@forgeax/engine-render 0.1.4 → 0.1.6

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 (918) hide show
  1. package/README.md +130 -641
  2. package/dist/.tsbuildinfo +1 -1
  3. package/dist/__tests__/device-scope-lifecycle.unit.test.d.ts +2 -0
  4. package/dist/__tests__/device-scope-lifecycle.unit.test.d.ts.map +1 -0
  5. package/dist/__tests__/device-scope-stale-matrix.unit.test.d.ts +2 -0
  6. package/dist/__tests__/device-scope-stale-matrix.unit.test.d.ts.map +1 -0
  7. package/dist/__tests__/fullscreen-feature-plan.unit.test.d.ts +2 -0
  8. package/dist/__tests__/fullscreen-feature-plan.unit.test.d.ts.map +1 -0
  9. package/dist/__tests__/gpu-driven-indirect-raster-evidence.d.ts.map +1 -1
  10. package/dist/__tests__/gpu-driven-view-gpu-evidence.d.ts +6 -0
  11. package/dist/__tests__/gpu-driven-view-gpu-evidence.d.ts.map +1 -1
  12. package/dist/{gpu-driven/view-reference.d.ts → __tests__/gpu-driven-view-reference.d.ts} +4 -4
  13. package/dist/__tests__/gpu-driven-view-reference.d.ts.map +1 -0
  14. package/dist/__tests__/gpu-scene-render-graph-gpu.d.ts.map +1 -1
  15. package/dist/__tests__/ibl/face-uniforms.unit.test.d.ts +2 -0
  16. package/dist/__tests__/ibl/face-uniforms.unit.test.d.ts.map +1 -0
  17. package/dist/__tests__/morph-feature-plan.unit.test.d.ts +2 -0
  18. package/dist/__tests__/morph-feature-plan.unit.test.d.ts.map +1 -0
  19. package/dist/__tests__/render-feature-plan.test-d.d.ts +2 -0
  20. package/dist/__tests__/render-feature-plan.test-d.d.ts.map +1 -0
  21. package/dist/__tests__/render-feature-plan.unit.test.d.ts +2 -0
  22. package/dist/__tests__/render-feature-plan.unit.test.d.ts.map +1 -0
  23. package/dist/__tests__/ssao-config.unit.test.d.ts +2 -0
  24. package/dist/__tests__/ssao-config.unit.test.d.ts.map +1 -0
  25. package/dist/__tests__/standard-clustered-pipeline.unit.test.d.ts +2 -0
  26. package/dist/__tests__/standard-clustered-pipeline.unit.test.d.ts.map +1 -0
  27. package/dist/__tests__/standard-descriptors.test-d.d.ts +2 -0
  28. package/dist/__tests__/standard-descriptors.test-d.d.ts.map +1 -0
  29. package/dist/__tests__/standard-pipeline.dawn.test.d.ts +2 -0
  30. package/dist/__tests__/standard-pipeline.dawn.test.d.ts.map +1 -0
  31. package/dist/__tests__/standard-pipeline.integration.test.d.ts +2 -0
  32. package/dist/__tests__/standard-pipeline.integration.test.d.ts.map +1 -0
  33. package/dist/__tests__/standard-profile-oracle.unit.test.d.ts +2 -0
  34. package/dist/__tests__/standard-profile-oracle.unit.test.d.ts.map +1 -0
  35. package/dist/__tests__/visibility-resource-short-circuit.unit.test.d.ts +2 -0
  36. package/dist/__tests__/visibility-resource-short-circuit.unit.test.d.ts.map +1 -0
  37. package/dist/{renderer/backend-selection.d.ts → assembly/backend-contract.d.ts} +15 -4
  38. package/dist/assembly/backend-contract.d.ts.map +1 -0
  39. package/dist/assembly/factory.d.ts +207 -0
  40. package/dist/assembly/factory.d.ts.map +1 -0
  41. package/dist/assembly/host-contract.d.ts +84 -0
  42. package/dist/assembly/host-contract.d.ts.map +1 -0
  43. package/dist/{renderer → assembly}/material/assembly.d.ts +0 -1
  44. package/dist/{renderer → assembly}/material/assembly.d.ts.map +1 -1
  45. package/dist/assembly/material/pipeline-projection.d.ts +30 -0
  46. package/dist/assembly/material/pipeline-projection.d.ts.map +1 -0
  47. package/dist/authoring.d.ts +10 -11
  48. package/dist/authoring.d.ts.map +1 -1
  49. package/dist/authoring.mjs +25 -3
  50. package/dist/authoring.mjs.map +1 -1
  51. package/dist/chunk-CQXZC5XI.mjs +182 -0
  52. package/dist/chunk-CQXZC5XI.mjs.map +1 -0
  53. package/dist/chunk-QC4VW3XJ.mjs +79 -0
  54. package/dist/chunk-QC4VW3XJ.mjs.map +1 -0
  55. package/dist/chunk-SCRSAK5B.mjs +480 -0
  56. package/dist/chunk-SCRSAK5B.mjs.map +1 -0
  57. package/dist/components/__tests__/schema-contract.unit.test.d.ts +2 -0
  58. package/dist/components/__tests__/schema-contract.unit.test.d.ts.map +1 -0
  59. package/dist/components/glyph-text.d.ts +1 -1
  60. package/dist/components/glyph-text.d.ts.map +1 -1
  61. package/dist/components/index.d.ts +2 -2
  62. package/dist/components/index.d.ts.map +1 -1
  63. package/dist/components/instances.d.ts +1 -1
  64. package/dist/components/instances.d.ts.map +1 -1
  65. package/dist/components/light-helpers.d.ts +1 -1
  66. package/dist/components/light-helpers.d.ts.map +1 -1
  67. package/dist/components/mesh-filter.d.ts +7 -7
  68. package/dist/components/mesh-filter.d.ts.map +1 -1
  69. package/dist/components/scene-instance.d.ts +11 -11
  70. package/dist/components/skybox-background.d.ts +56 -0
  71. package/dist/components/skybox-background.d.ts.map +1 -0
  72. package/dist/components/skylight.d.ts +55 -0
  73. package/dist/components/skylight.d.ts.map +1 -0
  74. package/dist/components/sprite-animation.d.ts +2 -3
  75. package/dist/components/sprite-animation.d.ts.map +1 -1
  76. package/dist/components/sprite-instances.d.ts +1 -1
  77. package/dist/components/sprite-playback-mode.d.ts +6 -1
  78. package/dist/components/sprite-playback-mode.d.ts.map +1 -1
  79. package/dist/components/sprite-region-override.d.ts +2 -3
  80. package/dist/components/sprite-region-override.d.ts.map +1 -1
  81. package/dist/components/tile-layer.d.ts +5 -0
  82. package/dist/components/tile-layer.d.ts.map +1 -1
  83. package/dist/construct-renderer.d.ts +18 -1
  84. package/dist/construct-renderer.d.ts.map +1 -1
  85. package/dist/construct-renderer.mjs +27008 -4
  86. package/dist/construct-renderer.mjs.map +1 -1
  87. package/dist/debug-draw-glue.d.ts +2 -53
  88. package/dist/debug-draw-glue.d.ts.map +1 -1
  89. package/dist/device/device-scope.d.ts +83 -0
  90. package/dist/device/device-scope.d.ts.map +1 -0
  91. package/dist/{gpu-resource-store.d.ts → device/gpu-residency.d.ts} +91 -48
  92. package/dist/device/gpu-residency.d.ts.map +1 -0
  93. package/dist/device/resource-types.d.ts +8 -0
  94. package/dist/device/resource-types.d.ts.map +1 -0
  95. package/dist/engine-metrics.d.ts +2 -2
  96. package/dist/engine-metrics.d.ts.map +1 -1
  97. package/dist/errors/recover.d.ts +28 -1
  98. package/dist/errors/recover.d.ts.map +1 -1
  99. package/dist/errors/render.d.ts +249 -258
  100. package/dist/errors/render.d.ts.map +1 -1
  101. package/dist/features/fullscreen.d.ts +19 -0
  102. package/dist/features/fullscreen.d.ts.map +1 -0
  103. package/dist/features/host.d.ts +32 -26
  104. package/dist/features/host.d.ts.map +1 -1
  105. package/dist/features/morph/morph-feature.d.ts +39 -5
  106. package/dist/features/morph/morph-feature.d.ts.map +1 -1
  107. package/dist/features/plan.d.ts +182 -0
  108. package/dist/features/plan.d.ts.map +1 -0
  109. package/dist/features/prepared-gpu-work.d.ts +21 -17
  110. package/dist/features/prepared-gpu-work.d.ts.map +1 -1
  111. package/dist/features/prepared-graphics-store.d.ts +2 -1
  112. package/dist/features/prepared-graphics-store.d.ts.map +1 -1
  113. package/dist/features/prepared-graphics.d.ts +11 -21
  114. package/dist/features/prepared-graphics.d.ts.map +1 -1
  115. package/dist/features/render-graph-compute.d.ts +2 -2
  116. package/dist/features/render-graph-compute.d.ts.map +1 -1
  117. package/dist/features/render-graph-contribution.d.ts +4 -7
  118. package/dist/features/render-graph-contribution.d.ts.map +1 -1
  119. package/dist/features/render-graph-raster.d.ts +2 -2
  120. package/dist/features/render-graph-raster.d.ts.map +1 -1
  121. package/dist/features/render-graph-resources.d.ts +6 -6
  122. package/dist/features/render-graph-resources.d.ts.map +1 -1
  123. package/dist/features/targets.d.ts +5 -5
  124. package/dist/features/targets.d.ts.map +1 -1
  125. package/dist/features/types.d.ts +11 -190
  126. package/dist/features/types.d.ts.map +1 -1
  127. package/dist/features/vocabulary.d.ts +14 -0
  128. package/dist/features/vocabulary.d.ts.map +1 -0
  129. package/dist/fullscreen-post-process-pass.d.ts +4 -25
  130. package/dist/fullscreen-post-process-pass.d.ts.map +1 -1
  131. package/dist/glyph-text-layout-system.d.ts +3 -2
  132. package/dist/glyph-text-layout-system.d.ts.map +1 -1
  133. package/dist/gpu-driven/batch-topology.d.ts +6 -75
  134. package/dist/gpu-driven/batch-topology.d.ts.map +1 -1
  135. package/dist/gpu-driven/production-raster.d.ts +13 -112
  136. package/dist/gpu-driven/production-raster.d.ts.map +1 -1
  137. package/dist/gpu-driven/view-gpu.d.ts +10 -66
  138. package/dist/gpu-driven/view-gpu.d.ts.map +1 -1
  139. package/dist/gpu-resource.d.ts +3 -3
  140. package/dist/gpu-scene-schema.d.ts +1 -94
  141. package/dist/gpu-scene-schema.d.ts.map +1 -1
  142. package/dist/gpu-scene.d.ts +7 -33
  143. package/dist/gpu-scene.d.ts.map +1 -1
  144. package/dist/hdrp-buffers.d.ts +3 -53
  145. package/dist/hdrp-buffers.d.ts.map +1 -1
  146. package/dist/ibl/IblPipelineCache.d.ts +74 -180
  147. package/dist/ibl/IblPipelineCache.d.ts.map +1 -1
  148. package/dist/ibl/skylight-bind-group.d.ts +1 -1
  149. package/dist/index.d.ts +13 -43
  150. package/dist/index.d.ts.map +1 -1
  151. package/dist/index.mjs +165 -3
  152. package/dist/index.mjs.map +1 -1
  153. package/dist/inspection-types.d.ts +69 -0
  154. package/dist/inspection-types.d.ts.map +1 -0
  155. package/dist/instance-buffer-cache.d.ts +1 -4
  156. package/dist/instance-buffer-cache.d.ts.map +1 -1
  157. package/dist/internal.d.ts +1 -73
  158. package/dist/internal.d.ts.map +1 -1
  159. package/dist/internal.mjs +1 -43
  160. package/dist/internal.mjs.map +1 -1
  161. package/dist/lifecycle.d.ts +36 -2
  162. package/dist/lifecycle.d.ts.map +1 -1
  163. package/dist/materials.d.ts +0 -3
  164. package/dist/materials.d.ts.map +1 -1
  165. package/dist/mesh-material-bindings.d.ts +0 -1
  166. package/dist/mesh-material-bindings.d.ts.map +1 -1
  167. package/dist/pbr-pipeline.d.ts +75 -29
  168. package/dist/pbr-pipeline.d.ts.map +1 -1
  169. package/dist/pipeline/standard-forward-lane.d.ts +5 -0
  170. package/dist/pipeline/standard-forward-lane.d.ts.map +1 -0
  171. package/dist/pipeline/standard-pipeline.d.ts +31 -0
  172. package/dist/pipeline/standard-pipeline.d.ts.map +1 -0
  173. package/dist/pipeline/standard-profile.d.ts +40 -0
  174. package/dist/pipeline/standard-profile.d.ts.map +1 -0
  175. package/dist/pipeline-builder.d.ts +3 -3
  176. package/dist/pipeline-builder.d.ts.map +1 -1
  177. package/dist/pipeline-spec-types.d.ts +24 -0
  178. package/dist/pipeline-spec-types.d.ts.map +1 -0
  179. package/dist/pipeline-spec.d.ts +16 -155
  180. package/dist/pipeline-spec.d.ts.map +1 -1
  181. package/dist/plugin.d.ts +1 -14
  182. package/dist/plugin.d.ts.map +1 -1
  183. package/dist/post-process-errors.d.ts +18 -18
  184. package/dist/post-process-errors.d.ts.map +1 -1
  185. package/dist/prepare/prepared-graphics-resolver.d.ts +2 -5
  186. package/dist/prepare/prepared-graphics-resolver.d.ts.map +1 -1
  187. package/dist/record/__tests__/typed-frame-graph-plan.unit.test.d.ts +2 -0
  188. package/dist/record/__tests__/typed-frame-graph-plan.unit.test.d.ts.map +1 -0
  189. package/dist/record/frame-lighting.d.ts +7 -73
  190. package/dist/record/frame-lighting.d.ts.map +1 -1
  191. package/dist/record/frame-snapshot.d.ts +44 -44
  192. package/dist/record/frame-snapshot.d.ts.map +1 -1
  193. package/dist/record/frame-targets.d.ts +5 -38
  194. package/dist/record/frame-targets.d.ts.map +1 -1
  195. package/dist/record/frame.d.ts +64 -52
  196. package/dist/record/frame.d.ts.map +1 -1
  197. package/dist/record/helpers.d.ts +3 -2
  198. package/dist/record/helpers.d.ts.map +1 -1
  199. package/dist/record/main-pass-geometry.d.ts +5 -4
  200. package/dist/record/main-pass-geometry.d.ts.map +1 -1
  201. package/dist/record/main-pass-material.d.ts +90 -59
  202. package/dist/record/main-pass-material.d.ts.map +1 -1
  203. package/dist/record/main-pass-sprite-draws.d.ts +28 -3
  204. package/dist/record/main-pass-sprite-draws.d.ts.map +1 -1
  205. package/dist/record/main-pass.d.ts +1 -1
  206. package/dist/record/main-pass.d.ts.map +1 -1
  207. package/dist/record/mesh-ssbo.d.ts +276 -3
  208. package/dist/record/mesh-ssbo.d.ts.map +1 -1
  209. package/dist/record/render-context.d.ts +235 -0
  210. package/dist/record/render-context.d.ts.map +1 -0
  211. package/dist/record/shadow-pass.d.ts +15 -88
  212. package/dist/record/shadow-pass.d.ts.map +1 -1
  213. package/dist/record/skybox-post-pass.d.ts +1 -1
  214. package/dist/record/skybox-post-pass.d.ts.map +1 -1
  215. package/dist/record/typed-frame-graph.d.ts +29 -7
  216. package/dist/record/typed-frame-graph.d.ts.map +1 -1
  217. package/dist/record/view-ubo.d.ts +3 -3
  218. package/dist/record/view-ubo.d.ts.map +1 -1
  219. package/dist/render-contract.d.ts +416 -0
  220. package/dist/render-contract.d.ts.map +1 -0
  221. package/dist/render-data.d.ts.map +1 -1
  222. package/dist/render-graph-primitives.d.ts +14 -362
  223. package/dist/render-graph-primitives.d.ts.map +1 -1
  224. package/dist/render-pipeline.d.ts +25 -64
  225. package/dist/render-pipeline.d.ts.map +1 -1
  226. package/dist/render-system-extract.d.ts +107 -338
  227. package/dist/render-system-extract.d.ts.map +1 -1
  228. package/dist/render-system.d.ts +21 -713
  229. package/dist/render-system.d.ts.map +1 -1
  230. package/dist/scene/render-scene-types.d.ts +58 -0
  231. package/dist/scene/render-scene-types.d.ts.map +1 -0
  232. package/dist/scene/render-scene.d.ts +105 -0
  233. package/dist/scene/render-scene.d.ts.map +1 -0
  234. package/dist/scene-instances/post-spawn-resolve-joints.d.ts +2 -5
  235. package/dist/scene-instances/post-spawn-resolve-joints.d.ts.map +1 -1
  236. package/dist/ssao-buffers.d.ts +22 -3
  237. package/dist/ssao-buffers.d.ts.map +1 -1
  238. package/dist/systems/skin-palette-allocator.d.ts +2 -4
  239. package/dist/systems/skin-palette-allocator.d.ts.map +1 -1
  240. package/dist/systems/skin-palette-types.d.ts +14 -0
  241. package/dist/systems/skin-palette-types.d.ts.map +1 -0
  242. package/dist/systems/transparent-sort-config.d.ts +23 -2
  243. package/dist/systems/transparent-sort-config.d.ts.map +1 -1
  244. package/dist/tilemap-chunk-extract-system.d.ts +4 -3
  245. package/dist/tilemap-chunk-extract-system.d.ts.map +1 -1
  246. package/dist/typed-render-graph-primitives.d.ts +2 -4
  247. package/dist/typed-render-graph-primitives.d.ts.map +1 -1
  248. package/dist/typed-shadow-passes.d.ts +3 -3
  249. package/dist/typed-shadow-passes.d.ts.map +1 -1
  250. package/package.json +23 -23
  251. package/src/__tests__/backend-selection-rhi-capture.test-d.ts +1 -1
  252. package/src/__tests__/callback-inference.test-d.ts +6 -3
  253. package/src/__tests__/cluster-grid-default-surface.unit.test.ts +7 -4
  254. package/src/__tests__/construct-renderer-identity.unit.test.ts +15 -2
  255. package/src/__tests__/device-scope-lifecycle.unit.test.ts +151 -0
  256. package/src/__tests__/device-scope-stale-matrix.unit.test.ts +42 -0
  257. package/src/__tests__/direct-extract-consumer-contract.test-d.ts +8 -19
  258. package/src/__tests__/direct-light-snapshot.unit.test.ts +3 -13
  259. package/src/__tests__/factory-contract.integration.test.ts +158 -209
  260. package/src/__tests__/fallback-row-stride-surface.unit.test.ts +1 -4
  261. package/src/__tests__/frame-observation.contract.test.ts +17 -8
  262. package/src/__tests__/fullscreen-feature-plan.unit.test.ts +32 -0
  263. package/src/__tests__/glyph-text-layout-recovery.unit.test.ts +6 -11
  264. package/src/__tests__/gpu-driven-indirect-raster-evidence.ts +9 -16
  265. package/src/__tests__/gpu-driven-production.integration.test.ts +32 -205
  266. package/src/__tests__/gpu-driven-scaling.unit.test.ts +4 -7
  267. package/src/__tests__/gpu-driven-view-gpu-evidence.ts +87 -8
  268. package/src/__tests__/gpu-driven-view-graph.integration.test.ts +170 -8
  269. package/src/{gpu-driven/view-reference.ts → __tests__/gpu-driven-view-reference.ts} +4 -3
  270. package/src/__tests__/gpu-driven-view.browser.test.ts +12 -1
  271. package/src/__tests__/gpu-driven-view.dawn.test.ts +12 -1
  272. package/src/__tests__/gpu-driven-view.unit.test.ts +11 -267
  273. package/src/__tests__/gpu-resource-store-stride.unit.test.ts +3 -3
  274. package/src/__tests__/gpu-scene-render-graph-gpu.ts +2 -3
  275. package/src/__tests__/gpu-scene.dawn.test.ts +2 -6
  276. package/src/__tests__/gpu-scene.unit.test.ts +10 -24
  277. package/src/__tests__/ibl/face-uniforms.unit.test.ts +46 -0
  278. package/src/__tests__/infinite-grid-no-vertex-probe.unit.test.ts +34 -66
  279. package/src/__tests__/ktx2-basis-gpu-consumer.dawn.test.ts +14 -5
  280. package/src/__tests__/light-buffer-layout.unit.test.ts +4 -49
  281. package/src/__tests__/material-cooked-projection.unit.test.ts +2 -51
  282. package/src/__tests__/material-snapshot-mutation.integration.test.ts +10 -15
  283. package/src/__tests__/material-static-dynamic-route.unit.test.ts +4 -23
  284. package/src/__tests__/material-stride-surface.unit.test.ts +2 -2
  285. package/src/__tests__/mesh-buffer-usage-surface.unit.test.ts +7 -8
  286. package/src/__tests__/morph-culling-reentry.dawn.test.ts +29 -38
  287. package/src/__tests__/morph-feature-gpu-work.integration.test.ts +45 -43
  288. package/src/__tests__/morph-feature-plan.unit.test.ts +53 -0
  289. package/src/__tests__/morph-visual-evidence.integration.test.ts +47 -33
  290. package/src/__tests__/nineslice-handle-surface.unit.test.ts +11 -6
  291. package/src/__tests__/post-process-error-policy-owner.unit.test.ts +6 -13
  292. package/src/__tests__/prepared-graphics-capability.unit.test.ts +6 -81
  293. package/src/__tests__/prepared-graphics-generation.unit.test.ts +3 -17
  294. package/src/__tests__/prepared-graphics-lifecycle.unit.test.ts +6 -74
  295. package/src/__tests__/prepared-graphics-resolver.unit.test.ts +1 -3
  296. package/src/__tests__/prepared-graphics-snapshot.unit.test.ts +2 -2
  297. package/src/__tests__/profiler-default-off.test.ts +1 -1
  298. package/src/__tests__/profiler-phase-catalog.test.ts +2 -2
  299. package/src/__tests__/profiler-phase-integration.test.ts +5 -13
  300. package/src/__tests__/profiler-phase-token.test.ts +3 -8
  301. package/src/__tests__/public-surface.test-d.ts +65 -3
  302. package/src/__tests__/recover-error-policy-owner.unit.test.ts +1 -21
  303. package/src/__tests__/render-error-code-owner.test-d.ts +18 -23
  304. package/src/__tests__/render-error-detail-ssot.test-d.ts +0 -95
  305. package/src/__tests__/render-error-exhaustive.test-d.ts +8 -1
  306. package/src/__tests__/render-feature-assembly.test-d.ts +8 -16
  307. package/src/__tests__/render-feature-context.test-d.ts +16 -40
  308. package/src/__tests__/render-feature-contract.test-d.ts +9 -18
  309. package/src/__tests__/render-feature-diagnostics.unit.test.ts +6 -8
  310. package/src/__tests__/render-feature-docs.unit.test.ts +8 -7
  311. package/src/__tests__/render-feature-gpu-work.integration.test.ts +14 -75
  312. package/src/__tests__/render-feature-plan.test-d.ts +161 -0
  313. package/src/__tests__/render-feature-plan.unit.test.ts +170 -0
  314. package/src/__tests__/render-feature-prepared-diagnostics.unit.test.ts +8 -19
  315. package/src/__tests__/render-feature-prepared-errors.test-d.ts +3 -6
  316. package/src/__tests__/render-feature-prepared-graphics-docs.unit.test.ts +10 -71
  317. package/src/__tests__/render-feature-prepared-graphics-isolation.unit.test.ts +11 -61
  318. package/src/__tests__/render-feature-prepared-graphics-negative.test-d.ts +20 -43
  319. package/src/__tests__/render-feature-prepared-graphics.test-d.ts +56 -78
  320. package/src/__tests__/render-feature-public-surface.test-d.ts +6 -24
  321. package/src/__tests__/render-feature-retry.unit.test.ts +7 -48
  322. package/src/__tests__/render-feature-scheduling.unit.test.ts +15 -27
  323. package/src/__tests__/render-feature-stage-failed-policy-owner.unit.test.ts +0 -9
  324. package/src/__tests__/render-feature-stage-fault-recovery.unit.test.ts +19 -109
  325. package/src/__tests__/render-feature-visibility-context.test-d.ts +1 -6
  326. package/src/__tests__/render-feature-visibility-context.unit.test.ts +1 -2
  327. package/src/__tests__/render-feature-zero-work.unit.test.ts +14 -20
  328. package/src/__tests__/render-scene-projection.unit.test.ts +73 -111
  329. package/src/__tests__/renderer-factory-material-contract.unit.test.ts +44 -95
  330. package/src/__tests__/renderer-lifecycle.integration.test.ts +49 -1
  331. package/src/__tests__/shader-stage-surface.unit.test.ts +14 -9
  332. package/src/__tests__/ssao-config.unit.test.ts +36 -0
  333. package/src/__tests__/ssao-kernel-surface.unit.test.ts +4 -5
  334. package/src/__tests__/standard-clustered-pipeline.unit.test.ts +28 -0
  335. package/src/__tests__/standard-descriptors.test-d.ts +22 -0
  336. package/src/__tests__/standard-pipeline.dawn.test.ts +61 -0
  337. package/src/__tests__/standard-pipeline.integration.test.ts +124 -0
  338. package/src/__tests__/standard-profile-oracle.unit.test.ts +62 -0
  339. package/src/__tests__/surface-configuration.unit.test.ts +1 -2
  340. package/src/__tests__/texture-usage-surface.unit.test.ts +3 -6
  341. package/src/__tests__/typed-pipeline-topology.unit.test.ts +40 -206
  342. package/src/__tests__/urp-pipeline-targets.unit.test.ts +1 -11
  343. package/src/__tests__/urp-pipeline.unit.test.ts +2 -2
  344. package/src/__tests__/vertex-color-pipeline.unit.test.ts +10 -2
  345. package/src/__tests__/vertex-layout-consumer.unit.test.ts +1 -1
  346. package/src/__tests__/visibility-diagnostics.integration.test.ts +7 -11
  347. package/src/__tests__/visibility-extract.integration.test.ts +20 -11
  348. package/src/__tests__/visibility-extract.perf.test.ts +66 -32
  349. package/src/__tests__/visibility-feature-dedup.integration.test.ts +2 -4
  350. package/src/__tests__/visibility-hidden-report.unit.test.ts +1 -2
  351. package/src/__tests__/visibility-instances.integration.test.ts +7 -11
  352. package/src/__tests__/visibility-multi-world.integration.test.ts +38 -6
  353. package/src/__tests__/visibility-producer-matrix.integration.test.ts +18 -41
  354. package/src/__tests__/visibility-public-surface.test-d.ts +10 -9
  355. package/src/__tests__/visibility-resolver.unit.test.ts +2 -1
  356. package/src/__tests__/visibility-resource-short-circuit.unit.test.ts +80 -0
  357. package/src/__tests__/visibility-snapshot-contract.unit.test.ts +2 -1
  358. package/src/__tests__/vocabulary.unit.test.ts +1 -1
  359. package/src/assembly/backend-contract.ts +57 -0
  360. package/src/{renderer/renderer-factory.ts → assembly/factory.ts} +1663 -2690
  361. package/src/assembly/host-contract.ts +101 -0
  362. package/src/{renderer → assembly}/material/assembly.ts +0 -2
  363. package/src/assembly/material/pipeline-projection.ts +63 -0
  364. package/src/authoring.ts +14 -22
  365. package/src/components/__tests__/schema-contract.unit.test.ts +10 -0
  366. package/src/components/glyph-text.ts +3 -2
  367. package/src/components/index.ts +7 -9
  368. package/src/components/instances.ts +4 -5
  369. package/src/components/light-helpers.ts +1 -1
  370. package/src/components/mesh-filter.ts +11 -10
  371. package/src/components/post-process-params.ts +3 -3
  372. package/src/components/scene-instance.ts +12 -12
  373. package/src/components/skybox-background.ts +103 -0
  374. package/src/components/{environment.ts → skylight.ts} +2 -110
  375. package/src/components/sprite-animation.ts +3 -4
  376. package/src/components/sprite-instances.ts +2 -2
  377. package/src/components/sprite-playback-mode.ts +7 -1
  378. package/src/components/sprite-region-override.ts +2 -3
  379. package/src/components/tile-layer.ts +8 -2
  380. package/src/construct-renderer.ts +67 -4
  381. package/src/debug-draw-glue.ts +8 -129
  382. package/src/device/device-scope.ts +306 -0
  383. package/src/{gpu-resource-store.ts → device/gpu-residency.ts} +540 -639
  384. package/src/device/resource-types.ts +20 -0
  385. package/src/engine-metrics.ts +12 -19
  386. package/src/errors/recover.ts +45 -3
  387. package/src/errors/render.ts +357 -460
  388. package/src/features/fullscreen.ts +46 -0
  389. package/src/features/host.ts +575 -309
  390. package/src/features/morph/morph-feature.ts +195 -105
  391. package/src/features/plan.ts +447 -0
  392. package/src/features/prepared-gpu-work.ts +72 -15
  393. package/src/features/prepared-graphics-store.ts +20 -6
  394. package/src/features/prepared-graphics.ts +12 -71
  395. package/src/features/render-graph-compute.ts +14 -5
  396. package/src/features/render-graph-contribution.ts +43 -63
  397. package/src/features/render-graph-raster.ts +11 -6
  398. package/src/features/render-graph-resources.ts +25 -23
  399. package/src/features/targets.ts +8 -21
  400. package/src/features/types.ts +39 -227
  401. package/src/features/vocabulary.ts +24 -0
  402. package/src/fullscreen-post-process-pass.ts +14 -57
  403. package/src/glyph-text-layout-system.ts +70 -96
  404. package/src/gpu-driven/batch-topology.ts +24 -202
  405. package/src/gpu-driven/production-raster.ts +93 -1108
  406. package/src/gpu-driven/view-gpu.ts +46 -192
  407. package/src/gpu-resource.ts +4 -4
  408. package/src/gpu-scene-schema.ts +11 -99
  409. package/src/gpu-scene.ts +231 -364
  410. package/src/hdrp-buffers.ts +12 -221
  411. package/src/ibl/IblPipelineCache.ts +471 -711
  412. package/src/ibl/skylight-bind-group.ts +4 -4
  413. package/src/index.ts +58 -217
  414. package/src/inspection-types.ts +76 -0
  415. package/src/instance-buffer-cache.ts +1 -29
  416. package/src/internal.ts +6 -85
  417. package/src/lifecycle.ts +64 -19
  418. package/src/materials.ts +7 -29
  419. package/src/mesh-material-bindings.ts +0 -1
  420. package/src/pbr-pipeline.ts +434 -53
  421. package/src/{urp-pipeline.ts → pipeline/standard-forward-lane.ts} +38 -149
  422. package/src/{hdrp-pipeline.ts → pipeline/standard-pipeline.ts} +221 -191
  423. package/src/pipeline/standard-profile.ts +65 -0
  424. package/src/pipeline-builder.ts +60 -64
  425. package/src/pipeline-spec-types.ts +28 -0
  426. package/src/pipeline-spec.ts +72 -609
  427. package/src/plugin.ts +3 -75
  428. package/src/post-process-errors.ts +31 -33
  429. package/src/prepare/prepared-graphics-resolver.ts +5 -4
  430. package/src/record/__tests__/material-slot-plan.unit.test.ts +1 -33
  431. package/src/record/__tests__/typed-frame-graph-plan.unit.test.ts +41 -0
  432. package/src/record/__tests__/video-texture-view.unit.test.ts +1 -1
  433. package/src/record/frame-lighting.ts +74 -195
  434. package/src/record/frame-snapshot.ts +45 -60
  435. package/src/record/frame-targets.ts +8 -243
  436. package/src/record/frame.ts +509 -796
  437. package/src/record/helpers.ts +6 -11
  438. package/src/record/main-pass-geometry.ts +106 -147
  439. package/src/record/main-pass-material.ts +517 -190
  440. package/src/record/main-pass-sprite-draws.ts +198 -117
  441. package/src/record/main-pass.ts +162 -143
  442. package/src/record/mesh-ssbo.ts +517 -38
  443. package/src/record/render-context.ts +364 -0
  444. package/src/record/shadow-pass.ts +138 -1838
  445. package/src/record/skybox-post-pass.ts +12 -14
  446. package/src/record/typed-frame-graph.ts +215 -254
  447. package/src/record/view-ubo.ts +6 -37
  448. package/src/render-contract.ts +571 -0
  449. package/src/render-data.ts +3 -3
  450. package/src/render-graph-primitives.ts +76 -851
  451. package/src/render-pipeline.ts +104 -188
  452. package/src/render-system-extract.ts +1048 -1729
  453. package/src/render-system.ts +330 -1957
  454. package/src/scene/render-scene-types.ts +64 -0
  455. package/src/scene/render-scene.ts +1032 -0
  456. package/src/scene-instances/post-spawn-resolve-joints.ts +4 -7
  457. package/src/ssao-buffers.ts +167 -8
  458. package/src/systems/skin-palette-allocator.ts +21 -64
  459. package/src/systems/skin-palette-types.ts +14 -0
  460. package/src/systems/transparent-sort-config.ts +25 -3
  461. package/src/tilemap-chunk-extract-system.ts +53 -70
  462. package/src/typed-render-graph-primitives.ts +35 -24
  463. package/src/typed-shadow-passes.ts +26 -56
  464. package/dist/__tests__/analytic-sky-contract.test.d.ts +0 -2
  465. package/dist/__tests__/analytic-sky-contract.test.d.ts.map +0 -1
  466. package/dist/__tests__/analytic-sky-falsify.test.d.ts +0 -2
  467. package/dist/__tests__/analytic-sky-falsify.test.d.ts.map +0 -1
  468. package/dist/__tests__/assets-runtime-handoff.integration.test.d.ts +0 -2
  469. package/dist/__tests__/assets-runtime-handoff.integration.test.d.ts.map +0 -1
  470. package/dist/__tests__/backend-selection.integration.test.d.ts +0 -2
  471. package/dist/__tests__/backend-selection.integration.test.d.ts.map +0 -1
  472. package/dist/__tests__/camera-temporal.test-d.d.ts +0 -2
  473. package/dist/__tests__/camera-temporal.test-d.d.ts.map +0 -1
  474. package/dist/__tests__/camera-temporal.test.d.ts +0 -2
  475. package/dist/__tests__/camera-temporal.test.d.ts.map +0 -1
  476. package/dist/__tests__/directional-shadow-probe-atlas-layout.unit.test.d.ts +0 -2
  477. package/dist/__tests__/directional-shadow-probe-atlas-layout.unit.test.d.ts.map +0 -1
  478. package/dist/__tests__/environment-inspection.test.d.ts +0 -2
  479. package/dist/__tests__/environment-inspection.test.d.ts.map +0 -1
  480. package/dist/__tests__/fog-ai-user.fixture.d.ts +0 -2
  481. package/dist/__tests__/fog-ai-user.fixture.d.ts.map +0 -1
  482. package/dist/__tests__/fog-custom-render-feature.fixture.d.ts +0 -16
  483. package/dist/__tests__/fog-custom-render-feature.fixture.d.ts.map +0 -1
  484. package/dist/__tests__/fog-custom-render-feature.integration.test.d.ts +0 -2
  485. package/dist/__tests__/fog-custom-render-feature.integration.test.d.ts.map +0 -1
  486. package/dist/__tests__/fog-inspection.integration.test.d.ts +0 -2
  487. package/dist/__tests__/fog-inspection.integration.test.d.ts.map +0 -1
  488. package/dist/__tests__/fog-owner-state.integration.test.d.ts +0 -2
  489. package/dist/__tests__/fog-owner-state.integration.test.d.ts.map +0 -1
  490. package/dist/__tests__/fog-pipeline-topology.integration.test.d.ts +0 -2
  491. package/dist/__tests__/fog-pipeline-topology.integration.test.d.ts.map +0 -1
  492. package/dist/__tests__/fog-public-surface.integration.test.d.ts +0 -2
  493. package/dist/__tests__/fog-public-surface.integration.test.d.ts.map +0 -1
  494. package/dist/__tests__/fog-ray-contract.integration.test.d.ts +0 -2
  495. package/dist/__tests__/fog-ray-contract.integration.test.d.ts.map +0 -1
  496. package/dist/__tests__/fog-source-absence.integration.test.d.ts +0 -2
  497. package/dist/__tests__/fog-source-absence.integration.test.d.ts.map +0 -1
  498. package/dist/__tests__/fog-temporal.integration.test.d.ts +0 -2
  499. package/dist/__tests__/fog-temporal.integration.test.d.ts.map +0 -1
  500. package/dist/__tests__/frame-chain.unit.test.d.ts +0 -2
  501. package/dist/__tests__/frame-chain.unit.test.d.ts.map +0 -1
  502. package/dist/__tests__/gpu-scene-field-type-owner.test-d.d.ts +0 -2
  503. package/dist/__tests__/gpu-scene-field-type-owner.test-d.d.ts.map +0 -1
  504. package/dist/__tests__/hdrp-pipeline.unit.test.d.ts +0 -2
  505. package/dist/__tests__/hdrp-pipeline.unit.test.d.ts.map +0 -1
  506. package/dist/__tests__/ibl/ibl-fallback.unit.test.d.ts +0 -2
  507. package/dist/__tests__/ibl/ibl-fallback.unit.test.d.ts.map +0 -1
  508. package/dist/__tests__/material-derived-error-stop-draw.integration.test.d.ts +0 -2
  509. package/dist/__tests__/material-derived-error-stop-draw.integration.test.d.ts.map +0 -1
  510. package/dist/__tests__/material-derived-payload.integration.test.d.ts +0 -2
  511. package/dist/__tests__/material-derived-payload.integration.test.d.ts.map +0 -1
  512. package/dist/__tests__/materials.unit.test.d.ts +0 -2
  513. package/dist/__tests__/materials.unit.test.d.ts.map +0 -1
  514. package/dist/__tests__/param-schema-projection-census.unit.test.d.ts +0 -2
  515. package/dist/__tests__/param-schema-projection-census.unit.test.d.ts.map +0 -1
  516. package/dist/__tests__/persistent-render-scene.unit.test.d.ts +0 -2
  517. package/dist/__tests__/persistent-render-scene.unit.test.d.ts.map +0 -1
  518. package/dist/__tests__/pipeline-error-policy-owner.unit.test.d.ts +0 -2
  519. package/dist/__tests__/pipeline-error-policy-owner.unit.test.d.ts.map +0 -1
  520. package/dist/__tests__/pipeline-pass-trace.test.d.ts +0 -2
  521. package/dist/__tests__/pipeline-pass-trace.test.d.ts.map +0 -1
  522. package/dist/__tests__/pipeline-stage-owner.test-d.d.ts +0 -2
  523. package/dist/__tests__/pipeline-stage-owner.test-d.d.ts.map +0 -1
  524. package/dist/__tests__/plugin.test.d.ts +0 -2
  525. package/dist/__tests__/plugin.test.d.ts.map +0 -1
  526. package/dist/__tests__/prepared-graphics-backend-matrix.unit.test.d.ts +0 -2
  527. package/dist/__tests__/prepared-graphics-backend-matrix.unit.test.d.ts.map +0 -1
  528. package/dist/__tests__/prepared-graphics-resolver-recording.unit.test.d.ts +0 -2
  529. package/dist/__tests__/prepared-graphics-resolver-recording.unit.test.d.ts.map +0 -1
  530. package/dist/__tests__/public-pipeline-id.test-d.d.ts +0 -2
  531. package/dist/__tests__/public-pipeline-id.test-d.d.ts.map +0 -1
  532. package/dist/__tests__/render-dispatch-membership.unit.test.d.ts +0 -2
  533. package/dist/__tests__/render-dispatch-membership.unit.test.d.ts.map +0 -1
  534. package/dist/__tests__/render-feature-construction.unit.test.d.ts +0 -2
  535. package/dist/__tests__/render-feature-construction.unit.test.d.ts.map +0 -1
  536. package/dist/__tests__/render-feature-error-code-owner.test-d.d.ts +0 -2
  537. package/dist/__tests__/render-feature-error-code-owner.test-d.d.ts.map +0 -1
  538. package/dist/__tests__/render-feature-gpu-buffer-usage-owner.test-d.d.ts +0 -2
  539. package/dist/__tests__/render-feature-gpu-buffer-usage-owner.test-d.d.ts.map +0 -1
  540. package/dist/__tests__/render-feature-graph.integration.test.d.ts +0 -2
  541. package/dist/__tests__/render-feature-graph.integration.test.d.ts.map +0 -1
  542. package/dist/__tests__/render-feature-graphics-staging.unit.test.d.ts +0 -2
  543. package/dist/__tests__/render-feature-graphics-staging.unit.test.d.ts.map +0 -1
  544. package/dist/__tests__/render-feature-order.unit.test.d.ts +0 -2
  545. package/dist/__tests__/render-feature-order.unit.test.d.ts.map +0 -1
  546. package/dist/__tests__/render-feature-prepared-graphics-recording.unit.test.d.ts +0 -2
  547. package/dist/__tests__/render-feature-prepared-graphics-recording.unit.test.d.ts.map +0 -1
  548. package/dist/__tests__/render-feature-staging.unit.test.d.ts +0 -2
  549. package/dist/__tests__/render-feature-staging.unit.test.d.ts.map +0 -1
  550. package/dist/__tests__/renderer-render-scene-public.test-d.d.ts +0 -2
  551. package/dist/__tests__/renderer-render-scene-public.test-d.d.ts.map +0 -1
  552. package/dist/__tests__/scene-temporal-coverage.unit.test.d.ts +0 -2
  553. package/dist/__tests__/scene-temporal-coverage.unit.test.d.ts.map +0 -1
  554. package/dist/__tests__/sun-snapshot-consumers.test.d.ts +0 -2
  555. package/dist/__tests__/sun-snapshot-consumers.test.d.ts.map +0 -1
  556. package/dist/__tests__/surface-backend-kind-owner.test-d.d.ts +0 -2
  557. package/dist/__tests__/surface-backend-kind-owner.test-d.d.ts.map +0 -1
  558. package/dist/__tests__/taa-history-store.unit.test.d.ts +0 -2
  559. package/dist/__tests__/taa-history-store.unit.test.d.ts.map +0 -1
  560. package/dist/__tests__/temporal-frame-transaction.integration.test.d.ts +0 -2
  561. package/dist/__tests__/temporal-frame-transaction.integration.test.d.ts.map +0 -1
  562. package/dist/__tests__/temporal-inspection.unit.test.d.ts +0 -2
  563. package/dist/__tests__/temporal-inspection.unit.test.d.ts.map +0 -1
  564. package/dist/assets/__tests__/asset-decoders.unit.test.d.ts +0 -2
  565. package/dist/assets/__tests__/asset-decoders.unit.test.d.ts.map +0 -1
  566. package/dist/assets/__tests__/mipmap-generator.unit.test.d.ts +0 -2
  567. package/dist/assets/__tests__/mipmap-generator.unit.test.d.ts.map +0 -1
  568. package/dist/assets/__tests__/render-asset-port.unit.test.d.ts +0 -2
  569. package/dist/assets/__tests__/render-asset-port.unit.test.d.ts.map +0 -1
  570. package/dist/assets/__tests__/resolve-render-asset.unit.test.d.ts +0 -2
  571. package/dist/assets/__tests__/resolve-render-asset.unit.test.d.ts.map +0 -1
  572. package/dist/chunk-DJIMFYX6.mjs +0 -1439
  573. package/dist/chunk-DJIMFYX6.mjs.map +0 -1
  574. package/dist/chunk-F2SIOCRM.mjs +0 -7423
  575. package/dist/chunk-F2SIOCRM.mjs.map +0 -1
  576. package/dist/chunk-JMSB7AR4.mjs +0 -3
  577. package/dist/chunk-JMSB7AR4.mjs.map +0 -1
  578. package/dist/chunk-KHI6K4C6.mjs +0 -659
  579. package/dist/chunk-KHI6K4C6.mjs.map +0 -1
  580. package/dist/chunk-PORZOL2V.mjs +0 -569
  581. package/dist/chunk-PORZOL2V.mjs.map +0 -1
  582. package/dist/chunk-UOJGMDGP.mjs +0 -29913
  583. package/dist/chunk-UOJGMDGP.mjs.map +0 -1
  584. package/dist/components/__tests__/atmosphere-red.test.d.ts +0 -2
  585. package/dist/components/__tests__/atmosphere-red.test.d.ts.map +0 -1
  586. package/dist/components/__tests__/atmosphere.test.d.ts +0 -2
  587. package/dist/components/__tests__/atmosphere.test.d.ts.map +0 -1
  588. package/dist/components/__tests__/fog.test-d.d.ts +0 -2
  589. package/dist/components/__tests__/fog.test-d.d.ts.map +0 -1
  590. package/dist/components/__tests__/fog.test.d.ts +0 -2
  591. package/dist/components/__tests__/fog.test.d.ts.map +0 -1
  592. package/dist/components/atmosphere.d.ts +0 -18
  593. package/dist/components/atmosphere.d.ts.map +0 -1
  594. package/dist/components/environment.d.ts +0 -115
  595. package/dist/components/environment.d.ts.map +0 -1
  596. package/dist/deferred-lighting.d.ts +0 -13
  597. package/dist/deferred-lighting.d.ts.map +0 -1
  598. package/dist/dynamic-texture-store.d.ts +0 -42
  599. package/dist/dynamic-texture-store.d.ts.map +0 -1
  600. package/dist/environment/__tests__/failure-injection.test.d.ts +0 -2
  601. package/dist/environment/__tests__/failure-injection.test.d.ts.map +0 -1
  602. package/dist/environment/__tests__/generation-red.test.d.ts +0 -2
  603. package/dist/environment/__tests__/generation-red.test.d.ts.map +0 -1
  604. package/dist/environment/__tests__/generation.test.d.ts +0 -2
  605. package/dist/environment/__tests__/generation.test.d.ts.map +0 -1
  606. package/dist/environment/__tests__/graph-transaction.test.d.ts +0 -2
  607. package/dist/environment/__tests__/graph-transaction.test.d.ts.map +0 -1
  608. package/dist/environment/__tests__/inspection-red.test.d.ts +0 -2
  609. package/dist/environment/__tests__/inspection-red.test.d.ts.map +0 -1
  610. package/dist/environment/__tests__/lifecycle-evidence.test.d.ts +0 -2
  611. package/dist/environment/__tests__/lifecycle-evidence.test.d.ts.map +0 -1
  612. package/dist/environment/__tests__/pipeline-topology.test.d.ts +0 -2
  613. package/dist/environment/__tests__/pipeline-topology.test.d.ts.map +0 -1
  614. package/dist/environment/__tests__/readiness.test.d.ts +0 -2
  615. package/dist/environment/__tests__/readiness.test.d.ts.map +0 -1
  616. package/dist/environment/__tests__/recovery.test.d.ts +0 -2
  617. package/dist/environment/__tests__/recovery.test.d.ts.map +0 -1
  618. package/dist/environment/__tests__/resize-dispose.test.d.ts +0 -2
  619. package/dist/environment/__tests__/resize-dispose.test.d.ts.map +0 -1
  620. package/dist/environment/__tests__/signature-red.test.d.ts +0 -2
  621. package/dist/environment/__tests__/signature-red.test.d.ts.map +0 -1
  622. package/dist/environment/__tests__/signature.test.d.ts +0 -2
  623. package/dist/environment/__tests__/signature.test.d.ts.map +0 -1
  624. package/dist/environment/descriptors.d.ts +0 -2
  625. package/dist/environment/descriptors.d.ts.map +0 -1
  626. package/dist/environment/extracted-environment.d.ts +0 -53
  627. package/dist/environment/extracted-environment.d.ts.map +0 -1
  628. package/dist/environment/generation.d.ts +0 -62
  629. package/dist/environment/generation.d.ts.map +0 -1
  630. package/dist/environment/gpu-bundle.d.ts +0 -23
  631. package/dist/environment/gpu-bundle.d.ts.map +0 -1
  632. package/dist/environment/graph.d.ts +0 -108
  633. package/dist/environment/graph.d.ts.map +0 -1
  634. package/dist/environment/inspection.d.ts +0 -48
  635. package/dist/environment/inspection.d.ts.map +0 -1
  636. package/dist/environment/lifecycle.d.ts +0 -22
  637. package/dist/environment/lifecycle.d.ts.map +0 -1
  638. package/dist/environment/readiness.d.ts +0 -29
  639. package/dist/environment/readiness.d.ts.map +0 -1
  640. package/dist/environment/signature.d.ts +0 -70
  641. package/dist/environment/signature.d.ts.map +0 -1
  642. package/dist/extract/__tests__/directional-csm-domain.unit.test.d.ts +0 -2
  643. package/dist/extract/__tests__/directional-csm-domain.unit.test.d.ts.map +0 -1
  644. package/dist/extract/__tests__/environment-source.test.d.ts +0 -2
  645. package/dist/extract/__tests__/environment-source.test.d.ts.map +0 -1
  646. package/dist/extract/__tests__/schema-readers.unit.test.d.ts +0 -2
  647. package/dist/extract/__tests__/schema-readers.unit.test.d.ts.map +0 -1
  648. package/dist/extract/directional-csm.d.ts +0 -129
  649. package/dist/extract/directional-csm.d.ts.map +0 -1
  650. package/dist/extract/index.d.ts +0 -5
  651. package/dist/extract/index.d.ts.map +0 -1
  652. package/dist/extract/material-interface.d.ts +0 -56
  653. package/dist/extract/material-interface.d.ts.map +0 -1
  654. package/dist/extract/schema-readers.d.ts +0 -20
  655. package/dist/extract/schema-readers.d.ts.map +0 -1
  656. package/dist/features/graph-contribution.d.ts +0 -64
  657. package/dist/features/graph-contribution.d.ts.map +0 -1
  658. package/dist/features/index.d.ts +0 -21
  659. package/dist/features/index.d.ts.map +0 -1
  660. package/dist/features/morph/index.d.ts +0 -3
  661. package/dist/features/morph/index.d.ts.map +0 -1
  662. package/dist/features/morph/morph-bounds.d.ts +0 -42
  663. package/dist/features/morph/morph-bounds.d.ts.map +0 -1
  664. package/dist/features/scene-temporal.d.ts +0 -45
  665. package/dist/features/scene-temporal.d.ts.map +0 -1
  666. package/dist/features/taa-resolve.d.ts +0 -21
  667. package/dist/features/taa-resolve.d.ts.map +0 -1
  668. package/dist/frame-chain.d.ts +0 -14
  669. package/dist/frame-chain.d.ts.map +0 -1
  670. package/dist/gpu-driven/view-reference.d.ts.map +0 -1
  671. package/dist/gpu-resource-store.d.ts.map +0 -1
  672. package/dist/hdrp-cluster-membership.d.ts +0 -2
  673. package/dist/hdrp-cluster-membership.d.ts.map +0 -1
  674. package/dist/hdrp-pipeline.d.ts +0 -36
  675. package/dist/hdrp-pipeline.d.ts.map +0 -1
  676. package/dist/ibl/cubemap-projection.d.ts +0 -23
  677. package/dist/ibl/cubemap-projection.d.ts.map +0 -1
  678. package/dist/ibl/face-uniforms.d.ts +0 -65
  679. package/dist/ibl/face-uniforms.d.ts.map +0 -1
  680. package/dist/mesh-update-errors.d.ts +0 -71
  681. package/dist/mesh-update-errors.d.ts.map +0 -1
  682. package/dist/mipmap-generator.d.ts +0 -39
  683. package/dist/mipmap-generator.d.ts.map +0 -1
  684. package/dist/param-schema-projection-census.d.ts +0 -18
  685. package/dist/param-schema-projection-census.d.ts.map +0 -1
  686. package/dist/persistent-render-scene.d.ts +0 -158
  687. package/dist/persistent-render-scene.d.ts.map +0 -1
  688. package/dist/pipeline/index.d.ts +0 -11
  689. package/dist/pipeline/index.d.ts.map +0 -1
  690. package/dist/pipeline-errors.d.ts +0 -110
  691. package/dist/pipeline-errors.d.ts.map +0 -1
  692. package/dist/prepare/__tests__/schema-readers.unit.test.d.ts +0 -2
  693. package/dist/prepare/__tests__/schema-readers.unit.test.d.ts.map +0 -1
  694. package/dist/prepare/index.d.ts +0 -4
  695. package/dist/prepare/index.d.ts.map +0 -1
  696. package/dist/prepare/schema-readers.d.ts +0 -11
  697. package/dist/prepare/schema-readers.d.ts.map +0 -1
  698. package/dist/record/__tests__/environment-record.test.d.ts +0 -2
  699. package/dist/record/__tests__/environment-record.test.d.ts.map +0 -1
  700. package/dist/record/__tests__/frame-targets.unit.test.d.ts +0 -2
  701. package/dist/record/__tests__/frame-targets.unit.test.d.ts.map +0 -1
  702. package/dist/record/__tests__/membership-timing.unit.test.d.ts +0 -2
  703. package/dist/record/__tests__/membership-timing.unit.test.d.ts.map +0 -1
  704. package/dist/record/__tests__/render-submission.integration.test.d.ts +0 -2
  705. package/dist/record/__tests__/render-submission.integration.test.d.ts.map +0 -1
  706. package/dist/record/__tests__/render-submission.perf.test.d.ts +0 -2
  707. package/dist/record/__tests__/render-submission.perf.test.d.ts.map +0 -1
  708. package/dist/record/__tests__/shadow-submit-mode.unit.test.d.ts +0 -2
  709. package/dist/record/__tests__/shadow-submit-mode.unit.test.d.ts.map +0 -1
  710. package/dist/record/__tests__/view-ubo-layout.unit.test.d.ts +0 -2
  711. package/dist/record/__tests__/view-ubo-layout.unit.test.d.ts.map +0 -1
  712. package/dist/record/frame-observation.d.ts +0 -38
  713. package/dist/record/frame-observation.d.ts.map +0 -1
  714. package/dist/record/index.d.ts +0 -15
  715. package/dist/record/index.d.ts.map +0 -1
  716. package/dist/record/main-pass-skin.d.ts +0 -46
  717. package/dist/record/main-pass-skin.d.ts.map +0 -1
  718. package/dist/record/main-pass-sprite.d.ts +0 -69
  719. package/dist/record/main-pass-sprite.d.ts.map +0 -1
  720. package/dist/record/material-payload.d.ts +0 -43
  721. package/dist/record/material-payload.d.ts.map +0 -1
  722. package/dist/record/material-slot-plan.d.ts +0 -26
  723. package/dist/record/material-slot-plan.d.ts.map +0 -1
  724. package/dist/record/membership-timing.d.ts +0 -232
  725. package/dist/record/membership-timing.d.ts.map +0 -1
  726. package/dist/record/shadow-caster-uniform.d.ts +0 -8
  727. package/dist/record/shadow-caster-uniform.d.ts.map +0 -1
  728. package/dist/record/shadow-submit-mode.d.ts +0 -66
  729. package/dist/record/shadow-submit-mode.d.ts.map +0 -1
  730. package/dist/render-dispatch-membership.d.ts +0 -47
  731. package/dist/render-dispatch-membership.d.ts.map +0 -1
  732. package/dist/render-pipeline-context.d.ts +0 -289
  733. package/dist/render-pipeline-context.d.ts.map +0 -1
  734. package/dist/render-pipeline-target.d.ts +0 -16
  735. package/dist/render-pipeline-target.d.ts.map +0 -1
  736. package/dist/render-scene-projection.d.ts +0 -174
  737. package/dist/render-scene-projection.d.ts.map +0 -1
  738. package/dist/render-system-fold.d.ts +0 -266
  739. package/dist/render-system-fold.d.ts.map +0 -1
  740. package/dist/renderer/asset-service.d.ts +0 -10
  741. package/dist/renderer/asset-service.d.ts.map +0 -1
  742. package/dist/renderer/backend-selection.d.ts.map +0 -1
  743. package/dist/renderer/environment-classify.d.ts +0 -6
  744. package/dist/renderer/environment-classify.d.ts.map +0 -1
  745. package/dist/renderer/environment-error.d.ts +0 -13
  746. package/dist/renderer/environment-error.d.ts.map +0 -1
  747. package/dist/renderer/material/pipeline-projection.d.ts +0 -91
  748. package/dist/renderer/material/pipeline-projection.d.ts.map +0 -1
  749. package/dist/renderer/renderer-factory.d.ts +0 -289
  750. package/dist/renderer/renderer-factory.d.ts.map +0 -1
  751. package/dist/renderer.d.ts +0 -771
  752. package/dist/renderer.d.ts.map +0 -1
  753. package/dist/scene-utils/collect-subtree.d.ts +0 -11
  754. package/dist/scene-utils/collect-subtree.d.ts.map +0 -1
  755. package/dist/ssao-data.d.ts +0 -34
  756. package/dist/ssao-data.d.ts.map +0 -1
  757. package/dist/surface-format.d.ts +0 -10
  758. package/dist/surface-format.d.ts.map +0 -1
  759. package/dist/taa-history-store.d.ts +0 -88
  760. package/dist/taa-history-store.d.ts.map +0 -1
  761. package/dist/temporal-coverage.d.ts +0 -35
  762. package/dist/temporal-coverage.d.ts.map +0 -1
  763. package/dist/temporal-frame-transaction.d.ts +0 -92
  764. package/dist/temporal-frame-transaction.d.ts.map +0 -1
  765. package/dist/temporal-inspection.d.ts +0 -57
  766. package/dist/temporal-inspection.d.ts.map +0 -1
  767. package/dist/temporal-view.d.ts +0 -43
  768. package/dist/temporal-view.d.ts.map +0 -1
  769. package/dist/tilemap/resolve-tileset-runtime.d.ts +0 -23
  770. package/dist/tilemap/resolve-tileset-runtime.d.ts.map +0 -1
  771. package/dist/urp-pipeline.d.ts +0 -4
  772. package/dist/urp-pipeline.d.ts.map +0 -1
  773. package/src/__tests__/analytic-sky-contract.test.ts +0 -27
  774. package/src/__tests__/analytic-sky-falsify-carriers.mjs +0 -43
  775. package/src/__tests__/analytic-sky-falsify.test.ts +0 -94
  776. package/src/__tests__/assets-runtime-handoff.integration.test.ts +0 -36
  777. package/src/__tests__/backend-selection.integration.test.ts +0 -11
  778. package/src/__tests__/camera-temporal.test-d.ts +0 -8
  779. package/src/__tests__/camera-temporal.test.ts +0 -188
  780. package/src/__tests__/directional-shadow-probe-atlas-layout.unit.test.ts +0 -18
  781. package/src/__tests__/environment-inspection.test.ts +0 -45
  782. package/src/__tests__/fog-ai-user.fixture.ts +0 -350
  783. package/src/__tests__/fog-custom-render-feature.fixture.ts +0 -33
  784. package/src/__tests__/fog-custom-render-feature.integration.test.ts +0 -76
  785. package/src/__tests__/fog-inspection.integration.test.ts +0 -127
  786. package/src/__tests__/fog-owner-state.integration.test.ts +0 -112
  787. package/src/__tests__/fog-pipeline-topology.integration.test.ts +0 -93
  788. package/src/__tests__/fog-public-surface.integration.test.ts +0 -60
  789. package/src/__tests__/fog-ray-contract.integration.test.ts +0 -73
  790. package/src/__tests__/fog-source-absence.integration.test.ts +0 -51
  791. package/src/__tests__/fog-temporal.integration.test.ts +0 -115
  792. package/src/__tests__/frame-chain.unit.test.ts +0 -26
  793. package/src/__tests__/gpu-scene-field-type-owner.test-d.ts +0 -27
  794. package/src/__tests__/hdrp-pipeline.unit.test.ts +0 -100
  795. package/src/__tests__/ibl/ibl-fallback.unit.test.ts +0 -23
  796. package/src/__tests__/material-derived-error-stop-draw.integration.test.ts +0 -69
  797. package/src/__tests__/material-derived-payload.integration.test.ts +0 -164
  798. package/src/__tests__/materials.unit.test.ts +0 -25
  799. package/src/__tests__/param-schema-projection-census.unit.test.ts +0 -40
  800. package/src/__tests__/persistent-render-scene.unit.test.ts +0 -1311
  801. package/src/__tests__/pipeline-error-policy-owner.unit.test.ts +0 -167
  802. package/src/__tests__/pipeline-pass-trace.test.ts +0 -92
  803. package/src/__tests__/pipeline-stage-owner.test-d.ts +0 -13
  804. package/src/__tests__/plugin.test.ts +0 -25
  805. package/src/__tests__/prepared-graphics-backend-matrix.unit.test.ts +0 -129
  806. package/src/__tests__/prepared-graphics-resolver-recording.unit.test.ts +0 -180
  807. package/src/__tests__/public-pipeline-id.test-d.ts +0 -6
  808. package/src/__tests__/render-dispatch-membership.unit.test.ts +0 -117
  809. package/src/__tests__/render-feature-construction.unit.test.ts +0 -124
  810. package/src/__tests__/render-feature-error-code-owner.test-d.ts +0 -27
  811. package/src/__tests__/render-feature-gpu-buffer-usage-owner.test-d.ts +0 -46
  812. package/src/__tests__/render-feature-graph.integration.test.ts +0 -205
  813. package/src/__tests__/render-feature-graphics-staging.unit.test.ts +0 -200
  814. package/src/__tests__/render-feature-order.unit.test.ts +0 -66
  815. package/src/__tests__/render-feature-prepared-graphics-recording.unit.test.ts +0 -107
  816. package/src/__tests__/render-feature-staging.unit.test.ts +0 -94
  817. package/src/__tests__/renderer-render-scene-public.test-d.ts +0 -27
  818. package/src/__tests__/scene-temporal-coverage.unit.test.ts +0 -259
  819. package/src/__tests__/sun-snapshot-consumers.test.ts +0 -35
  820. package/src/__tests__/surface-backend-kind-owner.test-d.ts +0 -42
  821. package/src/__tests__/taa-history-store.unit.test.ts +0 -196
  822. package/src/__tests__/temporal-frame-transaction.integration.test.ts +0 -537
  823. package/src/__tests__/temporal-inspection.unit.test.ts +0 -138
  824. package/src/assets/__tests__/asset-decoders.unit.test.ts +0 -92
  825. package/src/assets/__tests__/mipmap-generator.unit.test.ts +0 -52
  826. package/src/assets/__tests__/render-asset-port.unit.test.ts +0 -54
  827. package/src/assets/__tests__/resolve-render-asset.unit.test.ts +0 -47
  828. package/src/components/__tests__/atmosphere-red.test.ts +0 -51
  829. package/src/components/__tests__/atmosphere.test.ts +0 -79
  830. package/src/components/__tests__/fog.test-d.ts +0 -49
  831. package/src/components/__tests__/fog.test.ts +0 -60
  832. package/src/components/atmosphere.ts +0 -64
  833. package/src/deferred-lighting.ts +0 -92
  834. package/src/dynamic-texture-store.ts +0 -111
  835. package/src/environment/README.md +0 -76
  836. package/src/environment/__tests__/failure-injection.test.ts +0 -50
  837. package/src/environment/__tests__/generation-red.test.ts +0 -64
  838. package/src/environment/__tests__/generation.test.ts +0 -37
  839. package/src/environment/__tests__/graph-transaction.test.ts +0 -85
  840. package/src/environment/__tests__/inspection-red.test.ts +0 -53
  841. package/src/environment/__tests__/lifecycle-evidence.test.ts +0 -40
  842. package/src/environment/__tests__/pipeline-topology.test.ts +0 -33
  843. package/src/environment/__tests__/readiness.test.ts +0 -42
  844. package/src/environment/__tests__/recovery.test.ts +0 -62
  845. package/src/environment/__tests__/resize-dispose.test.ts +0 -30
  846. package/src/environment/__tests__/signature-red.test.ts +0 -45
  847. package/src/environment/__tests__/signature.test.ts +0 -60
  848. package/src/environment/descriptors.ts +0 -7
  849. package/src/environment/extracted-environment.ts +0 -239
  850. package/src/environment/generation.ts +0 -158
  851. package/src/environment/gpu-bundle.ts +0 -144
  852. package/src/environment/graph.ts +0 -588
  853. package/src/environment/inspection.ts +0 -107
  854. package/src/environment/lifecycle.ts +0 -124
  855. package/src/environment/readiness.ts +0 -76
  856. package/src/environment/signature.ts +0 -185
  857. package/src/extract/__tests__/directional-csm-domain.unit.test.ts +0 -391
  858. package/src/extract/__tests__/environment-source.test.ts +0 -105
  859. package/src/extract/__tests__/schema-readers.unit.test.ts +0 -16
  860. package/src/extract/directional-csm.ts +0 -959
  861. package/src/extract/index.ts +0 -10
  862. package/src/extract/material-interface.ts +0 -604
  863. package/src/extract/schema-readers.ts +0 -27
  864. package/src/features/graph-contribution.ts +0 -577
  865. package/src/features/index.ts +0 -100
  866. package/src/features/morph/index.ts +0 -24
  867. package/src/features/morph/morph-bounds.ts +0 -123
  868. package/src/features/scene-temporal.ts +0 -274
  869. package/src/features/taa-resolve.ts +0 -244
  870. package/src/frame-chain.ts +0 -21
  871. package/src/hdrp-cluster-membership.ts +0 -70
  872. package/src/ibl/cubemap-projection.ts +0 -60
  873. package/src/ibl/face-uniforms.ts +0 -150
  874. package/src/mesh-update-errors.ts +0 -113
  875. package/src/mipmap-generator.ts +0 -244
  876. package/src/param-schema-projection-census.ts +0 -73
  877. package/src/persistent-render-scene.ts +0 -1752
  878. package/src/pipeline/index.ts +0 -40
  879. package/src/pipeline-errors.ts +0 -172
  880. package/src/prepare/__tests__/schema-readers.unit.test.ts +0 -16
  881. package/src/prepare/index.ts +0 -8
  882. package/src/prepare/schema-readers.ts +0 -20
  883. package/src/record/__tests__/environment-record.test.ts +0 -35
  884. package/src/record/__tests__/frame-targets.unit.test.ts +0 -54
  885. package/src/record/__tests__/membership-timing.unit.test.ts +0 -524
  886. package/src/record/__tests__/render-submission.integration.test.ts +0 -76
  887. package/src/record/__tests__/render-submission.perf.test.ts +0 -141
  888. package/src/record/__tests__/shadow-submit-mode.unit.test.ts +0 -88
  889. package/src/record/__tests__/view-ubo-layout.unit.test.ts +0 -101
  890. package/src/record/frame-observation.ts +0 -122
  891. package/src/record/index.ts +0 -15
  892. package/src/record/main-pass-skin.ts +0 -51
  893. package/src/record/main-pass-sprite.ts +0 -166
  894. package/src/record/material-payload.ts +0 -292
  895. package/src/record/material-slot-plan.ts +0 -68
  896. package/src/record/membership-timing.ts +0 -1012
  897. package/src/record/shadow-caster-uniform.ts +0 -37
  898. package/src/record/shadow-submit-mode.ts +0 -277
  899. package/src/render-dispatch-membership.ts +0 -155
  900. package/src/render-pipeline-context.ts +0 -332
  901. package/src/render-pipeline-target.ts +0 -96
  902. package/src/render-scene-projection.ts +0 -1738
  903. package/src/render-system-fold.ts +0 -531
  904. package/src/renderer/asset-service.ts +0 -32
  905. package/src/renderer/backend-selection.ts +0 -121
  906. package/src/renderer/environment-classify.ts +0 -30
  907. package/src/renderer/environment-error.ts +0 -19
  908. package/src/renderer/material/pipeline-projection.ts +0 -140
  909. package/src/renderer.ts +0 -940
  910. package/src/scene-utils/collect-subtree.ts +0 -40
  911. package/src/ssao-data.ts +0 -106
  912. package/src/surface-format.ts +0 -37
  913. package/src/taa-history-store.ts +0 -429
  914. package/src/temporal-coverage.ts +0 -106
  915. package/src/temporal-frame-transaction.ts +0 -301
  916. package/src/temporal-inspection.ts +0 -194
  917. package/src/temporal-view.ts +0 -174
  918. package/src/tilemap/resolve-tileset-runtime.ts +0 -72
package/README.md CHANGED
@@ -1,29 +1,38 @@
1
1
  # `@forgeax/engine-render`
2
2
 
3
- ## MaterialAsset 唯一成功路径
3
+ ## Render happy path
4
4
 
5
- Render 只消费 `paramSchema -> derive -> compile/reflect -> cook/load -> extract/record`
6
- 主线的 extract/record 阶段:从已验证的 material artifact 取得 slot 数据,按
7
- `coordinateSet`、transform `physicalUvScale` 写入 record,并以
8
- `layoutIdentity` 选择匹配的 bind-group layout。发现 identity 或坐标不一致时,
9
- 回到 producer inspect/repair/recook,不在 game-side 添加 padding fallback。
5
+ `RenderScene -> Standard Pipeline -> DeviceScope -> FrameReceipt` is the only frame
6
+ model. The host calls `createRenderer`, `attach(world)`, and `draw(request)`; diagnostics use
7
+ `inspect`, `observe(receipt, request)`, and `recover`. `FrameReceipt` is the synchronous proof that
8
+ submit completed. A failed `Result` carries `code`, `hint`, and `detail`; repair the named owner,
9
+ rebuild or cold-cook its source, then retry the same request.
10
10
 
11
- | 阶段 | 唯一 owner | 结果 |
12
- |---|---|---|
13
- | schema / derive | material producer | 派生参数与纹理字段 |
14
- | compile / reflect | shader compiler | 与 WGSL 一致的 artifact 输入 |
15
- | cook / load | pack 与 assets-runtime | 带 receipt 的 GUID payload |
16
- | extract / record | render | 与 identity 对齐的 draw bindings |
11
+ ```ts
12
+ const created = await createRenderer(canvas);
13
+ if (!created.ok) throw created.error;
14
+ const renderer = created.value;
15
+ const attached = renderer.attach(world);
16
+ if (!attached.ok) throw attached.error;
17
+ const frame = renderer.draw({
18
+ leases: [attached.value],
19
+ camera: { lease: attached.value },
20
+ environment: { lease: attached.value },
21
+ });
22
+ if (!frame.ok) throw frame.error;
23
+ const observation = await renderer.observe(frame.value, { include: ['timings'] });
24
+ ```
17
25
 
18
- > [!IMPORTANT]
19
- > Render 错误通过结构化 `code`、`detail`、`hint` 恢复;不要把非结构化文本、
20
- > app 侧安装或替代材质当作 contract。
26
+ The Standard pipeline selects direct or clustered lighting from capabilities and keeps shadow,
27
+ PBR, IBL, SSAO, bloom, tone, antialiasing, sky, material, VFX, and debug feature ownership inside
28
+ the same graph and submit boundary. CPU and WebGL2 fallback are capability lanes of that pipeline,
29
+ not second renderer identities.
21
30
 
22
31
  ## Direct-light parity contract
23
32
 
24
33
  The direct-light proposition is: one public `DirectionalLight`/`PointLight`/
25
- `SpotLight` semantic snapshot must produce the same analytic result in URP and
26
- HDRP. The M4 authority is the revision-pinned
34
+ `SpotLight` semantic snapshot must produce the same analytic result in every
35
+ Standard capability lane. The authority is the revision-pinned
27
36
  [`three-r184-finite-range-authority.json`](../../apps/parity/color-lighting/cases/direct-light/calibration/three-r184-finite-range-authority.json).
28
37
  It is `ready` only when its Three revision, source hash, config, and expected
29
38
  samples are present. Missing authority or paired GPU captures is `blocked`; do
@@ -46,7 +55,7 @@ The public mapping is deliberately small:
46
55
  | Color | Linear RGB; no hidden global multiplier | Light snapshot and buffer layout |
47
56
  | Range and decay | Positive range is meters; `Infinity` means no cutoff; runtime uses `e=2` | Three r184 authority |
48
57
  | Cone | KHR radians import to component degrees; snapshot stores `cosInner` and `cosOuter` | glTF bridge and extract |
49
- | Direction | KHR local `-Z` after world rotation; extract normalizes once; downstream shaders consume the result | Extract snapshot and URP/HDRP shaders |
58
+ | Direction | KHR local `-Z` after world rotation; extract normalizes once; downstream shaders consume the result | Extract snapshot and Standard shaders |
50
59
 
51
60
  The runtime finite-range factor is the Three r184 squared window:
52
61
  `clamp(1 - (d / c)^4, 0, 1)^2`. The KHR
@@ -61,228 +70,6 @@ must retain `provenance`, `captures`, `raw hash`, `analyticMax`, `roiMax`, and
61
70
  `verdict` for each backend x pipeline x case. A same-canvas self-comparison or
62
71
  analytic-only green result is not direct-light parity evidence.
63
72
 
64
- ## Fog: authoring, inspection, and recovery
65
-
66
- > [!IMPORTANT]
67
- > Fog is the one public scene-radiance component. Spawn it in the World that
68
- > is passed as resourceOwner; the renderer selects zero or one Fog entity,
69
- > validates the fields, publishes a candidate, and commits it only after a
70
- > successful frame submission. Applications do not register a post effect,
71
- > pack a Fog buffer, import Fog WGSL, or maintain Fog history.
72
-
73
- The shortest authoring route is one public import plus the existing draw owner:
74
- The minimum form is world.spawn({ component: Fog, data: {} }) when defaults are sufficient.
75
-
76
- ```ts
77
- import { Fog } from '@forgeax/engine-render';
78
- import type { RenderError } from '@forgeax/engine-render';
79
-
80
- const fogEntity = world.spawn({
81
- component: Fog,
82
- data: {
83
- color: [0.45, 0.52, 0.6],
84
- density: 0.018,
85
- heightFalloff: 0.15,
86
- maxOpacity: 0.85,
87
- },
88
- }).unwrap();
89
-
90
- const drawn = renderer.draw([world], { cameraOwner: 0, resourceOwner: 0 });
91
- if (!drawn.ok) reportRenderError(drawn.error as RenderError);
92
- const fogInspection = renderer.renderScene.fog;
93
- void fogEntity;
94
- void fogInspection;
95
- ```
96
-
97
- ### Authoring domain
98
-
99
- | Field | Valid domain | Default | Meaning |
100
- |:--|:--|--:|:--|
101
- | color | three finite non-negative numbers | [0.5, 0.5, 0.5] | Linear Fog radiance color; HDR values are valid |
102
- | density | finite number >= 0 | 0.01 | Base optical density |
103
- | heightFalloff | finite number >= 0 | 0 | Exponential density falloff along world y |
104
- | maxOpacity | finite number in [0, 1] | 1 | Upper bound for the Fog mix; surface alpha is preserved |
105
-
106
- The component has no mode, profile, baseHeight, start, or end field.
107
- heightFalloff = 0 is the uniform-density lane. A missing Fog entity means
108
- disabled scene Fog and adds no Fog-owned graph resource, pass, texture, bind
109
- group, or history. A second Fog entity in the same resourceOwner is a
110
- structured conflict, not a winner-selection policy.
111
-
112
- resourceOwner is an existing numeric World owner, not a string resource:
113
-
114
- | Fog cardinality in the selected owner | Renderer fact | Recovery |
115
- |:--:|:--|:--|
116
- | 0 | enabled=false; no accepted Fog snapshot | Continue without scene Fog |
117
- | 1 | Candidate is validated and becomes last-known-good after submit | Read renderer.renderScene.fog |
118
- | N | fog-owner-conflict; no new candidate is published | Remove every extra Fog entity, then retry draw |
119
-
120
- ### Bounded inspection
121
-
122
- Read the accepted facts after draw:
123
-
124
- ```ts
125
- const fog = renderer.renderScene.fog;
126
- const accepted = {
127
- enabled: fog.enabled,
128
- resourceOwner: fog.resourceOwner,
129
- entity: fog.entity,
130
- revision: fog.revision,
131
- reactive: fog.reactive,
132
- failure: fog.failure,
133
- };
134
- ```
135
-
136
- The inspection is bounded and read-only. revision changes when a successful
137
- Fog authoring candidate changes; reactive is true on the current frame when
138
- the accepted revision changed. A failed candidate does not replace the
139
- last-known-good snapshot. failure is either fog-owner-conflict,
140
- fog-parameters-invalid, or undefined; it is not a free-form diagnostic
141
- registry.
142
-
143
- ### Structured errors and exhaustive recovery
144
-
145
- Fog failures are members of the closed RenderError union:
146
- FogOwnerConflictError has code fog-owner-conflict, while
147
- FogParametersInvalidError has code fog-parameters-invalid. Both errors expose
148
- code, detail, expected, and hint; detail carries the bounded values needed for
149
- a retry.
150
-
151
- ```ts
152
- function recoverFog(error: RenderError): 'retry' | 'forward' {
153
- switch (error.code) {
154
- case 'fog-owner-conflict':
155
- // Remove all but one Fog entity in error.detail.resourceOwner.
156
- return 'retry';
157
- case 'fog-parameters-invalid':
158
- // Set error.detail.field to a value satisfying error.expected.
159
- return 'retry';
160
- default:
161
- return 'forward';
162
- }
163
- }
164
- ```
165
-
166
- For fog-owner-conflict, inspect error.detail.entities and
167
- error.detail.omitted; remove every extra entity from that resourceOwner, then
168
- retry draw. For fog-parameters-invalid, inspect error.detail.entity,
169
- error.detail.field, error.detail.actual, and the structured expected domain;
170
- repair the ECS field and retry. Do not parse the error message, create a
171
- fallback material, or silently disable Fog.
172
-
173
- ### Height-aware scene-radiance formula
174
-
175
- The shared forgeax_view::fog module integrates optical depth along a
176
- producer-supplied world-space ray. Let y0 be the ray origin height, dy its
177
- world-space vertical direction, d its linear distance, h the height falloff,
178
- and rho the authored density:
179
-
180
- $$
181
- \rho_0 = \rho e^{-h y_0},\qquad
182
- q = h\,dy,\qquad
183
- \tau =
184
- \begin{cases}
185
- \rho_0 d & |q| < \epsilon,\\
186
- \rho_0 \dfrac{1-e^{-qd}}{q} & |q| \geq \epsilon.
187
- \end{cases}
188
- $$
189
-
190
- $$
191
- T = e^{-\tau},\qquad
192
- \alpha_f = \operatorname{clamp}(m(1-T), 0, 1),\qquad
193
- C' = \operatorname{mix}(C, C_f, \alpha_f),
194
- $$
195
-
196
- where m is maxOpacity, C is the producer color, and Cf is the authored
197
- linear Fog color. The output keeps the producer alpha unchanged. CPU
198
- extraction and WGSL share the same field order and ray contract; near/far
199
- values and non-linear depth are not Fog inputs.
200
-
201
- ### Producer and pipeline responsibility
202
-
203
- Fog is applied exactly once to linear scene radiance before the
204
- renderer-owned temporal resolve. URP and HDRP keep their existing pipeline
205
- order; opaque, masked, unlit, Standard PBR, transparent, Sprite, Text,
206
- Skybox, and the five VFX render paths supply their own ray facts and call the
207
- shared module. G-buffer facts, shadow maps, and overlay/debug output are not
208
- Fog inputs. Alpha is preserved for transparent and VFX output.
209
-
210
- ```mermaid
211
- flowchart TD
212
- Author["World spawns one Fog entity"] --> Extract["extract selects resourceOwner"]
213
- Extract --> Candidate["validate and stage candidate"]
214
- Candidate --> Submit{"successful frame submit"}
215
- Submit -->|yes| Accepted["publish revision and bounded inspection"]
216
- Submit -->|no| Lkg["retain last-known-good snapshot"]
217
- Accepted --> Scene["linear scene-radiance Fog exactly once"]
218
- Scene --> Temporal["existing temporal resolve"]
219
- ```
220
-
221
- No Fog-specific pass, texture, bind group, upload, history, registry, or
222
- fullscreen fallback is part of this route. TAA remains the sole history owner;
223
- Fog revision changes use its existing current-frame reactive lane.
224
-
225
- ### Real evidence commands
226
-
227
- Run the focused contracts first, then the two independent feature carriers:
228
-
229
- ```sh
230
- pnpm exec vitest run --project='@forgeax/engine-render' packages/render/src/__tests__/fog-public-surface.integration.test.ts packages/render/src/__tests__/fog-source-absence.integration.test.ts packages/render/src/__tests__/fog-custom-render-feature.integration.test.ts
231
- pnpm --filter @forgeax/bevy-fog smoke
232
- pnpm --filter @forgeax/bevy-fog smoke:browser
233
- ```
234
-
235
- Each carrier must write case-wise expected, observed, delta, verdict, and
236
- confidence fields plus revision/reactive/recovery facts. The Dawn artifact is
237
- evidence/dawn-fog-trace.json; the Browser artifact is
238
- evidence/browser-fog-trace.json. PNG is auxiliary evidence: it never replaces
239
- linear readback or the case-wise verdict.
240
-
241
- > [!CAUTION]
242
- > The current M4 Dawn and Browser 300-frame artifacts are real executions but
243
- > remain verdict: fail because their RGB deltas exceed 0.02. This README
244
- > records the failure rather than promoting it to green. Preserve the
245
- > artifacts and repair the Engine owner before claiming visual parity.
246
-
247
- ### Custom RenderFeature responsibility
248
-
249
- A custom RenderFeature can consume the renderer-owned scene-color target and
250
- contribute an overlay through the existing graph seam. It must not become a
251
- second Fog owner or create fog-texture, fog-history, fog-bind-group,
252
- Fog-specific upload state, or a parallel formula. The executable fixture is
253
- src/__tests__/fog-custom-render-feature.fixture.ts; its compile/import/overlay
254
- evidence is evidence/custom-render-feature-compile.json and contains the
255
- fixture path, compiler command, exitCode, moduleImport, and overlay verdict.
256
-
257
- <details>
258
- <summary>Custom feature boundary checklist</summary>
259
-
260
- - [x] Consume existing graph targets instead of allocating a Fog resource.
261
- - [x] Keep engine-render as the Fog owner.
262
- - [x] Use the public RenderFeature lifecycle and opaque staging references.
263
- - [ ] Add a new public capability only through a separate design and owner review.
264
-
265
- </details>
266
-
267
- ### Out of scope for this Fog contract
268
-
269
- | Deferred capability | Boundary |
270
- |:--|:--|
271
- | Linear start/end, Exp2, baseHeight, public mode/profile, or a second Fog component | Reopen design only if a real scene proves the single density field insufficient |
272
- | Froxel/raymarch volume, 3D density, phase/scattering, light/shadow injection, or temporal volume denoise | Separate volume and lighting owner |
273
- | Local Fog volumes, overlap/blend, or directional phase | Separate volume composition authority |
274
- | Atmosphere, Sun, analytic sky, clouds, weather, or cloud shadow | Separate sky/weather/environment owner |
275
- | OIT, layered media, volume compositing, or automatic exposure | Separate transparency and color-management owners |
276
- | Fog-specific pass, texture, bind group, upload, history, or coverage registry | Explicitly forbidden because they duplicate RenderGraph/View/TAA SSOT |
277
- | Frozen GPU epsilon, exponent, or full diagnostic UI | Keep implementation details behind ABI and bounded evidence |
278
-
279
- M5 closure remains explicit:
280
-
281
- - [x] Public Fog schema and bounded inspection are documented.
282
- - [x] One-cut app source absence and two closed recovery errors are indexed.
283
- - [x] Real Dawn/Browser evidence paths and their current failed verdicts are linked.
284
- - [ ] RGB tolerance repair and full smoke-fleet gates remain required.
285
-
286
73
  ## Particle feature boundary
287
74
 
288
75
  Particle rendering is provided by
@@ -291,71 +78,26 @@ generic RenderFeature host, prepared graphics resolver, pipeline readiness
291
78
  contract, and structured renderer errors; it does not own VFX simulation or
292
79
  particle asset authoring.
293
80
 
294
- ## Deferred membership timing
295
-
296
- Render owns the opt-in `membershipTiming` contract for the real
297
- `hdrp-cluster-membership` compute pass. App and Runtime only forward the option;
298
- they do not define a second profiler or reason vocabulary.
299
-
300
- | Mode | Work | Result |
301
- |:--|:--|:--|
302
- | omitted | No query set, resolve buffer, map, or queue wait | No timing record |
303
- | `cpu-control` | Existing CPU binner remains the control path | Accepted control record with `gpu: null` |
304
- | `gpu` | Bounded timestamp query, resolve, async queue completion, and map | GPU ticks plus backend period, or a terminal refusal/error |
305
-
306
- > [!IMPORTANT]
307
- > A GPU request is refused when the backend does not advertise timestamp
308
- > queries or a positive timestamp period. RhiNull and the wgpu WebGL2 path are
309
- > intentionally non-timing backends. They never synthesize GPU duration.
310
-
311
- The controller timestamps immediately around the existing membership dispatch,
312
- keeps GPU ticks separate from CPU encode/submit and async readback, and
313
- terminalizes captures on timeout, submit failure, queue completion failure,
314
- readback failure, device recovery, or disposal. The closed
315
- `MembershipTimingReasonCode` union and its exhaustive mapping live in
316
- [`src/record/membership-timing.ts`](src/record/membership-timing.ts).
317
-
318
- Timestamp-capable backends must execute both raw timestamp writes. A missing or
319
- throwing write is a structured `timestamp-write-unavailable` refusal; Render
320
- never publishes a zero, reversed, or non-finite GPU interval as a report.
321
-
322
- ## Deferred membership evidence closure
81
+ ## Deferred lighting evidence
323
82
 
324
- > [!IMPORTANT]
325
- > The close condition is `acceptedGpu=16`, with five accepted Dawn GPU
326
- > records at each of 32, 64, and 128 lights, one 256-light record, positive
327
- > tick intervals, per-light-count variance, and the 256-light overflow
328
- > fingerprint. `acceptedGpu=0` is a blocker. CPU control, WebKit refusal,
329
- > RhiNull refusal, PNG screenshots, and capability bits never count as GPU
330
- > evidence.
331
-
332
- The producer and validator are deliberately separate from the public Render
333
- API. Generate the exact manifest, run the full producer matrix, and inspect
334
- the machine-readable report in this order:
335
-
336
- ```sh
337
- node scripts/dev-verify/generate-deferred-membership-manifest.mjs --output=report/deferred-membership-timing/full-matrix-manifest.json
338
- node scripts/dev-verify/capture-deferred-membership-corpus.mjs --manifest=report/deferred-membership-timing/full-matrix-manifest.json --output-root=report/deferred-membership-timing --webkit-download=webkit-evidence --report=report/deferred-membership-timing
339
- ```
340
-
341
- The manifest contract is [`full-matrix-contract.json`](../../scripts/dev-verify/membership-timing/full-matrix-contract.json); the WebKit subset is validated by [`webkit-subset.schema.json`](../../scripts/dev-verify/membership-timing/webkit-subset.schema.json). The stable identity is `sourceHead`, `carrier`, `workload`, `profile`, and `artifactHashes`. The exact target is 20 top-level records and 32 nested references, with `record`, `profile`, `membership`, and `pixel` SHA-256 descriptors.
342
-
343
- The report exposes `valid`, `truthfulnessReady`, `completeMatrixReady`,
344
- `optimizationReleaseReady`, `counts`, `errors`, and `blocker`. A blocker uses
345
- `code`, `expected`, `hint`, and the observed `acceptedGpu` count so an AI user
346
- can recover by inspecting per-attempt refusal, profile, identity, and artifact
347
- hash records. The owner reason union remains closed; for example,
348
- `timestamp-query-unsupported` is a refusal, while `timestamp-write-unavailable`
349
- is a terminal producer failure. Neither is a successful GPU sample.
83
+ Deferred lighting validation is consumer evidence, not a Render production
84
+ subsystem. The learn-render smoke exercises the Standard clustered path and
85
+ the profiler captures bounded CPU ownership evidence; the WebKit fallback
86
+ gate exercises the browser delivery path. Runtime inspection uses the public
87
+ `inspect` and `observe` projections, while any future timestamp benchmark
88
+ belongs in `packages/render/bench` and its dev-verify producer. Render does
89
+ not expose a timing controller or a second membership-specific API.
350
90
 
351
91
  ## RenderFeature: the producer seam (first-read index)
352
92
 
353
- The public route remains `RenderFeature` through `RenderPipeline` and the
354
- active RenderGraph pass. This is the RenderGraph pass for a `type FrameData`
355
- producer, which uses
356
- `createRenderer(canvas, { features: [feature] })`,
357
- `context.staging.addPass('named-pass'`, `execute: ({ pass })`, and the
358
- `Material pass` boundary. This is the graph-only Wave 1 feature route.
93
+ The public route is one `RenderFeature<FrameData>` through the Standard
94
+ Pipeline and the active RenderGraph pass. In the examples below, `type FrameData`
95
+ is the producer-owned extracted value. A feature extracts one frame value,
96
+ then its mandatory `plan(data, context)` declares named resources and passes;
97
+ the host derives graph access, preparation, recording, and recovery from that
98
+ plan. Register it at construction with
99
+ `createRenderer(canvas, { features: [feature] })`. A feature never receives a
100
+ device, queue, encoder, staging builder, or submit callback.
359
101
 
360
102
  > [!IMPORTANT]
361
103
  > Render consumes the effective MaterialAsset snapshot produced by extract. Each texture slot carries its own coordinate set and transform into the built-in PBR binding layout; render records do not reinterpret authoring fields or manufacture shader artifacts. The effective `passes` are already validated.
@@ -393,31 +135,22 @@ The render path is `MaterialAsset` -> extract snapshot -> prepare resources -> r
393
135
  > Owner: render vocabulary and the extract → prepare → record frame boundary. Runtime selects concrete services and calls this package; it does not re-own these tokens.
394
136
 
395
137
  ```ts
396
- import {
397
- Camera,
398
- materialTextureValue,
399
- MeshFilter,
400
- MeshRenderer,
401
- } from '@forgeax/engine-render';
138
+ import { Camera, MeshFilter, MeshRenderer } from '@forgeax/engine-render';
402
139
  import { createRenderer } from '@forgeax/engine-runtime';
403
140
 
404
141
  const renderer = await createRenderer(canvas);
405
- const ready = await renderer.ready;
406
- const attached = renderer.attachWorld(world);
407
- if (ready.ok && attached.ok) {
142
+ const attached = renderer.attach(world);
143
+ if (attached.ok) {
408
144
  world.update(1 / 60).unwrap();
409
- renderer.draw([world], { cameraOwner: 0, resourceOwner: 0 });
145
+ renderer.draw({
146
+ leases: [attached.value],
147
+ camera: { lease: attached.value },
148
+ environment: { lease: attached.value },
149
+ });
410
150
  }
411
-
412
- // A numeric texture handle is normalized into the structured material slot.
413
- const values = { baseColorTexture: materialTextureValue(textureHandle) };
414
151
  ```
415
152
 
416
- For the full slot contract, read [`MaterialTextureValue`](../types/src/material/asset.ts)
417
- and keep `baseColorTexture` on the same `paramSchema -> derive -> cook/load ->
418
- extract/record` path.
419
-
420
- `attachWorld` installs renderer-required derived-state systems once. Hosts built
153
+ `attach` installs renderer-required derived-state systems once. Hosts built
421
154
  with `createApp` get this wiring automatically. A custom loop attaches each
422
155
  World before its first update, then keeps `draw` as a read-only consumer of the
423
156
  state published by `World.update()`.
@@ -425,12 +158,10 @@ state published by `World.update()`.
425
158
  ## Persistent render scene
426
159
 
427
160
  The ordinary single-World path bootstraps one renderer-owned CPU projection,
428
- then drains the World's bounded change journal. Each attached World generation
429
- receives one renderer-local `WorldRenderId`; draw-array reordering cannot change
430
- that identity, while detach retires it before the same World object can
431
- reattach. A no-change frame reuses the last visible snapshot without traversing
432
- renderable archetypes; transform changes update only their stable projection
433
- slots. Unrelated gameplay component writes do not invalidate render state.
161
+ then drains the World's bounded change journal. A no-change frame reuses the
162
+ last visible snapshot without traversing renderable archetypes; transform
163
+ changes update only their stable projection slots. Unrelated gameplay
164
+ component writes do not invalidate render state.
434
165
 
435
166
  Mutable shared payloads use the same explicit-dirty rule: mutate the resolved
436
167
  payload, then call `world.sharedRefs.markChanged(handle)`. The renderer compares
@@ -458,7 +189,7 @@ are real driver/pixel proofs for the GPU-driven boundary; they do not make
458
189
  RhiNull a pixel backend or make the CPU projection cease to be the scene
459
190
  authority.
460
191
 
461
- Inspect the current path through `renderer.renderScene`. Its CPU counters expose
192
+ Inspect the current path through `renderer.inspect()`. Its detached CPU snapshot exposes
462
193
  full rebuilds, no-change and delta frames, transform/material/instance updates,
463
194
  removals, the journal cursor, projection cardinality, and the last resync
464
195
  reason. The nested `gpu` status is one of `inactive`, `unsupported`, `resident`,
@@ -466,7 +197,9 @@ reason. The nested `gpu` status is one of `inactive`, `unsupported`, `resident`,
466
197
  upload ranges and bytes, grows, clears, rebuilds, and no-change frames. The
467
198
  `gpuDriven` inspection reports whether stable frames materialized or validated
468
199
  GPU-owned rows and whether candidate or batch topology bytes were uploaded.
469
- GPU errors also use the existing `renderer.onError` channel.
200
+ GPU and renderer contract errors arrive through the single `renderer.subscribe`
201
+ event stream (`event.kind === 'error'`); the renderer does not expose a second
202
+ error listener registry.
470
203
 
471
204
  ## GPU-driven view kernel
472
205
 
@@ -480,28 +213,27 @@ primitive world transform with each ordinary instance-local transform, writes a
480
213
  compact `(instanceIndex, materialIndex)` stream, sets explicit overflow flags,
481
214
  and emits indirect arguments with `firstInstance = 0`.
482
215
 
483
- The URP frame activates the production raster lane when compute, storage
216
+ The Standard frame activates the production raster lane when compute, storage
484
217
  buffers, and indirect drawing are available. The current lane accepts opaque,
485
218
  rigid default-unlit passes with batch-stable render state, ordinary instances,
486
219
  indexed or non-indexed geometry, multiple submeshes and material slots, and the
487
220
  canonical `12F` vertex layout. It also accepts persistent rigid multi-World
488
- composition keyed by stable renderer-local World identity instead of the
489
- current `draw(worlds)` order. Candidates come from the complete persistent
490
- projection rather than the CPU-visible snapshot. The same typed graph imports the scene and mesh
221
+ composition. Candidates come from the complete persistent projection rather
222
+ than the CPU-visible snapshot. The same typed graph imports the scene and mesh
491
223
  buffers, runs the three compute passes, and consumes generated arguments with
492
224
  `drawIndexedIndirect` or `drawIndirect`. Entities accepted by that lane are not
493
225
  also validated, uploaded, or recorded by the CPU forward loop on a stable
494
226
  frame.
495
227
 
496
- HDRP, PBR and custom shader variants, texture/sampler/video resource bindings,
228
+ clustered, PBR and custom shader variants, texture/sampler/video resource bindings,
497
229
  transparent meshes, skinning, morphing, non-canonical layouts, and shadow views
498
230
  keep explicit CPU or specialized lanes. WebGL2 selects capability fallback from
499
231
  the same persistent projection; it does not emulate compute. Visibility and
500
232
  hierarchy changes, non-rigid multi-World composition, and some prepared-resource
501
233
  changes still require bounded reconcile work. The implemented lane proves a
502
234
  zero-upload stable data path and broad rigid geometry coverage, but hardware
503
- 100k timing, schema-derived material variants, visibility/hierarchy-local
504
- routing, and GPU-driven shadows remain required before declaring P3 complete.
235
+ 100k timing, schema-derived material variants, stable world identities, and
236
+ GPU-driven shadows remain required before declaring P3 complete.
505
237
 
506
238
  The bounded inspection reports topology revision, candidates, batches, visible
507
239
  capacity, buffer capacities, update count, upload bytes, rebuild count, and CPU
@@ -509,7 +241,7 @@ fallback rows. RhiNull verifies graph dependency order and stable-frame zero
509
241
  work; Dawn and Chromium verification consume indexed, non-indexed,
510
242
  multi-submesh, and instanced arguments, read persistent scene tables in the
511
243
  vertex path, and compare the resulting pixel. The renderer-level RhiNull
512
- integration also proves that the built-in URP graph contains the compute chain
244
+ integration also proves that the built-in Standard graph contains the compute chain
513
245
  before `main`, including rigid multi-World composition, without GPU plus CPU
514
246
  duplicate draws. The renderer retains one graph, one compile owner, one
515
247
  encoder, and one submit route.
@@ -522,71 +254,11 @@ encoder, and one submit route.
522
254
  > semantics; later coverage can make those changes entity-local without adding
523
255
  > another scene authority.
524
256
 
525
- When a host constructs a feature only after its World or asset catalogue is
526
- ready, use `await renderer.installRenderFeature(feature)`. The late path inserts into
527
- the same lifecycle host and RenderGraph ordering as boot-time features; it is
528
- not a second renderer. Installing the same object twice is idempotent, while a
529
- different object with the same identity returns the structured registration
530
- conflict. Awaiting also completes the feature's declared material-shader
531
- prewarm, so its first prepared draw observes the same ready barrier as a
532
- boot-time feature.
533
-
534
- This is the graph-only Wave 1 feature route; prepared graphics and late shader
535
- prewarm extend the same lifecycle for production asset features.
536
-
537
- When a late-installed feature remains registered through device loss, its declared material
538
- shaders remain part of the renderer's live prewarm set. `await renderer.recover()` therefore
539
- rebuilds those modules before the next prepared draw rather than relying on a one-frame retry.
540
-
541
- For capability composition, `rendererPlugin(renderer)` provides the Host-owned
542
- renderer and `renderFeaturePlugin(feature)` binds installation to a Cordis
543
- Fiber. Fiber disposal calls `uninstallRenderFeature`, waits for submitted GPU
544
- work, releases prepared batches/resources, and removes the feature's shader
545
- prewarm declarations before the disposer resolves. The Fiber is never queried
546
- inside extract, prepare, record, RenderGraph execution, or an RHI command loop.
547
-
548
- When an App or Engine Worker owns the host-created Renderer itself, it installs
549
- `ownedRendererPlugin(renderer)`. The same Provider publishes the renderer
550
- Service and calls `Renderer.dispose()` after dependent capability Fibers have
551
- unwound. Assemble-form Apps use borrowed `rendererPlugin(renderer)` instead.
552
-
553
- ```ts
554
- const fiber = await app.pluginContext.plugin(renderFeaturePlugin(feature));
555
- await fiber.dispose();
556
- ```
557
-
558
- Boot-time `features: [...]` remains the direct renderer-construction path. Use
559
- the plugin helper when the feature belongs to an optional or reloadable
560
- capability whose lifetime must be reversible.
561
-
562
- ### Built-in pipeline identity and cleanup
563
-
564
- The built-in Universal Render Pipeline is registered under the stable public
565
- identifier `URP_PIPELINE_ID` (`'forgeax::urp'`). Import the identifier from the
566
- public `@forgeax/engine-render` entry when constructing a
567
- `RenderPipelineAsset`; the `urpPipeline` implementation remains engine-owned.
568
-
569
- ```ts
570
- import { URP_PIPELINE_ID } from '@forgeax/engine-render';
571
-
572
- const asset = {
573
- kind: 'render-pipeline',
574
- pipelineId: URP_PIPELINE_ID,
575
- config: {},
576
- };
577
- const cleanup = renderer.installPipeline(asset);
578
- if (cleanup.ok) {
579
- // Keep this disposer with the Renderer / Fiber that installed the asset.
580
- cleanup.value();
581
- }
582
- ```
583
-
584
- > [!IMPORTANT]
585
- > Pipeline, post-process, and RenderFeature registrations belong to a
586
- > Renderer instance and must be disposed with that instance or its owning
587
- > Fiber. Do not add a module-level `installed` set or reach through
588
- > `renderer.store`; those are lifecycle and allocation internals, not public
589
- > extension state.
257
+ Features are supplied through the construction options (`features: [...]`) and
258
+ enter the same host-owned extract plan → graph projection path. The public
259
+ `Renderer` intentionally has no install/uninstall methods: optional capability
260
+ lifetime belongs to the App host, while recovery re-runs the plan against the
261
+ replacement device generation.
590
262
 
591
263
  | This package owns | Excluded concepts |
592
264
  |:--|:--|
@@ -657,92 +329,68 @@ const renderer = await createRenderer(canvas, { profiler });
657
329
  ```
658
330
 
659
331
  Use the package's `validateProfileCapture` and `buildProfileModel` entries for offline analysis.
660
- The render package remains the owner of render vocabulary and extract/prepare/record execution.
332
+ The render package remains the owner of render vocabulary and extract/plan/record execution.
661
333
 
662
334
  ## RenderFeature: the producer seam
663
335
 
664
336
  Register one producer-owned feature at the renderer assembly boundary. The
665
- same `FrameData` type flows through `extract`, `prepare`, and `contribute`;
666
- the host supplies ordering, capability projection, graph composition, and
667
- lifecycle isolation.
668
- Both paths execute inside the active RenderGraph and the frame's single
669
- execute/submit boundary.
337
+ same `FrameData` type flows through `extract` and the mandatory `plan`; the
338
+ host derives preparation, graph access, recording, and lifecycle isolation
339
+ from that one plan. Both paths execute inside the active RenderGraph and the
340
+ frame's single execute/submit boundary.
670
341
 
671
- The smallest graph-only feature can still use `addResource` plus `addPass` for
672
- CPU callbacks. GPU work uses the typed methods on the same staging object:
342
+ The smallest feature returns a closed plan with named resources and passes.
343
+ Graph access is derived from those declarations; there is no staging object or
344
+ second contribution API:
673
345
 
674
346
  ```ts
675
- contribute: (_frame, context) => {
676
- context.staging.addComputePass('compact', computeDescriptor).unwrap();
677
- context.staging.addGraphicsPass('draw', graphicsDescriptor).unwrap();
678
- return ok(undefined);
679
- }
347
+ plan: (frame, context) => ok({
348
+ resources: [
349
+ { kind: 'compute-program', name: 'compact.program', program },
350
+ { kind: 'compute-bindings', name: 'compact.bindings', program: 'compact.program', entries },
351
+ ],
352
+ passes: [{
353
+ kind: 'compute', name: 'compact', program: 'compact.program',
354
+ bindings: 'compact.bindings', dispatches,
355
+ }],
356
+ })
680
357
  ```
681
358
 
682
- `computeDescriptor` contains only prepared program/binding references and
683
- dispatches. `graphicsDescriptor` contains logical feature targets, prepared
684
- pipeline/binding/data references, and draw or indirect-draw commands. The host
685
- projects both into one typed `RenderGraph`; neither descriptor owns an encoder.
359
+ The plan contains cooked program descriptors, named buffers and bindings, logical
360
+ targets, and draw/dispatch commands. Graph buffer and texture access is derived
361
+ from those roles; producers never author a second `reads`/`writes` ledger and
362
+ never receive an encoder or submit authority.
686
363
 
687
364
  ### Five render terms
688
365
 
689
366
  | Term | Meaning | Owner |
690
367
  |:--|:--|:--|
691
- | `RenderFeature` | Producer-owned extract/prepare/contribute callbacks and frame data | Feature producer |
692
- | `RenderPipeline` | Full frame policy selected or switched by the host | Render host |
693
- | RenderGraph pass | One declared graph execution node contributed to the active pipeline | Graph host |
368
+ | `RenderFeature` | Producer-owned extract/plan callbacks and frame data | Feature producer |
369
+ | `Standard Pipeline` | The single frame policy containing the supported capability/profile lanes | Render host |
370
+ | RenderGraph pass | One declared graph execution node in the active Standard Pipeline | Graph host |
694
371
  | Material pass | One shader-facing pass in a `MaterialAsset` | Material asset |
695
- | Prepared graphics | Opaque pipeline, binding, vertex/index, and attachment references prepared by the host | Render host |
696
- | Prepared GPU work | Opaque persistent compute program, binding, buffer, dispatch, and indirect-draw references | Render host |
372
+ | RenderFeaturePlan | One executable declaration of resources, bindings, targets, and commands | Feature producer |
697
373
 
698
374
  ### Prepared compute resources
699
375
 
700
- `RenderFeature` producers prepare cooked compute pipelines, reflected name-based bindings,
701
- uniform/storage buffers, and dispatches. The renderer joins reflection with prepared binding
702
- entries, imports the persistent buffers into the render graph, and derives `uniform-read`,
376
+ `RenderFeature` producers declare cooked compute pipelines, reflected name-based bindings,
377
+ uniform/storage buffers, and dispatches. The renderer prepares those declarations,
378
+ imports the persistent buffers into the render graph, and derives `uniform-read`,
703
379
  `storage-read`, or `storage-read-write` access. Producers do not repeat a string `reads/writes`
704
380
  ledger and do not receive an encoder.
705
381
 
706
- Compute and graphics passes use the same contribution graph and submission boundary. The graph
707
- owns `beginComputePass` / `end`; prepared GPU work records only pipeline, bind group, and dispatch
708
- commands into the lent pass encoder. Persistent buffers retain device identity across frames,
382
+ Compute and graphics passes use the same plan projection and submission boundary. The graph
383
+ owns `beginComputePass` / `end`; the plan records only named pipeline, bind group, and dispatch
384
+ commands. Persistent buffers retain device identity across frames,
709
385
  rebuild with the feature-host generation, and retire only after queue completion. A storage buffer
710
386
  may also be consumed as renderer-declared vertex data.
711
387
 
712
388
  Feature contexts never expose raw GPU graphics state, a complete pipeline
713
- context, submit authority, or a command encoder. They expose an immutable
714
- `Readonly<RhiCaps>` capability snapshot for capability-gated preparation. The
715
- graph-only `addPass`
716
- surface still exposes only named pass and frame identity; use the prepared
717
- graphics surface below when a feature needs pipelines, bindings, vertex/index
718
- data, attachments, and draw records. Both paths execute inside the active
719
- RenderGraph and the frame's single execute/submit boundary. The active RenderGraph
720
- owns that frame boundary. Do not cast either context to a raw device or encoder. See
721
- [`features/graph-contribution.ts`](src/features/graph-contribution.ts) for the
722
- staging shape.
723
-
724
- The copyable recipe above is therefore a graph-only Wave 1 feature; it stops at
725
- the graph seam and does not provide a production particle draw path.
726
-
727
- ### Prepared graphics recipe
728
-
729
- Prepared graphics extends the existing graph-owned staging seam with five
730
- opaque reference kinds. A producer requests preparation during `prepare`,
731
- retains only the returned references, and contributes declarative records. The
732
- render host owns generation checks, graph composition, recording, and submit.
733
-
734
- Persistent GPU work follows the same ownership rule. A feature may retain opaque bindings for an
735
- active producer; bindings retain their transitive program and buffers. Untouched resources are
736
- detached after a successful feature frame and destroyed after queue completion, never while an
737
- in-flight command can still reference them.
738
-
739
- Prepare opaque references through `context.graphics` and, when compute is
740
- available, `context.gpu`; retain those references in producer-owned frame data
741
- and consume them only through `addComputePass` and `addGraphicsPass` during
742
- `contribute`. The executable contract examples live in
743
- [`render-feature-graph.integration.test.ts`](src/__tests__/render-feature-graph.integration.test.ts)
744
- and
745
- [`render-feature-gpu-work.integration.test.ts`](src/__tests__/render-feature-gpu-work.integration.test.ts).
389
+ context, submit authority, or a command encoder. They expose immutable
390
+ capabilities and logical targets for plan construction. The active RenderGraph
391
+ owns the frame boundary; do not cast a plan context to a backend object or
392
+ encoder. The executable contract examples live in the plan-focused tests under
393
+ `src/record/__tests__` and `src/features`.
746
394
 
747
395
  ### Failure and recovery
748
396
 
@@ -756,19 +404,17 @@ consume the structured `error.detail` context.
756
404
  |:--|:--|
757
405
  | `active` | Continue the next frame |
758
406
  | `failed` / `render-feature-stage-failed` | Correct producer data and retry on the next frame |
759
- | `disabled` / `render-feature-capability-missing` | Provide the capability on a replacement device; after device-loss recovery call `await renderer.recover()`. On a live renderer, `recover()` returns `recover-not-needed`, so rebuild on a capable device instead. |
407
+ | `disabled` / `render-feature-capability-missing` | Provide the capability on a replacement device; after device-loss recovery call `await renderer.recover()`. On a live renderer, the public recovery boundary returns a structured renderer-state-invalid result, so rebuild on a capable device instead. |
760
408
  | `render-feature-registration-conflict` | Fix identity/order at registration |
761
- | `render-feature-pass-order-conflict` | Reorder the declared dependency and retry contribution |
409
+ | `render-feature-pass-order-conflict` | Reorder the declared dependency and re-plan on the next frame |
762
410
  | `render-feature-preparation-failed` | Repair the named prepared resource and retry on the action in `error.detail.recovery`; after device loss, verify that the feature's declared shader was included in the recovery prewarm set |
763
411
  | `render-feature-prepared-state-mismatch` | Read the discriminated `error.detail.reason`, repair the generation/layout/format mismatch, and retry |
764
412
  | `render-feature-draw-recording-failed` | Read `error.detail.backendReason`, then retry after the host reports renderer recovery |
765
413
  | `disposed` | Terminal; create a new renderer/feature registration |
766
414
 
767
- Use `renderer.renderFeatureDiagnostics()` for a read-only snapshot. Call
768
- `renderer.dispose()` once or repeatedly; disposal is idempotent. A pipeline
769
- switch keeps the feature registration list and rebuilds the active graph.
770
- The host still uses `renderer.registerPipeline(id, pipeline)` for a full
771
- pipeline change.
415
+ Use `renderer.inspect()` for a read-only snapshot. Call `renderer.dispose()`
416
+ once or repeatedly; disposal is idempotent. Feature plans are assembled once
417
+ and the Standard host owns graph replacement and last-known-good recovery.
772
418
 
773
419
  For a temporary presentation-owner handoff, call `renderer.releaseSurface()`.
774
420
  It unconfigures the canvas and makes `draw()` fail closed without disposing the
@@ -778,9 +424,9 @@ next draw. Both calls are idempotent; `dispose()` remains the terminal path.
778
424
 
779
425
  For the complete declaration shape, read
780
426
  [`features/types.ts`](src/features/types.ts) and
781
- [`features/prepared-graphics.ts`](src/features/prepared-graphics.ts). For graph
782
- contribution details, read [`features/graph-contribution.ts`](src/features/graph-contribution.ts);
783
- for pipeline switching, read [`renderer.ts`](src/renderer.ts). The producer
427
+ [`features/plan.ts`](src/features/plan.ts). For Standard profile and lane
428
+ selection, read the internal pipeline implementation through the host seam;
429
+ there is no public full-pipeline registration API. The producer
784
430
  asset contract is [`@forgeax/engine-vfx`](../vfx/README.md), while graph
785
431
  ownership is [`@forgeax/engine-render-graph`](../render-graph/README.md).
786
432
 
@@ -806,120 +452,23 @@ import {
806
452
  GlyphText,
807
453
  SpriteAnimation,
808
454
  Tilemap,
809
- setTransparentSortConfig,
810
- TRANSPARENT_SORT_MODE_LAYER_Y,
455
+ TransparentSort,
811
456
  } from '@forgeax/engine-render/authoring';
812
457
  ```
813
458
 
814
- `authoring` also owns the public transparent-bucket configuration helpers and
815
- their four named modes. A consumer that composes sprites with an existing 3D
816
- game may set the world-level mode here; it should not reach into `/internal`.
817
-
818
- The root barrel does not expose frame stores or extract/prepare/record owners.
819
- Custom pipelines use `RenderPipeline.build`, typed targets, and typed graph
820
- primitives; the renderer owns graph compilation and submission.
821
-
822
- `@forgeax/engine-render/internal` is an engine-owned assembly seam, not an
823
- application API or a compatibility route. Imports from `/internal` under the
824
- private `apps/` tree are engine dogfood for assembly coverage, not application
825
- recipes. First-party packages may use it while the engine is assembled;
826
- application code should not copy those imports. Its
827
- surface can change without a consumer migration promise. If a custom renderer
828
- needs a capability absent from the supported root operations, treat that as a
829
- request for an explicit public design rather than importing `/internal`.
830
-
831
- For a custom `RenderPipeline` with `Camera.antialias = ANTIALIAS_MSAA`, create
832
- count-4 scene colour/depth targets plus a single-sample resolve target, then pass
833
- the typed resolve target to `addTypedScenePass`. Downstream passes read that
834
- resolved handle; single-sample pipelines omit it.
835
-
836
- ## Temporal antialiasing contract
837
-
838
- `Camera.antialias = ANTIALIAS_TAA` selects the renderer-owned temporal path. The fixed v1 order is linear scene color -> temporal raster -> one TAA resolve -> bloom -> tone/output/debug/UI. `Camera.historyVersion` is the explicit reset authority; increment it after a camera cut or other discontinuity.
839
-
840
- > [!IMPORTANT]
841
- > Read `renderer.renderScene.temporal` after `draw()`. It is the bounded inspection SSOT for history bytes, reset reason, coverage, failure, and recovery. Applications must not retain graph textures or create a parallel history registry.
842
-
843
- The none, FXAA, and MSAA lanes allocate zero TAA history and record neither `scene-temporal-clear` nor `taa-resolve`. The permanent real-backend oracle is [`apps/hello/taa`](../../apps/hello/taa/README.md).
844
-
845
- The main scene raster is the only jittered domain. Temporal replay uses unjittered current and previous view projection matrices plus its own cleared depth attachment; reusing main depth would compare unjittered fragments against jittered visibility. The packed `rgba16float` payload is `(currentUv - previousUv, log2(1 + viewDepth), reactive)`. Clip payloads use linear interpolation so previous projection remains a geometric authority rather than a perspective-correct material varying.
846
-
847
- Resolve and both history textures live in the unjittered output domain. Current scene color is therefore sampled at `uv + currentJitterUv`, while history is sampled at `uv - velocity`. This is the same coordinate transform as the jittered-domain form `uvJittered - velocity + (previousJitter - currentJitter)`: storing the previous resolve unjittered removes the previous-jitter term instead of dropping jitter correction. The v1 preset keeps hard UV/depth rejection, 3 x 3 current-neighborhood clipping, alpha preservation, and a fixed luminance-adaptive feedback range of 0.88 through 0.97 further reduced by reactive, velocity, depth, and startup factors.
848
-
849
- ### AI-user recipe: TAA, reset, and recovery
850
-
851
- Enable TAA on the existing `Camera` and treat `historyVersion` as an explicit discontinuity counter. Do not increment it for ordinary camera motion.
852
-
853
- ```ts
854
- import { ANTIALIAS_TAA, Camera } from '@forgeax/engine-render';
855
-
856
- const camera = world.spawn({
857
- component: Camera,
858
- data: {
859
- fov: Math.PI / 4,
860
- aspect: 16 / 9,
861
- near: 0.1,
862
- far: 100,
863
- antialias: ANTIALIAS_TAA,
864
- historyVersion: 0,
865
- },
866
- }).unwrap();
867
-
868
- let historyVersion = 0;
869
- function resetHistoryAfterCameraCut(): void {
870
- historyVersion += 1;
871
- world.set(camera, Camera, { historyVersion }).unwrap();
872
- }
873
- ```
874
-
875
- Register `onError` before the first draw, handle the returned `Result`, then read the bounded inspection after the draw. The inspection is the recovery authority; the error listener preserves the exact structured failure that caused it.
876
-
877
- ```ts
878
- const stopErrors = renderer.onError((error) => reportRenderError(error));
879
- const drawn = renderer.draw([world], { cameraOwner: 0, resourceOwner: 0 });
880
- if (!drawn.ok) reportRenderError(drawn.error);
881
-
882
- const temporal = renderer.renderScene.temporal;
883
- if (temporal.recovery !== 'none') {
884
- reportTemporalRecovery(temporal.recovery, temporal.failure, temporal.coverage);
885
- }
886
-
887
- stopErrors();
888
- ```
889
-
890
- | `temporal.recovery` | Owner action |
891
- |:--|:--|
892
- | `none` | Continue; a stable submitted frame owns valid history. |
893
- | `seed-history` | Submit the next continuous frame; increment `historyVersion` only for a real discontinuity. |
894
- | `enable-temporal-capabilities` | Recreate the renderer on a device with `rgba16float` rendering and at least two color attachments. |
895
- | `fix-temporal-pipeline-topology` | Repair the custom pipeline's target domain, attachment, or resolve count. |
896
- | `complete-temporal-coverage` | Find `coverage.missingContributorIds`; make each producer exact or reactive. |
897
- | `retry-frame` | Retry after the submit failure; aborted frames never advance history. |
898
- | `rebuild-renderer` | Call `await renderer.recover()` after device loss and handle its `Result`. |
459
+ `authoring` also owns the grouped transparent-bucket configuration values. A
460
+ consumer that composes sprites with an existing 3D game can call
461
+ `TransparentSort.configure(world, { mode: TransparentSort.layerY, yzAlpha: 1 })`;
462
+ it should not reach into `/internal`.
899
463
 
900
- ### Custom pipeline temporal seam
464
+ The root barrel does not expose frame stores or extract/plan/record owners.
465
+ Applications contribute work through `RenderFeature` plans; the Standard
466
+ renderer owns graph compilation and submission.
901
467
 
902
- A custom pipeline uses the same graph owner and follows one narrow order: scene color -> unjittered temporal raster -> feature contributions -> exactly one `context.resolveTemporal(...)` -> bloom/tone/output. For a TAA topology, allocate `scene-color` and `scene-temporal` as single-sample `rgba16float`; allocate a separate single-sample temporal depth target; clear temporal color to `(0, 0, -1, 1)` before replay; and call the public resolve seam exactly once. A non-TAA topology allocates and records none of those temporal resources or passes; calling the seam without `sceneTemporal` is optional and returns `undefined`.
903
-
904
- ```ts
905
- const features = context.contributeFeatures([
906
- sceneColorTarget,
907
- sceneDepthTarget,
908
- sceneTemporalTarget,
909
- ]);
910
- if (!features.ok) return features;
911
-
912
- const resolved = context.resolveTemporal({
913
- sceneColor: sceneColorTarget,
914
- sceneDepth: sceneDepthTarget,
915
- sceneTemporal: sceneTemporalTarget,
916
- });
917
- if (!resolved.ok) return resolved;
918
-
919
- const postInput = resolved.value?.resolvedColor ?? sceneColorTarget;
920
- ```
921
-
922
- The snippet assumes the pipeline has already recorded its scene and temporal raster passes. `exact` feature coverage must write the provided `scene-temporal` target from current/previous producer state. `reactive` is conservative but complete coverage: declaring `temporalCoverage: 'reactive'` permits current-frame fallback, while writing `w = 1` to the target gives pixel-local rejection. A visible graphics producer that declares neither is `missing`; the renderer rejects that frame's history instead of guessing.
468
+ The render package has one narrow construction seam owned by the host. It is
469
+ not an application API or a compatibility route. Standard profile and
470
+ capability lanes own MSAA target selection and resolve; applications do not
471
+ replace the frame topology.
923
472
 
924
473
  ```mermaid
925
474
  flowchart LR
@@ -947,7 +496,7 @@ const snapshot = resolveVisibility(world);
947
496
  |:--|:--|:--|
948
497
  | Author intent | `Visibility.state` is `inherited`, `hidden`, or `visible` | Read the ECS field or reflected `labels` |
949
498
  | Effective state | `resolveVisibility(world).effective(entity)` applies valid scene parents | Inspect `snapshot.diagnostics` and `VisibilityResolution.source` |
950
- | Render result | Render producers skip hidden candidates before material work | Read `renderer.visibilityStats`; it is not a frustum or picking metric |
499
+ | Render result | Render producers skip hidden candidates before material work | Read `renderer.inspect().visibilityStats`; it is not a frustum or picking metric |
951
500
 
952
501
  If the state write returns an error, preserve `code`, `expected`, `hint`, and
953
502
  `detail`, correct the enum value, and retry through `world.set`. If hierarchy
@@ -957,63 +506,3 @@ hide the issue with a custom mesh, camera workaround, or material substitute.
957
506
  Out of scope: camera frustum policy, picking, app lifecycle, asset import, and
958
507
  VFX shadow behavior. `@forgeax/engine-vfx-render` remains the producer-owned
959
508
  particle bridge and consumes the same effective visibility boundary.
960
-
961
- ## Analytic atmosphere: one source, one submitted generation
962
-
963
- The analytic environment route has one authoring source and one renderer-owned
964
- submission transaction. `Atmosphere` contains exactly five medium fields; the
965
- resource-owner selector enforces one Atmosphere source per World (the ECS schema
966
- does not carry cardinality policy);
967
- Sun direction, colour and illuminance belong to the co-located
968
- `DirectionalLight` entity. The app never selects an atmosphere Skybox mode and
969
- never owns an evaluator, cache, lifecycle ledger, encoder or queue submit.
970
-
971
- ```ts
972
- const sunEntity = world.spawn(
973
- { component: Atmosphere, data: {
974
- turbidity: 2.4,
975
- rayleigh: 1.1,
976
- mieCoefficient: 0.006,
977
- mieDirectionalG: 0.78,
978
- sunAngularRadius: 0.004675,
979
- } },
980
- { component: DirectionalLight, data: {
981
- direction: [0.35, -0.88, -0.2],
982
- color: [1, 0.93, 0.82],
983
- intensity: 2.2,
984
- } },
985
- ).unwrap();
986
-
987
- world.update(1 / 60).unwrap();
988
- const frame = renderer.draw([world], { cameraOwner: 0, resourceOwner: 0 });
989
- if (!frame.ok) reportRenderError(frame.error);
990
- const submitted = renderer.renderScene.environment;
991
- ```
992
-
993
- The final line is a bounded projection of the existing Renderer generation
994
- transaction. It reports state, source World/entity, desired/active signature,
995
- device generation, bytes, rebuild facts, failure/LKG and temporal publish/reset
996
- facts. It does not expose GPU handles or mutable caches.
997
-
998
- | Failure observation | Exhaustive recovery action |
999
- |:--|:--|
1000
- | `environment-source-conflict` | Keep exactly one image or Atmosphere source and retry extract. |
1001
- | `atmosphere-sun-missing` | Add the co-located `DirectionalLight`; do not invent a second Sun store. |
1002
- | `atmosphere-capability-insufficient` | Admit only the M0 capability matrix result or fail closed. |
1003
- | `atmosphere-producer-failed` | Read the stage, preserve LKG, repair the producer and retry the same Renderer owner. |
1004
- | `render-feature-*` / `webgpu-runtime-error` | Read the discriminated `code`/`detail`, abort the frame transaction and follow its explicit recovery. |
1005
-
1006
- > [!WARNING]
1007
- > `Fog`, day/night automation, clouds, aerial perspective, astronomy, auto
1008
- > exposure and a high-frequency time-of-day system are not implemented by this
1009
- > route. A compatibility alias, conceptual wrapper, second evaluator/cache or
1010
- > second submit/lifecycle owner would fail the one-cut audit.
1011
-
1012
- <details>
1013
- <summary>U-12 comparative-only boundary</summary>
1014
-
1015
- Three r184 and PMREM references may appear in comparative calibration evidence,
1016
- but they are not an implementation dependency, runtime import, evaluator, or
1017
- public API owner. Comparative observations cannot turn an unavailable
1018
- Browser/Dawn readback into a ForgeaX pixel verdict.
1019
- </details>