Files
prometeu-studio/docs/specs/compiler
bquarkz bf31184d4d 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.
2026-11-05 15:16:07 +00:00
..

General Compiler Specifications

Owner: compiler/general. Canonical source: docs/specs/compiler.

These specifications define shared frontend/backend acceptance, compilation, linking, typed handoff and emission. They apply across supported languages. Language contracts define PBS rules and refer to this layer for shared policy rather than duplicating it.

Authority and reading order

The runtime owns PBX binary layout, Core ISA, admission and VM execution. Read the mirror and provenance policy for that boundary. Chapters 24–25 own the detailed compiler catalog/typed-Registry consumer contracts; earlier pipeline, verification and matrix chapters reference them for these topics. Equal storage widths never replace logical identity or transfer runtime authority.

Start with pipeline entry points (23), then name/linking (14), typed handoff (25), lowering/optimization (20–21), runtime/catalog integration (16, 18, 24), and conformance/verification/compatibility (13, 17, 19, 22). Existing chapter numbers are stable and do not imply language-version numbers.

Chapter index

Editorial and workflow rules

Write specs in English with title, status, scope, authority, normative rules, non-goals and conformance/exit criteria. Keep one owner per detailed contract; summaries link to it. Only settled decisions may change normative behavior. Agendas, decisions and plans live in discussion/, and completed teaching material lives in discussion/lessons/; they are not parallel spec sources.

See the specification guide for other domains.