@carbonenginejs/runtime-resource 0.12.0 → 0.12.2

package/dist/formats/webgpu/CjsWebgpuFormat.js

@@ -5,13 +5,14 @@ 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, buildPackage, 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, isCewgpu, OUTPUT_JSON, OUTPUT_RAW, CEWGPU_FORMAT, CEWGPU_ANALYSIS_FORMAT } from './core/helpers.js';
 
 const FORMAT_NAME = "CjsWebgpuFormat";
 
 /**
  * CarbonEngineJS-facing format surface for `.cewgpu` WebGPU packages, plus an
- * offline effect-analysis helper built on `format-hlsl` and `format-dxbc`.
+ * offline effect-analysis helper built on the runtime-resource HLSL and DXBC
+ * format subpaths.
  *
  * The package owns read/build, normalized shader analysis, and the current
  * bounded DXBC-to-WGSL profiles. Broader shader-semantic coverage remains an
@@ -144,16 +145,6 @@ class CjsWebgpuFormat {
     return inspectWithValues(input, this.GetValues(options));
   }
 
-  /**
-   * Assembles a CEWGPU package from ordered chunk payloads.
-   *
-   * @param {Array<[string, string|object|Uint8Array|ArrayBuffer|ArrayBufferView]>} chunks Ordered package chunks.
-   * @returns {Uint8Array} Package bytes.
-   */
-  Build(chunks) {
-    return buildPackage(chunks);
-  }
-
   /**
    * Analyzes one compiled effect payload into a normalized WebGPU-facing
    * document using the current profile's values.
@@ -243,7 +234,7 @@ class CjsWebgpuFormat {
    * Static payload sniff. Static methods use camelCase by convention.
    *
    * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Candidate bytes.
-   * @returns {boolean} True when the payload starts with the CEWGPU magic.
+   * @returns {boolean} True when the payload has Carbon's version-15 shape.
    */
   static isCewgpu(input) {
     return isCewgpu(input);
@@ -271,16 +262,6 @@ class CjsWebgpuFormat {
     return inspectWithValues(input, normalizeValues(DEFAULT_VALUES, options, CLASS_KEYS, FORMAT_NAME));
   }
 
-  /**
-   * Static one-shot package build.
-   *
-   * @param {Array<[string, string|object|Uint8Array|ArrayBuffer|ArrayBufferView]>} chunks Ordered package chunks.
-   * @returns {Uint8Array} Package bytes.
-   */
-  static build(chunks) {
-    return buildPackage(chunks);
-  }
-
   /**
    * Static one-shot effect analysis.
    *

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    buildPackage,\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 `format-hlsl` and `format-dxbc`.\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     * Assembles a CEWGPU package from ordered chunk payloads.\n     *\n     * @param {Array<[string, string|object|Uint8Array|ArrayBuffer|ArrayBufferView]>} chunks Ordered package chunks.\n     * @returns {Uint8Array} Package bytes.\n     */\n    Build(chunks)\n    {\n        return buildPackage(chunks);\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 starts with the CEWGPU magic.\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 package build.\n     *\n     * @param {Array<[string, string|object|Uint8Array|ArrayBuffer|ArrayBufferView]>} chunks Ordered package chunks.\n     * @returns {Uint8Array} Package bytes.\n     */\n    static build(chunks)\n    {\n        return buildPackage(chunks);\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","Build","chunks","buildPackage","AnalyzeEffect","analyzeEffectWithValues","BuildEffect","buildEffectPackage","BuildShaderIr","lowerDxbcToIr","BuildWgsl","buildWgsl","BuildWgslBindingPlan","programs","buildWgslBindingPlan","BuildWgslSet","entries","buildWgslSet","ToJSON","value","toJsonValue","isCewgpu","read","inspect","build","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    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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"}

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

@@ -0,0 +1,197 @@
+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';
+
+/**
+ * Assembles the WebGPU effect container: Carbon's v15 record layout carrying
+ * WGSL where a shipped file carries DXBC.
+ *
+ * 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?
+ *
+ * - `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 entry-point name every WGSL lowerer emits.
+ *
+ * Carbon's `StageInput` has no entry-point field, so the container can only omit
+ * one if it is a constant of our emitter rather than data. It is: all thirteen
+ * `lower*Program` modules write `entryPoint: "main"` literally. Measured constant
+ * across 626 shaders in seven effects — but measurement only shows it holds
+ * today, so the substitution asserts it. A future lowerer that picks a different
+ * name fails the build instead of silently emitting a container whose programs
+ * cannot be found.
+ */
+const WGSL_ENTRY_POINT = "main";
+
+/**
+ * Builds the per-pass backend block for one pass of one translated body.
+ *
+ * @param {object} unit Pass translation unit.
+ * @param {string} passKey Enclosing pass key.
+ * @returns {Uint8Array|null} Block bytes, or null when the pass has no layout.
+ */
+function backendBlockFor(unit, passKey) {
+  const layout = unit.layouts.find(entry => entry.key === passKey);
+  if (!layout) return null;
+  return writeBackendBlock({
+    bindGroups: layout.bindGroups,
+    transforms: (unit.resourceTransforms ?? []).filter(transform => transform.layoutKey === 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;
+    }
+  });
+}
+
+/**
+ * Builds the complete WebGPU effect container.
+ *
+ * @param {object} effectRes Loaded version-15 `Tr2EffectRes`.
+ * @param {object} permutationGraph Validated `PGRF` document.
+ * @param {object} backendBodySet Translated backend bodies.
+ * @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.
+ */
+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
+  };
+}
+
+export { WGSL_ENTRY_POINT, buildCarbonEffectContainer };
+//# sourceMappingURL=buildCarbonEffectContainer.js.map

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

@@ -0,0 +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":"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"}