@relu-interactives/spatial-ecs 0.3.12 → 0.3.14

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

@@ -603,6 +603,13 @@ type CreatePayload = {
     options?: Record<string, unknown>;
     camera?: Record<string, unknown>;
     useWorldCamera?: boolean;
+    /**
+     * Suppress the default child entities a factory would otherwise create.
+     *
+     * Set during hydration: the snapshot already contains those children, so
+     * letting the factory add its own too duplicates them on every load.
+     */
+    skipDefaultChildren?: boolean;
 };
 type CreateContext = {
     world: World;

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

@@ -603,6 +603,13 @@ type CreatePayload = {
     options?: Record<string, unknown>;
     camera?: Record<string, unknown>;
     useWorldCamera?: boolean;
+    /**
+     * Suppress the default child entities a factory would otherwise create.
+     *
+     * Set during hydration: the snapshot already contains those children, so
+     * letting the factory add its own too duplicates them on every load.
+     */
+    skipDefaultChildren?: boolean;
 };
 type CreateContext = {
     world: World;

package/dist/{XRHandPose-DawOR0uR.d.cts → XRHandPose-LR4EhboN.d.cts}

@@ -1,5 +1,5 @@
 import * as THREE from 'three';
-import { C as Component, p as EcsEntityKind, F as EcsEntityEditorKind, r as EntityId } from './System-31wk-A0g.cjs';
+import { C as Component, p as EcsEntityKind, F as EcsEntityEditorKind, r as EntityId } from './System-BhnLw0fZ.cjs';
 import * as RAPIER from '@dimforge/rapier3d-compat';
 import { a as XrFinger, b as XrHandPoseOrientation, X as XrHandPoseDefinition } from './handPose-dFxqbFFY.cjs';
 
@@ -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,8 @@ 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. */
@@ -1536,7 +1551,8 @@ 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. */

package/dist/{XRHandPose-DhAd9Qi6.d.ts → XRHandPose-SZ7ou63b.d.ts}

@@ -1,5 +1,5 @@
 import * as THREE from 'three';
-import { C as Component, p as EcsEntityKind, F as EcsEntityEditorKind, r as EntityId } from './System-31wk-A0g.js';
+import { C as Component, p as EcsEntityKind, F as EcsEntityEditorKind, r as EntityId } from './System-BhnLw0fZ.js';
 import * as RAPIER from '@dimforge/rapier3d-compat';
 import { a as XrFinger, b as XrHandPoseOrientation, X as XrHandPoseDefinition } from './handPose-dFxqbFFY.js';
 
@@ -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,8 @@ 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. */
@@ -1536,7 +1551,8 @@ 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. */

package/dist/{chunk-OMDYLFTN.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,7 @@ 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;
   }
@@ -2230,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-OMDYLFTN.js.map
-//# sourceMappingURL=chunk-OMDYLFTN.js.map
+//# sourceMappingURL=chunk-3LDQ4GVZ.js.map
+//# sourceMappingURL=chunk-3LDQ4GVZ.js.map