@carbonenginejs/runtime-resource 0.10.0 → 0.11.1

package/dist/formats/dxbc/core/signature.js

@@ -0,0 +1,172 @@
+import { DxbcReader } from './DxbcReader.js';
+import { DxbcReadError } from './errors.js';
+
+const SIGNATURE_TABLE_HEADER_SIZE = 8;
+const semanticNameDecoder = new TextDecoder("latin1");
+
+/**
+ * Per-fourCC signature element layouts.
+ *
+ * `ISGN`/`OSGN`/`PCSG` use the 24-byte Shader Model 4 layout. `OSG5` prefixes
+ * a stream index. `ISG1`/`OSG1`/`PSG1` prefix a stream index and append a
+ * minimum-precision field.
+ */
+const SIGNATURE_ELEMENT_LAYOUTS = Object.freeze({
+  ISGN: {
+    stride: 24,
+    hasStream: false,
+    hasMinPrecision: false
+  },
+  OSGN: {
+    stride: 24,
+    hasStream: false,
+    hasMinPrecision: false
+  },
+  PCSG: {
+    stride: 24,
+    hasStream: false,
+    hasMinPrecision: false
+  },
+  OSG5: {
+    stride: 28,
+    hasStream: true,
+    hasMinPrecision: false
+  },
+  ISG1: {
+    stride: 32,
+    hasStream: true,
+    hasMinPrecision: true
+  },
+  OSG1: {
+    stride: 32,
+    hasStream: true,
+    hasMinPrecision: true
+  },
+  PSG1: {
+    stride: 32,
+    hasStream: true,
+    hasMinPrecision: true
+  }
+});
+
+/**
+ * Register component type names indexed by DXBC signature component-type ids.
+ */
+const DxbcComponentTypeNames = Object.freeze(["unknown", "uint32", "int32", "float32"]);
+
+/**
+ * DXBC input/output signature chunk reader for `ISGN`-family chunks.
+ */
+class DxbcSignatureChunk {
+  /**
+   * Creates an empty signature chunk; call a read entry point to populate its parameter records.
+   */
+  constructor() {
+    this.fourCC = "";
+    this.elements = [];
+    this.source = "memory";
+  }
+
+  /**
+  * Reads a signature chunk payload into semantic/register element records.
+  *
+  * @param {{fourCC:string,bytes:Uint8Array}} chunk Chunk record from `DxbcContainer`.
+  * @param {object} [options] Read options.
+  * @param {string} [options.source] Source name used in error details.
+  * @returns {DxbcSignatureChunk} This signature.
+  */
+  Read(chunk, options = {}) {
+    this.fourCC = chunk.fourCC;
+    this.source = options.source || "memory";
+    const layout = SIGNATURE_ELEMENT_LAYOUTS[this.fourCC];
+    if (!layout) {
+      throw new DxbcReadError("Unsupported DXBC signature chunk", {
+        source: this.source,
+        fourCC: this.fourCC
+      });
+    }
+    const bytes = chunk.bytes;
+    const reader = new DxbcReader(bytes, {
+      source: this.source
+    });
+    const elementCount = reader.readUint32();
+    const elementOffset = reader.readUint32() || SIGNATURE_TABLE_HEADER_SIZE;
+    if (elementOffset + elementCount * layout.stride > bytes.length) {
+      throw new DxbcReadError("DXBC signature elements lie outside the chunk", {
+        source: this.source,
+        fourCC: this.fourCC,
+        elementCount,
+        elementOffset,
+        chunkSize: bytes.length
+      });
+    }
+    this.elements = [];
+    reader.offset = elementOffset;
+    for (let index = 0; index < elementCount; index += 1) {
+      const stream = layout.hasStream ? reader.readUint32() : 0;
+      const semanticNameOffset = reader.readUint32();
+      const semanticIndex = reader.readUint32();
+      const systemValueType = reader.readUint32();
+      const componentType = reader.readUint32();
+      const registerIndex = reader.readUint32();
+      const mask = reader.readUint8();
+      const readWriteMask = reader.readUint8();
+      reader.Skip(2);
+      const minPrecision = layout.hasMinPrecision ? reader.readUint32() : 0;
+      this.elements.push({
+        semanticName: this._readSemanticName(bytes, semanticNameOffset, index),
+        semanticIndex,
+        systemValueType,
+        componentType,
+        componentTypeName: DxbcComponentTypeNames[componentType] || "unknown",
+        registerIndex,
+        mask,
+        readWriteMask,
+        stream,
+        minPrecision
+      });
+    }
+    return this;
+  }
+
+  /**
+  * Finds a signature element by semantic name and index.
+  *
+  * @param {string} semanticName Case-insensitive semantic name such as `"TEXCOORD"`.
+  * @param {number} [semanticIndex] Semantic index, defaulting to 0.
+  * @returns {object|null} Element record or null.
+  */
+  findElement(semanticName, semanticIndex = 0) {
+    const wanted = String(semanticName).toUpperCase();
+    return this.elements.find(element => element.semanticName.toUpperCase() === wanted && element.semanticIndex === semanticIndex) || null;
+  }
+
+  /**
+  * Resolves a null-terminated semantic name inside the chunk payload.
+  *
+  * @param {Uint8Array} bytes Chunk payload.
+  * @param {number} offset Name offset relative to the chunk payload start.
+  * @param {number} index Element index used in error details.
+  * @returns {string} Decoded semantic name.
+  * @private
+  */
+  _readSemanticName(bytes, offset, index) {
+    if (offset >= bytes.length) {
+      throw new DxbcReadError("DXBC signature semantic name lies outside the chunk", {
+        source: this.source,
+        fourCC: this.fourCC,
+        elementIndex: index,
+        offset,
+        chunkSize: bytes.length
+      });
+    }
+    let end = offset;
+    while (end < bytes.length && bytes[end] !== 0) {
+      end += 1;
+    }
+    return semanticNameDecoder.decode(bytes.subarray(offset, end));
+  }
+}
+
+export { DxbcComponentTypeNames, DxbcSignatureChunk };
+//# sourceMappingURL=signature.js.map

package/dist/formats/dxbc/core/signature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signature.js","sources":["../../../../../src/formats/dxbc/core/signature.js"],"sourcesContent":["import { DxbcReader } from \"./DxbcReader.js\";\nimport { DxbcReadError } from \"./errors.js\";\n\nconst SIGNATURE_TABLE_HEADER_SIZE = 8;\n\nconst semanticNameDecoder = new TextDecoder(\"latin1\");\n\n/**\n * Per-fourCC signature element layouts.\n *\n * `ISGN`/`OSGN`/`PCSG` use the 24-byte Shader Model 4 layout. `OSG5` prefixes\n * a stream index. `ISG1`/`OSG1`/`PSG1` prefix a stream index and append a\n * minimum-precision field.\n */\nconst SIGNATURE_ELEMENT_LAYOUTS = Object.freeze({\n    ISGN: { stride: 24, hasStream: false, hasMinPrecision: false },\n    OSGN: { stride: 24, hasStream: false, hasMinPrecision: false },\n    PCSG: { stride: 24, hasStream: false, hasMinPrecision: false },\n    OSG5: { stride: 28, hasStream: true, hasMinPrecision: false },\n    ISG1: { stride: 32, hasStream: true, hasMinPrecision: true },\n    OSG1: { stride: 32, hasStream: true, hasMinPrecision: true },\n    PSG1: { stride: 32, hasStream: true, hasMinPrecision: true }\n});\n\n/**\n * Register component type names indexed by DXBC signature component-type ids.\n */\nexport const DxbcComponentTypeNames = Object.freeze([ \"unknown\", \"uint32\", \"int32\", \"float32\" ]);\n\n/**\n * DXBC input/output signature chunk reader for `ISGN`-family chunks.\n */\nexport class DxbcSignatureChunk\n{\n    /**\n     * Creates an empty signature chunk; call a read entry point to populate its parameter records.\n     */\n    constructor()\n    {\n        this.fourCC = \"\";\n        this.elements = [];\n        this.source = \"memory\";\n    }\n\n    /**\n   * Reads a signature chunk payload into semantic/register element records.\n   *\n   * @param {{fourCC:string,bytes:Uint8Array}} chunk Chunk record from `DxbcContainer`.\n   * @param {object} [options] Read options.\n   * @param {string} [options.source] Source name used in error details.\n   * @returns {DxbcSignatureChunk} This signature.\n   */\n    Read(chunk, options = {})\n    {\n        this.fourCC = chunk.fourCC;\n        this.source = options.source || \"memory\";\n        const layout = SIGNATURE_ELEMENT_LAYOUTS[this.fourCC];\n        if (!layout)\n        {\n            throw new DxbcReadError(\"Unsupported DXBC signature chunk\", {\n                source: this.source,\n                fourCC: this.fourCC\n            });\n        }\n\n        const bytes = chunk.bytes;\n        const reader = new DxbcReader(bytes, { source: this.source });\n        const elementCount = reader.readUint32();\n        const elementOffset = reader.readUint32() || SIGNATURE_TABLE_HEADER_SIZE;\n        if (elementOffset + elementCount * layout.stride > bytes.length)\n        {\n            throw new DxbcReadError(\"DXBC signature elements lie outside the chunk\", {\n                source: this.source,\n                fourCC: this.fourCC,\n                elementCount,\n                elementOffset,\n                chunkSize: bytes.length\n            });\n        }\n\n        this.elements = [];\n        reader.offset = elementOffset;\n        for (let index = 0; index < elementCount; index += 1)\n        {\n            const stream = layout.hasStream ? reader.readUint32() : 0;\n            const semanticNameOffset = reader.readUint32();\n            const semanticIndex = reader.readUint32();\n            const systemValueType = reader.readUint32();\n            const componentType = reader.readUint32();\n            const registerIndex = reader.readUint32();\n            const mask = reader.readUint8();\n            const readWriteMask = reader.readUint8();\n            reader.Skip(2);\n            const minPrecision = layout.hasMinPrecision ? reader.readUint32() : 0;\n\n            this.elements.push({\n                semanticName: this._readSemanticName(bytes, semanticNameOffset, index),\n                semanticIndex,\n                systemValueType,\n                componentType,\n                componentTypeName: DxbcComponentTypeNames[componentType] || \"unknown\",\n                registerIndex,\n                mask,\n                readWriteMask,\n                stream,\n                minPrecision\n            });\n        }\n        return this;\n    }\n\n    /**\n   * Finds a signature element by semantic name and index.\n   *\n   * @param {string} semanticName Case-insensitive semantic name such as `\"TEXCOORD\"`.\n   * @param {number} [semanticIndex] Semantic index, defaulting to 0.\n   * @returns {object|null} Element record or null.\n   */\n    findElement(semanticName, semanticIndex = 0)\n    {\n        const wanted = String(semanticName).toUpperCase();\n        return this.elements.find(\n            (element) => element.semanticName.toUpperCase() === wanted && element.semanticIndex === semanticIndex\n        ) || null;\n    }\n\n    /**\n   * Resolves a null-terminated semantic name inside the chunk payload.\n   *\n   * @param {Uint8Array} bytes Chunk payload.\n   * @param {number} offset Name offset relative to the chunk payload start.\n   * @param {number} index Element index used in error details.\n   * @returns {string} Decoded semantic name.\n   * @private\n   */\n    _readSemanticName(bytes, offset, index)\n    {\n        if (offset >= bytes.length)\n        {\n            throw new DxbcReadError(\"DXBC signature semantic name lies outside the chunk\", {\n                source: this.source,\n                fourCC: this.fourCC,\n                elementIndex: index,\n                offset,\n                chunkSize: bytes.length\n            });\n        }\n        let end = offset;\n        while (end < bytes.length && bytes[end] !== 0)\n        {\n            end += 1;\n        }\n        return semanticNameDecoder.decode(bytes.subarray(offset, end));\n    }\n}\n"],"names":["SIGNATURE_TABLE_HEADER_SIZE","semanticNameDecoder","TextDecoder","SIGNATURE_ELEMENT_LAYOUTS","Object","freeze","ISGN","stride","hasStream","hasMinPrecision","OSGN","PCSG","OSG5","ISG1","OSG1","PSG1","DxbcComponentTypeNames","DxbcSignatureChunk","constructor","fourCC","elements","source","Read","chunk","options","layout","DxbcReadError","bytes","reader","DxbcReader","elementCount","readUint32","elementOffset","length","chunkSize","offset","index","stream","semanticNameOffset","semanticIndex","systemValueType","componentType","registerIndex","mask","readUint8","readWriteMask","Skip","minPrecision","push","semanticName","_readSemanticName","componentTypeName","findElement","wanted","String","toUpperCase","find","element","elementIndex","end","decode","subarray"],"mappings":"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"}

package/dist/formats/dxbc/index.js

@@ -0,0 +1,2 @@
+export { CjsDxbcFormat, CjsDxbcFormat as default } from './CjsDxbcFormat.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/formats/hlsl/CjsHlslFormat.js

@@ -0,0 +1,254 @@
+import { HlslEffectRes } from './core/tr2/resources/HlslEffectRes.js';
+import { DEFAULT_VALUES, normalizeValues, validateClassKey, validateClass, readWithValues, inspectWithValues, toJsonValue, toBytes, OUTPUT_JSON, OUTPUT_METADATA, OUTPUT_RAW } from './core/helpers.js';
+import { CLASS_KEYS } from './core/json.js';
+
+/**
+ * Exposed CarbonEngineJS-facing Tr2 effect container format class.
+ *
+ * Keep this file small and reviewable: the Tr2 effect graph parser lives
+ * under src/core/tr2 (internal parsing machinery, not part of this
+ * package's public surface); input/option normalization, the shared read
+ * path, and the JSON emitters live under src/core.
+ */
+
+const FORMAT_NAME = "CjsHlslFormat";
+
+/**
+ * CarbonEngineJS-facing reader for CCP's Tr2 compiled effect container
+ * format (`.sm_hi` / `.sm_lo` / `.sm_depth` bodies).
+ *
+ * The Cjs prefix marks this as a JavaScript format/construction boundary.
+ * This format profile has no dependency on any DXBC/shader-bytecode decoder: shader
+ * bodies stay as opaque bytes in the emitted graph. The public contract is
+ * plain JSON data (`emit: "json"`, the default) — the documented effect
+ * graph shape described in `docs/reference/json-graph.md`. `emit: "raw"`
+ * exposes the internal
+ * HlslEffectRes graph directly; treat it as unstable, not schema-guaranteed
+ * internals, useful mainly for resolving multiple permutations by hand.
+ *
+ * The `classes` option lets a caller register constructors for specific
+ * node kinds in the emitted JSON graph (see `CjsHlslFormat.CLASS_KEYS`);
+ * class registration does not depend on importing internal graph classes.
+ */
+class CjsHlslFormat {
+  #emit = DEFAULT_VALUES.emit;
+  #source = DEFAULT_VALUES.source;
+  #permutation = DEFAULT_VALUES.permutation;
+  #classes = DEFAULT_VALUES.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 {CjsHlslFormat} This format profile.
+   */
+  SetValues(options = {}) {
+    const values = normalizeValues(this.GetValues(), options, FORMAT_NAME);
+    this.#emit = values.emit;
+    this.#source = values.source;
+    this.#permutation = values.permutation;
+    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,
+      permutation: this.#permutation,
+      classes: this.#classes
+    }, options, FORMAT_NAME);
+  }
+
+  /**
+   * Set multiple node-class constructors for this profile.
+   *
+   * @param {object} [classes] Map of node class keys to constructors. See {@link CjsHlslFormat.CLASS_KEYS}.
+   * @returns {CjsHlslFormat} 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 {CjsHlslFormat} This format profile.
+   */
+  SetClass(type, Class) {
+    if (Class === null || Class === undefined) {
+      validateClassKey(type, FORMAT_NAME);
+      const classes = {
+        ...this.#classes
+      };
+      delete classes[type];
+      this.#classes = classes;
+      return this;
+    }
+    validateClass(type, Class, FORMAT_NAME);
+    return this.SetValues({
+      classes: {
+        [type]: Class
+      }
+    });
+  }
+
+  /**
+   * Get a configured node-class constructor.
+   *
+   * @param {string} type Node class key.
+   * @returns {Function|undefined} The registered constructor, if any.
+   */
+  GetClass(type) {
+    validateClassKey(type, FORMAT_NAME);
+    return this.#classes[type];
+  }
+
+  /**
+   * Whether this reader has a constructor registered for a node class key.
+   *
+   * @param {string} type Node class key.
+   * @returns {boolean} True when a constructor is registered.
+   */
+  HasClass(type) {
+    return !!this.GetClass(type);
+  }
+
+  /**
+   * Read a Tr2 effect payload with this profile's values.
+   *
+   * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Tr2 effect container bytes.
+   * @param {object} [options] Per-call value overrides.
+   * @returns {HlslEffectRes|object} The raw HlslEffectRes instance, compact metadata, or the documented JSON graph.
+   */
+  Read(input, options = {}) {
+    return readWithValues(input, this.GetValues(options));
+  }
+
+  /**
+   * Inspect a Tr2 effect payload: header facts plus the default (or
+   * selected) permutation's technique names and stage counts.
+   *
+   * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Tr2 effect container bytes.
+   * @param {object} [options] Per-call value overrides.
+   * @returns {object} Plain summary data.
+   */
+  Inspect(input, options = {}) {
+    return inspectWithValues(input, this.GetValues(options));
+  }
+
+  /**
+   * 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.
+   *
+   * The Tr2 effect container has no magic number, so this attempts a
+   * cheap header-only load (version, string table, permutation axes and
+   * body offsets — no shader bodies) and reports whether it succeeded.
+   *
+   * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Candidate bytes.
+   * @returns {boolean} True when the payload's header decodes as a supported Tr2 effect.
+   */
+  static isSupported(input) {
+    try {
+      const bytes = toBytes(input);
+      return new HlslEffectRes().DoLoad(bytes, {
+        source: "isSupported"
+      });
+    } catch {
+      return false;
+    }
+  }
+
+  /**
+   * Static one-shot read.
+   *
+   * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Tr2 effect container bytes.
+   * @param {object} [options] Format values.
+   * @returns {HlslEffectRes|object} The raw HlslEffectRes instance, compact metadata, or the documented JSON graph.
+   */
+  static read(input, options = {}) {
+    return readWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));
+  }
+
+  /**
+   * Static one-shot inspection.
+   *
+   * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Tr2 effect container 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);
+  }
+
+  /**
+   * Node-only convenience: reads a compiled Tr2 effect file from disk.
+   *
+   * @param {string} path Path to a compiled Carbon effect file (`.sm_hi` etc.).
+   * @param {object} [options] Format values.
+   * @returns {Promise<HlslEffectRes|object>} The raw HlslEffectRes instance, compact metadata, or the documented JSON graph.
+   */
+  static async readFile(path, options = {}) {
+    if (typeof path !== "string" || !path) {
+      throw new TypeError(`${FORMAT_NAME}: readFile path must be a non-empty string`);
+    }
+    const {
+      readFile
+    } = await import('node:fs/promises');
+    const input = await readFile(path);
+    return readWithValues(input, normalizeValues(DEFAULT_VALUES, {
+      source: path,
+      ...options
+    }, FORMAT_NAME));
+  }
+  static OUTPUT_JSON = OUTPUT_JSON;
+  static OUTPUT_METADATA = OUTPUT_METADATA;
+  static OUTPUT_RAW = OUTPUT_RAW;
+  static CLASS_KEYS = CLASS_KEYS;
+  static type = Object.freeze(["shader"]);
+  static mediaTypes = Object.freeze(["shader"]);
+  static inputTypes = Object.freeze(["sm_hi", "sm_lo", "sm_depth"]);
+  static outputTypes = Object.freeze([OUTPUT_JSON, OUTPUT_METADATA]);
+  static debugOutputTypes = Object.freeze([OUTPUT_RAW]);
+}
+
+export { CjsHlslFormat, CjsHlslFormat as default };
+//# sourceMappingURL=CjsHlslFormat.js.map

package/dist/formats/hlsl/CjsHlslFormat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CjsHlslFormat.js","sources":["../../../../src/formats/hlsl/CjsHlslFormat.js"],"sourcesContent":["/**\n * Exposed CarbonEngineJS-facing Tr2 effect container format class.\n *\n * Keep this file small and reviewable: the Tr2 effect graph parser lives\n * under src/core/tr2 (internal parsing machinery, not part of this\n * package's public surface); input/option normalization, the shared read\n * path, and the JSON emitters live under src/core.\n */\n\nimport { HlslEffectRes } from \"./core/tr2/resources/HlslEffectRes.js\";\nimport {\n    CLASS_KEYS,\n    DEFAULT_VALUES,\n    OUTPUT_JSON,\n    OUTPUT_METADATA,\n    OUTPUT_RAW,\n    inspectWithValues,\n    normalizeValues,\n    readWithValues,\n    toBytes,\n    toJsonValue,\n    validateClass,\n    validateClassKey\n} from \"./core/helpers.js\";\n\nconst FORMAT_NAME = \"CjsHlslFormat\";\n\n/**\n * CarbonEngineJS-facing reader for CCP's Tr2 compiled effect container\n * format (`.sm_hi` / `.sm_lo` / `.sm_depth` bodies).\n *\n * The Cjs prefix marks this as a JavaScript format/construction boundary.\n * This format profile has no dependency on any DXBC/shader-bytecode decoder: shader\n * bodies stay as opaque bytes in the emitted graph. The public contract is\n * plain JSON data (`emit: \"json\"`, the default) — the documented effect\n * graph shape described in `docs/reference/json-graph.md`. `emit: \"raw\"`\n * exposes the internal\n * HlslEffectRes graph directly; treat it as unstable, not schema-guaranteed\n * internals, useful mainly for resolving multiple permutations by hand.\n *\n * The `classes` option lets a caller register constructors for specific\n * node kinds in the emitted JSON graph (see `CjsHlslFormat.CLASS_KEYS`);\n * class registration does not depend on importing internal graph classes.\n */\nexport class CjsHlslFormat\n{\n\n    #emit = DEFAULT_VALUES.emit;\n    #source = DEFAULT_VALUES.source;\n    #permutation = DEFAULT_VALUES.permutation;\n    #classes = DEFAULT_VALUES.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 {CjsHlslFormat} 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.#permutation = values.permutation;\n        this.#classes = values.classes;\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            permutation: this.#permutation,\n            classes: this.#classes\n        }, options, 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. See {@link CjsHlslFormat.CLASS_KEYS}.\n     * @returns {CjsHlslFormat} 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 {CjsHlslFormat} This format profile.\n     */\n    SetClass(type, Class)\n    {\n        if (Class === null || Class === undefined)\n        {\n            validateClassKey(type, FORMAT_NAME);\n            const classes = { ...this.#classes };\n            delete classes[type];\n            this.#classes = classes;\n            return this;\n        }\n\n        validateClass(type, Class, FORMAT_NAME);\n        return this.SetValues({ classes: { [type]: Class } });\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(type, FORMAT_NAME);\n        return this.#classes[type];\n    }\n\n    /**\n     * Whether this reader has a constructor registered for a node class 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 Tr2 effect payload with this profile's values.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Tr2 effect container bytes.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {HlslEffectRes|object} The raw HlslEffectRes instance, compact metadata, or the documented JSON graph.\n     */\n    Read(input, options = {})\n    {\n        return readWithValues(input, this.GetValues(options));\n    }\n\n    /**\n     * Inspect a Tr2 effect payload: header facts plus the default (or\n     * selected) permutation's technique names and stage counts.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Tr2 effect container 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     * 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     * The Tr2 effect container has no magic number, so this attempts a\n     * cheap header-only load (version, string table, permutation axes and\n     * body offsets — no shader bodies) and reports whether it succeeded.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Candidate bytes.\n     * @returns {boolean} True when the payload's header decodes as a supported Tr2 effect.\n     */\n    static isSupported(input)\n    {\n        try\n        {\n            const bytes = toBytes(input);\n            return new HlslEffectRes().DoLoad(bytes, { source: \"isSupported\" });\n        }\n        catch\n        {\n            return false;\n        }\n    }\n\n    /**\n     * Static one-shot read.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Tr2 effect container bytes.\n     * @param {object} [options] Format values.\n     * @returns {HlslEffectRes|object} The raw HlslEffectRes instance, compact metadata, or the documented JSON graph.\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 Tr2 effect container 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    /**\n     * Node-only convenience: reads a compiled Tr2 effect file from disk.\n     *\n     * @param {string} path Path to a compiled Carbon effect file (`.sm_hi` etc.).\n     * @param {object} [options] Format values.\n     * @returns {Promise<HlslEffectRes|object>} The raw HlslEffectRes instance, compact metadata, or the documented JSON graph.\n     */\n    static async readFile(path, options = {})\n    {\n        if (typeof path !== \"string\" || !path)\n        {\n            throw new TypeError(`${FORMAT_NAME}: readFile path must be a non-empty string`);\n        }\n\n        const { readFile } = await import(\"node:fs/promises\");\n        const input = await readFile(path);\n\n        return readWithValues(input, normalizeValues(DEFAULT_VALUES, { source: path, ...options }, FORMAT_NAME));\n    }\n\n    static OUTPUT_JSON = OUTPUT_JSON;\n    static OUTPUT_METADATA = OUTPUT_METADATA;\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([ \"sm_hi\", \"sm_lo\", \"sm_depth\" ]);\n    static outputTypes = Object.freeze([ OUTPUT_JSON, OUTPUT_METADATA ]);\n    static debugOutputTypes = Object.freeze([ OUTPUT_RAW ]);\n\n}\n\nexport default CjsHlslFormat;\n"],"names":["FORMAT_NAME","CjsHlslFormat","DEFAULT_VALUES","emit","source","permutation","classes","constructor","options","SetValues","values","normalizeValues","GetValues","SetClasses","SetClass","type","Class","undefined","validateClassKey","validateClass","GetClass","HasClass","Read","input","readWithValues","Inspect","inspectWithValues","ToJSON","value","toJsonValue","isSupported","bytes","toBytes","HlslEffectRes","DoLoad","read","inspect","toJSON","readFile","path","TypeError","OUTPUT_JSON","OUTPUT_METADATA","OUTPUT_RAW","CLASS_KEYS","Object","freeze","mediaTypes","inputTypes","outputTypes","debugOutputTypes"],"mappings":"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"}

package/dist/formats/hlsl/core/HlslBinaryUtils.js

@@ -0,0 +1,15 @@
+/**
+ * Reinterprets a little-endian uint32 annotation payload as a float32.
+ *
+ * @param {number} value Unsigned 32-bit integer containing float bits.
+ * @returns {number} Float value represented by the same bits.
+ */
+function cjsUint32ToFloat32(value) {
+  const bytes = new Uint8Array(4);
+  const view = new DataView(bytes.buffer);
+  view.setUint32(0, value >>> 0, true);
+  return view.getFloat32(0, true);
+}
+
+export { cjsUint32ToFloat32 };
+//# sourceMappingURL=HlslBinaryUtils.js.map

package/dist/formats/hlsl/core/HlslBinaryUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HlslBinaryUtils.js","sources":["../../../../../src/formats/hlsl/core/HlslBinaryUtils.js"],"sourcesContent":["/**\n * Reinterprets a little-endian uint32 annotation payload as a float32.\n *\n * @param {number} value Unsigned 32-bit integer containing float bits.\n * @returns {number} Float value represented by the same bits.\n */\nexport function cjsUint32ToFloat32(value)\n{\n    const bytes = new Uint8Array(4);\n    const view = new DataView(bytes.buffer);\n    view.setUint32(0, value >>> 0, true);\n    return view.getFloat32(0, true);\n}\n"],"names":["cjsUint32ToFloat32","value","bytes","Uint8Array","view","DataView","buffer","setUint32","getFloat32"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACO,SAASA,kBAAkBA,CAACC,KAAK,EACxC;AACI,EAAA,MAAMC,KAAK,GAAG,IAAIC,UAAU,CAAC,CAAC,CAAC;EAC/B,MAAMC,IAAI,GAAG,IAAIC,QAAQ,CAACH,KAAK,CAACI,MAAM,CAAC;EACvCF,IAAI,CAACG,SAAS,CAAC,CAAC,EAAEN,KAAK,KAAK,CAAC,EAAE,IAAI,CAAC;AACpC,EAAA,OAAOG,IAAI,CAACI,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC;AACnC;;;;"}

package/dist/formats/hlsl/core/HlslEffectReadError.js

@@ -0,0 +1,19 @@
+/**
+ * Error raised when a Carbon/Trinity effect payload cannot be decoded safely.
+ */
+class HlslEffectReadError extends Error {
+  /**
+  * Creates an effect-read error with structured location details.
+  *
+  * @param {string} message Human-readable failure reason.
+  * @param {object} [details] Extra reader state such as source, offset, or size.
+  */
+  constructor(message, details = {}) {
+    super(message);
+    this.name = "HlslEffectReadError";
+    this.details = details;
+  }
+}
+
+export { HlslEffectReadError };
+//# sourceMappingURL=HlslEffectReadError.js.map

package/dist/formats/hlsl/core/HlslEffectReadError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HlslEffectReadError.js","sources":["../../../../../src/formats/hlsl/core/HlslEffectReadError.js"],"sourcesContent":["/**\n * Error raised when a Carbon/Trinity effect payload cannot be decoded safely.\n */\nexport class HlslEffectReadError extends Error\n{\n    /**\n   * Creates an effect-read error with structured location details.\n   *\n   * @param {string} message Human-readable failure reason.\n   * @param {object} [details] Extra reader state such as source, offset, or size.\n   */\n    constructor(message, details = {})\n    {\n        super(message);\n        this.name = \"HlslEffectReadError\";\n        this.details = details;\n    }\n}\n"],"names":["HlslEffectReadError","Error","constructor","message","details","name"],"mappings":"AAAA;AACA;AACA;AACO,MAAMA,mBAAmB,SAASC,KAAK,CAC9C;AACI;AACJ;AACA;AACA;AACA;AACA;AACIC,EAAAA,WAAWA,CAACC,OAAO,EAAEC,OAAO,GAAG,EAAE,EACjC;IACI,KAAK,CAACD,OAAO,CAAC;IACd,IAAI,CAACE,IAAI,GAAG,qBAAqB;IACjC,IAAI,CAACD,OAAO,GAAGA,OAAO;AAC1B,EAAA;AACJ;;;;"}

package/dist/formats/hlsl/core/HlslEffectStateManager.js

@@ -0,0 +1,130 @@
+import { HlslRenderStateSetup } from './HlslRenderStateSetup.js';
+
+/**
+ * In-memory JavaScript substitute for Carbon's effect state manager registry.
+ */
+class HlslEffectStateManager {
+  /**
+  * Creates empty registries for shaders, programs, render states, and libraries.
+  */
+  constructor() {
+    this._nextShader = 1;
+    this._nextProgram = 1;
+    this._nextRenderState = 1;
+    this._nextLibrary = 1;
+    this.shaders = new Map();
+    this.shaderPrograms = new Map();
+    this.renderStates = new Map();
+    this.shaderLibraries = new Map();
+  }
+
+  /**
+  * Registers a shader stage payload and returns a stable numeric handle.
+  *
+  * @param {number} stageType Trinity shader stage enum value.
+  * @param {object} bytecode Captured shader bytecode.
+  * @param {object} signature Stage signature metadata.
+  * @param {string} [effectName] Source effect name or path.
+  * @returns {number} Shader handle.
+  */
+  RegisterShader(stageType, bytecode, signature, effectName = "") {
+    const handle = this._nextShader++;
+    this.shaders.set(handle, {
+      stageType,
+      bytecode,
+      signature,
+      effectName
+    });
+    return handle;
+  }
+
+  /**
+  * Registers a shader program from one or more shader handles.
+  *
+  * @param {number[]} shaderHandles Shader handles in effect stage order.
+  * @param {number} [stageCount] Number of active stage handles to use.
+  * @returns {number} Shader program handle.
+  */
+  RegisterShaderProgram(shaderHandles, stageCount = shaderHandles.length) {
+    const handle = this._nextProgram++;
+    this.shaderPrograms.set(handle, {
+      shaderHandles: shaderHandles.slice(0, stageCount),
+      stageCount
+    });
+    return handle;
+  }
+
+  /**
+  * Registers a program override pairing for Carbon-compatible call sites.
+  *
+  * @param {number} program Base shader program handle.
+  * @param {number} overrideProgram Override shader program handle.
+  * @returns {number} Override program handle.
+  */
+  RegisterShaderProgramOverride(program, overrideProgram) {
+    const handle = this._nextProgram++;
+    this.shaderPrograms.set(handle, {
+      program,
+      overrideProgram,
+      isOverride: true
+    });
+    return handle;
+  }
+
+  /**
+  * Registers a render-state setup and returns its handle.
+  *
+  * @param {HlslRenderStateSetup|Map<number, number>|object} states Render-state setup.
+  * @returns {number} Render-state handle.
+  */
+  RegisterRenderStateSetup(states) {
+    const handle = this._nextRenderState++;
+    this.renderStates.set(handle, states instanceof HlslRenderStateSetup ? states : new HlslRenderStateSetup(states));
+    return handle;
+  }
+
+  /**
+  * Registers a DXIL/DXBC library bytecode payload and returns its handle.
+  *
+  * @param {object} bytecode Captured shader-library bytecode.
+  * @returns {number} Shader library handle.
+  */
+  RegisterShaderLibrary(bytecode) {
+    const handle = this._nextLibrary++;
+    this.shaderLibraries.set(handle, bytecode);
+    return handle;
+  }
+
+  /**
+  * Looks up a registered shader by handle.
+  *
+  * @param {number} handle Shader handle.
+  * @returns {object|null} Registered shader metadata or null.
+  */
+  GetShader(handle) {
+    return this.shaders.get(handle) || null;
+  }
+
+  /**
+  * Looks up a registered shader program by handle.
+  *
+  * @param {number} handle Shader program handle.
+  * @returns {object|null} Registered program metadata or null.
+  */
+  GetShaderProgram(handle) {
+    return this.shaderPrograms.get(handle) || null;
+  }
+
+  /**
+  * Looks up a registered render-state setup by handle.
+  *
+  * @param {number} handle Render-state handle.
+  * @returns {HlslRenderStateSetup|null} Registered render-state setup or null.
+  */
+  GetRenderStateSetup(handle) {
+    return this.renderStates.get(handle) || null;
+  }
+}
+
+export { HlslEffectStateManager };
+//# sourceMappingURL=HlslEffectStateManager.js.map