@needle-tools/engine 5.1.4 → 5.1.5

package/dist/needle-engine.d.ts

@@ -118,13 +118,13 @@ export declare const $componentName: unique symbol;
 
 export declare const $physicsKey: unique symbol;
 
+/* Excluded from this release type: $PLKRCQIf */
+
 export declare class __Ignore {
 }
 
 export declare function __internalNotifyObjectDestroyed(obj: Object3D): void;
 
-/* Excluded from this release type: __QhCnOwd */
-
 /** Data describing the accessible semantics for a 3D object or component. */
 declare type AccessibilityData = {
     /** ARIA role (e.g. `"button"`, `"img"`, `"region"`). */
@@ -7965,6 +7965,8 @@ export declare class GltfExportBox extends BoxHelperComponent {
     sceneRoot?: Object3D;
 }
 
+/* Excluded from this release type: _gNHPUn */
+
 /** Projects the grabbed attachment point back onto a plane after position is resolved,
  *  with optional grid snapping on that plane.
  *  Owned by the strategy that requires plane-clamping (e.g. {@link XZPlaneDragStrategy}). */
@@ -10557,8 +10559,6 @@ declare type KF_2<V> = AnimationKeyframe<V>[] | Tween<V>;
 /** Keyframe array or tween shorthand */
 declare type KF_3<V> = AnimationKeyframe<V>[] | Tween<V>;
 
-/* Excluded from this release type: KLaEb */
-
 declare type LabelHandle = {
     setText(str: string): any;
 };
@@ -14735,6 +14735,8 @@ export declare class OrbitControls extends Component implements ICameraControlle
          immediate?: boolean;
      };
 
+     /* Excluded from this release type: otIKt */
+
      /**
       * [Outline](https://engine.needle.tools/docs/api/Outline) is a UI component that adds an outline effect to UI elements.
       * You can customize the outline color and distance to create a visual border around the UI element.
@@ -19871,8 +19873,11 @@ export declare class OrbitControls extends Component implements ICameraControlle
 
      /**
       * Used by {@link SnapToSurfacesDragStrategy} for two-pointer (multi-touch) drags.
-      * Casts a downward ray each frame from the follow object's world position and adjusts
-      * it so the dragged object's bounding-box contact face rests on the detected surface.
+      * Each frame `MultiTouchDragHandler` aims the snap ray from the pointer origin(s) through the
+      * current two-finger grab midpoint (see {@link setRay}); apply() casts that ray into the scene
+      * and places the follow object so its bounding-box contact face rests on the hit surface with
+      * the object origin at the hit point — the same "snap to what the pointer points at" semantics
+      * as the single-pointer surface raycast.
       *
       * Only injected into the constraint pipeline for multi-touch; the single-pointer path
       * continues to use {@link SnapToSurfacesDragStrategy.update} (pointer ray + drag plane
@@ -19882,12 +19887,18 @@ export declare class OrbitControls extends Component implements ICameraControlle
          private readonly _context;
          private _gameObject;
          private _boundsAtScaleOne;
+         /** Snap ray for the current frame. Valid only after {@link setRay}; apply() is a no-op until then. */
+         private readonly _ray;
+         private _hasRay;
          private readonly _t1;
          private readonly _t2;
          private readonly _t3;
          private readonly _t4;
          constructor(_context: Context);
          init(ctx: IDragConstraintContext): void;
+         /** Sets the world-space snap ray for this frame. Called by `MultiTouchDragHandler` before the
+          *  constraint pipeline runs. `direction` must be normalized. */
+         setRay(origin: Vector3, direction: Vector3): void;
          apply(followObject: GameObject): void;
      }
 
@@ -24799,8 +24810,6 @@ export declare class OrbitControls extends Component implements ICameraControlle
          constructor(context: WebXRImageTracking, trackedImage: WebXRImageTrackingModel, bitmap: ImageBitmap, measuredSize: number, state: "tracked" | "emulated", pose: any);
      }
 
-     /* Excluded from this release type: wPA */
-
      export declare type WriteCallback = (data: any, prop: string) => void;
 
      /** Button names as used in the xr profile */
@@ -25121,28 +25130,6 @@ export declare class OrbitControls extends Component implements ICameraControlle
      export { }
 
 
-declare module 'three' {
-    interface SkinnedMesh {
-        staticGenerator?: StaticGeometryGenerator;
-        staticGeometry?: BufferGeometry;
-        staticGeometryLastUpdate?: number;
-    }
-    interface Mesh {
-        acceleratedRaycast?: any;
-    }
-    interface SkinnedMesh {
-        /** @deprecated use autoUpdateMeshBvhInterval */
-        autoUpdateMeshBVH?: boolean;
-        /**
-         * Interval in milliseconds to automatically update the mesh BVH. When set to >= 0 the BVH will be updated every x milliseconds.
-         * @default undefined (disabled)
-         */
-        autoUpdateMeshBvhInterval?: number;
-        bvhNeedsUpdate?: boolean;
-    }
-}
-
-
 declare module 'three' {
     interface Object3D {
         get guid(): string | undefined;
@@ -25290,6 +25277,28 @@ declare module 'three' {
 }
 
 
+declare module 'three' {
+    interface SkinnedMesh {
+        staticGenerator?: StaticGeometryGenerator;
+        staticGeometry?: BufferGeometry;
+        staticGeometryLastUpdate?: number;
+    }
+    interface Mesh {
+        acceleratedRaycast?: any;
+    }
+    interface SkinnedMesh {
+        /** @deprecated use autoUpdateMeshBvhInterval */
+        autoUpdateMeshBVH?: boolean;
+        /**
+         * Interval in milliseconds to automatically update the mesh BVH. When set to >= 0 the BVH will be updated every x milliseconds.
+         * @default undefined (disabled)
+         */
+        autoUpdateMeshBvhInterval?: number;
+        bvhNeedsUpdate?: boolean;
+    }
+}
+
+
 declare module 'three/examples/jsm/controls/OrbitControls.js' {
     interface OrbitControls {
         _sphericalDelta: import("three").Spherical;