@relu-interactives/spatial-ecs 0.3.18 → 0.3.20

package/dist/factories/index.d.cts

@@ -1,8 +1,8 @@
-import { A as AnimationComponent, b as AudioComponent, c as CameraComponentOptions, C as CameraComponent, T as RigidbodyState, g as ColliderState, P as PhysicsComponent, o as EntityType, I as ImageComponent, q as ImageTargetAnchor, p as ImageTarget, L as LightComponent, M as MaterialComponent, B as MeshComponent, F as MeshGeometryComponent, J as ModelComponent, N as Name, O as Object3DRef, W as ScriptEntry, V as ScriptComponent, Y as ScriptObjectComponentInput, X as ScriptObjectComponent, _ as Selectable, $ as SelectionTransformState, a0 as SpriteComponent, w as InstancedMeshKind, G as MeshGeometryParameters, v as InstancedMeshComponent, t as InstanceSlotComponent, a6 as VideoComponent, af as XRRigComponent, a4 as VRTeleportAreaComponent, a8 as XRHandPoseComponent, aa as XRInteractableComponent, ac as XRInteractorComponent, ae as XRInteractorSideComponent } from '../XRHandPose-B8xxFb9A.cjs';
+import { A as AnimationComponent, b as AudioComponent, c as CameraComponentOptions, C as CameraComponent, U as RigidbodyState, g as ColliderState, P as PhysicsComponent, p as EntityType, I as ImageComponent, r as ImageTargetAnchor, q as ImageTarget, L as LightComponent, M as MaterialComponent, F as MeshComponent, G as MeshGeometryComponent, K as ModelComponent, N as Name, O as Object3DRef, X as ScriptEntry, W as ScriptComponent, Z as ScriptObjectComponentInput, Y as ScriptObjectComponent, $ as Selectable, a0 as SelectionTransformState, a1 as SpriteComponent, x as InstancedMeshKind, H as MeshGeometryParameters, w as InstancedMeshComponent, u as InstanceSlotComponent, a7 as VideoComponent, ag as XRRigComponent, a5 as VRTeleportAreaComponent, a9 as XRHandPoseComponent, ab as XRInteractableComponent, ad as XRInteractorComponent, af as XRInteractorSideComponent } from '../XRHandPose-CLl4MiHx.cjs';
 import { l as World, g as EnvironmentState, E as Environment, P as ParentId, i as PostprocessingState, h as Postprocessing, T as TransformComponent, O as ObjectManagementSystem } from '../System-BhnLw0fZ.cjs';
 import * as THREE from 'three';
 import '@dimforge/rapier3d-compat';
-import '../handPose-dFxqbFFY.cjs';
+import '../handPose-DlcTtqgx.cjs';
 
 declare function createAnimationComponent(world: World, entityId: number, ...args: ConstructorParameters<typeof AnimationComponent>): AnimationComponent;
 

package/dist/factories/index.d.ts

@@ -1,8 +1,8 @@
-import { A as AnimationComponent, b as AudioComponent, c as CameraComponentOptions, C as CameraComponent, T as RigidbodyState, g as ColliderState, P as PhysicsComponent, o as EntityType, I as ImageComponent, q as ImageTargetAnchor, p as ImageTarget, L as LightComponent, M as MaterialComponent, B as MeshComponent, F as MeshGeometryComponent, J as ModelComponent, N as Name, O as Object3DRef, W as ScriptEntry, V as ScriptComponent, Y as ScriptObjectComponentInput, X as ScriptObjectComponent, _ as Selectable, $ as SelectionTransformState, a0 as SpriteComponent, w as InstancedMeshKind, G as MeshGeometryParameters, v as InstancedMeshComponent, t as InstanceSlotComponent, a6 as VideoComponent, af as XRRigComponent, a4 as VRTeleportAreaComponent, a8 as XRHandPoseComponent, aa as XRInteractableComponent, ac as XRInteractorComponent, ae as XRInteractorSideComponent } from '../XRHandPose-ubMe5Igc.js';
+import { A as AnimationComponent, b as AudioComponent, c as CameraComponentOptions, C as CameraComponent, U as RigidbodyState, g as ColliderState, P as PhysicsComponent, p as EntityType, I as ImageComponent, r as ImageTargetAnchor, q as ImageTarget, L as LightComponent, M as MaterialComponent, F as MeshComponent, G as MeshGeometryComponent, K as ModelComponent, N as Name, O as Object3DRef, X as ScriptEntry, W as ScriptComponent, Z as ScriptObjectComponentInput, Y as ScriptObjectComponent, $ as Selectable, a0 as SelectionTransformState, a1 as SpriteComponent, x as InstancedMeshKind, H as MeshGeometryParameters, w as InstancedMeshComponent, u as InstanceSlotComponent, a7 as VideoComponent, ag as XRRigComponent, a5 as VRTeleportAreaComponent, a9 as XRHandPoseComponent, ab as XRInteractableComponent, ad as XRInteractorComponent, af as XRInteractorSideComponent } from '../XRHandPose-CrzI57JA.js';
 import { l as World, g as EnvironmentState, E as Environment, P as ParentId, i as PostprocessingState, h as Postprocessing, T as TransformComponent, O as ObjectManagementSystem } from '../System-BhnLw0fZ.js';
 import * as THREE from 'three';
 import '@dimforge/rapier3d-compat';
-import '../handPose-dFxqbFFY.js';
+import '../handPose-DlcTtqgx.js';
 
 declare function createAnimationComponent(world: World, entityId: number, ...args: ConstructorParameters<typeof AnimationComponent>): AnimationComponent;
 

package/dist/factories/index.js

@@ -1,6 +1,6 @@
-export { createAnimationComponent, createAudioComponent, createCameraComponent, createEntityTypeComponent, createEnvironmentComponent, createImageComponent, createImageTargetAnchorComponent, createImageTargetComponent, createInstanceSlotComponent, createInstancedMeshComponent, createLightComponent, createMaterialComponent, createMeshComponent, createMeshGeometryComponent, createModelComponent, createNameComponent, createObject3DRefComponent, createParentIdComponent, createPhysicsComponent, createPostprocessingComponent, createScriptComponent, createScriptObjectComponent, createSelectableComponent, createSelectionTransformStateComponent, createSpriteComponent, createTransformComponent, createVRTeleportAreaComponent, createVideoComponent, createXRHandPoseComponent, createXRInteractableComponent, createXRInteractorComponent, createXRInteractorSideComponent, createXRRigComponent, registerDefaultComponentFactories, registerDefaultFactories } from '../chunk-KRWBNC6Y.js';
-import '../chunk-PFE2SDXR.js';
-import '../chunk-J3EUNW57.js';
+export { createAnimationComponent, createAudioComponent, createCameraComponent, createEntityTypeComponent, createEnvironmentComponent, createImageComponent, createImageTargetAnchorComponent, createImageTargetComponent, createInstanceSlotComponent, createInstancedMeshComponent, createLightComponent, createMaterialComponent, createMeshComponent, createMeshGeometryComponent, createModelComponent, createNameComponent, createObject3DRefComponent, createParentIdComponent, createPhysicsComponent, createPostprocessingComponent, createScriptComponent, createScriptObjectComponent, createSelectableComponent, createSelectionTransformStateComponent, createSpriteComponent, createTransformComponent, createVRTeleportAreaComponent, createVideoComponent, createXRHandPoseComponent, createXRInteractableComponent, createXRInteractorComponent, createXRInteractorSideComponent, createXRRigComponent, registerDefaultComponentFactories, registerDefaultFactories } from '../chunk-P42OE3RU.js';
+import '../chunk-D6KXWNYT.js';
+import '../chunk-H6DQ7JRE.js';
 import '../chunk-OY7ZODZP.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/{handPose-dFxqbFFY.d.cts → handPose-DlcTtqgx.d.cts}

@@ -119,6 +119,14 @@ type XrHandShape = {
     scale: number;
     /** Direction the thumb points, world space. */
     thumbDirection: THREE.Vector3 | null;
+    /**
+     * Direction each finger points, world space (metacarpal → tip).
+     *
+     * Separate from curl: a finger can be straight while pointing anywhere, and
+     * "index extended, pointing up" is a different pose from "index extended,
+     * pointing at the user".
+     */
+    fingerDirections: Record<XrFinger, THREE.Vector3 | null>;
 };
 /**
  * Reduce tracked joints to the matchable shape.
@@ -137,6 +145,14 @@ type XrFingerTarget = {
     baseCurl?: number;
     /** Optional outer-joint constraint. */
     tipCurl?: number;
+    /**
+     * Directions this finger may point, world space.
+     *
+     * Any ONE of them satisfies the constraint, mirroring fingerpose's
+     * `addDirection` — a thumb that may point up OR diagonally up is one pose,
+     * not two. Empty or omitted leaves the finger free to point anywhere.
+     */
+    directions?: XrHandPoseDirection[];
 };
 /** Which way something on the hand must point for the pose to count. */
 type XrHandPoseAxis = "palm-normal" | "fingers" | "thumb";
@@ -167,6 +183,13 @@ type XrHandPoseDefinition = {
         tolerance: number;
     };
     orientation?: XrHandPoseOrientation;
+    /**
+     * How far a finger may point from an accepted direction, in degrees.
+     *
+     * Generous by default: finger direction is a coarse signal, and a tight cone
+     * makes a pose that reads correctly to the user fail to register.
+     */
+    directionToleranceDegrees?: number;
     /** Restrict to one hand; omit to match either. */
     hand?: "left" | "right";
 };
@@ -180,6 +203,8 @@ type XrHandPoseMatch = {
     /** The constraint furthest out of range — what to show the user when it fails. */
     worstConstraint: string | null;
 };
+/** Default cone for per-finger direction constraints. */
+declare const DEFAULT_DIRECTION_TOLERANCE = 45;
 /** Extra world context needed only by head-relative orientation conditions. */
 type XrHandPoseContext = {
     headPosition?: THREE.Vector3;
@@ -237,4 +262,4 @@ declare class HandPoseTracker {
     reset(): void;
 }
 
-export { CURLED_COS as C, DEFAULT_ENTER_CONFIDENCE as D, FALLBACK_HAND_SCALE as F, HandPoseTracker as H, MATCH_FALLOFF as M, PINCH_FINGERS as P, STRAIGHT_COS as S, type XrHandPoseDefinition as X, type XrFinger as a, type XrHandPoseOrientation as b, DEFAULT_EXIT_CONFIDENCE as c, DEFAULT_LOST_GRACE_SECONDS as d, DEFAULT_MIN_HOLD_SECONDS as e, type HandPoseTrackerOptions as f, XR_FINGERS as g, type XrFingerCurl as h, type XrFingerTarget as i, type XrHandJointName as j, type XrHandJoints as k, type XrHandPoseAxis as l, type XrHandPoseContext as m, type XrHandPoseDirection as n, type XrHandPoseEvent as o, type XrHandPoseMatch as p, type XrHandShape as q, type XrPalmPose as r, computeFingerCurl as s, computeHandShape as t, computePalmPose as u, computePalmWidth as v, computePinch as w, computeSpread as x, estimateHandScale as y, matchHandPose as z };
+export { matchHandPose as A, CURLED_COS as C, DEFAULT_DIRECTION_TOLERANCE as D, FALLBACK_HAND_SCALE as F, HandPoseTracker as H, MATCH_FALLOFF as M, PINCH_FINGERS as P, STRAIGHT_COS as S, type XrHandPoseDefinition as X, type XrFinger as a, type XrHandPoseOrientation as b, type XrHandPoseDirection as c, DEFAULT_ENTER_CONFIDENCE as d, DEFAULT_EXIT_CONFIDENCE as e, DEFAULT_LOST_GRACE_SECONDS as f, DEFAULT_MIN_HOLD_SECONDS as g, type HandPoseTrackerOptions as h, XR_FINGERS as i, type XrFingerCurl as j, type XrFingerTarget as k, type XrHandJointName as l, type XrHandJoints as m, type XrHandPoseAxis as n, type XrHandPoseContext as o, type XrHandPoseEvent as p, type XrHandPoseMatch as q, type XrHandShape as r, type XrPalmPose as s, computeFingerCurl as t, computeHandShape as u, computePalmPose as v, computePalmWidth as w, computePinch as x, computeSpread as y, estimateHandScale as z };

package/dist/{handPose-dFxqbFFY.d.ts → handPose-DlcTtqgx.d.ts}

@@ -119,6 +119,14 @@ type XrHandShape = {
     scale: number;
     /** Direction the thumb points, world space. */
     thumbDirection: THREE.Vector3 | null;
+    /**
+     * Direction each finger points, world space (metacarpal → tip).
+     *
+     * Separate from curl: a finger can be straight while pointing anywhere, and
+     * "index extended, pointing up" is a different pose from "index extended,
+     * pointing at the user".
+     */
+    fingerDirections: Record<XrFinger, THREE.Vector3 | null>;
 };
 /**
  * Reduce tracked joints to the matchable shape.
@@ -137,6 +145,14 @@ type XrFingerTarget = {
     baseCurl?: number;
     /** Optional outer-joint constraint. */
     tipCurl?: number;
+    /**
+     * Directions this finger may point, world space.
+     *
+     * Any ONE of them satisfies the constraint, mirroring fingerpose's
+     * `addDirection` — a thumb that may point up OR diagonally up is one pose,
+     * not two. Empty or omitted leaves the finger free to point anywhere.
+     */
+    directions?: XrHandPoseDirection[];
 };
 /** Which way something on the hand must point for the pose to count. */
 type XrHandPoseAxis = "palm-normal" | "fingers" | "thumb";
@@ -167,6 +183,13 @@ type XrHandPoseDefinition = {
         tolerance: number;
     };
     orientation?: XrHandPoseOrientation;
+    /**
+     * How far a finger may point from an accepted direction, in degrees.
+     *
+     * Generous by default: finger direction is a coarse signal, and a tight cone
+     * makes a pose that reads correctly to the user fail to register.
+     */
+    directionToleranceDegrees?: number;
     /** Restrict to one hand; omit to match either. */
     hand?: "left" | "right";
 };
@@ -180,6 +203,8 @@ type XrHandPoseMatch = {
     /** The constraint furthest out of range — what to show the user when it fails. */
     worstConstraint: string | null;
 };
+/** Default cone for per-finger direction constraints. */
+declare const DEFAULT_DIRECTION_TOLERANCE = 45;
 /** Extra world context needed only by head-relative orientation conditions. */
 type XrHandPoseContext = {
     headPosition?: THREE.Vector3;
@@ -237,4 +262,4 @@ declare class HandPoseTracker {
     reset(): void;
 }
 
-export { CURLED_COS as C, DEFAULT_ENTER_CONFIDENCE as D, FALLBACK_HAND_SCALE as F, HandPoseTracker as H, MATCH_FALLOFF as M, PINCH_FINGERS as P, STRAIGHT_COS as S, type XrHandPoseDefinition as X, type XrFinger as a, type XrHandPoseOrientation as b, DEFAULT_EXIT_CONFIDENCE as c, DEFAULT_LOST_GRACE_SECONDS as d, DEFAULT_MIN_HOLD_SECONDS as e, type HandPoseTrackerOptions as f, XR_FINGERS as g, type XrFingerCurl as h, type XrFingerTarget as i, type XrHandJointName as j, type XrHandJoints as k, type XrHandPoseAxis as l, type XrHandPoseContext as m, type XrHandPoseDirection as n, type XrHandPoseEvent as o, type XrHandPoseMatch as p, type XrHandShape as q, type XrPalmPose as r, computeFingerCurl as s, computeHandShape as t, computePalmPose as u, computePalmWidth as v, computePinch as w, computeSpread as x, estimateHandScale as y, matchHandPose as z };
+export { matchHandPose as A, CURLED_COS as C, DEFAULT_DIRECTION_TOLERANCE as D, FALLBACK_HAND_SCALE as F, HandPoseTracker as H, MATCH_FALLOFF as M, PINCH_FINGERS as P, STRAIGHT_COS as S, type XrHandPoseDefinition as X, type XrFinger as a, type XrHandPoseOrientation as b, type XrHandPoseDirection as c, DEFAULT_ENTER_CONFIDENCE as d, DEFAULT_EXIT_CONFIDENCE as e, DEFAULT_LOST_GRACE_SECONDS as f, DEFAULT_MIN_HOLD_SECONDS as g, type HandPoseTrackerOptions as h, XR_FINGERS as i, type XrFingerCurl as j, type XrFingerTarget as k, type XrHandJointName as l, type XrHandJoints as m, type XrHandPoseAxis as n, type XrHandPoseContext as o, type XrHandPoseEvent as p, type XrHandPoseMatch as q, type XrHandShape as r, type XrPalmPose as s, computeFingerCurl as t, computeHandShape as u, computePalmPose as v, computePalmWidth as w, computePinch as x, computeSpread as y, estimateHandScale as z };

package/dist/{index-D7aSZ-e9.d.ts → index-6l4hn2Sh.d.ts}

@@ -1,6 +1,6 @@
 import { k as EcsSystem, l as World } from './System-BhnLw0fZ.js';
 import * as THREE from 'three';
-import { k as XrHandJoints, q as XrHandShape } from './handPose-dFxqbFFY.js';
+import { m as XrHandJoints, r as XrHandShape } from './handPose-DlcTtqgx.js';
 
 declare class AnimationSystem implements EcsSystem {
     private readonly runtimeByEntity;
@@ -401,6 +401,18 @@ declare class XRInputSystem implements EcsSystem {
     getInputs(): XrInputState[];
     /** The first source for a hand, or null. Prefer this for hand-specific logic. */
     getInput(handedness: XrHandedness): XrInputState | null;
+    /**
+     * The ARTICULATED source for a hand — the one carrying joint poses.
+     *
+     * Distinct from {@link getInput} because a hand can be backed by several
+     * sources at once: a Quest reports a controller AND a tracked hand for the
+     * same handedness, and Vision Pro adds a transient pinch alongside its two
+     * persistent hands. `getInput` returns whichever was seen first, so anything
+     * needing JOINTS has to ask for them specifically — taking the first match
+     * silently handed pose detection a controller with no joints, and no pose
+     * ever fired.
+     */
+    getHandInput(handedness: XrHandedness): XrInputState | null;
     /** True while ANY source is selecting — the portable "is the user acting" check. */
     isSelecting(): boolean;
     dispose(): void;
@@ -800,6 +812,8 @@ declare class XRHandPoseSystem implements EcsSystem {
     /** Reused so head-relative orientation checks allocate nothing per frame. */
     private readonly headPosition;
     private elapsed;
+    private warnedNoHands;
+    private noHandSeconds;
     constructor(inputSystem: XRInputSystem);
     update(world: World, deltaTime: number): void;
     /** Derive each hand's shape once for the whole frame. */

package/dist/{index-7CFf45fo.d.cts → index-C2I5PxCI.d.cts}

@@ -1,6 +1,6 @@
 import { k as EcsSystem, l as World } from './System-BhnLw0fZ.cjs';
 import * as THREE from 'three';
-import { k as XrHandJoints, q as XrHandShape } from './handPose-dFxqbFFY.cjs';
+import { m as XrHandJoints, r as XrHandShape } from './handPose-DlcTtqgx.cjs';
 
 declare class AnimationSystem implements EcsSystem {
     private readonly runtimeByEntity;
@@ -401,6 +401,18 @@ declare class XRInputSystem implements EcsSystem {
     getInputs(): XrInputState[];
     /** The first source for a hand, or null. Prefer this for hand-specific logic. */
     getInput(handedness: XrHandedness): XrInputState | null;
+    /**
+     * The ARTICULATED source for a hand — the one carrying joint poses.
+     *
+     * Distinct from {@link getInput} because a hand can be backed by several
+     * sources at once: a Quest reports a controller AND a tracked hand for the
+     * same handedness, and Vision Pro adds a transient pinch alongside its two
+     * persistent hands. `getInput` returns whichever was seen first, so anything
+     * needing JOINTS has to ask for them specifically — taking the first match
+     * silently handed pose detection a controller with no joints, and no pose
+     * ever fired.
+     */
+    getHandInput(handedness: XrHandedness): XrInputState | null;
     /** True while ANY source is selecting — the portable "is the user acting" check. */
     isSelecting(): boolean;
     dispose(): void;
@@ -800,6 +812,8 @@ declare class XRHandPoseSystem implements EcsSystem {
     /** Reused so head-relative orientation checks allocate nothing per frame. */
     private readonly headPosition;
     private elapsed;
+    private warnedNoHands;
+    private noHandSeconds;
     constructor(inputSystem: XRInputSystem);
     update(world: World, deltaTime: number): void;
     /** Derive each hand's shape once for the whole frame. */

package/dist/{index-DhWfxUgL.d.ts → index-JRcoel9F.d.ts}

@@ -1,4 +1,4 @@
-import { A as AnimationComponent, a as AnimationComponentOptions, b as AudioComponent, C as CameraComponent, c as CameraComponentOptions, d as CameraProjection, e as CameraRuntimeType, f as ColliderShape, g as ColliderState, h as CubeMeshParameters, D as DEFAULT_COLLIDER_STATE, i as DEFAULT_INSTANCED_MESH_PARAMETERS, j as DEFAULT_INSTANCE_TRANSFORM, k as DEFAULT_MESH_GEOMETRY_PARAMETERS, l as DEFAULT_PHYSICS_STATE, m as DEFAULT_POSE_CURLS, n as DEFAULT_RIGIDBODY_STATE, E as EditableMeshObjectKind, o as EntityType, I as ImageComponent, p as ImageTarget, q as ImageTargetAnchor, r as ImageTargetAnchorOptions, s as ImageTargetReference, t as InstanceSlotComponent, u as InstanceTransform, v as InstancedMeshComponent, w as InstancedMeshKind, L as LightComponent, x as LightValueState, M as MaterialComponent, y as MaterialTypeValue, z as MaterialValueState, B as MeshComponent, F as MeshGeometryComponent, G as MeshGeometryParameters, H as MeshGeometryParametersByKind, J as ModelComponent, N as Name, O as Object3DRef, P as PhysicsComponent, K as PhysicsState, Q as PlaneMeshParameters, R as RadiusHeightMeshParameters, S as RadiusMeshParameters, T as RigidbodyState, U as RigidbodyType, V as ScriptComponent, W as ScriptEntry, X as ScriptObjectComponent, Y as ScriptObjectComponentInput, Z as ScriptObjectRuntimeState, _ as Selectable, $ as SelectionTransformState, a0 as SpriteComponent, a1 as TextureFilteringValue, a2 as TransformModeValue, a3 as TransformSpaceValue, a4 as VRTeleportAreaComponent, a5 as VRTeleportAreaOptions, a6 as VideoComponent, a7 as VrTeleportShape, a8 as XRHandPoseComponent, a9 as XRHandPoseOptions, aa as XRInteractableComponent, ab as XRInteractableOptions, ac as XRInteractorComponent, ad as XRInteractorOptions, ae as XRInteractorSideComponent, af as XRRigComponent, ag as XRRigOptions, ah as XrAttachPoint, ai as XrDistanceGrabBehavior, aj as XrGrabGesture, ak as XrGrabHands, al as XrGrabReach, am as XrHandPoseEntry, an as XrHandPreset, ao as XrInteractorSide, ap as XrInteractorType, aq as XrLocomotionMode, ar as XrTrackingOrigin, as as XrTwoHandRotation, at as createAttachPoint, au as createHandPoseEntry, av as defaultMaterialValue, aw as handPoseDefinitionFor, ax as normalizePhysicsState, ay as setPhysicsLiveRef } from './XRHandPose-ubMe5Igc.js';
+import { A as AnimationComponent, a as AnimationComponentOptions, b as AudioComponent, C as CameraComponent, c as CameraComponentOptions, d as CameraProjection, e as CameraRuntimeType, f as ColliderShape, g as ColliderState, h as CubeMeshParameters, D as DEFAULT_COLLIDER_STATE, i as DEFAULT_INSTANCED_MESH_PARAMETERS, j as DEFAULT_INSTANCE_TRANSFORM, k as DEFAULT_MESH_GEOMETRY_PARAMETERS, l as DEFAULT_PHYSICS_STATE, m as DEFAULT_POSE_CURLS, n as DEFAULT_POSE_DIRECTIONS, o as DEFAULT_RIGIDBODY_STATE, E as EditableMeshObjectKind, p as EntityType, I as ImageComponent, q as ImageTarget, r as ImageTargetAnchor, s as ImageTargetAnchorOptions, t as ImageTargetReference, u as InstanceSlotComponent, v as InstanceTransform, w as InstancedMeshComponent, x as InstancedMeshKind, L as LightComponent, y as LightValueState, M as MaterialComponent, z as MaterialTypeValue, B as MaterialValueState, F as MeshComponent, G as MeshGeometryComponent, H as MeshGeometryParameters, J as MeshGeometryParametersByKind, K as ModelComponent, N as Name, O as Object3DRef, P as PhysicsComponent, Q as PhysicsState, R as PlaneMeshParameters, S as RadiusHeightMeshParameters, T as RadiusMeshParameters, U as RigidbodyState, V as RigidbodyType, W as ScriptComponent, X as ScriptEntry, Y as ScriptObjectComponent, Z as ScriptObjectComponentInput, _ as ScriptObjectRuntimeState, $ as Selectable, a0 as SelectionTransformState, a1 as SpriteComponent, a2 as TextureFilteringValue, a3 as TransformModeValue, a4 as TransformSpaceValue, a5 as VRTeleportAreaComponent, a6 as VRTeleportAreaOptions, a7 as VideoComponent, a8 as VrTeleportShape, a9 as XRHandPoseComponent, aa as XRHandPoseOptions, ab as XRInteractableComponent, ac as XRInteractableOptions, ad as XRInteractorComponent, ae as XRInteractorOptions, af as XRInteractorSideComponent, ag as XRRigComponent, ah as XRRigOptions, ai as XrAttachPoint, aj as XrDistanceGrabBehavior, ak as XrGrabGesture, al as XrGrabHands, am as XrGrabReach, an as XrHandPoseEntry, ao as XrHandPreset, ap as XrInteractorSide, aq as XrInteractorType, ar as XrLocomotionMode, as as XrTrackingOrigin, at as XrTwoHandRotation, au as createAttachPoint, av as createHandPoseEntry, aw as defaultMaterialValue, ax as handPoseDefinitionFor, ay as normalizePhysicsState, az as setPhysicsLiveRef } from './XRHandPose-CrzI57JA.js';
 import { C as Component, D as DEFAULT_ENVIRONMENT_STATE, a as DEFAULT_POSTPROCESSING_STATE, E as Environment, b as EnvironmentFogState, c as EnvironmentFogType, d as EnvironmentGradientEffect, e as EnvironmentSkyboxState, f as EnvironmentSkyboxType, g as EnvironmentState, P as ParentId, h as Postprocessing, i as PostprocessingState, T as TransformComponent, j as TransformData, V as Vec3 } from './System-BhnLw0fZ.js';
 
 /**
@@ -85,6 +85,7 @@ declare const index_DEFAULT_INSTANCE_TRANSFORM: typeof DEFAULT_INSTANCE_TRANSFOR
 declare const index_DEFAULT_MESH_GEOMETRY_PARAMETERS: typeof DEFAULT_MESH_GEOMETRY_PARAMETERS;
 declare const index_DEFAULT_PHYSICS_STATE: typeof DEFAULT_PHYSICS_STATE;
 declare const index_DEFAULT_POSE_CURLS: typeof DEFAULT_POSE_CURLS;
+declare const index_DEFAULT_POSE_DIRECTIONS: typeof DEFAULT_POSE_DIRECTIONS;
 declare const index_DEFAULT_POSTPROCESSING_STATE: typeof DEFAULT_POSTPROCESSING_STATE;
 declare const index_DEFAULT_RIGIDBODY_STATE: typeof DEFAULT_RIGIDBODY_STATE;
 declare const index_EditableMeshObjectKind: typeof EditableMeshObjectKind;
@@ -177,7 +178,7 @@ declare const index_handPoseDefinitionFor: typeof handPoseDefinitionFor;
 declare const index_normalizePhysicsState: typeof normalizePhysicsState;
 declare const index_setPhysicsLiveRef: typeof setPhysicsLiveRef;
 declare namespace index {
-  export { index_AnimationComponent as AnimationComponent, index_AnimationComponentOptions as AnimationComponentOptions, index_AudioComponent as AudioComponent, index_CameraComponent as CameraComponent, index_CameraComponentOptions as CameraComponentOptions, index_CameraProjection as CameraProjection, index_CameraRuntimeType as CameraRuntimeType, index_ColliderShape as ColliderShape, index_ColliderState as ColliderState, index_CubeMeshParameters as CubeMeshParameters, index_DEFAULT_COLLIDER_STATE as DEFAULT_COLLIDER_STATE, index_DEFAULT_ENVIRONMENT_STATE as DEFAULT_ENVIRONMENT_STATE, index_DEFAULT_INSTANCED_MESH_PARAMETERS as DEFAULT_INSTANCED_MESH_PARAMETERS, index_DEFAULT_INSTANCE_TRANSFORM as DEFAULT_INSTANCE_TRANSFORM, index_DEFAULT_MESH_GEOMETRY_PARAMETERS as DEFAULT_MESH_GEOMETRY_PARAMETERS, index_DEFAULT_PHYSICS_STATE as DEFAULT_PHYSICS_STATE, index_DEFAULT_POSE_CURLS as DEFAULT_POSE_CURLS, index_DEFAULT_POSTPROCESSING_STATE as DEFAULT_POSTPROCESSING_STATE, index_DEFAULT_RIGIDBODY_STATE as DEFAULT_RIGIDBODY_STATE, index_EditableMeshObjectKind as EditableMeshObjectKind, index_EntityType as EntityType, index_Environment as Environment, index_EnvironmentFogState as EnvironmentFogState, index_EnvironmentFogType as EnvironmentFogType, index_EnvironmentGradientEffect as EnvironmentGradientEffect, index_EnvironmentSkyboxState as EnvironmentSkyboxState, index_EnvironmentSkyboxType as EnvironmentSkyboxType, index_EnvironmentState as EnvironmentState, index_ImageComponent as ImageComponent, index_ImageTarget as ImageTarget, index_ImageTargetAnchor as ImageTargetAnchor, index_ImageTargetAnchorOptions as ImageTargetAnchorOptions, index_ImageTargetReference as ImageTargetReference, index_InstanceSlotComponent as InstanceSlotComponent, index_InstanceTransform as InstanceTransform, index_InstancedMeshComponent as InstancedMeshComponent, index_InstancedMeshKind as InstancedMeshKind, index_LightComponent as LightComponent, index_LightValueState as LightValueState, index_MaterialComponent as MaterialComponent, index_MaterialTypeValue as MaterialTypeValue, index_MaterialValueState as MaterialValueState, index_MeshComponent as MeshComponent, index_MeshGeometryComponent as MeshGeometryComponent, index_MeshGeometryParameters as MeshGeometryParameters, index_MeshGeometryParametersByKind as MeshGeometryParametersByKind, index_ModelComponent as ModelComponent, index_Name as Name, index_Object3DRef as Object3DRef, index_ParentId as ParentId, index_PhysicsComponent as PhysicsComponent, index_PhysicsState as PhysicsState, index_PlaneMeshParameters as PlaneMeshParameters, index_Postprocessing as Postprocessing, index_PostprocessingState as PostprocessingState, index_PrefabInstance as PrefabInstance, index_PrefabNode as PrefabNode, index_RadiusHeightMeshParameters as RadiusHeightMeshParameters, index_RadiusMeshParameters as RadiusMeshParameters, index_RigidbodyState as RigidbodyState, index_RigidbodyType as RigidbodyType, index_ScriptComponent as ScriptComponent, index_ScriptEntry as ScriptEntry, index_ScriptObjectComponent as ScriptObjectComponent, index_ScriptObjectComponentInput as ScriptObjectComponentInput, index_ScriptObjectRuntimeState as ScriptObjectRuntimeState, index_Selectable as Selectable, index_SelectionTransformState as SelectionTransformState, index_SpriteComponent as SpriteComponent, index_TextureFilteringValue as TextureFilteringValue, index_TransformComponent as TransformComponent, index_TransformData as TransformData, index_TransformModeValue as TransformModeValue, index_TransformSpaceValue as TransformSpaceValue, index_VRTeleportAreaComponent as VRTeleportAreaComponent, index_VRTeleportAreaOptions as VRTeleportAreaOptions, index_Vec3 as Vec3, index_VideoComponent as VideoComponent, index_VrTeleportShape as VrTeleportShape, index_XRHandPoseComponent as XRHandPoseComponent, index_XRHandPoseOptions as XRHandPoseOptions, index_XRInteractableComponent as XRInteractableComponent, index_XRInteractableOptions as XRInteractableOptions, index_XRInteractorComponent as XRInteractorComponent, index_XRInteractorOptions as XRInteractorOptions, index_XRInteractorSideComponent as XRInteractorSideComponent, index_XRRigComponent as XRRigComponent, index_XRRigOptions as XRRigOptions, index_XrAttachPoint as XrAttachPoint, index_XrDistanceGrabBehavior as XrDistanceGrabBehavior, index_XrGrabGesture as XrGrabGesture, index_XrGrabHands as XrGrabHands, index_XrGrabReach as XrGrabReach, index_XrHandPoseEntry as XrHandPoseEntry, index_XrHandPreset as XrHandPreset, index_XrInteractorSide as XrInteractorSide, index_XrInteractorType as XrInteractorType, index_XrLocomotionMode as XrLocomotionMode, index_XrTrackingOrigin as XrTrackingOrigin, index_XrTwoHandRotation as XrTwoHandRotation, index_createAttachPoint as createAttachPoint, index_createHandPoseEntry as createHandPoseEntry, index_defaultMaterialValue as defaultMaterialValue, index_handPoseDefinitionFor as handPoseDefinitionFor, index_normalizePhysicsState as normalizePhysicsState, index_setPhysicsLiveRef as setPhysicsLiveRef };
+  export { index_AnimationComponent as AnimationComponent, index_AnimationComponentOptions as AnimationComponentOptions, index_AudioComponent as AudioComponent, index_CameraComponent as CameraComponent, index_CameraComponentOptions as CameraComponentOptions, index_CameraProjection as CameraProjection, index_CameraRuntimeType as CameraRuntimeType, index_ColliderShape as ColliderShape, index_ColliderState as ColliderState, index_CubeMeshParameters as CubeMeshParameters, index_DEFAULT_COLLIDER_STATE as DEFAULT_COLLIDER_STATE, index_DEFAULT_ENVIRONMENT_STATE as DEFAULT_ENVIRONMENT_STATE, index_DEFAULT_INSTANCED_MESH_PARAMETERS as DEFAULT_INSTANCED_MESH_PARAMETERS, index_DEFAULT_INSTANCE_TRANSFORM as DEFAULT_INSTANCE_TRANSFORM, index_DEFAULT_MESH_GEOMETRY_PARAMETERS as DEFAULT_MESH_GEOMETRY_PARAMETERS, index_DEFAULT_PHYSICS_STATE as DEFAULT_PHYSICS_STATE, index_DEFAULT_POSE_CURLS as DEFAULT_POSE_CURLS, index_DEFAULT_POSE_DIRECTIONS as DEFAULT_POSE_DIRECTIONS, index_DEFAULT_POSTPROCESSING_STATE as DEFAULT_POSTPROCESSING_STATE, index_DEFAULT_RIGIDBODY_STATE as DEFAULT_RIGIDBODY_STATE, index_EditableMeshObjectKind as EditableMeshObjectKind, index_EntityType as EntityType, index_Environment as Environment, index_EnvironmentFogState as EnvironmentFogState, index_EnvironmentFogType as EnvironmentFogType, index_EnvironmentGradientEffect as EnvironmentGradientEffect, index_EnvironmentSkyboxState as EnvironmentSkyboxState, index_EnvironmentSkyboxType as EnvironmentSkyboxType, index_EnvironmentState as EnvironmentState, index_ImageComponent as ImageComponent, index_ImageTarget as ImageTarget, index_ImageTargetAnchor as ImageTargetAnchor, index_ImageTargetAnchorOptions as ImageTargetAnchorOptions, index_ImageTargetReference as ImageTargetReference, index_InstanceSlotComponent as InstanceSlotComponent, index_InstanceTransform as InstanceTransform, index_InstancedMeshComponent as InstancedMeshComponent, index_InstancedMeshKind as InstancedMeshKind, index_LightComponent as LightComponent, index_LightValueState as LightValueState, index_MaterialComponent as MaterialComponent, index_MaterialTypeValue as MaterialTypeValue, index_MaterialValueState as MaterialValueState, index_MeshComponent as MeshComponent, index_MeshGeometryComponent as MeshGeometryComponent, index_MeshGeometryParameters as MeshGeometryParameters, index_MeshGeometryParametersByKind as MeshGeometryParametersByKind, index_ModelComponent as ModelComponent, index_Name as Name, index_Object3DRef as Object3DRef, index_ParentId as ParentId, index_PhysicsComponent as PhysicsComponent, index_PhysicsState as PhysicsState, index_PlaneMeshParameters as PlaneMeshParameters, index_Postprocessing as Postprocessing, index_PostprocessingState as PostprocessingState, index_PrefabInstance as PrefabInstance, index_PrefabNode as PrefabNode, index_RadiusHeightMeshParameters as RadiusHeightMeshParameters, index_RadiusMeshParameters as RadiusMeshParameters, index_RigidbodyState as RigidbodyState, index_RigidbodyType as RigidbodyType, index_ScriptComponent as ScriptComponent, index_ScriptEntry as ScriptEntry, index_ScriptObjectComponent as ScriptObjectComponent, index_ScriptObjectComponentInput as ScriptObjectComponentInput, index_ScriptObjectRuntimeState as ScriptObjectRuntimeState, index_Selectable as Selectable, index_SelectionTransformState as SelectionTransformState, index_SpriteComponent as SpriteComponent, index_TextureFilteringValue as TextureFilteringValue, index_TransformComponent as TransformComponent, index_TransformData as TransformData, index_TransformModeValue as TransformModeValue, index_TransformSpaceValue as TransformSpaceValue, index_VRTeleportAreaComponent as VRTeleportAreaComponent, index_VRTeleportAreaOptions as VRTeleportAreaOptions, index_Vec3 as Vec3, index_VideoComponent as VideoComponent, index_VrTeleportShape as VrTeleportShape, index_XRHandPoseComponent as XRHandPoseComponent, index_XRHandPoseOptions as XRHandPoseOptions, index_XRInteractableComponent as XRInteractableComponent, index_XRInteractableOptions as XRInteractableOptions, index_XRInteractorComponent as XRInteractorComponent, index_XRInteractorOptions as XRInteractorOptions, index_XRInteractorSideComponent as XRInteractorSideComponent, index_XRRigComponent as XRRigComponent, index_XRRigOptions as XRRigOptions, index_XrAttachPoint as XrAttachPoint, index_XrDistanceGrabBehavior as XrDistanceGrabBehavior, index_XrGrabGesture as XrGrabGesture, index_XrGrabHands as XrGrabHands, index_XrGrabReach as XrGrabReach, index_XrHandPoseEntry as XrHandPoseEntry, index_XrHandPreset as XrHandPreset, index_XrInteractorSide as XrInteractorSide, index_XrInteractorType as XrInteractorType, index_XrLocomotionMode as XrLocomotionMode, index_XrTrackingOrigin as XrTrackingOrigin, index_XrTwoHandRotation as XrTwoHandRotation, index_createAttachPoint as createAttachPoint, index_createHandPoseEntry as createHandPoseEntry, index_defaultMaterialValue as defaultMaterialValue, index_handPoseDefinitionFor as handPoseDefinitionFor, index_normalizePhysicsState as normalizePhysicsState, index_setPhysicsLiveRef as setPhysicsLiveRef };
 }
 
 export { PrefabInstance as P, PrefabNode as a, index as i };

package/dist/{index-CA9fqh4Z.d.cts → index-g777AmFv.d.cts}

@@ -1,4 +1,4 @@
-import { A as AnimationComponent, a as AnimationComponentOptions, b as AudioComponent, C as CameraComponent, c as CameraComponentOptions, d as CameraProjection, e as CameraRuntimeType, f as ColliderShape, g as ColliderState, h as CubeMeshParameters, D as DEFAULT_COLLIDER_STATE, i as DEFAULT_INSTANCED_MESH_PARAMETERS, j as DEFAULT_INSTANCE_TRANSFORM, k as DEFAULT_MESH_GEOMETRY_PARAMETERS, l as DEFAULT_PHYSICS_STATE, m as DEFAULT_POSE_CURLS, n as DEFAULT_RIGIDBODY_STATE, E as EditableMeshObjectKind, o as EntityType, I as ImageComponent, p as ImageTarget, q as ImageTargetAnchor, r as ImageTargetAnchorOptions, s as ImageTargetReference, t as InstanceSlotComponent, u as InstanceTransform, v as InstancedMeshComponent, w as InstancedMeshKind, L as LightComponent, x as LightValueState, M as MaterialComponent, y as MaterialTypeValue, z as MaterialValueState, B as MeshComponent, F as MeshGeometryComponent, G as MeshGeometryParameters, H as MeshGeometryParametersByKind, J as ModelComponent, N as Name, O as Object3DRef, P as PhysicsComponent, K as PhysicsState, Q as PlaneMeshParameters, R as RadiusHeightMeshParameters, S as RadiusMeshParameters, T as RigidbodyState, U as RigidbodyType, V as ScriptComponent, W as ScriptEntry, X as ScriptObjectComponent, Y as ScriptObjectComponentInput, Z as ScriptObjectRuntimeState, _ as Selectable, $ as SelectionTransformState, a0 as SpriteComponent, a1 as TextureFilteringValue, a2 as TransformModeValue, a3 as TransformSpaceValue, a4 as VRTeleportAreaComponent, a5 as VRTeleportAreaOptions, a6 as VideoComponent, a7 as VrTeleportShape, a8 as XRHandPoseComponent, a9 as XRHandPoseOptions, aa as XRInteractableComponent, ab as XRInteractableOptions, ac as XRInteractorComponent, ad as XRInteractorOptions, ae as XRInteractorSideComponent, af as XRRigComponent, ag as XRRigOptions, ah as XrAttachPoint, ai as XrDistanceGrabBehavior, aj as XrGrabGesture, ak as XrGrabHands, al as XrGrabReach, am as XrHandPoseEntry, an as XrHandPreset, ao as XrInteractorSide, ap as XrInteractorType, aq as XrLocomotionMode, ar as XrTrackingOrigin, as as XrTwoHandRotation, at as createAttachPoint, au as createHandPoseEntry, av as defaultMaterialValue, aw as handPoseDefinitionFor, ax as normalizePhysicsState, ay as setPhysicsLiveRef } from './XRHandPose-B8xxFb9A.cjs';
+import { A as AnimationComponent, a as AnimationComponentOptions, b as AudioComponent, C as CameraComponent, c as CameraComponentOptions, d as CameraProjection, e as CameraRuntimeType, f as ColliderShape, g as ColliderState, h as CubeMeshParameters, D as DEFAULT_COLLIDER_STATE, i as DEFAULT_INSTANCED_MESH_PARAMETERS, j as DEFAULT_INSTANCE_TRANSFORM, k as DEFAULT_MESH_GEOMETRY_PARAMETERS, l as DEFAULT_PHYSICS_STATE, m as DEFAULT_POSE_CURLS, n as DEFAULT_POSE_DIRECTIONS, o as DEFAULT_RIGIDBODY_STATE, E as EditableMeshObjectKind, p as EntityType, I as ImageComponent, q as ImageTarget, r as ImageTargetAnchor, s as ImageTargetAnchorOptions, t as ImageTargetReference, u as InstanceSlotComponent, v as InstanceTransform, w as InstancedMeshComponent, x as InstancedMeshKind, L as LightComponent, y as LightValueState, M as MaterialComponent, z as MaterialTypeValue, B as MaterialValueState, F as MeshComponent, G as MeshGeometryComponent, H as MeshGeometryParameters, J as MeshGeometryParametersByKind, K as ModelComponent, N as Name, O as Object3DRef, P as PhysicsComponent, Q as PhysicsState, R as PlaneMeshParameters, S as RadiusHeightMeshParameters, T as RadiusMeshParameters, U as RigidbodyState, V as RigidbodyType, W as ScriptComponent, X as ScriptEntry, Y as ScriptObjectComponent, Z as ScriptObjectComponentInput, _ as ScriptObjectRuntimeState, $ as Selectable, a0 as SelectionTransformState, a1 as SpriteComponent, a2 as TextureFilteringValue, a3 as TransformModeValue, a4 as TransformSpaceValue, a5 as VRTeleportAreaComponent, a6 as VRTeleportAreaOptions, a7 as VideoComponent, a8 as VrTeleportShape, a9 as XRHandPoseComponent, aa as XRHandPoseOptions, ab as XRInteractableComponent, ac as XRInteractableOptions, ad as XRInteractorComponent, ae as XRInteractorOptions, af as XRInteractorSideComponent, ag as XRRigComponent, ah as XRRigOptions, ai as XrAttachPoint, aj as XrDistanceGrabBehavior, ak as XrGrabGesture, al as XrGrabHands, am as XrGrabReach, an as XrHandPoseEntry, ao as XrHandPreset, ap as XrInteractorSide, aq as XrInteractorType, ar as XrLocomotionMode, as as XrTrackingOrigin, at as XrTwoHandRotation, au as createAttachPoint, av as createHandPoseEntry, aw as defaultMaterialValue, ax as handPoseDefinitionFor, ay as normalizePhysicsState, az as setPhysicsLiveRef } from './XRHandPose-CLl4MiHx.cjs';
 import { C as Component, D as DEFAULT_ENVIRONMENT_STATE, a as DEFAULT_POSTPROCESSING_STATE, E as Environment, b as EnvironmentFogState, c as EnvironmentFogType, d as EnvironmentGradientEffect, e as EnvironmentSkyboxState, f as EnvironmentSkyboxType, g as EnvironmentState, P as ParentId, h as Postprocessing, i as PostprocessingState, T as TransformComponent, j as TransformData, V as Vec3 } from './System-BhnLw0fZ.cjs';
 
 /**
@@ -85,6 +85,7 @@ declare const index_DEFAULT_INSTANCE_TRANSFORM: typeof DEFAULT_INSTANCE_TRANSFOR
 declare const index_DEFAULT_MESH_GEOMETRY_PARAMETERS: typeof DEFAULT_MESH_GEOMETRY_PARAMETERS;
 declare const index_DEFAULT_PHYSICS_STATE: typeof DEFAULT_PHYSICS_STATE;
 declare const index_DEFAULT_POSE_CURLS: typeof DEFAULT_POSE_CURLS;
+declare const index_DEFAULT_POSE_DIRECTIONS: typeof DEFAULT_POSE_DIRECTIONS;
 declare const index_DEFAULT_POSTPROCESSING_STATE: typeof DEFAULT_POSTPROCESSING_STATE;
 declare const index_DEFAULT_RIGIDBODY_STATE: typeof DEFAULT_RIGIDBODY_STATE;
 declare const index_EditableMeshObjectKind: typeof EditableMeshObjectKind;
@@ -177,7 +178,7 @@ declare const index_handPoseDefinitionFor: typeof handPoseDefinitionFor;
 declare const index_normalizePhysicsState: typeof normalizePhysicsState;
 declare const index_setPhysicsLiveRef: typeof setPhysicsLiveRef;
 declare namespace index {
-  export { index_AnimationComponent as AnimationComponent, index_AnimationComponentOptions as AnimationComponentOptions, index_AudioComponent as AudioComponent, index_CameraComponent as CameraComponent, index_CameraComponentOptions as CameraComponentOptions, index_CameraProjection as CameraProjection, index_CameraRuntimeType as CameraRuntimeType, index_ColliderShape as ColliderShape, index_ColliderState as ColliderState, index_CubeMeshParameters as CubeMeshParameters, index_DEFAULT_COLLIDER_STATE as DEFAULT_COLLIDER_STATE, index_DEFAULT_ENVIRONMENT_STATE as DEFAULT_ENVIRONMENT_STATE, index_DEFAULT_INSTANCED_MESH_PARAMETERS as DEFAULT_INSTANCED_MESH_PARAMETERS, index_DEFAULT_INSTANCE_TRANSFORM as DEFAULT_INSTANCE_TRANSFORM, index_DEFAULT_MESH_GEOMETRY_PARAMETERS as DEFAULT_MESH_GEOMETRY_PARAMETERS, index_DEFAULT_PHYSICS_STATE as DEFAULT_PHYSICS_STATE, index_DEFAULT_POSE_CURLS as DEFAULT_POSE_CURLS, index_DEFAULT_POSTPROCESSING_STATE as DEFAULT_POSTPROCESSING_STATE, index_DEFAULT_RIGIDBODY_STATE as DEFAULT_RIGIDBODY_STATE, index_EditableMeshObjectKind as EditableMeshObjectKind, index_EntityType as EntityType, index_Environment as Environment, index_EnvironmentFogState as EnvironmentFogState, index_EnvironmentFogType as EnvironmentFogType, index_EnvironmentGradientEffect as EnvironmentGradientEffect, index_EnvironmentSkyboxState as EnvironmentSkyboxState, index_EnvironmentSkyboxType as EnvironmentSkyboxType, index_EnvironmentState as EnvironmentState, index_ImageComponent as ImageComponent, index_ImageTarget as ImageTarget, index_ImageTargetAnchor as ImageTargetAnchor, index_ImageTargetAnchorOptions as ImageTargetAnchorOptions, index_ImageTargetReference as ImageTargetReference, index_InstanceSlotComponent as InstanceSlotComponent, index_InstanceTransform as InstanceTransform, index_InstancedMeshComponent as InstancedMeshComponent, index_InstancedMeshKind as InstancedMeshKind, index_LightComponent as LightComponent, index_LightValueState as LightValueState, index_MaterialComponent as MaterialComponent, index_MaterialTypeValue as MaterialTypeValue, index_MaterialValueState as MaterialValueState, index_MeshComponent as MeshComponent, index_MeshGeometryComponent as MeshGeometryComponent, index_MeshGeometryParameters as MeshGeometryParameters, index_MeshGeometryParametersByKind as MeshGeometryParametersByKind, index_ModelComponent as ModelComponent, index_Name as Name, index_Object3DRef as Object3DRef, index_ParentId as ParentId, index_PhysicsComponent as PhysicsComponent, index_PhysicsState as PhysicsState, index_PlaneMeshParameters as PlaneMeshParameters, index_Postprocessing as Postprocessing, index_PostprocessingState as PostprocessingState, index_PrefabInstance as PrefabInstance, index_PrefabNode as PrefabNode, index_RadiusHeightMeshParameters as RadiusHeightMeshParameters, index_RadiusMeshParameters as RadiusMeshParameters, index_RigidbodyState as RigidbodyState, index_RigidbodyType as RigidbodyType, index_ScriptComponent as ScriptComponent, index_ScriptEntry as ScriptEntry, index_ScriptObjectComponent as ScriptObjectComponent, index_ScriptObjectComponentInput as ScriptObjectComponentInput, index_ScriptObjectRuntimeState as ScriptObjectRuntimeState, index_Selectable as Selectable, index_SelectionTransformState as SelectionTransformState, index_SpriteComponent as SpriteComponent, index_TextureFilteringValue as TextureFilteringValue, index_TransformComponent as TransformComponent, index_TransformData as TransformData, index_TransformModeValue as TransformModeValue, index_TransformSpaceValue as TransformSpaceValue, index_VRTeleportAreaComponent as VRTeleportAreaComponent, index_VRTeleportAreaOptions as VRTeleportAreaOptions, index_Vec3 as Vec3, index_VideoComponent as VideoComponent, index_VrTeleportShape as VrTeleportShape, index_XRHandPoseComponent as XRHandPoseComponent, index_XRHandPoseOptions as XRHandPoseOptions, index_XRInteractableComponent as XRInteractableComponent, index_XRInteractableOptions as XRInteractableOptions, index_XRInteractorComponent as XRInteractorComponent, index_XRInteractorOptions as XRInteractorOptions, index_XRInteractorSideComponent as XRInteractorSideComponent, index_XRRigComponent as XRRigComponent, index_XRRigOptions as XRRigOptions, index_XrAttachPoint as XrAttachPoint, index_XrDistanceGrabBehavior as XrDistanceGrabBehavior, index_XrGrabGesture as XrGrabGesture, index_XrGrabHands as XrGrabHands, index_XrGrabReach as XrGrabReach, index_XrHandPoseEntry as XrHandPoseEntry, index_XrHandPreset as XrHandPreset, index_XrInteractorSide as XrInteractorSide, index_XrInteractorType as XrInteractorType, index_XrLocomotionMode as XrLocomotionMode, index_XrTrackingOrigin as XrTrackingOrigin, index_XrTwoHandRotation as XrTwoHandRotation, index_createAttachPoint as createAttachPoint, index_createHandPoseEntry as createHandPoseEntry, index_defaultMaterialValue as defaultMaterialValue, index_handPoseDefinitionFor as handPoseDefinitionFor, index_normalizePhysicsState as normalizePhysicsState, index_setPhysicsLiveRef as setPhysicsLiveRef };
+  export { index_AnimationComponent as AnimationComponent, index_AnimationComponentOptions as AnimationComponentOptions, index_AudioComponent as AudioComponent, index_CameraComponent as CameraComponent, index_CameraComponentOptions as CameraComponentOptions, index_CameraProjection as CameraProjection, index_CameraRuntimeType as CameraRuntimeType, index_ColliderShape as ColliderShape, index_ColliderState as ColliderState, index_CubeMeshParameters as CubeMeshParameters, index_DEFAULT_COLLIDER_STATE as DEFAULT_COLLIDER_STATE, index_DEFAULT_ENVIRONMENT_STATE as DEFAULT_ENVIRONMENT_STATE, index_DEFAULT_INSTANCED_MESH_PARAMETERS as DEFAULT_INSTANCED_MESH_PARAMETERS, index_DEFAULT_INSTANCE_TRANSFORM as DEFAULT_INSTANCE_TRANSFORM, index_DEFAULT_MESH_GEOMETRY_PARAMETERS as DEFAULT_MESH_GEOMETRY_PARAMETERS, index_DEFAULT_PHYSICS_STATE as DEFAULT_PHYSICS_STATE, index_DEFAULT_POSE_CURLS as DEFAULT_POSE_CURLS, index_DEFAULT_POSE_DIRECTIONS as DEFAULT_POSE_DIRECTIONS, index_DEFAULT_POSTPROCESSING_STATE as DEFAULT_POSTPROCESSING_STATE, index_DEFAULT_RIGIDBODY_STATE as DEFAULT_RIGIDBODY_STATE, index_EditableMeshObjectKind as EditableMeshObjectKind, index_EntityType as EntityType, index_Environment as Environment, index_EnvironmentFogState as EnvironmentFogState, index_EnvironmentFogType as EnvironmentFogType, index_EnvironmentGradientEffect as EnvironmentGradientEffect, index_EnvironmentSkyboxState as EnvironmentSkyboxState, index_EnvironmentSkyboxType as EnvironmentSkyboxType, index_EnvironmentState as EnvironmentState, index_ImageComponent as ImageComponent, index_ImageTarget as ImageTarget, index_ImageTargetAnchor as ImageTargetAnchor, index_ImageTargetAnchorOptions as ImageTargetAnchorOptions, index_ImageTargetReference as ImageTargetReference, index_InstanceSlotComponent as InstanceSlotComponent, index_InstanceTransform as InstanceTransform, index_InstancedMeshComponent as InstancedMeshComponent, index_InstancedMeshKind as InstancedMeshKind, index_LightComponent as LightComponent, index_LightValueState as LightValueState, index_MaterialComponent as MaterialComponent, index_MaterialTypeValue as MaterialTypeValue, index_MaterialValueState as MaterialValueState, index_MeshComponent as MeshComponent, index_MeshGeometryComponent as MeshGeometryComponent, index_MeshGeometryParameters as MeshGeometryParameters, index_MeshGeometryParametersByKind as MeshGeometryParametersByKind, index_ModelComponent as ModelComponent, index_Name as Name, index_Object3DRef as Object3DRef, index_ParentId as ParentId, index_PhysicsComponent as PhysicsComponent, index_PhysicsState as PhysicsState, index_PlaneMeshParameters as PlaneMeshParameters, index_Postprocessing as Postprocessing, index_PostprocessingState as PostprocessingState, index_PrefabInstance as PrefabInstance, index_PrefabNode as PrefabNode, index_RadiusHeightMeshParameters as RadiusHeightMeshParameters, index_RadiusMeshParameters as RadiusMeshParameters, index_RigidbodyState as RigidbodyState, index_RigidbodyType as RigidbodyType, index_ScriptComponent as ScriptComponent, index_ScriptEntry as ScriptEntry, index_ScriptObjectComponent as ScriptObjectComponent, index_ScriptObjectComponentInput as ScriptObjectComponentInput, index_ScriptObjectRuntimeState as ScriptObjectRuntimeState, index_Selectable as Selectable, index_SelectionTransformState as SelectionTransformState, index_SpriteComponent as SpriteComponent, index_TextureFilteringValue as TextureFilteringValue, index_TransformComponent as TransformComponent, index_TransformData as TransformData, index_TransformModeValue as TransformModeValue, index_TransformSpaceValue as TransformSpaceValue, index_VRTeleportAreaComponent as VRTeleportAreaComponent, index_VRTeleportAreaOptions as VRTeleportAreaOptions, index_Vec3 as Vec3, index_VideoComponent as VideoComponent, index_VrTeleportShape as VrTeleportShape, index_XRHandPoseComponent as XRHandPoseComponent, index_XRHandPoseOptions as XRHandPoseOptions, index_XRInteractableComponent as XRInteractableComponent, index_XRInteractableOptions as XRInteractableOptions, index_XRInteractorComponent as XRInteractorComponent, index_XRInteractorOptions as XRInteractorOptions, index_XRInteractorSideComponent as XRInteractorSideComponent, index_XRRigComponent as XRRigComponent, index_XRRigOptions as XRRigOptions, index_XrAttachPoint as XrAttachPoint, index_XrDistanceGrabBehavior as XrDistanceGrabBehavior, index_XrGrabGesture as XrGrabGesture, index_XrGrabHands as XrGrabHands, index_XrGrabReach as XrGrabReach, index_XrHandPoseEntry as XrHandPoseEntry, index_XrHandPreset as XrHandPreset, index_XrInteractorSide as XrInteractorSide, index_XrInteractorType as XrInteractorType, index_XrLocomotionMode as XrLocomotionMode, index_XrTrackingOrigin as XrTrackingOrigin, index_XrTwoHandRotation as XrTwoHandRotation, index_createAttachPoint as createAttachPoint, index_createHandPoseEntry as createHandPoseEntry, index_defaultMaterialValue as defaultMaterialValue, index_handPoseDefinitionFor as handPoseDefinitionFor, index_normalizePhysicsState as normalizePhysicsState, index_setPhysicsLiveRef as setPhysicsLiveRef };
 }
 
 export { PrefabInstance as P, PrefabNode as a, index as i };

package/dist/index.cjs

@@ -2729,15 +2729,22 @@ function getHandPosePreset(id) {
   return cloneHandPose(preset);
 }
 __name(getHandPosePreset, "getHandPosePreset");
+function cloneTarget(target) {
+  return {
+    ...target,
+    ...target.directions ? { directions: [...target.directions] } : {}
+  };
+}
+__name(cloneTarget, "cloneTarget");
 function cloneHandPose(definition) {
   return {
     ...definition,
     fingers: {
-      thumb: { ...definition.fingers.thumb },
-      index: { ...definition.fingers.index },
-      middle: { ...definition.fingers.middle },
-      ring: { ...definition.fingers.ring },
-      pinky: { ...definition.fingers.pinky }
+      thumb: cloneTarget(definition.fingers.thumb),
+      index: cloneTarget(definition.fingers.index),
+      middle: cloneTarget(definition.fingers.middle),
+      ring: cloneTarget(definition.fingers.ring),
+      pinky: cloneTarget(definition.fingers.pinky)
     },
     pinch: definition.pinch ? { ...definition.pinch } : void 0,
     orientation: definition.orientation ? { ...definition.orientation } : void 0
@@ -2746,22 +2753,27 @@ function cloneHandPose(definition) {
 __name(cloneHandPose, "cloneHandPose");
 function handPoseFromCurls(id, name, curls, options) {
   const tolerance = options?.tolerance ?? NARROW;
-  const target = /* @__PURE__ */ __name((curl) => ({
-    curl: Math.min(1, Math.max(0, curl)),
-    tolerance
-  }), "target");
+  const target = /* @__PURE__ */ __name((finger, curl) => {
+    const directions = options?.directions?.[finger];
+    return {
+      curl: Math.min(1, Math.max(0, curl)),
+      tolerance,
+      ...directions && directions.length > 0 ? { directions } : {}
+    };
+  }, "target");
   return {
     id,
     name,
     fingers: {
-      thumb: target(curls.thumb),
-      index: target(curls.index),
-      middle: target(curls.middle),
-      ring: target(curls.ring),
-      pinky: target(curls.pinky)
+      thumb: target("thumb", curls.thumb),
+      index: target("index", curls.index),
+      middle: target("middle", curls.middle),
+      ring: target("ring", curls.ring),
+      pinky: target("pinky", curls.pinky)
     },
     pinch: options?.pinch,
     orientation: options?.orientation,
+    directionToleranceDegrees: options?.directionToleranceDegrees,
     hand: options?.hand
   };
 }
@@ -2775,6 +2787,13 @@ var DEFAULT_POSE_CURLS = {
   ring: 0,
   pinky: 0
 };
+var DEFAULT_POSE_DIRECTIONS = {
+  thumb: [],
+  index: [],
+  middle: [],
+  ring: [],
+  pinky: []
+};
 function createHandPoseEntry(partial) {
   return {
     id: partial.id,
@@ -2782,6 +2801,14 @@ function createHandPoseEntry(partial) {
     preset: partial.preset ?? null,
     curls: { ...DEFAULT_POSE_CURLS, ...partial.curls },
     tolerance: partial.tolerance ?? 0.25,
+    directions: {
+      thumb: [...partial.directions?.thumb ?? []],
+      index: [...partial.directions?.index ?? []],
+      middle: [...partial.directions?.middle ?? []],
+      ring: [...partial.directions?.ring ?? []],
+      pinky: [...partial.directions?.pinky ?? []]
+    },
+    directionTolerance: partial.directionTolerance ?? 45,
     hand: partial.hand ?? null,
     orientation: partial.orientation ?? null,
     minHoldSeconds: partial.minHoldSeconds ?? 0.15,
@@ -2804,7 +2831,9 @@ function handPoseDefinitionFor(entry, resolvePreset) {
   return handPoseFromCurls(entry.id, entry.name, entry.curls, {
     tolerance: entry.tolerance,
     orientation: entry.orientation ?? void 0,
-    hand: entry.hand ?? void 0
+    hand: entry.hand ?? void 0,
+    directions: entry.directions,
+    directionToleranceDegrees: entry.directionTolerance
   });
 }
 __name(handPoseDefinitionFor, "handPoseDefinitionFor");
@@ -3960,6 +3989,7 @@ __export(components_exports, {
   DEFAULT_MESH_GEOMETRY_PARAMETERS: () => DEFAULT_MESH_GEOMETRY_PARAMETERS,
   DEFAULT_PHYSICS_STATE: () => DEFAULT_PHYSICS_STATE,
   DEFAULT_POSE_CURLS: () => DEFAULT_POSE_CURLS,
+  DEFAULT_POSE_DIRECTIONS: () => DEFAULT_POSE_DIRECTIONS,
   DEFAULT_POSTPROCESSING_STATE: () => DEFAULT_POSTPROCESSING_STATE,
   DEFAULT_RIGIDBODY_STATE: () => DEFAULT_RIGIDBODY_STATE,
   EntityType: () => EntityType,
@@ -10989,6 +11019,25 @@ var _XRInputSystem = class _XRInputSystem {
     }
     return null;
   }
+  /**
+   * The ARTICULATED source for a hand — the one carrying joint poses.
+   *
+   * Distinct from {@link getInput} because a hand can be backed by several
+   * sources at once: a Quest reports a controller AND a tracked hand for the
+   * same handedness, and Vision Pro adds a transient pinch alongside its two
+   * persistent hands. `getInput` returns whichever was seen first, so anything
+   * needing JOINTS has to ask for them specifically — taking the first match
+   * silently handed pose detection a controller with no joints, and no pose
+   * ever fired.
+   */
+  getHandInput(handedness) {
+    for (const record of this.records.values()) {
+      const state = record.state;
+      if (state.handedness !== handedness) continue;
+      if (state.joints) return state;
+    }
+    return null;
+  }
   /** True while ANY source is selecting — the portable "is the user acting" check. */
   isSelecting() {
     for (const record of this.records.values()) {
@@ -13032,10 +13081,22 @@ function computeHandShape(joints, handedness) {
     const direction = new THREE51__namespace.Vector3().subVectors(thumbTip, thumbBase);
     if (direction.lengthSq() > 1e-12) thumbDirection = direction.normalize();
   }
+  const fingerDirections = {};
+  for (const finger of XR_FINGERS) {
+    const base = joints[METACARPAL_JOINTS[finger]];
+    const tip = joints[TIP_JOINTS[finger]];
+    if (!base || !tip) {
+      fingerDirections[finger] = null;
+      continue;
+    }
+    const direction = new THREE51__namespace.Vector3().subVectors(tip, base);
+    fingerDirections[finger] = direction.lengthSq() > 1e-12 ? direction.normalize() : null;
+  }
   return {
     handedness,
     fingers: fingers2,
     pinch,
+    fingerDirections,
     spread: {
       thumbIndex: computeSpread(joints, "thumb", "index") ?? 0,
       indexMiddle: computeSpread(joints, "index", "middle") ?? 0,
@@ -13060,6 +13121,7 @@ function scoreAgainst(actual, target, tolerance) {
   return clamp01(1 - (error - tolerance) / MATCH_FALLOFF);
 }
 __name(scoreAgainst, "scoreAgainst");
+var DEFAULT_DIRECTION_TOLERANCE = 45;
 var WORLD_DIRECTIONS = {
   up: new THREE51__namespace.Vector3(0, 1, 0),
   down: new THREE51__namespace.Vector3(0, -1, 0),
@@ -13087,6 +13149,22 @@ function resolveDirection(direction, shape, context) {
   return direction === "toward-head" ? toHead : toHead.multiplyScalar(-1);
 }
 __name(resolveDirection, "resolveDirection");
+function scoreDirections(actual, accepted, shape, toleranceDegrees, context) {
+  if (!actual) return 0;
+  let best = 0;
+  for (const direction of accepted) {
+    const wanted = resolveDirection(direction, shape, context);
+    if (!wanted) continue;
+    const angle = THREE51__namespace.MathUtils.radToDeg(
+      Math.acos(THREE51__namespace.MathUtils.clamp(actual.dot(wanted), -1, 1))
+    );
+    const normalizedError = Math.max(0, angle - toleranceDegrees) / 90;
+    const score = clamp01(1 - normalizedError / MATCH_FALLOFF);
+    if (score > best) best = score;
+  }
+  return best;
+}
+__name(scoreDirections, "scoreDirections");
 function matchHandPose(shape, definition, context) {
   if (definition.hand && definition.hand !== shape.handedness) return NO_MATCH;
   let confidence = 1;
@@ -13116,6 +13194,18 @@ function matchHandPose(shape, definition, context) {
         `${finger} tip`
       );
     }
+    if (target.directions && target.directions.length > 0) {
+      consider(
+        scoreDirections(
+          shape.fingerDirections[finger],
+          target.directions,
+          shape,
+          definition.directionToleranceDegrees ?? DEFAULT_DIRECTION_TOLERANCE,
+          context
+        ),
+        `${finger} direction`
+      );
+    }
   }
   if (definition.pinch) {
     const { finger, target, tolerance } = definition.pinch;
@@ -13212,6 +13302,8 @@ var _XRHandPoseSystem = class _XRHandPoseSystem {
     /** Reused so head-relative orientation checks allocate nothing per frame. */
     this.headPosition = new THREE51__namespace.Vector3();
     this.elapsed = 0;
+    this.warnedNoHands = false;
+    this.noHandSeconds = 0;
     this.inputSystem = inputSystem;
   }
   update(world, deltaTime) {
@@ -13223,6 +13315,20 @@ var _XRHandPoseSystem = class _XRHandPoseSystem {
     this.refreshShapes();
     const entries = this.collectEntries(world);
     if (entries.length === 0) return;
+    if (!this.warnedNoHands) {
+      const tracked = this.shapes.get("left") !== null || this.shapes.get("right") !== null;
+      if (tracked) {
+        this.warnedNoHands = true;
+      } else {
+        this.noHandSeconds += deltaTime;
+        if (this.noHandSeconds > 5) {
+          this.warnedNoHands = true;
+          console.warn(
+            "[XRHandPoseSystem] Hand poses are configured but no tracked hands have been seen. Hand poses need HAND TRACKING \u2014 put the controllers down and enable hand tracking on the headset."
+          );
+        }
+      }
+    }
     world.getCamera().getWorldPosition(this.headPosition);
     const context = { headPosition: this.headPosition };
     for (const { entityId, entry } of entries) {
@@ -13267,7 +13373,7 @@ var _XRHandPoseSystem = class _XRHandPoseSystem {
   /** Derive each hand's shape once for the whole frame. */
   refreshShapes() {
     for (const handedness of ["left", "right"]) {
-      const input = this.inputSystem.getInput(handedness);
+      const input = this.inputSystem.getHandInput(handedness);
       const joints = input?.joints ?? null;
       this.shapes.set(
         handedness,
@@ -14864,6 +14970,7 @@ exports.CURLED_COS = CURLED_COS;
 exports.CameraSyncSystem = CameraSyncSystem;
 exports.Component = Component;
 exports.CoreComponents = components_exports;
+exports.DEFAULT_DIRECTION_TOLERANCE = DEFAULT_DIRECTION_TOLERANCE;
 exports.DEFAULT_ENTER_CONFIDENCE = DEFAULT_ENTER_CONFIDENCE;
 exports.DEFAULT_EXIT_CONFIDENCE = DEFAULT_EXIT_CONFIDENCE;
 exports.DEFAULT_LOST_GRACE_SECONDS = DEFAULT_LOST_GRACE_SECONDS;