@carbonenginejs/runtime-resource 0.17.0 → 0.18.0

package/dist/formats/webgpu/core/effectBackendBodySet.js.map

@@ -1 +1 @@
-{"version":3,"file":"effectBackendBodySet.js","sources":["../../../../../src/formats/webgpu/core/effectBackendBodySet.js"],"sourcesContent":["import { HlslEffectBindingManifest } from \"../../hlsl/core/tr2/shader/HlslEffectBindingManifest.js\";\nimport { enumerateUniqueEffectBodies } from \"../../../format/effect/effectBodyInventory.js\";\nimport { buildEffectAnalysis } from \"./helpers.js\";\nimport { normalizeBytecodeBytes } from \"./effectAnalysis.js\";\nimport { lowerDxbcToIr } from \"./ir/lowerDxbcToIr.js\";\nimport { buildWgslBindingPlan } from \"./wgsl/buildWgslBindingPlan.js\";\nimport { buildWgsl } from \"./wgsl/emitWgsl.js\";\nimport { buildWgslSet } from \"./wgsl/buildWgslSet.js\";\nimport { buildResourceTransformPlan } from \"./wgsl/buildResourceTransformPlan.js\";\nimport { sha256Bytes, sha256Utf8 } from \"../../../format/effect/sha256.js\";\nimport { selectEffectStages } from \"./packageEffectSelection.js\";\nimport { compareUtf8 } from \"../../../format/compareUtf8.js\";\nimport {\n    isParticleClearEffectCandidate,\n    particleClearEffectProofFor,\n    preflightParticleClearEffectProfile\n} from \"./wgsl/lowerParticleClearComputePrograms.js\";\n\nexport const EFFECT_BACKEND_BODY_SET_CHUNK = \"WGSB\";\nexport const EFFECT_BACKEND_BODY_SET_FORMAT = \"CJS_WGSL_BODY_SET\";\nexport const EFFECT_BACKEND_BODY_SET_VERSION = 1;\n\n/**\n * One translation unit is exactly one pass of one body: the binding plan, the\n * resource-transform plan, and every stage's emitted WGSL are derived together.\n * Bodies that share an identical pass signature therefore share one unit.\n *\n * @param {object} pass Pass entry carrying its ordered stage records.\n * @returns {string} Stable signature for the pass translation unit.\n */\nfunction passUnitSignature(pass)\n{\n    return JSON.stringify({\n        passKey: pass.passKey,\n        stages: pass.stages\n            .map((stage) => ({\n                stageName: stage.stageName,\n                bytecode: stage.bytecodeDigest,\n                semanticBindings: stage.semanticBindings,\n                // An effect profile changes emission, so two otherwise identical\n                // passes must not share one unit when their proofs differ.\n                effectProfileProof: stage.effectProfileProof\n                    ? sha256Utf8(JSON.stringify(stage.effectProfileProof))\n                    : null\n            }))\n            .sort((left, right) => compareUtf8(left.stageName, right.stageName))\n    });\n}\n\nfunction collectBodyStageBytecode(effectDescription)\n{\n    const bytecodeByKey = new Map();\n\n    for (const technique of effectDescription?.techniques ?? [])\n    {\n        for (let passIndex = 0; passIndex < technique.passes.length; passIndex++)\n        {\n            const stageInputs = technique.passes[passIndex].stageInputs;\n\n            for (let stageType = 0; stageType < stageInputs.length; stageType++)\n            {\n                const stage = stageInputs[stageType];\n                if (!stage?.m_exists) continue;\n\n                const stageName = stage.cjsShaderBytecode?.stageName;\n                const value = stage.cjsShaderBytecode?.bytes;\n                if (!stageName || value === undefined || value === null) continue;\n\n                const key = `${technique.name}.pass${passIndex}.${stageName}`;\n                const bytes = normalizeBytecodeBytes(value, `${key} stage bytecode`);\n\n                if (!bytes?.length)\n                {\n                    throw new TypeError(`${key} stage bytecode must be a non-empty byte view`);\n                }\n\n                bytecodeByKey.set(key, {\n                    techniqueName: technique.name,\n                    passIndex,\n                    stageType,\n                    stageName,\n                    bytes\n                });\n            }\n        }\n    }\n\n    return bytecodeByKey;\n}\n\nfunction resolveBody(effectRes, permutationIndex, source)\n{\n    const shader = effectRes.GetShaderByIndex(permutationIndex);\n\n    if (!shader)\n    {\n        throw new Error(\n            `Effect body at permutation ${permutationIndex} could not be decoded`\n        );\n    }\n\n    const effectDescription = shader.GetEffectDescription();\n\n    if (!effectDescription)\n    {\n        throw new Error(\n            `Effect body at permutation ${permutationIndex} has no effect description`\n        );\n    }\n\n    const resolved = {\n        effectRes,\n        shader,\n        selection: { bodyIndex: permutationIndex, selectedOptions: [] },\n        effectDescription,\n        bindingManifest: HlslEffectBindingManifest.fromEffectDescription(effectDescription),\n        stageBytecodeByKey: collectBodyStageBytecode(effectDescription)\n    };\n\n    return {\n        resolved,\n        analysis: buildEffectAnalysis(resolved, {\n            source,\n            decodeBytecode: false,\n            decodeInstructions: false\n        })\n    };\n}\n\nfunction buildPassEntries(analysis, resolved, selection, effectProfileContext)\n{\n    const selectedStages = selectEffectStages(analysis.stages, selection);\n    const passes = new Map();\n\n    for (const stage of selectedStages)\n    {\n        const passKey = `${stage.techniqueName}.pass${stage.passIndex}`;\n\n        if (!passes.has(passKey))\n        {\n            passes.set(passKey, { passKey, stages: [] });\n        }\n\n        const bytecode = resolved.stageBytecodeByKey.get(stage.key)?.bytes;\n\n        if (!bytecode?.length)\n        {\n            throw new Error(`${stage.key} has no shader bytecode`);\n        }\n\n        passes.get(passKey).stages.push({\n            key: stage.key,\n            stageName: stage.stageName,\n            bytecodeKey: stage.key,\n            bytecodeDigest: sha256Bytes(bytecode),\n            semanticBindings: analysis.stages.find((candidate) =>\n                candidate.techniqueName === stage.techniqueName\n                && candidate.passIndex === stage.passIndex\n                && candidate.stageName === stage.stageName)?.bindings || [],\n            effectProfileProof: particleClearEffectProofFor(\n                effectProfileContext,\n                stage.key\n            )\n        });\n    }\n\n    return Array.from(passes.values());\n}\n\nfunction translatePassUnit(pass, programForKey, source, bindingPolicy)\n{\n    const irEntries = pass.stages.map((stage) => ({\n        key: stage.key,\n        ir: programForKey(stage.bytecodeKey),\n        semanticBindings: stage.semanticBindings,\n        effectProfileProof: stage.effectProfileProof\n    }));\n    const resourceTransformPlan = buildResourceTransformPlan(\n        irEntries.map((entry) => ({\n            ir: entry.ir,\n            semanticBindings: entry.semanticBindings\n        })),\n        { layoutKey: pass.passKey }\n    );\n    const proof = irEntries.find((entry) => entry.effectProfileProof)\n        ?.effectProfileProof ?? null;\n    const plan = buildWgslBindingPlan(\n        irEntries.map((entry) => entry.ir),\n        {\n            ...(bindingPolicy ?? {}),\n            ...(proof ? { effectProfileProof: proof } : {}),\n            ...(resourceTransformPlan ? { resourceTransformPlan } : {})\n        }\n    );\n\n    return buildWgslSet(irEntries.map((entry) => ({\n        key: entry.key,\n        shader: buildWgsl(entry.ir, {\n            bindingPlan: plan,\n            ...(resourceTransformPlan ? { resourceTransformPlan } : {}),\n            ...(entry.effectProfileProof\n                ? { effectProfileProof: entry.effectProfileProof }\n                : {})\n        })\n    })));\n}\n\n/**\n * Translate every unique source body into backend programs, layouts, and\n * resource transforms, sharing one translation unit between bodies whose pass\n * is byte-for-byte identical.\n *\n * A body that cannot be lowered is retained as an explicitly unsupported\n * in-memory record carrying its reason. Portable source reflection is built\n * separately from the same effect; this body-set document does not store it.\n *\n * @param {object} effectRes Loaded version-15 `Tr2EffectRes`.\n * @param {object} permutationGraph Validated `PGRF` document.\n * @param {object} [options] Source label, stage selection, and binding policy.\n * @returns {object} Frozen `CJS_WGSL_BODY_SET` document.\n */\nexport function buildEffectBackendBodySet(effectRes, permutationGraph, options = {})\n{\n    const source = options.source || \"memory\";\n    const selection = options.selection ?? null;\n    const bindingPolicy = options.bindingPolicy ?? null;\n    const groups = enumerateUniqueEffectBodies(effectRes);\n\n    if (groups.length !== permutationGraph.bodies.length)\n    {\n        throw new Error(\n            \"Effect backend body set requires one unique body per permutation-graph body\"\n        );\n    }\n\n    const unitsBySignature = new Map();\n    const graphBodiesByKey = new Map(permutationGraph.bodies.map((body) => [ body.key, body ]));\n    const passUnits = [];\n    const bodies = [];\n    const seenBodyKeys = new Set();\n\n    for (const group of groups)\n    {\n        const variant = permutationGraph.variants[group.permutationIndex];\n        const graphBody = variant ? graphBodiesByKey.get(variant.bodyKey) : null;\n\n        if (!graphBody)\n        {\n            throw new Error(\n                `Effect backend body ${group.permutationIndex} does not reconcile with its permutation graph record`\n            );\n        }\n\n        if (seenBodyKeys.has(graphBody.key))\n        {\n            throw new Error(\n                `Effect backend body ${graphBody.key} was enumerated more than once`\n            );\n        }\n\n        seenBodyKeys.add(graphBody.key);\n\n        let resolvedBody = null;\n        let passes = null;\n        let programForKey = null;\n\n        try\n        {\n            resolvedBody = resolveBody(effectRes, group.permutationIndex, source);\n\n            // One IR cache per body, so a stage shared by two passes lowers once\n            // and the effect-profile preflight can seed it exactly as the\n            // selected-body path does.\n            const programsByKey = new Map();\n            programForKey = (key) =>\n            {\n                if (programsByKey.has(key)) return programsByKey.get(key);\n\n                const bytecode = resolvedBody.resolved.stageBytecodeByKey.get(key)?.bytes;\n\n                if (!bytecode?.length)\n                {\n                    throw new Error(`${key} has no shader bytecode`);\n                }\n\n                const program = lowerDxbcToIr(bytecode, { source: `${source}#${key}` });\n                programsByKey.set(key, program);\n                return program;\n            };\n\n            let effectProfileContext = null;\n\n            if (isParticleClearEffectCandidate(resolvedBody.resolved.effectDescription))\n            {\n                programForKey(\"Main.pass0.compute\");\n                programForKey(\"Main.pass1.compute\");\n                effectProfileContext = preflightParticleClearEffectProfile(\n                    resolvedBody.resolved.effectDescription,\n                    programsByKey\n                );\n            }\n\n            passes = buildPassEntries(\n                resolvedBody.analysis,\n                resolvedBody.resolved,\n                selection,\n                effectProfileContext\n            );\n        }\n        catch (error)\n        {\n            // Stage selection and profile preflight fail closed per body: an\n            // unsupported stage kind in one body must not fail the package.\n            bodies.push(Object.freeze({\n                bodyKey: graphBody.key,\n                representativePermutationIndex: group.permutationIndex,\n                status: \"unsupported\",\n                error: String(error?.message ?? error),\n                passCount: 0,\n                passes: Object.freeze([])\n            }));\n            continue;\n        }\n\n        const bodyPasses = [];\n        let failure = null;\n\n        for (const pass of passes)\n        {\n            const signature = passUnitSignature(pass);\n            let unit = unitsBySignature.get(signature);\n\n            if (!unit)\n            {\n                let wgsl = null;\n\n                try\n                {\n                    wgsl = translatePassUnit(\n                        pass,\n                        programForKey,\n                        source,\n                        bindingPolicy\n                    );\n                }\n                catch (error)\n                {\n                    failure = String(error?.message ?? error);\n                    break;\n                }\n\n                unit = {\n                    key: `unit${passUnits.length}`,\n                    sha256: sha256Utf8(`${JSON.stringify(wgsl)}\\n`),\n                    wgslSetVersion: wgsl.formatVersion,\n                    shaders: wgsl.shaders,\n                    layouts: wgsl.layouts,\n                    ...(wgsl.resourceTransforms\n                        ? { resourceTransforms: wgsl.resourceTransforms }\n                        : {})\n                };\n                unitsBySignature.set(signature, unit);\n                passUnits.push(unit);\n            }\n\n            bodyPasses.push(Object.freeze({ passKey: pass.passKey, unitKey: unit.key }));\n        }\n\n        bodies.push(Object.freeze(failure\n            ? {\n                bodyKey: graphBody.key,\n                representativePermutationIndex: group.permutationIndex,\n                status: \"unsupported\",\n                error: failure,\n                passCount: 0,\n                passes: Object.freeze([])\n            }\n            : {\n                bodyKey: graphBody.key,\n                representativePermutationIndex: group.permutationIndex,\n                status: \"translated\",\n                error: null,\n                passCount: bodyPasses.length,\n                passes: Object.freeze(bodyPasses)\n            }));\n    }\n\n    const translatedCount = bodies.filter((body) => body.status === \"translated\").length;\n\n    if (!translatedCount)\n    {\n        throw new Error(\n            \"Effect backend body set requires at least one translated body\"\n        );\n    }\n\n    return Object.freeze({\n        format: EFFECT_BACKEND_BODY_SET_FORMAT,\n        formatVersion: EFFECT_BACKEND_BODY_SET_VERSION,\n        coverage: Object.freeze({\n            bodies: translatedCount === bodies.length ? \"all-unique\" : \"partial\",\n            programs: \"complete-for-translated\"\n        }),\n        bodyCount: bodies.length,\n        translatedBodyCount: translatedCount,\n        passUnitCount: passUnits.length,\n        passUnits: Object.freeze(passUnits.map((unit) => Object.freeze(unit))),\n        bodies: Object.freeze(bodies)\n    });\n}\n"],"names":["EFFECT_BACKEND_BODY_SET_CHUNK","EFFECT_BACKEND_BODY_SET_FORMAT","EFFECT_BACKEND_BODY_SET_VERSION","passUnitSignature","pass","JSON","stringify","passKey","stages","map","stage","stageName","bytecode","bytecodeDigest","semanticBindings","effectProfileProof","sha256Utf8","sort","left","right","compareUtf8","collectBodyStageBytecode","effectDescription","bytecodeByKey","Map","technique","techniques","passIndex","passes","length","stageInputs","stageType","m_exists","cjsShaderBytecode","value","bytes","undefined","key","name","normalizeBytecodeBytes","TypeError","set","techniqueName","resolveBody","effectRes","permutationIndex","source","shader","GetShaderByIndex","Error","GetEffectDescription","resolved","selection","bodyIndex","selectedOptions","bindingManifest","HlslEffectBindingManifest","fromEffectDescription","stageBytecodeByKey","analysis","buildEffectAnalysis","decodeBytecode","decodeInstructions","buildPassEntries","effectProfileContext","selectedStages","selectEffectStages","has","get","push","bytecodeKey","sha256Bytes","find","candidate","bindings","particleClearEffectProofFor","Array","from","values","translatePassUnit","programForKey","bindingPolicy","irEntries","ir","resourceTransformPlan","buildResourceTransformPlan","entry","layoutKey","proof","plan","buildWgslBindingPlan","buildWgslSet","buildWgsl","bindingPlan","buildEffectBackendBodySet","permutationGraph","options","groups","enumerateUniqueEffectBodies","bodies","unitsBySignature","graphBodiesByKey","body","passUnits","seenBodyKeys","Set","group","variant","variants","graphBody","bodyKey","add","resolvedBody","programsByKey","program","lowerDxbcToIr","isParticleClearEffectCandidate","preflightParticleClearEffectProfile","error","Object","freeze","representativePermutationIndex","status","String","message","passCount","bodyPasses","failure","signature","unit","wgsl","sha256","wgslSetVersion","formatVersion","shaders","layouts","resourceTransforms","unitKey","translatedCount","filter","format","coverage","programs","bodyCount","translatedBodyCount","passUnitCount"],"mappings":"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"}
+{"version":3,"file":"effectBackendBodySet.js","sources":["../../../../../src/formats/webgpu/core/effectBackendBodySet.js"],"sourcesContent":["import { HlslEffectBindingManifest } from \"../../hlsl/core/tr2/shader/HlslEffectBindingManifest.js\";\r\nimport { enumerateUniqueEffectBodies } from \"../../../format/effect/effectBodyInventory.js\";\r\nimport { buildEffectAnalysis } from \"./helpers.js\";\r\nimport { normalizeBytecodeBytes } from \"./effectAnalysis.js\";\r\nimport { lowerDxbcToIr } from \"./ir/lowerDxbcToIr.js\";\r\nimport { buildWgslBindingPlan } from \"./wgsl/buildWgslBindingPlan.js\";\r\nimport { buildWgsl } from \"./wgsl/emitWgsl.js\";\r\nimport { buildWgslSet } from \"./wgsl/buildWgslSet.js\";\r\nimport { buildResourceTransformPlan } from \"./wgsl/buildResourceTransformPlan.js\";\r\nimport { sha256Bytes, sha256Utf8 } from \"../../../format/effect/sha256.js\";\r\nimport { selectEffectStages } from \"./packageEffectSelection.js\";\r\nimport { compareUtf8 } from \"../../../format/compareUtf8.js\";\r\nimport {\r\n    isParticleClearEffectCandidate,\r\n    particleClearEffectProofFor,\r\n    preflightParticleClearEffectProfile\r\n} from \"./wgsl/lowerParticleClearComputePrograms.js\";\r\n\r\nexport const EFFECT_BACKEND_BODY_SET_FORMAT = \"CJS_WGSL_BODY_SET\";\r\nexport const EFFECT_BACKEND_BODY_SET_VERSION = 1;\r\n\r\n/**\r\n * One translation unit is exactly one pass of one body: the binding plan, the\r\n * resource-transform plan, and every stage's emitted WGSL are derived together.\r\n * Bodies that share an identical pass signature therefore share one unit.\r\n *\r\n * @param {object} pass Pass entry carrying its ordered stage records.\r\n * @returns {string} Stable signature for the pass translation unit.\r\n */\r\nfunction passUnitSignature(pass)\r\n{\r\n    return JSON.stringify({\r\n        passKey: pass.passKey,\r\n        stages: pass.stages\r\n            .map((stage) => ({\r\n                stageName: stage.stageName,\r\n                bytecode: stage.bytecodeDigest,\r\n                semanticBindings: stage.semanticBindings,\r\n                // An effect profile changes emission, so two otherwise identical\r\n                // passes must not share one unit when their proofs differ.\r\n                effectProfileProof: stage.effectProfileProof\r\n                    ? sha256Utf8(JSON.stringify(stage.effectProfileProof))\r\n                    : null\r\n            }))\r\n            .sort((left, right) => compareUtf8(left.stageName, right.stageName))\r\n    });\r\n}\r\n\r\nfunction collectBodyStageBytecode(effectDescription)\r\n{\r\n    const bytecodeByKey = new Map();\r\n\r\n    for (const technique of effectDescription?.techniques ?? [])\r\n    {\r\n        for (let passIndex = 0; passIndex < technique.passes.length; passIndex++)\r\n        {\r\n            const stageInputs = technique.passes[passIndex].stageInputs;\r\n\r\n            for (let stageType = 0; stageType < stageInputs.length; stageType++)\r\n            {\r\n                const stage = stageInputs[stageType];\r\n                if (!stage?.m_exists) continue;\r\n\r\n                const stageName = stage.cjsShaderBytecode?.stageName;\r\n                const value = stage.cjsShaderBytecode?.bytes;\r\n                if (!stageName || value === undefined || value === null) continue;\r\n\r\n                const key = `${technique.name}.pass${passIndex}.${stageName}`;\r\n                const bytes = normalizeBytecodeBytes(value, `${key} stage bytecode`);\r\n\r\n                if (!bytes?.length)\r\n                {\r\n                    throw new TypeError(`${key} stage bytecode must be a non-empty byte view`);\r\n                }\r\n\r\n                bytecodeByKey.set(key, {\r\n                    techniqueName: technique.name,\r\n                    passIndex,\r\n                    stageType,\r\n                    stageName,\r\n                    bytes\r\n                });\r\n            }\r\n        }\r\n    }\r\n\r\n    return bytecodeByKey;\r\n}\r\n\r\nfunction resolveBody(effectRes, permutationIndex, source)\r\n{\r\n    const shader = effectRes.GetShaderByIndex(permutationIndex);\r\n\r\n    if (!shader)\r\n    {\r\n        throw new Error(\r\n            `Effect body at permutation ${permutationIndex} could not be decoded`\r\n        );\r\n    }\r\n\r\n    const effectDescription = shader.GetEffectDescription();\r\n\r\n    if (!effectDescription)\r\n    {\r\n        throw new Error(\r\n            `Effect body at permutation ${permutationIndex} has no effect description`\r\n        );\r\n    }\r\n\r\n    const resolved = {\r\n        effectRes,\r\n        shader,\r\n        selection: { bodyIndex: permutationIndex, selectedOptions: [] },\r\n        effectDescription,\r\n        bindingManifest: HlslEffectBindingManifest.fromEffectDescription(effectDescription),\r\n        stageBytecodeByKey: collectBodyStageBytecode(effectDescription)\r\n    };\r\n\r\n    return {\r\n        resolved,\r\n        analysis: buildEffectAnalysis(resolved, {\r\n            source,\r\n            decodeBytecode: false,\r\n            decodeInstructions: false\r\n        })\r\n    };\r\n}\r\n\r\nfunction buildPassEntries(analysis, resolved, selection, effectProfileContext)\r\n{\r\n    const selectedStages = selectEffectStages(analysis.stages, selection);\r\n    const passes = new Map();\r\n\r\n    for (const stage of selectedStages)\r\n    {\r\n        const passKey = `${stage.techniqueName}.pass${stage.passIndex}`;\r\n\r\n        if (!passes.has(passKey))\r\n        {\r\n            passes.set(passKey, { passKey, stages: [] });\r\n        }\r\n\r\n        const bytecode = resolved.stageBytecodeByKey.get(stage.key)?.bytes;\r\n\r\n        if (!bytecode?.length)\r\n        {\r\n            throw new Error(`${stage.key} has no shader bytecode`);\r\n        }\r\n\r\n        passes.get(passKey).stages.push({\r\n            key: stage.key,\r\n            stageName: stage.stageName,\r\n            bytecodeKey: stage.key,\r\n            bytecodeDigest: sha256Bytes(bytecode),\r\n            semanticBindings: analysis.stages.find((candidate) =>\r\n                candidate.techniqueName === stage.techniqueName\r\n                && candidate.passIndex === stage.passIndex\r\n                && candidate.stageName === stage.stageName)?.bindings || [],\r\n            effectProfileProof: particleClearEffectProofFor(\r\n                effectProfileContext,\r\n                stage.key\r\n            )\r\n        });\r\n    }\r\n\r\n    return Array.from(passes.values());\r\n}\r\n\r\nfunction translatePassUnit(pass, programForKey, source, bindingPolicy)\r\n{\r\n    const irEntries = pass.stages.map((stage) => ({\r\n        key: stage.key,\r\n        ir: programForKey(stage.bytecodeKey),\r\n        semanticBindings: stage.semanticBindings,\r\n        effectProfileProof: stage.effectProfileProof\r\n    }));\r\n    const resourceTransformPlan = buildResourceTransformPlan(\r\n        irEntries.map((entry) => ({\r\n            ir: entry.ir,\r\n            semanticBindings: entry.semanticBindings\r\n        })),\r\n        { layoutKey: pass.passKey }\r\n    );\r\n    const proof = irEntries.find((entry) => entry.effectProfileProof)\r\n        ?.effectProfileProof ?? null;\r\n    const plan = buildWgslBindingPlan(\r\n        irEntries.map((entry) => entry.ir),\r\n        {\r\n            ...(bindingPolicy ?? {}),\r\n            ...(proof ? { effectProfileProof: proof } : {}),\r\n            ...(resourceTransformPlan ? { resourceTransformPlan } : {})\r\n        }\r\n    );\r\n\r\n    return buildWgslSet(irEntries.map((entry) => ({\r\n        key: entry.key,\r\n        shader: buildWgsl(entry.ir, {\r\n            bindingPlan: plan,\r\n            ...(resourceTransformPlan ? { resourceTransformPlan } : {}),\r\n            ...(entry.effectProfileProof\r\n                ? { effectProfileProof: entry.effectProfileProof }\r\n                : {})\r\n        })\r\n    })));\r\n}\r\n\r\n/**\r\n * Translate every unique source body into backend programs, layouts, and\r\n * resource transforms, sharing one translation unit between bodies whose pass\r\n * is byte-for-byte identical.\r\n *\r\n * A body that cannot be lowered is retained as an explicitly unsupported\r\n * in-memory record carrying its reason. Portable source reflection is built\r\n * separately from the same effect; this body-set document does not store it.\r\n *\r\n * @param {object} effectRes Loaded version-15 `Tr2EffectRes`.\r\n * @param {object} permutationGraph Validated `PGRF` document.\r\n * @param {object} [options] Source label, stage selection, and binding policy.\r\n * @returns {object} Frozen `CJS_WGSL_BODY_SET` document.\r\n */\r\nexport function buildEffectBackendBodySet(effectRes, permutationGraph, options = {})\r\n{\r\n    const source = options.source || \"memory\";\r\n    const selection = options.selection ?? null;\r\n    const bindingPolicy = options.bindingPolicy ?? null;\r\n    const groups = enumerateUniqueEffectBodies(effectRes);\r\n\r\n    if (groups.length !== permutationGraph.bodies.length)\r\n    {\r\n        throw new Error(\r\n            \"Effect backend body set requires one unique body per permutation-graph body\"\r\n        );\r\n    }\r\n\r\n    const unitsBySignature = new Map();\r\n    const graphBodiesByKey = new Map(permutationGraph.bodies.map((body) => [ body.key, body ]));\r\n    const passUnits = [];\r\n    const bodies = [];\r\n    const seenBodyKeys = new Set();\r\n\r\n    for (const group of groups)\r\n    {\r\n        const variant = permutationGraph.variants[group.permutationIndex];\r\n        const graphBody = variant ? graphBodiesByKey.get(variant.bodyKey) : null;\r\n\r\n        if (!graphBody)\r\n        {\r\n            throw new Error(\r\n                `Effect backend body ${group.permutationIndex} does not reconcile with its permutation graph record`\r\n            );\r\n        }\r\n\r\n        if (seenBodyKeys.has(graphBody.key))\r\n        {\r\n            throw new Error(\r\n                `Effect backend body ${graphBody.key} was enumerated more than once`\r\n            );\r\n        }\r\n\r\n        seenBodyKeys.add(graphBody.key);\r\n\r\n        let resolvedBody = null;\r\n        let passes = null;\r\n        let programForKey = null;\r\n\r\n        try\r\n        {\r\n            resolvedBody = resolveBody(effectRes, group.permutationIndex, source);\r\n\r\n            // One IR cache per body, so a stage shared by two passes lowers once\r\n            // and the effect-profile preflight can seed it exactly as the\r\n            // selected-body path does.\r\n            const programsByKey = new Map();\r\n            programForKey = (key) =>\r\n            {\r\n                if (programsByKey.has(key)) return programsByKey.get(key);\r\n\r\n                const bytecode = resolvedBody.resolved.stageBytecodeByKey.get(key)?.bytes;\r\n\r\n                if (!bytecode?.length)\r\n                {\r\n                    throw new Error(`${key} has no shader bytecode`);\r\n                }\r\n\r\n                const program = lowerDxbcToIr(bytecode, { source: `${source}#${key}` });\r\n                programsByKey.set(key, program);\r\n                return program;\r\n            };\r\n\r\n            let effectProfileContext = null;\r\n\r\n            if (isParticleClearEffectCandidate(resolvedBody.resolved.effectDescription))\r\n            {\r\n                programForKey(\"Main.pass0.compute\");\r\n                programForKey(\"Main.pass1.compute\");\r\n                effectProfileContext = preflightParticleClearEffectProfile(\r\n                    resolvedBody.resolved.effectDescription,\r\n                    programsByKey\r\n                );\r\n            }\r\n\r\n            passes = buildPassEntries(\r\n                resolvedBody.analysis,\r\n                resolvedBody.resolved,\r\n                selection,\r\n                effectProfileContext\r\n            );\r\n        }\r\n        catch (error)\r\n        {\r\n            // Stage selection and profile preflight fail closed per body: an\r\n            // unsupported stage kind in one body must not fail the package.\r\n            bodies.push(Object.freeze({\r\n                bodyKey: graphBody.key,\r\n                representativePermutationIndex: group.permutationIndex,\r\n                status: \"unsupported\",\r\n                error: String(error?.message ?? error),\r\n                passCount: 0,\r\n                passes: Object.freeze([])\r\n            }));\r\n            continue;\r\n        }\r\n\r\n        const bodyPasses = [];\r\n        let failure = null;\r\n\r\n        for (const pass of passes)\r\n        {\r\n            const signature = passUnitSignature(pass);\r\n            let unit = unitsBySignature.get(signature);\r\n\r\n            if (!unit)\r\n            {\r\n                let wgsl = null;\r\n\r\n                try\r\n                {\r\n                    wgsl = translatePassUnit(\r\n                        pass,\r\n                        programForKey,\r\n                        source,\r\n                        bindingPolicy\r\n                    );\r\n                }\r\n                catch (error)\r\n                {\r\n                    failure = String(error?.message ?? error);\r\n                    break;\r\n                }\r\n\r\n                unit = {\r\n                    key: `unit${passUnits.length}`,\r\n                    sha256: sha256Utf8(`${JSON.stringify(wgsl)}\\n`),\r\n                    wgslSetVersion: wgsl.formatVersion,\r\n                    shaders: wgsl.shaders,\r\n                    layouts: wgsl.layouts,\r\n                    ...(wgsl.resourceTransforms\r\n                        ? { resourceTransforms: wgsl.resourceTransforms }\r\n                        : {})\r\n                };\r\n                unitsBySignature.set(signature, unit);\r\n                passUnits.push(unit);\r\n            }\r\n\r\n            bodyPasses.push(Object.freeze({ passKey: pass.passKey, unitKey: unit.key }));\r\n        }\r\n\r\n        bodies.push(Object.freeze(failure\r\n            ? {\r\n                bodyKey: graphBody.key,\r\n                representativePermutationIndex: group.permutationIndex,\r\n                status: \"unsupported\",\r\n                error: failure,\r\n                passCount: 0,\r\n                passes: Object.freeze([])\r\n            }\r\n            : {\r\n                bodyKey: graphBody.key,\r\n                representativePermutationIndex: group.permutationIndex,\r\n                status: \"translated\",\r\n                error: null,\r\n                passCount: bodyPasses.length,\r\n                passes: Object.freeze(bodyPasses)\r\n            }));\r\n    }\r\n\r\n    const translatedCount = bodies.filter((body) => body.status === \"translated\").length;\r\n\r\n    if (!translatedCount)\r\n    {\r\n        throw new Error(\r\n            \"Effect backend body set requires at least one translated body\"\r\n        );\r\n    }\r\n\r\n    return Object.freeze({\r\n        format: EFFECT_BACKEND_BODY_SET_FORMAT,\r\n        formatVersion: EFFECT_BACKEND_BODY_SET_VERSION,\r\n        coverage: Object.freeze({\r\n            bodies: translatedCount === bodies.length ? \"all-unique\" : \"partial\",\r\n            programs: \"complete-for-translated\"\r\n        }),\r\n        bodyCount: bodies.length,\r\n        translatedBodyCount: translatedCount,\r\n        passUnitCount: passUnits.length,\r\n        passUnits: Object.freeze(passUnits.map((unit) => Object.freeze(unit))),\r\n        bodies: Object.freeze(bodies)\r\n    });\r\n}\r\n"],"names":["EFFECT_BACKEND_BODY_SET_FORMAT","EFFECT_BACKEND_BODY_SET_VERSION","passUnitSignature","pass","JSON","stringify","passKey","stages","map","stage","stageName","bytecode","bytecodeDigest","semanticBindings","effectProfileProof","sha256Utf8","sort","left","right","compareUtf8","collectBodyStageBytecode","effectDescription","bytecodeByKey","Map","technique","techniques","passIndex","passes","length","stageInputs","stageType","m_exists","cjsShaderBytecode","value","bytes","undefined","key","name","normalizeBytecodeBytes","TypeError","set","techniqueName","resolveBody","effectRes","permutationIndex","source","shader","GetShaderByIndex","Error","GetEffectDescription","resolved","selection","bodyIndex","selectedOptions","bindingManifest","HlslEffectBindingManifest","fromEffectDescription","stageBytecodeByKey","analysis","buildEffectAnalysis","decodeBytecode","decodeInstructions","buildPassEntries","effectProfileContext","selectedStages","selectEffectStages","has","get","push","bytecodeKey","sha256Bytes","find","candidate","bindings","particleClearEffectProofFor","Array","from","values","translatePassUnit","programForKey","bindingPolicy","irEntries","ir","resourceTransformPlan","buildResourceTransformPlan","entry","layoutKey","proof","plan","buildWgslBindingPlan","buildWgslSet","buildWgsl","bindingPlan","buildEffectBackendBodySet","permutationGraph","options","groups","enumerateUniqueEffectBodies","bodies","unitsBySignature","graphBodiesByKey","body","passUnits","seenBodyKeys","Set","group","variant","variants","graphBody","bodyKey","add","resolvedBody","programsByKey","program","lowerDxbcToIr","isParticleClearEffectCandidate","preflightParticleClearEffectProfile","error","Object","freeze","representativePermutationIndex","status","String","message","passCount","bodyPasses","failure","signature","unit","wgsl","sha256","wgslSetVersion","formatVersion","shaders","layouts","resourceTransforms","unitKey","translatedCount","filter","format","coverage","programs","bodyCount","translatedBodyCount","passUnitCount"],"mappings":";;;;;;;;;;;;;;AAkBO,MAAMA,8BAA8B,GAAG;AACvC,MAAMC,+BAA+B,GAAG;;AAE/C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,iBAAiBA,CAACC,IAAI,EAC/B;EACI,OAAOC,IAAI,CAACC,SAAS,CAAC;IAClBC,OAAO,EAAEH,IAAI,CAACG,OAAO;IACrBC,MAAM,EAAEJ,IAAI,CAACI,MAAM,CACdC,GAAG,CAAEC,KAAK,KAAM;MACbC,SAAS,EAAED,KAAK,CAACC,SAAS;MAC1BC,QAAQ,EAAEF,KAAK,CAACG,cAAc;MAC9BC,gBAAgB,EAAEJ,KAAK,CAACI,gBAAgB;AACxC;AACA;AACAC,MAAAA,kBAAkB,EAAEL,KAAK,CAACK,kBAAkB,GACtCC,UAAU,CAACX,IAAI,CAACC,SAAS,CAACI,KAAK,CAACK,kBAAkB,CAAC,CAAC,GACpD;AACV,KAAC,CAAC,CAAC,CACFE,IAAI,CAAC,CAACC,IAAI,EAAEC,KAAK,KAAKC,WAAW,CAACF,IAAI,CAACP,SAAS,EAAEQ,KAAK,CAACR,SAAS,CAAC;AAC3E,GAAC,CAAC;AACN;AAEA,SAASU,wBAAwBA,CAACC,iBAAiB,EACnD;AACI,EAAA,MAAMC,aAAa,GAAG,IAAIC,GAAG,EAAE;EAE/B,KAAK,MAAMC,SAAS,IAAIH,iBAAiB,EAAEI,UAAU,IAAI,EAAE,EAC3D;AACI,IAAA,KAAK,IAAIC,SAAS,GAAG,CAAC,EAAEA,SAAS,GAAGF,SAAS,CAACG,MAAM,CAACC,MAAM,EAAEF,SAAS,EAAE,EACxE;MACI,MAAMG,WAAW,GAAGL,SAAS,CAACG,MAAM,CAACD,SAAS,CAAC,CAACG,WAAW;AAE3D,MAAA,KAAK,IAAIC,SAAS,GAAG,CAAC,EAAEA,SAAS,GAAGD,WAAW,CAACD,MAAM,EAAEE,SAAS,EAAE,EACnE;AACI,QAAA,MAAMrB,KAAK,GAAGoB,WAAW,CAACC,SAAS,CAAC;AACpC,QAAA,IAAI,CAACrB,KAAK,EAAEsB,QAAQ,EAAE;AAEtB,QAAA,MAAMrB,SAAS,GAAGD,KAAK,CAACuB,iBAAiB,EAAEtB,SAAS;AACpD,QAAA,MAAMuB,KAAK,GAAGxB,KAAK,CAACuB,iBAAiB,EAAEE,KAAK;QAC5C,IAAI,CAACxB,SAAS,IAAIuB,KAAK,KAAKE,SAAS,IAAIF,KAAK,KAAK,IAAI,EAAE;QAEzD,MAAMG,GAAG,GAAG,CAAA,EAAGZ,SAAS,CAACa,IAAI,CAAA,KAAA,EAAQX,SAAS,CAAA,CAAA,EAAIhB,SAAS,CAAA,CAAE;QAC7D,MAAMwB,KAAK,GAAGI,sBAAsB,CAACL,KAAK,EAAE,CAAA,EAAGG,GAAG,CAAA,eAAA,CAAiB,CAAC;AAEpE,QAAA,IAAI,CAACF,KAAK,EAAEN,MAAM,EAClB;AACI,UAAA,MAAM,IAAIW,SAAS,CAAC,CAAA,EAAGH,GAAG,+CAA+C,CAAC;AAC9E,QAAA;AAEAd,QAAAA,aAAa,CAACkB,GAAG,CAACJ,GAAG,EAAE;UACnBK,aAAa,EAAEjB,SAAS,CAACa,IAAI;UAC7BX,SAAS;UACTI,SAAS;UACTpB,SAAS;AACTwB,UAAAA;AACJ,SAAC,CAAC;AACN,MAAA;AACJ,IAAA;AACJ,EAAA;AAEA,EAAA,OAAOZ,aAAa;AACxB;AAEA,SAASoB,WAAWA,CAACC,SAAS,EAAEC,gBAAgB,EAAEC,MAAM,EACxD;AACI,EAAA,MAAMC,MAAM,GAAGH,SAAS,CAACI,gBAAgB,CAACH,gBAAgB,CAAC;EAE3D,IAAI,CAACE,MAAM,EACX;AACI,IAAA,MAAM,IAAIE,KAAK,CACX,CAAA,2BAAA,EAA8BJ,gBAAgB,uBAClD,CAAC;AACL,EAAA;AAEA,EAAA,MAAMvB,iBAAiB,GAAGyB,MAAM,CAACG,oBAAoB,EAAE;EAEvD,IAAI,CAAC5B,iBAAiB,EACtB;AACI,IAAA,MAAM,IAAI2B,KAAK,CACX,CAAA,2BAAA,EAA8BJ,gBAAgB,4BAClD,CAAC;AACL,EAAA;AAEA,EAAA,MAAMM,QAAQ,GAAG;IACbP,SAAS;IACTG,MAAM;AACNK,IAAAA,SAAS,EAAE;AAAEC,MAAAA,SAAS,EAAER,gBAAgB;AAAES,MAAAA,eAAe,EAAE;KAAI;IAC/DhC,iBAAiB;AACjBiC,IAAAA,eAAe,EAAEC,yBAAyB,CAACC,qBAAqB,CAACnC,iBAAiB,CAAC;IACnFoC,kBAAkB,EAAErC,wBAAwB,CAACC,iBAAiB;GACjE;EAED,OAAO;IACH6B,QAAQ;AACRQ,IAAAA,QAAQ,EAAEC,mBAAmB,CAACT,QAAQ,EAAE;MACpCL,MAAM;AACNe,MAAAA,cAAc,EAAE,KAAK;AACrBC,MAAAA,kBAAkB,EAAE;KACvB;GACJ;AACL;AAEA,SAASC,gBAAgBA,CAACJ,QAAQ,EAAER,QAAQ,EAAEC,SAAS,EAAEY,oBAAoB,EAC7E;EACI,MAAMC,cAAc,GAAGC,kBAAkB,CAACP,QAAQ,CAACnD,MAAM,EAAE4C,SAAS,CAAC;AACrE,EAAA,MAAMxB,MAAM,GAAG,IAAIJ,GAAG,EAAE;AAExB,EAAA,KAAK,MAAMd,KAAK,IAAIuD,cAAc,EAClC;IACI,MAAM1D,OAAO,GAAG,CAAA,EAAGG,KAAK,CAACgC,aAAa,CAAA,KAAA,EAAQhC,KAAK,CAACiB,SAAS,CAAA,CAAE;AAE/D,IAAA,IAAI,CAACC,MAAM,CAACuC,GAAG,CAAC5D,OAAO,CAAC,EACxB;AACIqB,MAAAA,MAAM,CAACa,GAAG,CAAClC,OAAO,EAAE;QAAEA,OAAO;AAAEC,QAAAA,MAAM,EAAE;AAAG,OAAC,CAAC;AAChD,IAAA;AAEA,IAAA,MAAMI,QAAQ,GAAGuC,QAAQ,CAACO,kBAAkB,CAACU,GAAG,CAAC1D,KAAK,CAAC2B,GAAG,CAAC,EAAEF,KAAK;AAElE,IAAA,IAAI,CAACvB,QAAQ,EAAEiB,MAAM,EACrB;MACI,MAAM,IAAIoB,KAAK,CAAC,CAAA,EAAGvC,KAAK,CAAC2B,GAAG,yBAAyB,CAAC;AAC1D,IAAA;IAEAT,MAAM,CAACwC,GAAG,CAAC7D,OAAO,CAAC,CAACC,MAAM,CAAC6D,IAAI,CAAC;MAC5BhC,GAAG,EAAE3B,KAAK,CAAC2B,GAAG;MACd1B,SAAS,EAAED,KAAK,CAACC,SAAS;MAC1B2D,WAAW,EAAE5D,KAAK,CAAC2B,GAAG;AACtBxB,MAAAA,cAAc,EAAE0D,WAAW,CAAC3D,QAAQ,CAAC;AACrCE,MAAAA,gBAAgB,EAAE6C,QAAQ,CAACnD,MAAM,CAACgE,IAAI,CAAEC,SAAS,IAC7CA,SAAS,CAAC/B,aAAa,KAAKhC,KAAK,CAACgC,aAAa,IAC5C+B,SAAS,CAAC9C,SAAS,KAAKjB,KAAK,CAACiB,SAAS,IACvC8C,SAAS,CAAC9D,SAAS,KAAKD,KAAK,CAACC,SAAS,CAAC,EAAE+D,QAAQ,IAAI,EAAE;AAC/D3D,MAAAA,kBAAkB,EAAE4D,2BAA2B,CAC3CX,oBAAoB,EACpBtD,KAAK,CAAC2B,GACV;AACJ,KAAC,CAAC;AACN,EAAA;EAEA,OAAOuC,KAAK,CAACC,IAAI,CAACjD,MAAM,CAACkD,MAAM,EAAE,CAAC;AACtC;AAEA,SAASC,iBAAiBA,CAAC3E,IAAI,EAAE4E,aAAa,EAAElC,MAAM,EAAEmC,aAAa,EACrE;EACI,MAAMC,SAAS,GAAG9E,IAAI,CAACI,MAAM,CAACC,GAAG,CAAEC,KAAK,KAAM;IAC1C2B,GAAG,EAAE3B,KAAK,CAAC2B,GAAG;AACd8C,IAAAA,EAAE,EAAEH,aAAa,CAACtE,KAAK,CAAC4D,WAAW,CAAC;IACpCxD,gBAAgB,EAAEJ,KAAK,CAACI,gBAAgB;IACxCC,kBAAkB,EAAEL,KAAK,CAACK;AAC9B,GAAC,CAAC,CAAC;EACH,MAAMqE,qBAAqB,GAAGC,0BAA0B,CACpDH,SAAS,CAACzE,GAAG,CAAE6E,KAAK,KAAM;IACtBH,EAAE,EAAEG,KAAK,CAACH,EAAE;IACZrE,gBAAgB,EAAEwE,KAAK,CAACxE;GAC3B,CAAC,CAAC,EACH;IAAEyE,SAAS,EAAEnF,IAAI,CAACG;AAAQ,GAC9B,CAAC;AACD,EAAA,MAAMiF,KAAK,GAAGN,SAAS,CAACV,IAAI,CAAEc,KAAK,IAAKA,KAAK,CAACvE,kBAAkB,CAAC,EAC3DA,kBAAkB,IAAI,IAAI;AAChC,EAAA,MAAM0E,IAAI,GAAGC,oBAAoB,CAC7BR,SAAS,CAACzE,GAAG,CAAE6E,KAAK,IAAKA,KAAK,CAACH,EAAE,CAAC,EAClC;AACI,IAAA,IAAIF,aAAa,IAAI,EAAE,CAAC;AACxB,IAAA,IAAIO,KAAK,GAAG;AAAEzE,MAAAA,kBAAkB,EAAEyE;KAAO,GAAG,EAAE,CAAC;AAC/C,IAAA,IAAIJ,qBAAqB,GAAG;AAAEA,MAAAA;KAAuB,GAAG,EAAE;AAC9D,GACJ,CAAC;AAED,EAAA,OAAOO,YAAY,CAACT,SAAS,CAACzE,GAAG,CAAE6E,KAAK,KAAM;IAC1CjD,GAAG,EAAEiD,KAAK,CAACjD,GAAG;AACdU,IAAAA,MAAM,EAAE6C,SAAS,CAACN,KAAK,CAACH,EAAE,EAAE;AACxBU,MAAAA,WAAW,EAAEJ,IAAI;AACjB,MAAA,IAAIL,qBAAqB,GAAG;AAAEA,QAAAA;OAAuB,GAAG,EAAE,CAAC;MAC3D,IAAIE,KAAK,CAACvE,kBAAkB,GACtB;QAAEA,kBAAkB,EAAEuE,KAAK,CAACvE;OAAoB,GAChD,EAAE;KACX;GACJ,CAAC,CAAC,CAAC;AACR;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS+E,yBAAyBA,CAAClD,SAAS,EAAEmD,gBAAgB,EAAEC,OAAO,GAAG,EAAE,EACnF;AACI,EAAA,MAAMlD,MAAM,GAAGkD,OAAO,CAAClD,MAAM,IAAI,QAAQ;AACzC,EAAA,MAAMM,SAAS,GAAG4C,OAAO,CAAC5C,SAAS,IAAI,IAAI;AAC3C,EAAA,MAAM6B,aAAa,GAAGe,OAAO,CAACf,aAAa,IAAI,IAAI;AACnD,EAAA,MAAMgB,MAAM,GAAGC,2BAA2B,CAACtD,SAAS,CAAC;EAErD,IAAIqD,MAAM,CAACpE,MAAM,KAAKkE,gBAAgB,CAACI,MAAM,CAACtE,MAAM,EACpD;AACI,IAAA,MAAM,IAAIoB,KAAK,CACX,6EACJ,CAAC;AACL,EAAA;AAEA,EAAA,MAAMmD,gBAAgB,GAAG,IAAI5E,GAAG,EAAE;EAClC,MAAM6E,gBAAgB,GAAG,IAAI7E,GAAG,CAACuE,gBAAgB,CAACI,MAAM,CAAC1F,GAAG,CAAE6F,IAAI,IAAK,CAAEA,IAAI,CAACjE,GAAG,EAAEiE,IAAI,CAAE,CAAC,CAAC;EAC3F,MAAMC,SAAS,GAAG,EAAE;EACpB,MAAMJ,MAAM,GAAG,EAAE;AACjB,EAAA,MAAMK,YAAY,GAAG,IAAIC,GAAG,EAAE;AAE9B,EAAA,KAAK,MAAMC,KAAK,IAAIT,MAAM,EAC1B;IACI,MAAMU,OAAO,GAAGZ,gBAAgB,CAACa,QAAQ,CAACF,KAAK,CAAC7D,gBAAgB,CAAC;AACjE,IAAA,MAAMgE,SAAS,GAAGF,OAAO,GAAGN,gBAAgB,CAACjC,GAAG,CAACuC,OAAO,CAACG,OAAO,CAAC,GAAG,IAAI;IAExE,IAAI,CAACD,SAAS,EACd;MACI,MAAM,IAAI5D,KAAK,CACX,CAAA,oBAAA,EAAuByD,KAAK,CAAC7D,gBAAgB,uDACjD,CAAC;AACL,IAAA;IAEA,IAAI2D,YAAY,CAACrC,GAAG,CAAC0C,SAAS,CAACxE,GAAG,CAAC,EACnC;MACI,MAAM,IAAIY,KAAK,CACX,CAAA,oBAAA,EAAuB4D,SAAS,CAACxE,GAAG,gCACxC,CAAC;AACL,IAAA;AAEAmE,IAAAA,YAAY,CAACO,GAAG,CAACF,SAAS,CAACxE,GAAG,CAAC;IAE/B,IAAI2E,YAAY,GAAG,IAAI;IACvB,IAAIpF,MAAM,GAAG,IAAI;IACjB,IAAIoD,aAAa,GAAG,IAAI;IAExB,IACA;MACIgC,YAAY,GAAGrE,WAAW,CAACC,SAAS,EAAE8D,KAAK,CAAC7D,gBAAgB,EAAEC,MAAM,CAAC;;AAErE;AACA;AACA;AACA,MAAA,MAAMmE,aAAa,GAAG,IAAIzF,GAAG,EAAE;MAC/BwD,aAAa,GAAI3C,GAAG,IACpB;AACI,QAAA,IAAI4E,aAAa,CAAC9C,GAAG,CAAC9B,GAAG,CAAC,EAAE,OAAO4E,aAAa,CAAC7C,GAAG,CAAC/B,GAAG,CAAC;AAEzD,QAAA,MAAMzB,QAAQ,GAAGoG,YAAY,CAAC7D,QAAQ,CAACO,kBAAkB,CAACU,GAAG,CAAC/B,GAAG,CAAC,EAAEF,KAAK;AAEzE,QAAA,IAAI,CAACvB,QAAQ,EAAEiB,MAAM,EACrB;AACI,UAAA,MAAM,IAAIoB,KAAK,CAAC,CAAA,EAAGZ,GAAG,yBAAyB,CAAC;AACpD,QAAA;AAEA,QAAA,MAAM6E,OAAO,GAAGC,aAAa,CAACvG,QAAQ,EAAE;AAAEkC,UAAAA,MAAM,EAAE,CAAA,EAAGA,MAAM,CAAA,CAAA,EAAIT,GAAG,CAAA;AAAG,SAAC,CAAC;AACvE4E,QAAAA,aAAa,CAACxE,GAAG,CAACJ,GAAG,EAAE6E,OAAO,CAAC;AAC/B,QAAA,OAAOA,OAAO;MAClB,CAAC;MAED,IAAIlD,oBAAoB,GAAG,IAAI;MAE/B,IAAIoD,8BAA8B,CAACJ,YAAY,CAAC7D,QAAQ,CAAC7B,iBAAiB,CAAC,EAC3E;QACI0D,aAAa,CAAC,oBAAoB,CAAC;QACnCA,aAAa,CAAC,oBAAoB,CAAC;QACnChB,oBAAoB,GAAGqD,mCAAmC,CACtDL,YAAY,CAAC7D,QAAQ,CAAC7B,iBAAiB,EACvC2F,aACJ,CAAC;AACL,MAAA;AAEArF,MAAAA,MAAM,GAAGmC,gBAAgB,CACrBiD,YAAY,CAACrD,QAAQ,EACrBqD,YAAY,CAAC7D,QAAQ,EACrBC,SAAS,EACTY,oBACJ,CAAC;IACL,CAAC,CACD,OAAOsD,KAAK,EACZ;AACI;AACA;AACAnB,MAAAA,MAAM,CAAC9B,IAAI,CAACkD,MAAM,CAACC,MAAM,CAAC;QACtBV,OAAO,EAAED,SAAS,CAACxE,GAAG;QACtBoF,8BAA8B,EAAEf,KAAK,CAAC7D,gBAAgB;AACtD6E,QAAAA,MAAM,EAAE,aAAa;QACrBJ,KAAK,EAAEK,MAAM,CAACL,KAAK,EAAEM,OAAO,IAAIN,KAAK,CAAC;AACtCO,QAAAA,SAAS,EAAE,CAAC;AACZjG,QAAAA,MAAM,EAAE2F,MAAM,CAACC,MAAM,CAAC,EAAE;AAC5B,OAAC,CAAC,CAAC;AACH,MAAA;AACJ,IAAA;IAEA,MAAMM,UAAU,GAAG,EAAE;IACrB,IAAIC,OAAO,GAAG,IAAI;AAElB,IAAA,KAAK,MAAM3H,IAAI,IAAIwB,MAAM,EACzB;AACI,MAAA,MAAMoG,SAAS,GAAG7H,iBAAiB,CAACC,IAAI,CAAC;AACzC,MAAA,IAAI6H,IAAI,GAAG7B,gBAAgB,CAAChC,GAAG,CAAC4D,SAAS,CAAC;MAE1C,IAAI,CAACC,IAAI,EACT;QACI,IAAIC,IAAI,GAAG,IAAI;QAEf,IACA;UACIA,IAAI,GAAGnD,iBAAiB,CACpB3E,IAAI,EACJ4E,aAAa,EACblC,MAAM,EACNmC,aACJ,CAAC;QACL,CAAC,CACD,OAAOqC,KAAK,EACZ;UACIS,OAAO,GAAGJ,MAAM,CAACL,KAAK,EAAEM,OAAO,IAAIN,KAAK,CAAC;AACzC,UAAA;AACJ,QAAA;AAEAW,QAAAA,IAAI,GAAG;AACH5F,UAAAA,GAAG,EAAE,CAAA,IAAA,EAAOkE,SAAS,CAAC1E,MAAM,CAAA,CAAE;UAC9BsG,MAAM,EAAEnH,UAAU,CAAC,CAAA,EAAGX,IAAI,CAACC,SAAS,CAAC4H,IAAI,CAAC,CAAA,EAAA,CAAI,CAAC;UAC/CE,cAAc,EAAEF,IAAI,CAACG,aAAa;UAClCC,OAAO,EAAEJ,IAAI,CAACI,OAAO;UACrBC,OAAO,EAAEL,IAAI,CAACK,OAAO;UACrB,IAAIL,IAAI,CAACM,kBAAkB,GACrB;YAAEA,kBAAkB,EAAEN,IAAI,CAACM;WAAoB,GAC/C,EAAE;SACX;AACDpC,QAAAA,gBAAgB,CAAC3D,GAAG,CAACuF,SAAS,EAAEC,IAAI,CAAC;AACrC1B,QAAAA,SAAS,CAAClC,IAAI,CAAC4D,IAAI,CAAC;AACxB,MAAA;AAEAH,MAAAA,UAAU,CAACzD,IAAI,CAACkD,MAAM,CAACC,MAAM,CAAC;QAAEjH,OAAO,EAAEH,IAAI,CAACG,OAAO;QAAEkI,OAAO,EAAER,IAAI,CAAC5F;AAAI,OAAC,CAAC,CAAC;AAChF,IAAA;IAEA8D,MAAM,CAAC9B,IAAI,CAACkD,MAAM,CAACC,MAAM,CAACO,OAAO,GAC3B;MACEjB,OAAO,EAAED,SAAS,CAACxE,GAAG;MACtBoF,8BAA8B,EAAEf,KAAK,CAAC7D,gBAAgB;AACtD6E,MAAAA,MAAM,EAAE,aAAa;AACrBJ,MAAAA,KAAK,EAAES,OAAO;AACdF,MAAAA,SAAS,EAAE,CAAC;AACZjG,MAAAA,MAAM,EAAE2F,MAAM,CAACC,MAAM,CAAC,EAAE;AAC5B,KAAC,GACC;MACEV,OAAO,EAAED,SAAS,CAACxE,GAAG;MACtBoF,8BAA8B,EAAEf,KAAK,CAAC7D,gBAAgB;AACtD6E,MAAAA,MAAM,EAAE,YAAY;AACpBJ,MAAAA,KAAK,EAAE,IAAI;MACXO,SAAS,EAAEC,UAAU,CAACjG,MAAM;AAC5BD,MAAAA,MAAM,EAAE2F,MAAM,CAACC,MAAM,CAACM,UAAU;AACpC,KAAC,CAAC,CAAC;AACX,EAAA;AAEA,EAAA,MAAMY,eAAe,GAAGvC,MAAM,CAACwC,MAAM,CAAErC,IAAI,IAAKA,IAAI,CAACoB,MAAM,KAAK,YAAY,CAAC,CAAC7F,MAAM;EAEpF,IAAI,CAAC6G,eAAe,EACpB;AACI,IAAA,MAAM,IAAIzF,KAAK,CACX,+DACJ,CAAC;AACL,EAAA;EAEA,OAAOsE,MAAM,CAACC,MAAM,CAAC;AACjBoB,IAAAA,MAAM,EAAE3I,8BAA8B;AACtCoI,IAAAA,aAAa,EAAEnI,+BAA+B;AAC9C2I,IAAAA,QAAQ,EAAEtB,MAAM,CAACC,MAAM,CAAC;MACpBrB,MAAM,EAAEuC,eAAe,KAAKvC,MAAM,CAACtE,MAAM,GAAG,YAAY,GAAG,SAAS;AACpEiH,MAAAA,QAAQ,EAAE;AACd,KAAC,CAAC;IACFC,SAAS,EAAE5C,MAAM,CAACtE,MAAM;AACxBmH,IAAAA,mBAAmB,EAAEN,eAAe;IACpCO,aAAa,EAAE1C,SAAS,CAAC1E,MAAM;AAC/B0E,IAAAA,SAAS,EAAEgB,MAAM,CAACC,MAAM,CAACjB,SAAS,CAAC9F,GAAG,CAAEwH,IAAI,IAAKV,MAAM,CAACC,MAAM,CAACS,IAAI,CAAC,CAAC,CAAC;AACtE9B,IAAAA,MAAM,EAAEoB,MAAM,CAACC,MAAM,CAACrB,MAAM;AAChC,GAAC,CAAC;AACN;;;;"}

package/dist/formats/webgpu/core/helpers.js

@@ -8,7 +8,6 @@ import { lowerDxbcToIr } from './ir/lowerDxbcToIr.js';
 import { normalizeEffectPermutation, validateResolvedPermutation } from './packageEffectSelection.js';
 
 const OUTPUT_JSON = "json";
-const OUTPUT_RAW = "raw";
 const CARBON_WEBGPU_FORMAT = "CARBON_WEBGPU";
 const CARBON_WEBGPU_ANALYSIS_FORMAT = "CARBON_WEBGPU_ANALYSIS";
 const CARBON_WEBGPU_ANALYSIS_VERSION = 1;
@@ -21,13 +20,27 @@ const DEFAULT_VALUES = Object.freeze({
   classes: Object.freeze({})
 });
 const OPTION_KEYS = new Set(["emit", "source", "decodeInstructions", "permutation", "schema", "classes"]);
+// One emit, as WebGL has. `Read` returns the container-backed document and that
+// document is complete: the analysis, WGSL, metadata and permutation views the
+// caller selects among, plus `backendBodySet`, which is every translated body
+// joined to its shared translation units.
+//
+// A second `raw` emit used to hand back the live `CarbonWebgpuContainer` because
+// the chunk package's JSON could not express the body set. It became the only way
+// to reach a body, so `engine-webgpu` duck-typed the container instead of reading
+// the document - and when the chunk package was replaced, the engine kept asking
+// for a shape the producer had stopped emitting. Both halves then failed, in
+// different directions, for weeks: the default emit built pipelines but resolved
+// no bodies, and the raw emit resolved bodies but built no pipelines.
+//
+// Neither is reachable now. The container stays internal to this module.
+const VALID_EMITS = new Set([OUTPUT_JSON]);
 function hasOwn(value, key) {
   return Object.prototype.hasOwnProperty.call(value, key);
 }
 function normalizeEmit(emit, readerName) {
-  if (emit === undefined || emit === OUTPUT_JSON) return OUTPUT_JSON;
-  if (emit === OUTPUT_RAW) return OUTPUT_RAW;
-  throw new TypeError(`${readerName}: emit must be "${OUTPUT_JSON}" or "${OUTPUT_RAW}", got ${JSON.stringify(emit)}`);
+  if (emit === undefined || VALID_EMITS.has(emit)) return OUTPUT_JSON;
+  throw new TypeError(`${readerName}: emit must be "${OUTPUT_JSON}", got ${JSON.stringify(emit)}`);
 }
 function assertKnownOptions(options, readerName) {
   for (const key of Object.keys(options)) {
@@ -52,12 +65,12 @@ function cloneValues(values) {
   };
 }
 
-/**
- * Rejects class override keys outside a format reader's supported class set.
- *
- * @param {string[]} classKeys Supported class override keys.
- * @param {string} key Candidate override key.
- * @param {string} readerName Reader name used in diagnostics.
+/**
+ * Rejects class override keys outside a format reader's supported class set.
+ *
+ * @param {string[]} classKeys Supported class override keys.
+ * @param {string} key Candidate override key.
+ * @param {string} readerName Reader name used in diagnostics.
  */
 function validateClassKey(classKeys, key, readerName) {
   if (!classKeys.includes(key)) {
@@ -65,13 +78,13 @@ function validateClassKey(classKeys, key, readerName) {
   }
 }
 
-/**
- * Validates one constructor supplied through a format reader class override.
- *
- * @param {string[]} classKeys Supported class override keys.
- * @param {string} type Candidate override key.
- * @param {Function} Class Candidate constructor.
- * @param {string} readerName Reader name used in diagnostics.
+/**
+ * Validates one constructor supplied through a format reader class override.
+ *
+ * @param {string[]} classKeys Supported class override keys.
+ * @param {string} type Candidate override key.
+ * @param {Function} Class Candidate constructor.
+ * @param {string} readerName Reader name used in diagnostics.
  */
 function validateClass(classKeys, type, Class, readerName) {
   validateClassKey(classKeys, type, readerName);
@@ -93,14 +106,14 @@ function mergeClasses(values, classes, classKeys, readerName) {
   values.classes = next;
 }
 
-/**
- * Merge format values over a base set and validate them.
- *
- * @param {object} base Current values.
- * @param {object} [options] Values to merge in.
- * @param {string[]} classKeys Valid class keys.
- * @param {string} readerName Reader name used in error messages.
- * @returns {object} A validated copy of the merged values.
+/**
+ * Merge format values over a base set and validate them.
+ *
+ * @param {object} base Current values.
+ * @param {object} [options] Values to merge in.
+ * @param {string[]} classKeys Valid class keys.
+ * @param {string} readerName Reader name used in error messages.
+ * @returns {object} A validated copy of the merged values.
  */
 function normalizeValues(base, options = {}, classKeys = [], readerName = "CjsWebgpuFormat") {
   if (!options || typeof options !== "object") {
@@ -117,11 +130,11 @@ function normalizeValues(base, options = {}, classKeys = [], readerName = "CjsWe
   return values;
 }
 
-/**
- * Normalize caller input into a Uint8Array of package bytes.
- *
- * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Candidate payload.
- * @returns {Uint8Array} The payload bytes.
+/**
+ * Normalize caller input into a Uint8Array of package bytes.
+ *
+ * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Candidate payload.
+ * @returns {Uint8Array} The payload bytes.
  */
 function toBytes(input) {
   if (input instanceof Uint8Array) return input;
@@ -130,17 +143,17 @@ function toBytes(input) {
   throw new TypeError("CjsWebgpuFormat: input must be Carbon WebGPU package bytes (Uint8Array, Buffer, DataView or ArrayBuffer)");
 }
 
-/**
- * Reports whether a payload has the Carbon v15 container shape.
- *
- * This is a **shape** check, not an identity check. Our containers are stock
- * Carbon v15 files, so nothing in the bytes separates one from a shipped
- * `effect.dx11` file -- and nothing should. Identity comes from the resource
- * path the file was resolved through, exactly as it does for Carbon, whose own
- * three backend trees are byte-format-identical with no language field anywhere.
- *
- * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Candidate payload.
- * @returns {boolean} True when the payload opens on Carbon's v15 version dword.
+/**
+ * Reports whether a payload has the Carbon v15 container shape.
+ *
+ * This is a **shape** check, not an identity check. Our containers are stock
+ * Carbon v15 files, so nothing in the bytes separates one from a shipped
+ * `effect.dx11` file -- and nothing should. Identity comes from the resource
+ * path the file was resolved through, exactly as it does for Carbon, whose own
+ * three backend trees are byte-format-identical with no language field anywhere.
+ *
+ * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Candidate payload.
+ * @returns {boolean} True when the payload opens on Carbon's v15 version dword.
  */
 function isCarbonWebgpu(input) {
   try {
@@ -150,12 +163,12 @@ function isCarbonWebgpu(input) {
   }
 }
 
-/**
- * The shared read path used by the instance Read/Inspect and static one-shots.
- *
- * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Carbon WebGPU container payload.
- * @param {object} values Normalized format values.
- * @returns {CarbonWebgpuContainer} The loaded container.
+/**
+ * The shared read path used by the instance Read/Inspect and static one-shots.
+ *
+ * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Carbon WebGPU container payload.
+ * @param {object} values Normalized format values.
+ * @returns {CarbonWebgpuContainer} The loaded container.
  */
 function readRaw(input, values) {
   const bytes = toBytes(input);
@@ -183,20 +196,20 @@ function readRaw(input, values) {
   return container;
 }
 
-/**
- * Converts a loaded container to the documented plain JSON shape.
- *
- * `analysis` and `wgsl` are **derived views**, not stored documents. The chunk
- * package kept them beside the reflection they were computed from and carried
- * digests to detect the two disagreeing; there is now one document, so there is
- * nothing left to disagree and no digest to carry.
- *
- * `chunks` is gone. It described a container that no longer exists, and a record
- * layout has no chunk table to translate it into.
- *
- * @param {CarbonWebgpuContainer} container Loaded container.
- * @param {object} [options] View options.
- * @returns {object} Plain JSON data.
+/**
+ * Converts a loaded container to the documented plain JSON shape.
+ *
+ * `analysis` and `wgsl` are **derived views**, not stored documents. The chunk
+ * package kept them beside the reflection they were computed from and carried
+ * digests to detect the two disagreeing; there is now one document, so there is
+ * nothing left to disagree and no digest to carry.
+ *
+ * `chunks` is gone. It described a container that no longer exists, and a record
+ * layout has no chunk table to translate it into.
+ *
+ * @param {CarbonWebgpuContainer} container Loaded container.
+ * @param {object} [options] View options.
+ * @returns {object} Plain JSON data.
  */
 function packageToJson(container, options = {}) {
   const source = options.source || container.sourcePath || "memory";
@@ -229,27 +242,26 @@ function packageToJson(container, options = {}) {
   });
 }
 
-/**
- * Shared read entry honouring the emit mode.
- *
- * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Carbon WebGPU container payload.
- * @param {object} values Normalized format values.
- * @returns {CarbonWebgpuContainer|object} Raw container or plain JSON data.
+/**
+ * Shared read entry.
+ *
+ * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Carbon WebGPU container payload.
+ * @param {object} values Normalized format values.
+ * @returns {object} Plain JSON data.
  */
 function readWithValues(input, values) {
-  const container = readRaw(input, values);
-  return values.emit === OUTPUT_RAW ? container : packageToJson(container, {
+  return packageToJson(readRaw(input, values), {
     source: values.source
   });
 }
 
-/**
- * Compact inspection: Carbon version and compiler bytes, body counts, and the
- * resolved analysis/WGSL counts without building the full JSON package shape.
- *
- * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Carbon WebGPU container payload.
- * @param {object} values Normalized format values.
- * @returns {object} Plain summary data.
+/**
+ * Compact inspection: Carbon version and compiler bytes, body counts, and the
+ * resolved analysis/WGSL counts without building the full JSON package shape.
+ *
+ * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Carbon WebGPU container payload.
+ * @param {object} values Normalized format values.
+ * @returns {object} Plain summary data.
  */
 function inspectWithValues(input, values) {
   const container = readRaw(input, values);
@@ -351,15 +363,15 @@ function analyzeStage(stage, options) {
   return out;
 }
 
-/**
- * Builds the normalized WebGPU analysis document from a resolved effect.
- *
- * @param {object} resolved Raw resolved-effect context from `readEffectAnalysis`.
- * @param {object} [options] Analysis options.
- * @param {string} [options.source] Source label for diagnostics.
- * @param {boolean} [options.decodeBytecode] Whether stage bytecode is inspected.
- * @param {boolean} [options.decodeInstructions] Whether DXBC instructions are decoded.
- * @returns {object} Plain JSON-compatible analysis data.
+/**
+ * Builds the normalized WebGPU analysis document from a resolved effect.
+ *
+ * @param {object} resolved Raw resolved-effect context from `readEffectAnalysis`.
+ * @param {object} [options] Analysis options.
+ * @param {string} [options.source] Source label for diagnostics.
+ * @param {boolean} [options.decodeBytecode] Whether stage bytecode is inspected.
+ * @param {boolean} [options.decodeInstructions] Whether DXBC instructions are decoded.
+ * @returns {object} Plain JSON-compatible analysis data.
  */
 function buildEffectAnalysis(resolved, options = {}) {
   const source = options.source || resolved.effectRes?.sourcePath || "memory";
@@ -390,14 +402,14 @@ function buildEffectAnalysis(resolved, options = {}) {
   });
 }
 
-/**
- * Analyzes one compiled effect payload into a normalized WebGPU-facing
- * document: selected permutation, Carbon binding manifest, and per-stage DXBC
- * decode.
- *
- * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Tr2 effect payload.
- * @param {object} values Normalized format values.
- * @returns {object} Plain JSON-compatible analysis data.
+/**
+ * Analyzes one compiled effect payload into a normalized WebGPU-facing
+ * document: selected permutation, Carbon binding manifest, and per-stage DXBC
+ * decode.
+ *
+ * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Tr2 effect payload.
+ * @param {object} values Normalized format values.
+ * @returns {object} Plain JSON-compatible analysis data.
  */
 function analyzeEffectWithValues(input, values) {
   const permutation = normalizeEffectPermutation(values.permutation);
@@ -412,11 +424,11 @@ function analyzeEffectWithValues(input, values) {
   });
 }
 
-/**
- * Deep-convert a value to plain JSON-compatible data.
- *
- * @param {any} value Value to convert.
- * @returns {any} Plain data.
+/**
+ * Deep-convert a value to plain JSON-compatible data.
+ *
+ * @param {any} value Value to convert.
+ * @returns {any} Plain data.
  */
 function toJsonValue(value) {
   if (value === null || value === undefined) return value ?? null;
@@ -439,5 +451,5 @@ function toJsonValue(value) {
   return null;
 }
 
-export { CARBON_WEBGPU_ANALYSIS_FORMAT, CARBON_WEBGPU_ANALYSIS_VERSION, CARBON_WEBGPU_FORMAT, DEFAULT_VALUES, OUTPUT_JSON, OUTPUT_RAW, WebgpuReadError, analyzeEffectWithValues, buildEffectAnalysis, inspectWithValues, isCarbonWebgpu, normalizeValues, packageToJson, readRaw, readWithValues, toBytes, toJsonValue, validateClass, validateClassKey };
+export { CARBON_WEBGPU_ANALYSIS_FORMAT, CARBON_WEBGPU_ANALYSIS_VERSION, CARBON_WEBGPU_FORMAT, DEFAULT_VALUES, OUTPUT_JSON, WebgpuReadError, analyzeEffectWithValues, buildEffectAnalysis, inspectWithValues, isCarbonWebgpu, normalizeValues, packageToJson, readRaw, readWithValues, toBytes, toJsonValue, validateClass, validateClassKey };
 //# sourceMappingURL=helpers.js.map