@preference-sl/pref-viewer 2.18.0 → 3.0.0-beta.0

package/src/babylonjs-camera-wheel-motion.js

@@ -1,7 +1,7 @@
 /**
- * Bridges native mouse-location wheel inertia to the viewer's render and navigation lifecycle.
+ * Bridges native mouse-location wheel and midpoint-pinch inertia to the viewer's render and navigation lifecycle.
  * Babylon 9.11 keeps coupled pan/radius inertia on its wheel input, outside the public
- * camera offsets. Keep that version-sensitive access here; Babylon still computes all zoom.
+ * camera offsets. Keep that version-sensitive access here; Babylon still computes all zoom and coupled focal movement.
  */
 export default class BabylonJSCameraWheelMotion {
     /**
@@ -58,6 +58,39 @@ export default class BabylonJSCameraWheelMotion {
         input._hitPlane = null;
     }
 
+    /**
+     * Queues a native coupled radius/target increment at a two-finger client midpoint.
+     * Uses the existing wheel surface/plane lookup and inertia so the scheduler, geometry guard
+     * and ViewCube cancellation retain the same owner. Scene pointer coordinates are restored
+     * synchronously even if picking throws; no synthetic wheel event or pointer hover is emitted.
+     * @param {object|null|undefined} camera - Orbital camera with native mouse-location zoom enabled.
+     * @param {number} delta - Native pinch radius increment; positive zooms inward.
+     * @param {{x:number, y:number}} center - Touch midpoint in client CSS pixels.
+     * @returns {boolean} True when queued; false leaves ordinary radial pinch as the fallback.
+     * @throws {Error} Propagates native picking failures after restoring scene pointer coordinates.
+     */
+    static zoomAtClientPoint(camera, delta, center) {
+        const input = this.#input(camera);
+        if (!input || !Number.isFinite(delta) || !delta || !center || !Number.isFinite(center.x) || !Number.isFinite(center.y)) {
+            return false;
+        }
+        const scene = camera.getScene();
+        const rect = camera.getEngine().getInputElementClientRect();
+        const previousX = scene.pointerX;
+        const previousY = scene.pointerY;
+        try {
+            scene.pointerX = center.x - (rect?.left ?? 0);
+            scene.pointerY = center.y - (rect?.top ?? 0);
+            input._updateHitPlane();
+            input._zoomToMouse(delta);
+            camera.movement.activeInput = true;
+            return true;
+        } finally {
+            scene.pointerX = previousX;
+            scene.pointerY = previousY;
+        }
+    }
+
     /**
      * Makes native mouse-location zoom focus on the model surface under the pointer.
      * Babylon otherwise intersects the pointer ray with a plane through the camera target, so the