@carbonenginejs/runtime-resource 0.10.0 → 0.11.1

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

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

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

@@ -0,0 +1,266 @@
+import { HlslEffectReadError } from './HlslEffectReadError.js';
+import { asUint8Array } from '@carbonenginejs/runtime-utils/bytes';
+
+const textDecoder = new TextDecoder("utf-8", {
+  fatal: false
+});
+
+/**
+ * Little-endian binary reader for Carbon/Trinity compiled effect data.
+ */
+class HlslReader {
+  /**
+  * Creates a reader over a byte payload and optional shared string table.
+  *
+  * @param {ArrayBuffer|ArrayBufferView|Uint8Array} bytes Source payload.
+  * @param {object} [options] Reader bounds and metadata.
+  * @param {number} [options.offset] Initial byte offset.
+  * @param {number} [options.end] Exclusive end offset.
+  * @param {string} [options.source] Source name used in error details.
+  * @param {ArrayBuffer|ArrayBufferView|Uint8Array} [options.stringTable] Effect string table.
+  * @param {number} [options.stringTableSize] Valid string-table byte count.
+  */
+  constructor(bytes, options = {}) {
+    this.bytes = asUint8Array(bytes);
+    this.view = new DataView(this.bytes.buffer, this.bytes.byteOffset, this.bytes.byteLength);
+    this.offset = Number(options.offset) || 0;
+    this.end = Number.isInteger(options.end) ? options.end : this.bytes.length;
+    this.source = options.source || "memory";
+    this.stringTable = options.stringTable ? asUint8Array(options.stringTable) : null;
+    this.stringTableSize = Number.isInteger(options.stringTableSize) ? options.stringTableSize : this.stringTable ? this.stringTable.length : 0;
+  }
+
+  /**
+  * Attaches or replaces the effect string table used by string and blob reads.
+  *
+  * @param {ArrayBuffer|ArrayBufferView|Uint8Array} bytes String-table bytes.
+  * @param {number|null} [size] Valid string-table byte count.
+  */
+  setStringTable(bytes, size = null) {
+    this.stringTable = asUint8Array(bytes);
+    this.stringTableSize = Number.isInteger(size) ? size : this.stringTable.length;
+  }
+
+  /**
+  * Returns the unread byte count inside the configured reader bounds.
+  *
+  * @returns {number} Remaining bytes.
+  */
+  get remaining() {
+    return this.end - this.offset;
+  }
+
+  /**
+  * Advances the reader by a fixed number of bytes.
+  *
+  * @param {number} size Byte count to skip.
+  */
+  skip(size) {
+    this._require(size);
+    this.offset += size;
+  }
+
+  /**
+  * Reads a byte range from the main payload.
+  *
+  * @param {number} size Byte count to read.
+  * @returns {Uint8Array} View over the read bytes.
+  */
+  readRaw(size) {
+    this._require(size);
+    const start = this.offset;
+    this.offset += size;
+    return this.bytes.subarray(start, start + size);
+  }
+
+  /**
+  * Reads an unsigned 8-bit integer.
+  *
+  * @returns {number} Integer value.
+  */
+  readUint8() {
+    this._require(1);
+    const value = this.view.getUint8(this.offset);
+    this.offset += 1;
+    return value;
+  }
+
+  /**
+  * Reads a little-endian unsigned 16-bit integer.
+  *
+  * @returns {number} Integer value.
+  */
+  readUint16() {
+    this._require(2);
+    const value = this.view.getUint16(this.offset, true);
+    this.offset += 2;
+    return value;
+  }
+
+  /**
+  * Reads a little-endian unsigned 32-bit integer.
+  *
+  * @returns {number} Integer value.
+  */
+  readUint32() {
+    this._require(4);
+    const value = this.view.getUint32(this.offset, true);
+    this.offset += 4;
+    return value;
+  }
+
+  /**
+  * Reads a little-endian signed 32-bit integer.
+  *
+  * @returns {number} Integer value.
+  */
+  readInt32() {
+    this._require(4);
+    const value = this.view.getInt32(this.offset, true);
+    this.offset += 4;
+    return value;
+  }
+
+  /**
+  * Reads a little-endian 32-bit float.
+  *
+  * @returns {number} Float value.
+  */
+  readFloat32() {
+    this._require(4);
+    const value = this.view.getFloat32(this.offset, true);
+    this.offset += 4;
+    return value;
+  }
+
+  /**
+  * Reads Carbon's byte-sized boolean encoding.
+  *
+  * @returns {boolean} Boolean value.
+  */
+  readBool() {
+    return this.readUint8() !== 0;
+  }
+
+  /**
+  * Reads a string-table offset and resolves it to a UTF-8 string.
+  *
+  * @param {number} [sizeHint] Optional maximum byte span for bounds checking.
+  * @returns {string} Decoded string.
+  */
+  readString(sizeHint = 0) {
+    const offset = this.readUint32();
+    return this.readStringAt(offset, sizeHint);
+  }
+
+  /**
+  * Reads an optional string-table offset, returning null for zero-length fields.
+  *
+  * @param {number} length Source field length.
+  * @returns {string|null} Decoded string or null.
+  */
+  readStringOptional(length) {
+    const offset = this.readUint32();
+    if (length === 0) {
+      return null;
+    }
+    return this.readStringAt(offset, length);
+  }
+
+  /**
+  * Reads a string-table blob offset and returns the referenced byte range.
+  *
+  * @param {number} size Blob byte count.
+  * @returns {{offset:number,bytes:Uint8Array}} Blob location and bytes.
+  */
+  readTableBlob(size) {
+    const offset = this.readUint32();
+    this._requireStringTable(offset, size);
+    return {
+      offset,
+      bytes: this.stringTable.subarray(offset, offset + size)
+    };
+  }
+
+  /**
+  * Reads a possibly empty string-table blob reference.
+  *
+  * @param {number} size Blob byte count.
+  * @returns {{offset:number,bytes:Uint8Array}} Blob location and bytes.
+  */
+  readTableBlobOptional(size) {
+    const offset = this.readUint32();
+    if (size === 0) {
+      return {
+        offset,
+        bytes: new Uint8Array(0)
+      };
+    }
+    this._requireStringTable(offset, size);
+    return {
+      offset,
+      bytes: this.stringTable.subarray(offset, offset + size)
+    };
+  }
+
+  /**
+  * Resolves a string table offset to a null-terminated UTF-8 string.
+  *
+  * @param {number} offset String-table byte offset.
+  * @param {number} [sizeHint] Optional maximum byte span for bounds checking.
+  * @returns {string} Decoded string.
+  */
+  readStringAt(offset, sizeHint = 0) {
+    this._requireStringTable(offset, sizeHint);
+    let end = offset;
+    while (end < this.stringTableSize && this.stringTable[end] !== 0) {
+      end += 1;
+    }
+    return textDecoder.decode(this.stringTable.subarray(offset, end));
+  }
+
+  /**
+  * Ensures the requested read fits inside the configured payload bounds.
+  *
+  * @param {number} size Requested byte count.
+  * @private
+  */
+  _require(size) {
+    if (!Number.isInteger(size) || size < 0 || this.offset + size > this.end) {
+      throw new HlslEffectReadError("Unexpected end of effect data", {
+        source: this.source,
+        offset: this.offset,
+        requested: size,
+        end: this.end
+      });
+    }
+  }
+
+  /**
+  * Ensures a string-table offset and optional span are valid.
+  *
+  * @param {number} offset String-table byte offset.
+  * @param {number} [sizeHint] Optional byte span for bounds checking.
+  * @private
+  */
+  _requireStringTable(offset, sizeHint = 0) {
+    const size = Number(sizeHint) || 0;
+    if (!this.stringTable) {
+      throw new HlslEffectReadError("Missing effect string table", {
+        source: this.source,
+        offset
+      });
+    }
+    if (!Number.isInteger(offset) || offset < 0 || offset >= this.stringTableSize || offset + size > this.stringTableSize) {
+      throw new HlslEffectReadError("Invalid string-table offset", {
+        source: this.source,
+        offset,
+        sizeHint: size,
+        stringTableSize: this.stringTableSize
+      });
+    }
+  }
+}
+
+export { HlslReader };
+//# sourceMappingURL=HlslReader.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HlslReader.js","sources":["../../../../../src/formats/hlsl/core/HlslReader.js"],"sourcesContent":["import { HlslEffectReadError } from \"./HlslEffectReadError.js\";\nimport { asUint8Array } from \"@carbonenginejs/runtime-utils/bytes\";\n\nconst textDecoder = new TextDecoder(\"utf-8\", { fatal: false });\n\n/**\n * Little-endian binary reader for Carbon/Trinity compiled effect data.\n */\nexport class HlslReader\n{\n    /**\n   * Creates a reader over a byte payload and optional shared string table.\n   *\n   * @param {ArrayBuffer|ArrayBufferView|Uint8Array} bytes Source payload.\n   * @param {object} [options] Reader bounds and metadata.\n   * @param {number} [options.offset] Initial byte offset.\n   * @param {number} [options.end] Exclusive end offset.\n   * @param {string} [options.source] Source name used in error details.\n   * @param {ArrayBuffer|ArrayBufferView|Uint8Array} [options.stringTable] Effect string table.\n   * @param {number} [options.stringTableSize] Valid string-table byte count.\n   */\n    constructor(bytes, options = {})\n    {\n        this.bytes = asUint8Array(bytes);\n        this.view = new DataView(this.bytes.buffer, this.bytes.byteOffset, this.bytes.byteLength);\n        this.offset = Number(options.offset) || 0;\n        this.end = Number.isInteger(options.end) ? options.end : this.bytes.length;\n        this.source = options.source || \"memory\";\n        this.stringTable = options.stringTable ? asUint8Array(options.stringTable) : null;\n        this.stringTableSize = Number.isInteger(options.stringTableSize)\n            ? options.stringTableSize\n            : (this.stringTable ? this.stringTable.length : 0);\n    }\n\n    /**\n   * Attaches or replaces the effect string table used by string and blob reads.\n   *\n   * @param {ArrayBuffer|ArrayBufferView|Uint8Array} bytes String-table bytes.\n   * @param {number|null} [size] Valid string-table byte count.\n   */\n    setStringTable(bytes, size = null)\n    {\n        this.stringTable = asUint8Array(bytes);\n        this.stringTableSize = Number.isInteger(size) ? size : this.stringTable.length;\n    }\n\n    /**\n   * Returns the unread byte count inside the configured reader bounds.\n   *\n   * @returns {number} Remaining bytes.\n   */\n    get remaining()\n    {\n        return this.end - this.offset;\n    }\n\n    /**\n   * Advances the reader by a fixed number of bytes.\n   *\n   * @param {number} size Byte count to skip.\n   */\n    skip(size)\n    {\n        this._require(size);\n        this.offset += size;\n    }\n\n    /**\n   * Reads a byte range from the main payload.\n   *\n   * @param {number} size Byte count to read.\n   * @returns {Uint8Array} View over the read bytes.\n   */\n    readRaw(size)\n    {\n        this._require(size);\n        const start = this.offset;\n        this.offset += size;\n        return this.bytes.subarray(start, start + size);\n    }\n\n    /**\n   * Reads an unsigned 8-bit integer.\n   *\n   * @returns {number} Integer value.\n   */\n    readUint8()\n    {\n        this._require(1);\n        const value = this.view.getUint8(this.offset);\n        this.offset += 1;\n        return value;\n    }\n\n    /**\n   * Reads a little-endian unsigned 16-bit integer.\n   *\n   * @returns {number} Integer value.\n   */\n    readUint16()\n    {\n        this._require(2);\n        const value = this.view.getUint16(this.offset, true);\n        this.offset += 2;\n        return value;\n    }\n\n    /**\n   * Reads a little-endian unsigned 32-bit integer.\n   *\n   * @returns {number} Integer value.\n   */\n    readUint32()\n    {\n        this._require(4);\n        const value = this.view.getUint32(this.offset, true);\n        this.offset += 4;\n        return value;\n    }\n\n    /**\n   * Reads a little-endian signed 32-bit integer.\n   *\n   * @returns {number} Integer value.\n   */\n    readInt32()\n    {\n        this._require(4);\n        const value = this.view.getInt32(this.offset, true);\n        this.offset += 4;\n        return value;\n    }\n\n    /**\n   * Reads a little-endian 32-bit float.\n   *\n   * @returns {number} Float value.\n   */\n    readFloat32()\n    {\n        this._require(4);\n        const value = this.view.getFloat32(this.offset, true);\n        this.offset += 4;\n        return value;\n    }\n\n    /**\n   * Reads Carbon's byte-sized boolean encoding.\n   *\n   * @returns {boolean} Boolean value.\n   */\n    readBool()\n    {\n        return this.readUint8() !== 0;\n    }\n\n    /**\n   * Reads a string-table offset and resolves it to a UTF-8 string.\n   *\n   * @param {number} [sizeHint] Optional maximum byte span for bounds checking.\n   * @returns {string} Decoded string.\n   */\n    readString(sizeHint = 0)\n    {\n        const offset = this.readUint32();\n        return this.readStringAt(offset, sizeHint);\n    }\n\n    /**\n   * Reads an optional string-table offset, returning null for zero-length fields.\n   *\n   * @param {number} length Source field length.\n   * @returns {string|null} Decoded string or null.\n   */\n    readStringOptional(length)\n    {\n        const offset = this.readUint32();\n        if (length === 0)\n        {\n            return null;\n        }\n        return this.readStringAt(offset, length);\n    }\n\n    /**\n   * Reads a string-table blob offset and returns the referenced byte range.\n   *\n   * @param {number} size Blob byte count.\n   * @returns {{offset:number,bytes:Uint8Array}} Blob location and bytes.\n   */\n    readTableBlob(size)\n    {\n        const offset = this.readUint32();\n        this._requireStringTable(offset, size);\n        return {\n            offset,\n            bytes: this.stringTable.subarray(offset, offset + size)\n        };\n    }\n\n    /**\n   * Reads a possibly empty string-table blob reference.\n   *\n   * @param {number} size Blob byte count.\n   * @returns {{offset:number,bytes:Uint8Array}} Blob location and bytes.\n   */\n    readTableBlobOptional(size)\n    {\n        const offset = this.readUint32();\n        if (size === 0)\n        {\n            return {\n                offset,\n                bytes: new Uint8Array(0)\n            };\n        }\n        this._requireStringTable(offset, size);\n        return {\n            offset,\n            bytes: this.stringTable.subarray(offset, offset + size)\n        };\n    }\n\n    /**\n   * Resolves a string table offset to a null-terminated UTF-8 string.\n   *\n   * @param {number} offset String-table byte offset.\n   * @param {number} [sizeHint] Optional maximum byte span for bounds checking.\n   * @returns {string} Decoded string.\n   */\n    readStringAt(offset, sizeHint = 0)\n    {\n        this._requireStringTable(offset, sizeHint);\n        let end = offset;\n        while (end < this.stringTableSize && this.stringTable[end] !== 0)\n        {\n            end += 1;\n        }\n        return textDecoder.decode(this.stringTable.subarray(offset, end));\n    }\n\n    /**\n   * Ensures the requested read fits inside the configured payload bounds.\n   *\n   * @param {number} size Requested byte count.\n   * @private\n   */\n    _require(size)\n    {\n        if (!Number.isInteger(size) || size < 0 || this.offset + size > this.end)\n        {\n            throw new HlslEffectReadError(\"Unexpected end of effect data\", {\n                source: this.source,\n                offset: this.offset,\n                requested: size,\n                end: this.end\n            });\n        }\n    }\n\n    /**\n   * Ensures a string-table offset and optional span are valid.\n   *\n   * @param {number} offset String-table byte offset.\n   * @param {number} [sizeHint] Optional byte span for bounds checking.\n   * @private\n   */\n    _requireStringTable(offset, sizeHint = 0)\n    {\n        const size = Number(sizeHint) || 0;\n        if (!this.stringTable)\n        {\n            throw new HlslEffectReadError(\"Missing effect string table\", {\n                source: this.source,\n                offset\n            });\n        }\n        if (!Number.isInteger(offset) || offset < 0 || offset >= this.stringTableSize || offset + size > this.stringTableSize)\n        {\n            throw new HlslEffectReadError(\"Invalid string-table offset\", {\n                source: this.source,\n                offset,\n                sizeHint: size,\n                stringTableSize: this.stringTableSize\n            });\n        }\n    }\n}\n"],"names":["textDecoder","TextDecoder","fatal","HlslReader","constructor","bytes","options","asUint8Array","view","DataView","buffer","byteOffset","byteLength","offset","Number","end","isInteger","length","source","stringTable","stringTableSize","setStringTable","size","remaining","skip","_require","readRaw","start","subarray","readUint8","value","getUint8","readUint16","getUint16","readUint32","getUint32","readInt32","getInt32","readFloat32","getFloat32","readBool","readString","sizeHint","readStringAt","readStringOptional","readTableBlob","_requireStringTable","readTableBlobOptional","Uint8Array","decode","HlslEffectReadError","requested"],"mappings":";;;AAGA,MAAMA,WAAW,GAAG,IAAIC,WAAW,CAAC,OAAO,EAAE;AAAEC,EAAAA,KAAK,EAAE;AAAM,CAAC,CAAC;;AAE9D;AACA;AACA;AACO,MAAMC,UAAU,CACvB;AACI;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACIC,EAAAA,WAAWA,CAACC,KAAK,EAAEC,OAAO,GAAG,EAAE,EAC/B;AACI,IAAA,IAAI,CAACD,KAAK,GAAGE,YAAY,CAACF,KAAK,CAAC;IAChC,IAAI,CAACG,IAAI,GAAG,IAAIC,QAAQ,CAAC,IAAI,CAACJ,KAAK,CAACK,MAAM,EAAE,IAAI,CAACL,KAAK,CAACM,UAAU,EAAE,IAAI,CAACN,KAAK,CAACO,UAAU,CAAC;IACzF,IAAI,CAACC,MAAM,GAAGC,MAAM,CAACR,OAAO,CAACO,MAAM,CAAC,IAAI,CAAC;IACzC,IAAI,CAACE,GAAG,GAAGD,MAAM,CAACE,SAAS,CAACV,OAAO,CAACS,GAAG,CAAC,GAAGT,OAAO,CAACS,GAAG,GAAG,IAAI,CAACV,KAAK,CAACY,MAAM;AAC1E,IAAA,IAAI,CAACC,MAAM,GAAGZ,OAAO,CAACY,MAAM,IAAI,QAAQ;AACxC,IAAA,IAAI,CAACC,WAAW,GAAGb,OAAO,CAACa,WAAW,GAAGZ,YAAY,CAACD,OAAO,CAACa,WAAW,CAAC,GAAG,IAAI;IACjF,IAAI,CAACC,eAAe,GAAGN,MAAM,CAACE,SAAS,CAACV,OAAO,CAACc,eAAe,CAAC,GAC1Dd,OAAO,CAACc,eAAe,GACtB,IAAI,CAACD,WAAW,GAAG,IAAI,CAACA,WAAW,CAACF,MAAM,GAAG,CAAE;AAC1D,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACII,EAAAA,cAAcA,CAAChB,KAAK,EAAEiB,IAAI,GAAG,IAAI,EACjC;AACI,IAAA,IAAI,CAACH,WAAW,GAAGZ,YAAY,CAACF,KAAK,CAAC;AACtC,IAAA,IAAI,CAACe,eAAe,GAAGN,MAAM,CAACE,SAAS,CAACM,IAAI,CAAC,GAAGA,IAAI,GAAG,IAAI,CAACH,WAAW,CAACF,MAAM;AAClF,EAAA;;AAEA;AACJ;AACA;AACA;AACA;EACI,IAAIM,SAASA,GACb;AACI,IAAA,OAAO,IAAI,CAACR,GAAG,GAAG,IAAI,CAACF,MAAM;AACjC,EAAA;;AAEA;AACJ;AACA;AACA;AACA;EACIW,IAAIA,CAACF,IAAI,EACT;AACI,IAAA,IAAI,CAACG,QAAQ,CAACH,IAAI,CAAC;IACnB,IAAI,CAACT,MAAM,IAAIS,IAAI;AACvB,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;EACII,OAAOA,CAACJ,IAAI,EACZ;AACI,IAAA,IAAI,CAACG,QAAQ,CAACH,IAAI,CAAC;AACnB,IAAA,MAAMK,KAAK,GAAG,IAAI,CAACd,MAAM;IACzB,IAAI,CAACA,MAAM,IAAIS,IAAI;IACnB,OAAO,IAAI,CAACjB,KAAK,CAACuB,QAAQ,CAACD,KAAK,EAAEA,KAAK,GAAGL,IAAI,CAAC;AACnD,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACIO,EAAAA,SAASA,GACT;AACI,IAAA,IAAI,CAACJ,QAAQ,CAAC,CAAC,CAAC;IAChB,MAAMK,KAAK,GAAG,IAAI,CAACtB,IAAI,CAACuB,QAAQ,CAAC,IAAI,CAAClB,MAAM,CAAC;IAC7C,IAAI,CAACA,MAAM,IAAI,CAAC;AAChB,IAAA,OAAOiB,KAAK;AAChB,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACIE,EAAAA,UAAUA,GACV;AACI,IAAA,IAAI,CAACP,QAAQ,CAAC,CAAC,CAAC;AAChB,IAAA,MAAMK,KAAK,GAAG,IAAI,CAACtB,IAAI,CAACyB,SAAS,CAAC,IAAI,CAACpB,MAAM,EAAE,IAAI,CAAC;IACpD,IAAI,CAACA,MAAM,IAAI,CAAC;AAChB,IAAA,OAAOiB,KAAK;AAChB,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACII,EAAAA,UAAUA,GACV;AACI,IAAA,IAAI,CAACT,QAAQ,CAAC,CAAC,CAAC;AAChB,IAAA,MAAMK,KAAK,GAAG,IAAI,CAACtB,IAAI,CAAC2B,SAAS,CAAC,IAAI,CAACtB,MAAM,EAAE,IAAI,CAAC;IACpD,IAAI,CAACA,MAAM,IAAI,CAAC;AAChB,IAAA,OAAOiB,KAAK;AAChB,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACIM,EAAAA,SAASA,GACT;AACI,IAAA,IAAI,CAACX,QAAQ,CAAC,CAAC,CAAC;AAChB,IAAA,MAAMK,KAAK,GAAG,IAAI,CAACtB,IAAI,CAAC6B,QAAQ,CAAC,IAAI,CAACxB,MAAM,EAAE,IAAI,CAAC;IACnD,IAAI,CAACA,MAAM,IAAI,CAAC;AAChB,IAAA,OAAOiB,KAAK;AAChB,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACIQ,EAAAA,WAAWA,GACX;AACI,IAAA,IAAI,CAACb,QAAQ,CAAC,CAAC,CAAC;AAChB,IAAA,MAAMK,KAAK,GAAG,IAAI,CAACtB,IAAI,CAAC+B,UAAU,CAAC,IAAI,CAAC1B,MAAM,EAAE,IAAI,CAAC;IACrD,IAAI,CAACA,MAAM,IAAI,CAAC;AAChB,IAAA,OAAOiB,KAAK;AAChB,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACIU,EAAAA,QAAQA,GACR;AACI,IAAA,OAAO,IAAI,CAACX,SAAS,EAAE,KAAK,CAAC;AACjC,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACIY,EAAAA,UAAUA,CAACC,QAAQ,GAAG,CAAC,EACvB;AACI,IAAA,MAAM7B,MAAM,GAAG,IAAI,CAACqB,UAAU,EAAE;AAChC,IAAA,OAAO,IAAI,CAACS,YAAY,CAAC9B,MAAM,EAAE6B,QAAQ,CAAC;AAC9C,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;EACIE,kBAAkBA,CAAC3B,MAAM,EACzB;AACI,IAAA,MAAMJ,MAAM,GAAG,IAAI,CAACqB,UAAU,EAAE;IAChC,IAAIjB,MAAM,KAAK,CAAC,EAChB;AACI,MAAA,OAAO,IAAI;AACf,IAAA;AACA,IAAA,OAAO,IAAI,CAAC0B,YAAY,CAAC9B,MAAM,EAAEI,MAAM,CAAC;AAC5C,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;EACI4B,aAAaA,CAACvB,IAAI,EAClB;AACI,IAAA,MAAMT,MAAM,GAAG,IAAI,CAACqB,UAAU,EAAE;AAChC,IAAA,IAAI,CAACY,mBAAmB,CAACjC,MAAM,EAAES,IAAI,CAAC;IACtC,OAAO;MACHT,MAAM;MACNR,KAAK,EAAE,IAAI,CAACc,WAAW,CAACS,QAAQ,CAACf,MAAM,EAAEA,MAAM,GAAGS,IAAI;KACzD;AACL,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;EACIyB,qBAAqBA,CAACzB,IAAI,EAC1B;AACI,IAAA,MAAMT,MAAM,GAAG,IAAI,CAACqB,UAAU,EAAE;IAChC,IAAIZ,IAAI,KAAK,CAAC,EACd;MACI,OAAO;QACHT,MAAM;AACNR,QAAAA,KAAK,EAAE,IAAI2C,UAAU,CAAC,CAAC;OAC1B;AACL,IAAA;AACA,IAAA,IAAI,CAACF,mBAAmB,CAACjC,MAAM,EAAES,IAAI,CAAC;IACtC,OAAO;MACHT,MAAM;MACNR,KAAK,EAAE,IAAI,CAACc,WAAW,CAACS,QAAQ,CAACf,MAAM,EAAEA,MAAM,GAAGS,IAAI;KACzD;AACL,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACIqB,EAAAA,YAAYA,CAAC9B,MAAM,EAAE6B,QAAQ,GAAG,CAAC,EACjC;AACI,IAAA,IAAI,CAACI,mBAAmB,CAACjC,MAAM,EAAE6B,QAAQ,CAAC;IAC1C,IAAI3B,GAAG,GAAGF,MAAM;AAChB,IAAA,OAAOE,GAAG,GAAG,IAAI,CAACK,eAAe,IAAI,IAAI,CAACD,WAAW,CAACJ,GAAG,CAAC,KAAK,CAAC,EAChE;AACIA,MAAAA,GAAG,IAAI,CAAC;AACZ,IAAA;AACA,IAAA,OAAOf,WAAW,CAACiD,MAAM,CAAC,IAAI,CAAC9B,WAAW,CAACS,QAAQ,CAACf,MAAM,EAAEE,GAAG,CAAC,CAAC;AACrE,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;EACIU,QAAQA,CAACH,IAAI,EACb;IACI,IAAI,CAACR,MAAM,CAACE,SAAS,CAACM,IAAI,CAAC,IAAIA,IAAI,GAAG,CAAC,IAAI,IAAI,CAACT,MAAM,GAAGS,IAAI,GAAG,IAAI,CAACP,GAAG,EACxE;AACI,MAAA,MAAM,IAAImC,mBAAmB,CAAC,+BAA+B,EAAE;QAC3DhC,MAAM,EAAE,IAAI,CAACA,MAAM;QACnBL,MAAM,EAAE,IAAI,CAACA,MAAM;AACnBsC,QAAAA,SAAS,EAAE7B,IAAI;QACfP,GAAG,EAAE,IAAI,CAACA;AACd,OAAC,CAAC;AACN,IAAA;AACJ,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACI+B,EAAAA,mBAAmBA,CAACjC,MAAM,EAAE6B,QAAQ,GAAG,CAAC,EACxC;AACI,IAAA,MAAMpB,IAAI,GAAGR,MAAM,CAAC4B,QAAQ,CAAC,IAAI,CAAC;AAClC,IAAA,IAAI,CAAC,IAAI,CAACvB,WAAW,EACrB;AACI,MAAA,MAAM,IAAI+B,mBAAmB,CAAC,6BAA6B,EAAE;QACzDhC,MAAM,EAAE,IAAI,CAACA,MAAM;AACnBL,QAAAA;AACJ,OAAC,CAAC;AACN,IAAA;IACA,IAAI,CAACC,MAAM,CAACE,SAAS,CAACH,MAAM,CAAC,IAAIA,MAAM,GAAG,CAAC,IAAIA,MAAM,IAAI,IAAI,CAACO,eAAe,IAAIP,MAAM,GAAGS,IAAI,GAAG,IAAI,CAACF,eAAe,EACrH;AACI,MAAA,MAAM,IAAI8B,mBAAmB,CAAC,6BAA6B,EAAE;QACzDhC,MAAM,EAAE,IAAI,CAACA,MAAM;QACnBL,MAAM;AACN6B,QAAAA,QAAQ,EAAEpB,IAAI;QACdF,eAAe,EAAE,IAAI,CAACA;AAC1B,OAAC,CAAC;AACN,IAAA;AACJ,EAAA;AACJ;;;;"}

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

@@ -0,0 +1,37 @@
+/**
+ * JavaScript mirror of a registered Carbon render-state setup.
+ */
+class HlslRenderStateSetup {
+  /**
+  * Creates a render-state table from a Map or plain object.
+  *
+  * @param {Map<number, number>|object} [states] Render-state key/value pairs.
+  */
+  constructor(states = new Map()) {
+    this.states = states instanceof Map ? new Map(states) : new Map(Object.entries(states || {}).map(([key, value]) => [Number(key), Number(value)]));
+  }
+
+  /**
+  * Returns render states as stable serializable key/value records.
+  *
+  * @returns {{key:number,value:number}[]} Render-state entries.
+  */
+  get entries() {
+    return Array.from(this.states.entries()).map(([key, value]) => ({
+      key,
+      value
+    }));
+  }
+
+  /**
+  * Returns render states in report-friendly form.
+  *
+  * @returns {{key:number,value:number}[]} JSON-safe render-state entries.
+  */
+  toJSON() {
+    return this.entries;
+  }
+}
+
+export { HlslRenderStateSetup };
+//# sourceMappingURL=HlslRenderStateSetup.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HlslRenderStateSetup.js","sources":["../../../../../src/formats/hlsl/core/HlslRenderStateSetup.js"],"sourcesContent":["/**\n * JavaScript mirror of a registered Carbon render-state setup.\n */\nexport class HlslRenderStateSetup\n{\n    /**\n   * Creates a render-state table from a Map or plain object.\n   *\n   * @param {Map<number, number>|object} [states] Render-state key/value pairs.\n   */\n    constructor(states = new Map())\n    {\n        this.states = states instanceof Map\n            ? new Map(states)\n            : new Map(Object.entries(states || {}).map(([ key, value ]) => [ Number(key), Number(value) ]));\n    }\n\n    /**\n   * Returns render states as stable serializable key/value records.\n   *\n   * @returns {{key:number,value:number}[]} Render-state entries.\n   */\n    get entries()\n    {\n        return Array.from(this.states.entries()).map(([ key, value ]) => ({ key, value }));\n    }\n\n    /**\n   * Returns render states in report-friendly form.\n   *\n   * @returns {{key:number,value:number}[]} JSON-safe render-state entries.\n   */\n    toJSON()\n    {\n        return this.entries;\n    }\n}\n"],"names":["HlslRenderStateSetup","constructor","states","Map","Object","entries","map","key","value","Number","Array","from","toJSON"],"mappings":"AAAA;AACA;AACA;AACO,MAAMA,oBAAoB,CACjC;AACI;AACJ;AACA;AACA;AACA;AACIC,EAAAA,WAAWA,CAACC,MAAM,GAAG,IAAIC,GAAG,EAAE,EAC9B;IACI,IAAI,CAACD,MAAM,GAAGA,MAAM,YAAYC,GAAG,GAC7B,IAAIA,GAAG,CAACD,MAAM,CAAC,GACf,IAAIC,GAAG,CAACC,MAAM,CAACC,OAAO,CAACH,MAAM,IAAI,EAAE,CAAC,CAACI,GAAG,CAAC,CAAC,CAAEC,GAAG,EAAEC,KAAK,CAAE,KAAK,CAAEC,MAAM,CAACF,GAAG,CAAC,EAAEE,MAAM,CAACD,KAAK,CAAC,CAAE,CAAC,CAAC;AACvG,EAAA;;AAEA;AACJ;AACA;AACA;AACA;EACI,IAAIH,OAAOA,GACX;IACI,OAAOK,KAAK,CAACC,IAAI,CAAC,IAAI,CAACT,MAAM,CAACG,OAAO,EAAE,CAAC,CAACC,GAAG,CAAC,CAAC,CAAEC,GAAG,EAAEC,KAAK,CAAE,MAAM;MAAED,GAAG;AAAEC,MAAAA;AAAM,KAAC,CAAC,CAAC;AACtF,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACII,EAAAA,MAAMA,GACN;IACI,OAAO,IAAI,CAACP,OAAO;AACvB,EAAA;AACJ;;;;"}

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

@@ -0,0 +1,94 @@
+/**
+ * JavaScript mirror of Carbon's resource-set descriptor builder.
+ */
+class HlslResourceSetDescription {
+  /**
+  * Creates an empty resource-set description for the supplied shader stages.
+  *
+  * @param {number[]} [shaderTypes] Shader stage enum values participating in the set.
+  * @param {object[]} [signatures] Stage signatures read from the effect body.
+  */
+  constructor(shaderTypes = [], signatures = []) {
+    this.shaderTypes = shaderTypes.slice();
+    this.signatures = signatures.slice();
+    this.samplers = [];
+    this.heapViews = [];
+  }
+
+  /**
+  * Records a static sampler binding for a shader register.
+  *
+  * @param {number} stageType Shader stage enum value.
+  * @param {number} registerIndex Register index in the stage signature.
+  * @param {object} sampler Sampler descriptor.
+  */
+  SetSampler(stageType, registerIndex, sampler) {
+    this.samplers.push({
+      stageType,
+      registerIndex,
+      sampler
+    });
+  }
+
+  /**
+  * Marks a shader-resource binding as heap-view based.
+  *
+  * @param {number} stageType Shader stage enum value.
+  * @param {number} registerIndex Register index in the stage signature.
+  */
+  SetSrvHeapView(stageType, registerIndex) {
+    this.heapViews.push({
+      kind: "srv",
+      stageType,
+      registerIndex
+    });
+  }
+
+  /**
+  * Marks an unordered-access binding as heap-view based.
+  *
+  * @param {number} stageType Shader stage enum value.
+  * @param {number} registerIndex Register index in the stage signature.
+  */
+  SetUavHeapView(stageType, registerIndex) {
+    this.heapViews.push({
+      kind: "uav",
+      stageType,
+      registerIndex
+    });
+  }
+
+  /**
+  * Marks a sampler binding as heap-view based.
+  *
+  * @param {number} stageType Shader stage enum value.
+  * @param {number} registerIndex Register index in the stage signature.
+  */
+  SetSamplerHeapView(stageType, registerIndex) {
+    this.heapViews.push({
+      kind: "sampler",
+      stageType,
+      registerIndex
+    });
+  }
+
+  /**
+  * Returns a JSON-safe description of sampler and heap-view metadata.
+  *
+  * @returns {object} Serializable resource-set summary.
+  */
+  toJSON() {
+    return {
+      shaderTypes: this.shaderTypes.slice(),
+      samplers: this.samplers.map(entry => ({
+        ...entry
+      })),
+      heapViews: this.heapViews.map(entry => ({
+        ...entry
+      }))
+    };
+  }
+}
+
+export { HlslResourceSetDescription };
+//# sourceMappingURL=HlslResourceSetDescription.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HlslResourceSetDescription.js","sources":["../../../../../src/formats/hlsl/core/HlslResourceSetDescription.js"],"sourcesContent":["/**\n * JavaScript mirror of Carbon's resource-set descriptor builder.\n */\nexport class HlslResourceSetDescription\n{\n    /**\n   * Creates an empty resource-set description for the supplied shader stages.\n   *\n   * @param {number[]} [shaderTypes] Shader stage enum values participating in the set.\n   * @param {object[]} [signatures] Stage signatures read from the effect body.\n   */\n    constructor(shaderTypes = [], signatures = [])\n    {\n        this.shaderTypes = shaderTypes.slice();\n        this.signatures = signatures.slice();\n        this.samplers = [];\n        this.heapViews = [];\n    }\n\n    /**\n   * Records a static sampler binding for a shader register.\n   *\n   * @param {number} stageType Shader stage enum value.\n   * @param {number} registerIndex Register index in the stage signature.\n   * @param {object} sampler Sampler descriptor.\n   */\n    SetSampler(stageType, registerIndex, sampler)\n    {\n        this.samplers.push({ stageType, registerIndex, sampler });\n    }\n\n    /**\n   * Marks a shader-resource binding as heap-view based.\n   *\n   * @param {number} stageType Shader stage enum value.\n   * @param {number} registerIndex Register index in the stage signature.\n   */\n    SetSrvHeapView(stageType, registerIndex)\n    {\n        this.heapViews.push({ kind: \"srv\", stageType, registerIndex });\n    }\n\n    /**\n   * Marks an unordered-access binding as heap-view based.\n   *\n   * @param {number} stageType Shader stage enum value.\n   * @param {number} registerIndex Register index in the stage signature.\n   */\n    SetUavHeapView(stageType, registerIndex)\n    {\n        this.heapViews.push({ kind: \"uav\", stageType, registerIndex });\n    }\n\n    /**\n   * Marks a sampler binding as heap-view based.\n   *\n   * @param {number} stageType Shader stage enum value.\n   * @param {number} registerIndex Register index in the stage signature.\n   */\n    SetSamplerHeapView(stageType, registerIndex)\n    {\n        this.heapViews.push({ kind: \"sampler\", stageType, registerIndex });\n    }\n\n    /**\n   * Returns a JSON-safe description of sampler and heap-view metadata.\n   *\n   * @returns {object} Serializable resource-set summary.\n   */\n    toJSON()\n    {\n        return {\n            shaderTypes: this.shaderTypes.slice(),\n            samplers: this.samplers.map((entry) => ({ ...entry })),\n            heapViews: this.heapViews.map((entry) => ({ ...entry }))\n        };\n    }\n}\n"],"names":["HlslResourceSetDescription","constructor","shaderTypes","signatures","slice","samplers","heapViews","SetSampler","stageType","registerIndex","sampler","push","SetSrvHeapView","kind","SetUavHeapView","SetSamplerHeapView","toJSON","map","entry"],"mappings":"AAAA;AACA;AACA;AACO,MAAMA,0BAA0B,CACvC;AACI;AACJ;AACA;AACA;AACA;AACA;EACIC,WAAWA,CAACC,WAAW,GAAG,EAAE,EAAEC,UAAU,GAAG,EAAE,EAC7C;AACI,IAAA,IAAI,CAACD,WAAW,GAAGA,WAAW,CAACE,KAAK,EAAE;AACtC,IAAA,IAAI,CAACD,UAAU,GAAGA,UAAU,CAACC,KAAK,EAAE;IACpC,IAAI,CAACC,QAAQ,GAAG,EAAE;IAClB,IAAI,CAACC,SAAS,GAAG,EAAE;AACvB,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACIC,EAAAA,UAAUA,CAACC,SAAS,EAAEC,aAAa,EAAEC,OAAO,EAC5C;AACI,IAAA,IAAI,CAACL,QAAQ,CAACM,IAAI,CAAC;MAAEH,SAAS;MAAEC,aAAa;AAAEC,MAAAA;AAAQ,KAAC,CAAC;AAC7D,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACIE,EAAAA,cAAcA,CAACJ,SAAS,EAAEC,aAAa,EACvC;AACI,IAAA,IAAI,CAACH,SAAS,CAACK,IAAI,CAAC;AAAEE,MAAAA,IAAI,EAAE,KAAK;MAAEL,SAAS;AAAEC,MAAAA;AAAc,KAAC,CAAC;AAClE,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACIK,EAAAA,cAAcA,CAACN,SAAS,EAAEC,aAAa,EACvC;AACI,IAAA,IAAI,CAACH,SAAS,CAACK,IAAI,CAAC;AAAEE,MAAAA,IAAI,EAAE,KAAK;MAAEL,SAAS;AAAEC,MAAAA;AAAc,KAAC,CAAC;AAClE,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACIM,EAAAA,kBAAkBA,CAACP,SAAS,EAAEC,aAAa,EAC3C;AACI,IAAA,IAAI,CAACH,SAAS,CAACK,IAAI,CAAC;AAAEE,MAAAA,IAAI,EAAE,SAAS;MAAEL,SAAS;AAAEC,MAAAA;AAAc,KAAC,CAAC;AACtE,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACIO,EAAAA,MAAMA,GACN;IACI,OAAO;AACHd,MAAAA,WAAW,EAAE,IAAI,CAACA,WAAW,CAACE,KAAK,EAAE;MACrCC,QAAQ,EAAE,IAAI,CAACA,QAAQ,CAACY,GAAG,CAAEC,KAAK,KAAM;QAAE,GAAGA;AAAM,OAAC,CAAC,CAAC;MACtDZ,SAAS,EAAE,IAAI,CAACA,SAAS,CAACW,GAAG,CAAEC,KAAK,KAAM;QAAE,GAAGA;AAAM,OAAC,CAAC;KAC1D;AACL,EAAA;AACJ;;;;"}

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

@@ -0,0 +1,44 @@
+import { asUint8Array } from '@carbonenginejs/runtime-utils/bytes';
+
+/**
+ * JavaScript stand-in for Carbon's shader-bytecode handle payload.
+ */
+class HlslShaderBytecode {
+  /**
+  * Captures bytecode and metadata for one compiled shader stage or library.
+  *
+  * @param {object} [options] Bytecode metadata.
+  * @param {number|null} [options.stageType] Trinity shader stage enum value.
+  * @param {string|null} [options.stageName] Friendly stage name.
+  * @param {ArrayBuffer|ArrayBufferView|Uint8Array} [options.bytes] Shader bytecode bytes.
+  * @param {number} [options.shaderSize] Original bytecode size from the effect.
+  * @param {number|null} [options.stringTableOffset] Offset into the effect string table.
+  * @param {string} [options.effectName] Source effect name or path.
+  */
+  constructor(options = {}) {
+    this.stageType = Number.isInteger(options.stageType) ? options.stageType : null;
+    this.stageName = options.stageName || null;
+    this.bytes = options.bytes ? asUint8Array(options.bytes) : new Uint8Array(0);
+    this.shaderSize = Number(options.shaderSize) || this.bytes.length;
+    this.stringTableOffset = Number.isInteger(options.stringTableOffset) ? options.stringTableOffset : null;
+    this.effectName = options.effectName || "";
+  }
+
+  /**
+  * Returns serializable metadata while omitting the potentially large byte array.
+  *
+  * @returns {object} JSON-safe bytecode summary.
+  */
+  toJSON() {
+    return {
+      stageType: this.stageType,
+      stageName: this.stageName,
+      shaderSize: this.shaderSize,
+      stringTableOffset: this.stringTableOffset,
+      effectName: this.effectName
+    };
+  }
+}
+
+export { HlslShaderBytecode };
+//# sourceMappingURL=HlslShaderBytecode.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HlslShaderBytecode.js","sources":["../../../../../src/formats/hlsl/core/HlslShaderBytecode.js"],"sourcesContent":["import { asUint8Array } from \"@carbonenginejs/runtime-utils/bytes\";\n\n/**\n * JavaScript stand-in for Carbon's shader-bytecode handle payload.\n */\nexport class HlslShaderBytecode\n{\n    /**\n   * Captures bytecode and metadata for one compiled shader stage or library.\n   *\n   * @param {object} [options] Bytecode metadata.\n   * @param {number|null} [options.stageType] Trinity shader stage enum value.\n   * @param {string|null} [options.stageName] Friendly stage name.\n   * @param {ArrayBuffer|ArrayBufferView|Uint8Array} [options.bytes] Shader bytecode bytes.\n   * @param {number} [options.shaderSize] Original bytecode size from the effect.\n   * @param {number|null} [options.stringTableOffset] Offset into the effect string table.\n   * @param {string} [options.effectName] Source effect name or path.\n   */\n    constructor(options = {})\n    {\n        this.stageType = Number.isInteger(options.stageType) ? options.stageType : null;\n        this.stageName = options.stageName || null;\n        this.bytes = options.bytes ? asUint8Array(options.bytes) : new Uint8Array(0);\n        this.shaderSize = Number(options.shaderSize) || this.bytes.length;\n        this.stringTableOffset = Number.isInteger(options.stringTableOffset) ? options.stringTableOffset : null;\n        this.effectName = options.effectName || \"\";\n    }\n\n    /**\n   * Returns serializable metadata while omitting the potentially large byte array.\n   *\n   * @returns {object} JSON-safe bytecode summary.\n   */\n    toJSON()\n    {\n        return {\n            stageType: this.stageType,\n            stageName: this.stageName,\n            shaderSize: this.shaderSize,\n            stringTableOffset: this.stringTableOffset,\n            effectName: this.effectName\n        };\n    }\n}\n"],"names":["HlslShaderBytecode","constructor","options","stageType","Number","isInteger","stageName","bytes","asUint8Array","Uint8Array","shaderSize","length","stringTableOffset","effectName","toJSON"],"mappings":";;AAEA;AACA;AACA;AACO,MAAMA,kBAAkB,CAC/B;AACI;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACIC,EAAAA,WAAWA,CAACC,OAAO,GAAG,EAAE,EACxB;AACI,IAAA,IAAI,CAACC,SAAS,GAAGC,MAAM,CAACC,SAAS,CAACH,OAAO,CAACC,SAAS,CAAC,GAAGD,OAAO,CAACC,SAAS,GAAG,IAAI;AAC/E,IAAA,IAAI,CAACG,SAAS,GAAGJ,OAAO,CAACI,SAAS,IAAI,IAAI;AAC1C,IAAA,IAAI,CAACC,KAAK,GAAGL,OAAO,CAACK,KAAK,GAAGC,YAAY,CAACN,OAAO,CAACK,KAAK,CAAC,GAAG,IAAIE,UAAU,CAAC,CAAC,CAAC;AAC5E,IAAA,IAAI,CAACC,UAAU,GAAGN,MAAM,CAACF,OAAO,CAACQ,UAAU,CAAC,IAAI,IAAI,CAACH,KAAK,CAACI,MAAM;AACjE,IAAA,IAAI,CAACC,iBAAiB,GAAGR,MAAM,CAACC,SAAS,CAACH,OAAO,CAACU,iBAAiB,CAAC,GAAGV,OAAO,CAACU,iBAAiB,GAAG,IAAI;AACvG,IAAA,IAAI,CAACC,UAAU,GAAGX,OAAO,CAACW,UAAU,IAAI,EAAE;AAC9C,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACIC,EAAAA,MAAMA,GACN;IACI,OAAO;MACHX,SAAS,EAAE,IAAI,CAACA,SAAS;MACzBG,SAAS,EAAE,IAAI,CAACA,SAAS;MACzBI,UAAU,EAAE,IAAI,CAACA,UAAU;MAC3BE,iBAAiB,EAAE,IAAI,CAACA,iBAAiB;MACzCC,UAAU,EAAE,IAAI,CAACA;KACpB;AACL,EAAA;AACJ;;;;"}

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

@@ -0,0 +1,51 @@
+import { normalizeValues, DEFAULT_VALUES, readRaw } from './helpers.js';
+import { resolveSelectedOptions } from './metadata.js';
+import { HlslEffectBindingManifest } from './tr2/shader/HlslEffectBindingManifest.js';
+
+/**
+ * Resolve one permutation to the raw effect/shader/manifest context that
+ * downstream translation tooling needs.
+ *
+ * This is intentionally an advanced helper: it returns internal graph objects
+ * rather than the stable JSON contract exposed by `CjsHlslFormat`.
+ *
+ * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Tr2 effect payload.
+ * @param {object} values Normalized format values.
+ * @returns {{effectRes: object, shader: object|null, selection: object, effectDescription: object|null, bindingManifest: HlslEffectBindingManifest|null}}
+ *   Raw loaded effect data plus the resolved permutation context.
+ */
+function analyzeEffectWithValues(input, values) {
+  const effectRes = readRaw(input, values);
+  const selection = resolveSelectedOptions(effectRes, values.permutation || []);
+  let shader = null;
+  try {
+    shader = effectRes.GetShader(values.permutation || []);
+  } catch {
+    shader = null;
+  }
+  const effectDescription = shader ? shader.GetEffectDescription() : null;
+  const bindingManifest = effectDescription ? HlslEffectBindingManifest.fromEffectDescription(effectDescription) : null;
+  return {
+    effectRes,
+    shader,
+    selection,
+    effectDescription,
+    bindingManifest
+  };
+}
+
+/**
+ * Advanced one-shot helper for tooling that needs one parse plus one binding
+ * manifest build without changing the stable reader emits.
+ *
+ * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Tr2 effect payload.
+ * @param {object} [options] Format values.
+ * @returns {{effectRes: object, shader: object|null, selection: object, effectDescription: object|null, bindingManifest: HlslEffectBindingManifest|null}}
+ *   Raw loaded effect data plus the resolved permutation context.
+ */
+function readEffectAnalysis(input, options = {}) {
+  return analyzeEffectWithValues(input, normalizeValues(DEFAULT_VALUES, options, "readEffectAnalysis"));
+}
+
+export { analyzeEffectWithValues, readEffectAnalysis };
+//# sourceMappingURL=analysis.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analysis.js","sources":["../../../../../src/formats/hlsl/core/analysis.js"],"sourcesContent":["import { DEFAULT_VALUES, normalizeValues, readRaw } from \"./helpers.js\";\nimport { resolveSelectedOptions } from \"./metadata.js\";\nimport { HlslEffectBindingManifest } from \"./tr2/shader/HlslEffectBindingManifest.js\";\n\n/**\n * Resolve one permutation to the raw effect/shader/manifest context that\n * downstream translation tooling needs.\n *\n * This is intentionally an advanced helper: it returns internal graph objects\n * rather than the stable JSON contract exposed by `CjsHlslFormat`.\n *\n * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Tr2 effect payload.\n * @param {object} values Normalized format values.\n * @returns {{effectRes: object, shader: object|null, selection: object, effectDescription: object|null, bindingManifest: HlslEffectBindingManifest|null}}\n *   Raw loaded effect data plus the resolved permutation context.\n */\nexport function analyzeEffectWithValues(input, values)\n{\n    const effectRes = readRaw(input, values);\n    const selection = resolveSelectedOptions(effectRes, values.permutation || []);\n\n    let shader = null;\n    try\n    {\n        shader = effectRes.GetShader(values.permutation || []);\n    }\n    catch\n    {\n        shader = null;\n    }\n\n    const effectDescription = shader ? shader.GetEffectDescription() : null;\n    const bindingManifest = effectDescription\n        ? HlslEffectBindingManifest.fromEffectDescription(effectDescription)\n        : null;\n\n    return {\n        effectRes,\n        shader,\n        selection,\n        effectDescription,\n        bindingManifest\n    };\n}\n\n/**\n * Advanced one-shot helper for tooling that needs one parse plus one binding\n * manifest build without changing the stable reader emits.\n *\n * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Tr2 effect payload.\n * @param {object} [options] Format values.\n * @returns {{effectRes: object, shader: object|null, selection: object, effectDescription: object|null, bindingManifest: HlslEffectBindingManifest|null}}\n *   Raw loaded effect data plus the resolved permutation context.\n */\nexport function readEffectAnalysis(input, options = {})\n{\n    return analyzeEffectWithValues(input, normalizeValues(DEFAULT_VALUES, options, \"readEffectAnalysis\"));\n}\n"],"names":["analyzeEffectWithValues","input","values","effectRes","readRaw","selection","resolveSelectedOptions","permutation","shader","GetShader","effectDescription","GetEffectDescription","bindingManifest","HlslEffectBindingManifest","fromEffectDescription","readEffectAnalysis","options","normalizeValues","DEFAULT_VALUES"],"mappings":";;;;AAIA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASA,uBAAuBA,CAACC,KAAK,EAAEC,MAAM,EACrD;AACI,EAAA,MAAMC,SAAS,GAAGC,OAAO,CAACH,KAAK,EAAEC,MAAM,CAAC;EACxC,MAAMG,SAAS,GAAGC,sBAAsB,CAACH,SAAS,EAAED,MAAM,CAACK,WAAW,IAAI,EAAE,CAAC;EAE7E,IAAIC,MAAM,GAAG,IAAI;EACjB,IACA;IACIA,MAAM,GAAGL,SAAS,CAACM,SAAS,CAACP,MAAM,CAACK,WAAW,IAAI,EAAE,CAAC;AAC1D,EAAA,CAAC,CACD,MACA;AACIC,IAAAA,MAAM,GAAG,IAAI;AACjB,EAAA;EAEA,MAAME,iBAAiB,GAAGF,MAAM,GAAGA,MAAM,CAACG,oBAAoB,EAAE,GAAG,IAAI;EACvE,MAAMC,eAAe,GAAGF,iBAAiB,GACnCG,yBAAyB,CAACC,qBAAqB,CAACJ,iBAAiB,CAAC,GAClE,IAAI;EAEV,OAAO;IACHP,SAAS;IACTK,MAAM;IACNH,SAAS;IACTK,iBAAiB;AACjBE,IAAAA;GACH;AACL;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASG,kBAAkBA,CAACd,KAAK,EAAEe,OAAO,GAAG,EAAE,EACtD;AACI,EAAA,OAAOhB,uBAAuB,CAACC,KAAK,EAAEgB,eAAe,CAACC,cAAc,EAAEF,OAAO,EAAE,oBAAoB,CAAC,CAAC;AACzG;;;;"}