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