@thatopen/components 2.3.11 → 2.4.0-alpha.10

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.3.11";
+    static readonly release = "2.4.0-alpha.1";
     /** {@link Disposable.onDisposed} */
     readonly onDisposed: Event<void>;
     /**

package/dist/core/Raycasters/src/simple-raycaster.d.ts

@@ -35,8 +35,10 @@ export declare class SimpleRaycaster implements Disposable {
      * @param items - the [meshes](https://threejs.org/docs/#api/en/objects/Mesh)
      * to query. If not provided, it will query all the meshes stored in
      * {@link Components.meshes}.
+     * @param position - the screen position to use for raycasting. If not provided,
+     * the last pointer (mouse/touch) position will be used.
      */
-    castRay(items?: THREE.Object3D[]): THREE.Intersection | null;
+    castRay(items?: THREE.Object3D[], position?: THREE.Vector2): THREE.Intersection | null;
     /**
      * Casts a ray from a given origin in a given direction and returns the first item found.
      * This method also takes into account the clipping planes used by the renderer.

package/dist/core/Types/src/async-event.d.ts

@@ -2,6 +2,10 @@
  * Simple event handler by [Jason Kleban](https://gist.github.com/JasonKleban/50cee44960c225ac1993c922563aa540). Keep in mind that if you want to remove it later, you might want to declare the callback as an object. If you want to maintain the reference to `this`, you will need to declare the callback as an arrow function.
  */
 export declare class AsyncEvent<T> {
+    /**
+     * Whether this event is active or not. If not, it won't trigger.
+     */
+    enabled: boolean;
     /**
      * Add a callback to this event instance.
      * @param handler - the callback to be added to this event.

package/dist/core/Types/src/event-manager.d.ts

@@ -0,0 +1,30 @@
+import { Event } from "./event";
+import { AsyncEvent } from "./async-event";
+/**
+ * Simple class to easily toggle and reset event lists.
+ */
+export declare class EventManager {
+    /**
+     * The list of events managed by this instance.
+     */
+    list: Set<Event<any> | AsyncEvent<any>>;
+    /**
+     * Adds events to this manager.
+     * @param events the events to add.
+     */
+    add(events: Iterable<Event<any> | AsyncEvent<any>>): void;
+    /**
+     * Removes events from this manager.
+     * @param events the events to remove.
+     */
+    remove(events: Iterable<Event<any> | AsyncEvent<any>>): void;
+    /**
+     * Sets all the events managed by this instance as enabled or disabled.
+     * @param active whether to turn on or off the events.
+     */
+    set(active: boolean): void;
+    /**
+     * Resets all the events managed by this instance.
+     */
+    reset(): void;
+}

package/dist/core/Types/src/event.d.ts

@@ -2,6 +2,10 @@
  * Simple event handler by [Jason Kleban](https://gist.github.com/JasonKleban/50cee44960c225ac1993c922563aa540). Keep in mind that if you want to remove it later, you might want to declare the callback as an object. If you want to maintain the reference to `this`, you will need to declare the callback as an arrow function.
  */
 export declare class Event<T> {
+    /**
+     * Whether this event is active or not. If not, it won't trigger.
+     */
+    enabled: boolean;
     /**
      * Add a callback to this event instance.
      * @param handler - the callback to be added to this event.

package/dist/core/Types/src/index.d.ts

@@ -12,3 +12,4 @@ export * from "./data-set";
 export * from "./data-map";
 export * from "./component-with-ui";
 export * from "./config-types";
+export * from "./event-manager";

package/dist/core/Types/src/interfaces.d.ts

@@ -1,6 +1,7 @@
 import * as THREE from "three";
 import CameraControls from "camera-controls";
 import { Event } from "./event";
+import { EventManager } from "./event-manager";
 /**
  * Whether this component has to be manually destroyed once you are done with it to prevent [memory leaks](https://threejs.org/docs/#manual/en/introduction/How-to-dispose-of-objects). This also ensures that the DOM events created by that component will be cleaned up.
  */
@@ -105,3 +106,12 @@ export interface CameraControllable {
      */
     controls: CameraControls;
 }
+/**
+ * Whether it has events or not.
+ */
+export interface Eventable {
+    /**
+     * The object in charge of managing all the events.
+     */
+    eventManager: EventManager;
+}

package/dist/fragments/Classifier/index.d.ts

@@ -21,6 +21,15 @@ export interface Classification {
         };
     };
 }
+interface ExportedClassification {
+    [system: string]: {
+        [groupName: string]: {
+            map: string;
+            name: string;
+            id: number | null;
+        };
+    };
+}
 /**
  * The Classifier component is responsible for classifying and categorizing fragments based on various criteria. It provides methods to add, remove, find, and filter fragments based on their classification. 📕 [Tutorial](https://docs.thatopen.com/Tutorials/Components/Core/Classifier). 📘 [API](https://docs.thatopen.com/api/@thatopen/components/classes/Classifier).
  */
@@ -170,5 +179,16 @@ export declare class Classifier extends Component implements Disposable {
      * @throws Will throw an error if the fragment with the specified ID is not found.
      */
     resetColor(items: FRAGS.FragmentIdMap): void;
+    /**
+     * Exports the computed classification to persists them and import them back
+     * later for faster loading.
+     */
+    export(): ExportedClassification;
+    /**
+     * Imports a classification previously exported with .export().
+     * @param data the serialized classification to import.
+     */
+    import(data: ExportedClassification): void;
     protected saveItem(group: FRAGS.FragmentsGroup, systemName: string, className: string, expressID: number, parentID?: number | null): void;
 }
+export {};