@relu-interactives/spatial-ecs 0.3.11 → 0.3.13

package/dist/{XRHandPose-C-KJeYcJ.d.cts → XRHandPose-9mVZVU3K.d.cts}

@@ -1342,10 +1342,10 @@ type XRInteractableOptions = {
     maxScale?: number;
     /** Authored hand-holds. Empty means grab anywhere. */
     attachPoints?: XrAttachPoint[];
-    /** Carry the hand's momentum into the body on release. */
-    throwOnRelease?: boolean;
+    /** Hand the object the velocity it was moving with when released. */
+    applyVelocityOnRelease?: boolean;
     /** Scales released velocity; >1 makes throws feel stronger than real life. */
-    throwStrength?: number;
+    velocityScale?: number;
     /** Feedback shown while a pointer is on the object. */
     hoverBehavior?: XrHoverBehavior;
     /** Outline colour used by the `color` and `both` behaviours. */
@@ -1398,10 +1398,16 @@ declare class XRInteractableComponent extends Component {
     maxScale: number;
     /** Authored hand-holds; empty means grab anywhere. */
     attachPoints: XrAttachPoint[];
-    /** Carry hand momentum into the body on release. */
-    throwOnRelease: boolean;
+    /**
+     * Hand the object the velocity it was moving with when released.
+     *
+     * Applies to every release, not just a deliberate throw — letting go while
+     * your hand drifts should nudge the object, which is why this is not called
+     * "throw".
+     */
+    applyVelocityOnRelease: boolean;
     /** Multiplier on released velocity. */
-    throwStrength: number;
+    velocityScale: number;
     /** Feedback shown while a pointer is on the object. */
     hoverBehavior: XrHoverBehavior;
     /** Outline colour for the `color` and `both` behaviours. */
@@ -1484,6 +1490,14 @@ declare class XRRigComponent extends Component {
  * currently reports avoids shipping a build that shows nothing on half the
  * hardware. `none` hands presentation entirely to the author's own meshes.
  */
+/**
+ * When the pointer ray is drawn.
+ *
+ * `interacting` (default) shows it only while the hand is pointing at something
+ * it could act on, so the scene isn't permanently criss-crossed with rays
+ * implying everything is clickable. `always` suits scenes built around pointing.
+ */
+type XrRayVisibility = "always" | "interacting" | "never";
 type XrInteractorType = "hands" | "controllers" | "both" | "none";
 /**
  * Look applied to tracked-hand meshes.
@@ -1508,7 +1522,12 @@ type XRInteractorOptions = {
     /** Emissive strength, used by `neon`. */
     handEmissiveIntensity?: number;
     /** Draw the aim ray from each hand. */
-    showRay?: boolean;
+    /** When the pointer ray is drawn. */
+    rayVisibility?: XrRayVisibility;
+    /** Pointer ray colour. */
+    rayColor?: string;
+    /** Pointer ray thickness (diameter), metres. */
+    rayThickness?: number;
 };
 /**
  * Configures what the user sees as their hands, and hosts custom hand content.
@@ -1532,7 +1551,12 @@ declare class XRInteractorComponent extends Component {
     /** Emissive strength for glowing presets. */
     handEmissiveIntensity: number;
     /** Draw the aim ray from each hand. */
-    showRay: boolean;
+    /** When the pointer ray is drawn. */
+    rayVisibility: XrRayVisibility;
+    /** Pointer ray colour. */
+    rayColor: string;
+    /** Pointer ray thickness (diameter), metres. */
+    rayThickness: number;
     constructor(options?: XRInteractorOptions);
 }
 /**

package/dist/{XRHandPose-B6I4y1lj.d.ts → XRHandPose-To0260Lc.d.ts}

@@ -1342,10 +1342,10 @@ type XRInteractableOptions = {
     maxScale?: number;
     /** Authored hand-holds. Empty means grab anywhere. */
     attachPoints?: XrAttachPoint[];
-    /** Carry the hand's momentum into the body on release. */
-    throwOnRelease?: boolean;
+    /** Hand the object the velocity it was moving with when released. */
+    applyVelocityOnRelease?: boolean;
     /** Scales released velocity; >1 makes throws feel stronger than real life. */
-    throwStrength?: number;
+    velocityScale?: number;
     /** Feedback shown while a pointer is on the object. */
     hoverBehavior?: XrHoverBehavior;
     /** Outline colour used by the `color` and `both` behaviours. */
@@ -1398,10 +1398,16 @@ declare class XRInteractableComponent extends Component {
     maxScale: number;
     /** Authored hand-holds; empty means grab anywhere. */
     attachPoints: XrAttachPoint[];
-    /** Carry hand momentum into the body on release. */
-    throwOnRelease: boolean;
+    /**
+     * Hand the object the velocity it was moving with when released.
+     *
+     * Applies to every release, not just a deliberate throw — letting go while
+     * your hand drifts should nudge the object, which is why this is not called
+     * "throw".
+     */
+    applyVelocityOnRelease: boolean;
     /** Multiplier on released velocity. */
-    throwStrength: number;
+    velocityScale: number;
     /** Feedback shown while a pointer is on the object. */
     hoverBehavior: XrHoverBehavior;
     /** Outline colour for the `color` and `both` behaviours. */
@@ -1484,6 +1490,14 @@ declare class XRRigComponent extends Component {
  * currently reports avoids shipping a build that shows nothing on half the
  * hardware. `none` hands presentation entirely to the author's own meshes.
  */
+/**
+ * When the pointer ray is drawn.
+ *
+ * `interacting` (default) shows it only while the hand is pointing at something
+ * it could act on, so the scene isn't permanently criss-crossed with rays
+ * implying everything is clickable. `always` suits scenes built around pointing.
+ */
+type XrRayVisibility = "always" | "interacting" | "never";
 type XrInteractorType = "hands" | "controllers" | "both" | "none";
 /**
  * Look applied to tracked-hand meshes.
@@ -1508,7 +1522,12 @@ type XRInteractorOptions = {
     /** Emissive strength, used by `neon`. */
     handEmissiveIntensity?: number;
     /** Draw the aim ray from each hand. */
-    showRay?: boolean;
+    /** When the pointer ray is drawn. */
+    rayVisibility?: XrRayVisibility;
+    /** Pointer ray colour. */
+    rayColor?: string;
+    /** Pointer ray thickness (diameter), metres. */
+    rayThickness?: number;
 };
 /**
  * Configures what the user sees as their hands, and hosts custom hand content.
@@ -1532,7 +1551,12 @@ declare class XRInteractorComponent extends Component {
     /** Emissive strength for glowing presets. */
     handEmissiveIntensity: number;
     /** Draw the aim ray from each hand. */
-    showRay: boolean;
+    /** When the pointer ray is drawn. */
+    rayVisibility: XrRayVisibility;
+    /** Pointer ray colour. */
+    rayColor: string;
+    /** Pointer ray thickness (diameter), metres. */
+    rayThickness: number;
     constructor(options?: XRInteractorOptions);
 }
 /**

package/dist/{chunk-TXEGYR76.js → chunk-3LDQ4GVZ.js}

@@ -1964,8 +1964,8 @@ var _XRInteractableComponent = class _XRInteractableComponent extends Component
     this.attachPoints = (options?.attachPoints ?? []).map(
       (point) => createAttachPoint(point)
     );
-    this.throwOnRelease = options?.throwOnRelease ?? true;
-    this.throwStrength = options?.throwStrength ?? 1;
+    this.applyVelocityOnRelease = options?.applyVelocityOnRelease ?? true;
+    this.velocityScale = options?.velocityScale ?? 1;
     this.hoverBehavior = options?.hoverBehavior ?? "color";
     this.hoverColor = options?.hoverColor ?? "#4da3ff";
     this.hoverScale = options?.hoverScale ?? 1.06;
@@ -2009,7 +2009,9 @@ var _XRInteractorComponent = class _XRInteractorComponent extends Component {
     this.handColor = options?.handColor ?? "#e8b48a";
     this.handOpacity = options?.handOpacity ?? 1;
     this.handEmissiveIntensity = options?.handEmissiveIntensity ?? 0;
-    this.showRay = options?.showRay ?? true;
+    this.rayVisibility = options?.rayVisibility ?? "interacting";
+    this.rayColor = options?.rayColor ?? "#4da3ff";
+    this.rayThickness = options?.rayThickness ?? 6e-3;
   }
 };
 __name(_XRInteractorComponent, "XRInteractorComponent");
@@ -2228,5 +2230,5 @@ __name(_XRHandPoseComponent, "XRHandPoseComponent");
 var XRHandPoseComponent = _XRHandPoseComponent;
 
 export { AnimationComponent, AnimationStateMachine, AnimationStateManager, AudioComponent, CameraComponent, DEFAULT_COLLIDER_STATE, DEFAULT_ENVIRONMENT_STATE, DEFAULT_INSTANCED_MESH_PARAMETERS, DEFAULT_INSTANCE_TRANSFORM, DEFAULT_MESH_GEOMETRY_PARAMETERS, DEFAULT_PHYSICS_STATE, DEFAULT_POSE_CURLS, DEFAULT_POSTPROCESSING_STATE, DEFAULT_RIGIDBODY_STATE, EntityType, Environment, HAND_POSE_PRESETS, HAND_POSE_PRESET_IDS, ImageComponent, ImageTarget, ImageTargetAnchor, InstanceSlotComponent, InstancedMeshComponent, LightComponent, MaterialComponent, MeshComponent, MeshGeometryComponent, ModelComponent, Name, Object3DRef, ParentId, PhysicsComponent, Postprocessing, PrefabInstance, PrefabNode, ScriptComponent, ScriptObjectComponent, Selectable, SelectionTransformState, SpriteComponent, TransformComponent, VRTeleportAreaComponent, VideoComponent, XRHandPoseComponent, XRInteractableComponent, XRInteractorComponent, XRInteractorSideComponent, XRRigComponent, cloneHandPose, components_exports, createAttachPoint, createHandPoseEntry, defaultMaterialValue, getHandPosePreset, handPoseDefinitionFor, handPoseFromCurls, normalizePhysicsState, setPhysicsLiveRef };
-//# sourceMappingURL=chunk-TXEGYR76.js.map
-//# sourceMappingURL=chunk-TXEGYR76.js.map
+//# sourceMappingURL=chunk-3LDQ4GVZ.js.map
+//# sourceMappingURL=chunk-3LDQ4GVZ.js.map