@carbonenginejs/runtime-resource 0.12.2 → 0.13.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (541) hide show
  1. package/LICENSE +21 -21
  2. package/NOTICE +32 -32
  3. package/README.md +129 -108
  4. package/dist/CjsMotherLode.js +1271 -1271
  5. package/dist/CjsResMan.js +3858 -3494
  6. package/dist/CjsResMan.js.map +1 -1
  7. package/dist/CjsResManFetchProvider.js +94 -94
  8. package/dist/CjsResManWorkQueue.js +301 -301
  9. package/dist/_virtual/_rollupPluginBabelHelpers.js +150 -150
  10. package/dist/format/CjsBlueReader.js +358 -358
  11. package/dist/format/CjsByteReader.js +310 -310
  12. package/dist/format/CjsByteWriter.js +242 -242
  13. package/dist/format/CjsFormat.js +223 -223
  14. package/dist/format/CjsFormatError.js +41 -41
  15. package/dist/format/CjsReader.js +22 -22
  16. package/dist/format/CjsResourceProbe.js +279 -279
  17. package/dist/format/CjsStringTable.js +268 -268
  18. package/dist/format/carbonEffect/CjsCarbonEffectReader.js +408 -361
  19. package/dist/format/carbonEffect/CjsCarbonEffectReader.js.map +1 -1
  20. package/dist/format/carbonEffect/CjsCarbonEffectWriter.js +373 -373
  21. package/dist/format/carbonEffect/buildCarbonEffectContainer.js +182 -0
  22. package/dist/format/carbonEffect/buildCarbonEffectContainer.js.map +1 -0
  23. package/dist/format/carbonEffect/carbonEffectBackendBlock.js +321 -427
  24. package/dist/format/carbonEffect/carbonEffectBackendBlock.js.map +1 -1
  25. package/dist/format/carbonEffect/carbonEffectRecords.js +1147 -955
  26. package/dist/format/carbonEffect/carbonEffectRecords.js.map +1 -1
  27. package/dist/format/carbonEffect/carbonEffectResourceTransform.js +197 -0
  28. package/dist/format/carbonEffect/carbonEffectResourceTransform.js.map +1 -0
  29. package/dist/format/compareUtf8.js +36 -36
  30. package/dist/format/effect/effectBodyInventory.js +146 -0
  31. package/dist/format/effect/effectBodyInventory.js.map +1 -0
  32. package/dist/format/effect/effectPermutationGraph.js +257 -257
  33. package/dist/format/effect/effectPermutationGraph.js.map +1 -1
  34. package/dist/format/effect/sha256.js +114 -114
  35. package/dist/format/index.js +11 -11
  36. package/dist/format/payloadContract.js +193 -193
  37. package/dist/formats/black/CjsBlackFormat.js +310 -292
  38. package/dist/formats/black/CjsBlackFormat.js.map +1 -1
  39. package/dist/formats/black/core/CjsBlackBinaryReader.js +260 -260
  40. package/dist/formats/black/core/CjsBlackPropertyReaders.js +448 -448
  41. package/dist/formats/black/core/CjsBlackReader.js +764 -764
  42. package/dist/formats/black/core/CjsBlackSchemaRegistry.js +540 -540
  43. package/dist/formats/black/core/black-schema-v1-2026-07-23.json.js +4 -4
  44. package/dist/formats/black/core/blackConstants.js +7 -7
  45. package/dist/formats/black/core/blackDefinitions.js +10 -10
  46. package/dist/formats/black/core/blackEnums.js +6 -6
  47. package/dist/formats/black/core/blackSchema.js +3 -3
  48. package/dist/formats/black/core/blackVersion.js +22 -22
  49. package/dist/formats/black/core/helpers.js +199 -199
  50. package/dist/formats/black/core/schema.js +4 -4
  51. package/dist/formats/black/index.js +2 -2
  52. package/dist/formats/bnk/CjsBnkFormat.js +175 -156
  53. package/dist/formats/bnk/CjsBnkFormat.js.map +1 -1
  54. package/dist/formats/bnk/core/busNodes.js +252 -0
  55. package/dist/formats/bnk/core/busNodes.js.map +1 -0
  56. package/dist/formats/bnk/core/effectNodes.js +147 -0
  57. package/dist/formats/bnk/core/effectNodes.js.map +1 -0
  58. package/dist/formats/bnk/core/eventAction.js +416 -305
  59. package/dist/formats/bnk/core/eventAction.js.map +1 -1
  60. package/dist/formats/bnk/core/globalSettings.js +215 -0
  61. package/dist/formats/bnk/core/globalSettings.js.map +1 -0
  62. package/dist/formats/bnk/core/graph.js +137 -137
  63. package/dist/formats/bnk/core/helpers.js +512 -480
  64. package/dist/formats/bnk/core/helpers.js.map +1 -1
  65. package/dist/formats/bnk/core/musicNodes.js +533 -509
  66. package/dist/formats/bnk/core/musicNodes.js.map +1 -1
  67. package/dist/formats/bnk/core/nodeBase.js +553 -532
  68. package/dist/formats/bnk/core/nodeBase.js.map +1 -1
  69. package/dist/formats/bnk/core/sfxNodes.js +632 -632
  70. package/dist/formats/bnk/core/soundbanksInfo.js +209 -209
  71. package/dist/formats/bnk/index.js +2 -2
  72. package/dist/formats/cmf/CjsCmfFormat.js +497 -497
  73. package/dist/formats/cmf/core/binary.js +194 -194
  74. package/dist/formats/cmf/core/buffers.js +237 -237
  75. package/dist/formats/cmf/core/constants.js +47 -47
  76. package/dist/formats/cmf/core/gr2Anim.js +453 -453
  77. package/dist/formats/cmf/core/helpers.js +318 -318
  78. package/dist/formats/cmf/core/pack.js +276 -276
  79. package/dist/formats/cmf/core/schema.js +374 -374
  80. package/dist/formats/cmf/core/shared.js +277 -277
  81. package/dist/formats/cmf/core/writer.js +571 -571
  82. package/dist/formats/cmf/index.js +2 -2
  83. package/dist/formats/dds/CjsDdsFormat.js +200 -200
  84. package/dist/formats/dds/core/bc6h.js +298 -298
  85. package/dist/formats/dds/core/bc7.js +272 -272
  86. package/dist/formats/dds/core/helpers.js +862 -862
  87. package/dist/formats/dds/index.js +2 -2
  88. package/dist/formats/dxbc/CjsDxbcFormat.js +142 -142
  89. package/dist/formats/dxbc/core/DxbcReader.js +266 -266
  90. package/dist/formats/dxbc/core/container.js +169 -169
  91. package/dist/formats/dxbc/core/decoder.js +789 -789
  92. package/dist/formats/dxbc/core/errors.js +19 -19
  93. package/dist/formats/dxbc/core/helpers.js +220 -220
  94. package/dist/formats/dxbc/core/opcodes.js +45 -45
  95. package/dist/formats/dxbc/core/program.js +91 -91
  96. package/dist/formats/dxbc/core/signature.js +172 -172
  97. package/dist/formats/dxbc/index.js +2 -2
  98. package/dist/formats/fbx/CjsFbxFormat.js +266 -266
  99. package/dist/formats/fbx/core/helpers.js +3932 -3932
  100. package/dist/formats/fbx/index.js +2 -2
  101. package/dist/formats/flac/CjsFlacFormat.js +142 -142
  102. package/dist/formats/flac/core/helpers.js +315 -315
  103. package/dist/formats/flac/index.js +2 -2
  104. package/dist/formats/gif/CjsGifFormat.js +141 -141
  105. package/dist/formats/gif/core/helpers.js +380 -380
  106. package/dist/formats/gif/index.js +2 -2
  107. package/dist/formats/gltf/CjsGltfFormat.js +290 -290
  108. package/dist/formats/gltf/core/helpers.js +307 -307
  109. package/dist/formats/gltf/core/json.js +79 -79
  110. package/dist/formats/gltf/core/parser.js +679 -679
  111. package/dist/formats/gltf/core/targets.js +173 -173
  112. package/dist/formats/gltf/index.js +2 -2
  113. package/dist/formats/gr2/CjsGr2Format.js +289 -289
  114. package/dist/formats/gr2/core/bitknit2.js +282 -282
  115. package/dist/formats/gr2/core/curves.js +1047 -1047
  116. package/dist/formats/gr2/core/gsf.js +72 -72
  117. package/dist/formats/gr2/core/helpers.js +352 -352
  118. package/dist/formats/gr2/core/json.js +622 -622
  119. package/dist/formats/gr2/core/oodle1.js +388 -388
  120. package/dist/formats/gr2/core/tangents.js +48 -48
  121. package/dist/formats/gr2/core/targets.js +361 -361
  122. package/dist/formats/gr2/index.js +2 -2
  123. package/dist/formats/hlsl/CjsHlslFormat.js +254 -254
  124. package/dist/formats/hlsl/core/HlslBinaryUtils.js +15 -15
  125. package/dist/formats/hlsl/core/HlslEffectReadError.js +19 -19
  126. package/dist/formats/hlsl/core/HlslEffectStateManager.js +130 -130
  127. package/dist/formats/hlsl/core/HlslRenderStateSetup.js +37 -37
  128. package/dist/formats/hlsl/core/HlslResourceSetDescription.js +94 -94
  129. package/dist/formats/hlsl/core/HlslShaderBytecode.js +44 -44
  130. package/dist/formats/hlsl/core/analysis.js +51 -51
  131. package/dist/formats/hlsl/core/carbonDescriptionToRuntime.js +850 -781
  132. package/dist/formats/hlsl/core/carbonDescriptionToRuntime.js.map +1 -1
  133. package/dist/formats/hlsl/core/detailMapFamily.js +128 -0
  134. package/dist/formats/hlsl/core/detailMapFamily.js.map +1 -0
  135. package/dist/formats/hlsl/core/helpers.js +270 -270
  136. package/dist/formats/hlsl/core/json.js +284 -284
  137. package/dist/formats/hlsl/core/localLightFamily.js +133 -0
  138. package/dist/formats/hlsl/core/localLightFamily.js.map +1 -0
  139. package/dist/formats/hlsl/core/metadata.js +327 -327
  140. package/dist/formats/hlsl/core/render-states.js +280 -280
  141. package/dist/formats/hlsl/core/tr2/HlslRenderContextEnum.js +43 -43
  142. package/dist/formats/hlsl/core/tr2/resources/HlslEffectRes.js +320 -314
  143. package/dist/formats/hlsl/core/tr2/resources/HlslEffectRes.js.map +1 -1
  144. package/dist/formats/hlsl/core/tr2/resources/HlslShaderPermutation.js +33 -33
  145. package/dist/formats/hlsl/core/tr2/shader/HlslEffectBindingManifest.js +416 -416
  146. package/dist/formats/hlsl/core/tr2/shader/HlslEffectConstant.js +40 -40
  147. package/dist/formats/hlsl/core/tr2/shader/HlslEffectDescription.js +62 -742
  148. package/dist/formats/hlsl/core/tr2/shader/HlslEffectDescription.js.map +1 -1
  149. package/dist/formats/hlsl/core/tr2/shader/HlslEffectLibrary.js +52 -52
  150. package/dist/formats/hlsl/core/tr2/shader/HlslEffectParameterAnnotation.js +38 -38
  151. package/dist/formats/hlsl/core/tr2/shader/HlslEffectResource.js +50 -50
  152. package/dist/formats/hlsl/core/tr2/shader/HlslEffectStageInput.js +86 -86
  153. package/dist/formats/hlsl/core/tr2/shader/HlslEffectTechnique.js +31 -31
  154. package/dist/formats/hlsl/core/tr2/shader/HlslPass.js +42 -42
  155. package/dist/formats/hlsl/core/tr2/shader/HlslSamplerDescription.js +55 -55
  156. package/dist/formats/hlsl/core/tr2/shader/HlslSamplerSetup.js +29 -29
  157. package/dist/formats/hlsl/core/tr2/shader/HlslShader.js +220 -220
  158. package/dist/formats/hlsl/core/tr2/shader/HlslShaderOption.js +30 -30
  159. package/dist/formats/hlsl/index.js +3 -3
  160. package/dist/formats/index.js +33 -31
  161. package/dist/formats/index.js.map +1 -1
  162. package/dist/formats/jpeg/CjsJpegFormat.js +212 -212
  163. package/dist/formats/jpeg/core/helpers.js +402 -402
  164. package/dist/formats/jpeg/core/jpeg.js +480 -480
  165. package/dist/formats/jpeg/index.js +2 -2
  166. package/dist/formats/mp3/CjsMp3Format.js +197 -197
  167. package/dist/formats/mp3/core/helpers.js +375 -375
  168. package/dist/formats/mp3/index.js +2 -2
  169. package/dist/formats/mp4/CjsMp4Format.js +197 -197
  170. package/dist/formats/mp4/core/helpers.js +484 -484
  171. package/dist/formats/mp4/index.js +2 -2
  172. package/dist/formats/obj/CjsObjFormat.js +253 -253
  173. package/dist/formats/obj/core/helpers.js +573 -573
  174. package/dist/formats/obj/core/json.js +64 -64
  175. package/dist/formats/obj/core/parser.js +321 -321
  176. package/dist/formats/obj/index.js +2 -2
  177. package/dist/formats/ogg/CjsOggFormat.js +143 -143
  178. package/dist/formats/ogg/core/helpers.js +410 -410
  179. package/dist/formats/ogg/core/imdct.js +178 -178
  180. package/dist/formats/ogg/core/vorbis.js +1017 -1017
  181. package/dist/formats/ogg/index.js +2 -2
  182. package/dist/formats/pickle/CjsPickleFormat.js +214 -0
  183. package/dist/formats/pickle/CjsPickleFormat.js.map +1 -0
  184. package/dist/formats/pickle/core/CjsPickleProtocol0Reader.js +551 -0
  185. package/dist/formats/pickle/core/CjsPickleProtocol0Reader.js.map +1 -0
  186. package/dist/formats/pickle/index.js +2 -0
  187. package/dist/formats/pickle/index.js.map +1 -0
  188. package/dist/formats/png/CjsPngFormat.js +201 -201
  189. package/dist/formats/png/core/helpers.js +635 -635
  190. package/dist/formats/png/index.js +2 -2
  191. package/dist/formats/red/CjsRedFormat.js +263 -263
  192. package/dist/formats/red/core/CjsRedReader.js +246 -246
  193. package/dist/formats/red/core/blackDefinitions.js +3 -3
  194. package/dist/formats/red/core/helpers.js +158 -158
  195. package/dist/formats/red/core/redGraph.js +71 -68
  196. package/dist/formats/red/core/redGraph.js.map +1 -1
  197. package/dist/formats/red/core/schema.js +4 -4
  198. package/dist/formats/red/index.js +2 -2
  199. package/dist/formats/stl/CjsStlFormat.js +365 -365
  200. package/dist/formats/stl/core/helpers.js +261 -261
  201. package/dist/formats/stl/core/json.js +51 -51
  202. package/dist/formats/stl/core/stl.js +642 -642
  203. package/dist/formats/stl/core/targets.js +173 -173
  204. package/dist/formats/stl/index.js +2 -2
  205. package/dist/formats/tga/CjsTgaFormat.js +197 -197
  206. package/dist/formats/tga/core/helpers.js +493 -493
  207. package/dist/formats/tga/index.js +2 -2
  208. package/dist/formats/wav/CjsWavFormat.js +198 -198
  209. package/dist/formats/wav/core/helpers.js +365 -365
  210. package/dist/formats/wav/index.js +2 -2
  211. package/dist/formats/webgl/CjsWebglFormat.js +199 -221
  212. package/dist/formats/webgl/CjsWebglFormat.js.map +1 -1
  213. package/dist/formats/webgl/core/buildGlslEffectContainer.js +70 -0
  214. package/dist/formats/webgl/core/buildGlslEffectContainer.js.map +1 -0
  215. package/dist/formats/webgl/core/effectPackage.js +900 -792
  216. package/dist/formats/webgl/core/effectPackage.js.map +1 -1
  217. package/dist/formats/webgl/core/errors.js +27 -27
  218. package/dist/formats/webgl/core/errors.js.map +1 -1
  219. package/dist/formats/webgl/core/glsl/DxbcGlslEmitter.js +2820 -2678
  220. package/dist/formats/webgl/core/glsl/DxbcGlslEmitter.js.map +1 -1
  221. package/dist/formats/webgl/core/glsl/DxbcGlslHelpers.js +89 -89
  222. package/dist/formats/webgl/core/glsl/DxbcGlslOperandFormatter.js +486 -428
  223. package/dist/formats/webgl/core/glsl/DxbcGlslOperandFormatter.js.map +1 -1
  224. package/dist/formats/webgl/core/glsl/packedLightFixups.js +98 -0
  225. package/dist/formats/webgl/core/glsl/packedLightFixups.js.map +1 -0
  226. package/dist/formats/webgl/core/glslBackendBlock.js +552 -0
  227. package/dist/formats/webgl/core/glslBackendBlock.js.map +1 -0
  228. package/dist/formats/webgl/core/glslBackendBodySet.js +243 -0
  229. package/dist/formats/webgl/core/glslBackendBodySet.js.map +1 -0
  230. package/dist/formats/webgl/core/{cewgCompleteness.js → glslEffectCompleteness.js} +85 -81
  231. package/dist/formats/webgl/core/glslEffectCompleteness.js.map +1 -0
  232. package/dist/formats/webgl/core/helpers.js +167 -306
  233. package/dist/formats/webgl/core/helpers.js.map +1 -1
  234. package/dist/formats/webgl/core/inspectGlslEffectContainer.js +122 -0
  235. package/dist/formats/webgl/core/inspectGlslEffectContainer.js.map +1 -0
  236. package/dist/formats/webgl/core/readGlslEffectContainer.js +303 -0
  237. package/dist/formats/webgl/core/readGlslEffectContainer.js.map +1 -0
  238. package/dist/formats/webgl/index.js +2 -2
  239. package/dist/formats/webgpu/CjsWebgpuFormat.js +357 -357
  240. package/dist/formats/webgpu/CjsWebgpuFormat.js.map +1 -1
  241. package/dist/formats/webgpu/core/buildCarbonEffectContainer.js +89 -197
  242. package/dist/formats/webgpu/core/buildCarbonEffectContainer.js.map +1 -1
  243. package/dist/formats/webgpu/core/{cewgpu/CewgpuContainer.js → carbonWebgpu/CarbonWebgpuContainer.js} +354 -368
  244. package/dist/formats/webgpu/core/carbonWebgpu/CarbonWebgpuContainer.js.map +1 -0
  245. package/dist/formats/webgpu/core/{cewgpu → carbonWebgpu}/containerViews.js +355 -355
  246. package/dist/formats/webgpu/core/carbonWebgpu/containerViews.js.map +1 -0
  247. package/dist/formats/webgpu/core/{cewgpu → carbonWebgpu}/validateContainer.js +90 -90
  248. package/dist/formats/webgpu/core/carbonWebgpu/validateContainer.js.map +1 -0
  249. package/dist/formats/webgpu/core/effectAnalysis.js +82 -82
  250. package/dist/formats/webgpu/core/effectBackendBodySet.js +289 -289
  251. package/dist/formats/webgpu/core/effectBackendBodySet.js.map +1 -1
  252. package/dist/formats/webgpu/core/errors.js +20 -20
  253. package/dist/formats/webgpu/core/errors.js.map +1 -1
  254. package/dist/formats/webgpu/core/helpers.js +443 -443
  255. package/dist/formats/webgpu/core/helpers.js.map +1 -1
  256. package/dist/formats/webgpu/core/ir/analyzeRegisterValues.js +212 -212
  257. package/dist/formats/webgpu/core/ir/buildControlFlow.js +220 -220
  258. package/dist/formats/webgpu/core/ir/indexableTemps.js +137 -137
  259. package/dist/formats/webgpu/core/ir/inferValueTypes.js +449 -449
  260. package/dist/formats/webgpu/core/ir/lowerDxbcToIr.js +494 -494
  261. package/dist/formats/webgpu/core/ir/resolveRegisterFlow.js +177 -177
  262. package/dist/formats/webgpu/core/ir/sourceLanes.js +61 -61
  263. package/dist/formats/webgpu/core/packageEffect.js +381 -385
  264. package/dist/formats/webgpu/core/packageEffect.js.map +1 -1
  265. package/dist/formats/webgpu/core/packageEffectSelection.js +164 -164
  266. package/dist/formats/webgpu/core/packageEffectSelection.js.map +1 -1
  267. package/dist/formats/webgpu/core/packageMetadata.js +17 -17
  268. package/dist/formats/webgpu/core/schema.js +4 -4
  269. package/dist/formats/webgpu/core/wgsl/buildResourceTransformPlan.js +263 -263
  270. package/dist/formats/webgpu/core/wgsl/buildResourceTransformPlan.js.map +1 -1
  271. package/dist/formats/webgpu/core/wgsl/buildWgslBindingPlan.js +172 -172
  272. package/dist/formats/webgpu/core/wgsl/buildWgslSet.js +320 -320
  273. package/dist/formats/webgpu/core/wgsl/buildWgslSet.js.map +1 -1
  274. package/dist/formats/webgpu/core/wgsl/emitWgsl.js +356 -356
  275. package/dist/formats/webgpu/core/wgsl/hoistEscapingValues.js +77 -77
  276. package/dist/formats/webgpu/core/wgsl/lowerBindingLayout.js +451 -451
  277. package/dist/formats/webgpu/core/wgsl/lowerComputeProgram.js +735 -735
  278. package/dist/formats/webgpu/core/wgsl/lowerCreateHistogramsComputeProgram.js +457 -457
  279. package/dist/formats/webgpu/core/wgsl/lowerFragmentProgram.js +1572 -1572
  280. package/dist/formats/webgpu/core/wgsl/lowerMergeHistogramsComputeProgram.js +659 -659
  281. package/dist/formats/webgpu/core/wgsl/lowerParticleClearComputePrograms.js +734 -734
  282. package/dist/formats/webgpu/core/wgsl/lowerParticleEmitComputeProgram.js +583 -583
  283. package/dist/formats/webgpu/core/wgsl/lowerSkinVerticesComputeProgram.js +621 -621
  284. package/dist/formats/webgpu/core/wgsl/lowerSortComputeProgram.js +824 -824
  285. package/dist/formats/webgpu/core/wgsl/lowerSortInnerComputeProgram.js +697 -697
  286. package/dist/formats/webgpu/core/wgsl/lowerSortStepComputeProgram.js +559 -559
  287. package/dist/formats/webgpu/core/wgsl/lowerVertexProgram.js +1328 -1328
  288. package/dist/formats/webgpu/core/wgsl/particleEmitSemanticDigest.js +110 -110
  289. package/dist/formats/webgpu/core/wgsl/precisionControls.js +55 -55
  290. package/dist/formats/webgpu/core/wgsl/selectionPlans.js +717 -717
  291. package/dist/formats/webgpu/core/wgsl/uniformity.js +78 -78
  292. package/dist/formats/webgpu/core/wgsl/validateExactComputeIr.js +196 -196
  293. package/dist/formats/webgpu/core/wgsl/validateHandleOperand.js +37 -37
  294. package/dist/formats/webgpu/index.js +2 -2
  295. package/dist/formats/webm/CjsWebmFormat.js +197 -197
  296. package/dist/formats/webm/core/helpers.js +572 -572
  297. package/dist/formats/webm/index.js +2 -2
  298. package/dist/formats/webp/CjsWebpFormat.js +140 -140
  299. package/dist/formats/webp/core/helpers.js +237 -237
  300. package/dist/formats/webp/index.js +2 -2
  301. package/dist/formats/wem/CjsWemFormat.js +250 -250
  302. package/dist/formats/wem/core/bitStream.js +261 -261
  303. package/dist/formats/wem/core/codebookLibrary.js +164 -164
  304. package/dist/formats/wem/core/helpers.js +437 -437
  305. package/dist/formats/wem/core/packedCodebooksAotuv603.js +30 -30
  306. package/dist/formats/wem/core/ptadpcm.js +77 -77
  307. package/dist/formats/wem/core/resolve.js +121 -121
  308. package/dist/formats/wem/core/wemToOgg.js +485 -485
  309. package/dist/formats/wem/index.js +2 -2
  310. package/dist/formats/yaml/CjsYamlFormat.js +134 -134
  311. package/dist/formats/yaml/CjsYamlFormat.js.map +1 -1
  312. package/dist/formats/yaml/core/CjsYamlReader.js +400 -402
  313. package/dist/formats/yaml/core/CjsYamlReader.js.map +1 -1
  314. package/dist/formats/yaml/core/helpers.js +196 -170
  315. package/dist/formats/yaml/core/helpers.js.map +1 -1
  316. package/dist/formats/yaml/index.js +2 -2
  317. package/dist/index.js +64 -62
  318. package/dist/index.js.map +1 -1
  319. package/dist/resource/CjsLoadingObject.js +19 -0
  320. package/dist/resource/CjsLoadingObject.js.map +1 -0
  321. package/dist/resource/CjsResource.js +801 -797
  322. package/dist/resource/CjsResource.js.map +1 -1
  323. package/dist/resource/ResourceHandlerMode.js +14 -0
  324. package/dist/resource/ResourceHandlerMode.js.map +1 -0
  325. package/dist/resource/Tr2LightProfileRes.js +32 -32
  326. package/dist/resource/audio/AudioGeometryResData.js +47 -47
  327. package/dist/resource/audio/CjsAudioBufferRes.js +86 -86
  328. package/dist/resource/audio/CjsAudioRes.js +213 -213
  329. package/dist/resource/audio/index.js +4 -4
  330. package/dist/resource/geometry/MeshDecalData.js +37 -37
  331. package/dist/resource/geometry/MeshDecalLodData.js +34 -34
  332. package/dist/resource/geometry/TriGeometryRes.js +675 -675
  333. package/dist/resource/geometry/TriGeometryResAreaData.js +59 -59
  334. package/dist/resource/geometry/TriGeometryResJointData.js +38 -38
  335. package/dist/resource/geometry/TriGeometryResLodData.js +88 -88
  336. package/dist/resource/geometry/TriGeometryResMeshData.js +63 -63
  337. package/dist/resource/geometry/TriGeometryResSkeletonData.js +34 -34
  338. package/dist/resource/geometry/TriJointBinding.js +38 -38
  339. package/dist/resource/geometry/TriMorphTargetGeometryConstants.js +46 -46
  340. package/dist/resource/geometry/TriRtGeometryConstants.js +88 -88
  341. package/dist/resource/geometry/granny/GStateBindingCallbackData.js +31 -31
  342. package/dist/resource/geometry/granny/Tr2GrannyIntersectionResult.js +60 -60
  343. package/dist/resource/geometry/granny/Tr2GrannyStateRes.js +36 -36
  344. package/dist/resource/geometry/granny/TriGrannyRes.js +35 -35
  345. package/dist/resource/geometry/granny/enums.js +10 -10
  346. package/dist/resource/geometry/granny/index.js +6 -6
  347. package/dist/resource/geometry/index.js +17 -17
  348. package/dist/resource/index.js +54 -52
  349. package/dist/resource/index.js.map +1 -1
  350. package/dist/resource/resourceBoundary.js +64 -64
  351. package/dist/resource/shader/Tr2EffectRes.js +336 -431
  352. package/dist/resource/shader/Tr2EffectRes.js.map +1 -1
  353. package/dist/resource/shader/Tr2MaterialArea.js +31 -31
  354. package/dist/resource/shader/Tr2MaterialMesh.js +27 -27
  355. package/dist/resource/shader/Tr2MaterialRes.js +31 -31
  356. package/dist/resource/shader/Tr2Shader.js +283 -261
  357. package/dist/resource/shader/Tr2Shader.js.map +1 -1
  358. package/dist/resource/shader/Tr2ShaderPermutation.js +43 -43
  359. package/dist/resource/shader/index.js +17 -17
  360. package/dist/resource/shader/reflection/Tr2EffectConstant.js +143 -135
  361. package/dist/resource/shader/reflection/Tr2EffectConstant.js.map +1 -1
  362. package/dist/resource/shader/reflection/Tr2EffectDefine.js +30 -30
  363. package/dist/resource/shader/reflection/Tr2EffectDescription.js +114 -109
  364. package/dist/resource/shader/reflection/Tr2EffectDescription.js.map +1 -1
  365. package/dist/resource/shader/reflection/Tr2EffectLibrary.js +168 -147
  366. package/dist/resource/shader/reflection/Tr2EffectLibrary.js.map +1 -1
  367. package/dist/resource/shader/reflection/Tr2EffectParameterAnnotation.js +125 -105
  368. package/dist/resource/shader/reflection/Tr2EffectParameterAnnotation.js.map +1 -1
  369. package/dist/resource/shader/reflection/Tr2EffectResource.js +120 -86
  370. package/dist/resource/shader/reflection/Tr2EffectResource.js.map +1 -1
  371. package/dist/resource/shader/reflection/Tr2EffectStageInput.js +372 -241
  372. package/dist/resource/shader/reflection/Tr2EffectStageInput.js.map +1 -1
  373. package/dist/resource/shader/reflection/Tr2EffectTechnique.js +78 -68
  374. package/dist/resource/shader/reflection/Tr2EffectTechnique.js.map +1 -1
  375. package/dist/resource/shader/reflection/Tr2Pass.js +168 -111
  376. package/dist/resource/shader/reflection/Tr2Pass.js.map +1 -1
  377. package/dist/resource/shader/reflection/carbonRecordFields.js +159 -0
  378. package/dist/resource/shader/reflection/carbonRecordFields.js.map +1 -0
  379. package/dist/resource/shader/reflection/shaderStage.js +22 -0
  380. package/dist/resource/shader/reflection/shaderStage.js.map +1 -0
  381. package/dist/resource/shader/sampler/Tr2SamplerSetup.js +135 -77
  382. package/dist/resource/shader/sampler/Tr2SamplerSetup.js.map +1 -1
  383. package/dist/resource/texture/CjsTextureArrayRes.js +472 -472
  384. package/dist/resource/texture/CjsTextureArrayResParameterProxy.js +179 -179
  385. package/dist/resource/texture/Tr2ImageRes.js +120 -120
  386. package/dist/resource/texture/Tr2TextureLodManager.js +82 -82
  387. package/dist/resource/texture/Tr2TextureLodUpdateRequest.js +37 -37
  388. package/dist/resource/texture/Tr2TexturePackChannel.js +37 -37
  389. package/dist/resource/texture/Tr2TexturePipeline.js +54 -54
  390. package/dist/resource/texture/Tr2TexturePipelineParams.js +34 -34
  391. package/dist/resource/texture/Tr2TexturePipelineStepCompress.js +40 -40
  392. package/dist/resource/texture/Tr2TexturePipelineStepGenerateMips.js +22 -22
  393. package/dist/resource/texture/Tr2TexturePipelineStepLimitSize.js +34 -34
  394. package/dist/resource/texture/Tr2TexturePipelineStepLoad.js +31 -31
  395. package/dist/resource/texture/Tr2TexturePipelineStepPack.js +43 -43
  396. package/dist/resource/texture/TriTextureRes.js +359 -359
  397. package/dist/resource/texture/index.js +15 -15
  398. package/dist/resource/texture/texturePipelineBehavior.js +308 -308
  399. package/dist/worker/CjsResManMainThreadLoader.js +89 -87
  400. package/dist/worker/CjsResManMainThreadLoader.js.map +1 -1
  401. package/dist/worker/CjsResManWorker.js +218 -217
  402. package/dist/worker/CjsResManWorker.js.map +1 -1
  403. package/dist/worker/CjsResManWorkerLoader.js +437 -434
  404. package/dist/worker/CjsResManWorkerLoader.js.map +1 -1
  405. package/dist/worker/protocol.js +12 -12
  406. package/docs/README.md +98 -98
  407. package/docs/architecture.md +118 -109
  408. package/docs/concepts/resource-lifecycle.md +226 -225
  409. package/docs/concepts/shader-resource-model.md +111 -114
  410. package/docs/concepts/writing-an-engine-adapter.md +115 -115
  411. package/docs/formats/README.md +138 -136
  412. package/docs/formats/carbon-effect-container.md +553 -452
  413. package/docs/formats/dxbc/README.md +68 -68
  414. package/docs/formats/dxbc/architecture.md +80 -80
  415. package/docs/formats/dxbc/reference/api.md +77 -77
  416. package/docs/formats/dxbc/reference/classes/README.md +9 -9
  417. package/docs/formats/dxbc/reference/decoded-output.md +122 -122
  418. package/docs/formats/gr2.md +160 -160
  419. package/docs/formats/hlsl/README.md +54 -54
  420. package/docs/formats/hlsl/architecture.md +65 -67
  421. package/docs/formats/hlsl/guides/hydrating-json-output.md +60 -62
  422. package/docs/formats/hlsl/guides/reading-effects.md +64 -64
  423. package/docs/formats/hlsl/reference/advanced-analysis.md +61 -66
  424. package/docs/formats/hlsl/reference/api.md +92 -98
  425. package/docs/formats/hlsl/reference/classes/README.md +11 -11
  426. package/docs/formats/hlsl/reference/json-graph.md +97 -100
  427. package/docs/formats/pickle.md +82 -0
  428. package/docs/formats/provenance.md +196 -196
  429. package/docs/formats/stl.md +37 -37
  430. package/docs/formats/webgl/README.md +115 -57
  431. package/docs/formats/webgl/architecture.md +69 -70
  432. package/docs/formats/webgl/carbon-constant-layouts.md +326 -326
  433. package/docs/formats/webgl/decl-io.md +1234 -1234
  434. package/docs/formats/webgl/memory-structured.md +890 -871
  435. package/docs/formats/webgl/reference/classes/README.md +9 -9
  436. package/docs/formats/webgl/texture-sample.md +964 -964
  437. package/docs/formats/webgpu/README.md +84 -84
  438. package/docs/formats/webgpu/architecture.md +95 -96
  439. package/docs/formats/webgpu/formats/{cewgpu.md → carbon-webgpu.md} +215 -216
  440. package/docs/formats/webgpu/guides/effect-packaging.md +189 -191
  441. package/docs/formats/webgpu/reference/api.md +196 -197
  442. package/docs/formats/webgpu/reference/classes/README.md +9 -9
  443. package/docs/formats/webgpu/reference/wgsl-compatibility.md +1546 -1543
  444. package/docs/formats/wwise.md +146 -85
  445. package/docs/reference/classes/README.md +35 -35
  446. package/docs/reference/classes/audio.md +30 -30
  447. package/docs/reference/classes/core.md +216 -206
  448. package/docs/reference/classes/dropped.md +46 -46
  449. package/docs/reference/classes/formats.md +944 -952
  450. package/docs/reference/classes/resources.md +456 -456
  451. package/docs/reference/classes/texture.md +26 -26
  452. package/docs/reference/events.md +117 -117
  453. package/docs/reference/motherlode-cache.md +275 -275
  454. package/docs/reference/queues.md +194 -110
  455. package/docs/reference/reload.md +107 -107
  456. package/docs/reference/texture-arrays.md +113 -113
  457. package/docs/reference/texture-pipeline.md +53 -53
  458. package/docs/reference/workers.md +142 -135
  459. package/docs/roadmap.md +150 -150
  460. package/format-notices/black/LICENSE +21 -21
  461. package/format-notices/black/NOTICE +47 -47
  462. package/format-notices/bnk/LICENSE +21 -21
  463. package/format-notices/bnk/NOTICE +21 -21
  464. package/format-notices/cmf/LICENSE +21 -21
  465. package/format-notices/cmf/NOTICE +36 -36
  466. package/format-notices/dds/LICENSE +21 -21
  467. package/format-notices/dds/NOTICE +14 -14
  468. package/format-notices/dxbc/LICENSE +21 -21
  469. package/format-notices/dxbc/NOTICE +20 -20
  470. package/format-notices/fbx/LICENSE +21 -21
  471. package/format-notices/fbx/NOTICE +14 -14
  472. package/format-notices/flac/LICENSE +21 -21
  473. package/format-notices/flac/NOTICE +14 -14
  474. package/format-notices/gif/LICENSE +21 -21
  475. package/format-notices/gif/NOTICE +14 -14
  476. package/format-notices/gltf/LICENSE +21 -21
  477. package/format-notices/gltf/NOTICE +27 -27
  478. package/format-notices/gr2/LICENSE +21 -21
  479. package/format-notices/gr2/NOTICE +60 -60
  480. package/format-notices/gr2/THIRD-PARTY-NOTICES.md +93 -93
  481. package/format-notices/hlsl/LICENSE +21 -21
  482. package/format-notices/hlsl/NOTICE +25 -25
  483. package/format-notices/jpeg/LICENSE +21 -21
  484. package/format-notices/jpeg/NOTICE +14 -14
  485. package/format-notices/mp3/LICENSE +21 -21
  486. package/format-notices/mp3/NOTICE +14 -14
  487. package/format-notices/mp4/LICENSE +21 -21
  488. package/format-notices/mp4/NOTICE +14 -14
  489. package/format-notices/obj/LICENSE +21 -21
  490. package/format-notices/obj/NOTICE +26 -26
  491. package/format-notices/ogg/LICENSE +21 -21
  492. package/format-notices/ogg/NOTICE +28 -28
  493. package/format-notices/png/LICENSE +21 -21
  494. package/format-notices/png/NOTICE +14 -14
  495. package/format-notices/red/LICENSE +21 -21
  496. package/format-notices/red/NOTICE +31 -31
  497. package/format-notices/stl/LICENSE +21 -21
  498. package/format-notices/stl/NOTICE +21 -21
  499. package/format-notices/tga/LICENSE +21 -21
  500. package/format-notices/tga/NOTICE +14 -14
  501. package/format-notices/wav/LICENSE +21 -21
  502. package/format-notices/wav/NOTICE +14 -14
  503. package/format-notices/webgl/LICENSE +21 -21
  504. package/format-notices/webgl/NOTICE +35 -35
  505. package/format-notices/webgpu/LICENSE +21 -21
  506. package/format-notices/webgpu/NOTICE +31 -31
  507. package/format-notices/webm/LICENSE +21 -21
  508. package/format-notices/webm/NOTICE +14 -14
  509. package/format-notices/webp/LICENSE +21 -21
  510. package/format-notices/webp/NOTICE +14 -14
  511. package/format-notices/wem/LICENSE +57 -57
  512. package/format-notices/wem/NOTICE +33 -33
  513. package/format-notices/yaml/LICENSE +21 -21
  514. package/format-notices/yaml/NOTICE +44 -44
  515. package/package.json +63 -63
  516. package/dist/format/carbonEffect/carbonDescriptionFromPortable.js +0 -372
  517. package/dist/format/carbonEffect/carbonDescriptionFromPortable.js.map +0 -1
  518. package/dist/format/effect/effectReflectionPackage.js +0 -636
  519. package/dist/format/effect/effectReflectionPackage.js.map +0 -1
  520. package/dist/formats/hlsl/core/HlslReader.js +0 -16
  521. package/dist/formats/hlsl/core/HlslReader.js.map +0 -1
  522. package/dist/formats/hlsl/core/portableReflection.js +0 -848
  523. package/dist/formats/hlsl/core/portableReflection.js.map +0 -1
  524. package/dist/formats/hlsl/portable.js +0 -2
  525. package/dist/formats/hlsl/portable.js.map +0 -1
  526. package/dist/formats/webgl/core/cewg/CewgPackage.js +0 -340
  527. package/dist/formats/webgl/core/cewg/CewgPackage.js.map +0 -1
  528. package/dist/formats/webgl/core/cewg/CewgPackageBuilder.js +0 -104
  529. package/dist/formats/webgl/core/cewg/CewgPackageBuilder.js.map +0 -1
  530. package/dist/formats/webgl/core/cewg/binary.js +0 -19
  531. package/dist/formats/webgl/core/cewg/binary.js.map +0 -1
  532. package/dist/formats/webgl/core/cewgCompleteness.js.map +0 -1
  533. package/dist/formats/webgl/core/effectPackageValidation.js +0 -331
  534. package/dist/formats/webgl/core/effectPackageValidation.js.map +0 -1
  535. package/dist/formats/webgpu/core/cewgpu/CewgpuContainer.js.map +0 -1
  536. package/dist/formats/webgpu/core/cewgpu/containerViews.js.map +0 -1
  537. package/dist/formats/webgpu/core/cewgpu/validateContainer.js.map +0 -1
  538. package/dist/resource/shader/portable.js +0 -33
  539. package/dist/resource/shader/portable.js.map +0 -1
  540. package/docs/formats/hlsl/reference/portable-reflection.md +0 -141
  541. package/docs/formats/webgl/effect-reflection.md +0 -127
@@ -1,241 +1,372 @@
1
- import { CjsSchema, impl, type } from '@carbonenginejs/runtime-utils/schema';
2
- import { CjsModel } from '@carbonenginejs/runtime-utils/model';
3
- import { copyBytes } from '@carbonenginejs/runtime-utils/bytes';
4
- import { isPlainObject, isArray, isUint32 } from '@carbonenginejs/runtime-utils/is';
5
- import { cloneCarbonValue } from '@carbonenginejs/runtime-utils/types';
6
- import { requirePortableStageType, clonePortableSourceProgram } from '../portable.js';
7
- import { validateEffectBodyInput } from '../../../formats/hlsl/core/portableReflection.js';
8
- import { Tr2SamplerSetup } from '../sampler/Tr2SamplerSetup.js';
9
- import { Tr2EffectConstant } from './Tr2EffectConstant.js';
10
- import { Tr2EffectParameterAnnotation } from './Tr2EffectParameterAnnotation.js';
11
- import { Tr2EffectResource } from './Tr2EffectResource.js';
12
-
13
- // Source: trinity/trinity/Shader/Tr2EffectDescription.h
14
- // Source: trinity/trinity/Shader/Tr2EffectDescription.cpp
15
-
16
- /** Complete device-free reflection for one shader stage input. */
17
- class Tr2EffectStageInput extends CjsModel {
18
- /** Portable stage index; Carbon otherwise implies this from the containing array. */
19
- stageType = -1;
20
-
21
- /** m_exists (bool) */
22
- exists = false;
23
-
24
- /** resources (Tr2EffectResourceMap) */
25
- resources = new Map();
26
-
27
- /** uavs (Tr2EffectResourceMap) */
28
- uavs = new Map();
29
-
30
- /** samplers (Tr2SamplerSetupMap) */
31
- samplers = new Map();
32
-
33
- /** m_shader (unsigned) */
34
- shader = 0xffffffff;
35
-
36
- /** constants (Tr2EffectConstantVector) */
37
- constants = [];
38
-
39
- /** m_constantValueSize (unsigned) */
40
- constantValueSize = 0;
41
-
42
- /** constantValues (char[SHADER_CONSTANTS_MAX]) */
43
- constantValues = new Uint8Array(0);
44
-
45
- /** signature (Tr2ShaderSignatureAL) */
46
- signature = null;
47
-
48
- /** annotation (Tr2EffectParameterAnnotationMap) */
49
- annotation = [];
50
-
51
- /** Exact source program metadata and owned bytes, before backend realization. */
52
- sourceProgram = null;
53
-
54
- /**
55
- * Construct one canonical stage input from JS/JSON model values.
56
- *
57
- * @param {object} values Canonical model values.
58
- * @param {object} options CjsModel import options.
59
- * @returns {Tr2EffectStageInput} Hydrated stage input.
60
- */
61
- static from(values = {}, options = {}) {
62
- let normalized = values;
63
- const maps = new Map();
64
- for (const [field, Constructor] of [["resources", Tr2EffectResource], ["uavs", Tr2EffectResource], ["samplers", Tr2SamplerSetup]]) {
65
- if (values && Object.hasOwn(values, field)) {
66
- normalized = normalized === values ? {
67
- ...values
68
- } : normalized;
69
- normalized[field] = this.readCanonicalRegisterMap(values[field], Constructor, options, field);
70
- maps.set(field, normalized[field]);
71
- }
72
- }
73
- const stage = super.from(normalized, options);
74
- for (const [field, value] of maps) {
75
- stage[field] = value;
76
- }
77
- return stage;
78
- }
79
-
80
- /**
81
- * Build one stage input from its complete portable JSON stage record.
82
- *
83
- * @param {object} value Portable stage record.
84
- * @returns {Tr2EffectStageInput} Reflected stage input.
85
- */
86
- static fromPortable(value) {
87
- if (!isPlainObject(value)) {
88
- throw new TypeError("Portable effect stage must be an object");
89
- }
90
- const stageType = requirePortableStageType(value.stageType);
91
- return this.fromPortableInput(value.input, stageType, value.sourceProgram);
92
- }
93
-
94
- /**
95
- * Build one input record used by a render stage or shader library.
96
- *
97
- * @param {object} value Portable input record.
98
- * @param {number} stageType Stage index, or -1 for a library input.
99
- * @param {object|null} sourceProgram Optional stage source program.
100
- * @returns {Tr2EffectStageInput} Reflected input.
101
- */
102
- static fromPortableInput(value, stageType = -1, sourceProgram = null) {
103
- if (!isPlainObject(value)) {
104
- throw new TypeError("Portable effect stage input must be an object");
105
- }
106
- validateEffectBodyInput(value);
107
- if (!isArray(value.constants)) {
108
- throw new TypeError("Portable effect constants must be an array");
109
- }
110
- if (!isArray(value.resources)) {
111
- throw new TypeError("Portable effect resources must be an array");
112
- }
113
- if (!isArray(value.uavs)) {
114
- throw new TypeError("Portable effect UAVs must be an array");
115
- }
116
- if (!isArray(value.samplers)) {
117
- throw new TypeError("Portable effect samplers must be an array");
118
- }
119
- if (!isArray(value.annotations)) {
120
- throw new TypeError("Portable effect stage annotations must be an array");
121
- }
122
- if (!isPlainObject(value.constantDefaults)) {
123
- throw new TypeError("Portable effect constant defaults must be an object");
124
- }
125
- if (!(value.constantDefaults.bytes instanceof Uint8Array)) {
126
- throw new TypeError("Portable effect constant defaults must be Uint8Array bytes");
127
- }
128
- const defaults = value.constantDefaults;
129
- const constantValues = copyBytes(defaults.bytes);
130
- if (defaults.declaredByteLength !== constantValues.byteLength) {
131
- throw new Error("Portable effect constant defaults disagree with their declared byte length");
132
- }
133
- const input = new this();
134
- input.stageType = stageType;
135
- input.exists = true;
136
- input.constants = value.constants.map(entry => Tr2EffectConstant.fromPortable(entry));
137
- input.resources = this.readPortableResourceMap(value.resources);
138
- input.uavs = this.readPortableResourceMap(value.uavs);
139
- input.samplers = this.readPortableSamplerMap(value.samplers);
140
- input.constantValueSize = constantValues.byteLength;
141
- input.constantValues = constantValues;
142
- input.signature = cloneCarbonValue(value.signature);
143
- input.annotation = value.annotations.map(entry => Tr2EffectParameterAnnotation.fromPortable(entry));
144
- input.sourceProgram = sourceProgram ? clonePortableSourceProgram(sourceProgram, "stage") : null;
145
- return input;
146
- }
147
-
148
- /**
149
- * Create one explicit absent stage slot.
150
- *
151
- * @param {number} stageType Stage index.
152
- * @returns {Tr2EffectStageInput} Empty stage input.
153
- */
154
- static createEmpty(stageType) {
155
- const stage = new this();
156
- stage.stageType = requirePortableStageType(stageType);
157
- return stage;
158
- }
159
-
160
- /** Build one register-indexed portable resource map. */
161
- static readPortableResourceMap(values) {
162
- const result = new Map();
163
- for (const value of values) {
164
- if (!isPlainObject(value)) {
165
- throw new TypeError("Portable effect resource must be an object");
166
- }
167
- if (!isUint32(value.registerIndex)) {
168
- throw new RangeError("Portable resource register index must fit uint32");
169
- }
170
- const registerIndex = value.registerIndex;
171
- if (result.has(registerIndex)) {
172
- throw new Error(`Portable effect resource register ${registerIndex} is duplicated`);
173
- }
174
- result.set(registerIndex, Tr2EffectResource.fromPortable(value));
175
- }
176
- return result;
177
- }
178
-
179
- /** Build one register-indexed portable sampler map. */
180
- static readPortableSamplerMap(values) {
181
- const result = new Map();
182
- for (const value of values) {
183
- if (!isPlainObject(value)) {
184
- throw new TypeError("Portable effect sampler must be an object");
185
- }
186
- if (!isUint32(value.registerIndex)) {
187
- throw new RangeError("Portable sampler register index must fit uint32");
188
- }
189
- const registerIndex = value.registerIndex;
190
- if (result.has(registerIndex)) {
191
- throw new Error(`Portable effect sampler register ${registerIndex} is duplicated`);
192
- }
193
- result.set(registerIndex, Tr2SamplerSetup.fromPortable(value));
194
- }
195
- return result;
196
- }
197
-
198
- /** Hydrate one numeric-register map from canonical JS/JSON values. */
199
- static readCanonicalRegisterMap(values, Constructor, options, field) {
200
- const entries = values instanceof Map ? values : Object.entries(values ?? {});
201
- const result = new Map();
202
- for (const [key, value] of entries) {
203
- const registerIndex = Number(key);
204
- if (!isUint32(registerIndex)) {
205
- throw new RangeError(`Effect ${field} register index must fit uint32`);
206
- }
207
- if (result.has(registerIndex)) {
208
- throw new Error(`Effect ${field} register ${registerIndex} is duplicated`);
209
- }
210
- result.set(registerIndex, value instanceof Constructor ? value : Constructor.from(value, options));
211
- }
212
- return result;
213
- }
214
- }
215
-
216
- // Declared imperatively rather than with decorators, so this module stays
217
- // plain ESM that loads from source without a transform. The decorator
218
- // expressions are reused verbatim, so the registered metadata is identical.
219
- // Statics belong in `methods`: decorateMethod targets the prototype and
220
- // would register a static as an instance field.
221
- CjsSchema.define(Tr2EffectStageInput, {
222
- className: "Tr2EffectStageInput",
223
- family: "shader",
224
- fields: {
225
- stageType: [impl.adapted, impl.reason("The source format identifies stage inputs by array index; the device-free graph retains the index explicitly for serialization and engine adapters."), type.int32],
226
- exists: type.boolean,
227
- resources: type.map("Tr2EffectResource"),
228
- uavs: type.map("Tr2EffectResource"),
229
- samplers: type.map("Tr2SamplerSetup"),
230
- shader: type.uint32,
231
- constants: type.list("Tr2EffectConstant"),
232
- constantValueSize: type.uint32,
233
- constantValues: type.typedArray("Uint8Array"),
234
- signature: type.rawStruct("Tr2ShaderSignatureAL"),
235
- annotation: type.list("Tr2EffectParameterAnnotation"),
236
- sourceProgram: [impl.adapted, impl.reason("Carbon replaces source program data with renderer handles while reading; the device-free resource graph must retain the portable source program for later engine realization."), type.rawStruct("CjsEffectSourceProgram")]
237
- }
238
- });
239
-
240
- export { Tr2EffectStageInput };
241
- //# sourceMappingURL=Tr2EffectStageInput.js.map
1
+ import { CjsSchema, impl, type } from '@carbonenginejs/runtime-utils/schema';
2
+ import { CjsModel } from '@carbonenginejs/runtime-utils/model';
3
+ import { copyBytes } from '@carbonenginejs/runtime-utils/bytes';
4
+ import { isPlainObject, isUint32 } from '@carbonenginejs/runtime-utils/is';
5
+ import { Tr2SamplerSetup } from '../sampler/Tr2SamplerSetup.js';
6
+ import { Tr2EffectConstant } from './Tr2EffectConstant.js';
7
+ import { Tr2EffectParameterAnnotation } from './Tr2EffectParameterAnnotation.js';
8
+ import { Tr2EffectResource } from './Tr2EffectResource.js';
9
+ import { recordBytes, recordRawBits, toRecordBlob, toRecordFloat } from './carbonRecordFields.js';
10
+ import { compareUtf8 } from '../../../format/compareUtf8.js';
11
+ import { requireShaderStageType } from './shaderStage.js';
12
+
13
+ // Source: trinity/trinity/Shader/Tr2EffectDescription.h
14
+ // Source: trinity/trinity/Shader/Tr2EffectDescription.cpp
15
+
16
+ /**
17
+ * The offset word a zero-size blob carries, or the null sentinel.
18
+ *
19
+ * @param {{size:number,offset:number}} ref Blob reference.
20
+ * @returns {number} Offset word worth retaining.
21
+ */
22
+ function unsetOffsetOf(ref) {
23
+ return ref.size === 0 ? ref.offset : 0xffffffff;
24
+ }
25
+
26
+ /** Complete device-free reflection for one shader stage input. */
27
+ class Tr2EffectStageInput extends CjsModel {
28
+ /** Portable stage index; Carbon otherwise implies this from the containing array. */
29
+ stageType = -1;
30
+
31
+ /** m_exists (bool) */
32
+ exists = false;
33
+
34
+ /** resources (Tr2EffectResourceMap) */
35
+ resources = new Map();
36
+
37
+ /** uavs (Tr2EffectResourceMap) */
38
+ uavs = new Map();
39
+
40
+ /** samplers (Tr2SamplerSetupMap) */
41
+ samplers = new Map();
42
+
43
+ /** m_shader (unsigned) */
44
+ shader = 0xffffffff;
45
+
46
+ /** constants (Tr2EffectConstantVector) */
47
+ constants = [];
48
+
49
+ /** m_constantValueSize (unsigned) */
50
+ constantValueSize = 0;
51
+
52
+ /** constantValues (char[SHADER_CONSTANTS_MAX]) */
53
+ constantValues = new Uint8Array(0);
54
+
55
+ /** signature (Tr2ShaderSignatureAL) */
56
+ signature = null;
57
+
58
+ /** annotation (Tr2EffectParameterAnnotationMap) */
59
+ annotation = [];
60
+
61
+ /** Exact source program metadata and owned bytes, before backend realization. */
62
+ sourceProgram = null;
63
+
64
+ /**
65
+ * Construct one canonical stage input from JS/JSON model values.
66
+ *
67
+ * @param {object} values Canonical model values.
68
+ * @param {object} options CjsModel import options.
69
+ * @returns {Tr2EffectStageInput} Hydrated stage input.
70
+ */
71
+ static from(values = {}, options = {}) {
72
+ let normalized = values;
73
+ const maps = new Map();
74
+ for (const [field, Constructor] of [["resources", Tr2EffectResource], ["uavs", Tr2EffectResource], ["samplers", Tr2SamplerSetup]]) {
75
+ if (values && Object.hasOwn(values, field)) {
76
+ normalized = normalized === values ? {
77
+ ...values
78
+ } : normalized;
79
+ normalized[field] = this.readCanonicalRegisterMap(values[field], Constructor, options, field);
80
+ maps.set(field, normalized[field]);
81
+ }
82
+ }
83
+ const stage = super.from(normalized, options);
84
+ for (const [field, value] of maps) {
85
+ stage[field] = value;
86
+ }
87
+ return stage;
88
+ }
89
+
90
+ /**
91
+ * Hydrate one canonical stage input from a decoded Carbon binary record.
92
+ *
93
+ * @param {object} record Decoded Carbon stage record.
94
+ * @returns {Tr2EffectStageInput} Hydrated canonical stage input.
95
+ */
96
+ static fromCarbonBinary(record) {
97
+ if (!isPlainObject(record)) {
98
+ throw new TypeError("Carbon effect stage record must be an object");
99
+ }
100
+ const input = this.fromCarbonBinaryInput(record, record.type);
101
+ input.signature.pipelineInputCount = record.pipelineInputs.length;
102
+ input.signature.pipelineInputs = record.pipelineInputs.map(entry => ({
103
+ usage: entry.usage,
104
+ registerIndex: entry.registerIndex,
105
+ usageIndex: entry.usageIndex,
106
+ usedMask: entry.usedMask,
107
+ type: entry.type,
108
+ dimension: entry.dimension
109
+ }));
110
+ input.signature.threadGroupSize = {
111
+ x: record.threadGroupSize[0],
112
+ y: record.threadGroupSize[1],
113
+ z: record.threadGroupSize[2]
114
+ };
115
+ input.sourceProgram = {
116
+ kind: "stage",
117
+ bytes: copyBytes(recordBytes(record.shaderData)),
118
+ shaderSize: record.shaderData.size,
119
+ // Meaningful only at size zero, where the writer passes the word through
120
+ // rather than interning. At any other size it is a live arena offset that
121
+ // belongs to the container it was read from, so it is not retained.
122
+ unsetOffset: unsetOffsetOf(record.shaderData)
123
+ };
124
+ return input;
125
+ }
126
+
127
+ /**
128
+ * Build one stage input from a Carbon v15 `StageData` block.
129
+ *
130
+ * A raytracing library's global and local inputs are the same block without a
131
+ * stage wrapper no stage type, no pipeline inputs, no thread group, no
132
+ * program of their own — so this is the half both callers share and
133
+ * `fromCarbonBinary` is the stage-only remainder layered on top.
134
+ *
135
+ * Carbon writes textures, samplers and UAVs in ascending register order because
136
+ * they are `std::map`s, and they are re-keyed by register here rather than by
137
+ * position, so the map is authoritative and the record's order is not load
138
+ * bearing.
139
+ *
140
+ * @param {object} record Carbon stage-data record.
141
+ * @param {number} [stageType] Stage index, or -1 for a library input.
142
+ * @returns {Tr2EffectStageInput} Reflected stage input.
143
+ */
144
+ static fromCarbonBinaryInput(record, stageType = -1) {
145
+ if (!isPlainObject(record)) {
146
+ throw new TypeError("Carbon effect stage-data record must be an object");
147
+ }
148
+ const constantValues = copyBytes(recordBytes(record.defaultValues));
149
+ const input = new this();
150
+ input.stageType = stageType;
151
+ input.exists = true;
152
+ input.constants = record.constants.map(entry => Tr2EffectConstant.fromCarbonBinary(entry));
153
+ input.resources = this.readCarbonBinaryResourceMap(record.textures);
154
+ input.uavs = this.readCarbonBinaryResourceMap(record.uavs);
155
+ input.samplers = this.readCarbonBinarySamplerMap(record.samplers);
156
+ input.constantValueSize = constantValues.byteLength;
157
+ input.constantValues = constantValues;
158
+ input.constantValuesUnsetOffset = unsetOffsetOf(record.defaultValues);
159
+ input.annotation = record.annotations.map(entry => Tr2EffectParameterAnnotation.fromCarbonBinary(entry));
160
+ input.signature = {
161
+ pipelineInputCount: 0,
162
+ pipelineInputs: [],
163
+ registerCount: record.registers.length,
164
+ // Carbon stores one field its reader calls `arrayCount` and its writer
165
+ // calls `registerCount`. Both names are carried forward from the single
166
+ // stored value, because the write direction refuses to emit a record whose
167
+ // two names disagree.
168
+ registers: record.registers.map(entry => ({
169
+ registerType: entry.registerType,
170
+ registerIndex: entry.registerIndex,
171
+ arrayCount: entry.registerCount,
172
+ registerCount: entry.registerCount,
173
+ registerSpace: entry.registerSpace
174
+ })),
175
+ staticSamplerCount: record.staticSamplers.length,
176
+ staticSamplers: record.staticSamplers.map(entry => ({
177
+ registerIndex: entry.registerIndex,
178
+ registerSpace: entry.registerSpace,
179
+ descriptor: {
180
+ comparison: !!entry.comparison,
181
+ minFilter: entry.minFilter,
182
+ magFilter: entry.magFilter,
183
+ mipFilter: entry.mipFilter,
184
+ addressU: entry.addressU,
185
+ addressV: entry.addressV,
186
+ addressW: entry.addressW,
187
+ mipLODBiasRaw: recordRawBits(entry.mipLODBias),
188
+ maxAnisotropy: entry.maxAnisotropy,
189
+ comparisonFunc: entry.comparisonFunc,
190
+ // A static sampler's border colour is a one-byte enum, not four
191
+ // floats. Sharing the dynamic sampler's mapping here would silently
192
+ // reinterpret it.
193
+ borderColor: entry.borderColor,
194
+ minLODRaw: recordRawBits(entry.minLOD),
195
+ maxLODRaw: recordRawBits(entry.maxLOD)
196
+ }
197
+ })),
198
+ threadGroupSize: {
199
+ x: 0,
200
+ y: 0,
201
+ z: 0
202
+ }
203
+ };
204
+ input.sourceProgram = null;
205
+ return input;
206
+ }
207
+
208
+ /**
209
+ * Emit this stage as a Carbon v15 stage record.
210
+ *
211
+ * @returns {object} Carbon stage record.
212
+ */
213
+ toCarbonBinary() {
214
+ const signature = this.signature ?? {};
215
+ const program = this.sourceProgram ?? {};
216
+ return {
217
+ type: this.stageType,
218
+ shaderData: toRecordBlob(program.bytes, program.shaderSize, program.unsetOffset),
219
+ threadGroupSize: [signature.threadGroupSize?.x ?? 0, signature.threadGroupSize?.y ?? 0, signature.threadGroupSize?.z ?? 0],
220
+ pipelineInputs: (signature.pipelineInputs ?? []).map(entry => ({
221
+ usage: entry.usage,
222
+ registerIndex: entry.registerIndex,
223
+ usageIndex: entry.usageIndex,
224
+ usedMask: entry.usedMask,
225
+ type: entry.type,
226
+ dimension: entry.dimension
227
+ })),
228
+ ...this.toCarbonBinaryInput()
229
+ };
230
+ }
231
+
232
+ /**
233
+ * Emit this input as a Carbon v15 `StageData` block.
234
+ *
235
+ * Carbon holds textures, samplers, UAVs and render states in `std::map`s and
236
+ * writes them in key order, and it sorts annotation names by `strcmp` before
237
+ * writing. Our maps are keyed but not ordered, so every collection is sorted
238
+ * explicitly here rather than trusting insertion order — the reader is
239
+ * indifferent, but the bytes are not, and a container that disagrees with
240
+ * Carbon's ordering is not the file Carbon would have written.
241
+ *
242
+ * @returns {object} Carbon stage-data record.
243
+ */
244
+ toCarbonBinaryInput() {
245
+ const byRegister = (left, right) => left.registerIndex - right.registerIndex;
246
+ const signature = this.signature ?? {};
247
+ return {
248
+ registers: (signature.registers ?? []).map(entry => ({
249
+ registerType: entry.registerType,
250
+ registerIndex: entry.registerIndex,
251
+ registerCount: entry.registerCount,
252
+ registerSpace: entry.registerSpace
253
+ })),
254
+ staticSamplers: (signature.staticSamplers ?? []).map(entry => {
255
+ const descriptor = entry.descriptor ?? {};
256
+ return {
257
+ registerIndex: entry.registerIndex,
258
+ registerSpace: entry.registerSpace,
259
+ comparison: descriptor.comparison ? 1 : 0,
260
+ minFilter: descriptor.minFilter,
261
+ magFilter: descriptor.magFilter,
262
+ mipFilter: descriptor.mipFilter,
263
+ addressU: descriptor.addressU,
264
+ addressV: descriptor.addressV,
265
+ addressW: descriptor.addressW,
266
+ mipLODBias: toRecordFloat(descriptor.mipLODBiasRaw),
267
+ maxAnisotropy: descriptor.maxAnisotropy,
268
+ comparisonFunc: descriptor.comparisonFunc,
269
+ // One byte here, four floats on a dynamic sampler.
270
+ borderColor: descriptor.borderColor,
271
+ minLOD: toRecordFloat(descriptor.minLODRaw),
272
+ maxLOD: toRecordFloat(descriptor.maxLODRaw)
273
+ };
274
+ }),
275
+ constants: this.constants.map(constant => constant.toCarbonBinary()),
276
+ defaultValues: toRecordBlob(this.constantValues, this.constantValueSize, this.constantValuesUnsetOffset),
277
+ textures: Array.from(this.resources, ([register, resource]) => resource.toCarbonBinary(register)).sort(byRegister),
278
+ samplers: Array.from(this.samplers, ([register, sampler]) => sampler.toCarbonBinary(register)).sort(byRegister),
279
+ uavs: Array.from(this.uavs, ([register, uav]) => uav.toCarbonBinary(register, true)).sort(byRegister),
280
+ annotations: this.annotation.map(entry => entry.toCarbonBinary()).sort((left, right) => compareUtf8(left.name.value, right.name.value))
281
+ };
282
+ }
283
+
284
+ /** Build one register-indexed resource map from Carbon texture or UAV records. */
285
+ static readCarbonBinaryResourceMap(records) {
286
+ const result = new Map();
287
+ for (const record of records) {
288
+ if (result.has(record.registerIndex)) {
289
+ throw new Error(`Carbon effect resource register ${record.registerIndex} is duplicated`);
290
+ }
291
+ result.set(record.registerIndex, Tr2EffectResource.fromCarbonBinary(record));
292
+ }
293
+ return result;
294
+ }
295
+
296
+ /** Build one register-indexed sampler map from Carbon sampler records. */
297
+ static readCarbonBinarySamplerMap(records) {
298
+ const result = new Map();
299
+ for (const record of records) {
300
+ if (result.has(record.registerIndex)) {
301
+ throw new Error(`Carbon effect sampler register ${record.registerIndex} is duplicated`);
302
+ }
303
+ result.set(record.registerIndex, Tr2SamplerSetup.fromCarbonBinary(record));
304
+ }
305
+ return result;
306
+ }
307
+
308
+ /**
309
+ * Create one explicit absent stage slot.
310
+ *
311
+ * @param {number} stageType Stage index.
312
+ * @returns {Tr2EffectStageInput} Empty stage input.
313
+ */
314
+ static createEmpty(stageType) {
315
+ const stage = new this();
316
+ stage.stageType = requireShaderStageType(stageType);
317
+ return stage;
318
+ }
319
+
320
+ /**
321
+ * Normalize one register-indexed collection into its canonical typed map.
322
+ *
323
+ * @param {Map|object} values Register-indexed source values.
324
+ * @param {Function} Constructor Entry constructor exposing `from`.
325
+ * @param {object} options Hydration options passed to entry construction.
326
+ * @param {string} field Diagnostic field name.
327
+ * @returns {Map<number, *>} Canonical register map.
328
+ */
329
+ static readCanonicalRegisterMap(values, Constructor, options, field) {
330
+ const entries = values instanceof Map ? values : Object.entries(values ?? {});
331
+ const result = new Map();
332
+ for (const [key, value] of entries) {
333
+ const registerIndex = Number(key);
334
+ if (!isUint32(registerIndex)) {
335
+ throw new RangeError(`Effect ${field} register index must fit uint32`);
336
+ }
337
+ if (result.has(registerIndex)) {
338
+ throw new Error(`Effect ${field} register ${registerIndex} is duplicated`);
339
+ }
340
+ result.set(registerIndex, value instanceof Constructor ? value : Constructor.from(value, options));
341
+ }
342
+ return result;
343
+ }
344
+ }
345
+
346
+ // Declared imperatively rather than with decorators, so this module stays
347
+ // plain ESM that loads from source without a transform. The decorator
348
+ // expressions are reused verbatim, so the registered metadata is identical.
349
+ // Statics belong in `methods`: decorateMethod targets the prototype and
350
+ // would register a static as an instance field.
351
+ CjsSchema.define(Tr2EffectStageInput, {
352
+ className: "Tr2EffectStageInput",
353
+ family: "shader",
354
+ fields: {
355
+ stageType: [impl.adapted, impl.reason("The source format identifies stage inputs by array index; the device-free graph retains the index explicitly for serialization and engine adapters."), type.int32],
356
+ exists: type.boolean,
357
+ resources: type.map("Tr2EffectResource"),
358
+ uavs: type.map("Tr2EffectResource"),
359
+ samplers: type.map("Tr2SamplerSetup"),
360
+ shader: type.uint32,
361
+ constants: type.list("Tr2EffectConstant"),
362
+ constantValueSize: type.uint32,
363
+ constantValues: type.typedArray("Uint8Array"),
364
+ constantValuesUnsetOffset: [impl.custom, impl.reason("A zero-size blob's offset word is passed through rather than interned, and the shipped corpus does not always set it to the null sentinel; the graph retains it so a body re-emits as the file that produced it."), type.uint32],
365
+ signature: type.rawStruct("Tr2ShaderSignatureAL"),
366
+ annotation: type.list("Tr2EffectParameterAnnotation"),
367
+ sourceProgram: [impl.adapted, impl.reason("Carbon replaces source program data with renderer handles while reading; the device-free resource graph must retain the portable source program for later engine realization."), type.rawStruct("CjsEffectSourceProgram")]
368
+ }
369
+ });
370
+
371
+ export { Tr2EffectStageInput };
372
+ //# sourceMappingURL=Tr2EffectStageInput.js.map