@carbonenginejs/runtime-resource 0.9.2 → 0.11.0

package/dist/formats/webgpu/CjsWebgpuFormat.js

@@ -0,0 +1,376 @@
+import { CLASS_KEYS } from './core/schema.js';
+import { lowerDxbcToIr } from './core/ir/lowerDxbcToIr.js';
+import { buildWgsl } from './core/wgsl/emitWgsl.js';
+import { buildWgslBindingPlan } from './core/wgsl/buildWgslBindingPlan.js';
+import { buildWgslSet } from './core/wgsl/buildWgslSet.js';
+import { buildEffectPackage } from './core/packageEffect.js';
+import { FORMAT_WEBGPU_PACKAGE_VERSION } from './core/packageMetadata.js';
+import { DEFAULT_VALUES, normalizeValues, validateClassKey, validateClass, readWithValues, inspectWithValues, buildPackage, analyzeEffectWithValues, toJsonValue, isCewgpu, OUTPUT_JSON, OUTPUT_RAW, CEWGPU_FORMAT, CEWGPU_ANALYSIS_FORMAT } from './core/helpers.js';
+
+const FORMAT_NAME = "CjsWebgpuFormat";
+
+/**
+ * CarbonEngineJS-facing format surface for `.cewgpu` WebGPU packages, plus an
+ * offline effect-analysis helper built on `format-hlsl` and `format-dxbc`.
+ *
+ * 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;
+  #source = DEFAULT_VALUES.source;
+  #decodeInstructions = DEFAULT_VALUES.decodeInstructions;
+  #permutation = DEFAULT_VALUES.permutation;
+  #schema = DEFAULT_VALUES.schema;
+  #classes = {};
+
+  /**
+   * 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.
+   */
+  SetValues(options = {}) {
+    const values = normalizeValues(this.GetValues(), options, CLASS_KEYS, FORMAT_NAME);
+    this.#emit = values.emit;
+    this.#source = values.source;
+    this.#decodeInstructions = values.decodeInstructions;
+    this.#permutation = values.permutation;
+    this.#schema = values.schema;
+    this.#classes = values.classes;
+    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.
+   */
+  GetValues(options = {}) {
+    return normalizeValues({
+      emit: this.#emit,
+      source: this.#source,
+      decodeInstructions: this.#decodeInstructions,
+      permutation: this.#permutation,
+      schema: this.#schema,
+      classes: this.#classes
+    }, 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.
+   */
+  SetClasses(classes = {}) {
+    return this.SetValues({
+      classes
+    });
+  }
+
+  /**
+   * 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);
+    if (Class === null || Class === undefined) {
+      delete this.#classes[type];
+      return this;
+    }
+    validateClass(CLASS_KEYS, type, Class, FORMAT_NAME);
+    this.#classes = {
+      ...this.#classes,
+      [type]: Class
+    };
+    return this;
+  }
+
+  /**
+   * 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.
+   */
+  HasClass(type) {
+    return !!this.GetClass(type);
+  }
+
+  /**
+   * Read a CEWGPU package with this profile's values.
+   *
+   * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input CEWGPU package bytes.
+   * @param {object} [options] Per-call value overrides.
+   * @returns {object} Plain JSON data, or the raw package instance when emit is "raw".
+   */
+  Read(input, options = {}) {
+    return readWithValues(input, this.GetValues(options));
+  }
+
+  /**
+   * Inspect a CEWGPU package without building the full JSON shape.
+   *
+   * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input CEWGPU package bytes.
+   * @param {object} [options] Per-call value overrides.
+   * @returns {object} Plain summary data.
+   */
+  Inspect(input, options = {}) {
+    return inspectWithValues(input, this.GetValues(options));
+  }
+
+  /**
+   * Assembles a CEWGPU package from ordered chunk payloads.
+   *
+   * @param {Array<[string, string|object|Uint8Array|ArrayBuffer|ArrayBufferView]>} chunks Ordered package chunks.
+   * @returns {Uint8Array} Package bytes.
+   */
+  Build(chunks) {
+    return buildPackage(chunks);
+  }
+
+  /**
+   * Analyzes one compiled effect payload into a normalized WebGPU-facing
+   * document using the current profile's values.
+   *
+   * @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 CEWGPU 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();
+    return buildEffectPackage(input, {
+      source: values.source,
+      permutation: values.permutation,
+      ...options
+    });
+  }
+
+  /**
+   * 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.
+   */
+  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.
+   */
+  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.
+   */
+  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.
+   */
+  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 starts with the CEWGPU magic.
+   */
+  static isCewgpu(input) {
+    return isCewgpu(input);
+  }
+
+  /**
+   * Static one-shot read.
+   *
+   * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input CEWGPU package bytes.
+   * @param {object} [options] Format values.
+   * @returns {object} Plain JSON data, or the raw package instance when emit is "raw".
+   */
+  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 CEWGPU 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 package build.
+   *
+   * @param {Array<[string, string|object|Uint8Array|ArrayBuffer|ArrayBufferView]>} chunks Ordered package chunks.
+   * @returns {Uint8Array} Package bytes.
+   */
+  static build(chunks) {
+    return buildPackage(chunks);
+  }
+
+  /**
+   * Static one-shot effect analysis.
+   *
+   * @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 CEWGPU 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 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 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 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 buildWgslSet(entries) {
+    return buildWgslSet(entries);
+  }
+
+  /**
+   * 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(["cewgpu"]);
+  static outputTypes = Object.freeze([OUTPUT_JSON]);
+  static debugOutputTypes = Object.freeze([OUTPUT_RAW]);
+  static implementationStatus = "partial";
+  static format = CEWGPU_FORMAT;
+  static analysisFormat = CEWGPU_ANALYSIS_FORMAT;
+  static packageVersion = FORMAT_WEBGPU_PACKAGE_VERSION;
+}
+
+export { CjsWebgpuFormat, CjsWebgpuFormat as default };
+//# sourceMappingURL=CjsWebgpuFormat.js.map

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

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