u-space 0.0.1 → 0.0.2

package/dist/index.js

@@ -1,18 +1,18 @@
-import { Raycaster as ue, Vector2 as P, RenderPipeline as Be, Sphere as me, Box3 as ge, Spherical as C, Matrix4 as Re, Quaternion as _e, Vector4 as Ae, Vector3 as we, MathUtils as Ne, PMREMGenerator as Ue, OrthographicCamera as F, TimestampQuery as De, Cache as je, EventDispatcher as ke, Timer as Ge, PerspectiveCamera as W, WebGPURenderer as Fe, PCFShadowMap as He, AgXToneMapping as ze, Scene as $e, Color as J, MeshStandardNodeMaterial as I, Loader as We, LoaderUtils as L, FileLoader as fe, TextureLoader as ye, Group as z, SRGBColorSpace as ve, RepeatWrapping as se, BufferGeometry as Qe, BufferAttribute as ne, Mesh as j, FrontSide as Ke, BackSide as Xe, DoubleSide as qe, REVISION as ie, CubeTextureLoader as Ye, EquirectangularReflectionMapping as Je, Sprite as Ze, SphereGeometry as Ve, TubeGeometry as et, LineCurve3 as tt, CatmullRomCurve3 as st, SpriteNodeMaterial as nt, CanvasTexture as it, ShapeGeometry as rt, Shape as be, ExtrudeGeometry as at, PlaneGeometry as ot, CircleGeometry as ct } from "three/webgpu";
-import { pass as q, blendColor as ht, color as A, uv as re, time as Q, pow as K, sin as ae, mix as X, mx_noise_float as oe, Fn as Te, userData as D, materialColor as ce, select as Y, materialOpacity as lt, vec3 as dt } from "three/tsl";
+import { Raycaster as me, Vector2 as P, RenderPipeline as Be, Sphere as ge, Box3 as we, Spherical as C, Matrix4 as Re, Quaternion as _e, Vector4 as Ne, Vector3 as J, MathUtils as Ae, PMREMGenerator as Ue, OrthographicCamera as F, TimestampQuery as De, Cache as je, EventDispatcher as ke, Timer as Ge, PerspectiveCamera as W, WebGPURenderer as Fe, PCFShadowMap as He, AgXToneMapping as ze, Scene as $e, Color as Z, MeshStandardNodeMaterial as I, Loader as We, LoaderUtils as L, FileLoader as fe, TextureLoader as ye, Group as z, SRGBColorSpace as ve, RepeatWrapping as ne, BufferGeometry as Qe, BufferAttribute as ie, Mesh as j, FrontSide as Ke, BackSide as Xe, DoubleSide as qe, REVISION as re, CubeTextureLoader as Ye, EquirectangularReflectionMapping as Je, Sprite as Ze, SphereGeometry as Ve, TubeGeometry as et, LineCurve3 as tt, CatmullRomCurve3 as st, SpriteNodeMaterial as nt, CanvasTexture as it, ShapeGeometry as rt, Shape as be, ExtrudeGeometry as at, PlaneGeometry as ot, CircleGeometry as ct } from "three/webgpu";
+import { pass as q, blendColor as ht, color as N, uv as ae, time as Q, pow as K, sin as oe, mix as X, mx_noise_float as ce, Fn as Te, userData as D, materialColor as he, select as Y, materialOpacity as lt, vec3 as dt } from "three/tsl";
 import Ce from "camera-controls";
 import { RoomEnvironment as pt } from "three/addons/environments/RoomEnvironment.js";
 import { ViewHelper as ut } from "three/addons/helpers/ViewHelper.js";
-import { GLTFLoader as Me } from "three/addons/loaders/GLTFLoader.js";
+import { GLTFLoader as xe } from "three/addons/loaders/GLTFLoader.js";
 import { FBXLoader as mt } from "three/addons/loaders/FBXLoader.js";
 import { OBJLoader as gt } from "three/addons/loaders/OBJLoader.js";
 import { STLLoader as wt } from "three/addons/loaders/STLLoader.js";
 import { DRACOLoader as ft } from "three/addons/loaders/DRACOLoader.js";
 import { KTX2Loader as yt } from "three/addons/loaders/KTX2Loader.js";
-import { MeshoptDecoder as he } from "three/addons/libs/meshopt_decoder.module.js";
+import { MeshoptDecoder as le } from "three/addons/libs/meshopt_decoder.module.js";
 import { HDRLoader as vt } from "three/addons/loaders/HDRLoader.js";
 import { clone as bt } from "three/addons/utils/SkeletonUtils.js";
-import { Color as N } from "three";
+import { Color as A } from "three";
 import { Easing as d, Tween as Tt } from "three/addons/libs/tween.module.js";
 class Ct {
   /** The type of event (e.g., 'click', 'pointerdown'). */
@@ -42,11 +42,11 @@ class Ct {
     return this._propagationStopped;
   }
 }
-class Mt {
+class xt {
   domElement;
   scene;
   camera;
-  raycaster = new ue();
+  raycaster = new me();
   pointer = new P();
   hoveredObject = null;
   pointerDownTime = 0;
@@ -55,17 +55,16 @@ class Mt {
   longPressThreshold = 500;
   moveThreshold = 0.01;
   /**
-   * The objects to check for intersections.
-   * If not set, it defaults to the children of the scene.
+   * The objects to check for intersections. default to all children of the scene (including nested).
    */
-  targetObjects = null;
+  targetObjects;
   /**
    * Whether to enable pointer move events (pointermove, pointerenter, pointerleave).
    * Disabled by default for performance optimization.
    */
   pointerMoveEventsEnabled = !1;
   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._bindEvents();
+    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();
   }
   /**
    * Updates the camera reference (useful when switching cameras).
@@ -81,9 +80,7 @@ class Mt {
     this.pointer.x = (e.clientX - t.left) / t.width * 2 - 1, this.pointer.y = -((e.clientY - t.top) / t.height) * 2 + 1;
   }
   _getIntersects() {
-    this.raycaster.setFromCamera(this.pointer, this.camera);
-    const e = this.targetObjects || this.scene.children;
-    return this.raycaster.intersectObjects(e, !0);
+    return this.raycaster.setFromCamera(this.pointer, this.camera), this.raycaster.intersectObjects(this.targetObjects, !0);
   }
   /**
    * Dispatches an event to the target object and bubbles up the parent chain.
@@ -125,12 +122,18 @@ class Mt {
     this.clickTimer && (clearTimeout(this.clickTimer), this.clickTimer = null), this._handleEvent("dblclick", e);
   };
   _onContextMenu = (e) => {
-    e.preventDefault(), this._handleEvent("contextmenu", e);
+    e.preventDefault();
   };
   _onPointerDown = (e) => {
     this.pointerDownTime = Date.now(), this._updatePointer(e), this.pointerDownPos.copy(this.pointer), this._handleEvent("pointerdown", e);
   };
-  _onPointerUp = (e) => this._handleEvent("pointerup", e);
+  _onPointerUp = (e) => {
+    if (this._updatePointer(e), e.button === 2) {
+      const t = Date.now() - this.pointerDownTime, s = this.pointer.distanceTo(this.pointerDownPos);
+      t <= this.longPressThreshold && s <= this.moveThreshold && this._handleEvent("rightclick", e);
+    }
+    this._handleEvent("pointerup", e);
+  };
   _onPointerMove = (e) => {
     if (!this.pointerMoveEventsEnabled) return;
     this._updatePointer(e);
@@ -144,7 +147,7 @@ class Mt {
     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;
   }
 }
-class xt {
+class Mt {
   idMap = /* @__PURE__ */ new Map();
   nameMap = /* @__PURE__ */ new Map();
   typeMap = /* @__PURE__ */ new Map();
@@ -284,14 +287,14 @@ class Et extends Be {
 }
 const Ot = {
   Vector2: P,
-  Vector3: we,
-  Vector4: Ae,
+  Vector3: J,
+  Vector4: Ne,
   Quaternion: _e,
   Matrix4: Re,
   Spherical: C,
-  Box3: ge,
-  Sphere: me,
-  Raycaster: ue
+  Box3: we,
+  Sphere: ge,
+  Raycaster: me
 };
 Ce.install({ THREE: Ot });
 class Pt extends Ce {
@@ -310,7 +313,7 @@ class Pt extends Ce {
     this.absoluteRotations();
     const { viewpoint: s = "frontTop", enableTransition: n = !0, padding: i = 0.1, cover: a = !1 } = t, c = [];
     if (s !== "current") {
-      const r = le[s.toUpperCase()] ?? le.FRONTTOP, h = r.theta, l = r.phi;
+      const r = de[s.toUpperCase()] ?? de.FRONTTOP, h = r.theta, l = r.phi;
       c.push(
         this.fitToBox(e, n, {
           paddingLeft: i,
@@ -321,17 +324,17 @@ class Pt extends Ce {
         })
       ), c.push(this.rotateTo(h, l, n));
     } else {
-      const r = new me();
+      const r = new ge();
       e.getBoundingSphere(r), r.radius += i, c.push(this.fitToSphere(r, n));
     }
     return await Promise.all(c), !0;
   }
   async flyToObject(e, t = {}) {
-    const s = new ge().setFromObject(e);
+    const s = new we().setFromObject(e);
     return this.flyToBox(s, t);
   }
 }
-const le = {
+const de = {
   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),
@@ -349,7 +352,7 @@ const le = {
 };
 function St(o, e) {
   const t = o - e;
-  return Ne.euclideanModulo(t + Math.PI, Math.PI * 2) - Math.PI;
+  return Ae.euclideanModulo(t + Math.PI, Math.PI * 2) - Math.PI;
 }
 class Lt {
   environment = new pt();
@@ -447,7 +450,7 @@ class ys extends ke {
   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 Bt(this.el, this.renderer), this.controls = new Pt(this.camera, this.renderer.domElement), this.renderPipeline = new Et(this.renderer, this.scene, this.camera), this.timer = new Ge(), this.roomEnvironment = new Lt(this.renderer), this.interactionManager = new Mt(this.renderer.domElement, this.scene, this.camera), this.objectManager = new xt(), this.viewerHelper = new It(this), 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 Bt(this.el, this.renderer), this.controls = new Pt(this.camera, this.renderer.domElement), this.renderPipeline = new Et(this.renderer, this.scene, this.camera), this.timer = new Ge(), this.roomEnvironment = new Lt(this.renderer), this.interactionManager = new xt(this.renderer.domElement, this.scene, this.camera), this.objectManager = new Mt(), this.viewerHelper = new It(this), window.addEventListener("resize", this.onWindowResize);
   }
   onWindowResize = () => {
     const e = this.el.clientWidth, t = this.el.clientHeight;
@@ -487,7 +490,7 @@ class ys extends ke {
   }
   createScene() {
     const e = new $e();
-    return e.background = new J(0), e;
+    return e.background = new Z(0), e;
   }
   createPerspectiveCamera() {
     const e = new W(50, this.el.clientWidth / this.el.clientHeight, 0.1, 1e5);
@@ -508,13 +511,13 @@ class ys extends ke {
     this.el.removeChild(this.renderer.domElement), window.removeEventListener("resize", this.onWindowResize), this.info.dispose(), this.interactionManager.dispose(), this.roomEnvironment.dispose(), this.renderPipeline.dispose(), this.renderer.dispose();
   }
 }
-class Rt extends Me {
+class Rt extends xe {
   constructor(e) {
     super(e);
   }
   parse(e, t, s, n) {
     if (_t(e.slice(0, 8)) === "SBMG----") {
-      const a = At(e.slice(8));
+      const a = Nt(e.slice(8));
       return super.parse(a, t, s, n);
     } else
       return super.parse(e, t, s, n);
@@ -523,7 +526,7 @@ class Rt extends Me {
 function _t(o) {
   return new TextDecoder().decode(new Uint8Array(o));
 }
-function At(o) {
+function Nt(o) {
   const e = new DataView(o);
   for (let t = 0; t < e.byteLength; t++) {
     const s = e.getUint8(t), n = (s >> 4 & 15) + (s << 4 & 240);
@@ -531,18 +534,18 @@ function At(o) {
   }
   return e.buffer;
 }
-const Nt = 8, Ut = 130, de = 66, Dt = "SBK-----", jt = "SBM-----", xe = new TextDecoder(), kt = new TextEncoder();
+const At = 8, Ut = 130, pe = 66, Dt = "SBK-----", jt = "SBM-----", Me = new TextDecoder(), kt = new TextEncoder();
 function Gt(o) {
-  let e = Nt;
+  let e = At;
   const t = new Uint8Array(o, 0, e);
-  if (xe.decode(t) !== Dt)
+  if (Me.decode(t) !== Dt)
     return o;
   e += Ut;
   const n = new Uint8Array(o, 0, e);
   if (n[40] === 1) {
     const a = kt.encode(jt), c = new Uint8Array([n[41]]), r = Ft(n), h = Ht(r);
-    let l = de % h.length;
-    const u = e + de, f = new Uint8Array(o, u), p = new Uint8Array(f.length);
+    let l = pe % h.length;
+    const u = e + pe, f = new Uint8Array(o, u), p = new Uint8Array(f.length);
     for (let w = 0; w < f.length; w++)
       p[w] = f[w] ^ h[l], l = (l + 1) % h.length;
     const g = new Uint8Array(a.length + c.length + p.length);
@@ -559,13 +562,13 @@ function Ht(o) {
 }
 const zt = (o, e, t) => {
   const s = o.buffer.slice(t, t + e);
-  let n = xe.decode(s);
+  let n = Me.decode(s);
   return n = n.replace("\\", "/"), n.startsWith("Maps/") || (n = `Maps/${n}`), n;
 }, $t = (o, e, t) => {
   const [s, n, i, a, c] = e, r = t || a < 1;
   return new I({
     name: o,
-    color: new J(s, n, i),
+    color: new Z(s, n, i),
     opacity: a,
     transparent: r,
     alphaTest: 0.01,
@@ -614,7 +617,7 @@ class Qt {
       if (t += g, !this.materials.has(r)) {
         const v = $t(r, [h, l, u, f, p], Wt(w));
         this.materials.set(r, v), w && this.options.path && this.textureLoader.load(L.resolveURL(w, this.options.path), (b) => {
-          b.colorSpace = ve, b.wrapS = se, b.wrapT = se, b.flipY = !1, b.anisotropy = 16, v.map = b;
+          b.colorSpace = ve, b.wrapS = ne, b.wrapT = ne, b.flipY = !1, b.anisotropy = 16, v.map = b;
         });
       }
     }
@@ -626,7 +629,7 @@ class Qt {
       const l = [], u = [], f = [], p = [], g = e.getUint16(t, this.littleEndian);
       if (t += 2, g > 0)
         for (let m = 0; m < g; m++) {
-          const y = new we();
+          const y = new J();
           y.setX(e.getFloat32(t, this.littleEndian)), t += 4, y.setY(e.getFloat32(t, this.littleEndian)), t += 4, y.setZ(e.getFloat32(t, this.littleEndian)), t += 4, l.push(y);
         }
       const w = e.getUint16(t, this.littleEndian);
@@ -651,16 +654,16 @@ class Qt {
           const O = [y, B, _];
           f.push(O), u.length > 0 && p.push([u[O[0]], u[O[1]], u[O[2]]]);
         }
-      const b = [], M = [];
+      const b = [], x = [];
       for (let m = 0; m < f.length; m++) {
         const y = f[m], B = l[y[0]], _ = l[y[1]], O = l[y[2]];
         b.push(...B.toArray(), ..._.toArray(), ...O.toArray());
-        let V = new P(), ee = new P(), te = new P();
+        let ee = new P(), te = new P(), se = new P();
         const k = p[m];
-        k !== void 0 && (V = k[0], ee = k[1], te = k[2]), M.push(...V.toArray(), ...ee.toArray(), ...te.toArray());
+        k !== void 0 && (ee = k[0], te = k[1], se = k[2]), x.push(...ee.toArray(), ...te.toArray(), ...se.toArray());
       }
-      const x = new Float32Array(b), E = new Float32Array(M), S = new Qe();
-      if (x.length > 0 && S.setAttribute("position", new ne(x, 3)), E.length > 0 && S.setAttribute("uv", new ne(E, 2)), S.computeVertexNormals(), this.materials.has(h)) {
+      const M = new Float32Array(b), E = new Float32Array(x), S = new Qe();
+      if (M.length > 0 && S.setAttribute("position", new ie(M, 3)), E.length > 0 && S.setAttribute("uv", new ie(E, 2)), S.computeVertexNormals(), this.materials.has(h)) {
         const m = new j(S, this.materials.get(h));
         m.name = r, m.castShadow = !0, m.receiveShadow = !0, n.add(m);
       }
@@ -738,13 +741,13 @@ class R {
   static CACHE_NAME = "u-space-model-loader-cache";
   static fileLoader = new fe().setResponseType("arraybuffer");
   static dracoLoader = new ft().setDecoderPath(
-    `https://cdn.jsdelivr.net/npm/three@0.${ie}.0/examples/jsm/libs/draco/`
+    `https://cdn.jsdelivr.net/npm/three@0.${re}.0/examples/jsm/libs/draco/`
   );
   static ktx2Loader = new yt().setTranscoderPath(
-    `https://cdn.jsdelivr.net/npm/three@0.${ie}.0/examples/jsm/libs/basis/`
+    `https://cdn.jsdelivr.net/npm/three@0.${re}.0/examples/jsm/libs/basis/`
   );
-  static gltfLoader = new Me().setDRACOLoader(R.dracoLoader).setKTX2Loader(R.ktx2Loader).setMeshoptDecoder(he);
-  static sbmxLoader = new Rt().setDRACOLoader(R.dracoLoader).setKTX2Loader(R.ktx2Loader).setMeshoptDecoder(he);
+  static gltfLoader = new xe().setDRACOLoader(R.dracoLoader).setKTX2Loader(R.ktx2Loader).setMeshoptDecoder(le);
+  static sbmxLoader = new Rt().setDRACOLoader(R.dracoLoader).setKTX2Loader(R.ktx2Loader).setMeshoptDecoder(le);
   static sbmLoader = new Kt();
   static fbxLoader = new mt();
   static objLoader = new gt();
@@ -896,7 +899,7 @@ class qt extends U {
     ), this.material = new I(t);
   }
 }
-class pe extends U {
+class ue extends U {
   isTubeMesh = !0;
   type = "TubeMesh";
   constructor({ geometryParameters: e, materialParameters: t } = {}) {
@@ -1035,7 +1038,7 @@ class bs extends Ee {
         t.add(c);
         const r = this.nodes.get(n), h = this.nodes.get(a);
         if (r && h) {
-          const l = new tt(r, h), u = new pe({
+          const l = new tt(r, h), u = new ue({
             geometryParameters: {
               path: l,
               tubularSegments: 1,
@@ -1062,7 +1065,7 @@ class bs extends Ee {
    */
   renderPath(e, t = this.parameters.pathColor) {
     if (e.length < 2) return;
-    const s = new st(e, !1, "catmullrom", 0), n = new pe({
+    const s = new st(e, !1, "catmullrom", 0), n = new ue({
       geometryParameters: {
         path: s,
         tubularSegments: e.length * 10,
@@ -1080,6 +1083,31 @@ class bs extends Ee {
       this.remove(e), e.geometry.dispose(), e.material.dispose();
     }), this.pathMeshes = [];
   }
+  /** Export nodes and edges as a JSON-serializable object. */
+  exportData() {
+    const e = {};
+    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((n, i) => {
+      n.forEach((a, c) => {
+        const r = [i, c].sort().join("-");
+        s.has(r) || (s.add(r), t.push({ from: i, to: c, weight: a }));
+      });
+    }), { nodes: e, edges: t };
+  }
+  /**
+   * Load topology from a previously exported data object.
+   * Replaces all current nodes, edges, and path meshes, then re-renders the graph.
+   */
+  importData(e) {
+    this.clearGraph(), this.clearPaths(), this.nodes.clear(), this.adjacencyMap.clear(), Object.entries(e.nodes).forEach(([t, s]) => {
+      this.addNode(t, new J(s.x, s.y, s.z));
+    }), e.edges.forEach(({ from: t, to: s, weight: n }) => {
+      this.addEdge(t, s, n);
+    }), this.renderGraph();
+  }
   dispose() {
     this.clearGraph(), this.clearPaths();
   }
@@ -1117,26 +1145,26 @@ class Ts extends Xt {
     let n = null;
     this.parameters.img && (n = await this._loadImage(this.parameters.img));
     const { text: i, fontSize: a, color: c, iconSize: r, padding: h, backgroundColor: l, borderRadius: u, textPosition: f } = this.parameters, p = s.measureText(i), g = i ? p.width : 0, w = i ? a : 0;
-    let T = 0, v = 0, b = 0, M = 0, x = 0, E = 0;
+    let T = 0, v = 0, b = 0, x = 0, M = 0, E = 0;
     const S = !!n, m = !!i;
     if (S && m)
       switch (f) {
         case "top":
-          T = Math.max(r, g), v = r + h + w, x = (T - g) / 2, E = w / 2, b = (T - r) / 2, M = w + h;
+          T = Math.max(r, g), v = r + h + w, M = (T - g) / 2, E = w / 2, b = (T - r) / 2, x = w + h;
           break;
         case "bottom":
-          T = Math.max(r, g), v = r + h + w, b = (T - r) / 2, M = 0, x = (T - g) / 2, E = r + h + w / 2;
+          T = Math.max(r, g), v = r + h + w, b = (T - r) / 2, x = 0, M = (T - g) / 2, E = r + h + w / 2;
           break;
         case "left":
-          T = r + h + g, v = Math.max(r, w), x = 0, E = v / 2, b = g + h, M = (v - r) / 2;
+          T = r + h + g, v = Math.max(r, w), M = 0, E = v / 2, b = g + h, x = (v - r) / 2;
           break;
         default:
-          T = r + h + g, v = Math.max(r, w), b = 0, M = (v - r) / 2, x = r + h, E = v / 2;
+          T = r + h + g, v = Math.max(r, w), b = 0, x = (v - r) / 2, M = r + h, E = v / 2;
           break;
       }
-    else S ? (T = r, v = r, b = 0, M = 0) : m && (T = g, v = w, x = 0, E = w / 2);
+    else S ? (T = r, v = r, b = 0, x = 0) : m && (T = g, v = w, M = 0, E = w / 2);
     const y = T + h * 2, B = v + h * 2;
-    t.width = y, t.height = B, s.font = `${a}px ${this.parameters.fontFamily}`, s.textBaseline = "middle", l && (s.fillStyle = l, this._drawRoundedRect(s, 0, 0, y, B, u), s.fill()), S && s.drawImage(n, b + h, M + h, r, r), m && (s.fillStyle = c, s.fillText(i, x + h, E + h)), this.material.map?.dispose();
+    t.width = y, t.height = B, s.font = `${a}px ${this.parameters.fontFamily}`, s.textBaseline = "middle", l && (s.fillStyle = l, this._drawRoundedRect(s, 0, 0, y, B, u), s.fill()), S && s.drawImage(n, b + h, x + h, r, r), m && (s.fillStyle = c, s.fillText(i, M + h, E + h)), this.material.map?.dispose();
     const _ = new it(t);
     _.colorSpace = ve, this.material.map = _;
     const O = 0.01;
@@ -1202,7 +1230,7 @@ class Cs extends U {
     ), this.material = new I(t);
   }
 }
-class Ms extends U {
+class xs extends U {
   isCircleMesh = !0;
   type = "CircleMesh";
   constructor({ geometryParameters: e, materialParameters: t } = {}) {
@@ -1224,13 +1252,13 @@ class Yt {
     });
   }
 }
-class xs {
+class Ms {
   static flow(e = {}) {
-    const { baseColor: t = 16777215, flowColor: s = 65280, speed: n = 1, scale: i = 3, intensity: a = 4 } = e, c = A(new N(t)), r = A(new N(s)), h = re().x.mul(i).sub(Q.mul(n)), l = K(ae(h).add(1).mul(0.5), a);
+    const { baseColor: t = 16777215, flowColor: s = 65280, speed: n = 1, scale: i = 3, intensity: a = 4 } = e, c = N(new A(t)), r = N(new A(s)), h = ae().x.mul(i).sub(Q.mul(n)), l = K(oe(h).add(1).mul(0.5), a);
     return X(c, r, l);
   }
   static breathe(e = {}) {
-    const { baseColor: t = 16777215, breathColor: s = 65280, speed: n = 1, intensity: i = 2 } = e, a = A(new N(t)), c = A(new N(s)), r = ae(Q.mul(n)).add(1).mul(0.5), h = K(r, i);
+    const { baseColor: t = 16777215, breathColor: s = 65280, speed: n = 1, intensity: i = 2 } = e, a = N(new A(t)), c = N(new A(s)), r = oe(Q.mul(n)).add(1).mul(0.5), h = K(r, i);
     return X(a, c, h);
   }
   static fluid(e = {}) {
@@ -1241,17 +1269,17 @@ class xs {
       scale: i = 1,
       intensity: a = 1,
       distortion: c = 0.5
-    } = e, r = A(new N(t)), h = A(new N(s)), l = re().mul(i), u = Q.mul(n), f = oe(l.add(u), 1, 0), p = l.add(f.mul(c)), g = oe(p, 1, 0).add(1).mul(0.5), w = K(g, a);
+    } = e, r = N(new A(t)), h = N(new A(s)), l = ae().mul(i), u = Q.mul(n), f = ce(l.add(u), 1, 0), p = l.add(f.mul(c)), g = ce(p, 1, 0).add(1).mul(0.5), w = K(g, a);
     return X(r, h, w);
   }
 }
 function Es(o) {
 }
-const $ = "uSpaceHighlight", Z = `${$}/enabled`, Se = `${$}/opacity`, Le = `${$}/color`, Ie = `${$}/overwrite`, Jt = Te(() => {
-  const o = D(Z, "uint"), e = D(Le, "uint"), t = D(Ie, "uint"), s = Vt(e), n = ce.mul(s), i = Y(t.greaterThan(0), s, n);
-  return Y(o.greaterThan(0), i, ce);
+const $ = "uSpaceHighlight", V = `${$}/enabled`, Se = `${$}/opacity`, Le = `${$}/color`, Ie = `${$}/overwrite`, Jt = Te(() => {
+  const o = D(V, "uint"), e = D(Le, "uint"), t = D(Ie, "uint"), s = Vt(e), n = he.mul(s), i = Y(t.greaterThan(0), s, n);
+  return Y(o.greaterThan(0), i, he);
 })(), Zt = Te(() => {
-  const o = D(Z, "uint"), e = D(Se, "float");
+  const o = D(V, "uint"), e = D(Se, "float");
   return Y(o.greaterThan(0), e, lt);
 })();
 class Os {
@@ -1265,8 +1293,8 @@ class Os {
       },
       t
     );
-    s.color = new J(s.color).getHex(), Yt.traverseMeshes(e, (n) => {
-      n.userData[Z] = s.enabled ? 1 : 0, n.userData[Se] = s.opacity, n.userData[Le] = s.color, n.userData[Ie] = s.overwrite ? 1 : 0;
+    s.color = new Z(s.color).getHex(), Yt.traverseMeshes(e, (n) => {
+      n.userData[V] = s.enabled ? 1 : 0, n.userData[Se] = s.opacity, n.userData[Le] = s.color, n.userData[Ie] = s.overwrite ? 1 : 0;
       const i = n.material;
       i && !Array.isArray(i) && (i.transparent = !0, i.colorNode = Jt, i.opacityNode = Zt, i.needsUpdate = !0);
     });
@@ -1347,14 +1375,14 @@ export {
   U as BaseMesh,
   Xt as BaseSprite,
   Pt as CameraControls,
-  Ms as CircleMesh,
+  xs as CircleMesh,
   Pe as ExtrudeMesh,
   Ct as InteractionEvent,
-  Mt as InteractionManager,
+  xt as InteractionManager,
   Os as MaterialEffects,
   H as Model,
   R as ModelLoaderManager,
-  xt as ObjectManager,
+  Mt as ObjectManager,
   Yt as ObjectUtils,
   Cs as PlaneMesh,
   Ts as Poi,
@@ -1363,10 +1391,10 @@ export {
   Rt as SBMXLoader,
   Oe as ShapeMesh,
   qt as SphereMesh,
-  xs as TSLEffects,
+  Ms as TSLEffects,
   vs as TextureLoaderManager,
   bs as Topology,
-  pe as TubeMesh,
+  ue as TubeMesh,
   es as Tween,
   ys as Viewer,
   Es as reinterpretType,

package/dist/plugins/object-controls/ObjectControls.d.ts

@@ -0,0 +1,69 @@
+import { TransformControls } from 'three/addons/controls/TransformControls.js';
+import type { Viewer } from 'u-space';
+export interface ObjectControlsOptions {
+    /** Transform mode. Default: 'translate' */
+    mode?: 'translate' | 'rotate' | 'scale';
+    /** Transform space. Default: 'world' */
+    space?: 'world' | 'local';
+    /** Gizmo size. Default: 1 */
+    size?: number;
+    /** Show X axis handle. Default: true */
+    showX?: boolean;
+    /** Show Y axis handle. Default: true */
+    showY?: boolean;
+    /** Show Z axis handle. Default: true */
+    showZ?: boolean;
+}
+/**
+ * Interactive plugin for translating, rotating, and scaling 3D objects.
+ *
+ * Extends Three.js `TransformControls` with the u-space `Viewer` lifecycle:
+ * - `enable()` adds the gizmo to the scene and switches frameloop to 'always'.
+ * - `disable()` removes the gizmo and restores previous state.
+ * - While dragging, `viewer.controls` (CameraControls) is automatically
+ *   suspended to prevent conflicts.
+ *
+ * Since this class extends `TransformControls` (→ `Controls` → `EventDispatcher`),
+ * all native TransformControls events are available:
+ *   - `'change'`           : Any transform property changed (fires every frame while dragging).
+ *   - `'objectChange'`     : The attached object's matrix was updated.
+ *   - `'mouseDown'`        : Drag started.
+ *   - `'mouseUp'`          : Drag ended.
+ *   - `'dragging-changed'` : `{ value: boolean }` — true when drag begins, false when it ends.
+ *
+ * @example
+ * ```typescript
+ * const controls = new ObjectControls(viewer, { mode: 'translate' });
+ * controls.enable();
+ * controls.attach(myMesh);
+ *
+ * controls.addEventListener('objectChange', () => {
+ *   console.log(myMesh.position);
+ * });
+ * ```
+ */
+declare class ObjectControls extends TransformControls {
+    viewer: Viewer;
+    private _active;
+    private _prevFrameloop;
+    constructor(viewer: Viewer, options?: ObjectControlsOptions);
+    private _onDraggingChanged;
+    private _onCameraChange;
+    /** Whether the controls are currently active (added to the scene). */
+    get isActive(): boolean;
+    /**
+     * Enable the controls.
+     * Adds the gizmo helper to the scene and switches frameloop to 'always'
+     * so drags render continuously.
+     */
+    enable(): this;
+    /**
+     * Disable the controls.
+     * Removes the gizmo from the scene and restores the previous frameloop.
+     * Re-enables CameraControls in case they were suspended mid-drag.
+     */
+    disable(): this;
+    /** Fully dispose all resources and remove the gizmo from the scene. */
+    dispose(): void;
+}
+export { ObjectControls };

package/dist/plugins/object-controls/index.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("three/addons/controls/TransformControls.js");class s extends r.TransformControls{viewer;_active=!1;_prevFrameloop="demand";constructor(i,e){super(i.camera,i.renderer.domElement),this.viewer=i,e?.mode!==void 0&&(this.mode=e.mode),e?.space!==void 0&&(this.space=e.space),e?.size!==void 0&&(this.size=e.size),e?.showX!==void 0&&(this.showX=e.showX),e?.showY!==void 0&&(this.showY=e.showY),e?.showZ!==void 0&&(this.showZ=e.showZ),this.addEventListener("dragging-changed",this._onDraggingChanged),this.viewer.addEventListener("cameraChange",this._onCameraChange)}_onDraggingChanged=i=>{this.viewer.controls.enabled=!i.value};_onCameraChange=({camera:i})=>{this.camera=i};get isActive(){return this._active}enable(){return this._active?this:(this._active=!0,this._prevFrameloop=this.viewer.frameloop,this.viewer.frameloop="always",this.viewer.scene.add(this.getHelper()),this.viewer.render(),this)}disable(){return this._active?(this._active=!1,this.viewer.frameloop=this._prevFrameloop,this.viewer.scene.remove(this.getHelper()),this.viewer.controls.enabled=!0,this.viewer.render(),this):this}dispose(){this.disable(),this.removeEventListener("dragging-changed",this._onDraggingChanged),this.viewer.removeEventListener("cameraChange",this._onCameraChange),super.dispose()}}exports.ObjectControls=s;

package/dist/plugins/object-controls/index.d.ts

@@ -0,0 +1 @@
+export * from './ObjectControls';

package/dist/plugins/object-controls/index.js

@@ -0,0 +1,44 @@
+import { TransformControls as r } from "three/addons/controls/TransformControls.js";
+class a extends r {
+  viewer;
+  _active = !1;
+  _prevFrameloop = "demand";
+  constructor(i, e) {
+    super(i.camera, i.renderer.domElement), this.viewer = i, e?.mode !== void 0 && (this.mode = e.mode), e?.space !== void 0 && (this.space = e.space), e?.size !== void 0 && (this.size = e.size), e?.showX !== void 0 && (this.showX = e.showX), e?.showY !== void 0 && (this.showY = e.showY), e?.showZ !== void 0 && (this.showZ = e.showZ), this.addEventListener("dragging-changed", this._onDraggingChanged), this.viewer.addEventListener("cameraChange", this._onCameraChange);
+  }
+  // ─── Private handlers ─────────────────────────────────────────────────────
+  _onDraggingChanged = (i) => {
+    this.viewer.controls.enabled = !i.value;
+  };
+  _onCameraChange = ({ camera: i }) => {
+    this.camera = i;
+  };
+  // ─── Public API ───────────────────────────────────────────────────────────
+  /** Whether the controls are currently active (added to the scene). */
+  get isActive() {
+    return this._active;
+  }
+  /**
+   * Enable the controls.
+   * Adds the gizmo helper to the scene and switches frameloop to 'always'
+   * so drags render continuously.
+   */
+  enable() {
+    return this._active ? this : (this._active = !0, this._prevFrameloop = this.viewer.frameloop, this.viewer.frameloop = "always", this.viewer.scene.add(this.getHelper()), this.viewer.render(), this);
+  }
+  /**
+   * Disable the controls.
+   * Removes the gizmo from the scene and restores the previous frameloop.
+   * Re-enables CameraControls in case they were suspended mid-drag.
+   */
+  disable() {
+    return this._active ? (this._active = !1, this.viewer.frameloop = this._prevFrameloop, this.viewer.scene.remove(this.getHelper()), this.viewer.controls.enabled = !0, this.viewer.render(), this) : this;
+  }
+  /** Fully dispose all resources and remove the gizmo from the scene. */
+  dispose() {
+    this.disable(), this.removeEventListener("dragging-changed", this._onDraggingChanged), this.viewer.removeEventListener("cameraChange", this._onCameraChange), super.dispose();
+  }
+}
+export {
+  a as ObjectControls
+};