@needle-tools/engine 5.1.0-alpha.9 → 5.1.0-beta

package/dist/needle-engine.d.ts

@@ -118,8 +118,12 @@ import { XRHandSpace } from 'three';
 
 export declare const $componentName: unique symbol;
 
+/* Excluded from this release type: $fwGZrGe */
+
 export declare const $physicsKey: unique symbol;
 
+/* Excluded from this release type: _$qWUhYZU */
+
 export declare class __Ignore {
 }
 
@@ -9011,8 +9015,6 @@ export declare class ImageReference {
  */
 export declare function imageToCanvas(image: HTMLImageElement | HTMLCanvasElement | OffscreenCanvas | ImageBitmap, color?: Vector4 | undefined, flipY?: boolean, maxTextureSize?: number): Promise<OffscreenCanvasExt>;
 
-/* Excluded from this release type: _imGyfK */
-
 export declare interface IModel {
     guid: string;
     /**
@@ -16712,7 +16714,6 @@ export declare class OrbitControls extends Component implements ICameraControlle
      /** Adds an entry to the browser history. Internally uses `window.history.pushState` */
      export declare function pushState(title: string, urlParams: URLSearchParams, state?: any): void;
 
-     /* Excluded from this release type: _QchMjAD */
      export { QParticle }
 
      export { QParticleBehaviour }
@@ -17232,7 +17233,7 @@ export declare class OrbitControls extends Component implements ICameraControlle
          unapply(obj: Object3D): void;
      }
 
-     declare enum ReflectionProbeUsage {
+     export declare enum ReflectionProbeUsage {
          Off = 0,
          BlendProbes = 1,
          BlendProbesAndSkybox = 2,
@@ -17983,8 +17984,6 @@ export declare class OrbitControls extends Component implements ICameraControlle
          FreezeAll = 126
      }
 
-     /* Excluded from this release type: rkHTARX */
-
      /** Use to listen to room networking events like joining a networked room
       *  For example: `this.context.connection.beginListen(RoomEvents.JoinedRoom, () => { })`
       * @link https://engine.needle.tools/docs/networking.html#manual-networking
@@ -18321,6 +18320,8 @@ export declare class OrbitControls extends Component implements ICameraControlle
          switchScene(scene: AssetReference): Promise<boolean>;
          private __unloadCurrentScene;
          private _currentlyLoadingScene?;
+         private _loadingRequestId;
+         private _activeLoadingRequestId;
          /* Excluded from this release type: __internalSwitchScene */
          preload(index: number): Promise<boolean> | Promise<ArrayBufferLike | null>;
          private tryLoadFromQueryParam;
@@ -19173,13 +19174,42 @@ export declare class OrbitControls extends Component implements ICameraControlle
           *
           */
          autoUpdate: boolean;
+         /**
+          * The alpha (opacity) the object is currently faded to, in the `[0, 1]` range.
+          * `1` means fully visible, `0` means fully hidden. This is the live, animated value
+          * (it lerps toward the target over {@link fadeDuration}), updated every frame the fade runs.
+          *
+          * External components can read this to react to the see-through state — e.g. toggling a
+          * collider, muting audio, or driving a UI prompt as the object fades in or out.
+          *
+          * @example React to the object becoming (almost) hidden
+          * ```ts
+          * if (seeThrough.currentAlpha < 0.1) {
+          *   // object is essentially see-through now
+          * }
+          * ```
+          * @default 1
+          */
+         get currentAlpha(): number;
+         /**
+          * Below this alpha the object stops casting a shadow. The shadow map only stores depth, so a
+          * faded object would otherwise keep casting a fully solid shadow (three.js does not fade shadows
+          * by opacity). Toggling shadow casting off near-invisible is the cleanest fix; we drive it via
+          * the {@link Renderer.shadowCastingMode} so it cooperates with the per-frame shadow settings the
+          * Renderer re-applies. Note this is a hard on/off, not a fade.
+          */
+         static readonly shadowHideThreshold = 0.05;
          private readonly _referencePointVector;
          private readonly _referencePointDir;
          private _distance;
          private _renderer;
          private _needsUpdate;
          private _id;
+         private _currentAlpha;
+         /** Renderers whose shadow casting we turned off while hidden, mapped to their original mode for restore. */
+         private readonly _suppressedShadowCasting;
          /* Excluded from this release type: onEnable */
+         /* Excluded from this release type: onDestroy */
          /* Excluded from this release type: update */
          private updateDirection;
          /**
@@ -19188,6 +19218,15 @@ export declare class OrbitControls extends Component implements ICameraControlle
           * @param duration Duration in seconds to reach the target alpha. 0 means immediate. Default is the component's fadeDuration.
           */
          updateAlpha(targetAlpha: number, duration?: number): void;
+         /**
+          * Suppress or restore a renderer's shadow casting based on its current alpha.
+          * Driving {@link Renderer.shadowCastingMode} (rather than the raw `mesh.castShadow`) is required
+          * because the Renderer re-applies that setting every frame; we remember the original mode so it
+          * is restored exactly when the object fades back in.
+          */
+         private updateShadowCasting;
+         /** Restore every renderer we suppressed shadow casting on, then clear the bookkeeping. */
+         private restoreSuppressedShadowCasting;
      }
 
      export declare function sendDestroyed(guid: string, con: INetworkConnection, opts?: SyncDestroyOptions): void;
@@ -19406,7 +19445,7 @@ export declare class OrbitControls extends Component implements ICameraControlle
 
      export declare function setWorldScale(obj: Object3D, vec: Vector3): void;
 
-     declare enum ShadowCastingMode {
+     export declare enum ShadowCastingMode {
          Off = 0,
          On = 1,
          TwoSided = 2,
@@ -25113,9 +25152,33 @@ export declare class OrbitControls extends Component implements ICameraControlle
          All = 4294967295
      }
 
+     /* Excluded from this release type: _XtEQ */
+
      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 Vector3 {
         slerp(end: Vector3, t: number): Vector3;
@@ -25261,25 +25324,3 @@ declare module 'three' {
         contains(object: Object3D | null | undefined): boolean;
     }
 }
-
-
-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;
-    }
-}