@carbonenginejs/runtime-resource 0.13.0 → 0.15.0

package/dist/formats/dxbc/CjsDxbcFormat.js

@@ -1,142 +1,187 @@
-import { DxbcContainer } from './core/container.js';
-import { DEFAULT_VALUES, normalizeValues, readWithValues, inspectWithValues, toJsonValue, OUTPUT_JSON, OUTPUT_RAW } from './core/helpers.js';
-
-/**
- * Exposed CarbonEngineJS-facing DXBC format class.
- *
- * Keep this file small and reviewable: container/signature/program parsing
- * and the instruction decoder live in core/; input/option normalization and
- * the shared read path live in core/helpers.js.
- */
-
-const FORMAT_NAME = "CjsDxbcFormat";
-
-/**
- * CarbonEngineJS-facing DXBC (Direct3D shader bytecode) reader.
- *
- * The Cjs prefix marks this as a JavaScript format/construction boundary.
- * DXBC is Microsoft's compiled-shader container format; this reader has no
- * CCP/Carbon vocabulary. It parses the container, signatures and the
- * SM4/SM5 token stream, and emits plain JSON data by default or the raw
- * decoder objects for backends (GLSL/WGSL emitters) that want them.
- */
-class CjsDxbcFormat {
-  #emit = DEFAULT_VALUES.emit;
-  #source = DEFAULT_VALUES.source;
-  #decodeInstructions = DEFAULT_VALUES.decodeInstructions;
-
-  /**
-   * 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 {CjsDxbcFormat} This format profile.
-   */
-  SetValues(options = {}) {
-    const values = normalizeValues(this.GetValues(), options, FORMAT_NAME);
-    this.#emit = values.emit;
-    this.#source = values.source;
-    this.#decodeInstructions = values.decodeInstructions;
-    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
-    }, options, FORMAT_NAME);
-  }
-
-  /**
-   * Read a DXBC payload with this profile's values.
-   *
-   * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input DXBC bytes.
-   * @param {object} [options] Per-call value overrides.
-   * @returns {object} Plain JSON data, or raw decoder objects when emit is "raw".
-   */
-  Read(input, options = {}) {
-    return readWithValues(input, this.GetValues(options));
-  }
-
-  /**
-   * Inspect a DXBC payload without decoding instructions.
-   *
-   * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input DXBC bytes.
-   * @param {object} [options] Per-call value overrides.
-   * @returns {object} Plain summary data.
-   */
-  Inspect(input, options = {}) {
-    return inspectWithValues(input, this.GetValues(options));
-  }
-
-  /**
-   * 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 DXBC magic.
-   */
-  static isDxbc(input) {
-    try {
-      return DxbcContainer.IsDxbc(input);
-    } catch {
-      return false;
-    }
-  }
-
-  /**
-   * Static one-shot read.
-   *
-   * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input DXBC bytes.
-   * @param {object} [options] Format values.
-   * @returns {object} Plain JSON data, or raw decoder objects when emit is "raw".
-   */
-  static read(input, options = {}) {
-    return readWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));
-  }
-
-  /**
-   * Static one-shot inspection.
-   *
-   * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input DXBC bytes.
-   * @param {object} [options] Format values.
-   * @returns {object} Plain summary data.
-   */
-  static inspect(input, options = {}) {
-    return inspectWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));
-  }
-
-  /**
-   * 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 type = Object.freeze(["shader"]);
-  static mediaTypes = Object.freeze(["shader"]);
-  static inputTypes = Object.freeze(["dxbc"]);
-  static outputTypes = Object.freeze([OUTPUT_JSON]);
-  static debugOutputTypes = Object.freeze([OUTPUT_RAW]);
-}
-
-export { CjsDxbcFormat, CjsDxbcFormat as default };
-//# sourceMappingURL=CjsDxbcFormat.js.map
+import { DxbcContainer } from './core/container.js';
+import { disassembleInstructions } from './core/disassemble.js';
+import { DEFAULT_VALUES, normalizeValues, readWithValues, inspectWithValues, toJsonValue, OUTPUT_JSON, OUTPUT_RAW } from './core/helpers.js';
+
+/**
+ * Exposed CarbonEngineJS-facing DXBC format class.
+ *
+ * Keep this file small and reviewable: container/signature/program parsing
+ * and the instruction decoder live in core/; input/option normalization and
+ * the shared read path live in core/helpers.js.
+ */
+
+const FORMAT_NAME = "CjsDxbcFormat";
+
+/**
+ * Resolves whatever the caller has to the decoder record a listing needs.
+ *
+ * Callers reach disassembly from three places: raw bytes, the result of a
+ * previous read they do not want to repeat, and a decoder they already hold
+ * from an emitter. All three are accepted so the listing never costs a second
+ * decode.
+ *
+ * @param {Uint8Array|ArrayBuffer|Buffer|DataView|object} input Bytes or record.
+ * @param {object} options Format values for the byte path.
+ * @returns {object} Record carrying an `instructions` array.
+ */
+function resolveDecoderRecord(input, options) {
+  if (input && typeof input === "object" && Array.isArray(input.instructions)) {
+    return input;
+  }
+  if (input && typeof input === "object" && input.decoder) {
+    return input.decoder;
+  }
+  const result = readWithValues(input, normalizeValues(DEFAULT_VALUES, {
+    ...options,
+    emit: OUTPUT_RAW,
+    decodeInstructions: true
+  }, FORMAT_NAME));
+  return result.decoder;
+}
+
+/**
+ * CarbonEngineJS-facing DXBC (Direct3D shader bytecode) reader.
+ *
+ * The Cjs prefix marks this as a JavaScript format/construction boundary.
+ * DXBC is Microsoft's compiled-shader container format; this reader has no
+ * CCP/Carbon vocabulary. It parses the container, signatures and the
+ * SM4/SM5 token stream, and emits plain JSON data by default or the raw
+ * decoder objects for backends (GLSL/WGSL emitters) that want them.
+ */
+class CjsDxbcFormat {
+  #emit = DEFAULT_VALUES.emit;
+  #source = DEFAULT_VALUES.source;
+  #decodeInstructions = DEFAULT_VALUES.decodeInstructions;
+
+  /**
+   * 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 {CjsDxbcFormat} This format profile.
+   */
+  SetValues(options = {}) {
+    const values = normalizeValues(this.GetValues(), options, FORMAT_NAME);
+    this.#emit = values.emit;
+    this.#source = values.source;
+    this.#decodeInstructions = values.decodeInstructions;
+    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
+    }, options, FORMAT_NAME);
+  }
+
+  /**
+   * Read a DXBC payload with this profile's values.
+   *
+   * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input DXBC bytes.
+   * @param {object} [options] Per-call value overrides.
+   * @returns {object} Plain JSON data, or raw decoder objects when emit is "raw".
+   */
+  Read(input, options = {}) {
+    return readWithValues(input, this.GetValues(options));
+  }
+
+  /**
+   * Inspect a DXBC payload without decoding instructions.
+   *
+   * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input DXBC bytes.
+   * @param {object} [options] Per-call value overrides.
+   * @returns {object} Plain summary data.
+   */
+  Inspect(input, options = {}) {
+    return inspectWithValues(input, this.GetValues(options));
+  }
+
+  /**
+   * 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 DXBC magic.
+   */
+  static isDxbc(input) {
+    try {
+      return DxbcContainer.IsDxbc(input);
+    } catch {
+      return false;
+    }
+  }
+
+  /**
+   * Static one-shot read.
+   *
+   * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input DXBC bytes.
+   * @param {object} [options] Format values.
+   * @returns {object} Plain JSON data, or raw decoder objects when emit is "raw".
+   */
+  static read(input, options = {}) {
+    return readWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));
+  }
+
+  /**
+   * Static one-shot inspection.
+   *
+   * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input DXBC bytes.
+   * @param {object} [options] Format values.
+   * @returns {object} Plain summary data.
+   */
+  static inspect(input, options = {}) {
+    return inspectWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));
+  }
+
+  /**
+   * Static one-shot disassembly.
+   *
+   * A translated shader can only be judged against the bytecode it was
+   * translated from, so the listing exists to be read beside emitted GLSL or
+   * WGSL. Accepts DXBC bytes or an already-decoded result from `read`.
+   *
+   * @param {Uint8Array|ArrayBuffer|Buffer|DataView|object} input DXBC bytes,
+   *     a read result, or a decoder record.
+   * @param {object} [options] Listing options plus format values.
+   * @returns {string} Assembly listing.
+   */
+  static disassemble(input, options = {}) {
+    const decoder = resolveDecoderRecord(input, options);
+    return disassembleInstructions(decoder, options);
+  }
+
+  /**
+   * 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 type = Object.freeze(["shader"]);
+  static mediaTypes = Object.freeze(["shader"]);
+  static inputTypes = Object.freeze(["dxbc"]);
+  static outputTypes = Object.freeze([OUTPUT_JSON]);
+  static debugOutputTypes = Object.freeze([OUTPUT_RAW]);
+}
+
+export { CjsDxbcFormat, CjsDxbcFormat as default };
+//# sourceMappingURL=CjsDxbcFormat.js.map

package/dist/formats/dxbc/CjsDxbcFormat.js.map

@@ -1 +1 @@
-{"version":3,"file":"CjsDxbcFormat.js","sources":["../../../../src/formats/dxbc/CjsDxbcFormat.js"],"sourcesContent":["/**\n * Exposed CarbonEngineJS-facing DXBC format class.\n *\n * Keep this file small and reviewable: container/signature/program parsing\n * and the instruction decoder live in core/; input/option normalization and\n * the shared read path live in core/helpers.js.\n */\n\nimport { DxbcContainer } from \"./core/container.js\";\nimport {\n    DEFAULT_VALUES,\n    OUTPUT_JSON,\n    OUTPUT_RAW,\n    inspectWithValues,\n    normalizeValues,\n    readWithValues,\n    toJsonValue\n} from \"./core/helpers.js\";\n\nconst FORMAT_NAME = \"CjsDxbcFormat\";\n\n/**\n * CarbonEngineJS-facing DXBC (Direct3D shader bytecode) reader.\n *\n * The Cjs prefix marks this as a JavaScript format/construction boundary.\n * DXBC is Microsoft's compiled-shader container format; this reader has no\n * CCP/Carbon vocabulary. It parses the container, signatures and the\n * SM4/SM5 token stream, and emits plain JSON data by default or the raw\n * decoder objects for backends (GLSL/WGSL emitters) that want them.\n */\nexport class CjsDxbcFormat\n{\n\n    #emit = DEFAULT_VALUES.emit;\n    #source = DEFAULT_VALUES.source;\n    #decodeInstructions = DEFAULT_VALUES.decodeInstructions;\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 {CjsDxbcFormat} This format profile.\n     */\n    SetValues(options = {})\n    {\n        const values = normalizeValues(this.GetValues(), options, FORMAT_NAME);\n\n        this.#emit = values.emit;\n        this.#source = values.source;\n        this.#decodeInstructions = values.decodeInstructions;\n\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        }, options, FORMAT_NAME);\n    }\n\n    /**\n     * Read a DXBC payload with this profile's values.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input DXBC bytes.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} Plain JSON data, or raw decoder objects when emit is \"raw\".\n     */\n    Read(input, options = {})\n    {\n        return readWithValues(input, this.GetValues(options));\n    }\n\n    /**\n     * Inspect a DXBC payload without decoding instructions.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input DXBC 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     * 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 DXBC magic.\n     */\n    static isDxbc(input)\n    {\n        try\n        {\n            return DxbcContainer.IsDxbc(input);\n        }\n        catch\n        {\n            return false;\n        }\n    }\n\n    /**\n     * Static one-shot read.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input DXBC bytes.\n     * @param {object} [options] Format values.\n     * @returns {object} Plain JSON data, or raw decoder objects when emit is \"raw\".\n     */\n    static read(input, options = {})\n    {\n        return readWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\n    }\n\n    /**\n     * Static one-shot inspection.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input DXBC 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, FORMAT_NAME));\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 type = Object.freeze([ \"shader\" ]);\n    static mediaTypes = Object.freeze([ \"shader\" ]);\n    static inputTypes = Object.freeze([ \"dxbc\" ]);\n    static outputTypes = Object.freeze([ OUTPUT_JSON ]);\n    static debugOutputTypes = Object.freeze([ OUTPUT_RAW ]);\n\n}\n\nexport default CjsDxbcFormat;\n"],"names":["FORMAT_NAME","CjsDxbcFormat","DEFAULT_VALUES","emit","source","decodeInstructions","constructor","options","SetValues","values","normalizeValues","GetValues","Read","input","readWithValues","Inspect","inspectWithValues","isDxbc","DxbcContainer","IsDxbc","read","inspect","toJSON","value","toJsonValue","OUTPUT_JSON","OUTPUT_RAW","type","Object","freeze","mediaTypes","inputTypes","outputTypes","debugOutputTypes"],"mappings":"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"}
+{"version":3,"file":"CjsDxbcFormat.js","sources":["../../../../src/formats/dxbc/CjsDxbcFormat.js"],"sourcesContent":["/**\n * Exposed CarbonEngineJS-facing DXBC format class.\n *\n * Keep this file small and reviewable: container/signature/program parsing\n * and the instruction decoder live in core/; input/option normalization and\n * the shared read path live in core/helpers.js.\n */\n\nimport { DxbcContainer } from \"./core/container.js\";\nimport { disassembleInstructions } from \"./core/disassemble.js\";\nimport {\n    DEFAULT_VALUES,\n    OUTPUT_JSON,\n    OUTPUT_RAW,\n    inspectWithValues,\n    normalizeValues,\n    readWithValues,\n    toJsonValue\n} from \"./core/helpers.js\";\n\nconst FORMAT_NAME = \"CjsDxbcFormat\";\n\n/**\n * Resolves whatever the caller has to the decoder record a listing needs.\n *\n * Callers reach disassembly from three places: raw bytes, the result of a\n * previous read they do not want to repeat, and a decoder they already hold\n * from an emitter. All three are accepted so the listing never costs a second\n * decode.\n *\n * @param {Uint8Array|ArrayBuffer|Buffer|DataView|object} input Bytes or record.\n * @param {object} options Format values for the byte path.\n * @returns {object} Record carrying an `instructions` array.\n */\nfunction resolveDecoderRecord(input, options)\n{\n    if (input && typeof input === \"object\" && Array.isArray(input.instructions))\n    {\n        return input;\n    }\n\n    if (input && typeof input === \"object\" && input.decoder)\n    {\n        return input.decoder;\n    }\n\n    const result = readWithValues(input, normalizeValues(DEFAULT_VALUES, {\n        ...options,\n        emit: OUTPUT_RAW,\n        decodeInstructions: true\n    }, FORMAT_NAME));\n\n    return result.decoder;\n}\n\n/**\n * CarbonEngineJS-facing DXBC (Direct3D shader bytecode) reader.\n *\n * The Cjs prefix marks this as a JavaScript format/construction boundary.\n * DXBC is Microsoft's compiled-shader container format; this reader has no\n * CCP/Carbon vocabulary. It parses the container, signatures and the\n * SM4/SM5 token stream, and emits plain JSON data by default or the raw\n * decoder objects for backends (GLSL/WGSL emitters) that want them.\n */\nexport class CjsDxbcFormat\n{\n\n    #emit = DEFAULT_VALUES.emit;\n    #source = DEFAULT_VALUES.source;\n    #decodeInstructions = DEFAULT_VALUES.decodeInstructions;\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 {CjsDxbcFormat} This format profile.\n     */\n    SetValues(options = {})\n    {\n        const values = normalizeValues(this.GetValues(), options, FORMAT_NAME);\n\n        this.#emit = values.emit;\n        this.#source = values.source;\n        this.#decodeInstructions = values.decodeInstructions;\n\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        }, options, FORMAT_NAME);\n    }\n\n    /**\n     * Read a DXBC payload with this profile's values.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input DXBC bytes.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} Plain JSON data, or raw decoder objects when emit is \"raw\".\n     */\n    Read(input, options = {})\n    {\n        return readWithValues(input, this.GetValues(options));\n    }\n\n    /**\n     * Inspect a DXBC payload without decoding instructions.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input DXBC 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     * 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 DXBC magic.\n     */\n    static isDxbc(input)\n    {\n        try\n        {\n            return DxbcContainer.IsDxbc(input);\n        }\n        catch\n        {\n            return false;\n        }\n    }\n\n    /**\n     * Static one-shot read.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input DXBC bytes.\n     * @param {object} [options] Format values.\n     * @returns {object} Plain JSON data, or raw decoder objects when emit is \"raw\".\n     */\n    static read(input, options = {})\n    {\n        return readWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\n    }\n\n    /**\n     * Static one-shot inspection.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input DXBC 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, FORMAT_NAME));\n    }\n\n    /**\n     * Static one-shot disassembly.\n     *\n     * A translated shader can only be judged against the bytecode it was\n     * translated from, so the listing exists to be read beside emitted GLSL or\n     * WGSL. Accepts DXBC bytes or an already-decoded result from `read`.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView|object} input DXBC bytes,\n     *     a read result, or a decoder record.\n     * @param {object} [options] Listing options plus format values.\n     * @returns {string} Assembly listing.\n     */\n    static disassemble(input, options = {})\n    {\n        const decoder = resolveDecoderRecord(input, options);\n\n        return disassembleInstructions(decoder, options);\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 type = Object.freeze([ \"shader\" ]);\n    static mediaTypes = Object.freeze([ \"shader\" ]);\n    static inputTypes = Object.freeze([ \"dxbc\" ]);\n    static outputTypes = Object.freeze([ OUTPUT_JSON ]);\n    static debugOutputTypes = Object.freeze([ OUTPUT_RAW ]);\n\n}\n\nexport default CjsDxbcFormat;\n"],"names":["FORMAT_NAME","resolveDecoderRecord","input","options","Array","isArray","instructions","decoder","result","readWithValues","normalizeValues","DEFAULT_VALUES","emit","OUTPUT_RAW","decodeInstructions","CjsDxbcFormat","source","constructor","SetValues","values","GetValues","Read","Inspect","inspectWithValues","isDxbc","DxbcContainer","IsDxbc","read","inspect","disassemble","disassembleInstructions","toJSON","value","toJsonValue","OUTPUT_JSON","type","Object","freeze","mediaTypes","inputTypes","outputTypes","debugOutputTypes"],"mappings":"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"}