@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,147 @@
1
+ import { gaussianTargets } from './renderTargetInventory.js';
2
+ import * as THREE from 'three/webgpu';
3
+ import { gaussianBlur } from 'three/addons/tsl/display/GaussianBlurNode.js';
4
+ import { texture, uniform } from 'three/tsl';
5
+ const BLUR_KERNEL_SIGMA = 6;
6
+ const BLUR_KERNEL_STANDARD_DEVIATION = (3 + 2 * BLUR_KERNEL_SIGMA) / 3;
7
+ const TARGET_RESIDUAL_SIGMA = 5;
8
+ const MAX_DOWNSAMPLE_STEPS = 5;
9
+ /**
10
+ * CSS-pixel Gaussian blur for transparent, display-space captures.
11
+ *
12
+ * A staged 2x pyramid removes high frequencies before reducing resolution. The
13
+ * final Gaussian therefore uses dense samples instead of skipping across the
14
+ * source image, while premultiplied color prevents dark or glowing silhouettes.
15
+ */
16
+ export class MinimapBlurPipeline {
17
+ getRenderTargets() {
18
+ return [
19
+ this.outputTarget,
20
+ ...this.downsamplePasses.map((pass) => pass.target),
21
+ ...gaussianTargets(this.blurNode)
22
+ ];
23
+ }
24
+ outputTarget;
25
+ downsamplePasses = [];
26
+ blurDirection = uniform(new THREE.Vector2());
27
+ blurNode;
28
+ resolveMaterial;
29
+ resolveQuad;
30
+ downsampleSteps;
31
+ blurRadius;
32
+ constructor(inputTexture, blurRadius, maximumSourcePixelsPerCssPixel) {
33
+ this.blurRadius = Math.max(blurRadius, 0);
34
+ this.downsampleSteps = getMinimapBlurDownsampleSteps(this.blurRadius, maximumSourcePixelsPerCssPixel);
35
+ let passTexture = inputTexture;
36
+ for (let index = 0; index < this.downsampleSteps; index += 1) {
37
+ const target = createRenderTarget(THREE.HalfFloatType);
38
+ const sample = texture(passTexture);
39
+ // StageExperience's renderOutput() pass already stores premultiplied
40
+ // display-space RGB. Multiplying by alpha again here makes wider blur
41
+ // radii lose energy and appear darker instead of softer.
42
+ const material = createFullscreenMaterial(sample);
43
+ const quad = new THREE.QuadMesh(material);
44
+ this.downsamplePasses.push({ target, material, quad });
45
+ passTexture = target.texture;
46
+ }
47
+ const blurInput = texture(passTexture);
48
+ this.blurNode = gaussianBlur(blurInput, this.blurDirection, BLUR_KERNEL_SIGMA, {
49
+ // The capture and every pyramid level stay premultiplied until the
50
+ // final resolve below.
51
+ premultipliedAlpha: false,
52
+ resolutionScale: 1
53
+ });
54
+ // Keep the final texture premultiplied as well. Unpremultiplying here and
55
+ // sampling the result again in the minimap compositor made filtering alter
56
+ // silhouette coverage, so a rotated model could appear smaller or clipped.
57
+ this.resolveMaterial = createFullscreenMaterial(this.blurNode);
58
+ this.resolveQuad = new THREE.QuadMesh(this.resolveMaterial);
59
+ this.outputTarget = createRenderTarget(THREE.HalfFloatType);
60
+ }
61
+ setSize(width, height) {
62
+ const resolvedWidth = Math.max(Math.round(width), 1);
63
+ const resolvedHeight = Math.max(Math.round(height), 1);
64
+ this.outputTarget.setSize(resolvedWidth, resolvedHeight);
65
+ let levelWidth = resolvedWidth;
66
+ let levelHeight = resolvedHeight;
67
+ this.downsamplePasses.forEach((pass) => {
68
+ levelWidth = Math.max(Math.round(levelWidth * 0.5), 1);
69
+ levelHeight = Math.max(Math.round(levelHeight * 0.5), 1);
70
+ pass.target.setSize(levelWidth, levelHeight);
71
+ });
72
+ }
73
+ render(renderer, sourcePixelsPerCssPixelX, sourcePixelsPerCssPixelY) {
74
+ this.updateDirection(sourcePixelsPerCssPixelX, sourcePixelsPerCssPixelY);
75
+ this.downsamplePasses.forEach((pass) => {
76
+ renderer.setRenderTarget(pass.target);
77
+ renderer.clear();
78
+ pass.quad.render(renderer);
79
+ });
80
+ renderer.setRenderTarget(this.outputTarget);
81
+ renderer.clear();
82
+ this.resolveQuad.render(renderer);
83
+ }
84
+ dispose() {
85
+ this.downsamplePasses.forEach((pass) => {
86
+ pass.target.dispose();
87
+ pass.material.dispose();
88
+ });
89
+ this.blurNode.dispose();
90
+ this.resolveMaterial.dispose();
91
+ this.outputTarget.dispose();
92
+ }
93
+ updateDirection(sourcePixelsPerCssPixelX, sourcePixelsPerCssPixelY) {
94
+ this.blurDirection.value.copy(getMinimapBlurDirection(this.blurRadius, sourcePixelsPerCssPixelX, sourcePixelsPerCssPixelY, this.downsampleSteps));
95
+ }
96
+ }
97
+ /** Selects a bounded blur pyramid depth for a CSS-pixel blur radius. */
98
+ export function getMinimapBlurDownsampleSteps(blurRadius, maximumSourcePixelsPerCssPixel) {
99
+ const radius = Number.isFinite(blurRadius) ? Math.max(blurRadius, 0) : 0;
100
+ if (radius <= 0.001)
101
+ return 0;
102
+ const sourceDensity = Number.isFinite(maximumSourcePixelsPerCssPixel)
103
+ ? Math.max(maximumSourcePixelsPerCssPixel, 1)
104
+ : 1;
105
+ const sourceSigma = radius * sourceDensity;
106
+ return THREE.MathUtils.clamp(Math.max(Math.ceil(Math.log2(sourceSigma / TARGET_RESIDUAL_SIGMA)), 1), 1, MAX_DOWNSAMPLE_STEPS);
107
+ }
108
+ /**
109
+ * Converts a CSS-pixel blur radius into the Gaussian node's per-axis sample radius.
110
+ *
111
+ * The result compensates for both source pixel density and the selected blur
112
+ * pyramid level.
113
+ */
114
+ export function getMinimapBlurDirection(blurRadius, sourcePixelsPerCssPixelX, sourcePixelsPerCssPixelY, downsampleSteps) {
115
+ const pyramidScale = 2 ** Math.max(Math.floor(downsampleSteps), 0);
116
+ const radius = Number.isFinite(blurRadius) ? Math.max(blurRadius, 0) : 0;
117
+ const densityX = Number.isFinite(sourcePixelsPerCssPixelX)
118
+ ? Math.max(sourcePixelsPerCssPixelX, 0)
119
+ : 0;
120
+ const densityY = Number.isFinite(sourcePixelsPerCssPixelY)
121
+ ? Math.max(sourcePixelsPerCssPixelY, 0)
122
+ : 0;
123
+ return new THREE.Vector2((radius * densityX) / pyramidScale / BLUR_KERNEL_STANDARD_DEVIATION, (radius * densityY) / pyramidScale / BLUR_KERNEL_STANDARD_DEVIATION);
124
+ }
125
+ function createRenderTarget(type) {
126
+ const target = new THREE.RenderTarget(1, 1, {
127
+ depthBuffer: false,
128
+ stencilBuffer: false,
129
+ type
130
+ });
131
+ target.texture.minFilter = THREE.LinearFilter;
132
+ target.texture.magFilter = THREE.LinearFilter;
133
+ target.texture.generateMipmaps = false;
134
+ target.texture.colorSpace = THREE.NoColorSpace;
135
+ return target;
136
+ }
137
+ function createFullscreenMaterial(fragmentNode) {
138
+ const material = new THREE.NodeMaterial();
139
+ material.fragmentNode = fragmentNode;
140
+ material.depthTest = false;
141
+ material.depthWrite = false;
142
+ material.blending = THREE.NoBlending;
143
+ material.toneMapped = false;
144
+ material.needsUpdate = true;
145
+ return material;
146
+ }
147
+ //# sourceMappingURL=MinimapBlurPipeline.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"MinimapBlurPipeline.js","sourceRoot":"","sources":["../../src/stage/MinimapBlurPipeline.ts"],"names":[],"mappings":"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","sourcesContent":["import { gaussianTargets } from './renderTargetInventory.js';\nimport * as THREE from 'three/webgpu';\nimport { gaussianBlur } from 'three/addons/tsl/display/GaussianBlurNode.js';\nimport { texture, uniform } from 'three/tsl';\n\nconst BLUR_KERNEL_SIGMA = 6;\nconst BLUR_KERNEL_STANDARD_DEVIATION = (3 + 2 * BLUR_KERNEL_SIGMA) / 3;\nconst TARGET_RESIDUAL_SIGMA = 5;\nconst MAX_DOWNSAMPLE_STEPS = 5;\n\ninterface DownsamplePass {\n\ttarget: THREE.RenderTarget;\n\tmaterial: THREE.NodeMaterial;\n\tquad: THREE.QuadMesh;\n}\n\n/**\n * CSS-pixel Gaussian blur for transparent, display-space captures.\n *\n * A staged 2x pyramid removes high frequencies before reducing resolution. The\n * final Gaussian therefore uses dense samples instead of skipping across the\n * source image, while premultiplied color prevents dark or glowing silhouettes.\n */\nexport class MinimapBlurPipeline {\n\tgetRenderTargets() {\n\t\treturn [\n\t\t\tthis.outputTarget,\n\t\t\t...this.downsamplePasses.map((pass) => pass.target),\n\t\t\t...gaussianTargets(this.blurNode)\n\t\t];\n\t}\n\treadonly outputTarget: THREE.RenderTarget;\n\n\tprivate readonly downsamplePasses: DownsamplePass[] = [];\n\tprivate readonly blurDirection = uniform(new THREE.Vector2());\n\tprivate readonly blurNode: ReturnType<typeof gaussianBlur>;\n\tprivate readonly resolveMaterial: THREE.NodeMaterial;\n\tprivate readonly resolveQuad: THREE.QuadMesh;\n\tprivate readonly downsampleSteps: number;\n\tprivate readonly blurRadius: number;\n\n\tconstructor(\n\t\tinputTexture: THREE.Texture,\n\t\tblurRadius: number,\n\t\tmaximumSourcePixelsPerCssPixel: number\n\t) {\n\t\tthis.blurRadius = Math.max(blurRadius, 0);\n\t\tthis.downsampleSteps = getMinimapBlurDownsampleSteps(\n\t\t\tthis.blurRadius,\n\t\t\tmaximumSourcePixelsPerCssPixel\n\t\t);\n\n\t\tlet passTexture = inputTexture;\n\t\tfor (let index = 0; index < this.downsampleSteps; index += 1) {\n\t\t\tconst target = createRenderTarget(THREE.HalfFloatType);\n\t\t\tconst sample = texture(passTexture);\n\t\t\t// StageExperience's renderOutput() pass already stores premultiplied\n\t\t\t// display-space RGB. Multiplying by alpha again here makes wider blur\n\t\t\t// radii lose energy and appear darker instead of softer.\n\t\t\tconst material = createFullscreenMaterial(sample);\n\t\t\tconst quad = new THREE.QuadMesh(material);\n\t\t\tthis.downsamplePasses.push({ target, material, quad });\n\t\t\tpassTexture = target.texture;\n\t\t}\n\n\t\tconst blurInput = texture(passTexture);\n\t\tthis.blurNode = gaussianBlur(blurInput, this.blurDirection, BLUR_KERNEL_SIGMA, {\n\t\t\t// The capture and every pyramid level stay premultiplied until the\n\t\t\t// final resolve below.\n\t\t\tpremultipliedAlpha: false,\n\t\t\tresolutionScale: 1\n\t\t});\n\n\t\t// Keep the final texture premultiplied as well. Unpremultiplying here and\n\t\t// sampling the result again in the minimap compositor made filtering alter\n\t\t// silhouette coverage, so a rotated model could appear smaller or clipped.\n\t\tthis.resolveMaterial = createFullscreenMaterial(this.blurNode);\n\t\tthis.resolveQuad = new THREE.QuadMesh(this.resolveMaterial);\n\t\tthis.outputTarget = createRenderTarget(THREE.HalfFloatType);\n\t}\n\n\tsetSize(width: number, height: number) {\n\t\tconst resolvedWidth = Math.max(Math.round(width), 1);\n\t\tconst resolvedHeight = Math.max(Math.round(height), 1);\n\t\tthis.outputTarget.setSize(resolvedWidth, resolvedHeight);\n\n\t\tlet levelWidth = resolvedWidth;\n\t\tlet levelHeight = resolvedHeight;\n\t\tthis.downsamplePasses.forEach((pass) => {\n\t\t\tlevelWidth = Math.max(Math.round(levelWidth * 0.5), 1);\n\t\t\tlevelHeight = Math.max(Math.round(levelHeight * 0.5), 1);\n\t\t\tpass.target.setSize(levelWidth, levelHeight);\n\t\t});\n\t}\n\n\trender(\n\t\trenderer: THREE.WebGPURenderer,\n\t\tsourcePixelsPerCssPixelX: number,\n\t\tsourcePixelsPerCssPixelY: number\n\t) {\n\t\tthis.updateDirection(sourcePixelsPerCssPixelX, sourcePixelsPerCssPixelY);\n\n\t\tthis.downsamplePasses.forEach((pass) => {\n\t\t\trenderer.setRenderTarget(pass.target);\n\t\t\trenderer.clear();\n\t\t\tpass.quad.render(renderer);\n\t\t});\n\n\t\trenderer.setRenderTarget(this.outputTarget);\n\t\trenderer.clear();\n\t\tthis.resolveQuad.render(renderer);\n\t}\n\n\tdispose() {\n\t\tthis.downsamplePasses.forEach((pass) => {\n\t\t\tpass.target.dispose();\n\t\t\tpass.material.dispose();\n\t\t});\n\t\tthis.blurNode.dispose();\n\t\tthis.resolveMaterial.dispose();\n\t\tthis.outputTarget.dispose();\n\t}\n\n\tprivate updateDirection(sourcePixelsPerCssPixelX: number, sourcePixelsPerCssPixelY: number) {\n\t\tthis.blurDirection.value.copy(\n\t\t\tgetMinimapBlurDirection(\n\t\t\t\tthis.blurRadius,\n\t\t\t\tsourcePixelsPerCssPixelX,\n\t\t\t\tsourcePixelsPerCssPixelY,\n\t\t\t\tthis.downsampleSteps\n\t\t\t)\n\t\t);\n\t}\n}\n\n/** Selects a bounded blur pyramid depth for a CSS-pixel blur radius. */\nexport function getMinimapBlurDownsampleSteps(\n\tblurRadius: number,\n\tmaximumSourcePixelsPerCssPixel: number\n) {\n\tconst radius = Number.isFinite(blurRadius) ? Math.max(blurRadius, 0) : 0;\n\tif (radius <= 0.001) return 0;\n\n\tconst sourceDensity = Number.isFinite(maximumSourcePixelsPerCssPixel)\n\t\t? Math.max(maximumSourcePixelsPerCssPixel, 1)\n\t\t: 1;\n\tconst sourceSigma = radius * sourceDensity;\n\treturn THREE.MathUtils.clamp(\n\t\tMath.max(Math.ceil(Math.log2(sourceSigma / TARGET_RESIDUAL_SIGMA)), 1),\n\t\t1,\n\t\tMAX_DOWNSAMPLE_STEPS\n\t);\n}\n\n/**\n * Converts a CSS-pixel blur radius into the Gaussian node's per-axis sample radius.\n *\n * The result compensates for both source pixel density and the selected blur\n * pyramid level.\n */\nexport function getMinimapBlurDirection(\n\tblurRadius: number,\n\tsourcePixelsPerCssPixelX: number,\n\tsourcePixelsPerCssPixelY: number,\n\tdownsampleSteps: number\n) {\n\tconst pyramidScale = 2 ** Math.max(Math.floor(downsampleSteps), 0);\n\tconst radius = Number.isFinite(blurRadius) ? Math.max(blurRadius, 0) : 0;\n\tconst densityX = Number.isFinite(sourcePixelsPerCssPixelX)\n\t\t? Math.max(sourcePixelsPerCssPixelX, 0)\n\t\t: 0;\n\tconst densityY = Number.isFinite(sourcePixelsPerCssPixelY)\n\t\t? Math.max(sourcePixelsPerCssPixelY, 0)\n\t\t: 0;\n\treturn new THREE.Vector2(\n\t\t(radius * densityX) / pyramidScale / BLUR_KERNEL_STANDARD_DEVIATION,\n\t\t(radius * densityY) / pyramidScale / BLUR_KERNEL_STANDARD_DEVIATION\n\t);\n}\n\nfunction createRenderTarget(type: THREE.TextureDataType) {\n\tconst target = new THREE.RenderTarget(1, 1, {\n\t\tdepthBuffer: false,\n\t\tstencilBuffer: false,\n\t\ttype\n\t});\n\ttarget.texture.minFilter = THREE.LinearFilter;\n\ttarget.texture.magFilter = THREE.LinearFilter;\n\ttarget.texture.generateMipmaps = false;\n\ttarget.texture.colorSpace = THREE.NoColorSpace;\n\treturn target;\n}\n\nfunction createFullscreenMaterial(fragmentNode: THREE.Node) {\n\tconst material = new THREE.NodeMaterial();\n\tmaterial.fragmentNode = fragmentNode;\n\tmaterial.depthTest = false;\n\tmaterial.depthWrite = false;\n\tmaterial.blending = THREE.NoBlending;\n\tmaterial.toneMapped = false;\n\tmaterial.needsUpdate = true;\n\treturn material;\n}\n"]}
@@ -0,0 +1,113 @@
1
+ import * as THREE from 'three/webgpu';
2
+ import type { Mesh } from 'three';
3
+ import { type LiquidGlassPanelOptions } from './LiquidGlassPanel.js';
4
+ import type { MinimapCornerRadii } from './minimap/MinimapGeometry.js';
5
+ import type { StageMinimapState } from './minimap/MinimapState.js';
6
+ import type { StageCameraSettings, StageMinimapOptions, StagePanelTarget } from './stageTypes.js';
7
+ import type { StagePanelRuntime } from './StagePanelRuntime.js';
8
+ export interface MinimapPorts {
9
+ renderer: THREE.WebGPURenderer;
10
+ camera: THREE.PerspectiveCamera;
11
+ panelCamera: THREE.PerspectiveCamera;
12
+ panelScene: THREE.Scene;
13
+ panel(index: number): StagePanelRuntime | undefined;
14
+ target(index: number): StagePanelTarget | undefined;
15
+ spatialElement(): {
16
+ model?: THREE.Object3D;
17
+ low?: THREE.Object3D;
18
+ camera: StageCameraSettings;
19
+ restCamera: THREE.Quaternion;
20
+ restModel: THREE.Quaternion;
21
+ hasControls: boolean;
22
+ referenceTarget: THREE.Vector3;
23
+ };
24
+ frame(): {
25
+ hovering: boolean;
26
+ interacting: boolean;
27
+ scrolling: boolean;
28
+ };
29
+ environment(): THREE.RenderTarget | undefined;
30
+ capture(): {
31
+ scale: number;
32
+ sceneCapture: THREE.RenderTarget;
33
+ } | undefined;
34
+ blurTexture(options: LiquidGlassPanelOptions): THREE.Texture;
35
+ transitionOpacity(panel?: StagePanelRuntime): number;
36
+ pixelRatio(): number;
37
+ includeMesh(mesh: Mesh): boolean;
38
+ }
39
+ /** Owns independent Low views, docking projections and their blur resources. */
40
+ export declare class MinimapController {
41
+ private readonly ports;
42
+ private readonly measurementMode;
43
+ readonly scene: THREE.Scene<THREE.Object3DEventMap>;
44
+ constructor(ports: MinimapPorts);
45
+ get views(): ReadonlyMap<number, StageMinimapState>;
46
+ dispose(): void;
47
+ private get renderer();
48
+ private get camera();
49
+ private get panelCamera();
50
+ private get panelScene();
51
+ private get minimapScene();
52
+ private get model();
53
+ private get lowModel();
54
+ private get cameraSettings();
55
+ private get initialCameraWorldQuaternion();
56
+ private get initialModelWorldQuaternion();
57
+ private get modelHover();
58
+ private get modelInteractionActive();
59
+ private get scrollActive();
60
+ private isSpatialElementMesh;
61
+ private hideExcludedMeshes;
62
+ private getZoomReferenceTarget;
63
+ private getPanelTransitionOpacity;
64
+ private getFullPixelRatio;
65
+ private getPanelBlurTexture;
66
+ private readonly minimapModelWorldQuaternion;
67
+ private readonly minimapMainCameraWorldQuaternion;
68
+ private readonly minimapLiveQuaternion;
69
+ private readonly minimapBaseQuaternion;
70
+ private readonly minimapPanelCenter;
71
+ private readonly minimapDesiredNdc;
72
+ private readonly minimapDepthPoint;
73
+ private readonly minimapModelCenter;
74
+ private readonly minimapModelWorldScale;
75
+ private readonly minimapLayerWorldScale;
76
+ private readonly minimapModelBoundsPoint;
77
+ private readonly minimaps;
78
+ createMinimap(index: number, options?: StageMinimapOptions): void;
79
+ resolveMinimapOptions(options: StageMinimapOptions, panel: StagePanelRuntime): {
80
+ expandedHeight: number;
81
+ inset: number;
82
+ modelScale: number;
83
+ hoverModelScale: number;
84
+ expandedHoverModelScale: number;
85
+ overlayColor: THREE.ColorRepresentation;
86
+ overlayOpacity: number;
87
+ overlayBlur: number;
88
+ contextColor: THREE.ColorRepresentation;
89
+ contextOpacity: number;
90
+ viewportColor: THREE.ColorRepresentation;
91
+ };
92
+ disposeMinimap(index: number): void;
93
+ updateMinimapState(minimap: StageMinimapState, focus: number): void;
94
+ updateMinimapOverlayCaptureState(minimap: StageMinimapState): void;
95
+ private recordMinimapCaptureState;
96
+ updateMinimapDisplayModel(minimap: StageMinimapState, panelWidth: number, panelHeight: number, focus: number): void;
97
+ alignMinimapModelToDockTop(minimap: StageMinimapState): void;
98
+ getProjectedMinimapModelRect(minimap: StageMinimapState): {
99
+ x: number;
100
+ y: number;
101
+ width: number;
102
+ height: number;
103
+ } | null;
104
+ syncMinimapProjection(minimap: StageMinimapState, panelWidth: number, panelHeight: number): void;
105
+ updateMinimapViewport(minimap: StageMinimapState, panelWidth: number, panelHeight: number, contentWidth: number, contentHeight: number, rectX: number, rectY: number, rectWidth: number, rectHeight: number, focus: number): void;
106
+ updateMinimapRenderMask(minimap: StageMinimapState, panelWidth: number, panelHeight: number, viewportLeft: number, viewportTop: number, viewportWidth: number, viewportHeight: number, cornerRadii: MinimapCornerRadii, overlayProgress: number): void;
107
+ updateMinimapOverlayVisibility(minimap: StageMinimapState): void;
108
+ setMinimapDisplayModelOpacity(minimap: StageMinimapState, opacity: number): void;
109
+ renderMinimapBlur(minimap: StageMinimapState): void;
110
+ renderMinimapPanelCapture(minimap: StageMinimapState): void;
111
+ ensureMinimapBlurTargetSize(minimap: StageMinimapState): void;
112
+ }
113
+ //# sourceMappingURL=MinimapController.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"MinimapController.d.ts","sourceRoot":"","sources":["../../src/stage/MinimapController.ts"],"names":[],"mappings":"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"}