@carbonenginejs/runtime-resource 0.12.2 → 0.13.0

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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"}

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

@@ -1,197 +1,89 @@
-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
+import '../../../format/compareUtf8.js';
+import { writeBackendBlock } from '../../../format/carbonEffect/carbonEffectBackendBlock.js';
+import '../../../format/CjsByteReader.js';
+import '../../../format/carbonEffect/CjsCarbonEffectWriter.js';
+import { buildCarbonEffectContainer as buildCarbonEffectContainer$1 } from '../../../format/carbonEffect/buildCarbonEffectContainer.js';
+
+/**
+ * The WebGPU backend adapter for the shared Carbon container builder.
+ *
+ * Everything about the record layout, the permutation walk and the description
+ * mapping lives in `format/carbonEffect/buildCarbonEffectContainer.js` and is
+ * shared with WebGL. What remains here is the two things that are genuinely
+ * WGSL: how a program becomes bytes, and what a pass's trailing block contains.
+ *
+ * The block carries bind-group layouts and resource transforms. Neither is
+ * derivable from Carbon reflection - Carbon records the D3D binding model, while
+ * `(group, binding, visibility, generatedSymbol)` comes from the lowered IR.
+ */
+
+/**
+ * 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";
+
+/**
+ * Encodes one WGSL stage program.
+ *
+ * `sourceMap` is deliberately dropped. Its offsets index DXBC bytes, which this
+ * container does not carry, so it is a translator diagnostic rather than
+ * payload. It was separately measured to suppress no sharing, so keeping it
+ * would buy nothing either.
+ *
+ * @param {object} shader Translated shader record.
+ * @returns {Uint8Array} Program bytes.
+ */
+function encodeProgram(shader) {
+  if (shader.entryPoint !== WGSL_ENTRY_POINT) {
+    throw new Error(`WGSL shader ${shader.key} has entry point "${shader.entryPoint}"; ` + `the container omits the name because every lowerer emits "${WGSL_ENTRY_POINT}"`);
+  }
+  return new TextEncoder().encode(shader.code);
+}
+
+/**
+ * Builds the per-pass backend block for one pass of one translated body.
+ *
+ * @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 encodeBackendBlock(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)
+  });
+}
+
+/** The WebGPU encoders, as the shared builder's backend argument. */
+const WGSL_CONTAINER_BACKEND = Object.freeze({
+  encodeProgram,
+  encodeBackendBlock
+});
+
+/**
+ * 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, permutationCount:number, bodyCount:number}} Container and its body accounting.
+ */
+function buildCarbonEffectContainer(effectRes, permutationGraph, backendBodySet, options = {}) {
+  return buildCarbonEffectContainer$1(effectRes, permutationGraph, backendBodySet, WGSL_CONTAINER_BACKEND, options);
+}
+
+export { WGSL_CONTAINER_BACKEND, WGSL_ENTRY_POINT, buildCarbonEffectContainer };
+//# sourceMappingURL=buildCarbonEffectContainer.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"buildCarbonEffectContainer.js","sources":["../../../../../src/formats/webgpu/core/buildCarbonEffectContainer.js"],"sourcesContent":["import {\n    CjsCarbonEffectWriter,\n    carbonDescriptionFromPortable,\n    writeBackendBlock\n} from \"../../../format/carbonEffect/index.js\";\nimport { buildEffectBodyReflection } from \"../../hlsl/core/portableReflection.js\";\n\n/**\n * Assembles the WebGPU effect container: Carbon's v15 record layout carrying\n * WGSL where a shipped file carries DXBC.\n *\n * The Carbon record layout is shared across backends. CEWGPU replaces stage\n * program bytes with WGSL or an empty slot and adds one optional trailing block\n * per pass. The portable-to-Carbon mapping retains representable non-program\n * fields; non-dynamic sampler names are unrecoverable and stage order is\n * canonicalized.\n */\n\n/**\n * There is no envelope, no magic and no version of our own. That is deliberate.\n *\n * A twelve-byte prefix (`magic | containerVersion | payloadKind`) was carried\n * here and has been removed, along with a proposed \"v16\" for this variant.\n * Neither survived the only question worth asking of an addition: what breaks\n * without it?\n *\n * - `payloadKind` is redundant with the directory the file came from. CEWGPU\n *   identity belongs to the `effect.webgpu/` resource path; `.cewg` remains a\n *   separate CEWG chunk format.\n * - The magic only distinguished our file from a Carbon one, which the same\n *   directory already answers, and which the file *name* answers too.\n * - A version of our own would have claimed a number CCP owns, in the one field\n *   whose job is telling a reader how to parse. A real v16 from them would then\n *   collide with ours.\n *\n * What remains is a bare Carbon v15 record file. `CewgpuContainer` reads it and\n * the shared record reader detects the per-pass block from the description's\n * declared end. Direct `Tr2EffectRes` hydration remains an adapter boundary:\n * a Carbon description tree is not the portable reflection envelope consumed\n * by `Tr2Shader.fromPortable`.\n *\n * The one addition that does survive the question is the block itself: WebGPU\n * bind-group layouts come from the lowered IR and are not derivable from Carbon\n * reflection, so without it there is no binding topology and no pipeline.\n */\n\n/**\n * The entry-point name every WGSL lowerer emits.\n *\n * Carbon's `StageInput` has no entry-point field, so the container can only omit\n * one if it is a constant of our emitter rather than data. It is: all thirteen\n * `lower*Program` modules write `entryPoint: \"main\"` literally. Measured constant\n * across 626 shaders in seven effects — but measurement only shows it holds\n * today, so the substitution asserts it. A future lowerer that picks a different\n * name fails the build instead of silently emitting a container whose programs\n * cannot be found.\n */\nexport const WGSL_ENTRY_POINT = \"main\";\n\n/**\n * Builds the per-pass backend block for one pass of one translated body.\n *\n * @param {object} unit Pass translation unit.\n * @param {string} passKey Enclosing pass key.\n * @returns {Uint8Array|null} Block bytes, or null when the pass has no layout.\n */\nfunction backendBlockFor(unit, passKey)\n{\n    const layout = unit.layouts.find((entry) => entry.key === passKey);\n    if (!layout) return null;\n\n    return writeBackendBlock({\n        bindGroups: layout.bindGroups,\n        transforms: (unit.resourceTransforms ?? [])\n            .filter((transform) => transform.layoutKey === passKey)\n    });\n}\n\n/**\n * Maps one body's translated passes by pass key.\n *\n * @param {object} body Backend body-set record.\n * @param {Map<string, object>} unitsByKey Units indexed by key.\n * @returns {Map<string, object>} Units indexed by pass key.\n */\nfunction unitsByPassKey(body, unitsByKey)\n{\n    const result = new Map();\n    for (const pass of body.passes ?? [])\n    {\n        result.set(pass.passKey, unitsByKey.get(pass.unitKey));\n    }\n    return result;\n}\n\n/**\n * Builds one body's Carbon description record tree with WGSL substituted in.\n *\n * A body the translator could not lower retains its representable non-program\n * description fields and carries zero-length programs. Emitting empty\n * `shaderData` says exactly what the wire knows: no backend program was stored.\n * Full portable source reflection remains in the in-memory build result, not\n * in this emitted body.\n *\n * @param {object} effectRes Loaded version-15 `Tr2EffectRes`.\n * @param {number} permutationIndex Representative permutation for this body.\n * @param {Map<string, object>|null} passUnits Units by pass key, or null when unsupported.\n * @returns {object} Description record tree.\n */\nfunction describeBody(effectRes, permutationIndex, passUnits)\n{\n    const reflection = buildEffectBodyReflection(effectRes, permutationIndex);\n\n    if (!passUnits)\n    {\n        return carbonDescriptionFromPortable(reflection, {\n            programFor: () => ({ bytes: new Uint8Array(0), size: 0 })\n        });\n    }\n\n    return carbonDescriptionFromPortable(reflection, {\n        programFor: (stage, context) =>\n        {\n            const unit = passUnits.get(context.passKey);\n            const shader = unit?.shaders.find(\n                (entry) => entry.key === `${context.passKey}.${stage.stageName}`\n            );\n\n            if (!shader) return { bytes: new Uint8Array(0), size: 0 };\n\n            if (shader.entryPoint !== WGSL_ENTRY_POINT)\n            {\n                throw new Error(\n                    `WGSL shader ${shader.key} has entry point \"${shader.entryPoint}\"; `\n                    + `the container omits the name because every lowerer emits \"${WGSL_ENTRY_POINT}\"`\n                );\n            }\n\n            // `sourceMap` is deliberately dropped. Its offsets index DXBC bytes,\n            // which this container does not carry, so it is a translator\n            // diagnostic rather than payload. It was separately measured to\n            // suppress no sharing, so keeping it would buy nothing either.\n            const bytes = new TextEncoder().encode(shader.code);\n            return { bytes, size: bytes.byteLength };\n        },\n        backendBlockFor: (context) =>\n        {\n            const unit = passUnits.get(context.passKey);\n            return unit ? backendBlockFor(unit, context.passKey) : null;\n        }\n    });\n}\n\n/**\n * Builds the complete WebGPU effect container.\n *\n * @param {object} effectRes Loaded version-15 `Tr2EffectRes`.\n * @param {object} permutationGraph Validated `PGRF` document.\n * @param {object} backendBodySet Translated backend bodies.\n * @param {object} [options] Container options.\n * @param {number[]|Uint8Array} [options.compilerVersion] Four version bytes.\n * @param {string} [options.sourceHash] 32 ASCII hash characters.\n * @returns {{bytes:Uint8Array, bodyCount:number, distinctBodyCount:number}} Container and its body accounting.\n */\nexport function buildCarbonEffectContainer(\n    effectRes,\n    permutationGraph,\n    backendBodySet,\n    options = {}\n)\n{\n    const unitsByKey = new Map(backendBodySet.passUnits.map((unit) => [ unit.key, unit ]));\n    const bodyByKey = new Map(backendBodySet.bodies.map((body) => [ body.bodyKey, body ]));\n    const writer = new CjsCarbonEffectWriter({\n        backend: true,\n        compilerVersion: options.compilerVersion ?? effectRes.m_compilerVersionBytes ?? [ 0, 0, 0, 0 ],\n        ...(options.sourceHash ? { sourceHash: options.sourceHash } : {})\n    });\n\n    for (const axis of permutationGraph.axes)\n    {\n        writer.addPermutation({\n            name: axis.name,\n            defaultOption: axis.defaultOption,\n            description: axis.description,\n            type: axis.type,\n            options: axis.options\n        });\n    }\n\n    // Build one emitted description per source body key and reuse it for each\n    // matching permutation. The writer may dedupe additional descriptions when\n    // their emitted bytes become identical after source programs are replaced;\n    // the offset table remains dense.\n    const describedByBodyKey = new Map();\n\n    for (const [ permutationIndex, variant ] of permutationGraph.variants.entries())\n    {\n        let description = describedByBodyKey.get(variant.bodyKey);\n\n        if (!description)\n        {\n            const body = bodyByKey.get(variant.bodyKey);\n            description = describeBody(\n                effectRes,\n                body?.representativePermutationIndex ?? permutationIndex,\n                body?.status === \"translated\" ? unitsByPassKey(body, unitsByKey) : null\n            );\n            describedByBodyKey.set(variant.bodyKey, description);\n        }\n\n        writer.addBody(permutationIndex, description);\n    }\n\n    return {\n        bytes: writer.toBytes(),\n        permutationCount: permutationGraph.variants.length,\n        bodyCount: describedByBodyKey.size\n    };\n}\n\nexport default buildCarbonEffectContainer;\n"],"names":["WGSL_ENTRY_POINT","backendBlockFor","unit","passKey","layout","layouts","find","entry","key","writeBackendBlock","bindGroups","transforms","resourceTransforms","filter","transform","layoutKey","unitsByPassKey","body","unitsByKey","result","Map","pass","passes","set","get","unitKey","describeBody","effectRes","permutationIndex","passUnits","reflection","buildEffectBodyReflection","carbonDescriptionFromPortable","programFor","bytes","Uint8Array","size","stage","context","shader","shaders","stageName","entryPoint","Error","TextEncoder","encode","code","byteLength","buildCarbonEffectContainer","permutationGraph","backendBodySet","options","map","bodyByKey","bodies","bodyKey","writer","CjsCarbonEffectWriter","backend","compilerVersion","m_compilerVersionBytes","sourceHash","axis","axes","addPermutation","name","defaultOption","description","type","describedByBodyKey","variant","variants","entries","representativePermutationIndex","status","addBody","toBytes","permutationCount","length","bodyCount"],"mappings":"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"}
+{"version":3,"file":"buildCarbonEffectContainer.js","sources":["../../../../../src/formats/webgpu/core/buildCarbonEffectContainer.js"],"sourcesContent":["import { writeBackendBlock } from \"../../../format/carbonEffect/index.js\";\nimport {\n    buildCarbonEffectContainer as buildContainer\n} from \"../../../format/carbonEffect/buildCarbonEffectContainer.js\";\n\n/**\n * The WebGPU backend adapter for the shared Carbon container builder.\n *\n * Everything about the record layout, the permutation walk and the description\n * mapping lives in `format/carbonEffect/buildCarbonEffectContainer.js` and is\n * shared with WebGL. What remains here is the two things that are genuinely\n * WGSL: how a program becomes bytes, and what a pass's trailing block contains.\n *\n * The block carries bind-group layouts and resource transforms. Neither is\n * derivable from Carbon reflection - Carbon records the D3D binding model, while\n * `(group, binding, visibility, generatedSymbol)` comes from the lowered IR.\n */\n\n/**\n * The entry-point name every WGSL lowerer emits.\n *\n * Carbon's `StageInput` has no entry-point field, so the container can only omit\n * one if it is a constant of our emitter rather than data. It is: all thirteen\n * `lower*Program` modules write `entryPoint: \"main\"` literally. Measured constant\n * across 626 shaders in seven effects — but measurement only shows it holds\n * today, so the substitution asserts it. A future lowerer that picks a different\n * name fails the build instead of silently emitting a container whose programs\n * cannot be found.\n */\nexport const WGSL_ENTRY_POINT = \"main\";\n\n/**\n * Encodes one WGSL stage program.\n *\n * `sourceMap` is deliberately dropped. Its offsets index DXBC bytes, which this\n * container does not carry, so it is a translator diagnostic rather than\n * payload. It was separately measured to suppress no sharing, so keeping it\n * would buy nothing either.\n *\n * @param {object} shader Translated shader record.\n * @returns {Uint8Array} Program bytes.\n */\nfunction encodeProgram(shader)\n{\n    if (shader.entryPoint !== WGSL_ENTRY_POINT)\n    {\n        throw new Error(\n            `WGSL shader ${shader.key} has entry point \"${shader.entryPoint}\"; `\n            + `the container omits the name because every lowerer emits \"${WGSL_ENTRY_POINT}\"`\n        );\n    }\n\n    return new TextEncoder().encode(shader.code);\n}\n\n/**\n * Builds the per-pass backend block for one pass of one translated body.\n *\n * @param {object} unit Pass translation unit.\n * @param {string} passKey Enclosing pass key.\n * @returns {Uint8Array|null} Block bytes, or null when the pass has no layout.\n */\nfunction encodeBackendBlock(unit, passKey)\n{\n    const layout = unit.layouts.find((entry) => entry.key === passKey);\n    if (!layout) return null;\n\n    return writeBackendBlock({\n        bindGroups: layout.bindGroups,\n        transforms: (unit.resourceTransforms ?? [])\n            .filter((transform) => transform.layoutKey === passKey)\n    });\n}\n\n/** The WebGPU encoders, as the shared builder's backend argument. */\nexport const WGSL_CONTAINER_BACKEND = Object.freeze({ encodeProgram, encodeBackendBlock });\n\n/**\n * Builds the complete WebGPU effect container.\n *\n * @param {object} effectRes Loaded version-15 `Tr2EffectRes`.\n * @param {object} permutationGraph Validated `PGRF` document.\n * @param {object} backendBodySet Translated backend bodies.\n * @param {object} [options] Container options.\n * @param {number[]|Uint8Array} [options.compilerVersion] Four version bytes.\n * @param {string} [options.sourceHash] 32 ASCII hash characters.\n * @returns {{bytes:Uint8Array, permutationCount:number, bodyCount:number}} Container and its body accounting.\n */\nexport function buildCarbonEffectContainer(\n    effectRes,\n    permutationGraph,\n    backendBodySet,\n    options = {}\n)\n{\n    return buildContainer(\n        effectRes,\n        permutationGraph,\n        backendBodySet,\n        WGSL_CONTAINER_BACKEND,\n        options\n    );\n}\n\nexport default buildCarbonEffectContainer;\n"],"names":["WGSL_ENTRY_POINT","encodeProgram","shader","entryPoint","Error","key","TextEncoder","encode","code","encodeBackendBlock","unit","passKey","layout","layouts","find","entry","writeBackendBlock","bindGroups","transforms","resourceTransforms","filter","transform","layoutKey","WGSL_CONTAINER_BACKEND","Object","freeze","buildCarbonEffectContainer","effectRes","permutationGraph","backendBodySet","options","buildContainer"],"mappings":";;;;;;AAKA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMA,gBAAgB,GAAG;;AAEhC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,aAAaA,CAACC,MAAM,EAC7B;AACI,EAAA,IAAIA,MAAM,CAACC,UAAU,KAAKH,gBAAgB,EAC1C;AACI,IAAA,MAAM,IAAII,KAAK,CACX,CAAA,YAAA,EAAeF,MAAM,CAACG,GAAG,CAAA,kBAAA,EAAqBH,MAAM,CAACC,UAAU,CAAA,GAAA,CAAK,GAClE,CAAA,0DAAA,EAA6DH,gBAAgB,GACnF,CAAC;AACL,EAAA;EAEA,OAAO,IAAIM,WAAW,EAAE,CAACC,MAAM,CAACL,MAAM,CAACM,IAAI,CAAC;AAChD;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,kBAAkBA,CAACC,IAAI,EAAEC,OAAO,EACzC;AACI,EAAA,MAAMC,MAAM,GAAGF,IAAI,CAACG,OAAO,CAACC,IAAI,CAAEC,KAAK,IAAKA,KAAK,CAACV,GAAG,KAAKM,OAAO,CAAC;AAClE,EAAA,IAAI,CAACC,MAAM,EAAE,OAAO,IAAI;AAExB,EAAA,OAAOI,iBAAiB,CAAC;IACrBC,UAAU,EAAEL,MAAM,CAACK,UAAU;AAC7BC,IAAAA,UAAU,EAAE,CAACR,IAAI,CAACS,kBAAkB,IAAI,EAAE,EACrCC,MAAM,CAAEC,SAAS,IAAKA,SAAS,CAACC,SAAS,KAAKX,OAAO;AAC9D,GAAC,CAAC;AACN;;AAEA;MACaY,sBAAsB,GAAGC,MAAM,CAACC,MAAM,CAAC;EAAExB,aAAa;AAAEQ,EAAAA;AAAmB,CAAC;;AAEzF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASiB,0BAA0BA,CACtCC,SAAS,EACTC,gBAAgB,EAChBC,cAAc,EACdC,OAAO,GAAG,EAAE,EAEhB;EACI,OAAOC,4BAAc,CACjBJ,SAAS,EACTC,gBAAgB,EAChBC,cAAc,EACdN,sBAAsB,EACtBO,OACJ,CAAC;AACL;;;;"}