@relu-interactives/spatial-ecs 0.2.25 → 0.3.1

package/dist/{System-CYWZ_Zx5.d.cts → System-vrU46Vuw.d.cts}

@@ -333,7 +333,7 @@ type EntityId = number;
  * maps to an object factory in `core/factories/objects/*` that creates the
  * baseline component set.
  */
-type EcsEntityKind = "cube" | "sphere" | "plane" | "capsule" | "cylinder" | "empty" | "model" | "image" | "imageTarget" | "sprite" | "audio" | "camera" | "video" | "ambientLight" | "directionalLight" | "pointLight" | "spotLight" | "areaLight" | "instancedMesh" | "instanceSlot" | "scriptObject";
+type EcsEntityKind = "cube" | "sphere" | "plane" | "capsule" | "cylinder" | "empty" | "model" | "image" | "imageTarget" | "sprite" | "audio" | "camera" | "video" | "ambientLight" | "directionalLight" | "pointLight" | "spotLight" | "areaLight" | "instancedMesh" | "instanceSlot" | "scriptObject" | "xrRig" | "teleportArea";
 /** {@link EcsEntityKind} extended with editor-only utility entities (gizmos, helpers). */
 type EcsEntityEditorKind = EcsEntityKind | "editorUtility";
 /** Callback invoked when the selected entity changes. `null` indicates a deselection. */
@@ -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";
+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";
 type ComponentFactory = (world: World, entityId: EntityId, ...args: any[]) => unknown;
 declare class ObjectManagementSystem implements EcsSystem {
     private readonly scene;
@@ -952,6 +952,20 @@ declare class World {
         renderSystem: RenderSystem;
     };
     isEditorMode(): boolean;
+    /**
+     * `true` while an immersive WebXR session is actively presenting.
+     *
+     * While presenting, three's `WebXRManager` OWNS the render camera: each frame
+     * `updateUserCamera()` writes the headset pose into the camera's
+     * position/quaternion/scale and copies the XR projection (including a derived
+     * `fov`) onto it. Systems that also drive the camera must stand down for the
+     * duration, or they ping-pong with the headset every frame and defeat their
+     * own dirty-checks.
+     *
+     * Locomotion therefore moves the camera's PARENT (the XR rig) — three composes
+     * the head pose as `parent.matrixWorld × headPose`.
+     */
+    isXrPresenting(): boolean;
     /**
      * Pauses world simulation. While paused, `update()` skips all system ticks so
      * physics, animation, scripts, and rendering stop advancing. The last rendered

package/dist/{System-CYWZ_Zx5.d.ts → System-vrU46Vuw.d.ts}

@@ -333,7 +333,7 @@ type EntityId = number;
  * maps to an object factory in `core/factories/objects/*` that creates the
  * baseline component set.
  */
-type EcsEntityKind = "cube" | "sphere" | "plane" | "capsule" | "cylinder" | "empty" | "model" | "image" | "imageTarget" | "sprite" | "audio" | "camera" | "video" | "ambientLight" | "directionalLight" | "pointLight" | "spotLight" | "areaLight" | "instancedMesh" | "instanceSlot" | "scriptObject";
+type EcsEntityKind = "cube" | "sphere" | "plane" | "capsule" | "cylinder" | "empty" | "model" | "image" | "imageTarget" | "sprite" | "audio" | "camera" | "video" | "ambientLight" | "directionalLight" | "pointLight" | "spotLight" | "areaLight" | "instancedMesh" | "instanceSlot" | "scriptObject" | "xrRig" | "teleportArea";
 /** {@link EcsEntityKind} extended with editor-only utility entities (gizmos, helpers). */
 type EcsEntityEditorKind = EcsEntityKind | "editorUtility";
 /** Callback invoked when the selected entity changes. `null` indicates a deselection. */
@@ -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";
+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";
 type ComponentFactory = (world: World, entityId: EntityId, ...args: any[]) => unknown;
 declare class ObjectManagementSystem implements EcsSystem {
     private readonly scene;
@@ -952,6 +952,20 @@ declare class World {
         renderSystem: RenderSystem;
     };
     isEditorMode(): boolean;
+    /**
+     * `true` while an immersive WebXR session is actively presenting.
+     *
+     * While presenting, three's `WebXRManager` OWNS the render camera: each frame
+     * `updateUserCamera()` writes the headset pose into the camera's
+     * position/quaternion/scale and copies the XR projection (including a derived
+     * `fov`) onto it. Systems that also drive the camera must stand down for the
+     * duration, or they ping-pong with the headset every frame and defeat their
+     * own dirty-checks.
+     *
+     * Locomotion therefore moves the camera's PARENT (the XR rig) — three composes
+     * the head pose as `parent.matrixWorld × headPose`.
+     */
+    isXrPresenting(): boolean;
     /**
      * Pauses world simulation. While paused, `update()` skips all system ticks so
      * physics, animation, scripts, and rendering stop advancing. The last rendered

package/dist/{Video-AIQYTAAr.d.cts → XRRig-CAmf04NX.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-CYWZ_Zx5.cjs';
+import { C as Component, p as EcsEntityKind, F as EcsEntityEditorKind, r as EntityId } from './System-vrU46Vuw.js';
 import * as RAPIER from '@dimforge/rapier3d-compat';
 
 interface StateMachine {
@@ -172,8 +172,12 @@ declare class AnimationComponent extends Component {
     stopState(name?: string): boolean;
 }
 
-/** Runtime camera mode. `3d` is a free camera; `ar` is composited over a tracked image/face feed. */
-type CameraRuntimeType = "3d" | "ar";
+/**
+ * Runtime camera mode. `3d` is a free camera; `ar` is composited over a tracked
+ * image/face feed; `xr` is driven by an immersive WebXR session (the headset
+ * owns the pose and projection — locomotion moves the camera's XR rig parent).
+ */
+type CameraRuntimeType = "3d" | "ar" | "xr";
 /** Projection model. */
 type CameraProjection = "perspective" | "orthographic";
 /** Optional initializer for {@link CameraComponent}. Any field omitted falls back to the defaults documented on the component. */
@@ -1168,4 +1172,127 @@ declare class VideoComponent extends Component {
     stop(): void;
 }
 
-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, VideoComponent as a3, defaultMaterialValue as a4, normalizePhysicsState as a5, setPhysicsLiveRef as a6, type AnimationStateCallbacks as a7, AnimationStateMachine as a8, AnimationStateManager as a9, type StateMachine as aa, 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 };
+/** Footprint of a teleport destination. */
+type VrTeleportShape = "plane" | "cylinder";
+/** Optional initializer for {@link VRTeleportAreaComponent}. */
+type VRTeleportAreaOptions = {
+    /** Disable to keep the area authored but inert. */
+    enabled?: boolean;
+    /** Footprint shape. */
+    shape?: VrTeleportShape;
+    /** Full width in metres (`plane`), or diameter (`cylinder`). */
+    width?: number;
+    /** Full depth in metres. Ignored for `cylinder`, which uses `width`. */
+    depth?: number;
+};
+/**
+ * Marks an entity's surface as a valid teleport destination.
+ *
+ * Teleport is an allow-list, not a physics query: only entities carrying an
+ * enabled area can be teleported onto. That keeps destinations deliberate —
+ * authors decide where the player may stand rather than discovering that every
+ * collider in the scene is walkable.
+ *
+ * @category Components
+ */
+declare class VRTeleportAreaComponent extends Component {
+    /** Whether this area currently accepts teleports. */
+    enabled: boolean;
+    /** Footprint shape. */
+    shape: VrTeleportShape;
+    /** Full width in metres (diameter for `cylinder`). */
+    width: number;
+    /** Full depth in metres (unused for `cylinder`). */
+    depth: number;
+    constructor(options?: VRTeleportAreaOptions);
+}
+
+/**
+ * How a grabbed 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.
+ */
+type XrGrabMode = "kinematic" | "physics";
+/** 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. */
+    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.
+ *
+ * @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. */
+    highlightOnHover: boolean;
+    constructor(options?: XRInteractableOptions);
+}
+
+/** How the player moves through the scene in an immersive session. */
+type XrLocomotionMode = "teleport" | "smooth" | "none";
+/** Optional initializer for {@link XRRigComponent}. */
+type XRRigOptions = {
+    /** Movement style. Defaults to `teleport` — the most comfort-safe option. */
+    locomotion?: XrLocomotionMode;
+    /** Metres/second for `smooth` locomotion. */
+    moveSpeed?: number;
+    /** Rotate in fixed steps instead of continuously (greatly reduces nausea). */
+    snapTurn?: boolean;
+    /** Degrees per snap-turn step. */
+    snapTurnDegrees?: number;
+    /** Height in metres used when the device reports no floor-relative space. */
+    fallbackEyeHeight?: number;
+};
+/**
+ * Marks an entity as the XR rig — the player's movable origin.
+ *
+ * The rig exists because a WebXR headset owns the camera pose absolutely: three
+ * composes the render camera as `rig.matrixWorld × headPose`, so the ONLY way
+ * to move the player is to move the camera's parent. The camera entity must be
+ * a child of this entity.
+ *
+ * Defaults are deliberately comfort-first — teleport locomotion with snap
+ * turning is the combination least likely to cause motion sickness, and is what
+ * every platform's design guidance recommends as the baseline.
+ *
+ * @category Components
+ */
+declare class XRRigComponent extends Component {
+    /** Movement style. */
+    locomotion: XrLocomotionMode;
+    /** Metres/second for `smooth` locomotion. */
+    moveSpeed: number;
+    /** Rotate in fixed steps rather than continuously. */
+    snapTurn: boolean;
+    /** Degrees per snap-turn step. */
+    snapTurnDegrees: number;
+    /** Eye height fallback for devices without a floor-relative reference space. */
+    fallbackEyeHeight: number;
+    constructor(options?: XRRigOptions);
+}
+
+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, XRRigComponent as a9, type XRRigOptions as aa, type XrGrabMode as ab, type XrLocomotionMode as ac, defaultMaterialValue as ad, normalizePhysicsState as ae, setPhysicsLiveRef as af, type AnimationStateCallbacks as ag, AnimationStateMachine as ah, AnimationStateManager as ai, type StateMachine as aj, 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 };

package/dist/{Video-DlZ4G9ig.d.ts → XRRig-Cu-EyliG.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-CYWZ_Zx5.js';
+import { C as Component, p as EcsEntityKind, F as EcsEntityEditorKind, r as EntityId } from './System-vrU46Vuw.cjs';
 import * as RAPIER from '@dimforge/rapier3d-compat';
 
 interface StateMachine {
@@ -172,8 +172,12 @@ declare class AnimationComponent extends Component {
     stopState(name?: string): boolean;
 }
 
-/** Runtime camera mode. `3d` is a free camera; `ar` is composited over a tracked image/face feed. */
-type CameraRuntimeType = "3d" | "ar";
+/**
+ * Runtime camera mode. `3d` is a free camera; `ar` is composited over a tracked
+ * image/face feed; `xr` is driven by an immersive WebXR session (the headset
+ * owns the pose and projection — locomotion moves the camera's XR rig parent).
+ */
+type CameraRuntimeType = "3d" | "ar" | "xr";
 /** Projection model. */
 type CameraProjection = "perspective" | "orthographic";
 /** Optional initializer for {@link CameraComponent}. Any field omitted falls back to the defaults documented on the component. */
@@ -1168,4 +1172,127 @@ declare class VideoComponent extends Component {
     stop(): void;
 }
 
-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, VideoComponent as a3, defaultMaterialValue as a4, normalizePhysicsState as a5, setPhysicsLiveRef as a6, type AnimationStateCallbacks as a7, AnimationStateMachine as a8, AnimationStateManager as a9, type StateMachine as aa, 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 };
+/** Footprint of a teleport destination. */
+type VrTeleportShape = "plane" | "cylinder";
+/** Optional initializer for {@link VRTeleportAreaComponent}. */
+type VRTeleportAreaOptions = {
+    /** Disable to keep the area authored but inert. */
+    enabled?: boolean;
+    /** Footprint shape. */
+    shape?: VrTeleportShape;
+    /** Full width in metres (`plane`), or diameter (`cylinder`). */
+    width?: number;
+    /** Full depth in metres. Ignored for `cylinder`, which uses `width`. */
+    depth?: number;
+};
+/**
+ * Marks an entity's surface as a valid teleport destination.
+ *
+ * Teleport is an allow-list, not a physics query: only entities carrying an
+ * enabled area can be teleported onto. That keeps destinations deliberate —
+ * authors decide where the player may stand rather than discovering that every
+ * collider in the scene is walkable.
+ *
+ * @category Components
+ */
+declare class VRTeleportAreaComponent extends Component {
+    /** Whether this area currently accepts teleports. */
+    enabled: boolean;
+    /** Footprint shape. */
+    shape: VrTeleportShape;
+    /** Full width in metres (diameter for `cylinder`). */
+    width: number;
+    /** Full depth in metres (unused for `cylinder`). */
+    depth: number;
+    constructor(options?: VRTeleportAreaOptions);
+}
+
+/**
+ * How a grabbed 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.
+ */
+type XrGrabMode = "kinematic" | "physics";
+/** 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. */
+    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.
+ *
+ * @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. */
+    highlightOnHover: boolean;
+    constructor(options?: XRInteractableOptions);
+}
+
+/** How the player moves through the scene in an immersive session. */
+type XrLocomotionMode = "teleport" | "smooth" | "none";
+/** Optional initializer for {@link XRRigComponent}. */
+type XRRigOptions = {
+    /** Movement style. Defaults to `teleport` — the most comfort-safe option. */
+    locomotion?: XrLocomotionMode;
+    /** Metres/second for `smooth` locomotion. */
+    moveSpeed?: number;
+    /** Rotate in fixed steps instead of continuously (greatly reduces nausea). */
+    snapTurn?: boolean;
+    /** Degrees per snap-turn step. */
+    snapTurnDegrees?: number;
+    /** Height in metres used when the device reports no floor-relative space. */
+    fallbackEyeHeight?: number;
+};
+/**
+ * Marks an entity as the XR rig — the player's movable origin.
+ *
+ * The rig exists because a WebXR headset owns the camera pose absolutely: three
+ * composes the render camera as `rig.matrixWorld × headPose`, so the ONLY way
+ * to move the player is to move the camera's parent. The camera entity must be
+ * a child of this entity.
+ *
+ * Defaults are deliberately comfort-first — teleport locomotion with snap
+ * turning is the combination least likely to cause motion sickness, and is what
+ * every platform's design guidance recommends as the baseline.
+ *
+ * @category Components
+ */
+declare class XRRigComponent extends Component {
+    /** Movement style. */
+    locomotion: XrLocomotionMode;
+    /** Metres/second for `smooth` locomotion. */
+    moveSpeed: number;
+    /** Rotate in fixed steps rather than continuously. */
+    snapTurn: boolean;
+    /** Degrees per snap-turn step. */
+    snapTurnDegrees: number;
+    /** Eye height fallback for devices without a floor-relative reference space. */
+    fallbackEyeHeight: number;
+    constructor(options?: XRRigOptions);
+}
+
+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, XRRigComponent as a9, type XRRigOptions as aa, type XrGrabMode as ab, type XrLocomotionMode as ac, defaultMaterialValue as ad, normalizePhysicsState as ae, setPhysicsLiveRef as af, type AnimationStateCallbacks as ag, AnimationStateMachine as ah, AnimationStateManager as ai, type StateMachine as aj, 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 };

package/dist/{chunk-XFD74BQL.js → chunk-67WGASUJ.js}

@@ -1,4 +1,4 @@
-import { TransformComponent, Object3DRef, ParentId } from './chunk-J6736FFO.js';
+import { TransformComponent, Object3DRef, ParentId } from './chunk-U3MDYKPV.js';
 import { __name } from './chunk-OY7ZODZP.js';
 import * as THREE2 from 'three';
 import { clone } from 'three/examples/jsm/utils/SkeletonUtils.js';
@@ -311,5 +311,5 @@ function resolveDracoDecoderPath() {
 __name(resolveDracoDecoderPath, "resolveDracoDecoderPath");
 
 export { ObjectManagementSystem, SHARED_MODEL_RESOURCE_FLAG, applyTransform, clearModelCache, cloneModelScene, createTransform, loadSharedGltf, resolveDracoDecoderPath, setDracoDecoderPath };
-//# sourceMappingURL=chunk-XFD74BQL.js.map
-//# sourceMappingURL=chunk-XFD74BQL.js.map
+//# sourceMappingURL=chunk-67WGASUJ.js.map
+//# sourceMappingURL=chunk-67WGASUJ.js.map

package/dist/{chunk-XFD74BQL.js.map → chunk-67WGASUJ.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../core/utils/modelCache.ts","../core/systems/ObjectManagementSystem.ts","../core/utils/dracoDecoderPath.ts"],"names":["THREE","cloneWithSkeleton"],"mappings":"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","file":"chunk-XFD74BQL.js","sourcesContent":["import * as THREE from \"three\";\nimport type { GLTF } from \"three/examples/jsm/loaders/GLTFLoader.js\";\nimport { clone as cloneWithSkeleton } from \"three/examples/jsm/utils/SkeletonUtils.js\";\n\n/**\n * userData flag set on geometries/materials that back shared (cached) model\n * scenes. Entity disposal must skip these — other live clones and future\n * spawns reference the same GPU resources.\n */\nexport const SHARED_MODEL_RESOURCE_FLAG = \"spatialEcsSharedModelResource\";\n\nconst modelCache = new Map<string, Promise<GLTF>>();\n\nfunction markSharedResources(root: THREE.Object3D): void {\n  root.traverse((child) => {\n    if (!(child instanceof THREE.Mesh)) {\n      return;\n    }\n    if (child.geometry) {\n      child.geometry.userData[SHARED_MODEL_RESOURCE_FLAG] = true;\n    }\n    const materials = Array.isArray(child.material)\n      ? child.material\n      : [child.material];\n    for (const material of materials) {\n      if (material) {\n        material.userData[SHARED_MODEL_RESOURCE_FLAG] = true;\n      }\n    }\n  });\n}\n\n/**\n * Load a GLTF once per URL and share the parsed result, so repeated spawns of\n * the same model skip both the fetch and the parse. The cached scene must\n * never be mounted directly (an Object3D has a single parent) — mount a\n * cloneModelScene() of it. Failed loads are evicted so a retry re-fetches.\n */\nexport function loadSharedGltf(\n  url: string,\n  load: () => Promise<GLTF>,\n): Promise<GLTF> {\n  let pending = modelCache.get(url);\n  if (!pending) {\n    pending = load().then((gltf) => {\n      markSharedResources(gltf.scene);\n      return gltf;\n    });\n    pending.catch(() => {\n      modelCache.delete(url);\n    });\n    modelCache.set(url, pending);\n  }\n  return pending;\n}\n\n/**\n * Skeleton-aware clone of a cached model scene for mounting. Geometries and\n * materials are shared with the cached original (marked via\n * SHARED_MODEL_RESOURCE_FLAG); the object hierarchy — including rebound\n * skeletons for skinned meshes — is fresh per call.\n */\nexport function cloneModelScene(scene: THREE.Object3D): THREE.Object3D {\n  return cloneWithSkeleton(scene);\n}\n\n/**\n * Forget cached models (one URL, or everything). Subsequent loads fetch and\n * parse anew. Does not dispose GPU resources — live clones may still use them.\n */\nexport function clearModelCache(url?: string): void {\n  if (typeof url === \"string\") {\n    modelCache.delete(url);\n    return;\n  }\n  modelCache.clear();\n}\n","import * as THREE from \"three\";\n\nimport { Object3DRef } from \"../components/Object3DRef\";\nimport { ParentId } from \"../components/ParentId\";\nimport type { TransformData } from \"../components/Transform\";\nimport { TransformComponent } from \"../components/Transform\";\nimport type { EcsSystem } from \"../System\";\nimport { SHARED_MODEL_RESOURCE_FLAG } from \"../utils/modelCache\";\nimport type { World } from \"../World\";\nimport type { EntityId, EcsEntityKind } from \"../types\";\n\nexport type CreatePayload = {\n  name?: string;\n  transform?: TransformData;\n  parentId?: EntityId | null;\n  path?: string;\n  options?: Record<string, unknown>;\n  camera?: Record<string, unknown>;\n  useWorldCamera?: boolean;\n};\n\nexport type CreateContext = {\n  world: World;\n  scene: THREE.Scene;\n  camera: THREE.PerspectiveCamera;\n  payload: CreatePayload;\n  isEditor?: boolean;\n};\n\nexport type EntityFactory = (context: CreateContext) => EntityId;\n\nexport type EcsComponentFactoryKind =\n  | \"animation\"\n  | \"audio\"\n  | \"camera\"\n  | \"environment\"\n  | \"entityType\"\n  | \"image\"\n  | \"imageTargetAnchor\"\n  | \"imageTarget\"\n  | \"light\"\n  | \"material\"\n  | \"mesh\"\n  | \"meshGeometry\"\n  | \"model\"\n  | \"name\"\n  | \"object3DRef\"\n  | \"parentId\"\n  | \"physics\"\n  | \"postprocessing\"\n  | \"script\"\n  | \"scriptObject\"\n  | \"selectable\"\n  | \"selectionTransformState\"\n  | \"sprite\"\n  | \"transform\"\n  | \"video\"\n  | \"instancedMesh\";\n\nexport type ComponentFactory = (\n  world: World,\n  entityId: EntityId,\n  ...args: any[]\n) => unknown;\n\ntype CreateRequest = {\n  kind: EcsEntityKind;\n  payload: CreatePayload;\n  onCreated?: (entityId: EntityId) => void;\n};\n\nexport function createTransform(input?: TransformData): TransformComponent {\n  return new TransformComponent(input);\n}\n\nexport function applyTransform(\n  object: THREE.Object3D,\n  transform: TransformComponent,\n): void {\n  object.position.set(\n    transform.position.x,\n    transform.position.y,\n    transform.position.z,\n  );\n  object.rotation.set(\n    transform.rotation.x,\n    transform.rotation.y,\n    transform.rotation.z,\n  );\n  object.scale.set(transform.scale.x, transform.scale.y, transform.scale.z);\n}\n\nexport class ObjectManagementSystem implements EcsSystem {\n  private readonly scene: THREE.Scene;\n  private readonly camera: THREE.PerspectiveCamera;\n  private readonly isEditor: boolean;\n  private readonly registry = new Map<EcsEntityKind, EntityFactory>();\n  private readonly componentRegistry = new Map<\n    EcsComponentFactoryKind,\n    ComponentFactory\n  >();\n  private readonly createQueue: CreateRequest[] = [];\n\n  constructor(\n    scene: THREE.Scene,\n    camera: THREE.PerspectiveCamera,\n    isEditor = false,\n  ) {\n    this.scene = scene;\n    this.camera = camera;\n    this.isEditor = isEditor;\n  }\n\n  register(kind: EcsEntityKind, factory: EntityFactory): void {\n    this.registry.set(kind, factory);\n  }\n\n  registerComponentFactory(\n    kind: EcsComponentFactoryKind,\n    factory: ComponentFactory,\n  ): void {\n    this.componentRegistry.set(kind, factory);\n  }\n\n  getOrCreateAudioListener(): THREE.AudioListener {\n    const existing = this.camera.userData.ecsAudioListener;\n    if (existing instanceof THREE.AudioListener) {\n      return existing;\n    }\n\n    const listener = new THREE.AudioListener();\n    this.camera.add(listener);\n    this.camera.userData.ecsAudioListener = listener;\n    return listener;\n  }\n\n  isEditorMode(): boolean {\n    return this.isEditor;\n  }\n\n  getComponentFactory(kind: EcsComponentFactoryKind): ComponentFactory | null {\n    return this.componentRegistry.get(kind) ?? null;\n  }\n\n  createComponentNow(\n    kind: EcsComponentFactoryKind,\n    world: World,\n    entityId: EntityId,\n    ...args: any[]\n  ): unknown {\n    const factory = this.componentRegistry.get(kind);\n    if (!factory) {\n      throw new Error(`Unknown component kind: ${kind}`);\n    }\n\n    return factory(world, entityId, ...args);\n  }\n\n  requestCreate(\n    kind: EcsEntityKind,\n    payload: CreatePayload = {},\n    onCreated?: (entityId: EntityId) => void,\n  ): void {\n    this.createQueue.push({ kind, payload, onCreated });\n  }\n\n  createNow(\n    kind: EcsEntityKind,\n    world: World,\n    payload: CreatePayload = {},\n  ): EntityId {\n    const factory = this.registry.get(kind);\n    if (!factory) {\n      throw new Error(`Unknown object kind: ${kind}`);\n    }\n\n    const entityId = factory({\n      world,\n      scene: this.scene,\n      camera: this.camera,\n      payload,\n      isEditor: this.isEditor,\n    });\n\n    const object = world.getComponent(entityId, Object3DRef)?.object;\n    if (object) {\n      object.userData.ecsKind = kind;\n    }\n\n    if (payload.parentId !== undefined) {\n      world.addComponent(entityId, new ParentId(payload.parentId));\n    }\n\n    return entityId;\n  }\n\n  /**\n   * Removes an entity from the ECS world and its associated `Object3D` from the\n   * THREE.js scene graph.\n   *\n   * @param world - The world the entity belongs to.\n   * @param entityId - The entity to remove.\n   * @param dispose - When `true`, traverses the entity's `Object3D` subtree and\n   *   calls `.dispose()` on every `BufferGeometry` and `Material` found. Pass\n   *   `true` when the entity will not be reused and you want to free GPU memory\n   *   immediately (e.g. dynamically spawned objects). Defaults to `false`.\n   * @returns `true` if the entity existed and was removed; `false` if the entity\n   *   was not found.\n   *\n   * @example\n   * ```ts\n   * // Remove from scene, keep GPU resources (safe if geometry is shared)\n   * objects.deleteEntity(world, entityId);\n   *\n   * // Remove from scene and free GPU memory (use for one-off spawned objects)\n   * objects.deleteEntity(world, entityId, true);\n   * ```\n   */\n  deleteEntity(world: World, entityId: EntityId, dispose = false): boolean {\n    if (!world.hasEntity(entityId)) {\n      return false;\n    }\n\n    const object3d = world.getComponent(entityId, Object3DRef)?.object;\n    if (object3d?.parent) {\n      object3d.parent.remove(object3d);\n    }\n\n    if (dispose && object3d) {\n      object3d.traverse((child) => {\n        if (child instanceof THREE.Mesh) {\n          // Resources backing shared (cached) model scenes are skipped —\n          // other live clones and future spawns reference the same objects.\n          if (!child.geometry?.userData?.[SHARED_MODEL_RESOURCE_FLAG]) {\n            child.geometry?.dispose();\n          }\n          const materials = Array.isArray(child.material)\n            ? child.material\n            : [child.material];\n          for (const mat of materials) {\n            if (mat && !mat.userData?.[SHARED_MODEL_RESOURCE_FLAG]) {\n              mat.dispose();\n            }\n          }\n        }\n      });\n    }\n\n    world.destroyEntity(entityId);\n    return true;\n  }\n\n  setParent(\n    world: World,\n    entityId: EntityId,\n    parentId: EntityId | null,\n    options?: {\n      preserveWorldTransform?: boolean;\n    },\n  ): boolean {\n    if (!world.hasEntity(entityId)) {\n      return false;\n    }\n\n    if (parentId !== null && !world.hasEntity(parentId)) {\n      return false;\n    }\n\n    if (parentId === entityId) {\n      return false;\n    }\n\n    let ancestor = parentId;\n    while (ancestor !== null) {\n      if (ancestor === entityId) {\n        return false;\n      }\n\n      ancestor = world.getComponent(ancestor, ParentId)?.value ?? null;\n    }\n\n    const parentComponent = world.getComponent(entityId, ParentId);\n    if (parentComponent) {\n      if (parentComponent.value === parentId) {\n        return false;\n      }\n\n      parentComponent.value = parentId;\n    } else {\n      world.addComponent(entityId, new ParentId(parentId));\n    }\n\n    const preserveWorldTransform = options?.preserveWorldTransform ?? true;\n    if (preserveWorldTransform) {\n      const object = world.getComponent(entityId, Object3DRef)?.object;\n      const parentObject =\n        parentId !== null\n          ? world.getComponent(parentId, Object3DRef)?.object ?? null\n          : null;\n\n      if (object) {\n        // Refresh matrixWorld before attach so world-space preservation is accurate.\n        this.scene.updateMatrixWorld(true);\n\n        if (parentObject && parentObject !== object) {\n          parentObject.attach(object);\n        } else {\n          this.scene.attach(object);\n        }\n\n        object.updateMatrixWorld(true);\n        this.syncTransformComponentFromObject(world, entityId, object);\n      }\n    }\n\n    this.reconcileSceneFromWorld(world);\n    return true;\n  }\n\n  private syncTransformComponentFromObject(\n    world: World,\n    entityId: EntityId,\n    object: THREE.Object3D,\n  ): void {\n    const transform = world.getComponent(entityId, TransformComponent);\n    if (!transform) {\n      return;\n    }\n\n    transform.position.x = object.position.x;\n    transform.position.y = object.position.y;\n    transform.position.z = object.position.z;\n\n    transform.rotation.x = object.rotation.x;\n    transform.rotation.y = object.rotation.y;\n    transform.rotation.z = object.rotation.z;\n\n    transform.scale.x = object.scale.x;\n    transform.scale.y = object.scale.y;\n    transform.scale.z = object.scale.z;\n  }\n\n  reconcileSceneFromWorld(world: World): void {\n    const worldObjects = new Map<EntityId, THREE.Object3D>();\n    const entityIds = world.query(Object3DRef);\n\n    for (const entityId of entityIds) {\n      const object = world.getComponent(entityId, Object3DRef)?.object;\n      if (!object) {\n        continue;\n      }\n\n      worldObjects.set(entityId, object);\n    }\n\n    for (const child of [...this.scene.children]) {\n      const entityId = child.userData?.entityId;\n      if (typeof entityId === \"number\" && !world.hasEntity(entityId)) {\n        this.scene.remove(child);\n      }\n    }\n\n    for (const [entityId, object] of worldObjects.entries()) {\n      const parentEntityId = world.getComponent(entityId, ParentId)?.value;\n      const parentObject =\n        typeof parentEntityId === \"number\"\n          ? worldObjects.get(parentEntityId)\n          : undefined;\n\n      if (parentObject && parentObject !== object) {\n        if (object.parent !== parentObject) {\n          // Reconcile hierarchy from ParentId while keeping Transform as local source of truth.\n          parentObject.add(object);\n          object.updateMatrixWorld(true);\n        }\n        continue;\n      }\n\n      if (object.parent !== this.scene) {\n        // Reconcile hierarchy from ParentId while keeping Transform as local source of truth.\n        this.scene.add(object);\n        object.updateMatrixWorld(true);\n      }\n    }\n  }\n\n  update(world: World): void {\n    for (const request of this.createQueue.splice(0)) {\n      const entityId = this.createNow(request.kind, world, request.payload);\n      request.onCreated?.(entityId);\n    }\n\n    this.reconcileSceneFromWorld(world);\n  }\n}\n","const LOCAL_DRACO_DECODER_RELATIVE_PATH = \"./assets/draco/\";\nexport const DRACO_DECODER_CDN_PATH =\n  \"https://www.gstatic.com/draco/versioned/decoders/1.5.7/\";\n\nlet dracoDecoderPathOverride: string | null = null;\n\n/**\n * Override where the DRACO decoder files (draco_wasm_wrapper.js,\n * draco_decoder.wasm, draco_decoder.js) are fetched from. Embedding apps\n * whose bundlers relocate this package's chunks — making the default\n * import.meta.url resolution point at a location that is never populated —\n * should call this before any model loads. The path must end with \"/\".\n * Pass null to restore the default resolution.\n */\nexport function setDracoDecoderPath(path: string | null): void {\n  dracoDecoderPathOverride = path;\n}\n\nfunction isBlockedBrowserFileUrl(url: string): boolean {\n  return url.startsWith(\"file://\");\n}\n\nexport function resolveDracoDecoderPath(): string {\n  if (dracoDecoderPathOverride) {\n    return dracoDecoderPathOverride;\n  }\n\n  try {\n    // Prefer vendored decoder assets shipped with this package.\n    const resolvedPath = new URL(\n      LOCAL_DRACO_DECODER_RELATIVE_PATH,\n      import.meta.url,\n    ).toString();\n\n    // Browser loaders cannot fetch file:// resources from package install paths.\n    // Fall back to CDN decoders when bundlers emit file URLs for node_modules assets.\n    if (isBlockedBrowserFileUrl(resolvedPath)) {\n      return DRACO_DECODER_CDN_PATH;\n    }\n\n    return resolvedPath;\n  } catch {\n    // Fallback keeps compatibility in runtimes that cannot resolve package-relative URLs.\n    return DRACO_DECODER_CDN_PATH;\n  }\n}\n"]}
+{"version":3,"sources":["../core/utils/modelCache.ts","../core/systems/ObjectManagementSystem.ts","../core/utils/dracoDecoderPath.ts"],"names":["THREE","cloneWithSkeleton"],"mappings":"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","file":"chunk-67WGASUJ.js","sourcesContent":["import * as THREE from \"three\";\nimport type { GLTF } from \"three/examples/jsm/loaders/GLTFLoader.js\";\nimport { clone as cloneWithSkeleton } from \"three/examples/jsm/utils/SkeletonUtils.js\";\n\n/**\n * userData flag set on geometries/materials that back shared (cached) model\n * scenes. Entity disposal must skip these — other live clones and future\n * spawns reference the same GPU resources.\n */\nexport const SHARED_MODEL_RESOURCE_FLAG = \"spatialEcsSharedModelResource\";\n\nconst modelCache = new Map<string, Promise<GLTF>>();\n\nfunction markSharedResources(root: THREE.Object3D): void {\n  root.traverse((child) => {\n    if (!(child instanceof THREE.Mesh)) {\n      return;\n    }\n    if (child.geometry) {\n      child.geometry.userData[SHARED_MODEL_RESOURCE_FLAG] = true;\n    }\n    const materials = Array.isArray(child.material)\n      ? child.material\n      : [child.material];\n    for (const material of materials) {\n      if (material) {\n        material.userData[SHARED_MODEL_RESOURCE_FLAG] = true;\n      }\n    }\n  });\n}\n\n/**\n * Load a GLTF once per URL and share the parsed result, so repeated spawns of\n * the same model skip both the fetch and the parse. The cached scene must\n * never be mounted directly (an Object3D has a single parent) — mount a\n * cloneModelScene() of it. Failed loads are evicted so a retry re-fetches.\n */\nexport function loadSharedGltf(\n  url: string,\n  load: () => Promise<GLTF>,\n): Promise<GLTF> {\n  let pending = modelCache.get(url);\n  if (!pending) {\n    pending = load().then((gltf) => {\n      markSharedResources(gltf.scene);\n      return gltf;\n    });\n    pending.catch(() => {\n      modelCache.delete(url);\n    });\n    modelCache.set(url, pending);\n  }\n  return pending;\n}\n\n/**\n * Skeleton-aware clone of a cached model scene for mounting. Geometries and\n * materials are shared with the cached original (marked via\n * SHARED_MODEL_RESOURCE_FLAG); the object hierarchy — including rebound\n * skeletons for skinned meshes — is fresh per call.\n */\nexport function cloneModelScene(scene: THREE.Object3D): THREE.Object3D {\n  return cloneWithSkeleton(scene);\n}\n\n/**\n * Forget cached models (one URL, or everything). Subsequent loads fetch and\n * parse anew. Does not dispose GPU resources — live clones may still use them.\n */\nexport function clearModelCache(url?: string): void {\n  if (typeof url === \"string\") {\n    modelCache.delete(url);\n    return;\n  }\n  modelCache.clear();\n}\n","import * as THREE from \"three\";\n\nimport { Object3DRef } from \"../components/Object3DRef\";\nimport { ParentId } from \"../components/ParentId\";\nimport type { TransformData } from \"../components/Transform\";\nimport { TransformComponent } from \"../components/Transform\";\nimport type { EcsSystem } from \"../System\";\nimport { SHARED_MODEL_RESOURCE_FLAG } from \"../utils/modelCache\";\nimport type { World } from \"../World\";\nimport type { EntityId, EcsEntityKind } from \"../types\";\n\nexport type CreatePayload = {\n  name?: string;\n  transform?: TransformData;\n  parentId?: EntityId | null;\n  path?: string;\n  options?: Record<string, unknown>;\n  camera?: Record<string, unknown>;\n  useWorldCamera?: boolean;\n};\n\nexport type CreateContext = {\n  world: World;\n  scene: THREE.Scene;\n  camera: THREE.PerspectiveCamera;\n  payload: CreatePayload;\n  isEditor?: boolean;\n};\n\nexport type EntityFactory = (context: CreateContext) => EntityId;\n\nexport type EcsComponentFactoryKind =\n  | \"animation\"\n  | \"audio\"\n  | \"camera\"\n  | \"environment\"\n  | \"entityType\"\n  | \"image\"\n  | \"imageTargetAnchor\"\n  | \"imageTarget\"\n  | \"light\"\n  | \"material\"\n  | \"mesh\"\n  | \"meshGeometry\"\n  | \"model\"\n  | \"name\"\n  | \"object3DRef\"\n  | \"parentId\"\n  | \"physics\"\n  | \"postprocessing\"\n  | \"script\"\n  | \"scriptObject\"\n  | \"selectable\"\n  | \"selectionTransformState\"\n  | \"sprite\"\n  | \"transform\"\n  | \"video\"\n  | \"instancedMesh\"\n  | \"xrRig\"\n  | \"vrTeleportArea\"\n  | \"xrInteractable\";\n\nexport type ComponentFactory = (\n  world: World,\n  entityId: EntityId,\n  ...args: any[]\n) => unknown;\n\ntype CreateRequest = {\n  kind: EcsEntityKind;\n  payload: CreatePayload;\n  onCreated?: (entityId: EntityId) => void;\n};\n\nexport function createTransform(input?: TransformData): TransformComponent {\n  return new TransformComponent(input);\n}\n\nexport function applyTransform(\n  object: THREE.Object3D,\n  transform: TransformComponent,\n): void {\n  object.position.set(\n    transform.position.x,\n    transform.position.y,\n    transform.position.z,\n  );\n  object.rotation.set(\n    transform.rotation.x,\n    transform.rotation.y,\n    transform.rotation.z,\n  );\n  object.scale.set(transform.scale.x, transform.scale.y, transform.scale.z);\n}\n\nexport class ObjectManagementSystem implements EcsSystem {\n  private readonly scene: THREE.Scene;\n  private readonly camera: THREE.PerspectiveCamera;\n  private readonly isEditor: boolean;\n  private readonly registry = new Map<EcsEntityKind, EntityFactory>();\n  private readonly componentRegistry = new Map<\n    EcsComponentFactoryKind,\n    ComponentFactory\n  >();\n  private readonly createQueue: CreateRequest[] = [];\n\n  constructor(\n    scene: THREE.Scene,\n    camera: THREE.PerspectiveCamera,\n    isEditor = false,\n  ) {\n    this.scene = scene;\n    this.camera = camera;\n    this.isEditor = isEditor;\n  }\n\n  register(kind: EcsEntityKind, factory: EntityFactory): void {\n    this.registry.set(kind, factory);\n  }\n\n  registerComponentFactory(\n    kind: EcsComponentFactoryKind,\n    factory: ComponentFactory,\n  ): void {\n    this.componentRegistry.set(kind, factory);\n  }\n\n  getOrCreateAudioListener(): THREE.AudioListener {\n    const existing = this.camera.userData.ecsAudioListener;\n    if (existing instanceof THREE.AudioListener) {\n      return existing;\n    }\n\n    const listener = new THREE.AudioListener();\n    this.camera.add(listener);\n    this.camera.userData.ecsAudioListener = listener;\n    return listener;\n  }\n\n  isEditorMode(): boolean {\n    return this.isEditor;\n  }\n\n  getComponentFactory(kind: EcsComponentFactoryKind): ComponentFactory | null {\n    return this.componentRegistry.get(kind) ?? null;\n  }\n\n  createComponentNow(\n    kind: EcsComponentFactoryKind,\n    world: World,\n    entityId: EntityId,\n    ...args: any[]\n  ): unknown {\n    const factory = this.componentRegistry.get(kind);\n    if (!factory) {\n      throw new Error(`Unknown component kind: ${kind}`);\n    }\n\n    return factory(world, entityId, ...args);\n  }\n\n  requestCreate(\n    kind: EcsEntityKind,\n    payload: CreatePayload = {},\n    onCreated?: (entityId: EntityId) => void,\n  ): void {\n    this.createQueue.push({ kind, payload, onCreated });\n  }\n\n  createNow(\n    kind: EcsEntityKind,\n    world: World,\n    payload: CreatePayload = {},\n  ): EntityId {\n    const factory = this.registry.get(kind);\n    if (!factory) {\n      throw new Error(`Unknown object kind: ${kind}`);\n    }\n\n    const entityId = factory({\n      world,\n      scene: this.scene,\n      camera: this.camera,\n      payload,\n      isEditor: this.isEditor,\n    });\n\n    const object = world.getComponent(entityId, Object3DRef)?.object;\n    if (object) {\n      object.userData.ecsKind = kind;\n    }\n\n    if (payload.parentId !== undefined) {\n      world.addComponent(entityId, new ParentId(payload.parentId));\n    }\n\n    return entityId;\n  }\n\n  /**\n   * Removes an entity from the ECS world and its associated `Object3D` from the\n   * THREE.js scene graph.\n   *\n   * @param world - The world the entity belongs to.\n   * @param entityId - The entity to remove.\n   * @param dispose - When `true`, traverses the entity's `Object3D` subtree and\n   *   calls `.dispose()` on every `BufferGeometry` and `Material` found. Pass\n   *   `true` when the entity will not be reused and you want to free GPU memory\n   *   immediately (e.g. dynamically spawned objects). Defaults to `false`.\n   * @returns `true` if the entity existed and was removed; `false` if the entity\n   *   was not found.\n   *\n   * @example\n   * ```ts\n   * // Remove from scene, keep GPU resources (safe if geometry is shared)\n   * objects.deleteEntity(world, entityId);\n   *\n   * // Remove from scene and free GPU memory (use for one-off spawned objects)\n   * objects.deleteEntity(world, entityId, true);\n   * ```\n   */\n  deleteEntity(world: World, entityId: EntityId, dispose = false): boolean {\n    if (!world.hasEntity(entityId)) {\n      return false;\n    }\n\n    const object3d = world.getComponent(entityId, Object3DRef)?.object;\n    if (object3d?.parent) {\n      object3d.parent.remove(object3d);\n    }\n\n    if (dispose && object3d) {\n      object3d.traverse((child) => {\n        if (child instanceof THREE.Mesh) {\n          // Resources backing shared (cached) model scenes are skipped —\n          // other live clones and future spawns reference the same objects.\n          if (!child.geometry?.userData?.[SHARED_MODEL_RESOURCE_FLAG]) {\n            child.geometry?.dispose();\n          }\n          const materials = Array.isArray(child.material)\n            ? child.material\n            : [child.material];\n          for (const mat of materials) {\n            if (mat && !mat.userData?.[SHARED_MODEL_RESOURCE_FLAG]) {\n              mat.dispose();\n            }\n          }\n        }\n      });\n    }\n\n    world.destroyEntity(entityId);\n    return true;\n  }\n\n  setParent(\n    world: World,\n    entityId: EntityId,\n    parentId: EntityId | null,\n    options?: {\n      preserveWorldTransform?: boolean;\n    },\n  ): boolean {\n    if (!world.hasEntity(entityId)) {\n      return false;\n    }\n\n    if (parentId !== null && !world.hasEntity(parentId)) {\n      return false;\n    }\n\n    if (parentId === entityId) {\n      return false;\n    }\n\n    let ancestor = parentId;\n    while (ancestor !== null) {\n      if (ancestor === entityId) {\n        return false;\n      }\n\n      ancestor = world.getComponent(ancestor, ParentId)?.value ?? null;\n    }\n\n    const parentComponent = world.getComponent(entityId, ParentId);\n    if (parentComponent) {\n      if (parentComponent.value === parentId) {\n        return false;\n      }\n\n      parentComponent.value = parentId;\n    } else {\n      world.addComponent(entityId, new ParentId(parentId));\n    }\n\n    const preserveWorldTransform = options?.preserveWorldTransform ?? true;\n    if (preserveWorldTransform) {\n      const object = world.getComponent(entityId, Object3DRef)?.object;\n      const parentObject =\n        parentId !== null\n          ? world.getComponent(parentId, Object3DRef)?.object ?? null\n          : null;\n\n      if (object) {\n        // Refresh matrixWorld before attach so world-space preservation is accurate.\n        this.scene.updateMatrixWorld(true);\n\n        if (parentObject && parentObject !== object) {\n          parentObject.attach(object);\n        } else {\n          this.scene.attach(object);\n        }\n\n        object.updateMatrixWorld(true);\n        this.syncTransformComponentFromObject(world, entityId, object);\n      }\n    }\n\n    this.reconcileSceneFromWorld(world);\n    return true;\n  }\n\n  private syncTransformComponentFromObject(\n    world: World,\n    entityId: EntityId,\n    object: THREE.Object3D,\n  ): void {\n    const transform = world.getComponent(entityId, TransformComponent);\n    if (!transform) {\n      return;\n    }\n\n    transform.position.x = object.position.x;\n    transform.position.y = object.position.y;\n    transform.position.z = object.position.z;\n\n    transform.rotation.x = object.rotation.x;\n    transform.rotation.y = object.rotation.y;\n    transform.rotation.z = object.rotation.z;\n\n    transform.scale.x = object.scale.x;\n    transform.scale.y = object.scale.y;\n    transform.scale.z = object.scale.z;\n  }\n\n  reconcileSceneFromWorld(world: World): void {\n    const worldObjects = new Map<EntityId, THREE.Object3D>();\n    const entityIds = world.query(Object3DRef);\n\n    for (const entityId of entityIds) {\n      const object = world.getComponent(entityId, Object3DRef)?.object;\n      if (!object) {\n        continue;\n      }\n\n      worldObjects.set(entityId, object);\n    }\n\n    for (const child of [...this.scene.children]) {\n      const entityId = child.userData?.entityId;\n      if (typeof entityId === \"number\" && !world.hasEntity(entityId)) {\n        this.scene.remove(child);\n      }\n    }\n\n    for (const [entityId, object] of worldObjects.entries()) {\n      const parentEntityId = world.getComponent(entityId, ParentId)?.value;\n      const parentObject =\n        typeof parentEntityId === \"number\"\n          ? worldObjects.get(parentEntityId)\n          : undefined;\n\n      if (parentObject && parentObject !== object) {\n        if (object.parent !== parentObject) {\n          // Reconcile hierarchy from ParentId while keeping Transform as local source of truth.\n          parentObject.add(object);\n          object.updateMatrixWorld(true);\n        }\n        continue;\n      }\n\n      if (object.parent !== this.scene) {\n        // Reconcile hierarchy from ParentId while keeping Transform as local source of truth.\n        this.scene.add(object);\n        object.updateMatrixWorld(true);\n      }\n    }\n  }\n\n  update(world: World): void {\n    for (const request of this.createQueue.splice(0)) {\n      const entityId = this.createNow(request.kind, world, request.payload);\n      request.onCreated?.(entityId);\n    }\n\n    this.reconcileSceneFromWorld(world);\n  }\n}\n","const LOCAL_DRACO_DECODER_RELATIVE_PATH = \"./assets/draco/\";\nexport const DRACO_DECODER_CDN_PATH =\n  \"https://www.gstatic.com/draco/versioned/decoders/1.5.7/\";\n\nlet dracoDecoderPathOverride: string | null = null;\n\n/**\n * Override where the DRACO decoder files (draco_wasm_wrapper.js,\n * draco_decoder.wasm, draco_decoder.js) are fetched from. Embedding apps\n * whose bundlers relocate this package's chunks — making the default\n * import.meta.url resolution point at a location that is never populated —\n * should call this before any model loads. The path must end with \"/\".\n * Pass null to restore the default resolution.\n */\nexport function setDracoDecoderPath(path: string | null): void {\n  dracoDecoderPathOverride = path;\n}\n\nfunction isBlockedBrowserFileUrl(url: string): boolean {\n  return url.startsWith(\"file://\");\n}\n\nexport function resolveDracoDecoderPath(): string {\n  if (dracoDecoderPathOverride) {\n    return dracoDecoderPathOverride;\n  }\n\n  try {\n    // Prefer vendored decoder assets shipped with this package.\n    const resolvedPath = new URL(\n      LOCAL_DRACO_DECODER_RELATIVE_PATH,\n      import.meta.url,\n    ).toString();\n\n    // Browser loaders cannot fetch file:// resources from package install paths.\n    // Fall back to CDN decoders when bundlers emit file URLs for node_modules assets.\n    if (isBlockedBrowserFileUrl(resolvedPath)) {\n      return DRACO_DECODER_CDN_PATH;\n    }\n\n    return resolvedPath;\n  } catch {\n    // Fallback keeps compatibility in runtimes that cannot resolve package-relative URLs.\n    return DRACO_DECODER_CDN_PATH;\n  }\n}\n"]}