feat(pbs): add sprite animation and shared Studio authoring

Implement DEC-0084 with factory-only Sprite/Animator structs, complete result
lowering, validated animation sidecars, generated PBS factories and JavaFX/MCP
authoring through shared services.

Qualify native dev/release with ordinary and optimized producers, zero-allocation
playback, private-cycle reclamation, canonical Composer pixels, installed JARs
and JavaFX lifecycle. Preserve the runtime checkout and existing host ABI.
This commit is contained in:
2026-11-05 15:16:07 +00:00
parent 1d8b8c2101
commit bf31184d4d
151 changed files with 4823 additions and 98 deletions
+38
View File
@@ -505,3 +505,41 @@ GC fixtures require actual advancing collection counters. Snapshots release sour
backings and observe 1,200 → 1 → 1 → 0 nodes/payloads. Collection fixtures observe
64 → 61 → 0 → 1 → 0 payloads and only one retained backing until its final owner
is dropped. Temporary Cargo projects/targets stay outside the runtime checkout.
## PBS Result, Sprite and Animation qualification
Generate the source corpora with `:prometeu-architecture-tests:test` and
`:prometeu-app:installedKnowledgeTest`. Focused native gates are `--result-only`
and `--animation-only`; add `--release` for the runtime release profile. Before
animation qualification, generate the Composer pixel corpus with
`:prometeu-app:headlessProcessTest --tests '*AnimationInstalledRuntimeTest'`
and `-PstudioRuntimeInstall=<extracted-runtime-installation>`. The desktop gate
is `:prometeu-app:animationDesktopTest`. Each native gate
requires both ordinary and optimized producer variants and fails on missing fixtures.
Result executes status plus complete payload groups, once-only propagation and
handling, error remapping, reference/Fn/trait/builtin payloads and uncaught traps.
Animation executes the public core, reusable independent backing, state/reset/time
boundaries, every domain error, exact long limits and a test-only near-limit state.
The isolated count/phase setup is never shipped as a public mutation hook.
`animation.rs` single-steps actual instructions between post-construction markers.
Sprite and successful, negative and overflow advance paths must execute zero
StructNew/ArrayNew/MakeClosure instructions. Large jumps must remain below the
bounded instruction gate. Zero guest/handle quotas trap during construction and
are distinct from recoverable domain errors. A test-only safepoint marker observes
live private rings followed by complete reclamation after their last owner clears.
The installed-JAR producer saves a real Packer-bound canonical sidecar, compiles
virtual factories with read-only JSON origins and supplies both producer variants
for production firmware execution. `AnimationInstalledRuntimeTest` separately boots
the configured extracted runtime and compares every pixel of direct/generated
Composer sprites with the shared preview across tick boundaries and alternating
palettes. That saved-project corpus is replayed by production firmware in native
dev/release with both producers, comparing the exact same canonical pixels. The public Composer
facade retains int status and nine arguments; its private host carrier is narrowed
from the existing native Int64 status. No runtime source write is required.
Keep Cargo targets in `/tmp` and retain source hashes, provider revision, profiles,
allocation counts and GC observations with the completed discussion's evidence.