@carbonenginejs/runtime-resource 0.12.2 → 0.13.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -21
- package/NOTICE +32 -32
- package/README.md +129 -108
- package/dist/CjsMotherLode.js +1271 -1271
- package/dist/CjsResMan.js +3858 -3494
- package/dist/CjsResMan.js.map +1 -1
- package/dist/CjsResManFetchProvider.js +94 -94
- package/dist/CjsResManWorkQueue.js +301 -301
- package/dist/_virtual/_rollupPluginBabelHelpers.js +150 -150
- package/dist/format/CjsBlueReader.js +358 -358
- package/dist/format/CjsByteReader.js +310 -310
- package/dist/format/CjsByteWriter.js +242 -242
- package/dist/format/CjsFormat.js +223 -223
- package/dist/format/CjsFormatError.js +41 -41
- package/dist/format/CjsReader.js +22 -22
- package/dist/format/CjsResourceProbe.js +279 -279
- package/dist/format/CjsStringTable.js +268 -268
- package/dist/format/carbonEffect/CjsCarbonEffectReader.js +408 -361
- package/dist/format/carbonEffect/CjsCarbonEffectReader.js.map +1 -1
- package/dist/format/carbonEffect/CjsCarbonEffectWriter.js +373 -373
- package/dist/format/carbonEffect/buildCarbonEffectContainer.js +182 -0
- package/dist/format/carbonEffect/buildCarbonEffectContainer.js.map +1 -0
- package/dist/format/carbonEffect/carbonEffectBackendBlock.js +321 -427
- package/dist/format/carbonEffect/carbonEffectBackendBlock.js.map +1 -1
- package/dist/format/carbonEffect/carbonEffectRecords.js +1147 -955
- package/dist/format/carbonEffect/carbonEffectRecords.js.map +1 -1
- package/dist/format/carbonEffect/carbonEffectResourceTransform.js +197 -0
- package/dist/format/carbonEffect/carbonEffectResourceTransform.js.map +1 -0
- package/dist/format/compareUtf8.js +36 -36
- package/dist/format/effect/effectBodyInventory.js +146 -0
- package/dist/format/effect/effectBodyInventory.js.map +1 -0
- package/dist/format/effect/effectPermutationGraph.js +257 -257
- package/dist/format/effect/effectPermutationGraph.js.map +1 -1
- package/dist/format/effect/sha256.js +114 -114
- package/dist/format/index.js +11 -11
- package/dist/format/payloadContract.js +193 -193
- package/dist/formats/black/CjsBlackFormat.js +310 -292
- package/dist/formats/black/CjsBlackFormat.js.map +1 -1
- package/dist/formats/black/core/CjsBlackBinaryReader.js +260 -260
- package/dist/formats/black/core/CjsBlackPropertyReaders.js +448 -448
- package/dist/formats/black/core/CjsBlackReader.js +764 -764
- package/dist/formats/black/core/CjsBlackSchemaRegistry.js +540 -540
- package/dist/formats/black/core/black-schema-v1-2026-07-23.json.js +4 -4
- package/dist/formats/black/core/blackConstants.js +7 -7
- package/dist/formats/black/core/blackDefinitions.js +10 -10
- package/dist/formats/black/core/blackEnums.js +6 -6
- package/dist/formats/black/core/blackSchema.js +3 -3
- package/dist/formats/black/core/blackVersion.js +22 -22
- package/dist/formats/black/core/helpers.js +199 -199
- package/dist/formats/black/core/schema.js +4 -4
- package/dist/formats/black/index.js +2 -2
- package/dist/formats/bnk/CjsBnkFormat.js +175 -156
- package/dist/formats/bnk/CjsBnkFormat.js.map +1 -1
- package/dist/formats/bnk/core/busNodes.js +252 -0
- package/dist/formats/bnk/core/busNodes.js.map +1 -0
- package/dist/formats/bnk/core/effectNodes.js +147 -0
- package/dist/formats/bnk/core/effectNodes.js.map +1 -0
- package/dist/formats/bnk/core/eventAction.js +416 -305
- package/dist/formats/bnk/core/eventAction.js.map +1 -1
- package/dist/formats/bnk/core/globalSettings.js +215 -0
- package/dist/formats/bnk/core/globalSettings.js.map +1 -0
- package/dist/formats/bnk/core/graph.js +137 -137
- package/dist/formats/bnk/core/helpers.js +512 -480
- package/dist/formats/bnk/core/helpers.js.map +1 -1
- package/dist/formats/bnk/core/musicNodes.js +533 -509
- package/dist/formats/bnk/core/musicNodes.js.map +1 -1
- package/dist/formats/bnk/core/nodeBase.js +553 -532
- package/dist/formats/bnk/core/nodeBase.js.map +1 -1
- package/dist/formats/bnk/core/sfxNodes.js +632 -632
- package/dist/formats/bnk/core/soundbanksInfo.js +209 -209
- package/dist/formats/bnk/index.js +2 -2
- package/dist/formats/cmf/CjsCmfFormat.js +497 -497
- package/dist/formats/cmf/core/binary.js +194 -194
- package/dist/formats/cmf/core/buffers.js +237 -237
- package/dist/formats/cmf/core/constants.js +47 -47
- package/dist/formats/cmf/core/gr2Anim.js +453 -453
- package/dist/formats/cmf/core/helpers.js +318 -318
- package/dist/formats/cmf/core/pack.js +276 -276
- package/dist/formats/cmf/core/schema.js +374 -374
- package/dist/formats/cmf/core/shared.js +277 -277
- package/dist/formats/cmf/core/writer.js +571 -571
- package/dist/formats/cmf/index.js +2 -2
- package/dist/formats/dds/CjsDdsFormat.js +200 -200
- package/dist/formats/dds/core/bc6h.js +298 -298
- package/dist/formats/dds/core/bc7.js +272 -272
- package/dist/formats/dds/core/helpers.js +862 -862
- package/dist/formats/dds/index.js +2 -2
- package/dist/formats/dxbc/CjsDxbcFormat.js +142 -142
- package/dist/formats/dxbc/core/DxbcReader.js +266 -266
- package/dist/formats/dxbc/core/container.js +169 -169
- package/dist/formats/dxbc/core/decoder.js +789 -789
- package/dist/formats/dxbc/core/errors.js +19 -19
- package/dist/formats/dxbc/core/helpers.js +220 -220
- package/dist/formats/dxbc/core/opcodes.js +45 -45
- package/dist/formats/dxbc/core/program.js +91 -91
- package/dist/formats/dxbc/core/signature.js +172 -172
- package/dist/formats/dxbc/index.js +2 -2
- package/dist/formats/fbx/CjsFbxFormat.js +266 -266
- package/dist/formats/fbx/core/helpers.js +3932 -3932
- package/dist/formats/fbx/index.js +2 -2
- package/dist/formats/flac/CjsFlacFormat.js +142 -142
- package/dist/formats/flac/core/helpers.js +315 -315
- package/dist/formats/flac/index.js +2 -2
- package/dist/formats/gif/CjsGifFormat.js +141 -141
- package/dist/formats/gif/core/helpers.js +380 -380
- package/dist/formats/gif/index.js +2 -2
- package/dist/formats/gltf/CjsGltfFormat.js +290 -290
- package/dist/formats/gltf/core/helpers.js +307 -307
- package/dist/formats/gltf/core/json.js +79 -79
- package/dist/formats/gltf/core/parser.js +679 -679
- package/dist/formats/gltf/core/targets.js +173 -173
- package/dist/formats/gltf/index.js +2 -2
- package/dist/formats/gr2/CjsGr2Format.js +289 -289
- package/dist/formats/gr2/core/bitknit2.js +282 -282
- package/dist/formats/gr2/core/curves.js +1047 -1047
- package/dist/formats/gr2/core/gsf.js +72 -72
- package/dist/formats/gr2/core/helpers.js +352 -352
- package/dist/formats/gr2/core/json.js +622 -622
- package/dist/formats/gr2/core/oodle1.js +388 -388
- package/dist/formats/gr2/core/tangents.js +48 -48
- package/dist/formats/gr2/core/targets.js +361 -361
- package/dist/formats/gr2/index.js +2 -2
- package/dist/formats/hlsl/CjsHlslFormat.js +254 -254
- package/dist/formats/hlsl/core/HlslBinaryUtils.js +15 -15
- package/dist/formats/hlsl/core/HlslEffectReadError.js +19 -19
- package/dist/formats/hlsl/core/HlslEffectStateManager.js +130 -130
- package/dist/formats/hlsl/core/HlslRenderStateSetup.js +37 -37
- package/dist/formats/hlsl/core/HlslResourceSetDescription.js +94 -94
- package/dist/formats/hlsl/core/HlslShaderBytecode.js +44 -44
- package/dist/formats/hlsl/core/analysis.js +51 -51
- package/dist/formats/hlsl/core/carbonDescriptionToRuntime.js +850 -781
- package/dist/formats/hlsl/core/carbonDescriptionToRuntime.js.map +1 -1
- package/dist/formats/hlsl/core/detailMapFamily.js +128 -0
- package/dist/formats/hlsl/core/detailMapFamily.js.map +1 -0
- package/dist/formats/hlsl/core/helpers.js +270 -270
- package/dist/formats/hlsl/core/json.js +284 -284
- package/dist/formats/hlsl/core/localLightFamily.js +133 -0
- package/dist/formats/hlsl/core/localLightFamily.js.map +1 -0
- package/dist/formats/hlsl/core/metadata.js +327 -327
- package/dist/formats/hlsl/core/render-states.js +280 -280
- package/dist/formats/hlsl/core/tr2/HlslRenderContextEnum.js +43 -43
- package/dist/formats/hlsl/core/tr2/resources/HlslEffectRes.js +320 -314
- package/dist/formats/hlsl/core/tr2/resources/HlslEffectRes.js.map +1 -1
- package/dist/formats/hlsl/core/tr2/resources/HlslShaderPermutation.js +33 -33
- package/dist/formats/hlsl/core/tr2/shader/HlslEffectBindingManifest.js +416 -416
- package/dist/formats/hlsl/core/tr2/shader/HlslEffectConstant.js +40 -40
- package/dist/formats/hlsl/core/tr2/shader/HlslEffectDescription.js +62 -742
- package/dist/formats/hlsl/core/tr2/shader/HlslEffectDescription.js.map +1 -1
- package/dist/formats/hlsl/core/tr2/shader/HlslEffectLibrary.js +52 -52
- package/dist/formats/hlsl/core/tr2/shader/HlslEffectParameterAnnotation.js +38 -38
- package/dist/formats/hlsl/core/tr2/shader/HlslEffectResource.js +50 -50
- package/dist/formats/hlsl/core/tr2/shader/HlslEffectStageInput.js +86 -86
- package/dist/formats/hlsl/core/tr2/shader/HlslEffectTechnique.js +31 -31
- package/dist/formats/hlsl/core/tr2/shader/HlslPass.js +42 -42
- package/dist/formats/hlsl/core/tr2/shader/HlslSamplerDescription.js +55 -55
- package/dist/formats/hlsl/core/tr2/shader/HlslSamplerSetup.js +29 -29
- package/dist/formats/hlsl/core/tr2/shader/HlslShader.js +220 -220
- package/dist/formats/hlsl/core/tr2/shader/HlslShaderOption.js +30 -30
- package/dist/formats/hlsl/index.js +3 -3
- package/dist/formats/index.js +33 -31
- package/dist/formats/index.js.map +1 -1
- package/dist/formats/jpeg/CjsJpegFormat.js +212 -212
- package/dist/formats/jpeg/core/helpers.js +402 -402
- package/dist/formats/jpeg/core/jpeg.js +480 -480
- package/dist/formats/jpeg/index.js +2 -2
- package/dist/formats/mp3/CjsMp3Format.js +197 -197
- package/dist/formats/mp3/core/helpers.js +375 -375
- package/dist/formats/mp3/index.js +2 -2
- package/dist/formats/mp4/CjsMp4Format.js +197 -197
- package/dist/formats/mp4/core/helpers.js +484 -484
- package/dist/formats/mp4/index.js +2 -2
- package/dist/formats/obj/CjsObjFormat.js +253 -253
- package/dist/formats/obj/core/helpers.js +573 -573
- package/dist/formats/obj/core/json.js +64 -64
- package/dist/formats/obj/core/parser.js +321 -321
- package/dist/formats/obj/index.js +2 -2
- package/dist/formats/ogg/CjsOggFormat.js +143 -143
- package/dist/formats/ogg/core/helpers.js +410 -410
- package/dist/formats/ogg/core/imdct.js +178 -178
- package/dist/formats/ogg/core/vorbis.js +1017 -1017
- package/dist/formats/ogg/index.js +2 -2
- package/dist/formats/pickle/CjsPickleFormat.js +214 -0
- package/dist/formats/pickle/CjsPickleFormat.js.map +1 -0
- package/dist/formats/pickle/core/CjsPickleProtocol0Reader.js +551 -0
- package/dist/formats/pickle/core/CjsPickleProtocol0Reader.js.map +1 -0
- package/dist/formats/pickle/index.js +2 -0
- package/dist/formats/pickle/index.js.map +1 -0
- package/dist/formats/png/CjsPngFormat.js +201 -201
- package/dist/formats/png/core/helpers.js +635 -635
- package/dist/formats/png/index.js +2 -2
- package/dist/formats/red/CjsRedFormat.js +263 -263
- package/dist/formats/red/core/CjsRedReader.js +246 -246
- package/dist/formats/red/core/blackDefinitions.js +3 -3
- package/dist/formats/red/core/helpers.js +158 -158
- package/dist/formats/red/core/redGraph.js +71 -68
- package/dist/formats/red/core/redGraph.js.map +1 -1
- package/dist/formats/red/core/schema.js +4 -4
- package/dist/formats/red/index.js +2 -2
- package/dist/formats/stl/CjsStlFormat.js +365 -365
- package/dist/formats/stl/core/helpers.js +261 -261
- package/dist/formats/stl/core/json.js +51 -51
- package/dist/formats/stl/core/stl.js +642 -642
- package/dist/formats/stl/core/targets.js +173 -173
- package/dist/formats/stl/index.js +2 -2
- package/dist/formats/tga/CjsTgaFormat.js +197 -197
- package/dist/formats/tga/core/helpers.js +493 -493
- package/dist/formats/tga/index.js +2 -2
- package/dist/formats/wav/CjsWavFormat.js +198 -198
- package/dist/formats/wav/core/helpers.js +365 -365
- package/dist/formats/wav/index.js +2 -2
- package/dist/formats/webgl/CjsWebglFormat.js +199 -221
- package/dist/formats/webgl/CjsWebglFormat.js.map +1 -1
- package/dist/formats/webgl/core/buildGlslEffectContainer.js +70 -0
- package/dist/formats/webgl/core/buildGlslEffectContainer.js.map +1 -0
- package/dist/formats/webgl/core/effectPackage.js +900 -792
- package/dist/formats/webgl/core/effectPackage.js.map +1 -1
- package/dist/formats/webgl/core/errors.js +27 -27
- package/dist/formats/webgl/core/errors.js.map +1 -1
- package/dist/formats/webgl/core/glsl/DxbcGlslEmitter.js +2820 -2678
- package/dist/formats/webgl/core/glsl/DxbcGlslEmitter.js.map +1 -1
- package/dist/formats/webgl/core/glsl/DxbcGlslHelpers.js +89 -89
- package/dist/formats/webgl/core/glsl/DxbcGlslOperandFormatter.js +486 -428
- package/dist/formats/webgl/core/glsl/DxbcGlslOperandFormatter.js.map +1 -1
- package/dist/formats/webgl/core/glsl/packedLightFixups.js +98 -0
- package/dist/formats/webgl/core/glsl/packedLightFixups.js.map +1 -0
- package/dist/formats/webgl/core/glslBackendBlock.js +552 -0
- package/dist/formats/webgl/core/glslBackendBlock.js.map +1 -0
- package/dist/formats/webgl/core/glslBackendBodySet.js +243 -0
- package/dist/formats/webgl/core/glslBackendBodySet.js.map +1 -0
- package/dist/formats/webgl/core/{cewgCompleteness.js → glslEffectCompleteness.js} +85 -81
- package/dist/formats/webgl/core/glslEffectCompleteness.js.map +1 -0
- package/dist/formats/webgl/core/helpers.js +167 -306
- package/dist/formats/webgl/core/helpers.js.map +1 -1
- package/dist/formats/webgl/core/inspectGlslEffectContainer.js +122 -0
- package/dist/formats/webgl/core/inspectGlslEffectContainer.js.map +1 -0
- package/dist/formats/webgl/core/readGlslEffectContainer.js +303 -0
- package/dist/formats/webgl/core/readGlslEffectContainer.js.map +1 -0
- package/dist/formats/webgl/index.js +2 -2
- package/dist/formats/webgpu/CjsWebgpuFormat.js +357 -357
- package/dist/formats/webgpu/CjsWebgpuFormat.js.map +1 -1
- package/dist/formats/webgpu/core/buildCarbonEffectContainer.js +89 -197
- package/dist/formats/webgpu/core/buildCarbonEffectContainer.js.map +1 -1
- package/dist/formats/webgpu/core/{cewgpu/CewgpuContainer.js → carbonWebgpu/CarbonWebgpuContainer.js} +354 -368
- package/dist/formats/webgpu/core/carbonWebgpu/CarbonWebgpuContainer.js.map +1 -0
- package/dist/formats/webgpu/core/{cewgpu → carbonWebgpu}/containerViews.js +355 -355
- package/dist/formats/webgpu/core/carbonWebgpu/containerViews.js.map +1 -0
- package/dist/formats/webgpu/core/{cewgpu → carbonWebgpu}/validateContainer.js +90 -90
- package/dist/formats/webgpu/core/carbonWebgpu/validateContainer.js.map +1 -0
- package/dist/formats/webgpu/core/effectAnalysis.js +82 -82
- package/dist/formats/webgpu/core/effectBackendBodySet.js +289 -289
- package/dist/formats/webgpu/core/effectBackendBodySet.js.map +1 -1
- package/dist/formats/webgpu/core/errors.js +20 -20
- package/dist/formats/webgpu/core/errors.js.map +1 -1
- package/dist/formats/webgpu/core/helpers.js +443 -443
- package/dist/formats/webgpu/core/helpers.js.map +1 -1
- package/dist/formats/webgpu/core/ir/analyzeRegisterValues.js +212 -212
- package/dist/formats/webgpu/core/ir/buildControlFlow.js +220 -220
- package/dist/formats/webgpu/core/ir/indexableTemps.js +137 -137
- package/dist/formats/webgpu/core/ir/inferValueTypes.js +449 -449
- package/dist/formats/webgpu/core/ir/lowerDxbcToIr.js +494 -494
- package/dist/formats/webgpu/core/ir/resolveRegisterFlow.js +177 -177
- package/dist/formats/webgpu/core/ir/sourceLanes.js +61 -61
- package/dist/formats/webgpu/core/packageEffect.js +381 -385
- package/dist/formats/webgpu/core/packageEffect.js.map +1 -1
- package/dist/formats/webgpu/core/packageEffectSelection.js +164 -164
- package/dist/formats/webgpu/core/packageEffectSelection.js.map +1 -1
- package/dist/formats/webgpu/core/packageMetadata.js +17 -17
- package/dist/formats/webgpu/core/schema.js +4 -4
- package/dist/formats/webgpu/core/wgsl/buildResourceTransformPlan.js +263 -263
- package/dist/formats/webgpu/core/wgsl/buildResourceTransformPlan.js.map +1 -1
- package/dist/formats/webgpu/core/wgsl/buildWgslBindingPlan.js +172 -172
- package/dist/formats/webgpu/core/wgsl/buildWgslSet.js +320 -320
- package/dist/formats/webgpu/core/wgsl/buildWgslSet.js.map +1 -1
- package/dist/formats/webgpu/core/wgsl/emitWgsl.js +356 -356
- package/dist/formats/webgpu/core/wgsl/hoistEscapingValues.js +77 -77
- package/dist/formats/webgpu/core/wgsl/lowerBindingLayout.js +451 -451
- package/dist/formats/webgpu/core/wgsl/lowerComputeProgram.js +735 -735
- package/dist/formats/webgpu/core/wgsl/lowerCreateHistogramsComputeProgram.js +457 -457
- package/dist/formats/webgpu/core/wgsl/lowerFragmentProgram.js +1572 -1572
- package/dist/formats/webgpu/core/wgsl/lowerMergeHistogramsComputeProgram.js +659 -659
- package/dist/formats/webgpu/core/wgsl/lowerParticleClearComputePrograms.js +734 -734
- package/dist/formats/webgpu/core/wgsl/lowerParticleEmitComputeProgram.js +583 -583
- package/dist/formats/webgpu/core/wgsl/lowerSkinVerticesComputeProgram.js +621 -621
- package/dist/formats/webgpu/core/wgsl/lowerSortComputeProgram.js +824 -824
- package/dist/formats/webgpu/core/wgsl/lowerSortInnerComputeProgram.js +697 -697
- package/dist/formats/webgpu/core/wgsl/lowerSortStepComputeProgram.js +559 -559
- package/dist/formats/webgpu/core/wgsl/lowerVertexProgram.js +1328 -1328
- package/dist/formats/webgpu/core/wgsl/particleEmitSemanticDigest.js +110 -110
- package/dist/formats/webgpu/core/wgsl/precisionControls.js +55 -55
- package/dist/formats/webgpu/core/wgsl/selectionPlans.js +717 -717
- package/dist/formats/webgpu/core/wgsl/uniformity.js +78 -78
- package/dist/formats/webgpu/core/wgsl/validateExactComputeIr.js +196 -196
- package/dist/formats/webgpu/core/wgsl/validateHandleOperand.js +37 -37
- package/dist/formats/webgpu/index.js +2 -2
- package/dist/formats/webm/CjsWebmFormat.js +197 -197
- package/dist/formats/webm/core/helpers.js +572 -572
- package/dist/formats/webm/index.js +2 -2
- package/dist/formats/webp/CjsWebpFormat.js +140 -140
- package/dist/formats/webp/core/helpers.js +237 -237
- package/dist/formats/webp/index.js +2 -2
- package/dist/formats/wem/CjsWemFormat.js +250 -250
- package/dist/formats/wem/core/bitStream.js +261 -261
- package/dist/formats/wem/core/codebookLibrary.js +164 -164
- package/dist/formats/wem/core/helpers.js +437 -437
- package/dist/formats/wem/core/packedCodebooksAotuv603.js +30 -30
- package/dist/formats/wem/core/ptadpcm.js +77 -77
- package/dist/formats/wem/core/resolve.js +121 -121
- package/dist/formats/wem/core/wemToOgg.js +485 -485
- package/dist/formats/wem/index.js +2 -2
- package/dist/formats/yaml/CjsYamlFormat.js +134 -134
- package/dist/formats/yaml/CjsYamlFormat.js.map +1 -1
- package/dist/formats/yaml/core/CjsYamlReader.js +400 -402
- package/dist/formats/yaml/core/CjsYamlReader.js.map +1 -1
- package/dist/formats/yaml/core/helpers.js +196 -170
- package/dist/formats/yaml/core/helpers.js.map +1 -1
- package/dist/formats/yaml/index.js +2 -2
- package/dist/index.js +64 -62
- package/dist/index.js.map +1 -1
- package/dist/resource/CjsLoadingObject.js +19 -0
- package/dist/resource/CjsLoadingObject.js.map +1 -0
- package/dist/resource/CjsResource.js +801 -797
- package/dist/resource/CjsResource.js.map +1 -1
- package/dist/resource/ResourceHandlerMode.js +14 -0
- package/dist/resource/ResourceHandlerMode.js.map +1 -0
- package/dist/resource/Tr2LightProfileRes.js +32 -32
- package/dist/resource/audio/AudioGeometryResData.js +47 -47
- package/dist/resource/audio/CjsAudioBufferRes.js +86 -86
- package/dist/resource/audio/CjsAudioRes.js +213 -213
- package/dist/resource/audio/index.js +4 -4
- package/dist/resource/geometry/MeshDecalData.js +37 -37
- package/dist/resource/geometry/MeshDecalLodData.js +34 -34
- package/dist/resource/geometry/TriGeometryRes.js +675 -675
- package/dist/resource/geometry/TriGeometryResAreaData.js +59 -59
- package/dist/resource/geometry/TriGeometryResJointData.js +38 -38
- package/dist/resource/geometry/TriGeometryResLodData.js +88 -88
- package/dist/resource/geometry/TriGeometryResMeshData.js +63 -63
- package/dist/resource/geometry/TriGeometryResSkeletonData.js +34 -34
- package/dist/resource/geometry/TriJointBinding.js +38 -38
- package/dist/resource/geometry/TriMorphTargetGeometryConstants.js +46 -46
- package/dist/resource/geometry/TriRtGeometryConstants.js +88 -88
- package/dist/resource/geometry/granny/GStateBindingCallbackData.js +31 -31
- package/dist/resource/geometry/granny/Tr2GrannyIntersectionResult.js +60 -60
- package/dist/resource/geometry/granny/Tr2GrannyStateRes.js +36 -36
- package/dist/resource/geometry/granny/TriGrannyRes.js +35 -35
- package/dist/resource/geometry/granny/enums.js +10 -10
- package/dist/resource/geometry/granny/index.js +6 -6
- package/dist/resource/geometry/index.js +17 -17
- package/dist/resource/index.js +54 -52
- package/dist/resource/index.js.map +1 -1
- package/dist/resource/resourceBoundary.js +64 -64
- package/dist/resource/shader/Tr2EffectRes.js +336 -431
- package/dist/resource/shader/Tr2EffectRes.js.map +1 -1
- package/dist/resource/shader/Tr2MaterialArea.js +31 -31
- package/dist/resource/shader/Tr2MaterialMesh.js +27 -27
- package/dist/resource/shader/Tr2MaterialRes.js +31 -31
- package/dist/resource/shader/Tr2Shader.js +283 -261
- package/dist/resource/shader/Tr2Shader.js.map +1 -1
- package/dist/resource/shader/Tr2ShaderPermutation.js +43 -43
- package/dist/resource/shader/index.js +17 -17
- package/dist/resource/shader/reflection/Tr2EffectConstant.js +143 -135
- package/dist/resource/shader/reflection/Tr2EffectConstant.js.map +1 -1
- package/dist/resource/shader/reflection/Tr2EffectDefine.js +30 -30
- package/dist/resource/shader/reflection/Tr2EffectDescription.js +114 -109
- package/dist/resource/shader/reflection/Tr2EffectDescription.js.map +1 -1
- package/dist/resource/shader/reflection/Tr2EffectLibrary.js +168 -147
- package/dist/resource/shader/reflection/Tr2EffectLibrary.js.map +1 -1
- package/dist/resource/shader/reflection/Tr2EffectParameterAnnotation.js +125 -105
- package/dist/resource/shader/reflection/Tr2EffectParameterAnnotation.js.map +1 -1
- package/dist/resource/shader/reflection/Tr2EffectResource.js +120 -86
- package/dist/resource/shader/reflection/Tr2EffectResource.js.map +1 -1
- package/dist/resource/shader/reflection/Tr2EffectStageInput.js +372 -241
- package/dist/resource/shader/reflection/Tr2EffectStageInput.js.map +1 -1
- package/dist/resource/shader/reflection/Tr2EffectTechnique.js +78 -68
- package/dist/resource/shader/reflection/Tr2EffectTechnique.js.map +1 -1
- package/dist/resource/shader/reflection/Tr2Pass.js +168 -111
- package/dist/resource/shader/reflection/Tr2Pass.js.map +1 -1
- package/dist/resource/shader/reflection/carbonRecordFields.js +159 -0
- package/dist/resource/shader/reflection/carbonRecordFields.js.map +1 -0
- package/dist/resource/shader/reflection/shaderStage.js +22 -0
- package/dist/resource/shader/reflection/shaderStage.js.map +1 -0
- package/dist/resource/shader/sampler/Tr2SamplerSetup.js +135 -77
- package/dist/resource/shader/sampler/Tr2SamplerSetup.js.map +1 -1
- package/dist/resource/texture/CjsTextureArrayRes.js +472 -472
- package/dist/resource/texture/CjsTextureArrayResParameterProxy.js +179 -179
- package/dist/resource/texture/Tr2ImageRes.js +120 -120
- package/dist/resource/texture/Tr2TextureLodManager.js +82 -82
- package/dist/resource/texture/Tr2TextureLodUpdateRequest.js +37 -37
- package/dist/resource/texture/Tr2TexturePackChannel.js +37 -37
- package/dist/resource/texture/Tr2TexturePipeline.js +54 -54
- package/dist/resource/texture/Tr2TexturePipelineParams.js +34 -34
- package/dist/resource/texture/Tr2TexturePipelineStepCompress.js +40 -40
- package/dist/resource/texture/Tr2TexturePipelineStepGenerateMips.js +22 -22
- package/dist/resource/texture/Tr2TexturePipelineStepLimitSize.js +34 -34
- package/dist/resource/texture/Tr2TexturePipelineStepLoad.js +31 -31
- package/dist/resource/texture/Tr2TexturePipelineStepPack.js +43 -43
- package/dist/resource/texture/TriTextureRes.js +359 -359
- package/dist/resource/texture/index.js +15 -15
- package/dist/resource/texture/texturePipelineBehavior.js +308 -308
- package/dist/worker/CjsResManMainThreadLoader.js +89 -87
- package/dist/worker/CjsResManMainThreadLoader.js.map +1 -1
- package/dist/worker/CjsResManWorker.js +218 -217
- package/dist/worker/CjsResManWorker.js.map +1 -1
- package/dist/worker/CjsResManWorkerLoader.js +437 -434
- package/dist/worker/CjsResManWorkerLoader.js.map +1 -1
- package/dist/worker/protocol.js +12 -12
- package/docs/README.md +98 -98
- package/docs/architecture.md +118 -109
- package/docs/concepts/resource-lifecycle.md +226 -225
- package/docs/concepts/shader-resource-model.md +111 -114
- package/docs/concepts/writing-an-engine-adapter.md +115 -115
- package/docs/formats/README.md +138 -136
- package/docs/formats/carbon-effect-container.md +553 -452
- package/docs/formats/dxbc/README.md +68 -68
- package/docs/formats/dxbc/architecture.md +80 -80
- package/docs/formats/dxbc/reference/api.md +77 -77
- package/docs/formats/dxbc/reference/classes/README.md +9 -9
- package/docs/formats/dxbc/reference/decoded-output.md +122 -122
- package/docs/formats/gr2.md +160 -160
- package/docs/formats/hlsl/README.md +54 -54
- package/docs/formats/hlsl/architecture.md +65 -67
- package/docs/formats/hlsl/guides/hydrating-json-output.md +60 -62
- package/docs/formats/hlsl/guides/reading-effects.md +64 -64
- package/docs/formats/hlsl/reference/advanced-analysis.md +61 -66
- package/docs/formats/hlsl/reference/api.md +92 -98
- package/docs/formats/hlsl/reference/classes/README.md +11 -11
- package/docs/formats/hlsl/reference/json-graph.md +97 -100
- package/docs/formats/pickle.md +82 -0
- package/docs/formats/provenance.md +196 -196
- package/docs/formats/stl.md +37 -37
- package/docs/formats/webgl/README.md +115 -57
- package/docs/formats/webgl/architecture.md +69 -70
- package/docs/formats/webgl/carbon-constant-layouts.md +326 -326
- package/docs/formats/webgl/decl-io.md +1234 -1234
- package/docs/formats/webgl/memory-structured.md +890 -871
- package/docs/formats/webgl/reference/classes/README.md +9 -9
- package/docs/formats/webgl/texture-sample.md +964 -964
- package/docs/formats/webgpu/README.md +84 -84
- package/docs/formats/webgpu/architecture.md +95 -96
- package/docs/formats/webgpu/formats/{cewgpu.md → carbon-webgpu.md} +215 -216
- package/docs/formats/webgpu/guides/effect-packaging.md +189 -191
- package/docs/formats/webgpu/reference/api.md +196 -197
- package/docs/formats/webgpu/reference/classes/README.md +9 -9
- package/docs/formats/webgpu/reference/wgsl-compatibility.md +1546 -1543
- package/docs/formats/wwise.md +146 -85
- package/docs/reference/classes/README.md +35 -35
- package/docs/reference/classes/audio.md +30 -30
- package/docs/reference/classes/core.md +216 -206
- package/docs/reference/classes/dropped.md +46 -46
- package/docs/reference/classes/formats.md +944 -952
- package/docs/reference/classes/resources.md +456 -456
- package/docs/reference/classes/texture.md +26 -26
- package/docs/reference/events.md +117 -117
- package/docs/reference/motherlode-cache.md +275 -275
- package/docs/reference/queues.md +194 -110
- package/docs/reference/reload.md +107 -107
- package/docs/reference/texture-arrays.md +113 -113
- package/docs/reference/texture-pipeline.md +53 -53
- package/docs/reference/workers.md +142 -135
- package/docs/roadmap.md +150 -150
- package/format-notices/black/LICENSE +21 -21
- package/format-notices/black/NOTICE +47 -47
- package/format-notices/bnk/LICENSE +21 -21
- package/format-notices/bnk/NOTICE +21 -21
- package/format-notices/cmf/LICENSE +21 -21
- package/format-notices/cmf/NOTICE +36 -36
- package/format-notices/dds/LICENSE +21 -21
- package/format-notices/dds/NOTICE +14 -14
- package/format-notices/dxbc/LICENSE +21 -21
- package/format-notices/dxbc/NOTICE +20 -20
- package/format-notices/fbx/LICENSE +21 -21
- package/format-notices/fbx/NOTICE +14 -14
- package/format-notices/flac/LICENSE +21 -21
- package/format-notices/flac/NOTICE +14 -14
- package/format-notices/gif/LICENSE +21 -21
- package/format-notices/gif/NOTICE +14 -14
- package/format-notices/gltf/LICENSE +21 -21
- package/format-notices/gltf/NOTICE +27 -27
- package/format-notices/gr2/LICENSE +21 -21
- package/format-notices/gr2/NOTICE +60 -60
- package/format-notices/gr2/THIRD-PARTY-NOTICES.md +93 -93
- package/format-notices/hlsl/LICENSE +21 -21
- package/format-notices/hlsl/NOTICE +25 -25
- package/format-notices/jpeg/LICENSE +21 -21
- package/format-notices/jpeg/NOTICE +14 -14
- package/format-notices/mp3/LICENSE +21 -21
- package/format-notices/mp3/NOTICE +14 -14
- package/format-notices/mp4/LICENSE +21 -21
- package/format-notices/mp4/NOTICE +14 -14
- package/format-notices/obj/LICENSE +21 -21
- package/format-notices/obj/NOTICE +26 -26
- package/format-notices/ogg/LICENSE +21 -21
- package/format-notices/ogg/NOTICE +28 -28
- package/format-notices/png/LICENSE +21 -21
- package/format-notices/png/NOTICE +14 -14
- package/format-notices/red/LICENSE +21 -21
- package/format-notices/red/NOTICE +31 -31
- package/format-notices/stl/LICENSE +21 -21
- package/format-notices/stl/NOTICE +21 -21
- package/format-notices/tga/LICENSE +21 -21
- package/format-notices/tga/NOTICE +14 -14
- package/format-notices/wav/LICENSE +21 -21
- package/format-notices/wav/NOTICE +14 -14
- package/format-notices/webgl/LICENSE +21 -21
- package/format-notices/webgl/NOTICE +35 -35
- package/format-notices/webgpu/LICENSE +21 -21
- package/format-notices/webgpu/NOTICE +31 -31
- package/format-notices/webm/LICENSE +21 -21
- package/format-notices/webm/NOTICE +14 -14
- package/format-notices/webp/LICENSE +21 -21
- package/format-notices/webp/NOTICE +14 -14
- package/format-notices/wem/LICENSE +57 -57
- package/format-notices/wem/NOTICE +33 -33
- package/format-notices/yaml/LICENSE +21 -21
- package/format-notices/yaml/NOTICE +44 -44
- package/package.json +63 -63
- package/dist/format/carbonEffect/carbonDescriptionFromPortable.js +0 -372
- package/dist/format/carbonEffect/carbonDescriptionFromPortable.js.map +0 -1
- package/dist/format/effect/effectReflectionPackage.js +0 -636
- package/dist/format/effect/effectReflectionPackage.js.map +0 -1
- package/dist/formats/hlsl/core/HlslReader.js +0 -16
- package/dist/formats/hlsl/core/HlslReader.js.map +0 -1
- package/dist/formats/hlsl/core/portableReflection.js +0 -848
- package/dist/formats/hlsl/core/portableReflection.js.map +0 -1
- package/dist/formats/hlsl/portable.js +0 -2
- package/dist/formats/hlsl/portable.js.map +0 -1
- package/dist/formats/webgl/core/cewg/CewgPackage.js +0 -340
- package/dist/formats/webgl/core/cewg/CewgPackage.js.map +0 -1
- package/dist/formats/webgl/core/cewg/CewgPackageBuilder.js +0 -104
- package/dist/formats/webgl/core/cewg/CewgPackageBuilder.js.map +0 -1
- package/dist/formats/webgl/core/cewg/binary.js +0 -19
- package/dist/formats/webgl/core/cewg/binary.js.map +0 -1
- package/dist/formats/webgl/core/cewgCompleteness.js.map +0 -1
- package/dist/formats/webgl/core/effectPackageValidation.js +0 -331
- package/dist/formats/webgl/core/effectPackageValidation.js.map +0 -1
- package/dist/formats/webgpu/core/cewgpu/CewgpuContainer.js.map +0 -1
- package/dist/formats/webgpu/core/cewgpu/containerViews.js.map +0 -1
- package/dist/formats/webgpu/core/cewgpu/validateContainer.js.map +0 -1
- package/dist/resource/shader/portable.js +0 -33
- package/dist/resource/shader/portable.js.map +0 -1
- package/docs/formats/hlsl/reference/portable-reflection.md +0 -141
- package/docs/formats/webgl/effect-reflection.md +0 -127
|
@@ -0,0 +1,243 @@
|
|
|
1
|
+
import { detailMapTransformFor } from '../../hlsl/core/detailMapFamily.js';
|
|
2
|
+
import { localLightProfileNeutralTransformFor } from '../../hlsl/core/localLightFamily.js';
|
|
3
|
+
|
|
4
|
+
/**
|
|
5
|
+
* Reshapes translated GLSL into the backend body set the Carbon container
|
|
6
|
+
* writer consumes.
|
|
7
|
+
*
|
|
8
|
+
* This is the WebGL counterpart of `formats/webgpu/core/effectBackendBodySet.js`
|
|
9
|
+
* and deliberately emits the same envelope, because `buildCarbonEffectContainer`
|
|
10
|
+
* is backend-neutral and should stay that way: it wants bodies, passes and
|
|
11
|
+
* translation units, and does not care what language the programs are in.
|
|
12
|
+
*
|
|
13
|
+
* Two facts drive the shape here, and neither is obvious:
|
|
14
|
+
*
|
|
15
|
+
* 1. **Body keys must be the permutation graph's, not this package's.** The
|
|
16
|
+
* effect walk mints `body_${offset}_${size}` while the graph mints
|
|
17
|
+
* `body${N}`. The container writer drives off graph variants, so a package
|
|
18
|
+
* key reaching it would silently match nothing. The bridge is the
|
|
19
|
+
* permutation index, not string surgery on either spelling.
|
|
20
|
+
*
|
|
21
|
+
* 2. **A translation unit is per pass, never per shader.** One DXBC vertex body
|
|
22
|
+
* can lower to several different GLSL programs, because `pairVaryings`
|
|
23
|
+
* zero-fills the varyings a paired pixel stage reads but the vertex stage
|
|
24
|
+
* never writes - and that set differs per pass. Deduplicating programs by
|
|
25
|
+
* bytecode would therefore collapse two genuinely different programs into
|
|
26
|
+
* one. The unit signature includes the pass key for exactly this reason.
|
|
27
|
+
*/
|
|
28
|
+
|
|
29
|
+
/**
|
|
30
|
+
* Carbon's pass identity, matching the WebGPU emitter so both backends key
|
|
31
|
+
* passes identically.
|
|
32
|
+
*
|
|
33
|
+
* @param {string} techniqueName Technique name.
|
|
34
|
+
* @param {number} passIndex Pass index within the technique.
|
|
35
|
+
* @returns {string} Pass key.
|
|
36
|
+
*/
|
|
37
|
+
function passKeyFor(techniqueName, passIndex) {
|
|
38
|
+
return `${techniqueName}.pass${passIndex}`;
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
/**
|
|
42
|
+
* Stable signature for one pass translation unit.
|
|
43
|
+
*
|
|
44
|
+
* Includes `passKey` because pass-scoped varying pairing can make two units
|
|
45
|
+
* differ while their source bytecode is identical. Excludes diagnostics
|
|
46
|
+
* (`emitWarnings`, `hlsl2webgl`) because they describe the build, not the
|
|
47
|
+
* program, and would split otherwise-identical units.
|
|
48
|
+
*
|
|
49
|
+
* @param {object} unit Candidate unit.
|
|
50
|
+
* @returns {string} Signature.
|
|
51
|
+
*/
|
|
52
|
+
function unitSignature(unit) {
|
|
53
|
+
return JSON.stringify({
|
|
54
|
+
passKey: unit.passKey,
|
|
55
|
+
shaders: unit.shaders,
|
|
56
|
+
block: unit.block,
|
|
57
|
+
resourceTransforms: unit.resourceTransforms
|
|
58
|
+
});
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
/**
|
|
62
|
+
* Collect the per-stage data that has no home in Carbon reflection.
|
|
63
|
+
*
|
|
64
|
+
* Carbon records the logical resource and its register; these are the lowering
|
|
65
|
+
* decisions taken on top of that - fused sampler pairs, synthesised data
|
|
66
|
+
* textures and UBOs, dropped stub registers, and integer attributes lowered to
|
|
67
|
+
* float. The GLSL text declares them but does not say how to build or bind
|
|
68
|
+
* them, and reflection does not know they happened.
|
|
69
|
+
*
|
|
70
|
+
* Identifiers are kept. An earlier version of this comment claimed `cb{n}`,
|
|
71
|
+
* `s{n}` and `attr{n}` are functions of the register index alone and so need not
|
|
72
|
+
* be stored. They are not: the pixel stage remaps constant-buffer slot 0 to
|
|
73
|
+
* `cb7` (`DxbcGlslEmitter.js`, `pixelConstantBufferRemap`), so an identifier
|
|
74
|
+
* depends on the register *and* the stage, through a profile table. Deriving it
|
|
75
|
+
* downstream would re-implement that policy, and a divergence would show up as a
|
|
76
|
+
* uniform that never binds rather than as an error.
|
|
77
|
+
* See docs/contracts/constant-buffer-slots.md.
|
|
78
|
+
*
|
|
79
|
+
* @param {object} shader Translated shader record.
|
|
80
|
+
* @returns {object|null} Stage block data, or null when the stage adds nothing.
|
|
81
|
+
*/
|
|
82
|
+
function stageBlockFor(shader) {
|
|
83
|
+
const block = {};
|
|
84
|
+
if (Array.isArray(shader.bindings) && shader.bindings.length) {
|
|
85
|
+
block.bindings = shader.bindings;
|
|
86
|
+
}
|
|
87
|
+
if (Array.isArray(shader.stageInputs) && shader.stageInputs.length) {
|
|
88
|
+
block.stageInputs = shader.stageInputs;
|
|
89
|
+
}
|
|
90
|
+
if (shader.computeFragment) {
|
|
91
|
+
block.computeFragment = shader.computeFragment;
|
|
92
|
+
}
|
|
93
|
+
return Object.keys(block).length ? block : null;
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
/**
|
|
97
|
+
* Build the backend body set for a translated WebGL effect.
|
|
98
|
+
*
|
|
99
|
+
* @param {object} input Translation results.
|
|
100
|
+
* @param {Array<object>} input.bodies Body records from the effect walk.
|
|
101
|
+
* @param {Array<object>} input.stages Stage records from the effect walk.
|
|
102
|
+
* @param {Array<object>} input.shaders Translated shader records.
|
|
103
|
+
* @param {Array<object>} input.variants Export variants, carrying permutation indices.
|
|
104
|
+
* @param {object} input.permutationGraph Validated permutation graph.
|
|
105
|
+
* @returns {object} Backend body set in the container writer's shape.
|
|
106
|
+
*/
|
|
107
|
+
function buildGlslBackendBodySet(input) {
|
|
108
|
+
const {
|
|
109
|
+
bodies,
|
|
110
|
+
stages,
|
|
111
|
+
shaders,
|
|
112
|
+
variants,
|
|
113
|
+
permutationGraph
|
|
114
|
+
} = input;
|
|
115
|
+
const shadersByKey = new Map(shaders.map(shader => [shader.key, shader]));
|
|
116
|
+
const stagesByBody = new Map();
|
|
117
|
+
for (const stage of stages) {
|
|
118
|
+
if (!stagesByBody.has(stage.bodyKey)) stagesByBody.set(stage.bodyKey, []);
|
|
119
|
+
stagesByBody.get(stage.bodyKey).push(stage);
|
|
120
|
+
}
|
|
121
|
+
|
|
122
|
+
// Package body key -> the graph's own key, bridged through the permutation
|
|
123
|
+
// index rather than by reformatting either spelling.
|
|
124
|
+
const graphKeyByPackageKey = new Map();
|
|
125
|
+
const permutationIndexByPackageKey = new Map();
|
|
126
|
+
for (const variant of variants) {
|
|
127
|
+
if (graphKeyByPackageKey.has(variant.bodyKey)) continue;
|
|
128
|
+
const graphVariant = permutationGraph.variants[variant.permutationIndex];
|
|
129
|
+
if (!graphVariant) continue;
|
|
130
|
+
graphKeyByPackageKey.set(variant.bodyKey, graphVariant.bodyKey);
|
|
131
|
+
permutationIndexByPackageKey.set(variant.bodyKey, variant.permutationIndex);
|
|
132
|
+
}
|
|
133
|
+
const passUnits = [];
|
|
134
|
+
const unitKeyBySignature = new Map();
|
|
135
|
+
const emittedBodies = [];
|
|
136
|
+
for (const body of bodies) {
|
|
137
|
+
const graphBodyKey = graphKeyByPackageKey.get(body.key);
|
|
138
|
+
if (!graphBodyKey) continue;
|
|
139
|
+
const representativePermutationIndex = permutationIndexByPackageKey.get(body.key) ?? 0;
|
|
140
|
+
if (body.error) {
|
|
141
|
+
emittedBodies.push(Object.freeze({
|
|
142
|
+
bodyKey: graphBodyKey,
|
|
143
|
+
representativePermutationIndex,
|
|
144
|
+
status: "unsupported",
|
|
145
|
+
error: body.error,
|
|
146
|
+
passes: Object.freeze([])
|
|
147
|
+
}));
|
|
148
|
+
continue;
|
|
149
|
+
}
|
|
150
|
+
const passes = new Map();
|
|
151
|
+
for (const stage of stagesByBody.get(body.key) ?? []) {
|
|
152
|
+
const key = passKeyFor(stage.techniqueName, stage.passIndex);
|
|
153
|
+
if (!passes.has(key)) {
|
|
154
|
+
passes.set(key, {
|
|
155
|
+
passKey: key,
|
|
156
|
+
shaders: [],
|
|
157
|
+
block: {},
|
|
158
|
+
transforms: []
|
|
159
|
+
});
|
|
160
|
+
}
|
|
161
|
+
const shader = shadersByKey.get(stage.shaderKey);
|
|
162
|
+
// A stage the translator could not lower carries no program. The
|
|
163
|
+
// body still emits, with reflection intact and an empty slot, so
|
|
164
|
+
// the offset table stays dense and the failure is visible rather
|
|
165
|
+
// than absent.
|
|
166
|
+
if (!shader?.source) continue;
|
|
167
|
+
const entry = passes.get(key);
|
|
168
|
+
|
|
169
|
+
// The merge is a property of the pass, not of one stage: the block's
|
|
170
|
+
// transform section says how to build the array the GLSL samples.
|
|
171
|
+
// Built here rather than at translation time because the transform's
|
|
172
|
+
// identity includes the pass key, which the translator does not know.
|
|
173
|
+
if (shader.detailMapArray && !entry.hasDetailMapTransform) {
|
|
174
|
+
entry.hasDetailMapTransform = true;
|
|
175
|
+
entry.transforms.push(detailMapTransformFor(shader.detailMapArray, key));
|
|
176
|
+
}
|
|
177
|
+
|
|
178
|
+
// Same reasoning, different statement: this one records that the
|
|
179
|
+
// light profile array was dropped for a constant, so the resource
|
|
180
|
+
// the description still lists is accounted for rather than missing.
|
|
181
|
+
if (shader.lightProfileNeutral && !entry.hasLightProfileTransform) {
|
|
182
|
+
const transform = localLightProfileNeutralTransformFor(shader.lightProfileNeutral, key);
|
|
183
|
+
if (transform) {
|
|
184
|
+
entry.hasLightProfileTransform = true;
|
|
185
|
+
entry.transforms.push(transform);
|
|
186
|
+
}
|
|
187
|
+
}
|
|
188
|
+
entry.shaders.push({
|
|
189
|
+
key: `${key}.${stage.stageName}`,
|
|
190
|
+
stageName: stage.stageName,
|
|
191
|
+
stageType: stage.stageType,
|
|
192
|
+
code: shader.source
|
|
193
|
+
});
|
|
194
|
+
const stageBlock = stageBlockFor(shader);
|
|
195
|
+
if (stageBlock) entry.block[stage.stageName] = stageBlock;
|
|
196
|
+
}
|
|
197
|
+
const bodyPasses = [];
|
|
198
|
+
let translatedPassCount = 0;
|
|
199
|
+
for (const pass of passes.values()) {
|
|
200
|
+
if (!pass.shaders.length) continue;
|
|
201
|
+
translatedPassCount += 1;
|
|
202
|
+
const unit = {
|
|
203
|
+
passKey: pass.passKey,
|
|
204
|
+
shaders: pass.shaders,
|
|
205
|
+
block: Object.keys(pass.block).length ? pass.block : null,
|
|
206
|
+
resourceTransforms: pass.transforms
|
|
207
|
+
};
|
|
208
|
+
const signature = unitSignature(unit);
|
|
209
|
+
let unitKey = unitKeyBySignature.get(signature);
|
|
210
|
+
if (!unitKey) {
|
|
211
|
+
unitKey = `unit${passUnits.length}`;
|
|
212
|
+
unitKeyBySignature.set(signature, unitKey);
|
|
213
|
+
passUnits.push(Object.freeze({
|
|
214
|
+
key: unitKey,
|
|
215
|
+
...unit
|
|
216
|
+
}));
|
|
217
|
+
}
|
|
218
|
+
bodyPasses.push(Object.freeze({
|
|
219
|
+
passKey: pass.passKey,
|
|
220
|
+
unitKey
|
|
221
|
+
}));
|
|
222
|
+
}
|
|
223
|
+
emittedBodies.push(Object.freeze({
|
|
224
|
+
bodyKey: graphBodyKey,
|
|
225
|
+
representativePermutationIndex,
|
|
226
|
+
status: translatedPassCount ? "translated" : "unsupported",
|
|
227
|
+
error: translatedPassCount ? null : "no pass produced a translated program",
|
|
228
|
+
passes: Object.freeze(bodyPasses)
|
|
229
|
+
}));
|
|
230
|
+
}
|
|
231
|
+
return Object.freeze({
|
|
232
|
+
format: "CJS_GLSL_BODY_SET",
|
|
233
|
+
formatVersion: 1,
|
|
234
|
+
bodyCount: emittedBodies.length,
|
|
235
|
+
translatedBodyCount: emittedBodies.filter(body => body.status === "translated").length,
|
|
236
|
+
passUnitCount: passUnits.length,
|
|
237
|
+
passUnits: Object.freeze(passUnits),
|
|
238
|
+
bodies: Object.freeze(emittedBodies)
|
|
239
|
+
});
|
|
240
|
+
}
|
|
241
|
+
|
|
242
|
+
export { buildGlslBackendBodySet };
|
|
243
|
+
//# sourceMappingURL=glslBackendBodySet.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"glslBackendBodySet.js","sources":["../../../../../src/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 * See docs/contracts/constant-buffer-slots.md.\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(Object.freeze({\n bodyKey: graphBodyKey,\n representativePermutationIndex,\n status: \"unsupported\",\n error: body.error,\n passes: Object.freeze([])\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(Object.freeze({ key: unitKey, ...unit }));\n }\n\n bodyPasses.push(Object.freeze({ passKey: pass.passKey, unitKey }));\n }\n\n emittedBodies.push(Object.freeze({\n bodyKey: graphBodyKey,\n representativePermutationIndex,\n status: translatedPassCount ? \"translated\" : \"unsupported\",\n error: translatedPassCount ? null : \"no pass produced a translated program\",\n passes: Object.freeze(bodyPasses)\n }));\n }\n\n return Object.freeze({\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: Object.freeze(passUnits),\n bodies: Object.freeze(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","freeze","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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"}
|
|
@@ -1,81 +1,85 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Inspects
|
|
3
|
-
*
|
|
4
|
-
* Geometry and compute stages are not raster-pair members. A raster pass is
|
|
5
|
-
* complete only when both its vertex and pixel records exist and their shared
|
|
6
|
-
* shader records contain successful translated source.
|
|
7
|
-
*
|
|
8
|
-
*
|
|
9
|
-
*
|
|
10
|
-
*
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
}
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
1
|
+
/**
|
|
2
|
+
* Inspects Carbon WebGL stage records for complete WebGL2 raster passes.
|
|
3
|
+
*
|
|
4
|
+
* Geometry and compute stages are not raster-pair members. A raster pass is
|
|
5
|
+
* complete only when both its vertex and pixel records exist and their shared
|
|
6
|
+
* shader records contain successful translated source.
|
|
7
|
+
*
|
|
8
|
+
* Stages reference shaders by key. The older shape that inlined the shader into
|
|
9
|
+
* the stage record has no producer left — both callers pass a shader table, and
|
|
10
|
+
* the container decoder always builds one — so the branch that supported it is
|
|
11
|
+
* gone rather than kept as an untested path.
|
|
12
|
+
*
|
|
13
|
+
* @param {object[]} stages Stage records.
|
|
14
|
+
* @param {object[]} shaders Translated shader records.
|
|
15
|
+
* @returns {{ expectedPassCount: number, completePassCount: number, incompletePasses: object[] }}
|
|
16
|
+
*/
|
|
17
|
+
function inspectRasterCompleteness(stages, shaders) {
|
|
18
|
+
const shaderMap = new Map((shaders || []).map(shader => [shader.key, shader]));
|
|
19
|
+
const groups = new Map();
|
|
20
|
+
for (const stage of stages || []) {
|
|
21
|
+
if (stage.stageName !== "vertex" && stage.stageName !== "pixel") continue;
|
|
22
|
+
const key = [stage.bodyKey || "selected", stage.techniqueName || "Main", Number.isInteger(stage.passIndex) ? stage.passIndex : 0].join(":");
|
|
23
|
+
let group = groups.get(key);
|
|
24
|
+
if (!group) {
|
|
25
|
+
group = {
|
|
26
|
+
key,
|
|
27
|
+
bodyKey: stage.bodyKey || "selected",
|
|
28
|
+
techniqueName: stage.techniqueName || "Main",
|
|
29
|
+
passIndex: Number.isInteger(stage.passIndex) ? stage.passIndex : 0,
|
|
30
|
+
vertex: null,
|
|
31
|
+
pixel: null,
|
|
32
|
+
duplicateStages: []
|
|
33
|
+
};
|
|
34
|
+
groups.set(key, group);
|
|
35
|
+
}
|
|
36
|
+
if (group[stage.stageName]) {
|
|
37
|
+
group.duplicateStages.push(stage.stageName);
|
|
38
|
+
}
|
|
39
|
+
group[stage.stageName] = stage;
|
|
40
|
+
}
|
|
41
|
+
const incompletePasses = [];
|
|
42
|
+
let completePassCount = 0;
|
|
43
|
+
for (const group of groups.values()) {
|
|
44
|
+
const missingStages = [];
|
|
45
|
+
const unavailableStages = [];
|
|
46
|
+
for (const stageName of ["vertex", "pixel"]) {
|
|
47
|
+
const stage = group[stageName];
|
|
48
|
+
if (!stage) {
|
|
49
|
+
missingStages.push(stageName);
|
|
50
|
+
continue;
|
|
51
|
+
}
|
|
52
|
+
const shader = shaderMap.get(stage.shaderKey);
|
|
53
|
+
if (!shader?.hlsl2webgl?.ok || !shader.source) {
|
|
54
|
+
unavailableStages.push({
|
|
55
|
+
stageName,
|
|
56
|
+
stageKey: stage.key,
|
|
57
|
+
shaderKey: stage.shaderKey,
|
|
58
|
+
excluded: shader?.excluded || null,
|
|
59
|
+
reason: shader?.hlsl2webgl?.validationError || shader?.hlsl2webgl?.reason || shader?.hlsl2webgl?.error || shader?.excluded?.reason || "translated source is unavailable"
|
|
60
|
+
});
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
if (!missingStages.length && !unavailableStages.length && !group.duplicateStages.length) {
|
|
64
|
+
completePassCount += 1;
|
|
65
|
+
continue;
|
|
66
|
+
}
|
|
67
|
+
incompletePasses.push({
|
|
68
|
+
key: group.key,
|
|
69
|
+
bodyKey: group.bodyKey,
|
|
70
|
+
techniqueName: group.techniqueName,
|
|
71
|
+
passIndex: group.passIndex,
|
|
72
|
+
missingStages,
|
|
73
|
+
unavailableStages,
|
|
74
|
+
duplicateStages: [...new Set(group.duplicateStages)].sort()
|
|
75
|
+
});
|
|
76
|
+
}
|
|
77
|
+
return {
|
|
78
|
+
expectedPassCount: groups.size,
|
|
79
|
+
completePassCount,
|
|
80
|
+
incompletePasses
|
|
81
|
+
};
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
export { inspectRasterCompleteness };
|
|
85
|
+
//# sourceMappingURL=glslEffectCompleteness.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"glslEffectCompleteness.js","sources":["../../../../../src/formats/webgl/core/glslEffectCompleteness.js"],"sourcesContent":["import { LOCAL_LIGHT_RESOURCE_NAMES } from \"../../hlsl/core/localLightFamily.js\";\n\n/**\n * Light-record fields naming the Carbon registers a lowering replaced.\n *\n * A lowered family declares one synthesised uniform, so its own `registerIndex`\n * covers only one of the sources; the record carries the rest.\n */\n/** Transform stage names, in the shared codec's vocabulary, as WebGL names them. */\nconst TRANSFORM_STAGE_NAMES = Object.freeze({\n vertex: \"vertex\",\n fragment: \"pixel\",\n compute: \"compute\"\n});\n\nconst LOCAL_LIGHT_RECORD_REGISTERS = Object.freeze([\n \"lightIndexRegister\",\n \"lightDataRegister\",\n \"lightProfileRegister\"\n]);\n\n/**\n * Inspects Carbon WebGL stage records for complete WebGL2 raster passes.\n *\n * Geometry and compute stages are not raster-pair members. A raster pass is\n * complete only when both its vertex and pixel records exist and their shared\n * shader records contain successful translated source.\n *\n * Stages reference shaders by key. The older shape that inlined the shader into\n * the stage record has no producer left — both callers pass a shader table, and\n * the container decoder always builds one — so the branch that supported it is\n * gone rather than kept as an untested path.\n *\n * @param {object[]} stages Stage records.\n * @param {object[]} shaders Translated shader records.\n * @returns {{ expectedPassCount: number, completePassCount: number, incompletePasses: object[] }}\n */\nexport function inspectRasterCompleteness(stages, shaders)\n{\n const shaderMap = new Map((shaders || []).map((shader) => [ shader.key, shader ]));\n const groups = new Map();\n\n for (const stage of stages || [])\n {\n if (stage.stageName !== \"vertex\" && stage.stageName !== \"pixel\") continue;\n\n const key = [\n stage.bodyKey || \"selected\",\n stage.techniqueName || \"Main\",\n Number.isInteger(stage.passIndex) ? stage.passIndex : 0\n ].join(\":\");\n let group = groups.get(key);\n if (!group)\n {\n group = {\n key,\n bodyKey: stage.bodyKey || \"selected\",\n techniqueName: stage.techniqueName || \"Main\",\n passIndex: Number.isInteger(stage.passIndex) ? stage.passIndex : 0,\n vertex: null,\n pixel: null,\n duplicateStages: []\n };\n groups.set(key, group);\n }\n if (group[stage.stageName])\n {\n group.duplicateStages.push(stage.stageName);\n }\n group[stage.stageName] = stage;\n }\n\n const incompletePasses = [];\n let completePassCount = 0;\n\n for (const group of groups.values())\n {\n const missingStages = [];\n const unavailableStages = [];\n\n for (const stageName of [ \"vertex\", \"pixel\" ])\n {\n const stage = group[stageName];\n if (!stage)\n {\n missingStages.push(stageName);\n continue;\n }\n\n const shader = shaderMap.get(stage.shaderKey);\n if (!shader?.hlsl2webgl?.ok || !shader.source)\n {\n unavailableStages.push({\n stageName,\n stageKey: stage.key,\n shaderKey: stage.shaderKey,\n excluded: shader?.excluded || null,\n reason: shader?.hlsl2webgl?.validationError\n || shader?.hlsl2webgl?.reason\n || shader?.hlsl2webgl?.error\n || shader?.excluded?.reason\n || \"translated source is unavailable\"\n });\n }\n }\n\n if (!missingStages.length && !unavailableStages.length && !group.duplicateStages.length)\n {\n completePassCount += 1;\n continue;\n }\n\n incompletePasses.push({\n key: group.key,\n bodyKey: group.bodyKey,\n techniqueName: group.techniqueName,\n passIndex: group.passIndex,\n missingStages,\n unavailableStages,\n duplicateStages: [ ...new Set(group.duplicateStages) ].sort()\n });\n }\n\n return {\n expectedPassCount: groups.size,\n completePassCount,\n incompletePasses\n };\n}\n\n/**\n * Checks the host-side routing contract emitted for compute-as-fragment\n * programs. A boolean marker is insufficient: the runtime needs the original\n * dispatch shape, dispatch-origin uniform, and every UAV render-target route.\n */\nexport function isComputeFragmentContract(value)\n{\n if (!value || typeof value !== \"object\" || Array.isArray(value)) return false;\n if (!Array.isArray(value.threadGroup)\n || value.threadGroup.length !== 3\n || value.threadGroup.some((item) => !Number.isSafeInteger(item) || item < 1))\n {\n return false;\n }\n if (value.dispatchOriginUniform !== null\n && (typeof value.dispatchOriginUniform !== \"string\" || !value.dispatchOriginUniform)) return false;\n if (!Array.isArray(value.uavOutputs) || !value.uavOutputs.length) return false;\n\n const locations = new Set();\n const names = new Set();\n const routes = new Set();\n for (const output of value.uavOutputs)\n {\n if (!output || typeof output !== \"object\") return false;\n if (!Number.isSafeInteger(output.register) || output.register < 0) return false;\n if (output.slice !== null && (!Number.isSafeInteger(output.slice) || output.slice < 0)) return false;\n if (!Number.isSafeInteger(output.location) || output.location < 0 || locations.has(output.location)) return false;\n if (typeof output.glslName !== \"string\" || !output.glslName || names.has(output.glslName)) return false;\n const route = `${output.register}:${output.slice === null ? \"dynamic\" : output.slice}`;\n if (routes.has(route)) return false;\n locations.add(output.location);\n names.add(output.glslName);\n routes.add(route);\n }\n return true;\n}\n\n/**\n * Checks a declared resource transform against the bindings it claims to have\n * rewritten.\n *\n * A transform says N described resources became one array binding. That claim is\n * only meaningful if the shader agrees: the carrier - layer 0's register, whose\n * slot the array occupies - must be declared, and every merged-away input must\n * not be. A transform naming registers the shader still binds separately has not\n * happened; a carrier the shader never declares cannot be bound.\n *\n * engine-webgpu makes equivalent checks when it realizes a package, and they are\n * mostly about the emitted artefacts rather than the device. WebGL has no engine\n * to make them, so a container can currently ship a transform nothing agrees\n * with. Checking here covers both, and covers WebGL at the only point that\n * exists.\n *\n * @param {object} stage Decoded stage record.\n * @param {object} shader Decoded shader record.\n * @param {object[]} errors Collected integrity errors.\n */\nfunction checkResourceTransforms(stage, shader, errors)\n{\n const all = Array.isArray(stage.transforms) ? stage.transforms : [];\n // A transform belongs to a pass but rewrites one stage. The record names that\n // stage in WGSL's vocabulary, where WebGL's is \"pixel\" - the block codec is\n // shared between the backends and restores the field from one set of\n // defaults. Checking a vertex stage against a fragment transform reports\n // every pass twice and says nothing: measured on a shipped effect, that was\n // 48 carrier-undeclared reports on a container with nothing wrong with it.\n const transforms = all.filter(\n (transform) => TRANSFORM_STAGE_NAMES[transform?.stage] === stage.stageName\n );\n if (!transforms.length) return;\n\n const declared = new Set(\n (Array.isArray(shader.bindings) ? shader.bindings : [])\n .filter((binding) => Number.isSafeInteger(binding?.registerIndex))\n .map((binding) => binding.registerIndex)\n );\n\n for (const transform of transforms)\n {\n const inputs = Array.isArray(transform?.inputs) ? transform.inputs : [];\n\n // Not every transform is a merge. `local-light-profile-neutral` records\n // one resource replaced by a constant, so it has exactly one input and\n // no carrier - the checks below would read that as an underfilled merge\n // whose carrier went missing, which is the opposite of what happened.\n if (transform?.family === \"local-light-profile-neutral\")\n {\n if (inputs.length !== 1)\n {\n addIntegrityError(\n errors,\n \"resource_transform_neutral_arity\",\n `Stage ${stage.key} transform ${transform?.id || \"<missing>\"} neutralises ${inputs.length} resource(s); exactly one is expected`,\n { stageKey: stage.key, transformId: transform?.id || null }\n );\n continue;\n }\n\n const [ neutralised ] = inputs;\n if (Number.isSafeInteger(neutralised.registerIndex)\n && declared.has(neutralised.registerIndex))\n {\n addIntegrityError(\n errors,\n \"resource_transform_neutral_still_bound\",\n `Stage ${stage.key} transform ${transform.id} neutralised register ${neutralised.registerIndex}, but the shader still declares it`,\n {\n stageKey: stage.key,\n transformId: transform.id,\n register: neutralised.registerIndex\n }\n );\n }\n continue;\n }\n\n if (inputs.length < 2)\n {\n addIntegrityError(\n errors,\n \"resource_transform_underfilled\",\n `Stage ${stage.key} declares transform ${transform?.id || \"<missing>\"} with ${inputs.length} input(s); a merge needs at least two`,\n { stageKey: stage.key, transformId: transform?.id || null }\n );\n continue;\n }\n\n // Layers address array slices, so they must be the whole range 0..n-1.\n const layers = inputs.map((input) => input.layer);\n if (layers.some((layer, index) => layer !== index))\n {\n addIntegrityError(\n errors,\n \"resource_transform_layer_gap\",\n `Stage ${stage.key} transform ${transform.id} has layers ${layers.join(\", \")} rather than a contiguous range`,\n { stageKey: stage.key, transformId: transform.id, layers }\n );\n continue;\n }\n\n const [ carrier, ...merged ] = inputs;\n if (Number.isSafeInteger(carrier.registerIndex)\n && !declared.has(carrier.registerIndex))\n {\n addIntegrityError(\n errors,\n \"resource_transform_carrier_undeclared\",\n `Stage ${stage.key} transform ${transform.id} names carrier register ${carrier.registerIndex}, which the shader does not declare`,\n {\n stageKey: stage.key,\n transformId: transform.id,\n register: carrier.registerIndex\n }\n );\n }\n\n for (const input of merged)\n {\n if (!Number.isSafeInteger(input.registerIndex)) continue;\n if (!declared.has(input.registerIndex)) continue;\n\n addIntegrityError(\n errors,\n \"resource_transform_input_still_bound\",\n `Stage ${stage.key} transform ${transform.id} merged register ${input.registerIndex} away, but the shader still declares it`,\n {\n stageKey: stage.key,\n transformId: transform.id,\n register: input.registerIndex\n }\n );\n }\n }\n}\n\n/**\n * Reports a local-light family that the shipped GLSL neither binds nor explains.\n *\n * The container deliberately says two things at once. The Carbon description\n * records are the authored name and register authority and are never rewritten\n * by a lowering; the GLSL declares whatever the lowering actually produced; and\n * the per-pass backend block is the delta that ties one to the other. That only\n * holds while the delta is complete.\n *\n * This cannot be a general \"every described resource is declared\" rule. Carbon\n * describes resources a shader may simply not use, and the emitter only declares\n * what it samples, so an undeclared resource is ordinary. Measured on a shipped\n * effect, the general form reported 96 such resources on a perfectly good build.\n *\n * What is checkable is a family the packager is known to rewrite. Local lights\n * are two structured buffers plus an optional profile texture; WebGL2 has no\n * structured buffers, so the shader either lowers them - leaving a light record\n * naming the source registers - or it cannot bind lights at all. A described\n * family with no declaration and no record is the one case that is definitely\n * wrong rather than merely unused.\n *\n * `localLights: \"drop\"` produces exactly that: the emitter removes the\n * declarations *and* their binding records, so nothing reaches the block while\n * the description still lists all three. That mode is a diagnostic aid, not a\n * shipping mode, and this is what says so instead of writing a container that\n * quietly disagrees with itself.\n *\n * @param {object} stage Decoded stage record.\n * @param {object} shader Decoded shader record.\n * @param {object[]} errors Collected integrity errors.\n */\nfunction checkLocalLightFamilyAccounted(stage, shader, errors)\n{\n const manifestBindings = Array.isArray(stage.manifest?.bindings)\n ? stage.manifest.bindings\n : [];\n const family = manifestBindings.filter((entry) => entry?.kind === \"resource\"\n && LOCAL_LIGHT_RESOURCE_NAMES.includes(entry.name));\n if (family.length < 2) return;\n\n const bindings = Array.isArray(shader.bindings) ? shader.bindings : [];\n const accounted = new Set();\n for (const binding of bindings)\n {\n if (Number.isSafeInteger(binding?.registerIndex))\n {\n accounted.add(binding.registerIndex);\n }\n for (const key of LOCAL_LIGHT_RECORD_REGISTERS)\n {\n if (Number.isSafeInteger(binding?.[key])) accounted.add(binding[key]);\n }\n }\n\n // A resource transform accounts for a register just as a binding record\n // does. `local-light-profile-neutral` names a resource replaced by a\n // constant: nothing is bound, so no binding can carry it, and the transform\n // is the only place the decision is written down.\n for (const transform of Array.isArray(stage.transforms) ? stage.transforms : [])\n {\n if (transform?.family !== \"local-light-profile-neutral\") continue;\n for (const input of Array.isArray(transform.inputs) ? transform.inputs : [])\n {\n if (Number.isSafeInteger(input?.registerIndex)) accounted.add(input.registerIndex);\n }\n }\n\n // Any orphan is a fault, not only a wholly missing family. A lowering that\n // declares its synthesised uniform but forgets to record the other source\n // registers loses them just as completely, and only the record can say where\n // they went.\n const orphans = family\n .filter((entry) => Number.isSafeInteger(entry.registerIndex)\n && !accounted.has(entry.registerIndex))\n .map((entry) => entry.registerIndex);\n if (!orphans.length) return;\n\n addIntegrityError(\n errors,\n \"unlowered_local_light_family\",\n `Stage ${stage.key} describes a local-light family at registers ${orphans.join(\", \")} that the shader neither declares nor lowers`,\n {\n stageKey: stage.key,\n shaderKey: stage.shaderKey || null,\n registers: orphans\n }\n );\n}\n\n/**\n * Inspects a decoded effect container for the contracts a WebGL 2 runtime needs.\n *\n * This replaces `inspectGlslContainerIntegrity`, which took the chunk package's\n * INFO, META and GLSL records. Most of that function was bookkeeping about the\n * chunk format rather than about the effect, and it is not carried across:\n *\n * - **Envelope and kind checks** (`invalid_package_envelope`,\n * `unsupported_package_kind`) asserted the magic strings `Carbon WebGL` /\n * `CARBON_WEBGL_GLSL_SET` and a `packageKind` naming the chunk layout. They described\n * the container they were written in, and that container is gone.\n * - **Declared-count checks** (`invalid_declared_count`, `declared_count_mismatch`,\n * `declared_partial_package` — twelve fields) compared a header counter against\n * the graph it summarised. A header can lie about the body; that is why the\n * check existed. Nothing here declares a count, so there is nothing to lie.\n * - **Cross-copy reconciliation** (`package_mode_mismatch`,\n * `package_selection_mismatch`, `variant_metadata_mismatch`,\n * `failed_metadata_body`, `missing_metadata_*`, `orphan_metadata_*`) checked\n * that META and GLSL agreed. Two independently-encoded copies of one fact can\n * drift. The container stores one copy, so the bug class is gone rather than\n * unchecked.\n * - **`missing_glsl_set` / `missing_metadata` / `invalid_core_chunk_cardinality`**\n * asked whether a chunk was present exactly once. The reader now refuses to\n * construct at all on a malformed container, which is strictly stronger.\n * - **`orphan_shader` / `duplicate_shader_key`** are unreachable by construction:\n * the decoder pools shaders by program text and emits a key per pool, so a\n * shader exists only because a stage referenced it.\n *\n * What survives is everything that describes the translation: which stages a\n * pass may contain, whether a declared stage carries a program, whether a\n * compute stage was adapted to the fragment host, and whether the emitted GLSL\n * actually declares the inputs and samplers the reflection promises. Those are\n * properties of the shader, not of the file it arrived in.\n *\n * @param {{stages:object[], shaders:object[]}} decoded Decoded container graph.\n * @returns {{ok:boolean, errors:object[]}} Integrity report.\n */\nexport function inspectGlslContainerIntegrity(decoded)\n{\n const errors = [];\n const stages = decoded?.stages;\n const shaders = decoded?.shaders;\n\n if (!Array.isArray(stages) || !Array.isArray(shaders))\n {\n addIntegrityError(\n errors,\n \"missing_container_graph\",\n \"Container integrity requires decoded stage and shader arrays\"\n );\n return { ok: false, errors };\n }\n\n const shaderMap = new Map(shaders.map((shader) => [ shader.key, shader ]));\n const passGroups = new Map();\n\n for (const stage of stages)\n {\n const passKey = `${stage.bodyKey}.${stage.techniqueName}.pass${stage.passIndex}`;\n if (!passGroups.has(passKey)) passGroups.set(passKey, []);\n passGroups.get(passKey).push(stage);\n\n const shader = shaderMap.get(stage.shaderKey);\n\n if (![ \"vertex\", \"pixel\", \"compute\" ].includes(stage.stageName))\n {\n addIntegrityError(\n errors,\n \"unsupported_stage\",\n `Stage ${stage.key} uses unsupported WebGL2 stage ${stage.stageName}`,\n { stageKey: stage.key, stageName: stage.stageName || null }\n );\n continue;\n }\n\n if (!shader?.hlsl2webgl?.ok || !shader.source)\n {\n addIntegrityError(\n errors,\n \"unavailable_stage_shader\",\n `Stage ${stage.key} has no successful translated source`,\n { stageKey: stage.key, shaderKey: stage.shaderKey || null }\n );\n continue;\n }\n\n if (stage.stageName === \"compute\")\n {\n const computeIssue = computeFragmentShaderIssue(shader);\n if (computeIssue)\n {\n addIntegrityError(\n errors,\n \"unadapted_compute_stage\",\n `Compute stage ${stage.key} ${computeIssue}`,\n { stageKey: stage.key, shaderKey: stage.shaderKey || null }\n );\n }\n }\n\n if (stage.manifest) validateShaderRuntimeContract(shader, stage, stage.manifest, errors);\n }\n\n for (const [ passKey, passStages ] of passGroups)\n {\n const counts = { vertex: 0, pixel: 0, compute: 0, other: 0 };\n for (const stage of passStages)\n {\n if (stage.stageName in counts && stage.stageName !== \"other\") counts[stage.stageName] += 1;\n else counts.other += 1;\n }\n const raster = counts.vertex === 1 && counts.pixel === 1 && counts.compute === 0 && counts.other === 0;\n const compute = counts.vertex === 0 && counts.pixel === 0 && counts.compute === 1 && counts.other === 0;\n if (!raster && !compute)\n {\n const duplicate = Object.values(counts).some((count) => count > 1);\n const mixed = counts.compute > 0 && (counts.vertex > 0 || counts.pixel > 0);\n const code = duplicate || mixed\n ? \"invalid_pass_stage_family\"\n : counts.other > 0\n ? \"unsupported_pass_stage_family\"\n : \"incomplete_pass_stage_family\";\n addIntegrityError(\n errors,\n code,\n `Pass ${passKey} must contain exactly one vertex/pixel pair or one compute stage`,\n { passKey, counts }\n );\n }\n }\n\n return { ok: errors.length === 0, errors };\n}\n\nfunction computeFragmentShaderIssue(shader)\n{\n const contract = shader?.computeFragment;\n if (!isComputeFragmentContract(contract)) return \"has no valid compute-fragment host contract\";\n if (!Array.isArray(shader.bindings)) return \"has no binding metadata for its compute-fragment host contract\";\n\n const bindings = shader.bindings.filter((binding) => binding?.kind === \"uavTexture\");\n if (bindings.length !== contract.uavOutputs.length)\n {\n return \"compute-fragment UAV routes do not match its binding metadata\";\n }\n for (const output of contract.uavOutputs)\n {\n if (!bindings.some((binding) => binding.registerIndex === output.register\n && binding.slice === output.slice\n && binding.location === output.location\n && binding.name === output.glslName))\n {\n return `compute-fragment route ${output.glslName} does not match its binding metadata`;\n }\n const declaration = new RegExp(\n `layout\\\\s*\\\\(\\\\s*location\\\\s*=\\\\s*${output.location}\\\\s*\\\\)\\\\s*out\\\\b[^;]*\\\\b${escapeRegExp(output.glslName)}\\\\s*;`\n );\n if (!declaration.test(shader.source))\n {\n return `compute-fragment route ${output.glslName} is not declared at output location ${output.location}`;\n }\n }\n\n const dispatchBindings = shader.bindings.filter((binding) => binding?.kind === \"dispatchUniform\");\n if (contract.dispatchOriginUniform === null)\n {\n if (dispatchBindings.length) return \"declares unexpected dispatch-origin binding metadata\";\n }\n else\n {\n if (dispatchBindings.length !== 1 || dispatchBindings[0].name !== contract.dispatchOriginUniform)\n {\n return \"dispatch-origin uniform does not match its binding metadata\";\n }\n const declaration = new RegExp(`uniform\\\\s+ivec3\\\\s+${escapeRegExp(contract.dispatchOriginUniform)}\\\\s*;`);\n if (!declaration.test(shader.source)) return \"dispatch-origin uniform is not declared in translated source\";\n }\n return null;\n}\n\nfunction validateShaderRuntimeContract(shader, stage, manifestStage, errors)\n{\n if (stage.stageName === \"vertex\" && Array.isArray(shader.stageInputs))\n {\n const registers = new Set();\n const names = new Set();\n const expectedInputs = (manifestStage.pipelineInputs || []).filter((input) => Number(input?.usedMask || 0) !== 0);\n for (const input of shader.stageInputs)\n {\n if (!Number.isSafeInteger(input?.register)\n || input.register < 0\n || registers.has(input.register)\n || typeof input.name !== \"string\"\n || !input.name\n || names.has(input.name))\n {\n addIntegrityError(\n errors,\n \"invalid_vertex_input_contract\",\n `Vertex shader ${shader.key} has an invalid or duplicate emitted input`,\n { stageKey: stage.key, shaderKey: shader.key }\n );\n continue;\n }\n registers.add(input.register);\n names.add(input.name);\n if (!expectedInputs.some((entry) => entry.registerIndex === input.register\n && normalizeSemanticName(entry.usageName) === normalizeSemanticName(input.semanticName)\n && entry.usageIndex === input.semanticIndex))\n {\n addIntegrityError(\n errors,\n \"vertex_input_contract_mismatch\",\n `Vertex shader ${shader.key} input ${input.name} is not present in its manifest pipeline inputs`,\n { stageKey: stage.key, shaderKey: shader.key, register: input.register }\n );\n }\n const declaration = new RegExp(`\\\\bin\\\\b[^;]*\\\\b${escapeRegExp(input.name)}\\\\s*;`);\n if (!declaration.test(shader.source))\n {\n addIntegrityError(\n errors,\n \"vertex_input_declaration_mismatch\",\n `Vertex shader ${shader.key} input ${input.name} is not declared in translated source`,\n { stageKey: stage.key, shaderKey: shader.key, inputName: input.name }\n );\n }\n }\n }\n\n checkLocalLightFamilyAccounted(stage, shader, errors);\n checkResourceTransforms(stage, shader, errors);\n\n if (!Array.isArray(shader.bindings)) return;\n const manifestBindings = Array.isArray(manifestStage.bindings) ? manifestStage.bindings : [];\n for (const binding of shader.bindings)\n {\n if (typeof binding?.samplerType !== \"string\" || !binding.samplerType) continue;\n const uniform = new RegExp(\n `uniform\\\\s+(?:(?:lowp|mediump|highp)\\\\s+)?${escapeRegExp(binding.samplerType)}\\\\s+${escapeRegExp(binding.name)}\\\\s*;`\n );\n if (!uniform.test(shader.source))\n {\n addIntegrityError(\n errors,\n \"sampler_binding_declaration_mismatch\",\n `Shader ${shader.key} sampler ${binding.name || \"<missing>\"} is not declared as ${binding.samplerType}`,\n { stageKey: stage.key, shaderKey: shader.key, bindingName: binding.name || null }\n );\n }\n if (!Number.isSafeInteger(binding.registerIndex)\n || binding.registerIndex < 0\n || !manifestBindings.some((entry) => entry?.kind === \"resource\" && entry.registerIndex === binding.registerIndex))\n {\n addIntegrityError(\n errors,\n \"sampler_resource_contract_mismatch\",\n `Shader ${shader.key} sampler ${binding.name || \"<missing>\"} has no matching manifest resource register`,\n { stageKey: stage.key, shaderKey: shader.key, register: binding.registerIndex }\n );\n }\n\n const comparison = binding.samplerType.endsWith(\"Shadow\");\n if ((binding.comparison === true) !== comparison)\n {\n addIntegrityError(\n errors,\n \"comparison_sampler_contract_mismatch\",\n `Shader ${shader.key} sampler ${binding.name || \"<missing>\"} comparison metadata disagrees with ${binding.samplerType}`,\n { stageKey: stage.key, shaderKey: shader.key, bindingName: binding.name || null }\n );\n }\n if (comparison)\n {\n const samplerRegisters = binding.samplerRegisterIndices;\n if (!Array.isArray(samplerRegisters)\n || !samplerRegisters.length\n || new Set(samplerRegisters).size !== samplerRegisters.length\n || samplerRegisters.some((register) => !Number.isSafeInteger(register)\n || register < 0\n || !manifestBindings.some((entry) => entry?.kind === \"sampler\"\n && entry.registerIndex === register\n && entry.carbon?.sampler?.comparison === true)))\n {\n addIntegrityError(\n errors,\n \"comparison_sampler_contract_mismatch\",\n `Shader ${shader.key} comparison sampler ${binding.name || \"<missing>\"} has invalid manifest sampler pairing`,\n { stageKey: stage.key, shaderKey: shader.key, bindingName: binding.name || null }\n );\n }\n }\n }\n}\n\nfunction normalizeSemanticName(value)\n{\n const name = String(value || \"\").toUpperCase();\n if (name === \"BITANGENT\") return \"BINORMAL\";\n if (name === \"BLENDWEIGHTS\") return \"BLENDWEIGHT\";\n return name;\n}\n\nfunction escapeRegExp(value)\n{\n return String(value).replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n}\n\nfunction addIntegrityError(errors, code, message, details = {})\n{\n errors.push({ code, message, ...details });\n}\n"],"names":["inspectRasterCompleteness","stages","shaders","shaderMap","Map","map","shader","key","groups","stage","stageName","bodyKey","techniqueName","Number","isInteger","passIndex","join","group","get","vertex","pixel","duplicateStages","set","push","incompletePasses","completePassCount","values","missingStages","unavailableStages","shaderKey","hlsl2webgl","ok","source","stageKey","excluded","reason","validationError","error","length","Set","sort","expectedPassCount","size"],"mappings":"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"}
|