@carbonenginejs/runtime-resource 0.12.1 → 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
@@ -1 +1 @@
1
- {"version":3,"file":"buildResourceTransformPlan.js","sources":["../../../../../../src/formats/webgpu/core/wgsl/buildResourceTransformPlan.js"],"sourcesContent":["import { compareUtf8 } from \"../../../../format/compareUtf8.js\";\r\n\r\nconst RESOURCE_IDENTITY = /^sampled-resource:(\\d+):(\\d+)$/u;\r\nconst DETAIL_PARAMETER = /^Detail(\\d+)Map$/u;\r\nconst SAMPLE_OPCODES = new Set([ \"sample_b\" ]);\r\n\r\nfunction deepFreeze(value)\r\n{\r\n if (!value || typeof value !== \"object\" || Object.isFrozen(value)) return value;\r\n for (const entry of Object.values(value)) deepFreeze(entry);\r\n return Object.freeze(value);\r\n}\r\n\r\nfunction bindingRegister(binding)\r\n{\r\n return binding.range?.lowerBound ?? binding.registerIndex;\r\n}\r\n\r\nfunction bindingSpace(binding)\r\n{\r\n return binding.range?.registerSpace ?? 0;\r\n}\r\n\r\nfunction bindingIdentity(binding)\r\n{\r\n return `${binding.resourceKind}:${bindingSpace(binding)}:${bindingRegister(binding)}`;\r\n}\r\n\r\nfunction scopeIdentity(identity, stage)\r\n{\r\n return `${identity}@${stage}`;\r\n}\r\n\r\nfunction normalizeInput(input, transformId, index)\r\n{\r\n const parameter = input?.parameter;\r\n const layer = input?.layer;\r\n const identity = input?.identity;\r\n const scoped = input?.scopeIdentity;\r\n if (typeof parameter !== \"string\" || !parameter\r\n || !Number.isInteger(layer) || layer !== index\r\n || typeof identity !== \"string\" || !RESOURCE_IDENTITY.test(identity)\r\n || scoped !== `${identity}@fragment`)\r\n {\r\n throw new Error(`WGSL resource transform ${transformId} has an invalid input at layer ${index}`);\r\n }\r\n return { parameter, layer, identity, scopeIdentity: scoped };\r\n}\r\n\r\nfunction normalizeTransform(transform)\r\n{\r\n const id = transform?.id;\r\n if (typeof id !== \"string\" || !id\r\n || transform.version !== 1\r\n || transform.kind !== \"texture-2d-array\"\r\n || typeof transform.layoutKey !== \"string\" || !transform.layoutKey\r\n || transform.stage !== \"fragment\"\r\n || !Array.isArray(transform.inputs)\r\n || transform.inputs.length < 2)\r\n {\r\n throw new Error(`WGSL resource transform ${id || \"<unknown>\"} has an invalid texture-array contract`);\r\n }\r\n const inputs = transform.inputs.map((input, index) => normalizeInput(input, id, index));\r\n const inputParameters = new Set(inputs.map((input) => input.parameter));\r\n const inputIdentities = new Set(inputs.map((input) => input.identity));\r\n if (inputParameters.size !== inputs.length || inputIdentities.size !== inputs.length)\r\n {\r\n throw new Error(`WGSL resource transform ${id} contains duplicate inputs`);\r\n }\r\n const output = transform.output;\r\n if (typeof output?.name !== \"string\" || !output.name\r\n || output.identity !== inputs[0].identity\r\n || output.scopeIdentity !== inputs[0].scopeIdentity\r\n || output.viewDimension !== \"2d-array\"\r\n || output.layerCount !== inputs.length\r\n || transform.representation !== \"native-or-rgba8\"\r\n || transform.missingLayer !== \"reject\")\r\n {\r\n throw new Error(`WGSL resource transform ${id} has an invalid output contract`);\r\n }\r\n return {\r\n id,\r\n version: 1,\r\n kind: \"texture-2d-array\",\r\n layoutKey: transform.layoutKey,\r\n stage: \"fragment\",\r\n inputs,\r\n output: {\r\n name: output.name,\r\n identity: output.identity,\r\n scopeIdentity: output.scopeIdentity,\r\n viewDimension: \"2d-array\",\r\n layerCount: output.layerCount\r\n },\r\n representation: \"native-or-rgba8\",\r\n missingLayer: \"reject\"\r\n };\r\n}\r\n\r\n/**\r\n * Validates and freezes the compiler-owned resource-transform plan.\r\n *\r\n * @param {object|null|undefined} value Candidate plan.\r\n * @param {string|null} [layoutKey] Optional expected pass layout key.\r\n * @returns {object|null} Canonical frozen plan, or null.\r\n */\r\nexport function normalizeResourceTransformPlan(value, layoutKey = null)\r\n{\r\n if (value === undefined || value === null) return null;\r\n if (value?.format !== \"CJS_WGSL_RESOURCE_TRANSFORM_PLAN\"\r\n || value.formatVersion !== 1\r\n || !Array.isArray(value.resourceTransforms)\r\n || !value.resourceTransforms.length)\r\n {\r\n throw new TypeError(\"WGSL resource transform plan must be a non-empty version-1 document\");\r\n }\r\n const resourceTransforms = value.resourceTransforms.map(normalizeTransform)\r\n .sort((left, right) => compareUtf8(left.id, right.id));\r\n const ids = new Set();\r\n for (const transform of resourceTransforms)\r\n {\r\n if (ids.has(transform.id))\r\n {\r\n throw new Error(`WGSL resource transform plan contains duplicate id ${transform.id}`);\r\n }\r\n ids.add(transform.id);\r\n if (layoutKey !== null && transform.layoutKey !== layoutKey)\r\n {\r\n throw new Error(`WGSL resource transform ${transform.id} targets ${transform.layoutKey}, expected ${layoutKey}`);\r\n }\r\n }\r\n return deepFreeze({\r\n format: \"CJS_WGSL_RESOURCE_TRANSFORM_PLAN\",\r\n formatVersion: 1,\r\n resourceTransforms\r\n });\r\n}\r\n\r\nfunction bindingMatchesForOperand(program, resourceKind, operand)\r\n{\r\n const candidates = program.bindings.filter((binding) =>\r\n binding.resourceKind === resourceKind);\r\n const rangeId = operand?.resourceReference?.rangeId;\r\n return Number.isInteger(rangeId)\r\n ? candidates.filter((binding) => binding.range?.rangeId === rangeId)\r\n : candidates.filter((binding) => bindingRegister(binding) === operand?.registerIndex);\r\n}\r\n\r\nfunction resolveBindingForOperand(program, resourceKind, operand)\r\n{\r\n const matches = bindingMatchesForOperand(program, resourceKind, operand);\r\n if (matches.length !== 1) return null;\r\n const binding = matches[0];\r\n const absolute = operand?.resourceReference?.absoluteIndex;\r\n if (operand?.typeName !== (resourceKind === \"sampler\" ? \"sampler\" : \"resource\")\r\n || (operand.modifierName ?? \"none\") !== \"none\"\r\n || (operand.minPrecisionName ?? \"default\") !== \"default\"\r\n || operand.nonUniform\r\n || operand.indices?.some((index) => index?.relative)\r\n || operand.resourceReference?.nonUniform\r\n || absolute?.relative\r\n || (absolute !== undefined\r\n && (absolute?.values?.length !== 1\r\n || absolute.values[0] !== bindingRegister(binding))))\r\n {\r\n return null;\r\n }\r\n return binding;\r\n}\r\n\r\nfunction operandFingerprint(operand)\r\n{\r\n return JSON.stringify({\r\n typeName: operand?.typeName ?? null,\r\n selectionModeName: operand?.selectionModeName ?? null,\r\n mask: operand?.mask ?? \"\",\r\n swizzle: operand?.swizzle ?? \"\",\r\n selected: operand?.selected ?? \"\",\r\n modifierName: operand?.modifierName ?? \"none\",\r\n minPrecisionName: operand?.minPrecisionName ?? \"default\",\r\n registerIndex: operand?.registerIndex ?? null,\r\n indices: (operand?.indices || []).map((index) => ({\r\n values: index?.values || [],\r\n relative: index?.relative ?? null\r\n })),\r\n immediateValues: (operand?.immediateValues || []).map((entry) => entry?.uint32)\r\n });\r\n}\r\n\r\nfunction semanticResource(binding)\r\n{\r\n if (binding?.kind !== \"resource\") return null;\r\n const parameter = binding.metadataName ?? binding.carbon?.name;\r\n if (typeof parameter !== \"string\" || !parameter) return null;\r\n return {\r\n parameter,\r\n registerIndex: binding.registerIndex,\r\n registerSpace: binding.registerSpace ?? 0,\r\n arrayElements: binding.arrayCount ?? binding.carbon?.arrayElements,\r\n type: binding.carbon?.type,\r\n isSRGB: binding.carbon?.isSRGB\r\n };\r\n}\r\n\r\nfunction rejectCandidate()\r\n{\r\n return null;\r\n}\r\n\r\n/**\r\n * Recognizes the exact Carbon Detail-map sample family and builds a late\r\n * physical texture-array overlay. The source IR remains unchanged.\r\n *\r\n * @param {Array<{ir: object, semanticBindings: object[]}>} entries Pass stages.\r\n * @param {object} options Planner options.\r\n * @param {string} options.layoutKey Canonical pass key.\r\n * @returns {object|null} Frozen transform plan, or null when proof is absent.\r\n */\r\nexport function buildResourceTransformPlan(entries, options = {})\r\n{\r\n if (!Array.isArray(entries) || !entries.length)\r\n {\r\n throw new TypeError(\"WGSL resource transform planning expects pass stage entries\");\r\n }\r\n const layoutKey = options.layoutKey;\r\n if (typeof layoutKey !== \"string\" || !layoutKey)\r\n {\r\n throw new TypeError(\"WGSL resource transform planning requires a layoutKey\");\r\n }\r\n const fragments = entries.filter((entry) => entry?.ir?.stage === \"pixel\");\r\n if (fragments.length !== 1) return null;\r\n const { ir: program } = fragments[0];\r\n if (program?.format !== \"CJS_SHADER_IR\" || program.formatVersion !== 1\r\n || !Array.isArray(fragments[0].semanticBindings))\r\n {\r\n throw new TypeError(\"WGSL resource transform planning requires version-1 IR and semantic bindings\");\r\n }\r\n const semanticResources = fragments[0].semanticBindings.map(semanticResource).filter(Boolean);\r\n const detailResources = semanticResources.filter((resource) => DETAIL_PARAMETER.test(resource.parameter));\r\n if (!detailResources.length) return null;\r\n const byName = new Map();\r\n for (const resource of detailResources)\r\n {\r\n if (byName.has(resource.parameter)) return rejectCandidate();\r\n byName.set(resource.parameter, resource);\r\n }\r\n const hasThird = byName.has(\"Detail3Map\");\r\n const parameters = hasThird\r\n ? [ \"Detail1Map\", \"Detail2Map\", \"Detail3Map\" ]\r\n : [ \"Detail1Map\", \"Detail2Map\" ];\r\n if (byName.size !== parameters.length\r\n || parameters.some((parameter) => !byName.has(parameter)))\r\n {\r\n return rejectCandidate();\r\n }\r\n\r\n const sources = [];\r\n for (const parameter of parameters)\r\n {\r\n const semantic = byName.get(parameter);\r\n if (!Number.isInteger(semantic.registerIndex) || semantic.registerIndex < 0\r\n || !Number.isInteger(semantic.registerSpace) || semantic.registerSpace < 0\r\n || semantic.arrayElements !== 1\r\n || semantic.type !== 2\r\n || semantic.isSRGB !== false)\r\n {\r\n return rejectCandidate();\r\n }\r\n const matches = program.bindings.filter((binding) =>\r\n binding.resourceKind === \"sampled-resource\"\r\n && bindingSpace(binding) === semantic.registerSpace\r\n && bindingRegister(binding) === semantic.registerIndex);\r\n if (matches.length !== 1) return rejectCandidate();\r\n const binding = matches[0];\r\n const returns = binding.returnType?.returnTypeNames || [];\r\n if (binding.resourceDimension !== \"texture2d\"\r\n || binding.structureStride !== null\r\n || binding.range?.unbounded\r\n || binding.range?.registerCount !== 1\r\n || returns.length !== 4\r\n || returns.some((entry) => entry !== \"float\"))\r\n {\r\n return rejectCandidate();\r\n }\r\n sources.push({ parameter, semantic, binding, identity: bindingIdentity(binding) });\r\n }\r\n if (sources.some((source, index) =>\r\n index > 0\r\n && (source.semantic.registerSpace !== sources[0].semantic.registerSpace\r\n || source.semantic.registerIndex <= sources[index - 1].semantic.registerIndex)))\r\n {\r\n return rejectCandidate();\r\n }\r\n\r\n const sourceByIdentity = new Map(sources.map((source) => [ source.identity, source ]));\r\n const uses = new Map(sources.map((source) => [ source.identity, 0 ]));\r\n let samplerIdentity = null;\r\n let biasFingerprint = null;\r\n for (const instruction of program.instructions)\r\n {\r\n for (let operandIndex = 0; operandIndex < instruction.operands.length; operandIndex += 1)\r\n {\r\n const operand = instruction.operands[operandIndex];\r\n if (operand?.typeName !== \"resource\") continue;\r\n const binding = resolveBindingForOperand(program, \"sampled-resource\", operand);\r\n if (!binding)\r\n {\r\n const unresolvedCandidate = bindingMatchesForOperand(\r\n program,\r\n \"sampled-resource\",\r\n operand\r\n ).some((candidate) =>\r\n sourceByIdentity.has(bindingIdentity(candidate)));\r\n if (unresolvedCandidate) return rejectCandidate();\r\n continue;\r\n }\r\n const identity = bindingIdentity(binding);\r\n if (!sourceByIdentity.has(identity)) continue;\r\n if (!SAMPLE_OPCODES.has(instruction.opcodeName)\r\n || operandIndex !== 2\r\n || instruction.extensions?.some((extension) =>\r\n extension.typeName === \"sample_controls\")\r\n || instruction.operands.length !== 5)\r\n {\r\n return rejectCandidate();\r\n }\r\n const sampler = resolveBindingForOperand(program, \"sampler\", instruction.operands[3]);\r\n if (!sampler) return rejectCandidate();\r\n const currentSamplerIdentity = bindingIdentity(sampler);\r\n const currentBiasFingerprint = operandFingerprint(instruction.operands[4]);\r\n if ((samplerIdentity !== null && samplerIdentity !== currentSamplerIdentity)\r\n || (biasFingerprint !== null && biasFingerprint !== currentBiasFingerprint))\r\n {\r\n return rejectCandidate();\r\n }\r\n samplerIdentity = currentSamplerIdentity;\r\n biasFingerprint = currentBiasFingerprint;\r\n uses.set(identity, uses.get(identity) + 1);\r\n }\r\n }\r\n if (samplerIdentity === null || Array.from(uses.values()).some((count) => count < 1))\r\n {\r\n return rejectCandidate();\r\n }\r\n\r\n const inputs = sources.map((source, layer) => ({\r\n parameter: source.parameter,\r\n layer,\r\n identity: source.identity,\r\n scopeIdentity: scopeIdentity(source.identity, \"fragment\")\r\n }));\r\n const first = inputs[0];\r\n const id = `${layoutKey}:detail-map-array:${first.identity}`;\r\n return normalizeResourceTransformPlan({\r\n format: \"CJS_WGSL_RESOURCE_TRANSFORM_PLAN\",\r\n formatVersion: 1,\r\n resourceTransforms: [ {\r\n id,\r\n version: 1,\r\n kind: \"texture-2d-array\",\r\n layoutKey,\r\n stage: \"fragment\",\r\n inputs,\r\n output: {\r\n name: \"DetailMapArray\",\r\n identity: first.identity,\r\n scopeIdentity: first.scopeIdentity,\r\n viewDimension: \"2d-array\",\r\n layerCount: inputs.length\r\n },\r\n representation: \"native-or-rgba8\",\r\n missingLayer: \"reject\"\r\n } ]\r\n }, layoutKey);\r\n}\r\n"],"names":["RESOURCE_IDENTITY","DETAIL_PARAMETER","SAMPLE_OPCODES","Set","deepFreeze","value","Object","isFrozen","entry","values","freeze","bindingRegister","binding","range","lowerBound","registerIndex","bindingSpace","registerSpace","bindingIdentity","resourceKind","scopeIdentity","identity","stage","normalizeInput","input","transformId","index","parameter","layer","scoped","Number","isInteger","test","Error","normalizeTransform","transform","id","version","kind","layoutKey","Array","isArray","inputs","length","map","inputParameters","inputIdentities","size","output","name","viewDimension","layerCount","representation","missingLayer","normalizeResourceTransformPlan","undefined","format","formatVersion","resourceTransforms","TypeError","sort","left","right","compareUtf8","ids","has","add","bindingMatchesForOperand","program","operand","candidates","bindings","filter","rangeId","resourceReference","resolveBindingForOperand","matches","absolute","absoluteIndex","typeName","modifierName","minPrecisionName","nonUniform","indices","some","relative","operandFingerprint","JSON","stringify","selectionModeName","mask","swizzle","selected","immediateValues","uint32","semanticResource","metadataName","carbon","arrayElements","arrayCount","type","isSRGB","rejectCandidate","buildResourceTransformPlan","entries","options","fragments","ir","semanticBindings","semanticResources","Boolean","detailResources","resource","byName","Map","set","hasThird","parameters","sources","semantic","get","returns","returnType","returnTypeNames","resourceDimension","structureStride","unbounded","registerCount","push","source","sourceByIdentity","uses","samplerIdentity","biasFingerprint","instruction","instructions","operandIndex","operands","unresolvedCandidate","candidate","opcodeName","extensions","extension","sampler","currentSamplerIdentity","currentBiasFingerprint","from","count","first"],"mappings":"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"}
1
+ {"version":3,"file":"buildResourceTransformPlan.js","sources":["../../../../../../src/formats/webgpu/core/wgsl/buildResourceTransformPlan.js"],"sourcesContent":["import { compareUtf8 } from \"../../../../format/compareUtf8.js\";\r\nimport {\r\n DETAIL_MAP_ARRAY_NAME,\r\n recogniseDetailMapFamily\r\n} from \"../../../hlsl/core/detailMapFamily.js\";\r\n\r\nconst RESOURCE_IDENTITY = /^sampled-resource:(\\d+):(\\d+)$/u;\r\nconst SAMPLE_OPCODES = new Set([ \"sample_b\" ]);\r\n\r\nfunction deepFreeze(value)\r\n{\r\n if (!value || typeof value !== \"object\" || Object.isFrozen(value)) return value;\r\n for (const entry of Object.values(value)) deepFreeze(entry);\r\n return Object.freeze(value);\r\n}\r\n\r\nfunction bindingRegister(binding)\r\n{\r\n return binding.range?.lowerBound ?? binding.registerIndex;\r\n}\r\n\r\nfunction bindingSpace(binding)\r\n{\r\n return binding.range?.registerSpace ?? 0;\r\n}\r\n\r\nfunction bindingIdentity(binding)\r\n{\r\n return `${binding.resourceKind}:${bindingSpace(binding)}:${bindingRegister(binding)}`;\r\n}\r\n\r\nfunction scopeIdentity(identity, stage)\r\n{\r\n return `${identity}@${stage}`;\r\n}\r\n\r\nfunction normalizeInput(input, transformId, index)\r\n{\r\n const parameter = input?.parameter;\r\n const layer = input?.layer;\r\n const identity = input?.identity;\r\n const scoped = input?.scopeIdentity;\r\n if (typeof parameter !== \"string\" || !parameter\r\n || !Number.isInteger(layer) || layer !== index\r\n || typeof identity !== \"string\" || !RESOURCE_IDENTITY.test(identity)\r\n || scoped !== `${identity}@fragment`)\r\n {\r\n throw new Error(`WGSL resource transform ${transformId} has an invalid input at layer ${index}`);\r\n }\r\n return { parameter, layer, identity, scopeIdentity: scoped };\r\n}\r\n\r\nfunction normalizeTransform(transform)\r\n{\r\n const id = transform?.id;\r\n if (typeof id !== \"string\" || !id\r\n || transform.version !== 1\r\n || transform.kind !== \"texture-2d-array\"\r\n || typeof transform.layoutKey !== \"string\" || !transform.layoutKey\r\n || transform.stage !== \"fragment\"\r\n || !Array.isArray(transform.inputs)\r\n || transform.inputs.length < 2)\r\n {\r\n throw new Error(`WGSL resource transform ${id || \"<unknown>\"} has an invalid texture-array contract`);\r\n }\r\n const inputs = transform.inputs.map((input, index) => normalizeInput(input, id, index));\r\n const inputParameters = new Set(inputs.map((input) => input.parameter));\r\n const inputIdentities = new Set(inputs.map((input) => input.identity));\r\n if (inputParameters.size !== inputs.length || inputIdentities.size !== inputs.length)\r\n {\r\n throw new Error(`WGSL resource transform ${id} contains duplicate inputs`);\r\n }\r\n const output = transform.output;\r\n if (typeof output?.name !== \"string\" || !output.name\r\n || output.identity !== inputs[0].identity\r\n || output.scopeIdentity !== inputs[0].scopeIdentity\r\n || output.viewDimension !== \"2d-array\"\r\n || output.layerCount !== inputs.length\r\n || transform.representation !== \"native-or-rgba8\"\r\n || transform.missingLayer !== \"reject\")\r\n {\r\n throw new Error(`WGSL resource transform ${id} has an invalid output contract`);\r\n }\r\n return {\r\n id,\r\n version: 1,\r\n kind: \"texture-2d-array\",\r\n layoutKey: transform.layoutKey,\r\n stage: \"fragment\",\r\n inputs,\r\n output: {\r\n name: output.name,\r\n identity: output.identity,\r\n scopeIdentity: output.scopeIdentity,\r\n viewDimension: \"2d-array\",\r\n layerCount: output.layerCount\r\n },\r\n representation: \"native-or-rgba8\",\r\n missingLayer: \"reject\"\r\n };\r\n}\r\n\r\n/**\r\n * Validates and freezes the compiler-owned resource-transform plan.\r\n *\r\n * @param {object|null|undefined} value Candidate plan.\r\n * @param {string|null} [layoutKey] Optional expected pass layout key.\r\n * @returns {object|null} Canonical frozen plan, or null.\r\n */\r\nexport function normalizeResourceTransformPlan(value, layoutKey = null)\r\n{\r\n if (value === undefined || value === null) return null;\r\n if (value?.format !== \"CJS_WGSL_RESOURCE_TRANSFORM_PLAN\"\r\n || value.formatVersion !== 1\r\n || !Array.isArray(value.resourceTransforms)\r\n || !value.resourceTransforms.length)\r\n {\r\n throw new TypeError(\"WGSL resource transform plan must be a non-empty version-1 document\");\r\n }\r\n const resourceTransforms = value.resourceTransforms.map(normalizeTransform)\r\n .sort((left, right) => compareUtf8(left.id, right.id));\r\n const ids = new Set();\r\n for (const transform of resourceTransforms)\r\n {\r\n if (ids.has(transform.id))\r\n {\r\n throw new Error(`WGSL resource transform plan contains duplicate id ${transform.id}`);\r\n }\r\n ids.add(transform.id);\r\n if (layoutKey !== null && transform.layoutKey !== layoutKey)\r\n {\r\n throw new Error(`WGSL resource transform ${transform.id} targets ${transform.layoutKey}, expected ${layoutKey}`);\r\n }\r\n }\r\n return deepFreeze({\r\n format: \"CJS_WGSL_RESOURCE_TRANSFORM_PLAN\",\r\n formatVersion: 1,\r\n resourceTransforms\r\n });\r\n}\r\n\r\nfunction bindingMatchesForOperand(program, resourceKind, operand)\r\n{\r\n const candidates = program.bindings.filter((binding) =>\r\n binding.resourceKind === resourceKind);\r\n const rangeId = operand?.resourceReference?.rangeId;\r\n return Number.isInteger(rangeId)\r\n ? candidates.filter((binding) => binding.range?.rangeId === rangeId)\r\n : candidates.filter((binding) => bindingRegister(binding) === operand?.registerIndex);\r\n}\r\n\r\nfunction resolveBindingForOperand(program, resourceKind, operand)\r\n{\r\n const matches = bindingMatchesForOperand(program, resourceKind, operand);\r\n if (matches.length !== 1) return null;\r\n const binding = matches[0];\r\n const absolute = operand?.resourceReference?.absoluteIndex;\r\n if (operand?.typeName !== (resourceKind === \"sampler\" ? \"sampler\" : \"resource\")\r\n || (operand.modifierName ?? \"none\") !== \"none\"\r\n || (operand.minPrecisionName ?? \"default\") !== \"default\"\r\n || operand.nonUniform\r\n || operand.indices?.some((index) => index?.relative)\r\n || operand.resourceReference?.nonUniform\r\n || absolute?.relative\r\n || (absolute !== undefined\r\n && (absolute?.values?.length !== 1\r\n || absolute.values[0] !== bindingRegister(binding))))\r\n {\r\n return null;\r\n }\r\n return binding;\r\n}\r\n\r\nfunction operandFingerprint(operand)\r\n{\r\n return JSON.stringify({\r\n typeName: operand?.typeName ?? null,\r\n selectionModeName: operand?.selectionModeName ?? null,\r\n mask: operand?.mask ?? \"\",\r\n swizzle: operand?.swizzle ?? \"\",\r\n selected: operand?.selected ?? \"\",\r\n modifierName: operand?.modifierName ?? \"none\",\r\n minPrecisionName: operand?.minPrecisionName ?? \"default\",\r\n registerIndex: operand?.registerIndex ?? null,\r\n indices: (operand?.indices || []).map((index) => ({\r\n values: index?.values || [],\r\n relative: index?.relative ?? null\r\n })),\r\n immediateValues: (operand?.immediateValues || []).map((entry) => entry?.uint32)\r\n });\r\n}\r\n\r\nfunction semanticResource(binding)\r\n{\r\n if (binding?.kind !== \"resource\") return null;\r\n const parameter = binding.metadataName ?? binding.carbon?.name;\r\n if (typeof parameter !== \"string\" || !parameter) return null;\r\n return {\r\n parameter,\r\n registerIndex: binding.registerIndex,\r\n registerSpace: binding.registerSpace ?? 0,\r\n arrayElements: binding.arrayCount ?? binding.carbon?.arrayElements,\r\n type: binding.carbon?.type,\r\n isSRGB: binding.carbon?.isSRGB\r\n };\r\n}\r\n\r\nfunction rejectCandidate()\r\n{\r\n return null;\r\n}\r\n\r\n/**\r\n * Recognizes the exact Carbon Detail-map sample family and builds a late\r\n * physical texture-array overlay. The source IR remains unchanged.\r\n *\r\n * @param {Array<{ir: object, semanticBindings: object[]}>} entries Pass stages.\r\n * @param {object} options Planner options.\r\n * @param {string} options.layoutKey Canonical pass key.\r\n * @returns {object|null} Frozen transform plan, or null when proof is absent.\r\n */\r\nexport function buildResourceTransformPlan(entries, options = {})\r\n{\r\n if (!Array.isArray(entries) || !entries.length)\r\n {\r\n throw new TypeError(\"WGSL resource transform planning expects pass stage entries\");\r\n }\r\n const layoutKey = options.layoutKey;\r\n if (typeof layoutKey !== \"string\" || !layoutKey)\r\n {\r\n throw new TypeError(\"WGSL resource transform planning requires a layoutKey\");\r\n }\r\n const fragments = entries.filter((entry) => entry?.ir?.stage === \"pixel\");\r\n if (fragments.length !== 1) return null;\r\n const { ir: program } = fragments[0];\r\n if (program?.format !== \"CJS_SHADER_IR\" || program.formatVersion !== 1\r\n || !Array.isArray(fragments[0].semanticBindings))\r\n {\r\n throw new TypeError(\"WGSL resource transform planning requires version-1 IR and semantic bindings\");\r\n }\r\n const semanticResources = fragments[0].semanticBindings.map(semanticResource).filter(Boolean);\r\n\r\n // Which registers make up the family is a fact about Carbon's resources,\r\n // not about WGSL, so it is decided by the recogniser WebGL uses too. Both\r\n // backends therefore merge the same registers in the same layer order, and a\r\n // change to that rule cannot land on one backend only. Everything below is\r\n // the part WGSL has to prove for itself: that every use of those registers\r\n // is a plain sample this planner can redirect at an array layer.\r\n const family = recogniseDetailMapFamily(semanticResources);\r\n if (!family) return null;\r\n\r\n const sources = [];\r\n for (const { parameter, registerIndex, registerSpace } of family.layers)\r\n {\r\n const semantic = { parameter, registerIndex, registerSpace };\r\n if (!Number.isInteger(registerSpace) || registerSpace < 0) return rejectCandidate();\r\n const matches = program.bindings.filter((binding) =>\r\n binding.resourceKind === \"sampled-resource\"\r\n && bindingSpace(binding) === registerSpace\r\n && bindingRegister(binding) === registerIndex);\r\n if (matches.length !== 1) return rejectCandidate();\r\n const binding = matches[0];\r\n const returns = binding.returnType?.returnTypeNames || [];\r\n if (binding.resourceDimension !== \"texture2d\"\r\n || binding.structureStride !== null\r\n || binding.range?.unbounded\r\n || binding.range?.registerCount !== 1\r\n || returns.length !== 4\r\n || returns.some((entry) => entry !== \"float\"))\r\n {\r\n return rejectCandidate();\r\n }\r\n sources.push({ parameter, semantic, binding, identity: bindingIdentity(binding) });\r\n }\r\n\r\n const sourceByIdentity = new Map(sources.map((source) => [ source.identity, source ]));\r\n const uses = new Map(sources.map((source) => [ source.identity, 0 ]));\r\n let samplerIdentity = null;\r\n let biasFingerprint = null;\r\n for (const instruction of program.instructions)\r\n {\r\n for (let operandIndex = 0; operandIndex < instruction.operands.length; operandIndex += 1)\r\n {\r\n const operand = instruction.operands[operandIndex];\r\n if (operand?.typeName !== \"resource\") continue;\r\n const binding = resolveBindingForOperand(program, \"sampled-resource\", operand);\r\n if (!binding)\r\n {\r\n const unresolvedCandidate = bindingMatchesForOperand(\r\n program,\r\n \"sampled-resource\",\r\n operand\r\n ).some((candidate) =>\r\n sourceByIdentity.has(bindingIdentity(candidate)));\r\n if (unresolvedCandidate) return rejectCandidate();\r\n continue;\r\n }\r\n const identity = bindingIdentity(binding);\r\n if (!sourceByIdentity.has(identity)) continue;\r\n if (!SAMPLE_OPCODES.has(instruction.opcodeName)\r\n || operandIndex !== 2\r\n || instruction.extensions?.some((extension) =>\r\n extension.typeName === \"sample_controls\")\r\n || instruction.operands.length !== 5)\r\n {\r\n return rejectCandidate();\r\n }\r\n const sampler = resolveBindingForOperand(program, \"sampler\", instruction.operands[3]);\r\n if (!sampler) return rejectCandidate();\r\n const currentSamplerIdentity = bindingIdentity(sampler);\r\n const currentBiasFingerprint = operandFingerprint(instruction.operands[4]);\r\n if ((samplerIdentity !== null && samplerIdentity !== currentSamplerIdentity)\r\n || (biasFingerprint !== null && biasFingerprint !== currentBiasFingerprint))\r\n {\r\n return rejectCandidate();\r\n }\r\n samplerIdentity = currentSamplerIdentity;\r\n biasFingerprint = currentBiasFingerprint;\r\n uses.set(identity, uses.get(identity) + 1);\r\n }\r\n }\r\n if (samplerIdentity === null || Array.from(uses.values()).some((count) => count < 1))\r\n {\r\n return rejectCandidate();\r\n }\r\n\r\n const inputs = sources.map((source, layer) => ({\r\n parameter: source.parameter,\r\n layer,\r\n identity: source.identity,\r\n scopeIdentity: scopeIdentity(source.identity, \"fragment\")\r\n }));\r\n const first = inputs[0];\r\n const id = `${layoutKey}:detail-map-array:${first.identity}`;\r\n return normalizeResourceTransformPlan({\r\n format: \"CJS_WGSL_RESOURCE_TRANSFORM_PLAN\",\r\n formatVersion: 1,\r\n resourceTransforms: [ {\r\n id,\r\n version: 1,\r\n kind: \"texture-2d-array\",\r\n layoutKey,\r\n stage: \"fragment\",\r\n inputs,\r\n output: {\r\n name: DETAIL_MAP_ARRAY_NAME,\r\n identity: first.identity,\r\n scopeIdentity: first.scopeIdentity,\r\n viewDimension: \"2d-array\",\r\n layerCount: inputs.length\r\n },\r\n representation: \"native-or-rgba8\",\r\n missingLayer: \"reject\"\r\n } ]\r\n }, layoutKey);\r\n}\r\n"],"names":["RESOURCE_IDENTITY","SAMPLE_OPCODES","Set","deepFreeze","value","Object","isFrozen","entry","values","freeze","bindingRegister","binding","range","lowerBound","registerIndex","bindingSpace","registerSpace","bindingIdentity","resourceKind","scopeIdentity","identity","stage","normalizeInput","input","transformId","index","parameter","layer","scoped","Number","isInteger","test","Error","normalizeTransform","transform","id","version","kind","layoutKey","Array","isArray","inputs","length","map","inputParameters","inputIdentities","size","output","name","viewDimension","layerCount","representation","missingLayer","normalizeResourceTransformPlan","undefined","format","formatVersion","resourceTransforms","TypeError","sort","left","right","compareUtf8","ids","has","add","bindingMatchesForOperand","program","operand","candidates","bindings","filter","rangeId","resourceReference","resolveBindingForOperand","matches","absolute","absoluteIndex","typeName","modifierName","minPrecisionName","nonUniform","indices","some","relative","operandFingerprint","JSON","stringify","selectionModeName","mask","swizzle","selected","immediateValues","uint32","semanticResource","metadataName","carbon","arrayElements","arrayCount","type","isSRGB","rejectCandidate","buildResourceTransformPlan","entries","options","fragments","ir","semanticBindings","semanticResources","Boolean","family","recogniseDetailMapFamily","sources","layers","semantic","returns","returnType","returnTypeNames","resourceDimension","structureStride","unbounded","registerCount","push","sourceByIdentity","Map","source","uses","samplerIdentity","biasFingerprint","instruction","instructions","operandIndex","operands","unresolvedCandidate","candidate","opcodeName","extensions","extension","sampler","currentSamplerIdentity","currentBiasFingerprint","set","get","from","count","first","DETAIL_MAP_ARRAY_NAME"],"mappings":"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"}
@@ -1,65 +1,65 @@
1
- import { lowerBindingLayout } from './lowerBindingLayout.js';
2
- import { normalizeResourceTransformPlan } from './buildResourceTransformPlan.js';
3
- import { compareUtf8 } from '../../../../format/compareUtf8.js';
4
- import { particleClearSignedAtomicLayoutPolicy } from './lowerParticleClearComputePrograms.js';
5
- import { particleEmitSignedAtomicLayoutPolicy } from './lowerParticleEmitComputeProgram.js';
6
-
7
- const KIND_ORDER = Object.freeze({
8
- "uniform-buffer": 0,
9
- "sampled-resource": 1,
10
- sampler: 2,
11
- "storage-resource": 3
12
- });
13
- const STAGE_VISIBILITY = Object.freeze({
14
- vertex: "vertex",
15
- pixel: "fragment",
16
- compute: "compute"
17
- });
18
- const STAGE_ORDER = Object.freeze({
19
- vertex: 0,
20
- fragment: 1,
21
- compute: 2
22
- });
23
- const IDENTITY_PATTERN = /^(uniform-buffer|sampled-resource|sampler|storage-resource):\d+:\d+$/u;
24
- function identity(binding) {
25
- return `${binding.resourceKind}:${binding.registerSpace}:${binding.registerIndex}`;
26
- }
27
- function portableBinding(binding) {
28
- const d3dIdentity = identity(binding);
29
- return {
30
- identity: d3dIdentity,
31
- resourceKind: binding.resourceKind,
32
- generatedSymbol: binding.generatedSymbol,
33
- registerSpace: binding.registerSpace,
34
- registerIndex: binding.registerIndex,
35
- type: binding.type,
36
- ...(typeof binding.transformId === "string" ? {
37
- transformId: binding.transformId,
38
- arrayLayerCount: binding.arrayLayerCount
39
- } : {}),
40
- ...(Number.isInteger(binding.structureStride) ? {
41
- structureStride: binding.structureStride
42
- } : {}),
43
- ...(binding.buffer ? {
44
- buffer: binding.buffer
45
- } : {}),
46
- ...(binding.texture ? {
47
- texture: binding.texture
48
- } : {}),
49
- ...(binding.sampler ? {
50
- sampler: binding.sampler
51
- } : {})
52
- };
53
- }
54
- function fingerprint(binding) {
55
- return JSON.stringify(binding);
56
- }
57
- function deepFreeze(value) {
58
- if (!value || typeof value !== "object" || Object.isFrozen(value)) return value;
59
- for (const entry of Object.values(value)) deepFreeze(entry);
60
- return Object.freeze(value);
61
- }
62
-
1
+ import { lowerBindingLayout } from './lowerBindingLayout.js';
2
+ import { normalizeResourceTransformPlan } from './buildResourceTransformPlan.js';
3
+ import { compareUtf8 } from '../../../../format/compareUtf8.js';
4
+ import { particleClearSignedAtomicLayoutPolicy } from './lowerParticleClearComputePrograms.js';
5
+ import { particleEmitSignedAtomicLayoutPolicy } from './lowerParticleEmitComputeProgram.js';
6
+
7
+ const KIND_ORDER = Object.freeze({
8
+ "uniform-buffer": 0,
9
+ "sampled-resource": 1,
10
+ sampler: 2,
11
+ "storage-resource": 3
12
+ });
13
+ const STAGE_VISIBILITY = Object.freeze({
14
+ vertex: "vertex",
15
+ pixel: "fragment",
16
+ compute: "compute"
17
+ });
18
+ const STAGE_ORDER = Object.freeze({
19
+ vertex: 0,
20
+ fragment: 1,
21
+ compute: 2
22
+ });
23
+ const IDENTITY_PATTERN = /^(uniform-buffer|sampled-resource|sampler|storage-resource):\d+:\d+$/u;
24
+ function identity(binding) {
25
+ return `${binding.resourceKind}:${binding.registerSpace}:${binding.registerIndex}`;
26
+ }
27
+ function portableBinding(binding) {
28
+ const d3dIdentity = identity(binding);
29
+ return {
30
+ identity: d3dIdentity,
31
+ resourceKind: binding.resourceKind,
32
+ generatedSymbol: binding.generatedSymbol,
33
+ registerSpace: binding.registerSpace,
34
+ registerIndex: binding.registerIndex,
35
+ type: binding.type,
36
+ ...(typeof binding.transformId === "string" ? {
37
+ transformId: binding.transformId,
38
+ arrayLayerCount: binding.arrayLayerCount
39
+ } : {}),
40
+ ...(Number.isInteger(binding.structureStride) ? {
41
+ structureStride: binding.structureStride
42
+ } : {}),
43
+ ...(binding.buffer ? {
44
+ buffer: binding.buffer
45
+ } : {}),
46
+ ...(binding.texture ? {
47
+ texture: binding.texture
48
+ } : {}),
49
+ ...(binding.sampler ? {
50
+ sampler: binding.sampler
51
+ } : {})
52
+ };
53
+ }
54
+ function fingerprint(binding) {
55
+ return JSON.stringify(binding);
56
+ }
57
+ function deepFreeze(value) {
58
+ if (!value || typeof value !== "object" || Object.isFrozen(value)) return value;
59
+ for (const entry of Object.values(value)) deepFreeze(entry);
60
+ return Object.freeze(value);
61
+ }
62
+
63
63
  /**
64
64
  * Builds one deterministic numeric binding plan for all shader stages in a
65
65
  * pass. Unshared D3D tuples remain stage-scoped unless the caller explicitly
@@ -71,113 +71,113 @@ function deepFreeze(value) {
71
71
  * pass metadata/CjsLibrary to represent one resource across stages.
72
72
  * @param {object|null} [options.effectProfileProof] Opaque exact-effect proof.
73
73
  * @returns {object} Frozen pass-global binding plan.
74
- */
75
- function buildWgslBindingPlan(programs, options = {}) {
76
- if (!Array.isArray(programs) || !programs.length) {
77
- throw new TypeError("BuildWgslBindingPlan expects at least one CJS shader IR program");
78
- }
79
- if (!options || typeof options !== "object" || Array.isArray(options)) {
80
- throw new TypeError("BuildWgslBindingPlan options must be an object");
81
- }
82
- const requestedShared = options.sharedIdentities === undefined ? [] : options.sharedIdentities;
83
- if (!Array.isArray(requestedShared) || requestedShared.some(entry => typeof entry !== "string" || !IDENTITY_PATTERN.test(entry)) || new Set(requestedShared).size !== requestedShared.length) {
84
- throw new TypeError("BuildWgslBindingPlan sharedIdentities must contain unique D3D resource identities");
85
- }
86
- const sharedIdentities = new Set(requestedShared);
87
- const resourceTransformPlan = normalizeResourceTransformPlan(options.resourceTransformPlan);
88
- const identities = new Map();
89
- const programStages = new Set();
90
- for (const [index, program] of programs.entries()) {
91
- if (program?.format !== "CJS_SHADER_IR" || program.formatVersion !== 1) {
92
- throw new TypeError(`BuildWgslBindingPlan program ${index} is not CJS_SHADER_IR version 1`);
93
- }
94
- const stage = STAGE_VISIBILITY[program.stage];
95
- if (!stage) {
96
- throw new Error(`BuildWgslBindingPlan program ${index} has unsupported stage ${program.stage || "unknown"}`);
97
- }
98
- if (programStages.has(stage)) {
99
- throw new Error(`BuildWgslBindingPlan contains multiple ${stage} programs for one pass`);
100
- }
101
- programStages.add(stage);
102
- const layoutPolicy = particleClearSignedAtomicLayoutPolicy(program, options.effectProfileProof ?? null) ?? particleEmitSignedAtomicLayoutPolicy(program);
103
- for (const binding of lowerBindingLayout(program, null, layoutPolicy, resourceTransformPlan)) {
104
- const key = identity(binding);
105
- const entry = portableBinding(binding);
106
- if (!identities.has(key)) identities.set(key, []);
107
- identities.get(key).push({
108
- binding: entry,
109
- stage
110
- });
111
- }
112
- }
113
- if (programStages.has("compute") && programStages.size !== 1) {
114
- throw new Error("BuildWgslBindingPlan cannot mix compute and render programs in one pass");
115
- }
116
- const bindings = [];
117
- for (const [key, occurrences] of identities) {
118
- const stages = occurrences.map(entry => entry.stage).sort((left, right) => STAGE_ORDER[left] - STAGE_ORDER[right]);
119
- if (sharedIdentities.has(key)) {
120
- if (occurrences.length < 2) {
121
- throw new Error(`WGSL shared identity ${key} does not occur in multiple stages`);
122
- }
123
- const expected = fingerprint(occurrences[0].binding);
124
- if (occurrences.some(entry => fingerprint(entry.binding) !== expected)) {
125
- throw new Error(`WGSL shared identity ${key} has incompatible stage declarations`);
126
- }
127
- bindings.push({
128
- ...occurrences[0].binding,
129
- scopeIdentity: key,
130
- stages
131
- });
132
- continue;
133
- }
134
- for (const occurrence of occurrences) {
135
- bindings.push({
136
- ...occurrence.binding,
137
- scopeIdentity: `${key}@${occurrence.stage}`,
138
- stages: [occurrence.stage]
139
- });
140
- }
141
- }
142
- for (const key of sharedIdentities) {
143
- if (!identities.has(key)) throw new Error(`WGSL shared identity ${key} does not occur in the pass`);
144
- }
145
- bindings.sort((left, right) => left.registerSpace - right.registerSpace || (KIND_ORDER[left.resourceKind] ?? 99) - (KIND_ORDER[right.resourceKind] ?? 99) || left.registerIndex - right.registerIndex || (STAGE_ORDER[left.stages[0]] ?? 99) - (STAGE_ORDER[right.stages[0]] ?? 99) || compareUtf8(left.generatedSymbol, right.generatedSymbol) || compareUtf8(left.scopeIdentity, right.scopeIdentity));
146
- const plannedBindings = bindings.map((binding, bindingIndex) => ({
147
- ...binding,
148
- group: 0,
149
- binding: bindingIndex
150
- }));
151
-
152
- // WebGPU pipeline creation requires the vertex output and fragment input
153
- // interpolation attributes at one location to MATCH, and interpolation is
154
- // declared only on the fragment side in DXBC (dcl_input_ps). Record the
155
- // non-default modes here so the vertex module can mirror them.
156
- const varyingInterpolation = {};
157
- for (const program of programs) {
158
- if (program.stage !== "pixel") continue;
159
- for (const declaration of program.declarations || []) {
160
- if (declaration.opcodeName !== "dcl_input_ps") continue;
161
- if (declaration.data?.interpolationModeName === "linear_noperspective") {
162
- varyingInterpolation[declaration.data.registerIndex] = "linear";
163
- }
164
- }
165
- }
166
- return deepFreeze({
167
- format: "CJS_WGSL_BINDING_PLAN",
168
- formatVersion: resourceTransformPlan ? 3 : 2,
169
- ...(sharedIdentities.size ? {
170
- sharedIdentities: Object.freeze([...sharedIdentities].sort())
171
- } : {}),
172
- ...(Object.keys(varyingInterpolation).length ? {
173
- varyingInterpolation
174
- } : {}),
175
- ...(resourceTransformPlan ? {
176
- resourceTransforms: resourceTransformPlan.resourceTransforms
177
- } : {}),
178
- bindings: plannedBindings
179
- });
180
- }
181
-
182
- export { buildWgslBindingPlan };
183
- //# sourceMappingURL=buildWgslBindingPlan.js.map
74
+ */
75
+ function buildWgslBindingPlan(programs, options = {}) {
76
+ if (!Array.isArray(programs) || !programs.length) {
77
+ throw new TypeError("BuildWgslBindingPlan expects at least one CJS shader IR program");
78
+ }
79
+ if (!options || typeof options !== "object" || Array.isArray(options)) {
80
+ throw new TypeError("BuildWgslBindingPlan options must be an object");
81
+ }
82
+ const requestedShared = options.sharedIdentities === undefined ? [] : options.sharedIdentities;
83
+ if (!Array.isArray(requestedShared) || requestedShared.some(entry => typeof entry !== "string" || !IDENTITY_PATTERN.test(entry)) || new Set(requestedShared).size !== requestedShared.length) {
84
+ throw new TypeError("BuildWgslBindingPlan sharedIdentities must contain unique D3D resource identities");
85
+ }
86
+ const sharedIdentities = new Set(requestedShared);
87
+ const resourceTransformPlan = normalizeResourceTransformPlan(options.resourceTransformPlan);
88
+ const identities = new Map();
89
+ const programStages = new Set();
90
+ for (const [index, program] of programs.entries()) {
91
+ if (program?.format !== "CJS_SHADER_IR" || program.formatVersion !== 1) {
92
+ throw new TypeError(`BuildWgslBindingPlan program ${index} is not CJS_SHADER_IR version 1`);
93
+ }
94
+ const stage = STAGE_VISIBILITY[program.stage];
95
+ if (!stage) {
96
+ throw new Error(`BuildWgslBindingPlan program ${index} has unsupported stage ${program.stage || "unknown"}`);
97
+ }
98
+ if (programStages.has(stage)) {
99
+ throw new Error(`BuildWgslBindingPlan contains multiple ${stage} programs for one pass`);
100
+ }
101
+ programStages.add(stage);
102
+ const layoutPolicy = particleClearSignedAtomicLayoutPolicy(program, options.effectProfileProof ?? null) ?? particleEmitSignedAtomicLayoutPolicy(program);
103
+ for (const binding of lowerBindingLayout(program, null, layoutPolicy, resourceTransformPlan)) {
104
+ const key = identity(binding);
105
+ const entry = portableBinding(binding);
106
+ if (!identities.has(key)) identities.set(key, []);
107
+ identities.get(key).push({
108
+ binding: entry,
109
+ stage
110
+ });
111
+ }
112
+ }
113
+ if (programStages.has("compute") && programStages.size !== 1) {
114
+ throw new Error("BuildWgslBindingPlan cannot mix compute and render programs in one pass");
115
+ }
116
+ const bindings = [];
117
+ for (const [key, occurrences] of identities) {
118
+ const stages = occurrences.map(entry => entry.stage).sort((left, right) => STAGE_ORDER[left] - STAGE_ORDER[right]);
119
+ if (sharedIdentities.has(key)) {
120
+ if (occurrences.length < 2) {
121
+ throw new Error(`WGSL shared identity ${key} does not occur in multiple stages`);
122
+ }
123
+ const expected = fingerprint(occurrences[0].binding);
124
+ if (occurrences.some(entry => fingerprint(entry.binding) !== expected)) {
125
+ throw new Error(`WGSL shared identity ${key} has incompatible stage declarations`);
126
+ }
127
+ bindings.push({
128
+ ...occurrences[0].binding,
129
+ scopeIdentity: key,
130
+ stages
131
+ });
132
+ continue;
133
+ }
134
+ for (const occurrence of occurrences) {
135
+ bindings.push({
136
+ ...occurrence.binding,
137
+ scopeIdentity: `${key}@${occurrence.stage}`,
138
+ stages: [occurrence.stage]
139
+ });
140
+ }
141
+ }
142
+ for (const key of sharedIdentities) {
143
+ if (!identities.has(key)) throw new Error(`WGSL shared identity ${key} does not occur in the pass`);
144
+ }
145
+ bindings.sort((left, right) => left.registerSpace - right.registerSpace || (KIND_ORDER[left.resourceKind] ?? 99) - (KIND_ORDER[right.resourceKind] ?? 99) || left.registerIndex - right.registerIndex || (STAGE_ORDER[left.stages[0]] ?? 99) - (STAGE_ORDER[right.stages[0]] ?? 99) || compareUtf8(left.generatedSymbol, right.generatedSymbol) || compareUtf8(left.scopeIdentity, right.scopeIdentity));
146
+ const plannedBindings = bindings.map((binding, bindingIndex) => ({
147
+ ...binding,
148
+ group: 0,
149
+ binding: bindingIndex
150
+ }));
151
+
152
+ // WebGPU pipeline creation requires the vertex output and fragment input
153
+ // interpolation attributes at one location to MATCH, and interpolation is
154
+ // declared only on the fragment side in DXBC (dcl_input_ps). Record the
155
+ // non-default modes here so the vertex module can mirror them.
156
+ const varyingInterpolation = {};
157
+ for (const program of programs) {
158
+ if (program.stage !== "pixel") continue;
159
+ for (const declaration of program.declarations || []) {
160
+ if (declaration.opcodeName !== "dcl_input_ps") continue;
161
+ if (declaration.data?.interpolationModeName === "linear_noperspective") {
162
+ varyingInterpolation[declaration.data.registerIndex] = "linear";
163
+ }
164
+ }
165
+ }
166
+ return deepFreeze({
167
+ format: "CJS_WGSL_BINDING_PLAN",
168
+ formatVersion: resourceTransformPlan ? 3 : 2,
169
+ ...(sharedIdentities.size ? {
170
+ sharedIdentities: Object.freeze([...sharedIdentities].sort())
171
+ } : {}),
172
+ ...(Object.keys(varyingInterpolation).length ? {
173
+ varyingInterpolation
174
+ } : {}),
175
+ ...(resourceTransformPlan ? {
176
+ resourceTransforms: resourceTransformPlan.resourceTransforms
177
+ } : {}),
178
+ bindings: plannedBindings
179
+ });
180
+ }
181
+
182
+ export { buildWgslBindingPlan };
183
+ //# sourceMappingURL=buildWgslBindingPlan.js.map