@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
@@ -1,26 +1,35 @@
1
1
  import * as THREE from 'three/webgpu';
2
2
  import { OrbitControls } from 'three/addons/controls/OrbitControls.js';
3
3
  import type { Mesh } from 'three';
4
- import { type SpaceMouseNavigationUpdate } from './SpaceMouseAdapter.js';
4
+ import type { SpaceMouseNavigationUpdate } from './SpaceMouseAdapter.js';
5
+ import type { SpatialElementMediaItem } from '../spatial-element/types.js';
5
6
  export interface SpatialElementInteractionPorts {
7
+ onSpaceMouseStateChange?: (state: import("./spaceMousePlatform.js").SpaceMouseState) => void;
6
8
  camera: THREE.PerspectiveCamera;
7
9
  canvas: HTMLCanvasElement;
8
10
  container: HTMLElement;
9
11
  cssRoot: HTMLElement;
10
12
  requestRender(): void;
11
- markActivity(): void;
12
13
  updateProjection(): void;
13
14
  readGeometry(): {
14
15
  poseOwner: 'page' | 'transition' | 'none';
15
16
  visible: boolean;
16
17
  viewport: THREE.Vector4;
17
18
  bounds: THREE.Box3;
19
+ detail?: {
20
+ media: SpatialElementMediaItem['kind'];
21
+ split: boolean;
22
+ paneHidden: boolean;
23
+ paneLeft: number;
24
+ };
18
25
  };
19
26
  }
20
27
  /** Owns user navigation state; consumes the facade clock and never creates a RAF loop. */
21
28
  export declare class SpatialElementInteractionController {
22
29
  private readonly ports;
23
30
  private disposed;
31
+ private fullscreen;
32
+ setFullscreen(fullscreen: boolean): void;
24
33
  constructor(ports: SpatialElementInteractionPorts);
25
34
  private get camera();
26
35
  private get backgroundCanvas();
@@ -54,9 +63,17 @@ export declare class SpatialElementInteractionController {
54
63
  private _controls?;
55
64
  private _spaceMouse?;
56
65
  private _spaceMouseConnecting;
66
+ private spaceMouseGeneration;
67
+ private spaceMouseAbort?;
57
68
  private _spaceMouseMoving;
58
69
  private _modelHover;
59
70
  private _modelInteractionActive;
71
+ private readonly _interactionPointers;
72
+ private readonly guidance;
73
+ private readonly preview;
74
+ private reducedMotion?;
75
+ private stopGuidance?;
76
+ private readonly motionPreferenceChanged;
60
77
  private _focusRestDistance;
61
78
  private _focusCloseDistance;
62
79
  private _zoomResetTargetDistance?;
@@ -76,6 +93,7 @@ export declare class SpatialElementInteractionController {
76
93
  resetView(): void;
77
94
  createControls(): OrbitControls<THREE.PerspectiveCamera>;
78
95
  initializeSpaceMouse(): Promise<void>;
96
+ disconnectSpaceMouse(): void;
79
97
  getSpaceMouseViewFrustum(): number[];
80
98
  applySpaceMouseNavigationUpdate(update: SpaceMouseNavigationUpdate): void;
81
99
  setSpaceMouseMoving(moving: boolean): void;
@@ -83,6 +101,9 @@ export declare class SpatialElementInteractionController {
83
101
  handlePointerMove(event: PointerEvent): void;
84
102
  handlePointerDown(event: PointerEvent): void;
85
103
  handlePointerUp(event: PointerEvent): void;
104
+ handleTouchStart(event: TouchEvent): void;
105
+ handlePointerContact(event: PointerEvent): void;
106
+ private clearPointerHover;
86
107
  handleWheel(event: WheelEvent): void;
87
108
  requestScrollZoomReset(scrollDelta: number): void;
88
109
  applyZoomReset(delta: number): void;
@@ -98,6 +119,7 @@ export declare class SpatialElementInteractionController {
98
119
  hitTestModel(clientX: number, clientY: number, target: EventTarget | null): boolean;
99
120
  isPointerOccludedByHtml(clientX: number, clientY: number): boolean;
100
121
  setModelHover(hover: boolean): void;
122
+ private notifyModelInput;
101
123
  updateControlsAvailability(): void;
102
124
  getZoomFocusFactor(): number;
103
125
  getZoomReferenceTarget(): THREE.Vector3;
@@ -1 +1 @@
1
- {"version":3,"file":"SpatialElementInteractionController.d.ts","sourceRoot":"","sources":["../../src/stage/SpatialElementInteractionController.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"SpatialElementInteractionController.d.ts","sourceRoot":"","sources":["../../src/stage/SpatialElementInteractionController.ts"],"names":[],"mappings":"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"}
@@ -4,12 +4,26 @@ import { recreateOrbitControlsForExternalNavigation } from './OrbitControlsInter
4
4
  import { WHEEL_ZOOM_DAMPING, ZOOM_RESET_DAMPING } from './stageConstants.js';
5
5
  import { isStageUiTarget } from './stageDom.js';
6
6
  import { getCameraZoomFocus, getCameraZoomReferenceDistance, getEffectiveCameraDistance, getWheelZoomTargetDistance, normalizeWheelZoomDelta, getViewResetDuration, getViewResetInterpolation } from './stageMath.js';
7
- import { SpaceMouseAdapter } from './SpaceMouseAdapter.js';
8
7
  import { dampAndSnap } from './damping.js';
8
+ import { getInteractionGuidance, MODEL_INPUT_EVENT } from './interactionGuidance.js';
9
+ import { ModelPointerPreview } from './ModelPointerPreview.js';
10
+ import { resolveDetailGestureOwner } from '../spatial-element/spatialElementMedia.js';
9
11
  /** Owns user navigation state; consumes the facade clock and never creates a RAF loop. */
10
12
  export class SpatialElementInteractionController {
11
13
  ports;
12
14
  disposed = false;
15
+ fullscreen = false;
16
+ setFullscreen(fullscreen) {
17
+ this.fullscreen = fullscreen;
18
+ this.clearWheelZoom();
19
+ this._viewResetActive = false;
20
+ this.preview.clear();
21
+ this._pointer.active = false;
22
+ this.setModelHover(false);
23
+ this.clearZoomReset();
24
+ this.updateControlsAvailability();
25
+ this.requestRender();
26
+ }
13
27
  constructor(ports) {
14
28
  this.ports = ports;
15
29
  this._initialCameraFov = this._viewResetStartFov = ports.camera.fov;
@@ -43,21 +57,32 @@ export class SpatialElementInteractionController {
43
57
  }
44
58
  initialize() {
45
59
  this._controls = this.createControls();
60
+ this.reducedMotion = typeof window === 'undefined' ? undefined : window.matchMedia?.('(prefers-reduced-motion: reduce)');
61
+ this.reducedMotion?.addEventListener('change', this.motionPreferenceChanged);
62
+ this.stopGuidance = this.guidance.subscribe((state) => {
63
+ if (state.interacted)
64
+ this.preview.forget();
65
+ });
46
66
  }
47
67
  releasePage() {
68
+ this.preview.forget();
69
+ this._interactionPointers.clear();
70
+ this._pointer.active = false;
48
71
  this.clearWheelZoom();
49
72
  this._zoomResetTargetDistance = undefined;
50
73
  this._viewResetActive = false;
51
74
  this._modelHover = this._modelInteractionActive = false;
75
+ this.notifyModelInput();
52
76
  if (!this.disposed)
53
77
  this.recreateOrbitControls();
54
78
  }
55
79
  dispose() {
56
80
  this.disposed = true;
81
+ this.stopGuidance?.();
82
+ this.reducedMotion?.removeEventListener('change', this.motionPreferenceChanged);
57
83
  this._controls?.removeEventListener('change', this._controlsChange);
58
84
  this._controls?.dispose();
59
- this._spaceMouse?.dispose();
60
- this._spaceMouse = undefined;
85
+ this.disconnectSpaceMouse();
61
86
  }
62
87
  captureInitialView() {
63
88
  if (!this._controls)
@@ -66,6 +91,8 @@ export class SpatialElementInteractionController {
66
91
  this._initialControlsTarget.copy(this._controls.target);
67
92
  this._initialCameraFov = this.camera.fov;
68
93
  this._initialViewCaptured = true;
94
+ if (!this.guidance.snapshot.interacted)
95
+ this.preview.capture(this.camera, this._controls.target);
69
96
  }
70
97
  setFocusRange(rest, close) {
71
98
  this._focusRestDistance = rest;
@@ -97,9 +124,20 @@ export class SpatialElementInteractionController {
97
124
  _controls;
98
125
  _spaceMouse;
99
126
  _spaceMouseConnecting = false;
127
+ spaceMouseGeneration = 0;
128
+ spaceMouseAbort;
100
129
  _spaceMouseMoving = false;
101
130
  _modelHover = false;
102
131
  _modelInteractionActive = false;
132
+ _interactionPointers = new Map();
133
+ guidance = getInteractionGuidance();
134
+ preview = new ModelPointerPreview();
135
+ reducedMotion;
136
+ stopGuidance;
137
+ motionPreferenceChanged = () => {
138
+ this.preview.clear();
139
+ this.requestRender();
140
+ };
103
141
  _focusRestDistance = 1;
104
142
  _focusCloseDistance = 0.4;
105
143
  _zoomResetTargetDistance;
@@ -119,6 +157,7 @@ export class SpatialElementInteractionController {
119
157
  resetView() {
120
158
  if (!this._controls || !this._initialViewCaptured)
121
159
  return;
160
+ this.guidance.interact();
122
161
  this.clearWheelZoom();
123
162
  this.clearZoomReset();
124
163
  this._viewResetStartCameraPosition.copy(this.camera.position);
@@ -136,7 +175,9 @@ export class SpatialElementInteractionController {
136
175
  controls.zoomToCursor = true;
137
176
  controls.enabled = false;
138
177
  controls.addEventListener('change', this._controlsChange);
139
- this.backgroundCanvas.style.touchAction = 'pan-y';
178
+ // Gesture policy is stable before contact. Touch Events claim only gestures
179
+ // that start on the model; empty canvas keeps native pan/pinch behavior.
180
+ this.backgroundCanvas.style.touchAction = 'manipulation';
140
181
  return controls;
141
182
  }
142
183
  async initializeSpaceMouse() {
@@ -147,33 +188,62 @@ export class SpatialElementInteractionController {
147
188
  this.disposed)
148
189
  return;
149
190
  this._spaceMouseConnecting = true;
150
- const adapter = await SpaceMouseAdapter.connect({
151
- viewport: this.backgroundCanvas,
152
- applicationName: 'Spatial Panels SpatialElement Viewer',
153
- getViewMatrix: () => {
154
- this.camera.updateMatrixWorld(true);
155
- return [...this.camera.matrixWorld.elements];
156
- },
157
- getFov: () => THREE.MathUtils.degToRad(this.camera.fov),
158
- getViewFrustum: () => this.getSpaceMouseViewFrustum(),
159
- getViewTarget: () => this._controls?.target.toArray() ?? [0, 0, 0],
160
- getModelExtents: () => [
161
- this.modelBounds.min.x,
162
- this.modelBounds.min.y,
163
- this.modelBounds.min.z,
164
- this.modelBounds.max.x,
165
- this.modelBounds.max.y,
166
- this.modelBounds.max.z
167
- ],
168
- applyNavigationUpdate: (update) => this.applySpaceMouseNavigationUpdate(update),
169
- onMotionChange: (moving) => this.setSpaceMouseMoving(moving)
170
- });
171
- this._spaceMouseConnecting = false;
172
- if (this.disposed) {
173
- adapter.dispose();
174
- return;
191
+ const generation = ++this.spaceMouseGeneration;
192
+ this.spaceMouseAbort = new AbortController();
193
+ this.ports.onSpaceMouseStateChange?.('connecting');
194
+ try {
195
+ const { SpaceMouseAdapter } = await import('./SpaceMouseAdapter.js');
196
+ if (this.disposed || generation !== this.spaceMouseGeneration)
197
+ return;
198
+ const adapter = await SpaceMouseAdapter.connect({
199
+ onStateChange: (state) => { if (!this.disposed && generation === this.spaceMouseGeneration)
200
+ this.ports.onSpaceMouseStateChange?.(state); },
201
+ signal: this.spaceMouseAbort.signal,
202
+ // The SDK follows focus/blur on this target. Canvas focus hands the device
203
+ // back to browser scrolling as soon as another part of the page is clicked.
204
+ viewport: window,
205
+ applicationName: 'Spatial Panels SpatialElement Viewer',
206
+ getViewMatrix: () => {
207
+ this.camera.updateMatrixWorld(true);
208
+ return [...this.camera.matrixWorld.elements];
209
+ },
210
+ getFov: () => THREE.MathUtils.degToRad(this.camera.fov),
211
+ getViewFrustum: () => this.getSpaceMouseViewFrustum(),
212
+ getViewTarget: () => this._controls?.target.toArray() ?? [0, 0, 0],
213
+ getModelExtents: () => [
214
+ this.modelBounds.min.x,
215
+ this.modelBounds.min.y,
216
+ this.modelBounds.min.z,
217
+ this.modelBounds.max.x,
218
+ this.modelBounds.max.y,
219
+ this.modelBounds.max.z
220
+ ],
221
+ applyNavigationUpdate: (update) => this.applySpaceMouseNavigationUpdate(update),
222
+ onMotionChange: (moving) => this.setSpaceMouseMoving(moving)
223
+ });
224
+ if (this.disposed || generation !== this.spaceMouseGeneration) {
225
+ adapter.dispose();
226
+ return;
227
+ }
228
+ this._spaceMouseConnecting = false;
229
+ this._spaceMouse = adapter;
175
230
  }
176
- this._spaceMouse = adapter;
231
+ catch {
232
+ if (!this.disposed && generation === this.spaceMouseGeneration) {
233
+ this._spaceMouseConnecting = false;
234
+ this.ports.onSpaceMouseStateChange?.('unavailable');
235
+ }
236
+ }
237
+ }
238
+ disconnectSpaceMouse() {
239
+ this.spaceMouseGeneration++;
240
+ this.ports.onSpaceMouseStateChange?.('idle');
241
+ this.spaceMouseAbort?.abort();
242
+ this.spaceMouseAbort = undefined;
243
+ this._spaceMouseConnecting = false;
244
+ this._spaceMouse?.dispose();
245
+ this._spaceMouse = undefined;
246
+ this.setSpaceMouseMoving(false);
177
247
  }
178
248
  getSpaceMouseViewFrustum() {
179
249
  this.updateStageCameraProjection();
@@ -190,6 +260,8 @@ export class SpatialElementInteractionController {
190
260
  applySpaceMouseNavigationUpdate(update) {
191
261
  if (!this._controls || this.disposed || !this.canInteract)
192
262
  return;
263
+ if (update.viewMatrix || update.target || update.fov !== undefined)
264
+ this.guidance.interact();
193
265
  this.clearWheelZoom();
194
266
  this.clearZoomReset();
195
267
  this._viewResetActive = false;
@@ -219,13 +291,10 @@ export class SpatialElementInteractionController {
219
291
  this.constrainEffectiveZoom();
220
292
  this.camera.lookAt(this._controls.target);
221
293
  this.camera.updateMatrixWorld(true);
222
- this.ports.markActivity();
223
294
  this.requestRender();
224
295
  }
225
296
  setSpaceMouseMoving(moving) {
226
- if (this.disposed || !this.canInteract)
227
- return;
228
- if (this.disposed) {
297
+ if (this.disposed || (moving && !this.canInteract)) {
229
298
  this._spaceMouseMoving = false;
230
299
  return;
231
300
  }
@@ -235,6 +304,11 @@ export class SpatialElementInteractionController {
235
304
  this.recreateOrbitControls();
236
305
  this._spaceMouseMoving = moving;
237
306
  if (moving) {
307
+ // In the split (3XL) layout the geometry remains visible beside the text.
308
+ // Otherwise reveal it without moving keyboard focus or resetting its pose.
309
+ if (!this.ports.readGeometry().detail?.split && window.scrollY > 0) {
310
+ window.scrollTo({ top: 0, behavior: window.matchMedia?.('(prefers-reduced-motion: reduce)').matches ? 'instant' : 'smooth' });
311
+ }
238
312
  this.clearWheelZoom();
239
313
  this.clearZoomReset();
240
314
  this._viewResetActive = false;
@@ -249,6 +323,14 @@ export class SpatialElementInteractionController {
249
323
  this._controls = recreateOrbitControlsForExternalNavigation(this._controls, () => this.createControls());
250
324
  }
251
325
  handlePointerMove(event) {
326
+ const start = this._interactionPointers.get(event.pointerId);
327
+ if (start && Math.hypot(event.clientX - start.x, event.clientY - start.y) >= 6) {
328
+ this.guidance.interact();
329
+ }
330
+ if (event.pointerType !== 'mouse') {
331
+ this.clearPointerHover();
332
+ return;
333
+ }
252
334
  const pointerChanged = !this._pointer.active ||
253
335
  this._pointer.x !== event.clientX ||
254
336
  this._pointer.y !== event.clientY;
@@ -257,29 +339,69 @@ export class SpatialElementInteractionController {
257
339
  this._pointer.active = true;
258
340
  if (pointerChanged)
259
341
  this.requestRender();
260
- if (!this._modelInteractionActive) {
342
+ if (!this._modelInteractionActive && !this.fullscreen) {
261
343
  this.setModelHover(this.hitTestModel(event.clientX, event.clientY, event.target));
344
+ if (this.canInteract && this.stageViewportVisible && !this.guidance.snapshot.interacted &&
345
+ !this.reducedMotion?.matches && event.target === this.backgroundCanvas) {
346
+ this.preview.pointAt(event.clientX, event.clientY, this.camera, this.modelBounds, window.innerWidth, window.innerHeight);
347
+ }
348
+ else
349
+ this.preview.clear();
262
350
  }
263
351
  }
264
352
  handlePointerDown(event) {
265
- const hit = this.hitTestModel(event.clientX, event.clientY, event.target);
353
+ if (event.pointerType !== 'mouse')
354
+ this.clearPointerHover();
355
+ // Once a model gesture owns contact, a second finger may land outside its
356
+ // silhouette. Keep both fingers in the same orbit/pinch gesture.
357
+ const hit = (event.pointerType === 'touch' && this._interactionPointers.size > 0) ||
358
+ this.hitTestModel(event.clientX, event.clientY, event.target);
266
359
  if (hit) {
360
+ this._interactionPointers.set(event.pointerId, { x: event.clientX, y: event.clientY });
267
361
  this.backgroundCanvas.focus({ preventScroll: true });
268
362
  this.clearWheelZoom();
363
+ this.clearZoomReset();
269
364
  this.normalizeCameraFovForOrbitControls();
270
365
  this._viewResetActive = false;
271
366
  }
272
- this._modelInteractionActive = hit;
273
- this.setModelHover(hit);
367
+ this._modelInteractionActive = this._interactionPointers.size > 0;
368
+ this.setModelHover(event.pointerType === 'mouse' && hit);
369
+ this.notifyModelInput();
274
370
  this.updateControlsAvailability();
275
371
  this.requestRender();
276
372
  }
277
373
  handlePointerUp(event) {
278
- this._modelInteractionActive = false;
279
- this.setModelHover(this.hitTestModel(event.clientX, event.clientY, event.target));
374
+ this._interactionPointers.delete(event.pointerId);
375
+ this._modelInteractionActive = this._interactionPointers.size > 0;
376
+ if (event.pointerType !== 'mouse')
377
+ this.clearPointerHover();
378
+ this.setModelHover(event.pointerType === 'mouse' &&
379
+ event.type !== 'pointercancel' &&
380
+ this.hitTestModel(event.clientX, event.clientY, event.target));
381
+ this.notifyModelInput();
280
382
  this.updateControlsAvailability();
281
383
  this.requestRender();
282
384
  }
385
+ handleTouchStart(event) {
386
+ // touch-action cannot be changed after pointerdown to claim the current
387
+ // gesture. Cancel this one start only when the exact geometry was hit.
388
+ // No blocking touchmove handler is needed while native scrolling proceeds.
389
+ if (this._modelInteractionActive && this._controls?.enabled && event.cancelable) {
390
+ event.preventDefault();
391
+ }
392
+ }
393
+ handlePointerContact(event) {
394
+ if (event.pointerType !== 'mouse')
395
+ this.clearPointerHover();
396
+ }
397
+ clearPointerHover() {
398
+ this.preview.clear();
399
+ const changed = this._pointer.active || this._modelHover;
400
+ this._pointer.active = false;
401
+ this.setModelHover(false);
402
+ if (changed)
403
+ this.requestRender();
404
+ }
283
405
  handleWheel(event) {
284
406
  const hit = this.hitTestModel(event.clientX, event.clientY, event.target);
285
407
  this.setModelHover(hit);
@@ -288,6 +410,8 @@ export class SpatialElementInteractionController {
288
410
  this.requestRender();
289
411
  return;
290
412
  }
413
+ if (event.deltaY !== 0)
414
+ this.guidance.interact();
291
415
  // OrbitControls applies wheel dolly immediately even when rotation damping is
292
416
  // enabled. Own the spatialElement wheel gesture so camera, panels, and minimap can
293
417
  // advance from one shared damped camera distance instead.
@@ -309,11 +433,10 @@ export class SpatialElementInteractionController {
309
433
  .unproject(this.camera)
310
434
  .sub(this.camera.position)
311
435
  .normalize();
312
- this.ports.markActivity();
313
436
  this.requestRender();
314
437
  }
315
438
  requestScrollZoomReset(scrollDelta) {
316
- if (!this._controls)
439
+ if (!this._controls || this.fullscreen)
317
440
  return;
318
441
  this.clearWheelZoom();
319
442
  this._viewResetActive = false;
@@ -441,13 +564,33 @@ export class SpatialElementInteractionController {
441
564
  this.camera.updateProjectionMatrix();
442
565
  }
443
566
  handlePointerLeave() {
567
+ this.preview.clear();
568
+ const wasInteracting = this._modelInteractionActive;
569
+ this._interactionPointers.clear();
444
570
  this._pointer.active = false;
445
571
  this._modelInteractionActive = false;
446
572
  this.setModelHover(false);
573
+ this.notifyModelInput();
574
+ // Lost focus may not deliver pointerup. Drop OrbitControls' captured
575
+ // pointer bookkeeping as well, so the next gesture starts immediately.
576
+ if (wasInteracting)
577
+ this.recreateOrbitControls();
447
578
  this.updateControlsAvailability();
448
579
  this.requestRender();
449
580
  }
450
581
  hitTestModel(clientX, clientY, target) {
582
+ // Fullscreen owns the canvas, including its empty background. UI events
583
+ // never reach this gate as canvas input; no geometry or DOM picking is needed.
584
+ if (this.fullscreen)
585
+ return this.canInteract && this.stageViewportVisible && target === this.backgroundCanvas;
586
+ const detail = this.ports.readGeometry().detail;
587
+ if (detail && (detail.split || detail.paneHidden)) {
588
+ if (!this.canInteract || !this.stageViewportVisible)
589
+ return false;
590
+ return resolveDetailGestureOwner({ ...detail, clientX, modelHit: false,
591
+ uiTarget: target !== this.backgroundCanvas || isStageUiTarget(target) || this.isPointerOccludedByHtml(clientX, clientY)
592
+ }) === 'model';
593
+ }
451
594
  if (!this.canInteract ||
452
595
  !this.stageViewportVisible ||
453
596
  clientX < this.viewportFrame.x ||
@@ -492,16 +635,24 @@ export class SpatialElementInteractionController {
492
635
  return false;
493
636
  }
494
637
  setModelHover(hover) {
638
+ if (this.fullscreen)
639
+ hover = false;
495
640
  if (this._modelHover === hover)
496
641
  return;
497
642
  this._modelHover = hover;
643
+ this.notifyModelInput();
498
644
  this.updateControlsAvailability();
499
645
  this.requestRender();
500
646
  }
647
+ notifyModelInput() {
648
+ this.container.dispatchEvent?.(new CustomEvent(MODEL_INPUT_EVENT, {
649
+ detail: { hovered: this._modelHover, active: this._modelInteractionActive }
650
+ }));
651
+ }
501
652
  updateControlsAvailability() {
502
653
  const enabled = this.canInteract &&
503
654
  !this._spaceMouseMoving &&
504
- (this._modelHover || this._modelInteractionActive);
655
+ (this.fullscreen || this._modelHover || this._modelInteractionActive);
505
656
  if (this._controls) {
506
657
  this._controls.enabled = enabled;
507
658
  }
@@ -510,7 +661,7 @@ export class SpatialElementInteractionController {
510
661
  : enabled
511
662
  ? 'grab'
512
663
  : 'auto';
513
- this.backgroundCanvas.style.touchAction = enabled ? 'none' : 'pan-y';
664
+ this.backgroundCanvas.style.touchAction = this.fullscreen ? 'none' : 'manipulation';
514
665
  }
515
666
  getZoomFocusFactor() {
516
667
  if (!this._controls)
@@ -536,7 +687,9 @@ export class SpatialElementInteractionController {
536
687
  const wheel = this.applyWheelZoom(delta);
537
688
  this.applyZoomReset(delta);
538
689
  this.applyViewReset(delta);
539
- return { controls, wheel };
690
+ const preview = !this.fullscreen && !this._modelInteractionActive && !this._spaceMouseMoving &&
691
+ this.preview.advance(this.camera, delta, this.reducedMotion?.matches);
692
+ return { controls: controls || preview, wheel };
540
693
  }
541
694
  get controls() {
542
695
  return this._controls;