@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
@@ -1,715 +1,715 @@
1
- import { requireRefactoringAllowed } from './precisionControls.js';
2
- import { validateExactComputeEnvelope, validateSm50ResourceExtensions, validateReturnTypeMirror } from './validateExactComputeIr.js';
3
- import { validateFixedHandleOperand, validateFixedHandleBinding } from './validateHandleOperand.js';
4
- import { compareUtf8 } from '../../../../format/compareUtf8.js';
5
- import { isSkinVerticesComputeProfile, lowerSkinVerticesComputeProgram } from './lowerSkinVerticesComputeProgram.js';
6
- import { isCreateHistogramsComputeProfile, lowerCreateHistogramsComputeProgram } from './lowerCreateHistogramsComputeProgram.js';
7
- import { isMergeHistogramsComputeProfile, lowerMergeHistogramsComputeProgram } from './lowerMergeHistogramsComputeProgram.js';
8
- import { isParticleClearResetCandidate, lowerParticleClearResetComputeProgram, isParticleClearInitializeCandidate, lowerParticleClearInitializeComputeProgram } from './lowerParticleClearComputePrograms.js';
9
- import { isParticleEmitComputeCandidate, lowerParticleEmitComputeProgram } from './lowerParticleEmitComputeProgram.js';
10
- import { isSortStepComputeProfile, lowerSortStepComputeProgram } from './lowerSortStepComputeProgram.js';
11
- import { isSortComputeProfile, lowerSortComputeProgram } from './lowerSortComputeProgram.js';
12
- import { isSortInnerComputeProfile, lowerSortInnerComputeProgram } from './lowerSortInnerComputeProgram.js';
13
-
14
- const COMPONENTS = Object.freeze(["x", "y", "z", "w"]);
15
- const DECLARATION_OPCODES = Object.freeze(["dcl_global_flags", "dcl_resource", "dcl_unordered_access_view_typed", "dcl_temps", "dcl_thread_group"]);
16
- const ARITHMETIC_RULES = Object.freeze({
17
- imul: Object.freeze({
18
- rule: "signed-integer",
19
- resultType: "int32",
20
- destinationOperand: 1,
21
- sourceOperands: Object.freeze([2, 3]),
22
- sourceType: "int32",
23
- operator: "*"
24
- }),
25
- umax: Object.freeze({
26
- rule: "unsigned-integer",
27
- resultType: "uint32",
28
- destinationOperand: 0,
29
- sourceOperands: Object.freeze([1, 2]),
30
- sourceType: "uint32",
31
- functionName: "max"
32
- }),
33
- iadd: Object.freeze({
34
- rule: "signed-integer",
35
- resultType: "int32",
36
- destinationOperand: 0,
37
- sourceOperands: Object.freeze([1, 2]),
38
- sourceType: "int32",
39
- operator: "+"
40
- }),
41
- ushr: Object.freeze({
42
- rule: "unsigned-integer",
43
- resultType: "uint32",
44
- destinationOperand: 0,
45
- sourceOperands: Object.freeze([1, 2]),
46
- sourceType: "uint32",
47
- operator: ">>"
48
- })
49
- });
50
- const SUPPORTED_OPCODES = new Set(["ld", ...Object.keys(ARITHMETIC_RULES), "store_uav_typed", "ret"]);
51
- const KIND_ORDER = Object.freeze({
52
- "sampled-resource": 0,
53
- "storage-resource": 1
54
- });
55
- const KIND_PREFIX = Object.freeze({
56
- "sampled-resource": "t",
57
- "storage-resource": "u"
58
- });
59
- function deepFreeze(value) {
60
- if (!value || typeof value !== "object" || Object.isFrozen(value)) return value;
61
- for (const entry of Object.values(value)) deepFreeze(entry);
62
- return Object.freeze(value);
63
- }
64
- function scalarTypeName(type) {
65
- return {
66
- int32: "i32",
67
- uint32: "u32",
68
- bitpattern32: "u32"
69
- }[type] || null;
70
- }
71
- function canonicalRef(ref) {
72
- return `${ref?.valueId || ""}.${ref?.component || ""}`;
73
- }
74
- function sameRef(left, right) {
75
- return canonicalRef(left) === canonicalRef(right);
76
- }
77
- function registerKey(operand) {
78
- return `${operand.typeName}[${operand.registerIndex}]`;
79
- }
80
- function validateCommonOperand(operand, instruction, operandIndex) {
81
- if (!operand || (operand.modifierName ?? "none") !== "none" || (operand.minPrecisionName ?? "default") !== "default" || operand.nonUniform === true) {
82
- throw new Error(`WGSL compute instruction ${instruction.index} requires an unmodified, uniform, default-precision operand ${operandIndex}`);
83
- }
84
- }
85
- function validateFixedRegisterOperand(operand, instruction, operandIndex, typeName) {
86
- validateCommonOperand(operand, instruction, operandIndex);
87
- const index = operand.indices?.[0];
88
- if (operand.typeName !== typeName || !Number.isInteger(operand.registerIndex) || operand.registerIndex < 0 || operand.indices?.length !== 1 || index?.relative || index?.values?.length !== 1 || index.values[0] !== operand.registerIndex) {
89
- throw new Error(`WGSL compute instruction ${instruction.index} operand ${operandIndex} has an invalid fixed ${typeName} identity`);
90
- }
91
- return operand;
92
- }
93
- function validateDestinationOperand(operand, instruction, operandIndex) {
94
- validateFixedRegisterOperand(operand, instruction, operandIndex, "temp");
95
- if (operand.registerIndex !== 0 || operand.componentCount !== 4 || !COMPONENTS.includes(operand.mask) || operand.swizzle || operand.selected) {
96
- throw new Error(`WGSL compute instruction ${instruction.index} operand ${operandIndex} requires one canonical temp[0] destination lane`);
97
- }
98
- return operand.mask;
99
- }
100
- function validateScalarTempSource(operand, instruction, operandIndex) {
101
- validateFixedRegisterOperand(operand, instruction, operandIndex, "temp");
102
- if (operand.registerIndex !== 0 || operand.componentCount !== 4 || !COMPONENTS.includes(operand.selected) || operand.mask || operand.swizzle) {
103
- throw new Error(`WGSL compute instruction ${instruction.index} operand ${operandIndex} requires one selected temp[0] source lane`);
104
- }
105
- return operand.selected;
106
- }
107
- function immediateBits(operand, instruction, operandIndex, replicated) {
108
- validateCommonOperand(operand, instruction, operandIndex);
109
- const values = operand.immediateValues || [];
110
- if (operand.typeName !== "immediate32" || operand.registerIndex !== null || operand.indices?.length || operand.mask || operand.swizzle || operand.selected || ![1, 4].includes(operand.componentCount) || values.length !== operand.componentCount || values.some(value => !Number.isInteger(value?.uint32))) {
111
- throw new Error(`WGSL compute instruction ${instruction.index} operand ${operandIndex} requires canonical immediate32 data`);
112
- }
113
- const bits = values.map(value => value.uint32 >>> 0);
114
- if (replicated && (bits.length !== 4 || bits.some(value => value !== bits[0]))) {
115
- throw new Error(`WGSL compute instruction ${instruction.index} operand ${operandIndex} requires four replicated immediate lanes`);
116
- }
117
- if (!replicated && bits.length !== 1) {
118
- throw new Error(`WGSL compute instruction ${instruction.index} operand ${operandIndex} requires one immediate lane`);
119
- }
120
- return bits[0];
121
- }
122
- function immediateCode(bits, type) {
123
- const literal = `0x${(bits >>> 0).toString(16).padStart(8, "0")}u`;
124
- return type === "int32" ? `bitcast<i32>(${literal})` : literal;
125
- }
126
- function validateValueRef(program, ref, expectedRegister, expectedComponent) {
127
- const value = program.values.find(entry => entry.id === ref?.valueId);
128
- if (!value || value.register !== expectedRegister || ref.component !== expectedComponent || !value.writeMask.includes(expectedComponent)) {
129
- throw new Error(`WGSL compute register dataflow references an incompatible ${expectedRegister}.${expectedComponent} value`);
130
- }
131
- if (value.origin === "undefined-register") {
132
- throw new Error(`WGSL compute reads undefined ${expectedRegister}.${expectedComponent}`);
133
- }
134
- return value;
135
- }
136
- function validateRead(program, instruction, operandIndex, operand, components, state, expectedReads) {
137
- const register = registerKey(operand);
138
- const matches = instruction.dataflow.reads.filter(entry => entry.kind === "register-read" && entry.operandIndex === operandIndex);
139
- if (matches.length !== 1) {
140
- throw new Error(`WGSL compute instruction ${instruction.index} has inconsistent read metadata for operand ${operandIndex}`);
141
- }
142
- const read = matches[0];
143
- if (read.register !== register || read.components?.length !== components.length || read.refs?.length !== components.length || components.some((component, index) => read.components[index] !== component || !sameRef(read.refs[index], state.get(`${register}.${component}`)))) {
144
- throw new Error(`WGSL compute instruction ${instruction.index} has stale or mismatched SSA reads for operand ${operandIndex}`);
145
- }
146
- components.forEach((component, index) => validateValueRef(program, read.refs[index], register, component));
147
- expectedReads.add(read);
148
- return read;
149
- }
150
- function validateNoUnexpectedReads(instruction, expectedReads) {
151
- if (instruction.dataflow.reads.length !== expectedReads.size || instruction.dataflow.reads.some(read => !expectedReads.has(read))) {
152
- throw new Error(`WGSL compute instruction ${instruction.index} has unexpected register or index reads`);
153
- }
154
- }
155
- function validateWrite(program, instruction, operandIndex, operand, state, writtenValueIds) {
156
- const writes = instruction.dataflow.writes;
157
- if (writes.length !== 1 || writes[0].operandIndex !== operandIndex) {
158
- throw new Error(`WGSL compute instruction ${instruction.index} requires one destination write at operand ${operandIndex}`);
159
- }
160
- const write = writes[0];
161
- const register = registerKey(operand);
162
- const component = operand.mask;
163
- const value = program.values.find(entry => entry.id === write.valueId);
164
- if (write.register !== register || write.mask !== component || !value || value.origin !== "instruction-write" || value.instructionIndex !== instruction.index || value.register !== register || value.writeMask !== component || writtenValueIds.has(value.id)) {
165
- throw new Error(`WGSL compute instruction ${instruction.index} has inconsistent destination SSA metadata`);
166
- }
167
- const previousComponents = COMPONENTS.filter(entry => entry !== component);
168
- if (!write.previous || Object.keys(write.previous).sort().join("") !== previousComponents.slice().sort().join("") || previousComponents.some(entry => !sameRef(write.previous[entry], state.get(`${register}.${entry}`))) || Object.keys(write.result || {}).sort().join("") !== COMPONENTS.slice().sort().join("") || !sameRef(write.result[component], {
169
- valueId: value.id,
170
- component
171
- }) || previousComponents.some(entry => !sameRef(write.result[entry], state.get(`${register}.${entry}`)))) {
172
- throw new Error(`WGSL compute instruction ${instruction.index} has inconsistent previous/result SSA lanes`);
173
- }
174
- writtenValueIds.add(value.id);
175
- state.set(`${register}.${component}`, {
176
- valueId: value.id,
177
- component
178
- });
179
- return {
180
- write,
181
- value
182
- };
183
- }
184
- function valueStorageType(value, component) {
185
- const type = value?.componentTypes?.[component];
186
- if (!scalarTypeName(type)) {
187
- throw new Error(`WGSL compute value ${value?.id || "<missing>"}.${component} has an unresolved type`);
188
- }
189
- return type;
190
- }
191
- function reinterpretCode(code, fromType, toType) {
192
- const from = scalarTypeName(fromType);
193
- const to = scalarTypeName(toType);
194
- if (!from || !to) {
195
- throw new Error(`WGSL compute cannot reinterpret ${fromType} to ${toType}`);
196
- }
197
- return from === to ? code : `bitcast<${to}>(${code})`;
198
- }
199
- function readCode(program, instruction, operandIndex, expectedType, state, expectedReads) {
200
- const operand = instruction.operands[operandIndex];
201
- if (operand?.typeName === "immediate32") {
202
- return immediateCode(immediateBits(operand, instruction, operandIndex, false), expectedType);
203
- }
204
- const component = validateScalarTempSource(operand, instruction, operandIndex);
205
- const read = validateRead(program, instruction, operandIndex, operand, [component], state, expectedReads);
206
- const value = validateValueRef(program, read.refs[0], read.register, component);
207
- return reinterpretCode(value.id, valueStorageType(value, component), expectedType);
208
- }
209
- function replicatedStoreCode(program, instruction, operandIndex, state, expectedReads) {
210
- const operand = instruction.operands[operandIndex];
211
- if (operand?.typeName === "immediate32") {
212
- return immediateCode(immediateBits(operand, instruction, operandIndex, true), "uint32");
213
- }
214
- validateFixedRegisterOperand(operand, instruction, operandIndex, "temp");
215
- if (operand.registerIndex !== 0 || operand.componentCount !== 4 || operand.mask || operand.selected || operand.swizzle?.length !== 4 || Array.from(operand.swizzle).some(component => component !== operand.swizzle[0])) {
216
- throw new Error(`WGSL compute store instruction ${instruction.index} requires four replicated source lanes from temp[0]`);
217
- }
218
- const component = operand.swizzle[0];
219
- if (!COMPONENTS.includes(component)) {
220
- throw new Error(`WGSL compute store instruction ${instruction.index} selects an invalid source lane`);
221
- }
222
- const components = Array(4).fill(component);
223
- const read = validateRead(program, instruction, operandIndex, operand, components, state, expectedReads);
224
- const value = validateValueRef(program, read.refs[0], read.register, component);
225
- return reinterpretCode(value.id, valueStorageType(value, component), "uint32");
226
- }
227
- function expectedOperandTypes(instruction) {
228
- if (instruction.opcodeName === "ld") {
229
- return [["destination", "int32"], ["source", "uint32"], ["source", "unknown"]];
230
- }
231
- const arithmetic = ARITHMETIC_RULES[instruction.opcodeName];
232
- if (arithmetic) {
233
- return instruction.operands.map((_, operandIndex) => [operandIndex === arithmetic.destinationOperand ? "destination" : "source", operandIndex === arithmetic.destinationOperand || arithmetic.sourceOperands.includes(operandIndex) ? arithmetic.resultType : "unknown"]);
234
- }
235
- if (instruction.opcodeName === "store_uav_typed") {
236
- return [["source", "unknown"], ["source", "uint32"], ["source", "uint32"]];
237
- }
238
- return [];
239
- }
240
- function expectedRule(instruction) {
241
- if (instruction.opcodeName === "ld") return ["texture-load", "int32"];
242
- const arithmetic = ARITHMETIC_RULES[instruction.opcodeName];
243
- if (arithmetic) return [arithmetic.rule, arithmetic.resultType];
244
- if (instruction.opcodeName === "store_uav_typed") return ["typed-uav-store", "unknown"];
245
- return ["untyped", "unknown"];
246
- }
247
- function bitcastKey(entry) {
248
- if (entry.kind === "read-bitcast") {
249
- return [entry.kind, entry.operandIndex, entry.componentIndex, entry.valueId, entry.component, entry.from, entry.to].join(":");
250
- }
251
- if (entry.kind === "result-bitcast") {
252
- return [entry.kind, entry.operandIndex, entry.valueId, entry.component, entry.from, entry.to].join(":");
253
- }
254
- return [entry.kind, entry.operandIndex, entry.component, entry.from, entry.to, entry.uint32 >>> 0].join(":");
255
- }
256
- function validateTypeInfo(program, instruction) {
257
- const [rule, resultType] = expectedRule(instruction);
258
- const operandTypes = expectedOperandTypes(instruction);
259
- const typeInfo = instruction.typeInfo;
260
- if (typeInfo?.kind !== "instruction-types" || typeInfo.rule !== rule || typeInfo.resultType !== resultType || typeInfo.conversion !== null || typeInfo.conditionProjection !== null || typeInfo.operandTypes?.length !== operandTypes.length || operandTypes.some(([role, expectedType], operandIndex) => {
261
- const actual = typeInfo.operandTypes[operandIndex];
262
- return actual?.operandIndex !== operandIndex || actual.role !== role || actual.expectedType !== expectedType || actual.modifier !== "none" || actual.minPrecision !== "default";
263
- })) {
264
- throw new Error(`WGSL compute instruction ${instruction.index} has inconsistent type metadata`);
265
- }
266
- const required = [];
267
- for (const read of instruction.dataflow.reads) {
268
- if (read.kind !== "register-read") {
269
- throw new Error(`WGSL compute instruction ${instruction.index} has unsupported index-read type metadata`);
270
- }
271
- const expected = operandTypes[read.operandIndex]?.[1];
272
- if (!expected || expected === "unknown") continue;
273
- read.refs.forEach((ref, componentIndex) => {
274
- const value = program.values.find(entry => entry.id === ref.valueId);
275
- const storage = valueStorageType(value, ref.component);
276
- if (storage !== expected) {
277
- required.push({
278
- kind: "read-bitcast",
279
- operandIndex: read.operandIndex,
280
- componentIndex,
281
- valueId: ref.valueId,
282
- component: ref.component,
283
- from: storage,
284
- to: expected
285
- });
286
- }
287
- });
288
- }
289
- if (resultType !== "unknown") {
290
- for (const write of instruction.dataflow.writes) {
291
- for (const component of write.mask) {
292
- const value = program.values.find(entry => entry.id === write.valueId);
293
- const storage = valueStorageType(value, component);
294
- if (storage !== resultType) {
295
- required.push({
296
- kind: "result-bitcast",
297
- operandIndex: write.operandIndex,
298
- valueId: write.valueId,
299
- component,
300
- from: resultType,
301
- to: storage
302
- });
303
- }
304
- }
305
- }
306
- }
307
- operandTypes.forEach(([, expectedType], operandIndex) => {
308
- const operand = instruction.operands[operandIndex];
309
- if (operand?.typeName !== "immediate32" || expectedType !== "int32") return;
310
- operand.immediateValues.forEach((value, componentIndex) => {
311
- required.push({
312
- kind: "immediate-bitcast",
313
- operandIndex,
314
- component: COMPONENTS[componentIndex],
315
- from: "uint32",
316
- to: "int32",
317
- uint32: value.uint32 >>> 0
318
- });
319
- });
320
- });
321
- const requiredKeys = required.map(bitcastKey).sort();
322
- const actualKeys = (typeInfo.bitcasts || []).map(bitcastKey).sort();
323
- if (new Set(actualKeys).size !== actualKeys.length || requiredKeys.length !== actualKeys.length || requiredKeys.some((entry, index) => entry !== actualKeys[index])) {
324
- throw new Error(`WGSL compute instruction ${instruction.index} has inconsistent bitcast metadata`);
325
- }
326
- }
327
- function bindingRegister(binding) {
328
- return binding.range?.lowerBound ?? binding.registerIndex;
329
- }
330
- function bindingSpace(binding) {
331
- return binding.range?.registerSpace ?? 0;
332
- }
333
- function bindingIdentity(binding) {
334
- return `${binding.resourceKind}:${bindingSpace(binding)}:${bindingRegister(binding)}`;
335
- }
336
- function validateBindingRange(binding) {
337
- const registerIndex = binding.registerIndex;
338
- const range = binding.range;
339
- if (!Number.isInteger(registerIndex) || registerIndex < 0 || range?.bindingModel !== "sm5.0-register" || range.rangeId !== null || range.lowerBound !== registerIndex || range.upperBound !== registerIndex || range.unbounded !== false || range.registerCount !== 1 || range.registerSpace !== 0) {
340
- throw new Error(`WGSL compute binding ${binding.id || "<unknown>"} requires one fixed SM5.0 register`);
341
- }
342
- }
343
- function validateBindingDeclaration(program, binding, opcodeName, operandType, returnType) {
344
- const declarations = program.declarations.filter(entry => entry.dxbcOffset === binding.declarationOffset);
345
- if (declarations.length !== 1 || declarations[0].opcodeName !== opcodeName) {
346
- throw new Error(`WGSL compute binding ${binding.id} has inconsistent declaration identity`);
347
- }
348
- const declaration = declarations[0];
349
- const data = declaration.data;
350
- const operand = declaration.operands?.[0];
351
- validateReturnTypeMirror(binding.returnType, `WGSL compute binding ${binding.id}`);
352
- validateReturnTypeMirror(data?.returnType, `WGSL compute declaration at DXBC offset ${declaration.dxbcOffset}`);
353
- validateBindingRange(binding);
354
- if (binding.operandType !== operandType || binding.resourceDimension !== "buffer" || binding.structureStride !== null || binding.accessPattern !== null || binding.returnType?.returnTypeNames?.length !== 4 || binding.returnType.returnTypeNames.some(entry => entry !== returnType) || data?.registerIndex !== binding.registerIndex || data.resourceDimensionName !== "buffer" || opcodeName === "dcl_resource" && data.sampleCount !== 0 || opcodeName === "dcl_unordered_access_view_typed" && data.globallyCoherent !== false || data.returnType?.returnTypeNames?.length !== 4 || data.returnType.returnTypeNames.some(entry => entry !== returnType) || declaration.operands?.length !== 1) {
355
- throw new Error(`WGSL compute binding ${binding.id} has an unsupported typed-buffer declaration`);
356
- }
357
- validateFixedRegisterOperand(operand, {
358
- index: `declaration@${declaration.dxbcOffset}`
359
- }, 0, operandType);
360
- if (operand.componentCount !== 0 || operand.mask || operand.swizzle || operand.selected) {
361
- throw new Error(`WGSL compute binding ${binding.id} declaration has a malformed handle operand`);
362
- }
363
- }
364
- function portableBinding(binding) {
365
- return {
366
- identity: binding.identity,
367
- resourceKind: binding.resourceKind,
368
- generatedSymbol: binding.generatedSymbol,
369
- registerSpace: binding.registerSpace,
370
- registerIndex: binding.registerIndex,
371
- type: binding.type,
372
- buffer: binding.buffer
373
- };
374
- }
375
- function applyBindingPlan(bindings, bindingPlan) {
376
- if (bindingPlan === null || bindingPlan === undefined) return bindings;
377
- if (bindingPlan?.format !== "CJS_WGSL_BINDING_PLAN" || bindingPlan.formatVersion !== 2 || !Array.isArray(bindingPlan.bindings) || bindingPlan.bindings.length !== bindings.length) {
378
- throw new TypeError("WGSL compute binding plan must provide exact version 2 compute coverage");
379
- }
380
- const planned = new Map();
381
- const slots = new Set();
382
- for (const entry of bindingPlan.bindings) {
383
- const identity = `${entry.resourceKind}:${entry.registerSpace}:${entry.registerIndex}`;
384
- const slot = `${entry.group}:${entry.binding}`;
385
- if (entry.identity !== identity || entry.scopeIdentity !== `${identity}@compute` || entry.stages?.length !== 1 || entry.stages[0] !== "compute" || !Number.isInteger(entry.group) || entry.group < 0 || !Number.isInteger(entry.binding) || entry.binding < 0 || planned.has(identity) || slots.has(slot)) {
386
- throw new Error(`WGSL compute binding plan contains an invalid entry ${entry.identity || identity}`);
387
- }
388
- planned.set(identity, entry);
389
- slots.add(slot);
390
- }
391
- return bindings.map(binding => {
392
- const entry = planned.get(binding.identity);
393
- if (!entry || JSON.stringify(portableBinding(binding)) !== JSON.stringify({
394
- identity: entry.identity,
395
- resourceKind: entry.resourceKind,
396
- generatedSymbol: entry.generatedSymbol,
397
- registerSpace: entry.registerSpace,
398
- registerIndex: entry.registerIndex,
399
- type: entry.type,
400
- buffer: entry.buffer
401
- })) {
402
- throw new Error(`WGSL compute binding plan layout for ${binding.identity} does not match the shader declaration`);
403
- }
404
- return {
405
- ...binding,
406
- scopeIdentity: entry.scopeIdentity,
407
- group: entry.group,
408
- binding: entry.binding
409
- };
410
- });
411
- }
412
-
1
+ import { requireRefactoringAllowed } from './precisionControls.js';
2
+ import { validateExactComputeEnvelope, validateSm50ResourceExtensions, validateReturnTypeMirror } from './validateExactComputeIr.js';
3
+ import { validateFixedHandleOperand, validateFixedHandleBinding } from './validateHandleOperand.js';
4
+ import { compareUtf8 } from '../../../../format/compareUtf8.js';
5
+ import { isSkinVerticesComputeProfile, lowerSkinVerticesComputeProgram } from './lowerSkinVerticesComputeProgram.js';
6
+ import { isCreateHistogramsComputeProfile, lowerCreateHistogramsComputeProgram } from './lowerCreateHistogramsComputeProgram.js';
7
+ import { isMergeHistogramsComputeProfile, lowerMergeHistogramsComputeProgram } from './lowerMergeHistogramsComputeProgram.js';
8
+ import { isParticleClearResetCandidate, lowerParticleClearResetComputeProgram, isParticleClearInitializeCandidate, lowerParticleClearInitializeComputeProgram } from './lowerParticleClearComputePrograms.js';
9
+ import { isParticleEmitComputeCandidate, lowerParticleEmitComputeProgram } from './lowerParticleEmitComputeProgram.js';
10
+ import { isSortStepComputeProfile, lowerSortStepComputeProgram } from './lowerSortStepComputeProgram.js';
11
+ import { isSortComputeProfile, lowerSortComputeProgram } from './lowerSortComputeProgram.js';
12
+ import { isSortInnerComputeProfile, lowerSortInnerComputeProgram } from './lowerSortInnerComputeProgram.js';
13
+
14
+ const COMPONENTS = Object.freeze(["x", "y", "z", "w"]);
15
+ const DECLARATION_OPCODES = Object.freeze(["dcl_global_flags", "dcl_resource", "dcl_unordered_access_view_typed", "dcl_temps", "dcl_thread_group"]);
16
+ const ARITHMETIC_RULES = Object.freeze({
17
+ imul: Object.freeze({
18
+ rule: "signed-integer",
19
+ resultType: "int32",
20
+ destinationOperand: 1,
21
+ sourceOperands: Object.freeze([2, 3]),
22
+ sourceType: "int32",
23
+ operator: "*"
24
+ }),
25
+ umax: Object.freeze({
26
+ rule: "unsigned-integer",
27
+ resultType: "uint32",
28
+ destinationOperand: 0,
29
+ sourceOperands: Object.freeze([1, 2]),
30
+ sourceType: "uint32",
31
+ functionName: "max"
32
+ }),
33
+ iadd: Object.freeze({
34
+ rule: "signed-integer",
35
+ resultType: "int32",
36
+ destinationOperand: 0,
37
+ sourceOperands: Object.freeze([1, 2]),
38
+ sourceType: "int32",
39
+ operator: "+"
40
+ }),
41
+ ushr: Object.freeze({
42
+ rule: "unsigned-integer",
43
+ resultType: "uint32",
44
+ destinationOperand: 0,
45
+ sourceOperands: Object.freeze([1, 2]),
46
+ sourceType: "uint32",
47
+ operator: ">>"
48
+ })
49
+ });
50
+ const SUPPORTED_OPCODES = new Set(["ld", ...Object.keys(ARITHMETIC_RULES), "store_uav_typed", "ret"]);
51
+ const KIND_ORDER = Object.freeze({
52
+ "sampled-resource": 0,
53
+ "storage-resource": 1
54
+ });
55
+ const KIND_PREFIX = Object.freeze({
56
+ "sampled-resource": "t",
57
+ "storage-resource": "u"
58
+ });
59
+ function deepFreeze(value) {
60
+ if (!value || typeof value !== "object" || Object.isFrozen(value)) return value;
61
+ for (const entry of Object.values(value)) deepFreeze(entry);
62
+ return Object.freeze(value);
63
+ }
64
+ function scalarTypeName(type) {
65
+ return {
66
+ int32: "i32",
67
+ uint32: "u32",
68
+ bitpattern32: "u32"
69
+ }[type] || null;
70
+ }
71
+ function canonicalRef(ref) {
72
+ return `${ref?.valueId || ""}.${ref?.component || ""}`;
73
+ }
74
+ function sameRef(left, right) {
75
+ return canonicalRef(left) === canonicalRef(right);
76
+ }
77
+ function registerKey(operand) {
78
+ return `${operand.typeName}[${operand.registerIndex}]`;
79
+ }
80
+ function validateCommonOperand(operand, instruction, operandIndex) {
81
+ if (!operand || (operand.modifierName ?? "none") !== "none" || (operand.minPrecisionName ?? "default") !== "default" || operand.nonUniform === true) {
82
+ throw new Error(`WGSL compute instruction ${instruction.index} requires an unmodified, uniform, default-precision operand ${operandIndex}`);
83
+ }
84
+ }
85
+ function validateFixedRegisterOperand(operand, instruction, operandIndex, typeName) {
86
+ validateCommonOperand(operand, instruction, operandIndex);
87
+ const index = operand.indices?.[0];
88
+ if (operand.typeName !== typeName || !Number.isInteger(operand.registerIndex) || operand.registerIndex < 0 || operand.indices?.length !== 1 || index?.relative || index?.values?.length !== 1 || index.values[0] !== operand.registerIndex) {
89
+ throw new Error(`WGSL compute instruction ${instruction.index} operand ${operandIndex} has an invalid fixed ${typeName} identity`);
90
+ }
91
+ return operand;
92
+ }
93
+ function validateDestinationOperand(operand, instruction, operandIndex) {
94
+ validateFixedRegisterOperand(operand, instruction, operandIndex, "temp");
95
+ if (operand.registerIndex !== 0 || operand.componentCount !== 4 || !COMPONENTS.includes(operand.mask) || operand.swizzle || operand.selected) {
96
+ throw new Error(`WGSL compute instruction ${instruction.index} operand ${operandIndex} requires one canonical temp[0] destination lane`);
97
+ }
98
+ return operand.mask;
99
+ }
100
+ function validateScalarTempSource(operand, instruction, operandIndex) {
101
+ validateFixedRegisterOperand(operand, instruction, operandIndex, "temp");
102
+ if (operand.registerIndex !== 0 || operand.componentCount !== 4 || !COMPONENTS.includes(operand.selected) || operand.mask || operand.swizzle) {
103
+ throw new Error(`WGSL compute instruction ${instruction.index} operand ${operandIndex} requires one selected temp[0] source lane`);
104
+ }
105
+ return operand.selected;
106
+ }
107
+ function immediateBits(operand, instruction, operandIndex, replicated) {
108
+ validateCommonOperand(operand, instruction, operandIndex);
109
+ const values = operand.immediateValues || [];
110
+ if (operand.typeName !== "immediate32" || operand.registerIndex !== null || operand.indices?.length || operand.mask || operand.swizzle || operand.selected || ![1, 4].includes(operand.componentCount) || values.length !== operand.componentCount || values.some(value => !Number.isInteger(value?.uint32))) {
111
+ throw new Error(`WGSL compute instruction ${instruction.index} operand ${operandIndex} requires canonical immediate32 data`);
112
+ }
113
+ const bits = values.map(value => value.uint32 >>> 0);
114
+ if (replicated && (bits.length !== 4 || bits.some(value => value !== bits[0]))) {
115
+ throw new Error(`WGSL compute instruction ${instruction.index} operand ${operandIndex} requires four replicated immediate lanes`);
116
+ }
117
+ if (!replicated && bits.length !== 1) {
118
+ throw new Error(`WGSL compute instruction ${instruction.index} operand ${operandIndex} requires one immediate lane`);
119
+ }
120
+ return bits[0];
121
+ }
122
+ function immediateCode(bits, type) {
123
+ const literal = `0x${(bits >>> 0).toString(16).padStart(8, "0")}u`;
124
+ return type === "int32" ? `bitcast<i32>(${literal})` : literal;
125
+ }
126
+ function validateValueRef(program, ref, expectedRegister, expectedComponent) {
127
+ const value = program.values.find(entry => entry.id === ref?.valueId);
128
+ if (!value || value.register !== expectedRegister || ref.component !== expectedComponent || !value.writeMask.includes(expectedComponent)) {
129
+ throw new Error(`WGSL compute register dataflow references an incompatible ${expectedRegister}.${expectedComponent} value`);
130
+ }
131
+ if (value.origin === "undefined-register") {
132
+ throw new Error(`WGSL compute reads undefined ${expectedRegister}.${expectedComponent}`);
133
+ }
134
+ return value;
135
+ }
136
+ function validateRead(program, instruction, operandIndex, operand, components, state, expectedReads) {
137
+ const register = registerKey(operand);
138
+ const matches = instruction.dataflow.reads.filter(entry => entry.kind === "register-read" && entry.operandIndex === operandIndex);
139
+ if (matches.length !== 1) {
140
+ throw new Error(`WGSL compute instruction ${instruction.index} has inconsistent read metadata for operand ${operandIndex}`);
141
+ }
142
+ const read = matches[0];
143
+ if (read.register !== register || read.components?.length !== components.length || read.refs?.length !== components.length || components.some((component, index) => read.components[index] !== component || !sameRef(read.refs[index], state.get(`${register}.${component}`)))) {
144
+ throw new Error(`WGSL compute instruction ${instruction.index} has stale or mismatched SSA reads for operand ${operandIndex}`);
145
+ }
146
+ components.forEach((component, index) => validateValueRef(program, read.refs[index], register, component));
147
+ expectedReads.add(read);
148
+ return read;
149
+ }
150
+ function validateNoUnexpectedReads(instruction, expectedReads) {
151
+ if (instruction.dataflow.reads.length !== expectedReads.size || instruction.dataflow.reads.some(read => !expectedReads.has(read))) {
152
+ throw new Error(`WGSL compute instruction ${instruction.index} has unexpected register or index reads`);
153
+ }
154
+ }
155
+ function validateWrite(program, instruction, operandIndex, operand, state, writtenValueIds) {
156
+ const writes = instruction.dataflow.writes;
157
+ if (writes.length !== 1 || writes[0].operandIndex !== operandIndex) {
158
+ throw new Error(`WGSL compute instruction ${instruction.index} requires one destination write at operand ${operandIndex}`);
159
+ }
160
+ const write = writes[0];
161
+ const register = registerKey(operand);
162
+ const component = operand.mask;
163
+ const value = program.values.find(entry => entry.id === write.valueId);
164
+ if (write.register !== register || write.mask !== component || !value || value.origin !== "instruction-write" || value.instructionIndex !== instruction.index || value.register !== register || value.writeMask !== component || writtenValueIds.has(value.id)) {
165
+ throw new Error(`WGSL compute instruction ${instruction.index} has inconsistent destination SSA metadata`);
166
+ }
167
+ const previousComponents = COMPONENTS.filter(entry => entry !== component);
168
+ if (!write.previous || Object.keys(write.previous).sort().join("") !== previousComponents.slice().sort().join("") || previousComponents.some(entry => !sameRef(write.previous[entry], state.get(`${register}.${entry}`))) || Object.keys(write.result || {}).sort().join("") !== COMPONENTS.slice().sort().join("") || !sameRef(write.result[component], {
169
+ valueId: value.id,
170
+ component
171
+ }) || previousComponents.some(entry => !sameRef(write.result[entry], state.get(`${register}.${entry}`)))) {
172
+ throw new Error(`WGSL compute instruction ${instruction.index} has inconsistent previous/result SSA lanes`);
173
+ }
174
+ writtenValueIds.add(value.id);
175
+ state.set(`${register}.${component}`, {
176
+ valueId: value.id,
177
+ component
178
+ });
179
+ return {
180
+ write,
181
+ value
182
+ };
183
+ }
184
+ function valueStorageType(value, component) {
185
+ const type = value?.componentTypes?.[component];
186
+ if (!scalarTypeName(type)) {
187
+ throw new Error(`WGSL compute value ${value?.id || "<missing>"}.${component} has an unresolved type`);
188
+ }
189
+ return type;
190
+ }
191
+ function reinterpretCode(code, fromType, toType) {
192
+ const from = scalarTypeName(fromType);
193
+ const to = scalarTypeName(toType);
194
+ if (!from || !to) {
195
+ throw new Error(`WGSL compute cannot reinterpret ${fromType} to ${toType}`);
196
+ }
197
+ return from === to ? code : `bitcast<${to}>(${code})`;
198
+ }
199
+ function readCode(program, instruction, operandIndex, expectedType, state, expectedReads) {
200
+ const operand = instruction.operands[operandIndex];
201
+ if (operand?.typeName === "immediate32") {
202
+ return immediateCode(immediateBits(operand, instruction, operandIndex, false), expectedType);
203
+ }
204
+ const component = validateScalarTempSource(operand, instruction, operandIndex);
205
+ const read = validateRead(program, instruction, operandIndex, operand, [component], state, expectedReads);
206
+ const value = validateValueRef(program, read.refs[0], read.register, component);
207
+ return reinterpretCode(value.id, valueStorageType(value, component), expectedType);
208
+ }
209
+ function replicatedStoreCode(program, instruction, operandIndex, state, expectedReads) {
210
+ const operand = instruction.operands[operandIndex];
211
+ if (operand?.typeName === "immediate32") {
212
+ return immediateCode(immediateBits(operand, instruction, operandIndex, true), "uint32");
213
+ }
214
+ validateFixedRegisterOperand(operand, instruction, operandIndex, "temp");
215
+ if (operand.registerIndex !== 0 || operand.componentCount !== 4 || operand.mask || operand.selected || operand.swizzle?.length !== 4 || Array.from(operand.swizzle).some(component => component !== operand.swizzle[0])) {
216
+ throw new Error(`WGSL compute store instruction ${instruction.index} requires four replicated source lanes from temp[0]`);
217
+ }
218
+ const component = operand.swizzle[0];
219
+ if (!COMPONENTS.includes(component)) {
220
+ throw new Error(`WGSL compute store instruction ${instruction.index} selects an invalid source lane`);
221
+ }
222
+ const components = Array(4).fill(component);
223
+ const read = validateRead(program, instruction, operandIndex, operand, components, state, expectedReads);
224
+ const value = validateValueRef(program, read.refs[0], read.register, component);
225
+ return reinterpretCode(value.id, valueStorageType(value, component), "uint32");
226
+ }
227
+ function expectedOperandTypes(instruction) {
228
+ if (instruction.opcodeName === "ld") {
229
+ return [["destination", "int32"], ["source", "uint32"], ["source", "unknown"]];
230
+ }
231
+ const arithmetic = ARITHMETIC_RULES[instruction.opcodeName];
232
+ if (arithmetic) {
233
+ return instruction.operands.map((_, operandIndex) => [operandIndex === arithmetic.destinationOperand ? "destination" : "source", operandIndex === arithmetic.destinationOperand || arithmetic.sourceOperands.includes(operandIndex) ? arithmetic.resultType : "unknown"]);
234
+ }
235
+ if (instruction.opcodeName === "store_uav_typed") {
236
+ return [["source", "unknown"], ["source", "uint32"], ["source", "uint32"]];
237
+ }
238
+ return [];
239
+ }
240
+ function expectedRule(instruction) {
241
+ if (instruction.opcodeName === "ld") return ["texture-load", "int32"];
242
+ const arithmetic = ARITHMETIC_RULES[instruction.opcodeName];
243
+ if (arithmetic) return [arithmetic.rule, arithmetic.resultType];
244
+ if (instruction.opcodeName === "store_uav_typed") return ["typed-uav-store", "unknown"];
245
+ return ["untyped", "unknown"];
246
+ }
247
+ function bitcastKey(entry) {
248
+ if (entry.kind === "read-bitcast") {
249
+ return [entry.kind, entry.operandIndex, entry.componentIndex, entry.valueId, entry.component, entry.from, entry.to].join(":");
250
+ }
251
+ if (entry.kind === "result-bitcast") {
252
+ return [entry.kind, entry.operandIndex, entry.valueId, entry.component, entry.from, entry.to].join(":");
253
+ }
254
+ return [entry.kind, entry.operandIndex, entry.component, entry.from, entry.to, entry.uint32 >>> 0].join(":");
255
+ }
256
+ function validateTypeInfo(program, instruction) {
257
+ const [rule, resultType] = expectedRule(instruction);
258
+ const operandTypes = expectedOperandTypes(instruction);
259
+ const typeInfo = instruction.typeInfo;
260
+ if (typeInfo?.kind !== "instruction-types" || typeInfo.rule !== rule || typeInfo.resultType !== resultType || typeInfo.conversion !== null || typeInfo.conditionProjection !== null || typeInfo.operandTypes?.length !== operandTypes.length || operandTypes.some(([role, expectedType], operandIndex) => {
261
+ const actual = typeInfo.operandTypes[operandIndex];
262
+ return actual?.operandIndex !== operandIndex || actual.role !== role || actual.expectedType !== expectedType || actual.modifier !== "none" || actual.minPrecision !== "default";
263
+ })) {
264
+ throw new Error(`WGSL compute instruction ${instruction.index} has inconsistent type metadata`);
265
+ }
266
+ const required = [];
267
+ for (const read of instruction.dataflow.reads) {
268
+ if (read.kind !== "register-read") {
269
+ throw new Error(`WGSL compute instruction ${instruction.index} has unsupported index-read type metadata`);
270
+ }
271
+ const expected = operandTypes[read.operandIndex]?.[1];
272
+ if (!expected || expected === "unknown") continue;
273
+ read.refs.forEach((ref, componentIndex) => {
274
+ const value = program.values.find(entry => entry.id === ref.valueId);
275
+ const storage = valueStorageType(value, ref.component);
276
+ if (storage !== expected) {
277
+ required.push({
278
+ kind: "read-bitcast",
279
+ operandIndex: read.operandIndex,
280
+ componentIndex,
281
+ valueId: ref.valueId,
282
+ component: ref.component,
283
+ from: storage,
284
+ to: expected
285
+ });
286
+ }
287
+ });
288
+ }
289
+ if (resultType !== "unknown") {
290
+ for (const write of instruction.dataflow.writes) {
291
+ for (const component of write.mask) {
292
+ const value = program.values.find(entry => entry.id === write.valueId);
293
+ const storage = valueStorageType(value, component);
294
+ if (storage !== resultType) {
295
+ required.push({
296
+ kind: "result-bitcast",
297
+ operandIndex: write.operandIndex,
298
+ valueId: write.valueId,
299
+ component,
300
+ from: resultType,
301
+ to: storage
302
+ });
303
+ }
304
+ }
305
+ }
306
+ }
307
+ operandTypes.forEach(([, expectedType], operandIndex) => {
308
+ const operand = instruction.operands[operandIndex];
309
+ if (operand?.typeName !== "immediate32" || expectedType !== "int32") return;
310
+ operand.immediateValues.forEach((value, componentIndex) => {
311
+ required.push({
312
+ kind: "immediate-bitcast",
313
+ operandIndex,
314
+ component: COMPONENTS[componentIndex],
315
+ from: "uint32",
316
+ to: "int32",
317
+ uint32: value.uint32 >>> 0
318
+ });
319
+ });
320
+ });
321
+ const requiredKeys = required.map(bitcastKey).sort();
322
+ const actualKeys = (typeInfo.bitcasts || []).map(bitcastKey).sort();
323
+ if (new Set(actualKeys).size !== actualKeys.length || requiredKeys.length !== actualKeys.length || requiredKeys.some((entry, index) => entry !== actualKeys[index])) {
324
+ throw new Error(`WGSL compute instruction ${instruction.index} has inconsistent bitcast metadata`);
325
+ }
326
+ }
327
+ function bindingRegister(binding) {
328
+ return binding.range?.lowerBound ?? binding.registerIndex;
329
+ }
330
+ function bindingSpace(binding) {
331
+ return binding.range?.registerSpace ?? 0;
332
+ }
333
+ function bindingIdentity(binding) {
334
+ return `${binding.resourceKind}:${bindingSpace(binding)}:${bindingRegister(binding)}`;
335
+ }
336
+ function validateBindingRange(binding) {
337
+ const registerIndex = binding.registerIndex;
338
+ const range = binding.range;
339
+ if (!Number.isInteger(registerIndex) || registerIndex < 0 || range?.bindingModel !== "sm5.0-register" || range.rangeId !== null || range.lowerBound !== registerIndex || range.upperBound !== registerIndex || range.unbounded !== false || range.registerCount !== 1 || range.registerSpace !== 0) {
340
+ throw new Error(`WGSL compute binding ${binding.id || "<unknown>"} requires one fixed SM5.0 register`);
341
+ }
342
+ }
343
+ function validateBindingDeclaration(program, binding, opcodeName, operandType, returnType) {
344
+ const declarations = program.declarations.filter(entry => entry.dxbcOffset === binding.declarationOffset);
345
+ if (declarations.length !== 1 || declarations[0].opcodeName !== opcodeName) {
346
+ throw new Error(`WGSL compute binding ${binding.id} has inconsistent declaration identity`);
347
+ }
348
+ const declaration = declarations[0];
349
+ const data = declaration.data;
350
+ const operand = declaration.operands?.[0];
351
+ validateReturnTypeMirror(binding.returnType, `WGSL compute binding ${binding.id}`);
352
+ validateReturnTypeMirror(data?.returnType, `WGSL compute declaration at DXBC offset ${declaration.dxbcOffset}`);
353
+ validateBindingRange(binding);
354
+ if (binding.operandType !== operandType || binding.resourceDimension !== "buffer" || binding.structureStride !== null || binding.accessPattern !== null || binding.returnType?.returnTypeNames?.length !== 4 || binding.returnType.returnTypeNames.some(entry => entry !== returnType) || data?.registerIndex !== binding.registerIndex || data.resourceDimensionName !== "buffer" || opcodeName === "dcl_resource" && data.sampleCount !== 0 || opcodeName === "dcl_unordered_access_view_typed" && data.globallyCoherent !== false || data.returnType?.returnTypeNames?.length !== 4 || data.returnType.returnTypeNames.some(entry => entry !== returnType) || declaration.operands?.length !== 1) {
355
+ throw new Error(`WGSL compute binding ${binding.id} has an unsupported typed-buffer declaration`);
356
+ }
357
+ validateFixedRegisterOperand(operand, {
358
+ index: `declaration@${declaration.dxbcOffset}`
359
+ }, 0, operandType);
360
+ if (operand.componentCount !== 0 || operand.mask || operand.swizzle || operand.selected) {
361
+ throw new Error(`WGSL compute binding ${binding.id} declaration has a malformed handle operand`);
362
+ }
363
+ }
364
+ function portableBinding(binding) {
365
+ return {
366
+ identity: binding.identity,
367
+ resourceKind: binding.resourceKind,
368
+ generatedSymbol: binding.generatedSymbol,
369
+ registerSpace: binding.registerSpace,
370
+ registerIndex: binding.registerIndex,
371
+ type: binding.type,
372
+ buffer: binding.buffer
373
+ };
374
+ }
375
+ function applyBindingPlan(bindings, bindingPlan) {
376
+ if (bindingPlan === null || bindingPlan === undefined) return bindings;
377
+ if (bindingPlan?.format !== "CJS_WGSL_BINDING_PLAN" || bindingPlan.formatVersion !== 2 || !Array.isArray(bindingPlan.bindings) || bindingPlan.bindings.length !== bindings.length) {
378
+ throw new TypeError("WGSL compute binding plan must provide exact version 2 compute coverage");
379
+ }
380
+ const planned = new Map();
381
+ const slots = new Set();
382
+ for (const entry of bindingPlan.bindings) {
383
+ const identity = `${entry.resourceKind}:${entry.registerSpace}:${entry.registerIndex}`;
384
+ const slot = `${entry.group}:${entry.binding}`;
385
+ if (entry.identity !== identity || entry.scopeIdentity !== `${identity}@compute` || entry.stages?.length !== 1 || entry.stages[0] !== "compute" || !Number.isInteger(entry.group) || entry.group < 0 || !Number.isInteger(entry.binding) || entry.binding < 0 || planned.has(identity) || slots.has(slot)) {
386
+ throw new Error(`WGSL compute binding plan contains an invalid entry ${entry.identity || identity}`);
387
+ }
388
+ planned.set(identity, entry);
389
+ slots.add(slot);
390
+ }
391
+ return bindings.map(binding => {
392
+ const entry = planned.get(binding.identity);
393
+ if (!entry || JSON.stringify(portableBinding(binding)) !== JSON.stringify({
394
+ identity: entry.identity,
395
+ resourceKind: entry.resourceKind,
396
+ generatedSymbol: entry.generatedSymbol,
397
+ registerSpace: entry.registerSpace,
398
+ registerIndex: entry.registerIndex,
399
+ type: entry.type,
400
+ buffer: entry.buffer
401
+ })) {
402
+ throw new Error(`WGSL compute binding plan layout for ${binding.identity} does not match the shader declaration`);
403
+ }
404
+ return {
405
+ ...binding,
406
+ scopeIdentity: entry.scopeIdentity,
407
+ group: entry.group,
408
+ binding: entry.binding
409
+ };
410
+ });
411
+ }
412
+
413
413
  /**
414
414
  * Lowers the two scalar typed-buffer bindings used by the first compute slice.
415
415
  *
416
416
  * @param {object} program Frozen CJS shader IR.
417
417
  * @param {object|null} [bindingPlan] Optional exact compute-only binding plan.
418
418
  * @returns {object[]} Frozen WebGPU binding records.
419
- */
420
- function lowerComputeBindingLayout(program, bindingPlan = null) {
421
- if (program?.format !== "CJS_SHADER_IR" || program.formatVersion !== 1) {
422
- throw new TypeError("WGSL compute binding lowering expects CJS_SHADER_IR version 1 input");
423
- }
424
- const bindings = Array.from(program.bindings || []).sort((left, right) => bindingSpace(left) - bindingSpace(right) || (KIND_ORDER[left.resourceKind] ?? 99) - (KIND_ORDER[right.resourceKind] ?? 99) || bindingRegister(left) - bindingRegister(right) || left.declarationOffset - right.declarationOffset);
425
- if (bindings.length !== 2 || bindings.filter(entry => entry.resourceKind === "sampled-resource").length !== 1 || bindings.filter(entry => entry.resourceKind === "storage-resource").length !== 1) {
426
- throw new Error("WGSL compute body slice requires exactly one typed SRV and one typed UAV");
427
- }
428
- const identities = new Set();
429
- const lowered = bindings.map((binding, bindingIndex) => {
430
- const identity = bindingIdentity(binding);
431
- if (identities.has(identity)) {
432
- throw new Error(`WGSL compute binding layout contains duplicate ${identity}`);
433
- }
434
- identities.add(identity);
435
- const sampled = binding.resourceKind === "sampled-resource";
436
- validateBindingDeclaration(program, binding, sampled ? "dcl_resource" : "dcl_unordered_access_view_typed", sampled ? "resource" : "uav", sampled ? "sint" : "uint");
437
- const registerIndex = bindingRegister(binding);
438
- const registerSpace = bindingSpace(binding);
439
- return {
440
- kind: "wgsl-binding",
441
- id: binding.id,
442
- identity,
443
- scopeIdentity: `${identity}@compute`,
444
- resourceKind: binding.resourceKind,
445
- generatedSymbol: `${KIND_PREFIX[binding.resourceKind]}${registerIndex}`,
446
- registerSpace,
447
- registerIndex,
448
- rangeId: null,
449
- group: 0,
450
- binding: bindingIndex,
451
- visibility: "compute",
452
- declarationOffset: binding.declarationOffset,
453
- declaration: sampled ? "var<storage, read>" : "var<storage, read_write>",
454
- type: sampled ? "array<i32>" : "array<atomic<u32>>",
455
- buffer: {
456
- type: sampled ? "read-only-storage" : "storage",
457
- hasDynamicOffset: false,
458
- minBindingSize: 4
459
- }
460
- };
461
- });
462
- return deepFreeze(applyBindingPlan(lowered, bindingPlan));
463
- }
464
- function bindingForOperand(bindings, resourceKind, operand, instruction, operandIndex) {
465
- validateFixedHandleOperand(instruction, operandIndex, operand.typeName, "compute");
466
- const matches = bindings.filter(entry => entry.resourceKind === resourceKind && entry.registerIndex === operand.registerIndex && entry.registerSpace === 0);
467
- if (matches.length !== 1) {
468
- throw new Error(`WGSL compute instruction ${instruction.index} has an unresolved ${resourceKind} binding`);
469
- }
470
- return validateFixedHandleBinding(operand, matches[0], "compute");
471
- }
472
- function validateProgramShape(program) {
473
- if (program?.format !== "CJS_SHADER_IR" || program.formatVersion !== 1) {
474
- throw new TypeError("WGSL compute lowering expects CJS_SHADER_IR version 1 input");
475
- }
476
- if (program.stage !== "compute") throw new Error(`WGSL compute lowering cannot lower ${program.stage}`);
477
- if (program.shaderModel?.major !== 5 || program.shaderModel.minor !== 0) {
478
- throw new Error("WGSL compute body slice currently supports only SM5.0");
479
- }
480
- if ((program.signatures?.input || []).length || (program.signatures?.output || []).length || (program.signatures?.patch || []).length || program.immediateConstantBuffer || program.constTables) {
481
- throw new Error("WGSL compute body slice does not support signatures or constant tables");
482
- }
483
- if (program.declarations?.length !== DECLARATION_OPCODES.length || DECLARATION_OPCODES.some((opcodeName, index) => program.declarations[index]?.opcodeName !== opcodeName)) {
484
- throw new Error("WGSL compute declaration shape is not supported; the bounded body slice requires canonical global/SRV/UAV/temp/thread-group declarations");
485
- }
486
- const temp = program.declarations[3];
487
- const group = program.declarations[4];
488
- if (temp.data?.tempCount !== 1 || group.data?.threadGroupX !== 1 || group.data?.threadGroupY !== 1 || group.data?.threadGroupZ !== 1) {
489
- throw new Error("WGSL compute body slice requires one temporary and dcl_thread_group 1,1,1");
490
- }
491
- requireRefactoringAllowed(program, "compute");
492
- if (!Array.isArray(program.instructions) || program.instructions.length < 2 || program.instructions.at(-1)?.opcodeName !== "ret" || program.instructions.slice(0, -1).some(instruction => instruction.opcodeName === "ret") || program.instructions.some(instruction => !SUPPORTED_OPCODES.has(instruction.opcodeName)) || program.instructions.some((instruction, index) => instruction.index !== index || index > 0 && instruction.dxbcOffset <= program.instructions[index - 1].dxbcOffset)) {
493
- throw new Error("WGSL compute body slice requires one straight-line supported instruction sequence ending in ret");
494
- }
495
- const block = program.blocks?.[0];
496
- if (program.blocks?.length !== 1 || block.id !== "block0" || block.index !== 0 || block.startInstruction !== 0 || block.endInstruction !== program.instructions.length - 1 || block.terminator !== "ret" || block.reachable === false || block.successors?.length || block.predecessors?.length || block.mergeSite !== null || block.inputValueIds?.length || block.instructionIndices?.length !== program.instructions.length || block.instructionIndices.some((value, index) => value !== index)) {
497
- throw new Error("WGSL compute body slice requires one canonical reachable return block");
498
- }
499
- }
500
- function validateInstructionEnvelope(instruction) {
501
- const isReturn = instruction.opcodeName === "ret";
502
- if (instruction.controlKind !== (isReturn ? "termination" : null) || instruction.testBoolean !== null || instruction.saturate || instruction.preciseMask !== "" || instruction.opcodeName !== "ld" && instruction.extensions?.length) {
503
- throw new Error(`WGSL compute instruction ${instruction.index} has unsupported control, modifier, or extension metadata`);
504
- }
505
- for (let operandIndex = 0; operandIndex < instruction.operands.length; operandIndex += 1) {
506
- validateCommonOperand(instruction.operands[operandIndex], instruction, operandIndex);
507
- }
508
- }
509
- function validateLoadExtensions(instruction) {
510
- const extensions = instruction.extensions || [];
511
- validateSm50ResourceExtensions(extensions, {
512
- resourceDimension: 1,
513
- resourceDimensionName: "buffer",
514
- structureStride: 0,
515
- resourceReturnTypes: [3, 3, 3, 3]
516
- }, `WGSL compute load instruction ${instruction.index}`);
517
- }
518
- function validateNullHighDestination(instruction) {
519
- const operand = instruction.operands[0];
520
- validateCommonOperand(operand, instruction, 0);
521
- if (operand.typeName !== "null" || operand.componentCount !== 0 || operand.registerIndex !== null || operand.indices?.length || operand.mask || operand.swizzle || operand.selected || operand.immediateValues?.length) {
522
- throw new Error(`WGSL compute imul instruction ${instruction.index} requires a null high destination`);
523
- }
524
- }
525
- function seedRegisterState(program) {
526
- const state = new Map();
527
- const valueIds = new Set();
528
- for (const value of program.values || []) {
529
- if (valueIds.has(value.id)) {
530
- throw new Error(`WGSL compute program contains duplicate value ${value.id}`);
531
- }
532
- valueIds.add(value.id);
533
- if (!["undefined-register", "instruction-write"].includes(value.origin) || value.register !== "temp[0]" || value.writeMask.length !== 1 || !COMPONENTS.includes(value.writeMask) || Object.keys(value.componentTypes || {}).length !== 1 || (value.origin === "instruction-write" ? !scalarTypeName(value.componentTypes[value.writeMask]) : value.componentTypes[value.writeMask] !== "unknown")) {
534
- throw new Error(`WGSL compute value ${value.id} is outside the bounded temp[0] scalar slice`);
535
- }
536
- if (value.origin === "undefined-register") {
537
- if (value.instructionIndex !== null || value.blockId !== null || value.previous !== null) {
538
- throw new Error(`WGSL compute undefined value ${value.id} has inconsistent origin metadata`);
539
- }
540
- const key = `${value.register}.${value.writeMask}`;
541
- if (state.has(key)) {
542
- throw new Error(`WGSL compute program contains duplicate undefined ${key}`);
543
- }
544
- state.set(key, {
545
- valueId: value.id,
546
- component: value.writeMask
547
- });
548
- } else if (value.blockId !== "block0") {
549
- throw new Error(`WGSL compute instruction value ${value.id} belongs to an unexpected block`);
550
- }
551
- }
552
- return state;
553
- }
554
- function validateBlockOutput(program, state) {
555
- const outputs = program.blocks[0].outputValues || [];
556
- const expected = Array.from(state, ([key, ref]) => {
557
- const split = key.lastIndexOf(".");
558
- return {
559
- register: key.slice(0, split),
560
- component: key.slice(split + 1),
561
- ref
562
- };
563
- }).sort((left, right) => compareUtf8(left.register, right.register) || compareUtf8(left.component, right.component));
564
- const actual = outputs.slice().sort((left, right) => compareUtf8(left.register, right.register) || compareUtf8(left.component, right.component));
565
- if (actual.length !== expected.length || expected.some((entry, index) => actual[index]?.register !== entry.register || actual[index]?.component !== entry.component || !sameRef(actual[index]?.ref, entry.ref))) {
566
- throw new Error("WGSL compute block output does not match the final scalar register state");
567
- }
568
- }
569
-
419
+ */
420
+ function lowerComputeBindingLayout(program, bindingPlan = null) {
421
+ if (program?.format !== "CJS_SHADER_IR" || program.formatVersion !== 1) {
422
+ throw new TypeError("WGSL compute binding lowering expects CJS_SHADER_IR version 1 input");
423
+ }
424
+ const bindings = Array.from(program.bindings || []).sort((left, right) => bindingSpace(left) - bindingSpace(right) || (KIND_ORDER[left.resourceKind] ?? 99) - (KIND_ORDER[right.resourceKind] ?? 99) || bindingRegister(left) - bindingRegister(right) || left.declarationOffset - right.declarationOffset);
425
+ if (bindings.length !== 2 || bindings.filter(entry => entry.resourceKind === "sampled-resource").length !== 1 || bindings.filter(entry => entry.resourceKind === "storage-resource").length !== 1) {
426
+ throw new Error("WGSL compute body slice requires exactly one typed SRV and one typed UAV");
427
+ }
428
+ const identities = new Set();
429
+ const lowered = bindings.map((binding, bindingIndex) => {
430
+ const identity = bindingIdentity(binding);
431
+ if (identities.has(identity)) {
432
+ throw new Error(`WGSL compute binding layout contains duplicate ${identity}`);
433
+ }
434
+ identities.add(identity);
435
+ const sampled = binding.resourceKind === "sampled-resource";
436
+ validateBindingDeclaration(program, binding, sampled ? "dcl_resource" : "dcl_unordered_access_view_typed", sampled ? "resource" : "uav", sampled ? "sint" : "uint");
437
+ const registerIndex = bindingRegister(binding);
438
+ const registerSpace = bindingSpace(binding);
439
+ return {
440
+ kind: "wgsl-binding",
441
+ id: binding.id,
442
+ identity,
443
+ scopeIdentity: `${identity}@compute`,
444
+ resourceKind: binding.resourceKind,
445
+ generatedSymbol: `${KIND_PREFIX[binding.resourceKind]}${registerIndex}`,
446
+ registerSpace,
447
+ registerIndex,
448
+ rangeId: null,
449
+ group: 0,
450
+ binding: bindingIndex,
451
+ visibility: "compute",
452
+ declarationOffset: binding.declarationOffset,
453
+ declaration: sampled ? "var<storage, read>" : "var<storage, read_write>",
454
+ type: sampled ? "array<i32>" : "array<atomic<u32>>",
455
+ buffer: {
456
+ type: sampled ? "read-only-storage" : "storage",
457
+ hasDynamicOffset: false,
458
+ minBindingSize: 4
459
+ }
460
+ };
461
+ });
462
+ return deepFreeze(applyBindingPlan(lowered, bindingPlan));
463
+ }
464
+ function bindingForOperand(bindings, resourceKind, operand, instruction, operandIndex) {
465
+ validateFixedHandleOperand(instruction, operandIndex, operand.typeName, "compute");
466
+ const matches = bindings.filter(entry => entry.resourceKind === resourceKind && entry.registerIndex === operand.registerIndex && entry.registerSpace === 0);
467
+ if (matches.length !== 1) {
468
+ throw new Error(`WGSL compute instruction ${instruction.index} has an unresolved ${resourceKind} binding`);
469
+ }
470
+ return validateFixedHandleBinding(operand, matches[0], "compute");
471
+ }
472
+ function validateProgramShape(program) {
473
+ if (program?.format !== "CJS_SHADER_IR" || program.formatVersion !== 1) {
474
+ throw new TypeError("WGSL compute lowering expects CJS_SHADER_IR version 1 input");
475
+ }
476
+ if (program.stage !== "compute") throw new Error(`WGSL compute lowering cannot lower ${program.stage}`);
477
+ if (program.shaderModel?.major !== 5 || program.shaderModel.minor !== 0) {
478
+ throw new Error("WGSL compute body slice currently supports only SM5.0");
479
+ }
480
+ if ((program.signatures?.input || []).length || (program.signatures?.output || []).length || (program.signatures?.patch || []).length || program.immediateConstantBuffer || program.constTables) {
481
+ throw new Error("WGSL compute body slice does not support signatures or constant tables");
482
+ }
483
+ if (program.declarations?.length !== DECLARATION_OPCODES.length || DECLARATION_OPCODES.some((opcodeName, index) => program.declarations[index]?.opcodeName !== opcodeName)) {
484
+ throw new Error("WGSL compute declaration shape is not supported; the bounded body slice requires canonical global/SRV/UAV/temp/thread-group declarations");
485
+ }
486
+ const temp = program.declarations[3];
487
+ const group = program.declarations[4];
488
+ if (temp.data?.tempCount !== 1 || group.data?.threadGroupX !== 1 || group.data?.threadGroupY !== 1 || group.data?.threadGroupZ !== 1) {
489
+ throw new Error("WGSL compute body slice requires one temporary and dcl_thread_group 1,1,1");
490
+ }
491
+ requireRefactoringAllowed(program, "compute");
492
+ if (!Array.isArray(program.instructions) || program.instructions.length < 2 || program.instructions.at(-1)?.opcodeName !== "ret" || program.instructions.slice(0, -1).some(instruction => instruction.opcodeName === "ret") || program.instructions.some(instruction => !SUPPORTED_OPCODES.has(instruction.opcodeName)) || program.instructions.some((instruction, index) => instruction.index !== index || index > 0 && instruction.dxbcOffset <= program.instructions[index - 1].dxbcOffset)) {
493
+ throw new Error("WGSL compute body slice requires one straight-line supported instruction sequence ending in ret");
494
+ }
495
+ const block = program.blocks?.[0];
496
+ if (program.blocks?.length !== 1 || block.id !== "block0" || block.index !== 0 || block.startInstruction !== 0 || block.endInstruction !== program.instructions.length - 1 || block.terminator !== "ret" || block.reachable === false || block.successors?.length || block.predecessors?.length || block.mergeSite !== null || block.inputValueIds?.length || block.instructionIndices?.length !== program.instructions.length || block.instructionIndices.some((value, index) => value !== index)) {
497
+ throw new Error("WGSL compute body slice requires one canonical reachable return block");
498
+ }
499
+ }
500
+ function validateInstructionEnvelope(instruction) {
501
+ const isReturn = instruction.opcodeName === "ret";
502
+ if (instruction.controlKind !== (isReturn ? "termination" : null) || instruction.testBoolean !== null || instruction.saturate || instruction.preciseMask !== "" || instruction.opcodeName !== "ld" && instruction.extensions?.length) {
503
+ throw new Error(`WGSL compute instruction ${instruction.index} has unsupported control, modifier, or extension metadata`);
504
+ }
505
+ for (let operandIndex = 0; operandIndex < instruction.operands.length; operandIndex += 1) {
506
+ validateCommonOperand(instruction.operands[operandIndex], instruction, operandIndex);
507
+ }
508
+ }
509
+ function validateLoadExtensions(instruction) {
510
+ const extensions = instruction.extensions || [];
511
+ validateSm50ResourceExtensions(extensions, {
512
+ resourceDimension: 1,
513
+ resourceDimensionName: "buffer",
514
+ structureStride: 0,
515
+ resourceReturnTypes: [3, 3, 3, 3]
516
+ }, `WGSL compute load instruction ${instruction.index}`);
517
+ }
518
+ function validateNullHighDestination(instruction) {
519
+ const operand = instruction.operands[0];
520
+ validateCommonOperand(operand, instruction, 0);
521
+ if (operand.typeName !== "null" || operand.componentCount !== 0 || operand.registerIndex !== null || operand.indices?.length || operand.mask || operand.swizzle || operand.selected || operand.immediateValues?.length) {
522
+ throw new Error(`WGSL compute imul instruction ${instruction.index} requires a null high destination`);
523
+ }
524
+ }
525
+ function seedRegisterState(program) {
526
+ const state = new Map();
527
+ const valueIds = new Set();
528
+ for (const value of program.values || []) {
529
+ if (valueIds.has(value.id)) {
530
+ throw new Error(`WGSL compute program contains duplicate value ${value.id}`);
531
+ }
532
+ valueIds.add(value.id);
533
+ if (!["undefined-register", "instruction-write"].includes(value.origin) || value.register !== "temp[0]" || value.writeMask.length !== 1 || !COMPONENTS.includes(value.writeMask) || Object.keys(value.componentTypes || {}).length !== 1 || (value.origin === "instruction-write" ? !scalarTypeName(value.componentTypes[value.writeMask]) : value.componentTypes[value.writeMask] !== "unknown")) {
534
+ throw new Error(`WGSL compute value ${value.id} is outside the bounded temp[0] scalar slice`);
535
+ }
536
+ if (value.origin === "undefined-register") {
537
+ if (value.instructionIndex !== null || value.blockId !== null || value.previous !== null) {
538
+ throw new Error(`WGSL compute undefined value ${value.id} has inconsistent origin metadata`);
539
+ }
540
+ const key = `${value.register}.${value.writeMask}`;
541
+ if (state.has(key)) {
542
+ throw new Error(`WGSL compute program contains duplicate undefined ${key}`);
543
+ }
544
+ state.set(key, {
545
+ valueId: value.id,
546
+ component: value.writeMask
547
+ });
548
+ } else if (value.blockId !== "block0") {
549
+ throw new Error(`WGSL compute instruction value ${value.id} belongs to an unexpected block`);
550
+ }
551
+ }
552
+ return state;
553
+ }
554
+ function validateBlockOutput(program, state) {
555
+ const outputs = program.blocks[0].outputValues || [];
556
+ const expected = Array.from(state, ([key, ref]) => {
557
+ const split = key.lastIndexOf(".");
558
+ return {
559
+ register: key.slice(0, split),
560
+ component: key.slice(split + 1),
561
+ ref
562
+ };
563
+ }).sort((left, right) => compareUtf8(left.register, right.register) || compareUtf8(left.component, right.component));
564
+ const actual = outputs.slice().sort((left, right) => compareUtf8(left.register, right.register) || compareUtf8(left.component, right.component));
565
+ if (actual.length !== expected.length || expected.some((entry, index) => actual[index]?.register !== entry.register || actual[index]?.component !== entry.component || !sameRef(actual[index]?.ref, entry.ref))) {
566
+ throw new Error("WGSL compute block output does not match the final scalar register state");
567
+ }
568
+ }
569
+
570
570
  /**
571
571
  * Lowers the bounded setdrawparameters/setsortargs compute slice into typed SSA.
572
572
  *
573
573
  * @param {object} program Frozen CJS shader IR.
574
574
  * @param {object} [options] Optional exact compute-only binding plan.
575
575
  * @returns {object} Frozen typed compute program.
576
- */
577
- function lowerScalarWordComputeProgram(program, options = {}) {
578
- validateProgramShape(program);
579
- const bindings = lowerComputeBindingLayout(program, options.bindingPlan ?? null);
580
- const state = seedRegisterState(program);
581
- const writtenValueIds = new Set();
582
- const statements = [];
583
- for (const instruction of program.instructions) {
584
- validateInstructionEnvelope(instruction);
585
- validateTypeInfo(program, instruction);
586
- const expectedReads = new Set();
587
- if (instruction.opcodeName === "ret") {
588
- if (instruction.operands.length || instruction.dataflow.reads.length || instruction.dataflow.writes.length) {
589
- throw new Error(`WGSL compute return instruction ${instruction.index} must be operand-free`);
590
- }
591
- statements.push({
592
- kind: "return",
593
- instructionIndex: instruction.index,
594
- dxbcOffset: instruction.dxbcOffset
595
- });
596
- continue;
597
- }
598
- if (instruction.opcodeName === "ld") {
599
- if (instruction.operands.length !== 3) {
600
- throw new Error(`WGSL compute load instruction ${instruction.index} requires three operands`);
601
- }
602
- validateLoadExtensions(instruction);
603
- const destination = instruction.operands[0];
604
- validateDestinationOperand(destination, instruction, 0);
605
- if (destination.mask !== "x") {
606
- throw new Error(`WGSL compute load instruction ${instruction.index} scalar-word profile requires the x destination lane`);
607
- }
608
- const address = immediateCode(immediateBits(instruction.operands[1], instruction, 1, true), "uint32");
609
- const resource = validateFixedRegisterOperand(instruction.operands[2], instruction, 2, "resource");
610
- if (resource.componentCount !== 4 || resource.swizzle !== "xyzw" || resource.mask || resource.selected) {
611
- throw new Error(`WGSL compute load instruction ${instruction.index} requires a canonical xyzw resource selection`);
612
- }
613
- const binding = bindingForOperand(bindings, "sampled-resource", resource, instruction, 2);
614
- const {
615
- write,
616
- value
617
- } = validateWrite(program, instruction, 0, destination, state, writtenValueIds);
618
- validateNoUnexpectedReads(instruction, expectedReads);
619
- const length = `arrayLength(&${binding.generatedSymbol})`;
620
- const intrinsic = `select(0i, ${binding.generatedSymbol}[min(${address}, ${length} - 1u)], ${address} < ${length})`;
621
- const storage = valueStorageType(value, write.mask);
622
- statements.push({
623
- kind: "let",
624
- instructionIndex: instruction.index,
625
- dxbcOffset: instruction.dxbcOffset,
626
- name: value.id,
627
- type: scalarTypeName(storage),
628
- expression: {
629
- code: reinterpretCode(intrinsic, "int32", storage),
630
- type: scalarTypeName(storage)
631
- }
632
- });
633
- continue;
634
- }
635
- const arithmetic = ARITHMETIC_RULES[instruction.opcodeName];
636
- if (arithmetic) {
637
- if (instruction.operands.length !== (instruction.opcodeName === "imul" ? 4 : 3)) {
638
- throw new Error(`WGSL compute ${instruction.opcodeName} instruction ${instruction.index} has an unsupported operand count`);
639
- }
640
- if (instruction.opcodeName === "imul") validateNullHighDestination(instruction);
641
- const destination = instruction.operands[arithmetic.destinationOperand];
642
- validateDestinationOperand(destination, instruction, arithmetic.destinationOperand);
643
- const sources = arithmetic.sourceOperands.map(operandIndex => readCode(program, instruction, operandIndex, arithmetic.sourceType, state, expectedReads));
644
- validateNoUnexpectedReads(instruction, expectedReads);
645
- const intrinsic = arithmetic.functionName ? `${arithmetic.functionName}(${sources.join(", ")})` : `(${sources[0]} ${arithmetic.operator} ${sources[1]})`;
646
- const {
647
- write,
648
- value
649
- } = validateWrite(program, instruction, arithmetic.destinationOperand, destination, state, writtenValueIds);
650
- const storage = valueStorageType(value, write.mask);
651
- statements.push({
652
- kind: "let",
653
- instructionIndex: instruction.index,
654
- dxbcOffset: instruction.dxbcOffset,
655
- name: value.id,
656
- type: scalarTypeName(storage),
657
- expression: {
658
- code: reinterpretCode(intrinsic, arithmetic.resultType, storage),
659
- type: scalarTypeName(storage)
660
- }
661
- });
662
- continue;
663
- }
664
- if (instruction.opcodeName === "store_uav_typed") {
665
- if (instruction.operands.length !== 3 || instruction.dataflow.writes.length) {
666
- throw new Error(`WGSL compute store instruction ${instruction.index} requires three source operands`);
667
- }
668
- const uav = validateFixedRegisterOperand(instruction.operands[0], instruction, 0, "uav");
669
- if (uav.componentCount !== 4 || uav.mask !== "xyzw" || uav.swizzle || uav.selected) {
670
- throw new Error(`WGSL compute store instruction ${instruction.index} requires a full xyzw UAV mask`);
671
- }
672
- const binding = bindingForOperand(bindings, "storage-resource", uav, instruction, 0);
673
- const address = immediateCode(immediateBits(instruction.operands[1], instruction, 1, true), "uint32");
674
- const value = replicatedStoreCode(program, instruction, 2, state, expectedReads);
675
- validateNoUnexpectedReads(instruction, expectedReads);
676
- statements.push({
677
- kind: "if",
678
- instructionIndex: instruction.index,
679
- dxbcOffset: instruction.dxbcOffset,
680
- condition: {
681
- code: `${address} < arrayLength(&${binding.generatedSymbol})`,
682
- type: "bool"
683
- },
684
- statements: [{
685
- kind: "call",
686
- instructionIndex: instruction.index,
687
- dxbcOffset: instruction.dxbcOffset,
688
- expression: {
689
- code: `atomicStore(&${binding.generatedSymbol}[${address}], ${value})`,
690
- type: "void"
691
- }
692
- }]
693
- });
694
- }
695
- }
696
- if (writtenValueIds.size !== program.values.filter(value => value.origin === "instruction-write").length) {
697
- throw new Error("WGSL compute program contains an unowned instruction-write value");
698
- }
699
- validateBlockOutput(program, state);
700
- return deepFreeze({
701
- kind: "typed-shader-program",
702
- format: "CJS_TYPED_SHADER",
703
- formatVersion: 1,
704
- source: program.source,
705
- stage: "compute",
706
- entryPoint: "main",
707
- threadGroupSize: [1, 1, 1],
708
- bindings,
709
- statements
710
- });
711
- }
712
-
576
+ */
577
+ function lowerScalarWordComputeProgram(program, options = {}) {
578
+ validateProgramShape(program);
579
+ const bindings = lowerComputeBindingLayout(program, options.bindingPlan ?? null);
580
+ const state = seedRegisterState(program);
581
+ const writtenValueIds = new Set();
582
+ const statements = [];
583
+ for (const instruction of program.instructions) {
584
+ validateInstructionEnvelope(instruction);
585
+ validateTypeInfo(program, instruction);
586
+ const expectedReads = new Set();
587
+ if (instruction.opcodeName === "ret") {
588
+ if (instruction.operands.length || instruction.dataflow.reads.length || instruction.dataflow.writes.length) {
589
+ throw new Error(`WGSL compute return instruction ${instruction.index} must be operand-free`);
590
+ }
591
+ statements.push({
592
+ kind: "return",
593
+ instructionIndex: instruction.index,
594
+ dxbcOffset: instruction.dxbcOffset
595
+ });
596
+ continue;
597
+ }
598
+ if (instruction.opcodeName === "ld") {
599
+ if (instruction.operands.length !== 3) {
600
+ throw new Error(`WGSL compute load instruction ${instruction.index} requires three operands`);
601
+ }
602
+ validateLoadExtensions(instruction);
603
+ const destination = instruction.operands[0];
604
+ validateDestinationOperand(destination, instruction, 0);
605
+ if (destination.mask !== "x") {
606
+ throw new Error(`WGSL compute load instruction ${instruction.index} scalar-word profile requires the x destination lane`);
607
+ }
608
+ const address = immediateCode(immediateBits(instruction.operands[1], instruction, 1, true), "uint32");
609
+ const resource = validateFixedRegisterOperand(instruction.operands[2], instruction, 2, "resource");
610
+ if (resource.componentCount !== 4 || resource.swizzle !== "xyzw" || resource.mask || resource.selected) {
611
+ throw new Error(`WGSL compute load instruction ${instruction.index} requires a canonical xyzw resource selection`);
612
+ }
613
+ const binding = bindingForOperand(bindings, "sampled-resource", resource, instruction, 2);
614
+ const {
615
+ write,
616
+ value
617
+ } = validateWrite(program, instruction, 0, destination, state, writtenValueIds);
618
+ validateNoUnexpectedReads(instruction, expectedReads);
619
+ const length = `arrayLength(&${binding.generatedSymbol})`;
620
+ const intrinsic = `select(0i, ${binding.generatedSymbol}[min(${address}, ${length} - 1u)], ${address} < ${length})`;
621
+ const storage = valueStorageType(value, write.mask);
622
+ statements.push({
623
+ kind: "let",
624
+ instructionIndex: instruction.index,
625
+ dxbcOffset: instruction.dxbcOffset,
626
+ name: value.id,
627
+ type: scalarTypeName(storage),
628
+ expression: {
629
+ code: reinterpretCode(intrinsic, "int32", storage),
630
+ type: scalarTypeName(storage)
631
+ }
632
+ });
633
+ continue;
634
+ }
635
+ const arithmetic = ARITHMETIC_RULES[instruction.opcodeName];
636
+ if (arithmetic) {
637
+ if (instruction.operands.length !== (instruction.opcodeName === "imul" ? 4 : 3)) {
638
+ throw new Error(`WGSL compute ${instruction.opcodeName} instruction ${instruction.index} has an unsupported operand count`);
639
+ }
640
+ if (instruction.opcodeName === "imul") validateNullHighDestination(instruction);
641
+ const destination = instruction.operands[arithmetic.destinationOperand];
642
+ validateDestinationOperand(destination, instruction, arithmetic.destinationOperand);
643
+ const sources = arithmetic.sourceOperands.map(operandIndex => readCode(program, instruction, operandIndex, arithmetic.sourceType, state, expectedReads));
644
+ validateNoUnexpectedReads(instruction, expectedReads);
645
+ const intrinsic = arithmetic.functionName ? `${arithmetic.functionName}(${sources.join(", ")})` : `(${sources[0]} ${arithmetic.operator} ${sources[1]})`;
646
+ const {
647
+ write,
648
+ value
649
+ } = validateWrite(program, instruction, arithmetic.destinationOperand, destination, state, writtenValueIds);
650
+ const storage = valueStorageType(value, write.mask);
651
+ statements.push({
652
+ kind: "let",
653
+ instructionIndex: instruction.index,
654
+ dxbcOffset: instruction.dxbcOffset,
655
+ name: value.id,
656
+ type: scalarTypeName(storage),
657
+ expression: {
658
+ code: reinterpretCode(intrinsic, arithmetic.resultType, storage),
659
+ type: scalarTypeName(storage)
660
+ }
661
+ });
662
+ continue;
663
+ }
664
+ if (instruction.opcodeName === "store_uav_typed") {
665
+ if (instruction.operands.length !== 3 || instruction.dataflow.writes.length) {
666
+ throw new Error(`WGSL compute store instruction ${instruction.index} requires three source operands`);
667
+ }
668
+ const uav = validateFixedRegisterOperand(instruction.operands[0], instruction, 0, "uav");
669
+ if (uav.componentCount !== 4 || uav.mask !== "xyzw" || uav.swizzle || uav.selected) {
670
+ throw new Error(`WGSL compute store instruction ${instruction.index} requires a full xyzw UAV mask`);
671
+ }
672
+ const binding = bindingForOperand(bindings, "storage-resource", uav, instruction, 0);
673
+ const address = immediateCode(immediateBits(instruction.operands[1], instruction, 1, true), "uint32");
674
+ const value = replicatedStoreCode(program, instruction, 2, state, expectedReads);
675
+ validateNoUnexpectedReads(instruction, expectedReads);
676
+ statements.push({
677
+ kind: "if",
678
+ instructionIndex: instruction.index,
679
+ dxbcOffset: instruction.dxbcOffset,
680
+ condition: {
681
+ code: `${address} < arrayLength(&${binding.generatedSymbol})`,
682
+ type: "bool"
683
+ },
684
+ statements: [{
685
+ kind: "call",
686
+ instructionIndex: instruction.index,
687
+ dxbcOffset: instruction.dxbcOffset,
688
+ expression: {
689
+ code: `atomicStore(&${binding.generatedSymbol}[${address}], ${value})`,
690
+ type: "void"
691
+ }
692
+ }]
693
+ });
694
+ }
695
+ }
696
+ if (writtenValueIds.size !== program.values.filter(value => value.origin === "instruction-write").length) {
697
+ throw new Error("WGSL compute program contains an unowned instruction-write value");
698
+ }
699
+ validateBlockOutput(program, state);
700
+ return deepFreeze({
701
+ kind: "typed-shader-program",
702
+ format: "CJS_TYPED_SHADER",
703
+ formatVersion: 1,
704
+ source: program.source,
705
+ stage: "compute",
706
+ entryPoint: "main",
707
+ threadGroupSize: [1, 1, 1],
708
+ bindings,
709
+ statements
710
+ });
711
+ }
712
+
713
713
  /**
714
714
  * Routes one compute program to an exact declaration-shaped lowering profile.
715
715
  * Once a profile is selected its validation errors are final; malformed input
@@ -718,38 +718,38 @@ function lowerScalarWordComputeProgram(program, options = {}) {
718
718
  * @param {object} program Frozen CJS shader IR.
719
719
  * @param {object} [options] Optional exact compute-only binding plan.
720
720
  * @returns {object} Frozen typed compute program.
721
- */
722
- function lowerComputeProgram(program, options = {}) {
723
- validateExactComputeEnvelope(program, "WGSL compute");
724
- if (isParticleClearResetCandidate(program)) {
725
- return lowerParticleClearResetComputeProgram(program, options);
726
- }
727
- if (isParticleClearInitializeCandidate(program)) {
728
- return lowerParticleClearInitializeComputeProgram(program, options);
729
- }
730
- if (isParticleEmitComputeCandidate(program)) {
731
- return lowerParticleEmitComputeProgram(program, options);
732
- }
733
- if (isCreateHistogramsComputeProfile(program)) {
734
- return lowerCreateHistogramsComputeProgram(program, options);
735
- }
736
- if (isMergeHistogramsComputeProfile(program)) {
737
- return lowerMergeHistogramsComputeProgram(program, options);
738
- }
739
- if (isSortComputeProfile(program)) {
740
- return lowerSortComputeProgram(program, options);
741
- }
742
- if (isSortInnerComputeProfile(program)) {
743
- return lowerSortInnerComputeProgram(program, options);
744
- }
745
- if (isSortStepComputeProfile(program)) {
746
- return lowerSortStepComputeProgram(program, options);
747
- }
748
- if (isSkinVerticesComputeProfile(program)) {
749
- return lowerSkinVerticesComputeProgram(program, options);
750
- }
751
- return lowerScalarWordComputeProgram(program, options);
752
- }
753
-
754
- export { lowerComputeBindingLayout, lowerComputeProgram };
755
- //# sourceMappingURL=lowerComputeProgram.js.map
721
+ */
722
+ function lowerComputeProgram(program, options = {}) {
723
+ validateExactComputeEnvelope(program, "WGSL compute");
724
+ if (isParticleClearResetCandidate(program)) {
725
+ return lowerParticleClearResetComputeProgram(program, options);
726
+ }
727
+ if (isParticleClearInitializeCandidate(program)) {
728
+ return lowerParticleClearInitializeComputeProgram(program, options);
729
+ }
730
+ if (isParticleEmitComputeCandidate(program)) {
731
+ return lowerParticleEmitComputeProgram(program, options);
732
+ }
733
+ if (isCreateHistogramsComputeProfile(program)) {
734
+ return lowerCreateHistogramsComputeProgram(program, options);
735
+ }
736
+ if (isMergeHistogramsComputeProfile(program)) {
737
+ return lowerMergeHistogramsComputeProgram(program, options);
738
+ }
739
+ if (isSortComputeProfile(program)) {
740
+ return lowerSortComputeProgram(program, options);
741
+ }
742
+ if (isSortInnerComputeProfile(program)) {
743
+ return lowerSortInnerComputeProgram(program, options);
744
+ }
745
+ if (isSortStepComputeProfile(program)) {
746
+ return lowerSortStepComputeProgram(program, options);
747
+ }
748
+ if (isSkinVerticesComputeProfile(program)) {
749
+ return lowerSkinVerticesComputeProgram(program, options);
750
+ }
751
+ return lowerScalarWordComputeProgram(program, options);
752
+ }
753
+
754
+ export { lowerComputeBindingLayout, lowerComputeProgram };
755
+ //# sourceMappingURL=lowerComputeProgram.js.map