@thatopen/components 2.4.4 → 2.4.6

package/README.md

@@ -0,0 +1,92 @@
+<p align="center">
+  <a href="https://thatopen.com/">TOC</a>
+  |
+  <a href="https://docs.thatopen.com/intro">documentation</a>
+  |
+  <a href="https://thatopen.github.io/engine_components/examples/IfcLoader/index.html">demo</a>
+  |
+  <a href="https://people.thatopen.com/">community</a>
+  |
+  <a href="https://www.npmjs.com/org/thatopen">npm package</a>
+</p>
+
+![cover](https://thatopen.github.io/engine_components/resources/cover.png)
+
+<h1>Open BIM Components <img src="https://thatopen.github.io/engine_components/resources/favicon.ico" width="32"/></h1>
+
+[![NPM Package][npm]][npm-url]
+[![NPM Package][npm-downloads]][npm-url]
+
+This library is a collection of BIM tools based on [Three.js](https://github.com/mrdoob/three.js/) and other libraries. It includes pre-made features to easily build browser-based 3D BIM applications, such as postproduction, dimensions, floorplan navigation, DXF export and much more. 
+
+
+## 🤝 Want our help?
+Are you developing a project with our technology and would like our help?
+Apply now to join [That Open Accelerator Program](https://thatopen.com/accelerator)!
+
+
+## 🧩 Integration with fragments
+As you might know, we have 4 open source libraries:
+- [web-ifc](https://github.com/ThatOpen/engine_web-ifc): the IFC parser and geometry engine.
+- [fragments](https://github.com/ThatOpen/engine_fragment): the open source format and 3D engine.
+- [components](https://github.com/ThatOpen/engine_components): a set of tools to build BIM software fast. 
+- [ui components](https://github.com/ThatOpen/engine_ui-components): our agnostic UI system.
+
+Components doesn't work with this new version of Fragments yet. In the next release, at the end of Q2, all components will be updated to work with this new version of Fragments. In the meantime, you have 3 options:
+
+- Work with Fragments and build your own BIM components from scratch.
+- Work with Components (which don't use this new version of Fragments).
+- Check out our [Accelerator Program](https://thatopen.com/accelerator) to get previous access to the upcoming components.
+
+Once the release at the end of Q2 is made, Components will work natively with this new version of Fragments.
+
+## Packages
+
+This library contains 2 packages:
+
+`@thatopen/components` - The core functionality. Compatible both with browser and Node.js environments.
+
+`@thatopen/components-front` - Features exclusive for browser environments.
+
+## Usage
+
+You need to be familiar with [Three.js API](https://github.com/mrdoob/three.js/) to be able to use this library effectively. In the following example, we will create a cube in a 3D scene that can be navigated with the mouse or touch events. You can see the full example [here](https://github.com/ThatOpen/engine_components/blob/main/packages/core/src/core/Worlds/example.ts) and the deployed app [here](https://thatopen.github.io/engine_components/examples/Worlds/index.html).
+
+```js
+/* eslint import/no-extraneous-dependencies: 0 */
+
+import * as THREE from "three";
+import * as OBC from "../..";
+
+const container = document.getElementById("container")!;
+
+const components = new OBC.Components();
+
+const worlds = components.get(OBC.Worlds);
+
+const world = worlds.create<
+  OBC.SimpleScene,
+  OBC.SimpleCamera,
+  OBC.SimpleRenderer
+>();
+
+world.scene = new OBC.SimpleScene(components);
+world.renderer = new OBC.SimpleRenderer(components, container);
+world.camera = new OBC.SimpleCamera(components);
+
+components.init();
+
+const material = new THREE.MeshLambertMaterial({ color: "#6528D7" });
+const geometry = new THREE.BoxGeometry();
+const cube = new THREE.Mesh(geometry, material);
+world.scene.three.add(cube);
+
+world.scene.setup();
+
+world.camera.controls.setLookAt(3, 3, 3, 0, 0, 0);
+```
+
+
+[npm]: https://img.shields.io/npm/v/@thatopen/components
+[npm-url]: https://www.npmjs.com/package/@thatopen/components
+[npm-downloads]: https://img.shields.io/npm/dw/@thatopen/components

package/dist/core/Components/index.d.ts

@@ -6,7 +6,7 @@ export declare class Components implements Disposable {
     /**
      * The version of the @thatopen/components library.
      */
-    static readonly release = "2.4.4";
+    static readonly release = "2.4.6";
     /** {@link Disposable.onDisposed} */
     readonly onDisposed: Event<void>;
     /**

package/dist/index.cjs

@@ -6312,7 +6312,7 @@ const _Components = class _Components {
 /**
  * The version of the @thatopen/components library.
  */
-__publicField(_Components, "release", "2.4.4");
+__publicField(_Components, "release", "2.4.6");
 let Components = _Components;
 class SimpleWorld extends Base {
   constructor() {
@@ -12775,6 +12775,9 @@ class ProjectionManager {
   setupOrthoCamera(height, width) {
     this._component.controls.mouseButtons.wheel = CameraControls.ACTION.ZOOM;
     this._component.controls.mouseButtons.middle = CameraControls.ACTION.ZOOM;
+    this._component.controls.touches.two = CameraControls.ACTION.TOUCH_ZOOM_TRUCK;
+    this._component.controls.touches.three = CameraControls.ACTION.TOUCH_ZOOM_TRUCK;
+    this._component.controls.dollySpeed = 5;
     const pCamera = this._component.threePersp;
     const oCamera = this._component.threeOrtho;
     oCamera.zoom = 1;
@@ -12801,6 +12804,9 @@ class ProjectionManager {
     pCamera.position.copy(oCamera.position);
     pCamera.quaternion.copy(oCamera.quaternion);
     this._component.controls.mouseButtons.wheel = CameraControls.ACTION.DOLLY;
+    this._component.controls.touches.two = CameraControls.ACTION.TOUCH_DOLLY_TRUCK;
+    this._component.controls.touches.three = CameraControls.ACTION.TOUCH_DOLLY_TRUCK;
+    this._component.controls.dollySpeed = 5;
     if (this.matchOrthoDistanceEnabled) {
       this._component.controls.distance = this.getDistance();
     } else {
@@ -26753,7 +26759,7 @@ class MiniMap {
     this._camera.left = frustumSize * aspect / -2;
     this._camera.right = frustumSize * aspect / 2;
     this._camera.top = frustumSize / 2;
-    this._camera.bottom = -frustumSize / 2;
+    this._camera.bottom = -1 / 2;
     this._camera.updateProjectionMatrix();
     this.onResize.trigger(size);
   }
@@ -27287,12 +27293,12 @@ const getParameterXML = (name, parameter) => {
   if (!parameter)
     return parameterXML;
   if (parameter.type === "simple") {
-    parameterXML = `<ids:simpleValue>${parameter.parameter}</ids:simpleValue>`;
+    parameterXML = `<simpleValue>${parameter.parameter}</simpleValue>`;
   }
   if (parameter.type === "enumeration") {
     const value = parameter.parameter;
     parameterXML = `<xs:restriction base="xs:string">
-    ${value.map((v) => `<xs:enumeration value="${v}" />`).join("\r\n")}
+    ${value.map((v) => `<xs:enumeration value="${v}" />`).join("\n")}
     </xs:restriction>`;
   }
   if (parameter.type === "pattern") {
@@ -27301,9 +27307,44 @@ const getParameterXML = (name, parameter) => {
       <xs:pattern value="${value}" />
     </xs:restriction>`;
   }
-  const xml = `<ids:${name[0].toLowerCase() + name.slice(1)}>
+  if (parameter.type === "bounds") {
+    const { min, minInclusive, max, maxInclusive } = parameter.parameter;
+    let minTag = "";
+    if (min !== void 0) {
+      minTag = `<xs:min${minInclusive ? "Inclusive" : "Exclusive"} value="${min}">`;
+    }
+    let maxTag = "";
+    if (max !== void 0) {
+      maxTag = `<xs:max${maxInclusive ? "Inclusive" : "Exclusive"} value="${max}">`;
+    }
+    parameterXML = `<xs:restriction base="xs:double">
+      ${minTag}
+      ${maxTag}
+    </xs:restriction>`;
+  }
+  if (parameter.type === "length") {
+    const { length, min, max } = parameter.parameter;
+    let lengthTag = "";
+    if (length !== void 0 && min === void 0 && max === void 0) {
+      lengthTag = `<xs:length value="${length}" />`;
+    }
+    let minTag = "";
+    if (min !== void 0 && length === void 0) {
+      minTag = `<xs:minLength value="${min}" />`;
+    }
+    let maxTag = "";
+    if (max !== void 0 && length === void 0) {
+      maxTag = `<xs:maxLength value="${max}" />`;
+    }
+    parameterXML = `<xs:restriction base="xs:string">
+      ${lengthTag}
+      ${minTag}
+      ${maxTag}
+    </xs:restriction>`;
+  }
+  const xml = `<${name[0].toLowerCase() + name.slice(1)}>
     ${parameterXML}
-  </ids:${name[0].toLowerCase() + name.slice(1)}>`;
+  </${name[0].toLowerCase() + name.slice(1)}>`;
   return xml;
 };
 class IDSAttribute extends IDSFacet {
@@ -27322,10 +27363,10 @@ class IDSAttribute extends IDSFacet {
       attributes += `cardinality="${this.cardinality}"`;
       attributes += this.instructions ? `instructions="${this.instructions}"` : "";
     }
-    return `<ids:attribute ${attributes}>
+    return `<attribute ${attributes}>
   ${nameXML}
   ${valueXML}
-</ids:attribute>`;
+</attribute>`;
   }
   // This can be very ineficcient as we do not have an easy way to get an entity based on an attribute
   // Right now, all entities must be iterated.
@@ -27461,10 +27502,10 @@ class IDSClassification extends IDSFacet {
       attributes += this.uri ? `uri=${this.uri}` : "";
       attributes += this.instructions ? `instructions="${this.instructions}"` : "";
     }
-    return `<ids:classification ${attributes}>
+    return `<classification ${attributes}>
   ${systemXML}
   ${valueXML}
-</ids:classification>`;
+</classification>`;
   }
   async getEntities(model, collector = {}) {
     var _a;
@@ -27742,10 +27783,10 @@ class IDSEntity extends IDSFacet {
       attributes += `cardinality="${this.cardinality}"`;
       attributes += this.instructions ? `instructions="${this.instructions}"` : "";
     }
-    return `<ids:entity ${attributes}>
+    return `<entity ${attributes}>
   ${nameXML}
   ${predefinedTypeXML}
-</ids:entity>`;
+</entity>`;
   }
   // IFCSURFACESTYLEREFRACTION is not present in the FragmentsGroup
   // IFCSURFACESTYLERENDERING is not present in the FragmentsGroup
@@ -27883,11 +27924,11 @@ class IDSProperty extends IDSFacet {
       attributes += this.uri ? `uri=${this.uri}` : "";
       attributes += this.instructions ? `instructions="${this.instructions}"` : "";
     }
-    return `<ids:property ${dataTypeXML} ${attributes}>
+    return `<property ${dataTypeXML} ${attributes}>
   ${propertySetXML}
   ${baseNameXML}
   ${valueXML}
-</ids:property>`;
+</property>`;
   }
   async getEntities(model, collector = {}) {
     var _a, _b;
@@ -28306,14 +28347,14 @@ class IDSSpecification {
     const identifier = this.identifier ? `identifier="${this.identifier}"` : "";
     const description = this.description ? `description="${this.description}"` : "";
     const instructions = this.instructions ? `instructions="${this.instructions}"` : "";
-    const xml = `<ids:specification ifcVersion="${[...this.ifcVersion].join(" ")}" ${name} ${identifier} ${description} ${instructions}>
-      <ids:applicability minOccurs="1" maxOccurs="unbounded">
-        ${[...this.applicability].map((facet) => facet.serialize("applicability"))}
-      </ids:applicability>
-      <ids:requirements>
-        ${[...this.requirements].map((facet) => facet.serialize("requirement"))}
-      </ids:requirements>
-    </ids:specification>`;
+    const xml = `<specification ifcVersion="${[...this.ifcVersion].join(" ")}" ${name} ${identifier} ${description} ${instructions}>
+      <applicability minOccurs="1" maxOccurs="unbounded">
+        ${[...this.applicability].map((facet) => facet.serialize("applicability")).join("\n")}
+      </applicability>
+      <requirements>
+        ${[...this.requirements].map((facet) => facet.serialize("requirement")).join("\n")}
+      </requirements>
+    </specification>`;
     return xml;
   }
 }
@@ -28562,22 +28603,22 @@ const _IDSSpecifications = class _IDSSpecifications extends Component {
    */
   export(info, specifications = this.list.values()) {
     const _specifications = specifications ?? this.list;
-    const xml = `<ids:ids xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://standards.buildingsmart.org/IDS http://standards.buildingsmart.org/IDS/1.0/ids.xsd" xmlns:ids="http://standards.buildingsmart.org/IDS">
+    const xml = `<ids xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://standards.buildingsmart.org/IDS http://standards.buildingsmart.org/IDS/1.0/ids.xsd" xmlns:ids="http://standards.buildingsmart.org/IDS">
   <!-- Made with That Open Engine ${Components.release} (https://github.com/thatopen/engine_components) -->
-  <ids:info>
-    <ids:title>${info.title}</ids:title>
-    ${info.copyright ? `<ids:copyright>${info.copyright}</ids:copyright>` : ""}
-    ${info.version ? `<ids:version>${info.version}</ids:version>` : ""}
-    ${info.description ? `<ids:description>${info.description}</ids:description>` : ""}
-    ${info.author ? `<ids:author>${info.author}</ids:author>` : ""}
-    ${info.date ? `<ids:date>${info.date.toISOString().split("T")[0]}</ids:date>` : ""}
-    ${info.purpose ? `<ids:purpose>${info.purpose}</ids:purpose>` : ""}
-    ${info.milestone ? `<ids:milestone>${info.milestone}</ids:milestone>` : ""}
-  </ids:info>
-  <ids:specifications>
+  <info>
+    <title>${info.title}</title>
+    ${info.copyright ? `<copyright>${info.copyright}</copyright>` : ""}
+    ${info.version ? `<version>${info.version}</version>` : ""}
+    ${info.description ? `<description>${info.description}</description>` : ""}
+    ${info.author ? `<author>${info.author}</author>` : ""}
+    ${info.date ? `<date>${info.date.toISOString().split("T")[0]}</date>` : ""}
+    ${info.purpose ? `<purpose>${info.purpose}</purpose>` : ""}
+    ${info.milestone ? `<milestone>${info.milestone}</milestone>` : ""}
+  </info>
+  <specifications>
     ${[..._specifications].map((spec) => spec.serialize()).join("\n")}
-  </ids:specifications>
-</ids:ids>`;
+  </specifications>
+</ids>`;
     return xml;
   }
 };