@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.
Files changed (541) hide show
  1. package/LICENSE +21 -21
  2. package/NOTICE +32 -32
  3. package/README.md +129 -108
  4. package/dist/CjsMotherLode.js +1271 -1271
  5. package/dist/CjsResMan.js +3858 -3494
  6. package/dist/CjsResMan.js.map +1 -1
  7. package/dist/CjsResManFetchProvider.js +94 -94
  8. package/dist/CjsResManWorkQueue.js +301 -301
  9. package/dist/_virtual/_rollupPluginBabelHelpers.js +150 -150
  10. package/dist/format/CjsBlueReader.js +358 -358
  11. package/dist/format/CjsByteReader.js +310 -310
  12. package/dist/format/CjsByteWriter.js +242 -242
  13. package/dist/format/CjsFormat.js +223 -223
  14. package/dist/format/CjsFormatError.js +41 -41
  15. package/dist/format/CjsReader.js +22 -22
  16. package/dist/format/CjsResourceProbe.js +279 -279
  17. package/dist/format/CjsStringTable.js +268 -268
  18. package/dist/format/carbonEffect/CjsCarbonEffectReader.js +408 -361
  19. package/dist/format/carbonEffect/CjsCarbonEffectReader.js.map +1 -1
  20. package/dist/format/carbonEffect/CjsCarbonEffectWriter.js +373 -373
  21. package/dist/format/carbonEffect/buildCarbonEffectContainer.js +182 -0
  22. package/dist/format/carbonEffect/buildCarbonEffectContainer.js.map +1 -0
  23. package/dist/format/carbonEffect/carbonEffectBackendBlock.js +321 -427
  24. package/dist/format/carbonEffect/carbonEffectBackendBlock.js.map +1 -1
  25. package/dist/format/carbonEffect/carbonEffectRecords.js +1147 -955
  26. package/dist/format/carbonEffect/carbonEffectRecords.js.map +1 -1
  27. package/dist/format/carbonEffect/carbonEffectResourceTransform.js +197 -0
  28. package/dist/format/carbonEffect/carbonEffectResourceTransform.js.map +1 -0
  29. package/dist/format/compareUtf8.js +36 -36
  30. package/dist/format/effect/effectBodyInventory.js +146 -0
  31. package/dist/format/effect/effectBodyInventory.js.map +1 -0
  32. package/dist/format/effect/effectPermutationGraph.js +257 -257
  33. package/dist/format/effect/effectPermutationGraph.js.map +1 -1
  34. package/dist/format/effect/sha256.js +114 -114
  35. package/dist/format/index.js +11 -11
  36. package/dist/format/payloadContract.js +193 -193
  37. package/dist/formats/black/CjsBlackFormat.js +310 -292
  38. package/dist/formats/black/CjsBlackFormat.js.map +1 -1
  39. package/dist/formats/black/core/CjsBlackBinaryReader.js +260 -260
  40. package/dist/formats/black/core/CjsBlackPropertyReaders.js +448 -448
  41. package/dist/formats/black/core/CjsBlackReader.js +764 -764
  42. package/dist/formats/black/core/CjsBlackSchemaRegistry.js +540 -540
  43. package/dist/formats/black/core/black-schema-v1-2026-07-23.json.js +4 -4
  44. package/dist/formats/black/core/blackConstants.js +7 -7
  45. package/dist/formats/black/core/blackDefinitions.js +10 -10
  46. package/dist/formats/black/core/blackEnums.js +6 -6
  47. package/dist/formats/black/core/blackSchema.js +3 -3
  48. package/dist/formats/black/core/blackVersion.js +22 -22
  49. package/dist/formats/black/core/helpers.js +199 -199
  50. package/dist/formats/black/core/schema.js +4 -4
  51. package/dist/formats/black/index.js +2 -2
  52. package/dist/formats/bnk/CjsBnkFormat.js +175 -156
  53. package/dist/formats/bnk/CjsBnkFormat.js.map +1 -1
  54. package/dist/formats/bnk/core/busNodes.js +252 -0
  55. package/dist/formats/bnk/core/busNodes.js.map +1 -0
  56. package/dist/formats/bnk/core/effectNodes.js +147 -0
  57. package/dist/formats/bnk/core/effectNodes.js.map +1 -0
  58. package/dist/formats/bnk/core/eventAction.js +416 -305
  59. package/dist/formats/bnk/core/eventAction.js.map +1 -1
  60. package/dist/formats/bnk/core/globalSettings.js +215 -0
  61. package/dist/formats/bnk/core/globalSettings.js.map +1 -0
  62. package/dist/formats/bnk/core/graph.js +137 -137
  63. package/dist/formats/bnk/core/helpers.js +512 -480
  64. package/dist/formats/bnk/core/helpers.js.map +1 -1
  65. package/dist/formats/bnk/core/musicNodes.js +533 -509
  66. package/dist/formats/bnk/core/musicNodes.js.map +1 -1
  67. package/dist/formats/bnk/core/nodeBase.js +553 -532
  68. package/dist/formats/bnk/core/nodeBase.js.map +1 -1
  69. package/dist/formats/bnk/core/sfxNodes.js +632 -632
  70. package/dist/formats/bnk/core/soundbanksInfo.js +209 -209
  71. package/dist/formats/bnk/index.js +2 -2
  72. package/dist/formats/cmf/CjsCmfFormat.js +497 -497
  73. package/dist/formats/cmf/core/binary.js +194 -194
  74. package/dist/formats/cmf/core/buffers.js +237 -237
  75. package/dist/formats/cmf/core/constants.js +47 -47
  76. package/dist/formats/cmf/core/gr2Anim.js +453 -453
  77. package/dist/formats/cmf/core/helpers.js +318 -318
  78. package/dist/formats/cmf/core/pack.js +276 -276
  79. package/dist/formats/cmf/core/schema.js +374 -374
  80. package/dist/formats/cmf/core/shared.js +277 -277
  81. package/dist/formats/cmf/core/writer.js +571 -571
  82. package/dist/formats/cmf/index.js +2 -2
  83. package/dist/formats/dds/CjsDdsFormat.js +200 -200
  84. package/dist/formats/dds/core/bc6h.js +298 -298
  85. package/dist/formats/dds/core/bc7.js +272 -272
  86. package/dist/formats/dds/core/helpers.js +862 -862
  87. package/dist/formats/dds/index.js +2 -2
  88. package/dist/formats/dxbc/CjsDxbcFormat.js +142 -142
  89. package/dist/formats/dxbc/core/DxbcReader.js +266 -266
  90. package/dist/formats/dxbc/core/container.js +169 -169
  91. package/dist/formats/dxbc/core/decoder.js +789 -789
  92. package/dist/formats/dxbc/core/errors.js +19 -19
  93. package/dist/formats/dxbc/core/helpers.js +220 -220
  94. package/dist/formats/dxbc/core/opcodes.js +45 -45
  95. package/dist/formats/dxbc/core/program.js +91 -91
  96. package/dist/formats/dxbc/core/signature.js +172 -172
  97. package/dist/formats/dxbc/index.js +2 -2
  98. package/dist/formats/fbx/CjsFbxFormat.js +266 -266
  99. package/dist/formats/fbx/core/helpers.js +3932 -3932
  100. package/dist/formats/fbx/index.js +2 -2
  101. package/dist/formats/flac/CjsFlacFormat.js +142 -142
  102. package/dist/formats/flac/core/helpers.js +315 -315
  103. package/dist/formats/flac/index.js +2 -2
  104. package/dist/formats/gif/CjsGifFormat.js +141 -141
  105. package/dist/formats/gif/core/helpers.js +380 -380
  106. package/dist/formats/gif/index.js +2 -2
  107. package/dist/formats/gltf/CjsGltfFormat.js +290 -290
  108. package/dist/formats/gltf/core/helpers.js +307 -307
  109. package/dist/formats/gltf/core/json.js +79 -79
  110. package/dist/formats/gltf/core/parser.js +679 -679
  111. package/dist/formats/gltf/core/targets.js +173 -173
  112. package/dist/formats/gltf/index.js +2 -2
  113. package/dist/formats/gr2/CjsGr2Format.js +289 -289
  114. package/dist/formats/gr2/core/bitknit2.js +282 -282
  115. package/dist/formats/gr2/core/curves.js +1047 -1047
  116. package/dist/formats/gr2/core/gsf.js +72 -72
  117. package/dist/formats/gr2/core/helpers.js +352 -352
  118. package/dist/formats/gr2/core/json.js +622 -622
  119. package/dist/formats/gr2/core/oodle1.js +388 -388
  120. package/dist/formats/gr2/core/tangents.js +48 -48
  121. package/dist/formats/gr2/core/targets.js +361 -361
  122. package/dist/formats/gr2/index.js +2 -2
  123. package/dist/formats/hlsl/CjsHlslFormat.js +254 -254
  124. package/dist/formats/hlsl/core/HlslBinaryUtils.js +15 -15
  125. package/dist/formats/hlsl/core/HlslEffectReadError.js +19 -19
  126. package/dist/formats/hlsl/core/HlslEffectStateManager.js +130 -130
  127. package/dist/formats/hlsl/core/HlslRenderStateSetup.js +37 -37
  128. package/dist/formats/hlsl/core/HlslResourceSetDescription.js +94 -94
  129. package/dist/formats/hlsl/core/HlslShaderBytecode.js +44 -44
  130. package/dist/formats/hlsl/core/analysis.js +51 -51
  131. package/dist/formats/hlsl/core/carbonDescriptionToRuntime.js +850 -781
  132. package/dist/formats/hlsl/core/carbonDescriptionToRuntime.js.map +1 -1
  133. package/dist/formats/hlsl/core/detailMapFamily.js +128 -0
  134. package/dist/formats/hlsl/core/detailMapFamily.js.map +1 -0
  135. package/dist/formats/hlsl/core/helpers.js +270 -270
  136. package/dist/formats/hlsl/core/json.js +284 -284
  137. package/dist/formats/hlsl/core/localLightFamily.js +133 -0
  138. package/dist/formats/hlsl/core/localLightFamily.js.map +1 -0
  139. package/dist/formats/hlsl/core/metadata.js +327 -327
  140. package/dist/formats/hlsl/core/render-states.js +280 -280
  141. package/dist/formats/hlsl/core/tr2/HlslRenderContextEnum.js +43 -43
  142. package/dist/formats/hlsl/core/tr2/resources/HlslEffectRes.js +320 -314
  143. package/dist/formats/hlsl/core/tr2/resources/HlslEffectRes.js.map +1 -1
  144. package/dist/formats/hlsl/core/tr2/resources/HlslShaderPermutation.js +33 -33
  145. package/dist/formats/hlsl/core/tr2/shader/HlslEffectBindingManifest.js +416 -416
  146. package/dist/formats/hlsl/core/tr2/shader/HlslEffectConstant.js +40 -40
  147. package/dist/formats/hlsl/core/tr2/shader/HlslEffectDescription.js +62 -742
  148. package/dist/formats/hlsl/core/tr2/shader/HlslEffectDescription.js.map +1 -1
  149. package/dist/formats/hlsl/core/tr2/shader/HlslEffectLibrary.js +52 -52
  150. package/dist/formats/hlsl/core/tr2/shader/HlslEffectParameterAnnotation.js +38 -38
  151. package/dist/formats/hlsl/core/tr2/shader/HlslEffectResource.js +50 -50
  152. package/dist/formats/hlsl/core/tr2/shader/HlslEffectStageInput.js +86 -86
  153. package/dist/formats/hlsl/core/tr2/shader/HlslEffectTechnique.js +31 -31
  154. package/dist/formats/hlsl/core/tr2/shader/HlslPass.js +42 -42
  155. package/dist/formats/hlsl/core/tr2/shader/HlslSamplerDescription.js +55 -55
  156. package/dist/formats/hlsl/core/tr2/shader/HlslSamplerSetup.js +29 -29
  157. package/dist/formats/hlsl/core/tr2/shader/HlslShader.js +220 -220
  158. package/dist/formats/hlsl/core/tr2/shader/HlslShaderOption.js +30 -30
  159. package/dist/formats/hlsl/index.js +3 -3
  160. package/dist/formats/index.js +33 -31
  161. package/dist/formats/index.js.map +1 -1
  162. package/dist/formats/jpeg/CjsJpegFormat.js +212 -212
  163. package/dist/formats/jpeg/core/helpers.js +402 -402
  164. package/dist/formats/jpeg/core/jpeg.js +480 -480
  165. package/dist/formats/jpeg/index.js +2 -2
  166. package/dist/formats/mp3/CjsMp3Format.js +197 -197
  167. package/dist/formats/mp3/core/helpers.js +375 -375
  168. package/dist/formats/mp3/index.js +2 -2
  169. package/dist/formats/mp4/CjsMp4Format.js +197 -197
  170. package/dist/formats/mp4/core/helpers.js +484 -484
  171. package/dist/formats/mp4/index.js +2 -2
  172. package/dist/formats/obj/CjsObjFormat.js +253 -253
  173. package/dist/formats/obj/core/helpers.js +573 -573
  174. package/dist/formats/obj/core/json.js +64 -64
  175. package/dist/formats/obj/core/parser.js +321 -321
  176. package/dist/formats/obj/index.js +2 -2
  177. package/dist/formats/ogg/CjsOggFormat.js +143 -143
  178. package/dist/formats/ogg/core/helpers.js +410 -410
  179. package/dist/formats/ogg/core/imdct.js +178 -178
  180. package/dist/formats/ogg/core/vorbis.js +1017 -1017
  181. package/dist/formats/ogg/index.js +2 -2
  182. package/dist/formats/pickle/CjsPickleFormat.js +214 -0
  183. package/dist/formats/pickle/CjsPickleFormat.js.map +1 -0
  184. package/dist/formats/pickle/core/CjsPickleProtocol0Reader.js +551 -0
  185. package/dist/formats/pickle/core/CjsPickleProtocol0Reader.js.map +1 -0
  186. package/dist/formats/pickle/index.js +2 -0
  187. package/dist/formats/pickle/index.js.map +1 -0
  188. package/dist/formats/png/CjsPngFormat.js +201 -201
  189. package/dist/formats/png/core/helpers.js +635 -635
  190. package/dist/formats/png/index.js +2 -2
  191. package/dist/formats/red/CjsRedFormat.js +263 -263
  192. package/dist/formats/red/core/CjsRedReader.js +246 -246
  193. package/dist/formats/red/core/blackDefinitions.js +3 -3
  194. package/dist/formats/red/core/helpers.js +158 -158
  195. package/dist/formats/red/core/redGraph.js +71 -68
  196. package/dist/formats/red/core/redGraph.js.map +1 -1
  197. package/dist/formats/red/core/schema.js +4 -4
  198. package/dist/formats/red/index.js +2 -2
  199. package/dist/formats/stl/CjsStlFormat.js +365 -365
  200. package/dist/formats/stl/core/helpers.js +261 -261
  201. package/dist/formats/stl/core/json.js +51 -51
  202. package/dist/formats/stl/core/stl.js +642 -642
  203. package/dist/formats/stl/core/targets.js +173 -173
  204. package/dist/formats/stl/index.js +2 -2
  205. package/dist/formats/tga/CjsTgaFormat.js +197 -197
  206. package/dist/formats/tga/core/helpers.js +493 -493
  207. package/dist/formats/tga/index.js +2 -2
  208. package/dist/formats/wav/CjsWavFormat.js +198 -198
  209. package/dist/formats/wav/core/helpers.js +365 -365
  210. package/dist/formats/wav/index.js +2 -2
  211. package/dist/formats/webgl/CjsWebglFormat.js +199 -221
  212. package/dist/formats/webgl/CjsWebglFormat.js.map +1 -1
  213. package/dist/formats/webgl/core/buildGlslEffectContainer.js +70 -0
  214. package/dist/formats/webgl/core/buildGlslEffectContainer.js.map +1 -0
  215. package/dist/formats/webgl/core/effectPackage.js +900 -792
  216. package/dist/formats/webgl/core/effectPackage.js.map +1 -1
  217. package/dist/formats/webgl/core/errors.js +27 -27
  218. package/dist/formats/webgl/core/errors.js.map +1 -1
  219. package/dist/formats/webgl/core/glsl/DxbcGlslEmitter.js +2820 -2678
  220. package/dist/formats/webgl/core/glsl/DxbcGlslEmitter.js.map +1 -1
  221. package/dist/formats/webgl/core/glsl/DxbcGlslHelpers.js +89 -89
  222. package/dist/formats/webgl/core/glsl/DxbcGlslOperandFormatter.js +486 -428
  223. package/dist/formats/webgl/core/glsl/DxbcGlslOperandFormatter.js.map +1 -1
  224. package/dist/formats/webgl/core/glsl/packedLightFixups.js +98 -0
  225. package/dist/formats/webgl/core/glsl/packedLightFixups.js.map +1 -0
  226. package/dist/formats/webgl/core/glslBackendBlock.js +552 -0
  227. package/dist/formats/webgl/core/glslBackendBlock.js.map +1 -0
  228. package/dist/formats/webgl/core/glslBackendBodySet.js +243 -0
  229. package/dist/formats/webgl/core/glslBackendBodySet.js.map +1 -0
  230. package/dist/formats/webgl/core/{cewgCompleteness.js → glslEffectCompleteness.js} +85 -81
  231. package/dist/formats/webgl/core/glslEffectCompleteness.js.map +1 -0
  232. package/dist/formats/webgl/core/helpers.js +167 -306
  233. package/dist/formats/webgl/core/helpers.js.map +1 -1
  234. package/dist/formats/webgl/core/inspectGlslEffectContainer.js +122 -0
  235. package/dist/formats/webgl/core/inspectGlslEffectContainer.js.map +1 -0
  236. package/dist/formats/webgl/core/readGlslEffectContainer.js +303 -0
  237. package/dist/formats/webgl/core/readGlslEffectContainer.js.map +1 -0
  238. package/dist/formats/webgl/index.js +2 -2
  239. package/dist/formats/webgpu/CjsWebgpuFormat.js +357 -357
  240. package/dist/formats/webgpu/CjsWebgpuFormat.js.map +1 -1
  241. package/dist/formats/webgpu/core/buildCarbonEffectContainer.js +89 -197
  242. package/dist/formats/webgpu/core/buildCarbonEffectContainer.js.map +1 -1
  243. package/dist/formats/webgpu/core/{cewgpu/CewgpuContainer.js → carbonWebgpu/CarbonWebgpuContainer.js} +354 -368
  244. package/dist/formats/webgpu/core/carbonWebgpu/CarbonWebgpuContainer.js.map +1 -0
  245. package/dist/formats/webgpu/core/{cewgpu → carbonWebgpu}/containerViews.js +355 -355
  246. package/dist/formats/webgpu/core/carbonWebgpu/containerViews.js.map +1 -0
  247. package/dist/formats/webgpu/core/{cewgpu → carbonWebgpu}/validateContainer.js +90 -90
  248. package/dist/formats/webgpu/core/carbonWebgpu/validateContainer.js.map +1 -0
  249. package/dist/formats/webgpu/core/effectAnalysis.js +82 -82
  250. package/dist/formats/webgpu/core/effectBackendBodySet.js +289 -289
  251. package/dist/formats/webgpu/core/effectBackendBodySet.js.map +1 -1
  252. package/dist/formats/webgpu/core/errors.js +20 -20
  253. package/dist/formats/webgpu/core/errors.js.map +1 -1
  254. package/dist/formats/webgpu/core/helpers.js +443 -443
  255. package/dist/formats/webgpu/core/helpers.js.map +1 -1
  256. package/dist/formats/webgpu/core/ir/analyzeRegisterValues.js +212 -212
  257. package/dist/formats/webgpu/core/ir/buildControlFlow.js +220 -220
  258. package/dist/formats/webgpu/core/ir/indexableTemps.js +137 -137
  259. package/dist/formats/webgpu/core/ir/inferValueTypes.js +449 -449
  260. package/dist/formats/webgpu/core/ir/lowerDxbcToIr.js +494 -494
  261. package/dist/formats/webgpu/core/ir/resolveRegisterFlow.js +177 -177
  262. package/dist/formats/webgpu/core/ir/sourceLanes.js +61 -61
  263. package/dist/formats/webgpu/core/packageEffect.js +381 -385
  264. package/dist/formats/webgpu/core/packageEffect.js.map +1 -1
  265. package/dist/formats/webgpu/core/packageEffectSelection.js +164 -164
  266. package/dist/formats/webgpu/core/packageEffectSelection.js.map +1 -1
  267. package/dist/formats/webgpu/core/packageMetadata.js +17 -17
  268. package/dist/formats/webgpu/core/schema.js +4 -4
  269. package/dist/formats/webgpu/core/wgsl/buildResourceTransformPlan.js +263 -263
  270. package/dist/formats/webgpu/core/wgsl/buildResourceTransformPlan.js.map +1 -1
  271. package/dist/formats/webgpu/core/wgsl/buildWgslBindingPlan.js +172 -172
  272. package/dist/formats/webgpu/core/wgsl/buildWgslSet.js +320 -320
  273. package/dist/formats/webgpu/core/wgsl/buildWgslSet.js.map +1 -1
  274. package/dist/formats/webgpu/core/wgsl/emitWgsl.js +356 -356
  275. package/dist/formats/webgpu/core/wgsl/hoistEscapingValues.js +77 -77
  276. package/dist/formats/webgpu/core/wgsl/lowerBindingLayout.js +451 -451
  277. package/dist/formats/webgpu/core/wgsl/lowerComputeProgram.js +735 -735
  278. package/dist/formats/webgpu/core/wgsl/lowerCreateHistogramsComputeProgram.js +457 -457
  279. package/dist/formats/webgpu/core/wgsl/lowerFragmentProgram.js +1572 -1572
  280. package/dist/formats/webgpu/core/wgsl/lowerMergeHistogramsComputeProgram.js +659 -659
  281. package/dist/formats/webgpu/core/wgsl/lowerParticleClearComputePrograms.js +734 -734
  282. package/dist/formats/webgpu/core/wgsl/lowerParticleEmitComputeProgram.js +583 -583
  283. package/dist/formats/webgpu/core/wgsl/lowerSkinVerticesComputeProgram.js +621 -621
  284. package/dist/formats/webgpu/core/wgsl/lowerSortComputeProgram.js +824 -824
  285. package/dist/formats/webgpu/core/wgsl/lowerSortInnerComputeProgram.js +697 -697
  286. package/dist/formats/webgpu/core/wgsl/lowerSortStepComputeProgram.js +559 -559
  287. package/dist/formats/webgpu/core/wgsl/lowerVertexProgram.js +1328 -1328
  288. package/dist/formats/webgpu/core/wgsl/particleEmitSemanticDigest.js +110 -110
  289. package/dist/formats/webgpu/core/wgsl/precisionControls.js +55 -55
  290. package/dist/formats/webgpu/core/wgsl/selectionPlans.js +717 -717
  291. package/dist/formats/webgpu/core/wgsl/uniformity.js +78 -78
  292. package/dist/formats/webgpu/core/wgsl/validateExactComputeIr.js +196 -196
  293. package/dist/formats/webgpu/core/wgsl/validateHandleOperand.js +37 -37
  294. package/dist/formats/webgpu/index.js +2 -2
  295. package/dist/formats/webm/CjsWebmFormat.js +197 -197
  296. package/dist/formats/webm/core/helpers.js +572 -572
  297. package/dist/formats/webm/index.js +2 -2
  298. package/dist/formats/webp/CjsWebpFormat.js +140 -140
  299. package/dist/formats/webp/core/helpers.js +237 -237
  300. package/dist/formats/webp/index.js +2 -2
  301. package/dist/formats/wem/CjsWemFormat.js +250 -250
  302. package/dist/formats/wem/core/bitStream.js +261 -261
  303. package/dist/formats/wem/core/codebookLibrary.js +164 -164
  304. package/dist/formats/wem/core/helpers.js +437 -437
  305. package/dist/formats/wem/core/packedCodebooksAotuv603.js +30 -30
  306. package/dist/formats/wem/core/ptadpcm.js +77 -77
  307. package/dist/formats/wem/core/resolve.js +121 -121
  308. package/dist/formats/wem/core/wemToOgg.js +485 -485
  309. package/dist/formats/wem/index.js +2 -2
  310. package/dist/formats/yaml/CjsYamlFormat.js +134 -134
  311. package/dist/formats/yaml/CjsYamlFormat.js.map +1 -1
  312. package/dist/formats/yaml/core/CjsYamlReader.js +400 -402
  313. package/dist/formats/yaml/core/CjsYamlReader.js.map +1 -1
  314. package/dist/formats/yaml/core/helpers.js +196 -170
  315. package/dist/formats/yaml/core/helpers.js.map +1 -1
  316. package/dist/formats/yaml/index.js +2 -2
  317. package/dist/index.js +64 -62
  318. package/dist/index.js.map +1 -1
  319. package/dist/resource/CjsLoadingObject.js +19 -0
  320. package/dist/resource/CjsLoadingObject.js.map +1 -0
  321. package/dist/resource/CjsResource.js +801 -797
  322. package/dist/resource/CjsResource.js.map +1 -1
  323. package/dist/resource/ResourceHandlerMode.js +14 -0
  324. package/dist/resource/ResourceHandlerMode.js.map +1 -0
  325. package/dist/resource/Tr2LightProfileRes.js +32 -32
  326. package/dist/resource/audio/AudioGeometryResData.js +47 -47
  327. package/dist/resource/audio/CjsAudioBufferRes.js +86 -86
  328. package/dist/resource/audio/CjsAudioRes.js +213 -213
  329. package/dist/resource/audio/index.js +4 -4
  330. package/dist/resource/geometry/MeshDecalData.js +37 -37
  331. package/dist/resource/geometry/MeshDecalLodData.js +34 -34
  332. package/dist/resource/geometry/TriGeometryRes.js +675 -675
  333. package/dist/resource/geometry/TriGeometryResAreaData.js +59 -59
  334. package/dist/resource/geometry/TriGeometryResJointData.js +38 -38
  335. package/dist/resource/geometry/TriGeometryResLodData.js +88 -88
  336. package/dist/resource/geometry/TriGeometryResMeshData.js +63 -63
  337. package/dist/resource/geometry/TriGeometryResSkeletonData.js +34 -34
  338. package/dist/resource/geometry/TriJointBinding.js +38 -38
  339. package/dist/resource/geometry/TriMorphTargetGeometryConstants.js +46 -46
  340. package/dist/resource/geometry/TriRtGeometryConstants.js +88 -88
  341. package/dist/resource/geometry/granny/GStateBindingCallbackData.js +31 -31
  342. package/dist/resource/geometry/granny/Tr2GrannyIntersectionResult.js +60 -60
  343. package/dist/resource/geometry/granny/Tr2GrannyStateRes.js +36 -36
  344. package/dist/resource/geometry/granny/TriGrannyRes.js +35 -35
  345. package/dist/resource/geometry/granny/enums.js +10 -10
  346. package/dist/resource/geometry/granny/index.js +6 -6
  347. package/dist/resource/geometry/index.js +17 -17
  348. package/dist/resource/index.js +54 -52
  349. package/dist/resource/index.js.map +1 -1
  350. package/dist/resource/resourceBoundary.js +64 -64
  351. package/dist/resource/shader/Tr2EffectRes.js +336 -431
  352. package/dist/resource/shader/Tr2EffectRes.js.map +1 -1
  353. package/dist/resource/shader/Tr2MaterialArea.js +31 -31
  354. package/dist/resource/shader/Tr2MaterialMesh.js +27 -27
  355. package/dist/resource/shader/Tr2MaterialRes.js +31 -31
  356. package/dist/resource/shader/Tr2Shader.js +283 -261
  357. package/dist/resource/shader/Tr2Shader.js.map +1 -1
  358. package/dist/resource/shader/Tr2ShaderPermutation.js +43 -43
  359. package/dist/resource/shader/index.js +17 -17
  360. package/dist/resource/shader/reflection/Tr2EffectConstant.js +143 -135
  361. package/dist/resource/shader/reflection/Tr2EffectConstant.js.map +1 -1
  362. package/dist/resource/shader/reflection/Tr2EffectDefine.js +30 -30
  363. package/dist/resource/shader/reflection/Tr2EffectDescription.js +114 -109
  364. package/dist/resource/shader/reflection/Tr2EffectDescription.js.map +1 -1
  365. package/dist/resource/shader/reflection/Tr2EffectLibrary.js +168 -147
  366. package/dist/resource/shader/reflection/Tr2EffectLibrary.js.map +1 -1
  367. package/dist/resource/shader/reflection/Tr2EffectParameterAnnotation.js +125 -105
  368. package/dist/resource/shader/reflection/Tr2EffectParameterAnnotation.js.map +1 -1
  369. package/dist/resource/shader/reflection/Tr2EffectResource.js +120 -86
  370. package/dist/resource/shader/reflection/Tr2EffectResource.js.map +1 -1
  371. package/dist/resource/shader/reflection/Tr2EffectStageInput.js +372 -241
  372. package/dist/resource/shader/reflection/Tr2EffectStageInput.js.map +1 -1
  373. package/dist/resource/shader/reflection/Tr2EffectTechnique.js +78 -68
  374. package/dist/resource/shader/reflection/Tr2EffectTechnique.js.map +1 -1
  375. package/dist/resource/shader/reflection/Tr2Pass.js +168 -111
  376. package/dist/resource/shader/reflection/Tr2Pass.js.map +1 -1
  377. package/dist/resource/shader/reflection/carbonRecordFields.js +159 -0
  378. package/dist/resource/shader/reflection/carbonRecordFields.js.map +1 -0
  379. package/dist/resource/shader/reflection/shaderStage.js +22 -0
  380. package/dist/resource/shader/reflection/shaderStage.js.map +1 -0
  381. package/dist/resource/shader/sampler/Tr2SamplerSetup.js +135 -77
  382. package/dist/resource/shader/sampler/Tr2SamplerSetup.js.map +1 -1
  383. package/dist/resource/texture/CjsTextureArrayRes.js +472 -472
  384. package/dist/resource/texture/CjsTextureArrayResParameterProxy.js +179 -179
  385. package/dist/resource/texture/Tr2ImageRes.js +120 -120
  386. package/dist/resource/texture/Tr2TextureLodManager.js +82 -82
  387. package/dist/resource/texture/Tr2TextureLodUpdateRequest.js +37 -37
  388. package/dist/resource/texture/Tr2TexturePackChannel.js +37 -37
  389. package/dist/resource/texture/Tr2TexturePipeline.js +54 -54
  390. package/dist/resource/texture/Tr2TexturePipelineParams.js +34 -34
  391. package/dist/resource/texture/Tr2TexturePipelineStepCompress.js +40 -40
  392. package/dist/resource/texture/Tr2TexturePipelineStepGenerateMips.js +22 -22
  393. package/dist/resource/texture/Tr2TexturePipelineStepLimitSize.js +34 -34
  394. package/dist/resource/texture/Tr2TexturePipelineStepLoad.js +31 -31
  395. package/dist/resource/texture/Tr2TexturePipelineStepPack.js +43 -43
  396. package/dist/resource/texture/TriTextureRes.js +359 -359
  397. package/dist/resource/texture/index.js +15 -15
  398. package/dist/resource/texture/texturePipelineBehavior.js +308 -308
  399. package/dist/worker/CjsResManMainThreadLoader.js +89 -87
  400. package/dist/worker/CjsResManMainThreadLoader.js.map +1 -1
  401. package/dist/worker/CjsResManWorker.js +218 -217
  402. package/dist/worker/CjsResManWorker.js.map +1 -1
  403. package/dist/worker/CjsResManWorkerLoader.js +437 -434
  404. package/dist/worker/CjsResManWorkerLoader.js.map +1 -1
  405. package/dist/worker/protocol.js +12 -12
  406. package/docs/README.md +98 -98
  407. package/docs/architecture.md +118 -109
  408. package/docs/concepts/resource-lifecycle.md +226 -225
  409. package/docs/concepts/shader-resource-model.md +111 -114
  410. package/docs/concepts/writing-an-engine-adapter.md +115 -115
  411. package/docs/formats/README.md +138 -136
  412. package/docs/formats/carbon-effect-container.md +553 -452
  413. package/docs/formats/dxbc/README.md +68 -68
  414. package/docs/formats/dxbc/architecture.md +80 -80
  415. package/docs/formats/dxbc/reference/api.md +77 -77
  416. package/docs/formats/dxbc/reference/classes/README.md +9 -9
  417. package/docs/formats/dxbc/reference/decoded-output.md +122 -122
  418. package/docs/formats/gr2.md +160 -160
  419. package/docs/formats/hlsl/README.md +54 -54
  420. package/docs/formats/hlsl/architecture.md +65 -67
  421. package/docs/formats/hlsl/guides/hydrating-json-output.md +60 -62
  422. package/docs/formats/hlsl/guides/reading-effects.md +64 -64
  423. package/docs/formats/hlsl/reference/advanced-analysis.md +61 -66
  424. package/docs/formats/hlsl/reference/api.md +92 -98
  425. package/docs/formats/hlsl/reference/classes/README.md +11 -11
  426. package/docs/formats/hlsl/reference/json-graph.md +97 -100
  427. package/docs/formats/pickle.md +82 -0
  428. package/docs/formats/provenance.md +196 -196
  429. package/docs/formats/stl.md +37 -37
  430. package/docs/formats/webgl/README.md +115 -57
  431. package/docs/formats/webgl/architecture.md +69 -70
  432. package/docs/formats/webgl/carbon-constant-layouts.md +326 -326
  433. package/docs/formats/webgl/decl-io.md +1234 -1234
  434. package/docs/formats/webgl/memory-structured.md +890 -871
  435. package/docs/formats/webgl/reference/classes/README.md +9 -9
  436. package/docs/formats/webgl/texture-sample.md +964 -964
  437. package/docs/formats/webgpu/README.md +84 -84
  438. package/docs/formats/webgpu/architecture.md +95 -96
  439. package/docs/formats/webgpu/formats/{cewgpu.md → carbon-webgpu.md} +215 -216
  440. package/docs/formats/webgpu/guides/effect-packaging.md +189 -191
  441. package/docs/formats/webgpu/reference/api.md +196 -197
  442. package/docs/formats/webgpu/reference/classes/README.md +9 -9
  443. package/docs/formats/webgpu/reference/wgsl-compatibility.md +1546 -1543
  444. package/docs/formats/wwise.md +146 -85
  445. package/docs/reference/classes/README.md +35 -35
  446. package/docs/reference/classes/audio.md +30 -30
  447. package/docs/reference/classes/core.md +216 -206
  448. package/docs/reference/classes/dropped.md +46 -46
  449. package/docs/reference/classes/formats.md +944 -952
  450. package/docs/reference/classes/resources.md +456 -456
  451. package/docs/reference/classes/texture.md +26 -26
  452. package/docs/reference/events.md +117 -117
  453. package/docs/reference/motherlode-cache.md +275 -275
  454. package/docs/reference/queues.md +194 -110
  455. package/docs/reference/reload.md +107 -107
  456. package/docs/reference/texture-arrays.md +113 -113
  457. package/docs/reference/texture-pipeline.md +53 -53
  458. package/docs/reference/workers.md +142 -135
  459. package/docs/roadmap.md +150 -150
  460. package/format-notices/black/LICENSE +21 -21
  461. package/format-notices/black/NOTICE +47 -47
  462. package/format-notices/bnk/LICENSE +21 -21
  463. package/format-notices/bnk/NOTICE +21 -21
  464. package/format-notices/cmf/LICENSE +21 -21
  465. package/format-notices/cmf/NOTICE +36 -36
  466. package/format-notices/dds/LICENSE +21 -21
  467. package/format-notices/dds/NOTICE +14 -14
  468. package/format-notices/dxbc/LICENSE +21 -21
  469. package/format-notices/dxbc/NOTICE +20 -20
  470. package/format-notices/fbx/LICENSE +21 -21
  471. package/format-notices/fbx/NOTICE +14 -14
  472. package/format-notices/flac/LICENSE +21 -21
  473. package/format-notices/flac/NOTICE +14 -14
  474. package/format-notices/gif/LICENSE +21 -21
  475. package/format-notices/gif/NOTICE +14 -14
  476. package/format-notices/gltf/LICENSE +21 -21
  477. package/format-notices/gltf/NOTICE +27 -27
  478. package/format-notices/gr2/LICENSE +21 -21
  479. package/format-notices/gr2/NOTICE +60 -60
  480. package/format-notices/gr2/THIRD-PARTY-NOTICES.md +93 -93
  481. package/format-notices/hlsl/LICENSE +21 -21
  482. package/format-notices/hlsl/NOTICE +25 -25
  483. package/format-notices/jpeg/LICENSE +21 -21
  484. package/format-notices/jpeg/NOTICE +14 -14
  485. package/format-notices/mp3/LICENSE +21 -21
  486. package/format-notices/mp3/NOTICE +14 -14
  487. package/format-notices/mp4/LICENSE +21 -21
  488. package/format-notices/mp4/NOTICE +14 -14
  489. package/format-notices/obj/LICENSE +21 -21
  490. package/format-notices/obj/NOTICE +26 -26
  491. package/format-notices/ogg/LICENSE +21 -21
  492. package/format-notices/ogg/NOTICE +28 -28
  493. package/format-notices/png/LICENSE +21 -21
  494. package/format-notices/png/NOTICE +14 -14
  495. package/format-notices/red/LICENSE +21 -21
  496. package/format-notices/red/NOTICE +31 -31
  497. package/format-notices/stl/LICENSE +21 -21
  498. package/format-notices/stl/NOTICE +21 -21
  499. package/format-notices/tga/LICENSE +21 -21
  500. package/format-notices/tga/NOTICE +14 -14
  501. package/format-notices/wav/LICENSE +21 -21
  502. package/format-notices/wav/NOTICE +14 -14
  503. package/format-notices/webgl/LICENSE +21 -21
  504. package/format-notices/webgl/NOTICE +35 -35
  505. package/format-notices/webgpu/LICENSE +21 -21
  506. package/format-notices/webgpu/NOTICE +31 -31
  507. package/format-notices/webm/LICENSE +21 -21
  508. package/format-notices/webm/NOTICE +14 -14
  509. package/format-notices/webp/LICENSE +21 -21
  510. package/format-notices/webp/NOTICE +14 -14
  511. package/format-notices/wem/LICENSE +57 -57
  512. package/format-notices/wem/NOTICE +33 -33
  513. package/format-notices/yaml/LICENSE +21 -21
  514. package/format-notices/yaml/NOTICE +44 -44
  515. package/package.json +63 -63
  516. package/dist/format/carbonEffect/carbonDescriptionFromPortable.js +0 -372
  517. package/dist/format/carbonEffect/carbonDescriptionFromPortable.js.map +0 -1
  518. package/dist/format/effect/effectReflectionPackage.js +0 -636
  519. package/dist/format/effect/effectReflectionPackage.js.map +0 -1
  520. package/dist/formats/hlsl/core/HlslReader.js +0 -16
  521. package/dist/formats/hlsl/core/HlslReader.js.map +0 -1
  522. package/dist/formats/hlsl/core/portableReflection.js +0 -848
  523. package/dist/formats/hlsl/core/portableReflection.js.map +0 -1
  524. package/dist/formats/hlsl/portable.js +0 -2
  525. package/dist/formats/hlsl/portable.js.map +0 -1
  526. package/dist/formats/webgl/core/cewg/CewgPackage.js +0 -340
  527. package/dist/formats/webgl/core/cewg/CewgPackage.js.map +0 -1
  528. package/dist/formats/webgl/core/cewg/CewgPackageBuilder.js +0 -104
  529. package/dist/formats/webgl/core/cewg/CewgPackageBuilder.js.map +0 -1
  530. package/dist/formats/webgl/core/cewg/binary.js +0 -19
  531. package/dist/formats/webgl/core/cewg/binary.js.map +0 -1
  532. package/dist/formats/webgl/core/cewgCompleteness.js.map +0 -1
  533. package/dist/formats/webgl/core/effectPackageValidation.js +0 -331
  534. package/dist/formats/webgl/core/effectPackageValidation.js.map +0 -1
  535. package/dist/formats/webgpu/core/cewgpu/CewgpuContainer.js.map +0 -1
  536. package/dist/formats/webgpu/core/cewgpu/containerViews.js.map +0 -1
  537. package/dist/formats/webgpu/core/cewgpu/validateContainer.js.map +0 -1
  538. package/dist/resource/shader/portable.js +0 -33
  539. package/dist/resource/shader/portable.js.map +0 -1
  540. package/docs/formats/hlsl/reference/portable-reflection.md +0 -141
  541. 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 CEWG 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
- * @param {object[]} stages CEWG stage records.
9
- * @param {object[]} shaders CEWG translated shader records.
10
- * @returns {{ expectedPassCount: number, completePassCount: number, incompletePasses: object[] }}
11
- */
12
- function inspectCewgRasterCompleteness(stages, shaders) {
13
- const shaderMap = new Map((shaders || []).map(shader => [shader.key, shader]));
14
- const usesSharedShaders = Array.isArray(shaders);
15
- const groups = new Map();
16
- for (const stage of stages || []) {
17
- if (stage.stageName !== "vertex" && stage.stageName !== "pixel") continue;
18
- const key = [stage.bodyKey || "selected", stage.techniqueName || "Main", Number.isInteger(stage.passIndex) ? stage.passIndex : 0].join(":");
19
- let group = groups.get(key);
20
- if (!group) {
21
- group = {
22
- key,
23
- bodyKey: stage.bodyKey || "selected",
24
- techniqueName: stage.techniqueName || "Main",
25
- passIndex: Number.isInteger(stage.passIndex) ? stage.passIndex : 0,
26
- vertex: null,
27
- pixel: null,
28
- duplicateStages: []
29
- };
30
- groups.set(key, group);
31
- }
32
- if (group[stage.stageName]) {
33
- group.duplicateStages.push(stage.stageName);
34
- }
35
- group[stage.stageName] = stage;
36
- }
37
- const incompletePasses = [];
38
- let completePassCount = 0;
39
- for (const group of groups.values()) {
40
- const missingStages = [];
41
- const unavailableStages = [];
42
- for (const stageName of ["vertex", "pixel"]) {
43
- const stage = group[stageName];
44
- if (!stage) {
45
- missingStages.push(stageName);
46
- continue;
47
- }
48
- const shader = usesSharedShaders ? shaderMap.get(stage.shaderKey) : stage;
49
- if (!shader?.hlsl2webgl?.ok || !shader.source) {
50
- unavailableStages.push({
51
- stageName,
52
- stageKey: stage.key,
53
- shaderKey: stage.shaderKey,
54
- excluded: shader?.excluded || null,
55
- reason: shader?.hlsl2webgl?.validationError || shader?.hlsl2webgl?.reason || shader?.hlsl2webgl?.error || shader?.excluded?.reason || "translated source is unavailable"
56
- });
57
- }
58
- }
59
- if (!missingStages.length && !unavailableStages.length && !group.duplicateStages.length) {
60
- completePassCount += 1;
61
- continue;
62
- }
63
- incompletePasses.push({
64
- key: group.key,
65
- bodyKey: group.bodyKey,
66
- techniqueName: group.techniqueName,
67
- passIndex: group.passIndex,
68
- missingStages,
69
- unavailableStages,
70
- duplicateStages: [...new Set(group.duplicateStages)].sort()
71
- });
72
- }
73
- return {
74
- expectedPassCount: groups.size,
75
- completePassCount,
76
- incompletePasses
77
- };
78
- }
79
-
80
- export { inspectCewgRasterCompleteness };
81
- //# sourceMappingURL=cewgCompleteness.js.map
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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"}