@forgeax/engine-render 0.1.21 → 0.1.24

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 (584) hide show
  1. package/README.md +281 -38
  2. package/dist/assembly/backend-contract.d.ts +13 -0
  3. package/dist/assembly/backend-contract.d.ts.map +1 -1
  4. package/dist/assembly/bundler-contract.d.ts +9 -0
  5. package/dist/assembly/bundler-contract.d.ts.map +1 -0
  6. package/dist/assembly/device-feature-admission.d.ts +8 -0
  7. package/dist/assembly/device-feature-admission.d.ts.map +1 -1
  8. package/dist/assembly/extended-lighting-fallback.d.ts +13 -0
  9. package/dist/assembly/extended-lighting-fallback.d.ts.map +1 -0
  10. package/dist/assembly/factory.d.ts +7 -235
  11. package/dist/assembly/factory.d.ts.map +1 -1
  12. package/dist/assembly/host-contract.d.ts +10 -0
  13. package/dist/assembly/host-contract.d.ts.map +1 -1
  14. package/dist/assembly/material/assembly.d.ts +3 -2
  15. package/dist/assembly/material/assembly.d.ts.map +1 -1
  16. package/dist/assembly/material/standard-layer-projection.d.ts +10 -0
  17. package/dist/assembly/material/standard-layer-projection.d.ts.map +1 -0
  18. package/dist/assembly/material-shader-policy.d.ts +168 -0
  19. package/dist/assembly/material-shader-policy.d.ts.map +1 -0
  20. package/dist/assembly/material-shader-prewarm.d.ts +21 -0
  21. package/dist/assembly/material-shader-prewarm.d.ts.map +1 -0
  22. package/dist/assembly/mesh-ssbo-grow.d.ts +88 -0
  23. package/dist/assembly/mesh-ssbo-grow.d.ts.map +1 -0
  24. package/dist/assembly/recovery/device-loss-fanout.d.ts +14 -0
  25. package/dist/assembly/recovery/device-loss-fanout.d.ts.map +1 -0
  26. package/dist/assembly/recovery/generation.d.ts +46 -0
  27. package/dist/assembly/recovery/generation.d.ts.map +1 -0
  28. package/dist/assembly/recovery/recovery-attempt.d.ts +63 -0
  29. package/dist/assembly/recovery/recovery-attempt.d.ts.map +1 -0
  30. package/dist/assembly/recovery/renderer-recover.d.ts +115 -0
  31. package/dist/assembly/recovery/renderer-recover.d.ts.map +1 -0
  32. package/dist/assembly/renderer-facade.d.ts +10 -0
  33. package/dist/assembly/renderer-facade.d.ts.map +1 -0
  34. package/dist/assembly/renderer-frame-transaction.d.ts +17 -0
  35. package/dist/assembly/renderer-frame-transaction.d.ts.map +1 -1
  36. package/dist/assembly/renderer-helpers.d.ts +19 -0
  37. package/dist/assembly/renderer-helpers.d.ts.map +1 -0
  38. package/dist/assembly/renderer-lifecycle.d.ts +34 -0
  39. package/dist/assembly/renderer-lifecycle.d.ts.map +1 -1
  40. package/dist/assembly/shader-prewarm-policy.d.ts +15 -0
  41. package/dist/assembly/shader-prewarm-policy.d.ts.map +1 -0
  42. package/dist/assembly/webgpu-ready-contract.d.ts +9 -0
  43. package/dist/assembly/webgpu-ready-contract.d.ts.map +1 -0
  44. package/dist/assembly/webgpu-ready.d.ts +55 -0
  45. package/dist/assembly/webgpu-ready.d.ts.map +1 -0
  46. package/dist/assembly/webgpu-renderer.d.ts +152 -0
  47. package/dist/assembly/webgpu-renderer.d.ts.map +1 -0
  48. package/dist/authoring.mjs +1 -1
  49. package/dist/{chunk-PCHBPYML.mjs → chunk-GE3SDD72.mjs} +37 -5
  50. package/dist/chunk-GE3SDD72.mjs.map +1 -0
  51. package/dist/chunk-KZFTK6DO.mjs +1191 -0
  52. package/dist/chunk-KZFTK6DO.mjs.map +1 -0
  53. package/dist/{chunk-FS2KNUQH.mjs → chunk-Q752SHI5.mjs} +332 -568
  54. package/dist/chunk-Q752SHI5.mjs.map +1 -0
  55. package/dist/{chunk-6OPXDQ2E.mjs → chunk-RR5L4SRS.mjs} +33 -294
  56. package/dist/chunk-RR5L4SRS.mjs.map +1 -0
  57. package/dist/chunk-TFH5I7JJ.mjs +296 -0
  58. package/dist/chunk-TFH5I7JJ.mjs.map +1 -0
  59. package/dist/chunk-UQYS7FRM.mjs +1003 -0
  60. package/dist/chunk-UQYS7FRM.mjs.map +1 -0
  61. package/dist/chunk-YKB5DQV7.mjs +345 -0
  62. package/dist/chunk-YKB5DQV7.mjs.map +1 -0
  63. package/dist/{chunk-5YADUCA7.mjs → chunk-YRUYGA4A.mjs} +1189 -1217
  64. package/dist/chunk-YRUYGA4A.mjs.map +1 -0
  65. package/dist/chunk-Z3YYH2MB.mjs +5082 -0
  66. package/dist/chunk-Z3YYH2MB.mjs.map +1 -0
  67. package/dist/cluster-binner.d.ts +5 -0
  68. package/dist/cluster-binner.d.ts.map +1 -1
  69. package/dist/components/index.d.ts +3 -0
  70. package/dist/components/index.d.ts.map +1 -1
  71. package/dist/components/light-helpers.d.ts +4 -0
  72. package/dist/components/light-helpers.d.ts.map +1 -1
  73. package/dist/components/light-probe.d.ts +9 -0
  74. package/dist/components/light-probe.d.ts.map +1 -0
  75. package/dist/components/rect-area-light.d.ts +12 -0
  76. package/dist/components/rect-area-light.d.ts.map +1 -0
  77. package/dist/components/scene-instance.d.ts +4 -0
  78. package/dist/components/scene-instance.d.ts.map +1 -1
  79. package/dist/components/spot-light.d.ts +3 -0
  80. package/dist/components/spot-light.d.ts.map +1 -1
  81. package/dist/construct-renderer.mjs +27276 -23232
  82. package/dist/construct-renderer.mjs.map +1 -1
  83. package/dist/device/device-scope.d.ts +2 -0
  84. package/dist/device/device-scope.d.ts.map +1 -1
  85. package/dist/device/gpu-residency.d.ts +32 -5
  86. package/dist/device/gpu-residency.d.ts.map +1 -1
  87. package/dist/device/lifecycle-transaction.d.ts +2 -0
  88. package/dist/device/lifecycle-transaction.d.ts.map +1 -0
  89. package/dist/environment/frame.d.ts +5 -0
  90. package/dist/environment/frame.d.ts.map +1 -1
  91. package/dist/environment/inspection.d.ts +7 -0
  92. package/dist/environment/inspection.d.ts.map +1 -1
  93. package/dist/environment/lifecycle.d.ts +20 -2
  94. package/dist/environment/lifecycle.d.ts.map +1 -1
  95. package/dist/errors/gpu-driven.d.ts +26 -0
  96. package/dist/errors/gpu-driven.d.ts.map +1 -0
  97. package/dist/errors/index.d.ts +1 -0
  98. package/dist/errors/index.d.ts.map +1 -1
  99. package/dist/errors/recover.d.ts +67 -3
  100. package/dist/errors/recover.d.ts.map +1 -1
  101. package/dist/errors/render.d.ts +39 -1
  102. package/dist/errors/render.d.ts.map +1 -1
  103. package/dist/extract/contracts.d.ts +899 -0
  104. package/dist/extract/contracts.d.ts.map +1 -0
  105. package/dist/extract/gpu-driven.d.ts +50 -0
  106. package/dist/extract/gpu-driven.d.ts.map +1 -0
  107. package/dist/extract/visibility.d.ts.map +1 -1
  108. package/dist/features/host.d.ts +2 -0
  109. package/dist/features/host.d.ts.map +1 -1
  110. package/dist/features/prepared-gpu-work.d.ts +3 -0
  111. package/dist/features/prepared-gpu-work.d.ts.map +1 -1
  112. package/dist/features/prepared-graphics-store.d.ts +2 -0
  113. package/dist/features/prepared-graphics-store.d.ts.map +1 -1
  114. package/dist/gpu-driven/batch-topology.d.ts +34 -0
  115. package/dist/gpu-driven/batch-topology.d.ts.map +1 -1
  116. package/dist/gpu-driven/prepared-draw.d.ts +63 -0
  117. package/dist/gpu-driven/prepared-draw.d.ts.map +1 -0
  118. package/dist/gpu-driven/production-raster.d.ts +126 -2
  119. package/dist/gpu-driven/production-raster.d.ts.map +1 -1
  120. package/dist/gpu-driven/view-gpu.d.ts +64 -1
  121. package/dist/gpu-driven/view-gpu.d.ts.map +1 -1
  122. package/dist/gpu-scene-schema.d.ts +14 -0
  123. package/dist/gpu-scene-schema.d.ts.map +1 -1
  124. package/dist/gpu-scene.d.ts +9 -1
  125. package/dist/gpu-scene.d.ts.map +1 -1
  126. package/dist/gpu-usage.d.ts +0 -1
  127. package/dist/gpu-usage.d.ts.map +1 -1
  128. package/dist/hdrp-buffers.d.ts +3 -3
  129. package/dist/hdrp-buffers.d.ts.map +1 -1
  130. package/dist/ibl/IblPipelineCache.d.ts +7 -6
  131. package/dist/ibl/IblPipelineCache.d.ts.map +1 -1
  132. package/dist/ibl/skylight-bind-group.d.ts +7 -1
  133. package/dist/ibl/skylight-bind-group.d.ts.map +1 -1
  134. package/dist/index.d.ts +13 -2
  135. package/dist/index.d.ts.map +1 -1
  136. package/dist/index.mjs +90 -5
  137. package/dist/index.mjs.map +1 -1
  138. package/dist/inspection-types.d.ts +163 -1
  139. package/dist/inspection-types.d.ts.map +1 -1
  140. package/dist/internal.d.ts +9 -0
  141. package/dist/internal.d.ts.map +1 -1
  142. package/dist/internal.mjs +23 -2
  143. package/dist/internal.mjs.map +1 -1
  144. package/dist/light-buffer-layout.d.ts +60 -148
  145. package/dist/light-buffer-layout.d.ts.map +1 -1
  146. package/dist/materials.d.ts +34 -10
  147. package/dist/materials.d.ts.map +1 -1
  148. package/dist/mesh-material-bindings.d.ts +56 -0
  149. package/dist/mesh-material-bindings.d.ts.map +1 -1
  150. package/dist/occlusion-proxy.d.ts +4 -0
  151. package/dist/occlusion-proxy.d.ts.map +1 -0
  152. package/dist/pbr-pipeline.d.ts +58 -21
  153. package/dist/pbr-pipeline.d.ts.map +1 -1
  154. package/dist/pipeline/standard-forward-lane.d.ts.map +1 -1
  155. package/dist/pipeline/standard-lighting/graph.d.ts.map +1 -1
  156. package/dist/pipeline/standard-lighting/light-frame.d.ts +3 -3
  157. package/dist/pipeline/standard-lighting/light-frame.d.ts.map +1 -1
  158. package/dist/pipeline/standard-lighting/topology.d.ts +1 -1
  159. package/dist/pipeline/standard-lighting/topology.d.ts.map +1 -1
  160. package/dist/pipeline/standard-lighting/transport.d.ts.map +1 -1
  161. package/dist/pipeline/standard-pipeline.d.ts.map +1 -1
  162. package/dist/pipeline-builder.d.ts +2 -0
  163. package/dist/pipeline-builder.d.ts.map +1 -1
  164. package/dist/pipeline-spec.d.ts +1 -1
  165. package/dist/pipeline-spec.d.ts.map +1 -1
  166. package/dist/plugin.d.ts.map +1 -1
  167. package/dist/points-lines/prepare.d.ts +3 -0
  168. package/dist/points-lines/prepare.d.ts.map +1 -1
  169. package/dist/points-lines/standard-owner.d.ts +33 -0
  170. package/dist/points-lines/standard-owner.d.ts.map +1 -0
  171. package/dist/prepare/extended-lighting/ltc-resources.d.ts +31 -0
  172. package/dist/prepare/extended-lighting/ltc-resources.d.ts.map +1 -0
  173. package/dist/prepare/extended-lighting/resources.d.ts +72 -0
  174. package/dist/prepare/extended-lighting/resources.d.ts.map +1 -0
  175. package/dist/prepare/extended-lighting/spot-modifiers.d.ts +42 -0
  176. package/dist/prepare/extended-lighting/spot-modifiers.d.ts.map +1 -0
  177. package/dist/prepare/extended-lighting/state.d.ts +24 -0
  178. package/dist/prepare/extended-lighting/state.d.ts.map +1 -0
  179. package/dist/record/frame-lighting.d.ts +8 -6
  180. package/dist/record/frame-lighting.d.ts.map +1 -1
  181. package/dist/record/frame-snapshot.d.ts +55 -10
  182. package/dist/record/frame-snapshot.d.ts.map +1 -1
  183. package/dist/record/frame-targets.d.ts.map +1 -1
  184. package/dist/record/frame.d.ts +21 -5
  185. package/dist/record/frame.d.ts.map +1 -1
  186. package/dist/record/gpu-timing.d.ts +19 -7
  187. package/dist/record/gpu-timing.d.ts.map +1 -1
  188. package/dist/record/helpers.d.ts +0 -20
  189. package/dist/record/helpers.d.ts.map +1 -1
  190. package/dist/record/main-pass-geometry.d.ts +20 -2
  191. package/dist/record/main-pass-geometry.d.ts.map +1 -1
  192. package/dist/record/main-pass-material.d.ts +10 -18
  193. package/dist/record/main-pass-material.d.ts.map +1 -1
  194. package/dist/record/main-pass-sprite-draws.d.ts.map +1 -1
  195. package/dist/record/main-pass.d.ts.map +1 -1
  196. package/dist/record/mesh-ssbo.d.ts +11 -3
  197. package/dist/record/mesh-ssbo.d.ts.map +1 -1
  198. package/dist/record/recovery-pipeline.d.ts +30 -0
  199. package/dist/record/recovery-pipeline.d.ts.map +1 -0
  200. package/dist/record/render-context.d.ts +82 -9
  201. package/dist/record/render-context.d.ts.map +1 -1
  202. package/dist/record/shadow-pass.d.ts.map +1 -1
  203. package/dist/record/typed-frame-graph.d.ts +49 -2
  204. package/dist/record/typed-frame-graph.d.ts.map +1 -1
  205. package/dist/record/view-ubo.d.ts +1 -2
  206. package/dist/record/view-ubo.d.ts.map +1 -1
  207. package/dist/recovery/render-system-candidate.d.ts +65 -0
  208. package/dist/recovery/render-system-candidate.d.ts.map +1 -0
  209. package/dist/reflection/inspection.d.ts +10 -0
  210. package/dist/reflection/inspection.d.ts.map +1 -0
  211. package/dist/reflection/projection.d.ts +49 -0
  212. package/dist/reflection/projection.d.ts.map +1 -1
  213. package/dist/reflection/record-owner.d.ts +60 -0
  214. package/dist/reflection/record-owner.d.ts.map +1 -0
  215. package/dist/render-contract.d.ts +78 -15
  216. package/dist/render-contract.d.ts.map +1 -1
  217. package/dist/render-pipeline.d.ts +7 -0
  218. package/dist/render-pipeline.d.ts.map +1 -1
  219. package/dist/render-system-extract-tail.d.ts +12 -0
  220. package/dist/render-system-extract-tail.d.ts.map +1 -0
  221. package/dist/render-system-extract.d.ts +252 -30
  222. package/dist/render-system-extract.d.ts.map +1 -1
  223. package/dist/render-system.d.ts +140 -5
  224. package/dist/render-system.d.ts.map +1 -1
  225. package/dist/scene/probe-blend-record.d.ts +22 -0
  226. package/dist/scene/probe-blend-record.d.ts.map +1 -0
  227. package/dist/scene/probe-blend.d.ts +142 -0
  228. package/dist/scene/probe-blend.d.ts.map +1 -0
  229. package/dist/scene/render-scene-types.d.ts +0 -6
  230. package/dist/scene/render-scene-types.d.ts.map +1 -1
  231. package/dist/scene/render-scene.d.ts +122 -9
  232. package/dist/scene/render-scene.d.ts.map +1 -1
  233. package/dist/scene/visibility/bounds.d.ts +20 -0
  234. package/dist/scene/visibility/bounds.d.ts.map +1 -0
  235. package/dist/scene/visibility/budget.d.ts +16 -0
  236. package/dist/scene/visibility/budget.d.ts.map +1 -0
  237. package/dist/scene/visibility/facet.d.ts +73 -0
  238. package/dist/scene/visibility/facet.d.ts.map +1 -0
  239. package/dist/scene/visibility/gpu-frame-timing.d.ts +41 -0
  240. package/dist/scene/visibility/gpu-frame-timing.d.ts.map +1 -0
  241. package/dist/scene/visibility/gpu-lod.d.ts +46 -0
  242. package/dist/scene/visibility/gpu-lod.d.ts.map +1 -0
  243. package/dist/scene/visibility/inspection.d.ts +132 -0
  244. package/dist/scene/visibility/inspection.d.ts.map +1 -0
  245. package/dist/scene/visibility/lod-selector.d.ts +25 -0
  246. package/dist/scene/visibility/lod-selector.d.ts.map +1 -0
  247. package/dist/scene/visibility/occlusion-confidence.d.ts +81 -0
  248. package/dist/scene/visibility/occlusion-confidence.d.ts.map +1 -0
  249. package/dist/scene/visibility/occlusion-pass.d.ts +57 -0
  250. package/dist/scene/visibility/occlusion-pass.d.ts.map +1 -0
  251. package/dist/scene/visibility/occlusion-query-pool.d.ts +57 -0
  252. package/dist/scene/visibility/occlusion-query-pool.d.ts.map +1 -0
  253. package/dist/scene/visibility/occlusion-runtime.d.ts +96 -0
  254. package/dist/scene/visibility/occlusion-runtime.d.ts.map +1 -0
  255. package/dist/scene/visibility/types.d.ts +34 -0
  256. package/dist/scene/visibility/types.d.ts.map +1 -0
  257. package/dist/ssr/admission.d.ts +122 -0
  258. package/dist/ssr/admission.d.ts.map +1 -0
  259. package/dist/ssr/composition.d.ts +32 -0
  260. package/dist/ssr/composition.d.ts.map +1 -0
  261. package/dist/ssr/errors.d.ts +39 -0
  262. package/dist/ssr/errors.d.ts.map +1 -0
  263. package/dist/ssr/identity.d.ts +13 -0
  264. package/dist/ssr/identity.d.ts.map +1 -0
  265. package/dist/systems/skin-palette-allocator.d.ts +1 -1
  266. package/dist/temporal/frame-coordinator.d.ts +13 -0
  267. package/dist/temporal/frame-coordinator.d.ts.map +1 -1
  268. package/dist/temporal/frame.d.ts +2 -0
  269. package/dist/temporal/frame.d.ts.map +1 -1
  270. package/dist/temporal/index.mjs +6 -5
  271. package/dist/temporal/taa-history-store.d.ts +15 -1
  272. package/dist/temporal/taa-history-store.d.ts.map +1 -1
  273. package/dist/temporal/transaction.d.ts +5 -0
  274. package/dist/temporal/transaction.d.ts.map +1 -1
  275. package/dist/temporal/view.d.ts +7 -0
  276. package/dist/temporal/view.d.ts.map +1 -1
  277. package/dist/tilemap-chunk-extract-system.d.ts +1 -1
  278. package/dist/typed-render-graph-primitives.d.ts +4 -0
  279. package/dist/typed-render-graph-primitives.d.ts.map +1 -1
  280. package/dist/volume/passes.d.ts +8 -4
  281. package/dist/volume/passes.d.ts.map +1 -1
  282. package/package.json +20 -20
  283. package/src/__tests__/cluster-grid-default-surface.unit.test.ts +5 -0
  284. package/src/__tests__/detached-inspection.integration.test.ts +6 -0
  285. package/src/__tests__/device-feature-admission.unit.test.ts +19 -1
  286. package/src/__tests__/device-loss-fanout.unit.test.ts +107 -0
  287. package/src/__tests__/device-scope-lifecycle.unit.test.ts +21 -0
  288. package/src/__tests__/direct-light-snapshot.unit.test.ts +59 -3
  289. package/src/__tests__/environment-generation.integration.test.ts +39 -0
  290. package/src/__tests__/evidence-identity.ts +13 -0
  291. package/src/__tests__/evidence-identity.unit.test.ts +24 -0
  292. package/src/__tests__/expose-renderer-errors.unit.test.ts +34 -0
  293. package/src/__tests__/extended-lighting-recovery.browser.test.ts +14 -0
  294. package/src/__tests__/extended-lighting-recovery.dawn.test.ts +14 -0
  295. package/src/__tests__/extended-lighting-recovery.integration.test.ts +81 -0
  296. package/src/__tests__/extended-lighting-resources.unit.test.ts +51 -0
  297. package/src/__tests__/extended-lighting-zero-feature.integration.test.ts +52 -0
  298. package/src/__tests__/factory-contract.integration.test.ts +154 -6
  299. package/src/__tests__/fallback-row-stride-surface.unit.test.ts +4 -1
  300. package/src/__tests__/frame-observation.contract.test.ts +15 -0
  301. package/src/__tests__/gpu-driven-batch-topology-pbr.unit.test.ts +146 -0
  302. package/src/__tests__/gpu-driven-indirect-raster-evidence.ts +1 -0
  303. package/src/__tests__/gpu-driven-indirect-raster.dawn.test.ts +1 -0
  304. package/src/__tests__/gpu-driven-production.integration.test.ts +572 -9
  305. package/src/__tests__/gpu-driven-scaling.unit.test.ts +66 -2
  306. package/src/__tests__/gpu-driven-view-gpu-evidence.ts +26 -1
  307. package/src/__tests__/gpu-driven-view-graph.integration.test.ts +89 -2
  308. package/src/__tests__/gpu-driven-view.browser.test.ts +3 -3
  309. package/src/__tests__/gpu-driven-view.dawn.test.ts +3 -3
  310. package/src/__tests__/gpu-driven-view.unit.test.ts +50 -0
  311. package/src/__tests__/gpu-lod-evidence.ts +188 -0
  312. package/src/__tests__/gpu-lod-fallback.integration.test.ts +10 -0
  313. package/src/__tests__/gpu-lod-indirect.integration.test.ts +40 -0
  314. package/src/__tests__/gpu-lod-parity.dawn.test.ts +29 -0
  315. package/src/__tests__/gpu-lod-readiness.integration.test.ts +52 -0
  316. package/src/__tests__/gpu-lod-schema.unit.test.ts +66 -0
  317. package/src/__tests__/gpu-lod-selector.unit.test.ts +28 -0
  318. package/src/__tests__/gpu-lod-silhouette.browser.test.ts +13 -0
  319. package/src/__tests__/gpu-resource-store-stride.unit.test.ts +66 -1
  320. package/src/__tests__/gpu-scene.dawn.test.ts +8 -1
  321. package/src/__tests__/gpu-scene.unit.test.ts +49 -3
  322. package/src/__tests__/ibl/face-uniforms.unit.test.ts +2 -0
  323. package/src/__tests__/ibl-residency-publication.unit.test.ts +113 -0
  324. package/src/__tests__/light-buffer-layout.unit.test.ts +113 -3
  325. package/src/__tests__/light-inspection.unit.test.ts +55 -0
  326. package/src/__tests__/light-resource-error.unit.test.ts +43 -0
  327. package/src/__tests__/lighting-scene-roundtrip.integration.test.ts +109 -0
  328. package/src/__tests__/lod-bounds.unit.test.ts +42 -0
  329. package/src/__tests__/lod-cpu-lane.integration.test.ts +55 -0
  330. package/src/__tests__/lod-cpu-no-change.perf.test.ts +19 -0
  331. package/src/__tests__/lod-gpu-frame-timing.unit.test.ts +49 -0
  332. package/src/__tests__/lod-multi-view.integration.test.ts +63 -0
  333. package/src/__tests__/lod-occlusion-device-loss.integration.test.ts +27 -0
  334. package/src/__tests__/lod-occlusion-final-decision.integration.test.ts +47 -0
  335. package/src/__tests__/lod-occlusion-inspection.integration.test.ts +217 -0
  336. package/src/__tests__/lod-occlusion-inspection.schema.test-d.ts +14 -0
  337. package/src/__tests__/lod-occlusion-inspection.unit.test.ts +72 -0
  338. package/src/__tests__/lod-occlusion-visual-evidence.ts +91 -0
  339. package/src/__tests__/lod-occlusion.browser.test.ts +15 -0
  340. package/src/__tests__/lod-occlusion.dawn.test.ts +20 -0
  341. package/src/__tests__/lod-selector.profile.test.ts +35 -0
  342. package/src/__tests__/lod-selector.unit.test.ts +68 -0
  343. package/src/__tests__/lod-visibility-identity.unit.test.ts +198 -0
  344. package/src/__tests__/lod-visibility-lifecycle.integration.test.ts +132 -0
  345. package/src/__tests__/ltc-resources.unit.test.ts +32 -0
  346. package/src/__tests__/material-contract-inventory.unit.test.ts +41 -9
  347. package/src/__tests__/material-cooked-projection.unit.test.ts +19 -1
  348. package/src/__tests__/material-static-dynamic-route.unit.test.ts +29 -0
  349. package/src/__tests__/material-stride-surface.unit.test.ts +7 -3
  350. package/src/__tests__/materials-standard-contract.unit.test.ts +104 -0
  351. package/src/__tests__/mesh-buffer-usage-surface.unit.test.ts +1 -1
  352. package/src/__tests__/occlusion-confidence.unit.test.ts +168 -0
  353. package/src/__tests__/occlusion-invalidation.integration.test.ts +37 -0
  354. package/src/__tests__/occlusion-pass-routing.unit.test.ts +16 -0
  355. package/src/__tests__/occlusion-pass.dawn.test.ts +20 -0
  356. package/src/__tests__/occlusion-pass.integration.test.ts +43 -0
  357. package/src/__tests__/occlusion-pass.rhi-null.test.ts +22 -0
  358. package/src/__tests__/occlusion-query-pool.rhi-null.test.ts +21 -0
  359. package/src/__tests__/occlusion-query-pool.unit.test.ts +95 -0
  360. package/src/__tests__/occlusion-query-ticket.integration.test.ts +47 -0
  361. package/src/__tests__/occlusion-query.dawn.test.ts +16 -0
  362. package/src/__tests__/occlusion-query.evidence.ts +178 -0
  363. package/src/__tests__/occlusion-query.rhi-null.test.ts +31 -0
  364. package/src/__tests__/occlusion-runtime.unit.test.ts +120 -0
  365. package/src/__tests__/physical-clearcoat.integration.test.ts +89 -0
  366. package/src/__tests__/prepared-gpu-driven-pbr.integration.test.ts +196 -0
  367. package/src/__tests__/prepared-graphics-pipeline-warmup.unit.test.ts +1 -1
  368. package/src/__tests__/probe-bindings.unit.test.ts +200 -0
  369. package/src/__tests__/probe-blend-numeric.unit.test.ts +67 -0
  370. package/src/__tests__/probe-blend-oracle.unit.test.ts +136 -0
  371. package/src/__tests__/probe-capacity.integration.test.ts +97 -0
  372. package/src/__tests__/probe-recovery.integration.test.ts +104 -0
  373. package/src/__tests__/probe-scene-dirty.integration.test.ts +211 -0
  374. package/src/__tests__/profiler-phase-catalog.test.ts +4 -1
  375. package/src/__tests__/profiler-phase-token.test.ts +1 -0
  376. package/src/__tests__/recover-error-policy-owner.unit.test.ts +6 -3
  377. package/src/__tests__/recovery-candidate-prepare.contract.test.ts +140 -0
  378. package/src/__tests__/rect-area-boundary.unit.test.ts +24 -0
  379. package/src/__tests__/reflection-fallback-graph.unit.test.ts +67 -0
  380. package/src/__tests__/reflection-fallback-inspection.unit.test.ts +77 -0
  381. package/src/__tests__/reflection-fallback-lifecycle.integration.test.ts +21 -0
  382. package/src/__tests__/reflection-fallback-projection.unit.test.ts +90 -0
  383. package/src/__tests__/reflection-fallback-source.unit.test.ts +32 -0
  384. package/src/__tests__/reflection-probe-owner-placement.unit.test.ts +39 -0
  385. package/src/__tests__/reflection-probe-record-owner.characterization.unit.test.ts +120 -0
  386. package/src/__tests__/render-error-code-owner.test-d.ts +1 -0
  387. package/src/__tests__/render-feature-docs.unit.test.ts +12 -7
  388. package/src/__tests__/render-graph-fallback.integration.test.ts +24 -0
  389. package/src/__tests__/render-perf/extended-lighting.bench.test.ts +66 -0
  390. package/src/__tests__/render-scene-projection.unit.test.ts +447 -18
  391. package/src/__tests__/renderer-factory-material-contract.unit.test.ts +160 -17
  392. package/src/__tests__/renderer-frame-generation-fence.integration.test.ts +47 -0
  393. package/src/__tests__/renderer-generation-assembly.unit.test.ts +77 -0
  394. package/src/__tests__/renderer-generation-failure.unit.test.ts +108 -0
  395. package/src/__tests__/renderer-producer-root-matrix.integration.test.ts +33 -0
  396. package/src/__tests__/renderer-recovery-capability-matrix.unit.test.ts +59 -0
  397. package/src/__tests__/renderer-recovery-contract.unit.test.ts +73 -0
  398. package/src/__tests__/renderer-recovery-lifecycle.unit.test.ts +216 -0
  399. package/src/__tests__/renderer-target-history-recovery.integration.test.ts +80 -0
  400. package/src/__tests__/shader-manifest-fixture.ts +13 -16
  401. package/src/__tests__/shader-stage-surface.unit.test.ts +1 -1
  402. package/src/__tests__/skin-motion-regression.unit.test.ts +22 -0
  403. package/src/__tests__/skinned-shadow-caster.test.ts +2 -2
  404. package/src/__tests__/spot-modifier-projection.unit.test.ts +70 -0
  405. package/src/__tests__/ssr-admission-matrix.integration.test.ts +206 -0
  406. package/src/__tests__/ssr-composition.unit.test.ts +46 -0
  407. package/src/__tests__/ssr-fallback-zero-work.bench.test.ts +94 -0
  408. package/src/__tests__/ssr-recovery-errors.unit.test.ts +58 -0
  409. package/src/__tests__/standard-cluster-variant-resolution.unit.test.ts +67 -0
  410. package/src/__tests__/standard-clustered-pipeline.unit.test.ts +7 -0
  411. package/src/__tests__/standard-layer-projection.unit.test.ts +23 -0
  412. package/src/__tests__/standard-lighting-inspection.integration.test.ts +1 -1
  413. package/src/__tests__/standard-lighting-write.unit.test.ts +66 -2
  414. package/src/__tests__/temporal-fallback-generation.integration.test.ts +16 -0
  415. package/src/__tests__/temporal-view.unit.test.ts +3 -3
  416. package/src/__tests__/transmission-prewarm.unit.test.ts +111 -32
  417. package/src/__tests__/visibility-budget.integration.test.ts +140 -0
  418. package/src/__tests__/visibility-budget.unit.test.ts +70 -0
  419. package/src/__tests__/visibility-extract.integration.test.ts +11 -6
  420. package/src/__tests__/volumetric-fog-point-spot-accumulation.integration.test.ts +6 -3
  421. package/src/__tests__/volumetric-fog-stage-readback.dawn.test.ts +31 -28
  422. package/src/__tests__/volumetric-fog-topology.unit.test.ts +3 -1
  423. package/src/assembly/backend-contract.ts +13 -0
  424. package/src/assembly/bundler-contract.ts +9 -0
  425. package/src/assembly/device-feature-admission.ts +26 -9
  426. package/src/assembly/extended-lighting-fallback.ts +216 -0
  427. package/src/assembly/factory.ts +81 -9634
  428. package/src/assembly/host-contract.ts +10 -0
  429. package/src/assembly/material/assembly.ts +18 -2
  430. package/src/assembly/material/standard-layer-projection.ts +16 -0
  431. package/src/assembly/material-shader-policy.ts +854 -0
  432. package/src/assembly/material-shader-prewarm.ts +88 -0
  433. package/src/assembly/mesh-ssbo-grow.ts +270 -0
  434. package/src/assembly/recovery/device-loss-fanout.ts +89 -0
  435. package/src/assembly/recovery/generation.ts +141 -0
  436. package/src/assembly/recovery/recovery-attempt.ts +800 -0
  437. package/src/assembly/recovery/renderer-recover.ts +906 -0
  438. package/src/assembly/renderer-facade.ts +342 -0
  439. package/src/assembly/renderer-frame-transaction.ts +45 -0
  440. package/src/assembly/renderer-helpers.ts +99 -0
  441. package/src/assembly/renderer-lifecycle.ts +159 -0
  442. package/src/assembly/shader-prewarm-policy.ts +157 -0
  443. package/src/assembly/webgpu-ready-contract.ts +14 -0
  444. package/src/assembly/webgpu-ready.ts +4079 -0
  445. package/src/assembly/webgpu-renderer.ts +4095 -0
  446. package/src/cluster-binner.ts +31 -0
  447. package/src/components/__tests__/lighting-authoring.unit.test.ts +39 -0
  448. package/src/components/__tests__/rect-area-light.unit.test.ts +33 -0
  449. package/src/components/camera.ts +1 -1
  450. package/src/components/index.ts +3 -0
  451. package/src/components/light-helpers.ts +52 -1
  452. package/src/components/light-probe.ts +13 -0
  453. package/src/components/rect-area-light.ts +15 -0
  454. package/src/components/scene-instance.ts +6 -0
  455. package/src/components/spot-light.ts +3 -0
  456. package/src/debug-draw-glue.ts +1 -1
  457. package/src/device/__tests__/extended-lighting-recovery.unit.test.ts +24 -0
  458. package/src/device/device-scope.ts +35 -6
  459. package/src/device/gpu-residency.ts +334 -35
  460. package/src/device/lifecycle-transaction.ts +12 -0
  461. package/src/environment/frame.ts +6 -0
  462. package/src/environment/inspection.ts +10 -0
  463. package/src/environment/lifecycle.ts +122 -9
  464. package/src/errors/gpu-driven.ts +92 -0
  465. package/src/errors/index.ts +1 -0
  466. package/src/errors/recover.ts +108 -5
  467. package/src/errors/render.ts +72 -1
  468. package/src/extract/camera.ts +3 -3
  469. package/src/extract/contracts.ts +974 -0
  470. package/src/extract/gpu-driven.ts +108 -0
  471. package/src/extract/visibility.ts +0 -23
  472. package/src/features/host.ts +16 -0
  473. package/src/features/prepared-gpu-work.ts +20 -2
  474. package/src/features/prepared-graphics-store.ts +17 -0
  475. package/src/gpu-driven/batch-topology.ts +206 -28
  476. package/src/gpu-driven/prepared-draw.ts +208 -0
  477. package/src/gpu-driven/production-raster.ts +1046 -39
  478. package/src/gpu-driven/view-gpu.ts +411 -29
  479. package/src/gpu-scene-schema.ts +13 -0
  480. package/src/gpu-scene.ts +137 -67
  481. package/src/gpu-usage.ts +0 -1
  482. package/src/hdrp-buffers.ts +6 -6
  483. package/src/ibl/IblPipelineCache.ts +134 -50
  484. package/src/ibl/skylight-bind-group.ts +26 -0
  485. package/src/index.ts +83 -1
  486. package/src/inspection-types.ts +220 -1
  487. package/src/internal.ts +38 -0
  488. package/src/light-buffer-layout.ts +157 -324
  489. package/src/materials.ts +278 -47
  490. package/src/mesh-material-bindings.ts +59 -0
  491. package/src/occlusion-proxy.ts +64 -0
  492. package/src/pbr-pipeline.ts +290 -60
  493. package/src/pipeline/standard-forward-lane.ts +47 -0
  494. package/src/pipeline/standard-lighting/graph.ts +2 -1
  495. package/src/pipeline/standard-lighting/light-frame.ts +3 -2
  496. package/src/pipeline/standard-lighting/topology.ts +1 -1
  497. package/src/pipeline/standard-lighting/transport.ts +2 -1
  498. package/src/pipeline/standard-pipeline.ts +2 -0
  499. package/src/pipeline-builder.ts +5 -2
  500. package/src/pipeline-spec.ts +12 -1
  501. package/src/plugin.ts +4 -0
  502. package/src/points-lines/__tests__/cache-recovery.unit.test.ts +22 -0
  503. package/src/points-lines/prepare.ts +9 -0
  504. package/src/points-lines/standard-owner.ts +403 -0
  505. package/src/prepare/__tests__/extended-lighting-capability.unit.test.ts +56 -0
  506. package/src/prepare/extended-lighting/ltc-resources.ts +136 -0
  507. package/src/prepare/extended-lighting/resources.ts +389 -0
  508. package/src/prepare/extended-lighting/spot-modifiers.ts +194 -0
  509. package/src/prepare/extended-lighting/state.ts +92 -0
  510. package/src/record/__tests__/frame-targets-recovery.unit.test.ts +60 -0
  511. package/src/record/__tests__/gpu-timing.unit.test.ts +177 -0
  512. package/src/record/__tests__/main-pass-geometry.unit.test.ts +26 -1
  513. package/src/record/__tests__/mesh-ssbo.unit.test.ts +38 -0
  514. package/src/record/__tests__/recovery-pipeline.unit.test.ts +124 -0
  515. package/src/record/__tests__/sprite-material-abi.unit.test.ts +28 -13
  516. package/src/record/__tests__/standard-pbr-ubo-layout.unit.test.ts +47 -4
  517. package/src/record/__tests__/temporal-payload.unit.test.ts +29 -28
  518. package/src/record/__tests__/typed-frame-graph-plan.unit.test.ts +21 -2
  519. package/src/record/frame-lighting.ts +252 -53
  520. package/src/record/frame-snapshot.ts +72 -12
  521. package/src/record/frame-targets.ts +11 -1
  522. package/src/record/frame.ts +416 -95
  523. package/src/record/gpu-timing.ts +108 -44
  524. package/src/record/helpers.ts +1 -59
  525. package/src/record/main-pass-geometry.ts +434 -44
  526. package/src/record/main-pass-material.ts +324 -210
  527. package/src/record/main-pass-sprite-draws.ts +58 -92
  528. package/src/record/main-pass.ts +94 -6
  529. package/src/record/mesh-ssbo.ts +79 -46
  530. package/src/record/recovery-pipeline.ts +695 -0
  531. package/src/record/render-context.ts +99 -7
  532. package/src/record/shadow-pass.ts +66 -40
  533. package/src/record/typed-frame-graph.ts +270 -84
  534. package/src/record/view-ubo.ts +17 -27
  535. package/src/recovery/render-system-candidate.ts +839 -0
  536. package/src/reflection/inspection.ts +67 -0
  537. package/src/reflection/projection.ts +196 -1
  538. package/src/reflection/record-owner.ts +1283 -0
  539. package/src/render-contract.ts +82 -12
  540. package/src/render-pipeline.ts +5 -0
  541. package/src/render-system-extract-tail.ts +2983 -0
  542. package/src/render-system-extract.ts +290 -2784
  543. package/src/render-system.ts +1597 -1192
  544. package/src/scene/__tests__/changed-block-summary.candidate.test.ts +36 -0
  545. package/src/scene/probe-blend-record.ts +54 -0
  546. package/src/scene/probe-blend.ts +813 -0
  547. package/src/scene/render-scene-types.ts +0 -7
  548. package/src/scene/render-scene.ts +972 -184
  549. package/src/scene/visibility/bounds.ts +57 -0
  550. package/src/scene/visibility/budget.ts +40 -0
  551. package/src/scene/visibility/facet.ts +400 -0
  552. package/src/scene/visibility/gpu-frame-timing.ts +101 -0
  553. package/src/scene/visibility/gpu-lod.ts +119 -0
  554. package/src/scene/visibility/inspection.ts +313 -0
  555. package/src/scene/visibility/lod-selector.ts +84 -0
  556. package/src/scene/visibility/occlusion-confidence.ts +478 -0
  557. package/src/scene/visibility/occlusion-pass.ts +165 -0
  558. package/src/scene/visibility/occlusion-query-pool.ts +178 -0
  559. package/src/scene/visibility/occlusion-runtime.ts +672 -0
  560. package/src/scene/visibility/types.ts +50 -0
  561. package/src/ssr/admission.ts +451 -0
  562. package/src/ssr/composition.ts +73 -0
  563. package/src/ssr/errors.ts +76 -0
  564. package/src/ssr/identity.ts +12 -0
  565. package/src/systems/skin-palette-allocator.ts +1 -1
  566. package/src/temporal/frame-coordinator.ts +30 -1
  567. package/src/temporal/frame.ts +14 -1
  568. package/src/temporal/taa-history-store.ts +46 -2
  569. package/src/temporal/temporal-view.ts +1 -1
  570. package/src/temporal/transaction.ts +9 -0
  571. package/src/temporal/view.ts +11 -0
  572. package/src/tilemap-chunk-extract-system.ts +5 -5
  573. package/src/transmission/__tests__/standard-transmission.dawn.test.ts +19 -12
  574. package/src/typed-render-graph-primitives.ts +48 -0
  575. package/src/volume/passes.ts +46 -49
  576. package/dist/.tsbuildinfo +0 -1
  577. package/dist/chunk-5YADUCA7.mjs.map +0 -1
  578. package/dist/chunk-6OPXDQ2E.mjs.map +0 -1
  579. package/dist/chunk-BXBQQKFQ.mjs +0 -67
  580. package/dist/chunk-BXBQQKFQ.mjs.map +0 -1
  581. package/dist/chunk-FS2KNUQH.mjs.map +0 -1
  582. package/dist/chunk-PCHBPYML.mjs.map +0 -1
  583. package/dist/chunk-VFPLTKCU.mjs +0 -192
  584. package/dist/chunk-VFPLTKCU.mjs.map +0 -1
package/src/materials.ts CHANGED
@@ -1,3 +1,4 @@
1
+ import { color } from '@forgeax/engine-math';
1
2
  import { DEFAULT_STANDARD_PBR_PARAM_SCHEMA } from '@forgeax/engine-shader';
2
3
  import type {
3
4
  MaterialAsset,
@@ -7,6 +8,7 @@ import type {
7
8
  MaterialRenderState,
8
9
  MaterialValue,
9
10
  } from '@forgeax/engine-types';
11
+ import { deriveStandardLayerPlan } from '@forgeax/engine-types';
10
12
 
11
13
  export type MaterialTransmissionValidationReason =
12
14
  | 'non-finite'
@@ -60,6 +62,49 @@ const STANDARD_MODULE = 'forgeax_material::standard';
60
62
  const UNLIT_MODULE = 'forgeax_material::unlit';
61
63
  const SPRITE_MODULE = 'forgeax_material::sprite';
62
64
 
65
+ export type MaterialColorTuple3 = readonly [number, number, number];
66
+ export type MaterialColorTuple4 = readonly [number, number, number, number];
67
+ export type MaterialColorInput3 = MaterialColorTuple3 | string | number;
68
+ export type MaterialColorInput4 = MaterialColorTuple4 | string | number;
69
+
70
+ function colorHexFromNumber(value: number): string {
71
+ if (!Number.isInteger(value) || value < 0 || value > 0xffffff) {
72
+ throw new Error(`material color number must be an integer in [0, 0xffffff], got ${value}`);
73
+ }
74
+ return `#${value.toString(16).padStart(6, '0')}`;
75
+ }
76
+
77
+ function linearColorFromInput(
78
+ input: MaterialColorInput3 | MaterialColorInput4,
79
+ channels: 3 | 4,
80
+ ): readonly number[] {
81
+ if (typeof input === 'number' || typeof input === 'string') {
82
+ const parsed = color.create();
83
+ color.fromCss(parsed, typeof input === 'number' ? colorHexFromNumber(input) : input);
84
+ return channels === 3
85
+ ? [parsed[0] as number, parsed[1] as number, parsed[2] as number]
86
+ : Array.from(parsed);
87
+ }
88
+ if (input.length !== channels) {
89
+ throw new Error(`material color tuple must contain ${channels} channels, got ${input.length}`);
90
+ }
91
+ return [...input];
92
+ }
93
+
94
+ /** Convert an explicit sRGB numeric tuple into the linear tuple factories store. */
95
+ export function srgb(input: MaterialColorTuple3): MaterialColorTuple3;
96
+ export function srgb(input: MaterialColorTuple4): MaterialColorTuple4;
97
+ export function srgb(input: readonly number[]): readonly number[] {
98
+ if (input.length !== 3 && input.length !== 4) {
99
+ throw new Error(`sRGB material color tuple must contain 3 or 4 channels, got ${input.length}`);
100
+ }
101
+ const parsed = color.create(input[0] ?? 0, input[1] ?? 0, input[2] ?? 0, input[3] ?? 1);
102
+ color.srgbToLinear(parsed, parsed);
103
+ return input.length === 3
104
+ ? [parsed[0] as number, parsed[1] as number, parsed[2] as number]
105
+ : [parsed[0] as number, parsed[1] as number, parsed[2] as number, parsed[3] as number];
106
+ }
107
+
63
108
  function authoredColorParameter(
64
109
  name: string,
65
110
  type: 'color' | 'vec3',
@@ -74,27 +119,148 @@ function authoredColorParameter(
74
119
  };
75
120
  }
76
121
 
77
- function standardParameters(colorSpace: MaterialColorSpace): readonly MaterialParameter[] {
78
- return DEFAULT_STANDARD_PBR_PARAM_SCHEMA.map((entry) => {
79
- const type = entry.type.startsWith('texture') ? 'texture' : entry.type;
80
- const isRequired =
81
- entry.name === 'baseColor' || entry.name === 'metallic' || entry.name === 'roughness';
82
- const authoredColor =
83
- entry.type === 'color' || (entry.type === 'vec3' && entry.name !== 'attenuationColor');
84
- const schemaColorSpace = 'colorSpace' in entry ? entry.colorSpace : undefined;
85
- const colorSpaceProjection: { colorSpace?: MaterialColorSpace } = {};
86
- if (authoredColor && !(type === 'color' && colorSpace === 'srgb')) {
87
- colorSpaceProjection.colorSpace = colorSpace;
88
- } else if (!authoredColor && schemaColorSpace !== undefined) {
89
- colorSpaceProjection.colorSpace = schemaColorSpace;
122
+ function standardParameters(
123
+ colorSpace: MaterialColorSpace,
124
+ opts: StandardOpts,
125
+ ): readonly MaterialParameter[] {
126
+ const physicalNames = new Set<string>();
127
+ const addPhysical = (...names: readonly string[]) => {
128
+ for (const name of names) physicalNames.add(name);
129
+ };
130
+ if (
131
+ opts.clearcoat !== undefined ||
132
+ opts.clearcoatRoughness !== undefined ||
133
+ opts.clearcoatNormalScale !== undefined ||
134
+ opts.clearcoatTexture !== undefined ||
135
+ opts.clearcoatRoughnessTexture !== undefined ||
136
+ opts.clearcoatNormalTexture !== undefined
137
+ ) {
138
+ addPhysical(
139
+ 'clearcoat',
140
+ 'clearcoatRoughness',
141
+ 'clearcoatNormalScale',
142
+ ...(opts.clearcoatTexture === undefined ? [] : ['clearcoatTexture']),
143
+ ...(opts.clearcoatRoughnessTexture === undefined ? [] : ['clearcoatRoughnessTexture']),
144
+ ...(opts.clearcoatNormalTexture === undefined ? [] : ['clearcoatNormalTexture']),
145
+ );
146
+ }
147
+ if (
148
+ opts.anisotropyStrength !== undefined ||
149
+ opts.anisotropyRotation !== undefined ||
150
+ opts.anisotropyTexture !== undefined
151
+ ) {
152
+ addPhysical('anisotropyStrength', 'anisotropyRotation');
153
+ if (opts.anisotropyTexture !== undefined) addPhysical('anisotropyTexture');
154
+ }
155
+ if (
156
+ opts.sheenColor !== undefined ||
157
+ opts.sheenRoughness !== undefined ||
158
+ opts.sheenColorTexture !== undefined ||
159
+ opts.sheenRoughnessTexture !== undefined
160
+ ) {
161
+ addPhysical('sheenColor', 'sheenRoughness');
162
+ if (opts.sheenColorTexture !== undefined) addPhysical('sheenColorTexture');
163
+ if (opts.sheenRoughnessTexture !== undefined) addPhysical('sheenRoughnessTexture');
164
+ }
165
+ if (
166
+ opts.iridescence !== undefined ||
167
+ opts.iridescenceIor !== undefined ||
168
+ opts.iridescenceThicknessMinimum !== undefined ||
169
+ opts.iridescenceThicknessMaximum !== undefined ||
170
+ opts.iridescenceTexture !== undefined ||
171
+ opts.iridescenceThicknessTexture !== undefined
172
+ ) {
173
+ addPhysical(
174
+ 'iridescence',
175
+ 'iridescenceIor',
176
+ 'iridescenceThicknessMinimum',
177
+ 'iridescenceThicknessMaximum',
178
+ ...(opts.iridescenceTexture === undefined ? [] : ['iridescenceTexture']),
179
+ ...(opts.iridescenceThicknessTexture === undefined ? [] : ['iridescenceThicknessTexture']),
180
+ );
181
+ }
182
+ const baseNames = new Set([
183
+ 'baseColor',
184
+ 'metallic',
185
+ 'roughness',
186
+ 'metallicChannel',
187
+ 'roughnessChannel',
188
+ 'aoChannel',
189
+ 'extraChannel',
190
+ 'emissive',
191
+ 'emissiveIntensity',
192
+ 'occlusionStrength',
193
+ 'alphaCutoff',
194
+ 'normalScale',
195
+ 'baseColorTexture',
196
+ 'metallicRoughnessTexture',
197
+ 'normalTexture',
198
+ 'emissiveTexture',
199
+ 'occlusionTexture',
200
+ 'specular',
201
+ 'specularColor',
202
+ // IOR is part of the always-present dielectric F0 contract. The
203
+ // transmission layer may be absent, but the Standard shader still
204
+ // consumes this scalar for the base reflection path.
205
+ 'ior',
206
+ ]);
207
+ if (opts.specularTexture !== undefined) baseNames.add('specularTexture');
208
+ if (opts.specularColorTexture !== undefined) baseNames.add('specularColorTexture');
209
+ if (
210
+ opts.transmission !== undefined ||
211
+ opts.ior !== undefined ||
212
+ opts.thickness !== undefined ||
213
+ opts.transmissionTexture !== undefined ||
214
+ opts.thicknessTexture !== undefined ||
215
+ opts.attenuationColor !== undefined ||
216
+ opts.attenuationDistance !== undefined
217
+ ) {
218
+ for (const name of [
219
+ 'transmission',
220
+ 'ior',
221
+ 'thickness',
222
+ 'attenuationColor',
223
+ 'attenuationDistance',
224
+ 'transmissionTexture',
225
+ 'thicknessTexture',
226
+ ]) {
227
+ baseNames.add(name);
90
228
  }
91
- return {
92
- name: entry.name,
93
- type,
94
- ...colorSpaceProjection,
95
- ...(isRequired ? {} : { optional: true }),
96
- } as MaterialParameter;
97
- });
229
+ }
230
+ // All Standard fields come from one root schema. Physical fields are
231
+ // projected by the authored option membership above; appending a second
232
+ // physical schema would create a parallel ABI authority.
233
+ const availableSchema = DEFAULT_STANDARD_PBR_PARAM_SCHEMA;
234
+ // Keep the generated Standard UBO's numeric run contiguous before any
235
+ // texture coordinate records. The built-in WGSL places the complete
236
+ // physical root (including clearcoat scalars) after the base numeric run
237
+ // and before all coordinate pairs; appending physical entries after the
238
+ // base texture records would otherwise derive a different ABI.
239
+ const numericSchema = availableSchema.filter((entry) => !entry.type.startsWith('texture'));
240
+ const textureSchema = availableSchema.filter((entry) => entry.type.startsWith('texture'));
241
+ const orderedSchema = [...numericSchema, ...textureSchema];
242
+ return orderedSchema
243
+ .filter((entry) => baseNames.has(entry.name) || physicalNames.has(entry.name))
244
+ .map((entry) => {
245
+ const type = entry.type.startsWith('texture') ? 'texture' : entry.type;
246
+ const isRequired =
247
+ entry.name === 'baseColor' || entry.name === 'metallic' || entry.name === 'roughness';
248
+ const authoredColor =
249
+ entry.type === 'color' || (entry.type === 'vec3' && entry.name !== 'attenuationColor');
250
+ const schemaColorSpace = 'colorSpace' in entry ? entry.colorSpace : undefined;
251
+ const colorSpaceProjection: { colorSpace?: MaterialColorSpace } = {};
252
+ if (authoredColor && !(type === 'color' && colorSpace === 'srgb')) {
253
+ colorSpaceProjection.colorSpace = colorSpace;
254
+ } else if (!authoredColor && schemaColorSpace !== undefined) {
255
+ colorSpaceProjection.colorSpace = schemaColorSpace;
256
+ }
257
+ return {
258
+ name: entry.name,
259
+ type,
260
+ ...colorSpaceProjection,
261
+ ...(isRequired ? {} : { optional: true }),
262
+ } as MaterialParameter;
263
+ });
98
264
  }
99
265
 
100
266
  function unlitParameters(colorSpace: MaterialColorSpace): readonly MaterialParameter[] {
@@ -130,9 +296,17 @@ function pass(
130
296
  };
131
297
  }
132
298
 
299
+ function shadowCasterRenderState(
300
+ renderState: MaterialRenderState | undefined,
301
+ ): MaterialRenderState | undefined {
302
+ if (renderState?.cullMode === undefined && renderState?.frontFace === undefined) return undefined;
303
+ return {
304
+ ...(renderState.cullMode === undefined ? {} : { cullMode: renderState.cullMode }),
305
+ ...(renderState.frontFace === undefined ? {} : { frontFace: renderState.frontFace }),
306
+ };
307
+ }
308
+
133
309
  interface UnlitOpts {
134
- /** Asset-side authored color space. Defaults to sRGB. */
135
- readonly colorSpace?: MaterialColorSpace;
136
310
  readonly castShadow?: boolean;
137
311
  readonly baseColorTexture?: MaterialValue;
138
312
  readonly alphaCutoff?: number;
@@ -140,32 +314,31 @@ interface UnlitOpts {
140
314
  readonly queue?: number;
141
315
  }
142
316
 
143
- function unlit(rgba: readonly [number, number, number, number], opts?: UnlitOpts): MaterialAsset {
317
+ function unlit(rgba: MaterialColorInput4, opts?: UnlitOpts): MaterialAsset {
144
318
  if (opts?.alphaCutoff !== undefined && (opts.alphaCutoff < 0 || opts.alphaCutoff > 1)) {
145
319
  throw new Error(`Materials.unlit: alphaCutoff must be in [0, 1], got ${opts.alphaCutoff}`);
146
320
  }
147
- const values: Record<string, MaterialValue> = { baseColor: rgba };
321
+ const values: Record<string, MaterialValue> = { baseColor: linearColorFromInput(rgba, 4) };
148
322
  if (opts?.baseColorTexture !== undefined) values.baseColorTexture = opts.baseColorTexture;
149
323
  if (opts?.alphaCutoff !== undefined) values.alphaCutoff = opts.alphaCutoff;
150
324
  const passes: [MaterialPass, ...MaterialPass[]] = [
151
325
  pass('forward', UNLIT_MODULE, opts?.renderState, undefined, opts?.queue),
152
326
  ];
153
- if (opts?.castShadow !== false) passes.push(pass('shadow-caster', UNLIT_MODULE, undefined));
327
+ if (opts?.castShadow !== false) {
328
+ passes.push(pass('shadow-caster', UNLIT_MODULE, shadowCasterRenderState(opts?.renderState)));
329
+ }
154
330
  return {
155
331
  kind: 'material',
156
- ...(opts?.colorSpace === undefined || opts.colorSpace === 'srgb'
157
- ? {}
158
- : { colorSpace: opts.colorSpace }),
332
+ colorSpace: 'linear',
159
333
  passes,
160
- parameters: unlitParameters(opts?.colorSpace ?? 'srgb'),
334
+ parameters: unlitParameters('linear'),
161
335
  values,
162
336
  };
163
337
  }
164
338
 
165
339
  interface StandardOpts {
166
- /** Asset-side authored color space for baseColor/emissive/specularTint. Defaults to sRGB. */
167
- readonly colorSpace?: MaterialColorSpace;
168
- readonly baseColor: readonly [number, number, number, number];
340
+ /** Numeric tuples are linear; Hex/CSS strings and numbers are sRGB inputs. */
341
+ readonly baseColor: MaterialColorInput4;
169
342
  readonly metallic?: number;
170
343
  readonly roughness?: number;
171
344
  /** Texture channel used for the metallic factor; glTF defaults to B (2). */
@@ -174,9 +347,28 @@ interface StandardOpts {
174
347
  readonly roughnessChannel?: number;
175
348
  readonly clearcoat?: number;
176
349
  readonly clearcoatRoughness?: number;
177
- readonly specularTint?: readonly [number, number, number];
178
- readonly specularTintTexture?: MaterialValue;
179
- readonly emissive?: readonly [number, number, number];
350
+ readonly clearcoatTexture?: MaterialValue;
351
+ readonly clearcoatRoughnessTexture?: MaterialValue;
352
+ readonly clearcoatNormalTexture?: MaterialValue;
353
+ readonly clearcoatNormalScale?: number;
354
+ readonly anisotropyStrength?: number;
355
+ readonly anisotropyRotation?: number;
356
+ readonly anisotropyTexture?: MaterialValue;
357
+ readonly sheenColor?: MaterialColorInput3;
358
+ readonly sheenRoughness?: number;
359
+ readonly sheenColorTexture?: MaterialValue;
360
+ readonly sheenRoughnessTexture?: MaterialValue;
361
+ readonly iridescence?: number;
362
+ readonly iridescenceIor?: number;
363
+ readonly iridescenceThicknessMinimum?: number;
364
+ readonly iridescenceThicknessMaximum?: number;
365
+ readonly iridescenceTexture?: MaterialValue;
366
+ readonly iridescenceThicknessTexture?: MaterialValue;
367
+ readonly specular?: number;
368
+ readonly specularColor?: MaterialColorInput3;
369
+ readonly specularTexture?: MaterialValue;
370
+ readonly specularColorTexture?: MaterialValue;
371
+ readonly emissive?: MaterialColorInput3;
180
372
  readonly emissiveIntensity?: number;
181
373
  readonly emissiveTexture?: MaterialValue;
182
374
  readonly baseColorTexture?: MaterialValue;
@@ -254,11 +446,13 @@ function standard(opts: StandardOpts): MaterialAsset {
254
446
  throw new MaterialTransmissionContractError('transmission', 'depth-write', true);
255
447
  }
256
448
  const values: Record<string, MaterialValue> = {
257
- baseColor: opts.baseColor,
449
+ baseColor: linearColorFromInput(opts.baseColor, 4),
258
450
  metallic: opts.metallic ?? 0,
259
451
  roughness: opts.roughness ?? 0.5,
260
452
  occlusionStrength,
261
- specularTint: opts.specularTint ?? [1, 1, 1],
453
+ specular: opts.specular ?? 1,
454
+ specularColor:
455
+ opts.specularColor === undefined ? [1, 1, 1] : linearColorFromInput(opts.specularColor, 3),
262
456
  transmission,
263
457
  ior,
264
458
  thickness,
@@ -268,7 +462,37 @@ function standard(opts: StandardOpts): MaterialAsset {
268
462
  if (opts.roughnessChannel !== undefined) values.roughnessChannel = opts.roughnessChannel;
269
463
  if (opts.clearcoat !== undefined) values.clearcoat = opts.clearcoat;
270
464
  if (opts.clearcoatRoughness !== undefined) values.clearcoatRoughness = opts.clearcoatRoughness;
271
- if (opts.emissive !== undefined) values.emissive = opts.emissive;
465
+ if (opts.clearcoatTexture !== undefined) values.clearcoatTexture = opts.clearcoatTexture;
466
+ if (opts.clearcoatRoughnessTexture !== undefined) {
467
+ values.clearcoatRoughnessTexture = opts.clearcoatRoughnessTexture;
468
+ }
469
+ if (opts.clearcoatNormalTexture !== undefined) {
470
+ values.clearcoatNormalTexture = opts.clearcoatNormalTexture;
471
+ }
472
+ if (opts.clearcoatNormalScale !== undefined)
473
+ values.clearcoatNormalScale = opts.clearcoatNormalScale;
474
+ if (opts.anisotropyStrength !== undefined) values.anisotropyStrength = opts.anisotropyStrength;
475
+ if (opts.anisotropyRotation !== undefined) values.anisotropyRotation = opts.anisotropyRotation;
476
+ if (opts.anisotropyTexture !== undefined) values.anisotropyTexture = opts.anisotropyTexture;
477
+ if (opts.sheenColor !== undefined) values.sheenColor = linearColorFromInput(opts.sheenColor, 3);
478
+ if (opts.sheenRoughness !== undefined) values.sheenRoughness = opts.sheenRoughness;
479
+ if (opts.sheenColorTexture !== undefined) values.sheenColorTexture = opts.sheenColorTexture;
480
+ if (opts.sheenRoughnessTexture !== undefined) {
481
+ values.sheenRoughnessTexture = opts.sheenRoughnessTexture;
482
+ }
483
+ if (opts.iridescence !== undefined) values.iridescence = opts.iridescence;
484
+ if (opts.iridescenceIor !== undefined) values.iridescenceIor = opts.iridescenceIor;
485
+ if (opts.iridescenceThicknessMinimum !== undefined) {
486
+ values.iridescenceThicknessMinimum = opts.iridescenceThicknessMinimum;
487
+ }
488
+ if (opts.iridescenceThicknessMaximum !== undefined) {
489
+ values.iridescenceThicknessMaximum = opts.iridescenceThicknessMaximum;
490
+ }
491
+ if (opts.iridescenceTexture !== undefined) values.iridescenceTexture = opts.iridescenceTexture;
492
+ if (opts.iridescenceThicknessTexture !== undefined) {
493
+ values.iridescenceThicknessTexture = opts.iridescenceThicknessTexture;
494
+ }
495
+ if (opts.emissive !== undefined) values.emissive = linearColorFromInput(opts.emissive, 3);
272
496
  if (opts.emissiveIntensity !== undefined) values.emissiveIntensity = opts.emissiveIntensity;
273
497
  if (opts.emissiveTexture !== undefined) values.emissiveTexture = opts.emissiveTexture;
274
498
  if (opts.baseColorTexture !== undefined) values.baseColorTexture = opts.baseColorTexture;
@@ -277,8 +501,9 @@ function standard(opts: StandardOpts): MaterialAsset {
277
501
  }
278
502
  if (opts.normalTexture !== undefined) values.normalTexture = opts.normalTexture;
279
503
  if (opts.occlusionTexture !== undefined) values.occlusionTexture = opts.occlusionTexture;
280
- if (opts.specularTintTexture !== undefined) {
281
- values.specularTintTexture = opts.specularTintTexture;
504
+ if (opts.specularTexture !== undefined) values.specularTexture = opts.specularTexture;
505
+ if (opts.specularColorTexture !== undefined) {
506
+ values.specularColorTexture = opts.specularColorTexture;
282
507
  }
283
508
  if (opts.alphaCutoff !== undefined) values.alphaCutoff = opts.alphaCutoff;
284
509
  if (opts.transmissionTexture !== undefined) values.transmissionTexture = opts.transmissionTexture;
@@ -286,24 +511,30 @@ function standard(opts: StandardOpts): MaterialAsset {
286
511
  if (opts.attenuationDistance !== undefined) values.attenuationDistance = opts.attenuationDistance;
287
512
  const forwardRenderState =
288
513
  transmission > 0 ? { ...(opts.renderState ?? {}), depthWriteEnabled: false } : opts.renderState;
514
+ const parameters = standardParameters('linear', opts);
515
+ const declaredNames = new Set(parameters.map((parameter) => parameter.name));
516
+ for (const name of Object.keys(values)) {
517
+ if (!declaredNames.has(name)) delete values[name];
518
+ }
519
+ const physical = deriveStandardLayerPlan(parameters).mode === 'physical';
289
520
  const passes: [MaterialPass, ...MaterialPass[]] = [
290
521
  pass('forward', STANDARD_MODULE, forwardRenderState, 'fs_main', opts.queue),
291
522
  ];
292
- if (transmission === 0) {
523
+ if (!physical && transmission === 0) {
293
524
  passes.push(pass('deferred', STANDARD_MODULE, opts.renderState, 'fs_gbuffer', opts.queue));
294
525
  }
295
- if (opts.castShadow !== false) passes.push(pass('shadow-caster', STANDARD_MODULE, undefined));
526
+ if (opts.castShadow !== false) {
527
+ passes.push(pass('shadow-caster', STANDARD_MODULE, shadowCasterRenderState(opts.renderState)));
528
+ }
296
529
  return {
297
530
  kind: 'material',
298
- ...(opts.colorSpace === undefined || opts.colorSpace === 'srgb'
299
- ? {}
300
- : { colorSpace: opts.colorSpace }),
531
+ colorSpace: 'linear',
301
532
  passes,
302
- parameters: standardParameters(opts.colorSpace ?? 'srgb'),
533
+ parameters,
303
534
  values,
304
535
  };
305
536
  }
306
537
 
307
- export const Materials = { unlit, standard } as const;
538
+ export const Materials = { unlit, standard, srgb } as const;
308
539
 
309
540
  export { SPRITE_MODULE };
@@ -12,6 +12,65 @@ export interface MeshMaterialBindingDiagnostic {
12
12
  readonly detail?: Readonly<AssetErrorDetail>;
13
13
  }
14
14
 
15
+ /** Detached final-frame receipt for the Standard material IBL binding chain. */
16
+ export interface IblBindingResourceInspection {
17
+ readonly viewIdentity: number;
18
+ readonly samplerIdentity: number;
19
+ readonly deviceGeneration: number;
20
+ }
21
+
22
+ export interface IblBindingEntryInspection {
23
+ readonly binding: number;
24
+ readonly kind: 'textureView' | 'sampler' | 'buffer';
25
+ readonly resourceIdentity: number;
26
+ }
27
+
28
+ export interface IblBindingInspection {
29
+ readonly status: 'binding-chain-consistent' | 'binding-chain-mismatch';
30
+ readonly frameId: number;
31
+ readonly deviceGeneration: number;
32
+ readonly active: 'active' | 'fallback';
33
+ readonly cache: {
34
+ readonly identity: number;
35
+ readonly generation: number;
36
+ readonly prefilterMipCount: number;
37
+ readonly prefilterViewMipCount: number;
38
+ };
39
+ readonly sampler: {
40
+ readonly expected: {
41
+ readonly magFilter: 'linear';
42
+ readonly minFilter: 'linear';
43
+ readonly mipmapFilter: 'linear';
44
+ readonly addressModeU: 'clamp-to-edge';
45
+ readonly addressModeV: 'clamp-to-edge';
46
+ readonly addressModeW: 'clamp-to-edge';
47
+ };
48
+ readonly identities: readonly number[];
49
+ };
50
+ readonly resources: {
51
+ readonly irradiance: IblBindingResourceInspection;
52
+ readonly prefilter: IblBindingResourceInspection;
53
+ readonly brdfLut: IblBindingResourceInspection;
54
+ readonly intensityBufferIdentity: number;
55
+ };
56
+ readonly material?: {
57
+ readonly bindGroupIdentity: number;
58
+ readonly materialBglIdentity: number;
59
+ readonly cache: 'hit' | 'miss';
60
+ readonly skylightBindingStart: number;
61
+ readonly entries: readonly IblBindingEntryInspection[];
62
+ readonly reflectionBindings: readonly number[];
63
+ };
64
+ readonly pipeline?: {
65
+ readonly pipelineIdentity: number;
66
+ readonly effectiveMaterialLayoutIdentity: string | undefined;
67
+ readonly materialBglIdentity: number;
68
+ readonly bindGroupIdentity: number;
69
+ readonly drawFrameId: number;
70
+ };
71
+ readonly errors: readonly string[];
72
+ }
73
+
15
74
  export interface ResolvedMeshMaterialBinding {
16
75
  readonly handle: number;
17
76
  readonly source: MeshMaterialBindingSource;
@@ -0,0 +1,64 @@
1
+ import { mat4 } from '@forgeax/engine-math';
2
+ import { computeProjectionMatrix, computeViewMatrix } from './record/helpers';
3
+ import type { CameraSnapshot } from './render-contract';
4
+
5
+ /** Build the camera-facing proxy geometry used by GPU occlusion queries. */
6
+ export function buildOcclusionProxyVertices(
7
+ aabb: ArrayLike<number>,
8
+ world: ArrayLike<number>,
9
+ camera: CameraSnapshot,
10
+ ): Float32Array {
11
+ const view = computeViewMatrix(camera);
12
+ const projection = computeProjectionMatrix(camera);
13
+ const viewProjection = mat4.create();
14
+ mat4.multiply(viewProjection, projection, view);
15
+ const corners = [
16
+ [aabb[0] ?? 0, aabb[1] ?? 0, aabb[2] ?? 0],
17
+ [aabb[3] ?? 0, aabb[1] ?? 0, aabb[2] ?? 0],
18
+ [aabb[3] ?? 0, aabb[4] ?? 0, aabb[2] ?? 0],
19
+ [aabb[0] ?? 0, aabb[4] ?? 0, aabb[2] ?? 0],
20
+ [aabb[0] ?? 0, aabb[1] ?? 0, aabb[5] ?? 0],
21
+ [aabb[3] ?? 0, aabb[1] ?? 0, aabb[5] ?? 0],
22
+ [aabb[3] ?? 0, aabb[4] ?? 0, aabb[5] ?? 0],
23
+ [aabb[0] ?? 0, aabb[4] ?? 0, aabb[5] ?? 0],
24
+ ];
25
+ const triangles = [
26
+ 0, 1, 2, 0, 2, 3, 4, 6, 5, 4, 7, 6, 0, 4, 5, 0, 5, 1, 3, 2, 6, 3, 6, 7, 0, 3, 7, 0, 7, 4, 1, 5,
27
+ 6, 1, 6, 2,
28
+ ];
29
+ const output = new Float32Array(triangles.length * 4);
30
+ for (let index = 0; index < triangles.length; index += 1) {
31
+ const corner = corners[triangles[index] ?? 0] ?? [0, 0, 0];
32
+ const cx = corner[0] ?? 0;
33
+ const cy = corner[1] ?? 0;
34
+ const cz = corner[2] ?? 0;
35
+ const x = (world[0] ?? 0) * cx + (world[4] ?? 0) * cy + (world[8] ?? 0) * cz + (world[12] ?? 0);
36
+ const y = (world[1] ?? 0) * cx + (world[5] ?? 0) * cy + (world[9] ?? 0) * cz + (world[13] ?? 0);
37
+ const z =
38
+ (world[2] ?? 0) * cx + (world[6] ?? 0) * cy + (world[10] ?? 0) * cz + (world[14] ?? 0);
39
+ const w =
40
+ (world[3] ?? 0) * cx + (world[7] ?? 0) * cy + (world[11] ?? 0) * cz + (world[15] ?? 1);
41
+ const base = index * 4;
42
+ output[base] =
43
+ (viewProjection[0] ?? 0) * x +
44
+ (viewProjection[4] ?? 0) * y +
45
+ (viewProjection[8] ?? 0) * z +
46
+ (viewProjection[12] ?? 0) * w;
47
+ output[base + 1] =
48
+ (viewProjection[1] ?? 0) * x +
49
+ (viewProjection[5] ?? 0) * y +
50
+ (viewProjection[9] ?? 0) * z +
51
+ (viewProjection[13] ?? 0) * w;
52
+ output[base + 2] =
53
+ (viewProjection[2] ?? 0) * x +
54
+ (viewProjection[6] ?? 0) * y +
55
+ (viewProjection[10] ?? 0) * z +
56
+ (viewProjection[14] ?? 0) * w;
57
+ output[base + 3] =
58
+ (viewProjection[3] ?? 0) * x +
59
+ (viewProjection[7] ?? 0) * y +
60
+ (viewProjection[11] ?? 0) * z +
61
+ (viewProjection[15] ?? 0) * w;
62
+ }
63
+ return output;
64
+ }