@relu-interactives/spatial-ecs 0.5.2 → 0.8.0

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

@@ -17,7 +17,6 @@
 | [World](classes/World.md) | - |
 | [AnimationSystem](classes/AnimationSystem.md) | - |
 | [CameraSyncSystem](classes/CameraSyncSystem.md) | - |
-| [EnvironmentSyncSystem](classes/EnvironmentSyncSystem.md) | - |
 | [InputSystem](classes/InputSystem.md) | - |
 | [InstancedMeshSystem](classes/InstancedMeshSystem.md) | Maintains the runtime geometry for entities with an [InstancedMeshComponent](../components/classes/InstancedMeshComponent.md). |
 | [LightSyncSystem](classes/LightSyncSystem.md) | - |
@@ -26,10 +25,25 @@
 | [ObjectManagementSystem](classes/ObjectManagementSystem.md) | - |
 | [ObjectVisibilitySystem](classes/ObjectVisibilitySystem.md) | - |
 | [PhysicsSyncSystem](classes/PhysicsSyncSystem.md) | - |
-| [PostprocessingSyncSystem](classes/PostprocessingSyncSystem.md) | - |
-| [RenderSystem](classes/RenderSystem.md) | - |
 | [ScriptBehaviourSystem](classes/ScriptBehaviourSystem.md) | - |
 | [TransformSyncSystem](classes/TransformSyncSystem.md) | - |
+| [UIInteractionSystem](classes/UIInteractionSystem.md) | - |
+| [UIPanelSystem](classes/UIPanelSystem.md) | - |
+| [VRTeleportAreaSystem](classes/VRTeleportAreaSystem.md) | - |
+| [XRAnchorSystem](classes/XRAnchorSystem.md) | - |
+| [XRControllerVisualSystem](classes/XRControllerVisualSystem.md) | - |
+| [XREnvironmentSystem](classes/XREnvironmentSystem.md) | - |
+| [XRHandPoseSystem](classes/XRHandPoseSystem.md) | - |
+| [XRHitTestSystem](classes/XRHitTestSystem.md) | - |
+| [XRHoverVisualSystem](classes/XRHoverVisualSystem.md) | - |
+| [XRInputSystem](classes/XRInputSystem.md) | - |
+| [XRInteractionSystem](classes/XRInteractionSystem.md) | - |
+| [XRLocomotionSystem](classes/XRLocomotionSystem.md) | - |
+| [XRSessionSystem](classes/XRSessionSystem.md) | Owns the immersive-session lifecycle and fans XR events out to Behaviours. |
+| [XRTeleportVisualSystem](classes/XRTeleportVisualSystem.md) | - |
+| [HandPoseTracker](classes/HandPoseTracker.md) | Turns a stream of per-frame confidences into clean start/end events. |
+| [TeleportAimGate](classes/TeleportAimGate.md) | Decides when a teleport may actually commit. |
+| [ThrowVelocityTracker](classes/ThrowVelocityTracker.md) | Rolling buffer of hand positions used to recover throw velocity. |
 
 ### Scripting
 
@@ -42,6 +56,9 @@
 | Class | Description |
 | ------ | ------ |
 | [AudioSystem](classes/AudioSystem.md) | Reconciles `AudioComponent` state with the underlying THREE.js audio objects each frame. |
+| [EnvironmentSyncSystem](classes/EnvironmentSyncSystem.md) | Applies the scene's [Environment](../components/classes/Environment.md) component to the three.js scene: skybox, fog, and (when `values.lighting` is present) image-based lighting, tone mapping and exposure. |
+| [PostprocessingSyncSystem](classes/PostprocessingSyncSystem.md) | Builds the post-processing chain from the scene's [Postprocessing](../components/classes/Postprocessing.md) component and hands it to `RenderSystem` through `scene.userData`: |
+| [RenderSystem](classes/RenderSystem.md) | Draws the frame: through the post-processing chain in `scene.userData.ecsPostprocessingComposer` while `scene.userData.ecsPostprocessingComposerActive` is `true`, otherwise with `renderer.render(scene, camera)`. Runs last in the default system list. |
 | [ScriptObjectSystem](classes/ScriptObjectSystem.md) | Builds, ticks, and disposes [ScriptObject](classes/ScriptObject.md) scripts. Unlike `ScriptBehaviourSystem`, this runs in the editor AND at runtime — there is NO `isEditorMode` gating anywhere here. A script's `build()` output is attached under the entity's `Object3DRef.object` (so it inherits transform, selection and visibility). `runtimeState` is written on transitions only (never every frame). |
 | [VideoSystem](classes/VideoSystem.md) | Reconciles `VideoComponent` state with the underlying HTML video element and THREE.js mesh/material each frame. |
 
@@ -51,6 +68,10 @@
 | ------ | ------ |
 | [StateMachine](interfaces/StateMachine.md) | - |
 | [EcsSystem](interfaces/EcsSystem.md) | - |
+| [PostprocessingPipeline](interfaces/PostprocessingPipeline.md) | A built post-processing chain. `RenderSystem` calls `render()` in place of `renderer.render()` while it is active. |
+| [PostprocessingBuildContext](interfaces/PostprocessingBuildContext.md) | Everything a backend needs to build a post-processing chain. |
+| [ChromaKeyOptions](interfaces/ChromaKeyOptions.md) | Green-screen settings, in the same units as `VideoComponent.options`. |
+| [RenderBackend](interfaces/RenderBackend.md) | Everything renderer-specific the engine does, behind one small interface so a [World](classes/World.md) can run on WebGL or WebGPU. |
 
 ## Type Aliases
 
@@ -74,12 +95,44 @@
 | [SpawnPrefabSource](type-aliases/SpawnPrefabSource.md) | - |
 | [SpawnPrefabOptions](type-aliases/SpawnPrefabOptions.md) | - |
 | [PrefabAsset](type-aliases/PrefabAsset.md) | Envelope of a `.prefab` asset file (and, later, `.scene` assets — same shape with `type: "scene"`). `snapshot` is the same columnar world-snapshot format `hydrateWorldFromSnapshotDetailed` consumes, with entity ids renumbered 1..N and every entity carrying a `PrefabNode` identity. |
+| [EcsRenderer](type-aliases/EcsRenderer.md) | A renderer a [World](classes/World.md) can run on: three's classic `WebGLRenderer`, or `WebGPURenderer` from `three/webgpu` (which falls back to WebGL 2 on its own when the browser has no WebGPU). |
+| [RendererKind](type-aliases/RendererKind.md) | Which renderer family a world is drawing with. |
+| [ScriptErrorPhase](type-aliases/ScriptErrorPhase.md) | Where in a script's life an error happened. |
+| [ScriptErrorSource](type-aliases/ScriptErrorSource.md) | Which kind of script failed. |
+| [ScriptErrorEvent](type-aliases/ScriptErrorEvent.md) | Emitted by `world.onScriptError(...)` the first time a distinct script error occurs. "Distinct" is the combination of script URL, class name, phase and message: ten enemies running the same broken script report once. |
+| [ScriptErrorListener](type-aliases/ScriptErrorListener.md) | Listener registered with `world.onScriptError(...)`. |
+| [ScriptErrorReport](type-aliases/ScriptErrorReport.md) | What a system knows when it reports a script error. |
 | [MouseButton](type-aliases/MouseButton.md) | - |
 | [EcsComponentFactoryKind](type-aliases/EcsComponentFactoryKind.md) | - |
 | [ComponentFactory](type-aliases/ComponentFactory.md) | - |
+| [ScriptBehaviourSystemOptions](type-aliases/ScriptBehaviourSystemOptions.md) | Options for [ScriptBehaviourSystem](classes/ScriptBehaviourSystem.md). |
 | [SelectionContext](type-aliases/SelectionContext.md) | Optional context that enables raycast-based onSelect / onDeselect dispatch. When provided, pointer/touch taps on the canvas fire a raycast against the scene. If the hit object (or any ancestor) carries userData.entityId, every Behaviour instance for that entity receives onSelect(); the previously selected entity's instances receive onDeselect(). |
+| [UiCanvasLike](type-aliases/UiCanvasLike.md) | Structural canvas type so tests can inject a stub with no DOM. |
+| [XrHandPoseEventDetail](type-aliases/XrHandPoseEventDetail.md) | - |
+| [XrHitResult](type-aliases/XrHitResult.md) | Where a ray met the real world. |
 | [KeyboardKey](type-aliases/KeyboardKey.md) | - |
 | [ModuleLoader](type-aliases/ModuleLoader.md) | Resolves a script URL to its ES module namespace. |
+| [XrHandJointName](type-aliases/XrHandJointName.md) | The 25 joints of the WebXR hand skeleton. |
+| [XrFinger](type-aliases/XrFinger.md) | - |
+| [XrHandJoints](type-aliases/XrHandJoints.md) | Joint positions, in world space. |
+| [XrFingerCurl](type-aliases/XrFingerCurl.md) | How curled one finger is. |
+| [XrPalmPose](type-aliases/XrPalmPose.md) | An orthonormal frame attached to the palm. |
+| [XrHandShape](type-aliases/XrHandShape.md) | Everything a pose is matched against, derived once per hand per frame. |
+| [XrFingerTarget](type-aliases/XrFingerTarget.md) | Target curl for one finger, with the slack allowed around it. |
+| [XrHandPoseAxis](type-aliases/XrHandPoseAxis.md) | Which way something on the hand must point for the pose to count. |
+| [XrHandPoseDirection](type-aliases/XrHandPoseDirection.md) | - |
+| [XrHandPoseOrientation](type-aliases/XrHandPoseOrientation.md) | - |
+| [XrHandPoseDefinition](type-aliases/XrHandPoseDefinition.md) | A matchable hand pose. |
+| [XrHandPoseMatch](type-aliases/XrHandPoseMatch.md) | - |
+| [XrHandPoseContext](type-aliases/XrHandPoseContext.md) | Extra world context needed only by head-relative orientation conditions. |
+| [XrHandPoseEvent](type-aliases/XrHandPoseEvent.md) | - |
+| [HandPoseTrackerOptions](type-aliases/HandPoseTrackerOptions.md) | - |
+| [HandMaterialOptions](type-aliases/HandMaterialOptions.md) | Materials for tracked-hand meshes. |
+| [VelocitySample](type-aliases/VelocitySample.md) | - |
+| [XrHandedness](type-aliases/XrHandedness.md) | Which hand an input source belongs to (`none` for gaze / single-source devices). |
+| [XrInputKind](type-aliases/XrInputKind.md) | How an input source is physically driven. |
+| [XrInputState](type-aliases/XrInputState.md) | One frame of normalized input for a single source. |
+| [XrCapabilities](type-aliases/XrCapabilities.md) | What the ACTIVE session actually granted us. |
 
 ## Variables
 
@@ -87,14 +140,38 @@
 | ------ | ------ |
 | [HYDRATABLE\_ENTITY\_KINDS](variables/HYDRATABLE_ENTITY_KINDS.md) | - |
 | [NODE\_KEY\_SEPARATOR](variables/NODE_KEY_SEPARATOR.md) | - |
-| [ADDED\_NODE\_MARKER\_COMPONENT](variables/ADDED_NODE_MARKER_COMPONENT.md) | Reserved override "component" marking a node ADDED by the host document inside a nested instance region (`"<nodeKey>|+node|"`). File patching trusts stored overrides (the old base is unavailable), so without the marker a host-authored node inside the region would be indistinguishable from a node the child prefab removed — and get deleted. |
+| [ADDED\_NODE\_MARKER\_COMPONENT](variables/ADDED_NODE_MARKER_COMPONENT.md) | Reserved override "component" marking a node ADDED by the host document inside a nested instance region (`"&lt;nodeKey&gt;|+node|"`). File patching trusts stored overrides (the old base is unavailable), so without the marker a host-authored node inside the region would be indistinguishable from a node the child prefab removed — and get deleted. |
 | [OVERRIDE\_DIFF\_EXCLUDED\_COMPONENTS](variables/OVERRIDE_DIFF_EXCLUDED_COMPONENTS.md) | Components that never participate in override diffing/merging. |
 | [OVERRIDE\_ROOT\_EXCLUDED\_COMPONENTS](variables/OVERRIDE_ROOT_EXCLUDED_COMPONENTS.md) | Components excluded ONLY on the instance ROOT node — these are per-instance by definition (where the instance sits in the scene and what it's called). |
 | [PREFAB\_FILE\_VERSION](variables/PREFAB_FILE_VERSION.md) | - |
 | [PREFAB\_FILE\_VERSION\_NESTED](variables/PREFAB_FILE_VERSION_NESTED.md) | Written for files containing NESTED instances (parse accepts either). |
+| [webglBackend](variables/webglBackend.md) | The default [RenderBackend](interfaces/RenderBackend.md): three's `WebGLRenderer`, post-processing through `EffectComposer`, GLSL chroma key. |
+| [DEFAULT\_SCRIPT\_ERROR\_RETRY\_DELAY](variables/DEFAULT_SCRIPT_ERROR_RETRY_DELAY.md) | Seconds a Behaviour waits after an error (load, `init()` or `update()`) before it is re-initialised. Without the wait a script that throws every frame was torn down and rebuilt every frame. |
 | [SCRIPT\_OBJECT\_ROOT\_FLAG](variables/SCRIPT_OBJECT_ROOT_FLAG.md) | Tags the Object3D a script's `build()` returned, so reloads can find/remove it. |
+| [XR\_HOVER\_SHELL\_FLAG](variables/XR_HOVER_SHELL_FLAG.md) | Marks shell meshes so they are never mistaken for scene content. |
 | [KeyboardKeys](variables/KeyboardKeys.md) | - |
 | [SHARED\_MODEL\_RESOURCE\_FLAG](variables/SHARED_MODEL_RESOURCE_FLAG.md) | userData flag set on geometries/materials that back shared (cached) model scenes. Entity disposal must skip these — other live clones and future spawns reference the same GPU resources. |
+| [XR\_FINGERS](variables/XR_FINGERS.md) | - |
+| [PINCH\_FINGERS](variables/PINCH_FINGERS.md) | Fingers that can oppose the thumb. The thumb cannot pinch itself. |
+| [FALLBACK\_HAND\_SCALE](variables/FALLBACK_HAND_SCALE.md) | Fallback palm width when the hand is too poorly tracked to measure. |
+| [STRAIGHT\_COS](variables/STRAIGHT_COS.md) | Straightness normalization. |
+| [CURLED\_COS](variables/CURLED_COS.md) | - |
+| [MATCH\_FALLOFF](variables/MATCH_FALLOFF.md) | Confidence falls to zero this far outside a target's tolerance band. |
+| [DEFAULT\_DIRECTION\_TOLERANCE](variables/DEFAULT_DIRECTION_TOLERANCE.md) | Default cone for per-finger direction constraints. |
+| [DEFAULT\_ENTER\_CONFIDENCE](variables/DEFAULT_ENTER_CONFIDENCE.md) | - |
+| [DEFAULT\_EXIT\_CONFIDENCE](variables/DEFAULT_EXIT_CONFIDENCE.md) | - |
+| [DEFAULT\_MIN\_HOLD\_SECONDS](variables/DEFAULT_MIN_HOLD_SECONDS.md) | - |
+| [DEFAULT\_LOST\_GRACE\_SECONDS](variables/DEFAULT_LOST_GRACE_SECONDS.md) | - |
+| [HAND\_POSE\_PRESETS](variables/HAND_POSE_PRESETS.md) | Built-in poses, keyed by id. |
+| [HAND\_POSE\_PRESET\_IDS](variables/HAND_POSE_PRESET_IDS.md) | Preset ids, in the order the editor lists them. |
+| [ARC\_GRAVITY](variables/ARC_GRAVITY.md) | Downward acceleration applied to the aim curve, m/s². |
+| [ARC\_SPEED](variables/ARC_SPEED.md) | Launch speed of the virtual projectile, m/s. Tuned for ~5-8m reach. |
+| [ARC\_STEPS](variables/ARC_STEPS.md) | Samples along the curve. Enough to look smooth without wasting raycasts. |
+| [ARC\_MAX\_TIME](variables/ARC_MAX_TIME.md) | Seconds of flight to simulate before giving up on finding ground. |
+| [VELOCITY\_SAMPLES](variables/VELOCITY_SAMPLES.md) | Samples retained. ~5 frames ≈ 55ms at 90Hz — long enough to smooth noise. |
+| [MAX\_SAMPLE\_AGE\_SECONDS](variables/MAX_SAMPLE_AGE_SECONDS.md) | Samples older than this are ignored on release. |
+| [MAX\_PLAUSIBLE\_SPEED](variables/MAX_PLAUSIBLE_SPEED.md) | Fastest hand motion treated as real, in metres/second. |
+| [NO\_XR\_CAPABILITIES](variables/NO_XR_CAPABILITIES.md) | Capabilities for "no session running" — every feature off. |
 
 ## Functions
 
@@ -126,7 +203,19 @@
 | [createSelectionTransformStateComponent](functions/createSelectionTransformStateComponent.md) | - |
 | [createSpriteComponent](functions/createSpriteComponent.md) | - |
 | [createTransformComponent](functions/createTransformComponent.md) | - |
+| [createUIButtonComponent](functions/createUIButtonComponent.md) | - |
+| [createUIPanelComponent](functions/createUIPanelComponent.md) | - |
+| [createUISliderComponent](functions/createUISliderComponent.md) | - |
+| [createUITextComponent](functions/createUITextComponent.md) | - |
+| [createUIToggleComponent](functions/createUIToggleComponent.md) | - |
+| [createVRTeleportAreaComponent](functions/createVRTeleportAreaComponent.md) | - |
 | [createVideoComponent](functions/createVideoComponent.md) | - |
+| [createXRAnchorComponent](functions/createXRAnchorComponent.md) | - |
+| [createXRHandPoseComponent](functions/createXRHandPoseComponent.md) | - |
+| [createXRInteractableComponent](functions/createXRInteractableComponent.md) | - |
+| [createXRInteractorComponent](functions/createXRInteractorComponent.md) | - |
+| [createXRInteractorSideComponent](functions/createXRInteractorSideComponent.md) | - |
+| [createXRRigComponent](functions/createXRRigComponent.md) | - |
 | [registerDefaultComponentFactories](functions/registerDefaultComponentFactories.md) | - |
 | [registerDefaultFactories](functions/registerDefaultFactories.md) | - |
 | [buildComponentValueMaps](functions/buildComponentValueMaps.md) | - |
@@ -165,6 +254,23 @@
 | [resolveDracoDecoderPath](functions/resolveDracoDecoderPath.md) | - |
 | [loadSharedGltf](functions/loadSharedGltf.md) | Load a GLTF once per URL and share the parsed result, so repeated spawns of the same model skip both the fetch and the parse. The cached scene must never be mounted directly (an Object3D has a single parent) — mount a cloneModelScene() of it. Failed loads are evicted so a retry re-fetches. |
 | [clearModelCache](functions/clearModelCache.md) | Forget cached models (one URL, or everything). Subsequent loads fetch and parse anew. Does not dispose GPU resources — live clones may still use them. |
+| [computeFingerCurl](functions/computeFingerCurl.md) | Curl for one finger, or null when the finger isn't tracked well enough. |
+| [computePalmWidth](functions/computePalmWidth.md) | Distance across the knuckles — our unit of hand size. |
+| [estimateHandScale](functions/estimateHandScale.md) | Characteristic hand size in metres. |
+| [computePinch](functions/computePinch.md) | How close a fingertip is to the thumb tip. 1 = touching, 0 = far apart. |
+| [computeSpread](functions/computeSpread.md) | Angular separation between two fingers. 0 = parallel, 1 = splayed wide. |
+| [computePalmPose](functions/computePalmPose.md) | Palm frame, used for orientation conditions ("palm up", "thumb toward face"). |
+| [computeHandShape](functions/computeHandShape.md) | Reduce tracked joints to the matchable shape. |
+| [matchHandPose](functions/matchHandPose.md) | Score a live hand against a pose. |
+| [getHandPosePreset](functions/getHandPosePreset.md) | A deep copy of a preset. |
+| [cloneHandPose](functions/cloneHandPose.md) | - |
+| [handPoseFromCurls](functions/handPoseFromCurls.md) | Build a pose from five curl values — the shape the editor's sliders and the AI tools produce. |
+| [createHandMaterial](functions/createHandMaterial.md) | Build the material for a preset. |
+| [applyHandMaterial](functions/applyHandMaterial.md) | Apply a preset material to every mesh under a hand model. |
+| [sampleTeleportArc](functions/sampleTeleportArc.md) | Sample a ballistic curve starting at `origin` heading along `direction`. |
+| [arcGroundCrossing](functions/arcGroundCrossing.md) | Where a sampled arc first crosses `groundY` going downward, or null. |
+| [angularVelocityFrom](functions/angularVelocityFrom.md) | Angular velocity from a rotation delta, as an axis-angle vector (rad/s). |
+| [readXrCapabilities](functions/readXrCapabilities.md) | Read granted features off a live session. |
 
 ## References
 
@@ -180,6 +286,12 @@ Re-exports [Behaviour](../Behaviour/classes/Behaviour.md)
 
 ***
 
+### UiInteractionEvent
+
+Re-exports [UiInteractionEvent](../Behaviour/type-aliases/UiInteractionEvent.md)
+
+***
+
 ### CoreComponents
 
 Renames and re-exports [components](../components/index.md)

package/dist/docs/api/index/interfaces/ChromaKeyOptions.md

@@ -0,0 +1,20 @@
+[**@relu-interactives/spatial-ecs**](../../index.md)
+
+***
+
+[@relu-interactives/spatial-ecs](../../index.md) / [index](../index.md) / ChromaKeyOptions
+
+# Interface: ChromaKeyOptions
+
+Defined in: render/RenderBackend.ts:44
+
+Green-screen settings, in the same units as `VideoComponent.options`.
+
+## Properties
+
+| Property | Type | Description | Defined in |
+| ------ | ------ | ------ | ------ |
+| <a id="keycolor"></a> `keyColor` | `ColorRepresentation` | Colour to key out (any three.js colour representation, e.g. `"#00ff00"`). | render/RenderBackend.ts:46 |
+| <a id="similarity"></a> `similarity` | `number` | Colour distance below which a pixel is fully transparent. | render/RenderBackend.ts:48 |
+| <a id="smoothness"></a> `smoothness` | `number` | Width of the soft edge above `similarity`. | render/RenderBackend.ts:50 |
+| <a id="spill"></a> `spill` | `number` | How far past the edge the key colour is desaturated (spill removal). | render/RenderBackend.ts:52 |

package/dist/docs/api/index/interfaces/EcsSystem.md

@@ -6,7 +6,7 @@
 
 # Interface: EcsSystem
 
-Defined in: [System.ts:3](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/System.ts#L3)
+Defined in: [System.ts:3](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/System.ts#L3)
 
 ## Methods
 
@@ -16,7 +16,7 @@ Defined in: [System.ts:3](https://github.com/Relu-Interactives/relu-spatial-ecs-
 update(world, deltaTime): void;
 ```
 
-Defined in: [System.ts:4](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/System.ts#L4)
+Defined in: [System.ts:4](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/System.ts#L4)
 
 #### Parameters
 
@@ -37,7 +37,7 @@ Defined in: [System.ts:4](https://github.com/Relu-Interactives/relu-spatial-ecs-
 optional dispose(world): void;
 ```
 
-Defined in: [System.ts:5](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/System.ts#L5)
+Defined in: [System.ts:5](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/System.ts#L5)
 
 #### Parameters
 

package/dist/docs/api/index/interfaces/PostprocessingBuildContext.md

@@ -0,0 +1,21 @@
+[**@relu-interactives/spatial-ecs**](../../index.md)
+
+***
+
+[@relu-interactives/spatial-ecs](../../index.md) / [index](../index.md) / PostprocessingBuildContext
+
+# Interface: PostprocessingBuildContext
+
+Defined in: render/RenderBackend.ts:33
+
+Everything a backend needs to build a post-processing chain.
+
+## Properties
+
+| Property | Type | Description | Defined in |
+| ------ | ------ | ------ | ------ |
+| <a id="renderer"></a> `renderer` | [`EcsRenderer`](../type-aliases/EcsRenderer.md) | - | render/RenderBackend.ts:34 |
+| <a id="scene"></a> `scene` | `Scene` | - | render/RenderBackend.ts:35 |
+| <a id="camera"></a> `camera` | `PerspectiveCamera` | - | render/RenderBackend.ts:36 |
+| <a id="values"></a> `values` | [`PostprocessingState`](../../components/type-aliases/PostprocessingState.md) | The scene's current `Postprocessing.values` (`postEnabled` is `true`). | render/RenderBackend.ts:38 |
+| <a id="world"></a> `world?` | [`World`](../classes/World.md) | The world being rendered, when known (used to scope one-time warnings). | render/RenderBackend.ts:40 |

package/dist/docs/api/index/interfaces/PostprocessingPipeline.md

@@ -0,0 +1,84 @@
+[**@relu-interactives/spatial-ecs**](../../index.md)
+
+***
+
+[@relu-interactives/spatial-ecs](../../index.md) / [index](../index.md) / PostprocessingPipeline
+
+# Interface: PostprocessingPipeline
+
+Defined in: render/RenderBackend.ts:25
+
+A built post-processing chain. `RenderSystem` calls `render()` in place of
+`renderer.render()` while it is active.
+
+`setSize` / `setPixelRatio` are optional: a WebGL `EffectComposer` needs
+them, while a WebGPU `RenderPipeline` reads the renderer's size every frame.
+
+## Methods
+
+### render()
+
+```ts
+render(): void;
+```
+
+Defined in: render/RenderBackend.ts:26
+
+#### Returns
+
+`void`
+
+***
+
+### setSize()?
+
+```ts
+optional setSize(width, height): void;
+```
+
+Defined in: render/RenderBackend.ts:27
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `width` | `number` |
+| `height` | `number` |
+
+#### Returns
+
+`void`
+
+***
+
+### setPixelRatio()?
+
+```ts
+optional setPixelRatio(pixelRatio): void;
+```
+
+Defined in: render/RenderBackend.ts:28
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `pixelRatio` | `number` |
+
+#### Returns
+
+`void`
+
+***
+
+### dispose()
+
+```ts
+dispose(): void;
+```
+
+Defined in: render/RenderBackend.ts:29
+
+#### Returns
+
+`void`

package/dist/docs/api/index/interfaces/RenderBackend.md

@@ -0,0 +1,168 @@
+[**@relu-interactives/spatial-ecs**](../../index.md)
+
+***
+
+[@relu-interactives/spatial-ecs](../../index.md) / [index](../index.md) / RenderBackend
+
+# Interface: RenderBackend
+
+Defined in: render/RenderBackend.ts:63
+
+Everything renderer-specific the engine does, behind one small interface so
+a [World](../classes/World.md) can run on WebGL or WebGPU.
+
+The default is `webglBackend` (exported from the package root). For a
+`WebGPURenderer`, pass `webgpuBackend` from
+`@relu-interactives/spatial-ecs/webgpu`.
+
+## Properties
+
+| Property | Modifier | Type | Description | Defined in |
+| ------ | ------ | ------ | ------ | ------ |
+| <a id="kind"></a> `kind` | `readonly` | [`RendererKind`](../type-aliases/RendererKind.md) | Renderer family this backend drives. | render/RenderBackend.ts:65 |
+
+## Methods
+
+### install()?
+
+```ts
+optional install(world): void;
+```
+
+Defined in: render/RenderBackend.ts:67
+
+One-time renderer setup, called once from the `World` constructor.
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `world` | [`World`](../classes/World.md) |
+
+#### Returns
+
+`void`
+
+***
+
+### prepareAreaLights()?
+
+```ts
+optional prepareAreaLights(world): void;
+```
+
+Defined in: render/RenderBackend.ts:72
+
+Called the first time an area light (`RectAreaLight`) is created, so the
+backend can load the lookup tables those lights need. Optional.
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `world` | [`World`](../classes/World.md) |
+
+#### Returns
+
+`void`
+
+***
+
+### createPostprocessing()
+
+```ts
+createPostprocessing(context): PostprocessingPipeline | null;
+```
+
+Defined in: render/RenderBackend.ts:77
+
+Build the post-processing chain for `context.values`. Return `null` to
+render the scene directly (no chain).
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `context` | [`PostprocessingBuildContext`](PostprocessingBuildContext.md) |
+
+#### Returns
+
+[`PostprocessingPipeline`](PostprocessingPipeline.md) \| `null`
+
+***
+
+### updatePostprocessing()?
+
+```ts
+optional updatePostprocessing(
+   pipeline, 
+   previous, 
+   next): boolean;
+```
+
+Defined in: render/RenderBackend.ts:86
+
+Apply a values change to an existing chain without rebuilding it. Return
+`true` when the chain was updated in place, `false` when the change is
+structural (an effect switched on or off) and the caller must rebuild.
+When omitted, every change rebuilds.
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `pipeline` | [`PostprocessingPipeline`](PostprocessingPipeline.md) |
+| `previous` | [`PostprocessingState`](../../components/type-aliases/PostprocessingState.md) |
+| `next` | [`PostprocessingState`](../../components/type-aliases/PostprocessingState.md) |
+
+#### Returns
+
+`boolean`
+
+***
+
+### createChromaKeyMaterial()
+
+```ts
+createChromaKeyMaterial(texture, options): Material;
+```
+
+Defined in: render/RenderBackend.ts:92
+
+Material that renders `texture` with `options.keyColor` keyed out.
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `texture` | `Texture` |
+| `options` | [`ChromaKeyOptions`](ChromaKeyOptions.md) |
+
+#### Returns
+
+`Material`
+
+***
+
+### updateChromaKeyMaterial()
+
+```ts
+updateChromaKeyMaterial(material, options): boolean;
+```
+
+Defined in: render/RenderBackend.ts:101
+
+Push new options into a material made by [createChromaKeyMaterial](#createchromakeymaterial).
+Returns `false` when `material` is not one of this backend's chroma-key
+materials.
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `material` | `Material` |
+| `options` | [`ChromaKeyOptions`](ChromaKeyOptions.md) |
+
+#### Returns
+
+`boolean`

package/dist/docs/api/index/interfaces/StateMachine.md

@@ -6,21 +6,21 @@
 
 # Interface: StateMachine
 
-Defined in: [AnimationStateMachine.ts:3](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/AnimationStateMachine.ts#L3)
+Defined in: [AnimationStateMachine.ts:3](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/AnimationStateMachine.ts#L3)
 
 ## Properties
 
 | Property | Type | Defined in |
 | ------ | ------ | ------ |
-| <a id="name"></a> `name` | `string` | [AnimationStateMachine.ts:4](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/AnimationStateMachine.ts#L4) |
-| <a id="clip"></a> `clip` | `AnimationClip` | [AnimationStateMachine.ts:5](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/AnimationStateMachine.ts#L5) |
-| <a id="clipid"></a> `clipId` | `string` \| `null` | [AnimationStateMachine.ts:6](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/AnimationStateMachine.ts#L6) |
-| <a id="loop"></a> `loop` | `boolean` | [AnimationStateMachine.ts:7](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/AnimationStateMachine.ts#L7) |
-| <a id="isplaying"></a> `isPlaying` | `boolean` | [AnimationStateMachine.ts:8](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/AnimationStateMachine.ts#L8) |
-| <a id="ispaused"></a> `isPaused` | `boolean` | [AnimationStateMachine.ts:9](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/AnimationStateMachine.ts#L9) |
-| <a id="onstart"></a> `onStart` | () => `void` | [AnimationStateMachine.ts:10](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/AnimationStateMachine.ts#L10) |
-| <a id="onplaying"></a> `onPlaying` | () => `void` | [AnimationStateMachine.ts:11](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/AnimationStateMachine.ts#L11) |
-| <a id="onend"></a> `onEnd` | () => `void` | [AnimationStateMachine.ts:12](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/AnimationStateMachine.ts#L12) |
-| <a id="play"></a> `play` | () => `void` | [AnimationStateMachine.ts:13](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/AnimationStateMachine.ts#L13) |
-| <a id="pause"></a> `pause` | () => `void` | [AnimationStateMachine.ts:14](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/AnimationStateMachine.ts#L14) |
-| <a id="stop"></a> `stop` | () => `void` | [AnimationStateMachine.ts:15](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/AnimationStateMachine.ts#L15) |
+| <a id="name"></a> `name` | `string` | [AnimationStateMachine.ts:4](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/AnimationStateMachine.ts#L4) |
+| <a id="clip"></a> `clip` | `AnimationClip` | [AnimationStateMachine.ts:5](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/AnimationStateMachine.ts#L5) |
+| <a id="clipid"></a> `clipId` | `string` \| `null` | [AnimationStateMachine.ts:6](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/AnimationStateMachine.ts#L6) |
+| <a id="loop"></a> `loop` | `boolean` | [AnimationStateMachine.ts:7](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/AnimationStateMachine.ts#L7) |
+| <a id="isplaying"></a> `isPlaying` | `boolean` | [AnimationStateMachine.ts:8](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/AnimationStateMachine.ts#L8) |
+| <a id="ispaused"></a> `isPaused` | `boolean` | [AnimationStateMachine.ts:9](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/AnimationStateMachine.ts#L9) |
+| <a id="onstart"></a> `onStart` | () => `void` | [AnimationStateMachine.ts:10](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/AnimationStateMachine.ts#L10) |
+| <a id="onplaying"></a> `onPlaying` | () => `void` | [AnimationStateMachine.ts:11](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/AnimationStateMachine.ts#L11) |
+| <a id="onend"></a> `onEnd` | () => `void` | [AnimationStateMachine.ts:12](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/AnimationStateMachine.ts#L12) |
+| <a id="play"></a> `play` | () => `void` | [AnimationStateMachine.ts:13](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/AnimationStateMachine.ts#L13) |
+| <a id="pause"></a> `pause` | () => `void` | [AnimationStateMachine.ts:14](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/AnimationStateMachine.ts#L14) |
+| <a id="stop"></a> `stop` | () => `void` | [AnimationStateMachine.ts:15](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/AnimationStateMachine.ts#L15) |

package/dist/docs/api/index/type-aliases/AnimationStateCallbacks.md

@@ -14,12 +14,12 @@ type AnimationStateCallbacks = {
 };
 ```
 
-Defined in: [AnimationStateMachine.ts:18](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/AnimationStateMachine.ts#L18)
+Defined in: [AnimationStateMachine.ts:18](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/AnimationStateMachine.ts#L18)
 
 ## Properties
 
 | Property | Type | Defined in |
 | ------ | ------ | ------ |
-| <a id="onstart"></a> `onStart?` | () => `void` | [AnimationStateMachine.ts:19](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/AnimationStateMachine.ts#L19) |
-| <a id="onplaying"></a> `onPlaying?` | () => `void` | [AnimationStateMachine.ts:20](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/AnimationStateMachine.ts#L20) |
-| <a id="onend"></a> `onEnd?` | () => `void` | [AnimationStateMachine.ts:21](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/AnimationStateMachine.ts#L21) |
+| <a id="onstart"></a> `onStart?` | () => `void` | [AnimationStateMachine.ts:19](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/AnimationStateMachine.ts#L19) |
+| <a id="onplaying"></a> `onPlaying?` | () => `void` | [AnimationStateMachine.ts:20](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/AnimationStateMachine.ts#L20) |
+| <a id="onend"></a> `onEnd?` | () => `void` | [AnimationStateMachine.ts:21](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/AnimationStateMachine.ts#L21) |

package/dist/docs/api/index/type-aliases/ApplyPrefabToSnapshotResult.md

@@ -13,11 +13,11 @@ type ApplyPrefabToSnapshotResult = {
 };
 ```
 
-Defined in: [prefab/applyPrefabToSnapshot.ts:112](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/applyPrefabToSnapshot.ts#L112)
+Defined in: [prefab/applyPrefabToSnapshot.ts:112](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/prefab/applyPrefabToSnapshot.ts#L112)
 
 ## Properties
 
 | Property | Type | Defined in |
 | ------ | ------ | ------ |
-| <a id="snapshot"></a> `snapshot` | [`SubtreeSnapshot`](SubtreeSnapshot.md) | [prefab/applyPrefabToSnapshot.ts:113](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/applyPrefabToSnapshot.ts#L113) |
-| <a id="changed"></a> `changed` | `boolean` | [prefab/applyPrefabToSnapshot.ts:114](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/applyPrefabToSnapshot.ts#L114) |
+| <a id="snapshot"></a> `snapshot` | [`SubtreeSnapshot`](SubtreeSnapshot.md) | [prefab/applyPrefabToSnapshot.ts:113](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/prefab/applyPrefabToSnapshot.ts#L113) |
+| <a id="changed"></a> `changed` | `boolean` | [prefab/applyPrefabToSnapshot.ts:114](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/prefab/applyPrefabToSnapshot.ts#L114) |

package/dist/docs/api/index/type-aliases/ComponentFactory.md

@@ -10,7 +10,7 @@
 type ComponentFactory = (world, entityId, ...args) => unknown;
 ```
 
-Defined in: [systems/ObjectManagementSystem.ts:60](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/systems/ObjectManagementSystem.ts#L60)
+Defined in: [systems/ObjectManagementSystem.ts:79](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/systems/ObjectManagementSystem.ts#L79)
 
 ## Parameters