@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 @@
1
+ {"version":3,"file":"PresentationLease.js","sourceRoot":"","sources":["../../src/catalog/PresentationLease.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,MAAM,OAAO,iBAAiB;IAKnB;IACQ;IALV,KAAK,GAAW,EAAE,CAAC;IACnB,QAAQ,GAAG,KAAK,CAAC;IACjB,SAAS,GAAG,CAAC,CAAC;IACtB,YACU,KAAQ,EACA,OAA2B;QADnC,UAAK,GAAL,KAAK,CAAG;QACA,YAAO,GAAP,OAAO,CAAoB;IAC1C,CAAC;IAEJ,KAAK;QACJ,IAAI,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC3E,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;QAChC,IAAI,CAAC,SAAS,EAAE,CAAC;QACjB,OAAO;YACN,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK;YACvD,OAAO,EAAE,GAAG,EAAE;gBACb,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK;oBAAE,OAAO,KAAK,CAAC;gBACxD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;gBACrB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACzB,OAAO,IAAI,CAAC;YACb,CAAC;SACD,CAAC;IACH,CAAC;IAED,IAAI,QAAQ;QACX,OAAO,IAAI,CAAC,SAAS,CAAC;IACvB,CAAC;CACD","sourcesContent":["/** One resource owner at a time; transfer invalidates all earlier release callbacks. */\nexport class PresentationLease<T> {\n\tprivate owner: object = {};\n\tprivate released = false;\n\tprivate transfers = 0;\n\tconstructor(\n\t\treadonly value: T,\n\t\tprivate readonly dispose: (value: T) => void\n\t) {}\n\n\tclaim() {\n\t\tif (this.released) throw new Error('Cannot adopt a released presentation');\n\t\tconst owner = (this.owner = {});\n\t\tthis.transfers++;\n\t\treturn {\n\t\t\tvalue: this.value,\n\t\t\tisCurrent: () => !this.released && this.owner === owner,\n\t\t\trelease: () => {\n\t\t\t\tif (this.released || this.owner !== owner) return false;\n\t\t\t\tthis.released = true;\n\t\t\t\tthis.dispose(this.value);\n\t\t\t\treturn true;\n\t\t\t}\n\t\t};\n\t}\n\n\tget revision() {\n\t\treturn this.transfers;\n\t}\n}\n"]}
@@ -0,0 +1,63 @@
1
+ import * as THREE from 'three/webgpu';
2
+ import type { SpatialElementRefinement } from '../stage/SpatialElementRefinement.js';
3
+ export interface SpatialElementProjection {
4
+ /** Visible section rectangle in CSS pixels, copied before its DOM owner unmounts. */
5
+ viewportClip?: {
6
+ left: number;
7
+ top: number;
8
+ width: number;
9
+ height: number;
10
+ };
11
+ environmentIntensity?: number;
12
+ /** Preserve the catalog depth cue while a rear element travels between render owners. */
13
+ fog?: THREE.Fog | THREE.FogExp2 | null;
14
+ model: THREE.Matrix4;
15
+ camera: THREE.Matrix4;
16
+ clip: THREE.Matrix4;
17
+ }
18
+ export declare function captureSpatialElementProjection(model: THREE.Object3D, camera: THREE.PerspectiveCamera): SpatialElementProjection;
19
+ /** A renderer-owned element with copied projection and independently retained asset resources. */
20
+ export declare class SpatialGeometryCapture {
21
+ readonly model: THREE.Object3D;
22
+ private source;
23
+ getRenderTargets(): THREE.RenderTarget<THREE.Texture<unknown, THREE.TextureEventMap>, THREE.RenderTargetEventMap>[];
24
+ private readonly scene;
25
+ private readonly camera;
26
+ private target?;
27
+ private submitted?;
28
+ private disposed;
29
+ private progress;
30
+ private highWeight;
31
+ private initialHighWeight;
32
+ private frames;
33
+ private sourceEnvironmentIntensity;
34
+ constructor(model: THREE.Object3D, source: SpatialElementProjection, options: {
35
+ environment: THREE.Texture | null;
36
+ environmentIntensity?: number;
37
+ highEnvironment?: THREE.Texture;
38
+ referencePoint?: THREE.Vector3;
39
+ lights: THREE.Light[];
40
+ high?: THREE.Object3D;
41
+ highWeight?: number;
42
+ blend?: SpatialElementRefinement;
43
+ release(): boolean | void;
44
+ });
45
+ private readonly options;
46
+ setTarget(target: SpatialElementProjection, progress: number, refinement: number): void;
47
+ /** Rebase on the exact submitted projection, without a camera or model reset. */
48
+ freeze(): void;
49
+ render(renderer: THREE.WebGPURenderer): void;
50
+ getSnapshot(): {
51
+ frames: number;
52
+ progress: number;
53
+ highWeight: number;
54
+ projection: THREE.Matrix4Tuple;
55
+ disposed: boolean;
56
+ };
57
+ getPoint(): {
58
+ x: number;
59
+ y: number;
60
+ };
61
+ dispose(): void;
62
+ }
63
+ //# sourceMappingURL=SpatialGeometryCapture.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"SpatialGeometryCapture.d.ts","sourceRoot":"","sources":["../../src/catalog/SpatialGeometryCapture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAMtC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAErF,MAAM,WAAW,wBAAwB;IACxC,qFAAqF;IACrF,YAAY,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5E,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,yFAAyF;IACzF,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,GAAG,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC;IACvC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC;IACrB,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC;IACtB,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC;CACpB;AAED,wBAAgB,+BAA+B,CAC9C,KAAK,EAAE,KAAK,CAAC,QAAQ,EACrB,MAAM,EAAE,KAAK,CAAC,iBAAiB,GAC7B,wBAAwB,CAa1B;AAED,kGAAkG;AAClG,qBAAa,sBAAsB;IAgBjC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ;IAC9B,OAAO,CAAC,MAAM;IAhBf,gBAAgB;IAGhB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiC;IACxD,OAAO,CAAC,MAAM,CAAC,CAA2B;IAC1C,OAAO,CAAC,SAAS,CAAC,CAA2B;IAC7C,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,0BAA0B,CAAS;gBAGjC,KAAK,EAAE,KAAK,CAAC,QAAQ,EACtB,MAAM,EAAE,wBAAwB,EACxC,OAAO,EAAE;QACR,WAAW,EAAE,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC;QAClC,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAC9B,eAAe,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC;QAChC,cAAc,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC;QAC/B,MAAM,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,wBAAwB,CAAC;QACjC,OAAO,IAAI,OAAO,GAAG,IAAI,CAAC;KAC1B;IAYF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAUtB;IAEF,SAAS,CAAC,MAAM,EAAE,wBAAwB,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;IAMhF,iFAAiF;IACjF,MAAM;IAQN,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,cAAc;IAkFrC,WAAW;;;;;;;IAUX,QAAQ;;;;IAWR,OAAO;CAYP"}
@@ -0,0 +1,158 @@
1
+ import * as THREE from 'three/webgpu';
2
+ import { getSpatialElementHandoffProjection, interpolatePose, normalizeSpatialElementClipMatrix } from './CatalogSpatialElementLayer.js';
3
+ export function captureSpatialElementProjection(model, camera) {
4
+ model.updateWorldMatrix(true, true);
5
+ camera.updateMatrixWorld();
6
+ return {
7
+ model: model.matrixWorld.clone(),
8
+ camera: camera.matrixWorld.clone(),
9
+ clip: normalizeSpatialElementClipMatrix(new THREE.Matrix4()
10
+ .multiplyMatrices(camera.projectionMatrix, camera.matrixWorldInverse)
11
+ .multiply(model.matrixWorld), new THREE.Vector3())
12
+ };
13
+ }
14
+ /** A renderer-owned element with copied projection and independently retained asset resources. */
15
+ export class SpatialGeometryCapture {
16
+ model;
17
+ source;
18
+ getRenderTargets() {
19
+ return this.disposed ? [] : (this.options.blend?.getRenderTargets() ?? []);
20
+ }
21
+ scene = new THREE.Scene();
22
+ camera = new THREE.PerspectiveCamera();
23
+ target;
24
+ submitted;
25
+ disposed = false;
26
+ progress = 0;
27
+ highWeight;
28
+ initialHighWeight;
29
+ frames = 0;
30
+ sourceEnvironmentIntensity;
31
+ constructor(model, source, options) {
32
+ this.model = model;
33
+ this.source = source;
34
+ this.options = options;
35
+ this.initialHighWeight = this.highWeight = options.highWeight ?? 0;
36
+ this.scene.environment = options.environment;
37
+ this.sourceEnvironmentIntensity = this.scene.environmentIntensity =
38
+ options.environmentIntensity ?? 0.5;
39
+ for (const light of options.lights)
40
+ this.scene.add(light.clone());
41
+ this.scene.add(model);
42
+ model.matrixAutoUpdate = false;
43
+ model.matrix.copy(source.model);
44
+ }
45
+ options;
46
+ setTarget(target, progress, refinement) {
47
+ this.target = target;
48
+ this.progress = progress;
49
+ this.highWeight = this.initialHighWeight * (1 - refinement);
50
+ }
51
+ /** Rebase on the exact submitted projection, without a camera or model reset. */
52
+ freeze() {
53
+ this.sourceEnvironmentIntensity = this.scene.environmentIntensity;
54
+ if (this.submitted)
55
+ this.source = this.submitted;
56
+ this.target = undefined;
57
+ this.progress = 0;
58
+ this.initialHighWeight = this.highWeight;
59
+ }
60
+ render(renderer) {
61
+ if (this.disposed)
62
+ return;
63
+ const target = this.target ?? this.source;
64
+ this.scene.fog = target.fog ?? this.source.fog ?? null;
65
+ this.scene.environmentIntensity = THREE.MathUtils.lerp(this.sourceEnvironmentIntensity, target.environmentIntensity ?? this.sourceEnvironmentIntensity, this.progress);
66
+ const model = interpolatePose(this.source.model, target.model, this.progress);
67
+ const camera = interpolatePose(this.source.camera, target.camera, this.progress);
68
+ this.model.matrix.copy(model);
69
+ this.model.matrixWorldNeedsUpdate = true;
70
+ this.camera.coordinateSystem = renderer.coordinateSystem;
71
+ camera.decompose(this.camera.position, this.camera.quaternion, this.camera.scale);
72
+ this.camera.updateMatrixWorld();
73
+ getSpatialElementHandoffProjection(this.source.clip, target.clip, this.progress, model, camera, {
74
+ sourceModel: this.source.model,
75
+ sourceCamera: this.source.camera,
76
+ targetModel: target.model,
77
+ targetCamera: target.camera,
78
+ reference: this.options.referencePoint
79
+ }, this.camera.projectionMatrix);
80
+ this.camera.projectionMatrixInverse.copy(this.camera.projectionMatrix).invert();
81
+ const viewport = { left: 0, top: 0, width: innerWidth, height: innerHeight };
82
+ const from = this.source.viewportClip ?? viewport, to = target.viewportClip ?? viewport;
83
+ const clip = { ...from };
84
+ for (const key of ['left', 'top', 'width', 'height'])
85
+ clip[key] += (to[key] - from[key]) * this.progress;
86
+ const previousScissor = renderer.getScissor(new THREE.Vector4());
87
+ const previousTest = renderer.getScissorTest();
88
+ const left = Math.max(0, clip.left), top = Math.max(0, clip.top);
89
+ renderer.setScissor(left, top, Math.max(0, Math.min(innerWidth, clip.left + clip.width) - left), Math.max(0, Math.min(innerHeight, clip.top + clip.height) - top));
90
+ renderer.setScissorTest(true);
91
+ try {
92
+ const children = [...this.model.children];
93
+ const draw = (high) => {
94
+ this.scene.environment = high
95
+ ? (this.options.highEnvironment ?? this.options.environment)
96
+ : this.options.environment;
97
+ for (const child of children)
98
+ child.visible = (child === this.options.high) === high;
99
+ renderer.clear();
100
+ renderer.render(this.scene, this.camera);
101
+ };
102
+ renderer.clearDepth();
103
+ if (this.options.high && this.options.blend && this.highWeight > 0 && this.highWeight < 1)
104
+ this.options.blend.render(renderer, draw, false, this.highWeight);
105
+ else {
106
+ this.scene.environment =
107
+ this.highWeight >= 1
108
+ ? (this.options.highEnvironment ?? this.options.environment)
109
+ : this.options.environment;
110
+ for (const child of children)
111
+ child.visible =
112
+ this.highWeight >= 1 ? child === this.options.high : child !== this.options.high;
113
+ renderer.render(this.scene, this.camera);
114
+ }
115
+ this.submitted = captureSpatialElementProjection(this.model, this.camera);
116
+ this.submitted.fog = this.scene.fog;
117
+ this.submitted.viewportClip = clip;
118
+ this.frames++;
119
+ }
120
+ finally {
121
+ renderer.setScissor(previousScissor);
122
+ renderer.setScissorTest(previousTest);
123
+ }
124
+ }
125
+ getSnapshot() {
126
+ return {
127
+ frames: this.frames,
128
+ progress: this.progress,
129
+ highWeight: this.highWeight,
130
+ projection: (this.submitted ?? this.source).clip.toArray(),
131
+ disposed: this.disposed
132
+ };
133
+ }
134
+ getPoint() {
135
+ const point = this.options.referencePoint ?? new THREE.Vector3();
136
+ const clip = new THREE.Vector4(point.x, point.y, point.z, 1).applyMatrix4((this.submitted ?? this.source).clip);
137
+ return {
138
+ x: ((clip.x / clip.w + 1) * innerWidth) / 2,
139
+ y: ((1 - clip.y / clip.w) * innerHeight) / 2
140
+ };
141
+ }
142
+ dispose() {
143
+ if (this.disposed)
144
+ return;
145
+ this.disposed = true;
146
+ this.model.removeFromParent();
147
+ // Returning false hands the prepared blend back to its still-live page owner.
148
+ let retained = false;
149
+ try {
150
+ retained = this.options.release() === false;
151
+ }
152
+ finally {
153
+ if (!retained)
154
+ this.options.blend?.dispose();
155
+ }
156
+ }
157
+ }
158
+ //# sourceMappingURL=SpatialGeometryCapture.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"SpatialGeometryCapture.js","sourceRoot":"","sources":["../../src/catalog/SpatialGeometryCapture.ts"],"names":[],"mappings":"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","sourcesContent":["import * as THREE from 'three/webgpu';\nimport {\n\tgetSpatialElementHandoffProjection,\n\tinterpolatePose,\n\tnormalizeSpatialElementClipMatrix\n} from './CatalogSpatialElementLayer.js';\nimport type { SpatialElementRefinement } from '../stage/SpatialElementRefinement.js';\n\nexport interface SpatialElementProjection {\n\t/** Visible section rectangle in CSS pixels, copied before its DOM owner unmounts. */\n\tviewportClip?: { left: number; top: number; width: number; height: number };\n\tenvironmentIntensity?: number;\n\t/** Preserve the catalog depth cue while a rear element travels between render owners. */\n\tfog?: THREE.Fog | THREE.FogExp2 | null;\n\tmodel: THREE.Matrix4;\n\tcamera: THREE.Matrix4;\n\tclip: THREE.Matrix4;\n}\n\nexport function captureSpatialElementProjection(\n\tmodel: THREE.Object3D,\n\tcamera: THREE.PerspectiveCamera\n): SpatialElementProjection {\n\tmodel.updateWorldMatrix(true, true);\n\tcamera.updateMatrixWorld();\n\treturn {\n\t\tmodel: model.matrixWorld.clone(),\n\t\tcamera: camera.matrixWorld.clone(),\n\t\tclip: normalizeSpatialElementClipMatrix(\n\t\t\tnew THREE.Matrix4()\n\t\t\t\t.multiplyMatrices(camera.projectionMatrix, camera.matrixWorldInverse)\n\t\t\t\t.multiply(model.matrixWorld),\n\t\t\tnew THREE.Vector3()\n\t\t)\n\t};\n}\n\n/** A renderer-owned element with copied projection and independently retained asset resources. */\nexport class SpatialGeometryCapture {\n\tgetRenderTargets() {\n\t\treturn this.disposed ? [] : (this.options.blend?.getRenderTargets() ?? []);\n\t}\n\tprivate readonly scene = new THREE.Scene();\n\tprivate readonly camera = new THREE.PerspectiveCamera();\n\tprivate target?: SpatialElementProjection;\n\tprivate submitted?: SpatialElementProjection;\n\tprivate disposed = false;\n\tprivate progress = 0;\n\tprivate highWeight: number;\n\tprivate initialHighWeight: number;\n\tprivate frames = 0;\n\tprivate sourceEnvironmentIntensity: number;\n\n\tconstructor(\n\t\treadonly model: THREE.Object3D,\n\t\tprivate source: SpatialElementProjection,\n\t\toptions: {\n\t\t\tenvironment: THREE.Texture | null;\n\t\t\tenvironmentIntensity?: number;\n\t\t\thighEnvironment?: THREE.Texture;\n\t\t\treferencePoint?: THREE.Vector3;\n\t\t\tlights: THREE.Light[];\n\t\t\thigh?: THREE.Object3D;\n\t\t\thighWeight?: number;\n\t\t\tblend?: SpatialElementRefinement;\n\t\t\trelease(): boolean | void;\n\t\t}\n\t) {\n\t\tthis.options = options;\n\t\tthis.initialHighWeight = this.highWeight = options.highWeight ?? 0;\n\t\tthis.scene.environment = options.environment;\n\t\tthis.sourceEnvironmentIntensity = this.scene.environmentIntensity =\n\t\t\toptions.environmentIntensity ?? 0.5;\n\t\tfor (const light of options.lights) this.scene.add(light.clone());\n\t\tthis.scene.add(model);\n\t\tmodel.matrixAutoUpdate = false;\n\t\tmodel.matrix.copy(source.model);\n\t}\n\tprivate readonly options: {\n\t\tenvironment: THREE.Texture | null;\n\t\tenvironmentIntensity?: number;\n\t\thighEnvironment?: THREE.Texture;\n\t\treferencePoint?: THREE.Vector3;\n\t\tlights: THREE.Light[];\n\t\thigh?: THREE.Object3D;\n\t\thighWeight?: number;\n\t\tblend?: SpatialElementRefinement;\n\t\trelease(): boolean | void;\n\t};\n\n\tsetTarget(target: SpatialElementProjection, progress: number, refinement: number) {\n\t\tthis.target = target;\n\t\tthis.progress = progress;\n\t\tthis.highWeight = this.initialHighWeight * (1 - refinement);\n\t}\n\n\t/** Rebase on the exact submitted projection, without a camera or model reset. */\n\tfreeze() {\n\t\tthis.sourceEnvironmentIntensity = this.scene.environmentIntensity;\n\t\tif (this.submitted) this.source = this.submitted;\n\t\tthis.target = undefined;\n\t\tthis.progress = 0;\n\t\tthis.initialHighWeight = this.highWeight;\n\t}\n\n\trender(renderer: THREE.WebGPURenderer) {\n\t\tif (this.disposed) return;\n\t\tconst target = this.target ?? this.source;\n\t\tthis.scene.fog = target.fog ?? this.source.fog ?? null;\n\t\tthis.scene.environmentIntensity = THREE.MathUtils.lerp(\n\t\t\tthis.sourceEnvironmentIntensity,\n\t\t\ttarget.environmentIntensity ?? this.sourceEnvironmentIntensity,\n\t\t\tthis.progress\n\t\t);\n\t\tconst model = interpolatePose(this.source.model, target.model, this.progress);\n\t\tconst camera = interpolatePose(this.source.camera, target.camera, this.progress);\n\t\tthis.model.matrix.copy(model);\n\t\tthis.model.matrixWorldNeedsUpdate = true;\n\t\tthis.camera.coordinateSystem = renderer.coordinateSystem;\n\t\tcamera.decompose(this.camera.position, this.camera.quaternion, this.camera.scale);\n\t\tthis.camera.updateMatrixWorld();\n\t\tgetSpatialElementHandoffProjection(\n\t\t\tthis.source.clip,\n\t\t\ttarget.clip,\n\t\t\tthis.progress,\n\t\t\tmodel,\n\t\t\tcamera,\n\t\t\t{\n\t\t\t\tsourceModel: this.source.model,\n\t\t\t\tsourceCamera: this.source.camera,\n\t\t\t\ttargetModel: target.model,\n\t\t\t\ttargetCamera: target.camera,\n\t\t\t\treference: this.options.referencePoint\n\t\t\t},\n\t\t\tthis.camera.projectionMatrix\n\t\t);\n\t\tthis.camera.projectionMatrixInverse.copy(this.camera.projectionMatrix).invert();\n\t\tconst viewport = { left: 0, top: 0, width: innerWidth, height: innerHeight };\n\t\tconst from = this.source.viewportClip ?? viewport,\n\t\t\tto = target.viewportClip ?? viewport;\n\t\tconst clip = { ...from };\n\t\tfor (const key of ['left', 'top', 'width', 'height'] as const)\n\t\t\tclip[key] += (to[key] - from[key]) * this.progress;\n\t\tconst previousScissor = renderer.getScissor(new THREE.Vector4());\n\t\tconst previousTest = renderer.getScissorTest();\n\t\tconst left = Math.max(0, clip.left),\n\t\t\ttop = Math.max(0, clip.top);\n\t\trenderer.setScissor(\n\t\t\tleft,\n\t\t\ttop,\n\t\t\tMath.max(0, Math.min(innerWidth, clip.left + clip.width) - left),\n\t\t\tMath.max(0, Math.min(innerHeight, clip.top + clip.height) - top)\n\t\t);\n\t\trenderer.setScissorTest(true);\n\t\ttry {\n\t\t\tconst children = [...this.model.children];\n\t\t\tconst draw = (high: boolean) => {\n\t\t\t\tthis.scene.environment = high\n\t\t\t\t\t? (this.options.highEnvironment ?? this.options.environment)\n\t\t\t\t\t: this.options.environment;\n\t\t\t\tfor (const child of children) child.visible = (child === this.options.high) === high;\n\t\t\t\trenderer.clear();\n\t\t\t\trenderer.render(this.scene, this.camera);\n\t\t\t};\n\t\t\trenderer.clearDepth();\n\t\t\tif (this.options.high && this.options.blend && this.highWeight > 0 && this.highWeight < 1)\n\t\t\t\tthis.options.blend.render(renderer, draw, false, this.highWeight);\n\t\t\telse {\n\t\t\t\tthis.scene.environment =\n\t\t\t\t\tthis.highWeight >= 1\n\t\t\t\t\t\t? (this.options.highEnvironment ?? this.options.environment)\n\t\t\t\t\t\t: this.options.environment;\n\t\t\t\tfor (const child of children)\n\t\t\t\t\tchild.visible =\n\t\t\t\t\t\tthis.highWeight >= 1 ? child === this.options.high : child !== this.options.high;\n\t\t\t\trenderer.render(this.scene, this.camera);\n\t\t\t}\n\t\t\tthis.submitted = captureSpatialElementProjection(this.model, this.camera);\n\t\t\tthis.submitted.fog = this.scene.fog;\n\t\t\tthis.submitted.viewportClip = clip;\n\t\t\tthis.frames++;\n\t\t} finally {\n\t\t\trenderer.setScissor(previousScissor);\n\t\t\trenderer.setScissorTest(previousTest);\n\t\t}\n\t}\n\n\tgetSnapshot() {\n\t\treturn {\n\t\t\tframes: this.frames,\n\t\t\tprogress: this.progress,\n\t\t\thighWeight: this.highWeight,\n\t\t\tprojection: (this.submitted ?? this.source).clip.toArray(),\n\t\t\tdisposed: this.disposed\n\t\t};\n\t}\n\n\tgetPoint() {\n\t\tconst point = this.options.referencePoint ?? new THREE.Vector3();\n\t\tconst clip = new THREE.Vector4(point.x, point.y, point.z, 1).applyMatrix4(\n\t\t\t(this.submitted ?? this.source).clip\n\t\t);\n\t\treturn {\n\t\t\tx: ((clip.x / clip.w + 1) * innerWidth) / 2,\n\t\t\ty: ((1 - clip.y / clip.w) * innerHeight) / 2\n\t\t};\n\t}\n\n\tdispose() {\n\t\tif (this.disposed) return;\n\t\tthis.disposed = true;\n\t\tthis.model.removeFromParent();\n\t\t// Returning false hands the prepared blend back to its still-live page owner.\n\t\tlet retained = false;\n\t\ttry {\n\t\t\tretained = this.options.release() === false;\n\t\t} finally {\n\t\t\tif (!retained) this.options.blend?.dispose();\n\t\t}\n\t}\n}\n"]}
@@ -0,0 +1,92 @@
1
+ import type { SpatialElementAssetResource } from '../spatialElementAssets.js';
2
+ import type { PreparationGate } from '../PreparationGate.js';
3
+ import { type LoadedSpatialElementAsset, type SpatialElementAssetInstance } from './spatialElementAssetResources.js';
4
+ export type { LoadedSpatialElementAsset, SpatialElementAssetInstance } from './spatialElementAssetResources.js';
5
+ export interface SpatialElementAssetLoader {
6
+ load(resource: SpatialElementAssetResource, options: {
7
+ signal: AbortSignal;
8
+ }): Promise<LoadedSpatialElementAsset>;
9
+ dispose?(): void;
10
+ }
11
+ export interface SpatialElementAssetLease {
12
+ readonly key: string;
13
+ /** Decoded CPU readiness only; the renderer separately establishes GPU readiness. */
14
+ readonly ready: Promise<LoadedSpatialElementAsset>;
15
+ /** A live instance pins shared resources independently of this lease. */
16
+ createInstance(): Promise<SpatialElementAssetInstance>;
17
+ release(): void;
18
+ }
19
+ export declare function getSpatialElementAssetResourceKey(resource: SpatialElementAssetResource): string;
20
+ /** Runtime-owned cache with separate lease, instance, and decoded-resource lifetimes. */
21
+ export declare class SpatialElementAssetManager {
22
+ private readonly cache;
23
+ private readonly entries;
24
+ private readonly loader;
25
+ private readonly maxIdleEntries;
26
+ private readonly maxIdleBytes;
27
+ private clock;
28
+ private loadingCount;
29
+ private disposed;
30
+ private loaderDisposed;
31
+ private readonly loads;
32
+ constructor(options?: {
33
+ loader?: SpatialElementAssetLoader;
34
+ dracoDecoderPath?: string;
35
+ maxIdleEntries?: number;
36
+ maxIdleBytes?: number;
37
+ preparationGate?: PreparationGate;
38
+ });
39
+ private readonly preparationGate?;
40
+ setDracoDecoderPath(path: string): void;
41
+ acquire(resource: SpatialElementAssetResource, options?: {
42
+ signal?: AbortSignal;
43
+ }): SpatialElementAssetLease;
44
+ /** Replaces one resource generation; existing instances retain their owned resources. */
45
+ invalidate(resource: SpatialElementAssetResource): void;
46
+ /** Evicts least-recently-used idle assets without touching active leases or instances. */
47
+ trim(maxIdleEntries?: number): void;
48
+ getStats(): {
49
+ estimatedResidentBytes: number;
50
+ loadTimings: {
51
+ url: string;
52
+ fetchMs: number;
53
+ decodeMs: number;
54
+ gateWaitMs: number;
55
+ }[];
56
+ estimatedIdleBytes: number;
57
+ cachedResources: number;
58
+ pendingLoads: number;
59
+ activeLeases: number;
60
+ activeInstances: number;
61
+ idleResources: number;
62
+ };
63
+ /** Closes the cache; live instances remain valid until their owners release them. */
64
+ dispose(): void;
65
+ private startLoad;
66
+ private retire;
67
+ private releaseUnused;
68
+ private disposeEntryWhenUnused;
69
+ private disposeLoaderWhenIdle;
70
+ }
71
+ /** Lazy shared decoder setup; network cancellation does not pretend to cancel GLTF decoding. */
72
+ export declare class GltfSpatialElementAssetLoader implements SpatialElementAssetLoader {
73
+ private readonly gate?;
74
+ private decoderPath;
75
+ constructor(gate?: PreparationGate | undefined, decoderPath?: string);
76
+ setDracoDecoderPath(path: string): void;
77
+ private setup?;
78
+ load(resource: SpatialElementAssetResource, { signal }: {
79
+ signal: AbortSignal;
80
+ }): Promise<{
81
+ scene: import("three").Group<import("three").Object3DEventMap>;
82
+ scenes: import("three").Group<import("three").Object3DEventMap>[];
83
+ animations: import("three").AnimationClip[];
84
+ timings: {
85
+ fetchMs: number;
86
+ decodeMs: number;
87
+ gateWaitMs: number;
88
+ };
89
+ }>;
90
+ dispose(): void;
91
+ }
92
+ //# sourceMappingURL=SpatialElementAssetManager.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"SpatialElementAssetManager.d.ts","sourceRoot":"","sources":["../../../src/catalog/assets/SpatialElementAssetManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAC9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,EAGN,KAAK,yBAAyB,EAC9B,KAAK,2BAA2B,EAChC,MAAM,mCAAmC,CAAC;AAE3C,YAAY,EAAE,yBAAyB,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AAEhH,MAAM,WAAW,yBAAyB;IACzC,IAAI,CACH,QAAQ,EAAE,2BAA2B,EACrC,OAAO,EAAE;QAAE,MAAM,EAAE,WAAW,CAAA;KAAE,GAC9B,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACtC,OAAO,CAAC,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACxC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,qFAAqF;IACrF,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACnD,yEAAyE;IACzE,cAAc,IAAI,OAAO,CAAC,2BAA2B,CAAC,CAAC;IACvD,OAAO,IAAI,IAAI,CAAC;CAChB;AAiBD,wBAAgB,iCAAiC,CAAC,QAAQ,EAAE,2BAA2B,UAWtF;AAMD,yFAAyF;AACzF,qBAAa,0BAA0B;IACtC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiC;IACvD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;IACnD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAClB;gBAGH,OAAO,GAAE;QACR,MAAM,CAAC,EAAE,yBAAyB,CAAC;QACnC,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,eAAe,CAAC,EAAE,eAAe,CAAC;KAC7B;IAOP,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAkB;IAEnD,mBAAmB,CAAC,IAAI,EAAE,MAAM;IAIhC,OAAO,CACN,QAAQ,EAAE,2BAA2B,EACrC,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GACpC,wBAAwB;IA0D3B,yFAAyF;IACzF,UAAU,CAAC,QAAQ,EAAE,2BAA2B;IAKhD,0FAA0F;IAC1F,IAAI,CAAC,cAAc,SAAsB;IAczC,QAAQ;;;iBAzGuB,MAAM;qBAAW,MAAM;sBAAY,MAAM;wBAAc,MAAM;;;;;;;;;IAmI5F,qFAAqF;IACrF,OAAO;IAOP,OAAO,CAAC,SAAS;IA0DjB,OAAO,CAAC,MAAM;IAUd,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,sBAAsB;IAU9B,OAAO,CAAC,qBAAqB;CAK7B;AAED,gGAAgG;AAChG,qBAAa,6BAA8B,YAAW,yBAAyB;IAClE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;IAAmB,OAAO,CAAC,WAAW;gBAA3C,IAAI,CAAC,EAAE,eAAe,YAAA,EAAU,WAAW,SAAwB;IAChG,mBAAmB,CAAC,IAAI,EAAE,MAAM;IAIhC,OAAO,CAAC,KAAK,CAAC,CAGX;IAEG,IAAI,CAAC,QAAQ,EAAE,2BAA2B,EAAE,EAAE,MAAM,EAAE,EAAE;QAAE,MAAM,EAAE,WAAW,CAAA;KAAE;;;;;;;;;;IAyCrF,OAAO;CAMP"}
@@ -0,0 +1,305 @@
1
+ import { estimateAssetBytes } from './assetCosts.js';
2
+ import { createSpatialElementAssetInstance, disposeLoadedSpatialElementAsset } from './spatialElementAssetResources.js';
3
+ export function getSpatialElementAssetResourceKey(resource) {
4
+ if (!resource.url || !resource.revision) {
5
+ throw new Error('SpatialElement asset requests require a URL and revision');
6
+ }
7
+ return JSON.stringify([
8
+ resource.format,
9
+ resource.url,
10
+ resource.revision,
11
+ [...new Set(resource.requirements?.decoders ?? [])].sort(),
12
+ [...new Set(resource.requirements?.extensions ?? [])].sort()
13
+ ]);
14
+ }
15
+ function abortError(message = 'SpatialElement asset operation was cancelled') {
16
+ return new DOMException(message, 'AbortError');
17
+ }
18
+ /** Runtime-owned cache with separate lease, instance, and decoded-resource lifetimes. */
19
+ export class SpatialElementAssetManager {
20
+ cache = new Map();
21
+ entries = new Set();
22
+ loader;
23
+ maxIdleEntries;
24
+ maxIdleBytes;
25
+ clock = 0;
26
+ loadingCount = 0;
27
+ disposed = false;
28
+ loaderDisposed = false;
29
+ loads = [];
30
+ constructor(options = {}) {
31
+ this.loader = options.loader ?? new GltfSpatialElementAssetLoader(options.preparationGate, options.dracoDecoderPath);
32
+ this.preparationGate = options.preparationGate;
33
+ this.maxIdleEntries = Math.max(0, Math.floor(options.maxIdleEntries ?? 6));
34
+ this.maxIdleBytes = Math.max(0, options.maxIdleBytes ?? 96 * 1024 * 1024);
35
+ }
36
+ preparationGate;
37
+ setDracoDecoderPath(path) {
38
+ if (this.loader instanceof GltfSpatialElementAssetLoader)
39
+ this.loader.setDracoDecoderPath(path);
40
+ }
41
+ acquire(resource, options = {}) {
42
+ if (this.disposed)
43
+ throw new Error('SpatialElementAssetManager has been disposed');
44
+ if (options.signal?.aborted)
45
+ throw abortError();
46
+ const key = getSpatialElementAssetResourceKey(resource);
47
+ const entry = this.cache.get(key) ?? this.startLoad(key, resource);
48
+ entry.leases += 1;
49
+ entry.lastUsed = ++this.clock;
50
+ let released = false;
51
+ let rejectReady = () => { };
52
+ const release = () => {
53
+ if (released)
54
+ return;
55
+ released = true;
56
+ options.signal?.removeEventListener('abort', release);
57
+ rejectReady(abortError());
58
+ entry.leases -= 1;
59
+ entry.lastUsed = ++this.clock;
60
+ this.releaseUnused(entry);
61
+ };
62
+ const ready = new Promise((resolve, reject) => {
63
+ rejectReady = reject;
64
+ entry.promise.then((asset) => {
65
+ if (released || entry.retired) {
66
+ reject(abortError());
67
+ release();
68
+ }
69
+ else
70
+ resolve(asset);
71
+ }, (error) => {
72
+ reject(error);
73
+ release();
74
+ });
75
+ });
76
+ // A caller may release speculative work without ever awaiting it.
77
+ void ready.catch(() => { });
78
+ options.signal?.addEventListener('abort', release, { once: true });
79
+ return {
80
+ key,
81
+ ready,
82
+ createInstance: async () => {
83
+ const asset = await ready;
84
+ if (released || entry.retired)
85
+ throw abortError();
86
+ const create = () => {
87
+ if (released || entry.retired)
88
+ throw abortError();
89
+ const instance = createSpatialElementAssetInstance(asset, () => {
90
+ entry.instances -= 1;
91
+ entry.lastUsed = ++this.clock;
92
+ this.releaseUnused(entry);
93
+ });
94
+ entry.instances += 1;
95
+ return instance;
96
+ };
97
+ return this.preparationGate ? this.preparationGate.run(create, options.signal) : create();
98
+ },
99
+ release
100
+ };
101
+ }
102
+ /** Replaces one resource generation; existing instances retain their owned resources. */
103
+ invalidate(resource) {
104
+ const entry = this.cache.get(getSpatialElementAssetResourceKey(resource));
105
+ if (entry)
106
+ this.retire(entry);
107
+ }
108
+ /** Evicts least-recently-used idle assets without touching active leases or instances. */
109
+ trim(maxIdleEntries = this.maxIdleEntries) {
110
+ const idle = [...this.cache.values()]
111
+ .filter((entry) => entry.status === 'ready' && entry.leases === 0 && entry.instances === 0)
112
+ .sort((a, b) => a.lastUsed - b.lastUsed);
113
+ let bytes = idle.reduce((sum, entry) => sum + entry.estimatedBytes, 0);
114
+ let count = idle.length;
115
+ for (const entry of idle) {
116
+ if (count <= Math.max(0, Math.floor(maxIdleEntries)) && bytes <= this.maxIdleBytes)
117
+ break;
118
+ bytes -= entry.estimatedBytes;
119
+ count--;
120
+ this.retire(entry);
121
+ }
122
+ }
123
+ getStats() {
124
+ let activeLeases = 0;
125
+ let activeInstances = 0;
126
+ for (const entry of this.entries) {
127
+ activeLeases += entry.leases;
128
+ activeInstances += entry.instances;
129
+ }
130
+ return {
131
+ estimatedResidentBytes: [...this.entries].reduce((sum, entry) => sum + entry.estimatedBytes, 0),
132
+ loadTimings: [...this.loads],
133
+ estimatedIdleBytes: [...this.cache.values()]
134
+ .filter((entry) => entry.status === 'ready' && !entry.leases && !entry.instances)
135
+ .reduce((sum, entry) => sum + entry.estimatedBytes, 0),
136
+ cachedResources: this.cache.size,
137
+ pendingLoads: this.loadingCount,
138
+ activeLeases,
139
+ activeInstances,
140
+ idleResources: [...this.cache.values()].filter((entry) => entry.status === 'ready' && entry.leases === 0 && entry.instances === 0).length
141
+ };
142
+ }
143
+ /** Closes the cache; live instances remain valid until their owners release them. */
144
+ dispose() {
145
+ if (this.disposed)
146
+ return;
147
+ this.disposed = true;
148
+ for (const entry of [...this.entries])
149
+ this.retire(entry);
150
+ this.disposeLoaderWhenIdle();
151
+ }
152
+ startLoad(key, resource) {
153
+ let resolve;
154
+ let reject;
155
+ const promise = new Promise((accept, fail) => {
156
+ resolve = accept;
157
+ reject = fail;
158
+ });
159
+ const entry = {
160
+ key,
161
+ controller: new AbortController(),
162
+ promise,
163
+ resolve,
164
+ reject,
165
+ status: 'loading',
166
+ leases: 0,
167
+ instances: 0,
168
+ lastUsed: ++this.clock,
169
+ retired: false,
170
+ estimatedBytes: 0
171
+ };
172
+ this.cache.set(key, entry);
173
+ this.entries.add(entry);
174
+ this.loadingCount += 1;
175
+ // Defer invocation so synchronous loader failures use the same cleanup path.
176
+ void Promise.resolve()
177
+ .then(() => {
178
+ if (entry.controller.signal.aborted)
179
+ throw abortError();
180
+ return this.loader.load(resource, { signal: entry.controller.signal });
181
+ })
182
+ .then((asset) => {
183
+ if (entry.retired || this.cache.get(key) !== entry) {
184
+ disposeLoadedSpatialElementAsset(asset);
185
+ entry.status = 'failed';
186
+ entry.reject(abortError('A newer spatialElement asset generation replaced this load'));
187
+ return;
188
+ }
189
+ entry.asset = asset;
190
+ entry.estimatedBytes = estimateAssetBytes(asset.scene, ...(asset.scenes ?? []));
191
+ if (asset.timings) {
192
+ this.loads.push({ url: resource.url, ...asset.timings });
193
+ if (this.loads.length > 20)
194
+ this.loads.shift();
195
+ }
196
+ entry.status = 'ready';
197
+ entry.resolve(asset);
198
+ })
199
+ .catch((error) => {
200
+ entry.status = 'failed';
201
+ entry.reject(error);
202
+ this.retire(entry);
203
+ })
204
+ .finally(() => {
205
+ this.loadingCount -= 1;
206
+ this.releaseUnused(entry);
207
+ this.disposeLoaderWhenIdle();
208
+ });
209
+ return entry;
210
+ }
211
+ retire(entry) {
212
+ entry.retired = true;
213
+ if (this.cache.get(entry.key) === entry)
214
+ this.cache.delete(entry.key);
215
+ if (entry.status === 'loading') {
216
+ entry.reject(abortError());
217
+ entry.controller.abort();
218
+ }
219
+ this.disposeEntryWhenUnused(entry);
220
+ }
221
+ releaseUnused(entry) {
222
+ if (entry.leases || entry.instances)
223
+ return;
224
+ if (entry.status === 'loading' || this.disposed || entry.retired)
225
+ this.retire(entry);
226
+ else
227
+ this.trim();
228
+ }
229
+ disposeEntryWhenUnused(entry) {
230
+ if (entry.leases || entry.instances || entry.status === 'loading')
231
+ return;
232
+ if (entry.asset) {
233
+ const asset = entry.asset;
234
+ entry.asset = undefined;
235
+ disposeLoadedSpatialElementAsset(asset);
236
+ }
237
+ this.entries.delete(entry);
238
+ }
239
+ disposeLoaderWhenIdle() {
240
+ if (!this.disposed || this.loadingCount || this.loaderDisposed)
241
+ return;
242
+ this.loaderDisposed = true;
243
+ this.loader.dispose?.();
244
+ }
245
+ }
246
+ /** Lazy shared decoder setup; network cancellation does not pretend to cancel GLTF decoding. */
247
+ export class GltfSpatialElementAssetLoader {
248
+ gate;
249
+ decoderPath;
250
+ constructor(gate, decoderPath = '/assets/draco/gltf/') {
251
+ this.gate = gate;
252
+ this.decoderPath = decoderPath;
253
+ }
254
+ setDracoDecoderPath(path) {
255
+ if (this.setup)
256
+ throw new Error('Configure the Draco decoder path before loading assets');
257
+ this.decoderPath = path;
258
+ }
259
+ setup;
260
+ async load(resource, { signal }) {
261
+ if (resource.requirements?.decoders.includes('ktx2')) {
262
+ throw new Error('KTX2 assets require renderer capability configuration');
263
+ }
264
+ this.setup ??= Promise.all([
265
+ import('three/addons/loaders/GLTFLoader.js'),
266
+ import('three/addons/loaders/DRACOLoader.js'),
267
+ import('three/addons/libs/meshopt_decoder.module.js')
268
+ ]).then(([{ GLTFLoader }, { DRACOLoader }, { MeshoptDecoder }]) => {
269
+ const draco = new DRACOLoader().setDecoderPath(this.decoderPath);
270
+ const gltf = new GLTFLoader().setDRACOLoader(draco).setMeshoptDecoder(MeshoptDecoder);
271
+ return { gltf, draco };
272
+ });
273
+ const { gltf } = await this.setup;
274
+ signal.throwIfAborted();
275
+ const fetchStarted = performance.now();
276
+ const response = await fetch(resource.url, { signal });
277
+ if (!response.ok)
278
+ throw new Error(`Unable to load spatialElement asset (${response.status})`);
279
+ const data = resource.format === 'gltf' ? await response.text() : await response.arrayBuffer();
280
+ const fetched = performance.now();
281
+ signal.throwIfAborted();
282
+ const base = new URL('.', new URL(resource.url, location.href)).href;
283
+ let parseStarted = fetched;
284
+ const parse = () => {
285
+ parseStarted = performance.now();
286
+ return gltf.parseAsync(data, base);
287
+ };
288
+ const loaded = this.gate ? await this.gate.run(parse, signal) : await parse();
289
+ // The manager disposes the decoded result if the request became stale during parse.
290
+ return {
291
+ scene: loaded.scene,
292
+ scenes: loaded.scenes,
293
+ animations: loaded.animations,
294
+ timings: {
295
+ fetchMs: fetched - fetchStarted,
296
+ decodeMs: performance.now() - parseStarted,
297
+ gateWaitMs: parseStarted - fetched
298
+ }
299
+ };
300
+ }
301
+ dispose() {
302
+ void this.setup?.then(({ draco }) => draco.dispose(), () => { });
303
+ }
304
+ }
305
+ //# sourceMappingURL=SpatialElementAssetManager.js.map