@ifc-lite/renderer 1.6.1 → 1.8.0

package/dist/camera-controls.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Camera orbit, pan, and zoom controls with spherical coordinate math.
+ * Extracted from Camera class using composition pattern.
+ */
+import type { Camera as CameraType, Vec3, Mat4 } from './types.js';
+/** Projection mode for the camera */
+export type ProjectionMode = 'perspective' | 'orthographic';
+/**
+ * Shared mutable state for camera sub-systems.
+ * All sub-systems reference the same state object so changes are visible across them.
+ */
+export interface CameraInternalState {
+    camera: CameraType;
+    viewMatrix: Mat4;
+    projMatrix: Mat4;
+    viewProjMatrix: Mat4;
+    /** Current projection mode */
+    projectionMode: ProjectionMode;
+    /** Orthographic half-height in world units (controls zoom level in ortho mode) */
+    orthoSize: number;
+}
+/**
+ * Handles core camera movement: orbit, pan, and zoom.
+ * Uses spherical coordinates for orbit with Y-up convention.
+ */
+export declare class CameraControls {
+    private readonly state;
+    private readonly updateMatrices;
+    /** Dynamic orbit pivot (for orbiting around selected element or cursor point) */
+    private orbitPivot;
+    constructor(state: CameraInternalState, updateMatrices: () => void);
+    /**
+     * Set temporary orbit pivot (for orbiting around selected element or cursor point)
+     * When set, orbit() will rotate around this point instead of the camera target
+     */
+    setOrbitPivot(pivot: Vec3 | null): void;
+    /**
+     * Get current orbit pivot (returns temporary pivot if set, otherwise target)
+     */
+    getOrbitPivot(): Vec3;
+    /**
+     * Check if a temporary orbit pivot is set
+     */
+    hasOrbitPivot(): boolean;
+    /**
+     * Clear the orbit pivot
+     */
+    clearOrbitPivot(): void;
+    /**
+     * Orbit around target or pivot (Y-up coordinate system).
+     * If an orbit pivot is set, orbits around that point.
+     *
+     * Note: Does not handle velocity or preset view tracking;
+     * the Camera class coordinates those concerns.
+     */
+    orbit(deltaX: number, deltaY: number): void;
+    /**
+     * Pan camera (Y-up coordinate system).
+     *
+     * Note: Does not handle velocity; the Camera class coordinates that.
+     */
+    pan(deltaX: number, deltaY: number): void;
+    /**
+     * Zoom camera towards mouse position.
+     * @param delta - Zoom delta (positive = zoom out, negative = zoom in)
+     * @param mouseX - Mouse X position in canvas coordinates
+     * @param mouseY - Mouse Y position in canvas coordinates
+     * @param canvasWidth - Canvas width
+     * @param canvasHeight - Canvas height
+     *
+     * Note: Does not handle velocity; the Camera class coordinates that.
+     */
+    zoom(delta: number, mouseX?: number, mouseY?: number, canvasWidth?: number, canvasHeight?: number): void;
+}
+//# sourceMappingURL=camera-controls.d.ts.map

package/dist/camera-controls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera-controls.d.ts","sourceRoot":"","sources":["../src/camera-controls.ts"],"names":[],"mappings":"AAIA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEnE,qCAAqC;AACrC,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,cAAc,CAAC;AAE5D;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,EAAE,IAAI,CAAC;IACjB,UAAU,EAAE,IAAI,CAAC;IACjB,cAAc,EAAE,IAAI,CAAC;IACrB,8BAA8B;IAC9B,cAAc,EAAE,cAAc,CAAC;IAC/B,kFAAkF;IAClF,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,qBAAa,cAAc;IAKvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,cAAc;IALjC,iFAAiF;IACjF,OAAO,CAAC,UAAU,CAAqB;gBAGpB,KAAK,EAAE,mBAAmB,EAC1B,cAAc,EAAE,MAAM,IAAI;IAG7C;;;OAGG;IACH,aAAa,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI;IAIvC;;OAEG;IACH,aAAa,IAAI,IAAI;IAIrB;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,eAAe,IAAI,IAAI;IAIvB;;;;;;OAMG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IA+D3C;;;;OAIG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IA4CzC;;;;;;;;;OASG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI;CA2FzG"}

package/dist/camera-controls.js

@@ -0,0 +1,239 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+/**
+ * Handles core camera movement: orbit, pan, and zoom.
+ * Uses spherical coordinates for orbit with Y-up convention.
+ */
+export class CameraControls {
+    state;
+    updateMatrices;
+    /** Dynamic orbit pivot (for orbiting around selected element or cursor point) */
+    orbitPivot = null;
+    constructor(state, updateMatrices) {
+        this.state = state;
+        this.updateMatrices = updateMatrices;
+    }
+    /**
+     * Set temporary orbit pivot (for orbiting around selected element or cursor point)
+     * When set, orbit() will rotate around this point instead of the camera target
+     */
+    setOrbitPivot(pivot) {
+        this.orbitPivot = pivot ? { ...pivot } : null;
+    }
+    /**
+     * Get current orbit pivot (returns temporary pivot if set, otherwise target)
+     */
+    getOrbitPivot() {
+        return this.orbitPivot ? { ...this.orbitPivot } : { ...this.state.camera.target };
+    }
+    /**
+     * Check if a temporary orbit pivot is set
+     */
+    hasOrbitPivot() {
+        return this.orbitPivot !== null;
+    }
+    /**
+     * Clear the orbit pivot
+     */
+    clearOrbitPivot() {
+        this.orbitPivot = null;
+    }
+    /**
+     * Orbit around target or pivot (Y-up coordinate system).
+     * If an orbit pivot is set, orbits around that point.
+     *
+     * Note: Does not handle velocity or preset view tracking;
+     * the Camera class coordinates those concerns.
+     */
+    orbit(deltaX, deltaY) {
+        // Always ensure Y-up for consistent orbit behavior
+        this.state.camera.up = { x: 0, y: 1, z: 0 };
+        // Invert controls: mouse movement direction = model rotation direction
+        const dx = -deltaX * 0.01;
+        const dy = -deltaY * 0.01;
+        // Use orbit pivot if set, otherwise use target
+        const pivotPoint = this.orbitPivot || this.state.camera.target;
+        const dir = {
+            x: this.state.camera.position.x - pivotPoint.x,
+            y: this.state.camera.position.y - pivotPoint.y,
+            z: this.state.camera.position.z - pivotPoint.z,
+        };
+        const distance = Math.sqrt(dir.x * dir.x + dir.y * dir.y + dir.z * dir.z);
+        if (distance < 1e-6)
+            return;
+        // Y-up coordinate system using standard spherical coordinates
+        // theta: horizontal rotation around Y axis
+        // phi: vertical angle from Y axis (0 = top, PI = bottom)
+        let currentPhi = Math.acos(Math.max(-1, Math.min(1, dir.y / distance)));
+        // When at poles (top/bottom view), use a stable theta based on current direction
+        // to avoid gimbal lock issues
+        let theta;
+        const sinPhi = Math.sin(currentPhi);
+        if (sinPhi > 0.05) {
+            // Normal case - calculate theta from horizontal position
+            theta = Math.atan2(dir.x, dir.z);
+        }
+        else {
+            // At a pole - determine which one and push away
+            theta = 0; // Default theta when at pole
+            if (currentPhi < Math.PI / 2) {
+                // Top pole (phi ~ 0) - push down
+                currentPhi = 0.15;
+            }
+            else {
+                // Bottom pole (phi ~ PI) - push up
+                currentPhi = Math.PI - 0.15;
+            }
+        }
+        theta += dx;
+        const phi = currentPhi + dy;
+        // Clamp phi to prevent gimbal lock (stay away from exact poles)
+        const phiClamped = Math.max(0.15, Math.min(Math.PI - 0.15, phi));
+        // Calculate new camera position around pivot
+        const newPosX = pivotPoint.x + distance * Math.sin(phiClamped) * Math.sin(theta);
+        const newPosY = pivotPoint.y + distance * Math.cos(phiClamped);
+        const newPosZ = pivotPoint.z + distance * Math.sin(phiClamped) * Math.cos(theta);
+        // Update camera position
+        this.state.camera.position.x = newPosX;
+        this.state.camera.position.y = newPosY;
+        this.state.camera.position.z = newPosZ;
+        this.updateMatrices();
+    }
+    /**
+     * Pan camera (Y-up coordinate system).
+     *
+     * Note: Does not handle velocity; the Camera class coordinates that.
+     */
+    pan(deltaX, deltaY) {
+        const dir = {
+            x: this.state.camera.position.x - this.state.camera.target.x,
+            y: this.state.camera.position.y - this.state.camera.target.y,
+            z: this.state.camera.position.z - this.state.camera.target.z,
+        };
+        const distance = Math.sqrt(dir.x * dir.x + dir.y * dir.y + dir.z * dir.z);
+        // Right vector: cross product of direction and up (0,1,0)
+        const right = {
+            x: -dir.z,
+            y: 0,
+            z: dir.x,
+        };
+        const rightLen = Math.sqrt(right.x * right.x + right.z * right.z);
+        if (rightLen > 1e-10) {
+            right.x /= rightLen;
+            right.z /= rightLen;
+        }
+        // Up vector: cross product of right and direction
+        const up = {
+            x: (right.z * dir.y - right.y * dir.z),
+            y: (right.x * dir.z - right.z * dir.x),
+            z: (right.y * dir.x - right.x * dir.y),
+        };
+        const upLen = Math.sqrt(up.x * up.x + up.y * up.y + up.z * up.z);
+        if (upLen > 1e-10) {
+            up.x /= upLen;
+            up.y /= upLen;
+            up.z /= upLen;
+        }
+        const panSpeed = distance * 0.001;
+        this.state.camera.target.x += (right.x * deltaX + up.x * deltaY) * panSpeed;
+        this.state.camera.target.y += (right.y * deltaX + up.y * deltaY) * panSpeed;
+        this.state.camera.target.z += (right.z * deltaX + up.z * deltaY) * panSpeed;
+        this.state.camera.position.x += (right.x * deltaX + up.x * deltaY) * panSpeed;
+        this.state.camera.position.y += (right.y * deltaX + up.y * deltaY) * panSpeed;
+        this.state.camera.position.z += (right.z * deltaX + up.z * deltaY) * panSpeed;
+        this.updateMatrices();
+    }
+    /**
+     * Zoom camera towards mouse position.
+     * @param delta - Zoom delta (positive = zoom out, negative = zoom in)
+     * @param mouseX - Mouse X position in canvas coordinates
+     * @param mouseY - Mouse Y position in canvas coordinates
+     * @param canvasWidth - Canvas width
+     * @param canvasHeight - Canvas height
+     *
+     * Note: Does not handle velocity; the Camera class coordinates that.
+     */
+    zoom(delta, mouseX, mouseY, canvasWidth, canvasHeight) {
+        const dir = {
+            x: this.state.camera.position.x - this.state.camera.target.x,
+            y: this.state.camera.position.y - this.state.camera.target.y,
+            z: this.state.camera.position.z - this.state.camera.target.z,
+        };
+        const distance = Math.sqrt(dir.x * dir.x + dir.y * dir.y + dir.z * dir.z);
+        // Normalize delta (wheel events can have large values)
+        const normalizedDelta = Math.sign(delta) * Math.min(Math.abs(delta) * 0.001, 0.1);
+        const zoomFactor = 1 + normalizedDelta;
+        // If mouse position provided, zoom towards that point
+        if (mouseX !== undefined && mouseY !== undefined && canvasWidth && canvasHeight) {
+            // Convert mouse to normalized device coordinates (-1 to 1)
+            const ndcX = (mouseX / canvasWidth) * 2 - 1;
+            const ndcY = 1 - (mouseY / canvasHeight) * 2; // Flip Y
+            // Calculate offset from center in world space
+            // Use the camera's right and up vectors
+            const forward = {
+                x: -dir.x / distance,
+                y: -dir.y / distance,
+                z: -dir.z / distance,
+            };
+            // Right = forward x up
+            const up = this.state.camera.up;
+            const right = {
+                x: forward.y * up.z - forward.z * up.y,
+                y: forward.z * up.x - forward.x * up.z,
+                z: forward.x * up.y - forward.y * up.x,
+            };
+            const rightLen = Math.sqrt(right.x * right.x + right.y * right.y + right.z * right.z);
+            if (rightLen > 1e-10) {
+                right.x /= rightLen;
+                right.y /= rightLen;
+                right.z /= rightLen;
+            }
+            // Actual up = right x forward
+            const actualUp = {
+                x: right.y * forward.z - right.z * forward.y,
+                y: right.z * forward.x - right.x * forward.z,
+                z: right.x * forward.y - right.y * forward.x,
+            };
+            // Calculate view frustum size at target distance
+            const halfHeight = this.state.projectionMode === 'orthographic'
+                ? this.state.orthoSize
+                : distance * Math.tan(this.state.camera.fov / 2);
+            const halfWidth = halfHeight * this.state.camera.aspect;
+            // World offset from center towards mouse position
+            const worldOffsetX = ndcX * halfWidth;
+            const worldOffsetY = ndcY * halfHeight;
+            // Point in world space that mouse is pointing at (on the target plane)
+            const mouseWorldPoint = {
+                x: this.state.camera.target.x + right.x * worldOffsetX + actualUp.x * worldOffsetY,
+                y: this.state.camera.target.y + right.y * worldOffsetX + actualUp.y * worldOffsetY,
+                z: this.state.camera.target.z + right.z * worldOffsetX + actualUp.z * worldOffsetY,
+            };
+            // Move both camera and target towards mouse point while zooming
+            const moveAmount = (1 - zoomFactor); // Negative when zooming in
+            this.state.camera.target.x += (mouseWorldPoint.x - this.state.camera.target.x) * moveAmount;
+            this.state.camera.target.y += (mouseWorldPoint.y - this.state.camera.target.y) * moveAmount;
+            this.state.camera.target.z += (mouseWorldPoint.z - this.state.camera.target.z) * moveAmount;
+        }
+        if (this.state.projectionMode === 'orthographic') {
+            // Orthographic: scale view volume instead of moving camera
+            this.state.orthoSize = Math.max(0.01, this.state.orthoSize * zoomFactor);
+            // Still move camera position to keep orbit distance consistent for when switching back
+            const newDistance = Math.max(0.1, distance * zoomFactor);
+            const scale = newDistance / distance;
+            this.state.camera.position.x = this.state.camera.target.x + dir.x * scale;
+            this.state.camera.position.y = this.state.camera.target.y + dir.y * scale;
+            this.state.camera.position.z = this.state.camera.target.z + dir.z * scale;
+        }
+        else {
+            // Perspective: scale distance
+            const newDistance = Math.max(0.1, distance * zoomFactor);
+            const scale = newDistance / distance;
+            this.state.camera.position.x = this.state.camera.target.x + dir.x * scale;
+            this.state.camera.position.y = this.state.camera.target.y + dir.y * scale;
+            this.state.camera.position.z = this.state.camera.target.z + dir.z * scale;
+        }
+        this.updateMatrices();
+    }
+}
+//# sourceMappingURL=camera-controls.js.map

package/dist/camera-controls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera-controls.js","sourceRoot":"","sources":["../src/camera-controls.ts"],"names":[],"mappings":"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"}

package/dist/camera-projection.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Camera projection utilities for screen/world coordinate conversion
+ * and view fitting. Extracted from Camera class using composition pattern.
+ */
+import type { Vec3 } from './types.js';
+import type { CameraInternalState } from './camera-controls.js';
+/**
+ * Handles projection math: screen-to-world and world-to-screen conversions,
+ * bounding box fitting, and near/far plane management.
+ */
+export declare class CameraProjection {
+    private readonly state;
+    private readonly updateMatrices;
+    constructor(state: CameraInternalState, updateMatrices: () => void);
+    /**
+     * Project a world position to screen coordinates
+     * @param worldPos - Position in world space
+     * @param canvasWidth - Canvas width in pixels
+     * @param canvasHeight - Canvas height in pixels
+     * @returns Screen coordinates { x, y } or null if behind camera
+     */
+    projectToScreen(worldPos: Vec3, canvasWidth: number, canvasHeight: number): {
+        x: number;
+        y: number;
+    } | null;
+    /**
+     * Unproject screen coordinates to a ray in world space
+     * @param screenX - X position in screen coordinates
+     * @param screenY - Y position in screen coordinates
+     * @param canvasWidth - Canvas width in pixels
+     * @param canvasHeight - Canvas height in pixels
+     * @returns Ray origin and direction in world space
+     */
+    unprojectToRay(screenX: number, screenY: number, canvasWidth: number, canvasHeight: number): {
+        origin: Vec3;
+        direction: Vec3;
+    };
+    /**
+     * Fit view to bounding box
+     * Sets camera to southeast isometric view (typical BIM starting view)
+     * Y-up coordinate system: Y is vertical
+     */
+    fitToBounds(min: Vec3, max: Vec3): void;
+    /**
+     * Update near/far planes dynamically based on camera distance.
+     * Now a no-op since updateMatrices() handles this automatically.
+     * Kept for API compatibility with CameraAnimator.
+     */
+    updateNearFarPlanes(_distance: number): void;
+}
+//# sourceMappingURL=camera-projection.d.ts.map

package/dist/camera-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera-projection.d.ts","sourceRoot":"","sources":["../src/camera-projection.ts"],"names":[],"mappings":"AAIA;;;GAGG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAGhE;;;GAGG;AACH,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,cAAc;gBADd,KAAK,EAAE,mBAAmB,EAC1B,cAAc,EAAE,MAAM,IAAI;IAG7C;;;;;;OAMG;IACH,eAAe,CAAC,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAkC3G;;;;;;;OAOG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG;QAAE,MAAM,EAAE,IAAI,CAAC;QAAC,SAAS,EAAE,IAAI,CAAA;KAAE;IA8D9H;;;;OAIG;IACH,WAAW,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,GAAG,IAAI;IA4BvC;;;;OAIG;IACH,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;CAG7C"}

package/dist/camera-projection.js

@@ -0,0 +1,147 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+import { MathUtils } from './math.js';
+/**
+ * Handles projection math: screen-to-world and world-to-screen conversions,
+ * bounding box fitting, and near/far plane management.
+ */
+export class CameraProjection {
+    state;
+    updateMatrices;
+    constructor(state, updateMatrices) {
+        this.state = state;
+        this.updateMatrices = updateMatrices;
+    }
+    /**
+     * Project a world position to screen coordinates
+     * @param worldPos - Position in world space
+     * @param canvasWidth - Canvas width in pixels
+     * @param canvasHeight - Canvas height in pixels
+     * @returns Screen coordinates { x, y } or null if behind camera
+     */
+    projectToScreen(worldPos, canvasWidth, canvasHeight) {
+        // Transform world position by view-projection matrix
+        const m = this.state.viewProjMatrix.m;
+        // Manual matrix-vector multiplication for vec4(worldPos, 1.0)
+        const clipX = m[0] * worldPos.x + m[4] * worldPos.y + m[8] * worldPos.z + m[12];
+        const clipY = m[1] * worldPos.x + m[5] * worldPos.y + m[9] * worldPos.z + m[13];
+        const clipZ = m[2] * worldPos.x + m[6] * worldPos.y + m[10] * worldPos.z + m[14];
+        const clipW = m[3] * worldPos.x + m[7] * worldPos.y + m[11] * worldPos.z + m[15];
+        // Check if behind camera
+        if (clipW <= 0) {
+            return null;
+        }
+        // Perspective divide to get NDC
+        const ndcX = clipX / clipW;
+        const ndcY = clipY / clipW;
+        const ndcZ = clipZ / clipW;
+        // Check if outside clip volume
+        if (ndcZ < -1 || ndcZ > 1) {
+            return null;
+        }
+        // Convert NDC to screen coordinates
+        // NDC: (-1,-1) = bottom-left, (1,1) = top-right
+        // Screen: (0,0) = top-left, (width, height) = bottom-right
+        const screenX = (ndcX + 1) * 0.5 * canvasWidth;
+        const screenY = (1 - ndcY) * 0.5 * canvasHeight; // Flip Y
+        return { x: screenX, y: screenY };
+    }
+    /**
+     * Unproject screen coordinates to a ray in world space
+     * @param screenX - X position in screen coordinates
+     * @param screenY - Y position in screen coordinates
+     * @param canvasWidth - Canvas width in pixels
+     * @param canvasHeight - Canvas height in pixels
+     * @returns Ray origin and direction in world space
+     */
+    unprojectToRay(screenX, screenY, canvasWidth, canvasHeight) {
+        // Convert screen coords to NDC (-1 to 1)
+        const ndcX = (screenX / canvasWidth) * 2 - 1;
+        const ndcY = 1 - (screenY / canvasHeight) * 2; // Flip Y
+        if (this.state.projectionMode === 'orthographic') {
+            // Orthographic: rays are parallel. Origin varies with screen position.
+            const halfH = this.state.orthoSize;
+            const halfW = halfH * this.state.camera.aspect;
+            // Forward direction (camera towards target)
+            const forward = MathUtils.normalize({
+                x: this.state.camera.target.x - this.state.camera.position.x,
+                y: this.state.camera.target.y - this.state.camera.position.y,
+                z: this.state.camera.target.z - this.state.camera.position.z,
+            });
+            // Right = forward x up
+            const right = MathUtils.normalize(MathUtils.cross(forward, this.state.camera.up));
+            // Actual up = right x forward
+            const actualUp = MathUtils.cross(right, forward);
+            // Ray origin: camera position offset by NDC * view extents
+            const origin = {
+                x: this.state.camera.position.x + right.x * ndcX * halfW + actualUp.x * ndcY * halfH,
+                y: this.state.camera.position.y + right.y * ndcX * halfW + actualUp.y * ndcY * halfH,
+                z: this.state.camera.position.z + right.z * ndcX * halfW + actualUp.z * ndcY * halfH,
+            };
+            return { origin, direction: forward };
+        }
+        // Perspective: ray origin is always the camera position
+        // Direction is computed through the screen point
+        // Invert the view-projection matrix
+        const invViewProj = MathUtils.invert(this.state.viewProjMatrix);
+        if (!invViewProj) {
+            // Fallback: return ray from camera position towards target
+            const dir = MathUtils.normalize({
+                x: this.state.camera.target.x - this.state.camera.position.x,
+                y: this.state.camera.target.y - this.state.camera.position.y,
+                z: this.state.camera.target.z - this.state.camera.position.z,
+            });
+            return { origin: { ...this.state.camera.position }, direction: dir };
+        }
+        // Unproject a point at some depth to get a point on the ray
+        // Using z=0.5 (midpoint in Reverse-Z: 1.0=near, 0.0=far) to get a finite point
+        const worldPoint = MathUtils.transformPoint(invViewProj, { x: ndcX, y: ndcY, z: 0.5 });
+        // Ray origin is camera position, direction is towards unprojected point
+        const origin = { ...this.state.camera.position };
+        const direction = MathUtils.normalize({
+            x: worldPoint.x - origin.x,
+            y: worldPoint.y - origin.y,
+            z: worldPoint.z - origin.z,
+        });
+        return { origin, direction };
+    }
+    /**
+     * Fit view to bounding box
+     * Sets camera to southeast isometric view (typical BIM starting view)
+     * Y-up coordinate system: Y is vertical
+     */
+    fitToBounds(min, max) {
+        const center = {
+            x: (min.x + max.x) / 2,
+            y: (min.y + max.y) / 2,
+            z: (min.z + max.z) / 2,
+        };
+        const size = {
+            x: max.x - min.x,
+            y: max.y - min.y,
+            z: max.z - min.z,
+        };
+        const maxSize = Math.max(size.x, size.y, size.z);
+        const distance = maxSize * 2.0;
+        this.state.camera.target = center;
+        // Southeast isometric view for Y-up:
+        // Position camera above and to the front-right of the model
+        this.state.camera.position = {
+            x: center.x + distance * 0.6, // Right
+            y: center.y + distance * 0.5, // Above
+            z: center.z + distance * 0.6, // Front
+        };
+        // near/far are computed dynamically in updateMatrices() based on distance
+        this.updateMatrices();
+    }
+    /**
+     * Update near/far planes dynamically based on camera distance.
+     * Now a no-op since updateMatrices() handles this automatically.
+     * Kept for API compatibility with CameraAnimator.
+     */
+    updateNearFarPlanes(_distance) {
+        // near/far are computed dynamically in Camera.updateMatrices()
+    }
+}
+//# sourceMappingURL=camera-projection.js.map

package/dist/camera-projection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera-projection.js","sourceRoot":"","sources":["../src/camera-projection.ts"],"names":[],"mappings":"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"}