@ifc-lite/renderer 1.43.0 → 1.44.1

package/dist/camera-projection.js

@@ -1,7 +1,22 @@
 /* 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';
+import { MathUtils, viewBasis } from './math.js';
+import { DEFAULT_ORTHO_SIZE, isUsableBounds } from './camera-guards.js';
+/**
+ * One NDC axis: `screen / extent * scale + offset`, degrading to the centre
+ * of the axis when the extent is unusable.
+ *
+ * `extent` is a drawing-buffer dimension. It is zero before the canvas is
+ * first sized and while its container is collapsed, and the division would
+ * then hand back ±Infinity — or NaN, when the cursor coordinate is zero too,
+ * since `0 / 0` is NaN. Neither is a position on screen.
+ */
+function usableNdc(screen, extent, scale, offset) {
+    if (!(Number.isFinite(extent) && extent > 0) || !Number.isFinite(screen))
+        return offset + scale / 2;
+    return (screen / extent) * scale + offset;
+}
 /**
  * Handles projection math: screen-to-world and world-to-screen conversions,
  * bounding box fitting, and near/far plane management.
@@ -56,30 +71,43 @@ export class CameraProjection {
      * @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
+        // Convert screen coords to NDC (-1 to 1).
+        //
+        // The divisors are the drawing-buffer dimensions, and a canvas can report
+        // zero before its first resize or while its container is collapsed — the
+        // division then yields ±Infinity and the ortho branch below writes that
+        // into the ray origin. A viewport with no extent has no meaningful cursor
+        // position, so the honest reading of "where is the cursor, in NDC" is
+        // dead centre; that is also the answer this returns for a cursor at the
+        // exact centre of a healthy canvas, so it introduces no new behaviour.
+        const ndcX = usableNdc(screenX, canvasWidth, 2, -1);
+        const ndcY = usableNdc(screenY, canvasHeight, -2, 1);
+        // One basis for both branches, and the same one the *view matrix* is built
+        // from (#2467). The orthographic branch used to recompute
+        // `normalize(cross(forward, up))` itself, which has no degeneracy handling
+        // at all: `MathUtils.normalize` floored on `len < 1e-10` back then, and
+        // that comparison is false for NaN, so it divided by NaN rather than
+        // falling back — a non-finite `camera.up` (a BCF `CameraUpVector` of `1e999`
+        // arrives as `Infinity` through a bare `parseFloat`) returned
+        // `origin = (NaN, NaN, NaN)` for BOTH NaN and Infinity, while the rendered
+        // frame stayed perfectly finite. Picking and measurement live outside this
+        // package and test hits with comparisons, every one of which is false
+        // against NaN, so the click read as "empty space".
+        const basis = viewBasis(this.state.camera.position, this.state.camera.target, this.state.camera.up);
         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);
+            // `orthoSize` has a read-site backstop in `Camera.updateMatrices` for
+            // the projection matrix; this is the other reader, so it needs its own.
+            const halfH = Number.isFinite(this.state.orthoSize) ? this.state.orthoSize : DEFAULT_ORTHO_SIZE;
+            const aspect = Number.isFinite(this.state.camera.aspect) ? this.state.camera.aspect : 1;
+            const halfW = halfH * aspect;
             // 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,
+                x: basis.eye.x + basis.right.x * ndcX * halfW + basis.up.x * ndcY * halfH,
+                y: basis.eye.y + basis.right.y * ndcX * halfW + basis.up.y * ndcY * halfH,
+                z: basis.eye.z + basis.right.z * ndcX * halfW + basis.up.z * ndcY * halfH,
             };
-            return { origin, direction: forward };
+            return { origin, direction: basis.forward };
         }
         // Perspective: ray origin is always the camera position
         // Direction is computed through the screen point
@@ -87,23 +115,43 @@ export class CameraProjection {
         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 };
+            return { origin: { ...basis.eye }, direction: basis.forward };
         }
         // 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({
+        // Ray origin is the scrubbed camera position — the same one the view
+        // matrix's translation row uses, so the ray belongs to the frame on
+        // screen rather than to a pose that was never rendered.
+        const origin = { ...basis.eye };
+        const raw = {
             x: worldPoint.x - origin.x,
             y: worldPoint.y - origin.y,
             z: worldPoint.z - origin.z,
-        });
+        };
+        const direction = MathUtils.normalize(raw);
+        // `normalize` is total — it returns the zero vector for everything it
+        // cannot normalize — and a zero-length direction is a ray that hits
+        // nothing, the same silent miss the NaN origin produced. Two inputs land
+        // here, and the second is why the floor inside `normalize` had to be a
+        // finiteness test rather than the `len < 1e-10` lower bound it was:
+        //
+        //  - the inverted matrix is ill-conditioned enough that the unprojected
+        //    point lands on the eye, leaving nothing to normalize;
+        //  - `raw` is non-finite. `MathUtils.invert` stores its result in a
+        //    `Float32Array`, so an inverse component past 3.4e38 saturates to
+        //    `Infinity` and `transformPoint` carries that into `worldPoint`. A
+        //    lower bound admits `Infinity` (it is not *below* the floor), and
+        //    `Infinity / Infinity` is NaN while the finite components divide to
+        //    `0` — so the direction came back `{NaN, 0, -0}`, which is neither
+        //    finite nor the zero vector this branch tests for. Measured on a
+        //    camera at `(1e155, 0, 0)` with a wide viewport (#2479).
+        //
+        // Look along the view direction instead: that is the ray through the
+        // centre of the frame, which is where a cursor with no usable offset is.
+        if (direction.x === 0 && direction.y === 0 && direction.z === 0) {
+            return { origin, direction: basis.forward };
+        }
         return { origin, direction };
     }
     /**
@@ -112,6 +160,11 @@ export class CameraProjection {
      * Y-up coordinate system: Y is vertical
      */
     fitToBounds(min, max) {
+        // Same input class, same policy as the animator's `frameBounds`/
+        // `zoomExtent` (#2461): an infinite or inverted AABB has no centre and no
+        // extent to fit to, and both go straight into `position` and `target`.
+        if (!isUsableBounds(min, max))
+            return;
         const center = {
             x: (min.x + max.x) / 2,
             y: (min.y + max.y) / 2,

package/dist/camera-projection.js.map

@@ -1 +1 @@
-{"version":3,"file":"camera-projection.js","sourceRoot":"","sources":["../src/camera-projection.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"camera-projection.js","sourceRoot":"","sources":["../src/camera-projection.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAS/D,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAExE;;;;;;;;GAQG;AACH,SAAS,SAAS,CAAC,MAAc,EAAE,MAAc,EAAE,KAAa,EAAE,MAAc;IAC9E,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,GAAG,KAAK,GAAG,CAAC,CAAC;IACpG,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,KAAK,GAAG,MAAM,CAAC;AAC5C,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,gBAAgB;IAER;IACA;IAFnB,YACmB,KAA0B,EAC1B,cAA0B;QAD1B,UAAK,GAAL,KAAK,CAAqB;QAC1B,mBAAc,GAAd,cAAc,CAAY;IAC1C,CAAC;IAEJ;;;;;;OAMG;IACH,eAAe,CAAC,QAAc,EAAE,WAAmB,EAAE,YAAoB;QACvE,qDAAqD;QACrD,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC;QAEtC,8DAA8D;QAC9D,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;QAChF,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;QAChF,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;QACjF,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;QAEjF,yBAAyB;QACzB,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YACf,OAAO,IAAI,CAAC;QACd,CAAC;QAED,gCAAgC;QAChC,MAAM,IAAI,GAAG,KAAK,GAAG,KAAK,CAAC;QAC3B,MAAM,IAAI,GAAG,KAAK,GAAG,KAAK,CAAC;QAC3B,MAAM,IAAI,GAAG,KAAK,GAAG,KAAK,CAAC;QAE3B,+BAA+B;QAC/B,IAAI,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,oCAAoC;QACpC,gDAAgD;QAChD,2DAA2D;QAC3D,MAAM,OAAO,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,GAAG,GAAG,WAAW,CAAC;QAC/C,MAAM,OAAO,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,GAAG,GAAG,YAAY,CAAC,CAAC,SAAS;QAE1D,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC;IACpC,CAAC;IAED;;;;;;;OAOG;IACH,cAAc,CAAC,OAAe,EAAE,OAAe,EAAE,WAAmB,EAAE,YAAoB;QACxF,0CAA0C;QAC1C,EAAE;QACF,0EAA0E;QAC1E,yEAAyE;QACzE,wEAAwE;QACxE,0EAA0E;QAC1E,sEAAsE;QACtE,wEAAwE;QACxE,uEAAuE;QACvE,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACpD,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAErD,2EAA2E;QAC3E,0DAA0D;QAC1D,2EAA2E;QAC3E,wEAAwE;QACxE,qEAAqE;QACrE,6EAA6E;QAC7E,8DAA8D;QAC9D,2EAA2E;QAC3E,2EAA2E;QAC3E,sEAAsE;QACtE,mDAAmD;QACnD,MAAM,KAAK,GAAG,SAAS,CACrB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,EAC1B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EACxB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CACrB,CAAC;QAEF,IAAI,IAAI,CAAC,KAAK,CAAC,cAAc,KAAK,cAAc,EAAE,CAAC;YACjD,uEAAuE;YACvE,sEAAsE;YACtE,wEAAwE;YACxE,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,kBAAkB,CAAC;YAChG,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YACxF,MAAM,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;YAE7B,2DAA2D;YAC3D,MAAM,MAAM,GAAG;gBACb,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,GAAG,KAAK;gBACzE,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,GAAG,KAAK;gBACzE,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,GAAG,KAAK;aAC1E,CAAC;YAEF,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;QAC9C,CAAC;QAED,wDAAwD;QACxD,iDAAiD;QAEjD,oCAAoC;QACpC,MAAM,WAAW,GAAG,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QAChE,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,2DAA2D;YAC3D,OAAO,EAAE,MAAM,EAAE,EAAE,GAAG,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;QAChE,CAAC;QAED,4DAA4D;QAC5D,+EAA+E;QAC/E,MAAM,UAAU,GAAG,SAAS,CAAC,cAAc,CAAC,WAAW,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;QAEvF,qEAAqE;QACrE,oEAAoE;QACpE,wDAAwD;QACxD,MAAM,MAAM,GAAG,EAAE,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;QAChC,MAAM,GAAG,GAAG;YACV,CAAC,EAAE,UAAU,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC;YAC1B,CAAC,EAAE,UAAU,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC;YAC1B,CAAC,EAAE,UAAU,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC;SAC3B,CAAC;QACF,MAAM,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAC3C,sEAAsE;QACtE,oEAAoE;QACpE,yEAAyE;QACzE,uEAAuE;QACvE,oEAAoE;QACpE,EAAE;QACF,wEAAwE;QACxE,2DAA2D;QAC3D,oEAAoE;QACpE,sEAAsE;QACtE,uEAAuE;QACvE,sEAAsE;QACtE,wEAAwE;QACxE,uEAAuE;QACvE,qEAAqE;QACrE,6DAA6D;QAC7D,EAAE;QACF,qEAAqE;QACrE,yEAAyE;QACzE,IAAI,SAAS,CAAC,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;YAChE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;QAC9C,CAAC;QAED,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAC/B,CAAC;IAED;;;;OAIG;IACH,WAAW,CAAC,GAAS,EAAE,GAAS;QAC9B,iEAAiE;QACjE,0EAA0E;QAC1E,uEAAuE;QACvE,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC;YAAE,OAAO;QAEtC,MAAM,MAAM,GAAG;YACb,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;YACtB,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;YACtB,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;SACvB,CAAC;QACF,MAAM,IAAI,GAAG;YACX,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;YAChB,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;YAChB,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;SACjB,CAAC;QACF,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QACjD,MAAM,QAAQ,GAAG,OAAO,GAAG,GAAG,CAAC;QAE/B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;QAElC,qCAAqC;QACrC,4DAA4D;QAC5D,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,GAAG;YAC3B,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,QAAQ,GAAG,GAAG,EAAI,QAAQ;YACxC,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,QAAQ,GAAG,GAAG,EAAI,QAAQ;YACxC,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,QAAQ,GAAG,GAAG,EAAI,QAAQ;SACzC,CAAC;QAEF,0EAA0E;QAC1E,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;IAED;;;;OAIG;IACH,mBAAmB,CAAC,SAAiB;QACnC,+DAA+D;IACjE,CAAC;CACF"}

package/dist/camera-state.d.ts

@@ -0,0 +1,62 @@
+/**
+ * The state object every camera sub-system shares.
+ *
+ * This lives on its own rather than inside one of the consumers: `camera.ts`,
+ * `camera-controls.ts`, `camera-animation.ts`, `camera-projection.ts`,
+ * `camera-matrices.ts`, `camera-framing.ts`, `camera-preset-view.ts` and
+ * `camera-first-person.ts` all
+ * need the type, and declaring it inside the gesture module made four of them
+ * import their core type from a sibling that is otherwise unrelated to them.
+ * Owning it here turns that chain into a star.
+ */
+import type { Camera as CameraType, 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;
+    /** Scene bounding box for tight orthographic near/far computation */
+    sceneBounds: {
+        min: {
+            x: number;
+            y: number;
+            z: number;
+        };
+        max: {
+            x: number;
+            y: number;
+            z: number;
+        };
+    } | null;
+    /**
+     * Optional outlier-robust bounds for anchoring the orbit pivot (issue #1394).
+     * Distinct from `sceneBounds`: the renderer keeps `sceneBounds` synced to the
+     * FULL model AABB (needed for near/far clipping and section ranges), but a
+     * handful of far-flung meshes can push that AABB's centre into empty space,
+     * which the orbit-pivot fallback would then rotate around. When set, the pivot
+     * uses this tighter centre instead. `null` ⇒ fall back to `sceneBounds`.
+     */
+    orbitAnchorBounds: {
+        min: {
+            x: number;
+            y: number;
+            z: number;
+        };
+        max: {
+            x: number;
+            y: number;
+            z: number;
+        };
+    } | null;
+}
+//# sourceMappingURL=camera-state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"camera-state.d.ts","sourceRoot":"","sources":["../src/camera-state.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAE7D,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;IAClB,qEAAqE;IACrE,WAAW,EAAE;QAAE,GAAG,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,GAAG,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,GAAG,IAAI,CAAC;IAC3G;;;;;;;OAOG;IACH,iBAAiB,EAAE;QAAE,GAAG,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,GAAG,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,GAAG,IAAI,CAAC;CAClH"}

package/dist/camera-state.js

@@ -0,0 +1,5 @@
+/* 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/. */
+export {};
+//# sourceMappingURL=camera-state.js.map

package/dist/camera-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera-state.js","sourceRoot":"","sources":["../src/camera-state.ts"],"names":[],"mappings":"AAAA;;+DAE+D"}

package/dist/camera.d.ts

@@ -6,14 +6,20 @@
  * (screen-world conversion/bounds fitting).
  */
 import type { Vec3, Mat4 } from './types.js';
-import { type ProjectionMode } from './camera-controls.js';
+import type { ProjectionMode } from './camera-state.js';
 import { type Bounds3, type FitPolicy } from './camera-fit-policy.js';
 export declare class Camera {
     private state;
     private controls;
     private animator;
     private projection;
+    private firstPerson;
     constructor();
+    /**
+     * Cold-path convenience for this class's own setters. The hot path uses the
+     * closure built in the constructor; see the note there.
+     */
+    private updateMatrices;
     /**
      * Set camera aspect ratio
      */
@@ -149,7 +155,21 @@ export declare class Camera {
      */
     getFOV(): number;
     /**
-     * Get distance from camera position to target
+     * Get distance from camera position to target.
+     *
+     * Deliberately **unsanitized**: it reports the pose as it actually is, so a
+     * malformed one (a BCF viewpoint restored from a file reaches the public
+     * setters unvalidated) yields NaN rather than a substituted number. This is
+     * a measurement, not a control input: it is what `useBCF` reads back when
+     * restoring a viewpoint and what the BCF overlay scales markers by. There is
+     * no substitute that is right for every reader — a plausible-looking `1`
+     * would place every restored target one unit from the eye — and returning a
+     * number here would contradict `getPosition()`/`getTarget()`, which are raw,
+     * leaving callers no way to tell that the pose is broken. Gesture code inside
+     * this package guards with {@link isUsableDistance} instead; each gesture
+     * needs a different fallback. Callers OUTSIDE the package cannot use that
+     * predicate (it is package-internal) and are not all guarded — see #2466 for
+     * the viewpoint-restore path (#2441).
      */
     getDistance(): number;
     /**
@@ -275,14 +295,5 @@ export declare class Camera {
             z: number;
         };
     } | null;
-    private updateMatrices;
-    /**
-     * Compute tight near/far for orthographic mode by projecting the scene
-     * bounding sphere onto the camera view direction.
-     *
-     * This gives optimal depth precision (minimizing z-fighting) while ensuring
-     * no geometry is clipped regardless of camera position or view angle.
-     */
-    private computeOrthoNearFar;
 }
 //# sourceMappingURL=camera.d.ts.map

package/dist/camera.d.ts.map

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

package/dist/camera.js

@@ -5,34 +5,16 @@ import { MathUtils } from './math.js';
 import { CameraControls } from './camera-controls.js';
 import { CameraAnimator } from './camera-animation.js';
 import { CameraProjection } from './camera-projection.js';
+import { FirstPersonNavigator } from './camera-first-person.js';
+import { updateCameraMatrices } from './camera-matrices.js';
 import { pickFitPolicy } from './camera-fit-policy.js';
-/**
- * Smallest orthographic half-height the projection matrix is ever built from.
- * Matches the floor the orthographic zoom clamps to in `CameraControls`.
- */
-const MIN_ORTHO_SIZE = 0.01;
-/** Default orthographic half-height, in world units, and the neutral fallback. */
-const DEFAULT_ORTHO_SIZE = 50;
-/**
- * Clamp an orthographic half-height, rejecting a non-finite one.
- *
- * `Math.max`/`Math.min` are NaN-transparent — `Math.max(0.01, NaN)` is `NaN`,
- * not the floor — so a clamp alone does not stop a malformed value reaching
- * the projection matrix (#2441). `orthoSize` is the other value feeding the
- * orthographic projection alongside the near/far guarded in `updateMatrices`,
- * and it is derived from the live pose when the mode is switched.
- *
- * Returns `null` when there is no usable size, so the caller can keep the
- * value it already had rather than substitute an arbitrary one.
- */
-function usableOrthoSize(size) {
-    return Number.isFinite(size) ? Math.max(MIN_ORTHO_SIZE, size) : null;
-}
+import { DEFAULT_ORTHO_SIZE, isUsableBounds, isUsableDistance, usableOrthoSize, } from './camera-guards.js';
 export class Camera {
     state;
     controls;
     animator;
     projection;
+    firstPerson;
     constructor() {
         // Geometry is converted from IFC Z-up to WebGL Y-up during import
         this.state = {
@@ -53,12 +35,25 @@ export class Camera {
             sceneBounds: null,
             orbitAnchorBounds: null,
         };
-        const updateMatrices = () => this.updateMatrices();
+        // Bound straight to the module-level function rather than to
+        // `this.updateMatrices()`: this closure is the per-frame path every
+        // sub-system drives the matrices through, and routing it via the private
+        // method would add a hop to it. Depth is therefore unchanged from before
+        // the extraction (closure → one call), and the callee is monomorphic.
+        const updateMatrices = () => updateCameraMatrices(this.state);
         this.controls = new CameraControls(this.state, updateMatrices);
         this.projection = new CameraProjection(this.state, updateMatrices);
         this.animator = new CameraAnimator(this.state, updateMatrices, this.controls, this.projection);
+        this.firstPerson = new FirstPersonNavigator(this.state, updateMatrices);
         this.updateMatrices();
     }
+    /**
+     * Cold-path convenience for this class's own setters. The hot path uses the
+     * closure built in the constructor; see the note there.
+     */
+    updateMatrices() {
+        updateCameraMatrices(this.state);
+    }
     /**
      * Set camera aspect ratio
      */
@@ -135,11 +130,17 @@ export class Camera {
      * Pan camera (Y-up coordinate system)
      */
     pan(deltaX, deltaY, addVelocity = false) {
-        // Pan speed depends on distance; compute before pan (pan preserves distance)
-        const panSpeed = this.getDistance() * 0.001;
+        // Pan speed depends on distance; compute before pan (pan preserves distance).
+        // `getDistance()` reports the pose verbatim, so a malformed one makes this
+        // NaN — and the inertia loop *latches* it: it spends velocity only while
+        // `Math.abs(velocity) > minVelocity`, which is false for NaN, so a NaN pan
+        // velocity is never applied and never decays. Pan inertia would stay dead
+        // for the rest of the session even after the pose is corrected (#2441).
+        // Skip the velocity rather than seed it with an invented speed.
+        const distance = this.getDistance();
         this.controls.pan(deltaX, deltaY);
-        if (addVelocity) {
-            this.animator.addPanVelocity(deltaX, deltaY, panSpeed);
+        if (addVelocity && isUsableDistance(distance, 0)) {
+            this.animator.addPanVelocity(deltaX, deltaY, distance * 0.001);
         }
     }
     /**
@@ -214,6 +215,23 @@ export class Camera {
      * callers don't have to thread the FOV through themselves.
      */
     fitBoundsAdaptive(bounds, options) {
+        // `pickFitPolicy` is pure and would hand back a non-finite pose for an
+        // infinite or inverted box, which `snapToFitPolicy` writes verbatim into
+        // position, target AND up — the widest single write in the class. This is
+        // the auto-fit that runs as geometry streams, so the box comes straight
+        // from the model (#2461). Report the pose the camera already has: applying
+        // it is a no-op, which is exactly the intended outcome, and callers only
+        // read `policy.kind`.
+        if (!isUsableBounds(bounds.min, bounds.max)) {
+            return {
+                kind: 'compact',
+                aspect: 1,
+                target: { ...this.state.camera.target },
+                position: { ...this.state.camera.position },
+                up: { ...this.state.camera.up },
+                distance: this.getDistance(),
+            };
+        }
         const fitOpts = {
             fovY: this.state.camera.fov,
             viewportShortPx: options?.viewportShortPx,
@@ -243,13 +261,13 @@ export class Camera {
      * Set first-person mode
      */
     enableFirstPersonMode(enabled) {
-        this.animator.enableFirstPersonMode(enabled);
+        this.firstPerson.setEnabled(enabled);
     }
     /**
      * Move in first-person mode (Y-up coordinate system)
      */
     moveFirstPerson(forward, right, up) {
-        this.animator.moveFirstPerson(forward, right, up);
+        this.firstPerson.move(forward, right, up);
     }
     /**
      * Set preset view with explicit bounds (Y-up coordinate system)
@@ -272,6 +290,11 @@ export class Camera {
     reset() {
         this.controls.setOrbitCenter(null);
         this.animator.reset();
+        // The walk velocity is smoothed in place, so it survives a model swap and
+        // would be spent on the new model's first walk frame. It used to live on
+        // the animator, where `animator.reset()` did not clear it either — the
+        // extraction is what made the omission visible.
+        this.firstPerson.stop();
         // Drop the previous model's outlier-robust orbit anchor (issue #1394) — it
         // survives setSceneBounds() syncs, so without this a model swap would orbit
         // the new model around the old one's centre until the first fit clears it.
@@ -299,7 +322,21 @@ export class Camera {
         return this.state.camera.fov;
     }
     /**
-     * Get distance from camera position to target
+     * Get distance from camera position to target.
+     *
+     * Deliberately **unsanitized**: it reports the pose as it actually is, so a
+     * malformed one (a BCF viewpoint restored from a file reaches the public
+     * setters unvalidated) yields NaN rather than a substituted number. This is
+     * a measurement, not a control input: it is what `useBCF` reads back when
+     * restoring a viewpoint and what the BCF overlay scales markers by. There is
+     * no substitute that is right for every reader — a plausible-looking `1`
+     * would place every restored target one unit from the eye — and returning a
+     * number here would contradict `getPosition()`/`getTarget()`, which are raw,
+     * leaving callers no way to tell that the pose is broken. Gesture code inside
+     * this package guards with {@link isUsableDistance} instead; each gesture
+     * needs a different fallback. Callers OUTSIDE the package cannot use that
+     * predicate (it is package-internal) and are not all guarded — see #2466 for
+     * the viewpoint-restore path (#2441).
      */
     getDistance() {
         const dir = {
@@ -322,7 +359,14 @@ export class Camera {
             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);
-        if (distance < 1e-6)
+        // `distance < 1e-6` alone is a magnitude test, not a finiteness one: the
+        // comparison is false for NaN, so a malformed pose fell through the guard
+        // that looked like it was catching it, and `Math.asin(Math.max(-1,
+        // Math.min(1, NaN)))` is NaN — a NaN elevation that leaves the renderer
+        // entirely, into the viewer's rotation readout and the measurement
+        // handlers (#2441). Same neutral answer as the degenerate pose, which is
+        // preserved verbatim.
+        if (!isUsableDistance(distance, 1e-6))
             return { azimuth: 0, elevation: 0 };
         // Elevation: angle from horizontal plane
         const elevation = Math.asin(Math.max(-1, Math.min(1, dir.y / distance))) * 180 / Math.PI;
@@ -456,94 +500,5 @@ export class Camera {
     getOrbitAnchorBounds() {
         return this.state.orbitAnchorBounds;
     }
-    updateMatrices() {
-        const dx = this.state.camera.position.x - this.state.camera.target.x;
-        const dy = this.state.camera.position.y - this.state.camera.target.y;
-        const dz = this.state.camera.position.z - this.state.camera.target.z;
-        const rawDistance = Math.sqrt(dx * dx + dy * dy + dz * dz);
-        // A non-finite position or target — a malformed BCF viewpoint reaches the
-        // public setters unvalidated — would put NaN into near/far and from there
-        // into the projection matrix, leaving the viewport dead even though
-        // `MathUtils.lookAt` scrubs the view matrix (#2441). Fall back to a
-        // neutral distance so the projection stays finite; the camera state itself
-        // is left as the caller set it.
-        const distance = Number.isFinite(rawDistance) ? rawDistance : 1;
-        this.state.viewMatrix = MathUtils.lookAt(this.state.camera.position, this.state.camera.target, this.state.camera.up);
-        if (this.state.projectionMode === 'orthographic') {
-            // Orthographic: project scene bounding sphere onto view direction for tight near/far.
-            // Tight range maximizes depth precision (less z-fighting) and prevents clipping.
-            const nf = this.computeOrthoNearFar(distance);
-            this.state.camera.near = nf.near;
-            this.state.camera.far = nf.far;
-            // Backstop for the writers that never see `setOrthoSize`'s clamp: the
-            // orthographic zoom scales `orthoSize` in place and the animator
-            // interpolates it, so a NaN reaching either (from a malformed pose, or
-            // from bounds that were themselves non-finite) would land straight in
-            // the projection matrix. Same fallback shape as the distance above.
-            const h = Number.isFinite(this.state.orthoSize) ? this.state.orthoSize : DEFAULT_ORTHO_SIZE;
-            const w = h * this.state.camera.aspect;
-            this.state.projMatrix = MathUtils.orthographicReverseZ(-w, w, -h, h, this.state.camera.near, this.state.camera.far);
-        }
-        else {
-            // Perspective: adapt near/far based on camera-to-target distance
-            this.state.camera.near = Math.max(0.01, distance * 0.001);
-            this.state.camera.far = Math.max(distance * 10, 1000);
-            this.state.projMatrix = MathUtils.perspectiveReverseZ(this.state.camera.fov, this.state.camera.aspect, this.state.camera.near, this.state.camera.far);
-        }
-        this.state.viewProjMatrix = MathUtils.multiply(this.state.projMatrix, this.state.viewMatrix);
-    }
-    /**
-     * Compute tight near/far for orthographic mode by projecting the scene
-     * bounding sphere onto the camera view direction.
-     *
-     * This gives optimal depth precision (minimizing z-fighting) while ensuring
-     * no geometry is clipped regardless of camera position or view angle.
-     */
-    computeOrthoNearFar(distance) {
-        const bounds = this.state.sceneBounds;
-        if (!bounds) {
-            // Fallback: generous range centered on camera
-            return { near: -Math.max(distance, 500), far: Math.max(distance, 500) };
-        }
-        // Scene bounding sphere center and radius
-        const cx = (bounds.min.x + bounds.max.x) / 2;
-        const cy = (bounds.min.y + bounds.max.y) / 2;
-        const cz = (bounds.min.z + bounds.max.z) / 2;
-        const ex = bounds.max.x - bounds.min.x;
-        const ey = bounds.max.y - bounds.min.y;
-        const ez = bounds.max.z - bounds.min.z;
-        const radius = Math.sqrt(ex * ex + ey * ey + ez * ez) / 2;
-        // View direction (camera looks from position toward target)
-        const pos = this.state.camera.position;
-        let vx = this.state.camera.target.x - pos.x;
-        let vy = this.state.camera.target.y - pos.y;
-        let vz = this.state.camera.target.z - pos.z;
-        const vLen = Math.sqrt(vx * vx + vy * vy + vz * vz);
-        if (vLen > 1e-8) {
-            vx /= vLen;
-            vy /= vLen;
-            vz /= vLen;
-        }
-        // Signed distance from camera to scene center along view direction
-        const toCenter = (cx - pos.x) * vx + (cy - pos.y) * vy + (cz - pos.z) * vz;
-        // Near/far as distances from camera along view direction.
-        // The sphere spans [toCenter - radius, toCenter + radius] along view dir.
-        // Add 10% padding for safety.
-        const pad = radius * 0.1 + 1;
-        let near = toCenter - radius - pad;
-        let far = toCenter + radius + pad;
-        // Ensure minimum range for depth precision
-        if (far - near < 1) {
-            near -= 0.5;
-            far += 0.5;
-        }
-        // Same contract as the perspective branch: a non-finite camera position or
-        // scene bound must not reach the projection matrix (#2441).
-        if (!Number.isFinite(near) || !Number.isFinite(far)) {
-            const fallback = Math.max(Number.isFinite(distance) ? distance : 0, 500);
-            return { near: -fallback, far: fallback };
-        }
-        return { near, far };
-    }
 }
 //# sourceMappingURL=camera.js.map