@forgeax/engine-runtime 0.1.3 → 0.1.6

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 (606) hide show
  1. package/README.md +49 -83
  2. package/dist/.tsbuildinfo +1 -1
  3. package/dist/__tests__/animation-graph-collect-roundtrip.test.d.ts +2 -0
  4. package/dist/__tests__/animation-graph-collect-roundtrip.test.d.ts.map +1 -0
  5. package/dist/__tests__/animation-graph-serialize.unit.test.d.ts +2 -0
  6. package/dist/__tests__/animation-graph-serialize.unit.test.d.ts.map +1 -0
  7. package/dist/__tests__/asset-brand-and-name-retirement.test.d.ts +2 -0
  8. package/dist/__tests__/asset-brand-and-name-retirement.test.d.ts.map +1 -0
  9. package/dist/__tests__/asset-error-exhaustive.test-d.d.ts +11 -0
  10. package/dist/__tests__/asset-error-exhaustive.test-d.d.ts.map +1 -0
  11. package/dist/__tests__/asset-registry-guid-reverse.test.d.ts +2 -0
  12. package/dist/__tests__/asset-registry-guid-reverse.test.d.ts.map +1 -0
  13. package/dist/__tests__/asset-registry-hdr-equirect.test.d.ts +2 -0
  14. package/dist/__tests__/asset-registry-hdr-equirect.test.d.ts.map +1 -0
  15. package/dist/__tests__/asset-registry-mesh-pack-payload.dawn.test.d.ts +2 -0
  16. package/dist/__tests__/asset-registry-mesh-pack-payload.dawn.test.d.ts.map +1 -0
  17. package/dist/__tests__/asset-registry-mounts.test.d.ts +2 -0
  18. package/dist/__tests__/asset-registry-mounts.test.d.ts.map +1 -0
  19. package/dist/__tests__/asset-registry.browser.test.d.ts +2 -0
  20. package/dist/__tests__/asset-registry.browser.test.d.ts.map +1 -0
  21. package/dist/__tests__/asset-registry.dawn.test.d.ts +2 -0
  22. package/dist/__tests__/asset-registry.dawn.test.d.ts.map +1 -0
  23. package/dist/__tests__/asset-registry.listCatalog.test.d.ts +2 -0
  24. package/dist/__tests__/asset-registry.listCatalog.test.d.ts.map +1 -0
  25. package/dist/__tests__/asset-registry.mesh-bin.test.d.ts +2 -0
  26. package/dist/__tests__/asset-registry.mesh-bin.test.d.ts.map +1 -0
  27. package/dist/__tests__/asset-registry.pack-cache.test.d.ts +2 -0
  28. package/dist/__tests__/asset-registry.pack-cache.test.d.ts.map +1 -0
  29. package/dist/__tests__/asset-registry.raw-container-failfast.test.d.ts +2 -0
  30. package/dist/__tests__/asset-registry.raw-container-failfast.test.d.ts.map +1 -0
  31. package/dist/__tests__/asset-registry.recursive.spec.d.ts +2 -0
  32. package/dist/__tests__/asset-registry.recursive.spec.d.ts.map +1 -0
  33. package/dist/__tests__/asset-registry.unit.test.d.ts +2 -0
  34. package/dist/__tests__/asset-registry.unit.test.d.ts.map +1 -0
  35. package/dist/__tests__/asset.unit.test.d.ts +2 -0
  36. package/dist/__tests__/asset.unit.test.d.ts.map +1 -0
  37. package/dist/__tests__/audio-load-by-guid.unit.test.d.ts +2 -0
  38. package/dist/__tests__/audio-load-by-guid.unit.test.d.ts.map +1 -0
  39. package/dist/__tests__/backend-selection.integration.test.d.ts +2 -0
  40. package/dist/__tests__/backend-selection.integration.test.d.ts.map +1 -0
  41. package/dist/__tests__/basis-catalog-dispatch.integration.test.d.ts +2 -0
  42. package/dist/__tests__/basis-catalog-dispatch.integration.test.d.ts.map +1 -0
  43. package/dist/__tests__/builtin-asset-registry.unit.test.d.ts +2 -0
  44. package/dist/__tests__/builtin-asset-registry.unit.test.d.ts.map +1 -0
  45. package/dist/__tests__/collect-scene-asset.test.d.ts +1 -2
  46. package/dist/__tests__/collect-scene-asset.test.d.ts.map +1 -1
  47. package/dist/__tests__/collect-scene-mount-collapse.test.d.ts +2 -0
  48. package/dist/__tests__/collect-scene-mount-collapse.test.d.ts.map +1 -0
  49. package/dist/__tests__/collect-transient-roundtrip.test.d.ts +1 -1
  50. package/dist/__tests__/collect-transient-roundtrip.test.d.ts.map +1 -1
  51. package/dist/__tests__/collect-transient-skip.test.d.ts +1 -2
  52. package/dist/__tests__/collect-transient-skip.test.d.ts.map +1 -1
  53. package/dist/__tests__/compressed-texture-physical-extent.integration.test.d.ts +2 -0
  54. package/dist/__tests__/compressed-texture-physical-extent.integration.test.d.ts.map +1 -0
  55. package/dist/__tests__/dawn/mesh-update-dawn.test.d.ts +2 -0
  56. package/dist/__tests__/dawn/mesh-update-dawn.test.d.ts.map +1 -0
  57. package/dist/__tests__/dawn/upload-texture.dawn.test.d.ts +2 -0
  58. package/dist/__tests__/dawn/upload-texture.dawn.test.d.ts.map +1 -0
  59. package/dist/__tests__/draw-published.d.ts +2 -2
  60. package/dist/__tests__/draw-published.d.ts.map +1 -1
  61. package/dist/__tests__/dynamic-texture-store.unit.test.d.ts +2 -0
  62. package/dist/__tests__/dynamic-texture-store.unit.test.d.ts.map +1 -0
  63. package/dist/__tests__/errors.unit.test.d.ts +2 -0
  64. package/dist/__tests__/errors.unit.test.d.ts.map +1 -0
  65. package/dist/__tests__/extract-skin-mismatch.unit.test.d.ts +2 -0
  66. package/dist/__tests__/extract-skin-mismatch.unit.test.d.ts.map +1 -0
  67. package/dist/__tests__/fetch-binary-decompress.test.d.ts +2 -0
  68. package/dist/__tests__/fetch-binary-decompress.test.d.ts.map +1 -0
  69. package/dist/__tests__/four-path-compression.integration.test.d.ts +2 -0
  70. package/dist/__tests__/four-path-compression.integration.test.d.ts.map +1 -0
  71. package/dist/__tests__/fullscreen-feature-host.dawn.test.d.ts +2 -0
  72. package/dist/__tests__/fullscreen-feature-host.dawn.test.d.ts.map +1 -0
  73. package/dist/__tests__/guid-for-asset.unit.test.d.ts +2 -0
  74. package/dist/__tests__/guid-for-asset.unit.test.d.ts.map +1 -0
  75. package/dist/__tests__/handle-migration.test.d.ts +2 -0
  76. package/dist/__tests__/handle-migration.test.d.ts.map +1 -0
  77. package/dist/__tests__/helpers/register-runtime-components.d.ts.map +1 -1
  78. package/dist/__tests__/host-custom-kind-contract.test-d.d.ts +2 -0
  79. package/dist/__tests__/host-custom-kind-contract.test-d.d.ts.map +1 -0
  80. package/dist/__tests__/host-custom-kind-contract.test.d.ts +2 -0
  81. package/dist/__tests__/host-custom-kind-contract.test.d.ts.map +1 -0
  82. package/dist/__tests__/inspect-name.test.d.ts +2 -0
  83. package/dist/__tests__/inspect-name.test.d.ts.map +1 -0
  84. package/dist/__tests__/instantiate-mount-deferred-wiring.test.d.ts +2 -0
  85. package/dist/__tests__/instantiate-mount-deferred-wiring.test.d.ts.map +1 -0
  86. package/dist/__tests__/loadbyguid-payload.unit.test.d.ts +2 -0
  87. package/dist/__tests__/loadbyguid-payload.unit.test.d.ts.map +1 -0
  88. package/dist/__tests__/loadbyguid-texture-intern.unit.test.d.ts +2 -0
  89. package/dist/__tests__/loadbyguid-texture-intern.unit.test.d.ts.map +1 -0
  90. package/dist/__tests__/loader-extract-graceful.test.d.ts +2 -0
  91. package/dist/__tests__/loader-extract-graceful.test.d.ts.map +1 -0
  92. package/dist/__tests__/loader-name-survival.test.d.ts +2 -0
  93. package/dist/__tests__/loader-name-survival.test.d.ts.map +1 -0
  94. package/dist/__tests__/mesh-bin-contract.test.d.ts +2 -0
  95. package/dist/__tests__/mesh-bin-contract.test.d.ts.map +1 -0
  96. package/dist/__tests__/mesh-bin-skin-roundtrip.unit.test.d.ts +2 -0
  97. package/dist/__tests__/mesh-bin-skin-roundtrip.unit.test.d.ts.map +1 -0
  98. package/dist/__tests__/mesh-bin.test.d.ts +2 -0
  99. package/dist/__tests__/mesh-bin.test.d.ts.map +1 -0
  100. package/dist/__tests__/mesh-loader-skin-contract.unit.test.d.ts +2 -0
  101. package/dist/__tests__/mesh-loader-skin-contract.unit.test.d.ts.map +1 -0
  102. package/dist/__tests__/new-kind-refs-contract.test.d.ts +2 -0
  103. package/dist/__tests__/new-kind-refs-contract.test.d.ts.map +1 -0
  104. package/dist/__tests__/package-promotion.test.d.ts +2 -0
  105. package/dist/__tests__/package-promotion.test.d.ts.map +1 -0
  106. package/dist/__tests__/package-rename.test.d.ts +2 -0
  107. package/dist/__tests__/package-rename.test.d.ts.map +1 -0
  108. package/dist/__tests__/recover-error-exhaustive.test-d.d.ts +1 -1
  109. package/dist/__tests__/recover-error-exhaustive.test-d.d.ts.map +1 -1
  110. package/dist/__tests__/render-error-exhaustive.test-d.d.ts +1 -1
  111. package/dist/__tests__/render-error-exhaustive.test-d.d.ts.map +1 -1
  112. package/dist/__tests__/render-feature-prepared-graphics.fixture.d.ts +10 -0
  113. package/dist/__tests__/render-feature-prepared-graphics.fixture.d.ts.map +1 -0
  114. package/dist/__tests__/render-system-extract.unit.test.d.ts +2 -0
  115. package/dist/__tests__/render-system-extract.unit.test.d.ts.map +1 -0
  116. package/dist/__tests__/renderer-test-utils.d.ts +10 -0
  117. package/dist/__tests__/renderer-test-utils.d.ts.map +1 -0
  118. package/dist/__tests__/renderer.test-d.d.ts +2 -0
  119. package/dist/__tests__/renderer.test-d.d.ts.map +1 -0
  120. package/dist/__tests__/resolve-asset-handle-err.test.d.ts +2 -0
  121. package/dist/__tests__/resolve-asset-handle-err.test.d.ts.map +1 -0
  122. package/dist/__tests__/resolve-asset-handle.unit.test.d.ts +2 -0
  123. package/dist/__tests__/resolve-asset-handle.unit.test.d.ts.map +1 -0
  124. package/dist/__tests__/resolveName-fallback.test.d.ts +2 -0
  125. package/dist/__tests__/resolveName-fallback.test.d.ts.map +1 -0
  126. package/dist/__tests__/resolveName-null-package.test.d.ts +2 -0
  127. package/dist/__tests__/resolveName-null-package.test.d.ts.map +1 -0
  128. package/dist/__tests__/resolveName-unified-entry.test.d.ts +2 -0
  129. package/dist/__tests__/resolveName-unified-entry.test.d.ts.map +1 -0
  130. package/dist/__tests__/resolveName.test.d.ts +2 -0
  131. package/dist/__tests__/resolveName.test.d.ts.map +1 -0
  132. package/dist/__tests__/roots-to-scene-asset.test.d.ts +1 -1
  133. package/dist/__tests__/roots-to-scene-asset.test.d.ts.map +1 -1
  134. package/dist/__tests__/roundtrip-primitive.test.d.ts +2 -0
  135. package/dist/__tests__/roundtrip-primitive.test.d.ts.map +1 -0
  136. package/dist/__tests__/scene-bare-guid-refs-instantiate.test.d.ts +2 -0
  137. package/dist/__tests__/scene-bare-guid-refs-instantiate.test.d.ts.map +1 -0
  138. package/dist/__tests__/scene-instance-authoring.integration.test.d.ts +2 -0
  139. package/dist/__tests__/scene-instance-authoring.integration.test.d.ts.map +1 -0
  140. package/dist/__tests__/scene-mount-fixed-point.test.d.ts +2 -0
  141. package/dist/__tests__/scene-mount-fixed-point.test.d.ts.map +1 -0
  142. package/dist/__tests__/scene-mount-roundtrip.test.d.ts +2 -0
  143. package/dist/__tests__/scene-mount-roundtrip.test.d.ts.map +1 -0
  144. package/dist/__tests__/scene-mount-wrapper-roundtrip.test.d.ts +2 -0
  145. package/dist/__tests__/scene-mount-wrapper-roundtrip.test.d.ts.map +1 -0
  146. package/dist/__tests__/scene-sugar-instantiate.test.d.ts +2 -0
  147. package/dist/__tests__/scene-sugar-instantiate.test.d.ts.map +1 -0
  148. package/dist/__tests__/serialize-mounts-roundtrip.test.d.ts +2 -0
  149. package/dist/__tests__/serialize-mounts-roundtrip.test.d.ts.map +1 -0
  150. package/dist/__tests__/serialize-scene-asset.test.d.ts +1 -1
  151. package/dist/__tests__/serialize-scene-asset.test.d.ts.map +1 -1
  152. package/dist/__tests__/template-game-default-api-contract.test.d.ts +2 -0
  153. package/dist/__tests__/template-game-default-api-contract.test.d.ts.map +1 -0
  154. package/dist/__tests__/tileset-asset-validate.test.d.ts +2 -0
  155. package/dist/__tests__/tileset-asset-validate.test.d.ts.map +1 -0
  156. package/dist/__tests__/transcode-fallback.unit.test.d.ts +2 -0
  157. package/dist/__tests__/transcode-fallback.unit.test.d.ts.map +1 -0
  158. package/dist/__tests__/transient-runtime-behavior.test.d.ts +2 -0
  159. package/dist/__tests__/transient-runtime-behavior.test.d.ts.map +1 -0
  160. package/dist/__tests__/video-loader-consumption.test.d.ts +2 -0
  161. package/dist/__tests__/video-loader-consumption.test.d.ts.map +1 -0
  162. package/dist/__tests__/video-loader-smoke.dawn.test.d.ts +2 -0
  163. package/dist/__tests__/video-loader-smoke.dawn.test.d.ts.map +1 -0
  164. package/dist/backend-selection.d.ts +13 -0
  165. package/dist/backend-selection.d.ts.map +1 -0
  166. package/dist/collect-scene-asset.d.ts +3 -3
  167. package/dist/collect-scene-asset.d.ts.map +1 -1
  168. package/dist/createRenderer.d.ts +14 -2
  169. package/dist/createRenderer.d.ts.map +1 -1
  170. package/dist/errors/environment.d.ts +1 -1
  171. package/dist/errors/environment.d.ts.map +1 -1
  172. package/dist/index.d.ts +19 -81
  173. package/dist/index.d.ts.map +1 -1
  174. package/dist/index.mjs +105 -108
  175. package/dist/index.mjs.map +1 -1
  176. package/dist/renderer-host.d.ts +9 -0
  177. package/dist/renderer-host.d.ts.map +1 -0
  178. package/dist/renderer-host.mjs +62 -0
  179. package/dist/renderer-host.mjs.map +1 -0
  180. package/dist/scene-instances/index.d.ts +2 -0
  181. package/dist/scene-instances/index.d.ts.map +1 -0
  182. package/dist/scene-utils/mount-override-fold.d.ts +1 -2
  183. package/dist/scene-utils/mount-override-fold.d.ts.map +1 -1
  184. package/dist/systems/sprite-animation-tick.d.ts +1 -1
  185. package/dist/systems/sprite-animation-tick.d.ts.map +1 -1
  186. package/dist/systems/transparent-sort.d.ts +1 -2
  187. package/dist/systems/transparent-sort.d.ts.map +1 -1
  188. package/dist/tilemap-register-validate.d.ts.map +1 -1
  189. package/package.json +34 -33
  190. package/src/__tests__/active-camera.unit.test.ts +19 -9
  191. package/src/__tests__/animation-graph-collect-roundtrip.test.ts +213 -0
  192. package/src/__tests__/animation-graph-serialize.unit.test.ts +171 -0
  193. package/src/__tests__/append-injection.test.ts +1 -1
  194. package/src/__tests__/asset-brand-and-name-retirement.test.ts +102 -0
  195. package/src/__tests__/asset-error-exhaustive.test-d.ts +62 -0
  196. package/src/__tests__/asset-registry-guid-reverse.test.ts +575 -0
  197. package/src/__tests__/asset-registry-hdr-equirect.test.ts +78 -0
  198. package/src/__tests__/asset-registry-mesh-pack-payload.dawn.test.ts +232 -0
  199. package/src/__tests__/asset-registry-mounts.test.ts +806 -0
  200. package/src/__tests__/asset-registry.browser.test.ts +81 -0
  201. package/src/__tests__/asset-registry.dawn.test.ts +94 -0
  202. package/src/__tests__/asset-registry.listCatalog.test.ts +170 -0
  203. package/src/__tests__/asset-registry.mesh-bin.test.ts +316 -0
  204. package/src/__tests__/asset-registry.pack-cache.test.ts +969 -0
  205. package/src/__tests__/asset-registry.raw-container-failfast.test.ts +225 -0
  206. package/src/__tests__/asset-registry.recursive.spec.ts +1397 -0
  207. package/src/__tests__/asset-registry.unit.test.ts +1030 -0
  208. package/src/__tests__/asset.unit.test.ts +7107 -0
  209. package/src/__tests__/audio-load-by-guid.unit.test.ts +126 -0
  210. package/src/__tests__/backend-selection.integration.test.ts +11 -0
  211. package/src/__tests__/basis-catalog-dispatch.integration.test.ts +320 -0
  212. package/src/__tests__/bind-group-cache-keying.test.ts +4 -4
  213. package/src/__tests__/block-upload-math.unit.test.ts +2 -2
  214. package/src/__tests__/builtin-asset-registry.unit.test.ts +112 -0
  215. package/src/__tests__/builtin-shader-register-e2e.test.ts +1 -1
  216. package/src/__tests__/cache-false-eviction.test.ts +2 -1
  217. package/src/__tests__/cache-isolation-matrix.test.ts +2 -1
  218. package/src/__tests__/camera-clear-snapshot-equivalence.unit.test.ts +5 -6
  219. package/src/__tests__/clamp-to-last.e2e.browser.test.ts +29 -19
  220. package/src/__tests__/collect-scene-asset.test.ts +49 -52
  221. package/src/__tests__/collect-scene-mount-collapse.test.ts +391 -0
  222. package/src/__tests__/collect-subtree.unit.test.ts +1 -2
  223. package/src/__tests__/collect-transient-children-absent.test.ts +24 -10
  224. package/src/__tests__/collect-transient-roundtrip.test.ts +44 -20
  225. package/src/__tests__/collect-transient-skip.test.ts +24 -13
  226. package/src/__tests__/components.test-d.ts +1 -6
  227. package/src/__tests__/components.unit.test.ts +20 -19
  228. package/src/__tests__/composite-skybox-cross-world.browser.test.ts +59 -27
  229. package/src/__tests__/compressed-texture-physical-extent.integration.test.ts +139 -0
  230. package/src/__tests__/create-renderer-assembly.integration.test.ts +42 -29
  231. package/src/__tests__/createRenderer-dispose.test.ts +35 -402
  232. package/src/__tests__/createRenderer.browser-no-webgpu.test.ts +25 -30
  233. package/src/__tests__/createRenderer.unit.test.ts +1 -1
  234. package/src/__tests__/dawn/hello-sprite-nineslice-section.dawn.test.ts +27 -63
  235. package/src/__tests__/dawn/ibl-precompute-readback.dawn.test.ts +56 -47
  236. package/src/__tests__/dawn/instances-per-instance-pbr.dawn.test.ts +49 -29
  237. package/src/__tests__/dawn/instances-shadow.dawn.test.ts +26 -15
  238. package/src/__tests__/dawn/instances-uniform-fallback.dawn.test.ts +13 -14
  239. package/src/__tests__/dawn/material-alpha.dawn.test.ts +23 -31
  240. package/src/__tests__/dawn/material-cooked-fixture.dawn.test.ts +0 -18
  241. package/src/__tests__/dawn/{mesh-update.dawn.test.ts → mesh-update-dawn.test.ts} +42 -134
  242. package/src/__tests__/dawn/mipmap-srgb-linear.dawn.test.ts +14 -7
  243. package/src/__tests__/dawn/per-entity-material-texture-isolation.dawn.test.ts +16 -28
  244. package/src/__tests__/dawn/sprite-nineslice-mesh-bind.dawn.test.ts +23 -39
  245. package/src/__tests__/dawn/upload-texture.dawn.test.ts +198 -0
  246. package/src/__tests__/dawn/user-handle-mesh-render.dawn.test.ts +12 -14
  247. package/src/__tests__/dawn/user-mesh-upload.dawn.test.ts +27 -22
  248. package/src/__tests__/dawn/zero-manifest-mesh-fail.dawn.test.ts +25 -28
  249. package/src/__tests__/dawn/zero-manifest-ready.dawn.test.ts +10 -11
  250. package/src/__tests__/demo-sortscope-migration.unit.test.ts +5 -5
  251. package/src/__tests__/derive-bgl-integration.test.ts +34 -44
  252. package/src/__tests__/derive-render-data-skin.unit.test.ts +1 -1
  253. package/src/__tests__/draw-published.ts +11 -4
  254. package/src/__tests__/dynamic-texture-store.unit.test.ts +190 -0
  255. package/src/__tests__/equirect-bc6h.integration.test.ts +144 -21
  256. package/src/__tests__/errors.unit.test.ts +1203 -0
  257. package/src/__tests__/extract-frames-graceful-degradation.test.ts +3 -7
  258. package/src/__tests__/extract-frames-merge.test.ts +35 -22
  259. package/src/__tests__/extract-record-no-hardcoded-texture-fields.test.ts +5 -16
  260. package/src/__tests__/extract-skin-mismatch.unit.test.ts +322 -0
  261. package/src/__tests__/fetch-binary-decompress.test.ts +356 -0
  262. package/src/__tests__/four-path-compression.integration.test.ts +395 -0
  263. package/src/__tests__/frame-targets-shadow-regression.unit.test.ts +1 -1
  264. package/src/__tests__/fullscreen-feature-host.dawn.test.ts +80 -0
  265. package/src/__tests__/fullscreen-post-bgl-depth.test.ts +4 -2
  266. package/src/__tests__/fullscreen-post-depth-params-arity.test.ts +3 -3
  267. package/src/__tests__/fullscreen-post-process-pass.dawn.test.ts +39 -23
  268. package/src/__tests__/fullscreen-post-process-pass.unit.test.ts +4 -2
  269. package/src/__tests__/fxaa-pixel-diff.dawn.test.ts +28 -17
  270. package/src/__tests__/fxaa-validation-and-resize.dawn.test.ts +29 -18
  271. package/src/__tests__/fxaa-zero-overhead.dawn.test.ts +16 -12
  272. package/src/__tests__/geometry.unit.test.ts +525 -159
  273. package/src/__tests__/glyph-tilemap-worldid.test.ts +1 -1
  274. package/src/__tests__/gpu-resource-cow-survivor.test.ts +6 -4
  275. package/src/__tests__/guid-for-asset.unit.test.ts +102 -0
  276. package/src/__tests__/handle-migration.test.ts +136 -0
  277. package/src/__tests__/helpers/register-runtime-components.ts +4 -2
  278. package/src/__tests__/helpers/register-scene-components.ts +1 -1
  279. package/src/__tests__/host-custom-kind-contract.test-d.ts +47 -0
  280. package/src/__tests__/host-custom-kind-contract.test.ts +578 -0
  281. package/src/__tests__/inspect-name.test.ts +139 -0
  282. package/src/__tests__/instances.test-d.ts +1 -1
  283. package/src/__tests__/instantiate-mount-deferred-wiring.test.ts +112 -0
  284. package/src/__tests__/light-casters-9-light.browser.test.ts +73 -76
  285. package/src/__tests__/light-gpu-byte-neutral.unit.test.ts +7 -10
  286. package/src/__tests__/light-snapshot.test-d.ts +2 -2
  287. package/src/__tests__/lights-vec-negative.unit.test.ts +1 -1
  288. package/src/__tests__/lights.unit.test.ts +16 -500
  289. package/src/__tests__/loadbyguid-payload.unit.test.ts +117 -0
  290. package/src/__tests__/loadbyguid-texture-intern.unit.test.ts +213 -0
  291. package/src/__tests__/loader-extract-graceful.test.ts +146 -0
  292. package/src/__tests__/loader-name-survival.test.ts +213 -0
  293. package/src/__tests__/m3-vec-negative.unit.test.ts +3 -2
  294. package/src/__tests__/material-texture-uv-scale.unit.test.ts +101 -31
  295. package/src/__tests__/materials.unit.test.ts +10 -27
  296. package/src/__tests__/mesh-bin-contract.test.ts +28 -0
  297. package/src/__tests__/mesh-bin-skin-roundtrip.unit.test.ts +149 -0
  298. package/src/__tests__/mesh-bin.test.ts +38 -0
  299. package/src/__tests__/mesh-loader-skin-contract.unit.test.ts +120 -0
  300. package/src/__tests__/mesh-ssbo-grow.unit.test.ts +3 -3
  301. package/src/__tests__/mip-gate.unit.test.ts +1 -1
  302. package/src/__tests__/msaa-sprite-pixel-diff.dawn.test.ts +29 -68
  303. package/src/__tests__/new-kind-refs-contract.test.ts +132 -0
  304. package/src/__tests__/node-shims.d.ts +4 -6
  305. package/src/__tests__/package-promotion.test.ts +88 -0
  306. package/src/__tests__/package-rename.test.ts +103 -0
  307. package/src/__tests__/pass-selector.unit.test.ts +2 -2
  308. package/src/__tests__/pbr-pipeline.unit.test.ts +14 -21
  309. package/src/__tests__/pipeline-builder-msaa.unit.test.ts +6 -9
  310. package/src/__tests__/pipeline-cache-keying.unit.test.ts +6 -9
  311. package/src/__tests__/pipeline-spec.test.ts +16 -177
  312. package/src/__tests__/pipeline.unit.test.ts +154 -1693
  313. package/src/__tests__/point-light-shadow.dawn.test.ts +33 -42
  314. package/src/__tests__/point-light-shadow.unit.test.ts +19 -60
  315. package/src/__tests__/post-process-error-codes.unit.test.ts +4 -1
  316. package/src/__tests__/post-process-params-component.unit.test.ts +1 -1
  317. package/src/__tests__/post-process-params-extract.unit.test.ts +2 -5
  318. package/src/__tests__/postprocess-camera-consistency.test.ts +4 -7
  319. package/src/__tests__/profiler-assembly.integration.test.ts +1 -1
  320. package/src/__tests__/propagate-transforms.dawn.test.ts +12 -11
  321. package/src/__tests__/record-worldid-isolation.test.ts +7 -29
  322. package/src/__tests__/recover-error-exhaustive.test-d.ts +1 -1
  323. package/src/__tests__/render-error-exhaustive.test-d.ts +81 -71
  324. package/src/__tests__/render-feature-assembly.test-d.ts +20 -9
  325. package/src/__tests__/render-feature-prepared-graphics-docs.unit.test.ts +8 -6
  326. package/src/__tests__/render-feature-prepared-graphics.browser.test.ts +60 -558
  327. package/src/__tests__/render-feature-prepared-graphics.dawn.test.ts +57 -544
  328. package/src/__tests__/render-feature-prepared-graphics.fixture.ts +104 -0
  329. package/src/__tests__/render-feature-prepared-graphics.integration.test.ts +40 -248
  330. package/src/__tests__/render-feature-prepared-graphics.regression.integration.test.ts +83 -340
  331. package/src/__tests__/render-feature-recover.integration.test.ts +9 -49
  332. package/src/__tests__/render-feature-runtime-surface.test-d.ts +17 -20
  333. package/src/__tests__/render-schema-consumer.integration.test.ts +20 -13
  334. package/src/__tests__/render-schema-owner-boundary.unit.test.ts +2 -6
  335. package/src/__tests__/render-system-cross-world-overlay-queue.test.ts +5 -5
  336. package/src/__tests__/render-system-extract-dispatch-ordering.test.ts +16 -31
  337. package/src/__tests__/render-system-extract.test.ts +36 -51
  338. package/src/__tests__/render-system-extract.unit.test.ts +360 -0
  339. package/src/__tests__/render-system-fold-bucket.unit.test.ts +3 -5
  340. package/src/__tests__/render-system-fold-fallback.unit.test.ts +6 -3
  341. package/src/__tests__/render-system-fold-material.unit.test.ts +3 -5
  342. package/src/__tests__/render-system-fold-metrics.unit.test.ts +5 -5
  343. package/src/__tests__/render-system-fold-modegate.unit.test.ts +6 -6
  344. package/src/__tests__/render-system-fold.dawn.test.ts +7 -5
  345. package/src/__tests__/render-system-mega.test.ts +292 -190
  346. package/src/__tests__/render-system-owner-split-contract.test.ts +10 -32
  347. package/src/__tests__/render-system-record-multi-material-textureview.test.ts +59 -45
  348. package/src/__tests__/render-system-record-per-submesh-transparency.test.ts +23 -29
  349. package/src/__tests__/render-system-record.test.ts +398 -235
  350. package/src/__tests__/render-system-record.unit.test.ts +25 -26
  351. package/src/__tests__/render-system-skin-bg.unit.test.ts +8 -12
  352. package/src/__tests__/renderer-consumer.test-d.ts +16 -3
  353. package/src/__tests__/renderer-health.unit.test.ts +26 -916
  354. package/src/__tests__/renderer-lifecycle.integration.test.ts +19 -6
  355. package/src/__tests__/renderer-recover.unit.test.ts +49 -1069
  356. package/src/__tests__/renderer-result.test-d.ts +19 -9
  357. package/src/__tests__/renderer-surface.unit.test.ts +3 -5
  358. package/src/__tests__/renderer-test-utils.ts +56 -0
  359. package/src/__tests__/renderer.test-d.ts +59 -0
  360. package/src/__tests__/resolve-asset-handle-err.test.ts +111 -0
  361. package/src/__tests__/resolve-asset-handle.unit.test.ts +64 -0
  362. package/src/__tests__/resolve-depth-only-view.test.ts +1 -1
  363. package/src/__tests__/resolveName-fallback.test.ts +64 -0
  364. package/src/__tests__/resolveName-null-package.test.ts +38 -0
  365. package/src/__tests__/resolveName-unified-entry.test.ts +65 -0
  366. package/src/__tests__/resolveName.test.ts +64 -0
  367. package/src/__tests__/rhi-null-command-flow.unit.test.ts +43 -261
  368. package/src/__tests__/rhi-null-renderer-lifecycle.unit.test.ts +41 -169
  369. package/src/__tests__/roots-to-scene-asset.test.ts +199 -93
  370. package/src/__tests__/roundtrip-primitive.test.ts +351 -0
  371. package/src/__tests__/scene-bare-guid-refs-instantiate.test.ts +123 -0
  372. package/src/__tests__/scene-equirect-roundtrip.test.ts +103 -16
  373. package/src/__tests__/scene-instance-authoring.integration.test.ts +8 -0
  374. package/src/__tests__/scene-instance-bridge.integration.test.ts +1 -1
  375. package/src/__tests__/scene-instance-component.test.ts +1 -1
  376. package/src/__tests__/scene-mount-fixed-point.test.ts +257 -0
  377. package/src/__tests__/scene-mount-roundtrip.test.ts +987 -0
  378. package/src/__tests__/scene-mount-wrapper-roundtrip.test.ts +202 -0
  379. package/src/__tests__/scene-sugar-instantiate.test.ts +324 -0
  380. package/src/__tests__/serialize-mounts-roundtrip.test.ts +533 -0
  381. package/src/__tests__/serialize-scene-asset.test.ts +219 -22
  382. package/src/__tests__/shadow-caster-empty-schema.test.ts +3 -3
  383. package/src/__tests__/shadow-csm-cascade-loadop.test.ts +37 -17
  384. package/src/__tests__/shadow-csm-component.test.ts +3 -5
  385. package/src/__tests__/shadow-csm-extract.test.ts +2 -100
  386. package/src/__tests__/shadow-csm-orthoz.test.ts +2 -16
  387. package/src/__tests__/shadow-csm-runtime-vary.dawn.test.ts +19 -14
  388. package/src/__tests__/shadow-csm-tile-consistency.test.ts +32 -26
  389. package/src/__tests__/shadow-csm-ubo.dawn.test.ts +8 -49
  390. package/src/__tests__/shadow-csm-ubo.test.ts +3 -25
  391. package/src/__tests__/shadow-csm-viewport.browser.test.ts +1 -1
  392. package/src/__tests__/shadow-fields-observable.dawn.test.ts +67 -56
  393. package/src/__tests__/shadow-m1.dawn.test.ts +8 -9
  394. package/src/__tests__/shadow-mesh-ssbo-order.test.ts +11 -27
  395. package/src/__tests__/skin-errors.unit.test.ts +1 -1
  396. package/src/__tests__/skin-extract-getarrayview-count.unit.test.ts +7 -5
  397. package/src/__tests__/skylight-lazy-projection.test.ts +36 -15
  398. package/src/__tests__/sparse-tag-scene-roundtrip.test.ts +5 -5
  399. package/src/__tests__/sprite-cullmode-flip.dawn.test.ts +47 -64
  400. package/src/__tests__/sprite-lit-bgl-byte-identical.test.ts +12 -11
  401. package/src/__tests__/sprite-lit-extract-branch.test.ts +1 -1
  402. package/src/__tests__/sprite-lit-pipeline-cache-key.test.ts +1 -1
  403. package/src/__tests__/ssao-bgl.test.ts +16 -9
  404. package/src/__tests__/ssao-buffers.test.ts +2 -2
  405. package/src/__tests__/ssao-data.test.ts +2 -2
  406. package/src/__tests__/ssao-errors.test.ts +1 -1
  407. package/src/__tests__/ssao-passes.test.ts +64 -392
  408. package/src/__tests__/ssao-pipelines.test.ts +1 -1
  409. package/src/__tests__/ssao-uniform-layout.test.ts +8 -6
  410. package/src/__tests__/stencil-outline-pixel.dawn.test.ts +25 -17
  411. package/src/__tests__/swap-chain-format.unit.test.ts +5 -7
  412. package/src/__tests__/systems.unit.test.ts +536 -1326
  413. package/src/__tests__/template-game-default-api-contract.test.ts +362 -0
  414. package/src/__tests__/text.unit.test.ts +56 -33
  415. package/src/__tests__/tilemap-childed-despawn.test.ts +8 -14
  416. package/src/__tests__/tilemap-chunk-extract.overhang-bounds.test.ts +8 -12
  417. package/src/__tests__/tilemap-chunk-extract.propagate-order.test.ts +2 -1
  418. package/src/__tests__/tilemap-chunk-extract.test.ts +13 -17
  419. package/src/__tests__/tilemap-dirty-rebuild.test.ts +7 -11
  420. package/src/__tests__/tilemap-material-cache.test.ts +8 -13
  421. package/src/__tests__/tilemap-multi-atlas.test.ts +12 -32
  422. package/src/__tests__/tilemap-owner-boundary.unit.test.ts +5 -2
  423. package/src/__tests__/tilemap-region-pack.test.ts +8 -12
  424. package/src/__tests__/tilemap-spawn-flip-pivot.test.ts +8 -12
  425. package/src/__tests__/tilemap-uv-inset.test.ts +11 -14
  426. package/src/__tests__/tilemap-validate.test.ts +1 -1
  427. package/src/__tests__/tileset-asset-validate.test.ts +638 -0
  428. package/src/__tests__/transcode-fallback.unit.test.ts +207 -0
  429. package/src/__tests__/transform-hierarchy-pixel-diff.dawn.test.ts +36 -28
  430. package/src/__tests__/transient-fields-collect.test.ts +28 -21
  431. package/src/__tests__/transient-runtime-behavior.test.ts +227 -0
  432. package/src/__tests__/transparent-sort-tilemap-sprite-interleave.test.ts +4 -4
  433. package/src/__tests__/variant-selection.unit.test.ts +1 -1
  434. package/src/__tests__/video-extract-bindgroup.dawn.test.ts +89 -136
  435. package/src/__tests__/video-loader-consumption.test.ts +86 -0
  436. package/src/__tests__/video-loader-smoke.dawn.test.ts +60 -0
  437. package/src/__tests__/view-ubo-layout.browser.test.ts +0 -22
  438. package/src/__tests__/world-entity-key.test.ts +1 -1
  439. package/src/__tests__/world-scene-despawn.test.ts +1 -1
  440. package/src/__tests__/world-scene-instantiate.test.ts +2 -36
  441. package/src/__tests__/world-scene-nested.test.ts +1 -1
  442. package/src/__tests__/world-scene-override.test.ts +1 -1
  443. package/src/backend-selection.ts +69 -0
  444. package/src/collect-scene-asset.ts +28 -23
  445. package/src/components/__tests__/camera.test-d.ts +1 -1
  446. package/src/components/__tests__/camera.test.ts +1 -1
  447. package/src/components/__tests__/sprite-animation.test-d.ts +2 -2
  448. package/src/components/__tests__/tile-layer.test-d.ts +1 -1
  449. package/src/components/__tests__/tile-layer.unit.test.ts +2 -2
  450. package/src/createRenderer.ts +24 -36
  451. package/src/errors/environment.ts +1 -1
  452. package/src/index.ts +47 -113
  453. package/src/renderer-host.ts +33 -0
  454. package/src/scene-instances/__tests__/post-spawn-resolve-joints.unit.test.ts +1 -1
  455. package/src/scene-instances/index.ts +4 -0
  456. package/src/scene-utils/mount-override-fold.ts +3 -7
  457. package/src/systems/__tests__/transparent-sort.bench.ts +3 -3
  458. package/src/systems/sprite-animation-tick.ts +1 -1
  459. package/src/systems/transparent-sort.ts +38 -38
  460. package/src/tilemap-register-validate.ts +4 -4
  461. package/dist/__tests__/bind-group-cache-binding.test.d.ts +0 -2
  462. package/dist/__tests__/bind-group-cache-binding.test.d.ts.map +0 -1
  463. package/dist/__tests__/bind-group-cache-frame.test.d.ts +0 -2
  464. package/dist/__tests__/bind-group-cache-frame.test.d.ts.map +0 -1
  465. package/dist/__tests__/dawn/mesh-update.dawn.test.d.ts +0 -2
  466. package/dist/__tests__/dawn/mesh-update.dawn.test.d.ts.map +0 -1
  467. package/dist/__tests__/dispatch-fullscreen-pass-composite-swapchain.dawn.test.d.ts +0 -2
  468. package/dist/__tests__/dispatch-fullscreen-pass-composite-swapchain.dawn.test.d.ts.map +0 -1
  469. package/dist/__tests__/dispatch-fullscreen-pass-custom-reads.dawn.test.d.ts +0 -2
  470. package/dist/__tests__/dispatch-fullscreen-pass-custom-reads.dawn.test.d.ts.map +0 -1
  471. package/dist/__tests__/dispatch-fullscreen-pass-depth-composite.dawn.test.d.ts +0 -2
  472. package/dist/__tests__/dispatch-fullscreen-pass-depth-composite.dawn.test.d.ts.map +0 -1
  473. package/dist/__tests__/dispatch-fullscreen-pass-params.unit.test.d.ts +0 -2
  474. package/dist/__tests__/dispatch-fullscreen-pass-params.unit.test.d.ts.map +0 -1
  475. package/dist/__tests__/fog-producer-manifest.d.ts +0 -131
  476. package/dist/__tests__/fog-producer-manifest.d.ts.map +0 -1
  477. package/dist/__tests__/fog-producer-pixel-probe.d.ts +0 -42
  478. package/dist/__tests__/fog-producer-pixel-probe.d.ts.map +0 -1
  479. package/dist/__tests__/fog-producer-pixel.browser.test.d.ts +0 -2
  480. package/dist/__tests__/fog-producer-pixel.browser.test.d.ts.map +0 -1
  481. package/dist/__tests__/fog-producer-pixel.dawn.test.d.ts +0 -2
  482. package/dist/__tests__/fog-producer-pixel.dawn.test.d.ts.map +0 -1
  483. package/dist/__tests__/fog-producer-real-fixture.d.ts +0 -5
  484. package/dist/__tests__/fog-producer-real-fixture.d.ts.map +0 -1
  485. package/dist/__tests__/fog-producer-vfx-effect.d.ts +0 -3
  486. package/dist/__tests__/fog-producer-vfx-effect.d.ts.map +0 -1
  487. package/dist/__tests__/fog-scene-asset.integration.test.d.ts +0 -2
  488. package/dist/__tests__/fog-scene-asset.integration.test.d.ts.map +0 -1
  489. package/dist/__tests__/gpu-resource-store-cubemap-status.test.d.ts +0 -2
  490. package/dist/__tests__/gpu-resource-store-cubemap-status.test.d.ts.map +0 -1
  491. package/dist/__tests__/gpu-resource.test.d.ts +0 -2
  492. package/dist/__tests__/gpu-resource.test.d.ts.map +0 -1
  493. package/dist/__tests__/hdrp-bgl-slots.browser.test.d.ts +0 -2
  494. package/dist/__tests__/hdrp-bgl-slots.browser.test.d.ts.map +0 -1
  495. package/dist/__tests__/hdrp-buffers.unit.test.d.ts +0 -2
  496. package/dist/__tests__/hdrp-buffers.unit.test.d.ts.map +0 -1
  497. package/dist/__tests__/hdrp-execute-filter.unit.test.d.ts +0 -2
  498. package/dist/__tests__/hdrp-execute-filter.unit.test.d.ts.map +0 -1
  499. package/dist/__tests__/hdrp-gbuffer-attachments.browser.test.d.ts +0 -2
  500. package/dist/__tests__/hdrp-gbuffer-attachments.browser.test.d.ts.map +0 -1
  501. package/dist/__tests__/hdrp-pipeline-asset-type.test-d.d.ts +0 -2
  502. package/dist/__tests__/hdrp-pipeline-asset-type.test-d.d.ts.map +0 -1
  503. package/dist/__tests__/hdrp-ssao-boundary.test.d.ts +0 -2
  504. package/dist/__tests__/hdrp-ssao-boundary.test.d.ts.map +0 -1
  505. package/dist/__tests__/hdrp-ssao-falsification.test.d.ts +0 -2
  506. package/dist/__tests__/hdrp-ssao-falsification.test.d.ts.map +0 -1
  507. package/dist/__tests__/helpers/primitive-world.d.ts +0 -8
  508. package/dist/__tests__/helpers/primitive-world.d.ts.map +0 -1
  509. package/dist/__tests__/helpers/render-asset-port.d.ts +0 -15
  510. package/dist/__tests__/helpers/render-asset-port.d.ts.map +0 -1
  511. package/dist/__tests__/helpers/scene-asset-port.d.ts +0 -9
  512. package/dist/__tests__/helpers/scene-asset-port.d.ts.map +0 -1
  513. package/dist/__tests__/material-derived-coordinates.integration.test.d.ts +0 -2
  514. package/dist/__tests__/material-derived-coordinates.integration.test.d.ts.map +0 -1
  515. package/dist/__tests__/pipeline-layout-selection.test.d.ts +0 -2
  516. package/dist/__tests__/pipeline-layout-selection.test.d.ts.map +0 -1
  517. package/dist/__tests__/post-process-reads-narrowing.test-d.d.ts +0 -2
  518. package/dist/__tests__/post-process-reads-narrowing.test-d.d.ts.map +0 -1
  519. package/dist/__tests__/post-process-register-roundtrip.dawn.test.d.ts +0 -2
  520. package/dist/__tests__/post-process-register-roundtrip.dawn.test.d.ts.map +0 -1
  521. package/dist/__tests__/render-feature-zero-feature.browser.test.d.ts +0 -2
  522. package/dist/__tests__/render-feature-zero-feature.browser.test.d.ts.map +0 -1
  523. package/dist/__tests__/render-pipeline-trivial.dawn.test.d.ts +0 -2
  524. package/dist/__tests__/render-pipeline-trivial.dawn.test.d.ts.map +0 -1
  525. package/dist/__tests__/shadow-csm-caster-membership.test.d.ts +0 -2
  526. package/dist/__tests__/shadow-csm-caster-membership.test.d.ts.map +0 -1
  527. package/dist/__tests__/shadow-csm-pssm.test.d.ts +0 -2
  528. package/dist/__tests__/shadow-csm-pssm.test.d.ts.map +0 -1
  529. package/dist/__tests__/shadow-csm-temporal.browser.test.d.ts +0 -2
  530. package/dist/__tests__/shadow-csm-temporal.browser.test.d.ts.map +0 -1
  531. package/dist/__tests__/shadow-csm-viewport.test.d.ts +0 -2
  532. package/dist/__tests__/shadow-csm-viewport.test.d.ts.map +0 -1
  533. package/dist/__tests__/shadow-m2.dawn.test.d.ts +0 -2
  534. package/dist/__tests__/shadow-m2.dawn.test.d.ts.map +0 -1
  535. package/dist/__tests__/shadow-m3-calibrate-run.dawn.test.d.ts +0 -2
  536. package/dist/__tests__/shadow-m3-calibrate-run.dawn.test.d.ts.map +0 -1
  537. package/dist/__tests__/shadow-m3-calibrate.d.ts +0 -83
  538. package/dist/__tests__/shadow-m3-calibrate.d.ts.map +0 -1
  539. package/dist/__tests__/shadow-m3.dawn.test.d.ts +0 -2
  540. package/dist/__tests__/shadow-m3.dawn.test.d.ts.map +0 -1
  541. package/dist/__tests__/shadow-probe-control-flow.dawn.test.d.ts +0 -2
  542. package/dist/__tests__/shadow-probe-control-flow.dawn.test.d.ts.map +0 -1
  543. package/dist/__tests__/shadow-quality-metrics.dawn.test.d.ts +0 -2
  544. package/dist/__tests__/shadow-quality-metrics.dawn.test.d.ts.map +0 -1
  545. package/dist/__tests__/temporal-off-path.unit.test.d.ts +0 -2
  546. package/dist/__tests__/temporal-off-path.unit.test.d.ts.map +0 -1
  547. package/dist/__tests__/video-cache-regression.unit.test.d.ts +0 -2
  548. package/dist/__tests__/video-cache-regression.unit.test.d.ts.map +0 -1
  549. package/dist/asset-kind.d.ts +0 -4
  550. package/dist/asset-kind.d.ts.map +0 -1
  551. package/dist/errors/sprite-animation.d.ts +0 -3
  552. package/dist/errors/sprite-animation.d.ts.map +0 -1
  553. package/dist/scene-asset-port.d.ts +0 -17
  554. package/dist/scene-asset-port.d.ts.map +0 -1
  555. package/dist/scene-collect-errors.d.ts +0 -22
  556. package/dist/scene-collect-errors.d.ts.map +0 -1
  557. package/dist/shadow-m3-calibrate.d.ts +0 -40
  558. package/dist/shadow-m3-calibrate.d.ts.map +0 -1
  559. package/src/__tests__/bind-group-cache-binding.test.ts +0 -2513
  560. package/src/__tests__/bind-group-cache-frame.test.ts +0 -1511
  561. package/src/__tests__/dispatch-fullscreen-pass-composite-swapchain.dawn.test.ts +0 -204
  562. package/src/__tests__/dispatch-fullscreen-pass-custom-reads.dawn.test.ts +0 -297
  563. package/src/__tests__/dispatch-fullscreen-pass-depth-composite.dawn.test.ts +0 -271
  564. package/src/__tests__/dispatch-fullscreen-pass-params.unit.test.ts +0 -321
  565. package/src/__tests__/fog-producer-manifest.ts +0 -162
  566. package/src/__tests__/fog-producer-pixel-probe.ts +0 -263
  567. package/src/__tests__/fog-producer-pixel.browser.test.ts +0 -26
  568. package/src/__tests__/fog-producer-pixel.dawn.test.ts +0 -55
  569. package/src/__tests__/fog-producer-real-fixture.ts +0 -805
  570. package/src/__tests__/fog-producer-vfx-effect.ts +0 -272
  571. package/src/__tests__/fog-scene-asset.integration.test.ts +0 -123
  572. package/src/__tests__/gpu-resource-store-cubemap-status.test.ts +0 -207
  573. package/src/__tests__/gpu-resource.test.ts +0 -1206
  574. package/src/__tests__/hdrp-bgl-slots.browser.test.ts +0 -50
  575. package/src/__tests__/hdrp-buffers.unit.test.ts +0 -70
  576. package/src/__tests__/hdrp-execute-filter.unit.test.ts +0 -200
  577. package/src/__tests__/hdrp-gbuffer-attachments.browser.test.ts +0 -64
  578. package/src/__tests__/hdrp-pipeline-asset-type.test-d.ts +0 -139
  579. package/src/__tests__/hdrp-ssao-boundary.test.ts +0 -237
  580. package/src/__tests__/hdrp-ssao-falsification.test.ts +0 -289
  581. package/src/__tests__/helpers/primitive-world.ts +0 -91
  582. package/src/__tests__/helpers/render-asset-port.ts +0 -65
  583. package/src/__tests__/helpers/scene-asset-port.ts +0 -23
  584. package/src/__tests__/material-derived-coordinates.integration.test.ts +0 -100
  585. package/src/__tests__/pipeline-layout-selection.test.ts +0 -298
  586. package/src/__tests__/post-process-reads-narrowing.test-d.ts +0 -52
  587. package/src/__tests__/post-process-register-roundtrip.dawn.test.ts +0 -230
  588. package/src/__tests__/render-feature-zero-feature.browser.test.ts +0 -152
  589. package/src/__tests__/render-pipeline-trivial.dawn.test.ts +0 -525
  590. package/src/__tests__/shadow-csm-caster-membership.test.ts +0 -232
  591. package/src/__tests__/shadow-csm-pssm.test.ts +0 -142
  592. package/src/__tests__/shadow-csm-temporal.browser.test.ts +0 -145
  593. package/src/__tests__/shadow-csm-viewport.test.ts +0 -74
  594. package/src/__tests__/shadow-m2.dawn.test.ts +0 -394
  595. package/src/__tests__/shadow-m3-calibrate-run.dawn.test.ts +0 -248
  596. package/src/__tests__/shadow-m3-calibrate.ts +0 -203
  597. package/src/__tests__/shadow-m3.dawn.test.ts +0 -288
  598. package/src/__tests__/shadow-probe-control-flow.dawn.test.ts +0 -264
  599. package/src/__tests__/shadow-quality-metrics.dawn.test.ts +0 -324
  600. package/src/__tests__/temporal-off-path.unit.test.ts +0 -69
  601. package/src/__tests__/video-cache-regression.unit.test.ts +0 -186
  602. package/src/asset-kind.ts +0 -7
  603. package/src/errors/sprite-animation.ts +0 -5
  604. package/src/scene-asset-port.ts +0 -32
  605. package/src/scene-collect-errors.ts +0 -30
  606. package/src/shadow-m3-calibrate.ts +0 -171
@@ -1,361 +1,104 @@
1
- import { World } from '@forgeax/engine-ecs';
2
- import type {
3
- RenderFeature,
4
- RenderFeatureDrawRecord,
5
- RenderFeaturePreparedRef,
6
- RenderPipeline,
7
- } from '@forgeax/engine-render';
8
- import {
9
- Camera,
10
- createRenderFeatureTarget,
11
- createRenderPipelineTarget,
12
- RenderFeatureStageFailedError,
13
- } from '@forgeax/engine-render';
14
- import type { RhiDevice } from '@forgeax/engine-rhi';
15
1
  import { rhi } from '@forgeax/engine-rhi-null';
16
- import { Transform } from '@forgeax/engine-scene';
17
- import { err, ok } from '@forgeax/engine-types';
18
2
  import { describe, expect, it } from 'vitest';
19
- import { createRenderer } from '../createRenderer';
20
-
21
- const manifest = `data:application/json,${encodeURIComponent(
22
- JSON.stringify({
23
- schemaVersion: '1.0.0',
24
- entries: [
25
- { hash: 'pbr00000', wgsl: '/* pbr stub */', glsl: '', bindings: '' },
26
- { hash: 'unlit000', wgsl: '/* unlit stub */', glsl: '', bindings: '' },
27
- { hash: 'tonemap0', wgsl: '/* tonemap stub */', glsl: '', bindings: '' },
28
- ],
29
- materialShaders: [
30
- {
31
- identifier: 'forgeax::default-standard-pbr',
32
- sourcePath: 'forgeax::default-standard-pbr.wgsl',
33
- composedWgsl: '/* stub */',
34
- paramSchema: '[]',
35
- variants: [],
36
- },
37
- {
38
- identifier: 'forgeax::default-unlit',
39
- sourcePath: 'forgeax::default-unlit.wgsl',
40
- composedWgsl: '/* stub */',
41
- paramSchema: '[]',
42
- variants: [],
43
- },
44
- ],
45
- }),
46
- )}`;
3
+ import { constructRendererHost } from '../../../render/src/construct-renderer';
4
+ import {
5
+ frameRequest,
6
+ type PreparedFeatureMode,
7
+ preparedFeature,
8
+ preparedManifest,
9
+ preparedWorld,
10
+ } from './render-feature-prepared-graphics.fixture';
47
11
 
48
12
  function canvas(): HTMLCanvasElement {
49
- return {
50
- width: 64,
51
- height: 64,
52
- getContext: () => null,
53
- addEventListener: () => undefined,
54
- removeEventListener: () => undefined,
55
- } as unknown as HTMLCanvasElement;
56
- }
57
-
58
- function observeDrawCalls(device: RhiDevice): () => number {
59
- let count = 0;
60
- const createCommandEncoder = device.createCommandEncoder.bind(device);
61
- device.createCommandEncoder = (descriptor) => {
62
- const result = createCommandEncoder(descriptor);
63
- if (!result.ok) return result;
64
- const encoder = result.value;
65
- const beginRenderPass = encoder.beginRenderPass.bind(encoder);
66
- encoder.beginRenderPass = (passDescriptor) => {
67
- const pass = beginRenderPass(passDescriptor);
68
- const draw = pass.draw.bind(pass);
69
- const drawIndexed = pass.drawIndexed.bind(pass);
70
- pass.draw = (...args) => {
71
- count += 1;
72
- draw(...args);
73
- };
74
- pass.drawIndexed = (...args) => {
75
- count += 1;
76
- drawIndexed(...args);
77
- };
78
- return pass;
79
- };
80
- return result;
81
- };
82
- return () => count;
83
- }
84
-
85
- function pipeline(): RenderPipeline {
86
- return {
87
- build: ({ graph, contributeFeatures }) => {
88
- const scene = createRenderPipelineTarget(graph, 'prepared-scene', {
89
- format: 'rgba8unorm',
90
- size: 'surface',
91
- });
92
- if (!scene.ok) return scene;
93
- const base = graph.addRasterPass('base', {
94
- accesses: [{ resource: scene.value.view, usage: 'color-attachment' }],
95
- colorAttachments: [
96
- {
97
- view: scene.value.view,
98
- loadOp: 'clear',
99
- storeOp: 'store',
100
- clearValue: { r: 0, g: 0, b: 0, a: 1 },
101
- },
102
- ],
103
- encode: () => undefined,
104
- });
105
- if (!base.ok) return base;
106
- return contributeFeatures([
107
- {
108
- kind: 'scene-color',
109
- texture: scene.value.texture,
110
- view: scene.value.view,
111
- format: scene.value.format,
112
- sampleCount: 1,
113
- },
114
- ]);
115
- },
116
- };
117
- }
118
-
119
- function world(): World {
120
- const value = new World();
121
- value.spawn(
122
- { component: Transform, data: { pos: [0, 0, 3], quat: [0, 0, 0, 1], scale: [1, 1, 1] } },
123
- { component: Camera, data: { fov: Math.PI / 4, aspect: 1, near: 0.1, far: 100 } },
124
- );
125
- return value;
126
- }
127
-
128
- type MatrixCase = 'accepted' | 'mismatch' | 'empty' | 'multi-feature' | 'recovery';
129
-
130
- interface MatrixResult {
131
- readonly case: MatrixCase;
132
- readonly drawCount: number;
133
- readonly featureStatuses: readonly string[];
134
- readonly errorCodes: readonly string[];
135
- readonly passNames: readonly string[];
136
- }
137
-
138
- interface FeatureState {
139
- pipeline: RenderFeaturePreparedRef<'pipeline'> | undefined;
140
- bindings: RenderFeaturePreparedRef<'bindings'> | undefined;
141
- vertices: RenderFeaturePreparedRef<'vertex-data'> | undefined;
142
- firstContribution: boolean;
13
+ return { width: 64, height: 64, getContext: () => null } as unknown as HTMLCanvasElement;
143
14
  }
144
15
 
145
- function graphicsFeature(
146
- identity: string,
147
- state: FeatureState,
148
- mode: Exclude<MatrixCase, 'multi-feature'>,
149
- ): RenderFeature<{ readonly draw: boolean }> {
150
- return {
151
- identity,
152
- extract: () => ok({ draw: mode !== 'empty' }),
153
- prepare: (_data, context) => {
154
- const pipelineResult = context.graphics.preparePipeline('forward', {
155
- shader: 'synthetic.unlit',
156
- vertexLayout: 'position',
157
- colorFormats: ['rgba8unorm'],
158
- });
159
- if (!pipelineResult.ok) return pipelineResult;
160
- const bindingsResult = context.graphics.prepareBindings('forward', {
161
- pipeline: pipelineResult.value,
162
- values: { opacity: 1 },
163
- });
164
- if (!bindingsResult.ok) return bindingsResult;
165
- const verticesResult = context.graphics.prepareVertexData('triangle', {
166
- layout: 'position',
167
- data: new Float32Array([0, 0, 0]),
168
- });
169
- if (!verticesResult.ok) return verticesResult;
170
- state.pipeline = pipelineResult.value;
171
- state.bindings = bindingsResult.value;
172
- state.vertices = verticesResult.value;
173
- return ok(undefined);
174
- },
175
- contribute: (data, context) => {
176
- if (!data.draw) return ok(undefined);
177
- const { pipeline: preparedPipeline, bindings, vertices } = state;
178
- if (preparedPipeline === undefined || bindings === undefined || vertices === undefined) {
179
- return err(new RenderFeatureStageFailedError(identity, 0, 'contribute', 'next-frame'));
180
- }
181
- const drawPipeline =
182
- mode === 'mismatch' || (mode === 'recovery' && state.firstContribution)
183
- ? { kind: 'pipeline' as const, generation: 99 }
184
- : preparedPipeline;
185
- state.firstContribution = false;
186
- const draw: RenderFeatureDrawRecord = {
187
- kind: 'draw',
188
- pipeline: drawPipeline,
189
- bindings: [bindings],
190
- vertexData: [{ slot: 0, resource: vertices }],
191
- command: { vertexCount: 3, instanceCount: 1 },
192
- };
193
- return context.staging.addGraphicsPass('forward', {
194
- attachments: {
195
- colors: [
196
- {
197
- resource: createRenderFeatureTarget({
198
- kind: 'scene-color',
199
- format: 'rgba8unorm',
200
- sampleCount: 1,
201
- }),
202
- format: 'rgba8unorm',
203
- loadOp: 'load',
204
- storeOp: 'store',
205
- },
206
- ],
207
- },
208
- draws: [draw],
209
- });
210
- },
211
- };
16
+ function rootErrorCode(value: unknown): string {
17
+ let error = value as { code: string; detail?: unknown };
18
+ while (error.detail !== undefined && typeof error.detail === 'object' && error.detail !== null) {
19
+ const cause = (error.detail as { cause?: unknown }).cause;
20
+ if (
21
+ cause === undefined ||
22
+ typeof cause !== 'object' ||
23
+ cause === null ||
24
+ typeof (cause as { code?: unknown }).code !== 'string'
25
+ ) {
26
+ break;
27
+ }
28
+ error = cause as { code: string; detail?: unknown };
29
+ }
30
+ return error.code;
212
31
  }
213
32
 
214
- async function rendererWith(
215
- features: readonly RenderFeature<{ readonly draw: boolean }>[],
216
- ): Promise<Awaited<ReturnType<typeof createRenderer>>> {
217
- const renderer = await createRenderer(
33
+ async function runCase(mode: PreparedFeatureMode) {
34
+ const host = await constructRendererHost(
218
35
  canvas(),
219
- { rhi, features },
220
- { shaderManifestUrl: manifest },
36
+ { rhi, features: [preparedFeature(`synthetic.${mode}`, mode)] },
37
+ { shaderManifestUrl: preparedManifest },
221
38
  );
222
- renderer.registerPipeline('synthetic::regression', pipeline());
223
- expect(
224
- renderer.installPipeline({ kind: 'render-pipeline', pipelineId: 'synthetic::regression' }).ok,
225
- ).toBe(true);
226
- expect((await renderer.ready).ok).toBe(true);
227
- return renderer;
228
- }
229
-
230
- async function runCase(
231
- name: Exclude<MatrixCase, 'multi-feature'>,
232
- feature = graphicsFeature(
233
- `synthetic.${name}`,
234
- {
235
- pipeline: undefined,
236
- bindings: undefined,
237
- vertices: undefined,
238
- firstContribution: true,
239
- },
240
- name,
241
- ),
242
- ): Promise<MatrixResult> {
243
- const renderer = await rendererWith([feature]);
244
- const drawCount = observeDrawCalls(renderer.device);
245
- const activeWorld = world();
246
- const attachment = renderer.attachWorld(activeWorld);
247
- if (!attachment.ok) throw attachment.error;
248
- activeWorld.update().unwrap();
249
- const result = renderer.draw([activeWorld], { cameraOwner: 0, resourceOwner: 0 });
250
- const firstDiagnostics = renderer.renderFeatureDiagnostics();
251
- let featureStatuses = firstDiagnostics.map((diagnostic) => diagnostic.status);
252
- const first: MatrixResult = {
253
- case: name,
254
- drawCount: drawCount(),
255
- featureStatuses,
256
- errorCodes: firstDiagnostics.flatMap((diagnostic) =>
257
- diagnostic.latestError === undefined ? [] : [diagnostic.latestError.code],
258
- ),
259
- passNames: [...renderer.perFramePassNames],
260
- };
261
- expect(result.ok).toBe(true);
262
- if (name === 'recovery') {
263
- activeWorld.update().unwrap();
264
- expect(renderer.draw([activeWorld], { cameraOwner: 0, resourceOwner: 0 }).ok).toBe(true);
265
- featureStatuses = renderer.renderFeatureDiagnostics().map((diagnostic) => diagnostic.status);
39
+ expect(host.ok).toBe(true);
40
+ if (!host.ok) return { frame: host, errors: [] as string[] };
41
+ const errors: string[] = [];
42
+ host.value.renderer.subscribe((event) => {
43
+ if (event.kind === 'error') errors.push(rootErrorCode(event.error));
44
+ });
45
+ const world = preparedWorld();
46
+ const attached = host.value.renderer.attach(world);
47
+ expect(attached.ok).toBe(true);
48
+ if (!attached.ok) return { frame: attached, errors };
49
+ expect(world.update().ok).toBe(true);
50
+ const first = host.value.renderer.draw(frameRequest(attached.value));
51
+ if (first.ok) await first.value.completed;
52
+ if (mode === 'recovery') {
53
+ expect(world.update().ok).toBe(true);
54
+ expect(host.value.renderer.draw(frameRequest(attached.value)).ok).toBe(true);
266
55
  }
267
- renderer.dispose();
268
- return { ...first, featureStatuses };
56
+ host.value.renderer.dispose();
57
+ return { frame: first, errors: errors.filter((code) => code.startsWith('render-feature-')) };
269
58
  }
270
59
 
271
- describe('prepared graphics full-stack regression matrix', () => {
272
- it('emits machine-readable accepted, mismatch, empty, and recovery cases', async () => {
60
+ describe('prepared graphics state-machine regression', () => {
61
+ it('isolates accepted, empty, mismatch, and next-frame recovery cases', async () => {
273
62
  const accepted = await runCase('accepted');
274
- const mismatch = await runCase('mismatch');
275
63
  const empty = await runCase('empty');
64
+ const mismatch = await runCase('mismatch');
276
65
  const recovery = await runCase('recovery');
277
66
 
278
- expect([accepted, mismatch, empty, recovery]).toEqual([
279
- expect.objectContaining({
280
- case: 'accepted',
281
- featureStatuses: ['active'],
282
- errorCodes: [],
283
- }),
284
- expect.objectContaining({
285
- case: 'mismatch',
286
- featureStatuses: ['failed'],
287
- errorCodes: ['render-feature-prepared-state-mismatch'],
288
- drawCount: 0,
289
- }),
290
- expect.objectContaining({
291
- case: 'empty',
292
- featureStatuses: ['active'],
293
- errorCodes: [],
294
- drawCount: 0,
295
- }),
296
- expect.objectContaining({
297
- case: 'recovery',
298
- featureStatuses: ['active'],
299
- errorCodes: ['render-feature-prepared-state-mismatch'],
300
- }),
301
- ]);
67
+ expect(accepted.frame.ok).toBe(true);
68
+ expect(accepted.errors).not.toContain('render-feature-prepared-state-mismatch');
69
+ expect(empty.frame.ok).toBe(true);
70
+ expect(empty.errors).toEqual([]);
71
+ expect(mismatch.frame.ok).toBe(true);
72
+ expect(mismatch.errors).toContain('render-feature-stage-failed');
73
+ expect(recovery.frame.ok).toBe(true);
74
+ expect(recovery.errors).toContain('render-feature-stage-failed');
302
75
  });
303
76
 
304
- it('isolates one failed feature while retaining another feature and the base graph', async () => {
305
- const healthyState: FeatureState = {
306
- pipeline: undefined,
307
- bindings: undefined,
308
- vertices: undefined,
309
- firstContribution: true,
310
- };
311
- const failingState: FeatureState = {
312
- pipeline: undefined,
313
- bindings: undefined,
314
- vertices: undefined,
315
- firstContribution: true,
316
- };
317
- const renderer = await rendererWith([
318
- graphicsFeature('synthetic.healthy', healthyState, 'accepted'),
319
- graphicsFeature('synthetic.failing', failingState, 'mismatch'),
320
- ]);
321
- const drawCount = observeDrawCalls(renderer.device);
322
- const activeWorld = world();
323
- const attachment = renderer.attachWorld(activeWorld);
324
- if (!attachment.ok) throw attachment.error;
325
- activeWorld.update().unwrap();
326
- const result = renderer.draw([activeWorld], { cameraOwner: 0, resourceOwner: 0 });
327
- const diagnostics = renderer.renderFeatureDiagnostics();
328
-
329
- expect(result.ok).toBe(true);
330
- expect(diagnostics.map((diagnostic) => diagnostic.status)).toEqual(['active', 'failed']);
331
- expect(diagnostics[1]?.latestError?.code).toBe('render-feature-prepared-state-mismatch');
332
- expect(renderer.perFramePassNames).toContain('synthetic.healthy::forward');
333
- expect(renderer.perFramePassNames).not.toContain('synthetic.failing::forward');
334
- expect(drawCount()).toBe(1);
335
- renderer.dispose();
336
- });
337
-
338
- it('keeps an unregistered feature identical to the baseline renderer path', async () => {
339
- const renderer = await rendererWith([]);
340
- const drawCount = observeDrawCalls(renderer.device);
341
- let submits = 0;
342
- const submit = renderer.device.queue.submit.bind(renderer.device.queue);
343
- renderer.device.queue.submit = (buffers) => {
344
- submits += 1;
345
- return submit(buffers);
346
- };
347
-
348
- const activeWorld = world();
349
- const attachment = renderer.attachWorld(activeWorld);
350
- if (!attachment.ok) throw attachment.error;
351
- activeWorld.update().unwrap();
352
- const result = renderer.draw([activeWorld], { cameraOwner: 0, resourceOwner: 0 });
353
-
354
- expect(result.ok).toBe(true);
355
- expect(renderer.renderFeatureDiagnostics()).toEqual([]);
356
- expect(renderer.perFramePassNames).toEqual(['base']);
357
- expect(drawCount()).toBe(0);
358
- expect(submits).toBe(1);
359
- renderer.dispose();
77
+ it('keeps a healthy feature producing a frame when a sibling fails preparation state', async () => {
78
+ const host = await constructRendererHost(
79
+ canvas(),
80
+ {
81
+ rhi,
82
+ features: [
83
+ preparedFeature('synthetic.healthy', 'accepted'),
84
+ preparedFeature('synthetic.failing', 'mismatch'),
85
+ ],
86
+ },
87
+ { shaderManifestUrl: preparedManifest },
88
+ );
89
+ expect(host.ok).toBe(true);
90
+ if (!host.ok) return;
91
+ const errors: string[] = [];
92
+ host.value.renderer.subscribe((event) => {
93
+ if (event.kind === 'error') errors.push(rootErrorCode(event.error));
94
+ });
95
+ const world = preparedWorld();
96
+ const attached = host.value.renderer.attach(world);
97
+ expect(attached.ok).toBe(true);
98
+ if (!attached.ok) return;
99
+ expect(world.update().ok).toBe(true);
100
+ expect(host.value.renderer.draw(frameRequest(attached.value)).ok).toBe(true);
101
+ expect(errors).toContain('render-feature-stage-failed');
102
+ host.value.renderer.dispose();
360
103
  });
361
104
  });
@@ -1,13 +1,9 @@
1
1
  import type { RenderFeature } from '@forgeax/engine-render';
2
- import {
3
- createRenderFeatureHost,
4
- RenderFeatureCapabilityMissingError,
5
- RenderFeatureStageFailedError,
6
- runRenderFeatureFrame,
7
- } from '@forgeax/engine-render/internal';
8
2
  import type { RhiCaps } from '@forgeax/engine-rhi';
9
3
  import { ok } from '@forgeax/engine-types';
10
4
  import { describe, expect, it } from 'vitest';
5
+ import { RenderFeatureStageFailedError } from '../../../render/src/errors/render';
6
+ import { createRenderFeatureHost, runRenderFeatureFrame } from '../../../render/src/features/host';
11
7
 
12
8
  const caps = (compute: boolean): Readonly<RhiCaps> => ({ compute }) as unknown as RhiCaps;
13
9
 
@@ -19,17 +15,9 @@ function recoverableFeature(calls: string[]): RenderFeature<{ readonly frame: nu
19
15
  calls.push(`extract:${frameNumber}`);
20
16
  return ok({ frame: frameNumber });
21
17
  },
22
- prepare: (data) => {
23
- calls.push(`prepare:${data.frame}`);
24
- return ok(undefined);
25
- },
26
- contribute: (data) => {
27
- calls.push(`contribute:${data.frame}`);
28
- return ok(undefined);
29
- },
30
- recover: ({ frame }) => {
31
- calls.push(`recover:${frame.frameNumber}`);
32
- return ok(undefined);
18
+ plan: (data) => {
19
+ calls.push(`plan:${data.frame}`);
20
+ return ok({ resources: [], passes: [] });
33
21
  },
34
22
  };
35
23
  }
@@ -45,11 +33,7 @@ describe('render feature recovery lifecycle', () => {
45
33
  frameNumber: 1,
46
34
  caps: caps(true),
47
35
  });
48
- expect(first.stageEvents.map((event) => event.stage)).toEqual([
49
- 'extract',
50
- 'prepare',
51
- 'contribute',
52
- ]);
36
+ expect(first.stageEvents.map((event) => event.stage)).toEqual(['extract', 'plan']);
53
37
 
54
38
  host.setStatus(
55
39
  'synthetic.recoverable',
@@ -63,7 +47,7 @@ describe('render feature recovery lifecycle', () => {
63
47
  caps: caps(true),
64
48
  });
65
49
  expect(retry.errors).toEqual([]);
66
- expect(calls.slice(-3)).toEqual(['extract:2', 'prepare:2', 'contribute:2']);
50
+ expect(calls.slice(-2)).toEqual(['extract:2', 'plan:2']);
67
51
 
68
52
  host.setStatus('synthetic.recoverable', 'disabled');
69
53
  const skipped = runRenderFeatureFrame(host, {
@@ -76,7 +60,7 @@ describe('render feature recovery lifecycle', () => {
76
60
 
77
61
  const recovered = host.recover({ frameNumber: 4, caps: caps(true) });
78
62
  expect(recovered).toEqual(ok(undefined));
79
- expect(calls.at(-1)).toBe('recover:4');
63
+ expect(calls.at(-1)).toBe('plan:2');
80
64
 
81
65
  const resumed = runRenderFeatureFrame(host, {
82
66
  worlds: [],
@@ -85,7 +69,7 @@ describe('render feature recovery lifecycle', () => {
85
69
  caps: caps(true),
86
70
  });
87
71
  expect(resumed.errors).toEqual([]);
88
- expect(resumed.stageEvents).toHaveLength(3);
72
+ expect(resumed.stageEvents).toHaveLength(2);
89
73
  });
90
74
 
91
75
  it('keeps registration through a pipeline switch and makes dispose terminal', () => {
@@ -115,28 +99,4 @@ describe('render feature recovery lifecycle', () => {
115
99
  ).toEqual([]);
116
100
  expect(calls).toEqual([]);
117
101
  });
118
-
119
- it('reports unsupported GPU capability as a structured fault and keeps the CPU lane available', () => {
120
- const calls: string[] = [];
121
- const host = createRenderFeatureHost([recoverableFeature(calls)], caps(false)).unwrap();
122
-
123
- const frame = runRenderFeatureFrame(host, {
124
- worlds: [],
125
- owner: 0,
126
- frameNumber: 7,
127
- caps: caps(false),
128
- });
129
-
130
- expect(frame.stageEvents).toEqual([]);
131
- expect(frame.errors).toHaveLength(1);
132
- const error = frame.errors[0];
133
- expect(error).toMatchObject({
134
- code: 'render-feature-capability-missing',
135
- expected: expect.stringContaining("device capability 'compute'"),
136
- hint: expect.stringContaining('compute'),
137
- detail: { capability: 'compute' },
138
- });
139
- expect(calls).toEqual([]);
140
- expect(error).toBeInstanceOf(RenderFeatureCapabilityMissingError);
141
- });
142
102
  });
@@ -1,11 +1,7 @@
1
- import type {
2
- Renderer,
3
- RendererOptions,
4
- RenderFeature,
5
- RenderFeatureDiagnostics,
6
- } from '@forgeax/engine-render';
7
- import { ok } from '@forgeax/engine-types';
8
- import { createRenderer } from '../createRenderer';
1
+ import type { RenderError, Renderer, RendererOptions, RenderFeature } from '@forgeax/engine-render';
2
+ import type { EngineEnvironmentError } from '@forgeax/engine-runtime';
3
+ import { ok, type Result } from '@forgeax/engine-types';
4
+ import { createRenderer } from '../index';
9
5
 
10
6
  type FrameData = {
11
7
  readonly visibleCount: number;
@@ -16,27 +12,28 @@ const feature = {
16
12
  extract({ owner }) {
17
13
  return ok<FrameData>({ visibleCount: owner });
18
14
  },
19
- prepare(data: FrameData) {
15
+ plan(data: FrameData) {
20
16
  const count: number = data.visibleCount;
21
17
  void count;
22
- return ok(undefined);
23
- },
24
- contribute(data: FrameData) {
25
- const count: number = data.visibleCount;
26
- void count;
27
- return ok(undefined);
18
+ return ok({ resources: [], passes: [] });
28
19
  },
29
20
  } satisfies RenderFeature<FrameData>;
30
21
 
31
22
  declare const canvas: HTMLCanvasElement;
32
23
 
33
24
  const options: RendererOptions = { features: [feature] };
34
- const rendererPromise: Promise<Renderer> = createRenderer(canvas, options);
35
- const diagnostics = (renderer: Renderer): readonly RenderFeatureDiagnostics[] =>
36
- renderer.renderFeatureDiagnostics();
37
-
25
+ const rendererPromise: Promise<Result<Renderer, EngineEnvironmentError | RenderError>> =
26
+ createRenderer(canvas, options);
38
27
  void rendererPromise;
39
- void diagnostics;
28
+ declare const renderer: Renderer;
29
+ // The public contract is feature input plus receipt/observe; diagnostics and
30
+ // per-frame pass lists remain implementation-owned.
31
+ // @ts-expect-error renderer diagnostics are not public
32
+ renderer.renderFeatureDiagnostics();
33
+ // @ts-expect-error per-frame pass names are not public
34
+ renderer.perFramePassNames;
35
+ // @ts-expect-error raw readback is owned by Dawn/browser harnesses
36
+ renderer.readPixels();
40
37
 
41
38
  // Runtime owns assembly; its public factory does not expose the internal host.
42
39
  // @ts-expect-error the feature host is private to engine-render
@@ -1,20 +1,27 @@
1
- import {
2
- Camera,
3
- DirectionalLight,
4
- MeshFilter,
5
- orthographic,
6
- prepareRenderSchemas,
7
- readRenderSchemas,
8
- } from '@forgeax/engine-render/internal';
1
+ import { Camera, DirectionalLight, MeshFilter, orthographic } from '@forgeax/engine-render';
9
2
  import { describe, expect, it } from 'vitest';
10
3
 
4
+ function prepareRenderSchemas(frame: {
5
+ readonly mesh: { readonly assetHandle: number };
6
+ readonly light: { readonly direction: Float32Array; readonly intensity: number };
7
+ readonly camera: { readonly projection: number; readonly near: number; readonly far: number };
8
+ }) {
9
+ return {
10
+ meshAssetHandle: frame.mesh.assetHandle,
11
+ lightDirection: frame.light.direction,
12
+ cameraProjection: frame.camera.projection,
13
+ cameraNear: frame.camera.near,
14
+ cameraFar: frame.camera.far,
15
+ };
16
+ }
17
+
11
18
  describe('runtime render schema consumer', () => {
12
19
  it('reads canonical render fields without adapters or casts', () => {
13
- const row = readRenderSchemas(
14
- { assetHandle: 3 },
15
- { direction: new Float32Array([0, -1, 0]), intensity: 2 },
16
- orthographic({ left: -1, right: 1, bottom: -1, top: 1, near: 0.1, far: 10 }),
17
- );
20
+ const row = {
21
+ mesh: { assetHandle: 3 },
22
+ light: { direction: new Float32Array([0, -1, 0]), intensity: 2 },
23
+ camera: orthographic({ left: -1, right: 1, bottom: -1, top: 1, near: 0.1, far: 10 }),
24
+ };
18
25
  const prepared = prepareRenderSchemas(row);
19
26
  expect(prepared.meshAssetHandle).toBe(3);
20
27
  expect(prepared.cameraProjection).toBe(1);
@@ -1,12 +1,8 @@
1
1
  import { World } from '@forgeax/engine-ecs';
2
- import {
3
- Camera,
4
- extractFrame,
5
- perspective,
6
- prepareExtractContext,
7
- } from '@forgeax/engine-render/internal';
2
+ import { Camera, perspective } from '@forgeax/engine-render';
8
3
  import { propagateTransforms, Transform } from '@forgeax/engine-scene';
9
4
  import { describe, expect, it } from 'vitest';
5
+ import { extractFrame, prepareExtractContext } from '../../../render/src/render-system-extract';
10
6
 
11
7
  describe('render extract owner boundary', () => {
12
8
  it('joins render Camera with scene Transform in one world', () => {