@thatopen/components 2.0.9 → 2.0.10

package/dist/index.mjs

@@ -1,8 +1,8 @@
 var Wn = Object.defineProperty;
 var Xn = (l, s, t) => s in l ? Wn(l, s, { enumerable: !0, configurable: !0, writable: !0, value: t }) : l[s] = t;
 var I = (l, s, t) => (Xn(l, typeof s != "symbol" ? s + "" : s, t), t);
-import * as g from "three";
-import { BufferAttribute as Ln, Vector3 as w, Vector2 as pe, Plane as Fi, Line3 as Lt, Triangle as Ie, Sphere as Zn, Matrix4 as yt, Box3 as Ot, BackSide as Qn, DoubleSide as yn, FrontSide as Di, Mesh as v, Ray as jn, Raycaster as qn, Quaternion as Pt, Object3D as ri, Euler as $n, MeshBasicMaterial as wn, LineBasicMaterial as Kn, CylinderGeometry as ct, BoxGeometry as rt, BufferGeometry as Ui, Float32BufferAttribute as xi, OctahedronGeometry as Qe, Line as Dt, SphereGeometry as Jn, TorusGeometry as Re, PlaneGeometry as to } from "three";
+import * as O from "three";
+import { BufferAttribute as Ln, Vector3 as w, Vector2 as pe, Plane as Fi, Line3 as Lt, Triangle as Ie, Sphere as Zn, Matrix4 as yt, Box3 as gt, BackSide as Qn, DoubleSide as yn, FrontSide as Di, Mesh as v, Ray as jn, Raycaster as qn, Quaternion as Pt, Object3D as ri, Euler as $n, MeshBasicMaterial as wn, LineBasicMaterial as Kn, CylinderGeometry as ct, BoxGeometry as rt, BufferGeometry as Ui, Float32BufferAttribute as xi, OctahedronGeometry as Qe, Line as Dt, SphereGeometry as Jn, TorusGeometry as Re, PlaneGeometry as to } from "three";
 import * as Vt from "@thatopen/fragments";
 import { Serializer as eo } from "@thatopen/fragments";
 import * as U from "web-ifc";
@@ -95,8 +95,8 @@ function Gs(l, s, t, e, i = null) {
   let o = 1 / 0, n = 1 / 0, r = 1 / 0, a = -1 / 0, c = -1 / 0, h = -1 / 0, d = 1 / 0, E = 1 / 0, u = 1 / 0, p = -1 / 0, A = -1 / 0, m = -1 / 0;
   const C = i !== null;
   for (let R = s * 6, F = (s + t) * 6; R < F; R += 6) {
-    const f = l[R + 0], T = l[R + 1], O = f - T, S = f + T;
-    O < o && (o = O), S > a && (a = S), C && f < d && (d = f), C && f > p && (p = f);
+    const f = l[R + 0], T = l[R + 1], g = f - T, S = f + T;
+    g < o && (o = g), S > a && (a = S), C && f < d && (d = f), C && f > p && (p = f);
     const _ = l[R + 2], N = l[R + 3], L = _ - N, M = _ + N;
     L < n && (n = L), M > c && (c = M), C && _ < E && (E = _), C && _ > A && (A = _);
     const y = l[R + 4], x = l[R + 5], b = y - x, B = y + x;
@@ -131,10 +131,10 @@ function Eo(l, s) {
       n ? (R = t[h[C]](p), F = t[h[C]](A), f = t[h[C]](m)) : (R = r[p + C], F = r[A + C], f = r[m + C]);
       let T = R;
       F < T && (T = F), f < T && (T = f);
-      let O = R;
-      F > O && (O = F), f > O && (O = f);
-      const S = (O - T) / 2, _ = C * 2;
-      o[u + _ + 0] = T + S, o[u + _ + 1] = S + (Math.abs(T) + S) * no, T < s[C] && (s[C] = T), O > s[C + 3] && (s[C + 3] = O);
+      let g = R;
+      F > g && (g = F), f > g && (g = f);
+      const S = (g - T) / 2, _ = C * 2;
+      o[u + _ + 0] = T + S, o[u + _ + 1] = S + (Math.abs(T) + S) * no, T < s[C] && (s[C] = T), g > s[C + 3] && (s[C + 3] = g);
     }
   }
   return o;
@@ -166,13 +166,13 @@ function Io(l, s, t, e, i, o) {
           const T = C[R];
           T.candidate = t[f + 2 * E], T.count = 0;
           const {
-            bounds: O,
+            bounds: g,
             leftCacheBounds: S,
             rightCacheBounds: _
           } = T;
           for (let N = 0; N < 3; N++)
-            _[N] = 1 / 0, _[N + 3] = -1 / 0, S[N] = 1 / 0, S[N + 3] = -1 / 0, O[N] = 1 / 0, O[N + 3] = -1 / 0;
-          je(f, t, O);
+            _[N] = 1 / 0, _[N + 3] = -1 / 0, S[N] = 1 / 0, S[N + 3] = -1 / 0, g[N] = 1 / 0, g[N + 3] = -1 / 0;
+          je(f, t, g);
         }
         C.sort(uo);
         let F = i;
@@ -183,18 +183,18 @@ function Io(l, s, t, e, i, o) {
         }
         for (let f = h; f < d; f += 6) {
           const T = t[f + 2 * E];
-          for (let O = 0; O < F; O++) {
-            const S = C[O];
+          for (let g = 0; g < F; g++) {
+            const S = C[g];
             T >= S.candidate ? je(f, t, S.rightCacheBounds) : (je(f, t, S.leftCacheBounds), S.count++);
           }
         }
         for (let f = 0; f < F; f++) {
-          const T = C[f], O = T.count, S = i - T.count, _ = T.leftCacheBounds, N = T.rightCacheBounds;
+          const T = C[f], g = T.count, S = i - T.count, _ = T.leftCacheBounds, N = T.rightCacheBounds;
           let L = 0;
-          O !== 0 && (L = Ae(_) / a);
+          g !== 0 && (L = Ae(_) / a);
           let M = 0;
           S !== 0 && (M = Ae(N) / a);
-          const y = vi + Ys * (L * O + M * S);
+          const y = vi + Ys * (L * g + M * S);
           y < c && (n = E, c = y, r = T.candidate);
         }
       } else {
@@ -202,13 +202,13 @@ function Io(l, s, t, e, i, o) {
           const f = Ut[F];
           f.count = 0, f.candidate = u + m + F * m;
           const T = f.bounds;
-          for (let O = 0; O < 3; O++)
-            T[O] = 1 / 0, T[O + 3] = -1 / 0;
+          for (let g = 0; g < 3; g++)
+            T[g] = 1 / 0, T[g + 3] = -1 / 0;
         }
         for (let F = h; F < d; F += 6) {
-          let O = ~~((t[F + 2 * E] - u) / m);
-          O >= wt && (O = wt - 1);
-          const S = Ut[O];
+          let g = ~~((t[F + 2 * E] - u) / m);
+          g >= wt && (g = wt - 1);
+          const S = Ut[g];
           S.count++, je(F, t, S.bounds);
         }
         const C = Ut[wt - 1];
@@ -219,8 +219,8 @@ function Io(l, s, t, e, i, o) {
         }
         let R = 0;
         for (let F = 0; F < wt - 1; F++) {
-          const f = Ut[F], T = f.count, O = f.bounds, _ = Ut[F + 1].rightCacheBounds;
-          T !== 0 && (R === 0 ? Yi(O, qe) : Vi(O, qe, qe)), R += T;
+          const f = Ut[F], T = f.count, g = f.bounds, _ = Ut[F + 1].rightCacheBounds;
+          T !== 0 && (R === 0 ? Yi(g, qe) : Vi(g, qe, qe)), R += T;
           let N = 0, L = 0;
           R !== 0 && (N = Ae(qe) / a);
           const M = i - R;
@@ -308,20 +308,20 @@ function mo(l, s) {
   function R(f) {
     a && a(f / c);
   }
-  function F(f, T, O, S = null, _ = 0) {
-    if (!d && _ >= i && (d = !0, o && (console.warn(`MeshBVH: Max depth of ${i} reached when generating BVH. Consider increasing maxDepth.`), console.warn(t))), O <= n || _ >= i)
-      return R(T + O), f.offset = T, f.count = O, f;
-    const N = Io(f.boundingData, S, p, T, O, r);
+  function F(f, T, g, S = null, _ = 0) {
+    if (!d && _ >= i && (d = !0, o && (console.warn(`MeshBVH: Max depth of ${i} reached when generating BVH. Consider increasing maxDepth.`), console.warn(t))), g <= n || _ >= i)
+      return R(T + g), f.offset = T, f.count = g, f;
+    const N = Io(f.boundingData, S, p, T, g, r);
     if (N.axis === -1)
-      return R(T + O), f.offset = T, f.count = O, f;
-    const L = A(h, e, p, T, O, N);
-    if (L === T || L === T + O)
-      R(T + O), f.offset = T, f.count = O;
+      return R(T + g), f.offset = T, f.count = g, f;
+    const L = A(h, e, p, T, g, N);
+    if (L === T || L === T + g)
+      R(T + g), f.offset = T, f.count = g;
     else {
       f.splitAxis = N.axis;
       const M = new $e(), y = T, x = L - T;
       f.left = M, M.boundingData = new Float32Array(6), Gs(p, y, x, M.boundingData, u), F(M, y, x, u, _ + 1);
-      const b = new $e(), B = L, H = O - x;
+      const b = new $e(), B = L, H = g - x;
       f.right = b, b.boundingData = new Float32Array(6), Gs(p, B, H, b.boundingData, u), F(b, B, H, u, _ + 1);
     }
     return f;
@@ -410,7 +410,7 @@ const Ao = function() {
     let C, R;
     m !== 0 ? C = (d * E - p * u) / m : C = 0, R = (d + C * E) / u, n.x = C, n.y = R;
   };
-}(), Oi = function() {
+}(), gi = function() {
   const l = new pe(), s = new w(), t = new w();
   return function(i, o, n, r) {
     Ao(i, o, l);
@@ -453,9 +453,9 @@ const Ao = function() {
     }
     return !1;
   };
-}(), Oo = 1e-15;
+}(), go = 1e-15;
 function zs(l) {
-  return Math.abs(l) < Oo;
+  return Math.abs(l) < go;
 }
 class Ft extends Ie {
   constructor(...s) {
@@ -482,7 +482,7 @@ Ft.prototype.closestPointToSegment = function() {
     let h, d = 1 / 0;
     for (let E = 0; E < 3; E++) {
       const u = (E + 1) % 3;
-      t.start.copy(c[E]), t.end.copy(c[u]), Oi(t, i, l, s), h = l.distanceToSquared(s), h < d && (d = h, o && o.copy(l), n && n.copy(s));
+      t.start.copy(c[E]), t.end.copy(c[u]), gi(t, i, l, s), h = l.distanceToSquared(s), h < d && (d = h, o && o.copy(l), n && n.copy(s));
     }
     return this.closestPointToPoint(r, l), h = r.distanceToSquared(l), h < d && (d = h, o && o.copy(l), n && n.copy(r)), this.closestPointToPoint(a, l), h = a.distanceToSquared(l), h < d && (d = h, o && o.copy(l), n && n.copy(a)), Math.sqrt(d);
   };
@@ -493,15 +493,15 @@ Ft.prototype.intersectsTriangle = function() {
     const R = A.points;
     let F = 0, f = -1;
     for (let T = 0; T < 3; T++) {
-      const { start: O, end: S } = h;
-      O.copy(R[T]), S.copy(R[(T + 1) % 3]), h.delta(n);
-      const _ = zs(m.distanceToPoint(O));
+      const { start: g, end: S } = h;
+      g.copy(R[T]), S.copy(R[(T + 1) % 3]), h.delta(n);
+      const _ = zs(m.distanceToPoint(g));
       if (zs(m.normal.dot(n)) && _) {
         C.copy(h), F = 2;
         break;
       }
       const N = m.intersectLine(h, u);
-      if (!N && _ && u.copy(O), (N || _) && !zs(u.distanceTo(S))) {
+      if (!N && _ && u.copy(g), (N || _) && !zs(u.distanceTo(S))) {
         if (F <= 1)
           (F === 1 ? C.start : C.end).copy(u), _ && (f = F);
         else if (F >= 2) {
@@ -518,10 +518,10 @@ Ft.prototype.intersectsTriangle = function() {
     this.needsUpdate && this.update(), m.isExtendedTriangle ? m.needsUpdate && m.update() : (l.copy(m), l.update(), m = l);
     const F = this.plane, f = m.plane;
     if (Math.abs(F.normal.dot(f.normal)) > 1 - 1e-10) {
-      const T = this.satBounds, O = this.satAxes;
+      const T = this.satBounds, g = this.satAxes;
       t[0] = m.a, t[1] = m.b, t[2] = m.c;
       for (let N = 0; N < 4; N++) {
-        const L = T[N], M = O[N];
+        const L = T[N], M = g[N];
         if (e.setFromPoints(M, t), L.isSeparated(e))
           return !1;
       }
@@ -533,7 +533,7 @@ Ft.prototype.intersectsTriangle = function() {
           return !1;
       }
       for (let N = 0; N < 4; N++) {
-        const L = O[N];
+        const L = g[N];
         for (let M = 0; M < 4; M++) {
           const y = _[M];
           if (o.crossVectors(L, y), e.setFromPoints(o, s), i.setFromPoints(o, t), e.isSeparated(i))
@@ -547,10 +547,10 @@ Ft.prototype.intersectsTriangle = function() {
         return C && (C.start.copy(d.end), C.end.copy(d.end)), !0;
       if (T !== 2)
         return !1;
-      const O = p(m, F, E);
-      if (O === 1 && this.containsPoint(E.end))
+      const g = p(m, F, E);
+      if (g === 1 && this.containsPoint(E.end))
         return C && (C.start.copy(E.end), C.end.copy(E.end)), !0;
-      if (O !== 2)
+      if (g !== 2)
         return !1;
       if (d.delta(r), E.delta(a), r.dot(a) < 0) {
         let x = E.start;
@@ -586,7 +586,7 @@ Ft.prototype.distanceToTriangle = function() {
       e.set(this[E], this[u]);
       for (let p = 0; p < 3; p++) {
         const A = t[p], m = t[(p + 1) % 3];
-        i.set(n[A], n[m]), Oi(e, i, l, s);
+        i.set(n[A], n[m]), gi(e, i, l, s);
         const C = l.distanceToSquared(s);
         C < h && (h = C, r && r.copy(l), a && a.copy(s));
       }
@@ -695,7 +695,7 @@ at.prototype.distanceToBox = function() {
     for (let m = 0; m < 3; m++)
       for (let C = 0; C <= 1; C++)
         for (let R = 0; R <= 1; R++) {
-          const F = (m + 1) % 3, f = (m + 2) % 3, T = C << F | R << f, O = 1 << m | C << F | R << f, S = u[T], _ = u[O];
+          const F = (m + 1) % 3, f = (m + 2) % 3, T = C << F | R << f, g = 1 << m | C << F | R << f, S = u[T], _ = u[g];
           s[A].set(S, _);
           const L = l[m], M = l[F], y = l[f], x = t[A], b = x.start, B = x.end;
           b[L] = d[L], b[M] = C ? d[M] : E[M], b[y] = R ? d[y] : E[M], B[L] = E[L], B[M] = C ? d[M] : E[M], B[y] = R ? d[y] : E[M], A++;
@@ -712,7 +712,7 @@ at.prototype.distanceToBox = function() {
       const C = s[m];
       for (let R = 0; R < 12; R++) {
         const F = t[R];
-        Oi(C, F, e, i);
+        gi(C, F, e, i);
         const f = e.distanceToSquared(i);
         if (f < p && (p = f, a && a.copy(e), c && c.copy(i), f < h))
           return Math.sqrt(f);
@@ -721,7 +721,7 @@ at.prototype.distanceToBox = function() {
     return Math.sqrt(p);
   };
 }();
-class gi {
+class Oi {
   constructor(s) {
     this._getNewPrimitive = s, this._primitives = [];
   }
@@ -733,12 +733,12 @@ class gi {
     this._primitives.push(s);
   }
 }
-class go extends gi {
+class Oo extends Oi {
   constructor() {
     super(() => new Ft());
   }
 }
-const It = /* @__PURE__ */ new go();
+const It = /* @__PURE__ */ new Oo();
 function ht(l, s) {
   return s[l + 15] === 65535;
 }
@@ -771,7 +771,7 @@ class So {
 }
 const Z = new So();
 let Yt, fe;
-const te = [], Ke = /* @__PURE__ */ new gi(() => new Ot());
+const te = [], Ke = /* @__PURE__ */ new Oi(() => new gt());
 function _o(l, s, t, e, i, o) {
   Yt = Ke.getPrimitive(), fe = Ke.getPrimitive(), te.push(Yt, fe), Z.setBuffer(l._roots[s]);
   const n = ai(0, l.geometry, t, e, i, o);
@@ -808,12 +808,12 @@ function ai(l, s, t, e, i = null, o = 0, n = 0) {
     }
     R || (R = Yt, $(p, r, R));
     const f = ht(p * 2, a), T = t(R, f, m, n + 1, o + p);
-    let O;
+    let g;
     if (T === bi) {
       const y = L(p), b = M(p) - y;
-      O = e(y, b, !0, n + 1, o + p, R);
+      g = e(y, b, !0, n + 1, o + p, R);
     } else
-      O = T && ai(
+      g = T && ai(
         p,
         s,
         t,
@@ -822,7 +822,7 @@ function ai(l, s, t, e, i = null, o = 0, n = 0) {
         o,
         n + 1
       );
-    if (O)
+    if (g)
       return !0;
     F = fe, $(A, r, F);
     const S = ht(A * 2, a), _ = t(F, S, C, n + 1, o + A);
@@ -933,18 +933,18 @@ function Do(l, s = null) {
     const A = E * 2;
     if (r[A + 15] === Us) {
       const C = n[E + 6], R = r[A + 14];
-      let F = 1 / 0, f = 1 / 0, T = 1 / 0, O = -1 / 0, S = -1 / 0, _ = -1 / 0;
+      let F = 1 / 0, f = 1 / 0, T = 1 / 0, g = -1 / 0, S = -1 / 0, _ = -1 / 0;
       for (let N = 3 * C, L = 3 * (C + R); N < L; N++) {
         let M = e[N];
         const y = i.getX(M), x = i.getY(M), b = i.getZ(M);
-        y < F && (F = y), y > O && (O = y), x < f && (f = x), x > S && (S = x), b < T && (T = b), b > _ && (_ = b);
+        y < F && (F = y), y > g && (g = y), x < f && (f = x), x > S && (S = x), b < T && (T = b), b > _ && (_ = b);
       }
-      return a[E + 0] !== F || a[E + 1] !== f || a[E + 2] !== T || a[E + 3] !== O || a[E + 4] !== S || a[E + 5] !== _ ? (a[E + 0] = F, a[E + 1] = f, a[E + 2] = T, a[E + 3] = O, a[E + 4] = S, a[E + 5] = _, !0) : !1;
+      return a[E + 0] !== F || a[E + 1] !== f || a[E + 2] !== T || a[E + 3] !== g || a[E + 4] !== S || a[E + 5] !== _ ? (a[E + 0] = F, a[E + 1] = f, a[E + 2] = T, a[E + 3] = g, a[E + 4] = S, a[E + 5] = _, !0) : !1;
     } else {
       const C = E + 8, R = n[E + 6], F = C + u, f = R + u;
-      let T = p, O = !1, S = !1;
-      s ? T || (O = s.has(F), S = s.has(f), T = !O && !S) : (O = !0, S = !0);
-      const _ = T || O, N = T || S;
+      let T = p, g = !1, S = !1;
+      s ? T || (g = s.has(F), S = s.has(f), T = !g && !S) : (g = !0, S = !0);
+      const _ = T || g, N = T || S;
       let L = !1;
       _ && (L = d(C, u, T));
       let M = !1;
@@ -959,7 +959,7 @@ function Do(l, s = null) {
     }
   }
 }
-const ki = /* @__PURE__ */ new Ot();
+const ki = /* @__PURE__ */ new gt();
 function Gt(l, s, t, e) {
   return $(l, s, ki), t.intersectBox(ki, e);
 }
@@ -1033,7 +1033,7 @@ function li(l, s, t, e) {
     return m && R ? m.distance <= R.distance ? m : R : m || R || null;
   }
 }
-const is = /* @__PURE__ */ new Ot(), ne = /* @__PURE__ */ new Ft(), oe = /* @__PURE__ */ new Ft(), Oe = /* @__PURE__ */ new yt(), Zi = /* @__PURE__ */ new at(), ns = /* @__PURE__ */ new at();
+const is = /* @__PURE__ */ new gt(), ne = /* @__PURE__ */ new Ft(), oe = /* @__PURE__ */ new Ft(), ge = /* @__PURE__ */ new yt(), Zi = /* @__PURE__ */ new at(), ns = /* @__PURE__ */ new at();
 function Vo(l, s, t, e) {
   Z.setBuffer(l._roots[s]);
   const i = hi(0, l, t, e);
@@ -1044,8 +1044,8 @@ function hi(l, s, t, e, i = null) {
   let a = l * 2;
   if (i === null && (t.boundingBox || t.computeBoundingBox(), Zi.set(t.boundingBox.min, t.boundingBox.max, e), i = Zi), ht(a, n)) {
     const h = s.geometry, d = h.index, E = h.attributes.position, u = t.index, p = t.attributes.position, A = Et(l, r), m = ft(a, n);
-    if (Oe.copy(e).invert(), t.boundsTree)
-      return $(l, o, ns), ns.matrix.copy(Oe), ns.needsUpdate = !0, t.boundsTree.shapecast({
+    if (ge.copy(e).invert(), t.boundsTree)
+      return $(l, o, ns), ns.matrix.copy(ge), ns.needsUpdate = !0, t.boundsTree.shapecast({
         intersectsBounds: (R) => ns.intersectsBox(R),
         intersectsTriangle: (R) => {
           R.a.applyMatrix4(e), R.b.applyMatrix4(e), R.c.applyMatrix4(e), R.needsUpdate = !0;
@@ -1056,7 +1056,7 @@ function hi(l, s, t, e, i = null) {
         }
       });
     for (let C = A * 3, R = (m + A) * 3; C < R; C += 3) {
-      et(ne, C, d, E), ne.a.applyMatrix4(Oe), ne.b.applyMatrix4(Oe), ne.c.applyMatrix4(Oe), ne.needsUpdate = !0;
+      et(ne, C, d, E), ne.a.applyMatrix4(ge), ne.b.applyMatrix4(ge), ne.c.applyMatrix4(ge), ne.needsUpdate = !0;
       for (let F = 0, f = u.count; F < f; F += 3)
         if (et(oe, F, u, p), oe.needsUpdate = !0, ne.intersectsTriangle(oe))
           return !0;
@@ -1066,26 +1066,26 @@ function hi(l, s, t, e, i = null) {
     return $(h, o, is), !!(i.intersectsBox(is) && hi(h, s, t, e, i) || ($(d, o, is), i.intersectsBox(is) && hi(d, s, t, e, i)));
   }
 }
-const os = /* @__PURE__ */ new yt(), ks = /* @__PURE__ */ new at(), ge = /* @__PURE__ */ new at(), Go = /* @__PURE__ */ new w(), zo = /* @__PURE__ */ new w(), Ho = /* @__PURE__ */ new w(), ko = /* @__PURE__ */ new w();
+const os = /* @__PURE__ */ new yt(), ks = /* @__PURE__ */ new at(), Oe = /* @__PURE__ */ new at(), Go = /* @__PURE__ */ new w(), zo = /* @__PURE__ */ new w(), Ho = /* @__PURE__ */ new w(), ko = /* @__PURE__ */ new w();
 function Wo(l, s, t, e = {}, i = {}, o = 0, n = 1 / 0) {
   s.boundingBox || s.computeBoundingBox(), ks.set(s.boundingBox.min, s.boundingBox.max, t), ks.needsUpdate = !0;
   const r = l.geometry, a = r.attributes.position, c = r.index, h = s.attributes.position, d = s.index, E = It.getPrimitive(), u = It.getPrimitive();
   let p = Go, A = zo, m = null, C = null;
   i && (m = Ho, C = ko);
   let R = 1 / 0, F = null, f = null;
-  return os.copy(t).invert(), ge.matrix.copy(os), l.shapecast(
+  return os.copy(t).invert(), Oe.matrix.copy(os), l.shapecast(
     {
       boundsTraverseOrder: (T) => ks.distanceToBox(T),
-      intersectsBounds: (T, O, S) => S < R && S < n ? (O && (ge.min.copy(T.min), ge.max.copy(T.max), ge.needsUpdate = !0), !0) : !1,
-      intersectsRange: (T, O) => {
+      intersectsBounds: (T, g, S) => S < R && S < n ? (g && (Oe.min.copy(T.min), Oe.max.copy(T.max), Oe.needsUpdate = !0), !0) : !1,
+      intersectsRange: (T, g) => {
         if (s.boundsTree)
           return s.boundsTree.shapecast({
-            boundsTraverseOrder: (_) => ge.distanceToBox(_),
+            boundsTraverseOrder: (_) => Oe.distanceToBox(_),
             intersectsBounds: (_, N, L) => L < R && L < n,
             intersectsRange: (_, N) => {
               for (let L = _, M = _ + N; L < M; L++) {
                 et(u, 3 * L, d, h), u.a.applyMatrix4(t), u.b.applyMatrix4(t), u.c.applyMatrix4(t), u.needsUpdate = !0;
-                for (let y = T, x = T + O; y < x; y++) {
+                for (let y = T, x = T + g; y < x; y++) {
                   et(E, 3 * y, c, a), E.needsUpdate = !0;
                   const b = E.distanceToTriangle(u, p, m);
                   if (b < R && (A.copy(p), C && C.copy(m), R = b, F = y, f = L), b < o)
@@ -1098,7 +1098,7 @@ function Wo(l, s, t, e = {}, i = {}, o = 0, n = 1 / 0) {
           const S = Ce(s);
           for (let _ = 0, N = S; _ < N; _++) {
             et(u, 3 * _, d, h), u.a.applyMatrix4(t), u.b.applyMatrix4(t), u.c.applyMatrix4(t), u.needsUpdate = !0;
-            for (let L = T, M = T + O; L < M; L++) {
+            for (let L = T, M = T + g; L < M; L++) {
               et(E, 3 * L, c, a), E.needsUpdate = !0;
               const y = E.distanceToTriangle(u, p, m);
               if (y < R && (A.copy(p), C && C.copy(m), R = y, F = L, f = _), y < o)
@@ -1121,22 +1121,22 @@ function Xo(l, s = null) {
     const A = E * 2;
     if (r[A + 15] === Us) {
       const C = n[E + 6], R = r[A + 14];
-      let F = 1 / 0, f = 1 / 0, T = 1 / 0, O = -1 / 0, S = -1 / 0, _ = -1 / 0;
+      let F = 1 / 0, f = 1 / 0, T = 1 / 0, g = -1 / 0, S = -1 / 0, _ = -1 / 0;
       for (let N = C, L = C + R; N < L; N++) {
         const M = 3 * l.resolveTriangleIndex(N);
         for (let y = 0; y < 3; y++) {
           let x = M + y;
           x = e ? e[x] : x;
           const b = i.getX(x), B = i.getY(x), H = i.getZ(x);
-          b < F && (F = b), b > O && (O = b), B < f && (f = B), B > S && (S = B), H < T && (T = H), H > _ && (_ = H);
+          b < F && (F = b), b > g && (g = b), B < f && (f = B), B > S && (S = B), H < T && (T = H), H > _ && (_ = H);
         }
       }
-      return a[E + 0] !== F || a[E + 1] !== f || a[E + 2] !== T || a[E + 3] !== O || a[E + 4] !== S || a[E + 5] !== _ ? (a[E + 0] = F, a[E + 1] = f, a[E + 2] = T, a[E + 3] = O, a[E + 4] = S, a[E + 5] = _, !0) : !1;
+      return a[E + 0] !== F || a[E + 1] !== f || a[E + 2] !== T || a[E + 3] !== g || a[E + 4] !== S || a[E + 5] !== _ ? (a[E + 0] = F, a[E + 1] = f, a[E + 2] = T, a[E + 3] = g, a[E + 4] = S, a[E + 5] = _, !0) : !1;
     } else {
       const C = E + 8, R = n[E + 6], F = C + u, f = R + u;
-      let T = p, O = !1, S = !1;
-      s ? T || (O = s.has(F), S = s.has(f), T = !O && !S) : (O = !0, S = !0);
-      const _ = T || O, N = T || S;
+      let T = p, g = !1, S = !1;
+      s ? T || (g = s.has(F), S = s.has(f), T = !g && !S) : (g = !0, S = !0);
+      const _ = T || g, N = T || S;
       let L = !1;
       _ && (L = d(C, u, T));
       let M = !1;
@@ -1196,7 +1196,7 @@ function di(l, s, t, e) {
     return m && R ? m.distance <= R.distance ? m : R : m || R || null;
   }
 }
-const rs = /* @__PURE__ */ new Ot(), re = /* @__PURE__ */ new Ft(), ae = /* @__PURE__ */ new Ft(), Se = /* @__PURE__ */ new yt(), qi = /* @__PURE__ */ new at(), as = /* @__PURE__ */ new at();
+const rs = /* @__PURE__ */ new gt(), re = /* @__PURE__ */ new Ft(), ae = /* @__PURE__ */ new Ft(), Se = /* @__PURE__ */ new yt(), qi = /* @__PURE__ */ new at(), as = /* @__PURE__ */ new at();
 function qo(l, s, t, e) {
   Z.setBuffer(l._roots[s]);
   const i = ui(0, l, t, e);
@@ -1240,8 +1240,8 @@ function er(l, s, t, e = {}, i = {}, o = 0, n = 1 / 0) {
   return cs.copy(t).invert(), _e.matrix.copy(cs), l.shapecast(
     {
       boundsTraverseOrder: (T) => Ws.distanceToBox(T),
-      intersectsBounds: (T, O, S) => S < R && S < n ? (O && (_e.min.copy(T.min), _e.max.copy(T.max), _e.needsUpdate = !0), !0) : !1,
-      intersectsRange: (T, O) => {
+      intersectsBounds: (T, g, S) => S < R && S < n ? (g && (_e.min.copy(T.min), _e.max.copy(T.max), _e.needsUpdate = !0), !0) : !1,
+      intersectsRange: (T, g) => {
         if (s.boundsTree) {
           const S = s.boundsTree;
           return S.shapecast({
@@ -1251,7 +1251,7 @@ function er(l, s, t, e = {}, i = {}, o = 0, n = 1 / 0) {
               for (let L = _, M = _ + N; L < M; L++) {
                 const y = S.resolveTriangleIndex(L);
                 et(u, 3 * y, d, h), u.a.applyMatrix4(t), u.b.applyMatrix4(t), u.c.applyMatrix4(t), u.needsUpdate = !0;
-                for (let x = T, b = T + O; x < b; x++) {
+                for (let x = T, b = T + g; x < b; x++) {
                   const B = l.resolveTriangleIndex(x);
                   et(E, 3 * B, c, a), E.needsUpdate = !0;
                   const H = E.distanceToTriangle(u, p, m);
@@ -1265,7 +1265,7 @@ function er(l, s, t, e = {}, i = {}, o = 0, n = 1 / 0) {
           const S = Ce(s);
           for (let _ = 0, N = S; _ < N; _++) {
             et(u, 3 * _, d, h), u.a.applyMatrix4(t), u.b.applyMatrix4(t), u.c.applyMatrix4(t), u.needsUpdate = !0;
-            for (let L = T, M = T + O; L < M; L++) {
+            for (let L = T, M = T + g; L < M; L++) {
               const y = l.resolveTriangleIndex(L);
               et(E, 3 * y, c, a), E.needsUpdate = !0;
               const x = E.distanceToTriangle(u, p, m);
@@ -1281,7 +1281,7 @@ function er(l, s, t, e = {}, i = {}, o = 0, n = 1 / 0) {
 function sr() {
   return typeof SharedArrayBuffer < "u";
 }
-const be = new Z.constructor(), As = new Z.constructor(), vt = new gi(() => new Ot()), ce = new Ot(), le = new Ot(), Xs = new Ot(), Zs = new Ot();
+const be = new Z.constructor(), As = new Z.constructor(), vt = new Oi(() => new gt()), ce = new gt(), le = new gt(), Xs = new gt(), Zs = new gt();
 let Qs = !1;
 function ir(l, s, t, e) {
   if (Qs)
@@ -1315,9 +1315,9 @@ function ir(l, s, t, e) {
 function Tt(l, s, t, e, i, o = 0, n = 0, r = 0, a = 0, c = null, h = !1) {
   let d, E;
   h ? (d = As, E = be) : (d = be, E = As);
-  const u = d.float32Array, p = d.uint32Array, A = d.uint16Array, m = E.float32Array, C = E.uint32Array, R = E.uint16Array, F = l * 2, f = s * 2, T = ht(F, A), O = ht(f, R);
+  const u = d.float32Array, p = d.uint32Array, A = d.uint16Array, m = E.float32Array, C = E.uint32Array, R = E.uint16Array, F = l * 2, f = s * 2, T = ht(F, A), g = ht(f, R);
   let S = !1;
-  if (O && T)
+  if (g && T)
     h ? S = i(
       Et(s, C),
       ft(s * 2, R),
@@ -1337,7 +1337,7 @@ function Tt(l, s, t, e, i, o = 0, n = 0, r = 0, a = 0, c = null, h = !1) {
       a,
       n + s
     );
-  else if (O) {
+  else if (g) {
     const _ = vt.getPrimitive();
     $(s, m, _), _.applyMatrix4(t);
     const N = pt(l), L = Ct(l, p);
@@ -1495,7 +1495,7 @@ function Tt(l, s, t, e, i, o = 0, n = 0, r = 0, a = 0, c = null, h = !1) {
   }
   return S;
 }
-const ls = /* @__PURE__ */ new at(), $i = /* @__PURE__ */ new Ot();
+const ls = /* @__PURE__ */ new at(), $i = /* @__PURE__ */ new gt();
 class Si {
   static serialize(s, t = {}) {
     t = {
@@ -1554,7 +1554,7 @@ class Si {
       [Vs]: !1
     }, t), t.useSharedArrayBuffer && !sr())
       throw new Error("MeshBVH: SharedArrayBuffer is not available.");
-    this.geometry = s, this._roots = null, this._indirectBuffer = null, t[Vs] || (Ro(this, t), !s.boundingBox && t.setBoundingBox && (s.boundingBox = this.getBoundingBox(new Ot())));
+    this.geometry = s, this._roots = null, this._indirectBuffer = null, t[Vs] || (Ro(this, t), !s.boundingBox && t.setBoundingBox && (s.boundingBox = this.getBoundingBox(new gt())));
     const { _indirectBuffer: e } = this;
     this.resolveTriangleIndex = t.indirect ? (i) => e[i] : (i) => i;
   }
@@ -1645,19 +1645,19 @@ class Si {
       et(h, p * 3, d, E);
     };
     if (o) {
-      const p = (A, m, C, R, F, f, T, O) => {
+      const p = (A, m, C, R, F, f, T, g) => {
         for (let S = C, _ = C + R; S < _; S++) {
           u(S), h.a.applyMatrix4(t), h.b.applyMatrix4(t), h.c.applyMatrix4(t), h.needsUpdate = !0;
           for (let N = A, L = A + m; N < L; N++)
-            if (c(N), n.needsUpdate = !0, o(n, h, N, S, F, f, T, O))
+            if (c(N), n.needsUpdate = !0, o(n, h, N, S, F, f, T, g))
               return !0;
         }
         return !1;
       };
       if (i) {
         const A = i;
-        i = function(m, C, R, F, f, T, O, S) {
-          return A(m, C, R, F, f, T, O, S) ? !0 : p(m, C, R, F, f, T, O, S);
+        i = function(m, C, R, F, f, T, g, S) {
+          return A(m, C, R, F, f, T, g, S) ? !0 : p(m, C, R, F, f, T, g, S);
         };
       } else
         i = p;
@@ -1815,7 +1815,14 @@ class Ni extends _i {
   constructor(t) {
     super(t);
     I(this, "worlds", /* @__PURE__ */ new Map());
+    /**
+     * Event that is triggered when a world is added or removed from the `worlds` map.
+     * The event payload contains the world instance and the action ("added" or "removed").
+     */
     I(this, "onWorldChanged", new D());
+    /**
+     * The current world this item is associated with. It can be null if no world is currently active.
+     */
     I(this, "currentWorld", null);
     this.onWorldChanged.add(({ world: e, action: i }) => {
       i === "removed" && this.worlds.delete(e.uuid);
@@ -1825,7 +1832,11 @@ class Ni extends _i {
 class cr extends Ni {
   constructor() {
     super(...arguments);
-    /** Whether is instance is {@link CameraControllable}. */
+    /**
+     * Checks whether the instance is {@link CameraControllable}.
+     *
+     * @returns True if the instance is controllable, false otherwise.
+     */
     I(this, "hasCameraControls", () => "controls" in this);
   }
 }
@@ -1838,6 +1849,7 @@ class lr extends Ni {
     I(this, "onBeforeUpdate", new D());
     /** {@link Disposable.onDisposed} */
     I(this, "onDisposed", new D());
+    /** {@link Resizeable.onResize} */
     I(this, "onResize", new D());
     /**
      * Event that fires when there has been a change to the list of clipping
@@ -1845,23 +1857,34 @@ class lr extends Ni {
      */
     I(this, "onClippingPlanesUpdated", new D());
     /**
-     * The list of [clipping planes](https://threejs.org/docs/#api/en/renderers/WebGLRenderer.clippingPlanes) used by this
-     * instance of the renderer.
+     * The list of [clipping planes](https://threejs.org/docs/#api/en/renderers/WebGLRenderer.clippingPlanes) used by this instance of the renderer.
      */
     I(this, "clippingPlanes", []);
   }
   /**
-   * Forces the update of the clipping planes and all components that depend
-   * on them that are subscribed to `onClippingPlanesUpdated`.
-   */
+  * Updates the clipping planes and triggers the `onClippingPlanesUpdated` event.
+  *
+  * @remarks
+  * This method is typically called when there is a change to the list of clipping planes
+  * used by the active renderer.
+  */
   updateClippingPlanes() {
     this.onClippingPlanesUpdated.trigger();
   }
   /**
-   * Adds or removes a
-   * [clipping plane](https://threejs.org/docs/#api/en/renderers/WebGLRenderer.clippingPlanes)
-   * to the renderer.
-   */
+  * Sets or removes a clipping plane from the renderer.
+  *
+  * @param active - A boolean indicating whether the clipping plane should be active or not.
+  * @param plane - The clipping plane to be added or removed.
+  * @param isLocal - An optional boolean indicating whether the clipping plane is local to the object. If not provided, it defaults to `false`.
+  *
+  * @remarks
+  * This method adds or removes a clipping plane from the `clippingPlanes` array.
+  * If `active` is `true` and the plane is not already in the array, it is added.
+  * If `active` is `false` and the plane is in the array, it is removed.
+  * The `three.clippingPlanes` property is then updated to reflect the current state of the `clippingPlanes` array,
+  * excluding any planes marked as local.
+  */
   setPlane(t, e, i) {
     e.isLocal = i;
     const o = this.clippingPlanes.indexOf(e);
@@ -1879,8 +1902,7 @@ const ve = class ve extends J {
     t.add(ve.uuid, this);
   }
   /**
-   * {@link Component.uuid}.
-   * @return the list of UUIDs of deleted components.
+   * Return the UUIDs of all disposed components.
    */
   get() {
     return this._disposedComponents;
@@ -1910,8 +1932,7 @@ const ve = class ve extends J {
    * to remove.
    */
   disposeGeometry(t) {
-    const e = t;
-    e.boundsTree && e.disposeBoundsTree(), t.dispose();
+    t.boundsTree && t.disposeBoundsTree && t.disposeBoundsTree(), t.dispose();
   }
   disposeGeometryAndMaterials(t, e) {
     const i = t;
@@ -1930,6 +1951,10 @@ const ve = class ve extends J {
         t.material.dispose();
   }
 };
+/**
+ * A unique identifier for the component.
+ * This UUID is used to register the component within the Components system.
+ */
 I(ve, "uuid", "76e9cd8e-ad8f-4753-9ef6-cbc60f7247fe");
 let zt = ve;
 class hr extends Ni {
@@ -2338,7 +2363,7 @@ function Tr(l, s) {
   let t = 0, e = 0;
   const i = 10;
   s.unitary.identity(), s.diagonal.copy(l);
-  const o = s.unitary, n = s.diagonal, r = new g.Matrix3(), a = new g.Matrix3(), c = Number.EPSILON * fr(n);
+  const o = s.unitary, n = s.diagonal, r = new O.Matrix3(), a = new O.Matrix3(), c = Number.EPSILON * fr(n);
   for (; e < i && pr(n) > c; )
     Cr(n, r), a.copy(r).transpose(), n.multiply(r), n.premultiply(a), o.multiply(r), ++t > 2 && (e++, t = 0);
   return s;
@@ -2347,13 +2372,13 @@ function mr(l) {
   const s = [];
   for (let it = 0; it < l.length - 2; it += 3) {
     const Xt = l[it], tt = l[it + 1], Jt = l[it + 2];
-    s.push(new g.Vector3(Xt, tt, Jt));
+    s.push(new O.Vector3(Xt, tt, Jt));
   }
   const t = new ur();
   t.setFromPoints(s);
   const e = {
-    unitary: new g.Matrix3(),
-    diagonal: new g.Matrix3()
+    unitary: new O.Matrix3(),
+    diagonal: new O.Matrix3()
   }, i = t.faces, o = [], n = [];
   for (let it = 0, Xt = i.length; it < Xt; it++) {
     const tt = i[it];
@@ -2368,7 +2393,7 @@ function mr(l) {
       n.push(bs.point.x, bs.point.y, bs.point.z), n.push(vs.point.x, vs.point.y, vs.point.z), n.push(Bs.point.x, Bs.point.y, Bs.point.z);
     }
   }
-  const r = new g.Vector3(), a = new g.Vector3(), c = new g.Vector3(), h = new g.Vector3(), d = new g.Vector3(), E = new g.Vector3(), u = new g.Vector3(), p = new g.Vector3();
+  const r = new O.Vector3(), a = new O.Vector3(), c = new O.Vector3(), h = new O.Vector3(), d = new O.Vector3(), E = new O.Vector3(), u = new O.Vector3(), p = new O.Vector3();
   let A = 0, m = 0, C = 0, R = 0, F = 0, f = 0, T = 0;
   for (let it = 0, Xt = n.length; it < Xt; it += 9) {
     r.fromArray(n, it), a.fromArray(n, it + 3), c.fromArray(n, it + 6), u.set(0, 0, 0), u.add(r).add(a).add(c).divideScalar(3), h.subVectors(a, r), d.subVectors(c, r);
@@ -2376,9 +2401,9 @@ function mr(l) {
     p.add(E.copy(u).multiplyScalar(tt)), A += tt, m += (9 * u.x * u.x + r.x * r.x + a.x * a.x + c.x * c.x) * (tt / 12), C += (9 * u.x * u.y + r.x * r.y + a.x * a.y + c.x * c.y) * (tt / 12), R += (9 * u.x * u.z + r.x * r.z + a.x * a.z + c.x * c.z) * (tt / 12), F += (9 * u.y * u.y + r.y * r.y + a.y * a.y + c.y * c.y) * (tt / 12), f += (9 * u.y * u.z + r.y * r.z + a.y * a.z + c.y * c.z) * (tt / 12), T += (9 * u.z * u.z + r.z * r.z + a.z * a.z + c.z * c.z) * (tt / 12);
   }
   p.divideScalar(A), m /= A, C /= A, R /= A, F /= A, f /= A, T /= A, m -= p.x * p.x, C -= p.x * p.y, R -= p.x * p.z, F -= p.y * p.y, f -= p.y * p.z, T -= p.z * p.z;
-  const O = new g.Matrix3();
-  O.elements[0] = m, O.elements[1] = C, O.elements[2] = R, O.elements[3] = C, O.elements[4] = F, O.elements[5] = f, O.elements[6] = R, O.elements[7] = f, O.elements[8] = T, Tr(O, e);
-  const S = e.unitary, _ = new g.Vector3(), N = new g.Vector3(), L = new g.Vector3();
+  const g = new O.Matrix3();
+  g.elements[0] = m, g.elements[1] = C, g.elements[2] = R, g.elements[3] = C, g.elements[4] = F, g.elements[5] = f, g.elements[6] = R, g.elements[7] = f, g.elements[8] = T, Tr(g, e);
+  const S = e.unitary, _ = new O.Vector3(), N = new O.Vector3(), L = new O.Vector3();
   S.extractBasis(_, N, L);
   let M = -1 / 0, y = -1 / 0, x = -1 / 0, b = 1 / 0, B = 1 / 0, H = 1 / 0;
   for (let it = 0, Xt = s.length; it < Xt; it++) {
@@ -2386,17 +2411,17 @@ function mr(l) {
     M = Math.max(_.dot(tt), M), y = Math.max(N.dot(tt), y), x = Math.max(L.dot(tt), x), b = Math.min(_.dot(tt), b), B = Math.min(N.dot(tt), B), H = Math.min(L.dot(tt), H);
   }
   _.multiplyScalar(0.5 * (b + M)), N.multiplyScalar(0.5 * (B + y)), L.multiplyScalar(0.5 * (H + x));
-  const q = new g.Vector3(), st = new g.Vector3(), Q = new g.Matrix3();
+  const q = new O.Vector3(), st = new O.Vector3(), Q = new O.Matrix3();
   q.add(_).add(N).add(L), st.x = M - b, st.y = y - B, st.z = x - H, st.multiplyScalar(0.5), Q.copy(S);
-  const { x: Ht, y: kt, z: Wt } = st, Xe = new g.Matrix4();
+  const { x: Ht, y: kt, z: Wt } = st, Xe = new O.Matrix4();
   Xe.makeScale(Ht * 2, kt * 2, Wt * 2);
-  const Te = new g.Matrix4();
+  const Te = new O.Matrix4();
   Te.makeTranslation(-Ht, -kt, -Wt);
-  const wi = new g.Matrix4();
+  const wi = new O.Matrix4();
   wi.makeTranslation(q.x, q.y, q.z);
-  const Mi = new g.Matrix4();
+  const Mi = new O.Matrix4();
   Mi.setFromMatrix3(Q);
-  const me = new g.Matrix4();
+  const me = new O.Matrix4();
   return me.multiply(wi), me.multiply(Mi), me.multiply(Te), me.multiply(Xe), { center: q, halfSizes: st, rotation: Q, transformation: me };
 }
 function Rr(l, s, t) {
@@ -2737,7 +2762,7 @@ class sa extends J {
     return n ? (this.workingPlane ? Math.abs(this.workingPlane.distanceToPoint(n)) < 1e-3 : !0) ? ((this._pickedPoint === null || !this._pickedPoint.equals(n)) && (this._pickedPoint = n.clone(), this.onVertexFound.trigger(this._pickedPoint)), this._pickedPoint) : (this._pickedPoint = null, this._pickedPoint) : (this._pickedPoint !== null && (this.onVertexLost.trigger(), this._pickedPoint = null), this._pickedPoint);
   }
   getClosestVertex(t) {
-    let e = new g.Vector3(), i = !1, o = Number.MAX_SAFE_INTEGER;
+    let e = new O.Vector3(), i = !1, o = Number.MAX_SAFE_INTEGER;
     const n = this.getVertices(t);
     if (n === null)
       return null;
@@ -2753,7 +2778,7 @@ class sa extends J {
     const e = t.object;
     if (!t.face || !e)
       return null;
-    const i = e.geometry, o = new g.Matrix4(), { instanceId: n } = t, r = n !== void 0, a = e instanceof g.InstancedMesh;
+    const i = e.geometry, o = new O.Matrix4(), { instanceId: n } = t, r = n !== void 0, a = e instanceof O.InstancedMesh;
     return a && r && e.getMatrixAt(n, o), [
       this.getVertex(t.face.a, i),
       this.getVertex(t.face.b, i),
@@ -2764,7 +2789,7 @@ class sa extends J {
     if (t === void 0)
       return null;
     const i = e.attributes.position;
-    return new g.Vector3(
+    return new O.Vector3(
       i.getX(t),
       i.getY(t),
       i.getZ(t)
@@ -2775,9 +2800,15 @@ const Fs = class Fs {
   constructor() {
     /** {@link Disposable.onDisposed} */
     I(this, "onDisposed", new D());
-    /** The list of components created in this app. */
+    /**
+     * The list of components created in this app.
+     * The keys are UUIDs and the values are instances of the components.
+     */
     I(this, "list", /* @__PURE__ */ new Map());
-    /** If disabled, the animation loop will be stopped. */
+    /**
+     * If disabled, the animation loop will be stopped.
+     * Default value is false.
+     */
     I(this, "enabled", !1);
     I(this, "_clock");
     I(this, "update", () => {
@@ -2788,21 +2819,39 @@ const Fs = class Fs {
         e.enabled && e.isUpdateable() && e.update(s);
       requestAnimationFrame(this.update);
     });
-    this._clock = new g.Clock(), Fs.setupBVH();
+    this._clock = new O.Clock(), Fs.setupBVH();
   }
+  /**
+  * Adds a component to the list of components.
+  * Throws an error if a component with the same UUID already exists.
+  *
+  * @param uuid - The unique identifier of the component.
+  * @param instance - The instance of the component to be added.
+  *
+  * @throws Will throw an error if a component with the same UUID already exists.
+  *
+  * @internal
+  */
   add(s, t) {
     if (this.list.has(s))
       throw new Error(
-        "You're trying to add a component that already exists in the components intance. Use Components.get() instead."
+        "You're trying to add a component that already exists in the components instance. Use Components.get() instead."
       );
     ze.validate(s), this.list.set(s, t);
   }
   /**
-   * Retrieves a component. If it already exists in this app, it returns the instance of the component. If it
-   * doesn't exist, it will instance it automatically.
-   *
-   * @param Component - The component to get or create.
-   */
+  * Retrieves a component instance by its constructor function.
+  * If the component does not exist in the list, it will be created and added.
+  *
+  * @template U - The type of the component to retrieve.
+  * @param Component - The constructor function of the component to retrieve.
+  *
+  * @returns The instance of the requested component.
+  *
+  * @throws Will throw an error if a component with the same UUID already exists.
+  *
+  * @internal
+  */
   get(s) {
     const t = s.uuid;
     if (!this.list.has(t)) {
@@ -2812,10 +2861,11 @@ const Fs = class Fs {
     return this.list.get(t);
   }
   /**
-   * Initializes the library. It should be called at the start of the app after
-   * initializing the scene, the renderer and the
-   * camera. Additionally, if any component that need a raycaster is
-   * used, the {@link raycaster} will need to be initialized.
+   * Initializes the Components instance.
+   * This method starts the animation loop, sets the enabled flag to true,
+   * and calls the update method.
+   *
+   * @returns {void}
    */
   init() {
     this.enabled = !0, this._clock.start(), this.update();
@@ -2828,7 +2878,7 @@ const Fs = class Fs {
    * called. This is especially relevant in Single Page Applications (React,
    * Angular, Vue, etc).
    *
-   * - Any of the objects of this instance (meshes, geometries, etc) is
+   * - Any of the objects of this instance (meshes, geometries,materials, etc) is
    * referenced by a reference type (object or array).
    *
    * You can learn more about how Three.js handles memory leaks
@@ -2842,15 +2892,18 @@ const Fs = class Fs {
     this._clock.stop(), this.onDisposed.trigger(), this.onDisposed.reset();
   }
   static setupBVH() {
-    g.BufferGeometry.prototype.computeBoundsTree = rr, g.BufferGeometry.prototype.disposeBoundsTree = ar, g.Mesh.prototype.raycast = or;
+    O.BufferGeometry.prototype.computeBoundsTree = rr, O.BufferGeometry.prototype.disposeBoundsTree = ar, O.Mesh.prototype.raycast = or;
   }
 };
-I(Fs, "release", "1.4.21");
+/**
+ * The version of the @thatopen/components library.
+ */
+I(Fs, "release", "2.0.8");
 let pi = Fs;
 class Ar {
   constructor(s) {
     I(this, "_event");
-    I(this, "_position", new g.Vector2());
+    I(this, "_position", new O.Vector2());
     /** {@link Disposable.onDisposed} */
     I(this, "onDisposed", new D());
     I(this, "updateMouseInfo", (s) => {
@@ -2886,12 +2939,21 @@ class Fr {
   constructor(s, t) {
     /** {@link Component.enabled} */
     I(this, "enabled", !0);
+    /** The components instance to which this Raycaster belongs. */
     I(this, "components");
     /** {@link Disposable.onDisposed} */
     I(this, "onDisposed", new D());
     /** The position of the mouse in the screen. */
     I(this, "mouse");
-    I(this, "three", new g.Raycaster());
+    /**
+     * A reference to the Three.js Raycaster instance.
+     * This is used for raycasting operations.
+     */
+    I(this, "three", new O.Raycaster());
+    /**
+     * A reference to the world instance to which this Raycaster belongs.
+     * This is used to access the camera and meshes.
+     */
     I(this, "world");
     const e = t.renderer;
     if (!e)
@@ -2917,6 +2979,15 @@ class Fr {
     const t = this.world.camera.three;
     return this.three.setFromCamera(this.mouse.position, t), this.intersect(s);
   }
+  /**
+  * Casts a ray from a given origin in a given direction and returns the first item found.
+  * This method also takes into account the clipping planes used by the renderer.
+  *
+  * @param origin - The origin of the ray.
+  * @param direction - The direction of the ray.
+  * @param items - The meshes to query. If not provided, it will query all the meshes stored in {@link World.meshes}.
+  * @returns The first intersection found or `null` if no intersection was found.
+  */
   castRayFromVector(s, t, e = Array.from(this.world.meshes)) {
     return this.three.set(s, t), this.intersect(e);
   }
@@ -2936,14 +3007,28 @@ class Fr {
     );
   }
 }
-const Os = class Os extends J {
+const gs = class gs extends J {
   constructor(t) {
     super(t);
+    /** {@link Component.enabled} */
     I(this, "enabled", !0);
+    /**
+     * A Map that stores raycasters for each world.
+     * The key is the world's UUID, and the value is the corresponding SimpleRaycaster instance.
+     */
     I(this, "list", /* @__PURE__ */ new Map());
+    /** {@link Disposable.onDisposed} */
     I(this, "onDisposed", new D());
-    t.add(Os.uuid, this);
+    t.add(gs.uuid, this);
   }
+  /**
+   * Retrieves a SimpleRaycaster instance for the given world.
+   * If a SimpleRaycaster instance already exists for the world, it will be returned.
+   * Otherwise, a new SimpleRaycaster instance will be created and added to the list.
+   *
+   * @param world - The world for which to retrieve or create a SimpleRaycaster instance.
+   * @returns The SimpleRaycaster instance for the given world.
+   */
   get(t) {
     if (this.list.has(t.uuid))
       return this.list.get(t.uuid);
@@ -2952,61 +3037,119 @@ const Os = class Os extends J {
       this.delete(t);
     }), e;
   }
+  /**
+   * Deletes the SimpleRaycaster instance associated with the given world.
+   * If a SimpleRaycaster instance exists for the given world, it will be disposed and removed from the list.
+   *
+   * @param world - The world for which to delete the SimpleRaycaster instance.
+   * @returns {void}
+   */
   delete(t) {
     const e = this.list.get(t.uuid);
     e && e.dispose(), this.list.delete(t.uuid);
   }
+  /** {@link Disposable.dispose} */
   dispose() {
     for (const [t, e] of this.list)
       e.dispose();
     this.list.clear(), this.onDisposed.trigger();
   }
 };
-I(Os, "uuid", "d5d8bdf0-db25-4952-b951-b643af207ace");
-let He = Os;
-class Or extends _i {
-  constructor(t) {
-    super(t);
+/**
+ * A unique identifier for the component.
+ * This UUID is used to register the component within the Components system.
+ */
+I(gs, "uuid", "d5d8bdf0-db25-4952-b951-b643af207ace");
+let He = gs;
+class gr extends _i {
+  constructor() {
+    super(...arguments);
     /**
-     * All the loaded [meshes](https://threejs.org/docs/#api/en/objects/Mesh).
+     * All the loaded [meshes](https://threejs.org/docs/#api/en/objects/Mesh). These meshes will be taken into account in operations like raycasting.
      */
     I(this, "meshes", /* @__PURE__ */ new Set());
+    /** {@link Updateable.onAfterUpdate} */
     I(this, "onAfterUpdate", new D());
+    /** {@link Updateable.onBeforeUpdate} */
     I(this, "onBeforeUpdate", new D());
+    /** {@link Disposable.onDisposed} */
+    I(this, "onDisposed", new D());
+    /**
+     * Indicates whether the world is currently being disposed. This is useful to prevent trying to access world's elements when it's being disposed, which could cause errors when you dispose a world.
+     */
     I(this, "isDisposing", !1);
+    /**
+     * Indicates whether the world is currently enabled.
+     * When disabled, the world will not be updated.
+     */
     I(this, "enabled", !0);
+    /**
+     * A unique identifier for the world.
+     */
     I(this, "uuid", ze.create());
+    /**
+     * An optional name for the world.
+     */
     I(this, "name");
-    I(this, "onDisposed", new D());
     I(this, "_scene");
     I(this, "_camera");
     I(this, "_renderer", null);
   }
+  /**
+   * Getter for the scene. If no scene is initialized, it throws an error.
+   * @returns The current scene.
+   */
   get scene() {
     if (!this._scene)
       throw new Error("No scene initialized!");
     return this._scene;
   }
+  /**
+   * Setter for the scene. It sets the current scene, adds the world to the scene's worlds set,
+   * sets the current world in the scene, and triggers the scene's onWorldChanged event with the added action.
+   * @param scene - The new scene to be set.
+   */
   set scene(t) {
     this._scene = t, t.worlds.set(this.uuid, this), t.currentWorld = this, t.onWorldChanged.trigger({ world: this, action: "added" });
   }
+  /**
+   * Getter for the camera. If no camera is initialized, it throws an error.
+   * @returns The current camera.
+   */
   get camera() {
     if (!this._camera)
       throw new Error("No camera initialized!");
     return this._camera;
   }
+  /**
+   * Setter for the camera. It sets the current camera, adds the world to the camera's worlds set,
+   * sets the current world in the camera, and triggers the camera's onWorldChanged event with the added action.
+   * @param camera - The new camera to be set.
+   */
   set camera(t) {
     this._camera = t, t.worlds.set(this.uuid, this), t.currentWorld = this, t.onWorldChanged.trigger({ world: this, action: "added" });
   }
+  /**
+   * Getter for the renderer.
+   * @returns The current renderer or null if no renderer is set. Some worlds don't need a renderer to work (when your mail goal is not to display a 3D viewport to the user).
+   */
   get renderer() {
     return this._renderer;
   }
+  /**
+   * Setter for the renderer. It sets the current renderer, adds the world to the renderer's worlds set,
+   * sets the current world in the renderer, and triggers the renderer's onWorldChanged event with the added action.
+   * If a new renderer is set, it also triggers the onWorldChanged event with the removed action for the old renderer.
+   * @param renderer - The new renderer to be set or null to remove the current renderer.
+   */
   set renderer(t) {
     this._renderer = t, t && (t.worlds.set(this.uuid, this), t.currentWorld = this, t.onWorldChanged.trigger({ world: this, action: "added" }));
   }
+  /** {@link Updateable.update} */
   update(t) {
     this.enabled && (!this._scene || !this._camera || (this.scene.currentWorld = this, this.camera.currentWorld = this, this.renderer && (this.renderer.currentWorld = this), this.onBeforeUpdate.trigger(), this.scene.isUpdateable() && this.scene.update(t), this.camera.isUpdateable() && this.camera.update(t), this.renderer && this.renderer.update(t), this.onAfterUpdate.trigger()));
   }
+  /** {@link Disposable.dispose} */
   dispose(t = !0) {
     if (this.enabled = !1, this.isDisposing = !0, this.scene.onWorldChanged.trigger({ world: this, action: "removed" }), this.camera.onWorldChanged.trigger({ world: this, action: "removed" }), this.renderer && this.renderer.onWorldChanged.trigger({ world: this, action: "removed" }), t) {
       const e = this.components.get(zt);
@@ -3023,31 +3166,39 @@ class ia extends hr {
     super(t);
     /** {@link Configurable.isSetup} */
     I(this, "isSetup", !1);
+    /**
+     * The underlying Three.js scene object.
+     * It is used to define the 3D space containing objects, lights, and cameras.
+     */
     I(this, "three");
     /** {@link Configurable.onSetup} */
     I(this, "onSetup", new D());
+    /**
+    * Configuration interface for the {@link SimpleScene}.
+    * Defines properties for directional and ambient lights.
+    */
     I(this, "config", {
       directionalLight: {
-        color: new g.Color("white"),
+        color: new O.Color("white"),
         intensity: 1.5,
-        position: new g.Vector3(5, 10, 3)
+        position: new O.Vector3(5, 10, 3)
       },
       ambientLight: {
-        color: new g.Color("white"),
+        color: new O.Color("white"),
         intensity: 1
       }
     });
-    this.three = new g.Scene(), this.three.background = new g.Color(2107698);
+    this.three = new O.Scene(), this.three.background = new O.Color(2107698);
   }
-  /** Creates a simple and nice default set up for the scene (e.g. lighting). */
+  /** {@link Configurable.setup} */
   setup(t) {
     this.config = { ...this.config, ...t };
-    const e = new g.DirectionalLight(
+    const e = new O.DirectionalLight(
       this.config.directionalLight.color,
       this.config.directionalLight.intensity
     );
     e.position.copy(this.config.directionalLight.position);
-    const i = new g.AmbientLight(
+    const i = new O.AmbientLight(
       this.config.ambientLight.color,
       this.config.ambientLight.intensity
     );
@@ -3055,11 +3206,27 @@ class ia extends hr {
   }
 }
 class na extends lr {
+  /**
+   * Constructor for the SimpleRenderer class.
+   *
+   * @param components - The components instance.
+   * @param container - The HTML container where the THREE.js canvas will be rendered.
+   * @param parameters - Optional parameters for the THREE.js WebGLRenderer.
+   */
   constructor(t, e, i) {
     super(t);
+    /**
+     * Indicates whether the renderer is enabled. If it's not, it won't be updated.
+     * Default is `true`.
+     */
     I(this, "enabled", !0);
-    /** The HTML container of the THREE.js canvas where the scene is rendered. */
+    /**
+     * The HTML container of the THREE.js canvas where the scene is rendered.
+     */
     I(this, "container");
+    /**
+     * The THREE.js WebGLRenderer instance.
+     */
     I(this, "three");
     I(this, "_canvas");
     I(this, "_parameters");
@@ -3072,7 +3239,7 @@ class na extends lr {
         return;
       this._resizing = !0, this.onContainerUpdated.trigger();
       const e = t ? t.x : this.container.clientWidth, i = t ? t.y : this.container.clientHeight;
-      this.three.setSize(e, i), this.onResize.trigger(new g.Vector2(e, i)), this._resizing = !1;
+      this.three.setSize(e, i), this.onResize.trigger(new O.Vector2(e, i)), this._resizing = !1;
     });
     I(this, "resizeEvent", () => {
       this.resize();
@@ -3081,14 +3248,14 @@ class na extends lr {
       t.preventDefault(), this.enabled = !1;
     });
     I(this, "onContextBack", () => {
-      this.three.setRenderTarget(null), this.three.dispose(), this.three = new g.WebGLRenderer({
+      this.three.setRenderTarget(null), this.three.dispose(), this.three = new O.WebGLRenderer({
         canvas: this._canvas,
         antialias: !0,
         alpha: !0,
         ...this._parameters
       }), this.enabled = !0;
     });
-    this.container = e, this._parameters = i, this.three = new g.WebGLRenderer({
+    this.container = e, this._parameters = i, this.three = new O.WebGLRenderer({
       antialias: !0,
       alpha: !0,
       ...i
@@ -3110,11 +3277,18 @@ class na extends lr {
   }
   /** {@link Resizeable.getSize}. */
   getSize() {
-    return new g.Vector2(
+    return new O.Vector2(
       this.three.domElement.clientWidth,
       this.three.domElement.clientHeight
     );
   }
+  /**
+   * Sets up and manages the event listeners for the renderer.
+   *
+   * @param active - A boolean indicating whether to activate or deactivate the event listeners.
+   *
+   * @throws Will throw an error if the renderer does not have an HTML container.
+   */
   setupEvents(t) {
     const e = this.three.domElement.parentElement;
     if (!e)
@@ -3204,8 +3378,8 @@ function an(l, s, t, e, i = 1 / 0, o, n) {
     u = u / B * F, p = p / B * F, A = A / B * F;
   }
   h = l.x - u, d = l.y - p, E = l.z - A;
-  const O = (t.x + r * u) * o, S = (t.y + r * p) * o, _ = (t.z + r * A) * o;
-  t.x = (t.x - r * O) * c, t.y = (t.y - r * S) * c, t.z = (t.z - r * _) * c, n.x = h + (u + O) * c, n.y = d + (p + S) * c, n.z = E + (A + _) * c;
+  const g = (t.x + r * u) * o, S = (t.y + r * p) * o, _ = (t.z + r * A) * o;
+  t.x = (t.x - r * g) * c, t.y = (t.y - r * S) * c, t.z = (t.z - r * _) * c, n.x = h + (u + g) * c, n.y = d + (p + S) * c, n.z = E + (A + _) * c;
   const N = m - l.x, L = C - l.y, M = R - l.z, y = n.x - m, x = n.y - C, b = n.z - R;
   return N * y + L * x + M * b > 0 && (n.x = m, n.y = C, n.z = R, t.x = (n.x - m) / o, t.y = (n.y - C) / o, t.z = (n.z - R) / o), n;
 }
@@ -3217,7 +3391,7 @@ function Ks(l, s) {
 function Js(l, s) {
   return bt(l) ? (console.warn(`${s} is not supported in OrthographicCamera`), !0) : !1;
 }
-class gr {
+class Or {
   constructor() {
     this._listeners = {};
   }
@@ -3282,8 +3456,8 @@ class gr {
   }
 }
 const Sr = "2.7.3", ds = 1 / 8, vn = typeof window < "u", _r = vn && /Mac/.test(navigator.platform), Nr = !(vn && "PointerEvent" in window);
-let Y, cn, us, ti, lt, G, z, de, ye, gt, St, Qt, ln, hn, dt, we, ue, En, ei, dn, si, ii, Is;
-class ot extends gr {
+let Y, cn, us, ti, lt, G, z, de, ye, Ot, St, Qt, ln, hn, dt, we, ue, En, ei, dn, si, ii, Is;
+class ot extends Or {
   /**
        * Injects THREE as the dependency. You can then proceed to use CameraControls.
        *
@@ -3325,7 +3499,7 @@ class ot extends gr {
        * @category Statics
        */
   static install(s) {
-    Y = s.THREE, cn = Object.freeze(new Y.Vector3(0, 0, 0)), us = Object.freeze(new Y.Vector3(0, 1, 0)), ti = Object.freeze(new Y.Vector3(0, 0, 1)), lt = new Y.Vector2(), G = new Y.Vector3(), z = new Y.Vector3(), de = new Y.Vector3(), ye = new Y.Vector3(), gt = new Y.Vector3(), St = new Y.Vector3(), Qt = new Y.Vector3(), ln = new Y.Vector3(), hn = new Y.Vector3(), dt = new Y.Spherical(), we = new Y.Spherical(), ue = new Y.Box3(), En = new Y.Box3(), ei = new Y.Sphere(), dn = new Y.Quaternion(), si = new Y.Quaternion(), ii = new Y.Matrix4(), Is = new Y.Raycaster();
+    Y = s.THREE, cn = Object.freeze(new Y.Vector3(0, 0, 0)), us = Object.freeze(new Y.Vector3(0, 1, 0)), ti = Object.freeze(new Y.Vector3(0, 0, 1)), lt = new Y.Vector2(), G = new Y.Vector3(), z = new Y.Vector3(), de = new Y.Vector3(), ye = new Y.Vector3(), Ot = new Y.Vector3(), St = new Y.Vector3(), Qt = new Y.Vector3(), ln = new Y.Vector3(), hn = new Y.Vector3(), dt = new Y.Spherical(), we = new Y.Spherical(), ue = new Y.Box3(), En = new Y.Box3(), ei = new Y.Sphere(), dn = new Y.Quaternion(), si = new Y.Quaternion(), ii = new Y.Matrix4(), Is = new Y.Raycaster();
   }
   /**
    * list all ACTIONs
@@ -3353,7 +3527,7 @@ class ot extends gr {
    */
   constructor(s, t) {
     super(), this.minPolarAngle = 0, this.maxPolarAngle = Math.PI, this.minAzimuthAngle = -1 / 0, this.maxAzimuthAngle = 1 / 0, this.minDistance = Number.EPSILON, this.maxDistance = 1 / 0, this.infinityDolly = !1, this.minZoom = 0.01, this.maxZoom = 1 / 0, this.smoothTime = 0.25, this.draggingSmoothTime = 0.125, this.maxSpeed = 1 / 0, this.azimuthRotateSpeed = 1, this.polarRotateSpeed = 1, this.dollySpeed = 1, this.dollyDragInverted = !1, this.truckSpeed = 2, this.dollyToCursor = !1, this.dragToOffset = !1, this.verticalDragToForward = !1, this.boundaryFriction = 0, this.restThreshold = 0.01, this.colliderMeshes = [], this.cancel = () => {
-    }, this._enabled = !0, this._state = P.NONE, this._viewport = null, this._changedDolly = 0, this._changedZoom = 0, this._hasRested = !0, this._boundaryEnclosesCamera = !1, this._needsUpdate = !0, this._updatedLastTime = !1, this._elementRect = new DOMRect(), this._isDragging = !1, this._dragNeedsUpdate = !0, this._activePointers = [], this._lockedPointer = null, this._interactiveArea = new DOMRect(0, 0, 1, 1), this._isUserControllingRotate = !1, this._isUserControllingDolly = !1, this._isUserControllingTruck = !1, this._isUserControllingOffset = !1, this._isUserControllingZoom = !1, this._lastDollyDirection = he.NONE, this._thetaVelocity = { value: 0 }, this._phiVelocity = { value: 0 }, this._radiusVelocity = { value: 0 }, this._targetVelocity = new Y.Vector3(), this._focalOffsetVelocity = new Y.Vector3(), this._zoomVelocity = { value: 0 }, this._truckInternal = (f, T, O) => {
+    }, this._enabled = !0, this._state = P.NONE, this._viewport = null, this._changedDolly = 0, this._changedZoom = 0, this._hasRested = !0, this._boundaryEnclosesCamera = !1, this._needsUpdate = !0, this._updatedLastTime = !1, this._elementRect = new DOMRect(), this._isDragging = !1, this._dragNeedsUpdate = !0, this._activePointers = [], this._lockedPointer = null, this._interactiveArea = new DOMRect(0, 0, 1, 1), this._isUserControllingRotate = !1, this._isUserControllingDolly = !1, this._isUserControllingTruck = !1, this._isUserControllingOffset = !1, this._isUserControllingZoom = !1, this._lastDollyDirection = he.NONE, this._thetaVelocity = { value: 0 }, this._phiVelocity = { value: 0 }, this._radiusVelocity = { value: 0 }, this._targetVelocity = new Y.Vector3(), this._focalOffsetVelocity = new Y.Vector3(), this._zoomVelocity = { value: 0 }, this._truckInternal = (f, T, g) => {
       let S, _;
       if (Zt(this._camera)) {
         const N = G.copy(this._camera.position).sub(this._target), L = this._camera.getEffectiveFOV() * Ne, M = N.length() * Math.tan(L * 0.5);
@@ -3363,16 +3537,16 @@ class ot extends gr {
         S = f * (N.right - N.left) / N.zoom / this._elementRect.width, _ = T * (N.top - N.bottom) / N.zoom / this._elementRect.height;
       } else
         return;
-      this.verticalDragToForward ? (O ? this.setFocalOffset(this._focalOffsetEnd.x + S, this._focalOffsetEnd.y, this._focalOffsetEnd.z, !0) : this.truck(S, 0, !0), this.forward(-_, !0)) : O ? this.setFocalOffset(this._focalOffsetEnd.x + S, this._focalOffsetEnd.y + _, this._focalOffsetEnd.z, !0) : this.truck(S, _, !0);
+      this.verticalDragToForward ? (g ? this.setFocalOffset(this._focalOffsetEnd.x + S, this._focalOffsetEnd.y, this._focalOffsetEnd.z, !0) : this.truck(S, 0, !0), this.forward(-_, !0)) : g ? this.setFocalOffset(this._focalOffsetEnd.x + S, this._focalOffsetEnd.y + _, this._focalOffsetEnd.z, !0) : this.truck(S, _, !0);
     }, this._rotateInternal = (f, T) => {
-      const O = Ee * this.azimuthRotateSpeed * f / this._elementRect.height, S = Ee * this.polarRotateSpeed * T / this._elementRect.height;
-      this.rotate(O, S, !0);
-    }, this._dollyInternal = (f, T, O) => {
+      const g = Ee * this.azimuthRotateSpeed * f / this._elementRect.height, S = Ee * this.polarRotateSpeed * T / this._elementRect.height;
+      this.rotate(g, S, !0);
+    }, this._dollyInternal = (f, T, g) => {
       const S = Math.pow(0.95, -f * this.dollySpeed), _ = this._sphericalEnd.radius, N = this._sphericalEnd.radius * S, L = mt(N, this.minDistance, this.maxDistance), M = L - N;
-      this.infinityDolly && this.dollyToCursor ? this._dollyToNoClamp(N, !0) : this.infinityDolly && !this.dollyToCursor ? (this.dollyInFixed(M, !0), this._dollyToNoClamp(L, !0)) : this._dollyToNoClamp(L, !0), this.dollyToCursor && (this._changedDolly += (this.infinityDolly ? N : L) - _, this._dollyControlCoord.set(T, O)), this._lastDollyDirection = Math.sign(-f);
-    }, this._zoomInternal = (f, T, O) => {
+      this.infinityDolly && this.dollyToCursor ? this._dollyToNoClamp(N, !0) : this.infinityDolly && !this.dollyToCursor ? (this.dollyInFixed(M, !0), this._dollyToNoClamp(L, !0)) : this._dollyToNoClamp(L, !0), this.dollyToCursor && (this._changedDolly += (this.infinityDolly ? N : L) - _, this._dollyControlCoord.set(T, g)), this._lastDollyDirection = Math.sign(-f);
+    }, this._zoomInternal = (f, T, g) => {
       const S = Math.pow(0.95, f * this.dollySpeed), _ = this._zoom, N = this._zoom * S;
-      this.zoomTo(N, !0), this.dollyToCursor && (this._changedZoom += N - _, this._dollyControlCoord.set(T, O));
+      this.zoomTo(N, !0), this.dollyToCursor && (this._changedZoom += N - _, this._dollyControlCoord.set(T, g));
     }, typeof Y > "u" && console.error("camera-controls: `THREE` is undefined. You must first run `CameraControls.install( { THREE: THREE } )`. Check the docs for further information."), this._camera = s, this._yAxisUpSpace = new Y.Quaternion().setFromUnitVectors(this._camera.up, us), this._yAxisUpSpaceInverse = this._yAxisUpSpace.clone().invert(), this._state = P.NONE, this._target = new Y.Vector3(), this._targetEnd = this._target.clone(), this._focalOffset = new Y.Vector3(), this._focalOffsetEnd = this._focalOffset.clone(), this._spherical = new Y.Spherical().setFromVector3(G.copy(this._camera.position).applyQuaternion(this._yAxisUpSpace)), this._sphericalEnd = this._spherical.clone(), this._lastDistance = this._spherical.radius, this._zoom = this._camera.zoom, this._zoomEnd = this._zoom, this._lastZoom = this._zoom, this._nearPlaneCorners = [
       new Y.Vector3(),
       new Y.Vector3(),
@@ -3403,7 +3577,7 @@ class ot extends gr {
       }
       if ((f.buttons & V.LEFT) === V.LEFT && this._lockedPointer)
         return;
-      const O = {
+      const g = {
         pointerId: f.pointerId,
         clientX: f.clientX,
         clientY: f.clientY,
@@ -3411,7 +3585,7 @@ class ot extends gr {
         deltaY: 0,
         mouseButton: T
       };
-      this._activePointers.push(O), this._domElement.ownerDocument.removeEventListener("pointermove", a, { passive: !1 }), this._domElement.ownerDocument.removeEventListener("pointerup", h), this._domElement.ownerDocument.addEventListener("pointermove", a, { passive: !1 }), this._domElement.ownerDocument.addEventListener("pointerup", h), this._isDragging = !0, A(f);
+      this._activePointers.push(g), this._domElement.ownerDocument.removeEventListener("pointermove", a, { passive: !1 }), this._domElement.ownerDocument.removeEventListener("pointerup", h), this._domElement.ownerDocument.addEventListener("pointermove", a, { passive: !1 }), this._domElement.ownerDocument.addEventListener("pointerup", h), this._isDragging = !0, A(f);
     }, r = (f) => {
       if (!this._enabled || !this._domElement || this._lockedPointer)
         return;
@@ -3425,7 +3599,7 @@ class ot extends gr {
         const S = this._findPointerByMouseButton(T);
         S && this._disposePointer(S);
       }
-      const O = {
+      const g = {
         pointerId: 1,
         clientX: f.clientX,
         clientY: f.clientY,
@@ -3433,12 +3607,12 @@ class ot extends gr {
         deltaY: 0,
         mouseButton: (f.buttons & V.LEFT) === V.LEFT ? V.LEFT : (f.buttons & V.MIDDLE) === V.LEFT ? V.MIDDLE : (f.buttons & V.RIGHT) === V.LEFT ? V.RIGHT : null
       };
-      this._activePointers.push(O), this._domElement.ownerDocument.removeEventListener("mousemove", c), this._domElement.ownerDocument.removeEventListener("mouseup", d), this._domElement.ownerDocument.addEventListener("mousemove", c), this._domElement.ownerDocument.addEventListener("mouseup", d), this._isDragging = !0, A(f);
+      this._activePointers.push(g), this._domElement.ownerDocument.removeEventListener("mousemove", c), this._domElement.ownerDocument.removeEventListener("mouseup", d), this._domElement.ownerDocument.addEventListener("mousemove", c), this._domElement.ownerDocument.addEventListener("mouseup", d), this._isDragging = !0, A(f);
     }, a = (f) => {
       f.cancelable && f.preventDefault();
-      const T = f.pointerId, O = this._lockedPointer || this._findPointerById(T);
-      if (O) {
-        if (O.clientX = f.clientX, O.clientY = f.clientY, O.deltaX = f.movementX, O.deltaY = f.movementY, this._state = 0, f.pointerType === "touch")
+      const T = f.pointerId, g = this._lockedPointer || this._findPointerById(T);
+      if (g) {
+        if (g.clientX = f.clientX, g.clientY = f.clientY, g.deltaX = f.movementX, g.deltaY = f.movementY, this._state = 0, f.pointerType === "touch")
           switch (this._activePointers.length) {
             case 1:
               this._state = this.touches.one;
@@ -3496,7 +3670,7 @@ class ot extends gr {
         const N = performance.now();
         E - N < 1e3 && this._getClientRect(this._elementRect), E = N;
       }
-      const T = _r ? -1 : -3, O = f.deltaMode === 1 ? f.deltaY / T : f.deltaY / (T * 10), S = this.dollyToCursor ? (f.clientX - this._elementRect.x) / this._elementRect.width * 2 - 1 : 0, _ = this.dollyToCursor ? (f.clientY - this._elementRect.y) / this._elementRect.height * -2 + 1 : 0;
+      const T = _r ? -1 : -3, g = f.deltaMode === 1 ? f.deltaY / T : f.deltaY / (T * 10), S = this.dollyToCursor ? (f.clientX - this._elementRect.x) / this._elementRect.width * 2 - 1 : 0, _ = this.dollyToCursor ? (f.clientY - this._elementRect.y) / this._elementRect.height * -2 + 1 : 0;
       switch (this.mouseButtons.wheel) {
         case P.ROTATE: {
           this._rotateInternal(f.deltaX, f.deltaY), this._isUserControllingRotate = !0;
@@ -3511,11 +3685,11 @@ class ot extends gr {
           break;
         }
         case P.DOLLY: {
-          this._dollyInternal(-O, S, _), this._isUserControllingDolly = !0;
+          this._dollyInternal(-g, S, _), this._isUserControllingDolly = !0;
           break;
         }
         case P.ZOOM: {
-          this._zoomInternal(-O, S, _), this._isUserControllingZoom = !0;
+          this._zoomInternal(-g, S, _), this._isUserControllingZoom = !0;
           break;
         }
       }
@@ -3523,8 +3697,8 @@ class ot extends gr {
     }, p = (f) => {
       if (!(!this._domElement || !this._enabled)) {
         if (this.mouseButtons.right === ot.ACTION.NONE) {
-          const T = f instanceof PointerEvent ? f.pointerId : (f instanceof MouseEvent, 0), O = this._findPointerById(T);
-          O && this._disposePointer(O), this._domElement.ownerDocument.removeEventListener("pointermove", a, { passive: !1 }), this._domElement.ownerDocument.removeEventListener("pointerup", h), this._domElement.ownerDocument.removeEventListener("mousemove", c), this._domElement.ownerDocument.removeEventListener("mouseup", d);
+          const T = f instanceof PointerEvent ? f.pointerId : (f instanceof MouseEvent, 0), g = this._findPointerById(T);
+          g && this._disposePointer(g), this._domElement.ownerDocument.removeEventListener("pointermove", a, { passive: !1 }), this._domElement.ownerDocument.removeEventListener("pointerup", h), this._domElement.ownerDocument.removeEventListener("mousemove", c), this._domElement.ownerDocument.removeEventListener("mouseup", d);
           return;
         }
         f.preventDefault();
@@ -3533,7 +3707,7 @@ class ot extends gr {
       if (!this._enabled)
         return;
       if (Ks(this._activePointers, lt), this._getClientRect(this._elementRect), e.copy(lt), i.copy(lt), this._activePointers.length >= 2) {
-        const O = lt.x - this._activePointers[1].clientX, S = lt.y - this._activePointers[1].clientY, _ = Math.sqrt(O * O + S * S);
+        const g = lt.x - this._activePointers[1].clientX, S = lt.y - this._activePointers[1].clientY, _ = Math.sqrt(g * g + S * S);
         o.set(0, _);
         const N = (this._activePointers[0].clientX + this._activePointers[1].clientX) * 0.5, L = (this._activePointers[0].clientY + this._activePointers[1].clientY) * 0.5;
         i.set(N, L);
@@ -3559,8 +3733,8 @@ class ot extends gr {
       if (!this._enabled || !this._dragNeedsUpdate)
         return;
       this._dragNeedsUpdate = !1, Ks(this._activePointers, lt);
-      const T = this._domElement && document.pointerLockElement === this._domElement ? this._lockedPointer || this._activePointers[0] : null, O = T ? -T.deltaX : i.x - lt.x, S = T ? -T.deltaY : i.y - lt.y;
-      if (i.copy(lt), ((this._state & P.ROTATE) === P.ROTATE || (this._state & P.TOUCH_ROTATE) === P.TOUCH_ROTATE || (this._state & P.TOUCH_DOLLY_ROTATE) === P.TOUCH_DOLLY_ROTATE || (this._state & P.TOUCH_ZOOM_ROTATE) === P.TOUCH_ZOOM_ROTATE) && (this._rotateInternal(O, S), this._isUserControllingRotate = !0), (this._state & P.DOLLY) === P.DOLLY || (this._state & P.ZOOM) === P.ZOOM) {
+      const T = this._domElement && document.pointerLockElement === this._domElement ? this._lockedPointer || this._activePointers[0] : null, g = T ? -T.deltaX : i.x - lt.x, S = T ? -T.deltaY : i.y - lt.y;
+      if (i.copy(lt), ((this._state & P.ROTATE) === P.ROTATE || (this._state & P.TOUCH_ROTATE) === P.TOUCH_ROTATE || (this._state & P.TOUCH_DOLLY_ROTATE) === P.TOUCH_DOLLY_ROTATE || (this._state & P.TOUCH_ZOOM_ROTATE) === P.TOUCH_ZOOM_ROTATE) && (this._rotateInternal(g, S), this._isUserControllingRotate = !0), (this._state & P.DOLLY) === P.DOLLY || (this._state & P.ZOOM) === P.ZOOM) {
         const _ = this.dollyToCursor ? (e.x - this._elementRect.x) / this._elementRect.width * 2 - 1 : 0, N = this.dollyToCursor ? (e.y - this._elementRect.y) / this._elementRect.height * -2 + 1 : 0, L = this.dollyDragInverted ? -1 : 1;
         (this._state & P.DOLLY) === P.DOLLY ? (this._dollyInternal(L * S * ds, _, N), this._isUserControllingDolly = !0) : (this._zoomInternal(L * S * ds, _, N), this._isUserControllingZoom = !0);
       }
@@ -3570,7 +3744,7 @@ class ot extends gr {
         const y = this.dollyToCursor ? (i.x - this._elementRect.x) / this._elementRect.width * 2 - 1 : 0, x = this.dollyToCursor ? (i.y - this._elementRect.y) / this._elementRect.height * -2 + 1 : 0;
         (this._state & P.TOUCH_DOLLY) === P.TOUCH_DOLLY || (this._state & P.TOUCH_DOLLY_ROTATE) === P.TOUCH_DOLLY_ROTATE || (this._state & P.TOUCH_DOLLY_TRUCK) === P.TOUCH_DOLLY_TRUCK || (this._state & P.TOUCH_DOLLY_OFFSET) === P.TOUCH_DOLLY_OFFSET ? (this._dollyInternal(M * ds, y, x), this._isUserControllingDolly = !0) : (this._zoomInternal(M * ds, y, x), this._isUserControllingZoom = !0);
       }
-      ((this._state & P.TRUCK) === P.TRUCK || (this._state & P.TOUCH_TRUCK) === P.TOUCH_TRUCK || (this._state & P.TOUCH_DOLLY_TRUCK) === P.TOUCH_DOLLY_TRUCK || (this._state & P.TOUCH_ZOOM_TRUCK) === P.TOUCH_ZOOM_TRUCK) && (this._truckInternal(O, S, !1), this._isUserControllingTruck = !0), ((this._state & P.OFFSET) === P.OFFSET || (this._state & P.TOUCH_OFFSET) === P.TOUCH_OFFSET || (this._state & P.TOUCH_DOLLY_OFFSET) === P.TOUCH_DOLLY_OFFSET || (this._state & P.TOUCH_ZOOM_OFFSET) === P.TOUCH_ZOOM_OFFSET) && (this._truckInternal(O, S, !0), this._isUserControllingOffset = !0), this.dispatchEvent({ type: "control" });
+      ((this._state & P.TRUCK) === P.TRUCK || (this._state & P.TOUCH_TRUCK) === P.TOUCH_TRUCK || (this._state & P.TOUCH_DOLLY_TRUCK) === P.TOUCH_DOLLY_TRUCK || (this._state & P.TOUCH_ZOOM_TRUCK) === P.TOUCH_ZOOM_TRUCK) && (this._truckInternal(g, S, !1), this._isUserControllingTruck = !0), ((this._state & P.OFFSET) === P.OFFSET || (this._state & P.TOUCH_OFFSET) === P.TOUCH_OFFSET || (this._state & P.TOUCH_DOLLY_OFFSET) === P.TOUCH_DOLLY_OFFSET || (this._state & P.TOUCH_ZOOM_OFFSET) === P.TOUCH_ZOOM_OFFSET) && (this._truckInternal(g, S, !0), this._isUserControllingOffset = !0), this.dispatchEvent({ type: "control" });
     }, C = () => {
       Ks(this._activePointers, lt), i.copy(lt), this._dragNeedsUpdate = !1, (this._activePointers.length === 0 || this._activePointers.length === 1 && this._activePointers[0] === this._lockedPointer) && (this._isDragging = !1), this._activePointers.length === 0 && this._domElement && (this._domElement.ownerDocument.removeEventListener("pointermove", a, { passive: !1 }), this._domElement.ownerDocument.removeEventListener("mousemove", c), this._domElement.ownerDocument.removeEventListener("pointerup", h), this._domElement.ownerDocument.removeEventListener("mouseup", d), this.dispatchEvent({ type: "controlend" }));
     };
@@ -3893,8 +4067,8 @@ class ot extends gr {
    * @category Methods
    */
   truck(s, t, e = !1) {
-    this._camera.updateMatrix(), gt.setFromMatrixColumn(this._camera.matrix, 0), St.setFromMatrixColumn(this._camera.matrix, 1), gt.multiplyScalar(s), St.multiplyScalar(-t);
-    const i = G.copy(gt).add(St), o = z.copy(this._targetEnd).add(i);
+    this._camera.updateMatrix(), Ot.setFromMatrixColumn(this._camera.matrix, 0), St.setFromMatrixColumn(this._camera.matrix, 1), Ot.multiplyScalar(s), St.multiplyScalar(-t);
+    const i = G.copy(Ot).add(St), o = z.copy(this._targetEnd).add(i);
     return this.moveTo(o.x, o.y, o.z, e);
   }
   /**
@@ -4038,8 +4212,8 @@ class ot extends gr {
     we.setFromVector3(R.sub(C).applyQuaternion(this._yAxisUpSpace)), this._targetEnd.copy(A.lerp(C, u));
     const F = we.theta - dt.theta, f = we.phi - dt.phi, T = we.radius - dt.radius;
     this._sphericalEnd.set(dt.radius + T * u, dt.phi + f * u, dt.theta + F * u), this.normalizeRotations(), this._needsUpdate = !0, p || (this._target.copy(this._targetEnd), this._spherical.copy(this._sphericalEnd));
-    const O = !p || k(this._target.x, this._targetEnd.x, this.restThreshold) && k(this._target.y, this._targetEnd.y, this.restThreshold) && k(this._target.z, this._targetEnd.z, this.restThreshold) && k(this._spherical.theta, this._sphericalEnd.theta, this.restThreshold) && k(this._spherical.phi, this._sphericalEnd.phi, this.restThreshold) && k(this._spherical.radius, this._sphericalEnd.radius, this.restThreshold);
-    return this._createOnRestPromise(O);
+    const g = !p || k(this._target.x, this._targetEnd.x, this.restThreshold) && k(this._target.y, this._targetEnd.y, this.restThreshold) && k(this._target.z, this._targetEnd.z, this.restThreshold) && k(this._spherical.theta, this._sphericalEnd.theta, this.restThreshold) && k(this._spherical.phi, this._sphericalEnd.phi, this.restThreshold) && k(this._spherical.radius, this._sphericalEnd.radius, this.restThreshold);
+    return this._createOnRestPromise(g);
   }
   /**
    * Set angle and distance by given position.
@@ -4088,9 +4262,9 @@ class ot extends gr {
    * @category Methods
    */
   setOrbitPoint(s, t, e) {
-    this._camera.updateMatrixWorld(), gt.setFromMatrixColumn(this._camera.matrixWorldInverse, 0), St.setFromMatrixColumn(this._camera.matrixWorldInverse, 1), Qt.setFromMatrixColumn(this._camera.matrixWorldInverse, 2);
+    this._camera.updateMatrixWorld(), Ot.setFromMatrixColumn(this._camera.matrixWorldInverse, 0), St.setFromMatrixColumn(this._camera.matrixWorldInverse, 1), Qt.setFromMatrixColumn(this._camera.matrixWorldInverse, 2);
     const i = G.set(s, t, e), o = i.distanceTo(this._camera.position), n = i.sub(this._camera.position);
-    gt.multiplyScalar(n.x), St.multiplyScalar(n.y), Qt.multiplyScalar(n.z), G.copy(gt).add(St).add(Qt), G.z = G.z + o, this.dollyTo(o, !1), this.setFocalOffset(-G.x, G.y, -G.z, !1), this.moveTo(s, t, e, !1);
+    Ot.multiplyScalar(n.x), St.multiplyScalar(n.y), Qt.multiplyScalar(n.z), G.copy(Ot).add(St).add(Qt), G.z = G.z + o, this.dollyTo(o, !1), this.setFocalOffset(-G.x, G.y, -G.z, !1), this.moveTo(s, t, e, !1);
   }
   /**
    * Set the boundary box that encloses the target of the camera. box3 is in THREE.Box3
@@ -4282,8 +4456,8 @@ class ot extends gr {
       if (Zt(this._camera) && this._changedDolly !== 0) {
         const d = this._spherical.radius - this._lastDistance, E = this._camera, u = this._getCameraDirection(ye), p = G.copy(u).cross(E.up).normalize();
         p.lengthSq() === 0 && (p.x = 1);
-        const A = z.crossVectors(p, u), m = this._sphericalEnd.radius * Math.tan(E.getEffectiveFOV() * Ne * 0.5), R = (this._sphericalEnd.radius - d - this._sphericalEnd.radius) / this._sphericalEnd.radius, F = de.copy(this._targetEnd).add(p.multiplyScalar(this._dollyControlCoord.x * m * E.aspect)).add(A.multiplyScalar(this._dollyControlCoord.y * m)), f = G.copy(this._targetEnd).lerp(F, R), T = this._lastDollyDirection === he.IN && this._spherical.radius <= this.minDistance, O = this._lastDollyDirection === he.OUT && this.maxDistance <= this._spherical.radius;
-        if (this.infinityDolly && (T || O)) {
+        const A = z.crossVectors(p, u), m = this._sphericalEnd.radius * Math.tan(E.getEffectiveFOV() * Ne * 0.5), R = (this._sphericalEnd.radius - d - this._sphericalEnd.radius) / this._sphericalEnd.radius, F = de.copy(this._targetEnd).add(p.multiplyScalar(this._dollyControlCoord.x * m * E.aspect)).add(A.multiplyScalar(this._dollyControlCoord.y * m)), f = G.copy(this._targetEnd).lerp(F, R), T = this._lastDollyDirection === he.IN && this._spherical.radius <= this.minDistance, g = this._lastDollyDirection === he.OUT && this.maxDistance <= this._spherical.radius;
+        if (this.infinityDolly && (T || g)) {
           this._sphericalEnd.radius -= d, this._spherical.radius -= d;
           const _ = z.copy(u).multiplyScalar(-d);
           f.add(_);
@@ -4292,15 +4466,15 @@ class ot extends gr {
         const S = z.subVectors(f, this._targetEnd);
         this._targetEnd.copy(f), this._target.add(S), this._changedDolly -= d, X(this._changedDolly) && (this._changedDolly = 0);
       } else if (bt(this._camera) && this._changedZoom !== 0) {
-        const d = this._zoom - this._lastZoom, E = this._camera, u = G.set(this._dollyControlCoord.x, this._dollyControlCoord.y, (E.near + E.far) / (E.near - E.far)).unproject(E), p = z.set(0, 0, -1).applyQuaternion(E.quaternion), A = de.copy(u).add(p.multiplyScalar(-u.dot(E.up))), C = -(this._zoom - d - this._zoom) / this._zoom, R = this._getCameraDirection(ye), F = this._targetEnd.dot(R), f = G.copy(this._targetEnd).lerp(A, C), T = f.dot(R), O = R.multiplyScalar(T - F);
-        f.sub(O), this._boundary.clampPoint(f, f);
+        const d = this._zoom - this._lastZoom, E = this._camera, u = G.set(this._dollyControlCoord.x, this._dollyControlCoord.y, (E.near + E.far) / (E.near - E.far)).unproject(E), p = z.set(0, 0, -1).applyQuaternion(E.quaternion), A = de.copy(u).add(p.multiplyScalar(-u.dot(E.up))), C = -(this._zoom - d - this._zoom) / this._zoom, R = this._getCameraDirection(ye), F = this._targetEnd.dot(R), f = G.copy(this._targetEnd).lerp(A, C), T = f.dot(R), g = R.multiplyScalar(T - F);
+        f.sub(g), this._boundary.clampPoint(f, f);
         const S = z.subVectors(f, this._targetEnd);
         this._targetEnd.copy(f), this._target.add(S), this._changedZoom -= d, X(this._changedZoom) && (this._changedZoom = 0);
       }
     }
     this._camera.zoom !== this._zoom && (this._camera.zoom = this._zoom, this._camera.updateProjectionMatrix(), this._updateNearPlaneCorners(), this._needsUpdate = !0), this._dragNeedsUpdate = !0;
     const a = this._collisionTest();
-    this._spherical.radius = Math.min(this._spherical.radius, a), this._spherical.makeSafe(), this._camera.position.setFromSpherical(this._spherical).applyQuaternion(this._yAxisUpSpaceInverse).add(this._target), this._camera.lookAt(this._target), (!X(this._focalOffset.x) || !X(this._focalOffset.y) || !X(this._focalOffset.z)) && (this._camera.updateMatrixWorld(), gt.setFromMatrixColumn(this._camera.matrix, 0), St.setFromMatrixColumn(this._camera.matrix, 1), Qt.setFromMatrixColumn(this._camera.matrix, 2), gt.multiplyScalar(this._focalOffset.x), St.multiplyScalar(-this._focalOffset.y), Qt.multiplyScalar(this._focalOffset.z), G.copy(gt).add(St).add(Qt), this._camera.position.add(G)), this._boundaryEnclosesCamera && this._encloseToBoundary(this._camera.position.copy(this._target), G.setFromSpherical(this._spherical).applyQuaternion(this._yAxisUpSpaceInverse), 1);
+    this._spherical.radius = Math.min(this._spherical.radius, a), this._spherical.makeSafe(), this._camera.position.setFromSpherical(this._spherical).applyQuaternion(this._yAxisUpSpaceInverse).add(this._target), this._camera.lookAt(this._target), (!X(this._focalOffset.x) || !X(this._focalOffset.y) || !X(this._focalOffset.z)) && (this._camera.updateMatrixWorld(), Ot.setFromMatrixColumn(this._camera.matrix, 0), St.setFromMatrixColumn(this._camera.matrix, 1), Qt.setFromMatrixColumn(this._camera.matrix, 2), Ot.multiplyScalar(this._focalOffset.x), St.multiplyScalar(-this._focalOffset.y), Qt.multiplyScalar(this._focalOffset.z), G.copy(Ot).add(St).add(Qt), this._camera.position.add(G)), this._boundaryEnclosesCamera && this._encloseToBoundary(this._camera.position.copy(this._target), G.setFromSpherical(this._spherical).applyQuaternion(this._yAxisUpSpaceInverse), 1);
     const h = this._needsUpdate;
     return h && !this._updatedLastTime ? (this._hasRested = !1, this.dispatchEvent({ type: "wake" }), this.dispatchEvent({ type: "update" })) : h ? (this.dispatchEvent({ type: "update" }), X(t, this.restThreshold) && X(e, this.restThreshold) && X(i, this.restThreshold) && X(o.x, this.restThreshold) && X(o.y, this.restThreshold) && X(o.z, this.restThreshold) && X(n.x, this.restThreshold) && X(n.y, this.restThreshold) && X(n.z, this.restThreshold) && X(r, this.restThreshold) && !this._hasRested && (this._hasRested = !0, this.dispatchEvent({ type: "rest" }))) : !h && this._updatedLastTime && this.dispatchEvent({ type: "sleep" }), this._lastDistance = this._spherical.radius, this._lastZoom = this._zoom, this._updatedLastTime = h, this._needsUpdate = !1, h;
   }
@@ -4506,9 +4680,17 @@ class ke extends cr {
     I(this, "onBeforeUpdate", new D());
     /** {@link Updateable.onAfterUpdate} */
     I(this, "onAfterUpdate", new D());
+    /**
+     * Event that is triggered when the aspect of the camera has been updated.
+     * This event is useful when you need to perform actions after the aspect of the camera has been changed.
+     */
     I(this, "onAspectUpdated", new D());
     /** {@link Disposable.onDisposed} */
     I(this, "onDisposed", new D());
+    /**
+     * A three.js PerspectiveCamera or OrthographicCamera instance.
+     * This camera is used for rendering the scene.
+     */
     I(this, "three");
     I(this, "_allControls", /* @__PURE__ */ new Map());
     /**
@@ -4518,7 +4700,7 @@ class ke extends cr {
     I(this, "updateAspect", () => {
       var t;
       if (!(!this.currentWorld || !this.currentWorld.renderer)) {
-        if (this.three instanceof g.OrthographicCamera) {
+        if (this.three instanceof O.OrthographicCamera) {
           this.onAspectUpdated.trigger();
           return;
         }
@@ -4553,13 +4735,24 @@ class ke extends cr {
       throw new Error("Controls not found!");
     return t;
   }
-  /** {@link Component.enabled} */
+  /**
+   * Getter for the enabled state of the camera controls.
+   * If the current world is null, it returns false.
+   * Otherwise, it returns the enabled state of the camera controls.
+   *
+   * @returns {boolean} The enabled state of the camera controls.
+   */
   get enabled() {
     return this.currentWorld === null ? !1 : this.controls.enabled;
   }
-  /** {@link Component.enabled} */
+  /**
+   * Setter for the enabled state of the camera controls.
+   * If the current world is not null, it sets the enabled state of the camera controls to the provided value.
+   *
+   * @param {boolean} enabled - The new enabled state of the camera controls.
+   */
   set enabled(t) {
-    this.controls.enabled = t;
+    this.currentWorld !== null && (this.controls.enabled = t);
   }
   /** {@link Disposable.dispose} */
   dispose() {
@@ -4572,8 +4765,8 @@ class ke extends cr {
     this.enabled && (this.onBeforeUpdate.trigger(this), this.controls.update(t), this.onAfterUpdate.trigger(this));
   }
   setupCamera() {
-    const t = window.innerWidth / window.innerHeight, e = new g.PerspectiveCamera(60, t, 1, 1e3);
-    return e.position.set(50, 50, 50), e.lookAt(new g.Vector3(0, 0, 0)), e;
+    const t = window.innerWidth / window.innerHeight, e = new O.PerspectiveCamera(60, t, 1, 1e3);
+    return e.position.set(50, 50, 50), e.lookAt(new O.Vector3(0, 0, 0)), e;
   }
   newCameraControls() {
     if (!this.currentWorld)
@@ -4589,51 +4782,47 @@ class ke extends cr {
   }
   static getSubsetOfThree() {
     return {
-      MOUSE: g.MOUSE,
-      Vector2: g.Vector2,
-      Vector3: g.Vector3,
-      Vector4: g.Vector4,
-      Quaternion: g.Quaternion,
-      Matrix4: g.Matrix4,
-      Spherical: g.Spherical,
-      Box3: g.Box3,
-      Sphere: g.Sphere,
-      Raycaster: g.Raycaster,
-      MathUtils: g.MathUtils
+      MOUSE: O.MOUSE,
+      Vector2: O.Vector2,
+      Vector3: O.Vector3,
+      Vector4: O.Vector4,
+      Quaternion: O.Quaternion,
+      Matrix4: O.Matrix4,
+      Spherical: O.Spherical,
+      Box3: O.Box3,
+      Sphere: O.Sphere,
+      Raycaster: O.Raycaster,
+      MathUtils: O.MathUtils
     };
   }
 }
-const gs = class gs extends J {
+const Os = class Os extends J {
   constructor(t) {
     super(t);
-    /**
-     * Event triggered after the update process of all worlds.
-     * Subscribers can listen to this event to perform actions post-update.
-     */
+    /** {@link Updateable.onAfterUpdate} */
     I(this, "onAfterUpdate", new D());
-    /**
-     * Event triggered before the update process of all worlds.
-     * Subscribers can listen to this event to perform actions pre-update.
-     */
+    /** {@link Updateable.onBeforeUpdate} */
     I(this, "onBeforeUpdate", new D());
+    /** {@link Disposable.onDisposed} */
+    I(this, "onDisposed", new D());
     /**
-     * Event triggered when the Worlds component is disposed.
-     * Subscribers can listen to this event to perform cleanup actions.
+     * An event that is triggered when a new world is created.
+     * The event passes the newly created world as a parameter.
      */
-    I(this, "onDisposed", new D());
     I(this, "onWorldCreated", new D());
+    /**
+     * An event that is triggered when a world is deleted.
+     * The event passes the UUID of the deleted world as a parameter.
+     */
     I(this, "onWorldDeleted", new D());
     /**
      * A collection of worlds managed by this component.
      * The key is the unique identifier (UUID) of the world, and the value is the World instance.
      */
     I(this, "list", /* @__PURE__ */ new Map());
-    /**
-     * A flag indicating whether the Worlds component is enabled.
-     * If false, the update process will be skipped.
-     */
+    /** {@link Component.enabled} */
     I(this, "enabled", !0);
-    t.add(gs.uuid, this);
+    t.add(Os.uuid, this);
   }
   /**
    * Creates a new instance of a SimpleWorld and adds it to the list of worlds.
@@ -4645,21 +4834,40 @@ const gs = class gs extends J {
    * @throws {Error} - Throws an error if a world with the same UUID already exists in the list.
    */
   create() {
-    const t = new Or(this.components), e = t.uuid;
+    const t = new gr(this.components), e = t.uuid;
     if (this.list.has(e))
       throw new Error("There is already a world with this name!");
     return this.list.set(e, t), this.onWorldCreated.trigger(t), t;
   }
+  /**
+  * Deletes a world from the list of worlds.
+  *
+  * @param {World} world - The world to be deleted.
+  *
+  * @throws {Error} - Throws an error if the provided world is not found in the list.
+  *
+  * @returns {void}
+  */
   delete(t) {
+    if (!this.list.has(t.uuid))
+      throw new Error("The provided world is not found in the list!");
     const e = t.uuid;
     this.list.delete(t.uuid), t.dispose(), this.onWorldDeleted.trigger(e);
   }
+  /**
+  * Disposes of the Worlds component and all its managed worlds.
+  * This method sets the enabled flag to false, disposes of all worlds, clears the list,
+  * and triggers the onDisposed event.
+  *
+  * @returns {void}
+  */
   dispose() {
     this.enabled = !1;
     for (const [t, e] of this.list)
       e.dispose();
     this.list.clear(), this.onDisposed.trigger();
   }
+  /** {@link Updateable.update} */
   update(t) {
     if (this.enabled)
       for (const [e, i] of this.list)
@@ -4670,14 +4878,17 @@ const gs = class gs extends J {
  * A unique identifier for the component.
  * This UUID is used to register the component within the Components system.
  */
-I(gs, "uuid", "fdb61dc4-2ec1-4966-b83d-54ea795fad4a");
-let Ci = gs;
+I(Os, "uuid", "fdb61dc4-2ec1-4966-b83d-54ea795fad4a");
+let Ci = Os;
 class Pr {
   constructor(s, t, e) {
     /** {@link Disposable.onDisposed} */
     I(this, "onDisposed", new D());
+    /** The world instance to which this Raycaster belongs. */
     I(this, "world");
+    /** The components instance to which this grid belongs. */
     I(this, "components");
+    /** The Three.js mesh that contains the infinite grid. */
     I(this, "three");
     I(this, "_fade", 3);
     I(this, "updateZoom", () => {
@@ -4686,8 +4897,8 @@ class Pr {
     this.world = t;
     const { color: i, size1: o, size2: n, distance: r } = e;
     this.components = s;
-    const a = new g.PlaneGeometry(2, 2, 1, 1), c = new g.ShaderMaterial({
-      side: g.DoubleSide,
+    const a = new O.PlaneGeometry(2, 2, 1, 1), c = new O.ShaderMaterial({
+      side: O.DoubleSide,
       uniforms: {
         uSize1: {
           value: o
@@ -4776,7 +4987,7 @@ class Pr {
         derivatives: !0
       }
     });
-    this.three = new g.Mesh(a, c), this.three.frustumCulled = !1, t.scene.three.add(this.three), this.setupEvents(!0);
+    this.three = new O.Mesh(a, c), this.three.frustumCulled = !1, t.scene.three.add(this.three), this.setupEvents(!0);
   }
   /** {@link Hideable.visible} */
   get visible() {
@@ -4818,18 +5029,34 @@ class Pr {
 const Ss = class Ss extends J {
   constructor(t) {
     super(t);
+    /**
+     * A map of world UUIDs to their corresponding grid instances.
+     */
     I(this, "list", /* @__PURE__ */ new Map());
-    I(this, "onDisposed", new D());
+    /**
+     * The default configuration for grid creation.
+     */
     I(this, "config", {
-      color: new g.Color(12303291),
+      color: new O.Color(12303291),
       size1: 1,
       size2: 10,
       distance: 500
     });
+    /** {@link Disposable.onDisposed} */
+    I(this, "onDisposed", new D());
     /** {@link Component.enabled} */
     I(this, "enabled", !0);
     t.add(Ss.uuid, this);
   }
+  /**
+  * Creates a new grid for the given world.
+  * Throws an error if a grid already exists for the world.
+  *
+  * @param world - The world to create the grid for.
+  * @returns The newly created grid.
+  *
+  * @throws Will throw an error if a grid already exists for the given world.
+  */
   create(t) {
     if (this.list.has(t.uuid))
       throw new Error("This world already has a grid!");
@@ -4838,16 +5065,31 @@ const Ss = class Ss extends J {
       this.delete(t);
     }), e;
   }
+  /**
+   * Deletes the grid associated with the given world.
+   * If a grid does not exist for the given world, this method does nothing.
+   *
+   * @param world - The world for which to delete the grid.
+   *
+   * @remarks
+   * This method will dispose of the grid and remove it from the internal list.
+   * If the world is disposed before calling this method, the grid will be automatically deleted.
+   */
   delete(t) {
     const e = this.list.get(t.uuid);
     e && e.dispose(), this.list.delete(t.uuid);
   }
+  /** {@link Disposable.dispose} */
   dispose() {
     for (const [t, e] of this.list)
       e.dispose();
     this.list.clear(), this.onDisposed.trigger(), this.onDisposed.reset();
   }
 };
+/**
+ * A unique identifier for the component.
+ * This UUID is used to register the component within the Components system.
+ */
 I(Ss, "uuid", "d1e814d5-b81c-4452-87a2-f039375e0489");
 let un = Ss;
 const jt = new qn(), nt = new w(), xt = new w(), j = new Pt(), In = {
@@ -5090,7 +5332,7 @@ class xr extends ri {
       XZ: [
         [new v(new rt(0.15, 0.15, 0.01), c.clone()), [0.15, 0, 0.15], [-Math.PI / 2, 0, 0]]
       ]
-    }, O = {
+    }, g = {
       X: [
         [new v(new ct(0.2, 0, 0.6, 4), e), [0.3, 0, 0], [0, 0, -Math.PI / 2]],
         [new v(new ct(0.2, 0, 0.6, 4), e), [-0.3, 0, 0], [0, 0, Math.PI / 2]]
@@ -5245,7 +5487,7 @@ class xr extends ri {
         }
       return H;
     }
-    this.gizmo = {}, this.picker = {}, this.helper = {}, this.add(this.gizmo.translate = b(T)), this.add(this.gizmo.rotate = b(_)), this.add(this.gizmo.scale = b(M)), this.add(this.picker.translate = b(O)), this.add(this.picker.rotate = b(L)), this.add(this.picker.scale = b(y)), this.add(this.helper.translate = b(S)), this.add(this.helper.rotate = b(N)), this.add(this.helper.scale = b(x)), this.picker.translate.visible = !1, this.picker.rotate.visible = !1, this.picker.scale.visible = !1;
+    this.gizmo = {}, this.picker = {}, this.helper = {}, this.add(this.gizmo.translate = b(T)), this.add(this.gizmo.rotate = b(_)), this.add(this.gizmo.scale = b(M)), this.add(this.picker.translate = b(g)), this.add(this.picker.rotate = b(L)), this.add(this.picker.scale = b(y)), this.add(this.helper.translate = b(S)), this.add(this.helper.rotate = b(N)), this.add(this.helper.scale = b(x)), this.picker.translate.visible = !1, this.picker.rotate.visible = !1, this.picker.scale.visible = !1;
   }
   // updateMatrixWorld will update transformations and appearance of individual handles
   updateMatrixWorld(s) {
@@ -5320,19 +5562,30 @@ class Pi {
     I(this, "onDraggingEnded", new D());
     /** {@link Disposable.onDisposed} */
     I(this, "onDisposed", new D());
+    /**
+     * The normal vector of the clipping plane.
+     */
     I(this, "normal");
+    /**
+     * The origin point of the clipping plane.
+     */
     I(this, "origin");
-    I(this, "three", new g.Plane());
+    /**
+     * The THREE.js Plane object representing the clipping plane.
+     */
+    I(this, "three", new O.Plane());
+    /** The components instance to which this plane belongs. */
+    I(this, "components");
+    /** The world instance to which this plane belongs. */
+    I(this, "world");
     I(this, "_helper");
     I(this, "_visible", !0);
     I(this, "_enabled", !0);
-    I(this, "components");
-    I(this, "world");
     I(this, "_controlsActive", !1);
-    I(this, "_arrowBoundBox", new g.Mesh());
+    I(this, "_arrowBoundBox", new O.Mesh());
     I(this, "_planeMesh");
     I(this, "_controls");
-    I(this, "_hiddenMaterial", new g.MeshBasicMaterial({
+    I(this, "_hiddenMaterial", new O.MeshBasicMaterial({
       visible: !1
     }));
     /** {@link Updateable.update} */
@@ -5349,10 +5602,18 @@ class Pi {
       throw new Error("The given world must have a renderer!");
     this.normal = i, this.origin = e, t.renderer.setPlane(!0, this.three), this._planeMesh = Pi.newPlaneMesh(n, o), this._helper = this.newHelper(), this._controls = this.newTransformControls(), this.three.setFromNormalAndCoplanarPoint(i, e), r && this.toggleControls(!0);
   }
+  /**
+   * Getter for the enabled state of the clipping plane.
+   * @returns {boolean} The current enabled state.
+   */
   get enabled() {
     return this._enabled;
   }
-  /** {@link Component.enabled} */
+  /**
+   * Setter for the enabled state of the clipping plane.
+   * Updates the clipping plane state in the renderer and throws an error if no renderer is found.
+   * @param {boolean} state - The new enabled state.
+   */
   set enabled(s) {
     if (!this.world.renderer)
       throw new Error("No renderer found for clipping plane!");
@@ -5386,9 +5647,26 @@ class Pi {
   set size(s) {
     this._planeMesh.scale.set(s, s, s);
   }
+  /**
+  * Getter for the helper object of the clipping plane.
+  * The helper object is a THREE.Object3D that contains the clipping plane mesh and other related objects.
+  * It is used for positioning, rotating, and scaling the clipping plane in the 3D scene.
+  *
+  * @returns {THREE.Object3D} The helper object of the clipping plane.
+  */
   get helper() {
     return this._helper;
   }
+  /**
+  * Sets the clipping plane's normal and origin from the given normal and point.
+  * This method resets the clipping plane's state, updates the normal and origin,
+  * and positions the helper object accordingly.
+  *
+  * @param normal - The new normal vector for the clipping plane.
+  * @param point - The new origin point for the clipping plane.
+  *
+  * @returns {void}
+  */
   setFromNormalAndCoplanarPoint(s, t) {
     this.reset(), this.normal.equals(s) || (this.normal.copy(s), this._helper.lookAt(s)), this.origin.copy(t), this._helper.position.copy(t), this._helper.updateMatrix(), this.update();
   }
@@ -5397,7 +5675,7 @@ class Pi {
     this._enabled = !1, this.onDraggingStarted.reset(), this.onDraggingEnded.reset(), this._helper.removeFromParent(), this.world.renderer && this.world.renderer.setPlane(!1, this.three), this._arrowBoundBox.removeFromParent(), this._arrowBoundBox.geometry.dispose(), this._planeMesh.geometry.dispose(), this._controls.removeFromParent(), this._controls.dispose(), this.onDisposed.trigger(), this.onDisposed.reset();
   }
   reset() {
-    const s = new g.Vector3(1, 0, 0), t = new g.Vector3();
+    const s = new O.Vector3(1, 0, 0), t = new O.Vector3();
     this.normal.equals(s) || (this.normal.copy(s), this._helper.lookAt(s)), this.origin.copy(t), this._helper.position.copy(t), this._helper.updateMatrix();
   }
   toggleControls(s) {
@@ -5419,7 +5697,7 @@ class Pi {
     s.attach(this._helper), s.showX = !1, s.showY = !1, s.setSpace("local"), this.createArrowBoundingBox(), s.children[0].children[0].add(this._arrowBoundBox);
   }
   createArrowBoundingBox() {
-    this._arrowBoundBox.geometry = new g.CylinderGeometry(0.18, 0.18, 1.2), this._arrowBoundBox.material = this._hiddenMaterial, this._arrowBoundBox.rotateX(Math.PI / 2), this._arrowBoundBox.updateMatrix(), this._arrowBoundBox.geometry.applyMatrix4(this._arrowBoundBox.matrix);
+    this._arrowBoundBox.geometry = new O.CylinderGeometry(0.18, 0.18, 1.2), this._arrowBoundBox.material = this._hiddenMaterial, this._arrowBoundBox.rotateX(Math.PI / 2), this._arrowBoundBox.updateMatrix(), this._arrowBoundBox.geometry.applyMatrix4(this._arrowBoundBox.matrix);
   }
   notifyDraggingChanged(s) {
     s.value ? this.onDraggingStarted.trigger() : this.onDraggingEnded.trigger();
@@ -5428,29 +5706,47 @@ class Pi {
     this.world.camera.enabled = this._visible;
   }
   newHelper() {
-    const s = new g.Object3D();
+    const s = new O.Object3D();
     return s.lookAt(this.normal), s.position.copy(this.origin), this._planeMesh.position.z += 0.01, s.add(this._planeMesh), this.world.scene.three.add(s), s;
   }
   static newPlaneMesh(s, t) {
-    const e = new g.PlaneGeometry(1), i = new g.Mesh(e, t);
+    const e = new O.PlaneGeometry(1), i = new O.Mesh(e, t);
     return i.scale.set(s, s, s), i;
   }
 }
 const Be = class Be extends J {
   constructor(t) {
     super(t);
-    /** {@link Createable.onAfterCreate} */
-    I(this, "onAfterCreate", new D());
-    /** {@link Createable.onAfterDelete} */
-    I(this, "onAfterDelete", new D());
     /** Event that fires when the user starts dragging a clipping plane. */
     I(this, "onBeforeDrag", new D());
     /** Event that fires when the user stops dragging a clipping plane. */
     I(this, "onAfterDrag", new D());
+    /**
+     * Event that fires when the user starts creating a clipping plane.
+     */
     I(this, "onBeforeCreate", new D());
+    /**
+     * Event that fires when the user cancels the creation of a clipping plane.
+     */
     I(this, "onBeforeCancel", new D());
+    /**
+     * Event that fires after the user cancels the creation of a clipping plane.
+     */
     I(this, "onAfterCancel", new D());
+    /**
+     * Event that fires when the user starts deleting a clipping plane.
+     */
     I(this, "onBeforeDelete", new D());
+    /**
+     * Event that fires after a clipping plane has been created.
+     * @param plane - The newly created clipping plane.
+     */
+    I(this, "onAfterCreate", new D());
+    /**
+     * Event that fires after a clipping plane has been deleted.
+     * @param plane - The deleted clipping plane.
+     */
+    I(this, "onAfterDelete", new D());
     /** {@link Disposable.onDisposed} */
     I(this, "onDisposed", new D());
     /**
@@ -5466,12 +5762,19 @@ const Be = class Be extends J {
      * has to be `true` for this to apply.
      */
     I(this, "toleranceOrthogonalY", 0.7);
+    /**
+     * The type of clipping plane to be created.
+     * Default is {@link SimplePlane}.
+     */
     I(this, "Type", Pi);
+    /**
+     * A list of all the clipping planes created by this component.
+     */
     I(this, "list", []);
     /** The material used in all the clipping planes. */
-    I(this, "_material", new g.MeshBasicMaterial({
+    I(this, "_material", new O.MeshBasicMaterial({
       color: 12255487,
-      side: g.DoubleSide,
+      side: O.DoubleSide,
       transparent: !0,
       opacity: 0.2
     }));
@@ -5596,7 +5899,7 @@ const Be = class Be extends J {
     var a;
     if (!t.renderer)
       throw new Error("The given world must have a renderer!");
-    const i = e.point.distanceTo(new g.Vector3(0, 0, 0)), o = (a = e.face) == null ? void 0 : a.normal;
+    const i = e.point.distanceTo(new O.Vector3(0, 0, 0)), o = (a = e.face) == null ? void 0 : a.normal;
     if (!i || !o)
       return;
     const n = this.getWorldNormal(e, o), r = this.newPlane(t, e.point, n.negate());
@@ -5605,11 +5908,11 @@ const Be = class Be extends J {
   getWorldNormal(t, e) {
     const i = t.object;
     let o = t.object.matrixWorld.clone();
-    if (i instanceof g.InstancedMesh && t.instanceId !== void 0) {
-      const c = new g.Matrix4();
+    if (i instanceof O.InstancedMesh && t.instanceId !== void 0) {
+      const c = new O.Matrix4();
       i.getMatrixAt(t.instanceId, c), o = c.multiply(o);
     }
-    const r = new g.Matrix3().getNormalMatrix(o), a = e.clone().applyMatrix3(r).normalize();
+    const r = new O.Matrix3().getNormalMatrix(o), a = e.clone().applyMatrix3(r).normalize();
     return this.normalizePlaneDirectionY(a), a;
   }
   normalizePlaneDirectionY(t) {
@@ -5641,6 +5944,10 @@ const Be = class Be extends J {
     }
   }
 };
+/**
+ * A unique identifier for the component.
+ * This UUID is used to register the component within the Components system.
+ */
 I(Be, "uuid", "66290bc5-18c4-4cd1-9379-2e17a0617611");
 let An = Be;
 function vr(l, s, t, e) {
@@ -5678,7 +5985,9 @@ class Vr {
      * just before but not anymore.
      */
     I(this, "onViewUpdated", new $t());
-    /** {@link Component.enabled} */
+    /**
+     * Whether this renderer is active or not. If not, it won't render anything.
+     */
     I(this, "enabled", !0);
     /**
      * Needs to check whether there are objects that need to be hidden or shown.
@@ -5690,13 +5999,16 @@ class Vr {
      * for debugging purposes.
      */
     I(this, "renderDebugFrame", !1);
+    /** The components instance to which this renderer belongs. */
     I(this, "components");
+    /** The world instance to which this renderer belongs. */
     I(this, "world");
+    /** The THREE.js renderer used to make the visibility test. */
     I(this, "renderer");
     I(this, "autoUpdate", !0);
     I(this, "updateInterval", 1e3);
     I(this, "worker");
-    I(this, "scene", new g.Scene());
+    I(this, "scene", new O.Scene());
     I(this, "_width", 512);
     I(this, "_height", 512);
     I(this, "_availableColor", 1);
@@ -5733,7 +6045,7 @@ class Vr {
     });
     if (!t.renderer)
       throw new Error("The given world must have a renderer!");
-    this.components = s, this.applySettings(e), this.world = t, this.renderer = new g.WebGLRenderer(), this.renderTarget = new g.WebGLRenderTarget(this._width, this._height), this.bufferSize = this._width * this._height * 4, this._buffer = new Uint8Array(this.bufferSize), this.renderer.clippingPlanes = t.renderer.clippingPlanes;
+    this.components = s, this.applySettings(e), this.world = t, this.renderer = new O.WebGLRenderer(), this.renderTarget = new O.WebGLRenderTarget(this._width, this._height), this.bufferSize = this._width * this._height * 4, this._buffer = new Uint8Array(this.bufferSize), this.renderer.clippingPlanes = t.renderer.clippingPlanes;
     const i = `
       addEventListener("message", (event) => {
         const { buffer } = event.data;
@@ -5793,17 +6105,32 @@ class Vr {
 class Gr extends Vr {
   constructor(t, e, i) {
     super(t, e, i);
-    /* Pixels in screen a geometry must occupy to be considered "seen". */
-    I(this, "threshold", 100);
+    /**
+     * Event triggered when the visibility of meshes is updated.
+     * Contains two sets: seen and unseen.
+     */
     I(this, "onViewUpdated", new D());
+    /**
+     * Pixels in screen a geometry must occupy to be considered "seen".
+     * Default value is 100.
+     */
+    I(this, "threshold", 100);
+    /**
+     * Map of color code to THREE.InstancedMesh.
+     * Used to keep track of color-coded meshes.
+     */
     I(this, "colorMeshes", /* @__PURE__ */ new Map());
+    /**
+     * Flag to indicate if the renderer is currently processing.
+     * Used to prevent concurrent processing.
+     */
     I(this, "isProcessing", !1);
     I(this, "_colorCodeMeshMap", /* @__PURE__ */ new Map());
     I(this, "_meshIDColorCodeMap", /* @__PURE__ */ new Map());
     I(this, "_currentVisibleMeshes", /* @__PURE__ */ new Set());
     I(this, "_recentlyHiddenMeshes", /* @__PURE__ */ new Set());
     I(this, "_intervalID", null);
-    I(this, "_transparentMat", new g.MeshBasicMaterial({
+    I(this, "_transparentMat", new O.MeshBasicMaterial({
       transparent: !0,
       opacity: 0
     }));
@@ -5832,6 +6159,7 @@ class Gr extends Vr {
         r.visible = !1;
     });
   }
+  /** {@link Disposable.dispose} */
   dispose() {
     super.dispose(), this._intervalID !== null && (window.clearInterval(this._intervalID), this._intervalID = null), this._currentVisibleMeshes.clear(), this._recentlyHiddenMeshes.clear(), this._meshIDColorCodeMap.clear(), this._transparentMat.dispose(), this._colorCodeMeshMap.clear();
     const t = this.components.get(zt);
@@ -5841,6 +6169,11 @@ class Gr extends Vr {
     }
     this.colorMeshes.clear();
   }
+  /**
+   * Adds a mesh to the culler. When the mesh is not visibile anymore, it will be removed from the scene. When it's visible again, it will be added to the scene.
+   * @param mesh - The mesh to add. It can be a regular THREE.Mesh or an instance of THREE.InstancedMesh.
+   * @returns {void}
+   */
   add(t) {
     if (!this.enabled)
       return;
@@ -5849,7 +6182,7 @@ class Gr extends Vr {
       return;
     }
     this.isProcessing = !0;
-    const e = t instanceof g.InstancedMesh, { geometry: i, material: o } = t, { colorMaterial: n, code: r } = this.getAvailableMaterial();
+    const e = t instanceof O.InstancedMesh, { geometry: i, material: o } = t, { colorMaterial: n, code: r } = this.getAvailableMaterial();
     let a;
     if (Array.isArray(o)) {
       let d = !0;
@@ -5867,9 +6200,15 @@ class Gr extends Vr {
     } else
       a = n;
     this._colorCodeMeshMap.set(r, t), this._meshIDColorCodeMap.set(t.uuid, r);
-    const c = e ? t.count : 1, h = new g.InstancedMesh(i, a, c);
-    e ? h.instanceMatrix = t.instanceMatrix : h.setMatrixAt(0, new g.Matrix4()), t.visible = !1, h.applyMatrix4(t.matrix), h.updateMatrix(), this.scene.add(h), this.colorMeshes.set(t.uuid, h), this.increaseColor(), this.isProcessing = !1;
+    const c = e ? t.count : 1, h = new O.InstancedMesh(i, a, c);
+    e ? h.instanceMatrix = t.instanceMatrix : h.setMatrixAt(0, new O.Matrix4()), t.visible = !1, h.applyMatrix4(t.matrix), h.updateMatrix(), this.scene.add(h), this.colorMeshes.set(t.uuid, h), this.increaseColor(), this.isProcessing = !1;
   }
+  /**
+  * Removes a mesh from the culler, so its visibility is not controlled by the culler anymore.
+  * When the mesh is removed, it will be hidden from the scene and its color-coded mesh will be destroyed.
+  * @param mesh - The mesh to remove. It can be a regular THREE.Mesh or an instance of THREE.InstancedMesh.
+  * @returns {void}
+  */
   remove(t) {
     if (this.isProcessing) {
       console.log("Culler processing not finished yet.");
@@ -5886,70 +6225,66 @@ class Gr extends Vr {
     this._colorCodeMeshMap.delete(o), this._meshIDColorCodeMap.delete(t.uuid), this.colorMeshes.delete(t.uuid), i.geometry = void 0, i.material = [], e.destroy(i, !0), this._recentlyHiddenMeshes.delete(t), this._currentVisibleMeshes.delete(t), this.isProcessing = !1;
   }
   getAvailableMaterial() {
-    const { r: t, g: e, b: i, code: o } = this.getAvailableColor(), n = g.ColorManagement.enabled;
-    g.ColorManagement.enabled = !1;
-    const r = new g.Color(`rgb(${t}, ${e}, ${i})`);
+    const { r: t, g: e, b: i, code: o } = this.getAvailableColor(), n = O.ColorManagement.enabled;
+    O.ColorManagement.enabled = !1;
+    const r = new O.Color(`rgb(${t}, ${e}, ${i})`);
     if (!this.world.renderer)
       throw new Error("Renderer not found in the world!");
-    const a = this.world.renderer.clippingPlanes, c = new g.MeshBasicMaterial({
+    const a = this.world.renderer.clippingPlanes, c = new O.MeshBasicMaterial({
       color: r,
       clippingPlanes: a,
-      side: g.DoubleSide
+      side: O.DoubleSide
     });
-    return g.ColorManagement.enabled = n, { colorMaterial: c, code: o };
+    return O.ColorManagement.enabled = n, { colorMaterial: c, code: o };
   }
 }
 const Ye = class Ye extends J {
   constructor(t) {
     super(t);
     /**
-     * Indicates whether the Cullers component is enabled.
-     */
+    * An event that is triggered when the Cullers component is disposed.
+    */
+    I(this, "onDisposed", new D());
     I(this, "_enabled", !0);
     /**
      * A map of MeshCullerRenderer instances, keyed by their world UUIDs.
      */
     I(this, "list", /* @__PURE__ */ new Map());
-    /**
-     * An event that is triggered when the Cullers component is disposed.
-     */
-    I(this, "onDisposed", new D());
     t.add(Ye.uuid, this);
   }
-  /**
-   * Gets the enabled state of the Cullers component.
-   *
-   * @returns The current enabled state.
-   */
+  /** {@link Component.enabled} */
   get enabled() {
     return this._enabled;
   }
-  /**
-   * Sets the enabled state of the Cullers component.
-   * Also sets the enabled state of all MeshCullerRenderer instances.
-   *
-   * @param value - The new enabled state.
-   */
+  /** {@link Component.enabled} */
   set enabled(t) {
     this._enabled = t;
     for (const [e, i] of this.list)
       i.enabled = t;
   }
   /**
-  * Creates a new MeshCullerRenderer for the given world.
-  * If a MeshCullerRenderer already exists for the world, it will return the existing one.
-  *
-  * @param world - The world for which to create the MeshCullerRenderer.
-  * @param config - Optional configuration settings for the MeshCullerRenderer.
-  *
-  * @returns The newly created or existing MeshCullerRenderer for the given world.
-  */
+   * Creates a new MeshCullerRenderer for the given world.
+   * If a MeshCullerRenderer already exists for the world, it will return the existing one.
+   *
+   * @param world - The world for which to create the MeshCullerRenderer.
+   * @param config - Optional configuration settings for the MeshCullerRenderer.
+   *
+   * @returns The newly created or existing MeshCullerRenderer for the given world.
+   */
   create(t, e) {
     if (this.list.has(t.uuid))
       return this.list.get(t.uuid);
     const i = new Gr(this.components, t, e);
     return this.list.set(t.uuid, i), i;
   }
+  /**
+   * Deletes the MeshCullerRenderer associated with the given world.
+   * If a MeshCullerRenderer exists for the given world, it will be disposed and removed from the list.
+   *
+   * @param world - The world for which to delete the MeshCullerRenderer.
+   *
+   * @returns {void}
+   */
   delete(t) {
     const e = this.list.get(t.uuid);
     e && e.dispose(), this.list.delete(t.uuid);
@@ -5963,7 +6298,8 @@ const Ye = class Ye extends J {
   }
 };
 /**
- * A unique identifier for the Cullers component.
+ * A unique identifier for the component.
+ * This UUID is used to register the component within the Components system.
  */
 I(Ye, "uuid", "69f2a50d-c266-44fc-b1bd-fa4d34be89e6");
 let Ti = Ye;
@@ -5971,24 +6307,51 @@ class zr {
   constructor(s) {
     /** {@link Disposable.onDisposed} */
     I(this, "onDisposed", new D());
+    /** {@link Updateable.onAfterUpdate} */
     I(this, "onAfterUpdate", new D());
+    /** {@link Updateable.onBeforeUpdate} */
     I(this, "onBeforeUpdate", new D());
+    /** {@link Resizeable.onResize} */
     I(this, "onResize", new D());
-    // By pushing the map to the front, what the user sees on screen corresponds with what they see on the map
+    /**
+     * The front offset of the minimap.
+     * It determines how much the minimap's view is offset from the camera's view.
+     * By pushing the map to the front, what the user sees on screen corresponds with what they see on the map
+     */
     I(this, "frontOffset", 0);
-    I(this, "overrideMaterial", new g.MeshDepthMaterial());
-    I(this, "backgroundColor", new g.Color(395274));
+    /**
+     * The override material for the minimap.
+     * It is used to render the depth information of the world onto the minimap.
+     */
+    I(this, "overrideMaterial", new O.MeshDepthMaterial());
+    /**
+     * The background color of the minimap.
+     * It is used to set the background color of the minimap's renderer.
+     */
+    I(this, "backgroundColor", new O.Color(395274));
+    /**
+     * The WebGL renderer for the minimap.
+     * It is used to render the minimap onto the screen.
+     */
     I(this, "renderer");
+    /**
+     * A flag indicating whether the minimap is enabled.
+     * If disabled, the minimap will not update or render.
+     */
     I(this, "enabled", !0);
+    /**
+     * The world in which the minimap is displayed.
+     * It provides access to the 3D scene, camera, and other relevant world elements.
+     */
     I(this, "world");
     I(this, "_lockRotation", !0);
     I(this, "_camera");
     I(this, "_plane");
-    I(this, "_size", new g.Vector2(320, 160));
-    I(this, "_tempVector1", new g.Vector3());
-    I(this, "_tempVector2", new g.Vector3());
-    I(this, "_tempTarget", new g.Vector3());
-    I(this, "down", new g.Vector3(0, -1, 0));
+    I(this, "_size", new O.Vector2(320, 160));
+    I(this, "_tempVector1", new O.Vector3());
+    I(this, "_tempVector2", new O.Vector3());
+    I(this, "_tempTarget", new O.Vector3());
+    I(this, "down", new O.Vector3(0, -1, 0));
     I(this, "updatePlanes", () => {
       if (!this.world.renderer)
         throw new Error("The given world must have a renderer!");
@@ -5999,33 +6362,55 @@ class zr {
     });
     if (this.world = s, !this.world.renderer)
       throw new Error("The given world must have a renderer!");
-    this.renderer = new g.WebGLRenderer(), this.renderer.setSize(this._size.x, this._size.y);
+    this.renderer = new O.WebGLRenderer(), this.renderer.setSize(this._size.x, this._size.y);
     const t = 1, e = this._size.x / this._size.y;
-    this._camera = new g.OrthographicCamera(
+    this._camera = new O.OrthographicCamera(
       t * e / -2,
       t * e / 2,
       t / 2,
       t / -2
-    ), this.world.renderer.onClippingPlanesUpdated.add(this.updatePlanes), this._camera.position.set(0, 200, 0), this._camera.zoom = 0.1, this._camera.rotation.x = -Math.PI / 2, this._plane = new g.Plane(this.down, 200), this.updatePlanes();
+    ), this.world.renderer.onClippingPlanesUpdated.add(this.updatePlanes), this._camera.position.set(0, 200, 0), this._camera.zoom = 0.1, this._camera.rotation.x = -Math.PI / 2, this._plane = new O.Plane(this.down, 200), this.updatePlanes();
   }
+  /**
+  * Gets or sets whether the minimap rotation is locked.
+  * When rotation is locked, the minimap will always face the same direction as the camera.
+  */
   get lockRotation() {
     return this._lockRotation;
   }
+  /**
+  * Sets whether the minimap rotation is locked.
+  * When rotation is locked, the minimap will always face the same direction as the camera.
+  * @param active - If `true`, rotation is locked. If `false`, rotation is not locked.
+  */
   set lockRotation(s) {
     this._lockRotation = s, s && (this._camera.rotation.z = 0);
   }
+  /**
+  * Gets the current zoom level of the minimap.
+  * The zoom level determines how much of the world is visible on the minimap.
+  * @returns The current zoom level of the minimap.
+  */
   get zoom() {
     return this._camera.zoom;
   }
+  /**
+  * Sets the zoom level of the minimap.
+  * The zoom level determines how much of the world is visible on the minimap.
+  * @param value - The new zoom level of the minimap.
+  */
   set zoom(s) {
     this._camera.zoom = s, this._camera.updateProjectionMatrix();
   }
+  /** {@link Disposable.dispose} */
   dispose() {
     this.enabled = !1, this.onBeforeUpdate.reset(), this.onAfterUpdate.reset(), this.onResize.reset(), this.overrideMaterial.dispose(), this.renderer.dispose(), this.onDisposed.trigger(), this.onDisposed.reset();
   }
+  /** Returns the camera used by the MiniMap */
   get() {
     return this._camera;
   }
+  /** {@link Updateable.update} */
   update() {
     if (!this.enabled)
       return;
@@ -6033,7 +6418,7 @@ class zr {
     const s = this.world.scene.three, t = this.world.camera;
     if (!t.hasCameraControls())
       throw new Error("The given world must use camera controls!");
-    if (!(s instanceof g.Scene))
+    if (!(s instanceof O.Scene))
       throw new Error("The given world must have a THREE.Scene as a root!");
     const e = t.controls;
     if (e.getPosition(this._tempVector1), this._camera.position.x = this._tempVector1.x, this._camera.position.z = this._tempVector1.z, this.frontOffset !== 0 && (e.getTarget(this._tempVector2), this._tempVector2.sub(this._tempVector1), this._tempVector2.normalize().multiplyScalar(this.frontOffset), this._camera.position.x += this._tempVector2.x, this._camera.position.z += this._tempVector2.z), !this._lockRotation) {
@@ -6048,9 +6433,11 @@ class zr {
     const i = s.background;
     s.background = this.backgroundColor, this.renderer.render(s, this._camera), s.background = i, this.onAfterUpdate.trigger();
   }
+  /** {@link Resizeable.getSize} */
   getSize() {
     return this._size;
   }
+  /** {@link Resizeable.resize} */
   resize(s = this._size) {
     this._size.copy(s), this.renderer.setSize(s.x, s.y);
     const t = s.x / s.y, e = 1;
@@ -6060,33 +6447,61 @@ class zr {
 const _s = class _s extends J {
   constructor(t) {
     super(t);
+    /** {@link Updateable.onAfterUpdate} */
     I(this, "onAfterUpdate", new D());
+    /** {@link Updateable.onBeforeUpdate} */
     I(this, "onBeforeUpdate", new D());
+    /** {@link Disposable.onDisposed} */
     I(this, "onDisposed", new D());
+    /** {@link Component.enabled} */
     I(this, "enabled", !0);
+    /**
+    * A collection of {@link MiniMap} instances, each associated with a unique world ID.
+    */
     I(this, "list", /* @__PURE__ */ new Map());
     this.components.add(_s.uuid, this);
   }
+  /**
+  * Creates a new {@link MiniMap} instance associated with the given world.
+  * If a {@link MiniMap} instance already exists for the given world, an error will be thrown.
+  *
+  * @param world - The {@link World} for which to create a {@link MiniMap} instance.
+  * @returns The newly created {@link MiniMap} instance.
+  * @throws Will throw an error if a {@link MiniMap} instance already exists for the given world.
+  */
   create(t) {
     if (this.list.has(t.uuid))
       throw new Error("This world already has a minimap!");
     const e = new zr(t);
     return this.list.set(t.uuid, e), e;
   }
+  /**
+  * Deletes a {@link MiniMap} instance associated with the given world ID.
+  * If a {@link MiniMap} instance does not exist for the given ID, nothing happens.
+  *
+  * @param id - The unique identifier of the world for which to delete the {@link MiniMap} instance.
+  * @returns {void}
+  */
   delete(t) {
     const e = this.list.get(t);
     e && e.dispose(), this.list.delete(t);
   }
+  /** {@link Disposable.dispose} */
   dispose() {
     for (const [t, e] of this.list)
       e.dispose();
     this.list.clear(), this.onDisposed.trigger();
   }
+  /** {@link Updateable.update} */
   update() {
     for (const [t, e] of this.list)
       e.update();
   }
 };
+/**
+* A unique identifier for the component.
+* This UUID is used to register the component within the Components system.
+*/
 I(_s, "uuid", "39ad6aad-84c8-4adf-a1e0-7f25313a9e7f");
 let Fn = _s;
 class Hr {
@@ -6108,7 +6523,7 @@ class Hr {
     }
   }
   setupFirstPersonCamera() {
-    const s = this.camera.controls, t = new g.Vector3();
+    const s = this.camera.controls, t = new O.Vector3();
     s.distance--, s.getPosition(t), s.minDistance = 1, s.maxDistance = 1, s.distance = 1, s.moveTo(
       t.x,
       t.y,
@@ -6131,11 +6546,11 @@ class kr {
   activateOrbitControls() {
     const s = this.camera.controls;
     s.minDistance = 1, s.maxDistance = 300;
-    const t = new g.Vector3();
+    const t = new O.Vector3();
     s.getPosition(t);
     const e = t.length();
     s.distance = e, s.truckSpeed = 2;
-    const { rotation: i } = this.camera.three, o = new g.Vector3(0, 0, -1).applyEuler(i), n = t.addScaledVector(o, e);
+    const { rotation: i } = this.camera.three, o = new O.Vector3(0, 0, -1).applyEuler(i), n = t.addScaledVector(o, e);
     s.moveTo(n.x, n.y, n.z);
   }
 }
@@ -6165,12 +6580,20 @@ class Xr {
      * Event that fires when the {@link CameraProjection} changes.
      */
     I(this, "onChanged", new D());
+    /**
+     * Current projection mode of the camera.
+     * Default is "Perspective".
+     */
     I(this, "current", "Perspective");
+    /**
+     * The camera controlled by this ProjectionManager.
+     * It can be either a PerspectiveCamera or an OrthographicCamera.
+     */
     I(this, "camera");
-    I(this, "_component");
-    I(this, "_previousDistance", -1);
     /** Match Ortho zoom with Perspective distance when changing projection mode */
     I(this, "matchOrthoDistanceEnabled", !1);
+    I(this, "_component");
+    I(this, "_previousDistance", -1);
     this._component = s, this.camera = s.three;
   }
   /**
@@ -6204,9 +6627,9 @@ class Xr {
     const s = this._component.currentWorld;
     if (!s || !s.renderer)
       return null;
-    const t = new g.Vector3();
+    const t = new O.Vector3();
     this._component.threePersp.getWorldDirection(t);
-    const e = new g.Vector3();
+    const e = new O.Vector3();
     this._component.controls.getTarget(e);
     const o = e.clone().sub(this._component.threePersp.position).dot(t), n = s.renderer.getSize(), r = n.x / n.y, a = this._component.threePersp, c = o * 2 * Math.atan(a.fov * (Math.PI / 180) / 2);
     return { width: c * r, height: c };
@@ -6230,15 +6653,23 @@ class oa extends ke {
   constructor(t) {
     super(t);
     /**
-     * The current {@link NavigationMode}.
+     * A ProjectionManager instance that manages the projection modes of the camera.
      */
-    I(this, "_mode", null);
     I(this, "projection");
+    /**
+     * A THREE.OrthographicCamera instance that represents the orthographic camera.
+     * This camera is used when the projection mode is set to orthographic.
+     */
     I(this, "threeOrtho");
+    /**
+     * A THREE.PerspectiveCamera instance that represents the perspective camera.
+     * This camera is used when the projection mode is set to perspective.
+     */
     I(this, "threePersp");
     I(this, "_userInputButtons", {});
     I(this, "_frustumSize", 50);
     I(this, "_navigationModes", /* @__PURE__ */ new Map());
+    I(this, "_mode", null);
     I(this, "previousSize", null);
     this.threePersp = this.three, this.threeOrtho = this.newOrthoCamera(), this.projection = new Xr(this), this.onAspectUpdated.add(() => {
       this.setOrthoPerspCameraAspect();
@@ -6250,6 +6681,14 @@ class oa extends ke {
       e === "added" && (this._navigationModes.clear(), this._navigationModes.set("Orbit", new kr(this)), this._navigationModes.set("FirstPerson", new Hr(this)), this._navigationModes.set("Plan", new Wr(this)), this._mode = this._navigationModes.get("Orbit"), this.mode.set(!0, { preventTargetAdjustment: !0 }), this.currentWorld && this.currentWorld.renderer && (this.previousSize = this.currentWorld.renderer.getSize().clone()));
     });
   }
+  /**
+  * Getter for the current navigation mode.
+  * Throws an error if the mode is not found or the camera is not initialized.
+  *
+  * @returns {NavigationMode} The current navigation mode.
+  *
+  * @throws {Error} Throws an error if the mode is not found or the camera is not initialized.
+  */
   get mode() {
     if (!this._mode)
       throw new Error("Mode not found, camera not initialized");
@@ -6281,16 +6720,16 @@ class oa extends ke {
   async fit(t, e = 1.5) {
     if (!this.enabled)
       return;
-    const i = Number.MAX_VALUE, o = Number.MIN_VALUE, n = new g.Vector3(i, i, i), r = new g.Vector3(o, o, o);
+    const i = Number.MAX_VALUE, o = Number.MIN_VALUE, n = new O.Vector3(i, i, i), r = new O.Vector3(o, o, o);
     for (const u of t) {
-      const p = new g.Box3().setFromObject(u);
+      const p = new O.Box3().setFromObject(u);
       p.min.x < n.x && (n.x = p.min.x), p.min.y < n.y && (n.y = p.min.y), p.min.z < n.z && (n.z = p.min.z), p.max.x > r.x && (r.x = p.max.x), p.max.y > r.y && (r.y = p.max.y), p.max.z > r.z && (r.z = p.max.z);
     }
-    const a = new g.Box3(n, r), c = new g.Vector3();
+    const a = new O.Box3(n, r), c = new O.Vector3();
     a.getSize(c);
-    const h = new g.Vector3();
+    const h = new O.Vector3();
     a.getCenter(h);
-    const d = Math.max(c.x, c.y, c.z) * e, E = new g.Sphere(h, d);
+    const d = Math.max(c.x, c.y, c.z) * e, E = new O.Sphere(h, d);
     await this.controls.fitToSphere(E, !0);
   }
   /**
@@ -6309,7 +6748,7 @@ class oa extends ke {
   }
   newOrthoCamera() {
     const t = window.innerWidth / window.innerHeight;
-    return new g.OrthographicCamera(
+    return new O.OrthographicCamera(
       this._frustumSize * t / -2,
       this._frustumSize * t / 2,
       this._frustumSize / 2,
@@ -6338,12 +6777,12 @@ const At = class At extends J {
     this.components.add(At.uuid, this), this._absoluteMin = At.newBound(!0), this._absoluteMax = At.newBound(!1);
   }
   static getDimensions(t) {
-    const { min: e, max: i } = t, o = Math.abs(i.x - e.x), n = Math.abs(i.y - e.y), r = Math.abs(i.z - e.z), a = new g.Vector3();
+    const { min: e, max: i } = t, o = Math.abs(i.x - e.x), n = Math.abs(i.y - e.y), r = Math.abs(i.z - e.z), a = new O.Vector3();
     return a.subVectors(i, e).divideScalar(2).add(e), { width: o, height: n, depth: r, center: a };
   }
   static newBound(t) {
     const e = t ? 1 : -1;
-    return new g.Vector3(
+    return new O.Vector3(
       e * Number.MAX_VALUE,
       e * Number.MAX_VALUE,
       e * Number.MAX_VALUE
@@ -6353,7 +6792,7 @@ const At = class At extends J {
     const o = i || this.newBound(!1), n = e || this.newBound(!0);
     for (const r of t)
       r.x < n.x && (n.x = r.x), r.y < n.y && (n.y = r.y), r.z < n.z && (n.z = r.z), r.x > o.x && (o.x = r.x), r.y > o.y && (o.y = r.y), r.z > o.z && (o.z = r.z);
-    return new g.Box3(e, i);
+    return new O.Box3(e, i);
   }
   /** {@link Disposable.dispose} */
   dispose() {
@@ -6364,14 +6803,14 @@ const At = class At extends J {
   }
   get() {
     const t = this._absoluteMin.clone(), e = this._absoluteMax.clone();
-    return new g.Box3(t, e);
+    return new O.Box3(t, e);
   }
   getSphere() {
-    const t = this._absoluteMin.clone(), e = this._absoluteMax.clone(), i = Math.abs((e.x - t.x) / 2), o = Math.abs((e.y - t.y) / 2), n = Math.abs((e.z - t.z) / 2), r = new g.Vector3(t.x + i, t.y + o, t.z + n), a = r.distanceTo(t);
-    return new g.Sphere(r, a);
+    const t = this._absoluteMin.clone(), e = this._absoluteMax.clone(), i = Math.abs((e.x - t.x) / 2), o = Math.abs((e.y - t.y) / 2), n = Math.abs((e.z - t.z) / 2), r = new O.Vector3(t.x + i, t.y + o, t.z + n), a = r.distanceTo(t);
+    return new O.Sphere(r, a);
   }
   getMesh() {
-    const t = new g.Box3(this._absoluteMin, this._absoluteMax), e = At.getDimensions(t), { width: i, height: o, depth: n, center: r } = e, a = new g.BoxGeometry(i, o, n), c = new g.Mesh(a);
+    const t = new O.Box3(this._absoluteMin, this._absoluteMax), e = At.getDimensions(t), { width: i, height: o, depth: n, center: r } = e, a = new O.BoxGeometry(i, o, n), c = new O.Mesh(a);
     return this._meshes.push(c), c.position.copy(r), c;
   }
   reset() {
@@ -6386,7 +6825,7 @@ const At = class At extends J {
       return;
     const i = At.getFragmentBounds(t);
     t.updateMatrixWorld();
-    const o = t.matrixWorld, n = new g.Matrix4(), r = t instanceof g.InstancedMesh, a = /* @__PURE__ */ new Set();
+    const o = t.matrixWorld, n = new O.Matrix4(), r = t instanceof O.InstancedMesh, a = /* @__PURE__ */ new Set();
     if (e && t instanceof Vt.FragmentMesh)
       for (const c of e) {
         const h = t.fragment.getInstancesIDs(c);
@@ -6402,7 +6841,7 @@ const At = class At extends J {
     }
   }
   static getFragmentBounds(t) {
-    const e = t.geometry.attributes.position, i = Number.MAX_VALUE, o = -i, n = new g.Vector3(i, i, i), r = new g.Vector3(o, o, o);
+    const e = t.geometry.attributes.position, i = Number.MAX_VALUE, o = -i, n = new O.Vector3(i, i, i), r = new O.Vector3(o, o, o);
     if (!t.geometry.index)
       throw new Error("Geometry must be indexed!");
     const a = Array.from(t.geometry.index.array);
@@ -6414,11 +6853,11 @@ const At = class At extends J {
       const h = a[c], d = e.getX(h), E = e.getY(h), u = e.getZ(h);
       d < n.x && (n.x = d), E < n.y && (n.y = E), u < n.z && (n.z = u), d > r.x && (r.x = d), E > r.y && (r.y = E), u > r.z && (r.z = u);
     }
-    return new g.Box3(n, r);
+    return new O.Box3(n, r);
   }
 };
 I(At, "uuid", "d1444724-dba6-4cdd-a0c7-68ee1450d166");
-let On = At;
+let gn = At;
 const Li = /* @__PURE__ */ new Set([
   1123145078,
   574549367,
@@ -6653,6 +7092,46 @@ const Ps = class Ps extends J {
   export(t) {
     return this._loader.export(t);
   }
+  /**
+   * Gets a map of model IDs to sets of express IDs for the given fragment ID map.
+   * @param fragmentIdMap - A map of fragment IDs to their corresponding express IDs.
+   * @returns A map of model IDs to sets of express IDs.
+   */
+  getModelIdMap(t) {
+    const e = {};
+    for (const i in t) {
+      const o = this.list.get(i);
+      if (!(o && o.group))
+        continue;
+      const n = o.group;
+      n.uuid in e || (e[n.uuid] = /* @__PURE__ */ new Set());
+      const r = t[i];
+      for (const a of r)
+        e[n.uuid].add(a);
+    }
+    return e;
+  }
+  /**
+   * Converts a map of model IDs to sets of express IDs to a fragment ID map.
+   * @param modelIdMap - A map of model IDs to their corresponding express IDs.
+   * @returns A fragment ID map.
+   * @remarks
+   * This method iterates through the provided model ID map, retrieves the corresponding model from the `groups` map,
+   * and then calls the `getFragmentMap` method of the model to obtain a fragment ID map for the given express IDs.
+   * The fragment ID maps are then merged into a single map and returned.
+   * If a model with a given ID is not found in the `groups` map, the method skips that model and continues with the next one.
+   */
+  modelIdToFragmentIdMap(t) {
+    let e = {};
+    for (const i in t) {
+      const o = this.groups.get(i);
+      if (!o)
+        continue;
+      const n = t[i], r = o.getFragmentMap(n);
+      e = { ...e, ...r };
+    }
+    return e;
+  }
   coordinate(t = Array.from(this.groups.values())) {
     if (this.baseCoordinationModel.length === 0) {
       const o = t.pop();
@@ -8448,7 +8927,7 @@ class jr {
   }
   getScaleMatrix() {
     const s = this.factor;
-    return new g.Matrix4().fromArray([
+    return new O.Matrix4().fromArray([
       s,
       0,
       0,
@@ -8570,7 +9049,7 @@ class yi {
 }
 class Vn {
   constructor() {
-    I(this, "defLineMat", new g.LineBasicMaterial({ color: 16777215 }));
+    I(this, "defLineMat", new O.LineBasicMaterial({ color: 16777215 }));
   }
   read(s) {
     const t = s.GetAllAlignments(0), e = s.GetAllCrossSections2D(0), i = s.GetAllCrossSections3D(0), o = {
@@ -8587,7 +9066,7 @@ class Vn {
         const i = new Vt.Alignment();
         i.absolute = this.getCurves(e.curve3D, i), i.horizontal = this.getCurves(e.horizontal, i), i.vertical = this.getCurves(e.vertical, i), t.set(t.size, i);
       }
-      return { alignments: t, coordinationMatrix: new g.Matrix4() };
+      return { alignments: t, coordinationMatrix: new O.Matrix4() };
     }
   }
   getCurves(s, t) {
@@ -8605,7 +9084,7 @@ class Vn {
         const { x: u, y: p, z: A } = r[E];
         a[E * 3] = u, a[E * 3 + 1] = p, a[E * 3 + 2] = A || 0;
       }
-      const c = new g.BufferAttribute(a, 3), h = new g.EdgesGeometry();
+      const c = new O.BufferAttribute(a, 3), h = new O.EdgesGeometry();
       h.setAttribute("position", c);
       const d = new Vt.CurveMesh(
         i,
@@ -8664,13 +9143,13 @@ const Ge = class Ge extends J {
     I(this, "settings", new yi());
     I(this, "enabled", !0);
     I(this, "webIfc", new U.IfcAPI());
-    I(this, "_material", new g.MeshLambertMaterial());
+    I(this, "_material", new O.MeshLambertMaterial());
     I(this, "_spatialTree", new Yn());
     I(this, "_metaData", new Gn());
     I(this, "_fragmentInstances", /* @__PURE__ */ new Map());
     I(this, "_civil", new Vn());
     I(this, "_visitedFragments", /* @__PURE__ */ new Map());
-    I(this, "_materialT", new g.MeshLambertMaterial({
+    I(this, "_materialT", new O.MeshLambertMaterial({
       transparent: !0,
       opacity: 0.5
     }));
@@ -8747,12 +9226,12 @@ const Ge = class Ge extends J {
     for (let n = 0; n < i; n++) {
       const r = t.geometries.get(n), { x: a, y: c, z: h, w: d } = r.color, E = d !== 1, { geometryExpressID: u } = r, p = `${u}-${E}`;
       if (!this._visitedFragments.has(p)) {
-        const T = this.getGeometry(this.webIfc, u), O = E ? this._materialT : this._material, S = new Vt.Fragment(T, O, 1);
+        const T = this.getGeometry(this.webIfc, u), g = E ? this._materialT : this._material, S = new Vt.Fragment(T, g, 1);
         e.add(S.mesh), e.items.push(S);
         const _ = this._visitedFragments.size;
         this._visitedFragments.set(p, { index: _, fragment: S });
       }
-      const A = new g.Color().setRGB(a, c, h, "srgb"), m = new g.Matrix4();
+      const A = new O.Color().setRGB(a, c, h, "srgb"), m = new O.Matrix4();
       m.fromArray(r.flatTransformation);
       const C = this._visitedFragments.get(p);
       if (C === void 0)
@@ -8785,7 +9264,7 @@ const Ge = class Ge extends J {
     ), r = new Float32Array(n.length / 2), a = new Float32Array(n.length / 2);
     for (let E = 0; E < n.length; E += 6)
       r[E / 2] = n[E], r[E / 2 + 1] = n[E + 1], r[E / 2 + 2] = n[E + 2], a[E / 2] = n[E + 3], a[E / 2 + 1] = n[E + 4], a[E / 2 + 2] = n[E + 5];
-    const c = new g.BufferGeometry(), h = new g.BufferAttribute(r, 3), d = new g.BufferAttribute(a, 3);
+    const c = new O.BufferGeometry(), h = new O.BufferAttribute(r, 3), d = new O.BufferAttribute(a, 3);
     return c.setAttribute("position", h), c.setAttribute("normal", d), c.setIndex(Array.from(o)), i.delete(), c;
   }
   async autoSetWasm() {
@@ -8997,7 +9476,7 @@ const Bt = class Bt extends J {
   }
 };
 I(Bt, "uuid", "58c2d9f0-183c-48d6-a402-dfcf5b9a34df");
-let gn = Bt;
+let On = Bt;
 const Ls = class Ls extends J {
   constructor(t) {
     super(t);
@@ -9218,7 +9697,7 @@ const ys = class ys extends J {
       return;
     const e = this.components.get(Ai), i = this.components.get(ut), o = t ? 1 : -1;
     let n = 0;
-    const r = e.list[this.groupName], a = new g.Matrix4();
+    const r = e.list[this.groupName], a = new O.Matrix4();
     for (const c in r) {
       a.elements[13] = n * o * this.height;
       for (const h in r[c]) {
@@ -9496,8 +9975,8 @@ const Ms = class Ms extends J {
       const c = e.geometries.get(a), h = c.geometryExpressID, d = c.color.w === 1 ? 1 : -1, E = h * d;
       if (!this._visitedGeometries.has(E)) {
         this._visitedGeometries.has(h) || this.getGeometry(t, h);
-        const T = this._visitedGeometries.size, O = g.MathUtils.generateUUID();
-        this._visitedGeometries.set(E, { uuid: O, index: T });
+        const T = this._visitedGeometries.size, g = O.MathUtils.generateUUID();
+        this._visitedGeometries.set(E, { uuid: g, index: T });
       }
       const u = this._visitedGeometries.get(E);
       if (u === void 0)
@@ -9663,14 +10142,14 @@ const Ds = class Ds extends J {
       const p = /* @__PURE__ */ new Map();
       for (const { id: T } of u)
         if (h.has(T)) {
-          const O = h.get(T);
-          p.set(T, O);
+          const g = h.get(T);
+          p.set(T, g);
         }
       const A = u.map((T) => T.id);
       if (!p.size) {
         const T = c++;
-        for (const { id: O } of u)
-          h.set(O, T);
+        for (const { id: g } of u)
+          h.set(g, T);
         d.set(T, {
           edges: new Set(A),
           indices: /* @__PURE__ */ new Set([E])
@@ -9679,9 +10158,9 @@ const Ds = class Ds extends J {
       }
       let m = null;
       const C = /* @__PURE__ */ new Set(), R = new Set(A);
-      for (const [T, O] of p) {
-        m === null ? m = O : O !== m && C.add(O), h.delete(T);
-        const { edges: S } = d.get(O);
+      for (const [T, g] of p) {
+        m === null ? m = g : g !== m && C.add(g), h.delete(T);
+        const { edges: S } = d.get(g);
         S.delete(T), R.delete(T);
       }
       if (m === null)
@@ -9690,11 +10169,11 @@ const Ds = class Ds extends J {
       f.add(E);
       for (const T of R) {
         h.set(T, m);
-        const { edges: O } = F;
-        O.add(T);
+        const { edges: g } = F;
+        g.add(T);
       }
       for (const T of C) {
-        const O = d.get(T), { edges: S, indices: _ } = O, N = d.get(m), { edges: L, indices: M } = N;
+        const g = d.get(T), { edges: S, indices: _ } = g, N = d.get(m), { edges: L, indices: M } = N;
         for (const y of S)
           L.add(y), h.set(y, m);
         for (const y of _)
@@ -9714,7 +10193,7 @@ const Ds = class Ds extends J {
     return null;
   }
   static distanceFromPointToLine(t, e, i, o = !1) {
-    const n = new g.Line3(), r = new g.Vector3();
+    const n = new O.Line3(), r = new O.Vector3();
     return n.set(e, i), n.closestPointToPoint(t, o, r), r.distanceTo(t);
   }
   getFaceData(t, e, i) {
@@ -9746,18 +10225,18 @@ const Ds = class Ds extends J {
         distance: E.distanceTo(m),
         points: [E, m]
       }
-    ], R = new g.Plane();
+    ], R = new O.Plane();
     return R.setFromNormalAndCoplanarPoint(c, n), R.constant = Math.round(R.constant * 10) / 10, { plane: R, edges: C };
   }
   getVerticesAndNormal(t, e, i) {
     if (!t.geometry.index)
       throw new Error("Geometry must be indexed!");
-    const o = t.geometry.index.array, n = t.geometry.attributes.position.array, r = t.geometry.attributes.normal.array, a = o[e * 3] * 3, c = o[e * 3 + 1] * 3, h = o[e * 3 + 2] * 3, d = new g.Vector3(n[a], n[a + 1], n[a + 2]), E = new g.Vector3(n[c], n[c + 1], n[c + 2]), u = new g.Vector3(n[h], n[h + 1], n[h + 2]), p = new g.Vector3(r[a], r[a + 1], r[a + 2]), A = new g.Vector3(r[c], r[c + 1], r[c + 2]), m = new g.Vector3(r[h], r[h + 1], r[h + 2]), C = (p.x + A.x + m.x) / 3, R = (p.y + A.y + m.y) / 3, F = (p.z + A.z + m.z) / 3, f = new g.Vector3(C, R, F);
-    if (i !== void 0 && t instanceof g.InstancedMesh) {
-      const T = new g.Matrix4();
+    const o = t.geometry.index.array, n = t.geometry.attributes.position.array, r = t.geometry.attributes.normal.array, a = o[e * 3] * 3, c = o[e * 3 + 1] * 3, h = o[e * 3 + 2] * 3, d = new O.Vector3(n[a], n[a + 1], n[a + 2]), E = new O.Vector3(n[c], n[c + 1], n[c + 2]), u = new O.Vector3(n[h], n[h + 1], n[h + 2]), p = new O.Vector3(r[a], r[a + 1], r[a + 2]), A = new O.Vector3(r[c], r[c + 1], r[c + 2]), m = new O.Vector3(r[h], r[h + 1], r[h + 2]), C = (p.x + A.x + m.x) / 3, R = (p.y + A.y + m.y) / 3, F = (p.z + A.z + m.z) / 3, f = new O.Vector3(C, R, F);
+    if (i !== void 0 && t instanceof O.InstancedMesh) {
+      const T = new O.Matrix4();
       t.getMatrixAt(i, T);
-      const O = new g.Matrix4();
-      O.extractRotation(T), f.applyMatrix4(O), d.applyMatrix4(T), E.applyMatrix4(T), u.applyMatrix4(T);
+      const g = new O.Matrix4();
+      g.extractRotation(T), f.applyMatrix4(g), d.applyMatrix4(T), E.applyMatrix4(T), u.applyMatrix4(T);
     }
     return { p1: d, p2: E, p3: u, faceNormal: f };
   }
@@ -9774,7 +10253,7 @@ export {
   lr as BaseRenderer,
   hr as BaseScene,
   Ni as BaseWorldItem,
-  On as BoundingBoxer,
+  gn as BoundingBoxer,
   Ai as Classifier,
   An as Clipper,
   J as Component,
@@ -9795,7 +10274,7 @@ export {
   Nn as IfcGeometryTiler,
   mi as IfcJsonExporter,
   Ri as IfcLoader,
-  gn as IfcPropertiesManager,
+  On as IfcPropertiesManager,
   Kr as IfcPropertiesTiler,
   Kt as IfcPropertiesUtils,
   We as IfcRelationsIndexer,
@@ -9814,7 +10293,7 @@ export {
   Pi as SimplePlane,
   na as SimpleRenderer,
   ia as SimpleScene,
-  Or as SimpleWorld,
+  gr as SimpleWorld,
   ze as UUID,
   sa as VertexPicker,
   Ci as Worlds,