@thatopen/components 3.3.2 → 3.3.3

package/dist/index.d.ts

@@ -843,9 +843,9 @@ export declare class Clipper extends Component implements Createable, Disposable
     /** {@link Configurable.onSetup} */
     readonly onSetup: Event_2<unknown>;
     /** Event that fires when the user starts dragging a clipping plane. */
-    readonly onBeforeDrag: Event_2<void>;
+    readonly onBeforeDrag: Event_2<SimplePlane>;
     /** Event that fires when the user stops dragging a clipping plane. */
-    readonly onAfterDrag: Event_2<void>;
+    readonly onAfterDrag: Event_2<SimplePlane>;
     /**
      * Event that fires when the user starts creating a clipping plane.
      */
@@ -889,6 +889,12 @@ export declare class Clipper extends Component implements Createable, Disposable
      * has to be `true` for this to apply.
      */
     toleranceOrthogonalY: number;
+    /**
+     * Whether clipping planes should automatically scale based on
+     * camera distance. When true, the plane surface stays proportional
+     * to the arrow gizmo as you zoom in/out. Default is true.
+     */
+    autoScalePlanes: boolean;
     /**
      * The type of clipping plane to be created.
      * Default is {@link SimplePlane}.
@@ -962,8 +968,6 @@ export declare class Clipper extends Component implements Createable, Disposable
     private normalizePlaneDirectionY;
     private newPlane;
     private updateMaterialsAndPlanes;
-    private _onStartDragging;
-    private _onEndDragging;
 }
 
 /**
@@ -2454,6 +2458,26 @@ export declare class IfcLoader extends Component implements Disposable_2 {
     /**
      * Loads an IFC file and processes it for 3D visualization.
      *
+     * By default, the loader imports a minimal set of attributes and relations
+     * needed for typical visualization workflows.
+     *
+     * **Default attributes**
+     * - Base entities: Project, Site, Building, BuildingStorey
+     * - Materials: IFC material definitions and layers
+     * - Properties: Property Sets, quantities (area, volume, length, etc.)
+     *
+     * **Default relations**
+     * - DefinesByProperties (IsDefinedBy / DefinesOccurrence)
+     * - AssociatesMaterial (HasAssociations / AssociatedTo)
+     * - Aggregates (IsDecomposedBy / Decomposes)
+     * - ContainedInSpatialStructure (ContainsElements / ContainedInStructure)
+     *
+     * If you need *all* attributes or relations to be loaded, you can enable them
+     * via the `instanceCallback`.
+     *
+     * The callback provides direct access to the underlying `IfcImporter`,
+     * allowing advanced configuration before processing begins.
+     *
      * @param data - The Uint8Array containing the IFC file data.
      * @param coordinate - Boolean indicating whether to coordinate the loaded IFC data. Default is true.
      * @param name - Name for the fragments model.
@@ -2462,6 +2486,17 @@ export declare class IfcLoader extends Component implements Disposable_2 {
      * @returns A Promise that resolves to the FragmentsModel containing the loaded and processed IFC data.
      *
      * @example
+     * // Load all attributes and relations using the instanceCallback
+     * ```ts
+     * const model = await ifcLoader.load(ifcData, true, "modelName", {
+     *   instanceCallback: (importer) => {
+     *     importer.addAllAttributes();
+     *     importer.addAllRelations();
+     *   },
+     * });
+     * ```
+     * @example
+     * // Default loading (built-in attributes and relations only)
      * ```typescript
      * const ifcLoader = components.get(IfcLoader);
      * const model = await ifcLoader.load(ifcData);
@@ -3216,6 +3251,7 @@ export declare class SimpleCamera extends BaseCamera implements Updateable, Disp
      * This camera is used for rendering the scene.
      */
     three: THREE.PerspectiveCamera | THREE.OrthographicCamera;
+    protected _resizeObserver: ResizeObserver | null;
     private _allControls;
     /**
      * The object that controls the camera. An instance of
@@ -3422,6 +3458,10 @@ export declare class SimplePlane implements Disposable_2, Hideable {
     private readonly _planeMesh;
     private readonly _controls;
     private readonly _hiddenMaterial;
+    private _sizeMultiplier;
+    private _autoScale;
+    get autoScale(): boolean;
+    set autoScale(value: boolean);
     /**
      * Getter for the enabled state of the clipping plane.
      * @returns {boolean} The current enabled state.
@@ -3478,6 +3518,7 @@ export declare class SimplePlane implements Disposable_2, Hideable {
     setFromNormalAndCoplanarPoint(normal: THREE.Vector3, point: THREE.Vector3): void;
     /** {@link Updateable.update} */
     update: () => void;
+    private updateScale;
     /** {@link Disposable.dispose} */
     dispose(): void;
     private reset;