@relu-interactives/spatial-ecs 0.2.24 → 0.3.0

package/dist/docs/api/types/type-aliases/ComponentInput.md

@@ -18,7 +18,7 @@ type ComponentInput<T> = {
 };
 ```
 
-Defined in: [types.ts:109](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/types.ts#L109)
+Defined in: [types.ts:111](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/types.ts#L111)
 
 Inspector field that lets the user drag an entity and optionally pick a
 component from it.
@@ -47,6 +47,6 @@ transform: { type: "component", componentKind: "Transform", value: null } as Com
 
 | Property | Type | Description | Defined in |
 | ------ | ------ | ------ | ------ |
-| <a id="type"></a> `type` | `"component"` | - | [types.ts:110](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/types.ts#L110) |
-| <a id="componentkind"></a> `componentKind?` | [`ComponentKind`](ComponentKind.md) | Optional component-kind constraint. When provided, the inspector skips the dropdown and resolves directly to this kind. | [types.ts:113](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/types.ts#L113) |
-| <a id="value"></a> `value` | \| \{ `entityId`: [`EntityId`](EntityId.md); `componentKind`: [`ComponentKind`](ComponentKind.md); \} \| `null` | - | [types.ts:114](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/types.ts#L114) |
+| <a id="type"></a> `type` | `"component"` | - | [types.ts:112](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/types.ts#L112) |
+| <a id="componentkind"></a> `componentKind?` | [`ComponentKind`](ComponentKind.md) | Optional component-kind constraint. When provided, the inspector skips the dropdown and resolves directly to this kind. | [types.ts:115](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/types.ts#L115) |
+| <a id="value"></a> `value` | \| \{ `entityId`: [`EntityId`](EntityId.md); `componentKind`: [`ComponentKind`](ComponentKind.md); \} \| `null` | - | [types.ts:116](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/types.ts#L116) |

package/dist/docs/api/types/type-aliases/ComponentKind.md

@@ -29,6 +29,7 @@ type ComponentKind =
   | "Physics"
   | "Postprocessing"
   | "Script"
+  | "ScriptObject"
   | "Selectable"
   | "SelectionTransformState"
   | "Sprite"
@@ -36,4 +37,4 @@ type ComponentKind =
   | "Video";
 ```
 
-Defined in: [types.ts:67](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/types.ts#L67)
+Defined in: [types.ts:68](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/types.ts#L68)

package/dist/docs/api/types/type-aliases/DropdownInput.md

@@ -13,11 +13,11 @@ type DropdownInput = {
 };
 ```
 
-Defined in: [types.ts:62](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/types.ts#L62)
+Defined in: [types.ts:63](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/types.ts#L63)
 
 ## Properties
 
 | Property | Type | Defined in |
 | ------ | ------ | ------ |
-| <a id="options"></a> `options` | [`DropdownOption`](DropdownOption.md)[] | [types.ts:62](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/types.ts#L62) |
-| <a id="value"></a> `value` | `string` \| `any` | [types.ts:62](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/types.ts#L62) |
+| <a id="options"></a> `options` | [`DropdownOption`](DropdownOption.md)[] | [types.ts:63](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/types.ts#L63) |
+| <a id="value"></a> `value` | `string` \| `any` | [types.ts:63](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/types.ts#L63) |

package/dist/docs/api/types/type-aliases/DropdownOption.md

@@ -13,11 +13,11 @@ type DropdownOption = {
 };
 ```
 
-Defined in: [types.ts:61](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/types.ts#L61)
+Defined in: [types.ts:62](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/types.ts#L62)
 
 ## Properties
 
 | Property | Type | Defined in |
 | ------ | ------ | ------ |
-| <a id="label"></a> `label` | `string` | [types.ts:61](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/types.ts#L61) |
-| <a id="value"></a> `value` | `string` \| `any` | [types.ts:61](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/types.ts#L61) |
+| <a id="label"></a> `label` | `string` | [types.ts:62](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/types.ts#L62) |
+| <a id="value"></a> `value` | `string` \| `any` | [types.ts:62](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/types.ts#L62) |

package/dist/docs/api/types/type-aliases/EcsEntityEditorKind.md

@@ -10,6 +10,6 @@
 type EcsEntityEditorKind = EcsEntityKind | "editorUtility";
 ```
 
-Defined in: [types.ts:42](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/types.ts#L42)
+Defined in: [types.ts:43](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/types.ts#L43)
 
 [EcsEntityKind](EcsEntityKind.md) extended with editor-only utility entities (gizmos, helpers).

package/dist/docs/api/types/type-aliases/EcsEntityKind.md

@@ -27,10 +27,11 @@ type EcsEntityKind =
   | "spotLight"
   | "areaLight"
   | "instancedMesh"
-  | "instanceSlot";
+  | "instanceSlot"
+  | "scriptObject";
 ```
 
-Defined in: [types.ts:19](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/types.ts#L19)
+Defined in: [types.ts:19](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/types.ts#L19)
 
 Built-in entity kinds recognized by the ECS factory registry. Each kind
 maps to an object factory in `core/factories/objects/*` that creates the

package/dist/docs/api/types/type-aliases/EntityId.md

@@ -10,7 +10,7 @@
 type EntityId = number;
 ```
 
-Defined in: [types.ts:12](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/types.ts#L12)
+Defined in: [types.ts:12](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/types.ts#L12)
 
 Numeric identifier for an entity. Entities are pure ids — all data lives in
 components attached to the entity.

package/dist/docs/api/types/type-aliases/EntityInput.md

@@ -13,11 +13,11 @@ type EntityInput = {
 };
 ```
 
-Defined in: [types.ts:66](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/types.ts#L66)
+Defined in: [types.ts:67](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/types.ts#L67)
 
 ## Properties
 
 | Property | Type | Defined in |
 | ------ | ------ | ------ |
-| <a id="type"></a> `type` | `"entity"` | [types.ts:66](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/types.ts#L66) |
-| <a id="value"></a> `value` | [`EntityId`](EntityId.md) \| `null` | [types.ts:66](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/types.ts#L66) |
+| <a id="type"></a> `type` | `"entity"` | [types.ts:67](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/types.ts#L67) |
+| <a id="value"></a> `value` | [`EntityId`](EntityId.md) \| `null` | [types.ts:67](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/types.ts#L67) |

package/dist/docs/api/types/type-aliases/FloatInput.md

@@ -10,4 +10,4 @@
 type FloatInput = number;
 ```
 
-Defined in: [types.ts:51](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/types.ts#L51)
+Defined in: [types.ts:52](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/types.ts#L52)

package/dist/docs/api/types/type-aliases/IntersectionResult.md

@@ -13,7 +13,7 @@ type IntersectionResult = {
 };
 ```
 
-Defined in: [types.ts:155](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/types.ts#L155)
+Defined in: [types.ts:157](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/types.ts#L157)
 
 Single hit returned by `World.raycast` / `World.raycastFrom`. Pairs the
 standard `THREE.Intersection` (`threeResult`) with the owning entity id
@@ -25,5 +25,5 @@ editor helper).
 
 | Property | Type | Description | Defined in |
 | ------ | ------ | ------ | ------ |
-| <a id="entityid"></a> `entityId` | [`EntityId`](EntityId.md) \| `null` | The entity that owns the hit object, or `null` if untracked. | [types.ts:157](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/types.ts#L157) |
-| <a id="threeresult"></a> `threeResult` | `THREE.Intersection` | The underlying three.js intersection record. | [types.ts:159](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/types.ts#L159) |
+| <a id="entityid"></a> `entityId` | [`EntityId`](EntityId.md) \| `null` | The entity that owns the hit object, or `null` if untracked. | [types.ts:159](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/types.ts#L159) |
+| <a id="threeresult"></a> `threeResult` | `THREE.Intersection` | The underlying three.js intersection record. | [types.ts:161](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/types.ts#L161) |

package/dist/docs/api/types/type-aliases/ParentLookup.md

@@ -13,7 +13,7 @@ type ParentLookup = {
 };
 ```
 
-Defined in: [types.ts:132](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/types.ts#L132)
+Defined in: [types.ts:134](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/types.ts#L134)
 
 Result of a parent lookup. `parent` is `null` for entities at the root or
 for entities without a [ParentId](../../components/classes/ParentId.md) component.
@@ -22,5 +22,5 @@ for entities without a [ParentId](../../components/classes/ParentId.md) componen
 
 | Property | Type | Description | Defined in |
 | ------ | ------ | ------ | ------ |
-| <a id="parentidcomponent"></a> `parentIdComponent` | [`ParentId`](../../components/classes/ParentId.md) \| `null` | The entity's `ParentId` component, or `null` if it has none. | [types.ts:134](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/types.ts#L134) |
-| <a id="parent"></a> `parent` | [`WorldEntityView`](WorldEntityView.md) \| `null` | The resolved parent entity view, or `null` if the entity is at the root. | [types.ts:136](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/types.ts#L136) |
+| <a id="parentidcomponent"></a> `parentIdComponent` | [`ParentId`](../../components/classes/ParentId.md) \| `null` | The entity's `ParentId` component, or `null` if it has none. | [types.ts:136](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/types.ts#L136) |
+| <a id="parent"></a> `parent` | [`WorldEntityView`](WorldEntityView.md) \| `null` | The resolved parent entity view, or `null` if the entity is at the root. | [types.ts:138](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/types.ts#L138) |

package/dist/docs/api/types/type-aliases/SelectionListener.md

@@ -10,7 +10,7 @@
 type SelectionListener = (entityId) => void;
 ```
 
-Defined in: [types.ts:45](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/types.ts#L45)
+Defined in: [types.ts:46](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/types.ts#L46)
 
 Callback invoked when the selected entity changes. `null` indicates a deselection.
 

package/dist/docs/api/types/type-aliases/SliderInput.md

@@ -15,13 +15,13 @@ type SliderInput = {
 };
 ```
 
-Defined in: [types.ts:55](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/types.ts#L55)
+Defined in: [types.ts:56](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/types.ts#L56)
 
 ## Properties
 
 | Property | Type | Defined in |
 | ------ | ------ | ------ |
-| <a id="min"></a> `min` | `number` | [types.ts:56](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/types.ts#L56) |
-| <a id="max"></a> `max` | `number` | [types.ts:57](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/types.ts#L57) |
-| <a id="step"></a> `step` | `number` | [types.ts:58](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/types.ts#L58) |
-| <a id="value"></a> `value` | `number` | [types.ts:59](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/types.ts#L59) |
+| <a id="min"></a> `min` | `number` | [types.ts:57](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/types.ts#L57) |
+| <a id="max"></a> `max` | `number` | [types.ts:58](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/types.ts#L58) |
+| <a id="step"></a> `step` | `number` | [types.ts:59](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/types.ts#L59) |
+| <a id="value"></a> `value` | `number` | [types.ts:60](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/types.ts#L60) |

package/dist/docs/api/types/type-aliases/TextInput.md

@@ -10,4 +10,4 @@
 type TextInput = string;
 ```
 
-Defined in: [types.ts:50](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/types.ts#L50)
+Defined in: [types.ts:51](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/types.ts#L51)

package/dist/docs/api/types/type-aliases/ToggleInput.md

@@ -10,4 +10,4 @@
 type ToggleInput = boolean;
 ```
 
-Defined in: [types.ts:64](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/types.ts#L64)
+Defined in: [types.ts:65](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/types.ts#L65)

package/dist/docs/api/types/type-aliases/Vec3.md

@@ -16,7 +16,7 @@ type Vec3 =
 };
 ```
 
-Defined in: [types.ts:144](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/types.ts#L144)
+Defined in: [types.ts:146](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/types.ts#L146)
 
 Loose 3D vector accepted by raycast and other spatial helpers. Either a
 live `THREE.Vector3` or a plain `{ x, y, z }` object — both are normalized

package/dist/docs/api/types/type-aliases/Vector2Input.md

@@ -13,11 +13,11 @@ type Vector2Input = {
 };
 ```
 
-Defined in: [types.ts:53](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/types.ts#L53)
+Defined in: [types.ts:54](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/types.ts#L54)
 
 ## Properties
 
 | Property | Type | Defined in |
 | ------ | ------ | ------ |
-| <a id="x"></a> `x` | `number` | [types.ts:53](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/types.ts#L53) |
-| <a id="y"></a> `y` | `number` | [types.ts:53](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/types.ts#L53) |
+| <a id="x"></a> `x` | `number` | [types.ts:54](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/types.ts#L54) |
+| <a id="y"></a> `y` | `number` | [types.ts:54](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/types.ts#L54) |

package/dist/docs/api/types/type-aliases/Vector3Input.md

@@ -14,12 +14,12 @@ type Vector3Input = {
 };
 ```
 
-Defined in: [types.ts:54](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/types.ts#L54)
+Defined in: [types.ts:55](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/types.ts#L55)
 
 ## Properties
 
 | Property | Type | Defined in |
 | ------ | ------ | ------ |
-| <a id="x"></a> `x` | `number` | [types.ts:54](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/types.ts#L54) |
-| <a id="y"></a> `y` | `number` | [types.ts:54](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/types.ts#L54) |
-| <a id="z"></a> `z` | `number` | [types.ts:54](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/types.ts#L54) |
+| <a id="x"></a> `x` | `number` | [types.ts:55](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/types.ts#L55) |
+| <a id="y"></a> `y` | `number` | [types.ts:55](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/types.ts#L55) |
+| <a id="z"></a> `z` | `number` | [types.ts:55](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/types.ts#L55) |

package/dist/docs/api/types/type-aliases/WorldEntityView.md

@@ -10,7 +10,7 @@
 type WorldEntityView = NonNullable<ReturnType<World["getEntityById"]>>;
 ```
 
-Defined in: [types.ts:126](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/types.ts#L126)
+Defined in: [types.ts:128](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/types.ts#L128)
 
 Lightweight, read-only view of an entity returned by `World.getEntityById`.
 Contains the entity id and its current component list at the moment of the

package/dist/docs/guide/components/_sidebar.json

@@ -63,6 +63,10 @@
     "text": "Script",
     "link": "/guide/components/script"
   },
+  {
+    "text": "Script Object",
+    "link": "/guide/components/script-object"
+  },
   {
     "text": "Sprite",
     "link": "/guide/components/sprite"

package/dist/docs/guide/components/material.md

@@ -19,6 +19,7 @@ The editor can link a material slot to a **material asset** (a `.material` file
 | `materials` | `THREE.Material[]` | Live three.js materials currently bound to the entity's mesh (one per submesh). |
 | `material` | `THREE.Material \| null` | Convenience reference to `materials[0]`. `null` when no material is assigned. |
 | `values` | `MaterialValueState[]` | Serialized authoring state (one entry per material in `materials`). Saved with the project. |
+| `assetRefs` | `(string \| null)[]` | Editor-managed material-asset linkage, one entry per slot (parallel to `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` and keeps them in sync when the asset is edited — rendering and the runtime read only `values` and ignore this field. Saved with the project; survives material rebinds. |
 
 ## API reference
 

package/dist/docs/guide/components/script-object.md

@@ -0,0 +1,32 @@
+# Script Object
+
+Component for a **script object** — a single `ScriptObject` whose THREE.js visual is built by user code and runs in the editor AND at runtime. Unlike `ScriptComponent` this holds ONE script (not an entries array). The live instance ref is non-enumerable so it never leaks into save data or undo history.
+
+## Editor inspector
+
+::: tip Screenshot
+Add a screenshot of the **Script Object** component in the editor inspector here.
+Suggested asset path: `/public/images/inspector/script-object.png`
+:::
+
+```md
+![Script Object inspector](/images/inspector/script-object.png)
+```
+
+## Properties
+
+| Property | Type | Description |
+| --- | --- | --- |
+| `scriptUrl` | `string \| null` | — |
+| `className` | `string \| null` | — |
+| `enabled` | `boolean` | — |
+| `data` | `Record<string, unknown>` | — |
+| `runtimeState` | `ScriptObjectRuntimeState` | — |
+| `runtimeMessage` | `string` | — |
+| `instance` | `unknown \| null` | Live ScriptObject instance. Non-enumerable — never enters snapshots/history. |
+
+## API reference
+
+- Class: [`ScriptObjectComponent`](../../api/components/classes/ScriptObjectComponent.md)
+- Source: [`core/components/ScriptObjectComponent.ts`](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/main/core/components/ScriptObjectComponent.ts)
+

package/dist/factories/index.cjs

@@ -909,12 +909,21 @@ function normalizePhysicsState(value) {
   };
 }
 __name(normalizePhysicsState, "normalizePhysicsState");
+function setPhysicsLiveRef(component, key, value) {
+  Object.defineProperty(component, key, {
+    value,
+    writable: true,
+    configurable: true,
+    enumerable: false
+  });
+}
+__name(setPhysicsLiveRef, "setPhysicsLiveRef");
 var _PhysicsComponent = class _PhysicsComponent extends Component {
   constructor(values) {
     super();
     this.values = normalizePhysicsState(values);
-    this.rigidBody = null;
-    this.collider = null;
+    setPhysicsLiveRef(this, "rigidBody", null);
+    setPhysicsLiveRef(this, "collider", null);
   }
   /**
    * Patch rigidbody and/or collider state. Each sub-object is deep-merged
@@ -1344,6 +1353,22 @@ function getMaterialType(material) {
   return "standard";
 }
 __name(getMaterialType, "getMaterialType");
+function textureImageSrc(texture) {
+  const src = texture?.image?.src;
+  return typeof src === "string" ? src : void 0;
+}
+__name(textureImageSrc, "textureImageSrc");
+function textureSourceUrl(texture) {
+  if (!texture?.image) {
+    return void 0;
+  }
+  const currentSrc = texture.source?.data?.currentSrc;
+  if (typeof currentSrc === "string" && currentSrc) {
+    return currentSrc;
+  }
+  return textureImageSrc(texture);
+}
+__name(textureSourceUrl, "textureSourceUrl");
 function createMaterialValue(material) {
   const materialRecord = material;
   const normalScale = materialRecord.normalScale;
@@ -1363,17 +1388,33 @@ function createMaterialValue(material) {
     depthWrite: materialRecord.depthWrite !== false,
     wireframe: Boolean(materialRecord.wireframe),
     transparent: Boolean(materialRecord.transparent),
-    textureMap: map?.image ? map.source?.data?.currentSrc || map.image?.src : void 0,
-    alphaTextureMap: materialRecord.alphaMap?.image?.src,
-    normalMap: materialRecord.normalMap?.image?.src,
-    roughnessMap: materialRecord.roughnessMap?.image?.src,
-    metalnessMap: materialRecord.metalnessMap?.image?.src,
-    aoMap: materialRecord.aoMap?.image?.src,
-    emissiveMap: materialRecord.emissiveMap?.image?.src,
-    bumpMap: materialRecord.bumpMap?.image?.src,
-    displacementMap: materialRecord.displacementMap?.image?.src,
-    lightMap: materialRecord.lightMap?.image?.src,
-    envMap: materialRecord.envMap?.image?.src,
+    textureMap: textureSourceUrl(map),
+    alphaTextureMap: textureImageSrc(
+      materialRecord.alphaMap
+    ),
+    normalMap: textureImageSrc(
+      materialRecord.normalMap
+    ),
+    roughnessMap: textureImageSrc(
+      materialRecord.roughnessMap
+    ),
+    metalnessMap: textureImageSrc(
+      materialRecord.metalnessMap
+    ),
+    aoMap: textureImageSrc(materialRecord.aoMap),
+    emissiveMap: textureImageSrc(
+      materialRecord.emissiveMap
+    ),
+    bumpMap: textureImageSrc(
+      materialRecord.bumpMap
+    ),
+    displacementMap: textureImageSrc(
+      materialRecord.displacementMap
+    ),
+    lightMap: textureImageSrc(
+      materialRecord.lightMap
+    ),
+    envMap: textureImageSrc(materialRecord.envMap),
     textureFiltering: map?.magFilter === THREE29__namespace.NearestFilter ? "sharp" : "smooth",
     useMipmaps: map?.generateMipmaps !== false
   };