@spatial-elements/core 1.0.0-beta.4 → 1.0.0-beta.6

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 (120) hide show
  1. package/README.md +1 -1
  2. package/dist/catalog/CarouselGlassCompositor.d.ts +7 -2
  3. package/dist/catalog/CarouselGlassCompositor.d.ts.map +1 -1
  4. package/dist/catalog/CarouselGlassCompositor.js +85 -24
  5. package/dist/catalog/CarouselGlassCompositor.js.map +1 -1
  6. package/dist/catalog/CarouselGround.d.ts +21 -0
  7. package/dist/catalog/CarouselGround.d.ts.map +1 -0
  8. package/dist/catalog/CarouselGround.js +107 -0
  9. package/dist/catalog/CarouselGround.js.map +1 -0
  10. package/dist/catalog/CatalogDepthBlur.d.ts +26 -0
  11. package/dist/catalog/CatalogDepthBlur.d.ts.map +1 -0
  12. package/dist/catalog/CatalogDepthBlur.js +87 -0
  13. package/dist/catalog/CatalogDepthBlur.js.map +1 -0
  14. package/dist/catalog/CatalogModelOutline.d.ts +31 -0
  15. package/dist/catalog/CatalogModelOutline.d.ts.map +1 -0
  16. package/dist/catalog/CatalogModelOutline.js +127 -0
  17. package/dist/catalog/CatalogModelOutline.js.map +1 -0
  18. package/dist/catalog/CatalogSpatialElementLayer.d.ts +29 -2
  19. package/dist/catalog/CatalogSpatialElementLayer.d.ts.map +1 -1
  20. package/dist/catalog/CatalogSpatialElementLayer.js +170 -41
  21. package/dist/catalog/CatalogSpatialElementLayer.js.map +1 -1
  22. package/dist/catalog/CatalogTransition.d.ts.map +1 -1
  23. package/dist/catalog/CatalogTransition.js +49 -4
  24. package/dist/catalog/CatalogTransition.js.map +1 -1
  25. package/dist/catalog/SpatialGeometryCapture.d.ts +9 -0
  26. package/dist/catalog/SpatialGeometryCapture.d.ts.map +1 -1
  27. package/dist/catalog/SpatialGeometryCapture.js +11 -1
  28. package/dist/catalog/SpatialGeometryCapture.js.map +1 -1
  29. package/dist/catalog/cardModelFit.d.ts +7 -0
  30. package/dist/catalog/cardModelFit.d.ts.map +1 -0
  31. package/dist/catalog/cardModelFit.js +16 -0
  32. package/dist/catalog/cardModelFit.js.map +1 -0
  33. package/dist/catalog/cardProjection.d.ts +8 -0
  34. package/dist/catalog/cardProjection.d.ts.map +1 -0
  35. package/dist/catalog/cardProjection.js +51 -0
  36. package/dist/catalog/cardProjection.js.map +1 -0
  37. package/dist/catalog/carouselMotion.d.ts +35 -0
  38. package/dist/catalog/carouselMotion.d.ts.map +1 -1
  39. package/dist/catalog/carouselMotion.js +85 -4
  40. package/dist/catalog/carouselMotion.js.map +1 -1
  41. package/dist/catalog/carouselProximity.d.ts +11 -0
  42. package/dist/catalog/carouselProximity.d.ts.map +1 -0
  43. package/dist/catalog/carouselProximity.js +13 -0
  44. package/dist/catalog/carouselProximity.js.map +1 -0
  45. package/dist/catalog/carouselSupport.d.ts +4 -0
  46. package/dist/catalog/carouselSupport.d.ts.map +1 -0
  47. package/dist/catalog/carouselSupport.js +30 -0
  48. package/dist/catalog/carouselSupport.js.map +1 -0
  49. package/dist/catalog/catalogPose.d.ts +36 -6
  50. package/dist/catalog/catalogPose.d.ts.map +1 -1
  51. package/dist/catalog/catalogPose.js +79 -23
  52. package/dist/catalog/catalogPose.js.map +1 -1
  53. package/dist/spatial-element/SpatialElementDockController.d.ts +1 -1
  54. package/dist/spatial-element/SpatialElementDockController.d.ts.map +1 -1
  55. package/dist/spatial-element/SpatialElementDockController.js +29 -2
  56. package/dist/spatial-element/SpatialElementDockController.js.map +1 -1
  57. package/dist/spatial-element/messages.d.ts +2 -0
  58. package/dist/spatial-element/messages.d.ts.map +1 -1
  59. package/dist/spatial-element/messages.js +1 -1
  60. package/dist/spatial-element/messages.js.map +1 -1
  61. package/dist/spatial-element/spatialTheme.d.ts.map +1 -1
  62. package/dist/spatial-element/spatialTheme.js +1 -0
  63. package/dist/spatial-element/spatialTheme.js.map +1 -1
  64. package/dist/spatial-element/types.d.ts +2 -0
  65. package/dist/spatial-element/types.d.ts.map +1 -1
  66. package/dist/spatial-element/types.js.map +1 -1
  67. package/dist/stage/LiquidGlassPanel.d.ts +2 -0
  68. package/dist/stage/LiquidGlassPanel.d.ts.map +1 -1
  69. package/dist/stage/LiquidGlassPanel.js +8 -1
  70. package/dist/stage/LiquidGlassPanel.js.map +1 -1
  71. package/dist/stage/MinimapController.d.ts +3 -1
  72. package/dist/stage/MinimapController.d.ts.map +1 -1
  73. package/dist/stage/MinimapController.js +23 -20
  74. package/dist/stage/MinimapController.js.map +1 -1
  75. package/dist/stage/PageBindingController.d.ts +4 -0
  76. package/dist/stage/PageBindingController.d.ts.map +1 -1
  77. package/dist/stage/PageBindingController.js +15 -4
  78. package/dist/stage/PageBindingController.js.map +1 -1
  79. package/dist/stage/PanelPresentationController.d.ts +1 -0
  80. package/dist/stage/PanelPresentationController.d.ts.map +1 -1
  81. package/dist/stage/PanelPresentationController.js +38 -7
  82. package/dist/stage/PanelPresentationController.js.map +1 -1
  83. package/dist/stage/SpatialElementInteractionController.d.ts +2 -0
  84. package/dist/stage/SpatialElementInteractionController.d.ts.map +1 -1
  85. package/dist/stage/SpatialElementInteractionController.js +23 -5
  86. package/dist/stage/SpatialElementInteractionController.js.map +1 -1
  87. package/dist/stage/StageExperience.d.ts +58 -1
  88. package/dist/stage/StageExperience.d.ts.map +1 -1
  89. package/dist/stage/StageExperience.js +112 -19
  90. package/dist/stage/StageExperience.js.map +1 -1
  91. package/dist/stage/StageFullscreenController.d.ts +17 -0
  92. package/dist/stage/StageFullscreenController.d.ts.map +1 -0
  93. package/dist/stage/StageFullscreenController.js +90 -0
  94. package/dist/stage/StageFullscreenController.js.map +1 -0
  95. package/dist/stage/StageRenderPipeline.d.ts +6 -0
  96. package/dist/stage/StageRenderPipeline.d.ts.map +1 -1
  97. package/dist/stage/StageRenderPipeline.js +46 -65
  98. package/dist/stage/StageRenderPipeline.js.map +1 -1
  99. package/dist/stage/VirtualScrollController.d.ts.map +1 -1
  100. package/dist/stage/VirtualScrollController.js +6 -0
  101. package/dist/stage/VirtualScrollController.js.map +1 -1
  102. package/dist/stage/interactionOutline.d.ts +14 -0
  103. package/dist/stage/interactionOutline.d.ts.map +1 -0
  104. package/dist/stage/interactionOutline.js +81 -0
  105. package/dist/stage/interactionOutline.js.map +1 -0
  106. package/dist/stage/minimap/MinimapProjection.d.ts +7 -0
  107. package/dist/stage/minimap/MinimapProjection.d.ts.map +1 -1
  108. package/dist/stage/minimap/MinimapProjection.js +14 -13
  109. package/dist/stage/minimap/MinimapProjection.js.map +1 -1
  110. package/dist/stage/panelContext.d.ts +9 -0
  111. package/dist/stage/panelContext.d.ts.map +1 -1
  112. package/dist/stage/panelContext.js.map +1 -1
  113. package/dist/stage/stageDom.d.ts +2 -0
  114. package/dist/stage/stageDom.d.ts.map +1 -1
  115. package/dist/stage/stageDom.js +4 -0
  116. package/dist/stage/stageDom.js.map +1 -1
  117. package/dist/stage/stageVisualTest.d.ts +2 -0
  118. package/dist/stage/stageVisualTest.d.ts.map +1 -1
  119. package/dist/stage/stageVisualTest.js.map +1 -1
  120. package/package.json +1 -1
@@ -21,7 +21,7 @@ import { CSS3DRenderer } from 'three/addons/renderers/CSS3DRenderer.js';
21
21
  import { uniform } from 'three/tsl';
22
22
  import { LiquidGlassPanel, resolveLiquidGlassPanelOptions } from './LiquidGlassPanel.js';
23
23
  import { STAGE_PANEL_LAYOUT_EVENT, STAGE_PANEL_VISUAL_EVENT } from './panelContext.js';
24
- import { DEFAULT_INTERACTION_THEME, DEFAULT_PANELS, PANEL_CAMERA_FOV, PANEL_CONTENT_Z, SPATIAL_ELEMENT_CAMERA_FIT_MARGIN, ZOOM_FOCUS_NOTIFY_EPSILON } from './stageConstants.js';
24
+ import { DEFAULT_BACKGROUND, DEFAULT_INTERACTION_THEME, DEFAULT_PANELS, PANEL_CAMERA_FOV, PANEL_CONTENT_Z, SPATIAL_ELEMENT_CAMERA_FIT_MARGIN, ZOOM_FOCUS_NOTIFY_EPSILON } from './stageConstants.js';
25
25
  import { getStagePositionFromRect, isViewportRectVisible } from './stageDom.js';
26
26
  import { STAGE_SCROLL_PRIORITY, getStageVisualScrollPosition, hasPendingStageScrollFrame, subscribeStageScrollFrame } from './scrollFrame.js';
27
27
  import { getCameraFitDistance, getCameraOrbitDirection, getBoxCorners, getPanelFocusOpacity, getPerspectiveDistance, getSequencedMinimapFocus, getStageUiFocus, getZoomFocusDistanceRange, hasPanelGeometryChanged } from './stageMath.js';
@@ -29,6 +29,7 @@ import {} from './SpaceMouseAdapter.js';
29
29
  import { disposeMinimapModelMaterials } from './minimap/MinimapModel.js';
30
30
  import {} from './minimap/MinimapProjection.js';
31
31
  import { disposeMaterialOnly, getMeshBounds, getMeshMaterials, isMesh } from './stageSceneUtils.js';
32
+ import { isOutlineMesh } from './interactionOutline.js';
32
33
  const SCROLL_SETTLE_DELAY = 120;
33
34
  const VIEWPORT_CULL_MARGIN = 96;
34
35
  /** Shared spatial state for both WebGPU glass and DOM-backed panel surfaces. */
@@ -58,6 +59,7 @@ export class StageExperience {
58
59
  }
59
60
  pipeline;
60
61
  backgroundSettings;
62
+ appliedEnvironment;
61
63
  pageBackground = '#ffffff';
62
64
  hdr;
63
65
  glb;
@@ -261,6 +263,14 @@ export class StageExperience {
261
263
  panelMeasurementsDirty = true;
262
264
  viewportMeasurementDirty = true;
263
265
  stageViewportVisible = true;
266
+ fullscreen = false;
267
+ setFullscreen(fullscreen) {
268
+ if (this.fullscreen === fullscreen)
269
+ return;
270
+ this.fullscreen = fullscreen;
271
+ this.interaction.setFullscreen(fullscreen);
272
+ this.resizeRenderer();
273
+ }
264
274
  get visiblePanelCount() {
265
275
  return this.panels.visiblePanels;
266
276
  }
@@ -348,12 +358,13 @@ export class StageExperience {
348
358
  restCamera: this.initialCameraWorldQuaternion,
349
359
  restModel: this.initialModelWorldQuaternion,
350
360
  hasControls: Boolean(this.controls),
351
- referenceTarget: this.getZoomReferenceTarget()
361
+ center: this.initialControlsTarget
352
362
  }),
353
363
  frame: () => ({
354
364
  hovering: this.modelHover,
355
365
  interacting: this.modelInteractionActive,
356
- scrolling: this.scrollActive
366
+ scrolling: this.scrollActive,
367
+ fullscreen: this.fullscreen
357
368
  }),
358
369
  environment: () => this.environmentTarget,
359
370
  capture: () => this.pipeline.activeRenderTargets,
@@ -374,6 +385,7 @@ export class StageExperience {
374
385
  presentation: this.catalogPresentation,
375
386
  minimapFocus: this.minimapFocus,
376
387
  uiFocus: this.panelUiFocus,
388
+ fullscreen: this.fullscreen,
377
389
  pointer: this.pointer
378
390
  }),
379
391
  visible: (index) => this.isPanelTargetVisible(index),
@@ -501,6 +513,9 @@ export class StageExperience {
501
513
  this.pipeline.createSceneCapture();
502
514
  this.createPanels();
503
515
  this.resizeRenderer();
516
+ // Reparenting must preserve the already visible HTML in the same task;
517
+ // shader compilation below can yield for more than one browser frame.
518
+ this.renderPanelContents();
504
519
  this.pipeline.warmRenderTargetSets();
505
520
  await this.pipeline.prepareZoomEffects();
506
521
  if (this.disposed)
@@ -615,6 +630,8 @@ export class StageExperience {
615
630
  element);
616
631
  }
617
632
  capturePanelSurface(element) {
633
+ if (element.closest('[data-carousel-spatial-element]'))
634
+ return captureCssSurface(element, element, '::before');
618
635
  if (element.hasAttribute('data-catalog-dock-surface')) {
619
636
  const header = element.closest('[data-spatial-element-sticky-header]');
620
637
  if (header)
@@ -688,6 +705,77 @@ export class StageExperience {
688
705
  return;
689
706
  return { width, height, corners: corners };
690
707
  }
708
+ /** Updates appearance in place. Model leases, camera, interaction and page navigation stay intact. */
709
+ updateAppearance(options) {
710
+ if (this.disposed)
711
+ return;
712
+ this.pageBackground = options.pageBackground ?? '#ffffff';
713
+ this.pipeline.setPageBackground(this.pageBackground);
714
+ this.catalogLayer?.setPageBackground(this.pageBackground);
715
+ this.backgroundSettings = { ...DEFAULT_BACKGROUND, ...options.background };
716
+ if (this.appliedEnvironment) {
717
+ this.backgroundScene.background = this.backgroundSettings.blurriness <= 0
718
+ ? this.appliedEnvironment.source : this.appliedEnvironment.target.texture;
719
+ }
720
+ this.backgroundScene.backgroundBlurriness = this.backgroundSettings.blurriness;
721
+ if (this.tintMaterial) {
722
+ this.tintMaterial.color.set(this.backgroundSettings.tint);
723
+ this.tintMaterial.opacity = this.backgroundSettings.tintIntensity;
724
+ }
725
+ const previousExcludeMesh = this.interactionTheme.excludeMesh;
726
+ Object.assign(this.interactionTheme, DEFAULT_INTERACTION_THEME, { excludeMesh: undefined }, options.interactionTheme);
727
+ this.pipeline.updateInteractionTheme();
728
+ if (previousExcludeMesh !== this.interactionTheme.excludeMesh && this.model) {
729
+ const pickModel = this.refinementState === 'high' && this.highPose ? this.highPose : this.model;
730
+ this.collectModelPickTargets(pickModel);
731
+ if (pickModel === this.model)
732
+ this.pipeline.createModelOutline(this.model);
733
+ else {
734
+ const outline = this.model.clone(false);
735
+ outline.add(pickModel.clone(true));
736
+ this.pipeline.createModelOutline(outline);
737
+ }
738
+ }
739
+ const changed = [];
740
+ let surfaceChanged = false;
741
+ for (const next of options.panels ?? []) {
742
+ const index = this.panelTargets.findIndex((target) => target.frame === next.frame);
743
+ const target = this.panelTargets[index];
744
+ if (!target)
745
+ continue; // Navigation owns newly registered panels.
746
+ const appearance = (panel) => JSON.stringify([
747
+ panel.options, panel.minimap, panel.surface, panel.contentInset
748
+ ]);
749
+ if (appearance(target) === appearance(next))
750
+ continue;
751
+ surfaceChanged ||= target.surface !== next.surface;
752
+ Object.assign(target, next);
753
+ changed.push(index);
754
+ }
755
+ if (changed.length) {
756
+ this.fallbackPanelOptions = this.panelTargets
757
+ .filter((target) => target.surface === 'glass' || target.minimap).map((target) => target.options);
758
+ this.pipeline.syncPanelBlurCaptures();
759
+ if (surfaceChanged) {
760
+ // A backend change only replaces panel presentation, never the element scene.
761
+ this.minimapController.dispose();
762
+ this.panels.release();
763
+ this.createPanels();
764
+ }
765
+ else
766
+ for (const index of changed) {
767
+ const target = this.panelTargets[index];
768
+ const measured = this.getMeasuredPanelOptions(target, true);
769
+ if (this.panelRuntimes[index]?.glass)
770
+ this.replacePanel(index, measured);
771
+ else if (this.panelRuntimes[index])
772
+ this.panelRuntimes[index].options = resolveLiquidGlassPanelOptions(measured);
773
+ this.createMinimap(index, target.minimap);
774
+ }
775
+ this.panelMeasurementsDirty = this.layoutDirty = true;
776
+ }
777
+ this.requestRender();
778
+ }
691
779
  async updatePage(options) {
692
780
  if (this.disposed)
693
781
  return;
@@ -766,7 +854,7 @@ export class StageExperience {
766
854
  void this.initializeSpaceMouse();
767
855
  }
768
856
  setCatalogSpatialElements(brandId, items) {
769
- this.catalogLayer ??= new CatalogSpatialElementLayer(this.assets, () => this.requestRender());
857
+ this.catalogLayer ??= new CatalogSpatialElementLayer(this.assets, () => this.requestRender(), () => this.interactionTheme);
770
858
  this.catalogLayer.setPageBackground(this.pageBackground);
771
859
  this.catalogLayer.setExitOpacity(this.returnSpatialElement
772
860
  ? this.catalogPresentation.enterOpacity
@@ -874,6 +962,8 @@ export class StageExperience {
874
962
  device.destroy();
875
963
  }
876
964
  getPanelTransitionOpacity(panel) {
965
+ if (panel?.content?.element.closest('[data-catalog-shell-continuous]'))
966
+ return 1;
877
967
  return getCatalogTransitionOpacity(this.catalogPresentation, panel?.transitionGroup);
878
968
  }
879
969
  captureCatalogGeometry(spatialElementId) {
@@ -1052,6 +1142,7 @@ export class StageExperience {
1052
1142
  this.pageModelReady = false;
1053
1143
  this.spatialCapture = new SpatialGeometryCapture(model, projection, {
1054
1144
  environment: this.scene.environment,
1145
+ outlineTheme: this.modelHover ? this.interactionTheme : undefined,
1055
1146
  environmentIntensity: this.scene.environmentIntensity,
1056
1147
  lights: this.scene.children.filter((child) => child instanceof THREE.Light),
1057
1148
  high: highPose,
@@ -1495,6 +1586,15 @@ export class StageExperience {
1495
1586
  const minimap = this.minimaps.values().next().value;
1496
1587
  return minimap ? this.getProjectedMinimapModelRect(minimap) : null;
1497
1588
  }
1589
+ /** Returns the visible viewport mask in minimap-local pixels. */
1590
+ getVisualTestMinimapViewportRect() {
1591
+ const minimap = this.minimaps.values().next().value;
1592
+ if (!minimap)
1593
+ return null;
1594
+ const center = minimap.overlayViewportCenter.value;
1595
+ const halfSize = minimap.overlayViewportHalfSize.value;
1596
+ return { x: center.x - halfSize.x, y: center.y - halfSize.y, width: halfSize.x * 2, height: halfSize.y * 2 };
1597
+ }
1498
1598
  /** Returns minimap orientation endpoints for query-gated browser regressions. */
1499
1599
  getVisualTestMinimapOrientation() {
1500
1600
  const minimap = this.minimaps.values().next().value;
@@ -1676,6 +1776,7 @@ export class StageExperience {
1676
1776
  }
1677
1777
  }
1678
1778
  applyEnvironment(environment) {
1779
+ this.appliedEnvironment = environment;
1679
1780
  this.presentation.retainEnvironment(this.environments, environment);
1680
1781
  this.environmentTarget = environment.target;
1681
1782
  const texture = environment.target.texture;
@@ -1900,18 +2001,7 @@ export class StageExperience {
1900
2001
  this.interaction.setPickTargets(model, (mesh) => this.isInteractionMesh(mesh));
1901
2002
  }
1902
2003
  isInteractionMesh(mesh) {
1903
- if (!this.isSpatialElementMesh(mesh))
1904
- return false;
1905
- if (this.interactionTheme.excludeMesh?.(mesh))
1906
- return false;
1907
- if (mesh.userData.stagePick === false || mesh.userData.stageOutline === false)
1908
- return false;
1909
- const materialNames = getMeshMaterials(mesh)
1910
- .map((material) => material.name)
1911
- .filter(Boolean)
1912
- .join(' ');
1913
- const label = `${mesh.name} ${materialNames}`.toLowerCase();
1914
- return !/(shadow|ground|floor|plane|helper|collision|collider|reflection)/i.test(label);
2004
+ return this.isSpatialElementMesh(mesh) && isOutlineMesh(mesh, this.interactionTheme);
1915
2005
  }
1916
2006
  createPanels() {
1917
2007
  if (!this.pipeline.activeRenderTargets &&
@@ -2142,6 +2232,9 @@ export class StageExperience {
2142
2232
  return true;
2143
2233
  if (target.getVisible?.() === false)
2144
2234
  return false;
2235
+ if (this.fullscreen)
2236
+ return Boolean(target.minimap || target.focusReactive === 'top-right' ||
2237
+ target.content.hasAttribute('data-stage-fullscreen-visible'));
2145
2238
  const cachedRect = this.pageBinding.getPanelRect(target.frame);
2146
2239
  if (!cachedRect)
2147
2240
  return true;
@@ -2182,7 +2275,7 @@ export class StageExperience {
2182
2275
  const width = window.innerWidth;
2183
2276
  const height = window.innerHeight;
2184
2277
  const element = this.viewportTarget?.element;
2185
- if (!element) {
2278
+ if (!element || this.fullscreen) {
2186
2279
  this.stageViewportVisible = true;
2187
2280
  this.viewportFrame.set(0, 0, width, height);
2188
2281
  this.viewportLayoutSize.set(width, height);
@@ -2425,8 +2518,8 @@ export class StageExperience {
2425
2518
  // The damped camera distance is the single animation clock for geometry and
2426
2519
  // every close-up UI phase. Phase remapping remains, temporal lag does not.
2427
2520
  this.panelFocus = this.getZoomFocusFactor();
2428
- this.panelUiFocus = getStageUiFocus(this.panelFocus);
2429
- this.minimapFocus = getSequencedMinimapFocus(this.panelFocus, this.panelUiFocus);
2521
+ this.panelUiFocus = this.fullscreen ? 1 : getStageUiFocus(this.panelFocus);
2522
+ this.minimapFocus = this.fullscreen ? 1 : getSequencedMinimapFocus(this.panelFocus, this.panelUiFocus);
2430
2523
  this.updateStageCameraProjection();
2431
2524
  this.reportZoomFocus({
2432
2525
  focus: this.panelFocus,