@relu-interactives/spatial-ecs 0.5.2 → 0.8.0

package/dist/docs/api/index/classes/World.md

@@ -6,7 +6,7 @@
 
 # Class: World
 
-Defined in: [World.ts:66](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L66)
+Defined in: [World.ts:88](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L88)
 
 ## Constructors
 
@@ -16,17 +16,18 @@ Defined in: [World.ts:66](https://github.com/Relu-Interactives/relu-spatial-ecs-
 new World(options): World;
 ```
 
-Defined in: [World.ts:97](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L97)
+Defined in: [World.ts:133](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L133)
 
 #### Parameters
 
-| Parameter | Type |
-| ------ | ------ |
-| `options` | \{ `scene`: `Scene`; `camera`: `PerspectiveCamera`; `renderer`: `WebGLRenderer`; `featureFlags?`: `WorldFeatureFlags`; \} |
-| `options.scene` | `Scene` |
-| `options.camera` | `PerspectiveCamera` |
-| `options.renderer` | `WebGLRenderer` |
-| `options.featureFlags?` | `WorldFeatureFlags` |
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `options` | \{ `scene`: `Scene`; `camera`: `PerspectiveCamera`; `renderer`: [`EcsRenderer`](../type-aliases/EcsRenderer.md); `backend?`: [`RenderBackend`](../interfaces/RenderBackend.md); `featureFlags?`: `WorldFeatureFlags`; \} | - |
+| `options.scene` | `Scene` | - |
+| `options.camera` | `PerspectiveCamera` | - |
+| `options.renderer` | [`EcsRenderer`](../type-aliases/EcsRenderer.md) | A `THREE.WebGLRenderer`, or a `WebGPURenderer` from `three/webgpu`. A `WebGPURenderer` must be initialised (`await renderer.init()`) before the first `update()`. |
+| `options.backend?` | [`RenderBackend`](../interfaces/RenderBackend.md) | Renderer-specific behaviour (post-processing, green-screen video, area lights). Defaults to the WebGL backend; pass `webgpuBackend` from `@relu-interactives/spatial-ecs/webgpu` with a `WebGPURenderer`. |
+| `options.featureFlags?` | `WorldFeatureFlags` | - |
 
 #### Returns
 
@@ -40,7 +41,7 @@ Defined in: [World.ts:97](https://github.com/Relu-Interactives/relu-spatial-ecs-
 createEntity(): number;
 ```
 
-Defined in: [World.ts:116](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L116)
+Defined in: [World.ts:157](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L157)
 
 #### Returns
 
@@ -54,7 +55,7 @@ Defined in: [World.ts:116](https://github.com/Relu-Interactives/relu-spatial-ecs
 destroyEntity(entityId): void;
 ```
 
-Defined in: [World.ts:124](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L124)
+Defined in: [World.ts:165](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L165)
 
 #### Parameters
 
@@ -74,7 +75,7 @@ Defined in: [World.ts:124](https://github.com/Relu-Interactives/relu-spatial-ecs
 hasEntity(entityId): boolean;
 ```
 
-Defined in: [World.ts:151](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L151)
+Defined in: [World.ts:192](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L192)
 
 #### Parameters
 
@@ -94,7 +95,7 @@ Defined in: [World.ts:151](https://github.com/Relu-Interactives/relu-spatial-ecs
 getEntities(): number[];
 ```
 
-Defined in: [World.ts:155](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L155)
+Defined in: [World.ts:196](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L196)
 
 #### Returns
 
@@ -108,7 +109,7 @@ Defined in: [World.ts:155](https://github.com/Relu-Interactives/relu-spatial-ecs
 getEntityCount(): number;
 ```
 
-Defined in: [World.ts:159](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L159)
+Defined in: [World.ts:200](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L200)
 
 #### Returns
 
@@ -122,7 +123,7 @@ Defined in: [World.ts:159](https://github.com/Relu-Interactives/relu-spatial-ecs
 addComponent<T>(entityId, component): void;
 ```
 
-Defined in: [World.ts:163](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L163)
+Defined in: [World.ts:204](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L204)
 
 #### Type Parameters
 
@@ -149,7 +150,7 @@ Defined in: [World.ts:163](https://github.com/Relu-Interactives/relu-spatial-ecs
 addComponents<T>(entityId, components): void;
 ```
 
-Defined in: [World.ts:178](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L178)
+Defined in: [World.ts:219](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L219)
 
 #### Type Parameters
 
@@ -176,7 +177,7 @@ Defined in: [World.ts:178](https://github.com/Relu-Interactives/relu-spatial-ecs
 removeComponent<T>(entityId, componentType): void;
 ```
 
-Defined in: [World.ts:199](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L199)
+Defined in: [World.ts:240](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L240)
 
 #### Type Parameters
 
@@ -203,7 +204,7 @@ Defined in: [World.ts:199](https://github.com/Relu-Interactives/relu-spatial-ecs
 getComponent<T>(entityId, componentType): T | undefined;
 ```
 
-Defined in: [World.ts:207](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L207)
+Defined in: [World.ts:248](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L248)
 
 #### Type Parameters
 
@@ -230,7 +231,7 @@ Defined in: [World.ts:207](https://github.com/Relu-Interactives/relu-spatial-ecs
 hasComponent<T>(entityId, componentType): boolean;
 ```
 
-Defined in: [World.ts:214](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L214)
+Defined in: [World.ts:255](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L255)
 
 #### Type Parameters
 
@@ -257,7 +258,7 @@ Defined in: [World.ts:214](https://github.com/Relu-Interactives/relu-spatial-ecs
 query(...componentTypes): number[];
 ```
 
-Defined in: [World.ts:221](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L221)
+Defined in: [World.ts:262](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L262)
 
 #### Parameters
 
@@ -277,7 +278,7 @@ Defined in: [World.ts:221](https://github.com/Relu-Interactives/relu-spatial-ecs
 isEntityVisible(entityId): boolean;
 ```
 
-Defined in: [World.ts:235](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L235)
+Defined in: [World.ts:276](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L276)
 
 Returns `true` if the entity is currently visible (its `Object3DRef.visibility`
 is `true`), or if the entity has no `Object3DRef` component (entities without a
@@ -302,7 +303,7 @@ updates for hidden objects.
 getInputSystem(): EcsSystem | null;
 ```
 
-Defined in: [World.ts:240](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L240)
+Defined in: [World.ts:281](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L281)
 
 #### Returns
 
@@ -316,7 +317,7 @@ Defined in: [World.ts:240](https://github.com/Relu-Interactives/relu-spatial-ecs
 getKeyDown(key): boolean;
 ```
 
-Defined in: [World.ts:252](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L252)
+Defined in: [World.ts:293](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L293)
 
 #### Parameters
 
@@ -336,7 +337,7 @@ Defined in: [World.ts:252](https://github.com/Relu-Interactives/relu-spatial-ecs
 getKeyUp(key): boolean;
 ```
 
-Defined in: [World.ts:261](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L261)
+Defined in: [World.ts:302](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L302)
 
 #### Parameters
 
@@ -356,7 +357,7 @@ Defined in: [World.ts:261](https://github.com/Relu-Interactives/relu-spatial-ecs
 getKey(key): boolean;
 ```
 
-Defined in: [World.ts:270](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L270)
+Defined in: [World.ts:311](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L311)
 
 #### Parameters
 
@@ -376,7 +377,7 @@ Defined in: [World.ts:270](https://github.com/Relu-Interactives/relu-spatial-ecs
 getMouse(button): boolean;
 ```
 
-Defined in: [World.ts:279](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L279)
+Defined in: [World.ts:320](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L320)
 
 #### Parameters
 
@@ -396,7 +397,7 @@ Defined in: [World.ts:279](https://github.com/Relu-Interactives/relu-spatial-ecs
 getMouseDown(button): boolean;
 ```
 
-Defined in: [World.ts:288](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L288)
+Defined in: [World.ts:329](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L329)
 
 #### Parameters
 
@@ -416,7 +417,7 @@ Defined in: [World.ts:288](https://github.com/Relu-Interactives/relu-spatial-ecs
 getMouseUp(button): boolean;
 ```
 
-Defined in: [World.ts:297](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L297)
+Defined in: [World.ts:338](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L338)
 
 #### Parameters
 
@@ -436,7 +437,7 @@ Defined in: [World.ts:297](https://github.com/Relu-Interactives/relu-spatial-ecs
 getScrollClick(): boolean;
 ```
 
-Defined in: [World.ts:306](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L306)
+Defined in: [World.ts:347](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L347)
 
 #### Returns
 
@@ -450,7 +451,7 @@ Defined in: [World.ts:306](https://github.com/Relu-Interactives/relu-spatial-ecs
 getScrollClickDown(): boolean;
 ```
 
-Defined in: [World.ts:315](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L315)
+Defined in: [World.ts:356](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L356)
 
 #### Returns
 
@@ -464,7 +465,7 @@ Defined in: [World.ts:315](https://github.com/Relu-Interactives/relu-spatial-ecs
 getScrollClickUp(): boolean;
 ```
 
-Defined in: [World.ts:324](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L324)
+Defined in: [World.ts:365](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L365)
 
 #### Returns
 
@@ -481,7 +482,7 @@ getScrollDelta(): {
 };
 ```
 
-Defined in: [World.ts:333](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L333)
+Defined in: [World.ts:374](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L374)
 
 #### Returns
 
@@ -494,8 +495,8 @@ Defined in: [World.ts:333](https://github.com/Relu-Interactives/relu-spatial-ecs
 
 | Name | Type | Defined in |
 | ------ | ------ | ------ |
-| `x` | `number` | [World.ts:333](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L333) |
-| `y` | `number` | [World.ts:333](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L333) |
+| `x` | `number` | [World.ts:374](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L374) |
+| `y` | `number` | [World.ts:374](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L374) |
 
 ***
 
@@ -508,7 +509,7 @@ consumeScrollDelta(): {
 };
 ```
 
-Defined in: [World.ts:342](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L342)
+Defined in: [World.ts:383](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L383)
 
 #### Returns
 
@@ -521,8 +522,8 @@ Defined in: [World.ts:342](https://github.com/Relu-Interactives/relu-spatial-ecs
 
 | Name | Type | Defined in |
 | ------ | ------ | ------ |
-| `x` | `number` | [World.ts:342](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L342) |
-| `y` | `number` | [World.ts:342](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L342) |
+| `x` | `number` | [World.ts:383](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L383) |
+| `y` | `number` | [World.ts:383](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L383) |
 
 ***
 
@@ -535,7 +536,7 @@ getMousePosition(): {
 };
 ```
 
-Defined in: [World.ts:351](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L351)
+Defined in: [World.ts:392](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L392)
 
 #### Returns
 
@@ -548,8 +549,8 @@ Defined in: [World.ts:351](https://github.com/Relu-Interactives/relu-spatial-ecs
 
 | Name | Type | Defined in |
 | ------ | ------ | ------ |
-| `x` | `number` | [World.ts:351](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L351) |
-| `y` | `number` | [World.ts:351](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L351) |
+| `x` | `number` | [World.ts:392](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L392) |
+| `y` | `number` | [World.ts:392](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L392) |
 
 ***
 
@@ -562,7 +563,7 @@ getMouseDelta(): {
 };
 ```
 
-Defined in: [World.ts:360](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L360)
+Defined in: [World.ts:401](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L401)
 
 #### Returns
 
@@ -575,8 +576,8 @@ Defined in: [World.ts:360](https://github.com/Relu-Interactives/relu-spatial-ecs
 
 | Name | Type | Defined in |
 | ------ | ------ | ------ |
-| `x` | `number` | [World.ts:360](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L360) |
-| `y` | `number` | [World.ts:360](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L360) |
+| `x` | `number` | [World.ts:401](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L401) |
+| `y` | `number` | [World.ts:401](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L401) |
 
 ***
 
@@ -589,7 +590,7 @@ consumeMouseDelta(): {
 };
 ```
 
-Defined in: [World.ts:369](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L369)
+Defined in: [World.ts:410](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L410)
 
 #### Returns
 
@@ -602,8 +603,8 @@ Defined in: [World.ts:369](https://github.com/Relu-Interactives/relu-spatial-ecs
 
 | Name | Type | Defined in |
 | ------ | ------ | ------ |
-| `x` | `number` | [World.ts:369](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L369) |
-| `y` | `number` | [World.ts:369](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L369) |
+| `x` | `number` | [World.ts:410](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L410) |
+| `y` | `number` | [World.ts:410](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L410) |
 
 ***
 
@@ -613,7 +614,7 @@ Defined in: [World.ts:369](https://github.com/Relu-Interactives/relu-spatial-ecs
 getRapierModule(): Promise<__module>;
 ```
 
-Defined in: [World.ts:378](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L378)
+Defined in: [World.ts:419](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L419)
 
 #### Returns
 
@@ -627,7 +628,7 @@ Defined in: [World.ts:378](https://github.com/Relu-Interactives/relu-spatial-ecs
 getPhysicsWorld(): World | null;
 ```
 
-Defined in: [World.ts:396](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L396)
+Defined in: [World.ts:437](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L437)
 
 #### Returns
 
@@ -641,7 +642,7 @@ Defined in: [World.ts:396](https://github.com/Relu-Interactives/relu-spatial-ecs
 setPhysicsWorld(physicsWorld): void;
 ```
 
-Defined in: [World.ts:400](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L400)
+Defined in: [World.ts:441](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L441)
 
 #### Parameters
 
@@ -661,7 +662,7 @@ Defined in: [World.ts:400](https://github.com/Relu-Interactives/relu-spatial-ecs
 createPhysicsWorld(options?): Promise<World | null>;
 ```
 
-Defined in: [World.ts:404](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L404)
+Defined in: [World.ts:445](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L445)
 
 #### Parameters
 
@@ -685,7 +686,7 @@ Defined in: [World.ts:404](https://github.com/Relu-Interactives/relu-spatial-ecs
 lockMousePointer(): boolean;
 ```
 
-Defined in: [World.ts:423](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L423)
+Defined in: [World.ts:464](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L464)
 
 #### Returns
 
@@ -699,7 +700,7 @@ Defined in: [World.ts:423](https://github.com/Relu-Interactives/relu-spatial-ecs
 unlockMousePointer(): boolean;
 ```
 
-Defined in: [World.ts:454](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L454)
+Defined in: [World.ts:495](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L495)
 
 #### Returns
 
@@ -713,7 +714,7 @@ Defined in: [World.ts:454](https://github.com/Relu-Interactives/relu-spatial-ecs
 isMousePointerLocked(): boolean;
 ```
 
-Defined in: [World.ts:475](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L475)
+Defined in: [World.ts:516](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L516)
 
 #### Returns
 
@@ -727,7 +728,7 @@ Defined in: [World.ts:475](https://github.com/Relu-Interactives/relu-spatial-ecs
 getSystem<T>(system): T;
 ```
 
-Defined in: [World.ts:491](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L491)
+Defined in: [World.ts:532](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L532)
 
 #### Type Parameters
 
@@ -753,7 +754,7 @@ Defined in: [World.ts:491](https://github.com/Relu-Interactives/relu-spatial-ecs
 hasSystem<T>(system): boolean;
 ```
 
-Defined in: [World.ts:508](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L508)
+Defined in: [World.ts:549](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L549)
 
 #### Type Parameters
 
@@ -779,7 +780,7 @@ Defined in: [World.ts:508](https://github.com/Relu-Interactives/relu-spatial-ecs
 addSystem(system): void;
 ```
 
-Defined in: [World.ts:517](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L517)
+Defined in: [World.ts:558](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L558)
 
 #### Parameters
 
@@ -799,7 +800,7 @@ Defined in: [World.ts:517](https://github.com/Relu-Interactives/relu-spatial-ecs
 addSystems(systems): void;
 ```
 
-Defined in: [World.ts:521](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L521)
+Defined in: [World.ts:562](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L562)
 
 #### Parameters
 
@@ -823,7 +824,7 @@ setup(__namedParameters): {
 };
 ```
 
-Defined in: [World.ts:527](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L527)
+Defined in: [World.ts:568](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L568)
 
 #### Parameters
 
@@ -845,9 +846,9 @@ Defined in: [World.ts:527](https://github.com/Relu-Interactives/relu-spatial-ecs
 
 | Name | Type | Defined in |
 | ------ | ------ | ------ |
-| `objectManagementSystem` | [`ObjectManagementSystem`](ObjectManagementSystem.md) | [World.ts:528](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L528) |
-| `transformSyncSystem` | [`TransformSyncSystem`](TransformSyncSystem.md) | [World.ts:529](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L529) |
-| `renderSystem` | [`RenderSystem`](RenderSystem.md) | [World.ts:530](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L530) |
+| `objectManagementSystem` | [`ObjectManagementSystem`](ObjectManagementSystem.md) | [World.ts:569](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L569) |
+| `transformSyncSystem` | [`TransformSyncSystem`](TransformSyncSystem.md) | [World.ts:570](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L570) |
+| `renderSystem` | [`RenderSystem`](RenderSystem.md) | [World.ts:571](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L571) |
 
 ***
 
@@ -857,7 +858,59 @@ Defined in: [World.ts:527](https://github.com/Relu-Interactives/relu-spatial-ecs
 isEditorMode(): boolean;
 ```
 
-Defined in: [World.ts:615](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L615)
+Defined in: [World.ts:671](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L671)
+
+#### Returns
+
+`boolean`
+
+***
+
+### isXrPresenting()
+
+```ts
+isXrPresenting(): boolean;
+```
+
+Defined in: [World.ts:688](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L688)
+
+`true` while an immersive WebXR session is actively presenting.
+
+While presenting, three's `WebXRManager` OWNS the render camera: each frame
+`updateUserCamera()` writes the headset pose into the camera's
+position/quaternion/scale and copies the XR projection (including a derived
+`fov`) onto it. Systems that also drive the camera must stand down for the
+duration, or they ping-pong with the headset every frame and defeat their
+own dirty-checks.
+
+Locomotion therefore moves the camera's PARENT (the XR rig) — three composes
+the head pose as `parent.matrixWorld × headPose`.
+
+#### Returns
+
+`boolean`
+
+***
+
+### isXrPassthrough()
+
+```ts
+isXrPassthrough(): boolean;
+```
+
+Defined in: [World.ts:705](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L705)
+
+`true` while the session is compositing over the real world (passthrough).
+
+Read from the session's `environmentBlendMode` rather than from what the app
+ASKED for: a request for `immersive-ar` can be granted as a plain opaque
+session, and the blend mode is the only thing that says what the user is
+actually looking at. `additive` (optical see-through) and `alpha-blend`
+(video passthrough) both mean the real world is visible behind the render.
+
+The load-bearing consequence is that nothing may paint an opaque background:
+a skybox drawn over the whole framebuffer hides the room completely, which
+looks exactly like passthrough having failed.
 
 #### Returns
 
@@ -871,7 +924,7 @@ Defined in: [World.ts:615](https://github.com/Relu-Interactives/relu-spatial-ecs
 pause(): void;
 ```
 
-Defined in: [World.ts:626](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L626)
+Defined in: [World.ts:718](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L718)
 
 Pauses world simulation. While paused, `update()` skips all system ticks so
 physics, animation, scripts, and rendering stop advancing. The last rendered
@@ -891,7 +944,7 @@ Call [resume](#resume) to continue.
 resume(): void;
 ```
 
-Defined in: [World.ts:634](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L634)
+Defined in: [World.ts:726](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L726)
 
 Resumes world simulation after a previous [pause](#pause) call.
 Has no effect if the world is not paused.
@@ -908,7 +961,7 @@ Has no effect if the world is not paused.
 isPaused(): boolean;
 ```
 
-Defined in: [World.ts:648](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L648)
+Defined in: [World.ts:740](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L740)
 
 Returns `true` if the world is currently paused.
 
@@ -932,7 +985,7 @@ if (this.world.isPaused()) {
 getScene(): Scene;
 ```
 
-Defined in: [World.ts:652](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L652)
+Defined in: [World.ts:744](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L744)
 
 #### Returns
 
@@ -946,7 +999,7 @@ Defined in: [World.ts:652](https://github.com/Relu-Interactives/relu-spatial-ecs
 getCamera(): PerspectiveCamera;
 ```
 
-Defined in: [World.ts:656](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L656)
+Defined in: [World.ts:748](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L748)
 
 #### Returns
 
@@ -957,14 +1010,52 @@ Defined in: [World.ts:656](https://github.com/Relu-Interactives/relu-spatial-ecs
 ### getRenderer()
 
 ```ts
-getRenderer(): WebGLRenderer;
+getRenderer(): EcsRenderer;
+```
+
+Defined in: [World.ts:758](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L758)
+
+The renderer this world draws with: a `THREE.WebGLRenderer`, or a
+`WebGPURenderer` from `three/webgpu`. Check [getRendererKind](#getrendererkind) before
+using an API only one of them has (for example `capabilities` exists on
+WebGL only).
+
+#### Returns
+
+[`EcsRenderer`](../type-aliases/EcsRenderer.md)
+
+***
+
+### getRendererKind()
+
+```ts
+getRendererKind(): RendererKind;
 ```
 
-Defined in: [World.ts:660](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L660)
+Defined in: [World.ts:763](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L763)
+
+`"webgpu"` when the world renders with a `WebGPURenderer`, else `"webgl"`.
+
+#### Returns
+
+[`RendererKind`](../type-aliases/RendererKind.md)
+
+***
+
+### getRenderBackend()
+
+```ts
+getRenderBackend(): RenderBackend;
+```
+
+Defined in: [World.ts:771](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L771)
+
+The renderer-specific backend in use (post-processing, green-screen
+video, area lights). See `RenderBackend`.
 
 #### Returns
 
-`WebGLRenderer`
+[`RenderBackend`](../interfaces/RenderBackend.md)
 
 ***
 
@@ -974,7 +1065,7 @@ Defined in: [World.ts:660](https://github.com/Relu-Interactives/relu-spatial-ecs
 update(deltaTime): void;
 ```
 
-Defined in: [World.ts:664](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L664)
+Defined in: [World.ts:775](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L775)
 
 #### Parameters
 
@@ -994,7 +1085,7 @@ Defined in: [World.ts:664](https://github.com/Relu-Interactives/relu-spatial-ecs
 dispose(): void;
 ```
 
-Defined in: [World.ts:671](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L671)
+Defined in: [World.ts:782](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L782)
 
 #### Returns
 
@@ -1008,7 +1099,7 @@ Defined in: [World.ts:671](https://github.com/Relu-Interactives/relu-spatial-ecs
 setSelectedEntity(entityId): void;
 ```
 
-Defined in: [World.ts:683](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L683)
+Defined in: [World.ts:796](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L796)
 
 #### Parameters
 
@@ -1028,7 +1119,7 @@ Defined in: [World.ts:683](https://github.com/Relu-Interactives/relu-spatial-ecs
 getSelectedEntity(): number | null;
 ```
 
-Defined in: [World.ts:705](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L705)
+Defined in: [World.ts:818](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L818)
 
 #### Returns
 
@@ -1042,7 +1133,7 @@ Defined in: [World.ts:705](https://github.com/Relu-Interactives/relu-spatial-ecs
 getEntitiesByComponent(component): WorldEntityView[];
 ```
 
-Defined in: [World.ts:765](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L765)
+Defined in: [World.ts:878](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L878)
 
 #### Parameters
 
@@ -1062,7 +1153,7 @@ Defined in: [World.ts:765](https://github.com/Relu-Interactives/relu-spatial-ecs
 getEntitiesByName(name): WorldEntityView[];
 ```
 
-Defined in: [World.ts:779](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L779)
+Defined in: [World.ts:892](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L892)
 
 #### Parameters
 
@@ -1082,7 +1173,7 @@ Defined in: [World.ts:779](https://github.com/Relu-Interactives/relu-spatial-ecs
 getEntityByName(name): WorldEntityView | null;
 ```
 
-Defined in: [World.ts:788](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L788)
+Defined in: [World.ts:901](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L901)
 
 #### Parameters
 
@@ -1102,7 +1193,7 @@ Defined in: [World.ts:788](https://github.com/Relu-Interactives/relu-spatial-ecs
 getEntityById(entityId): WorldEntityView | null;
 ```
 
-Defined in: [World.ts:793](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L793)
+Defined in: [World.ts:906](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L906)
 
 #### Parameters
 
@@ -1122,7 +1213,7 @@ Defined in: [World.ts:793](https://github.com/Relu-Interactives/relu-spatial-ecs
 getEntitiesChildren(entityId): WorldEntityView[];
 ```
 
-Defined in: [World.ts:801](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L801)
+Defined in: [World.ts:914](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L914)
 
 #### Parameters
 
@@ -1142,7 +1233,7 @@ Defined in: [World.ts:801](https://github.com/Relu-Interactives/relu-spatial-ecs
 getEntitiesParent(entityId): WorldEntityView | null;
 ```
 
-Defined in: [World.ts:815](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L815)
+Defined in: [World.ts:928](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L928)
 
 #### Parameters
 
@@ -1162,7 +1253,7 @@ Defined in: [World.ts:815](https://github.com/Relu-Interactives/relu-spatial-ecs
 spawnPrefab(source, options?): Promise<number>;
 ```
 
-Defined in: [World.ts:830](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L830)
+Defined in: [World.ts:943](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L943)
 
 Instantiate a prefab asset into this world at runtime — see
 [spawnPrefab](../functions/spawnPrefab.md). Convenience wrapper so scripts and embedding apps
@@ -1187,7 +1278,7 @@ can spawn without reaching for the object management system.
 despawnPrefab(rootEntityId): number;
 ```
 
-Defined in: [World.ts:838](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L838)
+Defined in: [World.ts:951](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L951)
 
 Remove a spawned prefab instance (root + descendants).
 
@@ -1209,7 +1300,7 @@ Remove a spawned prefab instance (root + descendants).
 getObjectManagementSystem(): ObjectManagementSystem;
 ```
 
-Defined in: [World.ts:842](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L842)
+Defined in: [World.ts:955](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L955)
 
 #### Returns
 
@@ -1223,7 +1314,7 @@ Defined in: [World.ts:842](https://github.com/Relu-Interactives/relu-spatial-ecs
 getEnvironmentComponent(): Environment | undefined;
 ```
 
-Defined in: [World.ts:870](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L870)
+Defined in: [World.ts:983](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L983)
 
 Returns the singleton [Environment](../../components/classes/Environment.md) component for the scene, or
 `undefined` if no environment entity exists yet.
@@ -1255,7 +1346,7 @@ getPostprocessingComponent():
   | undefined;
 ```
 
-Defined in: [World.ts:893](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L893)
+Defined in: [World.ts:1006](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L1006)
 
 Returns the singleton [Postprocessing](../../components/classes/Postprocessing.md) component for the scene, or
 `undefined` if no postprocessing entity exists yet.
@@ -1291,7 +1382,7 @@ raycast(
    far?): IntersectionResult[];
 ```
 
-Defined in: [World.ts:923](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L923)
+Defined in: [World.ts:1036](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L1036)
 
 Cast a ray from `origin` along `direction` and return every intersected
 entity-bound mesh, sorted by distance. Each result is a standard
@@ -1334,7 +1425,7 @@ raycastFrom(
    far?): IntersectionResult[];
 ```
 
-Defined in: [World.ts:974](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L974)
+Defined in: [World.ts:1087](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L1087)
 
 Cast a ray from an entity's world-space position along its forward
 direction (the +Z axis of its world matrix). Returns intersected
@@ -1371,7 +1462,7 @@ if (closest && closest.entityId !== null) {
 getEntityScript<T>(entityId): T | null;
 ```
 
-Defined in: [World.ts:1057](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L1057)
+Defined in: [World.ts:1170](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L1170)
 
 #### Type Parameters
 
@@ -1397,7 +1488,7 @@ Defined in: [World.ts:1057](https://github.com/Relu-Interactives/relu-spatial-ec
 getScripts<T>(className): T[];
 ```
 
-Defined in: [World.ts:1070](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L1070)
+Defined in: [World.ts:1183](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L1183)
 
 #### Type Parameters
 
@@ -1423,7 +1514,7 @@ Defined in: [World.ts:1070](https://github.com/Relu-Interactives/relu-spatial-ec
 getScript<T>(className): T | null;
 ```
 
-Defined in: [World.ts:1111](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L1111)
+Defined in: [World.ts:1224](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L1224)
 
 #### Type Parameters
 
@@ -1449,7 +1540,7 @@ Defined in: [World.ts:1111](https://github.com/Relu-Interactives/relu-spatial-ec
 getAllEntities(): WorldEntityView[];
 ```
 
-Defined in: [World.ts:1116](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L1116)
+Defined in: [World.ts:1229](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L1229)
 
 #### Returns
 
@@ -1463,7 +1554,7 @@ Defined in: [World.ts:1116](https://github.com/Relu-Interactives/relu-spatial-ec
 onSelectionChanged(listener): () => void;
 ```
 
-Defined in: [World.ts:1122](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L1122)
+Defined in: [World.ts:1235](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L1235)
 
 #### Parameters
 
@@ -1483,7 +1574,7 @@ Defined in: [World.ts:1122](https://github.com/Relu-Interactives/relu-spatial-ec
 subscribe(listener): () => void;
 ```
 
-Defined in: [World.ts:1130](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L1130)
+Defined in: [World.ts:1243](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L1243)
 
 #### Parameters
 
@@ -1497,13 +1588,104 @@ Defined in: [World.ts:1130](https://github.com/Relu-Interactives/relu-spatial-ec
 
 ***
 
+### onScriptError()
+
+```ts
+onScriptError(listener): () => void;
+```
+
+Defined in: [World.ts:1269](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L1269)
+
+Listen for script errors from Behaviours and ScriptObjects: load
+failures, `init()` / `build()` / `update()` exceptions, and exceptions
+thrown inside Behaviour hooks such as `onSelect` or `onUiPress`.
+
+Each DISTINCT error (same script URL, class, phase and message) is
+delivered once, so a script that throws every frame does not flood the
+listener. Returns an unsubscribe function.
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `listener` | [`ScriptErrorListener`](../type-aliases/ScriptErrorListener.md) |
+
+#### Returns
+
+() => `void`
+
+#### Example
+
+```ts
+const stop = world.onScriptError((event) => {
+  console.warn(`${event.className} failed in ${event.phase}: ${event.message}`);
+});
+// later
+stop();
+```
+
+***
+
+### reportScriptError()
+
+```ts
+reportScriptError(report, error): boolean;
+```
+
+Defined in: [World.ts:1286](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L1286)
+
+Report a script error. Used by the script systems and by any system that
+calls into Behaviour hooks; scripts themselves do not need to call it.
+
+The first occurrence of a distinct error (same script URL, class, phase
+and message) is logged with `console.error` and delivered to
+[onScriptError](#onscripterror) listeners; repeats are dropped. Returns `true` when
+the error was new.
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `report` | [`ScriptErrorReport`](../type-aliases/ScriptErrorReport.md) |
+| `error` | `unknown` |
+
+#### Returns
+
+`boolean`
+
+***
+
+### clearScriptErrors()
+
+```ts
+clearScriptErrors(scriptUrl?): void;
+```
+
+Defined in: [World.ts:1338](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L1338)
+
+Forget which script errors were already reported, so their next
+occurrence is logged and delivered again. Pass a script URL to forget only
+that script's errors (for example after hot-reloading it).
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `scriptUrl?` | `string` |
+
+#### Returns
+
+`void`
+
+***
+
 ### getDebugSnapshot()
 
 ```ts
 getDebugSnapshot(maxDepth?): unknown;
 ```
 
-Defined in: [World.ts:1138](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L1138)
+Defined in: [World.ts:1350](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L1350)
 
 #### Parameters
 
@@ -1523,7 +1705,7 @@ Defined in: [World.ts:1138](https://github.com/Relu-Interactives/relu-spatial-ec
 getDebugSignature(maxDepth?): string;
 ```
 
-Defined in: [World.ts:1188](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L1188)
+Defined in: [World.ts:1400](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L1400)
 
 #### Parameters
 
@@ -1552,7 +1734,7 @@ getEntitiesSnapshot(entityIds, maxDepth?): {
 };
 ```
 
-Defined in: [World.ts:1197](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L1197)
+Defined in: [World.ts:1409](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L1409)
 
 Serialize ONLY the given entities into the same columnar
 `{entities, components}` shape as [getDebugSnapshot](#getdebugsnapshot) (no systems,
@@ -1582,8 +1764,8 @@ no selection). Used by prefab/scene subtree serialization.
 
 | Name | Type | Defined in |
 | ------ | ------ | ------ |
-| `entities` | `number`[] | [World.ts:1201](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L1201) |
-| `components` | \{ `component`: `string`; `entries`: \{ `entityId`: `number`; `value`: `unknown`; \}[]; \}[] | [World.ts:1202](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L1202) |
+| `entities` | `number`[] | [World.ts:1413](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L1413) |
+| `components` | \{ `component`: `string`; `entries`: \{ `entityId`: `number`; `value`: `unknown`; \}[]; \}[] | [World.ts:1414](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L1414) |
 
 ***
 
@@ -1593,7 +1775,7 @@ no selection). Used by prefab/scene subtree serialization.
 createHistorySnapshot(): WorldHistorySnapshot;
 ```
 
-Defined in: [World.ts:1239](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L1239)
+Defined in: [World.ts:1451](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L1451)
 
 #### Returns
 
@@ -1607,7 +1789,7 @@ Defined in: [World.ts:1239](https://github.com/Relu-Interactives/relu-spatial-ec
 applyHistorySnapshot(snapshot): void;
 ```
 
-Defined in: [World.ts:1260](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/World.ts#L1260)
+Defined in: [World.ts:1472](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/World.ts#L1472)
 
 #### Parameters