@relu-interactives/spatial-ecs 0.4.0 → 0.4.2

package/dist/{System-QjjSc6LZ.d.cts → System-ln4Q7Eot.d.cts}

@@ -619,7 +619,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" | "xrHandPose" | "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" | "xrAnchor" | "xrInteractable" | "xrInteractor" | "xrInteractorSide";
 type ComponentFactory = (world: World, entityId: EntityId, ...args: any[]) => unknown;
 declare class ObjectManagementSystem implements EcsSystem {
     private readonly scene;

package/dist/{System-QjjSc6LZ.d.ts → System-ln4Q7Eot.d.ts}

@@ -619,7 +619,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" | "xrHandPose" | "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" | "xrAnchor" | "xrInteractable" | "xrInteractor" | "xrInteractorSide";
 type ComponentFactory = (world: World, entityId: EntityId, ...args: any[]) => unknown;
 declare class ObjectManagementSystem implements EcsSystem {
     private readonly scene;

package/dist/{XRHandPose-Csd3QGkj.d.ts → XRHandPose-BImIa4ZS.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-QjjSc6LZ.js';
+import { C as Component, p as EcsEntityKind, F as EcsEntityEditorKind, r as EntityId } from './System-ln4Q7Eot.js';
 import * as RAPIER from '@dimforge/rapier3d-compat';
 import { a as XrFinger, c as XrHandPoseDirection, b as XrHandPoseOrientation, X as XrHandPoseDefinition } from './handPose-DlcTtqgx.js';
 
@@ -1538,6 +1538,41 @@ declare class XRRigComponent extends Component {
     constructor(options?: XRRigOptions);
 }
 
+/** Optional initializer for {@link XRAnchorComponent}. */
+type XRAnchorOptions = {
+    /** Whether the entity should anchor at all. Defaults to `true`. */
+    enabled?: boolean;
+};
+/**
+ * Pins an entity to a real-world position.
+ *
+ * A headset's idea of where the room is keeps being refined while a session
+ * runs — it re-recognises the space, corrects drift, and quietly shifts its
+ * coordinate system by a few centimetres. Content placed at fixed scene
+ * coordinates does not move with those corrections, so a vase carefully set on a
+ * real table gradually slides off it.
+ *
+ * An anchor is the runtime's own handle on a point in the room. Attaching this
+ * component hands the entity's pose over to that handle, so the entity moves
+ * exactly as the runtime's understanding of the room moves and stays put
+ * relative to the real world.
+ *
+ * Because the anchor OWNS the transform once created, moving the entity by
+ * script or by physics has no lasting effect — release it first if you want to
+ * move it, then re-anchor.
+ *
+ * Anchors last only as long as the session. Persisting one across launches
+ * needs `requestPersistentHandle`, which is still a draft extension and not
+ * supported here.
+ *
+ * @category Components
+ */
+declare class XRAnchorComponent extends Component {
+    /** Whether the entity should anchor. Turning this off releases the anchor. */
+    enabled: boolean;
+    constructor(options?: XRAnchorOptions);
+}
+
 /**
  * What is rendered at the user's hands.
  *
@@ -1702,4 +1737,4 @@ declare class XRHandPoseComponent extends Component {
     constructor(options?: XRHandPoseOptions);
 }
 
-export { Selectable as $, AnimationComponent as A, type MaterialValueState as B, CameraComponent as C, DEFAULT_COLLIDER_STATE as D, type EditableMeshObjectKind as E, MeshComponent as F, MeshGeometryComponent as G, type MeshGeometryParameters as H, ImageComponent as I, type MeshGeometryParametersByKind as J, ModelComponent as K, LightComponent as L, MaterialComponent as M, Name as N, Object3DRef as O, PhysicsComponent as P, type PhysicsState as Q, type PlaneMeshParameters as R, type RadiusHeightMeshParameters as S, type RadiusMeshParameters as T, type RigidbodyState as U, type RigidbodyType as V, ScriptComponent as W, type ScriptEntry as X, ScriptObjectComponent as Y, type ScriptObjectComponentInput as Z, type ScriptObjectRuntimeState as _, type AnimationComponentOptions as a, SelectionTransformState as a0, SpriteComponent as a1, type TextureFilteringValue as a2, type TransformModeValue as a3, type TransformSpaceValue as a4, VRTeleportAreaComponent as a5, type VRTeleportAreaOptions as a6, VideoComponent as a7, type VrTeleportShape as a8, XRHandPoseComponent as a9, setPhysicsLiveRef as aA, type AnimationStateCallbacks as aB, AnimationStateMachine as aC, AnimationStateManager as aD, type StateMachine as aE, type XRHandPoseOptions as aa, XRInteractableComponent as ab, type XRInteractableOptions as ac, XRInteractorComponent as ad, type XRInteractorOptions as ae, XRInteractorSideComponent as af, XRRigComponent as ag, type XRRigOptions as ah, type XrAttachPoint as ai, type XrDistanceGrabBehavior as aj, type XrEnvironmentPhysics as ak, type XrGrabGesture as al, type XrGrabHands as am, type XrGrabReach as an, type XrHandPoseEntry as ao, type XrHandPreset as ap, type XrInteractorSide as aq, type XrInteractorType as ar, type XrLocomotionMode as as, type XrTrackingOrigin as at, type XrTwoHandRotation as au, createAttachPoint as av, createHandPoseEntry as aw, defaultMaterialValue as ax, handPoseDefinitionFor as ay, normalizePhysicsState 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_POSE_DIRECTIONS as n, DEFAULT_RIGIDBODY_STATE as o, EntityType as p, ImageTarget as q, ImageTargetAnchor as r, type ImageTargetAnchorOptions as s, type ImageTargetReference as t, InstanceSlotComponent as u, type InstanceTransform as v, InstancedMeshComponent as w, type InstancedMeshKind as x, type LightValueState as y, type MaterialTypeValue as z };
+export { Selectable as $, AnimationComponent as A, type MaterialValueState as B, CameraComponent as C, DEFAULT_COLLIDER_STATE as D, type EditableMeshObjectKind as E, MeshComponent as F, MeshGeometryComponent as G, type MeshGeometryParameters as H, ImageComponent as I, type MeshGeometryParametersByKind as J, ModelComponent as K, LightComponent as L, MaterialComponent as M, Name as N, Object3DRef as O, PhysicsComponent as P, type PhysicsState as Q, type PlaneMeshParameters as R, type RadiusHeightMeshParameters as S, type RadiusMeshParameters as T, type RigidbodyState as U, type RigidbodyType as V, ScriptComponent as W, type ScriptEntry as X, ScriptObjectComponent as Y, type ScriptObjectComponentInput as Z, type ScriptObjectRuntimeState as _, type AnimationComponentOptions as a, SelectionTransformState as a0, SpriteComponent as a1, type TextureFilteringValue as a2, type TransformModeValue as a3, type TransformSpaceValue as a4, VRTeleportAreaComponent as a5, type VRTeleportAreaOptions as a6, VideoComponent as a7, type VrTeleportShape as a8, XRAnchorComponent as a9, handPoseDefinitionFor as aA, normalizePhysicsState as aB, setPhysicsLiveRef as aC, type AnimationStateCallbacks as aD, AnimationStateMachine as aE, AnimationStateManager as aF, type StateMachine as aG, type XRAnchorOptions as aa, XRHandPoseComponent as ab, type XRHandPoseOptions as ac, XRInteractableComponent as ad, type XRInteractableOptions as ae, XRInteractorComponent as af, type XRInteractorOptions as ag, XRInteractorSideComponent as ah, XRRigComponent as ai, type XRRigOptions as aj, type XrAttachPoint as ak, type XrDistanceGrabBehavior as al, type XrEnvironmentPhysics as am, type XrGrabGesture as an, type XrGrabHands as ao, type XrGrabReach as ap, type XrHandPoseEntry as aq, type XrHandPreset as ar, type XrInteractorSide as as, type XrInteractorType as at, type XrLocomotionMode as au, type XrTrackingOrigin as av, type XrTwoHandRotation as aw, createAttachPoint as ax, createHandPoseEntry as ay, defaultMaterialValue 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_POSE_DIRECTIONS as n, DEFAULT_RIGIDBODY_STATE as o, EntityType as p, ImageTarget as q, ImageTargetAnchor as r, type ImageTargetAnchorOptions as s, type ImageTargetReference as t, InstanceSlotComponent as u, type InstanceTransform as v, InstancedMeshComponent as w, type InstancedMeshKind as x, type LightValueState as y, type MaterialTypeValue as z };

package/dist/{XRHandPose-Capx-RTD.d.cts → XRHandPose-CxPv-LBo.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-QjjSc6LZ.cjs';
+import { C as Component, p as EcsEntityKind, F as EcsEntityEditorKind, r as EntityId } from './System-ln4Q7Eot.cjs';
 import * as RAPIER from '@dimforge/rapier3d-compat';
 import { a as XrFinger, c as XrHandPoseDirection, b as XrHandPoseOrientation, X as XrHandPoseDefinition } from './handPose-DlcTtqgx.cjs';
 
@@ -1538,6 +1538,41 @@ declare class XRRigComponent extends Component {
     constructor(options?: XRRigOptions);
 }
 
+/** Optional initializer for {@link XRAnchorComponent}. */
+type XRAnchorOptions = {
+    /** Whether the entity should anchor at all. Defaults to `true`. */
+    enabled?: boolean;
+};
+/**
+ * Pins an entity to a real-world position.
+ *
+ * A headset's idea of where the room is keeps being refined while a session
+ * runs — it re-recognises the space, corrects drift, and quietly shifts its
+ * coordinate system by a few centimetres. Content placed at fixed scene
+ * coordinates does not move with those corrections, so a vase carefully set on a
+ * real table gradually slides off it.
+ *
+ * An anchor is the runtime's own handle on a point in the room. Attaching this
+ * component hands the entity's pose over to that handle, so the entity moves
+ * exactly as the runtime's understanding of the room moves and stays put
+ * relative to the real world.
+ *
+ * Because the anchor OWNS the transform once created, moving the entity by
+ * script or by physics has no lasting effect — release it first if you want to
+ * move it, then re-anchor.
+ *
+ * Anchors last only as long as the session. Persisting one across launches
+ * needs `requestPersistentHandle`, which is still a draft extension and not
+ * supported here.
+ *
+ * @category Components
+ */
+declare class XRAnchorComponent extends Component {
+    /** Whether the entity should anchor. Turning this off releases the anchor. */
+    enabled: boolean;
+    constructor(options?: XRAnchorOptions);
+}
+
 /**
  * What is rendered at the user's hands.
  *
@@ -1702,4 +1737,4 @@ declare class XRHandPoseComponent extends Component {
     constructor(options?: XRHandPoseOptions);
 }
 
-export { Selectable as $, AnimationComponent as A, type MaterialValueState as B, CameraComponent as C, DEFAULT_COLLIDER_STATE as D, type EditableMeshObjectKind as E, MeshComponent as F, MeshGeometryComponent as G, type MeshGeometryParameters as H, ImageComponent as I, type MeshGeometryParametersByKind as J, ModelComponent as K, LightComponent as L, MaterialComponent as M, Name as N, Object3DRef as O, PhysicsComponent as P, type PhysicsState as Q, type PlaneMeshParameters as R, type RadiusHeightMeshParameters as S, type RadiusMeshParameters as T, type RigidbodyState as U, type RigidbodyType as V, ScriptComponent as W, type ScriptEntry as X, ScriptObjectComponent as Y, type ScriptObjectComponentInput as Z, type ScriptObjectRuntimeState as _, type AnimationComponentOptions as a, SelectionTransformState as a0, SpriteComponent as a1, type TextureFilteringValue as a2, type TransformModeValue as a3, type TransformSpaceValue as a4, VRTeleportAreaComponent as a5, type VRTeleportAreaOptions as a6, VideoComponent as a7, type VrTeleportShape as a8, XRHandPoseComponent as a9, setPhysicsLiveRef as aA, type AnimationStateCallbacks as aB, AnimationStateMachine as aC, AnimationStateManager as aD, type StateMachine as aE, type XRHandPoseOptions as aa, XRInteractableComponent as ab, type XRInteractableOptions as ac, XRInteractorComponent as ad, type XRInteractorOptions as ae, XRInteractorSideComponent as af, XRRigComponent as ag, type XRRigOptions as ah, type XrAttachPoint as ai, type XrDistanceGrabBehavior as aj, type XrEnvironmentPhysics as ak, type XrGrabGesture as al, type XrGrabHands as am, type XrGrabReach as an, type XrHandPoseEntry as ao, type XrHandPreset as ap, type XrInteractorSide as aq, type XrInteractorType as ar, type XrLocomotionMode as as, type XrTrackingOrigin as at, type XrTwoHandRotation as au, createAttachPoint as av, createHandPoseEntry as aw, defaultMaterialValue as ax, handPoseDefinitionFor as ay, normalizePhysicsState 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_POSE_DIRECTIONS as n, DEFAULT_RIGIDBODY_STATE as o, EntityType as p, ImageTarget as q, ImageTargetAnchor as r, type ImageTargetAnchorOptions as s, type ImageTargetReference as t, InstanceSlotComponent as u, type InstanceTransform as v, InstancedMeshComponent as w, type InstancedMeshKind as x, type LightValueState as y, type MaterialTypeValue as z };
+export { Selectable as $, AnimationComponent as A, type MaterialValueState as B, CameraComponent as C, DEFAULT_COLLIDER_STATE as D, type EditableMeshObjectKind as E, MeshComponent as F, MeshGeometryComponent as G, type MeshGeometryParameters as H, ImageComponent as I, type MeshGeometryParametersByKind as J, ModelComponent as K, LightComponent as L, MaterialComponent as M, Name as N, Object3DRef as O, PhysicsComponent as P, type PhysicsState as Q, type PlaneMeshParameters as R, type RadiusHeightMeshParameters as S, type RadiusMeshParameters as T, type RigidbodyState as U, type RigidbodyType as V, ScriptComponent as W, type ScriptEntry as X, ScriptObjectComponent as Y, type ScriptObjectComponentInput as Z, type ScriptObjectRuntimeState as _, type AnimationComponentOptions as a, SelectionTransformState as a0, SpriteComponent as a1, type TextureFilteringValue as a2, type TransformModeValue as a3, type TransformSpaceValue as a4, VRTeleportAreaComponent as a5, type VRTeleportAreaOptions as a6, VideoComponent as a7, type VrTeleportShape as a8, XRAnchorComponent as a9, handPoseDefinitionFor as aA, normalizePhysicsState as aB, setPhysicsLiveRef as aC, type AnimationStateCallbacks as aD, AnimationStateMachine as aE, AnimationStateManager as aF, type StateMachine as aG, type XRAnchorOptions as aa, XRHandPoseComponent as ab, type XRHandPoseOptions as ac, XRInteractableComponent as ad, type XRInteractableOptions as ae, XRInteractorComponent as af, type XRInteractorOptions as ag, XRInteractorSideComponent as ah, XRRigComponent as ai, type XRRigOptions as aj, type XrAttachPoint as ak, type XrDistanceGrabBehavior as al, type XrEnvironmentPhysics as am, type XrGrabGesture as an, type XrGrabHands as ao, type XrGrabReach as ap, type XrHandPoseEntry as aq, type XrHandPreset as ar, type XrInteractorSide as as, type XrInteractorType as at, type XrLocomotionMode as au, type XrTrackingOrigin as av, type XrTwoHandRotation as aw, createAttachPoint as ax, createHandPoseEntry as ay, defaultMaterialValue 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_POSE_DIRECTIONS as n, DEFAULT_RIGIDBODY_STATE as o, EntityType as p, ImageTarget as q, ImageTargetAnchor as r, type ImageTargetAnchorOptions as s, type ImageTargetReference as t, InstanceSlotComponent as u, type InstanceTransform as v, InstancedMeshComponent as w, type InstancedMeshKind as x, type LightValueState as y, type MaterialTypeValue as z };

package/dist/{chunk-ZWONFM2F.js → chunk-4AK4I3QF.js}

@@ -2293,5 +2293,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_POSE_DIRECTIONS, 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, XRAnchorComponent, XREnvironmentComponent, XRHandPoseComponent, XRInteractableComponent, XRInteractorComponent, XRInteractorSideComponent, XRRigComponent, cloneHandPose, components_exports, createAttachPoint, createHandPoseEntry, defaultMaterialValue, getHandPosePreset, handPoseDefinitionFor, handPoseFromCurls, normalizePhysicsState, setPhysicsLiveRef };
-//# sourceMappingURL=chunk-ZWONFM2F.js.map
-//# sourceMappingURL=chunk-ZWONFM2F.js.map
+//# sourceMappingURL=chunk-4AK4I3QF.js.map
+//# sourceMappingURL=chunk-4AK4I3QF.js.map