@forgeax/engine-render 0.1.7 → 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 (683) hide show
  1. package/README.md +140 -2
  2. package/dist/.tsbuildinfo +1 -1
  3. package/dist/assembly/backend-contract.d.ts +12 -0
  4. package/dist/assembly/backend-contract.d.ts.map +1 -1
  5. package/dist/assembly/factory.d.ts +12 -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/renderer-frame-transaction.d.ts +39 -0
  10. package/dist/assembly/renderer-frame-transaction.d.ts.map +1 -0
  11. package/dist/assembly/renderer-inspection.d.ts +22 -0
  12. package/dist/assembly/renderer-inspection.d.ts.map +1 -0
  13. package/dist/assembly/renderer-lifecycle.d.ts +4 -0
  14. package/dist/assembly/renderer-lifecycle.d.ts.map +1 -0
  15. package/dist/authoring.mjs +4 -2
  16. package/dist/authoring.mjs.map +1 -1
  17. package/dist/chunk-FJ6P52EE.mjs +46 -0
  18. package/dist/chunk-FJ6P52EE.mjs.map +1 -0
  19. package/dist/chunk-IPXCABEP.mjs +73 -0
  20. package/dist/chunk-IPXCABEP.mjs.map +1 -0
  21. package/dist/chunk-JDWARUOI.mjs +44 -0
  22. package/dist/chunk-JDWARUOI.mjs.map +1 -0
  23. package/dist/{chunk-YEJIUW7D.mjs → chunk-LOSO4CTV.mjs} +296 -547
  24. package/dist/chunk-LOSO4CTV.mjs.map +1 -0
  25. package/dist/chunk-PCHBPYML.mjs +385 -0
  26. package/dist/chunk-PCHBPYML.mjs.map +1 -0
  27. package/dist/chunk-RJRUS55L.mjs +9323 -0
  28. package/dist/chunk-RJRUS55L.mjs.map +1 -0
  29. package/dist/chunk-RXZ3RGOU.mjs +53 -0
  30. package/dist/chunk-RXZ3RGOU.mjs.map +1 -0
  31. package/dist/{chunk-CQXZC5XI.mjs → chunk-VFPLTKCU.mjs} +79 -69
  32. package/dist/chunk-VFPLTKCU.mjs.map +1 -0
  33. package/dist/chunk-YTQ5C7YQ.mjs +584 -0
  34. package/dist/chunk-YTQ5C7YQ.mjs.map +1 -0
  35. package/dist/components/atmosphere.d.ts +9 -0
  36. package/dist/components/atmosphere.d.ts.map +1 -0
  37. package/dist/components/camera.d.ts +2 -1
  38. package/dist/components/camera.d.ts.map +1 -1
  39. package/dist/components/fog.d.ts +8 -0
  40. package/dist/components/fog.d.ts.map +1 -0
  41. package/dist/components/index.d.ts +3 -0
  42. package/dist/components/index.d.ts.map +1 -1
  43. package/dist/components/motion-blur.d.ts +7 -0
  44. package/dist/components/motion-blur.d.ts.map +1 -0
  45. package/dist/construct-renderer.d.ts +2 -2
  46. package/dist/construct-renderer.d.ts.map +1 -1
  47. package/dist/construct-renderer.mjs +10914 -16392
  48. package/dist/construct-renderer.mjs.map +1 -1
  49. package/dist/device/device-scope.d.ts +4 -0
  50. package/dist/device/device-scope.d.ts.map +1 -1
  51. package/dist/environment/frame.d.ts +60 -0
  52. package/dist/environment/frame.d.ts.map +1 -0
  53. package/dist/environment/generation.d.ts +21 -0
  54. package/dist/environment/generation.d.ts.map +1 -0
  55. package/dist/environment/graph.d.ts +4 -0
  56. package/dist/environment/graph.d.ts.map +1 -0
  57. package/dist/environment/inspection.d.ts +48 -0
  58. package/dist/environment/inspection.d.ts.map +1 -0
  59. package/dist/environment/lifecycle.d.ts +39 -0
  60. package/dist/environment/lifecycle.d.ts.map +1 -0
  61. package/dist/environment/signature.d.ts +25 -0
  62. package/dist/environment/signature.d.ts.map +1 -0
  63. package/dist/errors/render.d.ts +136 -1
  64. package/dist/errors/render.d.ts.map +1 -1
  65. package/dist/extract/camera.d.ts +5 -0
  66. package/dist/extract/camera.d.ts.map +1 -0
  67. package/dist/extract/environment.d.ts +74 -0
  68. package/dist/extract/environment.d.ts.map +1 -0
  69. package/dist/extract/visibility.d.ts +1 -1
  70. package/dist/extract/visibility.d.ts.map +1 -1
  71. package/dist/features/host.d.ts +9 -2
  72. package/dist/features/host.d.ts.map +1 -1
  73. package/dist/features/motion-blur/motion-blur-feature.d.ts +16 -0
  74. package/dist/features/motion-blur/motion-blur-feature.d.ts.map +1 -0
  75. package/dist/features/motion-blur/motion-blur-params.d.ts +25 -0
  76. package/dist/features/motion-blur/motion-blur-params.d.ts.map +1 -0
  77. package/dist/features/plan.d.ts +17 -2
  78. package/dist/features/plan.d.ts.map +1 -1
  79. package/dist/features/prepared-gpu-work.d.ts +3 -1
  80. package/dist/features/prepared-gpu-work.d.ts.map +1 -1
  81. package/dist/features/prepared-graphics.d.ts +2 -1
  82. package/dist/features/prepared-graphics.d.ts.map +1 -1
  83. package/dist/features/render-graph-raster.d.ts +2 -1
  84. package/dist/features/render-graph-raster.d.ts.map +1 -1
  85. package/dist/features/targets.d.ts +3 -0
  86. package/dist/features/targets.d.ts.map +1 -1
  87. package/dist/features/types.d.ts +12 -0
  88. package/dist/features/types.d.ts.map +1 -1
  89. package/dist/fullscreen-post-process-pass.d.ts +7 -1
  90. package/dist/fullscreen-post-process-pass.d.ts.map +1 -1
  91. package/dist/gpu-scene.d.ts +2 -0
  92. package/dist/gpu-scene.d.ts.map +1 -1
  93. package/dist/ibl/skylight-bind-group.d.ts +5 -6
  94. package/dist/ibl/skylight-bind-group.d.ts.map +1 -1
  95. package/dist/index.d.ts +17 -6
  96. package/dist/index.d.ts.map +1 -1
  97. package/dist/index.mjs +6 -4
  98. package/dist/index.mjs.map +1 -1
  99. package/dist/inspection-types.d.ts +43 -1
  100. package/dist/inspection-types.d.ts.map +1 -1
  101. package/dist/internal.d.ts +2 -0
  102. package/dist/internal.d.ts.map +1 -1
  103. package/dist/internal.mjs +2 -0
  104. package/dist/materials.d.ts +22 -0
  105. package/dist/materials.d.ts.map +1 -1
  106. package/dist/pbr-pipeline.d.ts +10 -6
  107. package/dist/pbr-pipeline.d.ts.map +1 -1
  108. package/dist/pipeline/standard-forward-lane.d.ts.map +1 -1
  109. package/dist/pipeline/standard-pipeline.d.ts +3 -0
  110. package/dist/pipeline/standard-pipeline.d.ts.map +1 -1
  111. package/dist/pipeline/standard-post.d.ts +48 -0
  112. package/dist/pipeline/standard-post.d.ts.map +1 -0
  113. package/dist/pipeline/standard-profile.d.ts +3 -6
  114. package/dist/pipeline/standard-profile.d.ts.map +1 -1
  115. package/dist/pipeline-builder.d.ts +18 -0
  116. package/dist/pipeline-builder.d.ts.map +1 -1
  117. package/dist/pipeline-spec.d.ts.map +1 -1
  118. package/dist/plugin.d.ts.map +1 -1
  119. package/dist/record/frame-snapshot.d.ts +100 -5
  120. package/dist/record/frame-snapshot.d.ts.map +1 -1
  121. package/dist/record/frame-targets.d.ts.map +1 -1
  122. package/dist/record/frame.d.ts +4 -2
  123. package/dist/record/frame.d.ts.map +1 -1
  124. package/dist/record/main-pass-geometry.d.ts +11 -0
  125. package/dist/record/main-pass-geometry.d.ts.map +1 -1
  126. package/dist/record/main-pass-material.d.ts +8 -5
  127. package/dist/record/main-pass-material.d.ts.map +1 -1
  128. package/dist/record/main-pass-sprite-draws.d.ts +8 -1
  129. package/dist/record/main-pass-sprite-draws.d.ts.map +1 -1
  130. package/dist/record/main-pass.d.ts +2 -0
  131. package/dist/record/main-pass.d.ts.map +1 -1
  132. package/dist/record/mesh-ssbo.d.ts.map +1 -1
  133. package/dist/record/render-context.d.ts +76 -18
  134. package/dist/record/render-context.d.ts.map +1 -1
  135. package/dist/record/shadow-pass.d.ts.map +1 -1
  136. package/dist/record/skybox-post-pass.d.ts +1 -11
  137. package/dist/record/skybox-post-pass.d.ts.map +1 -1
  138. package/dist/record/typed-frame-graph.d.ts +26 -2
  139. package/dist/record/typed-frame-graph.d.ts.map +1 -1
  140. package/dist/record/view-ubo.d.ts +4 -1
  141. package/dist/record/view-ubo.d.ts.map +1 -1
  142. package/dist/render-contract.d.ts +92 -8
  143. package/dist/render-contract.d.ts.map +1 -1
  144. package/dist/render-graph-primitives.d.ts.map +1 -1
  145. package/dist/render-pipeline.d.ts +50 -6
  146. package/dist/render-pipeline.d.ts.map +1 -1
  147. package/dist/render-system-extract.d.ts +29 -5
  148. package/dist/render-system-extract.d.ts.map +1 -1
  149. package/dist/render-system.d.ts +23 -4
  150. package/dist/render-system.d.ts.map +1 -1
  151. package/dist/scene/render-scene.d.ts +36 -2
  152. package/dist/scene/render-scene.d.ts.map +1 -1
  153. package/dist/temporal/coverage.d.ts +42 -0
  154. package/dist/temporal/coverage.d.ts.map +1 -0
  155. package/dist/temporal/frame-coordinator.d.ts +99 -0
  156. package/dist/temporal/frame-coordinator.d.ts.map +1 -0
  157. package/dist/temporal/gpu.d.ts +39 -0
  158. package/dist/temporal/gpu.d.ts.map +1 -0
  159. package/dist/temporal/history.d.ts +37 -0
  160. package/dist/temporal/history.d.ts.map +1 -0
  161. package/dist/temporal/index.d.ts +7 -0
  162. package/dist/temporal/index.d.ts.map +1 -0
  163. package/dist/temporal/index.mjs +8 -0
  164. package/dist/temporal/index.mjs.map +1 -0
  165. package/dist/temporal/inspection.d.ts +36 -0
  166. package/dist/temporal/inspection.d.ts.map +1 -0
  167. package/dist/temporal/scene-data-catalog.d.ts +48 -0
  168. package/dist/temporal/scene-data-catalog.d.ts.map +1 -0
  169. package/dist/temporal/scene-data.d.ts +43 -0
  170. package/dist/temporal/scene-data.d.ts.map +1 -0
  171. package/dist/temporal/standard-scene-data.d.ts +61 -0
  172. package/dist/temporal/standard-scene-data.d.ts.map +1 -0
  173. package/dist/temporal/taa-history-resources.d.ts +22 -0
  174. package/dist/temporal/taa-history-resources.d.ts.map +1 -0
  175. package/dist/temporal/taa-history-store.d.ts +27 -0
  176. package/dist/temporal/taa-history-store.d.ts.map +1 -0
  177. package/dist/temporal/taa-resolve.d.ts +15 -0
  178. package/dist/temporal/taa-resolve.d.ts.map +1 -0
  179. package/dist/temporal/temporal-view.d.ts +40 -0
  180. package/dist/temporal/temporal-view.d.ts.map +1 -0
  181. package/dist/temporal/transaction.d.ts +9 -0
  182. package/dist/temporal/transaction.d.ts.map +1 -0
  183. package/dist/temporal/view.d.ts +56 -0
  184. package/dist/temporal/view.d.ts.map +1 -0
  185. package/dist/transmission/backdrop.d.ts +147 -0
  186. package/dist/transmission/backdrop.d.ts.map +1 -0
  187. package/dist/transmission/inspection.d.ts +57 -0
  188. package/dist/transmission/inspection.d.ts.map +1 -0
  189. package/dist/transmission/oracle.d.ts +42 -0
  190. package/dist/transmission/oracle.d.ts.map +1 -0
  191. package/dist/transmission/projection.d.ts +37 -0
  192. package/dist/transmission/projection.d.ts.map +1 -0
  193. package/dist/typed-render-graph-primitives.d.ts +25 -2
  194. package/dist/typed-render-graph-primitives.d.ts.map +1 -1
  195. package/package.json +24 -19
  196. package/src/__tests__/ai-user-cold-start.integration.test.ts +59 -0
  197. package/src/__tests__/ai-user-public-surface.test-d.ts +45 -0
  198. package/src/__tests__/bloom-exact-zero.unit.test.ts +202 -0
  199. package/src/__tests__/bloom-lifecycle.integration.test.ts +125 -0
  200. package/src/__tests__/construct-renderer-identity.unit.test.ts +4 -3
  201. package/src/__tests__/detached-inspection.integration.test.ts +177 -0
  202. package/src/__tests__/environment-fog-lanes.integration.test.ts +219 -0
  203. package/src/__tests__/environment-generation.integration.test.ts +141 -0
  204. package/src/__tests__/environment-selection.unit.test.ts +245 -0
  205. package/src/__tests__/factory-contract.integration.test.ts +1380 -9
  206. package/src/__tests__/frame-plan-contract.unit.test.ts +90 -0
  207. package/src/__tests__/fullscreen-feature-plan.unit.test.ts +7 -0
  208. package/src/__tests__/gpu-driven-production.integration.test.ts +74 -22
  209. package/src/__tests__/gpu-driven-view-graph.integration.test.ts +37 -0
  210. package/src/__tests__/gpu-scene.unit.test.ts +10 -0
  211. package/src/__tests__/injection-kind-owner.test-d.ts +2 -1
  212. package/src/__tests__/material-contract-inventory.unit.test.ts +62 -0
  213. package/src/__tests__/material-cooked-projection.unit.test.ts +18 -146
  214. package/src/__tests__/materials-transmission-validation.unit.test.ts +36 -0
  215. package/src/__tests__/morph-feature-plan.unit.test.ts +7 -0
  216. package/src/__tests__/motion-blur.pixel.integration.test.ts +121 -0
  217. package/src/__tests__/public-surface.test-d.ts +15 -1
  218. package/src/__tests__/render-error-code-owner.test-d.ts +9 -0
  219. package/src/__tests__/render-error-detail-ssot.test-d.ts +11 -2
  220. package/src/__tests__/render-error-exhaustive.test-d.ts +3 -0
  221. package/src/__tests__/render-feature-errors.unit.test.ts +33 -3
  222. package/src/__tests__/render-feature-gpu-work.integration.test.ts +44 -0
  223. package/src/__tests__/render-feature-plan.test-d.ts +22 -89
  224. package/src/__tests__/render-scene-projection.unit.test.ts +28 -0
  225. package/src/__tests__/render-temporal-environment-consumer.browser.test.ts +26 -0
  226. package/src/__tests__/render-temporal-environment-consumer.dawn.test.ts +21 -0
  227. package/src/__tests__/renderer-factory-material-contract.unit.test.ts +395 -1
  228. package/src/__tests__/renderer-frame-transaction.integration.test.ts +405 -0
  229. package/src/__tests__/renderer-lifecycle.integration.test.ts +22 -0
  230. package/src/__tests__/scene-data-catalog.unit.test.ts +59 -0
  231. package/src/__tests__/scene-data-consumer.integration.test.ts +67 -0
  232. package/src/__tests__/scene-data-contract.test-d.ts +35 -0
  233. package/src/__tests__/scene-data-inspection.unit.test.ts +41 -0
  234. package/src/__tests__/scene-data-public-surface.test-d.ts +34 -0
  235. package/src/__tests__/shader-manifest-fixture.ts +111 -0
  236. package/src/__tests__/skinned-shadow-caster.test.ts +102 -0
  237. package/src/__tests__/standard-clustered-pipeline.unit.test.ts +24 -3
  238. package/src/__tests__/standard-pipeline.dawn.test.ts +15 -0
  239. package/src/__tests__/standard-pipeline.integration.test.ts +543 -1
  240. package/src/__tests__/standard-profile-oracle.unit.test.ts +10 -2
  241. package/src/__tests__/standard-temporal-producer.integration.test.ts +35 -0
  242. package/src/__tests__/surface-configuration.unit.test.ts +211 -12
  243. package/src/__tests__/taa-transaction.integration.test.ts +30 -0
  244. package/src/__tests__/temporal-admission.integration.test.ts +40 -0
  245. package/src/__tests__/temporal-coverage.unit.test.ts +35 -0
  246. package/src/__tests__/temporal-demand.unit.test.ts +44 -0
  247. package/src/__tests__/temporal-frame-coordinator.unit.test.ts +64 -0
  248. package/src/__tests__/temporal-graph-topology.unit.test.ts +51 -0
  249. package/src/__tests__/temporal-history-lifecycle.unit.test.ts +170 -0
  250. package/src/__tests__/temporal-performance.integration.test.ts +615 -0
  251. package/src/__tests__/temporal-reset-matrix.unit.test.ts +97 -0
  252. package/src/__tests__/temporal-transaction.integration.test.ts +60 -0
  253. package/src/__tests__/temporal-view.unit.test.ts +152 -0
  254. package/src/__tests__/transmission-prewarm.unit.test.ts +93 -0
  255. package/src/__tests__/typed-pipeline-topology.unit.test.ts +230 -1
  256. package/src/__tests__/urp-pipeline-targets.unit.test.ts +25 -1
  257. package/src/__tests__/urp-pipeline.unit.test.ts +4 -3
  258. package/src/__tests__/visibility-extract.integration.test.ts +27 -1
  259. package/src/__tests__/visibility-producer-matrix.integration.test.ts +10 -0
  260. package/src/assembly/backend-contract.ts +47 -1
  261. package/src/assembly/factory.ts +1224 -505
  262. package/src/assembly/host-contract.ts +4 -0
  263. package/src/assembly/renderer-frame-transaction.ts +75 -0
  264. package/src/assembly/renderer-inspection.ts +112 -0
  265. package/src/assembly/renderer-lifecycle.ts +6 -0
  266. package/src/components/__tests__/motion-blur.unit.test.ts +14 -0
  267. package/src/components/__tests__/schema-contract.unit.test.ts +6 -1
  268. package/src/components/atmosphere.ts +10 -0
  269. package/src/components/camera.ts +2 -1
  270. package/src/components/fog.ts +9 -0
  271. package/src/components/index.ts +3 -0
  272. package/src/components/motion-blur.ts +8 -0
  273. package/src/construct-renderer.ts +40 -3
  274. package/src/device/device-scope.ts +15 -1
  275. package/src/environment/frame.ts +185 -0
  276. package/src/environment/generation.ts +23 -0
  277. package/src/environment/graph.ts +9 -0
  278. package/src/environment/inspection.ts +87 -0
  279. package/src/environment/lifecycle.ts +250 -0
  280. package/src/environment/signature.ts +55 -0
  281. package/src/errors/render.ts +285 -0
  282. package/src/extract/camera.ts +78 -0
  283. package/src/extract/environment.ts +171 -0
  284. package/src/extract/visibility.ts +38 -19
  285. package/src/features/host.ts +36 -5
  286. package/src/features/motion-blur/__tests__/motion-blur-feature.unit.test.ts +67 -0
  287. package/src/features/motion-blur/__tests__/motion-blur-params.unit.test.ts +53 -0
  288. package/src/features/motion-blur/motion-blur-feature.ts +119 -0
  289. package/src/features/motion-blur/motion-blur-params.ts +89 -0
  290. package/src/features/plan.ts +32 -3
  291. package/src/features/prepared-gpu-work.ts +21 -6
  292. package/src/features/prepared-graphics.ts +2 -1
  293. package/src/features/render-graph-raster.ts +2 -1
  294. package/src/features/targets.ts +24 -2
  295. package/src/features/types.ts +13 -0
  296. package/src/fullscreen-post-process-pass.ts +34 -4
  297. package/src/gpu-scene.ts +24 -0
  298. package/src/ibl/skylight-bind-group.ts +30 -38
  299. package/src/index.ts +66 -6
  300. package/src/inspection-types.ts +48 -0
  301. package/src/internal.ts +5 -0
  302. package/src/materials.ts +119 -24
  303. package/src/pbr-pipeline.ts +58 -19
  304. package/src/pipeline/standard-forward-lane.ts +158 -101
  305. package/src/pipeline/standard-pipeline.ts +156 -105
  306. package/src/pipeline/standard-post.ts +373 -0
  307. package/src/pipeline/standard-profile.ts +11 -11
  308. package/src/pipeline-builder.ts +102 -12
  309. package/src/pipeline-spec.ts +9 -0
  310. package/src/plugin.ts +2 -0
  311. package/src/record/__tests__/fullscreen-temporal-routing.unit.test.ts +25 -0
  312. package/src/record/__tests__/main-pass-geometry.unit.test.ts +47 -0
  313. package/src/record/__tests__/material-bg-cache.unit.test.ts +12 -1
  314. package/src/record/__tests__/material-pipeline-pending-cache.unit.test.ts +22 -0
  315. package/src/record/__tests__/sprite-material-abi.unit.test.ts +75 -0
  316. package/src/record/__tests__/standard-pbr-ubo-layout.unit.test.ts +67 -0
  317. package/src/record/__tests__/temporal-payload.unit.test.ts +164 -0
  318. package/src/record/__tests__/typed-frame-graph-plan.unit.test.ts +127 -0
  319. package/src/record/frame-snapshot.ts +129 -5
  320. package/src/record/frame-targets.ts +15 -6
  321. package/src/record/frame.ts +107 -3
  322. package/src/record/main-pass-geometry.ts +86 -40
  323. package/src/record/main-pass-material.ts +114 -66
  324. package/src/record/main-pass-sprite-draws.ts +78 -101
  325. package/src/record/main-pass.ts +77 -4
  326. package/src/record/mesh-ssbo.ts +22 -3
  327. package/src/record/render-context.ts +189 -23
  328. package/src/record/shadow-pass.ts +113 -23
  329. package/src/record/skybox-post-pass.ts +97 -41
  330. package/src/record/typed-frame-graph.ts +565 -26
  331. package/src/record/view-ubo.ts +52 -4
  332. package/src/render-contract.ts +109 -6
  333. package/src/render-graph-primitives.ts +18 -1
  334. package/src/render-pipeline.ts +100 -27
  335. package/src/render-system-extract.ts +193 -69
  336. package/src/render-system.ts +482 -41
  337. package/src/scene/render-scene.ts +250 -7
  338. package/src/temporal/__tests__/taa-history-resources.unit.test.ts +45 -0
  339. package/src/temporal/coverage.ts +76 -0
  340. package/src/temporal/frame-coordinator.ts +311 -0
  341. package/src/temporal/gpu.ts +287 -0
  342. package/src/temporal/history.ts +92 -0
  343. package/src/temporal/index.ts +6 -0
  344. package/src/temporal/inspection.ts +97 -0
  345. package/src/temporal/scene-data-catalog.ts +200 -0
  346. package/src/temporal/scene-data.ts +149 -0
  347. package/src/temporal/standard-scene-data.ts +182 -0
  348. package/src/temporal/taa-history-resources.ts +128 -0
  349. package/src/temporal/taa-history-store.ts +79 -0
  350. package/src/temporal/taa-resolve.ts +34 -0
  351. package/src/temporal/temporal-view.ts +169 -0
  352. package/src/temporal/transaction.ts +17 -0
  353. package/src/temporal/view.ts +161 -0
  354. package/src/transmission/__tests__/capability.unit.test.ts +83 -0
  355. package/src/transmission/__tests__/composition.integration.test.ts +161 -0
  356. package/src/transmission/__tests__/inspection.unit.test.ts +241 -0
  357. package/src/transmission/__tests__/lifecycle.integration.test.ts +96 -0
  358. package/src/transmission/__tests__/oracle.unit.test.ts +131 -0
  359. package/src/transmission/__tests__/projection.unit.test.ts +71 -0
  360. package/src/transmission/__tests__/standard-transmission.dawn.test.ts +438 -0
  361. package/src/transmission/__tests__/transmission-backdrop-topology.unit.test.ts +109 -0
  362. package/src/transmission/__tests__/transmission-backdrop.dawn.test.ts +105 -0
  363. package/src/transmission/backdrop.ts +572 -0
  364. package/src/transmission/inspection.ts +190 -0
  365. package/src/transmission/oracle.ts +141 -0
  366. package/src/transmission/projection.ts +83 -0
  367. package/src/typed-render-graph-primitives.ts +162 -9
  368. package/dist/__tests__/authoring-path.unit.test.d.ts +0 -2
  369. package/dist/__tests__/authoring-path.unit.test.d.ts.map +0 -1
  370. package/dist/__tests__/backend-selection-rhi-capture.test-d.d.ts +0 -2
  371. package/dist/__tests__/backend-selection-rhi-capture.test-d.d.ts.map +0 -1
  372. package/dist/__tests__/callback-inference.test-d.d.ts +0 -2
  373. package/dist/__tests__/callback-inference.test-d.d.ts.map +0 -1
  374. package/dist/__tests__/cluster-binner.test.d.ts +0 -2
  375. package/dist/__tests__/cluster-binner.test.d.ts.map +0 -1
  376. package/dist/__tests__/cluster-grid-default-surface.unit.test.d.ts +0 -2
  377. package/dist/__tests__/cluster-grid-default-surface.unit.test.d.ts.map +0 -1
  378. package/dist/__tests__/construct-renderer-identity.unit.test.d.ts +0 -2
  379. package/dist/__tests__/construct-renderer-identity.unit.test.d.ts.map +0 -1
  380. package/dist/__tests__/device-scope-lifecycle.unit.test.d.ts +0 -2
  381. package/dist/__tests__/device-scope-lifecycle.unit.test.d.ts.map +0 -1
  382. package/dist/__tests__/device-scope-stale-matrix.unit.test.d.ts +0 -2
  383. package/dist/__tests__/device-scope-stale-matrix.unit.test.d.ts.map +0 -1
  384. package/dist/__tests__/direct-extract-consumer-contract.test-d.d.ts +0 -2
  385. package/dist/__tests__/direct-extract-consumer-contract.test-d.d.ts.map +0 -1
  386. package/dist/__tests__/direct-light-snapshot.unit.test.d.ts +0 -2
  387. package/dist/__tests__/direct-light-snapshot.unit.test.d.ts.map +0 -1
  388. package/dist/__tests__/factory-contract.integration.test.d.ts +0 -2
  389. package/dist/__tests__/factory-contract.integration.test.d.ts.map +0 -1
  390. package/dist/__tests__/fallback-row-stride-surface.unit.test.d.ts +0 -2
  391. package/dist/__tests__/fallback-row-stride-surface.unit.test.d.ts.map +0 -1
  392. package/dist/__tests__/frame-observation.contract.test.d.ts +0 -2
  393. package/dist/__tests__/frame-observation.contract.test.d.ts.map +0 -1
  394. package/dist/__tests__/fullscreen-feature-plan.unit.test.d.ts +0 -2
  395. package/dist/__tests__/fullscreen-feature-plan.unit.test.d.ts.map +0 -1
  396. package/dist/__tests__/glyph-text-layout-recovery.unit.test.d.ts +0 -2
  397. package/dist/__tests__/glyph-text-layout-recovery.unit.test.d.ts.map +0 -1
  398. package/dist/__tests__/gpu-driven-indirect-raster-evidence.d.ts +0 -6
  399. package/dist/__tests__/gpu-driven-indirect-raster-evidence.d.ts.map +0 -1
  400. package/dist/__tests__/gpu-driven-indirect-raster.browser.test.d.ts +0 -2
  401. package/dist/__tests__/gpu-driven-indirect-raster.browser.test.d.ts.map +0 -1
  402. package/dist/__tests__/gpu-driven-indirect-raster.dawn.test.d.ts +0 -2
  403. package/dist/__tests__/gpu-driven-indirect-raster.dawn.test.d.ts.map +0 -1
  404. package/dist/__tests__/gpu-driven-production.integration.test.d.ts +0 -2
  405. package/dist/__tests__/gpu-driven-production.integration.test.d.ts.map +0 -1
  406. package/dist/__tests__/gpu-driven-scaling.unit.test.d.ts +0 -2
  407. package/dist/__tests__/gpu-driven-scaling.unit.test.d.ts.map +0 -1
  408. package/dist/__tests__/gpu-driven-view-gpu-evidence.d.ts +0 -18
  409. package/dist/__tests__/gpu-driven-view-gpu-evidence.d.ts.map +0 -1
  410. package/dist/__tests__/gpu-driven-view-graph.integration.test.d.ts +0 -2
  411. package/dist/__tests__/gpu-driven-view-graph.integration.test.d.ts.map +0 -1
  412. package/dist/__tests__/gpu-driven-view-reference.d.ts +0 -15
  413. package/dist/__tests__/gpu-driven-view-reference.d.ts.map +0 -1
  414. package/dist/__tests__/gpu-driven-view.browser.test.d.ts +0 -2
  415. package/dist/__tests__/gpu-driven-view.browser.test.d.ts.map +0 -1
  416. package/dist/__tests__/gpu-driven-view.dawn.test.d.ts +0 -2
  417. package/dist/__tests__/gpu-driven-view.dawn.test.d.ts.map +0 -1
  418. package/dist/__tests__/gpu-driven-view.unit.test.d.ts +0 -2
  419. package/dist/__tests__/gpu-driven-view.unit.test.d.ts.map +0 -1
  420. package/dist/__tests__/gpu-resource-store-stride.unit.test.d.ts +0 -2
  421. package/dist/__tests__/gpu-resource-store-stride.unit.test.d.ts.map +0 -1
  422. package/dist/__tests__/gpu-scene-render-graph-gpu.d.ts +0 -7
  423. package/dist/__tests__/gpu-scene-render-graph-gpu.d.ts.map +0 -1
  424. package/dist/__tests__/gpu-scene-render-graph.browser.test.d.ts +0 -2
  425. package/dist/__tests__/gpu-scene-render-graph.browser.test.d.ts.map +0 -1
  426. package/dist/__tests__/gpu-scene-render-graph.dawn.test.d.ts +0 -2
  427. package/dist/__tests__/gpu-scene-render-graph.dawn.test.d.ts.map +0 -1
  428. package/dist/__tests__/gpu-scene-schema.unit.test.d.ts +0 -2
  429. package/dist/__tests__/gpu-scene-schema.unit.test.d.ts.map +0 -1
  430. package/dist/__tests__/gpu-scene.dawn.test.d.ts +0 -2
  431. package/dist/__tests__/gpu-scene.dawn.test.d.ts.map +0 -1
  432. package/dist/__tests__/gpu-scene.unit.test.d.ts +0 -2
  433. package/dist/__tests__/gpu-scene.unit.test.d.ts.map +0 -1
  434. package/dist/__tests__/ibl/face-uniforms.unit.test.d.ts +0 -2
  435. package/dist/__tests__/ibl/face-uniforms.unit.test.d.ts.map +0 -1
  436. package/dist/__tests__/infinite-grid-no-vertex-probe.unit.test.d.ts +0 -2
  437. package/dist/__tests__/infinite-grid-no-vertex-probe.unit.test.d.ts.map +0 -1
  438. package/dist/__tests__/injection-kind-owner.test-d.d.ts +0 -2
  439. package/dist/__tests__/injection-kind-owner.test-d.d.ts.map +0 -1
  440. package/dist/__tests__/ktx2-basis-gpu-consumer.dawn.test.d.ts +0 -2
  441. package/dist/__tests__/ktx2-basis-gpu-consumer.dawn.test.d.ts.map +0 -1
  442. package/dist/__tests__/light-buffer-layout.unit.test.d.ts +0 -2
  443. package/dist/__tests__/light-buffer-layout.unit.test.d.ts.map +0 -1
  444. package/dist/__tests__/material-contract-inventory.unit.test.d.ts +0 -2
  445. package/dist/__tests__/material-contract-inventory.unit.test.d.ts.map +0 -1
  446. package/dist/__tests__/material-cooked-projection.unit.test.d.ts +0 -2
  447. package/dist/__tests__/material-cooked-projection.unit.test.d.ts.map +0 -1
  448. package/dist/__tests__/material-snapshot-mutation.integration.test.d.ts +0 -2
  449. package/dist/__tests__/material-snapshot-mutation.integration.test.d.ts.map +0 -1
  450. package/dist/__tests__/material-static-dynamic-route.unit.test.d.ts +0 -2
  451. package/dist/__tests__/material-static-dynamic-route.unit.test.d.ts.map +0 -1
  452. package/dist/__tests__/material-stride-surface.unit.test.d.ts +0 -2
  453. package/dist/__tests__/material-stride-surface.unit.test.d.ts.map +0 -1
  454. package/dist/__tests__/mesh-buffer-usage-surface.unit.test.d.ts +0 -2
  455. package/dist/__tests__/mesh-buffer-usage-surface.unit.test.d.ts.map +0 -1
  456. package/dist/__tests__/mesh-material-bindings.unit.test.d.ts +0 -2
  457. package/dist/__tests__/mesh-material-bindings.unit.test.d.ts.map +0 -1
  458. package/dist/__tests__/mesh-stride-surface.unit.test.d.ts +0 -2
  459. package/dist/__tests__/mesh-stride-surface.unit.test.d.ts.map +0 -1
  460. package/dist/__tests__/morph-culling-reentry.dawn.test.d.ts +0 -2
  461. package/dist/__tests__/morph-culling-reentry.dawn.test.d.ts.map +0 -1
  462. package/dist/__tests__/morph-feature-gpu-work.integration.test.d.ts +0 -2
  463. package/dist/__tests__/morph-feature-gpu-work.integration.test.d.ts.map +0 -1
  464. package/dist/__tests__/morph-feature-plan.unit.test.d.ts +0 -2
  465. package/dist/__tests__/morph-feature-plan.unit.test.d.ts.map +0 -1
  466. package/dist/__tests__/morph-visual-evidence.integration.test.d.ts +0 -2
  467. package/dist/__tests__/morph-visual-evidence.integration.test.d.ts.map +0 -1
  468. package/dist/__tests__/nineslice-handle-surface.unit.test.d.ts +0 -2
  469. package/dist/__tests__/nineslice-handle-surface.unit.test.d.ts.map +0 -1
  470. package/dist/__tests__/post-process-error-policy-owner.unit.test.d.ts +0 -2
  471. package/dist/__tests__/post-process-error-policy-owner.unit.test.d.ts.map +0 -1
  472. package/dist/__tests__/prepared-buffer-kind-owner.test-d.d.ts +0 -2
  473. package/dist/__tests__/prepared-buffer-kind-owner.test-d.d.ts.map +0 -1
  474. package/dist/__tests__/prepared-graphics-capability.unit.test.d.ts +0 -2
  475. package/dist/__tests__/prepared-graphics-capability.unit.test.d.ts.map +0 -1
  476. package/dist/__tests__/prepared-graphics-generation.unit.test.d.ts +0 -2
  477. package/dist/__tests__/prepared-graphics-generation.unit.test.d.ts.map +0 -1
  478. package/dist/__tests__/prepared-graphics-lifecycle.unit.test.d.ts +0 -2
  479. package/dist/__tests__/prepared-graphics-lifecycle.unit.test.d.ts.map +0 -1
  480. package/dist/__tests__/prepared-graphics-pipeline-warmup.unit.test.d.ts +0 -2
  481. package/dist/__tests__/prepared-graphics-pipeline-warmup.unit.test.d.ts.map +0 -1
  482. package/dist/__tests__/prepared-graphics-resolver.unit.test.d.ts +0 -2
  483. package/dist/__tests__/prepared-graphics-resolver.unit.test.d.ts.map +0 -1
  484. package/dist/__tests__/prepared-graphics-snapshot.unit.test.d.ts +0 -2
  485. package/dist/__tests__/prepared-graphics-snapshot.unit.test.d.ts.map +0 -1
  486. package/dist/__tests__/prepared-graphics-store.unit.test.d.ts +0 -2
  487. package/dist/__tests__/prepared-graphics-store.unit.test.d.ts.map +0 -1
  488. package/dist/__tests__/prepared-graphics-validation.unit.test.d.ts +0 -2
  489. package/dist/__tests__/prepared-graphics-validation.unit.test.d.ts.map +0 -1
  490. package/dist/__tests__/profiler-default-off.test.d.ts +0 -2
  491. package/dist/__tests__/profiler-default-off.test.d.ts.map +0 -1
  492. package/dist/__tests__/profiler-phase-catalog.test.d.ts +0 -2
  493. package/dist/__tests__/profiler-phase-catalog.test.d.ts.map +0 -1
  494. package/dist/__tests__/profiler-phase-integration.test.d.ts +0 -2
  495. package/dist/__tests__/profiler-phase-integration.test.d.ts.map +0 -1
  496. package/dist/__tests__/profiler-phase-token.test.d.ts +0 -2
  497. package/dist/__tests__/profiler-phase-token.test.d.ts.map +0 -1
  498. package/dist/__tests__/public-surface.test-d.d.ts +0 -2
  499. package/dist/__tests__/public-surface.test-d.d.ts.map +0 -1
  500. package/dist/__tests__/recover-error-policy-owner.unit.test.d.ts +0 -2
  501. package/dist/__tests__/recover-error-policy-owner.unit.test.d.ts.map +0 -1
  502. package/dist/__tests__/render-error-code-owner.test-d.d.ts +0 -2
  503. package/dist/__tests__/render-error-code-owner.test-d.d.ts.map +0 -1
  504. package/dist/__tests__/render-error-detail-ssot.test-d.d.ts +0 -2
  505. package/dist/__tests__/render-error-detail-ssot.test-d.d.ts.map +0 -1
  506. package/dist/__tests__/render-error-exhaustive.test-d.d.ts +0 -2
  507. package/dist/__tests__/render-error-exhaustive.test-d.d.ts.map +0 -1
  508. package/dist/__tests__/render-feature-assembly.test-d.d.ts +0 -2
  509. package/dist/__tests__/render-feature-assembly.test-d.d.ts.map +0 -1
  510. package/dist/__tests__/render-feature-context.test-d.d.ts +0 -2
  511. package/dist/__tests__/render-feature-context.test-d.d.ts.map +0 -1
  512. package/dist/__tests__/render-feature-contract.test-d.d.ts +0 -2
  513. package/dist/__tests__/render-feature-contract.test-d.d.ts.map +0 -1
  514. package/dist/__tests__/render-feature-diagnostics.unit.test.d.ts +0 -2
  515. package/dist/__tests__/render-feature-diagnostics.unit.test.d.ts.map +0 -1
  516. package/dist/__tests__/render-feature-docs.unit.test.d.ts +0 -2
  517. package/dist/__tests__/render-feature-docs.unit.test.d.ts.map +0 -1
  518. package/dist/__tests__/render-feature-errors.unit.test.d.ts +0 -2
  519. package/dist/__tests__/render-feature-errors.unit.test.d.ts.map +0 -1
  520. package/dist/__tests__/render-feature-gpu-work.integration.test.d.ts +0 -2
  521. package/dist/__tests__/render-feature-gpu-work.integration.test.d.ts.map +0 -1
  522. package/dist/__tests__/render-feature-plan.test-d.d.ts +0 -2
  523. package/dist/__tests__/render-feature-plan.test-d.d.ts.map +0 -1
  524. package/dist/__tests__/render-feature-plan.unit.test.d.ts +0 -2
  525. package/dist/__tests__/render-feature-plan.unit.test.d.ts.map +0 -1
  526. package/dist/__tests__/render-feature-prepared-diagnostics.unit.test.d.ts +0 -2
  527. package/dist/__tests__/render-feature-prepared-diagnostics.unit.test.d.ts.map +0 -1
  528. package/dist/__tests__/render-feature-prepared-errors.test-d.d.ts +0 -2
  529. package/dist/__tests__/render-feature-prepared-errors.test-d.d.ts.map +0 -1
  530. package/dist/__tests__/render-feature-prepared-graphics-docs.unit.test.d.ts +0 -2
  531. package/dist/__tests__/render-feature-prepared-graphics-docs.unit.test.d.ts.map +0 -1
  532. package/dist/__tests__/render-feature-prepared-graphics-isolation.unit.test.d.ts +0 -2
  533. package/dist/__tests__/render-feature-prepared-graphics-isolation.unit.test.d.ts.map +0 -1
  534. package/dist/__tests__/render-feature-prepared-graphics-negative.test-d.d.ts +0 -2
  535. package/dist/__tests__/render-feature-prepared-graphics-negative.test-d.d.ts.map +0 -1
  536. package/dist/__tests__/render-feature-prepared-graphics.test-d.d.ts +0 -2
  537. package/dist/__tests__/render-feature-prepared-graphics.test-d.d.ts.map +0 -1
  538. package/dist/__tests__/render-feature-prepared-graphics.unit.test.d.ts +0 -2
  539. package/dist/__tests__/render-feature-prepared-graphics.unit.test.d.ts.map +0 -1
  540. package/dist/__tests__/render-feature-public-surface.test-d.d.ts +0 -2
  541. package/dist/__tests__/render-feature-public-surface.test-d.d.ts.map +0 -1
  542. package/dist/__tests__/render-feature-retry.unit.test.d.ts +0 -2
  543. package/dist/__tests__/render-feature-retry.unit.test.d.ts.map +0 -1
  544. package/dist/__tests__/render-feature-scheduling.unit.test.d.ts +0 -2
  545. package/dist/__tests__/render-feature-scheduling.unit.test.d.ts.map +0 -1
  546. package/dist/__tests__/render-feature-stage-failed-policy-owner.unit.test.d.ts +0 -2
  547. package/dist/__tests__/render-feature-stage-failed-policy-owner.unit.test.d.ts.map +0 -1
  548. package/dist/__tests__/render-feature-stage-fault-recovery.unit.test.d.ts +0 -2
  549. package/dist/__tests__/render-feature-stage-fault-recovery.unit.test.d.ts.map +0 -1
  550. package/dist/__tests__/render-feature-visibility-context.test-d.d.ts +0 -2
  551. package/dist/__tests__/render-feature-visibility-context.test-d.d.ts.map +0 -1
  552. package/dist/__tests__/render-feature-visibility-context.unit.test.d.ts +0 -2
  553. package/dist/__tests__/render-feature-visibility-context.unit.test.d.ts.map +0 -1
  554. package/dist/__tests__/render-feature-zero-work.unit.test.d.ts +0 -2
  555. package/dist/__tests__/render-feature-zero-work.unit.test.d.ts.map +0 -1
  556. package/dist/__tests__/render-graph-compute-raster-gpu.d.ts +0 -7
  557. package/dist/__tests__/render-graph-compute-raster-gpu.d.ts.map +0 -1
  558. package/dist/__tests__/render-graph-compute-raster.browser.test.d.ts +0 -2
  559. package/dist/__tests__/render-graph-compute-raster.browser.test.d.ts.map +0 -1
  560. package/dist/__tests__/render-graph-compute-raster.dawn.test.d.ts +0 -2
  561. package/dist/__tests__/render-graph-compute-raster.dawn.test.d.ts.map +0 -1
  562. package/dist/__tests__/render-graph-hzb-gpu.d.ts +0 -7
  563. package/dist/__tests__/render-graph-hzb-gpu.d.ts.map +0 -1
  564. package/dist/__tests__/render-graph-hzb.browser.test.d.ts +0 -2
  565. package/dist/__tests__/render-graph-hzb.browser.test.d.ts.map +0 -1
  566. package/dist/__tests__/render-graph-hzb.dawn.test.d.ts +0 -2
  567. package/dist/__tests__/render-graph-hzb.dawn.test.d.ts.map +0 -1
  568. package/dist/__tests__/render-graph-primitives.unit.test.d.ts +0 -2
  569. package/dist/__tests__/render-graph-primitives.unit.test.d.ts.map +0 -1
  570. package/dist/__tests__/render-graph-storage-indirect-gpu.d.ts +0 -12
  571. package/dist/__tests__/render-graph-storage-indirect-gpu.d.ts.map +0 -1
  572. package/dist/__tests__/render-graph-storage-indirect.browser.test.d.ts +0 -2
  573. package/dist/__tests__/render-graph-storage-indirect.browser.test.d.ts.map +0 -1
  574. package/dist/__tests__/render-graph-storage-indirect.dawn.test.d.ts +0 -2
  575. package/dist/__tests__/render-graph-storage-indirect.dawn.test.d.ts.map +0 -1
  576. package/dist/__tests__/render-scene-projection.unit.test.d.ts +0 -2
  577. package/dist/__tests__/render-scene-projection.unit.test.d.ts.map +0 -1
  578. package/dist/__tests__/renderer-factory-material-contract.unit.test.d.ts +0 -2
  579. package/dist/__tests__/renderer-factory-material-contract.unit.test.d.ts.map +0 -1
  580. package/dist/__tests__/renderer-lifecycle.integration.test.d.ts +0 -2
  581. package/dist/__tests__/renderer-lifecycle.integration.test.d.ts.map +0 -1
  582. package/dist/__tests__/rhi-backend-package-boundary.unit.test.d.ts +0 -2
  583. package/dist/__tests__/rhi-backend-package-boundary.unit.test.d.ts.map +0 -1
  584. package/dist/__tests__/scriptable-pack-consumer.test-d.d.ts +0 -2
  585. package/dist/__tests__/scriptable-pack-consumer.test-d.d.ts.map +0 -1
  586. package/dist/__tests__/shader-stage-surface.unit.test.d.ts +0 -2
  587. package/dist/__tests__/shader-stage-surface.unit.test.d.ts.map +0 -1
  588. package/dist/__tests__/ssao-config.unit.test.d.ts +0 -2
  589. package/dist/__tests__/ssao-config.unit.test.d.ts.map +0 -1
  590. package/dist/__tests__/ssao-kernel-surface.unit.test.d.ts +0 -2
  591. package/dist/__tests__/ssao-kernel-surface.unit.test.d.ts.map +0 -1
  592. package/dist/__tests__/standard-clustered-pipeline.unit.test.d.ts +0 -2
  593. package/dist/__tests__/standard-clustered-pipeline.unit.test.d.ts.map +0 -1
  594. package/dist/__tests__/standard-descriptors.test-d.d.ts +0 -2
  595. package/dist/__tests__/standard-descriptors.test-d.d.ts.map +0 -1
  596. package/dist/__tests__/standard-pipeline.dawn.test.d.ts +0 -2
  597. package/dist/__tests__/standard-pipeline.dawn.test.d.ts.map +0 -1
  598. package/dist/__tests__/standard-pipeline.integration.test.d.ts +0 -2
  599. package/dist/__tests__/standard-pipeline.integration.test.d.ts.map +0 -1
  600. package/dist/__tests__/standard-profile-oracle.unit.test.d.ts +0 -2
  601. package/dist/__tests__/standard-profile-oracle.unit.test.d.ts.map +0 -1
  602. package/dist/__tests__/surface-configuration.unit.test.d.ts +0 -2
  603. package/dist/__tests__/surface-configuration.unit.test.d.ts.map +0 -1
  604. package/dist/__tests__/texture-usage-surface.unit.test.d.ts +0 -2
  605. package/dist/__tests__/texture-usage-surface.unit.test.d.ts.map +0 -1
  606. package/dist/__tests__/typed-pipeline-topology.unit.test.d.ts +0 -2
  607. package/dist/__tests__/typed-pipeline-topology.unit.test.d.ts.map +0 -1
  608. package/dist/__tests__/urp-pipeline-targets.unit.test.d.ts +0 -2
  609. package/dist/__tests__/urp-pipeline-targets.unit.test.d.ts.map +0 -1
  610. package/dist/__tests__/urp-pipeline.unit.test.d.ts +0 -2
  611. package/dist/__tests__/urp-pipeline.unit.test.d.ts.map +0 -1
  612. package/dist/__tests__/vertex-color-pipeline.unit.test.d.ts +0 -2
  613. package/dist/__tests__/vertex-color-pipeline.unit.test.d.ts.map +0 -1
  614. package/dist/__tests__/vertex-layout-consumer.unit.test.d.ts +0 -2
  615. package/dist/__tests__/vertex-layout-consumer.unit.test.d.ts.map +0 -1
  616. package/dist/__tests__/visibility-diagnostics.integration.test.d.ts +0 -2
  617. package/dist/__tests__/visibility-diagnostics.integration.test.d.ts.map +0 -1
  618. package/dist/__tests__/visibility-extract.integration.test.d.ts +0 -2
  619. package/dist/__tests__/visibility-extract.integration.test.d.ts.map +0 -1
  620. package/dist/__tests__/visibility-extract.perf.test.d.ts +0 -2
  621. package/dist/__tests__/visibility-extract.perf.test.d.ts.map +0 -1
  622. package/dist/__tests__/visibility-feature-dedup.integration.test.d.ts +0 -2
  623. package/dist/__tests__/visibility-feature-dedup.integration.test.d.ts.map +0 -1
  624. package/dist/__tests__/visibility-hidden-report.unit.test.d.ts +0 -2
  625. package/dist/__tests__/visibility-hidden-report.unit.test.d.ts.map +0 -1
  626. package/dist/__tests__/visibility-instances.integration.test.d.ts +0 -2
  627. package/dist/__tests__/visibility-instances.integration.test.d.ts.map +0 -1
  628. package/dist/__tests__/visibility-multi-world.integration.test.d.ts +0 -2
  629. package/dist/__tests__/visibility-multi-world.integration.test.d.ts.map +0 -1
  630. package/dist/__tests__/visibility-producer-matrix.integration.test.d.ts +0 -2
  631. package/dist/__tests__/visibility-producer-matrix.integration.test.d.ts.map +0 -1
  632. package/dist/__tests__/visibility-producer-matrix.unit.test.d.ts +0 -2
  633. package/dist/__tests__/visibility-producer-matrix.unit.test.d.ts.map +0 -1
  634. package/dist/__tests__/visibility-public-surface.test-d.d.ts +0 -2
  635. package/dist/__tests__/visibility-public-surface.test-d.d.ts.map +0 -1
  636. package/dist/__tests__/visibility-resolver.unit.test.d.ts +0 -2
  637. package/dist/__tests__/visibility-resolver.unit.test.d.ts.map +0 -1
  638. package/dist/__tests__/visibility-resource-short-circuit.unit.test.d.ts +0 -2
  639. package/dist/__tests__/visibility-resource-short-circuit.unit.test.d.ts.map +0 -1
  640. package/dist/__tests__/visibility-snapshot-contract.unit.test.d.ts +0 -2
  641. package/dist/__tests__/visibility-snapshot-contract.unit.test.d.ts.map +0 -1
  642. package/dist/__tests__/vocabulary.unit.test.d.ts +0 -2
  643. package/dist/__tests__/vocabulary.unit.test.d.ts.map +0 -1
  644. package/dist/chunk-CQXZC5XI.mjs.map +0 -1
  645. package/dist/chunk-HCOGPHKS.mjs +0 -93
  646. package/dist/chunk-HCOGPHKS.mjs.map +0 -1
  647. package/dist/chunk-YEJIUW7D.mjs.map +0 -1
  648. package/dist/components/__tests__/points-lines-admission.unit.test.d.ts +0 -2
  649. package/dist/components/__tests__/points-lines-admission.unit.test.d.ts.map +0 -1
  650. package/dist/components/__tests__/points-lines-schema.unit.test.d.ts +0 -2
  651. package/dist/components/__tests__/points-lines-schema.unit.test.d.ts.map +0 -1
  652. package/dist/components/__tests__/schema-contract.unit.test.d.ts +0 -2
  653. package/dist/components/__tests__/schema-contract.unit.test.d.ts.map +0 -1
  654. package/dist/components/__tests__/schema-parity.unit.test.d.ts +0 -2
  655. package/dist/components/__tests__/schema-parity.unit.test.d.ts.map +0 -1
  656. package/dist/components/__tests__/visibility-schema.unit.test.d.ts +0 -2
  657. package/dist/components/__tests__/visibility-schema.unit.test.d.ts.map +0 -1
  658. package/dist/points-lines/__tests__/bounds.unit.test.d.ts +0 -2
  659. package/dist/points-lines/__tests__/bounds.unit.test.d.ts.map +0 -1
  660. package/dist/points-lines/__tests__/cache-recovery.unit.test.d.ts +0 -2
  661. package/dist/points-lines/__tests__/cache-recovery.unit.test.d.ts.map +0 -1
  662. package/dist/points-lines/__tests__/inspection-lanes.integration.test.d.ts +0 -2
  663. package/dist/points-lines/__tests__/inspection-lanes.integration.test.d.ts.map +0 -1
  664. package/dist/points-lines/__tests__/inspection.unit.test.d.ts +0 -2
  665. package/dist/points-lines/__tests__/inspection.unit.test.d.ts.map +0 -1
  666. package/dist/points-lines/__tests__/lane-structural.integration.test.d.ts +0 -2
  667. package/dist/points-lines/__tests__/lane-structural.integration.test.d.ts.map +0 -1
  668. package/dist/points-lines/__tests__/points-lines.bench.d.ts +0 -2
  669. package/dist/points-lines/__tests__/points-lines.bench.d.ts.map +0 -1
  670. package/dist/points-lines/__tests__/raster-lane.integration.test.d.ts +0 -2
  671. package/dist/points-lines/__tests__/raster-lane.integration.test.d.ts.map +0 -1
  672. package/dist/points-lines/__tests__/snapshot.unit.test.d.ts +0 -2
  673. package/dist/points-lines/__tests__/snapshot.unit.test.d.ts.map +0 -1
  674. package/dist/points-lines/__tests__/view-ubo.unit.test.d.ts +0 -2
  675. package/dist/points-lines/__tests__/view-ubo.unit.test.d.ts.map +0 -1
  676. package/dist/record/__tests__/material-bg-cache.unit.test.d.ts +0 -2
  677. package/dist/record/__tests__/material-bg-cache.unit.test.d.ts.map +0 -1
  678. package/dist/record/__tests__/material-slot-plan.unit.test.d.ts +0 -2
  679. package/dist/record/__tests__/material-slot-plan.unit.test.d.ts.map +0 -1
  680. package/dist/record/__tests__/typed-frame-graph-plan.unit.test.d.ts +0 -2
  681. package/dist/record/__tests__/typed-frame-graph-plan.unit.test.d.ts.map +0 -1
  682. package/dist/record/__tests__/video-texture-view.unit.test.d.ts +0 -2
  683. package/dist/record/__tests__/video-texture-view.unit.test.d.ts.map +0 -1
@@ -0,0 +1,438 @@
1
+ import { World } from '@forgeax/engine-ecs';
2
+ import { createPlaneGeometry } from '@forgeax/engine-geometry';
3
+ import {
4
+ _internal_getRawDevice,
5
+ createShaderModule,
6
+ rhi,
7
+ translateErrorEventToRhiError as translateWebgpuError,
8
+ } from '@forgeax/engine-rhi-webgpu';
9
+ import { Transform } from '@forgeax/engine-scene';
10
+ import type { TextureAsset } from '@forgeax/engine-types';
11
+ import { describe, expect, it } from 'vitest';
12
+ import {
13
+ Camera,
14
+ DirectionalLight,
15
+ MeshFilter,
16
+ MeshRenderer,
17
+ TONEMAP_LINEAR,
18
+ } from '../../components';
19
+ import { constructRendererHost, type RhiBackendPack } from '../../construct-renderer';
20
+ import { Materials } from '../../materials';
21
+ import { DEFAULT_STANDARD_PROFILE } from '../../pipeline/standard-profile';
22
+
23
+ const WIDTH = 32;
24
+ const HEIGHT = 32;
25
+ const TEXTURE_USAGE_COPY_SRC = 0x01;
26
+ const TEXTURE_USAGE_RENDER_ATTACHMENT = 0x10;
27
+ const BUFFER_USAGE_MAP_READ = 0x0001;
28
+ const BUFFER_USAGE_COPY_DST = 0x0008;
29
+ const GPU_MAP_MODE_READ = 0x0001;
30
+ const TEST_REACTIVE = 0;
31
+
32
+ const ENGINE_MANIFEST = await (async () => {
33
+ const { buildEngineShaderManifest } = await import('@forgeax/engine-vite-plugin-shader');
34
+ return buildEngineShaderManifest();
35
+ })();
36
+ const ENGINE_MANIFEST_URL = `data:application/json,${encodeURIComponent(
37
+ JSON.stringify(ENGINE_MANIFEST),
38
+ )}`;
39
+ const DAWN_BACKEND: RhiBackendPack = {
40
+ rhi,
41
+ createShaderModule,
42
+ _internal_getRawDevice,
43
+ translateErrorEventToRhiError: translateWebgpuError as NonNullable<
44
+ RhiBackendPack['translateErrorEventToRhiError']
45
+ >,
46
+ };
47
+
48
+ interface TransmissionCase {
49
+ readonly name: string;
50
+ readonly transmission: number;
51
+ readonly ior: number;
52
+ readonly thickness: number;
53
+ readonly roughness: number;
54
+ readonly attenuationColor: readonly [number, number, number];
55
+ readonly attenuationDistance?: number;
56
+ readonly transmissionTexture?: number;
57
+ readonly thicknessTexture?: number;
58
+ readonly masked?: boolean;
59
+ readonly overlap?: boolean;
60
+ readonly lane?: 'direct' | 'clustered';
61
+ readonly surfaceQuat?: readonly [number, number, number, number];
62
+ }
63
+
64
+ function textureAsset(value: number): TextureAsset {
65
+ const channel = Math.round(value * 255);
66
+ return {
67
+ kind: 'texture',
68
+ width: 1,
69
+ height: 1,
70
+ format: 'rgba8unorm',
71
+ data: Uint8Array.from([channel, channel, channel, 255]),
72
+ colorSpace: 'linear',
73
+ mipmap: false,
74
+ };
75
+ }
76
+
77
+ async function readCenter(
78
+ device: GPUDevice,
79
+ target: GPUTexture,
80
+ ): Promise<[number, number, number, number]> {
81
+ const bytesPerRow = Math.ceil((WIDTH * 4) / 256) * 256;
82
+ const readback = device.createBuffer({
83
+ size: bytesPerRow * HEIGHT,
84
+ usage: BUFFER_USAGE_MAP_READ | BUFFER_USAGE_COPY_DST,
85
+ });
86
+ const encoder = device.createCommandEncoder();
87
+ encoder.copyTextureToBuffer(
88
+ { texture: target },
89
+ { buffer: readback, bytesPerRow, rowsPerImage: HEIGHT },
90
+ { width: WIDTH, height: HEIGHT, depthOrArrayLayers: 1 },
91
+ );
92
+ device.queue.submit([encoder.finish()]);
93
+ await readback.mapAsync(GPU_MAP_MODE_READ);
94
+ const bytes = new Uint8Array(readback.getMappedRange().slice(0));
95
+ readback.unmap();
96
+ readback.destroy();
97
+ const offset = Math.floor(HEIGHT / 2) * bytesPerRow + Math.floor(WIDTH / 2) * 4;
98
+ return [
99
+ bytes[offset] ?? 0,
100
+ bytes[offset + 1] ?? 0,
101
+ bytes[offset + 2] ?? 0,
102
+ bytes[offset + 3] ?? 0,
103
+ ];
104
+ }
105
+
106
+ async function renderCase(testCase: TransmissionCase): Promise<{
107
+ readonly pixel: readonly [number, number, number, number];
108
+ readonly passNames: readonly string[];
109
+ readonly observation: boolean;
110
+ }> {
111
+ let device: GPUDevice | undefined;
112
+ let configuredDevice: GPUDevice | undefined;
113
+ let target: GPUTexture | undefined;
114
+ const originalRequestAdapter = globalThis.navigator.gpu.requestAdapter.bind(
115
+ globalThis.navigator.gpu,
116
+ );
117
+ globalThis.navigator.gpu.requestAdapter = async (options) => {
118
+ const adapter = await originalRequestAdapter(options);
119
+ if (adapter === null) return adapter;
120
+ const requestDevice = adapter.requestDevice.bind(adapter);
121
+ adapter.requestDevice = async (descriptor) => {
122
+ const next = await requestDevice(descriptor);
123
+ device ??= next;
124
+ return next;
125
+ };
126
+ return adapter;
127
+ };
128
+ const canvas = {
129
+ width: WIDTH,
130
+ height: HEIGHT,
131
+ getContext(kind: string): unknown {
132
+ if (kind !== 'webgpu') return null;
133
+ return {
134
+ configure(desc: { device: GPUDevice; format?: GPUTextureFormat }) {
135
+ configuredDevice ??= desc.device;
136
+ target ??= desc.device.createTexture({
137
+ size: { width: WIDTH, height: HEIGHT, depthOrArrayLayers: 1 },
138
+ format: desc.format ?? 'rgba8unorm',
139
+ usage: TEXTURE_USAGE_COPY_SRC | TEXTURE_USAGE_RENDER_ATTACHMENT,
140
+ viewFormats: ['rgba8unorm-srgb'],
141
+ });
142
+ },
143
+ unconfigure() {},
144
+ getCurrentTexture() {
145
+ if (target === undefined) throw new Error('render target was not configured');
146
+ return target;
147
+ },
148
+ };
149
+ },
150
+ addEventListener() {},
151
+ removeEventListener() {},
152
+ } as unknown as HTMLCanvasElement;
153
+
154
+ let host: Awaited<ReturnType<typeof constructRendererHost>>;
155
+ try {
156
+ host = await constructRendererHost(
157
+ canvas,
158
+ {
159
+ standardProfile: {
160
+ ...DEFAULT_STANDARD_PROFILE,
161
+ lighting: testCase.lane ?? 'direct',
162
+ },
163
+ },
164
+ { shaderManifestUrl: ENGINE_MANIFEST_URL },
165
+ DAWN_BACKEND,
166
+ );
167
+ } finally {
168
+ globalThis.navigator.gpu.requestAdapter = originalRequestAdapter;
169
+ }
170
+ expect(host.ok).toBe(true);
171
+ if (!host.ok || device === undefined) {
172
+ throw new Error('runtime Dawn renderer was not ready');
173
+ }
174
+
175
+ const { renderer } = host.value;
176
+ const world = new World();
177
+ const lease = renderer.attach(world);
178
+ if (!lease.ok) throw lease.error;
179
+ const plane = createPlaneGeometry(2, 2);
180
+ if (!plane.ok) throw plane.error;
181
+ const mesh = world.allocSharedRef('MeshAsset', {
182
+ ...plane.value,
183
+ materialSlots: [{ slotName: 'Default' }],
184
+ });
185
+ const transmissionHandle =
186
+ testCase.transmissionTexture === undefined
187
+ ? undefined
188
+ : world.allocSharedRef('TextureAsset', textureAsset(testCase.transmissionTexture));
189
+ const thicknessHandle =
190
+ testCase.thicknessTexture === undefined
191
+ ? undefined
192
+ : world.allocSharedRef('TextureAsset', textureAsset(testCase.thicknessTexture));
193
+ const material = Materials.standard({
194
+ baseColor: [0.7, 0.8, 0.9, testCase.masked ? 0.35 : 1],
195
+ metallic: 0,
196
+ roughness: testCase.roughness,
197
+ transmission: testCase.transmission,
198
+ ior: testCase.ior,
199
+ thickness: testCase.thickness,
200
+ attenuationColor: testCase.attenuationColor,
201
+ castShadow: false,
202
+ ...(testCase.attenuationDistance === undefined
203
+ ? {}
204
+ : { attenuationDistance: testCase.attenuationDistance }),
205
+ ...(testCase.masked
206
+ ? {
207
+ queue: 2450,
208
+ alphaCutoff: 0.5,
209
+ baseColorTexture: {
210
+ texture: world.allocSharedRef('TextureAsset', {
211
+ kind: 'texture',
212
+ width: 2,
213
+ height: 2,
214
+ format: 'rgba8unorm',
215
+ data: Uint8Array.from([
216
+ 255, 255, 255, 0, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 0,
217
+ ]),
218
+ colorSpace: 'linear',
219
+ mipmap: false,
220
+ }),
221
+ },
222
+ }
223
+ : { queue: 2000 }),
224
+ ...(testCase.surfaceQuat === undefined ? {} : { renderState: { cullMode: 'none' as const } }),
225
+ ...(transmissionHandle === undefined
226
+ ? {}
227
+ : { transmissionTexture: { texture: transmissionHandle as never } }),
228
+ ...(thicknessHandle === undefined
229
+ ? {}
230
+ : { thicknessTexture: { texture: thicknessHandle as never } }),
231
+ });
232
+ const materialHandle = world.allocSharedRef('MaterialAsset', material);
233
+ const meshEntity = world.spawn(
234
+ {
235
+ component: Transform,
236
+ data: testCase.surfaceQuat === undefined ? {} : { quat: testCase.surfaceQuat },
237
+ },
238
+ { component: MeshFilter, data: { assetHandle: mesh } },
239
+ { component: MeshRenderer, data: { materials: [materialHandle] } },
240
+ );
241
+ expect(meshEntity.ok, `${testCase.name}: mesh spawn must succeed`).toBe(true);
242
+ if (!meshEntity.ok) throw meshEntity.error;
243
+ if (testCase.overlap) {
244
+ const overlay = Materials.unlit([0.1, 0.9, 0.2, 0.35], {
245
+ castShadow: false,
246
+ queue: 3000,
247
+ renderState: {
248
+ cullMode: 'none',
249
+ depthWriteEnabled: false,
250
+ blend: {
251
+ color: { srcFactor: 'src-alpha', dstFactor: 'one-minus-src-alpha', operation: 'add' },
252
+ alpha: { srcFactor: 'one', dstFactor: 'one-minus-src-alpha', operation: 'add' },
253
+ },
254
+ },
255
+ });
256
+ const overlayHandle = world.allocSharedRef('MaterialAsset', overlay);
257
+ const overlayEntity = world.spawn(
258
+ { component: Transform, data: { pos: [0, 0, -0.1] } },
259
+ { component: MeshFilter, data: { assetHandle: mesh } },
260
+ { component: MeshRenderer, data: { materials: [overlayHandle] } },
261
+ );
262
+ expect(overlayEntity.ok, `${testCase.name}: overlay spawn must succeed`).toBe(true);
263
+ if (!overlayEntity.ok) throw overlayEntity.error;
264
+ }
265
+ const cameraEntity = world.spawn(
266
+ { component: Transform, data: { pos: [0, 0, 3] } },
267
+ {
268
+ component: Camera,
269
+ data: {
270
+ fov: Math.PI / 4,
271
+ aspect: 1,
272
+ near: 0.1,
273
+ far: 10,
274
+ tonemap: TONEMAP_LINEAR,
275
+ clearColor: [0.05, 0.1, 0.15, 1],
276
+ },
277
+ },
278
+ );
279
+ expect(cameraEntity.ok, `${testCase.name}: camera spawn must succeed`).toBe(true);
280
+ if (!cameraEntity.ok) throw cameraEntity.error;
281
+ const lightEntity = world.spawn({
282
+ component: DirectionalLight,
283
+ data: { direction: [0, 0, -1], color: [1, 1, 1], intensity: 1, castShadow: false },
284
+ });
285
+ expect(lightEntity.ok, `${testCase.name}: light spawn must succeed`).toBe(true);
286
+ if (!lightEntity.ok) throw lightEntity.error;
287
+ world.update().unwrap();
288
+ const drawn = renderer.draw({
289
+ leases: [lease.value],
290
+ camera: { lease: lease.value },
291
+ environment: { lease: lease.value },
292
+ });
293
+ expect(drawn.ok, drawn.ok ? undefined : JSON.stringify(drawn.error)).toBe(true);
294
+ if (!drawn.ok) throw drawn.error;
295
+ await drawn.value.completed;
296
+ const observation = await renderer.observe(drawn.value, { include: ['draws', 'bindings'] });
297
+ expect(observation.ok).toBe(true);
298
+ await device.queue.onSubmittedWorkDone();
299
+ if (target === undefined) throw new Error('render target was not configured after draw');
300
+ const renderDevice = configuredDevice ?? device;
301
+ const passNames = renderer.inspect().perFramePassNames;
302
+ expect(renderer.inspect().renderScene.projectionRecords).toBeGreaterThanOrEqual(1);
303
+ return {
304
+ pixel: await readCenter(renderDevice, target),
305
+ passNames,
306
+ observation: observation.ok,
307
+ };
308
+ }
309
+
310
+ function luma(pixel: readonly [number, number, number, number]): number {
311
+ return 0.2126 * pixel[0] + 0.7152 * pixel[1] + 0.0722 * pixel[2];
312
+ }
313
+
314
+ describe('Standard transmission Dawn ROI', () => {
315
+ it('uses linear HDR observation and responds to F0, Beer, texture, TIR, and fallback inputs', async () => {
316
+ const baseline = await renderCase({
317
+ name: 'baseline',
318
+ transmission: 0,
319
+ ior: 1.5,
320
+ thickness: 0,
321
+ roughness: 0.5,
322
+ attenuationColor: [1, 1, 1],
323
+ });
324
+ const transmitted = await renderCase({
325
+ name: 'transmitted',
326
+ transmission: 1,
327
+ ior: 1.5,
328
+ thickness: 0.5,
329
+ roughness: 0.5,
330
+ attenuationColor: [0.1, 0.4, 0.8],
331
+ attenuationDistance: 1,
332
+ transmissionTexture: 1,
333
+ thicknessTexture: 1,
334
+ });
335
+ const tir = await renderCase({
336
+ name: 'total-internal-reflection',
337
+ transmission: 1,
338
+ ior: 1.5,
339
+ thickness: 0.5,
340
+ roughness: 0.5,
341
+ attenuationColor: [0.1, 0.4, 0.8],
342
+ attenuationDistance: 1,
343
+ transmissionTexture: 1,
344
+ thicknessTexture: 1,
345
+ // Back side at a grazing angle: eta=ior exercises TIR. The old case
346
+ // duplicated the air-to-glass inputs (eta=1/ior), where TIR is impossible.
347
+ surfaceQuat: [0, Math.sin((Math.PI * 235) / 360), 0, Math.cos((Math.PI * 235) / 360)],
348
+ });
349
+
350
+ expect(baseline.passNames).not.toContain('transmission-forward');
351
+ expect(transmitted.passNames).toContain('linear-hdr-observation');
352
+ expect(transmitted.passNames).toContain('transmission-forward');
353
+ expect(transmitted.observation).toBe(true);
354
+ expect(transmitted.pixel.every(Number.isFinite)).toBe(true);
355
+ expect(transmitted.pixel).not.toEqual(baseline.pixel);
356
+ expect(tir.pixel).not.toEqual(transmitted.pixel);
357
+ expect(TEST_REACTIVE).toBe(0);
358
+ }, 120_000);
359
+
360
+ it('keeps IOR, thickness, and roughness monotonic in a finite linear ROI', async () => {
361
+ const cases = await Promise.all([
362
+ renderCase({
363
+ name: 'ior-low',
364
+ transmission: 1,
365
+ ior: 1.1,
366
+ thickness: 0.1,
367
+ roughness: 0.1,
368
+ attenuationColor: [0.8, 0.8, 0.8],
369
+ attenuationDistance: 4,
370
+ }),
371
+ renderCase({
372
+ name: 'ior-high',
373
+ transmission: 1,
374
+ ior: 2.2,
375
+ thickness: 0.1,
376
+ roughness: 0.1,
377
+ attenuationColor: [0.8, 0.8, 0.8],
378
+ attenuationDistance: 4,
379
+ }),
380
+ renderCase({
381
+ name: 'thick',
382
+ transmission: 1,
383
+ ior: 1.5,
384
+ thickness: 1.5,
385
+ roughness: 0.1,
386
+ attenuationColor: [0.1, 0.1, 0.1],
387
+ attenuationDistance: 1,
388
+ }),
389
+ renderCase({
390
+ name: 'rough',
391
+ transmission: 1,
392
+ ior: 1.5,
393
+ thickness: 0.1,
394
+ roughness: 0.9,
395
+ attenuationColor: [0.8, 0.8, 0.8],
396
+ attenuationDistance: 4,
397
+ }),
398
+ ]);
399
+ for (const result of cases) expect(result.pixel.every(Number.isFinite)).toBe(true);
400
+ expect(cases[1]?.pixel).not.toEqual(cases[0]?.pixel);
401
+ expect(cases[2]?.pixel).not.toEqual(cases[0]?.pixel);
402
+ expect(luma(cases[3]?.pixel ?? [0, 0, 0, 0])).toBeLessThanOrEqual(
403
+ luma(cases[0]?.pixel ?? [0, 0, 0, 0]) + 2,
404
+ );
405
+ }, 120_000);
406
+
407
+ it('exercises direct/clustered lanes and transmission-before-BLEND overlap order', async () => {
408
+ const direct = await renderCase({
409
+ name: 'direct',
410
+ transmission: 1,
411
+ ior: 1.5,
412
+ thickness: 0.5,
413
+ roughness: 0.3,
414
+ attenuationColor: [0.7, 0.8, 0.9],
415
+ attenuationDistance: 2,
416
+ overlap: true,
417
+ lane: 'direct',
418
+ });
419
+ const clustered = await renderCase({
420
+ name: 'clustered',
421
+ transmission: 1,
422
+ ior: 1.5,
423
+ thickness: 0.5,
424
+ roughness: 0.3,
425
+ attenuationColor: [0.7, 0.8, 0.9],
426
+ attenuationDistance: 2,
427
+ overlap: true,
428
+ lane: 'clustered',
429
+ });
430
+ const transmissionIndex = direct.passNames.indexOf('transmission-forward');
431
+ const transparentIndex = direct.passNames.indexOf('transparent');
432
+ expect(transmissionIndex).toBeGreaterThanOrEqual(0);
433
+ expect(transparentIndex).toBeGreaterThan(transmissionIndex);
434
+ expect(clustered.pixel).not.toEqual(direct.pixel);
435
+ expect(clustered.pixel.every(Number.isFinite)).toBe(true);
436
+ expect(direct.pixel.every(Number.isFinite)).toBe(true);
437
+ }, 120_000);
438
+ });
@@ -0,0 +1,109 @@
1
+ import { RenderGraphBuilder } from '@forgeax/engine-render-graph';
2
+ import { describe, expect, it } from 'vitest';
3
+ import type { RenderPipelineFrame } from '../../render-pipeline';
4
+ import { createRenderPipelineTarget } from '../../render-pipeline';
5
+ import {
6
+ addTransmissionBackdropPasses,
7
+ resolveTransmissionBackdropTopology,
8
+ type TransmissionBackdropTopologyInput,
9
+ } from '../backdrop';
10
+
11
+ function topology(
12
+ overrides: Partial<TransmissionBackdropTopologyInput> = {},
13
+ ): TransmissionBackdropTopologyInput {
14
+ return {
15
+ demand: { activeCount: 1, needsRoughMips: false },
16
+ sourceSampleCount: 1,
17
+ ...overrides,
18
+ };
19
+ }
20
+
21
+ describe('TransmissionBackdrop typed topology', () => {
22
+ it('keeps the demand-off path exact zero', () => {
23
+ expect(
24
+ resolveTransmissionBackdropTopology({
25
+ demand: { activeCount: 0, needsRoughMips: false },
26
+ sourceSampleCount: 4,
27
+ }),
28
+ ).toEqual({
29
+ active: false,
30
+ sourceSampleCount: 4,
31
+ copyCount: 0,
32
+ mipCount: 0,
33
+ submitCount: 1,
34
+ aliasCount: 0,
35
+ phases: [],
36
+ });
37
+ });
38
+
39
+ it('places one resolved copy before transmission and ordinary transparent work', () => {
40
+ expect(resolveTransmissionBackdropTopology(topology()).phases).toEqual([
41
+ 'opaque-resolve',
42
+ 'transmission-backdrop-copy',
43
+ 'transmission-forward',
44
+ 'transparent',
45
+ 'temporal',
46
+ ]);
47
+ expect(resolveTransmissionBackdropTopology(topology())).toMatchObject({
48
+ active: true,
49
+ copyCount: 1,
50
+ mipCount: 0,
51
+ });
52
+ });
53
+
54
+ it('adds only shared raster mip work for rough transmission', () => {
55
+ expect(
56
+ resolveTransmissionBackdropTopology(
57
+ topology({ demand: { activeCount: 2, needsRoughMips: true } }),
58
+ ),
59
+ ).toMatchObject({
60
+ active: true,
61
+ copyCount: 1,
62
+ mipCount: 1,
63
+ phases: [
64
+ 'opaque-resolve',
65
+ 'transmission-backdrop-copy',
66
+ 'transmission-backdrop-mip',
67
+ 'transmission-forward',
68
+ 'transparent',
69
+ 'temporal',
70
+ ],
71
+ });
72
+ });
73
+
74
+ it('never creates a second submission or aliases the backdrop source', () => {
75
+ const result = resolveTransmissionBackdropTopology(topology({ sourceSampleCount: 4 }));
76
+
77
+ expect(result).toMatchObject({ sourceSampleCount: 4, submitCount: 1, aliasCount: 0 });
78
+ });
79
+
80
+ it('rejects rough mips without a renderer-owned sampling encoder', () => {
81
+ const graph = new RenderGraphBuilder<RenderPipelineFrame>();
82
+ const source = createRenderPipelineTarget(graph, 'opaque-resolved', {
83
+ format: 'rgba16float',
84
+ size: 'surface',
85
+ });
86
+ expect(source.ok).toBe(true);
87
+ if (!source.ok) return;
88
+
89
+ const result = addTransmissionBackdropPasses({
90
+ graph,
91
+ source: source.value,
92
+ demand: { activeCount: 1, needsRoughMips: true },
93
+ copySize: { width: 8, height: 4 },
94
+ });
95
+
96
+ expect(result.ok).toBe(false);
97
+ if (result.ok) return;
98
+ expect(result.error).toMatchObject({
99
+ code: 'resource-descriptor-invalid',
100
+ detail: {
101
+ resourceLabel: 'transmission-backdrop',
102
+ field: 'roughMipEncoder',
103
+ actual: 'missing',
104
+ },
105
+ });
106
+ expect(result.error.expected).toContain('fullscreen/downsample owner');
107
+ expect(result.error.hint).toContain('encodeRoughMip');
108
+ });
109
+ });
@@ -0,0 +1,105 @@
1
+ import { RenderGraphBuilder } from '@forgeax/engine-render-graph';
2
+ import type { RhiDevice } from '@forgeax/engine-rhi';
3
+ import { rhi } from '@forgeax/engine-rhi-webgpu';
4
+ import { describe, expect, it } from 'vitest';
5
+ import type { RenderPipelineFrame } from '../../render-pipeline';
6
+ import { createRenderPipelineTarget } from '../../render-pipeline';
7
+ import { addTransmissionBackdropPasses, type TransmissionBackdropGraph } from '../backdrop';
8
+
9
+ async function buildBackdrop(device: RhiDevice): Promise<TransmissionBackdropGraph> {
10
+ const graph = new RenderGraphBuilder<RenderPipelineFrame>();
11
+ const source = createRenderPipelineTarget(graph, 'opaque-resolved', {
12
+ format: 'rgba16float',
13
+ size: 'surface',
14
+ sampleCount: 1,
15
+ });
16
+ expect(source.ok).toBe(true);
17
+ if (!source.ok) throw source.error;
18
+ graph
19
+ .addRasterPass('opaque', {
20
+ accesses: [{ resource: source.value.view, usage: 'color-attachment' }],
21
+ colorAttachments: [{ view: source.value.view, loadOp: 'clear', storeOp: 'store' }],
22
+ encode: () => undefined,
23
+ })
24
+ .unwrap();
25
+ const added = addTransmissionBackdropPasses({
26
+ graph,
27
+ source: source.value,
28
+ demand: { activeCount: 2, needsRoughMips: true },
29
+ copySize: { width: 4, height: 4 },
30
+ encodeRoughMip: ({ pass }) => {
31
+ pass.draw(3, 1, 0, 0);
32
+ },
33
+ });
34
+ expect(added.ok).toBe(true);
35
+ if (!added.ok) throw added.error;
36
+ const compiled = graph.compile({ device, surfaceSize: { width: 4, height: 4 } });
37
+ if (!compiled.ok) throw compiled.error;
38
+ const names = compiled.value.inspect().passes.map((pass) => pass.name);
39
+ expect(names).toEqual([
40
+ 'opaque',
41
+ 'transmission-backdrop-copy',
42
+ 'transmission-backdrop-mip',
43
+ 'transmission-backdrop-mip-2',
44
+ 'transmission-forward',
45
+ 'transparent',
46
+ 'temporal',
47
+ ]);
48
+ expect(compiled.value.inspect().resources.map((resource) => resource.label)).toContain(
49
+ 'transmission-backdrop',
50
+ );
51
+ return added.value;
52
+ }
53
+
54
+ describe('TransmissionBackdrop Dawn topology', () => {
55
+ it('compiles the single rgba16float backdrop with one copy and raster mip', async () => {
56
+ const adapter = (await rhi.requestAdapter()).unwrap();
57
+ const device = (await adapter.requestDevice()).unwrap();
58
+ const result = await buildBackdrop(device);
59
+
60
+ expect(result.topology).toMatchObject({
61
+ active: true,
62
+ copyCount: 1,
63
+ mipCount: 1,
64
+ submitCount: 1,
65
+ aliasCount: 0,
66
+ });
67
+ });
68
+
69
+ it('does not allocate a backdrop on exact-zero demand', async () => {
70
+ const adapter = (await rhi.requestAdapter()).unwrap();
71
+ const device = (await adapter.requestDevice()).unwrap();
72
+ const graph = new RenderGraphBuilder<RenderPipelineFrame>();
73
+ const source = createRenderPipelineTarget(graph, 'opaque-resolved', {
74
+ format: 'rgba16float',
75
+ size: 'surface',
76
+ });
77
+ expect(source.ok).toBe(true);
78
+ if (!source.ok) return;
79
+ const added = addTransmissionBackdropPasses({
80
+ graph,
81
+ source: source.value,
82
+ demand: { activeCount: 0, needsRoughMips: false },
83
+ copySize: { width: 1, height: 1 },
84
+ });
85
+ expect(added).toEqual({
86
+ ok: true,
87
+ value: {
88
+ topology: {
89
+ active: false,
90
+ sourceSampleCount: 1,
91
+ copyCount: 0,
92
+ mipCount: 0,
93
+ submitCount: 1,
94
+ aliasCount: 0,
95
+ phases: [],
96
+ },
97
+ backdrop: undefined,
98
+ mipViews: [],
99
+ },
100
+ });
101
+ const compiled = graph.compile({ device, surfaceSize: { width: 1, height: 1 } });
102
+ expect(compiled.ok).toBe(true);
103
+ if (compiled.ok) expect(compiled.value.inspect().passes).toEqual([]);
104
+ });
105
+ });