@thatopen/components 2.4.0-alpha.9 → 2.4.0

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, Plane, Line3, Vector2, Triangle, Sphere, Matrix4, Box3, BackSide, DoubleSide, FrontSide, Ray, Mesh, Object3D, MeshBasicMaterial, LineBasicMaterial, CylinderGeometry, BoxGeometry, BufferGeometry, Float32BufferAttribute, OctahedronGeometry, Line, TorusGeometry, SphereGeometry, Quaternion, Euler, PlaneGeometry, Raycaster } from "three";
 import * as FRAGS from "@thatopen/fragments";
 import { FragmentsGroup, Serializer } from "@thatopen/fragments";
 import * as WEBIFC from "web-ifc";
@@ -3808,7 +3808,9 @@ class DataMap extends Map {
     this.onCleared.trigger();
   }
   /**
-   * Sets the value for the specified key in the map and triggers the appropriate event (onItemSet or onItemUpdated).
+   * Sets the value for the specified key in the map.
+   * If the item is new, then onItemSet is triggered.
+   * If the item is already in the map, then onItemUpdated is triggered.
    *
    * @param key - The key of the item to set.
    * @param value - The value of the item to set.
@@ -3858,6 +3860,97 @@ class DataMap extends Map {
 }
 class ComponentWithUI extends Component {
 }
+class ControlsUtils {
+  static isEntry(item) {
+    const types = /* @__PURE__ */ new Set([
+      "Boolean",
+      "Color",
+      "Text",
+      "Number",
+      "Select",
+      "Vector3",
+      "TextSet",
+      "None"
+    ]);
+    return types.has(item.type);
+  }
+  static copySchema(schema, copy = {}) {
+    for (const name in schema) {
+      const entry = schema[name];
+      if (this.isEntry(entry)) {
+        copy[name] = this.copyEntry(entry);
+      } else {
+        copy[name] = {};
+        this.copySchema(entry, copy[name]);
+      }
+    }
+    return copy;
+  }
+  static copyEntry(controlEntry) {
+    if (controlEntry.type === "Boolean") {
+      const entry = controlEntry;
+      return {
+        type: entry.type,
+        value: entry.value
+      };
+    }
+    if (controlEntry.type === "Color") {
+      const entry = controlEntry;
+      return {
+        type: entry.type,
+        value: entry.value.clone()
+      };
+    }
+    if (controlEntry.type === "Text") {
+      const entry = controlEntry;
+      return {
+        type: entry.type,
+        value: entry.value
+      };
+    }
+    if (controlEntry.type === "Number") {
+      const entry = controlEntry;
+      return {
+        type: entry.type,
+        value: entry.value,
+        min: entry.min,
+        max: entry.max,
+        interpolable: entry.interpolable
+      };
+    }
+    if (controlEntry.type === "Select") {
+      const entry = controlEntry;
+      return {
+        type: entry.type,
+        value: entry.value,
+        multiple: entry.multiple,
+        options: new Set(entry.options)
+      };
+    }
+    if (controlEntry.type === "Vector3") {
+      const entry = controlEntry;
+      return {
+        type: entry.type,
+        value: entry.value.clone()
+      };
+    }
+    if (controlEntry.type === "TextSet") {
+      const entry = controlEntry;
+      return {
+        type: entry.type,
+        value: new Set(entry.value)
+      };
+    }
+    if (controlEntry.type === "None") {
+      const entry = controlEntry;
+      return {
+        type: entry.type,
+        value: entry.value
+      };
+    }
+    throw new Error("Invalid entry!");
+  }
+}
 class EventManager {
   constructor() {
     /**
@@ -5366,7 +5459,7 @@ const _Components = class _Components {
 /**
  * The version of the @thatopen/components library.
  */
-__publicField(_Components, "release", "2.4.0-alpha.1");
+__publicField(_Components, "release", "2.4.0");
 let Components = _Components;
 class SimpleWorld extends Base {
   constructor() {
@@ -5533,76 +5626,69 @@ class Configurator {
     configManager.list.set(this.uuid, this);
   }
   get controls() {
-    const copy = {};
-    for (const name in this._config) {
-      const entry = this._config[name];
-      copy[name] = this.copyEntry(entry);
-    }
-    return copy;
+    return ControlsUtils.copySchema(this._config);
   }
-  copyEntry(controlEntry) {
-    if (controlEntry.type === "Boolean") {
-      const entry = controlEntry;
-      return {
-        type: entry.type,
-        value: entry.value
-      };
-    }
-    if (controlEntry.type === "Color") {
-      const entry = controlEntry;
-      return {
-        type: entry.type,
-        value: entry.value.clone()
-      };
-    }
-    if (controlEntry.type === "Text") {
-      const entry = controlEntry;
-      return {
-        type: entry.type,
-        value: entry.value
-      };
-    }
-    if (controlEntry.type === "Number") {
-      const entry = controlEntry;
-      return {
-        type: entry.type,
-        value: entry.value,
-        min: entry.min,
-        max: entry.max,
-        interpolable: entry.interpolable
-      };
-    }
-    if (controlEntry.type === "Select") {
-      const entry = controlEntry;
-      return {
-        type: entry.type,
-        value: entry.value,
-        multiple: entry.multiple,
-        options: new Set(entry.options)
-      };
-    }
-    if (controlEntry.type === "Vector3") {
-      const entry = controlEntry;
-      return {
-        type: entry.type,
-        value: entry.value.clone()
-      };
-    }
-    if (controlEntry.type === "TextSet") {
-      const entry = controlEntry;
-      return {
-        type: entry.type,
-        value: new Set(entry.value)
-      };
+  set(data) {
+    for (const name in data) {
+      if (name in this) {
+        const key = name;
+        this[key] = data[name].value;
+      }
+    }
+  }
+  export(controls = this._config, exported = {}) {
+    for (const id in controls) {
+      const control = controls[id];
+      const isControl = ControlsUtils.isEntry(control);
+      if (isControl) {
+        if (control.type === "Color") {
+          const { r, g, b } = control.value;
+          exported[id] = { ...control, value: { r, g, b } };
+        } else if (control.type === "Vector3") {
+          const { x, y, z } = control.value;
+          exported[id] = { ...control, value: { x, y, z } };
+        } else if (control.type === "TextSet") {
+          const value = Array.from(control.value);
+          exported[id] = { ...control, value };
+        } else if (control.type === "Select") {
+          const options = Array.from(control.options);
+          exported[id] = { ...control, options };
+        } else {
+          exported[id] = { ...control };
+        }
+      } else {
+        exported[id] = {};
+        this.export(control, exported[id]);
+      }
+    }
+    return exported;
+  }
+  import(exported, imported = {}, first = true) {
+    for (const id in exported) {
+      const control = exported[id];
+      const isControl = ControlsUtils.isEntry(control);
+      if (isControl) {
+        if (control.type === "Color") {
+          const { r, g, b } = control.value;
+          imported[id] = { ...control, value: new THREE$1.Color(r, g, b) };
+        } else if (control.type === "Vector3") {
+          const { x, y, z } = control.value;
+          imported[id] = { ...control, value: new THREE$1.Vector3(x, y, z) };
+        } else if (control.type === "TextSet") {
+          imported[id] = { ...control, value: new Set(control.value) };
+        } else if (control.type === "Select") {
+          imported[id] = { ...control, options: new Set(control.options) };
+        } else {
+          imported[id] = { ...control };
+        }
+      } else {
+        imported[id] = {};
+        this.import(control, imported[id], false);
+      }
     }
-    if (controlEntry.type === "None") {
-      const entry = controlEntry;
-      return {
-        type: entry.type,
-        value: entry.value
-      };
+    if (first) {
+      this.set(imported);
     }
-    throw new Error("Invalid entry!");
   }
 }
 const _ConfigManager = class _ConfigManager extends Component {
@@ -11070,6 +11156,9 @@ class SimplePlane {
    * @param {boolean} state - The new enabled state.
    */
   set enabled(state) {
+    if (this.world.isDisposing) {
+      return;
+    }
     if (!this.world.renderer) {
       throw new Error("No renderer found for clipping plane!");
     }
@@ -15312,7 +15401,8 @@ const GeometryTypes = /* @__PURE__ */ new Set([
   3958567839,
   2513912981,
   2830218821,
-  427810014
+  427810014,
+  2916149573
 ]);
 const _IfcJsonExporter = class _IfcJsonExporter extends Component {
   constructor(components) {
@@ -15866,7 +15956,7 @@ const _IfcPropertiesManager = class _IfcPropertiesManager extends Component {
    */
   async newPset(model, name, description) {
     const schema = _IfcPropertiesManager.getIFCSchema(model);
-    const { ownerHistoryHandle } = await this.getOwnerHistory(model);
+    const { handle: ownerHistoryHandle } = await this.getOwnerHistory(model);
     const psetGlobalId = this.newGUID(model);
     const psetName = new WEBIFC[schema].IfcLabel(name);
     const psetDescription = description ? new WEBIFC[schema].IfcText(description) : null;
@@ -15878,18 +15968,8 @@ const _IfcPropertiesManager = class _IfcPropertiesManager extends Component {
       []
     );
     pset.expressID = this.getNewExpressID(model);
-    const relGlobalId = this.newGUID(model);
-    const rel = new WEBIFC[schema].IfcRelDefinesByProperties(
-      relGlobalId,
-      ownerHistoryHandle,
-      null,
-      null,
-      [],
-      new WEBIFC.Handle(pset.expressID)
-    );
-    rel.expressID = this.getNewExpressID(model);
-    await this.setData(model, pset, rel);
-    return { pset, rel };
+    await this.setData(model, pset);
+    return { pset };
   }
   /**
    * Removes a Property Set (Pset) from the given model.
@@ -16004,7 +16084,7 @@ const _IfcPropertiesManager = class _IfcPropertiesManager extends Component {
     indexer.addEntitiesRelation(
       model,
       psetID,
-      { type: WEBIFC.IFCRELDEFINESBYPROPERTIES, inv: "IsDefinedBy" },
+      { type: WEBIFC.IFCRELDEFINESBYPROPERTIES, inv: "DefinesOcurrence" },
       ...expressIDs
     );
   }
@@ -16052,7 +16132,7 @@ const _IfcPropertiesManager = class _IfcPropertiesManager extends Component {
     if (!relName) {
       throw new Error(`IfcPropertiesManager: ${relName} is unsoported.`);
     }
-    const schema = model.ifcMetadata.schema;
+    const schema = _IfcPropertiesManager.getIFCSchema(model);
     const attributePositions = ifcRelAttrsPosition[relName];
     const RelClass = WEBIFC[schema][relName];
     if (!(attributePositions && RelClass)) {
@@ -16103,7 +16183,9 @@ const _IfcPropertiesManager = class _IfcPropertiesManager extends Component {
     for (const expressID of changes) {
       const data = await model.getProperties(expressID);
       if (!data) {
-        ifcApi.DeleteLine(modelID, expressID);
+        const existed = ifcApi.GetLine(modelID, expressID);
+        if (existed)
+          ifcApi.DeleteLine(modelID, expressID);
       } else {
         ifcApi.WriteLine(modelID, data);
       }
@@ -16200,9 +16282,9 @@ const _IfcPropertiesManager = class _IfcPropertiesManager extends Component {
       throw new Error("No OwnerHistory was found.");
     }
     const keys = Object.keys(ownerHistories).map((key) => parseInt(key, 10));
-    const ownerHistory = ownerHistories[keys[0]];
-    const ownerHistoryHandle = new WEBIFC.Handle(ownerHistory.expressID);
-    return { ownerHistory, ownerHistoryHandle };
+    const entity = ownerHistories[keys[0]];
+    const handle = new WEBIFC.Handle(entity.expressID);
+    return { entity, handle };
   }
   registerChange(model, ...expressID) {
     if (!this.changeMap[model.uuid]) {
@@ -16307,7 +16389,7 @@ const _IfcRelationsIndexer = class _IfcRelationsIndexer extends Component {
     __publicField(this, "onFragmentsDisposed", (data) => {
       delete this.relationMaps[data.groupID];
     });
-    // Use to create the corresponding IfcRelationship
+    // Used to create the corresponding IfcRelationship with the IfcPropertiesManager
     __publicField(this, "_changeMap", {});
     /**
      * An event that is triggered when entities are related in a BIM model.
@@ -16330,43 +16412,26 @@ const _IfcRelationsIndexer = class _IfcRelationsIndexer extends Component {
       return;
     const relatingID = relAttrs[relatingKey].value;
     const relatedIDs = relAttrs[relatedKey].map((el) => el.value);
-    const index = this.getAttributeIndex(relating);
-    if (index !== null) {
-      let currentMap = relationsMap.get(relatingID);
-      if (!currentMap) {
-        currentMap = /* @__PURE__ */ new Map();
-        relationsMap.set(relatingID, currentMap);
-      }
-      let indexMap = currentMap.get(index);
-      if (!indexMap) {
-        indexMap = [];
-        currentMap.set(index, indexMap);
-      }
-      for (const id of relatedIDs) {
-        indexMap.push(id);
-      }
+    const indexMap = this.getEntityRelations(
+      relationsMap,
+      relatingID,
+      relating
+    );
+    for (const id of relatedIDs) {
+      indexMap.push(id);
     }
     for (const id of relatedIDs) {
-      const index2 = this.getAttributeIndex(related);
-      if (index2 === null)
-        continue;
-      let currentMap = relationsMap.get(id);
-      if (!currentMap) {
-        currentMap = /* @__PURE__ */ new Map();
-        relationsMap.set(id, currentMap);
-      }
-      let relations = currentMap.get(index2);
-      if (!relations) {
-        relations = [];
-        currentMap.set(index2, relations);
-      }
+      const relations = this.getEntityRelations(relationsMap, id, related);
       relations.push(relatingID);
     }
   }
   getAttributeIndex(inverseAttribute) {
     const index = this._inverseAttributes.indexOf(inverseAttribute);
-    if (index === -1)
-      return null;
+    if (index === -1) {
+      throw new Error(
+        `IfcRelationsIndexer: ${inverseAttribute} is not a valid IFC Inverse Attribute name or its not supported yet by this component.`
+      );
+    }
     return index;
   }
   /**
@@ -16400,28 +16465,27 @@ const _IfcRelationsIndexer = class _IfcRelationsIndexer extends Component {
    * representation of the relations indexed by entity expressIDs and relation types.
    * @throws An error if the model does not have properties loaded.
    */
-  async process(model) {
+  async process(model, config) {
     if (!model.hasProperties)
       throw new Error("FragmentsGroup properties not found");
     let relationsMap = this.relationMaps[model.uuid];
-    if (relationsMap) {
-      return relationsMap;
+    if (!relationsMap) {
+      relationsMap = /* @__PURE__ */ new Map();
+      this.relationMaps[model.uuid] = relationsMap;
     }
-    relationsMap = /* @__PURE__ */ new Map();
-    for (const relType of this._ifcRels) {
-      const relsAttrs = await model.getAllPropertiesOfType(relType);
-      if (!relsAttrs) {
+    const entities = model.getLocalProperties();
+    if (!entities)
+      return relationsMap;
+    const relationsToProcess = (config == null ? void 0 : config.relationsToProcess) ?? this._ifcRels;
+    for (const [_, entity] of Object.entries(entities)) {
+      if (!relationsToProcess.includes(entity.type))
         continue;
-      }
-      const relInverseAttributes = this._relToAttributesMap.get(relType);
+      const relInverseAttributes = this._relToAttributesMap.get(entity.type);
       if (!relInverseAttributes) {
         continue;
       }
       const { forRelated: related, forRelating: relating } = relInverseAttributes;
-      for (const expressID in relsAttrs) {
-        const relAttrs = relsAttrs[expressID];
-        this.indexRelations(relationsMap, relAttrs, related, relating);
-      }
+      this.indexRelations(relationsMap, entity, related, relating);
     }
     this.setRelationMap(model, relationsMap);
     return relationsMap;
@@ -16463,26 +16527,33 @@ const _IfcRelationsIndexer = class _IfcRelationsIndexer extends Component {
    *
    * @param model The `FragmentsGroup` model containing the entity, or its UUID.
    * @param expressID The unique identifier of the entity within the model.
-   * @param relationName The IFC schema inverse attribute of the relation to search for (e.g., "IsDefinedBy", "ContainsElements").
-   * @returns An array of express IDs representing the related entities, or `null` if no relations are found
-   * or the specified relation name is not indexed.
-   */
-  getEntityRelations(model, expressID, relationName) {
-    const id = model instanceof FragmentsGroup ? model.uuid : model;
-    const indexMap = this.relationMaps[id];
-    if (!indexMap) {
-      throw new Error(
-        `IfcRelationsIndexer: model ${id} has no relations indexed.`
-      );
+   * @param attribute The IFC schema inverse attribute of the relation to search for (e.g., "IsDefinedBy", "ContainsElements").
+   * @returns An array of express IDs representing the related entities. If the array is empty, no relations were found.
+   */
+  getEntityRelations(model, expressID, attribute) {
+    const index = this.getAttributeIndex(attribute);
+    let relationsMap;
+    if (model instanceof FragmentsGroup) {
+      relationsMap = this.relationMaps[model.uuid];
+    } else if (typeof model === "string") {
+      relationsMap = this.relationMaps[model];
+    } else {
+      relationsMap = model;
     }
-    const entityRelations = indexMap.get(expressID);
-    const attributeIndex = this.getAttributeIndex(relationName);
-    if (entityRelations === void 0 || attributeIndex === null) {
-      return null;
+    if (!relationsMap && (model instanceof FragmentsGroup || typeof model === "string")) {
+      relationsMap = /* @__PURE__ */ new Map();
+      const id = model instanceof FragmentsGroup ? model.uuid : model;
+      this.relationMaps[id] = relationsMap;
+    }
+    let entityRelations = relationsMap.get(expressID);
+    if (!entityRelations) {
+      entityRelations = /* @__PURE__ */ new Map();
+      relationsMap.set(expressID, entityRelations);
     }
-    const relations = entityRelations.get(attributeIndex);
+    let relations = entityRelations.get(index);
     if (!relations) {
-      return null;
+      relations = [];
+      entityRelations.set(index, relations);
     }
     return relations;
   }
@@ -16603,8 +16674,6 @@ const _IfcRelationsIndexer = class _IfcRelationsIndexer extends Component {
     const set = /* @__PURE__ */ new Set();
     for (const [id, map] of relations) {
       const index = this.getAttributeIndex(inv);
-      if (index === null)
-        throw new Error("IfcRelationsIndexer: invalid inverse attribute name");
       const rels = map.get(index);
       if (rels && rels.includes(expressID))
         set.add(id);
@@ -16630,28 +16699,17 @@ const _IfcRelationsIndexer = class _IfcRelationsIndexer extends Component {
     );
     if (!existingRelations) {
       const attributeIndex = this.getAttributeIndex(relationName);
-      if (!attributeIndex) {
-        throw new Error(
-          `IfcRelationsIndexer: ${relationName} is not a valid relation name.`
-        );
-      }
       const entityRelations = this.relationMaps[model.uuid].get(expressID);
       entityRelations == null ? void 0 : entityRelations.set(attributeIndex, relIDs);
     } else {
       existingRelations.push(...relIDs);
     }
   }
-  // removeEntitiesRelation(
-  //   model: FragmentsGroup,
-  //   relatingID: number,
-  //   relationName: InverseAttribute,
-  //   ...relatedIDs: number[]
-  // ) {}
   /**
    * Converts the relations made into actual IFC data.
    *
    * @remarks This function iterates through the changes made to the relations and applies them to the corresponding BIM model.
-   * It only make sense to use if the relations need to be write in the IFC file.
+   * It only make sense to use it if the relations need to be write in the IFC file.
    *
    * @returns A promise that resolves when all the relation changes have been applied.
    */
@@ -16695,9 +16753,11 @@ const _IfcRelationsIndexer = class _IfcRelationsIndexer extends Component {
   }
   addEntitiesRelation(model, relatingID, rel, ...relatedIDs) {
     const { type, inv } = rel;
-    const relationsMap = this.relationMaps[model.uuid];
-    if (!relationsMap)
-      return;
+    let relationsMap = this.relationMaps[model.uuid];
+    if (!relationsMap) {
+      relationsMap = /* @__PURE__ */ new Map();
+      this.relationMaps[model.uuid] = relationsMap;
+    }
     if (!this._ifcRels.includes(type))
       return;
     const relInvAttrs = relToAttributesMap.get(type);
@@ -16743,35 +16803,11 @@ const _IfcRelationsIndexer = class _IfcRelationsIndexer extends Component {
       relatingData.related.add(...relatedExpressID);
     }
     for (const id of relatingExpressID) {
-      let currentMap = relationsMap.get(id);
-      if (!currentMap) {
-        currentMap = /* @__PURE__ */ new Map();
-        relationsMap.set(id, currentMap);
-      }
-      const index = this.getAttributeIndex(relating);
-      if (index !== null) {
-        let indexMap = currentMap.get(index);
-        if (!indexMap) {
-          indexMap = [];
-          currentMap.set(index, indexMap);
-        }
-        indexMap.push(...relatedExpressID);
-      }
+      const indexMap = this.getEntityRelations(model, id, relating);
+      indexMap.push(...relatedExpressID);
     }
     for (const id of relatedExpressID) {
-      let currentMap = relationsMap.get(id);
-      if (!currentMap) {
-        currentMap = /* @__PURE__ */ new Map();
-        relationsMap.set(id, currentMap);
-      }
-      const index = this.getAttributeIndex(related);
-      if (index === null)
-        continue;
-      let relations = currentMap.get(index);
-      if (!relations) {
-        relations = [];
-        currentMap.set(index, relations);
-      }
+      const relations = this.getEntityRelations(model, id, related);
       relations.push(...relatingExpressID);
     }
   }
@@ -21520,9 +21556,9 @@ const _Topic = class _Topic {
     __publicField(this, "_type", _Topic.default.type);
     __publicField(this, "_status", _Topic.default.status);
     __publicField(this, "_priority", _Topic.default.priority);
-    __publicField(this, "_stage", _Topic.default.priority);
+    __publicField(this, "_stage", _Topic.default.stage);
     __publicField(this, "_assignedTo", _Topic.default.assignedTo);
-    __publicField(this, "_labels", _Topic.default.labels);
+    __publicField(this, "_labels", _Topic.default.labels ?? /* @__PURE__ */ new Set());
     __publicField(this, "_components");
     this._components = components;
     const manager = components.get(BCFTopics);
@@ -21848,8 +21884,7 @@ ${tags}
 __publicField(_Topic, "default", {
   title: "BCF Topic",
   type: "Issue",
-  status: "Active",
-  labels: /* @__PURE__ */ new Set()
+  status: "Active"
 });
 let Topic = _Topic;
 const extensionsImporter = (manager, extensionsXML) => {
@@ -22109,8 +22144,9 @@ const _BCFTopics = class _BCFTopics extends Component {
     if (data) {
       topic.guid = data.guid ?? topic.guid;
       topic.set(data);
+    } else {
+      this.list.set(topic.guid, topic);
     }
-    this.list.set(topic.guid, topic);
     return topic;
   }
   /**
@@ -23000,6 +23036,84 @@ const _BoundingBoxer = class _BoundingBoxer extends Component {
 };
 __publicField(_BoundingBoxer, "uuid", "d1444724-dba6-4cdd-a0c7-68ee1450d166");
 let BoundingBoxer = _BoundingBoxer;
+const _IfcIsolator = class _IfcIsolator extends Component {
+  constructor(components) {
+    super(components);
+    /** {@link Component.enabled} */
+    __publicField(this, "enabled", true);
+    components.add(_IfcIsolator.uuid, this);
+  }
+  async getIsolatedElements(webIfc, modelID, elementIDs) {
+    const isolatedElementIDs = /* @__PURE__ */ new Set();
+    function addElementAndReferences(elementID) {
+      if (isolatedElementIDs.has(elementID))
+        return;
+      const element = webIfc.GetLine(modelID, elementID);
+      if (!element)
+        return;
+      isolatedElementIDs.add(elementID);
+      for (const prop in element) {
+        const value = element[prop];
+        if (value && value.constructor.name === "Handle" && value.value > 0) {
+          addElementAndReferences(value.value);
+        } else if (Array.isArray(value)) {
+          value.forEach((refID) => {
+            if (refID && refID.constructor.name === "Handle" && refID.value > 0) {
+              addElementAndReferences(refID.value);
+            }
+          });
+        }
+      }
+    }
+    for (const elementID of elementIDs) {
+      addElementAndReferences(elementID);
+    }
+    const arr = [];
+    for (const elementID of isolatedElementIDs) {
+      arr.push(elementID);
+    }
+    arr.sort((a, b) => {
+      return a - b;
+    });
+    const isolatedElements = [];
+    arr.forEach((elementID) => {
+      const element = webIfc.GetLine(modelID, elementID);
+      isolatedElements.push(element);
+    });
+    return isolatedElements;
+  }
+  /**
+   * Exports isolated elements to the new model.
+   * @param webIfc The instance of [web-ifc](https://github.com/ThatOpen/engine_web-ifc) to use.
+   * @param modelID ID of the new IFC model.
+   * @param isolatedElements The array of isolated elements
+   */
+  async export(webIfc, modelID, isolatedElements) {
+    isolatedElements.forEach((element) => {
+      webIfc.WriteLine(modelID, element);
+    });
+    const data = webIfc.SaveModel(modelID);
+    return data;
+  }
+  async splitIfc(webIfc, ifcFile, idsToExtract) {
+    const ifcBuffer = new Uint8Array(ifcFile);
+    const modelID = webIfc.OpenModel(ifcBuffer);
+    const isolated = await this.getIsolatedElements(
+      webIfc,
+      modelID,
+      idsToExtract
+    );
+    const newModelID = webIfc.CreateModel({ schema: WEBIFC.Schemas.IFC2X3 });
+    const data = await this.export(webIfc, newModelID, isolated);
+    return data;
+  }
+};
+/**
+ * A unique identifier for the component.
+ * This UUID is used to register the component within the Components system.
+ */
+__publicField(_IfcIsolator, "uuid", "6eb0ba2f-71c0-464e-bcec-2d7c335186b2");
+let IfcIsolator = _IfcIsolator;
 const _IfcFinderQuery = class _IfcFinderQuery {
   constructor(components) {
     /**
@@ -23966,7 +24080,7 @@ const _Classifier = class _Classifier extends Component {
         `Classifier: model relations of ${model.name || model.uuid} have to exists to group by spatial structure.`
       );
     }
-    const systemName = "spatialStructures";
+    const systemName = config.systemName ?? "spatialStructures";
     const noProps = config.useProperties === void 0;
     const useProperties = noProps || config.useProperties;
     for (const [expressID] of modelRelations) {
@@ -24091,19 +24205,18 @@ const _Classifier = class _Classifier extends Component {
         };
       }
     }
-    return JSON.stringify(exported);
+    return exported;
   }
   /**
    * Imports a classification previously exported with .export().
    * @param data the serialized classification to import.
    */
   import(data) {
-    const imported = JSON.parse(data);
-    for (const systemName in imported) {
+    for (const systemName in data) {
       if (!this.list[systemName]) {
         this.list[systemName] = {};
       }
-      const system = imported[systemName];
+      const system = data[systemName];
       for (const groupName in system) {
         const group = system[groupName];
         this.list[systemName][groupName] = {
@@ -24667,16 +24780,27 @@ const _IfcGeometryTiler = class _IfcGeometryTiler extends Component {
     this._assets = [];
   }
   async streamGeometries() {
-    let buffer = this._streamSerializer.export(this._geometries);
+    const exportMap = /* @__PURE__ */ new Map();
+    for (const [id, value] of this._geometries) {
+      exportMap.set(id, value);
+      if (exportMap.size > this.settings.minGeometrySize) {
+        await this.outputGeometries(exportMap);
+      }
+    }
+    await this.outputGeometries(exportMap);
+    this._geometries.clear();
+    this._geometryCount = 0;
+  }
+  async outputGeometries(exportMap) {
+    let buffer = this._streamSerializer.export(exportMap);
     let data = {};
-    for (const [id, { boundingBox: boundingBox2, hasHoles }] of this._geometries) {
+    for (const [id, { boundingBox: boundingBox2, hasHoles }] of exportMap) {
       data[id] = { boundingBox: boundingBox2, hasHoles };
     }
     await this.onGeometryStreamed.trigger({ data, buffer });
     data = null;
     buffer = null;
-    this._geometries.clear();
-    this._geometryCount = 0;
+    exportMap.clear();
   }
   registerGeometryData(group, itemID, geometry, asset, geometryID, transpGeometryID) {
     const geometryData = this._visitedGeometries.get(transpGeometryID);
@@ -25106,8 +25230,8 @@ class Viewpoint {
    *
    * @returns A Promise that resolves when the camera has been set.
    */
-  async go(transition = true) {
-    const { camera } = this.world;
+  async go(world, transition = true) {
+    const { camera } = world ?? this.world;
     if (!camera.hasCameraControls()) {
       throw new Error(
         "Viewpoint: the world's camera need controls to set the viewpoint."
@@ -25171,8 +25295,8 @@ class Viewpoint {
    * @throws An error if the world's camera does not have camera controls.
    * @throws An error if the world's renderer is not available.
    */
-  updateCamera() {
-    const { camera, renderer } = this.world;
+  updateCamera(world) {
+    const { camera, renderer } = world ?? this.world;
     if (!renderer) {
       throw new Error("Viewpoint: the world needs to have a renderer!");
     }
@@ -26249,21 +26373,17 @@ class IDSFacet {
         this.addCheckResult(checkLog, checks);
       let pass = false;
       if (facetParameter.type === "simple") {
-        const parameter2 = facetParameter.parameter;
-        pass = value === parameter2;
+        pass = value === facetParameter.parameter;
       }
       if (facetParameter.type === "enumeration") {
-        const parameter2 = facetParameter.parameter;
-        pass = parameter2.includes(value);
+        pass = facetParameter.parameter.includes(value);
       }
       if (facetParameter.type === "pattern") {
-        const parameter2 = facetParameter.parameter;
-        const regex = new RegExp(parameter2);
+        const regex = new RegExp(facetParameter.parameter);
         pass = regex.test(String(value));
       }
       if (facetParameter.type === "length") {
-        const parameter2 = facetParameter.parameter;
-        const { min, length, max } = parameter2;
+        const { min, length, max } = facetParameter.parameter;
         if (length !== void 0) {
           pass = String(value).length === length;
         }
@@ -26347,6 +26467,7 @@ const getParameterXML = (name, parameter) => {
 class IDSAttribute extends IDSFacet {
   constructor(components, name) {
     super(components);
+    __publicField(this, "facetType", "Attribute");
     __publicField(this, "name");
     __publicField(this, "value");
     this.name = name;
@@ -26483,6 +26604,7 @@ class IDSAttribute extends IDSFacet {
 class IDSClassification extends IDSFacet {
   constructor(components, system) {
     super(components);
+    __publicField(this, "facetType", "Classification");
     __publicField(this, "system");
     __publicField(this, "value");
     __publicField(this, "uri");
@@ -26765,6 +26887,7 @@ class IDSClassification extends IDSFacet {
 class IDSEntity extends IDSFacet {
   constructor(components, name) {
     super(components);
+    __publicField(this, "facetType", "Entity");
     __publicField(this, "name");
     __publicField(this, "predefinedType");
     this.name = name;
@@ -26893,11 +27016,13 @@ class IDSEntity extends IDSFacet {
 class IDSProperty extends IDSFacet {
   constructor(components, propertySet, baseName) {
     super(components);
+    __publicField(this, "facetType", "Property");
     __publicField(this, "propertySet");
     __publicField(this, "baseName");
     __publicField(this, "value");
     __publicField(this, "dataType");
     __publicField(this, "uri");
+    // These are defined by the IDS specification
     __publicField(this, "_unsupportedTypes", [
       WEBIFC.IFCCOMPLEXPROPERTY,
       WEBIFC.IFCPHYSICALCOMPLEXQUANTITY
@@ -27093,10 +27218,43 @@ class IDSProperty extends IDSFacet {
       (name) => name.endsWith("Value") || name.endsWith("Values")
     );
   }
-  // IFCPROPERTYSET from type must be get as well
-  async getPsets(model, expressID) {
+  async getPsetProps(model, attrs, propsListName) {
+    const attrsClone = structuredClone(attrs);
+    const props = [];
+    const list = attrsClone[propsListName];
+    if (!list)
+      return props;
+    for (const { value } of list) {
+      const propAttrs = await model.getProperties(value);
+      if (propAttrs)
+        props.push(propAttrs);
+    }
+    attrsClone[propsListName] = props;
+    return attrsClone;
+  }
+  async getTypePsets(model, expressID) {
     const sets = [];
     const indexer = this.components.get(IfcRelationsIndexer);
+    const types = indexer.getEntityRelations(model, expressID, "IsTypedBy");
+    if (!(types && types[0]))
+      return sets;
+    const typeAttrs = await model.getProperties(types[0]);
+    if (!(typeAttrs && "HasPropertySets" in typeAttrs && Array.isArray(typeAttrs.HasPropertySets))) {
+      return sets;
+    }
+    for (const { value } of typeAttrs.HasPropertySets) {
+      const psetAttrs = await model.getProperties(value);
+      if (!(psetAttrs && "HasProperties" in psetAttrs && Array.isArray(psetAttrs.HasProperties))) {
+        continue;
+      }
+      const pset = await this.getPsetProps(model, psetAttrs, "HasProperties");
+      sets.push(pset);
+    }
+    return sets;
+  }
+  async getPsets(model, expressID) {
+    const sets = await this.getTypePsets(model, expressID);
+    const indexer = this.components.get(IfcRelationsIndexer);
     const definitions = indexer.getEntityRelations(
       model,
       expressID,
@@ -27111,15 +27269,8 @@ class IDSProperty extends IDSFacet {
       const propsListName = this.getItemsAttrName(attrs.type);
       if (!propsListName)
         continue;
-      const attrsClone = structuredClone(attrs);
-      const props = [];
-      for (const { value } of attrsClone[propsListName]) {
-        const propAttrs = await model.getProperties(value);
-        if (propAttrs)
-          props.push(propAttrs);
-      }
-      attrsClone[propsListName] = props;
-      sets.push(attrsClone);
+      const pset = await this.getPsetProps(model, attrs, propsListName);
+      sets.push(pset);
     }
     return sets;
   }
@@ -27128,8 +27279,9 @@ class IDSProperty extends IDSFacet {
   // Work must to be done to convert numerical value units to IDS-nominated standard units https://github.com/buildingSMART/IDS/blob/development/Documentation/UserManual/units.md
   evalValue(attrs, checks) {
     const valueKey = this.getValueKey(attrs);
+    const valueAttr = attrs[valueKey];
     if (this.value) {
-      if (!valueKey) {
+      if (!valueAttr) {
         checks == null ? void 0 : checks.push({
           parameter: "Value",
           currentValue: null,
@@ -27138,17 +27290,16 @@ class IDSProperty extends IDSFacet {
         });
         return false;
       }
-      const valueAttr = attrs[valueKey];
       const facetValue = structuredClone(this.value);
       if (valueAttr.name === "IFCLABEL" && facetValue.type === "simple") {
         facetValue.parameter = String(facetValue.parameter);
       }
       if ((attrs.type === WEBIFC.IFCPROPERTYLISTVALUE || attrs.type === WEBIFC.IFCPROPERTYENUMERATEDVALUE) && Array.isArray(valueAttr)) {
-        const values = valueAttr.map((value2) => value2.value);
-        const matchingValue = valueAttr.find((value2) => {
+        const values = valueAttr.map((value) => value.value);
+        const matchingValue = valueAttr.find((value) => {
           if (!facetValue)
             return false;
-          return this.evalRequirement(value2.value, facetValue, "Value");
+          return this.evalRequirement(value.value, facetValue, "Value");
         });
         checks == null ? void 0 : checks.push({
           currentValue: values,
@@ -27168,8 +27319,7 @@ class IDSProperty extends IDSFacet {
     }
     if (!valueKey)
       return true;
-    const value = attrs[valueKey];
-    if (value.type === 3 && value.value === 2) {
+    if (valueAttr.type === 3 && valueAttr.value === 2) {
       checks == null ? void 0 : checks.push({
         parameter: "Value",
         currentValue: null,
@@ -27178,7 +27328,7 @@ class IDSProperty extends IDSFacet {
       });
       return false;
     }
-    if (value.type === 1 && value.value.trim() === "") {
+    if (valueAttr.type === 1 && valueAttr.value.trim() === "") {
       checks == null ? void 0 : checks.push({
         parameter: "Value",
         currentValue: "",
@@ -27194,6 +27344,15 @@ class IDSProperty extends IDSFacet {
       return true;
     const valueKey = this.getValueKey(attrs);
     const valueAttr = attrs[valueKey];
+    if (!valueAttr) {
+      checks == null ? void 0 : checks.push({
+        parameter: "DataType",
+        currentValue: null,
+        pass: false,
+        requiredValue: this.dataType
+      });
+      return false;
+    }
     if ((attrs.type === WEBIFC.IFCPROPERTYLISTVALUE || attrs.type === WEBIFC.IFCPROPERTYENUMERATEDVALUE) && Array.isArray(valueAttr) && valueAttr[0]) {
       const valueType = valueAttr[0].name;
       const result2 = this.evalRequirement(
@@ -27239,6 +27398,20 @@ class IDSSpecification {
       this.ifcVersion.add(version);
     }
   }
+  set(data) {
+    const _data = data;
+    const _this = this;
+    for (const key in data) {
+      if (key === "identifier")
+        continue;
+      const value = _data[key];
+      if (key in this)
+        _this[key] = value;
+    }
+    const manager = this.components.get(IDSSpecifications);
+    manager.list.set(this.identifier, this);
+    return this;
+  }
   /**
    * Tests the model to test against the specification's requirements.
    *
@@ -27284,8 +27457,9 @@ class IDSSpecification {
 const getParameterValue = (property) => {
   if (!property)
     return void 0;
-  const result = { type: "simple" };
+  const result = {};
   if ("simpleValue" in property) {
+    result.type = "simple";
     result.parameter = property.simpleValue;
   }
   if ("restriction" in property) {
@@ -27577,6 +27751,7 @@ export {
   Components,
   ConfigManager,
   Configurator,
+  ControlsUtils,
   CullerRenderer,
   Cullers,
   DataMap,
@@ -27605,6 +27780,7 @@ export {
   IfcFinderQuery,
   IfcFragmentSettings,
   IfcGeometryTiler,
+  IfcIsolator,
   IfcJsonExporter,
   IfcLoader,
   IfcPropertiesManager,