@carbonenginejs/runtime-resource 0.12.2 → 0.14.0

package/dist/formats/webgl/core/readGlslEffectContainer.js

@@ -0,0 +1,249 @@
+import { CjsCarbonEffectReader } from '../../../format/carbonEffect/CjsCarbonEffectReader.js';
+import { readGlslBackendBlock } from './glslBackendBlock.js';
+import { hlslShaderStageName } from '../../hlsl/core/tr2/HlslRenderContextEnum.js';
+import { runtimeDescriptionFromCarbon } from '../../hlsl/core/carbonDescriptionToRuntime.js';
+import { HlslEffectBindingManifest } from '../../hlsl/core/tr2/shader/HlslEffectBindingManifest.js';
+
+/**
+ * Decodes a WebGL effect container into the stage/shader records the
+ * completeness rules consume.
+ *
+ * This exists so the rules run from container bytes alone. The alternative was
+ * to hand them the in-memory translation, which works inside `buildEffectPackage`
+ * and nowhere else — the validator reads a finished file and has no translation
+ * in scope. That would have cost the validator its completeness check while
+ * still requiring a decoder to produce the programs it compiles in a browser, so
+ * it was strictly more work for strictly less checking.
+ *
+ * The vocabulary is deliberately the one the rules already speak — `stages` with
+ * pass coordinates, `shaders` with source and a translation verdict. The rules
+ * are about the translation, not about how it was stored, so retargeting them
+ * meant changing where the records come from and nothing about what they mean.
+ *
+ * **What the wire cannot tell you.** `buildCarbonEffectContainer` stores a body
+ * the translator could not lower as its full pass tree with zero-length
+ * programs; the *reason* it failed stays in the in-memory build result and is
+ * never written. So a shader decoded from bytes reports `ok: false` with
+ * "no program was stored" and nothing more specific. That is the honest answer:
+ * a file on disk does not know why a translation failed months ago. Callers that
+ * do know — `buildEffectPackage`, at build time — keep their specific
+ * diagnostics by feeding the rules their own records instead.
+ */
+
+/** The verdict a stage carrying no stored program gets. */
+const NO_PROGRAM_REASON = "no program was stored";
+
+/**
+ * Derives the per-stage binding manifests for one body through the one
+ * manifest builder the source path uses.
+ *
+ * This replaces a hand-built reshape of the wire records into the manifest
+ * vocabulary. That copy had already diverged from the real manifest once —
+ * `isAutoregister` was silently dropped, making every resource look
+ * user-settable — which is the whole argument against a second producer: two
+ * hand-maintained spellings of one reflection drift, and the drift is exactly
+ * the kind of bug that draws, links and renders black without an error. The
+ * record tree now flows through `runtimeDescriptionFromCarbon` — the
+ * corpus-proven adapter the runtime read path uses — and
+ * `HlslEffectBindingManifest`, so the container read and the build-time
+ * package derive their manifests from the same code.
+ *
+ * No `bytecodeFor` is supplied: program text lives in the shader records this
+ * reader emits, so the manifest's `shaderBytecode` stays null rather than
+ * duplicating every program into the reflection.
+ *
+ * @param {object} description Decoded Carbon description record tree.
+ * @param {number} version Container data version.
+ * @param {string} source Source name for diagnostics.
+ * @returns {Map<string, object>} Manifest stage records keyed by
+ *     `technique.passN.stageName`.
+ */
+function bodyManifestStages(description, version, source) {
+  const runtime = runtimeDescriptionFromCarbon(description, {
+    effectName: source,
+    version
+  });
+  const manifest = HlslEffectBindingManifest.fromEffectDescription(runtime).toJSON();
+  return new Map(manifest.stages.map(stage => [`${stage.techniqueName}.pass${stage.passIndex}.${stage.stageName}`, stage]));
+}
+
+/**
+ * Decodes one pass's backend block, tolerating a pass that has none.
+ *
+ * @param {object} pass Decoded pass record.
+ * @param {string} passKey Enclosing pass key.
+ * @param {string} source Source name for error details.
+ * @returns {object} Per-stage backend data, keyed by stage name.
+ */
+function backendStages(pass, passKey, source) {
+  if (!pass.backendBlock?.size) return {
+    stages: {},
+    transforms: []
+  };
+  const block = readGlslBackendBlock(pass.backendBlock.bytes, {
+    layoutKey: passKey,
+    source
+  });
+  return {
+    stages: block.stages ?? {},
+    transforms: block.transforms ?? []
+  };
+}
+
+/**
+ * Decodes container bytes into stage and shader records.
+ *
+ * Bodies are decoded once each rather than once per permutation row: rows alias
+ * onto shared bodies, and a rule that saw the same body 4,096 times would report
+ * 4,096 identical incomplete passes.
+ *
+ * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Container payload.
+ * @param {object} [values] Read values.
+ * @param {string} [values.source] Source name, for diagnostics.
+ * @returns {{stages:object[], shaders:object[], recordCount:number, bodyCount:number}}
+ *   Stage graph in the completeness rules' vocabulary.
+ */
+function readGlslEffectContainer(input, values = {}) {
+  const source = values.source ?? "memory";
+  const reader = new CjsCarbonEffectReader(input, {
+    source
+  });
+  const stages = [];
+  const shaders = [];
+  const bodyKeyByOffset = new Map();
+
+  // Every permutation index that resolves to each body.
+  //
+  // This is the bridge a caller actually needs, and the only one that is
+  // sound. `bodyKey` here is this reader's own ordinal spelling; the
+  // permutation graph mints `body${N}` for the same body, and the two are not
+  // merely spelled differently — the graph dedupes by content (SHA-256 plus
+  // byte equality) while this reader dedupes by source-record offset. Those
+  // partitions coincide only because the container writer aliases
+  // byte-identical bodies onto one offset, which is a property of the writer
+  // rather than a contract.
+  //
+  // So a consumer must never map between the two by string surgery on either
+  // spelling, and must not assume the two ordinal sequences agree. It holds a
+  // permutation index; this gives it the body directly.
+  const permutationIndicesByOffset = new Map();
+  for (let index = 0; index < reader.records.length; index += 1) {
+    const {
+      offset
+    } = reader.records[index];
+    const seen = permutationIndicesByOffset.get(offset);
+    if (seen) seen.push(index);else permutationIndicesByOffset.set(offset, [index]);
+  }
+
+  // Distinct program texts share one shader record, so `shaders` counts unique
+  // translations the way the chunk package's shader table did. Empty stages are
+  // deliberately *not* pooled: each keeps its own record so a report can name
+  // every pass that is missing a program rather than one shared "absent".
+  //
+  // The pool key is the program text *and* the backend reflection that came
+  // with it, not the text alone. A pooled record carries the bindings and
+  // stage inputs of whichever stage was seen first, and
+  // `validateShaderRuntimeContract` judges the emitted GLSL against them — so
+  // pooling on text alone would let two stages with identical source but
+  // different reflection be checked against the wrong metadata, silently. It
+  // is unlikely that identical GLSL ever carries different reflection, which
+  // is exactly why it would not be noticed.
+  const shaderKeyByIdentity = new Map();
+  for (let index = 0; index < reader.records.length; index += 1) {
+    const {
+      offset
+    } = reader.records[index];
+    if (bodyKeyByOffset.has(offset)) continue;
+    const bodyKey = `body_${bodyKeyByOffset.size}`;
+    bodyKeyByOffset.set(offset, bodyKey);
+    const description = reader.readDescription(index, {
+      backend: true
+    });
+    const manifestStages = bodyManifestStages(description, reader.version, source);
+    for (const technique of description.techniques) {
+      const techniqueName = technique.name.value;
+      for (const [passIndex, pass] of technique.passes.entries()) {
+        const passKey = `${techniqueName}.pass${passIndex}`;
+        const {
+          stages: backend,
+          transforms
+        } = backendStages(pass, passKey, source);
+        for (const stage of pass.stages) {
+          const name = hlslShaderStageName(stage.type);
+          const stageKey = `${bodyKey}.${passKey}.${name}`;
+          const stageBackend = backend[name] ?? {};
+          let shaderKey;
+          if (stage.shaderData?.size) {
+            const code = new TextDecoder().decode(stage.shaderData.bytes);
+            const identity = `${JSON.stringify([stageBackend.bindings ?? [], stageBackend.stageInputs ?? [], stageBackend.computeFragment ?? null])} ${code}`;
+            const pooled = shaderKeyByIdentity.get(identity);
+            if (pooled) {
+              shaderKey = pooled;
+            } else {
+              shaderKey = `shader_${shaderKeyByIdentity.size}`;
+              shaderKeyByIdentity.set(identity, shaderKey);
+              shaders.push({
+                key: shaderKey,
+                stageName: name,
+                source: code,
+                hlsl2webgl: {
+                  ok: true
+                },
+                bindings: stageBackend.bindings ?? [],
+                stageInputs: stageBackend.stageInputs ?? [],
+                ...(stageBackend.computeFragment ? {
+                  computeFragment: stageBackend.computeFragment
+                } : {})
+              });
+            }
+          } else {
+            shaderKey = `${stageKey}.absent`;
+            shaders.push({
+              key: shaderKey,
+              stageName: name,
+              source: "",
+              hlsl2webgl: {
+                ok: false,
+                reason: NO_PROGRAM_REASON
+              },
+              bindings: stageBackend.bindings ?? [],
+              stageInputs: stageBackend.stageInputs ?? []
+            });
+          }
+          stages.push({
+            key: stageKey,
+            bodyKey,
+            techniqueName,
+            passIndex,
+            stageName: name,
+            stageType: stage.type,
+            shaderKey,
+            manifest: manifestStages.get(`${passKey}.${name}`) ?? null,
+            // The pass's transforms, so a rule can ask whether a
+            // description resource was merged away rather than lost.
+            transforms
+          });
+        }
+      }
+    }
+  }
+
+  // Ordered by first appearance, matching `bodyKey`'s ordinal.
+  const bodies = [];
+  for (const [offset, key] of bodyKeyByOffset) {
+    bodies.push({
+      key,
+      permutationIndices: Object.freeze(permutationIndicesByOffset.get(offset) ?? [])
+    });
+  }
+  return {
+    stages,
+    shaders,
+    bodies,
+    recordCount: reader.records.length,
+    bodyCount: bodyKeyByOffset.size
+  };
+}
+
+export { readGlslEffectContainer };
+//# sourceMappingURL=readGlslEffectContainer.js.map

package/dist/formats/webgl/core/readGlslEffectContainer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readGlslEffectContainer.js","sources":["../../../../../src/formats/webgl/core/readGlslEffectContainer.js"],"sourcesContent":["import { CjsCarbonEffectReader } from \"../../../format/carbonEffect/CjsCarbonEffectReader.js\";\r\nimport { readGlslBackendBlock } from \"./glslBackendBlock.js\";\r\nimport { hlslShaderStageName } from \"../../hlsl/core/tr2/HlslRenderContextEnum.js\";\r\nimport { runtimeDescriptionFromCarbon } from \"../../hlsl/core/carbonDescriptionToRuntime.js\";\r\nimport { HlslEffectBindingManifest } from \"../../hlsl/core/tr2/shader/HlslEffectBindingManifest.js\";\r\n\r\n/**\r\n * Decodes a WebGL effect container into the stage/shader records the\r\n * completeness rules consume.\r\n *\r\n * This exists so the rules run from container bytes alone. The alternative was\r\n * to hand them the in-memory translation, which works inside `buildEffectPackage`\r\n * and nowhere else — the validator reads a finished file and has no translation\r\n * in scope. That would have cost the validator its completeness check while\r\n * still requiring a decoder to produce the programs it compiles in a browser, so\r\n * it was strictly more work for strictly less checking.\r\n *\r\n * The vocabulary is deliberately the one the rules already speak — `stages` with\r\n * pass coordinates, `shaders` with source and a translation verdict. The rules\r\n * are about the translation, not about how it was stored, so retargeting them\r\n * meant changing where the records come from and nothing about what they mean.\r\n *\r\n * **What the wire cannot tell you.** `buildCarbonEffectContainer` stores a body\r\n * the translator could not lower as its full pass tree with zero-length\r\n * programs; the *reason* it failed stays in the in-memory build result and is\r\n * never written. So a shader decoded from bytes reports `ok: false` with\r\n * \"no program was stored\" and nothing more specific. That is the honest answer:\r\n * a file on disk does not know why a translation failed months ago. Callers that\r\n * do know — `buildEffectPackage`, at build time — keep their specific\r\n * diagnostics by feeding the rules their own records instead.\r\n */\r\n\r\n/** The verdict a stage carrying no stored program gets. */\r\nconst NO_PROGRAM_REASON = \"no program was stored\";\r\n\r\n/**\r\n * Derives the per-stage binding manifests for one body through the one\r\n * manifest builder the source path uses.\r\n *\r\n * This replaces a hand-built reshape of the wire records into the manifest\r\n * vocabulary. That copy had already diverged from the real manifest once —\r\n * `isAutoregister` was silently dropped, making every resource look\r\n * user-settable — which is the whole argument against a second producer: two\r\n * hand-maintained spellings of one reflection drift, and the drift is exactly\r\n * the kind of bug that draws, links and renders black without an error. The\r\n * record tree now flows through `runtimeDescriptionFromCarbon` — the\r\n * corpus-proven adapter the runtime read path uses — and\r\n * `HlslEffectBindingManifest`, so the container read and the build-time\r\n * package derive their manifests from the same code.\r\n *\r\n * No `bytecodeFor` is supplied: program text lives in the shader records this\r\n * reader emits, so the manifest's `shaderBytecode` stays null rather than\r\n * duplicating every program into the reflection.\r\n *\r\n * @param {object} description Decoded Carbon description record tree.\r\n * @param {number} version Container data version.\r\n * @param {string} source Source name for diagnostics.\r\n * @returns {Map<string, object>} Manifest stage records keyed by\r\n *     `technique.passN.stageName`.\r\n */\r\nfunction bodyManifestStages(description, version, source)\r\n{\r\n    const runtime = runtimeDescriptionFromCarbon(description, {\r\n        effectName: source,\r\n        version\r\n    });\r\n    const manifest = HlslEffectBindingManifest.fromEffectDescription(runtime).toJSON();\r\n    return new Map(manifest.stages.map((stage) => [\r\n        `${stage.techniqueName}.pass${stage.passIndex}.${stage.stageName}`,\r\n        stage\r\n    ]));\r\n}\r\n\r\n/**\r\n * Decodes one pass's backend block, tolerating a pass that has none.\r\n *\r\n * @param {object} pass Decoded pass record.\r\n * @param {string} passKey Enclosing pass key.\r\n * @param {string} source Source name for error details.\r\n * @returns {object} Per-stage backend data, keyed by stage name.\r\n */\r\nfunction backendStages(pass, passKey, source)\r\n{\r\n    if (!pass.backendBlock?.size) return { stages: {}, transforms: [] };\r\n    const block = readGlslBackendBlock(pass.backendBlock.bytes, { layoutKey: passKey, source });\r\n    return { stages: block.stages ?? {}, transforms: block.transforms ?? [] };\r\n}\r\n\r\n/**\r\n * Decodes container bytes into stage and shader records.\r\n *\r\n * Bodies are decoded once each rather than once per permutation row: rows alias\r\n * onto shared bodies, and a rule that saw the same body 4,096 times would report\r\n * 4,096 identical incomplete passes.\r\n *\r\n * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Container payload.\r\n * @param {object} [values] Read values.\r\n * @param {string} [values.source] Source name, for diagnostics.\r\n * @returns {{stages:object[], shaders:object[], recordCount:number, bodyCount:number}}\r\n *   Stage graph in the completeness rules' vocabulary.\r\n */\r\nexport function readGlslEffectContainer(input, values = {})\r\n{\r\n    const source = values.source ?? \"memory\";\r\n    const reader = new CjsCarbonEffectReader(input, { source });\r\n\r\n    const stages = [];\r\n    const shaders = [];\r\n    const bodyKeyByOffset = new Map();\r\n\r\n    // Every permutation index that resolves to each body.\r\n    //\r\n    // This is the bridge a caller actually needs, and the only one that is\r\n    // sound. `bodyKey` here is this reader's own ordinal spelling; the\r\n    // permutation graph mints `body${N}` for the same body, and the two are not\r\n    // merely spelled differently — the graph dedupes by content (SHA-256 plus\r\n    // byte equality) while this reader dedupes by source-record offset. Those\r\n    // partitions coincide only because the container writer aliases\r\n    // byte-identical bodies onto one offset, which is a property of the writer\r\n    // rather than a contract.\r\n    //\r\n    // So a consumer must never map between the two by string surgery on either\r\n    // spelling, and must not assume the two ordinal sequences agree. It holds a\r\n    // permutation index; this gives it the body directly.\r\n    const permutationIndicesByOffset = new Map();\r\n\r\n    for (let index = 0; index < reader.records.length; index += 1)\r\n    {\r\n        const { offset } = reader.records[index];\r\n        const seen = permutationIndicesByOffset.get(offset);\r\n        if (seen) seen.push(index);\r\n        else permutationIndicesByOffset.set(offset, [ index ]);\r\n    }\r\n\r\n    // Distinct program texts share one shader record, so `shaders` counts unique\r\n    // translations the way the chunk package's shader table did. Empty stages are\r\n    // deliberately *not* pooled: each keeps its own record so a report can name\r\n    // every pass that is missing a program rather than one shared \"absent\".\r\n    //\r\n    // The pool key is the program text *and* the backend reflection that came\r\n    // with it, not the text alone. A pooled record carries the bindings and\r\n    // stage inputs of whichever stage was seen first, and\r\n    // `validateShaderRuntimeContract` judges the emitted GLSL against them — so\r\n    // pooling on text alone would let two stages with identical source but\r\n    // different reflection be checked against the wrong metadata, silently. It\r\n    // is unlikely that identical GLSL ever carries different reflection, which\r\n    // is exactly why it would not be noticed.\r\n    const shaderKeyByIdentity = new Map();\r\n\r\n    for (let index = 0; index < reader.records.length; index += 1)\r\n    {\r\n        const { offset } = reader.records[index];\r\n        if (bodyKeyByOffset.has(offset)) continue;\r\n\r\n        const bodyKey = `body_${bodyKeyByOffset.size}`;\r\n        bodyKeyByOffset.set(offset, bodyKey);\r\n\r\n        const description = reader.readDescription(index, { backend: true });\r\n        const manifestStages = bodyManifestStages(description, reader.version, source);\r\n\r\n        for (const technique of description.techniques)\r\n        {\r\n            const techniqueName = technique.name.value;\r\n            for (const [ passIndex, pass ] of technique.passes.entries())\r\n            {\r\n                const passKey = `${techniqueName}.pass${passIndex}`;\r\n                const { stages: backend, transforms } = backendStages(\r\n                    pass,\r\n                    passKey,\r\n                    source\r\n                );\r\n\r\n                for (const stage of pass.stages)\r\n                {\r\n                    const name = hlslShaderStageName(stage.type);\r\n                    const stageKey = `${bodyKey}.${passKey}.${name}`;\r\n                    const stageBackend = backend[name] ?? {};\r\n\r\n                    let shaderKey;\r\n                    if (stage.shaderData?.size)\r\n                    {\r\n                        const code = new TextDecoder().decode(stage.shaderData.bytes);\r\n                        const identity = `${JSON.stringify([\r\n                            stageBackend.bindings ?? [],\r\n                            stageBackend.stageInputs ?? [],\r\n                            stageBackend.computeFragment ?? null\r\n                        ])} ${code}`;\r\n                        const pooled = shaderKeyByIdentity.get(identity);\r\n                        if (pooled)\r\n                        {\r\n                            shaderKey = pooled;\r\n                        }\r\n                        else\r\n                        {\r\n                            shaderKey = `shader_${shaderKeyByIdentity.size}`;\r\n                            shaderKeyByIdentity.set(identity, shaderKey);\r\n                            shaders.push({\r\n                                key: shaderKey,\r\n                                stageName: name,\r\n                                source: code,\r\n                                hlsl2webgl: { ok: true },\r\n                                bindings: stageBackend.bindings ?? [],\r\n                                stageInputs: stageBackend.stageInputs ?? [],\r\n                                ...(stageBackend.computeFragment\r\n                                    ? { computeFragment: stageBackend.computeFragment }\r\n                                    : {})\r\n                            });\r\n                        }\r\n                    }\r\n                    else\r\n                    {\r\n                        shaderKey = `${stageKey}.absent`;\r\n                        shaders.push({\r\n                            key: shaderKey,\r\n                            stageName: name,\r\n                            source: \"\",\r\n                            hlsl2webgl: { ok: false, reason: NO_PROGRAM_REASON },\r\n                            bindings: stageBackend.bindings ?? [],\r\n                            stageInputs: stageBackend.stageInputs ?? []\r\n                        });\r\n                    }\r\n\r\n                    stages.push({\r\n                        key: stageKey,\r\n                        bodyKey,\r\n                        techniqueName,\r\n                        passIndex,\r\n                        stageName: name,\r\n                        stageType: stage.type,\r\n                        shaderKey,\r\n                        manifest: manifestStages.get(`${passKey}.${name}`) ?? null,\r\n                        // The pass's transforms, so a rule can ask whether a\r\n                        // description resource was merged away rather than lost.\r\n                        transforms\r\n                    });\r\n                }\r\n            }\r\n        }\r\n    }\r\n\r\n    // Ordered by first appearance, matching `bodyKey`'s ordinal.\r\n    const bodies = [];\r\n    for (const [ offset, key ] of bodyKeyByOffset)\r\n    {\r\n        bodies.push({\r\n            key,\r\n            permutationIndices: Object.freeze(permutationIndicesByOffset.get(offset) ?? [])\r\n        });\r\n    }\r\n\r\n    return {\r\n        stages,\r\n        shaders,\r\n        bodies,\r\n        recordCount: reader.records.length,\r\n        bodyCount: bodyKeyByOffset.size\r\n    };\r\n}\r\n\r\nexport default readGlslEffectContainer;\r\n"],"names":["NO_PROGRAM_REASON","bodyManifestStages","description","version","source","runtime","runtimeDescriptionFromCarbon","effectName","manifest","HlslEffectBindingManifest","fromEffectDescription","toJSON","Map","stages","map","stage","techniqueName","passIndex","stageName","backendStages","pass","passKey","backendBlock","size","transforms","block","readGlslBackendBlock","bytes","layoutKey","readGlslEffectContainer","input","values","reader","CjsCarbonEffectReader","shaders","bodyKeyByOffset","permutationIndicesByOffset","index","records","length","offset","seen","get","push","set","shaderKeyByIdentity","has","bodyKey","readDescription","backend","manifestStages","technique","techniques","name","value","passes","entries","hlslShaderStageName","type","stageKey","stageBackend","shaderKey","shaderData","code","TextDecoder","decode","identity","JSON","stringify","bindings","stageInputs","computeFragment","pooled","key","hlsl2webgl","ok","reason","stageType","bodies","permutationIndices","Object","freeze","recordCount","bodyCount"],"mappings":"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"}

package/dist/formats/webgpu/CjsWebgpuFormat.js

@@ -5,12 +5,12 @@ import { buildWgslBindingPlan } from './core/wgsl/buildWgslBindingPlan.js';
 import { buildWgslSet } from './core/wgsl/buildWgslSet.js';
 import { buildEffectPackage } from './core/packageEffect.js';
 import { FORMAT_WEBGPU_PACKAGE_VERSION } from './core/packageMetadata.js';
-import { DEFAULT_VALUES, normalizeValues, validateClassKey, validateClass, readWithValues, inspectWithValues, analyzeEffectWithValues, toJsonValue, isCewgpu, OUTPUT_JSON, OUTPUT_RAW, CEWGPU_FORMAT, CEWGPU_ANALYSIS_FORMAT } from './core/helpers.js';
+import { DEFAULT_VALUES, normalizeValues, validateClassKey, validateClass, readWithValues, inspectWithValues, analyzeEffectWithValues, toJsonValue, isCarbonWebgpu, OUTPUT_JSON, OUTPUT_RAW, CARBON_WEBGPU_FORMAT, CARBON_WEBGPU_ANALYSIS_FORMAT } from './core/helpers.js';
 
 const FORMAT_NAME = "CjsWebgpuFormat";
 
 /**
- * CarbonEngineJS-facing format surface for `.cewgpu` WebGPU packages, plus an
+ * CarbonEngineJS-facing format surface for `.carbonwebgpu` WebGPU packages, plus an
  * offline effect-analysis helper built on the runtime-resource HLSL and DXBC
  * format subpaths.
  *
@@ -124,9 +124,9 @@ class CjsWebgpuFormat {
   }
 
   /**
-   * Read a CEWGPU package with this profile's values.
+   * Read a Carbon WebGPU package with this profile's values.
    *
-   * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input CEWGPU package bytes.
+   * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Carbon WebGPU package bytes.
    * @param {object} [options] Per-call value overrides.
    * @returns {object} Plain JSON data, or the raw package instance when emit is "raw".
    */
@@ -135,9 +135,9 @@ class CjsWebgpuFormat {
   }
 
   /**
-   * Inspect a CEWGPU package without building the full JSON shape.
+   * Inspect a Carbon WebGPU package without building the full JSON shape.
    *
-   * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input CEWGPU package bytes.
+   * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Carbon WebGPU package bytes.
    * @param {object} [options] Per-call value overrides.
    * @returns {object} Plain summary data.
    */
@@ -158,7 +158,7 @@ class CjsWebgpuFormat {
   }
 
   /**
-   * Builds a CEWGPU package with complete version-15 source reflection and
+   * Builds a Carbon WebGPU package with complete version-15 source reflection and
    * selected-body WebGPU output from compiled Tr2 effect bytes.
    *
    * @param {Uint8Array|ArrayBuffer|ArrayBufferView} input Compiled effect bytes.
@@ -236,14 +236,14 @@ class CjsWebgpuFormat {
    * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Candidate bytes.
    * @returns {boolean} True when the payload has Carbon's version-15 shape.
    */
-  static isCewgpu(input) {
-    return isCewgpu(input);
+  static isCarbonWebgpu(input) {
+    return isCarbonWebgpu(input);
   }
 
   /**
    * Static one-shot read.
    *
-   * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input CEWGPU package bytes.
+   * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Carbon WebGPU package bytes.
    * @param {object} [options] Format values.
    * @returns {object} Plain JSON data, or the raw package instance when emit is "raw".
    */
@@ -254,7 +254,7 @@ class CjsWebgpuFormat {
   /**
    * Static one-shot inspection.
    *
-   * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input CEWGPU package bytes.
+   * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Carbon WebGPU package bytes.
    * @param {object} [options] Format values.
    * @returns {object} Plain summary data.
    */
@@ -274,7 +274,7 @@ class CjsWebgpuFormat {
   }
 
   /**
-   * Static selected-body CEWGPU builder.
+   * Static selected-body Carbon WebGPU builder.
    *
    * @param {Uint8Array|ArrayBuffer|ArrayBufferView} input Compiled effect bytes.
    * @param {object} [options] Source, body-mode, permutation, and stage-selection policy.
@@ -344,12 +344,12 @@ class CjsWebgpuFormat {
   static CLASS_KEYS = CLASS_KEYS;
   static type = Object.freeze(["shader"]);
   static mediaTypes = Object.freeze(["shader"]);
-  static inputTypes = Object.freeze(["cewgpu"]);
+  static inputTypes = Object.freeze(["carbonwebgpu"]);
   static outputTypes = Object.freeze([OUTPUT_JSON]);
   static debugOutputTypes = Object.freeze([OUTPUT_RAW]);
   static implementationStatus = "partial";
-  static format = CEWGPU_FORMAT;
-  static analysisFormat = CEWGPU_ANALYSIS_FORMAT;
+  static format = CARBON_WEBGPU_FORMAT;
+  static analysisFormat = CARBON_WEBGPU_ANALYSIS_FORMAT;
   static packageVersion = FORMAT_WEBGPU_PACKAGE_VERSION;
 }
 

package/dist/formats/webgpu/CjsWebgpuFormat.js.map

@@ -1 +1 @@
-{"version":3,"file":"CjsWebgpuFormat.js","sources":["../../../../src/formats/webgpu/CjsWebgpuFormat.js"],"sourcesContent":["import { CLASS_KEYS } from \"./core/schema.js\";\nimport { lowerDxbcToIr } from \"./core/ir/lowerDxbcToIr.js\";\nimport { buildWgsl } from \"./core/wgsl/emitWgsl.js\";\nimport { buildWgslBindingPlan } from \"./core/wgsl/buildWgslBindingPlan.js\";\nimport { buildWgslSet } from \"./core/wgsl/buildWgslSet.js\";\nimport { buildEffectPackage } from \"./core/packageEffect.js\";\nimport { FORMAT_WEBGPU_PACKAGE_VERSION } from \"./core/packageMetadata.js\";\nimport {\n    CEWGPU_ANALYSIS_FORMAT,\n    CEWGPU_FORMAT,\n    DEFAULT_VALUES,\n    OUTPUT_JSON,\n    OUTPUT_RAW,\n    analyzeEffectWithValues,\n    inspectWithValues,\n    isCewgpu,\n    normalizeValues,\n    readWithValues,\n    toJsonValue,\n    validateClass,\n    validateClassKey\n} from \"./core/helpers.js\";\n\nconst FORMAT_NAME = \"CjsWebgpuFormat\";\n\n/**\n * CarbonEngineJS-facing format surface for `.cewgpu` WebGPU packages, plus an\n * offline effect-analysis helper built on the runtime-resource HLSL and DXBC\n * format subpaths.\n *\n * The package owns read/build, normalized shader analysis, and the current\n * bounded DXBC-to-WGSL profiles. Broader shader-semantic coverage remains an\n * explicit qualification ladder.\n */\nexport class CjsWebgpuFormat\n{\n    #emit = DEFAULT_VALUES.emit;\n    #source = DEFAULT_VALUES.source;\n    #decodeInstructions = DEFAULT_VALUES.decodeInstructions;\n    #permutation = DEFAULT_VALUES.permutation;\n    #schema = DEFAULT_VALUES.schema;\n    #classes = {};\n\n    /**\n     * Create a reusable format profile.\n     *\n     * @param {object} [options] Default format values.\n     */\n    constructor(options = {})\n    {\n        this.SetValues(options);\n    }\n\n    /**\n     * Set format values for this reusable profile.\n     *\n     * @param {object} [options] Values to merge into the profile.\n     * @returns {CjsWebgpuFormat} This format profile.\n     */\n    SetValues(options = {})\n    {\n        const values = normalizeValues(this.GetValues(), options, CLASS_KEYS, FORMAT_NAME);\n        this.#emit = values.emit;\n        this.#source = values.source;\n        this.#decodeInstructions = values.decodeInstructions;\n        this.#permutation = values.permutation;\n        this.#schema = values.schema;\n        this.#classes = values.classes;\n        return this;\n    }\n\n    /**\n     * Get this profile's current values, optionally with per-call overrides.\n     *\n     * @param {object} [options] Optional values to merge into a copy.\n     * @returns {object} A copy of the effective values.\n     */\n    GetValues(options = {})\n    {\n        return normalizeValues({\n            emit: this.#emit,\n            source: this.#source,\n            decodeInstructions: this.#decodeInstructions,\n            permutation: this.#permutation,\n            schema: this.#schema,\n            classes: this.#classes\n        }, options, CLASS_KEYS, FORMAT_NAME);\n    }\n\n    /**\n     * Set multiple node-class constructors for this profile.\n     *\n     * @param {object} [classes] Map of node class keys to constructors.\n     * @returns {CjsWebgpuFormat} This format profile.\n     */\n    SetClasses(classes = {})\n    {\n        return this.SetValues({ classes });\n    }\n\n    /**\n     * Set one node-class constructor for this profile.\n     *\n     * @param {string} type Node class key.\n     * @param {Function|null|undefined} Class constructor to use, or nullish to delete.\n     * @returns {CjsWebgpuFormat} This format profile.\n     */\n    SetClass(type, Class)\n    {\n        validateClassKey(CLASS_KEYS, type, FORMAT_NAME);\n        if (Class === null || Class === undefined)\n        {\n            delete this.#classes[type];\n            return this;\n        }\n\n        validateClass(CLASS_KEYS, type, Class, FORMAT_NAME);\n        this.#classes = { ...this.#classes, [type]: Class };\n        return this;\n    }\n\n    /**\n     * Get a configured node-class constructor.\n     *\n     * @param {string} type Node class key.\n     * @returns {Function|undefined} The registered constructor, if any.\n     */\n    GetClass(type)\n    {\n        validateClassKey(CLASS_KEYS, type, FORMAT_NAME);\n        return this.#classes[type];\n    }\n\n    /**\n     * Whether this format profile has a constructor registered for a node key.\n     *\n     * @param {string} type Node class key.\n     * @returns {boolean} True when a constructor is registered.\n     */\n    HasClass(type)\n    {\n        return !!this.GetClass(type);\n    }\n\n    /**\n     * Read a CEWGPU package with this profile's values.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input CEWGPU package bytes.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} Plain JSON data, or the raw package instance when emit is \"raw\".\n     */\n    Read(input, options = {})\n    {\n        return readWithValues(input, this.GetValues(options));\n    }\n\n    /**\n     * Inspect a CEWGPU package without building the full JSON shape.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input CEWGPU package bytes.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} Plain summary data.\n     */\n    Inspect(input, options = {})\n    {\n        return inspectWithValues(input, this.GetValues(options));\n    }\n\n    /**\n     * Analyzes one compiled effect payload into a normalized WebGPU-facing\n     * document using the current profile's values.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Tr2 effect bytes.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} Plain JSON-compatible analysis data.\n     */\n    AnalyzeEffect(input, options = {})\n    {\n        return analyzeEffectWithValues(input, this.GetValues(options));\n    }\n\n    /**\n     * Builds a CEWGPU package with complete version-15 source reflection and\n     * selected-body WebGPU output from compiled Tr2 effect bytes.\n     *\n     * @param {Uint8Array|ArrayBuffer|ArrayBufferView} input Compiled effect bytes.\n     * @param {object} [options] Source, body-mode, permutation, and stage-selection policy.\n     * @returns {object} Package bytes plus inspection and provenance documents.\n     */\n    BuildEffect(input, options = {})\n    {\n        const values = this.GetValues();\n\n        return buildEffectPackage(input, {\n            source: values.source,\n            permutation: values.permutation,\n            ...options\n        });\n    }\n\n    /**\n     * Lowers DXBC bytes or decoded instructions into the front-end shader IR.\n     *\n     * @param {Uint8Array|ArrayBuffer|ArrayBufferView|object} input DXBC input.\n     * @param {object} [options] IR provenance options.\n     * @returns {object} Frozen shader IR program.\n     */\n    BuildShaderIr(input, options = {})\n    {\n        return lowerDxbcToIr(input, options);\n    }\n\n    /**\n     * Emits WGSL for the currently supported typed shader slice.\n     *\n     * @param {Uint8Array|ArrayBuffer|ArrayBufferView|object} input DXBC or shader IR.\n     * @param {object} [options] Source/provenance options.\n     * @returns {object} Frozen WGSL shader descriptor.\n     */\n    BuildWgsl(input, options = {})\n    {\n        return buildWgsl(input, options);\n    }\n\n    /**\n     * Assign one canonical numeric binding layout across shader stages in a pass.\n     * Unshared D3D tuples remain stage-scoped unless shared explicitly.\n     *\n     * @param {object[]} programs Complete CJS shader IR stage set for one pass.\n     * @param {object} [options] Pass-level binding policy.\n     * @param {string[]} [options.sharedIdentities] Compatible D3D identities\n     * confirmed to represent one resource across stages.\n     * @returns {object} Frozen CJS_WGSL_BINDING_PLAN document.\n     */\n    BuildWgslBindingPlan(programs, options = {})\n    {\n        return buildWgslBindingPlan(programs, options);\n    }\n\n    /**\n     * Assembles emitted shader descriptors into a portable WGSL set.\n     *\n     * @param {object[]} entries Canonically keyed emitted shader descriptors.\n     * @returns {object} Frozen CJS_WGSL_SET document.\n     */\n    BuildWgslSet(entries)\n    {\n        return buildWgslSet(entries);\n    }\n\n    /**\n     * Convert format output to JSON-compatible data.\n     *\n     * @param {any} value Format output to convert.\n     * @returns {any} Plain JSON-compatible data.\n     */\n    ToJSON(value)\n    {\n        return toJsonValue(value);\n    }\n\n    /**\n     * Static payload sniff. Static methods use camelCase by convention.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Candidate bytes.\n     * @returns {boolean} True when the payload has Carbon's version-15 shape.\n     */\n    static isCewgpu(input)\n    {\n        return isCewgpu(input);\n    }\n\n    /**\n     * Static one-shot read.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input CEWGPU package bytes.\n     * @param {object} [options] Format values.\n     * @returns {object} Plain JSON data, or the raw package instance when emit is \"raw\".\n     */\n    static read(input, options = {})\n    {\n        return readWithValues(input, normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME));\n    }\n\n    /**\n     * Static one-shot inspection.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input CEWGPU package bytes.\n     * @param {object} [options] Format values.\n     * @returns {object} Plain summary data.\n     */\n    static inspect(input, options = {})\n    {\n        return inspectWithValues(input, normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME));\n    }\n\n    /**\n     * Static one-shot effect analysis.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Tr2 effect bytes.\n     * @param {object} [options] Format values.\n     * @returns {object} Plain JSON-compatible analysis data.\n     */\n    static analyzeEffect(input, options = {})\n    {\n        return analyzeEffectWithValues(input, normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME));\n    }\n\n    /**\n     * Static selected-body CEWGPU builder.\n     *\n     * @param {Uint8Array|ArrayBuffer|ArrayBufferView} input Compiled effect bytes.\n     * @param {object} [options] Source, body-mode, permutation, and stage-selection policy.\n     * @returns {object} Package bytes plus inspection and provenance documents.\n     */\n    static buildEffect(input, options = {})\n    {\n        return buildEffectPackage(input, options);\n    }\n\n    /**\n     * Static DXBC-to-front-end-IR helper.\n     *\n     * @param {Uint8Array|ArrayBuffer|ArrayBufferView|object} input DXBC input.\n     * @param {object} [options] IR provenance options.\n     * @returns {object} Frozen shader IR program.\n     */\n    static buildShaderIr(input, options = {})\n    {\n        return lowerDxbcToIr(input, options);\n    }\n\n    /**\n     * Static WGSL emission helper for the currently supported typed slice.\n     *\n     * @param {Uint8Array|ArrayBuffer|ArrayBufferView|object} input DXBC or shader IR.\n     * @param {object} [options] Source/provenance options.\n     * @returns {object} Frozen WGSL shader descriptor.\n     */\n    static buildWgsl(input, options = {})\n    {\n        return buildWgsl(input, options);\n    }\n\n    /**\n     * Static pass-global WGSL binding-plan helper. Unshared D3D tuples remain\n     * stage-scoped unless listed in options.sharedIdentities.\n     *\n     * @param {object[]} programs Complete CJS shader IR stage set for one pass.\n     * @param {object} [options] Pass-level binding policy.\n     * @param {string[]} [options.sharedIdentities] Compatible D3D identities\n     * confirmed to represent one resource across stages.\n     * @returns {object} Frozen CJS_WGSL_BINDING_PLAN document.\n     */\n    static buildWgslBindingPlan(programs, options = {})\n    {\n        return buildWgslBindingPlan(programs, options);\n    }\n\n    /**\n     * Static WGSL-set assembly helper.\n     *\n     * @param {object[]} entries Canonically keyed emitted shader descriptors.\n     * @returns {object} Frozen CJS_WGSL_SET document.\n     */\n    static buildWgslSet(entries)\n    {\n        return buildWgslSet(entries);\n    }\n\n    /**\n     * Static JSON-compatible conversion.\n     *\n     * @param {any} value Format output to convert.\n     * @returns {any} Plain JSON-compatible data.\n     */\n    static toJSON(value)\n    {\n        return toJsonValue(value);\n    }\n\n    static OUTPUT_JSON = OUTPUT_JSON;\n    static OUTPUT_RAW = OUTPUT_RAW;\n    static CLASS_KEYS = CLASS_KEYS;\n    static type = Object.freeze([ \"shader\" ]);\n    static mediaTypes = Object.freeze([ \"shader\" ]);\n    static inputTypes = Object.freeze([ \"cewgpu\" ]);\n    static outputTypes = Object.freeze([ OUTPUT_JSON ]);\n    static debugOutputTypes = Object.freeze([ OUTPUT_RAW ]);\n    static implementationStatus = \"partial\";\n    static format = CEWGPU_FORMAT;\n    static analysisFormat = CEWGPU_ANALYSIS_FORMAT;\n    static packageVersion = FORMAT_WEBGPU_PACKAGE_VERSION;\n}\n\nexport default CjsWebgpuFormat;\n"],"names":["FORMAT_NAME","CjsWebgpuFormat","DEFAULT_VALUES","emit","source","decodeInstructions","permutation","schema","constructor","options","SetValues","values","normalizeValues","GetValues","CLASS_KEYS","classes","SetClasses","SetClass","type","Class","validateClassKey","undefined","validateClass","GetClass","HasClass","Read","input","readWithValues","Inspect","inspectWithValues","AnalyzeEffect","analyzeEffectWithValues","BuildEffect","buildEffectPackage","BuildShaderIr","lowerDxbcToIr","BuildWgsl","buildWgsl","BuildWgslBindingPlan","programs","buildWgslBindingPlan","BuildWgslSet","entries","buildWgslSet","ToJSON","value","toJsonValue","isCewgpu","read","inspect","analyzeEffect","buildEffect","buildShaderIr","toJSON","OUTPUT_JSON","OUTPUT_RAW","Object","freeze","mediaTypes","inputTypes","outputTypes","debugOutputTypes","implementationStatus","format","CEWGPU_FORMAT","analysisFormat","CEWGPU_ANALYSIS_FORMAT","packageVersion","FORMAT_WEBGPU_PACKAGE_VERSION"],"mappings":"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"}
+{"version":3,"file":"CjsWebgpuFormat.js","sources":["../../../../src/formats/webgpu/CjsWebgpuFormat.js"],"sourcesContent":["import { CLASS_KEYS } from \"./core/schema.js\";\nimport { lowerDxbcToIr } from \"./core/ir/lowerDxbcToIr.js\";\nimport { buildWgsl } from \"./core/wgsl/emitWgsl.js\";\nimport { buildWgslBindingPlan } from \"./core/wgsl/buildWgslBindingPlan.js\";\nimport { buildWgslSet } from \"./core/wgsl/buildWgslSet.js\";\nimport { buildEffectPackage } from \"./core/packageEffect.js\";\nimport { FORMAT_WEBGPU_PACKAGE_VERSION } from \"./core/packageMetadata.js\";\nimport {\n    CARBON_WEBGPU_ANALYSIS_FORMAT,\n    CARBON_WEBGPU_FORMAT,\n    DEFAULT_VALUES,\n    OUTPUT_JSON,\n    OUTPUT_RAW,\n    analyzeEffectWithValues,\n    inspectWithValues,\n    isCarbonWebgpu,\n    normalizeValues,\n    readWithValues,\n    toJsonValue,\n    validateClass,\n    validateClassKey\n} from \"./core/helpers.js\";\n\nconst FORMAT_NAME = \"CjsWebgpuFormat\";\n\n/**\n * CarbonEngineJS-facing format surface for `.carbonwebgpu` WebGPU packages, plus an\n * offline effect-analysis helper built on the runtime-resource HLSL and DXBC\n * format subpaths.\n *\n * The package owns read/build, normalized shader analysis, and the current\n * bounded DXBC-to-WGSL profiles. Broader shader-semantic coverage remains an\n * explicit qualification ladder.\n */\nexport class CjsWebgpuFormat\n{\n    #emit = DEFAULT_VALUES.emit;\n    #source = DEFAULT_VALUES.source;\n    #decodeInstructions = DEFAULT_VALUES.decodeInstructions;\n    #permutation = DEFAULT_VALUES.permutation;\n    #schema = DEFAULT_VALUES.schema;\n    #classes = {};\n\n    /**\n     * Create a reusable format profile.\n     *\n     * @param {object} [options] Default format values.\n     */\n    constructor(options = {})\n    {\n        this.SetValues(options);\n    }\n\n    /**\n     * Set format values for this reusable profile.\n     *\n     * @param {object} [options] Values to merge into the profile.\n     * @returns {CjsWebgpuFormat} This format profile.\n     */\n    SetValues(options = {})\n    {\n        const values = normalizeValues(this.GetValues(), options, CLASS_KEYS, FORMAT_NAME);\n        this.#emit = values.emit;\n        this.#source = values.source;\n        this.#decodeInstructions = values.decodeInstructions;\n        this.#permutation = values.permutation;\n        this.#schema = values.schema;\n        this.#classes = values.classes;\n        return this;\n    }\n\n    /**\n     * Get this profile's current values, optionally with per-call overrides.\n     *\n     * @param {object} [options] Optional values to merge into a copy.\n     * @returns {object} A copy of the effective values.\n     */\n    GetValues(options = {})\n    {\n        return normalizeValues({\n            emit: this.#emit,\n            source: this.#source,\n            decodeInstructions: this.#decodeInstructions,\n            permutation: this.#permutation,\n            schema: this.#schema,\n            classes: this.#classes\n        }, options, CLASS_KEYS, FORMAT_NAME);\n    }\n\n    /**\n     * Set multiple node-class constructors for this profile.\n     *\n     * @param {object} [classes] Map of node class keys to constructors.\n     * @returns {CjsWebgpuFormat} This format profile.\n     */\n    SetClasses(classes = {})\n    {\n        return this.SetValues({ classes });\n    }\n\n    /**\n     * Set one node-class constructor for this profile.\n     *\n     * @param {string} type Node class key.\n     * @param {Function|null|undefined} Class constructor to use, or nullish to delete.\n     * @returns {CjsWebgpuFormat} This format profile.\n     */\n    SetClass(type, Class)\n    {\n        validateClassKey(CLASS_KEYS, type, FORMAT_NAME);\n        if (Class === null || Class === undefined)\n        {\n            delete this.#classes[type];\n            return this;\n        }\n\n        validateClass(CLASS_KEYS, type, Class, FORMAT_NAME);\n        this.#classes = { ...this.#classes, [type]: Class };\n        return this;\n    }\n\n    /**\n     * Get a configured node-class constructor.\n     *\n     * @param {string} type Node class key.\n     * @returns {Function|undefined} The registered constructor, if any.\n     */\n    GetClass(type)\n    {\n        validateClassKey(CLASS_KEYS, type, FORMAT_NAME);\n        return this.#classes[type];\n    }\n\n    /**\n     * Whether this format profile has a constructor registered for a node key.\n     *\n     * @param {string} type Node class key.\n     * @returns {boolean} True when a constructor is registered.\n     */\n    HasClass(type)\n    {\n        return !!this.GetClass(type);\n    }\n\n    /**\n     * Read a Carbon WebGPU package with this profile's values.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Carbon WebGPU package bytes.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} Plain JSON data, or the raw package instance when emit is \"raw\".\n     */\n    Read(input, options = {})\n    {\n        return readWithValues(input, this.GetValues(options));\n    }\n\n    /**\n     * Inspect a Carbon WebGPU package without building the full JSON shape.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Carbon WebGPU package bytes.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} Plain summary data.\n     */\n    Inspect(input, options = {})\n    {\n        return inspectWithValues(input, this.GetValues(options));\n    }\n\n    /**\n     * Analyzes one compiled effect payload into a normalized WebGPU-facing\n     * document using the current profile's values.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Tr2 effect bytes.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} Plain JSON-compatible analysis data.\n     */\n    AnalyzeEffect(input, options = {})\n    {\n        return analyzeEffectWithValues(input, this.GetValues(options));\n    }\n\n    /**\n     * Builds a Carbon WebGPU package with complete version-15 source reflection and\n     * selected-body WebGPU output from compiled Tr2 effect bytes.\n     *\n     * @param {Uint8Array|ArrayBuffer|ArrayBufferView} input Compiled effect bytes.\n     * @param {object} [options] Source, body-mode, permutation, and stage-selection policy.\n     * @returns {object} Package bytes plus inspection and provenance documents.\n     */\n    BuildEffect(input, options = {})\n    {\n        const values = this.GetValues();\n\n        return buildEffectPackage(input, {\n            source: values.source,\n            permutation: values.permutation,\n            ...options\n        });\n    }\n\n    /**\n     * Lowers DXBC bytes or decoded instructions into the front-end shader IR.\n     *\n     * @param {Uint8Array|ArrayBuffer|ArrayBufferView|object} input DXBC input.\n     * @param {object} [options] IR provenance options.\n     * @returns {object} Frozen shader IR program.\n     */\n    BuildShaderIr(input, options = {})\n    {\n        return lowerDxbcToIr(input, options);\n    }\n\n    /**\n     * Emits WGSL for the currently supported typed shader slice.\n     *\n     * @param {Uint8Array|ArrayBuffer|ArrayBufferView|object} input DXBC or shader IR.\n     * @param {object} [options] Source/provenance options.\n     * @returns {object} Frozen WGSL shader descriptor.\n     */\n    BuildWgsl(input, options = {})\n    {\n        return buildWgsl(input, options);\n    }\n\n    /**\n     * Assign one canonical numeric binding layout across shader stages in a pass.\n     * Unshared D3D tuples remain stage-scoped unless shared explicitly.\n     *\n     * @param {object[]} programs Complete CJS shader IR stage set for one pass.\n     * @param {object} [options] Pass-level binding policy.\n     * @param {string[]} [options.sharedIdentities] Compatible D3D identities\n     * confirmed to represent one resource across stages.\n     * @returns {object} Frozen CJS_WGSL_BINDING_PLAN document.\n     */\n    BuildWgslBindingPlan(programs, options = {})\n    {\n        return buildWgslBindingPlan(programs, options);\n    }\n\n    /**\n     * Assembles emitted shader descriptors into a portable WGSL set.\n     *\n     * @param {object[]} entries Canonically keyed emitted shader descriptors.\n     * @returns {object} Frozen CJS_WGSL_SET document.\n     */\n    BuildWgslSet(entries)\n    {\n        return buildWgslSet(entries);\n    }\n\n    /**\n     * Convert format output to JSON-compatible data.\n     *\n     * @param {any} value Format output to convert.\n     * @returns {any} Plain JSON-compatible data.\n     */\n    ToJSON(value)\n    {\n        return toJsonValue(value);\n    }\n\n    /**\n     * Static payload sniff. Static methods use camelCase by convention.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Candidate bytes.\n     * @returns {boolean} True when the payload has Carbon's version-15 shape.\n     */\n    static isCarbonWebgpu(input)\n    {\n        return isCarbonWebgpu(input);\n    }\n\n    /**\n     * Static one-shot read.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Carbon WebGPU package bytes.\n     * @param {object} [options] Format values.\n     * @returns {object} Plain JSON data, or the raw package instance when emit is \"raw\".\n     */\n    static read(input, options = {})\n    {\n        return readWithValues(input, normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME));\n    }\n\n    /**\n     * Static one-shot inspection.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Carbon WebGPU package bytes.\n     * @param {object} [options] Format values.\n     * @returns {object} Plain summary data.\n     */\n    static inspect(input, options = {})\n    {\n        return inspectWithValues(input, normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME));\n    }\n\n    /**\n     * Static one-shot effect analysis.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Tr2 effect bytes.\n     * @param {object} [options] Format values.\n     * @returns {object} Plain JSON-compatible analysis data.\n     */\n    static analyzeEffect(input, options = {})\n    {\n        return analyzeEffectWithValues(input, normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME));\n    }\n\n    /**\n     * Static selected-body Carbon WebGPU builder.\n     *\n     * @param {Uint8Array|ArrayBuffer|ArrayBufferView} input Compiled effect bytes.\n     * @param {object} [options] Source, body-mode, permutation, and stage-selection policy.\n     * @returns {object} Package bytes plus inspection and provenance documents.\n     */\n    static buildEffect(input, options = {})\n    {\n        return buildEffectPackage(input, options);\n    }\n\n    /**\n     * Static DXBC-to-front-end-IR helper.\n     *\n     * @param {Uint8Array|ArrayBuffer|ArrayBufferView|object} input DXBC input.\n     * @param {object} [options] IR provenance options.\n     * @returns {object} Frozen shader IR program.\n     */\n    static buildShaderIr(input, options = {})\n    {\n        return lowerDxbcToIr(input, options);\n    }\n\n    /**\n     * Static WGSL emission helper for the currently supported typed slice.\n     *\n     * @param {Uint8Array|ArrayBuffer|ArrayBufferView|object} input DXBC or shader IR.\n     * @param {object} [options] Source/provenance options.\n     * @returns {object} Frozen WGSL shader descriptor.\n     */\n    static buildWgsl(input, options = {})\n    {\n        return buildWgsl(input, options);\n    }\n\n    /**\n     * Static pass-global WGSL binding-plan helper. Unshared D3D tuples remain\n     * stage-scoped unless listed in options.sharedIdentities.\n     *\n     * @param {object[]} programs Complete CJS shader IR stage set for one pass.\n     * @param {object} [options] Pass-level binding policy.\n     * @param {string[]} [options.sharedIdentities] Compatible D3D identities\n     * confirmed to represent one resource across stages.\n     * @returns {object} Frozen CJS_WGSL_BINDING_PLAN document.\n     */\n    static buildWgslBindingPlan(programs, options = {})\n    {\n        return buildWgslBindingPlan(programs, options);\n    }\n\n    /**\n     * Static WGSL-set assembly helper.\n     *\n     * @param {object[]} entries Canonically keyed emitted shader descriptors.\n     * @returns {object} Frozen CJS_WGSL_SET document.\n     */\n    static buildWgslSet(entries)\n    {\n        return buildWgslSet(entries);\n    }\n\n    /**\n     * Static JSON-compatible conversion.\n     *\n     * @param {any} value Format output to convert.\n     * @returns {any} Plain JSON-compatible data.\n     */\n    static toJSON(value)\n    {\n        return toJsonValue(value);\n    }\n\n    static OUTPUT_JSON = OUTPUT_JSON;\n    static OUTPUT_RAW = OUTPUT_RAW;\n    static CLASS_KEYS = CLASS_KEYS;\n    static type = Object.freeze([ \"shader\" ]);\n    static mediaTypes = Object.freeze([ \"shader\" ]);\n    static inputTypes = Object.freeze([ \"carbonwebgpu\" ]);\n    static outputTypes = Object.freeze([ OUTPUT_JSON ]);\n    static debugOutputTypes = Object.freeze([ OUTPUT_RAW ]);\n    static implementationStatus = \"partial\";\n    static format = CARBON_WEBGPU_FORMAT;\n    static analysisFormat = CARBON_WEBGPU_ANALYSIS_FORMAT;\n    static packageVersion = FORMAT_WEBGPU_PACKAGE_VERSION;\n}\n\nexport default CjsWebgpuFormat;\n"],"names":["FORMAT_NAME","CjsWebgpuFormat","DEFAULT_VALUES","emit","source","decodeInstructions","permutation","schema","constructor","options","SetValues","values","normalizeValues","GetValues","CLASS_KEYS","classes","SetClasses","SetClass","type","Class","validateClassKey","undefined","validateClass","GetClass","HasClass","Read","input","readWithValues","Inspect","inspectWithValues","AnalyzeEffect","analyzeEffectWithValues","BuildEffect","buildEffectPackage","BuildShaderIr","lowerDxbcToIr","BuildWgsl","buildWgsl","BuildWgslBindingPlan","programs","buildWgslBindingPlan","BuildWgslSet","entries","buildWgslSet","ToJSON","value","toJsonValue","isCarbonWebgpu","read","inspect","analyzeEffect","buildEffect","buildShaderIr","toJSON","OUTPUT_JSON","OUTPUT_RAW","Object","freeze","mediaTypes","inputTypes","outputTypes","debugOutputTypes","implementationStatus","format","CARBON_WEBGPU_FORMAT","analysisFormat","CARBON_WEBGPU_ANALYSIS_FORMAT","packageVersion","FORMAT_WEBGPU_PACKAGE_VERSION"],"mappings":"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"}