implements PR-015 asset codec NONE in specs

This commit is contained in:
2026-03-24 13:40:56 +00:00
parent f652e8d5d3
commit a024e199fb
4 changed files with 23 additions and 69 deletions
@@ -103,18 +103,25 @@ In v1, that decision comes from the `codec`/CODEX:
The key point is to separate:
- the asset storage contract;
- the generic codec layer, when one exists;
- the operational strategy for reading and decode.
## Serialized Form Is Not Resident Form
One of the most important asset-management lessons in the current runtime is that `RAW` does not mean "bitwise identical to in-memory layout".
One of the most important asset-management lessons in the current runtime is that `codec = NONE` does not mean "bitwise identical to in-memory layout".
The tile-bank path is the concrete example:
- there is no additional generic codec layer for the asset;
- the serialized payload stores indexed pixels as packed `4bpp`;
- the palette table remains serialized as `RGB565` little-endian;
- the runtime expands pixels into one `u8` index per pixel after decode.
That is exactly why `codec` and bank contract must stay separate in the mental model:
- `codec` may be absent;
- the bank-specific decode may still be real and mandatory.
That is why `AssetEntry.size` and `AssetEntry.decoded_size` must be thought of as different concepts:
- `size` is transport cost inside `assets.pa`;