@needle-tools/engine 5.1.9 → 5.1.10

package/dist/needle-engine.d.ts

@@ -5,6 +5,7 @@ import { Audio as Audio_2 } from 'three';
 import { AudioListener as AudioListener_3 } from 'three';
 import { BatchedMesh } from 'three';
 import { BloomEffect as BloomEffect_2 } from 'postprocessing';
+import { Bone } from 'three';
 import { Box3 } from 'three';
 import { BufferGeometry } from 'three';
 import { Camera as Camera_2 } from 'three';
@@ -111,22 +112,23 @@ import { WebGLRenderTarget } from 'three';
 import { WebXRArrayCamera } from 'three';
 import { World } from '@dimforge/rapier3d-compat';
 import { XRControllerModelFactory } from 'three/examples/jsm/webxr/XRControllerModelFactory.js';
-import { XRHandMeshModel } from 'three/examples/jsm/webxr/XRHandMeshModel.js';
 import { XRHandSpace } from 'three';
 
 export declare const $componentName: unique symbol;
 
-/* Excluded from this release type: $iNNlsg */
+/* Excluded from this release type: $fHATZ */
 
-export declare const $physicsKey: unique symbol;
+/* Excluded from this release type: $Ljyi */
 
-/* Excluded from this release type: _$qxlHFE */
+export declare const $physicsKey: unique symbol;
 
 export declare class __Ignore {
 }
 
 export declare function __internalNotifyObjectDestroyed(obj: Object3D): void;
 
+/* Excluded from this release type: __KODK */
+
 /** Data describing the accessible semantics for a 3D object or component. */
 declare type AccessibilityData = {
     /** ARIA role (e.g. `"button"`, `"img"`, `"region"`). */
@@ -5567,7 +5569,7 @@ export declare class DepthOfField extends PostProcessingEffect {
     unapply(): void;
 }
 
-declare enum DepthOfFieldMode {
+export declare enum DepthOfFieldMode {
     Off = 0,
     Gaussian = 1,
     Bokeh = 2
@@ -10458,8 +10460,6 @@ export declare interface IWatch {
     dispose(): any;
 }
 
-/* Excluded from this release type: _iXmRJVD */
-
 export declare interface IXRRig extends Pick<IComponent, "gameObject"> {
     isXRRig(): boolean;
     get isActive(): boolean;
@@ -10502,6 +10502,10 @@ declare abstract class Joint extends Component {
     protected abstract createJoint(self: Rigidbody, other: Rigidbody): any;
 }
 
+declare type JointBone = Bone & {
+    jointName?: string;
+};
+
 /** Locks the follow object's world rotation to the quaternion captured at drag-start. */
 export declare class KeepRotationConstraint implements IDragConstraint {
     private readonly _savedQuat;
@@ -11050,19 +11054,28 @@ export declare enum LogType {
  */
 export declare class LookAt extends Component implements UsdzBehaviour {
     /**
-     * The target object to look at. If not set, the main camera will be used.
+     * The target object to look at.
+     * @default undefined — when no target is set the main camera is used
      */
     target?: Object3D;
     /**
-     * Inverts the forward direction.
+     * Inverts the forward direction, so the object turns its back to the target
+     * instead of facing it. Useful for models authored facing -Z.
+     * @default false
      */
     invertForward: boolean;
     /**
-     * Keep the up direction.
+     * Keeps the object upright while turning, so it only rotates around the up
+     * axis rather than tilting to point directly at a target above or below it.
+     * @default true
      */
     keepUpDirection: boolean;
     /**
-     * Copy the target rotation.
+     * Copies the target's rotation instead of aiming at its position. Use this to
+     * match a target's orientation, for example to align with the camera.
+     *
+     * Ignored during a VR or AR session.
+     * @default false
      */
     copyTargetRotation: boolean;
     private static flipYQuat;
@@ -11256,7 +11269,7 @@ export declare class MaskableGraphic extends Graphic {
  * This means:
  * - If you change the object's material, the overrides will still be applied to the new material
  * - Multiple objects can share the same material but have different property overrides
- * - If you don't want overrides applied after changing a material, you must remove them using {@link removeOveride}, {@link clearAllOverrides}, or {@link dispose}
+ * - If you don't want overrides applied after changing a material, you must remove them using {@link removeOverride}, {@link clearAllOverrides}, or {@link dispose}
  *
  * The property block system works by:
  * - Temporarily applying overrides in onBeforeRender
@@ -11318,7 +11331,7 @@ export declare class MaskableGraphic extends Graphic {
  * // If you don't want overrides on the new material, remove them:
  * block.clearAllOverrides(); // Remove all overrides
  * // or
- * block.removeOveride("color"); // Remove specific override
+ * block.removeOverride("color"); // Remove specific override
  * // or
  * block.dispose(); // Remove the entire property block
  * ```
@@ -11445,11 +11458,20 @@ export declare class MaterialPropertyBlock<T extends Material = Material> {
      * block.setOverride("lightMap", lightmapTexture);
      *
      * // Remove a specific override - the material will now use its original color
-     * block.removeOveride("color");
+     * block.removeOverride("color");
      *
      * // Other overrides (roughness, lightMap) remain active
      * ```
      */
+    removeOverride<K extends NonFunctionPropertyNames<T>>(name: K | ({} & string)): void;
+    /**
+     * Removes a specific property override.
+     *
+     * @param name The property name to remove the override for
+     *
+     * @deprecated The name is missing an `r`. Use {@link removeOverride} instead — this
+     * alias is kept so existing code keeps working and will be removed in a future version.
+     */
     removeOveride<K extends NonFunctionPropertyNames<T>>(name: K | ({} & string)): void;
     /**
      * Removes all property overrides from this block.
@@ -11491,7 +11513,7 @@ export declare class MaterialPropertyBlock<T extends Material = Material> {
      * });
      * ```
      *
-     * @see {@link removeOveride} - To remove a single override
+     * @see {@link removeOverride} - To remove a single override
      * @see {@link dispose} - To completely remove the property block and clean up resources
      */
     clearAllOverrides(): void;
@@ -13333,7 +13355,7 @@ export declare class NestedGltf extends Component {
     private hash;
 }
 
-declare enum NEToneMappingMode {
+export declare enum NEToneMappingMode {
     None = 0,
     Neutral = 1,// Neutral tonemapper, close to Reinhard
     ACES = 2,// ACES Filmic reference tonemapper (custom approximation)
@@ -16258,6 +16280,24 @@ export declare class OrbitControls extends Component implements ICameraControlle
          get effects(): readonly IPostProcessingEffect[];
          get dirty(): boolean;
          set dirty(value: boolean);
+         private _enabled;
+         /**
+          * Whether the postprocessing stack runs at all. When disabled the scene is
+          * rendered directly, with no effects and no composer.
+          *
+          * Every effect keeps its own `enabled` state, so switching this back on
+          * restores exactly the stack that was there before. Useful for a quality
+          * setting, for a clean screenshot, or for comparing a scene with and
+          * without effects.
+          *
+          * @default true
+          * @example
+          * ```ts
+          * context.postprocessing.enabled = false;
+          * ```
+          */
+         get enabled(): boolean;
+         set enabled(value: boolean);
          /** The internal PostProcessingHandler that manages the EffectComposer pipeline */
          get handler(): IPostProcessingHandler | null;
          /**
@@ -16728,6 +16768,13 @@ export declare class OrbitControls extends Component implements ICameraControlle
 
      export { QTrailParticle }
 
+     export declare enum QualityLevel {
+         LOW = 0,
+         MEDIUM = 1,
+         HIGH = 2,
+         ULTRA = 3
+     }
+
      declare type Quat = {
          x: number;
          y: number;
@@ -18907,7 +18954,7 @@ export declare class OrbitControls extends Component implements ICameraControlle
      }
 
      /**See (N8AO documentation)[https://github.com/N8python/n8ao] */
-     declare enum ScreenSpaceAmbientOcclusionN8QualityMode {
+     export declare enum ScreenSpaceAmbientOcclusionN8QualityMode {
          Performance = 0,
          Low = 1,
          Medium = 2,
@@ -25112,6 +25159,32 @@ export declare class OrbitControls extends Component implements ICameraControlle
 
      export declare type XRGestureName = "pinch";
 
+     /**
+      * Renders a skinned hand mesh and drives its bones from the tracked WebXR joint poses.
+      *
+      * @see {@link XRControllerModel} which creates one per tracked hand.
+      */
+     declare class XRHandMeshModel {
+         /** The three XRHandSpace whose `joints` drive this mesh. */
+         readonly controller: XRHandSpace;
+         /** The object the loaded hand mesh is added to. */
+         readonly handModel: Object3D;
+         /** The bones driven by {@link updateMesh}, in {@link JOINT_NAMES} order. Sparse if the model lacks joints. */
+         readonly bones: Array<JointBone | undefined>;
+         /**
+          * @param handModel the object the loaded mesh is parented to
+          * @param controller the hand space providing joint poses
+          * @param path base path for the model (defaults to the generic hand profile CDN)
+          * @param handedness file name to load (without extension) — either "left"/"right" for the
+          *                   default profile, or a full path for a custom hand model
+          * @param loader loader to use; a plain GLTFLoader is created when omitted
+          * @param onLoad invoked with the loaded hand object once it has been added
+          */
+         constructor(handModel: Object3D, controller: XRHandSpace, path: string | null, handedness: string, loader?: GLTFLoader | null, onLoad?: ((object: Object3D) => void) | null);
+         /** Copies the current tracked joint poses onto the mesh bones. Called every XR frame. */
+         updateMesh(): void;
+     }
+
      declare type XRMesh_2 = {
          meshSpace: XRSpace;
          lastChangedTime: number;