@carbonenginejs/runtime-resource 0.12.2 → 0.14.0

package/dist/formats/webgpu/core/buildCarbonEffectContainer.js

@@ -1,47 +1,20 @@
 import '../../../format/compareUtf8.js';
 import { writeBackendBlock } from '../../../format/carbonEffect/carbonEffectBackendBlock.js';
-import { carbonDescriptionFromPortable } from '../../../format/carbonEffect/carbonDescriptionFromPortable.js';
 import '../../../format/CjsByteReader.js';
-import { CjsCarbonEffectWriter } from '../../../format/carbonEffect/CjsCarbonEffectWriter.js';
-import { buildEffectBodyReflection } from '../../hlsl/core/portableReflection.js';
+import '../../../format/carbonEffect/CjsCarbonEffectWriter.js';
+import { buildCarbonEffectContainer as buildCarbonEffectContainer$1 } from '../../../format/carbonEffect/buildCarbonEffectContainer.js';
 
 /**
- * Assembles the WebGPU effect container: Carbon's v15 record layout carrying
- * WGSL where a shipped file carries DXBC.
+ * The WebGPU backend adapter for the shared Carbon container builder.
  *
- * The Carbon record layout is shared across backends. CEWGPU replaces stage
- * program bytes with WGSL or an empty slot and adds one optional trailing block
- * per pass. The portable-to-Carbon mapping retains representable non-program
- * fields; non-dynamic sampler names are unrecoverable and stage order is
- * canonicalized.
- */
-
-/**
- * There is no envelope, no magic and no version of our own. That is deliberate.
- *
- * A twelve-byte prefix (`magic | containerVersion | payloadKind`) was carried
- * here and has been removed, along with a proposed "v16" for this variant.
- * Neither survived the only question worth asking of an addition: what breaks
- * without it?
+ * Everything about the record layout, the permutation walk and the description
+ * mapping lives in `format/carbonEffect/buildCarbonEffectContainer.js` and is
+ * shared with WebGL. What remains here is the two things that are genuinely
+ * WGSL: how a program becomes bytes, and what a pass's trailing block contains.
  *
- * - `payloadKind` is redundant with the directory the file came from. CEWGPU
- *   identity belongs to the `effect.webgpu/` resource path; `.cewg` remains a
- *   separate CEWG chunk format.
- * - The magic only distinguished our file from a Carbon one, which the same
- *   directory already answers, and which the file *name* answers too.
- * - A version of our own would have claimed a number CCP owns, in the one field
- *   whose job is telling a reader how to parse. A real v16 from them would then
- *   collide with ours.
- *
- * What remains is a bare Carbon v15 record file. `CewgpuContainer` reads it and
- * the shared record reader detects the per-pass block from the description's
- * declared end. Direct `Tr2EffectRes` hydration remains an adapter boundary:
- * a Carbon description tree is not the portable reflection envelope consumed
- * by `Tr2Shader.fromPortable`.
- *
- * The one addition that does survive the question is the block itself: WebGPU
- * bind-group layouts come from the lowered IR and are not derivable from Carbon
- * reflection, so without it there is no binding topology and no pipeline.
+ * The block carries bind-group layouts and resource transforms. Neither is
+ * derivable from Carbon reflection - Carbon records the D3D binding model, while
+ * `(group, binding, visibility, generatedSymbol)` comes from the lowered IR.
  */
 
 /**
@@ -57,6 +30,24 @@ import { buildEffectBodyReflection } from '../../hlsl/core/portableReflection.js
  */
 const WGSL_ENTRY_POINT = "main";
 
+/**
+ * Encodes one WGSL stage program.
+ *
+ * `sourceMap` is deliberately dropped. Its offsets index DXBC bytes, which this
+ * container does not carry, so it is a translator diagnostic rather than
+ * payload. It was separately measured to suppress no sharing, so keeping it
+ * would buy nothing either.
+ *
+ * @param {object} shader Translated shader record.
+ * @returns {Uint8Array} Program bytes.
+ */
+function encodeProgram(shader) {
+  if (shader.entryPoint !== WGSL_ENTRY_POINT) {
+    throw new Error(`WGSL shader ${shader.key} has entry point "${shader.entryPoint}"; ` + `the container omits the name because every lowerer emits "${WGSL_ENTRY_POINT}"`);
+  }
+  return new TextEncoder().encode(shader.code);
+}
+
 /**
  * Builds the per-pass backend block for one pass of one translated body.
  *
@@ -64,7 +55,7 @@ const WGSL_ENTRY_POINT = "main";
  * @param {string} passKey Enclosing pass key.
  * @returns {Uint8Array|null} Block bytes, or null when the pass has no layout.
  */
-function backendBlockFor(unit, passKey) {
+function encodeBackendBlock(unit, passKey) {
   const layout = unit.layouts.find(entry => entry.key === passKey);
   if (!layout) return null;
   return writeBackendBlock({
@@ -73,73 +64,11 @@ function backendBlockFor(unit, passKey) {
   });
 }
 
-/**
- * Maps one body's translated passes by pass key.
- *
- * @param {object} body Backend body-set record.
- * @param {Map<string, object>} unitsByKey Units indexed by key.
- * @returns {Map<string, object>} Units indexed by pass key.
- */
-function unitsByPassKey(body, unitsByKey) {
-  const result = new Map();
-  for (const pass of body.passes ?? []) {
-    result.set(pass.passKey, unitsByKey.get(pass.unitKey));
-  }
-  return result;
-}
-
-/**
- * Builds one body's Carbon description record tree with WGSL substituted in.
- *
- * A body the translator could not lower retains its representable non-program
- * description fields and carries zero-length programs. Emitting empty
- * `shaderData` says exactly what the wire knows: no backend program was stored.
- * Full portable source reflection remains in the in-memory build result, not
- * in this emitted body.
- *
- * @param {object} effectRes Loaded version-15 `Tr2EffectRes`.
- * @param {number} permutationIndex Representative permutation for this body.
- * @param {Map<string, object>|null} passUnits Units by pass key, or null when unsupported.
- * @returns {object} Description record tree.
- */
-function describeBody(effectRes, permutationIndex, passUnits) {
-  const reflection = buildEffectBodyReflection(effectRes, permutationIndex);
-  if (!passUnits) {
-    return carbonDescriptionFromPortable(reflection, {
-      programFor: () => ({
-        bytes: new Uint8Array(0),
-        size: 0
-      })
-    });
-  }
-  return carbonDescriptionFromPortable(reflection, {
-    programFor: (stage, context) => {
-      const unit = passUnits.get(context.passKey);
-      const shader = unit?.shaders.find(entry => entry.key === `${context.passKey}.${stage.stageName}`);
-      if (!shader) return {
-        bytes: new Uint8Array(0),
-        size: 0
-      };
-      if (shader.entryPoint !== WGSL_ENTRY_POINT) {
-        throw new Error(`WGSL shader ${shader.key} has entry point "${shader.entryPoint}"; ` + `the container omits the name because every lowerer emits "${WGSL_ENTRY_POINT}"`);
-      }
-
-      // `sourceMap` is deliberately dropped. Its offsets index DXBC bytes,
-      // which this container does not carry, so it is a translator
-      // diagnostic rather than payload. It was separately measured to
-      // suppress no sharing, so keeping it would buy nothing either.
-      const bytes = new TextEncoder().encode(shader.code);
-      return {
-        bytes,
-        size: bytes.byteLength
-      };
-    },
-    backendBlockFor: context => {
-      const unit = passUnits.get(context.passKey);
-      return unit ? backendBlockFor(unit, context.passKey) : null;
-    }
-  });
-}
+/** The WebGPU encoders, as the shared builder's backend argument. */
+const WGSL_CONTAINER_BACKEND = Object.freeze({
+  encodeProgram,
+  encodeBackendBlock
+});
 
 /**
  * Builds the complete WebGPU effect container.
@@ -150,48 +79,11 @@ function describeBody(effectRes, permutationIndex, passUnits) {
  * @param {object} [options] Container options.
  * @param {number[]|Uint8Array} [options.compilerVersion] Four version bytes.
  * @param {string} [options.sourceHash] 32 ASCII hash characters.
- * @returns {{bytes:Uint8Array, bodyCount:number, distinctBodyCount:number}} Container and its body accounting.
+ * @returns {{bytes:Uint8Array, permutationCount:number, bodyCount:number}} Container and its body accounting.
  */
 function buildCarbonEffectContainer(effectRes, permutationGraph, backendBodySet, options = {}) {
-  const unitsByKey = new Map(backendBodySet.passUnits.map(unit => [unit.key, unit]));
-  const bodyByKey = new Map(backendBodySet.bodies.map(body => [body.bodyKey, body]));
-  const writer = new CjsCarbonEffectWriter({
-    backend: true,
-    compilerVersion: options.compilerVersion ?? effectRes.m_compilerVersionBytes ?? [0, 0, 0, 0],
-    ...(options.sourceHash ? {
-      sourceHash: options.sourceHash
-    } : {})
-  });
-  for (const axis of permutationGraph.axes) {
-    writer.addPermutation({
-      name: axis.name,
-      defaultOption: axis.defaultOption,
-      description: axis.description,
-      type: axis.type,
-      options: axis.options
-    });
-  }
-
-  // Build one emitted description per source body key and reuse it for each
-  // matching permutation. The writer may dedupe additional descriptions when
-  // their emitted bytes become identical after source programs are replaced;
-  // the offset table remains dense.
-  const describedByBodyKey = new Map();
-  for (const [permutationIndex, variant] of permutationGraph.variants.entries()) {
-    let description = describedByBodyKey.get(variant.bodyKey);
-    if (!description) {
-      const body = bodyByKey.get(variant.bodyKey);
-      description = describeBody(effectRes, body?.representativePermutationIndex ?? permutationIndex, body?.status === "translated" ? unitsByPassKey(body, unitsByKey) : null);
-      describedByBodyKey.set(variant.bodyKey, description);
-    }
-    writer.addBody(permutationIndex, description);
-  }
-  return {
-    bytes: writer.toBytes(),
-    permutationCount: permutationGraph.variants.length,
-    bodyCount: describedByBodyKey.size
-  };
+  return buildCarbonEffectContainer$1(effectRes, permutationGraph, backendBodySet, WGSL_CONTAINER_BACKEND, options);
 }
 
-export { WGSL_ENTRY_POINT, buildCarbonEffectContainer };
+export { WGSL_CONTAINER_BACKEND, WGSL_ENTRY_POINT, buildCarbonEffectContainer };
 //# sourceMappingURL=buildCarbonEffectContainer.js.map

package/dist/formats/webgpu/core/buildCarbonEffectContainer.js.map

@@ -1 +1 @@
-{"version":3,"file":"buildCarbonEffectContainer.js","sources":["../../../../../src/formats/webgpu/core/buildCarbonEffectContainer.js"],"sourcesContent":["import {\n    CjsCarbonEffectWriter,\n    carbonDescriptionFromPortable,\n    writeBackendBlock\n} from \"../../../format/carbonEffect/index.js\";\nimport { buildEffectBodyReflection } from \"../../hlsl/core/portableReflection.js\";\n\n/**\n * Assembles the WebGPU effect container: Carbon's v15 record layout carrying\n * WGSL where a shipped file carries DXBC.\n *\n * The Carbon record layout is shared across backends. CEWGPU replaces stage\n * program bytes with WGSL or an empty slot and adds one optional trailing block\n * per pass. The portable-to-Carbon mapping retains representable non-program\n * fields; non-dynamic sampler names are unrecoverable and stage order is\n * canonicalized.\n */\n\n/**\n * There is no envelope, no magic and no version of our own. That is deliberate.\n *\n * A twelve-byte prefix (`magic | containerVersion | payloadKind`) was carried\n * here and has been removed, along with a proposed \"v16\" for this variant.\n * Neither survived the only question worth asking of an addition: what breaks\n * without it?\n *\n * - `payloadKind` is redundant with the directory the file came from. CEWGPU\n *   identity belongs to the `effect.webgpu/` resource path; `.cewg` remains a\n *   separate CEWG chunk format.\n * - The magic only distinguished our file from a Carbon one, which the same\n *   directory already answers, and which the file *name* answers too.\n * - A version of our own would have claimed a number CCP owns, in the one field\n *   whose job is telling a reader how to parse. A real v16 from them would then\n *   collide with ours.\n *\n * What remains is a bare Carbon v15 record file. `CewgpuContainer` reads it and\n * the shared record reader detects the per-pass block from the description's\n * declared end. Direct `Tr2EffectRes` hydration remains an adapter boundary:\n * a Carbon description tree is not the portable reflection envelope consumed\n * by `Tr2Shader.fromPortable`.\n *\n * The one addition that does survive the question is the block itself: WebGPU\n * bind-group layouts come from the lowered IR and are not derivable from Carbon\n * reflection, so without it there is no binding topology and no pipeline.\n */\n\n/**\n * The entry-point name every WGSL lowerer emits.\n *\n * Carbon's `StageInput` has no entry-point field, so the container can only omit\n * one if it is a constant of our emitter rather than data. It is: all thirteen\n * `lower*Program` modules write `entryPoint: \"main\"` literally. Measured constant\n * across 626 shaders in seven effects — but measurement only shows it holds\n * today, so the substitution asserts it. A future lowerer that picks a different\n * name fails the build instead of silently emitting a container whose programs\n * cannot be found.\n */\nexport const WGSL_ENTRY_POINT = \"main\";\n\n/**\n * Builds the per-pass backend block for one pass of one translated body.\n *\n * @param {object} unit Pass translation unit.\n * @param {string} passKey Enclosing pass key.\n * @returns {Uint8Array|null} Block bytes, or null when the pass has no layout.\n */\nfunction backendBlockFor(unit, passKey)\n{\n    const layout = unit.layouts.find((entry) => entry.key === passKey);\n    if (!layout) return null;\n\n    return writeBackendBlock({\n        bindGroups: layout.bindGroups,\n        transforms: (unit.resourceTransforms ?? [])\n            .filter((transform) => transform.layoutKey === passKey)\n    });\n}\n\n/**\n * Maps one body's translated passes by pass key.\n *\n * @param {object} body Backend body-set record.\n * @param {Map<string, object>} unitsByKey Units indexed by key.\n * @returns {Map<string, object>} Units indexed by pass key.\n */\nfunction unitsByPassKey(body, unitsByKey)\n{\n    const result = new Map();\n    for (const pass of body.passes ?? [])\n    {\n        result.set(pass.passKey, unitsByKey.get(pass.unitKey));\n    }\n    return result;\n}\n\n/**\n * Builds one body's Carbon description record tree with WGSL substituted in.\n *\n * A body the translator could not lower retains its representable non-program\n * description fields and carries zero-length programs. Emitting empty\n * `shaderData` says exactly what the wire knows: no backend program was stored.\n * Full portable source reflection remains in the in-memory build result, not\n * in this emitted body.\n *\n * @param {object} effectRes Loaded version-15 `Tr2EffectRes`.\n * @param {number} permutationIndex Representative permutation for this body.\n * @param {Map<string, object>|null} passUnits Units by pass key, or null when unsupported.\n * @returns {object} Description record tree.\n */\nfunction describeBody(effectRes, permutationIndex, passUnits)\n{\n    const reflection = buildEffectBodyReflection(effectRes, permutationIndex);\n\n    if (!passUnits)\n    {\n        return carbonDescriptionFromPortable(reflection, {\n            programFor: () => ({ bytes: new Uint8Array(0), size: 0 })\n        });\n    }\n\n    return carbonDescriptionFromPortable(reflection, {\n        programFor: (stage, context) =>\n        {\n            const unit = passUnits.get(context.passKey);\n            const shader = unit?.shaders.find(\n                (entry) => entry.key === `${context.passKey}.${stage.stageName}`\n            );\n\n            if (!shader) return { bytes: new Uint8Array(0), size: 0 };\n\n            if (shader.entryPoint !== WGSL_ENTRY_POINT)\n            {\n                throw new Error(\n                    `WGSL shader ${shader.key} has entry point \"${shader.entryPoint}\"; `\n                    + `the container omits the name because every lowerer emits \"${WGSL_ENTRY_POINT}\"`\n                );\n            }\n\n            // `sourceMap` is deliberately dropped. Its offsets index DXBC bytes,\n            // which this container does not carry, so it is a translator\n            // diagnostic rather than payload. It was separately measured to\n            // suppress no sharing, so keeping it would buy nothing either.\n            const bytes = new TextEncoder().encode(shader.code);\n            return { bytes, size: bytes.byteLength };\n        },\n        backendBlockFor: (context) =>\n        {\n            const unit = passUnits.get(context.passKey);\n            return unit ? backendBlockFor(unit, context.passKey) : null;\n        }\n    });\n}\n\n/**\n * Builds the complete WebGPU effect container.\n *\n * @param {object} effectRes Loaded version-15 `Tr2EffectRes`.\n * @param {object} permutationGraph Validated `PGRF` document.\n * @param {object} backendBodySet Translated backend bodies.\n * @param {object} [options] Container options.\n * @param {number[]|Uint8Array} [options.compilerVersion] Four version bytes.\n * @param {string} [options.sourceHash] 32 ASCII hash characters.\n * @returns {{bytes:Uint8Array, bodyCount:number, distinctBodyCount:number}} Container and its body accounting.\n */\nexport function buildCarbonEffectContainer(\n    effectRes,\n    permutationGraph,\n    backendBodySet,\n    options = {}\n)\n{\n    const unitsByKey = new Map(backendBodySet.passUnits.map((unit) => [ unit.key, unit ]));\n    const bodyByKey = new Map(backendBodySet.bodies.map((body) => [ body.bodyKey, body ]));\n    const writer = new CjsCarbonEffectWriter({\n        backend: true,\n        compilerVersion: options.compilerVersion ?? effectRes.m_compilerVersionBytes ?? [ 0, 0, 0, 0 ],\n        ...(options.sourceHash ? { sourceHash: options.sourceHash } : {})\n    });\n\n    for (const axis of permutationGraph.axes)\n    {\n        writer.addPermutation({\n            name: axis.name,\n            defaultOption: axis.defaultOption,\n            description: axis.description,\n            type: axis.type,\n            options: axis.options\n        });\n    }\n\n    // Build one emitted description per source body key and reuse it for each\n    // matching permutation. The writer may dedupe additional descriptions when\n    // their emitted bytes become identical after source programs are replaced;\n    // the offset table remains dense.\n    const describedByBodyKey = new Map();\n\n    for (const [ permutationIndex, variant ] of permutationGraph.variants.entries())\n    {\n        let description = describedByBodyKey.get(variant.bodyKey);\n\n        if (!description)\n        {\n            const body = bodyByKey.get(variant.bodyKey);\n            description = describeBody(\n                effectRes,\n                body?.representativePermutationIndex ?? permutationIndex,\n                body?.status === \"translated\" ? unitsByPassKey(body, unitsByKey) : null\n            );\n            describedByBodyKey.set(variant.bodyKey, description);\n        }\n\n        writer.addBody(permutationIndex, description);\n    }\n\n    return {\n        bytes: writer.toBytes(),\n        permutationCount: permutationGraph.variants.length,\n        bodyCount: describedByBodyKey.size\n    };\n}\n\nexport default buildCarbonEffectContainer;\n"],"names":["WGSL_ENTRY_POINT","backendBlockFor","unit","passKey","layout","layouts","find","entry","key","writeBackendBlock","bindGroups","transforms","resourceTransforms","filter","transform","layoutKey","unitsByPassKey","body","unitsByKey","result","Map","pass","passes","set","get","unitKey","describeBody","effectRes","permutationIndex","passUnits","reflection","buildEffectBodyReflection","carbonDescriptionFromPortable","programFor","bytes","Uint8Array","size","stage","context","shader","shaders","stageName","entryPoint","Error","TextEncoder","encode","code","byteLength","buildCarbonEffectContainer","permutationGraph","backendBodySet","options","map","bodyByKey","bodies","bodyKey","writer","CjsCarbonEffectWriter","backend","compilerVersion","m_compilerVersionBytes","sourceHash","axis","axes","addPermutation","name","defaultOption","description","type","describedByBodyKey","variant","variants","entries","representativePermutationIndex","status","addBody","toBytes","permutationCount","length","bodyCount"],"mappings":";;;;;;;AAOA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMA,gBAAgB,GAAG;;AAEhC;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,eAAeA,CAACC,IAAI,EAAEC,OAAO,EACtC;AACI,EAAA,MAAMC,MAAM,GAAGF,IAAI,CAACG,OAAO,CAACC,IAAI,CAAEC,KAAK,IAAKA,KAAK,CAACC,GAAG,KAAKL,OAAO,CAAC;AAClE,EAAA,IAAI,CAACC,MAAM,EAAE,OAAO,IAAI;AAExB,EAAA,OAAOK,iBAAiB,CAAC;IACrBC,UAAU,EAAEN,MAAM,CAACM,UAAU;AAC7BC,IAAAA,UAAU,EAAE,CAACT,IAAI,CAACU,kBAAkB,IAAI,EAAE,EACrCC,MAAM,CAAEC,SAAS,IAAKA,SAAS,CAACC,SAAS,KAAKZ,OAAO;AAC9D,GAAC,CAAC;AACN;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASa,cAAcA,CAACC,IAAI,EAAEC,UAAU,EACxC;AACI,EAAA,MAAMC,MAAM,GAAG,IAAIC,GAAG,EAAE;EACxB,KAAK,MAAMC,IAAI,IAAIJ,IAAI,CAACK,MAAM,IAAI,EAAE,EACpC;AACIH,IAAAA,MAAM,CAACI,GAAG,CAACF,IAAI,CAAClB,OAAO,EAAEe,UAAU,CAACM,GAAG,CAACH,IAAI,CAACI,OAAO,CAAC,CAAC;AAC1D,EAAA;AACA,EAAA,OAAON,MAAM;AACjB;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASO,YAAYA,CAACC,SAAS,EAAEC,gBAAgB,EAAEC,SAAS,EAC5D;AACI,EAAA,MAAMC,UAAU,GAAGC,yBAAyB,CAACJ,SAAS,EAAEC,gBAAgB,CAAC;EAEzE,IAAI,CAACC,SAAS,EACd;IACI,OAAOG,6BAA6B,CAACF,UAAU,EAAE;MAC7CG,UAAU,EAAEA,OAAO;AAAEC,QAAAA,KAAK,EAAE,IAAIC,UAAU,CAAC,CAAC,CAAC;AAAEC,QAAAA,IAAI,EAAE;OAAG;AAC5D,KAAC,CAAC;AACN,EAAA;EAEA,OAAOJ,6BAA6B,CAACF,UAAU,EAAE;AAC7CG,IAAAA,UAAU,EAAEA,CAACI,KAAK,EAAEC,OAAO,KAC3B;MACI,MAAMpC,IAAI,GAAG2B,SAAS,CAACL,GAAG,CAACc,OAAO,CAACnC,OAAO,CAAC;MAC3C,MAAMoC,MAAM,GAAGrC,IAAI,EAAEsC,OAAO,CAAClC,IAAI,CAC5BC,KAAK,IAAKA,KAAK,CAACC,GAAG,KAAK,CAAA,EAAG8B,OAAO,CAACnC,OAAO,IAAIkC,KAAK,CAACI,SAAS,CAAA,CAClE,CAAC;MAED,IAAI,CAACF,MAAM,EAAE,OAAO;AAAEL,QAAAA,KAAK,EAAE,IAAIC,UAAU,CAAC,CAAC,CAAC;AAAEC,QAAAA,IAAI,EAAE;OAAG;AAEzD,MAAA,IAAIG,MAAM,CAACG,UAAU,KAAK1C,gBAAgB,EAC1C;AACI,QAAA,MAAM,IAAI2C,KAAK,CACX,CAAA,YAAA,EAAeJ,MAAM,CAAC/B,GAAG,CAAA,kBAAA,EAAqB+B,MAAM,CAACG,UAAU,CAAA,GAAA,CAAK,GAClE,CAAA,0DAAA,EAA6D1C,gBAAgB,GACnF,CAAC;AACL,MAAA;;AAEA;AACA;AACA;AACA;AACA,MAAA,MAAMkC,KAAK,GAAG,IAAIU,WAAW,EAAE,CAACC,MAAM,CAACN,MAAM,CAACO,IAAI,CAAC;MACnD,OAAO;QAAEZ,KAAK;QAAEE,IAAI,EAAEF,KAAK,CAACa;OAAY;IAC5C,CAAC;IACD9C,eAAe,EAAGqC,OAAO,IACzB;MACI,MAAMpC,IAAI,GAAG2B,SAAS,CAACL,GAAG,CAACc,OAAO,CAACnC,OAAO,CAAC;MAC3C,OAAOD,IAAI,GAAGD,eAAe,CAACC,IAAI,EAAEoC,OAAO,CAACnC,OAAO,CAAC,GAAG,IAAI;AAC/D,IAAA;AACJ,GAAC,CAAC;AACN;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS6C,0BAA0BA,CACtCrB,SAAS,EACTsB,gBAAgB,EAChBC,cAAc,EACdC,OAAO,GAAG,EAAE,EAEhB;EACI,MAAMjC,UAAU,GAAG,IAAIE,GAAG,CAAC8B,cAAc,CAACrB,SAAS,CAACuB,GAAG,CAAElD,IAAI,IAAK,CAAEA,IAAI,CAACM,GAAG,EAAEN,IAAI,CAAE,CAAC,CAAC;EACtF,MAAMmD,SAAS,GAAG,IAAIjC,GAAG,CAAC8B,cAAc,CAACI,MAAM,CAACF,GAAG,CAAEnC,IAAI,IAAK,CAAEA,IAAI,CAACsC,OAAO,EAAEtC,IAAI,CAAE,CAAC,CAAC;AACtF,EAAA,MAAMuC,MAAM,GAAG,IAAIC,qBAAqB,CAAC;AACrCC,IAAAA,OAAO,EAAE,IAAI;AACbC,IAAAA,eAAe,EAAER,OAAO,CAACQ,eAAe,IAAIhC,SAAS,CAACiC,sBAAsB,IAAI,CAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAE;IAC9F,IAAIT,OAAO,CAACU,UAAU,GAAG;MAAEA,UAAU,EAAEV,OAAO,CAACU;KAAY,GAAG,EAAE;AACpE,GAAC,CAAC;AAEF,EAAA,KAAK,MAAMC,IAAI,IAAIb,gBAAgB,CAACc,IAAI,EACxC;IACIP,MAAM,CAACQ,cAAc,CAAC;MAClBC,IAAI,EAAEH,IAAI,CAACG,IAAI;MACfC,aAAa,EAAEJ,IAAI,CAACI,aAAa;MACjCC,WAAW,EAAEL,IAAI,CAACK,WAAW;MAC7BC,IAAI,EAAEN,IAAI,CAACM,IAAI;MACfjB,OAAO,EAAEW,IAAI,CAACX;AAClB,KAAC,CAAC;AACN,EAAA;;AAEA;AACA;AACA;AACA;AACA,EAAA,MAAMkB,kBAAkB,GAAG,IAAIjD,GAAG,EAAE;AAEpC,EAAA,KAAK,MAAM,CAAEQ,gBAAgB,EAAE0C,OAAO,CAAE,IAAIrB,gBAAgB,CAACsB,QAAQ,CAACC,OAAO,EAAE,EAC/E;IACI,IAAIL,WAAW,GAAGE,kBAAkB,CAAC7C,GAAG,CAAC8C,OAAO,CAACf,OAAO,CAAC;IAEzD,IAAI,CAACY,WAAW,EAChB;MACI,MAAMlD,IAAI,GAAGoC,SAAS,CAAC7B,GAAG,CAAC8C,OAAO,CAACf,OAAO,CAAC;MAC3CY,WAAW,GAAGzC,YAAY,CACtBC,SAAS,EACTV,IAAI,EAAEwD,8BAA8B,IAAI7C,gBAAgB,EACxDX,IAAI,EAAEyD,MAAM,KAAK,YAAY,GAAG1D,cAAc,CAACC,IAAI,EAAEC,UAAU,CAAC,GAAG,IACvE,CAAC;MACDmD,kBAAkB,CAAC9C,GAAG,CAAC+C,OAAO,CAACf,OAAO,EAAEY,WAAW,CAAC;AACxD,IAAA;AAEAX,IAAAA,MAAM,CAACmB,OAAO,CAAC/C,gBAAgB,EAAEuC,WAAW,CAAC;AACjD,EAAA;EAEA,OAAO;AACHjC,IAAAA,KAAK,EAAEsB,MAAM,CAACoB,OAAO,EAAE;AACvBC,IAAAA,gBAAgB,EAAE5B,gBAAgB,CAACsB,QAAQ,CAACO,MAAM;IAClDC,SAAS,EAAEV,kBAAkB,CAACjC;GACjC;AACL;;;;"}
+{"version":3,"file":"buildCarbonEffectContainer.js","sources":["../../../../../src/formats/webgpu/core/buildCarbonEffectContainer.js"],"sourcesContent":["import { writeBackendBlock } from \"../../../format/carbonEffect/index.js\";\nimport {\n    buildCarbonEffectContainer as buildContainer\n} from \"../../../format/carbonEffect/buildCarbonEffectContainer.js\";\n\n/**\n * The WebGPU backend adapter for the shared Carbon container builder.\n *\n * Everything about the record layout, the permutation walk and the description\n * mapping lives in `format/carbonEffect/buildCarbonEffectContainer.js` and is\n * shared with WebGL. What remains here is the two things that are genuinely\n * WGSL: how a program becomes bytes, and what a pass's trailing block contains.\n *\n * The block carries bind-group layouts and resource transforms. Neither is\n * derivable from Carbon reflection - Carbon records the D3D binding model, while\n * `(group, binding, visibility, generatedSymbol)` comes from the lowered IR.\n */\n\n/**\n * The entry-point name every WGSL lowerer emits.\n *\n * Carbon's `StageInput` has no entry-point field, so the container can only omit\n * one if it is a constant of our emitter rather than data. It is: all thirteen\n * `lower*Program` modules write `entryPoint: \"main\"` literally. Measured constant\n * across 626 shaders in seven effects — but measurement only shows it holds\n * today, so the substitution asserts it. A future lowerer that picks a different\n * name fails the build instead of silently emitting a container whose programs\n * cannot be found.\n */\nexport const WGSL_ENTRY_POINT = \"main\";\n\n/**\n * Encodes one WGSL stage program.\n *\n * `sourceMap` is deliberately dropped. Its offsets index DXBC bytes, which this\n * container does not carry, so it is a translator diagnostic rather than\n * payload. It was separately measured to suppress no sharing, so keeping it\n * would buy nothing either.\n *\n * @param {object} shader Translated shader record.\n * @returns {Uint8Array} Program bytes.\n */\nfunction encodeProgram(shader)\n{\n    if (shader.entryPoint !== WGSL_ENTRY_POINT)\n    {\n        throw new Error(\n            `WGSL shader ${shader.key} has entry point \"${shader.entryPoint}\"; `\n            + `the container omits the name because every lowerer emits \"${WGSL_ENTRY_POINT}\"`\n        );\n    }\n\n    return new TextEncoder().encode(shader.code);\n}\n\n/**\n * Builds the per-pass backend block for one pass of one translated body.\n *\n * @param {object} unit Pass translation unit.\n * @param {string} passKey Enclosing pass key.\n * @returns {Uint8Array|null} Block bytes, or null when the pass has no layout.\n */\nfunction encodeBackendBlock(unit, passKey)\n{\n    const layout = unit.layouts.find((entry) => entry.key === passKey);\n    if (!layout) return null;\n\n    return writeBackendBlock({\n        bindGroups: layout.bindGroups,\n        transforms: (unit.resourceTransforms ?? [])\n            .filter((transform) => transform.layoutKey === passKey)\n    });\n}\n\n/** The WebGPU encoders, as the shared builder's backend argument. */\nexport const WGSL_CONTAINER_BACKEND = Object.freeze({ encodeProgram, encodeBackendBlock });\n\n/**\n * Builds the complete WebGPU effect container.\n *\n * @param {object} effectRes Loaded version-15 `Tr2EffectRes`.\n * @param {object} permutationGraph Validated `PGRF` document.\n * @param {object} backendBodySet Translated backend bodies.\n * @param {object} [options] Container options.\n * @param {number[]|Uint8Array} [options.compilerVersion] Four version bytes.\n * @param {string} [options.sourceHash] 32 ASCII hash characters.\n * @returns {{bytes:Uint8Array, permutationCount:number, bodyCount:number}} Container and its body accounting.\n */\nexport function buildCarbonEffectContainer(\n    effectRes,\n    permutationGraph,\n    backendBodySet,\n    options = {}\n)\n{\n    return buildContainer(\n        effectRes,\n        permutationGraph,\n        backendBodySet,\n        WGSL_CONTAINER_BACKEND,\n        options\n    );\n}\n\nexport default buildCarbonEffectContainer;\n"],"names":["WGSL_ENTRY_POINT","encodeProgram","shader","entryPoint","Error","key","TextEncoder","encode","code","encodeBackendBlock","unit","passKey","layout","layouts","find","entry","writeBackendBlock","bindGroups","transforms","resourceTransforms","filter","transform","layoutKey","WGSL_CONTAINER_BACKEND","Object","freeze","buildCarbonEffectContainer","effectRes","permutationGraph","backendBodySet","options","buildContainer"],"mappings":";;;;;;AAKA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMA,gBAAgB,GAAG;;AAEhC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,aAAaA,CAACC,MAAM,EAC7B;AACI,EAAA,IAAIA,MAAM,CAACC,UAAU,KAAKH,gBAAgB,EAC1C;AACI,IAAA,MAAM,IAAII,KAAK,CACX,CAAA,YAAA,EAAeF,MAAM,CAACG,GAAG,CAAA,kBAAA,EAAqBH,MAAM,CAACC,UAAU,CAAA,GAAA,CAAK,GAClE,CAAA,0DAAA,EAA6DH,gBAAgB,GACnF,CAAC;AACL,EAAA;EAEA,OAAO,IAAIM,WAAW,EAAE,CAACC,MAAM,CAACL,MAAM,CAACM,IAAI,CAAC;AAChD;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,kBAAkBA,CAACC,IAAI,EAAEC,OAAO,EACzC;AACI,EAAA,MAAMC,MAAM,GAAGF,IAAI,CAACG,OAAO,CAACC,IAAI,CAAEC,KAAK,IAAKA,KAAK,CAACV,GAAG,KAAKM,OAAO,CAAC;AAClE,EAAA,IAAI,CAACC,MAAM,EAAE,OAAO,IAAI;AAExB,EAAA,OAAOI,iBAAiB,CAAC;IACrBC,UAAU,EAAEL,MAAM,CAACK,UAAU;AAC7BC,IAAAA,UAAU,EAAE,CAACR,IAAI,CAACS,kBAAkB,IAAI,EAAE,EACrCC,MAAM,CAAEC,SAAS,IAAKA,SAAS,CAACC,SAAS,KAAKX,OAAO;AAC9D,GAAC,CAAC;AACN;;AAEA;MACaY,sBAAsB,GAAGC,MAAM,CAACC,MAAM,CAAC;EAAExB,aAAa;AAAEQ,EAAAA;AAAmB,CAAC;;AAEzF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASiB,0BAA0BA,CACtCC,SAAS,EACTC,gBAAgB,EAChBC,cAAc,EACdC,OAAO,GAAG,EAAE,EAEhB;EACI,OAAOC,4BAAc,CACjBJ,SAAS,EACTC,gBAAgB,EAChBC,cAAc,EACdN,sBAAsB,EACtBO,OACJ,CAAC;AACL;;;;"}

package/dist/formats/webgpu/core/{cewgpu/CewgpuContainer.js → carbonWebgpu/CarbonWebgpuContainer.js}

@@ -1,6 +1,6 @@
 import '../../../../format/compareUtf8.js';
 import { readBackendBlock } from '../../../../format/carbonEffect/carbonEffectBackendBlock.js';
-import { CjsCarbonEffectReader } from '../../../../format/carbonEffect/CjsCarbonEffectReader.js';
+import { looksLikeCarbonEffectContainer, CjsCarbonEffectReader } from '../../../../format/carbonEffect/CjsCarbonEffectReader.js';
 import '../../../../format/carbonEffect/CjsCarbonEffectWriter.js';
 import { WGSL_ENTRY_POINT } from '../buildCarbonEffectContainer.js';
 import { sha256Bytes } from '../../../../format/effect/sha256.js';
@@ -61,9 +61,11 @@ const WEBGPU_STAGE = Object.freeze({
  * @param {Uint8Array} bytes Candidate bytes.
  * @returns {boolean} True when the first dword is Carbon's v15 version.
  */
-function looksLikeCewgpuContainer(bytes) {
-  if (!bytes || bytes.length < 4) return false;
-  return bytes[0] === 15 && bytes[1] === 0 && bytes[2] === 0 && bytes[3] === 0;
+function looksLikeCarbonWebgpuContainer(bytes) {
+  // Delegates rather than repeating the version dword. WebGL needs the same
+  // check, and a second hand-written copy of one constant is a second chance
+  // to disagree with it.
+  return looksLikeCarbonEffectContainer(bytes);
 }
 
 /**
@@ -90,7 +92,7 @@ function optionIndicesFor(axes, permutationIndex) {
 /**
  * Reader over one WebGPU effect container.
  */
-class CewgpuContainer {
+class CarbonWebgpuContainer {
   /**
    * Creates an empty container reader.
    */
@@ -121,7 +123,7 @@ class CewgpuContainer {
       const bytes = source instanceof Uint8Array ? source : source instanceof ArrayBuffer ? new Uint8Array(source) : new Uint8Array(source.buffer, source.byteOffset, source.byteLength);
       this.bytes = bytes;
       this.carbon = new CjsCarbonEffectReader(bytes, {
-        source: this.sourcePath || "CEWGPU"
+        source: this.sourcePath || "CARBON_WEBGPU"
       });
       this.containerVersion = this.carbon.version;
       return true;
@@ -152,7 +154,7 @@ class CewgpuContainer {
   GetDescription(permutationIndex) {
     const record = this.carbon.records[permutationIndex];
     if (!record) {
-      throw new Error(`CEWGPU container has no body at permutation ${permutationIndex}`);
+      throw new Error(`Carbon WebGPU container has no body at permutation ${permutationIndex}`);
     }
     if (!this._descriptions.has(record.offset)) {
       this._descriptions.set(record.offset, this.carbon.readDescription(permutationIndex, {
@@ -286,7 +288,7 @@ class CewgpuContainer {
         if (!shaders.length) continue;
         const block = pass.backendBlock && pass.backendBlock.size !== 0 ? readBackendBlock(pass.backendBlock.bytes, {
           layoutKey: passKey,
-          source: this.sourcePath || "CEWGPU"
+          source: this.sourcePath || "CARBON_WEBGPU"
         }) : null;
         passes.push(Object.freeze({
           passKey,
@@ -325,22 +327,6 @@ class CewgpuContainer {
     return deriveBackendBodySet(this);
   }
 
-  /**
-   * Returns the Carbon description currently exposed through the legacy
-   * portable-reflection accessor.
-   *
-   * This is not a `CJS_EFFECT_BODY_REFLECTION` envelope. Direct
-   * `Tr2EffectRes` hydration requires an adapter and remains an open
-   * integration boundary.
-   *
-   * @param {number} [permutationIndex] Permutation index.
-   * @returns {object|null} Raw Carbon description record tree.
-   */
-  GetPortableEffectReflection(permutationIndex = 0) {
-    if (!this.IsGood()) return null;
-    return this.GetDescription(permutationIndex);
-  }
-
   /**
    * Summarises the container without materialising every body.
    *
@@ -349,7 +335,7 @@ class CewgpuContainer {
   get info() {
     const bodyKeys = this.bodyKeyByOffset;
     return Object.freeze({
-      format: "CEWGPU",
+      format: "CARBON_WEBGPU",
       // Carbon's own version dword, always 15. There is no container
       // version of ours: see buildCarbonEffectContainer for why nothing
       // announces the payload, and why identity comes from the path.
@@ -364,5 +350,5 @@ class CewgpuContainer {
   }
 }
 
-export { CewgpuContainer, looksLikeCewgpuContainer };
-//# sourceMappingURL=CewgpuContainer.js.map
+export { CarbonWebgpuContainer, looksLikeCarbonWebgpuContainer };
+//# sourceMappingURL=CarbonWebgpuContainer.js.map

package/dist/formats/webgpu/core/carbonWebgpu/CarbonWebgpuContainer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CarbonWebgpuContainer.js","sources":["../../../../../../src/formats/webgpu/core/carbonWebgpu/CarbonWebgpuContainer.js"],"sourcesContent":["import {\n    CjsCarbonEffectReader,\n    readBackendBlock\n} from \"../../../../format/carbonEffect/index.js\";\nimport { WGSL_ENTRY_POINT } from \"../buildCarbonEffectContainer.js\";\nimport { sha256Bytes } from \"../../../../format/effect/sha256.js\";\nimport {\n    looksLikeCarbonEffectContainer\n} from \"../../../../format/carbonEffect/CjsCarbonEffectReader.js\";\nimport { deriveBackendBodySet } from \"./containerViews.js\";\n\n/**\n * Reader for the WebGPU effect container.\n *\n * The chunk package stored the permutation graph, the source reflection, the\n * translated body set and the emitted WGSL as four documents that had to be kept\n * consistent with each other, and carried digests to detect when they were not.\n * Under the record layout there is one document. The permutation graph is the\n * header's own permutation records and offset table, the reflection is the\n * description tree, and a translated pass is that tree's `shaderData` plus its\n * trailing block. So the accessors below are **views**, not stored copies, and\n * the class of bug the digests guarded against cannot occur: there is nothing\n * left to disagree.\n *\n * Keys the chunk format stored explicitly are derived here instead:\n *\n * - a body key is its position among distinct offset-table entries, which is\n *   exactly what Carbon's alias dedupe produces;\n * - a pass's technique name, pass index and stage name come from its position in\n *   the record tree, which is why cross-technique passes share on the wire;\n * - the WGSL entry point is a constant of the emitter, asserted on write.\n */\n\nconst textDecoder = new TextDecoder(\"utf-8\", { fatal: false });\n\n/** WGSL stage names by Carbon stage type, for the stage types WebGPU supports. */\nconst WEBGPU_STAGE_NAME = Object.freeze({ 0: \"vertex\", 1: \"pixel\", 2: \"compute\" });\n\n/** WebGPU pipeline stage for a WGSL stage name. */\nconst WEBGPU_STAGE = Object.freeze({ vertex: \"vertex\", pixel: \"fragment\", compute: \"compute\" });\n\n/**\n * Reports whether bytes look like a Carbon v15 effect container.\n *\n * This is a **shape** check, not an identity check, and the distinction is the\n * point: our containers are stock Carbon v15 files, so nothing in the bytes\n * separates ours from a shipped `effect.dx11` file. Identity comes from where\n * the file was resolved — `effect.webgpu/` versus `effect.dx11/` — exactly as it\n * does for Carbon, whose three backend trees are also byte-format-identical.\n *\n * Use this to reject something that is not a v15 container at all. Do not use it\n * to decide what a payload is.\n *\n * @param {Uint8Array} bytes Candidate bytes.\n * @returns {boolean} True when the first dword is Carbon's v15 version.\n */\nexport function looksLikeCarbonWebgpuContainer(bytes)\n{\n    // Delegates rather than repeating the version dword. WebGL needs the same\n    // check, and a second hand-written copy of one constant is a second chance\n    // to disagree with it.\n    return looksLikeCarbonEffectContainer(bytes);\n}\n\n/**\n * Decomposes a permutation index into per-axis option indices.\n *\n * The inverse of Carbon's own selection arithmetic: it accumulates\n * `value * multiplier` over the axes in declaration order, multiplying the\n * running radix by each axis's option count.\n *\n * @param {object[]} axes Permutation axis records.\n * @param {number} permutationIndex Permutation index.\n * @returns {number[]} Option index per axis.\n */\nfunction optionIndicesFor(axes, permutationIndex)\n{\n    let remaining = permutationIndex;\n    return axes.map((axis) =>\n    {\n        const radix = axis.options.length || 1;\n        const value = remaining % radix;\n        remaining = Math.floor(remaining / radix);\n        return value;\n    });\n}\n\n/**\n * Reader over one WebGPU effect container.\n */\nexport class CarbonWebgpuContainer\n{\n    /**\n     * Creates an empty container reader.\n     */\n    constructor()\n    {\n        this.readError = null;\n        this.sourcePath = \"\";\n        this.containerVersion = 0;\n        this.bytes = null;\n        this.carbon = null;\n        this._descriptions = new Map();\n        this._bodyKeyByOffset = null;\n    }\n\n    /**\n     * Reads a container from bytes.\n     *\n     * @param {ArrayBuffer|ArrayBufferView|Uint8Array} source Container bytes.\n     * @param {object} [options] Read options.\n     * @param {string} [options.sourcePath] Source path for diagnostics.\n     * @returns {boolean} True when the container was decoded.\n     */\n    Read(source, options = {})\n    {\n        this.readError = null;\n        this.sourcePath = options.sourcePath || \"\";\n        this._descriptions = new Map();\n        this._bodyKeyByOffset = null;\n\n        try\n        {\n            const bytes = source instanceof Uint8Array\n                ? source\n                : (source instanceof ArrayBuffer\n                    ? new Uint8Array(source)\n                    : new Uint8Array(source.buffer, source.byteOffset, source.byteLength));\n\n            this.bytes = bytes;\n            this.carbon = new CjsCarbonEffectReader(bytes, {\n                source: this.sourcePath || \"CARBON_WEBGPU\"\n            });\n            this.containerVersion = this.carbon.version;\n            return true;\n        }\n        catch (error)\n        {\n            this.readError = error;\n            this.carbon = null;\n            return false;\n        }\n    }\n\n    /**\n     * Reports whether the container decoded.\n     *\n     * @returns {boolean} True when readable.\n     */\n    IsGood()\n    {\n        return this.carbon !== null;\n    }\n\n    /**\n     * Reads one permutation's description, memoised by stored body.\n     *\n     * Aliased permutations share one stored blob, so they share one parse.\n     *\n     * @param {number} permutationIndex Permutation index.\n     * @returns {object} Description record tree.\n     */\n    GetDescription(permutationIndex)\n    {\n        const record = this.carbon.records[permutationIndex];\n        if (!record)\n        {\n            throw new Error(`Carbon WebGPU container has no body at permutation ${permutationIndex}`);\n        }\n        if (!this._descriptions.has(record.offset))\n        {\n            this._descriptions.set(\n                record.offset,\n                this.carbon.readDescription(permutationIndex, { backend: true })\n            );\n        }\n        return this._descriptions.get(record.offset);\n    }\n\n    /**\n     * Maps each distinct stored body to a stable key, in offset-table order.\n     *\n     * @returns {Map<number, string>} Body key by stored offset.\n     */\n    get bodyKeyByOffset()\n    {\n        if (!this._bodyKeyByOffset)\n        {\n            const keys = new Map();\n            for (const record of this.carbon.records)\n            {\n                if (!keys.has(record.offset)) keys.set(record.offset, `body${keys.size}`);\n            }\n            this._bodyKeyByOffset = keys;\n        }\n        return this._bodyKeyByOffset;\n    }\n\n    /**\n     * Derives the permutation graph the chunk package used to store.\n     *\n     * @returns {object} Permutation graph view.\n     */\n    get permutationGraph()\n    {\n        const bodyKeys = this.bodyKeyByOffset;\n        const bodies = [];\n\n        for (const [ offset, key ] of bodyKeys)\n        {\n            const record = this.carbon.records.find((entry) => entry.offset === offset);\n            bodies.push(Object.freeze({\n                key,\n                offset,\n                byteLength: record.size,\n                // Hashed from the stored description blob. The chunk graph\n                // carried a digest per body; here it is a function of the bytes\n                // it identifies, so it cannot disagree with them. It is also what\n                // Tr2EffectRes uses to prove bodies are distinct -- aliased rows\n                // share one blob and therefore one digest, which is exactly the\n                // identity the offset table already expresses.\n                sha256: sha256Bytes(this.bytes.subarray(offset, offset + record.size)),\n                permutationCount: this.carbon.records\n                    .filter((entry) => entry.offset === offset).length\n            }));\n        }\n\n        return Object.freeze({\n            // The envelope the chunk `PGRF` document carried. Not provenance:\n            // `Tr2EffectRes.SetPayload` validates it before accepting a payload\n            // at all, so a graph without it is refused outright.\n            format: \"CJS_EFFECT_PERMUTATION_GRAPH\",\n            formatVersion: 1,\n            // Fixed by construction rather than recorded. A container always\n            // carries every permutation, the offset table gives body identity\n            // only, and source reflection is not a separate document.\n            coverage: Object.freeze({\n                permutations: \"complete\",\n                bodies: \"identity-only\",\n                reflection: \"absent\"\n            }),\n            axes: Object.freeze(this.carbon.permutations.map((axis, index) => Object.freeze({\n                index,\n                name: axis.name.value,\n                defaultOption: axis.defaultOption,\n                description: axis.description.value,\n                type: axis.type,\n                options: Object.freeze(axis.options.map((option) => option.value))\n            }))),\n            variants: Object.freeze(this.carbon.records.map((record, permutationIndex) =>\n                Object.freeze({\n                    permutationIndex,\n                    bodyKey: bodyKeys.get(record.offset),\n                    // Mixed-radix decomposition of the index over the axes, which\n                    // is the inverse of the sum Carbon's GetShader() builds when\n                    // it walks options in declaration order.\n                    optionIndices: Object.freeze(\n                        optionIndicesFor(this.carbon.permutations, permutationIndex)\n                    ),\n                    // The offset-table row itself. Aliased permutations share a\n                    // stored record, so the consumer can prove that two\n                    // permutations resolve to the same emitted bytes.\n                    sourceRecord: Object.freeze({\n                        offset: record.offset,\n                        byteLength: record.size\n                    })\n                }))),\n            bodies: Object.freeze(bodies)\n        });\n    }\n\n    /**\n     * Resolves the translated backend passes for one permutation.\n     *\n     * A body whose stages carry no program is reported unsupported, which is\n     * what a zero-length `shaderData` means: the reflection is known, the\n     * program is not.\n     *\n     * @param {number} [permutationIndex] Permutation index.\n     * @returns {object|null} Resolved backend body.\n     */\n    GetBackendBodyPrograms(permutationIndex = 0)\n    {\n        if (!this.IsGood()) return null;\n\n        const record = this.carbon.records[permutationIndex];\n        if (!record) return null;\n\n        const description = this.GetDescription(permutationIndex);\n        const bodyKey = this.bodyKeyByOffset.get(record.offset);\n        const passes = [];\n        let translated = false;\n\n        for (const technique of description.techniques)\n        {\n            for (const [ passIndex, pass ] of technique.passes.entries())\n            {\n                const passKey = `${technique.name.value}.pass${passIndex}`;\n                const shaders = [];\n\n                for (const stage of pass.stages)\n                {\n                    const stageName = WEBGPU_STAGE_NAME[stage.type];\n                    if (!stageName || stage.shaderData.size === 0) continue;\n                    translated = true;\n                    shaders.push(Object.freeze({\n                        key: `${passKey}.${stageName}`,\n                        techniqueName: technique.name.value,\n                        passIndex,\n                        stageName,\n                        stage: WEBGPU_STAGE[stageName],\n                        stageType: stage.type,\n                        entryPoint: WGSL_ENTRY_POINT,\n                        code: textDecoder.decode(stage.shaderData.bytes),\n                        ...(stageName === \"compute\"\n                            ? { threadGroupSize: [ ...stage.threadGroupSize ] }\n                            : {})\n                    }));\n                }\n\n                if (!shaders.length) continue;\n\n                const block = pass.backendBlock && pass.backendBlock.size !== 0\n                    ? readBackendBlock(pass.backendBlock.bytes, {\n                        layoutKey: passKey,\n                        source: this.sourcePath || \"CARBON_WEBGPU\"\n                    })\n                    : null;\n\n                passes.push(Object.freeze({\n                    passKey,\n                    shaders: Object.freeze(shaders),\n                    layouts: Object.freeze(block\n                        ? [ Object.freeze({\n                            key: passKey,\n                            techniqueName: technique.name.value,\n                            passIndex,\n                            bindGroups: block.bindGroups\n                        }) ]\n                        : []),\n                    ...(block?.transforms?.length\n                        ? { resourceTransforms: Object.freeze(block.transforms) }\n                        : {})\n                }));\n            }\n        }\n\n        return Object.freeze({\n            permutationIndex,\n            bodyKey,\n            status: translated ? \"translated\" : \"unsupported\",\n            error: translated ? null : \"body carries no translated programs\",\n            passes: Object.freeze(passes)\n        });\n    }\n\n    /**\n     * Derives the body-set view, for consumers holding the raw container.\n     *\n     * `packageToJson` exposes the same document. A consumer taking the raw emit\n     * reads it here instead, which is why this is a getter on the container\n     * rather than only a field in the JSON projection.\n     *\n     * @returns {object} Body-set document.\n     */\n    get backendBodySet()\n    {\n        return deriveBackendBodySet(this);\n    }\n\n    /**\n     * Summarises the container without materialising every body.\n     *\n     * @returns {object} Container summary.\n     */\n    get info()\n    {\n        const bodyKeys = this.bodyKeyByOffset;\n        return Object.freeze({\n            format: \"CARBON_WEBGPU\",\n            // Carbon's own version dword, always 15. There is no container\n            // version of ours: see buildCarbonEffectContainer for why nothing\n            // announces the payload, and why identity comes from the path.\n            containerVersion: this.containerVersion,\n            sourcePath: this.sourcePath,\n            compilerVersion: Object.freeze([ ...this.carbon.compilerVersion ]),\n            sourceHash: textDecoder.decode(this.carbon.sourceHash),\n            permutationCount: this.carbon.records.length,\n            uniqueBodyCount: bodyKeys.size,\n            axisCount: this.carbon.permutations.length\n        });\n    }\n}\n\nexport default CarbonWebgpuContainer;\n"],"names":["textDecoder","TextDecoder","fatal","WEBGPU_STAGE_NAME","Object","freeze","WEBGPU_STAGE","vertex","pixel","compute","looksLikeCarbonWebgpuContainer","bytes","looksLikeCarbonEffectContainer","optionIndicesFor","axes","permutationIndex","remaining","map","axis","radix","options","length","value","Math","floor","CarbonWebgpuContainer","constructor","readError","sourcePath","containerVersion","carbon","_descriptions","Map","_bodyKeyByOffset","Read","source","Uint8Array","ArrayBuffer","buffer","byteOffset","byteLength","CjsCarbonEffectReader","version","error","IsGood","GetDescription","record","records","Error","has","offset","set","readDescription","backend","get","bodyKeyByOffset","keys","size","permutationGraph","bodyKeys","bodies","key","find","entry","push","sha256","sha256Bytes","subarray","permutationCount","filter","format","formatVersion","coverage","permutations","reflection","index","name","defaultOption","description","type","option","variants","bodyKey","optionIndices","sourceRecord","GetBackendBodyPrograms","passes","translated","technique","techniques","passIndex","pass","entries","passKey","shaders","stage","stages","stageName","shaderData","techniqueName","stageType","entryPoint","WGSL_ENTRY_POINT","code","decode","threadGroupSize","block","backendBlock","readBackendBlock","layoutKey","layouts","bindGroups","transforms","resourceTransforms","status","backendBodySet","deriveBackendBodySet","info","compilerVersion","sourceHash","uniqueBodyCount","axisCount"],"mappings":";;;;;;;;AAWA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,MAAMA,WAAW,GAAG,IAAIC,WAAW,CAAC,OAAO,EAAE;AAAEC,EAAAA,KAAK,EAAE;AAAM,CAAC,CAAC;;AAE9D;AACA,MAAMC,iBAAiB,GAAGC,MAAM,CAACC,MAAM,CAAC;AAAE,EAAA,CAAC,EAAE,QAAQ;AAAE,EAAA,CAAC,EAAE,OAAO;AAAE,EAAA,CAAC,EAAE;AAAU,CAAC,CAAC;;AAElF;AACA,MAAMC,YAAY,GAAGF,MAAM,CAACC,MAAM,CAAC;AAAEE,EAAAA,MAAM,EAAE,QAAQ;AAAEC,EAAAA,KAAK,EAAE,UAAU;AAAEC,EAAAA,OAAO,EAAE;AAAU,CAAC,CAAC;;AAE/F;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,8BAA8BA,CAACC,KAAK,EACpD;AACI;AACA;AACA;EACA,OAAOC,8BAA8B,CAACD,KAAK,CAAC;AAChD;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASE,gBAAgBA,CAACC,IAAI,EAAEC,gBAAgB,EAChD;EACI,IAAIC,SAAS,GAAGD,gBAAgB;AAChC,EAAA,OAAOD,IAAI,CAACG,GAAG,CAAEC,IAAI,IACrB;IACI,MAAMC,KAAK,GAAGD,IAAI,CAACE,OAAO,CAACC,MAAM,IAAI,CAAC;AACtC,IAAA,MAAMC,KAAK,GAAGN,SAAS,GAAGG,KAAK;IAC/BH,SAAS,GAAGO,IAAI,CAACC,KAAK,CAACR,SAAS,GAAGG,KAAK,CAAC;AACzC,IAAA,OAAOG,KAAK;AAChB,EAAA,CAAC,CAAC;AACN;;AAEA;AACA;AACA;AACO,MAAMG,qBAAqB,CAClC;AACI;AACJ;AACA;AACIC,EAAAA,WAAWA,GACX;IACI,IAAI,CAACC,SAAS,GAAG,IAAI;IACrB,IAAI,CAACC,UAAU,GAAG,EAAE;IACpB,IAAI,CAACC,gBAAgB,GAAG,CAAC;IACzB,IAAI,CAAClB,KAAK,GAAG,IAAI;IACjB,IAAI,CAACmB,MAAM,GAAG,IAAI;AAClB,IAAA,IAAI,CAACC,aAAa,GAAG,IAAIC,GAAG,EAAE;IAC9B,IAAI,CAACC,gBAAgB,GAAG,IAAI;AAChC,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACIC,EAAAA,IAAIA,CAACC,MAAM,EAAEf,OAAO,GAAG,EAAE,EACzB;IACI,IAAI,CAACO,SAAS,GAAG,IAAI;AACrB,IAAA,IAAI,CAACC,UAAU,GAAGR,OAAO,CAACQ,UAAU,IAAI,EAAE;AAC1C,IAAA,IAAI,CAACG,aAAa,GAAG,IAAIC,GAAG,EAAE;IAC9B,IAAI,CAACC,gBAAgB,GAAG,IAAI;IAE5B,IACA;AACI,MAAA,MAAMtB,KAAK,GAAGwB,MAAM,YAAYC,UAAU,GACpCD,MAAM,GACLA,MAAM,YAAYE,WAAW,GAC1B,IAAID,UAAU,CAACD,MAAM,CAAC,GACtB,IAAIC,UAAU,CAACD,MAAM,CAACG,MAAM,EAAEH,MAAM,CAACI,UAAU,EAAEJ,MAAM,CAACK,UAAU,CAAE;MAE9E,IAAI,CAAC7B,KAAK,GAAGA,KAAK;AAClB,MAAA,IAAI,CAACmB,MAAM,GAAG,IAAIW,qBAAqB,CAAC9B,KAAK,EAAE;AAC3CwB,QAAAA,MAAM,EAAE,IAAI,CAACP,UAAU,IAAI;AAC/B,OAAC,CAAC;AACF,MAAA,IAAI,CAACC,gBAAgB,GAAG,IAAI,CAACC,MAAM,CAACY,OAAO;AAC3C,MAAA,OAAO,IAAI;IACf,CAAC,CACD,OAAOC,KAAK,EACZ;MACI,IAAI,CAAChB,SAAS,GAAGgB,KAAK;MACtB,IAAI,CAACb,MAAM,GAAG,IAAI;AAClB,MAAA,OAAO,KAAK;AAChB,IAAA;AACJ,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACIc,EAAAA,MAAMA,GACN;AACI,IAAA,OAAO,IAAI,CAACd,MAAM,KAAK,IAAI;AAC/B,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;EACIe,cAAcA,CAAC9B,gBAAgB,EAC/B;IACI,MAAM+B,MAAM,GAAG,IAAI,CAAChB,MAAM,CAACiB,OAAO,CAAChC,gBAAgB,CAAC;IACpD,IAAI,CAAC+B,MAAM,EACX;AACI,MAAA,MAAM,IAAIE,KAAK,CAAC,CAAA,mDAAA,EAAsDjC,gBAAgB,EAAE,CAAC;AAC7F,IAAA;IACA,IAAI,CAAC,IAAI,CAACgB,aAAa,CAACkB,GAAG,CAACH,MAAM,CAACI,MAAM,CAAC,EAC1C;AACI,MAAA,IAAI,CAACnB,aAAa,CAACoB,GAAG,CAClBL,MAAM,CAACI,MAAM,EACb,IAAI,CAACpB,MAAM,CAACsB,eAAe,CAACrC,gBAAgB,EAAE;AAAEsC,QAAAA,OAAO,EAAE;AAAK,OAAC,CACnE,CAAC;AACL,IAAA;IACA,OAAO,IAAI,CAACtB,aAAa,CAACuB,GAAG,CAACR,MAAM,CAACI,MAAM,CAAC;AAChD,EAAA;;AAEA;AACJ;AACA;AACA;AACA;EACI,IAAIK,eAAeA,GACnB;AACI,IAAA,IAAI,CAAC,IAAI,CAACtB,gBAAgB,EAC1B;AACI,MAAA,MAAMuB,IAAI,GAAG,IAAIxB,GAAG,EAAE;MACtB,KAAK,MAAMc,MAAM,IAAI,IAAI,CAAChB,MAAM,CAACiB,OAAO,EACxC;QACI,IAAI,CAACS,IAAI,CAACP,GAAG,CAACH,MAAM,CAACI,MAAM,CAAC,EAAEM,IAAI,CAACL,GAAG,CAACL,MAAM,CAACI,MAAM,EAAE,OAAOM,IAAI,CAACC,IAAI,CAAA,CAAE,CAAC;AAC7E,MAAA;MACA,IAAI,CAACxB,gBAAgB,GAAGuB,IAAI;AAChC,IAAA;IACA,OAAO,IAAI,CAACvB,gBAAgB;AAChC,EAAA;;AAEA;AACJ;AACA;AACA;AACA;EACI,IAAIyB,gBAAgBA,GACpB;AACI,IAAA,MAAMC,QAAQ,GAAG,IAAI,CAACJ,eAAe;IACrC,MAAMK,MAAM,GAAG,EAAE;IAEjB,KAAK,MAAM,CAAEV,MAAM,EAAEW,GAAG,CAAE,IAAIF,QAAQ,EACtC;AACI,MAAA,MAAMb,MAAM,GAAG,IAAI,CAAChB,MAAM,CAACiB,OAAO,CAACe,IAAI,CAAEC,KAAK,IAAKA,KAAK,CAACb,MAAM,KAAKA,MAAM,CAAC;AAC3EU,MAAAA,MAAM,CAACI,IAAI,CAAC5D,MAAM,CAACC,MAAM,CAAC;QACtBwD,GAAG;QACHX,MAAM;QACNV,UAAU,EAAEM,MAAM,CAACW,IAAI;AACvB;AACA;AACA;AACA;AACA;AACA;AACAQ,QAAAA,MAAM,EAAEC,WAAW,CAAC,IAAI,CAACvD,KAAK,CAACwD,QAAQ,CAACjB,MAAM,EAAEA,MAAM,GAAGJ,MAAM,CAACW,IAAI,CAAC,CAAC;AACtEW,QAAAA,gBAAgB,EAAE,IAAI,CAACtC,MAAM,CAACiB,OAAO,CAChCsB,MAAM,CAAEN,KAAK,IAAKA,KAAK,CAACb,MAAM,KAAKA,MAAM,CAAC,CAAC7B;AACpD,OAAC,CAAC,CAAC;AACP,IAAA;IAEA,OAAOjB,MAAM,CAACC,MAAM,CAAC;AACjB;AACA;AACA;AACAiE,MAAAA,MAAM,EAAE,8BAA8B;AACtCC,MAAAA,aAAa,EAAE,CAAC;AAChB;AACA;AACA;AACAC,MAAAA,QAAQ,EAAEpE,MAAM,CAACC,MAAM,CAAC;AACpBoE,QAAAA,YAAY,EAAE,UAAU;AACxBb,QAAAA,MAAM,EAAE,eAAe;AACvBc,QAAAA,UAAU,EAAE;AAChB,OAAC,CAAC;MACF5D,IAAI,EAAEV,MAAM,CAACC,MAAM,CAAC,IAAI,CAACyB,MAAM,CAAC2C,YAAY,CAACxD,GAAG,CAAC,CAACC,IAAI,EAAEyD,KAAK,KAAKvE,MAAM,CAACC,MAAM,CAAC;QAC5EsE,KAAK;AACLC,QAAAA,IAAI,EAAE1D,IAAI,CAAC0D,IAAI,CAACtD,KAAK;QACrBuD,aAAa,EAAE3D,IAAI,CAAC2D,aAAa;AACjCC,QAAAA,WAAW,EAAE5D,IAAI,CAAC4D,WAAW,CAACxD,KAAK;QACnCyD,IAAI,EAAE7D,IAAI,CAAC6D,IAAI;AACf3D,QAAAA,OAAO,EAAEhB,MAAM,CAACC,MAAM,CAACa,IAAI,CAACE,OAAO,CAACH,GAAG,CAAE+D,MAAM,IAAKA,MAAM,CAAC1D,KAAK,CAAC;OACpE,CAAC,CAAC,CAAC;MACJ2D,QAAQ,EAAE7E,MAAM,CAACC,MAAM,CAAC,IAAI,CAACyB,MAAM,CAACiB,OAAO,CAAC9B,GAAG,CAAC,CAAC6B,MAAM,EAAE/B,gBAAgB,KACrEX,MAAM,CAACC,MAAM,CAAC;QACVU,gBAAgB;QAChBmE,OAAO,EAAEvB,QAAQ,CAACL,GAAG,CAACR,MAAM,CAACI,MAAM,CAAC;AACpC;AACA;AACA;AACAiC,QAAAA,aAAa,EAAE/E,MAAM,CAACC,MAAM,CACxBQ,gBAAgB,CAAC,IAAI,CAACiB,MAAM,CAAC2C,YAAY,EAAE1D,gBAAgB,CAC/D,CAAC;AACD;AACA;AACA;AACAqE,QAAAA,YAAY,EAAEhF,MAAM,CAACC,MAAM,CAAC;UACxB6C,MAAM,EAAEJ,MAAM,CAACI,MAAM;UACrBV,UAAU,EAAEM,MAAM,CAACW;SACtB;OACJ,CAAC,CAAC,CAAC;AACRG,MAAAA,MAAM,EAAExD,MAAM,CAACC,MAAM,CAACuD,MAAM;AAChC,KAAC,CAAC;AACN,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACIyB,EAAAA,sBAAsBA,CAACtE,gBAAgB,GAAG,CAAC,EAC3C;IACI,IAAI,CAAC,IAAI,CAAC6B,MAAM,EAAE,EAAE,OAAO,IAAI;IAE/B,MAAME,MAAM,GAAG,IAAI,CAAChB,MAAM,CAACiB,OAAO,CAAChC,gBAAgB,CAAC;AACpD,IAAA,IAAI,CAAC+B,MAAM,EAAE,OAAO,IAAI;AAExB,IAAA,MAAMgC,WAAW,GAAG,IAAI,CAACjC,cAAc,CAAC9B,gBAAgB,CAAC;IACzD,MAAMmE,OAAO,GAAG,IAAI,CAAC3B,eAAe,CAACD,GAAG,CAACR,MAAM,CAACI,MAAM,CAAC;IACvD,MAAMoC,MAAM,GAAG,EAAE;IACjB,IAAIC,UAAU,GAAG,KAAK;AAEtB,IAAA,KAAK,MAAMC,SAAS,IAAIV,WAAW,CAACW,UAAU,EAC9C;AACI,MAAA,KAAK,MAAM,CAAEC,SAAS,EAAEC,IAAI,CAAE,IAAIH,SAAS,CAACF,MAAM,CAACM,OAAO,EAAE,EAC5D;QACI,MAAMC,OAAO,GAAG,CAAA,EAAGL,SAAS,CAACZ,IAAI,CAACtD,KAAK,CAAA,KAAA,EAAQoE,SAAS,CAAA,CAAE;QAC1D,MAAMI,OAAO,GAAG,EAAE;AAElB,QAAA,KAAK,MAAMC,KAAK,IAAIJ,IAAI,CAACK,MAAM,EAC/B;AACI,UAAA,MAAMC,SAAS,GAAG9F,iBAAiB,CAAC4F,KAAK,CAAChB,IAAI,CAAC;UAC/C,IAAI,CAACkB,SAAS,IAAIF,KAAK,CAACG,UAAU,CAACzC,IAAI,KAAK,CAAC,EAAE;AAC/C8B,UAAAA,UAAU,GAAG,IAAI;AACjBO,UAAAA,OAAO,CAAC9B,IAAI,CAAC5D,MAAM,CAACC,MAAM,CAAC;AACvBwD,YAAAA,GAAG,EAAE,CAAA,EAAGgC,OAAO,CAAA,CAAA,EAAII,SAAS,CAAA,CAAE;AAC9BE,YAAAA,aAAa,EAAEX,SAAS,CAACZ,IAAI,CAACtD,KAAK;YACnCoE,SAAS;YACTO,SAAS;AACTF,YAAAA,KAAK,EAAEzF,YAAY,CAAC2F,SAAS,CAAC;YAC9BG,SAAS,EAAEL,KAAK,CAAChB,IAAI;AACrBsB,YAAAA,UAAU,EAAEC,gBAAgB;YAC5BC,IAAI,EAAEvG,WAAW,CAACwG,MAAM,CAACT,KAAK,CAACG,UAAU,CAACvF,KAAK,CAAC;YAChD,IAAIsF,SAAS,KAAK,SAAS,GACrB;AAAEQ,cAAAA,eAAe,EAAE,CAAE,GAAGV,KAAK,CAACU,eAAe;aAAI,GACjD,EAAE;AACZ,WAAC,CAAC,CAAC;AACP,QAAA;AAEA,QAAA,IAAI,CAACX,OAAO,CAACzE,MAAM,EAAE;QAErB,MAAMqF,KAAK,GAAGf,IAAI,CAACgB,YAAY,IAAIhB,IAAI,CAACgB,YAAY,CAAClD,IAAI,KAAK,CAAC,GACzDmD,gBAAgB,CAACjB,IAAI,CAACgB,YAAY,CAAChG,KAAK,EAAE;AACxCkG,UAAAA,SAAS,EAAEhB,OAAO;AAClB1D,UAAAA,MAAM,EAAE,IAAI,CAACP,UAAU,IAAI;SAC9B,CAAC,GACA,IAAI;AAEV0D,QAAAA,MAAM,CAACtB,IAAI,CAAC5D,MAAM,CAACC,MAAM,CAAC;UACtBwF,OAAO;AACPC,UAAAA,OAAO,EAAE1F,MAAM,CAACC,MAAM,CAACyF,OAAO,CAAC;UAC/BgB,OAAO,EAAE1G,MAAM,CAACC,MAAM,CAACqG,KAAK,GACtB,CAAEtG,MAAM,CAACC,MAAM,CAAC;AACdwD,YAAAA,GAAG,EAAEgC,OAAO;AACZM,YAAAA,aAAa,EAAEX,SAAS,CAACZ,IAAI,CAACtD,KAAK;YACnCoE,SAAS;YACTqB,UAAU,EAAEL,KAAK,CAACK;AACtB,WAAC,CAAC,CAAE,GACF,EAAE,CAAC;AACT,UAAA,IAAIL,KAAK,EAAEM,UAAU,EAAE3F,MAAM,GACvB;AAAE4F,YAAAA,kBAAkB,EAAE7G,MAAM,CAACC,MAAM,CAACqG,KAAK,CAACM,UAAU;WAAG,GACvD,EAAE;AACZ,SAAC,CAAC,CAAC;AACP,MAAA;AACJ,IAAA;IAEA,OAAO5G,MAAM,CAACC,MAAM,CAAC;MACjBU,gBAAgB;MAChBmE,OAAO;AACPgC,MAAAA,MAAM,EAAE3B,UAAU,GAAG,YAAY,GAAG,aAAa;AACjD5C,MAAAA,KAAK,EAAE4C,UAAU,GAAG,IAAI,GAAG,qCAAqC;AAChED,MAAAA,MAAM,EAAElF,MAAM,CAACC,MAAM,CAACiF,MAAM;AAChC,KAAC,CAAC;AACN,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACI,IAAI6B,cAAcA,GAClB;IACI,OAAOC,oBAAoB,CAAC,IAAI,CAAC;AACrC,EAAA;;AAEA;AACJ;AACA;AACA;AACA;EACI,IAAIC,IAAIA,GACR;AACI,IAAA,MAAM1D,QAAQ,GAAG,IAAI,CAACJ,eAAe;IACrC,OAAOnD,MAAM,CAACC,MAAM,CAAC;AACjBiE,MAAAA,MAAM,EAAE,eAAe;AACvB;AACA;AACA;MACAzC,gBAAgB,EAAE,IAAI,CAACA,gBAAgB;MACvCD,UAAU,EAAE,IAAI,CAACA,UAAU;AAC3B0F,MAAAA,eAAe,EAAElH,MAAM,CAACC,MAAM,CAAC,CAAE,GAAG,IAAI,CAACyB,MAAM,CAACwF,eAAe,CAAE,CAAC;MAClEC,UAAU,EAAEvH,WAAW,CAACwG,MAAM,CAAC,IAAI,CAAC1E,MAAM,CAACyF,UAAU,CAAC;AACtDnD,MAAAA,gBAAgB,EAAE,IAAI,CAACtC,MAAM,CAACiB,OAAO,CAAC1B,MAAM;MAC5CmG,eAAe,EAAE7D,QAAQ,CAACF,IAAI;AAC9BgE,MAAAA,SAAS,EAAE,IAAI,CAAC3F,MAAM,CAAC2C,YAAY,CAACpD;AACxC,KAAC,CAAC;AACN,EAAA;AACJ;;;;"}

package/dist/formats/webgpu/core/{cewgpu → carbonWebgpu}/containerViews.js

@@ -341,7 +341,7 @@ function deriveInfo(container, options = {}) {
   const source = options.source || container.sourcePath || "memory";
   const graph = container.permutationGraph;
   return {
-    format: "CEWGPU",
+    format: "CARBON_WEBGPU",
     packageKind: "tr2-effect-webgpu",
     sourcePath: source,
     effectVersion: container.carbon.version,

package/dist/formats/webgpu/core/carbonWebgpu/containerViews.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"containerViews.js","sources":["../../../../../../src/formats/webgpu/core/carbonWebgpu/containerViews.js"],"sourcesContent":["import { HlslEffectBindingManifest } from \"../../../hlsl/core/tr2/shader/HlslEffectBindingManifest.js\";\nimport { HlslShaderBytecode } from \"../../../hlsl/core/HlslShaderBytecode.js\";\nimport { hlslShaderStageName } from \"../../../hlsl/core/tr2/HlslRenderContextEnum.js\";\nimport { runtimeDescriptionFromCarbon } from \"../../../hlsl/core/carbonDescriptionToRuntime.js\";\nimport { buildEffectAnalysis } from \"../helpers.js\";\nimport { WGSL_SET_VERSION } from \"../wgsl/buildWgslSet.js\";\nimport { sha256Utf8 } from \"../../../../format/effect/sha256.js\";\n\n/**\n * Derived compatibility views over a container.\n *\n * The chunk package stored `ANLS` and `WGSL` as documents beside the reflection\n * they were computed from, and carried digests to detect the two disagreeing.\n * The container stores one document, so these are **views**: functions of the\n * records, computed on read. The class of bug the digests guarded cannot occur,\n * because there is no second copy to drift.\n *\n * The analysis view is deliberately not a reimplementation. It runs\n * `buildEffectAnalysis` — the same function the packager runs on source — over a\n * description rebuilt by `runtimeDescriptionFromCarbon`. That is what keeps the\n * view honest: if it were rewritten to emit the fields consumers read today, it\n * would be free to drift from the real analysis, and nothing would notice.\n * `carbon-analysis-adapter-corpus.test.mjs` diffs the two over every shipped\n * permutation and finds zero differences.\n *\n * These views exist for `engine-webgpu`, which reads format-package JSON for\n * Carbon reflection instead of reading `Tr2Shader`. That is a recorded layering\n * defect and is not this port's to fix; the views keep it working unchanged\n * while the wire format moves underneath it. They go away with that cleanup.\n */\n\n/**\n * Resolves the permutation Carbon's own `GetShader()` would select with no\n * option overrides.\n *\n * Carbon multiplies each axis's default option by the running product of the\n * preceding axes' option counts. The chunk package stored a single selected\n * body and its index; the container carries every permutation, so the view has\n * to name a default rather than inherit one, and Carbon's own default is the\n * only defensible choice.\n *\n * @param {object} container Loaded container.\n * @returns {number} Permutation index.\n */\nexport function defaultPermutationIndex(container)\n{\n    let multiplier = 1;\n    let index = 0;\n    for (const axis of container.carbon.permutations)\n    {\n        index += axis.defaultOption * multiplier;\n        multiplier *= axis.options.length || 1;\n    }\n    return index < container.carbon.records.length ? index : 0;\n}\n\n/**\n * Rebuilds the runtime effect description for one permutation.\n *\n * @param {object} container Loaded container.\n * @param {number} permutationIndex Permutation index.\n * @param {string} source Source label.\n * @returns {object} Runtime-shaped effect description.\n */\nfunction describeRuntime(container, permutationIndex, source)\n{\n    return runtimeDescriptionFromCarbon(container.GetDescription(permutationIndex), {\n        effectName: source,\n        version: container.carbon.version,\n        bytecodeFor: (stage, stageType) => new HlslShaderBytecode({\n            stageType,\n            // Carbon's six stage names, not WebGPU's three. A three-entry table\n            // reports a geometry stage as null, which the corpus caught.\n            stageName: hlslShaderStageName(stageType),\n            bytes: stage.shaderData.bytes,\n            shaderSize: stage.shaderData.size,\n            stringTableOffset: stage.shaderData.offset,\n            effectName: source\n        })\n    });\n}\n\n/**\n * Derives the analysis document for one permutation.\n *\n * One field is honestly different from the stored `ANLS` it replaces:\n * `stages[].shaderBytecode` describes the **WGSL** program the container\n * carries, where the stored document described the source DXBC. The container\n * does not carry DXBC, so reproducing the old numbers would mean inventing\n * them. Nothing in the engine's read surface uses this field; it is a\n * diagnostic.\n *\n * @param {object} container Loaded container.\n * @param {object} [options] View options.\n * @param {string} [options.source] Source label.\n * @param {number} [options.permutationIndex] Permutation to describe.\n * @returns {object} Analysis document.\n */\nexport function deriveAnalysis(container, options = {})\n{\n    const source = options.source || container.sourcePath || \"memory\";\n    const permutationIndex = options.permutationIndex ?? defaultPermutationIndex(container);\n    const effectDescription = describeRuntime(container, permutationIndex, source);\n\n    return buildEffectAnalysis({\n        effectDescription,\n        bindingManifest: HlslEffectBindingManifest.fromEffectDescription(effectDescription, {\n            effectName: source\n        }),\n        effectRes: {\n            sourcePath: source,\n            m_compilerVersion: null\n        },\n        selection: {\n            bodyIndex: permutationIndex,\n            selectedOptions: container.carbon.permutations.map((axis) => ({\n                name: axis.name.value,\n                value: axis.options[axis.defaultOption]?.value ?? null\n            }))\n        }\n    }, { source, decodeBytecode: false, decodeInstructions: false });\n}\n\n/**\n * Derives the WGSL set document for one permutation.\n *\n * `sourceMap` is absent rather than empty, and that is not an oversight: its\n * offsets index DXBC bytes the container does not carry, so it is a translator\n * diagnostic and was dropped on write. It was separately measured to suppress\n * no sharing, so keeping it would have bought nothing either.\n *\n * @param {object} container Loaded container.\n * @param {object} [options] View options.\n * @param {number} [options.permutationIndex] Permutation to describe.\n * @returns {object} WGSL set document.\n */\nexport function deriveWgsl(container, options = {})\n{\n    const permutationIndex = options.permutationIndex ?? defaultPermutationIndex(container);\n    const body = container.GetBackendBodyPrograms(permutationIndex);\n    const shaders = [];\n    const layouts = [];\n    const resourceTransforms = [];\n\n    for (const pass of body?.passes ?? [])\n    {\n        for (const shader of pass.shaders)\n        {\n            shaders.push({\n                key: shader.key,\n                techniqueName: shader.techniqueName,\n                passIndex: shader.passIndex,\n                stageName: shader.stageName,\n                stage: shader.stage,\n                stageType: shader.stageType,\n                entryPoint: shader.entryPoint,\n                code: shader.code,\n                ...(shader.threadGroupSize ? { threadGroupSize: [ ...shader.threadGroupSize ] } : {})\n            });\n        }\n        for (const layout of pass.layouts) layouts.push(layout);\n        for (const transform of pass.resourceTransforms ?? []) resourceTransforms.push(transform);\n    }\n\n    return {\n        format: \"CJS_WGSL_SET\",\n        formatVersion: WGSL_SET_VERSION,\n        shaders,\n        layouts,\n        ...(resourceTransforms.length ? { resourceTransforms } : {})\n    };\n}\n\n/**\n * Derives the `WGSB` body-set view the chunk package used to store.\n *\n * `engine-webgpu` resolves a permutation's translated programs through this,\n * which is part of the recorded layering defect -- it should read the shader,\n * not a package document. The view keeps that path working unchanged while the\n * wire format moves underneath it, and goes away with the cleanup.\n *\n * Nothing here is stored. A body's status is whether its stages carry programs,\n * its passes are the record tree's passes, and a pass unit is that pass's\n * shaders and layouts. Bodies are keyed by distinct stored offset, which is\n * exactly what Carbon's alias dedupe produces.\n *\n * @param {object} container Loaded container.\n * @returns {object} Body-set document.\n */\nexport function deriveBackendBodySet(container)\n{\n    const bodyKeys = container.bodyKeyByOffset;\n    const passUnits = [];\n    const bodies = [];\n    const seen = new Set();\n\n    for (let index = 0; index < container.carbon.records.length; index += 1)\n    {\n        const offset = container.carbon.records[index].offset;\n        if (seen.has(offset)) continue;\n        seen.add(offset);\n\n        const bodyKey = bodyKeys.get(offset);\n        const body = container.GetBackendBodyPrograms(index);\n\n        if (!body || body.status !== \"translated\")\n        {\n            bodies.push({\n                bodyKey,\n                representativePermutationIndex: index,\n                status: \"unsupported\",\n                error: body?.error ?? \"body carries no translated programs\",\n                passCount: 0,\n                passes: []\n            });\n            continue;\n        }\n\n        const passes = [];\n        for (const pass of body.passes)\n        {\n            const unit = {\n                key: `unit${passUnits.length}`,\n                // Hashed from the unit's own content. The chunk body set stored\n                // this digest to detect a unit drifting from what referenced it;\n                // derived from the content it identifies, it cannot.\n                sha256: sha256Utf8(`${JSON.stringify({\n                    shaders: pass.shaders,\n                    layouts: pass.layouts,\n                    resourceTransforms: pass.resourceTransforms ?? []\n                })}\n`),\n                wgslSetVersion: WGSL_SET_VERSION,\n                shaders: pass.shaders,\n                layouts: pass.layouts,\n                ...(pass.resourceTransforms?.length\n                    ? { resourceTransforms: pass.resourceTransforms }\n                    : {})\n            };\n            passUnits.push(unit);\n            passes.push({ passKey: pass.passKey, unitKey: unit.key });\n        }\n\n        bodies.push({\n            bodyKey,\n            representativePermutationIndex: index,\n            status: \"translated\",\n            error: null,\n            passCount: passes.length,\n            passes\n        });\n    }\n\n    return {\n        format: \"CJS_WGSL_BODY_SET\",\n        formatVersion: 1,\n        bodyCount: bodies.length,\n        translatedBodyCount: bodies.filter((body) => body.status === \"translated\").length,\n        passUnitCount: passUnits.length,\n        passUnits,\n        bodies\n    };\n}\n\n/**\n * Finds the permutation a package resolves to.\n *\n * A \"selected\" package is not a different format -- the container always carries\n * every permutation. What makes it selected is that exactly one body was\n * translated, so the resolved permutation is the first one whose body carries\n * programs. When every body is translated, there is nothing to single out and\n * Carbon's own default applies.\n *\n * @param {object} container Loaded container.\n * @returns {number} Permutation index.\n */\nexport function resolvedPermutationIndex(container)\n{\n    const translated = [];\n    const seen = new Set();\n\n    for (let index = 0; index < container.carbon.records.length; index += 1)\n    {\n        const offset = container.carbon.records[index].offset;\n        if (seen.has(offset)) continue;\n        seen.add(offset);\n\n        const body = container.GetBackendBodyPrograms(index);\n        if (body?.status === \"translated\") translated.push(index);\n        if (translated.length > 1) return defaultPermutationIndex(container);\n    }\n\n    return translated.length === 1 ? translated[0] : defaultPermutationIndex(container);\n}\n\n/**\n * Derives the `META`-shaped view the chunk package used to store.\n *\n * Every field here is recovered from the records rather than carried:\n * `selectedOptions` from the resolved permutation's option indices, and\n * `wgslSelection` from which passes and stages actually hold programs. Build-time\n * *policy* -- `bodyMode`, `sourceIdentity`, `completeness` -- is deliberately not\n * here: it describes how the artifact was produced, not what it is, and Carbon\n * stores none of it.\n *\n * @param {object} container Loaded container.\n * @param {object} [options] View options.\n * @param {string} [options.source] Source label.\n * @param {number} [options.permutationIndex] Permutation to describe.\n * @returns {object} Metadata document.\n */\nexport function deriveMetadata(container, options = {})\n{\n    const source = options.source || container.sourcePath || \"memory\";\n    const permutationIndex = options.permutationIndex ?? resolvedPermutationIndex(container);\n    const variant = container.permutationGraph.variants[permutationIndex];\n    const axes = container.carbon.permutations;\n\n    const selectedOptions = axes.map((axis, axisIndex) => ({\n        name: axis.name.value,\n        value: axis.options[variant?.optionIndices?.[axisIndex] ?? axis.defaultOption]?.value ?? null\n    }));\n\n    const body = container.GetBackendBodyPrograms(permutationIndex);\n    const selectedStageKeys = (body?.passes ?? [])\n        .flatMap((pass) => pass.shaders.map((shader) => shader.key));\n    const passKeys = (body?.passes ?? []).map((pass) => pass.passKey);\n\n    return {\n        effectName: source,\n        sourcePath: source,\n        bodyIndex: permutationIndex,\n        selectedOptions,\n        ...(passKeys.length === 1\n            ? {\n                wgslSelection: {\n                    mode: \"explicit\",\n                    completePasses: true,\n                    techniqueName: passKeys[0].slice(0, passKeys[0].lastIndexOf(\".pass\")),\n                    passIndex: Number(/\\.pass([0-9]+)$/u.exec(passKeys[0])?.[1] ?? 0),\n                    requestedStageNames: Array.from(new Set(\n                        (body?.passes ?? []).flatMap((pass) => pass.shaders.map((shader) => shader.stageName))\n                    )),\n                    selectedStageKeys\n                }\n            }\n            : {})\n    };\n}\n\n/**\n * Derives the `INFO`-shaped summary the chunk package used to store.\n *\n * Everything here is counted from the records rather than trusted from a stored\n * field, which is why no digest accompanies it: a count derived from the thing\n * it counts cannot disagree with it.\n *\n * @param {object} container Loaded container.\n * @param {object} [options] View options.\n * @param {string} [options.source] Source label.\n * @returns {object} Info document.\n */\nexport function deriveInfo(container, options = {})\n{\n    const source = options.source || container.sourcePath || \"memory\";\n    const graph = container.permutationGraph;\n    return {\n        format: \"CARBON_WEBGPU\",\n        packageKind: \"tr2-effect-webgpu\",\n        sourcePath: source,\n        effectVersion: container.carbon.version,\n        compilerVersion: [ ...container.carbon.compilerVersion ],\n        permutationCount: graph.variants.length,\n        uniqueBodyCount: graph.bodies.length\n    };\n}\n\nexport default deriveAnalysis;\n"],"names":["defaultPermutationIndex","container","multiplier","index","axis","carbon","permutations","defaultOption","options","length","records","describeRuntime","permutationIndex","source","runtimeDescriptionFromCarbon","GetDescription","effectName","version","bytecodeFor","stage","stageType","HlslShaderBytecode","stageName","hlslShaderStageName","bytes","shaderData","shaderSize","size","stringTableOffset","offset","deriveAnalysis","sourcePath","effectDescription","buildEffectAnalysis","bindingManifest","HlslEffectBindingManifest","fromEffectDescription","effectRes","m_compilerVersion","selection","bodyIndex","selectedOptions","map","name","value","decodeBytecode","decodeInstructions","deriveWgsl","body","GetBackendBodyPrograms","shaders","layouts","resourceTransforms","pass","passes","shader","push","key","techniqueName","passIndex","entryPoint","code","threadGroupSize","layout","transform","format","formatVersion","WGSL_SET_VERSION","deriveBackendBodySet","bodyKeys","bodyKeyByOffset","passUnits","bodies","seen","Set","has","add","bodyKey","get","status","representativePermutationIndex","error","passCount","unit","sha256","sha256Utf8","JSON","stringify","wgslSetVersion","passKey","unitKey","bodyCount","translatedBodyCount","filter","passUnitCount","resolvedPermutationIndex","translated","deriveMetadata","variant","permutationGraph","variants","axes","axisIndex","optionIndices","selectedStageKeys","flatMap","passKeys","wgslSelection","mode","completePasses","slice","lastIndexOf","Number","exec","requestedStageNames","Array","from","deriveInfo","graph","packageKind","effectVersion","compilerVersion","permutationCount","uniqueBodyCount"],"mappings":"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"}

package/dist/formats/webgpu/core/{cewgpu → carbonWebgpu}/validateContainer.js

@@ -35,7 +35,7 @@ const WEBGPU_STAGE_TYPES = new Set([0, 1, 2]);
 /**
  * Validates a loaded container for WebGPU consumption.
  *
- * @param {object} container Loaded `CewgpuContainer`.
+ * @param {object} container Loaded `CarbonWebgpuContainer`.
  * @param {object} [options] Validation options.
  * @param {string} [options.source] Source label for diagnostics.
  * @throws {WebgpuReadError} When the container cannot serve WebGPU.
@@ -43,13 +43,13 @@ const WEBGPU_STAGE_TYPES = new Set([0, 1, 2]);
 function validateEffectContainer(container, options = {}) {
   const source = options.source || container.sourcePath || "memory";
   if (!container?.IsGood()) {
-    throw new WebgpuReadError("CEWGPU container is not readable", {
+    throw new WebgpuReadError("Carbon WebGPU container is not readable", {
       source,
       cause: container?.readError ?? null
     });
   }
   if (!container.carbon.records.length) {
-    throw new WebgpuReadError("CEWGPU container declares no permutation bodies", {
+    throw new WebgpuReadError("Carbon WebGPU container declares no permutation bodies", {
       source
     });
   }
@@ -73,7 +73,7 @@ function validateEffectContainer(container, options = {}) {
           // is about stages with a program, not about stages.
           if (stage.shaderData.size === 0) continue;
           if (!WEBGPU_STAGE_TYPES.has(stage.type)) {
-            throw new WebgpuReadError(`CEWGPU container carries a program for stage type ${stage.type}, ` + "which WebGPU cannot express", {
+            throw new WebgpuReadError(`Carbon WebGPU container carries a program for stage type ${stage.type}, ` + "which WebGPU cannot express", {
               source,
               permutationIndex: index,
               pass: `${technique.name.value}.pass${passIndex}`,

package/dist/formats/webgpu/core/carbonWebgpu/validateContainer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateContainer.js","sources":["../../../../../../src/formats/webgpu/core/carbonWebgpu/validateContainer.js"],"sourcesContent":["import { WebgpuReadError } from \"../errors.js\";\n\n/**\n * Structural validation for a loaded WebGPU effect container.\n *\n * This replaces `validateEffectPackageEnvelope`, which was 1762 lines. Most of\n * that is **deleted rather than translated**, and the reason matters: those\n * checks were not format invariants. The chunk container shattered one logical\n * tree into flat string-keyed arrays across `INFO`, `META`, `ANLS`, `WGSL`,\n * `PGRF` and `WGSB`, each holding a projection of the same effect, and roughly\n * 600 lines asserted that the projections still agreed with each other. A record\n * layout makes that question unaskable: containment replaces reference, position\n * replaces key, and the count word before an array replaces `Array.isArray`.\n *\n * What is deliberately **not** re-checked here, because phase 1 already enforces\n * it and checking twice means two places to keep correct:\n *\n * - count caps, arena containment, offset-table density and positional indexing,\n *   and the version range — `CjsCarbonEffectReader`;\n * - every sized record parsing to exactly its declared end — Rule 1, in the\n *   record codec and the block codec;\n * - duplicate stage type within a pass, and stage-type range — the shape adapter\n *   fails closed on both, which is where a runtime description is built.\n *\n * What remains is the one thing that is genuinely this layer's: the container\n * admits all six of Carbon's stage types by design, and WebGPU can express three.\n * That restriction belongs to the backend, not to the container — the Carbon\n * region is backend-invariant, and a container that admitted only three would not\n * be Carbon's container.\n */\n\n/** Stage types WebGPU can express, by Carbon's `InputStageType` numbering. */\nconst WEBGPU_STAGE_TYPES = new Set([ 0, 1, 2 ]);\n\n/**\n * Validates a loaded container for WebGPU consumption.\n *\n * @param {object} container Loaded `CarbonWebgpuContainer`.\n * @param {object} [options] Validation options.\n * @param {string} [options.source] Source label for diagnostics.\n * @throws {WebgpuReadError} When the container cannot serve WebGPU.\n */\nexport function validateEffectContainer(container, options = {})\n{\n    const source = options.source || container.sourcePath || \"memory\";\n\n    if (!container?.IsGood())\n    {\n        throw new WebgpuReadError(\"Carbon WebGPU container is not readable\", {\n            source,\n            cause: container?.readError ?? null\n        });\n    }\n\n    if (!container.carbon.records.length)\n    {\n        throw new WebgpuReadError(\"Carbon WebGPU container declares no permutation bodies\", { source });\n    }\n\n    // One check per distinct stored body. Aliased rows share a blob, so checking\n    // per permutation would re-check identical bytes up to twenty times over on\n    // the effects that alias hardest.\n    const checked = new Set();\n\n    for (let index = 0; index < container.carbon.records.length; index += 1)\n    {\n        const offset = container.carbon.records[index].offset;\n        if (checked.has(offset)) continue;\n        checked.add(offset);\n\n        const description = container.GetDescription(index);\n\n        for (const technique of description.techniques)\n        {\n            for (const [ passIndex, pass ] of technique.passes.entries())\n            {\n                for (const stage of pass.stages)\n                {\n                    // A stage carrying no program is reflection-only: the body\n                    // is known, the translation is not, and the emitter says so\n                    // with a zero-length payload. Those are legitimate — 107\n                    // shipped body-passes carry a geometry stage — so the rule\n                    // is about stages with a program, not about stages.\n                    if (stage.shaderData.size === 0) continue;\n\n                    if (!WEBGPU_STAGE_TYPES.has(stage.type))\n                    {\n                        throw new WebgpuReadError(\n                            `Carbon WebGPU container carries a program for stage type ${stage.type}, `\n                            + \"which WebGPU cannot express\",\n                            {\n                                source,\n                                permutationIndex: index,\n                                pass: `${technique.name.value}.pass${passIndex}`,\n                                stageType: stage.type\n                            }\n                        );\n                    }\n                }\n            }\n        }\n    }\n}\n\nexport default validateEffectContainer;\n"],"names":["WEBGPU_STAGE_TYPES","Set","validateEffectContainer","container","options","source","sourcePath","IsGood","WebgpuReadError","cause","readError","carbon","records","length","checked","index","offset","has","add","description","GetDescription","technique","techniques","passIndex","pass","passes","entries","stage","stages","shaderData","size","type","permutationIndex","name","value","stageType"],"mappings":";;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA,MAAMA,kBAAkB,GAAG,IAAIC,GAAG,CAAC,CAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAE,CAAC;;AAE/C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,uBAAuBA,CAACC,SAAS,EAAEC,OAAO,GAAG,EAAE,EAC/D;EACI,MAAMC,MAAM,GAAGD,OAAO,CAACC,MAAM,IAAIF,SAAS,CAACG,UAAU,IAAI,QAAQ;AAEjE,EAAA,IAAI,CAACH,SAAS,EAAEI,MAAM,EAAE,EACxB;AACI,IAAA,MAAM,IAAIC,eAAe,CAAC,yCAAyC,EAAE;MACjEH,MAAM;AACNI,MAAAA,KAAK,EAAEN,SAAS,EAAEO,SAAS,IAAI;AACnC,KAAC,CAAC;AACN,EAAA;EAEA,IAAI,CAACP,SAAS,CAACQ,MAAM,CAACC,OAAO,CAACC,MAAM,EACpC;AACI,IAAA,MAAM,IAAIL,eAAe,CAAC,wDAAwD,EAAE;AAAEH,MAAAA;AAAO,KAAC,CAAC;AACnG,EAAA;;AAEA;AACA;AACA;AACA,EAAA,MAAMS,OAAO,GAAG,IAAIb,GAAG,EAAE;AAEzB,EAAA,KAAK,IAAIc,KAAK,GAAG,CAAC,EAAEA,KAAK,GAAGZ,SAAS,CAACQ,MAAM,CAACC,OAAO,CAACC,MAAM,EAAEE,KAAK,IAAI,CAAC,EACvE;IACI,MAAMC,MAAM,GAAGb,SAAS,CAACQ,MAAM,CAACC,OAAO,CAACG,KAAK,CAAC,CAACC,MAAM;AACrD,IAAA,IAAIF,OAAO,CAACG,GAAG,CAACD,MAAM,CAAC,EAAE;AACzBF,IAAAA,OAAO,CAACI,GAAG,CAACF,MAAM,CAAC;AAEnB,IAAA,MAAMG,WAAW,GAAGhB,SAAS,CAACiB,cAAc,CAACL,KAAK,CAAC;AAEnD,IAAA,KAAK,MAAMM,SAAS,IAAIF,WAAW,CAACG,UAAU,EAC9C;AACI,MAAA,KAAK,MAAM,CAAEC,SAAS,EAAEC,IAAI,CAAE,IAAIH,SAAS,CAACI,MAAM,CAACC,OAAO,EAAE,EAC5D;AACI,QAAA,KAAK,MAAMC,KAAK,IAAIH,IAAI,CAACI,MAAM,EAC/B;AACI;AACA;AACA;AACA;AACA;AACA,UAAA,IAAID,KAAK,CAACE,UAAU,CAACC,IAAI,KAAK,CAAC,EAAE;UAEjC,IAAI,CAAC9B,kBAAkB,CAACiB,GAAG,CAACU,KAAK,CAACI,IAAI,CAAC,EACvC;YACI,MAAM,IAAIvB,eAAe,CACrB,CAAA,yDAAA,EAA4DmB,KAAK,CAACI,IAAI,CAAA,EAAA,CAAI,GACxE,6BAA6B,EAC/B;cACI1B,MAAM;AACN2B,cAAAA,gBAAgB,EAAEjB,KAAK;cACvBS,IAAI,EAAE,GAAGH,SAAS,CAACY,IAAI,CAACC,KAAK,CAAA,KAAA,EAAQX,SAAS,CAAA,CAAE;cAChDY,SAAS,EAAER,KAAK,CAACI;AACrB,aACJ,CAAC;AACL,UAAA;AACJ,QAAA;AACJ,MAAA;AACJ,IAAA;AACJ,EAAA;AACJ;;;;"}

package/dist/formats/webgpu/core/effectBackendBodySet.js

@@ -1,5 +1,5 @@
 import { HlslEffectBindingManifest } from '../../hlsl/core/tr2/shader/HlslEffectBindingManifest.js';
-import { enumerateUniqueEffectBodies } from '../../hlsl/core/portableReflection.js';
+import { enumerateUniqueEffectBodies } from '../../../format/effect/effectBodyInventory.js';
 import { buildEffectAnalysis } from './helpers.js';
 import { normalizeBytecodeBytes } from './effectAnalysis.js';
 import { lowerDxbcToIr } from './ir/lowerDxbcToIr.js';
@@ -16,13 +16,13 @@ const EFFECT_BACKEND_BODY_SET_CHUNK = "WGSB";
 const EFFECT_BACKEND_BODY_SET_FORMAT = "CJS_WGSL_BODY_SET";
 const EFFECT_BACKEND_BODY_SET_VERSION = 1;
 
-/**
- * One translation unit is exactly one pass of one body: the binding plan, the
- * resource-transform plan, and every stage's emitted WGSL are derived together.
- * Bodies that share an identical pass signature therefore share one unit.
- *
- * @param {object} pass Pass entry carrying its ordered stage records.
- * @returns {string} Stable signature for the pass translation unit.
+/**
+ * One translation unit is exactly one pass of one body: the binding plan, the
+ * resource-transform plan, and every stage's emitted WGSL are derived together.
+ * Bodies that share an identical pass signature therefore share one unit.
+ *
+ * @param {object} pass Pass entry carrying its ordered stage records.
+ * @returns {string} Stable signature for the pass translation unit.
  */
 function passUnitSignature(pass) {
   return JSON.stringify({
@@ -157,19 +157,19 @@ function translatePassUnit(pass, programForKey, source, bindingPolicy) {
   })));
 }
 
-/**
- * Translate every unique source body into backend programs, layouts, and
- * resource transforms, sharing one translation unit between bodies whose pass
- * is byte-for-byte identical.
- *
+/**
+ * Translate every unique source body into backend programs, layouts, and
+ * resource transforms, sharing one translation unit between bodies whose pass
+ * is byte-for-byte identical.
+ *
  * A body that cannot be lowered is retained as an explicitly unsupported
  * in-memory record carrying its reason. Portable source reflection is built
  * separately from the same effect; this body-set document does not store it.
- *
- * @param {object} effectRes Loaded version-15 `Tr2EffectRes`.
- * @param {object} permutationGraph Validated `PGRF` document.
- * @param {object} [options] Source label, stage selection, and binding policy.
- * @returns {object} Frozen `CJS_WGSL_BODY_SET` document.
+ *
+ * @param {object} effectRes Loaded version-15 `Tr2EffectRes`.
+ * @param {object} permutationGraph Validated `PGRF` document.
+ * @param {object} [options] Source label, stage selection, and binding policy.
+ * @returns {object} Frozen `CJS_WGSL_BODY_SET` document.
  */
 function buildEffectBackendBodySet(effectRes, permutationGraph, options = {}) {
   const source = options.source || "memory";