@carbonenginejs/runtime 0.1.0-alpha.4 → 0.1.0-alpha.5

package/dist/resource/format/CjsStringTable.js.map

@@ -1 +1 @@
-{"version":3,"file":"CjsStringTable.js","sources":["../../../../src/resource/format/CjsStringTable.js"],"sourcesContent":["import { CjsFormatWriteError } from \"./CjsFormatError.js\";\r\n\r\n// Source: trinity/shadercompiler/StringTable.cpp, trinity/shadercompiler/StringTable.h\r\n\r\nconst textEncoder = new TextEncoder();\r\n\r\n/**\r\n * The null arena reference. `StringTable::GetOffset` returns this for an\r\n * invalid or unknown reference (`StringTable.cpp:52-68`), and Carbon's reader\r\n * tolerates it at exactly one wire position: a stage's default-constant-value\r\n * offset when the accompanying size is zero\r\n * (`Tr2EffectDescription.cpp:80-91`). Everywhere else it fails the load.\r\n */\r\nexport const CJS_STRING_TABLE_NULL_REFERENCE = 0xffffffff;\r\n\r\n/**\r\n * Compares two byte runs the way Carbon's `Blob::operator<` does: `memcmp`\r\n * over the shorter length, then shorter-wins on a tie\r\n * (`StringTable.h:109-122`).\r\n *\r\n * @param {Uint8Array} a First byte run.\r\n * @param {Uint8Array} b Second byte run.\r\n * @returns {number} Negative, zero, or positive ordering result.\r\n */\r\nexport function compareTableBlobs(a, b)\r\n{\r\n    const shared = Math.min(a.length, b.length);\r\n    for (let index = 0; index < shared; index += 1)\r\n    {\r\n        if (a[index] !== b[index]) return a[index] - b[index];\r\n    }\r\n    return a.length - b.length;\r\n}\r\n\r\n/**\r\n * FNV-1a over every byte, used only to bucket dedupe candidates.\r\n *\r\n * Carbon hashes a stride-sampled subset (`StringTable.h:124-134`); hashing all\r\n * bytes costs the same asymptotically and collides less. Either way the\r\n * decision is made by the full byte comparison that follows, so the choice of\r\n * hash cannot change the emitted arena.\r\n *\r\n * @param {Uint8Array} bytes Byte run to hash.\r\n * @returns {number} 32-bit hash.\r\n */\r\nfunction hashBytes(bytes)\r\n{\r\n    let hash = 0x811c9dc5;\r\n    for (let index = 0; index < bytes.length; index += 1)\r\n    {\r\n        hash ^= bytes[index];\r\n        hash = Math.imul(hash, 0x01000193);\r\n    }\r\n    return hash >>> 0;\r\n}\r\n\r\n/**\r\n * Carbon's compiled-effect string table: a deduplicated blob arena whose\r\n * offsets are assigned by a bytewise sort rather than by insertion order.\r\n *\r\n * The arena holds three kinds of entry, distinguished only by how the wire\r\n * refers to them:\r\n *\r\n * - NUL-terminated strings, added with the terminator (`strlen + 1`,\r\n *   `StringTable.cpp:18-21`), referenced by a bare `u32` offset;\r\n * - sized blobs — shader bytecode, program source, default constant values —\r\n *   added with exactly their own bytes and no terminator\r\n *   (`StringTable.cpp:23-41`), referenced by a `{u32 size, u32 offset}` pair;\r\n * - nothing else. Carbon persists no manifest: `StringTable::Write` emits a\r\n *   `u32` payload size and the payload (`StringTable.cpp:110-143`), and every\r\n *   reference site resolves its own entry.\r\n *\r\n * Two deliberate departures from Carbon, both of which make byte-identical\r\n * output more likely rather than less:\r\n *\r\n * - `m_size` is initialised. Carbon's constructor leaves it indeterminate\r\n *   (`StringTable.cpp:9-12`, `StringTable.h:170`) and gets away with it only\r\n *   because the one instance is a zero-initialised global.\r\n * - adding after an offset has been handed out is an error rather than a silent\r\n *   resort. In Carbon, `GetOffset` re-sorts whenever the table is dirty\r\n *   (`StringTable.cpp:59-62`), which reassigns *every* offset — including\r\n *   offsets already baked into packed bodies. Carbon avoids the corruption by\r\n *   interning all late strings before the packing pass; we fail closed instead.\r\n */\r\nexport class CjsStringTable\r\n{\r\n    #blobs = [];\r\n    #buckets = new Map();\r\n    #byteLength = 0;\r\n    #offsets = null;\r\n    #handedOutOffsets = false;\r\n\r\n    /**\r\n     * Returns the arena payload byte count, excluding the `u32` size prefix.\r\n     *\r\n     * This is Carbon's `m_size` and the value the reader bounds-checks every\r\n     * offset against.\r\n     *\r\n     * @returns {number} Payload byte count.\r\n     */\r\n    get byteLength()\r\n    {\r\n        return this.#byteLength;\r\n    }\r\n\r\n    /**\r\n     * Returns the byte count the arena occupies in the file, including its own\r\n     * `u32` size prefix.\r\n     *\r\n     * This is Carbon's `GetSize()` (`StringTable.cpp:82-85`), the term used by\r\n     * the body-offset base arithmetic.\r\n     *\r\n     * @returns {number} On-disk byte count.\r\n     */\r\n    get containerSize()\r\n    {\r\n        return this.#byteLength + 4;\r\n    }\r\n\r\n    /**\r\n     * Returns the number of distinct entries in the arena.\r\n     *\r\n     * @returns {number} Deduplicated entry count.\r\n     */\r\n    get entryCount()\r\n    {\r\n        return this.#blobs.length;\r\n    }\r\n\r\n    /**\r\n     * Interns a NUL-terminated string and returns its reference.\r\n     *\r\n     * @param {string} value Text to intern, stored with a trailing NUL.\r\n     * @returns {number} Arena reference for later `offsetOf`.\r\n     */\r\n    addString(value)\r\n    {\r\n        const text = textEncoder.encode(String(value));\r\n        const bytes = new Uint8Array(text.length + 1);\r\n        bytes.set(text, 0);\r\n        return this.#add(bytes);\r\n    }\r\n\r\n    /**\r\n     * Interns exact bytes with no terminator and returns their reference.\r\n     *\r\n     * @param {ArrayBufferView|Uint8Array} value Bytes to intern.\r\n     * @returns {number} Arena reference for later `offsetOf`.\r\n     */\r\n    addBytes(value)\r\n    {\r\n        const source = value instanceof Uint8Array\r\n            ? value\r\n            : new Uint8Array(value.buffer, value.byteOffset, value.byteLength);\r\n        return this.#add(Uint8Array.from(source));\r\n    }\r\n\r\n    /**\r\n     * Assigns every entry its final offset by Carbon's bytewise sort.\r\n     *\r\n     * Idempotent while the table is unchanged. Returns this table so it can be\r\n     * chained onto construction.\r\n     *\r\n     * @returns {CjsStringTable} This table.\r\n     */\r\n    finish()\r\n    {\r\n        if (this.#offsets) return this;\r\n\r\n        const order = this.#blobs.map((blob, index) => index);\r\n        order.sort((a, b) => compareTableBlobs(this.#blobs[a], this.#blobs[b]));\r\n\r\n        const offsets = new Array(this.#blobs.length);\r\n        let cursor = 0;\r\n        for (const index of order)\r\n        {\r\n            offsets[index] = cursor;\r\n            cursor += this.#blobs[index].length;\r\n        }\r\n        this.#offsets = offsets;\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     * Resolves an arena reference to its byte offset.\r\n     *\r\n     * `null` and `undefined` resolve to the `0xffffffff` null reference, so a\r\n     * caller can pass an absent optional field straight through.\r\n     *\r\n     * @param {number|null|undefined} reference Reference from `addString`/`addBytes`.\r\n     * @returns {number} Byte offset, or `0xffffffff` for a null reference.\r\n     */\r\n    offsetOf(reference)\r\n    {\r\n        if (reference === null || reference === undefined)\r\n        {\r\n            return CJS_STRING_TABLE_NULL_REFERENCE;\r\n        }\r\n        if (!Number.isInteger(reference) || reference < 0 || reference >= this.#blobs.length)\r\n        {\r\n            throw new CjsFormatWriteError(\"Unknown string-table reference\", {\r\n                reference,\r\n                entryCount: this.#blobs.length\r\n            });\r\n        }\r\n        this.finish();\r\n        this.#handedOutOffsets = true;\r\n        return this.#offsets[reference];\r\n    }\r\n\r\n    /**\r\n     * Returns the interned bytes behind a reference.\r\n     *\r\n     * @param {number} reference Reference from `addString`/`addBytes`.\r\n     * @returns {Uint8Array} View over the interned bytes.\r\n     */\r\n    bytesOf(reference)\r\n    {\r\n        if (!Number.isInteger(reference) || reference < 0 || reference >= this.#blobs.length)\r\n        {\r\n            throw new CjsFormatWriteError(\"Unknown string-table reference\", {\r\n                reference,\r\n                entryCount: this.#blobs.length\r\n            });\r\n        }\r\n        return this.#blobs[reference];\r\n    }\r\n\r\n    /**\r\n     * Materialises the arena payload in sorted order.\r\n     *\r\n     * @returns {Uint8Array} Arena payload, without the `u32` size prefix.\r\n     */\r\n    toBytes()\r\n    {\r\n        this.finish();\r\n        const out = new Uint8Array(this.#byteLength);\r\n        for (let index = 0; index < this.#blobs.length; index += 1)\r\n        {\r\n            out.set(this.#blobs[index], this.#offsets[index]);\r\n        }\r\n        return out;\r\n    }\r\n\r\n    /**\r\n     * Writes the arena exactly as `StringTable::Write` does: a `u32` payload\r\n     * size followed by the payload (`StringTable.cpp:110-143`).\r\n     *\r\n     * @param {import(\"./CjsByteWriter.js\").CjsByteWriter} writer Target writer.\r\n     */\r\n    write(writer)\r\n    {\r\n        this.finish();\r\n        writer.u32(this.#byteLength);\r\n        if (this.#byteLength === 0) return;\r\n        writer.bytes(this.toBytes());\r\n    }\r\n\r\n    /**\r\n     * Interns a byte run, returning an existing reference when the bytes match\r\n     * exactly. Dedupe is on full content and length, with no suffix merging —\r\n     * Carbon's `Blob::operator==` (`StringTable.h:104-107`).\r\n     *\r\n     * @param {Uint8Array} bytes Owned bytes to intern.\r\n     * @returns {number} Arena reference.\r\n     */\r\n    #add(bytes)\r\n    {\r\n        const key = hashBytes(bytes);\r\n        const bucket = this.#buckets.get(key);\r\n        if (bucket)\r\n        {\r\n            for (const candidate of bucket)\r\n            {\r\n                if (compareTableBlobs(this.#blobs[candidate], bytes) === 0)\r\n                {\r\n                    return candidate;\r\n                }\r\n            }\r\n        }\r\n\r\n        if (this.#handedOutOffsets)\r\n        {\r\n            throw new CjsFormatWriteError(\r\n                \"String-table entry added after offsets were resolved; every offset already handed out would shift\",\r\n                { byteLength: bytes.length }\r\n            );\r\n        }\r\n\r\n        const reference = this.#blobs.length;\r\n        this.#blobs.push(bytes);\r\n        this.#byteLength += bytes.length;\r\n        this.#offsets = null;\r\n        if (bucket) bucket.push(reference);\r\n        else this.#buckets.set(key, [ reference ]);\r\n        return reference;\r\n    }\r\n}\r\n\r\nexport default CjsStringTable;\r\n"],"names":["textEncoder","TextEncoder","CJS_STRING_TABLE_NULL_REFERENCE","compareTableBlobs","a","b","shared","Math","min","length","index","hashBytes","bytes","hash","imul","CjsStringTable","Map","byteLength","containerSize","entryCount","addString","value","text","encode","String","Uint8Array","set","addBytes","source","buffer","byteOffset","from","finish","order","map","blob","sort","offsets","Array","cursor","offsetOf","reference","undefined","Number","isInteger","CjsFormatWriteError","bytesOf","toBytes","out","write","writer","u32","#add","key","bucket","get","candidate","push"],"mappings":"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"}
+{"version":3,"file":"CjsStringTable.js","sources":["../../../../src/resource/format/CjsStringTable.js"],"sourcesContent":["import { CjsFormatWriteError } from \"./CjsFormatError.js\";\r\n\r\n// Source: trinity/shadercompiler/StringTable.cpp, trinity/shadercompiler/StringTable.h\r\n\r\nconst textEncoder = new TextEncoder();\r\n\r\n/**\r\n * The null arena reference. `StringTable::GetOffset` returns this for an\r\n * invalid or unknown reference (`StringTable.cpp:52-68`), and Carbon's reader\r\n * tolerates it at exactly one wire position: a stage's default-constant-value\r\n * offset when the accompanying size is zero\r\n * (`Tr2EffectDescription.cpp:80-91`). Everywhere else it fails the load.\r\n */\r\nexport const CJS_STRING_TABLE_NULL_REFERENCE = 0xffffffff;\r\n\r\n/**\r\n * Compares two byte runs the way Carbon's `Blob::operator<` does: `memcmp`\r\n * over the shorter length, then shorter-wins on a tie\r\n * (`StringTable.h:109-122`).\r\n *\r\n * @param {Uint8Array} a First byte run.\r\n * @param {Uint8Array} b Second byte run.\r\n * @returns {number} Negative, zero, or positive ordering result.\r\n */\r\nexport function compareTableBlobs(a, b)\r\n{\r\n    const shared = Math.min(a.length, b.length);\r\n    for (let index = 0; index < shared; index += 1)\r\n    {\r\n        if (a[index] !== b[index]) return a[index] - b[index];\r\n    }\r\n    return a.length - b.length;\r\n}\r\n\r\n/**\r\n * FNV-1a over every byte, used only to bucket dedupe candidates.\r\n *\r\n * Carbon hashes a stride-sampled subset (`StringTable.h:124-134`); hashing all\r\n * bytes costs the same asymptotically and collides less. Either way the\r\n * decision is made by the full byte comparison that follows, so the choice of\r\n * hash cannot change the emitted arena.\r\n *\r\n * @param {Uint8Array} bytes Byte run to hash.\r\n * @returns {number} 32-bit hash.\r\n */\r\nfunction hashBytes(bytes)\r\n{\r\n    let hash = 0x811c9dc5;\r\n    for (let index = 0; index < bytes.length; index += 1)\r\n    {\r\n        hash ^= bytes[index];\r\n        hash = Math.imul(hash, 0x01000193);\r\n    }\r\n    return hash >>> 0;\r\n}\r\n\r\n/**\r\n * Carbon's compiled-effect string table: a deduplicated blob arena whose\r\n * offsets are assigned by a bytewise sort rather than by insertion order.\r\n *\r\n * The arena holds three kinds of entry, distinguished only by how the wire\r\n * refers to them:\r\n *\r\n * - NUL-terminated strings, added with the terminator (`strlen + 1`,\r\n *   `StringTable.cpp:18-21`), referenced by a bare `u32` offset;\r\n * - sized blobs — shader bytecode, program source, default constant values —\r\n *   added with exactly their own bytes and no terminator\r\n *   (`StringTable.cpp:23-41`), referenced by a `{u32 size, u32 offset}` pair;\r\n * - nothing else. Carbon persists no manifest: `StringTable::Write` emits a\r\n *   `u32` payload size and the payload (`StringTable.cpp:110-143`), and every\r\n *   reference site resolves its own entry.\r\n *\r\n * Two deliberate departures from Carbon, both of which make byte-identical\r\n * output more likely rather than less:\r\n *\r\n * - `m_size` is initialised. Carbon's constructor leaves it indeterminate\r\n *   (`StringTable.cpp:9-12`, `StringTable.h:170`) and gets away with it only\r\n *   because the one instance is a zero-initialised global.\r\n * - adding after an offset has been handed out is an error rather than a silent\r\n *   resort. In Carbon, `GetOffset` re-sorts whenever the table is dirty\r\n *   (`StringTable.cpp:59-62`), which reassigns *every* offset — including\r\n *   offsets already baked into packed bodies. Carbon avoids the corruption by\r\n *   interning all late strings before the packing pass; we fail closed instead.\r\n */\r\nexport class CjsStringTable\r\n{\r\n    _blobs = [];\r\n    _buckets = new Map();\r\n    _byteLength = 0;\r\n    _offsets = null;\r\n    _handedOutOffsets = false;\r\n\r\n    /**\r\n     * Returns the arena payload byte count, excluding the `u32` size prefix.\r\n     *\r\n     * This is Carbon's `m_size` and the value the reader bounds-checks every\r\n     * offset against.\r\n     *\r\n     * @returns {number} Payload byte count.\r\n     */\r\n    get byteLength()\r\n    {\r\n        return this._byteLength;\r\n    }\r\n\r\n    /**\r\n     * Returns the byte count the arena occupies in the file, including its own\r\n     * `u32` size prefix.\r\n     *\r\n     * This is Carbon's `GetSize()` (`StringTable.cpp:82-85`), the term used by\r\n     * the body-offset base arithmetic.\r\n     *\r\n     * @returns {number} On-disk byte count.\r\n     */\r\n    get containerSize()\r\n    {\r\n        return this._byteLength + 4;\r\n    }\r\n\r\n    /**\r\n     * Returns the number of distinct entries in the arena.\r\n     *\r\n     * @returns {number} Deduplicated entry count.\r\n     */\r\n    get entryCount()\r\n    {\r\n        return this._blobs.length;\r\n    }\r\n\r\n    /**\r\n     * Interns a NUL-terminated string and returns its reference.\r\n     *\r\n     * @param {string} value Text to intern, stored with a trailing NUL.\r\n     * @returns {number} Arena reference for later `offsetOf`.\r\n     */\r\n    addString(value)\r\n    {\r\n        const text = textEncoder.encode(String(value));\r\n        const bytes = new Uint8Array(text.length + 1);\r\n        bytes.set(text, 0);\r\n        return this._add(bytes);\r\n    }\r\n\r\n    /**\r\n     * Interns exact bytes with no terminator and returns their reference.\r\n     *\r\n     * @param {ArrayBufferView|Uint8Array} value Bytes to intern.\r\n     * @returns {number} Arena reference for later `offsetOf`.\r\n     */\r\n    addBytes(value)\r\n    {\r\n        const source = value instanceof Uint8Array\r\n            ? value\r\n            : new Uint8Array(value.buffer, value.byteOffset, value.byteLength);\r\n        return this._add(Uint8Array.from(source));\r\n    }\r\n\r\n    /**\r\n     * Assigns every entry its final offset by Carbon's bytewise sort.\r\n     *\r\n     * Idempotent while the table is unchanged. Returns this table so it can be\r\n     * chained onto construction.\r\n     *\r\n     * @returns {CjsStringTable} This table.\r\n     */\r\n    finish()\r\n    {\r\n        if (this._offsets) return this;\r\n\r\n        const order = this._blobs.map((blob, index) => index);\r\n        order.sort((a, b) => compareTableBlobs(this._blobs[a], this._blobs[b]));\r\n\r\n        const offsets = new Array(this._blobs.length);\r\n        let cursor = 0;\r\n        for (const index of order)\r\n        {\r\n            offsets[index] = cursor;\r\n            cursor += this._blobs[index].length;\r\n        }\r\n        this._offsets = offsets;\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     * Resolves an arena reference to its byte offset.\r\n     *\r\n     * `null` and `undefined` resolve to the `0xffffffff` null reference, so a\r\n     * caller can pass an absent optional field straight through.\r\n     *\r\n     * @param {number|null|undefined} reference Reference from `addString`/`addBytes`.\r\n     * @returns {number} Byte offset, or `0xffffffff` for a null reference.\r\n     */\r\n    offsetOf(reference)\r\n    {\r\n        if (reference === null || reference === undefined)\r\n        {\r\n            return CJS_STRING_TABLE_NULL_REFERENCE;\r\n        }\r\n        if (!Number.isInteger(reference) || reference < 0 || reference >= this._blobs.length)\r\n        {\r\n            throw new CjsFormatWriteError(\"Unknown string-table reference\", {\r\n                reference,\r\n                entryCount: this._blobs.length\r\n            });\r\n        }\r\n        this.finish();\r\n        this._handedOutOffsets = true;\r\n        return this._offsets[reference];\r\n    }\r\n\r\n    /**\r\n     * Returns the interned bytes behind a reference.\r\n     *\r\n     * @param {number} reference Reference from `addString`/`addBytes`.\r\n     * @returns {Uint8Array} View over the interned bytes.\r\n     */\r\n    bytesOf(reference)\r\n    {\r\n        if (!Number.isInteger(reference) || reference < 0 || reference >= this._blobs.length)\r\n        {\r\n            throw new CjsFormatWriteError(\"Unknown string-table reference\", {\r\n                reference,\r\n                entryCount: this._blobs.length\r\n            });\r\n        }\r\n        return this._blobs[reference];\r\n    }\r\n\r\n    /**\r\n     * Materialises the arena payload in sorted order.\r\n     *\r\n     * @returns {Uint8Array} Arena payload, without the `u32` size prefix.\r\n     */\r\n    toBytes()\r\n    {\r\n        this.finish();\r\n        const out = new Uint8Array(this._byteLength);\r\n        for (let index = 0; index < this._blobs.length; index += 1)\r\n        {\r\n            out.set(this._blobs[index], this._offsets[index]);\r\n        }\r\n        return out;\r\n    }\r\n\r\n    /**\r\n     * Writes the arena exactly as `StringTable::Write` does: a `u32` payload\r\n     * size followed by the payload (`StringTable.cpp:110-143`).\r\n     *\r\n     * @param {import(\"./CjsByteWriter.js\").CjsByteWriter} writer Target writer.\r\n     */\r\n    write(writer)\r\n    {\r\n        this.finish();\r\n        writer.u32(this._byteLength);\r\n        if (this._byteLength === 0) return;\r\n        writer.bytes(this.toBytes());\r\n    }\r\n\r\n    /**\r\n     * Interns a byte run, returning an existing reference when the bytes match\r\n     * exactly. Dedupe is on full content and length, with no suffix merging —\r\n     * Carbon's `Blob::operator==` (`StringTable.h:104-107`).\r\n     *\r\n     * @param {Uint8Array} bytes Owned bytes to intern.\r\n     * @returns {number} Arena reference.\r\n     */\r\n    _add(bytes)\r\n    {\r\n        const key = hashBytes(bytes);\r\n        const bucket = this._buckets.get(key);\r\n        if (bucket)\r\n        {\r\n            for (const candidate of bucket)\r\n            {\r\n                if (compareTableBlobs(this._blobs[candidate], bytes) === 0)\r\n                {\r\n                    return candidate;\r\n                }\r\n            }\r\n        }\r\n\r\n        if (this._handedOutOffsets)\r\n        {\r\n            throw new CjsFormatWriteError(\r\n                \"String-table entry added after offsets were resolved; every offset already handed out would shift\",\r\n                { byteLength: bytes.length }\r\n            );\r\n        }\r\n\r\n        const reference = this._blobs.length;\r\n        this._blobs.push(bytes);\r\n        this._byteLength += bytes.length;\r\n        this._offsets = null;\r\n        if (bucket) bucket.push(reference);\r\n        else this._buckets.set(key, [ reference ]);\r\n        return reference;\r\n    }\r\n}\r\n\r\nexport default CjsStringTable;\r\n"],"names":["textEncoder","TextEncoder","CJS_STRING_TABLE_NULL_REFERENCE","compareTableBlobs","a","b","shared","Math","min","length","index","hashBytes","bytes","hash","imul","CjsStringTable","_blobs","_buckets","Map","_byteLength","_offsets","_handedOutOffsets","byteLength","containerSize","entryCount","addString","value","text","encode","String","Uint8Array","set","_add","addBytes","source","buffer","byteOffset","from","finish","order","map","blob","sort","offsets","Array","cursor","offsetOf","reference","undefined","Number","isInteger","CjsFormatWriteError","bytesOf","toBytes","out","write","writer","u32","key","bucket","get","candidate","push"],"mappings":"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"}

package/dist/resource/format/carbonEffect/CjsCarbonEffectReader.js

@@ -104,10 +104,10 @@ class CjsCarbonEffectReader extends CjsCarbonEffectBodyReader {
     this.stringTableBytes = this.bytes.subarray(this.offset, this.offset + this.stringTableSize);
     this.Skip(this.stringTableSize);
     this.SetStringTable(this.stringTableBytes, this.stringTableSize);
-    this.permutations = this.#readPermutations();
-    this.records = this.#readRecords();
+    this.permutations = this._readPermutations();
+    this.records = this._readRecords();
     this.headerEnd = this.offset;
-    this.diagnostics = this.#inspect();
+    this.diagnostics = this._inspect();
     if (!options.permissive) {
       this.requireDensePermutationTable();
     }
@@ -198,16 +198,16 @@ class CjsCarbonEffectReader extends CjsCarbonEffectBodyReader {
       });
     }
     if (options.backend !== undefined) {
-      return this.#readDescriptionAs(record, options.backend === true);
+      return this._readDescriptionAs(record, options.backend === true);
     }
 
     // Plain Carbon first: it is the larger population, and it is the reading
     // that must stay cheap.
     try {
-      return this.#readDescriptionAs(record, false);
+      return this._readDescriptionAs(record, false);
     } catch (withoutBlocks) {
       try {
-        return this.#readDescriptionAs(record, true);
+        return this._readDescriptionAs(record, true);
       } catch {
         // Report the plain-Carbon failure. If neither reading works the
         // blob is malformed, and the Carbon diagnosis is the useful one;
@@ -225,7 +225,7 @@ class CjsCarbonEffectReader extends CjsCarbonEffectBodyReader {
    * @param {boolean} backend Whether to expect the per-pass block.
    * @returns {object} Description record tree.
    */
-  #readDescriptionAs(record, backend) {
+  _readDescriptionAs(record, backend) {
     const reader = new this.constructor.BodyReader(this.bytes, {
       source: this.source,
       offset: record.offset,
@@ -261,7 +261,7 @@ class CjsCarbonEffectReader extends CjsCarbonEffectBodyReader {
    *
    * @returns {object[]} Permutation axes with arena references retained.
    */
-  #readPermutations() {
+  _readPermutations() {
     const permutations = [];
     const count = this.ReadUint8();
     for (let index = 0; index < count; index += 1) {
@@ -303,7 +303,7 @@ class CjsCarbonEffectReader extends CjsCarbonEffectBodyReader {
    *
    * @returns {object[]} Offset-table rows.
    */
-  #readRecords() {
+  _readRecords() {
     const count = this.ReadUint32();
     if (count === 0) {
       throw this._error("Carbon effect contains no compiled bodies");
@@ -331,7 +331,7 @@ class CjsCarbonEffectReader extends CjsCarbonEffectBodyReader {
    *
    * @returns {object} Structural diagnostics.
    */
-  #inspect() {
+  _inspect() {
     const headerEnd = this.headerEnd;
     const byteLength = this.bytes.length;
     let firstIndexMismatch = null;

package/dist/resource/format/carbonEffect/CjsCarbonEffectReader.js.map

@@ -1 +1 @@
-{"version":3,"file":"CjsCarbonEffectReader.js","sources":["../../../../../src/resource/format/carbonEffect/CjsCarbonEffectReader.js"],"sourcesContent":["// Source: trinity/trinity/Resources/Tr2EffectRes.cpp (DoLoad, GetShader)\r\n// Source: trinity/shadercompiler/ShaderCompiler.cpp:746-845 (file assembly)\r\n\r\nimport { CjsByteReader } from \"../CjsByteReader.js\";\r\nimport { CjsFormatReadError } from \"../CjsFormatError.js\";\r\nimport {\r\n    CARBON_EFFECT_DATA_VERSION,\r\n    CARBON_EFFECT_MIN_DATA_VERSION,\r\n    readEffectDescription\r\n} from \"./carbonEffectRecords.js\";\r\n\r\n/** Byte count of the ASCII-hex MD5 source hash in the v15 header. */\r\nexport const CARBON_EFFECT_SOURCE_HASH_BYTES = 32;\r\n\r\n/** Byte count of one offset-table row: `{u32 index, u32 offset, u32 size}`. */\r\nexport const CARBON_EFFECT_RECORD_BYTES = 12;\r\n\r\n/**\r\n * Plain byte cursor over one description blob, carrying the Carbon effect error\r\n * class and message.\r\n *\r\n * Separate from the container reader because the container reader parses its\r\n * header in the constructor; a body needs a cursor, not a second header parse.\r\n */\r\nexport class CjsCarbonEffectBodyReader extends CjsByteReader\r\n{\r\n    static ReadError = CjsFormatReadError;\r\n\r\n    static endOfDataMessage = \"Unexpected end of Carbon effect data\";\r\n}\r\n\r\n/**\r\n * Reader for Carbon's compiled-effect container, versions 8 through 15.\r\n *\r\n * The v15 header is (`ShaderCompiler.cpp:822-831`):\r\n *\r\n * ```\r\n * u32      version = 15\r\n * u8[4]    shaderCompilerVersion       <- four bytes, not a u32\r\n * char[32] sourceHash                  <- ASCII hex MD5 of the HLSL inputs\r\n * u32      stringTableSize | arena\r\n * u8       permutationCount | permutation records\r\n * u32      recordCount     | recordCount x { u32 index, u32 offset, u32 size }\r\n * description blobs\r\n * ```\r\n *\r\n * Versions 8..14 differ in the header by exactly one thing: the compiler\r\n * version and source hash are absent, so `compilerVersion` and `sourceHash`\r\n * are null for them. Everything else — arena, permutation records, offset\r\n * table — is byte-identical across the accepted range.\r\n *\r\n * Carbon validates the version at 2..15 (`Tr2EffectRes.cpp:209`), then threads\r\n * it through parsing rather than gating on it again: it forwards the version\r\n * into the description reader (`Tr2EffectRes.cpp:128`), where\r\n * `Tr2EffectDescription.cpp` branches at 22 conditional sites. The version\r\n * decides the byte layout at nearly every level - whether a stage carries a\r\n * register signature at all (`> 8`), where pipeline inputs are read (`< 14`),\r\n * how a constant's type byte is decoded (`< 11`), and whether a resource\r\n * carries `arrayElements` at all (`>= 13`).\r\n *\r\n * This reader carries the same parameter, restored per the 2026-08-02\r\n * maintainer decision with 8 as the floor (see\r\n * `CARBON_EFFECT_MIN_DATA_VERSION`). Reading a version is not supporting it:\r\n * the reader's job ends at a correct record tree, normalized to the v15\r\n * record shape, and what an engine can do with an old body is a separate\r\n * question. Versions below 8 are still rejected outright — those branches\r\n * have no examined file and no writer to check against, and applying newer\r\n * rules to an older layout misaligns fields silently.\r\n */\r\nexport class CjsCarbonEffectReader extends CjsCarbonEffectBodyReader\r\n{\r\n    /** Cursor class used for description blobs. */\r\n    static BodyReader = CjsCarbonEffectBodyReader;\r\n\r\n    /**\r\n     * Reads the container header, arena, permutation axes and offset table.\r\n     *\r\n     * @param {ArrayBuffer|ArrayBufferView|Uint8Array} bytes Container bytes.\r\n     * @param {object} [options] Read options.\r\n     * @param {string} [options.source] Source name used in error details.\r\n     * @param {boolean} [options.permissive] Accept a sparse or misordered offset\r\n     *     table instead of rejecting it. For forensic inspection of a file already\r\n     *     known to be malformed; never for a load path.\r\n     */\r\n    constructor(bytes, options = {})\r\n    {\r\n        super(bytes, options);\r\n\r\n        this.version = this.ReadUint32();\r\n        if (this.version < CARBON_EFFECT_MIN_DATA_VERSION || this.version > CARBON_EFFECT_DATA_VERSION)\r\n        {\r\n            throw this._error(\r\n                `Unsupported Carbon effect version ${this.version}; expected ${CARBON_EFFECT_MIN_DATA_VERSION}..${CARBON_EFFECT_DATA_VERSION}`,\r\n                { version: this.version }\r\n            );\r\n        }\r\n\r\n        // The compiler version and source hash are the v15 header additions;\r\n        // an older header goes straight from the version to the arena.\r\n        if (this.version === CARBON_EFFECT_DATA_VERSION)\r\n        {\r\n            this.compilerVersion = Array.from(this.ReadRaw(4));\r\n            this.sourceHash = Uint8Array.from(this.ReadRaw(CARBON_EFFECT_SOURCE_HASH_BYTES));\r\n        }\r\n        else\r\n        {\r\n            this.compilerVersion = null;\r\n            this.sourceHash = null;\r\n        }\r\n\r\n        this.stringTableSize = this.ReadUint32();\r\n        if (this.offset + this.stringTableSize > this.bytes.length)\r\n        {\r\n            throw this._error(\"Invalid Carbon effect string-table size\", {\r\n                stringTableSize: this.stringTableSize,\r\n                byteLength: this.bytes.length\r\n            });\r\n        }\r\n        this.stringTableBytes = this.bytes.subarray(this.offset, this.offset + this.stringTableSize);\r\n        this.Skip(this.stringTableSize);\r\n        this.SetStringTable(this.stringTableBytes, this.stringTableSize);\r\n\r\n        this.permutations = this.#readPermutations();\r\n        this.records = this.#readRecords();\r\n        this.headerEnd = this.offset;\r\n        this.diagnostics = this.#inspect();\r\n\r\n        if (!options.permissive)\r\n        {\r\n            this.requireDensePermutationTable();\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Returns the product of the permutation axes' option counts — the number of\r\n     * offset-table rows a fully populated file has.\r\n     *\r\n     * @returns {number} Permutation count.\r\n     */\r\n    get permutationProduct()\r\n    {\r\n        let product = 1;\r\n        for (const permutation of this.permutations)\r\n        {\r\n            product *= permutation.options.length;\r\n        }\r\n        return product;\r\n    }\r\n\r\n    /**\r\n     * Throws unless the offset table is dense and positionally indexed.\r\n     *\r\n     * Carbon indexes `m_offsets` positionally and never reads the stored `index`\r\n     * field (`Tr2EffectRes.cpp:121-126`), so a sparse or misordered table does\r\n     * not fail — it silently returns the wrong shader body. Carbon gets density\r\n     * incidentally, from `g_compiledEffects` being a `std::map` densely keyed by\r\n     * `AddPermutationsToWorkQueue`, and promises it nowhere.\r\n     *\r\n     * Measured across the whole shipped corpus at build 3444265 — 4833 files and\r\n     * 78,498 rows across `effect.dx11`, `effect.dx12` and `effect.metal` — both\r\n     * conditions hold in every file, so this runs by default.\r\n     *\r\n     * `--ignore-permutations` does make CCP's compiler emit only key 0 while\r\n     * declaring every axis, so a sparse file is producible. That argues for an\r\n     * escape hatch, not for permissiveness: because Carbon indexes positionally,\r\n     * accepting such a file returns the wrong permutation's shader silently, which\r\n     * is exactly the failure class this container port exists to close.\r\n     * `{ permissive: true }` is the opt-in, for inspecting a file already known to\r\n     * be malformed.\r\n     */\r\n    requireDensePermutationTable()\r\n    {\r\n        if (!this.diagnostics.dense)\r\n        {\r\n            throw this._error(\"Carbon effect offset table is sparse\", {\r\n                recordCount: this.records.length,\r\n                permutationProduct: this.permutationProduct\r\n            });\r\n        }\r\n        if (!this.diagnostics.indicesMatchPosition)\r\n        {\r\n            throw this._error(\"Carbon effect offset table is not positionally indexed\", {\r\n                firstMismatch: this.diagnostics.firstIndexMismatch\r\n            });\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Reads and parses one permutation's description blob.\r\n     *\r\n     * `backend` is **optional**, and omitting it is the interesting case. A\r\n     * Carbon file ends each pass at the render states; ours adds one eight-byte\r\n     * block reference. Nothing in the header distinguishes the two, and we\r\n     * deliberately do not add anything — no envelope, no version of our own,\r\n     * because CCP owns the version space and a container that announces itself\r\n     * is an invention nothing requires.\r\n     *\r\n     * Instead the blob describes itself, using a rule the format already has.\r\n     * Every sized record must parse to exactly its declared end (Rule 1), and a\r\n     * body's declared size is in the offset table. So the wrong interpretation\r\n     * either throws or leaves the cursor somewhere other than the end, and one\r\n     * retry settles it.\r\n     *\r\n     * Pass `backend` explicitly when the caller knows — the loader does, because\r\n     * backend selection is by resource path, mirroring Carbon's\r\n     * `effect.dx11`/`effect.dx12`/`effect.metal`. Auto-detection is for bytes\r\n     * that arrive without that context: tooling, caches, inspection.\r\n     *\r\n     * @param {number} index Permutation index, positional in the offset table.\r\n     * @param {object} [options] Read options.\r\n     * @param {boolean} [options.backend] Expect our optional per-pass trailing\r\n     *     block. Omit to detect it from the blob's declared end.\r\n     * @returns {object} Description record tree.\r\n     */\r\n    readDescription(index, options = {})\r\n    {\r\n        const record = this.records[index];\r\n        if (!record)\r\n        {\r\n            throw this._error(`No Carbon effect body at permutation index ${index}`, {\r\n                index,\r\n                recordCount: this.records.length\r\n            });\r\n        }\r\n\r\n        if (options.backend !== undefined)\r\n        {\r\n            return this.#readDescriptionAs(record, options.backend === true);\r\n        }\r\n\r\n        // Plain Carbon first: it is the larger population, and it is the reading\r\n        // that must stay cheap.\r\n        try\r\n        {\r\n            return this.#readDescriptionAs(record, false);\r\n        }\r\n        catch (withoutBlocks)\r\n        {\r\n            try\r\n            {\r\n                return this.#readDescriptionAs(record, true);\r\n            }\r\n            catch\r\n            {\r\n                // Report the plain-Carbon failure. If neither reading works the\r\n                // blob is malformed, and the Carbon diagnosis is the useful one;\r\n                // the backend attempt's error would describe a misparse of bytes\r\n                // that were never a backend block.\r\n                throw withoutBlocks;\r\n            }\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Parses one body under an exact backend-block assumption.\r\n     *\r\n     * @param {object} record Offset-table row.\r\n     * @param {boolean} backend Whether to expect the per-pass block.\r\n     * @returns {object} Description record tree.\r\n     */\r\n    #readDescriptionAs(record, backend)\r\n    {\r\n        const reader = new this.constructor.BodyReader(this.bytes, {\r\n            source: this.source,\r\n            offset: record.offset,\r\n            end: record.offset + record.size,\r\n            stringTable: this.stringTableBytes,\r\n            stringTableSize: this.stringTableSize\r\n        });\r\n        return readEffectDescription(reader, { backend, version: this.version });\r\n    }\r\n\r\n    /**\r\n     * Returns the raw description-blob bytes for one permutation.\r\n     *\r\n     * @param {number} index Permutation index, positional in the offset table.\r\n     * @returns {Uint8Array} View over the body bytes.\r\n     */\r\n    bodyBytes(index)\r\n    {\r\n        const record = this.records[index];\r\n        if (!record)\r\n        {\r\n            throw this._error(`No Carbon effect body at permutation index ${index}`, { index });\r\n        }\r\n        return this.bytes.subarray(record.offset, record.offset + record.size);\r\n    }\r\n\r\n    /**\r\n     * Reads the permutation axis records (`ShaderCompiler.cpp:769-795`,\r\n     * `Tr2EffectRes.cpp:263-292`).\r\n     *\r\n     * @returns {object[]} Permutation axes with arena references retained.\r\n     */\r\n    #readPermutations()\r\n    {\r\n        const permutations = [];\r\n        const count = this.ReadUint8();\r\n        for (let index = 0; index < count; index += 1)\r\n        {\r\n            const nameOffset = this.ReadUint32();\r\n            const name = this.ReadStringAt(nameOffset);\r\n            const defaultOption = this.ReadUint8();\r\n            const descriptionOffset = this.ReadUint32();\r\n            const description = this.ReadStringAt(descriptionOffset);\r\n            const type = this.ReadUint8();\r\n\r\n            const options = [];\r\n            const optionCount = this.ReadUint8();\r\n            for (let optionIndex = 0; optionIndex < optionCount; optionIndex += 1)\r\n            {\r\n                const offset = this.ReadUint32();\r\n                options.push({ offset, value: this.ReadStringAt(offset) });\r\n            }\r\n\r\n            permutations.push({\r\n                name: { offset: nameOffset, value: name },\r\n                defaultOption,\r\n                description: { offset: descriptionOffset, value: description },\r\n                type,\r\n                options\r\n            });\r\n        }\r\n        return permutations;\r\n    }\r\n\r\n    /**\r\n     * Reads the offset table (`ShaderCompiler.cpp:800-820`,\r\n     * `Tr2EffectRes.cpp:294-311`).\r\n     *\r\n     * @returns {object[]} Offset-table rows.\r\n     */\r\n    #readRecords()\r\n    {\r\n        const count = this.ReadUint32();\r\n        if (count === 0)\r\n        {\r\n            throw this._error(\"Carbon effect contains no compiled bodies\");\r\n        }\r\n        if (this.offset + count * CARBON_EFFECT_RECORD_BYTES > this.bytes.length)\r\n        {\r\n            throw this._error(\"Carbon effect offset table runs past the end of the file\", {\r\n                recordCount: count,\r\n                byteLength: this.bytes.length\r\n            });\r\n        }\r\n\r\n        const records = [];\r\n        for (let index = 0; index < count; index += 1)\r\n        {\r\n            records.push({\r\n                index: this.ReadUint32(),\r\n                offset: this.ReadUint32(),\r\n                size: this.ReadUint32()\r\n            });\r\n        }\r\n        return records;\r\n    }\r\n\r\n    /**\r\n     * Validates every row's byte range and collects the structural diagnostics\r\n     * Carbon relies on without stating.\r\n     *\r\n     * @returns {object} Structural diagnostics.\r\n     */\r\n    #inspect()\r\n    {\r\n        const headerEnd = this.headerEnd;\r\n        const byteLength = this.bytes.length;\r\n        let firstIndexMismatch = null;\r\n        const uniqueOffsets = new Set();\r\n\r\n        for (let index = 0; index < this.records.length; index += 1)\r\n        {\r\n            const record = this.records[index];\r\n            if (record.index !== index && firstIndexMismatch === null)\r\n            {\r\n                firstIndexMismatch = { position: index, storedIndex: record.index };\r\n            }\r\n            const end = record.offset + record.size;\r\n            if (record.offset < headerEnd || end > byteLength || record.size === 0)\r\n            {\r\n                throw this._error(`Carbon effect body record ${index} is out of range`, {\r\n                    position: index,\r\n                    offset: record.offset,\r\n                    size: record.size,\r\n                    headerEnd,\r\n                    byteLength\r\n                });\r\n            }\r\n            uniqueOffsets.add(record.offset);\r\n        }\r\n\r\n        // The body region must begin exactly where the header ends. Carbon computes\r\n        // its first body offset as `4 + 4 + 32 + headerSize + stringTable.GetSize()`\r\n        // (`ShaderCompiler.cpp:801`), so a gap or an overlap means our reconstruction\r\n        // of that arithmetic disagrees with the writer's — which would silently\r\n        // misread every body rather than fail. Carbon's own reader does not check\r\n        // this; measured across 4833 shipped files, every one starts its body region\r\n        // flush against the header with no slack.\r\n        const firstBody = Math.min(...this.records.map((record) => record.offset));\r\n        if (firstBody !== headerEnd)\r\n        {\r\n            throw this._error(\"Carbon effect body region does not start where the header ends\", {\r\n                firstBody,\r\n                headerEnd,\r\n                slack: firstBody - headerEnd\r\n            });\r\n        }\r\n\r\n        return {\r\n            recordCount: this.records.length,\r\n            permutationProduct: this.permutationProduct,\r\n            dense: this.records.length === this.permutationProduct,\r\n            indicesMatchPosition: firstIndexMismatch === null,\r\n            firstIndexMismatch,\r\n            uniqueBodyCount: uniqueOffsets.size,\r\n            aliasedRowCount: this.records.length - uniqueOffsets.size\r\n        };\r\n    }\r\n}\r\n\r\n/**\r\n * Reports whether a payload has the Carbon effect container shape.\r\n *\r\n * A **shape** check, not an identity check, and the distinction is the point:\r\n * our containers are stock Carbon files, so nothing in the bytes separates one\r\n * from a shipped `effect.dx11`. Identity comes from the resource path the file\r\n * was resolved through - `effect.webgl/` versus `effect.dx11/` - exactly as it\r\n * does for Carbon, whose own backend trees are byte-format-identical.\r\n *\r\n * Both backend sniffs call this rather than each keeping a copy of the version\r\n * dword. Two hand-written copies of one constant are two chances to disagree.\r\n *\r\n * @param {Uint8Array} bytes Candidate payload.\r\n * @returns {boolean} True when the payload opens on Carbon's version dword.\r\n */\r\nexport function looksLikeCarbonEffectContainer(bytes)\r\n{\r\n    if (!bytes || bytes.length < 4) return false;\r\n    return bytes[0] === CARBON_EFFECT_DATA_VERSION\r\n        && bytes[1] === 0\r\n        && bytes[2] === 0\r\n        && bytes[3] === 0;\r\n}\r\n\r\nexport default CjsCarbonEffectReader;\r\n"],"names":["CARBON_EFFECT_SOURCE_HASH_BYTES","CARBON_EFFECT_RECORD_BYTES","CjsCarbonEffectBodyReader","CjsByteReader","ReadError","CjsFormatReadError","endOfDataMessage","CjsCarbonEffectReader","BodyReader","constructor","bytes","options","version","ReadUint32","CARBON_EFFECT_MIN_DATA_VERSION","CARBON_EFFECT_DATA_VERSION","_error","compilerVersion","Array","from","ReadRaw","sourceHash","Uint8Array","stringTableSize","offset","length","byteLength","stringTableBytes","subarray","Skip","SetStringTable","permutations","records","headerEnd","diagnostics","permissive","requireDensePermutationTable","permutationProduct","product","permutation","dense","recordCount","indicesMatchPosition","firstMismatch","firstIndexMismatch","readDescription","index","record","backend","undefined","withoutBlocks","#readDescriptionAs","reader","source","end","size","stringTable","readEffectDescription","bodyBytes","#readPermutations","count","ReadUint8","nameOffset","name","ReadStringAt","defaultOption","descriptionOffset","description","type","optionCount","optionIndex","push","value","#readRecords","#inspect","uniqueOffsets","Set","position","storedIndex","add","firstBody","Math","min","map","slack","uniqueBodyCount","aliasedRowCount","looksLikeCarbonEffectContainer"],"mappings":"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"}
+{"version":3,"file":"CjsCarbonEffectReader.js","sources":["../../../../../src/resource/format/carbonEffect/CjsCarbonEffectReader.js"],"sourcesContent":["// Source: trinity/trinity/Resources/Tr2EffectRes.cpp (DoLoad, GetShader)\r\n// Source: trinity/shadercompiler/ShaderCompiler.cpp:746-845 (file assembly)\r\n\r\nimport { CjsByteReader } from \"../CjsByteReader.js\";\r\nimport { CjsFormatReadError } from \"../CjsFormatError.js\";\r\nimport {\r\n    CARBON_EFFECT_DATA_VERSION,\r\n    CARBON_EFFECT_MIN_DATA_VERSION,\r\n    readEffectDescription\r\n} from \"./carbonEffectRecords.js\";\r\n\r\n/** Byte count of the ASCII-hex MD5 source hash in the v15 header. */\r\nexport const CARBON_EFFECT_SOURCE_HASH_BYTES = 32;\r\n\r\n/** Byte count of one offset-table row: `{u32 index, u32 offset, u32 size}`. */\r\nexport const CARBON_EFFECT_RECORD_BYTES = 12;\r\n\r\n/**\r\n * Plain byte cursor over one description blob, carrying the Carbon effect error\r\n * class and message.\r\n *\r\n * Separate from the container reader because the container reader parses its\r\n * header in the constructor; a body needs a cursor, not a second header parse.\r\n */\r\nexport class CjsCarbonEffectBodyReader extends CjsByteReader\r\n{\r\n    static ReadError = CjsFormatReadError;\r\n\r\n    static endOfDataMessage = \"Unexpected end of Carbon effect data\";\r\n}\r\n\r\n/**\r\n * Reader for Carbon's compiled-effect container, versions 8 through 15.\r\n *\r\n * The v15 header is (`ShaderCompiler.cpp:822-831`):\r\n *\r\n * ```\r\n * u32      version = 15\r\n * u8[4]    shaderCompilerVersion       <- four bytes, not a u32\r\n * char[32] sourceHash                  <- ASCII hex MD5 of the HLSL inputs\r\n * u32      stringTableSize | arena\r\n * u8       permutationCount | permutation records\r\n * u32      recordCount     | recordCount x { u32 index, u32 offset, u32 size }\r\n * description blobs\r\n * ```\r\n *\r\n * Versions 8..14 differ in the header by exactly one thing: the compiler\r\n * version and source hash are absent, so `compilerVersion` and `sourceHash`\r\n * are null for them. Everything else — arena, permutation records, offset\r\n * table — is byte-identical across the accepted range.\r\n *\r\n * Carbon validates the version at 2..15 (`Tr2EffectRes.cpp:209`), then threads\r\n * it through parsing rather than gating on it again: it forwards the version\r\n * into the description reader (`Tr2EffectRes.cpp:128`), where\r\n * `Tr2EffectDescription.cpp` branches at 22 conditional sites. The version\r\n * decides the byte layout at nearly every level - whether a stage carries a\r\n * register signature at all (`> 8`), where pipeline inputs are read (`< 14`),\r\n * how a constant's type byte is decoded (`< 11`), and whether a resource\r\n * carries `arrayElements` at all (`>= 13`).\r\n *\r\n * This reader carries the same parameter, restored per the 2026-08-02\r\n * maintainer decision with 8 as the floor (see\r\n * `CARBON_EFFECT_MIN_DATA_VERSION`). Reading a version is not supporting it:\r\n * the reader's job ends at a correct record tree, normalized to the v15\r\n * record shape, and what an engine can do with an old body is a separate\r\n * question. Versions below 8 are still rejected outright — those branches\r\n * have no examined file and no writer to check against, and applying newer\r\n * rules to an older layout misaligns fields silently.\r\n */\r\nexport class CjsCarbonEffectReader extends CjsCarbonEffectBodyReader\r\n{\r\n    /** Cursor class used for description blobs. */\r\n    static BodyReader = CjsCarbonEffectBodyReader;\r\n\r\n    /**\r\n     * Reads the container header, arena, permutation axes and offset table.\r\n     *\r\n     * @param {ArrayBuffer|ArrayBufferView|Uint8Array} bytes Container bytes.\r\n     * @param {object} [options] Read options.\r\n     * @param {string} [options.source] Source name used in error details.\r\n     * @param {boolean} [options.permissive] Accept a sparse or misordered offset\r\n     *     table instead of rejecting it. For forensic inspection of a file already\r\n     *     known to be malformed; never for a load path.\r\n     */\r\n    constructor(bytes, options = {})\r\n    {\r\n        super(bytes, options);\r\n\r\n        this.version = this.ReadUint32();\r\n        if (this.version < CARBON_EFFECT_MIN_DATA_VERSION || this.version > CARBON_EFFECT_DATA_VERSION)\r\n        {\r\n            throw this._error(\r\n                `Unsupported Carbon effect version ${this.version}; expected ${CARBON_EFFECT_MIN_DATA_VERSION}..${CARBON_EFFECT_DATA_VERSION}`,\r\n                { version: this.version }\r\n            );\r\n        }\r\n\r\n        // The compiler version and source hash are the v15 header additions;\r\n        // an older header goes straight from the version to the arena.\r\n        if (this.version === CARBON_EFFECT_DATA_VERSION)\r\n        {\r\n            this.compilerVersion = Array.from(this.ReadRaw(4));\r\n            this.sourceHash = Uint8Array.from(this.ReadRaw(CARBON_EFFECT_SOURCE_HASH_BYTES));\r\n        }\r\n        else\r\n        {\r\n            this.compilerVersion = null;\r\n            this.sourceHash = null;\r\n        }\r\n\r\n        this.stringTableSize = this.ReadUint32();\r\n        if (this.offset + this.stringTableSize > this.bytes.length)\r\n        {\r\n            throw this._error(\"Invalid Carbon effect string-table size\", {\r\n                stringTableSize: this.stringTableSize,\r\n                byteLength: this.bytes.length\r\n            });\r\n        }\r\n        this.stringTableBytes = this.bytes.subarray(this.offset, this.offset + this.stringTableSize);\r\n        this.Skip(this.stringTableSize);\r\n        this.SetStringTable(this.stringTableBytes, this.stringTableSize);\r\n\r\n        this.permutations = this._readPermutations();\r\n        this.records = this._readRecords();\r\n        this.headerEnd = this.offset;\r\n        this.diagnostics = this._inspect();\r\n\r\n        if (!options.permissive)\r\n        {\r\n            this.requireDensePermutationTable();\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Returns the product of the permutation axes' option counts — the number of\r\n     * offset-table rows a fully populated file has.\r\n     *\r\n     * @returns {number} Permutation count.\r\n     */\r\n    get permutationProduct()\r\n    {\r\n        let product = 1;\r\n        for (const permutation of this.permutations)\r\n        {\r\n            product *= permutation.options.length;\r\n        }\r\n        return product;\r\n    }\r\n\r\n    /**\r\n     * Throws unless the offset table is dense and positionally indexed.\r\n     *\r\n     * Carbon indexes `m_offsets` positionally and never reads the stored `index`\r\n     * field (`Tr2EffectRes.cpp:121-126`), so a sparse or misordered table does\r\n     * not fail — it silently returns the wrong shader body. Carbon gets density\r\n     * incidentally, from `g_compiledEffects` being a `std::map` densely keyed by\r\n     * `AddPermutationsToWorkQueue`, and promises it nowhere.\r\n     *\r\n     * Measured across the whole shipped corpus at build 3444265 — 4833 files and\r\n     * 78,498 rows across `effect.dx11`, `effect.dx12` and `effect.metal` — both\r\n     * conditions hold in every file, so this runs by default.\r\n     *\r\n     * `--ignore-permutations` does make CCP's compiler emit only key 0 while\r\n     * declaring every axis, so a sparse file is producible. That argues for an\r\n     * escape hatch, not for permissiveness: because Carbon indexes positionally,\r\n     * accepting such a file returns the wrong permutation's shader silently, which\r\n     * is exactly the failure class this container port exists to close.\r\n     * `{ permissive: true }` is the opt-in, for inspecting a file already known to\r\n     * be malformed.\r\n     */\r\n    requireDensePermutationTable()\r\n    {\r\n        if (!this.diagnostics.dense)\r\n        {\r\n            throw this._error(\"Carbon effect offset table is sparse\", {\r\n                recordCount: this.records.length,\r\n                permutationProduct: this.permutationProduct\r\n            });\r\n        }\r\n        if (!this.diagnostics.indicesMatchPosition)\r\n        {\r\n            throw this._error(\"Carbon effect offset table is not positionally indexed\", {\r\n                firstMismatch: this.diagnostics.firstIndexMismatch\r\n            });\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Reads and parses one permutation's description blob.\r\n     *\r\n     * `backend` is **optional**, and omitting it is the interesting case. A\r\n     * Carbon file ends each pass at the render states; ours adds one eight-byte\r\n     * block reference. Nothing in the header distinguishes the two, and we\r\n     * deliberately do not add anything — no envelope, no version of our own,\r\n     * because CCP owns the version space and a container that announces itself\r\n     * is an invention nothing requires.\r\n     *\r\n     * Instead the blob describes itself, using a rule the format already has.\r\n     * Every sized record must parse to exactly its declared end (Rule 1), and a\r\n     * body's declared size is in the offset table. So the wrong interpretation\r\n     * either throws or leaves the cursor somewhere other than the end, and one\r\n     * retry settles it.\r\n     *\r\n     * Pass `backend` explicitly when the caller knows — the loader does, because\r\n     * backend selection is by resource path, mirroring Carbon's\r\n     * `effect.dx11`/`effect.dx12`/`effect.metal`. Auto-detection is for bytes\r\n     * that arrive without that context: tooling, caches, inspection.\r\n     *\r\n     * @param {number} index Permutation index, positional in the offset table.\r\n     * @param {object} [options] Read options.\r\n     * @param {boolean} [options.backend] Expect our optional per-pass trailing\r\n     *     block. Omit to detect it from the blob's declared end.\r\n     * @returns {object} Description record tree.\r\n     */\r\n    readDescription(index, options = {})\r\n    {\r\n        const record = this.records[index];\r\n        if (!record)\r\n        {\r\n            throw this._error(`No Carbon effect body at permutation index ${index}`, {\r\n                index,\r\n                recordCount: this.records.length\r\n            });\r\n        }\r\n\r\n        if (options.backend !== undefined)\r\n        {\r\n            return this._readDescriptionAs(record, options.backend === true);\r\n        }\r\n\r\n        // Plain Carbon first: it is the larger population, and it is the reading\r\n        // that must stay cheap.\r\n        try\r\n        {\r\n            return this._readDescriptionAs(record, false);\r\n        }\r\n        catch (withoutBlocks)\r\n        {\r\n            try\r\n            {\r\n                return this._readDescriptionAs(record, true);\r\n            }\r\n            catch\r\n            {\r\n                // Report the plain-Carbon failure. If neither reading works the\r\n                // blob is malformed, and the Carbon diagnosis is the useful one;\r\n                // the backend attempt's error would describe a misparse of bytes\r\n                // that were never a backend block.\r\n                throw withoutBlocks;\r\n            }\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Parses one body under an exact backend-block assumption.\r\n     *\r\n     * @param {object} record Offset-table row.\r\n     * @param {boolean} backend Whether to expect the per-pass block.\r\n     * @returns {object} Description record tree.\r\n     */\r\n    _readDescriptionAs(record, backend)\r\n    {\r\n        const reader = new this.constructor.BodyReader(this.bytes, {\r\n            source: this.source,\r\n            offset: record.offset,\r\n            end: record.offset + record.size,\r\n            stringTable: this.stringTableBytes,\r\n            stringTableSize: this.stringTableSize\r\n        });\r\n        return readEffectDescription(reader, { backend, version: this.version });\r\n    }\r\n\r\n    /**\r\n     * Returns the raw description-blob bytes for one permutation.\r\n     *\r\n     * @param {number} index Permutation index, positional in the offset table.\r\n     * @returns {Uint8Array} View over the body bytes.\r\n     */\r\n    bodyBytes(index)\r\n    {\r\n        const record = this.records[index];\r\n        if (!record)\r\n        {\r\n            throw this._error(`No Carbon effect body at permutation index ${index}`, { index });\r\n        }\r\n        return this.bytes.subarray(record.offset, record.offset + record.size);\r\n    }\r\n\r\n    /**\r\n     * Reads the permutation axis records (`ShaderCompiler.cpp:769-795`,\r\n     * `Tr2EffectRes.cpp:263-292`).\r\n     *\r\n     * @returns {object[]} Permutation axes with arena references retained.\r\n     */\r\n    _readPermutations()\r\n    {\r\n        const permutations = [];\r\n        const count = this.ReadUint8();\r\n        for (let index = 0; index < count; index += 1)\r\n        {\r\n            const nameOffset = this.ReadUint32();\r\n            const name = this.ReadStringAt(nameOffset);\r\n            const defaultOption = this.ReadUint8();\r\n            const descriptionOffset = this.ReadUint32();\r\n            const description = this.ReadStringAt(descriptionOffset);\r\n            const type = this.ReadUint8();\r\n\r\n            const options = [];\r\n            const optionCount = this.ReadUint8();\r\n            for (let optionIndex = 0; optionIndex < optionCount; optionIndex += 1)\r\n            {\r\n                const offset = this.ReadUint32();\r\n                options.push({ offset, value: this.ReadStringAt(offset) });\r\n            }\r\n\r\n            permutations.push({\r\n                name: { offset: nameOffset, value: name },\r\n                defaultOption,\r\n                description: { offset: descriptionOffset, value: description },\r\n                type,\r\n                options\r\n            });\r\n        }\r\n        return permutations;\r\n    }\r\n\r\n    /**\r\n     * Reads the offset table (`ShaderCompiler.cpp:800-820`,\r\n     * `Tr2EffectRes.cpp:294-311`).\r\n     *\r\n     * @returns {object[]} Offset-table rows.\r\n     */\r\n    _readRecords()\r\n    {\r\n        const count = this.ReadUint32();\r\n        if (count === 0)\r\n        {\r\n            throw this._error(\"Carbon effect contains no compiled bodies\");\r\n        }\r\n        if (this.offset + count * CARBON_EFFECT_RECORD_BYTES > this.bytes.length)\r\n        {\r\n            throw this._error(\"Carbon effect offset table runs past the end of the file\", {\r\n                recordCount: count,\r\n                byteLength: this.bytes.length\r\n            });\r\n        }\r\n\r\n        const records = [];\r\n        for (let index = 0; index < count; index += 1)\r\n        {\r\n            records.push({\r\n                index: this.ReadUint32(),\r\n                offset: this.ReadUint32(),\r\n                size: this.ReadUint32()\r\n            });\r\n        }\r\n        return records;\r\n    }\r\n\r\n    /**\r\n     * Validates every row's byte range and collects the structural diagnostics\r\n     * Carbon relies on without stating.\r\n     *\r\n     * @returns {object} Structural diagnostics.\r\n     */\r\n    _inspect()\r\n    {\r\n        const headerEnd = this.headerEnd;\r\n        const byteLength = this.bytes.length;\r\n        let firstIndexMismatch = null;\r\n        const uniqueOffsets = new Set();\r\n\r\n        for (let index = 0; index < this.records.length; index += 1)\r\n        {\r\n            const record = this.records[index];\r\n            if (record.index !== index && firstIndexMismatch === null)\r\n            {\r\n                firstIndexMismatch = { position: index, storedIndex: record.index };\r\n            }\r\n            const end = record.offset + record.size;\r\n            if (record.offset < headerEnd || end > byteLength || record.size === 0)\r\n            {\r\n                throw this._error(`Carbon effect body record ${index} is out of range`, {\r\n                    position: index,\r\n                    offset: record.offset,\r\n                    size: record.size,\r\n                    headerEnd,\r\n                    byteLength\r\n                });\r\n            }\r\n            uniqueOffsets.add(record.offset);\r\n        }\r\n\r\n        // The body region must begin exactly where the header ends. Carbon computes\r\n        // its first body offset as `4 + 4 + 32 + headerSize + stringTable.GetSize()`\r\n        // (`ShaderCompiler.cpp:801`), so a gap or an overlap means our reconstruction\r\n        // of that arithmetic disagrees with the writer's — which would silently\r\n        // misread every body rather than fail. Carbon's own reader does not check\r\n        // this; measured across 4833 shipped files, every one starts its body region\r\n        // flush against the header with no slack.\r\n        const firstBody = Math.min(...this.records.map((record) => record.offset));\r\n        if (firstBody !== headerEnd)\r\n        {\r\n            throw this._error(\"Carbon effect body region does not start where the header ends\", {\r\n                firstBody,\r\n                headerEnd,\r\n                slack: firstBody - headerEnd\r\n            });\r\n        }\r\n\r\n        return {\r\n            recordCount: this.records.length,\r\n            permutationProduct: this.permutationProduct,\r\n            dense: this.records.length === this.permutationProduct,\r\n            indicesMatchPosition: firstIndexMismatch === null,\r\n            firstIndexMismatch,\r\n            uniqueBodyCount: uniqueOffsets.size,\r\n            aliasedRowCount: this.records.length - uniqueOffsets.size\r\n        };\r\n    }\r\n}\r\n\r\n/**\r\n * Reports whether a payload has the Carbon effect container shape.\r\n *\r\n * A **shape** check, not an identity check, and the distinction is the point:\r\n * our containers are stock Carbon files, so nothing in the bytes separates one\r\n * from a shipped `effect.dx11`. Identity comes from the resource path the file\r\n * was resolved through - `effect.webgl/` versus `effect.dx11/` - exactly as it\r\n * does for Carbon, whose own backend trees are byte-format-identical.\r\n *\r\n * Both backend sniffs call this rather than each keeping a copy of the version\r\n * dword. Two hand-written copies of one constant are two chances to disagree.\r\n *\r\n * @param {Uint8Array} bytes Candidate payload.\r\n * @returns {boolean} True when the payload opens on Carbon's version dword.\r\n */\r\nexport function looksLikeCarbonEffectContainer(bytes)\r\n{\r\n    if (!bytes || bytes.length < 4) return false;\r\n    return bytes[0] === CARBON_EFFECT_DATA_VERSION\r\n        && bytes[1] === 0\r\n        && bytes[2] === 0\r\n        && bytes[3] === 0;\r\n}\r\n\r\nexport default CjsCarbonEffectReader;\r\n"],"names":["CARBON_EFFECT_SOURCE_HASH_BYTES","CARBON_EFFECT_RECORD_BYTES","CjsCarbonEffectBodyReader","CjsByteReader","ReadError","CjsFormatReadError","endOfDataMessage","CjsCarbonEffectReader","BodyReader","constructor","bytes","options","version","ReadUint32","CARBON_EFFECT_MIN_DATA_VERSION","CARBON_EFFECT_DATA_VERSION","_error","compilerVersion","Array","from","ReadRaw","sourceHash","Uint8Array","stringTableSize","offset","length","byteLength","stringTableBytes","subarray","Skip","SetStringTable","permutations","_readPermutations","records","_readRecords","headerEnd","diagnostics","_inspect","permissive","requireDensePermutationTable","permutationProduct","product","permutation","dense","recordCount","indicesMatchPosition","firstMismatch","firstIndexMismatch","readDescription","index","record","backend","undefined","_readDescriptionAs","withoutBlocks","reader","source","end","size","stringTable","readEffectDescription","bodyBytes","count","ReadUint8","nameOffset","name","ReadStringAt","defaultOption","descriptionOffset","description","type","optionCount","optionIndex","push","value","uniqueOffsets","Set","position","storedIndex","add","firstBody","Math","min","map","slack","uniqueBodyCount","aliasedRowCount","looksLikeCarbonEffectContainer"],"mappings":"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"}

package/dist/resource/format/carbonEffect/CjsCarbonEffectWriter.js

@@ -228,13 +228,13 @@ function writeCarbonEffectFile(parts) {
  * step with each other.
  */
 class CjsCarbonEffectWriter {
-  #table;
-  #permutations = [];
-  #bodies = [];
-  #compilerVersion;
-  #sourceHash;
-  #backend;
-  #version;
+  _table;
+  _permutations = [];
+  _bodies = [];
+  _compilerVersion;
+  _sourceHash;
+  _backend;
+  _version;
 
   /**
    * Creates an empty container builder.
@@ -250,11 +250,11 @@ class CjsCarbonEffectWriter {
    * @param {boolean} [options.backend] Emit the optional trailing block per pass.
    */
   constructor(options = {}) {
-    this.#version = resolveWriteVersion(options.version);
-    this.#table = options.stringTable ?? new CjsStringTable();
-    this.#compilerVersion = options.compilerVersion ?? [0, 0, 0, 0];
-    this.#sourceHash = options.sourceHash ?? "0".repeat(CARBON_EFFECT_SOURCE_HASH_BYTES);
-    this.#backend = options.backend === true;
+    this._version = resolveWriteVersion(options.version);
+    this._table = options.stringTable ?? new CjsStringTable();
+    this._compilerVersion = options.compilerVersion ?? [0, 0, 0, 0];
+    this._sourceHash = options.sourceHash ?? "0".repeat(CARBON_EFFECT_SOURCE_HASH_BYTES);
+    this._backend = options.backend === true;
   }
 
   /**
@@ -263,7 +263,7 @@ class CjsCarbonEffectWriter {
    * @returns {CjsStringTable} String table.
    */
   get stringTable() {
-    return this.#table;
+    return this._table;
   }
 
   /**
@@ -278,7 +278,7 @@ class CjsCarbonEffectWriter {
    * @returns {CjsCarbonEffectWriter} This builder.
    */
   addPermutation(axis) {
-    this.#permutations.push({
+    this._permutations.push({
       name: String(axis.name ?? ""),
       defaultOption: axis.defaultOption ?? 0,
       description: String(axis.description ?? ""),
@@ -296,7 +296,7 @@ class CjsCarbonEffectWriter {
    * @returns {CjsCarbonEffectWriter} This builder.
    */
   addBody(index, description) {
-    this.#bodies.push({
+    this._bodies.push({
       index,
       description,
       bytes: null
@@ -316,7 +316,7 @@ class CjsCarbonEffectWriter {
    * @returns {CjsCarbonEffectWriter} This builder.
    */
   addRawBody(index, bytes) {
-    this.#bodies.push({
+    this._bodies.push({
       index,
       description: null,
       bytes: Uint8Array.from(bytes)
@@ -330,23 +330,23 @@ class CjsCarbonEffectWriter {
    * @returns {Uint8Array} Container bytes.
    */
   toBytes() {
-    for (const axis of this.#permutations) {
-      axis.nameRef = this.#table.addString(axis.name);
-      axis.descriptionRef = this.#table.addString(axis.description);
-      axis.optionRefs = axis.options.map(option => this.#table.addString(option));
+    for (const axis of this._permutations) {
+      axis.nameRef = this._table.addString(axis.name);
+      axis.descriptionRef = this._table.addString(axis.description);
+      axis.optionRefs = axis.options.map(option => this._table.addString(option));
     }
-    for (const body of this.#bodies) {
+    for (const body of this._bodies) {
       if (body.description) {
         writeEffectDescription(new CjsByteWriter(), body.description, {
-          arena: collectArena(this.#table),
-          backend: this.#backend,
-          version: this.#version
+          arena: collectArena(this._table),
+          backend: this._backend,
+          version: this._version
         });
       }
     }
-    this.#table.finish();
-    const arena = internArena(this.#table);
-    const bodies = this.#bodies.map(body => {
+    this._table.finish();
+    const arena = internArena(this._table);
+    const bodies = this._bodies.map(body => {
       if (body.bytes) return {
         index: body.index,
         bytes: body.bytes
@@ -354,27 +354,27 @@ class CjsCarbonEffectWriter {
       const writer = new CjsByteWriter();
       writeEffectDescription(writer, body.description, {
         arena,
-        backend: this.#backend,
-        version: this.#version
+        backend: this._backend,
+        version: this._version
       });
       return {
         index: body.index,
         bytes: writer.toBytes()
       };
     });
-    const permutationRows = this.#permutations.map(axis => ({
+    const permutationRows = this._permutations.map(axis => ({
       name: axis.name,
-      nameOffset: this.#table.offsetOf(axis.nameRef),
+      nameOffset: this._table.offsetOf(axis.nameRef),
       defaultOption: axis.defaultOption,
-      descriptionOffset: this.#table.offsetOf(axis.descriptionRef),
+      descriptionOffset: this._table.offsetOf(axis.descriptionRef),
       type: axis.type,
-      options: axis.optionRefs.map(reference => this.#table.offsetOf(reference))
+      options: axis.optionRefs.map(reference => this._table.offsetOf(reference))
     }));
     return writeCarbonEffectFile({
-      version: this.#version,
-      compilerVersion: this.#compilerVersion,
-      sourceHash: this.#sourceHash,
-      stringTableBytes: this.#table.toBytes(),
+      version: this._version,
+      compilerVersion: this._compilerVersion,
+      sourceHash: this._sourceHash,
+      stringTableBytes: this._table.toBytes(),
       permutationRows,
       bodies
     });

package/dist/resource/format/carbonEffect/CjsCarbonEffectWriter.js.map

@@ -1 +1 @@
-{"version":3,"file":"CjsCarbonEffectWriter.js","sources":["../../../../../src/resource/format/carbonEffect/CjsCarbonEffectWriter.js"],"sourcesContent":["// Source: trinity/shadercompiler/ShaderCompiler.cpp:717-845 (alias dedupe, file assembly)\r\n\r\nimport { CjsByteWriter } from \"../CjsByteWriter.js\";\r\nimport { CjsStringTable } from \"../CjsStringTable.js\";\r\nimport { CjsFormatWriteError } from \"../CjsFormatError.js\";\r\nimport {\r\n    collectArena,\r\n    internArena,\r\n    resolveWriteVersion,\r\n    writeEffectDescription\r\n} from \"./carbonEffectRecords.js\";\r\nimport { CARBON_EFFECT_RECORD_BYTES, CARBON_EFFECT_SOURCE_HASH_BYTES } from \"./CjsCarbonEffectReader.js\";\r\n\r\nconst textEncoder = new TextEncoder();\r\n\r\n/**\r\n * Byte count of one permutation record's fixed part: `u32 name`,\r\n * `u8 defaultOption`, `u32 description`, `u8 type`, `u8 optionCount`\r\n * (`ShaderCompiler.cpp:757-761`).\r\n */\r\nconst PERMUTATION_FIXED_BYTES = 11;\r\n\r\n/**\r\n * FNV-1a over every byte, used to bucket body-dedupe candidates.\r\n *\r\n * @param {Uint8Array} bytes Byte run to hash.\r\n * @returns {number} 32-bit hash.\r\n */\r\nfunction hashBytes(bytes)\r\n{\r\n    let hash = 0x811c9dc5;\r\n    for (let index = 0; index < bytes.length; index += 1)\r\n    {\r\n        hash ^= bytes[index];\r\n        hash = Math.imul(hash, 0x01000193);\r\n    }\r\n    return hash >>> 0;\r\n}\r\n\r\n/**\r\n * Reports whether two byte runs are identical.\r\n *\r\n * @param {Uint8Array} a First byte run.\r\n * @param {Uint8Array} b Second byte run.\r\n * @returns {boolean} True when the runs match exactly.\r\n */\r\nfunction bytesEqual(a, b)\r\n{\r\n    if (a.length !== b.length) return false;\r\n    for (let index = 0; index < a.length; index += 1)\r\n    {\r\n        if (a[index] !== b[index]) return false;\r\n    }\r\n    return true;\r\n}\r\n\r\n/**\r\n * Normalises a source hash to the 32 ASCII bytes the header slot holds.\r\n *\r\n * @param {string|ArrayBufferView|Uint8Array} value 32 hex characters or 32 bytes.\r\n * @returns {Uint8Array} Exactly 32 bytes.\r\n */\r\nfunction normalizeSourceHash(value)\r\n{\r\n    const bytes = typeof value === \"string\"\r\n        ? textEncoder.encode(value)\r\n        : (value instanceof Uint8Array\r\n            ? value\r\n            : new Uint8Array(value.buffer, value.byteOffset, value.byteLength));\r\n    if (bytes.length !== CARBON_EFFECT_SOURCE_HASH_BYTES)\r\n    {\r\n        throw new CjsFormatWriteError(\r\n            `Source hash must be exactly ${CARBON_EFFECT_SOURCE_HASH_BYTES} bytes`,\r\n            { byteLength: bytes.length }\r\n        );\r\n    }\r\n    return bytes;\r\n}\r\n\r\n/**\r\n * Normalises a compiler version to the four bytes the header slot holds.\r\n *\r\n * The slot is `uint8_t[4]` — `{major, minor, patch, tweak}` from\r\n * `ShaderCompilerConfig.h.in:5`, of which Carbon's rebuild check compares only\r\n * the first three (`ModifiedTime.cpp:77`). Carbon's own runtime skips the field\r\n * entirely (`Tr2EffectRes.cpp:246-249`).\r\n *\r\n * @param {number[]|ArrayBufferView|Uint8Array} value Four version components.\r\n * @returns {Uint8Array} Exactly 4 bytes.\r\n */\r\nfunction normalizeCompilerVersion(value)\r\n{\r\n    const bytes = Array.isArray(value)\r\n        ? Uint8Array.from(value, (part) => Number(part) & 0xff)\r\n        : (value instanceof Uint8Array\r\n            ? value\r\n            : new Uint8Array(value.buffer, value.byteOffset, value.byteLength));\r\n    if (bytes.length !== 4)\r\n    {\r\n        throw new CjsFormatWriteError(\"Compiler version must be exactly 4 bytes\", {\r\n            byteLength: bytes.length\r\n        });\r\n    }\r\n    return bytes;\r\n}\r\n\r\n/**\r\n * Assembles a Carbon compiled-effect container from fully resolved parts.\r\n *\r\n * This is the low-level primitive: every arena reference in `permutationRows`\r\n * is already a byte offset and every body is already serialised, so the\r\n * function reproduces exactly Carbon's header order, alias dedupe and\r\n * body-offset arithmetic and nothing else. Re-emitting a file through this\r\n * function with its own arena and body bytes must reproduce it byte for byte.\r\n *\r\n * Body-offset base is `4 + 4 + 32 + headerSize + stringTable.GetSize()`\r\n * (`ShaderCompiler.cpp:801`), where `headerSize` is the byte size of the\r\n * permutation block plus the offset table (`:765`) and `GetSize()` includes the\r\n * arena's own `u32` length prefix (`StringTable.cpp:82-85`).\r\n *\r\n * @param {object} parts Resolved container parts.\r\n * @param {number} [parts.version] Container data version to emit; must be one of\r\n *     `CARBON_EFFECT_WRITE_VERSIONS`. Defaults to the current version.\r\n * @param {number[]|Uint8Array} parts.compilerVersion Four version bytes.\r\n * @param {string|Uint8Array} parts.sourceHash 32 ASCII hash bytes.\r\n * @param {Uint8Array} parts.stringTableBytes Arena payload, without its prefix.\r\n * @param {object[]} parts.permutationRows Permutation axes with resolved offsets.\r\n * @param {Array<{index:number, bytes:Uint8Array}>} parts.bodies Serialised bodies.\r\n * @returns {Uint8Array} Container bytes.\r\n */\r\nexport function writeCarbonEffectFile(parts)\r\n{\r\n    const version = resolveWriteVersion(parts.version);\r\n    const compilerVersion = normalizeCompilerVersion(parts.compilerVersion ?? [ 0, 0, 0, 0 ]);\r\n    const sourceHash = normalizeSourceHash(parts.sourceHash ?? \"0\".repeat(CARBON_EFFECT_SOURCE_HASH_BYTES));\r\n    const stringTableBytes = parts.stringTableBytes ?? new Uint8Array(0);\r\n    const permutationRows = parts.permutationRows ?? [];\r\n    const bodies = parts.bodies ?? [];\r\n\r\n    if (bodies.length === 0)\r\n    {\r\n        throw new CjsFormatWriteError(\"A Carbon effect container needs at least one body\");\r\n    }\r\n    if (permutationRows.length > 0xff)\r\n    {\r\n        throw new CjsFormatWriteError(\"Permutation axis count does not fit in a u8\", {\r\n            count: permutationRows.length\r\n        });\r\n    }\r\n\r\n    const ordered = bodies.slice().sort((a, b) => a.index - b.index);\r\n    for (let position = 0; position < ordered.length; position += 1)\r\n    {\r\n        if (ordered[position].index !== position)\r\n        {\r\n            throw new CjsFormatWriteError(\r\n                \"Carbon effect bodies must be dense and start at index 0; the reader indexes the offset table positionally\",\r\n                { position, index: ordered[position].index }\r\n            );\r\n        }\r\n    }\r\n\r\n    let permutationBytes = 1;\r\n    for (const row of permutationRows)\r\n    {\r\n        if (row.options.length > 0xff)\r\n        {\r\n            throw new CjsFormatWriteError(\"Permutation option count does not fit in a u8\", {\r\n                name: row.name,\r\n                count: row.options.length\r\n            });\r\n        }\r\n        permutationBytes += PERMUTATION_FIXED_BYTES + row.options.length * 4;\r\n    }\r\n\r\n    const headerSize = (ordered.length * 3 + 1) * 4 + permutationBytes;\r\n    const base = 4 + 4 + CARBON_EFFECT_SOURCE_HASH_BYTES + headerSize + (stringTableBytes.length + 4);\r\n\r\n    // Carbon compares packed bodies pairwise and points a duplicate's row at the\r\n    // surviving twin, so the offset table stays dense while the file stores each\r\n    // distinct body once (`ShaderCompiler.cpp:717-744`, `:804-820`). Keying the\r\n    // first occurrence by content reaches the same rows in one pass.\r\n    const byContent = new Map();\r\n    const records = [];\r\n    const uniqueBodies = [];\r\n    let cursor = base;\r\n    for (const body of ordered)\r\n    {\r\n        const key = hashBytes(body.bytes);\r\n        const candidates = byContent.get(key);\r\n        const existing = candidates?.find((candidate) => bytesEqual(candidate.bytes, body.bytes));\r\n        if (existing)\r\n        {\r\n            records.push({ index: body.index, offset: existing.offset, size: existing.size });\r\n            continue;\r\n        }\r\n        const record = { index: body.index, offset: cursor, size: body.bytes.length };\r\n        if (candidates) candidates.push({ bytes: body.bytes, ...record });\r\n        else byContent.set(key, [ { bytes: body.bytes, ...record } ]);\r\n        records.push(record);\r\n        uniqueBodies.push(body.bytes);\r\n        cursor += body.bytes.length;\r\n    }\r\n\r\n    const writer = new CjsByteWriter(cursor);\r\n    writer.u32(version);\r\n    writer.bytes(compilerVersion);\r\n    writer.bytes(sourceHash);\r\n\r\n    writer.u32(stringTableBytes.length);\r\n    if (stringTableBytes.length > 0) writer.bytes(stringTableBytes);\r\n\r\n    writer.u8(permutationRows.length);\r\n    for (const row of permutationRows)\r\n    {\r\n        writer.u32(row.nameOffset);\r\n        writer.u8(row.defaultOption);\r\n        writer.u32(row.descriptionOffset);\r\n        writer.u8(row.type);\r\n        writer.u8(row.options.length);\r\n        for (const optionOffset of row.options)\r\n        {\r\n            writer.u32(optionOffset);\r\n        }\r\n    }\r\n\r\n    writer.u32(records.length);\r\n    for (const record of records)\r\n    {\r\n        writer.u32(record.index);\r\n        writer.u32(record.offset);\r\n        writer.u32(record.size);\r\n    }\r\n\r\n    if (writer.length !== base)\r\n    {\r\n        throw new CjsFormatWriteError(\"Carbon effect header size arithmetic disagrees with the bytes written\", {\r\n            written: writer.length,\r\n            expected: base,\r\n            headerSize,\r\n            permutationBytes\r\n        });\r\n    }\r\n\r\n    for (const bytes of uniqueBodies)\r\n    {\r\n        writer.bytes(bytes);\r\n    }\r\n\r\n    return writer.toBytes();\r\n}\r\n\r\n/**\r\n * Builder for a Carbon compiled-effect container.\r\n *\r\n * Interning and emission are two passes over the same records, in that order,\r\n * because an arena offset is only stable once every entry is present: adding\r\n * after an offset has been handed out would shift every offset already written.\r\n * `collectArena` runs the first pass and `internArena` the second, and because\r\n * both drive the same `writeEffectDescription` walk they cannot fall out of\r\n * step with each other.\r\n */\r\nexport class CjsCarbonEffectWriter\r\n{\r\n    #table;\r\n    #permutations = [];\r\n    #bodies = [];\r\n    #compilerVersion;\r\n    #sourceHash;\r\n    #backend;\r\n    #version;\r\n\r\n    /**\r\n     * Creates an empty container builder.\r\n     *\r\n     * @param {object} [options] Builder options.\r\n     * @param {number} [options.version] Container data version to emit; must be\r\n     *     one of `CARBON_EFFECT_WRITE_VERSIONS`. Defaults to the current\r\n     *     version. Rejected at construction, not at `finish()`, so a caller\r\n     *     learns it asked for something unwritable before doing the work.\r\n     * @param {number[]|Uint8Array} [options.compilerVersion] Four version bytes.\r\n     * @param {string|Uint8Array} [options.sourceHash] 32 ASCII hash bytes.\r\n     * @param {CjsStringTable} [options.stringTable] Arena to intern into.\r\n     * @param {boolean} [options.backend] Emit the optional trailing block per pass.\r\n     */\r\n    constructor(options = {})\r\n    {\r\n        this.#version = resolveWriteVersion(options.version);\r\n        this.#table = options.stringTable ?? new CjsStringTable();\r\n        this.#compilerVersion = options.compilerVersion ?? [ 0, 0, 0, 0 ];\r\n        this.#sourceHash = options.sourceHash ?? \"0\".repeat(CARBON_EFFECT_SOURCE_HASH_BYTES);\r\n        this.#backend = options.backend === true;\r\n    }\r\n\r\n    /**\r\n     * Returns the arena this builder interns into.\r\n     *\r\n     * @returns {CjsStringTable} String table.\r\n     */\r\n    get stringTable()\r\n    {\r\n        return this.#table;\r\n    }\r\n\r\n    /**\r\n     * Adds a permutation axis.\r\n     *\r\n     * @param {object} axis Axis description.\r\n     * @param {string} axis.name Axis name.\r\n     * @param {number} [axis.defaultOption] Index of the default option.\r\n     * @param {string} [axis.description] Axis description text.\r\n     * @param {number} [axis.type] Axis type byte.\r\n     * @param {string[]} axis.options Option names.\r\n     * @returns {CjsCarbonEffectWriter} This builder.\r\n     */\r\n    addPermutation(axis)\r\n    {\r\n        this.#permutations.push({\r\n            name: String(axis.name ?? \"\"),\r\n            defaultOption: axis.defaultOption ?? 0,\r\n            description: String(axis.description ?? \"\"),\r\n            type: axis.type ?? 0,\r\n            options: (axis.options ?? []).map((option) => String(option))\r\n        });\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     * Adds one permutation's description record tree.\r\n     *\r\n     * @param {number} index Permutation index.\r\n     * @param {object} description Description record tree.\r\n     * @returns {CjsCarbonEffectWriter} This builder.\r\n     */\r\n    addBody(index, description)\r\n    {\r\n        this.#bodies.push({ index, description, bytes: null });\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     * Adds one permutation's already-serialised description bytes.\r\n     *\r\n     * Used when re-emitting a file whose arena is being reused verbatim: the\r\n     * bytes already carry resolved offsets into that arena, so they must not be\r\n     * re-interned.\r\n     *\r\n     * @param {number} index Permutation index.\r\n     * @param {Uint8Array} bytes Serialised description blob.\r\n     * @returns {CjsCarbonEffectWriter} This builder.\r\n     */\r\n    addRawBody(index, bytes)\r\n    {\r\n        this.#bodies.push({ index, description: null, bytes: Uint8Array.from(bytes) });\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     * Interns, serialises and assembles the container.\r\n     *\r\n     * @returns {Uint8Array} Container bytes.\r\n     */\r\n    toBytes()\r\n    {\r\n        for (const axis of this.#permutations)\r\n        {\r\n            axis.nameRef = this.#table.addString(axis.name);\r\n            axis.descriptionRef = this.#table.addString(axis.description);\r\n            axis.optionRefs = axis.options.map((option) => this.#table.addString(option));\r\n        }\r\n        for (const body of this.#bodies)\r\n        {\r\n            if (body.description)\r\n            {\r\n                writeEffectDescription(new CjsByteWriter(), body.description, {\r\n                    arena: collectArena(this.#table),\r\n                    backend: this.#backend,\r\n                    version: this.#version\r\n                });\r\n            }\r\n        }\r\n\r\n        this.#table.finish();\r\n\r\n        const arena = internArena(this.#table);\r\n        const bodies = this.#bodies.map((body) =>\r\n        {\r\n            if (body.bytes) return { index: body.index, bytes: body.bytes };\r\n            const writer = new CjsByteWriter();\r\n            writeEffectDescription(writer, body.description, { arena, backend: this.#backend, version: this.#version });\r\n            return { index: body.index, bytes: writer.toBytes() };\r\n        });\r\n\r\n        const permutationRows = this.#permutations.map((axis) => ({\r\n            name: axis.name,\r\n            nameOffset: this.#table.offsetOf(axis.nameRef),\r\n            defaultOption: axis.defaultOption,\r\n            descriptionOffset: this.#table.offsetOf(axis.descriptionRef),\r\n            type: axis.type,\r\n            options: axis.optionRefs.map((reference) => this.#table.offsetOf(reference))\r\n        }));\r\n\r\n        return writeCarbonEffectFile({\r\n            version: this.#version,\r\n            compilerVersion: this.#compilerVersion,\r\n            sourceHash: this.#sourceHash,\r\n            stringTableBytes: this.#table.toBytes(),\r\n            permutationRows,\r\n            bodies\r\n        });\r\n    }\r\n}\r\n\r\nexport { CARBON_EFFECT_RECORD_BYTES, CARBON_EFFECT_SOURCE_HASH_BYTES };\r\nexport default CjsCarbonEffectWriter;\r\n"],"names":["textEncoder","TextEncoder","PERMUTATION_FIXED_BYTES","hashBytes","bytes","hash","index","length","Math","imul","bytesEqual","a","b","normalizeSourceHash","value","encode","Uint8Array","buffer","byteOffset","byteLength","CARBON_EFFECT_SOURCE_HASH_BYTES","CjsFormatWriteError","normalizeCompilerVersion","Array","isArray","from","part","Number","writeCarbonEffectFile","parts","version","resolveWriteVersion","compilerVersion","sourceHash","repeat","stringTableBytes","permutationRows","bodies","count","ordered","slice","sort","position","permutationBytes","row","options","name","headerSize","base","byContent","Map","records","uniqueBodies","cursor","body","key","candidates","get","existing","find","candidate","push","offset","size","record","set","writer","CjsByteWriter","u32","u8","nameOffset","defaultOption","descriptionOffset","type","optionOffset","written","expected","toBytes","CjsCarbonEffectWriter","constructor","stringTable","CjsStringTable","backend","addPermutation","axis","String","description","map","option","addBody","addRawBody","nameRef","addString","descriptionRef","optionRefs","writeEffectDescription","arena","collectArena","finish","internArena","offsetOf","reference"],"mappings":";;;;;;;AAAA;;AAaA,MAAMA,WAAW,GAAG,IAAIC,WAAW,EAAE;;AAErC;AACA;AACA;AACA;AACA;AACA,MAAMC,uBAAuB,GAAG,EAAE;;AAElC;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,SAASA,CAACC,KAAK,EACxB;EACI,IAAIC,IAAI,GAAG,UAAU;AACrB,EAAA,KAAK,IAAIC,KAAK,GAAG,CAAC,EAAEA,KAAK,GAAGF,KAAK,CAACG,MAAM,EAAED,KAAK,IAAI,CAAC,EACpD;AACID,IAAAA,IAAI,IAAID,KAAK,CAACE,KAAK,CAAC;IACpBD,IAAI,GAAGG,IAAI,CAACC,IAAI,CAACJ,IAAI,EAAE,UAAU,CAAC;AACtC,EAAA;EACA,OAAOA,IAAI,KAAK,CAAC;AACrB;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASK,UAAUA,CAACC,CAAC,EAAEC,CAAC,EACxB;EACI,IAAID,CAAC,CAACJ,MAAM,KAAKK,CAAC,CAACL,MAAM,EAAE,OAAO,KAAK;AACvC,EAAA,KAAK,IAAID,KAAK,GAAG,CAAC,EAAEA,KAAK,GAAGK,CAAC,CAACJ,MAAM,EAAED,KAAK,IAAI,CAAC,EAChD;IACI,IAAIK,CAAC,CAACL,KAAK,CAAC,KAAKM,CAAC,CAACN,KAAK,CAAC,EAAE,OAAO,KAAK;AAC3C,EAAA;AACA,EAAA,OAAO,IAAI;AACf;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,SAASO,mBAAmBA,CAACC,KAAK,EAClC;AACI,EAAA,MAAMV,KAAK,GAAG,OAAOU,KAAK,KAAK,QAAQ,GACjCd,WAAW,CAACe,MAAM,CAACD,KAAK,CAAC,GACxBA,KAAK,YAAYE,UAAU,GACxBF,KAAK,GACL,IAAIE,UAAU,CAACF,KAAK,CAACG,MAAM,EAAEH,KAAK,CAACI,UAAU,EAAEJ,KAAK,CAACK,UAAU,CAAE;AAC3E,EAAA,IAAIf,KAAK,CAACG,MAAM,KAAKa,+BAA+B,EACpD;AACI,IAAA,MAAM,IAAIC,mBAAmB,CACzB,CAAA,4BAAA,EAA+BD,+BAA+B,QAAQ,EACtE;MAAED,UAAU,EAAEf,KAAK,CAACG;AAAO,KAC/B,CAAC;AACL,EAAA;AACA,EAAA,OAAOH,KAAK;AAChB;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASkB,wBAAwBA,CAACR,KAAK,EACvC;EACI,MAAMV,KAAK,GAAGmB,KAAK,CAACC,OAAO,CAACV,KAAK,CAAC,GAC5BE,UAAU,CAACS,IAAI,CAACX,KAAK,EAAGY,IAAI,IAAKC,MAAM,CAACD,IAAI,CAAC,GAAG,IAAI,CAAC,GACpDZ,KAAK,YAAYE,UAAU,GACxBF,KAAK,GACL,IAAIE,UAAU,CAACF,KAAK,CAACG,MAAM,EAAEH,KAAK,CAACI,UAAU,EAAEJ,KAAK,CAACK,UAAU,CAAE;AAC3E,EAAA,IAAIf,KAAK,CAACG,MAAM,KAAK,CAAC,EACtB;AACI,IAAA,MAAM,IAAIc,mBAAmB,CAAC,0CAA0C,EAAE;MACtEF,UAAU,EAAEf,KAAK,CAACG;AACtB,KAAC,CAAC;AACN,EAAA;AACA,EAAA,OAAOH,KAAK;AAChB;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASwB,qBAAqBA,CAACC,KAAK,EAC3C;AACI,EAAA,MAAMC,OAAO,GAAGC,mBAAmB,CAACF,KAAK,CAACC,OAAO,CAAC;AAClD,EAAA,MAAME,eAAe,GAAGV,wBAAwB,CAACO,KAAK,CAACG,eAAe,IAAI,CAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAE,CAAC;AACzF,EAAA,MAAMC,UAAU,GAAGpB,mBAAmB,CAACgB,KAAK,CAACI,UAAU,IAAI,GAAG,CAACC,MAAM,CAACd,+BAA+B,CAAC,CAAC;EACvG,MAAMe,gBAAgB,GAAGN,KAAK,CAACM,gBAAgB,IAAI,IAAInB,UAAU,CAAC,CAAC,CAAC;AACpE,EAAA,MAAMoB,eAAe,GAAGP,KAAK,CAACO,eAAe,IAAI,EAAE;AACnD,EAAA,MAAMC,MAAM,GAAGR,KAAK,CAACQ,MAAM,IAAI,EAAE;AAEjC,EAAA,IAAIA,MAAM,CAAC9B,MAAM,KAAK,CAAC,EACvB;AACI,IAAA,MAAM,IAAIc,mBAAmB,CAAC,mDAAmD,CAAC;AACtF,EAAA;AACA,EAAA,IAAIe,eAAe,CAAC7B,MAAM,GAAG,IAAI,EACjC;AACI,IAAA,MAAM,IAAIc,mBAAmB,CAAC,6CAA6C,EAAE;MACzEiB,KAAK,EAAEF,eAAe,CAAC7B;AAC3B,KAAC,CAAC;AACN,EAAA;EAEA,MAAMgC,OAAO,GAAGF,MAAM,CAACG,KAAK,EAAE,CAACC,IAAI,CAAC,CAAC9B,CAAC,EAAEC,CAAC,KAAKD,CAAC,CAACL,KAAK,GAAGM,CAAC,CAACN,KAAK,CAAC;AAChE,EAAA,KAAK,IAAIoC,QAAQ,GAAG,CAAC,EAAEA,QAAQ,GAAGH,OAAO,CAAChC,MAAM,EAAEmC,QAAQ,IAAI,CAAC,EAC/D;IACI,IAAIH,OAAO,CAACG,QAAQ,CAAC,CAACpC,KAAK,KAAKoC,QAAQ,EACxC;AACI,MAAA,MAAM,IAAIrB,mBAAmB,CACzB,2GAA2G,EAC3G;QAAEqB,QAAQ;AAAEpC,QAAAA,KAAK,EAAEiC,OAAO,CAACG,QAAQ,CAAC,CAACpC;AAAM,OAC/C,CAAC;AACL,IAAA;AACJ,EAAA;EAEA,IAAIqC,gBAAgB,GAAG,CAAC;AACxB,EAAA,KAAK,MAAMC,GAAG,IAAIR,eAAe,EACjC;AACI,IAAA,IAAIQ,GAAG,CAACC,OAAO,CAACtC,MAAM,GAAG,IAAI,EAC7B;AACI,MAAA,MAAM,IAAIc,mBAAmB,CAAC,+CAA+C,EAAE;QAC3EyB,IAAI,EAAEF,GAAG,CAACE,IAAI;AACdR,QAAAA,KAAK,EAAEM,GAAG,CAACC,OAAO,CAACtC;AACvB,OAAC,CAAC;AACN,IAAA;IACAoC,gBAAgB,IAAIzC,uBAAuB,GAAG0C,GAAG,CAACC,OAAO,CAACtC,MAAM,GAAG,CAAC;AACxE,EAAA;AAEA,EAAA,MAAMwC,UAAU,GAAG,CAACR,OAAO,CAAChC,MAAM,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,GAAGoC,gBAAgB;AAClE,EAAA,MAAMK,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG5B,+BAA+B,GAAG2B,UAAU,IAAIZ,gBAAgB,CAAC5B,MAAM,GAAG,CAAC,CAAC;;AAEjG;AACA;AACA;AACA;AACA,EAAA,MAAM0C,SAAS,GAAG,IAAIC,GAAG,EAAE;EAC3B,MAAMC,OAAO,GAAG,EAAE;EAClB,MAAMC,YAAY,GAAG,EAAE;EACvB,IAAIC,MAAM,GAAGL,IAAI;AACjB,EAAA,KAAK,MAAMM,IAAI,IAAIf,OAAO,EAC1B;AACI,IAAA,MAAMgB,GAAG,GAAGpD,SAAS,CAACmD,IAAI,CAAClD,KAAK,CAAC;AACjC,IAAA,MAAMoD,UAAU,GAAGP,SAAS,CAACQ,GAAG,CAACF,GAAG,CAAC;AACrC,IAAA,MAAMG,QAAQ,GAAGF,UAAU,EAAEG,IAAI,CAAEC,SAAS,IAAKlD,UAAU,CAACkD,SAAS,CAACxD,KAAK,EAAEkD,IAAI,CAAClD,KAAK,CAAC,CAAC;AACzF,IAAA,IAAIsD,QAAQ,EACZ;MACIP,OAAO,CAACU,IAAI,CAAC;QAAEvD,KAAK,EAAEgD,IAAI,CAAChD,KAAK;QAAEwD,MAAM,EAAEJ,QAAQ,CAACI,MAAM;QAAEC,IAAI,EAAEL,QAAQ,CAACK;AAAK,OAAC,CAAC;AACjF,MAAA;AACJ,IAAA;AACA,IAAA,MAAMC,MAAM,GAAG;MAAE1D,KAAK,EAAEgD,IAAI,CAAChD,KAAK;AAAEwD,MAAAA,MAAM,EAAET,MAAM;AAAEU,MAAAA,IAAI,EAAET,IAAI,CAAClD,KAAK,CAACG;KAAQ;AAC7E,IAAA,IAAIiD,UAAU,EAAEA,UAAU,CAACK,IAAI,CAAC;MAAEzD,KAAK,EAAEkD,IAAI,CAAClD,KAAK;MAAE,GAAG4D;KAAQ,CAAC,CAAC,KAC7Df,SAAS,CAACgB,GAAG,CAACV,GAAG,EAAE,CAAE;MAAEnD,KAAK,EAAEkD,IAAI,CAAClD,KAAK;MAAE,GAAG4D;AAAO,KAAC,CAAE,CAAC;AAC7Db,IAAAA,OAAO,CAACU,IAAI,CAACG,MAAM,CAAC;AACpBZ,IAAAA,YAAY,CAACS,IAAI,CAACP,IAAI,CAAClD,KAAK,CAAC;AAC7BiD,IAAAA,MAAM,IAAIC,IAAI,CAAClD,KAAK,CAACG,MAAM;AAC/B,EAAA;AAEA,EAAA,MAAM2D,MAAM,GAAG,IAAIC,aAAa,CAACd,MAAM,CAAC;AACxCa,EAAAA,MAAM,CAACE,GAAG,CAACtC,OAAO,CAAC;AACnBoC,EAAAA,MAAM,CAAC9D,KAAK,CAAC4B,eAAe,CAAC;AAC7BkC,EAAAA,MAAM,CAAC9D,KAAK,CAAC6B,UAAU,CAAC;AAExBiC,EAAAA,MAAM,CAACE,GAAG,CAACjC,gBAAgB,CAAC5B,MAAM,CAAC;EACnC,IAAI4B,gBAAgB,CAAC5B,MAAM,GAAG,CAAC,EAAE2D,MAAM,CAAC9D,KAAK,CAAC+B,gBAAgB,CAAC;AAE/D+B,EAAAA,MAAM,CAACG,EAAE,CAACjC,eAAe,CAAC7B,MAAM,CAAC;AACjC,EAAA,KAAK,MAAMqC,GAAG,IAAIR,eAAe,EACjC;AACI8B,IAAAA,MAAM,CAACE,GAAG,CAACxB,GAAG,CAAC0B,UAAU,CAAC;AAC1BJ,IAAAA,MAAM,CAACG,EAAE,CAACzB,GAAG,CAAC2B,aAAa,CAAC;AAC5BL,IAAAA,MAAM,CAACE,GAAG,CAACxB,GAAG,CAAC4B,iBAAiB,CAAC;AACjCN,IAAAA,MAAM,CAACG,EAAE,CAACzB,GAAG,CAAC6B,IAAI,CAAC;IACnBP,MAAM,CAACG,EAAE,CAACzB,GAAG,CAACC,OAAO,CAACtC,MAAM,CAAC;AAC7B,IAAA,KAAK,MAAMmE,YAAY,IAAI9B,GAAG,CAACC,OAAO,EACtC;AACIqB,MAAAA,MAAM,CAACE,GAAG,CAACM,YAAY,CAAC;AAC5B,IAAA;AACJ,EAAA;AAEAR,EAAAA,MAAM,CAACE,GAAG,CAACjB,OAAO,CAAC5C,MAAM,CAAC;AAC1B,EAAA,KAAK,MAAMyD,MAAM,IAAIb,OAAO,EAC5B;AACIe,IAAAA,MAAM,CAACE,GAAG,CAACJ,MAAM,CAAC1D,KAAK,CAAC;AACxB4D,IAAAA,MAAM,CAACE,GAAG,CAACJ,MAAM,CAACF,MAAM,CAAC;AACzBI,IAAAA,MAAM,CAACE,GAAG,CAACJ,MAAM,CAACD,IAAI,CAAC;AAC3B,EAAA;AAEA,EAAA,IAAIG,MAAM,CAAC3D,MAAM,KAAKyC,IAAI,EAC1B;AACI,IAAA,MAAM,IAAI3B,mBAAmB,CAAC,uEAAuE,EAAE;MACnGsD,OAAO,EAAET,MAAM,CAAC3D,MAAM;AACtBqE,MAAAA,QAAQ,EAAE5B,IAAI;MACdD,UAAU;AACVJ,MAAAA;AACJ,KAAC,CAAC;AACN,EAAA;AAEA,EAAA,KAAK,MAAMvC,KAAK,IAAIgD,YAAY,EAChC;AACIc,IAAAA,MAAM,CAAC9D,KAAK,CAACA,KAAK,CAAC;AACvB,EAAA;AAEA,EAAA,OAAO8D,MAAM,CAACW,OAAO,EAAE;AAC3B;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMC,qBAAqB,CAClC;AACI,EAAA,MAAM;EACN,aAAa,GAAG,EAAE;EAClB,OAAO,GAAG,EAAE;AACZ,EAAA,gBAAgB;AAChB,EAAA,WAAW;AACX,EAAA,QAAQ;AACR,EAAA,QAAQ;;AAER;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACIC,EAAAA,WAAWA,CAAClC,OAAO,GAAG,EAAE,EACxB;IACI,IAAI,CAAC,QAAQ,GAAGd,mBAAmB,CAACc,OAAO,CAACf,OAAO,CAAC;IACpD,IAAI,CAAC,MAAM,GAAGe,OAAO,CAACmC,WAAW,IAAI,IAAIC,cAAc,EAAE;AACzD,IAAA,IAAI,CAAC,gBAAgB,GAAGpC,OAAO,CAACb,eAAe,IAAI,CAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAE;AACjE,IAAA,IAAI,CAAC,WAAW,GAAGa,OAAO,CAACZ,UAAU,IAAI,GAAG,CAACC,MAAM,CAACd,+BAA+B,CAAC;IACpF,IAAI,CAAC,QAAQ,GAAGyB,OAAO,CAACqC,OAAO,KAAK,IAAI;AAC5C,EAAA;;AAEA;AACJ;AACA;AACA;AACA;EACI,IAAIF,WAAWA,GACf;IACI,OAAO,IAAI,CAAC,MAAM;AACtB,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACIG,cAAcA,CAACC,IAAI,EACnB;AACI,IAAA,IAAI,CAAC,aAAa,CAACvB,IAAI,CAAC;MACpBf,IAAI,EAAEuC,MAAM,CAACD,IAAI,CAACtC,IAAI,IAAI,EAAE,CAAC;AAC7ByB,MAAAA,aAAa,EAAEa,IAAI,CAACb,aAAa,IAAI,CAAC;MACtCe,WAAW,EAAED,MAAM,CAACD,IAAI,CAACE,WAAW,IAAI,EAAE,CAAC;AAC3Cb,MAAAA,IAAI,EAAEW,IAAI,CAACX,IAAI,IAAI,CAAC;AACpB5B,MAAAA,OAAO,EAAE,CAACuC,IAAI,CAACvC,OAAO,IAAI,EAAE,EAAE0C,GAAG,CAAEC,MAAM,IAAKH,MAAM,CAACG,MAAM,CAAC;AAChE,KAAC,CAAC;AACF,IAAA,OAAO,IAAI;AACf,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACIC,EAAAA,OAAOA,CAACnF,KAAK,EAAEgF,WAAW,EAC1B;AACI,IAAA,IAAI,CAAC,OAAO,CAACzB,IAAI,CAAC;MAAEvD,KAAK;MAAEgF,WAAW;AAAElF,MAAAA,KAAK,EAAE;AAAK,KAAC,CAAC;AACtD,IAAA,OAAO,IAAI;AACf,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACIsF,EAAAA,UAAUA,CAACpF,KAAK,EAAEF,KAAK,EACvB;AACI,IAAA,IAAI,CAAC,OAAO,CAACyD,IAAI,CAAC;MAAEvD,KAAK;AAAEgF,MAAAA,WAAW,EAAE,IAAI;AAAElF,MAAAA,KAAK,EAAEY,UAAU,CAACS,IAAI,CAACrB,KAAK;AAAE,KAAC,CAAC;AAC9E,IAAA,OAAO,IAAI;AACf,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACIyE,EAAAA,OAAOA,GACP;AACI,IAAA,KAAK,MAAMO,IAAI,IAAI,IAAI,CAAC,aAAa,EACrC;AACIA,MAAAA,IAAI,CAACO,OAAO,GAAG,IAAI,CAAC,MAAM,CAACC,SAAS,CAACR,IAAI,CAACtC,IAAI,CAAC;AAC/CsC,MAAAA,IAAI,CAACS,cAAc,GAAG,IAAI,CAAC,MAAM,CAACD,SAAS,CAACR,IAAI,CAACE,WAAW,CAAC;MAC7DF,IAAI,CAACU,UAAU,GAAGV,IAAI,CAACvC,OAAO,CAAC0C,GAAG,CAAEC,MAAM,IAAK,IAAI,CAAC,MAAM,CAACI,SAAS,CAACJ,MAAM,CAAC,CAAC;AACjF,IAAA;AACA,IAAA,KAAK,MAAMlC,IAAI,IAAI,IAAI,CAAC,OAAO,EAC/B;MACI,IAAIA,IAAI,CAACgC,WAAW,EACpB;QACIS,sBAAsB,CAAC,IAAI5B,aAAa,EAAE,EAAEb,IAAI,CAACgC,WAAW,EAAE;AAC1DU,UAAAA,KAAK,EAAEC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC;AAChCf,UAAAA,OAAO,EAAE,IAAI,CAAC,QAAQ;UACtBpD,OAAO,EAAE,IAAI,CAAC;AAClB,SAAC,CAAC;AACN,MAAA;AACJ,IAAA;AAEA,IAAA,IAAI,CAAC,MAAM,CAACoE,MAAM,EAAE;IAEpB,MAAMF,KAAK,GAAGG,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC;IACtC,MAAM9D,MAAM,GAAG,IAAI,CAAC,OAAO,CAACkD,GAAG,CAAEjC,IAAI,IACrC;AACI,MAAA,IAAIA,IAAI,CAAClD,KAAK,EAAE,OAAO;QAAEE,KAAK,EAAEgD,IAAI,CAAChD,KAAK;QAAEF,KAAK,EAAEkD,IAAI,CAAClD;OAAO;AAC/D,MAAA,MAAM8D,MAAM,GAAG,IAAIC,aAAa,EAAE;AAClC4B,MAAAA,sBAAsB,CAAC7B,MAAM,EAAEZ,IAAI,CAACgC,WAAW,EAAE;QAAEU,KAAK;AAAEd,QAAAA,OAAO,EAAE,IAAI,CAAC,QAAQ;QAAEpD,OAAO,EAAE,IAAI,CAAC;AAAS,OAAC,CAAC;MAC3G,OAAO;QAAExB,KAAK,EAAEgD,IAAI,CAAChD,KAAK;AAAEF,QAAAA,KAAK,EAAE8D,MAAM,CAACW,OAAO;OAAI;AACzD,IAAA,CAAC,CAAC;IAEF,MAAMzC,eAAe,GAAG,IAAI,CAAC,aAAa,CAACmD,GAAG,CAAEH,IAAI,KAAM;MACtDtC,IAAI,EAAEsC,IAAI,CAACtC,IAAI;MACfwB,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC8B,QAAQ,CAAChB,IAAI,CAACO,OAAO,CAAC;MAC9CpB,aAAa,EAAEa,IAAI,CAACb,aAAa;MACjCC,iBAAiB,EAAE,IAAI,CAAC,MAAM,CAAC4B,QAAQ,CAAChB,IAAI,CAACS,cAAc,CAAC;MAC5DpB,IAAI,EAAEW,IAAI,CAACX,IAAI;AACf5B,MAAAA,OAAO,EAAEuC,IAAI,CAACU,UAAU,CAACP,GAAG,CAAEc,SAAS,IAAK,IAAI,CAAC,MAAM,CAACD,QAAQ,CAACC,SAAS,CAAC;AAC/E,KAAC,CAAC,CAAC;AAEH,IAAA,OAAOzE,qBAAqB,CAAC;AACzBE,MAAAA,OAAO,EAAE,IAAI,CAAC,QAAQ;AACtBE,MAAAA,eAAe,EAAE,IAAI,CAAC,gBAAgB;AACtCC,MAAAA,UAAU,EAAE,IAAI,CAAC,WAAW;MAC5BE,gBAAgB,EAAE,IAAI,CAAC,MAAM,CAAC0C,OAAO,EAAE;MACvCzC,eAAe;AACfC,MAAAA;AACJ,KAAC,CAAC;AACN,EAAA;AACJ;;;;"}
+{"version":3,"file":"CjsCarbonEffectWriter.js","sources":["../../../../../src/resource/format/carbonEffect/CjsCarbonEffectWriter.js"],"sourcesContent":["// Source: trinity/shadercompiler/ShaderCompiler.cpp:717-845 (alias dedupe, file assembly)\r\n\r\nimport { CjsByteWriter } from \"../CjsByteWriter.js\";\r\nimport { CjsStringTable } from \"../CjsStringTable.js\";\r\nimport { CjsFormatWriteError } from \"../CjsFormatError.js\";\r\nimport {\r\n    collectArena,\r\n    internArena,\r\n    resolveWriteVersion,\r\n    writeEffectDescription\r\n} from \"./carbonEffectRecords.js\";\r\nimport { CARBON_EFFECT_RECORD_BYTES, CARBON_EFFECT_SOURCE_HASH_BYTES } from \"./CjsCarbonEffectReader.js\";\r\n\r\nconst textEncoder = new TextEncoder();\r\n\r\n/**\r\n * Byte count of one permutation record's fixed part: `u32 name`,\r\n * `u8 defaultOption`, `u32 description`, `u8 type`, `u8 optionCount`\r\n * (`ShaderCompiler.cpp:757-761`).\r\n */\r\nconst PERMUTATION_FIXED_BYTES = 11;\r\n\r\n/**\r\n * FNV-1a over every byte, used to bucket body-dedupe candidates.\r\n *\r\n * @param {Uint8Array} bytes Byte run to hash.\r\n * @returns {number} 32-bit hash.\r\n */\r\nfunction hashBytes(bytes)\r\n{\r\n    let hash = 0x811c9dc5;\r\n    for (let index = 0; index < bytes.length; index += 1)\r\n    {\r\n        hash ^= bytes[index];\r\n        hash = Math.imul(hash, 0x01000193);\r\n    }\r\n    return hash >>> 0;\r\n}\r\n\r\n/**\r\n * Reports whether two byte runs are identical.\r\n *\r\n * @param {Uint8Array} a First byte run.\r\n * @param {Uint8Array} b Second byte run.\r\n * @returns {boolean} True when the runs match exactly.\r\n */\r\nfunction bytesEqual(a, b)\r\n{\r\n    if (a.length !== b.length) return false;\r\n    for (let index = 0; index < a.length; index += 1)\r\n    {\r\n        if (a[index] !== b[index]) return false;\r\n    }\r\n    return true;\r\n}\r\n\r\n/**\r\n * Normalises a source hash to the 32 ASCII bytes the header slot holds.\r\n *\r\n * @param {string|ArrayBufferView|Uint8Array} value 32 hex characters or 32 bytes.\r\n * @returns {Uint8Array} Exactly 32 bytes.\r\n */\r\nfunction normalizeSourceHash(value)\r\n{\r\n    const bytes = typeof value === \"string\"\r\n        ? textEncoder.encode(value)\r\n        : (value instanceof Uint8Array\r\n            ? value\r\n            : new Uint8Array(value.buffer, value.byteOffset, value.byteLength));\r\n    if (bytes.length !== CARBON_EFFECT_SOURCE_HASH_BYTES)\r\n    {\r\n        throw new CjsFormatWriteError(\r\n            `Source hash must be exactly ${CARBON_EFFECT_SOURCE_HASH_BYTES} bytes`,\r\n            { byteLength: bytes.length }\r\n        );\r\n    }\r\n    return bytes;\r\n}\r\n\r\n/**\r\n * Normalises a compiler version to the four bytes the header slot holds.\r\n *\r\n * The slot is `uint8_t[4]` — `{major, minor, patch, tweak}` from\r\n * `ShaderCompilerConfig.h.in:5`, of which Carbon's rebuild check compares only\r\n * the first three (`ModifiedTime.cpp:77`). Carbon's own runtime skips the field\r\n * entirely (`Tr2EffectRes.cpp:246-249`).\r\n *\r\n * @param {number[]|ArrayBufferView|Uint8Array} value Four version components.\r\n * @returns {Uint8Array} Exactly 4 bytes.\r\n */\r\nfunction normalizeCompilerVersion(value)\r\n{\r\n    const bytes = Array.isArray(value)\r\n        ? Uint8Array.from(value, (part) => Number(part) & 0xff)\r\n        : (value instanceof Uint8Array\r\n            ? value\r\n            : new Uint8Array(value.buffer, value.byteOffset, value.byteLength));\r\n    if (bytes.length !== 4)\r\n    {\r\n        throw new CjsFormatWriteError(\"Compiler version must be exactly 4 bytes\", {\r\n            byteLength: bytes.length\r\n        });\r\n    }\r\n    return bytes;\r\n}\r\n\r\n/**\r\n * Assembles a Carbon compiled-effect container from fully resolved parts.\r\n *\r\n * This is the low-level primitive: every arena reference in `permutationRows`\r\n * is already a byte offset and every body is already serialised, so the\r\n * function reproduces exactly Carbon's header order, alias dedupe and\r\n * body-offset arithmetic and nothing else. Re-emitting a file through this\r\n * function with its own arena and body bytes must reproduce it byte for byte.\r\n *\r\n * Body-offset base is `4 + 4 + 32 + headerSize + stringTable.GetSize()`\r\n * (`ShaderCompiler.cpp:801`), where `headerSize` is the byte size of the\r\n * permutation block plus the offset table (`:765`) and `GetSize()` includes the\r\n * arena's own `u32` length prefix (`StringTable.cpp:82-85`).\r\n *\r\n * @param {object} parts Resolved container parts.\r\n * @param {number} [parts.version] Container data version to emit; must be one of\r\n *     `CARBON_EFFECT_WRITE_VERSIONS`. Defaults to the current version.\r\n * @param {number[]|Uint8Array} parts.compilerVersion Four version bytes.\r\n * @param {string|Uint8Array} parts.sourceHash 32 ASCII hash bytes.\r\n * @param {Uint8Array} parts.stringTableBytes Arena payload, without its prefix.\r\n * @param {object[]} parts.permutationRows Permutation axes with resolved offsets.\r\n * @param {Array<{index:number, bytes:Uint8Array}>} parts.bodies Serialised bodies.\r\n * @returns {Uint8Array} Container bytes.\r\n */\r\nexport function writeCarbonEffectFile(parts)\r\n{\r\n    const version = resolveWriteVersion(parts.version);\r\n    const compilerVersion = normalizeCompilerVersion(parts.compilerVersion ?? [ 0, 0, 0, 0 ]);\r\n    const sourceHash = normalizeSourceHash(parts.sourceHash ?? \"0\".repeat(CARBON_EFFECT_SOURCE_HASH_BYTES));\r\n    const stringTableBytes = parts.stringTableBytes ?? new Uint8Array(0);\r\n    const permutationRows = parts.permutationRows ?? [];\r\n    const bodies = parts.bodies ?? [];\r\n\r\n    if (bodies.length === 0)\r\n    {\r\n        throw new CjsFormatWriteError(\"A Carbon effect container needs at least one body\");\r\n    }\r\n    if (permutationRows.length > 0xff)\r\n    {\r\n        throw new CjsFormatWriteError(\"Permutation axis count does not fit in a u8\", {\r\n            count: permutationRows.length\r\n        });\r\n    }\r\n\r\n    const ordered = bodies.slice().sort((a, b) => a.index - b.index);\r\n    for (let position = 0; position < ordered.length; position += 1)\r\n    {\r\n        if (ordered[position].index !== position)\r\n        {\r\n            throw new CjsFormatWriteError(\r\n                \"Carbon effect bodies must be dense and start at index 0; the reader indexes the offset table positionally\",\r\n                { position, index: ordered[position].index }\r\n            );\r\n        }\r\n    }\r\n\r\n    let permutationBytes = 1;\r\n    for (const row of permutationRows)\r\n    {\r\n        if (row.options.length > 0xff)\r\n        {\r\n            throw new CjsFormatWriteError(\"Permutation option count does not fit in a u8\", {\r\n                name: row.name,\r\n                count: row.options.length\r\n            });\r\n        }\r\n        permutationBytes += PERMUTATION_FIXED_BYTES + row.options.length * 4;\r\n    }\r\n\r\n    const headerSize = (ordered.length * 3 + 1) * 4 + permutationBytes;\r\n    const base = 4 + 4 + CARBON_EFFECT_SOURCE_HASH_BYTES + headerSize + (stringTableBytes.length + 4);\r\n\r\n    // Carbon compares packed bodies pairwise and points a duplicate's row at the\r\n    // surviving twin, so the offset table stays dense while the file stores each\r\n    // distinct body once (`ShaderCompiler.cpp:717-744`, `:804-820`). Keying the\r\n    // first occurrence by content reaches the same rows in one pass.\r\n    const byContent = new Map();\r\n    const records = [];\r\n    const uniqueBodies = [];\r\n    let cursor = base;\r\n    for (const body of ordered)\r\n    {\r\n        const key = hashBytes(body.bytes);\r\n        const candidates = byContent.get(key);\r\n        const existing = candidates?.find((candidate) => bytesEqual(candidate.bytes, body.bytes));\r\n        if (existing)\r\n        {\r\n            records.push({ index: body.index, offset: existing.offset, size: existing.size });\r\n            continue;\r\n        }\r\n        const record = { index: body.index, offset: cursor, size: body.bytes.length };\r\n        if (candidates) candidates.push({ bytes: body.bytes, ...record });\r\n        else byContent.set(key, [ { bytes: body.bytes, ...record } ]);\r\n        records.push(record);\r\n        uniqueBodies.push(body.bytes);\r\n        cursor += body.bytes.length;\r\n    }\r\n\r\n    const writer = new CjsByteWriter(cursor);\r\n    writer.u32(version);\r\n    writer.bytes(compilerVersion);\r\n    writer.bytes(sourceHash);\r\n\r\n    writer.u32(stringTableBytes.length);\r\n    if (stringTableBytes.length > 0) writer.bytes(stringTableBytes);\r\n\r\n    writer.u8(permutationRows.length);\r\n    for (const row of permutationRows)\r\n    {\r\n        writer.u32(row.nameOffset);\r\n        writer.u8(row.defaultOption);\r\n        writer.u32(row.descriptionOffset);\r\n        writer.u8(row.type);\r\n        writer.u8(row.options.length);\r\n        for (const optionOffset of row.options)\r\n        {\r\n            writer.u32(optionOffset);\r\n        }\r\n    }\r\n\r\n    writer.u32(records.length);\r\n    for (const record of records)\r\n    {\r\n        writer.u32(record.index);\r\n        writer.u32(record.offset);\r\n        writer.u32(record.size);\r\n    }\r\n\r\n    if (writer.length !== base)\r\n    {\r\n        throw new CjsFormatWriteError(\"Carbon effect header size arithmetic disagrees with the bytes written\", {\r\n            written: writer.length,\r\n            expected: base,\r\n            headerSize,\r\n            permutationBytes\r\n        });\r\n    }\r\n\r\n    for (const bytes of uniqueBodies)\r\n    {\r\n        writer.bytes(bytes);\r\n    }\r\n\r\n    return writer.toBytes();\r\n}\r\n\r\n/**\r\n * Builder for a Carbon compiled-effect container.\r\n *\r\n * Interning and emission are two passes over the same records, in that order,\r\n * because an arena offset is only stable once every entry is present: adding\r\n * after an offset has been handed out would shift every offset already written.\r\n * `collectArena` runs the first pass and `internArena` the second, and because\r\n * both drive the same `writeEffectDescription` walk they cannot fall out of\r\n * step with each other.\r\n */\r\nexport class CjsCarbonEffectWriter\r\n{\r\n    _table;\r\n    _permutations = [];\r\n    _bodies = [];\r\n    _compilerVersion;\r\n    _sourceHash;\r\n    _backend;\r\n    _version;\r\n\r\n    /**\r\n     * Creates an empty container builder.\r\n     *\r\n     * @param {object} [options] Builder options.\r\n     * @param {number} [options.version] Container data version to emit; must be\r\n     *     one of `CARBON_EFFECT_WRITE_VERSIONS`. Defaults to the current\r\n     *     version. Rejected at construction, not at `finish()`, so a caller\r\n     *     learns it asked for something unwritable before doing the work.\r\n     * @param {number[]|Uint8Array} [options.compilerVersion] Four version bytes.\r\n     * @param {string|Uint8Array} [options.sourceHash] 32 ASCII hash bytes.\r\n     * @param {CjsStringTable} [options.stringTable] Arena to intern into.\r\n     * @param {boolean} [options.backend] Emit the optional trailing block per pass.\r\n     */\r\n    constructor(options = {})\r\n    {\r\n        this._version = resolveWriteVersion(options.version);\r\n        this._table = options.stringTable ?? new CjsStringTable();\r\n        this._compilerVersion = options.compilerVersion ?? [ 0, 0, 0, 0 ];\r\n        this._sourceHash = options.sourceHash ?? \"0\".repeat(CARBON_EFFECT_SOURCE_HASH_BYTES);\r\n        this._backend = options.backend === true;\r\n    }\r\n\r\n    /**\r\n     * Returns the arena this builder interns into.\r\n     *\r\n     * @returns {CjsStringTable} String table.\r\n     */\r\n    get stringTable()\r\n    {\r\n        return this._table;\r\n    }\r\n\r\n    /**\r\n     * Adds a permutation axis.\r\n     *\r\n     * @param {object} axis Axis description.\r\n     * @param {string} axis.name Axis name.\r\n     * @param {number} [axis.defaultOption] Index of the default option.\r\n     * @param {string} [axis.description] Axis description text.\r\n     * @param {number} [axis.type] Axis type byte.\r\n     * @param {string[]} axis.options Option names.\r\n     * @returns {CjsCarbonEffectWriter} This builder.\r\n     */\r\n    addPermutation(axis)\r\n    {\r\n        this._permutations.push({\r\n            name: String(axis.name ?? \"\"),\r\n            defaultOption: axis.defaultOption ?? 0,\r\n            description: String(axis.description ?? \"\"),\r\n            type: axis.type ?? 0,\r\n            options: (axis.options ?? []).map((option) => String(option))\r\n        });\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     * Adds one permutation's description record tree.\r\n     *\r\n     * @param {number} index Permutation index.\r\n     * @param {object} description Description record tree.\r\n     * @returns {CjsCarbonEffectWriter} This builder.\r\n     */\r\n    addBody(index, description)\r\n    {\r\n        this._bodies.push({ index, description, bytes: null });\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     * Adds one permutation's already-serialised description bytes.\r\n     *\r\n     * Used when re-emitting a file whose arena is being reused verbatim: the\r\n     * bytes already carry resolved offsets into that arena, so they must not be\r\n     * re-interned.\r\n     *\r\n     * @param {number} index Permutation index.\r\n     * @param {Uint8Array} bytes Serialised description blob.\r\n     * @returns {CjsCarbonEffectWriter} This builder.\r\n     */\r\n    addRawBody(index, bytes)\r\n    {\r\n        this._bodies.push({ index, description: null, bytes: Uint8Array.from(bytes) });\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     * Interns, serialises and assembles the container.\r\n     *\r\n     * @returns {Uint8Array} Container bytes.\r\n     */\r\n    toBytes()\r\n    {\r\n        for (const axis of this._permutations)\r\n        {\r\n            axis.nameRef = this._table.addString(axis.name);\r\n            axis.descriptionRef = this._table.addString(axis.description);\r\n            axis.optionRefs = axis.options.map((option) => this._table.addString(option));\r\n        }\r\n        for (const body of this._bodies)\r\n        {\r\n            if (body.description)\r\n            {\r\n                writeEffectDescription(new CjsByteWriter(), body.description, {\r\n                    arena: collectArena(this._table),\r\n                    backend: this._backend,\r\n                    version: this._version\r\n                });\r\n            }\r\n        }\r\n\r\n        this._table.finish();\r\n\r\n        const arena = internArena(this._table);\r\n        const bodies = this._bodies.map((body) =>\r\n        {\r\n            if (body.bytes) return { index: body.index, bytes: body.bytes };\r\n            const writer = new CjsByteWriter();\r\n            writeEffectDescription(writer, body.description, { arena, backend: this._backend, version: this._version });\r\n            return { index: body.index, bytes: writer.toBytes() };\r\n        });\r\n\r\n        const permutationRows = this._permutations.map((axis) => ({\r\n            name: axis.name,\r\n            nameOffset: this._table.offsetOf(axis.nameRef),\r\n            defaultOption: axis.defaultOption,\r\n            descriptionOffset: this._table.offsetOf(axis.descriptionRef),\r\n            type: axis.type,\r\n            options: axis.optionRefs.map((reference) => this._table.offsetOf(reference))\r\n        }));\r\n\r\n        return writeCarbonEffectFile({\r\n            version: this._version,\r\n            compilerVersion: this._compilerVersion,\r\n            sourceHash: this._sourceHash,\r\n            stringTableBytes: this._table.toBytes(),\r\n            permutationRows,\r\n            bodies\r\n        });\r\n    }\r\n}\r\n\r\nexport { CARBON_EFFECT_RECORD_BYTES, CARBON_EFFECT_SOURCE_HASH_BYTES };\r\nexport default CjsCarbonEffectWriter;\r\n"],"names":["textEncoder","TextEncoder","PERMUTATION_FIXED_BYTES","hashBytes","bytes","hash","index","length","Math","imul","bytesEqual","a","b","normalizeSourceHash","value","encode","Uint8Array","buffer","byteOffset","byteLength","CARBON_EFFECT_SOURCE_HASH_BYTES","CjsFormatWriteError","normalizeCompilerVersion","Array","isArray","from","part","Number","writeCarbonEffectFile","parts","version","resolveWriteVersion","compilerVersion","sourceHash","repeat","stringTableBytes","permutationRows","bodies","count","ordered","slice","sort","position","permutationBytes","row","options","name","headerSize","base","byContent","Map","records","uniqueBodies","cursor","body","key","candidates","get","existing","find","candidate","push","offset","size","record","set","writer","CjsByteWriter","u32","u8","nameOffset","defaultOption","descriptionOffset","type","optionOffset","written","expected","toBytes","CjsCarbonEffectWriter","_table","_permutations","_bodies","_compilerVersion","_sourceHash","_backend","_version","constructor","stringTable","CjsStringTable","backend","addPermutation","axis","String","description","map","option","addBody","addRawBody","nameRef","addString","descriptionRef","optionRefs","writeEffectDescription","arena","collectArena","finish","internArena","offsetOf","reference"],"mappings":"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"}