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

package/dist/resource/formats/webgl/core/glslBackendBodySet.js

@@ -1,4 +1,4 @@
-import { detailMapTransformFor } from '../../hlsl/core/detailMapFamily.js';
+import { textureArrayTransformFor } from '../../hlsl/core/textureArrayFamilies.js';
 import { localLightProfileNeutralTransformFor } from '../../hlsl/core/localLightFamily.js';
 
 /**
@@ -169,9 +169,9 @@ function buildGlslBackendBodySet(input) {
       // transform section says how to build the array the GLSL samples.
       // Built here rather than at translation time because the transform's
       // identity includes the pass key, which the translator does not know.
-      if (shader.detailMapArray && !entry.hasDetailMapTransform) {
-        entry.hasDetailMapTransform = true;
-        entry.transforms.push(detailMapTransformFor(shader.detailMapArray, key));
+      if (shader.textureArrays?.length && !entry.hasTextureArrayTransforms) {
+        entry.hasTextureArrayTransforms = true;
+        for (const plan of shader.textureArrays) entry.transforms.push(textureArrayTransformFor(plan, key));
       }
 
       // Same reasoning, different statement: this one records that the

package/dist/resource/formats/webgl/core/glslBackendBodySet.js.map

@@ -1 +1 @@
-{"version":3,"file":"glslBackendBodySet.js","sources":["../../../../../../src/resource/formats/webgl/core/glslBackendBodySet.js"],"sourcesContent":["import { detailMapTransformFor } from \"../../hlsl/core/detailMapFamily.js\";\nimport { localLightProfileNeutralTransformFor } from \"../../hlsl/core/localLightFamily.js\";\n\n/**\n * Reshapes translated GLSL into the backend body set the Carbon container\n * writer consumes.\n *\n * This is the WebGL counterpart of `formats/webgpu/core/effectBackendBodySet.js`\n * and deliberately emits the same envelope, because `buildCarbonEffectContainer`\n * is backend-neutral and should stay that way: it wants bodies, passes and\n * translation units, and does not care what language the programs are in.\n *\n * Two facts drive the shape here, and neither is obvious:\n *\n * 1. **Body keys must be the permutation graph's, not this package's.** The\n *    effect walk mints `body_${offset}_${size}` while the graph mints\n *    `body${N}`. The container writer drives off graph variants, so a package\n *    key reaching it would silently match nothing. The bridge is the\n *    permutation index, not string surgery on either spelling.\n *\n * 2. **A translation unit is per pass, never per shader.** One DXBC vertex body\n *    can lower to several different GLSL programs, because `pairVaryings`\n *    zero-fills the varyings a paired pixel stage reads but the vertex stage\n *    never writes - and that set differs per pass. Deduplicating programs by\n *    bytecode would therefore collapse two genuinely different programs into\n *    one. The unit signature includes the pass key for exactly this reason.\n */\n\n/**\n * Carbon's pass identity, matching the WebGPU emitter so both backends key\n * passes identically.\n *\n * @param {string} techniqueName Technique name.\n * @param {number} passIndex Pass index within the technique.\n * @returns {string} Pass key.\n */\nfunction passKeyFor(techniqueName, passIndex)\n{\n    return `${techniqueName}.pass${passIndex}`;\n}\n\n/**\n * Stable signature for one pass translation unit.\n *\n * Includes `passKey` because pass-scoped varying pairing can make two units\n * differ while their source bytecode is identical. Excludes diagnostics\n * (`emitWarnings`, `hlsl2webgl`) because they describe the build, not the\n * program, and would split otherwise-identical units.\n *\n * @param {object} unit Candidate unit.\n * @returns {string} Signature.\n */\nfunction unitSignature(unit)\n{\n    return JSON.stringify({\n        passKey: unit.passKey,\n        shaders: unit.shaders,\n        block: unit.block,\n        resourceTransforms: unit.resourceTransforms\n    });\n}\n\n/**\n * Collect the per-stage data that has no home in Carbon reflection.\n *\n * Carbon records the logical resource and its register; these are the lowering\n * decisions taken on top of that - fused sampler pairs, synthesised data\n * textures and UBOs, dropped stub registers, and integer attributes lowered to\n * float. The GLSL text declares them but does not say how to build or bind\n * them, and reflection does not know they happened.\n *\n * Identifiers are kept. An earlier version of this comment claimed `cb{n}`,\n * `s{n}` and `attr{n}` are functions of the register index alone and so need not\n * be stored. They are not: the pixel stage remaps constant-buffer slot 0 to\n * `cb7` (`DxbcGlslEmitter.js`, `pixelConstantBufferRemap`), so an identifier\n * depends on the register *and* the stage, through a profile table. Deriving it\n * downstream would re-implement that policy, and a divergence would show up as a\n * uniform that never binds rather than as an error.\n *\n * @param {object} shader Translated shader record.\n * @returns {object|null} Stage block data, or null when the stage adds nothing.\n */\nfunction stageBlockFor(shader)\n{\n    const block = {};\n\n    if (Array.isArray(shader.bindings) && shader.bindings.length)\n    {\n        block.bindings = shader.bindings;\n    }\n    if (Array.isArray(shader.stageInputs) && shader.stageInputs.length)\n    {\n        block.stageInputs = shader.stageInputs;\n    }\n    if (shader.computeFragment)\n    {\n        block.computeFragment = shader.computeFragment;\n    }\n\n    return Object.keys(block).length ? block : null;\n}\n\n/**\n * Build the backend body set for a translated WebGL effect.\n *\n * @param {object} input Translation results.\n * @param {Array<object>} input.bodies Body records from the effect walk.\n * @param {Array<object>} input.stages Stage records from the effect walk.\n * @param {Array<object>} input.shaders Translated shader records.\n * @param {Array<object>} input.variants Export variants, carrying permutation indices.\n * @param {object} input.permutationGraph Validated permutation graph.\n * @returns {object} Backend body set in the container writer's shape.\n */\nexport function buildGlslBackendBodySet(input)\n{\n    const { bodies, stages, shaders, variants, permutationGraph } = input;\n\n    const shadersByKey = new Map(shaders.map((shader) => [ shader.key, shader ]));\n    const stagesByBody = new Map();\n    for (const stage of stages)\n    {\n        if (!stagesByBody.has(stage.bodyKey)) stagesByBody.set(stage.bodyKey, []);\n        stagesByBody.get(stage.bodyKey).push(stage);\n    }\n\n    // Package body key -> the graph's own key, bridged through the permutation\n    // index rather than by reformatting either spelling.\n    const graphKeyByPackageKey = new Map();\n    const permutationIndexByPackageKey = new Map();\n    for (const variant of variants)\n    {\n        if (graphKeyByPackageKey.has(variant.bodyKey)) continue;\n        const graphVariant = permutationGraph.variants[variant.permutationIndex];\n        if (!graphVariant) continue;\n        graphKeyByPackageKey.set(variant.bodyKey, graphVariant.bodyKey);\n        permutationIndexByPackageKey.set(variant.bodyKey, variant.permutationIndex);\n    }\n\n    const passUnits = [];\n    const unitKeyBySignature = new Map();\n    const emittedBodies = [];\n\n    for (const body of bodies)\n    {\n        const graphBodyKey = graphKeyByPackageKey.get(body.key);\n        if (!graphBodyKey) continue;\n\n        const representativePermutationIndex =\n            permutationIndexByPackageKey.get(body.key) ?? 0;\n\n        if (body.error)\n        {\n            emittedBodies.push({\n                bodyKey: graphBodyKey,\n                representativePermutationIndex,\n                status: \"unsupported\",\n                error: body.error,\n                passes: []\n            });\n            continue;\n        }\n\n        const passes = new Map();\n        for (const stage of stagesByBody.get(body.key) ?? [])\n        {\n            const key = passKeyFor(stage.techniqueName, stage.passIndex);\n            if (!passes.has(key))\n            {\n                passes.set(key, { passKey: key, shaders: [], block: {}, transforms: [] });\n            }\n\n            const shader = shadersByKey.get(stage.shaderKey);\n            // A stage the translator could not lower carries no program. The\n            // body still emits, with reflection intact and an empty slot, so\n            // the offset table stays dense and the failure is visible rather\n            // than absent.\n            if (!shader?.source) continue;\n\n            const entry = passes.get(key);\n\n            // The merge is a property of the pass, not of one stage: the block's\n            // transform section says how to build the array the GLSL samples.\n            // Built here rather than at translation time because the transform's\n            // identity includes the pass key, which the translator does not know.\n            if (shader.detailMapArray && !entry.hasDetailMapTransform)\n            {\n                entry.hasDetailMapTransform = true;\n                entry.transforms.push(detailMapTransformFor(shader.detailMapArray, key));\n            }\n\n            // Same reasoning, different statement: this one records that the\n            // light profile array was dropped for a constant, so the resource\n            // the description still lists is accounted for rather than missing.\n            if (shader.lightProfileNeutral && !entry.hasLightProfileTransform)\n            {\n                const transform = localLightProfileNeutralTransformFor(shader.lightProfileNeutral, key);\n                if (transform)\n                {\n                    entry.hasLightProfileTransform = true;\n                    entry.transforms.push(transform);\n                }\n            }\n\n            entry.shaders.push({\n                key: `${key}.${stage.stageName}`,\n                stageName: stage.stageName,\n                stageType: stage.stageType,\n                code: shader.source\n            });\n\n            const stageBlock = stageBlockFor(shader);\n            if (stageBlock) entry.block[stage.stageName] = stageBlock;\n        }\n\n        const bodyPasses = [];\n        let translatedPassCount = 0;\n\n        for (const pass of passes.values())\n        {\n            if (!pass.shaders.length) continue;\n            translatedPassCount += 1;\n\n            const unit = {\n                passKey: pass.passKey,\n                shaders: pass.shaders,\n                block: Object.keys(pass.block).length ? pass.block : null,\n                resourceTransforms: pass.transforms\n            };\n            const signature = unitSignature(unit);\n            let unitKey = unitKeyBySignature.get(signature);\n\n            if (!unitKey)\n            {\n                unitKey = `unit${passUnits.length}`;\n                unitKeyBySignature.set(signature, unitKey);\n                passUnits.push({ key: unitKey, ...unit });\n            }\n\n            bodyPasses.push({ passKey: pass.passKey, unitKey });\n        }\n\n        emittedBodies.push({\n            bodyKey: graphBodyKey,\n            representativePermutationIndex,\n            status: translatedPassCount ? \"translated\" : \"unsupported\",\n            error: translatedPassCount ? null : \"no pass produced a translated program\",\n            passes: bodyPasses\n        });\n    }\n\n    return {\n        format: \"CJS_GLSL_BODY_SET\",\n        formatVersion: 1,\n        bodyCount: emittedBodies.length,\n        translatedBodyCount: emittedBodies.filter((body) => body.status === \"translated\").length,\n        passUnitCount: passUnits.length,\n        passUnits: passUnits,\n        bodies: emittedBodies\n    };\n}\n\nexport default buildGlslBackendBodySet;\n"],"names":["passKeyFor","techniqueName","passIndex","unitSignature","unit","JSON","stringify","passKey","shaders","block","resourceTransforms","stageBlockFor","shader","Array","isArray","bindings","length","stageInputs","computeFragment","Object","keys","buildGlslBackendBodySet","input","bodies","stages","variants","permutationGraph","shadersByKey","Map","map","key","stagesByBody","stage","has","bodyKey","set","get","push","graphKeyByPackageKey","permutationIndexByPackageKey","variant","graphVariant","permutationIndex","passUnits","unitKeyBySignature","emittedBodies","body","graphBodyKey","representativePermutationIndex","error","status","passes","transforms","shaderKey","source","entry","detailMapArray","hasDetailMapTransform","detailMapTransformFor","lightProfileNeutral","hasLightProfileTransform","transform","localLightProfileNeutralTransformFor","stageName","stageType","code","stageBlock","bodyPasses","translatedPassCount","pass","values","signature","unitKey","format","formatVersion","bodyCount","translatedBodyCount","filter","passUnitCount"],"mappings":"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"}
+{"version":3,"file":"glslBackendBodySet.js","sources":["../../../../../../src/resource/formats/webgl/core/glslBackendBodySet.js"],"sourcesContent":["import { textureArrayTransformFor } from \"../../hlsl/core/textureArrayFamilies.js\";\nimport { localLightProfileNeutralTransformFor } from \"../../hlsl/core/localLightFamily.js\";\n\n/**\n * Reshapes translated GLSL into the backend body set the Carbon container\n * writer consumes.\n *\n * This is the WebGL counterpart of `formats/webgpu/core/effectBackendBodySet.js`\n * and deliberately emits the same envelope, because `buildCarbonEffectContainer`\n * is backend-neutral and should stay that way: it wants bodies, passes and\n * translation units, and does not care what language the programs are in.\n *\n * Two facts drive the shape here, and neither is obvious:\n *\n * 1. **Body keys must be the permutation graph's, not this package's.** The\n *    effect walk mints `body_${offset}_${size}` while the graph mints\n *    `body${N}`. The container writer drives off graph variants, so a package\n *    key reaching it would silently match nothing. The bridge is the\n *    permutation index, not string surgery on either spelling.\n *\n * 2. **A translation unit is per pass, never per shader.** One DXBC vertex body\n *    can lower to several different GLSL programs, because `pairVaryings`\n *    zero-fills the varyings a paired pixel stage reads but the vertex stage\n *    never writes - and that set differs per pass. Deduplicating programs by\n *    bytecode would therefore collapse two genuinely different programs into\n *    one. The unit signature includes the pass key for exactly this reason.\n */\n\n/**\n * Carbon's pass identity, matching the WebGPU emitter so both backends key\n * passes identically.\n *\n * @param {string} techniqueName Technique name.\n * @param {number} passIndex Pass index within the technique.\n * @returns {string} Pass key.\n */\nfunction passKeyFor(techniqueName, passIndex)\n{\n    return `${techniqueName}.pass${passIndex}`;\n}\n\n/**\n * Stable signature for one pass translation unit.\n *\n * Includes `passKey` because pass-scoped varying pairing can make two units\n * differ while their source bytecode is identical. Excludes diagnostics\n * (`emitWarnings`, `hlsl2webgl`) because they describe the build, not the\n * program, and would split otherwise-identical units.\n *\n * @param {object} unit Candidate unit.\n * @returns {string} Signature.\n */\nfunction unitSignature(unit)\n{\n    return JSON.stringify({\n        passKey: unit.passKey,\n        shaders: unit.shaders,\n        block: unit.block,\n        resourceTransforms: unit.resourceTransforms\n    });\n}\n\n/**\n * Collect the per-stage data that has no home in Carbon reflection.\n *\n * Carbon records the logical resource and its register; these are the lowering\n * decisions taken on top of that - fused sampler pairs, synthesised data\n * textures and UBOs, dropped stub registers, and integer attributes lowered to\n * float. The GLSL text declares them but does not say how to build or bind\n * them, and reflection does not know they happened.\n *\n * Identifiers are kept. An earlier version of this comment claimed `cb{n}`,\n * `s{n}` and `attr{n}` are functions of the register index alone and so need not\n * be stored. They are not: the pixel stage remaps constant-buffer slot 0 to\n * `cb7` (`DxbcGlslEmitter.js`, `pixelConstantBufferRemap`), so an identifier\n * depends on the register *and* the stage, through a profile table. Deriving it\n * downstream would re-implement that policy, and a divergence would show up as a\n * uniform that never binds rather than as an error.\n *\n * @param {object} shader Translated shader record.\n * @returns {object|null} Stage block data, or null when the stage adds nothing.\n */\nfunction stageBlockFor(shader)\n{\n    const block = {};\n\n    if (Array.isArray(shader.bindings) && shader.bindings.length)\n    {\n        block.bindings = shader.bindings;\n    }\n    if (Array.isArray(shader.stageInputs) && shader.stageInputs.length)\n    {\n        block.stageInputs = shader.stageInputs;\n    }\n    if (shader.computeFragment)\n    {\n        block.computeFragment = shader.computeFragment;\n    }\n\n    return Object.keys(block).length ? block : null;\n}\n\n/**\n * Build the backend body set for a translated WebGL effect.\n *\n * @param {object} input Translation results.\n * @param {Array<object>} input.bodies Body records from the effect walk.\n * @param {Array<object>} input.stages Stage records from the effect walk.\n * @param {Array<object>} input.shaders Translated shader records.\n * @param {Array<object>} input.variants Export variants, carrying permutation indices.\n * @param {object} input.permutationGraph Validated permutation graph.\n * @returns {object} Backend body set in the container writer's shape.\n */\nexport function buildGlslBackendBodySet(input)\n{\n    const { bodies, stages, shaders, variants, permutationGraph } = input;\n\n    const shadersByKey = new Map(shaders.map((shader) => [ shader.key, shader ]));\n    const stagesByBody = new Map();\n    for (const stage of stages)\n    {\n        if (!stagesByBody.has(stage.bodyKey)) stagesByBody.set(stage.bodyKey, []);\n        stagesByBody.get(stage.bodyKey).push(stage);\n    }\n\n    // Package body key -> the graph's own key, bridged through the permutation\n    // index rather than by reformatting either spelling.\n    const graphKeyByPackageKey = new Map();\n    const permutationIndexByPackageKey = new Map();\n    for (const variant of variants)\n    {\n        if (graphKeyByPackageKey.has(variant.bodyKey)) continue;\n        const graphVariant = permutationGraph.variants[variant.permutationIndex];\n        if (!graphVariant) continue;\n        graphKeyByPackageKey.set(variant.bodyKey, graphVariant.bodyKey);\n        permutationIndexByPackageKey.set(variant.bodyKey, variant.permutationIndex);\n    }\n\n    const passUnits = [];\n    const unitKeyBySignature = new Map();\n    const emittedBodies = [];\n\n    for (const body of bodies)\n    {\n        const graphBodyKey = graphKeyByPackageKey.get(body.key);\n        if (!graphBodyKey) continue;\n\n        const representativePermutationIndex =\n            permutationIndexByPackageKey.get(body.key) ?? 0;\n\n        if (body.error)\n        {\n            emittedBodies.push({\n                bodyKey: graphBodyKey,\n                representativePermutationIndex,\n                status: \"unsupported\",\n                error: body.error,\n                passes: []\n            });\n            continue;\n        }\n\n        const passes = new Map();\n        for (const stage of stagesByBody.get(body.key) ?? [])\n        {\n            const key = passKeyFor(stage.techniqueName, stage.passIndex);\n            if (!passes.has(key))\n            {\n                passes.set(key, { passKey: key, shaders: [], block: {}, transforms: [] });\n            }\n\n            const shader = shadersByKey.get(stage.shaderKey);\n            // A stage the translator could not lower carries no program. The\n            // body still emits, with reflection intact and an empty slot, so\n            // the offset table stays dense and the failure is visible rather\n            // than absent.\n            if (!shader?.source) continue;\n\n            const entry = passes.get(key);\n\n            // The merge is a property of the pass, not of one stage: the block's\n            // transform section says how to build the array the GLSL samples.\n            // Built here rather than at translation time because the transform's\n            // identity includes the pass key, which the translator does not know.\n            if (shader.textureArrays?.length && !entry.hasTextureArrayTransforms)\n            {\n                entry.hasTextureArrayTransforms = true;\n                for (const plan of shader.textureArrays) entry.transforms.push(textureArrayTransformFor(plan, key));\n            }\n\n            // Same reasoning, different statement: this one records that the\n            // light profile array was dropped for a constant, so the resource\n            // the description still lists is accounted for rather than missing.\n            if (shader.lightProfileNeutral && !entry.hasLightProfileTransform)\n            {\n                const transform = localLightProfileNeutralTransformFor(shader.lightProfileNeutral, key);\n                if (transform)\n                {\n                    entry.hasLightProfileTransform = true;\n                    entry.transforms.push(transform);\n                }\n            }\n\n            entry.shaders.push({\n                key: `${key}.${stage.stageName}`,\n                stageName: stage.stageName,\n                stageType: stage.stageType,\n                code: shader.source\n            });\n\n            const stageBlock = stageBlockFor(shader);\n            if (stageBlock) entry.block[stage.stageName] = stageBlock;\n        }\n\n        const bodyPasses = [];\n        let translatedPassCount = 0;\n\n        for (const pass of passes.values())\n        {\n            if (!pass.shaders.length) continue;\n            translatedPassCount += 1;\n\n            const unit = {\n                passKey: pass.passKey,\n                shaders: pass.shaders,\n                block: Object.keys(pass.block).length ? pass.block : null,\n                resourceTransforms: pass.transforms\n            };\n            const signature = unitSignature(unit);\n            let unitKey = unitKeyBySignature.get(signature);\n\n            if (!unitKey)\n            {\n                unitKey = `unit${passUnits.length}`;\n                unitKeyBySignature.set(signature, unitKey);\n                passUnits.push({ key: unitKey, ...unit });\n            }\n\n            bodyPasses.push({ passKey: pass.passKey, unitKey });\n        }\n\n        emittedBodies.push({\n            bodyKey: graphBodyKey,\n            representativePermutationIndex,\n            status: translatedPassCount ? \"translated\" : \"unsupported\",\n            error: translatedPassCount ? null : \"no pass produced a translated program\",\n            passes: bodyPasses\n        });\n    }\n\n    return {\n        format: \"CJS_GLSL_BODY_SET\",\n        formatVersion: 1,\n        bodyCount: emittedBodies.length,\n        translatedBodyCount: emittedBodies.filter((body) => body.status === \"translated\").length,\n        passUnitCount: passUnits.length,\n        passUnits: passUnits,\n        bodies: emittedBodies\n    };\n}\n\nexport default buildGlslBackendBodySet;\n"],"names":["passKeyFor","techniqueName","passIndex","unitSignature","unit","JSON","stringify","passKey","shaders","block","resourceTransforms","stageBlockFor","shader","Array","isArray","bindings","length","stageInputs","computeFragment","Object","keys","buildGlslBackendBodySet","input","bodies","stages","variants","permutationGraph","shadersByKey","Map","map","key","stagesByBody","stage","has","bodyKey","set","get","push","graphKeyByPackageKey","permutationIndexByPackageKey","variant","graphVariant","permutationIndex","passUnits","unitKeyBySignature","emittedBodies","body","graphBodyKey","representativePermutationIndex","error","status","passes","transforms","shaderKey","source","entry","textureArrays","hasTextureArrayTransforms","plan","textureArrayTransformFor","lightProfileNeutral","hasLightProfileTransform","transform","localLightProfileNeutralTransformFor","stageName","stageType","code","stageBlock","bodyPasses","translatedPassCount","pass","values","signature","unitKey","format","formatVersion","bodyCount","translatedBodyCount","filter","passUnitCount"],"mappings":"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"}

package/dist/resource/formats/webgl/core/helpers.js

@@ -67,8 +67,8 @@ function isWebglEffectContainer(input) {
     return false;
   }
 }
-const EMIT_GLSL_OPTION_KEYS = new Set(["constantBufferStyle", "pixelConstantBufferRemap", "samplerName", "vertexStructuredCapacity", "dataTextureWidth", "stubResourceRegisters", "neutralResourceRegisters", "detailMapArrayRegisters", "lightConstantBuffer", "lightPackedTexture", "packedLightProfiles", "emulatedAddressing", "depthRange", "clipYFlip", "pairVaryings", "source"]);
-const EMIT_GLSL_PROFILE_KEYS = new Set(["constantBufferStyle", "pixelConstantBufferRemap", "samplerName", "vertexStructuredCapacity", "dataTextureWidth", "stubResourceRegisters", "neutralResourceRegisters", "detailMapArrayRegisters", "lightConstantBuffer", "lightPackedTexture", "packedLightProfiles", "emulatedAddressing", "depthRange", "clipYFlip"]);
+const EMIT_GLSL_OPTION_KEYS = new Set(["constantBufferStyle", "pixelConstantBufferRemap", "samplerName", "vertexStructuredCapacity", "dataTextureWidth", "stubResourceRegisters", "neutralResourceRegisters", "detailMapArrayRegisters", "textureArrayFamilies", "lightConstantBuffer", "lightPackedTexture", "packedLightProfiles", "emulatedAddressing", "depthRange", "clipYFlip", "pairVaryings", "source"]);
+const EMIT_GLSL_PROFILE_KEYS = new Set(["constantBufferStyle", "pixelConstantBufferRemap", "samplerName", "vertexStructuredCapacity", "dataTextureWidth", "stubResourceRegisters", "neutralResourceRegisters", "detailMapArrayRegisters", "textureArrayFamilies", "lightConstantBuffer", "lightPackedTexture", "packedLightProfiles", "emulatedAddressing", "depthRange", "clipYFlip"]);
 
 /**
  * Translates one DXBC stage into GLSL ES 3.00 source, sharing one core path

package/dist/resource/formats/webgl/core/helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","sources":["../../../../../../src/resource/formats/webgl/core/helpers.js"],"sourcesContent":["import { toJsonWithCollections as toJsonValue } from \"../../../format/jsonPolicies.js\";\nimport { asUint8Array } from \"#utils/bytes\";\n\n/**\n * Internal glue for CjsWebglFormat.\n *\n * Keeps the public class file small: input/option normalization, DXBC-to-GLSL\n * emission, and JSON conversion live here. Reading an effect is\n * `readGlslEffectContainer` and summarising one is `inspectGlslEffectContainer`;\n * neither needs glue, so neither is wrapped here. The GLSL emitter lives under\n * src/formats/webgl/core/glsl.\n */\n\nimport { DxbcGlslEmitter } from \"./glsl/DxbcGlslEmitter.js\";\nimport { applyPackedLightFixups } from \"./glsl/packedLightFixups.js\";\nimport { WebglReadError } from \"./errors.js\";\nimport {\n    looksLikeCarbonEffectContainer\n} from \"../../../format/carbonEffect/CjsCarbonEffectReader.js\";\n\nexport const OUTPUT_JSON = \"json\";\n\nexport const DEFAULT_VALUES = Object.freeze({\n    emit: OUTPUT_JSON,\n    source: \"memory\"\n});\n\nconst VALID_EMITS = new Set([ OUTPUT_JSON ]);\nconst OPTION_KEYS = new Set([ \"emit\", \"source\" ]);\n\n/**\n * Merge format values over a base set and validate them.\n *\n * @param {object} base Current values.\n * @param {object} [options] Values to merge in.\n * @param {string} [readerName] Reader name used in error messages.\n * @returns {object} A validated copy of the merged values.\n */\nexport function normalizeValues(base, options = {}, readerName = \"CjsWebglFormat\")\n{\n    if (!options || typeof options !== \"object\")\n    {\n        throw new TypeError(`${readerName}: options must be an object`);\n    }\n    for (const key of Object.keys(options))\n    {\n        if (!OPTION_KEYS.has(key))\n        {\n            throw new TypeError(`${readerName}: unknown option ${JSON.stringify(key)}`);\n        }\n    }\n\n    const values = { ...base, ...options };\n\n    if (!VALID_EMITS.has(values.emit))\n    {\n        throw new TypeError(`${readerName}: emit must be \"${OUTPUT_JSON}\", got ${JSON.stringify(values.emit)}`);\n    }\n    if (typeof values.source !== \"string\" || !values.source)\n    {\n        values.source = DEFAULT_VALUES.source;\n    }\n\n    return {\n        emit: values.emit,\n        source: values.source\n    };\n}\n\n/**\n * Normalize caller input into a Uint8Array of package/DXBC bytes.\n *\n * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Candidate payload.\n * @returns {Uint8Array} The payload bytes.\n */\n/**\n * Reports whether a payload has the Carbon effect container shape.\n *\n * A shape check, not an identity check: our files are stock Carbon containers,\n * so nothing in the bytes distinguishes a WebGL one from a shipped\n * `effect.dx11`. Identity comes from the path the file was resolved through.\n *\n * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Candidate payload.\n * @returns {boolean} True when the payload has the container shape.\n */\nexport function isWebglEffectContainer(input)\n{\n    try\n    {\n        return looksLikeCarbonEffectContainer(asUint8Array(input, \"CjsWebglFormat input\"));\n    }\n    catch\n    {\n        return false;\n    }\n}\n\nconst EMIT_GLSL_OPTION_KEYS = new Set([\n    \"constantBufferStyle\",\n    \"pixelConstantBufferRemap\",\n    \"samplerName\",\n    \"vertexStructuredCapacity\",\n    \"dataTextureWidth\",\n    \"stubResourceRegisters\",\n    \"neutralResourceRegisters\",\n    \"detailMapArrayRegisters\",\n    \"lightConstantBuffer\",\n    \"lightPackedTexture\",\n    \"packedLightProfiles\",\n    \"emulatedAddressing\",\n    \"depthRange\",\n    \"clipYFlip\",\n    \"pairVaryings\",\n    \"source\"\n]);\n\nconst EMIT_GLSL_PROFILE_KEYS = new Set([\n    \"constantBufferStyle\",\n    \"pixelConstantBufferRemap\",\n    \"samplerName\",\n    \"vertexStructuredCapacity\",\n    \"dataTextureWidth\",\n    \"stubResourceRegisters\",\n    \"neutralResourceRegisters\",\n    \"detailMapArrayRegisters\",\n    \"lightConstantBuffer\",\n    \"lightPackedTexture\",\n    \"packedLightProfiles\",\n    \"emulatedAddressing\",\n    \"depthRange\",\n    \"clipYFlip\"\n]);\n\n/**\n * Translates one DXBC stage into GLSL ES 3.00 source, sharing one core path\n * between `CjsWebglFormat.emitGlsl` (static) and `EmitGlsl` (instance).\n *\n * `options` is a flat bag combining the emitter's ccpwgl-profile constructor\n * bits (`constantBufferStyle`, `pixelConstantBufferRemap`, `samplerName`,\n * `vertexStructuredCapacity`, `dataTextureWidth`) with its per-call Emit\n * options (`pairVaryings`, `source`); omitted keys keep the emitter's\n * existing defaults exactly.\n *\n * @param {ArrayBuffer|ArrayBufferView|Uint8Array} dxbcBytes DXBC container bytes.\n * @param {object} [options] Combined profile/emit options.\n * @returns {{source:string,stageName:string,inputs:object[],outputs:object[],bindings:object[],warnings:string[],computeFragment:(object|undefined)}}\n *   GLSL text plus the IO contract the packaging layer records; compute\n *   stages add the emitter's `computeFragment` host contract.\n */\nexport function emitGlslWithOptions(dxbcBytes, options = {})\n{\n    if (!options || typeof options !== \"object\")\n    {\n        throw new TypeError(\"CjsWebglFormat: emitGlsl options must be an object\");\n    }\n    for (const key of Object.keys(options))\n    {\n        if (!EMIT_GLSL_OPTION_KEYS.has(key))\n        {\n            throw new TypeError(`CjsWebglFormat: unknown emitGlsl option ${JSON.stringify(key)}`);\n        }\n    }\n\n    const profile = {};\n    for (const key of EMIT_GLSL_PROFILE_KEYS)\n    {\n        if (Object.prototype.hasOwnProperty.call(options, key)) profile[key] = options[key];\n    }\n\n    const emitter = new DxbcGlslEmitter({ profile });\n    const result = emitter.Emit(dxbcBytes, {\n        source: options.source,\n        pairVaryings: options.pairVaryings\n    });\n\n    // The packed local-light lowering leaves two idioms that must not reach a\n    // driver: a flag mask round-tripped through a float, and an all-bits mask\n    // stored as a float and then used for branch control, where 0xFFFFFFFF is a\n    // NaN. Applied here rather than at a call site so every caller gets them.\n    if (!options.lightPackedTexture) return result;\n\n    return {\n        ...result,\n        source: applyPackedLightFixups(result.source, result.stageName)\n    };\n}\n\n/**\n * Deep-convert a value to plain JSON-compatible data. Typed arrays become\n * plain number arrays; Maps/Sets become objects/arrays; class instances\n * with toJSON are honoured.\n *\n * @param {any} value Value to convert.\n * @returns {any} Plain data.\n */\n/** The shared JSON policy for this reader, under the name its callers use. */\nexport { toJsonValue };\n\nexport { WebglReadError };\n\n"],"names":["OUTPUT_JSON","DEFAULT_VALUES","Object","freeze","emit","source","VALID_EMITS","Set","OPTION_KEYS","normalizeValues","base","options","readerName","TypeError","key","keys","has","JSON","stringify","values","isWebglEffectContainer","input","looksLikeCarbonEffectContainer","asUint8Array","EMIT_GLSL_OPTION_KEYS","EMIT_GLSL_PROFILE_KEYS","emitGlslWithOptions","dxbcBytes","profile","prototype","hasOwnProperty","call","emitter","DxbcGlslEmitter","result","Emit","pairVaryings","lightPackedTexture","applyPackedLightFixups","stageName"],"mappings":"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"}
+{"version":3,"file":"helpers.js","sources":["../../../../../../src/resource/formats/webgl/core/helpers.js"],"sourcesContent":["import { toJsonWithCollections as toJsonValue } from \"../../../format/jsonPolicies.js\";\nimport { asUint8Array } from \"#utils/bytes\";\n\n/**\n * Internal glue for CjsWebglFormat.\n *\n * Keeps the public class file small: input/option normalization, DXBC-to-GLSL\n * emission, and JSON conversion live here. Reading an effect is\n * `readGlslEffectContainer` and summarising one is `inspectGlslEffectContainer`;\n * neither needs glue, so neither is wrapped here. The GLSL emitter lives under\n * src/formats/webgl/core/glsl.\n */\n\nimport { DxbcGlslEmitter } from \"./glsl/DxbcGlslEmitter.js\";\nimport { applyPackedLightFixups } from \"./glsl/packedLightFixups.js\";\nimport { WebglReadError } from \"./errors.js\";\nimport {\n    looksLikeCarbonEffectContainer\n} from \"../../../format/carbonEffect/CjsCarbonEffectReader.js\";\n\nexport const OUTPUT_JSON = \"json\";\n\nexport const DEFAULT_VALUES = Object.freeze({\n    emit: OUTPUT_JSON,\n    source: \"memory\"\n});\n\nconst VALID_EMITS = new Set([ OUTPUT_JSON ]);\nconst OPTION_KEYS = new Set([ \"emit\", \"source\" ]);\n\n/**\n * Merge format values over a base set and validate them.\n *\n * @param {object} base Current values.\n * @param {object} [options] Values to merge in.\n * @param {string} [readerName] Reader name used in error messages.\n * @returns {object} A validated copy of the merged values.\n */\nexport function normalizeValues(base, options = {}, readerName = \"CjsWebglFormat\")\n{\n    if (!options || typeof options !== \"object\")\n    {\n        throw new TypeError(`${readerName}: options must be an object`);\n    }\n    for (const key of Object.keys(options))\n    {\n        if (!OPTION_KEYS.has(key))\n        {\n            throw new TypeError(`${readerName}: unknown option ${JSON.stringify(key)}`);\n        }\n    }\n\n    const values = { ...base, ...options };\n\n    if (!VALID_EMITS.has(values.emit))\n    {\n        throw new TypeError(`${readerName}: emit must be \"${OUTPUT_JSON}\", got ${JSON.stringify(values.emit)}`);\n    }\n    if (typeof values.source !== \"string\" || !values.source)\n    {\n        values.source = DEFAULT_VALUES.source;\n    }\n\n    return {\n        emit: values.emit,\n        source: values.source\n    };\n}\n\n/**\n * Normalize caller input into a Uint8Array of package/DXBC bytes.\n *\n * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Candidate payload.\n * @returns {Uint8Array} The payload bytes.\n */\n/**\n * Reports whether a payload has the Carbon effect container shape.\n *\n * A shape check, not an identity check: our files are stock Carbon containers,\n * so nothing in the bytes distinguishes a WebGL one from a shipped\n * `effect.dx11`. Identity comes from the path the file was resolved through.\n *\n * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Candidate payload.\n * @returns {boolean} True when the payload has the container shape.\n */\nexport function isWebglEffectContainer(input)\n{\n    try\n    {\n        return looksLikeCarbonEffectContainer(asUint8Array(input, \"CjsWebglFormat input\"));\n    }\n    catch\n    {\n        return false;\n    }\n}\n\nconst EMIT_GLSL_OPTION_KEYS = new Set([\n    \"constantBufferStyle\",\n    \"pixelConstantBufferRemap\",\n    \"samplerName\",\n    \"vertexStructuredCapacity\",\n    \"dataTextureWidth\",\n    \"stubResourceRegisters\",\n    \"neutralResourceRegisters\",\n    \"detailMapArrayRegisters\",\n    \"textureArrayFamilies\",\n    \"lightConstantBuffer\",\n    \"lightPackedTexture\",\n    \"packedLightProfiles\",\n    \"emulatedAddressing\",\n    \"depthRange\",\n    \"clipYFlip\",\n    \"pairVaryings\",\n    \"source\"\n]);\n\nconst EMIT_GLSL_PROFILE_KEYS = new Set([\n    \"constantBufferStyle\",\n    \"pixelConstantBufferRemap\",\n    \"samplerName\",\n    \"vertexStructuredCapacity\",\n    \"dataTextureWidth\",\n    \"stubResourceRegisters\",\n    \"neutralResourceRegisters\",\n    \"detailMapArrayRegisters\",\n    \"textureArrayFamilies\",\n    \"lightConstantBuffer\",\n    \"lightPackedTexture\",\n    \"packedLightProfiles\",\n    \"emulatedAddressing\",\n    \"depthRange\",\n    \"clipYFlip\"\n]);\n\n/**\n * Translates one DXBC stage into GLSL ES 3.00 source, sharing one core path\n * between `CjsWebglFormat.emitGlsl` (static) and `EmitGlsl` (instance).\n *\n * `options` is a flat bag combining the emitter's ccpwgl-profile constructor\n * bits (`constantBufferStyle`, `pixelConstantBufferRemap`, `samplerName`,\n * `vertexStructuredCapacity`, `dataTextureWidth`) with its per-call Emit\n * options (`pairVaryings`, `source`); omitted keys keep the emitter's\n * existing defaults exactly.\n *\n * @param {ArrayBuffer|ArrayBufferView|Uint8Array} dxbcBytes DXBC container bytes.\n * @param {object} [options] Combined profile/emit options.\n * @returns {{source:string,stageName:string,inputs:object[],outputs:object[],bindings:object[],warnings:string[],computeFragment:(object|undefined)}}\n *   GLSL text plus the IO contract the packaging layer records; compute\n *   stages add the emitter's `computeFragment` host contract.\n */\nexport function emitGlslWithOptions(dxbcBytes, options = {})\n{\n    if (!options || typeof options !== \"object\")\n    {\n        throw new TypeError(\"CjsWebglFormat: emitGlsl options must be an object\");\n    }\n    for (const key of Object.keys(options))\n    {\n        if (!EMIT_GLSL_OPTION_KEYS.has(key))\n        {\n            throw new TypeError(`CjsWebglFormat: unknown emitGlsl option ${JSON.stringify(key)}`);\n        }\n    }\n\n    const profile = {};\n    for (const key of EMIT_GLSL_PROFILE_KEYS)\n    {\n        if (Object.prototype.hasOwnProperty.call(options, key)) profile[key] = options[key];\n    }\n\n    const emitter = new DxbcGlslEmitter({ profile });\n    const result = emitter.Emit(dxbcBytes, {\n        source: options.source,\n        pairVaryings: options.pairVaryings\n    });\n\n    // The packed local-light lowering leaves two idioms that must not reach a\n    // driver: a flag mask round-tripped through a float, and an all-bits mask\n    // stored as a float and then used for branch control, where 0xFFFFFFFF is a\n    // NaN. Applied here rather than at a call site so every caller gets them.\n    if (!options.lightPackedTexture) return result;\n\n    return {\n        ...result,\n        source: applyPackedLightFixups(result.source, result.stageName)\n    };\n}\n\n/**\n * Deep-convert a value to plain JSON-compatible data. Typed arrays become\n * plain number arrays; Maps/Sets become objects/arrays; class instances\n * with toJSON are honoured.\n *\n * @param {any} value Value to convert.\n * @returns {any} Plain data.\n */\n/** The shared JSON policy for this reader, under the name its callers use. */\nexport { toJsonValue };\n\nexport { WebglReadError };\n\n"],"names":["OUTPUT_JSON","DEFAULT_VALUES","Object","freeze","emit","source","VALID_EMITS","Set","OPTION_KEYS","normalizeValues","base","options","readerName","TypeError","key","keys","has","JSON","stringify","values","isWebglEffectContainer","input","looksLikeCarbonEffectContainer","asUint8Array","EMIT_GLSL_OPTION_KEYS","EMIT_GLSL_PROFILE_KEYS","emitGlslWithOptions","dxbcBytes","profile","prototype","hasOwnProperty","call","emitter","DxbcGlslEmitter","result","Emit","pairVaryings","lightPackedTexture","applyPackedLightFixups","stageName"],"mappings":"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"}

package/dist/resource/geometry/TriGeometryRes.js

@@ -1,5 +1,5 @@
 import { ResourceRequirement } from '../ResourceRequirement.js';
-import { CjsSchema, carbon, impl, type, io } from '#schema';
+import { CjsSchema, carbon, impl, type, edit } from '#schema';
 import { box3 } from '#math/box3';
 import { triangleNormalTo } from '#math/mesh';
 import { ray3 } from '#math/ray3';
@@ -7,6 +7,7 @@ import { sph3 } from '#math/sph3';
 import { vec3 } from '#math/vec3';
 import { vec4 } from '#math/vec4';
 import { CjsResource } from '../CjsResource.js';
+import { TriStorageFlags } from '#consts/graphics';
 import { Tr2RaycastGeometryRes } from './Tr2RaycastGeometryRes.js';
 import { assertResourcePayloadObject, assertResourcePayloadArray, resourcePayloadError, resourceBoundaryError } from '../resourceBoundary.js';
 
@@ -24,8 +25,8 @@ const edgeAC = [0, 0, 0];
 
 /**
  * Resource record that owns geometry payload facts (meshes, optional
- * skeletons and animations) and LOD-force metadata, while engine packages
- * decide device buffers, vertex declarations, and draw-time state.
+ * skeletons and animations) and LOD-force metadata. Device buffers and vertex
+ * declarations are allocated through the abstraction layer.
  *
  * Geometry inspection composes the generic math supplied by the runtime global layer
  * with resource-specific payload traversal.
@@ -42,7 +43,6 @@ class TriGeometryRes extends CjsResource {
   constructor(values = null) {
     super();
     this.SetValues(values || {}, {
-      markDirty: false,
       skipUpdate: true,
       skipEvents: true
     });
@@ -77,6 +77,20 @@ class TriGeometryRes extends CjsResource {
     return this;
   }
 
+  /**
+   * Release the geometry payload, and with it anything derived from it.
+   *
+   * Carbon has no payload-only release: cpp:496-509 drops the meshes and the
+   * raycast geometry together. A manager-driven release here must do the same,
+   * or the raycaster keeps answering from meshes that are gone.
+   *
+   * @returns {TriGeometryRes} This resource.
+   */
+  ReleasePayload() {
+    this.DestroyRayCaster();
+    return super.ReleasePayload();
+  }
+
   /**
    * Get mesh count from the CPU geometry payload.
    *
@@ -401,9 +415,46 @@ class TriGeometryRes extends CjsResource {
 
   /** Reports whether the current raycast preparation session failed. */
   HasRayCasterPreparationFailed() {
+    // cpp:1597-1603. A release destroys the derived geometry without touching
+    // the session count, so an open session with nothing under it IS the
+    // failure - Carbon's own comment there reads "ReleaseResources destroyed
+    // our bvh :(".
+    if (this.#raycastUsers > 0 && !this.#raycastGeometry) return true;
     return this.#raycastPreparationFailed;
   }
 
+  /**
+   * Drop the derived raycast geometry, whether or not sessions are open.
+   *
+   * cpp:1560-1567. Carbon ignores the session count here; an open session
+   * discovers the loss through HasRayCasterPreparationFailed.
+   *
+   * @returns {TriGeometryRes} This resource.
+   */
+  DestroyRayCaster() {
+    this.#raycastGeometry = null;
+    this.#raycastPreparationFailed = false;
+    return this;
+  }
+
+  /**
+   * Release this resource's CPU geometry for the requested storage classes.
+   *
+   * cpp:496-509. Carbon also calls CancelPendingLoad, which belongs to the
+   * manager here, and SetGood(false)/SetPrepared(false), which this port
+   * expresses as the single UNLOADED state.
+   *
+   * @param {number} [storage=TriStorageFlags.TRISTORAGE_ALL] Carbon's TriStorage mask.
+   * @returns {TriGeometryRes} This resource.
+   */
+  ReleaseResources(storage = TriStorageFlags.TRISTORAGE_ALL) {
+    if (!(storage & TriStorageFlags.TRISTORAGE_MANAGEDMEMORY)) return this;
+    this.DestroyRayCaster();
+    this.ReleasePayload();
+    this.SetState(CjsResource.State.UNLOADED);
+    return this;
+  }
+
   /** Public Carbon query; requires a matching active raycast session. */
   GetIntersectionPoints(position, direction, result = {}, areaIndex = -1, rayLength = Infinity) {
     if (!this.#raycastGeometry) {
@@ -948,9 +999,9 @@ CjsSchema.define(TriGeometryRes, {
   className: "TriGeometryRes",
   family: "resources",
   fields: {
-    forceLod: [type.boolean, io.readwrite],
-    forcedLodIndex: [type.int32, io.readwrite],
-    name: [type.string, io.readwrite]
+    forceLod: [type.boolean, edit.readwrite],
+    forcedLodIndex: [type.int32, edit.readwrite],
+    name: [type.string, edit.readwrite]
   },
   methods: {
     GetMeshCount: [carbon.method, impl.adapted],
@@ -975,6 +1026,9 @@ CjsSchema.define(TriGeometryRes, {
     ResetRayCaster: [carbon.method, impl.adapted],
     IsRayCasterReady: [carbon.method, impl.adapted],
     HasRayCasterPreparationFailed: [carbon.method, impl.adapted],
+    DestroyRayCaster: [carbon.method, impl.adapted],
+    ReleaseResources: [carbon.method, impl.adapted, impl.reason("Carbon's CancelPendingLoad half is manager-owned here, and its SetGood(false)/SetPrepared(false) pair is one UNLOADED state.")],
+    ReleasePayload: [impl.custom, impl.reason("No Carbon counterpart: Carbon releases geometry only through ReleaseResources. The override exists so a manager-driven payload release cannot leave a raycaster built from the freed meshes behind.")],
     GetIntersectionPoints: [carbon.method, impl.adapted],
     GetMeshVertexElements: [carbon.method, impl.adapted],
     SaveMesh: [carbon.method, impl.notSupported]