vim-web 0.3.44-dev.8 → 0.3.44-dev.80

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

@@ -2,125 +2,26 @@
  * @module viw-webgl-viewer/camera
  */
 import * as THREE from 'three';
-import { Viewport } from '../viewport';
-import { ViewerSettings } from '../settings/viewerSettings';
-import { RenderScene } from '../rendering/renderScene';
 import { ISignal } from 'ste-signals';
-import { PerspectiveWrapper } from './perspective';
-import { OrthographicWrapper } from './orthographic';
+import { RenderScene } from '../rendering/renderScene';
+import { ViewerSettings } from '../settings/viewerSettings';
+import { Viewport } from '../viewport';
+import { ICamera } from './cameraInterface';
 import { CameraMovement } from './cameraMovement';
-/**
- * Interface representing a camera with various properties and methods for controlling its behavior.
- */
-export interface ICamera {
-    /**
-     * A signal that is dispatched when camera settings change.
-     */
-    onSettingsChanged: ISignal;
-    /**
-     * A signal that is dispatched when camera moves.
-     */
-    onMoved: ISignal;
-    /**
-     * True if the camera has moved this frame.
-     */
-    get hasMoved(): boolean;
-    /**
-     * Represents allowed movement along each axis using a Vector3 object.
-     * Each component of the Vector3 should be either 0 or 1 to enable/disable movement along the corresponding axis.
-     */
-    allowedMovement: THREE.Vector3;
-    /**
-     * Represents allowed rotation using a Vector2 object.
-     * Each component of the Vector2 should be either 0 or 1 to enable/disable rotation around the corresponding axis.
-     */
-    allowedRotation: THREE.Vector2;
-    /**
-     * The default forward direction that can be used to initialize the camera.
-     */
-    defaultForward: THREE.Vector3;
-    /**
-     * Interface for instantaneously moving the camera.
-     * @param {boolean} [force=false] - Set to true to ignore locked axis and rotation.
-     * @returns {CameraMovement} The camera movement api.
-     */
-    snap(force?: boolean): CameraMovement;
-    /**
-     * Interface for smoothly moving the camera over time.
-     * @param {number} [duration=1] - The duration of the camera movement animation.
-     * @param {boolean} [force=false] - Set to true to ignore locked axis and rotation.
-     * @returns {CameraMovement} The camera movement api.
-     */
-    lerp(duration: number, force?: boolean): CameraMovement;
-    /**
-     * Calculates the frustum size at a given point in the scene.
-     * @param {THREE.Vector3} point - The point in the scene to calculate the frustum size at.
-     * @returns {number} The frustum size at the specified point.
-     */
-    frustrumSizeAt(point: THREE.Vector3): THREE.Vector2;
-    /**
-     * The current THREE Camera
-     */
-    get three(): THREE.Camera;
-    /**
-     * The quaternion representing the orientation of the object.
-     */
-    get quaternion(): THREE.Quaternion;
-    /**
-    * The position of the camera.
-    */
-    get position(): THREE.Vector3;
-    /**
-     * The matrix representing the transformation of the camera.
-     */
-    get matrix(): THREE.Matrix4;
-    /**
-     * The forward direction of the camera.
-     */
-    get forward(): THREE.Vector3;
-    get isLerping(): boolean;
-    /**
-     * The camera speed factor.
-     */
-    speed: number;
-    /**
-     * The current or target velocity of the camera.
-     */
-    localVelocity: THREE.Vector3;
-    /**
-     * Immediately stops the camera movement.
-     */
-    stop(): void;
-    /**
-     * The target at which the camera is looking at and around which it rotates.
-     */
-    get target(): THREE.Vector3;
-    /**
-     * The distance from the camera to the target.
-     */
-    get orbitDistance(): number;
-    /**
-     * Saves current camera orientation to restore on next reset.
-     */
-    save(): void;
-    /**
-     * Represents whether the camera projection is orthographic.
-     */
-    orthographic: boolean;
-}
+import { OrthographicCamera } from './cameraOrthographic';
+import { PerspectiveCamera } from './cameraPerspective';
 /**
  * Manages viewer camera movement and position
  */
 export declare class Camera implements ICamera {
-    camPerspective: PerspectiveWrapper;
-    camOrthographic: OrthographicWrapper;
+    camPerspective: PerspectiveCamera;
+    camOrthographic: OrthographicCamera;
     private _viewport;
     _scene: RenderScene;
     private _lerp;
     private _movement;
     private _inputVelocity;
     private _velocity;
-    private _speed;
     private _orthographic;
     private _target;
     private _lastPosition;
@@ -169,7 +70,6 @@ export declare class Camera implements ICamera {
     get defaultForward(): THREE.Vector3;
     set defaultForward(value: THREE.Vector3);
     private _velocityBlendFactor;
-    private _moveSpeed;
     constructor(scene: RenderScene, viewport: Viewport, settings: ViewerSettings);
     /**
      * Interface for instantaneously moving the camera.
@@ -210,11 +110,6 @@ export declare class Camera implements ICamera {
      * The forward direction of the camera.
      */
     get forward(): THREE.Vector3;
-    /**
-     * The camera speed factor.
-     */
-    get speed(): number;
-    set speed(value: number);
     /**
      * The current or target velocity of the camera.
      */

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

@@ -71,10 +71,6 @@ export interface ICamera {
      */
     get forward(): THREE.Vector3;
     get isLerping(): boolean;
-    /**
-     * The camera speed factor.
-     */
-    speed: number;
     /**
      * The current or target velocity of the camera.
      */

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';