@forgeax/engine-render 0.1.27 → 0.1.29

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 (655) hide show
  1. package/README.md +842 -124
  2. package/dist/assembly/atmosphere-shader-prewarm.d.ts +6 -0
  3. package/dist/assembly/atmosphere-shader-prewarm.d.ts.map +1 -0
  4. package/dist/assembly/dynamic-geometry-host.d.ts +52 -0
  5. package/dist/assembly/dynamic-geometry-host.d.ts.map +1 -0
  6. package/dist/assembly/dynamic-geometry-runtime.d.ts +20 -0
  7. package/dist/assembly/dynamic-geometry-runtime.d.ts.map +1 -0
  8. package/dist/assembly/factory.d.ts +3 -1
  9. package/dist/assembly/factory.d.ts.map +1 -1
  10. package/dist/assembly/gpu-driven-owner.d.ts +10 -0
  11. package/dist/assembly/gpu-driven-owner.d.ts.map +1 -0
  12. package/dist/assembly/host-contract.d.ts +19 -0
  13. package/dist/assembly/host-contract.d.ts.map +1 -1
  14. package/dist/assembly/material/assembly.d.ts +7 -0
  15. package/dist/assembly/material/assembly.d.ts.map +1 -1
  16. package/dist/assembly/material-shader-policy.d.ts +3 -1
  17. package/dist/assembly/material-shader-policy.d.ts.map +1 -1
  18. package/dist/assembly/recovery/failure-location.d.ts +12 -0
  19. package/dist/assembly/recovery/failure-location.d.ts.map +1 -0
  20. package/dist/assembly/recovery/renderer-recover.d.ts +6 -4
  21. package/dist/assembly/recovery/renderer-recover.d.ts.map +1 -1
  22. package/dist/assembly/renderer-facade.d.ts.map +1 -1
  23. package/dist/assembly/renderer-feature-inspection.d.ts +5 -0
  24. package/dist/assembly/renderer-feature-inspection.d.ts.map +1 -0
  25. package/dist/assembly/renderer-frame-transaction.d.ts +19 -0
  26. package/dist/assembly/renderer-frame-transaction.d.ts.map +1 -1
  27. package/dist/assembly/renderer-helpers.d.ts +3 -0
  28. package/dist/assembly/renderer-helpers.d.ts.map +1 -1
  29. package/dist/assembly/renderer-inspection.d.ts +4 -0
  30. package/dist/assembly/renderer-inspection.d.ts.map +1 -1
  31. package/dist/assembly/shader-prewarm-policy.d.ts +6 -0
  32. package/dist/assembly/shader-prewarm-policy.d.ts.map +1 -1
  33. package/dist/assembly/skin-palette-owner.d.ts +8 -0
  34. package/dist/assembly/skin-palette-owner.d.ts.map +1 -0
  35. package/dist/assembly/ssr-shader-prewarm.d.ts +6 -0
  36. package/dist/assembly/ssr-shader-prewarm.d.ts.map +1 -0
  37. package/dist/assembly/webgpu-device-loss.d.ts +15 -0
  38. package/dist/assembly/webgpu-device-loss.d.ts.map +1 -0
  39. package/dist/assembly/webgpu-pbr-ready.d.ts +38 -0
  40. package/dist/assembly/webgpu-pbr-ready.d.ts.map +1 -0
  41. package/dist/assembly/webgpu-ready-mipmap.d.ts +11 -0
  42. package/dist/assembly/webgpu-ready-mipmap.d.ts.map +1 -0
  43. package/dist/assembly/webgpu-ready.d.ts +7 -3
  44. package/dist/assembly/webgpu-ready.d.ts.map +1 -1
  45. package/dist/assembly/webgpu-renderer-bootstrap.d.ts +10 -0
  46. package/dist/assembly/webgpu-renderer-bootstrap.d.ts.map +1 -0
  47. package/dist/assembly/webgpu-renderer-contract.d.ts +62 -0
  48. package/dist/assembly/webgpu-renderer-contract.d.ts.map +1 -0
  49. package/dist/assembly/webgpu-renderer-guards.d.ts +9 -0
  50. package/dist/assembly/webgpu-renderer-guards.d.ts.map +1 -0
  51. package/dist/assembly/webgpu-renderer-observation.d.ts +6 -0
  52. package/dist/assembly/webgpu-renderer-observation.d.ts.map +1 -0
  53. package/dist/assembly/webgpu-renderer-recovery-failure.d.ts +12 -0
  54. package/dist/assembly/webgpu-renderer-recovery-failure.d.ts.map +1 -0
  55. package/dist/assembly/webgpu-renderer.d.ts +7 -141
  56. package/dist/assembly/webgpu-renderer.d.ts.map +1 -1
  57. package/dist/assembly/webgpu-vertex-layouts.d.ts +28 -84
  58. package/dist/assembly/webgpu-vertex-layouts.d.ts.map +1 -1
  59. package/dist/authoring.mjs +3 -3
  60. package/dist/{chunk-ADHHVYLW.mjs → chunk-33XZFTQU.mjs} +245 -39
  61. package/dist/chunk-33XZFTQU.mjs.map +1 -0
  62. package/dist/{chunk-GF523LHF.mjs → chunk-BLXGONR2.mjs} +30 -12
  63. package/dist/chunk-BLXGONR2.mjs.map +1 -0
  64. package/dist/{chunk-KM2NOX2I.mjs → chunk-BQVQOQJH.mjs} +958 -254
  65. package/dist/chunk-BQVQOQJH.mjs.map +1 -0
  66. package/dist/{chunk-HKXTW355.mjs → chunk-BTWH7BP4.mjs} +386 -17
  67. package/dist/chunk-BTWH7BP4.mjs.map +1 -0
  68. package/dist/{chunk-TMIASV2N.mjs → chunk-FUODTTIA.mjs} +3934 -676
  69. package/dist/chunk-FUODTTIA.mjs.map +1 -0
  70. package/dist/{chunk-FJ6P52EE.mjs → chunk-ILQ5MEZF.mjs} +3 -17
  71. package/dist/chunk-ILQ5MEZF.mjs.map +1 -0
  72. package/dist/{chunk-E34VL5VI.mjs → chunk-JQTSEI3Z.mjs} +3 -3
  73. package/dist/{chunk-E34VL5VI.mjs.map → chunk-JQTSEI3Z.mjs.map} +1 -1
  74. package/dist/{chunk-GE3SDD72.mjs → chunk-NICXSHAT.mjs} +16 -38
  75. package/dist/chunk-NICXSHAT.mjs.map +1 -0
  76. package/dist/{chunk-ZZ4YQ474.mjs → chunk-NRNXBLIJ.mjs} +577 -7
  77. package/dist/chunk-NRNXBLIJ.mjs.map +1 -0
  78. package/dist/{chunk-JDWARUOI.mjs → chunk-PA5DRJNI.mjs} +17 -3
  79. package/dist/chunk-PA5DRJNI.mjs.map +1 -0
  80. package/dist/{chunk-XDP6XE5V.mjs → chunk-S4DNKQYQ.mjs} +1118 -446
  81. package/dist/chunk-S4DNKQYQ.mjs.map +1 -0
  82. package/dist/components/camera.d.ts +62 -2
  83. package/dist/components/camera.d.ts.map +1 -1
  84. package/dist/components/index.d.ts +1 -0
  85. package/dist/components/index.d.ts.map +1 -1
  86. package/dist/components/instances.d.ts +6 -20
  87. package/dist/components/instances.d.ts.map +1 -1
  88. package/dist/components/scene-instance.d.ts +2 -1
  89. package/dist/components/scene-instance.d.ts.map +1 -1
  90. package/dist/components/screen-space-reflection.d.ts +14 -0
  91. package/dist/components/screen-space-reflection.d.ts.map +1 -0
  92. package/dist/construct-renderer.mjs +13805 -7186
  93. package/dist/construct-renderer.mjs.map +1 -1
  94. package/dist/device/gpu-residency.d.ts +11 -17
  95. package/dist/device/gpu-residency.d.ts.map +1 -1
  96. package/dist/device/mesh-residency-lifetime.d.ts +21 -0
  97. package/dist/device/mesh-residency-lifetime.d.ts.map +1 -0
  98. package/dist/dynamic-geometry.d.ts +125 -0
  99. package/dist/dynamic-geometry.d.ts.map +1 -0
  100. package/dist/environment/background.d.ts +6 -0
  101. package/dist/environment/background.d.ts.map +1 -0
  102. package/dist/errors/gpu-driven.d.ts +6 -3
  103. package/dist/errors/gpu-driven.d.ts.map +1 -1
  104. package/dist/errors/render.d.ts +7 -4
  105. package/dist/errors/render.d.ts.map +1 -1
  106. package/dist/extract/camera.d.ts.map +1 -1
  107. package/dist/extract/gpu-driven.d.ts +33 -3
  108. package/dist/extract/gpu-driven.d.ts.map +1 -1
  109. package/dist/features/host.d.ts +23 -1
  110. package/dist/features/host.d.ts.map +1 -1
  111. package/dist/features/noise-texture.d.ts +17 -0
  112. package/dist/features/noise-texture.d.ts.map +1 -0
  113. package/dist/features/plan.d.ts +83 -2
  114. package/dist/features/plan.d.ts.map +1 -1
  115. package/dist/features/prepared-gpu-work.d.ts +37 -4
  116. package/dist/features/prepared-gpu-work.d.ts.map +1 -1
  117. package/dist/features/prepared-graphics-store.d.ts.map +1 -1
  118. package/dist/features/prepared-graphics.d.ts +5 -0
  119. package/dist/features/prepared-graphics.d.ts.map +1 -1
  120. package/dist/features/render-graph-compute.d.ts +5 -3
  121. package/dist/features/render-graph-compute.d.ts.map +1 -1
  122. package/dist/features/render-graph-contribution.d.ts +11 -3
  123. package/dist/features/render-graph-contribution.d.ts.map +1 -1
  124. package/dist/features/render-graph-raster.d.ts +19 -3
  125. package/dist/features/render-graph-raster.d.ts.map +1 -1
  126. package/dist/features/types.d.ts +11 -0
  127. package/dist/features/types.d.ts.map +1 -1
  128. package/dist/fullscreen-post-process-pass.d.ts +2 -0
  129. package/dist/fullscreen-post-process-pass.d.ts.map +1 -1
  130. package/dist/gpu-driven/batch-topology.d.ts +34 -1
  131. package/dist/gpu-driven/batch-topology.d.ts.map +1 -1
  132. package/dist/gpu-driven/pbr-program.d.ts +10 -0
  133. package/dist/gpu-driven/pbr-program.d.ts.map +1 -0
  134. package/dist/gpu-driven/prepared-draw.d.ts.map +1 -1
  135. package/dist/gpu-driven/production-raster.d.ts +144 -23
  136. package/dist/gpu-driven/production-raster.d.ts.map +1 -1
  137. package/dist/gpu-driven/shadow-views.d.ts +126 -0
  138. package/dist/gpu-driven/shadow-views.d.ts.map +1 -0
  139. package/dist/gpu-driven/view-gpu.d.ts +18 -2
  140. package/dist/gpu-driven/view-gpu.d.ts.map +1 -1
  141. package/dist/gpu-scene-schema.d.ts +2 -8
  142. package/dist/gpu-scene-schema.d.ts.map +1 -1
  143. package/dist/gpu-scene.d.ts +14 -0
  144. package/dist/gpu-scene.d.ts.map +1 -1
  145. package/dist/gpu-texture-usage.d.ts +1 -0
  146. package/dist/gpu-texture-usage.d.ts.map +1 -1
  147. package/dist/hdrp-buffers.d.ts +6 -0
  148. package/dist/hdrp-buffers.d.ts.map +1 -1
  149. package/dist/ibl/frame-resources.d.ts +8 -0
  150. package/dist/ibl/frame-resources.d.ts.map +1 -0
  151. package/dist/ibl/skylight-bind-group.d.ts.map +1 -1
  152. package/dist/index.d.ts +21 -8
  153. package/dist/index.d.ts.map +1 -1
  154. package/dist/index.mjs +8 -7
  155. package/dist/index.mjs.map +1 -1
  156. package/dist/inspection-types.d.ts +164 -0
  157. package/dist/inspection-types.d.ts.map +1 -1
  158. package/dist/instances-derived-bounds.d.ts +11 -0
  159. package/dist/instances-derived-bounds.d.ts.map +1 -1
  160. package/dist/instances.d.ts +89 -44
  161. package/dist/instances.d.ts.map +1 -1
  162. package/dist/internal.d.ts +3 -0
  163. package/dist/internal.d.ts.map +1 -1
  164. package/dist/internal.mjs +118 -10
  165. package/dist/internal.mjs.map +1 -1
  166. package/dist/lifecycle.d.ts +2 -1
  167. package/dist/lifecycle.d.ts.map +1 -1
  168. package/dist/material-row.d.ts +5 -0
  169. package/dist/material-row.d.ts.map +1 -0
  170. package/dist/materials.d.ts +15 -0
  171. package/dist/materials.d.ts.map +1 -1
  172. package/dist/pbr-pipeline.d.ts +21 -5
  173. package/dist/pbr-pipeline.d.ts.map +1 -1
  174. package/dist/pipeline/standard-forward-lane.d.ts.map +1 -1
  175. package/dist/pipeline/standard-output/auto-exposure/capability.d.ts +12 -0
  176. package/dist/pipeline/standard-output/auto-exposure/capability.d.ts.map +1 -0
  177. package/dist/pipeline/standard-output/auto-exposure/gpu.d.ts +70 -0
  178. package/dist/pipeline/standard-output/auto-exposure/gpu.d.ts.map +1 -0
  179. package/dist/pipeline/standard-output/auto-exposure/graph.d.ts +75 -0
  180. package/dist/pipeline/standard-output/auto-exposure/graph.d.ts.map +1 -0
  181. package/dist/pipeline/standard-output/auto-exposure/inspection.d.ts +111 -0
  182. package/dist/pipeline/standard-output/auto-exposure/inspection.d.ts.map +1 -0
  183. package/dist/pipeline/standard-output/auto-exposure/oracle.d.ts +16 -0
  184. package/dist/pipeline/standard-output/auto-exposure/oracle.d.ts.map +1 -0
  185. package/dist/pipeline/standard-output/auto-exposure/preset.d.ts +14 -0
  186. package/dist/pipeline/standard-output/auto-exposure/preset.d.ts.map +1 -0
  187. package/dist/pipeline/standard-output/auto-exposure/state.d.ts +46 -0
  188. package/dist/pipeline/standard-output/auto-exposure/state.d.ts.map +1 -0
  189. package/dist/pipeline/standard-output/color-transform.d.ts +27 -0
  190. package/dist/pipeline/standard-output/color-transform.d.ts.map +1 -0
  191. package/dist/pipeline/standard-output/graph.d.ts +15 -0
  192. package/dist/pipeline/standard-output/graph.d.ts.map +1 -0
  193. package/dist/pipeline/standard-output/lut-admission.d.ts +29 -0
  194. package/dist/pipeline/standard-output/lut-admission.d.ts.map +1 -0
  195. package/dist/pipeline/standard-output/lut-gpu.d.ts +48 -0
  196. package/dist/pipeline/standard-output/lut-gpu.d.ts.map +1 -0
  197. package/dist/pipeline/standard-output/lut-state.d.ts +68 -0
  198. package/dist/pipeline/standard-output/lut-state.d.ts.map +1 -0
  199. package/dist/pipeline/standard-output/resources.d.ts +10 -0
  200. package/dist/pipeline/standard-output/resources.d.ts.map +1 -0
  201. package/dist/pipeline/standard-output/types.d.ts +39 -0
  202. package/dist/pipeline/standard-output/types.d.ts.map +1 -0
  203. package/dist/pipeline/standard-pipeline.d.ts.map +1 -1
  204. package/dist/pipeline/standard-post.d.ts +2 -2
  205. package/dist/pipeline/standard-post.d.ts.map +1 -1
  206. package/dist/pipeline-builder.d.ts +2 -1
  207. package/dist/pipeline-builder.d.ts.map +1 -1
  208. package/dist/pipeline-spec-types.d.ts +4 -0
  209. package/dist/pipeline-spec-types.d.ts.map +1 -1
  210. package/dist/pipeline-spec.d.ts +1 -9
  211. package/dist/pipeline-spec.d.ts.map +1 -1
  212. package/dist/points-lines/standard-owner.d.ts +1 -1
  213. package/dist/points-lines/standard-owner.d.ts.map +1 -1
  214. package/dist/prepare/prepared-graphics-resolver.d.ts +6 -1
  215. package/dist/prepare/prepared-graphics-resolver.d.ts.map +1 -1
  216. package/dist/record/dynamic-geometry-consumption.d.ts +15 -0
  217. package/dist/record/dynamic-geometry-consumption.d.ts.map +1 -0
  218. package/dist/record/frame-lighting.d.ts +3 -3
  219. package/dist/record/frame-lighting.d.ts.map +1 -1
  220. package/dist/record/frame-snapshot.d.ts +106 -5
  221. package/dist/record/frame-snapshot.d.ts.map +1 -1
  222. package/dist/record/frame-targets.d.ts.map +1 -1
  223. package/dist/record/frame.d.ts +39 -4
  224. package/dist/record/frame.d.ts.map +1 -1
  225. package/dist/record/main-pass-geometry.d.ts +7 -8
  226. package/dist/record/main-pass-geometry.d.ts.map +1 -1
  227. package/dist/record/main-pass-material.d.ts +38 -1
  228. package/dist/record/main-pass-material.d.ts.map +1 -1
  229. package/dist/record/main-pass-sprite-draws.d.ts +2 -10
  230. package/dist/record/main-pass-sprite-draws.d.ts.map +1 -1
  231. package/dist/record/main-pass.d.ts +12 -2
  232. package/dist/record/main-pass.d.ts.map +1 -1
  233. package/dist/record/mesh-ssbo.d.ts +15 -6
  234. package/dist/record/mesh-ssbo.d.ts.map +1 -1
  235. package/dist/record/prepared-material-bindings.d.ts +19 -0
  236. package/dist/record/prepared-material-bindings.d.ts.map +1 -0
  237. package/dist/record/recovery-pipeline.d.ts +2 -9
  238. package/dist/record/recovery-pipeline.d.ts.map +1 -1
  239. package/dist/record/render-context.d.ts +76 -26
  240. package/dist/record/render-context.d.ts.map +1 -1
  241. package/dist/record/shadow-pass.d.ts +62 -7
  242. package/dist/record/shadow-pass.d.ts.map +1 -1
  243. package/dist/record/skybox-post-pass.d.ts +1 -1
  244. package/dist/record/skybox-post-pass.d.ts.map +1 -1
  245. package/dist/record/typed-frame-graph.d.ts +35 -7
  246. package/dist/record/typed-frame-graph.d.ts.map +1 -1
  247. package/dist/record/view-ubo.d.ts +1 -0
  248. package/dist/record/view-ubo.d.ts.map +1 -1
  249. package/dist/recovery/render-system-candidate.d.ts +10 -2
  250. package/dist/recovery/render-system-candidate.d.ts.map +1 -1
  251. package/dist/recovery/render-system-roots.d.ts +11 -0
  252. package/dist/recovery/render-system-roots.d.ts.map +1 -0
  253. package/dist/recovery/types.d.ts +76 -0
  254. package/dist/recovery/types.d.ts.map +1 -0
  255. package/dist/reflection/record-owner.d.ts +0 -2
  256. package/dist/reflection/record-owner.d.ts.map +1 -1
  257. package/dist/render-contract.d.ts +185 -30
  258. package/dist/render-contract.d.ts.map +1 -1
  259. package/dist/render-graph-primitives.d.ts +1 -0
  260. package/dist/render-graph-primitives.d.ts.map +1 -1
  261. package/dist/render-pipeline.d.ts +64 -5
  262. package/dist/render-pipeline.d.ts.map +1 -1
  263. package/dist/render-system-extract-tail.d.ts +7 -5
  264. package/dist/render-system-extract-tail.d.ts.map +1 -1
  265. package/dist/render-system-extract.d.ts +101 -41
  266. package/dist/render-system-extract.d.ts.map +1 -1
  267. package/dist/render-system-projections.d.ts +22 -0
  268. package/dist/render-system-projections.d.ts.map +1 -0
  269. package/dist/render-system.d.ts +34 -77
  270. package/dist/render-system.d.ts.map +1 -1
  271. package/dist/scene/render-scene-types.d.ts +14 -7
  272. package/dist/scene/render-scene-types.d.ts.map +1 -1
  273. package/dist/scene/render-scene.d.ts +29 -11
  274. package/dist/scene/render-scene.d.ts.map +1 -1
  275. package/dist/scene/shadow-visibility.d.ts +5 -0
  276. package/dist/scene/shadow-visibility.d.ts.map +1 -0
  277. package/dist/ssr/admission.d.ts +70 -1
  278. package/dist/ssr/admission.d.ts.map +1 -1
  279. package/dist/ssr/compose.d.ts +13 -0
  280. package/dist/ssr/compose.d.ts.map +1 -0
  281. package/dist/ssr/errors.d.ts +35 -0
  282. package/dist/ssr/errors.d.ts.map +1 -1
  283. package/dist/ssr/graph.d.ts +60 -0
  284. package/dist/ssr/graph.d.ts.map +1 -0
  285. package/dist/ssr/history.d.ts +97 -0
  286. package/dist/ssr/history.d.ts.map +1 -0
  287. package/dist/ssr/hiz.d.ts +37 -0
  288. package/dist/ssr/hiz.d.ts.map +1 -0
  289. package/dist/ssr/inspection.d.ts +42 -0
  290. package/dist/ssr/inspection.d.ts.map +1 -0
  291. package/dist/ssr/resources.d.ts +58 -0
  292. package/dist/ssr/resources.d.ts.map +1 -0
  293. package/dist/ssr/temporal.d.ts +38 -0
  294. package/dist/ssr/temporal.d.ts.map +1 -0
  295. package/dist/systems/skin-palette-allocator.d.ts +32 -10
  296. package/dist/systems/skin-palette-allocator.d.ts.map +1 -1
  297. package/dist/systems/skin-palette-types.d.ts +15 -0
  298. package/dist/systems/skin-palette-types.d.ts.map +1 -1
  299. package/dist/systems/transparent-dispatch.d.ts +9 -0
  300. package/dist/systems/transparent-dispatch.d.ts.map +1 -0
  301. package/dist/targets/material-source.d.ts +7 -0
  302. package/dist/targets/material-source.d.ts.map +1 -1
  303. package/dist/temporal/frame-coordinator.d.ts +7 -0
  304. package/dist/temporal/frame-coordinator.d.ts.map +1 -1
  305. package/dist/temporal/gpu.d.ts +8 -0
  306. package/dist/temporal/gpu.d.ts.map +1 -1
  307. package/dist/temporal/history.d.ts.map +1 -1
  308. package/dist/temporal/index.mjs +6 -6
  309. package/dist/temporal/inspection.d.ts.map +1 -1
  310. package/dist/temporal/standard-scene-data.d.ts +2 -1
  311. package/dist/temporal/standard-scene-data.d.ts.map +1 -1
  312. package/dist/temporal/temporal-view.d.ts +2 -0
  313. package/dist/temporal/temporal-view.d.ts.map +1 -1
  314. package/dist/typed-render-graph-primitives.d.ts +35 -1
  315. package/dist/typed-render-graph-primitives.d.ts.map +1 -1
  316. package/dist/typed-shadow-passes.d.ts +3 -1
  317. package/dist/typed-shadow-passes.d.ts.map +1 -1
  318. package/dist/volume/temporal.d.ts +6 -0
  319. package/dist/volume/temporal.d.ts.map +1 -1
  320. package/package.json +21 -20
  321. package/src/__tests__/auto-exposure-gpu-evidence.ts +291 -0
  322. package/src/__tests__/auto-exposure-inspection.unit.test.ts +80 -0
  323. package/src/__tests__/auto-exposure-transaction.integration.test.ts +99 -0
  324. package/src/__tests__/auto-exposure.browser.test.ts +33 -0
  325. package/src/__tests__/auto-exposure.dawn.test.ts +33 -0
  326. package/src/__tests__/detached-inspection.integration.test.ts +5 -0
  327. package/src/__tests__/device-scope-lifecycle.unit.test.ts +18 -0
  328. package/src/__tests__/device-scope-stale-matrix.unit.test.ts +18 -0
  329. package/src/__tests__/docs-gate-green.unit.test.ts +3 -3
  330. package/src/__tests__/dynamic-geometry-host.unit.test.ts +1123 -0
  331. package/src/__tests__/dynamic-geometry.unit.test.ts +233 -0
  332. package/src/__tests__/factory-contract.integration.test.ts +73 -22
  333. package/src/__tests__/fallback-row-stride-surface.unit.test.ts +19 -0
  334. package/src/__tests__/feature-depth-input.dawn.test.ts +121 -0
  335. package/src/__tests__/feature-noise.unit.test.ts +38 -0
  336. package/src/__tests__/fixtures/taa-resolve-pinned-baseline.wgsl +301 -0
  337. package/src/__tests__/frame-camera-selection.unit.test.ts +131 -0
  338. package/src/__tests__/frame-plan-contract.unit.test.ts +24 -0
  339. package/src/__tests__/frame-targets.unit.test.ts +24 -0
  340. package/src/__tests__/fullscreen-feature-plan.unit.test.ts +3 -0
  341. package/src/__tests__/gpu-driven-baseline.characterization.test.ts +79 -0
  342. package/src/__tests__/gpu-driven-batch-topology-pbr.unit.test.ts +287 -6
  343. package/src/__tests__/gpu-driven-indirect-raster-evidence.ts +122 -142
  344. package/src/__tests__/gpu-driven-indirect-raster.browser.test.ts +10 -1
  345. package/src/__tests__/gpu-driven-lod-cache.unit.test.ts +264 -0
  346. package/src/__tests__/gpu-driven-mesh-world-identity.unit.test.ts +349 -0
  347. package/src/__tests__/gpu-driven-pbr.dawn.test.ts +1417 -0
  348. package/src/__tests__/gpu-driven-pbr.integration.test.ts +21 -0
  349. package/src/__tests__/gpu-driven-production-fixture.ts +96 -0
  350. package/src/__tests__/gpu-driven-production.integration.test.ts +1075 -93
  351. package/src/__tests__/gpu-driven-scaling.unit.test.ts +1 -3
  352. package/src/__tests__/gpu-driven-shadow-views.browser.test.ts +63 -0
  353. package/src/__tests__/gpu-driven-shadow-views.dawn.test.ts +294 -0
  354. package/src/__tests__/gpu-driven-shadow-views.integration.test.ts +97 -0
  355. package/src/__tests__/gpu-driven-shadow-views.unit.test.ts +168 -0
  356. package/src/__tests__/gpu-driven-skin-contract.test-d.ts +11 -0
  357. package/src/__tests__/gpu-driven-view-gpu-evidence.ts +72 -20
  358. package/src/__tests__/gpu-driven-view-graph.integration.test.ts +30 -9
  359. package/src/__tests__/gpu-driven-view.unit.test.ts +159 -52
  360. package/src/__tests__/gpu-pass-timing.browser.test.ts +6 -1
  361. package/src/__tests__/gpu-resource-store-stride.unit.test.ts +42 -0
  362. package/src/__tests__/gpu-scene-render-graph-gpu.ts +19 -5
  363. package/src/__tests__/gpu-scene.dawn.test.ts +40 -13
  364. package/src/__tests__/gpu-scene.unit.test.ts +559 -33
  365. package/src/__tests__/instances-culling.integration.test.ts +36 -10
  366. package/src/__tests__/instances-derived-bounds.unit.test.ts +54 -0
  367. package/src/__tests__/instances-store.unit.test.ts +242 -39
  368. package/src/__tests__/ktx2-basis-gpu-consumer.dawn.test.ts +6 -0
  369. package/src/__tests__/lighting-scene-roundtrip.integration.test.ts +13 -16
  370. package/src/__tests__/lut-lkg-transaction.integration.test.ts +122 -0
  371. package/src/__tests__/material-contract-inventory.unit.test.ts +5 -6
  372. package/src/__tests__/material-dispatch-shader-id.unit.test.ts +51 -0
  373. package/src/__tests__/material-lane-selection.unit.test.ts +60 -0
  374. package/src/__tests__/material-numeric-upload.unit.test.ts +53 -0
  375. package/src/__tests__/material-texture-handles.unit.test.ts +18 -0
  376. package/src/__tests__/material-texture-source.unit.test.ts +87 -0
  377. package/src/__tests__/materials-authoring-validation.unit.test.ts +41 -0
  378. package/src/__tests__/materials-standard-contract.unit.test.ts +52 -2
  379. package/src/__tests__/mesh-buffer-usage-surface.unit.test.ts +4 -0
  380. package/src/__tests__/mesh-submission-lifetime.unit.test.ts +53 -0
  381. package/src/__tests__/normal-fallback.dawn.test.ts +122 -0
  382. package/src/__tests__/particle-material-input-layout.unit.test.ts +104 -0
  383. package/src/__tests__/physical-clearcoat.integration.test.ts +37 -3
  384. package/src/__tests__/pipeline-texture-specialization.unit.test.ts +138 -0
  385. package/src/__tests__/point-shadow-inspection.unit.test.ts +2 -0
  386. package/src/__tests__/prepared-gpu-driven-pbr-contract.test-d.ts +31 -0
  387. package/src/__tests__/prepared-gpu-driven-pbr-contract.unit.test.ts +39 -0
  388. package/src/__tests__/prepared-gpu-driven-pbr.integration.test.ts +35 -4
  389. package/src/__tests__/prepared-graphics-capability.unit.test.ts +21 -0
  390. package/src/__tests__/prepared-graphics-pipeline-warmup.unit.test.ts +6 -2
  391. package/src/__tests__/profiler-phase-catalog.test.ts +5 -0
  392. package/src/__tests__/public-surface.test-d.ts +3 -0
  393. package/src/__tests__/recovery-candidate-prepare.contract.test.ts +30 -12
  394. package/src/__tests__/reflection-fallback-async-publication.unit.test.ts +104 -0
  395. package/src/__tests__/reflection-probe-record-owner.characterization.unit.test.ts +2 -1
  396. package/src/__tests__/render-error-code-owner.test-d.ts +4 -0
  397. package/src/__tests__/render-error-detail-ssot.test-d.ts +22 -0
  398. package/src/__tests__/render-error-exhaustive.test-d.ts +15 -0
  399. package/src/__tests__/render-feature-gpu-work.integration.test.ts +285 -2
  400. package/src/__tests__/render-feature-plan.unit.test.ts +245 -0
  401. package/src/__tests__/render-feature-shadow-order.unit.test.ts +228 -0
  402. package/src/__tests__/render-feature-zero-work.unit.test.ts +35 -1
  403. package/src/__tests__/render-graph-fallback.integration.test.ts +2 -2
  404. package/src/__tests__/render-owner-cohesion.unit.test.ts +55 -0
  405. package/src/__tests__/render-scene-mixed-updates.integration.test.ts +426 -0
  406. package/src/__tests__/render-scene-projection.unit.test.ts +914 -23
  407. package/src/__tests__/render-scene-resource-updates.integration.test.ts +214 -0
  408. package/src/__tests__/render-scene-skin-lifecycle.integration.test.ts +173 -0
  409. package/src/__tests__/render-scene-temporal-retry.unit.test.ts +133 -0
  410. package/src/__tests__/render-target-material-source.test-d.ts +27 -3
  411. package/src/__tests__/renderer-factory-material-contract.unit.test.ts +61 -1
  412. package/src/__tests__/renderer-frame-transaction.integration.test.ts +923 -5
  413. package/src/__tests__/shader-manifest-fixture.ts +39 -0
  414. package/src/__tests__/skin-motion-regression.unit.test.ts +0 -33
  415. package/src/__tests__/skin-palette-persistent.integration.test.ts +28 -0
  416. package/src/__tests__/skin-palette-persistent.unit.test.ts +247 -0
  417. package/src/__tests__/skinned-shadow-caster.test.ts +118 -14
  418. package/src/__tests__/specular-environment-scale.dawn.test.ts +156 -0
  419. package/src/__tests__/ssr-admission-matrix.integration.test.ts +7 -1
  420. package/src/__tests__/ssr-confidence-compose.unit.test.ts +84 -0
  421. package/src/__tests__/ssr-coordinate-oracle.unit.test.ts +28 -0
  422. package/src/__tests__/ssr-format-probe-gating.integration.test.ts +82 -0
  423. package/src/__tests__/ssr-gpu-dispatch.browser.test.ts +91 -0
  424. package/src/__tests__/ssr-gpu-dispatch.dawn.test.ts +112 -0
  425. package/src/__tests__/ssr-gpu-dispatch.ts +946 -0
  426. package/src/__tests__/ssr-graph-topology.unit.test.ts +104 -0
  427. package/src/__tests__/ssr-history-filter.dawn.test.ts +198 -0
  428. package/src/__tests__/ssr-hit-color.dawn.test.ts +273 -0
  429. package/src/__tests__/ssr-hiz-odd-reduction.dawn.test.ts +569 -0
  430. package/src/__tests__/ssr-hiz-rescue.dawn.test.ts +279 -0
  431. package/src/__tests__/ssr-hiz.browser.test.ts +150 -0
  432. package/src/__tests__/ssr-hiz.dawn.test.ts +150 -0
  433. package/src/__tests__/ssr-hiz.unit.test.ts +56 -0
  434. package/src/__tests__/ssr-inspection.unit.test.ts +105 -0
  435. package/src/__tests__/ssr-memory-budget.unit.test.ts +45 -0
  436. package/src/__tests__/ssr-performance-sequence-aggregation.unit.test.ts +15 -0
  437. package/src/__tests__/ssr-public-surface.test-d.ts +37 -0
  438. package/src/__tests__/ssr-receiver-coverage.dawn.test.ts +387 -0
  439. package/src/__tests__/ssr-reflection-mip-reducer.dawn.test.ts +309 -0
  440. package/src/__tests__/ssr-reprojection-probe.ts +90 -0
  441. package/src/__tests__/ssr-roughness-mip.dawn.test.ts +163 -0
  442. package/src/__tests__/ssr-shader-prewarm.unit.test.ts +59 -0
  443. package/src/__tests__/ssr-spatial.integration.test.ts +141 -0
  444. package/src/__tests__/ssr-stable-lattice.dawn.test.ts +475 -0
  445. package/src/__tests__/ssr-temporal-history.unit.test.ts +202 -0
  446. package/src/__tests__/ssr-texel-crossing.dawn.test.ts +448 -0
  447. package/src/__tests__/ssr-zero-work.integration.test.ts +87 -0
  448. package/src/__tests__/standard-cluster-variant-resolution.unit.test.ts +44 -12
  449. package/src/__tests__/standard-clustered-pipeline.unit.test.ts +29 -0
  450. package/src/__tests__/standard-output-chain-contract.unit.test.ts +99 -0
  451. package/src/__tests__/standard-output-chain.integration.test.ts +73 -0
  452. package/src/__tests__/standard-output-gpu-evidence.ts +205 -0
  453. package/src/__tests__/standard-output.browser.test.ts +15 -0
  454. package/src/__tests__/standard-output.dawn.test.ts +15 -0
  455. package/src/__tests__/standard-pbr-artifact-assembly.unit.test.ts +38 -0
  456. package/src/__tests__/standard-pipeline.integration.test.ts +320 -3
  457. package/src/__tests__/standard-profile-oracle.unit.test.ts +22 -0
  458. package/src/__tests__/standard-surface-lighting.unit.test.ts +41 -0
  459. package/src/__tests__/standard-texture-specialization.dawn.test.ts +141 -0
  460. package/src/__tests__/surface-adjacent-regressions.integration.test.ts +6 -3
  461. package/src/__tests__/taa-coverage-edge.dawn.test.ts +193 -0
  462. package/src/__tests__/taa-history-clipping.dawn.test.ts +328 -0
  463. package/src/__tests__/taa-neighborhood-equivalence.dawn.test.ts +778 -0
  464. package/src/__tests__/taa-stability-feedback.browser.test.ts +23 -0
  465. package/src/__tests__/taa-stability-feedback.dawn.test.ts +68 -0
  466. package/src/__tests__/taa-stability-feedback.ts +341 -0
  467. package/src/__tests__/temporal-history-lifecycle.unit.test.ts +49 -7
  468. package/src/__tests__/temporal-reset-matrix.unit.test.ts +9 -0
  469. package/src/__tests__/temporal-transaction.integration.test.ts +28 -0
  470. package/src/__tests__/texture-usage-surface.unit.test.ts +4 -2
  471. package/src/__tests__/typed-pipeline-topology.unit.test.ts +109 -4
  472. package/src/__tests__/typed-scene-pass-material-cache.integration.test.ts +126 -0
  473. package/src/__tests__/vertex-layouts-ssot.unit.test.ts +47 -0
  474. package/src/__tests__/visibility-extract.perf.test.ts +20 -8
  475. package/src/__tests__/visibility-instances.integration.test.ts +19 -7
  476. package/src/__tests__/visibility-producer-matrix.integration.test.ts +20 -9
  477. package/src/assembly/atmosphere-shader-prewarm.ts +38 -0
  478. package/src/assembly/dynamic-geometry-host.ts +887 -0
  479. package/src/assembly/dynamic-geometry-runtime.ts +71 -0
  480. package/src/assembly/factory.ts +4 -0
  481. package/src/assembly/gpu-driven-owner.ts +29 -0
  482. package/src/assembly/host-contract.ts +36 -0
  483. package/src/assembly/material/assembly.ts +38 -0
  484. package/src/assembly/material-shader-policy.ts +71 -28
  485. package/src/assembly/recovery/failure-location.ts +62 -0
  486. package/src/assembly/recovery/renderer-recover.ts +19 -17
  487. package/src/assembly/renderer-facade.ts +29 -0
  488. package/src/assembly/renderer-feature-inspection.ts +13 -0
  489. package/src/assembly/renderer-frame-transaction.ts +63 -0
  490. package/src/assembly/renderer-helpers.ts +26 -0
  491. package/src/assembly/renderer-inspection.ts +6 -0
  492. package/src/assembly/shader-prewarm-policy.ts +32 -0
  493. package/src/assembly/skin-palette-owner.ts +21 -0
  494. package/src/assembly/ssr-shader-prewarm.ts +41 -0
  495. package/src/assembly/webgpu-device-loss.ts +75 -0
  496. package/src/assembly/webgpu-pbr-ready.ts +232 -0
  497. package/src/assembly/webgpu-ready-mipmap.ts +26 -0
  498. package/src/assembly/webgpu-ready.ts +142 -121
  499. package/src/assembly/webgpu-renderer-bootstrap.ts +85 -0
  500. package/src/assembly/webgpu-renderer-contract.ts +69 -0
  501. package/src/assembly/webgpu-renderer-guards.ts +32 -0
  502. package/src/assembly/webgpu-renderer-observation.ts +43 -0
  503. package/src/assembly/webgpu-renderer-recovery-failure.ts +62 -0
  504. package/src/assembly/webgpu-renderer.ts +675 -614
  505. package/src/assembly/webgpu-vertex-layouts.ts +233 -87
  506. package/src/components/__tests__/camera-exposure.contract.unit.test.ts +153 -0
  507. package/src/components/camera.ts +287 -7
  508. package/src/components/index.ts +1 -0
  509. package/src/components/instances.ts +45 -18
  510. package/src/components/scene-instance.ts +2 -1
  511. package/src/components/screen-space-reflection.ts +21 -0
  512. package/src/components/sprite-animation.ts +3 -3
  513. package/src/components/sprite-instances.ts +1 -1
  514. package/src/device/gpu-residency.ts +96 -93
  515. package/src/device/mesh-residency-lifetime.ts +73 -0
  516. package/src/dynamic-geometry.ts +736 -0
  517. package/src/environment/background.ts +263 -0
  518. package/src/errors/gpu-driven.ts +39 -5
  519. package/src/errors/render.ts +27 -3
  520. package/src/extract/camera.ts +26 -1
  521. package/src/extract/gpu-driven.ts +185 -10
  522. package/src/features/host.ts +237 -19
  523. package/src/features/noise-texture.ts +91 -0
  524. package/src/features/plan.ts +553 -24
  525. package/src/features/prepared-gpu-work.ts +631 -49
  526. package/src/features/prepared-graphics-store.ts +31 -0
  527. package/src/features/prepared-graphics.ts +5 -0
  528. package/src/features/render-graph-compute.ts +41 -8
  529. package/src/features/render-graph-contribution.ts +141 -3
  530. package/src/features/render-graph-raster.ts +143 -30
  531. package/src/features/types.ts +11 -0
  532. package/src/fullscreen-post-process-pass.ts +3 -0
  533. package/src/gpu-driven/batch-topology.ts +424 -102
  534. package/src/gpu-driven/pbr-program.ts +31 -0
  535. package/src/gpu-driven/prepared-draw.ts +29 -4
  536. package/src/gpu-driven/production-raster.ts +2267 -694
  537. package/src/gpu-driven/shadow-views.ts +539 -0
  538. package/src/gpu-driven/view-gpu.ts +188 -41
  539. package/src/gpu-scene-schema.ts +52 -11
  540. package/src/gpu-scene.ts +186 -99
  541. package/src/gpu-texture-usage.ts +1 -0
  542. package/src/hdrp-buffers.ts +72 -36
  543. package/src/ibl/frame-resources.ts +38 -0
  544. package/src/ibl/skylight-bind-group.ts +5 -4
  545. package/src/index.ts +125 -1
  546. package/src/inspection-types.ts +191 -0
  547. package/src/instances-derived-bounds.ts +258 -34
  548. package/src/instances.ts +459 -150
  549. package/src/internal.ts +22 -0
  550. package/src/lifecycle.ts +2 -0
  551. package/src/material-row.ts +145 -0
  552. package/src/materials.ts +44 -8
  553. package/src/pbr-pipeline.ts +159 -17
  554. package/src/pipeline/standard-forward-lane.ts +52 -24
  555. package/src/pipeline/standard-output/__tests__/lut-admission.unit.test.ts +103 -0
  556. package/src/pipeline/standard-output/auto-exposure/__tests__/capability.unit.test.ts +40 -0
  557. package/src/pipeline/standard-output/auto-exposure/__tests__/gpu.contract.unit.test.ts +125 -0
  558. package/src/pipeline/standard-output/auto-exposure/__tests__/graph.contract.unit.test.ts +94 -0
  559. package/src/pipeline/standard-output/auto-exposure/__tests__/oracle.test.ts +108 -0
  560. package/src/pipeline/standard-output/auto-exposure/__tests__/preset.test.ts +26 -0
  561. package/src/pipeline/standard-output/auto-exposure/capability.ts +38 -0
  562. package/src/pipeline/standard-output/auto-exposure/gpu.ts +567 -0
  563. package/src/pipeline/standard-output/auto-exposure/graph.ts +221 -0
  564. package/src/pipeline/standard-output/auto-exposure/inspection.ts +231 -0
  565. package/src/pipeline/standard-output/auto-exposure/oracle.ts +291 -0
  566. package/src/pipeline/standard-output/auto-exposure/preset.ts +28 -0
  567. package/src/pipeline/standard-output/auto-exposure/state.ts +156 -0
  568. package/src/pipeline/standard-output/color-transform.ts +124 -0
  569. package/src/pipeline/standard-output/graph.ts +139 -0
  570. package/src/pipeline/standard-output/lut-admission.ts +121 -0
  571. package/src/pipeline/standard-output/lut-gpu.ts +399 -0
  572. package/src/pipeline/standard-output/lut-state.ts +176 -0
  573. package/src/pipeline/standard-output/resources.ts +121 -0
  574. package/src/pipeline/standard-output/types.ts +58 -0
  575. package/src/pipeline/standard-pipeline.ts +192 -59
  576. package/src/pipeline/standard-post.ts +186 -27
  577. package/src/pipeline-builder.ts +16 -6
  578. package/src/pipeline-spec-types.ts +4 -0
  579. package/src/pipeline-spec.ts +37 -29
  580. package/src/points-lines/standard-owner.ts +6 -14
  581. package/src/prepare/prepared-graphics-resolver.ts +9 -2
  582. package/src/record/__tests__/material-slot-plan.unit.test.ts +48 -0
  583. package/src/record/__tests__/mesh-ssbo.unit.test.ts +40 -1
  584. package/src/record/__tests__/recovery-pipeline.unit.test.ts +2 -29
  585. package/src/record/__tests__/sprite-material-abi.unit.test.ts +36 -5
  586. package/src/record/__tests__/typed-frame-graph-plan.unit.test.ts +45 -0
  587. package/src/record/__tests__/view-ubo-layout.unit.test.ts +5 -0
  588. package/src/record/dynamic-geometry-consumption.ts +59 -0
  589. package/src/record/frame-lighting.ts +12 -11
  590. package/src/record/frame-snapshot.ts +133 -23
  591. package/src/record/frame-targets.ts +9 -0
  592. package/src/record/frame.ts +727 -133
  593. package/src/record/main-pass-geometry.ts +162 -98
  594. package/src/record/main-pass-material.ts +115 -26
  595. package/src/record/main-pass-sprite-draws.ts +18 -107
  596. package/src/record/main-pass.ts +78 -8
  597. package/src/record/material-uniforms.ts +1 -1
  598. package/src/record/mesh-ssbo.ts +59 -15
  599. package/src/record/prepared-material-bindings.ts +234 -0
  600. package/src/record/recovery-pipeline.ts +59 -136
  601. package/src/record/render-context.ts +92 -22
  602. package/src/record/shadow-pass.ts +1231 -209
  603. package/src/record/skybox-post-pass.ts +14 -3
  604. package/src/record/typed-frame-graph.ts +1006 -53
  605. package/src/record/view-ubo.ts +11 -0
  606. package/src/recovery/render-system-candidate.ts +90 -66
  607. package/src/recovery/render-system-roots.ts +113 -0
  608. package/src/recovery/types.ts +77 -0
  609. package/src/reflection/record-owner.ts +26 -54
  610. package/src/render-contract.ts +219 -25
  611. package/src/render-graph-primitives.ts +6 -2
  612. package/src/render-pipeline.ts +70 -1
  613. package/src/render-system-extract-tail.ts +409 -160
  614. package/src/render-system-extract.ts +376 -102
  615. package/src/render-system-projections.ts +241 -0
  616. package/src/render-system.ts +692 -791
  617. package/src/scene/render-scene-types.ts +13 -4
  618. package/src/scene/render-scene.ts +569 -355
  619. package/src/scene/shadow-visibility.ts +21 -0
  620. package/src/ssr/admission.ts +380 -14
  621. package/src/ssr/compose.ts +144 -0
  622. package/src/ssr/errors.ts +48 -0
  623. package/src/ssr/graph.ts +777 -0
  624. package/src/ssr/history.ts +436 -0
  625. package/src/ssr/hiz.ts +124 -0
  626. package/src/ssr/inspection.ts +124 -0
  627. package/src/ssr/resources.ts +202 -0
  628. package/src/ssr/temporal.ts +164 -0
  629. package/src/systems/skin-palette-allocator.ts +495 -148
  630. package/src/systems/skin-palette-types.ts +17 -0
  631. package/src/systems/transparent-dispatch.ts +90 -0
  632. package/src/targets/material-source.ts +34 -0
  633. package/src/temporal/coverage.ts +1 -1
  634. package/src/temporal/frame-coordinator.ts +23 -2
  635. package/src/temporal/gpu.ts +74 -12
  636. package/src/temporal/history.ts +3 -1
  637. package/src/temporal/inspection.ts +2 -1
  638. package/src/temporal/standard-scene-data.ts +3 -1
  639. package/src/temporal/temporal-view.ts +3 -0
  640. package/src/transmission/__tests__/standard-transmission.dawn.test.ts +204 -139
  641. package/src/typed-render-graph-primitives.ts +266 -74
  642. package/src/typed-shadow-passes.ts +122 -12
  643. package/src/volume/temporal.ts +10 -0
  644. package/dist/chunk-ADHHVYLW.mjs.map +0 -1
  645. package/dist/chunk-FJ6P52EE.mjs.map +0 -1
  646. package/dist/chunk-GE3SDD72.mjs.map +0 -1
  647. package/dist/chunk-GF523LHF.mjs.map +0 -1
  648. package/dist/chunk-HKXTW355.mjs.map +0 -1
  649. package/dist/chunk-JDWARUOI.mjs.map +0 -1
  650. package/dist/chunk-KM2NOX2I.mjs.map +0 -1
  651. package/dist/chunk-TMIASV2N.mjs.map +0 -1
  652. package/dist/chunk-XDP6XE5V.mjs.map +0 -1
  653. package/dist/chunk-ZZ4YQ474.mjs.map +0 -1
  654. package/src/__tests__/instances-world-ownership.integration.test.ts +0 -62
  655. package/src/scene/__tests__/changed-block-summary.candidate.test.ts +0 -36
@@ -0,0 +1,23 @@
1
+ import { beforeAll, expect, it } from 'vitest';
2
+ import { verifyTaaStabilityFeedback } from './taa-stability-feedback';
3
+
4
+ let publishedSource: string;
5
+
6
+ beforeAll(async () => {
7
+ const response = await fetch('/shaders/manifest.json');
8
+ expect(response.ok).toBe(true);
9
+ const manifest = (await response.json()) as { entries: { wgsl: string }[] };
10
+ const entries = manifest.entries.filter((entry) => entry.wgsl.includes('fn fs_taa_resolve('));
11
+ expect(entries).toHaveLength(1);
12
+ const entry = entries[0];
13
+ if (!entry) throw new Error('Missing published TAA shader');
14
+ publishedSource = entry.wgsl;
15
+ });
16
+
17
+ it.each([
18
+ 'feedback',
19
+ 'secondary-motion',
20
+ 'clipping-recovery',
21
+ ] as const)('preserves HDR feedback and recovery through browser shader publication (%s)', async (scenario) => {
22
+ await verifyTaaStabilityFeedback(publishedSource, scenario);
23
+ });
@@ -0,0 +1,68 @@
1
+ import { readFileSync } from 'node:fs';
2
+ import { resolve } from 'node:path';
3
+ import { expect, it } from 'vitest';
4
+ import { verifyTaaStabilityFeedback } from './taa-stability-feedback';
5
+
6
+ it('preserves temporal metadata and accumulates cyclic radiance without biased half-float feedback', async () => {
7
+ const source = readFileSync(resolve('packages/shader/src/taa-resolve.wgsl'), 'utf8').replace(
8
+ /^#define_import_path.*$/gm,
9
+ '',
10
+ );
11
+ await verifyTaaStabilityFeedback(source);
12
+ const premature = source.replace(
13
+ 'mix(0.95, 0.99, smoothstep(64.0, TAA_HISTORY_SETTLE_FRAMES, stableAge))',
14
+ '0.99',
15
+ );
16
+ expect(premature).not.toBe(source);
17
+ await expect(verifyTaaStabilityFeedback(premature)).rejects.toThrow(
18
+ 'TAA must follow delayed accumulation',
19
+ );
20
+ });
21
+
22
+ it('invalidates final TAA for secondary source motion without changing receiver velocity', async () => {
23
+ const source = readFileSync(resolve('packages/shader/src/taa-resolve.wgsl'), 'utf8').replace(
24
+ /^#define_import_path.*$/gm,
25
+ '',
26
+ );
27
+ await verifyTaaStabilityFeedback(source, 'secondary-motion');
28
+ const ignored = source.replace(
29
+ /fn sampleSecondaryReactivity\([\s\S]*?\n}/,
30
+ 'fn sampleSecondaryReactivity(uv : vec2<f32>) -> f32 { return 0.0; }',
31
+ );
32
+ expect(ignored).not.toBe(source);
33
+ await expect(verifyTaaStabilityFeedback(ignored, 'secondary-motion')).rejects.toThrow(
34
+ 'secondary motion must reject old radiance',
35
+ );
36
+ });
37
+
38
+ it('preserves phase-local coverage while rejecting persistent unmarked color changes', async () => {
39
+ const source = readFileSync(resolve('packages/shader/src/taa-resolve.wgsl'), 'utf8').replace(
40
+ /^#define_import_path.*$/gm,
41
+ '',
42
+ );
43
+ await verifyTaaStabilityFeedback(source, 'clipping-recovery');
44
+ const resetFootprint = source.replace(
45
+ 'return TaaClipDecision(clipped, TAA_HISTORY_SETTLE_FRAMES / 255.0);',
46
+ 'return TaaClipDecision(clipped, 0.0);',
47
+ );
48
+ expect(resetFootprint).not.toBe(source);
49
+ await expect(verifyTaaStabilityFeedback(resetFootprint, 'clipping-recovery')).rejects.toThrow(
50
+ 'color clipping must not discard the accepted stationary reconstruction footprint',
51
+ );
52
+ const delayedRelease = source.replace(
53
+ 'smoothstep(TAA_STABILITY_FRAMES, 64.0, age)',
54
+ '0.9 * smoothstep(64.0, TAA_HISTORY_SETTLE_FRAMES, age)',
55
+ );
56
+ expect(delayedRelease).not.toBe(source);
57
+ await expect(verifyTaaStabilityFeedback(delayedRelease, 'clipping-recovery')).rejects.toThrow(
58
+ 'coverage must converge before increasing the stationary history weight',
59
+ );
60
+ const frozen = source.replace(
61
+ /fn resolveTaaClipping\([\s\S]*?\n}/,
62
+ 'fn resolveTaaClipping(clipped : vec3<f32>, history : vec3<f32>, previous : f32, age : f32) -> TaaClipDecision { return TaaClipDecision(history, age / 255.0); }',
63
+ );
64
+ expect(frozen).not.toBe(source);
65
+ await expect(verifyTaaStabilityFeedback(frozen, 'clipping-recovery')).rejects.toThrow(
66
+ 'persistent unmarked color change must recover within one jitter cycle',
67
+ );
68
+ });
@@ -0,0 +1,341 @@
1
+ import { createShaderModuleImmediate, rhi } from '@forgeax/engine-rhi-webgpu';
2
+ import { expect } from 'vitest';
3
+ import { DeviceScope } from '../device/device-scope';
4
+ import {
5
+ GPU_TEXTURE_USAGE_COPY_DST,
6
+ GPU_TEXTURE_USAGE_TEXTURE_BINDING,
7
+ } from '../gpu-texture-usage';
8
+ import { GPU_BUFFER_USAGE_COPY_DST, GPU_BUFFER_USAGE_MAP_READ } from '../gpu-usage';
9
+ import type { RenderFrameState } from '../record/frame-snapshot';
10
+ import {
11
+ commitTemporalGpuSubmit,
12
+ getTemporalBindGroupResources,
13
+ getTemporalGpuState,
14
+ getTemporalParamsBuffer,
15
+ retireTemporalGpuState,
16
+ stageTemporalGpuSubmit,
17
+ } from '../temporal/gpu';
18
+
19
+ export async function verifyTaaStabilityFeedback(
20
+ source: string,
21
+ scenario: 'feedback' | 'secondary-motion' | 'clipping-recovery' = 'feedback',
22
+ ) {
23
+ const secondaryMotion = scenario === 'secondary-motion';
24
+ const clippingCycle = scenario === 'clipping-recovery';
25
+ const frameCount = secondaryMotion || clippingCycle ? 658 : 528;
26
+ const frameBytes = 768;
27
+ const device = (await (await rhi.requestAdapter()).unwrap().requestDevice()).unwrap();
28
+ const state = getTemporalGpuState(
29
+ {} as RenderFrameState,
30
+ device,
31
+ DeviceScope.create(23, 'taa-feedback'),
32
+ 2,
33
+ 1,
34
+ );
35
+ const inputs = getTemporalBindGroupResources(state);
36
+ if (inputs.sampler === null || inputs.temporalSampler === null)
37
+ throw new Error('Missing TAA samplers');
38
+ const params = getTemporalParamsBuffer(state);
39
+ const module = createShaderModuleImmediate(device, { code: source }).unwrap();
40
+ const empty = device.createBindGroupLayout({ entries: [] }).unwrap();
41
+ const emptyGroup = device.createBindGroup({ layout: empty, entries: [] }).unwrap();
42
+ const pipeline = device
43
+ .createRenderPipeline({
44
+ layout: device.createPipelineLayout({ bindGroupLayouts: [empty, inputs.layout] }).unwrap(),
45
+ vertex: { module, entryPoint: 'vs_main', buffers: [] },
46
+ fragment: {
47
+ module,
48
+ entryPoint: 'fs_main',
49
+ targets: [{ format: 'rgba16float' }, { format: 'rgba16float' }, { format: 'r8unorm' }],
50
+ },
51
+ primitive: { topology: 'triangle-list' },
52
+ })
53
+ .unwrap();
54
+ const current = Array.from({ length: 3 }, () => {
55
+ const texture = device
56
+ .createTexture({
57
+ size: { width: 2, height: 1, depthOrArrayLayers: 1 },
58
+ format: 'rgba16float',
59
+ textureBindingViewDimension: '2d',
60
+ usage: GPU_TEXTURE_USAGE_COPY_DST | GPU_TEXTURE_USAGE_TEXTURE_BINDING,
61
+ })
62
+ .unwrap();
63
+ return { texture, view: device.createTextureView(texture, {}).unwrap() };
64
+ });
65
+ const readback = device
66
+ .createBuffer({
67
+ size: frameBytes * frameCount,
68
+ usage: GPU_BUFFER_USAGE_MAP_READ | GPU_BUFFER_USAGE_COPY_DST,
69
+ })
70
+ .unwrap();
71
+ try {
72
+ const color = current[0];
73
+ const temporal = current[1];
74
+ const secondary = current[2];
75
+ if (!color || !temporal || !secondary) throw new Error('Missing current inputs');
76
+ device.queue
77
+ .writeTexture(
78
+ { texture: color.texture },
79
+ new Uint16Array(Array(8).fill(0x3c00)),
80
+ { bytesPerRow: 16, rowsPerImage: 1 },
81
+ { width: 2, height: 1, depthOrArrayLayers: 1 },
82
+ )
83
+ .unwrap();
84
+ const ages = [];
85
+ const errors: number[] = [];
86
+ let reference = 0;
87
+ let previousActual = 0;
88
+ let stepReference = 0;
89
+ // Initial seed, eight stationary frames, motion, stop, reactive material,
90
+ // then depth disocclusion. Values below are exact half-float encodings.
91
+ const cycleTail: number[] = [];
92
+ const earlyCycle: number[] = [];
93
+ for (let frame = 0; frame < frameCount; frame++) {
94
+ const reactive = secondaryMotion && frame === 528;
95
+ const metadata = new Uint16Array([
96
+ frame === 9 ? 0x3000 : 0,
97
+ 0,
98
+ frame >= 14 ? 0x4400 : 0x4000,
99
+ frame === 12 ? 0x3800 : 0,
100
+ ]);
101
+ if (frame >= 16) {
102
+ // Complementary neighboring pixels keep the color bounds at [0, 1].
103
+ // Only temporal feedback (not clipping or input quantization) changes
104
+ // the analytic Karis recurrence. All input values are exact in FP16.
105
+ const value = clippingCycle ? (frame >= 528 ? 0 : Number(frame % 8 !== 2)) : frame % 2;
106
+ const neighbor = clippingCycle ? value : 1 - value;
107
+ if (frame === 16) state.valid = false;
108
+ device.queue
109
+ .writeTexture(
110
+ { texture: color.texture },
111
+ new Uint16Array([
112
+ value * 0x3c00,
113
+ value * 0x3c00,
114
+ value * 0x3c00,
115
+ 0x3c00,
116
+ neighbor * 0x3c00,
117
+ neighbor * 0x3c00,
118
+ neighbor * 0x3c00,
119
+ 0x3c00,
120
+ ]),
121
+ { bytesPerRow: 16, rowsPerImage: 1 },
122
+ { width: 2, height: 1, depthOrArrayLayers: 1 },
123
+ )
124
+ .unwrap();
125
+ }
126
+ device.queue
127
+ .writeTexture(
128
+ { texture: temporal.texture },
129
+ new Uint16Array([...metadata, ...metadata]),
130
+ { bytesPerRow: 16, rowsPerImage: 1 },
131
+ { width: 2, height: 1, depthOrArrayLayers: 1 },
132
+ )
133
+ .unwrap();
134
+ device.queue
135
+ .writeTexture(
136
+ { texture: secondary.texture },
137
+ new Uint16Array([reactive ? 0x3c00 : 0, 0, 0, 0, reactive ? 0x3c00 : 0, 0, 0, 0]),
138
+ { bytesPerRow: 16, rowsPerImage: 1 },
139
+ { width: 2, height: 1, depthOrArrayLayers: 1 },
140
+ )
141
+ .unwrap();
142
+ device.queue
143
+ .writeBuffer(
144
+ params,
145
+ 0,
146
+ new Uint32Array([0, 0, Number(state.valid), frame, Number(secondaryMotion), 0, 0, 0]),
147
+ )
148
+ .unwrap();
149
+ const index = state.readIndex;
150
+ const group = device
151
+ .createBindGroup({
152
+ layout: inputs.layout,
153
+ entries: [
154
+ { binding: 0, resource: { kind: 'textureView', value: color.view } },
155
+ { binding: 1, resource: { kind: 'sampler', value: inputs.sampler } },
156
+ { binding: 2, resource: { kind: 'textureView', value: state.color[index].view } },
157
+ { binding: 3, resource: { kind: 'sampler', value: inputs.sampler } },
158
+ { binding: 4, resource: { kind: 'textureView', value: state.temporal[index].view } },
159
+ { binding: 5, resource: { kind: 'sampler', value: inputs.temporalSampler } },
160
+ { binding: 6, resource: { kind: 'textureView', value: temporal.view } },
161
+ { binding: 7, resource: { kind: 'sampler', value: inputs.temporalSampler } },
162
+ { binding: 8, resource: { kind: 'buffer', value: { buffer: params } } },
163
+ { binding: 9, resource: { kind: 'textureView', value: state.stability[index].view } },
164
+ { binding: 10, resource: { kind: 'textureView', value: secondary.view } },
165
+ ],
166
+ })
167
+ .unwrap();
168
+ stageTemporalGpuSubmit(state);
169
+ const next = state.pendingIndex;
170
+ if (next === undefined) throw new Error('Missing staged history write');
171
+ const encoder = device.createCommandEncoder().unwrap();
172
+ const targets = [state.color[next], state.temporal[next], state.stability[next]];
173
+ const pass = encoder.beginRenderPass({
174
+ colorAttachments: targets.map(({ view }) => ({
175
+ view,
176
+ loadOp: 'clear',
177
+ storeOp: 'store',
178
+ clearValue: { r: 0, g: 0, b: 0, a: 0 },
179
+ })),
180
+ });
181
+ pass.setPipeline(pipeline);
182
+ pass.setBindGroup(0, emptyGroup);
183
+ pass.setBindGroup(1, group);
184
+ pass.draw(3, 1, 0, 0);
185
+ pass.end();
186
+ for (const [slot, surface] of targets.entries())
187
+ encoder.copyTextureToBuffer(
188
+ { texture: surface.texture },
189
+ {
190
+ buffer: readback,
191
+ offset: frame * frameBytes + slot * 256,
192
+ bytesPerRow: 256,
193
+ rowsPerImage: 1,
194
+ },
195
+ { width: 1, height: 1, depthOrArrayLayers: 1 },
196
+ );
197
+ device.queue.submit([encoder.finish().unwrap()]).unwrap();
198
+ expect(commitTemporalGpuSubmit(state)).toBe(true);
199
+ }
200
+ // Preserve every submitted frame and its three outputs, but synchronize
201
+ // with the GPU once. No input depends on CPU readback; the analytic oracle
202
+ // can consume the complete ordered history after the queue finishes.
203
+ const mapped = (await readback.mapAsync(GPU_BUFFER_USAGE_MAP_READ)).unwrap();
204
+ const history = mapped.getMappedRange().unwrap().slice(0);
205
+ mapped.unmap();
206
+ for (let frame = 0; frame < frameCount; frame++) {
207
+ const reactive = secondaryMotion && frame === 528;
208
+ const metadata = [
209
+ frame === 9 ? 0x3000 : 0,
210
+ 0,
211
+ frame >= 14 ? 0x4400 : 0x4000,
212
+ frame === 12 ? 0x3800 : 0,
213
+ ];
214
+ const bytes = history.slice(frame * frameBytes, (frame + 1) * frameBytes);
215
+ if (frame >= 16) {
216
+ const value = clippingCycle ? (frame >= 528 ? 0 : Number(frame % 8 !== 2)) : frame % 2;
217
+ const settled = Math.max(0, Math.min(1, (frame - 16 - 64) / 64));
218
+ const steadyWeight = 0.95 + 0.04 * settled * settled * (3 - 2 * settled);
219
+ const weight = Math.min(steadyWeight, frame / (frame + 1));
220
+ const a = (1 - weight) / (1 + value);
221
+ const b = weight / (1 + reference);
222
+ reference = frame === 16 ? value : (value * a + reference * b) / (a + b);
223
+ const previousWeight = weight / (1 + previousActual);
224
+ stepReference =
225
+ frame === 16
226
+ ? value
227
+ : (value * a + previousActual * previousWeight) / (a + previousWeight);
228
+ }
229
+ const result = new Uint16Array(bytes, 0, 4);
230
+ if (frame >= 16 && frame < 528 && !clippingCycle) {
231
+ const half = result[0];
232
+ if (half === undefined) throw new Error('Missing TAA color readback');
233
+ const actual =
234
+ half < 1024 ? half * 2 ** -24 : (1 + (half & 1023) / 1024) * 2 ** ((half >>> 10) - 15);
235
+ // Stochastic FP16 rounding feeds its error into later frames, so a
236
+ // per-frame formula check must start with the actual stored history.
237
+ // Only the two adjacent FP16 values are legal (plus FP32 arithmetic
238
+ // tolerance). The independent infinite-precision tail below still
239
+ // detects accumulated bias; it is not reset to the GPU result.
240
+ const spacing = 2 ** Math.max(-24, Math.floor(Math.log2(stepReference)) - 10);
241
+ const lower = Math.floor(stepReference / spacing) * spacing;
242
+ const upper = Math.ceil(stepReference / spacing) * spacing;
243
+ const message = `TAA must follow delayed accumulation: frame=${frame}, actual=${actual}, expected=${stepReference}`;
244
+ expect(actual, message).toBeGreaterThanOrEqual(lower - 0.000001);
245
+ expect(actual, message).toBeLessThanOrEqual(upper + 0.000001);
246
+ previousActual = actual;
247
+ }
248
+ if (frame < 16) {
249
+ expect([...result]).toEqual([0x3c00, 0x3c00, 0x3c00, 0x3c00]);
250
+ ages.push(new Uint8Array(bytes)[512]);
251
+ } else if (frame >= 464 && frame < 528 && !clippingCycle) {
252
+ const half = result[0];
253
+ if (half === undefined) throw new Error('Missing TAA color readback');
254
+ // The expected steady values are normal, positive half floats.
255
+ expect(half >>> 10).toBeGreaterThan(0);
256
+ expect(half >>> 10).toBeLessThan(31);
257
+ const actual = (1 + (half & 1023) / 1024) * 2 ** ((half >>> 10) - 15);
258
+ errors.push(actual - reference);
259
+ expect(result[1]).toBe(half);
260
+ expect(result[2]).toBe(half);
261
+ expect(result[3]).toBe(0x3c00);
262
+ }
263
+ if (clippingCycle && frame >= 120 && frame < 128) {
264
+ const half = result[0];
265
+ if (half === undefined) throw new Error('Missing early clipping-cycle color');
266
+ earlyCycle.push(
267
+ half < 1024 ? half * 2 ** -24 : (1 + (half & 1023) / 1024) * 2 ** ((half >>> 10) - 15),
268
+ );
269
+ if (frame === 127)
270
+ expect(
271
+ Math.abs(earlyCycle.reduce((sum, value) => sum + value, 0) / earlyCycle.length - 7 / 9),
272
+ 'coverage must converge before increasing the stationary history weight',
273
+ ).toBeLessThan(0.03);
274
+ }
275
+ if (clippingCycle && frame >= 464) {
276
+ expect(
277
+ new Uint8Array(bytes)[512],
278
+ 'color clipping must not discard the accepted stationary reconstruction footprint',
279
+ ).toBeGreaterThanOrEqual(128);
280
+ const half = result[0];
281
+ if (half === undefined) throw new Error('Missing clipping-cycle color');
282
+ const actual =
283
+ half < 1024 ? half * 2 ** -24 : (1 + (half & 1023) / 1024) * 2 ** ((half >>> 10) - 15);
284
+ if (frame < 528) cycleTail.push(actual);
285
+ if (frame === 527)
286
+ expect(
287
+ Math.max(...cycleTail) - Math.min(...cycleTail),
288
+ 'phase-local clipping must not repeatedly erase settled history',
289
+ ).toBeLessThan(0.03);
290
+ if (frame >= 536)
291
+ expect(
292
+ actual,
293
+ 'persistent unmarked color change must recover within one jitter cycle',
294
+ ).toBeLessThan(0.01);
295
+ }
296
+ if (frame >= 528 && !clippingCycle) {
297
+ if (reactive) {
298
+ expect(
299
+ [...result],
300
+ 'secondary motion must reject old radiance on a stationary receiver',
301
+ ).toEqual([0, 0, 0, 0x3c00]);
302
+ }
303
+ if (frame === 529) {
304
+ const half = result[0];
305
+ if (half === undefined) throw new Error('Missing post-motion color');
306
+ const actual = (1 + (half & 1023) / 1024) * 2 ** ((half >>> 10) - 15);
307
+ // A fresh white sample after reactive black must use fast 0.95
308
+ // feedback, not the previously settled 0.99 history weight.
309
+ expect(actual).toBeCloseTo(0.025 / 0.975, 4);
310
+ }
311
+ const expectedAge = Math.min(frame - 528, 128);
312
+ expect(
313
+ new Uint8Array(bytes)[512],
314
+ 'secondary motion restarts the complete settling cycle',
315
+ ).toBe(expectedAge);
316
+ }
317
+ const expectedMetadata = [...metadata];
318
+ if (reactive) expectedMetadata[3] = 0x3c00;
319
+ expect([...new Uint16Array(bytes, 256, 4)]).toEqual(expectedMetadata);
320
+ }
321
+ expect(ages).toEqual([0, 1, 2, 3, 4, 5, 6, 7, 8, 0, 0, 1, 0, 1, 0, 1]);
322
+ if (clippingCycle) {
323
+ expect(cycleTail).toHaveLength(64);
324
+ expect(
325
+ Math.max(...cycleTail) - Math.min(...cycleTail),
326
+ 'phase-local clipping must not repeatedly erase settled history',
327
+ ).toBeLessThan(0.03);
328
+ expect(cycleTail.reduce((a, b) => a + b, 0) / cycleTail.length).toBeCloseTo(7 / 9, 2);
329
+ return;
330
+ }
331
+ expect(errors).toHaveLength(64);
332
+ expect(Math.abs(errors.reduce((sum, error) => sum + error, 0) / errors.length)).toBeLessThan(
333
+ 0.0005,
334
+ );
335
+ expect(Math.max(...errors.map(Math.abs))).toBeLessThan(0.001);
336
+ } finally {
337
+ device.destroyBuffer(readback).unwrap();
338
+ for (const { texture } of current) device.destroyTexture(texture).unwrap();
339
+ retireTemporalGpuState(state);
340
+ }
341
+ }
@@ -1,6 +1,6 @@
1
1
  import type { RhiQueue } from '@forgeax/engine-rhi';
2
2
  import { RhiNullAdapter } from '@forgeax/engine-rhi-null';
3
- import { describe, expect, it } from 'vitest';
3
+ import { describe, expect, it, vi } from 'vitest';
4
4
  import { DeviceScope } from '../device/device-scope';
5
5
  import type { RenderFrameState } from '../record/frame-snapshot';
6
6
  import {
@@ -12,15 +12,57 @@ import {
12
12
  stageTemporalGpuSubmit,
13
13
  } from '../temporal/gpu';
14
14
  import { TemporalHistory } from '../temporal/history';
15
+ import { inspectTemporal } from '../temporal/inspection';
15
16
  import { createTemporalView } from '../temporal/view';
16
17
 
17
18
  describe('TAA history lifecycle', () => {
18
- it('allocates four full-size rgba16float histories only for TAA', () => {
19
+ it('keeps stability history separate from downstream temporal-v1 metadata', async () => {
20
+ const device = (await new RhiNullAdapter().requestDevice()).unwrap();
21
+ const textures = vi.spyOn(device, 'createTexture');
22
+ const scope = DeviceScope.create(22, 'taa-stability-test');
23
+ const state = getTemporalGpuState({} as RenderFrameState, device, scope, 8, 8);
24
+ try {
25
+ expect(textures.mock.calls.map(([desc]) => desc.format)).toEqual([
26
+ 'rgba16float',
27
+ 'rgba16float',
28
+ 'rgba16float',
29
+ 'rgba16float',
30
+ 'r8unorm',
31
+ 'r8unorm',
32
+ ]);
33
+ expect(state).toHaveProperty('stability');
34
+ const view = createTemporalView({ antialias: 'taa', width: 8, height: 8 });
35
+ const inspection = inspectTemporal(view, undefined, { active: state });
36
+ expect(inspection.historyBytes).toBe(34 * 8 * 8);
37
+ expect(inspection.resources.activeBytes).toBe(34 * 8 * 8);
38
+ } finally {
39
+ retireTemporalGpuState(state);
40
+ }
41
+ });
42
+ it('filters subpixel color reconstruction without filtering temporal metadata', async () => {
43
+ const device = (await new RhiNullAdapter().requestDevice()).unwrap();
44
+ const samplers = vi.spyOn(device, 'createSampler');
45
+ const layouts = vi.spyOn(device, 'createBindGroupLayout');
46
+ const state = getTemporalGpuState(
47
+ {} as RenderFrameState,
48
+ device,
49
+ DeviceScope.create(20, 'taa-test'),
50
+ 8,
51
+ 8,
52
+ );
53
+ getTemporalBindGroupResources(state);
54
+ expect(samplers.mock.calls.map(([desc]) => desc?.magFilter)).toEqual(['linear', 'nearest']);
55
+ const entries = layouts.mock.calls[0]?.[0].entries;
56
+ expect(entries?.find((entry) => entry.binding === 1)?.sampler?.type).toBe('filtering');
57
+ expect(entries?.find((entry) => entry.binding === 5)?.sampler?.type).toBe('non-filtering');
58
+ retireTemporalGpuState(state);
59
+ });
60
+ it('accounts for color, temporal, and private stability histories only for TAA', () => {
19
61
  const scope = DeviceScope.create(8, 'renderer');
20
62
  const taa = new TemporalHistory(scope, { width: 320, height: 200, mode: 'taa' });
21
63
  const off = new TemporalHistory(scope, { width: 320, height: 200, mode: 'off' });
22
- expect(taa.historyCount).toBe(4);
23
- expect(taa.historyBytes).toBe(32 * 320 * 200);
64
+ expect(taa.historyCount).toBe(6);
65
+ expect(taa.historyBytes).toBe(34 * 320 * 200);
24
66
  expect(taa.childScope?.parent).toBe(scope);
25
67
  expect(off.historyCount).toBe(0);
26
68
  expect(off.historyBytes).toBe(0);
@@ -70,10 +112,10 @@ describe('TAA history lifecycle', () => {
70
112
  frameState.activeTemporalGpuState = active;
71
113
  frameState.temporalGpuState = undefined;
72
114
  expect(active.childScope.parent).toBe(scope);
73
- expect(active.childScope.resourceDelta()).toBe(4);
115
+ expect(active.childScope.resourceDelta()).toBe(6);
74
116
  const bindGroupResources = getTemporalBindGroupResources(active);
75
117
  expect(bindGroupResources.sampler).not.toBeNull();
76
- expect(active.childScope.resourceDelta()).toBe(6);
118
+ expect(active.childScope.resourceDelta()).toBe(9);
77
119
  expect(getTemporalGpuState(frameState, device, scope, 64, 64)).toBe(active);
78
120
 
79
121
  const replacement = getTemporalGpuState(frameState, device, scope, 128, 64);
@@ -110,7 +152,7 @@ describe('TAA history lifecycle', () => {
110
152
  throw new Error('unexpected temporal retirement failure');
111
153
  });
112
154
  expect(state.childScope.state).toBe('retiring');
113
- expect(state.childScope.resourceDelta()).toBe(6);
155
+ expect(state.childScope.resourceDelta()).toBe(9);
114
156
  expect(retiring.has(state)).toBe(true);
115
157
  resolveFence();
116
158
  await fence;
@@ -1,5 +1,7 @@
1
1
  import { describe, expect, it } from 'vitest';
2
+ import { TEMPORAL_TAAU_DEPENDENCY_STATUS } from '../temporal/temporal-view';
2
3
  import { createTemporalView, HALTON_23_8, resolveTemporalReset } from '../temporal/view';
4
+ import { VOLUME_TAAU_DEPENDENCY } from '../volume/temporal';
3
5
 
4
6
  const base = () =>
5
7
  createTemporalView({
@@ -94,4 +96,11 @@ describe('TemporalView reset matrix', () => {
94
96
  expect(next.temporalFrameIndex).toBe(1);
95
97
  expect(next.jitter).toEqual(HALTON_23_8[1]);
96
98
  });
99
+
100
+ it('records the unreachable TAAU sibling as dependency-deferred', () => {
101
+ expect(TEMPORAL_TAAU_DEPENDENCY_STATUS).toBe('dependency-deferred');
102
+ expect(VOLUME_TAAU_DEPENDENCY.status).toBe('dependency-deferred');
103
+ expect(VOLUME_TAAU_DEPENDENCY.siblingFeature).toBe('feat-20260831-taau-dynamic-resolution');
104
+ expect(VOLUME_TAAU_DEPENDENCY.candidateShas).toHaveLength(2);
105
+ });
97
106
  });
@@ -58,3 +58,31 @@ describe('temporal successful-submit transaction', () => {
58
58
  expect(coordinator.historyStore.inspect().valid).toBe(false);
59
59
  });
60
60
  });
61
+
62
+ import { executeAutoExposureFrameTransaction } from '../assembly/renderer-frame-transaction';
63
+ import {
64
+ createAutoExposureState,
65
+ resetAutoExposureState,
66
+ } from '../pipeline/standard-output/auto-exposure/state';
67
+
68
+ describe('temporal and auto exposure transaction identity', () => {
69
+ it('keeps reset and device identity when submit aborts', () => {
70
+ const initial = createAutoExposureState({ fallback: 1, targetGeneration: 2, deviceEpoch: 5 });
71
+ if (!initial.ok) throw initial.error;
72
+ const reset = resetAutoExposureState(initial.value, 'device-lost', {
73
+ targetGeneration: 3,
74
+ deviceEpoch: 6,
75
+ });
76
+ const result = executeAutoExposureFrameTransaction(
77
+ reset,
78
+ { ev: 2, generation: 3, deviceEpoch: 6, frameId: 12 },
79
+ { failAt: 'submit' },
80
+ );
81
+
82
+ expect(result.ok).toBe(false);
83
+ expect(result.state).toBe(reset);
84
+ expect(result.state.reset).toEqual(['device-lost']);
85
+ expect(result.state.deviceEpoch).toBe(6);
86
+ expect(result.state.receipt.committed).toBe(false);
87
+ });
88
+ });
@@ -5,6 +5,7 @@ import {
5
5
  GPU_TEXTURE_USAGE_COPY_SRC,
6
6
  GPU_TEXTURE_USAGE_RENDER_ATTACHMENT,
7
7
  GPU_TEXTURE_USAGE_RENDER_ATTACHMENT_AND_TEXTURE_BINDING,
8
+ GPU_TEXTURE_USAGE_STORAGE_BINDING,
8
9
  GPU_TEXTURE_USAGE_TEXTURE_BINDING,
9
10
  } from '../gpu-texture-usage';
10
11
 
@@ -19,13 +20,14 @@ const consumerSources = [
19
20
  ];
20
21
 
21
22
  describe('texture usage owner', () => {
22
- it('keeps the four texture usage bits in one owner', () => {
23
+ it('keeps the five texture usage bits in one owner', () => {
23
24
  expect(GPU_TEXTURE_USAGE_COPY_SRC).toBe(0x01);
24
25
  expect(GPU_TEXTURE_USAGE_COPY_DST).toBe(0x02);
25
26
  expect(GPU_TEXTURE_USAGE_TEXTURE_BINDING).toBe(0x04);
27
+ expect(GPU_TEXTURE_USAGE_STORAGE_BINDING).toBe(0x08);
26
28
  expect(GPU_TEXTURE_USAGE_RENDER_ATTACHMENT).toBe(0x10);
27
29
  expect(GPU_TEXTURE_USAGE_RENDER_ATTACHMENT_AND_TEXTURE_BINDING).toBe(0x14);
28
- expect(ownerSource.match(/export const GPU_TEXTURE_USAGE_/g)).toHaveLength(5);
30
+ expect(ownerSource.match(/export const GPU_TEXTURE_USAGE_/g)).toHaveLength(6);
29
31
  });
30
32
 
31
33
  it('routes texture usage consumers through the owner', () => {