@vertexvis/viewer 0.18.0 → 0.18.1-testing.0

package/dist/collection/lib/interactions/interactionApiPerspective.js

@@ -1,8 +1,9 @@
 /*!
  * Copyright (c) 2023 Vertex Software LLC. All rights reserved.
  */
-import { Point, Vector3 } from '@vertexvis/geometry';
+import { Plane, Point, Ray, Vector3 } from '@vertexvis/geometry';
 import { InteractionApi, } from './interactionApi';
+const CAMERA_MIN_ZOOM_SCALAR = 0.2;
 export class InteractionApiPerspective extends InteractionApi {
   constructor(stream, cursors, getConfig, getScene, getFrame, getViewport, tapEmitter, doubleTapEmitter, longPressEmitter, interactionStartedEmitter, interactionFinishedEmitter) {
     super(stream, cursors, getConfig, getScene, getFrame, getViewport, tapEmitter, doubleTapEmitter, longPressEmitter, interactionStartedEmitter, interactionFinishedEmitter);
@@ -30,6 +31,48 @@ export class InteractionApiPerspective extends InteractionApi {
       return camera.moveBy(offset);
     });
   }
+  async zoomCameraToPoint(point, delta) {
+    return this.transformCamera(({ camera, viewport, frame, depthBuffer, boundingBox }) => {
+      const cam = frame.scene.camera;
+      const dir = cam.direction;
+      const frameCam = camera.toFrameCamera();
+      const ray = viewport.transformPointToRay(point, frame.image, frameCam);
+      if (this.zoomData == null) {
+        const fallbackPlane = Plane.fromNormalAndCoplanarPoint(dir, cam.lookAt);
+        const fallbackPt = Ray.intersectPlane(ray, fallbackPlane);
+        if (fallbackPt == null) {
+          console.warn('Cannot determine fallback point for zoom. Ray does not intersect plane.');
+          return camera;
+        }
+        const hitPt = depthBuffer != null
+          ? this.getWorldPoint(point, depthBuffer, fallbackPt)
+          : fallbackPt;
+        const hitPlane = Plane.fromNormalAndCoplanarPoint(dir, hitPt);
+        this.zoomData = { hitPt, hitPlane };
+      }
+      if (this.zoomData != null) {
+        const { hitPlane } = this.zoomData;
+        const { position, distance, isPastHitPlane, keepCurrent } = this.computeZoomDistances(delta, camera, viewport, boundingBox, ray, this.zoomData);
+        if (isPastHitPlane && !keepCurrent) {
+          const viewVectorRay = Ray.create({
+            origin: position,
+            direction: Vector3.normalize(camera.viewVector),
+          });
+          return camera.update({
+            position,
+            lookAt: Ray.at(viewVectorRay, distance),
+          });
+        }
+        else if (!keepCurrent) {
+          return camera.update({
+            position,
+            lookAt: Plane.projectPoint(hitPlane, position),
+          });
+        }
+      }
+      return camera;
+    });
+  }
   async transformCamera(t) {
     var _a;
     if (this.isInteracting()) {
@@ -51,5 +94,64 @@ export class InteractionApiPerspective extends InteractionApi {
       await ((_a = this.currentCamera) === null || _a === void 0 ? void 0 : _a.render());
     }
   }
+  computeZoomDistances(delta, camera, viewport, boundingBox, pointRay, zoomData) {
+    const config = this.getConfig();
+    const { hitPt, hitPlane } = zoomData;
+    const minDistance = config.useMinimumPerspectiveZoomDistance
+      ? this.computeZoomMinimumDistance(camera, boundingBox)
+      : -1;
+    const expectedDistance = Vector3.distance(camera.position, hitPt);
+    const actualDistance = Math.max(minDistance, expectedDistance);
+    const epsilon = (6 * actualDistance * delta) / viewport.height;
+    const expectedPosition = Ray.at(pointRay, epsilon);
+    const expectedViewVector = Ray.create({
+      origin: expectedPosition,
+      direction: Vector3.normalize(camera.viewVector),
+    });
+    const expectedIntersection = Ray.intersectPlane(expectedViewVector, hitPlane);
+    if (expectedIntersection == null &&
+      config.useMinimumPerspectiveZoomDistance) {
+      const minDistanceEpsilon = (6 * minDistance * delta) / viewport.height;
+      const position = Ray.at(pointRay, minDistanceEpsilon);
+      return {
+        position,
+        distance: minDistance,
+        isPastHitPlane: true,
+        keepCurrent: false,
+      };
+    }
+    else if (expectedIntersection == null) {
+      return {
+        position: camera.position,
+        distance: actualDistance,
+        isPastHitPlane: true,
+        keepCurrent: true,
+      };
+    }
+    return {
+      position: expectedPosition,
+      distance: actualDistance,
+      isPastHitPlane: false,
+      keepCurrent: false,
+    };
+  }
+  computeZoomMinimumDistance(camera, boundingBox) {
+    const xLength = Math.abs(boundingBox.min.x) + Math.abs(boundingBox.max.x);
+    const yLength = Math.abs(boundingBox.min.y) + Math.abs(boundingBox.max.y);
+    const zLength = Math.abs(boundingBox.min.z) + Math.abs(boundingBox.max.z);
+    const maxLength = Math.max(xLength, yLength, zLength);
+    const absDotX = Math.abs(Vector3.dot(Vector3.normalize(camera.viewVector), Vector3.right()));
+    const absDotY = Math.abs(Vector3.dot(Vector3.normalize(camera.viewVector), Vector3.up()));
+    const absDotZ = Math.abs(Vector3.dot(Vector3.normalize(camera.viewVector), Vector3.back()));
+    const scaledLengthX = xLength * absDotX;
+    const scaledLengthY = yLength * absDotY;
+    const scaledLengthZ = zLength * absDotZ;
+    const relevanceLengthX = maxLength / xLength;
+    const relevanceLengthY = maxLength / yLength;
+    const relevanceLengthZ = maxLength / zLength;
+    return (((scaledLengthX + scaledLengthY + scaledLengthZ) /
+      (relevanceLengthX + relevanceLengthY + relevanceLengthZ)) *
+      CAMERA_MIN_ZOOM_SCALAR);
+  }
 }
 //# sourceMappingURL=interactionApiPerspective.js.map

package/dist/collection/lib/interactions/interactionApiPerspective.js.map

@@ -1 +1 @@
-{"version":3,"file":"interactionApiPerspective.js","sourceRoot":"","sources":["../../../src/lib/interactions/interactionApiPerspective.ts"],"names":[],"mappings":"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","sourcesContent":["import { EventEmitter } from '@stencil/core';\nimport { Point, Vector3 } from '@vertexvis/geometry';\nimport { StreamApi } from '@vertexvis/stream-api';\n\nimport { ReceivedFrame } from '../..';\nimport { CursorManager } from '../cursors';\nimport { PerspectiveCamera } from '../scenes';\nimport { Viewport } from '../types';\nimport {\n  CameraTransform,\n  InteractionApi,\n  InteractionConfigProvider,\n  SceneProvider,\n} from './interactionApi';\nimport { TapEventDetails } from './tapEventDetails';\n\nexport class InteractionApiPerspective extends InteractionApi {\n  public constructor(\n    stream: StreamApi,\n    cursors: CursorManager,\n    getConfig: InteractionConfigProvider,\n    getScene: SceneProvider,\n    getFrame: () => ReceivedFrame | undefined,\n    getViewport: () => Viewport,\n    tapEmitter: EventEmitter<TapEventDetails>,\n    doubleTapEmitter: EventEmitter<TapEventDetails>,\n    longPressEmitter: EventEmitter<TapEventDetails>,\n    interactionStartedEmitter: EventEmitter<void>,\n    interactionFinishedEmitter: EventEmitter<void>\n  ) {\n    super(\n      stream,\n      cursors,\n      getConfig,\n      getScene,\n      getFrame,\n      getViewport,\n      tapEmitter,\n      doubleTapEmitter,\n      longPressEmitter,\n      interactionStartedEmitter,\n      interactionFinishedEmitter\n    );\n  }\n\n  /**\n   * Performs a pan operation of the scene's camera, and requests a new image\n   * for the updated scene.\n   *\n   * @param delta A position delta `{x, y}` in the 2D coordinate space of the\n   *  viewer.\n   */\n  public async panCameraByDelta(delta: Point.Point): Promise<void> {\n    return this.transformCamera(({ camera, viewport }) => {\n      const vv = camera.viewVector;\n\n      const u = Vector3.normalize(camera.up);\n      const v = Vector3.normalize(vv);\n\n      const throttledDelta = Point.scale(delta, 0.25, 0.25);\n      const d = Vector3.magnitude(vv) * Math.tan(camera.fovY ?? 45);\n      const epsilonX = (throttledDelta.x * d) / viewport.width;\n      const epsilonY = (throttledDelta.y / viewport.width) * d;\n\n      const xvec = Vector3.cross(u, v);\n      const yvec = Vector3.cross(v, xvec);\n\n      const offset = Vector3.add(\n        Vector3.scale(epsilonX, xvec),\n        Vector3.scale(epsilonY, yvec)\n      );\n\n      return camera.moveBy(offset);\n    });\n  }\n\n  public async transformCamera(\n    t: CameraTransform<PerspectiveCamera>\n  ): Promise<void> {\n    if (this.isInteracting()) {\n      const scene = await this.getScene();\n      const viewport = this.getViewport();\n      const frame = this.getFrame();\n      const depthBuffer = await frame?.depthBuffer();\n\n      this.currentCamera =\n        this.currentCamera != null && viewport != null && frame != null\n          ? t({\n              camera: this.currentCamera as PerspectiveCamera,\n              viewport,\n              scale: scene.scale(),\n              boundingBox: scene.boundingBox(),\n              frame,\n              depthBuffer,\n            })\n          : undefined;\n\n      await this.currentCamera?.render();\n    }\n  }\n}\n"]}
+{"version":3,"file":"interactionApiPerspective.js","sourceRoot":"","sources":["../../../src/lib/interactions/interactionApiPerspective.ts"],"names":[],"mappings":"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","sourcesContent":["import { EventEmitter } from '@stencil/core';\nimport { BoundingBox, Plane, Point, Ray, Vector3 } from '@vertexvis/geometry';\nimport { StreamApi } from '@vertexvis/stream-api';\n\nimport { ReceivedFrame } from '../..';\nimport { CursorManager } from '../cursors';\nimport { PerspectiveCamera } from '../scenes';\nimport { Viewport } from '../types';\nimport {\n  CameraTransform,\n  InteractionApi,\n  InteractionConfigProvider,\n  SceneProvider,\n  ZoomData,\n} from './interactionApi';\nimport { TapEventDetails } from './tapEventDetails';\n\ninterface ZoomPositionData {\n  position: Vector3.Vector3;\n  distance: number;\n  isPastHitPlane: boolean;\n  keepCurrent: boolean;\n}\n\nconst CAMERA_MIN_ZOOM_SCALAR = 0.2;\n\nexport class InteractionApiPerspective extends InteractionApi {\n  public constructor(\n    stream: StreamApi,\n    cursors: CursorManager,\n    getConfig: InteractionConfigProvider,\n    getScene: SceneProvider,\n    getFrame: () => ReceivedFrame | undefined,\n    getViewport: () => Viewport,\n    tapEmitter: EventEmitter<TapEventDetails>,\n    doubleTapEmitter: EventEmitter<TapEventDetails>,\n    longPressEmitter: EventEmitter<TapEventDetails>,\n    interactionStartedEmitter: EventEmitter<void>,\n    interactionFinishedEmitter: EventEmitter<void>\n  ) {\n    super(\n      stream,\n      cursors,\n      getConfig,\n      getScene,\n      getFrame,\n      getViewport,\n      tapEmitter,\n      doubleTapEmitter,\n      longPressEmitter,\n      interactionStartedEmitter,\n      interactionFinishedEmitter\n    );\n  }\n\n  /**\n   * Performs a pan operation of the scene's camera, and requests a new image\n   * for the updated scene.\n   *\n   * @param delta A position delta `{x, y}` in the 2D coordinate space of the\n   *  viewer.\n   */\n  public async panCameraByDelta(delta: Point.Point): Promise<void> {\n    return this.transformCamera(({ camera, viewport }) => {\n      const vv = camera.viewVector;\n\n      const u = Vector3.normalize(camera.up);\n      const v = Vector3.normalize(vv);\n\n      const throttledDelta = Point.scale(delta, 0.25, 0.25);\n      const d = Vector3.magnitude(vv) * Math.tan(camera.fovY ?? 45);\n      const epsilonX = (throttledDelta.x * d) / viewport.width;\n      const epsilonY = (throttledDelta.y / viewport.width) * d;\n\n      const xvec = Vector3.cross(u, v);\n      const yvec = Vector3.cross(v, xvec);\n\n      const offset = Vector3.add(\n        Vector3.scale(epsilonX, xvec),\n        Vector3.scale(epsilonY, yvec)\n      );\n\n      return camera.moveBy(offset);\n    });\n  }\n\n  public async zoomCameraToPoint(\n    point: Point.Point,\n    delta: number\n  ): Promise<void> {\n    return this.transformCamera(\n      ({ camera, viewport, frame, depthBuffer, boundingBox }) => {\n        const cam = frame.scene.camera;\n        const dir = cam.direction;\n\n        const frameCam = camera.toFrameCamera();\n        const ray = viewport.transformPointToRay(point, frame.image, frameCam);\n\n        if (this.zoomData == null) {\n          const fallbackPlane = Plane.fromNormalAndCoplanarPoint(\n            dir,\n            cam.lookAt\n          );\n          const fallbackPt = Ray.intersectPlane(ray, fallbackPlane);\n          if (fallbackPt == null) {\n            console.warn(\n              'Cannot determine fallback point for zoom. Ray does not intersect plane.'\n            );\n            return camera;\n          }\n\n          const hitPt =\n            depthBuffer != null\n              ? this.getWorldPoint(point, depthBuffer, fallbackPt)\n              : fallbackPt;\n          const hitPlane = Plane.fromNormalAndCoplanarPoint(dir, hitPt);\n          this.zoomData = { hitPt, hitPlane };\n        }\n\n        if (this.zoomData != null) {\n          const { hitPlane } = this.zoomData;\n          const { position, distance, isPastHitPlane, keepCurrent } =\n            this.computeZoomDistances(\n              delta,\n              camera,\n              viewport,\n              boundingBox,\n              ray,\n              this.zoomData\n            );\n\n          if (isPastHitPlane && !keepCurrent) {\n            const viewVectorRay = Ray.create({\n              origin: position,\n              direction: Vector3.normalize(camera.viewVector),\n            });\n\n            return camera.update({\n              position,\n              lookAt: Ray.at(viewVectorRay, distance),\n            });\n          } else if (!keepCurrent) {\n            return camera.update({\n              position,\n              lookAt: Plane.projectPoint(hitPlane, position),\n            });\n          }\n        }\n        return camera;\n      }\n    );\n  }\n\n  public async transformCamera(\n    t: CameraTransform<PerspectiveCamera>\n  ): Promise<void> {\n    if (this.isInteracting()) {\n      const scene = await this.getScene();\n      const viewport = this.getViewport();\n      const frame = this.getFrame();\n      const depthBuffer = await frame?.depthBuffer();\n\n      this.currentCamera =\n        this.currentCamera != null && viewport != null && frame != null\n          ? t({\n              camera: this.currentCamera as PerspectiveCamera,\n              viewport,\n              scale: scene.scale(),\n              boundingBox: scene.boundingBox(),\n              frame,\n              depthBuffer,\n            })\n          : undefined;\n\n      await this.currentCamera?.render();\n    }\n  }\n\n  private computeZoomDistances(\n    delta: number,\n    camera: PerspectiveCamera,\n    viewport: Viewport,\n    boundingBox: BoundingBox.BoundingBox,\n    pointRay: Ray.Ray,\n    zoomData: ZoomData\n  ): ZoomPositionData {\n    const config = this.getConfig();\n    const { hitPt, hitPlane } = zoomData;\n    const minDistance = config.useMinimumPerspectiveZoomDistance\n      ? this.computeZoomMinimumDistance(camera, boundingBox)\n      : -1;\n    const expectedDistance = Vector3.distance(camera.position, hitPt);\n    const actualDistance = Math.max(minDistance, expectedDistance);\n    const epsilon = (6 * actualDistance * delta) / viewport.height;\n\n    const expectedPosition = Ray.at(pointRay, epsilon);\n    const expectedViewVector = Ray.create({\n      origin: expectedPosition,\n      direction: Vector3.normalize(camera.viewVector),\n    });\n    const expectedIntersection = Ray.intersectPlane(\n      expectedViewVector,\n      hitPlane\n    );\n\n    if (\n      expectedIntersection == null &&\n      config.useMinimumPerspectiveZoomDistance\n    ) {\n      const minDistanceEpsilon = (6 * minDistance * delta) / viewport.height;\n      const position = Ray.at(pointRay, minDistanceEpsilon);\n\n      return {\n        position,\n        distance: minDistance,\n        isPastHitPlane: true,\n        keepCurrent: false,\n      };\n    } else if (expectedIntersection == null) {\n      return {\n        position: camera.position,\n        distance: actualDistance,\n        isPastHitPlane: true,\n        keepCurrent: true,\n      };\n    }\n\n    return {\n      position: expectedPosition,\n      distance: actualDistance,\n      isPastHitPlane: false,\n      keepCurrent: false,\n    };\n  }\n\n  private computeZoomMinimumDistance(\n    camera: PerspectiveCamera,\n    boundingBox: BoundingBox.BoundingBox\n  ): number {\n    const xLength = Math.abs(boundingBox.min.x) + Math.abs(boundingBox.max.x);\n    const yLength = Math.abs(boundingBox.min.y) + Math.abs(boundingBox.max.y);\n    const zLength = Math.abs(boundingBox.min.z) + Math.abs(boundingBox.max.z);\n    const maxLength = Math.max(xLength, yLength, zLength);\n\n    const absDotX = Math.abs(\n      Vector3.dot(Vector3.normalize(camera.viewVector), Vector3.right())\n    );\n    const absDotY = Math.abs(\n      Vector3.dot(Vector3.normalize(camera.viewVector), Vector3.up())\n    );\n    const absDotZ = Math.abs(\n      Vector3.dot(Vector3.normalize(camera.viewVector), Vector3.back())\n    );\n\n    const scaledLengthX = xLength * absDotX;\n    const scaledLengthY = yLength * absDotY;\n    const scaledLengthZ = zLength * absDotZ;\n\n    const relevanceLengthX = maxLength / xLength;\n    const relevanceLengthY = maxLength / yLength;\n    const relevanceLengthZ = maxLength / zLength;\n\n    return (\n      ((scaledLengthX + scaledLengthY + scaledLengthZ) /\n        (relevanceLengthX + relevanceLengthY + relevanceLengthZ)) *\n      CAMERA_MIN_ZOOM_SCALAR\n    );\n  }\n}\n"]}

package/dist/collection/lib/types/interactions.js

@@ -5,5 +5,6 @@ export const defaultInteractionConfig = {
   finePointerThreshold: 1,
   coarsePointerThreshold: 3,
   interactionDelay: 75,
+  useMinimumPerspectiveZoomDistance: true,
 };
 //# sourceMappingURL=interactions.js.map

package/dist/collection/lib/types/interactions.js.map

@@ -1 +1 @@
-{"version":3,"file":"interactions.js","sourceRoot":"","sources":["../../../src/lib/types/interactions.ts"],"names":[],"mappings":"AAsBA,MAAM,CAAC,MAAM,wBAAwB,GAAsB;EACzD,oBAAoB,EAAE,CAAC;EACvB,sBAAsB,EAAE,CAAC;EACzB,gBAAgB,EAAE,EAAE;CACrB,CAAC","sourcesContent":["export interface InteractionConfig {\n  /**\n   * The amount of movement required with a fine (mouse, trackpad, etc) pointer\n   * input before an interaction is considered a movement that will update the\n   * camera. This threshold is always scaled up based on the device's pixel ratio.\n   */\n  finePointerThreshold: number;\n\n  /**\n   * The amount of movement required with a coarse (touch, stylus, etc) pointer\n   * input before an interaction is considered a movement that will update the\n   * camera. This threshold is always scaled up based on the device's pixel ratio.\n   */\n  coarsePointerThreshold: number;\n\n  /**\n   * The amount of time before a movement is considered an interaction and will\n   * update the camera.\n   */\n  interactionDelay: number;\n}\n\nexport const defaultInteractionConfig: InteractionConfig = {\n  finePointerThreshold: 1,\n  coarsePointerThreshold: 3,\n  interactionDelay: 75,\n};\n"]}
+{"version":3,"file":"interactions.js","sourceRoot":"","sources":["../../../src/lib/types/interactions.ts"],"names":[],"mappings":"AA8BA,MAAM,CAAC,MAAM,wBAAwB,GAAsB;EACzD,oBAAoB,EAAE,CAAC;EACvB,sBAAsB,EAAE,CAAC;EACzB,gBAAgB,EAAE,EAAE;EACpB,iCAAiC,EAAE,IAAI;CACxC,CAAC","sourcesContent":["export interface InteractionConfig {\n  /**\n   * The amount of movement required with a fine (mouse, trackpad, etc) pointer\n   * input before an interaction is considered a movement that will update the\n   * camera. This threshold is always scaled up based on the device's pixel ratio.\n   */\n  finePointerThreshold: number;\n\n  /**\n   * The amount of movement required with a coarse (touch, stylus, etc) pointer\n   * input before an interaction is considered a movement that will update the\n   * camera. This threshold is always scaled up based on the device's pixel ratio.\n   */\n  coarsePointerThreshold: number;\n\n  /**\n   * The amount of time before a movement is considered an interaction and will\n   * update the camera.\n   */\n  interactionDelay: number;\n\n  /**\n   * Whether the `zoomCameraToPoint` interaction through the `InteractionApiPerspective`\n   * will enforce a minimum distance when moving the camera. When set, the camera will be\n   * able to move through geometry under the cursor, rather than being restricted by the\n   * point under the cursor. Defaults to `true`.\n   */\n  useMinimumPerspectiveZoomDistance: boolean;\n}\n\nexport const defaultInteractionConfig: InteractionConfig = {\n  finePointerThreshold: 1,\n  coarsePointerThreshold: 3,\n  interactionDelay: 75,\n  useMinimumPerspectiveZoomDistance: true,\n};\n"]}

package/dist/custom-elements/index.js

@@ -12218,7 +12218,7 @@ class SceneTreeController {
     this.pages = new Map();
     this.activeRowRange = [0, 0];
     this.metadataKeys = [];
-    this.debugLogs = false;
+    this.debugLogs = true;
     /**
      * A dispatcher that emits an event whenever the internal state has changed.
      */
@@ -12432,6 +12432,7 @@ class SceneTreeController {
         ? undefined
         : this.state.shouldShowEmptyResults,
       handshakeReceived: reset ? undefined : this.state.handshakeReceived,
+      firstFetchComplete: reset ? undefined : this.state.firstFetchComplete,
     });
   }
   cancel() {
@@ -12724,6 +12725,14 @@ class SceneTreeController {
         if (msg.hasHandshake()) {
           this.clearHandshakeTimer();
           this.updateState(Object.assign(Object.assign({}, this.state), { handshakeReceived: true }));
+          // Verify that we've loaded the first page of the tree when we receive
+          // a handshake in the case that the listener was not fully registered
+          // when a `ListChange` was sent.
+          if (this.state.firstFetchComplete) {
+            this.log('Scene tree did not have the first page before the handshake completed');
+            this.invalidateAfterOffset(0);
+            this.fetchUnloadedPagesInActiveRows();
+          }
         }
         this.startIdleReconnectTimer();
         const { change } = msg.toObject();
@@ -12819,7 +12828,7 @@ class SceneTreeController {
         }
         else {
           this.updateState(Object.assign(Object.assign({}, this.state), { totalRows: totalRows, rows: rows, shouldShowLoading: rows.length === 0 && this.state.shouldShowLoading, shouldShowEmptyResults: this.state.filterTerm != null &&
-              (rows.length === 0 || this.state.totalFilteredRows === 0) }));
+              (rows.length === 0 || this.state.totalFilteredRows === 0), firstFetchComplete: true }));
         }
       }
     }
@@ -65474,6 +65483,7 @@ const defaultInteractionConfig = {
   finePointerThreshold: 1,
   coarsePointerThreshold: 3,
   interactionDelay: 75,
+  useMinimumPerspectiveZoomDistance: true,
 };
 
 function fromUrn(urn) {
@@ -110951,40 +110961,6 @@ class InteractionApi {
       return newCamera;
     });
   }
-  async zoomCameraToPoint(point, delta) {
-    return this.transformCamera(({ camera, viewport, frame, depthBuffer }) => {
-      const cam = frame.scene.camera;
-      const dir = cam.direction;
-      const frameCam = camera.toFrameCamera();
-      const ray$1 = viewport.transformPointToRay(point, frame.image, frameCam);
-      if (this.zoomData == null) {
-        const fallbackPlane = plane.fromNormalAndCoplanarPoint(dir, cam.lookAt);
-        const fallbackPt = ray.intersectPlane(ray$1, fallbackPlane);
-        if (fallbackPt == null) {
-          console.warn('Cannot determine fallback point for zoom. Ray does not intersect plane.');
-          return camera;
-        }
-        const hitPt = depthBuffer != null
-          ? this.getWorldPoint(point, depthBuffer, fallbackPt)
-          : fallbackPt;
-        const hitPlane = plane.fromNormalAndCoplanarPoint(dir, hitPt);
-        this.zoomData = { hitPt, hitPlane };
-      }
-      if (this.zoomData != null) {
-        const { hitPt, hitPlane } = this.zoomData;
-        const distance = vector3.distance(camera.position, hitPt);
-        const epsilon = (6 * distance * delta) / viewport.height;
-        const position = ray.at(ray$1, epsilon);
-        const lookAt = plane.projectPoint(hitPlane, position);
-        const newCamera = camera.update({ position, lookAt });
-        const newDistance = vector3.distance(position, lookAt);
-        if (newDistance >= newCamera.near) {
-          return newCamera;
-        }
-      }
-      return camera;
-    });
-  }
   /**
    * Performs a pivot operation of the scene's camera, updating the lookAt
    * while maintaining the position, and requests a new image for the
@@ -111236,6 +111212,7 @@ class InteractionApiOrthographic extends InteractionApi {
   }
 }
 
+const CAMERA_MIN_ZOOM_SCALAR = 0.2;
 class InteractionApiPerspective extends InteractionApi {
   constructor(stream, cursors, getConfig, getScene, getFrame, getViewport, tapEmitter, doubleTapEmitter, longPressEmitter, interactionStartedEmitter, interactionFinishedEmitter) {
     super(stream, cursors, getConfig, getScene, getFrame, getViewport, tapEmitter, doubleTapEmitter, longPressEmitter, interactionStartedEmitter, interactionFinishedEmitter);
@@ -111263,6 +111240,48 @@ class InteractionApiPerspective extends InteractionApi {
       return camera.moveBy(offset);
     });
   }
+  async zoomCameraToPoint(point, delta) {
+    return this.transformCamera(({ camera, viewport, frame, depthBuffer, boundingBox }) => {
+      const cam = frame.scene.camera;
+      const dir = cam.direction;
+      const frameCam = camera.toFrameCamera();
+      const ray$1 = viewport.transformPointToRay(point, frame.image, frameCam);
+      if (this.zoomData == null) {
+        const fallbackPlane = plane.fromNormalAndCoplanarPoint(dir, cam.lookAt);
+        const fallbackPt = ray.intersectPlane(ray$1, fallbackPlane);
+        if (fallbackPt == null) {
+          console.warn('Cannot determine fallback point for zoom. Ray does not intersect plane.');
+          return camera;
+        }
+        const hitPt = depthBuffer != null
+          ? this.getWorldPoint(point, depthBuffer, fallbackPt)
+          : fallbackPt;
+        const hitPlane = plane.fromNormalAndCoplanarPoint(dir, hitPt);
+        this.zoomData = { hitPt, hitPlane };
+      }
+      if (this.zoomData != null) {
+        const { hitPlane } = this.zoomData;
+        const { position, distance, isPastHitPlane, keepCurrent } = this.computeZoomDistances(delta, camera, viewport, boundingBox, ray$1, this.zoomData);
+        if (isPastHitPlane && !keepCurrent) {
+          const viewVectorRay = ray.create({
+            origin: position,
+            direction: vector3.normalize(camera.viewVector),
+          });
+          return camera.update({
+            position,
+            lookAt: ray.at(viewVectorRay, distance),
+          });
+        }
+        else if (!keepCurrent) {
+          return camera.update({
+            position,
+            lookAt: plane.projectPoint(hitPlane, position),
+          });
+        }
+      }
+      return camera;
+    });
+  }
   async transformCamera(t) {
     var _a;
     if (this.isInteracting()) {
@@ -111284,6 +111303,65 @@ class InteractionApiPerspective extends InteractionApi {
       await ((_a = this.currentCamera) === null || _a === void 0 ? void 0 : _a.render());
     }
   }
+  computeZoomDistances(delta, camera, viewport, boundingBox, pointRay, zoomData) {
+    const config = this.getConfig();
+    const { hitPt, hitPlane } = zoomData;
+    const minDistance = config.useMinimumPerspectiveZoomDistance
+      ? this.computeZoomMinimumDistance(camera, boundingBox)
+      : -1;
+    const expectedDistance = vector3.distance(camera.position, hitPt);
+    const actualDistance = Math.max(minDistance, expectedDistance);
+    const epsilon = (6 * actualDistance * delta) / viewport.height;
+    const expectedPosition = ray.at(pointRay, epsilon);
+    const expectedViewVector = ray.create({
+      origin: expectedPosition,
+      direction: vector3.normalize(camera.viewVector),
+    });
+    const expectedIntersection = ray.intersectPlane(expectedViewVector, hitPlane);
+    if (expectedIntersection == null &&
+      config.useMinimumPerspectiveZoomDistance) {
+      const minDistanceEpsilon = (6 * minDistance * delta) / viewport.height;
+      const position = ray.at(pointRay, minDistanceEpsilon);
+      return {
+        position,
+        distance: minDistance,
+        isPastHitPlane: true,
+        keepCurrent: false,
+      };
+    }
+    else if (expectedIntersection == null) {
+      return {
+        position: camera.position,
+        distance: actualDistance,
+        isPastHitPlane: true,
+        keepCurrent: true,
+      };
+    }
+    return {
+      position: expectedPosition,
+      distance: actualDistance,
+      isPastHitPlane: false,
+      keepCurrent: false,
+    };
+  }
+  computeZoomMinimumDistance(camera, boundingBox) {
+    const xLength = Math.abs(boundingBox.min.x) + Math.abs(boundingBox.max.x);
+    const yLength = Math.abs(boundingBox.min.y) + Math.abs(boundingBox.max.y);
+    const zLength = Math.abs(boundingBox.min.z) + Math.abs(boundingBox.max.z);
+    const maxLength = Math.max(xLength, yLength, zLength);
+    const absDotX = Math.abs(vector3.dot(vector3.normalize(camera.viewVector), vector3.right()));
+    const absDotY = Math.abs(vector3.dot(vector3.normalize(camera.viewVector), vector3.up()));
+    const absDotZ = Math.abs(vector3.dot(vector3.normalize(camera.viewVector), vector3.back()));
+    const scaledLengthX = xLength * absDotX;
+    const scaledLengthY = yLength * absDotY;
+    const scaledLengthZ = zLength * absDotZ;
+    const relevanceLengthX = maxLength / xLength;
+    const relevanceLengthY = maxLength / yLength;
+    const relevanceLengthZ = maxLength / zLength;
+    return (((scaledLengthX + scaledLengthY + scaledLengthZ) /
+      (relevanceLengthX + relevanceLengthY + relevanceLengthZ)) *
+      CAMERA_MIN_ZOOM_SCALAR);
+  }
 }
 
 class FlyToPositionKeyInteraction {