@needle-tools/engine 5.1.0 → 5.1.2

package/dist/needle-engine.d.ts

@@ -116,14 +116,12 @@ import { XRControllerModelFactory } from '../../../../node_modules/@types/three/
 import { XRHandMeshModel } from '../../../../node_modules/@types/three/examples/jsm/webxr/XRHandMeshModel.js';
 import { XRHandSpace } from 'three';
 
-export declare const $componentName: unique symbol;
+/* Excluded from this release type: _$apSvAt */
 
-/* Excluded from this release type: $iujBhf */
+export declare const $componentName: unique symbol;
 
 export declare const $physicsKey: unique symbol;
 
-/* Excluded from this release type: $RHhhju */
-
 export declare class __Ignore {
 }
 
@@ -2124,6 +2122,8 @@ export declare class Avatar extends Component {
     rightHand?: AssetReference;
     private _leftHandMeshes?;
     private _rightHandMeshes?;
+    private _remoteLeftHandMeshes?;
+    private _remoteRightHandMeshes?;
     private _syncTransforms?;
     onEnterXR(_args: NeedleXREventArgs): Promise<void>;
     onLeaveXR(_args: NeedleXREventArgs): void;
@@ -2131,6 +2131,12 @@ export declare class Avatar extends Component {
     onBeforeRender(): void;
     private updateHandVisibility;
     private updateRemoteAvatarVisibility;
+    /**
+     * Show/hide a remote avatar hand render-only. The hand object stays active so its SyncedTransform keeps
+     * applying networked updates (toggling `.visible` would deactivate it and could free the owner's ownership).
+     * The mesh list is gathered lazily and cached, and returned so the caller can keep it.
+     */
+    private setRemoteHandRendered;
     private tryFindAvatarObjectsIfMissing;
     private prepareAvatar;
     private loadAvatarObjects;
@@ -8594,6 +8600,8 @@ export declare class HoverAnimation extends Component {
 /** SSR-safe base class for web components. */
 declare const HTMLElementBase: typeof HTMLElement;
 
+/* Excluded from this release type: _hyjgv */
+
 export declare type IAnimationComponent = Pick<IComponent, "gameObject"> & {
     isAnimationComponent: boolean;
     addClip?(clip: AnimationClip): void;
@@ -10495,6 +10503,8 @@ export declare interface IXRRig extends Pick<IComponent, "gameObject"> {
     priority?: number;
 }
 
+/* Excluded from this release type: Jkdun */
+
 /** Received when listening to `RoomEvents.JoinedRoom` event */
 export declare class JoinedRoomResponse {
     room: string;
@@ -12884,7 +12894,9 @@ export declare class NeedleXRSession implements INeedleXRSession {
      *
      * **IMPORTANT**: the resulting URL must exactly match an App Clip experience URL you have registered (with custom card metadata).
      * For this reason the URL is opened as-is, without appending any query parameters.
-     * @link https://appclip.needle.tools
+     *
+     * Note: custom App Clip branding requires an active PRO subscription. See the iOS WebXR App Clip docs (Custom Branding for iOS AR).
+     * @link https://engine.needle.tools/docs/how-to-guides/xr/ios-webxr-app-clip#custom-branding-for-ios-ar
      */
     static get appClipUrl(): string | null;
     static set appClipUrl(value: string | null);
@@ -12922,6 +12934,10 @@ export declare class NeedleXRSession implements INeedleXRSession {
      */
     static isSessionSupported(mode: XRSessionMode): Promise<boolean>;
     private static _sessionSupportedCache;
+    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. */
+    private static ensureDeviceChangeInvalidation;
     private static _currentSessionRequest?;
     private static _activeSession;
     /** Register to listen to XRSession start events. Unsubscribe with `offXRSessionStart` */
@@ -18071,8 +18087,6 @@ export declare class OrbitControls extends Component implements ICameraControlle
          evaluate(t01: number, t: number): number;
      }
 
-     /* Excluded from this release type: rXELCf */
-
      export declare function sanitizeString(str: any): string;
 
      /** Download a image (must be a data url).
@@ -21307,17 +21321,21 @@ export declare class OrbitControls extends Component implements ICameraControlle
          interpolatePosition: boolean;
          /** Whether to smoothly interpolate rotation changes when receiving updates */
          interpolateRotation: boolean;
+         /** Whether to smoothly interpolate scale changes when receiving updates */
+         interpolateScale: boolean;
          /** When true, sends updates at a higher frequency, useful for fast-moving objects */
          fastMode: boolean;
          /** When true, notifies other clients when this object is destroyed */
          syncDestroy: boolean;
          private _model;
          private _needsUpdate;
+         private _hadOwnershipBeforeDisable;
          private rb;
          private _wasKinematic;
          private _receivedDataBefore;
          private _targetPosition;
          private _targetRotation;
+         private _targetScale;
          private _receivedFastUpdate;
          private _shouldRequestOwnership;
          /**