@forgeax/engine-render 0.1.6 → 0.1.19

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 (713) hide show
  1. package/README.md +279 -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 +19 -2
  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/material/assembly.d.ts.map +1 -1
  10. package/dist/assembly/renderer-frame-transaction.d.ts +39 -0
  11. package/dist/assembly/renderer-frame-transaction.d.ts.map +1 -0
  12. package/dist/assembly/renderer-inspection.d.ts +22 -0
  13. package/dist/assembly/renderer-inspection.d.ts.map +1 -0
  14. package/dist/assembly/renderer-lifecycle.d.ts +4 -0
  15. package/dist/assembly/renderer-lifecycle.d.ts.map +1 -0
  16. package/dist/authoring.d.ts +1 -0
  17. package/dist/authoring.d.ts.map +1 -1
  18. package/dist/authoring.mjs +4 -2
  19. package/dist/authoring.mjs.map +1 -1
  20. package/dist/chunk-FJ6P52EE.mjs +46 -0
  21. package/dist/chunk-FJ6P52EE.mjs.map +1 -0
  22. package/dist/chunk-IPXCABEP.mjs +73 -0
  23. package/dist/chunk-IPXCABEP.mjs.map +1 -0
  24. package/dist/chunk-JDWARUOI.mjs +44 -0
  25. package/dist/chunk-JDWARUOI.mjs.map +1 -0
  26. package/dist/chunk-LOSO4CTV.mjs +901 -0
  27. package/dist/chunk-LOSO4CTV.mjs.map +1 -0
  28. package/dist/chunk-PCHBPYML.mjs +385 -0
  29. package/dist/chunk-PCHBPYML.mjs.map +1 -0
  30. package/dist/chunk-RJRUS55L.mjs +9323 -0
  31. package/dist/chunk-RJRUS55L.mjs.map +1 -0
  32. package/dist/{chunk-QC4VW3XJ.mjs → chunk-RXZ3RGOU.mjs} +4 -30
  33. package/dist/chunk-RXZ3RGOU.mjs.map +1 -0
  34. package/dist/{chunk-CQXZC5XI.mjs → chunk-VFPLTKCU.mjs} +79 -69
  35. package/dist/chunk-VFPLTKCU.mjs.map +1 -0
  36. package/dist/{chunk-SCRSAK5B.mjs → chunk-YTQ5C7YQ.mjs} +231 -127
  37. package/dist/chunk-YTQ5C7YQ.mjs.map +1 -0
  38. package/dist/components/atmosphere.d.ts +9 -0
  39. package/dist/components/atmosphere.d.ts.map +1 -0
  40. package/dist/components/camera.d.ts +2 -1
  41. package/dist/components/camera.d.ts.map +1 -1
  42. package/dist/components/fog.d.ts +8 -0
  43. package/dist/components/fog.d.ts.map +1 -0
  44. package/dist/components/index.d.ts +5 -0
  45. package/dist/components/index.d.ts.map +1 -1
  46. package/dist/components/lines.d.ts +5 -0
  47. package/dist/components/lines.d.ts.map +1 -0
  48. package/dist/components/motion-blur.d.ts +7 -0
  49. package/dist/components/motion-blur.d.ts.map +1 -0
  50. package/dist/components/points.d.ts +15 -0
  51. package/dist/components/points.d.ts.map +1 -0
  52. package/dist/construct-renderer.d.ts +2 -2
  53. package/dist/construct-renderer.d.ts.map +1 -1
  54. package/dist/construct-renderer.mjs +11419 -16442
  55. package/dist/construct-renderer.mjs.map +1 -1
  56. package/dist/device/device-scope.d.ts +4 -0
  57. package/dist/device/device-scope.d.ts.map +1 -1
  58. package/dist/environment/frame.d.ts +60 -0
  59. package/dist/environment/frame.d.ts.map +1 -0
  60. package/dist/environment/generation.d.ts +21 -0
  61. package/dist/environment/generation.d.ts.map +1 -0
  62. package/dist/environment/graph.d.ts +4 -0
  63. package/dist/environment/graph.d.ts.map +1 -0
  64. package/dist/environment/inspection.d.ts +48 -0
  65. package/dist/environment/inspection.d.ts.map +1 -0
  66. package/dist/environment/lifecycle.d.ts +39 -0
  67. package/dist/environment/lifecycle.d.ts.map +1 -0
  68. package/dist/environment/signature.d.ts +25 -0
  69. package/dist/environment/signature.d.ts.map +1 -0
  70. package/dist/errors/render.d.ts +217 -1
  71. package/dist/errors/render.d.ts.map +1 -1
  72. package/dist/extract/camera.d.ts +5 -0
  73. package/dist/extract/camera.d.ts.map +1 -0
  74. package/dist/extract/environment.d.ts +74 -0
  75. package/dist/extract/environment.d.ts.map +1 -0
  76. package/dist/extract/visibility.d.ts +1 -1
  77. package/dist/extract/visibility.d.ts.map +1 -1
  78. package/dist/features/host.d.ts +9 -2
  79. package/dist/features/host.d.ts.map +1 -1
  80. package/dist/features/motion-blur/motion-blur-feature.d.ts +16 -0
  81. package/dist/features/motion-blur/motion-blur-feature.d.ts.map +1 -0
  82. package/dist/features/motion-blur/motion-blur-params.d.ts +25 -0
  83. package/dist/features/motion-blur/motion-blur-params.d.ts.map +1 -0
  84. package/dist/features/plan.d.ts +17 -2
  85. package/dist/features/plan.d.ts.map +1 -1
  86. package/dist/features/prepared-gpu-work.d.ts +3 -1
  87. package/dist/features/prepared-gpu-work.d.ts.map +1 -1
  88. package/dist/features/prepared-graphics.d.ts +2 -1
  89. package/dist/features/prepared-graphics.d.ts.map +1 -1
  90. package/dist/features/render-graph-raster.d.ts +7 -2
  91. package/dist/features/render-graph-raster.d.ts.map +1 -1
  92. package/dist/features/targets.d.ts +3 -0
  93. package/dist/features/targets.d.ts.map +1 -1
  94. package/dist/features/types.d.ts +12 -0
  95. package/dist/features/types.d.ts.map +1 -1
  96. package/dist/fullscreen-post-process-pass.d.ts +7 -1
  97. package/dist/fullscreen-post-process-pass.d.ts.map +1 -1
  98. package/dist/gpu-driven/production-raster.d.ts.map +1 -1
  99. package/dist/gpu-scene.d.ts +2 -0
  100. package/dist/gpu-scene.d.ts.map +1 -1
  101. package/dist/ibl/skylight-bind-group.d.ts +5 -6
  102. package/dist/ibl/skylight-bind-group.d.ts.map +1 -1
  103. package/dist/index.d.ts +21 -6
  104. package/dist/index.d.ts.map +1 -1
  105. package/dist/index.mjs +8 -4
  106. package/dist/index.mjs.map +1 -1
  107. package/dist/inspection-types.d.ts +46 -1
  108. package/dist/inspection-types.d.ts.map +1 -1
  109. package/dist/internal.d.ts +2 -0
  110. package/dist/internal.d.ts.map +1 -1
  111. package/dist/internal.mjs +2 -0
  112. package/dist/materials.d.ts +22 -0
  113. package/dist/materials.d.ts.map +1 -1
  114. package/dist/pbr-pipeline.d.ts +12 -6
  115. package/dist/pbr-pipeline.d.ts.map +1 -1
  116. package/dist/pipeline/standard-forward-lane.d.ts.map +1 -1
  117. package/dist/pipeline/standard-pipeline.d.ts +3 -0
  118. package/dist/pipeline/standard-pipeline.d.ts.map +1 -1
  119. package/dist/pipeline/standard-post.d.ts +48 -0
  120. package/dist/pipeline/standard-post.d.ts.map +1 -0
  121. package/dist/pipeline/standard-profile.d.ts +3 -6
  122. package/dist/pipeline/standard-profile.d.ts.map +1 -1
  123. package/dist/pipeline-builder.d.ts +18 -0
  124. package/dist/pipeline-builder.d.ts.map +1 -1
  125. package/dist/pipeline-spec.d.ts.map +1 -1
  126. package/dist/plugin.d.ts.map +1 -1
  127. package/dist/points-lines/admission.d.ts +36 -0
  128. package/dist/points-lines/admission.d.ts.map +1 -0
  129. package/dist/points-lines/bounds.d.ts +8 -0
  130. package/dist/points-lines/bounds.d.ts.map +1 -0
  131. package/dist/points-lines/expansion-cache.d.ts +28 -0
  132. package/dist/points-lines/expansion-cache.d.ts.map +1 -0
  133. package/dist/points-lines/inspection.d.ts +53 -0
  134. package/dist/points-lines/inspection.d.ts.map +1 -0
  135. package/dist/points-lines/prepare.d.ts +67 -0
  136. package/dist/points-lines/prepare.d.ts.map +1 -0
  137. package/dist/points-lines/record.d.ts +60 -0
  138. package/dist/points-lines/record.d.ts.map +1 -0
  139. package/dist/points-lines/snapshot.d.ts +49 -0
  140. package/dist/points-lines/snapshot.d.ts.map +1 -0
  141. package/dist/record/frame-lighting.d.ts.map +1 -1
  142. package/dist/record/frame-snapshot.d.ts +100 -5
  143. package/dist/record/frame-snapshot.d.ts.map +1 -1
  144. package/dist/record/frame-targets.d.ts.map +1 -1
  145. package/dist/record/frame.d.ts +4 -2
  146. package/dist/record/frame.d.ts.map +1 -1
  147. package/dist/record/main-pass-geometry.d.ts +18 -0
  148. package/dist/record/main-pass-geometry.d.ts.map +1 -1
  149. package/dist/record/main-pass-material.d.ts +8 -5
  150. package/dist/record/main-pass-material.d.ts.map +1 -1
  151. package/dist/record/main-pass-sprite-draws.d.ts +8 -1
  152. package/dist/record/main-pass-sprite-draws.d.ts.map +1 -1
  153. package/dist/record/main-pass.d.ts +2 -0
  154. package/dist/record/main-pass.d.ts.map +1 -1
  155. package/dist/record/mesh-ssbo.d.ts.map +1 -1
  156. package/dist/record/render-context.d.ts +93 -18
  157. package/dist/record/render-context.d.ts.map +1 -1
  158. package/dist/record/shadow-pass.d.ts.map +1 -1
  159. package/dist/record/skybox-post-pass.d.ts +1 -11
  160. package/dist/record/skybox-post-pass.d.ts.map +1 -1
  161. package/dist/record/typed-frame-graph.d.ts +26 -2
  162. package/dist/record/typed-frame-graph.d.ts.map +1 -1
  163. package/dist/record/view-ubo.d.ts +10 -1
  164. package/dist/record/view-ubo.d.ts.map +1 -1
  165. package/dist/render-contract.d.ts +102 -10
  166. package/dist/render-contract.d.ts.map +1 -1
  167. package/dist/render-graph-primitives.d.ts.map +1 -1
  168. package/dist/render-pipeline.d.ts +50 -6
  169. package/dist/render-pipeline.d.ts.map +1 -1
  170. package/dist/render-system-extract.d.ts +32 -5
  171. package/dist/render-system-extract.d.ts.map +1 -1
  172. package/dist/render-system.d.ts +27 -5
  173. package/dist/render-system.d.ts.map +1 -1
  174. package/dist/scene/render-scene-types.d.ts +3 -0
  175. package/dist/scene/render-scene-types.d.ts.map +1 -1
  176. package/dist/scene/render-scene.d.ts +43 -2
  177. package/dist/scene/render-scene.d.ts.map +1 -1
  178. package/dist/temporal/coverage.d.ts +42 -0
  179. package/dist/temporal/coverage.d.ts.map +1 -0
  180. package/dist/temporal/frame-coordinator.d.ts +99 -0
  181. package/dist/temporal/frame-coordinator.d.ts.map +1 -0
  182. package/dist/temporal/gpu.d.ts +39 -0
  183. package/dist/temporal/gpu.d.ts.map +1 -0
  184. package/dist/temporal/history.d.ts +37 -0
  185. package/dist/temporal/history.d.ts.map +1 -0
  186. package/dist/temporal/index.d.ts +7 -0
  187. package/dist/temporal/index.d.ts.map +1 -0
  188. package/dist/temporal/index.mjs +8 -0
  189. package/dist/temporal/index.mjs.map +1 -0
  190. package/dist/temporal/inspection.d.ts +36 -0
  191. package/dist/temporal/inspection.d.ts.map +1 -0
  192. package/dist/temporal/scene-data-catalog.d.ts +48 -0
  193. package/dist/temporal/scene-data-catalog.d.ts.map +1 -0
  194. package/dist/temporal/scene-data.d.ts +43 -0
  195. package/dist/temporal/scene-data.d.ts.map +1 -0
  196. package/dist/temporal/standard-scene-data.d.ts +61 -0
  197. package/dist/temporal/standard-scene-data.d.ts.map +1 -0
  198. package/dist/temporal/taa-history-resources.d.ts +22 -0
  199. package/dist/temporal/taa-history-resources.d.ts.map +1 -0
  200. package/dist/temporal/taa-history-store.d.ts +27 -0
  201. package/dist/temporal/taa-history-store.d.ts.map +1 -0
  202. package/dist/temporal/taa-resolve.d.ts +15 -0
  203. package/dist/temporal/taa-resolve.d.ts.map +1 -0
  204. package/dist/temporal/temporal-view.d.ts +40 -0
  205. package/dist/temporal/temporal-view.d.ts.map +1 -0
  206. package/dist/temporal/transaction.d.ts +9 -0
  207. package/dist/temporal/transaction.d.ts.map +1 -0
  208. package/dist/temporal/view.d.ts +56 -0
  209. package/dist/temporal/view.d.ts.map +1 -0
  210. package/dist/transmission/backdrop.d.ts +147 -0
  211. package/dist/transmission/backdrop.d.ts.map +1 -0
  212. package/dist/transmission/inspection.d.ts +57 -0
  213. package/dist/transmission/inspection.d.ts.map +1 -0
  214. package/dist/transmission/oracle.d.ts +42 -0
  215. package/dist/transmission/oracle.d.ts.map +1 -0
  216. package/dist/transmission/projection.d.ts +37 -0
  217. package/dist/transmission/projection.d.ts.map +1 -0
  218. package/dist/typed-render-graph-primitives.d.ts +25 -2
  219. package/dist/typed-render-graph-primitives.d.ts.map +1 -1
  220. package/package.json +24 -19
  221. package/src/__tests__/ai-user-cold-start.integration.test.ts +59 -0
  222. package/src/__tests__/ai-user-public-surface.test-d.ts +45 -0
  223. package/src/__tests__/authoring-path.unit.test.ts +9 -0
  224. package/src/__tests__/bloom-exact-zero.unit.test.ts +202 -0
  225. package/src/__tests__/bloom-lifecycle.integration.test.ts +125 -0
  226. package/src/__tests__/construct-renderer-identity.unit.test.ts +4 -3
  227. package/src/__tests__/detached-inspection.integration.test.ts +177 -0
  228. package/src/__tests__/environment-fog-lanes.integration.test.ts +219 -0
  229. package/src/__tests__/environment-generation.integration.test.ts +141 -0
  230. package/src/__tests__/environment-selection.unit.test.ts +245 -0
  231. package/src/__tests__/factory-contract.integration.test.ts +1380 -9
  232. package/src/__tests__/frame-plan-contract.unit.test.ts +90 -0
  233. package/src/__tests__/fullscreen-feature-plan.unit.test.ts +7 -0
  234. package/src/__tests__/gpu-driven-indirect-raster-evidence.ts +12 -2
  235. package/src/__tests__/gpu-driven-production.integration.test.ts +74 -22
  236. package/src/__tests__/gpu-driven-view-graph.integration.test.ts +37 -0
  237. package/src/__tests__/gpu-scene.unit.test.ts +10 -0
  238. package/src/__tests__/injection-kind-owner.test-d.ts +2 -1
  239. package/src/__tests__/material-contract-inventory.unit.test.ts +62 -0
  240. package/src/__tests__/material-cooked-projection.unit.test.ts +18 -124
  241. package/src/__tests__/material-static-dynamic-route.unit.test.ts +28 -28
  242. package/src/__tests__/materials-transmission-validation.unit.test.ts +36 -0
  243. package/src/__tests__/morph-feature-plan.unit.test.ts +7 -0
  244. package/src/__tests__/motion-blur.pixel.integration.test.ts +121 -0
  245. package/src/__tests__/public-surface.test-d.ts +15 -1
  246. package/src/__tests__/render-error-code-owner.test-d.ts +15 -0
  247. package/src/__tests__/render-error-detail-ssot.test-d.ts +11 -2
  248. package/src/__tests__/render-error-exhaustive.test-d.ts +22 -0
  249. package/src/__tests__/render-feature-errors.unit.test.ts +33 -3
  250. package/src/__tests__/render-feature-gpu-work.integration.test.ts +44 -0
  251. package/src/__tests__/render-feature-plan.test-d.ts +22 -89
  252. package/src/__tests__/render-scene-projection.unit.test.ts +28 -0
  253. package/src/__tests__/render-temporal-environment-consumer.browser.test.ts +26 -0
  254. package/src/__tests__/render-temporal-environment-consumer.dawn.test.ts +21 -0
  255. package/src/__tests__/renderer-factory-material-contract.unit.test.ts +433 -1
  256. package/src/__tests__/renderer-frame-transaction.integration.test.ts +405 -0
  257. package/src/__tests__/renderer-lifecycle.integration.test.ts +22 -0
  258. package/src/__tests__/scene-data-catalog.unit.test.ts +59 -0
  259. package/src/__tests__/scene-data-consumer.integration.test.ts +67 -0
  260. package/src/__tests__/scene-data-contract.test-d.ts +35 -0
  261. package/src/__tests__/scene-data-inspection.unit.test.ts +41 -0
  262. package/src/__tests__/scene-data-public-surface.test-d.ts +34 -0
  263. package/src/__tests__/shader-manifest-fixture.ts +111 -0
  264. package/src/__tests__/skinned-shadow-caster.test.ts +102 -0
  265. package/src/__tests__/standard-clustered-pipeline.unit.test.ts +24 -3
  266. package/src/__tests__/standard-pipeline.dawn.test.ts +15 -0
  267. package/src/__tests__/standard-pipeline.integration.test.ts +543 -1
  268. package/src/__tests__/standard-profile-oracle.unit.test.ts +10 -2
  269. package/src/__tests__/standard-temporal-producer.integration.test.ts +35 -0
  270. package/src/__tests__/surface-configuration.unit.test.ts +211 -12
  271. package/src/__tests__/taa-transaction.integration.test.ts +30 -0
  272. package/src/__tests__/temporal-admission.integration.test.ts +40 -0
  273. package/src/__tests__/temporal-coverage.unit.test.ts +35 -0
  274. package/src/__tests__/temporal-demand.unit.test.ts +44 -0
  275. package/src/__tests__/temporal-frame-coordinator.unit.test.ts +64 -0
  276. package/src/__tests__/temporal-graph-topology.unit.test.ts +51 -0
  277. package/src/__tests__/temporal-history-lifecycle.unit.test.ts +170 -0
  278. package/src/__tests__/temporal-performance.integration.test.ts +615 -0
  279. package/src/__tests__/temporal-reset-matrix.unit.test.ts +97 -0
  280. package/src/__tests__/temporal-transaction.integration.test.ts +60 -0
  281. package/src/__tests__/temporal-view.unit.test.ts +152 -0
  282. package/src/__tests__/transmission-prewarm.unit.test.ts +93 -0
  283. package/src/__tests__/typed-pipeline-topology.unit.test.ts +230 -1
  284. package/src/__tests__/urp-pipeline-targets.unit.test.ts +25 -1
  285. package/src/__tests__/urp-pipeline.unit.test.ts +4 -3
  286. package/src/__tests__/visibility-extract.integration.test.ts +27 -1
  287. package/src/__tests__/visibility-producer-matrix.integration.test.ts +10 -0
  288. package/src/assembly/backend-contract.ts +47 -1
  289. package/src/assembly/factory.ts +1295 -507
  290. package/src/assembly/host-contract.ts +4 -0
  291. package/src/assembly/material/assembly.ts +2 -5
  292. package/src/assembly/renderer-frame-transaction.ts +75 -0
  293. package/src/assembly/renderer-inspection.ts +112 -0
  294. package/src/assembly/renderer-lifecycle.ts +6 -0
  295. package/src/authoring.ts +1 -0
  296. package/src/components/__tests__/motion-blur.unit.test.ts +14 -0
  297. package/src/components/__tests__/points-lines-admission.unit.test.ts +219 -0
  298. package/src/components/__tests__/points-lines-schema.unit.test.ts +56 -0
  299. package/src/components/__tests__/schema-contract.unit.test.ts +6 -1
  300. package/src/components/atmosphere.ts +10 -0
  301. package/src/components/camera.ts +2 -1
  302. package/src/components/fog.ts +9 -0
  303. package/src/components/index.ts +10 -0
  304. package/src/components/lines.ts +18 -0
  305. package/src/components/motion-blur.ts +8 -0
  306. package/src/components/points.ts +40 -0
  307. package/src/construct-renderer.ts +40 -3
  308. package/src/device/device-scope.ts +15 -1
  309. package/src/environment/frame.ts +185 -0
  310. package/src/environment/generation.ts +23 -0
  311. package/src/environment/graph.ts +9 -0
  312. package/src/environment/inspection.ts +87 -0
  313. package/src/environment/lifecycle.ts +250 -0
  314. package/src/environment/signature.ts +55 -0
  315. package/src/errors/render.ts +429 -1
  316. package/src/extract/camera.ts +78 -0
  317. package/src/extract/environment.ts +171 -0
  318. package/src/extract/visibility.ts +38 -19
  319. package/src/features/host.ts +36 -5
  320. package/src/features/motion-blur/__tests__/motion-blur-feature.unit.test.ts +67 -0
  321. package/src/features/motion-blur/__tests__/motion-blur-params.unit.test.ts +53 -0
  322. package/src/features/motion-blur/motion-blur-feature.ts +119 -0
  323. package/src/features/motion-blur/motion-blur-params.ts +89 -0
  324. package/src/features/plan.ts +32 -3
  325. package/src/features/prepared-gpu-work.ts +21 -6
  326. package/src/features/prepared-graphics.ts +2 -1
  327. package/src/features/render-graph-raster.ts +24 -4
  328. package/src/features/targets.ts +24 -2
  329. package/src/features/types.ts +13 -0
  330. package/src/fullscreen-post-process-pass.ts +34 -4
  331. package/src/gpu-driven/production-raster.ts +6 -1
  332. package/src/gpu-scene.ts +24 -0
  333. package/src/ibl/skylight-bind-group.ts +30 -38
  334. package/src/index.ts +83 -6
  335. package/src/inspection-types.ts +52 -0
  336. package/src/internal.ts +5 -0
  337. package/src/materials.ts +119 -24
  338. package/src/pbr-pipeline.ts +66 -20
  339. package/src/pipeline/standard-forward-lane.ts +158 -101
  340. package/src/pipeline/standard-pipeline.ts +156 -105
  341. package/src/pipeline/standard-post.ts +373 -0
  342. package/src/pipeline/standard-profile.ts +11 -11
  343. package/src/pipeline-builder.ts +102 -12
  344. package/src/pipeline-spec.ts +9 -0
  345. package/src/plugin.ts +6 -0
  346. package/src/points-lines/__tests__/bounds.unit.test.ts +21 -0
  347. package/src/points-lines/__tests__/cache-recovery.unit.test.ts +157 -0
  348. package/src/points-lines/__tests__/inspection-lanes.integration.test.ts +146 -0
  349. package/src/points-lines/__tests__/inspection.unit.test.ts +173 -0
  350. package/src/points-lines/__tests__/lane-structural.integration.test.ts +122 -0
  351. package/src/points-lines/__tests__/points-lines.bench.ts +400 -0
  352. package/src/points-lines/__tests__/raster-lane.integration.test.ts +44 -0
  353. package/src/points-lines/__tests__/snapshot.unit.test.ts +101 -0
  354. package/src/points-lines/__tests__/view-ubo.unit.test.ts +73 -0
  355. package/src/points-lines/admission.ts +238 -0
  356. package/src/points-lines/bounds.ts +23 -0
  357. package/src/points-lines/expansion-cache.ts +215 -0
  358. package/src/points-lines/inspection.ts +97 -0
  359. package/src/points-lines/prepare.ts +177 -0
  360. package/src/points-lines/record.ts +125 -0
  361. package/src/points-lines/snapshot.ts +130 -0
  362. package/src/record/__tests__/fullscreen-temporal-routing.unit.test.ts +25 -0
  363. package/src/record/__tests__/main-pass-geometry.unit.test.ts +47 -0
  364. package/src/record/__tests__/material-bg-cache.unit.test.ts +12 -1
  365. package/src/record/__tests__/material-pipeline-pending-cache.unit.test.ts +22 -0
  366. package/src/record/__tests__/sprite-material-abi.unit.test.ts +75 -0
  367. package/src/record/__tests__/standard-pbr-ubo-layout.unit.test.ts +67 -0
  368. package/src/record/__tests__/temporal-payload.unit.test.ts +164 -0
  369. package/src/record/__tests__/typed-frame-graph-plan.unit.test.ts +127 -0
  370. package/src/record/frame-lighting.ts +14 -2
  371. package/src/record/frame-snapshot.ts +129 -5
  372. package/src/record/frame-targets.ts +15 -6
  373. package/src/record/frame.ts +119 -4
  374. package/src/record/main-pass-geometry.ts +178 -40
  375. package/src/record/main-pass-material.ts +114 -66
  376. package/src/record/main-pass-sprite-draws.ts +79 -102
  377. package/src/record/main-pass.ts +83 -7
  378. package/src/record/mesh-ssbo.ts +22 -3
  379. package/src/record/render-context.ts +209 -23
  380. package/src/record/shadow-pass.ts +129 -28
  381. package/src/record/skybox-post-pass.ts +99 -42
  382. package/src/record/typed-frame-graph.ts +582 -42
  383. package/src/record/view-ubo.ts +99 -4
  384. package/src/render-contract.ts +121 -7
  385. package/src/render-graph-primitives.ts +18 -1
  386. package/src/render-pipeline.ts +100 -27
  387. package/src/render-system-extract.ts +264 -77
  388. package/src/render-system.ts +786 -43
  389. package/src/scene/render-scene-types.ts +3 -0
  390. package/src/scene/render-scene.ts +307 -9
  391. package/src/temporal/__tests__/taa-history-resources.unit.test.ts +45 -0
  392. package/src/temporal/coverage.ts +76 -0
  393. package/src/temporal/frame-coordinator.ts +311 -0
  394. package/src/temporal/gpu.ts +287 -0
  395. package/src/temporal/history.ts +92 -0
  396. package/src/temporal/index.ts +6 -0
  397. package/src/temporal/inspection.ts +97 -0
  398. package/src/temporal/scene-data-catalog.ts +200 -0
  399. package/src/temporal/scene-data.ts +149 -0
  400. package/src/temporal/standard-scene-data.ts +182 -0
  401. package/src/temporal/taa-history-resources.ts +128 -0
  402. package/src/temporal/taa-history-store.ts +79 -0
  403. package/src/temporal/taa-resolve.ts +34 -0
  404. package/src/temporal/temporal-view.ts +169 -0
  405. package/src/temporal/transaction.ts +17 -0
  406. package/src/temporal/view.ts +161 -0
  407. package/src/transmission/__tests__/capability.unit.test.ts +83 -0
  408. package/src/transmission/__tests__/composition.integration.test.ts +161 -0
  409. package/src/transmission/__tests__/inspection.unit.test.ts +241 -0
  410. package/src/transmission/__tests__/lifecycle.integration.test.ts +96 -0
  411. package/src/transmission/__tests__/oracle.unit.test.ts +131 -0
  412. package/src/transmission/__tests__/projection.unit.test.ts +71 -0
  413. package/src/transmission/__tests__/standard-transmission.dawn.test.ts +438 -0
  414. package/src/transmission/__tests__/transmission-backdrop-topology.unit.test.ts +109 -0
  415. package/src/transmission/__tests__/transmission-backdrop.dawn.test.ts +105 -0
  416. package/src/transmission/backdrop.ts +572 -0
  417. package/src/transmission/inspection.ts +190 -0
  418. package/src/transmission/oracle.ts +141 -0
  419. package/src/transmission/projection.ts +83 -0
  420. package/src/typed-render-graph-primitives.ts +162 -9
  421. package/dist/__tests__/authoring-path.unit.test.d.ts +0 -2
  422. package/dist/__tests__/authoring-path.unit.test.d.ts.map +0 -1
  423. package/dist/__tests__/backend-selection-rhi-capture.test-d.d.ts +0 -2
  424. package/dist/__tests__/backend-selection-rhi-capture.test-d.d.ts.map +0 -1
  425. package/dist/__tests__/callback-inference.test-d.d.ts +0 -2
  426. package/dist/__tests__/callback-inference.test-d.d.ts.map +0 -1
  427. package/dist/__tests__/cluster-binner.test.d.ts +0 -2
  428. package/dist/__tests__/cluster-binner.test.d.ts.map +0 -1
  429. package/dist/__tests__/cluster-grid-default-surface.unit.test.d.ts +0 -2
  430. package/dist/__tests__/cluster-grid-default-surface.unit.test.d.ts.map +0 -1
  431. package/dist/__tests__/construct-renderer-identity.unit.test.d.ts +0 -2
  432. package/dist/__tests__/construct-renderer-identity.unit.test.d.ts.map +0 -1
  433. package/dist/__tests__/device-scope-lifecycle.unit.test.d.ts +0 -2
  434. package/dist/__tests__/device-scope-lifecycle.unit.test.d.ts.map +0 -1
  435. package/dist/__tests__/device-scope-stale-matrix.unit.test.d.ts +0 -2
  436. package/dist/__tests__/device-scope-stale-matrix.unit.test.d.ts.map +0 -1
  437. package/dist/__tests__/direct-extract-consumer-contract.test-d.d.ts +0 -2
  438. package/dist/__tests__/direct-extract-consumer-contract.test-d.d.ts.map +0 -1
  439. package/dist/__tests__/direct-light-snapshot.unit.test.d.ts +0 -2
  440. package/dist/__tests__/direct-light-snapshot.unit.test.d.ts.map +0 -1
  441. package/dist/__tests__/factory-contract.integration.test.d.ts +0 -2
  442. package/dist/__tests__/factory-contract.integration.test.d.ts.map +0 -1
  443. package/dist/__tests__/fallback-row-stride-surface.unit.test.d.ts +0 -2
  444. package/dist/__tests__/fallback-row-stride-surface.unit.test.d.ts.map +0 -1
  445. package/dist/__tests__/frame-observation.contract.test.d.ts +0 -2
  446. package/dist/__tests__/frame-observation.contract.test.d.ts.map +0 -1
  447. package/dist/__tests__/fullscreen-feature-plan.unit.test.d.ts +0 -2
  448. package/dist/__tests__/fullscreen-feature-plan.unit.test.d.ts.map +0 -1
  449. package/dist/__tests__/glyph-text-layout-recovery.unit.test.d.ts +0 -2
  450. package/dist/__tests__/glyph-text-layout-recovery.unit.test.d.ts.map +0 -1
  451. package/dist/__tests__/gpu-driven-indirect-raster-evidence.d.ts +0 -6
  452. package/dist/__tests__/gpu-driven-indirect-raster-evidence.d.ts.map +0 -1
  453. package/dist/__tests__/gpu-driven-indirect-raster.browser.test.d.ts +0 -2
  454. package/dist/__tests__/gpu-driven-indirect-raster.browser.test.d.ts.map +0 -1
  455. package/dist/__tests__/gpu-driven-indirect-raster.dawn.test.d.ts +0 -2
  456. package/dist/__tests__/gpu-driven-indirect-raster.dawn.test.d.ts.map +0 -1
  457. package/dist/__tests__/gpu-driven-production.integration.test.d.ts +0 -2
  458. package/dist/__tests__/gpu-driven-production.integration.test.d.ts.map +0 -1
  459. package/dist/__tests__/gpu-driven-scaling.unit.test.d.ts +0 -2
  460. package/dist/__tests__/gpu-driven-scaling.unit.test.d.ts.map +0 -1
  461. package/dist/__tests__/gpu-driven-view-gpu-evidence.d.ts +0 -18
  462. package/dist/__tests__/gpu-driven-view-gpu-evidence.d.ts.map +0 -1
  463. package/dist/__tests__/gpu-driven-view-graph.integration.test.d.ts +0 -2
  464. package/dist/__tests__/gpu-driven-view-graph.integration.test.d.ts.map +0 -1
  465. package/dist/__tests__/gpu-driven-view-reference.d.ts +0 -15
  466. package/dist/__tests__/gpu-driven-view-reference.d.ts.map +0 -1
  467. package/dist/__tests__/gpu-driven-view.browser.test.d.ts +0 -2
  468. package/dist/__tests__/gpu-driven-view.browser.test.d.ts.map +0 -1
  469. package/dist/__tests__/gpu-driven-view.dawn.test.d.ts +0 -2
  470. package/dist/__tests__/gpu-driven-view.dawn.test.d.ts.map +0 -1
  471. package/dist/__tests__/gpu-driven-view.unit.test.d.ts +0 -2
  472. package/dist/__tests__/gpu-driven-view.unit.test.d.ts.map +0 -1
  473. package/dist/__tests__/gpu-resource-store-stride.unit.test.d.ts +0 -2
  474. package/dist/__tests__/gpu-resource-store-stride.unit.test.d.ts.map +0 -1
  475. package/dist/__tests__/gpu-scene-render-graph-gpu.d.ts +0 -7
  476. package/dist/__tests__/gpu-scene-render-graph-gpu.d.ts.map +0 -1
  477. package/dist/__tests__/gpu-scene-render-graph.browser.test.d.ts +0 -2
  478. package/dist/__tests__/gpu-scene-render-graph.browser.test.d.ts.map +0 -1
  479. package/dist/__tests__/gpu-scene-render-graph.dawn.test.d.ts +0 -2
  480. package/dist/__tests__/gpu-scene-render-graph.dawn.test.d.ts.map +0 -1
  481. package/dist/__tests__/gpu-scene-schema.unit.test.d.ts +0 -2
  482. package/dist/__tests__/gpu-scene-schema.unit.test.d.ts.map +0 -1
  483. package/dist/__tests__/gpu-scene.dawn.test.d.ts +0 -2
  484. package/dist/__tests__/gpu-scene.dawn.test.d.ts.map +0 -1
  485. package/dist/__tests__/gpu-scene.unit.test.d.ts +0 -2
  486. package/dist/__tests__/gpu-scene.unit.test.d.ts.map +0 -1
  487. package/dist/__tests__/ibl/face-uniforms.unit.test.d.ts +0 -2
  488. package/dist/__tests__/ibl/face-uniforms.unit.test.d.ts.map +0 -1
  489. package/dist/__tests__/infinite-grid-no-vertex-probe.unit.test.d.ts +0 -2
  490. package/dist/__tests__/infinite-grid-no-vertex-probe.unit.test.d.ts.map +0 -1
  491. package/dist/__tests__/injection-kind-owner.test-d.d.ts +0 -2
  492. package/dist/__tests__/injection-kind-owner.test-d.d.ts.map +0 -1
  493. package/dist/__tests__/ktx2-basis-gpu-consumer.dawn.test.d.ts +0 -2
  494. package/dist/__tests__/ktx2-basis-gpu-consumer.dawn.test.d.ts.map +0 -1
  495. package/dist/__tests__/light-buffer-layout.unit.test.d.ts +0 -2
  496. package/dist/__tests__/light-buffer-layout.unit.test.d.ts.map +0 -1
  497. package/dist/__tests__/material-contract-inventory.unit.test.d.ts +0 -2
  498. package/dist/__tests__/material-contract-inventory.unit.test.d.ts.map +0 -1
  499. package/dist/__tests__/material-cooked-projection.unit.test.d.ts +0 -2
  500. package/dist/__tests__/material-cooked-projection.unit.test.d.ts.map +0 -1
  501. package/dist/__tests__/material-snapshot-mutation.integration.test.d.ts +0 -2
  502. package/dist/__tests__/material-snapshot-mutation.integration.test.d.ts.map +0 -1
  503. package/dist/__tests__/material-static-dynamic-route.unit.test.d.ts +0 -2
  504. package/dist/__tests__/material-static-dynamic-route.unit.test.d.ts.map +0 -1
  505. package/dist/__tests__/material-stride-surface.unit.test.d.ts +0 -2
  506. package/dist/__tests__/material-stride-surface.unit.test.d.ts.map +0 -1
  507. package/dist/__tests__/mesh-buffer-usage-surface.unit.test.d.ts +0 -2
  508. package/dist/__tests__/mesh-buffer-usage-surface.unit.test.d.ts.map +0 -1
  509. package/dist/__tests__/mesh-material-bindings.unit.test.d.ts +0 -2
  510. package/dist/__tests__/mesh-material-bindings.unit.test.d.ts.map +0 -1
  511. package/dist/__tests__/mesh-stride-surface.unit.test.d.ts +0 -2
  512. package/dist/__tests__/mesh-stride-surface.unit.test.d.ts.map +0 -1
  513. package/dist/__tests__/morph-culling-reentry.dawn.test.d.ts +0 -2
  514. package/dist/__tests__/morph-culling-reentry.dawn.test.d.ts.map +0 -1
  515. package/dist/__tests__/morph-feature-gpu-work.integration.test.d.ts +0 -2
  516. package/dist/__tests__/morph-feature-gpu-work.integration.test.d.ts.map +0 -1
  517. package/dist/__tests__/morph-feature-plan.unit.test.d.ts +0 -2
  518. package/dist/__tests__/morph-feature-plan.unit.test.d.ts.map +0 -1
  519. package/dist/__tests__/morph-visual-evidence.integration.test.d.ts +0 -2
  520. package/dist/__tests__/morph-visual-evidence.integration.test.d.ts.map +0 -1
  521. package/dist/__tests__/nineslice-handle-surface.unit.test.d.ts +0 -2
  522. package/dist/__tests__/nineslice-handle-surface.unit.test.d.ts.map +0 -1
  523. package/dist/__tests__/post-process-error-policy-owner.unit.test.d.ts +0 -2
  524. package/dist/__tests__/post-process-error-policy-owner.unit.test.d.ts.map +0 -1
  525. package/dist/__tests__/prepared-buffer-kind-owner.test-d.d.ts +0 -2
  526. package/dist/__tests__/prepared-buffer-kind-owner.test-d.d.ts.map +0 -1
  527. package/dist/__tests__/prepared-graphics-capability.unit.test.d.ts +0 -2
  528. package/dist/__tests__/prepared-graphics-capability.unit.test.d.ts.map +0 -1
  529. package/dist/__tests__/prepared-graphics-generation.unit.test.d.ts +0 -2
  530. package/dist/__tests__/prepared-graphics-generation.unit.test.d.ts.map +0 -1
  531. package/dist/__tests__/prepared-graphics-lifecycle.unit.test.d.ts +0 -2
  532. package/dist/__tests__/prepared-graphics-lifecycle.unit.test.d.ts.map +0 -1
  533. package/dist/__tests__/prepared-graphics-pipeline-warmup.unit.test.d.ts +0 -2
  534. package/dist/__tests__/prepared-graphics-pipeline-warmup.unit.test.d.ts.map +0 -1
  535. package/dist/__tests__/prepared-graphics-resolver.unit.test.d.ts +0 -2
  536. package/dist/__tests__/prepared-graphics-resolver.unit.test.d.ts.map +0 -1
  537. package/dist/__tests__/prepared-graphics-snapshot.unit.test.d.ts +0 -2
  538. package/dist/__tests__/prepared-graphics-snapshot.unit.test.d.ts.map +0 -1
  539. package/dist/__tests__/prepared-graphics-store.unit.test.d.ts +0 -2
  540. package/dist/__tests__/prepared-graphics-store.unit.test.d.ts.map +0 -1
  541. package/dist/__tests__/prepared-graphics-validation.unit.test.d.ts +0 -2
  542. package/dist/__tests__/prepared-graphics-validation.unit.test.d.ts.map +0 -1
  543. package/dist/__tests__/profiler-default-off.test.d.ts +0 -2
  544. package/dist/__tests__/profiler-default-off.test.d.ts.map +0 -1
  545. package/dist/__tests__/profiler-phase-catalog.test.d.ts +0 -2
  546. package/dist/__tests__/profiler-phase-catalog.test.d.ts.map +0 -1
  547. package/dist/__tests__/profiler-phase-integration.test.d.ts +0 -2
  548. package/dist/__tests__/profiler-phase-integration.test.d.ts.map +0 -1
  549. package/dist/__tests__/profiler-phase-token.test.d.ts +0 -2
  550. package/dist/__tests__/profiler-phase-token.test.d.ts.map +0 -1
  551. package/dist/__tests__/public-surface.test-d.d.ts +0 -2
  552. package/dist/__tests__/public-surface.test-d.d.ts.map +0 -1
  553. package/dist/__tests__/recover-error-policy-owner.unit.test.d.ts +0 -2
  554. package/dist/__tests__/recover-error-policy-owner.unit.test.d.ts.map +0 -1
  555. package/dist/__tests__/render-error-code-owner.test-d.d.ts +0 -2
  556. package/dist/__tests__/render-error-code-owner.test-d.d.ts.map +0 -1
  557. package/dist/__tests__/render-error-detail-ssot.test-d.d.ts +0 -2
  558. package/dist/__tests__/render-error-detail-ssot.test-d.d.ts.map +0 -1
  559. package/dist/__tests__/render-error-exhaustive.test-d.d.ts +0 -2
  560. package/dist/__tests__/render-error-exhaustive.test-d.d.ts.map +0 -1
  561. package/dist/__tests__/render-feature-assembly.test-d.d.ts +0 -2
  562. package/dist/__tests__/render-feature-assembly.test-d.d.ts.map +0 -1
  563. package/dist/__tests__/render-feature-context.test-d.d.ts +0 -2
  564. package/dist/__tests__/render-feature-context.test-d.d.ts.map +0 -1
  565. package/dist/__tests__/render-feature-contract.test-d.d.ts +0 -2
  566. package/dist/__tests__/render-feature-contract.test-d.d.ts.map +0 -1
  567. package/dist/__tests__/render-feature-diagnostics.unit.test.d.ts +0 -2
  568. package/dist/__tests__/render-feature-diagnostics.unit.test.d.ts.map +0 -1
  569. package/dist/__tests__/render-feature-docs.unit.test.d.ts +0 -2
  570. package/dist/__tests__/render-feature-docs.unit.test.d.ts.map +0 -1
  571. package/dist/__tests__/render-feature-errors.unit.test.d.ts +0 -2
  572. package/dist/__tests__/render-feature-errors.unit.test.d.ts.map +0 -1
  573. package/dist/__tests__/render-feature-gpu-work.integration.test.d.ts +0 -2
  574. package/dist/__tests__/render-feature-gpu-work.integration.test.d.ts.map +0 -1
  575. package/dist/__tests__/render-feature-plan.test-d.d.ts +0 -2
  576. package/dist/__tests__/render-feature-plan.test-d.d.ts.map +0 -1
  577. package/dist/__tests__/render-feature-plan.unit.test.d.ts +0 -2
  578. package/dist/__tests__/render-feature-plan.unit.test.d.ts.map +0 -1
  579. package/dist/__tests__/render-feature-prepared-diagnostics.unit.test.d.ts +0 -2
  580. package/dist/__tests__/render-feature-prepared-diagnostics.unit.test.d.ts.map +0 -1
  581. package/dist/__tests__/render-feature-prepared-errors.test-d.d.ts +0 -2
  582. package/dist/__tests__/render-feature-prepared-errors.test-d.d.ts.map +0 -1
  583. package/dist/__tests__/render-feature-prepared-graphics-docs.unit.test.d.ts +0 -2
  584. package/dist/__tests__/render-feature-prepared-graphics-docs.unit.test.d.ts.map +0 -1
  585. package/dist/__tests__/render-feature-prepared-graphics-isolation.unit.test.d.ts +0 -2
  586. package/dist/__tests__/render-feature-prepared-graphics-isolation.unit.test.d.ts.map +0 -1
  587. package/dist/__tests__/render-feature-prepared-graphics-negative.test-d.d.ts +0 -2
  588. package/dist/__tests__/render-feature-prepared-graphics-negative.test-d.d.ts.map +0 -1
  589. package/dist/__tests__/render-feature-prepared-graphics.test-d.d.ts +0 -2
  590. package/dist/__tests__/render-feature-prepared-graphics.test-d.d.ts.map +0 -1
  591. package/dist/__tests__/render-feature-prepared-graphics.unit.test.d.ts +0 -2
  592. package/dist/__tests__/render-feature-prepared-graphics.unit.test.d.ts.map +0 -1
  593. package/dist/__tests__/render-feature-public-surface.test-d.d.ts +0 -2
  594. package/dist/__tests__/render-feature-public-surface.test-d.d.ts.map +0 -1
  595. package/dist/__tests__/render-feature-retry.unit.test.d.ts +0 -2
  596. package/dist/__tests__/render-feature-retry.unit.test.d.ts.map +0 -1
  597. package/dist/__tests__/render-feature-scheduling.unit.test.d.ts +0 -2
  598. package/dist/__tests__/render-feature-scheduling.unit.test.d.ts.map +0 -1
  599. package/dist/__tests__/render-feature-stage-failed-policy-owner.unit.test.d.ts +0 -2
  600. package/dist/__tests__/render-feature-stage-failed-policy-owner.unit.test.d.ts.map +0 -1
  601. package/dist/__tests__/render-feature-stage-fault-recovery.unit.test.d.ts +0 -2
  602. package/dist/__tests__/render-feature-stage-fault-recovery.unit.test.d.ts.map +0 -1
  603. package/dist/__tests__/render-feature-visibility-context.test-d.d.ts +0 -2
  604. package/dist/__tests__/render-feature-visibility-context.test-d.d.ts.map +0 -1
  605. package/dist/__tests__/render-feature-visibility-context.unit.test.d.ts +0 -2
  606. package/dist/__tests__/render-feature-visibility-context.unit.test.d.ts.map +0 -1
  607. package/dist/__tests__/render-feature-zero-work.unit.test.d.ts +0 -2
  608. package/dist/__tests__/render-feature-zero-work.unit.test.d.ts.map +0 -1
  609. package/dist/__tests__/render-graph-compute-raster-gpu.d.ts +0 -7
  610. package/dist/__tests__/render-graph-compute-raster-gpu.d.ts.map +0 -1
  611. package/dist/__tests__/render-graph-compute-raster.browser.test.d.ts +0 -2
  612. package/dist/__tests__/render-graph-compute-raster.browser.test.d.ts.map +0 -1
  613. package/dist/__tests__/render-graph-compute-raster.dawn.test.d.ts +0 -2
  614. package/dist/__tests__/render-graph-compute-raster.dawn.test.d.ts.map +0 -1
  615. package/dist/__tests__/render-graph-hzb-gpu.d.ts +0 -7
  616. package/dist/__tests__/render-graph-hzb-gpu.d.ts.map +0 -1
  617. package/dist/__tests__/render-graph-hzb.browser.test.d.ts +0 -2
  618. package/dist/__tests__/render-graph-hzb.browser.test.d.ts.map +0 -1
  619. package/dist/__tests__/render-graph-hzb.dawn.test.d.ts +0 -2
  620. package/dist/__tests__/render-graph-hzb.dawn.test.d.ts.map +0 -1
  621. package/dist/__tests__/render-graph-primitives.unit.test.d.ts +0 -2
  622. package/dist/__tests__/render-graph-primitives.unit.test.d.ts.map +0 -1
  623. package/dist/__tests__/render-graph-storage-indirect-gpu.d.ts +0 -12
  624. package/dist/__tests__/render-graph-storage-indirect-gpu.d.ts.map +0 -1
  625. package/dist/__tests__/render-graph-storage-indirect.browser.test.d.ts +0 -2
  626. package/dist/__tests__/render-graph-storage-indirect.browser.test.d.ts.map +0 -1
  627. package/dist/__tests__/render-graph-storage-indirect.dawn.test.d.ts +0 -2
  628. package/dist/__tests__/render-graph-storage-indirect.dawn.test.d.ts.map +0 -1
  629. package/dist/__tests__/render-scene-projection.unit.test.d.ts +0 -2
  630. package/dist/__tests__/render-scene-projection.unit.test.d.ts.map +0 -1
  631. package/dist/__tests__/renderer-factory-material-contract.unit.test.d.ts +0 -2
  632. package/dist/__tests__/renderer-factory-material-contract.unit.test.d.ts.map +0 -1
  633. package/dist/__tests__/renderer-lifecycle.integration.test.d.ts +0 -2
  634. package/dist/__tests__/renderer-lifecycle.integration.test.d.ts.map +0 -1
  635. package/dist/__tests__/rhi-backend-package-boundary.unit.test.d.ts +0 -2
  636. package/dist/__tests__/rhi-backend-package-boundary.unit.test.d.ts.map +0 -1
  637. package/dist/__tests__/scriptable-pack-consumer.test-d.d.ts +0 -2
  638. package/dist/__tests__/scriptable-pack-consumer.test-d.d.ts.map +0 -1
  639. package/dist/__tests__/shader-stage-surface.unit.test.d.ts +0 -2
  640. package/dist/__tests__/shader-stage-surface.unit.test.d.ts.map +0 -1
  641. package/dist/__tests__/ssao-config.unit.test.d.ts +0 -2
  642. package/dist/__tests__/ssao-config.unit.test.d.ts.map +0 -1
  643. package/dist/__tests__/ssao-kernel-surface.unit.test.d.ts +0 -2
  644. package/dist/__tests__/ssao-kernel-surface.unit.test.d.ts.map +0 -1
  645. package/dist/__tests__/standard-clustered-pipeline.unit.test.d.ts +0 -2
  646. package/dist/__tests__/standard-clustered-pipeline.unit.test.d.ts.map +0 -1
  647. package/dist/__tests__/standard-descriptors.test-d.d.ts +0 -2
  648. package/dist/__tests__/standard-descriptors.test-d.d.ts.map +0 -1
  649. package/dist/__tests__/standard-pipeline.dawn.test.d.ts +0 -2
  650. package/dist/__tests__/standard-pipeline.dawn.test.d.ts.map +0 -1
  651. package/dist/__tests__/standard-pipeline.integration.test.d.ts +0 -2
  652. package/dist/__tests__/standard-pipeline.integration.test.d.ts.map +0 -1
  653. package/dist/__tests__/standard-profile-oracle.unit.test.d.ts +0 -2
  654. package/dist/__tests__/standard-profile-oracle.unit.test.d.ts.map +0 -1
  655. package/dist/__tests__/surface-configuration.unit.test.d.ts +0 -2
  656. package/dist/__tests__/surface-configuration.unit.test.d.ts.map +0 -1
  657. package/dist/__tests__/texture-usage-surface.unit.test.d.ts +0 -2
  658. package/dist/__tests__/texture-usage-surface.unit.test.d.ts.map +0 -1
  659. package/dist/__tests__/typed-pipeline-topology.unit.test.d.ts +0 -2
  660. package/dist/__tests__/typed-pipeline-topology.unit.test.d.ts.map +0 -1
  661. package/dist/__tests__/urp-pipeline-targets.unit.test.d.ts +0 -2
  662. package/dist/__tests__/urp-pipeline-targets.unit.test.d.ts.map +0 -1
  663. package/dist/__tests__/urp-pipeline.unit.test.d.ts +0 -2
  664. package/dist/__tests__/urp-pipeline.unit.test.d.ts.map +0 -1
  665. package/dist/__tests__/vertex-color-pipeline.unit.test.d.ts +0 -2
  666. package/dist/__tests__/vertex-color-pipeline.unit.test.d.ts.map +0 -1
  667. package/dist/__tests__/vertex-layout-consumer.unit.test.d.ts +0 -2
  668. package/dist/__tests__/vertex-layout-consumer.unit.test.d.ts.map +0 -1
  669. package/dist/__tests__/visibility-diagnostics.integration.test.d.ts +0 -2
  670. package/dist/__tests__/visibility-diagnostics.integration.test.d.ts.map +0 -1
  671. package/dist/__tests__/visibility-extract.integration.test.d.ts +0 -2
  672. package/dist/__tests__/visibility-extract.integration.test.d.ts.map +0 -1
  673. package/dist/__tests__/visibility-extract.perf.test.d.ts +0 -2
  674. package/dist/__tests__/visibility-extract.perf.test.d.ts.map +0 -1
  675. package/dist/__tests__/visibility-feature-dedup.integration.test.d.ts +0 -2
  676. package/dist/__tests__/visibility-feature-dedup.integration.test.d.ts.map +0 -1
  677. package/dist/__tests__/visibility-hidden-report.unit.test.d.ts +0 -2
  678. package/dist/__tests__/visibility-hidden-report.unit.test.d.ts.map +0 -1
  679. package/dist/__tests__/visibility-instances.integration.test.d.ts +0 -2
  680. package/dist/__tests__/visibility-instances.integration.test.d.ts.map +0 -1
  681. package/dist/__tests__/visibility-multi-world.integration.test.d.ts +0 -2
  682. package/dist/__tests__/visibility-multi-world.integration.test.d.ts.map +0 -1
  683. package/dist/__tests__/visibility-producer-matrix.integration.test.d.ts +0 -2
  684. package/dist/__tests__/visibility-producer-matrix.integration.test.d.ts.map +0 -1
  685. package/dist/__tests__/visibility-producer-matrix.unit.test.d.ts +0 -2
  686. package/dist/__tests__/visibility-producer-matrix.unit.test.d.ts.map +0 -1
  687. package/dist/__tests__/visibility-public-surface.test-d.d.ts +0 -2
  688. package/dist/__tests__/visibility-public-surface.test-d.d.ts.map +0 -1
  689. package/dist/__tests__/visibility-resolver.unit.test.d.ts +0 -2
  690. package/dist/__tests__/visibility-resolver.unit.test.d.ts.map +0 -1
  691. package/dist/__tests__/visibility-resource-short-circuit.unit.test.d.ts +0 -2
  692. package/dist/__tests__/visibility-resource-short-circuit.unit.test.d.ts.map +0 -1
  693. package/dist/__tests__/visibility-snapshot-contract.unit.test.d.ts +0 -2
  694. package/dist/__tests__/visibility-snapshot-contract.unit.test.d.ts.map +0 -1
  695. package/dist/__tests__/vocabulary.unit.test.d.ts +0 -2
  696. package/dist/__tests__/vocabulary.unit.test.d.ts.map +0 -1
  697. package/dist/chunk-CQXZC5XI.mjs.map +0 -1
  698. package/dist/chunk-QC4VW3XJ.mjs.map +0 -1
  699. package/dist/chunk-SCRSAK5B.mjs.map +0 -1
  700. package/dist/components/__tests__/schema-contract.unit.test.d.ts +0 -2
  701. package/dist/components/__tests__/schema-contract.unit.test.d.ts.map +0 -1
  702. package/dist/components/__tests__/schema-parity.unit.test.d.ts +0 -2
  703. package/dist/components/__tests__/schema-parity.unit.test.d.ts.map +0 -1
  704. package/dist/components/__tests__/visibility-schema.unit.test.d.ts +0 -2
  705. package/dist/components/__tests__/visibility-schema.unit.test.d.ts.map +0 -1
  706. package/dist/record/__tests__/material-bg-cache.unit.test.d.ts +0 -2
  707. package/dist/record/__tests__/material-bg-cache.unit.test.d.ts.map +0 -1
  708. package/dist/record/__tests__/material-slot-plan.unit.test.d.ts +0 -2
  709. package/dist/record/__tests__/material-slot-plan.unit.test.d.ts.map +0 -1
  710. package/dist/record/__tests__/typed-frame-graph-plan.unit.test.d.ts +0 -2
  711. package/dist/record/__tests__/typed-frame-graph-plan.unit.test.d.ts.map +0 -1
  712. package/dist/record/__tests__/video-texture-view.unit.test.d.ts +0 -2
  713. package/dist/record/__tests__/video-texture-view.unit.test.d.ts.map +0 -1
@@ -3,6 +3,7 @@ import type { RhiDevice } from '@forgeax/engine-rhi';
3
3
  import { rhi } from '@forgeax/engine-rhi-null';
4
4
  import { ok } from '@forgeax/engine-types';
5
5
  import { beforeAll, describe, expect, it } from 'vitest';
6
+ import { createRenderSurfaceError, type RenderSurfaceExpectedError } from '../errors/render';
6
7
  import { standardPipeline } from '../pipeline/standard-pipeline';
7
8
  import {
8
9
  DEFAULT_STANDARD_PROFILE,
@@ -10,6 +11,23 @@ import {
10
11
  type StandardProfile,
11
12
  } from '../pipeline/standard-profile';
12
13
  import type { RenderPipelineFrame, RenderPipelineTopology } from '../render-pipeline';
14
+ import type { SurfaceProfile } from '../render-system';
15
+
16
+ const rawOnlyProfile: SurfaceProfile = {
17
+ kind: 'raw-only',
18
+ storageFormat: 'rgba8unorm',
19
+ viewFormat: 'rgba8unorm',
20
+ viewFormats: [],
21
+ hasDisplayEndpoint: false,
22
+ };
23
+
24
+ const dualViewProfile: SurfaceProfile = {
25
+ kind: 'dual-view',
26
+ storageFormat: 'bgra8unorm',
27
+ viewFormat: 'bgra8unorm-srgb',
28
+ viewFormats: ['bgra8unorm-srgb'],
29
+ hasDisplayEndpoint: true,
30
+ };
13
31
 
14
32
  function topology(
15
33
  profile: StandardProfile,
@@ -57,9 +75,59 @@ beforeAll(async () => {
57
75
 
58
76
  async function build(profile: StandardProfile, overrides?: Partial<RenderPipelineTopology>) {
59
77
  const graph = new RenderGraphBuilder<RenderPipelineFrame>();
78
+ const resolvedTopology = topology(profile, overrides);
60
79
  const built = standardPipeline.build(
61
80
  {
62
81
  graph,
82
+ encodeTransmissionMip: ({ pass }) => pass.draw(3, 1, 0, 0),
83
+ projectGpuDriven: () => ok(undefined),
84
+ contributeFeatures: () => ok(undefined),
85
+ },
86
+ resolvedTopology,
87
+ );
88
+ if (!built.ok) return built;
89
+ return graph.compile({
90
+ device,
91
+ surfaceSize: {
92
+ width: resolvedTopology.surface.width,
93
+ height: resolvedTopology.surface.height,
94
+ },
95
+ });
96
+ }
97
+
98
+ function importedTaaHistory(graph: RenderGraphBuilder<RenderPipelineFrame>) {
99
+ const target = (label: string) => {
100
+ const texture = graph.importTexture(
101
+ label,
102
+ { format: 'rgba16float', size: 'surface', usage: 0x17 },
103
+ (frame) => frame.currentTexture,
104
+ );
105
+ if (!texture.ok) throw texture.error;
106
+ const view = graph.importView(texture.value, { label: `${label}.view` }, (frame) => frame.view);
107
+ if (!view.ok) throw view.error;
108
+ return {
109
+ texture: texture.value,
110
+ view: view.value,
111
+ format: 'rgba16float' as const,
112
+ sampleCount: 1 as const,
113
+ };
114
+ };
115
+ return {
116
+ currentColor: target('taa-history-current-color'),
117
+ previousColor: target('taa-history-previous-color'),
118
+ currentTemporal: target('taa-history-current-temporal'),
119
+ previousTemporal: target('taa-history-previous-temporal'),
120
+ };
121
+ }
122
+
123
+ async function buildTaa(profile: StandardProfile, overrides?: Partial<RenderPipelineTopology>) {
124
+ const graph = new RenderGraphBuilder<RenderPipelineFrame>();
125
+ const history = importedTaaHistory(graph);
126
+ const built = standardPipeline.build(
127
+ {
128
+ graph,
129
+ capabilities: { rgba16floatRenderable: true },
130
+ taaHistory: history,
63
131
  projectGpuDriven: () => ok(undefined),
64
132
  contributeFeatures: () => ok(undefined),
65
133
  },
@@ -70,6 +138,27 @@ async function build(profile: StandardProfile, overrides?: Partial<RenderPipelin
70
138
  }
71
139
 
72
140
  describe('forgeax::standard graph', () => {
141
+ it('keeps the last-known-good graph for each explicit surface failure', () => {
142
+ let activeGraph = 'last-known-good';
143
+ const failures = ['allocation', 'attachment', 'sampled-read', 'raw-endpoint'] as const;
144
+ for (const kind of failures) {
145
+ const candidateError: RenderSurfaceExpectedError = createRenderSurfaceError(kind, {
146
+ lane: 'direct',
147
+ stage: 'output-transform',
148
+ target: 'standard-output-color',
149
+ format: 'rgba16float',
150
+ domain: 'display-encoded',
151
+ endpoint: 'surface.storage',
152
+ capability: `float-${kind}`,
153
+ });
154
+ expect(candidateError.code).toBe(`surface-${kind}-failed`);
155
+ expect(candidateError.detail.target).toBe('standard-output-color');
156
+ expect(activeGraph).toBe('last-known-good');
157
+ }
158
+ activeGraph = 'candidate';
159
+ expect(activeGraph).toBe('candidate');
160
+ });
161
+
73
162
  it.each([
74
163
  ['direct-1', { ...DEFAULT_STANDARD_PROFILE, lightCount: 1, lighting: 'direct' }],
75
164
  ['clustered-32', { ...DEFAULT_STANDARD_PROFILE, lightCount: 32, lighting: 'clustered' }],
@@ -81,6 +170,22 @@ describe('forgeax::standard graph', () => {
81
170
  expect(result.value.inspect().passes.length).toBeGreaterThan(0);
82
171
  });
83
172
 
173
+ it('keeps Bloom a no-op when TAA has no active tone mapper', async () => {
174
+ const result = await buildTaa(
175
+ { ...DEFAULT_STANDARD_PROFILE, lighting: 'direct' },
176
+ { camera: { tonemap: 'none', antialias: 'taa', bloom: 'on' } },
177
+ );
178
+ expect(result.ok).toBe(true);
179
+ if (!result.ok) return;
180
+ const names = result.value.inspect().passes.map((pass) => pass.name);
181
+ expect(names).not.toContain('bloom-bright');
182
+ expect(names).not.toContain('bloom-blur-h');
183
+ expect(names).not.toContain('bloom-blur-v');
184
+ expect(names).not.toContain('bloom-composite');
185
+ expect(names).toContain('taa-resolve');
186
+ expect(names).toContain('output-transform');
187
+ });
188
+
84
189
  it('keeps shadow, lighting, post, and debug work in one ordered graph', async () => {
85
190
  const result = await build({ ...DEFAULT_STANDARD_PROFILE, lighting: 'clustered' });
86
191
  expect(result.ok).toBe(true);
@@ -91,7 +196,7 @@ describe('forgeax::standard graph', () => {
91
196
  'g-buffer',
92
197
  'lighting',
93
198
  'forward',
94
- 'tonemap',
199
+ 'output-transform',
95
200
  'debug-overlay',
96
201
  ];
97
202
  for (let index = 1; index < stages.length; index += 1) {
@@ -101,6 +206,29 @@ describe('forgeax::standard graph', () => {
101
206
  }
102
207
  });
103
208
 
209
+ it('routes a no-camera clear-only frame directly to the surface', async () => {
210
+ const result = await build(
211
+ { ...DEFAULT_STANDARD_PROFILE, lighting: 'clustered' },
212
+ {
213
+ clearOnly: true,
214
+ camera: { tonemap: 'none', antialias: 'none', bloom: 'off' },
215
+ },
216
+ );
217
+ expect(result.ok).toBe(true);
218
+ if (!result.ok) return;
219
+ const info = result.value.inspect();
220
+ const names = info.passes.map((pass) => pass.name);
221
+ expect(names).toContain('main');
222
+ expect(names).not.toContain('output-transform');
223
+ expect(names).not.toContain('g-buffer');
224
+ expect(names).not.toContain('lighting');
225
+ expect(names).not.toContain('cluster-membership-producer');
226
+ expect(names).not.toContain('fxaa');
227
+ expect(names).not.toContain('bloom-composite');
228
+ expect(names).toContain('debug-overlay');
229
+ expect(info.resources.map((resource) => resource.label)).not.toContain('scene-color');
230
+ });
231
+
104
232
  it('uses the CPU/WebGL2 fallback without clustered resources', async () => {
105
233
  const result = await build(
106
234
  { ...DEFAULT_STANDARD_PROFILE, lighting: 'clustered' },
@@ -121,4 +249,418 @@ describe('forgeax::standard graph', () => {
121
249
  'hdrp-light-index-list',
122
250
  );
123
251
  });
252
+
253
+ it.each([
254
+ ['direct', 'aces-filmic', 'fxaa'],
255
+ ['direct', 'none', 'fxaa'],
256
+ ['clustered', 'aces-filmic', 'fxaa'],
257
+ ['clustered', 'none', 'fxaa'],
258
+ ['direct', 'aces-filmic', 'none'],
259
+ ['clustered', 'aces-filmic', 'none'],
260
+ ] as const)('uses one explicit post-chain contract for %s/%s/%s', async (lighting, tonemap, antialias) => {
261
+ const result = await build(
262
+ { ...DEFAULT_STANDARD_PROFILE, lighting },
263
+ { camera: { tonemap, antialias, bloom: 'on' } },
264
+ );
265
+ expect(result.ok).toBe(true);
266
+ if (!result.ok) return;
267
+ const info = result.value.inspect();
268
+ const names = info.passes.map((pass) => pass.name);
269
+ expect(names).toContain('output-transform');
270
+ expect(names.indexOf('bloom-composite')).toBeLessThan(names.indexOf('output-transform'));
271
+ expect(names.indexOf('debug-overlay')).toBeGreaterThan(names.indexOf('output-transform'));
272
+ if (antialias === 'fxaa') {
273
+ expect(names.indexOf('fxaa')).toBeGreaterThan(names.indexOf('output-transform'));
274
+ expect(info.resources.map((resource) => resource.label)).toContain('standard-output-color');
275
+ } else {
276
+ expect(names).not.toContain('fxaa');
277
+ expect(info.resources.map((resource) => resource.label)).not.toContain(
278
+ 'standard-output-color',
279
+ );
280
+ }
281
+ expect(info.resources.map((resource) => resource.label)).not.toContain('ldr-color');
282
+ });
283
+
284
+ const routeMatrix = (['direct', 'clustered'] as const).flatMap((lighting) =>
285
+ (['dual-view', 'raw-only'] as const).flatMap((surfaceKind) =>
286
+ (['none', 'aces-filmic'] as const).flatMap((tonemap) =>
287
+ (['none', 'fxaa'] as const).map(
288
+ (antialias) => [lighting, surfaceKind, tonemap, antialias] as const,
289
+ ),
290
+ ),
291
+ ),
292
+ );
293
+
294
+ it.each(
295
+ routeMatrix,
296
+ )('keeps the output route explicit for %s/%s/%s/%s', async (lighting, surfaceKind, tonemap, antialias) => {
297
+ const rawOnly = surfaceKind === 'raw-only';
298
+ const result = await build(
299
+ { ...DEFAULT_STANDARD_PROFILE, lighting },
300
+ {
301
+ camera: { tonemap, antialias, bloom: 'off' },
302
+ surface: {
303
+ width: 1,
304
+ height: 1,
305
+ storageFormat: rawOnly ? 'rgba8unorm' : 'bgra8unorm',
306
+ viewFormat: rawOnly ? 'rgba8unorm' : 'bgra8unorm-srgb',
307
+ profile: rawOnly ? rawOnlyProfile : dualViewProfile,
308
+ },
309
+ },
310
+ );
311
+ expect(result.ok).toBe(true);
312
+ if (!result.ok) return;
313
+ const info = result.value.inspect();
314
+ const names = info.passes.map((pass) => pass.name);
315
+ const sceneLabel = lighting === 'direct' ? 'scene-color' : 'hdrp-scene-color';
316
+ const sceneResource = info.resources.find((resource) => resource.label === sceneLabel);
317
+ expect(sceneResource).toBeDefined();
318
+ expect(sceneResource?.derivedUsage).toBe(0x15);
319
+ const outputTransforms = names.filter((name) => name === 'output-transform');
320
+ expect(outputTransforms).toHaveLength(1);
321
+ expect(names.filter((name) => name === 'fxaa')).toHaveLength(antialias === 'fxaa' ? 1 : 0);
322
+ expect(names.filter((name) => name === 'debug-overlay')).toHaveLength(1);
323
+ if (rawOnly) {
324
+ expect(info.resources.map((resource) => resource.label)).not.toContain('surface.display');
325
+ expect(names.indexOf('debug-overlay')).toBeLessThan(names.indexOf('output-transform'));
326
+ } else {
327
+ expect(names.indexOf('debug-overlay')).toBeGreaterThan(names.indexOf('output-transform'));
328
+ }
329
+ expect(
330
+ info.resources.filter((resource) => resource.label === 'standard-output-color'),
331
+ ).toHaveLength(antialias === 'fxaa' ? 1 : 0);
332
+ if (antialias === 'fxaa') {
333
+ expect(
334
+ info.resources.find((resource) => resource.label === 'standard-output-color'),
335
+ ).toMatchObject({
336
+ derivedUsage: 0x10 | 0x04 | 0x01,
337
+ });
338
+ }
339
+ });
340
+
341
+ it('uses one linear target and one output transform for direct storage-buffer LDR output', async () => {
342
+ const result = await build(
343
+ { ...DEFAULT_STANDARD_PROFILE, lighting: 'direct' },
344
+ { camera: { tonemap: 'none', antialias: 'none', bloom: 'off' } },
345
+ );
346
+ expect(result.ok).toBe(true);
347
+ if (!result.ok) return;
348
+ const info = result.value.inspect();
349
+ const names = info.passes.map((pass) => pass.name);
350
+ expect(names).toContain('output-transform');
351
+ expect(names).not.toContain('fxaa');
352
+ expect(info.resources.find((resource) => resource.label === 'scene-color')).toMatchObject({
353
+ descriptor: { format: 'rgba16float', domain: 'linear-ldr' },
354
+ });
355
+ expect(info.resources.map((resource) => resource.label)).not.toContain('standard-output-color');
356
+ expect(info.resources.map((resource) => resource.label)).not.toContain('ldr-color');
357
+ });
358
+
359
+ it('keeps the direct display fast path when storage buffers are unavailable', async () => {
360
+ const result = await build(
361
+ { ...DEFAULT_STANDARD_PROFILE, lighting: 'direct' },
362
+ {
363
+ camera: { tonemap: 'none', antialias: 'none', bloom: 'off' },
364
+ lane: {
365
+ compute: false,
366
+ storageBuffer: false,
367
+ multisample: false,
368
+ maxColorAttachments: 4,
369
+ },
370
+ },
371
+ );
372
+ expect(result.ok).toBe(true);
373
+ if (!result.ok) return;
374
+ const info = result.value.inspect();
375
+ const names = info.passes.map((pass) => pass.name);
376
+ expect(names).not.toContain('output-transform');
377
+ expect(info.resources.map((resource) => resource.label)).not.toContain('scene-color');
378
+ });
379
+
380
+ it('uses one linear target and one output transform for raw-only no-FXAA', async () => {
381
+ const result = await build(
382
+ { ...DEFAULT_STANDARD_PROFILE, lighting: 'direct' },
383
+ {
384
+ camera: { tonemap: 'none', antialias: 'none', bloom: 'off' },
385
+ surface: {
386
+ width: 1,
387
+ height: 1,
388
+ storageFormat: 'rgba8unorm',
389
+ viewFormat: 'rgba8unorm',
390
+ profile: rawOnlyProfile,
391
+ },
392
+ },
393
+ );
394
+ expect(result.ok).toBe(true);
395
+ if (!result.ok) return;
396
+ const info = result.value.inspect();
397
+ expect(info.passes.filter((pass) => pass.name === 'output-transform')).toHaveLength(1);
398
+ expect(info.resources.filter((resource) => resource.label === 'scene-color')).toHaveLength(1);
399
+ expect(info.resources.map((resource) => resource.label)).not.toContain('standard-output-color');
400
+ expect(info.resources.map((resource) => resource.label)).not.toContain('surface.display');
401
+ expect(info.passes.filter((pass) => pass.name === 'debug-overlay')).toHaveLength(1);
402
+ expect(info.passes.map((pass) => pass.name).indexOf('debug-overlay')).toBeLessThan(
403
+ info.passes.map((pass) => pass.name).indexOf('output-transform'),
404
+ );
405
+ });
406
+
407
+ it('keeps raw-only FXAA in one display-encoded float intermediate', async () => {
408
+ const result = await build(
409
+ { ...DEFAULT_STANDARD_PROFILE, lighting: 'direct' },
410
+ {
411
+ camera: { tonemap: 'none', antialias: 'fxaa', bloom: 'off' },
412
+ surface: {
413
+ width: 1,
414
+ height: 1,
415
+ storageFormat: 'rgba8unorm',
416
+ viewFormat: 'rgba8unorm',
417
+ profile: rawOnlyProfile,
418
+ },
419
+ },
420
+ );
421
+ expect(result.ok).toBe(true);
422
+ if (!result.ok) return;
423
+ const info = result.value.inspect();
424
+ expect(info.passes.filter((pass) => pass.name === 'output-transform')).toHaveLength(1);
425
+ expect(info.passes.map((pass) => pass.name).indexOf('debug-overlay')).toBeLessThan(
426
+ info.passes.map((pass) => pass.name).indexOf('output-transform'),
427
+ );
428
+ expect(
429
+ info.resources.filter((resource) => resource.label === 'standard-output-color'),
430
+ ).toHaveLength(1);
431
+ expect(info.resources.map((resource) => resource.label)).not.toContain('surface.display');
432
+ expect(info.passes.filter((pass) => pass.name === 'debug-overlay')).toHaveLength(1);
433
+ });
434
+
435
+ it.each([
436
+ 'none',
437
+ 'fxaa',
438
+ ] as const)('routes raw-only registered post effects through an encoded float input target (%s)', async (antialias) => {
439
+ const result = await build(
440
+ { ...DEFAULT_STANDARD_PROFILE, lighting: 'direct' },
441
+ {
442
+ camera: { tonemap: 'none', antialias, bloom: 'off' },
443
+ config: { postEffects: ['test-effect'] },
444
+ surface: {
445
+ width: 1,
446
+ height: 1,
447
+ storageFormat: 'rgba8unorm',
448
+ viewFormat: 'rgba8unorm',
449
+ profile: rawOnlyProfile,
450
+ },
451
+ },
452
+ );
453
+ expect(result.ok).toBe(true);
454
+ if (!result.ok) return;
455
+ const info = result.value.inspect();
456
+ const names = info.passes.map((pass) => pass.name);
457
+ const resources = info.resources;
458
+ const input = resources.find((resource) => resource.label === 'standard-post-effects-input');
459
+ expect(input).toMatchObject({
460
+ derivedUsage: 0x10 | 0x01,
461
+ });
462
+ expect(names.indexOf('debug-overlay')).toBeLessThan(names.indexOf('output-transform'));
463
+ const fxaaIndex = names.indexOf('fxaa');
464
+ expect(names.indexOf('output-transform')).toBeLessThan(
465
+ fxaaIndex === -1 ? names.indexOf('post-effect-copy-0') : fxaaIndex,
466
+ );
467
+ if (fxaaIndex !== -1) expect(fxaaIndex).toBeLessThan(names.indexOf('post-effect-copy-0'));
468
+ expect(names.indexOf('post-effect-copy-0')).toBeLessThan(names.indexOf('post-effect-0'));
469
+ expect(info.passes.find((pass) => pass.name === 'post-effect-copy-0')?.accesses).toContainEqual(
470
+ { resource: 'standard-post-effects-input', usage: 'copy-src' },
471
+ );
472
+ expect(info.passes.find((pass) => pass.name === 'post-effect-0')?.accesses).toContainEqual({
473
+ resource: 'surface',
474
+ usage: 'color-attachment',
475
+ });
476
+ expect(resources.map((resource) => resource.label)).not.toContain('surface.display');
477
+ expect(resources.map((resource) => resource.label)).not.toContain('ldr-color');
478
+ expect(resources.map((resource) => resource.label)).toContain('standard-post-effects-input');
479
+ expect(resources.map((resource) => resource.label)).toContain('post-effect-scratch-0');
480
+ });
481
+
482
+ it('presents a resolved no-tone MSAA scene through the shared output boundary', async () => {
483
+ const result = await build(
484
+ { ...DEFAULT_STANDARD_PROFILE, lighting: 'direct' },
485
+ {
486
+ camera: { tonemap: 'none', antialias: 'msaa', bloom: 'off' },
487
+ lane: {
488
+ compute: true,
489
+ storageBuffer: true,
490
+ multisample: true,
491
+ maxColorAttachments: 8,
492
+ },
493
+ },
494
+ );
495
+ expect(result.ok).toBe(true);
496
+ if (!result.ok) return;
497
+ const info = result.value.inspect();
498
+ const names = info.passes.map((pass) => pass.name);
499
+ expect(names).toContain('output-transform');
500
+ expect(names.indexOf('output-transform')).toBeGreaterThan(names.indexOf('main'));
501
+ expect(names.indexOf('debug-overlay')).toBeGreaterThan(names.indexOf('output-transform'));
502
+ expect(info.resources.map((resource) => resource.label)).toContain('scene-color');
503
+ expect(info.resources.map((resource) => resource.label)).toContain('scene-color-msaa');
504
+ expect(info.resources.map((resource) => resource.label)).not.toContain('standard-output-color');
505
+ });
506
+
507
+ it('uses the live rgba16float capability for temporal admission', () => {
508
+ const graph = new RenderGraphBuilder<RenderPipelineFrame>();
509
+ const built = standardPipeline.build(
510
+ {
511
+ graph,
512
+ capabilities: { rgba16floatRenderable: false },
513
+ projectGpuDriven: () => ok(undefined),
514
+ contributeFeatures: () => ok(undefined),
515
+ },
516
+ topology(DEFAULT_STANDARD_PROFILE, {
517
+ camera: { tonemap: 'aces-filmic', antialias: 'taa', bloom: 'off' },
518
+ }),
519
+ );
520
+ expect(built.ok).toBe(false);
521
+ if (built.ok) return;
522
+ expect(built.error).toMatchObject({
523
+ code: 'scene-data-unavailable',
524
+ detail: { reason: 'capability-missing' },
525
+ });
526
+ });
527
+
528
+ it('fails closed when the temporal capability probe is absent', () => {
529
+ const graph = new RenderGraphBuilder<RenderPipelineFrame>();
530
+ const built = standardPipeline.build(
531
+ {
532
+ graph,
533
+ projectGpuDriven: () => ok(undefined),
534
+ contributeFeatures: () => ok(undefined),
535
+ },
536
+ topology(DEFAULT_STANDARD_PROFILE, {
537
+ surface: {
538
+ width: 1,
539
+ height: 1,
540
+ storageFormat: 'rgba16float',
541
+ viewFormat: 'rgba16float',
542
+ },
543
+ camera: { tonemap: 'aces-filmic', antialias: 'taa', bloom: 'off' },
544
+ }),
545
+ );
546
+ expect(built.ok).toBe(false);
547
+ if (built.ok) return;
548
+ expect(built.error).toMatchObject({
549
+ code: 'scene-data-unavailable',
550
+ detail: { reason: 'capability-missing' },
551
+ });
552
+ });
553
+
554
+ it('keeps direct and clustered transmission topology in one graph', async () => {
555
+ for (const lighting of ['direct', 'clustered'] as const) {
556
+ const result = await build({ ...DEFAULT_STANDARD_PROFILE, lighting }, {
557
+ surface: {
558
+ width: 8,
559
+ height: 4,
560
+ storageFormat: 'bgra8unorm',
561
+ viewFormat: 'bgra8unorm-srgb',
562
+ },
563
+ transmissionDemand: { activeCount: 1, needsRoughMips: true },
564
+ } as Partial<RenderPipelineTopology>);
565
+ expect(result.ok).toBe(true);
566
+ if (!result.ok) continue;
567
+ const names = result.value.inspect().passes.map((pass) => pass.name);
568
+ expect(names).toContain('transmission-backdrop-copy');
569
+ expect(names).toContain('transmission-backdrop-mip');
570
+ expect(names.indexOf('transmission-backdrop-copy')).toBeLessThan(
571
+ names.indexOf('transmission-forward'),
572
+ );
573
+ expect(names.indexOf('transmission-forward')).toBeLessThan(names.indexOf('transparent'));
574
+ expect(names.indexOf('transparent')).toBeLessThan(names.indexOf('temporal'));
575
+ }
576
+ });
577
+
578
+ it('uses the resolved single-sample MSAA source for the shared backdrop', async () => {
579
+ const result = await build(
580
+ { ...DEFAULT_STANDARD_PROFILE, lighting: 'direct' },
581
+ {
582
+ surface: {
583
+ width: 8,
584
+ height: 4,
585
+ storageFormat: 'bgra8unorm',
586
+ viewFormat: 'bgra8unorm-srgb',
587
+ },
588
+ camera: { tonemap: 'aces-filmic', antialias: 'msaa', bloom: 'on' },
589
+ lane: {
590
+ compute: true,
591
+ storageBuffer: true,
592
+ multisample: true,
593
+ maxColorAttachments: 8,
594
+ },
595
+ transmissionDemand: { activeCount: 1, needsRoughMips: true },
596
+ },
597
+ );
598
+ expect(result.ok).toBe(true);
599
+ if (!result.ok) return;
600
+ const inspected = result.value.inspect();
601
+ const names = inspected.passes.map((pass) => pass.name);
602
+ expect(inspected.resources.map((resource) => resource.label)).toContain('scene-color-msaa');
603
+ expect(names).toContain('transmission-backdrop-copy');
604
+ const copy = inspected.passes.find((pass) => pass.name === 'transmission-backdrop-copy');
605
+ expect(copy?.accesses).toEqual(
606
+ expect.arrayContaining([{ resource: 'scene-color', usage: 'copy-src' }]),
607
+ );
608
+ expect(copy?.accesses).not.toContainEqual({
609
+ resource: 'scene-color-msaa',
610
+ usage: 'copy-src',
611
+ });
612
+ });
613
+
614
+ it('keeps the CPU fallback lane on the same transmission phase contract', async () => {
615
+ const result = await build(
616
+ { ...DEFAULT_STANDARD_PROFILE, lighting: 'clustered', fallback: 'cpu-webgl2' },
617
+ {
618
+ lane: {
619
+ compute: false,
620
+ storageBuffer: false,
621
+ multisample: false,
622
+ maxColorAttachments: 4,
623
+ },
624
+ transmissionDemand: { activeCount: 1, needsRoughMips: false },
625
+ },
626
+ );
627
+ expect(result.ok).toBe(true);
628
+ if (!result.ok) return;
629
+ const names = result.value.inspect().passes.map((pass) => pass.name);
630
+ expect(names).toEqual(
631
+ expect.arrayContaining([
632
+ 'transmission-backdrop-copy',
633
+ 'transmission-forward',
634
+ 'transparent',
635
+ 'temporal',
636
+ ]),
637
+ );
638
+ expect(names).not.toContain('cluster-membership-producer');
639
+ });
640
+
641
+ it.each([
642
+ [
643
+ 'omitted-backdrop-copy',
644
+ (names: readonly string[]) => names.filter((name) => name !== 'transmission-backdrop-copy'),
645
+ ],
646
+ ['reversed-phase-order', (names: readonly string[]) => [...names].reverse()],
647
+ ] as const)('dev falsifier %s rejects the two-lane phase contract', async (_name, falsify) => {
648
+ const result = await build(
649
+ { ...DEFAULT_STANDARD_PROFILE, lighting: 'direct' },
650
+ {
651
+ transmissionDemand: { activeCount: 1, needsRoughMips: false },
652
+ },
653
+ );
654
+ expect(result.ok).toBe(true);
655
+ if (!result.ok) return;
656
+ const names = result.value.inspect().passes.map((pass) => pass.name);
657
+ const mutated = falsify(names);
658
+ expect(() => {
659
+ expect(mutated.indexOf('transmission-backdrop-copy')).toBeGreaterThanOrEqual(0);
660
+ expect(mutated.indexOf('transmission-backdrop-copy')).toBeLessThan(
661
+ mutated.indexOf('transmission-forward'),
662
+ );
663
+ expect(mutated.indexOf('transmission-forward')).toBeLessThan(mutated.indexOf('transparent'));
664
+ }).toThrow();
665
+ });
124
666
  });
@@ -54,9 +54,17 @@ describe('Standard profile oracle', () => {
54
54
  expect(DEFAULT_STANDARD_PROFILE.postStages).toEqual([
55
55
  'transparent-blend',
56
56
  'bloom',
57
- 'tone',
57
+ 'output-transform',
58
58
  'fxaa',
59
- 'output',
59
+ 'post-effect',
60
+ 'present',
60
61
  ]);
61
62
  });
63
+
64
+ it('does not duplicate Camera authoring facts in the Standard profile', () => {
65
+ expect(DEFAULT_STANDARD_PROFILE).not.toHaveProperty('tone');
66
+ expect(DEFAULT_STANDARD_PROFILE).not.toHaveProperty('antialias');
67
+ expect(DEFAULT_STANDARD_PROFILE).not.toHaveProperty('bloom');
68
+ expect(DEFAULT_STANDARD_PROFILE).not.toHaveProperty('sky');
69
+ });
62
70
  });
@@ -0,0 +1,35 @@
1
+ import { describe, expect, it } from 'vitest';
2
+ import {
3
+ aggregateTemporalDemand,
4
+ standardTemporalLaneAdmission,
5
+ } from '../temporal/standard-scene-data';
6
+
7
+ describe('Standard temporal producer admission', () => {
8
+ it.each([
9
+ ['direct', { compute: true, storageBuffer: true }],
10
+ ['clustered', { compute: true, storageBuffer: true }],
11
+ ['cpu-webgl2', { compute: false, storageBuffer: false }],
12
+ ['rhi-null', { compute: true, storageBuffer: true }],
13
+ ] as const)('shares temporal-v1 semantics on the %s lane', (lane, caps) => {
14
+ const admission = standardTemporalLaneAdmission({
15
+ lane,
16
+ demand: aggregateTemporalDemand({ taa: true, motionBlur: true }),
17
+ capabilities: { ...caps, rgba16floatRenderable: true },
18
+ });
19
+ expect(admission.status).toBe('available');
20
+ if (admission.status !== 'available') return;
21
+ expect(admission.schema).toBe('forgeax::scene-data::temporal-v1');
22
+ expect(admission.producerId).toBe('forgeax::standard::scene-data');
23
+ expect(admission.structuralOnly).toBe(lane === 'rhi-null');
24
+ });
25
+
26
+ it('returns closed unavailable data without an 8-bit fallback', () => {
27
+ const admission = standardTemporalLaneAdmission({
28
+ lane: 'direct',
29
+ demand: aggregateTemporalDemand({ taa: true, motionBlur: false }),
30
+ capabilities: { compute: true, storageBuffer: true, rgba16floatRenderable: false },
31
+ });
32
+ expect(admission).toMatchObject({ status: 'unavailable', reason: 'capability-missing' });
33
+ expect(admission).not.toHaveProperty('format', 'rgba8unorm');
34
+ });
35
+ });