@thatopen/components 3.1.6 → 3.2.1

package/dist/index.cjs

@@ -124,6 +124,10 @@ class Base {
     __publicField(this, "isConfigurable", () => {
       return "setup" in this && "config" in this && "onSetup" in this;
     });
+    /** Whether is component is {@link Serializable}. */
+    __publicField(this, "isSerializable", () => {
+      return "import" in this && "export" in this;
+    });
     this.components = components;
   }
 }
@@ -3176,6 +3180,7 @@ const _FragmentsManager = class _FragmentsManager extends Component {
     super(components);
     /** {@link Disposable.onDisposed} */
     __publicField(this, "onDisposed", new Event());
+    __publicField(this, "onBeforeDispose", new Event());
     /**
      * Event triggered when fragments are loaded.
      */
@@ -3184,10 +3189,12 @@ const _FragmentsManager = class _FragmentsManager extends Component {
     __publicField(this, "baseCoordinationMatrix", new THREE__namespace.Matrix4());
     /** {@link Component.enabled} */
     __publicField(this, "enabled", true);
-    __publicField(this, "initialized", false);
     __publicField(this, "_core");
     this.components.add(_FragmentsManager.uuid, this);
   }
+  get initialized() {
+    return !!this._core;
+  }
   /**
    * Map containing all loaded fragment models.
    * The key is the group's unique identifier, and the value is the model itself.
@@ -3201,8 +3208,12 @@ const _FragmentsManager = class _FragmentsManager extends Component {
     }
     return this._core;
   }
+  get _hasCoordinationModel() {
+    return this.baseCoordinationModel !== "";
+  }
   /** {@link Disposable.dispose} */
   dispose() {
+    this.onBeforeDispose.trigger();
     if (this._core) {
       this.core.dispose();
       this._core = void 0;
@@ -3214,12 +3225,14 @@ const _FragmentsManager = class _FragmentsManager extends Component {
   }
   init(workerURL) {
     this._core = new FRAGS.FragmentsModels(workerURL);
-    this.initialized = true;
-    this.core.onModelLoaded.add(async (model) => {
-      if (this.list.size !== 1)
+    this.core.onModelLoaded.add(async () => {
+      if (this._hasCoordinationModel)
         return;
-      this.baseCoordinationModel = model.modelId;
-      this.baseCoordinationMatrix = await model.getCoordinationMatrix();
+      const firstModel = [...this.list.values()][0];
+      if (!firstModel)
+        return;
+      this.baseCoordinationModel = firstModel.modelId;
+      this.baseCoordinationMatrix = await firstModel.getCoordinationMatrix();
     });
     this.list.onItemDeleted.add(() => {
       if (this.list.size > 0)
@@ -3894,7 +3907,7 @@ __publicField(_BoundingBoxer, "uuid", "d1444724-dba6-4cdd-a0c7-68ee1450d166");
 let BoundingBoxer = _BoundingBoxer;
 class FinderQuery {
   constructor(components, queries) {
-    __publicField(this, "description");
+    __publicField(this, "customData", {});
     __publicField(this, "_components");
     __publicField(this, "_queries", []);
     __publicField(this, "_aggregation", "exclusive");
@@ -4017,9 +4030,11 @@ class FinderQuery {
    * @returns A `SerializedFinderQuery` object representing the serialized query.
    */
   toJSON() {
+    const manager = this._components.get(ItemsFinder);
+    const name = manager.list.getKey(this) ?? "Finder Query";
     const result = {
-      name: "Finder Query",
-      description: this.description,
+      name,
+      customData: this.customData,
       queries: this.queries.map(this.serializeQueryParameters),
       aggregation: this.aggregation,
       cache: this.cache
@@ -4051,7 +4066,7 @@ class FinderQuery {
    * @returns A `FinderQuery` instance.
    */
   fromJSON(data) {
-    this.description = data.description;
+    this.customData = data.customData;
     this.aggregation = data.aggregation;
     this.cache = data.cache;
     this.queries = data.queries.map(this.deserializeQueryParameters);
@@ -4151,9 +4166,9 @@ const _ItemsFinder = class _ItemsFinder extends Component {
     if (!data)
       return instances;
     for (const value of data) {
-      const { name, description, queries, aggregation, cache } = value;
+      const { name, customData, queries, aggregation, cache } = value;
       const finderQuery = this.create(name, []);
-      finderQuery.fromJSON({ description, queries, aggregation, cache });
+      finderQuery.fromJSON({ customData, queries, aggregation, cache });
       instances.push(finderQuery);
     }
     return instances;
@@ -15895,21 +15910,6 @@ ${users}
       const viewpoint = new Viewpoint(this.components, bcfViewpoint);
       createdViewpoints.push(viewpoint);
     }
-    const getNameWithoutExtension = (name) => {
-      const partsBySlash = name.split("/");
-      const partsByDot = partsBySlash[partsBySlash.length - 1].split(".");
-      partsByDot.pop();
-      return partsByDot.join(".");
-    };
-    const snapshotFiles = files.filter(
-      (file) => file.name.endsWith(".png") || file.name.endsWith(".jpeg")
-    );
-    for (const file of snapshotFiles) {
-      const name = getNameWithoutExtension(file.name);
-      const buffer = await file.async("arraybuffer");
-      const bytes = new Uint8Array(buffer);
-      viewpoints.snapshots.set(name, bytes);
-    }
     const topicRelations = {};
     const topics = [];
     const markupFiles = files.filter((file) => file.name.endsWith(".bcf"));
@@ -15958,12 +15958,16 @@ ${users}
         if (!(markupViewpoint && markupViewpoint.Guid))
           continue;
         const viewpoint = viewpoints.list.get(markupViewpoint.Guid);
-        if (viewpoint) {
-          topic.viewpoints.add(viewpoint.guid);
-          const snapshotName = getNameWithoutExtension(
-            markupViewpoint.Snapshot
-          );
-          viewpoint.snapshot = snapshotName ?? null;
+        if (!viewpoint)
+          continue;
+        topic.viewpoints.add(viewpoint.guid);
+        const snapshotName = `${topic.guid}/${markupViewpoint.Snapshot}`;
+        const snapshotFile = files.find(({ name }) => name === snapshotName);
+        if (snapshotFile) {
+          const buffer = await snapshotFile.async("arraybuffer");
+          const bytes = new Uint8Array(buffer);
+          viewpoints.snapshots.set(viewpoint.guid, bytes);
+          viewpoint.snapshot = viewpoint.guid ?? null;
         }
       }
       const markupDocReferences = this.getMarkupDocumentReferences(
@@ -18496,21 +18500,21 @@ ${colorTags}
     </CameraUpVector>`;
     const cameraRatioXML = `<AspectRatio>${this.camera.aspect_ratio}</AspectRatio>`;
     let cameraXML = "";
-    if ("viewToWorld" in this.camera) {
+    if ("view_to_world_scale" in this.camera) {
       cameraXML = `<OrthogonalCamera>
         ${cameraViewpointXML}
         ${cameraDirectionXML}
         ${cameraUpVectorXML}
         ${cameraRatioXML}
-        <ViewToWorldScale>${this.camera.viewToWorld}</ViewToWorldScale>
+        <ViewToWorldScale>${this.camera.view_to_world_scale}</ViewToWorldScale>
       </OrthogonalCamera>`;
-    } else if ("fov" in this.camera) {
+    } else if ("field_of_view" in this.camera) {
       cameraXML = `<PerspectiveCamera>
         ${cameraViewpointXML}
         ${cameraDirectionXML}
         ${cameraUpVectorXML}
         ${cameraRatioXML}
-        <FieldOfView>${this.camera.fov}</FieldOfView>
+        <FieldOfView>${this.camera.field_of_view}</FieldOfView>
       </PerspectiveCamera>`;
     }
     const viewSetupHints = `<ViewSetupHints SpacesVisible="${this.spacesVisible ?? false}" SpaceBoundariesVisible="${this.spaceBoundariesVisible ?? false}" OpeningsVisible="${this.openingsVisible ?? false}" />`;
@@ -20796,7 +20800,7 @@ class IDSSpecification {
     return xml;
   }
 }
-const getParameterValue = (property) => {
+const getParameterValue = (property, parseNumericString = true) => {
   if (!property)
     return void 0;
   const result = {};
@@ -20814,7 +20818,7 @@ const getParameterValue = (property) => {
     if ("enumeration" in restriction) {
       result.type = "enumeration";
       const enumeration = restriction.enumeration.map(
-        ({ value }) => value
+        ({ value }) => parseNumericString ? value : String(value)
       );
       result.parameter = enumeration;
     }
@@ -20908,19 +20912,19 @@ const createMaterialFacets = (components, elements) => {
   }
   return facets;
 };
-const createPropertyFacets = (components, elements) => {
+const createPropertyFacets = (components, elements, parseNumericString) => {
   const facets = [];
   for (const element of elements) {
     const psetParameter = element.propertySet;
     const baseNameParameter = element.baseName;
-    const pset = getParameterValue(psetParameter);
-    const baseName = getParameterValue(baseNameParameter);
+    const pset = getParameterValue(psetParameter, parseNumericString);
+    const baseName = getParameterValue(baseNameParameter, parseNumericString);
     if (!(baseName && pset))
       continue;
     const facet = new IDSProperty(components, pset, baseName);
     if (element.cardinality)
       facet.cardinality = element.cardinality;
-    const value = getParameterValue(element.value);
+    const value = getParameterValue(element.value, parseNumericString);
     facet.value = value;
     facet.dataType = element.dataType;
     facet.uri = element.uri;
@@ -21030,7 +21034,7 @@ const _IDSSpecifications = class _IDSSpecifications extends Component {
    *
    * @returns An array of IDSSpecification instances created from the parsed data.
    */
-  load(data) {
+  load(data, config = { parseNumericString: true }) {
     const result = [];
     const ids = _IDSSpecifications.xmlParser.parse(data).ids;
     const { specifications } = ids;
@@ -21069,7 +21073,11 @@ const _IDSSpecifications = class _IDSSpecifications extends Component {
                 applicabilities.push(...facets2);
               }
               if (facetName === "property") {
-                const facets2 = createPropertyFacets(this.components, elements);
+                const facets2 = createPropertyFacets(
+                  this.components,
+                  elements,
+                  config.parseNumericString
+                );
                 applicabilities.push(...facets2);
               }
               if (facetName === "partOf") {
@@ -21107,7 +21115,11 @@ const _IDSSpecifications = class _IDSSpecifications extends Component {
                 reqs.push(...facets2);
               }
               if (facetName === "property") {
-                const facets2 = createPropertyFacets(this.components, elements);
+                const facets2 = createPropertyFacets(
+                  this.components,
+                  elements,
+                  config.parseNumericString
+                );
                 reqs.push(...facets2);
               }
               if (facetName === "partOf") {

package/dist/index.d.ts

@@ -80,6 +80,8 @@ export declare abstract class Base {
     isHideable: () => this is Hideable;
     /** Whether is component is {@link Configurable}. */
     isConfigurable: () => this is Configurable<any, any>;
+    /** Whether is component is {@link Serializable}. */
+    isSerializable: () => this is Serializable<any, Record<string, any>>;
 }
 
 /**
@@ -1633,7 +1635,7 @@ export declare interface ExternalDocumentReference extends DocumentReference {
  * Represents a finder query for retrieving items based on specified parameters. This class encapsulates the query logic, caching mechanism, and result management.
  */
 export declare class FinderQuery {
-    description?: string;
+    customData: Record<string, any>;
     private _components;
     private _queries;
     /**
@@ -1715,7 +1717,8 @@ export declare class FragmentsManager extends Component implements Disposable_2
      */
     static readonly uuid: "fef46874-46a3-461b-8c44-2922ab77c806";
     /** {@link Disposable.onDisposed} */
-    readonly onDisposed: Event_2<unknown>;
+    readonly onDisposed: Event_2<undefined>;
+    readonly onBeforeDispose: Event_2<undefined>;
     /**
      * Event triggered when fragments are loaded.
      */
@@ -1724,7 +1727,7 @@ export declare class FragmentsManager extends Component implements Disposable_2
     baseCoordinationMatrix: THREE.Matrix4;
     /** {@link Component.enabled} */
     enabled: boolean;
-    initialized: boolean;
+    get initialized(): boolean;
     private _core?;
     /**
      * Map containing all loaded fragment models.
@@ -1732,6 +1735,7 @@ export declare class FragmentsManager extends Component implements Disposable_2
      */
     get list(): FRAGS.DataMap<string, FRAGS.FragmentsModel>;
     get core(): FRAGS.FragmentsModels;
+    private get _hasCoordinationModel();
     constructor(components: Components);
     /** {@link Disposable.dispose} */
     dispose(): void;
@@ -2181,7 +2185,9 @@ export declare class IDSSpecifications extends Component {
      *
      * @returns An array of IDSSpecification instances created from the parsed data.
      */
-    load(data: string): IDSSpecification[];
+    load(data: string, config?: {
+        parseNumericString: boolean;
+    }): IDSSpecification[];
     /**
      * Exports the IDSSpecifications data into an XML string.
      *
@@ -2868,9 +2874,9 @@ export declare interface SerializedFinderQuery {
      */
     name: string;
     /**
-     * An optional description of the query.
+     * An object to define custom data.
      */
-    description?: string;
+    customData: Record<string, any>;
     /**
      * An array of serialized query parameters.
      */
@@ -4052,7 +4058,7 @@ export declare class Viewpoint {
 }
 
 /**
- * Represents a bitmap image associated with a viewpoint. This interface is compliant with the BCF API specifications.
+ *  Represents a bitmap image associated with a viewpoint. This interface is compliant with the BCF API specifications.
  */
 export declare interface ViewpointBitmap {
     /**