@relu-interactives/spatial-ecs 0.3.6 → 0.3.8

package/dist/{System-TmC2EijF.d.cts → System-31wk-A0g.d.cts}

@@ -612,7 +612,7 @@ type CreateContext = {
     isEditor?: boolean;
 };
 type EntityFactory = (context: CreateContext) => EntityId;
-type EcsComponentFactoryKind = "animation" | "audio" | "camera" | "environment" | "entityType" | "image" | "imageTargetAnchor" | "imageTarget" | "light" | "material" | "mesh" | "meshGeometry" | "model" | "name" | "object3DRef" | "parentId" | "physics" | "postprocessing" | "script" | "scriptObject" | "selectable" | "selectionTransformState" | "sprite" | "transform" | "video" | "instancedMesh" | "xrRig" | "vrTeleportArea" | "xrInteractable" | "xrInteractor" | "xrInteractorSide";
+type EcsComponentFactoryKind = "animation" | "audio" | "camera" | "environment" | "entityType" | "image" | "imageTargetAnchor" | "imageTarget" | "light" | "material" | "mesh" | "meshGeometry" | "model" | "name" | "object3DRef" | "parentId" | "physics" | "postprocessing" | "script" | "scriptObject" | "selectable" | "selectionTransformState" | "sprite" | "transform" | "video" | "instancedMesh" | "xrRig" | "vrTeleportArea" | "xrHandPose" | "xrInteractable" | "xrInteractor" | "xrInteractorSide";
 type ComponentFactory = (world: World, entityId: EntityId, ...args: any[]) => unknown;
 declare class ObjectManagementSystem implements EcsSystem {
     private readonly scene;

package/dist/{System-TmC2EijF.d.ts → System-31wk-A0g.d.ts}

@@ -612,7 +612,7 @@ type CreateContext = {
     isEditor?: boolean;
 };
 type EntityFactory = (context: CreateContext) => EntityId;
-type EcsComponentFactoryKind = "animation" | "audio" | "camera" | "environment" | "entityType" | "image" | "imageTargetAnchor" | "imageTarget" | "light" | "material" | "mesh" | "meshGeometry" | "model" | "name" | "object3DRef" | "parentId" | "physics" | "postprocessing" | "script" | "scriptObject" | "selectable" | "selectionTransformState" | "sprite" | "transform" | "video" | "instancedMesh" | "xrRig" | "vrTeleportArea" | "xrInteractable" | "xrInteractor" | "xrInteractorSide";
+type EcsComponentFactoryKind = "animation" | "audio" | "camera" | "environment" | "entityType" | "image" | "imageTargetAnchor" | "imageTarget" | "light" | "material" | "mesh" | "meshGeometry" | "model" | "name" | "object3DRef" | "parentId" | "physics" | "postprocessing" | "script" | "scriptObject" | "selectable" | "selectionTransformState" | "sprite" | "transform" | "video" | "instancedMesh" | "xrRig" | "vrTeleportArea" | "xrHandPose" | "xrInteractable" | "xrInteractor" | "xrInteractorSide";
 type ComponentFactory = (world: World, entityId: EntityId, ...args: any[]) => unknown;
 declare class ObjectManagementSystem implements EcsSystem {
     private readonly scene;

package/dist/{XRInteractor-CCUzSqg9.d.ts → XRHandPose-CxPz8VBp.d.ts}

@@ -1,6 +1,7 @@
 import * as THREE from 'three';
-import { C as Component, p as EcsEntityKind, F as EcsEntityEditorKind, r as EntityId } from './System-TmC2EijF.js';
+import { C as Component, p as EcsEntityKind, F as EcsEntityEditorKind, r as EntityId } from './System-31wk-A0g.js';
 import * as RAPIER from '@dimforge/rapier3d-compat';
+import { a as XrFinger, b as XrHandPoseOrientation, X as XrHandPoseDefinition } from './handPose-dFxqbFFY.js';
 
 interface StateMachine {
     name: string;
@@ -1208,46 +1209,105 @@ declare class VRTeleportAreaComponent extends Component {
 }
 
 /**
- * How a grabbed entity behaves while held.
+ * How an entity behaves while held.
  *
- * `kinematic` snaps it to the hand and ignores physics — predictable, and the
- * right default. `physics` keeps the body simulated so it can collide while
- * held and carry momentum when thrown.
+ * `kinematic` snaps it to the hand and ignores physics — predictable, and right
+ * for tools and UI. `physics` keeps the body simulated so it can collide while
+ * held and, crucially, carry momentum when released (see {@link throwOnRelease}).
  */
 type XrGrabMode = "kinematic" | "physics";
+/**
+ * How close the user must be to grab.
+ *
+ * `physical` requires the hand to actually reach the object — the honest,
+ * embodied interaction. `distance` allows grabbing across the room along the
+ * pointer ray, which is what makes seated and room-scale play comfortable.
+ * `both` accepts either, and is the friendliest default.
+ */
+type XrGrabReach = "physical" | "distance" | "both";
+/**
+ * What a distance grab does to the object.
+ *
+ * `snap` brings it to the hand (Half-Life: Alyx style — good for picking things
+ * up). `remote` leaves it where it is and manipulates it at range, which suits
+ * large or anchored objects that would look absurd flying into your palm.
+ */
+type XrDistanceGrabBehavior = "snap" | "remote";
+/**
+ * Which gesture grabs the object.
+ *
+ * `pinch` maps to the primary action (trigger / finger pinch), `full` to the
+ * grip squeeze (whole-hand close). Distinguishing them lets a scene mix
+ * precise pickups with firm grabs — a chess piece versus a suitcase handle.
+ */
+type XrGrabGesture = "any" | "pinch" | "full";
 /** Optional initializer for {@link XRInteractableComponent}. */
 type XRInteractableOptions = {
-    /** Disable to keep the entity authored but non-interactive. */
     enabled?: boolean;
-    /** Can be picked up and held. */
     grabbable?: boolean;
-    /** Can be hit by a pointer ray (hover + select), without being grabbable. */
     pointable?: boolean;
-    /** Behaviour while held. */
     grabMode?: XrGrabMode;
-    /** Emphasize the entity while a pointer is over it. */
+    grabReach?: XrGrabReach;
+    distanceBehavior?: XrDistanceGrabBehavior;
+    grabGesture?: XrGrabGesture;
+    /** Metres within which a `physical` grab registers. */
+    grabRadius?: number;
+    /** Where the object sits relative to the hand once held. */
+    grabOffsetPosition?: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    /** Orientation offset, in radians. */
+    grabOffsetRotation?: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    /** Carry the hand's momentum into the body on release. */
+    throwOnRelease?: boolean;
+    /** Scales released velocity; >1 makes throws feel stronger than real life. */
+    throwStrength?: number;
     highlightOnHover?: boolean;
 };
 /**
  * Makes an entity respond to XR pointers and hands.
  *
- * Split into `pointable` and `grabbable` because they are genuinely different
- * affordances: a wall-mounted UI panel should receive select events without
- * being liftable, while a physics prop should be both. Interaction is opt-in
- * per entity so a scene's interactive surface is explicit.
+ * Split into `pointable` and `grabbable` because they are different
+ * affordances: a wall panel should receive select events without being
+ * liftable, while a physics prop should be both.
  *
  * @category Components
  */
 declare class XRInteractableComponent extends Component {
-    /** Whether this entity currently responds to XR input. */
     enabled: boolean;
-    /** Can be picked up and held. */
     grabbable: boolean;
-    /** Can be hit by a pointer ray. */
     pointable: boolean;
-    /** Behaviour while held. */
     grabMode: XrGrabMode;
-    /** Emphasize while hovered. */
+    /** Whether the object can be grabbed up close, at range, or either. */
+    grabReach: XrGrabReach;
+    /** What a distance grab does — bring it here, or manipulate it in place. */
+    distanceBehavior: XrDistanceGrabBehavior;
+    /** Which gesture grabs it. */
+    grabGesture: XrGrabGesture;
+    /** Metres within which a physical grab registers. */
+    grabRadius: number;
+    /** Position offset from the hand while held. */
+    grabOffsetPosition: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    /** Rotation offset (radians) while held. */
+    grabOffsetRotation: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    /** Carry hand momentum into the body on release. */
+    throwOnRelease: boolean;
+    /** Multiplier on released velocity. */
+    throwStrength: number;
     highlightOnHover: boolean;
     constructor(options?: XRInteractableOptions);
 }
@@ -1389,4 +1449,63 @@ declare class XRInteractorSideComponent extends Component {
     });
 }
 
-export { SpriteComponent as $, AnimationComponent as A, MeshGeometryComponent as B, CameraComponent as C, DEFAULT_COLLIDER_STATE as D, type EditableMeshObjectKind as E, type MeshGeometryParameters as F, type MeshGeometryParametersByKind as G, ModelComponent as H, ImageComponent as I, type PhysicsState as J, type PlaneMeshParameters as K, LightComponent as L, MaterialComponent as M, Name as N, Object3DRef as O, PhysicsComponent as P, type RadiusMeshParameters as Q, type RadiusHeightMeshParameters as R, type RigidbodyState as S, type RigidbodyType as T, ScriptComponent as U, type ScriptEntry as V, ScriptObjectComponent as W, type ScriptObjectComponentInput as X, type ScriptObjectRuntimeState as Y, Selectable as Z, SelectionTransformState as _, type AnimationComponentOptions as a, type TextureFilteringValue as a0, type TransformModeValue as a1, type TransformSpaceValue as a2, VRTeleportAreaComponent as a3, type VRTeleportAreaOptions as a4, VideoComponent as a5, type VrTeleportShape as a6, XRInteractableComponent as a7, type XRInteractableOptions as a8, XRInteractorComponent as a9, type XRInteractorOptions as aa, XRInteractorSideComponent as ab, XRRigComponent as ac, type XRRigOptions as ad, type XrGrabMode as ae, type XrHandPreset as af, type XrInteractorSide as ag, type XrInteractorType as ah, type XrLocomotionMode as ai, type XrTrackingOrigin as aj, defaultMaterialValue as ak, normalizePhysicsState as al, setPhysicsLiveRef as am, type AnimationStateCallbacks as an, AnimationStateMachine as ao, AnimationStateManager as ap, type StateMachine as aq, AudioComponent as b, type CameraComponentOptions as c, type CameraProjection as d, type CameraRuntimeType as e, type ColliderShape as f, type ColliderState as g, type CubeMeshParameters as h, DEFAULT_INSTANCED_MESH_PARAMETERS as i, DEFAULT_INSTANCE_TRANSFORM as j, DEFAULT_MESH_GEOMETRY_PARAMETERS as k, DEFAULT_PHYSICS_STATE as l, DEFAULT_RIGIDBODY_STATE as m, EntityType as n, ImageTarget as o, ImageTargetAnchor as p, type ImageTargetAnchorOptions as q, type ImageTargetReference as r, InstanceSlotComponent as s, type InstanceTransform as t, InstancedMeshComponent as u, type InstancedMeshKind as v, type LightValueState as w, type MaterialTypeValue as x, type MaterialValueState as y, MeshComponent as z };
+/**
+ * One pose an entity listens for.
+ *
+ * A pose is either a named PRESET or a CUSTOM set of finger curls. Storing the
+ * preset id rather than a copy of its numbers means a preset improved in a later
+ * release reaches existing scenes, while custom poses stay pinned to exactly
+ * what the author dialled in.
+ */
+type XrHandPoseEntry = {
+    /** Stable id, unique within the component. Used in Behaviour hooks. */
+    id: string;
+    /** Shown in the inspector and passed to scripts. */
+    name: string;
+    /** Preset id, or null for a custom pose. */
+    preset: string | null;
+    /** Per-finger curl targets, 0 extended → 1 curled. Custom poses only. */
+    curls: Record<XrFinger, number>;
+    /** Slack around each curl target. Larger is easier to perform. */
+    tolerance: number;
+    /** Which hand may trigger it; null for either. */
+    hand: "left" | "right" | null;
+    /** Optional direction requirement. */
+    orientation: XrHandPoseOrientation | null;
+    /** Seconds the pose must be held before it fires. */
+    minHoldSeconds: number;
+    enabled: boolean;
+};
+type XRHandPoseOptions = {
+    enabled?: boolean;
+    poses?: XrHandPoseEntry[];
+};
+declare const DEFAULT_POSE_CURLS: Record<XrFinger, number>;
+/** A pose entry with every field populated, for the editor and AI tools. */
+declare function createHandPoseEntry(partial: Partial<XrHandPoseEntry> & {
+    id: string;
+}): XrHandPoseEntry;
+/**
+ * Resolve an entry to the definition the matcher consumes.
+ *
+ * Preset entries defer to the shared library but still honour the entry's own
+ * hand restriction and hold time, so a scene can reuse "thumbs up" while
+ * scoping it to one hand.
+ */
+declare function handPoseDefinitionFor(entry: XrHandPoseEntry, resolvePreset: (id: string) => XrHandPoseDefinition | null): XrHandPoseDefinition | null;
+/**
+ * Listens for hand poses and reports them to the entity's Behaviours.
+ *
+ * Attached to any entity that wants to react to a gesture — the poses are
+ * detected on the user's hands, not on the entity, so this is a subscription
+ * rather than a property of the object itself.
+ *
+ * @category Components
+ */
+declare class XRHandPoseComponent extends Component {
+    enabled: boolean;
+    poses: XrHandPoseEntry[];
+    constructor(options?: XRHandPoseOptions);
+}
+
+export { SelectionTransformState as $, AnimationComponent as A, MeshComponent as B, CameraComponent as C, DEFAULT_COLLIDER_STATE as D, type EditableMeshObjectKind as E, MeshGeometryComponent as F, type MeshGeometryParameters as G, type MeshGeometryParametersByKind as H, ImageComponent as I, ModelComponent as J, type PhysicsState as K, LightComponent as L, MaterialComponent as M, Name as N, Object3DRef as O, PhysicsComponent as P, type PlaneMeshParameters as Q, type RadiusHeightMeshParameters as R, type RadiusMeshParameters as S, type RigidbodyState as T, type RigidbodyType as U, ScriptComponent as V, type ScriptEntry as W, ScriptObjectComponent as X, type ScriptObjectComponentInput as Y, type ScriptObjectRuntimeState as Z, Selectable as _, type AnimationComponentOptions as a, SpriteComponent as a0, type TextureFilteringValue as a1, type TransformModeValue as a2, type TransformSpaceValue as a3, VRTeleportAreaComponent as a4, type VRTeleportAreaOptions as a5, VideoComponent as a6, type VrTeleportShape as a7, XRHandPoseComponent as a8, type XRHandPoseOptions as a9, XRInteractableComponent as aa, type XRInteractableOptions as ab, XRInteractorComponent as ac, type XRInteractorOptions as ad, XRInteractorSideComponent as ae, XRRigComponent as af, type XRRigOptions as ag, type XrGrabMode as ah, type XrHandPoseEntry as ai, type XrHandPreset as aj, type XrInteractorSide as ak, type XrInteractorType as al, type XrLocomotionMode as am, type XrTrackingOrigin as an, createHandPoseEntry as ao, defaultMaterialValue as ap, handPoseDefinitionFor as aq, normalizePhysicsState as ar, setPhysicsLiveRef as as, type AnimationStateCallbacks as at, AnimationStateMachine as au, AnimationStateManager as av, type StateMachine as aw, AudioComponent as b, type CameraComponentOptions as c, type CameraProjection as d, type CameraRuntimeType as e, type ColliderShape as f, type ColliderState as g, type CubeMeshParameters as h, DEFAULT_INSTANCED_MESH_PARAMETERS as i, DEFAULT_INSTANCE_TRANSFORM as j, DEFAULT_MESH_GEOMETRY_PARAMETERS as k, DEFAULT_PHYSICS_STATE as l, DEFAULT_POSE_CURLS as m, DEFAULT_RIGIDBODY_STATE as n, EntityType as o, ImageTarget as p, ImageTargetAnchor as q, type ImageTargetAnchorOptions as r, type ImageTargetReference as s, InstanceSlotComponent as t, type InstanceTransform as u, InstancedMeshComponent as v, type InstancedMeshKind as w, type LightValueState as x, type MaterialTypeValue as y, type MaterialValueState as z };

package/dist/{XRInteractor-I2q6TKtF.d.cts → XRHandPose-VuSbe4iz.d.cts}

@@ -1,6 +1,7 @@
 import * as THREE from 'three';
-import { C as Component, p as EcsEntityKind, F as EcsEntityEditorKind, r as EntityId } from './System-TmC2EijF.cjs';
+import { C as Component, p as EcsEntityKind, F as EcsEntityEditorKind, r as EntityId } from './System-31wk-A0g.cjs';
 import * as RAPIER from '@dimforge/rapier3d-compat';
+import { a as XrFinger, b as XrHandPoseOrientation, X as XrHandPoseDefinition } from './handPose-dFxqbFFY.cjs';
 
 interface StateMachine {
     name: string;
@@ -1208,46 +1209,105 @@ declare class VRTeleportAreaComponent extends Component {
 }
 
 /**
- * How a grabbed entity behaves while held.
+ * How an entity behaves while held.
  *
- * `kinematic` snaps it to the hand and ignores physics — predictable, and the
- * right default. `physics` keeps the body simulated so it can collide while
- * held and carry momentum when thrown.
+ * `kinematic` snaps it to the hand and ignores physics — predictable, and right
+ * for tools and UI. `physics` keeps the body simulated so it can collide while
+ * held and, crucially, carry momentum when released (see {@link throwOnRelease}).
  */
 type XrGrabMode = "kinematic" | "physics";
+/**
+ * How close the user must be to grab.
+ *
+ * `physical` requires the hand to actually reach the object — the honest,
+ * embodied interaction. `distance` allows grabbing across the room along the
+ * pointer ray, which is what makes seated and room-scale play comfortable.
+ * `both` accepts either, and is the friendliest default.
+ */
+type XrGrabReach = "physical" | "distance" | "both";
+/**
+ * What a distance grab does to the object.
+ *
+ * `snap` brings it to the hand (Half-Life: Alyx style — good for picking things
+ * up). `remote` leaves it where it is and manipulates it at range, which suits
+ * large or anchored objects that would look absurd flying into your palm.
+ */
+type XrDistanceGrabBehavior = "snap" | "remote";
+/**
+ * Which gesture grabs the object.
+ *
+ * `pinch` maps to the primary action (trigger / finger pinch), `full` to the
+ * grip squeeze (whole-hand close). Distinguishing them lets a scene mix
+ * precise pickups with firm grabs — a chess piece versus a suitcase handle.
+ */
+type XrGrabGesture = "any" | "pinch" | "full";
 /** Optional initializer for {@link XRInteractableComponent}. */
 type XRInteractableOptions = {
-    /** Disable to keep the entity authored but non-interactive. */
     enabled?: boolean;
-    /** Can be picked up and held. */
     grabbable?: boolean;
-    /** Can be hit by a pointer ray (hover + select), without being grabbable. */
     pointable?: boolean;
-    /** Behaviour while held. */
     grabMode?: XrGrabMode;
-    /** Emphasize the entity while a pointer is over it. */
+    grabReach?: XrGrabReach;
+    distanceBehavior?: XrDistanceGrabBehavior;
+    grabGesture?: XrGrabGesture;
+    /** Metres within which a `physical` grab registers. */
+    grabRadius?: number;
+    /** Where the object sits relative to the hand once held. */
+    grabOffsetPosition?: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    /** Orientation offset, in radians. */
+    grabOffsetRotation?: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    /** Carry the hand's momentum into the body on release. */
+    throwOnRelease?: boolean;
+    /** Scales released velocity; >1 makes throws feel stronger than real life. */
+    throwStrength?: number;
     highlightOnHover?: boolean;
 };
 /**
  * Makes an entity respond to XR pointers and hands.
  *
- * Split into `pointable` and `grabbable` because they are genuinely different
- * affordances: a wall-mounted UI panel should receive select events without
- * being liftable, while a physics prop should be both. Interaction is opt-in
- * per entity so a scene's interactive surface is explicit.
+ * Split into `pointable` and `grabbable` because they are different
+ * affordances: a wall panel should receive select events without being
+ * liftable, while a physics prop should be both.
  *
  * @category Components
  */
 declare class XRInteractableComponent extends Component {
-    /** Whether this entity currently responds to XR input. */
     enabled: boolean;
-    /** Can be picked up and held. */
     grabbable: boolean;
-    /** Can be hit by a pointer ray. */
     pointable: boolean;
-    /** Behaviour while held. */
     grabMode: XrGrabMode;
-    /** Emphasize while hovered. */
+    /** Whether the object can be grabbed up close, at range, or either. */
+    grabReach: XrGrabReach;
+    /** What a distance grab does — bring it here, or manipulate it in place. */
+    distanceBehavior: XrDistanceGrabBehavior;
+    /** Which gesture grabs it. */
+    grabGesture: XrGrabGesture;
+    /** Metres within which a physical grab registers. */
+    grabRadius: number;
+    /** Position offset from the hand while held. */
+    grabOffsetPosition: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    /** Rotation offset (radians) while held. */
+    grabOffsetRotation: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    /** Carry hand momentum into the body on release. */
+    throwOnRelease: boolean;
+    /** Multiplier on released velocity. */
+    throwStrength: number;
     highlightOnHover: boolean;
     constructor(options?: XRInteractableOptions);
 }
@@ -1389,4 +1449,63 @@ declare class XRInteractorSideComponent extends Component {
     });
 }
 
-export { SpriteComponent as $, AnimationComponent as A, MeshGeometryComponent as B, CameraComponent as C, DEFAULT_COLLIDER_STATE as D, type EditableMeshObjectKind as E, type MeshGeometryParameters as F, type MeshGeometryParametersByKind as G, ModelComponent as H, ImageComponent as I, type PhysicsState as J, type PlaneMeshParameters as K, LightComponent as L, MaterialComponent as M, Name as N, Object3DRef as O, PhysicsComponent as P, type RadiusMeshParameters as Q, type RadiusHeightMeshParameters as R, type RigidbodyState as S, type RigidbodyType as T, ScriptComponent as U, type ScriptEntry as V, ScriptObjectComponent as W, type ScriptObjectComponentInput as X, type ScriptObjectRuntimeState as Y, Selectable as Z, SelectionTransformState as _, type AnimationComponentOptions as a, type TextureFilteringValue as a0, type TransformModeValue as a1, type TransformSpaceValue as a2, VRTeleportAreaComponent as a3, type VRTeleportAreaOptions as a4, VideoComponent as a5, type VrTeleportShape as a6, XRInteractableComponent as a7, type XRInteractableOptions as a8, XRInteractorComponent as a9, type XRInteractorOptions as aa, XRInteractorSideComponent as ab, XRRigComponent as ac, type XRRigOptions as ad, type XrGrabMode as ae, type XrHandPreset as af, type XrInteractorSide as ag, type XrInteractorType as ah, type XrLocomotionMode as ai, type XrTrackingOrigin as aj, defaultMaterialValue as ak, normalizePhysicsState as al, setPhysicsLiveRef as am, type AnimationStateCallbacks as an, AnimationStateMachine as ao, AnimationStateManager as ap, type StateMachine as aq, AudioComponent as b, type CameraComponentOptions as c, type CameraProjection as d, type CameraRuntimeType as e, type ColliderShape as f, type ColliderState as g, type CubeMeshParameters as h, DEFAULT_INSTANCED_MESH_PARAMETERS as i, DEFAULT_INSTANCE_TRANSFORM as j, DEFAULT_MESH_GEOMETRY_PARAMETERS as k, DEFAULT_PHYSICS_STATE as l, DEFAULT_RIGIDBODY_STATE as m, EntityType as n, ImageTarget as o, ImageTargetAnchor as p, type ImageTargetAnchorOptions as q, type ImageTargetReference as r, InstanceSlotComponent as s, type InstanceTransform as t, InstancedMeshComponent as u, type InstancedMeshKind as v, type LightValueState as w, type MaterialTypeValue as x, type MaterialValueState as y, MeshComponent as z };
+/**
+ * One pose an entity listens for.
+ *
+ * A pose is either a named PRESET or a CUSTOM set of finger curls. Storing the
+ * preset id rather than a copy of its numbers means a preset improved in a later
+ * release reaches existing scenes, while custom poses stay pinned to exactly
+ * what the author dialled in.
+ */
+type XrHandPoseEntry = {
+    /** Stable id, unique within the component. Used in Behaviour hooks. */
+    id: string;
+    /** Shown in the inspector and passed to scripts. */
+    name: string;
+    /** Preset id, or null for a custom pose. */
+    preset: string | null;
+    /** Per-finger curl targets, 0 extended → 1 curled. Custom poses only. */
+    curls: Record<XrFinger, number>;
+    /** Slack around each curl target. Larger is easier to perform. */
+    tolerance: number;
+    /** Which hand may trigger it; null for either. */
+    hand: "left" | "right" | null;
+    /** Optional direction requirement. */
+    orientation: XrHandPoseOrientation | null;
+    /** Seconds the pose must be held before it fires. */
+    minHoldSeconds: number;
+    enabled: boolean;
+};
+type XRHandPoseOptions = {
+    enabled?: boolean;
+    poses?: XrHandPoseEntry[];
+};
+declare const DEFAULT_POSE_CURLS: Record<XrFinger, number>;
+/** A pose entry with every field populated, for the editor and AI tools. */
+declare function createHandPoseEntry(partial: Partial<XrHandPoseEntry> & {
+    id: string;
+}): XrHandPoseEntry;
+/**
+ * Resolve an entry to the definition the matcher consumes.
+ *
+ * Preset entries defer to the shared library but still honour the entry's own
+ * hand restriction and hold time, so a scene can reuse "thumbs up" while
+ * scoping it to one hand.
+ */
+declare function handPoseDefinitionFor(entry: XrHandPoseEntry, resolvePreset: (id: string) => XrHandPoseDefinition | null): XrHandPoseDefinition | null;
+/**
+ * Listens for hand poses and reports them to the entity's Behaviours.
+ *
+ * Attached to any entity that wants to react to a gesture — the poses are
+ * detected on the user's hands, not on the entity, so this is a subscription
+ * rather than a property of the object itself.
+ *
+ * @category Components
+ */
+declare class XRHandPoseComponent extends Component {
+    enabled: boolean;
+    poses: XrHandPoseEntry[];
+    constructor(options?: XRHandPoseOptions);
+}
+
+export { SelectionTransformState as $, AnimationComponent as A, MeshComponent as B, CameraComponent as C, DEFAULT_COLLIDER_STATE as D, type EditableMeshObjectKind as E, MeshGeometryComponent as F, type MeshGeometryParameters as G, type MeshGeometryParametersByKind as H, ImageComponent as I, ModelComponent as J, type PhysicsState as K, LightComponent as L, MaterialComponent as M, Name as N, Object3DRef as O, PhysicsComponent as P, type PlaneMeshParameters as Q, type RadiusHeightMeshParameters as R, type RadiusMeshParameters as S, type RigidbodyState as T, type RigidbodyType as U, ScriptComponent as V, type ScriptEntry as W, ScriptObjectComponent as X, type ScriptObjectComponentInput as Y, type ScriptObjectRuntimeState as Z, Selectable as _, type AnimationComponentOptions as a, SpriteComponent as a0, type TextureFilteringValue as a1, type TransformModeValue as a2, type TransformSpaceValue as a3, VRTeleportAreaComponent as a4, type VRTeleportAreaOptions as a5, VideoComponent as a6, type VrTeleportShape as a7, XRHandPoseComponent as a8, type XRHandPoseOptions as a9, XRInteractableComponent as aa, type XRInteractableOptions as ab, XRInteractorComponent as ac, type XRInteractorOptions as ad, XRInteractorSideComponent as ae, XRRigComponent as af, type XRRigOptions as ag, type XrGrabMode as ah, type XrHandPoseEntry as ai, type XrHandPreset as aj, type XrInteractorSide as ak, type XrInteractorType as al, type XrLocomotionMode as am, type XrTrackingOrigin as an, createHandPoseEntry as ao, defaultMaterialValue as ap, handPoseDefinitionFor as aq, normalizePhysicsState as ar, setPhysicsLiveRef as as, type AnimationStateCallbacks as at, AnimationStateMachine as au, AnimationStateManager as av, type StateMachine as aw, AudioComponent as b, type CameraComponentOptions as c, type CameraProjection as d, type CameraRuntimeType as e, type ColliderShape as f, type ColliderState as g, type CubeMeshParameters as h, DEFAULT_INSTANCED_MESH_PARAMETERS as i, DEFAULT_INSTANCE_TRANSFORM as j, DEFAULT_MESH_GEOMETRY_PARAMETERS as k, DEFAULT_PHYSICS_STATE as l, DEFAULT_POSE_CURLS as m, DEFAULT_RIGIDBODY_STATE as n, EntityType as o, ImageTarget as p, ImageTargetAnchor as q, type ImageTargetAnchorOptions as r, type ImageTargetReference as s, InstanceSlotComponent as t, type InstanceTransform as u, InstancedMeshComponent as v, type InstancedMeshKind as w, type LightValueState as x, type MaterialTypeValue as y, type MaterialValueState as z };

package/dist/{chunk-FQTOC7HK.js → chunk-KIKIWCEB.js}

@@ -1,5 +1,5 @@
-import { createTransform, applyTransform, resolveDracoDecoderPath, loadSharedGltf, cloneModelScene } from './chunk-JRJ3CL5H.js';
-import { AnimationComponent, AudioComponent, Object3DRef, CameraComponent, MeshGeometryComponent, PhysicsComponent, Environment, EntityType, ImageComponent, ImageTargetAnchor, ImageTarget, LightComponent, MaterialComponent, MeshComponent, ModelComponent, Name, ParentId, Postprocessing, ScriptComponent, ScriptObjectComponent, Selectable, SelectionTransformState, SpriteComponent, TransformComponent, InstancedMeshComponent, InstanceSlotComponent, VideoComponent, XRRigComponent, VRTeleportAreaComponent, XRInteractableComponent, XRInteractorComponent, XRInteractorSideComponent, DEFAULT_INSTANCE_TRANSFORM } from './chunk-N4GKZ7IV.js';
+import { createTransform, applyTransform, resolveDracoDecoderPath, loadSharedGltf, cloneModelScene } from './chunk-L5BP727H.js';
+import { AnimationComponent, AudioComponent, Object3DRef, CameraComponent, MeshGeometryComponent, PhysicsComponent, Environment, EntityType, ImageComponent, ImageTargetAnchor, ImageTarget, LightComponent, MaterialComponent, MeshComponent, ModelComponent, Name, ParentId, Postprocessing, ScriptComponent, ScriptObjectComponent, Selectable, SelectionTransformState, SpriteComponent, TransformComponent, InstancedMeshComponent, InstanceSlotComponent, VideoComponent, XRRigComponent, VRTeleportAreaComponent, XRHandPoseComponent, XRInteractableComponent, XRInteractorComponent, XRInteractorSideComponent, DEFAULT_INSTANCE_TRANSFORM } from './chunk-KVGGAL5V.js';
 import { __name } from './chunk-OY7ZODZP.js';
 import * as THREE25 from 'three';
 import { RectAreaLightHelper } from 'three/examples/jsm/helpers/RectAreaLightHelper.js';
@@ -406,6 +406,14 @@ function createVRTeleportAreaComponent(world, entityId, ...args) {
 }
 __name(createVRTeleportAreaComponent, "createVRTeleportAreaComponent");
 
+// core/factories/components/XRHandPoseFactory.ts
+function createXRHandPoseComponent(world, entityId, ...args) {
+  const component = new XRHandPoseComponent(...args);
+  world.addComponent(entityId, component);
+  return component;
+}
+__name(createXRHandPoseComponent, "createXRHandPoseComponent");
+
 // core/factories/components/XRInteractableFactory.ts
 function createXRInteractableComponent(world, entityId, ...args) {
   const component = new XRInteractableComponent(...args);
@@ -441,6 +449,7 @@ function registerDefaultComponentFactories(objectManagementSystem) {
   objectManagementSystem.registerComponentFactory("image", createImageComponent);
   objectManagementSystem.registerComponentFactory("xrRig", createXRRigComponent);
   objectManagementSystem.registerComponentFactory("vrTeleportArea", createVRTeleportAreaComponent);
+  objectManagementSystem.registerComponentFactory("xrHandPose", createXRHandPoseComponent);
   objectManagementSystem.registerComponentFactory("xrInteractable", createXRInteractableComponent);
   objectManagementSystem.registerComponentFactory("xrInteractor", createXRInteractorComponent);
   objectManagementSystem.registerComponentFactory("xrInteractorSide", createXRInteractorSideComponent);
@@ -1655,6 +1664,6 @@ function registerDefaultFactories(objectManagementSystem) {
 }
 __name(registerDefaultFactories, "registerDefaultFactories");
 
-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, createXRInteractableComponent, createXRInteractorComponent, createXRInteractorSideComponent, createXRRigComponent, registerDefaultComponentFactories, registerDefaultFactories };
-//# sourceMappingURL=chunk-FQTOC7HK.js.map
-//# sourceMappingURL=chunk-FQTOC7HK.js.map
+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 };
+//# sourceMappingURL=chunk-KIKIWCEB.js.map
+//# sourceMappingURL=chunk-KIKIWCEB.js.map