u-space 0.0.7 → 0.0.9

package/dist/index.js

@@ -1,27 +1,27 @@
-import { Raycaster as Te, Vector2 as R, RenderPipeline as $e, PerspectiveCamera as K, Sphere as Se, Box3 as xe, Spherical as C, Matrix4 as We, Quaternion as Ke, Vector4 as Qe, Vector3 as oe, MathUtils as Xe, PMREMGenerator as qe, OrthographicCamera as Q, TimestampQuery as Ye, Cache as Je, EventDispatcher as Ze, Timer as Ve, WebGPURenderer as et, PCFShadowMap as tt, AgXToneMapping as st, Scene as it, Color as V, MeshStandardNodeMaterial as L, Loader as nt, LoaderUtils as I, FileLoader as Ee, TextureLoader as Me, Group as ee, SRGBColorSpace as Pe, RepeatWrapping as ce, BufferGeometry as rt, BufferAttribute as he, Mesh as z, FrontSide as at, BackSide as ot, DoubleSide as ct, REVISION as le, CubeTextureLoader as ht, EquirectangularReflectionMapping as lt, Sprite as dt, AnimationMixer as pt, LoopRepeat as ut, LoopOnce as mt, SphereGeometry as gt, TubeGeometry as ft, LineCurve3 as yt, CatmullRomCurve3 as wt, SpriteNodeMaterial as vt, CanvasTexture as bt, ShapeGeometry as Ct, Shape as Oe, ExtrudeGeometry as Tt, PlaneGeometry as St, CircleGeometry as xt } from "three/webgpu";
-import { pass as re, mrt as Et, output as Mt, add as de, blendColor as Pt, emissive as Ot, normalView as Rt, velocity as It, color as j, uv as pe, time as X, pow as q, sin as ae, mix as Y, mx_noise_float as ue, Fn as Re, userData as O, materialColor as me, select as J, materialOpacity as Lt, vec3 as At } from "three/tsl";
-import { bloom as Nt } from "three/addons/tsl/display/BloomNode.js";
-import { ssgi as Bt } from "three/addons/tsl/display/SSGINode.js";
-import { traa as _t } from "three/addons/tsl/display/TRAANode.js";
-import Ie from "camera-controls";
-import { RoomEnvironment as Dt } from "three/addons/environments/RoomEnvironment.js";
-import { ViewHelper as jt } from "three/addons/helpers/ViewHelper.js";
-import { CSS2DRenderer as Ut, CSS2DObject as kt } from "three/addons/renderers/CSS2DRenderer.js";
-import { CSS2DObject as pi } from "three/addons/renderers/CSS2DRenderer.js";
-import { CSS3DRenderer as Gt, CSS3DSprite as Ft, CSS3DObject as zt } from "three/addons/renderers/CSS3DRenderer.js";
-import { CSS3DObject as mi, CSS3DSprite as gi } from "three/addons/renderers/CSS3DRenderer.js";
-import { GLTFLoader as Le } from "three/addons/loaders/GLTFLoader.js";
-import { FBXLoader as Ht } from "three/addons/loaders/FBXLoader.js";
-import { OBJLoader as $t } from "three/addons/loaders/OBJLoader.js";
-import { STLLoader as Wt } from "three/addons/loaders/STLLoader.js";
-import { DRACOLoader as Kt } from "three/addons/loaders/DRACOLoader.js";
-import { KTX2Loader as Qt } from "three/addons/loaders/KTX2Loader.js";
-import { MeshoptDecoder as ge } from "three/addons/libs/meshopt_decoder.module.js";
-import { HDRLoader as Xt } from "three/addons/loaders/HDRLoader.js";
-import { clone as qt } from "three/addons/utils/SkeletonUtils.js";
+import { Raycaster as Be, Vector2 as S, EventDispatcher as Le, Box2 as tt, Matrix4 as Ie, Vector3 as w, Box3 as q, Scene as Re, Color as B, AmbientLight as st, DirectionalLight as ue, PointLight as me, SpotLight as ge, HemisphereLight as fe, DirectionalLightHelper as nt, PointLightHelper as it, SpotLightHelper as rt, HemisphereLightHelper as ot, RenderPipeline as at, PerspectiveCamera as J, Sphere as ze, Spherical as C, Quaternion as ct, Vector4 as ht, MathUtils as lt, PMREMGenerator as dt, OrthographicCamera as V, TimestampQuery as pt, Cache as ut, Timer as mt, WebGPURenderer as gt, PCFShadowMap as ft, AgXToneMapping as yt, Fog as wt, FogExp2 as bt, MeshStandardNodeMaterial as R, Loader as vt, LoaderUtils as L, FileLoader as Ne, TextureLoader as je, Group as I, SRGBColorSpace as De, RepeatWrapping as ye, BufferGeometry as K, BufferAttribute as we, Mesh as G, FrontSide as xt, BackSide as St, DoubleSide as Ct, REVISION as be, CubeTextureLoader as _t, EquirectangularReflectionMapping as Mt, Sprite as Tt, AnimationMixer as Pt, LoopRepeat as Et, LoopOnce as Ot, SphereGeometry as At, TubeGeometry as Bt, LineCurve3 as Lt, CatmullRomCurve3 as It, SpriteNodeMaterial as Rt, CanvasTexture as zt, ShapeGeometry as Nt, Shape as ke, ExtrudeGeometry as jt, PlaneGeometry as Dt, CircleGeometry as kt, ClippingGroup as Ht, Plane as Ut, PlaneHelper as Ft, LineBasicMaterial as Z, Line as ee } from "three/webgpu";
+import { pass as de, mrt as Gt, output as $t, add as ve, blendColor as Wt, emissive as Kt, normalView as Qt, velocity as qt, color as H, uv as xe, time as te, pow as se, sin as pe, mix as ne, mx_noise_float as Se, Fn as He, userData as A, materialColor as Ce, select as ie, materialOpacity as Xt, vec3 as Yt } from "three/tsl";
+import { bloom as Jt } from "three/addons/tsl/display/BloomNode.js";
+import { ssgi as Vt } from "three/addons/tsl/display/SSGINode.js";
+import { traa as Zt } from "three/addons/tsl/display/TRAANode.js";
+import Ue from "camera-controls";
+import { RoomEnvironment as es } from "three/addons/environments/RoomEnvironment.js";
+import { ViewHelper as ts } from "three/addons/helpers/ViewHelper.js";
+import { CSS2DRenderer as ss, CSS2DObject as ns } from "three/addons/renderers/CSS2DRenderer.js";
+import { CSS2DObject as Nn } from "three/addons/renderers/CSS2DRenderer.js";
+import { CSS3DRenderer as is, CSS3DSprite as rs, CSS3DObject as os } from "three/addons/renderers/CSS3DRenderer.js";
+import { CSS3DObject as Dn, CSS3DSprite as kn } from "three/addons/renderers/CSS3DRenderer.js";
+import { GLTFLoader as Fe } from "three/addons/loaders/GLTFLoader.js";
+import { FBXLoader as as } from "three/addons/loaders/FBXLoader.js";
+import { OBJLoader as cs } from "three/addons/loaders/OBJLoader.js";
+import { STLLoader as hs } from "three/addons/loaders/STLLoader.js";
+import { DRACOLoader as ls } from "three/addons/loaders/DRACOLoader.js";
+import { KTX2Loader as ds } from "three/addons/loaders/KTX2Loader.js";
+import { MeshoptDecoder as _e } from "three/addons/libs/meshopt_decoder.module.js";
+import { HDRLoader as ps } from "three/addons/loaders/HDRLoader.js";
+import { clone as us } from "three/addons/utils/SkeletonUtils.js";
 import { Color as U } from "three";
-import { Easing as u, Tween as Yt } from "three/addons/libs/tween.module.js";
-class Jt {
+import { Easing as m, Tween as ms } from "three/addons/libs/tween.module.js";
+class gs {
   /** The type of event (e.g., 'click', 'pointerdown'). */
   type;
   /** The original 3D object that triggered the event. */
@@ -49,15 +49,15 @@ class Jt {
     return this._propagationStopped;
   }
 }
-class Zt {
+class fs {
   domElement;
   scene;
   camera;
-  raycaster = new Te();
-  pointer = new R();
+  raycaster = new Be();
+  pointer = new S();
   hoveredObject = null;
   pointerDownTime = 0;
-  pointerDownPos = new R();
+  pointerDownPos = new S();
   clickTimer = null;
   longPressThreshold = 500;
   moveThreshold = 0.01;
@@ -70,6 +70,14 @@ class Zt {
    * Disabled by default for performance optimization.
    */
   pointerMoveEventsEnabled = !1;
+  /**
+   * Whether interaction is enabled globally.
+   */
+  _enabled = !0;
+  /**
+   * Objects excluded from raycasting (via addIgnore or setInteractable(false)).
+   */
+  _excludeSet = /* @__PURE__ */ new Set();
   constructor(e, t, s) {
     this.domElement = e, this.scene = t, this.camera = s, this.raycaster.params.Points.threshold = 0.1, this.raycaster.params.Line.threshold = 0.1, this.targetObjects = this.scene.children, this._bindEvents();
   }
@@ -79,6 +87,39 @@ class Zt {
   setCamera(e) {
     this.camera = e;
   }
+  /**
+   * Enable all interactions.
+   */
+  enable() {
+    this._enabled = !0;
+  }
+  /**
+   * Disable all interactions.
+   */
+  disable() {
+    this._enabled = !1;
+  }
+  /**
+   * Set whether a specific object is interactable.
+   * When set to false, the object and its children are excluded from raycasting.
+   */
+  setInteractable(e, t) {
+    t ? this._excludeSet.delete(e) : this._excludeSet.add(e);
+  }
+  /**
+   * Add an object to the exclude list (will not receive any events).
+   * Alias for `setInteractable(object, false)`.
+   */
+  addIgnore(e) {
+    this._excludeSet.add(e);
+  }
+  /**
+   * Remove an object from the exclude list.
+   * Alias for `setInteractable(object, true)`.
+   */
+  removeIgnore(e) {
+    this._excludeSet.delete(e);
+  }
   _bindEvents() {
     this.domElement.addEventListener("click", this._onClick), this.domElement.addEventListener("dblclick", this._onDblClick), this.domElement.addEventListener("contextmenu", this._onContextMenu), this.domElement.addEventListener("pointerdown", this._onPointerDown), this.domElement.addEventListener("pointerup", this._onPointerUp), this.domElement.addEventListener("pointermove", this._onPointerMove);
   }
@@ -87,31 +128,42 @@ class Zt {
     this.pointer.x = (e.clientX - t.left) / t.width * 2 - 1, this.pointer.y = -((e.clientY - t.top) / t.height) * 2 + 1;
   }
   _getIntersects() {
-    return this.raycaster.setFromCamera(this.pointer, this.camera), this.raycaster.intersectObjects(this.targetObjects, !0);
+    this.raycaster.setFromCamera(this.pointer, this.camera);
+    const e = this.raycaster.intersectObjects(this.targetObjects, !0);
+    return this._excludeSet.size > 0 ? e.filter((t) => {
+      let s = t.object;
+      for (; s; ) {
+        if (this._excludeSet.has(s))
+          return !1;
+        s = s.parent;
+      }
+      return !0;
+    }) : e;
   }
   /**
    * Dispatches an event to the target object and bubbles up the parent chain.
    */
-  _dispatchToTarget(e, t, s, i) {
-    const n = new Jt({
+  _dispatchToTarget(e, t, s, n) {
+    const i = new gs({
       type: e,
       target: t,
       intersect: s,
-      originalEvent: i
+      originalEvent: n
     });
     let r = t;
-    for (; r && !n.propagationStopped; )
-      n.currentTarget = r, r.dispatchEvent({ type: e, event: n }), r = r.parent;
+    for (; r && !i.propagationStopped; )
+      i.currentTarget = r, r.dispatchEvent({ type: e, event: i }), r = r.parent;
   }
   /**
    * Handles a DOM event by raycasting and dispatching to the first intersected object.
    */
   _handleEvent(e, t) {
+    if (!this._enabled) return;
     this._updatePointer(t);
     const s = this._getIntersects();
     if (s.length === 0) return;
-    const i = s[0];
-    this._dispatchToTarget(e, i.object, i, t);
+    const n = s[0];
+    this._dispatchToTarget(e, n.object, n, t);
   }
   _onClick = (e) => {
     const t = Date.now() - this.pointerDownTime, s = this.pointer.distanceTo(this.pointerDownPos);
@@ -142,19 +194,155 @@ class Zt {
     this._handleEvent("pointerup", e);
   };
   _onPointerMove = (e) => {
-    if (!this.pointerMoveEventsEnabled) return;
+    if (!this._enabled || !this.pointerMoveEventsEnabled) return;
     this._updatePointer(e);
-    const t = this._getIntersects(), s = t.length > 0 ? t[0].object : null, i = t.length > 0 ? t[0] : null;
-    this.hoveredObject !== s && (this.hoveredObject && this._dispatchToTarget("pointerleave", this.hoveredObject, null, e), this.hoveredObject = s, s && i && this._dispatchToTarget("pointerenter", s, i, e)), s && i && this._dispatchToTarget("pointermove", s, i, e);
+    const t = this._getIntersects(), s = t.length > 0 ? t[0].object : null, n = t.length > 0 ? t[0] : null;
+    this.hoveredObject !== s && (this.hoveredObject && this._dispatchToTarget("pointerleave", this.hoveredObject, null, e), this.hoveredObject = s, s && n && this._dispatchToTarget("pointerenter", s, n, e)), s && n && this._dispatchToTarget("pointermove", s, n, e);
   };
   /**
    * Cleans up event listeners.
    */
   dispose() {
-    this.domElement.removeEventListener("click", this._onClick), this.domElement.removeEventListener("dblclick", this._onDblClick), this.domElement.removeEventListener("contextmenu", this._onContextMenu), this.domElement.removeEventListener("pointerdown", this._onPointerDown), this.domElement.removeEventListener("pointerup", this._onPointerUp), this.domElement.removeEventListener("pointermove", this._onPointerMove), this.hoveredObject = null;
+    this.domElement.removeEventListener("click", this._onClick), this.domElement.removeEventListener("dblclick", this._onDblClick), this.domElement.removeEventListener("contextmenu", this._onContextMenu), this.domElement.removeEventListener("pointerdown", this._onPointerDown), this.domElement.removeEventListener("pointerup", this._onPointerUp), this.domElement.removeEventListener("pointermove", this._onPointerMove), this.clickTimer && (clearTimeout(this.clickTimer), this.clickTimer = null), this.hoveredObject = null, this._excludeSet.clear();
   }
 }
-class Vt {
+class bn extends Le {
+  scene;
+  camera;
+  domElement;
+  /** The container element for the selection box overlay (domElement's parent). */
+  _container;
+  _selected = /* @__PURE__ */ new Set();
+  // Box selection state
+  _boxSelectionEnabled = !1;
+  _isSelecting = !1;
+  _startPoint = new S();
+  _endPoint = new S();
+  _selectionBox = null;
+  _deep = !0;
+  /**
+   * Objects available for selection (defaults to scene.children).
+   */
+  targetObjects = null;
+  constructor(e, t, s) {
+    super(), this.domElement = e, this._container = e.parentElement ?? e, this.scene = t, this.camera = s;
+  }
+  get selected() {
+    return this._selected;
+  }
+  get selectedArray() {
+    return Array.from(this._selected);
+  }
+  /**
+   * Select one or more objects.
+   */
+  select(e) {
+    const t = Array.isArray(e) ? e : [e], s = [];
+    for (const n of t)
+      this._selected.has(n) || (this._selected.add(n), s.push(n));
+    s.length > 0 && (this.dispatchEvent({ type: "select", objects: s }), this.dispatchEvent({ type: "change", selected: this._selected }));
+  }
+  /**
+   * Deselect one or more objects.
+   */
+  deselect(e) {
+    const t = Array.isArray(e) ? e : [e], s = [];
+    for (const n of t)
+      this._selected.delete(n) && s.push(n);
+    s.length > 0 && (this.dispatchEvent({ type: "deselect", objects: s }), this.dispatchEvent({ type: "change", selected: this._selected }));
+  }
+  /**
+   * Toggle selection of an object.
+   */
+  toggle(e) {
+    this._selected.has(e) ? this.deselect(e) : this.select(e);
+  }
+  /**
+   * Clear all selections.
+   */
+  clear() {
+    if (this._selected.size === 0) return;
+    const e = Array.from(this._selected);
+    this._selected.clear(), this.dispatchEvent({ type: "deselect", objects: e }), this.dispatchEvent({ type: "change", selected: this._selected });
+  }
+  /**
+   * Check if an object is selected.
+   */
+  isSelected(e) {
+    return this._selected.has(e);
+  }
+  /**
+   * Enable rubber-band box selection mode.
+   */
+  enableBoxSelection(e = {}) {
+    this._boxSelectionEnabled || (this._boxSelectionEnabled = !0, this._deep = e.deep ?? !0, this._selectionBox = document.createElement("div"), this._selectionBox.style.cssText = `
+      position: absolute;
+      border: 1px dashed #55aaff;
+      background: rgba(75, 160, 255, 0.15);
+      pointer-events: none;
+      display: none;
+      z-index: 9999;
+    `, e.className && (this._selectionBox.className = e.className), this._container.style.position = this._container.style.position || "relative", this._container.appendChild(this._selectionBox), this.domElement.addEventListener("pointerdown", this._onBoxPointerDown), this.domElement.addEventListener("pointermove", this._onBoxPointerMove), this.domElement.addEventListener("pointerup", this._onBoxPointerUp));
+  }
+  /**
+   * Disable box selection mode.
+   */
+  disableBoxSelection() {
+    this._boxSelectionEnabled && (this._boxSelectionEnabled = !1, this.domElement.removeEventListener("pointerdown", this._onBoxPointerDown), this.domElement.removeEventListener("pointermove", this._onBoxPointerMove), this.domElement.removeEventListener("pointerup", this._onBoxPointerUp), this._selectionBox && (this._selectionBox.remove(), this._selectionBox = null));
+  }
+  setCamera(e) {
+    this.camera = e;
+  }
+  _onBoxPointerDown = (e) => {
+    if (e.button !== 0) return;
+    this._isSelecting = !0;
+    const t = this._container.getBoundingClientRect();
+    this._startPoint.set(e.clientX - t.left, e.clientY - t.top), this._endPoint.copy(this._startPoint), this._selectionBox && (this._selectionBox.style.display = "block", this._updateBoxElement());
+  };
+  _onBoxPointerMove = (e) => {
+    if (!this._isSelecting) return;
+    const t = this._container.getBoundingClientRect();
+    this._endPoint.set(e.clientX - t.left, e.clientY - t.top), this._updateBoxElement();
+  };
+  _onBoxPointerUp = () => {
+    if (!this._isSelecting) return;
+    this._isSelecting = !1, this._selectionBox && (this._selectionBox.style.display = "none");
+    const e = this._getObjectsInBox();
+    this.clear(), e.length > 0 && this.select(e);
+  };
+  _updateBoxElement() {
+    if (!this._selectionBox) return;
+    const e = Math.min(this._startPoint.x, this._endPoint.x), t = Math.min(this._startPoint.y, this._endPoint.y), s = Math.abs(this._endPoint.x - this._startPoint.x), n = Math.abs(this._endPoint.y - this._startPoint.y);
+    this._selectionBox.style.left = `${e}px`, this._selectionBox.style.top = `${t}px`, this._selectionBox.style.width = `${s}px`, this._selectionBox.style.height = `${n}px`;
+  }
+  _getObjectsInBox() {
+    const e = this._container.getBoundingClientRect(), t = e.width, s = e.height, n = new S(
+      this._startPoint.x / t * 2 - 1,
+      -(this._startPoint.y / s) * 2 + 1
+    ), i = new S(
+      this._endPoint.x / t * 2 - 1,
+      -(this._endPoint.y / s) * 2 + 1
+    ), r = new tt(
+      new S(Math.min(n.x, i.x), Math.min(n.y, i.y)),
+      new S(Math.max(n.x, i.x), Math.max(n.y, i.y))
+    ), o = this.targetObjects || this.scene.children, a = [], c = new Ie();
+    c.multiplyMatrices(this.camera.projectionMatrix, this.camera.matrixWorldInverse);
+    const h = (d) => {
+      if (!d.visible) return;
+      const p = new w();
+      if (p.setFromMatrixPosition(d.matrixWorld), p.applyMatrix4(c), p.z > -1 && p.z < 1 && r.containsPoint(new S(p.x, p.y)) && a.push(d), this._deep)
+        for (const u of d.children)
+          h(u);
+    };
+    for (const d of o)
+      h(d);
+    return a;
+  }
+  dispose() {
+    this.disableBoxSelection(), this._selected.clear();
+  }
+}
+class ys {
   idMap = /* @__PURE__ */ new Map();
   nameMap = /* @__PURE__ */ new Map();
   typeMap = /* @__PURE__ */ new Map();
@@ -256,8 +444,272 @@ class Vt {
   get size() {
     return this.allObjects.size;
   }
+  /**
+   * Show an object by id.
+   */
+  show(e) {
+    const t = this.idMap.get(e);
+    t && (t.visible = !0);
+  }
+  /**
+   * Hide an object by id.
+   */
+  hide(e) {
+    const t = this.idMap.get(e);
+    t && (t.visible = !1);
+  }
+  /**
+   * Show only the specified objects, hide all others.
+   */
+  isolate(e) {
+    const t = new Set(e);
+    for (const [s, n] of this.idMap)
+      n.visible = t.has(s);
+  }
+  /**
+   * Set the opacity of an object's materials.
+   */
+  setOpacity(e, t) {
+    const s = this.idMap.get(e);
+    s && s.traverse((n) => {
+      if (!n.isMesh) return;
+      const i = n.material;
+      if (!i) return;
+      const r = Array.isArray(i) ? i : [i];
+      for (const o of r)
+        o.transparent = t < 1, o.opacity = t, o.needsUpdate = !0;
+    });
+  }
+  /**
+   * Get the bounding box of an object by id, or all objects if no id provided.
+   */
+  getBoundingBox(e) {
+    const t = new q();
+    if (e) {
+      const s = this.idMap.get(e);
+      s && t.setFromObject(s);
+    } else
+      for (const s of this.allObjects)
+        t.expandByObject(s);
+    return t;
+  }
+  /**
+   * Iterate over all managed objects.
+   */
+  forEach(e) {
+    for (const t of this.allObjects) {
+      const s = this.objectIds.get(t) || /* @__PURE__ */ new Set();
+      e(t, s);
+    }
+  }
+  /**
+   * Filter objects by a predicate.
+   */
+  filter(e) {
+    const t = [];
+    for (const s of this.allObjects)
+      e(s) && t.push(s);
+    return t;
+  }
+  /**
+   * Show all managed objects.
+   */
+  showAll() {
+    for (const e of this.allObjects)
+      e.visible = !0;
+  }
 }
-class es extends $e {
+class vn {
+  scenes = /* @__PURE__ */ new Map();
+  _activeSceneKey = null;
+  /**
+   * Add a scene with a key.
+   */
+  add(e, t) {
+    this.scenes.set(e, t);
+  }
+  /**
+   * Create and register a new scene.
+   */
+  create(e, t = {}) {
+    const s = new Re();
+    return t.background !== void 0 && (s.background = new B(t.background)), this.scenes.set(e, s), s;
+  }
+  /**
+   * Get a scene by key.
+   */
+  get(e) {
+    return this.scenes.get(e);
+  }
+  /**
+   * Remove a scene by key.
+   */
+  remove(e) {
+    this.scenes.delete(e), this._activeSceneKey === e && (this._activeSceneKey = null);
+  }
+  /**
+   * Get the currently active scene key.
+   */
+  get activeKey() {
+    return this._activeSceneKey;
+  }
+  /**
+   * Set the active scene key (for external use to track which scene is active).
+   */
+  set activeKey(e) {
+    this._activeSceneKey = e;
+  }
+  /**
+   * List all registered scene keys.
+   */
+  keys() {
+    return Array.from(this.scenes.keys());
+  }
+  /**
+   * Serialize scene metadata to JSON (children names/ids, background, etc.).
+   */
+  serialize(e) {
+    const t = this.scenes.get(e);
+    if (!t) return null;
+    let s = null;
+    return t.background instanceof B && (s = `#${t.background.getHexString()}`), {
+      name: t.name || e,
+      background: s,
+      environmentRotation: {
+        x: t.environmentRotation?.x ?? 0,
+        y: t.environmentRotation?.y ?? 0,
+        z: t.environmentRotation?.z ?? 0
+      },
+      children: t.children.map((n) => n.name || n.uuid)
+    };
+  }
+  /**
+   * Clear all scenes.
+   */
+  clear() {
+    this.scenes.clear(), this._activeSceneKey = null;
+  }
+  get size() {
+    return this.scenes.size;
+  }
+}
+class xn {
+  scene;
+  lights = /* @__PURE__ */ new Map();
+  helpers = /* @__PURE__ */ new Map();
+  constructor(e) {
+    this.scene = e;
+  }
+  addAmbient(e, t = {}) {
+    const { color: s = 16777215, intensity: n = 0.5 } = t, i = new st(s, n);
+    return i.name = e, this._register(e, i), i;
+  }
+  addDirectional(e, t = {}) {
+    const { color: s = 16777215, intensity: n = 1, position: i = { x: 5, y: 10, z: 5 }, castShadow: r = !1, shadowMapSize: o = 1024 } = t, a = new ue(s, n);
+    return a.position.set(i.x, i.y, i.z), a.castShadow = r, r && a.shadow.mapSize.setScalar(o), a.name = e, this._register(e, a), a;
+  }
+  addPoint(e, t = {}) {
+    const { color: s = 16777215, intensity: n = 1, distance: i = 0, decay: r = 2, position: o = { x: 0, y: 5, z: 0 }, castShadow: a = !1 } = t, c = new me(s, n, i, r);
+    return c.position.set(o.x, o.y, o.z), c.castShadow = a, c.name = e, this._register(e, c), c;
+  }
+  addSpot(e, t = {}) {
+    const {
+      color: s = 16777215,
+      intensity: n = 1,
+      distance: i = 0,
+      angle: r = Math.PI / 6,
+      penumbra: o = 0.1,
+      decay: a = 2,
+      position: c = { x: 0, y: 10, z: 0 },
+      target: h,
+      castShadow: d = !1
+    } = t, p = new ge(s, n, i, r, o, a);
+    return p.position.set(c.x, c.y, c.z), h && p.target.position.set(h.x, h.y, h.z), p.castShadow = d, p.name = e, this._register(e, p), p;
+  }
+  addHemisphere(e, t = {}) {
+    const { skyColor: s = 8900331, groundColor: n = 3549447, intensity: i = 0.6 } = t, r = new fe(s, n, i);
+    return r.name = e, this._register(e, r), r;
+  }
+  /**
+   * Apply a lighting preset to the scene.
+   */
+  applyPreset(e) {
+    switch (this.removeAll(), e) {
+      case "indoor":
+        this.addAmbient("preset_ambient", { intensity: 0.4 }), this.addPoint("preset_point1", { position: { x: 0, y: 3, z: 0 }, intensity: 1, castShadow: !0 }), this.addPoint("preset_point2", { position: { x: 3, y: 2, z: -3 }, intensity: 0.5 });
+        break;
+      case "outdoor":
+        this.addHemisphere("preset_hemi", { skyColor: 8900331, groundColor: 3549447, intensity: 0.6 }), this.addDirectional("preset_sun", { position: { x: 10, y: 20, z: 10 }, intensity: 1.5, castShadow: !0, shadowMapSize: 2048 });
+        break;
+      case "studio":
+        this.addAmbient("preset_ambient", { intensity: 0.3 }), this.addDirectional("preset_key", { position: { x: 5, y: 8, z: 5 }, intensity: 1.2, castShadow: !0 }), this.addDirectional("preset_fill", { position: { x: -5, y: 5, z: -2 }, intensity: 0.6 }), this.addDirectional("preset_back", { position: { x: 0, y: 5, z: -8 }, intensity: 0.4 });
+        break;
+      case "warehouse":
+        this.addAmbient("preset_ambient", { intensity: 0.2 }), this.addPoint("preset_light1", { position: { x: -5, y: 6, z: -5 }, intensity: 2, distance: 20 }), this.addPoint("preset_light2", { position: { x: 5, y: 6, z: -5 }, intensity: 2, distance: 20 }), this.addPoint("preset_light3", { position: { x: -5, y: 6, z: 5 }, intensity: 2, distance: 20 }), this.addPoint("preset_light4", { position: { x: 5, y: 6, z: 5 }, intensity: 2, distance: 20 });
+        break;
+    }
+  }
+  /**
+   * Get a light by id.
+   */
+  get(e) {
+    return this.lights.get(e);
+  }
+  /**
+   * Remove a light by id.
+   */
+  remove(e) {
+    const t = this.lights.get(e);
+    t && (this.scene.remove(t), this.lights.delete(e)), this.hideHelper(e);
+  }
+  /**
+   * Remove all lights managed by this manager.
+   */
+  removeAll() {
+    const e = Array.from(this.lights.keys());
+    for (const t of e)
+      this.remove(t);
+  }
+  /**
+   * Show a visual helper for a light.
+   */
+  showHelper(e) {
+    if (this.helpers.has(e)) return;
+    const t = this.lights.get(e);
+    if (!t) return;
+    let s = null;
+    t instanceof ue ? s = new nt(t, 1) : t instanceof me ? s = new it(t, 0.5) : t instanceof ge ? s = new rt(t) : t instanceof fe && (s = new ot(t, 1)), s && (this.scene.add(s), this.helpers.set(e, s));
+  }
+  /**
+   * Hide (remove) the helper for a light.
+   */
+  hideHelper(e) {
+    const t = this.helpers.get(e);
+    t && (this.scene.remove(t), this.helpers.delete(e));
+  }
+  /**
+   * Show helpers for all lights.
+   */
+  showAllHelpers() {
+    for (const [e] of this.lights)
+      this.showHelper(e);
+  }
+  /**
+   * Hide all helpers.
+   */
+  hideAllHelpers() {
+    const e = Array.from(this.helpers.keys());
+    for (const t of e)
+      this.hideHelper(t);
+  }
+  _register(e, t) {
+    this.lights.has(e) && this.remove(e), this.lights.set(e, t), this.scene.add(t);
+  }
+  dispose() {
+    this.removeAll(), this.hideAllHelpers();
+  }
+}
+class ws extends at {
   scene;
   camera;
   scenePass;
@@ -265,9 +717,9 @@ class es extends $e {
   #r;
   #t;
   #s = !1;
-  #a = { strength: 1, radius: 0, threshold: 0 };
+  #o = { strength: 1, radius: 0, threshold: 0 };
   #c = null;
-  #n = !1;
+  #i = !1;
   #e = {
     sliceCount: 1,
     stepCount: 12,
@@ -277,12 +729,12 @@ class es extends $e {
     thickness: 1
   };
   #h = null;
-  #o = !1;
+  #a = !1;
   #l = null;
   #d = null;
   constructor(...e) {
-    const [t, s, i] = e;
-    super(t), this.scene = s, this.camera = i, this.scenePass = re(s, i), this.needsUpdateOutputNode = !0, this.#r = /* @__PURE__ */ new Set(), this.#t = [], this.#p();
+    const [t, s, n] = e;
+    super(t), this.scene = s, this.camera = n, this.scenePass = de(s, n), this.needsUpdateOutputNode = !0, this.#r = /* @__PURE__ */ new Set(), this.#t = [], this.#p();
   }
   /** @deprecated Use `scenePass` instead */
   get currentOutputNode() {
@@ -295,7 +747,7 @@ class es extends $e {
     this.#r.delete(e), this.needsUpdateOutputNode = !0;
   }
   setCamera(e) {
-    this.camera = e, this.#i();
+    this.camera = e, this.#n();
   }
   /** @deprecated Use `setOutputComposer` instead */
   setCurrentOutputNode(e) {
@@ -309,19 +761,19 @@ class es extends $e {
     this.#d = e, this.needsUpdateOutputNode = !0;
   }
   enableBloom(e) {
-    e && Object.assign(this.#a, e), this.#s = !0, this.#i();
+    e && Object.assign(this.#o, e), this.#s = !0, this.#n();
   }
   disableBloom() {
-    this.#s = !1, this.#c = null, this.#i();
+    this.#s = !1, this.#c = null, this.#n();
   }
   updateBloom(e) {
-    Object.assign(this.#a, e), this.#s && (this.needsUpdateOutputNode = !0);
+    Object.assign(this.#o, e), this.#s && (this.needsUpdateOutputNode = !0);
   }
   enableSSGI(e) {
-    e && Object.assign(this.#e, e), this.#n = !0, this.#i();
+    e && Object.assign(this.#e, e), this.#i = !0, this.#n();
   }
   disableSSGI() {
-    this.#n = !1, this.#h = null, this.#i();
+    this.#i = !1, this.#h = null, this.#n();
   }
   updateSSGI(e) {
     if (Object.assign(this.#e, e), this.#h) {
@@ -330,19 +782,19 @@ class es extends $e {
     }
   }
   enableTRAA() {
-    this.#o = !0, this.#i();
+    this.#a = !0, this.#n();
   }
   disableTRAA() {
-    this.#o = !1, this.#l = null, this.#i();
+    this.#a = !1, this.#l = null, this.#n();
   }
-  #i() {
+  #n() {
     const e = this.scenePass;
-    this.scenePass = re(this.scene, this.camera), this.#p(), this.needsUpdateOutputNode = !0, e.dispose();
+    this.scenePass = de(this.scene, this.camera), this.#p(), this.needsUpdateOutputNode = !0, e.dispose();
   }
   #p() {
-    if (this.#s || this.#n || this.#o) {
-      const t = { output: Mt };
-      this.#s && (t.emissive = Ot), this.#n && (t.normal = Rt), this.#o && (t.velocity = It), this.scenePass.setMRT(Et(t));
+    if (this.#s || this.#i || this.#a) {
+      const t = { output: $t };
+      this.#s && (t.emissive = Kt), this.#i && (t.normal = Qt), this.#a && (t.velocity = qt), this.scenePass.setMRT(Gt(t));
     }
   }
   #u() {
@@ -352,33 +804,33 @@ class es extends $e {
   }
   #m() {
     let e = this.scenePass.getTextureNode();
-    if (this.#n)
-      if (!(this.camera instanceof K))
+    if (this.#i)
+      if (!(this.camera instanceof J))
         console.warn("RenderPipeline: SSGI requires a PerspectiveCamera, skipping.");
       else {
-        const t = this.scenePass.getTextureNode(), s = this.scenePass.getTextureNode("depth"), i = this.scenePass.getTextureNode("normal"), n = Bt(t, s, i, this.camera);
-        n.sliceCount.value = this.#e.sliceCount, n.stepCount.value = this.#e.stepCount, n.aoIntensity.value = this.#e.aoIntensity, n.giIntensity.value = this.#e.giIntensity, n.radius.value = this.#e.radius, n.thickness.value = this.#e.thickness, this.#h = n, e = de(e, n), this.#t.push(n);
+        const t = this.scenePass.getTextureNode(), s = this.scenePass.getTextureNode("depth"), n = this.scenePass.getTextureNode("normal"), i = Vt(t, s, n, this.camera);
+        i.sliceCount.value = this.#e.sliceCount, i.stepCount.value = this.#e.stepCount, i.aoIntensity.value = this.#e.aoIntensity, i.giIntensity.value = this.#e.giIntensity, i.radius.value = this.#e.radius, i.thickness.value = this.#e.thickness, this.#h = i, e = ve(e, i), this.#t.push(i);
       }
     if (this.#s) {
       const t = this.scenePass.getTextureNode("emissive");
-      this.#c = Nt(
+      this.#c = Jt(
         t,
-        this.#a.strength,
-        this.#a.radius,
-        this.#a.threshold
-      ), e = de(e, this.#c), this.#t.push(this.#c);
+        this.#o.strength,
+        this.#o.radius,
+        this.#o.threshold
+      ), e = ve(e, this.#c), this.#t.push(this.#c);
     }
     return e;
   }
   #g() {
     this.#u();
     let e;
-    if (this.#d ? e = this.#d(this.scenePass) : this.#s || this.#n ? e = this.#m() : e = this.scenePass, this.#o) {
+    if (this.#d ? e = this.#d(this.scenePass) : this.#s || this.#i ? e = this.#m() : e = this.scenePass, this.#a) {
       const t = this.scenePass.getTextureNode("depth"), s = this.scenePass.getTextureNode("velocity");
-      this.#l = _t(e, t, s, this.camera), this.#t.push(this.#l), e = this.#l;
+      this.#l = Zt(e, t, s, this.camera), this.#t.push(this.#l), e = this.#l;
     }
     this.#r.size > 0 && this.#r.forEach((t) => {
-      const s = Pt(e, t);
+      const s = Wt(e, t);
       this.#t.push(s), e = s;
     }), this.outputNode = e, this.needsUpdate = !0;
   }
@@ -389,19 +841,19 @@ class es extends $e {
     this.#u(), this.scenePass.dispose(), super.dispose();
   }
 }
-const ts = {
-  Vector2: R,
-  Vector3: oe,
-  Vector4: Qe,
-  Quaternion: Ke,
-  Matrix4: We,
+const bs = {
+  Vector2: S,
+  Vector3: w,
+  Vector4: ht,
+  Quaternion: ct,
+  Matrix4: Ie,
   Spherical: C,
-  Box3: xe,
-  Sphere: Se,
-  Raycaster: Te
+  Box3: q,
+  Sphere: ze,
+  Raycaster: Be
 };
-Ie.install({ THREE: ts });
-class ss extends Ie {
+Ue.install({ THREE: bs });
+class vs extends Ue {
   constructor(...e) {
     super(...e), this.minDistance = 0.2, this.smoothTime = 0.2, this.dollySpeed = 0.2;
   }
@@ -409,43 +861,83 @@ class ss extends Ie {
    * Set absolute angle for azimuth to avoid spinning
    */
   absoluteRotations() {
-    this.azimuthAngle = is(this.azimuthAngle, 0);
+    this.azimuthAngle = xs(this.azimuthAngle, 0);
   }
   async flyToBox(e, t = {}) {
     if (e.isEmpty())
       return console.warn("CameraControls.flyToBox: The provided Box3 is empty."), !1;
     this.absoluteRotations();
-    const { viewpoint: s = "frontTop", enableTransition: i = !0, padding: n = 0.1, cover: r = !1 } = t, o = [];
+    const { viewpoint: s = "frontTop", enableTransition: n = !0, padding: i = 0.1, cover: r = !1 } = t, o = [];
     if (s !== "current") {
-      const c = fe[s.toUpperCase()] ?? fe.FRONTTOP, h = c.theta, l = c.phi;
+      const a = Me[s.toUpperCase()] ?? Me.FRONTTOP, c = a.theta, h = a.phi;
       o.push(
-        this.fitToBox(e, i, {
-          paddingLeft: n,
-          paddingRight: n,
-          paddingTop: n,
-          paddingBottom: n,
+        this.fitToBox(e, n, {
+          paddingLeft: i,
+          paddingRight: i,
+          paddingTop: i,
+          paddingBottom: i,
           cover: r
         })
-      ), o.push(this.rotateTo(h, l, i));
+      ), o.push(this.rotateTo(c, h, n));
     } else {
-      const c = new Se();
-      e.getBoundingSphere(c), c.radius += n, o.push(this.fitToSphere(c, i));
+      const a = new ze();
+      e.getBoundingSphere(a), a.radius += i, o.push(this.fitToSphere(a, n));
     }
     return await Promise.all(o), !0;
   }
   async flyToObject(e, t = {}) {
-    const s = new xe().setFromObject(e);
+    const s = new q().setFromObject(e);
     return this.flyToBox(s, t);
   }
+  /**
+   * Fly camera to a specific position and look-at target.
+   */
+  async flyTo(e, t, s = {}) {
+    const { enableTransition: n = !0 } = s;
+    return this.absoluteRotations(), this.setLookAt(e.x, e.y, e.z, t.x, t.y, t.z, n);
+  }
+  /**
+   * Get the current camera viewpoint data (position, target, zoom).
+   */
+  getCameraViewpoint() {
+    const e = new w(), t = new w();
+    return this.getPosition(e), this.getTarget(t), {
+      position: { x: e.x, y: e.y, z: e.z },
+      target: { x: t.x, y: t.y, z: t.z },
+      zoom: this.camera.zoom
+    };
+  }
+  /**
+   * Lock camera controls (disable all user interaction).
+   */
+  lock() {
+    this.enabled = !1;
+  }
+  /**
+   * Unlock camera controls (re-enable user interaction).
+   */
+  unlock() {
+    this.enabled = !0;
+  }
+  /**
+   * Switch between 2D top-down and 3D perspective views.
+   */
+  async setViewMode(e, t = !0) {
+    if (e === "2d") {
+      const s = new w();
+      this.getTarget(s), await this.rotateTo(0, 0, t), this.minPolarAngle = 0, this.maxPolarAngle = 0;
+    } else
+      this.minPolarAngle = 0, this.maxPolarAngle = Math.PI, await this.rotateTo(0, Math.PI / 4, t);
+  }
   async setCameraViewpoint(e, t = !0) {
-    const { position: s, target: i, zoom: n = this.camera.zoom } = e;
+    const { position: s, target: n, zoom: i = this.camera.zoom } = e;
     return Promise.all([
-      this.zoomTo(n, t),
-      this.setLookAt(s.x, s.y, s.z, i.x, i.y, i.z, t)
+      this.zoomTo(i, t),
+      this.setLookAt(s.x, s.y, s.z, n.x, n.y, n.z, t)
     ]);
   }
 }
-const fe = {
+const Me = {
   LEFT: new C(0, Math.PI / 2, -Math.PI / 2),
   RIGHT: new C(0, Math.PI / 2, Math.PI / 2),
   FRONT: new C(0, Math.PI / 2, 0),
@@ -461,17 +953,17 @@ const fe = {
   LEFTBACKTOP: new C(0, Math.PI / 4, -Math.PI / 4 * 3),
   RIGHTBACKTOP: new C(0, Math.PI / 4, Math.PI / 4 * 3)
 };
-function is(a, e) {
-  const t = a - e;
-  return Xe.euclideanModulo(t + Math.PI, Math.PI * 2) - Math.PI;
+function xs(l, e) {
+  const t = l - e;
+  return lt.euclideanModulo(t + Math.PI, Math.PI * 2) - Math.PI;
 }
-class ns {
-  environment = new Dt();
+class Ss {
+  environment = new es();
   renderer;
   pmremGenerator;
   envMap = null;
   constructor(e) {
-    this.renderer = e, this.pmremGenerator = new qe(e);
+    this.renderer = e, this.pmremGenerator = new dt(e);
   }
   update() {
     this.envMap || (this.envMap = this.pmremGenerator.fromScene(this.environment).texture);
@@ -480,20 +972,20 @@ class ns {
     this.pmremGenerator.dispose(), this.envMap?.dispose();
   }
 }
-const $ = 128;
-class rs extends jt {
+const Y = 128;
+class Cs extends ts {
   viewer;
   overlayPass;
   constructor(e) {
     super(e.camera, e.el), this.viewer = e;
-    const t = new Q(-2, 2, 2, -2, 0, 4);
-    t.position.set(0, 0, 2), this.overlayPass = re(this, t), this.setLabels("x", "y", "z");
+    const t = new V(-2, 2, 2, -2, 0, 4);
+    t.position.set(0, 0, 2), this.overlayPass = de(this, t), this.setLabels("x", "y", "z");
   }
   _update = () => {
     this.quaternion.copy(this.viewer.camera.quaternion).invert();
     const e = this.location;
     let t, s;
-    e.left !== null ? t = e.left : t = this.viewer.el.offsetWidth - $ - e.right, e.top !== null ? s = e.top : s = this.viewer.el.offsetHeight - $ - e.bottom, this.overlayPass.setViewport(t, s, $, $);
+    e.left !== null ? t = e.left : t = this.viewer.el.offsetWidth - Y - e.right, e.top !== null ? s = e.top : s = this.viewer.el.offsetHeight - Y - e.bottom, this.overlayPass.setViewport(t, s, Y, Y);
   };
   enable() {
     return this.viewer.renderPipeline.addOverlayPass(this.overlayPass), this.viewer.addEventListener("beforeRender", this._update), this.viewer.render(), this;
@@ -502,8 +994,8 @@ class rs extends jt {
     return this.viewer.renderPipeline.removeOverlayPass(this.overlayPass), this.viewer.removeEventListener("beforeRender", this._update), this.viewer.render(), this;
   }
 }
-const Ae = "position:absolute;top:0;left:0;width:100%;height:100%;pointer-events:none;overflow:hidden;", as = Ae + "z-index:0;", os = Ae + "z-index:1;";
-class cs {
+const Ge = "position:absolute;top:0;left:0;width:100%;height:100%;pointer-events:none;overflow:hidden;", _s = Ge + "z-index:0;", Ms = Ge + "z-index:1;";
+class Ts {
   el;
   css2dRenderer = null;
   css3dRenderer = null;
@@ -511,21 +1003,21 @@ class cs {
     this.el = e, getComputedStyle(e).position === "static" && (e.style.position = "relative");
   }
   initCSS2DRenderer() {
-    const e = new Ut();
-    return e.setSize(this.el.clientWidth, this.el.clientHeight), e.domElement.style.cssText = os, this.el.appendChild(e.domElement), this.css2dRenderer = e, e;
+    const e = new ss();
+    return e.setSize(this.el.clientWidth, this.el.clientHeight), e.domElement.style.cssText = Ms, this.el.appendChild(e.domElement), this.css2dRenderer = e, e;
   }
   initCSS3DRenderer() {
-    const e = new Gt();
-    return e.setSize(this.el.clientWidth, this.el.clientHeight), e.domElement.style.cssText = as, this.el.appendChild(e.domElement), this.css3dRenderer = e, e;
+    const e = new is();
+    return e.setSize(this.el.clientWidth, this.el.clientHeight), e.domElement.style.cssText = _s, this.el.appendChild(e.domElement), this.css3dRenderer = e, e;
   }
   createCSS2DObject(e) {
-    return this.css2dRenderer || this.initCSS2DRenderer(), new kt(e);
+    return this.css2dRenderer || this.initCSS2DRenderer(), new ns(e);
   }
   createCSS25DObject(e) {
-    return this.css3dRenderer || this.initCSS3DRenderer(), new Ft(e);
+    return this.css3dRenderer || this.initCSS3DRenderer(), new rs(e);
   }
   createCSS3DObject(e) {
-    return this.css3dRenderer || this.initCSS3DRenderer(), new zt(e);
+    return this.css3dRenderer || this.initCSS3DRenderer(), new os(e);
   }
   render(e, t) {
     this.css2dRenderer && this.css2dRenderer.render(e, t), this.css3dRenderer && this.css3dRenderer.render(e, t);
@@ -537,7 +1029,7 @@ class cs {
     this.css2dRenderer && (this.el.removeChild(this.css2dRenderer.domElement), this.css2dRenderer = null), this.css3dRenderer && (this.el.removeChild(this.css3dRenderer.domElement), this.css3dRenderer = null);
   }
 }
-class hs {
+class Ps {
   el;
   renderer;
   container;
@@ -552,19 +1044,19 @@ class hs {
     this.el = e, this.renderer = t;
     const s = document.createElement("div");
     s.style.position = "absolute", s.style.left = "12px", s.style.bottom = "12px", s.style.fontSize = "12px", s.style.color = "#fff", s.style.pointerEvents = "none", this.container = s;
-    function i(r, o = !0) {
-      const c = document.createElement("span");
-      return o && (c.style.marginLeft = "6px"), c.innerText = r, c;
+    function n(r, o = !0) {
+      const a = document.createElement("span");
+      return o && (a.style.marginLeft = "6px"), a.innerText = r, a;
     }
-    function n() {
+    function i() {
       return document.createElement("br");
     }
-    this.drawCallsText = i("0"), this.frameCallsText = i("0"), this.trianglesText = i("0"), this.linesText = i("0"), this.pointsText = i("0"), this.timestampText = i("0"), this.container.appendChild(i("draw calls", !1)), this.container.appendChild(this.drawCallsText), this.container.appendChild(n()), this.container.appendChild(i("frame calls", !1)), this.container.appendChild(this.frameCallsText), this.container.appendChild(n()), this.container.appendChild(i("triangles", !1)), this.container.appendChild(this.trianglesText), this.container.appendChild(n()), this.container.appendChild(i("points", !1)), this.container.appendChild(this.pointsText), this.container.appendChild(n()), this.container.appendChild(i("lines", !1)), this.container.appendChild(this.linesText), this.container.appendChild(n()), this.container.appendChild(i("timestamp", !1)), this.container.appendChild(this.timestampText), this.container.appendChild(n());
+    this.drawCallsText = n("0"), this.frameCallsText = n("0"), this.trianglesText = n("0"), this.linesText = n("0"), this.pointsText = n("0"), this.timestampText = n("0"), this.container.appendChild(n("draw calls", !1)), this.container.appendChild(this.drawCallsText), this.container.appendChild(i()), this.container.appendChild(n("frame calls", !1)), this.container.appendChild(this.frameCallsText), this.container.appendChild(i()), this.container.appendChild(n("triangles", !1)), this.container.appendChild(this.trianglesText), this.container.appendChild(i()), this.container.appendChild(n("points", !1)), this.container.appendChild(this.pointsText), this.container.appendChild(i()), this.container.appendChild(n("lines", !1)), this.container.appendChild(this.linesText), this.container.appendChild(i()), this.container.appendChild(n("timestamp", !1)), this.container.appendChild(this.timestampText), this.container.appendChild(i());
   }
   update() {
     if (this._enabled) {
       const { render: e } = this.renderer.info;
-      this.drawCallsText.innerText = e.drawCalls.toString(), this.frameCallsText.innerText = e.frameCalls.toString(), this.trianglesText.innerText = e.triangles.toString(), this.pointsText.innerText = e.points.toString(), this.linesText.innerText = e.lines.toString(), this.renderer.resolveTimestampsAsync(Ye.RENDER).then((t) => {
+      this.drawCallsText.innerText = e.drawCalls.toString(), this.frameCallsText.innerText = e.frameCalls.toString(), this.trianglesText.innerText = e.triangles.toString(), this.pointsText.innerText = e.points.toString(), this.linesText.innerText = e.lines.toString(), this.renderer.resolveTimestampsAsync(pt.RENDER).then((t) => {
         this.timestampText.innerText = t?.toFixed(2) ?? "0";
       });
     }
@@ -579,8 +1071,8 @@ class hs {
     this.disable();
   }
 }
-Je.enabled = !0;
-class ei extends Ze {
+ut.enabled = !0;
+class Sn extends Le {
   el;
   renderer;
   scene;
@@ -597,11 +1089,11 @@ class ei extends Ze {
   frameCount = 1;
   frameloop = "demand";
   constructor({ el: e, rendererOptions: t }) {
-    super(), this.el = e, this.renderer = this._initRenderer(t), this.scene = this.createScene(), this.camera = this.createPerspectiveCamera(), this.info = new hs(this.el, this.renderer), this.controls = new ss(this.camera, this.renderer.domElement), this.renderPipeline = new es(this.renderer, this.scene, this.camera), this.timer = new Ve(), this.roomEnvironment = new ns(this.renderer), this.interactionManager = new Zt(this.renderer.domElement, this.scene, this.camera), this.objectManager = new Vt(), this.viewerHelper = new rs(this), this.cssRenderer = new cs(this.el), window.addEventListener("resize", this.onWindowResize);
+    super(), this.el = e, this.renderer = this._initRenderer(t), this.scene = this.createScene(), this.camera = this.createPerspectiveCamera(), this.info = new Ps(this.el, this.renderer), this.controls = new vs(this.camera, this.renderer.domElement), this.renderPipeline = new ws(this.renderer, this.scene, this.camera), this.timer = new mt(), this.roomEnvironment = new Ss(this.renderer), this.interactionManager = new fs(this.renderer.domElement, this.scene, this.camera), this.objectManager = new ys(), this.viewerHelper = new Cs(this), this.cssRenderer = new Ts(this.el), window.addEventListener("resize", this.onWindowResize);
   }
   onWindowResize = () => {
     const e = this.el.clientWidth, t = this.el.clientHeight;
-    this.camera instanceof K ? (this.camera.aspect = e / t, this.camera.updateProjectionMatrix()) : this.camera instanceof Q && (this.camera.left = -e / 2, this.camera.right = e / 2, this.camera.top = t / 2, this.camera.bottom = -t / 2, this.camera.updateProjectionMatrix()), this.renderer.setSize(e, t), this.cssRenderer.resize(e, t), this.render();
+    this.camera instanceof J ? (this.camera.aspect = e / t, this.camera.updateProjectionMatrix()) : this.camera instanceof V && (this.camera.left = -e / 2, this.camera.right = e / 2, this.camera.top = t / 2, this.camera.bottom = -t / 2, this.camera.updateProjectionMatrix()), this.renderer.setSize(e, t), this.cssRenderer.resize(e, t), this.render();
   };
   async init() {
     await this.renderer.init(), this.roomEnvironment.update(), this.scene.environment = this.roomEnvironment.envMap;
@@ -610,7 +1102,7 @@ class ei extends Ze {
     this.camera = e, this.controls.camera = e, this.interactionManager.setCamera(e), this.renderPipeline.setCamera(e), this.onWindowResize(), this.dispatchEvent({ type: "cameraChange", camera: e });
   }
   setCameraByType(e) {
-    e === "perspective" && !(this.camera instanceof K) ? this.setCamera(this.createPerspectiveCamera()) : e === "orthographic" && !(this.camera instanceof Q) && this.setCamera(this.createOrthographicCamera());
+    e === "perspective" && !(this.camera instanceof J) ? this.setCamera(this.createPerspectiveCamera()) : e === "orthographic" && !(this.camera instanceof V) && this.setCamera(this.createOrthographicCamera());
   }
   render(e = 1) {
     return this.frameCount += e, new Promise((t) => {
@@ -628,25 +1120,25 @@ class ei extends Ze {
     this.dispatchEvent({ type: "afterControlsUpdate", time: e, delta: t }), this.frameCount > 0 && (this.frameCount--, s = !0), this.frameloop === "always" && (s = !0), s && (this.dispatchEvent({ type: "beforeRender", time: e, delta: t }), this.renderer.info.reset(), this.renderPipeline.render(), this.cssRenderer.render(this.scene, this.camera), this.info.update(), this.dispatchEvent({ type: "afterRender", time: e, delta: t }));
   };
   _initRenderer(e) {
-    const t = new et({
+    const t = new gt({
       logarithmicDepthBuffer: !0,
       antialias: !1,
       depth: !1,
       trackTimestamp: !0,
       ...e
     });
-    return t.setSize(this.el.clientWidth, this.el.clientHeight), t.shadowMap.enabled = !0, t.shadowMap.type = tt, t.toneMapping = st, t.toneMappingExposure = 1, t.info.autoReset = !1, t.setPixelRatio(window.devicePixelRatio), t.setAnimationLoop(this.animate), this.el.appendChild(t.domElement), t;
+    return t.setSize(this.el.clientWidth, this.el.clientHeight), t.shadowMap.enabled = !0, t.shadowMap.type = ft, t.toneMapping = yt, t.toneMappingExposure = 1, t.info.autoReset = !1, t.setPixelRatio(window.devicePixelRatio), t.setAnimationLoop(this.animate), this.el.appendChild(t.domElement), t;
   }
   createScene() {
-    const e = new it();
-    return e.background = new V(0), e;
+    const e = new Re();
+    return e.background = new B(0), e;
   }
   createPerspectiveCamera() {
-    const e = new K(50, this.el.clientWidth / this.el.clientHeight, 0.1, 1e5);
+    const e = new J(50, this.el.clientWidth / this.el.clientHeight, 0.1, 1e5);
     return e.position.setScalar(5), e;
   }
   createOrthographicCamera() {
-    const e = new Q(
+    const e = new V(
       -this.el.clientWidth / 2,
       this.el.clientWidth / 2,
       this.el.clientHeight / 2,
@@ -656,251 +1148,310 @@ class ei extends Ze {
     );
     return e.position.setScalar(5), e;
   }
+  /**
+   * Manually trigger a resize update.
+   */
+  resize(e, t) {
+    e !== void 0 && t !== void 0 && (this.el.style.width = `${e}px`, this.el.style.height = `${t}px`), this.onWindowResize();
+  }
+  /**
+   * Capture a screenshot of the current render.
+   */
+  async screenshot(e = {}) {
+    const { type: t = "image/png", quality: s = 1 } = e, n = this.el.clientWidth, i = this.el.clientHeight, r = e.width && e.height;
+    r && this.renderer.setSize(e.width, e.height), await this.render();
+    const o = this.renderer.domElement.toDataURL(t, s);
+    return r && (this.renderer.setSize(n, i), this.onWindowResize()), o;
+  }
+  /**
+   * Set the scene background color, texture, or null.
+   */
+  setBackground(e) {
+    e === null ? this.scene.background = null : e instanceof B || typeof e == "number" || typeof e == "string" ? this.scene.background = new B(e) : this.scene.background = e, this.render();
+  }
+  /**
+   * Set the scene environment map for reflections / IBL.
+   */
+  setEnvironment(e) {
+    this.scene.environment = e, this.render();
+  }
+  /**
+   * Enable shadow rendering.
+   */
+  enableShadow() {
+    this.renderer.shadowMap.enabled = !0, this.render();
+  }
+  /**
+   * Disable shadow rendering.
+   */
+  disableShadow() {
+    this.renderer.shadowMap.enabled = !1, this.render();
+  }
+  /**
+   * Enable linear fog.
+   */
+  enableFog(e = {}) {
+    const { color: t = 13421772, near: s = 10, far: n = 100 } = e;
+    this.scene.fog = new wt(t, s, n), this.render();
+  }
+  /**
+   * Enable exponential fog.
+   */
+  enableFogExp2(e = {}) {
+    const { color: t = 13421772, density: s = 0.01 } = e;
+    this.scene.fog = new bt(t, s), this.render();
+  }
+  /**
+   * Disable fog.
+   */
+  disableFog() {
+    this.scene.fog = null, this.render();
+  }
   dispose() {
     this.el.removeChild(this.renderer.domElement), window.removeEventListener("resize", this.onWindowResize), this.info.dispose(), this.interactionManager.dispose(), this.roomEnvironment.dispose(), this.cssRenderer.dispose(), this.renderPipeline.dispose(), this.renderer.dispose();
   }
 }
-class ls extends Le {
+class Es extends Fe {
   constructor(e) {
     super(e);
   }
-  parse(e, t, s, i) {
-    if (ds(e.slice(0, 8)) === "SBMG----") {
-      const r = ps(e.slice(8));
-      return super.parse(r, t, s, i);
+  parse(e, t, s, n) {
+    if (Os(e.slice(0, 8)) === "SBMG----") {
+      const r = As(e.slice(8));
+      return super.parse(r, t, s, n);
     } else
-      return super.parse(e, t, s, i);
+      return super.parse(e, t, s, n);
   }
 }
-function ds(a) {
-  return new TextDecoder().decode(new Uint8Array(a));
+function Os(l) {
+  return new TextDecoder().decode(new Uint8Array(l));
 }
-function ps(a) {
-  const e = new DataView(a);
+function As(l) {
+  const e = new DataView(l);
   for (let t = 0; t < e.byteLength; t++) {
-    const s = e.getUint8(t), i = (s >> 4 & 15) + (s << 4 & 240);
-    e.setUint8(t, i);
+    const s = e.getUint8(t), n = (s >> 4 & 15) + (s << 4 & 240);
+    e.setUint8(t, n);
   }
   return e.buffer;
 }
-const us = 8, ms = 130, ye = 66, gs = "SBK-----", fs = "SBM-----", Ne = new TextDecoder(), ys = new TextEncoder();
-function ws(a) {
-  let e = us;
-  const t = new Uint8Array(a, 0, e);
-  if (Ne.decode(t) !== gs)
-    return a;
-  e += ms;
-  const i = new Uint8Array(a, 0, e);
-  if (i[40] === 1) {
-    const r = ys.encode(fs), o = new Uint8Array([i[41]]), c = vs(i), h = bs(c);
-    let l = ye % h.length;
-    const d = e + ye, g = new Uint8Array(a, d), p = new Uint8Array(g.length);
-    for (let v = 0; v < g.length; v++)
-      p[v] = g[v] ^ h[l], l = (l + 1) % h.length;
-    const y = new Uint8Array(r.length + o.length + p.length);
-    return y.set(r), y.set(o, r.length), y.set(p, r.length + o.length), y.buffer;
+const Bs = 8, Ls = 130, Te = 66, Is = "SBK-----", Rs = "SBM-----", $e = new TextDecoder(), zs = new TextEncoder();
+function Ns(l) {
+  let e = Bs;
+  const t = new Uint8Array(l, 0, e);
+  if ($e.decode(t) !== Is)
+    return l;
+  e += Ls;
+  const n = new Uint8Array(l, 0, e);
+  if (n[40] === 1) {
+    const r = zs.encode(Rs), o = new Uint8Array([n[41]]), a = js(n), c = Ds(a);
+    let h = Te % c.length;
+    const d = e + Te, p = new Uint8Array(l, d), u = new Uint8Array(p.length);
+    for (let b = 0; b < p.length; b++)
+      u[b] = p[b] ^ c[h], h = (h + 1) % c.length;
+    const g = new Uint8Array(r.length + o.length + u.length);
+    return g.set(r), g.set(o, r.length), g.set(u, r.length + o.length), g.buffer;
   }
 }
-function vs(a) {
+function js(l) {
   const e = new Uint8Array(128);
-  return e.set(a.slice(42, 74), 0), e.set(a.slice(74, 138), 32), e.set(a.slice(8, 40), 96), e;
+  return e.set(l.slice(42, 74), 0), e.set(l.slice(74, 138), 32), e.set(l.slice(8, 40), 96), e;
 }
-function bs(a) {
+function Ds(l) {
   const e = new Uint8Array(64);
-  return e.set(a.slice(0, 8), 0), e.set(a.slice(24, 32), 8), e.set(a.slice(40, 56), 16), e.set(a.slice(64, 88), 32), e.set(a.slice(96, 104), 56), e;
+  return e.set(l.slice(0, 8), 0), e.set(l.slice(24, 32), 8), e.set(l.slice(40, 56), 16), e.set(l.slice(64, 88), 32), e.set(l.slice(96, 104), 56), e;
 }
-const Cs = (a, e, t) => {
-  const s = a.buffer.slice(t, t + e);
-  let i = Ne.decode(s);
-  return i = i.replace("\\", "/"), i.startsWith("Maps/") || (i = `Maps/${i}`), i;
-}, Ts = (a, e, t) => {
-  const [s, i, n, r, o] = e, c = t || r < 1;
-  return new L({
-    name: a,
-    color: new V(s, i, n),
+const ks = (l, e, t) => {
+  const s = l.buffer.slice(t, t + e);
+  let n = $e.decode(s);
+  return n = n.replace("\\", "/"), n.startsWith("Maps/") || (n = `Maps/${n}`), n;
+}, Hs = (l, e, t) => {
+  const [s, n, i, r, o] = e, a = t || r < 1;
+  return new R({
+    name: l,
+    color: new B(s, n, i),
     opacity: r,
-    transparent: c,
+    transparent: a,
     alphaTest: 0.01,
     side: o
   });
-}, Ss = (a) => a?.toLowerCase().endsWith(".png") ?? !1;
-class xs {
+}, Us = (l) => l?.toLowerCase().endsWith(".png") ?? !1;
+class Fs {
   data;
   options;
   textureLoader;
   littleEndian = !0;
   materials = /* @__PURE__ */ new Map();
   constructor(e, t) {
-    this.data = e, this.options = t, this.textureLoader = new Me(t.manager), this.textureLoader.setCrossOrigin(t.crossOrigin), this.textureLoader.setRequestHeader(t.requestHeader);
+    this.data = e, this.options = t, this.textureLoader = new je(t.manager), this.textureLoader.setCrossOrigin(t.crossOrigin), this.textureLoader.setRequestHeader(t.requestHeader);
   }
   parse(e, t) {
     let s = this.data;
-    const i = ws(this.data);
-    i && (s = i);
-    const n = new DataView(s);
+    const n = Ns(this.data);
+    n && (s = n);
+    const i = new DataView(s);
     let r = 8;
-    const o = n.getUint8(r);
-    r += 1, o === 1 ? this._parseV2(n, r, e) : o === 2 ? this._parseV2(n, r, e) : o === 3 ? this._parseV3(n, r, e) : t?.(new Error(`SBMLoader: Unsupported SBM version: ${o}`));
+    const o = i.getUint8(r);
+    r += 1, o === 1 ? this._parseV2(i, r, e) : o === 2 ? this._parseV2(i, r, e) : o === 3 ? this._parseV3(i, r, e) : t?.(new Error(`SBMLoader: Unsupported SBM version: ${o}`));
   }
   _parseV2(e, t, s) {
-    const i = new ee(), n = e.getUint16(t, this.littleEndian);
+    const n = new I(), i = e.getUint16(t, this.littleEndian);
     t += 2;
     const r = e.getUint16(t, this.littleEndian);
     t += 2;
-    for (let o = 0; o < n; ++o) {
-      const c = e.getUint16(t, this.littleEndian).toString();
+    for (let o = 0; o < i; ++o) {
+      const a = e.getUint16(t, this.littleEndian).toString();
       t += 2, t += 4, t += 4, t += 4, t += 4;
-      const h = e.getFloat32(t, this.littleEndian);
+      const c = e.getFloat32(t, this.littleEndian);
       t += 4;
-      const l = e.getFloat32(t, this.littleEndian);
+      const h = e.getFloat32(t, this.littleEndian);
       t += 4;
       const d = e.getFloat32(t, this.littleEndian);
       t += 4;
-      const g = e.getFloat32(t, this.littleEndian);
+      const p = e.getFloat32(t, this.littleEndian);
       t += 4, t += 4, t += 4, t += 4, t += 4;
-      let p = e.getUint8(t);
-      t += 1, p === 0 ? p = at : p === 1 ? p = ot : p === 2 && (p = ct);
-      const y = e.getUint16(t, this.littleEndian);
+      let u = e.getUint8(t);
+      t += 1, u === 0 ? u = xt : u === 1 ? u = St : u === 2 && (u = Ct);
+      const g = e.getUint16(t, this.littleEndian);
       t += 2;
-      const v = y > 0 ? Cs(e, y, t) : "";
-      if (t += y, !this.materials.has(c)) {
-        const b = Ts(c, [h, l, d, g, p], Ss(v));
-        this.materials.set(c, b), v && this.options.path && this.textureLoader.load(I.resolveURL(v, this.options.path), (f) => {
-          f.colorSpace = Pe, f.wrapS = ce, f.wrapT = ce, f.flipY = !1, f.anisotropy = 16, b.map = f;
+      const b = g > 0 ? ks(e, g, t) : "";
+      if (t += g, !this.materials.has(a)) {
+        const x = Hs(a, [c, h, d, p, u], Us(b));
+        this.materials.set(a, x), b && this.options.path && this.textureLoader.load(L.resolveURL(b, this.options.path), (y) => {
+          y.colorSpace = De, y.wrapS = ye, y.wrapT = ye, y.flipY = !1, y.anisotropy = 16, x.map = y;
         });
       }
     }
     for (let o = 0; o < r; ++o) {
-      const c = e.getUint16(t, this.littleEndian).toString();
+      const a = e.getUint16(t, this.littleEndian).toString();
       t += 2;
-      const h = e.getUint16(t, this.littleEndian).toString();
+      const c = e.getUint16(t, this.littleEndian).toString();
       t += 2;
-      const l = [], d = [], g = [], p = [], y = e.getUint16(t, this.littleEndian);
-      if (t += 2, y > 0)
-        for (let m = 0; m < y; m++) {
-          const w = new oe();
-          w.setX(e.getFloat32(t, this.littleEndian)), t += 4, w.setY(e.getFloat32(t, this.littleEndian)), t += 4, w.setZ(e.getFloat32(t, this.littleEndian)), t += 4, l.push(w);
-        }
-      const v = e.getUint16(t, this.littleEndian);
-      if (t += 2, v > 0)
-        for (let m = 0; m < v; m++)
-          t += 4, t += 4, t += 4;
-      const S = e.getUint16(t, this.littleEndian);
-      if (t += 2, S > 0)
-        for (let m = 0; m < S; m++) {
-          const w = new R();
-          w.setX(e.getFloat32(t, this.littleEndian)), t += 4, w.setY(e.getFloat32(t, this.littleEndian)), t += 4, d.push(w);
+      const h = [], d = [], p = [], u = [], g = e.getUint16(t, this.littleEndian);
+      if (t += 2, g > 0)
+        for (let f = 0; f < g; f++) {
+          const v = new w();
+          v.setX(e.getFloat32(t, this.littleEndian)), t += 4, v.setY(e.getFloat32(t, this.littleEndian)), t += 4, v.setZ(e.getFloat32(t, this.littleEndian)), t += 4, h.push(v);
         }
       const b = e.getUint16(t, this.littleEndian);
       if (t += 2, b > 0)
-        for (let m = 0; m < b; m++) {
-          const w = e.getUint16(t, this.littleEndian);
+        for (let f = 0; f < b; f++)
+          t += 4, t += 4, t += 4;
+      const _ = e.getUint16(t, this.littleEndian);
+      if (t += 2, _ > 0)
+        for (let f = 0; f < _; f++) {
+          const v = new S();
+          v.setX(e.getFloat32(t, this.littleEndian)), t += 4, v.setY(e.getFloat32(t, this.littleEndian)), t += 4, d.push(v);
+        }
+      const x = e.getUint16(t, this.littleEndian);
+      if (t += 2, x > 0)
+        for (let f = 0; f < x; f++) {
+          const v = e.getUint16(t, this.littleEndian);
           t += 2;
-          const A = e.getUint16(t, this.littleEndian);
+          const z = e.getUint16(t, this.littleEndian);
           t += 2;
           const N = e.getUint16(t, this.littleEndian);
           t += 2;
-          const E = [w, A, N];
-          g.push(E), d.length > 0 && p.push([d[E[0]], d[E[1]], d[E[2]]]);
+          const P = [v, z, N];
+          p.push(P), d.length > 0 && u.push([d[P[0]], d[P[1]], d[P[2]]]);
         }
-      const f = [], T = [];
-      for (let m = 0; m < g.length; m++) {
-        const w = g[m], A = l[w[0]], N = l[w[1]], E = l[w[2]];
-        f.push(...A.toArray(), ...N.toArray(), ...E.toArray());
-        let H = new R(), G = new R(), _ = new R();
-        const D = p[m];
-        D !== void 0 && (H = D[0], G = D[1], _ = D[2]), T.push(...H.toArray(), ...G.toArray(), ..._.toArray());
+      const y = [], M = [];
+      for (let f = 0; f < p.length; f++) {
+        const v = p[f], z = h[v[0]], N = h[v[1]], P = h[v[2]];
+        y.push(...z.toArray(), ...N.toArray(), ...P.toArray());
+        let X = new S(), W = new S(), D = new S();
+        const k = u[f];
+        k !== void 0 && (X = k[0], W = k[1], D = k[2]), M.push(...X.toArray(), ...W.toArray(), ...D.toArray());
       }
-      const M = new Float32Array(f), P = new Float32Array(T), x = new rt();
-      if (M.length > 0 && x.setAttribute("position", new he(M, 3)), P.length > 0 && x.setAttribute("uv", new he(P, 2)), x.computeVertexNormals(), this.materials.has(h)) {
-        const m = new z(x, this.materials.get(h));
-        m.name = c, m.castShadow = !0, m.receiveShadow = !0, i.add(m);
+      const E = new Float32Array(y), O = new Float32Array(M), T = new K();
+      if (E.length > 0 && T.setAttribute("position", new we(E, 3)), O.length > 0 && T.setAttribute("uv", new we(O, 2)), T.computeVertexNormals(), this.materials.has(c)) {
+        const f = new G(T, this.materials.get(c));
+        f.name = a, f.castShadow = !0, f.receiveShadow = !0, n.add(f);
       }
     }
-    s(i);
+    s(n);
   }
   _parseV3(e, t, s) {
-    const i = new ee();
-    console.warn("SBMLoader: SBM version 3 is not supported yet."), s(i);
+    const n = new I();
+    console.warn("SBMLoader: SBM version 3 is not supported yet."), s(n);
   }
 }
-class Es extends nt {
-  load(e, t, s, i) {
-    let n;
+class Gs extends vt {
+  load(e, t, s, n) {
+    let i;
     if (this.resourcePath !== "")
-      n = this.resourcePath;
+      i = this.resourcePath;
     else if (this.path !== "") {
-      const c = I.extractUrlBase(e);
-      n = I.resolveURL(c, this.path);
+      const a = L.extractUrlBase(e);
+      i = L.resolveURL(a, this.path);
     } else
-      n = I.extractUrlBase(e);
+      i = L.extractUrlBase(e);
     this.manager.itemStart(e);
-    const r = (c) => {
-      i ? i(c) : console.error(c), this.manager.itemError(e), this.manager.itemEnd(e);
-    }, o = new Ee(this.manager);
+    const r = (a) => {
+      n ? n(a) : console.error(a), this.manager.itemError(e), this.manager.itemEnd(e);
+    }, o = new Ne(this.manager);
     o.setPath(this.path), o.setResponseType("arraybuffer"), o.setRequestHeader(this.requestHeader), o.setWithCredentials(this.withCredentials), o.load(
       e,
-      (c) => {
+      (a) => {
         try {
           this.parse(
-            c,
-            n,
-            (h) => {
-              t(h), this.manager.itemEnd(e);
+            a,
+            i,
+            (c) => {
+              t(c), this.manager.itemEnd(e);
             },
             r
           );
-        } catch (h) {
-          r(h);
+        } catch (c) {
+          r(c);
         }
       },
       s,
       r
     );
   }
-  parse(e, t, s, i) {
-    const n = new TextDecoder().decode(e.slice(0, 8));
-    if (n !== "SBK-----" && n !== "SBM-----") {
-      i?.(new Error(`SBMLoader: Invalid SBM format: ${n}`));
+  parse(e, t, s, n) {
+    const i = new TextDecoder().decode(e.slice(0, 8));
+    if (i !== "SBK-----" && i !== "SBM-----") {
+      n?.(new Error(`SBMLoader: Invalid SBM format: ${i}`));
       return;
     }
-    new xs(e, {
+    new Fs(e, {
       path: t,
       crossOrigin: this.crossOrigin,
       requestHeader: this.requestHeader,
       manager: this.manager
-    }).parse(s, i);
+    }).parse(s, n);
   }
   parseAsync(e, t) {
-    return new Promise((s, i) => {
+    return new Promise((s, n) => {
       this.parse(
         e,
         t,
-        (n) => {
-          s(n);
+        (i) => {
+          s(i);
         },
-        (n) => {
-          i(n);
+        (i) => {
+          n(i);
         }
       );
     });
   }
 }
-class B {
+class j {
   static CACHE_NAME = "u-space-model-loader-cache";
-  static fileLoader = new Ee().setResponseType("arraybuffer");
-  static dracoLoader = new Kt().setDecoderPath(
-    `https://cdn.jsdelivr.net/npm/three@0.${le}.0/examples/jsm/libs/draco/`
+  static fileLoader = new Ne().setResponseType("arraybuffer");
+  static dracoLoader = new ls().setDecoderPath(
+    `https://cdn.jsdelivr.net/npm/three@0.${be}.0/examples/jsm/libs/draco/`
   );
-  static ktx2Loader = new Qt().setTranscoderPath(
-    `https://cdn.jsdelivr.net/npm/three@0.${le}.0/examples/jsm/libs/basis/`
+  static ktx2Loader = new ds().setTranscoderPath(
+    `https://cdn.jsdelivr.net/npm/three@0.${be}.0/examples/jsm/libs/basis/`
   );
-  static gltfLoader = new Le().setDRACOLoader(B.dracoLoader).setKTX2Loader(B.ktx2Loader).setMeshoptDecoder(ge);
-  static sbmxLoader = new ls().setDRACOLoader(B.dracoLoader).setKTX2Loader(B.ktx2Loader).setMeshoptDecoder(ge);
-  static sbmLoader = new Es();
-  static fbxLoader = new Ht();
-  static objLoader = new $t();
-  static stlLoader = new Wt();
+  static gltfLoader = new Fe().setDRACOLoader(j.dracoLoader).setKTX2Loader(j.ktx2Loader).setMeshoptDecoder(_e);
+  static sbmxLoader = new Es().setDRACOLoader(j.dracoLoader).setKTX2Loader(j.ktx2Loader).setMeshoptDecoder(_e);
+  static sbmLoader = new Gs();
+  static fbxLoader = new as();
+  static objLoader = new cs();
+  static stlLoader = new hs();
   static setLoadingManager(e) {
     this.fileLoader.manager = e, this.dracoLoader.manager = e, this.ktx2Loader.manager = e, this.gltfLoader.manager = e, this.sbmxLoader.manager = e, this.sbmLoader.manager = e, this.fbxLoader.manager = e, this.objLoader.manager = e, this.stlLoader.manager = e;
   }
@@ -924,25 +1475,25 @@ class B {
   }
   static async loadAsync(e, t = { persistent: !0 }) {
     const s = e.split(".").pop()?.split("?")[0].toLowerCase();
-    let i;
-    switch (t.persistent && typeof caches < "u" ? i = await this.getPersistentData(e) : i = await this.fileLoader.loadAsync(e), s) {
+    let n;
+    switch (t.persistent && typeof caches < "u" ? n = await this.getPersistentData(e) : n = await this.fileLoader.loadAsync(e), s) {
       case "gltf":
       case "glb":
-        const n = await this.gltfLoader.parseAsync(i, I.extractUrlBase(e));
-        return n.scene.animations = n.animations, n.scene;
+        const i = await this.gltfLoader.parseAsync(n, L.extractUrlBase(e));
+        return i.scene.animations = i.animations, i.scene;
       case "sbmx":
-        const r = await this.sbmxLoader.parseAsync(i, I.extractUrlBase(e));
+        const r = await this.sbmxLoader.parseAsync(n, L.extractUrlBase(e));
         return r.scene.animations = r.animations, r.scene;
       case "sbm":
-        return await this.sbmLoader.parseAsync(i, I.extractUrlBase(e));
+        return await this.sbmLoader.parseAsync(n, L.extractUrlBase(e));
       case "fbx":
-        return this.fbxLoader.parse(i, I.extractUrlBase(e));
+        return this.fbxLoader.parse(n, L.extractUrlBase(e));
       case "obj":
-        const h = new TextDecoder().decode(i);
-        return this.objLoader.parse(h);
+        const c = new TextDecoder().decode(n);
+        return this.objLoader.parse(c);
       case "stl":
-        const d = this.stlLoader.parse(i);
-        return new z(d, new L());
+        const d = this.stlLoader.parse(n);
+        return new G(d, new R());
       default:
         throw new Error(`Unsupported model format: ${s}`);
     }
@@ -952,17 +1503,17 @@ class B {
       const t = await caches.open(this.CACHE_NAME), s = await t.match(e);
       if (s)
         return await s.arrayBuffer();
-      const i = await this.fileLoader.loadAsync(e), n = new Response(i);
-      return await t.put(e, n), i;
+      const n = await this.fileLoader.loadAsync(e), i = new Response(n);
+      return await t.put(e, i), n;
     } catch (t) {
       return console.warn(`[LoaderManager] Failed to use Cache API for ${e}:`, t), await this.fileLoader.loadAsync(e);
     }
   }
 }
-class ti {
-  static textureLoader = new Me();
-  static hdrLoader = new Xt();
-  static cubeTextureLoader = new ht();
+class Cn {
+  static textureLoader = new je();
+  static hdrLoader = new ps();
+  static cubeTextureLoader = new _t();
   static setLoadingManager(e) {
     this.textureLoader.manager = e, this.hdrLoader.manager = e, this.cubeTextureLoader.manager = e;
   }
@@ -971,13 +1522,13 @@ class ti {
   }
   static async loadAsyncHDR(e) {
     const t = await this.hdrLoader.loadAsync(e);
-    return t.mapping = lt, t;
+    return t.mapping = Mt, t;
   }
   static async loadAsyncCubeTexture(e, t) {
     return this.cubeTextureLoader.setPath(e), await this.cubeTextureLoader.loadAsync(t);
   }
 }
-class k extends z {
+class $ extends G {
   isBaseMesh = !0;
   type = "BaseMesh";
   ignoreInvisibleWhenRaycast = !0;
@@ -988,7 +1539,7 @@ class k extends z {
     return this.visible === !1 && this.ignoreInvisibleWhenRaycast === !0 ? !1 : super.raycast(e, t);
   }
 }
-class Be extends ee {
+class We extends I {
   isBaseGroup = !0;
   type = "BaseGroup";
   ignoreInvisibleWhenRaycast = !0;
@@ -999,7 +1550,7 @@ class Be extends ee {
     return this.visible === !1 && this.ignoreInvisibleWhenRaycast === !0 ? !1 : super.raycast(e, t);
   }
 }
-class Ms extends dt {
+class $s extends Tt {
   isBaseSprite = !0;
   type = "BaseSprite";
   ignoreInvisibleWhenRaycast = !0;
@@ -1010,7 +1561,7 @@ class Ms extends dt {
     return this.visible === !1 && this.ignoreInvisibleWhenRaycast === !0 ? !1 : super.raycast(e, t);
   }
 }
-class Z extends Be {
+class re extends We {
   isModel = !0;
   type = "Model";
   static memoryCache = /* @__PURE__ */ new Map();
@@ -1021,24 +1572,24 @@ class Z extends Be {
     super();
   }
   async loadAsync(e) {
-    const { url: t, cache: s = !0, persistent: i = !0 } = e;
+    const { url: t, cache: s = !0, persistent: n = !0 } = e;
     try {
-      let n;
-      s ? Z.memoryCache.has(t) ? n = Z.memoryCache.get(t) : (n = B.loadAsync(t, { persistent: i }), Z.memoryCache.set(t, n)) : n = B.loadAsync(t, { persistent: i });
-      const r = await n, o = qt(r);
-      return this.add(o), o.animations && o.animations.length > 0 && (this.animations = o.animations, this.mixer = new pt(o)), o;
-    } catch (n) {
-      return console.error(`[Model] Failed to load model from ${t}:`, n), null;
+      let i;
+      s ? re.memoryCache.has(t) ? i = re.memoryCache.get(t) : (i = j.loadAsync(t, { persistent: n }), re.memoryCache.set(t, i)) : i = j.loadAsync(t, { persistent: n });
+      const r = await i, o = us(r);
+      return this.add(o), o.animations && o.animations.length > 0 && (this.animations = o.animations, this.mixer = new Pt(o)), o;
+    } catch (i) {
+      return console.error(`[Model] Failed to load model from ${t}:`, i), null;
     }
   }
   playAnimation(e, t = {}) {
     if (!this.mixer || this.animations.length === 0) return null;
-    const { loop: s = !0, repetitions: i = 1 / 0, timeScale: n = 1, clampWhenFinished: r = !1 } = t;
+    const { loop: s = !0, repetitions: n = 1 / 0, timeScale: i = 1, clampWhenFinished: r = !1 } = t;
     let o;
-    if (e === void 0 ? o = this.animations[0] : typeof e == "number" ? o = this.animations[e] : o = this.animations.find((h) => h.name === e), !o)
+    if (e === void 0 ? o = this.animations[0] : typeof e == "number" ? o = this.animations[e] : o = this.animations.find((c) => c.name === e), !o)
       return console.warn(`[Model] Animation not found: ${e}`), null;
-    let c = this.actions.get(o.name);
-    return c || (c = this.mixer.clipAction(o), this.actions.set(o.name, c)), c.setLoop(s ? ut : mt, i), c.clampWhenFinished = r, c.timeScale = n, c.reset().play(), c;
+    let a = this.actions.get(o.name);
+    return a || (a = this.mixer.clipAction(o), this.actions.set(o.name, a)), a.setLoop(s ? Et : Ot, n), a.clampWhenFinished = r, a.timeScale = i, a.reset().play(), a;
   }
   playAllAnimations(e = {}) {
     return this.animations.map((t, s) => this.playAnimation(s, e)).filter((t) => t !== null);
@@ -1055,6 +1606,27 @@ class Z extends Be {
   updateAnimation(e) {
     this.mixer?.update(e);
   }
+  /**
+   * Get the axis-aligned bounding box of this model.
+   */
+  getBoundingBox() {
+    return new q().setFromObject(this);
+  }
+  /**
+   * Get the center point of this model's bounding box.
+   */
+  getCenter() {
+    const e = new w();
+    return this.getBoundingBox().getCenter(e), e;
+  }
+  /**
+   * Set the material for all meshes in this model.
+   */
+  setMaterial(e) {
+    this.traverse((t) => {
+      t instanceof G && (t.material = e);
+    });
+  }
   static clearMemoryCache() {
     this.memoryCache.clear();
   }
@@ -1062,11 +1634,11 @@ class Z extends Be {
     typeof caches < "u" && await caches.delete("u-space-loader-cache");
   }
 }
-class Ps extends k {
+class Ws extends $ {
   isSphereMesh = !0;
   type = "SphereMesh";
   constructor({ geometryParameters: e, materialParameters: t } = {}) {
-    super(), this.geometry = new gt(
+    super(), this.geometry = new At(
       e?.radius,
       e?.widthSegments,
       e?.heightSegments,
@@ -1074,23 +1646,23 @@ class Ps extends k {
       e?.phiLength,
       e?.thetaStart,
       e?.thetaLength
-    ), this.material = new L(t);
+    ), this.material = new R(t);
   }
 }
-class we extends k {
+class Pe extends $ {
   isTubeMesh = !0;
   type = "TubeMesh";
   constructor({ geometryParameters: e, materialParameters: t } = {}) {
-    super(), this.geometry = new ft(
+    super(), this.geometry = new Bt(
       e?.path,
       e?.tubularSegments,
       e?.radius,
       e?.radialSegments,
       e?.closed
-    ), this.material = new L(t);
+    ), this.material = new R(t);
   }
 }
-class si extends Be {
+class _n extends We {
   isTopology = !0;
   type = "Topology";
   // Visuals
@@ -1135,14 +1707,14 @@ class si extends Be {
    * @param weight Cost of the edge. Defaults to Euclidean distance.
    * @param bidirectional If true, adds the reverse edge as well. Default true.
    */
-  addEdge(e, t, s, i = !0) {
-    const n = this.nodes.get(e), r = this.nodes.get(t);
-    if (!n || !r) {
+  addEdge(e, t, s, n = !0) {
+    const i = this.nodes.get(e), r = this.nodes.get(t);
+    if (!i || !r) {
       console.error(`[Topology] Cannot add edge. One or both nodes not found: ${e}, ${t}`);
       return;
     }
-    const o = s ?? n.distanceTo(r);
-    this.getNeighbors(e)?.set(t, o), i && this.getNeighbors(t)?.set(e, o);
+    const o = s ?? i.distanceTo(r);
+    this.getNeighbors(e)?.set(t, o), n && this.getNeighbors(t)?.set(e, o);
   }
   /**
    * Remove an edge between two nodes.
@@ -1159,33 +1731,33 @@ class si extends Be {
   getShortestPath(e, t) {
     if (!this.nodes.has(e) || !this.nodes.has(t))
       return console.warn("[Topology] Start or End node not found."), [];
-    const s = /* @__PURE__ */ new Map(), i = /* @__PURE__ */ new Map(), n = /* @__PURE__ */ new Set();
-    for (const [c] of this.nodes)
-      s.set(c, 1 / 0), i.set(c, null), n.add(c);
-    for (s.set(e, 0); n.size > 0; ) {
-      let c = null, h = 1 / 0;
-      for (const d of n) {
-        const g = s.get(d);
-        g < h && (h = g, c = d);
+    const s = /* @__PURE__ */ new Map(), n = /* @__PURE__ */ new Map(), i = /* @__PURE__ */ new Set();
+    for (const [a] of this.nodes)
+      s.set(a, 1 / 0), n.set(a, null), i.add(a);
+    for (s.set(e, 0); i.size > 0; ) {
+      let a = null, c = 1 / 0;
+      for (const d of i) {
+        const p = s.get(d);
+        p < c && (c = p, a = d);
       }
-      if (c === null || c === t || h === 1 / 0)
+      if (a === null || a === t || c === 1 / 0)
         break;
-      n.delete(c);
-      const l = this.adjacencyMap?.get(c);
-      if (l)
-        for (const [d, g] of l) {
-          if (!n.has(d)) continue;
-          const p = s.get(c) + g;
-          p < s.get(d) && (s.set(d, p), i.set(d, c));
+      i.delete(a);
+      const h = this.adjacencyMap?.get(a);
+      if (h)
+        for (const [d, p] of h) {
+          if (!i.has(d)) continue;
+          const u = s.get(a) + p;
+          u < s.get(d) && (s.set(d, u), n.set(d, a));
         }
     }
     const r = [];
     let o = t;
-    if (i.get(t) === null && e !== t)
+    if (n.get(t) === null && e !== t)
       return [];
     for (; o !== null; ) {
-      const c = this.nodes.get(o);
-      c && r.unshift(c), o = i.get(o) || null;
+      const a = this.nodes.get(o);
+      a && r.unshift(a), o = n.get(o) || null;
     }
     return r;
   }
@@ -1193,8 +1765,8 @@ class si extends Be {
    * Renders the entire topology graph structure using TubeGeometry and Spheres.
    */
   renderGraph() {
-    this.clearGraph(), this.graphGroup = new ee();
-    const e = new Ps({
+    this.clearGraph(), this.graphGroup = new I();
+    const e = new Ws({
       geometryParameters: {
         radius: this.parameters.nodeRadius,
         widthSegments: 16,
@@ -1204,21 +1776,21 @@ class si extends Be {
         color: this.parameters.nodeColor
       }
     });
-    this.nodes.forEach((s, i) => {
-      const n = e.clone();
-      n.position.copy(s), Object.assign(n.userData, { id: i, type: "node" }), this.graphGroup.add(n);
+    this.nodes.forEach((s, n) => {
+      const i = e.clone();
+      i.position.copy(s), Object.assign(i.userData, { id: n, type: "node" }), this.graphGroup.add(i);
     });
     const t = /* @__PURE__ */ new Set();
-    this.adjacencyMap.forEach((s, i) => {
-      s.forEach((n, r) => {
-        const o = [i, r].sort().join("-");
+    this.adjacencyMap.forEach((s, n) => {
+      s.forEach((i, r) => {
+        const o = [n, r].sort().join("-");
         if (t.has(o)) return;
         t.add(o);
-        const c = this.nodes.get(i), h = this.nodes.get(r);
-        if (c && h) {
-          const l = new yt(c, h), d = new we({
+        const a = this.nodes.get(n), c = this.nodes.get(r);
+        if (a && c) {
+          const h = new Lt(a, c), d = new Pe({
             geometryParameters: {
-              path: l,
+              path: h,
               tubularSegments: 1,
               radius: this.parameters.edgeRadius,
               radialSegments: 8,
@@ -1228,14 +1800,14 @@ class si extends Be {
               color: this.parameters.edgeColor
             }
           });
-          Object.assign(d.userData, { from: i, to: r, weight: n, type: "edge" }), this.graphGroup.add(d);
+          Object.assign(d.userData, { from: n, to: r, weight: i, type: "edge" }), this.graphGroup.add(d);
         }
       });
     }), this.add(this.graphGroup);
   }
   clearGraph() {
     this.graphGroup && (this.remove(this.graphGroup), this.graphGroup.traverse((e) => {
-      e instanceof z && (e.geometry.dispose(), e.material.dispose());
+      e instanceof G && (e.geometry.dispose(), e.material.dispose());
     }), this.graphGroup = null);
   }
   /**
@@ -1243,7 +1815,7 @@ class si extends Be {
    */
   renderPath(e, t = this.parameters.pathColor) {
     if (e.length < 2) return;
-    const s = new wt(e, !1, "catmullrom", 0), i = new we({
+    const s = new It(e, !1, "catmullrom", 0), n = new Pe({
       geometryParameters: {
         path: s,
         tubularSegments: e.length * 10,
@@ -1254,7 +1826,7 @@ class si extends Be {
         color: t
       }
     });
-    return this.add(i), this.pathMeshes.push(i), i;
+    return this.add(n), this.pathMeshes.push(n), n;
   }
   clearPaths() {
     this.pathMeshes.forEach((e) => {
@@ -1264,14 +1836,14 @@ class si extends Be {
   /** Export nodes and edges as a JSON-serializable object. */
   exportData() {
     const e = {};
-    this.nodes.forEach((i, n) => {
-      e[n] = { x: i.x, y: i.y, z: i.z };
+    this.nodes.forEach((n, i) => {
+      e[i] = { x: n.x, y: n.y, z: n.z };
     });
     const t = [], s = /* @__PURE__ */ new Set();
-    return this.adjacencyMap.forEach((i, n) => {
-      i.forEach((r, o) => {
-        const c = [n, o].sort().join("-");
-        s.has(c) || (s.add(c), t.push({ from: n, to: o, weight: r }));
+    return this.adjacencyMap.forEach((n, i) => {
+      n.forEach((r, o) => {
+        const a = [i, o].sort().join("-");
+        s.has(a) || (s.add(a), t.push({ from: i, to: o, weight: r }));
       });
     }), { nodes: e, edges: t };
   }
@@ -1281,9 +1853,9 @@ class si extends Be {
    */
   importData(e) {
     this.clearGraph(), this.clearPaths(), this.nodes.clear(), this.adjacencyMap.clear(), Object.entries(e.nodes).forEach(([t, s]) => {
-      this.addNode(t, new oe(s.x, s.y, s.z));
-    }), e.edges.forEach(({ from: t, to: s, weight: i }) => {
-      this.addEdge(t, s, i);
+      this.addNode(t, new w(s.x, s.y, s.z));
+    }), e.edges.forEach(({ from: t, to: s, weight: n }) => {
+      this.addEdge(t, s, n);
     }), this.renderGraph();
   }
   dispose() {
@@ -1293,7 +1865,7 @@ class si extends Be {
     return this.adjacencyMap.get(e);
   }
 }
-class ii extends Ms {
+class Mn extends $s {
   isPoi = !0;
   type = "Poi";
   parameters = {
@@ -1312,7 +1884,7 @@ class ii extends Ms {
   _canvas = document.createElement("canvas");
   _lastParametersJSON = "";
   constructor(e = {}) {
-    super(new vt()), Object.assign(this.parameters, e), this.updateAsync();
+    super(new Rt()), Object.assign(this.parameters, e), this.updateAsync();
   }
   /**
    * Update the POI with new parameters
@@ -1323,195 +1895,191 @@ class ii extends Ms {
     const t = JSON.stringify(this.parameters);
     if (t === this._lastParametersJSON) return;
     this._lastParametersJSON = t;
-    const s = this._canvas, i = s.getContext("2d");
-    if (!i) return;
-    i.font = `${this.parameters.fontSize}px ${this.parameters.fontFamily}`;
-    let n = null;
-    this.parameters.img && (n = await this._loadImage(this.parameters.img));
-    const { text: r, fontSize: o, color: c, iconSize: h, padding: l, backgroundColor: d, borderRadius: g, textPosition: p, scaleFactor: y } = this.parameters, v = i.measureText(r), S = r ? v.width : 0, b = r ? o : 0;
-    let f = 0, T = 0, M = 0, P = 0, x = 0, m = 0;
-    const w = !!n, A = !!r;
-    if (w && A)
-      switch (p) {
+    const s = this._canvas, n = s.getContext("2d");
+    if (!n) return;
+    n.font = `${this.parameters.fontSize}px ${this.parameters.fontFamily}`;
+    let i = null;
+    this.parameters.img && (i = await this._loadImage(this.parameters.img));
+    const { text: r, fontSize: o, color: a, iconSize: c, padding: h, backgroundColor: d, borderRadius: p, textPosition: u, scaleFactor: g } = this.parameters, b = n.measureText(r), _ = r ? b.width : 0, x = r ? o : 0;
+    let y = 0, M = 0, E = 0, O = 0, T = 0, f = 0;
+    const v = !!i, z = !!r;
+    if (v && z)
+      switch (u) {
         case "top":
-          f = Math.max(h, S), T = h + l + b, x = (f - S) / 2, m = b / 2, M = (f - h) / 2, P = b + l;
+          y = Math.max(c, _), M = c + h + x, T = (y - _) / 2, f = x / 2, E = (y - c) / 2, O = x + h;
           break;
         case "bottom":
-          f = Math.max(h, S), T = h + l + b, M = (f - h) / 2, P = 0, x = (f - S) / 2, m = h + l + b / 2;
+          y = Math.max(c, _), M = c + h + x, E = (y - c) / 2, O = 0, T = (y - _) / 2, f = c + h + x / 2;
           break;
         case "left":
-          f = h + l + S, T = Math.max(h, b), x = 0, m = T / 2, M = S + l, P = (T - h) / 2;
+          y = c + h + _, M = Math.max(c, x), T = 0, f = M / 2, E = _ + h, O = (M - c) / 2;
           break;
         default:
-          f = h + l + S, T = Math.max(h, b), M = 0, P = (T - h) / 2, x = h + l, m = T / 2;
+          y = c + h + _, M = Math.max(c, x), E = 0, O = (M - c) / 2, T = c + h, f = M / 2;
           break;
       }
-    else w ? (f = h, T = h, M = 0, P = 0) : A && (f = S, T = b, x = 0, m = b / 2);
-    const N = f + l * 2, E = T + l * 2;
-    if (s.width = N, s.height = E, i.font = `${o}px ${this.parameters.fontFamily}`, d && (i.fillStyle = d, this._drawRoundedRect(i, 0, 0, N, E, g), i.fill()), w && i.drawImage(n, M + l, P + l, h, h), A) {
-      i.fillStyle = c;
-      const _ = i.measureText(r), D = _.actualBoundingBoxAscent + _.actualBoundingBoxDescent, He = _.actualBoundingBoxAscent - D / 2;
-      i.textBaseline = "alphabetic", i.fillText(r, x + l, m + l + He);
+    else v ? (y = c, M = c, E = 0, O = 0) : z && (y = _, M = x, T = 0, f = x / 2);
+    const N = y + h * 2, P = M + h * 2;
+    if (s.width = N, s.height = P, n.font = `${o}px ${this.parameters.fontFamily}`, d && (n.fillStyle = d, this._drawRoundedRect(n, 0, 0, N, P, p), n.fill()), v && n.drawImage(i, E + h, O + h, c, c), z) {
+      n.fillStyle = a;
+      const D = n.measureText(r), k = D.actualBoundingBoxAscent + D.actualBoundingBoxDescent, et = D.actualBoundingBoxAscent - k / 2;
+      n.textBaseline = "alphabetic", n.fillText(r, T + h, f + h + et);
     }
-    const H = this.material.map, G = new bt(s);
-    G.colorSpace = Pe, this.material.map = G, H?.dispose(), this.scale.set(N * y, E * y, 1);
+    const X = this.material.map, W = new zt(s);
+    W.colorSpace = De, this.material.map = W, X?.dispose(), this.scale.set(N * g, P * g, 1);
   }
   _loadImage(e) {
     return new Promise((t, s) => {
       if (typeof e == "string") {
-        const i = new Image();
-        i.crossOrigin = "Anonymous", i.onload = () => t(i), i.onerror = () => s(new Error(`Failed to load image: ${e}`)), i.src = e;
+        const n = new Image();
+        n.crossOrigin = "Anonymous", n.onload = () => t(n), n.onerror = () => s(new Error(`Failed to load image: ${e}`)), n.src = e;
       } else
         t(e);
     });
   }
-  _drawRoundedRect(e, t, s, i, n, r) {
-    e.beginPath(), e.moveTo(t + r, s), e.lineTo(t + i - r, s), e.quadraticCurveTo(t + i, s, t + i, s + r), e.lineTo(t + i, s + n - r), e.quadraticCurveTo(t + i, s + n, t + i - r, s + n), e.lineTo(t + r, s + n), e.quadraticCurveTo(t, s + n, t, s + n - r), e.lineTo(t, s + r), e.quadraticCurveTo(t, s, t + r, s), e.closePath();
+  _drawRoundedRect(e, t, s, n, i, r) {
+    e.beginPath(), e.moveTo(t + r, s), e.lineTo(t + n - r, s), e.quadraticCurveTo(t + n, s, t + n, s + r), e.lineTo(t + n, s + i - r), e.quadraticCurveTo(t + n, s + i, t + n - r, s + i), e.lineTo(t + r, s + i), e.quadraticCurveTo(t, s + i, t, s + i - r), e.lineTo(t, s + r), e.quadraticCurveTo(t, s, t + r, s), e.closePath();
   }
   dispose() {
     this.material.map?.dispose(), this.material.dispose();
   }
 }
-class _e extends k {
+class Ke extends $ {
   isShapeMesh = !0;
   type = "ShapeMesh";
   constructor({ geometryParameters: e, materialParameters: t } = {}) {
-    super(), this.geometry = new Ct(e?.shape, e?.curveSegments), this.material = new L(t), this.geometry.rotateX(-Math.PI / 2);
+    super(), this.geometry = new Nt(e?.shape, e?.curveSegments), this.material = new R(t), this.geometry.rotateX(-Math.PI / 2);
   }
   static createFromPoints(e, t = {}) {
-    return new _e({
+    return new Ke({
       ...t,
       geometryParameters: {
         ...t.geometryParameters,
-        shape: new Oe(e.map((s) => new R(s.x, -s.z)))
+        shape: new ke(e.map((s) => new S(s.x, -s.z)))
       }
     });
   }
 }
-class De extends k {
+class Qe extends $ {
   isExtrudeMesh = !0;
   type = "ExtrudeMesh";
   constructor({ geometryParameters: e, materialParameters: t } = {}) {
-    super(), this.geometry = new Tt(e?.shape, e?.options), this.material = new L(t), this.geometry.rotateX(-Math.PI / 2);
+    super(), this.geometry = new jt(e?.shape, e?.options), this.material = new R(t), this.geometry.rotateX(-Math.PI / 2);
   }
   static createFromPoints(e, t = {}) {
-    return new De({
+    return new Qe({
       ...t,
       geometryParameters: {
         ...t.geometryParameters,
-        shape: new Oe(e.map((s) => new R(s.x, -s.z)))
+        shape: new ke(e.map((s) => new S(s.x, -s.z)))
       }
     });
   }
 }
-class ni extends k {
+class Tn extends $ {
   isPlaneMesh = !0;
   type = "PlaneMesh";
   constructor({ geometryParameters: e, materialParameters: t } = {}) {
-    super(), this.geometry = new St(
+    super(), this.geometry = new Dt(
       e?.width,
       e?.height,
       e?.widthSegments,
       e?.heightSegments
-    ), this.material = new L(t);
+    ), this.material = new R(t);
   }
 }
-class ri extends k {
+class Pn extends $ {
   isCircleMesh = !0;
   type = "CircleMesh";
   constructor({ geometryParameters: e, materialParameters: t } = {}) {
     super(
-      new xt(
+      new kt(
         e?.radius,
         e?.segments,
         e?.thetaStart,
         e?.thetaLength
       ),
-      new L(t)
+      new R(t)
     ), this.geometry.rotateX(-Math.PI / 2);
   }
 }
-class W {
+class F {
   static traverseMeshes(e, t) {
     e.traverse((s) => {
-      s instanceof z && t(s);
+      s instanceof G && t(s);
     });
   }
 }
-class ai {
+class En {
   static flow(e = {}) {
-    const { baseColor: t = 16777215, flowColor: s = 65280, speed: i = 1, scale: n = 3, intensity: r = 4 } = e, o = j(new U(t)), c = j(new U(s)), h = pe().x.mul(n).sub(X.mul(i)), l = q(ae(h).add(1).mul(0.5), r);
-    return Y(o, c, l);
+    const { baseColor: t = 16777215, flowColor: s = 65280, speed: n = 1, scale: i = 3, intensity: r = 4 } = e, o = H(new U(t)), a = H(new U(s)), c = xe().x.mul(i).sub(te.mul(n)), h = se(pe(c).add(1).mul(0.5), r);
+    return ne(o, a, h);
   }
   static breathe(e = {}) {
-    const { baseColor: t = 16777215, breathColor: s = 65280, speed: i = 1, intensity: n = 2 } = e, r = j(new U(t)), o = j(new U(s)), c = ae(X.mul(i)).add(1).mul(0.5), h = q(c, n);
-    return Y(r, o, h);
+    const { baseColor: t = 16777215, breathColor: s = 65280, speed: n = 1, intensity: i = 2 } = e, r = H(new U(t)), o = H(new U(s)), a = pe(te.mul(n)).add(1).mul(0.5), c = se(a, i);
+    return ne(r, o, c);
   }
   static fluid(e = {}) {
     const {
       baseColor: t = 16777215,
       flowColor: s = 255,
-      speed: i = 1,
-      scale: n = 1,
+      speed: n = 1,
+      scale: i = 1,
       intensity: r = 1,
       distortion: o = 0.5
-    } = e, c = j(new U(t)), h = j(new U(s)), l = pe().mul(n), d = X.mul(i), g = ue(l.add(d), 1, 0), p = l.add(g.mul(o)), y = ue(p, 1, 0).add(1).mul(0.5), v = q(y, r);
-    return Y(c, h, v);
+    } = e, a = H(new U(t)), c = H(new U(s)), h = xe().mul(i), d = te.mul(n), p = Se(h.add(d), 1, 0), u = h.add(p.mul(o)), g = Se(u, 1, 0).add(1).mul(0.5), b = se(g, r);
+    return ne(a, c, b);
   }
 }
-function oi(a) {
+function On(l) {
 }
-const ie = "uSpaceHighlight", F = `${ie}/enabled`, je = `${ie}/opacity`, Ue = `${ie}/color`, ke = `${ie}/overwrite`, ne = "uSpaceBreathe", te = `${ne}/enabled`, Ge = `${ne}/color`, Fe = `${ne}/speed`, ze = `${ne}/intensity`, se = /* @__PURE__ */ new WeakMap(), Os = Re(() => {
-  const a = O(F, "uint"), e = O(Ue, "uint"), t = O(ke, "uint"), s = Ce(e), i = me.mul(s), n = J(t.greaterThan(0), s, i), r = J(a.greaterThan(0), n, me), o = O(te, "uint"), c = O(Ge, "uint"), h = O(Fe, "float"), l = O(ze, "float"), d = Ce(c), g = ae(X.mul(h)).add(1).mul(0.5), p = q(g, l), y = Y(r, d, p);
-  return J(o.greaterThan(0), y, r);
-})(), Rs = Re(() => {
-  const a = O(F, "uint"), e = O(je, "float");
-  return J(a.greaterThan(0), e, Lt);
+const he = "uSpaceHighlight", Q = `${he}/enabled`, qe = `${he}/opacity`, Xe = `${he}/color`, Ye = `${he}/overwrite`, le = "uSpaceBreathe", ae = `${le}/enabled`, Je = `${le}/color`, Ve = `${le}/speed`, Ze = `${le}/intensity`, ce = /* @__PURE__ */ new WeakMap(), Ks = He(() => {
+  const l = A(Q, "uint"), e = A(Xe, "uint"), t = A(Ye, "uint"), s = Ae(e), n = Ce.mul(s), i = ie(t.greaterThan(0), s, n), r = ie(l.greaterThan(0), i, Ce), o = A(ae, "uint"), a = A(Je, "uint"), c = A(Ve, "float"), h = A(Ze, "float"), d = Ae(a), p = pe(te.mul(c)).add(1).mul(0.5), u = se(p, h), g = ne(r, d, u);
+  return ie(o.greaterThan(0), g, r);
+})(), Qs = He(() => {
+  const l = A(Q, "uint"), e = A(qe, "float");
+  return ie(l.greaterThan(0), e, Xt);
 })();
-function ve(a) {
-  const e = a.material;
+function Ee(l) {
+  const e = l.material;
   if (!e || Array.isArray(e)) return;
-  let t = se.get(e);
+  let t = ce.get(e);
   t || (t = {
     colorNode: e.colorNode,
     opacityNode: e.opacityNode,
     transparent: e.transparent,
+    depthWrite: e.depthWrite,
     activeMeshes: /* @__PURE__ */ new Set()
-  }, se.set(e, t)), t.activeMeshes.add(a), e.transparent = !0, e.colorNode = Os, e.opacityNode = Rs, e.needsUpdate = !0;
+  }, ce.set(e, t)), t.activeMeshes.add(l), e.transparent = !0, e.colorNode = Ks, e.opacityNode = Qs, e.needsUpdate = !0;
 }
-function be(a) {
-  const e = a.userData[F], t = a.userData[te];
+function Oe(l) {
+  const e = l.userData[Q], t = l.userData[ae];
   if (e || t) return;
-  const s = a.material;
+  const s = l.material;
   if (!s || Array.isArray(s)) return;
-  const i = se.get(s);
-  i && (i.activeMeshes.delete(a), !(i.activeMeshes.size > 0) && (s.colorNode = i.colorNode, s.opacityNode = i.opacityNode, s.transparent = i.transparent, s.needsUpdate = !0, se.delete(s)));
+  const n = ce.get(s);
+  n && (n.activeMeshes.delete(l), !(n.activeMeshes.size > 0) && (s.colorNode = n.colorNode, s.opacityNode = n.opacityNode, s.transparent = n.transparent, s.depthWrite = n.depthWrite, s.needsUpdate = !0, ce.delete(s)));
 }
-class ci {
+class oe {
   static highlightColor(e, t = {}) {
-    const s = Array.isArray(e) ? e : [e], i = Object.assign(
-      {
-        opacity: 0.5,
-        color: 16711680,
-        overwrite: !1
-      },
-      t
-    );
-    i.color = new V(i.color).getHex();
-    for (const n of s)
-      W.traverseMeshes(n, (r) => {
-        r.userData[F] = 1, r.userData[je] = i.opacity, r.userData[Ue] = i.color, r.userData[ke] = i.overwrite ? 1 : 0, ve(r);
+    const s = Array.isArray(e) ? e : [e], { opacity: n = 0.5, color: i = 16711680, overwrite: r = !1, depthWrite: o } = t, a = new B(i).getHex();
+    for (const c of s)
+      F.traverseMeshes(c, (h) => {
+        if (h.userData[Q] = 1, h.userData[qe] = n, h.userData[Xe] = a, h.userData[Ye] = r ? 1 : 0, Ee(h), o !== void 0) {
+          const d = h.material;
+          d && !Array.isArray(d) && (d.depthWrite = o);
+        }
       });
   }
   static removeHighlightColor(e) {
     const t = Array.isArray(e) ? e : [e];
     for (const s of t)
-      W.traverseMeshes(s, (i) => {
-        i.userData[F] = 0, be(i);
+      F.traverseMeshes(s, (n) => {
+        n.userData[Q] = 0, Oe(n);
       });
   }
   static breatheColor(e, t = {}) {
-    const s = Array.isArray(e) ? e : [e], i = Object.assign(
+    const s = Array.isArray(e) ? e : [e], n = Object.assign(
       {
         color: 65280,
         speed: 1,
@@ -1519,25 +2087,88 @@ class ci {
       },
       t
     );
-    i.color = new V(i.color).getHex();
-    for (const n of s)
-      W.traverseMeshes(n, (r) => {
-        r.userData[te] = 1, r.userData[Ge] = i.color, r.userData[Fe] = i.speed, r.userData[ze] = i.intensity, ve(r);
+    n.color = new B(n.color).getHex();
+    for (const i of s)
+      F.traverseMeshes(i, (r) => {
+        r.userData[ae] = 1, r.userData[Je] = n.color, r.userData[Ve] = n.speed, r.userData[Ze] = n.intensity, Ee(r);
       });
   }
   static removeBreatheColor(e) {
     const t = Array.isArray(e) ? e : [e];
     for (const s of t)
-      W.traverseMeshes(s, (i) => {
-        i.userData[te] = 0, be(i);
+      F.traverseMeshes(s, (n) => {
+        n.userData[ae] = 0, Oe(n);
       });
   }
+  /**
+   * Enable wireframe mode on object(s).
+   */
+  static wireframe(e, t = !0) {
+    const s = Array.isArray(e) ? e : [e];
+    for (const n of s)
+      F.traverseMeshes(n, (i) => {
+        const r = i.material;
+        !r || Array.isArray(r) || (r.wireframe = t, r.needsUpdate = !0);
+      });
+  }
+  /**
+   * Remove wireframe mode.
+   */
+  static removeWireframe(e) {
+    oe.wireframe(e, !1);
+  }
+  /**
+   * Fade in object(s) from fully transparent to original opacity.
+   * Returns a promise that resolves when animation is complete.
+   */
+  static fadeIn(e, t = {}) {
+    const { duration: s = 500 } = t;
+    return oe._fade(e, 0, 1, s);
+  }
+  /**
+   * Fade out object(s) to fully transparent.
+   * Returns a promise that resolves when animation is complete.
+   */
+  static fadeOut(e, t = {}) {
+    const { duration: s = 500 } = t;
+    return oe._fade(e, 1, 0, s);
+  }
+  static _fade(e, t, s, n) {
+    const i = Array.isArray(e) ? e : [e], r = [];
+    for (const o of i)
+      F.traverseMeshes(o, (a) => {
+        const c = a.material;
+        !c || Array.isArray(c) || (c.transparent = !0, c.opacity = t, c.needsUpdate = !0, r.push({ material: c, targetOpacity: s }));
+      });
+    return r.length === 0 ? Promise.resolve() : new Promise((o) => {
+      const a = performance.now();
+      let c = 0;
+      const h = () => {
+        const d = performance.now() - a, p = Math.min(d / n, 1);
+        if (!i[0].parent) {
+          cancelAnimationFrame(c), o();
+          return;
+        }
+        for (const { material: g, targetOpacity: b } of r)
+          g.opacity = t + (b - t) * p, g.needsUpdate = !0;
+        if (p < 1)
+          c = requestAnimationFrame(h);
+        else {
+          if (s >= 1)
+            for (const { material: g } of r)
+              g.transparent = !1;
+          o();
+        }
+      };
+      c = requestAnimationFrame(h);
+    });
+  }
 }
-const Ce = (a) => {
-  const e = a.shiftRight(16).bitAnd(255).toFloat().div(255), t = a.shiftRight(8).bitAnd(255).toFloat().div(255), s = a.bitAnd(255).toFloat().div(255);
-  return At(e, t, s);
+const Ae = (l) => {
+  const e = l.shiftRight(16).bitAnd(255).toFloat().div(255), t = l.shiftRight(8).bitAnd(255).toFloat().div(255), s = l.bitAnd(255).toFloat().div(255);
+  return Yt(e, t, s);
 };
-class Is extends Yt {
+class qs extends ms {
   viewer;
   constructor(e, t) {
     super(t), this.viewer = e;
@@ -1546,7 +2177,7 @@ class Is extends Yt {
     this.update(e) && this.viewer.render();
   };
   easingByMode(e) {
-    const t = Ls[e];
+    const t = Xs[e];
     return super.easing(t);
   }
   start(e, t) {
@@ -1556,87 +2187,500 @@ class Is extends Yt {
     return this.viewer.removeEventListener("afterControlsUpdate", this._update), super.stop();
   }
 }
-function hi(a, e, t, s = {}, i, n) {
+function An(l, e, t, s = {}, n, i) {
   return new Promise((r, o) => {
-    const { duration: c = 1e3, delay: h = 0, repeat: l = !1, mode: d = "Linear.None", yoyo: g = !1 } = s, p = new Is(a, e).to(t, c).easingByMode(d).delay(h).onUpdate((y) => {
-      i?.(y, p);
+    const { duration: a = 1e3, delay: c = 0, repeat: h = !1, mode: d = "Linear.None", yoyo: p = !1 } = s, u = new qs(l, e).to(t, a).easingByMode(d).delay(c).onUpdate((g) => {
+      n?.(g, u);
     }).onComplete(() => {
       r();
     }).onStop(() => {
       o("animation stop");
     }).onStart(() => {
-      n?.(p);
+      i?.(u);
     });
-    typeof l == "number" ? p.repeat(l) : typeof l == "boolean" && l && p.repeat(1 / 0), g && p.repeatDelay(20), p.yoyo(g), p.start();
+    typeof h == "number" ? u.repeat(h) : typeof h == "boolean" && h && u.repeat(1 / 0), p && u.repeatDelay(20), u.yoyo(p), u.start();
   });
 }
-const Ls = {
-  "Linear.None": u.Linear.None,
-  "Quadratic.In": u.Quadratic.In,
-  "Quadratic.Out": u.Quadratic.Out,
-  "Quadratic.InOut": u.Quadratic.InOut,
-  "Cubic.In": u.Cubic.In,
-  "Cubic.Out": u.Cubic.Out,
-  "Cubic.InOut": u.Cubic.InOut,
-  "Quartic.In": u.Quartic.In,
-  "Quartic.Out": u.Quartic.Out,
-  "Quartic.InOut": u.Quartic.InOut,
-  "Quintic.In": u.Quintic.In,
-  "Quintic.Out": u.Quintic.Out,
-  "Quintic.InOut": u.Quintic.InOut,
-  "Sinusoidal.In": u.Sinusoidal.In,
-  "Sinusoidal.Out": u.Sinusoidal.Out,
-  "Sinusoidal.InOut": u.Sinusoidal.InOut,
-  "Exponential.In": u.Exponential.In,
-  "Exponential.Out": u.Exponential.Out,
-  "Exponential.InOut": u.Exponential.InOut,
-  "Circular.In": u.Circular.In,
-  "Circular.Out": u.Circular.Out,
-  "Circular.InOut": u.Circular.InOut,
-  "Elastic.In": u.Elastic.In,
-  "Elastic.Out": u.Elastic.Out,
-  "Elastic.InOut": u.Elastic.InOut,
-  "Back.In": u.Back.In,
-  "Back.Out": u.Back.Out,
-  "Back.InOut": u.Back.InOut,
-  "Bounce.In": u.Bounce.In,
-  "Bounce.Out": u.Bounce.Out,
-  "Bounce.InOut": u.Bounce.InOut
-}, As = "0.0.5";
-window.__USPACE__ = { version: As };
+const Xs = {
+  "Linear.None": m.Linear.None,
+  "Quadratic.In": m.Quadratic.In,
+  "Quadratic.Out": m.Quadratic.Out,
+  "Quadratic.InOut": m.Quadratic.InOut,
+  "Cubic.In": m.Cubic.In,
+  "Cubic.Out": m.Cubic.Out,
+  "Cubic.InOut": m.Cubic.InOut,
+  "Quartic.In": m.Quartic.In,
+  "Quartic.Out": m.Quartic.Out,
+  "Quartic.InOut": m.Quartic.InOut,
+  "Quintic.In": m.Quintic.In,
+  "Quintic.Out": m.Quintic.Out,
+  "Quintic.InOut": m.Quintic.InOut,
+  "Sinusoidal.In": m.Sinusoidal.In,
+  "Sinusoidal.Out": m.Sinusoidal.Out,
+  "Sinusoidal.InOut": m.Sinusoidal.InOut,
+  "Exponential.In": m.Exponential.In,
+  "Exponential.Out": m.Exponential.Out,
+  "Exponential.InOut": m.Exponential.InOut,
+  "Circular.In": m.Circular.In,
+  "Circular.Out": m.Circular.Out,
+  "Circular.InOut": m.Circular.InOut,
+  "Elastic.In": m.Elastic.In,
+  "Elastic.Out": m.Elastic.Out,
+  "Elastic.InOut": m.Elastic.InOut,
+  "Back.In": m.Back.In,
+  "Back.Out": m.Back.Out,
+  "Back.InOut": m.Back.InOut,
+  "Bounce.In": m.Bounce.In,
+  "Bounce.Out": m.Bounce.Out,
+  "Bounce.InOut": m.Bounce.InOut
+};
+class Bn {
+  scene;
+  planes = /* @__PURE__ */ new Map();
+  helpers = /* @__PURE__ */ new Map();
+  /**
+   * The ClippingGroup node. Objects must be descendants of this group to be clipped.
+   */
+  group;
+  constructor(e) {
+    this.scene = e, this.group = new Ht(), this.group.name = "__clippingToolGroup", this.scene.add(this.group);
+  }
+  /**
+   * Move all current scene children (except the clipping group itself) into the ClippingGroup,
+   * so they are all subject to clipping.
+   */
+  attach() {
+    const e = [...this.scene.children];
+    for (const t of e)
+      t !== this.group && this.group.add(t);
+  }
+  /**
+   * Move all children out of the ClippingGroup back to the scene root.
+   */
+  detach() {
+    const e = [...this.group.children];
+    for (const t of e)
+      this.helpers.has(t.name) || this.scene.add(t);
+  }
+  /**
+   * Enable clipping.
+   */
+  enable() {
+    this.group.enabled = !0;
+  }
+  /**
+   * Disable clipping.
+   */
+  disable() {
+    this.group.enabled = !1;
+  }
+  /**
+   * Add a clipping plane.
+   */
+  addPlane(e, t = {}) {
+    const {
+      normal: s = { x: 0, y: -1, z: 0 },
+      constant: n = 0,
+      showHelper: i = !1,
+      helperSize: r = 5,
+      helperColor: o = 16711680
+    } = t, a = new Ut(new w(s.x, s.y, s.z), n);
+    return this.planes.set(e, a), this._syncPlanes(), i && this.showHelper(e, r, o), a;
+  }
+  /**
+   * Add six clipping planes that form a box around a Box3.
+   * Returns the six plane ids: `${id}_+x`, `${id}_-x`, etc.
+   */
+  addBox(e, t, s = {}) {
+    const { showHelpers: n = !1, helperColor: i = 16711680 } = s, r = t.min, o = t.max, a = [
+      { suffix: "+x", normal: { x: -1, y: 0, z: 0 }, constant: o.x },
+      { suffix: "-x", normal: { x: 1, y: 0, z: 0 }, constant: -r.x },
+      { suffix: "+y", normal: { x: 0, y: -1, z: 0 }, constant: o.y },
+      { suffix: "-y", normal: { x: 0, y: 1, z: 0 }, constant: -r.y },
+      { suffix: "+z", normal: { x: 0, y: 0, z: -1 }, constant: o.z },
+      { suffix: "-z", normal: { x: 0, y: 0, z: 1 }, constant: -r.z }
+    ], c = [];
+    for (const h of a) {
+      const d = `${e}_${h.suffix}`;
+      this.addPlane(d, { normal: h.normal, constant: h.constant, showHelper: n, helperColor: i }), c.push(d);
+    }
+    return c;
+  }
+  /**
+   * Add a clipping box from an object's bounding box with optional padding.
+   */
+  addBoxFromObject(e, t, s = 0, n = {}) {
+    const i = new q().setFromObject(t);
+    return i.expandByScalar(s), this.addBox(e, i, n);
+  }
+  /**
+   * Update a plane's constant (distance from origin).
+   */
+  setPlaneConstant(e, t) {
+    const s = this.planes.get(e);
+    s && (s.constant = t);
+  }
+  /**
+   * Remove a clipping plane.
+   */
+  removePlane(e) {
+    this.planes.delete(e), this.hideHelper(e), this._syncPlanes();
+  }
+  /**
+   * Remove a clipping box (all 6 associated planes).
+   */
+  removeBox(e) {
+    const t = ["+x", "-x", "+y", "-y", "+z", "-z"];
+    for (const s of t)
+      this.removePlane(`${e}_${s}`);
+  }
+  /**
+   * Remove all clipping planes.
+   */
+  removeAll() {
+    const e = Array.from(this.helpers.keys());
+    for (const t of e)
+      this.hideHelper(t);
+    this.planes.clear(), this._syncPlanes();
+  }
+  /**
+   * Show a helper visualization for a clipping plane.
+   */
+  showHelper(e, t = 5, s = 16711680) {
+    this.hideHelper(e);
+    const n = this.planes.get(e);
+    if (!n) return;
+    const i = new Ft(n, t, new B(s).getHex());
+    i.name = e, this.helpers.set(e, i), this.scene.add(i);
+  }
+  /**
+   * Hide a plane helper.
+   */
+  hideHelper(e) {
+    const t = this.helpers.get(e);
+    t && (this.scene.remove(t), t.dispose(), this.helpers.delete(e));
+  }
+  /**
+   * Get a plane by id.
+   */
+  get(e) {
+    return this.planes.get(e);
+  }
+  /**
+   * Sync the planes map into the ClippingGroup's clippingPlanes array.
+   */
+  _syncPlanes() {
+    this.group.clippingPlanes = Array.from(this.planes.values());
+  }
+  dispose() {
+    this.detach(), this.removeAll(), this.scene.remove(this.group);
+  }
+}
+class Ln {
+  scene;
+  measurements = /* @__PURE__ */ new Map();
+  _idCounter = 0;
+  constructor(e) {
+    this.scene = e;
+  }
+  /**
+   * Measure distance between two points.
+   */
+  measureDistance(e, t, s = {}) {
+    const { lineColor: n = 16776960 } = s, i = new w(e.x, e.y, e.z), r = new w(t.x, t.y, t.z), o = i.distanceTo(r), a = `measure_dist_${this._idCounter++}`, c = new I();
+    c.name = a;
+    const h = new K().setFromPoints([i, r]), d = new Z({ color: n }), p = new ee(h, d);
+    c.add(p), this.scene.add(c);
+    const u = {
+      id: a,
+      type: "distance",
+      value: o,
+      unit: "m",
+      points: [i, r],
+      object: c
+    };
+    return this.measurements.set(a, u), u;
+  }
+  /**
+   * Measure the area of a polygon defined by 3+ coplanar points.
+   */
+  measureArea(e, t = {}) {
+    const { lineColor: s = 65280 } = t;
+    if (e.length < 3)
+      throw new Error("MeasureTool.measureArea requires at least 3 points");
+    const n = e.map((u) => new w(u.x, u.y, u.z)), i = this._calculatePolygonArea(n), r = `measure_area_${this._idCounter++}`, o = new I();
+    o.name = r;
+    const a = [...n, n[0]], c = new K().setFromPoints(a), h = new Z({ color: s }), d = new ee(c, h);
+    o.add(d), this.scene.add(o);
+    const p = {
+      id: r,
+      type: "area",
+      value: i,
+      unit: "m²",
+      points: n,
+      object: o
+    };
+    return this.measurements.set(r, p), p;
+  }
+  /**
+   * Measure the angle between three points (vertex at the middle point).
+   */
+  measureAngle(e, t, s, n = {}) {
+    const { lineColor: i = 16746496 } = n, r = new w(e.x, e.y, e.z), o = new w(t.x, t.y, t.z), a = new w(s.x, s.y, s.z), c = r.clone().sub(o).normalize(), h = a.clone().sub(o).normalize(), p = Math.acos(Math.max(-1, Math.min(1, c.dot(h)))) * 180 / Math.PI, u = `measure_angle_${this._idCounter++}`, g = new I();
+    g.name = u;
+    const b = new K().setFromPoints([r, o, a]), _ = new Z({ color: i }), x = new ee(b, _);
+    g.add(x), this.scene.add(g);
+    const y = {
+      id: u,
+      type: "angle",
+      value: p,
+      unit: "°",
+      points: [r, o, a],
+      object: g
+    };
+    return this.measurements.set(u, y), y;
+  }
+  /**
+   * Get a measurement result by id.
+   */
+  get(e) {
+    return this.measurements.get(e);
+  }
+  /**
+   * Remove a measurement by id.
+   */
+  remove(e) {
+    const t = this.measurements.get(e);
+    t && (this.scene.remove(t.object), t.object.traverse((s) => {
+      s.geometry?.dispose(), s.material?.dispose();
+    }), this.measurements.delete(e));
+  }
+  /**
+   * Remove all measurements.
+   */
+  removeAll() {
+    const e = Array.from(this.measurements.keys());
+    for (const t of e)
+      this.remove(t);
+  }
+  /**
+   * Get all measurement results.
+   */
+  getAll() {
+    return Array.from(this.measurements.values());
+  }
+  /**
+   * Calculate polygon area using cross product method (Newell's method).
+   */
+  _calculatePolygonArea(e) {
+    const t = e.length, s = new w();
+    for (let i = 0; i < t; i++) {
+      const r = e[i], o = e[(i + 1) % t], a = new w().crossVectors(r, o);
+      s.add(a);
+    }
+    const n = new w();
+    if (t >= 3) {
+      const i = e[1].clone().sub(e[0]), r = e[2].clone().sub(e[0]);
+      n.crossVectors(i, r).normalize();
+    }
+    return Math.abs(s.dot(n)) / 2;
+  }
+  dispose() {
+    this.removeAll();
+  }
+}
+class In {
+  scene;
+  annotations = /* @__PURE__ */ new Map();
+  _idCounter = 0;
+  _createCSSObject = null;
+  constructor(e) {
+    this.scene = e;
+  }
+  /**
+   * Set the CSS object factory function (from CSSRenderer).
+   * This allows annotations to be rendered as CSS2D/CSS2.5D objects.
+   */
+  setCSSObjectFactory(e) {
+    this._createCSSObject = e;
+  }
+  /**
+   * Add an annotation.
+   */
+  add(e, t) {
+    this.annotations.has(e) && this.remove(e);
+    const s = new I();
+    s.name = `annotation_${e}`;
+    const n = new w(t.position.x, t.position.y, t.position.z);
+    s.position.copy(n);
+    const i = document.createElement("div");
+    if (i.innerHTML = t.content, i.style.cssText = `
+      padding: 4px 8px;
+      background: rgba(0, 0, 0, 0.75);
+      color: #fff;
+      font-size: 12px;
+      border-radius: 4px;
+      pointer-events: auto;
+      white-space: nowrap;
+    `, t.labelStyle)
+      for (const [c, h] of Object.entries(t.labelStyle))
+        h !== void 0 && (i.style[c] = h);
+    let r = null;
+    const o = t.labelOffset || { x: 0, y: 2, z: 0 };
+    if (t.showLeaderLine !== !1) {
+      const { lineColor: c = 16777215 } = t, h = new K().setFromPoints([
+        new w(0, 0, 0),
+        new w(o.x, o.y, o.z)
+      ]), d = new Z({ color: c });
+      r = new ee(h, d), s.add(r);
+    }
+    if (this._createCSSObject) {
+      const c = this._createCSSObject(i);
+      c.position.set(o.x, o.y, o.z), s.add(c);
+    }
+    this.scene.add(s);
+    const a = {
+      id: e,
+      options: t,
+      group: s,
+      labelElement: i,
+      line: r
+    };
+    return this.annotations.set(e, a), a;
+  }
+  /**
+   * Quick-add a text annotation.
+   */
+  addText(e, t, s = {}) {
+    const n = `annotation_${this._idCounter++}`;
+    return this.add(n, {
+      position: t,
+      content: e,
+      ...s
+    });
+  }
+  /**
+   * Update an annotation's content.
+   */
+  updateContent(e, t) {
+    const s = this.annotations.get(e);
+    s && (s.labelElement.innerHTML = t, s.options.content = t);
+  }
+  /**
+   * Update an annotation's position.
+   */
+  updatePosition(e, t) {
+    const s = this.annotations.get(e);
+    s && (s.group.position.set(t.x, t.y, t.z), s.options.position = t);
+  }
+  /**
+   * Show an annotation.
+   */
+  show(e) {
+    const t = this.annotations.get(e);
+    t && (t.group.visible = !0);
+  }
+  /**
+   * Hide an annotation.
+   */
+  hide(e) {
+    const t = this.annotations.get(e);
+    t && (t.group.visible = !1);
+  }
+  /**
+   * Get an annotation by id.
+   */
+  get(e) {
+    return this.annotations.get(e);
+  }
+  /**
+   * Remove an annotation.
+   */
+  remove(e) {
+    const t = this.annotations.get(e);
+    if (t) {
+      const s = [...t.group.children];
+      for (const n of s)
+        t.group.remove(n), n.geometry?.dispose(), n.material?.dispose();
+      this.scene.remove(t.group), this.annotations.delete(e);
+    }
+  }
+  /**
+   * Remove all annotations.
+   */
+  removeAll() {
+    const e = Array.from(this.annotations.keys());
+    for (const t of e)
+      this.remove(t);
+  }
+  /**
+   * Show all annotations.
+   */
+  showAll() {
+    for (const e of this.annotations.values())
+      e.group.visible = !0;
+  }
+  /**
+   * Hide all annotations.
+   */
+  hideAll() {
+    for (const e of this.annotations.values())
+      e.group.visible = !1;
+  }
+  /**
+   * Get all annotation ids.
+   */
+  keys() {
+    return Array.from(this.annotations.keys());
+  }
+  get size() {
+    return this.annotations.size;
+  }
+  dispose() {
+    this.removeAll();
+  }
+}
+const Ys = "0.0.8";
+window.__USPACE__ = { version: Ys };
 export {
-  Be as BaseGroup,
-  k as BaseMesh,
-  Ms as BaseSprite,
-  pi as CSS2DObject,
-  mi as CSS3DObject,
-  gi as CSS3DSprite,
-  cs as CSSRenderer,
-  ss as CameraControls,
-  ri as CircleMesh,
-  De as ExtrudeMesh,
-  Jt as InteractionEvent,
-  Zt as InteractionManager,
-  ci as MaterialEffects,
-  Z as Model,
-  B as ModelLoaderManager,
-  Vt as ObjectManager,
-  W as ObjectUtils,
-  ni as PlaneMesh,
-  ii as Poi,
-  es as RenderPipeline,
-  ns as RoomEnvironment,
-  Es as SBMLoader,
-  ls as SBMXLoader,
-  _e as ShapeMesh,
-  Ps as SphereMesh,
-  ai as TSLEffects,
-  ti as TextureLoaderManager,
-  si as Topology,
-  we as TubeMesh,
-  Is as Tween,
-  ei as Viewer,
-  oi as reinterpretType,
-  hi as tweenAnimation,
-  As as version
+  In as AnnotationManager,
+  We as BaseGroup,
+  $ as BaseMesh,
+  $s as BaseSprite,
+  Nn as CSS2DObject,
+  Dn as CSS3DObject,
+  kn as CSS3DSprite,
+  Ts as CSSRenderer,
+  vs as CameraControls,
+  Pn as CircleMesh,
+  Bn as ClippingTool,
+  Qe as ExtrudeMesh,
+  gs as InteractionEvent,
+  fs as InteractionManager,
+  xn as LightManager,
+  oe as MaterialEffects,
+  Ln as MeasureTool,
+  re as Model,
+  j as ModelLoaderManager,
+  ys as ObjectManager,
+  F as ObjectUtils,
+  Tn as PlaneMesh,
+  Mn as Poi,
+  ws as RenderPipeline,
+  Ss as RoomEnvironment,
+  Gs as SBMLoader,
+  Es as SBMXLoader,
+  vn as SceneManager,
+  bn as Selection,
+  Ke as ShapeMesh,
+  Ws as SphereMesh,
+  En as TSLEffects,
+  Cn as TextureLoaderManager,
+  _n as Topology,
+  Pe as TubeMesh,
+  qs as Tween,
+  Sn as Viewer,
+  On as reinterpretType,
+  An as tweenAnimation,
+  Ys as version
 };