@relu-interactives/spatial-ecs 0.11.0 → 0.11.1

package/dist/docs/api/components/classes/XRRigComponent.md

@@ -6,7 +6,7 @@
 
 # Class: XRRigComponent
 
-Defined in: [components/XRRig.ts:85](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/XRRig.ts#L85)
+Defined in: [components/XRRig.ts:85](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/XRRig.ts#L85)
 
 Marks an entity as the XR rig — the player's movable origin.
 
@@ -31,7 +31,7 @@ every platform's design guidance recommends as the baseline.
 new XRRigComponent(options?): XRRigComponent;
 ```
 
-Defined in: [components/XRRig.ts:125](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/XRRig.ts#L125)
+Defined in: [components/XRRig.ts:125](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/XRRig.ts#L125)
 
 #### Parameters
 
@@ -51,18 +51,18 @@ Defined in: [components/XRRig.ts:125](https://github.com/Relu-Interactives/relu-
 
 | Property | Type | Description | Defined in |
 | ------ | ------ | ------ | ------ |
-| <a id="trackingorigin"></a> `trackingOrigin` | [`XrTrackingOrigin`](../type-aliases/XrTrackingOrigin.md) | Where the headset origin sits (floor-relative vs eye-relative). | [components/XRRig.ts:87](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/XRRig.ts#L87) |
-| <a id="locomotion"></a> `locomotion` | [`XrLocomotionMode`](../type-aliases/XrLocomotionMode.md) | Movement style. | [components/XRRig.ts:89](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/XRRig.ts#L89) |
-| <a id="movespeed"></a> `moveSpeed` | `number` | Metres/second for `smooth` locomotion. | [components/XRRig.ts:91](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/XRRig.ts#L91) |
-| <a id="snapturn"></a> `snapTurn` | `boolean` | Rotate in fixed steps rather than continuously. | [components/XRRig.ts:93](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/XRRig.ts#L93) |
-| <a id="snapturndegrees"></a> `snapTurnDegrees` | `number` | Degrees per snap-turn step. | [components/XRRig.ts:95](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/XRRig.ts#L95) |
-| <a id="fallbackeyeheight"></a> `fallbackEyeHeight` | `number` | Eye height fallback for devices without a floor-relative reference space. | [components/XRRig.ts:97](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/XRRig.ts#L97) |
-| <a id="teleportarccolor"></a> `teleportArcColor` | `string` | Teleport arc colour when it lands somewhere valid. | [components/XRRig.ts:99](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/XRRig.ts#L99) |
-| <a id="teleportarcinvalidcolor"></a> `teleportArcInvalidColor` | `string` | Teleport arc colour when it lands nowhere teleportable. | [components/XRRig.ts:101](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/XRRig.ts#L101) |
-| <a id="teleportarcthickness"></a> `teleportArcThickness` | `number` | Teleport arc thickness (diameter), metres. | [components/XRRig.ts:103](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/XRRig.ts#L103) |
-| <a id="passthrough"></a> `passthrough` | `boolean` | Run the session in passthrough — the real room shows through. This is the VR/MR switch for the whole project: the entry button requests `immersive-ar` instead of `immersive-vr`. Blend mode is fixed for the life of a session, so this cannot be flipped mid-session — ending and re-entering is the only way to change it. | [components/XRRig.ts:113](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/XRRig.ts#L113) |
-| <a id="depthocclusion"></a> `depthOcclusion` | `boolean` | Let real objects occlude virtual ones, via WebXR depth sensing. | [components/XRRig.ts:115](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/XRRig.ts#L115) |
-| <a id="environmentphysics"></a> `environmentPhysics` | [`XrEnvironmentPhysics`](../type-aliases/XrEnvironmentPhysics.md) | Which detected real-world geometry becomes physics colliders. | [components/XRRig.ts:117](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/XRRig.ts#L117) |
-| <a id="environmentdebug"></a> `environmentDebug` | `boolean` | Draw the detected room geometry on-device, for checking a scan. | [components/XRRig.ts:119](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/XRRig.ts#L119) |
-| <a id="hittest"></a> `hitTest` | `boolean` | Allow scripts to raycast against the real room (`hit-test`). | [components/XRRig.ts:121](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/XRRig.ts#L121) |
-| <a id="anchors"></a> `anchors` | `boolean` | Allow content to be pinned to real-world features (`anchors`). | [components/XRRig.ts:123](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/XRRig.ts#L123) |
+| <a id="trackingorigin"></a> `trackingOrigin` | [`XrTrackingOrigin`](../type-aliases/XrTrackingOrigin.md) | Where the headset origin sits (floor-relative vs eye-relative). | [components/XRRig.ts:87](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/XRRig.ts#L87) |
+| <a id="locomotion"></a> `locomotion` | [`XrLocomotionMode`](../type-aliases/XrLocomotionMode.md) | Movement style. | [components/XRRig.ts:89](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/XRRig.ts#L89) |
+| <a id="movespeed"></a> `moveSpeed` | `number` | Metres/second for `smooth` locomotion. | [components/XRRig.ts:91](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/XRRig.ts#L91) |
+| <a id="snapturn"></a> `snapTurn` | `boolean` | Rotate in fixed steps rather than continuously. | [components/XRRig.ts:93](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/XRRig.ts#L93) |
+| <a id="snapturndegrees"></a> `snapTurnDegrees` | `number` | Degrees per snap-turn step. | [components/XRRig.ts:95](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/XRRig.ts#L95) |
+| <a id="fallbackeyeheight"></a> `fallbackEyeHeight` | `number` | Eye height fallback for devices without a floor-relative reference space. | [components/XRRig.ts:97](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/XRRig.ts#L97) |
+| <a id="teleportarccolor"></a> `teleportArcColor` | `string` | Teleport arc colour when it lands somewhere valid. | [components/XRRig.ts:99](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/XRRig.ts#L99) |
+| <a id="teleportarcinvalidcolor"></a> `teleportArcInvalidColor` | `string` | Teleport arc colour when it lands nowhere teleportable. | [components/XRRig.ts:101](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/XRRig.ts#L101) |
+| <a id="teleportarcthickness"></a> `teleportArcThickness` | `number` | Teleport arc thickness (diameter), metres. | [components/XRRig.ts:103](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/XRRig.ts#L103) |
+| <a id="passthrough"></a> `passthrough` | `boolean` | Run the session in passthrough — the real room shows through. This is the VR/MR switch for the whole project: the entry button requests `immersive-ar` instead of `immersive-vr`. Blend mode is fixed for the life of a session, so this cannot be flipped mid-session — ending and re-entering is the only way to change it. | [components/XRRig.ts:113](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/XRRig.ts#L113) |
+| <a id="depthocclusion"></a> `depthOcclusion` | `boolean` | Let real objects occlude virtual ones, via WebXR depth sensing. | [components/XRRig.ts:115](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/XRRig.ts#L115) |
+| <a id="environmentphysics"></a> `environmentPhysics` | [`XrEnvironmentPhysics`](../type-aliases/XrEnvironmentPhysics.md) | Which detected real-world geometry becomes physics colliders. | [components/XRRig.ts:117](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/XRRig.ts#L117) |
+| <a id="environmentdebug"></a> `environmentDebug` | `boolean` | Draw the detected room geometry on-device, for checking a scan. | [components/XRRig.ts:119](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/XRRig.ts#L119) |
+| <a id="hittest"></a> `hitTest` | `boolean` | Allow scripts to raycast against the real room (`hit-test`). | [components/XRRig.ts:121](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/XRRig.ts#L121) |
+| <a id="anchors"></a> `anchors` | `boolean` | Allow content to be pinned to real-world features (`anchors`). | [components/XRRig.ts:123](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/XRRig.ts#L123) |

package/dist/docs/api/components/functions/createAttachPoint.md

@@ -10,7 +10,7 @@
 function createAttachPoint(partial): XrAttachPoint;
 ```
 
-Defined in: [components/XRInteractable.ts:206](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/XRInteractable.ts#L206)
+Defined in: [components/XRInteractable.ts:206](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/XRInteractable.ts#L206)
 
 An attach point with every field populated, for the editor and AI tools.
 

package/dist/docs/api/components/functions/createHandPoseEntry.md

@@ -10,7 +10,7 @@
 function createHandPoseEntry(partial): XrHandPoseEntry;
 ```
 
-Defined in: [components/XRHandPose.ts:70](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/XRHandPose.ts#L70)
+Defined in: [components/XRHandPose.ts:70](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/XRHandPose.ts#L70)
 
 A pose entry with every field populated, for the editor and AI tools.
 

package/dist/docs/api/components/functions/defaultMaterialValue.md

@@ -10,7 +10,7 @@
 function defaultMaterialValue(): MaterialValueState;
 ```
 
-Defined in: [components/Material.ts:202](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Material.ts#L202)
+Defined in: [components/Material.ts:202](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/Material.ts#L202)
 
 ## Returns
 

package/dist/docs/api/components/functions/handPoseDefinitionFor.md

@@ -12,7 +12,7 @@ function handPoseDefinitionFor(entry, resolvePreset):
   | null;
 ```
 
-Defined in: [components/XRHandPose.ts:101](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/XRHandPose.ts#L101)
+Defined in: [components/XRHandPose.ts:101](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/XRHandPose.ts#L101)
 
 Resolve an entry to the definition the matcher consumes.
 

package/dist/docs/api/components/functions/normalizeBoneHold.md

@@ -0,0 +1,25 @@
+[**@relu-interactives/spatial-ecs**](../../index.md)
+
+***
+
+[@relu-interactives/spatial-ecs](../../index.md) / [components](../index.md) / normalizeBoneHold
+
+# Function: normalizeBoneHold()
+
+```ts
+function normalizeBoneHold(hold): BoneHold;
+```
+
+Defined in: [components/BoneAttachment.ts:33](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/BoneAttachment.ts#L33)
+
+A hold with every field filled in.
+
+## Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `hold` | `Partial`\<[`BoneHold`](../type-aliases/BoneHold.md)\> |
+
+## Returns
+
+[`BoneHold`](../type-aliases/BoneHold.md)

package/dist/docs/api/components/functions/normalizeEnvironmentLighting.md

@@ -12,7 +12,7 @@ function normalizeEnvironmentLighting(value):
   | undefined;
 ```
 
-Defined in: [components/Environment.ts:240](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Environment.ts#L240)
+Defined in: [components/Environment.ts:240](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/Environment.ts#L240)
 
 Normalize a lighting block to a complete [EnvironmentLightingState](../type-aliases/EnvironmentLightingState.md).
 Returns `undefined` when `value` is not an object, so a scene without the

package/dist/docs/api/components/functions/normalizeIKChain.md

@@ -0,0 +1,25 @@
+[**@relu-interactives/spatial-ecs**](../../index.md)
+
+***
+
+[@relu-interactives/spatial-ecs](../../index.md) / [components](../index.md) / normalizeIKChain
+
+# Function: normalizeIKChain()
+
+```ts
+function normalizeIKChain(chain): IKChain;
+```
+
+Defined in: [components/IK.ts:38](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/IK.ts#L38)
+
+A chain with every field filled in.
+
+## Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `chain` | `Partial`\<[`IKChain`](../type-aliases/IKChain.md)\> & \{ `limb`: [`IKLimb`](../type-aliases/IKLimb.md); \} |
+
+## Returns
+
+[`IKChain`](../type-aliases/IKChain.md)

package/dist/docs/api/components/functions/normalizePhysicsState.md

@@ -10,7 +10,7 @@
 function normalizePhysicsState(value): PhysicsState;
 ```
 
-Defined in: [components/Physics.ts:319](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Physics.ts#L319)
+Defined in: [components/Physics.ts:319](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/Physics.ts#L319)
 
 ## Parameters
 

package/dist/docs/api/components/functions/setModelLoadState.md

@@ -13,7 +13,7 @@ function setModelLoadState(
    error?): void;
 ```
 
-Defined in: [components/Model.ts:17](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Model.ts#L17)
+Defined in: [components/Model.ts:17](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/Model.ts#L17)
 
 Write a model's load state as NON-ENUMERABLE own properties, so it never
 enters snapshots, undo history or saved projects. Always via defineProperty

package/dist/docs/api/components/functions/setPhysicsLiveRef.md

@@ -13,7 +13,7 @@ function setPhysicsLiveRef(
    value): void;
 ```
 
-Defined in: [components/Physics.ts:370](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Physics.ts#L370)
+Defined in: [components/Physics.ts:370](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/Physics.ts#L370)
 
 ## Parameters
 

package/dist/docs/api/components/index.md

@@ -14,9 +14,11 @@
 | ------ | ------ |
 | [AnimationComponent](classes/AnimationComponent.md) | Animation catalog and runtime state for an entity. Combines clips imported from a model with externally added clips, exposes a state machine for named transitions, and is queried each frame by the animation system to advance mixer time. |
 | [AudioComponent](classes/AudioComponent.md) | Plays an audio clip from `path`. Supports both global stereo (`positional: false`) and 3D positional audio with the configured distance model. Runtime fields (`object`, `audio`, `isPlaying`, `isPaused`) are recreated when the project loads and are never persisted to saved snapshots. |
+| [BoneAttachmentComponent](classes/BoneAttachmentComponent.md) | Fixes an entity to a bone of its PARENT's model — a sword in a hand, a hat on a head, a backpack on the chest — so it moves with every animation. |
 | [CameraComponent](classes/CameraComponent.md) | Camera entity state. Supports perspective and orthographic projections, a `3d` or `ar` runtime type, and an `isDefault` flag for the camera that the preview/editor renders through. Field-of-view, near/far, ortho frustum, and zoom are persisted; the live `THREE.Camera` is recreated when the project loads. |
 | [EntityType](classes/EntityType.md) | Tags an entity with the kind it was created from (`cube`, `sphere`, `model`, `directionalLight`, etc.). Factories use this to drive kind-specific behavior; the editor inspector uses it to select component editors. |
 | [Environment](classes/Environment.md) | Scene environment settings: skybox (gradient/color/image), fog (linear/exponential), gravity vector for the physics world, and optional image-based lighting / tone mapping (`values.lighting`). Singleton-style — attached to one environment entity per scene. |
+| [IKComponent](classes/IKComponent.md) | Inverse kinematics for a humanoid model: after the animation plays, each chain bends an arm or leg so its hand/foot reaches a target entity — the second hand on a rifle's grip, a hand on a door handle, a foot on a step. The elbow/knee keeps the animation's bend unless a pole entity says otherwise. Bones are found by humanoid name, so any rig the editor recognises works (Mixamo, auto-rigs, Unreal, VRM). |
 | [ImageComponent](classes/ImageComponent.md) | Renders a 2D image as a textured quad in the scene. Width/height are in world units. Texture loading is handled by the image system, which populates [ImageComponent.texture](classes/ImageComponent.md#texture) and [ImageComponent.object](classes/ImageComponent.md#object) asynchronously. |
 | [ImageTarget](classes/ImageTarget.md) | Image-tracking target metadata used by AR projects. Holds the source images users uploaded plus the URL of the compiled `.mind` target file produced by the image-target compiler. Pair with [ImageTargetAnchor](classes/ImageTargetAnchor.md) on child entities that should appear when the target is detected. |
 | [ImageTargetAnchor](classes/ImageTargetAnchor.md) | Marks an entity as an anchor for an image-tracking target. The image tracking system reveals the entity when the referenced target is found and hides it when the target is lost. |
@@ -28,6 +30,10 @@
 | [MeshGeometryComponent](classes/MeshGeometryComponent.md) | Editable geometry parameters for primitive meshes (cube, sphere, plane, capsule, cylinder) and the placeholder for `model` entities. Holds the authoring values plus shadow casting/receiving flags. The mesh-geometry system rebuilds the underlying `BufferGeometry` when parameters change. |
 | [ModelComponent](classes/ModelComponent.md) | References a GLTF/GLB asset loaded from `path`. The model loading system resolves the asset asynchronously and populates [ModelComponent.object](classes/ModelComponent.md#object) once available; loading is deferred-tolerant so the entity exists before the model finishes loading. [ModelComponent.loadState](classes/ModelComponent.md#loadstate) reports progress (`"loading"` → `"loaded"` or `"error"`). |
 | [Name](classes/Name.md) | Human-readable name for an entity. Shown in the editor hierarchy panel and preserved across save/reload. |
+| [NetworkIdentityComponent](classes/NetworkIdentityComponent.md) | Marks an entity as shared between players. A scene object is simulated by the host (the first player in the room, then the longest connected); a spawned object belongs to the player who spawned it and leaves with them. |
+| [NetworkTransformComponent](classes/NetworkTransformComponent.md) | Shares an entity's position and rotation. The owner moves it at once and sends updates; everyone else plays them back a little in the past, so movement is smooth however the packets arrive. |
+| [NetworkedPropsComponent](classes/NetworkedPropsComponent.md) | Named values shared with everyone: a health bar, a score. Only the entity's owner can change them, with `this.network.setProp()`. `values` holds the starting values, and a Behaviour hears changes in `onNetworkProp`. |
+| [NetworkSpawnerComponent](classes/NetworkSpawnerComponent.md) | Gives each player an avatar: when a client connects it spawns `playerPrefab` as its own, placed around this entity. |
 | [Object3DRef](classes/Object3DRef.md) | Wraps the live `THREE.Object3D` for an entity. Almost every entity that renders to the scene carries an `Object3DRef` so transform sync, selection, and parenting systems can manipulate the underlying object. |
 | [ParentId](classes/ParentId.md) | Records the parent entity id for hierarchical scene graphs. `null` means the entity is at the world root. The `ObjectManagementSystem` reconciles scene-graph parenting from this component each frame. |
 | [PhysicsComponent](classes/PhysicsComponent.md) | Marker base class for every ECS component. Subclass `Component` to declare a typed data container that systems can query. |
@@ -60,6 +66,8 @@
 | Type Alias | Description |
 | ------ | ------ |
 | [AnimationComponentOptions](type-aliases/AnimationComponentOptions.md) | Initializer for [AnimationComponent](classes/AnimationComponent.md). |
+| [BoneHold](type-aliases/BoneHold.md) | Where an attached entity goes while certain clips play: a rifle slung on the back in Idle, a sword hidden in Swim. |
+| [BoneAttachmentOptions](type-aliases/BoneAttachmentOptions.md) | Optional initializer for [BoneAttachmentComponent](classes/BoneAttachmentComponent.md). |
 | [CameraRuntimeType](type-aliases/CameraRuntimeType.md) | 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). |
 | [CameraProjection](type-aliases/CameraProjection.md) | Projection model. |
 | [CameraComponentOptions](type-aliases/CameraComponentOptions.md) | Optional initializer for [CameraComponent](classes/CameraComponent.md). Any field omitted falls back to the defaults documented on the component. |
@@ -72,6 +80,9 @@
 | [EnvironmentFogState](type-aliases/EnvironmentFogState.md) | Fog configuration. Mirrors three.js `Fog` / `FogExp2`. |
 | [EnvironmentLightingState](type-aliases/EnvironmentLightingState.md) | Image-based lighting and renderer colour settings. Every field is optional; the defaults below apply when a field is missing. When the whole block is absent the scene's environment map and the renderer's tone mapping are left untouched. |
 | [EnvironmentState](type-aliases/EnvironmentState.md) | Aggregated authoring state owned by [Environment](classes/Environment.md). |
+| [IKLimb](type-aliases/IKLimb.md) | The limb a chain moves: its end bone, by humanoid name. |
+| [IKChain](type-aliases/IKChain.md) | One limb reaching for an entity. |
+| [IKOptions](type-aliases/IKOptions.md) | Optional initializer for [IKComponent](classes/IKComponent.md). |
 | [ImageTargetReference](type-aliases/ImageTargetReference.md) | Single uploaded image used as input to the image-target compiler. |
 | [ImageTargetAnchorOptions](type-aliases/ImageTargetAnchorOptions.md) | Optional initializer for [ImageTargetAnchor](classes/ImageTargetAnchor.md). |
 | [InstanceTransform](type-aliases/InstanceTransform.md) | Per-instance transform stored inside [InstancedMeshComponent](classes/InstancedMeshComponent.md). All rotations are in radians. |
@@ -89,6 +100,8 @@
 | [MeshGeometryParametersByKind](type-aliases/MeshGeometryParametersByKind.md) | Map from [EditableMeshObjectKind](type-aliases/EditableMeshObjectKind.md) to its parameter shape. |
 | [MeshGeometryParameters](type-aliases/MeshGeometryParameters.md) | - |
 | [ModelLoadState](type-aliases/ModelLoadState.md) | Load progress of a [ModelComponent](classes/ModelComponent.md)'s asset. |
+| [NetValue](type-aliases/NetValue.md) | A value a networked prop can hold: anything that survives JSON. |
+| [NetworkTransformOptions](type-aliases/NetworkTransformOptions.md) | - |
 | [RigidbodyType](type-aliases/RigidbodyType.md) | Rigidbody body type: - `dynamic`: simulated by physics; affected by forces and gravity. - `fixed`: immovable static body. - `kinematicPosition`: moved by setting next position; ignores forces. - `kinematicVelocity`: moved by setting velocity; ignores forces. |
 | [RigidbodyState](type-aliases/RigidbodyState.md) | Authoring state for the rigidbody half of [PhysicsComponent](classes/PhysicsComponent.md). Saved with the project. |
 | [ColliderShape](type-aliases/ColliderShape.md) | Collider primitive shape. `trimesh` derives geometry from the entity's mesh. |
@@ -102,13 +115,16 @@
 | [TransformSpaceValue](type-aliases/TransformSpaceValue.md) | Reference frame for the active gizmo. |
 | [Vec3](type-aliases/Vec3.md) | Plain XYZ vector. All ECS transform fields use this shape rather than `THREE.Vector3` so they save cleanly with the project. |
 | [TransformData](type-aliases/TransformData.md) | Optional initial values passed to [TransformComponent](classes/TransformComponent.md). Missing axes default to `0` for position/rotation and `1` for scale. |
+| [UiIconPosition](type-aliases/UiIconPosition.md) | - |
 | [UIButtonOptions](type-aliases/UIButtonOptions.md) | Optional initializer for [UIButtonComponent](classes/UIButtonComponent.md). |
 | [UiFollowMode](type-aliases/UiFollowMode.md) | How a panel orients itself while the experience runs. |
 | [UIPanelOptions](type-aliases/UIPanelOptions.md) | Optional initializer for [UIPanelComponent](classes/UIPanelComponent.md). |
+| [UiSliderVariant](type-aliases/UiSliderVariant.md) | - |
 | [UISliderOptions](type-aliases/UISliderOptions.md) | Optional initializer for [UISliderComponent](classes/UISliderComponent.md). |
 | [UiTextAlign](type-aliases/UiTextAlign.md) | - |
 | [UiTextVAlign](type-aliases/UiTextVAlign.md) | - |
 | [UITextOptions](type-aliases/UITextOptions.md) | Optional initializer for [UITextComponent](classes/UITextComponent.md). |
+| [UiToggleVariant](type-aliases/UiToggleVariant.md) | - |
 | [UIToggleOptions](type-aliases/UIToggleOptions.md) | Optional initializer for [UIToggleComponent](classes/UIToggleComponent.md). |
 | [VrTeleportShape](type-aliases/VrTeleportShape.md) | Footprint of a teleport destination. |
 | [VRTeleportAreaOptions](type-aliases/VRTeleportAreaOptions.md) | Optional initializer for [VRTeleportAreaComponent](classes/VRTeleportAreaComponent.md). |
@@ -154,7 +170,9 @@
 
 | Function | Description |
 | ------ | ------ |
+| [normalizeBoneHold](functions/normalizeBoneHold.md) | A hold with every field filled in. |
 | [normalizeEnvironmentLighting](functions/normalizeEnvironmentLighting.md) | Normalize a lighting block to a complete [EnvironmentLightingState](type-aliases/EnvironmentLightingState.md). Returns `undefined` when `value` is not an object, so a scene without the block stays without it. |
+| [normalizeIKChain](functions/normalizeIKChain.md) | A chain with every field filled in. |
 | [defaultMaterialValue](functions/defaultMaterialValue.md) | - |
 | [setModelLoadState](functions/setModelLoadState.md) | Write a model's load state as NON-ENUMERABLE own properties, so it never enters snapshots, undo history or saved projects. Always via defineProperty (the pattern `setPhysicsLiveRef` uses): plain assignment on a history-restored clone would create an ENUMERABLE property instead. |
 | [normalizePhysicsState](functions/normalizePhysicsState.md) | - |

package/dist/docs/api/components/type-aliases/AnimationComponentOptions.md

@@ -24,7 +24,7 @@ type AnimationComponentOptions = {
 };
 ```
 
-Defined in: [components/Animation.ts:10](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Animation.ts#L10)
+Defined in: [components/Animation.ts:10](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/Animation.ts#L10)
 
 Initializer for [AnimationComponent](../classes/AnimationComponent.md).
 
@@ -32,11 +32,11 @@ Initializer for [AnimationComponent](../classes/AnimationComponent.md).
 
 | Property | Type | Description | Defined in |
 | ------ | ------ | ------ | ------ |
-| <a id="clips"></a> `clips?` | `THREE.AnimationClip`[] | Initial set of clips imported from the entity's model. | [components/Animation.ts:12](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Animation.ts#L12) |
-| <a id="externalclipsources"></a> `externalClipSources?` | `string`[] | URLs (or `localasset://` paths) of clips to load asynchronously and merge into the catalog. | [components/Animation.ts:14](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Animation.ts#L14) |
-| <a id="activestate"></a> `activeState?` | `string` \| `null` | Name of the state to activate after construction. | [components/Animation.ts:16](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Animation.ts#L16) |
-| <a id="paused"></a> `paused?` | `boolean` | Whether playback starts paused. | [components/Animation.ts:18](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Animation.ts#L18) |
-| <a id="reverse"></a> `reverse?` | `boolean` | Play the active clip in reverse. | [components/Animation.ts:20](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Animation.ts#L20) |
-| <a id="timescale"></a> `timeScale?` | `number` | Time-scale multiplier (`1` = real-time). | [components/Animation.ts:22](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Animation.ts#L22) |
-| <a id="crossfadeduration"></a> `crossFadeDuration?` | `number` | Default cross-fade duration in seconds when switching states. | [components/Animation.ts:24](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Animation.ts#L24) |
-| <a id="states"></a> `states?` | \{ `name`: `string`; `clip`: `string`; `clipId?`: `string`; `loop?`: `boolean`; \}[] | Predefined state machine entries (`name` -> clip binding). | [components/Animation.ts:26](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Animation.ts#L26) |
+| <a id="clips"></a> `clips?` | `THREE.AnimationClip`[] | Initial set of clips imported from the entity's model. | [components/Animation.ts:12](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/Animation.ts#L12) |
+| <a id="externalclipsources"></a> `externalClipSources?` | `string`[] | URLs (or `localasset://` paths) of clips to load asynchronously and merge into the catalog. | [components/Animation.ts:14](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/Animation.ts#L14) |
+| <a id="activestate"></a> `activeState?` | `string` \| `null` | Name of the state to activate after construction. | [components/Animation.ts:16](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/Animation.ts#L16) |
+| <a id="paused"></a> `paused?` | `boolean` | Whether playback starts paused. | [components/Animation.ts:18](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/Animation.ts#L18) |
+| <a id="reverse"></a> `reverse?` | `boolean` | Play the active clip in reverse. | [components/Animation.ts:20](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/Animation.ts#L20) |
+| <a id="timescale"></a> `timeScale?` | `number` | Time-scale multiplier (`1` = real-time). | [components/Animation.ts:22](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/Animation.ts#L22) |
+| <a id="crossfadeduration"></a> `crossFadeDuration?` | `number` | Default cross-fade duration in seconds when switching states. | [components/Animation.ts:24](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/Animation.ts#L24) |
+| <a id="states"></a> `states?` | \{ `name`: `string`; `clip`: `string`; `clipId?`: `string`; `loop?`: `boolean`; \}[] | Predefined state machine entries (`name` -> clip binding). | [components/Animation.ts:26](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/Animation.ts#L26) |

package/dist/docs/api/components/type-aliases/BoneAttachmentOptions.md

@@ -0,0 +1,35 @@
+[**@relu-interactives/spatial-ecs**](../../index.md)
+
+***
+
+[@relu-interactives/spatial-ecs](../../index.md) / [components](../index.md) / BoneAttachmentOptions
+
+# Type Alias: BoneAttachmentOptions
+
+```ts
+type BoneAttachmentOptions = {
+  bone?: string;
+  humanoid?: string | null;
+  compensateScale?: boolean;
+  enabled?: boolean;
+  holds?: Partial<BoneHold> & {
+     clips: string[];
+  }[];
+  hideInOtherClips?: boolean;
+};
+```
+
+Defined in: [components/BoneAttachment.ts:45](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/BoneAttachment.ts#L45)
+
+Optional initializer for [BoneAttachmentComponent](../classes/BoneAttachmentComponent.md).
+
+## Properties
+
+| Property | Type | Description | Defined in |
+| ------ | ------ | ------ | ------ |
+| <a id="bone"></a> `bone?` | `string` | The bone's node name in the parent's model (as three.js names it). | [components/BoneAttachment.ts:47](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/BoneAttachment.ts#L47) |
+| <a id="humanoid"></a> `humanoid?` | `string` \| `null` | The bone's humanoid name (`rightHand`, `head` …), used when the node name isn't found (another rig). | [components/BoneAttachment.ts:49](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/BoneAttachment.ts#L49) |
+| <a id="compensatescale"></a> `compensateScale?` | `boolean` | Cancel the bone's world scale so offsets are in metres on any rig. Defaults to `true`. | [components/BoneAttachment.ts:51](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/BoneAttachment.ts#L51) |
+| <a id="enabled"></a> `enabled?` | `boolean` | Turn the attachment off without removing it. Defaults to `true`. | [components/BoneAttachment.ts:53](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/BoneAttachment.ts#L53) |
+| <a id="holds"></a> `holds?` | `Partial`\<[`BoneHold`](BoneHold.md)\> & \{ `clips`: `string`[]; \}[] | Where it goes in particular clips. Defaults to none. | [components/BoneAttachment.ts:55](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/BoneAttachment.ts#L55) |
+| <a id="hideinotherclips"></a> `hideInOtherClips?` | `boolean` | Hide it while a clip no hold names is playing. Defaults to `false`. | [components/BoneAttachment.ts:57](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/BoneAttachment.ts#L57) |

package/dist/docs/api/components/type-aliases/BoneHold.md

@@ -0,0 +1,34 @@
+[**@relu-interactives/spatial-ecs**](../../index.md)
+
+***
+
+[@relu-interactives/spatial-ecs](../../index.md) / [components](../index.md) / BoneHold
+
+# Type Alias: BoneHold
+
+```ts
+type BoneHold = {
+  clips: string[];
+  bone: string | null;
+  humanoid: string | null;
+  hidden: boolean;
+  position: Xyz | null;
+  rotation: Xyz | null;
+};
+```
+
+Defined in: [components/BoneAttachment.ts:10](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/BoneAttachment.ts#L10)
+
+Where an attached entity goes while certain clips play: a rifle slung on the
+back in Idle, a sword hidden in Swim.
+
+## Properties
+
+| Property | Type | Description | Defined in |
+| ------ | ------ | ------ | ------ |
+| <a id="clips"></a> `clips` | `string`[] | The clips this hold is for. | [components/BoneAttachment.ts:12](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/BoneAttachment.ts#L12) |
+| <a id="bone"></a> `bone` | `string` \| `null` | Another bone, by node name, for these clips. Unset: the attachment's own. | [components/BoneAttachment.ts:14](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/BoneAttachment.ts#L14) |
+| <a id="humanoid"></a> `humanoid` | `string` \| `null` | Another bone by humanoid name, used when the node name isn't found (another rig). | [components/BoneAttachment.ts:16](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/BoneAttachment.ts#L16) |
+| <a id="hidden"></a> `hidden` | `boolean` | Hide the entity in these clips. | [components/BoneAttachment.ts:18](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/BoneAttachment.ts#L18) |
+| <a id="position"></a> `position` | `Xyz` \| `null` | Offset from the bone in these clips, instead of the entity's Transform position. | [components/BoneAttachment.ts:20](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/BoneAttachment.ts#L20) |
+| <a id="rotation"></a> `rotation` | `Xyz` \| `null` | Rotation from the bone in radians, instead of the entity's Transform rotation. | [components/BoneAttachment.ts:22](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/BoneAttachment.ts#L22) |

package/dist/docs/api/components/type-aliases/CameraComponentOptions.md

@@ -23,7 +23,7 @@ type CameraComponentOptions = {
 };
 ```
 
-Defined in: [components/Camera.ts:15](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Camera.ts#L15)
+Defined in: [components/Camera.ts:15](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/Camera.ts#L15)
 
 Optional initializer for [CameraComponent](../classes/CameraComponent.md). Any field omitted falls back to the defaults documented on the component.
 
@@ -31,15 +31,15 @@ Optional initializer for [CameraComponent](../classes/CameraComponent.md). Any f
 
 | Property | Type | Description | Defined in |
 | ------ | ------ | ------ | ------ |
-| <a id="camera"></a> `camera?` | `THREE.Camera` | Pre-built three.js camera. When omitted the component creates one from [projection](#projection). | [components/Camera.ts:17](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Camera.ts#L17) |
-| <a id="type"></a> `type?` | [`CameraRuntimeType`](CameraRuntimeType.md) | Runtime camera mode. | [components/Camera.ts:19](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Camera.ts#L19) |
-| <a id="isdefault"></a> `isDefault?` | `boolean` | Mark this camera as the default camera the renderer uses. | [components/Camera.ts:21](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Camera.ts#L21) |
-| <a id="projection"></a> `projection?` | [`CameraProjection`](CameraProjection.md) | Projection model. | [components/Camera.ts:23](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Camera.ts#L23) |
-| <a id="fov"></a> `fov?` | `number` | Vertical field of view in **degrees** (perspective only). | [components/Camera.ts:25](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Camera.ts#L25) |
-| <a id="near"></a> `near?` | `number` | Near clip plane in world units. | [components/Camera.ts:27](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Camera.ts#L27) |
-| <a id="far"></a> `far?` | `number` | Far clip plane in world units. | [components/Camera.ts:29](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Camera.ts#L29) |
-| <a id="left"></a> `left?` | `number` | Left edge of the orthographic frustum in world units. | [components/Camera.ts:31](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Camera.ts#L31) |
-| <a id="right"></a> `right?` | `number` | Right edge of the orthographic frustum in world units. | [components/Camera.ts:33](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Camera.ts#L33) |
-| <a id="top"></a> `top?` | `number` | Top edge of the orthographic frustum in world units. | [components/Camera.ts:35](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Camera.ts#L35) |
-| <a id="bottom"></a> `bottom?` | `number` | Bottom edge of the orthographic frustum in world units. | [components/Camera.ts:37](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Camera.ts#L37) |
-| <a id="zoom"></a> `zoom?` | `number` | Zoom multiplier (`1` = no zoom). | [components/Camera.ts:39](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Camera.ts#L39) |
+| <a id="camera"></a> `camera?` | `THREE.Camera` | Pre-built three.js camera. When omitted the component creates one from [projection](#projection). | [components/Camera.ts:17](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/Camera.ts#L17) |
+| <a id="type"></a> `type?` | [`CameraRuntimeType`](CameraRuntimeType.md) | Runtime camera mode. | [components/Camera.ts:19](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/Camera.ts#L19) |
+| <a id="isdefault"></a> `isDefault?` | `boolean` | Mark this camera as the default camera the renderer uses. | [components/Camera.ts:21](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/Camera.ts#L21) |
+| <a id="projection"></a> `projection?` | [`CameraProjection`](CameraProjection.md) | Projection model. | [components/Camera.ts:23](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/Camera.ts#L23) |
+| <a id="fov"></a> `fov?` | `number` | Vertical field of view in **degrees** (perspective only). | [components/Camera.ts:25](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/Camera.ts#L25) |
+| <a id="near"></a> `near?` | `number` | Near clip plane in world units. | [components/Camera.ts:27](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/Camera.ts#L27) |
+| <a id="far"></a> `far?` | `number` | Far clip plane in world units. | [components/Camera.ts:29](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/Camera.ts#L29) |
+| <a id="left"></a> `left?` | `number` | Left edge of the orthographic frustum in world units. | [components/Camera.ts:31](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/Camera.ts#L31) |
+| <a id="right"></a> `right?` | `number` | Right edge of the orthographic frustum in world units. | [components/Camera.ts:33](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/Camera.ts#L33) |
+| <a id="top"></a> `top?` | `number` | Top edge of the orthographic frustum in world units. | [components/Camera.ts:35](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/Camera.ts#L35) |
+| <a id="bottom"></a> `bottom?` | `number` | Bottom edge of the orthographic frustum in world units. | [components/Camera.ts:37](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/Camera.ts#L37) |
+| <a id="zoom"></a> `zoom?` | `number` | Zoom multiplier (`1` = no zoom). | [components/Camera.ts:39](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/Camera.ts#L39) |

package/dist/docs/api/components/type-aliases/CameraProjection.md

@@ -10,6 +10,6 @@
 type CameraProjection = "perspective" | "orthographic";
 ```
 
-Defined in: [components/Camera.ts:12](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Camera.ts#L12)
+Defined in: [components/Camera.ts:12](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/Camera.ts#L12)
 
 Projection model.

package/dist/docs/api/components/type-aliases/CameraRuntimeType.md

@@ -10,7 +10,7 @@
 type CameraRuntimeType = "3d" | "ar" | "xr";
 ```
 
-Defined in: [components/Camera.ts:10](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Camera.ts#L10)
+Defined in: [components/Camera.ts:10](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/Camera.ts#L10)
 
 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

package/dist/docs/api/components/type-aliases/ColliderShape.md

@@ -10,6 +10,6 @@
 type ColliderShape = "cuboid" | "ball" | "capsule" | "cylinder" | "trimesh";
 ```
 
-Defined in: [components/Physics.ts:83](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Physics.ts#L83)
+Defined in: [components/Physics.ts:83](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/Physics.ts#L83)
 
 Collider primitive shape. `trimesh` derives geometry from the entity's mesh.

package/dist/docs/api/components/type-aliases/ColliderState.md

@@ -33,7 +33,7 @@ type ColliderState = {
 };
 ```
 
-Defined in: [components/Physics.ts:91](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Physics.ts#L91)
+Defined in: [components/Physics.ts:91](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/Physics.ts#L91)
 
 Authoring state for the collider half of [PhysicsComponent](../classes/PhysicsComponent.md). Only the size fields relevant to [ColliderState.shape](#shape) are read at simulation time.
 
@@ -41,22 +41,22 @@ Authoring state for the collider half of [PhysicsComponent](../classes/PhysicsCo
 
 | Property | Type | Description | Defined in |
 | ------ | ------ | ------ | ------ |
-| <a id="enabled"></a> `enabled` | `boolean` | When `false`, the collider is removed from physics simulation but kept in state. | [components/Physics.ts:93](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Physics.ts#L93) |
-| <a id="shape"></a> `shape` | [`ColliderShape`](ColliderShape.md) | Collider primitive shape. | [components/Physics.ts:95](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Physics.ts#L95) |
-| <a id="offsetposition"></a> `offsetPosition` | \{ `x`: `number`; `y`: `number`; `z`: `number`; \} | Local offset of the collider relative to the entity's transform, in world units. | [components/Physics.ts:97](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Physics.ts#L97) |
-| `offsetPosition.x` | `number` | Offset along local X. | [components/Physics.ts:99](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Physics.ts#L99) |
-| `offsetPosition.y` | `number` | Offset along local Y. | [components/Physics.ts:101](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Physics.ts#L101) |
-| `offsetPosition.z` | `number` | Offset along local Z. | [components/Physics.ts:103](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Physics.ts#L103) |
-| <a id="offsetrotation"></a> `offsetRotation` | \{ `x`: `number`; `y`: `number`; `z`: `number`; \} | Local rotation offset in **radians** (Euler XYZ). | [components/Physics.ts:106](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Physics.ts#L106) |
-| `offsetRotation.x` | `number` | Rotation around local X (radians). | [components/Physics.ts:108](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Physics.ts#L108) |
-| `offsetRotation.y` | `number` | Rotation around local Y (radians). | [components/Physics.ts:110](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Physics.ts#L110) |
-| `offsetRotation.z` | `number` | Rotation around local Z (radians). | [components/Physics.ts:112](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Physics.ts#L112) |
-| <a id="size"></a> `size` | \{ `x`: `number`; `y`: `number`; `z`: `number`; \} | FULL edge lengths for `cuboid` shape (NOT half-extents), in unscaled local units — multiplied by the entity world scale at collider build time. | [components/Physics.ts:115](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Physics.ts#L115) |
-| `size.x` | `number` | Half-extent along X. | [components/Physics.ts:117](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Physics.ts#L117) |
-| `size.y` | `number` | Half-extent along Y. | [components/Physics.ts:119](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Physics.ts#L119) |
-| `size.z` | `number` | Half-extent along Z. | [components/Physics.ts:121](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Physics.ts#L121) |
-| <a id="radius"></a> `radius` | `number` | Radius for `ball`, `capsule`, and `cylinder` shapes. | [components/Physics.ts:124](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Physics.ts#L124) |
-| <a id="height"></a> `height` | `number` | Height for `capsule` (segment length between caps) and `cylinder`. | [components/Physics.ts:126](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Physics.ts#L126) |
-| <a id="restitution"></a> `restitution` | `number` | Bounciness in `[0, 1]`. `0` is no bounce; `1` is perfectly elastic. | [components/Physics.ts:128](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Physics.ts#L128) |
-| <a id="friction"></a> `friction` | `number` | Surface friction coefficient. `0` is frictionless. | [components/Physics.ts:130](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Physics.ts#L130) |
-| <a id="issensor"></a> `isSensor` | `boolean` | When `true`, the collider reports overlaps but does not generate contact responses. | [components/Physics.ts:132](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Physics.ts#L132) |
+| <a id="enabled"></a> `enabled` | `boolean` | When `false`, the collider is removed from physics simulation but kept in state. | [components/Physics.ts:93](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/Physics.ts#L93) |
+| <a id="shape"></a> `shape` | [`ColliderShape`](ColliderShape.md) | Collider primitive shape. | [components/Physics.ts:95](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/Physics.ts#L95) |
+| <a id="offsetposition"></a> `offsetPosition` | \{ `x`: `number`; `y`: `number`; `z`: `number`; \} | Local offset of the collider relative to the entity's transform, in world units. | [components/Physics.ts:97](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/Physics.ts#L97) |
+| `offsetPosition.x` | `number` | Offset along local X. | [components/Physics.ts:99](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/Physics.ts#L99) |
+| `offsetPosition.y` | `number` | Offset along local Y. | [components/Physics.ts:101](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/Physics.ts#L101) |
+| `offsetPosition.z` | `number` | Offset along local Z. | [components/Physics.ts:103](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/Physics.ts#L103) |
+| <a id="offsetrotation"></a> `offsetRotation` | \{ `x`: `number`; `y`: `number`; `z`: `number`; \} | Local rotation offset in **radians** (Euler XYZ). | [components/Physics.ts:106](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/Physics.ts#L106) |
+| `offsetRotation.x` | `number` | Rotation around local X (radians). | [components/Physics.ts:108](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/Physics.ts#L108) |
+| `offsetRotation.y` | `number` | Rotation around local Y (radians). | [components/Physics.ts:110](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/Physics.ts#L110) |
+| `offsetRotation.z` | `number` | Rotation around local Z (radians). | [components/Physics.ts:112](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/Physics.ts#L112) |
+| <a id="size"></a> `size` | \{ `x`: `number`; `y`: `number`; `z`: `number`; \} | FULL edge lengths for `cuboid` shape (NOT half-extents), in unscaled local units — multiplied by the entity world scale at collider build time. | [components/Physics.ts:115](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/Physics.ts#L115) |
+| `size.x` | `number` | Half-extent along X. | [components/Physics.ts:117](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/Physics.ts#L117) |
+| `size.y` | `number` | Half-extent along Y. | [components/Physics.ts:119](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/Physics.ts#L119) |
+| `size.z` | `number` | Half-extent along Z. | [components/Physics.ts:121](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/Physics.ts#L121) |
+| <a id="radius"></a> `radius` | `number` | Radius for `ball`, `capsule`, and `cylinder` shapes. | [components/Physics.ts:124](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/Physics.ts#L124) |
+| <a id="height"></a> `height` | `number` | Height for `capsule` (segment length between caps) and `cylinder`. | [components/Physics.ts:126](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/Physics.ts#L126) |
+| <a id="restitution"></a> `restitution` | `number` | Bounciness in `[0, 1]`. `0` is no bounce; `1` is perfectly elastic. | [components/Physics.ts:128](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/Physics.ts#L128) |
+| <a id="friction"></a> `friction` | `number` | Surface friction coefficient. `0` is frictionless. | [components/Physics.ts:130](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/Physics.ts#L130) |
+| <a id="issensor"></a> `isSensor` | `boolean` | When `true`, the collider reports overlaps but does not generate contact responses. | [components/Physics.ts:132](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/Physics.ts#L132) |

package/dist/docs/api/components/type-aliases/CubeMeshParameters.md

@@ -14,7 +14,7 @@ type CubeMeshParameters = {
 };
 ```
 
-Defined in: [components/MeshGeometry.ts:15](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/MeshGeometry.ts#L15)
+Defined in: [components/MeshGeometry.ts:15](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/MeshGeometry.ts#L15)
 
 Box geometry parameters in world units.
 
@@ -22,6 +22,6 @@ Box geometry parameters in world units.
 
 | Property | Type | Description | Defined in |
 | ------ | ------ | ------ | ------ |
-| <a id="width"></a> `width` | `number` | Box width along X. | [components/MeshGeometry.ts:17](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/MeshGeometry.ts#L17) |
-| <a id="height"></a> `height` | `number` | Box height along Y. | [components/MeshGeometry.ts:19](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/MeshGeometry.ts#L19) |
-| <a id="depth"></a> `depth` | `number` | Box depth along Z. | [components/MeshGeometry.ts:21](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/MeshGeometry.ts#L21) |
+| <a id="width"></a> `width` | `number` | Box width along X. | [components/MeshGeometry.ts:17](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/MeshGeometry.ts#L17) |
+| <a id="height"></a> `height` | `number` | Box height along Y. | [components/MeshGeometry.ts:19](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/MeshGeometry.ts#L19) |
+| <a id="depth"></a> `depth` | `number` | Box depth along Z. | [components/MeshGeometry.ts:21](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/MeshGeometry.ts#L21) |

package/dist/docs/api/components/type-aliases/EditableMeshObjectKind.md

@@ -10,6 +10,6 @@
 type EditableMeshObjectKind = "capsule" | "cube" | "cylinder" | "model" | "plane" | "sphere";
 ```
 
-Defined in: [components/MeshGeometry.ts:6](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/MeshGeometry.ts#L6)
+Defined in: [components/MeshGeometry.ts:6](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/1f58a477b3cb6564276f2cb1b267d20fd5344345/core/components/MeshGeometry.ts#L6)
 
 Editable primitive kinds the mesh-geometry system can rebuild on the fly. `model` is a passthrough placeholder for entities that own a loaded GLTF/GLB instead.