@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,187 @@
1
+ export const CATALOG_ENDPOINTS = Symbol('catalog-endpoints');
2
+ /** Semantic identity excludes representation and location; registrations additionally need a slot. */
3
+ export function catalogSharedKey(identity, role) {
4
+ return JSON.stringify([identity.brandId, identity.spatialElementId, role]);
5
+ }
6
+ export function catalogEndpointKey(address) {
7
+ return JSON.stringify([
8
+ address.brandId,
9
+ address.spatialElementId,
10
+ address.slot,
11
+ address.occurrence ?? null,
12
+ address.role
13
+ ]);
14
+ }
15
+ /** Index semantic slots first; resolution explicitly chooses a concrete occurrence. */
16
+ function catalogSlotKey(address) {
17
+ return JSON.stringify([address.brandId, address.spatialElementId, address.slot, address.role]);
18
+ }
19
+ /** Owned by one persistent stage, never a process-global/SSR singleton. */
20
+ export class CatalogEndpointRegistry {
21
+ presentations = new Map();
22
+ entries = new Map();
23
+ revision = 0;
24
+ preferred = new Map();
25
+ preferredSlots = new Map();
26
+ restoredOrigin;
27
+ restoreOrigin(origin) {
28
+ this.restoredOrigin = origin ? { ...origin } : undefined;
29
+ if (origin)
30
+ this.prefer(origin.brandId, origin.spatialElementId, origin.occurrence, origin.slot);
31
+ }
32
+ prefer(brandId, spatialElementId, occurrence, slot = 'catalog.card') {
33
+ this.preferred.set(JSON.stringify([brandId, spatialElementId]), occurrence);
34
+ this.preferredSlots.set(JSON.stringify([brandId, spatialElementId]), slot);
35
+ if (this.preferredSlots.size > 100)
36
+ this.preferredSlots.delete(this.preferredSlots.keys().next().value);
37
+ if (this.preferred.size > 100)
38
+ this.preferred.delete(this.preferred.keys().next().value);
39
+ }
40
+ restoreFocus(key) {
41
+ if (!key?.startsWith('catalog:'))
42
+ return;
43
+ try {
44
+ const tuple = JSON.parse(key.slice(8));
45
+ if (Array.isArray(tuple) &&
46
+ (tuple.length === 3 || tuple.length === 4) &&
47
+ tuple.every((value) => typeof value === 'string'))
48
+ this.prefer(tuple[0], tuple[1], tuple[2], tuple[3] === 'carousel.front' ? 'carousel.front' : 'catalog.card');
49
+ }
50
+ catch {
51
+ /* Ignore stale or malformed entry metadata. */
52
+ }
53
+ }
54
+ /** Activated/restored occurrence wins; otherwise require a unique visible composition. */
55
+ getContentSlot(identity) {
56
+ const key = JSON.stringify([identity.brandId, identity.spatialElementId]);
57
+ const preferred = this.preferred.get(key);
58
+ const preferredSlot = this.preferredSlots.get(key);
59
+ const slots = ['catalog.card', 'carousel.front', 'carousel.neighbour'];
60
+ if (preferredSlot &&
61
+ [
62
+ ...(this.entries.get(catalogSlotKey({ ...identity, slot: preferredSlot, role: 'container' })) ?? [])
63
+ ].some((entry) => entry.element.isConnected && entry.address.occurrence === preferred))
64
+ return preferredSlot;
65
+ if (preferredSlot?.startsWith('carousel.')) {
66
+ const other = preferredSlot === 'carousel.front' ? 'carousel.neighbour' : 'carousel.front';
67
+ if ([
68
+ ...(this.entries.get(catalogSlotKey({ ...identity, slot: other, role: 'container' })) ??
69
+ [])
70
+ ].some((entry) => entry.element.isConnected && entry.address.occurrence === preferred))
71
+ return other;
72
+ }
73
+ if (this.restoredOrigin?.brandId === identity.brandId &&
74
+ this.restoredOrigin.spatialElementId === identity.spatialElementId)
75
+ return undefined;
76
+ const visible = slots
77
+ .map((slot) => ({
78
+ slot,
79
+ entries: [
80
+ ...(this.entries.get(catalogSlotKey({ ...identity, slot, role: 'container' })) ?? [])
81
+ ].filter(({ element }) => {
82
+ if (!element.isConnected)
83
+ return false;
84
+ const rect = element.getBoundingClientRect();
85
+ return (rect.width > 0 &&
86
+ rect.height > 0 &&
87
+ rect.bottom > 0 &&
88
+ rect.top < innerHeight &&
89
+ rect.right > 0 &&
90
+ rect.left < innerWidth);
91
+ })
92
+ }))
93
+ .filter(({ entries }) => entries.length > 0);
94
+ if (visible.length !== 1)
95
+ return undefined;
96
+ const candidate = visible[0];
97
+ return candidate.slot !== 'catalog.card' && candidate.entries.length !== 1
98
+ ? undefined
99
+ : candidate.slot;
100
+ }
101
+ getPreferredContentSlot(identity) {
102
+ return this.preferredSlots.get(JSON.stringify([identity.brandId, identity.spatialElementId]));
103
+ }
104
+ /** Read-only occurrence inventory; unlike resolve(), this does not change activation. */
105
+ getContentEndpoints() {
106
+ return [...this.entries.values()]
107
+ .flatMap((entries) => [...entries])
108
+ .filter(({ address, element }) => address.role === 'container' && !address.slot.startsWith('detail.') && element.isConnected);
109
+ }
110
+ registerPresentation(identity, read) {
111
+ const key = JSON.stringify([identity.brandId, identity.spatialElementId]);
112
+ const readers = this.presentations.get(key) ?? new Set();
113
+ readers.add(read);
114
+ this.presentations.set(key, readers);
115
+ return () => {
116
+ readers.delete(read);
117
+ if (!readers.size && this.presentations.get(key) === readers)
118
+ this.presentations.delete(key);
119
+ };
120
+ }
121
+ getComposition(identity) {
122
+ const readers = this.presentations.get(JSON.stringify([identity.brandId, identity.spatialElementId]));
123
+ return readers?.size === 1 ? [...readers][0]() : 'unavailable';
124
+ }
125
+ register(address, element) {
126
+ const key = catalogSlotKey(address);
127
+ const registration = { address: { ...address }, element };
128
+ const entries = this.entries.get(key) ?? new Set();
129
+ entries.add(registration);
130
+ this.entries.set(key, entries);
131
+ this.revision++;
132
+ return () => {
133
+ // A late or repeated Svelte teardown only releases its own registration.
134
+ if (!entries.delete(registration))
135
+ return;
136
+ if (!entries.size && this.entries.get(key) === entries)
137
+ this.entries.delete(key);
138
+ this.revision++;
139
+ };
140
+ }
141
+ resolve(address) {
142
+ let candidates = [...(this.entries.get(catalogSlotKey(address)) ?? [])].filter((entry) => entry.element.isConnected);
143
+ if (address.slot === 'catalog.card' || address.slot.startsWith('carousel.')) {
144
+ const preferred = address.occurrence ??
145
+ this.preferred.get(JSON.stringify([address.brandId, address.spatialElementId]));
146
+ const matching = candidates.filter((entry) => entry.address.occurrence === preferred);
147
+ const containers = this.entries.get(catalogSlotKey({ ...address, role: 'container' }));
148
+ const registeredPreference = preferred &&
149
+ [...(containers ?? [])].some((entry) => entry.element.isConnected && entry.address.occurrence === preferred);
150
+ if (address.occurrence !== undefined ||
151
+ registeredPreference ||
152
+ (preferred && matching.length))
153
+ candidates = matching;
154
+ else if (candidates.length > 1 && candidates.every((entry) => entry.address.occurrence)) {
155
+ const visible = candidates.filter((entry) => {
156
+ const rect = entry.element.getBoundingClientRect();
157
+ return (rect.bottom > 0 && rect.top < innerHeight && rect.right > 0 && rect.left < innerWidth);
158
+ });
159
+ const sorted = visible.sort((a, b) => a.address.occurrence.localeCompare(b.address.occurrence));
160
+ const occurrence = sorted[0]?.address.occurrence;
161
+ candidates = occurrence
162
+ ? candidates.filter((entry) => entry.address.occurrence === occurrence)
163
+ : [];
164
+ }
165
+ if (candidates.length === 1) {
166
+ const occurrence = candidates[0].address.occurrence;
167
+ if (occurrence)
168
+ this.prefer(address.brandId, address.spatialElementId, occurrence, address.slot);
169
+ const cards = ['catalog.card', 'carousel.front', 'carousel.neighbour'].flatMap((slot) => [
170
+ ...(this.entries.get(catalogSlotKey({ ...address, slot: slot, role: 'container' })) ?? [])
171
+ ]);
172
+ for (const entry of cards)
173
+ entry.element.toggleAttribute('data-catalog-selected', entry.address.occurrence === occurrence);
174
+ }
175
+ }
176
+ // Ambiguity is a fallback, never a "first DOM match wins" choice.
177
+ return candidates.length === 1 ? candidates[0].element : undefined;
178
+ }
179
+ /** Registration revision is not a rendered-pose/layout revision. No layout reads here. */
180
+ getSnapshot() {
181
+ return {
182
+ registrationRevision: this.revision,
183
+ entries: [...this.entries.values()].flatMap((entries) => [...entries].map(({ address, element }) => ({ ...address, connected: element.isConnected })))
184
+ };
185
+ }
186
+ }
187
+ //# sourceMappingURL=CatalogEndpointRegistry.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"CatalogEndpointRegistry.js","sourceRoot":"","sources":["../../src/catalog/CatalogEndpointRegistry.ts"],"names":[],"mappings":"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","sourcesContent":["export interface CatalogIdentity {\n\tbrandId: string;\n\tspatialElementId: string;\n}\n\nexport type CatalogSharedRole =\n\t'summary-surface' | 'eyebrow' | 'title' | 'features' | 'primary-action';\nexport type CatalogEndpointRole = CatalogSharedRole | 'geometry' | 'container';\nexport type CatalogEndpointSlot =\n\t| 'catalog.card'\n\t| 'carousel.front'\n\t| 'carousel.neighbour'\n\t| 'detail.hero'\n\t| 'detail.summary'\n\t| 'detail.dock';\nexport type CatalogContentSlot = 'catalog.card' | 'carousel.front' | 'carousel.neighbour';\n\nexport interface CatalogEndpointAddress extends CatalogIdentity {\n\tslot: CatalogEndpointSlot;\n\toccurrence?: string;\n\trole: CatalogEndpointRole;\n}\n\nexport const CATALOG_ENDPOINTS = Symbol('catalog-endpoints');\n\n/** Semantic identity excludes representation and location; registrations additionally need a slot. */\nexport function catalogSharedKey(identity: CatalogIdentity, role: CatalogSharedRole) {\n\treturn JSON.stringify([identity.brandId, identity.spatialElementId, role]);\n}\n\nexport function catalogEndpointKey(address: CatalogEndpointAddress) {\n\treturn JSON.stringify([\n\t\taddress.brandId,\n\t\taddress.spatialElementId,\n\t\taddress.slot,\n\t\taddress.occurrence ?? null,\n\t\taddress.role\n\t]);\n}\n\n/** Index semantic slots first; resolution explicitly chooses a concrete occurrence. */\nfunction catalogSlotKey(address: CatalogEndpointAddress) {\n\treturn JSON.stringify([address.brandId, address.spatialElementId, address.slot, address.role]);\n}\n\ninterface Registration {\n\taddress: CatalogEndpointAddress;\n\telement: HTMLElement;\n}\n\n/** Owned by one persistent stage, never a process-global/SSR singleton. */\nexport class CatalogEndpointRegistry {\n\tprivate presentations = new Map<\n\t\tstring,\n\t\tSet<() => 'hero' | 'dock' | 'intermediate' | 'unavailable'>\n\t>();\n\tprivate entries = new Map<string, Set<Registration>>();\n\tprivate revision = 0;\n\tprivate preferred = new Map<string, string>();\n\tprivate preferredSlots = new Map<string, CatalogContentSlot>();\n\tprivate restoredOrigin?: CatalogIdentity & { occurrence: string; slot: CatalogContentSlot };\n\trestoreOrigin(origin?: CatalogIdentity & { occurrence: string; slot: CatalogContentSlot }) {\n\t\tthis.restoredOrigin = origin ? { ...origin } : undefined;\n\t\tif (origin) this.prefer(origin.brandId, origin.spatialElementId, origin.occurrence, origin.slot);\n\t}\n\tprefer(\n\t\tbrandId: string,\n\t\tspatialElementId: string,\n\t\toccurrence: string,\n\t\tslot: CatalogContentSlot = 'catalog.card'\n\t) {\n\t\tthis.preferred.set(JSON.stringify([brandId, spatialElementId]), occurrence);\n\t\tthis.preferredSlots.set(JSON.stringify([brandId, spatialElementId]), slot);\n\t\tif (this.preferredSlots.size > 100)\n\t\t\tthis.preferredSlots.delete(this.preferredSlots.keys().next().value!);\n\t\tif (this.preferred.size > 100) this.preferred.delete(this.preferred.keys().next().value!);\n\t}\n\trestoreFocus(key?: string) {\n\t\tif (!key?.startsWith('catalog:')) return;\n\t\ttry {\n\t\t\tconst tuple: unknown = JSON.parse(key.slice(8));\n\t\t\tif (\n\t\t\t\tArray.isArray(tuple) &&\n\t\t\t\t(tuple.length === 3 || tuple.length === 4) &&\n\t\t\t\ttuple.every((value) => typeof value === 'string')\n\t\t\t)\n\t\t\t\tthis.prefer(\n\t\t\t\t\ttuple[0],\n\t\t\t\t\ttuple[1],\n\t\t\t\t\ttuple[2],\n\t\t\t\t\ttuple[3] === 'carousel.front' ? 'carousel.front' : 'catalog.card'\n\t\t\t\t);\n\t\t} catch {\n\t\t\t/* Ignore stale or malformed entry metadata. */\n\t\t}\n\t}\n\n\t/** Activated/restored occurrence wins; otherwise require a unique visible composition. */\n\tgetContentSlot(identity: CatalogIdentity): CatalogContentSlot | undefined {\n\t\tconst key = JSON.stringify([identity.brandId, identity.spatialElementId]);\n\t\tconst preferred = this.preferred.get(key);\n\t\tconst preferredSlot = this.preferredSlots.get(key);\n\t\tconst slots: CatalogContentSlot[] = ['catalog.card', 'carousel.front', 'carousel.neighbour'];\n\t\tif (\n\t\t\tpreferredSlot &&\n\t\t\t[\n\t\t\t\t...(this.entries.get(\n\t\t\t\t\tcatalogSlotKey({ ...identity, slot: preferredSlot, role: 'container' })\n\t\t\t\t) ?? [])\n\t\t\t].some((entry) => entry.element.isConnected && entry.address.occurrence === preferred)\n\t\t)\n\t\t\treturn preferredSlot;\n\t\tif (preferredSlot?.startsWith('carousel.')) {\n\t\t\tconst other = preferredSlot === 'carousel.front' ? 'carousel.neighbour' : 'carousel.front';\n\t\t\tif (\n\t\t\t\t[\n\t\t\t\t\t...(this.entries.get(catalogSlotKey({ ...identity, slot: other, role: 'container' })) ??\n\t\t\t\t\t\t[])\n\t\t\t\t].some((entry) => entry.element.isConnected && entry.address.occurrence === preferred)\n\t\t\t)\n\t\t\t\treturn other;\n\t\t}\n\t\tif (\n\t\t\tthis.restoredOrigin?.brandId === identity.brandId &&\n\t\t\tthis.restoredOrigin.spatialElementId === identity.spatialElementId\n\t\t)\n\t\t\treturn undefined;\n\t\tconst visible = slots\n\t\t\t.map((slot) => ({\n\t\t\t\tslot,\n\t\t\t\tentries: [\n\t\t\t\t\t...(this.entries.get(catalogSlotKey({ ...identity, slot, role: 'container' })) ?? [])\n\t\t\t\t].filter(({ element }) => {\n\t\t\t\t\tif (!element.isConnected) return false;\n\t\t\t\t\tconst rect = element.getBoundingClientRect();\n\t\t\t\t\treturn (\n\t\t\t\t\t\trect.width > 0 &&\n\t\t\t\t\t\trect.height > 0 &&\n\t\t\t\t\t\trect.bottom > 0 &&\n\t\t\t\t\t\trect.top < innerHeight &&\n\t\t\t\t\t\trect.right > 0 &&\n\t\t\t\t\t\trect.left < innerWidth\n\t\t\t\t\t);\n\t\t\t\t})\n\t\t\t}))\n\t\t\t.filter(({ entries }) => entries.length > 0);\n\t\tif (visible.length !== 1) return undefined;\n\t\tconst candidate = visible[0];\n\t\treturn candidate.slot !== 'catalog.card' && candidate.entries.length !== 1\n\t\t\t? undefined\n\t\t\t: candidate.slot;\n\t}\n\n\tgetPreferredContentSlot(identity: CatalogIdentity) {\n\t\treturn this.preferredSlots.get(JSON.stringify([identity.brandId, identity.spatialElementId]));\n\t}\n\n\t/** Read-only occurrence inventory; unlike resolve(), this does not change activation. */\n\tgetContentEndpoints() {\n\t\treturn [...this.entries.values()]\n\t\t\t.flatMap((entries) => [...entries])\n\t\t\t.filter(\n\t\t\t\t({ address, element }) =>\n\t\t\t\t\taddress.role === 'container' && !address.slot.startsWith('detail.') && element.isConnected\n\t\t\t);\n\t}\n\n\tregisterPresentation(\n\t\tidentity: CatalogIdentity,\n\t\tread: () => 'hero' | 'dock' | 'intermediate' | 'unavailable'\n\t) {\n\t\tconst key = JSON.stringify([identity.brandId, identity.spatialElementId]);\n\t\tconst readers = this.presentations.get(key) ?? new Set();\n\t\treaders.add(read);\n\t\tthis.presentations.set(key, readers);\n\t\treturn () => {\n\t\t\treaders.delete(read);\n\t\t\tif (!readers.size && this.presentations.get(key) === readers) this.presentations.delete(key);\n\t\t};\n\t}\n\n\tgetComposition(identity: CatalogIdentity) {\n\t\tconst readers = this.presentations.get(JSON.stringify([identity.brandId, identity.spatialElementId]));\n\t\treturn readers?.size === 1 ? [...readers][0]() : 'unavailable';\n\t}\n\n\tregister(address: CatalogEndpointAddress, element: HTMLElement): () => void {\n\t\tconst key = catalogSlotKey(address);\n\t\tconst registration = { address: { ...address }, element };\n\t\tconst entries = this.entries.get(key) ?? new Set<Registration>();\n\t\tentries.add(registration);\n\t\tthis.entries.set(key, entries);\n\t\tthis.revision++;\n\t\treturn () => {\n\t\t\t// A late or repeated Svelte teardown only releases its own registration.\n\t\t\tif (!entries.delete(registration)) return;\n\t\t\tif (!entries.size && this.entries.get(key) === entries) this.entries.delete(key);\n\t\t\tthis.revision++;\n\t\t};\n\t}\n\n\tresolve(address: CatalogEndpointAddress): HTMLElement | undefined {\n\t\tlet candidates = [...(this.entries.get(catalogSlotKey(address)) ?? [])].filter(\n\t\t\t(entry) => entry.element.isConnected\n\t\t);\n\t\tif (address.slot === 'catalog.card' || address.slot.startsWith('carousel.')) {\n\t\t\tconst preferred =\n\t\t\t\taddress.occurrence ??\n\t\t\t\tthis.preferred.get(JSON.stringify([address.brandId, address.spatialElementId]));\n\t\t\tconst matching = candidates.filter((entry) => entry.address.occurrence === preferred);\n\t\t\tconst containers = this.entries.get(catalogSlotKey({ ...address, role: 'container' }));\n\t\t\tconst registeredPreference =\n\t\t\t\tpreferred &&\n\t\t\t\t[...(containers ?? [])].some(\n\t\t\t\t\t(entry) => entry.element.isConnected && entry.address.occurrence === preferred\n\t\t\t\t);\n\t\t\tif (\n\t\t\t\taddress.occurrence !== undefined ||\n\t\t\t\tregisteredPreference ||\n\t\t\t\t(preferred && matching.length)\n\t\t\t)\n\t\t\t\tcandidates = matching;\n\t\t\telse if (candidates.length > 1 && candidates.every((entry) => entry.address.occurrence)) {\n\t\t\t\tconst visible = candidates.filter((entry) => {\n\t\t\t\t\tconst rect = entry.element.getBoundingClientRect();\n\t\t\t\t\treturn (\n\t\t\t\t\t\trect.bottom > 0 && rect.top < innerHeight && rect.right > 0 && rect.left < innerWidth\n\t\t\t\t\t);\n\t\t\t\t});\n\t\t\t\tconst sorted = visible.sort((a, b) =>\n\t\t\t\t\ta.address.occurrence!.localeCompare(b.address.occurrence!)\n\t\t\t\t);\n\t\t\t\tconst occurrence = sorted[0]?.address.occurrence;\n\t\t\t\tcandidates = occurrence\n\t\t\t\t\t? candidates.filter((entry) => entry.address.occurrence === occurrence)\n\t\t\t\t\t: [];\n\t\t\t}\n\t\t\tif (candidates.length === 1) {\n\t\t\t\tconst occurrence = candidates[0].address.occurrence;\n\t\t\t\tif (occurrence)\n\t\t\t\t\tthis.prefer(\n\t\t\t\t\t\taddress.brandId,\n\t\t\t\t\t\taddress.spatialElementId,\n\t\t\t\t\t\toccurrence,\n\t\t\t\t\t\taddress.slot as CatalogContentSlot\n\t\t\t\t\t);\n\t\t\t\tconst cards = ['catalog.card', 'carousel.front', 'carousel.neighbour'].flatMap((slot) => [\n\t\t\t\t\t...(this.entries.get(\n\t\t\t\t\t\tcatalogSlotKey({ ...address, slot: slot as CatalogContentSlot, role: 'container' })\n\t\t\t\t\t) ?? [])\n\t\t\t\t]);\n\t\t\t\tfor (const entry of cards)\n\t\t\t\t\tentry.element.toggleAttribute(\n\t\t\t\t\t\t'data-catalog-selected',\n\t\t\t\t\t\tentry.address.occurrence === occurrence\n\t\t\t\t\t);\n\t\t\t}\n\t\t}\n\t\t// Ambiguity is a fallback, never a \"first DOM match wins\" choice.\n\t\treturn candidates.length === 1 ? candidates[0].element : undefined;\n\t}\n\n\t/** Registration revision is not a rendered-pose/layout revision. No layout reads here. */\n\tgetSnapshot() {\n\t\treturn {\n\t\t\tregistrationRevision: this.revision,\n\t\t\tentries: [...this.entries.values()].flatMap((entries) =>\n\t\t\t\t[...entries].map(({ address, element }) => ({ ...address, connected: element.isConnected }))\n\t\t\t)\n\t\t};\n\t}\n}\n"]}
@@ -0,0 +1,12 @@
1
+ import * as THREE from 'three/webgpu';
2
+ /** Fade the resolved image, never the individual opaque surfaces of a element. */
3
+ export declare class CatalogGeometryFade {
4
+ getRenderTargets(): THREE.RenderTarget<THREE.Texture<unknown, THREE.TextureEventMap>, THREE.RenderTargetEventMap>[];
5
+ private capture?;
6
+ private material?;
7
+ private quad?;
8
+ private readonly alpha;
9
+ render(renderer: THREE.WebGPURenderer, opacity: number, draw: () => void): void;
10
+ dispose(): void;
11
+ }
12
+ //# sourceMappingURL=CatalogGeometryFade.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"CatalogGeometryFade.d.ts","sourceRoot":"","sources":["../../src/catalog/CatalogGeometryFade.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAGtC,kFAAkF;AAClF,qBAAa,mBAAmB;IAC/B,gBAAgB;IAGhB,OAAO,CAAC,OAAO,CAAC,CAAqB;IACrC,OAAO,CAAC,QAAQ,CAAC,CAAqB;IACtC,OAAO,CAAC,IAAI,CAAC,CAAiB;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IAEpC,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI;IA6CxE,OAAO;CAOP"}
@@ -0,0 +1,67 @@
1
+ import * as THREE from 'three/webgpu';
2
+ import { texture, uniform } from 'three/tsl';
3
+ /** Fade the resolved image, never the individual opaque surfaces of a element. */
4
+ export class CatalogGeometryFade {
5
+ getRenderTargets() {
6
+ return this.capture ? [this.capture] : [];
7
+ }
8
+ capture;
9
+ material;
10
+ quad;
11
+ alpha = uniform(1);
12
+ render(renderer, opacity, draw) {
13
+ if (opacity >= 1) {
14
+ draw();
15
+ return;
16
+ }
17
+ if (opacity <= 0)
18
+ return;
19
+ const destination = renderer.getRenderTarget();
20
+ const size = destination ?? renderer.getDrawingBufferSize(new THREE.Vector2());
21
+ if (!this.capture) {
22
+ this.capture = new THREE.RenderTarget(size.width, size.height, {
23
+ type: THREE.HalfFloatType,
24
+ samples: 4
25
+ });
26
+ this.material = new THREE.NodeMaterial();
27
+ this.material.fragmentNode = texture(this.capture.texture).mul(this.alpha);
28
+ this.material.transparent = true;
29
+ this.material.premultipliedAlpha = true;
30
+ this.material.depthTest = false;
31
+ this.material.depthWrite = false;
32
+ this.material.toneMapped = false;
33
+ this.quad = new THREE.QuadMesh(this.material);
34
+ }
35
+ this.capture.setSize(size.width, size.height);
36
+ const color = renderer.getClearColor(new THREE.Color());
37
+ const clearAlpha = renderer.getClearAlpha();
38
+ const scissor = renderer.getScissor(new THREE.Vector4());
39
+ const scissorTest = renderer.getScissorTest();
40
+ try {
41
+ renderer.setRenderTarget(this.capture);
42
+ renderer.setScissorTest(false);
43
+ renderer.setClearColor(0x000000, 0);
44
+ renderer.clear();
45
+ draw();
46
+ renderer.setRenderTarget(destination);
47
+ renderer.setScissor(scissor);
48
+ renderer.setScissorTest(scissorTest);
49
+ this.alpha.value = opacity;
50
+ this.quad.render(renderer);
51
+ }
52
+ finally {
53
+ renderer.setRenderTarget(destination);
54
+ renderer.setClearColor(color, clearAlpha);
55
+ renderer.setScissor(scissor);
56
+ renderer.setScissorTest(scissorTest);
57
+ }
58
+ }
59
+ dispose() {
60
+ this.capture?.dispose();
61
+ this.material?.dispose();
62
+ this.capture = undefined;
63
+ this.material = undefined;
64
+ this.quad = undefined;
65
+ }
66
+ }
67
+ //# sourceMappingURL=CatalogGeometryFade.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"CatalogGeometryFade.js","sourceRoot":"","sources":["../../src/catalog/CatalogGeometryFade.ts"],"names":[],"mappings":"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","sourcesContent":["import * as THREE from 'three/webgpu';\nimport { texture, uniform } from 'three/tsl';\n\n/** Fade the resolved image, never the individual opaque surfaces of a element. */\nexport class CatalogGeometryFade {\n\tgetRenderTargets() {\n\t\treturn this.capture ? [this.capture] : [];\n\t}\n\tprivate capture?: THREE.RenderTarget;\n\tprivate material?: THREE.NodeMaterial;\n\tprivate quad?: THREE.QuadMesh;\n\tprivate readonly alpha = uniform(1);\n\n\trender(renderer: THREE.WebGPURenderer, opacity: number, draw: () => void) {\n\t\tif (opacity >= 1) {\n\t\t\tdraw();\n\t\t\treturn;\n\t\t}\n\t\tif (opacity <= 0) return;\n\t\tconst destination = renderer.getRenderTarget();\n\t\tconst size = destination ?? renderer.getDrawingBufferSize(new THREE.Vector2());\n\t\tif (!this.capture) {\n\t\t\tthis.capture = new THREE.RenderTarget(size.width, size.height, {\n\t\t\t\ttype: THREE.HalfFloatType,\n\t\t\t\tsamples: 4\n\t\t\t});\n\t\t\tthis.material = new THREE.NodeMaterial();\n\t\t\tthis.material.fragmentNode = texture(this.capture.texture).mul(this.alpha);\n\t\t\tthis.material.transparent = true;\n\t\t\tthis.material.premultipliedAlpha = true;\n\t\t\tthis.material.depthTest = false;\n\t\t\tthis.material.depthWrite = false;\n\t\t\tthis.material.toneMapped = false;\n\t\t\tthis.quad = new THREE.QuadMesh(this.material);\n\t\t}\n\t\tthis.capture.setSize(size.width, size.height);\n\t\tconst color = renderer.getClearColor(new THREE.Color());\n\t\tconst clearAlpha = renderer.getClearAlpha();\n\t\tconst scissor = renderer.getScissor(new THREE.Vector4());\n\t\tconst scissorTest = renderer.getScissorTest();\n\t\ttry {\n\t\t\trenderer.setRenderTarget(this.capture);\n\t\t\trenderer.setScissorTest(false);\n\t\t\trenderer.setClearColor(0x000000, 0);\n\t\t\trenderer.clear();\n\t\t\tdraw();\n\t\t\trenderer.setRenderTarget(destination);\n\t\t\trenderer.setScissor(scissor);\n\t\t\trenderer.setScissorTest(scissorTest);\n\t\t\tthis.alpha.value = opacity;\n\t\t\tthis.quad!.render(renderer);\n\t\t} finally {\n\t\t\trenderer.setRenderTarget(destination);\n\t\t\trenderer.setClearColor(color, clearAlpha);\n\t\t\trenderer.setScissor(scissor);\n\t\t\trenderer.setScissorTest(scissorTest);\n\t\t}\n\t}\n\tdispose() {\n\t\tthis.capture?.dispose();\n\t\tthis.material?.dispose();\n\t\tthis.capture = undefined;\n\t\tthis.material = undefined;\n\t\tthis.quad = undefined;\n\t}\n}\n"]}
@@ -0,0 +1,40 @@
1
+ import * as THREE from 'three/webgpu';
2
+ import type { SpatialStageConfig } from '../spatial-element/types.js';
3
+ import { SpatialElementRefinement } from '../stage/SpatialElementRefinement.js';
4
+ import type { SpatialElementAssetInstance, SpatialElementAssetManager } from './assets/SpatialElementAssetManager.js';
5
+ import type { EnvironmentCache, PreparedEnvironment } from './EnvironmentCache.js';
6
+ import type { PreparationGate } from './PreparationGate.js';
7
+ export interface PreparedHigh {
8
+ instance: SpatialElementAssetInstance;
9
+ pose: THREE.Object3D;
10
+ overrides: Set<THREE.Material>;
11
+ blend: SpatialElementRefinement;
12
+ }
13
+ export interface SpatialElementPreparation {
14
+ key: string;
15
+ controller: AbortController;
16
+ environment: ReturnType<EnvironmentCache['acquire']>;
17
+ backgroundState: 'loading' | 'ready' | 'failed';
18
+ highState: 'loading' | 'ready' | 'failed' | 'unavailable' | 'adopted';
19
+ high?: PreparedHigh;
20
+ timings?: {
21
+ buildMs: number;
22
+ gpuWarmMs: number;
23
+ };
24
+ }
25
+ export declare const preparationKey: (stage: Pick<SpatialStageConfig, "hdr" | "glb" | "lodPair" | "model" | "background">) => string;
26
+ /** At most one speculative presentation is retained; active instances are adopted by the stage. */
27
+ export declare class CatalogPreparation {
28
+ private assets;
29
+ private environments;
30
+ private gate;
31
+ private warm;
32
+ private changed;
33
+ current?: SpatialElementPreparation;
34
+ constructor(assets: SpatialElementAssetManager, environments: EnvironmentCache, gate: PreparationGate, warm: (high: PreparedHigh, environment: PreparedEnvironment, signal: AbortSignal) => Promise<void>, changed: () => void);
35
+ prepare(stage: SpatialStageConfig): SpatialElementPreparation;
36
+ takeHigh(entry: SpatialElementPreparation): PreparedHigh | undefined;
37
+ dispose(): void;
38
+ }
39
+ export declare function disposePreparedHigh(high: PreparedHigh): void;
40
+ //# sourceMappingURL=CatalogPreparation.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"CatalogPreparation.d.ts","sourceRoot":"","sources":["../../src/catalog/CatalogPreparation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAQtE,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAChF,OAAO,KAAK,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,MAAM,wCAAwC,CAAC;AACtH,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACnF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG5D,MAAM,WAAW,YAAY;IAC5B,QAAQ,EAAE,2BAA2B,CAAC;IACtC,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC;IACrB,SAAS,EAAE,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC/B,KAAK,EAAE,wBAAwB,CAAC;CAChC;AACD,MAAM,WAAW,yBAAyB;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,eAAe,CAAC;IAC5B,WAAW,EAAE,UAAU,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC;IACrD,eAAe,EAAE,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;IAChD,SAAS,EAAE,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,aAAa,GAAG,SAAS,CAAC;IACtE,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,OAAO,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CACjD;AACD,eAAO,MAAM,cAAc,GAC1B,OAAO,IAAI,CAAC,kBAAkB,EAAE,KAAK,GAAG,KAAK,GAAG,SAAS,GAAG,OAAO,GAAG,YAAY,CAAC,WACW,CAAC;AAEhG,mGAAmG;AACnG,qBAAa,kBAAkB;IAG7B,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,IAAI;IAKZ,OAAO,CAAC,OAAO;IAVhB,OAAO,CAAC,EAAE,yBAAyB,CAAC;gBAE3B,MAAM,EAAE,0BAA0B,EAClC,YAAY,EAAE,gBAAgB,EAC9B,IAAI,EAAE,eAAe,EACrB,IAAI,EAAE,CACb,IAAI,EAAE,YAAY,EAClB,WAAW,EAAE,mBAAmB,EAChC,MAAM,EAAE,WAAW,KACf,OAAO,CAAC,IAAI,CAAC,EACV,OAAO,EAAE,MAAM,IAAI;IAE5B,OAAO,CAAC,KAAK,EAAE,kBAAkB;IA0FjC,QAAQ,CAAC,KAAK,EAAE,yBAAyB;IAQzC,OAAO;CAQP;AACD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,YAAY,QAKrD"}
@@ -0,0 +1,141 @@
1
+ import * as THREE from 'three/webgpu';
2
+ import { prepareSpatialElementFrame } from '../stage/spatialElementFrame.js';
3
+ import { applyModelMaterialOverrides, getMeshBounds, getMeshMaterials, isMesh } from '../stage/stageSceneUtils.js';
4
+ import { SpatialElementRefinement } from '../stage/SpatialElementRefinement.js';
5
+ import { resolveSpatialElementLodPair } from './spatialElementLodPair.js';
6
+ export const preparationKey = (stage) => JSON.stringify([stage.hdr, stage.glb, stage.lodPair, stage.model ?? {}, stage.background]);
7
+ /** At most one speculative presentation is retained; active instances are adopted by the stage. */
8
+ export class CatalogPreparation {
9
+ assets;
10
+ environments;
11
+ gate;
12
+ warm;
13
+ changed;
14
+ current;
15
+ constructor(assets, environments, gate, warm, changed) {
16
+ this.assets = assets;
17
+ this.environments = environments;
18
+ this.gate = gate;
19
+ this.warm = warm;
20
+ this.changed = changed;
21
+ }
22
+ prepare(stage) {
23
+ const key = preparationKey(stage);
24
+ if (this.current?.key === key && this.current.highState !== 'adopted')
25
+ return this.current;
26
+ this.dispose();
27
+ const pair = resolveSpatialElementLodPair(stage.glb, stage.lodPair);
28
+ const entry = {
29
+ key,
30
+ controller: new AbortController(),
31
+ environment: this.environments.acquire(stage.hdr),
32
+ backgroundState: 'loading',
33
+ highState: pair ? 'loading' : 'unavailable'
34
+ };
35
+ this.current = entry;
36
+ void entry.environment.ready
37
+ .then(async () => {
38
+ await this.gate.wait(entry.controller.signal);
39
+ entry.backgroundState = 'ready';
40
+ this.changed();
41
+ }, () => {
42
+ entry.backgroundState = 'failed';
43
+ this.changed();
44
+ })
45
+ .catch(() => { });
46
+ if (entry.environment.value)
47
+ entry.backgroundState = 'ready';
48
+ if (pair) {
49
+ const signal = entry.controller.signal;
50
+ const lease = this.assets.acquire(pair.high, { signal });
51
+ void (async () => {
52
+ let high;
53
+ let instance;
54
+ try {
55
+ const [, environment] = await Promise.all([lease.ready, entry.environment.ready]);
56
+ await this.gate.wait(signal);
57
+ instance = await lease.createInstance();
58
+ let buildStarted = 0;
59
+ await this.gate.run(() => {
60
+ buildStarted = performance.now();
61
+ signal.throwIfAborted();
62
+ const settings = stage.model ?? {};
63
+ applyModelMaterialOverrides(instance.scene, settings.materialOverrides);
64
+ const overrides = new Set();
65
+ const excluded = new Set(settings.excludeMeshes ?? []);
66
+ instance.scene.traverse((object) => {
67
+ if (!isMesh(object))
68
+ return;
69
+ if (excluded.has(object.name))
70
+ object.visible = false;
71
+ if (settings.materialOverrides?.[object.name])
72
+ getMeshMaterials(object).forEach((material) => overrides.add(material));
73
+ });
74
+ const container = new THREE.Group();
75
+ prepareSpatialElementFrame(container, instance.scene, pair, settings);
76
+ high = {
77
+ instance: instance,
78
+ overrides,
79
+ pose: container.children[0],
80
+ blend: new SpatialElementRefinement(true)
81
+ };
82
+ instance = undefined;
83
+ if (getMeshBounds(container, (mesh) => !excluded.has(mesh.name)).isEmpty())
84
+ throw new Error('High contains no spatialElement meshes');
85
+ }, signal);
86
+ const warmStarted = performance.now();
87
+ await this.warm(high, environment, signal);
88
+ entry.timings = {
89
+ buildMs: warmStarted - buildStarted,
90
+ gpuWarmMs: performance.now() - warmStarted
91
+ };
92
+ await this.gate.wait(signal);
93
+ signal.throwIfAborted();
94
+ entry.high = high;
95
+ high = undefined;
96
+ entry.highState = 'ready';
97
+ this.changed();
98
+ }
99
+ catch (error) {
100
+ if (!signal.aborted) {
101
+ entry.highState = 'failed';
102
+ console.warn('Optional spatialElement preparation failed; retaining Low', error);
103
+ this.changed();
104
+ }
105
+ }
106
+ finally {
107
+ instance?.dispose();
108
+ if (high)
109
+ disposePreparedHigh(high);
110
+ lease.release();
111
+ }
112
+ })();
113
+ }
114
+ return entry;
115
+ }
116
+ takeHigh(entry) {
117
+ const high = entry.high;
118
+ if (high) {
119
+ entry.high = undefined;
120
+ entry.highState = 'adopted';
121
+ }
122
+ return high;
123
+ }
124
+ dispose() {
125
+ const entry = this.current;
126
+ this.current = undefined;
127
+ if (!entry)
128
+ return;
129
+ entry.controller.abort();
130
+ entry.environment.release();
131
+ if (entry.high)
132
+ disposePreparedHigh(entry.high);
133
+ }
134
+ }
135
+ export function disposePreparedHigh(high) {
136
+ high.pose.removeFromParent();
137
+ high.blend.dispose();
138
+ high.overrides.forEach((material) => material.dispose());
139
+ high.instance.dispose();
140
+ }
141
+ //# sourceMappingURL=CatalogPreparation.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"CatalogPreparation.js","sourceRoot":"","sources":["../../src/catalog/CatalogPreparation.ts"],"names":[],"mappings":"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","sourcesContent":["import * as THREE from 'three/webgpu';\nimport type { SpatialStageConfig } from '../spatial-element/types.js';\nimport { prepareSpatialElementFrame } from '../stage/spatialElementFrame.js';\nimport {\n\tapplyModelMaterialOverrides,\n\tgetMeshBounds,\n\tgetMeshMaterials,\n\tisMesh\n} from '../stage/stageSceneUtils.js';\nimport { SpatialElementRefinement } from '../stage/SpatialElementRefinement.js';\nimport type { SpatialElementAssetInstance, SpatialElementAssetManager } from './assets/SpatialElementAssetManager.js';\nimport type { EnvironmentCache, PreparedEnvironment } from './EnvironmentCache.js';\nimport type { PreparationGate } from './PreparationGate.js';\nimport { resolveSpatialElementLodPair } from './spatialElementLodPair.js';\n\nexport interface PreparedHigh {\n\tinstance: SpatialElementAssetInstance;\n\tpose: THREE.Object3D;\n\toverrides: Set<THREE.Material>;\n\tblend: SpatialElementRefinement;\n}\nexport interface SpatialElementPreparation {\n\tkey: string;\n\tcontroller: AbortController;\n\tenvironment: ReturnType<EnvironmentCache['acquire']>;\n\tbackgroundState: 'loading' | 'ready' | 'failed';\n\thighState: 'loading' | 'ready' | 'failed' | 'unavailable' | 'adopted';\n\thigh?: PreparedHigh;\n\ttimings?: { buildMs: number; gpuWarmMs: number };\n}\nexport const preparationKey = (\n\tstage: Pick<SpatialStageConfig, 'hdr' | 'glb' | 'lodPair' | 'model' | 'background'>\n) => JSON.stringify([stage.hdr, stage.glb, stage.lodPair, stage.model ?? {}, stage.background]);\n\n/** At most one speculative presentation is retained; active instances are adopted by the stage. */\nexport class CatalogPreparation {\n\tcurrent?: SpatialElementPreparation;\n\tconstructor(\n\t\tprivate assets: SpatialElementAssetManager,\n\t\tprivate environments: EnvironmentCache,\n\t\tprivate gate: PreparationGate,\n\t\tprivate warm: (\n\t\t\thigh: PreparedHigh,\n\t\t\tenvironment: PreparedEnvironment,\n\t\t\tsignal: AbortSignal\n\t\t) => Promise<void>,\n\t\tprivate changed: () => void\n\t) {}\n\tprepare(stage: SpatialStageConfig) {\n\t\tconst key = preparationKey(stage);\n\t\tif (this.current?.key === key && this.current.highState !== 'adopted') return this.current;\n\t\tthis.dispose();\n\t\tconst pair = resolveSpatialElementLodPair(stage.glb, stage.lodPair);\n\t\tconst entry: SpatialElementPreparation = {\n\t\t\tkey,\n\t\t\tcontroller: new AbortController(),\n\t\t\tenvironment: this.environments.acquire(stage.hdr),\n\t\t\tbackgroundState: 'loading',\n\t\t\thighState: pair ? 'loading' : 'unavailable'\n\t\t};\n\t\tthis.current = entry;\n\t\tvoid entry.environment.ready\n\t\t\t.then(\n\t\t\t\tasync () => {\n\t\t\t\t\tawait this.gate.wait(entry.controller.signal);\n\t\t\t\t\tentry.backgroundState = 'ready';\n\t\t\t\t\tthis.changed();\n\t\t\t\t},\n\t\t\t\t() => {\n\t\t\t\t\tentry.backgroundState = 'failed';\n\t\t\t\t\tthis.changed();\n\t\t\t\t}\n\t\t\t)\n\t\t\t.catch(() => {});\n\t\tif (entry.environment.value) entry.backgroundState = 'ready';\n\t\tif (pair) {\n\t\t\tconst signal = entry.controller.signal;\n\t\t\tconst lease = this.assets.acquire(pair.high, { signal });\n\t\t\tvoid (async () => {\n\t\t\t\tlet high: PreparedHigh | undefined;\n\t\t\t\tlet instance: SpatialElementAssetInstance | undefined;\n\t\t\t\ttry {\n\t\t\t\t\tconst [, environment] = await Promise.all([lease.ready, entry.environment.ready]);\n\t\t\t\t\tawait this.gate.wait(signal);\n\t\t\t\t\tinstance = await lease.createInstance();\n\t\t\t\t\tlet buildStarted = 0;\n\t\t\t\t\tawait this.gate.run(() => {\n\t\t\t\t\t\tbuildStarted = performance.now();\n\t\t\t\t\t\tsignal.throwIfAborted();\n\t\t\t\t\t\tconst settings = stage.model ?? {};\n\t\t\t\t\t\tapplyModelMaterialOverrides(instance!.scene, settings.materialOverrides);\n\t\t\t\t\t\tconst overrides = new Set<THREE.Material>();\n\t\t\t\t\t\tconst excluded = new Set(settings.excludeMeshes ?? []);\n\t\t\t\t\t\tinstance!.scene.traverse((object) => {\n\t\t\t\t\t\t\tif (!isMesh(object)) return;\n\t\t\t\t\t\t\tif (excluded.has(object.name)) object.visible = false;\n\t\t\t\t\t\t\tif (settings.materialOverrides?.[object.name])\n\t\t\t\t\t\t\t\tgetMeshMaterials(object).forEach((material) => overrides.add(material));\n\t\t\t\t\t\t});\n\t\t\t\t\t\tconst container = new THREE.Group();\n\t\t\t\t\t\tprepareSpatialElementFrame(container, instance!.scene, pair, settings);\n\t\t\t\t\t\thigh = {\n\t\t\t\t\t\t\tinstance: instance!,\n\t\t\t\t\t\t\toverrides,\n\t\t\t\t\t\t\tpose: container.children[0],\n\t\t\t\t\t\t\tblend: new SpatialElementRefinement(true)\n\t\t\t\t\t\t};\n\t\t\t\t\t\tinstance = undefined;\n\t\t\t\t\t\tif (getMeshBounds(container, (mesh) => !excluded.has(mesh.name)).isEmpty())\n\t\t\t\t\t\t\tthrow new Error('High contains no spatialElement meshes');\n\t\t\t\t\t}, signal);\n\t\t\t\t\tconst warmStarted = performance.now();\n\t\t\t\t\tawait this.warm(high!, environment, signal);\n\t\t\t\t\tentry.timings = {\n\t\t\t\t\t\tbuildMs: warmStarted - buildStarted,\n\t\t\t\t\t\tgpuWarmMs: performance.now() - warmStarted\n\t\t\t\t\t};\n\t\t\t\t\tawait this.gate.wait(signal);\n\t\t\t\t\tsignal.throwIfAborted();\n\t\t\t\t\tentry.high = high;\n\t\t\t\t\thigh = undefined;\n\t\t\t\t\tentry.highState = 'ready';\n\t\t\t\t\tthis.changed();\n\t\t\t\t} catch (error) {\n\t\t\t\t\tif (!signal.aborted) {\n\t\t\t\t\t\tentry.highState = 'failed';\n\t\t\t\t\t\tconsole.warn('Optional spatialElement preparation failed; retaining Low', error);\n\t\t\t\t\t\tthis.changed();\n\t\t\t\t\t}\n\t\t\t\t} finally {\n\t\t\t\t\tinstance?.dispose();\n\t\t\t\t\tif (high) disposePreparedHigh(high);\n\t\t\t\t\tlease.release();\n\t\t\t\t}\n\t\t\t})();\n\t\t}\n\t\treturn entry;\n\t}\n\ttakeHigh(entry: SpatialElementPreparation) {\n\t\tconst high = entry.high;\n\t\tif (high) {\n\t\t\tentry.high = undefined;\n\t\t\tentry.highState = 'adopted';\n\t\t}\n\t\treturn high;\n\t}\n\tdispose() {\n\t\tconst entry = this.current;\n\t\tthis.current = undefined;\n\t\tif (!entry) return;\n\t\tentry.controller.abort();\n\t\tentry.environment.release();\n\t\tif (entry.high) disposePreparedHigh(entry.high);\n\t}\n}\nexport function disposePreparedHigh(high: PreparedHigh) {\n\thigh.pose.removeFromParent();\n\thigh.blend.dispose();\n\thigh.overrides.forEach((material) => material.dispose());\n\thigh.instance.dispose();\n}\n"]}
@@ -0,0 +1,36 @@
1
+ /** Section state belongs to one history entry, never to the element asset or URL globally. */
2
+ export interface CatalogSectionSnapshot {
3
+ selections: Record<string, string>;
4
+ origin?: {
5
+ brandId: string;
6
+ spatialElementId: string;
7
+ occurrence: string;
8
+ slot: 'catalog.card' | 'carousel.front';
9
+ };
10
+ }
11
+ export declare const CATALOG_SECTIONS: unique symbol;
12
+ interface SelectionHost {
13
+ read(): string | undefined;
14
+ restore(key: string | undefined): void;
15
+ }
16
+ /** Persistent Stage service; the Kit bridge installs the history port and merges unrelated state. */
17
+ export declare class CatalogSections {
18
+ private hosts;
19
+ private history?;
20
+ connect(history: NonNullable<CatalogSections['history']>): () => void;
21
+ register(id: string, host: SelectionHost): () => void;
22
+ restore(): void;
23
+ /** Fresh view-link selection only; the bridge never calls this for history restoration. */
24
+ selectForView(sectionId: string, key: string): void;
25
+ /** Called after a user selection settles, not on every drag/animation frame. */
26
+ remember(): void;
27
+ activate(origin: NonNullable<CatalogSectionSnapshot['origin']>): void;
28
+ getOrigin(): {
29
+ brandId: string;
30
+ spatialElementId: string;
31
+ occurrence: string;
32
+ slot: "catalog.card" | "carousel.front";
33
+ } | undefined;
34
+ }
35
+ export {};
36
+ //# sourceMappingURL=CatalogSections.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"CatalogSections.d.ts","sourceRoot":"","sources":["../../src/catalog/CatalogSections.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,MAAM,WAAW,sBAAsB;IACtC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE;QACR,OAAO,EAAE,MAAM,CAAC;QAChB,gBAAgB,EAAE,MAAM,CAAC;QACzB,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,cAAc,GAAG,gBAAgB,CAAC;KACxC,CAAC;CACF;AAED,eAAO,MAAM,gBAAgB,eAA6B,CAAC;AAE3D,UAAU,aAAa;IACtB,IAAI,IAAI,MAAM,GAAG,SAAS,CAAC;IAC3B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;CACvC;AAED,qGAAqG;AACrG,qBAAa,eAAe;IAC3B,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,OAAO,CAAC,CAGd;IAEF,OAAO,CAAC,OAAO,EAAE,WAAW,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;IAOxD,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa;IAUxC,OAAO;IAKP,2FAA2F;IAC3F,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;IAI5C,gFAAgF;IAChF,QAAQ;IASR,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IAK9D,SAAS;iBAhEC,MAAM;0BACG,MAAM;oBACZ,MAAM;cACZ,cAAc,GAAG,gBAAgB;;CAgExC"}
@@ -0,0 +1,51 @@
1
+ export const CATALOG_SECTIONS = Symbol('catalog-sections');
2
+ /** Persistent Stage service; the Kit bridge installs the history port and merges unrelated state. */
3
+ export class CatalogSections {
4
+ hosts = new Map();
5
+ history;
6
+ connect(history) {
7
+ this.history = history;
8
+ return () => {
9
+ if (this.history === history)
10
+ this.history = undefined;
11
+ };
12
+ }
13
+ register(id, host) {
14
+ if (this.hosts.has(id))
15
+ throw new Error(`Duplicate carousel section: ${id}`);
16
+ const registration = { ...host };
17
+ this.hosts.set(id, registration);
18
+ host.restore(this.history?.read()?.selections?.[id]);
19
+ return () => {
20
+ if (this.hosts.get(id) === registration)
21
+ this.hosts.delete(id);
22
+ };
23
+ }
24
+ restore() {
25
+ const snapshot = this.history?.read();
26
+ for (const [id, host] of this.hosts)
27
+ host.restore(snapshot?.selections?.[id]);
28
+ }
29
+ /** Fresh view-link selection only; the bridge never calls this for history restoration. */
30
+ selectForView(sectionId, key) {
31
+ this.hosts.get(sectionId)?.restore(key);
32
+ }
33
+ /** Called after a user selection settles, not on every drag/animation frame. */
34
+ remember() {
35
+ const selections = Object.create(null);
36
+ for (const [id, host] of this.hosts) {
37
+ const key = host.read();
38
+ if (key !== undefined)
39
+ selections[id] = key;
40
+ }
41
+ this.history?.write({ ...this.history.read(), selections });
42
+ }
43
+ activate(origin) {
44
+ this.remember();
45
+ this.history?.write({ selections: {}, ...this.history.read(), origin });
46
+ }
47
+ getOrigin() {
48
+ return this.history?.read()?.origin;
49
+ }
50
+ }
51
+ //# sourceMappingURL=CatalogSections.js.map