@carbonenginejs/runtime-resource 0.20.0 → 0.22.0

package/docs/formats/hlsl/reference/api.md

@@ -49,7 +49,9 @@ Options are reusable on an instance and can be overridden per call:
 
 ## Static methods
 
-- `CjsHlslFormat.isSupported(input)` performs a header-level support check.
+- `CjsHlslFormat.is(input)` performs boolean header-level identification.
+- `CjsHlslFormat.getSupport(input, options)` returns synchronous advisory output support.
+- `CjsHlslFormat.verifySupport(input, options)` proves one output through `readAsync()`.
 - `CjsHlslFormat.read(input, options)` performs a one-shot read.
 - `CjsHlslFormat.inspect(input, options)` performs a one-shot inspection.
 - `CjsHlslFormat.toJSON(value)` converts output to JSON-compatible data.
@@ -59,9 +61,9 @@ Supported container versions are 8 through 15.
 
 ## Constants
 
-The class exposes `OUTPUT_JSON`, `OUTPUT_METADATA`, `OUTPUT_RAW`,
-`CLASS_KEYS`, `type`, `mediaTypes`, `inputTypes`, `outputTypes`, and
-`debugOutputTypes`. `inputTypes` contains `sm_hi`, `sm_lo`, and `sm_depth`.
+The class exposes `OUTPUT_JSON`, `OUTPUT_METADATA`, `OUTPUT_RAW`, `CLASS_KEYS`,
+`id`, frozen `mediaTypes`, dotted `extensions`, and its frozen `outputs` map.
+The extensions are `.sm_hi`, `.sm_lo`, and `.sm_depth`.
 
 ## Output stability
 

package/docs/formats/provenance.md

@@ -60,6 +60,24 @@ the copied `CjsFormatGr2` name is gone and `formats/gr2/core/` holds only
 role-named helper modules, matching every other format. Donor license and
 notice files are kept under `format-notices/gr2/`.
 
+On 2026-08-22, the acquisition-free decoder and verified modern cFSD dataset
+readers moved from the retiring `tools-fsd` package. The runtime copy contains
+only caller-supplied byte decoding, inert schemas, and reader registration; it
+does not contain acquisition, build selection, native loader modules, decoded
+tables, or game data.
+
+| Legacy package | Source revision/state | Runtime classes | Runtime imports |
+|---|---|---|---|
+| `tools-fsd` | `1cef89b88c6285f6874420519cfc8f1bd4085281` (source and reader trees clean; documentation-only retirement edits present) | `CjsFsdFormat`, `CjsFsd64Format`, `CjsFsd64Reader`, schema readers | `@carbonenginejs/runtime-resource/formats/fsd`, `@carbonenginejs/runtime-resource/formats/fsd/64`, `@carbonenginejs/runtime-resource/formats/fsd/64/readers` |
+
+The runtime layout also reserves `formats/fsd/32` for legacy Carbon FSD. That
+format is headerless and schema-driven, so the current facade identifies it
+only from an explicit caller/profile declaration and throws
+`CJS_FSD_32_UNSUPPORTED` when reading. Modern cFSD is independently recognized
+by its fixed envelope and 64-bit payload length. The two layouts are related
+formats, not aliases. Donor MIT license and notice files are retained under
+`format-notices/fsd/`.
+
 ## Black definition snapshot
 
 The Black reader uses the package-owned generated definition snapshot at

package/docs/formats/schemabound.md

@@ -47,10 +47,16 @@ rather than only how wide it is.
 - `read` / `readJSON` — plain JSON-compatible values; a wide integer becomes a
   decimal string.
 - `readPayload` — the same, with wide integers left as `BigInt`.
-- `is` / `isSupported` — **these ask about the schema, not the payload.** These
-  containers have no signature, so claiming to recognize the bytes would be a
-  claim this format cannot support. Which family a `.static` file belongs to is
-  [`CjsStaticFormat`](static.md)'s question.
+- `is` — the synchronous boolean routing predicate. For this format it asks
+  whether the supplied schema is structurally recognizable, not whether the
+  payload matches it. These containers have no signature, so claiming to
+  recognize the bytes would be a claim the format cannot support.
+- `getSupport` — an advisory report derived from the schema and requested
+  output. Use `verifySupport()` when the caller needs asynchronous proof that a
+  particular output can actually be read.
+
+Which family a `.static` file belongs to is
+[`CjsStaticFormat`](static.md)'s question.
 
 The root is whatever the schema declares: a keyed map decodes to an object, a
 list decodes to an array.

package/docs/formats/static.md

@@ -43,14 +43,14 @@ It reports the family, where the payload starts, and what is still missing. The
 caller takes that to the format that owns the family:
 
 ```js
-const probe = await CjsStaticFormat.resolveType(bytes);
+const metadata = CjsStaticFormat.inspect(bytes);
 
-if (probe.preferred === CJS_STATIC_FAMILIES.SQLITE)
+if (metadata.family === CJS_STATIC_FAMILIES.SQLITE)
 {
   return CjsSqliteFormat.readJSON(bytes);
 }
 
-if (probe.preferred === CJS_STATIC_FAMILIES.PICKLE)
+if (metadata.family === CJS_STATIC_FAMILIES.PICKLE)
 {
   // The prefix is the SCHEMA's length, not a wrapper to skip. Handing the whole
   // remainder to a pickle reader throws CJS_PICKLE_FORMAT_TRAILING_DATA, on the binary
@@ -91,29 +91,29 @@ to be worked out and pinned. `CjsSchemaBoundFormat` reads it:
 skeleton of regions, constellations and systems. The celestial detail (moons,
 planets, belts, stars, gates) is in the embedded-schema family, not this one.
 
-## Use
-
-Identification goes through the shared type-resolution seam rather than a
-private entry point — see [format type resolution](../concepts/format-type-resolution.md).
-
-```js
-import { CjsStaticFormat, CJS_STATIC_FAMILIES } from
-    "@carbonenginejs/runtime-resource/formats/static";
-
-const probe = await CjsStaticFormat.resolveType(bytes);
-
-if (probe.preferred === CJS_STATIC_FAMILIES.PICKLE)
-{
-    // See the routing example above: the prefix is a schema length.
-}
-```
-
-`isSupported()` and its `inspect()` alias report on the declaration seam;
-`resolveType()` is the content-verified one. This format is an unusual case for
-that contract: `.static` carries no in-band declaration at all, so there is
-nothing for the content to disagree with. The signature is both claim and
-evidence, `resolveType()` is therefore always `verified`, and `metadata.declared`
-is `null` with `mismatch` always false.
+## Use
+
+Identification uses the shared synchronous inspection seam; see
+[format capabilities](../concepts/format-capabilities.md).
+
+```js
+import { CjsStaticFormat, CJS_STATIC_FAMILIES } from
+    "@carbonenginejs/runtime-resource/formats/static";
+
+const metadata = CjsStaticFormat.inspect(bytes);
+
+if (metadata.family === CJS_STATIC_FAMILIES.PICKLE)
+{
+    // See the routing example above: the prefix is a schema length.
+}
+```
+
+`is()` is the boolean routing predicate and `inspect()` returns the identified
+family. `getSupport()` reports `recognized: true` for SQLite and prefixed
+pickle, but `supported: false`: `CjsStaticFormat` deliberately declares no
+outputs and decodes nothing. `verifySupport()` therefore returns
+`CJS_FORMAT_OUTPUT_UNDECLARED` instead of pretending family identification is
+a decoder capability.
 
 `describe()` returns the underlying
 `{ family, byteLength, payloadOffset, prefix, decodable, requires, reason }` without

package/docs/formats/webgpu/reference/api.md

@@ -175,9 +175,10 @@ coalescing uses version 3 and carries an explicit transform recipe.
 
 ## Static metadata
 
-The class exposes `OUTPUT_JSON`, `CLASS_KEYS`, `type`, `mediaTypes`,
-`inputTypes`, `outputTypes`, `implementationStatus`, `format`, `analysisFormat`,
-and `packageVersion`. There is no `OUTPUT_RAW` and no `debugOutputTypes`.
+The class exposes `OUTPUT_JSON`, `CLASS_KEYS`, `id`, frozen `mediaTypes`,
+`extensions` (`.carbonwebgpu`), its frozen `outputs` map, `format`,
+`analysisFormat`, and `packageVersion`. There is no `OUTPUT_RAW` or debug
+output.
 
 ## Errors
 

package/docs/reference/classes/core.md

@@ -108,7 +108,7 @@ Shared output and hydration backend for Blue persistence readers that owns commo
 <!-- class:CjsFormat -->
 ## `CjsFormat`
 
-Base class for format readers that defines the static `read`/`readAsync`/`isSupported`/`resolveType` contract and instance option handling that concrete format packages implement.
+Decorator-free base for every format facade. It owns normalized statics, boolean `is()` routing, structural `inspect()`, synchronous advisory `getSupport()`, exact asynchronous `verifySupport()`, and shared instance option handling.
 
 - Export: `@carbonenginejs/runtime-resource`
 - Source: `src/format/CjsFormat.js`
@@ -125,6 +125,26 @@ Internal base for construction-bound readers that are created for one source and
 - Visibility: Internal
 - Kind: Internal implementation class
 
+<!-- class:CjsFormatRoute -->
+## `CjsFormatRoute`
+
+Captures one registered extension, content probe, reader, and output-capability route for format dispatch.
+
+- Export: `None`
+- Source: `src/format/CjsFormatStore.js`
+- Visibility: Internal
+- Kind: Original CarbonEngineJS class
+
+<!-- class:CjsFormatStore -->
+## `CjsFormatStore`
+
+Registers ordered content-aware format routes without coupling resource classes to concrete format implementations.
+
+- Export: `@carbonenginejs/runtime-resource`
+- Source: `src/format/CjsFormatStore.js`
+- Visibility: Public
+- Kind: Original CarbonEngineJS class
+
 <!-- class:CjsFormatReadError -->
 ## `CjsFormatReadError`
 
@@ -208,7 +228,7 @@ Builder for a Carbon compiled-effect container.
 <!-- class:CjsResourceProbe -->
 ## `CjsResourceProbe`
 
-Standard probe-report model that formats return from inspection, recording support status, content-verification state, confidence, preferred route, capability variants, warnings, and errors without choosing an engine or media backend.
+Optional decorated resource-layer model for a plain format support report. It records recognition, the selected output, advisory or verified support, declared output capabilities, metadata, warnings, and structured errors, and exposes `canUseSelected()` and `canUse(output)`.
 
 - Export: `@carbonenginejs/runtime-resource`
 - Source: `src/format/CjsResourceProbe.js`