@forgeax/engine-render 0.1.7 → 0.1.20

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 (777) hide show
  1. package/README.md +140 -2
  2. package/dist/.tsbuildinfo +1 -1
  3. package/dist/assembly/backend-contract.d.ts +12 -0
  4. package/dist/assembly/backend-contract.d.ts.map +1 -1
  5. package/dist/assembly/factory.d.ts +26 -5
  6. package/dist/assembly/factory.d.ts.map +1 -1
  7. package/dist/assembly/host-contract.d.ts +4 -0
  8. package/dist/assembly/host-contract.d.ts.map +1 -1
  9. package/dist/assembly/renderer-frame-transaction.d.ts +39 -0
  10. package/dist/assembly/renderer-frame-transaction.d.ts.map +1 -0
  11. package/dist/assembly/renderer-inspection.d.ts +22 -0
  12. package/dist/assembly/renderer-inspection.d.ts.map +1 -0
  13. package/dist/assembly/renderer-lifecycle.d.ts +4 -0
  14. package/dist/assembly/renderer-lifecycle.d.ts.map +1 -0
  15. package/dist/authoring.mjs +4 -2
  16. package/dist/authoring.mjs.map +1 -1
  17. package/dist/chunk-4XINDLAY.mjs +9404 -0
  18. package/dist/chunk-4XINDLAY.mjs.map +1 -0
  19. package/dist/chunk-CDTWTHZR.mjs +752 -0
  20. package/dist/chunk-CDTWTHZR.mjs.map +1 -0
  21. package/dist/chunk-FJ6P52EE.mjs +46 -0
  22. package/dist/chunk-FJ6P52EE.mjs.map +1 -0
  23. package/dist/chunk-JDWARUOI.mjs +44 -0
  24. package/dist/chunk-JDWARUOI.mjs.map +1 -0
  25. package/dist/chunk-M2MP4ZOU.mjs +73 -0
  26. package/dist/chunk-M2MP4ZOU.mjs.map +1 -0
  27. package/dist/chunk-PCHBPYML.mjs +385 -0
  28. package/dist/chunk-PCHBPYML.mjs.map +1 -0
  29. package/dist/chunk-RXZ3RGOU.mjs +53 -0
  30. package/dist/chunk-RXZ3RGOU.mjs.map +1 -0
  31. package/dist/{chunk-YEJIUW7D.mjs → chunk-TBQJOK2L.mjs} +356 -543
  32. package/dist/chunk-TBQJOK2L.mjs.map +1 -0
  33. package/dist/{chunk-CQXZC5XI.mjs → chunk-VFPLTKCU.mjs} +79 -69
  34. package/dist/chunk-VFPLTKCU.mjs.map +1 -0
  35. package/dist/components/atmosphere.d.ts +9 -0
  36. package/dist/components/atmosphere.d.ts.map +1 -0
  37. package/dist/components/camera.d.ts +2 -1
  38. package/dist/components/camera.d.ts.map +1 -1
  39. package/dist/components/fog.d.ts +8 -0
  40. package/dist/components/fog.d.ts.map +1 -0
  41. package/dist/components/index.d.ts +3 -0
  42. package/dist/components/index.d.ts.map +1 -1
  43. package/dist/components/light-helpers.d.ts.map +1 -1
  44. package/dist/components/motion-blur.d.ts +7 -0
  45. package/dist/components/motion-blur.d.ts.map +1 -0
  46. package/dist/components/spot-light.d.ts +12 -0
  47. package/dist/components/spot-light.d.ts.map +1 -1
  48. package/dist/construct-renderer.d.ts +2 -2
  49. package/dist/construct-renderer.d.ts.map +1 -1
  50. package/dist/construct-renderer.mjs +11146 -14507
  51. package/dist/construct-renderer.mjs.map +1 -1
  52. package/dist/device/device-scope.d.ts +4 -0
  53. package/dist/device/device-scope.d.ts.map +1 -1
  54. package/dist/device/gpu-residency.d.ts +19 -2
  55. package/dist/device/gpu-residency.d.ts.map +1 -1
  56. package/dist/environment/frame.d.ts +60 -0
  57. package/dist/environment/frame.d.ts.map +1 -0
  58. package/dist/environment/generation.d.ts +21 -0
  59. package/dist/environment/generation.d.ts.map +1 -0
  60. package/dist/environment/graph.d.ts +4 -0
  61. package/dist/environment/graph.d.ts.map +1 -0
  62. package/dist/environment/inspection.d.ts +48 -0
  63. package/dist/environment/inspection.d.ts.map +1 -0
  64. package/dist/environment/lifecycle.d.ts +39 -0
  65. package/dist/environment/lifecycle.d.ts.map +1 -0
  66. package/dist/environment/signature.d.ts +25 -0
  67. package/dist/environment/signature.d.ts.map +1 -0
  68. package/dist/errors/render.d.ts +204 -1
  69. package/dist/errors/render.d.ts.map +1 -1
  70. package/dist/extract/camera.d.ts +5 -0
  71. package/dist/extract/camera.d.ts.map +1 -0
  72. package/dist/extract/environment.d.ts +74 -0
  73. package/dist/extract/environment.d.ts.map +1 -0
  74. package/dist/extract/visibility.d.ts +1 -1
  75. package/dist/extract/visibility.d.ts.map +1 -1
  76. package/dist/features/host.d.ts +9 -2
  77. package/dist/features/host.d.ts.map +1 -1
  78. package/dist/features/motion-blur/motion-blur-feature.d.ts +16 -0
  79. package/dist/features/motion-blur/motion-blur-feature.d.ts.map +1 -0
  80. package/dist/features/motion-blur/motion-blur-params.d.ts +25 -0
  81. package/dist/features/motion-blur/motion-blur-params.d.ts.map +1 -0
  82. package/dist/features/plan.d.ts +17 -2
  83. package/dist/features/plan.d.ts.map +1 -1
  84. package/dist/features/prepared-gpu-work.d.ts +3 -1
  85. package/dist/features/prepared-gpu-work.d.ts.map +1 -1
  86. package/dist/features/prepared-graphics.d.ts +2 -1
  87. package/dist/features/prepared-graphics.d.ts.map +1 -1
  88. package/dist/features/render-graph-raster.d.ts +2 -1
  89. package/dist/features/render-graph-raster.d.ts.map +1 -1
  90. package/dist/features/targets.d.ts +3 -0
  91. package/dist/features/targets.d.ts.map +1 -1
  92. package/dist/features/types.d.ts +12 -0
  93. package/dist/features/types.d.ts.map +1 -1
  94. package/dist/fullscreen-post-process-pass.d.ts +7 -1
  95. package/dist/fullscreen-post-process-pass.d.ts.map +1 -1
  96. package/dist/gpu-scene.d.ts +2 -0
  97. package/dist/gpu-scene.d.ts.map +1 -1
  98. package/dist/gpu-usage.d.ts +2 -0
  99. package/dist/gpu-usage.d.ts.map +1 -1
  100. package/dist/ibl/skylight-bind-group.d.ts +5 -6
  101. package/dist/ibl/skylight-bind-group.d.ts.map +1 -1
  102. package/dist/index.d.ts +24 -7
  103. package/dist/index.d.ts.map +1 -1
  104. package/dist/index.mjs +6 -4
  105. package/dist/index.mjs.map +1 -1
  106. package/dist/inspection-types.d.ts +43 -1
  107. package/dist/inspection-types.d.ts.map +1 -1
  108. package/dist/internal.d.ts +2 -0
  109. package/dist/internal.d.ts.map +1 -1
  110. package/dist/internal.mjs +2 -0
  111. package/dist/light-buffer-layout.d.ts +20 -12
  112. package/dist/light-buffer-layout.d.ts.map +1 -1
  113. package/dist/materials.d.ts +22 -0
  114. package/dist/materials.d.ts.map +1 -1
  115. package/dist/pbr-pipeline.d.ts +16 -9
  116. package/dist/pbr-pipeline.d.ts.map +1 -1
  117. package/dist/pipeline/standard-forward-lane.d.ts.map +1 -1
  118. package/dist/pipeline/standard-pipeline.d.ts +3 -0
  119. package/dist/pipeline/standard-pipeline.d.ts.map +1 -1
  120. package/dist/pipeline/standard-post.d.ts +48 -0
  121. package/dist/pipeline/standard-post.d.ts.map +1 -0
  122. package/dist/pipeline/standard-profile.d.ts +12 -2
  123. package/dist/pipeline/standard-profile.d.ts.map +1 -1
  124. package/dist/pipeline-builder.d.ts +18 -0
  125. package/dist/pipeline-builder.d.ts.map +1 -1
  126. package/dist/pipeline-spec.d.ts.map +1 -1
  127. package/dist/plugin.d.ts.map +1 -1
  128. package/dist/record/frame-lighting.d.ts +2 -0
  129. package/dist/record/frame-lighting.d.ts.map +1 -1
  130. package/dist/record/frame-snapshot.d.ts +137 -6
  131. package/dist/record/frame-snapshot.d.ts.map +1 -1
  132. package/dist/record/frame-targets.d.ts.map +1 -1
  133. package/dist/record/frame.d.ts +6 -3
  134. package/dist/record/frame.d.ts.map +1 -1
  135. package/dist/record/gpu-timing.d.ts +32 -0
  136. package/dist/record/gpu-timing.d.ts.map +1 -0
  137. package/dist/record/main-pass-geometry.d.ts +11 -0
  138. package/dist/record/main-pass-geometry.d.ts.map +1 -1
  139. package/dist/record/main-pass-material.d.ts +9 -6
  140. package/dist/record/main-pass-material.d.ts.map +1 -1
  141. package/dist/record/main-pass-sprite-draws.d.ts +8 -1
  142. package/dist/record/main-pass-sprite-draws.d.ts.map +1 -1
  143. package/dist/record/main-pass.d.ts +2 -0
  144. package/dist/record/main-pass.d.ts.map +1 -1
  145. package/dist/record/mesh-ssbo.d.ts.map +1 -1
  146. package/dist/record/render-context.d.ts +81 -19
  147. package/dist/record/render-context.d.ts.map +1 -1
  148. package/dist/record/shadow-pass.d.ts.map +1 -1
  149. package/dist/record/skybox-post-pass.d.ts +1 -11
  150. package/dist/record/skybox-post-pass.d.ts.map +1 -1
  151. package/dist/record/typed-frame-graph.d.ts +36 -4
  152. package/dist/record/typed-frame-graph.d.ts.map +1 -1
  153. package/dist/record/view-ubo.d.ts +4 -1
  154. package/dist/record/view-ubo.d.ts.map +1 -1
  155. package/dist/render-contract.d.ts +157 -8
  156. package/dist/render-contract.d.ts.map +1 -1
  157. package/dist/render-data.d.ts +10 -6
  158. package/dist/render-data.d.ts.map +1 -1
  159. package/dist/render-graph-primitives.d.ts.map +1 -1
  160. package/dist/render-pipeline.d.ts +86 -6
  161. package/dist/render-pipeline.d.ts.map +1 -1
  162. package/dist/render-system-extract.d.ts +84 -8
  163. package/dist/render-system-extract.d.ts.map +1 -1
  164. package/dist/render-system.d.ts +30 -5
  165. package/dist/render-system.d.ts.map +1 -1
  166. package/dist/renderer-inspect.d.ts +29 -0
  167. package/dist/renderer-inspect.d.ts.map +1 -0
  168. package/dist/scene/render-scene.d.ts +36 -2
  169. package/dist/scene/render-scene.d.ts.map +1 -1
  170. package/dist/temporal/coverage.d.ts +42 -0
  171. package/dist/temporal/coverage.d.ts.map +1 -0
  172. package/dist/temporal/frame-coordinator.d.ts +99 -0
  173. package/dist/temporal/frame-coordinator.d.ts.map +1 -0
  174. package/dist/temporal/frame.d.ts +44 -0
  175. package/dist/temporal/frame.d.ts.map +1 -0
  176. package/dist/temporal/gpu.d.ts +39 -0
  177. package/dist/temporal/gpu.d.ts.map +1 -0
  178. package/dist/temporal/history.d.ts +37 -0
  179. package/dist/temporal/history.d.ts.map +1 -0
  180. package/dist/temporal/index.d.ts +7 -0
  181. package/dist/temporal/index.d.ts.map +1 -0
  182. package/dist/temporal/index.mjs +8 -0
  183. package/dist/temporal/index.mjs.map +1 -0
  184. package/dist/temporal/inspection.d.ts +36 -0
  185. package/dist/temporal/inspection.d.ts.map +1 -0
  186. package/dist/temporal/scene-data-catalog.d.ts +48 -0
  187. package/dist/temporal/scene-data-catalog.d.ts.map +1 -0
  188. package/dist/temporal/scene-data.d.ts +43 -0
  189. package/dist/temporal/scene-data.d.ts.map +1 -0
  190. package/dist/temporal/standard-scene-data.d.ts +61 -0
  191. package/dist/temporal/standard-scene-data.d.ts.map +1 -0
  192. package/dist/temporal/taa-history-resources.d.ts +22 -0
  193. package/dist/temporal/taa-history-resources.d.ts.map +1 -0
  194. package/dist/temporal/taa-history-store.d.ts +27 -0
  195. package/dist/temporal/taa-history-store.d.ts.map +1 -0
  196. package/dist/temporal/taa-resolve.d.ts +15 -0
  197. package/dist/temporal/taa-resolve.d.ts.map +1 -0
  198. package/dist/temporal/temporal-view.d.ts +40 -0
  199. package/dist/temporal/temporal-view.d.ts.map +1 -0
  200. package/dist/temporal/transaction.d.ts +9 -0
  201. package/dist/temporal/transaction.d.ts.map +1 -0
  202. package/dist/temporal/view.d.ts +56 -0
  203. package/dist/temporal/view.d.ts.map +1 -0
  204. package/dist/transmission/backdrop.d.ts +147 -0
  205. package/dist/transmission/backdrop.d.ts.map +1 -0
  206. package/dist/transmission/inspection.d.ts +57 -0
  207. package/dist/transmission/inspection.d.ts.map +1 -0
  208. package/dist/transmission/oracle.d.ts +42 -0
  209. package/dist/transmission/oracle.d.ts.map +1 -0
  210. package/dist/transmission/projection.d.ts +37 -0
  211. package/dist/transmission/projection.d.ts.map +1 -0
  212. package/dist/typed-render-graph-primitives.d.ts +30 -2
  213. package/dist/typed-render-graph-primitives.d.ts.map +1 -1
  214. package/dist/typed-shadow-atlas.d.ts +10 -0
  215. package/dist/typed-shadow-atlas.d.ts.map +1 -0
  216. package/dist/typed-shadow-passes.d.ts.map +1 -1
  217. package/dist/volume/capability.d.ts +57 -0
  218. package/dist/volume/capability.d.ts.map +1 -0
  219. package/dist/volume/component.d.ts +61 -0
  220. package/dist/volume/component.d.ts.map +1 -0
  221. package/dist/volume/extract.d.ts +11 -0
  222. package/dist/volume/extract.d.ts.map +1 -0
  223. package/dist/volume/inspection.d.ts +38 -0
  224. package/dist/volume/inspection.d.ts.map +1 -0
  225. package/dist/volume/passes.d.ts +38 -0
  226. package/dist/volume/passes.d.ts.map +1 -0
  227. package/dist/volume/recovery.d.ts +38 -0
  228. package/dist/volume/recovery.d.ts.map +1 -0
  229. package/dist/volume/resources.d.ts +57 -0
  230. package/dist/volume/resources.d.ts.map +1 -0
  231. package/dist/volume/temporal.d.ts +35 -0
  232. package/dist/volume/temporal.d.ts.map +1 -0
  233. package/package.json +24 -19
  234. package/src/__tests__/ai-user-cold-start.integration.test.ts +59 -0
  235. package/src/__tests__/ai-user-public-surface.test-d.ts +45 -0
  236. package/src/__tests__/bloom-exact-zero.unit.test.ts +202 -0
  237. package/src/__tests__/bloom-lifecycle.integration.test.ts +125 -0
  238. package/src/__tests__/construct-renderer-identity.unit.test.ts +4 -3
  239. package/src/__tests__/detached-inspection.integration.test.ts +177 -0
  240. package/src/__tests__/environment-fog-lanes.integration.test.ts +219 -0
  241. package/src/__tests__/environment-generation.integration.test.ts +141 -0
  242. package/src/__tests__/environment-selection.unit.test.ts +245 -0
  243. package/src/__tests__/factory-contract.integration.test.ts +1380 -9
  244. package/src/__tests__/frame-plan-contract.unit.test.ts +90 -0
  245. package/src/__tests__/fullscreen-feature-plan.unit.test.ts +7 -0
  246. package/src/__tests__/gpu-driven-production.integration.test.ts +74 -22
  247. package/src/__tests__/gpu-driven-view-graph.integration.test.ts +37 -0
  248. package/src/__tests__/gpu-scene.unit.test.ts +10 -0
  249. package/src/__tests__/injection-kind-owner.test-d.ts +2 -1
  250. package/src/__tests__/ktx2-basis-gpu-consumer.dawn.test.ts +14 -14
  251. package/src/__tests__/material-contract-inventory.unit.test.ts +62 -0
  252. package/src/__tests__/material-cooked-projection.unit.test.ts +18 -146
  253. package/src/__tests__/materials-transmission-validation.unit.test.ts +36 -0
  254. package/src/__tests__/mesh-buffer-usage-surface.unit.test.ts +1 -1
  255. package/src/__tests__/morph-feature-plan.unit.test.ts +7 -0
  256. package/src/__tests__/motion-blur.pixel.integration.test.ts +121 -0
  257. package/src/__tests__/public-surface.test-d.ts +15 -1
  258. package/src/__tests__/render-error-code-owner.test-d.ts +14 -0
  259. package/src/__tests__/render-error-detail-ssot.test-d.ts +11 -2
  260. package/src/__tests__/render-error-exhaustive.test-d.ts +3 -0
  261. package/src/__tests__/render-feature-errors.unit.test.ts +33 -3
  262. package/src/__tests__/render-feature-gpu-work.integration.test.ts +44 -0
  263. package/src/__tests__/render-feature-plan.test-d.ts +22 -89
  264. package/src/__tests__/render-scene-projection.unit.test.ts +28 -0
  265. package/src/__tests__/render-temporal-environment-consumer.browser.test.ts +26 -0
  266. package/src/__tests__/render-temporal-environment-consumer.dawn.test.ts +21 -0
  267. package/src/__tests__/renderer-factory-material-contract.unit.test.ts +423 -1
  268. package/src/__tests__/renderer-frame-transaction.integration.test.ts +405 -0
  269. package/src/__tests__/renderer-lifecycle.integration.test.ts +22 -0
  270. package/src/__tests__/scene-data-catalog.unit.test.ts +59 -0
  271. package/src/__tests__/scene-data-consumer.integration.test.ts +67 -0
  272. package/src/__tests__/scene-data-contract.test-d.ts +35 -0
  273. package/src/__tests__/scene-data-inspection.unit.test.ts +41 -0
  274. package/src/__tests__/scene-data-public-surface.test-d.ts +34 -0
  275. package/src/__tests__/shader-manifest-fixture.ts +111 -0
  276. package/src/__tests__/skinned-shadow-caster.test.ts +123 -0
  277. package/src/__tests__/standard-clustered-pipeline.unit.test.ts +24 -3
  278. package/src/__tests__/standard-pipeline.dawn.test.ts +15 -0
  279. package/src/__tests__/standard-pipeline.integration.test.ts +543 -1
  280. package/src/__tests__/standard-profile-oracle.unit.test.ts +12 -2
  281. package/src/__tests__/standard-temporal-producer.integration.test.ts +35 -0
  282. package/src/__tests__/surface-configuration.unit.test.ts +211 -12
  283. package/src/__tests__/taa-transaction.integration.test.ts +30 -0
  284. package/src/__tests__/temporal-admission.integration.test.ts +40 -0
  285. package/src/__tests__/temporal-coverage.unit.test.ts +35 -0
  286. package/src/__tests__/temporal-demand.unit.test.ts +44 -0
  287. package/src/__tests__/temporal-frame-coordinator.unit.test.ts +64 -0
  288. package/src/__tests__/temporal-graph-topology.unit.test.ts +51 -0
  289. package/src/__tests__/temporal-history-lifecycle.unit.test.ts +170 -0
  290. package/src/__tests__/temporal-performance.integration.test.ts +615 -0
  291. package/src/__tests__/temporal-reset-matrix.unit.test.ts +97 -0
  292. package/src/__tests__/temporal-transaction.integration.test.ts +60 -0
  293. package/src/__tests__/temporal-view.unit.test.ts +152 -0
  294. package/src/__tests__/transmission-prewarm.unit.test.ts +93 -0
  295. package/src/__tests__/typed-pipeline-topology.unit.test.ts +230 -1
  296. package/src/__tests__/urp-pipeline-targets.unit.test.ts +25 -1
  297. package/src/__tests__/urp-pipeline.unit.test.ts +4 -3
  298. package/src/__tests__/visibility-extract.integration.test.ts +27 -1
  299. package/src/__tests__/visibility-producer-matrix.integration.test.ts +10 -0
  300. package/src/__tests__/volume-optics-oracle.unit.test.ts +85 -0
  301. package/src/__tests__/volumetric-fog-budget-recovery.integration.test.ts +655 -0
  302. package/src/__tests__/volumetric-fog-component.unit.test.ts +71 -0
  303. package/src/__tests__/volumetric-fog-composite-stage-readback.dawn.test.ts +376 -0
  304. package/src/__tests__/volumetric-fog-errors.unit.test.ts +51 -0
  305. package/src/__tests__/volumetric-fog-inspection.unit.test.ts +77 -0
  306. package/src/__tests__/volumetric-fog-light-capability.unit.test.ts +19 -0
  307. package/src/__tests__/volumetric-fog-light-consumers.integration.test.ts +18 -0
  308. package/src/__tests__/volumetric-fog-light-errors.unit.test.ts +17 -0
  309. package/src/__tests__/volumetric-fog-light-topology.unit.test.ts +21 -0
  310. package/src/__tests__/volumetric-fog-light-transaction.integration.test.ts +53 -0
  311. package/src/__tests__/volumetric-fog-m9-watcher.integration.test.ts +27 -0
  312. package/src/__tests__/volumetric-fog-point-light-owner.integration.test.ts +44 -0
  313. package/src/__tests__/volumetric-fog-point-spot-accumulation.integration.test.ts +49 -0
  314. package/src/__tests__/volumetric-fog-point-spot-contract.unit.test.ts +28 -0
  315. package/src/__tests__/volumetric-fog-point-spot-lkg.integration.test.ts +65 -0
  316. package/src/__tests__/volumetric-fog-point-spot-selection.integration.test.ts +49 -0
  317. package/src/__tests__/volumetric-fog-point-spot-temporal.unit.test.ts +55 -0
  318. package/src/__tests__/volumetric-fog-projector-contract.unit.test.ts +22 -0
  319. package/src/__tests__/volumetric-fog-projector-inspection.unit.test.ts +12 -0
  320. package/src/__tests__/volumetric-fog-projector-surface-volume.integration.test.ts +11 -0
  321. package/src/__tests__/volumetric-fog-projector-transaction.integration.test.ts +26 -0
  322. package/src/__tests__/volumetric-fog-recovery.integration.test.ts +47 -0
  323. package/src/__tests__/volumetric-fog-selected-light-resolution.integration.test.ts +63 -0
  324. package/src/__tests__/volumetric-fog-spot-closure.integration.test.ts +26 -0
  325. package/src/__tests__/volumetric-fog-spot-contract.test-d.ts +21 -0
  326. package/src/__tests__/volumetric-fog-spot-contract.unit.test.ts +27 -0
  327. package/src/__tests__/volumetric-fog-spot-frame-optics.integration.test.ts +14 -0
  328. package/src/__tests__/volumetric-fog-spot-optics.integration.test.ts +29 -0
  329. package/src/__tests__/volumetric-fog-stage-readback.dawn.test.ts +550 -0
  330. package/src/__tests__/volumetric-fog-temporal-selected-light.unit.test.ts +33 -0
  331. package/src/__tests__/volumetric-fog-temporal.unit.test.ts +45 -0
  332. package/src/__tests__/volumetric-fog-topology.unit.test.ts +237 -0
  333. package/src/__tests__/volumetric-fog-transparent.integration.test.ts +27 -0
  334. package/src/assembly/backend-contract.ts +47 -1
  335. package/src/assembly/factory.ts +1480 -505
  336. package/src/assembly/host-contract.ts +4 -0
  337. package/src/assembly/renderer-frame-transaction.ts +75 -0
  338. package/src/assembly/renderer-inspection.ts +112 -0
  339. package/src/assembly/renderer-lifecycle.ts +6 -0
  340. package/src/components/__tests__/motion-blur.unit.test.ts +14 -0
  341. package/src/components/__tests__/schema-contract.unit.test.ts +6 -1
  342. package/src/components/atmosphere.ts +10 -0
  343. package/src/components/camera.ts +2 -1
  344. package/src/components/fog.ts +9 -0
  345. package/src/components/index.ts +3 -0
  346. package/src/components/light-helpers.ts +4 -0
  347. package/src/components/motion-blur.ts +8 -0
  348. package/src/components/spot-light.ts +22 -3
  349. package/src/construct-renderer.ts +40 -3
  350. package/src/device/device-scope.ts +15 -1
  351. package/src/device/gpu-residency.ts +168 -58
  352. package/src/environment/frame.ts +185 -0
  353. package/src/environment/generation.ts +23 -0
  354. package/src/environment/graph.ts +9 -0
  355. package/src/environment/inspection.ts +87 -0
  356. package/src/environment/lifecycle.ts +250 -0
  357. package/src/environment/signature.ts +55 -0
  358. package/src/errors/render.ts +404 -1
  359. package/src/extract/camera.ts +78 -0
  360. package/src/extract/environment.ts +171 -0
  361. package/src/extract/visibility.ts +38 -19
  362. package/src/features/host.ts +36 -5
  363. package/src/features/motion-blur/__tests__/motion-blur-feature.unit.test.ts +67 -0
  364. package/src/features/motion-blur/__tests__/motion-blur-params.unit.test.ts +53 -0
  365. package/src/features/motion-blur/motion-blur-feature.ts +119 -0
  366. package/src/features/motion-blur/motion-blur-params.ts +89 -0
  367. package/src/features/plan.ts +32 -3
  368. package/src/features/prepared-gpu-work.ts +21 -6
  369. package/src/features/prepared-graphics.ts +2 -1
  370. package/src/features/render-graph-raster.ts +2 -1
  371. package/src/features/targets.ts +24 -2
  372. package/src/features/types.ts +13 -0
  373. package/src/fullscreen-post-process-pass.ts +34 -4
  374. package/src/gpu-scene.ts +24 -0
  375. package/src/gpu-usage.ts +2 -0
  376. package/src/ibl/skylight-bind-group.ts +30 -38
  377. package/src/index.ts +104 -7
  378. package/src/inspection-types.ts +48 -0
  379. package/src/internal.ts +5 -0
  380. package/src/light-buffer-layout.ts +59 -26
  381. package/src/materials.ts +119 -24
  382. package/src/pbr-pipeline.ts +91 -29
  383. package/src/pipeline/standard-forward-lane.ts +178 -101
  384. package/src/pipeline/standard-pipeline.ts +176 -105
  385. package/src/pipeline/standard-post.ts +373 -0
  386. package/src/pipeline/standard-profile.ts +26 -3
  387. package/src/pipeline-builder.ts +102 -12
  388. package/src/pipeline-spec.ts +9 -0
  389. package/src/plugin.ts +2 -0
  390. package/src/record/__tests__/fullscreen-temporal-routing.unit.test.ts +25 -0
  391. package/src/record/__tests__/main-pass-geometry.unit.test.ts +47 -0
  392. package/src/record/__tests__/material-bg-cache.unit.test.ts +12 -1
  393. package/src/record/__tests__/material-pipeline-pending-cache.unit.test.ts +22 -0
  394. package/src/record/__tests__/sprite-material-abi.unit.test.ts +75 -0
  395. package/src/record/__tests__/standard-pbr-ubo-layout.unit.test.ts +67 -0
  396. package/src/record/__tests__/temporal-payload.unit.test.ts +164 -0
  397. package/src/record/__tests__/typed-frame-graph-plan.unit.test.ts +127 -0
  398. package/src/record/frame-lighting.ts +103 -89
  399. package/src/record/frame-snapshot.ts +170 -6
  400. package/src/record/frame-targets.ts +21 -8
  401. package/src/record/frame.ts +1014 -7
  402. package/src/record/gpu-timing.ts +224 -0
  403. package/src/record/main-pass-geometry.ts +86 -40
  404. package/src/record/main-pass-material.ts +120 -68
  405. package/src/record/main-pass-sprite-draws.ts +78 -101
  406. package/src/record/main-pass.ts +77 -4
  407. package/src/record/mesh-ssbo.ts +22 -3
  408. package/src/record/render-context.ts +194 -23
  409. package/src/record/shadow-pass.ts +197 -58
  410. package/src/record/skybox-post-pass.ts +97 -41
  411. package/src/record/typed-frame-graph.ts +704 -30
  412. package/src/record/view-ubo.ts +52 -4
  413. package/src/render-contract.ts +181 -6
  414. package/src/render-data.ts +50 -22
  415. package/src/render-graph-primitives.ts +18 -1
  416. package/src/render-pipeline.ts +144 -27
  417. package/src/render-system-extract.ts +522 -72
  418. package/src/render-system.ts +561 -41
  419. package/src/renderer-inspect.ts +66 -0
  420. package/src/scene/render-scene.ts +252 -7
  421. package/src/temporal/__tests__/taa-history-resources.unit.test.ts +45 -0
  422. package/src/temporal/coverage.ts +76 -0
  423. package/src/temporal/frame-coordinator.ts +311 -0
  424. package/src/temporal/frame.ts +128 -0
  425. package/src/temporal/gpu.ts +287 -0
  426. package/src/temporal/history.ts +92 -0
  427. package/src/temporal/index.ts +6 -0
  428. package/src/temporal/inspection.ts +97 -0
  429. package/src/temporal/scene-data-catalog.ts +200 -0
  430. package/src/temporal/scene-data.ts +149 -0
  431. package/src/temporal/standard-scene-data.ts +182 -0
  432. package/src/temporal/taa-history-resources.ts +128 -0
  433. package/src/temporal/taa-history-store.ts +79 -0
  434. package/src/temporal/taa-resolve.ts +34 -0
  435. package/src/temporal/temporal-view.ts +169 -0
  436. package/src/temporal/transaction.ts +17 -0
  437. package/src/temporal/view.ts +161 -0
  438. package/src/transmission/__tests__/capability.unit.test.ts +83 -0
  439. package/src/transmission/__tests__/composition.integration.test.ts +161 -0
  440. package/src/transmission/__tests__/inspection.unit.test.ts +241 -0
  441. package/src/transmission/__tests__/lifecycle.integration.test.ts +96 -0
  442. package/src/transmission/__tests__/oracle.unit.test.ts +131 -0
  443. package/src/transmission/__tests__/projection.unit.test.ts +71 -0
  444. package/src/transmission/__tests__/standard-transmission.dawn.test.ts +437 -0
  445. package/src/transmission/__tests__/transmission-backdrop-topology.unit.test.ts +109 -0
  446. package/src/transmission/__tests__/transmission-backdrop.dawn.test.ts +105 -0
  447. package/src/transmission/backdrop.ts +572 -0
  448. package/src/transmission/inspection.ts +190 -0
  449. package/src/transmission/oracle.ts +141 -0
  450. package/src/transmission/projection.ts +83 -0
  451. package/src/typed-render-graph-primitives.ts +194 -11
  452. package/src/typed-shadow-atlas.ts +17 -0
  453. package/src/typed-shadow-passes.ts +6 -5
  454. package/src/volume/capability.ts +173 -0
  455. package/src/volume/component.ts +110 -0
  456. package/src/volume/extract.ts +21 -0
  457. package/src/volume/inspection.ts +78 -0
  458. package/src/volume/passes.ts +680 -0
  459. package/src/volume/recovery.ts +86 -0
  460. package/src/volume/resources.ts +236 -0
  461. package/src/volume/temporal.ts +89 -0
  462. package/dist/__tests__/authoring-path.unit.test.d.ts +0 -2
  463. package/dist/__tests__/authoring-path.unit.test.d.ts.map +0 -1
  464. package/dist/__tests__/backend-selection-rhi-capture.test-d.d.ts +0 -2
  465. package/dist/__tests__/backend-selection-rhi-capture.test-d.d.ts.map +0 -1
  466. package/dist/__tests__/callback-inference.test-d.d.ts +0 -2
  467. package/dist/__tests__/callback-inference.test-d.d.ts.map +0 -1
  468. package/dist/__tests__/cluster-binner.test.d.ts +0 -2
  469. package/dist/__tests__/cluster-binner.test.d.ts.map +0 -1
  470. package/dist/__tests__/cluster-grid-default-surface.unit.test.d.ts +0 -2
  471. package/dist/__tests__/cluster-grid-default-surface.unit.test.d.ts.map +0 -1
  472. package/dist/__tests__/construct-renderer-identity.unit.test.d.ts +0 -2
  473. package/dist/__tests__/construct-renderer-identity.unit.test.d.ts.map +0 -1
  474. package/dist/__tests__/device-scope-lifecycle.unit.test.d.ts +0 -2
  475. package/dist/__tests__/device-scope-lifecycle.unit.test.d.ts.map +0 -1
  476. package/dist/__tests__/device-scope-stale-matrix.unit.test.d.ts +0 -2
  477. package/dist/__tests__/device-scope-stale-matrix.unit.test.d.ts.map +0 -1
  478. package/dist/__tests__/direct-extract-consumer-contract.test-d.d.ts +0 -2
  479. package/dist/__tests__/direct-extract-consumer-contract.test-d.d.ts.map +0 -1
  480. package/dist/__tests__/direct-light-snapshot.unit.test.d.ts +0 -2
  481. package/dist/__tests__/direct-light-snapshot.unit.test.d.ts.map +0 -1
  482. package/dist/__tests__/factory-contract.integration.test.d.ts +0 -2
  483. package/dist/__tests__/factory-contract.integration.test.d.ts.map +0 -1
  484. package/dist/__tests__/fallback-row-stride-surface.unit.test.d.ts +0 -2
  485. package/dist/__tests__/fallback-row-stride-surface.unit.test.d.ts.map +0 -1
  486. package/dist/__tests__/frame-observation.contract.test.d.ts +0 -2
  487. package/dist/__tests__/frame-observation.contract.test.d.ts.map +0 -1
  488. package/dist/__tests__/fullscreen-feature-plan.unit.test.d.ts +0 -2
  489. package/dist/__tests__/fullscreen-feature-plan.unit.test.d.ts.map +0 -1
  490. package/dist/__tests__/glyph-text-layout-recovery.unit.test.d.ts +0 -2
  491. package/dist/__tests__/glyph-text-layout-recovery.unit.test.d.ts.map +0 -1
  492. package/dist/__tests__/gpu-driven-indirect-raster-evidence.d.ts +0 -6
  493. package/dist/__tests__/gpu-driven-indirect-raster-evidence.d.ts.map +0 -1
  494. package/dist/__tests__/gpu-driven-indirect-raster.browser.test.d.ts +0 -2
  495. package/dist/__tests__/gpu-driven-indirect-raster.browser.test.d.ts.map +0 -1
  496. package/dist/__tests__/gpu-driven-indirect-raster.dawn.test.d.ts +0 -2
  497. package/dist/__tests__/gpu-driven-indirect-raster.dawn.test.d.ts.map +0 -1
  498. package/dist/__tests__/gpu-driven-production.integration.test.d.ts +0 -2
  499. package/dist/__tests__/gpu-driven-production.integration.test.d.ts.map +0 -1
  500. package/dist/__tests__/gpu-driven-scaling.unit.test.d.ts +0 -2
  501. package/dist/__tests__/gpu-driven-scaling.unit.test.d.ts.map +0 -1
  502. package/dist/__tests__/gpu-driven-view-gpu-evidence.d.ts +0 -18
  503. package/dist/__tests__/gpu-driven-view-gpu-evidence.d.ts.map +0 -1
  504. package/dist/__tests__/gpu-driven-view-graph.integration.test.d.ts +0 -2
  505. package/dist/__tests__/gpu-driven-view-graph.integration.test.d.ts.map +0 -1
  506. package/dist/__tests__/gpu-driven-view-reference.d.ts +0 -15
  507. package/dist/__tests__/gpu-driven-view-reference.d.ts.map +0 -1
  508. package/dist/__tests__/gpu-driven-view.browser.test.d.ts +0 -2
  509. package/dist/__tests__/gpu-driven-view.browser.test.d.ts.map +0 -1
  510. package/dist/__tests__/gpu-driven-view.dawn.test.d.ts +0 -2
  511. package/dist/__tests__/gpu-driven-view.dawn.test.d.ts.map +0 -1
  512. package/dist/__tests__/gpu-driven-view.unit.test.d.ts +0 -2
  513. package/dist/__tests__/gpu-driven-view.unit.test.d.ts.map +0 -1
  514. package/dist/__tests__/gpu-resource-store-stride.unit.test.d.ts +0 -2
  515. package/dist/__tests__/gpu-resource-store-stride.unit.test.d.ts.map +0 -1
  516. package/dist/__tests__/gpu-scene-render-graph-gpu.d.ts +0 -7
  517. package/dist/__tests__/gpu-scene-render-graph-gpu.d.ts.map +0 -1
  518. package/dist/__tests__/gpu-scene-render-graph.browser.test.d.ts +0 -2
  519. package/dist/__tests__/gpu-scene-render-graph.browser.test.d.ts.map +0 -1
  520. package/dist/__tests__/gpu-scene-render-graph.dawn.test.d.ts +0 -2
  521. package/dist/__tests__/gpu-scene-render-graph.dawn.test.d.ts.map +0 -1
  522. package/dist/__tests__/gpu-scene-schema.unit.test.d.ts +0 -2
  523. package/dist/__tests__/gpu-scene-schema.unit.test.d.ts.map +0 -1
  524. package/dist/__tests__/gpu-scene.dawn.test.d.ts +0 -2
  525. package/dist/__tests__/gpu-scene.dawn.test.d.ts.map +0 -1
  526. package/dist/__tests__/gpu-scene.unit.test.d.ts +0 -2
  527. package/dist/__tests__/gpu-scene.unit.test.d.ts.map +0 -1
  528. package/dist/__tests__/ibl/face-uniforms.unit.test.d.ts +0 -2
  529. package/dist/__tests__/ibl/face-uniforms.unit.test.d.ts.map +0 -1
  530. package/dist/__tests__/infinite-grid-no-vertex-probe.unit.test.d.ts +0 -2
  531. package/dist/__tests__/infinite-grid-no-vertex-probe.unit.test.d.ts.map +0 -1
  532. package/dist/__tests__/injection-kind-owner.test-d.d.ts +0 -2
  533. package/dist/__tests__/injection-kind-owner.test-d.d.ts.map +0 -1
  534. package/dist/__tests__/ktx2-basis-gpu-consumer.dawn.test.d.ts +0 -2
  535. package/dist/__tests__/ktx2-basis-gpu-consumer.dawn.test.d.ts.map +0 -1
  536. package/dist/__tests__/light-buffer-layout.unit.test.d.ts +0 -2
  537. package/dist/__tests__/light-buffer-layout.unit.test.d.ts.map +0 -1
  538. package/dist/__tests__/material-contract-inventory.unit.test.d.ts +0 -2
  539. package/dist/__tests__/material-contract-inventory.unit.test.d.ts.map +0 -1
  540. package/dist/__tests__/material-cooked-projection.unit.test.d.ts +0 -2
  541. package/dist/__tests__/material-cooked-projection.unit.test.d.ts.map +0 -1
  542. package/dist/__tests__/material-snapshot-mutation.integration.test.d.ts +0 -2
  543. package/dist/__tests__/material-snapshot-mutation.integration.test.d.ts.map +0 -1
  544. package/dist/__tests__/material-static-dynamic-route.unit.test.d.ts +0 -2
  545. package/dist/__tests__/material-static-dynamic-route.unit.test.d.ts.map +0 -1
  546. package/dist/__tests__/material-stride-surface.unit.test.d.ts +0 -2
  547. package/dist/__tests__/material-stride-surface.unit.test.d.ts.map +0 -1
  548. package/dist/__tests__/mesh-buffer-usage-surface.unit.test.d.ts +0 -2
  549. package/dist/__tests__/mesh-buffer-usage-surface.unit.test.d.ts.map +0 -1
  550. package/dist/__tests__/mesh-material-bindings.unit.test.d.ts +0 -2
  551. package/dist/__tests__/mesh-material-bindings.unit.test.d.ts.map +0 -1
  552. package/dist/__tests__/mesh-stride-surface.unit.test.d.ts +0 -2
  553. package/dist/__tests__/mesh-stride-surface.unit.test.d.ts.map +0 -1
  554. package/dist/__tests__/morph-culling-reentry.dawn.test.d.ts +0 -2
  555. package/dist/__tests__/morph-culling-reentry.dawn.test.d.ts.map +0 -1
  556. package/dist/__tests__/morph-feature-gpu-work.integration.test.d.ts +0 -2
  557. package/dist/__tests__/morph-feature-gpu-work.integration.test.d.ts.map +0 -1
  558. package/dist/__tests__/morph-feature-plan.unit.test.d.ts +0 -2
  559. package/dist/__tests__/morph-feature-plan.unit.test.d.ts.map +0 -1
  560. package/dist/__tests__/morph-visual-evidence.integration.test.d.ts +0 -2
  561. package/dist/__tests__/morph-visual-evidence.integration.test.d.ts.map +0 -1
  562. package/dist/__tests__/nineslice-handle-surface.unit.test.d.ts +0 -2
  563. package/dist/__tests__/nineslice-handle-surface.unit.test.d.ts.map +0 -1
  564. package/dist/__tests__/post-process-error-policy-owner.unit.test.d.ts +0 -2
  565. package/dist/__tests__/post-process-error-policy-owner.unit.test.d.ts.map +0 -1
  566. package/dist/__tests__/prepared-buffer-kind-owner.test-d.d.ts +0 -2
  567. package/dist/__tests__/prepared-buffer-kind-owner.test-d.d.ts.map +0 -1
  568. package/dist/__tests__/prepared-graphics-capability.unit.test.d.ts +0 -2
  569. package/dist/__tests__/prepared-graphics-capability.unit.test.d.ts.map +0 -1
  570. package/dist/__tests__/prepared-graphics-generation.unit.test.d.ts +0 -2
  571. package/dist/__tests__/prepared-graphics-generation.unit.test.d.ts.map +0 -1
  572. package/dist/__tests__/prepared-graphics-lifecycle.unit.test.d.ts +0 -2
  573. package/dist/__tests__/prepared-graphics-lifecycle.unit.test.d.ts.map +0 -1
  574. package/dist/__tests__/prepared-graphics-pipeline-warmup.unit.test.d.ts +0 -2
  575. package/dist/__tests__/prepared-graphics-pipeline-warmup.unit.test.d.ts.map +0 -1
  576. package/dist/__tests__/prepared-graphics-resolver.unit.test.d.ts +0 -2
  577. package/dist/__tests__/prepared-graphics-resolver.unit.test.d.ts.map +0 -1
  578. package/dist/__tests__/prepared-graphics-snapshot.unit.test.d.ts +0 -2
  579. package/dist/__tests__/prepared-graphics-snapshot.unit.test.d.ts.map +0 -1
  580. package/dist/__tests__/prepared-graphics-store.unit.test.d.ts +0 -2
  581. package/dist/__tests__/prepared-graphics-store.unit.test.d.ts.map +0 -1
  582. package/dist/__tests__/prepared-graphics-validation.unit.test.d.ts +0 -2
  583. package/dist/__tests__/prepared-graphics-validation.unit.test.d.ts.map +0 -1
  584. package/dist/__tests__/profiler-default-off.test.d.ts +0 -2
  585. package/dist/__tests__/profiler-default-off.test.d.ts.map +0 -1
  586. package/dist/__tests__/profiler-phase-catalog.test.d.ts +0 -2
  587. package/dist/__tests__/profiler-phase-catalog.test.d.ts.map +0 -1
  588. package/dist/__tests__/profiler-phase-integration.test.d.ts +0 -2
  589. package/dist/__tests__/profiler-phase-integration.test.d.ts.map +0 -1
  590. package/dist/__tests__/profiler-phase-token.test.d.ts +0 -2
  591. package/dist/__tests__/profiler-phase-token.test.d.ts.map +0 -1
  592. package/dist/__tests__/public-surface.test-d.d.ts +0 -2
  593. package/dist/__tests__/public-surface.test-d.d.ts.map +0 -1
  594. package/dist/__tests__/recover-error-policy-owner.unit.test.d.ts +0 -2
  595. package/dist/__tests__/recover-error-policy-owner.unit.test.d.ts.map +0 -1
  596. package/dist/__tests__/render-error-code-owner.test-d.d.ts +0 -2
  597. package/dist/__tests__/render-error-code-owner.test-d.d.ts.map +0 -1
  598. package/dist/__tests__/render-error-detail-ssot.test-d.d.ts +0 -2
  599. package/dist/__tests__/render-error-detail-ssot.test-d.d.ts.map +0 -1
  600. package/dist/__tests__/render-error-exhaustive.test-d.d.ts +0 -2
  601. package/dist/__tests__/render-error-exhaustive.test-d.d.ts.map +0 -1
  602. package/dist/__tests__/render-feature-assembly.test-d.d.ts +0 -2
  603. package/dist/__tests__/render-feature-assembly.test-d.d.ts.map +0 -1
  604. package/dist/__tests__/render-feature-context.test-d.d.ts +0 -2
  605. package/dist/__tests__/render-feature-context.test-d.d.ts.map +0 -1
  606. package/dist/__tests__/render-feature-contract.test-d.d.ts +0 -2
  607. package/dist/__tests__/render-feature-contract.test-d.d.ts.map +0 -1
  608. package/dist/__tests__/render-feature-diagnostics.unit.test.d.ts +0 -2
  609. package/dist/__tests__/render-feature-diagnostics.unit.test.d.ts.map +0 -1
  610. package/dist/__tests__/render-feature-docs.unit.test.d.ts +0 -2
  611. package/dist/__tests__/render-feature-docs.unit.test.d.ts.map +0 -1
  612. package/dist/__tests__/render-feature-errors.unit.test.d.ts +0 -2
  613. package/dist/__tests__/render-feature-errors.unit.test.d.ts.map +0 -1
  614. package/dist/__tests__/render-feature-gpu-work.integration.test.d.ts +0 -2
  615. package/dist/__tests__/render-feature-gpu-work.integration.test.d.ts.map +0 -1
  616. package/dist/__tests__/render-feature-plan.test-d.d.ts +0 -2
  617. package/dist/__tests__/render-feature-plan.test-d.d.ts.map +0 -1
  618. package/dist/__tests__/render-feature-plan.unit.test.d.ts +0 -2
  619. package/dist/__tests__/render-feature-plan.unit.test.d.ts.map +0 -1
  620. package/dist/__tests__/render-feature-prepared-diagnostics.unit.test.d.ts +0 -2
  621. package/dist/__tests__/render-feature-prepared-diagnostics.unit.test.d.ts.map +0 -1
  622. package/dist/__tests__/render-feature-prepared-errors.test-d.d.ts +0 -2
  623. package/dist/__tests__/render-feature-prepared-errors.test-d.d.ts.map +0 -1
  624. package/dist/__tests__/render-feature-prepared-graphics-docs.unit.test.d.ts +0 -2
  625. package/dist/__tests__/render-feature-prepared-graphics-docs.unit.test.d.ts.map +0 -1
  626. package/dist/__tests__/render-feature-prepared-graphics-isolation.unit.test.d.ts +0 -2
  627. package/dist/__tests__/render-feature-prepared-graphics-isolation.unit.test.d.ts.map +0 -1
  628. package/dist/__tests__/render-feature-prepared-graphics-negative.test-d.d.ts +0 -2
  629. package/dist/__tests__/render-feature-prepared-graphics-negative.test-d.d.ts.map +0 -1
  630. package/dist/__tests__/render-feature-prepared-graphics.test-d.d.ts +0 -2
  631. package/dist/__tests__/render-feature-prepared-graphics.test-d.d.ts.map +0 -1
  632. package/dist/__tests__/render-feature-prepared-graphics.unit.test.d.ts +0 -2
  633. package/dist/__tests__/render-feature-prepared-graphics.unit.test.d.ts.map +0 -1
  634. package/dist/__tests__/render-feature-public-surface.test-d.d.ts +0 -2
  635. package/dist/__tests__/render-feature-public-surface.test-d.d.ts.map +0 -1
  636. package/dist/__tests__/render-feature-retry.unit.test.d.ts +0 -2
  637. package/dist/__tests__/render-feature-retry.unit.test.d.ts.map +0 -1
  638. package/dist/__tests__/render-feature-scheduling.unit.test.d.ts +0 -2
  639. package/dist/__tests__/render-feature-scheduling.unit.test.d.ts.map +0 -1
  640. package/dist/__tests__/render-feature-stage-failed-policy-owner.unit.test.d.ts +0 -2
  641. package/dist/__tests__/render-feature-stage-failed-policy-owner.unit.test.d.ts.map +0 -1
  642. package/dist/__tests__/render-feature-stage-fault-recovery.unit.test.d.ts +0 -2
  643. package/dist/__tests__/render-feature-stage-fault-recovery.unit.test.d.ts.map +0 -1
  644. package/dist/__tests__/render-feature-visibility-context.test-d.d.ts +0 -2
  645. package/dist/__tests__/render-feature-visibility-context.test-d.d.ts.map +0 -1
  646. package/dist/__tests__/render-feature-visibility-context.unit.test.d.ts +0 -2
  647. package/dist/__tests__/render-feature-visibility-context.unit.test.d.ts.map +0 -1
  648. package/dist/__tests__/render-feature-zero-work.unit.test.d.ts +0 -2
  649. package/dist/__tests__/render-feature-zero-work.unit.test.d.ts.map +0 -1
  650. package/dist/__tests__/render-graph-compute-raster-gpu.d.ts +0 -7
  651. package/dist/__tests__/render-graph-compute-raster-gpu.d.ts.map +0 -1
  652. package/dist/__tests__/render-graph-compute-raster.browser.test.d.ts +0 -2
  653. package/dist/__tests__/render-graph-compute-raster.browser.test.d.ts.map +0 -1
  654. package/dist/__tests__/render-graph-compute-raster.dawn.test.d.ts +0 -2
  655. package/dist/__tests__/render-graph-compute-raster.dawn.test.d.ts.map +0 -1
  656. package/dist/__tests__/render-graph-hzb-gpu.d.ts +0 -7
  657. package/dist/__tests__/render-graph-hzb-gpu.d.ts.map +0 -1
  658. package/dist/__tests__/render-graph-hzb.browser.test.d.ts +0 -2
  659. package/dist/__tests__/render-graph-hzb.browser.test.d.ts.map +0 -1
  660. package/dist/__tests__/render-graph-hzb.dawn.test.d.ts +0 -2
  661. package/dist/__tests__/render-graph-hzb.dawn.test.d.ts.map +0 -1
  662. package/dist/__tests__/render-graph-primitives.unit.test.d.ts +0 -2
  663. package/dist/__tests__/render-graph-primitives.unit.test.d.ts.map +0 -1
  664. package/dist/__tests__/render-graph-storage-indirect-gpu.d.ts +0 -12
  665. package/dist/__tests__/render-graph-storage-indirect-gpu.d.ts.map +0 -1
  666. package/dist/__tests__/render-graph-storage-indirect.browser.test.d.ts +0 -2
  667. package/dist/__tests__/render-graph-storage-indirect.browser.test.d.ts.map +0 -1
  668. package/dist/__tests__/render-graph-storage-indirect.dawn.test.d.ts +0 -2
  669. package/dist/__tests__/render-graph-storage-indirect.dawn.test.d.ts.map +0 -1
  670. package/dist/__tests__/render-scene-projection.unit.test.d.ts +0 -2
  671. package/dist/__tests__/render-scene-projection.unit.test.d.ts.map +0 -1
  672. package/dist/__tests__/renderer-factory-material-contract.unit.test.d.ts +0 -2
  673. package/dist/__tests__/renderer-factory-material-contract.unit.test.d.ts.map +0 -1
  674. package/dist/__tests__/renderer-lifecycle.integration.test.d.ts +0 -2
  675. package/dist/__tests__/renderer-lifecycle.integration.test.d.ts.map +0 -1
  676. package/dist/__tests__/rhi-backend-package-boundary.unit.test.d.ts +0 -2
  677. package/dist/__tests__/rhi-backend-package-boundary.unit.test.d.ts.map +0 -1
  678. package/dist/__tests__/scriptable-pack-consumer.test-d.d.ts +0 -2
  679. package/dist/__tests__/scriptable-pack-consumer.test-d.d.ts.map +0 -1
  680. package/dist/__tests__/shader-stage-surface.unit.test.d.ts +0 -2
  681. package/dist/__tests__/shader-stage-surface.unit.test.d.ts.map +0 -1
  682. package/dist/__tests__/ssao-config.unit.test.d.ts +0 -2
  683. package/dist/__tests__/ssao-config.unit.test.d.ts.map +0 -1
  684. package/dist/__tests__/ssao-kernel-surface.unit.test.d.ts +0 -2
  685. package/dist/__tests__/ssao-kernel-surface.unit.test.d.ts.map +0 -1
  686. package/dist/__tests__/standard-clustered-pipeline.unit.test.d.ts +0 -2
  687. package/dist/__tests__/standard-clustered-pipeline.unit.test.d.ts.map +0 -1
  688. package/dist/__tests__/standard-descriptors.test-d.d.ts +0 -2
  689. package/dist/__tests__/standard-descriptors.test-d.d.ts.map +0 -1
  690. package/dist/__tests__/standard-pipeline.dawn.test.d.ts +0 -2
  691. package/dist/__tests__/standard-pipeline.dawn.test.d.ts.map +0 -1
  692. package/dist/__tests__/standard-pipeline.integration.test.d.ts +0 -2
  693. package/dist/__tests__/standard-pipeline.integration.test.d.ts.map +0 -1
  694. package/dist/__tests__/standard-profile-oracle.unit.test.d.ts +0 -2
  695. package/dist/__tests__/standard-profile-oracle.unit.test.d.ts.map +0 -1
  696. package/dist/__tests__/surface-configuration.unit.test.d.ts +0 -2
  697. package/dist/__tests__/surface-configuration.unit.test.d.ts.map +0 -1
  698. package/dist/__tests__/texture-usage-surface.unit.test.d.ts +0 -2
  699. package/dist/__tests__/texture-usage-surface.unit.test.d.ts.map +0 -1
  700. package/dist/__tests__/typed-pipeline-topology.unit.test.d.ts +0 -2
  701. package/dist/__tests__/typed-pipeline-topology.unit.test.d.ts.map +0 -1
  702. package/dist/__tests__/urp-pipeline-targets.unit.test.d.ts +0 -2
  703. package/dist/__tests__/urp-pipeline-targets.unit.test.d.ts.map +0 -1
  704. package/dist/__tests__/urp-pipeline.unit.test.d.ts +0 -2
  705. package/dist/__tests__/urp-pipeline.unit.test.d.ts.map +0 -1
  706. package/dist/__tests__/vertex-color-pipeline.unit.test.d.ts +0 -2
  707. package/dist/__tests__/vertex-color-pipeline.unit.test.d.ts.map +0 -1
  708. package/dist/__tests__/vertex-layout-consumer.unit.test.d.ts +0 -2
  709. package/dist/__tests__/vertex-layout-consumer.unit.test.d.ts.map +0 -1
  710. package/dist/__tests__/visibility-diagnostics.integration.test.d.ts +0 -2
  711. package/dist/__tests__/visibility-diagnostics.integration.test.d.ts.map +0 -1
  712. package/dist/__tests__/visibility-extract.integration.test.d.ts +0 -2
  713. package/dist/__tests__/visibility-extract.integration.test.d.ts.map +0 -1
  714. package/dist/__tests__/visibility-extract.perf.test.d.ts +0 -2
  715. package/dist/__tests__/visibility-extract.perf.test.d.ts.map +0 -1
  716. package/dist/__tests__/visibility-feature-dedup.integration.test.d.ts +0 -2
  717. package/dist/__tests__/visibility-feature-dedup.integration.test.d.ts.map +0 -1
  718. package/dist/__tests__/visibility-hidden-report.unit.test.d.ts +0 -2
  719. package/dist/__tests__/visibility-hidden-report.unit.test.d.ts.map +0 -1
  720. package/dist/__tests__/visibility-instances.integration.test.d.ts +0 -2
  721. package/dist/__tests__/visibility-instances.integration.test.d.ts.map +0 -1
  722. package/dist/__tests__/visibility-multi-world.integration.test.d.ts +0 -2
  723. package/dist/__tests__/visibility-multi-world.integration.test.d.ts.map +0 -1
  724. package/dist/__tests__/visibility-producer-matrix.integration.test.d.ts +0 -2
  725. package/dist/__tests__/visibility-producer-matrix.integration.test.d.ts.map +0 -1
  726. package/dist/__tests__/visibility-producer-matrix.unit.test.d.ts +0 -2
  727. package/dist/__tests__/visibility-producer-matrix.unit.test.d.ts.map +0 -1
  728. package/dist/__tests__/visibility-public-surface.test-d.d.ts +0 -2
  729. package/dist/__tests__/visibility-public-surface.test-d.d.ts.map +0 -1
  730. package/dist/__tests__/visibility-resolver.unit.test.d.ts +0 -2
  731. package/dist/__tests__/visibility-resolver.unit.test.d.ts.map +0 -1
  732. package/dist/__tests__/visibility-resource-short-circuit.unit.test.d.ts +0 -2
  733. package/dist/__tests__/visibility-resource-short-circuit.unit.test.d.ts.map +0 -1
  734. package/dist/__tests__/visibility-snapshot-contract.unit.test.d.ts +0 -2
  735. package/dist/__tests__/visibility-snapshot-contract.unit.test.d.ts.map +0 -1
  736. package/dist/__tests__/vocabulary.unit.test.d.ts +0 -2
  737. package/dist/__tests__/vocabulary.unit.test.d.ts.map +0 -1
  738. package/dist/chunk-CQXZC5XI.mjs.map +0 -1
  739. package/dist/chunk-HCOGPHKS.mjs +0 -93
  740. package/dist/chunk-HCOGPHKS.mjs.map +0 -1
  741. package/dist/chunk-YEJIUW7D.mjs.map +0 -1
  742. package/dist/components/__tests__/points-lines-admission.unit.test.d.ts +0 -2
  743. package/dist/components/__tests__/points-lines-admission.unit.test.d.ts.map +0 -1
  744. package/dist/components/__tests__/points-lines-schema.unit.test.d.ts +0 -2
  745. package/dist/components/__tests__/points-lines-schema.unit.test.d.ts.map +0 -1
  746. package/dist/components/__tests__/schema-contract.unit.test.d.ts +0 -2
  747. package/dist/components/__tests__/schema-contract.unit.test.d.ts.map +0 -1
  748. package/dist/components/__tests__/schema-parity.unit.test.d.ts +0 -2
  749. package/dist/components/__tests__/schema-parity.unit.test.d.ts.map +0 -1
  750. package/dist/components/__tests__/visibility-schema.unit.test.d.ts +0 -2
  751. package/dist/components/__tests__/visibility-schema.unit.test.d.ts.map +0 -1
  752. package/dist/points-lines/__tests__/bounds.unit.test.d.ts +0 -2
  753. package/dist/points-lines/__tests__/bounds.unit.test.d.ts.map +0 -1
  754. package/dist/points-lines/__tests__/cache-recovery.unit.test.d.ts +0 -2
  755. package/dist/points-lines/__tests__/cache-recovery.unit.test.d.ts.map +0 -1
  756. package/dist/points-lines/__tests__/inspection-lanes.integration.test.d.ts +0 -2
  757. package/dist/points-lines/__tests__/inspection-lanes.integration.test.d.ts.map +0 -1
  758. package/dist/points-lines/__tests__/inspection.unit.test.d.ts +0 -2
  759. package/dist/points-lines/__tests__/inspection.unit.test.d.ts.map +0 -1
  760. package/dist/points-lines/__tests__/lane-structural.integration.test.d.ts +0 -2
  761. package/dist/points-lines/__tests__/lane-structural.integration.test.d.ts.map +0 -1
  762. package/dist/points-lines/__tests__/points-lines.bench.d.ts +0 -2
  763. package/dist/points-lines/__tests__/points-lines.bench.d.ts.map +0 -1
  764. package/dist/points-lines/__tests__/raster-lane.integration.test.d.ts +0 -2
  765. package/dist/points-lines/__tests__/raster-lane.integration.test.d.ts.map +0 -1
  766. package/dist/points-lines/__tests__/snapshot.unit.test.d.ts +0 -2
  767. package/dist/points-lines/__tests__/snapshot.unit.test.d.ts.map +0 -1
  768. package/dist/points-lines/__tests__/view-ubo.unit.test.d.ts +0 -2
  769. package/dist/points-lines/__tests__/view-ubo.unit.test.d.ts.map +0 -1
  770. package/dist/record/__tests__/material-bg-cache.unit.test.d.ts +0 -2
  771. package/dist/record/__tests__/material-bg-cache.unit.test.d.ts.map +0 -1
  772. package/dist/record/__tests__/material-slot-plan.unit.test.d.ts +0 -2
  773. package/dist/record/__tests__/material-slot-plan.unit.test.d.ts.map +0 -1
  774. package/dist/record/__tests__/typed-frame-graph-plan.unit.test.d.ts +0 -2
  775. package/dist/record/__tests__/typed-frame-graph-plan.unit.test.d.ts.map +0 -1
  776. package/dist/record/__tests__/video-texture-view.unit.test.d.ts +0 -2
  777. package/dist/record/__tests__/video-texture-view.unit.test.d.ts.map +0 -1
@@ -0,0 +1,90 @@
1
+ import { describe, expect, it } from 'vitest';
2
+ import {
3
+ type AtmosphereParameters,
4
+ type EnvironmentCandidate,
5
+ type EnvironmentFrame,
6
+ type FogCandidate,
7
+ selectEnvironmentFrame,
8
+ } from '../extract/environment';
9
+
10
+ const atmosphereParameters: AtmosphereParameters = {
11
+ turbidity: 2,
12
+ rayleigh: 1,
13
+ mieCoefficient: 0.005,
14
+ mieDirectionalG: 0.8,
15
+ sunAngularRadius: 0.004675,
16
+ };
17
+
18
+ function unwrapFrame(result: ReturnType<typeof selectEnvironmentFrame>): EnvironmentFrame {
19
+ if (!result.ok) throw result.error;
20
+ return result.value;
21
+ }
22
+
23
+ const image = (entityKey: number, sourceKey: string): EnvironmentCandidate => ({
24
+ kind: 'image',
25
+ entityKey,
26
+ sourceKey,
27
+ });
28
+ const atmosphere = (entityKey: number, sourceKey: string): EnvironmentCandidate => ({
29
+ kind: 'atmosphere',
30
+ entityKey,
31
+ sourceKey,
32
+ atmosphere: atmosphereParameters,
33
+ });
34
+ const fog = (entityKey: number): FogCandidate => ({
35
+ entityKey,
36
+ color: [0.4, 0.5, 0.6],
37
+ density: 0.01,
38
+ heightFalloff: 0.2,
39
+ maxOpacity: 0.9,
40
+ });
41
+
42
+ describe('immutable frame plan contract', () => {
43
+ it('selects none, one image, or one atmosphere deterministically', () => {
44
+ expect(unwrapFrame(selectEnvironmentFrame([], [])).source.kind).toBe('none');
45
+ expect(unwrapFrame(selectEnvironmentFrame([image(2, 'image-a')], [])).source).toEqual({
46
+ kind: 'image',
47
+ sourceKey: 'image-a',
48
+ entityKey: 2,
49
+ });
50
+ expect(unwrapFrame(selectEnvironmentFrame([atmosphere(7, 'sky-a')], [])).source).toEqual({
51
+ kind: 'atmosphere',
52
+ sourceKey: 'sky-a',
53
+ entityKey: 7,
54
+ atmosphere: atmosphereParameters,
55
+ });
56
+ });
57
+
58
+ it('rejects mixed source kinds and conflicting source keys', () => {
59
+ expect(selectEnvironmentFrame([image(1, 'a'), atmosphere(2, 'b')], [])).toMatchObject({
60
+ ok: false,
61
+ error: { code: 'environment-source-conflict' },
62
+ });
63
+ expect(selectEnvironmentFrame([image(1, 'a'), image(2, 'b')], [])).toMatchObject({
64
+ ok: false,
65
+ error: { code: 'environment-source-conflict' },
66
+ });
67
+ });
68
+
69
+ it('keeps Fog independent from environment source and bounds cardinality', () => {
70
+ const withoutFog = unwrapFrame(selectEnvironmentFrame([], []));
71
+ expect(withoutFog.fog).toBeUndefined();
72
+ const withFog = unwrapFrame(selectEnvironmentFrame([], [fog(4)]));
73
+ expect(withFog.fog?.entityKey).toBe(4);
74
+ expect(selectEnvironmentFrame([], [fog(4), fog(8)])).toMatchObject({
75
+ ok: false,
76
+ error: { code: 'fog-cardinality' },
77
+ });
78
+ });
79
+
80
+ it('returns detached facts without GPU handles and freezes nested values', () => {
81
+ const result = selectEnvironmentFrame([image(1, 'stable')], [fog(3)]);
82
+ expect(result.ok).toBe(true);
83
+ if (!result.ok) return;
84
+ expect(Object.isFrozen(result.value)).toBe(true);
85
+ expect(Object.isFrozen(result.value.source)).toBe(true);
86
+ expect('device' in result.value).toBe(false);
87
+ expect('texture' in result.value).toBe(false);
88
+ expect('buffer' in result.value).toBe(false);
89
+ });
90
+ });
@@ -1,6 +1,7 @@
1
1
  import { describe, expect, it } from 'vitest';
2
2
  import { createFullscreenRenderFeature } from '../features/fullscreen';
3
3
  import { freezeRenderFeaturePlan } from '../features/plan';
4
+ import { createSceneDataCatalog } from '../temporal/scene-data-catalog';
4
5
 
5
6
  describe('fullscreen RenderFeature plan', () => {
6
7
  it('keeps the cooked effect on the Standard post-stage owner', () => {
@@ -14,6 +15,12 @@ describe('fullscreen RenderFeature plan', () => {
14
15
  frame: { frameNumber: 1 },
15
16
  generation: 1,
16
17
  targets: [{ name: 'scene-color', kind: 'color', format: 'rgba16float', sampleCount: 1 }],
18
+ sceneData: createSceneDataCatalog({
19
+ featureIdentity: 'test::fullscreen',
20
+ generation: 1,
21
+ planIdentity: 'test::fullscreen:1',
22
+ rgba16floatRenderable: true,
23
+ }),
17
24
  });
18
25
 
19
26
  expect(planned.ok).toBe(true);
@@ -4,6 +4,10 @@ import { deriveVertexLayoutProjection } from '@forgeax/engine-geometry';
4
4
  import { RenderGraphBuilder } from '@forgeax/engine-render-graph';
5
5
  import { type RhiNullDevice, rhi } from '@forgeax/engine-rhi-null';
6
6
  import { Transform } from '@forgeax/engine-scene';
7
+ import {
8
+ DEFAULT_STANDARD_PBR_PARAM_SCHEMA,
9
+ DEFAULT_UNLIT_PARAM_SCHEMA,
10
+ } from '@forgeax/engine-shader';
7
11
  import { ok } from '@forgeax/engine-types';
8
12
  import { describe, expect, it } from 'vitest';
9
13
  import { createRenderer as constructRenderer } from '../assembly/factory';
@@ -26,6 +30,61 @@ import { RenderScene } from '../scene/render-scene';
26
30
 
27
31
  const EMPTY_RESOURCE_CLASS = JSON.stringify({ textures: [], samplers: [], video: [] });
28
32
 
33
+ const STANDARD_PBR_URP_VARIANT_KEY =
34
+ 'CLUSTER_FORWARD_AVAILABLE=false+STORAGE_BUFFER_AVAILABLE=true+TRANSMISSION_AVAILABLE=false+VERTEX_COLOR_AVAILABLE=false';
35
+ const STANDARD_PBR_TRANSMISSION_VARIANT_KEY =
36
+ 'CLUSTER_FORWARD_AVAILABLE=false+STORAGE_BUFFER_AVAILABLE=true+TRANSMISSION_AVAILABLE=true+VERTEX_COLOR_AVAILABLE=false';
37
+
38
+ function manifestDataUrl(): string {
39
+ const pbrWgsl = '/* pbr stub - calls f_schlick( */';
40
+ const unlitWgsl = '/* unlit stub */';
41
+ const tonemapWgsl = '/* tonemap stub - struct TonemapParams { exposure: f32 }; */';
42
+ const standardPbrVariant = (transmissionAvailable: boolean, definesKey: string) => ({
43
+ definesKey,
44
+ defines: {
45
+ CLUSTER_FORWARD_AVAILABLE: false,
46
+ STORAGE_BUFFER_AVAILABLE: true,
47
+ TRANSMISSION_AVAILABLE: transmissionAvailable,
48
+ VERTEX_COLOR_AVAILABLE: false,
49
+ },
50
+ composedWgsl: pbrWgsl,
51
+ });
52
+ const materialShader = (
53
+ identifier: string,
54
+ paramSchema: readonly unknown[],
55
+ composedWgsl: string,
56
+ variants: readonly unknown[] = [],
57
+ ) => ({
58
+ identifier,
59
+ sourcePath: `${identifier}.wgsl`,
60
+ composedWgsl,
61
+ paramSchema: JSON.stringify(paramSchema),
62
+ variants,
63
+ });
64
+ return `data:application/json,${encodeURIComponent(
65
+ JSON.stringify({
66
+ schemaVersion: '1.0.0',
67
+ entries: [
68
+ { hash: 'pbr00000', wgsl: pbrWgsl, glsl: '', bindings: '' },
69
+ { hash: 'unlit000', wgsl: unlitWgsl, glsl: '', bindings: '' },
70
+ { hash: 'tonemap0', wgsl: tonemapWgsl, glsl: '', bindings: '' },
71
+ ],
72
+ materialShaders: [
73
+ materialShader(
74
+ 'forgeax::default-standard-pbr',
75
+ DEFAULT_STANDARD_PBR_PARAM_SCHEMA,
76
+ pbrWgsl,
77
+ [
78
+ standardPbrVariant(false, STANDARD_PBR_URP_VARIANT_KEY),
79
+ standardPbrVariant(true, STANDARD_PBR_TRANSMISSION_VARIANT_KEY),
80
+ ],
81
+ ),
82
+ materialShader('forgeax::default-unlit', DEFAULT_UNLIT_PARAM_SCHEMA, unlitWgsl),
83
+ ],
84
+ }),
85
+ )}`;
86
+ }
87
+
29
88
  function snapshot(entityKey: number, assetHandle: number): RenderableSnapshot {
30
89
  const material = {
31
90
  baseColor: new Float32Array([0.25 * entityKey, 0.5, 0.75]),
@@ -293,16 +352,6 @@ describe('GPU-driven production projection', () => {
293
352
  });
294
353
 
295
354
  it('activates inside the renderer-owned URP graph and removes the CPU forward draw', async () => {
296
- const manifest = `data:application/json,${encodeURIComponent(
297
- JSON.stringify({
298
- schemaVersion: '1.0.0',
299
- entries: [
300
- { hash: 'pbr00000', wgsl: '/* pbr stub */', glsl: '', bindings: '' },
301
- { hash: 'unlit000', wgsl: '/* unlit stub */', glsl: '', bindings: '' },
302
- { hash: 'tonemap0', wgsl: '/* tonemap stub */', glsl: '', bindings: '' },
303
- ],
304
- }),
305
- )}`;
306
355
  const canvas = {
307
356
  width: 1,
308
357
  height: 1,
@@ -310,7 +359,11 @@ describe('GPU-driven production projection', () => {
310
359
  addEventListener: () => undefined,
311
360
  removeEventListener: () => undefined,
312
361
  } as unknown as HTMLCanvasElement;
313
- const renderer = await constructRenderer(canvas, { rhi }, { shaderManifestUrl: manifest });
362
+ const renderer = await constructRenderer(
363
+ canvas,
364
+ { rhi },
365
+ { shaderManifestUrl: manifestDataUrl() },
366
+ );
314
367
  expect((await renderer.initialization).ok).toBe(true);
315
368
  const world = new World();
316
369
  expect(renderer.attach(world).ok).toBe(true);
@@ -345,9 +398,14 @@ describe('GPU-driven production projection', () => {
345
398
  'main',
346
399
  ]),
347
400
  );
401
+ expect(renderer.perFramePassNames).toContain('output-transform');
402
+ // Storage-buffer LDR frames keep the scene linear until the one output
403
+ // transform writes the encoded surface; the GPU-driven indirect raster
404
+ // draw and that fullscreen pass are the only draws in this topology.
348
405
  expect(device.totalDrawCount).toBe(2);
349
406
  expect(renderer.renderScene).toMatchObject({
350
407
  worldEntitiesScanned: 0,
408
+ fullRebuilds: 1,
351
409
  projectionRecords: 1,
352
410
  topology: { batchCount: 1, candidateCount: 1 },
353
411
  gpu: { status: 'resident' },
@@ -366,16 +424,6 @@ describe('GPU-driven production projection', () => {
366
424
  });
367
425
 
368
426
  it('keeps a stable multi-World composition resident and patches one World transform', async () => {
369
- const manifest = `data:application/json,${encodeURIComponent(
370
- JSON.stringify({
371
- schemaVersion: '1.0.0',
372
- entries: [
373
- { hash: 'pbr00000', wgsl: '/* pbr stub */', glsl: '', bindings: '' },
374
- { hash: 'unlit000', wgsl: '/* unlit stub */', glsl: '', bindings: '' },
375
- { hash: 'tonemap0', wgsl: '/* tonemap stub */', glsl: '', bindings: '' },
376
- ],
377
- }),
378
- )}`;
379
427
  const canvas = {
380
428
  width: 1,
381
429
  height: 1,
@@ -383,7 +431,11 @@ describe('GPU-driven production projection', () => {
383
431
  addEventListener: () => undefined,
384
432
  removeEventListener: () => undefined,
385
433
  } as unknown as HTMLCanvasElement;
386
- const renderer = await constructRenderer(canvas, { rhi }, { shaderManifestUrl: manifest });
434
+ const renderer = await constructRenderer(
435
+ canvas,
436
+ { rhi },
437
+ { shaderManifestUrl: manifestDataUrl() },
438
+ );
387
439
  expect((await renderer.initialization).ok).toBe(true);
388
440
  const cameraWorld = new World();
389
441
  const sceneWorld = new World();
@@ -221,10 +221,47 @@ describe('GpuDrivenView graph projection', () => {
221
221
  undefined,
222
222
  prepared,
223
223
  );
224
+
225
+ Object.defineProperty(device, 'surfaceViewFormats', {
226
+ configurable: true,
227
+ value: false,
228
+ });
229
+ Object.defineProperty(device, 'caps', {
230
+ configurable: true,
231
+ value: { ...device.caps, rgba16floatRenderable: false },
232
+ });
233
+ expect(compile(preparedFrame(view))).toBeNull();
234
+ expect(errors).toHaveLength(1);
235
+ expect(errors[0]).toMatchObject({
236
+ code: 'webgpu-runtime-error',
237
+ detail: { error: { code: 'surface-raw-endpoint-failed' } },
238
+ });
239
+ errors.length = 0;
240
+ delete (device as unknown as { caps?: unknown }).caps;
241
+ delete (device as unknown as { surfaceViewFormats?: unknown }).surfaceViewFormats;
242
+
224
243
  const compiledPrevious = compile(preparedFrame(view));
225
244
  expect(compiledPrevious).not.toBeNull();
226
245
  if (compiledPrevious === null) return;
227
246
 
247
+ Object.defineProperty(device, 'surfaceViewFormats', {
248
+ configurable: true,
249
+ value: false,
250
+ });
251
+ Object.defineProperty(device, 'caps', {
252
+ configurable: true,
253
+ value: { ...device.caps, rgba16floatRenderable: false },
254
+ });
255
+ expect(compile(preparedFrame(view))).toBe(compiledPrevious);
256
+ expect(errors).toHaveLength(1);
257
+ expect(errors[0]).toMatchObject({
258
+ code: 'webgpu-runtime-error',
259
+ detail: { error: { code: 'surface-raw-endpoint-failed' } },
260
+ });
261
+ errors.length = 0;
262
+ delete (device as unknown as { caps?: unknown }).caps;
263
+ delete (device as unknown as { surfaceViewFormats?: unknown }).surfaceViewFormats;
264
+
228
265
  const secondDelta = projection.apply([{ kind: 'create', snapshot: snapshot(2) }]);
229
266
  sceneAvailability.scene.sync(secondDelta).unwrap();
230
267
  topology.rebuild(projection.slotsSnapshot());
@@ -5,6 +5,7 @@ import { GpuScene } from '../gpu-scene';
5
5
  import { GPU_SCENE_LAYOUTS, gpuSceneFieldOffset } from '../gpu-scene-schema';
6
6
  import type { MaterialSnapshot, RenderableSnapshot } from '../render-system-extract';
7
7
  import { RenderScene } from '../scene/render-scene';
8
+ import { classifySceneDataCoverage } from '../temporal/coverage';
8
9
 
9
10
  interface WriteRecord {
10
11
  readonly offset: number;
@@ -66,6 +67,15 @@ function createDevice(queue: RecordingQueue): RhiNullDevice {
66
67
  }
67
68
 
68
69
  describe('GpuScene', () => {
70
+ it('exposes GPU scene facts as exact temporal coverage', () => {
71
+ const coverage = classifySceneDataCoverage({
72
+ contributors: [{ id: 'gpu-scene', kind: 'exact' }],
73
+ requiredContributorIds: ['gpu-scene'],
74
+ });
75
+ expect(coverage.complete).toBe(true);
76
+ expect(coverage.exactContributorIds).toEqual(['gpu-scene']);
77
+ });
78
+
69
79
  it('uploads only coalesced dirty ranges and performs no upload on no-change', () => {
70
80
  const queue = new RecordingQueue();
71
81
  const created = GpuScene.create(createDevice(queue), 4).unwrap();
@@ -4,11 +4,12 @@ import { appendInjection, INJECTION_KIND_LENGTHS, type InjectionKind } from '../
4
4
 
5
5
  it('derives InjectionKind from the public length-map keys', () => {
6
6
  expectTypeOf<InjectionKind>().toEqualTypeOf<keyof typeof INJECTION_KIND_LENGTHS>();
7
- expectTypeOf<InjectionKind>().toEqualTypeOf<'shadow' | 'ibl' | 'lightmap'>();
7
+ expectTypeOf<InjectionKind>().toEqualTypeOf<'shadow' | 'ibl' | 'lightmap' | 'transmission'>();
8
8
  expectTypeOf<'unknown'>().not.toExtend<InjectionKind>();
9
9
  });
10
10
 
11
11
  it('keeps the public map assignability and appendInjection narrowing', () => {
12
12
  expectTypeOf(INJECTION_KIND_LENGTHS).toMatchTypeOf<Readonly<Record<InjectionKind, number>>>();
13
13
  expectTypeOf(appendInjection).parameter(1).toEqualTypeOf<InjectionKind>();
14
+ expectTypeOf(appendInjection([], 'transmission')).toEqualTypeOf<GPUBindGroupLayoutEntry[]>();
14
15
  });
@@ -343,12 +343,11 @@ async function textureFor(
343
343
  selected,
344
344
  texture: {
345
345
  kind: 'texture',
346
- width: mip.width,
347
- height: mip.height,
346
+ shape: { viewDimension: '2d', extent: { width: mip.width, height: mip.height } },
348
347
  format: selected,
349
348
  data: mip.data,
350
349
  colorSpace: input.colorSpace,
351
- mipmap: false,
350
+ mips: { kind: 'none' },
352
351
  },
353
352
  };
354
353
  }
@@ -377,12 +376,11 @@ async function textureFor(
377
376
  selected,
378
377
  texture: {
379
378
  kind: 'texture',
380
- width: mip.width,
381
- height: mip.height,
379
+ shape: { viewDimension: '2d', extent: { width: mip.width, height: mip.height } },
382
380
  format: selected,
383
381
  data: mip.data,
384
382
  colorSpace: input.colorSpace,
385
- mipmap: false,
383
+ mips: { kind: 'none' },
386
384
  },
387
385
  };
388
386
  }
@@ -392,6 +390,8 @@ async function readbackTexture(
392
390
  texture: TextureAsset,
393
391
  gpuTexture: { readonly handle: Texture },
394
392
  ): Promise<Uint8Array> {
393
+ const width = texture.shape.extent.width;
394
+ const height = texture.shape.extent.height;
395
395
  const hdr = texture.format === 'rgba16float' || texture.format.startsWith('bc6h');
396
396
  const outputFormat: GPUTextureFormat = hdr ? 'rgba16float' : 'rgba8unorm-srgb';
397
397
  const outputBytesPerPixel = hdr ? 8 : 4;
@@ -447,7 +447,7 @@ async function readbackTexture(
447
447
  });
448
448
  if (!bindings.ok) throw new Error(`${bindings.error.code}:${bindings.error.hint}`);
449
449
  const normalizedTexture = device.createTexture({
450
- size: { width: texture.width, height: texture.height, depthOrArrayLayers: 1 },
450
+ size: { width, height, depthOrArrayLayers: 1 },
451
451
  format: outputFormat,
452
452
  usage: 0x10 | 0x01,
453
453
  } as never);
@@ -457,7 +457,7 @@ async function readbackTexture(
457
457
  if (!normalizedView.ok)
458
458
  throw new Error(`${normalizedView.error.code}:${normalizedView.error.hint}`);
459
459
  const readback = device.createBuffer({
460
- size: 256 * texture.height,
460
+ size: 256 * height,
461
461
  usage: GPU_BUFFER_USAGE_COPY_DST | GPU_BUFFER_USAGE_MAP_READ,
462
462
  });
463
463
  if (!readback.ok) throw new Error(`${readback.error.code}:${readback.error.hint}`);
@@ -483,9 +483,9 @@ async function readbackTexture(
483
483
  buffer: readback.value as unknown as GPUBuffer,
484
484
  offset: 0,
485
485
  bytesPerRow: 256,
486
- rowsPerImage: texture.height,
486
+ rowsPerImage: height,
487
487
  },
488
- { width: texture.width, height: texture.height, depthOrArrayLayers: 1 },
488
+ { width, height, depthOrArrayLayers: 1 },
489
489
  );
490
490
  const command = encoder.value.finish();
491
491
  if (!command.ok) throw new Error(`${command.error.code}:${command.error.hint}`);
@@ -497,11 +497,11 @@ async function readbackTexture(
497
497
  const range = mapped.value.getMappedRange();
498
498
  if (!range.ok) throw new Error(`${range.error.code}:${range.error.hint}`);
499
499
  const mappedBytes = new Uint8Array(range.value);
500
- const bytes = new Uint8Array(texture.width * texture.height * outputBytesPerPixel);
501
- for (let row = 0; row < texture.height; row += 1) {
500
+ const bytes = new Uint8Array(width * height * outputBytesPerPixel);
501
+ for (let row = 0; row < height; row += 1) {
502
502
  bytes.set(
503
- mappedBytes.subarray(row * 256, row * 256 + texture.width * outputBytesPerPixel),
504
- row * texture.width * outputBytesPerPixel,
503
+ mappedBytes.subarray(row * 256, row * 256 + width * outputBytesPerPixel),
504
+ row * width * outputBytesPerPixel,
505
505
  );
506
506
  }
507
507
  mapped.value.unmap();
@@ -3,7 +3,9 @@ import {
3
3
  DEFAULT_STANDARD_PBR_PARAM_SCHEMA,
4
4
  DEFAULT_UNLIT_PARAM_SCHEMA,
5
5
  } from '@forgeax/engine-shader';
6
+ import { resolveMaterialAsset } from '@forgeax/engine-types';
6
7
  import { describe, expect, it } from 'vitest';
8
+ import { Materials } from '../materials.js';
7
9
 
8
10
  describe('vertex color does not change the material contract', () => {
9
11
  it('keeps colored and plain materials on the same schema and resource identity', () => {
@@ -21,4 +23,64 @@ describe('vertex color does not change the material contract', () => {
21
23
  expect(JSON.stringify(material)).not.toMatch(/hasColor|VERTEX_COLOR_AVAILABLE|colorBinding/i);
22
24
  expect(material.passes?.[0]?.program).not.toHaveProperty('color');
23
25
  });
26
+
27
+ it.each([
28
+ ['unlit', Materials.unlit([0.5, 0.5, 0.5, 1])],
29
+ ['standard', Materials.standard({ baseColor: [0.5, 0.5, 0.5, 1] })],
30
+ ] as const)('keeps the %s factory fallback aligned with its color schema', (_name, material) => {
31
+ const resolved = resolveMaterialAsset('factory-fallback', {
32
+ 'factory-fallback': material,
33
+ });
34
+ expect(resolved).toMatchObject({ ok: true });
35
+ });
36
+
37
+ it('keeps the standard authoring parameters derived from the shared schema', () => {
38
+ const material = Materials.standard({ baseColor: [1, 1, 1, 1] });
39
+ expect(material.parameters?.map((parameter) => parameter.name)).toEqual(
40
+ DEFAULT_STANDARD_PBR_PARAM_SCHEMA.map((entry) => entry.name),
41
+ );
42
+ expect(material.values).toMatchObject({
43
+ transmission: 0,
44
+ ior: 1.5,
45
+ thickness: 0,
46
+ attenuationColor: [1, 1, 1],
47
+ });
48
+ });
49
+
50
+ it('routes active transmission to Forward and ShadowCaster only', () => {
51
+ const material = Materials.standard({ baseColor: [1, 1, 1, 1], transmission: 0.5 });
52
+ expect(material.passes?.map((pass) => pass.name)).toEqual(['forward', 'shadow-caster']);
53
+ expect(material.passes?.[0]?.renderState).toMatchObject({ depthWriteEnabled: false });
54
+ });
55
+
56
+ it.each([
57
+ ['transmission', { transmission: -0.1 }],
58
+ ['ior', { ior: 0 }],
59
+ ['thickness', { thickness: -0.1 }],
60
+ ['attenuationDistance', { attenuationDistance: 0 }],
61
+ ])('rejects invalid %s before material publication', (_name, options) => {
62
+ expect(() => Materials.standard({ baseColor: [1, 1, 1, 1], ...options })).toThrow();
63
+ });
64
+
65
+ it('rejects BLEND and depth writes for an active transmission material', () => {
66
+ expect(() =>
67
+ Materials.standard({
68
+ baseColor: [1, 1, 1, 1],
69
+ transmission: 0.5,
70
+ renderState: {
71
+ blend: {
72
+ color: { srcFactor: 'one', dstFactor: 'zero', operation: 'add' },
73
+ alpha: { srcFactor: 'one', dstFactor: 'zero', operation: 'add' },
74
+ },
75
+ },
76
+ }),
77
+ ).toThrow();
78
+ expect(() =>
79
+ Materials.standard({
80
+ baseColor: [1, 1, 1, 1],
81
+ transmission: 0.5,
82
+ renderState: { depthWriteEnabled: true },
83
+ }),
84
+ ).toThrow();
85
+ });
24
86
  });
@@ -1,150 +1,22 @@
1
- import type { CookedMaterialRecord } from '@forgeax/engine-pack';
1
+ import { DEFAULT_STANDARD_PBR_PARAM_SCHEMA } from '@forgeax/engine-shader';
2
+ import { derive } from '@forgeax/engine-types';
2
3
  import { describe, expect, it } from 'vitest';
3
- import { assembleMaterialProjection } from '../assembly/material/assembly.js';
4
- import { projectMaterialPipeline } from '../assembly/material/pipeline-projection.js';
5
4
 
6
- function cookedRecord(): CookedMaterialRecord {
7
- return {
8
- schemaVersion: 'material-cook/3',
9
- guid: 'material-leaf' as never,
10
- specializationKey: 'specialization-key',
11
- authored: {
12
- kind: 'material',
13
- parent: 'material-parent' as never,
14
- values: { baseColor: [1, 0, 0, 1] },
15
- },
16
- resolved: {
17
- passes: [
18
- {
19
- name: 'forward',
20
- program: {
21
- module: 'project::standard',
22
- vertexEntry: 'vs_main',
23
- fragmentEntry: 'fs_main',
24
- },
25
- renderState: { blend: 'opaque' },
26
- },
27
- ],
28
- parameters: [{ name: 'baseColor', type: 'color' }],
29
- values: { baseColor: [0.2, 0.3, 0.4, 1] },
30
- },
31
- refs: {
32
- parent: ['material-parent'],
33
- textures: [],
34
- samplers: [],
35
- modules: ['project::standard'],
36
- },
37
- artifact: {
38
- mediaType: 'text/wgsl',
39
- path: 'material-leaf.wgsl',
40
- digest: 'sha256:artifact',
41
- bytes: new Uint8Array([1, 2, 3]),
42
- },
43
- receipt: {
44
- schemaVersion: 'material-cook/3',
45
- sourceClosure: ['project::standard'],
46
- profile: 'forgeax-material-wgsl-v1',
47
- compilerVersion: 'compiler/1',
48
- identity: {
49
- materialContractDigest: 'sha256:contract',
50
- sourceRevision: 'sha256:source',
51
- sourceClosureDigest: 'sha256:closure',
52
- layoutIdentity: 'sha256:layout',
53
- programIdentity: 'sha256:program',
54
- pipelineIdentity: 'sha256:pipeline',
55
- materialPublicationIdentity: 'sha256:publication',
56
- cookIdentity: 'sha256:input',
57
- compilerFingerprint: 'sha256:compiler',
58
- wasm: {
59
- sourceContentKey: 'unavailable',
60
- artifactSha256: 'unavailable',
61
- glueSha256: 'unavailable',
62
- },
63
- artifactDigest: 'sha256:artifact',
64
- valueGeneration: 1,
65
- dependencyGeneration: 1,
66
- cookGeneration: 1,
67
- },
68
- derivedInterface: { layoutIdentity: 'sha256:layout' },
69
- },
70
- };
71
- }
72
-
73
- describe('cooked material render projection', () => {
74
- it('projects cooked passes and artifact identity without exposing authored inheritance', () => {
75
- const projection = assembleMaterialProjection(cookedRecord());
76
-
77
- expect(projection).toMatchObject({
78
- materialGuid: 'material-leaf',
79
- specializationKey: 'specialization-key',
80
- artifactHash: 'sha256:artifact',
81
- passes: [
82
- {
83
- name: 'forward',
84
- module: 'project::standard',
85
- vertexEntry: 'vs_main',
86
- fragmentEntry: 'fs_main',
87
- },
88
- ],
89
- });
90
- expect('authored' in projection).toBe(false);
91
- expect(projection.passes[0]?.artifactHash).toBe('sha256:artifact');
92
- });
93
-
94
- it('builds a pipeline projection from the cooked artifact, not the parent chain', () => {
95
- const projection = assembleMaterialProjection(cookedRecord());
96
- const pipeline = projectMaterialPipeline(projection);
97
-
98
- expect(pipeline).toEqual({
99
- specializationKey: 'specialization-key',
100
- artifactHash: 'sha256:artifact',
101
- passes: projection.passes,
102
- });
103
- });
104
-
105
- it('keeps projections isolated when adjacent slots use different cooked identities', () => {
106
- const firstRecord = cookedRecord();
107
- const secondRecord: CookedMaterialRecord = {
108
- ...firstRecord,
109
- guid: 'material-slot-2' as never,
110
- authored: {
111
- kind: 'material',
112
- ...firstRecord.authored,
113
- parent: 'material-parent-2' as never,
114
- values: { baseColor: [0, 1, 0, 1] },
115
- },
116
- resolved: {
117
- ...firstRecord.resolved,
118
- values: { baseColor: [0.8, 0.1, 0.2, 1] },
119
- },
120
- artifact: {
121
- ...firstRecord.artifact,
122
- path: 'material-slot-2.wgsl',
123
- digest: 'sha256:artifact-2',
124
- bytes: new Uint8Array([4, 5, 6]),
125
- },
126
- receipt: {
127
- ...firstRecord.receipt,
128
- identity: {
129
- ...firstRecord.receipt.identity,
130
- cookIdentity: 'sha256:input-2',
131
- artifactDigest: 'sha256:artifact-2',
132
- },
133
- },
134
- specializationKey: 'specialization-key-2',
135
- };
136
-
137
- const first = assembleMaterialProjection(firstRecord);
138
- const second = assembleMaterialProjection(secondRecord);
139
-
140
- expect(second).not.toBe(first);
141
- expect(first.materialGuid).toBe('material-leaf');
142
- expect(first.specializationKey).toBe('specialization-key');
143
- expect(first.artifactHash).toBe('sha256:artifact');
144
- expect(second.materialGuid).toBe('material-slot-2');
145
- expect(second.specializationKey).toBe('specialization-key-2');
146
- expect(second.artifactHash).toBe('sha256:artifact-2');
147
- expect(second.runtimeValues).not.toBe(first.runtimeValues);
148
- expect('authored' in second).toBe(false);
5
+ describe('standard material cooked projection', () => {
6
+ it('uses one schema for reflection, uniform layout, and resource bindings', () => {
7
+ const derived = derive(DEFAULT_STANDARD_PBR_PARAM_SCHEMA);
8
+ const names = derived.numericMembers.map((member) => member.name);
9
+ expect(names).toEqual(expect.arrayContaining(['transmission', 'ior', 'thickness']));
10
+ expect(derived.coordinateRecords.map((record) => record.parameter)).toEqual(
11
+ expect.arrayContaining(['transmissionTexture', 'thicknessTexture']),
12
+ );
13
+ expect(derived.resourceBindings.map((binding) => binding.name)).toEqual(
14
+ expect.arrayContaining([
15
+ 'transmissionTexture_sampler',
16
+ 'transmissionTexture',
17
+ 'thicknessTexture_sampler',
18
+ 'thicknessTexture',
19
+ ]),
20
+ );
149
21
  });
150
22
  });