@needle-tools/engine 5.1.0-alpha.6 → 5.1.0-canary.02ccb45

package/dist/needle-engine.d.ts

@@ -117,15 +117,17 @@ import { XRHandSpace } from 'three';
 
 export declare const $componentName: unique symbol;
 
+/* Excluded from this release type: _$HwXA */
+
 export declare const $physicsKey: unique symbol;
 
+/* Excluded from this release type: _$xxpfa */
+
 export declare class __Ignore {
 }
 
 export declare function __internalNotifyObjectDestroyed(obj: Object3D): void;
 
-/* Excluded from this release type: __otwqOR */
-
 /** Data describing the accessible semantics for a 3D object or component. */
 declare type AccessibilityData = {
     /** ARIA role (e.g. `"button"`, `"img"`, `"region"`). */
@@ -1796,7 +1798,7 @@ export { AudioListener_2 as AudioListener }
 /**
  * Defines how audio volume attenuates over distance from the listener.
  */
-declare enum AudioRolloffMode {
+export declare enum AudioRolloffMode {
     /**
      * Logarithmic rolloff provides a natural, real-world attenuation where volume decreases
      * exponentially with distance.
@@ -5422,8 +5424,6 @@ export declare class CustomShader extends RawShaderMaterial {
     onUpdateUniforms(camera?: Camera_2, obj?: any): void;
 }
 
-/* Excluded from this release type: _cxKhKwDL */
-
 export declare const debugNet: boolean;
 
 export declare const debugOwner: boolean;
@@ -10959,8 +10959,6 @@ declare class LowPassFilter {
     reset(value: number): void;
 }
 
-/* Excluded from this release type: LynjGsV */
-
 declare type MagicSkyboxName = "studio" | "blurred-skybox" | "quicklook-ar" | "quicklook";
 
 export declare class MainModule {
@@ -14470,6 +14468,7 @@ export declare class OrbitControls extends Component implements ICameraControlle
        */
       private setLookTargetFromConstraint;
       private lerpLookTarget;
+      private canFocusAtPointer;
       private setTargetFromRaycast;
       /**
        * Fits the camera to show the objects provided (defaults to the scene if no objects are passed in)
@@ -22597,6 +22596,8 @@ export declare class OrbitControls extends Component implements ICameraControlle
          userId: string;
      }
 
+     /* Excluded from this release type: UsFaeEU */
+
      /**
       * Marks a field to trigger the `onValidate` callback when its value changes.
       * Useful for reacting to property changes from the editor or at runtime.
@@ -22906,8 +22907,14 @@ export declare class OrbitControls extends Component implements ICameraControlle
          private _receivedInput;
          /* Excluded from this release type: __constructor */
          private _playErrors;
-         /** start playing the video source */
-         play(): void;
+         /**
+          * Plays the assigned video clip, URL, or MediaStream.
+          * If a `clip` argument is passed, it is used as the new video source (mirroring {@link AudioSource.play}).
+          *
+          * @param clip - Optional video URL string or {@link MediaStream} to play. If omitted, plays the currently assigned source.
+          * @returns A promise that resolves to `true` when playback was successfully started, or `false` on error.
+          */
+         play(clip?: string | MediaStream): Promise<boolean>;
          /**
           * Stop the video playback. This will reset the video to the beginning
           */
@@ -23177,9 +23184,9 @@ export declare class OrbitControls extends Component implements ICameraControlle
       * voip.createMenuButton = true;
       *
       * // Manual control
-      * voip.connect();    // Start sending audio
-      * voip.disconnect(); // Stop sending
-      * voip.setMuted(true); // Mute microphone
+      * voip.connect();    // Start sending your microphone
+      * voip.disconnect(); // Stop sending your microphone
+      * voip.setMuted(true); // Mute incoming audio (silence other users)
       * ```
       *
       * @summary Voice over IP for networked audio communication
@@ -23238,8 +23245,8 @@ export declare class OrbitControls extends Component implements ICameraControlle
           */
          get incomingStreams(): ReadonlyMap<string, HTMLAudioElement>;
          /**
-          * Threshold for speaking detection (0–255). When a user's audio amplitude exceeds this,
-          * they are considered "speaking". Default is 30.
+          * Normalized amplitude threshold for speaking detection (0–1). When a user's average
+          * audio amplitude exceeds this, they are considered "speaking". Default is 0.1.
           */
          speakingThreshold: number;
          /**
@@ -23249,6 +23256,8 @@ export declare class OrbitControls extends Component implements ICameraControlle
          onSpeakingChanged: EventList;
          private _speakingStates;
          private _analysers;
+         private _sharedAudioContext?;
+         private _lastSpeakingPollMs;
          private _net?;
          private _menubutton?;
          /* Excluded from this release type: awake */
@@ -23258,21 +23267,27 @@ export declare class OrbitControls extends Component implements ICameraControlle
          /** Set via the mic button (e.g. when the websocket connection closes and rejoins but the user was muted before we don't want to enable VOIP again automatically) */
          private _allowSending;
          private _outputStream;
+         private _connectInFlight?;
          /**
           * @returns true if the component is currently sending audio
           */
          get isSending(): boolean;
          /** Start sending audio. */
          connect(audioSource?: MediaTrackConstraints): Promise<boolean>;
+         private _connectImpl;
          /** Stop sending audio (muting your own microphone) */
          disconnect(opts?: {
              remember: boolean;
          }): void;
          /**
-          * Mute or unmute the audio stream (this will only mute incoming streams and not mute your own microphone. Use disconnect() to mute your own microphone)
+          * Mute or unmute the audio you hear from other users (incoming streams).
+          * This does NOT mute your own microphone — use {@link disconnect} to stop sending your microphone.
           */
          setMuted(mute: boolean): void;
-         /** Returns true if the audio stream is currently muted */
+         /**
+          * Returns true if incoming audio is currently muted (you can't hear other users).
+          * When there are no incoming streams, returns false.
+          */
          get isMuted(): boolean;
          private updateButton;
          /** @deprecated */
@@ -23284,6 +23299,7 @@ export declare class OrbitControls extends Component implements ICameraControlle
          /* Excluded from this release type: update */
          private setupAnalyser;
          private cleanupAnalyser;
+         private closeSharedAudioContext;
          private onReceiveStream;
          private onStreamEnded;
          private onEnabledChanged;
@@ -24712,28 +24728,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;
@@ -24879,3 +24873,25 @@ declare module 'three' {
         slerp(end: Vector3, t: number): Vector3;
     }
 }
+
+
+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;
+    }
+}