@relu-interactives/spatial-ecs 0.2.2 → 0.2.4

package/README.md

@@ -1,125 +1,56 @@
 # @relu-interactives/spatial-ecs
 
-Reusable ECS core engine for Relu Spatial editor and runtime experiences.
+Shared ECS (Entity-Component-System) engine powering the Relu Spatial editor and preview runtimes.
 
-## Package
+## What it is
 
-- Name: `@relu-interactives/spatial-ecs`
-- Registry: GitHub Packages (`https://npm.pkg.github.com`)
-- Publish workflow: `.github/workflows/publish-package.yml`
-- Publish trigger: push tags matching `v*` (or manual workflow dispatch)
-- Publish access: public (`npm publish --access public`)
+`@relu-interactives/spatial-ecs` is the source of truth for entity/component/system behavior used across Relu Spatial experiences. It provides a deterministic, serializable scene graph that can be saved, hydrated, and executed identically in both the editor authoring environment and deployed AR/VR previews.
 
-## Prerequisites
+## What it contains
 
-1. You have write access to this repository.
-2. GitHub Packages permissions are enabled for the repository.
-3. Your account/token has package read/write permissions.
-4. Node.js 20+ and npm are installed locally.
+| Area | Path | Description |
+|---|---|---|
+| **Components** | `core/components/**` | Runtime state containers (Transform, Model, Animation, Physics, Light, …) |
+| **Component factories** | `core/factories/components/**` | APIs for creating and updating component instances |
+| **Object factories** | `core/factories/objects/**` | Entity assembly — wires baseline components onto scene objects |
+| **Systems** | `core/systems/**` | Frame-by-frame runtime behavior and scene synchronization |
+| **World** | `core/World.ts` | ECS storage, lifecycle, system scheduling, snapshot and history management |
+| **Hydration** | `core/hydration/**` | World reconstruction from saved snapshot data |
+| **Snapshot utils** | `core/worldSnapshotUtils.ts` | Snapshot normalization, cloning, and debug helpers |
+| **Scripting** | `core/Behaviour.ts`, `core/ScriptTemplate.ts` | Base classes for user-authored ECS scripts |
 
-## Local Development
-
-Install dependencies:
+## Installation
 
 ```bash
-npm ci
-```
-
-Build package:
-
-```bash
-npm run build
-```
-
-Type check:
-
-```bash
-npm run typecheck
-```
-
-## Creating a Release Version
-
-Use one of the version scripts:
-
-```bash
-npm run release:patch
-# or
-npm run release:minor
+npm install @relu-interactives/spatial-ecs
 # or
-npm run release:major
+pnpm add @relu-interactives/spatial-ecs
 ```
 
-This updates `package.json` version and creates a git tag.
-
-## Publishing via GitHub Actions (Recommended)
-
-1. Commit your changes (including the version bump).
-2. Push commit and tag.
+`three` is a peer dependency and must be installed separately:
 
 ```bash
-git add .
-git commit -m "release: bump package version"
-git push && git push --tags
-git push --follow-tags
+npm install three
 ```
 
-3. GitHub Action `Publish Spatial ECS Package` runs automatically.
-4. Verify publish in:
-   - Repository `Actions` tab
-   - Repository `Packages` section
-
-## Make Package Public (GitHub UI)
-
-For already-published package versions, you may need a one-time visibility change in GitHub:
-
-1. Open repository `Packages`.
-2. Open package `@relu-interactives/spatial-ecs`.
-3. Go to `Package settings`.
-4. Under `Danger Zone`, change visibility to `Public`.
-
-After this, new releases published by the workflow remain public.
-
-## Manual Publish (Optional)
-
-If needed, publish from your machine.
-
-Create/update your user `.npmrc` with GitHub Packages auth:
-
-```ini
-@relu-interactives:registry=https://npm.pkg.github.com
-//npm.pkg.github.com/:_authToken=YOUR_GITHUB_TOKEN
-always-auth=true
-```
-
-Then run:
+## Local Development
 
 ```bash
-npm ci
-npm run build
-npm publish
+pnpm install
+pnpm run build
+pnpm run typecheck
 ```
 
-## Consuming This Package
+## Key Concepts
 
-In consumer projects, set scope registry:
+### Entities and Components
 
-```ini
-@relu-interactives:registry=https://npm.pkg.github.com
-//npm.pkg.github.com/:_authToken=${GITHUB_PACKAGES_TOKEN}
-always-auth=true
-```
+Entities are integer IDs. Components are plain data containers attached to entities and stored in the World. Systems query for entities that have specific component combinations and apply runtime behavior each frame.
 
-Install:
+### Snapshot and Hydration
 
-```bash
-npm install @relu-interactives/spatial-ecs
-```
+The world can be serialized to a plain JSON snapshot and fully reconstructed via `hydrateWorldFromSnapshotDetailed`. Snapshots are designed to be forward-compatible — hydration is tolerant of missing or legacy fields.
 
-## Troubleshooting
+### Editor / Preview Parity
 
-- `403 Forbidden` / `401 Unauthorized`:
-  - Check token permissions (`read:packages` for install, `write:packages` for publish).
-- `You cannot publish over the previously published versions`:
-  - Bump version before publishing.
-- Workflow succeeds build but fails publish:
-  - Confirm package name scope matches workflow scope (`@relu-interactives`).
+The same component contracts, factory logic, and hydration path are used by both the editor and the preview runtime. Changes to any of these must preserve behavior across both consumers.

package/dist/{System-rXAmagXA.d.cts → System-BTyYvKVH.d.cts}

@@ -464,6 +464,7 @@ declare class World {
     private readonly featureFlags;
     private components;
     private inputSystem;
+    private objectManagementSystem;
     private rapierModule;
     private rapierModulePromise;
     private physicsWorld;
@@ -590,6 +591,7 @@ declare class World {
     getEntitiesByName(name: string): WorldEntityView[];
     getEntityByName(name: string): WorldEntityView | null;
     getEntityById(entityId: number): WorldEntityView | null;
+    getObjectManagementSystem(): ObjectManagementSystem;
     /**
      * Cast a ray from `origin` along `direction` and return every intersected
      * entity-bound mesh, sorted by distance. Each result is a standard

package/dist/{System-rXAmagXA.d.ts → System-BTyYvKVH.d.ts}

@@ -464,6 +464,7 @@ declare class World {
     private readonly featureFlags;
     private components;
     private inputSystem;
+    private objectManagementSystem;
     private rapierModule;
     private rapierModulePromise;
     private physicsWorld;
@@ -590,6 +591,7 @@ declare class World {
     getEntitiesByName(name: string): WorldEntityView[];
     getEntityByName(name: string): WorldEntityView | null;
     getEntityById(entityId: number): WorldEntityView | null;
+    getObjectManagementSystem(): ObjectManagementSystem;
     /**
      * Cast a ray from `origin` along `direction` and return every intersected
      * entity-bound mesh, sorted by distance. Each result is a standard

package/dist/{Video-ChKV1UI7.d.ts → Video-BWhbvVPg.d.ts}

@@ -1,5 +1,5 @@
 import * as THREE from 'three';
-import { C as Component, e as EcsEntityKind, m as EcsEntityEditorKind, n as EntityId } from './System-rXAmagXA.js';
+import { C as Component, e as EcsEntityKind, m as EcsEntityEditorKind, n as EntityId } from './System-BTyYvKVH.js';
 import * as RAPIER from '@dimforge/rapier3d-compat';
 
 interface StateMachine {

package/dist/{Video-CDemv74U.d.cts → Video-D2H5H-K3.d.cts}

@@ -1,5 +1,5 @@
 import * as THREE from 'three';
-import { C as Component, e as EcsEntityKind, m as EcsEntityEditorKind, n as EntityId } from './System-rXAmagXA.cjs';
+import { C as Component, e as EcsEntityKind, m as EcsEntityEditorKind, n as EntityId } from './System-BTyYvKVH.cjs';
 import * as RAPIER from '@dimforge/rapier3d-compat';
 
 interface StateMachine {

package/dist/components/index.d.cts

@@ -1,4 +1,4 @@
-export { A as AnimationComponent, a as AnimationComponentOptions, b as AudioComponent, C as CameraComponent, c as CameraComponentOptions, d as CameraProjection, e as CameraRuntimeType, f as ColliderShape, g as ColliderState, h as CubeMeshParameters, D as DEFAULT_COLLIDER_STATE, i as DEFAULT_ENVIRONMENT_STATE, j as DEFAULT_MESH_GEOMETRY_PARAMETERS, k as DEFAULT_PHYSICS_STATE, l as DEFAULT_POSTPROCESSING_STATE, m as DEFAULT_RIGIDBODY_STATE, E as EditableMeshObjectKind, n as EntityType, o as Environment, p as EnvironmentFogState, q as EnvironmentFogType, r as EnvironmentGradientEffect, s as EnvironmentSkyboxState, t as EnvironmentSkyboxType, u as EnvironmentState, I as ImageComponent, v as ImageTarget, w as ImageTargetAnchor, x as ImageTargetAnchorOptions, y as ImageTargetReference, L as LightComponent, z as LightValueState, M as MaterialComponent, B as MaterialTypeValue, F as MaterialValueState, G as MeshComponent, H as MeshGeometryComponent, J as MeshGeometryParameters, K as MeshGeometryParametersByKind, N as ModelComponent, O as Name, P as Object3DRef, Q as PhysicsComponent, R as PhysicsState, S as PlaneMeshParameters, T as Postprocessing, U as PostprocessingState, V as RadiusHeightMeshParameters, W as RadiusMeshParameters, X as RigidbodyState, Y as RigidbodyType, Z as ScriptComponent, _ as ScriptEntry, $ as Selectable, a0 as SelectionTransformState, a1 as SpriteComponent, a2 as TextureFilteringValue, a3 as TransformModeValue, a4 as TransformSpaceValue, a5 as VideoComponent, a6 as normalizePhysicsState } from '../Video-CDemv74U.cjs';
-export { P as ParentId, T as TransformComponent, a as TransformData, V as Vec3 } from '../System-rXAmagXA.cjs';
+export { A as AnimationComponent, a as AnimationComponentOptions, b as AudioComponent, C as CameraComponent, c as CameraComponentOptions, d as CameraProjection, e as CameraRuntimeType, f as ColliderShape, g as ColliderState, h as CubeMeshParameters, D as DEFAULT_COLLIDER_STATE, i as DEFAULT_ENVIRONMENT_STATE, j as DEFAULT_MESH_GEOMETRY_PARAMETERS, k as DEFAULT_PHYSICS_STATE, l as DEFAULT_POSTPROCESSING_STATE, m as DEFAULT_RIGIDBODY_STATE, E as EditableMeshObjectKind, n as EntityType, o as Environment, p as EnvironmentFogState, q as EnvironmentFogType, r as EnvironmentGradientEffect, s as EnvironmentSkyboxState, t as EnvironmentSkyboxType, u as EnvironmentState, I as ImageComponent, v as ImageTarget, w as ImageTargetAnchor, x as ImageTargetAnchorOptions, y as ImageTargetReference, L as LightComponent, z as LightValueState, M as MaterialComponent, B as MaterialTypeValue, F as MaterialValueState, G as MeshComponent, H as MeshGeometryComponent, J as MeshGeometryParameters, K as MeshGeometryParametersByKind, N as ModelComponent, O as Name, P as Object3DRef, Q as PhysicsComponent, R as PhysicsState, S as PlaneMeshParameters, T as Postprocessing, U as PostprocessingState, V as RadiusHeightMeshParameters, W as RadiusMeshParameters, X as RigidbodyState, Y as RigidbodyType, Z as ScriptComponent, _ as ScriptEntry, $ as Selectable, a0 as SelectionTransformState, a1 as SpriteComponent, a2 as TextureFilteringValue, a3 as TransformModeValue, a4 as TransformSpaceValue, a5 as VideoComponent, a6 as normalizePhysicsState } from '../Video-D2H5H-K3.cjs';
+export { P as ParentId, T as TransformComponent, a as TransformData, V as Vec3 } from '../System-BTyYvKVH.cjs';
 import 'three';
 import '@dimforge/rapier3d-compat';

package/dist/components/index.d.ts

@@ -1,4 +1,4 @@
-export { A as AnimationComponent, a as AnimationComponentOptions, b as AudioComponent, C as CameraComponent, c as CameraComponentOptions, d as CameraProjection, e as CameraRuntimeType, f as ColliderShape, g as ColliderState, h as CubeMeshParameters, D as DEFAULT_COLLIDER_STATE, i as DEFAULT_ENVIRONMENT_STATE, j as DEFAULT_MESH_GEOMETRY_PARAMETERS, k as DEFAULT_PHYSICS_STATE, l as DEFAULT_POSTPROCESSING_STATE, m as DEFAULT_RIGIDBODY_STATE, E as EditableMeshObjectKind, n as EntityType, o as Environment, p as EnvironmentFogState, q as EnvironmentFogType, r as EnvironmentGradientEffect, s as EnvironmentSkyboxState, t as EnvironmentSkyboxType, u as EnvironmentState, I as ImageComponent, v as ImageTarget, w as ImageTargetAnchor, x as ImageTargetAnchorOptions, y as ImageTargetReference, L as LightComponent, z as LightValueState, M as MaterialComponent, B as MaterialTypeValue, F as MaterialValueState, G as MeshComponent, H as MeshGeometryComponent, J as MeshGeometryParameters, K as MeshGeometryParametersByKind, N as ModelComponent, O as Name, P as Object3DRef, Q as PhysicsComponent, R as PhysicsState, S as PlaneMeshParameters, T as Postprocessing, U as PostprocessingState, V as RadiusHeightMeshParameters, W as RadiusMeshParameters, X as RigidbodyState, Y as RigidbodyType, Z as ScriptComponent, _ as ScriptEntry, $ as Selectable, a0 as SelectionTransformState, a1 as SpriteComponent, a2 as TextureFilteringValue, a3 as TransformModeValue, a4 as TransformSpaceValue, a5 as VideoComponent, a6 as normalizePhysicsState } from '../Video-ChKV1UI7.js';
-export { P as ParentId, T as TransformComponent, a as TransformData, V as Vec3 } from '../System-rXAmagXA.js';
+export { A as AnimationComponent, a as AnimationComponentOptions, b as AudioComponent, C as CameraComponent, c as CameraComponentOptions, d as CameraProjection, e as CameraRuntimeType, f as ColliderShape, g as ColliderState, h as CubeMeshParameters, D as DEFAULT_COLLIDER_STATE, i as DEFAULT_ENVIRONMENT_STATE, j as DEFAULT_MESH_GEOMETRY_PARAMETERS, k as DEFAULT_PHYSICS_STATE, l as DEFAULT_POSTPROCESSING_STATE, m as DEFAULT_RIGIDBODY_STATE, E as EditableMeshObjectKind, n as EntityType, o as Environment, p as EnvironmentFogState, q as EnvironmentFogType, r as EnvironmentGradientEffect, s as EnvironmentSkyboxState, t as EnvironmentSkyboxType, u as EnvironmentState, I as ImageComponent, v as ImageTarget, w as ImageTargetAnchor, x as ImageTargetAnchorOptions, y as ImageTargetReference, L as LightComponent, z as LightValueState, M as MaterialComponent, B as MaterialTypeValue, F as MaterialValueState, G as MeshComponent, H as MeshGeometryComponent, J as MeshGeometryParameters, K as MeshGeometryParametersByKind, N as ModelComponent, O as Name, P as Object3DRef, Q as PhysicsComponent, R as PhysicsState, S as PlaneMeshParameters, T as Postprocessing, U as PostprocessingState, V as RadiusHeightMeshParameters, W as RadiusMeshParameters, X as RigidbodyState, Y as RigidbodyType, Z as ScriptComponent, _ as ScriptEntry, $ as Selectable, a0 as SelectionTransformState, a1 as SpriteComponent, a2 as TextureFilteringValue, a3 as TransformModeValue, a4 as TransformSpaceValue, a5 as VideoComponent, a6 as normalizePhysicsState } from '../Video-BWhbvVPg.js';
+export { P as ParentId, T as TransformComponent, a as TransformData, V as Vec3 } from '../System-BTyYvKVH.js';
 import 'three';
 import '@dimforge/rapier3d-compat';

package/dist/docs/api/Behaviour/classes/Behaviour.md

@@ -6,7 +6,7 @@
 
 # Class: Behaviour
 
-Defined in: [Behaviour.ts:62](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/Behaviour.ts#L62)
+Defined in: [Behaviour.ts:62](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/Behaviour.ts#L62)
 
 Base class for all user-authored scripts attached to an entity through a
 `ScriptComponent`. Subclass `Behaviour` to drive per-frame logic on a single
@@ -76,7 +76,7 @@ new Behaviour(
    component): Behaviour;
 ```
 
-Defined in: [Behaviour.ts:120](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/Behaviour.ts#L120)
+Defined in: [Behaviour.ts:120](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/Behaviour.ts#L120)
 
 Engine-managed constructor. Hosts (`ScriptBehaviourSystem`) instantiate
 subclasses with the owning world, the entity id, and the script's `data`
@@ -98,13 +98,13 @@ payload. User code should not call this directly.
 
 | Property | Type | Default value | Description | Defined in |
 | ------ | ------ | ------ | ------ | ------ |
-| <a id="data"></a> `data` | \| [`Component`](../../Component/classes/Component.md) \| `Record`\<`string`, `unknown`\> | `undefined` | Inspector-bound payload from the entity's `ScriptComponent`. Override the type on subclasses with `declare data: MyDataShape` to get type safety inside hooks. Saved with the project so values persist across reloads. | [Behaviour.ts:78](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/Behaviour.ts#L78) |
-| <a id="entityid"></a> `entityId` | `number` | `undefined` | Numeric id of the entity this script is attached to. | [Behaviour.ts:81](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/Behaviour.ts#L81) |
-| <a id="entity"></a> `entity` | `WorldEntityView` | `undefined` | View of the owning entity (id + components) at construction time. | [Behaviour.ts:84](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/Behaviour.ts#L84) |
-| <a id="threeref"></a> `threeRef` | [`Object3DRef`](../../components/classes/Object3DRef.md) | `undefined` | Live three.js object wrapper for the entity. May be `null` for entities with no scene presence; helpers on this class return `null` in that case. | [Behaviour.ts:90](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/Behaviour.ts#L90) |
-| <a id="transform"></a> `transform` | [`TransformComponent`](../../components/classes/TransformComponent.md) | `undefined` | The entity's [TransformComponent](../../components/classes/TransformComponent.md). Mutating `position`, `rotation`, or `scale` here is picked up the same frame by `TransformSyncSystem`. | [Behaviour.ts:96](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/Behaviour.ts#L96) |
-| <a id="world"></a> `world` | [`World`](../../index/classes/World.md) | `undefined` | The owning [World](../../index/classes/World.md). Refreshed each frame in [Behaviour.update](#update). Use it to query other entities or components. | [Behaviour.ts:102](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/Behaviour.ts#L102) |
-| <a id="deltatime"></a> `deltaTime` | `number` | `0` | Seconds elapsed since the last frame. Set by the engine before each [Behaviour.onUpdate](#onupdate). | [Behaviour.ts:108](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/Behaviour.ts#L108) |
+| <a id="data"></a> `data` | \| [`Component`](../../Component/classes/Component.md) \| `Record`\<`string`, `unknown`\> | `undefined` | Inspector-bound payload from the entity's `ScriptComponent`. Override the type on subclasses with `declare data: MyDataShape` to get type safety inside hooks. Saved with the project so values persist across reloads. | [Behaviour.ts:78](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/Behaviour.ts#L78) |
+| <a id="entityid"></a> `entityId` | `number` | `undefined` | Numeric id of the entity this script is attached to. | [Behaviour.ts:81](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/Behaviour.ts#L81) |
+| <a id="entity"></a> `entity` | `WorldEntityView` | `undefined` | View of the owning entity (id + components) at construction time. | [Behaviour.ts:84](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/Behaviour.ts#L84) |
+| <a id="threeref"></a> `threeRef` | [`Object3DRef`](../../components/classes/Object3DRef.md) | `undefined` | Live three.js object wrapper for the entity. May be `null` for entities with no scene presence; helpers on this class return `null` in that case. | [Behaviour.ts:90](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/Behaviour.ts#L90) |
+| <a id="transform"></a> `transform` | [`TransformComponent`](../../components/classes/TransformComponent.md) | `undefined` | The entity's [TransformComponent](../../components/classes/TransformComponent.md). Mutating `position`, `rotation`, or `scale` here is picked up the same frame by `TransformSyncSystem`. | [Behaviour.ts:96](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/Behaviour.ts#L96) |
+| <a id="world"></a> `world` | [`World`](../../index/classes/World.md) | `undefined` | The owning [World](../../index/classes/World.md). Refreshed each frame in [Behaviour.update](#update). Use it to query other entities or components. | [Behaviour.ts:102](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/Behaviour.ts#L102) |
+| <a id="deltatime"></a> `deltaTime` | `number` | `0` | Seconds elapsed since the last frame. Set by the engine before each [Behaviour.onUpdate](#onupdate). | [Behaviour.ts:108](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/Behaviour.ts#L108) |
 
 ## Methods
 
@@ -114,7 +114,7 @@ payload. User code should not call this directly.
 update(world, deltaTime): void;
 ```
 
-Defined in: [Behaviour.ts:144](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/Behaviour.ts#L144)
+Defined in: [Behaviour.ts:144](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/Behaviour.ts#L144)
 
 Engine-managed per-frame entry point. Refreshes [Behaviour.deltaTime](#deltatime)
 and delegates to [Behaviour.onUpdate](#onupdate).
@@ -149,7 +149,7 @@ CustomEcsSystem.update
 optional dispose(world): void;
 ```
 
-Defined in: [Behaviour.ts:156](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/Behaviour.ts#L156)
+Defined in: [Behaviour.ts:156](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/Behaviour.ts#L156)
 
 Optional cleanup hook invoked when the script is detached or the entity
 is destroyed. Override to release timers, listeners, or other resources.
@@ -178,7 +178,7 @@ CustomEcsSystem.dispose
 getWorldPosition(): Vector3 | null;
 ```
 
-Defined in: [Behaviour.ts:164](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/Behaviour.ts#L164)
+Defined in: [Behaviour.ts:164](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/Behaviour.ts#L164)
 
 Returns the entity's world-space position as a new `THREE.Vector3`, or
 `null` if the entity has no scene presence.
@@ -195,7 +195,7 @@ Returns the entity's world-space position as a new `THREE.Vector3`, or
 getWorldDirection(): Vector3 | null;
 ```
 
-Defined in: [Behaviour.ts:179](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/Behaviour.ts#L179)
+Defined in: [Behaviour.ts:179](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/Behaviour.ts#L179)
 
 Returns the entity's forward direction in world space (the +Z axis of its
 world matrix), or `null` if the entity has no scene presence.
@@ -212,7 +212,7 @@ world matrix), or `null` if the entity has no scene presence.
 directionTo(targetPosition): Vector3 | null;
 ```
 
-Defined in: [Behaviour.ts:196](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/Behaviour.ts#L196)
+Defined in: [Behaviour.ts:196](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/Behaviour.ts#L196)
 
 Returns a unit vector pointing from this entity toward the given world
 position, or `null` if the entity has no scene presence.
@@ -235,7 +235,7 @@ position, or `null` if the entity has no scene presence.
 distanceTo(targetPosition): number | null;
 ```
 
-Defined in: [Behaviour.ts:211](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/Behaviour.ts#L211)
+Defined in: [Behaviour.ts:211](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/Behaviour.ts#L211)
 
 Returns the world-space distance from this entity to the given position,
 or `null` if the entity has no scene presence.
@@ -258,7 +258,7 @@ or `null` if the entity has no scene presence.
 lerpTo(targetPosition, alpha): void;
 ```
 
-Defined in: [Behaviour.ts:229](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/Behaviour.ts#L229)
+Defined in: [Behaviour.ts:229](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/Behaviour.ts#L229)
 
 Linearly interpolates the entity's position toward `targetPosition` and
 writes the result back through [TransformComponent](../../components/classes/TransformComponent.md). No-op if the
@@ -283,7 +283,7 @@ entity has no scene presence.
 slerpTo(targetRotation, alpha): void;
 ```
 
-Defined in: [Behaviour.ts:251](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/Behaviour.ts#L251)
+Defined in: [Behaviour.ts:251](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/Behaviour.ts#L251)
 
 Spherically interpolates the entity's rotation toward `targetRotation`
 and writes the result back through [TransformComponent](../../components/classes/TransformComponent.md). No-op if
@@ -308,7 +308,7 @@ the entity has no scene presence.
 lookAt(targetPosition): void;
 ```
 
-Defined in: [Behaviour.ts:270](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/Behaviour.ts#L270)
+Defined in: [Behaviour.ts:270](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/Behaviour.ts#L270)
 
 Rotates the entity to face `targetPosition` in world space and writes the
 resulting orientation back through [TransformComponent](../../components/classes/TransformComponent.md). No-op if
@@ -332,7 +332,7 @@ the entity has no scene presence.
 getComponents(): Component[];
 ```
 
-Defined in: [Behaviour.ts:284](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/Behaviour.ts#L284)
+Defined in: [Behaviour.ts:284](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/Behaviour.ts#L284)
 
 Returns every component currently attached to this entity.
 
@@ -348,7 +348,7 @@ Returns every component currently attached to this entity.
 getComponent<T>(componentClass): T | null;
 ```
 
-Defined in: [Behaviour.ts:301](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/Behaviour.ts#L301)
+Defined in: [Behaviour.ts:301](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/Behaviour.ts#L301)
 
 Returns the entity's component of the given class, or `null` if it has
 no such component.
@@ -384,7 +384,7 @@ if (mesh) console.log(mesh.geometryRef);
 getEntity(): WorldEntityView | null;
 ```
 
-Defined in: [Behaviour.ts:311](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/Behaviour.ts#L311)
+Defined in: [Behaviour.ts:311](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/Behaviour.ts#L311)
 
 Returns the latest [WorldEntityView](../../types/type-aliases/WorldEntityView.md) snapshot for this entity, or
 `null` if it was destroyed.
@@ -401,7 +401,7 @@ Returns the latest [WorldEntityView](../../types/type-aliases/WorldEntityView.md
 getParent(): ParentLookup;
 ```
 
-Defined in: [Behaviour.ts:321](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/Behaviour.ts#L321)
+Defined in: [Behaviour.ts:321](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/Behaviour.ts#L321)
 
 Resolves the entity's parent from the [ParentId](../../components/classes/ParentId.md) component, if any.
 
@@ -420,7 +420,7 @@ A [ParentLookup](../../types/type-aliases/ParentLookup.md) with the parent compo
 getChildren(): WorldEntityView[];
 ```
 
-Defined in: [Behaviour.ts:342](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/Behaviour.ts#L342)
+Defined in: [Behaviour.ts:342](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/Behaviour.ts#L342)
 
 Returns every direct child entity of this one (entities whose
 [ParentId](../../components/classes/ParentId.md) matches `entityId`).
@@ -437,7 +437,7 @@ Returns every direct child entity of this one (entities whose
 protected init(): void;
 ```
 
-Defined in: [Behaviour.ts:361](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/Behaviour.ts#L361)
+Defined in: [Behaviour.ts:361](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/Behaviour.ts#L361)
 
 Called once before the first [Behaviour.onUpdate](#onupdate). Override to
 default and validate [Behaviour.data](#data), cache references, or set
@@ -460,7 +460,7 @@ entry.
 protected onUpdate(): void;
 ```
 
-Defined in: [Behaviour.ts:374](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/Behaviour.ts#L374)
+Defined in: [Behaviour.ts:374](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/Behaviour.ts#L374)
 
 Called every frame while the script is enabled. Override with the
 script's main per-frame logic.
@@ -483,7 +483,7 @@ rendering work such as custom shaders or procedural geometry.
 onSelect(): void;
 ```
 
-Defined in: [Behaviour.ts:379](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/Behaviour.ts#L379)
+Defined in: [Behaviour.ts:379](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/Behaviour.ts#L379)
 
 Called when the editor selects this entity. Optional UX hook.
 
@@ -499,7 +499,7 @@ Called when the editor selects this entity. Optional UX hook.
 onDeselect(): void;
 ```
 
-Defined in: [Behaviour.ts:384](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/Behaviour.ts#L384)
+Defined in: [Behaviour.ts:384](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/Behaviour.ts#L384)
 
 Called when the editor deselects this entity. Optional UX hook.
 
@@ -515,7 +515,7 @@ Called when the editor deselects this entity. Optional UX hook.
 onTargetFound(target): void;
 ```
 
-Defined in: [Behaviour.ts:394](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/Behaviour.ts#L394)
+Defined in: [Behaviour.ts:394](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/Behaviour.ts#L394)
 
 Called when an image-tracking target this entity depends on becomes
 visible. Optional AR hook.
@@ -538,7 +538,7 @@ visible. Optional AR hook.
 onTargetLost(target): void;
 ```
 
-Defined in: [Behaviour.ts:404](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/Behaviour.ts#L404)
+Defined in: [Behaviour.ts:404](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/Behaviour.ts#L404)
 
 Called when an image-tracking target this entity depends on is lost.
 Optional AR hook.

package/dist/docs/api/Component/classes/Component.md

@@ -6,7 +6,7 @@
 
 # Class: Component
 
-Defined in: [Component.ts:12](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/Component.ts#L12)
+Defined in: [Component.ts:12](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/Component.ts#L12)
 
 Marker base class for every ECS component. Subclass `Component` to declare
 a typed data container that systems can query.

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

@@ -6,7 +6,7 @@
 
 # Class: AnimationComponent
 
-Defined in: [components/Animation.ts:71](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/components/Animation.ts#L71)
+Defined in: [components/Animation.ts:71](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/components/Animation.ts#L71)
 
 Animation catalog and runtime state for an entity. Combines clips imported
 from a model with externally added clips, exposes a state machine for
@@ -30,7 +30,7 @@ machine directly so the animation system observes transitions.
 new AnimationComponent(options?): AnimationComponent;
 ```
 
-Defined in: [components/Animation.ts:102](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/components/Animation.ts#L102)
+Defined in: [components/Animation.ts:102](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/components/Animation.ts#L102)
 
 #### Parameters
 
@@ -50,18 +50,18 @@ Defined in: [components/Animation.ts:102](https://github.com/Relu-Interactives/r
 
 | Property | Type | Description | Defined in |
 | ------ | ------ | ------ | ------ |
-| <a id="clips"></a> `clips` | `AnimationClip`[] | Combined ordered list of clips (model + external) currently loaded. | [components/Animation.ts:78](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/components/Animation.ts#L78) |
-| <a id="clipcatalog"></a> `clipCatalog` | `AnimationClipCatalogEntry`[] | Per-clip metadata used by the inspector. | [components/Animation.ts:80](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/components/Animation.ts#L80) |
-| <a id="availableclips"></a> `availableClips` | `string`[] | Display names of clips available for state-machine bindings. | [components/Animation.ts:82](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/components/Animation.ts#L82) |
-| <a id="externalclipsources"></a> `externalClipSources` | `string`[] | URLs/paths of external clip sources (saved with the project). | [components/Animation.ts:84](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/components/Animation.ts#L84) |
-| <a id="paused"></a> `paused` | `boolean` | Whether playback is currently paused. | [components/Animation.ts:86](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/components/Animation.ts#L86) |
-| <a id="reverse"></a> `reverse` | `boolean` | Play the active clip in reverse. | [components/Animation.ts:88](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/components/Animation.ts#L88) |
-| <a id="timescale"></a> `timeScale` | `number` | Playback speed multiplier (`1` = real-time). | [components/Animation.ts:90](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/components/Animation.ts#L90) |
-| <a id="crossfadeduration"></a> `crossFadeDuration` | `number` | Default cross-fade duration in seconds when switching states. | [components/Animation.ts:92](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/components/Animation.ts#L92) |
-| <a id="states"></a> `states` | [`AnimationStateMachine`](../../index/classes/AnimationStateMachine.md)[] | All state-machine entries authored on this entity. | [components/Animation.ts:94](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/components/Animation.ts#L94) |
-| <a id="active"></a> `active` | \| [`AnimationStateMachine`](../../index/classes/AnimationStateMachine.md) \| `null` | State currently being played, or `null` if none. | [components/Animation.ts:96](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/components/Animation.ts#L96) |
-| <a id="activestatename"></a> `activeStateName` | `string` \| `null` | Name of the [active](#active) state, or `null` if none. | [components/Animation.ts:98](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/components/Animation.ts#L98) |
-| <a id="statemanager"></a> `stateManager` | [`AnimationStateManager`](../../index/classes/AnimationStateManager.md) | Manager that drives state transitions; mutate via [addState](#addstate)/[switchState](#switchstate). | [components/Animation.ts:100](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/components/Animation.ts#L100) |
+| <a id="clips"></a> `clips` | `AnimationClip`[] | Combined ordered list of clips (model + external) currently loaded. | [components/Animation.ts:78](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/components/Animation.ts#L78) |
+| <a id="clipcatalog"></a> `clipCatalog` | `AnimationClipCatalogEntry`[] | Per-clip metadata used by the inspector. | [components/Animation.ts:80](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/components/Animation.ts#L80) |
+| <a id="availableclips"></a> `availableClips` | `string`[] | Display names of clips available for state-machine bindings. | [components/Animation.ts:82](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/components/Animation.ts#L82) |
+| <a id="externalclipsources"></a> `externalClipSources` | `string`[] | URLs/paths of external clip sources (saved with the project). | [components/Animation.ts:84](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/components/Animation.ts#L84) |
+| <a id="paused"></a> `paused` | `boolean` | Whether playback is currently paused. | [components/Animation.ts:86](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/components/Animation.ts#L86) |
+| <a id="reverse"></a> `reverse` | `boolean` | Play the active clip in reverse. | [components/Animation.ts:88](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/components/Animation.ts#L88) |
+| <a id="timescale"></a> `timeScale` | `number` | Playback speed multiplier (`1` = real-time). | [components/Animation.ts:90](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/components/Animation.ts#L90) |
+| <a id="crossfadeduration"></a> `crossFadeDuration` | `number` | Default cross-fade duration in seconds when switching states. | [components/Animation.ts:92](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/components/Animation.ts#L92) |
+| <a id="states"></a> `states` | [`AnimationStateMachine`](../../index/classes/AnimationStateMachine.md)[] | All state-machine entries authored on this entity. | [components/Animation.ts:94](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/components/Animation.ts#L94) |
+| <a id="active"></a> `active` | \| [`AnimationStateMachine`](../../index/classes/AnimationStateMachine.md) \| `null` | State currently being played, or `null` if none. | [components/Animation.ts:96](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/components/Animation.ts#L96) |
+| <a id="activestatename"></a> `activeStateName` | `string` \| `null` | Name of the [active](#active) state, or `null` if none. | [components/Animation.ts:98](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/components/Animation.ts#L98) |
+| <a id="statemanager"></a> `stateManager` | [`AnimationStateManager`](../../index/classes/AnimationStateManager.md) | Manager that drives state transitions; mutate via [addState](#addstate)/[switchState](#switchstate). | [components/Animation.ts:100](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/components/Animation.ts#L100) |
 
 ## Methods
 
@@ -71,7 +71,7 @@ Defined in: [components/Animation.ts:102](https://github.com/Relu-Interactives/r
 setModelClips(clips): void;
 ```
 
-Defined in: [components/Animation.ts:234](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/components/Animation.ts#L234)
+Defined in: [components/Animation.ts:234](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/components/Animation.ts#L234)
 
 #### Parameters
 
@@ -91,7 +91,7 @@ Defined in: [components/Animation.ts:234](https://github.com/Relu-Interactives/r
 setImportedClips(clips): void;
 ```
 
-Defined in: [components/Animation.ts:239](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/components/Animation.ts#L239)
+Defined in: [components/Animation.ts:239](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/components/Animation.ts#L239)
 
 #### Parameters
 
@@ -111,7 +111,7 @@ Defined in: [components/Animation.ts:239](https://github.com/Relu-Interactives/r
 setExternalClipSources(sources): void;
 ```
 
-Defined in: [components/Animation.ts:276](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/components/Animation.ts#L276)
+Defined in: [components/Animation.ts:276](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/components/Animation.ts#L276)
 
 #### Parameters
 
@@ -136,7 +136,7 @@ addState(
   | null;
 ```
 
-Defined in: [components/Animation.ts:301](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/components/Animation.ts#L301)
+Defined in: [components/Animation.ts:301](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/components/Animation.ts#L301)
 
 #### Parameters
 
@@ -159,7 +159,7 @@ Defined in: [components/Animation.ts:301](https://github.com/Relu-Interactives/r
 setStates(states): void;
 ```
 
-Defined in: [components/Animation.ts:316](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/components/Animation.ts#L316)
+Defined in: [components/Animation.ts:316](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/components/Animation.ts#L316)
 
 #### Parameters
 
@@ -184,7 +184,7 @@ getStateConfigs(): {
 }[];
 ```
 
-Defined in: [components/Animation.ts:343](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/components/Animation.ts#L343)
+Defined in: [components/Animation.ts:343](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/components/Animation.ts#L343)
 
 #### Returns
 
@@ -203,7 +203,7 @@ Defined in: [components/Animation.ts:343](https://github.com/Relu-Interactives/r
 setActiveState(name, autoPlay?): boolean;
 ```
 
-Defined in: [components/Animation.ts:352](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/components/Animation.ts#L352)
+Defined in: [components/Animation.ts:352](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/components/Animation.ts#L352)
 
 #### Parameters
 
@@ -224,7 +224,7 @@ Defined in: [components/Animation.ts:352](https://github.com/Relu-Interactives/r
 removeState(name): boolean;
 ```
 
-Defined in: [components/Animation.ts:363](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/components/Animation.ts#L363)
+Defined in: [components/Animation.ts:363](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/components/Animation.ts#L363)
 
 #### Parameters
 
@@ -244,7 +244,7 @@ Defined in: [components/Animation.ts:363](https://github.com/Relu-Interactives/r
 switchState(name, autoPlay?): boolean;
 ```
 
-Defined in: [components/Animation.ts:371](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/components/Animation.ts#L371)
+Defined in: [components/Animation.ts:371](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/components/Animation.ts#L371)
 
 #### Parameters
 
@@ -265,7 +265,7 @@ Defined in: [components/Animation.ts:371](https://github.com/Relu-Interactives/r
 playState(name?): boolean;
 ```
 
-Defined in: [components/Animation.ts:382](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/components/Animation.ts#L382)
+Defined in: [components/Animation.ts:382](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/components/Animation.ts#L382)
 
 #### Parameters
 
@@ -285,7 +285,7 @@ Defined in: [components/Animation.ts:382](https://github.com/Relu-Interactives/r
 pauseState(name?): boolean;
 ```
 
-Defined in: [components/Animation.ts:393](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/components/Animation.ts#L393)
+Defined in: [components/Animation.ts:393](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/components/Animation.ts#L393)
 
 #### Parameters
 
@@ -305,7 +305,7 @@ Defined in: [components/Animation.ts:393](https://github.com/Relu-Interactives/r
 stopState(name?): boolean;
 ```
 
-Defined in: [components/Animation.ts:404](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/d7abe871a8dd71d2e6e1dff3235da21d5376bd8f/core/components/Animation.ts#L404)
+Defined in: [components/Animation.ts:404](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/bdd9282dee928f9a7d192d992833af9bda98772b/core/components/Animation.ts#L404)
 
 #### Parameters