@needle-tools/engine 5.1.3 → 5.1.4

package/dist/needle-engine.d.ts

@@ -123,7 +123,7 @@ export declare class __Ignore {
 
 export declare function __internalNotifyObjectDestroyed(obj: Object3D): void;
 
-/* Excluded from this release type: __OBvkie */
+/* Excluded from this release type: __QhCnOwd */
 
 /** Data describing the accessible semantics for a 3D object or component. */
 declare type AccessibilityData = {
@@ -9745,7 +9745,8 @@ export declare class Interactable extends Component {
 export declare namespace InternalScreenshotUtils {
     /**
      * Screenshot rendering for AR
-     * @param args
+     * @param args Set `skipCameraImage` to render only the 3D layer with a transparent background
+     * (used when the camera feed is composited elsewhere, e.g. natively in the Needle Go App Clip)
      * @returns The canvas with the screenshot
      */
     export function compositeWithCameraImage(args: {
@@ -9754,6 +9755,7 @@ export declare namespace InternalScreenshotUtils {
         renderer: WebGLRenderer;
         width: number;
         height: number;
+        skipCameraImage?: boolean;
     }): HTMLCanvasElement;
     export type FullscreenPlane = Mesh & {
         setTexture: (texture: Texture) => void;
@@ -10555,6 +10557,8 @@ 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;
 };
@@ -12879,7 +12883,10 @@ export declare class NeedleXRSession implements INeedleXRSession {
      * @returns true if the browser supports the given XRSessionMode
      */
     static isSessionSupported(mode: XRSessionMode): Promise<boolean>;
+    /** Resolved support results, kept as booleans so call sites can read them synchronously (e.g. the iOS AppClip path). */
     private static _sessionSupportedCache;
+    /** In-flight probes, to de-duplicate concurrent isSessionSupported() calls per mode. */
+    private static _sessionSupportedInFlight;
     private static _deviceChangeHooked;
     /** Invalidate the support cache when the set of XR devices changes, so a newly
      * connected headset is picked up by the next isSessionSupported() call. */
@@ -14024,8 +14031,6 @@ export declare function offXRSessionEnd(fn: (evt: XRSessionEventArgs) => void):
  */
 export declare function offXRSessionStart(fn: (evt: XRSessionEventArgs) => void): void;
 
-/* Excluded from this release type: Ojgqq */
-
 /**
  * @experimental
  * Subscribe to a DOM event on any {@link EventTarget} (window, document, HTML elements, etc.)
@@ -24794,9 +24799,9 @@ export declare class OrbitControls extends Component implements ICameraControlle
          constructor(context: WebXRImageTracking, trackedImage: WebXRImageTrackingModel, bitmap: ImageBitmap, measuredSize: number, state: "tracked" | "emulated", pose: any);
      }
 
-     export declare type WriteCallback = (data: any, prop: string) => void;
+     /* Excluded from this release type: wPA */
 
-     /* Excluded from this release type: _XCzQKUE */
+     export declare type WriteCallback = (data: any, prop: string) => void;
 
      /** Button names as used in the xr profile */
      export declare type XRControllerButtonName = "thumbrest" | "xr-standard-trigger" | "xr-standard-squeeze" | "xr-standard-thumbstick" | "xr-standard-touchpad" | "menu" | GamepadButtonName | StylusButtonName;
@@ -25116,6 +25121,28 @@ 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;
@@ -25263,28 +25290,6 @@ 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;