@relu-interactives/spatial-ecs 0.5.2 → 0.8.0

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

@@ -6,7 +6,7 @@
 
 # Class: InstancedMeshComponent
 
-Defined in: [components/InstancedMesh.ts:64](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/InstancedMesh.ts#L64)
+Defined in: [components/InstancedMesh.ts:64](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/InstancedMesh.ts#L64)
 
 Holds authored instanced-mesh data for an entity that renders as a
 `THREE.InstancedMesh`. Supports primitive geometry kinds (cube, sphere,
@@ -31,7 +31,7 @@ new InstancedMeshComponent(
    options?): InstancedMeshComponent;
 ```
 
-Defined in: [components/InstancedMesh.ts:93](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/InstancedMesh.ts#L93)
+Defined in: [components/InstancedMesh.ts:93](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/InstancedMesh.ts#L93)
 
 #### Parameters
 
@@ -57,13 +57,13 @@ Defined in: [components/InstancedMesh.ts:93](https://github.com/Relu-Interactive
 
 | Property | Type | Description | Defined in |
 | ------ | ------ | ------ | ------ |
-| <a id="meshkind"></a> `meshKind` | [`InstancedMeshKind`](../type-aliases/InstancedMeshKind.md) | Geometry kind for all instances. Use `"model"` for a custom GLTF/GLB asset. | [components/InstancedMesh.ts:66](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/InstancedMesh.ts#L66) |
-| <a id="modelpath"></a> `modelPath` | `string` | Path to the GLTF/GLB asset when `meshKind === "model"`. Serialized in snapshots and restored on hydration. | [components/InstancedMesh.ts:71](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/InstancedMesh.ts#L71) |
-| <a id="meshparameters"></a> `meshParameters` | [`MeshGeometryParameters`](../type-aliases/MeshGeometryParameters.md) | Editable geometry parameters (width/height/depth, radius, etc.). Ignored when `meshKind === "model"`. | [components/InstancedMesh.ts:73](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/InstancedMesh.ts#L73) |
-| <a id="castshadow"></a> `castShadow` | `boolean` | Whether all instances cast shadows. | [components/InstancedMesh.ts:75](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/InstancedMesh.ts#L75) |
-| <a id="receiveshadow"></a> `receiveShadow` | `boolean` | Whether all instances receive shadows. | [components/InstancedMesh.ts:77](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/InstancedMesh.ts#L77) |
-| <a id="instanceentityids"></a> `instanceEntityIds` | `number`[] | Ordered list of entity IDs for the instance slot entities owned by this group. Each slot entity carries a `TransformComponent` that `InstancedMeshSystem` reads every frame to build the per-instance matrix. | [components/InstancedMesh.ts:83](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/InstancedMesh.ts#L83) |
-| <a id="instancedmesh"></a> `instancedMesh` | `Object3D`\<`Object3DEventMap`\> \| `null` | Live runtime container managed by `InstancedMeshSystem`: - For primitive kinds: a `THREE.InstancedMesh`. - For `"model"` kind: a `THREE.Group` containing per-mesh `THREE.InstancedMesh` objects. Excluded from snapshot serialization — do **not** read this in hydration code. | [components/InstancedMesh.ts:91](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/InstancedMesh.ts#L91) |
+| <a id="meshkind"></a> `meshKind` | [`InstancedMeshKind`](../type-aliases/InstancedMeshKind.md) | Geometry kind for all instances. Use `"model"` for a custom GLTF/GLB asset. | [components/InstancedMesh.ts:66](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/InstancedMesh.ts#L66) |
+| <a id="modelpath"></a> `modelPath` | `string` | Path to the GLTF/GLB asset when `meshKind === "model"`. Serialized in snapshots and restored on hydration. | [components/InstancedMesh.ts:71](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/InstancedMesh.ts#L71) |
+| <a id="meshparameters"></a> `meshParameters` | [`MeshGeometryParameters`](../type-aliases/MeshGeometryParameters.md) | Editable geometry parameters (width/height/depth, radius, etc.). Ignored when `meshKind === "model"`. | [components/InstancedMesh.ts:73](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/InstancedMesh.ts#L73) |
+| <a id="castshadow"></a> `castShadow` | `boolean` | Whether all instances cast shadows. | [components/InstancedMesh.ts:75](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/InstancedMesh.ts#L75) |
+| <a id="receiveshadow"></a> `receiveShadow` | `boolean` | Whether all instances receive shadows. | [components/InstancedMesh.ts:77](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/InstancedMesh.ts#L77) |
+| <a id="instanceentityids"></a> `instanceEntityIds` | `number`[] | Ordered list of entity IDs for the instance slot entities owned by this group. Each slot entity carries a `TransformComponent` that `InstancedMeshSystem` reads every frame to build the per-instance matrix. | [components/InstancedMesh.ts:83](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/InstancedMesh.ts#L83) |
+| <a id="instancedmesh"></a> `instancedMesh` | `Object3D`\<`Object3DEventMap`\> \| `null` | Live runtime container managed by `InstancedMeshSystem`: - For primitive kinds: a `THREE.InstancedMesh`. - For `"model"` kind: a `THREE.Group` containing per-mesh `THREE.InstancedMesh` objects. Excluded from snapshot serialization — do **not** read this in hydration code. | [components/InstancedMesh.ts:91](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/InstancedMesh.ts#L91) |
 
 ## Methods
 
@@ -73,7 +73,7 @@ Defined in: [components/InstancedMesh.ts:93](https://github.com/Relu-Interactive
 getSanitizedParameters(): MeshGeometryParameters;
 ```
 
-Defined in: [components/InstancedMesh.ts:117](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/InstancedMesh.ts#L117)
+Defined in: [components/InstancedMesh.ts:117](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/InstancedMesh.ts#L117)
 
 Sanitize and return a copy of the current mesh parameters with valid values.
 

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

@@ -6,7 +6,7 @@
 
 # Class: LightComponent
 
-Defined in: [components/Light.ts:65](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/Light.ts#L65)
+Defined in: [components/Light.ts:94](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Light.ts#L94)
 
 Light source attached to an entity. `type` selects the underlying three.js
 light class (directional, point, spot, ambient, hemisphere, rect-area).
@@ -25,7 +25,7 @@ type-specific fields (distance, decay, angle, penumbra, width, height).
 new LightComponent(light): LightComponent;
 ```
 
-Defined in: [components/Light.ts:73](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/Light.ts#L73)
+Defined in: [components/Light.ts:102](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Light.ts#L102)
 
 #### Parameters
 
@@ -45,9 +45,9 @@ Defined in: [components/Light.ts:73](https://github.com/Relu-Interactives/relu-s
 
 | Property | Type | Description | Defined in |
 | ------ | ------ | ------ | ------ |
-| <a id="light"></a> `light` | `Light` | Live three.js light placed in the scene. Recreated when the project loads. | [components/Light.ts:67](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/Light.ts#L67) |
-| <a id="type"></a> `type` | `string` | Three.js class name of the light (e.g. `"DirectionalLight"`, `"PointLight"`, `"SpotLight"`). | [components/Light.ts:69](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/Light.ts#L69) |
-| <a id="values"></a> `values` | [`LightValueState`](../type-aliases/LightValueState.md) | Serialized authoring state. Saved with the project. | [components/Light.ts:71](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/Light.ts#L71) |
+| <a id="light"></a> `light` | `Light` | Live three.js light placed in the scene. Recreated when the project loads. | [components/Light.ts:96](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Light.ts#L96) |
+| <a id="type"></a> `type` | `string` | Three.js class name of the light (e.g. `"DirectionalLight"`, `"PointLight"`, `"SpotLight"`). | [components/Light.ts:98](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Light.ts#L98) |
+| <a id="values"></a> `values` | [`LightValueState`](../type-aliases/LightValueState.md) | Serialized authoring state. Saved with the project. | [components/Light.ts:100](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Light.ts#L100) |
 
 ## Methods
 
@@ -57,7 +57,7 @@ Defined in: [components/Light.ts:73](https://github.com/Relu-Interactives/relu-s
 setValues(patch): void;
 ```
 
-Defined in: [components/Light.ts:80](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/Light.ts#L80)
+Defined in: [components/Light.ts:109](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Light.ts#L109)
 
 #### Parameters
 

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

@@ -6,7 +6,7 @@
 
 # Class: MaterialComponent
 
-Defined in: [components/Material.ts:190](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/Material.ts#L190)
+Defined in: [components/Material.ts:237](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Material.ts#L237)
 
 Material catalog for an entity. Tracks the live three.js materials
 (`materials`, `material`) plus serialized authoring state (`values[]`)
@@ -32,13 +32,13 @@ inside the editor.
 new MaterialComponent(materialOrMaterials?): MaterialComponent;
 ```
 
-Defined in: [components/Material.ts:207](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/Material.ts#L207)
+Defined in: [components/Material.ts:254](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Material.ts#L254)
 
 #### Parameters
 
 | Parameter | Type | Default value |
 | ------ | ------ | ------ |
-| `materialOrMaterials` | `Material` \| `Material`[] | `[]` |
+| `materialOrMaterials` | `Material`\<`MaterialEventMap`\> \| `Material`\<`MaterialEventMap`\>[] | `[]` |
 
 #### Returns
 
@@ -52,10 +52,10 @@ Defined in: [components/Material.ts:207](https://github.com/Relu-Interactives/re
 
 | Property | Type | Description | Defined in |
 | ------ | ------ | ------ | ------ |
-| <a id="materials"></a> `materials` | `Material`[] | Live three.js materials currently bound to the entity's mesh (one per submesh). | [components/Material.ts:192](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/Material.ts#L192) |
-| <a id="material"></a> `material` | `Material` \| `null` | Convenience reference to `materials[0]`. `null` when no material is assigned. | [components/Material.ts:194](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/Material.ts#L194) |
-| <a id="values"></a> `values` | [`MaterialValueState`](../type-aliases/MaterialValueState.md)[] | Serialized authoring state (one entry per material in [materials](#materials)). Saved with the project. | [components/Material.ts:196](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/Material.ts#L196) |
-| <a id="assetrefs"></a> `assetRefs` | (`string` \| `null`)[] | Editor-managed material-asset linkage, one entry per slot (parallel to [values](#values)). A `localasset://` URL of a `.material` asset file, or `null`/absent for a local (unlinked) material. The editor materializes the asset's values into [values](#values) and keeps them in sync when the asset is edited — rendering and the runtime read only [values](#values) and ignore this field. Saved with the project; survives material rebinds. | [components/Material.ts:205](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/Material.ts#L205) |
+| <a id="materials"></a> `materials` | `Material`\<`MaterialEventMap`\>[] | Live three.js materials currently bound to the entity's mesh (one per submesh). | [components/Material.ts:239](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Material.ts#L239) |
+| <a id="material"></a> `material` | `Material`\<`MaterialEventMap`\> \| `null` | Convenience reference to `materials[0]`. `null` when no material is assigned. | [components/Material.ts:241](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Material.ts#L241) |
+| <a id="values"></a> `values` | [`MaterialValueState`](../type-aliases/MaterialValueState.md)[] | Serialized authoring state (one entry per material in [materials](#materials)). Saved with the project. | [components/Material.ts:243](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Material.ts#L243) |
+| <a id="assetrefs"></a> `assetRefs` | (`string` \| `null`)[] | Editor-managed material-asset linkage, one entry per slot (parallel to [values](#values)). A `localasset://` URL of a `.material` asset file, or `null`/absent for a local (unlinked) material. The editor materializes the asset's values into [values](#values) and keeps them in sync when the asset is edited — rendering and the runtime read only [values](#values) and ignore this field. Saved with the project; survives material rebinds. | [components/Material.ts:252](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Material.ts#L252) |
 
 ## Methods
 
@@ -65,7 +65,7 @@ Defined in: [components/Material.ts:207](https://github.com/Relu-Interactives/re
 setAssetRef(index, url): void;
 ```
 
-Defined in: [components/Material.ts:218](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/Material.ts#L218)
+Defined in: [components/Material.ts:265](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Material.ts#L265)
 
 Link/unlink a slot to a material asset URL (editor bookkeeping only).
 
@@ -88,7 +88,7 @@ Link/unlink a slot to a material asset URL (editor bookkeeping only).
 getAssetRef(index): string | null;
 ```
 
-Defined in: [components/Material.ts:229](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/Material.ts#L229)
+Defined in: [components/Material.ts:276](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Material.ts#L276)
 
 The material-asset URL a slot is linked to, or null when local.
 
@@ -110,13 +110,13 @@ The material-asset URL a slot is linked to, or null when local.
 setMaterials(materialOrMaterials?): void;
 ```
 
-Defined in: [components/Material.ts:233](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/Material.ts#L233)
+Defined in: [components/Material.ts:280](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Material.ts#L280)
 
 #### Parameters
 
 | Parameter | Type | Default value |
 | ------ | ------ | ------ |
-| `materialOrMaterials` | `Material` \| `Material`[] | `[]` |
+| `materialOrMaterials` | `Material`\<`MaterialEventMap`\> \| `Material`\<`MaterialEventMap`\>[] | `[]` |
 
 #### Returns
 
@@ -130,7 +130,7 @@ Defined in: [components/Material.ts:233](https://github.com/Relu-Interactives/re
 updateValue(index, patch): void;
 ```
 
-Defined in: [components/Material.ts:249](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/Material.ts#L249)
+Defined in: [components/Material.ts:296](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Material.ts#L296)
 
 #### Parameters
 
@@ -151,7 +151,7 @@ Defined in: [components/Material.ts:249](https://github.com/Relu-Interactives/re
 resetValue(index): void;
 ```
 
-Defined in: [components/Material.ts:264](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/Material.ts#L264)
+Defined in: [components/Material.ts:311](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Material.ts#L311)
 
 #### Parameters
 
@@ -171,7 +171,7 @@ Defined in: [components/Material.ts:264](https://github.com/Relu-Interactives/re
 setMaterialType(index, type): void;
 ```
 
-Defined in: [components/Material.ts:280](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/Material.ts#L280)
+Defined in: [components/Material.ts:327](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Material.ts#L327)
 
 #### Parameters
 
@@ -192,7 +192,7 @@ Defined in: [components/Material.ts:280](https://github.com/Relu-Interactives/re
 setTextureFiltering(index, filtering): void;
 ```
 
-Defined in: [components/Material.ts:284](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/Material.ts#L284)
+Defined in: [components/Material.ts:331](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Material.ts#L331)
 
 #### Parameters
 
@@ -213,7 +213,7 @@ Defined in: [components/Material.ts:284](https://github.com/Relu-Interactives/re
 setUseMipmaps(index, enabled): void;
 ```
 
-Defined in: [components/Material.ts:288](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/Material.ts#L288)
+Defined in: [components/Material.ts:335](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Material.ts#L335)
 
 #### Parameters
 

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

@@ -6,7 +6,7 @@
 
 # Class: MeshComponent
 
-Defined in: [components/Mesh.ts:13](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/Mesh.ts#L13)
+Defined in: [components/Mesh.ts:13](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Mesh.ts#L13)
 
 Holds the live three.js `Object3D` for an entity that renders as a primitive
 mesh (cube, sphere, plane, capsule, cylinder). For loaded GLTF/GLB models
@@ -25,7 +25,7 @@ see [ModelComponent](ModelComponent.md); for the editable geometry parameters se
 new MeshComponent(mesh): MeshComponent;
 ```
 
-Defined in: [components/Mesh.ts:17](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/Mesh.ts#L17)
+Defined in: [components/Mesh.ts:17](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Mesh.ts#L17)
 
 #### Parameters
 
@@ -45,4 +45,4 @@ Defined in: [components/Mesh.ts:17](https://github.com/Relu-Interactives/relu-sp
 
 | Property | Type | Description | Defined in |
 | ------ | ------ | ------ | ------ |
-| <a id="mesh"></a> `mesh` | `Object3D` | Underlying three.js mesh placed in the scene graph. | [components/Mesh.ts:15](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/Mesh.ts#L15) |
+| <a id="mesh"></a> `mesh` | `Object3D` | Underlying three.js mesh placed in the scene graph. | [components/Mesh.ts:15](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Mesh.ts#L15) |

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

@@ -6,7 +6,7 @@
 
 # Class: MeshGeometryComponent
 
-Defined in: [components/MeshGeometry.ts:88](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/MeshGeometry.ts#L88)
+Defined in: [components/MeshGeometry.ts:88](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/MeshGeometry.ts#L88)
 
 Editable geometry parameters for primitive meshes (cube, sphere, plane,
 capsule, cylinder) and the placeholder for `model` entities. Holds the
@@ -29,7 +29,7 @@ new MeshGeometryComponent(
    options?): MeshGeometryComponent;
 ```
 
-Defined in: [components/MeshGeometry.ts:104](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/MeshGeometry.ts#L104)
+Defined in: [components/MeshGeometry.ts:104](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/MeshGeometry.ts#L104)
 
 #### Parameters
 
@@ -55,10 +55,10 @@ Defined in: [components/MeshGeometry.ts:104](https://github.com/Relu-Interactive
 
 | Property | Modifier | Type | Description | Defined in |
 | ------ | ------ | ------ | ------ | ------ |
-| <a id="kind"></a> `kind` | `readonly` | [`EditableMeshObjectKind`](../type-aliases/EditableMeshObjectKind.md) | Primitive kind (`cube`, `sphere`, `plane`, `capsule`, `cylinder`) or `model` for loaded assets. | [components/MeshGeometry.ts:90](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/MeshGeometry.ts#L90) |
-| <a id="geometrytype"></a> `geometryType` | `readonly` | `string` | Three.js geometry class name (e.g. `"BoxGeometry"`, `"SphereGeometry"`). Derived from [kind](#kind). | [components/MeshGeometry.ts:92](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/MeshGeometry.ts#L92) |
-| <a id="parameters"></a> `parameters` | `public` | [`MeshGeometryParameters`](../type-aliases/MeshGeometryParameters.md) | Editable parameters whose shape depends on [kind](#kind). The mesh-geometry system rebuilds geometry when these change. | [components/MeshGeometry.ts:94](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/MeshGeometry.ts#L94) |
-| <a id="object"></a> `object` | `public` | `Object3D`\<`Object3DEventMap`\> \| `null` | Live three.js object whose geometry is being managed. `null` until the object is built. | [components/MeshGeometry.ts:96](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/MeshGeometry.ts#L96) |
-| <a id="modelname"></a> `modelName` | `public` | `string` | Human-readable model name shown in the inspector for `model` entities; empty for primitives. | [components/MeshGeometry.ts:98](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/MeshGeometry.ts#L98) |
-| <a id="castshadow"></a> `castShadow` | `public` | `boolean` | Whether the mesh casts shadows in the renderer. | [components/MeshGeometry.ts:100](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/MeshGeometry.ts#L100) |
-| <a id="receiveshadow"></a> `receiveShadow` | `public` | `boolean` | Whether the mesh receives shadows in the renderer. | [components/MeshGeometry.ts:102](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/MeshGeometry.ts#L102) |
+| <a id="kind"></a> `kind` | `readonly` | [`EditableMeshObjectKind`](../type-aliases/EditableMeshObjectKind.md) | Primitive kind (`cube`, `sphere`, `plane`, `capsule`, `cylinder`) or `model` for loaded assets. | [components/MeshGeometry.ts:90](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/MeshGeometry.ts#L90) |
+| <a id="geometrytype"></a> `geometryType` | `readonly` | `string` | Three.js geometry class name (e.g. `"BoxGeometry"`, `"SphereGeometry"`). Derived from [kind](#kind). | [components/MeshGeometry.ts:92](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/MeshGeometry.ts#L92) |
+| <a id="parameters"></a> `parameters` | `public` | [`MeshGeometryParameters`](../type-aliases/MeshGeometryParameters.md) | Editable parameters whose shape depends on [kind](#kind). The mesh-geometry system rebuilds geometry when these change. | [components/MeshGeometry.ts:94](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/MeshGeometry.ts#L94) |
+| <a id="object"></a> `object` | `public` | `Object3D`\<`Object3DEventMap`\> \| `null` | Live three.js object whose geometry is being managed. `null` until the object is built. | [components/MeshGeometry.ts:96](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/MeshGeometry.ts#L96) |
+| <a id="modelname"></a> `modelName` | `public` | `string` | Human-readable model name shown in the inspector for `model` entities; empty for primitives. | [components/MeshGeometry.ts:98](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/MeshGeometry.ts#L98) |
+| <a id="castshadow"></a> `castShadow` | `public` | `boolean` | Whether the mesh casts shadows in the renderer. | [components/MeshGeometry.ts:100](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/MeshGeometry.ts#L100) |
+| <a id="receiveshadow"></a> `receiveShadow` | `public` | `boolean` | Whether the mesh receives shadows in the renderer. | [components/MeshGeometry.ts:102](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/MeshGeometry.ts#L102) |

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

@@ -6,12 +6,13 @@
 
 # Class: ModelComponent
 
-Defined in: [components/Model.ts:13](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/Model.ts#L13)
+Defined in: [components/Model.ts:45](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Model.ts#L45)
 
 References a GLTF/GLB asset loaded from `path`. The model loading system
 resolves the asset asynchronously and populates [ModelComponent.object](#object)
 once available; loading is deferred-tolerant so the entity exists before
-the model finishes loading.
+the model finishes loading. [ModelComponent.loadState](#loadstate) reports
+progress (`"loading"` → `"loaded"` or `"error"`).
 
 ## Extends
 
@@ -25,7 +26,7 @@ the model finishes loading.
 new ModelComponent(path): ModelComponent;
 ```
 
-Defined in: [components/Model.ts:19](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/Model.ts#L19)
+Defined in: [components/Model.ts:60](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Model.ts#L60)
 
 #### Parameters
 
@@ -45,5 +46,7 @@ Defined in: [components/Model.ts:19](https://github.com/Relu-Interactives/relu-s
 
 | Property | Type | Description | Defined in |
 | ------ | ------ | ------ | ------ |
-| <a id="path"></a> `path` | `string` | Source URL or `localasset://` path of the GLTF/GLB asset. | [components/Model.ts:15](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/Model.ts#L15) |
-| <a id="object"></a> `object` | `Object3D`\<`Object3DEventMap`\> \| `null` | Loaded model object, populated asynchronously by the model loader. `null` until loaded. | [components/Model.ts:17](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/Model.ts#L17) |
+| <a id="path"></a> `path` | `string` | Source URL or `localasset://` path of the GLTF/GLB asset. | [components/Model.ts:47](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Model.ts#L47) |
+| <a id="object"></a> `object` | `Object3D`\<`Object3DEventMap`\> \| `null` | Loaded model object, populated asynchronously by the model loader. `null` until loaded. | [components/Model.ts:49](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Model.ts#L49) |
+| <a id="loadstate"></a> `loadState` | [`ModelLoadState`](../type-aliases/ModelLoadState.md) | `"loading"` while the asset is being fetched and parsed, `"loaded"` once it is attached to the entity, `"error"` when it failed (see [loadError](#loaderror)). A model with an empty `path` reports `"error"`. Runtime-only: never saved. | [components/Model.ts:56](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Model.ts#L56) |
+| <a id="loaderror"></a> `loadError?` | `string` | Why the load failed, when [loadState](#loadstate) is `"error"`. Runtime-only. | [components/Model.ts:58](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Model.ts#L58) |

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

@@ -6,7 +6,7 @@
 
 # Class: Name
 
-Defined in: [components/Name.ts:9](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/Name.ts#L9)
+Defined in: [components/Name.ts:9](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Name.ts#L9)
 
 Human-readable name for an entity. Shown in the editor hierarchy panel and
 preserved across save/reload.
@@ -23,7 +23,7 @@ preserved across save/reload.
 new Name(value): Name;
 ```
 
-Defined in: [components/Name.ts:13](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/Name.ts#L13)
+Defined in: [components/Name.ts:13](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Name.ts#L13)
 
 #### Parameters
 
@@ -43,4 +43,4 @@ Defined in: [components/Name.ts:13](https://github.com/Relu-Interactives/relu-sp
 
 | Property | Type | Description | Defined in |
 | ------ | ------ | ------ | ------ |
-| <a id="value"></a> `value` | `string` | Display name for the entity. Shown in the editor hierarchy. | [components/Name.ts:11](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/Name.ts#L11) |
+| <a id="value"></a> `value` | `string` | Display name for the entity. Shown in the editor hierarchy. | [components/Name.ts:11](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Name.ts#L11) |

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

@@ -6,7 +6,7 @@
 
 # Class: Object3DRef
 
-Defined in: [components/Object3DRef.ts:16](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/Object3DRef.ts#L16)
+Defined in: [components/Object3DRef.ts:16](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Object3DRef.ts#L16)
 
 Wraps the live `THREE.Object3D` for an entity. Almost every entity that
 renders to the scene carries an `Object3DRef` so transform sync, selection,
@@ -29,7 +29,7 @@ fresh inside system/script hooks rather than caching it across frames.
 new Object3DRef(object, visibility?): Object3DRef;
 ```
 
-Defined in: [components/Object3DRef.ts:22](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/Object3DRef.ts#L22)
+Defined in: [components/Object3DRef.ts:22](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Object3DRef.ts#L22)
 
 #### Parameters
 
@@ -50,5 +50,5 @@ Defined in: [components/Object3DRef.ts:22](https://github.com/Relu-Interactives/
 
 | Property | Type | Description | Defined in |
 | ------ | ------ | ------ | ------ |
-| <a id="object"></a> `object` | `Object3D` | Live three.js object placed in the scene graph. May be replaced when assets finish loading. | [components/Object3DRef.ts:18](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/Object3DRef.ts#L18) |
-| <a id="visibility"></a> `visibility` | `boolean` | Whether the object is currently visible. Mirrors `object.visible` and is preserved across reloads. | [components/Object3DRef.ts:20](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/Object3DRef.ts#L20) |
+| <a id="object"></a> `object` | `Object3D` | Live three.js object placed in the scene graph. May be replaced when assets finish loading. | [components/Object3DRef.ts:18](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Object3DRef.ts#L18) |
+| <a id="visibility"></a> `visibility` | `boolean` | Whether the object is currently visible. Mirrors `object.visible` and is preserved across reloads. | [components/Object3DRef.ts:20](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Object3DRef.ts#L20) |

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

@@ -6,7 +6,7 @@
 
 # Class: ParentId
 
-Defined in: [components/ParentId.ts:11](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/ParentId.ts#L11)
+Defined in: [components/ParentId.ts:11](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/ParentId.ts#L11)
 
 Records the parent entity id for hierarchical scene graphs. `null` means
 the entity is at the world root. The `ObjectManagementSystem` reconciles
@@ -24,7 +24,7 @@ scene-graph parenting from this component each frame.
 new ParentId(value?): ParentId;
 ```
 
-Defined in: [components/ParentId.ts:15](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/ParentId.ts#L15)
+Defined in: [components/ParentId.ts:15](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/ParentId.ts#L15)
 
 #### Parameters
 
@@ -44,4 +44,4 @@ Defined in: [components/ParentId.ts:15](https://github.com/Relu-Interactives/rel
 
 | Property | Type | Description | Defined in |
 | ------ | ------ | ------ | ------ |
-| <a id="value"></a> `value` | `number` \| `null` | Parent entity id, or `null` for root-level entities. | [components/ParentId.ts:13](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/ParentId.ts#L13) |
+| <a id="value"></a> `value` | `number` \| `null` | Parent entity id, or `null` for root-level entities. | [components/ParentId.ts:13](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/ParentId.ts#L13) |

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

@@ -6,7 +6,7 @@
 
 # Class: PhysicsComponent
 
-Defined in: [components/Physics.ts:370](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/Physics.ts#L370)
+Defined in: [components/Physics.ts:387](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Physics.ts#L387)
 
 Marker base class for every ECS component. Subclass `Component` to declare
 a typed data container that systems can query.
@@ -29,7 +29,7 @@ asset URLs).
 new PhysicsComponent(values?): PhysicsComponent;
 ```
 
-Defined in: [components/Physics.ts:382](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/Physics.ts#L382)
+Defined in: [components/Physics.ts:405](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Physics.ts#L405)
 
 #### Parameters
 
@@ -51,9 +51,10 @@ Defined in: [components/Physics.ts:382](https://github.com/Relu-Interactives/rel
 
 | Property | Type | Description | Defined in |
 | ------ | ------ | ------ | ------ |
-| <a id="values"></a> `values` | [`PhysicsState`](../type-aliases/PhysicsState.md) | Authoring state. Saved with the project. | [components/Physics.ts:372](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/Physics.ts#L372) |
-| <a id="rigidbody"></a> `rigidBody` | `RigidBody` \| `null` | Live Rapier rigid body. `null` until physics is initialized. NON-ENUMERABLE — Rapier wrappers (and, for trimesh, their vertex buffers) must never leak into snapshots/history/debug walks. | [components/Physics.ts:378](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/Physics.ts#L378) |
-| <a id="collider"></a> `collider` | `Collider` \| `null` | Live Rapier collider. `null` until physics is initialized. NON-ENUMERABLE. | [components/Physics.ts:380](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/Physics.ts#L380) |
+| <a id="values"></a> `values` | [`PhysicsState`](../type-aliases/PhysicsState.md) | Authoring state. Saved with the project. | [components/Physics.ts:389](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Physics.ts#L389) |
+| <a id="pendingvelocity"></a> `pendingVelocity?` | `PendingBodyVelocity` \| `null` | Velocity to apply the moment this body becomes dynamic again. Non-enumerable, like the Rapier refs — never serialized. | [components/Physics.ts:395](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Physics.ts#L395) |
+| <a id="rigidbody"></a> `rigidBody` | `RigidBody` \| `null` | Live Rapier rigid body. `null` until physics is initialized. NON-ENUMERABLE — Rapier wrappers (and, for trimesh, their vertex buffers) must never leak into snapshots/history/debug walks. | [components/Physics.ts:401](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Physics.ts#L401) |
+| <a id="collider"></a> `collider` | `Collider` \| `null` | Live Rapier collider. `null` until physics is initialized. NON-ENUMERABLE. | [components/Physics.ts:403](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Physics.ts#L403) |
 
 ## Methods
 
@@ -63,7 +64,7 @@ Defined in: [components/Physics.ts:382](https://github.com/Relu-Interactives/rel
 setValues(patch): void;
 ```
 
-Defined in: [components/Physics.ts:393](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/Physics.ts#L393)
+Defined in: [components/Physics.ts:416](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Physics.ts#L416)
 
 Patch rigidbody and/or collider state. Each sub-object is deep-merged
 with the current values via the respective normalizer.

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

@@ -6,7 +6,7 @@
 
 # Class: Postprocessing
 
-Defined in: [components/Postprocessing.ts:431](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/Postprocessing.ts#L431)
+Defined in: [components/Postprocessing.ts:431](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Postprocessing.ts#L431)
 
 Postprocessing stack settings (depth-of-field, bloom, vignette, chromatic
 aberration, noise, pixelation, tone mapping, hue/saturation, sepia, SMAA,
@@ -30,7 +30,7 @@ style — attached to one entity per scene.
 new Postprocessing(values?): Postprocessing;
 ```
 
-Defined in: [components/Postprocessing.ts:435](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/Postprocessing.ts#L435)
+Defined in: [components/Postprocessing.ts:435](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Postprocessing.ts#L435)
 
 #### Parameters
 
@@ -50,4 +50,4 @@ Defined in: [components/Postprocessing.ts:435](https://github.com/Relu-Interacti
 
 | Property | Type | Description | Defined in |
 | ------ | ------ | ------ | ------ |
-| <a id="values"></a> `values` | [`PostprocessingState`](../type-aliases/PostprocessingState.md) | Aggregated post-processing state. Saved with the project. | [components/Postprocessing.ts:433](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/Postprocessing.ts#L433) |
+| <a id="values"></a> `values` | [`PostprocessingState`](../type-aliases/PostprocessingState.md) | Aggregated post-processing state. Saved with the project. | [components/Postprocessing.ts:433](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/Postprocessing.ts#L433) |

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

@@ -6,7 +6,7 @@
 
 # Class: PrefabInstance
 
-Defined in: [components/PrefabInstance.ts:45](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/PrefabInstance.ts#L45)
+Defined in: [components/PrefabInstance.ts:45](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/PrefabInstance.ts#L45)
 
 Marks the ROOT entity of a prefab instance and records its link to the
 source `.prefab` asset plus the instance's per-property overrides.
@@ -53,7 +53,7 @@ new PrefabInstance(
    instanceId?): PrefabInstance;
 ```
 
-Defined in: [components/PrefabInstance.ts:57](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/PrefabInstance.ts#L57)
+Defined in: [components/PrefabInstance.ts:57](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/PrefabInstance.ts#L57)
 
 #### Parameters
 
@@ -75,6 +75,6 @@ Defined in: [components/PrefabInstance.ts:57](https://github.com/Relu-Interactiv
 
 | Property | Type | Description | Defined in |
 | ------ | ------ | ------ | ------ |
-| <a id="url"></a> `url` | `string` | URL of the source `.prefab` asset (`localasset://…` inside the editor). | [components/PrefabInstance.ts:47](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/PrefabInstance.ts#L47) |
-| <a id="overrides"></a> `overrides` | `string`[] | Encoded override paths — see class docs for the format. | [components/PrefabInstance.ts:49](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/PrefabInstance.ts#L49) |
-| <a id="instanceid"></a> `instanceId` | `string` | Per-placement uuid scoping node identity across nesting. Stable for the lifetime of the placement (persisted; survives applies) so override keys referencing nested content stay valid. | [components/PrefabInstance.ts:55](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/PrefabInstance.ts#L55) |
+| <a id="url"></a> `url` | `string` | URL of the source `.prefab` asset (`localasset://…` inside the editor). | [components/PrefabInstance.ts:47](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/PrefabInstance.ts#L47) |
+| <a id="overrides"></a> `overrides` | `string`[] | Encoded override paths — see class docs for the format. | [components/PrefabInstance.ts:49](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/PrefabInstance.ts#L49) |
+| <a id="instanceid"></a> `instanceId` | `string` | Per-placement uuid scoping node identity across nesting. Stable for the lifetime of the placement (persisted; survives applies) so override keys referencing nested content stay valid. | [components/PrefabInstance.ts:55](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/PrefabInstance.ts#L55) |

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

@@ -6,7 +6,7 @@
 
 # Class: PrefabNode
 
-Defined in: [components/PrefabNode.ts:17](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/PrefabNode.ts#L17)
+Defined in: [components/PrefabNode.ts:17](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/PrefabNode.ts#L17)
 
 Stable identity for an entity that originated from a prefab asset.
 
@@ -31,7 +31,7 @@ prefab intentionally share nodeIds.
 new PrefabNode(nodeId): PrefabNode;
 ```
 
-Defined in: [components/PrefabNode.ts:21](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/PrefabNode.ts#L21)
+Defined in: [components/PrefabNode.ts:21](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/PrefabNode.ts#L21)
 
 #### Parameters
 
@@ -51,4 +51,4 @@ Defined in: [components/PrefabNode.ts:21](https://github.com/Relu-Interactives/r
 
 | Property | Type | Description | Defined in |
 | ------ | ------ | ------ | ------ |
-| <a id="nodeid"></a> `nodeId` | `string` | Stable uuid identifying this entity within its prefab definition. | [components/PrefabNode.ts:19](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/PrefabNode.ts#L19) |
+| <a id="nodeid"></a> `nodeId` | `string` | Stable uuid identifying this entity within its prefab definition. | [components/PrefabNode.ts:19](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/PrefabNode.ts#L19) |

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

@@ -6,7 +6,7 @@
 
 # Class: ScriptComponent
 
-Defined in: [components/ScriptComponent.ts:35](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/ScriptComponent.ts#L35)
+Defined in: [components/ScriptComponent.ts:35](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/ScriptComponent.ts#L35)
 
 Component holding the list of [scripts](../type-aliases/ScriptEntry.md) attached to an
 entity. Loaded from the saved project; the runtime-side fields
@@ -29,7 +29,7 @@ Authored scripts subclass [Behaviour](../../Behaviour/index.md).
 new ScriptComponent(entries?): ScriptComponent;
 ```
 
-Defined in: [components/ScriptComponent.ts:43](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/ScriptComponent.ts#L43)
+Defined in: [components/ScriptComponent.ts:43](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/ScriptComponent.ts#L43)
 
 #### Parameters
 
@@ -49,6 +49,6 @@ Defined in: [components/ScriptComponent.ts:43](https://github.com/Relu-Interacti
 
 | Property | Type | Description | Defined in |
 | ------ | ------ | ------ | ------ |
-| <a id="entries"></a> `entries` | [`ScriptEntry`](../type-aliases/ScriptEntry.md)[] | Authored script entries attached to the entity. Each entry references a class by name plus its inspector field overrides. Saved with the project. | [components/ScriptComponent.ts:37](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/ScriptComponent.ts#L37) |
-| <a id="scriptinstance"></a> `scriptInstance` | `unknown` | First live behaviour instance after compile/load. Non-enumerable, so it does not appear in save data. `null` when no script is loaded. | [components/ScriptComponent.ts:39](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/ScriptComponent.ts#L39) |
-| <a id="scriptinstances"></a> `scriptInstances` | `Map`\<`number`, `unknown`\> | Map of `entityId` to its compiled behaviour instance (one entry per script bound to the entity). Non-enumerable, so it does not appear in save data. | [components/ScriptComponent.ts:41](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/components/ScriptComponent.ts#L41) |
+| <a id="entries"></a> `entries` | [`ScriptEntry`](../type-aliases/ScriptEntry.md)[] | Authored script entries attached to the entity. Each entry references a class by name plus its inspector field overrides. Saved with the project. | [components/ScriptComponent.ts:37](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/ScriptComponent.ts#L37) |
+| <a id="scriptinstance"></a> `scriptInstance` | `unknown` | First live behaviour instance after compile/load. Non-enumerable, so it does not appear in save data. `null` when no script is loaded. | [components/ScriptComponent.ts:39](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/ScriptComponent.ts#L39) |
+| <a id="scriptinstances"></a> `scriptInstances` | `Map`\<`number`, `unknown`\> | Map of `entityId` to its compiled behaviour instance (one entry per script bound to the entity). Non-enumerable, so it does not appear in save data. | [components/ScriptComponent.ts:41](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/components/ScriptComponent.ts#L41) |