@carbonenginejs/runtime-resource 0.12.2 → 0.13.0

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

@@ -1 +1 @@
-{"version":3,"file":"CjsCarbonEffectReader.js","sources":["../../../../src/format/carbonEffect/CjsCarbonEffectReader.js"],"sourcesContent":["// Source: trinity/trinity/Resources/Tr2EffectRes.cpp (DoLoad, GetShader)\n// Source: trinity/shadercompiler/ShaderCompiler.cpp:746-845 (file assembly)\n\nimport { CjsByteReader } from \"../CjsByteReader.js\";\nimport { CjsFormatReadError } from \"../CjsFormatError.js\";\nimport { CARBON_EFFECT_DATA_VERSION, readEffectDescription } from \"./carbonEffectRecords.js\";\n\n/** Byte count of the ASCII-hex MD5 source hash in the v15 header. */\nexport const CARBON_EFFECT_SOURCE_HASH_BYTES = 32;\n\n/** Byte count of one offset-table row: `{u32 index, u32 offset, u32 size}`. */\nexport const CARBON_EFFECT_RECORD_BYTES = 12;\n\n/**\n * Plain byte cursor over one description blob, carrying the Carbon effect error\n * class and message.\n *\n * Separate from the container reader because the container reader parses its\n * header in the constructor; a body needs a cursor, not a second header parse.\n */\nexport class CjsCarbonEffectBodyReader extends CjsByteReader\n{\n    static ReadError = CjsFormatReadError;\n\n    static endOfDataMessage = \"Unexpected end of Carbon effect data\";\n}\n\n/**\n * Reader for Carbon's compiled-effect container at version 15.\n *\n * The header is (`ShaderCompiler.cpp:822-831`):\n *\n * ```\n * u32      version = 15\n * u8[4]    shaderCompilerVersion       <- four bytes, not a u32\n * char[32] sourceHash                  <- ASCII hex MD5 of the HLSL inputs\n * u32      stringTableSize | arena\n * u8       permutationCount | permutation records\n * u32      recordCount     | recordCount x { u32 index, u32 offset, u32 size }\n * description blobs\n * ```\n *\n * Only version 15 is accepted. Carbon's own reader takes 2..15\n * (`Tr2EffectRes.cpp:209`) but marks the v13/v14 field-order boundaries\n * unverified, and every file in the shipped dx11/dx12 corpus is v15, so a\n * lower version here means something unexpected rather than something old.\n */\nexport class CjsCarbonEffectReader extends CjsCarbonEffectBodyReader\n{\n    /** Cursor class used for description blobs. */\n    static BodyReader = CjsCarbonEffectBodyReader;\n\n    /**\n     * Reads the container header, arena, permutation axes and offset table.\n     *\n     * @param {ArrayBuffer|ArrayBufferView|Uint8Array} bytes Container bytes.\n     * @param {object} [options] Read options.\n     * @param {string} [options.source] Source name used in error details.\n     * @param {boolean} [options.permissive] Accept a sparse or misordered offset\n     *     table instead of rejecting it. For forensic inspection of a file already\n     *     known to be malformed; never for a load path.\n     */\n    constructor(bytes, options = {})\n    {\n        super(bytes, options);\n\n        this.version = this.readUint32();\n        if (this.version !== CARBON_EFFECT_DATA_VERSION)\n        {\n            throw this._error(\n                `Unsupported Carbon effect version ${this.version}; expected ${CARBON_EFFECT_DATA_VERSION}`,\n                { version: this.version }\n            );\n        }\n\n        this.compilerVersion = Array.from(this.readRaw(4));\n        this.sourceHash = Uint8Array.from(this.readRaw(CARBON_EFFECT_SOURCE_HASH_BYTES));\n\n        this.stringTableSize = this.readUint32();\n        if (this.offset + this.stringTableSize > this.bytes.length)\n        {\n            throw this._error(\"Invalid Carbon effect string-table size\", {\n                stringTableSize: this.stringTableSize,\n                byteLength: this.bytes.length\n            });\n        }\n        this.stringTableBytes = this.bytes.subarray(this.offset, this.offset + this.stringTableSize);\n        this.skip(this.stringTableSize);\n        this.setStringTable(this.stringTableBytes, this.stringTableSize);\n\n        this.permutations = this.#readPermutations();\n        this.records = this.#readRecords();\n        this.headerEnd = this.offset;\n        this.diagnostics = this.#inspect();\n\n        if (!options.permissive)\n        {\n            this.requireDensePermutationTable();\n        }\n    }\n\n    /**\n     * Returns the product of the permutation axes' option counts — the number of\n     * offset-table rows a fully populated file has.\n     *\n     * @returns {number} Permutation count.\n     */\n    get permutationProduct()\n    {\n        let product = 1;\n        for (const permutation of this.permutations)\n        {\n            product *= permutation.options.length;\n        }\n        return product;\n    }\n\n    /**\n     * Throws unless the offset table is dense and positionally indexed.\n     *\n     * Carbon indexes `m_offsets` positionally and never reads the stored `index`\n     * field (`Tr2EffectRes.cpp:121-126`), so a sparse or misordered table does\n     * not fail — it silently returns the wrong shader body. Carbon gets density\n     * incidentally, from `g_compiledEffects` being a `std::map` densely keyed by\n     * `AddPermutationsToWorkQueue`, and promises it nowhere.\n     *\n     * Measured across the whole shipped corpus at build 3444265 — 4833 files and\n     * 78,498 rows across `effect.dx11`, `effect.dx12` and `effect.metal` — both\n     * conditions hold in every file, so this runs by default.\n     *\n     * `--ignore-permutations` does make CCP's compiler emit only key 0 while\n     * declaring every axis, so a sparse file is producible. That argues for an\n     * escape hatch, not for permissiveness: because Carbon indexes positionally,\n     * accepting such a file returns the wrong permutation's shader silently, which\n     * is exactly the failure class this container port exists to close.\n     * `{ permissive: true }` is the opt-in, for inspecting a file already known to\n     * be malformed.\n     */\n    requireDensePermutationTable()\n    {\n        if (!this.diagnostics.dense)\n        {\n            throw this._error(\"Carbon effect offset table is sparse\", {\n                recordCount: this.records.length,\n                permutationProduct: this.permutationProduct\n            });\n        }\n        if (!this.diagnostics.indicesMatchPosition)\n        {\n            throw this._error(\"Carbon effect offset table is not positionally indexed\", {\n                firstMismatch: this.diagnostics.firstIndexMismatch\n            });\n        }\n    }\n\n    /**\n     * Reads and parses one permutation's description blob.\n     *\n     * `backend` is **optional**, and omitting it is the interesting case. A\n     * Carbon file ends each pass at the render states; ours adds one eight-byte\n     * block reference. Nothing in the header distinguishes the two, and we\n     * deliberately do not add anything — no envelope, no version of our own,\n     * because CCP owns the version space and a container that announces itself\n     * is an invention nothing requires.\n     *\n     * Instead the blob describes itself, using a rule the format already has.\n     * Every sized record must parse to exactly its declared end (Rule 1), and a\n     * body's declared size is in the offset table. So the wrong interpretation\n     * either throws or leaves the cursor somewhere other than the end, and one\n     * retry settles it.\n     *\n     * Pass `backend` explicitly when the caller knows — the loader does, because\n     * backend selection is by resource path, mirroring Carbon's\n     * `effect.dx11`/`effect.dx12`/`effect.metal`. Auto-detection is for bytes\n     * that arrive without that context: tooling, caches, inspection.\n     *\n     * @param {number} index Permutation index, positional in the offset table.\n     * @param {object} [options] Read options.\n     * @param {boolean} [options.backend] Expect our optional per-pass trailing\n     *     block. Omit to detect it from the blob's declared end.\n     * @returns {object} Description record tree.\n     */\n    readDescription(index, options = {})\n    {\n        const record = this.records[index];\n        if (!record)\n        {\n            throw this._error(`No Carbon effect body at permutation index ${index}`, {\n                index,\n                recordCount: this.records.length\n            });\n        }\n\n        if (options.backend !== undefined)\n        {\n            return this.#readDescriptionAs(record, options.backend === true);\n        }\n\n        // Plain Carbon first: it is the larger population, and it is the reading\n        // that must stay cheap.\n        try\n        {\n            return this.#readDescriptionAs(record, false);\n        }\n        catch (withoutBlocks)\n        {\n            try\n            {\n                return this.#readDescriptionAs(record, true);\n            }\n            catch\n            {\n                // Report the plain-Carbon failure. If neither reading works the\n                // blob is malformed, and the Carbon diagnosis is the useful one;\n                // the backend attempt's error would describe a misparse of bytes\n                // that were never a backend block.\n                throw withoutBlocks;\n            }\n        }\n    }\n\n    /**\n     * Parses one body under an exact backend-block assumption.\n     *\n     * @param {object} record Offset-table row.\n     * @param {boolean} backend Whether to expect the per-pass block.\n     * @returns {object} Description record tree.\n     */\n    #readDescriptionAs(record, backend)\n    {\n        const reader = new this.constructor.BodyReader(this.bytes, {\n            source: this.source,\n            offset: record.offset,\n            end: record.offset + record.size,\n            stringTable: this.stringTableBytes,\n            stringTableSize: this.stringTableSize\n        });\n        return readEffectDescription(reader, { backend });\n    }\n\n    /**\n     * Returns the raw description-blob bytes for one permutation.\n     *\n     * @param {number} index Permutation index, positional in the offset table.\n     * @returns {Uint8Array} View over the body bytes.\n     */\n    bodyBytes(index)\n    {\n        const record = this.records[index];\n        if (!record)\n        {\n            throw this._error(`No Carbon effect body at permutation index ${index}`, { index });\n        }\n        return this.bytes.subarray(record.offset, record.offset + record.size);\n    }\n\n    /**\n     * Reads the permutation axis records (`ShaderCompiler.cpp:769-795`,\n     * `Tr2EffectRes.cpp:263-292`).\n     *\n     * @returns {object[]} Permutation axes with arena references retained.\n     */\n    #readPermutations()\n    {\n        const permutations = [];\n        const count = this.readUint8();\n        for (let index = 0; index < count; index += 1)\n        {\n            const nameOffset = this.readUint32();\n            const name = this.readStringAt(nameOffset);\n            const defaultOption = this.readUint8();\n            const descriptionOffset = this.readUint32();\n            const description = this.readStringAt(descriptionOffset);\n            const type = this.readUint8();\n\n            const options = [];\n            const optionCount = this.readUint8();\n            for (let optionIndex = 0; optionIndex < optionCount; optionIndex += 1)\n            {\n                const offset = this.readUint32();\n                options.push({ offset, value: this.readStringAt(offset) });\n            }\n\n            permutations.push({\n                name: { offset: nameOffset, value: name },\n                defaultOption,\n                description: { offset: descriptionOffset, value: description },\n                type,\n                options\n            });\n        }\n        return permutations;\n    }\n\n    /**\n     * Reads the offset table (`ShaderCompiler.cpp:800-820`,\n     * `Tr2EffectRes.cpp:294-311`).\n     *\n     * @returns {object[]} Offset-table rows.\n     */\n    #readRecords()\n    {\n        const count = this.readUint32();\n        if (count === 0)\n        {\n            throw this._error(\"Carbon effect contains no compiled bodies\");\n        }\n        if (this.offset + count * CARBON_EFFECT_RECORD_BYTES > this.bytes.length)\n        {\n            throw this._error(\"Carbon effect offset table runs past the end of the file\", {\n                recordCount: count,\n                byteLength: this.bytes.length\n            });\n        }\n\n        const records = [];\n        for (let index = 0; index < count; index += 1)\n        {\n            records.push({\n                index: this.readUint32(),\n                offset: this.readUint32(),\n                size: this.readUint32()\n            });\n        }\n        return records;\n    }\n\n    /**\n     * Validates every row's byte range and collects the structural diagnostics\n     * Carbon relies on without stating.\n     *\n     * @returns {object} Structural diagnostics.\n     */\n    #inspect()\n    {\n        const headerEnd = this.headerEnd;\n        const byteLength = this.bytes.length;\n        let firstIndexMismatch = null;\n        const uniqueOffsets = new Set();\n\n        for (let index = 0; index < this.records.length; index += 1)\n        {\n            const record = this.records[index];\n            if (record.index !== index && firstIndexMismatch === null)\n            {\n                firstIndexMismatch = { position: index, storedIndex: record.index };\n            }\n            const end = record.offset + record.size;\n            if (record.offset < headerEnd || end > byteLength || record.size === 0)\n            {\n                throw this._error(`Carbon effect body record ${index} is out of range`, {\n                    position: index,\n                    offset: record.offset,\n                    size: record.size,\n                    headerEnd,\n                    byteLength\n                });\n            }\n            uniqueOffsets.add(record.offset);\n        }\n\n        // The body region must begin exactly where the header ends. Carbon computes\n        // its first body offset as `4 + 4 + 32 + headerSize + stringTable.GetSize()`\n        // (`ShaderCompiler.cpp:801`), so a gap or an overlap means our reconstruction\n        // of that arithmetic disagrees with the writer's — which would silently\n        // misread every body rather than fail. Carbon's own reader does not check\n        // this; measured across 4833 shipped files, every one starts its body region\n        // flush against the header with no slack.\n        const firstBody = Math.min(...this.records.map((record) => record.offset));\n        if (firstBody !== headerEnd)\n        {\n            throw this._error(\"Carbon effect body region does not start where the header ends\", {\n                firstBody,\n                headerEnd,\n                slack: firstBody - headerEnd\n            });\n        }\n\n        return {\n            recordCount: this.records.length,\n            permutationProduct: this.permutationProduct,\n            dense: this.records.length === this.permutationProduct,\n            indicesMatchPosition: firstIndexMismatch === null,\n            firstIndexMismatch,\n            uniqueBodyCount: uniqueOffsets.size,\n            aliasedRowCount: this.records.length - uniqueOffsets.size\n        };\n    }\n}\n\nexport default CjsCarbonEffectReader;\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_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"],"mappings":"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"}
+{"version":3,"file":"CjsCarbonEffectReader.js","sources":["../../../../src/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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"}