@spatial-elements/core 0.1.0-beta.1

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 (299) hide show
  1. package/LICENSE +373 -0
  2. package/README.md +17 -0
  3. package/dist/catalog/CarouselGlassCompositor.d.ts +24 -0
  4. package/dist/catalog/CarouselGlassCompositor.d.ts.map +1 -0
  5. package/dist/catalog/CarouselGlassCompositor.js +132 -0
  6. package/dist/catalog/CarouselGlassCompositor.js.map +1 -0
  7. package/dist/catalog/CatalogEndpointRegistry.d.ts +59 -0
  8. package/dist/catalog/CatalogEndpointRegistry.d.ts.map +1 -0
  9. package/dist/catalog/CatalogEndpointRegistry.js +187 -0
  10. package/dist/catalog/CatalogEndpointRegistry.js.map +1 -0
  11. package/dist/catalog/CatalogGeometryFade.d.ts +12 -0
  12. package/dist/catalog/CatalogGeometryFade.d.ts.map +1 -0
  13. package/dist/catalog/CatalogGeometryFade.js +67 -0
  14. package/dist/catalog/CatalogGeometryFade.js.map +1 -0
  15. package/dist/catalog/CatalogPreparation.d.ts +40 -0
  16. package/dist/catalog/CatalogPreparation.d.ts.map +1 -0
  17. package/dist/catalog/CatalogPreparation.js +141 -0
  18. package/dist/catalog/CatalogPreparation.js.map +1 -0
  19. package/dist/catalog/CatalogSections.d.ts +36 -0
  20. package/dist/catalog/CatalogSections.d.ts.map +1 -0
  21. package/dist/catalog/CatalogSections.js +51 -0
  22. package/dist/catalog/CatalogSections.js.map +1 -0
  23. package/dist/catalog/CatalogSpatialElementLayer.d.ts +149 -0
  24. package/dist/catalog/CatalogSpatialElementLayer.d.ts.map +1 -0
  25. package/dist/catalog/CatalogSpatialElementLayer.js +920 -0
  26. package/dist/catalog/CatalogSpatialElementLayer.js.map +1 -0
  27. package/dist/catalog/CatalogTransition.d.ts +93 -0
  28. package/dist/catalog/CatalogTransition.d.ts.map +1 -0
  29. package/dist/catalog/CatalogTransition.js +1299 -0
  30. package/dist/catalog/CatalogTransition.js.map +1 -0
  31. package/dist/catalog/EnvironmentCache.d.ts +30 -0
  32. package/dist/catalog/EnvironmentCache.d.ts.map +1 -0
  33. package/dist/catalog/EnvironmentCache.js +128 -0
  34. package/dist/catalog/EnvironmentCache.js.map +1 -0
  35. package/dist/catalog/PreparationGate.d.ts +10 -0
  36. package/dist/catalog/PreparationGate.d.ts.map +1 -0
  37. package/dist/catalog/PreparationGate.js +66 -0
  38. package/dist/catalog/PreparationGate.js.map +1 -0
  39. package/dist/catalog/PresentationLease.d.ts +16 -0
  40. package/dist/catalog/PresentationLease.d.ts.map +1 -0
  41. package/dist/catalog/PresentationLease.js +33 -0
  42. package/dist/catalog/PresentationLease.js.map +1 -0
  43. package/dist/catalog/SpatialGeometryCapture.d.ts +63 -0
  44. package/dist/catalog/SpatialGeometryCapture.d.ts.map +1 -0
  45. package/dist/catalog/SpatialGeometryCapture.js +158 -0
  46. package/dist/catalog/SpatialGeometryCapture.js.map +1 -0
  47. package/dist/catalog/assets/SpatialElementAssetManager.d.ts +92 -0
  48. package/dist/catalog/assets/SpatialElementAssetManager.d.ts.map +1 -0
  49. package/dist/catalog/assets/SpatialElementAssetManager.js +305 -0
  50. package/dist/catalog/assets/SpatialElementAssetManager.js.map +1 -0
  51. package/dist/catalog/assets/assetCosts.d.ts +4 -0
  52. package/dist/catalog/assets/assetCosts.d.ts.map +1 -0
  53. package/dist/catalog/assets/assetCosts.js +33 -0
  54. package/dist/catalog/assets/assetCosts.js.map +1 -0
  55. package/dist/catalog/assets/spatialElementAssetResources.d.ts +25 -0
  56. package/dist/catalog/assets/spatialElementAssetResources.d.ts.map +1 -0
  57. package/dist/catalog/assets/spatialElementAssetResources.js +100 -0
  58. package/dist/catalog/assets/spatialElementAssetResources.js.map +1 -0
  59. package/dist/catalog/carouselPanelProjection.d.ts +9 -0
  60. package/dist/catalog/carouselPanelProjection.d.ts.map +1 -0
  61. package/dist/catalog/carouselPanelProjection.js +33 -0
  62. package/dist/catalog/carouselPanelProjection.js.map +1 -0
  63. package/dist/catalog/carouselSelection.d.ts +7 -0
  64. package/dist/catalog/carouselSelection.d.ts.map +1 -0
  65. package/dist/catalog/carouselSelection.js +15 -0
  66. package/dist/catalog/carouselSelection.js.map +1 -0
  67. package/dist/catalog/catalogAction.d.ts +4 -0
  68. package/dist/catalog/catalogAction.d.ts.map +1 -0
  69. package/dist/catalog/catalogAction.js +9 -0
  70. package/dist/catalog/catalogAction.js.map +1 -0
  71. package/dist/catalog/catalogGeometryRequest.d.ts +13 -0
  72. package/dist/catalog/catalogGeometryRequest.d.ts.map +1 -0
  73. package/dist/catalog/catalogGeometryRequest.js +8 -0
  74. package/dist/catalog/catalogGeometryRequest.js.map +1 -0
  75. package/dist/catalog/catalogItems.d.ts +10 -0
  76. package/dist/catalog/catalogItems.d.ts.map +1 -0
  77. package/dist/catalog/catalogItems.js +23 -0
  78. package/dist/catalog/catalogItems.js.map +1 -0
  79. package/dist/catalog/catalogJourney.d.ts +38 -0
  80. package/dist/catalog/catalogJourney.d.ts.map +1 -0
  81. package/dist/catalog/catalogJourney.js +64 -0
  82. package/dist/catalog/catalogJourney.js.map +1 -0
  83. package/dist/catalog/catalogPage.d.ts +11 -0
  84. package/dist/catalog/catalogPage.d.ts.map +1 -0
  85. package/dist/catalog/catalogPage.js +2 -0
  86. package/dist/catalog/catalogPage.js.map +1 -0
  87. package/dist/catalog/catalogPose.d.ts +30 -0
  88. package/dist/catalog/catalogPose.d.ts.map +1 -0
  89. package/dist/catalog/catalogPose.js +35 -0
  90. package/dist/catalog/catalogPose.js.map +1 -0
  91. package/dist/catalog/catalogPresentation.d.ts +24 -0
  92. package/dist/catalog/catalogPresentation.d.ts.map +1 -0
  93. package/dist/catalog/catalogPresentation.js +56 -0
  94. package/dist/catalog/catalogPresentation.js.map +1 -0
  95. package/dist/catalog/catalogRecipes.d.ts +21 -0
  96. package/dist/catalog/catalogRecipes.d.ts.map +1 -0
  97. package/dist/catalog/catalogRecipes.js +84 -0
  98. package/dist/catalog/catalogRecipes.js.map +1 -0
  99. package/dist/catalog/catalogSurfaceCapture.d.ts +11 -0
  100. package/dist/catalog/catalogSurfaceCapture.d.ts.map +1 -0
  101. package/dist/catalog/catalogSurfaceCapture.js +11 -0
  102. package/dist/catalog/catalogSurfaceCapture.js.map +1 -0
  103. package/dist/catalog/catalogViewLink.d.ts +8 -0
  104. package/dist/catalog/catalogViewLink.d.ts.map +1 -0
  105. package/dist/catalog/catalogViewLink.js +37 -0
  106. package/dist/catalog/catalogViewLink.js.map +1 -0
  107. package/dist/catalog/rebasePresentation.d.ts +3 -0
  108. package/dist/catalog/rebasePresentation.d.ts.map +1 -0
  109. package/dist/catalog/rebasePresentation.js +26 -0
  110. package/dist/catalog/rebasePresentation.js.map +1 -0
  111. package/dist/catalog/spatialElementAssets.d.ts +158 -0
  112. package/dist/catalog/spatialElementAssets.d.ts.map +1 -0
  113. package/dist/catalog/spatialElementAssets.js +92 -0
  114. package/dist/catalog/spatialElementAssets.js.map +1 -0
  115. package/dist/catalog/spatialElementLodPair.d.ts +17 -0
  116. package/dist/catalog/spatialElementLodPair.d.ts.map +1 -0
  117. package/dist/catalog/spatialElementLodPair.js +5 -0
  118. package/dist/catalog/spatialElementLodPair.js.map +1 -0
  119. package/dist/catalog/transitionTiming.d.ts +15 -0
  120. package/dist/catalog/transitionTiming.d.ts.map +1 -0
  121. package/dist/catalog/transitionTiming.js +22 -0
  122. package/dist/catalog/transitionTiming.js.map +1 -0
  123. package/dist/index.d.ts +11 -0
  124. package/dist/index.d.ts.map +1 -0
  125. package/dist/index.js +8 -0
  126. package/dist/index.js.map +1 -0
  127. package/dist/spatial-element/SpatialElementDockController.d.ts +101 -0
  128. package/dist/spatial-element/SpatialElementDockController.d.ts.map +1 -0
  129. package/dist/spatial-element/SpatialElementDockController.js +627 -0
  130. package/dist/spatial-element/SpatialElementDockController.js.map +1 -0
  131. package/dist/spatial-element/spatialElement.d.ts +28 -0
  132. package/dist/spatial-element/spatialElement.d.ts.map +1 -0
  133. package/dist/spatial-element/spatialElement.js +45 -0
  134. package/dist/spatial-element/spatialElement.js.map +1 -0
  135. package/dist/spatial-element/spatialElementDock.d.ts +43 -0
  136. package/dist/spatial-element/spatialElementDock.d.ts.map +1 -0
  137. package/dist/spatial-element/spatialElementDock.js +126 -0
  138. package/dist/spatial-element/spatialElementDock.js.map +1 -0
  139. package/dist/spatial-element/spatialElementSectionRegistry.d.ts +29 -0
  140. package/dist/spatial-element/spatialElementSectionRegistry.d.ts.map +1 -0
  141. package/dist/spatial-element/spatialElementSectionRegistry.js +67 -0
  142. package/dist/spatial-element/spatialElementSectionRegistry.js.map +1 -0
  143. package/dist/spatial-element/types.d.ts +165 -0
  144. package/dist/spatial-element/types.d.ts.map +1 -0
  145. package/dist/spatial-element/types.js +2 -0
  146. package/dist/spatial-element/types.js.map +1 -0
  147. package/dist/stage/LiquidGlassPanel.d.ts +55 -0
  148. package/dist/stage/LiquidGlassPanel.d.ts.map +1 -0
  149. package/dist/stage/LiquidGlassPanel.js +447 -0
  150. package/dist/stage/LiquidGlassPanel.js.map +1 -0
  151. package/dist/stage/MinimapBlurPipeline.d.ts +34 -0
  152. package/dist/stage/MinimapBlurPipeline.d.ts.map +1 -0
  153. package/dist/stage/MinimapBlurPipeline.js +147 -0
  154. package/dist/stage/MinimapBlurPipeline.js.map +1 -0
  155. package/dist/stage/MinimapController.d.ts +113 -0
  156. package/dist/stage/MinimapController.d.ts.map +1 -0
  157. package/dist/stage/MinimapController.js +803 -0
  158. package/dist/stage/MinimapController.js.map +1 -0
  159. package/dist/stage/OrbitControlsInterop.d.ts +8 -0
  160. package/dist/stage/OrbitControlsInterop.d.ts.map +1 -0
  161. package/dist/stage/OrbitControlsInterop.js +19 -0
  162. package/dist/stage/OrbitControlsInterop.js.map +1 -0
  163. package/dist/stage/PageBindingController.d.ts +41 -0
  164. package/dist/stage/PageBindingController.d.ts.map +1 -0
  165. package/dist/stage/PageBindingController.js +92 -0
  166. package/dist/stage/PageBindingController.js.map +1 -0
  167. package/dist/stage/PanelPresentationController.d.ts +92 -0
  168. package/dist/stage/PanelPresentationController.d.ts.map +1 -0
  169. package/dist/stage/PanelPresentationController.js +569 -0
  170. package/dist/stage/PanelPresentationController.js.map +1 -0
  171. package/dist/stage/PresentationReadiness.d.ts +30 -0
  172. package/dist/stage/PresentationReadiness.d.ts.map +1 -0
  173. package/dist/stage/PresentationReadiness.js +94 -0
  174. package/dist/stage/PresentationReadiness.js.map +1 -0
  175. package/dist/stage/SpaceMouseAdapter.d.ts +76 -0
  176. package/dist/stage/SpaceMouseAdapter.d.ts.map +1 -0
  177. package/dist/stage/SpaceMouseAdapter.js +197 -0
  178. package/dist/stage/SpaceMouseAdapter.js.map +1 -0
  179. package/dist/stage/SpatialElementInteractionController.d.ts +126 -0
  180. package/dist/stage/SpatialElementInteractionController.d.ts.map +1 -0
  181. package/dist/stage/SpatialElementInteractionController.js +581 -0
  182. package/dist/stage/SpatialElementInteractionController.js.map +1 -0
  183. package/dist/stage/SpatialElementPresentationController.d.ts +82 -0
  184. package/dist/stage/SpatialElementPresentationController.d.ts.map +1 -0
  185. package/dist/stage/SpatialElementPresentationController.js +372 -0
  186. package/dist/stage/SpatialElementPresentationController.js.map +1 -0
  187. package/dist/stage/SpatialElementRefinement.d.ts +26 -0
  188. package/dist/stage/SpatialElementRefinement.d.ts.map +1 -0
  189. package/dist/stage/SpatialElementRefinement.js +105 -0
  190. package/dist/stage/SpatialElementRefinement.js.map +1 -0
  191. package/dist/stage/StageExperience.d.ts +536 -0
  192. package/dist/stage/StageExperience.d.ts.map +1 -0
  193. package/dist/stage/StageExperience.js +2399 -0
  194. package/dist/stage/StageExperience.js.map +1 -0
  195. package/dist/stage/StagePanelLayout.d.ts +15 -0
  196. package/dist/stage/StagePanelLayout.d.ts.map +1 -0
  197. package/dist/stage/StagePanelLayout.js +20 -0
  198. package/dist/stage/StagePanelLayout.js.map +1 -0
  199. package/dist/stage/StagePanelRuntime.d.ts +20 -0
  200. package/dist/stage/StagePanelRuntime.d.ts.map +1 -0
  201. package/dist/stage/StagePanelRuntime.js +2 -0
  202. package/dist/stage/StagePanelRuntime.js.map +1 -0
  203. package/dist/stage/StageRenderPipeline.d.ts +179 -0
  204. package/dist/stage/StageRenderPipeline.d.ts.map +1 -0
  205. package/dist/stage/StageRenderPipeline.js +901 -0
  206. package/dist/stage/StageRenderPipeline.js.map +1 -0
  207. package/dist/stage/VirtualScrollController.d.ts +64 -0
  208. package/dist/stage/VirtualScrollController.d.ts.map +1 -0
  209. package/dist/stage/VirtualScrollController.js +329 -0
  210. package/dist/stage/VirtualScrollController.js.map +1 -0
  211. package/dist/stage/cssProjection.d.ts +18 -0
  212. package/dist/stage/cssProjection.d.ts.map +1 -0
  213. package/dist/stage/cssProjection.js +52 -0
  214. package/dist/stage/cssProjection.js.map +1 -0
  215. package/dist/stage/damping.d.ts +3 -0
  216. package/dist/stage/damping.d.ts.map +1 -0
  217. package/dist/stage/damping.js +8 -0
  218. package/dist/stage/damping.js.map +1 -0
  219. package/dist/stage/minimap/MinimapGeometry.d.ts +31 -0
  220. package/dist/stage/minimap/MinimapGeometry.d.ts.map +1 -0
  221. package/dist/stage/minimap/MinimapGeometry.js +163 -0
  222. package/dist/stage/minimap/MinimapGeometry.js.map +1 -0
  223. package/dist/stage/minimap/MinimapModel.d.ts +16 -0
  224. package/dist/stage/minimap/MinimapModel.d.ts.map +1 -0
  225. package/dist/stage/minimap/MinimapModel.js +51 -0
  226. package/dist/stage/minimap/MinimapModel.js.map +1 -0
  227. package/dist/stage/minimap/MinimapProjection.d.ts +41 -0
  228. package/dist/stage/minimap/MinimapProjection.d.ts.map +1 -0
  229. package/dist/stage/minimap/MinimapProjection.js +113 -0
  230. package/dist/stage/minimap/MinimapProjection.js.map +1 -0
  231. package/dist/stage/minimap/MinimapState.d.ts +102 -0
  232. package/dist/stage/minimap/MinimapState.d.ts.map +1 -0
  233. package/dist/stage/minimap/MinimapState.js +2 -0
  234. package/dist/stage/minimap/MinimapState.js.map +1 -0
  235. package/dist/stage/minimapMeasurement.d.ts +5 -0
  236. package/dist/stage/minimapMeasurement.d.ts.map +1 -0
  237. package/dist/stage/minimapMeasurement.js +11 -0
  238. package/dist/stage/minimapMeasurement.js.map +1 -0
  239. package/dist/stage/panelContext.d.ts +71 -0
  240. package/dist/stage/panelContext.d.ts.map +1 -0
  241. package/dist/stage/panelContext.js +6 -0
  242. package/dist/stage/panelContext.js.map +1 -0
  243. package/dist/stage/panelShadow.d.ts +20 -0
  244. package/dist/stage/panelShadow.d.ts.map +1 -0
  245. package/dist/stage/panelShadow.js +22 -0
  246. package/dist/stage/panelShadow.js.map +1 -0
  247. package/dist/stage/renderMeasurement.d.ts +3 -0
  248. package/dist/stage/renderMeasurement.d.ts.map +1 -0
  249. package/dist/stage/renderMeasurement.js +19 -0
  250. package/dist/stage/renderMeasurement.js.map +1 -0
  251. package/dist/stage/renderTargetInventory.d.ts +17 -0
  252. package/dist/stage/renderTargetInventory.d.ts.map +1 -0
  253. package/dist/stage/renderTargetInventory.js +27 -0
  254. package/dist/stage/renderTargetInventory.js.map +1 -0
  255. package/dist/stage/rendererState.d.ts +14 -0
  256. package/dist/stage/rendererState.d.ts.map +1 -0
  257. package/dist/stage/rendererState.js +35 -0
  258. package/dist/stage/rendererState.js.map +1 -0
  259. package/dist/stage/resolveStageProfile.d.ts +44 -0
  260. package/dist/stage/resolveStageProfile.d.ts.map +1 -0
  261. package/dist/stage/resolveStageProfile.js +30 -0
  262. package/dist/stage/resolveStageProfile.js.map +1 -0
  263. package/dist/stage/scrollAnimation.d.ts +10 -0
  264. package/dist/stage/scrollAnimation.d.ts.map +1 -0
  265. package/dist/stage/scrollAnimation.js +11 -0
  266. package/dist/stage/scrollAnimation.js.map +1 -0
  267. package/dist/stage/scrollFrame.d.ts +43 -0
  268. package/dist/stage/scrollFrame.d.ts.map +1 -0
  269. package/dist/stage/scrollFrame.js +232 -0
  270. package/dist/stage/scrollFrame.js.map +1 -0
  271. package/dist/stage/spatialElementFrame.d.ts +6 -0
  272. package/dist/stage/spatialElementFrame.d.ts.map +1 -0
  273. package/dist/stage/spatialElementFrame.js +22 -0
  274. package/dist/stage/spatialElementFrame.js.map +1 -0
  275. package/dist/stage/stageConstants.d.ts +85 -0
  276. package/dist/stage/stageConstants.d.ts.map +1 -0
  277. package/dist/stage/stageConstants.js +85 -0
  278. package/dist/stage/stageConstants.js.map +1 -0
  279. package/dist/stage/stageDom.d.ts +10 -0
  280. package/dist/stage/stageDom.d.ts.map +1 -0
  281. package/dist/stage/stageDom.js +22 -0
  282. package/dist/stage/stageDom.js.map +1 -0
  283. package/dist/stage/stageMath.d.ts +187 -0
  284. package/dist/stage/stageMath.d.ts.map +1 -0
  285. package/dist/stage/stageMath.js +344 -0
  286. package/dist/stage/stageMath.js.map +1 -0
  287. package/dist/stage/stageSceneUtils.d.ts +42 -0
  288. package/dist/stage/stageSceneUtils.d.ts.map +1 -0
  289. package/dist/stage/stageSceneUtils.js +154 -0
  290. package/dist/stage/stageSceneUtils.js.map +1 -0
  291. package/dist/stage/stageTypes.d.ts +189 -0
  292. package/dist/stage/stageTypes.d.ts.map +1 -0
  293. package/dist/stage/stageTypes.js +2 -0
  294. package/dist/stage/stageTypes.js.map +1 -0
  295. package/dist/stage/stageVisualTest.d.ts +92 -0
  296. package/dist/stage/stageVisualTest.d.ts.map +1 -0
  297. package/dist/stage/stageVisualTest.js +5 -0
  298. package/dist/stage/stageVisualTest.js.map +1 -0
  299. package/package.json +61 -0
@@ -0,0 +1,581 @@
1
+ import * as THREE from 'three/webgpu';
2
+ import { OrbitControls } from 'three/addons/controls/OrbitControls.js';
3
+ import { recreateOrbitControlsForExternalNavigation } from './OrbitControlsInterop.js';
4
+ import { WHEEL_ZOOM_DAMPING, ZOOM_RESET_DAMPING } from './stageConstants.js';
5
+ import { isStageUiTarget } from './stageDom.js';
6
+ import { getCameraZoomFocus, getCameraZoomReferenceDistance, getEffectiveCameraDistance, getWheelZoomTargetDistance, normalizeWheelZoomDelta, getViewResetDuration, getViewResetInterpolation } from './stageMath.js';
7
+ import { SpaceMouseAdapter } from './SpaceMouseAdapter.js';
8
+ import { dampAndSnap } from './damping.js';
9
+ /** Owns user navigation state; consumes the facade clock and never creates a RAF loop. */
10
+ export class SpatialElementInteractionController {
11
+ ports;
12
+ disposed = false;
13
+ constructor(ports) {
14
+ this.ports = ports;
15
+ this._initialCameraFov = this._viewResetStartFov = ports.camera.fov;
16
+ }
17
+ get camera() {
18
+ return this.ports.camera;
19
+ }
20
+ get backgroundCanvas() {
21
+ return this.ports.canvas;
22
+ }
23
+ get container() {
24
+ return this.ports.container;
25
+ }
26
+ get canInteract() {
27
+ return this.ports.readGeometry().poseOwner === 'page';
28
+ }
29
+ get stageViewportVisible() {
30
+ return this.ports.readGeometry().visible;
31
+ }
32
+ get viewportFrame() {
33
+ return this.ports.readGeometry().viewport;
34
+ }
35
+ get modelBounds() {
36
+ return this.ports.readGeometry().bounds;
37
+ }
38
+ requestRender() {
39
+ this.ports.requestRender();
40
+ }
41
+ updateStageCameraProjection() {
42
+ this.ports.updateProjection();
43
+ }
44
+ initialize() {
45
+ this._controls = this.createControls();
46
+ }
47
+ releasePage() {
48
+ this.clearWheelZoom();
49
+ this._zoomResetTargetDistance = undefined;
50
+ this._viewResetActive = false;
51
+ this._modelHover = this._modelInteractionActive = false;
52
+ if (!this.disposed)
53
+ this.recreateOrbitControls();
54
+ }
55
+ dispose() {
56
+ this.disposed = true;
57
+ this._controls?.removeEventListener('change', this._controlsChange);
58
+ this._controls?.dispose();
59
+ this._spaceMouse?.dispose();
60
+ this._spaceMouse = undefined;
61
+ }
62
+ captureInitialView() {
63
+ if (!this._controls)
64
+ return;
65
+ this._initialCameraPosition.copy(this.camera.position);
66
+ this._initialControlsTarget.copy(this._controls.target);
67
+ this._initialCameraFov = this.camera.fov;
68
+ this._initialViewCaptured = true;
69
+ }
70
+ setFocusRange(rest, close) {
71
+ this._focusRestDistance = rest;
72
+ this._focusCloseDistance = close;
73
+ }
74
+ stopViewReset() {
75
+ this._viewResetActive = false;
76
+ }
77
+ setPickTargets(model, include) {
78
+ this._modelPickTargets.length = 0;
79
+ model?.traverse((child) => {
80
+ if (child.isMesh && include(child))
81
+ this._modelPickTargets.push(child);
82
+ });
83
+ }
84
+ _raycaster = new THREE.Raycaster();
85
+ _pointerNdc = new THREE.Vector2();
86
+ _wheelZoomDirection = new THREE.Vector3();
87
+ _wheelZoomForward = new THREE.Vector3();
88
+ _controlsChange = () => this.requestRender();
89
+ _pointer = { x: 0, y: 0, active: false };
90
+ _modelPickTargets = [];
91
+ _modelHits = [];
92
+ _spaceMouseMatrix = new THREE.Matrix4();
93
+ _spaceMouseScale = new THREE.Vector3();
94
+ _spaceMouseDirection = new THREE.Vector3();
95
+ _spaceMouseFrustumMin = new THREE.Vector2();
96
+ _spaceMouseFrustumMax = new THREE.Vector2();
97
+ _controls;
98
+ _spaceMouse;
99
+ _spaceMouseConnecting = false;
100
+ _spaceMouseMoving = false;
101
+ _modelHover = false;
102
+ _modelInteractionActive = false;
103
+ _focusRestDistance = 1;
104
+ _focusCloseDistance = 0.4;
105
+ _zoomResetTargetDistance;
106
+ _zoomResetStartDistance;
107
+ _zoomResetScrollDistance = 0;
108
+ _wheelZoomTargetDistance;
109
+ _initialCameraPosition = new THREE.Vector3();
110
+ _initialControlsTarget = new THREE.Vector3();
111
+ _initialCameraFov = 45;
112
+ _initialViewCaptured = false;
113
+ _viewResetActive = false;
114
+ _viewResetStartCameraPosition = new THREE.Vector3();
115
+ _viewResetStartControlsTarget = new THREE.Vector3();
116
+ _viewResetStartFov = 45;
117
+ _viewResetElapsed = 0;
118
+ _viewResetDuration = 0;
119
+ resetView() {
120
+ if (!this._controls || !this._initialViewCaptured)
121
+ return;
122
+ this.clearWheelZoom();
123
+ this.clearZoomReset();
124
+ this._viewResetStartCameraPosition.copy(this.camera.position);
125
+ this._viewResetStartControlsTarget.copy(this._controls.target);
126
+ this._viewResetStartFov = this.camera.fov;
127
+ this._viewResetElapsed = 0;
128
+ this._viewResetDuration = getViewResetDuration(this.getZoomFocusFactor());
129
+ this._viewResetActive = true;
130
+ this.requestRender();
131
+ }
132
+ createControls() {
133
+ const controls = new OrbitControls(this.camera, this.backgroundCanvas);
134
+ controls.enableDamping = true;
135
+ controls.dampingFactor = 0.06;
136
+ controls.zoomToCursor = true;
137
+ controls.enabled = false;
138
+ controls.addEventListener('change', this._controlsChange);
139
+ this.backgroundCanvas.style.touchAction = 'pan-y';
140
+ return controls;
141
+ }
142
+ async initializeSpaceMouse() {
143
+ if (!this._controls ||
144
+ !this._initialViewCaptured ||
145
+ this._spaceMouse ||
146
+ this._spaceMouseConnecting ||
147
+ this.disposed)
148
+ return;
149
+ 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;
175
+ }
176
+ this._spaceMouse = adapter;
177
+ }
178
+ getSpaceMouseViewFrustum() {
179
+ this.updateStageCameraProjection();
180
+ this.camera.getViewBounds(this.camera.near, this._spaceMouseFrustumMin, this._spaceMouseFrustumMax);
181
+ return [
182
+ this._spaceMouseFrustumMin.x,
183
+ this._spaceMouseFrustumMax.x,
184
+ this._spaceMouseFrustumMin.y,
185
+ this._spaceMouseFrustumMax.y,
186
+ this.camera.near,
187
+ this.camera.far
188
+ ];
189
+ }
190
+ applySpaceMouseNavigationUpdate(update) {
191
+ if (!this._controls || this.disposed || !this.canInteract)
192
+ return;
193
+ this.clearWheelZoom();
194
+ this.clearZoomReset();
195
+ this._viewResetActive = false;
196
+ const previousTargetDistance = this.camera.position.distanceTo(this._controls.target);
197
+ if (update.viewMatrix) {
198
+ this._spaceMouseMatrix.fromArray(update.viewMatrix);
199
+ this._spaceMouseMatrix.decompose(this.camera.position, this.camera.quaternion, this._spaceMouseScale);
200
+ this.camera.scale.set(1, 1, 1);
201
+ }
202
+ if (update.target) {
203
+ this._controls.target.fromArray(update.target);
204
+ }
205
+ else if (update.viewMatrix) {
206
+ this.camera.getWorldDirection(this._spaceMouseDirection);
207
+ this._controls.target
208
+ .copy(this.camera.position)
209
+ .addScaledVector(this._spaceMouseDirection, Math.max(previousTargetDistance, 0.001));
210
+ }
211
+ if (update.fov !== undefined) {
212
+ this.camera.fov = THREE.MathUtils.clamp(THREE.MathUtils.radToDeg(update.fov), 1, 179);
213
+ }
214
+ const distance = this.camera.position.distanceTo(this._controls.target);
215
+ if (distance < this._controls.minDistance || distance > this._controls.maxDistance) {
216
+ this.setCameraDistance(THREE.MathUtils.clamp(distance, this._controls.minDistance, this._controls.maxDistance));
217
+ }
218
+ this.camera.updateProjectionMatrix();
219
+ this.constrainEffectiveZoom();
220
+ this.camera.lookAt(this._controls.target);
221
+ this.camera.updateMatrixWorld(true);
222
+ this.ports.markActivity();
223
+ this.requestRender();
224
+ }
225
+ setSpaceMouseMoving(moving) {
226
+ if (this.disposed || !this.canInteract)
227
+ return;
228
+ if (this.disposed) {
229
+ this._spaceMouseMoving = false;
230
+ return;
231
+ }
232
+ if (this._spaceMouseMoving === moving)
233
+ return;
234
+ if (moving)
235
+ this.recreateOrbitControls();
236
+ this._spaceMouseMoving = moving;
237
+ if (moving) {
238
+ this.clearWheelZoom();
239
+ this.clearZoomReset();
240
+ this._viewResetActive = false;
241
+ }
242
+ this.updateControlsAvailability();
243
+ this.requestRender();
244
+ }
245
+ recreateOrbitControls() {
246
+ if (!this._controls)
247
+ return;
248
+ this._controls.removeEventListener('change', this._controlsChange);
249
+ this._controls = recreateOrbitControlsForExternalNavigation(this._controls, () => this.createControls());
250
+ }
251
+ handlePointerMove(event) {
252
+ const pointerChanged = !this._pointer.active ||
253
+ this._pointer.x !== event.clientX ||
254
+ this._pointer.y !== event.clientY;
255
+ this._pointer.x = event.clientX;
256
+ this._pointer.y = event.clientY;
257
+ this._pointer.active = true;
258
+ if (pointerChanged)
259
+ this.requestRender();
260
+ if (!this._modelInteractionActive) {
261
+ this.setModelHover(this.hitTestModel(event.clientX, event.clientY, event.target));
262
+ }
263
+ }
264
+ handlePointerDown(event) {
265
+ const hit = this.hitTestModel(event.clientX, event.clientY, event.target);
266
+ if (hit) {
267
+ this.backgroundCanvas.focus({ preventScroll: true });
268
+ this.clearWheelZoom();
269
+ this.normalizeCameraFovForOrbitControls();
270
+ this._viewResetActive = false;
271
+ }
272
+ this._modelInteractionActive = hit;
273
+ this.setModelHover(hit);
274
+ this.updateControlsAvailability();
275
+ this.requestRender();
276
+ }
277
+ handlePointerUp(event) {
278
+ this._modelInteractionActive = false;
279
+ this.setModelHover(this.hitTestModel(event.clientX, event.clientY, event.target));
280
+ this.updateControlsAvailability();
281
+ this.requestRender();
282
+ }
283
+ handleWheel(event) {
284
+ const hit = this.hitTestModel(event.clientX, event.clientY, event.target);
285
+ this.setModelHover(hit);
286
+ this.updateControlsAvailability();
287
+ if (!hit || !this._controls) {
288
+ this.requestRender();
289
+ return;
290
+ }
291
+ // OrbitControls applies wheel dolly immediately even when rotation damping is
292
+ // enabled. Own the spatialElement wheel gesture so camera, panels, and minimap can
293
+ // advance from one shared damped camera distance instead.
294
+ event.preventDefault();
295
+ event.stopImmediatePropagation();
296
+ this.normalizeCameraFovForOrbitControls();
297
+ this.clearZoomReset();
298
+ this._viewResetActive = false;
299
+ const deltaY = normalizeWheelZoomDelta(event.deltaY, event.deltaMode, event.ctrlKey);
300
+ const currentDistance = this.camera.position.distanceTo(this._controls.target);
301
+ const previousTargetDistance = this._wheelZoomTargetDistance ?? currentDistance;
302
+ const targetDistance = getWheelZoomTargetDistance(previousTargetDistance, deltaY, this._controls.zoomSpeed, this._controls.minDistance, this._controls.maxDistance);
303
+ this._wheelZoomTargetDistance =
304
+ Math.abs(targetDistance - currentDistance) > 0.0001 ? targetDistance : undefined;
305
+ const rect = this.backgroundCanvas.getBoundingClientRect();
306
+ this._pointerNdc.set(((event.clientX - rect.left) / Math.max(rect.width, 1)) * 2 - 1, -((event.clientY - rect.top) / Math.max(rect.height, 1)) * 2 + 1);
307
+ this._wheelZoomDirection
308
+ .set(this._pointerNdc.x, this._pointerNdc.y, 1)
309
+ .unproject(this.camera)
310
+ .sub(this.camera.position)
311
+ .normalize();
312
+ this.ports.markActivity();
313
+ this.requestRender();
314
+ }
315
+ requestScrollZoomReset(scrollDelta) {
316
+ if (!this._controls)
317
+ return;
318
+ this.clearWheelZoom();
319
+ this._viewResetActive = false;
320
+ const currentDistance = this.getEffectiveCameraDistance();
321
+ const overviewDistance = this._controls.maxDistance;
322
+ if (currentDistance >= overviewDistance - 0.001 &&
323
+ Math.abs(this.camera.fov - this._initialCameraFov) < 0.001) {
324
+ this.clearZoomReset();
325
+ return;
326
+ }
327
+ if (this._zoomResetStartDistance === undefined) {
328
+ this._zoomResetStartDistance = currentDistance;
329
+ this._zoomResetScrollDistance = 0;
330
+ }
331
+ this._zoomResetScrollDistance += scrollDelta;
332
+ const resetAmount = THREE.MathUtils.clamp(this._zoomResetScrollDistance / Math.max(window.innerHeight, 1), 0, 1);
333
+ this._zoomResetTargetDistance = THREE.MathUtils.lerp(this._zoomResetStartDistance, overviewDistance, resetAmount);
334
+ }
335
+ applyZoomReset(delta) {
336
+ if (!this._controls || this._zoomResetTargetDistance === undefined)
337
+ return;
338
+ const currentDistance = this.camera.position.distanceTo(this._controls.target);
339
+ const targetDistance = THREE.MathUtils.clamp(this._zoomResetTargetDistance, this._controls.minDistance, this._controls.maxDistance);
340
+ const nextDistance = THREE.MathUtils.damp(currentDistance, targetDistance, ZOOM_RESET_DAMPING, delta);
341
+ this.setCameraDistance(nextDistance);
342
+ this.camera.fov = THREE.MathUtils.damp(this.camera.fov, this._initialCameraFov, ZOOM_RESET_DAMPING, delta);
343
+ this.camera.updateProjectionMatrix();
344
+ if (Math.abs(nextDistance - targetDistance) < 0.01 &&
345
+ Math.abs(this.camera.fov - this._initialCameraFov) < 0.01) {
346
+ this.setCameraDistance(targetDistance);
347
+ this.camera.fov = this._initialCameraFov;
348
+ this.camera.updateProjectionMatrix();
349
+ if (targetDistance >= this._controls.maxDistance - 0.001) {
350
+ this.clearZoomReset();
351
+ }
352
+ else {
353
+ this._zoomResetTargetDistance = undefined;
354
+ }
355
+ }
356
+ this._controls.update();
357
+ }
358
+ applyViewReset(delta) {
359
+ if (!this._controls || !this._viewResetActive || !this._initialViewCaptured)
360
+ return;
361
+ this._viewResetElapsed += Math.max(delta, 0);
362
+ const interpolation = getViewResetInterpolation(this._viewResetElapsed, this._viewResetDuration);
363
+ this.camera.position
364
+ .copy(this._viewResetStartCameraPosition)
365
+ .lerp(this._initialCameraPosition, interpolation);
366
+ this._controls.target
367
+ .copy(this._viewResetStartControlsTarget)
368
+ .lerp(this._initialControlsTarget, interpolation);
369
+ this.camera.fov = THREE.MathUtils.lerp(this._viewResetStartFov, this._initialCameraFov, interpolation);
370
+ this.camera.updateProjectionMatrix();
371
+ if (interpolation >= 1) {
372
+ this.camera.position.copy(this._initialCameraPosition);
373
+ this._controls.target.copy(this._initialControlsTarget);
374
+ this.camera.fov = this._initialCameraFov;
375
+ this.camera.updateProjectionMatrix();
376
+ this._viewResetActive = false;
377
+ }
378
+ this.camera.updateMatrixWorld();
379
+ this._controls.update();
380
+ }
381
+ clearZoomReset() {
382
+ this._zoomResetTargetDistance = undefined;
383
+ this._zoomResetStartDistance = undefined;
384
+ this._zoomResetScrollDistance = 0;
385
+ }
386
+ clearWheelZoom() {
387
+ this._wheelZoomTargetDistance = undefined;
388
+ }
389
+ applyWheelZoom(delta) {
390
+ if (!this._controls || this._wheelZoomTargetDistance === undefined)
391
+ return false;
392
+ const currentDistance = this.camera.position.distanceTo(this._controls.target);
393
+ const targetDistance = THREE.MathUtils.clamp(this._wheelZoomTargetDistance, this._controls.minDistance, this._controls.maxDistance);
394
+ const nextDistance = dampAndSnap(currentDistance, targetDistance, WHEEL_ZOOM_DAMPING, delta, 0.001);
395
+ const radiusDelta = currentDistance - nextDistance;
396
+ this.camera.position.addScaledVector(this._wheelZoomDirection, radiusDelta);
397
+ this.camera.updateMatrixWorld(true);
398
+ this.camera.getWorldDirection(this._wheelZoomForward);
399
+ this._controls.target
400
+ .copy(this.camera.position)
401
+ .addScaledVector(this._wheelZoomForward, nextDistance);
402
+ this._controls.update();
403
+ if (nextDistance === targetDistance)
404
+ this._wheelZoomTargetDistance = undefined;
405
+ return this._wheelZoomTargetDistance !== undefined;
406
+ }
407
+ setCameraDistance(distance) {
408
+ if (!this._controls)
409
+ return;
410
+ const direction = this.camera.position.clone().sub(this._controls.target);
411
+ if (direction.lengthSq() < 0.0001)
412
+ direction.set(0, 0, 1);
413
+ direction.setLength(distance);
414
+ this.camera.position.copy(this._controls.target).add(direction);
415
+ this.camera.updateMatrixWorld();
416
+ }
417
+ getEffectiveCameraDistance() {
418
+ if (!this._controls)
419
+ return 0;
420
+ return getEffectiveCameraDistance(this.camera.position.distanceTo(this._controls.target), this.camera.fov, this._initialCameraFov);
421
+ }
422
+ normalizeCameraFovForOrbitControls() {
423
+ if (!this._controls || Math.abs(this.camera.fov - this._initialCameraFov) < 0.001)
424
+ return;
425
+ const distance = THREE.MathUtils.clamp(this.getEffectiveCameraDistance(), this._controls.minDistance, this._controls.maxDistance);
426
+ this.camera.fov = this._initialCameraFov;
427
+ this.setCameraDistance(distance);
428
+ this.camera.updateProjectionMatrix();
429
+ this._controls.update();
430
+ }
431
+ constrainEffectiveZoom() {
432
+ if (!this._controls)
433
+ return;
434
+ const distance = Math.max(this.camera.position.distanceTo(this._controls.target), 0.001);
435
+ const effectiveDistance = this.getEffectiveCameraDistance();
436
+ const constrainedDistance = THREE.MathUtils.clamp(effectiveDistance, this._controls.minDistance, this._controls.maxDistance);
437
+ if (Math.abs(effectiveDistance - constrainedDistance) < 0.0001)
438
+ return;
439
+ const referenceTangent = Math.tan(THREE.MathUtils.degToRad(this._initialCameraFov * 0.5));
440
+ this.camera.fov = THREE.MathUtils.radToDeg(2 * Math.atan((referenceTangent * constrainedDistance) / distance));
441
+ this.camera.updateProjectionMatrix();
442
+ }
443
+ handlePointerLeave() {
444
+ this._pointer.active = false;
445
+ this._modelInteractionActive = false;
446
+ this.setModelHover(false);
447
+ this.updateControlsAvailability();
448
+ this.requestRender();
449
+ }
450
+ hitTestModel(clientX, clientY, target) {
451
+ if (!this.canInteract ||
452
+ !this.stageViewportVisible ||
453
+ clientX < this.viewportFrame.x ||
454
+ clientX > this.viewportFrame.x + this.viewportFrame.z ||
455
+ clientY < this.viewportFrame.y ||
456
+ clientY > this.viewportFrame.y + this.viewportFrame.w ||
457
+ !this._modelPickTargets.length ||
458
+ isStageUiTarget(target) ||
459
+ this.isPointerOccludedByHtml(clientX, clientY)) {
460
+ return false;
461
+ }
462
+ this.updateStageCameraProjection();
463
+ this._pointerNdc.set((clientX / window.innerWidth) * 2 - 1, -(clientY / window.innerHeight) * 2 + 1);
464
+ this._raycaster.setFromCamera(this._pointerNdc, this.camera);
465
+ // This is a boolean interaction gate, not a nearest-surface query. Do not
466
+ // raycast the remaining detailed meshes once one spatialElement surface was hit.
467
+ for (const mesh of this._modelPickTargets) {
468
+ this._modelHits.length = 0;
469
+ this._raycaster.intersectObject(mesh, false, this._modelHits);
470
+ if (this._modelHits.length) {
471
+ this._modelHits.length = 0;
472
+ return true;
473
+ }
474
+ }
475
+ return false;
476
+ }
477
+ isPointerOccludedByHtml(clientX, clientY) {
478
+ const elements = document.elementsFromPoint(clientX, clientY);
479
+ for (const element of elements) {
480
+ if (element === this.backgroundCanvas)
481
+ return false;
482
+ if (element === this.ports.cssRoot || element === this.container)
483
+ continue;
484
+ if (element === document.body || element === document.documentElement)
485
+ continue;
486
+ if (!(element instanceof HTMLElement || element instanceof SVGElement))
487
+ continue;
488
+ if (getComputedStyle(element).pointerEvents === 'none')
489
+ continue;
490
+ return true;
491
+ }
492
+ return false;
493
+ }
494
+ setModelHover(hover) {
495
+ if (this._modelHover === hover)
496
+ return;
497
+ this._modelHover = hover;
498
+ this.updateControlsAvailability();
499
+ this.requestRender();
500
+ }
501
+ updateControlsAvailability() {
502
+ const enabled = this.canInteract &&
503
+ !this._spaceMouseMoving &&
504
+ (this._modelHover || this._modelInteractionActive);
505
+ if (this._controls) {
506
+ this._controls.enabled = enabled;
507
+ }
508
+ this.backgroundCanvas.style.cursor = this._modelInteractionActive
509
+ ? 'grabbing'
510
+ : enabled
511
+ ? 'grab'
512
+ : 'auto';
513
+ this.backgroundCanvas.style.touchAction = enabled ? 'none' : 'pan-y';
514
+ }
515
+ getZoomFocusFactor() {
516
+ if (!this._controls)
517
+ return 0;
518
+ const viewTargetDistance = this.camera.position.distanceTo(this._controls.target);
519
+ const spatialElementCenterDistance = this.camera.position.distanceTo(this._initialControlsTarget);
520
+ return getCameraZoomFocus(getCameraZoomReferenceDistance(viewTargetDistance, spatialElementCenterDistance), this.camera.fov, this._initialCameraFov, this._focusCloseDistance, this._focusRestDistance);
521
+ }
522
+ getZoomReferenceTarget() {
523
+ if (!this._controls)
524
+ return this._initialControlsTarget;
525
+ const viewTargetDistance = this.camera.position.distanceTo(this._controls.target);
526
+ const spatialElementCenterDistance = this.camera.position.distanceTo(this._initialControlsTarget);
527
+ return spatialElementCenterDistance < viewTargetDistance
528
+ ? this._initialControlsTarget
529
+ : this._controls.target;
530
+ }
531
+ advance(now, delta) {
532
+ this._spaceMouse?.updateFrame(now);
533
+ if (!this.canInteract)
534
+ return { controls: false, wheel: false };
535
+ const controls = !this._spaceMouseMoving && Boolean(this._controls?.update());
536
+ const wheel = this.applyWheelZoom(delta);
537
+ this.applyZoomReset(delta);
538
+ this.applyViewReset(delta);
539
+ return { controls, wheel };
540
+ }
541
+ get controls() {
542
+ return this._controls;
543
+ }
544
+ get focusCloseDistance() {
545
+ return this._focusCloseDistance;
546
+ }
547
+ get initialCameraFov() {
548
+ return this._initialCameraFov;
549
+ }
550
+ get initialCameraPosition() {
551
+ return this._initialCameraPosition;
552
+ }
553
+ get initialControlsTarget() {
554
+ return this._initialControlsTarget;
555
+ }
556
+ get initialViewCaptured() {
557
+ return this._initialViewCaptured;
558
+ }
559
+ get modelHover() {
560
+ return this._modelHover;
561
+ }
562
+ get modelInteractionActive() {
563
+ return this._modelInteractionActive;
564
+ }
565
+ get pointer() {
566
+ return this._pointer;
567
+ }
568
+ get spaceMouseMoving() {
569
+ return this._spaceMouseMoving;
570
+ }
571
+ get viewResetActive() {
572
+ return this._viewResetActive;
573
+ }
574
+ get wheelZoomTargetDistance() {
575
+ return this._wheelZoomTargetDistance;
576
+ }
577
+ get zoomResetTargetDistance() {
578
+ return this._zoomResetTargetDistance;
579
+ }
580
+ }
581
+ //# sourceMappingURL=SpatialElementInteractionController.js.map