@carbonenginejs/runtime 0.1.0-alpha.4 → 0.1.0-alpha.5

package/dist/resource/format/carbonEffect/carbonEffectBackendBlock.js

@@ -61,6 +61,12 @@ export { CARBON_BACKEND_TRANSFORM_FAMILY, DETAIL_MAP_ARRAY_DEFAULTS } from './ca
  */
 const CARBON_BACKEND_RESOURCE_KIND = Object.freeze(["uniform-buffer", "sampled-resource", "sampler", "storage-resource"]);
 
+/**
+ * A texture binding's sample type, ordered so the wire value is stable. The
+ * first is the default and what every non-texture binding writes.
+ */
+const CARBON_BACKEND_TEXTURE_SAMPLE_TYPE = Object.freeze(["float", "unfilterable-float"]);
+
 /** Shader stages, as a bit position in the visibility mask. */
 const CARBON_BACKEND_VISIBILITY = Object.freeze(["vertex", "fragment", "compute"]);
 
@@ -113,6 +119,11 @@ function unpackVisibility(mask) {
  * buffer and a compute typed buffer, and the structure stride separates them:
  * structured always carries one, typed never does.
  *
+ * One texture fact is not in the WGSL type and is stored: its sample type.
+ * `texture_2d<f32>` is the same declaration whether the layout says `float` or
+ * `unfilterable-float`, and only the lowering, which sees the instructions,
+ * knows a texture is only ever loaded.
+ *
  * @param {object} binding Decoded binding record.
  * @returns {object} The descriptor fragment, as one `{buffer|texture|sampler}` key.
  */
@@ -144,7 +155,8 @@ function deriveBindingDescriptor(binding) {
     const texture = TEXTURE_DESCRIPTORS[binding.type];
     if (texture) return {
       texture: {
-        ...texture
+        ...texture,
+        sampleType: binding.textureSampleType
       }
     };
     return {
@@ -232,10 +244,10 @@ function assertDerivedBindingFieldsAgree(binding, group) {
   }
 }
 
-/**
- * Encode one canonical backend binding and transform block.
- * @param {object} block Backend block record.
- * @returns {Uint8Array} Encoded backend bytes.
+/**
+ * Encode one canonical backend binding and transform block.
+ * @param {object} block Backend block record.
+ * @returns {Uint8Array} Encoded backend bytes.
  */
 function writeBackendBlock(block) {
   const bindGroups = block.bindGroups ?? [];
@@ -261,6 +273,13 @@ function writeBackendBlock(block) {
       writer.u32(binding.registerIndex);
       writer.u32(binding.structureStride ?? ABSENT);
       writer.u8(binding.arrayLayerCount ?? 0);
+      const sampleType = CARBON_BACKEND_TEXTURE_SAMPLE_TYPE.indexOf(binding.texture?.sampleType ?? "float");
+      if (sampleType < 0) {
+        throw new CjsFormatWriteError(`Unknown texture sample type "${binding.texture.sampleType}"`, {
+          sampleType: binding.texture.sampleType
+        });
+      }
+      writer.u8(sampleType);
       writeInlineString(writer, binding.type);
       writeInlineString(writer, binding.generatedSymbol);
       // A binding either carries a transform id or it does not; an empty
@@ -301,6 +320,12 @@ function readBackendBlock(bytes, options = {}) {
       const registerIndex = reader.ReadUint32();
       const structureStride = reader.ReadUint32();
       const arrayLayerCount = reader.ReadUint8();
+      const textureSampleType = CARBON_BACKEND_TEXTURE_SAMPLE_TYPE[reader.ReadUint8()];
+      if (!textureSampleType) {
+        throw new CjsFormatReadError("Backend block binding has an unknown texture sample type", {
+          source: options.source ?? "backend block"
+        });
+      }
       const type = readInlineString(reader);
       const generatedSymbol = readInlineString(reader);
       const transformId = readInlineString(reader);
@@ -328,7 +353,10 @@ function readBackendBlock(bytes, options = {}) {
       };
       bindings.push({
         ...record,
-        ...deriveBindingDescriptor(record)
+        ...deriveBindingDescriptor({
+          ...record,
+          textureSampleType
+        })
       });
     }
     bindGroups.push({
@@ -360,5 +388,5 @@ function readBackendBlock(bytes, options = {}) {
   };
 }
 
-export { CARBON_BACKEND_RESOURCE_KIND, CARBON_BACKEND_VISIBILITY, readBackendBlock, writeBackendBlock };
+export { CARBON_BACKEND_RESOURCE_KIND, CARBON_BACKEND_TEXTURE_SAMPLE_TYPE, CARBON_BACKEND_VISIBILITY, readBackendBlock, writeBackendBlock };
 //# sourceMappingURL=carbonEffectBackendBlock.js.map

package/dist/resource/format/carbonEffect/carbonEffectBackendBlock.js.map

@@ -1 +1 @@
-{"version":3,"file":"carbonEffectBackendBlock.js","sources":["../../../../../src/resource/format/carbonEffect/carbonEffectBackendBlock.js"],"sourcesContent":["import { CjsByteWriter } from \"../CjsByteWriter.js\";\r\nimport { CjsByteReader } from \"../CjsByteReader.js\";\r\nimport { CjsFormatReadError, CjsFormatWriteError } from \"../CjsFormatError.js\";\r\nimport {\r\n    CARBON_BACKEND_ENGINE_ID,\r\n    readBackendEngineId\r\n} from \"./backendEngineId.js\";\r\nimport {\r\n    CARBON_BACKEND_TRANSFORM_FAMILY,\r\n    DETAIL_MAP_ARRAY_DEFAULTS,\r\n    readInlineString,\r\n    readTransformSection,\r\n    writeInlineString,\r\n    writeTransformSection\r\n} from \"./carbonEffectResourceTransform.js\";\r\n\r\n/**\r\n * The WebGPU pass block: bind-group layouts plus the shared resource-transform\r\n * section.\r\n *\r\n * Neither is derivable from Carbon reflection. Carbon's `registers[]` is the D3D\r\n * binding model, while `(group, binding, visibility, generatedSymbol)` comes from\r\n * the *lowered IR's* bindings. So this is the port's only genuine invention, and\r\n * it is built entirely from Carbon's own techniques: count-prefixed fixed-width\r\n * records inside a blob referenced by `{u32 size, u32 offset}`, exactly like\r\n * program source.\r\n *\r\n * Both sections share **one** block rather than occupying two, because the\r\n * invariant worth keeping is \"the Carbon region is backend-invariant, with\r\n * exactly one optional trailing block\". They are also mutually required — a\r\n * transform needs a carrier binding in the same pass's layout and a transformed\r\n * binding needs a recipe — so one unit is the honest shape.\r\n *\r\n * ## Why the block is self-contained\r\n *\r\n * The block lives in the arena so that identical layouts dedupe across bodies the\r\n * way program source does; measured sharing is 30.5:1 at `(body, pass)`\r\n * granularity, 22 distinct blocks across 672 pairs.\r\n *\r\n * That forces one design consequence: **the block cannot contain arena offsets.**\r\n * An offset is only known after the arena's content sort, and the sort depends on\r\n * every blob's bytes — including this one. A block referencing the arena would\r\n * have to be interned before its own contents could be computed. Carbon never\r\n * meets this because no Carbon arena blob refers to the arena.\r\n *\r\n * So strings are inline here, length-prefixed, not interned. The cost is real but\r\n * small: a repeated `\"t11\"` inside 22 distinct blocks rather than one shared copy.\r\n * The block itself is what dedupes, and it dedupes 30x.\r\n */\r\n\r\n/**\r\n * The leading byte is the TARGET ENGINE IDENTIFIER, not a version.\r\n *\r\n * It was called CARBON_EFFECT_BACKEND_BLOCK_VERSION and emitted 1, while the\r\n * WebGL2 writer also emitted 1 meaning something unrelated - so the byte could\r\n * not do the one job it was there for. Renamed to what it is, and given a\r\n * distinct value per backend, it identifies the block.\r\n *\r\n * Carbon container version remains the only version. Nothing stores this block:\r\n * a consumer builds one and reads it back in the same process, so a block from\r\n * a different build is caught by the trailing-byte check at the end of the read.\r\n *\r\n * The identifier is shared with the WebGL2 block rather than duplicated, so the\r\n * two cannot drift into meaning the same number again.\r\n */\r\n\r\n/**\r\n * Resource kinds, ordered so the wire value is stable\r\n * (`buildWgslSet.js:117-122`).\r\n */\r\nexport const CARBON_BACKEND_RESOURCE_KIND = Object.freeze([\r\n    \"uniform-buffer\",\r\n    \"sampled-resource\",\r\n    \"sampler\",\r\n    \"storage-resource\"\r\n]);\r\n\r\n/** Shader stages, as a bit position in the visibility mask. */\r\nexport const CARBON_BACKEND_VISIBILITY = Object.freeze([ \"vertex\", \"fragment\", \"compute\" ]);\r\n\r\n// The transform section is shared with the GLSL block; both re-export the\r\n// family enum and defaults so a consumer of either codec sees them.\r\nexport { CARBON_BACKEND_TRANSFORM_FAMILY, DETAIL_MAP_ARRAY_DEFAULTS };\r\n\r\n/** Marks an absent optional `u32`. Carbon's null-reference value. */\r\nconst ABSENT = 0xffffffff;\r\n\r\n/**\r\n * Encodes a visibility list as a bit mask.\r\n *\r\n * @param {string[]} visibility Stage names.\r\n * @returns {number} Bit mask.\r\n */\r\nfunction packVisibility(visibility)\r\n{\r\n    let mask = 0;\r\n    for (const stage of visibility ?? [])\r\n    {\r\n        const bit = CARBON_BACKEND_VISIBILITY.indexOf(stage);\r\n        if (bit < 0)\r\n        {\r\n            throw new CjsFormatWriteError(`Unknown binding visibility \"${stage}\"`, { stage });\r\n        }\r\n        mask |= 1 << bit;\r\n    }\r\n    return mask;\r\n}\r\n\r\n/**\r\n * Decodes a visibility bit mask, in the canonical stage order.\r\n *\r\n * @param {number} mask Bit mask.\r\n * @returns {string[]} Stage names.\r\n */\r\nfunction unpackVisibility(mask)\r\n{\r\n    const stages = [];\r\n    for (let bit = 0; bit < CARBON_BACKEND_VISIBILITY.length; bit += 1)\r\n    {\r\n        if (mask & (1 << bit)) stages.push(CARBON_BACKEND_VISIBILITY[bit]);\r\n    }\r\n    return stages;\r\n}\r\n\r\n/**\r\n * Rebuilds a binding's WebGPU descriptor from what the block does store.\r\n *\r\n * The descriptor — `buffer`, `texture` or `sampler` — is not on the wire because\r\n * it is a pure function of the WGSL type, the resource kind and the structure\r\n * stride, all three of which are. `lowerBindingLayout.js` derives it from the\r\n * same three inputs on the way out; this derives it back on the way in.\r\n *\r\n * The pairs that could collide do not. `array<u32>` reaches both a structured\r\n * buffer and a compute typed buffer, and the structure stride separates them:\r\n * structured always carries one, typed never does.\r\n *\r\n * @param {object} binding Decoded binding record.\r\n * @returns {object} The descriptor fragment, as one `{buffer|texture|sampler}` key.\r\n */\r\nfunction deriveBindingDescriptor(binding)\r\n{\r\n    const stride = binding.structureStride;\r\n\r\n    if (binding.resourceKind === \"sampler\")\r\n    {\r\n        return { sampler: { type: \"filtering\" } };\r\n    }\r\n\r\n    if (binding.resourceKind === \"uniform-buffer\")\r\n    {\r\n        const vec4Count = /^array<vec4<f32>, (\\d+)>$/u.exec(binding.type)?.[1];\r\n        if (!vec4Count)\r\n        {\r\n            throw new CjsFormatReadError(\r\n                `Backend block uniform binding has untranslatable type \"${binding.type}\"`,\r\n                { type: binding.type }\r\n            );\r\n        }\r\n        return {\r\n            buffer: {\r\n                type: \"uniform\",\r\n                hasDynamicOffset: false,\r\n                minBindingSize: Number(vec4Count) * 16\r\n            }\r\n        };\r\n    }\r\n\r\n    if (binding.resourceKind === \"sampled-resource\")\r\n    {\r\n        const texture = TEXTURE_DESCRIPTORS[binding.type];\r\n        if (texture) return { texture: { ...texture } };\r\n\r\n        return {\r\n            buffer: {\r\n                type: \"read-only-storage\",\r\n                hasDynamicOffset: false,\r\n                minBindingSize: stride === undefined ? 4 : stride\r\n            }\r\n        };\r\n    }\r\n\r\n    return {\r\n        buffer: {\r\n            type: \"storage\",\r\n            hasDynamicOffset: false,\r\n            minBindingSize: stride === undefined ? 4 : stride\r\n        }\r\n    };\r\n}\r\n\r\n/** Texture descriptors by WGSL type (`lowerBindingLayout.js:90-95`). */\r\nconst TEXTURE_DESCRIPTORS = Object.freeze({\r\n    \"texture_2d<f32>\": Object.freeze({ sampleType: \"float\", viewDimension: \"2d\", multisampled: false }),\r\n    \"texture_cube<f32>\": Object.freeze({ sampleType: \"float\", viewDimension: \"cube\", multisampled: false }),\r\n    \"texture_3d<f32>\": Object.freeze({ sampleType: \"float\", viewDimension: \"3d\", multisampled: false }),\r\n    \"texture_2d_array<f32>\": Object.freeze({ sampleType: \"float\", viewDimension: \"2d-array\", multisampled: false })\r\n});\r\n\r\n/**\r\n * Serialises one pass's backend block.\r\n *\r\n * @param {object} block Block contents.\r\n * @param {object[]} [block.bindGroups] Bind groups with their bindings.\r\n * @param {object[]} [block.transforms] Resource transforms.\r\n * @returns {Uint8Array} Self-contained block bytes.\r\n */\r\n/**\r\n * Refuses a binding whose derived fields disagree with what the reader rebuilds.\r\n *\r\n * `identity`, `scopeIdentity` and the per-binding `group` are not stored: the\r\n * reader recomputes them from the register triple, the visibility mask and the\r\n * enclosing group. A binding that carries a different value therefore does not\r\n * fail - it round-trips into a different binding, and the engine matches on\r\n * exactly these strings.\r\n *\r\n * `scopeIdentity` deserves the sharpest check, because the wire cannot preserve\r\n * what it is derived from. Visibility is stored as a **bitmask**, so it is a\r\n * set; `scopeIdentity` is built from `visibility[0]`, so it depends on an\r\n * order. A binding written as `[fragment, vertex]` reads back as\r\n * `[vertex, fragment]` and its scope silently moves from `@fragment` to\r\n * `@vertex`. Canonical order is the only order the format can represent, so a\r\n * producer must write it.\r\n *\r\n * @param {object} binding Binding record.\r\n * @param {object} group Enclosing bind group.\r\n */\r\nfunction assertDerivedBindingFieldsAgree(binding, group)\r\n{\r\n    const identity = `${binding.resourceKind}:${binding.registerSpace}:${binding.registerIndex}`;\r\n    const canonical = unpackVisibility(packVisibility(binding.visibility));\r\n    const derived = [\r\n        [ \"identity\", binding.identity, identity ],\r\n        [ \"scopeIdentity\", binding.scopeIdentity, `${identity}@${canonical[0]}` ],\r\n        [ \"group\", binding.group, group.group ]\r\n    ];\r\n\r\n    for (const [ field, actual, expected ] of derived)\r\n    {\r\n        if (actual === undefined || actual === null) continue;\r\n        if (actual === expected) continue;\r\n\r\n        throw new CjsFormatWriteError(\r\n            `Binding ${identity} sets ${field} to ${JSON.stringify(actual)}, but the reader rebuilds`\r\n            + ` ${JSON.stringify(expected)}. The value is not stored, so writing this would silently`\r\n            + ` change the binding.`,\r\n            { identity, field, actual, expected }\r\n        );\r\n    }\r\n}\r\n\r\n/**\n * Encode one canonical backend binding and transform block.\n * @param {object} block Backend block record.\n * @returns {Uint8Array} Encoded backend bytes.\n */\nexport function writeBackendBlock(block)\n{\r\n    const bindGroups = block.bindGroups ?? [];\r\n    const transforms = block.transforms ?? [];\r\n    const writer = new CjsByteWriter(256);\r\n\r\n    writer.u8(CARBON_BACKEND_ENGINE_ID.webgpu);\r\n\r\n    writer.u8(bindGroups.length);\r\n    for (const group of bindGroups)\r\n    {\r\n        writer.u8(group.group);\r\n        writer.u8(group.bindings.length);\r\n        for (const binding of group.bindings)\r\n        {\r\n            const kind = CARBON_BACKEND_RESOURCE_KIND.indexOf(binding.resourceKind);\r\n            if (kind < 0)\r\n            {\r\n                throw new CjsFormatWriteError(`Unknown resource kind \"${binding.resourceKind}\"`, {\r\n                    resourceKind: binding.resourceKind\r\n                });\r\n            }\r\n            assertDerivedBindingFieldsAgree(binding, group);\r\n            writer.u8(kind);\r\n            writer.u8(binding.registerSpace);\r\n            writer.u8(binding.binding);\r\n            writer.u8(packVisibility(binding.visibility));\r\n            writer.u32(binding.registerIndex);\r\n            writer.u32(binding.structureStride ?? ABSENT);\r\n            writer.u8(binding.arrayLayerCount ?? 0);\r\n            writeInlineString(writer, binding.type);\r\n            writeInlineString(writer, binding.generatedSymbol);\r\n            // A binding either carries a transform id or it does not; an empty\r\n            // string is not a legal id, so length zero encodes absence.\r\n            writeInlineString(writer, binding.transformId ?? \"\");\r\n        }\r\n    }\r\n\r\n    writeTransformSection(writer, transforms);\r\n\r\n    return writer.toBytes();\r\n}\r\n\r\n/**\r\n * Parses one pass's backend block, restoring every derived field.\r\n *\r\n * @param {ArrayBuffer|ArrayBufferView|Uint8Array} bytes Block bytes.\r\n * @param {object} [options] Read options.\r\n * @param {string} [options.layoutKey] Enclosing pass key, restored onto records.\r\n * @param {string} [options.source] Source name for error details.\r\n * @returns {object} Block contents with derived fields restored.\r\n */\r\nexport function readBackendBlock(bytes, options = {})\r\n{\r\n    const reader = new CjsByteReader(bytes, { source: options.source ?? \"backend block\" });\r\n    const layoutKey = options.layoutKey ?? null;\r\n\r\n    readBackendEngineId(reader, CARBON_BACKEND_ENGINE_ID.webgpu, options.source ?? \"backend block\");\r\n\r\n    const bindGroups = [];\r\n    const groupCount = reader.ReadUint8();\r\n    for (let groupIndex = 0; groupIndex < groupCount; groupIndex += 1)\r\n    {\r\n        const group = reader.ReadUint8();\r\n        const bindings = [];\r\n        const bindingCount = reader.ReadUint8();\r\n        for (let index = 0; index < bindingCount; index += 1)\r\n        {\r\n            const resourceKind = CARBON_BACKEND_RESOURCE_KIND[reader.ReadUint8()];\r\n            const registerSpace = reader.ReadUint8();\r\n            const binding = reader.ReadUint8();\r\n            const visibility = unpackVisibility(reader.ReadUint8());\r\n            const registerIndex = reader.ReadUint32();\r\n            const structureStride = reader.ReadUint32();\r\n            const arrayLayerCount = reader.ReadUint8();\r\n            const type = readInlineString(reader);\r\n            const generatedSymbol = readInlineString(reader);\r\n            const transformId = readInlineString(reader);\r\n\r\n            const identity = `${resourceKind}:${registerSpace}:${registerIndex}`;\r\n            const record = {\r\n                group,\r\n                binding,\r\n                resourceKind,\r\n                registerSpace,\r\n                registerIndex,\r\n                visibility,\r\n                type,\r\n                generatedSymbol,\r\n                identity,\r\n                scopeIdentity: `${identity}@${visibility[0]}`,\r\n                ...(structureStride === ABSENT ? {} : { structureStride }),\r\n                ...(arrayLayerCount === 0 ? {} : { arrayLayerCount }),\r\n                ...(transformId === \"\" ? {} : { transformId })\r\n            };\r\n            bindings.push({ ...record, ...deriveBindingDescriptor(record) });\r\n        }\r\n        bindGroups.push({ group, bindings });\r\n    }\r\n\r\n    const transforms = readTransformSection(reader, layoutKey);\r\n\r\n    // A sized record must land exactly on its declared end. Trailing bytes mean\r\n    // the writer knew fields this reader does not, which with no version byte is\r\n    // the ONLY signal that a block came from a different build - so this check is\r\n    // load-bearing rather than defensive.\r\n    // This is the only surviving form of a closed-schema check: under a record\r\n    // layout a field either exists at its offset or the read fails, so there is\r\n    // nothing per-field left to assert, but exhaustiveness is still checkable and\r\n    // is exactly what a silently-discarded tail would violate.\r\n    if (reader.remaining !== 0)\r\n    {\r\n        throw new CjsFormatReadError(\r\n            `Backend block has ${reader.remaining} unparsed trailing byte(s); rebuild the effect package`,\r\n            { source: options.source ?? \"backend block\", trailingBytes: reader.remaining }\r\n        );\r\n    }\r\n\r\n    return {\r\n        layoutKey,\r\n        bindGroups,\r\n        transforms,\r\n        trailingBytes: 0\r\n    };\r\n}\r\n"],"names":["CARBON_BACKEND_RESOURCE_KIND","Object","freeze","CARBON_BACKEND_VISIBILITY","ABSENT","packVisibility","visibility","mask","stage","bit","indexOf","CjsFormatWriteError","unpackVisibility","stages","length","push","deriveBindingDescriptor","binding","stride","structureStride","resourceKind","sampler","type","vec4Count","exec","CjsFormatReadError","buffer","hasDynamicOffset","minBindingSize","Number","texture","TEXTURE_DESCRIPTORS","undefined","sampleType","viewDimension","multisampled","assertDerivedBindingFieldsAgree","group","identity","registerSpace","registerIndex","canonical","derived","scopeIdentity","field","actual","expected","JSON","stringify","writeBackendBlock","block","bindGroups","transforms","writer","CjsByteWriter","u8","CARBON_BACKEND_ENGINE_ID","webgpu","bindings","kind","u32","arrayLayerCount","writeInlineString","generatedSymbol","transformId","writeTransformSection","toBytes","readBackendBlock","bytes","options","reader","CjsByteReader","source","layoutKey","readBackendEngineId","groupCount","ReadUint8","groupIndex","bindingCount","index","ReadUint32","readInlineString","record","readTransformSection","remaining","trailingBytes"],"mappings":"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"}
+{"version":3,"file":"carbonEffectBackendBlock.js","sources":["../../../../../src/resource/format/carbonEffect/carbonEffectBackendBlock.js"],"sourcesContent":["import { CjsByteWriter } from \"../CjsByteWriter.js\";\r\nimport { CjsByteReader } from \"../CjsByteReader.js\";\r\nimport { CjsFormatReadError, CjsFormatWriteError } from \"../CjsFormatError.js\";\r\nimport {\r\n    CARBON_BACKEND_ENGINE_ID,\r\n    readBackendEngineId\r\n} from \"./backendEngineId.js\";\r\nimport {\r\n    CARBON_BACKEND_TRANSFORM_FAMILY,\r\n    DETAIL_MAP_ARRAY_DEFAULTS,\r\n    readInlineString,\r\n    readTransformSection,\r\n    writeInlineString,\r\n    writeTransformSection\r\n} from \"./carbonEffectResourceTransform.js\";\r\n\r\n/**\r\n * The WebGPU pass block: bind-group layouts plus the shared resource-transform\r\n * section.\r\n *\r\n * Neither is derivable from Carbon reflection. Carbon's `registers[]` is the D3D\r\n * binding model, while `(group, binding, visibility, generatedSymbol)` comes from\r\n * the *lowered IR's* bindings. So this is the port's only genuine invention, and\r\n * it is built entirely from Carbon's own techniques: count-prefixed fixed-width\r\n * records inside a blob referenced by `{u32 size, u32 offset}`, exactly like\r\n * program source.\r\n *\r\n * Both sections share **one** block rather than occupying two, because the\r\n * invariant worth keeping is \"the Carbon region is backend-invariant, with\r\n * exactly one optional trailing block\". They are also mutually required — a\r\n * transform needs a carrier binding in the same pass's layout and a transformed\r\n * binding needs a recipe — so one unit is the honest shape.\r\n *\r\n * ## Why the block is self-contained\r\n *\r\n * The block lives in the arena so that identical layouts dedupe across bodies the\r\n * way program source does; measured sharing is 30.5:1 at `(body, pass)`\r\n * granularity, 22 distinct blocks across 672 pairs.\r\n *\r\n * That forces one design consequence: **the block cannot contain arena offsets.**\r\n * An offset is only known after the arena's content sort, and the sort depends on\r\n * every blob's bytes — including this one. A block referencing the arena would\r\n * have to be interned before its own contents could be computed. Carbon never\r\n * meets this because no Carbon arena blob refers to the arena.\r\n *\r\n * So strings are inline here, length-prefixed, not interned. The cost is real but\r\n * small: a repeated `\"t11\"` inside 22 distinct blocks rather than one shared copy.\r\n * The block itself is what dedupes, and it dedupes 30x.\r\n */\r\n\r\n/**\r\n * The leading byte is the TARGET ENGINE IDENTIFIER, not a version.\r\n *\r\n * It was called CARBON_EFFECT_BACKEND_BLOCK_VERSION and emitted 1, while the\r\n * WebGL2 writer also emitted 1 meaning something unrelated - so the byte could\r\n * not do the one job it was there for. Renamed to what it is, and given a\r\n * distinct value per backend, it identifies the block.\r\n *\r\n * Carbon container version remains the only version. Nothing stores this block:\r\n * a consumer builds one and reads it back in the same process, so a block from\r\n * a different build is caught by the trailing-byte check at the end of the read.\r\n *\r\n * The identifier is shared with the WebGL2 block rather than duplicated, so the\r\n * two cannot drift into meaning the same number again.\r\n */\r\n\r\n/**\r\n * Resource kinds, ordered so the wire value is stable\r\n * (`buildWgslSet.js:117-122`).\r\n */\r\nexport const CARBON_BACKEND_RESOURCE_KIND = Object.freeze([\r\n    \"uniform-buffer\",\r\n    \"sampled-resource\",\r\n    \"sampler\",\r\n    \"storage-resource\"\r\n]);\r\n\r\n/**\r\n * A texture binding's sample type, ordered so the wire value is stable. The\r\n * first is the default and what every non-texture binding writes.\r\n */\r\nexport const CARBON_BACKEND_TEXTURE_SAMPLE_TYPE = Object.freeze([ \"float\", \"unfilterable-float\" ]);\r\n\r\n/** Shader stages, as a bit position in the visibility mask. */\r\nexport const CARBON_BACKEND_VISIBILITY = Object.freeze([ \"vertex\", \"fragment\", \"compute\" ]);\r\n\r\n// The transform section is shared with the GLSL block; both re-export the\r\n// family enum and defaults so a consumer of either codec sees them.\r\nexport { CARBON_BACKEND_TRANSFORM_FAMILY, DETAIL_MAP_ARRAY_DEFAULTS };\r\n\r\n/** Marks an absent optional `u32`. Carbon's null-reference value. */\r\nconst ABSENT = 0xffffffff;\r\n\r\n/**\r\n * Encodes a visibility list as a bit mask.\r\n *\r\n * @param {string[]} visibility Stage names.\r\n * @returns {number} Bit mask.\r\n */\r\nfunction packVisibility(visibility)\r\n{\r\n    let mask = 0;\r\n    for (const stage of visibility ?? [])\r\n    {\r\n        const bit = CARBON_BACKEND_VISIBILITY.indexOf(stage);\r\n        if (bit < 0)\r\n        {\r\n            throw new CjsFormatWriteError(`Unknown binding visibility \"${stage}\"`, { stage });\r\n        }\r\n        mask |= 1 << bit;\r\n    }\r\n    return mask;\r\n}\r\n\r\n/**\r\n * Decodes a visibility bit mask, in the canonical stage order.\r\n *\r\n * @param {number} mask Bit mask.\r\n * @returns {string[]} Stage names.\r\n */\r\nfunction unpackVisibility(mask)\r\n{\r\n    const stages = [];\r\n    for (let bit = 0; bit < CARBON_BACKEND_VISIBILITY.length; bit += 1)\r\n    {\r\n        if (mask & (1 << bit)) stages.push(CARBON_BACKEND_VISIBILITY[bit]);\r\n    }\r\n    return stages;\r\n}\r\n\r\n/**\r\n * Rebuilds a binding's WebGPU descriptor from what the block does store.\r\n *\r\n * The descriptor — `buffer`, `texture` or `sampler` — is not on the wire because\r\n * it is a pure function of the WGSL type, the resource kind and the structure\r\n * stride, all three of which are. `lowerBindingLayout.js` derives it from the\r\n * same three inputs on the way out; this derives it back on the way in.\r\n *\r\n * The pairs that could collide do not. `array<u32>` reaches both a structured\r\n * buffer and a compute typed buffer, and the structure stride separates them:\r\n * structured always carries one, typed never does.\r\n *\r\n * One texture fact is not in the WGSL type and is stored: its sample type.\r\n * `texture_2d<f32>` is the same declaration whether the layout says `float` or\r\n * `unfilterable-float`, and only the lowering, which sees the instructions,\r\n * knows a texture is only ever loaded.\r\n *\r\n * @param {object} binding Decoded binding record.\r\n * @returns {object} The descriptor fragment, as one `{buffer|texture|sampler}` key.\r\n */\r\nfunction deriveBindingDescriptor(binding)\r\n{\r\n    const stride = binding.structureStride;\r\n\r\n    if (binding.resourceKind === \"sampler\")\r\n    {\r\n        return { sampler: { type: \"filtering\" } };\r\n    }\r\n\r\n    if (binding.resourceKind === \"uniform-buffer\")\r\n    {\r\n        const vec4Count = /^array<vec4<f32>, (\\d+)>$/u.exec(binding.type)?.[1];\r\n        if (!vec4Count)\r\n        {\r\n            throw new CjsFormatReadError(\r\n                `Backend block uniform binding has untranslatable type \"${binding.type}\"`,\r\n                { type: binding.type }\r\n            );\r\n        }\r\n        return {\r\n            buffer: {\r\n                type: \"uniform\",\r\n                hasDynamicOffset: false,\r\n                minBindingSize: Number(vec4Count) * 16\r\n            }\r\n        };\r\n    }\r\n\r\n    if (binding.resourceKind === \"sampled-resource\")\r\n    {\r\n        const texture = TEXTURE_DESCRIPTORS[binding.type];\r\n        if (texture) return { texture: { ...texture, sampleType: binding.textureSampleType } };\r\n\r\n        return {\r\n            buffer: {\r\n                type: \"read-only-storage\",\r\n                hasDynamicOffset: false,\r\n                minBindingSize: stride === undefined ? 4 : stride\r\n            }\r\n        };\r\n    }\r\n\r\n    return {\r\n        buffer: {\r\n            type: \"storage\",\r\n            hasDynamicOffset: false,\r\n            minBindingSize: stride === undefined ? 4 : stride\r\n        }\r\n    };\r\n}\r\n\r\n/** Texture descriptors by WGSL type (`lowerBindingLayout.js:90-95`). */\r\nconst TEXTURE_DESCRIPTORS = Object.freeze({\r\n    \"texture_2d<f32>\": Object.freeze({ sampleType: \"float\", viewDimension: \"2d\", multisampled: false }),\r\n    \"texture_cube<f32>\": Object.freeze({ sampleType: \"float\", viewDimension: \"cube\", multisampled: false }),\r\n    \"texture_3d<f32>\": Object.freeze({ sampleType: \"float\", viewDimension: \"3d\", multisampled: false }),\r\n    \"texture_2d_array<f32>\": Object.freeze({ sampleType: \"float\", viewDimension: \"2d-array\", multisampled: false })\r\n});\r\n\r\n/**\r\n * Serialises one pass's backend block.\r\n *\r\n * @param {object} block Block contents.\r\n * @param {object[]} [block.bindGroups] Bind groups with their bindings.\r\n * @param {object[]} [block.transforms] Resource transforms.\r\n * @returns {Uint8Array} Self-contained block bytes.\r\n */\r\n/**\r\n * Refuses a binding whose derived fields disagree with what the reader rebuilds.\r\n *\r\n * `identity`, `scopeIdentity` and the per-binding `group` are not stored: the\r\n * reader recomputes them from the register triple, the visibility mask and the\r\n * enclosing group. A binding that carries a different value therefore does not\r\n * fail - it round-trips into a different binding, and the engine matches on\r\n * exactly these strings.\r\n *\r\n * `scopeIdentity` deserves the sharpest check, because the wire cannot preserve\r\n * what it is derived from. Visibility is stored as a **bitmask**, so it is a\r\n * set; `scopeIdentity` is built from `visibility[0]`, so it depends on an\r\n * order. A binding written as `[fragment, vertex]` reads back as\r\n * `[vertex, fragment]` and its scope silently moves from `@fragment` to\r\n * `@vertex`. Canonical order is the only order the format can represent, so a\r\n * producer must write it.\r\n *\r\n * @param {object} binding Binding record.\r\n * @param {object} group Enclosing bind group.\r\n */\r\nfunction assertDerivedBindingFieldsAgree(binding, group)\r\n{\r\n    const identity = `${binding.resourceKind}:${binding.registerSpace}:${binding.registerIndex}`;\r\n    const canonical = unpackVisibility(packVisibility(binding.visibility));\r\n    const derived = [\r\n        [ \"identity\", binding.identity, identity ],\r\n        [ \"scopeIdentity\", binding.scopeIdentity, `${identity}@${canonical[0]}` ],\r\n        [ \"group\", binding.group, group.group ]\r\n    ];\r\n\r\n    for (const [ field, actual, expected ] of derived)\r\n    {\r\n        if (actual === undefined || actual === null) continue;\r\n        if (actual === expected) continue;\r\n\r\n        throw new CjsFormatWriteError(\r\n            `Binding ${identity} sets ${field} to ${JSON.stringify(actual)}, but the reader rebuilds`\r\n            + ` ${JSON.stringify(expected)}. The value is not stored, so writing this would silently`\r\n            + ` change the binding.`,\r\n            { identity, field, actual, expected }\r\n        );\r\n    }\r\n}\r\n\r\n/**\r\n * Encode one canonical backend binding and transform block.\r\n * @param {object} block Backend block record.\r\n * @returns {Uint8Array} Encoded backend bytes.\r\n */\r\nexport function writeBackendBlock(block)\r\n{\r\n    const bindGroups = block.bindGroups ?? [];\r\n    const transforms = block.transforms ?? [];\r\n    const writer = new CjsByteWriter(256);\r\n\r\n    writer.u8(CARBON_BACKEND_ENGINE_ID.webgpu);\r\n\r\n    writer.u8(bindGroups.length);\r\n    for (const group of bindGroups)\r\n    {\r\n        writer.u8(group.group);\r\n        writer.u8(group.bindings.length);\r\n        for (const binding of group.bindings)\r\n        {\r\n            const kind = CARBON_BACKEND_RESOURCE_KIND.indexOf(binding.resourceKind);\r\n            if (kind < 0)\r\n            {\r\n                throw new CjsFormatWriteError(`Unknown resource kind \"${binding.resourceKind}\"`, {\r\n                    resourceKind: binding.resourceKind\r\n                });\r\n            }\r\n            assertDerivedBindingFieldsAgree(binding, group);\r\n            writer.u8(kind);\r\n            writer.u8(binding.registerSpace);\r\n            writer.u8(binding.binding);\r\n            writer.u8(packVisibility(binding.visibility));\r\n            writer.u32(binding.registerIndex);\r\n            writer.u32(binding.structureStride ?? ABSENT);\r\n            writer.u8(binding.arrayLayerCount ?? 0);\r\n            const sampleType = CARBON_BACKEND_TEXTURE_SAMPLE_TYPE.indexOf(binding.texture?.sampleType ?? \"float\");\r\n            if (sampleType < 0)\r\n            {\r\n                throw new CjsFormatWriteError(`Unknown texture sample type \"${binding.texture.sampleType}\"`, {\r\n                    sampleType: binding.texture.sampleType\r\n                });\r\n            }\r\n            writer.u8(sampleType);\r\n            writeInlineString(writer, binding.type);\r\n            writeInlineString(writer, binding.generatedSymbol);\r\n            // A binding either carries a transform id or it does not; an empty\r\n            // string is not a legal id, so length zero encodes absence.\r\n            writeInlineString(writer, binding.transformId ?? \"\");\r\n        }\r\n    }\r\n\r\n    writeTransformSection(writer, transforms);\r\n\r\n    return writer.toBytes();\r\n}\r\n\r\n/**\r\n * Parses one pass's backend block, restoring every derived field.\r\n *\r\n * @param {ArrayBuffer|ArrayBufferView|Uint8Array} bytes Block bytes.\r\n * @param {object} [options] Read options.\r\n * @param {string} [options.layoutKey] Enclosing pass key, restored onto records.\r\n * @param {string} [options.source] Source name for error details.\r\n * @returns {object} Block contents with derived fields restored.\r\n */\r\nexport function readBackendBlock(bytes, options = {})\r\n{\r\n    const reader = new CjsByteReader(bytes, { source: options.source ?? \"backend block\" });\r\n    const layoutKey = options.layoutKey ?? null;\r\n\r\n    readBackendEngineId(reader, CARBON_BACKEND_ENGINE_ID.webgpu, options.source ?? \"backend block\");\r\n\r\n    const bindGroups = [];\r\n    const groupCount = reader.ReadUint8();\r\n    for (let groupIndex = 0; groupIndex < groupCount; groupIndex += 1)\r\n    {\r\n        const group = reader.ReadUint8();\r\n        const bindings = [];\r\n        const bindingCount = reader.ReadUint8();\r\n        for (let index = 0; index < bindingCount; index += 1)\r\n        {\r\n            const resourceKind = CARBON_BACKEND_RESOURCE_KIND[reader.ReadUint8()];\r\n            const registerSpace = reader.ReadUint8();\r\n            const binding = reader.ReadUint8();\r\n            const visibility = unpackVisibility(reader.ReadUint8());\r\n            const registerIndex = reader.ReadUint32();\r\n            const structureStride = reader.ReadUint32();\r\n            const arrayLayerCount = reader.ReadUint8();\r\n            const textureSampleType = CARBON_BACKEND_TEXTURE_SAMPLE_TYPE[reader.ReadUint8()];\r\n            if (!textureSampleType)\r\n            {\r\n                throw new CjsFormatReadError(\"Backend block binding has an unknown texture sample type\", {\r\n                    source: options.source ?? \"backend block\"\r\n                });\r\n            }\r\n            const type = readInlineString(reader);\r\n            const generatedSymbol = readInlineString(reader);\r\n            const transformId = readInlineString(reader);\r\n\r\n            const identity = `${resourceKind}:${registerSpace}:${registerIndex}`;\r\n            const record = {\r\n                group,\r\n                binding,\r\n                resourceKind,\r\n                registerSpace,\r\n                registerIndex,\r\n                visibility,\r\n                type,\r\n                generatedSymbol,\r\n                identity,\r\n                scopeIdentity: `${identity}@${visibility[0]}`,\r\n                ...(structureStride === ABSENT ? {} : { structureStride }),\r\n                ...(arrayLayerCount === 0 ? {} : { arrayLayerCount }),\r\n                ...(transformId === \"\" ? {} : { transformId })\r\n            };\r\n            bindings.push({ ...record, ...deriveBindingDescriptor({ ...record, textureSampleType }) });\r\n        }\r\n        bindGroups.push({ group, bindings });\r\n    }\r\n\r\n    const transforms = readTransformSection(reader, layoutKey);\r\n\r\n    // A sized record must land exactly on its declared end. Trailing bytes mean\r\n    // the writer knew fields this reader does not, which with no version byte is\r\n    // the ONLY signal that a block came from a different build - so this check is\r\n    // load-bearing rather than defensive.\r\n    // This is the only surviving form of a closed-schema check: under a record\r\n    // layout a field either exists at its offset or the read fails, so there is\r\n    // nothing per-field left to assert, but exhaustiveness is still checkable and\r\n    // is exactly what a silently-discarded tail would violate.\r\n    if (reader.remaining !== 0)\r\n    {\r\n        throw new CjsFormatReadError(\r\n            `Backend block has ${reader.remaining} unparsed trailing byte(s); rebuild the effect package`,\r\n            { source: options.source ?? \"backend block\", trailingBytes: reader.remaining }\r\n        );\r\n    }\r\n\r\n    return {\r\n        layoutKey,\r\n        bindGroups,\r\n        transforms,\r\n        trailingBytes: 0\r\n    };\r\n}\r\n"],"names":["CARBON_BACKEND_RESOURCE_KIND","Object","freeze","CARBON_BACKEND_TEXTURE_SAMPLE_TYPE","CARBON_BACKEND_VISIBILITY","ABSENT","packVisibility","visibility","mask","stage","bit","indexOf","CjsFormatWriteError","unpackVisibility","stages","length","push","deriveBindingDescriptor","binding","stride","structureStride","resourceKind","sampler","type","vec4Count","exec","CjsFormatReadError","buffer","hasDynamicOffset","minBindingSize","Number","texture","TEXTURE_DESCRIPTORS","sampleType","textureSampleType","undefined","viewDimension","multisampled","assertDerivedBindingFieldsAgree","group","identity","registerSpace","registerIndex","canonical","derived","scopeIdentity","field","actual","expected","JSON","stringify","writeBackendBlock","block","bindGroups","transforms","writer","CjsByteWriter","u8","CARBON_BACKEND_ENGINE_ID","webgpu","bindings","kind","u32","arrayLayerCount","writeInlineString","generatedSymbol","transformId","writeTransformSection","toBytes","readBackendBlock","bytes","options","reader","CjsByteReader","source","layoutKey","readBackendEngineId","groupCount","ReadUint8","groupIndex","bindingCount","index","ReadUint32","readInlineString","record","readTransformSection","remaining","trailingBytes"],"mappings":"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"}

package/dist/resource/format/index.js

@@ -5,10 +5,12 @@ export { CjsBitReader, readBitAt, readBitsAt } from './CjsBitReader.js';
 export { CjsByteWriter } from './CjsByteWriter.js';
 export { CJS_STRING_TABLE_NULL_REFERENCE, CjsStringTable, compareTableBlobs } from './CjsStringTable.js';
 export { CARBON_ANNOTATION_TYPE, CARBON_EFFECT_COUNT_CAPS, CARBON_EFFECT_DATA_VERSION, CARBON_EFFECT_MIN_DATA_VERSION, CARBON_EFFECT_WRITE_VERSIONS, CARBON_SHADER_CONSTANTS_MAX, collectArena, compareAnnotationNames, internArena, passthroughArena, readEffectDescription, resolveWriteVersion, writeEffectDescription } from './carbonEffect/carbonEffectRecords.js';
-export { CARBON_BACKEND_RESOURCE_KIND, CARBON_BACKEND_VISIBILITY, readBackendBlock, writeBackendBlock } from './carbonEffect/carbonEffectBackendBlock.js';
+export { CARBON_BACKEND_RESOURCE_KIND, CARBON_BACKEND_TEXTURE_SAMPLE_TYPE, CARBON_BACKEND_VISIBILITY, readBackendBlock, writeBackendBlock } from './carbonEffect/carbonEffectBackendBlock.js';
 export { CARBON_EFFECT_RECORD_BYTES, CARBON_EFFECT_SOURCE_HASH_BYTES, CjsCarbonEffectBodyReader, CjsCarbonEffectReader, looksLikeCarbonEffectContainer } from './carbonEffect/CjsCarbonEffectReader.js';
 export { CjsCarbonEffectWriter, writeCarbonEffectFile } from './carbonEffect/CjsCarbonEffectWriter.js';
 export { CjsFormat, CjsFormatOutputRole, CjsFormatReadMode } from './CjsFormat.js';
+export { CjsImageFormat } from './CjsImageFormat.js';
+export { CjsGeometryFormat } from './CjsGeometryFormat.js';
 export { CjsFormatRoute, CjsFormatStore } from './CjsFormatStore.js';
 export { ResourcePayloadType, ResourcePayloadValues, validateAudioPayload, validateRgbaPayload, validateTexturePayload, validateVideoPayload } from './payloadContract.js';
 export { CARBON_BACKEND_TRANSFORM_FAMILY, DETAIL_MAP_ARRAY_DEFAULTS } from './carbonEffect/carbonEffectResourceTransform.js';

package/dist/resource/format/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;"}

package/dist/resource/formats/black/CjsBlackFormat.js

@@ -1,16 +1,16 @@
 import { CjsFormat } from '../../format/CjsFormat.js';
 import { CLASS_KEYS } from './core/schema.js';
 import { DEFAULT_VALUES, OUTPUT_JSON, OUTPUT_PAYLOAD, normalizeValues, validateClassKey, validateClass, toJsonValue, OUTPUT_DOCUMENT, OUTPUT_RAW, OUTPUT_RUNTIME } from './core/helpers.js';
-import { CJS_BLACK_FOURCC, CJS_BLACK_FORMAT_ID, CJS_BLACK_EXTENSION, CJS_BLACK_VERSION } from './core/blackConstants.js';
+import { CJS_BLACK_FOURCC, CJS_BLACK_EXTENSION, CJS_BLACK_VERSION } from './core/blackConstants.js';
 import { CjsBlackReader } from './core/CjsBlackReader.js';
 
 const FORMAT_NAME = "CjsBlackFormat";
 
-/**
- * CarbonEngineJS-facing Black format profile.
- *
- * This package reads public-facing `.black` payload data using CarbonEngineJS
- * canonical schemas or source-shape registries.
+/**
+ * CarbonEngineJS-facing Black format profile.
+ *
+ * This package reads public-facing `.black` payload data using CarbonEngineJS
+ * canonical schemas or source-shape registries.
  */
 class CjsBlackFormat extends CjsFormat {
   #emit = DEFAULT_VALUES.emit;
@@ -18,33 +18,33 @@ class CjsBlackFormat extends CjsFormat {
   #readerOptions = {};
   #classes = {};
 
-  /**
-   * Plain payload outputs can be decoded in a browser worker. Document and
-   * runtime outputs retain class identity and therefore stay on the caller
-   * thread.
+  /**
+   * Plain payload outputs can be decoded in a browser worker. Document and
+   * runtime outputs retain class identity and therefore stay on the caller
+   * thread.
    */
-  static worker = Object.freeze({
+  static worker = {
     module: import.meta.url,
     exportName: "CjsBlackFormat",
     outputTypes: Object.freeze([OUTPUT_JSON, OUTPUT_PAYLOAD]),
     defaultOutput: OUTPUT_JSON
-  });
+  };
 
-  /**
-   * Create a reusable format profile.
-   *
-   * @param {object} [options] Default format values.
+  /**
+   * Create a reusable format profile.
+   *
+   * @param {object} [options] Default format values.
    */
   constructor(options = {}) {
     super();
     this.SetValues(options);
   }
 
-  /**
-   * Set format values for this reusable profile.
-   *
-   * @param {object} [options] Values to merge into the profile.
-   * @returns {CjsBlackFormat} This format profile.
+  /**
+   * Set format values for this reusable profile.
+   *
+   * @param {object} [options] Values to merge into the profile.
+   * @returns {CjsBlackFormat} This format profile.
    */
   SetValues(options = {}) {
     const values = normalizeValues(this.GetValues(), options, CLASS_KEYS, FORMAT_NAME);
@@ -55,11 +55,11 @@ class CjsBlackFormat extends CjsFormat {
     return this;
   }
 
-  /**
-   * Get this profile's current values, optionally with per-call overrides.
-   *
-   * @param {object} [options] Optional values to merge into a copy.
-   * @returns {object} A copy of the effective values.
+  /**
+   * Get this profile's current values, optionally with per-call overrides.
+   *
+   * @param {object} [options] Optional values to merge into a copy.
+   * @returns {object} A copy of the effective values.
    */
   GetValues(options = {}) {
     return normalizeValues({
@@ -70,11 +70,11 @@ class CjsBlackFormat extends CjsFormat {
     }, options, CLASS_KEYS, FORMAT_NAME);
   }
 
-  /**
-   * Set multiple runtime class constructors for this profile.
-   *
-   * @param {object} [classes] Map of Black class names to constructors.
-   * @returns {CjsBlackFormat} This format profile.
+  /**
+   * Set multiple runtime class constructors for this profile.
+   *
+   * @param {object} [classes] Map of Black class names to constructors.
+   * @returns {CjsBlackFormat} This format profile.
    */
   SetClasses(classes = {}) {
     return this.SetValues({
@@ -82,12 +82,12 @@ class CjsBlackFormat extends CjsFormat {
     });
   }
 
-  /**
-   * Set one node-class constructor for this profile.
-   *
-   * @param {string} type Black class name.
-   * @param {Function|null|undefined} Class Constructor to use, or nullish to delete.
-   * @returns {CjsBlackFormat} This format profile.
+  /**
+   * Set one node-class constructor for this profile.
+   *
+   * @param {string} type Black class name.
+   * @param {Function|null|undefined} Class Constructor to use, or nullish to delete.
+   * @returns {CjsBlackFormat} This format profile.
    */
   SetClass(type, Class) {
     validateClassKey(CLASS_KEYS, type, FORMAT_NAME);
@@ -103,98 +103,98 @@ class CjsBlackFormat extends CjsFormat {
     return this;
   }
 
-  /**
-   * Get a configured runtime class constructor.
-   *
-   * @param {string} type Black class name.
-   * @returns {Function|undefined} The registered constructor, if any.
+  /**
+   * Get a configured runtime class constructor.
+   *
+   * @param {string} type Black class name.
+   * @returns {Function|undefined} The registered constructor, if any.
    */
   GetClass(type) {
     validateClassKey(CLASS_KEYS, type, FORMAT_NAME);
     return this.#classes[type];
   }
 
-  /**
-   * Whether this format profile has a constructor registered for a node key.
-   *
-   * @param {string} type Node class key.
-   * @returns {boolean} True when a constructor is registered.
+  /**
+   * Whether this format profile has a constructor registered for a node key.
+   *
+   * @param {string} type Node class key.
+   * @returns {boolean} True when a constructor is registered.
    */
   HasClass(type) {
     return !!this.GetClass(type);
   }
 
-  /**
-   * Read Black data with this profile's values.
-   *
-   * @param {unknown} input Black format input.
-   * @param {object} [options] Per-call value overrides.
-   * @returns {object} Public payload output by default.
+  /**
+   * Read Black data with this profile's values.
+   *
+   * @param {unknown} input Black format input.
+   * @param {object} [options] Per-call value overrides.
+   * @returns {object} Public payload output by default.
    */
   Read(input, options = {}) {
     return CjsBlackFormat.read(input, this.GetValues(options));
   }
 
-  /**
-   * Read Black data as a neutral document graph for diagnostics.
-   *
-   * @param {unknown} input Black format input.
-   * @param {object} [options] Per-call value overrides.
-   * @returns {object} CarbonEngineJS document graph.
+  /**
+   * Read Black data as a neutral document graph for diagnostics.
+   *
+   * @param {unknown} input Black format input.
+   * @param {object} [options] Per-call value overrides.
+   * @returns {object} CarbonEngineJS document graph.
    */
   ReadDocument(input, options = {}) {
     return CjsBlackFormat.readDocument(input, this.GetValues(options));
   }
 
-  /**
-   * Read Black data as runtime objects or plain source-shaped objects.
-   *
-   * @param {unknown} input Black format input.
-   * @param {object} [options] Per-call value overrides.
-   * @returns {object} Runtime read result.
+  /**
+   * Read Black data as runtime objects or plain source-shaped objects.
+   *
+   * @param {unknown} input Black format input.
+   * @param {object} [options] Per-call value overrides.
+   * @returns {object} Runtime read result.
    */
   ReadRuntime(input, options = {}) {
     return CjsBlackFormat.readRuntime(input, this.GetValues(options));
   }
 
-  /**
-   * Read Black data as compact public payload JSON.
-   *
-   * @param {unknown} input Black format input.
-   * @param {object} [options] Per-call value overrides.
-   * @returns {object} Public payload output.
+  /**
+   * Read Black data as compact public payload JSON.
+   *
+   * @param {unknown} input Black format input.
+   * @param {object} [options] Per-call value overrides.
+   * @returns {object} Public payload output.
    */
   ReadPayload(input, options = {}) {
     return CjsBlackFormat.readPayload(input, this.GetValues(options));
   }
 
-  /**
-   * Inspect Black data with this profile's values.
-   *
-   * @param {unknown} input Black format input.
-   * @param {object} [options] Per-call value overrides.
-   * @returns {object} Plain summary data.
+  /**
+   * Inspect Black data with this profile's values.
+   *
+   * @param {unknown} input Black format input.
+   * @param {object} [options] Per-call value overrides.
+   * @returns {object} Plain summary data.
    */
   Inspect(input, options = {}) {
     return CjsBlackFormat.inspect(input, this.GetValues(options));
   }
 
-  /**
-   * Convert format output to JSON-compatible data.
-   *
-   * @param {any} value Format output to convert.
-   * @returns {any} Plain JSON-compatible data.
+  /**
+   * Convert format output to JSON-compatible data.
+   *
+   * @param {any} value Format output to convert.
+   * @returns {any} Plain JSON-compatible data.
    */
   ToJSON(value) {
     return toJsonValue(value);
   }
 
-  /**
-   * Static one-shot read. Static methods use camelCase by convention.
-   *
-   * @param {unknown} input Black format input.
-   * @param {object} [options] Format values.
-   * @returns {object} Format output.
+  /**
+   * Static one-shot read. Static methods use camelCase by convention.
+   *
+   * @param {unknown} input Black format input.
+   * @param {object} [options] Format values.
+   * @returns {object} Format output.
    */
   static read(input, options = {}) {
     const values = normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME);
@@ -203,89 +203,82 @@ class CjsBlackFormat extends CjsFormat {
     return CjsBlackFormat.readPayload(input, values);
   }
 
-  /**
-   * Static one-shot document read.
-   *
-   * @param {unknown} input Black format input.
-   * @param {object} [options] Format values.
-   * @returns {object} CarbonEngineJS document graph.
+  /**
+   * Static one-shot document read.
+   *
+   * @param {unknown} input Black format input.
+   * @param {object} [options] Format values.
+   * @returns {object} CarbonEngineJS document graph.
    */
   static readDocument(input, options = {}) {
     return new CjsBlackReader(input, normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME)).ReadDocument();
   }
 
-  /**
-   * Static one-shot runtime read.
-   *
-   * @param {unknown} input Black format input.
-   * @param {object} [options] Format values.
-   * @returns {object} Runtime read result.
+  /**
+   * Static one-shot runtime read.
+   *
+   * @param {unknown} input Black format input.
+   * @param {object} [options] Format values.
+   * @returns {object} Runtime read result.
    */
   static readRuntime(input, options = {}) {
     return new CjsBlackReader(input, normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME)).ReadRuntime();
   }
 
-  /**
-   * Static one-shot public payload read.
-   *
-   * @param {unknown} input Black format input.
-   * @param {object} [options] Format values.
-   * @returns {object} Public payload output.
+  /**
+   * Static one-shot public payload read.
+   *
+   * @param {unknown} input Black format input.
+   * @param {object} [options] Format values.
+   * @returns {object} Public payload output.
    */
   static readPayload(input, options = {}) {
     return new CjsBlackReader(input, normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME)).ReadPayload();
   }
 
-  /**
-   * Static one-shot inspection.
-   *
-   * @param {unknown} input Black format input.
-   * @param {object} [options] Format values.
-   * @returns {object} Plain summary data.
+  /**
+   * Static one-shot inspection.
+   *
+   * @param {unknown} input Black format input.
+   * @param {object} [options] Format values.
+   * @returns {object} Plain summary data.
    */
   static inspect(input, options = {}) {
     return new CjsBlackReader(input, normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME)).Inspect();
   }
 
-  /**
-   * Static JSON-compatible conversion.
-   *
-   * @param {any} value Format output to convert.
-   * @returns {any} Plain JSON-compatible data.
+  /**
+   * Static JSON-compatible conversion.
+   *
+   * @param {any} value Format output to convert.
+   * @returns {any} Plain JSON-compatible data.
    */
   static toJSON(value) {
     return toJsonValue(value);
   }
 
-  /**
-   * Performs the bounded Black content discriminator used by ordered object
-   * routes. Magic selects the Black reader; version and body failures remain
-   * that reader's errors and are never reinterpreted as Red/YAML.
-   *
-   * @param {ArrayBuffer|ArrayBufferView} input Candidate source bytes.
-   * @returns {boolean} True when the little-endian Black magic is present.
+  /**
+   * Performs the bounded Black content discriminator used by ordered object
+   * routes. Magic selects the Black reader; version and body failures remain
+   * that reader's errors and are never reinterpreted as Red/YAML.
+   *
+   * @param {ArrayBuffer|ArrayBufferView} input Candidate source bytes.
+   * @returns {boolean} True when the little-endian Black magic is present.
    */
   static probeSupport(input) {
     const view = getBlackProbeView(input);
     return Boolean(view && view.byteLength >= 4 && view.getUint32(0, true) === CJS_BLACK_FOURCC);
   }
 
-  /**
-   * Emit targets for this format (canonical frozen enum).
+  /**
+   * Emit targets for this format (canonical frozen enum).
    */
-  static Output = Object.freeze({
-    JSON: OUTPUT_JSON,
-    RAW: OUTPUT_RAW,
-    DOCUMENT: OUTPUT_DOCUMENT,
-    PAYLOAD: OUTPUT_PAYLOAD,
-    RUNTIME: OUTPUT_RUNTIME
-  });
-  static CLASS_KEYS = CLASS_KEYS;
-  static id = CJS_BLACK_FORMAT_ID;
-  static extensions = Object.freeze([CJS_BLACK_EXTENSION]);
+  static classKeys = CLASS_KEYS;
+  static id = "CjsBlackFormat";
+  static extensions = [CJS_BLACK_EXTENSION];
   static fourCC = CJS_BLACK_FOURCC;
   static version = CJS_BLACK_VERSION;
-  static mediaTypes = Object.freeze(["data"]);
+  static mediaTypes = ["data"];
   static outputs = CjsFormat.defineOutputs({
     json: {
       default: true,