@carbonenginejs/runtime-resource 0.18.0 → 0.18.1

package/docs/formats/webgpu/architecture.md

@@ -38,8 +38,8 @@ then package data to the engine.
 - Reading, inspecting, and building Carbon-record Carbon WebGPU containers.
 - Resolving one compiled-effect permutation and complete pass.
 - Preserving every source permutation row and representable non-program
-  description field; non-dynamic sampler names are unrecoverable and stage
-  order is canonicalized.
+  description field, including non-dynamic sampler names and the authored stage
+  order — both are preserved, whatever Carbon's runtime does with them.
   Stored-body identity is exact emitted-description-byte identity; it does not
   promise to retain the source alias partition after programs are replaced.
 - Writing WGSL to program slots and bind-group/transform data to the optional

package/docs/formats/webgpu/formats/carbon-webgpu.md

@@ -9,12 +9,23 @@ Summary: Defines the Carbon v15 record container used for WebGPU effects, its ba
 
 A `.carbonwebgpu` file is a stock Carbon version-15 compiled-effect container whose
 program slots carry WGSL instead of DXBC. It preserves every permutation row
-and representable non-program description/reflection fields. Non-dynamic
-sampler names are unrecoverable and stage order is canonicalized. Source-stage
+and representable non-program description/reflection fields, including
+non-dynamic sampler names and the authored stage order. Source-stage
 programs are not stored: a translated slot contains WGSL and an untranslated slot is empty.
 Each translated pass may also carry one WebGPU backend block containing
 bind-group layouts and resource transforms.
 
+That preservation is **inherited from the shared codec, and now pinned on this
+path.** It holds because the emit round-trips the description through the same
+Carbon classes the plain container uses and mutates only `stage.sourceProgram`
+and `pass.backendBlock`.
+
+`carbon-webgpu-emit-fidelity.test.mjs` compares both fields source-to-emitted
+across the corpus rather than trusting that restraint: 2,960 emitted files,
+39,252 sampler names and 84,912 stage orders, of which 102 are non-canonical —
+the case that distinguishes a preserved order from a re-derived one. Widening
+what the emit touches now fails there instead of surfacing in a consumer later.
+
 There is no Carbon WebGPU-specific magic, envelope, payload tag, or container version.
 Backend identity comes from the resource path, such as `effect.webgpu/`, just
 as Carbon selects `effect.dx11/`, `effect.dx12/`, or `effect.metal/`.

package/docs/formats/webgpu/guides/effect-packaging.md

@@ -50,8 +50,7 @@ The emitted bytes are a stock Carbon v15 effect container:
 - each distinct emitted description body is stored once, based on exact emitted
   bytes rather than the source alias partition;
 - representable non-program description/reflection fields remain in the Carbon
-  tree; non-dynamic sampler names are unrecoverable and stage order is
-  canonicalized;
+  tree, non-dynamic sampler names and the authored stage order included;
 - translated stage program slots contain UTF-8 WGSL;
 - untranslated or unsupported stage program slots have zero length; and
 - translated passes may carry a WebGPU backend block with bind-group layouts

package/docs/formats/webgpu/reference/wgsl-compatibility.md

@@ -1403,8 +1403,8 @@ program slots and coverage degrades to `partial`. The in-memory build result
 retains its specific reason; the wire does not. A reread can say only that the
 body carries no translated programs. Permutation topology and representable
 non-program description fields remain present, but source-stage programs are
-not stored. Non-dynamic sampler names are unrecoverable and stage order is
-canonicalized.
+not stored. Non-dynamic sampler names and the authored stage order are both
+preserved.
 
 Translating every body is deliberately **not** treated as backend completeness.
 `backendComplete` and `runtimeComplete` remain false, matching the sibling

package/docs/reference/classes/formats.md

@@ -689,6 +689,39 @@ Data-only Python pickle format facade that currently decodes protocol 0 into JSO
 - Visibility: Public
 - Kind: Original CarbonEngineJS class
 
+<!-- class:CjsSchemaBoundFormat -->
+## `CjsSchemaBoundFormat`
+
+Reads a binary record container against the separate schema document that describes its layout.
+
+- Export: `@carbonenginejs/runtime-resource/formats/schemabound`
+- Source: `src/formats/schemabound/CjsSchemaBoundFormat.js`
+- Visibility: Public
+- Kind: Original CarbonEngineJS class
+- Notes: The schema is required and there is no default. These bytes carry no signature, so the wrong schema decodes into plausible nonsense rather than failing.
+
+<!-- class:CjsSqliteFormat -->
+## `CjsSqliteFormat`
+
+Reads a SQLite 3 container as data: the tables it holds and every row of them, with no SQL and no query engine.
+
+- Export: `@carbonenginejs/runtime-resource/formats/sqlite`
+- Source: `src/formats/sqlite/CjsSqliteFormat.js`
+- Visibility: Public
+- Kind: Original CarbonEngineJS class
+- Notes: Read-only and full-scan. Index b-trees are never walked, and nothing here needs a driver or a filesystem.
+
+<!-- class:CjsStaticFormat -->
+## `CjsStaticFormat`
+
+Identifies which of three unrelated containers a client `.static` file holds, so a caller can route it to the format that decodes it.
+
+- Export: `@carbonenginejs/runtime-resource/formats/static`
+- Source: `src/formats/static/CjsStaticFormat.js`
+- Visibility: Public
+- Kind: Original CarbonEngineJS class
+- Notes: Signature-based, and it decodes nothing at all since 2026-08-15. It reports the family and the payload offset; `CjsPickleFormat`, `CjsSqliteFormat` and `CjsSchemaBoundFormat` decode.
+
 <!-- class:CjsPickleProtocol0Reader -->
 ## `CjsPickleProtocol0Reader`
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@carbonenginejs/runtime-resource",
-  "version": "0.18.0",
+  "version": "0.18.1",
   "description": "CarbonEngineJS resource lifecycle, cache, source, and object loading contracts.",
   "type": "module",
   "exports": {
@@ -39,6 +39,9 @@
     "./formats/png": "./dist/formats/png/index.js",
     "./formats/red": "./dist/formats/red/index.js",
     "./formats/red/schema": "./dist/formats/red/core/blackDefinitions.js",
+    "./formats/schemabound": "./dist/formats/schemabound/index.js",
+    "./formats/sqlite": "./dist/formats/sqlite/index.js",
+    "./formats/static": "./dist/formats/static/index.js",
     "./formats/stl": "./dist/formats/stl/index.js",
     "./formats/tga": "./dist/formats/tga/index.js",
     "./formats/wav": "./dist/formats/wav/index.js",