@forgeax/engine-render 0.1.6 → 0.1.19

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (713) hide show
  1. package/README.md +279 -2
  2. package/dist/.tsbuildinfo +1 -1
  3. package/dist/assembly/backend-contract.d.ts +12 -0
  4. package/dist/assembly/backend-contract.d.ts.map +1 -1
  5. package/dist/assembly/factory.d.ts +19 -2
  6. package/dist/assembly/factory.d.ts.map +1 -1
  7. package/dist/assembly/host-contract.d.ts +4 -0
  8. package/dist/assembly/host-contract.d.ts.map +1 -1
  9. package/dist/assembly/material/assembly.d.ts.map +1 -1
  10. package/dist/assembly/renderer-frame-transaction.d.ts +39 -0
  11. package/dist/assembly/renderer-frame-transaction.d.ts.map +1 -0
  12. package/dist/assembly/renderer-inspection.d.ts +22 -0
  13. package/dist/assembly/renderer-inspection.d.ts.map +1 -0
  14. package/dist/assembly/renderer-lifecycle.d.ts +4 -0
  15. package/dist/assembly/renderer-lifecycle.d.ts.map +1 -0
  16. package/dist/authoring.d.ts +1 -0
  17. package/dist/authoring.d.ts.map +1 -1
  18. package/dist/authoring.mjs +4 -2
  19. package/dist/authoring.mjs.map +1 -1
  20. package/dist/chunk-FJ6P52EE.mjs +46 -0
  21. package/dist/chunk-FJ6P52EE.mjs.map +1 -0
  22. package/dist/chunk-IPXCABEP.mjs +73 -0
  23. package/dist/chunk-IPXCABEP.mjs.map +1 -0
  24. package/dist/chunk-JDWARUOI.mjs +44 -0
  25. package/dist/chunk-JDWARUOI.mjs.map +1 -0
  26. package/dist/chunk-LOSO4CTV.mjs +901 -0
  27. package/dist/chunk-LOSO4CTV.mjs.map +1 -0
  28. package/dist/chunk-PCHBPYML.mjs +385 -0
  29. package/dist/chunk-PCHBPYML.mjs.map +1 -0
  30. package/dist/chunk-RJRUS55L.mjs +9323 -0
  31. package/dist/chunk-RJRUS55L.mjs.map +1 -0
  32. package/dist/{chunk-QC4VW3XJ.mjs → chunk-RXZ3RGOU.mjs} +4 -30
  33. package/dist/chunk-RXZ3RGOU.mjs.map +1 -0
  34. package/dist/{chunk-CQXZC5XI.mjs → chunk-VFPLTKCU.mjs} +79 -69
  35. package/dist/chunk-VFPLTKCU.mjs.map +1 -0
  36. package/dist/{chunk-SCRSAK5B.mjs → chunk-YTQ5C7YQ.mjs} +231 -127
  37. package/dist/chunk-YTQ5C7YQ.mjs.map +1 -0
  38. package/dist/components/atmosphere.d.ts +9 -0
  39. package/dist/components/atmosphere.d.ts.map +1 -0
  40. package/dist/components/camera.d.ts +2 -1
  41. package/dist/components/camera.d.ts.map +1 -1
  42. package/dist/components/fog.d.ts +8 -0
  43. package/dist/components/fog.d.ts.map +1 -0
  44. package/dist/components/index.d.ts +5 -0
  45. package/dist/components/index.d.ts.map +1 -1
  46. package/dist/components/lines.d.ts +5 -0
  47. package/dist/components/lines.d.ts.map +1 -0
  48. package/dist/components/motion-blur.d.ts +7 -0
  49. package/dist/components/motion-blur.d.ts.map +1 -0
  50. package/dist/components/points.d.ts +15 -0
  51. package/dist/components/points.d.ts.map +1 -0
  52. package/dist/construct-renderer.d.ts +2 -2
  53. package/dist/construct-renderer.d.ts.map +1 -1
  54. package/dist/construct-renderer.mjs +11419 -16442
  55. package/dist/construct-renderer.mjs.map +1 -1
  56. package/dist/device/device-scope.d.ts +4 -0
  57. package/dist/device/device-scope.d.ts.map +1 -1
  58. package/dist/environment/frame.d.ts +60 -0
  59. package/dist/environment/frame.d.ts.map +1 -0
  60. package/dist/environment/generation.d.ts +21 -0
  61. package/dist/environment/generation.d.ts.map +1 -0
  62. package/dist/environment/graph.d.ts +4 -0
  63. package/dist/environment/graph.d.ts.map +1 -0
  64. package/dist/environment/inspection.d.ts +48 -0
  65. package/dist/environment/inspection.d.ts.map +1 -0
  66. package/dist/environment/lifecycle.d.ts +39 -0
  67. package/dist/environment/lifecycle.d.ts.map +1 -0
  68. package/dist/environment/signature.d.ts +25 -0
  69. package/dist/environment/signature.d.ts.map +1 -0
  70. package/dist/errors/render.d.ts +217 -1
  71. package/dist/errors/render.d.ts.map +1 -1
  72. package/dist/extract/camera.d.ts +5 -0
  73. package/dist/extract/camera.d.ts.map +1 -0
  74. package/dist/extract/environment.d.ts +74 -0
  75. package/dist/extract/environment.d.ts.map +1 -0
  76. package/dist/extract/visibility.d.ts +1 -1
  77. package/dist/extract/visibility.d.ts.map +1 -1
  78. package/dist/features/host.d.ts +9 -2
  79. package/dist/features/host.d.ts.map +1 -1
  80. package/dist/features/motion-blur/motion-blur-feature.d.ts +16 -0
  81. package/dist/features/motion-blur/motion-blur-feature.d.ts.map +1 -0
  82. package/dist/features/motion-blur/motion-blur-params.d.ts +25 -0
  83. package/dist/features/motion-blur/motion-blur-params.d.ts.map +1 -0
  84. package/dist/features/plan.d.ts +17 -2
  85. package/dist/features/plan.d.ts.map +1 -1
  86. package/dist/features/prepared-gpu-work.d.ts +3 -1
  87. package/dist/features/prepared-gpu-work.d.ts.map +1 -1
  88. package/dist/features/prepared-graphics.d.ts +2 -1
  89. package/dist/features/prepared-graphics.d.ts.map +1 -1
  90. package/dist/features/render-graph-raster.d.ts +7 -2
  91. package/dist/features/render-graph-raster.d.ts.map +1 -1
  92. package/dist/features/targets.d.ts +3 -0
  93. package/dist/features/targets.d.ts.map +1 -1
  94. package/dist/features/types.d.ts +12 -0
  95. package/dist/features/types.d.ts.map +1 -1
  96. package/dist/fullscreen-post-process-pass.d.ts +7 -1
  97. package/dist/fullscreen-post-process-pass.d.ts.map +1 -1
  98. package/dist/gpu-driven/production-raster.d.ts.map +1 -1
  99. package/dist/gpu-scene.d.ts +2 -0
  100. package/dist/gpu-scene.d.ts.map +1 -1
  101. package/dist/ibl/skylight-bind-group.d.ts +5 -6
  102. package/dist/ibl/skylight-bind-group.d.ts.map +1 -1
  103. package/dist/index.d.ts +21 -6
  104. package/dist/index.d.ts.map +1 -1
  105. package/dist/index.mjs +8 -4
  106. package/dist/index.mjs.map +1 -1
  107. package/dist/inspection-types.d.ts +46 -1
  108. package/dist/inspection-types.d.ts.map +1 -1
  109. package/dist/internal.d.ts +2 -0
  110. package/dist/internal.d.ts.map +1 -1
  111. package/dist/internal.mjs +2 -0
  112. package/dist/materials.d.ts +22 -0
  113. package/dist/materials.d.ts.map +1 -1
  114. package/dist/pbr-pipeline.d.ts +12 -6
  115. package/dist/pbr-pipeline.d.ts.map +1 -1
  116. package/dist/pipeline/standard-forward-lane.d.ts.map +1 -1
  117. package/dist/pipeline/standard-pipeline.d.ts +3 -0
  118. package/dist/pipeline/standard-pipeline.d.ts.map +1 -1
  119. package/dist/pipeline/standard-post.d.ts +48 -0
  120. package/dist/pipeline/standard-post.d.ts.map +1 -0
  121. package/dist/pipeline/standard-profile.d.ts +3 -6
  122. package/dist/pipeline/standard-profile.d.ts.map +1 -1
  123. package/dist/pipeline-builder.d.ts +18 -0
  124. package/dist/pipeline-builder.d.ts.map +1 -1
  125. package/dist/pipeline-spec.d.ts.map +1 -1
  126. package/dist/plugin.d.ts.map +1 -1
  127. package/dist/points-lines/admission.d.ts +36 -0
  128. package/dist/points-lines/admission.d.ts.map +1 -0
  129. package/dist/points-lines/bounds.d.ts +8 -0
  130. package/dist/points-lines/bounds.d.ts.map +1 -0
  131. package/dist/points-lines/expansion-cache.d.ts +28 -0
  132. package/dist/points-lines/expansion-cache.d.ts.map +1 -0
  133. package/dist/points-lines/inspection.d.ts +53 -0
  134. package/dist/points-lines/inspection.d.ts.map +1 -0
  135. package/dist/points-lines/prepare.d.ts +67 -0
  136. package/dist/points-lines/prepare.d.ts.map +1 -0
  137. package/dist/points-lines/record.d.ts +60 -0
  138. package/dist/points-lines/record.d.ts.map +1 -0
  139. package/dist/points-lines/snapshot.d.ts +49 -0
  140. package/dist/points-lines/snapshot.d.ts.map +1 -0
  141. package/dist/record/frame-lighting.d.ts.map +1 -1
  142. package/dist/record/frame-snapshot.d.ts +100 -5
  143. package/dist/record/frame-snapshot.d.ts.map +1 -1
  144. package/dist/record/frame-targets.d.ts.map +1 -1
  145. package/dist/record/frame.d.ts +4 -2
  146. package/dist/record/frame.d.ts.map +1 -1
  147. package/dist/record/main-pass-geometry.d.ts +18 -0
  148. package/dist/record/main-pass-geometry.d.ts.map +1 -1
  149. package/dist/record/main-pass-material.d.ts +8 -5
  150. package/dist/record/main-pass-material.d.ts.map +1 -1
  151. package/dist/record/main-pass-sprite-draws.d.ts +8 -1
  152. package/dist/record/main-pass-sprite-draws.d.ts.map +1 -1
  153. package/dist/record/main-pass.d.ts +2 -0
  154. package/dist/record/main-pass.d.ts.map +1 -1
  155. package/dist/record/mesh-ssbo.d.ts.map +1 -1
  156. package/dist/record/render-context.d.ts +93 -18
  157. package/dist/record/render-context.d.ts.map +1 -1
  158. package/dist/record/shadow-pass.d.ts.map +1 -1
  159. package/dist/record/skybox-post-pass.d.ts +1 -11
  160. package/dist/record/skybox-post-pass.d.ts.map +1 -1
  161. package/dist/record/typed-frame-graph.d.ts +26 -2
  162. package/dist/record/typed-frame-graph.d.ts.map +1 -1
  163. package/dist/record/view-ubo.d.ts +10 -1
  164. package/dist/record/view-ubo.d.ts.map +1 -1
  165. package/dist/render-contract.d.ts +102 -10
  166. package/dist/render-contract.d.ts.map +1 -1
  167. package/dist/render-graph-primitives.d.ts.map +1 -1
  168. package/dist/render-pipeline.d.ts +50 -6
  169. package/dist/render-pipeline.d.ts.map +1 -1
  170. package/dist/render-system-extract.d.ts +32 -5
  171. package/dist/render-system-extract.d.ts.map +1 -1
  172. package/dist/render-system.d.ts +27 -5
  173. package/dist/render-system.d.ts.map +1 -1
  174. package/dist/scene/render-scene-types.d.ts +3 -0
  175. package/dist/scene/render-scene-types.d.ts.map +1 -1
  176. package/dist/scene/render-scene.d.ts +43 -2
  177. package/dist/scene/render-scene.d.ts.map +1 -1
  178. package/dist/temporal/coverage.d.ts +42 -0
  179. package/dist/temporal/coverage.d.ts.map +1 -0
  180. package/dist/temporal/frame-coordinator.d.ts +99 -0
  181. package/dist/temporal/frame-coordinator.d.ts.map +1 -0
  182. package/dist/temporal/gpu.d.ts +39 -0
  183. package/dist/temporal/gpu.d.ts.map +1 -0
  184. package/dist/temporal/history.d.ts +37 -0
  185. package/dist/temporal/history.d.ts.map +1 -0
  186. package/dist/temporal/index.d.ts +7 -0
  187. package/dist/temporal/index.d.ts.map +1 -0
  188. package/dist/temporal/index.mjs +8 -0
  189. package/dist/temporal/index.mjs.map +1 -0
  190. package/dist/temporal/inspection.d.ts +36 -0
  191. package/dist/temporal/inspection.d.ts.map +1 -0
  192. package/dist/temporal/scene-data-catalog.d.ts +48 -0
  193. package/dist/temporal/scene-data-catalog.d.ts.map +1 -0
  194. package/dist/temporal/scene-data.d.ts +43 -0
  195. package/dist/temporal/scene-data.d.ts.map +1 -0
  196. package/dist/temporal/standard-scene-data.d.ts +61 -0
  197. package/dist/temporal/standard-scene-data.d.ts.map +1 -0
  198. package/dist/temporal/taa-history-resources.d.ts +22 -0
  199. package/dist/temporal/taa-history-resources.d.ts.map +1 -0
  200. package/dist/temporal/taa-history-store.d.ts +27 -0
  201. package/dist/temporal/taa-history-store.d.ts.map +1 -0
  202. package/dist/temporal/taa-resolve.d.ts +15 -0
  203. package/dist/temporal/taa-resolve.d.ts.map +1 -0
  204. package/dist/temporal/temporal-view.d.ts +40 -0
  205. package/dist/temporal/temporal-view.d.ts.map +1 -0
  206. package/dist/temporal/transaction.d.ts +9 -0
  207. package/dist/temporal/transaction.d.ts.map +1 -0
  208. package/dist/temporal/view.d.ts +56 -0
  209. package/dist/temporal/view.d.ts.map +1 -0
  210. package/dist/transmission/backdrop.d.ts +147 -0
  211. package/dist/transmission/backdrop.d.ts.map +1 -0
  212. package/dist/transmission/inspection.d.ts +57 -0
  213. package/dist/transmission/inspection.d.ts.map +1 -0
  214. package/dist/transmission/oracle.d.ts +42 -0
  215. package/dist/transmission/oracle.d.ts.map +1 -0
  216. package/dist/transmission/projection.d.ts +37 -0
  217. package/dist/transmission/projection.d.ts.map +1 -0
  218. package/dist/typed-render-graph-primitives.d.ts +25 -2
  219. package/dist/typed-render-graph-primitives.d.ts.map +1 -1
  220. package/package.json +24 -19
  221. package/src/__tests__/ai-user-cold-start.integration.test.ts +59 -0
  222. package/src/__tests__/ai-user-public-surface.test-d.ts +45 -0
  223. package/src/__tests__/authoring-path.unit.test.ts +9 -0
  224. package/src/__tests__/bloom-exact-zero.unit.test.ts +202 -0
  225. package/src/__tests__/bloom-lifecycle.integration.test.ts +125 -0
  226. package/src/__tests__/construct-renderer-identity.unit.test.ts +4 -3
  227. package/src/__tests__/detached-inspection.integration.test.ts +177 -0
  228. package/src/__tests__/environment-fog-lanes.integration.test.ts +219 -0
  229. package/src/__tests__/environment-generation.integration.test.ts +141 -0
  230. package/src/__tests__/environment-selection.unit.test.ts +245 -0
  231. package/src/__tests__/factory-contract.integration.test.ts +1380 -9
  232. package/src/__tests__/frame-plan-contract.unit.test.ts +90 -0
  233. package/src/__tests__/fullscreen-feature-plan.unit.test.ts +7 -0
  234. package/src/__tests__/gpu-driven-indirect-raster-evidence.ts +12 -2
  235. package/src/__tests__/gpu-driven-production.integration.test.ts +74 -22
  236. package/src/__tests__/gpu-driven-view-graph.integration.test.ts +37 -0
  237. package/src/__tests__/gpu-scene.unit.test.ts +10 -0
  238. package/src/__tests__/injection-kind-owner.test-d.ts +2 -1
  239. package/src/__tests__/material-contract-inventory.unit.test.ts +62 -0
  240. package/src/__tests__/material-cooked-projection.unit.test.ts +18 -124
  241. package/src/__tests__/material-static-dynamic-route.unit.test.ts +28 -28
  242. package/src/__tests__/materials-transmission-validation.unit.test.ts +36 -0
  243. package/src/__tests__/morph-feature-plan.unit.test.ts +7 -0
  244. package/src/__tests__/motion-blur.pixel.integration.test.ts +121 -0
  245. package/src/__tests__/public-surface.test-d.ts +15 -1
  246. package/src/__tests__/render-error-code-owner.test-d.ts +15 -0
  247. package/src/__tests__/render-error-detail-ssot.test-d.ts +11 -2
  248. package/src/__tests__/render-error-exhaustive.test-d.ts +22 -0
  249. package/src/__tests__/render-feature-errors.unit.test.ts +33 -3
  250. package/src/__tests__/render-feature-gpu-work.integration.test.ts +44 -0
  251. package/src/__tests__/render-feature-plan.test-d.ts +22 -89
  252. package/src/__tests__/render-scene-projection.unit.test.ts +28 -0
  253. package/src/__tests__/render-temporal-environment-consumer.browser.test.ts +26 -0
  254. package/src/__tests__/render-temporal-environment-consumer.dawn.test.ts +21 -0
  255. package/src/__tests__/renderer-factory-material-contract.unit.test.ts +433 -1
  256. package/src/__tests__/renderer-frame-transaction.integration.test.ts +405 -0
  257. package/src/__tests__/renderer-lifecycle.integration.test.ts +22 -0
  258. package/src/__tests__/scene-data-catalog.unit.test.ts +59 -0
  259. package/src/__tests__/scene-data-consumer.integration.test.ts +67 -0
  260. package/src/__tests__/scene-data-contract.test-d.ts +35 -0
  261. package/src/__tests__/scene-data-inspection.unit.test.ts +41 -0
  262. package/src/__tests__/scene-data-public-surface.test-d.ts +34 -0
  263. package/src/__tests__/shader-manifest-fixture.ts +111 -0
  264. package/src/__tests__/skinned-shadow-caster.test.ts +102 -0
  265. package/src/__tests__/standard-clustered-pipeline.unit.test.ts +24 -3
  266. package/src/__tests__/standard-pipeline.dawn.test.ts +15 -0
  267. package/src/__tests__/standard-pipeline.integration.test.ts +543 -1
  268. package/src/__tests__/standard-profile-oracle.unit.test.ts +10 -2
  269. package/src/__tests__/standard-temporal-producer.integration.test.ts +35 -0
  270. package/src/__tests__/surface-configuration.unit.test.ts +211 -12
  271. package/src/__tests__/taa-transaction.integration.test.ts +30 -0
  272. package/src/__tests__/temporal-admission.integration.test.ts +40 -0
  273. package/src/__tests__/temporal-coverage.unit.test.ts +35 -0
  274. package/src/__tests__/temporal-demand.unit.test.ts +44 -0
  275. package/src/__tests__/temporal-frame-coordinator.unit.test.ts +64 -0
  276. package/src/__tests__/temporal-graph-topology.unit.test.ts +51 -0
  277. package/src/__tests__/temporal-history-lifecycle.unit.test.ts +170 -0
  278. package/src/__tests__/temporal-performance.integration.test.ts +615 -0
  279. package/src/__tests__/temporal-reset-matrix.unit.test.ts +97 -0
  280. package/src/__tests__/temporal-transaction.integration.test.ts +60 -0
  281. package/src/__tests__/temporal-view.unit.test.ts +152 -0
  282. package/src/__tests__/transmission-prewarm.unit.test.ts +93 -0
  283. package/src/__tests__/typed-pipeline-topology.unit.test.ts +230 -1
  284. package/src/__tests__/urp-pipeline-targets.unit.test.ts +25 -1
  285. package/src/__tests__/urp-pipeline.unit.test.ts +4 -3
  286. package/src/__tests__/visibility-extract.integration.test.ts +27 -1
  287. package/src/__tests__/visibility-producer-matrix.integration.test.ts +10 -0
  288. package/src/assembly/backend-contract.ts +47 -1
  289. package/src/assembly/factory.ts +1295 -507
  290. package/src/assembly/host-contract.ts +4 -0
  291. package/src/assembly/material/assembly.ts +2 -5
  292. package/src/assembly/renderer-frame-transaction.ts +75 -0
  293. package/src/assembly/renderer-inspection.ts +112 -0
  294. package/src/assembly/renderer-lifecycle.ts +6 -0
  295. package/src/authoring.ts +1 -0
  296. package/src/components/__tests__/motion-blur.unit.test.ts +14 -0
  297. package/src/components/__tests__/points-lines-admission.unit.test.ts +219 -0
  298. package/src/components/__tests__/points-lines-schema.unit.test.ts +56 -0
  299. package/src/components/__tests__/schema-contract.unit.test.ts +6 -1
  300. package/src/components/atmosphere.ts +10 -0
  301. package/src/components/camera.ts +2 -1
  302. package/src/components/fog.ts +9 -0
  303. package/src/components/index.ts +10 -0
  304. package/src/components/lines.ts +18 -0
  305. package/src/components/motion-blur.ts +8 -0
  306. package/src/components/points.ts +40 -0
  307. package/src/construct-renderer.ts +40 -3
  308. package/src/device/device-scope.ts +15 -1
  309. package/src/environment/frame.ts +185 -0
  310. package/src/environment/generation.ts +23 -0
  311. package/src/environment/graph.ts +9 -0
  312. package/src/environment/inspection.ts +87 -0
  313. package/src/environment/lifecycle.ts +250 -0
  314. package/src/environment/signature.ts +55 -0
  315. package/src/errors/render.ts +429 -1
  316. package/src/extract/camera.ts +78 -0
  317. package/src/extract/environment.ts +171 -0
  318. package/src/extract/visibility.ts +38 -19
  319. package/src/features/host.ts +36 -5
  320. package/src/features/motion-blur/__tests__/motion-blur-feature.unit.test.ts +67 -0
  321. package/src/features/motion-blur/__tests__/motion-blur-params.unit.test.ts +53 -0
  322. package/src/features/motion-blur/motion-blur-feature.ts +119 -0
  323. package/src/features/motion-blur/motion-blur-params.ts +89 -0
  324. package/src/features/plan.ts +32 -3
  325. package/src/features/prepared-gpu-work.ts +21 -6
  326. package/src/features/prepared-graphics.ts +2 -1
  327. package/src/features/render-graph-raster.ts +24 -4
  328. package/src/features/targets.ts +24 -2
  329. package/src/features/types.ts +13 -0
  330. package/src/fullscreen-post-process-pass.ts +34 -4
  331. package/src/gpu-driven/production-raster.ts +6 -1
  332. package/src/gpu-scene.ts +24 -0
  333. package/src/ibl/skylight-bind-group.ts +30 -38
  334. package/src/index.ts +83 -6
  335. package/src/inspection-types.ts +52 -0
  336. package/src/internal.ts +5 -0
  337. package/src/materials.ts +119 -24
  338. package/src/pbr-pipeline.ts +66 -20
  339. package/src/pipeline/standard-forward-lane.ts +158 -101
  340. package/src/pipeline/standard-pipeline.ts +156 -105
  341. package/src/pipeline/standard-post.ts +373 -0
  342. package/src/pipeline/standard-profile.ts +11 -11
  343. package/src/pipeline-builder.ts +102 -12
  344. package/src/pipeline-spec.ts +9 -0
  345. package/src/plugin.ts +6 -0
  346. package/src/points-lines/__tests__/bounds.unit.test.ts +21 -0
  347. package/src/points-lines/__tests__/cache-recovery.unit.test.ts +157 -0
  348. package/src/points-lines/__tests__/inspection-lanes.integration.test.ts +146 -0
  349. package/src/points-lines/__tests__/inspection.unit.test.ts +173 -0
  350. package/src/points-lines/__tests__/lane-structural.integration.test.ts +122 -0
  351. package/src/points-lines/__tests__/points-lines.bench.ts +400 -0
  352. package/src/points-lines/__tests__/raster-lane.integration.test.ts +44 -0
  353. package/src/points-lines/__tests__/snapshot.unit.test.ts +101 -0
  354. package/src/points-lines/__tests__/view-ubo.unit.test.ts +73 -0
  355. package/src/points-lines/admission.ts +238 -0
  356. package/src/points-lines/bounds.ts +23 -0
  357. package/src/points-lines/expansion-cache.ts +215 -0
  358. package/src/points-lines/inspection.ts +97 -0
  359. package/src/points-lines/prepare.ts +177 -0
  360. package/src/points-lines/record.ts +125 -0
  361. package/src/points-lines/snapshot.ts +130 -0
  362. package/src/record/__tests__/fullscreen-temporal-routing.unit.test.ts +25 -0
  363. package/src/record/__tests__/main-pass-geometry.unit.test.ts +47 -0
  364. package/src/record/__tests__/material-bg-cache.unit.test.ts +12 -1
  365. package/src/record/__tests__/material-pipeline-pending-cache.unit.test.ts +22 -0
  366. package/src/record/__tests__/sprite-material-abi.unit.test.ts +75 -0
  367. package/src/record/__tests__/standard-pbr-ubo-layout.unit.test.ts +67 -0
  368. package/src/record/__tests__/temporal-payload.unit.test.ts +164 -0
  369. package/src/record/__tests__/typed-frame-graph-plan.unit.test.ts +127 -0
  370. package/src/record/frame-lighting.ts +14 -2
  371. package/src/record/frame-snapshot.ts +129 -5
  372. package/src/record/frame-targets.ts +15 -6
  373. package/src/record/frame.ts +119 -4
  374. package/src/record/main-pass-geometry.ts +178 -40
  375. package/src/record/main-pass-material.ts +114 -66
  376. package/src/record/main-pass-sprite-draws.ts +79 -102
  377. package/src/record/main-pass.ts +83 -7
  378. package/src/record/mesh-ssbo.ts +22 -3
  379. package/src/record/render-context.ts +209 -23
  380. package/src/record/shadow-pass.ts +129 -28
  381. package/src/record/skybox-post-pass.ts +99 -42
  382. package/src/record/typed-frame-graph.ts +582 -42
  383. package/src/record/view-ubo.ts +99 -4
  384. package/src/render-contract.ts +121 -7
  385. package/src/render-graph-primitives.ts +18 -1
  386. package/src/render-pipeline.ts +100 -27
  387. package/src/render-system-extract.ts +264 -77
  388. package/src/render-system.ts +786 -43
  389. package/src/scene/render-scene-types.ts +3 -0
  390. package/src/scene/render-scene.ts +307 -9
  391. package/src/temporal/__tests__/taa-history-resources.unit.test.ts +45 -0
  392. package/src/temporal/coverage.ts +76 -0
  393. package/src/temporal/frame-coordinator.ts +311 -0
  394. package/src/temporal/gpu.ts +287 -0
  395. package/src/temporal/history.ts +92 -0
  396. package/src/temporal/index.ts +6 -0
  397. package/src/temporal/inspection.ts +97 -0
  398. package/src/temporal/scene-data-catalog.ts +200 -0
  399. package/src/temporal/scene-data.ts +149 -0
  400. package/src/temporal/standard-scene-data.ts +182 -0
  401. package/src/temporal/taa-history-resources.ts +128 -0
  402. package/src/temporal/taa-history-store.ts +79 -0
  403. package/src/temporal/taa-resolve.ts +34 -0
  404. package/src/temporal/temporal-view.ts +169 -0
  405. package/src/temporal/transaction.ts +17 -0
  406. package/src/temporal/view.ts +161 -0
  407. package/src/transmission/__tests__/capability.unit.test.ts +83 -0
  408. package/src/transmission/__tests__/composition.integration.test.ts +161 -0
  409. package/src/transmission/__tests__/inspection.unit.test.ts +241 -0
  410. package/src/transmission/__tests__/lifecycle.integration.test.ts +96 -0
  411. package/src/transmission/__tests__/oracle.unit.test.ts +131 -0
  412. package/src/transmission/__tests__/projection.unit.test.ts +71 -0
  413. package/src/transmission/__tests__/standard-transmission.dawn.test.ts +438 -0
  414. package/src/transmission/__tests__/transmission-backdrop-topology.unit.test.ts +109 -0
  415. package/src/transmission/__tests__/transmission-backdrop.dawn.test.ts +105 -0
  416. package/src/transmission/backdrop.ts +572 -0
  417. package/src/transmission/inspection.ts +190 -0
  418. package/src/transmission/oracle.ts +141 -0
  419. package/src/transmission/projection.ts +83 -0
  420. package/src/typed-render-graph-primitives.ts +162 -9
  421. package/dist/__tests__/authoring-path.unit.test.d.ts +0 -2
  422. package/dist/__tests__/authoring-path.unit.test.d.ts.map +0 -1
  423. package/dist/__tests__/backend-selection-rhi-capture.test-d.d.ts +0 -2
  424. package/dist/__tests__/backend-selection-rhi-capture.test-d.d.ts.map +0 -1
  425. package/dist/__tests__/callback-inference.test-d.d.ts +0 -2
  426. package/dist/__tests__/callback-inference.test-d.d.ts.map +0 -1
  427. package/dist/__tests__/cluster-binner.test.d.ts +0 -2
  428. package/dist/__tests__/cluster-binner.test.d.ts.map +0 -1
  429. package/dist/__tests__/cluster-grid-default-surface.unit.test.d.ts +0 -2
  430. package/dist/__tests__/cluster-grid-default-surface.unit.test.d.ts.map +0 -1
  431. package/dist/__tests__/construct-renderer-identity.unit.test.d.ts +0 -2
  432. package/dist/__tests__/construct-renderer-identity.unit.test.d.ts.map +0 -1
  433. package/dist/__tests__/device-scope-lifecycle.unit.test.d.ts +0 -2
  434. package/dist/__tests__/device-scope-lifecycle.unit.test.d.ts.map +0 -1
  435. package/dist/__tests__/device-scope-stale-matrix.unit.test.d.ts +0 -2
  436. package/dist/__tests__/device-scope-stale-matrix.unit.test.d.ts.map +0 -1
  437. package/dist/__tests__/direct-extract-consumer-contract.test-d.d.ts +0 -2
  438. package/dist/__tests__/direct-extract-consumer-contract.test-d.d.ts.map +0 -1
  439. package/dist/__tests__/direct-light-snapshot.unit.test.d.ts +0 -2
  440. package/dist/__tests__/direct-light-snapshot.unit.test.d.ts.map +0 -1
  441. package/dist/__tests__/factory-contract.integration.test.d.ts +0 -2
  442. package/dist/__tests__/factory-contract.integration.test.d.ts.map +0 -1
  443. package/dist/__tests__/fallback-row-stride-surface.unit.test.d.ts +0 -2
  444. package/dist/__tests__/fallback-row-stride-surface.unit.test.d.ts.map +0 -1
  445. package/dist/__tests__/frame-observation.contract.test.d.ts +0 -2
  446. package/dist/__tests__/frame-observation.contract.test.d.ts.map +0 -1
  447. package/dist/__tests__/fullscreen-feature-plan.unit.test.d.ts +0 -2
  448. package/dist/__tests__/fullscreen-feature-plan.unit.test.d.ts.map +0 -1
  449. package/dist/__tests__/glyph-text-layout-recovery.unit.test.d.ts +0 -2
  450. package/dist/__tests__/glyph-text-layout-recovery.unit.test.d.ts.map +0 -1
  451. package/dist/__tests__/gpu-driven-indirect-raster-evidence.d.ts +0 -6
  452. package/dist/__tests__/gpu-driven-indirect-raster-evidence.d.ts.map +0 -1
  453. package/dist/__tests__/gpu-driven-indirect-raster.browser.test.d.ts +0 -2
  454. package/dist/__tests__/gpu-driven-indirect-raster.browser.test.d.ts.map +0 -1
  455. package/dist/__tests__/gpu-driven-indirect-raster.dawn.test.d.ts +0 -2
  456. package/dist/__tests__/gpu-driven-indirect-raster.dawn.test.d.ts.map +0 -1
  457. package/dist/__tests__/gpu-driven-production.integration.test.d.ts +0 -2
  458. package/dist/__tests__/gpu-driven-production.integration.test.d.ts.map +0 -1
  459. package/dist/__tests__/gpu-driven-scaling.unit.test.d.ts +0 -2
  460. package/dist/__tests__/gpu-driven-scaling.unit.test.d.ts.map +0 -1
  461. package/dist/__tests__/gpu-driven-view-gpu-evidence.d.ts +0 -18
  462. package/dist/__tests__/gpu-driven-view-gpu-evidence.d.ts.map +0 -1
  463. package/dist/__tests__/gpu-driven-view-graph.integration.test.d.ts +0 -2
  464. package/dist/__tests__/gpu-driven-view-graph.integration.test.d.ts.map +0 -1
  465. package/dist/__tests__/gpu-driven-view-reference.d.ts +0 -15
  466. package/dist/__tests__/gpu-driven-view-reference.d.ts.map +0 -1
  467. package/dist/__tests__/gpu-driven-view.browser.test.d.ts +0 -2
  468. package/dist/__tests__/gpu-driven-view.browser.test.d.ts.map +0 -1
  469. package/dist/__tests__/gpu-driven-view.dawn.test.d.ts +0 -2
  470. package/dist/__tests__/gpu-driven-view.dawn.test.d.ts.map +0 -1
  471. package/dist/__tests__/gpu-driven-view.unit.test.d.ts +0 -2
  472. package/dist/__tests__/gpu-driven-view.unit.test.d.ts.map +0 -1
  473. package/dist/__tests__/gpu-resource-store-stride.unit.test.d.ts +0 -2
  474. package/dist/__tests__/gpu-resource-store-stride.unit.test.d.ts.map +0 -1
  475. package/dist/__tests__/gpu-scene-render-graph-gpu.d.ts +0 -7
  476. package/dist/__tests__/gpu-scene-render-graph-gpu.d.ts.map +0 -1
  477. package/dist/__tests__/gpu-scene-render-graph.browser.test.d.ts +0 -2
  478. package/dist/__tests__/gpu-scene-render-graph.browser.test.d.ts.map +0 -1
  479. package/dist/__tests__/gpu-scene-render-graph.dawn.test.d.ts +0 -2
  480. package/dist/__tests__/gpu-scene-render-graph.dawn.test.d.ts.map +0 -1
  481. package/dist/__tests__/gpu-scene-schema.unit.test.d.ts +0 -2
  482. package/dist/__tests__/gpu-scene-schema.unit.test.d.ts.map +0 -1
  483. package/dist/__tests__/gpu-scene.dawn.test.d.ts +0 -2
  484. package/dist/__tests__/gpu-scene.dawn.test.d.ts.map +0 -1
  485. package/dist/__tests__/gpu-scene.unit.test.d.ts +0 -2
  486. package/dist/__tests__/gpu-scene.unit.test.d.ts.map +0 -1
  487. package/dist/__tests__/ibl/face-uniforms.unit.test.d.ts +0 -2
  488. package/dist/__tests__/ibl/face-uniforms.unit.test.d.ts.map +0 -1
  489. package/dist/__tests__/infinite-grid-no-vertex-probe.unit.test.d.ts +0 -2
  490. package/dist/__tests__/infinite-grid-no-vertex-probe.unit.test.d.ts.map +0 -1
  491. package/dist/__tests__/injection-kind-owner.test-d.d.ts +0 -2
  492. package/dist/__tests__/injection-kind-owner.test-d.d.ts.map +0 -1
  493. package/dist/__tests__/ktx2-basis-gpu-consumer.dawn.test.d.ts +0 -2
  494. package/dist/__tests__/ktx2-basis-gpu-consumer.dawn.test.d.ts.map +0 -1
  495. package/dist/__tests__/light-buffer-layout.unit.test.d.ts +0 -2
  496. package/dist/__tests__/light-buffer-layout.unit.test.d.ts.map +0 -1
  497. package/dist/__tests__/material-contract-inventory.unit.test.d.ts +0 -2
  498. package/dist/__tests__/material-contract-inventory.unit.test.d.ts.map +0 -1
  499. package/dist/__tests__/material-cooked-projection.unit.test.d.ts +0 -2
  500. package/dist/__tests__/material-cooked-projection.unit.test.d.ts.map +0 -1
  501. package/dist/__tests__/material-snapshot-mutation.integration.test.d.ts +0 -2
  502. package/dist/__tests__/material-snapshot-mutation.integration.test.d.ts.map +0 -1
  503. package/dist/__tests__/material-static-dynamic-route.unit.test.d.ts +0 -2
  504. package/dist/__tests__/material-static-dynamic-route.unit.test.d.ts.map +0 -1
  505. package/dist/__tests__/material-stride-surface.unit.test.d.ts +0 -2
  506. package/dist/__tests__/material-stride-surface.unit.test.d.ts.map +0 -1
  507. package/dist/__tests__/mesh-buffer-usage-surface.unit.test.d.ts +0 -2
  508. package/dist/__tests__/mesh-buffer-usage-surface.unit.test.d.ts.map +0 -1
  509. package/dist/__tests__/mesh-material-bindings.unit.test.d.ts +0 -2
  510. package/dist/__tests__/mesh-material-bindings.unit.test.d.ts.map +0 -1
  511. package/dist/__tests__/mesh-stride-surface.unit.test.d.ts +0 -2
  512. package/dist/__tests__/mesh-stride-surface.unit.test.d.ts.map +0 -1
  513. package/dist/__tests__/morph-culling-reentry.dawn.test.d.ts +0 -2
  514. package/dist/__tests__/morph-culling-reentry.dawn.test.d.ts.map +0 -1
  515. package/dist/__tests__/morph-feature-gpu-work.integration.test.d.ts +0 -2
  516. package/dist/__tests__/morph-feature-gpu-work.integration.test.d.ts.map +0 -1
  517. package/dist/__tests__/morph-feature-plan.unit.test.d.ts +0 -2
  518. package/dist/__tests__/morph-feature-plan.unit.test.d.ts.map +0 -1
  519. package/dist/__tests__/morph-visual-evidence.integration.test.d.ts +0 -2
  520. package/dist/__tests__/morph-visual-evidence.integration.test.d.ts.map +0 -1
  521. package/dist/__tests__/nineslice-handle-surface.unit.test.d.ts +0 -2
  522. package/dist/__tests__/nineslice-handle-surface.unit.test.d.ts.map +0 -1
  523. package/dist/__tests__/post-process-error-policy-owner.unit.test.d.ts +0 -2
  524. package/dist/__tests__/post-process-error-policy-owner.unit.test.d.ts.map +0 -1
  525. package/dist/__tests__/prepared-buffer-kind-owner.test-d.d.ts +0 -2
  526. package/dist/__tests__/prepared-buffer-kind-owner.test-d.d.ts.map +0 -1
  527. package/dist/__tests__/prepared-graphics-capability.unit.test.d.ts +0 -2
  528. package/dist/__tests__/prepared-graphics-capability.unit.test.d.ts.map +0 -1
  529. package/dist/__tests__/prepared-graphics-generation.unit.test.d.ts +0 -2
  530. package/dist/__tests__/prepared-graphics-generation.unit.test.d.ts.map +0 -1
  531. package/dist/__tests__/prepared-graphics-lifecycle.unit.test.d.ts +0 -2
  532. package/dist/__tests__/prepared-graphics-lifecycle.unit.test.d.ts.map +0 -1
  533. package/dist/__tests__/prepared-graphics-pipeline-warmup.unit.test.d.ts +0 -2
  534. package/dist/__tests__/prepared-graphics-pipeline-warmup.unit.test.d.ts.map +0 -1
  535. package/dist/__tests__/prepared-graphics-resolver.unit.test.d.ts +0 -2
  536. package/dist/__tests__/prepared-graphics-resolver.unit.test.d.ts.map +0 -1
  537. package/dist/__tests__/prepared-graphics-snapshot.unit.test.d.ts +0 -2
  538. package/dist/__tests__/prepared-graphics-snapshot.unit.test.d.ts.map +0 -1
  539. package/dist/__tests__/prepared-graphics-store.unit.test.d.ts +0 -2
  540. package/dist/__tests__/prepared-graphics-store.unit.test.d.ts.map +0 -1
  541. package/dist/__tests__/prepared-graphics-validation.unit.test.d.ts +0 -2
  542. package/dist/__tests__/prepared-graphics-validation.unit.test.d.ts.map +0 -1
  543. package/dist/__tests__/profiler-default-off.test.d.ts +0 -2
  544. package/dist/__tests__/profiler-default-off.test.d.ts.map +0 -1
  545. package/dist/__tests__/profiler-phase-catalog.test.d.ts +0 -2
  546. package/dist/__tests__/profiler-phase-catalog.test.d.ts.map +0 -1
  547. package/dist/__tests__/profiler-phase-integration.test.d.ts +0 -2
  548. package/dist/__tests__/profiler-phase-integration.test.d.ts.map +0 -1
  549. package/dist/__tests__/profiler-phase-token.test.d.ts +0 -2
  550. package/dist/__tests__/profiler-phase-token.test.d.ts.map +0 -1
  551. package/dist/__tests__/public-surface.test-d.d.ts +0 -2
  552. package/dist/__tests__/public-surface.test-d.d.ts.map +0 -1
  553. package/dist/__tests__/recover-error-policy-owner.unit.test.d.ts +0 -2
  554. package/dist/__tests__/recover-error-policy-owner.unit.test.d.ts.map +0 -1
  555. package/dist/__tests__/render-error-code-owner.test-d.d.ts +0 -2
  556. package/dist/__tests__/render-error-code-owner.test-d.d.ts.map +0 -1
  557. package/dist/__tests__/render-error-detail-ssot.test-d.d.ts +0 -2
  558. package/dist/__tests__/render-error-detail-ssot.test-d.d.ts.map +0 -1
  559. package/dist/__tests__/render-error-exhaustive.test-d.d.ts +0 -2
  560. package/dist/__tests__/render-error-exhaustive.test-d.d.ts.map +0 -1
  561. package/dist/__tests__/render-feature-assembly.test-d.d.ts +0 -2
  562. package/dist/__tests__/render-feature-assembly.test-d.d.ts.map +0 -1
  563. package/dist/__tests__/render-feature-context.test-d.d.ts +0 -2
  564. package/dist/__tests__/render-feature-context.test-d.d.ts.map +0 -1
  565. package/dist/__tests__/render-feature-contract.test-d.d.ts +0 -2
  566. package/dist/__tests__/render-feature-contract.test-d.d.ts.map +0 -1
  567. package/dist/__tests__/render-feature-diagnostics.unit.test.d.ts +0 -2
  568. package/dist/__tests__/render-feature-diagnostics.unit.test.d.ts.map +0 -1
  569. package/dist/__tests__/render-feature-docs.unit.test.d.ts +0 -2
  570. package/dist/__tests__/render-feature-docs.unit.test.d.ts.map +0 -1
  571. package/dist/__tests__/render-feature-errors.unit.test.d.ts +0 -2
  572. package/dist/__tests__/render-feature-errors.unit.test.d.ts.map +0 -1
  573. package/dist/__tests__/render-feature-gpu-work.integration.test.d.ts +0 -2
  574. package/dist/__tests__/render-feature-gpu-work.integration.test.d.ts.map +0 -1
  575. package/dist/__tests__/render-feature-plan.test-d.d.ts +0 -2
  576. package/dist/__tests__/render-feature-plan.test-d.d.ts.map +0 -1
  577. package/dist/__tests__/render-feature-plan.unit.test.d.ts +0 -2
  578. package/dist/__tests__/render-feature-plan.unit.test.d.ts.map +0 -1
  579. package/dist/__tests__/render-feature-prepared-diagnostics.unit.test.d.ts +0 -2
  580. package/dist/__tests__/render-feature-prepared-diagnostics.unit.test.d.ts.map +0 -1
  581. package/dist/__tests__/render-feature-prepared-errors.test-d.d.ts +0 -2
  582. package/dist/__tests__/render-feature-prepared-errors.test-d.d.ts.map +0 -1
  583. package/dist/__tests__/render-feature-prepared-graphics-docs.unit.test.d.ts +0 -2
  584. package/dist/__tests__/render-feature-prepared-graphics-docs.unit.test.d.ts.map +0 -1
  585. package/dist/__tests__/render-feature-prepared-graphics-isolation.unit.test.d.ts +0 -2
  586. package/dist/__tests__/render-feature-prepared-graphics-isolation.unit.test.d.ts.map +0 -1
  587. package/dist/__tests__/render-feature-prepared-graphics-negative.test-d.d.ts +0 -2
  588. package/dist/__tests__/render-feature-prepared-graphics-negative.test-d.d.ts.map +0 -1
  589. package/dist/__tests__/render-feature-prepared-graphics.test-d.d.ts +0 -2
  590. package/dist/__tests__/render-feature-prepared-graphics.test-d.d.ts.map +0 -1
  591. package/dist/__tests__/render-feature-prepared-graphics.unit.test.d.ts +0 -2
  592. package/dist/__tests__/render-feature-prepared-graphics.unit.test.d.ts.map +0 -1
  593. package/dist/__tests__/render-feature-public-surface.test-d.d.ts +0 -2
  594. package/dist/__tests__/render-feature-public-surface.test-d.d.ts.map +0 -1
  595. package/dist/__tests__/render-feature-retry.unit.test.d.ts +0 -2
  596. package/dist/__tests__/render-feature-retry.unit.test.d.ts.map +0 -1
  597. package/dist/__tests__/render-feature-scheduling.unit.test.d.ts +0 -2
  598. package/dist/__tests__/render-feature-scheduling.unit.test.d.ts.map +0 -1
  599. package/dist/__tests__/render-feature-stage-failed-policy-owner.unit.test.d.ts +0 -2
  600. package/dist/__tests__/render-feature-stage-failed-policy-owner.unit.test.d.ts.map +0 -1
  601. package/dist/__tests__/render-feature-stage-fault-recovery.unit.test.d.ts +0 -2
  602. package/dist/__tests__/render-feature-stage-fault-recovery.unit.test.d.ts.map +0 -1
  603. package/dist/__tests__/render-feature-visibility-context.test-d.d.ts +0 -2
  604. package/dist/__tests__/render-feature-visibility-context.test-d.d.ts.map +0 -1
  605. package/dist/__tests__/render-feature-visibility-context.unit.test.d.ts +0 -2
  606. package/dist/__tests__/render-feature-visibility-context.unit.test.d.ts.map +0 -1
  607. package/dist/__tests__/render-feature-zero-work.unit.test.d.ts +0 -2
  608. package/dist/__tests__/render-feature-zero-work.unit.test.d.ts.map +0 -1
  609. package/dist/__tests__/render-graph-compute-raster-gpu.d.ts +0 -7
  610. package/dist/__tests__/render-graph-compute-raster-gpu.d.ts.map +0 -1
  611. package/dist/__tests__/render-graph-compute-raster.browser.test.d.ts +0 -2
  612. package/dist/__tests__/render-graph-compute-raster.browser.test.d.ts.map +0 -1
  613. package/dist/__tests__/render-graph-compute-raster.dawn.test.d.ts +0 -2
  614. package/dist/__tests__/render-graph-compute-raster.dawn.test.d.ts.map +0 -1
  615. package/dist/__tests__/render-graph-hzb-gpu.d.ts +0 -7
  616. package/dist/__tests__/render-graph-hzb-gpu.d.ts.map +0 -1
  617. package/dist/__tests__/render-graph-hzb.browser.test.d.ts +0 -2
  618. package/dist/__tests__/render-graph-hzb.browser.test.d.ts.map +0 -1
  619. package/dist/__tests__/render-graph-hzb.dawn.test.d.ts +0 -2
  620. package/dist/__tests__/render-graph-hzb.dawn.test.d.ts.map +0 -1
  621. package/dist/__tests__/render-graph-primitives.unit.test.d.ts +0 -2
  622. package/dist/__tests__/render-graph-primitives.unit.test.d.ts.map +0 -1
  623. package/dist/__tests__/render-graph-storage-indirect-gpu.d.ts +0 -12
  624. package/dist/__tests__/render-graph-storage-indirect-gpu.d.ts.map +0 -1
  625. package/dist/__tests__/render-graph-storage-indirect.browser.test.d.ts +0 -2
  626. package/dist/__tests__/render-graph-storage-indirect.browser.test.d.ts.map +0 -1
  627. package/dist/__tests__/render-graph-storage-indirect.dawn.test.d.ts +0 -2
  628. package/dist/__tests__/render-graph-storage-indirect.dawn.test.d.ts.map +0 -1
  629. package/dist/__tests__/render-scene-projection.unit.test.d.ts +0 -2
  630. package/dist/__tests__/render-scene-projection.unit.test.d.ts.map +0 -1
  631. package/dist/__tests__/renderer-factory-material-contract.unit.test.d.ts +0 -2
  632. package/dist/__tests__/renderer-factory-material-contract.unit.test.d.ts.map +0 -1
  633. package/dist/__tests__/renderer-lifecycle.integration.test.d.ts +0 -2
  634. package/dist/__tests__/renderer-lifecycle.integration.test.d.ts.map +0 -1
  635. package/dist/__tests__/rhi-backend-package-boundary.unit.test.d.ts +0 -2
  636. package/dist/__tests__/rhi-backend-package-boundary.unit.test.d.ts.map +0 -1
  637. package/dist/__tests__/scriptable-pack-consumer.test-d.d.ts +0 -2
  638. package/dist/__tests__/scriptable-pack-consumer.test-d.d.ts.map +0 -1
  639. package/dist/__tests__/shader-stage-surface.unit.test.d.ts +0 -2
  640. package/dist/__tests__/shader-stage-surface.unit.test.d.ts.map +0 -1
  641. package/dist/__tests__/ssao-config.unit.test.d.ts +0 -2
  642. package/dist/__tests__/ssao-config.unit.test.d.ts.map +0 -1
  643. package/dist/__tests__/ssao-kernel-surface.unit.test.d.ts +0 -2
  644. package/dist/__tests__/ssao-kernel-surface.unit.test.d.ts.map +0 -1
  645. package/dist/__tests__/standard-clustered-pipeline.unit.test.d.ts +0 -2
  646. package/dist/__tests__/standard-clustered-pipeline.unit.test.d.ts.map +0 -1
  647. package/dist/__tests__/standard-descriptors.test-d.d.ts +0 -2
  648. package/dist/__tests__/standard-descriptors.test-d.d.ts.map +0 -1
  649. package/dist/__tests__/standard-pipeline.dawn.test.d.ts +0 -2
  650. package/dist/__tests__/standard-pipeline.dawn.test.d.ts.map +0 -1
  651. package/dist/__tests__/standard-pipeline.integration.test.d.ts +0 -2
  652. package/dist/__tests__/standard-pipeline.integration.test.d.ts.map +0 -1
  653. package/dist/__tests__/standard-profile-oracle.unit.test.d.ts +0 -2
  654. package/dist/__tests__/standard-profile-oracle.unit.test.d.ts.map +0 -1
  655. package/dist/__tests__/surface-configuration.unit.test.d.ts +0 -2
  656. package/dist/__tests__/surface-configuration.unit.test.d.ts.map +0 -1
  657. package/dist/__tests__/texture-usage-surface.unit.test.d.ts +0 -2
  658. package/dist/__tests__/texture-usage-surface.unit.test.d.ts.map +0 -1
  659. package/dist/__tests__/typed-pipeline-topology.unit.test.d.ts +0 -2
  660. package/dist/__tests__/typed-pipeline-topology.unit.test.d.ts.map +0 -1
  661. package/dist/__tests__/urp-pipeline-targets.unit.test.d.ts +0 -2
  662. package/dist/__tests__/urp-pipeline-targets.unit.test.d.ts.map +0 -1
  663. package/dist/__tests__/urp-pipeline.unit.test.d.ts +0 -2
  664. package/dist/__tests__/urp-pipeline.unit.test.d.ts.map +0 -1
  665. package/dist/__tests__/vertex-color-pipeline.unit.test.d.ts +0 -2
  666. package/dist/__tests__/vertex-color-pipeline.unit.test.d.ts.map +0 -1
  667. package/dist/__tests__/vertex-layout-consumer.unit.test.d.ts +0 -2
  668. package/dist/__tests__/vertex-layout-consumer.unit.test.d.ts.map +0 -1
  669. package/dist/__tests__/visibility-diagnostics.integration.test.d.ts +0 -2
  670. package/dist/__tests__/visibility-diagnostics.integration.test.d.ts.map +0 -1
  671. package/dist/__tests__/visibility-extract.integration.test.d.ts +0 -2
  672. package/dist/__tests__/visibility-extract.integration.test.d.ts.map +0 -1
  673. package/dist/__tests__/visibility-extract.perf.test.d.ts +0 -2
  674. package/dist/__tests__/visibility-extract.perf.test.d.ts.map +0 -1
  675. package/dist/__tests__/visibility-feature-dedup.integration.test.d.ts +0 -2
  676. package/dist/__tests__/visibility-feature-dedup.integration.test.d.ts.map +0 -1
  677. package/dist/__tests__/visibility-hidden-report.unit.test.d.ts +0 -2
  678. package/dist/__tests__/visibility-hidden-report.unit.test.d.ts.map +0 -1
  679. package/dist/__tests__/visibility-instances.integration.test.d.ts +0 -2
  680. package/dist/__tests__/visibility-instances.integration.test.d.ts.map +0 -1
  681. package/dist/__tests__/visibility-multi-world.integration.test.d.ts +0 -2
  682. package/dist/__tests__/visibility-multi-world.integration.test.d.ts.map +0 -1
  683. package/dist/__tests__/visibility-producer-matrix.integration.test.d.ts +0 -2
  684. package/dist/__tests__/visibility-producer-matrix.integration.test.d.ts.map +0 -1
  685. package/dist/__tests__/visibility-producer-matrix.unit.test.d.ts +0 -2
  686. package/dist/__tests__/visibility-producer-matrix.unit.test.d.ts.map +0 -1
  687. package/dist/__tests__/visibility-public-surface.test-d.d.ts +0 -2
  688. package/dist/__tests__/visibility-public-surface.test-d.d.ts.map +0 -1
  689. package/dist/__tests__/visibility-resolver.unit.test.d.ts +0 -2
  690. package/dist/__tests__/visibility-resolver.unit.test.d.ts.map +0 -1
  691. package/dist/__tests__/visibility-resource-short-circuit.unit.test.d.ts +0 -2
  692. package/dist/__tests__/visibility-resource-short-circuit.unit.test.d.ts.map +0 -1
  693. package/dist/__tests__/visibility-snapshot-contract.unit.test.d.ts +0 -2
  694. package/dist/__tests__/visibility-snapshot-contract.unit.test.d.ts.map +0 -1
  695. package/dist/__tests__/vocabulary.unit.test.d.ts +0 -2
  696. package/dist/__tests__/vocabulary.unit.test.d.ts.map +0 -1
  697. package/dist/chunk-CQXZC5XI.mjs.map +0 -1
  698. package/dist/chunk-QC4VW3XJ.mjs.map +0 -1
  699. package/dist/chunk-SCRSAK5B.mjs.map +0 -1
  700. package/dist/components/__tests__/schema-contract.unit.test.d.ts +0 -2
  701. package/dist/components/__tests__/schema-contract.unit.test.d.ts.map +0 -1
  702. package/dist/components/__tests__/schema-parity.unit.test.d.ts +0 -2
  703. package/dist/components/__tests__/schema-parity.unit.test.d.ts.map +0 -1
  704. package/dist/components/__tests__/visibility-schema.unit.test.d.ts +0 -2
  705. package/dist/components/__tests__/visibility-schema.unit.test.d.ts.map +0 -1
  706. package/dist/record/__tests__/material-bg-cache.unit.test.d.ts +0 -2
  707. package/dist/record/__tests__/material-bg-cache.unit.test.d.ts.map +0 -1
  708. package/dist/record/__tests__/material-slot-plan.unit.test.d.ts +0 -2
  709. package/dist/record/__tests__/material-slot-plan.unit.test.d.ts.map +0 -1
  710. package/dist/record/__tests__/typed-frame-graph-plan.unit.test.d.ts +0 -2
  711. package/dist/record/__tests__/typed-frame-graph-plan.unit.test.d.ts.map +0 -1
  712. package/dist/record/__tests__/video-texture-view.unit.test.d.ts +0 -2
  713. package/dist/record/__tests__/video-texture-view.unit.test.d.ts.map +0 -1
@@ -0,0 +1,400 @@
1
+ import { World } from '@forgeax/engine-ecs';
2
+ import { buildMeshAttributeMapForUvSets } from '@forgeax/engine-geometry';
3
+ import { buildProfileModel, createProfiler } from '@forgeax/engine-profiler';
4
+ import {
5
+ Camera,
6
+ Lines,
7
+ Materials,
8
+ MeshFilter,
9
+ MeshRenderer,
10
+ PointShapeValue,
11
+ Points,
12
+ perspective,
13
+ } from '@forgeax/engine-render';
14
+ import type { RhiRenderPassEncoder } from '@forgeax/engine-rhi';
15
+ import { rhi } from '@forgeax/engine-rhi-null';
16
+ import { Transform } from '@forgeax/engine-scene';
17
+ import { err, type MeshAsset, ok } from '@forgeax/engine-types';
18
+ import { bench, describe } from 'vitest';
19
+ import { createRenderer as constructRenderer } from '../../assembly/factory';
20
+ import { recordPointsLinesDraw } from '../../record/main-pass-geometry';
21
+ import { admitPointsLines } from '../admission';
22
+ import { PointsLinesExpansionCache } from '../expansion-cache';
23
+ import { type PointsLinesGpuResourceAdapter, PointsLinesPreparation } from '../prepare';
24
+ import { createPointsLinesLaneContract, createPointsLinesRecordPlan } from '../record';
25
+ import { createPointsLinesSnapshot } from '../snapshot';
26
+
27
+ const POINT_COUNT = 10_000;
28
+ const SEGMENT_COUNT = 10_000;
29
+ const SAMPLE_COUNT = 30;
30
+ const BENCH_OPTIONS = { iterations: SAMPLE_COUNT } as const;
31
+
32
+ function buildMesh(topology: 'point-list' | 'line-list'): MeshAsset {
33
+ const vertexCount = topology === 'point-list' ? POINT_COUNT : SEGMENT_COUNT * 2;
34
+ const vertices = new Float32Array(vertexCount * 3);
35
+ const attributes = new Float32Array(vertices);
36
+ for (let index = 0; index < vertexCount; index += 1) {
37
+ const offset = index * 3;
38
+ vertices[offset] = (index % 100) / 50 - 1;
39
+ vertices[offset + 1] = Math.floor(index / 100) / 100 - 1;
40
+ vertices[offset + 2] = 0;
41
+ }
42
+ const indices = topology === 'line-list' ? new Uint32Array(vertexCount) : undefined;
43
+ if (indices !== undefined) {
44
+ for (let index = 0; index < indices.length; index += 1) indices[index] = index;
45
+ }
46
+ return {
47
+ kind: 'mesh',
48
+ vertices,
49
+ ...(indices === undefined ? {} : { indices }),
50
+ attributes: { ...buildMeshAttributeMapForUvSets(1), position: attributes },
51
+ aabb: new Float32Array([-1, -1, 0, 1, 1, 0]),
52
+ submeshes: [
53
+ {
54
+ indexOffset: 0,
55
+ indexCount: topology === 'line-list' ? vertexCount : 0,
56
+ vertexCount,
57
+ topology,
58
+ materialSlot: 0,
59
+ },
60
+ ],
61
+ materialSlots: [{ slotName: 'points-lines-bench' }],
62
+ };
63
+ }
64
+
65
+ function snapshot(component: 'Points' | 'Lines') {
66
+ return createPointsLinesSnapshot({
67
+ worldId: 0,
68
+ entityKey: component === 'Points' ? 10 : 11,
69
+ component,
70
+ meshHandle: 99,
71
+ meshGeneration: 1,
72
+ materialHandle: 100,
73
+ materialGeneration: 1,
74
+ style:
75
+ component === 'Points'
76
+ ? { kind: 'points', sizePx: 8, shape: 'circle' }
77
+ : { kind: 'lines', widthPx: 3 },
78
+ layer: 0,
79
+ visible: true,
80
+ sourceBounds: [-1, -1, 0, 1, 1, 0],
81
+ viewport: { width: 1280, height: 720, dpr: 1 },
82
+ projection: new Float32Array(16),
83
+ });
84
+ }
85
+
86
+ const MATERIAL = Materials.unlit([0.1, 0.9, 1, 1], { castShadow: false });
87
+
88
+ function manifestUrl(): string {
89
+ return `data:application/json,${encodeURIComponent(JSON.stringify({ schemaVersion: '1.0.0', entries: [] }))}`;
90
+ }
91
+
92
+ function buildDirectMesh(): MeshAsset {
93
+ const vertices = new Float32Array(POINT_COUNT * 3);
94
+ for (let index = 0; index < POINT_COUNT; index += 1) {
95
+ const offset = index * 3;
96
+ vertices[offset] = (index % 100) / 50 - 1;
97
+ vertices[offset + 1] = Math.floor(index / 100) / 100 - 1;
98
+ }
99
+ const indices = new Uint32Array(Math.floor(POINT_COUNT / 3) * 3);
100
+ for (let index = 0; index < indices.length; index += 1) indices[index] = index;
101
+ return {
102
+ kind: 'mesh',
103
+ vertices,
104
+ indices,
105
+ attributes: { ...buildMeshAttributeMapForUvSets(1), position: new Float32Array(vertices) },
106
+ aabb: new Float32Array([-1, -1, 0, 1, 1, 0]),
107
+ submeshes: [
108
+ {
109
+ indexOffset: 0,
110
+ indexCount: indices.length,
111
+ vertexCount: POINT_COUNT,
112
+ topology: 'triangle-list',
113
+ materialSlot: 0,
114
+ },
115
+ ],
116
+ materialSlots: [{ slotName: 'points-lines-direct-baseline' }],
117
+ };
118
+ }
119
+
120
+ type RealRoute = {
121
+ readonly renderer: Awaited<ReturnType<typeof constructRenderer>>;
122
+ readonly profiler: ReturnType<typeof createProfiler>;
123
+ readonly pointsLines: {
124
+ readonly world: World;
125
+ readonly lease: import('../../render-contract').RenderWorldLease;
126
+ };
127
+ readonly direct: {
128
+ readonly world: World;
129
+ readonly lease: import('../../render-contract').RenderWorldLease;
130
+ };
131
+ };
132
+
133
+ function makeRealScene(
134
+ renderer: RealRoute['renderer'],
135
+ meshes: { readonly points: MeshAsset; readonly lines: MeshAsset },
136
+ component: 'points-lines' | 'direct',
137
+ ): RealRoute['pointsLines'] {
138
+ const world = new World();
139
+ const materialHandle = world.allocSharedRef('MaterialAsset', MATERIAL);
140
+ if (component === 'points-lines') {
141
+ const pointMeshHandle = world.allocSharedRef('MeshAsset', meshes.points);
142
+ const lineMeshHandle = world.allocSharedRef('MeshAsset', meshes.lines);
143
+ world
144
+ .spawn(
145
+ {
146
+ component: Transform,
147
+ data: { pos: [-0.5, 0, -2], quat: [0, 0, 0, 1], scale: [1, 1, 1] },
148
+ },
149
+ { component: MeshFilter, data: { assetHandle: pointMeshHandle } },
150
+ { component: MeshRenderer, data: { materials: [materialHandle] } },
151
+ { component: Points, data: { sizePx: 8, shape: PointShapeValue.circle } },
152
+ )
153
+ .unwrap();
154
+ world
155
+ .spawn(
156
+ { component: Transform, data: { pos: [0.5, 0, -2], quat: [0, 0, 0, 1], scale: [1, 1, 1] } },
157
+ { component: MeshFilter, data: { assetHandle: lineMeshHandle } },
158
+ { component: MeshRenderer, data: { materials: [materialHandle] } },
159
+ { component: Lines, data: { widthPx: 3 } },
160
+ )
161
+ .unwrap();
162
+ } else {
163
+ const meshHandle = world.allocSharedRef('MeshAsset', meshes.points);
164
+ for (const x of [-0.5, 0.5]) {
165
+ world
166
+ .spawn(
167
+ { component: Transform, data: { pos: [x, 0, -2], quat: [0, 0, 0, 1], scale: [1, 1, 1] } },
168
+ { component: MeshFilter, data: { assetHandle: meshHandle } },
169
+ { component: MeshRenderer, data: { materials: [materialHandle] } },
170
+ )
171
+ .unwrap();
172
+ }
173
+ }
174
+ world
175
+ .spawn(
176
+ { component: Transform, data: { pos: [0, 0, 3], quat: [0, 0, 0, 1], scale: [1, 1, 1] } },
177
+ { component: Camera, data: { ...perspective({ fov: Math.PI / 4, aspect: 16 / 9 }) } },
178
+ )
179
+ .unwrap();
180
+ const attached = renderer.attach(world);
181
+ if (!attached.ok) throw attached.error;
182
+ world.update().unwrap();
183
+ return { world, lease: attached.value };
184
+ }
185
+
186
+ async function createRealRoute(): Promise<RealRoute> {
187
+ const profiler = createProfiler();
188
+ const renderer = await constructRenderer(
189
+ { getContext: () => null },
190
+ { rhi, profiler },
191
+ { shaderManifestUrl: manifestUrl() },
192
+ );
193
+ return {
194
+ renderer,
195
+ profiler,
196
+ pointsLines: makeRealScene(renderer, { points: POINT_MESH, lines: LINE_MESH }, 'points-lines'),
197
+ direct: makeRealScene(
198
+ renderer,
199
+ { points: buildDirectMesh(), lines: buildDirectMesh() },
200
+ 'direct',
201
+ ),
202
+ };
203
+ }
204
+
205
+ function drawRealFrame(route: RealRoute, scene: RealRoute['pointsLines']): void {
206
+ const drawn = route.renderer.draw({
207
+ leases: [scene.lease],
208
+ camera: { lease: scene.lease },
209
+ environment: { lease: scene.lease },
210
+ });
211
+ if (!drawn.ok) throw drawn.error;
212
+ }
213
+
214
+ async function captureProfile(route: RealRoute, scene: RealRoute['pointsLines']) {
215
+ const capture = route.profiler.startCapture({
216
+ frameLimit: 1,
217
+ eventLimit: 10_000,
218
+ detail: 'nested',
219
+ });
220
+ if (!capture.ok) throw capture.error;
221
+ drawRealFrame(route, scene);
222
+ const finished = capture.value.finish();
223
+ if (!finished.ok) throw finished.error;
224
+ const model = buildProfileModel(finished.value);
225
+ if (!model.ok) throw model.error;
226
+ return model.value;
227
+ }
228
+
229
+ type BenchResource = { readonly geometryKey: string; readonly bytes: number };
230
+
231
+ const RESOURCE_ADAPTER: PointsLinesGpuResourceAdapter<BenchResource> = {
232
+ create: (geometry) => ok({ geometryKey: geometry.key, bytes: 0 }),
233
+ upload: (_resource, geometry) => ok(geometry.derivedBytes),
234
+ validate: (_resource, geometry) =>
235
+ geometry.expandedVertexCount > 0 && geometry.expandedIndexCount > 0
236
+ ? ok(undefined)
237
+ : err(new Error('benchmark expansion is not drawable')),
238
+ destroy: () => undefined,
239
+ };
240
+
241
+ function prepareWorkload(
242
+ component: 'Points' | 'Lines',
243
+ mesh: MeshAsset,
244
+ cache: PointsLinesExpansionCache,
245
+ preparation = new PointsLinesPreparation({ cache, adapter: RESOURCE_ADAPTER }),
246
+ ) {
247
+ const authored =
248
+ component === 'Points' ? { points: { sizePx: 8, shape: 1 } } : { lines: { widthPx: 3 } };
249
+ const admission = admitPointsLines({
250
+ entity: component === 'Points' ? 10 : 11,
251
+ mesh,
252
+ material: MATERIAL,
253
+ ...authored,
254
+ });
255
+ if (!admission.ok) throw admission.error;
256
+ const retained = snapshot(component);
257
+ const prepared = preparation.prepare(retained, mesh);
258
+ if (!prepared.ok) throw prepared.error;
259
+ const plan = createPointsLinesRecordPlan(
260
+ retained,
261
+ prepared.value.geometry,
262
+ createPointsLinesLaneContract('direct', 'webgpu'),
263
+ );
264
+ const draws: string[] = [];
265
+ const pass = {
266
+ draw: () => draws.push('draw'),
267
+ drawIndexed: () => draws.push('drawIndexed'),
268
+ } as unknown as RhiRenderPassEncoder;
269
+ recordPointsLinesDraw(pass, plan);
270
+ if (draws.length !== 1) throw new Error(`${component} record path emitted ${draws.length} draws`);
271
+ return { geometry: prepared.value.geometry, plan, preparation, draws };
272
+ }
273
+
274
+ function preparePair(
275
+ cache: PointsLinesExpansionCache,
276
+ pointMesh: MeshAsset,
277
+ lineMesh: MeshAsset,
278
+ preparations?: {
279
+ points?: PointsLinesPreparation<BenchResource>;
280
+ lines?: PointsLinesPreparation<BenchResource>;
281
+ },
282
+ ) {
283
+ const points = prepareWorkload('Points', pointMesh, cache, preparations?.points);
284
+ const lines = prepareWorkload('Lines', lineMesh, cache, preparations?.lines);
285
+ return { points, lines };
286
+ }
287
+
288
+ function validateWorkload(pointMesh: MeshAsset, lineMesh: MeshAsset): void {
289
+ const cache = new PointsLinesExpansionCache();
290
+ const pair = preparePair(cache, pointMesh, lineMesh);
291
+ const primitiveCount = POINT_COUNT + SEGMENT_COUNT;
292
+ if (pair.points.geometry === pair.lines.geometry) {
293
+ throw new Error('Points and Lines must not share an expansion cache entry');
294
+ }
295
+ if (pair.points.geometry.expandedVertexCount !== POINT_COUNT * 4) {
296
+ throw new Error('Points expansion vertex count mismatch');
297
+ }
298
+ if (pair.lines.geometry.expandedIndexCount !== SEGMENT_COUNT * 6) {
299
+ throw new Error('Lines expansion index count mismatch');
300
+ }
301
+ if (pair.points.plan.drawCount !== 1 || pair.lines.plan.drawCount !== 1) {
302
+ throw new Error('Visible Points and Lines must each record one draw');
303
+ }
304
+ if (
305
+ pair.points.geometry.expandedVertexCount + pair.lines.geometry.expandedVertexCount >
306
+ primitiveCount * 4
307
+ ) {
308
+ throw new Error('Expanded vertex bound exceeded');
309
+ }
310
+ if (
311
+ pair.points.geometry.expandedIndexCount + pair.lines.geometry.expandedIndexCount >
312
+ primitiveCount * 6
313
+ ) {
314
+ throw new Error('Expanded index bound exceeded');
315
+ }
316
+ const offPath = cache.getOrCreate(
317
+ { ...snapshot('Points'), component: undefined, style: undefined },
318
+ pointMesh,
319
+ );
320
+ if (offPath.derivedBytes !== 0 || offPath.expandedVertexCount !== 0) {
321
+ throw new Error('Off-path geometry must remain exact-zero');
322
+ }
323
+ if (offPath.derivedBytes !== 0) throw new Error('off-path derived bytes changed');
324
+ }
325
+
326
+ const POINT_MESH = buildMesh('point-list');
327
+ const LINE_MESH = buildMesh('line-list');
328
+ validateWorkload(POINT_MESH, LINE_MESH);
329
+ const REAL_ROUTE = await createRealRoute();
330
+ const REAL_PROFILE = await captureProfile(REAL_ROUTE, REAL_ROUTE.pointsLines);
331
+ const DIRECT_PROFILE = await captureProfile(REAL_ROUTE, REAL_ROUTE.direct);
332
+
333
+ function phaseDeltas(): Readonly<Record<string, number>> {
334
+ const direct = new Map(
335
+ DIRECT_PROFILE?.phases.map((phase) => [
336
+ `${phase.source}:${phase.phase}`,
337
+ phase.p95DurationMicros ?? 0,
338
+ ]) ?? [],
339
+ );
340
+ return Object.fromEntries(
341
+ REAL_PROFILE?.phases.map((phase) => {
342
+ const key = `${phase.source}:${phase.phase}`;
343
+ return [key, (phase.p95DurationMicros ?? 0) - (direct.get(key) ?? 0)];
344
+ }) ?? [],
345
+ );
346
+ }
347
+
348
+ // biome-ignore lint/suspicious/noConsole: benchmark emits machine-readable evidence
349
+ console.info(
350
+ JSON.stringify({
351
+ workload: { points: POINT_COUNT, segments: SEGMENT_COUNT, samples: SAMPLE_COUNT },
352
+ route: 'Renderer.extract-prepare-record',
353
+ baseline: 'same-Renderer.direct-mesh',
354
+ phases: phaseDeltas(),
355
+ gpuTiming: {
356
+ status: 'blocked',
357
+ reason: 'no adapter-qualified timestamp owner exists for this RhiNull runner',
358
+ },
359
+ }),
360
+ );
361
+ let sink = 0;
362
+
363
+ describe('Points/Lines 10k + 10k benchmark', () => {
364
+ bench(
365
+ 'same-Renderer direct baseline',
366
+ () => {
367
+ drawRealFrame(REAL_ROUTE, REAL_ROUTE.direct);
368
+ sink ^= REAL_ROUTE.renderer.inspect().frame.frameId;
369
+ },
370
+ BENCH_OPTIONS,
371
+ );
372
+
373
+ bench(
374
+ 'Renderer extract prepare record',
375
+ () => {
376
+ drawRealFrame(REAL_ROUTE, REAL_ROUTE.pointsLines);
377
+ sink ^= REAL_ROUTE.renderer.inspect().renderScene.pointsLines?.length ?? 0;
378
+ },
379
+ BENCH_OPTIONS,
380
+ );
381
+
382
+ bench(
383
+ 'Renderer warm extract prepare record',
384
+ () => {
385
+ drawRealFrame(REAL_ROUTE, REAL_ROUTE.pointsLines);
386
+ sink ^= REAL_ROUTE.renderer.inspect().renderScene.pointsLines?.length ?? 0;
387
+ },
388
+ BENCH_OPTIONS,
389
+ );
390
+
391
+ bench(
392
+ 'Renderer inspection after record',
393
+ () => {
394
+ sink ^= REAL_ROUTE.renderer.inspect().renderScene.pointsLines?.length ?? 0;
395
+ },
396
+ BENCH_OPTIONS,
397
+ );
398
+
399
+ void sink;
400
+ });
@@ -0,0 +1,44 @@
1
+ import { describe, expect, it } from 'vitest';
2
+ import { createPointsLinesLaneContract, type PointsLinesLane } from '../record';
3
+
4
+ const lanes: readonly PointsLinesLane[] = ['direct', 'clustered', 'cpu-webgl2'];
5
+
6
+ describe('Points/Lines raster lane integration contract', () => {
7
+ it.each(lanes)('%s consumes one unlit material and the existing graph', (lane) => {
8
+ const contract = createPointsLinesLaneContract(lane, 'webgpu');
9
+
10
+ expect(contract.lane).toBe(lane);
11
+ expect(contract.material.shadingModel).toBe('unlit');
12
+ expect(contract.material.source).toBe('MaterialAsset');
13
+ expect(contract.graph.additionalAttachments).toBe(0);
14
+ expect(contract.graph.additionalPasses).toBe(0);
15
+ expect(contract.shadowDrawCount).toBe(0);
16
+ });
17
+
18
+ it('keeps clustered points and lines on the unlit route', () => {
19
+ const contract = createPointsLinesLaneContract('clustered', 'webgpu');
20
+
21
+ expect(contract.material.shadingModel).toBe('unlit');
22
+ expect(contract.material.clusteredLighting).toBe(false);
23
+ expect(contract.material.lit).toBe(false);
24
+ });
25
+
26
+ it('does not request compute, storage, or indirect features on CPU-WebGL2', () => {
27
+ const contract = createPointsLinesLaneContract('cpu-webgl2', 'wgpu-webgl2');
28
+
29
+ expect(contract.capabilities.compute).toBe(false);
30
+ expect(contract.capabilities.storage).toBe(false);
31
+ expect(contract.capabilities.indirect).toBe(false);
32
+ expect(contract.graph.additionalAttachments).toBe(0);
33
+ expect(contract.graph.additionalPasses).toBe(0);
34
+ });
35
+
36
+ it('labels RhiNull as structural-only and keeps the same authoring contract', () => {
37
+ const contract = createPointsLinesLaneContract('direct', 'null');
38
+
39
+ expect(contract.evidence).toBe('structural-only');
40
+ expect(contract.authoring).toBe('shared');
41
+ expect(contract.graph.additionalAttachments).toBe(0);
42
+ expect(contract.graph.additionalPasses).toBe(0);
43
+ });
44
+ });
@@ -0,0 +1,101 @@
1
+ import { describe, expect, it } from 'vitest';
2
+ import {
3
+ comparePointsLinesSnapshots,
4
+ createPointsLinesSnapshot,
5
+ type PointsLinesRetainedSnapshot,
6
+ } from '../snapshot';
7
+
8
+ function snapshotInput(): Parameters<typeof createPointsLinesSnapshot>[0] {
9
+ return {
10
+ worldId: 3,
11
+ entityKey: 17,
12
+ component: 'Points',
13
+ meshHandle: 11,
14
+ meshGeneration: 4,
15
+ materialHandle: 23,
16
+ materialGeneration: 8,
17
+ style: { kind: 'points', sizePx: 6, shape: 'circle' },
18
+ layer: 12,
19
+ sortKey: -2,
20
+ visible: true,
21
+ sourceBounds: new Float32Array([-1, -2, -3, 1, 2, 3]),
22
+ viewport: { width: 800, height: 600, dpr: 2 },
23
+ projection: new Float32Array(16),
24
+ };
25
+ }
26
+
27
+ describe('Points/Lines retained snapshot', () => {
28
+ it('detaches ECS identity, owner generations, style, and view facts', () => {
29
+ const source = snapshotInput();
30
+ const snapshot = createPointsLinesSnapshot(source);
31
+
32
+ expect(snapshot).toEqual<PointsLinesRetainedSnapshot>({
33
+ worldId: 3,
34
+ entityKey: 17,
35
+ component: 'Points',
36
+ meshHandle: 11,
37
+ meshGeneration: 4,
38
+ materialHandle: 23,
39
+ materialGeneration: 8,
40
+ style: { kind: 'points', sizePx: 6, shape: 'circle' },
41
+ layer: 12,
42
+ sortKey: -2,
43
+ visible: true,
44
+ sourceBounds: new Float32Array([-1, -2, -3, 1, 2, 3]),
45
+ viewport: { width: 800, height: 600, dpr: 2 },
46
+ projection: new Float32Array(16),
47
+ });
48
+ expect(snapshot).not.toHaveProperty('world');
49
+ expect(snapshot.sourceBounds).not.toBe(source.sourceBounds);
50
+ expect(snapshot.projection).not.toBe(source.projection);
51
+ });
52
+
53
+ it('classifies only owner generations and style as geometry invalidation', () => {
54
+ const base = createPointsLinesSnapshot(snapshotInput());
55
+
56
+ expect(
57
+ comparePointsLinesSnapshots(
58
+ base,
59
+ createPointsLinesSnapshot({ ...snapshotInput(), meshGeneration: 5 }),
60
+ ),
61
+ ).toBe('mesh');
62
+ expect(
63
+ comparePointsLinesSnapshots(
64
+ base,
65
+ createPointsLinesSnapshot({ ...snapshotInput(), materialGeneration: 9 }),
66
+ ),
67
+ ).toBe('material');
68
+ expect(
69
+ comparePointsLinesSnapshots(
70
+ base,
71
+ createPointsLinesSnapshot({
72
+ ...snapshotInput(),
73
+ style: { kind: 'points', sizePx: 8, shape: 'square' },
74
+ }),
75
+ ),
76
+ ).toBe('style');
77
+ expect(
78
+ comparePointsLinesSnapshots(
79
+ base,
80
+ createPointsLinesSnapshot({
81
+ ...snapshotInput(),
82
+ viewport: { width: 1600, height: 1200, dpr: 2 },
83
+ }),
84
+ ),
85
+ ).toBe('view');
86
+ expect(
87
+ comparePointsLinesSnapshots(base, createPointsLinesSnapshot({ ...snapshotInput() })),
88
+ ).toBe('none');
89
+ expect(base).not.toHaveProperty('derived');
90
+ });
91
+
92
+ it('records a dedicated-resource zero when the style component is absent', () => {
93
+ const snapshot = createPointsLinesSnapshot({
94
+ ...snapshotInput(),
95
+ component: undefined,
96
+ style: undefined,
97
+ });
98
+
99
+ expect(snapshot).toMatchObject({ component: undefined, dedicatedResourceBytes: 0 });
100
+ });
101
+ });
@@ -0,0 +1,73 @@
1
+ import { vec3 } from '@forgeax/engine-math';
2
+ import type { Buffer, RhiQueue } from '@forgeax/engine-rhi';
3
+ import { ok } from '@forgeax/engine-types';
4
+ import { describe, expect, it } from 'vitest';
5
+ import { POINTS_LINES_VIEW_SLOT_STRIDE, writePointsLinesViewUbo } from '../../record/view-ubo';
6
+ import type { CameraSnapshot } from '../../render-contract';
7
+
8
+ function camera(): CameraSnapshot {
9
+ return {
10
+ position: vec3.create(0, 0, 3),
11
+ world: new Float32Array([1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 3, 1]),
12
+ fov: Math.PI / 4,
13
+ aspect: 16 / 9,
14
+ near: 0.1,
15
+ far: 100,
16
+ projection: 'perspective',
17
+ orthoLeft: -1,
18
+ orthoRight: 1,
19
+ orthoBottom: -1,
20
+ orthoTop: 1,
21
+ tonemap: 'none',
22
+ exposure: 1,
23
+ whitePoint: 4,
24
+ antialias: 'none',
25
+ bloom: 'off',
26
+ bloomThreshold: 1,
27
+ bloomIntensity: 1,
28
+ bloomBlurRadius: 4,
29
+ clearColor: [0, 0, 0, 1],
30
+ };
31
+ }
32
+
33
+ describe('Points/Lines per-draw view slots', () => {
34
+ it('writes distinct transforms and styles at distinct dynamic offsets', () => {
35
+ const writes: Array<{ offset: number; payload: Float32Array }> = [];
36
+ const queue = {
37
+ writeBuffer: (_buffer: Buffer, offset: number, payload: Float32Array) => {
38
+ writes.push({ offset, payload: new Float32Array(payload) });
39
+ return ok(undefined);
40
+ },
41
+ } as unknown as RhiQueue;
42
+ const buffer = {} as Buffer;
43
+ const firstModel = new Float32Array([1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 2, 0, 0, 1]);
44
+ const secondModel = new Float32Array([1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, -2, 0, 0, 1]);
45
+
46
+ writePointsLinesViewUbo(
47
+ queue,
48
+ buffer,
49
+ camera(),
50
+ 640,
51
+ 360,
52
+ firstModel,
53
+ { kind: 'points', sizePx: 16, shape: 'circle' },
54
+ 0,
55
+ );
56
+ writePointsLinesViewUbo(
57
+ queue,
58
+ buffer,
59
+ camera(),
60
+ 640,
61
+ 360,
62
+ secondModel,
63
+ { kind: 'lines', widthPx: 4 },
64
+ POINTS_LINES_VIEW_SLOT_STRIDE,
65
+ );
66
+
67
+ expect(writes.map(({ offset }) => offset)).toEqual([0, POINTS_LINES_VIEW_SLOT_STRIDE]);
68
+ expect(writes[0]?.payload[28]).toBe(2);
69
+ expect(writes[1]?.payload[28]).toBe(-2);
70
+ expect(writes[0]?.payload.slice(36, 40)).toEqual(new Float32Array([16, 0, 1, 0]));
71
+ expect(writes[1]?.payload.slice(36, 40)).toEqual(new Float32Array([4, 1, 0, 0]));
72
+ });
73
+ });