@spatial-elements/core 0.1.0-beta.2 → 1.0.0-beta.11

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 (391) hide show
  1. package/README.md +16 -13
  2. package/dist/catalog/CarouselDeviceCamera.d.ts +20 -0
  3. package/dist/catalog/CarouselDeviceCamera.d.ts.map +1 -0
  4. package/dist/catalog/CarouselDeviceCamera.js +58 -0
  5. package/dist/catalog/CarouselDeviceCamera.js.map +1 -0
  6. package/dist/catalog/CarouselGlassCompositor.d.ts +14 -3
  7. package/dist/catalog/CarouselGlassCompositor.d.ts.map +1 -1
  8. package/dist/catalog/CarouselGlassCompositor.js +164 -28
  9. package/dist/catalog/CarouselGlassCompositor.js.map +1 -1
  10. package/dist/catalog/CarouselGround.d.ts +43 -0
  11. package/dist/catalog/CarouselGround.d.ts.map +1 -0
  12. package/dist/catalog/CarouselGround.js +270 -0
  13. package/dist/catalog/CarouselGround.js.map +1 -0
  14. package/dist/catalog/CarouselSectionSurfaces.d.ts +10 -0
  15. package/dist/catalog/CarouselSectionSurfaces.d.ts.map +1 -0
  16. package/dist/catalog/CarouselSectionSurfaces.js +55 -0
  17. package/dist/catalog/CarouselSectionSurfaces.js.map +1 -0
  18. package/dist/catalog/CatalogDepthBlur.d.ts +45 -0
  19. package/dist/catalog/CatalogDepthBlur.d.ts.map +1 -0
  20. package/dist/catalog/CatalogDepthBlur.js +190 -0
  21. package/dist/catalog/CatalogDepthBlur.js.map +1 -0
  22. package/dist/catalog/CatalogEndpointRegistry.d.ts +4 -2
  23. package/dist/catalog/CatalogEndpointRegistry.d.ts.map +1 -1
  24. package/dist/catalog/CatalogEndpointRegistry.js +2 -0
  25. package/dist/catalog/CatalogEndpointRegistry.js.map +1 -1
  26. package/dist/catalog/CatalogGeometryFade.d.ts +5 -1
  27. package/dist/catalog/CatalogGeometryFade.d.ts.map +1 -1
  28. package/dist/catalog/CatalogGeometryFade.js +45 -9
  29. package/dist/catalog/CatalogGeometryFade.js.map +1 -1
  30. package/dist/catalog/CatalogModelOutline.d.ts +33 -0
  31. package/dist/catalog/CatalogModelOutline.d.ts.map +1 -0
  32. package/dist/catalog/CatalogModelOutline.js +144 -0
  33. package/dist/catalog/CatalogModelOutline.js.map +1 -0
  34. package/dist/catalog/CatalogNavigationRegistry.d.ts +44 -0
  35. package/dist/catalog/CatalogNavigationRegistry.d.ts.map +1 -0
  36. package/dist/catalog/CatalogNavigationRegistry.js +66 -0
  37. package/dist/catalog/CatalogNavigationRegistry.js.map +1 -0
  38. package/dist/catalog/CatalogPreparation.d.ts +3 -3
  39. package/dist/catalog/CatalogPreparation.d.ts.map +1 -1
  40. package/dist/catalog/CatalogPreparation.js +10 -7
  41. package/dist/catalog/CatalogPreparation.js.map +1 -1
  42. package/dist/catalog/CatalogSpatialElementLayer.d.ts +175 -5
  43. package/dist/catalog/CatalogSpatialElementLayer.d.ts.map +1 -1
  44. package/dist/catalog/CatalogSpatialElementLayer.js +739 -121
  45. package/dist/catalog/CatalogSpatialElementLayer.js.map +1 -1
  46. package/dist/catalog/CatalogTransition.d.ts +5 -3
  47. package/dist/catalog/CatalogTransition.d.ts.map +1 -1
  48. package/dist/catalog/CatalogTransition.js +207 -91
  49. package/dist/catalog/CatalogTransition.js.map +1 -1
  50. package/dist/catalog/CatalogWarmOutputContext.d.ts +39 -0
  51. package/dist/catalog/CatalogWarmOutputContext.d.ts.map +1 -0
  52. package/dist/catalog/CatalogWarmOutputContext.js +159 -0
  53. package/dist/catalog/CatalogWarmOutputContext.js.map +1 -0
  54. package/dist/catalog/EarlyNavigationCoordinator.d.ts +35 -0
  55. package/dist/catalog/EarlyNavigationCoordinator.d.ts.map +1 -0
  56. package/dist/catalog/EarlyNavigationCoordinator.js +103 -0
  57. package/dist/catalog/EarlyNavigationCoordinator.js.map +1 -0
  58. package/dist/catalog/NavigationFeedback.d.ts +12 -0
  59. package/dist/catalog/NavigationFeedback.d.ts.map +1 -0
  60. package/dist/catalog/NavigationFeedback.js +40 -0
  61. package/dist/catalog/NavigationFeedback.js.map +1 -0
  62. package/dist/catalog/PreparationGate.d.ts +4 -0
  63. package/dist/catalog/PreparationGate.d.ts.map +1 -1
  64. package/dist/catalog/PreparationGate.js +1 -0
  65. package/dist/catalog/PreparationGate.js.map +1 -1
  66. package/dist/catalog/SourceDomClipping.d.ts +8 -0
  67. package/dist/catalog/SourceDomClipping.d.ts.map +1 -0
  68. package/dist/catalog/SourceDomClipping.js +74 -0
  69. package/dist/catalog/SourceDomClipping.js.map +1 -0
  70. package/dist/catalog/SourceDomMotion.d.ts +28 -0
  71. package/dist/catalog/SourceDomMotion.d.ts.map +1 -0
  72. package/dist/catalog/SourceDomMotion.js +111 -0
  73. package/dist/catalog/SourceDomMotion.js.map +1 -0
  74. package/dist/catalog/SpatialGeometryCapture.d.ts +9 -0
  75. package/dist/catalog/SpatialGeometryCapture.d.ts.map +1 -1
  76. package/dist/catalog/SpatialGeometryCapture.js +11 -1
  77. package/dist/catalog/SpatialGeometryCapture.js.map +1 -1
  78. package/dist/catalog/SpatialPageRegistry.d.ts +18 -0
  79. package/dist/catalog/SpatialPageRegistry.d.ts.map +1 -0
  80. package/dist/catalog/SpatialPageRegistry.js +21 -0
  81. package/dist/catalog/SpatialPageRegistry.js.map +1 -0
  82. package/dist/catalog/StagedCatalogTransition.d.ts +74 -0
  83. package/dist/catalog/StagedCatalogTransition.d.ts.map +1 -0
  84. package/dist/catalog/StagedCatalogTransition.js +270 -0
  85. package/dist/catalog/StagedCatalogTransition.js.map +1 -0
  86. package/dist/catalog/cardModelFit.d.ts +7 -0
  87. package/dist/catalog/cardModelFit.d.ts.map +1 -0
  88. package/dist/catalog/cardModelFit.js +16 -0
  89. package/dist/catalog/cardModelFit.js.map +1 -0
  90. package/dist/catalog/cardProjection.d.ts +39 -0
  91. package/dist/catalog/cardProjection.d.ts.map +1 -0
  92. package/dist/catalog/cardProjection.js +110 -0
  93. package/dist/catalog/cardProjection.js.map +1 -0
  94. package/dist/catalog/carouselMotion.d.ts +74 -0
  95. package/dist/catalog/carouselMotion.d.ts.map +1 -0
  96. package/dist/catalog/carouselMotion.js +185 -0
  97. package/dist/catalog/carouselMotion.js.map +1 -0
  98. package/dist/catalog/carouselPanelProjection.d.ts.map +1 -1
  99. package/dist/catalog/carouselPanelProjection.js +48 -11
  100. package/dist/catalog/carouselPanelProjection.js.map +1 -1
  101. package/dist/catalog/carouselProximity.d.ts +11 -0
  102. package/dist/catalog/carouselProximity.d.ts.map +1 -0
  103. package/dist/catalog/carouselProximity.js +13 -0
  104. package/dist/catalog/carouselProximity.js.map +1 -0
  105. package/dist/catalog/carouselSupport.d.ts +4 -0
  106. package/dist/catalog/carouselSupport.d.ts.map +1 -0
  107. package/dist/catalog/carouselSupport.js +30 -0
  108. package/dist/catalog/carouselSupport.js.map +1 -0
  109. package/dist/catalog/catalogActivationFocus.d.ts +5 -0
  110. package/dist/catalog/catalogActivationFocus.d.ts.map +1 -0
  111. package/dist/catalog/catalogActivationFocus.js +39 -0
  112. package/dist/catalog/catalogActivationFocus.js.map +1 -0
  113. package/dist/catalog/catalogDomSnapshot.d.ts +18 -0
  114. package/dist/catalog/catalogDomSnapshot.d.ts.map +1 -0
  115. package/dist/catalog/catalogDomSnapshot.js +51 -0
  116. package/dist/catalog/catalogDomSnapshot.js.map +1 -0
  117. package/dist/catalog/catalogJourney.d.ts +4 -1
  118. package/dist/catalog/catalogJourney.d.ts.map +1 -1
  119. package/dist/catalog/catalogJourney.js +7 -15
  120. package/dist/catalog/catalogJourney.js.map +1 -1
  121. package/dist/catalog/catalogPage.d.ts +7 -3
  122. package/dist/catalog/catalogPage.d.ts.map +1 -1
  123. package/dist/catalog/catalogPage.js.map +1 -1
  124. package/dist/catalog/catalogPose.d.ts +54 -6
  125. package/dist/catalog/catalogPose.d.ts.map +1 -1
  126. package/dist/catalog/catalogPose.js +100 -23
  127. package/dist/catalog/catalogPose.js.map +1 -1
  128. package/dist/catalog/catalogRecipes.d.ts +3 -2
  129. package/dist/catalog/catalogRecipes.d.ts.map +1 -1
  130. package/dist/catalog/catalogRecipes.js +12 -27
  131. package/dist/catalog/catalogRecipes.js.map +1 -1
  132. package/dist/catalog/catalogTransitionViewport.d.ts +9 -0
  133. package/dist/catalog/catalogTransitionViewport.d.ts.map +1 -0
  134. package/dist/catalog/catalogTransitionViewport.js +13 -0
  135. package/dist/catalog/catalogTransitionViewport.js.map +1 -0
  136. package/dist/catalog/catalogViewLink.d.ts +2 -0
  137. package/dist/catalog/catalogViewLink.d.ts.map +1 -1
  138. package/dist/catalog/catalogViewLink.js +10 -2
  139. package/dist/catalog/catalogViewLink.js.map +1 -1
  140. package/dist/catalog/deviceYaw.d.ts +21 -0
  141. package/dist/catalog/deviceYaw.d.ts.map +1 -0
  142. package/dist/catalog/deviceYaw.js +87 -0
  143. package/dist/catalog/deviceYaw.js.map +1 -0
  144. package/dist/catalog/listDeviceOrientation.d.ts +20 -0
  145. package/dist/catalog/listDeviceOrientation.d.ts.map +1 -0
  146. package/dist/catalog/listDeviceOrientation.js +273 -0
  147. package/dist/catalog/listDeviceOrientation.js.map +1 -0
  148. package/dist/catalog/spatialElementAssets.d.ts +5 -5
  149. package/dist/catalog/spatialElementAssets.d.ts.map +1 -1
  150. package/dist/catalog/spatialElementAssets.js.map +1 -1
  151. package/dist/catalog/spatialElementLodPair.d.ts +2 -1
  152. package/dist/catalog/spatialElementLodPair.d.ts.map +1 -1
  153. package/dist/catalog/spatialElementLodPair.js.map +1 -1
  154. package/dist/catalog/stagedDetailGeometry.d.ts +37 -0
  155. package/dist/catalog/stagedDetailGeometry.d.ts.map +1 -0
  156. package/dist/catalog/stagedDetailGeometry.js +55 -0
  157. package/dist/catalog/stagedDetailGeometry.js.map +1 -0
  158. package/dist/catalog/stagedDockGeometry.d.ts +66 -0
  159. package/dist/catalog/stagedDockGeometry.d.ts.map +1 -0
  160. package/dist/catalog/stagedDockGeometry.js +66 -0
  161. package/dist/catalog/stagedDockGeometry.js.map +1 -0
  162. package/dist/index.d.ts +6 -2
  163. package/dist/index.d.ts.map +1 -1
  164. package/dist/index.js +5 -1
  165. package/dist/index.js.map +1 -1
  166. package/dist/spatial-element/ResponsiveViewportMetrics.d.ts +18 -0
  167. package/dist/spatial-element/ResponsiveViewportMetrics.d.ts.map +1 -0
  168. package/dist/spatial-element/ResponsiveViewportMetrics.js +68 -0
  169. package/dist/spatial-element/ResponsiveViewportMetrics.js.map +1 -0
  170. package/dist/spatial-element/SectionSurfaceRegistry.d.ts +2 -0
  171. package/dist/spatial-element/SectionSurfaceRegistry.d.ts.map +1 -0
  172. package/dist/spatial-element/SectionSurfaceRegistry.js +2 -0
  173. package/dist/spatial-element/SectionSurfaceRegistry.js.map +1 -0
  174. package/dist/spatial-element/SpatialElementDockController.d.ts +23 -11
  175. package/dist/spatial-element/SpatialElementDockController.d.ts.map +1 -1
  176. package/dist/spatial-element/SpatialElementDockController.js +228 -96
  177. package/dist/spatial-element/SpatialElementDockController.js.map +1 -1
  178. package/dist/spatial-element/SpatialElementPaneController.d.ts +67 -0
  179. package/dist/spatial-element/SpatialElementPaneController.d.ts.map +1 -0
  180. package/dist/spatial-element/SpatialElementPaneController.js +246 -0
  181. package/dist/spatial-element/SpatialElementPaneController.js.map +1 -0
  182. package/dist/spatial-element/activeDetailSection.d.ts +8 -0
  183. package/dist/spatial-element/activeDetailSection.d.ts.map +1 -0
  184. package/dist/spatial-element/activeDetailSection.js +19 -0
  185. package/dist/spatial-element/activeDetailSection.js.map +1 -0
  186. package/dist/spatial-element/layoutTokens.json +228 -0
  187. package/dist/spatial-element/messages.d.ts +46 -0
  188. package/dist/spatial-element/messages.d.ts.map +1 -0
  189. package/dist/spatial-element/messages.js +46 -0
  190. package/dist/spatial-element/messages.js.map +1 -0
  191. package/dist/spatial-element/responsiveLayout.d.ts +1353 -0
  192. package/dist/spatial-element/responsiveLayout.d.ts.map +1 -0
  193. package/dist/spatial-element/responsiveLayout.js +210 -0
  194. package/dist/spatial-element/responsiveLayout.js.map +1 -0
  195. package/dist/spatial-element/sectionBackground.d.ts +3 -0
  196. package/dist/spatial-element/sectionBackground.d.ts.map +1 -0
  197. package/dist/spatial-element/sectionBackground.js +2 -0
  198. package/dist/spatial-element/sectionBackground.js.map +1 -0
  199. package/dist/spatial-element/spatialElement.d.ts +17 -12
  200. package/dist/spatial-element/spatialElement.d.ts.map +1 -1
  201. package/dist/spatial-element/spatialElement.js +33 -6
  202. package/dist/spatial-element/spatialElement.js.map +1 -1
  203. package/dist/spatial-element/spatialElementDock.d.ts +15 -0
  204. package/dist/spatial-element/spatialElementDock.d.ts.map +1 -1
  205. package/dist/spatial-element/spatialElementDock.js +22 -0
  206. package/dist/spatial-element/spatialElementDock.js.map +1 -1
  207. package/dist/spatial-element/spatialElementGeometry.d.ts +22 -0
  208. package/dist/spatial-element/spatialElementGeometry.d.ts.map +1 -0
  209. package/dist/spatial-element/spatialElementGeometry.js +40 -0
  210. package/dist/spatial-element/spatialElementGeometry.js.map +1 -0
  211. package/dist/spatial-element/spatialElementMedia.d.ts +16 -0
  212. package/dist/spatial-element/spatialElementMedia.d.ts.map +1 -0
  213. package/dist/spatial-element/spatialElementMedia.js +29 -0
  214. package/dist/spatial-element/spatialElementMedia.js.map +1 -0
  215. package/dist/spatial-element/spatialElementScene.d.ts +16 -0
  216. package/dist/spatial-element/spatialElementScene.d.ts.map +1 -0
  217. package/dist/spatial-element/spatialElementScene.js +22 -0
  218. package/dist/spatial-element/spatialElementScene.js.map +1 -0
  219. package/dist/spatial-element/spatialElementSectionRegistry.d.ts +6 -25
  220. package/dist/spatial-element/spatialElementSectionRegistry.d.ts.map +1 -1
  221. package/dist/spatial-element/spatialElementSectionRegistry.js +6 -63
  222. package/dist/spatial-element/spatialElementSectionRegistry.js.map +1 -1
  223. package/dist/spatial-element/spatialTheme.d.ts +27 -0
  224. package/dist/spatial-element/spatialTheme.d.ts.map +1 -0
  225. package/dist/spatial-element/spatialTheme.js +83 -0
  226. package/dist/spatial-element/spatialTheme.js.map +1 -0
  227. package/dist/spatial-element/types.d.ts +117 -36
  228. package/dist/spatial-element/types.d.ts.map +1 -1
  229. package/dist/spatial-element/types.js.map +1 -1
  230. package/dist/stage/BackgroundLayerOutput.d.ts +76 -0
  231. package/dist/stage/BackgroundLayerOutput.d.ts.map +1 -0
  232. package/dist/stage/BackgroundLayerOutput.js +333 -0
  233. package/dist/stage/BackgroundLayerOutput.js.map +1 -0
  234. package/dist/stage/DeviceGeometryMotion.d.ts +13 -0
  235. package/dist/stage/DeviceGeometryMotion.d.ts.map +1 -0
  236. package/dist/stage/DeviceGeometryMotion.js +37 -0
  237. package/dist/stage/DeviceGeometryMotion.js.map +1 -0
  238. package/dist/stage/LiquidGlassPanel.d.ts +7 -0
  239. package/dist/stage/LiquidGlassPanel.d.ts.map +1 -1
  240. package/dist/stage/LiquidGlassPanel.js +51 -7
  241. package/dist/stage/LiquidGlassPanel.js.map +1 -1
  242. package/dist/stage/MinimapController.d.ts +4 -1
  243. package/dist/stage/MinimapController.d.ts.map +1 -1
  244. package/dist/stage/MinimapController.js +62 -71
  245. package/dist/stage/MinimapController.js.map +1 -1
  246. package/dist/stage/ModelPointerPreview.d.ts +22 -0
  247. package/dist/stage/ModelPointerPreview.d.ts.map +1 -0
  248. package/dist/stage/ModelPointerPreview.js +71 -0
  249. package/dist/stage/ModelPointerPreview.js.map +1 -0
  250. package/dist/stage/PageBindingController.d.ts +10 -0
  251. package/dist/stage/PageBindingController.d.ts.map +1 -1
  252. package/dist/stage/PageBindingController.js +45 -5
  253. package/dist/stage/PageBindingController.js.map +1 -1
  254. package/dist/stage/PanelPresentationController.d.ts +21 -1
  255. package/dist/stage/PanelPresentationController.d.ts.map +1 -1
  256. package/dist/stage/PanelPresentationController.js +190 -31
  257. package/dist/stage/PanelPresentationController.js.map +1 -1
  258. package/dist/stage/SpaceMouseAdapter.d.ts +10 -2
  259. package/dist/stage/SpaceMouseAdapter.d.ts.map +1 -1
  260. package/dist/stage/SpaceMouseAdapter.js +50 -8
  261. package/dist/stage/SpaceMouseAdapter.js.map +1 -1
  262. package/dist/stage/SpatialElementInteractionController.d.ts +24 -2
  263. package/dist/stage/SpatialElementInteractionController.d.ts.map +1 -1
  264. package/dist/stage/SpatialElementInteractionController.js +198 -45
  265. package/dist/stage/SpatialElementInteractionController.js.map +1 -1
  266. package/dist/stage/SpatialElementPresentationController.d.ts +14 -2
  267. package/dist/stage/SpatialElementPresentationController.d.ts.map +1 -1
  268. package/dist/stage/SpatialElementPresentationController.js +47 -2
  269. package/dist/stage/SpatialElementPresentationController.js.map +1 -1
  270. package/dist/stage/SpatialElementRefinement.d.ts +34 -1
  271. package/dist/stage/SpatialElementRefinement.d.ts.map +1 -1
  272. package/dist/stage/SpatialElementRefinement.js +175 -37
  273. package/dist/stage/SpatialElementRefinement.js.map +1 -1
  274. package/dist/stage/StageExperience.d.ts +266 -11
  275. package/dist/stage/StageExperience.d.ts.map +1 -1
  276. package/dist/stage/StageExperience.js +673 -126
  277. package/dist/stage/StageExperience.js.map +1 -1
  278. package/dist/stage/StageFullscreenController.d.ts +17 -0
  279. package/dist/stage/StageFullscreenController.d.ts.map +1 -0
  280. package/dist/stage/StageFullscreenController.js +90 -0
  281. package/dist/stage/StageFullscreenController.js.map +1 -0
  282. package/dist/stage/StagePanelRuntime.d.ts +2 -1
  283. package/dist/stage/StagePanelRuntime.d.ts.map +1 -1
  284. package/dist/stage/StagePanelRuntime.js.map +1 -1
  285. package/dist/stage/StageRenderPipeline.d.ts +90 -2
  286. package/dist/stage/StageRenderPipeline.d.ts.map +1 -1
  287. package/dist/stage/StageRenderPipeline.js +494 -120
  288. package/dist/stage/StageRenderPipeline.js.map +1 -1
  289. package/dist/stage/VirtualScrollController.d.ts +7 -0
  290. package/dist/stage/VirtualScrollController.d.ts.map +1 -1
  291. package/dist/stage/VirtualScrollController.js +63 -6
  292. package/dist/stage/VirtualScrollController.js.map +1 -1
  293. package/dist/stage/inertLease.d.ts +2 -0
  294. package/dist/stage/inertLease.d.ts.map +1 -0
  295. package/dist/stage/inertLease.js +18 -0
  296. package/dist/stage/inertLease.js.map +1 -0
  297. package/dist/stage/interactionGuidance.d.ts +22 -0
  298. package/dist/stage/interactionGuidance.d.ts.map +1 -0
  299. package/dist/stage/interactionGuidance.js +53 -0
  300. package/dist/stage/interactionGuidance.js.map +1 -0
  301. package/dist/stage/interactionOutline.d.ts +14 -0
  302. package/dist/stage/interactionOutline.d.ts.map +1 -0
  303. package/dist/stage/interactionOutline.js +59 -0
  304. package/dist/stage/interactionOutline.js.map +1 -0
  305. package/dist/stage/minimap/MinimapGeometry.d.ts.map +1 -1
  306. package/dist/stage/minimap/MinimapGeometry.js +29 -0
  307. package/dist/stage/minimap/MinimapGeometry.js.map +1 -1
  308. package/dist/stage/minimap/MinimapModel.d.ts +2 -1
  309. package/dist/stage/minimap/MinimapModel.d.ts.map +1 -1
  310. package/dist/stage/minimap/MinimapModel.js +34 -4
  311. package/dist/stage/minimap/MinimapModel.js.map +1 -1
  312. package/dist/stage/minimap/MinimapModelGeometry.d.ts +21 -0
  313. package/dist/stage/minimap/MinimapModelGeometry.d.ts.map +1 -0
  314. package/dist/stage/minimap/MinimapModelGeometry.js +68 -0
  315. package/dist/stage/minimap/MinimapModelGeometry.js.map +1 -0
  316. package/dist/stage/minimap/MinimapProjection.d.ts +7 -0
  317. package/dist/stage/minimap/MinimapProjection.d.ts.map +1 -1
  318. package/dist/stage/minimap/MinimapProjection.js +14 -13
  319. package/dist/stage/minimap/MinimapProjection.js.map +1 -1
  320. package/dist/stage/minimap/MinimapState.d.ts +6 -11
  321. package/dist/stage/minimap/MinimapState.d.ts.map +1 -1
  322. package/dist/stage/minimap/MinimapState.js.map +1 -1
  323. package/dist/stage/mouseHover.d.ts +9 -0
  324. package/dist/stage/mouseHover.d.ts.map +1 -0
  325. package/dist/stage/mouseHover.js +55 -0
  326. package/dist/stage/mouseHover.js.map +1 -0
  327. package/dist/stage/panelContext.d.ts +33 -2
  328. package/dist/stage/panelContext.d.ts.map +1 -1
  329. package/dist/stage/panelContext.js.map +1 -1
  330. package/dist/stage/panelFocusMath.d.ts +34 -0
  331. package/dist/stage/panelFocusMath.d.ts.map +1 -0
  332. package/dist/stage/panelFocusMath.js +79 -0
  333. package/dist/stage/panelFocusMath.js.map +1 -0
  334. package/dist/stage/renderSettings.d.ts +10 -0
  335. package/dist/stage/renderSettings.d.ts.map +1 -0
  336. package/dist/stage/renderSettings.js +27 -0
  337. package/dist/stage/renderSettings.js.map +1 -0
  338. package/dist/stage/renderTargetInventory.d.ts +1 -1
  339. package/dist/stage/renderTargetInventory.js +1 -1
  340. package/dist/stage/renderTargetInventory.js.map +1 -1
  341. package/dist/stage/rendererState.d.ts +2 -0
  342. package/dist/stage/rendererState.d.ts.map +1 -1
  343. package/dist/stage/rendererState.js +13 -0
  344. package/dist/stage/rendererState.js.map +1 -1
  345. package/dist/stage/scalarMath.d.ts +6 -0
  346. package/dist/stage/scalarMath.d.ts.map +1 -0
  347. package/dist/stage/scalarMath.js +6 -0
  348. package/dist/stage/scalarMath.js.map +1 -0
  349. package/dist/stage/sceneEndpointEligibility.d.ts +20 -0
  350. package/dist/stage/sceneEndpointEligibility.d.ts.map +1 -0
  351. package/dist/stage/sceneEndpointEligibility.js +363 -0
  352. package/dist/stage/sceneEndpointEligibility.js.map +1 -0
  353. package/dist/stage/scrollFrame.d.ts +2 -0
  354. package/dist/stage/scrollFrame.d.ts.map +1 -1
  355. package/dist/stage/scrollFrame.js +18 -5
  356. package/dist/stage/scrollFrame.js.map +1 -1
  357. package/dist/stage/spaceMousePermission.d.ts +11 -0
  358. package/dist/stage/spaceMousePermission.d.ts.map +1 -0
  359. package/dist/stage/spaceMousePermission.js +63 -0
  360. package/dist/stage/spaceMousePermission.js.map +1 -0
  361. package/dist/stage/spaceMousePlatform.d.ts +12 -0
  362. package/dist/stage/spaceMousePlatform.d.ts.map +1 -0
  363. package/dist/stage/spaceMousePlatform.js +13 -0
  364. package/dist/stage/spaceMousePlatform.js.map +1 -0
  365. package/dist/stage/spatialElementFrame.d.ts.map +1 -1
  366. package/dist/stage/spatialElementFrame.js +5 -1
  367. package/dist/stage/spatialElementFrame.js.map +1 -1
  368. package/dist/stage/stageConstants.d.ts +3 -3
  369. package/dist/stage/stageConstants.d.ts.map +1 -1
  370. package/dist/stage/stageConstants.js +10 -10
  371. package/dist/stage/stageConstants.js.map +1 -1
  372. package/dist/stage/stageDom.d.ts +2 -0
  373. package/dist/stage/stageDom.d.ts.map +1 -1
  374. package/dist/stage/stageDom.js +10 -1
  375. package/dist/stage/stageDom.js.map +1 -1
  376. package/dist/stage/stageMath.d.ts +4 -33
  377. package/dist/stage/stageMath.d.ts.map +1 -1
  378. package/dist/stage/stageMath.js +39 -110
  379. package/dist/stage/stageMath.js.map +1 -1
  380. package/dist/stage/stageTypes.d.ts +32 -4
  381. package/dist/stage/stageTypes.d.ts.map +1 -1
  382. package/dist/stage/stageTypes.js.map +1 -1
  383. package/dist/stage/stageVisualTest.d.ts +24 -1
  384. package/dist/stage/stageVisualTest.d.ts.map +1 -1
  385. package/dist/stage/stageVisualTest.js.map +1 -1
  386. package/dist/stage/webgpuSupport.d.ts +3 -0
  387. package/dist/stage/webgpuSupport.d.ts.map +1 -0
  388. package/dist/stage/webgpuSupport.js +14 -0
  389. package/dist/stage/webgpuSupport.js.map +1 -0
  390. package/logo.svg +225 -0
  391. package/package.json +7 -5
@@ -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"]}