@spatial-elements/core 1.0.0-beta.7 → 1.0.0-beta.8

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 (235) hide show
  1. package/dist/catalog/CarouselDeviceCamera.d.ts +8 -0
  2. package/dist/catalog/CarouselDeviceCamera.d.ts.map +1 -1
  3. package/dist/catalog/CarouselDeviceCamera.js +15 -1
  4. package/dist/catalog/CarouselDeviceCamera.js.map +1 -1
  5. package/dist/catalog/CarouselGlassCompositor.d.ts +8 -2
  6. package/dist/catalog/CarouselGlassCompositor.d.ts.map +1 -1
  7. package/dist/catalog/CarouselGlassCompositor.js +69 -12
  8. package/dist/catalog/CarouselGlassCompositor.js.map +1 -1
  9. package/dist/catalog/CarouselGround.d.ts +22 -1
  10. package/dist/catalog/CarouselGround.d.ts.map +1 -1
  11. package/dist/catalog/CarouselGround.js +185 -24
  12. package/dist/catalog/CarouselGround.js.map +1 -1
  13. package/dist/catalog/CatalogDepthBlur.d.ts +20 -1
  14. package/dist/catalog/CatalogDepthBlur.d.ts.map +1 -1
  15. package/dist/catalog/CatalogDepthBlur.js +126 -23
  16. package/dist/catalog/CatalogDepthBlur.js.map +1 -1
  17. package/dist/catalog/CatalogGeometryFade.d.ts +5 -1
  18. package/dist/catalog/CatalogGeometryFade.d.ts.map +1 -1
  19. package/dist/catalog/CatalogGeometryFade.js +39 -7
  20. package/dist/catalog/CatalogGeometryFade.js.map +1 -1
  21. package/dist/catalog/CatalogModelOutline.d.ts +3 -1
  22. package/dist/catalog/CatalogModelOutline.d.ts.map +1 -1
  23. package/dist/catalog/CatalogModelOutline.js +11 -2
  24. package/dist/catalog/CatalogModelOutline.js.map +1 -1
  25. package/dist/catalog/CatalogPreparation.d.ts.map +1 -1
  26. package/dist/catalog/CatalogPreparation.js +8 -6
  27. package/dist/catalog/CatalogPreparation.js.map +1 -1
  28. package/dist/catalog/CatalogSpatialElementLayer.d.ts +129 -3
  29. package/dist/catalog/CatalogSpatialElementLayer.d.ts.map +1 -1
  30. package/dist/catalog/CatalogSpatialElementLayer.js +408 -33
  31. package/dist/catalog/CatalogSpatialElementLayer.js.map +1 -1
  32. package/dist/catalog/CatalogTransition.d.ts +4 -0
  33. package/dist/catalog/CatalogTransition.d.ts.map +1 -1
  34. package/dist/catalog/CatalogTransition.js +91 -22
  35. package/dist/catalog/CatalogTransition.js.map +1 -1
  36. package/dist/catalog/CatalogWarmOutputContext.d.ts +39 -0
  37. package/dist/catalog/CatalogWarmOutputContext.d.ts.map +1 -0
  38. package/dist/catalog/CatalogWarmOutputContext.js +159 -0
  39. package/dist/catalog/CatalogWarmOutputContext.js.map +1 -0
  40. package/dist/catalog/EarlyNavigationCoordinator.d.ts +35 -0
  41. package/dist/catalog/EarlyNavigationCoordinator.d.ts.map +1 -0
  42. package/dist/catalog/EarlyNavigationCoordinator.js +103 -0
  43. package/dist/catalog/EarlyNavigationCoordinator.js.map +1 -0
  44. package/dist/catalog/NavigationFeedback.d.ts +12 -0
  45. package/dist/catalog/NavigationFeedback.d.ts.map +1 -0
  46. package/dist/catalog/NavigationFeedback.js +40 -0
  47. package/dist/catalog/NavigationFeedback.js.map +1 -0
  48. package/dist/catalog/PreparationGate.d.ts +4 -0
  49. package/dist/catalog/PreparationGate.d.ts.map +1 -1
  50. package/dist/catalog/PreparationGate.js +1 -0
  51. package/dist/catalog/PreparationGate.js.map +1 -1
  52. package/dist/catalog/SourceDomClipping.d.ts +8 -0
  53. package/dist/catalog/SourceDomClipping.d.ts.map +1 -0
  54. package/dist/catalog/SourceDomClipping.js +74 -0
  55. package/dist/catalog/SourceDomClipping.js.map +1 -0
  56. package/dist/catalog/SourceDomMotion.d.ts +28 -0
  57. package/dist/catalog/SourceDomMotion.d.ts.map +1 -0
  58. package/dist/catalog/SourceDomMotion.js +111 -0
  59. package/dist/catalog/SourceDomMotion.js.map +1 -0
  60. package/dist/catalog/SpatialPageRegistry.d.ts +1 -0
  61. package/dist/catalog/SpatialPageRegistry.d.ts.map +1 -1
  62. package/dist/catalog/SpatialPageRegistry.js.map +1 -1
  63. package/dist/catalog/StagedCatalogTransition.d.ts +74 -0
  64. package/dist/catalog/StagedCatalogTransition.d.ts.map +1 -0
  65. package/dist/catalog/StagedCatalogTransition.js +270 -0
  66. package/dist/catalog/StagedCatalogTransition.js.map +1 -0
  67. package/dist/catalog/cardProjection.d.ts +31 -0
  68. package/dist/catalog/cardProjection.d.ts.map +1 -1
  69. package/dist/catalog/cardProjection.js +63 -4
  70. package/dist/catalog/cardProjection.js.map +1 -1
  71. package/dist/catalog/carouselPanelProjection.d.ts.map +1 -1
  72. package/dist/catalog/carouselPanelProjection.js +48 -11
  73. package/dist/catalog/carouselPanelProjection.js.map +1 -1
  74. package/dist/catalog/catalogActivationFocus.d.ts +5 -0
  75. package/dist/catalog/catalogActivationFocus.d.ts.map +1 -0
  76. package/dist/catalog/catalogActivationFocus.js +39 -0
  77. package/dist/catalog/catalogActivationFocus.js.map +1 -0
  78. package/dist/catalog/catalogJourney.d.ts +2 -0
  79. package/dist/catalog/catalogJourney.d.ts.map +1 -1
  80. package/dist/catalog/catalogJourney.js.map +1 -1
  81. package/dist/catalog/catalogPose.d.ts +18 -0
  82. package/dist/catalog/catalogPose.d.ts.map +1 -1
  83. package/dist/catalog/catalogPose.js +26 -5
  84. package/dist/catalog/catalogPose.js.map +1 -1
  85. package/dist/catalog/catalogTransitionViewport.d.ts +9 -0
  86. package/dist/catalog/catalogTransitionViewport.d.ts.map +1 -0
  87. package/dist/catalog/catalogTransitionViewport.js +13 -0
  88. package/dist/catalog/catalogTransitionViewport.js.map +1 -0
  89. package/dist/catalog/catalogViewLink.d.ts +2 -0
  90. package/dist/catalog/catalogViewLink.d.ts.map +1 -1
  91. package/dist/catalog/catalogViewLink.js +10 -2
  92. package/dist/catalog/catalogViewLink.js.map +1 -1
  93. package/dist/catalog/listDeviceOrientation.d.ts +2 -0
  94. package/dist/catalog/listDeviceOrientation.d.ts.map +1 -1
  95. package/dist/catalog/listDeviceOrientation.js +18 -1
  96. package/dist/catalog/listDeviceOrientation.js.map +1 -1
  97. package/dist/catalog/stagedDetailGeometry.d.ts +37 -0
  98. package/dist/catalog/stagedDetailGeometry.d.ts.map +1 -0
  99. package/dist/catalog/stagedDetailGeometry.js +55 -0
  100. package/dist/catalog/stagedDetailGeometry.js.map +1 -0
  101. package/dist/catalog/stagedDockGeometry.d.ts +66 -0
  102. package/dist/catalog/stagedDockGeometry.d.ts.map +1 -0
  103. package/dist/catalog/stagedDockGeometry.js +66 -0
  104. package/dist/catalog/stagedDockGeometry.js.map +1 -0
  105. package/dist/index.d.ts +2 -1
  106. package/dist/index.d.ts.map +1 -1
  107. package/dist/index.js +2 -1
  108. package/dist/index.js.map +1 -1
  109. package/dist/spatial-element/ResponsiveViewportMetrics.d.ts +18 -0
  110. package/dist/spatial-element/ResponsiveViewportMetrics.d.ts.map +1 -0
  111. package/dist/spatial-element/ResponsiveViewportMetrics.js +68 -0
  112. package/dist/spatial-element/ResponsiveViewportMetrics.js.map +1 -0
  113. package/dist/spatial-element/SectionSurfaceRegistry.d.ts +24 -0
  114. package/dist/spatial-element/SectionSurfaceRegistry.d.ts.map +1 -0
  115. package/dist/spatial-element/SectionSurfaceRegistry.js +48 -0
  116. package/dist/spatial-element/SectionSurfaceRegistry.js.map +1 -0
  117. package/dist/spatial-element/SpatialElementDockController.d.ts +19 -9
  118. package/dist/spatial-element/SpatialElementDockController.d.ts.map +1 -1
  119. package/dist/spatial-element/SpatialElementDockController.js +189 -93
  120. package/dist/spatial-element/SpatialElementDockController.js.map +1 -1
  121. package/dist/spatial-element/SpatialElementPaneController.d.ts +67 -0
  122. package/dist/spatial-element/SpatialElementPaneController.d.ts.map +1 -0
  123. package/dist/spatial-element/SpatialElementPaneController.js +245 -0
  124. package/dist/spatial-element/SpatialElementPaneController.js.map +1 -0
  125. package/dist/spatial-element/activeDetailSection.d.ts +8 -0
  126. package/dist/spatial-element/activeDetailSection.d.ts.map +1 -0
  127. package/dist/spatial-element/activeDetailSection.js +19 -0
  128. package/dist/spatial-element/activeDetailSection.js.map +1 -0
  129. package/dist/spatial-element/layoutTokens.json +53 -0
  130. package/dist/spatial-element/responsiveLayout.d.ts +1389 -0
  131. package/dist/spatial-element/responsiveLayout.d.ts.map +1 -0
  132. package/dist/spatial-element/responsiveLayout.js +265 -0
  133. package/dist/spatial-element/responsiveLayout.js.map +1 -0
  134. package/dist/spatial-element/sectionBackground.d.ts +29 -0
  135. package/dist/spatial-element/sectionBackground.d.ts.map +1 -0
  136. package/dist/spatial-element/sectionBackground.js +66 -0
  137. package/dist/spatial-element/sectionBackground.js.map +1 -0
  138. package/dist/spatial-element/spatialElement.d.ts +1 -0
  139. package/dist/spatial-element/spatialElement.d.ts.map +1 -1
  140. package/dist/spatial-element/spatialElement.js +1 -0
  141. package/dist/spatial-element/spatialElement.js.map +1 -1
  142. package/dist/spatial-element/spatialElementDock.d.ts +15 -0
  143. package/dist/spatial-element/spatialElementDock.d.ts.map +1 -1
  144. package/dist/spatial-element/spatialElementDock.js +22 -0
  145. package/dist/spatial-element/spatialElementDock.js.map +1 -1
  146. package/dist/spatial-element/spatialElementMedia.d.ts +16 -0
  147. package/dist/spatial-element/spatialElementMedia.d.ts.map +1 -0
  148. package/dist/spatial-element/spatialElementMedia.js +29 -0
  149. package/dist/spatial-element/spatialElementMedia.js.map +1 -0
  150. package/dist/spatial-element/spatialTheme.d.ts +12 -1
  151. package/dist/spatial-element/spatialTheme.d.ts.map +1 -1
  152. package/dist/spatial-element/spatialTheme.js +30 -1
  153. package/dist/spatial-element/spatialTheme.js.map +1 -1
  154. package/dist/spatial-element/types.d.ts +50 -2
  155. package/dist/spatial-element/types.d.ts.map +1 -1
  156. package/dist/spatial-element/types.js.map +1 -1
  157. package/dist/stage/BackgroundLayerOutput.d.ts +76 -0
  158. package/dist/stage/BackgroundLayerOutput.d.ts.map +1 -0
  159. package/dist/stage/BackgroundLayerOutput.js +333 -0
  160. package/dist/stage/BackgroundLayerOutput.js.map +1 -0
  161. package/dist/stage/LiquidGlassPanel.d.ts +3 -0
  162. package/dist/stage/LiquidGlassPanel.d.ts.map +1 -1
  163. package/dist/stage/LiquidGlassPanel.js +27 -2
  164. package/dist/stage/LiquidGlassPanel.js.map +1 -1
  165. package/dist/stage/MinimapController.d.ts.map +1 -1
  166. package/dist/stage/MinimapController.js +28 -47
  167. package/dist/stage/MinimapController.js.map +1 -1
  168. package/dist/stage/PageBindingController.d.ts +4 -0
  169. package/dist/stage/PageBindingController.d.ts.map +1 -1
  170. package/dist/stage/PageBindingController.js +12 -4
  171. package/dist/stage/PageBindingController.js.map +1 -1
  172. package/dist/stage/PanelPresentationController.d.ts +17 -0
  173. package/dist/stage/PanelPresentationController.d.ts.map +1 -1
  174. package/dist/stage/PanelPresentationController.js +69 -13
  175. package/dist/stage/PanelPresentationController.js.map +1 -1
  176. package/dist/stage/SpatialElementInteractionController.d.ts +7 -0
  177. package/dist/stage/SpatialElementInteractionController.d.ts.map +1 -1
  178. package/dist/stage/SpatialElementInteractionController.js +9 -0
  179. package/dist/stage/SpatialElementInteractionController.js.map +1 -1
  180. package/dist/stage/SpatialElementPresentationController.d.ts +14 -2
  181. package/dist/stage/SpatialElementPresentationController.d.ts.map +1 -1
  182. package/dist/stage/SpatialElementPresentationController.js +47 -2
  183. package/dist/stage/SpatialElementPresentationController.js.map +1 -1
  184. package/dist/stage/SpatialElementRefinement.d.ts +34 -1
  185. package/dist/stage/SpatialElementRefinement.d.ts.map +1 -1
  186. package/dist/stage/SpatialElementRefinement.js +175 -37
  187. package/dist/stage/SpatialElementRefinement.js.map +1 -1
  188. package/dist/stage/StageExperience.d.ts +167 -5
  189. package/dist/stage/StageExperience.d.ts.map +1 -1
  190. package/dist/stage/StageExperience.js +384 -58
  191. package/dist/stage/StageExperience.js.map +1 -1
  192. package/dist/stage/StageRenderPipeline.d.ts +76 -1
  193. package/dist/stage/StageRenderPipeline.d.ts.map +1 -1
  194. package/dist/stage/StageRenderPipeline.js +421 -46
  195. package/dist/stage/StageRenderPipeline.js.map +1 -1
  196. package/dist/stage/VirtualScrollController.d.ts +7 -0
  197. package/dist/stage/VirtualScrollController.d.ts.map +1 -1
  198. package/dist/stage/VirtualScrollController.js +57 -4
  199. package/dist/stage/VirtualScrollController.js.map +1 -1
  200. package/dist/stage/minimap/MinimapModel.d.ts +2 -1
  201. package/dist/stage/minimap/MinimapModel.d.ts.map +1 -1
  202. package/dist/stage/minimap/MinimapModel.js +34 -4
  203. package/dist/stage/minimap/MinimapModel.js.map +1 -1
  204. package/dist/stage/minimap/MinimapModelGeometry.d.ts +21 -0
  205. package/dist/stage/minimap/MinimapModelGeometry.d.ts.map +1 -0
  206. package/dist/stage/minimap/MinimapModelGeometry.js +68 -0
  207. package/dist/stage/minimap/MinimapModelGeometry.js.map +1 -0
  208. package/dist/stage/minimap/MinimapState.d.ts +3 -8
  209. package/dist/stage/minimap/MinimapState.d.ts.map +1 -1
  210. package/dist/stage/minimap/MinimapState.js.map +1 -1
  211. package/dist/stage/panelContext.d.ts +7 -0
  212. package/dist/stage/panelContext.d.ts.map +1 -1
  213. package/dist/stage/panelContext.js.map +1 -1
  214. package/dist/stage/rendererState.d.ts +2 -0
  215. package/dist/stage/rendererState.d.ts.map +1 -1
  216. package/dist/stage/rendererState.js +13 -0
  217. package/dist/stage/rendererState.js.map +1 -1
  218. package/dist/stage/sceneEndpointEligibility.d.ts +20 -0
  219. package/dist/stage/sceneEndpointEligibility.d.ts.map +1 -0
  220. package/dist/stage/sceneEndpointEligibility.js +363 -0
  221. package/dist/stage/sceneEndpointEligibility.js.map +1 -0
  222. package/dist/stage/stageDom.d.ts.map +1 -1
  223. package/dist/stage/stageDom.js +6 -1
  224. package/dist/stage/stageDom.js.map +1 -1
  225. package/dist/stage/stageMath.d.ts +3 -3
  226. package/dist/stage/stageMath.d.ts.map +1 -1
  227. package/dist/stage/stageMath.js +11 -10
  228. package/dist/stage/stageMath.js.map +1 -1
  229. package/dist/stage/stageTypes.d.ts +7 -1
  230. package/dist/stage/stageTypes.d.ts.map +1 -1
  231. package/dist/stage/stageTypes.js.map +1 -1
  232. package/dist/stage/stageVisualTest.d.ts +19 -0
  233. package/dist/stage/stageVisualTest.d.ts.map +1 -1
  234. package/dist/stage/stageVisualTest.js.map +1 -1
  235. package/package.json +1 -1
@@ -3,6 +3,19 @@ export declare function getRefinementSize(width: number, height: number): {
3
3
  width: number;
4
4
  height: number;
5
5
  };
6
+ export interface SceneEndpointGuard {
7
+ isValid(): boolean;
8
+ dispose(): void;
9
+ }
10
+ export interface SceneEndpointTicket {
11
+ commit(): boolean;
12
+ cancel(): void;
13
+ }
14
+ export interface RefinementRenderOptions {
15
+ /** Hidden preparation/its intervening RAFs borrow pixels without ticking q. */
16
+ advanceClock?: boolean;
17
+ backgroundReveal?: number;
18
+ }
6
19
  /** Separate scene captures preserve authored alpha without sorting two translucent element meshes. */
7
20
  export declare class SpatialElementRefinement {
8
21
  private readonly overlay;
@@ -15,12 +28,32 @@ export declare class SpatialElementRefinement {
15
28
  private readonly progress;
16
29
  private lastFrame?;
17
30
  private linearProgress;
31
+ private writeEpoch;
32
+ private sceneCache?;
33
+ private readonly cacheStats;
34
+ getSceneEndpointStats(): {
35
+ active: boolean;
36
+ pending: boolean;
37
+ preparations: number;
38
+ ready: number;
39
+ hits: number;
40
+ pendingReads: number;
41
+ invalidations: number;
42
+ staleTickets: number;
43
+ };
18
44
  complete: boolean;
19
45
  frames: number;
20
46
  get presentedProgress(): number;
21
47
  restart(): void;
22
48
  get targetCount(): number;
23
- render(renderer: THREE.WebGPURenderer, draw: (high: boolean) => void, reducedMotion: boolean, progress?: number): void;
49
+ invalidateSceneEndpoints(): void;
50
+ private ensureTargets;
51
+ private createCompositeMaterial;
52
+ private endpointsCurrent;
53
+ /** Call only after all warm live passes. Taking endpoints never advances the refinement clock.
54
+ * The caller fences these submissions and explicitly commits the returned ticket. */
55
+ prepareSceneEndpoints(renderer: THREE.WebGPURenderer, draw: (high: boolean, backgroundReveal: number) => void, guard: SceneEndpointGuard): SceneEndpointTicket | undefined;
56
+ render(renderer: THREE.WebGPURenderer, draw: (high: boolean) => void, reducedMotion: boolean, progress?: number, options?: RefinementRenderOptions): void;
24
57
  dispose(): void;
25
58
  }
26
59
  //# sourceMappingURL=SpatialElementRefinement.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"SpatialElementRefinement.d.ts","sourceRoot":"","sources":["../../src/stage/SpatialElementRefinement.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAMtC,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;;;EAM9D;AAED,sGAAsG;AACtG,qBAAa,wBAAwB;IAIxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,gBAAgB;gBAGa,OAAO,UAAQ;IAC5C,OAAO,CAAC,GAAG,CAAC,CAAqB;IACjC,OAAO,CAAC,IAAI,CAAC,CAAqB;IAClC,OAAO,CAAC,QAAQ,CAAC,CAAqB;IACtC,OAAO,CAAC,IAAI,CAAC,CAAiB;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAc;IACvC,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,cAAc,CAAK;IAC3B,QAAQ,UAAS;IACjB,MAAM,SAAK;IACX,IAAI,iBAAiB,WAEpB;IACD,OAAO;IAOP,IAAI,WAAW,WAEd;IAED,MAAM,CACL,QAAQ,EAAE,KAAK,CAAC,cAAc,EAC9B,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,EAC7B,aAAa,EAAE,OAAO,EACtB,QAAQ,CAAC,EAAE,MAAM;IA0DlB,OAAO;CAQP"}
1
+ {"version":3,"file":"SpatialElementRefinement.d.ts","sourceRoot":"","sources":["../../src/stage/SpatialElementRefinement.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAMtC,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;;;EAM9D;AAED,MAAM,WAAW,kBAAkB;IAClC,OAAO,IAAI,OAAO,CAAC;IACnB,OAAO,IAAI,IAAI,CAAC;CAChB;AACD,MAAM,WAAW,mBAAmB;IACnC,MAAM,IAAI,OAAO,CAAC;IAClB,MAAM,IAAI,IAAI,CAAC;CACf;AACD,MAAM,WAAW,uBAAuB;IACvC,+EAA+E;IAC/E,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC1B;AAiBD,sGAAsG;AACtG,qBAAa,wBAAwB;IAIxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,gBAAgB;gBAGa,OAAO,UAAQ;IAC5C,OAAO,CAAC,GAAG,CAAC,CAAqB;IACjC,OAAO,CAAC,IAAI,CAAC,CAAqB;IAClC,OAAO,CAAC,QAAQ,CAAC,CAAqB;IACtC,OAAO,CAAC,IAAI,CAAC,CAAiB;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAc;IACvC,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,UAAU,CAAC,CAAqB;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA8F;IACzH,qBAAqB;;;;;;;;;;IACrB,QAAQ,UAAS;IACjB,MAAM,SAAK;IACX,IAAI,iBAAiB,WAEpB;IACD,OAAO;IAQP,IAAI,WAAW,WAEd;IAED,wBAAwB;IASxB,OAAO,CAAC,aAAa;IAiBrB,OAAO,CAAC,uBAAuB;IAQ/B,OAAO,CAAC,gBAAgB;IAMxB;yFACqF;IACrF,qBAAqB,CAAC,QAAQ,EAAE,KAAK,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,KAAK,IAAI,EAAE,KAAK,EAAE,kBAAkB,GAAG,mBAAmB,GAAG,SAAS;IAmD1K,MAAM,CACL,QAAQ,EAAE,KAAK,CAAC,cAAc,EAC9B,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,EAC7B,aAAa,EAAE,OAAO,EACtB,QAAQ,CAAC,EAAE,MAAM,EACjB,OAAO,GAAE,uBAA4B;IAkCtC,OAAO;CASP"}
@@ -14,7 +14,7 @@ export function getRefinementSize(width, height) {
14
14
  export class SpatialElementRefinement {
15
15
  overlay;
16
16
  getRenderTargets() {
17
- return [this.low, this.high].filter((target) => Boolean(target));
17
+ return [this.low, this.high, ...(this.sceneCache?.zero ?? [])].filter((target) => Boolean(target));
18
18
  }
19
19
  constructor(overlay = false) {
20
20
  this.overlay = overlay;
@@ -26,12 +26,17 @@ export class SpatialElementRefinement {
26
26
  progress = uniform(0);
27
27
  lastFrame;
28
28
  linearProgress = 0;
29
+ writeEpoch = 0;
30
+ sceneCache;
31
+ cacheStats = { preparations: 0, ready: 0, hits: 0, pendingReads: 0, invalidations: 0, staleTickets: 0 };
32
+ getSceneEndpointStats() { return { ...this.cacheStats, active: Boolean(this.sceneCache?.ready), pending: Boolean(this.sceneCache && !this.sceneCache.ready) }; }
29
33
  complete = false;
30
34
  frames = 0;
31
35
  get presentedProgress() {
32
36
  return this.progress.value;
33
37
  }
34
38
  restart() {
39
+ this.invalidateSceneEndpoints();
35
40
  this.lastFrame = undefined;
36
41
  this.linearProgress = 0;
37
42
  this.progress.value = 0;
@@ -39,61 +44,194 @@ export class SpatialElementRefinement {
39
44
  this.frames = 0;
40
45
  }
41
46
  get targetCount() {
42
- return Number(Boolean(this.low)) + Number(Boolean(this.high));
47
+ return this.getRenderTargets().length;
43
48
  }
44
- render(renderer, draw, reducedMotion, progress) {
49
+ invalidateSceneEndpoints() {
50
+ const cache = this.sceneCache;
51
+ if (!cache)
52
+ return;
53
+ this.sceneCache = undefined;
54
+ this.cacheStats.invalidations++;
55
+ cache.zero.forEach(target => target.dispose());
56
+ cache.material.dispose();
57
+ cache.copyMaterial.dispose();
58
+ cache.guard.dispose();
59
+ }
60
+ ensureTargets(renderer) {
45
61
  const destination = renderer.getRenderTarget();
46
62
  if (!destination && !this.overlay)
47
63
  throw new Error('SpatialElement refinement requires an owned scene capture');
48
64
  const size = destination ?? renderer.getDrawingBufferSize(new THREE.Vector2());
49
- const targetWidth = size.width;
50
- const targetHeight = size.height;
51
65
  if (!this.low || !this.high) {
52
- this.low =
53
- destination?.clone() ??
54
- new THREE.RenderTarget(targetWidth, targetHeight, {
55
- type: THREE.HalfFloatType,
56
- samples: 4
57
- });
66
+ this.low = destination?.clone() ?? new THREE.RenderTarget(size.width, size.height, { type: THREE.HalfFloatType, samples: 4 });
58
67
  this.high = this.low.clone();
59
- this.material = new THREE.NodeMaterial();
60
- this.material.fragmentNode = mix(texture(this.low.texture), texture(this.high.texture), this.progress);
61
- this.material.depthTest = false;
62
- this.material.depthWrite = false;
63
- this.material.blending = this.overlay ? THREE.NormalBlending : THREE.NoBlending;
64
- this.material.transparent = this.overlay;
65
- this.material.premultipliedAlpha = this.overlay;
66
- this.material.toneMapped = false;
68
+ this.material = this.createCompositeMaterial(mix(texture(this.low.texture), texture(this.high.texture), this.progress));
67
69
  this.quad = new THREE.QuadMesh(this.material);
68
70
  }
69
- const { width, height } = getRefinementSize(targetWidth, targetHeight);
70
- this.low.setSize(width, height);
71
- this.high.setSize(width, height);
71
+ const { width, height } = getRefinementSize(size.width, size.height);
72
+ if (this.low.width !== width || this.low.height !== height || this.high.width !== width || this.high.height !== height) {
73
+ this.invalidateSceneEndpoints();
74
+ this.writeEpoch++;
75
+ this.low.setSize(width, height);
76
+ this.high.setSize(width, height);
77
+ }
78
+ return destination;
79
+ }
80
+ createCompositeMaterial(fragment) {
81
+ const material = new THREE.NodeMaterial();
82
+ material.fragmentNode = fragment;
83
+ material.depthTest = material.depthWrite = false;
84
+ material.blending = this.overlay ? THREE.NormalBlending : THREE.NoBlending;
85
+ material.transparent = material.premultipliedAlpha = this.overlay;
86
+ material.toneMapped = false;
87
+ return material;
88
+ }
89
+ endpointsCurrent(cache) {
90
+ return cache.epoch === this.writeEpoch && cache.destination.width === cache.destinationWidth && cache.destination.height === cache.destinationHeight &&
91
+ this.low?.width === cache.zero[0].width && this.low?.height === cache.zero[0].height &&
92
+ this.high?.width === cache.zero[1].width && this.high?.height === cache.zero[1].height && cache.guard.isValid();
93
+ }
94
+ /** Call only after all warm live passes. Taking endpoints never advances the refinement clock.
95
+ * The caller fences these submissions and explicitly commits the returned ticket. */
96
+ prepareSceneEndpoints(renderer, draw, guard) {
97
+ this.invalidateSceneEndpoints();
98
+ let destination = renderer.getRenderTarget();
99
+ try {
100
+ destination = this.ensureTargets(renderer);
101
+ }
102
+ catch (error) {
103
+ guard.dispose();
104
+ throw error;
105
+ }
106
+ if (!destination || this.low.texture.type !== THREE.HalfFloatType || !guard.isValid()) {
107
+ guard.dispose();
108
+ return;
109
+ }
110
+ const zero = [0, 1].map(() => {
111
+ const target = new THREE.RenderTarget(this.low.width, this.low.height, { type: THREE.HalfFloatType, samples: 0, depthBuffer: false, stencilBuffer: false });
112
+ target.texture.colorSpace = THREE.NoColorSpace;
113
+ target.texture.generateMipmaps = false;
114
+ return target;
115
+ });
116
+ const background = uniform(0), refinement = uniform(0);
117
+ const material = this.createCompositeMaterial(mix(mix(texture(zero[0].texture), texture(this.low.texture), background), mix(texture(zero[1].texture), texture(this.high.texture), background), refinement));
118
+ const source = texture(this.low.texture);
119
+ const copyMaterial = new THREE.NodeMaterial();
120
+ copyMaterial.fragmentNode = source;
121
+ copyMaterial.depthTest = copyMaterial.depthWrite = false;
122
+ copyMaterial.blending = THREE.NoBlending;
123
+ copyMaterial.toneMapped = false;
124
+ const cache = { destination, destinationWidth: destination.width, destinationHeight: destination.height,
125
+ zero, background, refinement, material, quad: new THREE.QuadMesh(material), copyMaterial, copy: new THREE.QuadMesh(copyMaterial), guard, epoch: ++this.writeEpoch, ready: false };
126
+ this.sceneCache = cache;
127
+ try {
128
+ for (const p of [0, 1])
129
+ for (const high of [true, false]) {
130
+ const target = high ? this.high : this.low;
131
+ renderer.setRenderTarget(target);
132
+ draw(high, p);
133
+ if (p === 0) {
134
+ source.value = target.texture;
135
+ renderer.setRenderTarget(zero[high ? 1 : 0]);
136
+ cache.copy.render(renderer);
137
+ }
138
+ }
139
+ // Warm the exact overlay pipeline without touching the actual q uniform/clock.
140
+ renderer.setRenderTarget(destination);
141
+ background.value = 0.5;
142
+ refinement.value = this.progress.value;
143
+ // Offscreen rendering reads RenderTarget.scissor, not the Canvas scissor.
144
+ // Preserve the real presentation seed: even a hidden overlay can change it for transmission.
145
+ const scissor = destination.scissor.clone(), scissorTest = renderer.getScissorTest(), autoClear = renderer.autoClear;
146
+ try {
147
+ destination.scissor.set(0, 0, 0, 0);
148
+ renderer.setScissorTest(true);
149
+ renderer.autoClear = false;
150
+ cache.quad.render(renderer);
151
+ }
152
+ finally {
153
+ destination.scissor.copy(scissor);
154
+ renderer.setScissorTest(scissorTest);
155
+ renderer.autoClear = autoClear;
156
+ }
157
+ this.cacheStats.preparations++;
158
+ }
159
+ catch (error) {
160
+ this.invalidateSceneEndpoints();
161
+ throw error;
162
+ }
163
+ finally {
164
+ renderer.setRenderTarget(destination);
165
+ }
166
+ return {
167
+ commit: () => {
168
+ if (this.sceneCache !== cache || !this.endpointsCurrent(cache)) {
169
+ this.cacheStats.staleTickets++;
170
+ if (this.sceneCache === cache)
171
+ this.invalidateSceneEndpoints();
172
+ return false;
173
+ }
174
+ if (!cache.ready) {
175
+ cache.ready = true;
176
+ this.cacheStats.ready++;
177
+ }
178
+ return true;
179
+ },
180
+ cancel: () => { if (this.sceneCache === cache)
181
+ this.invalidateSceneEndpoints(); }
182
+ };
183
+ }
184
+ render(renderer, draw, reducedMotion, progress, options = {}) {
185
+ const destination = this.ensureTargets(renderer);
186
+ let cache = this.sceneCache;
187
+ if (cache && (cache.destination !== destination || !this.endpointsCurrent(cache) || !Number.isFinite(options.backgroundReveal) || (!cache.ready && options.advanceClock !== false))) {
188
+ this.invalidateSceneEndpoints();
189
+ cache = undefined;
190
+ }
72
191
  try {
73
- // High first: its first actual render must succeed before it becomes visible.
74
- renderer.setRenderTarget(this.high);
75
- draw(true);
76
- renderer.setRenderTarget(this.low);
77
- draw(false);
78
- const now = performance.now();
79
- if (this.lastFrame !== undefined)
80
- this.linearProgress = Math.min(1, this.linearProgress + Math.min(50, now - this.lastFrame) / ASYNC_REVEAL_DURATION);
81
- this.progress.value = progress ?? easeInOutSine(this.linearProgress);
82
- this.lastFrame = now;
83
- if (reducedMotion)
84
- this.progress.value = 1;
192
+ if (!cache) {
193
+ this.writeEpoch++;
194
+ // Every live write invalidates a fence ticket, even when its scene generation did not change.
195
+ renderer.setRenderTarget(this.high);
196
+ draw(true);
197
+ renderer.setRenderTarget(this.low);
198
+ draw(false);
199
+ }
200
+ if (options.advanceClock !== false) {
201
+ const now = performance.now();
202
+ if (this.lastFrame !== undefined)
203
+ this.linearProgress = Math.min(1, this.linearProgress + Math.min(50, now - this.lastFrame) / ASYNC_REVEAL_DURATION);
204
+ this.progress.value = progress ?? easeInOutSine(this.linearProgress);
205
+ this.lastFrame = now;
206
+ if (reducedMotion)
207
+ this.progress.value = 1;
208
+ }
85
209
  renderer.setRenderTarget(destination);
86
210
  if (!this.overlay)
87
211
  renderer.clear();
88
- this.quad.render(renderer);
89
- this.frames += 1;
90
- this.complete = this.progress.value === 1;
212
+ if (cache) {
213
+ cache.background.value = Math.max(0, Math.min(1, options.backgroundReveal));
214
+ cache.refinement.value = this.progress.value;
215
+ cache.quad.render(renderer);
216
+ if (cache.ready)
217
+ this.cacheStats.hits++;
218
+ else
219
+ this.cacheStats.pendingReads++;
220
+ }
221
+ else
222
+ this.quad.render(renderer);
223
+ if (options.advanceClock !== false) {
224
+ this.frames += 1;
225
+ this.complete = this.progress.value === 1;
226
+ }
91
227
  }
92
228
  finally {
93
229
  renderer.setRenderTarget(destination);
94
230
  }
95
231
  }
96
232
  dispose() {
233
+ this.invalidateSceneEndpoints();
234
+ this.writeEpoch++;
97
235
  this.low?.dispose();
98
236
  this.high?.dispose();
99
237
  this.material?.dispose();
@@ -1 +1 @@
1
- {"version":3,"file":"SpatialElementRefinement.js","sourceRoot":"","sources":["../../src/stage/SpatialElementRefinement.ts"],"names":[],"mappings":"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","sourcesContent":["import * as THREE from 'three/webgpu';\nimport { mix, texture, uniform } from 'three/tsl';\nimport { easeInOutSine, ASYNC_REVEAL_DURATION } from '../catalog/transitionTiming.js';\n\n// Bound temporary attachments independently of viewport size and device pixel ratio.\nconst MAX_REFINEMENT_PIXELS = 512 * 1024;\nexport function getRefinementSize(width: number, height: number) {\n\tconst scale = Math.min(1, Math.sqrt(MAX_REFINEMENT_PIXELS / (width * height)));\n\treturn {\n\t\twidth: Math.max(1, Math.floor(width * scale)),\n\t\theight: Math.max(1, Math.floor(height * scale))\n\t};\n}\n\n/** Separate scene captures preserve authored alpha without sorting two translucent element meshes. */\nexport class SpatialElementRefinement {\n\tgetRenderTargets() {\n\t\treturn [this.low, this.high].filter((target): target is THREE.RenderTarget => Boolean(target));\n\t}\n\tconstructor(private readonly overlay = false) {}\n\tprivate low?: THREE.RenderTarget;\n\tprivate high?: THREE.RenderTarget;\n\tprivate material?: THREE.NodeMaterial;\n\tprivate quad?: THREE.QuadMesh;\n\tprivate readonly progress = uniform(0);\n\tprivate lastFrame?: number;\n\tprivate linearProgress = 0;\n\tcomplete = false;\n\tframes = 0;\n\tget presentedProgress() {\n\t\treturn this.progress.value;\n\t}\n\trestart() {\n\t\tthis.lastFrame = undefined;\n\t\tthis.linearProgress = 0;\n\t\tthis.progress.value = 0;\n\t\tthis.complete = false;\n\t\tthis.frames = 0;\n\t}\n\tget targetCount() {\n\t\treturn Number(Boolean(this.low)) + Number(Boolean(this.high));\n\t}\n\n\trender(\n\t\trenderer: THREE.WebGPURenderer,\n\t\tdraw: (high: boolean) => void,\n\t\treducedMotion: boolean,\n\t\tprogress?: number\n\t) {\n\t\tconst destination = renderer.getRenderTarget();\n\t\tif (!destination && !this.overlay)\n\t\t\tthrow new Error('SpatialElement refinement requires an owned scene capture');\n\t\tconst size = destination ?? renderer.getDrawingBufferSize(new THREE.Vector2());\n\t\tconst targetWidth = size.width;\n\t\tconst targetHeight = size.height;\n\t\tif (!this.low || !this.high) {\n\t\t\tthis.low =\n\t\t\t\tdestination?.clone() ??\n\t\t\t\tnew THREE.RenderTarget(targetWidth, targetHeight, {\n\t\t\t\t\ttype: THREE.HalfFloatType,\n\t\t\t\t\tsamples: 4\n\t\t\t\t});\n\t\t\tthis.high = this.low.clone();\n\t\t\tthis.material = new THREE.NodeMaterial();\n\t\t\tthis.material.fragmentNode = mix(\n\t\t\t\ttexture(this.low.texture),\n\t\t\t\ttexture(this.high.texture),\n\t\t\t\tthis.progress\n\t\t\t);\n\t\t\tthis.material.depthTest = false;\n\t\t\tthis.material.depthWrite = false;\n\t\t\tthis.material.blending = this.overlay ? THREE.NormalBlending : THREE.NoBlending;\n\t\t\tthis.material.transparent = this.overlay;\n\t\t\tthis.material.premultipliedAlpha = this.overlay;\n\t\t\tthis.material.toneMapped = false;\n\t\t\tthis.quad = new THREE.QuadMesh(this.material);\n\t\t}\n\t\tconst { width, height } = getRefinementSize(targetWidth, targetHeight);\n\t\tthis.low.setSize(width, height);\n\t\tthis.high.setSize(width, height);\n\t\ttry {\n\t\t\t// High first: its first actual render must succeed before it becomes visible.\n\t\t\trenderer.setRenderTarget(this.high);\n\t\t\tdraw(true);\n\t\t\trenderer.setRenderTarget(this.low);\n\t\t\tdraw(false);\n\t\t\tconst now = performance.now();\n\t\t\tif (this.lastFrame !== undefined)\n\t\t\t\tthis.linearProgress = Math.min(\n\t\t\t\t\t1,\n\t\t\t\t\tthis.linearProgress + Math.min(50, now - this.lastFrame) / ASYNC_REVEAL_DURATION\n\t\t\t\t);\n\t\t\tthis.progress.value = progress ?? easeInOutSine(this.linearProgress);\n\t\t\tthis.lastFrame = now;\n\t\t\tif (reducedMotion) this.progress.value = 1;\n\t\t\trenderer.setRenderTarget(destination);\n\t\t\tif (!this.overlay) renderer.clear();\n\t\t\tthis.quad!.render(renderer);\n\t\t\tthis.frames += 1;\n\t\t\tthis.complete = this.progress.value === 1;\n\t\t} finally {\n\t\t\trenderer.setRenderTarget(destination);\n\t\t}\n\t}\n\n\tdispose() {\n\t\tthis.low?.dispose();\n\t\tthis.high?.dispose();\n\t\tthis.material?.dispose();\n\t\tthis.low = this.high = undefined;\n\t\tthis.material = undefined;\n\t\tthis.quad = undefined;\n\t}\n}\n"]}
1
+ {"version":3,"file":"SpatialElementRefinement.js","sourceRoot":"","sources":["../../src/stage/SpatialElementRefinement.ts"],"names":[],"mappings":"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","sourcesContent":["import * as THREE from 'three/webgpu';\nimport { mix, texture, uniform } from 'three/tsl';\nimport { easeInOutSine, ASYNC_REVEAL_DURATION } from '../catalog/transitionTiming.js';\n\n// Bound temporary attachments independently of viewport size and device pixel ratio.\nconst MAX_REFINEMENT_PIXELS = 512 * 1024;\nexport function getRefinementSize(width: number, height: number) {\n\tconst scale = Math.min(1, Math.sqrt(MAX_REFINEMENT_PIXELS / (width * height)));\n\treturn {\n\t\twidth: Math.max(1, Math.floor(width * scale)),\n\t\theight: Math.max(1, Math.floor(height * scale))\n\t};\n}\n\nexport interface SceneEndpointGuard {\n\tisValid(): boolean;\n\tdispose(): void;\n}\nexport interface SceneEndpointTicket {\n\tcommit(): boolean;\n\tcancel(): void;\n}\nexport interface RefinementRenderOptions {\n\t/** Hidden preparation/its intervening RAFs borrow pixels without ticking q. */\n\tadvanceClock?: boolean;\n\tbackgroundReveal?: number;\n}\ninterface SceneEndpointCache {\n\tdestination: THREE.RenderTarget;\n\tdestinationWidth: number;\n\tdestinationHeight: number;\n\tzero: [THREE.RenderTarget, THREE.RenderTarget];\n\tmaterial: THREE.NodeMaterial;\n\tquad: THREE.QuadMesh;\n\tcopyMaterial: THREE.NodeMaterial;\n\tcopy: THREE.QuadMesh;\n\tbackground: { value: number };\n\trefinement: { value: number };\n\tguard: SceneEndpointGuard;\n\tepoch: number;\n\tready: boolean;\n}\n\n/** Separate scene captures preserve authored alpha without sorting two translucent element meshes. */\nexport class SpatialElementRefinement {\n\tgetRenderTargets() {\n\t\treturn [this.low, this.high, ...(this.sceneCache?.zero ?? [])].filter((target): target is THREE.RenderTarget => Boolean(target));\n\t}\n\tconstructor(private readonly overlay = false) {}\n\tprivate low?: THREE.RenderTarget;\n\tprivate high?: THREE.RenderTarget;\n\tprivate material?: THREE.NodeMaterial;\n\tprivate quad?: THREE.QuadMesh;\n\tprivate readonly progress = uniform(0);\n\tprivate lastFrame?: number;\n\tprivate linearProgress = 0;\n\tprivate writeEpoch = 0;\n\tprivate sceneCache?: SceneEndpointCache;\n\tprivate readonly cacheStats = { preparations: 0, ready: 0, hits: 0, pendingReads: 0, invalidations: 0, staleTickets: 0 };\n\tgetSceneEndpointStats() { return { ...this.cacheStats, active: Boolean(this.sceneCache?.ready), pending: Boolean(this.sceneCache && !this.sceneCache.ready) }; }\n\tcomplete = false;\n\tframes = 0;\n\tget presentedProgress() {\n\t\treturn this.progress.value;\n\t}\n\trestart() {\n\t\tthis.invalidateSceneEndpoints();\n\t\tthis.lastFrame = undefined;\n\t\tthis.linearProgress = 0;\n\t\tthis.progress.value = 0;\n\t\tthis.complete = false;\n\t\tthis.frames = 0;\n\t}\n\tget targetCount() {\n\t\treturn this.getRenderTargets().length;\n\t}\n\n\tinvalidateSceneEndpoints() {\n\t\tconst cache = this.sceneCache;\n\t\tif (!cache) return;\n\t\tthis.sceneCache = undefined;\n\t\tthis.cacheStats.invalidations++;\n\t\tcache.zero.forEach(target => target.dispose());\n\t\tcache.material.dispose(); cache.copyMaterial.dispose(); cache.guard.dispose();\n\t}\n\n\tprivate ensureTargets(renderer: THREE.WebGPURenderer) {\n\t\tconst destination = renderer.getRenderTarget();\n\t\tif (!destination && !this.overlay) throw new Error('SpatialElement refinement requires an owned scene capture');\n\t\tconst size = destination ?? renderer.getDrawingBufferSize(new THREE.Vector2());\n\t\tif (!this.low || !this.high) {\n\t\t\tthis.low = destination?.clone() ?? new THREE.RenderTarget(size.width, size.height, { type: THREE.HalfFloatType, samples: 4 });\n\t\t\tthis.high = this.low.clone();\n\t\t\tthis.material = this.createCompositeMaterial(mix(texture(this.low.texture), texture(this.high.texture), this.progress));\n\t\t\tthis.quad = new THREE.QuadMesh(this.material);\n\t\t}\n\t\tconst { width, height } = getRefinementSize(size.width, size.height);\n\t\tif (this.low.width !== width || this.low.height !== height || this.high.width !== width || this.high.height !== height) {\n\t\t\tthis.invalidateSceneEndpoints(); this.writeEpoch++;\n\t\t\tthis.low.setSize(width, height); this.high.setSize(width, height);\n\t\t}\n\t\treturn destination;\n\t}\n\tprivate createCompositeMaterial(fragment: THREE.NodeMaterial['fragmentNode']) {\n\t\tconst material = new THREE.NodeMaterial(); material.fragmentNode = fragment;\n\t\tmaterial.depthTest = material.depthWrite = false;\n\t\tmaterial.blending = this.overlay ? THREE.NormalBlending : THREE.NoBlending;\n\t\tmaterial.transparent = material.premultipliedAlpha = this.overlay;\n\t\tmaterial.toneMapped = false;\n\t\treturn material;\n\t}\n\tprivate endpointsCurrent(cache: SceneEndpointCache) {\n\t\treturn cache.epoch === this.writeEpoch && cache.destination.width === cache.destinationWidth && cache.destination.height === cache.destinationHeight &&\n\t\t\tthis.low?.width === cache.zero[0].width && this.low?.height === cache.zero[0].height &&\n\t\t\tthis.high?.width === cache.zero[1].width && this.high?.height === cache.zero[1].height && cache.guard.isValid();\n\t}\n\n\t/** Call only after all warm live passes. Taking endpoints never advances the refinement clock.\n\t * The caller fences these submissions and explicitly commits the returned ticket. */\n\tprepareSceneEndpoints(renderer: THREE.WebGPURenderer, draw: (high: boolean, backgroundReveal: number) => void, guard: SceneEndpointGuard): SceneEndpointTicket | undefined {\n\t\tthis.invalidateSceneEndpoints();\n\t\tlet destination: THREE.RenderTarget | null = renderer.getRenderTarget();\n\t\ttry { destination = this.ensureTargets(renderer); }\n\t\tcatch (error) { guard.dispose(); throw error; }\n\t\tif (!destination || this.low!.texture.type !== THREE.HalfFloatType || !guard.isValid()) { guard.dispose(); return; }\n\t\tconst zero = [0, 1].map(() => {\n\t\t\tconst target = new THREE.RenderTarget(this.low!.width, this.low!.height, { type: THREE.HalfFloatType, samples: 0, depthBuffer: false, stencilBuffer: false });\n\t\t\ttarget.texture.colorSpace = THREE.NoColorSpace; target.texture.generateMipmaps = false;\n\t\t\treturn target;\n\t\t}) as [THREE.RenderTarget, THREE.RenderTarget];\n\t\tconst background = uniform(0), refinement = uniform(0);\n\t\tconst material = this.createCompositeMaterial(mix(mix(texture(zero[0].texture), texture(this.low!.texture), background), mix(texture(zero[1].texture), texture(this.high!.texture), background), refinement));\n\t\tconst source = texture(this.low!.texture);\n\t\tconst copyMaterial = new THREE.NodeMaterial(); copyMaterial.fragmentNode = source;\n\t\tcopyMaterial.depthTest = copyMaterial.depthWrite = false; copyMaterial.blending = THREE.NoBlending; copyMaterial.toneMapped = false;\n\t\tconst cache: SceneEndpointCache = { destination, destinationWidth: destination.width, destinationHeight: destination.height,\n\t\t\tzero, background, refinement, material, quad: new THREE.QuadMesh(material), copyMaterial, copy: new THREE.QuadMesh(copyMaterial), guard, epoch: ++this.writeEpoch, ready: false };\n\t\tthis.sceneCache = cache;\n\t\ttry {\n\t\t\tfor (const p of [0, 1]) for (const high of [true, false]) {\n\t\t\t\tconst target = high ? this.high! : this.low!;\n\t\t\t\trenderer.setRenderTarget(target); draw(high, p);\n\t\t\t\tif (p === 0) { source.value = target.texture; renderer.setRenderTarget(zero[high ? 1 : 0]); cache.copy.render(renderer); }\n\t\t\t}\n\t\t\t// Warm the exact overlay pipeline without touching the actual q uniform/clock.\n\t\t\trenderer.setRenderTarget(destination); background.value = 0.5; refinement.value = this.progress.value;\n\t\t\t// Offscreen rendering reads RenderTarget.scissor, not the Canvas scissor.\n\t\t\t// Preserve the real presentation seed: even a hidden overlay can change it for transmission.\n\t\t\tconst scissor = destination.scissor.clone(), scissorTest = renderer.getScissorTest(), autoClear = renderer.autoClear;\n\t\t\ttry {\n\t\t\t\tdestination.scissor.set(0, 0, 0, 0); renderer.setScissorTest(true); renderer.autoClear = false;\n\t\t\t\tcache.quad.render(renderer);\n\t\t\t} finally { destination.scissor.copy(scissor); renderer.setScissorTest(scissorTest); renderer.autoClear = autoClear; }\n\t\t\tthis.cacheStats.preparations++;\n\t\t} catch (error) { this.invalidateSceneEndpoints(); throw error; }\n\t\tfinally { renderer.setRenderTarget(destination); }\n\t\treturn {\n\t\t\tcommit: () => {\n\t\t\t\tif (this.sceneCache !== cache || !this.endpointsCurrent(cache)) {\n\t\t\t\t\tthis.cacheStats.staleTickets++;\n\t\t\t\t\tif (this.sceneCache === cache) this.invalidateSceneEndpoints();\n\t\t\t\t\treturn false;\n\t\t\t\t}\n\t\t\t\tif (!cache.ready) { cache.ready = true; this.cacheStats.ready++; }\n\t\t\t\treturn true;\n\t\t\t},\n\t\t\tcancel: () => { if (this.sceneCache === cache) this.invalidateSceneEndpoints(); }\n\t\t};\n\t}\n\n\trender(\n\t\trenderer: THREE.WebGPURenderer,\n\t\tdraw: (high: boolean) => void,\n\t\treducedMotion: boolean,\n\t\tprogress?: number,\n\t\toptions: RefinementRenderOptions = {}\n\t) {\n\t\tconst destination = this.ensureTargets(renderer);\n\t\tlet cache = this.sceneCache;\n\t\tif (cache && (cache.destination !== destination || !this.endpointsCurrent(cache) || !Number.isFinite(options.backgroundReveal) || (!cache.ready && options.advanceClock !== false))) {\n\t\t\tthis.invalidateSceneEndpoints(); cache = undefined;\n\t\t}\n\t\ttry {\n\t\t\tif (!cache) {\n\t\t\t\tthis.writeEpoch++;\n\t\t\t\t// Every live write invalidates a fence ticket, even when its scene generation did not change.\n\t\t\t\trenderer.setRenderTarget(this.high!); draw(true);\n\t\t\t\trenderer.setRenderTarget(this.low!); draw(false);\n\t\t\t}\n\t\t\tif (options.advanceClock !== false) {\n\t\t\t\tconst now = performance.now();\n\t\t\t\tif (this.lastFrame !== undefined) this.linearProgress = Math.min(1, this.linearProgress + Math.min(50, now - this.lastFrame) / ASYNC_REVEAL_DURATION);\n\t\t\t\tthis.progress.value = progress ?? easeInOutSine(this.linearProgress);\n\t\t\t\tthis.lastFrame = now;\n\t\t\t\tif (reducedMotion) this.progress.value = 1;\n\t\t\t}\n\t\t\trenderer.setRenderTarget(destination);\n\t\t\tif (!this.overlay) renderer.clear();\n\t\t\tif (cache) {\n\t\t\t\tcache.background.value = Math.max(0, Math.min(1, options.backgroundReveal!)); cache.refinement.value = this.progress.value;\n\t\t\t\tcache.quad.render(renderer);\n\t\t\t\tif (cache.ready) this.cacheStats.hits++; else this.cacheStats.pendingReads++;\n\t\t\t} else this.quad!.render(renderer);\n\t\t\tif (options.advanceClock !== false) { this.frames += 1; this.complete = this.progress.value === 1; }\n\t\t} finally {\n\t\t\trenderer.setRenderTarget(destination);\n\t\t}\n\t}\n\n\tdispose() {\n\t\tthis.invalidateSceneEndpoints(); this.writeEpoch++;\n\t\tthis.low?.dispose();\n\t\tthis.high?.dispose();\n\t\tthis.material?.dispose();\n\t\tthis.low = this.high = undefined;\n\t\tthis.material = undefined;\n\t\tthis.quad = undefined;\n\t}\n}\n"]}
@@ -8,6 +8,9 @@ import { type CatalogTransitionPresentation } from '../catalog/catalogPresentati
8
8
  import type { SpatialListItem } from '../spatial-element/types.js';
9
9
  import type { SpatialElementScene } from '../spatial-element/spatialElementScene.js';
10
10
  import { type CssProjectionQuad } from './minimap/MinimapProjection.js';
11
+ import type { LayoutRect } from '../spatial-element/responsiveLayout.js';
12
+ import type { StagedDockTargetOptions } from '../catalog/stagedDockGeometry.js';
13
+ import type { SpatialElementMediaItem } from '../spatial-element/types.js';
11
14
  import type { BackgroundSettings, StageExperienceOptions, StageInteractionTheme, StagePanelTarget, StageVisualTestView } from './stageTypes.js';
12
15
  export type { BackgroundSettings, StageCameraSettings, StageExperienceOptions, StageInteractionTheme, StageMinimapOptions, StageModelSettings, StagePanelSurface, StagePanelTarget, StageRenderSettings, StageVisualTestView, StageViewportTarget, StageZoomFocusState } from './stageTypes.js';
13
16
  /** Shared spatial state for both WebGPU glass and DOM-backed panel surfaces. */
@@ -52,7 +55,25 @@ export declare class StageExperience {
52
55
  private catalogLayer?;
53
56
  private catalogHandoff;
54
57
  private catalogMotionComplete;
58
+ private stagedDetailTarget?;
59
+ private stagedAwaitingFirstFrame;
60
+ private stagedSceneCacheOwner?;
61
+ private stagedRevealPreparing?;
62
+ private releaseStagedSensorHold?;
63
+ /** Use only already submitted source resources during the pre-route movement. */
64
+ beginStagedDetailMotion(source: CatalogGeometryEndpoint, fit: LayoutRect, targetOptions?: StagedDockTargetOptions): boolean;
65
+ setStagedDetailProgress(progress: number): void;
66
+ setStagedDetailPanel(card: HTMLElement, corners: CssProjectionQuad, width: number, height: number): boolean;
67
+ setStagedPanelOpacity(opacity: number): void;
68
+ /** Called only after the final moving frame: route teardown may now replace its source. */
69
+ holdStagedDetail(spatialElementId: string, kind?: 'hero' | 'dock'): boolean;
70
+ private deferredZoomPreparation;
71
+ private deferredScrollWarmup?;
72
+ private zoomPreparationFrame;
55
73
  private catalogLayerAnimating;
74
+ private stagedPreparationIdle;
75
+ private stagedPreparationFallback;
76
+ private readonly stagedPreparationAbort;
56
77
  private catalogPresentation;
57
78
  private pageModelReady;
58
79
  private readonly preparationGate;
@@ -146,6 +167,12 @@ export declare class StageExperience {
146
167
  private panelMeasurementsDirty;
147
168
  private viewportMeasurementDirty;
148
169
  private stageViewportVisible;
170
+ private readonly readLayoutMetrics?;
171
+ private detailMedia;
172
+ private get detailMediaActive();
173
+ /** Changing media keeps the model/cache/camera but stops its interaction and sensor clock. */
174
+ setDetailMedia(media: SpatialElementMediaItem['kind']): void;
175
+ private readDetailInteractionLayout;
149
176
  private fullscreen;
150
177
  setFullscreen(fullscreen: boolean): void;
151
178
  private get visiblePanelCount();
@@ -201,7 +228,15 @@ export declare class StageExperience {
201
228
  }): void;
202
229
  updatePage(options: StageExperienceOptions): Promise<void>;
203
230
  setCatalogSpatialElements(brandId: string, items: SpatialListItem[]): Promise<void>;
231
+ /** Finish required DETAIL GPU preparation before its first visible reveal frame.
232
+ * Binding happens with enterOpacity=0, which intentionally skips minimaps and
233
+ * panel blur passes. Borrow fractional/end-point alpha to prepare both real
234
+ * material owners, restore all presentation state synchronously, then fence.
235
+ */
236
+ prepareStagedReveal(signal?: AbortSignal): Promise<boolean>;
204
237
  setCatalogTransitionPresentation(state: CatalogTransitionPresentation): void;
238
+ private scheduleZoomPreparation;
239
+ private scheduleStagedPreparation;
205
240
  /** Reports actual applied GPU alpha for browser verification without layout or style reads. */
206
241
  getCatalogPresentation(): {
207
242
  mode: TransitionMode | null;
@@ -220,8 +255,8 @@ export declare class StageExperience {
220
255
  disposed: boolean;
221
256
  }[];
222
257
  preparation: {
223
- background: "loading" | "ready" | "failed";
224
- high: "unavailable" | "loading" | "ready" | "failed" | "adopted";
258
+ background: "ready" | "loading" | "failed";
259
+ high: "unavailable" | "ready" | "loading" | "failed" | "adopted";
225
260
  timings: {
226
261
  buildMs: number;
227
262
  gpuWarmMs: number;
@@ -243,6 +278,16 @@ export declare class StageExperience {
243
278
  y: number;
244
279
  } | null;
245
280
  representations: {
281
+ sceneEndpointCache: {
282
+ active: boolean;
283
+ pending: boolean;
284
+ preparations: number;
285
+ ready: number;
286
+ hits: number;
287
+ pendingReads: number;
288
+ invalidations: number;
289
+ staleTickets: number;
290
+ }[];
246
291
  retainedBlendTargets: number;
247
292
  state: "unavailable" | "high" | "loading" | "failed" | "decoded" | "refining";
248
293
  hero: string | null;
@@ -291,7 +336,7 @@ export declare class StageExperience {
291
336
  y: number;
292
337
  } | null;
293
338
  /** Lease the last submitted element frame before another page binding can release it. */
294
- adoptCatalogPresentation(destination: CatalogGeometryDestination): boolean;
339
+ adoptCatalogPresentation(destination: CatalogGeometryDestination, restoreSourceOnCancel?: boolean): boolean;
295
340
  /** Transfer already prepared hero resources before releasePage/cancelHighRequest can dispose them. */
296
341
  captureHeroPresentation(): boolean;
297
342
  getSpatialCapture(): {
@@ -323,7 +368,7 @@ export declare class StageExperience {
323
368
  disposed: boolean;
324
369
  } | null;
325
370
  private captureReturnGeometry;
326
- getDockProjection(): {
371
+ getDockProjection(allowViewportClipping?: boolean): {
327
372
  environmentIntensity: number;
328
373
  viewportClip?: {
329
374
  left: number;
@@ -381,6 +426,8 @@ export declare class StageExperience {
381
426
  width: number;
382
427
  height: number;
383
428
  } | null;
429
+ /** Returns the bound renderer's projection for query-gated handoff regressions. */
430
+ getVisualTestDetailProjection(kind: 'hero' | 'dock'): THREE.Matrix4Tuple | null;
384
431
  /** Returns the main element's projected bounds for query-gated layout regressions. */
385
432
  getVisualTestModelRect(): {
386
433
  x: number;
@@ -428,6 +475,14 @@ export declare class StageExperience {
428
475
  detachedInstances: number;
429
476
  visible: number;
430
477
  passes: number;
478
+ stagedPreparation: {
479
+ preparing: boolean;
480
+ readyActors: number;
481
+ revision: number;
482
+ warmups: number;
483
+ failures: number;
484
+ sourceFrozen: boolean;
485
+ };
431
486
  glass: {
432
487
  panels: number;
433
488
  targets: number;
@@ -436,6 +491,10 @@ export declare class StageExperience {
436
491
  };
437
492
  ground: {
438
493
  silhouettes: number;
494
+ cacheDraws: number;
495
+ liveDraws: number;
496
+ cachePreparations: number;
497
+ cachedSilhouettes: number;
439
498
  };
440
499
  depthBlur: {
441
500
  passes: number;
@@ -450,6 +509,7 @@ export declare class StageExperience {
450
509
  };
451
510
  actors: {
452
511
  spatialElementId: string;
512
+ stagedReady: boolean;
453
513
  projectedCenter: THREE.Vector3Tuple;
454
514
  band: "front" | "rear" | undefined;
455
515
  clip: {
@@ -476,6 +536,81 @@ export declare class StageExperience {
476
536
  };
477
537
  }[];
478
538
  } | null;
539
+ /** Query-gated snapshot: no new frame state, DOM measurements, scheduling or settling. */
540
+ getVisualTestRenderActivity(): {
541
+ at: number;
542
+ lastFrameAt: number;
543
+ animationActive: boolean;
544
+ catalogAnimating: boolean;
545
+ renderInvalidated: boolean;
546
+ pendingRenderFrame: boolean;
547
+ pendingScrollFrame: boolean;
548
+ scrollActive: boolean;
549
+ stagedAwaitingFirstFrame: boolean;
550
+ transitionActive: boolean;
551
+ preparation: {
552
+ stagedIdlePending: boolean;
553
+ zoomFramePending: boolean;
554
+ zoomDeferred: boolean;
555
+ gate: {
556
+ paused: boolean;
557
+ waiting: number;
558
+ };
559
+ detailGate: {
560
+ paused: boolean;
561
+ waiting: number;
562
+ };
563
+ background: "ready" | "loading" | "failed" | null;
564
+ high: "unavailable" | "ready" | "loading" | "failed" | "adopted" | null;
565
+ assetLoads: number;
566
+ activeInstances: number;
567
+ };
568
+ catalog: {
569
+ camera: {
570
+ pivotReady: boolean;
571
+ pivotSettling: boolean;
572
+ neutral: boolean;
573
+ pivot: THREE.Vector3Tuple;
574
+ angles: THREE.Vector3Tuple;
575
+ };
576
+ pointer: {
577
+ x: number;
578
+ y: number;
579
+ active: boolean;
580
+ pressed: boolean;
581
+ };
582
+ layoutDirty: boolean;
583
+ queueDirty: boolean;
584
+ loadingActors: number;
585
+ preparing: boolean;
586
+ warmups: number;
587
+ selected: string | null;
588
+ actors: {
589
+ spatialElementId: string;
590
+ visible: boolean;
591
+ hover: number;
592
+ rotationX: number;
593
+ rotationY: number;
594
+ lift: number;
595
+ deviceYaw: number;
596
+ devicePitch: number;
597
+ deviceRoll: number;
598
+ materialReady: boolean;
599
+ }[];
600
+ } | null;
601
+ panels: {
602
+ index: number;
603
+ frameId: string;
604
+ visible: boolean;
605
+ pointerLift: number;
606
+ rotation: number[];
607
+ position: THREE.Vector3Tuple;
608
+ scale: THREE.Vector3Tuple;
609
+ domMode: "native" | "spatial";
610
+ nativeRestFrames: number;
611
+ nativeSwitchPending: boolean;
612
+ }[];
613
+ };
479
614
  /** Returns render-target lifecycle counters for query-gated performance tests. */
480
615
  getVisualTestRenderTargetStats(): {
481
616
  pixelRatio: number;
@@ -493,6 +628,34 @@ export declare class StageExperience {
493
628
  creations: number;
494
629
  resizes: number;
495
630
  warmups: number;
631
+ inactiveScrollWarmups: number;
632
+ backgroundOutput: {
633
+ held: boolean;
634
+ targetTextureId: string | null;
635
+ implicitBackgroundTarget: boolean | null;
636
+ catalogProfile: string | null;
637
+ catalogProfileCurrent: boolean;
638
+ mode: "explicit" | "fallback" | "disposed";
639
+ generation: number;
640
+ contentsValid: boolean;
641
+ busy: boolean;
642
+ publications: number;
643
+ borrows: number;
644
+ width: number;
645
+ height: number;
646
+ samples: number;
647
+ requested: boolean;
648
+ initialized: boolean;
649
+ } | {
650
+ held: boolean;
651
+ targetTextureId: string | null;
652
+ implicitBackgroundTarget: boolean | null;
653
+ catalogProfile: string | null;
654
+ catalogProfileCurrent: boolean;
655
+ mode: "legacy";
656
+ requested: boolean;
657
+ initialized: boolean;
658
+ };
496
659
  activeScale: number;
497
660
  liveTargets: number;
498
661
  targets: {
@@ -590,7 +753,6 @@ export declare class StageExperience {
590
753
  * materialized by these real offscreen/canvas render passes.
591
754
  */
592
755
  private updateViewportFrame;
593
- private getViewportScale;
594
756
  private getSpatialElementCameraFitDistance;
595
757
  private rememberFittedViewportMetrics;
596
758
  private refitCameraForViewport;