@carbonenginejs/runtime-resource 0.1.0 → 0.7.0

package/FORMAT-PROVENANCE.md

@@ -37,8 +37,10 @@ copied runtime files are the deterministic retained snapshot.
 
 ## Black definition snapshot
 
-The Black and Red readers use the package-owned generated definition snapshot
-at `src/formats/black/core/black-schema-v1-2026-07-11.json`. It was copied from
+The Black reader uses the package-owned generated definition snapshot at
+`src/formats/black/core/black-schema-v1-2026-07-11.json`. The Red format exposes
+the same catalog for discovery, but its YAML reader currently accepts named
+fields without registry enforcement. The snapshot was copied from
 `format-carbon` revision `d2a3c67cf3d46e8ba78ca19e66558d868178ec24`
 with SHA-256
 `008ECB29E670EFC678B471A6EFF099600A29C2907912FC42B854995904604691`.
@@ -57,11 +59,17 @@ format attribution rather than fork provenance.
 
 | Format | Runtime class | Runtime import | Notes |
 |---|---|---|---|
-| Wwise soundbank (`.bnk`) | `CjsBnkFormat` | `@carbonenginejs/runtime-resource/formats/bnk` | Original code; chunk layout from public community documentation (ww2ogg, vgmstream, wwiser), no code copied. Also carries the SoundbanksInfo JSON helpers (`parseSoundbanksInfo`, `buildSoundbanksCatalog`, `joinSoundbanksInfo`) and `wwiseIdFromName` (FNV-1 32 of the lowercased name, verified against EVE bank/language ids). |
-| Wwise media (`.wem`) | `CjsWemFormat` | `@carbonenginejs/runtime-resource/formats/wem` | Original code; container/codec-tag behavior from public community documentation (ww2ogg, vgmstream, wwiser), no code copied. Includes a Wwise-Vorbis→Ogg repacker (`emit: "ogg"`), an original reimplementation of the ww2ogg algorithm with inline granule computation (no revorb pass needed). |
+| Wwise soundbank (`.bnk`) | `CjsBnkFormat` | `@carbonenginejs/runtime-resource/formats/bnk` | Original code; chunk layout from public community documentation (ww2ogg, vgmstream, wwiser), no code copied. Also carries the SoundbanksInfo JSON helpers (`parseSoundbanksInfo`, `buildSoundbanksCatalog`, `joinSoundbanksInfo`) and `wwiseIdFromName` (FNV-1 32 of the lowercased name, verified against EVE bank/language ids). HIRC entries additionally decode version-stable typed fields (event action lists, action type/target, sound and music-track source ids), pinned by hexdump against bank generator version 150, and the `wwise` static namespace groups the domain toolkit (SoundbanksInfo helpers, id hash, `wwise.eventMediaFromBanks` event → media resolution over inspected banks — graph interpretation for consumers; never used by the resource lifecycle). |
+| Wwise media (`.wem`) | `CjsWemFormat` | `@carbonenginejs/runtime-resource/formats/wem` | Original code; container/codec-tag behavior from public community documentation (ww2ogg, vgmstream, wwiser), no code copied. Includes a Wwise-Vorbis→Ogg repacker (`emit: "ogg"`), an original reimplementation of the ww2ogg algorithm with inline granule computation (no revorb pass needed), and a PTADPCM/16-bit-PCM decoder (`emit: "pcm"` / `toPcm()`, AudioBuffer-ready float32; PTADPCM algorithm from community documentation, verified against EVE media). |
 
 ## Post-fork additions inside copied formats
 
+- `formats/stl` received a writer hardening pass (2026-07-18) without changing
+  its donor origin: binary provenance headers now round-trip the caller's solid
+  name, shared triangle indices are validated as in-range safe integers, scaled
+  coordinates must remain finite, and binary coordinates must fit float32
+  instead of silently becoming infinities. Writer JSDoc and ASCII/binary
+  round-trip/error coverage were expanded in the runtime-owned copy.
 - `formats/cmf` gained a **binary CMF v1 writer** (2026-07-15,
   `src/formats/cmf/core/writer.js`, `CjsCmfFormat.write`/`writeAsync` and
   `Write`/`WriteAsync`): original code implementing CarbonEngine's
@@ -117,7 +125,8 @@ snapshot must record its new source and digest here.
   until that code is replaced or an explicit distribution-license decision is
   made. It has not been deprecated or relabeled as MIT.
 - `format-carbon` remains the schema emitter/generator and build-time schema
-  authority. Black and Red consume its published Black definitions.
+  authority. Black consumes its published definitions; Red exposes the copied
+  catalog but does not yet enforce it while reading YAML fields.
 - `format-dxbc`, `format-hlsl`, `format-webgl`, and `format-webgpu` are active
   shader work and were not copied, annotated, or otherwise modified by this
   migration.