Glyph Bank Naming Alignment with Runtime DEC-0006

This commit is contained in:
2026-04-10 06:33:49 +01:00
parent 76b5717cd8
commit 99e9102004
46 changed files with 467 additions and 185 deletions
@@ -58,7 +58,7 @@ Rules:
Examples:
- `tile_bank`
- `glyph_bank`
- `sound_bank`
## Inputs
@@ -203,7 +203,7 @@ The `asset.json` schema is versioned independently from:
- runtime-facing artifact schema
- format contract versions
Format-specific contracts evolve through values such as `TILES/indexed_v1`.
Format-specific contracts evolve through values such as `GLYPH/indexed_v1`.
## Non-Goals
@@ -145,15 +145,15 @@ Offset ambiguity guardrail:
- internal pipeline indexing data (for example per-sample ranges for audio banks) must live under `asset_table[].metadata`;
- internal indexing fields must not be interpreted as payload slicing fields.
## Format-Specific Baseline: `TILES/indexed_v1`
## Format-Specific Baseline: `GLYPH/indexed_v1`
The first-wave producer contract for `TILES/indexed_v1` is fixed and runtime-aligned.
The first-wave producer contract for `GLYPH/indexed_v1` is fixed and runtime-aligned.
### Tile Selection and Identity
Rules:
- only selected artifacts participate in the emitted tile bank;
- only selected artifacts participate in the emitted glyph bank;
- `1 artifact = 1 tile` in v1;
- artifacts are normalized by ascending `artifacts[*].index`;
- emitted `tile_id` equals the normalized artifact index;
@@ -176,7 +176,7 @@ Rules:
Rules:
- the serialized payload for `TILES/indexed_v1` is:
- the serialized payload for `GLYPH/indexed_v1` is:
1. one packed `u4` pixel plane for the full emitted sheet;
2. one palette block of `64 * 16 * 2 = 2048` bytes;
- packed pixel bytes must be emitted by the packer, not inferred later by the runtime;
@@ -189,7 +189,7 @@ Rules:
Rules:
- emitted tile-bank entries use:
- `bank_type = TILES`
- `bank_type = GLYPH`
- `codec = NONE`
- tile-bank v1 metadata must expose at least:
- `tile_size`
@@ -208,7 +208,7 @@ Rules:
- bank palettes are declared under `output.pipeline.palettes`;
- each palette declaration uses the shape `{ "index": <int>, "palette": { ... } }`;
- palette ordering is ascending numeric `index`, never raw array position;
- palette ids in the emitted tile bank are the normalized declared palette indices;
- palette ids in the emitted glyph bank are the normalized declared palette indices;
- any tile in the bank may be rendered with any palette in the bank at runtime;
- palette selection is a runtime draw concern, not a tile-payload embedding concern.