@relu-interactives/spatial-ecs 0.3.8 → 0.3.10

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

@@ -1241,6 +1241,47 @@ type XrDistanceGrabBehavior = "snap" | "remote";
  * precise pickups with firm grabs — a chess piece versus a suitcase handle.
  */
 type XrGrabGesture = "any" | "pinch" | "full";
+/**
+ * A hand-hold authored on the object.
+ *
+ * Without attach points a hand grabs wherever it happens to touch, which is
+ * right for a ball and wrong for a rifle — a weapon has a grip and a foregrip,
+ * and the hands belong on those exact spots. `role` is what lets an author say
+ * "this is the trigger hand's hold" so a two-hand grab assembles correctly no
+ * matter which hand arrives first.
+ */
+type XrAttachPoint = {
+    /** Stable id; referenced by scripts and by the inspector list. */
+    id: string;
+    name: string;
+    /** Object-local position of the hold (unscaled). */
+    position: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    /** Object-local orientation of the hold, radians. */
+    rotation: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    /** Restrict to one hand, or `any`. */
+    hand: "left" | "right" | "any";
+    /** Whether this hold is the anchoring hand, the steering hand, or either. */
+    role: "primary" | "secondary" | "any";
+};
+/**
+ * How many hands may hold the object at once, and what a second grab does.
+ *
+ * `single` is a plain pickup. `handOff` lets the other hand TAKE it — the
+ * everyday gesture of passing something between your hands. `two` keeps both
+ * hands on it, which is what enables aiming a two-handed weapon and
+ * pull-apart scaling.
+ */
+type XrGrabHands = "single" | "handOff" | "two";
+/** How the second hand affects orientation. See `solveTwoHandTransform`. */
+type XrTwoHandRotation = "align" | "primary";
 /** Optional initializer for {@link XRInteractableComponent}. */
 type XRInteractableOptions = {
     enabled?: boolean;
@@ -1264,6 +1305,18 @@ type XRInteractableOptions = {
         y: number;
         z: number;
     };
+    /** How many hands may hold it, and whether a second grab transfers it. */
+    grabHands?: XrGrabHands;
+    /** Whether the second hand aims the object or only scales it. */
+    twoHandRotation?: XrTwoHandRotation;
+    /** Let a two-hand grab resize the object by moving the hands apart. */
+    allowTwoHandScale?: boolean;
+    /** Smallest fraction of its size a single scaling gesture may reach. */
+    minScale?: number;
+    /** Largest multiple of its size a single scaling gesture may reach. */
+    maxScale?: number;
+    /** Authored hand-holds. Empty means grab anywhere. */
+    attachPoints?: XrAttachPoint[];
     /** Carry the hand's momentum into the body on release. */
     throwOnRelease?: boolean;
     /** Scales released velocity; >1 makes throws feel stronger than real life. */
@@ -1304,6 +1357,18 @@ declare class XRInteractableComponent extends Component {
         y: number;
         z: number;
     };
+    /** How many hands may hold it, and whether a second grab transfers it. */
+    grabHands: XrGrabHands;
+    /** Whether the second hand aims the object or only scales it. */
+    twoHandRotation: XrTwoHandRotation;
+    /** Whether a two-hand grab may resize the object. */
+    allowTwoHandScale: boolean;
+    /** Scale floor for one gesture, as a fraction of the size at grab time. */
+    minScale: number;
+    /** Scale ceiling for one gesture, as a multiple of the size at grab time. */
+    maxScale: number;
+    /** Authored hand-holds; empty means grab anywhere. */
+    attachPoints: XrAttachPoint[];
     /** Carry hand momentum into the body on release. */
     throwOnRelease: boolean;
     /** Multiplier on released velocity. */
@@ -1311,6 +1376,10 @@ declare class XRInteractableComponent extends Component {
     highlightOnHover: boolean;
     constructor(options?: XRInteractableOptions);
 }
+/** An attach point with every field populated, for the editor and AI tools. */
+declare function createAttachPoint(partial: Partial<XrAttachPoint> & {
+    id: string;
+}): XrAttachPoint;
 
 /**
  * Where the headset's origin sits in the scene.
@@ -1508,4 +1577,4 @@ declare class XRHandPoseComponent extends Component {
     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 };
+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, type AnimationStateCallbacks as aA, AnimationStateMachine as aB, AnimationStateManager as aC, type StateMachine as aD, 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 XrAttachPoint as ah, type XrDistanceGrabBehavior as ai, type XrGrabGesture as aj, type XrGrabHands as ak, type XrGrabMode as al, type XrGrabReach as am, type XrHandPoseEntry as an, type XrHandPreset as ao, type XrInteractorSide as ap, type XrInteractorType as aq, type XrLocomotionMode as ar, type XrTrackingOrigin as as, type XrTwoHandRotation as at, createAttachPoint as au, createHandPoseEntry as av, defaultMaterialValue as aw, handPoseDefinitionFor as ax, normalizePhysicsState as ay, setPhysicsLiveRef as az, 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/{XRHandPose-VuSbe4iz.d.cts → XRHandPose-hAtj9wm-.d.cts}

@@ -1241,6 +1241,47 @@ type XrDistanceGrabBehavior = "snap" | "remote";
  * precise pickups with firm grabs — a chess piece versus a suitcase handle.
  */
 type XrGrabGesture = "any" | "pinch" | "full";
+/**
+ * A hand-hold authored on the object.
+ *
+ * Without attach points a hand grabs wherever it happens to touch, which is
+ * right for a ball and wrong for a rifle — a weapon has a grip and a foregrip,
+ * and the hands belong on those exact spots. `role` is what lets an author say
+ * "this is the trigger hand's hold" so a two-hand grab assembles correctly no
+ * matter which hand arrives first.
+ */
+type XrAttachPoint = {
+    /** Stable id; referenced by scripts and by the inspector list. */
+    id: string;
+    name: string;
+    /** Object-local position of the hold (unscaled). */
+    position: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    /** Object-local orientation of the hold, radians. */
+    rotation: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    /** Restrict to one hand, or `any`. */
+    hand: "left" | "right" | "any";
+    /** Whether this hold is the anchoring hand, the steering hand, or either. */
+    role: "primary" | "secondary" | "any";
+};
+/**
+ * How many hands may hold the object at once, and what a second grab does.
+ *
+ * `single` is a plain pickup. `handOff` lets the other hand TAKE it — the
+ * everyday gesture of passing something between your hands. `two` keeps both
+ * hands on it, which is what enables aiming a two-handed weapon and
+ * pull-apart scaling.
+ */
+type XrGrabHands = "single" | "handOff" | "two";
+/** How the second hand affects orientation. See `solveTwoHandTransform`. */
+type XrTwoHandRotation = "align" | "primary";
 /** Optional initializer for {@link XRInteractableComponent}. */
 type XRInteractableOptions = {
     enabled?: boolean;
@@ -1264,6 +1305,18 @@ type XRInteractableOptions = {
         y: number;
         z: number;
     };
+    /** How many hands may hold it, and whether a second grab transfers it. */
+    grabHands?: XrGrabHands;
+    /** Whether the second hand aims the object or only scales it. */
+    twoHandRotation?: XrTwoHandRotation;
+    /** Let a two-hand grab resize the object by moving the hands apart. */
+    allowTwoHandScale?: boolean;
+    /** Smallest fraction of its size a single scaling gesture may reach. */
+    minScale?: number;
+    /** Largest multiple of its size a single scaling gesture may reach. */
+    maxScale?: number;
+    /** Authored hand-holds. Empty means grab anywhere. */
+    attachPoints?: XrAttachPoint[];
     /** Carry the hand's momentum into the body on release. */
     throwOnRelease?: boolean;
     /** Scales released velocity; >1 makes throws feel stronger than real life. */
@@ -1304,6 +1357,18 @@ declare class XRInteractableComponent extends Component {
         y: number;
         z: number;
     };
+    /** How many hands may hold it, and whether a second grab transfers it. */
+    grabHands: XrGrabHands;
+    /** Whether the second hand aims the object or only scales it. */
+    twoHandRotation: XrTwoHandRotation;
+    /** Whether a two-hand grab may resize the object. */
+    allowTwoHandScale: boolean;
+    /** Scale floor for one gesture, as a fraction of the size at grab time. */
+    minScale: number;
+    /** Scale ceiling for one gesture, as a multiple of the size at grab time. */
+    maxScale: number;
+    /** Authored hand-holds; empty means grab anywhere. */
+    attachPoints: XrAttachPoint[];
     /** Carry hand momentum into the body on release. */
     throwOnRelease: boolean;
     /** Multiplier on released velocity. */
@@ -1311,6 +1376,10 @@ declare class XRInteractableComponent extends Component {
     highlightOnHover: boolean;
     constructor(options?: XRInteractableOptions);
 }
+/** An attach point with every field populated, for the editor and AI tools. */
+declare function createAttachPoint(partial: Partial<XrAttachPoint> & {
+    id: string;
+}): XrAttachPoint;
 
 /**
  * Where the headset's origin sits in the scene.
@@ -1508,4 +1577,4 @@ declare class XRHandPoseComponent extends Component {
     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 };
+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, type AnimationStateCallbacks as aA, AnimationStateMachine as aB, AnimationStateManager as aC, type StateMachine as aD, 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 XrAttachPoint as ah, type XrDistanceGrabBehavior as ai, type XrGrabGesture as aj, type XrGrabHands as ak, type XrGrabMode as al, type XrGrabReach as am, type XrHandPoseEntry as an, type XrHandPreset as ao, type XrInteractorSide as ap, type XrInteractorType as aq, type XrLocomotionMode as ar, type XrTrackingOrigin as as, type XrTwoHandRotation as at, createAttachPoint as au, createHandPoseEntry as av, defaultMaterialValue as aw, handPoseDefinitionFor as ax, normalizePhysicsState as ay, setPhysicsLiveRef as az, 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-KIKIWCEB.js → chunk-5UVBEAGW.js}

@@ -1,5 +1,5 @@
-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 { createTransform, applyTransform, resolveDracoDecoderPath, loadSharedGltf, cloneModelScene } from './chunk-NJOO7NO6.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-ELSZ5U3F.js';
 import { __name } from './chunk-OY7ZODZP.js';
 import * as THREE25 from 'three';
 import { RectAreaLightHelper } from 'three/examples/jsm/helpers/RectAreaLightHelper.js';
@@ -1665,5 +1665,5 @@ 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, createXRHandPoseComponent, createXRInteractableComponent, createXRInteractorComponent, createXRInteractorSideComponent, createXRRigComponent, registerDefaultComponentFactories, registerDefaultFactories };
-//# sourceMappingURL=chunk-KIKIWCEB.js.map
-//# sourceMappingURL=chunk-KIKIWCEB.js.map
+//# sourceMappingURL=chunk-5UVBEAGW.js.map
+//# sourceMappingURL=chunk-5UVBEAGW.js.map