@carbonenginejs/runtime-resource 0.17.0 → 0.18.1

package/dist/formats/webgpu/CjsWebgpuFormat.js

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

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

@@ -74,9 +74,11 @@ const WGSL_CONTAINER_BACKEND = Object.freeze({
  * Builds the complete WebGPU effect container.
  *
  * @param {object} effectRes Loaded version-15 `Tr2EffectRes`.
- * @param {object} permutationGraph Validated `PGRF` document.
+ * @param {object} permutationGraph Validated derived `CJS_EFFECT_PERMUTATION_GRAPH` document (no chunk is stored).
  * @param {object} backendBodySet Translated backend bodies.
  * @param {object} [options] Container options.
+ * @param {number} [options.version] Container data version to emit; defaults to
+ *     the current version. Independent of the source effect's version.
  * @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.

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

@@ -1 +1 @@
-{"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;;;;"}
+{"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 derived `CJS_EFFECT_PERMUTATION_GRAPH` document (no chunk is stored).\n * @param {object} backendBodySet Translated backend bodies.\n * @param {object} [options] Container options.\n * @param {number} [options.version] Container data version to emit; defaults to\n *     the current version. Independent of the source effect's version.\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;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;;;;"}