@spatial-elements/core 0.1.0-beta.1 → 1.0.0-beta.10

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 (367) hide show
  1. package/README.md +17 -9
  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 +2 -0
  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 +143 -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 +4 -2
  47. package/dist/catalog/CatalogTransition.d.ts.map +1 -1
  48. package/dist/catalog/CatalogTransition.js +206 -90
  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 +10 -25
  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 +17 -0
  145. package/dist/catalog/listDeviceOrientation.d.ts.map +1 -0
  146. package/dist/catalog/listDeviceOrientation.js +262 -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 +22 -10
  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 +34 -0
  188. package/dist/spatial-element/messages.d.ts.map +1 -0
  189. package/dist/spatial-element/messages.js +34 -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 +46 -5
  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 +57 -66
  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/SpatialElementInteractionController.d.ts +19 -1
  259. package/dist/stage/SpatialElementInteractionController.d.ts.map +1 -1
  260. package/dist/stage/SpatialElementInteractionController.js +134 -13
  261. package/dist/stage/SpatialElementInteractionController.js.map +1 -1
  262. package/dist/stage/SpatialElementPresentationController.d.ts +14 -2
  263. package/dist/stage/SpatialElementPresentationController.d.ts.map +1 -1
  264. package/dist/stage/SpatialElementPresentationController.js +47 -2
  265. package/dist/stage/SpatialElementPresentationController.js.map +1 -1
  266. package/dist/stage/SpatialElementRefinement.d.ts +34 -1
  267. package/dist/stage/SpatialElementRefinement.d.ts.map +1 -1
  268. package/dist/stage/SpatialElementRefinement.js +175 -37
  269. package/dist/stage/SpatialElementRefinement.js.map +1 -1
  270. package/dist/stage/StageExperience.d.ts +263 -10
  271. package/dist/stage/StageExperience.d.ts.map +1 -1
  272. package/dist/stage/StageExperience.js +655 -124
  273. package/dist/stage/StageExperience.js.map +1 -1
  274. package/dist/stage/StageFullscreenController.d.ts +17 -0
  275. package/dist/stage/StageFullscreenController.d.ts.map +1 -0
  276. package/dist/stage/StageFullscreenController.js +90 -0
  277. package/dist/stage/StageFullscreenController.js.map +1 -0
  278. package/dist/stage/StagePanelRuntime.d.ts +2 -1
  279. package/dist/stage/StagePanelRuntime.d.ts.map +1 -1
  280. package/dist/stage/StagePanelRuntime.js.map +1 -1
  281. package/dist/stage/StageRenderPipeline.d.ts +90 -2
  282. package/dist/stage/StageRenderPipeline.d.ts.map +1 -1
  283. package/dist/stage/StageRenderPipeline.js +494 -119
  284. package/dist/stage/StageRenderPipeline.js.map +1 -1
  285. package/dist/stage/VirtualScrollController.d.ts +7 -0
  286. package/dist/stage/VirtualScrollController.d.ts.map +1 -1
  287. package/dist/stage/VirtualScrollController.js +63 -6
  288. package/dist/stage/VirtualScrollController.js.map +1 -1
  289. package/dist/stage/inertLease.d.ts +2 -0
  290. package/dist/stage/inertLease.d.ts.map +1 -0
  291. package/dist/stage/inertLease.js +18 -0
  292. package/dist/stage/inertLease.js.map +1 -0
  293. package/dist/stage/interactionGuidance.d.ts +22 -0
  294. package/dist/stage/interactionGuidance.d.ts.map +1 -0
  295. package/dist/stage/interactionGuidance.js +53 -0
  296. package/dist/stage/interactionGuidance.js.map +1 -0
  297. package/dist/stage/interactionOutline.d.ts +14 -0
  298. package/dist/stage/interactionOutline.d.ts.map +1 -0
  299. package/dist/stage/interactionOutline.js +59 -0
  300. package/dist/stage/interactionOutline.js.map +1 -0
  301. package/dist/stage/minimap/MinimapGeometry.d.ts.map +1 -1
  302. package/dist/stage/minimap/MinimapGeometry.js +29 -0
  303. package/dist/stage/minimap/MinimapGeometry.js.map +1 -1
  304. package/dist/stage/minimap/MinimapModel.d.ts +2 -1
  305. package/dist/stage/minimap/MinimapModel.d.ts.map +1 -1
  306. package/dist/stage/minimap/MinimapModel.js +34 -4
  307. package/dist/stage/minimap/MinimapModel.js.map +1 -1
  308. package/dist/stage/minimap/MinimapModelGeometry.d.ts +21 -0
  309. package/dist/stage/minimap/MinimapModelGeometry.d.ts.map +1 -0
  310. package/dist/stage/minimap/MinimapModelGeometry.js +68 -0
  311. package/dist/stage/minimap/MinimapModelGeometry.js.map +1 -0
  312. package/dist/stage/minimap/MinimapProjection.d.ts +7 -0
  313. package/dist/stage/minimap/MinimapProjection.d.ts.map +1 -1
  314. package/dist/stage/minimap/MinimapProjection.js +14 -13
  315. package/dist/stage/minimap/MinimapProjection.js.map +1 -1
  316. package/dist/stage/minimap/MinimapState.d.ts +3 -8
  317. package/dist/stage/minimap/MinimapState.d.ts.map +1 -1
  318. package/dist/stage/minimap/MinimapState.js.map +1 -1
  319. package/dist/stage/mouseHover.d.ts +9 -0
  320. package/dist/stage/mouseHover.d.ts.map +1 -0
  321. package/dist/stage/mouseHover.js +55 -0
  322. package/dist/stage/mouseHover.js.map +1 -0
  323. package/dist/stage/panelContext.d.ts +27 -2
  324. package/dist/stage/panelContext.d.ts.map +1 -1
  325. package/dist/stage/panelContext.js.map +1 -1
  326. package/dist/stage/renderSettings.d.ts +10 -0
  327. package/dist/stage/renderSettings.d.ts.map +1 -0
  328. package/dist/stage/renderSettings.js +27 -0
  329. package/dist/stage/renderSettings.js.map +1 -0
  330. package/dist/stage/renderTargetInventory.d.ts +1 -1
  331. package/dist/stage/renderTargetInventory.js +1 -1
  332. package/dist/stage/renderTargetInventory.js.map +1 -1
  333. package/dist/stage/rendererState.d.ts +2 -0
  334. package/dist/stage/rendererState.d.ts.map +1 -1
  335. package/dist/stage/rendererState.js +13 -0
  336. package/dist/stage/rendererState.js.map +1 -1
  337. package/dist/stage/sceneEndpointEligibility.d.ts +20 -0
  338. package/dist/stage/sceneEndpointEligibility.d.ts.map +1 -0
  339. package/dist/stage/sceneEndpointEligibility.js +363 -0
  340. package/dist/stage/sceneEndpointEligibility.js.map +1 -0
  341. package/dist/stage/scrollFrame.d.ts +2 -0
  342. package/dist/stage/scrollFrame.d.ts.map +1 -1
  343. package/dist/stage/scrollFrame.js +18 -5
  344. package/dist/stage/scrollFrame.js.map +1 -1
  345. package/dist/stage/spatialElementFrame.d.ts.map +1 -1
  346. package/dist/stage/spatialElementFrame.js +5 -1
  347. package/dist/stage/spatialElementFrame.js.map +1 -1
  348. package/dist/stage/stageConstants.d.ts +3 -3
  349. package/dist/stage/stageConstants.d.ts.map +1 -1
  350. package/dist/stage/stageConstants.js +6 -6
  351. package/dist/stage/stageConstants.js.map +1 -1
  352. package/dist/stage/stageDom.d.ts +2 -0
  353. package/dist/stage/stageDom.d.ts.map +1 -1
  354. package/dist/stage/stageDom.js +10 -1
  355. package/dist/stage/stageDom.js.map +1 -1
  356. package/dist/stage/stageMath.d.ts +9 -10
  357. package/dist/stage/stageMath.d.ts.map +1 -1
  358. package/dist/stage/stageMath.js +23 -21
  359. package/dist/stage/stageMath.js.map +1 -1
  360. package/dist/stage/stageTypes.d.ts +30 -3
  361. package/dist/stage/stageTypes.d.ts.map +1 -1
  362. package/dist/stage/stageTypes.js.map +1 -1
  363. package/dist/stage/stageVisualTest.d.ts +24 -1
  364. package/dist/stage/stageVisualTest.d.ts.map +1 -1
  365. package/dist/stage/stageVisualTest.js.map +1 -1
  366. package/logo.svg +188 -0
  367. package/package.json +7 -5
@@ -1,6 +1,7 @@
1
1
  import * as THREE from 'three/webgpu';
2
2
  import { PresentationReadiness } from './PresentationReadiness.js';
3
3
  import { SpatialElementRefinement } from './SpatialElementRefinement.js';
4
+ import { createSceneEndpointGuard } from './sceneEndpointEligibility.js';
4
5
  import { prepareSpatialElementFrame } from './spatialElementFrame.js';
5
6
  import { applyModelMaterialOverrides, centerAndScale, disposeMaterialOnly, getMeshBounds, getMeshMaterials, isMesh } from './stageSceneUtils.js';
6
7
  /** Renderer-independent ownership of one hero's representations. Captures transfer, never borrow. */
@@ -10,6 +11,38 @@ export class SpatialElementPresentationController {
10
11
  getRenderTargets() {
11
12
  return [...new Set([this.blend, this.retainedBlend, this.movingBlend])].flatMap((blend) => blend?.getRenderTargets() ?? []);
12
13
  }
14
+ getSceneEndpointStats() {
15
+ return [...new Set([this.blend, this.retainedBlend, this.movingBlend])].flatMap(blend => blend ? [blend.getSceneEndpointStats()] : []);
16
+ }
17
+ invalidateSceneEndpoints() {
18
+ for (const blend of new Set([this.blend, this.retainedBlend, this.movingBlend]))
19
+ blend?.invalidateSceneEndpoints();
20
+ }
21
+ prepareSceneEndpoints(renderer, scene, camera, highEnvironment, draw, ownerIsCurrent, additionalScenes = [], additionalCameras = []) {
22
+ const refinement = this.blend, high = this.high, model = this.value, low = this.instance?.scene;
23
+ if (!refinement || !high || !model || !low || this.instance?.animations.length || high.instance.animations.length)
24
+ return;
25
+ const guard = createSceneEndpointGuard({ scene, camera, model, low, high: high.pose, highEnvironment, additionalScenes, additionalCameras });
26
+ if (!guard)
27
+ return;
28
+ return refinement.prepareSceneEndpoints(renderer, (useHigh, backgroundReveal) => {
29
+ const environment = scene.environment;
30
+ const visible = model.children.map(child => child.visible);
31
+ if (useHigh && highEnvironment)
32
+ scene.environment = highEnvironment;
33
+ model.children.forEach(child => { child.visible = (child === high.pose) === useHigh; });
34
+ try {
35
+ draw(backgroundReveal);
36
+ }
37
+ finally {
38
+ scene.environment = environment;
39
+ model.children.forEach((child, i) => { child.visible = visible[i]; });
40
+ }
41
+ }, {
42
+ isValid: () => this.blend === refinement && this.value === model && this.high === high && ownerIsCurrent() && guard.isValid(),
43
+ dispose: () => guard.dispose()
44
+ });
45
+ }
13
46
  readiness = new PresentationReadiness();
14
47
  environmentLease;
15
48
  finalizedTransfers = new WeakSet();
@@ -82,6 +115,7 @@ export class SpatialElementPresentationController {
82
115
  this.frames = frames;
83
116
  }
84
117
  finishHandoff(synchronous) {
118
+ this.invalidateSceneEndpoints();
85
119
  if (synchronous && this.high && this.state !== 'high')
86
120
  this.blend = new SpatialElementRefinement(true);
87
121
  if (this.movingBlend && this.high) {
@@ -93,6 +127,7 @@ export class SpatialElementPresentationController {
93
127
  this.movingBlend = undefined;
94
128
  }
95
129
  takeHigh() {
130
+ this.invalidateSceneEndpoints();
96
131
  const high = this.high;
97
132
  this.high = undefined;
98
133
  this.movingBlend = undefined;
@@ -104,6 +139,7 @@ export class SpatialElementPresentationController {
104
139
  this.state = 'high';
105
140
  }
106
141
  takeLowInstance() {
142
+ this.invalidateSceneEndpoints();
107
143
  const low = this.instance;
108
144
  this.instance = undefined;
109
145
  return low;
@@ -114,6 +150,7 @@ export class SpatialElementPresentationController {
114
150
  takeHero() {
115
151
  if (!this.value)
116
152
  return;
153
+ this.invalidateSceneEndpoints();
117
154
  const transfer = {
118
155
  model: this.value,
119
156
  low: this.low,
@@ -323,12 +360,13 @@ export class SpatialElementPresentationController {
323
360
  })();
324
361
  }
325
362
  /** Returns false when the ordinary single-representation pass should render instead. */
326
- renderRefinement(renderer, scene, highEnvironment, draw, representationChanged, reducedMotion) {
363
+ renderRefinement(renderer, scene, highEnvironment, draw, representationChanged, reducedMotion, options = {}) {
327
364
  const refinement = this.blend;
328
365
  const high = this.high;
329
366
  const model = this.value;
330
367
  if (!refinement || !high || !model)
331
368
  return false;
369
+ const originalVisibility = options.advanceClock === false ? model.children.map(child => child.visible) : undefined;
332
370
  try {
333
371
  refinement.render(renderer, (useHigh) => {
334
372
  const environment = scene.environment;
@@ -342,11 +380,14 @@ export class SpatialElementPresentationController {
342
380
  finally {
343
381
  scene.environment = environment;
344
382
  }
345
- }, reducedMotion);
383
+ }, reducedMotion, undefined, options);
384
+ if (options.advanceClock === false)
385
+ return true;
346
386
  this.markRefinement(refinement.complete ? 'high' : 'refining', refinement.frames);
347
387
  for (const child of model.children)
348
388
  child.visible = (child === high.pose) === refinement.complete;
349
389
  if (refinement.complete) {
390
+ refinement.invalidateSceneEndpoints();
350
391
  if (highEnvironment)
351
392
  scene.environment = highEnvironment;
352
393
  const outline = model.clone(false);
@@ -367,6 +408,10 @@ export class SpatialElementPresentationController {
367
408
  representationChanged(model, this.low ?? model);
368
409
  return false;
369
410
  }
411
+ finally {
412
+ if (originalVisibility)
413
+ model.children.forEach((child, i) => { child.visible = originalVisibility[i]; });
414
+ }
370
415
  }
371
416
  }
372
417
  //# sourceMappingURL=SpatialElementPresentationController.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"SpatialElementPresentationController.js","sourceRoot":"","sources":["../../src/stage/SpatialElementPresentationController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAOnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAEtE,OAAO,EACN,2BAA2B,EAC3B,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,gBAAgB,EAChB,MAAM,EACN,MAAM,sBAAsB,CAAC;AAiB9B,qGAAqG;AACrG,MAAM,OAAO,oCAAoC;IA0B9B;IACA;IA1BlB,gBAAgB;QACf,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,OAAO,CAC9E,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAC1C,CAAC;IACH,CAAC;IACQ,SAAS,GAAG,IAAI,qBAAqB,EAAE,CAAC;IACzC,gBAAgB,CAA2C;IAClD,kBAAkB,GAAG,IAAI,OAAO,EAAgB,CAAC;IAC1D,UAAU,GAAG,CAAC,CAAC;IACf,OAAO,CAAmB;IAC1B,WAAW,CAAmB;IAC9B,OAAO,CAAW;IAClB,KAAK,CAAkB;IACvB,GAAG,CAAkB;IACrB,MAAM,CAAc;IACpB,QAAQ,CAA+B;IACvC,IAAI,CAAgB;IACpB,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IACtC,KAAK,CAA4B;IACjC,WAAW,CAA4B;IACvC,aAAa,CAA4B;IACzC,KAAK,GAAoB,aAAa,CAAC;IACvC,MAAM,GAAG,CAAC,CAAC;IAEnB,YACkB,MAAmD,EACnD,OAAmB;QADnB,WAAM,GAAN,MAAM,CAA6C;QACnD,YAAO,GAAP,OAAO,CAAY;IAClC,CAAC;IAEJ,IAAI,KAAK;QACR,OAAO,IAAI,CAAC,KAAK,CAAC;IACnB,CAAC;IACD,IAAI,QAAQ;QACX,OAAO,IAAI,CAAC,GAAG,CAAC;IACjB,CAAC;IACD,IAAI,eAAe;QAClB,OAAO,IAAI,CAAC,MAAM,CAAC;IACpB,CAAC;IACD,IAAI,QAAQ;QACX,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IACxD,CAAC;IACD,IAAI,QAAQ;QACX,OAAO,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC;IACxB,CAAC;IACD,IAAI,UAAU;QACb,OAAO,IAAI,CAAC,KAAK,CAAC;IACnB,CAAC;IACD,IAAI,eAAe;QAClB,OAAO,IAAI,CAAC,KAAK,CAAC;IACnB,CAAC;IACD,IAAI,gBAAgB;QACnB,OAAO,IAAI,CAAC,MAAM,CAAC;IACpB,CAAC;IACD,IAAI,aAAa;QAChB,OAAO,IAAI,CAAC,QAAQ,CAAC;IACtB,CAAC;IACD,IAAI,YAAY;QACf,OAAO,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC;IAC5B,CAAC;IACD,IAAI,YAAY;QACf,OAAO,IAAI,CAAC,WAAW,CAAC;IACzB,CAAC;IACD,IAAI,WAAW;QACd,OAAO,IAAI,CAAC,aAAa,CAAC;IAC3B,CAAC;IAED,iBAAiB,CAAC,KAAuB,EAAE,WAAgC;QAC1E,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAC5C,IAAI,CAAC,gBAAgB,EAAE,OAAO,EAAE,CAAC;QACjC,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAC9B,CAAC;IAED,kBAAkB;QACjB,IAAI,CAAC,gBAAgB,EAAE,OAAO,EAAE,CAAC;QACjC,IAAI,CAAC,gBAAgB,GAAG,SAAS,CAAC;IACnC,CAAC;IAED,cAAc,CAAC,KAAsB,EAAE,MAAM,GAAG,IAAI,CAAC,MAAM;QAC1D,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACtB,CAAC;IAED,aAAa,CAAC,WAAoB;QACjC,IAAI,WAAW,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,KAAK,MAAM;YAAE,IAAI,CAAC,KAAK,GAAG,IAAI,wBAAwB,CAAC,IAAI,CAAC,CAAC;QACvG,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACnC,IAAI,CAAC,aAAa,EAAE,OAAO,EAAE,CAAC;YAC9B,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,WAAW,CAAC;QACvC,CAAC;;YAAM,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,CAAC;QACnC,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;IAC9B,CAAC;IAED,QAAQ;QACP,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;QACtB,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;QAC7B,OAAO,IAAI,CAAC;IACb,CAAC;IAED,WAAW,CAAC,IAAkB;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC;QAChC,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC;IACrB,CAAC;IAED,eAAe;QACd,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC1B,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;QAC1B,OAAO,GAAG,CAAC;IACZ,CAAC;IACD,kBAAkB,CAAC,GAAiC;QACnD,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC;IACrB,CAAC;IAED,QAAQ;QACP,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAO;QACxB,MAAM,QAAQ,GAAiB;YAC9B,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,UAAU,EAAE,IAAI,CAAC,KAAK;YACtB,KAAK,EAAE,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,KAAK;YAC3D,KAAK,EAAE,IAAI,CAAC,KAAK;SACjB,CAAC;QACF,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,GAAG,SAAS,CAAC;QAClC,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QACxB,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,IAAI,GAAG,EAAE,CAAC;QAC3B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;QAC/D,OAAO,QAAQ,CAAC;IACjB,CAAC;IAED,WAAW,CAAC,QAAsB;QACjC,IAAI,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC;YAAE,OAAO;QAClD,IAAI,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAC3E,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACtC,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;QAC5B,IAAI,CAAC,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC;QACxB,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;QAC9B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;QAC1B,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;QAChC,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC;QACpC,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC,UAAU,CAAC;QACjC,IAAI,CAAC,aAAa,GAAG,QAAQ,CAAC,KAAK,KAAK,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;QACzF,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;IAC7B,CAAC;IAED,sDAAsD;IACtD,eAAe,CAAC,QAAsB;QACrC,IAAI,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC;YAAE,OAAO;QAClD,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACtC,IAAI,QAAQ,CAAC,UAAU,KAAK,QAAQ,CAAC,KAAK;YAAE,QAAQ,CAAC,UAAU,EAAE,OAAO,EAAE,CAAC;QAC3E,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;QAChD,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;QACtD,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC;QAC7B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;IACnC,CAAC;IAED,qFAAqF;IACrF,cAAc;QACb,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;QACzB,IAAI,CAAC,UAAU,EAAE,CAAC;IACnB,CAAC;IAED,UAAU;QACT,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;QAC7B,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC;QACtB,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;QACvB,IAAI,IAAI,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;YAC3B,IAAI,IAAI,CAAC,KAAK;gBACb,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ;oBAAE,KAAK,CAAC,OAAO,GAAG,KAAK,KAAK,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC;YACpF,IAAI,CAAC,WAAW,EAAE,CAAC;YACnB,IAAI,CAAC,KAAK,GAAG,aAAa,CAAC;QAC5B,CAAC;IACF,CAAC;IAEO,WAAW;QAClB,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACnC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;IACvB,CAAC;IAED,OAAO;QACN,IAAI,CAAC,aAAa,EAAE,OAAO,EAAE,CAAC;QAC9B,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;QAClD,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,IAAI,CAAC,WAAW,EAAE,CAAC;QACnB,IAAI,CAAC,KAAK,EAAE,gBAAgB,EAAE,CAAC;QAC/B,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;QAC5C,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACvB,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;QAC1B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,GAAG,SAAS,CAAC;QAClC,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QACxB,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,aAAa,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,OAAgB;QAC1B,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QACnC,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,GAAG,IAAI,eAAe,EAAE,CAAC,CAAC;QACvD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAChC,OAAO,CAAC,OAAO,EAAE,GAAG,IAAI;YACvB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,MAAM,EAAE,KAAK;YACb,QAAQ,EAAE,oBAAoB;YAC9B,YAAY,EAAE,EAAE,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE;SACrD,EACD,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAC1B,CAAC;QACF,IAAI,QAAqC,CAAC;QAC1C,IAAI,CAAC;YACJ,QAAQ,GAAG,MAAM,KAAK,CAAC,cAAc,EAAE,CAAC;QACzC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO;gBAAE,OAAO;YACnC,MAAM,KAAK,CAAC;QACb,CAAC;gBAAS,CAAC;YACV,KAAK,CAAC,OAAO,EAAE,CAAC;YAChB,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO;gBAAE,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;QACxD,CAAC;QACD,IAAI,UAAU,KAAK,IAAI,CAAC,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAC9D,QAAQ,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO;QACR,CAAC;QACD,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QAC/C,IAAI,OAAO,CAAC,OAAO;YAClB,IAAI,CAAC,MAAM,GAAG,0BAA0B,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;aAC5F,CAAC;YACL,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YAC1B,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC;YACxC,IAAI,QAAQ;gBACX,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAC1B,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,EAC7C,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,EAC7C,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,EAC7C,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAC7B,CAAC;QACJ,CAAC;QACD,2BAA2B,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QAC7E,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,EAAE;YAClC,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,iBAAiB,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC;gBACnE,gBAAgB,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC/E,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,CAAC,OAAO;YACnB,cAAc,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,aAAa,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACpF,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7B,OAAO,KAAK,CAAC;IACd,CAAC;IAED,SAAS,CAAC,IAAkB,EAAE,MAAe;QAC5C,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI;YAAE,OAAO,KAAK,CAAC;QAC3C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QAC1B,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;QACvB,IAAI,MAAM;YAAE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC;aACrC,CAAC;YACL,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YACrB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACzB,CAAC;QACD,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IACb,CAAC;IAED,SAAS;QACR,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC7B,MAAM,IAAI,GAAG,OAAO,EAAE,OAAO,CAAC;QAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACzB,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ;YAC1F,OAAO;QACR,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,WAAW,GAAG,IAAI,eAAe,EAAE,CAAC,CAAC;QAC3D,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QAChB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QACzE,KAAK,CAAC,KAAK,IAAI,EAAE;YAChB,IAAI,QAAiD,CAAC;YACtD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;YAC5C,IAAI,CAAC;gBACJ,QAAQ,GAAG,MAAM,KAAK,CAAC,cAAc,EAAE,CAAC;gBACxC,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK;oBAAE,OAAO;gBAC3D,2BAA2B,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;gBAC7E,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,EAAE;oBAClC,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,iBAAiB,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC;wBACnE,gBAAgB,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAC1E,CAAC,CAAC,CAAC;gBACH,MAAM,SAAS,GAAG,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBACpC,0BAA0B,CAAC,SAAS,EAAE,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;gBAC3E,IACC,aAAa,CACZ,SAAS,EACT,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,aAAa,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAC3D,CAAC,OAAO,EAAE;oBAEX,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;gBAC3D,IAAI,CAAC,SAAS,CACb;oBACC,QAAQ;oBACR,IAAI,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;oBAC3B,SAAS,EAAE,IAAI,GAAG,CAAC,SAAS,CAAC;oBAC7B,KAAK,EAAE,IAAI,wBAAwB,CAAC,IAAI,CAAC;iBACzC,EACD,KAAK,CACL,CAAC;gBACF,QAAQ,GAAG,SAAS,CAAC;gBACrB,SAAS,CAAC,KAAK,EAAE,CAAC;YACnB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;oBACrD,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC;oBACtB,OAAO,CAAC,IAAI,CAAC,6CAA6C,EAAE,KAAK,CAAC,CAAC;gBACpE,CAAC;YACF,CAAC;oBAAS,CAAC;gBACV,SAAS,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;gBACvC,QAAQ,EAAE,OAAO,EAAE,CAAC;gBACpB,KAAK,CAAC,OAAO,EAAE,CAAC;gBAChB,IAAI,IAAI,CAAC,WAAW,KAAK,OAAO;oBAAE,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;YAChE,CAAC;QACF,CAAC,CAAC,EAAE,CAAC;IACN,CAAC;IAED,wFAAwF;IACxF,gBAAgB,CACf,QAA8B,EAC9B,KAAkB,EAClB,eAA0C,EAC1C,IAAgB,EAChB,qBAA+E,EAC/E,aAAsB;QAEtB,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC;QAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACvB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACzB,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;QACjD,IAAI,CAAC;YACJ,UAAU,CAAC,MAAM,CAChB,QAAQ,EACR,CAAC,OAAO,EAAE,EAAE;gBACX,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;gBACtC,IAAI,OAAO,IAAI,eAAe;oBAAE,KAAK,CAAC,WAAW,GAAG,eAAe,CAAC;gBACpE,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,QAAQ;oBAAE,KAAK,CAAC,OAAO,GAAG,CAAC,KAAK,KAAK,IAAI,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC;gBACtF,IAAI,CAAC;oBACJ,IAAI,EAAE,CAAC;gBACR,CAAC;wBAAS,CAAC;oBACV,KAAK,CAAC,WAAW,GAAG,WAAW,CAAC;gBACjC,CAAC;YACF,CAAC,EACD,aAAa,CACb,CAAC;YACF,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;YAClF,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,QAAQ;gBACjC,KAAK,CAAC,OAAO,GAAG,CAAC,KAAK,KAAK,IAAI,CAAC,IAAI,CAAC,KAAK,UAAU,CAAC,QAAQ,CAAC;YAC/D,IAAI,UAAU,CAAC,QAAQ,EAAE,CAAC;gBACzB,IAAI,eAAe;oBAAE,KAAK,CAAC,WAAW,GAAG,eAAe,CAAC;gBACzD,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBACnC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;gBACnC,qBAAqB,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;gBAC1C,IAAI,CAAC,aAAa,EAAE,OAAO,EAAE,CAAC;gBAC9B,IAAI,CAAC,aAAa,GAAG,UAAU,CAAC;gBAChC,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;gBACvB,IAAI,EAAE,CAAC;YACR,CAAC;YACD,OAAO,IAAI,CAAC;QACb,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,OAAO,CAAC,IAAI,CAAC,+CAA+C,EAAE,KAAK,CAAC,CAAC;YACrE,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC;YACtB,IAAI,CAAC,UAAU,EAAE,CAAC;YAClB,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC;YACtB,qBAAqB,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,IAAI,KAAK,CAAC,CAAC;YAChD,OAAO,KAAK,CAAC;QACd,CAAC;IACF,CAAC;CACD","sourcesContent":["import * as THREE from 'three/webgpu';\nimport { PresentationReadiness } from './PresentationReadiness.js';\nimport type { EnvironmentCache, PreparedEnvironment } from '../catalog/EnvironmentCache.js';\nimport type {\n\tSpatialElementAssetInstance,\n\tSpatialElementAssetManager\n} from '../catalog/assets/SpatialElementAssetManager.js';\nimport type { PreparedHigh } from '../catalog/CatalogPreparation.js';\nimport { SpatialElementRefinement } from './SpatialElementRefinement.js';\nimport { prepareSpatialElementFrame } from './spatialElementFrame.js';\nimport type { resolveStageProfile } from './resolveStageProfile.js';\nimport {\n\tapplyModelMaterialOverrides,\n\tcenterAndScale,\n\tdisposeMaterialOnly,\n\tgetMeshBounds,\n\tgetMeshMaterials,\n\tisMesh\n} from './stageSceneUtils.js';\n\ntype Profile = ReturnType<typeof resolveStageProfile>;\ntype RefinementState = 'unavailable' | 'loading' | 'decoded' | 'refining' | 'high' | 'failed';\ninterface HeroTransfer {\n\tmodel: THREE.Object3D;\n\tlow?: THREE.Object3D;\n\tbounds?: THREE.Box3;\n\tinstance?: SpatialElementAssetInstance;\n\thigh?: PreparedHigh;\n\tprofile?: Profile;\n\toverrides: Set<THREE.Material>;\n\trefinement?: SpatialElementRefinement;\n\tblend?: SpatialElementRefinement;\n\tstate: RefinementState;\n}\n\n/** Renderer-independent ownership of one hero's representations. Captures transfer, never borrow. */\nexport class SpatialElementPresentationController {\n\tgetRenderTargets() {\n\t\treturn [...new Set([this.blend, this.retainedBlend, this.movingBlend])].flatMap(\n\t\t\t(blend) => blend?.getRenderTargets() ?? []\n\t\t);\n\t}\n\treadonly readiness = new PresentationReadiness();\n\tprivate environmentLease?: ReturnType<EnvironmentCache['acquire']>;\n\tprivate readonly finalizedTransfers = new WeakSet<HeroTransfer>();\n\tprivate generation = 0;\n\tprivate request?: AbortController;\n\tprivate highRequest?: AbortController;\n\tprivate profile?: Profile;\n\tprivate value?: THREE.Object3D;\n\tprivate low?: THREE.Object3D;\n\tprivate bounds?: THREE.Box3;\n\tprivate instance?: SpatialElementAssetInstance;\n\tprivate high?: PreparedHigh;\n\tprivate overrides = new Set<THREE.Material>();\n\tprivate blend?: SpatialElementRefinement;\n\tprivate movingBlend?: SpatialElementRefinement;\n\tprivate retainedBlend?: SpatialElementRefinement;\n\tprivate state: RefinementState = 'unavailable';\n\tprivate frames = 0;\n\n\tconstructor(\n\t\tprivate readonly assets: Pick<SpatialElementAssetManager, 'acquire'>,\n\t\tprivate readonly changed: () => void\n\t) {}\n\n\tget model() {\n\t\treturn this.value;\n\t}\n\tget lowModel() {\n\t\treturn this.low;\n\t}\n\tget referenceBounds() {\n\t\treturn this.bounds;\n\t}\n\tget modelKey() {\n\t\treturn this.value ? this.profile?.modelKey : undefined;\n\t}\n\tget highPose() {\n\t\treturn this.high?.pose;\n\t}\n\tget refinement() {\n\t\treturn this.blend;\n\t}\n\tget refinementState() {\n\t\treturn this.state;\n\t}\n\tget refinementFrames() {\n\t\treturn this.frames;\n\t}\n\tget assetInstance() {\n\t\treturn this.instance;\n\t}\n\tget highInstance() {\n\t\treturn this.high?.instance;\n\t}\n\tget catalogBlend() {\n\t\treturn this.movingBlend;\n\t}\n\tget returnBlend() {\n\t\treturn this.retainedBlend;\n\t}\n\n\tretainEnvironment(cache: EnvironmentCache, environment: PreparedEnvironment) {\n\t\tconst next = cache.acquire(environment.url);\n\t\tthis.environmentLease?.release();\n\t\tthis.environmentLease = next;\n\t}\n\n\tdisposeEnvironment() {\n\t\tthis.environmentLease?.release();\n\t\tthis.environmentLease = undefined;\n\t}\n\n\tmarkRefinement(state: RefinementState, frames = this.frames) {\n\t\tthis.state = state;\n\t\tthis.frames = frames;\n\t}\n\n\tfinishHandoff(synchronous: boolean) {\n\t\tif (synchronous && this.high && this.state !== 'high') this.blend = new SpatialElementRefinement(true);\n\t\tif (this.movingBlend && this.high) {\n\t\t\tthis.retainedBlend?.dispose();\n\t\t\tthis.retainedBlend = this.movingBlend;\n\t\t} else this.movingBlend?.dispose();\n\t\tthis.movingBlend = undefined;\n\t}\n\n\ttakeHigh() {\n\t\tconst high = this.high;\n\t\tthis.high = undefined;\n\t\tthis.movingBlend = undefined;\n\t\treturn high;\n\t}\n\n\trestoreHigh(high: PreparedHigh) {\n\t\tthis.high = high;\n\t\tthis.retainedBlend = high.blend;\n\t\tthis.state = 'high';\n\t}\n\n\ttakeLowInstance() {\n\t\tconst low = this.instance;\n\t\tthis.instance = undefined;\n\t\treturn low;\n\t}\n\trestoreLowInstance(low?: SpatialElementAssetInstance) {\n\t\tthis.instance = low;\n\t}\n\n\ttakeHero(): HeroTransfer | undefined {\n\t\tif (!this.value) return;\n\t\tconst transfer: HeroTransfer = {\n\t\t\tmodel: this.value,\n\t\t\tlow: this.low,\n\t\t\tbounds: this.bounds,\n\t\t\tinstance: this.instance,\n\t\t\thigh: this.high,\n\t\t\tprofile: this.profile,\n\t\t\toverrides: this.overrides,\n\t\t\trefinement: this.blend,\n\t\t\tblend: this.retainedBlend ?? this.movingBlend ?? this.blend,\n\t\t\tstate: this.state\n\t\t};\n\t\tthis.value = this.low = undefined;\n\t\tthis.bounds = undefined;\n\t\tthis.instance = undefined;\n\t\tthis.high = undefined;\n\t\tthis.profile = undefined;\n\t\tthis.overrides = new Set();\n\t\tthis.blend = this.retainedBlend = this.movingBlend = undefined;\n\t\treturn transfer;\n\t}\n\n\trestoreHero(transfer: HeroTransfer) {\n\t\tif (this.finalizedTransfers.has(transfer)) return;\n\t\tif (this.value) throw new Error('Cannot restore over a live presentation');\n\t\tthis.finalizedTransfers.add(transfer);\n\t\tthis.value = transfer.model;\n\t\tthis.low = transfer.low;\n\t\tthis.bounds = transfer.bounds;\n\t\tthis.instance = transfer.instance;\n\t\tthis.high = transfer.high;\n\t\tthis.profile = transfer.profile;\n\t\tthis.overrides = transfer.overrides;\n\t\tthis.blend = transfer.refinement;\n\t\tthis.retainedBlend = transfer.blend !== transfer.refinement ? transfer.blend : undefined;\n\t\tthis.state = transfer.state;\n\t}\n\n\t/** The capture owns/disposes its blend separately. */\n\tdisposeTransfer(transfer: HeroTransfer) {\n\t\tif (this.finalizedTransfers.has(transfer)) return;\n\t\tthis.finalizedTransfers.add(transfer);\n\t\tif (transfer.refinement !== transfer.blend) transfer.refinement?.dispose();\n\t\ttransfer.overrides.forEach(disposeMaterialOnly);\n\t\ttransfer.high?.overrides.forEach(disposeMaterialOnly);\n\t\ttransfer.instance?.dispose();\n\t\ttransfer.high?.instance.dispose();\n\t}\n\n\t/** Page replacement cancels work, not resources already transferred to a capture. */\n\tcancelRequests() {\n\t\tthis.generation++;\n\t\tthis.request?.abort();\n\t\tthis.request = undefined;\n\t\tthis.cancelHigh();\n\t}\n\n\tcancelHigh() {\n\t\tthis.highRequest?.abort();\n\t\tthis.highRequest = undefined;\n\t\tthis.blend?.dispose();\n\t\tthis.blend = undefined;\n\t\tif (this.state !== 'high') {\n\t\t\tif (this.value)\n\t\t\t\tfor (const child of this.value.children) child.visible = child !== this.high?.pose;\n\t\t\tthis.releaseHigh();\n\t\t\tthis.state = 'unavailable';\n\t\t}\n\t}\n\n\tprivate releaseHigh() {\n\t\tthis.high?.pose.removeFromParent();\n\t\tthis.high?.overrides.forEach(disposeMaterialOnly);\n\t\tthis.high?.instance.dispose();\n\t\tthis.high = undefined;\n\t}\n\n\trelease() {\n\t\tthis.retainedBlend?.dispose();\n\t\tthis.movingBlend?.dispose();\n\t\tthis.retainedBlend = this.movingBlend = undefined;\n\t\tthis.cancelRequests();\n\t\tthis.releaseHigh();\n\t\tthis.value?.removeFromParent();\n\t\tthis.overrides.forEach(disposeMaterialOnly);\n\t\tthis.overrides.clear();\n\t\tthis.instance?.dispose();\n\t\tthis.instance = undefined;\n\t\tthis.value = this.low = undefined;\n\t\tthis.bounds = undefined;\n\t\tthis.profile = undefined;\n\t\tthis.state = 'unavailable';\n\t}\n\n\tasync load(profile: Profile) {\n\t\tthis.cancelRequests();\n\t\tconst generation = this.generation;\n\t\tconst request = (this.request = new AbortController());\n\t\tconst lease = this.assets.acquire(\n\t\t\tprofile.lodPair?.low ?? {\n\t\t\t\turl: profile.glb,\n\t\t\t\tformat: 'glb',\n\t\t\t\trevision: 'legacy-unversioned',\n\t\t\t\trequirements: { decoders: ['draco'], extensions: [] }\n\t\t\t},\n\t\t\t{ signal: request.signal }\n\t\t);\n\t\tlet instance: SpatialElementAssetInstance;\n\t\ttry {\n\t\t\tinstance = await lease.createInstance();\n\t\t} catch (error) {\n\t\t\tif (request.signal.aborted) return;\n\t\t\tthrow error;\n\t\t} finally {\n\t\t\tlease.release();\n\t\t\tif (this.request === request) this.request = undefined;\n\t\t}\n\t\tif (generation !== this.generation || request.signal.aborted) {\n\t\t\tinstance.dispose();\n\t\t\treturn;\n\t\t}\n\t\tthis.release();\n\t\tthis.profile = profile;\n\t\tthis.instance = instance;\n\t\tconst model = (this.value = new THREE.Group());\n\t\tif (profile.lodPair)\n\t\t\tthis.bounds = prepareSpatialElementFrame(model, instance.scene, profile.lodPair, profile.model);\n\t\telse {\n\t\t\tmodel.add(instance.scene);\n\t\t\tconst rotation = profile.model.rotation;\n\t\t\tif (rotation)\n\t\t\t\tinstance.scene.rotation.set(\n\t\t\t\t\tinstance.scene.rotation.x + (rotation.x ?? 0),\n\t\t\t\t\tinstance.scene.rotation.y + (rotation.y ?? 0),\n\t\t\t\t\tinstance.scene.rotation.z + (rotation.z ?? 0),\n\t\t\t\t\tinstance.scene.rotation.order\n\t\t\t\t);\n\t\t}\n\t\tapplyModelMaterialOverrides(instance.scene, profile.model.materialOverrides);\n\t\tinstance.scene.traverse((object) => {\n\t\t\tif (isMesh(object) && profile.model.materialOverrides?.[object.name])\n\t\t\t\tgetMeshMaterials(object).forEach((material) => this.overrides.add(material));\n\t\t});\n\t\tif (!profile.lodPair)\n\t\t\tcenterAndScale(model, (mesh) => !profile.model.excludeMeshes?.includes(mesh.name));\n\t\tthis.low = model.clone(true);\n\t\treturn model;\n\t}\n\n\tadoptHigh(high: PreparedHigh, moving: boolean) {\n\t\tif (!this.value || this.high) return false;\n\t\tthis.high = high;\n\t\tthis.value.add(high.pose);\n\t\thigh.pose.visible = false;\n\t\tthis.state = 'decoded';\n\t\tif (moving) this.movingBlend = high.blend;\n\t\telse {\n\t\t\thigh.blend.restart();\n\t\t\tthis.blend = high.blend;\n\t\t}\n\t\tthis.changed();\n\t\treturn true;\n\t}\n\n\tstartHigh() {\n\t\tconst profile = this.profile;\n\t\tconst pair = profile?.lodPair;\n\t\tconst model = this.value;\n\t\tif (!profile || !pair || !model || this.highRequest || this.high || this.state === 'failed')\n\t\t\treturn;\n\t\tconst request = (this.highRequest = new AbortController());\n\t\tthis.state = 'loading';\n\t\tthis.frames = 0;\n\t\tconst lease = this.assets.acquire(pair.high, { signal: request.signal });\n\t\tvoid (async () => {\n\t\t\tlet instance: SpatialElementAssetInstance | undefined;\n\t\t\tconst overrides = new Set<THREE.Material>();\n\t\t\ttry {\n\t\t\t\tinstance = await lease.createInstance();\n\t\t\t\tif (request.signal.aborted || this.value !== model) return;\n\t\t\t\tapplyModelMaterialOverrides(instance.scene, profile.model.materialOverrides);\n\t\t\t\tinstance.scene.traverse((object) => {\n\t\t\t\t\tif (isMesh(object) && profile.model.materialOverrides?.[object.name])\n\t\t\t\t\t\tgetMeshMaterials(object).forEach((material) => overrides.add(material));\n\t\t\t\t});\n\t\t\t\tconst container = new THREE.Group();\n\t\t\t\tprepareSpatialElementFrame(container, instance.scene, pair, profile.model);\n\t\t\t\tif (\n\t\t\t\t\tgetMeshBounds(\n\t\t\t\t\t\tcontainer,\n\t\t\t\t\t\t(mesh) => !profile.model.excludeMeshes?.includes(mesh.name)\n\t\t\t\t\t).isEmpty()\n\t\t\t\t)\n\t\t\t\t\tthrow new Error('High contains no spatialElement meshes');\n\t\t\t\tthis.adoptHigh(\n\t\t\t\t\t{\n\t\t\t\t\t\tinstance,\n\t\t\t\t\t\tpose: container.children[0],\n\t\t\t\t\t\toverrides: new Set(overrides),\n\t\t\t\t\t\tblend: new SpatialElementRefinement(true)\n\t\t\t\t\t},\n\t\t\t\t\tfalse\n\t\t\t\t);\n\t\t\t\tinstance = undefined;\n\t\t\t\toverrides.clear();\n\t\t\t} catch (error) {\n\t\t\t\tif (!request.signal.aborted && this.value === model) {\n\t\t\t\t\tthis.state = 'failed';\n\t\t\t\t\tconsole.warn('Optional High loading failed; retaining Low', error);\n\t\t\t\t}\n\t\t\t} finally {\n\t\t\t\toverrides.forEach(disposeMaterialOnly);\n\t\t\t\tinstance?.dispose();\n\t\t\t\tlease.release();\n\t\t\t\tif (this.highRequest === request) this.highRequest = undefined;\n\t\t\t}\n\t\t})();\n\t}\n\n\t/** Returns false when the ordinary single-representation pass should render instead. */\n\trenderRefinement(\n\t\trenderer: THREE.WebGPURenderer,\n\t\tscene: THREE.Scene,\n\t\thighEnvironment: THREE.Texture | undefined,\n\t\tdraw: () => void,\n\t\trepresentationChanged: (model: THREE.Object3D, outline: THREE.Object3D) => void,\n\t\treducedMotion: boolean\n\t) {\n\t\tconst refinement = this.blend;\n\t\tconst high = this.high;\n\t\tconst model = this.value;\n\t\tif (!refinement || !high || !model) return false;\n\t\ttry {\n\t\t\trefinement.render(\n\t\t\t\trenderer,\n\t\t\t\t(useHigh) => {\n\t\t\t\t\tconst environment = scene.environment;\n\t\t\t\t\tif (useHigh && highEnvironment) scene.environment = highEnvironment;\n\t\t\t\t\tfor (const child of model.children) child.visible = (child === high.pose) === useHigh;\n\t\t\t\t\ttry {\n\t\t\t\t\t\tdraw();\n\t\t\t\t\t} finally {\n\t\t\t\t\t\tscene.environment = environment;\n\t\t\t\t\t}\n\t\t\t\t},\n\t\t\t\treducedMotion\n\t\t\t);\n\t\t\tthis.markRefinement(refinement.complete ? 'high' : 'refining', refinement.frames);\n\t\t\tfor (const child of model.children)\n\t\t\t\tchild.visible = (child === high.pose) === refinement.complete;\n\t\t\tif (refinement.complete) {\n\t\t\t\tif (highEnvironment) scene.environment = highEnvironment;\n\t\t\t\tconst outline = model.clone(false);\n\t\t\t\toutline.add(high.pose.clone(true));\n\t\t\t\trepresentationChanged(high.pose, outline);\n\t\t\t\tthis.retainedBlend?.dispose();\n\t\t\t\tthis.retainedBlend = refinement;\n\t\t\t\tthis.blend = undefined;\n\t\t\t\tdraw();\n\t\t\t}\n\t\t\treturn true;\n\t\t} catch (error) {\n\t\t\tconsole.warn('Optional High rendering failed; retaining Low', error);\n\t\t\tthis.state = 'failed';\n\t\t\tthis.cancelHigh();\n\t\t\tthis.state = 'failed';\n\t\t\trepresentationChanged(model, this.low ?? model);\n\t\t\treturn false;\n\t\t}\n\t}\n}\n"]}
1
+ {"version":3,"file":"SpatialElementPresentationController.js","sourceRoot":"","sources":["../../src/stage/SpatialElementPresentationController.ts"],"names":[],"mappings":"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","sourcesContent":["import * as THREE from 'three/webgpu';\nimport { PresentationReadiness } from './PresentationReadiness.js';\nimport type { EnvironmentCache, PreparedEnvironment } from '../catalog/EnvironmentCache.js';\nimport type {\n\tSpatialElementAssetInstance,\n\tSpatialElementAssetManager\n} from '../catalog/assets/SpatialElementAssetManager.js';\nimport type { PreparedHigh } from '../catalog/CatalogPreparation.js';\nimport { SpatialElementRefinement, type RefinementRenderOptions } from './SpatialElementRefinement.js';\nimport { createSceneEndpointGuard } from './sceneEndpointEligibility.js';\nimport { prepareSpatialElementFrame } from './spatialElementFrame.js';\nimport type { resolveStageProfile } from './resolveStageProfile.js';\nimport {\n\tapplyModelMaterialOverrides,\n\tcenterAndScale,\n\tdisposeMaterialOnly,\n\tgetMeshBounds,\n\tgetMeshMaterials,\n\tisMesh\n} from './stageSceneUtils.js';\n\ntype Profile = ReturnType<typeof resolveStageProfile>;\ntype RefinementState = 'unavailable' | 'loading' | 'decoded' | 'refining' | 'high' | 'failed';\ninterface HeroTransfer {\n\tmodel: THREE.Object3D;\n\tlow?: THREE.Object3D;\n\tbounds?: THREE.Box3;\n\tinstance?: SpatialElementAssetInstance;\n\thigh?: PreparedHigh;\n\tprofile?: Profile;\n\toverrides: Set<THREE.Material>;\n\trefinement?: SpatialElementRefinement;\n\tblend?: SpatialElementRefinement;\n\tstate: RefinementState;\n}\n\n/** Renderer-independent ownership of one hero's representations. Captures transfer, never borrow. */\nexport class SpatialElementPresentationController {\n\tgetRenderTargets() {\n\t\treturn [...new Set([this.blend, this.retainedBlend, this.movingBlend])].flatMap(\n\t\t\t(blend) => blend?.getRenderTargets() ?? []\n\t\t);\n\t}\n\tgetSceneEndpointStats() {\n\t\treturn [...new Set([this.blend, this.retainedBlend, this.movingBlend])].flatMap(blend => blend ? [blend.getSceneEndpointStats()] : []);\n\t}\n\tinvalidateSceneEndpoints() {\n\t\tfor (const blend of new Set([this.blend, this.retainedBlend, this.movingBlend])) blend?.invalidateSceneEndpoints();\n\t}\n\tprepareSceneEndpoints(renderer: THREE.WebGPURenderer, scene: THREE.Scene, camera: THREE.Camera,\n\t\thighEnvironment: THREE.Texture | undefined, draw: (backgroundReveal: number) => void, ownerIsCurrent: () => boolean,\n\t\tadditionalScenes: readonly THREE.Scene[] = [], additionalCameras: readonly THREE.Camera[] = []) {\n\t\tconst refinement = this.blend, high = this.high, model = this.value, low = this.instance?.scene;\n\t\tif (!refinement || !high || !model || !low || this.instance?.animations.length || high.instance.animations.length) return;\n\t\tconst guard = createSceneEndpointGuard({ scene, camera, model, low, high: high.pose, highEnvironment, additionalScenes, additionalCameras });\n\t\tif (!guard) return;\n\t\treturn refinement.prepareSceneEndpoints(renderer, (useHigh, backgroundReveal) => {\n\t\t\tconst environment = scene.environment;\n\t\t\tconst visible = model.children.map(child => child.visible);\n\t\t\tif (useHigh && highEnvironment) scene.environment = highEnvironment;\n\t\t\tmodel.children.forEach(child => { child.visible = (child === high.pose) === useHigh; });\n\t\t\ttry { draw(backgroundReveal); }\n\t\t\tfinally { scene.environment = environment; model.children.forEach((child, i) => { child.visible = visible[i]; }); }\n\t\t}, {\n\t\t\tisValid: () => this.blend === refinement && this.value === model && this.high === high && ownerIsCurrent() && guard.isValid(),\n\t\t\tdispose: () => guard.dispose()\n\t\t});\n\t}\n\treadonly readiness = new PresentationReadiness();\n\tprivate environmentLease?: ReturnType<EnvironmentCache['acquire']>;\n\tprivate readonly finalizedTransfers = new WeakSet<HeroTransfer>();\n\tprivate generation = 0;\n\tprivate request?: AbortController;\n\tprivate highRequest?: AbortController;\n\tprivate profile?: Profile;\n\tprivate value?: THREE.Object3D;\n\tprivate low?: THREE.Object3D;\n\tprivate bounds?: THREE.Box3;\n\tprivate instance?: SpatialElementAssetInstance;\n\tprivate high?: PreparedHigh;\n\tprivate overrides = new Set<THREE.Material>();\n\tprivate blend?: SpatialElementRefinement;\n\tprivate movingBlend?: SpatialElementRefinement;\n\tprivate retainedBlend?: SpatialElementRefinement;\n\tprivate state: RefinementState = 'unavailable';\n\tprivate frames = 0;\n\n\tconstructor(\n\t\tprivate readonly assets: Pick<SpatialElementAssetManager, 'acquire'>,\n\t\tprivate readonly changed: () => void\n\t) {}\n\n\tget model() {\n\t\treturn this.value;\n\t}\n\tget lowModel() {\n\t\treturn this.low;\n\t}\n\tget referenceBounds() {\n\t\treturn this.bounds;\n\t}\n\tget modelKey() {\n\t\treturn this.value ? this.profile?.modelKey : undefined;\n\t}\n\tget highPose() {\n\t\treturn this.high?.pose;\n\t}\n\tget refinement() {\n\t\treturn this.blend;\n\t}\n\tget refinementState() {\n\t\treturn this.state;\n\t}\n\tget refinementFrames() {\n\t\treturn this.frames;\n\t}\n\tget assetInstance() {\n\t\treturn this.instance;\n\t}\n\tget highInstance() {\n\t\treturn this.high?.instance;\n\t}\n\tget catalogBlend() {\n\t\treturn this.movingBlend;\n\t}\n\tget returnBlend() {\n\t\treturn this.retainedBlend;\n\t}\n\n\tretainEnvironment(cache: EnvironmentCache, environment: PreparedEnvironment) {\n\t\tconst next = cache.acquire(environment.url);\n\t\tthis.environmentLease?.release();\n\t\tthis.environmentLease = next;\n\t}\n\n\tdisposeEnvironment() {\n\t\tthis.environmentLease?.release();\n\t\tthis.environmentLease = undefined;\n\t}\n\n\tmarkRefinement(state: RefinementState, frames = this.frames) {\n\t\tthis.state = state;\n\t\tthis.frames = frames;\n\t}\n\n\tfinishHandoff(synchronous: boolean) {\n\t\tthis.invalidateSceneEndpoints();\n\t\tif (synchronous && this.high && this.state !== 'high') this.blend = new SpatialElementRefinement(true);\n\t\tif (this.movingBlend && this.high) {\n\t\t\tthis.retainedBlend?.dispose();\n\t\t\tthis.retainedBlend = this.movingBlend;\n\t\t} else this.movingBlend?.dispose();\n\t\tthis.movingBlend = undefined;\n\t}\n\n\ttakeHigh() {\n\t\tthis.invalidateSceneEndpoints();\n\t\tconst high = this.high;\n\t\tthis.high = undefined;\n\t\tthis.movingBlend = undefined;\n\t\treturn high;\n\t}\n\n\trestoreHigh(high: PreparedHigh) {\n\t\tthis.high = high;\n\t\tthis.retainedBlend = high.blend;\n\t\tthis.state = 'high';\n\t}\n\n\ttakeLowInstance() {\n\t\tthis.invalidateSceneEndpoints();\n\t\tconst low = this.instance;\n\t\tthis.instance = undefined;\n\t\treturn low;\n\t}\n\trestoreLowInstance(low?: SpatialElementAssetInstance) {\n\t\tthis.instance = low;\n\t}\n\n\ttakeHero(): HeroTransfer | undefined {\n\t\tif (!this.value) return;\n\t\tthis.invalidateSceneEndpoints();\n\t\tconst transfer: HeroTransfer = {\n\t\t\tmodel: this.value,\n\t\t\tlow: this.low,\n\t\t\tbounds: this.bounds,\n\t\t\tinstance: this.instance,\n\t\t\thigh: this.high,\n\t\t\tprofile: this.profile,\n\t\t\toverrides: this.overrides,\n\t\t\trefinement: this.blend,\n\t\t\tblend: this.retainedBlend ?? this.movingBlend ?? this.blend,\n\t\t\tstate: this.state\n\t\t};\n\t\tthis.value = this.low = undefined;\n\t\tthis.bounds = undefined;\n\t\tthis.instance = undefined;\n\t\tthis.high = undefined;\n\t\tthis.profile = undefined;\n\t\tthis.overrides = new Set();\n\t\tthis.blend = this.retainedBlend = this.movingBlend = undefined;\n\t\treturn transfer;\n\t}\n\n\trestoreHero(transfer: HeroTransfer) {\n\t\tif (this.finalizedTransfers.has(transfer)) return;\n\t\tif (this.value) throw new Error('Cannot restore over a live presentation');\n\t\tthis.finalizedTransfers.add(transfer);\n\t\tthis.value = transfer.model;\n\t\tthis.low = transfer.low;\n\t\tthis.bounds = transfer.bounds;\n\t\tthis.instance = transfer.instance;\n\t\tthis.high = transfer.high;\n\t\tthis.profile = transfer.profile;\n\t\tthis.overrides = transfer.overrides;\n\t\tthis.blend = transfer.refinement;\n\t\tthis.retainedBlend = transfer.blend !== transfer.refinement ? transfer.blend : undefined;\n\t\tthis.state = transfer.state;\n\t}\n\n\t/** The capture owns/disposes its blend separately. */\n\tdisposeTransfer(transfer: HeroTransfer) {\n\t\tif (this.finalizedTransfers.has(transfer)) return;\n\t\tthis.finalizedTransfers.add(transfer);\n\t\tif (transfer.refinement !== transfer.blend) transfer.refinement?.dispose();\n\t\ttransfer.overrides.forEach(disposeMaterialOnly);\n\t\ttransfer.high?.overrides.forEach(disposeMaterialOnly);\n\t\ttransfer.instance?.dispose();\n\t\ttransfer.high?.instance.dispose();\n\t}\n\n\t/** Page replacement cancels work, not resources already transferred to a capture. */\n\tcancelRequests() {\n\t\tthis.generation++;\n\t\tthis.request?.abort();\n\t\tthis.request = undefined;\n\t\tthis.cancelHigh();\n\t}\n\n\tcancelHigh() {\n\t\tthis.highRequest?.abort();\n\t\tthis.highRequest = undefined;\n\t\tthis.blend?.dispose();\n\t\tthis.blend = undefined;\n\t\tif (this.state !== 'high') {\n\t\t\tif (this.value)\n\t\t\t\tfor (const child of this.value.children) child.visible = child !== this.high?.pose;\n\t\t\tthis.releaseHigh();\n\t\t\tthis.state = 'unavailable';\n\t\t}\n\t}\n\n\tprivate releaseHigh() {\n\t\tthis.high?.pose.removeFromParent();\n\t\tthis.high?.overrides.forEach(disposeMaterialOnly);\n\t\tthis.high?.instance.dispose();\n\t\tthis.high = undefined;\n\t}\n\n\trelease() {\n\t\tthis.retainedBlend?.dispose();\n\t\tthis.movingBlend?.dispose();\n\t\tthis.retainedBlend = this.movingBlend = undefined;\n\t\tthis.cancelRequests();\n\t\tthis.releaseHigh();\n\t\tthis.value?.removeFromParent();\n\t\tthis.overrides.forEach(disposeMaterialOnly);\n\t\tthis.overrides.clear();\n\t\tthis.instance?.dispose();\n\t\tthis.instance = undefined;\n\t\tthis.value = this.low = undefined;\n\t\tthis.bounds = undefined;\n\t\tthis.profile = undefined;\n\t\tthis.state = 'unavailable';\n\t}\n\n\tasync load(profile: Profile) {\n\t\tthis.cancelRequests();\n\t\tconst generation = this.generation;\n\t\tconst request = (this.request = new AbortController());\n\t\tconst lease = this.assets.acquire(\n\t\t\tprofile.lodPair?.low ?? {\n\t\t\t\turl: profile.glb,\n\t\t\t\tformat: 'glb',\n\t\t\t\trevision: 'legacy-unversioned',\n\t\t\t\trequirements: { decoders: ['draco'], extensions: [] }\n\t\t\t},\n\t\t\t{ signal: request.signal }\n\t\t);\n\t\tlet instance: SpatialElementAssetInstance;\n\t\ttry {\n\t\t\tinstance = await lease.createInstance();\n\t\t} catch (error) {\n\t\t\tif (request.signal.aborted) return;\n\t\t\tthrow error;\n\t\t} finally {\n\t\t\tlease.release();\n\t\t\tif (this.request === request) this.request = undefined;\n\t\t}\n\t\tif (generation !== this.generation || request.signal.aborted) {\n\t\t\tinstance.dispose();\n\t\t\treturn;\n\t\t}\n\t\tthis.release();\n\t\tthis.profile = profile;\n\t\tthis.instance = instance;\n\t\tconst model = (this.value = new THREE.Group());\n\t\tif (profile.lodPair)\n\t\t\tthis.bounds = prepareSpatialElementFrame(model, instance.scene, profile.lodPair, profile.model);\n\t\telse {\n\t\t\tmodel.add(instance.scene);\n\t\t\tconst rotation = profile.model.rotation;\n\t\t\tif (rotation)\n\t\t\t\tinstance.scene.rotation.set(\n\t\t\t\t\tinstance.scene.rotation.x + (rotation.x ?? 0),\n\t\t\t\t\tinstance.scene.rotation.y + (rotation.y ?? 0),\n\t\t\t\t\tinstance.scene.rotation.z + (rotation.z ?? 0),\n\t\t\t\t\tinstance.scene.rotation.order\n\t\t\t\t);\n\t\t}\n\t\tapplyModelMaterialOverrides(instance.scene, profile.model.materialOverrides);\n\t\tinstance.scene.traverse((object) => {\n\t\t\tif (isMesh(object) && profile.model.materialOverrides?.[object.name])\n\t\t\t\tgetMeshMaterials(object).forEach((material) => this.overrides.add(material));\n\t\t});\n\t\tif (!profile.lodPair)\n\t\t\tcenterAndScale(model, (mesh) => !profile.model.excludeMeshes?.includes(mesh.name));\n\t\tthis.low = model.clone(true);\n\t\treturn model;\n\t}\n\n\tadoptHigh(high: PreparedHigh, moving: boolean) {\n\t\tif (!this.value || this.high) return false;\n\t\tthis.high = high;\n\t\tthis.value.add(high.pose);\n\t\thigh.pose.visible = false;\n\t\tthis.state = 'decoded';\n\t\tif (moving) this.movingBlend = high.blend;\n\t\telse {\n\t\t\thigh.blend.restart();\n\t\t\tthis.blend = high.blend;\n\t\t}\n\t\tthis.changed();\n\t\treturn true;\n\t}\n\n\tstartHigh() {\n\t\tconst profile = this.profile;\n\t\tconst pair = profile?.lodPair;\n\t\tconst model = this.value;\n\t\tif (!profile || !pair || !model || this.highRequest || this.high || this.state === 'failed')\n\t\t\treturn;\n\t\tconst request = (this.highRequest = new AbortController());\n\t\tthis.state = 'loading';\n\t\tthis.frames = 0;\n\t\tconst lease = this.assets.acquire(pair.high, { signal: request.signal });\n\t\tvoid (async () => {\n\t\t\tlet instance: SpatialElementAssetInstance | undefined;\n\t\t\tconst overrides = new Set<THREE.Material>();\n\t\t\ttry {\n\t\t\t\tinstance = await lease.createInstance();\n\t\t\t\tif (request.signal.aborted || this.value !== model) return;\n\t\t\t\tapplyModelMaterialOverrides(instance.scene, profile.model.materialOverrides);\n\t\t\t\tinstance.scene.traverse((object) => {\n\t\t\t\t\tif (isMesh(object) && profile.model.materialOverrides?.[object.name])\n\t\t\t\t\t\tgetMeshMaterials(object).forEach((material) => overrides.add(material));\n\t\t\t\t});\n\t\t\t\tconst container = new THREE.Group();\n\t\t\t\tprepareSpatialElementFrame(container, instance.scene, pair, profile.model);\n\t\t\t\tif (\n\t\t\t\t\tgetMeshBounds(\n\t\t\t\t\t\tcontainer,\n\t\t\t\t\t\t(mesh) => !profile.model.excludeMeshes?.includes(mesh.name)\n\t\t\t\t\t).isEmpty()\n\t\t\t\t)\n\t\t\t\t\tthrow new Error('High contains no spatialElement meshes');\n\t\t\t\tthis.adoptHigh(\n\t\t\t\t\t{\n\t\t\t\t\t\tinstance,\n\t\t\t\t\t\tpose: container.children[0],\n\t\t\t\t\t\toverrides: new Set(overrides),\n\t\t\t\t\t\tblend: new SpatialElementRefinement(true)\n\t\t\t\t\t},\n\t\t\t\t\tfalse\n\t\t\t\t);\n\t\t\t\tinstance = undefined;\n\t\t\t\toverrides.clear();\n\t\t\t} catch (error) {\n\t\t\t\tif (!request.signal.aborted && this.value === model) {\n\t\t\t\t\tthis.state = 'failed';\n\t\t\t\t\tconsole.warn('Optional High loading failed; retaining Low', error);\n\t\t\t\t}\n\t\t\t} finally {\n\t\t\t\toverrides.forEach(disposeMaterialOnly);\n\t\t\t\tinstance?.dispose();\n\t\t\t\tlease.release();\n\t\t\t\tif (this.highRequest === request) this.highRequest = undefined;\n\t\t\t}\n\t\t})();\n\t}\n\n\t/** Returns false when the ordinary single-representation pass should render instead. */\n\trenderRefinement(\n\t\trenderer: THREE.WebGPURenderer,\n\t\tscene: THREE.Scene,\n\t\thighEnvironment: THREE.Texture | undefined,\n\t\tdraw: () => void,\n\t\trepresentationChanged: (model: THREE.Object3D, outline: THREE.Object3D) => void,\n\t\treducedMotion: boolean,\n\t\toptions: RefinementRenderOptions = {}\n\t) {\n\t\tconst refinement = this.blend;\n\t\tconst high = this.high;\n\t\tconst model = this.value;\n\t\tif (!refinement || !high || !model) return false;\n\t\tconst originalVisibility = options.advanceClock === false ? model.children.map(child => child.visible) : undefined;\n\t\ttry {\n\t\t\trefinement.render(\n\t\t\t\trenderer,\n\t\t\t\t(useHigh) => {\n\t\t\t\t\tconst environment = scene.environment;\n\t\t\t\t\tif (useHigh && highEnvironment) scene.environment = highEnvironment;\n\t\t\t\t\tfor (const child of model.children) child.visible = (child === high.pose) === useHigh;\n\t\t\t\t\ttry {\n\t\t\t\t\t\tdraw();\n\t\t\t\t\t} finally {\n\t\t\t\t\t\tscene.environment = environment;\n\t\t\t\t\t}\n\t\t\t\t},\n\t\t\t\treducedMotion,\n\t\t\t\tundefined,\n\t\t\t\toptions\n\t\t\t);\n\t\t\tif (options.advanceClock === false) return true;\n\t\t\tthis.markRefinement(refinement.complete ? 'high' : 'refining', refinement.frames);\n\t\t\tfor (const child of model.children)\n\t\t\t\tchild.visible = (child === high.pose) === refinement.complete;\n\t\t\tif (refinement.complete) {\n\t\t\t\trefinement.invalidateSceneEndpoints();\n\t\t\t\tif (highEnvironment) scene.environment = highEnvironment;\n\t\t\t\tconst outline = model.clone(false);\n\t\t\t\toutline.add(high.pose.clone(true));\n\t\t\t\trepresentationChanged(high.pose, outline);\n\t\t\t\tthis.retainedBlend?.dispose();\n\t\t\t\tthis.retainedBlend = refinement;\n\t\t\t\tthis.blend = undefined;\n\t\t\t\tdraw();\n\t\t\t}\n\t\t\treturn true;\n\t\t} catch (error) {\n\t\t\tconsole.warn('Optional High rendering failed; retaining Low', error);\n\t\t\tthis.state = 'failed';\n\t\t\tthis.cancelHigh();\n\t\t\tthis.state = 'failed';\n\t\t\trepresentationChanged(model, this.low ?? model);\n\t\t\treturn false;\n\t\t} finally {\n\t\t\tif (originalVisibility) model.children.forEach((child, i) => { child.visible = originalVisibility[i]; });\n\t\t}\n\t}\n}\n"]}
@@ -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();