vim-web 0.3.44-dev.9 → 0.4.0

package/dist/types/core-viewers/webgl/viewer/camera/cameraMovement.d.ts

@@ -2,8 +2,8 @@
  * @module viw-webgl-viewer/camera
  */
 import { Camera } from './camera';
-import { Object3D } from '../../loader/object3D';
-import { SelectableObject } from '../selection';
+import { Element3D } from '../../loader/element3d';
+import { Selectable } from '../selection';
 import * as THREE from 'three';
 import { Vim } from '../../loader/vim';
 export declare abstract class CameraMovement {
@@ -53,9 +53,9 @@ export declare abstract class CameraMovement {
     orbitTowards(direction: THREE.Vector3): void;
     /**
      * Rotates the camera without moving so that it looks at the specified target.
-     * @param {Object3D | THREE.Vector3} target - The target object or position to look at.
+     * @param {Element3D | THREE.Vector3} target - The target object or position to look at.
      */
-    abstract target(target: Object3D | THREE.Vector3): void;
+    abstract target(target: Element3D | THREE.Vector3): void;
     /**
      * Resets the camera to its last saved position and orientation.
      */
@@ -71,7 +71,7 @@ export declare abstract class CameraMovement {
      * @param {IObject | Vim | THREE.Sphere | THREE.Box3 | 'all' | undefined} target - The target object, or 'all' to frame all objects.
      * @param {THREE.Vector3} [forward] - Optional forward direction after framing.
      */
-    frame(target: SelectableObject | Vim | THREE.Sphere | THREE.Box3 | 'all' | undefined, forward?: THREE.Vector3): void;
+    frame(target: Selectable | Vim | THREE.Sphere | THREE.Box3 | 'all' | undefined, forward?: THREE.Vector3): Promise<void>;
     protected frameSphere(sphere: THREE.Sphere, forward?: THREE.Vector3): void;
     private getNormalizedDirection;
 }

package/dist/types/core-viewers/webgl/viewer/camera/cameraMovementLerp.d.ts

@@ -3,7 +3,7 @@
  */
 import * as THREE from 'three';
 import { Camera } from './camera';
-import { Object3D } from '../../loader/object3D';
+import { Element3D } from '../../loader/element3d';
 import { CameraMovementSnap } from './cameraMovementSnap';
 import { CameraMovement } from './cameraMovement';
 export declare class CameraLerp extends CameraMovement {
@@ -22,7 +22,7 @@ export declare class CameraLerp extends CameraMovement {
     zoom(amount: number): void;
     setDistance(dist: number): void;
     orbit(angle: THREE.Vector2): void;
-    target(target: Object3D | THREE.Vector3): void;
+    target(target: Element3D | THREE.Vector3): Promise<void>;
     reset(): void;
     set(position: THREE.Vector3, target?: THREE.Vector3): void;
 }

package/dist/types/core-viewers/webgl/viewer/camera/cameraMovementSnap.d.ts

@@ -2,7 +2,7 @@
  * @module viw-webgl-viewer/camera
  */
 import { CameraMovement } from './cameraMovement';
-import { Object3D } from '../../loader/object3D';
+import { Element3D } from '../../loader/element3d';
 import * as THREE from 'three';
 export declare class CameraMovementSnap extends CameraMovement {
     /**
@@ -14,7 +14,7 @@ export declare class CameraMovementSnap extends CameraMovement {
     setDistance(dist: number): void;
     rotate(angle: THREE.Vector2): void;
     applyRotation(quaternion: THREE.Quaternion): void;
-    target(target: Object3D | THREE.Vector3): void;
+    target(target: Element3D | THREE.Vector3): Promise<void>;
     orbit(angle: THREE.Vector2): void;
     move3(vector: THREE.Vector3): void;
     set(position: THREE.Vector3, target?: THREE.Vector3): void;

package/dist/types/core-viewers/webgl/viewer/camera/{orthographic.d.ts → cameraOrthographic.d.ts}

@@ -3,7 +3,7 @@
  */
 import * as THREE from 'three';
 import { ViewerSettings } from '../settings/viewerSettings';
-export declare class OrthographicWrapper {
+export declare class OrthographicCamera {
     camera: THREE.OrthographicCamera;
     constructor(camera: THREE.OrthographicCamera);
     frustrumSizeAt(point: THREE.Vector3): THREE.Vector2;

package/dist/types/core-viewers/webgl/viewer/camera/{perspective.d.ts → cameraPerspective.d.ts}

@@ -3,7 +3,7 @@
  */
 import * as THREE from 'three';
 import { ViewerSettings } from '../settings/viewerSettings';
-export declare class PerspectiveWrapper {
+export declare class PerspectiveCamera {
     camera: THREE.PerspectiveCamera;
     constructor(camera: THREE.PerspectiveCamera);
     applySettings(settings: ViewerSettings): void;

package/dist/types/core-viewers/webgl/viewer/camera/index.d.ts

@@ -0,0 +1,7 @@
+export type * from './camera';
+export type * from './cameraInterface';
+export type * from './cameraMovement';
+export type * from './cameraMovementLerp';
+export type * from './cameraMovementSnap';
+export type * from './cameraOrthographic';
+export type * from './cameraPerspective';

package/dist/types/core-viewers/webgl/viewer/environment/environment.d.ts

@@ -3,11 +3,11 @@
  */
 import * as THREE from 'three';
 import { ViewerSettings } from '../settings/viewerSettings';
-import { ICamera } from '../camera/ICamera';
-import { ViewerMaterials } from '../../loader/materials/viewerMaterials';
+import { ICamera } from '../camera/cameraInterface';
+import { Materials } from '../../loader/materials/materials';
 import { Skybox } from './skybox';
 import { Renderer } from '../rendering/renderer';
-import { CameraLight } from './cameraLight';
+import { Light } from './light';
 /**
  * Manages ground plane and lights that are part of the THREE.Scene to render but not part of the Vims.
  */
@@ -21,9 +21,9 @@ export declare class Environment {
     /**
      * The array of directional lights in the scene.
      */
-    readonly sunLights: ReadonlyArray<CameraLight>;
+    readonly sunLights: ReadonlyArray<Light>;
     readonly skybox: Skybox;
-    constructor(camera: ICamera, renderer: Renderer, viewerMaterials: ViewerMaterials, settings: ViewerSettings);
+    constructor(camera: ICamera, renderer: Renderer, materials: Materials, settings: ViewerSettings);
     /**
      * Returns all three objects composing the environment
      */

package/dist/types/core-viewers/webgl/viewer/environment/index.d.ts

@@ -0,0 +1,3 @@
+export type * from './environment';
+export type * from './light';
+export type * from './skybox';

package/dist/types/core-viewers/webgl/viewer/environment/{cameraLight.d.ts → light.d.ts}

@@ -2,8 +2,8 @@
  * @module viw-webgl-viewer
  */
 import * as THREE from 'three';
-import { ICamera } from '../camera/ICamera';
-export declare class CameraLight {
+import { ICamera } from '../camera/cameraInterface';
+export declare class Light {
     readonly light: THREE.DirectionalLight;
     private readonly _camera;
     private _unsubscribe;

package/dist/types/core-viewers/webgl/viewer/environment/skybox.d.ts

@@ -3,8 +3,8 @@
  */
 import * as THREE from 'three';
 import { ViewerSettings } from '../settings/viewerSettings';
-import { ICamera } from '../camera/ICamera';
-import { ViewerMaterials } from '../../loader/materials/viewerMaterials';
+import { ICamera } from '../camera/cameraInterface';
+import { Materials } from '../../loader/materials/materials';
 import { Renderer } from '../rendering/renderer';
 export declare class Skybox {
     readonly mesh: THREE.Mesh;
@@ -34,6 +34,6 @@ export declare class Skybox {
     private readonly _plane;
     private readonly _material;
     private readonly _renderer;
-    constructor(camera: ICamera, renderer: Renderer, materials: ViewerMaterials, settings: ViewerSettings);
+    constructor(camera: ICamera, renderer: Renderer, materials: Materials, settings: ViewerSettings);
     dispose(): void;
 }

package/dist/types/core-viewers/webgl/viewer/gizmos/axes/axesSettings.d.ts

@@ -1,4 +1,4 @@
-export declare class AxesSettings {
+export interface AxesSettings {
     size: number;
     padding: number;
     bubbleSizePrimary: number;
@@ -15,5 +15,6 @@ export declare class AxesSettings {
     colorXSub: string;
     colorYSub: string;
     colorZSub: string;
-    constructor(init?: Partial<AxesSettings>);
 }
+export declare function getDefaultAxesSettings(): AxesSettings;
+export declare function createAxesSettings(init?: Partial<AxesSettings>): AxesSettings;

package/dist/types/core-viewers/webgl/viewer/gizmos/axes/gizmoAxes.d.ts

@@ -1,7 +1,7 @@
 /**
  * @module viw-webgl-viewer/gizmos
  */
-import { Camera } from '../../camera/camera';
+import { Camera } from '../../camera';
 import { Viewport } from '../../viewport';
 import { AxesSettings } from './axesSettings';
 /**
@@ -15,7 +15,9 @@ export declare class GizmoAxes {
     private _context;
     private _rect;
     private _reparentConnection;
+    private _resizeConnection;
     private _axes;
+    private _resized;
     private _pointerInside;
     private _isDragging;
     private _isDragSignificant;

package/dist/types/core-viewers/webgl/viewer/gizmos/axes/index.d.ts

@@ -0,0 +1,3 @@
+export * from './axes';
+export * from './axesSettings';
+export * from './gizmoAxes';

package/dist/types/core-viewers/webgl/viewer/gizmos/gizmoOrbit.d.ts

@@ -5,7 +5,7 @@ import * as THREE from 'three';
 import { Renderer } from '../rendering/renderer';
 import { Camera } from '../camera/camera';
 import { ViewerSettings } from '../settings/viewerSettings';
-import { Input } from '../inputs/input';
+import { type InputHandler } from '../../../shared';
 /**
  * Manages the camera target gizmo
  */
@@ -27,7 +27,7 @@ export declare class GizmoOrbit {
     private _timeout;
     private _active;
     private _animation;
-    constructor(renderer: Renderer, camera: Camera, input: Input, settings: ViewerSettings);
+    constructor(renderer: Renderer, camera: Camera, input: InputHandler, settings: ViewerSettings);
     private connect;
     private onUpdate;
     /**

package/dist/types/core-viewers/webgl/viewer/gizmos/gizmos.d.ts

@@ -2,7 +2,6 @@ import { Viewer } from '../viewer';
 import { GizmoAxes } from './axes/gizmoAxes';
 import { GizmoLoading } from './gizmoLoading';
 import { GizmoOrbit } from './gizmoOrbit';
-import { GizmoRectangle } from './gizmoRectangle';
 import { IMeasure } from './measure/measure';
 import { SectionBox } from './sectionBox/sectionBox';
 import { GizmoMarkers } from './markers/gizmoMarkers';
@@ -29,10 +28,6 @@ export declare class Gizmos {
      * The camera orbit target gizmo.
      */
     readonly orbit: GizmoOrbit;
-    /**
-     * Rectangle Gizmo used for rectangle selection.
-     */
-    readonly rectangle: GizmoRectangle;
     /**
      * The axis gizmos of the viewer.
      */

package/dist/types/core-viewers/webgl/viewer/gizmos/index.d.ts

@@ -0,0 +1,7 @@
+export * from './gizmos';
+export * from './gizmoLoading';
+export type * from './gizmoOrbit';
+export type * from './axes';
+export type * from './markers';
+export type * from './measure';
+export type * from './sectionBox';

package/dist/types/core-viewers/webgl/viewer/gizmos/markers/gizmoMarker.d.ts

@@ -2,63 +2,111 @@ import { Vim } from '../../../loader/vim';
 import { Viewer } from '../../viewer';
 import * as THREE from 'three';
 import { SimpleInstanceSubmesh } from '../../../loader/mesh';
+import { IVimElement } from '../../../../shared/vim';
 /**
- * Marker gizmo that display an interactive sphere at a 3D positions
+ * Marker gizmo that displays an interactive sphere at a 3D position.
  * Marker gizmos are still under development.
  */
-export declare class GizmoMarker {
+export declare class Marker implements IVimElement {
     readonly type = "Marker";
     private _viewer;
     private _submesh;
+    private static _tmpMatrix;
+    private static _unitVector;
     /**
-     * The vim object from which this object came from.
+     * The Vim object from which this object came.
+     * Can be undefined if the object is not part of a Vim.
      */
     vim: Vim | undefined;
     /**
-     * The bim element index associated with this object.
+     * The BIM element index associated with this object.
+     * Can be undefined if the object is not part of a Vim.
      */
     element: number | undefined;
     /**
-     * The geometry instances  associated with this object.
+     * The geometry instances associated with this object.
+     * This is used when the marker is derived from multiple instances.
      */
     instances: number[] | undefined;
+    /**
+     * The index of the marker in the marker collection.
+     */
+    get index(): number;
     private _outlineAttribute;
     private _visibleAttribute;
     private _coloredAttribute;
     private _focusedAttribute;
     private _colorAttribute;
+    /**
+     * Constructs a new Marker object.
+     * @param viewer - The viewer managing rendering and interaction.
+     * @param submesh - The instanced submesh this marker is bound to.
+     */
     constructor(viewer: Viewer, submesh: SimpleInstanceSubmesh);
+    /**
+     * Updates the underlying submesh and rebinds all attributes to the new mesh.
+     * @param mesh - The new submesh to bind to this marker.
+     */
     updateMesh(mesh: SimpleInstanceSubmesh): void;
-    /** Sets the position of the marker in the 3d scene */
+    /**
+     * Sets the world position of the marker.
+     */
     set position(value: THREE.Vector3);
+    /**
+     * Gets the world position of the marker.
+     */
     get position(): THREE.Vector3;
     /**
-     * Always false
+     * Always false; marker is a gizmo and not an actual mesh.
      */
     get hasMesh(): boolean;
     /**
-     * Applies a color override instead of outlines.
+     * Gets whether the marker is outlined (highlighted).
      */
     get outline(): boolean;
+    /**
+     * Sets whether the marker is outlined (highlighted).
+     */
     set outline(value: boolean);
     /**
-     * Enlarges the gizmo to indicate focus.
+     * Gets whether the marker is focused (enlarged).
      */
     get focused(): boolean;
+    /**
+     * Sets whether the marker is focused (enlarged).
+     */
     set focused(value: boolean);
     /**
-     * Determines if the gizmo will be rendered.
+     * Gets whether the marker is visible in the scene.
      */
     get visible(): boolean;
+    /**
+     * Sets whether the marker is visible in the scene.
+     */
     set visible(value: boolean);
+    /**
+     * Gets the current color override for the marker.
+     */
     get color(): THREE.Color;
-    set color(color: THREE.Color);
+    /**
+     * Sets the color override for the marker.
+     * Passing undefined disables the override.
+     */
+    set color(color: THREE.Color | undefined);
+    /**
+     * Gets the uniform scale factor applied to the marker.
+     */
     get size(): number;
+    /**
+     * Sets the uniform scale factor for the marker.
+     * Only updates the matrix if the size has changed.
+     */
     set size(value: number);
     /**
-     * Retrieves the bounding box of the object from cache or computes it if needed.
-     * Returns a unit box arount the marker position.
-     * @returns {THREE.Box3 | undefined} The bounding box of the object.
+     * Retrieves the bounding box of the object.
+     * Returns a unit-sized box centered at the marker position.
+     * Returned as a promise to satisfy interface, but computed synchronously.
+     * @returns The bounding box of the marker.
      */
-    getBoundingBox(): THREE.Box3;
+    getBoundingBox(): Promise<THREE.Box3>;
 }

package/dist/types/core-viewers/webgl/viewer/gizmos/markers/gizmoMarkers.d.ts

@@ -1,29 +1,52 @@
 import { Viewer } from '../../viewer';
 import * as THREE from 'three';
-import { GizmoMarker } from './gizmoMarker';
+import { Marker } from './gizmoMarker';
 /**
  * API for adding and managing sprite markers in the scene.
+ * Uses THREE.InstancedMesh for performance.
  */
 export declare class GizmoMarkers {
     private _viewer;
     private _markers;
     private _mesh;
+    private _reusableMatrix;
+    /**
+     * Constructs the marker manager and sets up an initial instanced mesh.
+     * @param viewer - The rendering context this marker system belongs to.
+     */
     constructor(viewer: Viewer);
-    getMarkerFromIndex(index: number): GizmoMarker;
+    /**
+     * Returns the marker at the given index.
+     * @param index - The marker index.
+     * @returns The Marker instance or undefined.
+     */
+    getMarkerFromIndex(index: number): Marker | undefined;
+    /**
+     * Creates a new instanced mesh with given capacity, optionally reusing geometry/material.
+     * @param previous - Optional mesh to reuse properties from.
+     * @param capacity - Number of instances the mesh should support.
+     * @returns A new THREE.InstancedMesh.
+     */
     private createMesh;
+    /**
+     * Doubles the mesh capacity and copies over all instance data and marker bindings.
+     */
     private resizeMesh;
     /**
      * Adds a sprite marker at the specified position.
-     * @param {THREE.Vector3} position - The position at which to add the marker.
+     * Resizes mesh if capacity is reached.
+     * @param position - The world position to add the marker at.
+     * @returns The newly created Marker.
      */
-    add(position: THREE.Vector3): GizmoMarker;
+    add(position: THREE.Vector3): Marker;
     /**
      * Removes the specified marker from the scene.
-     * @param {GizmoMarker} marker - The marker to remove.
+     * Uses swap-and-pop to maintain dense storage.
+     * @param marker - The marker to remove.
      */
-    remove(marker: GizmoMarker): void;
+    remove(marker: Marker): void;
     /**
-     * Removes all markers from the scene.
+     * Removes all markers from the scene and resets mesh count.
      */
     clear(): void;
 }

package/dist/types/core-viewers/webgl/viewer/gizmos/markers/index.d.ts

@@ -0,0 +1,2 @@
+export * from './gizmoMarker';
+export * from './gizmoMarkers';

package/dist/types/core-viewers/webgl/viewer/gizmos/measure/index.d.ts

@@ -0,0 +1,3 @@
+export * from './measure';
+export * from './measureGizmo';
+export * from './measureHtml';

package/dist/types/core-viewers/webgl/viewer/gizmos/measure/measure.d.ts

@@ -2,9 +2,8 @@
  * @module viw-webgl-viewer/gizmos/measure
  */
 import * as THREE from 'three';
-import { InputAction } from '../../raycaster';
+import { IRaycastResult } from '../../raycaster';
 import { Viewer } from '../../viewer';
-import { MeasureStage } from './measureFlow';
 /**
  * Interacts with the measure tool.
  */
@@ -31,7 +30,7 @@ export interface IMeasure {
      * Promise is resolved if flow is succesfully completed, rejected otherwise.
      * Do not override viewer.onMouseClick while this flow is active.
      */
-    start(onProgress?: () => void): Promise<void>;
+    start(): Promise<void>;
     /**
      * Aborts the current measure flow, fails the related promise.
      */
@@ -41,6 +40,7 @@ export interface IMeasure {
      */
     clear(): void;
 }
+export type MeasureStage = 'ready' | 'active' | 'done' | 'failed';
 /**
  * Manages measure flow and gizmos
  */
@@ -50,8 +50,9 @@ export declare class Measure implements IMeasure {
     private _startPos;
     private _endPos;
     private _measurement;
-    private _flow;
-    private _previousScheme;
+    private _previousOnClick;
+    private _promise;
+    private _stage;
     /**
      * Start point of the current measure or undefined if no active measure.
      */
@@ -75,23 +76,16 @@ export declare class Measure implements IMeasure {
      * Promise is resolved if flow is succesfully completed, rejected otherwise.
      * Do not override viewer.onMouseClick while this flow is active.
      */
-    start(onProgress?: () => void): Promise<void>;
+    start(): Promise<void>;
+    private onClick;
     /**
      * Should be private.
      */
-    onFirstClick(action: InputAction): void;
+    onFirstClick(hit: IRaycastResult): void;
     /**
      * Should be private.
      */
-    onMouseMove(): void;
-    /**
-     * Should be private.
-     */
-    onMouseIdle(action: InputAction): void;
-    /**
-     * Should be private.
-     */
-    onSecondClick(action: InputAction): boolean;
+    onSecondClick(hit: IRaycastResult): boolean;
     /**
      * Aborts the current measure flow, fails the related promise.
      */

package/dist/types/core-viewers/webgl/viewer/gizmos/sectionBox/index.d.ts

@@ -0,0 +1,7 @@
+export * from './sectionBox';
+export * from './sectionBoxGizmo';
+export * from './sectionBoxHandle';
+export * from './sectionBoxHandles';
+export * from './sectionBoxInputs';
+export * from './SectionBoxMesh';
+export * from './sectionBoxOutline';

package/dist/types/core-viewers/webgl/viewer/gizmos/sectionBox/sectionBox.d.ts

@@ -57,11 +57,10 @@ export declare class SectionBox {
      */
     constructor(viewer: Viewer);
     /**
-     * The shared bounding box that defines the section region.
-     *
-     * To programmatically update the box, see {@link fitBox}.
+     * Returns a copy of the current section box.
+     * To programmatically update the box, see {@link setBox}.
      */
-    get box(): THREE.Box3;
+    getBox(): THREE.Box3;
     /**
      * Determines whether the section gizmo applies clipping planes to the model.
      *
@@ -88,7 +87,7 @@ export declare class SectionBox {
      * @param box - The bounding box to match (required).
      * @param padding - The scalar amount by which to expand the bounding box. Default is `1`.
      */
-    fitBox(box: THREE.Box3): void;
+    setBox(box: THREE.Box3): void;
     /**
      * Updates the section box to match the current size of `this.section.box`.
      *

package/dist/types/core-viewers/webgl/viewer/gizmos/sectionBox/sectionBoxGizmo.d.ts

@@ -3,7 +3,7 @@ import { SectionBoxMesh } from './SectionBoxMesh';
 import { SectionBoxOutline } from './sectionBoxOutline';
 import { SectionBoxHandles } from './sectionBoxHandles';
 import { Renderer } from '../../rendering/renderer';
-import { ICamera } from '../../camera/camera';
+import { ICamera } from '../../camera';
 export declare class SectionBoxGizmo {
     private _renderer;
     readonly cube: SectionBoxMesh;

package/dist/types/core-viewers/webgl/viewer/gizmos/sectionBox/sectionBoxHandle.d.ts

@@ -1,16 +1,18 @@
 import * as THREE from 'three';
-import { ICamera } from '../../camera/camera';
-export type Axis = 'x' | 'y' | 'z';
+import { ICamera } from '../../camera';
+export type AxisName = 'x' | 'y' | 'z';
 export declare class SectionBoxHandle extends THREE.Mesh {
-    readonly axis: Axis;
+    readonly axis: AxisName;
     readonly sign: number;
     private _forward;
     private _color;
     private _highlightColor;
     private _materials;
+    private _camera;
     private _camSub;
-    constructor(axes: Axis, sign: number, size: number, color?: THREE.Color);
+    constructor(axes: AxisName, sign: number, size: number, color?: THREE.Color);
     trackCamera(camera: ICamera): void;
+    update(): void;
     setPosition(position: THREE.Vector3): void;
     get forward(): THREE.Vector3;
     highlight(value: boolean): void;

package/dist/types/core-viewers/webgl/viewer/gizmos/sectionBox/sectionBoxHandles.d.ts

@@ -3,7 +3,7 @@
  */
 import * as THREE from 'three';
 import { SectionBoxHandle } from './sectionBoxHandle';
-import { ICamera } from '../../camera/camera';
+import { ICamera } from '../../camera';
 export declare class SectionBoxHandles {
     readonly up: SectionBoxHandle;
     readonly down: SectionBoxHandle;