@thatopen/components 2.4.8 → 2.4.10

package/dist/index.mjs

@@ -5,7 +5,7 @@ var __publicField = (obj, key, value) => {
   return value;
 };
 import * as THREE$1 from "three";
-import { BufferAttribute, Vector3, Vector2, Plane, Line3, Triangle, Sphere, Matrix4, Box3, BackSide, DoubleSide, FrontSide, Mesh, Ray, Raycaster, Quaternion, Object3D, Euler, MeshBasicMaterial, LineBasicMaterial, CylinderGeometry, BoxGeometry, BufferGeometry, Float32BufferAttribute, OctahedronGeometry, Line, SphereGeometry, TorusGeometry, PlaneGeometry } from "three";
+import { BufferAttribute, Vector3, Vector2, Plane, Line3, Triangle, Sphere, Matrix4, Box3, BackSide, DoubleSide, FrontSide, Mesh, Ray, Raycaster, Quaternion, Controls, Euler, Object3D, MeshBasicMaterial, LineBasicMaterial, CylinderGeometry, BoxGeometry, BufferGeometry, Float32BufferAttribute, OctahedronGeometry, Line, SphereGeometry, TorusGeometry, PlaneGeometry } from "three";
 import * as FRAGS from "@thatopen/fragments";
 import { FragmentsGroup, Serializer } from "@thatopen/fragments";
 import * as WEBIFC from "web-ifc";
@@ -4002,6 +4002,9 @@ const _plane = new Plane();
 const _closestPoint = new Vector3();
 const _triangle = new Triangle();
 class ConvexHull {
+  /**
+   * Constructs a new convex hull.
+   */
   constructor() {
     this.tolerance = -1;
     this.faces = [];
@@ -4010,16 +4013,29 @@ class ConvexHull {
     this.unassigned = new VertexList();
     this.vertices = [];
   }
+  /**
+   * Computes to convex hull for the given array of points.
+   *
+   * @param {Array<Vector3>} points - The array of points in 3D space.
+   * @return {ConvexHull} A reference to this convex hull.
+   */
   setFromPoints(points) {
     if (points.length >= 4) {
       this.makeEmpty();
       for (let i = 0, l = points.length; i < l; i++) {
         this.vertices.push(new VertexNode(points[i]));
       }
-      this.compute();
+      this._compute();
     }
     return this;
   }
+  /**
+   * Computes the convex hull of the given 3D object (including its descendants),
+   * accounting for the world transforms of both the 3D object and its descendants.
+   *
+   * @param {Object3D} object - The 3D object to compute the convex hull for.
+   * @return {ConvexHull} A reference to this convex hull.
+   */
   setFromObject(object) {
     const points = [];
     object.updateMatrixWorld(true);
@@ -4038,6 +4054,12 @@ class ConvexHull {
     });
     return this.setFromPoints(points);
   }
+  /**
+   * Returns `true` if the given point lies in the convex hull.
+   *
+   * @param {Vector3} point - The point to test.
+   * @return {boolean} Whether the given point lies in the convex hull or not.
+   */
   containsPoint(point) {
     const faces = this.faces;
     for (let i = 0, l = faces.length; i < l; i++) {
@@ -4047,6 +4069,13 @@ class ConvexHull {
     }
     return true;
   }
+  /**
+   * Computes the intersections point of the given ray and this convex hull.
+   *
+   * @param {Ray} ray - The ray to test.
+   * @param {Vector3} target - The target vector that is used to store the method's result.
+   * @return {Vector3|null} The intersection point. Returns `null` if not intersection was detected.
+   */
   intersectRay(ray2, target) {
     const faces = this.faces;
     let tNear = -Infinity;
@@ -4076,16 +4105,35 @@ class ConvexHull {
     }
     return target;
   }
+  /**
+   * Returns `true` if the given ray intersects with this convex hull.
+   *
+   * @param {Ray} ray - The ray to test.
+   * @return {boolean} Whether the given ray intersects with this convex hull or not.
+   */
   intersectsRay(ray2) {
     return this.intersectRay(ray2, _v1$1) !== null;
   }
+  /**
+   * Makes the convex hull empty.
+   *
+   * @return {ConvexHull} A reference to this convex hull.
+   */
   makeEmpty() {
     this.faces = [];
     this.vertices = [];
     return this;
   }
-  // Adds a vertex to the 'assigned' list of vertices and assigns it to the given face
-  addVertexToFace(vertex, face) {
+  // private
+  /**
+   * Adds a vertex to the 'assigned' list of vertices and assigns it to the given face.
+   *
+   * @private
+   * @param {VertexNode} vertex - The vertex to add.
+   * @param {Face} face - The target face.
+   * @return {ConvexHull} A reference to this convex hull.
+   */
+  _addVertexToFace(vertex, face) {
     vertex.face = face;
     if (face.outside === null) {
       this.assigned.append(vertex);
@@ -4095,8 +4143,17 @@ class ConvexHull {
     face.outside = vertex;
     return this;
   }
-  // Removes a vertex from the 'assigned' list of vertices and from the given face
-  removeVertexFromFace(vertex, face) {
+  /**
+   * Removes a vertex from the 'assigned' list of vertices and from the given face.
+   * It also makes sure that the link from 'face' to the first vertex it sees in 'assigned'
+   * is linked correctly after the removal.
+   *
+   * @private
+   * @param {VertexNode} vertex - The vertex to remove.
+   * @param {Face} face - The target face.
+   * @return {ConvexHull} A reference to this convex hull.
+   */
+  _removeVertexFromFace(vertex, face) {
     if (vertex === face.outside) {
       if (vertex.next !== null && vertex.next.face === face) {
         face.outside = vertex.next;
@@ -4107,8 +4164,15 @@ class ConvexHull {
     this.assigned.remove(vertex);
     return this;
   }
-  // Removes all the visible vertices that a given face is able to see which are stored in the 'assigned' vertex list
-  removeAllVerticesFromFace(face) {
+  /**
+   * Removes all the visible vertices that a given face is able to see which are stored in
+   * the 'assigned' vertex list.
+   *
+   * @private
+   * @param {Face} face - The target face.
+   * @return {VertexNode|undefined} A reference to this convex hull.
+   */
+  _removeAllVerticesFromFace(face) {
     if (face.outside !== null) {
       const start = face.outside;
       let end = face.outside;
@@ -4121,9 +4185,20 @@ class ConvexHull {
       return start;
     }
   }
-  // Removes all the visible vertices that 'face' is able to see
-  deleteFaceVertices(face, absorbingFace) {
-    const faceVertices = this.removeAllVerticesFromFace(face);
+  /**
+   * Removes all the visible vertices that `face` is able to see.
+   *
+   * - If `absorbingFace` doesn't exist, then all the removed vertices will be added to the 'unassigned' vertex list.
+   * - If `absorbingFace` exists, then this method will assign all the vertices of 'face' that can see 'absorbingFace'.
+   * - If a vertex cannot see `absorbingFace`, it's added to the 'unassigned' vertex list.
+   *
+   * @private
+   * @param {Face} face - The given face.
+   * @param {Face} [absorbingFace] - An optional face that tries to absorb the vertices of the first face.
+   * @return {ConvexHull} A reference to this convex hull.
+   */
+  _deleteFaceVertices(face, absorbingFace) {
+    const faceVertices = this._removeAllVerticesFromFace(face);
     if (faceVertices !== void 0) {
       if (absorbingFace === void 0) {
         this.unassigned.appendChain(faceVertices);
@@ -4133,7 +4208,7 @@ class ConvexHull {
           const nextVertex = vertex.next;
           const distance = absorbingFace.distanceToPoint(vertex.point);
           if (distance > this.tolerance) {
-            this.addVertexToFace(vertex, absorbingFace);
+            this._addVertexToFace(vertex, absorbingFace);
           } else {
             this.unassigned.append(vertex);
           }
@@ -4143,8 +4218,14 @@ class ConvexHull {
     }
     return this;
   }
-  // Reassigns as many vertices as possible from the unassigned list to the new faces
-  resolveUnassignedPoints(newFaces) {
+  /**
+   * Reassigns as many vertices as possible from the unassigned list to the new faces.
+   *
+   * @private
+   * @param {Array<Face>} newFaces - The new faces.
+   * @return {ConvexHull} A reference to this convex hull.
+   */
+  _resolveUnassignedPoints(newFaces) {
     if (this.unassigned.isEmpty() === false) {
       let vertex = this.unassigned.first();
       do {
@@ -4164,15 +4245,21 @@ class ConvexHull {
           }
         }
         if (maxFace !== null) {
-          this.addVertexToFace(vertex, maxFace);
+          this._addVertexToFace(vertex, maxFace);
         }
         vertex = nextVertex;
       } while (vertex !== null);
     }
     return this;
   }
-  // Computes the extremes of a simplex which will be the initial hull
-  computeExtremes() {
+  /**
+   * Computes the extremes values (min/max vectors) which will be used to
+   * compute the initial hull.
+   *
+   * @private
+   * @return {Object} The extremes.
+   */
+  _computeExtremes() {
     const min = new Vector3();
     const max = new Vector3();
     const minVertices = [];
@@ -4201,11 +4288,16 @@ class ConvexHull {
     this.tolerance = 3 * Number.EPSILON * (Math.max(Math.abs(min.x), Math.abs(max.x)) + Math.max(Math.abs(min.y), Math.abs(max.y)) + Math.max(Math.abs(min.z), Math.abs(max.z)));
     return { min: minVertices, max: maxVertices };
   }
-  // Computes the initial simplex assigning to its faces all the points
-  // that are candidates to form part of the hull
-  computeInitialHull() {
+  /**
+   * Computes the initial simplex assigning to its faces all the points that are
+   * candidates to form part of the hull.
+   *
+   * @private
+   * @return {ConvexHull} A reference to this convex hull.
+   */
+  _computeInitialHull() {
     const vertices = this.vertices;
-    const extremes = this.computeExtremes();
+    const extremes = this._computeExtremes();
     const min = extremes.min;
     const max = extremes.max;
     let maxDistance = 0;
@@ -4288,14 +4380,19 @@ class ConvexHull {
           }
         }
         if (maxFace !== null) {
-          this.addVertexToFace(vertex, maxFace);
+          this._addVertexToFace(vertex, maxFace);
         }
       }
     }
     return this;
   }
-  // Removes inactive faces
-  reindexFaces() {
+  /**
+   * Removes inactive (e.g. deleted) faces from the internal face list.
+   *
+   * @private
+   * @return {ConvexHull} A reference to this convex hull.
+   */
+  _reindexFaces() {
     const activeFaces = [];
     for (let i = 0; i < this.faces.length; i++) {
       const face = this.faces[i];
@@ -4306,8 +4403,17 @@ class ConvexHull {
     this.faces = activeFaces;
     return this;
   }
-  // Finds the next vertex to create faces with the current hull
-  nextVertexToAdd() {
+  /**
+   * Finds the next vertex to create faces with the current hull.
+   *
+   * - Let the initial face be the first face existing in the 'assigned' vertex list.
+   * - If a face doesn't exist then return since there're no vertices left.
+   * - Otherwise for each vertex that face sees find the one furthest away from it.
+   *
+   * @private
+   * @return {?VertexNode} The next vertex to add.
+   */
+  _nextVertexToAdd() {
     if (this.assigned.isEmpty() === false) {
       let eyeVertex, maxDistance = 0;
       const eyeFace = this.assigned.first().face;
@@ -4323,11 +4429,20 @@ class ConvexHull {
       return eyeVertex;
     }
   }
-  // Computes a chain of half edges in CCW order called the 'horizon'.
-  // For an edge to be part of the horizon it must join a face that can see
-  // 'eyePoint' and a face that cannot see 'eyePoint'.
-  computeHorizon(eyePoint, crossEdge, face, horizon) {
-    this.deleteFaceVertices(face);
+  /**
+   * Computes a chain of half edges in CCW order called the 'horizon'. For an edge
+   * to be part of the horizon it must join a face that can see 'eyePoint' and a face
+   * that cannot see 'eyePoint'.
+   *
+   * @private
+   * @param {Vector3} eyePoint - The 3D-coordinates of a point.
+   * @param {HalfEdge} crossEdge - The edge used to jump to the current face.
+   * @param {Face} face - The current face being tested.
+   * @param {Array<HalfEdge>} horizon - The edges that form part of the horizon in CCW order.
+   * @return {ConvexHull} A reference to this convex hull.
+   */
+  _computeHorizon(eyePoint, crossEdge, face, horizon) {
+    this._deleteFaceVertices(face);
     face.mark = Deleted;
     let edge;
     if (crossEdge === null) {
@@ -4340,7 +4455,7 @@ class ConvexHull {
       const oppositeFace = twinEdge.face;
       if (oppositeFace.mark === Visible) {
         if (oppositeFace.distanceToPoint(eyePoint) > this.tolerance) {
-          this.computeHorizon(eyePoint, twinEdge, oppositeFace, horizon);
+          this._computeHorizon(eyePoint, twinEdge, oppositeFace, horizon);
         } else {
           horizon.push(edge);
         }
@@ -4349,22 +4464,38 @@ class ConvexHull {
     } while (edge !== crossEdge);
     return this;
   }
-  // Creates a face with the vertices 'eyeVertex.point', 'horizonEdge.tail' and 'horizonEdge.head' in CCW order
-  addAdjoiningFace(eyeVertex, horizonEdge) {
+  /**
+   * Creates a face with the vertices 'eyeVertex.point', 'horizonEdge.tail' and 'horizonEdge.head'
+   * in CCW order. All the half edges are created in CCW order thus the face is always pointing
+   * outside the hull.
+   *
+   * @private
+   * @param {VertexNode} eyeVertex - The vertex that is added to the hull.
+   * @param {HalfEdge} horizonEdge - A single edge of the horizon.
+   * @return {HalfEdge} The half edge whose vertex is the eyeVertex.
+   */
+  _addAdjoiningFace(eyeVertex, horizonEdge) {
     const face = Face.create(eyeVertex, horizonEdge.tail(), horizonEdge.head());
     this.faces.push(face);
     face.getEdge(-1).setTwin(horizonEdge.twin);
     return face.getEdge(0);
   }
-  //  Adds 'horizon.length' faces to the hull, each face will be linked with the
-  //  horizon opposite face and the face on the left/right
-  addNewFaces(eyeVertex, horizon) {
+  /**
+   * Adds 'horizon.length' faces to the hull, each face will be linked with the horizon
+   * opposite face and the face on the left/right.
+   *
+   * @private
+   * @param {VertexNode} eyeVertex - The vertex that is added to the hull.
+   * @param {Array<HalfEdge>} horizon - The horizon.
+   * @return {ConvexHull} A reference to this convex hull.
+   */
+  _addNewFaces(eyeVertex, horizon) {
     this.newFaces = [];
     let firstSideEdge = null;
     let previousSideEdge = null;
     for (let i = 0; i < horizon.length; i++) {
       const horizonEdge = horizon[i];
-      const sideEdge = this.addAdjoiningFace(eyeVertex, horizonEdge);
+      const sideEdge = this._addAdjoiningFace(eyeVertex, horizonEdge);
       if (firstSideEdge === null) {
         firstSideEdge = sideEdge;
       } else {
@@ -4376,34 +4507,62 @@ class ConvexHull {
     firstSideEdge.next.setTwin(previousSideEdge);
     return this;
   }
-  // Adds a vertex to the hull
-  addVertexToHull(eyeVertex) {
+  /**
+   * Adds a vertex to the hull with the following algorithm:
+   *
+   * - Compute the 'horizon' which is a chain of half edges. For an edge to belong to this group
+   * it must be the edge connecting a face that can see 'eyeVertex' and a face which cannot see 'eyeVertex'.
+   * - All the faces that can see 'eyeVertex' have its visible vertices removed from the assigned vertex list.
+   * - A new set of faces is created with each edge of the 'horizon' and 'eyeVertex'. Each face is connected
+   * with the opposite horizon face and the face on the left/right.
+   * - The vertices removed from all the visible faces are assigned to the new faces if possible.
+   *
+   * @private
+   * @param {VertexNode} eyeVertex - The vertex to add.
+   * @return {ConvexHull} A reference to this convex hull.
+   */
+  _addVertexToHull(eyeVertex) {
     const horizon = [];
     this.unassigned.clear();
-    this.removeVertexFromFace(eyeVertex, eyeVertex.face);
-    this.computeHorizon(eyeVertex.point, null, eyeVertex.face, horizon);
-    this.addNewFaces(eyeVertex, horizon);
-    this.resolveUnassignedPoints(this.newFaces);
+    this._removeVertexFromFace(eyeVertex, eyeVertex.face);
+    this._computeHorizon(eyeVertex.point, null, eyeVertex.face, horizon);
+    this._addNewFaces(eyeVertex, horizon);
+    this._resolveUnassignedPoints(this.newFaces);
     return this;
   }
-  cleanup() {
+  /**
+   * Cleans up internal properties after computing the convex hull.
+   *
+   * @private
+   * @return {ConvexHull} A reference to this convex hull.
+   */
+  _cleanup() {
     this.assigned.clear();
     this.unassigned.clear();
     this.newFaces = [];
     return this;
   }
-  compute() {
+  /**
+   * Starts the execution of the quick hull algorithm.
+   *
+   * @private
+   * @return {ConvexHull} A reference to this convex hull.
+   */
+  _compute() {
     let vertex;
-    this.computeInitialHull();
-    while ((vertex = this.nextVertexToAdd()) !== void 0) {
-      this.addVertexToHull(vertex);
+    this._computeInitialHull();
+    while ((vertex = this._nextVertexToAdd()) !== void 0) {
+      this._addVertexToHull(vertex);
     }
-    this.reindexFaces();
-    this.cleanup();
+    this._reindexFaces();
+    this._cleanup();
     return this;
   }
 }
 class Face {
+  /**
+   * Constructs a new face.
+   */
   constructor() {
     this.normal = new Vector3();
     this.midpoint = new Vector3();
@@ -4413,6 +4572,15 @@ class Face {
     this.mark = Visible;
     this.edge = null;
   }
+  /**
+   * Creates a face from the given vertex nodes.
+   *
+   * @private
+   * @param {VertexNode} a - The first vertex node.
+   * @param {VertexNode} b - The second vertex node.
+   * @param {VertexNode} c - The third vertex node.
+   * @return {Face} The created face.
+   */
   static create(a, b, c) {
     const face = new Face();
     const e0 = new HalfEdge(a, face);
@@ -4424,6 +4592,13 @@ class Face {
     face.edge = e0;
     return face.compute();
   }
+  /**
+   * Returns an edge by the given index.
+   *
+   * @private
+   * @param {number} i - The edge index.
+   * @return {HalfEdge} The edge.
+   */
   getEdge(i) {
     let edge = this.edge;
     while (i > 0) {
@@ -4436,6 +4611,12 @@ class Face {
     }
     return edge;
   }
+  /**
+   * Computes all properties of the face.
+   *
+   * @private
+   * @return {Face} A reference to this face.
+   */
   compute() {
     const a = this.edge.tail();
     const b = this.edge.head();
@@ -4447,11 +4628,24 @@ class Face {
     this.constant = this.normal.dot(this.midpoint);
     return this;
   }
+  /**
+   * Returns the signed distance from a given point to the plane representation of this face.
+   *
+   * @private
+   * @param {Vector3} point - The point to compute the distance to.
+   * @return {number} The distance.
+   */
   distanceToPoint(point) {
     return this.normal.dot(point) - this.constant;
   }
 }
 class HalfEdge {
+  /**
+   * Constructs a new half edge.
+   *
+   * @param {VertexNode} vertex - A reference to its destination vertex.
+   * @param {Face} face - A reference to its face.
+   */
   constructor(vertex, face) {
     this.vertex = vertex;
     this.prev = null;
@@ -4459,12 +4653,30 @@ class HalfEdge {
     this.twin = null;
     this.face = face;
   }
+  /**
+   * Returns the destination vertex.
+   *
+   * @private
+   * @return {VertexNode} The destination vertex.
+   */
   head() {
     return this.vertex;
   }
+  /**
+   * Returns the origin vertex.
+   *
+   * @private
+   * @return {VertexNode} The destination vertex.
+   */
   tail() {
     return this.prev ? this.prev.vertex : null;
   }
+  /**
+   * Returns the Euclidean length (straight-line length) of the edge.
+   *
+   * @private
+   * @return {number} The edge's length.
+   */
   length() {
     const head = this.head();
     const tail = this.tail();
@@ -4473,6 +4685,12 @@ class HalfEdge {
     }
     return -1;
   }
+  /**
+   * Returns the square of the Euclidean length (straight-line length) of the edge.
+   *
+   * @private
+   * @return {number} The square of the edge's length.
+   */
   lengthSquared() {
     const head = this.head();
     const tail = this.tail();
@@ -4481,6 +4699,14 @@ class HalfEdge {
     }
     return -1;
   }
+  /**
+   * Sets the twin edge of this half-edge. It also ensures that the twin reference
+   * of the given half-edge is correctly set.
+   *
+   * @private
+   * @param {HalfEdge} edge - The twin edge to set.
+   * @return {HalfEdge} A reference to this edge.
+   */
   setTwin(edge) {
     this.twin = edge;
     edge.twin = this;
@@ -4488,6 +4714,11 @@ class HalfEdge {
   }
 }
 class VertexNode {
+  /**
+   * Constructs a new vertex node.
+   *
+   * @param {Vector3} point - A point in 3D space.
+   */
   constructor(point) {
     this.point = point;
     this.prev = null;
@@ -4496,21 +4727,49 @@ class VertexNode {
   }
 }
 class VertexList {
+  /**
+   * Constructs a new vertex list.
+   */
   constructor() {
     this.head = null;
     this.tail = null;
   }
+  /**
+   * Returns the head reference.
+   *
+   * @private
+   * @return {VertexNode} The head reference.
+   */
   first() {
     return this.head;
   }
+  /**
+   * Returns the tail reference.
+   *
+   * @private
+   * @return {VertexNode} The tail reference.
+   */
   last() {
     return this.tail;
   }
+  /**
+   * Clears the linked list.
+   *
+   * @private
+   * @return {VertexList} A reference to this vertex list.
+   */
   clear() {
     this.head = this.tail = null;
     return this;
   }
-  // Inserts a vertex before the target vertex
+  /**
+   * Inserts a vertex before a target vertex.
+   *
+   * @private
+   * @param {VertexNode} target - The target.
+   * @param {VertexNode} vertex - The vertex to insert.
+   * @return {VertexList} A reference to this vertex list.
+   */
   insertBefore(target, vertex) {
     vertex.prev = target.prev;
     vertex.next = target;
@@ -4522,7 +4781,14 @@ class VertexList {
     target.prev = vertex;
     return this;
   }
-  // Inserts a vertex after the target vertex
+  /**
+   * Inserts a vertex after a target vertex.
+   *
+   * @private
+   * @param {VertexNode} target - The target.
+   * @param {VertexNode} vertex - The vertex to insert.
+   * @return {VertexList} A reference to this vertex list.
+   */
   insertAfter(target, vertex) {
     vertex.prev = target;
     vertex.next = target.next;
@@ -4534,7 +4800,13 @@ class VertexList {
     target.next = vertex;
     return this;
   }
-  // Appends a vertex to the end of the linked list
+  /**
+   * Appends a vertex to this vertex list.
+   *
+   * @private
+   * @param {VertexNode} vertex - The vertex to append.
+   * @return {VertexList} A reference to this vertex list.
+   */
   append(vertex) {
     if (this.head === null) {
       this.head = vertex;
@@ -4546,7 +4818,13 @@ class VertexList {
     this.tail = vertex;
     return this;
   }
-  // Appends a chain of vertices where 'vertex' is the head.
+  /**
+   * Appends a chain of vertices where the given vertex is the head.
+   *
+   * @private
+   * @param {VertexNode} vertex - The head vertex of a chain of vertices.
+   * @return {VertexList} A reference to this vertex list.
+   */
   appendChain(vertex) {
     if (this.head === null) {
       this.head = vertex;
@@ -4560,7 +4838,13 @@ class VertexList {
     this.tail = vertex;
     return this;
   }
-  // Removes a vertex from the linked list
+  /**
+   * Removes a vertex from the linked list.
+   *
+   * @private
+   * @param {VertexNode} vertex - The vertex to remove.
+   * @return {VertexList} A reference to this vertex list.
+   */
   remove(vertex) {
     if (vertex.prev === null) {
       this.head = vertex.next;
@@ -4574,7 +4858,14 @@ class VertexList {
     }
     return this;
   }
-  // Removes a list of vertices whose 'head' is 'a' and whose 'tail' is b
+  /**
+   * Removes a sublist of vertices from the linked list.
+   *
+   * @private
+   * @param {VertexNode} a - The head of the sublist.
+   * @param {VertexNode} b - The tail of the sublist.
+   * @return {VertexList} A reference to this vertex list.
+   */
   removeSubList(a, b) {
     if (a.prev === null) {
       this.head = b.next;
@@ -4588,6 +4879,12 @@ class VertexList {
     }
     return this;
   }
+  /**
+   * Returns `true` if the linked list is empty.
+   *
+   * @private
+   * @return {boolean} Whether the linked list is empty or not.
+   */
   isEmpty() {
     return this.head === null;
   }
@@ -6293,7 +6590,7 @@ const _Components = class _Components {
 /**
  * The version of the @thatopen/components library.
  */
-__publicField(_Components, "release", "2.4.8");
+__publicField(_Components, "release", "2.4.10");
 let Components = _Components;
 class SimpleWorld extends Base {
   constructor() {
@@ -6863,20 +7160,24 @@ const ACTION = Object.freeze({
   NONE: 0,
   ROTATE: 1,
   TRUCK: 2,
-  OFFSET: 4,
-  DOLLY: 8,
-  ZOOM: 16,
-  TOUCH_ROTATE: 32,
-  TOUCH_TRUCK: 64,
-  TOUCH_OFFSET: 128,
-  TOUCH_DOLLY: 256,
-  TOUCH_ZOOM: 512,
-  TOUCH_DOLLY_TRUCK: 1024,
-  TOUCH_DOLLY_OFFSET: 2048,
-  TOUCH_DOLLY_ROTATE: 4096,
-  TOUCH_ZOOM_TRUCK: 8192,
-  TOUCH_ZOOM_OFFSET: 16384,
-  TOUCH_ZOOM_ROTATE: 32768
+  SCREEN_PAN: 4,
+  OFFSET: 8,
+  DOLLY: 16,
+  ZOOM: 32,
+  TOUCH_ROTATE: 64,
+  TOUCH_TRUCK: 128,
+  TOUCH_SCREEN_PAN: 256,
+  TOUCH_OFFSET: 512,
+  TOUCH_DOLLY: 1024,
+  TOUCH_ZOOM: 2048,
+  TOUCH_DOLLY_TRUCK: 4096,
+  TOUCH_DOLLY_SCREEN_PAN: 8192,
+  TOUCH_DOLLY_OFFSET: 16384,
+  TOUCH_DOLLY_ROTATE: 32768,
+  TOUCH_ZOOM_TRUCK: 65536,
+  TOUCH_ZOOM_OFFSET: 131072,
+  TOUCH_ZOOM_SCREEN_PAN: 262144,
+  TOUCH_ZOOM_ROTATE: 524288
 });
 const DOLLY_DIRECTION = {
   NONE: 0,
@@ -7075,11 +7376,10 @@ class EventDispatcher {
     }
   }
 }
-const VERSION = "2.7.3";
+var _a;
+const VERSION = "2.10.1";
 const TOUCH_DOLLY_FACTOR = 1 / 8;
-const isBrowser = typeof window !== "undefined";
-const isMac = isBrowser && /Mac/.test(navigator.platform);
-const isPointerEventsNotSupported = !(isBrowser && "PointerEvent" in window);
+const isMac = /Mac/.test((_a = globalThis === null || globalThis === void 0 ? void 0 : globalThis.navigator) === null || _a === void 0 ? void 0 : _a.platform);
 let THREE;
 let _ORIGIN;
 let _AXIS_Y;
@@ -7176,6 +7476,12 @@ class CameraControls extends EventDispatcher {
   static get ACTION() {
     return ACTION;
   }
+  /**
+   * @deprecated Use `cameraControls.mouseButtons.left = CameraControls.ACTION.SCREEN_PAN` instead.
+   */
+  set verticalDragToForward(_) {
+    console.warn("camera-controls: `verticalDragToForward` was removed. Use `mouseButtons.left = CameraControls.ACTION.SCREEN_PAN` instead.");
+  }
   /**
    * Creates a `CameraControls` instance.
    *
@@ -7214,7 +7520,6 @@ class CameraControls extends EventDispatcher {
     this.truckSpeed = 2;
     this.dollyToCursor = false;
     this.dragToOffset = false;
-    this.verticalDragToForward = false;
     this.boundaryFriction = 0;
     this.restThreshold = 0.01;
     this.colliderMeshes = [];
@@ -7247,7 +7552,7 @@ class CameraControls extends EventDispatcher {
     this._targetVelocity = new THREE.Vector3();
     this._focalOffsetVelocity = new THREE.Vector3();
     this._zoomVelocity = { value: 0 };
-    this._truckInternal = (deltaX, deltaY, dragToOffset) => {
+    this._truckInternal = (deltaX, deltaY, dragToOffset, screenSpacePanning) => {
       let truckX;
       let pedestalY;
       if (isPerspectiveCamera(this._camera)) {
@@ -7258,12 +7563,12 @@ class CameraControls extends EventDispatcher {
         pedestalY = this.truckSpeed * deltaY * targetDistance / this._elementRect.height;
       } else if (isOrthographicCamera(this._camera)) {
         const camera2 = this._camera;
-        truckX = deltaX * (camera2.right - camera2.left) / camera2.zoom / this._elementRect.width;
-        pedestalY = deltaY * (camera2.top - camera2.bottom) / camera2.zoom / this._elementRect.height;
+        truckX = this.truckSpeed * deltaX * (camera2.right - camera2.left) / camera2.zoom / this._elementRect.width;
+        pedestalY = this.truckSpeed * deltaY * (camera2.top - camera2.bottom) / camera2.zoom / this._elementRect.height;
       } else {
         return;
       }
-      if (this.verticalDragToForward) {
+      if (screenSpacePanning) {
         dragToOffset ? this.setFocalOffset(this._focalOffsetEnd.x + truckX, this._focalOffsetEnd.y, this._focalOffsetEnd.z, true) : this.truck(truckX, 0, true);
         this.forward(-pedestalY, true);
       } else {
@@ -7383,37 +7688,6 @@ class CameraControls extends EventDispatcher {
       this._isDragging = true;
       startDragging(event);
     };
-    const onMouseDown = (event) => {
-      if (!this._enabled || !this._domElement || this._lockedPointer)
-        return;
-      if (this._interactiveArea.left !== 0 || this._interactiveArea.top !== 0 || this._interactiveArea.width !== 1 || this._interactiveArea.height !== 1) {
-        const elRect = this._domElement.getBoundingClientRect();
-        const left = event.clientX / elRect.width;
-        const top = event.clientY / elRect.height;
-        if (left < this._interactiveArea.left || left > this._interactiveArea.right || top < this._interactiveArea.top || top > this._interactiveArea.bottom)
-          return;
-      }
-      const mouseButton = (event.buttons & MOUSE_BUTTON.LEFT) === MOUSE_BUTTON.LEFT ? MOUSE_BUTTON.LEFT : (event.buttons & MOUSE_BUTTON.MIDDLE) === MOUSE_BUTTON.MIDDLE ? MOUSE_BUTTON.MIDDLE : (event.buttons & MOUSE_BUTTON.RIGHT) === MOUSE_BUTTON.RIGHT ? MOUSE_BUTTON.RIGHT : null;
-      if (mouseButton !== null) {
-        const zombiePointer = this._findPointerByMouseButton(mouseButton);
-        zombiePointer && this._disposePointer(zombiePointer);
-      }
-      const pointer = {
-        pointerId: 1,
-        clientX: event.clientX,
-        clientY: event.clientY,
-        deltaX: 0,
-        deltaY: 0,
-        mouseButton: (event.buttons & MOUSE_BUTTON.LEFT) === MOUSE_BUTTON.LEFT ? MOUSE_BUTTON.LEFT : (event.buttons & MOUSE_BUTTON.MIDDLE) === MOUSE_BUTTON.LEFT ? MOUSE_BUTTON.MIDDLE : (event.buttons & MOUSE_BUTTON.RIGHT) === MOUSE_BUTTON.LEFT ? MOUSE_BUTTON.RIGHT : null
-      };
-      this._activePointers.push(pointer);
-      this._domElement.ownerDocument.removeEventListener("mousemove", onMouseMove);
-      this._domElement.ownerDocument.removeEventListener("mouseup", onMouseUp);
-      this._domElement.ownerDocument.addEventListener("mousemove", onMouseMove);
-      this._domElement.ownerDocument.addEventListener("mouseup", onMouseUp);
-      this._isDragging = true;
-      startDragging(event);
-    };
     const onPointerMove2 = (event) => {
       if (event.cancelable)
         event.preventDefault();
@@ -7451,26 +7725,6 @@ class CameraControls extends EventDispatcher {
       }
       dragging();
     };
-    const onMouseMove = (event) => {
-      const pointer = this._lockedPointer || this._findPointerById(1);
-      if (!pointer)
-        return;
-      pointer.clientX = event.clientX;
-      pointer.clientY = event.clientY;
-      pointer.deltaX = event.movementX;
-      pointer.deltaY = event.movementY;
-      this._state = 0;
-      if (this._lockedPointer || (event.buttons & MOUSE_BUTTON.LEFT) === MOUSE_BUTTON.LEFT) {
-        this._state = this._state | this.mouseButtons.left;
-      }
-      if ((event.buttons & MOUSE_BUTTON.MIDDLE) === MOUSE_BUTTON.MIDDLE) {
-        this._state = this._state | this.mouseButtons.middle;
-      }
-      if ((event.buttons & MOUSE_BUTTON.RIGHT) === MOUSE_BUTTON.RIGHT) {
-        this._state = this._state | this.mouseButtons.right;
-      }
-      dragging();
-    };
     const onPointerUp2 = (event) => {
       const pointer = this._findPointerById(event.pointerId);
       if (pointer && pointer === this._lockedPointer)
@@ -7496,14 +7750,6 @@ class CameraControls extends EventDispatcher {
       }
       endDragging();
     };
-    const onMouseUp = () => {
-      const pointer = this._findPointerById(1);
-      if (pointer && pointer === this._lockedPointer)
-        return;
-      pointer && this._disposePointer(pointer);
-      this._state = ACTION.NONE;
-      endDragging();
-    };
     let lastScrollTimeStamp = -1;
     const onMouseWheel = (event) => {
       if (!this._domElement)
@@ -7525,7 +7771,7 @@ class CameraControls extends EventDispatcher {
         lastScrollTimeStamp = now;
       }
       const deltaYFactor = isMac ? -1 : -3;
-      const delta = event.deltaMode === 1 ? event.deltaY / deltaYFactor : event.deltaY / (deltaYFactor * 10);
+      const delta = event.deltaMode === 1 || event.ctrlKey ? event.deltaY / deltaYFactor : event.deltaY / (deltaYFactor * 10);
       const x = this.dollyToCursor ? (event.clientX - this._elementRect.x) / this._elementRect.width * 2 - 1 : 0;
       const y = this.dollyToCursor ? (event.clientY - this._elementRect.y) / this._elementRect.height * -2 + 1 : 0;
       switch (this.mouseButtons.wheel) {
@@ -7535,12 +7781,17 @@ class CameraControls extends EventDispatcher {
           break;
         }
         case ACTION.TRUCK: {
-          this._truckInternal(event.deltaX, event.deltaY, false);
+          this._truckInternal(event.deltaX, event.deltaY, false, false);
+          this._isUserControllingTruck = true;
+          break;
+        }
+        case ACTION.SCREEN_PAN: {
+          this._truckInternal(event.deltaX, event.deltaY, false, true);
           this._isUserControllingTruck = true;
           break;
         }
         case ACTION.OFFSET: {
-          this._truckInternal(event.deltaX, event.deltaY, true);
+          this._truckInternal(event.deltaX, event.deltaY, true, false);
           this._isUserControllingOffset = true;
           break;
         }
@@ -7561,13 +7812,11 @@ class CameraControls extends EventDispatcher {
       if (!this._domElement || !this._enabled)
         return;
       if (this.mouseButtons.right === CameraControls.ACTION.NONE) {
-        const pointerId = event instanceof PointerEvent ? event.pointerId : event instanceof MouseEvent ? 0 : 0;
+        const pointerId = event instanceof PointerEvent ? event.pointerId : 0;
         const pointer = this._findPointerById(pointerId);
         pointer && this._disposePointer(pointer);
         this._domElement.ownerDocument.removeEventListener("pointermove", onPointerMove2, { passive: false });
         this._domElement.ownerDocument.removeEventListener("pointerup", onPointerUp2);
-        this._domElement.ownerDocument.removeEventListener("mousemove", onMouseMove);
-        this._domElement.ownerDocument.removeEventListener("mouseup", onMouseUp);
         return;
       }
       event.preventDefault();
@@ -7622,15 +7871,15 @@ class CameraControls extends EventDispatcher {
         this._thetaVelocity.value = 0;
         this._phiVelocity.value = 0;
       }
-      if ((this._state & ACTION.TRUCK) === ACTION.TRUCK || (this._state & ACTION.TOUCH_TRUCK) === ACTION.TOUCH_TRUCK || (this._state & ACTION.TOUCH_DOLLY_TRUCK) === ACTION.TOUCH_DOLLY_TRUCK || (this._state & ACTION.TOUCH_ZOOM_TRUCK) === ACTION.TOUCH_ZOOM_TRUCK) {
+      if ((this._state & ACTION.TRUCK) === ACTION.TRUCK || (this._state & ACTION.SCREEN_PAN) === ACTION.SCREEN_PAN || (this._state & ACTION.TOUCH_TRUCK) === ACTION.TOUCH_TRUCK || (this._state & ACTION.TOUCH_SCREEN_PAN) === ACTION.TOUCH_SCREEN_PAN || (this._state & ACTION.TOUCH_DOLLY_TRUCK) === ACTION.TOUCH_DOLLY_TRUCK || (this._state & ACTION.TOUCH_DOLLY_SCREEN_PAN) === ACTION.TOUCH_DOLLY_SCREEN_PAN || (this._state & ACTION.TOUCH_ZOOM_TRUCK) === ACTION.TOUCH_ZOOM_TRUCK || (this._state & ACTION.TOUCH_ZOOM_SCREEN_PAN) === ACTION.TOUCH_DOLLY_SCREEN_PAN) {
         this._targetEnd.copy(this._target);
         this._targetVelocity.set(0, 0, 0);
       }
-      if ((this._state & ACTION.DOLLY) === ACTION.DOLLY || (this._state & ACTION.TOUCH_DOLLY) === ACTION.TOUCH_DOLLY || (this._state & ACTION.TOUCH_DOLLY_TRUCK) === ACTION.TOUCH_DOLLY_TRUCK || (this._state & ACTION.TOUCH_DOLLY_OFFSET) === ACTION.TOUCH_DOLLY_OFFSET || (this._state & ACTION.TOUCH_DOLLY_ROTATE) === ACTION.TOUCH_DOLLY_ROTATE) {
+      if ((this._state & ACTION.DOLLY) === ACTION.DOLLY || (this._state & ACTION.TOUCH_DOLLY) === ACTION.TOUCH_DOLLY || (this._state & ACTION.TOUCH_DOLLY_TRUCK) === ACTION.TOUCH_DOLLY_TRUCK || (this._state & ACTION.TOUCH_DOLLY_SCREEN_PAN) === ACTION.TOUCH_DOLLY_SCREEN_PAN || (this._state & ACTION.TOUCH_DOLLY_OFFSET) === ACTION.TOUCH_DOLLY_OFFSET || (this._state & ACTION.TOUCH_DOLLY_ROTATE) === ACTION.TOUCH_DOLLY_ROTATE) {
         this._sphericalEnd.radius = this._spherical.radius;
         this._radiusVelocity.value = 0;
       }
-      if ((this._state & ACTION.ZOOM) === ACTION.ZOOM || (this._state & ACTION.TOUCH_ZOOM) === ACTION.TOUCH_ZOOM || (this._state & ACTION.TOUCH_ZOOM_TRUCK) === ACTION.TOUCH_ZOOM_TRUCK || (this._state & ACTION.TOUCH_ZOOM_OFFSET) === ACTION.TOUCH_ZOOM_OFFSET || (this._state & ACTION.TOUCH_ZOOM_ROTATE) === ACTION.TOUCH_ZOOM_ROTATE) {
+      if ((this._state & ACTION.ZOOM) === ACTION.ZOOM || (this._state & ACTION.TOUCH_ZOOM) === ACTION.TOUCH_ZOOM || (this._state & ACTION.TOUCH_ZOOM_TRUCK) === ACTION.TOUCH_ZOOM_TRUCK || (this._state & ACTION.TOUCH_ZOOM_SCREEN_PAN) === ACTION.TOUCH_ZOOM_SCREEN_PAN || (this._state & ACTION.TOUCH_ZOOM_OFFSET) === ACTION.TOUCH_ZOOM_OFFSET || (this._state & ACTION.TOUCH_ZOOM_ROTATE) === ACTION.TOUCH_ZOOM_ROTATE) {
         this._zoomEnd = this._zoom;
         this._zoomVelocity.value = 0;
       }
@@ -7645,7 +7894,7 @@ class CameraControls extends EventDispatcher {
         return;
       this._dragNeedsUpdate = false;
       extractClientCoordFromEvent(this._activePointers, _v2$1);
-      const isPointerLockActive = this._domElement && document.pointerLockElement === this._domElement;
+      const isPointerLockActive = this._domElement && this._domElement.ownerDocument.pointerLockElement === this._domElement;
       const lockedPointer = isPointerLockActive ? this._lockedPointer || this._activePointers[0] : null;
       const deltaX = lockedPointer ? -lockedPointer.deltaX : lastDragPosition.x - _v2$1.x;
       const deltaY = lockedPointer ? -lockedPointer.deltaY : lastDragPosition.y - _v2$1.y;
@@ -7666,7 +7915,7 @@ class CameraControls extends EventDispatcher {
           this._isUserControllingZoom = true;
         }
       }
-      if ((this._state & ACTION.TOUCH_DOLLY) === ACTION.TOUCH_DOLLY || (this._state & ACTION.TOUCH_ZOOM) === ACTION.TOUCH_ZOOM || (this._state & ACTION.TOUCH_DOLLY_TRUCK) === ACTION.TOUCH_DOLLY_TRUCK || (this._state & ACTION.TOUCH_ZOOM_TRUCK) === ACTION.TOUCH_ZOOM_TRUCK || (this._state & ACTION.TOUCH_DOLLY_OFFSET) === ACTION.TOUCH_DOLLY_OFFSET || (this._state & ACTION.TOUCH_ZOOM_OFFSET) === ACTION.TOUCH_ZOOM_OFFSET || (this._state & ACTION.TOUCH_DOLLY_ROTATE) === ACTION.TOUCH_DOLLY_ROTATE || (this._state & ACTION.TOUCH_ZOOM_ROTATE) === ACTION.TOUCH_ZOOM_ROTATE) {
+      if ((this._state & ACTION.TOUCH_DOLLY) === ACTION.TOUCH_DOLLY || (this._state & ACTION.TOUCH_ZOOM) === ACTION.TOUCH_ZOOM || (this._state & ACTION.TOUCH_DOLLY_TRUCK) === ACTION.TOUCH_DOLLY_TRUCK || (this._state & ACTION.TOUCH_ZOOM_TRUCK) === ACTION.TOUCH_ZOOM_TRUCK || (this._state & ACTION.TOUCH_DOLLY_SCREEN_PAN) === ACTION.TOUCH_DOLLY_SCREEN_PAN || (this._state & ACTION.TOUCH_ZOOM_SCREEN_PAN) === ACTION.TOUCH_ZOOM_SCREEN_PAN || (this._state & ACTION.TOUCH_DOLLY_OFFSET) === ACTION.TOUCH_DOLLY_OFFSET || (this._state & ACTION.TOUCH_ZOOM_OFFSET) === ACTION.TOUCH_ZOOM_OFFSET || (this._state & ACTION.TOUCH_DOLLY_ROTATE) === ACTION.TOUCH_DOLLY_ROTATE || (this._state & ACTION.TOUCH_ZOOM_ROTATE) === ACTION.TOUCH_ZOOM_ROTATE) {
         const dx = _v2$1.x - this._activePointers[1].clientX;
         const dy = _v2$1.y - this._activePointers[1].clientY;
         const distance = Math.sqrt(dx * dx + dy * dy);
@@ -7674,7 +7923,7 @@ class CameraControls extends EventDispatcher {
         dollyStart.set(0, distance);
         const dollyX = this.dollyToCursor ? (lastDragPosition.x - this._elementRect.x) / this._elementRect.width * 2 - 1 : 0;
         const dollyY = this.dollyToCursor ? (lastDragPosition.y - this._elementRect.y) / this._elementRect.height * -2 + 1 : 0;
-        if ((this._state & ACTION.TOUCH_DOLLY) === ACTION.TOUCH_DOLLY || (this._state & ACTION.TOUCH_DOLLY_ROTATE) === ACTION.TOUCH_DOLLY_ROTATE || (this._state & ACTION.TOUCH_DOLLY_TRUCK) === ACTION.TOUCH_DOLLY_TRUCK || (this._state & ACTION.TOUCH_DOLLY_OFFSET) === ACTION.TOUCH_DOLLY_OFFSET) {
+        if ((this._state & ACTION.TOUCH_DOLLY) === ACTION.TOUCH_DOLLY || (this._state & ACTION.TOUCH_DOLLY_ROTATE) === ACTION.TOUCH_DOLLY_ROTATE || (this._state & ACTION.TOUCH_DOLLY_TRUCK) === ACTION.TOUCH_DOLLY_TRUCK || (this._state & ACTION.TOUCH_DOLLY_SCREEN_PAN) === ACTION.TOUCH_DOLLY_SCREEN_PAN || (this._state & ACTION.TOUCH_DOLLY_OFFSET) === ACTION.TOUCH_DOLLY_OFFSET) {
           this._dollyInternal(dollyDelta * TOUCH_DOLLY_FACTOR, dollyX, dollyY);
           this._isUserControllingDolly = true;
         } else {
@@ -7683,11 +7932,15 @@ class CameraControls extends EventDispatcher {
         }
       }
       if ((this._state & ACTION.TRUCK) === ACTION.TRUCK || (this._state & ACTION.TOUCH_TRUCK) === ACTION.TOUCH_TRUCK || (this._state & ACTION.TOUCH_DOLLY_TRUCK) === ACTION.TOUCH_DOLLY_TRUCK || (this._state & ACTION.TOUCH_ZOOM_TRUCK) === ACTION.TOUCH_ZOOM_TRUCK) {
-        this._truckInternal(deltaX, deltaY, false);
+        this._truckInternal(deltaX, deltaY, false, false);
+        this._isUserControllingTruck = true;
+      }
+      if ((this._state & ACTION.SCREEN_PAN) === ACTION.SCREEN_PAN || (this._state & ACTION.TOUCH_SCREEN_PAN) === ACTION.TOUCH_SCREEN_PAN || (this._state & ACTION.TOUCH_DOLLY_SCREEN_PAN) === ACTION.TOUCH_DOLLY_SCREEN_PAN || (this._state & ACTION.TOUCH_ZOOM_SCREEN_PAN) === ACTION.TOUCH_ZOOM_SCREEN_PAN) {
+        this._truckInternal(deltaX, deltaY, false, true);
         this._isUserControllingTruck = true;
       }
       if ((this._state & ACTION.OFFSET) === ACTION.OFFSET || (this._state & ACTION.TOUCH_OFFSET) === ACTION.TOUCH_OFFSET || (this._state & ACTION.TOUCH_DOLLY_OFFSET) === ACTION.TOUCH_DOLLY_OFFSET || (this._state & ACTION.TOUCH_ZOOM_OFFSET) === ACTION.TOUCH_ZOOM_OFFSET) {
-        this._truckInternal(deltaX, deltaY, true);
+        this._truckInternal(deltaX, deltaY, true, false);
         this._isUserControllingOffset = true;
       }
       this.dispatchEvent({ type: "control" });
@@ -7701,9 +7954,7 @@ class CameraControls extends EventDispatcher {
       }
       if (this._activePointers.length === 0 && this._domElement) {
         this._domElement.ownerDocument.removeEventListener("pointermove", onPointerMove2, { passive: false });
-        this._domElement.ownerDocument.removeEventListener("mousemove", onMouseMove);
         this._domElement.ownerDocument.removeEventListener("pointerup", onPointerUp2);
-        this._domElement.ownerDocument.removeEventListener("mouseup", onMouseUp);
         this.dispatchEvent({ type: "controlend" });
       }
     };
@@ -7730,16 +7981,15 @@ class CameraControls extends EventDispatcher {
       startDragging();
     };
     this.unlockPointer = () => {
+      var _a2, _b, _c;
       if (this._lockedPointer !== null) {
         this._disposePointer(this._lockedPointer);
         this._lockedPointer = null;
       }
-      document.exitPointerLock();
+      (_a2 = this._domElement) === null || _a2 === void 0 ? void 0 : _a2.ownerDocument.exitPointerLock();
+      (_b = this._domElement) === null || _b === void 0 ? void 0 : _b.ownerDocument.removeEventListener("pointerlockchange", onPointerLockChange);
+      (_c = this._domElement) === null || _c === void 0 ? void 0 : _c.ownerDocument.removeEventListener("pointerlockerror", onPointerLockError);
       this.cancel();
-      if (!this._domElement)
-        return;
-      this._domElement.ownerDocument.removeEventListener("pointerlockchange", onPointerLockChange);
-      this._domElement.ownerDocument.removeEventListener("pointerlockerror", onPointerLockError);
     };
     const onPointerLockChange = () => {
       const isPointerLockActive = this._domElement && this._domElement.ownerDocument.pointerLockElement === this._domElement;
@@ -7755,7 +8005,6 @@ class CameraControls extends EventDispatcher {
       this._domElement.style.userSelect = "none";
       this._domElement.style.webkitUserSelect = "none";
       this._domElement.addEventListener("pointerdown", onPointerDown2);
-      isPointerEventsNotSupported && this._domElement.addEventListener("mousedown", onMouseDown);
       this._domElement.addEventListener("pointercancel", onPointerUp2);
       this._domElement.addEventListener("wheel", onMouseWheel, { passive: false });
       this._domElement.addEventListener("contextmenu", onContextMenu);
@@ -7767,14 +8016,11 @@ class CameraControls extends EventDispatcher {
       this._domElement.style.userSelect = "";
       this._domElement.style.webkitUserSelect = "";
       this._domElement.removeEventListener("pointerdown", onPointerDown2);
-      this._domElement.removeEventListener("mousedown", onMouseDown);
       this._domElement.removeEventListener("pointercancel", onPointerUp2);
       this._domElement.removeEventListener("wheel", onMouseWheel, { passive: false });
       this._domElement.removeEventListener("contextmenu", onContextMenu);
       this._domElement.ownerDocument.removeEventListener("pointermove", onPointerMove2, { passive: false });
-      this._domElement.ownerDocument.removeEventListener("mousemove", onMouseMove);
       this._domElement.ownerDocument.removeEventListener("pointerup", onPointerUp2);
-      this._domElement.ownerDocument.removeEventListener("mouseup", onMouseUp);
       this._domElement.ownerDocument.removeEventListener("pointerlockchange", onPointerLockChange);
       this._domElement.ownerDocument.removeEventListener("pointerlockerror", onPointerLockError);
     };
@@ -8206,7 +8452,7 @@ class CameraControls extends EventDispatcher {
   lookInDirectionOf(x, y, z, enableTransition = false) {
     const point = _v3A.set(x, y, z);
     const direction = point.sub(this._targetEnd).normalize();
-    const position = direction.multiplyScalar(-this._sphericalEnd.radius);
+    const position = direction.multiplyScalar(-this._sphericalEnd.radius).add(this._targetEnd);
     return this.setPosition(position.x, position.y, position.z, enableTransition);
   }
   /**
@@ -8291,8 +8537,8 @@ class CameraControls extends EventDispatcher {
    */
   fitToSphere(sphereOrMesh, enableTransition) {
     const promises = [];
-    const isSphere = sphereOrMesh instanceof THREE.Sphere;
-    const boundingSphere = isSphere ? _sphere.copy(sphereOrMesh) : CameraControls.createBoundingSphere(sphereOrMesh, _sphere);
+    const isObject3D = "isObject3D" in sphereOrMesh;
+    const boundingSphere = isObject3D ? CameraControls.createBoundingSphere(sphereOrMesh, _sphere) : _sphere.copy(sphereOrMesh);
     promises.push(this.moveTo(boundingSphere.center.x, boundingSphere.center.y, boundingSphere.center.z, enableTransition));
     if (isPerspectiveCamera(this._camera)) {
       const distanceToFit = this.getDistanceToFitSphere(boundingSphere.radius);
@@ -8545,7 +8791,7 @@ class CameraControls extends EventDispatcher {
    * @category Methods
    */
   getSpherical(out, receiveEndValue = true) {
-    const _out = !!out && out instanceof THREE.Spherical ? out : new THREE.Spherical();
+    const _out = out || new THREE.Spherical();
     return _out.copy(receiveEndValue ? this._sphericalEnd : this._spherical);
   }
   /**
@@ -8568,6 +8814,15 @@ class CameraControls extends EventDispatcher {
       this._sphericalEnd.theta += PI_2;
     this._spherical.theta += PI_2 * Math.round((this._sphericalEnd.theta - this._spherical.theta) / PI_2);
   }
+  /**
+   * stop all transitions.
+   */
+  stop() {
+    this._focalOffset.copy(this._focalOffsetEnd);
+    this._target.copy(this._targetEnd);
+    this._spherical.copy(this._sphericalEnd);
+    this._zoom = this._zoomEnd;
+  }
   /**
    * Reset all rotation and position to defaults.
    * @param enableTransition
@@ -8748,7 +9003,6 @@ class CameraControls extends EventDispatcher {
     this._camera.lookAt(this._target);
     const affectOffset = !approxZero(this._focalOffset.x) || !approxZero(this._focalOffset.y) || !approxZero(this._focalOffset.z);
     if (affectOffset) {
-      this._camera.updateMatrixWorld();
       _xColumn.setFromMatrixColumn(this._camera.matrix, 0);
       _yColumn.setFromMatrixColumn(this._camera.matrix, 1);
       _zColumn.setFromMatrixColumn(this._camera.matrix, 2);
@@ -8757,6 +9011,7 @@ class CameraControls extends EventDispatcher {
       _zColumn.multiplyScalar(this._focalOffset.z);
       _v3A.copy(_xColumn).add(_yColumn).add(_zColumn);
       this._camera.position.add(_v3A);
+      this._camera.updateMatrixWorld();
     }
     if (this._boundaryEnclosesCamera) {
       this._encloseToBoundary(this._camera.position.copy(this._target), _v3A.setFromSpherical(this._spherical).applyQuaternion(this._yAxisUpSpaceInverse), 1);
@@ -8801,7 +9056,6 @@ class CameraControls extends EventDispatcher {
       dollySpeed: this.dollySpeed,
       truckSpeed: this.truckSpeed,
       dollyToCursor: this.dollyToCursor,
-      verticalDragToForward: this.verticalDragToForward,
       target: this._targetEnd.toArray(),
       position: _v3A.setFromSpherical(this._sphericalEnd).add(this._targetEnd).toArray(),
       zoom: this._zoomEnd,
@@ -8834,7 +9088,6 @@ class CameraControls extends EventDispatcher {
     this.dollySpeed = obj.dollySpeed;
     this.truckSpeed = obj.truckSpeed;
     this.dollyToCursor = obj.dollyToCursor;
-    this.verticalDragToForward = obj.verticalDragToForward;
     this._target0.fromArray(obj.target0);
     this._position0.fromArray(obj.position0);
     this._zoom0 = obj.zoom0;
@@ -9050,6 +9303,8 @@ class CameraControls extends EventDispatcher {
       if (!object.isMesh)
         return;
       const mesh = object;
+      if (!mesh.geometry)
+        return;
       const geometry = mesh.geometry.clone();
       geometry.applyMatrix4(mesh.matrixWorld);
       const bufferGeometry = geometry;
@@ -9088,14 +9343,14 @@ class SimpleCamera extends BaseCamera {
      * {@link Components.renderer}.
      */
     __publicField(this, "updateAspect", () => {
-      var _a;
+      var _a2;
       if (!this.currentWorld || !this.currentWorld.renderer)
         return;
       if (this.three instanceof THREE$1.OrthographicCamera) {
         this.onAspectUpdated.trigger();
         return;
       }
-      if ((_a = this.currentWorld.renderer) == null ? void 0 : _a.isResizeable()) {
+      if ((_a2 = this.currentWorld.renderer) == null ? void 0 : _a2.isResizeable()) {
         const size = this.currentWorld.renderer.getSize();
         this.three.aspect = size.width / size.height;
         this.three.updateProjectionMatrix();
@@ -10789,7 +11044,7 @@ class SimpleGrid {
             
             `,
       extensions: {
-        derivatives: true
+        // derivatives: true,
       }
     });
     this.three = new THREE$1.Mesh(geometry, material);
@@ -10943,26 +11198,26 @@ const _unit = {
   Z: new Vector3(0, 0, 1)
 };
 const _changeEvent = { type: "change" };
-const _mouseDownEvent = { type: "mouseDown" };
+const _mouseDownEvent = { type: "mouseDown", mode: null };
 const _mouseUpEvent = { type: "mouseUp", mode: null };
 const _objectChangeEvent = { type: "objectChange" };
-class TransformControls extends Object3D {
-  constructor(camera, domElement) {
-    super();
-    if (domElement === void 0) {
-      console.warn('THREE.TransformControls: The second parameter "domElement" is now mandatory.');
-      domElement = document;
-    }
-    this.isTransformControls = true;
-    this.visible = false;
-    this.domElement = domElement;
-    this.domElement.style.touchAction = "none";
-    const _gizmo = new TransformControlsGizmo();
-    this._gizmo = _gizmo;
-    this.add(_gizmo);
-    const _plane2 = new TransformControlsPlane();
-    this._plane = _plane2;
-    this.add(_plane2);
+class TransformControls extends Controls {
+  /**
+   * Constructs a new controls instance.
+   *
+   * @param {Camera} camera - The camera of the rendered scene.
+   * @param {?HTMLDOMElement} domElement - The HTML element used for event listeners.
+   */
+  constructor(camera, domElement = null) {
+    super(void 0, domElement);
+    const root = new TransformControlsRoot(this);
+    this._root = root;
+    const gizmo = new TransformControlsGizmo();
+    this._gizmo = gizmo;
+    root.add(gizmo);
+    const plane = new TransformControlsPlane();
+    this._plane = plane;
+    root.add(plane);
     const scope = this;
     function defineProperty(propName2, defaultValue) {
       let propValue = defaultValue;
@@ -10973,16 +11228,16 @@ class TransformControls extends Object3D {
         set: function(value) {
           if (propValue !== value) {
             propValue = value;
-            _plane2[propName2] = value;
-            _gizmo[propName2] = value;
+            plane[propName2] = value;
+            gizmo[propName2] = value;
             scope.dispatchEvent({ type: propName2 + "-changed", value });
             scope.dispatchEvent(_changeEvent);
           }
         }
       });
       scope[propName2] = defaultValue;
-      _plane2[propName2] = defaultValue;
-      _gizmo[propName2] = defaultValue;
+      plane[propName2] = defaultValue;
+      gizmo[propName2] = defaultValue;
     }
     defineProperty("camera", camera);
     defineProperty("object", void 0);
@@ -10998,6 +11253,12 @@ class TransformControls extends Object3D {
     defineProperty("showX", true);
     defineProperty("showY", true);
     defineProperty("showZ", true);
+    defineProperty("minX", -Infinity);
+    defineProperty("maxX", Infinity);
+    defineProperty("minY", -Infinity);
+    defineProperty("maxY", Infinity);
+    defineProperty("minZ", -Infinity);
+    defineProperty("maxZ", Infinity);
     const worldPosition = new Vector3();
     const worldPositionStart = new Vector3();
     const worldQuaternion = new Quaternion();
@@ -11039,36 +11300,38 @@ class TransformControls extends Object3D {
     this._onPointerHover = onPointerHover.bind(this);
     this._onPointerMove = onPointerMove.bind(this);
     this._onPointerUp = onPointerUp.bind(this);
+    if (domElement !== null) {
+      this.connect(domElement);
+    }
+  }
+  connect(element) {
+    super.connect(element);
     this.domElement.addEventListener("pointerdown", this._onPointerDown);
     this.domElement.addEventListener("pointermove", this._onPointerHover);
     this.domElement.addEventListener("pointerup", this._onPointerUp);
+    this.domElement.style.touchAction = "none";
   }
-  // updateMatrixWorld  updates key transformation variables
-  updateMatrixWorld() {
-    if (this.object !== void 0) {
-      this.object.updateMatrixWorld();
-      if (this.object.parent === null) {
-        console.error("TransformControls: The attached 3D object must be a part of the scene graph.");
-      } else {
-        this.object.parent.matrixWorld.decompose(this._parentPosition, this._parentQuaternion, this._parentScale);
-      }
-      this.object.matrixWorld.decompose(this.worldPosition, this.worldQuaternion, this._worldScale);
-      this._parentQuaternionInv.copy(this._parentQuaternion).invert();
-      this._worldQuaternionInv.copy(this.worldQuaternion).invert();
-    }
-    this.camera.updateMatrixWorld();
-    this.camera.matrixWorld.decompose(this.cameraPosition, this.cameraQuaternion, this._cameraScale);
-    if (this.camera.isOrthographicCamera) {
-      this.camera.getWorldDirection(this.eye).negate();
-    } else {
-      this.eye.copy(this.cameraPosition).sub(this.worldPosition).normalize();
-    }
-    super.updateMatrixWorld(this);
+  disconnect() {
+    this.domElement.removeEventListener("pointerdown", this._onPointerDown);
+    this.domElement.removeEventListener("pointermove", this._onPointerHover);
+    this.domElement.removeEventListener("pointermove", this._onPointerMove);
+    this.domElement.removeEventListener("pointerup", this._onPointerUp);
+    this.domElement.style.touchAction = "auto";
+  }
+  /**
+   * Returns the visual representation of the controls. Add the helper to your scene to
+   * visually transform the attached  3D object.
+   *
+   * @return {TransformControlsRoot} The helper.
+   */
+  getHelper() {
+    return this._root;
   }
   pointerHover(pointer) {
     if (this.object === void 0 || this.dragging === true)
       return;
-    _raycaster.setFromCamera(pointer, this.camera);
+    if (pointer !== null)
+      _raycaster.setFromCamera(pointer, this.camera);
     const intersect = intersectObjectWithRay(this._gizmo.picker[this.mode], _raycaster);
     if (intersect) {
       this.axis = intersect.object.name;
@@ -11077,10 +11340,11 @@ class TransformControls extends Object3D {
     }
   }
   pointerDown(pointer) {
-    if (this.object === void 0 || this.dragging === true || pointer.button !== 0)
+    if (this.object === void 0 || this.dragging === true || pointer != null && pointer.button !== 0)
       return;
     if (this.axis !== null) {
-      _raycaster.setFromCamera(pointer, this.camera);
+      if (pointer !== null)
+        _raycaster.setFromCamera(pointer, this.camera);
       const planeIntersect = intersectObjectWithRay(this._plane, _raycaster, true);
       if (planeIntersect) {
         this.object.updateMatrixWorld();
@@ -11106,9 +11370,10 @@ class TransformControls extends Object3D {
     } else if (axis === "E" || axis === "XYZE" || axis === "XYZ") {
       space = "world";
     }
-    if (object === void 0 || axis === null || this.dragging === false || pointer.button !== -1)
+    if (object === void 0 || axis === null || this.dragging === false || pointer !== null && pointer.button !== -1)
       return;
-    _raycaster.setFromCamera(pointer, this.camera);
+    if (pointer !== null)
+      _raycaster.setFromCamera(pointer, this.camera);
     const planeIntersect = intersectObjectWithRay(this._plane, _raycaster, true);
     if (!planeIntersect)
       return;
@@ -11162,6 +11427,9 @@ class TransformControls extends Object3D {
           }
         }
       }
+      object.position.x = Math.max(this.minX, Math.min(this.maxX, object.position.x));
+      object.position.y = Math.max(this.minY, Math.min(this.maxY, object.position.y));
+      object.position.z = Math.max(this.minZ, Math.min(this.maxZ, object.position.z));
     } else if (mode === "scale") {
       if (axis.search("XYZ") !== -1) {
         let d = this.pointEnd.length() / this.pointStart.length();
@@ -11238,7 +11506,7 @@ class TransformControls extends Object3D {
     this.dispatchEvent(_objectChangeEvent);
   }
   pointerUp(pointer) {
-    if (pointer.button !== 0)
+    if (pointer !== null && pointer.button !== 0)
       return;
     if (this.dragging && this.axis !== null) {
       _mouseUpEvent.mode = this.mode;
@@ -11248,30 +11516,34 @@ class TransformControls extends Object3D {
     this.axis = null;
   }
   dispose() {
-    this.domElement.removeEventListener("pointerdown", this._onPointerDown);
-    this.domElement.removeEventListener("pointermove", this._onPointerHover);
-    this.domElement.removeEventListener("pointermove", this._onPointerMove);
-    this.domElement.removeEventListener("pointerup", this._onPointerUp);
-    this.traverse(function(child) {
-      if (child.geometry)
-        child.geometry.dispose();
-      if (child.material)
-        child.material.dispose();
-    });
+    this.disconnect();
+    this._root.dispose();
   }
-  // Set current object
+  /**
+   * Sets the 3D object that should be transformed and ensures the controls UI is visible.
+   *
+   * @param {Object3D} object -  The 3D object that should be transformed.
+   * @return {TransformControls} A reference to this controls.
+   */
   attach(object) {
     this.object = object;
-    this.visible = true;
+    this._root.visible = true;
     return this;
   }
-  // Detach from object
+  /**
+   * Removes the current 3D object from the controls and makes the helper UI invisible.
+   *
+   * @return {TransformControls} A reference to this controls.
+   */
   detach() {
     this.object = void 0;
-    this.visible = false;
     this.axis = null;
+    this._root.visible = false;
     return this;
   }
+  /**
+   * Resets the object's position, rotation and scale to when the current transform began.
+   */
   reset() {
     if (!this.enabled)
       return;
@@ -11284,28 +11556,68 @@ class TransformControls extends Object3D {
       this.pointStart.copy(this.pointEnd);
     }
   }
+  /**
+   * Returns the raycaster that is used for user interaction. This object is shared between all
+   * instances of `TransformControls`.
+   *
+   * @returns {Raycaster} The internal raycaster.
+   */
   getRaycaster() {
     return _raycaster;
   }
-  // TODO: deprecate
+  /**
+   * Returns the transformation mode.
+   *
+   * @returns {'translate'|'rotate'|'scale'} The transformation mode.
+   */
   getMode() {
     return this.mode;
   }
+  /**
+   * Sets the given transformation mode.
+   *
+   * @param {'translate'|'rotate'|'scale'} mode - The transformation mode to set.
+   */
   setMode(mode) {
     this.mode = mode;
   }
+  /**
+   * Sets the translation snap.
+   *
+   * @param {?number} translationSnap - The translation snap to set.
+   */
   setTranslationSnap(translationSnap) {
     this.translationSnap = translationSnap;
   }
+  /**
+   * Sets the rotation snap.
+   *
+   * @param {?number} rotationSnap - The rotation snap to set.
+   */
   setRotationSnap(rotationSnap) {
     this.rotationSnap = rotationSnap;
   }
+  /**
+   * Sets the scale snap.
+   *
+   * @param {?number} scaleSnap - The scale snap to set.
+   */
   setScaleSnap(scaleSnap) {
     this.scaleSnap = scaleSnap;
   }
+  /**
+   * Sets the size of the helper UI.
+   *
+   * @param {number} size - The size to set.
+   */
   setSize(size) {
     this.size = size;
   }
+  /**
+   * Sets the coordinate space in which transformations are applied.
+   *
+   * @param {'world'|'local'} space - The space to set.
+   */
   setSpace(space) {
     this.space = space;
   }
@@ -11381,6 +11693,45 @@ const _unitZ = new Vector3(0, 0, 1);
 const _v1 = new Vector3();
 const _v2 = new Vector3();
 const _v3 = new Vector3();
+class TransformControlsRoot extends Object3D {
+  constructor(controls) {
+    super();
+    this.isTransformControlsRoot = true;
+    this.controls = controls;
+    this.visible = false;
+  }
+  // updateMatrixWorld updates key transformation variables
+  updateMatrixWorld(force) {
+    const controls = this.controls;
+    if (controls.object !== void 0) {
+      controls.object.updateMatrixWorld();
+      if (controls.object.parent === null) {
+        console.error("TransformControls: The attached 3D object must be a part of the scene graph.");
+      } else {
+        controls.object.parent.matrixWorld.decompose(controls._parentPosition, controls._parentQuaternion, controls._parentScale);
+      }
+      controls.object.matrixWorld.decompose(controls.worldPosition, controls.worldQuaternion, controls._worldScale);
+      controls._parentQuaternionInv.copy(controls._parentQuaternion).invert();
+      controls._worldQuaternionInv.copy(controls.worldQuaternion).invert();
+    }
+    controls.camera.updateMatrixWorld();
+    controls.camera.matrixWorld.decompose(controls.cameraPosition, controls.cameraQuaternion, controls._cameraScale);
+    if (controls.camera.isOrthographicCamera) {
+      controls.camera.getWorldDirection(controls.eye).negate();
+    } else {
+      controls.eye.copy(controls.cameraPosition).sub(controls.worldPosition).normalize();
+    }
+    super.updateMatrixWorld(force);
+  }
+  dispose() {
+    this.traverse(function(child) {
+      if (child.geometry)
+        child.geometry.dispose();
+      if (child.material)
+        child.material.dispose();
+    });
+  }
+}
 class TransformControlsGizmo extends Object3D {
   constructor() {
     super();
@@ -12006,7 +12357,7 @@ class SimplePlane {
   /** {@link Hideable.visible } */
   set visible(state) {
     this._visible = state;
-    this._controls.visible = state;
+    this._controls.object.visible = state;
     this._helper.visible = state;
     this.toggleControls(state);
   }
@@ -12073,7 +12424,7 @@ class SimplePlane {
     this._arrowBoundBox.removeFromParent();
     this._arrowBoundBox.geometry.dispose();
     this._planeMesh.geometry.dispose();
-    this._controls.removeFromParent();
+    this._controls.object.removeFromParent();
     this._controls.dispose();
     this.onDisposed.trigger();
     this.onDisposed.reset();
@@ -12109,7 +12460,7 @@ class SimplePlane {
     const container = this.world.renderer.three.domElement;
     const controls = new TransformControls(camera, container);
     this.initializeControls(controls);
-    this.world.scene.three.add(controls);
+    this.world.scene.three.add(controls.object);
     return controls;
   }
   initializeControls(controls) {
@@ -12118,7 +12469,7 @@ class SimplePlane {
     controls.showY = false;
     controls.setSpace("local");
     this.createArrowBoundingBox();
-    controls.children[0].children[0].add(this._arrowBoundBox);
+    controls.object.children[0].children[0].add(this._arrowBoundBox);
   }
   createArrowBoundingBox() {
     this._arrowBoundBox.geometry = new THREE$1.CylinderGeometry(0.18, 0.18, 1.2);
@@ -12476,12 +12827,12 @@ const _Clipper = class _Clipper extends Component {
     return meshes;
   }
   createPlaneFromIntersection(world, intersect) {
-    var _a;
+    var _a2;
     if (!world.renderer) {
       throw new Error("The given world must have a renderer!");
     }
     const constant = intersect.point.distanceTo(new THREE$1.Vector3(0, 0, 0));
-    const normal = (_a = intersect.face) == null ? void 0 : _a.normal;
+    const normal = (_a2 = intersect.face) == null ? void 0 : _a2.normal;
     if (!constant || !normal) {
       return null;
     }
@@ -14389,7 +14740,7 @@ const IfcCategoryMap = {
 };
 class IfcPropertiesUtils {
   static async getUnits(group) {
-    var _a, _b, _c;
+    var _a2, _b, _c;
     const { IFCUNITASSIGNMENT } = WEBIFC;
     const allUnitsSets = await group.getAllPropertiesOfType(IFCUNITASSIGNMENT);
     if (!allUnitsSets) {
@@ -14415,7 +14766,7 @@ class IfcPropertiesUtils {
       if (unit.Name.value === "FOOT") {
         unitValue = 0.3048;
       }
-      if (((_a = unit.Prefix) == null ? void 0 : _a.value) === "MILLI") {
+      if (((_a2 = unit.Prefix) == null ? void 0 : _a2.value) === "MILLI") {
         factor = 1e-3;
       } else if (((_b = unit.Prefix) == null ? void 0 : _b.value) === "CENTI") {
         factor = 0.01;
@@ -14427,18 +14778,18 @@ class IfcPropertiesUtils {
     return 1;
   }
   static async findItemByGuid(model, guid) {
-    var _a;
+    var _a2;
     const ids = model.getAllPropertiesIDs();
     for (const id of ids) {
       const property = await model.getProperties(id);
-      if (property && ((_a = property.GlobalId) == null ? void 0 : _a.value) === guid) {
+      if (property && ((_a2 = property.GlobalId) == null ? void 0 : _a2.value) === guid) {
         return property;
       }
     }
     return null;
   }
   static async getRelationMap(model, relationType, onElementsFound) {
-    var _a;
+    var _a2;
     const defaultCallback = async () => {
     };
     const _onElementsFound = onElementsFound ?? defaultCallback;
@@ -14458,7 +14809,7 @@ class IfcPropertiesUtils {
       );
       if (!(isRelation && relatingKey && relatedKey))
         continue;
-      const relating = await model.getProperties((_a = prop[relatingKey]) == null ? void 0 : _a.value);
+      const relating = await model.getProperties((_a2 = prop[relatingKey]) == null ? void 0 : _a2.value);
       const related = prop[relatedKey];
       if (!relating || !related) {
         continue;
@@ -14506,7 +14857,7 @@ class IfcPropertiesUtils {
     return props.filter((prop) => prop !== null);
   }
   static async getPsetRel(model, psetID) {
-    var _a;
+    var _a2;
     const prop = await model.getProperties(psetID);
     if (!prop) {
       return null;
@@ -14520,7 +14871,7 @@ class IfcPropertiesUtils {
     const allRels = Object.values(allPropsRels);
     let found = null;
     for (const rel of allRels) {
-      if (((_a = rel.RelatingPropertyDefinition) == null ? void 0 : _a.value) === psetID) {
+      if (((_a2 = rel.RelatingPropertyDefinition) == null ? void 0 : _a2.value) === psetID) {
         found = rel.expressID;
       }
     }
@@ -14530,13 +14881,13 @@ class IfcPropertiesUtils {
     return IfcPropertiesUtils.getPsetRel(model, qsetID);
   }
   static async getEntityName(model, entityID) {
-    var _a;
+    var _a2;
     const entity = await model.getProperties(entityID);
     if (!entity) {
       return { key: null, name: null };
     }
     const key = Object.keys(entity).find((key2) => key2.endsWith("Name")) ?? null;
-    const name = key ? (_a = entity[key]) == null ? void 0 : _a.value : null;
+    const name = key ? (_a2 = entity[key]) == null ? void 0 : _a2.value : null;
     return { key, name };
   }
   static async getQuantityValue(model, quantityID) {
@@ -14567,7 +14918,7 @@ class IfcPropertiesUtils {
     return Object.keys(entity).includes(attribute);
   }
   static async groupEntitiesByType(model, expressIDs) {
-    var _a;
+    var _a2;
     const categoriesMap = /* @__PURE__ */ new Map();
     for (const expressID of expressIDs) {
       const entity = await model.getProperties(expressID);
@@ -14578,7 +14929,7 @@ class IfcPropertiesUtils {
       const set = categoriesMap.get(key);
       if (!set)
         categoriesMap.set(key, /* @__PURE__ */ new Set());
-      (_a = categoriesMap.get(key)) == null ? void 0 : _a.add(expressID);
+      (_a2 = categoriesMap.get(key)) == null ? void 0 : _a2.add(expressID);
     }
     return categoriesMap;
   }
@@ -15753,7 +16104,7 @@ class Units {
     matrix.copy(result);
   }
   setUp(webIfc) {
-    var _a, _b, _c;
+    var _a2, _b, _c;
     this.factor = 1;
     const length = this.getLengthUnits(webIfc);
     if (!length) {
@@ -15767,7 +16118,7 @@ class Units {
     if (length.Name.value === "FOOT") {
       this.factor = 0.3048;
     }
-    if (((_a = length.Prefix) == null ? void 0 : _a.value) === "MILLI") {
+    if (((_a2 = length.Prefix) == null ? void 0 : _a2.value) === "MILLI") {
       this.complement = 1e-3;
     } else if (((_b = length.Prefix) == null ? void 0 : _b.value) === "CENTI") {
       this.complement = 0.01;
@@ -16025,7 +16376,7 @@ class CivilReader {
 }
 class IfcMetadataReader {
   getNameInfo(webIfc) {
-    var _a;
+    var _a2;
     const data = {};
     const { arguments: dataArguments } = webIfc.GetHeaderLine(0, WEBIFC.FILE_NAME) || {};
     if (!dataArguments)
@@ -16051,7 +16402,7 @@ class IfcMetadataReader {
       if (authorEmail == null ? void 0 : authorEmail.value)
         data.author.email = authorEmail.value;
     }
-    if (organization && ((_a = organization[0]) == null ? void 0 : _a.value)) {
+    if (organization && ((_a2 = organization[0]) == null ? void 0 : _a2.value)) {
       data.organization = organization[0].value;
     }
     if (preprocessorVersion == null ? void 0 : preprocessorVersion.value) {
@@ -16066,13 +16417,13 @@ class IfcMetadataReader {
     return data;
   }
   getDescriptionInfo(webIfc) {
-    var _a;
+    var _a2;
     const data = {};
     const { arguments: dataArguments } = webIfc.GetHeaderLine(0, WEBIFC.FILE_DESCRIPTION) || {};
     if (!dataArguments)
       return data;
     const [description, implementationLevel] = dataArguments;
-    if (Array.isArray(description) && ((_a = description[0]) == null ? void 0 : _a.value)) {
+    if (Array.isArray(description) && ((_a2 = description[0]) == null ? void 0 : _a2.value)) {
       const viewDefinition = description[0].value.match(/\[([^\]]+)\]/);
       if (viewDefinition && viewDefinition[1]) {
         data.viewDefinition = viewDefinition[1];
@@ -22303,12 +22654,12 @@ class Comment {
    * @param value - The new comment text.
    */
   set comment(value) {
-    var _a;
+    var _a2;
     const manager = this._components.get(BCFTopics);
     this._comment = value;
     this.modifiedDate = /* @__PURE__ */ new Date();
     this.modifiedAuthor = manager.config.author;
-    (_a = this.topic) == null ? void 0 : _a.comments.set(this.guid, this);
+    (_a2 = this.topic) == null ? void 0 : _a2.comments.set(this.guid, this);
   }
   /**
    * Gets the comment text.
@@ -23191,12 +23542,12 @@ ${users}
     return comment;
   }
   getMarkupComments(markup, version) {
-    var _a;
+    var _a2;
     let data;
     if (version === "2.1")
       data = markup.Comment;
     if (version === "3")
-      data = (_a = markup.Topic.Comments) == null ? void 0 : _a.Comment;
+      data = (_a2 = markup.Topic.Comments) == null ? void 0 : _a2.Comment;
     if (!data)
       return [];
     data = Array.isArray(data) ? data : [data];
@@ -23205,36 +23556,36 @@ ${users}
     return array;
   }
   getMarkupLabels(markup, version) {
-    var _a;
+    var _a2;
     let data;
     if (version === "2.1")
       data = markup.Topic.Labels;
     if (version === "3")
-      data = (_a = markup.Topic.Labels) == null ? void 0 : _a.Label;
+      data = (_a2 = markup.Topic.Labels) == null ? void 0 : _a2.Label;
     if (!data)
       return [];
     const labels = Array.isArray(data) ? data : [data];
     return labels;
   }
   getMarkupViewpoints(markup, version) {
-    var _a;
+    var _a2;
     let data;
     if (version === "2.1")
       data = markup.Viewpoints;
     if (version === "3")
-      data = (_a = markup.Topic.Viewpoints) == null ? void 0 : _a.ViewPoint;
+      data = (_a2 = markup.Topic.Viewpoints) == null ? void 0 : _a2.ViewPoint;
     if (!data)
       return [];
     data = Array.isArray(data) ? data : [data];
     return data;
   }
   getMarkupRelatedTopics(markup, version) {
-    var _a;
+    var _a2;
     let data;
     if (version === "2.1")
       data = markup.Topic.RelatedTopic;
     if (version === "3")
-      data = (_a = markup.Topic.RelatedTopics) == null ? void 0 : _a.RelatedTopic;
+      data = (_a2 = markup.Topic.RelatedTopics) == null ? void 0 : _a2.RelatedTopic;
     if (!data)
       return [];
     const topics = Array.isArray(data) ? data : [data];
@@ -23251,7 +23602,7 @@ ${users}
    * @throws An error if the BCF version is not supported.
    */
   async load(data, world) {
-    var _a;
+    var _a2;
     const {
       fallbackVersionOnImport,
       ignoreIncompleteTopicsOnImport,
@@ -23316,7 +23667,7 @@ ${users}
           ViewSetupHints = Components2.ViewSetupHints;
         }
         if (version === "3") {
-          ViewSetupHints = (_a = Components2.Visibility) == null ? void 0 : _a.ViewSetupHints;
+          ViewSetupHints = (_a2 = Components2.Visibility) == null ? void 0 : _a2.ViewSetupHints;
         }
         if (ViewSetupHints) {
           if ("OpeningsVisible" in ViewSetupHints) {
@@ -24788,7 +25139,7 @@ const _Classifier = class _Classifier extends Component {
    * @throws Will throw an error if the fragment ID is not found.
    */
   async byPredefinedType(group) {
-    var _a;
+    var _a2;
     if (!this.list.predefinedTypes) {
       this.list.predefinedTypes = {};
     }
@@ -24798,7 +25149,7 @@ const _Classifier = class _Classifier extends Component {
       const entity = await group.getProperties(id);
       if (!entity)
         continue;
-      const predefinedType = String((_a = entity.PredefinedType) == null ? void 0 : _a.value).toUpperCase();
+      const predefinedType = String((_a2 = entity.PredefinedType) == null ? void 0 : _a2.value).toUpperCase();
       if (!currentTypes[predefinedType]) {
         currentTypes[predefinedType] = {
           map: {},
@@ -24901,7 +25252,7 @@ const _Classifier = class _Classifier extends Component {
    * @throws Will throw an error if the fragment ID is not found or if the model relations do not exist.
    */
   async bySpatialStructure(model, config = {}) {
-    var _a, _b;
+    var _a2, _b;
     const indexer = this.components.get(IfcRelationsIndexer);
     const modelRelations = indexer.relationMaps[model.uuid];
     if (!modelRelations) {
@@ -24935,7 +25286,7 @@ const _Classifier = class _Classifier extends Component {
             if (!spatialRelAttrs) {
               continue;
             }
-            relName2 = (_a = spatialRelAttrs.Name) == null ? void 0 : _a.value;
+            relName2 = (_a2 = spatialRelAttrs.Name) == null ? void 0 : _a2.value;
           }
           this.saveItem(model, systemName, relName2, expressID, id);
         }
@@ -26200,7 +26551,7 @@ class Viewpoint {
     }
   }
   async createComponentTags(from) {
-    var _a, _b;
+    var _a2, _b;
     const fragments = this._components.get(FragmentsManager);
     const manager = this._components.get(BCFTopics);
     let tags = "";
@@ -26215,7 +26566,7 @@ class Viewpoint {
           const attrs = await model.getProperties(expressID);
           if (!attrs)
             continue;
-          const globalID = (_a = attrs.GlobalId) == null ? void 0 : _a.value;
+          const globalID = (_a2 = attrs.GlobalId) == null ? void 0 : _a2.value;
           if (!globalID)
             continue;
           const tag = (_b = attrs.Tag) == null ? void 0 : _b.value;
@@ -27388,14 +27739,14 @@ class IDSAttribute extends IDSFacet {
   // All invalid cases have been treated as failures
   // FragmentsGroup do not hold some of the entities used in the tests
   async test(entities) {
-    var _a;
+    var _a2;
     this.testResult = [];
     for (const _expressID in entities) {
       const expressID = Number(_expressID);
       const attrs = entities[expressID];
       const checks = [];
       const result2 = {
-        guid: (_a = attrs.GlobalId) == null ? void 0 : _a.value,
+        guid: (_a2 = attrs.GlobalId) == null ? void 0 : _a2.value,
         expressID,
         pass: false,
         checks,
@@ -27489,7 +27840,7 @@ class IDSClassification extends IDSFacet {
 </classification>`;
   }
   async getEntities(model, collector = {}) {
-    var _a;
+    var _a2;
     const result = [];
     const references = await model.getAllPropertiesOfType(
       WEBIFC.IFCCLASSIFICATIONREFERENCE
@@ -27504,7 +27855,7 @@ class IDSClassification extends IDSFacet {
       const attrs = await model.getProperties(classificationID);
       if (!attrs)
         continue;
-      const referencedSourceID = (_a = attrs.ReferencedSource) == null ? void 0 : _a.value;
+      const referencedSourceID = (_a2 = attrs.ReferencedSource) == null ? void 0 : _a2.value;
       if (!referencedSourceID)
         continue;
       const classificationAttrs = await model.getProperties(referencedSourceID);
@@ -27541,14 +27892,14 @@ class IDSClassification extends IDSFacet {
     return result;
   }
   async test(entities, model) {
-    var _a;
+    var _a2;
     this.testResult = [];
     for (const _expressID in entities) {
       const expressID = Number(_expressID);
       const attrs = entities[expressID];
       const checks = [];
       const result2 = {
-        guid: (_a = attrs.GlobalId) == null ? void 0 : _a.value,
+        guid: (_a2 = attrs.GlobalId) == null ? void 0 : _a2.value,
         expressID,
         pass: false,
         checks,
@@ -27591,8 +27942,8 @@ class IDSClassification extends IDSFacet {
     return result;
   }
   async processReferencedSource(model, attrs) {
-    var _a;
-    const sourceID = (_a = attrs.ReferencedSource) == null ? void 0 : _a.value;
+    var _a2;
+    const sourceID = (_a2 = attrs.ReferencedSource) == null ? void 0 : _a2.value;
     if (!sourceID)
       return null;
     const sourceAttrs = await model.getProperties(sourceID);
@@ -27607,7 +27958,7 @@ class IDSClassification extends IDSFacet {
     return sourceAttrs;
   }
   async getSystems(model, expressID) {
-    var _a;
+    var _a2;
     const result = [];
     const indexer = this.components.get(IfcRelationsIndexer);
     const ocurrenceAssociations = indexer.getEntityRelations(
@@ -27634,9 +27985,9 @@ class IDSClassification extends IDSFacet {
       }
     }
     const occurrenceSystems = result.map((attrs) => {
-      var _a2, _b, _c;
+      var _a3, _b, _c;
       if (attrs.type === WEBIFC.IFCCLASSIFICATION) {
-        return (_a2 = attrs.Name) == null ? void 0 : _a2.value;
+        return (_a3 = attrs.Name) == null ? void 0 : _a3.value;
       }
       if (attrs.type === WEBIFC.IFCCLASSIFICATIONREFERENCE) {
         return (_c = (_b = attrs.ReferencedSource) == null ? void 0 : _b.Name) == null ? void 0 : _c.value;
@@ -27658,7 +28009,7 @@ class IDSClassification extends IDSFacet {
         if (!attrs)
           continue;
         if (attrs.type === WEBIFC.IFCCLASSIFICATION) {
-          if (occurrenceSystems.includes((_a = attrs.Name) == null ? void 0 : _a.value))
+          if (occurrenceSystems.includes((_a2 = attrs.Name) == null ? void 0 : _a2.value))
             continue;
           result.push(attrs);
         }
@@ -27675,9 +28026,9 @@ class IDSClassification extends IDSFacet {
     return result;
   }
   getSystemName(attrs) {
-    var _a, _b, _c, _d;
+    var _a2, _b, _c, _d;
     if (attrs.type === WEBIFC.IFCCLASSIFICATION) {
-      return (_a = attrs.Name) == null ? void 0 : _a.value;
+      return (_a2 = attrs.Name) == null ? void 0 : _a2.value;
     }
     if (attrs.type === WEBIFC.IFCCLASSIFICATIONREFERENCE) {
       if (((_b = attrs.ReferencedSource) == null ? void 0 : _b.type) === WEBIFC.IFCCLASSIFICATIONREFERENCE) {
@@ -27733,11 +28084,11 @@ class IDSClassification extends IDSFacet {
     return !!identifier;
   }
   evalURI(attrs, checks) {
-    var _a;
+    var _a2;
     if (!this.uri)
       return true;
     const result = this.evalRequirement(
-      (_a = attrs.Location) == null ? void 0 : _a.value,
+      (_a2 = attrs.Location) == null ? void 0 : _a2.value,
       {
         type: "simple",
         parameter: this.uri
@@ -27809,14 +28160,14 @@ class IDSEntity extends IDSFacet {
     return result;
   }
   async test(entities, model) {
-    var _a;
+    var _a2;
     this.testResult = [];
     for (const _expressID in entities) {
       const expressID = Number(_expressID);
       const attrs = entities[expressID];
       const checks = [];
       const result = {
-        guid: (_a = attrs.GlobalId) == null ? void 0 : _a.value,
+        guid: (_a2 = attrs.GlobalId) == null ? void 0 : _a2.value,
         expressID,
         pass: false,
         checks,
@@ -27835,12 +28186,12 @@ class IDSEntity extends IDSFacet {
     return result;
   }
   async evalPredefinedType(model, attrs, checks) {
-    var _a, _b, _c, _d;
+    var _a2, _b, _c, _d;
     if (!this.predefinedType)
       return null;
     const indexer = this.components.get(IfcRelationsIndexer);
     const isRequirementUserDefined = typeof this.predefinedType.parameter === "string" && this.predefinedType.parameter === "USERDEFINED";
-    let value = (_a = attrs.PredefinedType) == null ? void 0 : _a.value;
+    let value = (_a2 = attrs.PredefinedType) == null ? void 0 : _a2.value;
     if (value === "USERDEFINED" && !isRequirementUserDefined) {
       const attrNames = Object.keys(attrs);
       const result2 = attrNames.find(
@@ -27912,7 +28263,7 @@ class IDSProperty extends IDSFacet {
 </property>`;
   }
   async getEntities(model, collector = {}) {
-    var _a, _b;
+    var _a2, _b;
     let sets = {};
     const psets = await model.getAllPropertiesOfType(WEBIFC.IFCPROPERTYSET);
     sets = { ...sets, ...psets };
@@ -27926,7 +28277,7 @@ class IDSProperty extends IDSFacet {
       const attrs = await model.getProperties(setID);
       if (!attrs)
         continue;
-      const nameMatches = ((_a = attrs.Name) == null ? void 0 : _a.value) === this.propertySet.parameter;
+      const nameMatches = ((_a2 = attrs.Name) == null ? void 0 : _a2.value) === this.propertySet.parameter;
       if (!nameMatches)
         continue;
       let propsListName;
@@ -27975,14 +28326,14 @@ class IDSProperty extends IDSFacet {
     return [];
   }
   async test(entities, model) {
-    var _a;
+    var _a2;
     this.testResult = [];
     for (const _expressID in entities) {
       const expressID = Number(_expressID);
       const attrs = entities[expressID];
       const checks = [];
       const result2 = {
-        guid: (_a = attrs.GlobalId) == null ? void 0 : _a.value,
+        guid: (_a2 = attrs.GlobalId) == null ? void 0 : _a2.value,
         expressID,
         pass: false,
         checks,
@@ -28027,12 +28378,12 @@ class IDSProperty extends IDSFacet {
         }
         const items = set.Properties;
         const matchingItems = items.filter((item) => {
-          var _a2;
+          var _a3;
           if (this._unsupportedTypes.includes(item.type)) {
             return false;
           }
           const result3 = this.evalRequirement(
-            ((_a2 = item.Name) == null ? void 0 : _a2.value) ?? null,
+            ((_a3 = item.Name) == null ? void 0 : _a3.value) ?? null,
             this.baseName,
             "BaseName"
           );
@@ -28081,7 +28432,7 @@ class IDSProperty extends IDSFacet {
     );
   }
   async simplifyPset(model, attrs, propsListName) {
-    var _a;
+    var _a2;
     const props = [];
     const list = attrs[propsListName];
     if (!list)
@@ -28092,7 +28443,7 @@ class IDSProperty extends IDSFacet {
         props.push(propAttrs);
     }
     const attrsClone = {
-      Name: (_a = attrs.Name) == null ? void 0 : _a.value,
+      Name: (_a2 = attrs.Name) == null ? void 0 : _a2.value,
       Properties: props,
       type: attrs.type
     };
@@ -28119,7 +28470,7 @@ class IDSProperty extends IDSFacet {
     return sets;
   }
   async getPsets(model, expressID) {
-    var _a;
+    var _a2;
     const typePsets = await this.getTypePsets(model, expressID);
     const indexer = this.components.get(IfcRelationsIndexer);
     const definitions = indexer.getEntityRelations(
@@ -28147,7 +28498,7 @@ class IDSProperty extends IDSFacet {
       );
       if (typePset) {
         for (const prop of typePset.Properties) {
-          const name = (_a = prop.Name) == null ? void 0 : _a.value;
+          const name = (_a2 = prop.Name) == null ? void 0 : _a2.value;
           const existingProp = occurencePset.Properties.find(
             ({ Name }) => Name.value === name
           );