@relu-interactives/spatial-ecs 0.3.19 → 0.3.21

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

@@ -48,7 +48,8 @@ if (other) {
 Animate material transparency to create a pulsing ghost or reveal effect. Use `updateValue` so the state persists in the ECS snapshot — `MaterialSyncSystem` applies it to the live material each frame.
 
 ```typescript
-import { Behaviour, MaterialComponent } from "@relu-interactives/spatial-ecs";
+import { Behaviour } from "@relu-interactives/spatial-ecs";
+import { MaterialComponent } from "@relu-interactives/spatial-ecs/components";
 import type { FloatInput } from "@relu-interactives/spatial-ecs";
 
 export default class MaterialFade extends Behaviour {
@@ -64,14 +65,14 @@ export default class MaterialFade extends Behaviour {
     if (!mat) return;
 
     const opacity = (Math.sin(this.elapsed * this.data.speed) + 1) * 0.5;
-    mat.updateValue(0, 'transparent', true);
-    mat.updateValue(0, 'opacity', opacity);
+    mat.updateValue(0, { transparent: true });
+    mat.updateValue(0, { opacity: opacity });
   }
 }
 ```
 
 ::: warning Transient vs persistent opacity
-`mat.updateValue(0, 'opacity', value)` keeps `values[]` in sync with the live material — changes survive a project reload.
+`mat.updateValue(0, { opacity: value })` keeps `values[]` in sync with the live material — changes survive a project reload.
 
 Mutating `mat.material?.opacity` directly can work for transient visual-only effects, but `MaterialSyncSystem` may overwrite it when other material properties change. Prefer `updateValue` for any state you want to persist.
 :::
@@ -81,7 +82,8 @@ Mutating `mat.material?.opacity` directly can work for transient visual-only eff
 Let the inspector drive the diffuse color live without restarting the scene.
 
 ```typescript
-import { Behaviour, MaterialComponent } from "@relu-interactives/spatial-ecs";
+import { Behaviour } from "@relu-interactives/spatial-ecs";
+import { MaterialComponent } from "@relu-interactives/spatial-ecs/components";
 import type { ColorInput } from "@relu-interactives/spatial-ecs";
 
 export default class MaterialColorDriver extends Behaviour {
@@ -98,7 +100,7 @@ export default class MaterialColorDriver extends Behaviour {
 
     const mat = this.getComponent(MaterialComponent);
     if (!mat) return;
-    mat.updateValue(0, 'color', this.data.color);
+    mat.updateValue(0, { color: this.data.color });
   }
 }
 ```
@@ -114,9 +116,11 @@ You can also pick this component from the inspector using a `ComponentInput` fie
 ```typescript
 import {
   Behaviour,
-  MaterialComponent,
   type ComponentInput,
 } from "@relu-interactives/spatial-ecs";
+import {
+  MaterialComponent,
+} from "@relu-interactives/spatial-ecs/components";
 
 export default class Example extends Behaviour {
   data = {
@@ -141,10 +145,12 @@ Alternatively, pick an entity from the inspector using an `EntityInput` field an
 ```typescript
 import {
   Behaviour,
-  MaterialComponent,
   type EntityInput,
   type WorldEntityView,
 } from "@relu-interactives/spatial-ecs";
+import {
+  MaterialComponent,
+} from "@relu-interactives/spatial-ecs/components";
 
 export default class Example extends Behaviour {
   data = {

package/dist/docs/guide/components/mesh-geometry.md

@@ -43,7 +43,8 @@ if (other) {
 Let the inspector or game logic control whether the mesh casts and receives shadows.
 
 ```typescript
-import { Behaviour, MeshGeometryComponent } from "@relu-interactives/spatial-ecs";
+import { Behaviour } from "@relu-interactives/spatial-ecs";
+import { MeshGeometryComponent } from "@relu-interactives/spatial-ecs/components";
 import type { ToggleInput } from "@relu-interactives/spatial-ecs";
 
 export default class ShadowDriver extends Behaviour {
@@ -66,7 +67,8 @@ export default class ShadowDriver extends Behaviour {
 Pulse the radius of a sphere primitive by writing to its geometry `parameters` each frame. The mesh-geometry system rebuilds the `BufferGeometry` when parameters change.
 
 ```typescript
-import { Behaviour, MeshGeometryComponent } from "@relu-interactives/spatial-ecs";
+import { Behaviour } from "@relu-interactives/spatial-ecs";
+import { MeshGeometryComponent } from "@relu-interactives/spatial-ecs/components";
 import type { FloatInput } from "@relu-interactives/spatial-ecs";
 
 export default class SphereGrow extends Behaviour {
@@ -97,9 +99,11 @@ You can also pick this component from the inspector using a `ComponentInput` fie
 ```typescript
 import {
   Behaviour,
-  MeshGeometryComponent,
   type ComponentInput,
 } from "@relu-interactives/spatial-ecs";
+import {
+  MeshGeometryComponent,
+} from "@relu-interactives/spatial-ecs/components";
 
 export default class Example extends Behaviour {
   data = {
@@ -124,10 +128,12 @@ Alternatively, pick an entity from the inspector using an `EntityInput` field an
 ```typescript
 import {
   Behaviour,
-  MeshGeometryComponent,
   type EntityInput,
   type WorldEntityView,
 } from "@relu-interactives/spatial-ecs";
+import {
+  MeshGeometryComponent,
+} from "@relu-interactives/spatial-ecs/components";
 
 export default class Example extends Behaviour {
   data = {

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

@@ -39,7 +39,8 @@ if (other) {
 Walk the mesh hierarchy and enable or disable shadow casting based on a boolean inspector field.
 
 ```typescript
-import { Behaviour, MeshComponent } from "@relu-interactives/spatial-ecs";
+import { Behaviour } from "@relu-interactives/spatial-ecs";
+import { MeshComponent } from "@relu-interactives/spatial-ecs/components";
 import type { ToggleInput } from "@relu-interactives/spatial-ecs";
 
 export default class ShadowToggle extends Behaviour {
@@ -67,7 +68,8 @@ export default class ShadowToggle extends Behaviour {
 Access the underlying `THREE.Object3D` directly for low-level material mutations that are not exposed through `MaterialComponent`.
 
 ```typescript
-import { Behaviour, MeshComponent } from "@relu-interactives/spatial-ecs";
+import { Behaviour } from "@relu-interactives/spatial-ecs";
+import { MeshComponent } from "@relu-interactives/spatial-ecs/components";
 import type { ColorInput } from "@relu-interactives/spatial-ecs";
 
 export default class MeshColorDriver extends Behaviour {
@@ -99,9 +101,11 @@ You can also pick this component from the inspector using a `ComponentInput` fie
 ```typescript
 import {
   Behaviour,
-  MeshComponent,
   type ComponentInput,
 } from "@relu-interactives/spatial-ecs";
+import {
+  MeshComponent,
+} from "@relu-interactives/spatial-ecs/components";
 
 export default class Example extends Behaviour {
   data = {
@@ -126,10 +130,12 @@ Alternatively, pick an entity from the inspector using an `EntityInput` field an
 ```typescript
 import {
   Behaviour,
-  MeshComponent,
   type EntityInput,
   type WorldEntityView,
 } from "@relu-interactives/spatial-ecs";
+import {
+  MeshComponent,
+} from "@relu-interactives/spatial-ecs/components";
 
 export default class Example extends Behaviour {
   data = {

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

@@ -36,7 +36,8 @@ if (other) {
 Wait for the async model load to complete, then animate opacity to 1 over one second.
 
 ```typescript
-import { Behaviour, ModelComponent } from "@relu-interactives/spatial-ecs";
+import { Behaviour } from "@relu-interactives/spatial-ecs";
+import { ModelComponent } from "@relu-interactives/spatial-ecs/components";
 
 export default class ModelFadeIn extends Behaviour {
   private fadeProgress = 0;
@@ -72,7 +73,8 @@ export default class ModelFadeIn extends Behaviour {
 Show or hide the loaded model at runtime using the `Object3DRef` visibility flag.
 
 ```typescript
-import { Behaviour, ModelComponent, Object3DRef } from "@relu-interactives/spatial-ecs";
+import { Behaviour } from "@relu-interactives/spatial-ecs";
+import { ModelComponent, Object3DRef } from "@relu-interactives/spatial-ecs/components";
 import type { ToggleInput } from "@relu-interactives/spatial-ecs";
 
 export default class ModelVisibility extends Behaviour {

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

@@ -39,7 +39,8 @@ if (other) {
 Rename the entity at runtime from an inspector string field. Useful for dynamic labels or debug output.
 
 ```typescript
-import { Behaviour, Name } from "@relu-interactives/spatial-ecs";
+import { Behaviour } from "@relu-interactives/spatial-ecs";
+import { Name } from "@relu-interactives/spatial-ecs/components";
 import type { TextInput } from "@relu-interactives/spatial-ecs";
 
 export default class EntityRenamer extends Behaviour {
@@ -61,7 +62,8 @@ export default class EntityRenamer extends Behaviour {
 Query all `Name` components to locate a sibling entity and read its position.
 
 ```typescript
-import { Behaviour, Name, TransformComponent } from "@relu-interactives/spatial-ecs";
+import { Behaviour } from "@relu-interactives/spatial-ecs";
+import { Name, TransformComponent } from "@relu-interactives/spatial-ecs/components";
 import type { TextInput } from "@relu-interactives/spatial-ecs";
 
 export default class LookAtTarget extends Behaviour {
@@ -72,9 +74,10 @@ export default class LookAtTarget extends Behaviour {
   protected onUpdate() {
     let targetTransform: TransformComponent | null = null;
 
-    for (const [id, nameComp] of this.world.query([Name])) {
-      if (nameComp.value === this.data.targetName) {
-        targetTransform = this.world.getComponent(id, TransformComponent);
+    for (const id of this.world.query(Name)) {
+      const nameComp = this.world.getComponent(id, Name);
+      if (nameComp?.value === this.data.targetName) {
+        targetTransform = this.world.getComponent(id, TransformComponent) ?? null;
         break;
       }
     }
@@ -96,10 +99,12 @@ Alternatively, pick an entity from the inspector using an `EntityInput` field an
 ```typescript
 import {
   Behaviour,
-  Name,
   type EntityInput,
   type WorldEntityView,
 } from "@relu-interactives/spatial-ecs";
+import {
+  Name,
+} from "@relu-interactives/spatial-ecs/components";
 
 export default class Example extends Behaviour {
   data = {

package/dist/docs/guide/components/object3d-ref.md

@@ -38,7 +38,8 @@ if (other) {
 Expose a boolean that shows or hides the entity's scene object at runtime.
 
 ```typescript
-import { Behaviour, Object3DRef } from "@relu-interactives/spatial-ecs";
+import { Behaviour } from "@relu-interactives/spatial-ecs";
+import { Object3DRef } from "@relu-interactives/spatial-ecs/components";
 import type { ToggleInput } from "@relu-interactives/spatial-ecs";
 
 export default class VisibilityDriver extends Behaviour {
@@ -58,7 +59,8 @@ export default class VisibilityDriver extends Behaviour {
 Alternate visibility every half-second, useful for damage flashes or blinking pickups.
 
 ```typescript
-import { Behaviour, Object3DRef } from "@relu-interactives/spatial-ecs";
+import { Behaviour } from "@relu-interactives/spatial-ecs";
+import { Object3DRef } from "@relu-interactives/spatial-ecs/components";
 import type { FloatInput } from "@relu-interactives/spatial-ecs";
 
 export default class ObjectFlash extends Behaviour {
@@ -86,10 +88,12 @@ Alternatively, pick an entity from the inspector using an `EntityInput` field an
 ```typescript
 import {
   Behaviour,
-  Object3DRef,
   type EntityInput,
   type WorldEntityView,
 } from "@relu-interactives/spatial-ecs";
+import {
+  Object3DRef,
+} from "@relu-interactives/spatial-ecs/components";
 
 export default class Example extends Behaviour {
   data = {

package/dist/docs/guide/components/parent-id.md

@@ -36,7 +36,8 @@ if (other) {
 Set `ParentId.value` to `null` to reparent the entity to the scene root. The `ObjectManagementSystem` reconciles the actual scene-graph hierarchy every frame.
 
 ```typescript
-import { Behaviour, ParentId, KeyboardKeys } from "@relu-interactives/spatial-ecs";
+import { Behaviour, KeyboardKeys } from "@relu-interactives/spatial-ecs";
+import { ParentId } from "@relu-interactives/spatial-ecs/components";
 
 export default class DetachOnKey extends Behaviour {
   protected onUpdate() {
@@ -53,7 +54,8 @@ export default class DetachOnKey extends Behaviour {
 Assign a new parent entity ID to move the entity (and its children) under a different part of the hierarchy at runtime.
 
 ```typescript
-import { Behaviour, ParentId, Name, KeyboardKeys } from "@relu-interactives/spatial-ecs";
+import { Behaviour, KeyboardKeys } from "@relu-interactives/spatial-ecs";
+import { ParentId, Name } from "@relu-interactives/spatial-ecs/components";
 import type { TextInput } from "@relu-interactives/spatial-ecs";
 
 export default class Reparenter extends Behaviour {
@@ -66,8 +68,10 @@ export default class Reparenter extends Behaviour {
 
  // Find the target parent entity by name
     const parentEntity = this.world.getEntityByName(this.data.newParentName);
+    if (!parentEntity) return;
+
     const parent = this.getComponent(ParentId);
-    if (parent) parent.value = id;
+    if (parent) parent.value = parentEntity.entityId;
   }
 }
 ```
@@ -79,10 +83,12 @@ Alternatively, pick an entity from the inspector using an `EntityInput` field an
 ```typescript
 import {
   Behaviour,
-  ParentId,
   type EntityInput,
   type WorldEntityView,
 } from "@relu-interactives/spatial-ecs";
+import {
+  ParentId,
+} from "@relu-interactives/spatial-ecs/components";
 
 export default class Example extends Behaviour {
   data = {

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

@@ -1,6 +1,6 @@
 # Physics
 
-Combined rigid body and collider component backed by Rapier. `values.rigidbody.type` is one of `dynamic`, `fixed`, `kinematicPosition`, or `kinematicVelocity`. Per-axis translation/rotation locks constrain motion (e.g. lock Y rotation for top-down characters). Supported collider shapes: `cuboid`, `ball`, `capsule`, `cylinder`, `trimesh`. Set `values.collider.isSensor` to receive collision events without producing a physical response.
+Combined rigid body and collider component backed by Rapier. `values.rigidBody.type` is one of `dynamic`, `fixed`, `kinematicPosition`, or `kinematicVelocity`. Per-axis translation/rotation locks constrain motion (e.g. lock Y rotation for top-down characters). Supported collider shapes: `cuboid`, `ball`, `capsule`, `cylinder`, `trimesh`. Set `values.collider.isSensor` to receive collision events without producing a physical response.
 
 > **Managed by:** [`PhysicsSyncSystem`](../systems/physics-sync-system)
 
@@ -55,7 +55,8 @@ if (other) {
 Apply a one-shot upward impulse to a dynamic rigid body when the player presses Space.
 
 ```typescript
-import { Behaviour, PhysicsComponent, KeyboardKeys } from "@relu-interactives/spatial-ecs";
+import { Behaviour, KeyboardKeys } from "@relu-interactives/spatial-ecs";
+import { PhysicsComponent } from "@relu-interactives/spatial-ecs/components";
 import type { FloatInput } from "@relu-interactives/spatial-ecs";
 
 export default class Jumper extends Behaviour {
@@ -79,7 +80,8 @@ export default class Jumper extends Behaviour {
 Displace a `kinematicPosition` body each frame using the Rapier `setNextKinematicTranslation` API.
 
 ```typescript
-import { Behaviour, PhysicsComponent, KeyboardKeys } from "@relu-interactives/spatial-ecs";
+import { Behaviour, KeyboardKeys } from "@relu-interactives/spatial-ecs";
+import { PhysicsComponent } from "@relu-interactives/spatial-ecs/components";
 import type { FloatInput } from "@relu-interactives/spatial-ecs";
 
 export default class KinematicMover extends Behaviour {
@@ -116,9 +118,11 @@ You can also pick this component from the inspector using a `ComponentInput` fie
 ```typescript
 import {
   Behaviour,
-  PhysicsComponent,
   type ComponentInput,
 } from "@relu-interactives/spatial-ecs";
+import {
+  PhysicsComponent,
+} from "@relu-interactives/spatial-ecs/components";
 
 export default class Example extends Behaviour {
   data = {
@@ -143,10 +147,12 @@ Alternatively, pick an entity from the inspector using an `EntityInput` field an
 ```typescript
 import {
   Behaviour,
-  PhysicsComponent,
   type EntityInput,
   type WorldEntityView,
 } from "@relu-interactives/spatial-ecs";
+import {
+  PhysicsComponent,
+} from "@relu-interactives/spatial-ecs/components";
 
 export default class Example extends Behaviour {
   data = {
@@ -169,5 +175,5 @@ export default class Example extends Behaviour {
 
 
 ::: tip Rigid body type
-Set `values.rigidbody.type` to `"kinematicPosition"` in the inspector for the second example. Applying impulses requires a `"dynamic"` rigid body.
+Set `values.rigidBody.type` to `"kinematicPosition"` in the inspector for the second example. Applying impulses requires a `"dynamic"` rigid body.
 :::

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

@@ -43,7 +43,8 @@ if (other) {
 `ScriptComponent.scriptInstances` maps entity IDs to their compiled behaviour instances. You can cast an instance to a known shape and call public methods on it, enabling script-to-script communication.
 
 ```typescript
-import { Behaviour, ScriptComponent } from "@relu-interactives/spatial-ecs";
+import { Behaviour } from "@relu-interactives/spatial-ecs";
+import { ScriptComponent } from "@relu-interactives/spatial-ecs/components";
 
 // Assumes another script on this entity exposes a `reset()` method.
 export default class ScriptBridge extends Behaviour {
@@ -65,7 +66,8 @@ export default class ScriptBridge extends Behaviour {
 Read the authored `entries` array to find which scripts are attached and inspect their saved field overrides.
 
 ```typescript
-import { Behaviour, ScriptComponent } from "@relu-interactives/spatial-ecs";
+import { Behaviour } from "@relu-interactives/spatial-ecs";
+import { ScriptComponent } from "@relu-interactives/spatial-ecs/components";
 
 export default class ScriptInspector extends Behaviour {
   protected init() {
@@ -86,9 +88,11 @@ You can also pick this component from the inspector using a `ComponentInput` fie
 ```typescript
 import {
   Behaviour,
-  ScriptComponent,
   type ComponentInput,
 } from "@relu-interactives/spatial-ecs";
+import {
+  ScriptComponent,
+} from "@relu-interactives/spatial-ecs/components";
 
 export default class Example extends Behaviour {
   data = {
@@ -113,10 +117,12 @@ Alternatively, pick an entity from the inspector using an `EntityInput` field an
 ```typescript
 import {
   Behaviour,
-  ScriptComponent,
   type EntityInput,
   type WorldEntityView,
 } from "@relu-interactives/spatial-ecs";
+import {
+  ScriptComponent,
+} from "@relu-interactives/spatial-ecs/components";
 
 export default class Example extends Behaviour {
   data = {

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

@@ -43,7 +43,8 @@ if (other) {
 Animate the sprite's width and height to create a breathing or highlight effect. The initial dimensions are captured on `init` so the pulse is relative to the authored size.
 
 ```typescript
-import { Behaviour, SpriteComponent } from "@relu-interactives/spatial-ecs";
+import { Behaviour } from "@relu-interactives/spatial-ecs";
+import { SpriteComponent } from "@relu-interactives/spatial-ecs/components";
 import type { FloatInput } from "@relu-interactives/spatial-ecs";
 
 export default class SpritePulse extends Behaviour {
@@ -81,7 +82,8 @@ export default class SpritePulse extends Behaviour {
 Show or hide the sprite by toggling `Object3DRef.visibility`.
 
 ```typescript
-import { Behaviour, Object3DRef, KeyboardKeys } from "@relu-interactives/spatial-ecs";
+import { Behaviour, KeyboardKeys } from "@relu-interactives/spatial-ecs";
+import { Object3DRef } from "@relu-interactives/spatial-ecs/components";
 
 export default class SpriteToggle extends Behaviour {
   private visible = true;
@@ -103,9 +105,11 @@ You can also pick this component from the inspector using a `ComponentInput` fie
 ```typescript
 import {
   Behaviour,
-  SpriteComponent,
   type ComponentInput,
 } from "@relu-interactives/spatial-ecs";
+import {
+  SpriteComponent,
+} from "@relu-interactives/spatial-ecs/components";
 
 export default class Example extends Behaviour {
   data = {
@@ -130,10 +134,12 @@ Alternatively, pick an entity from the inspector using an `EntityInput` field an
 ```typescript
 import {
   Behaviour,
-  SpriteComponent,
   type EntityInput,
   type WorldEntityView,
 } from "@relu-interactives/spatial-ecs";
+import {
+  SpriteComponent,
+} from "@relu-interactives/spatial-ecs/components";
 
 export default class Example extends Behaviour {
   data = {

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

@@ -99,9 +99,11 @@ You can also pick this component from the inspector using a `ComponentInput` fie
 ```typescript
 import {
   Behaviour,
-  TransformComponent,
   type ComponentInput,
 } from "@relu-interactives/spatial-ecs";
+import {
+  TransformComponent,
+} from "@relu-interactives/spatial-ecs/components";
 
 export default class Example extends Behaviour {
   data = {
@@ -126,10 +128,12 @@ Alternatively, pick an entity from the inspector using an `EntityInput` field an
 ```typescript
 import {
   Behaviour,
-  TransformComponent,
   type EntityInput,
   type WorldEntityView,
 } from "@relu-interactives/spatial-ecs";
+import {
+  TransformComponent,
+} from "@relu-interactives/spatial-ecs/components";
 
 export default class Example extends Behaviour {
   data = {

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

@@ -49,7 +49,8 @@ if (other) {
 Toggle video playback when the player presses Space.
 
 ```typescript
-import { Behaviour, VideoComponent, KeyboardKeys } from "@relu-interactives/spatial-ecs";
+import { Behaviour, KeyboardKeys } from "@relu-interactives/spatial-ecs";
+import { VideoComponent } from "@relu-interactives/spatial-ecs/components";
 
 export default class VideoController extends Behaviour {
   protected onUpdate() {
@@ -72,7 +73,8 @@ export default class VideoController extends Behaviour {
 Expose volume and loop settings as inspector fields so they can be tuned without re-entering the code.
 
 ```typescript
-import { Behaviour, VideoComponent } from "@relu-interactives/spatial-ecs";
+import { Behaviour } from "@relu-interactives/spatial-ecs";
+import { VideoComponent } from "@relu-interactives/spatial-ecs/components";
 import type { FloatInput, ToggleInput } from "@relu-interactives/spatial-ecs";
 
 export default class VideoSettings extends Behaviour {
@@ -97,9 +99,11 @@ You can also pick this component from the inspector using a `ComponentInput` fie
 ```typescript
 import {
   Behaviour,
-  VideoComponent,
   type ComponentInput,
 } from "@relu-interactives/spatial-ecs";
+import {
+  VideoComponent,
+} from "@relu-interactives/spatial-ecs/components";
 
 export default class Example extends Behaviour {
   data = {
@@ -124,10 +128,12 @@ Alternatively, pick an entity from the inspector using an `EntityInput` field an
 ```typescript
 import {
   Behaviour,
-  VideoComponent,
   type EntityInput,
   type WorldEntityView,
 } from "@relu-interactives/spatial-ecs";
+import {
+  VideoComponent,
+} from "@relu-interactives/spatial-ecs/components";
 
 export default class Example extends Behaviour {
   data = {

package/dist/docs/guide/prefabs.md

@@ -145,6 +145,8 @@ register a resolver that maps them onto the deployed `assets/` folder:
 ```ts
 import { setPrefabAssetUrlResolver } from "@relu-interactives/spatial-ecs";
 
+declare function rewriteToMyCdn(url: string): string;
+
 setPrefabAssetUrlResolver((url) => rewriteToMyCdn(url));
 ```
 

package/dist/docs/guide/runtime-entity-management.md

@@ -64,7 +64,7 @@ export default class Tagger extends Behaviour {
     const entity = this.world.getEntityByName("Target");
     if (!entity) return;
 
-    this.world.addComponent(entity.entityId, new Name({ value: "Tagged" }));
+    this.world.addComponent(entity.entityId, new Name("Tagged"));
   }
 }
 ```

package/dist/docs/guide/spawning/instanced-mesh.md

@@ -85,7 +85,8 @@ The asset loads asynchronously. `InstancedMeshSystem` rebuilds the instanced mes
 Each slot is a separate entity. To add more instances after the group is created, use `requestCreate("instanceSlot")` and push the new ID into the group component:
 
 ```typescript
-import { Behaviour, InstancedMeshComponent } from "@relu-interactives/spatial-ecs";
+import { Behaviour } from "@relu-interactives/spatial-ecs";
+import { InstancedMeshComponent } from "@relu-interactives/spatial-ecs/components";
 
 export default class AddInstances extends Behaviour {
   protected init() {
@@ -135,7 +136,7 @@ export default class AddInstances extends Behaviour {
 
 ```typescript
 import { Behaviour } from "@relu-interactives/spatial-ecs";
-import { InstancedMeshComponent } from "@relu-interactives/spatial-ecs";
+import { InstancedMeshComponent } from "@relu-interactives/spatial-ecs/components";
 
 export default class CubeGrid extends Behaviour {
   private groupId: number | null = null;
@@ -193,9 +194,11 @@ Mutate the `TransformComponent` of the slot entity. `InstancedMeshSystem` picks
 ```typescript
 import {
   Behaviour,
+} from "@relu-interactives/spatial-ecs";
+import {
   InstancedMeshComponent,
   TransformComponent,
-} from "@relu-interactives/spatial-ecs";
+} from "@relu-interactives/spatial-ecs/components";
 
 export default class OrbitInstances extends Behaviour {
   private elapsed = 0;
@@ -208,7 +211,7 @@ export default class OrbitInstances extends Behaviour {
 
     for (let i = 0; i < instanced.instanceEntityIds.length; i++) {
       const slotId = instanced.instanceEntityIds[i];
-      const transform = this.world.getComponentById(slotId, TransformComponent);
+      const transform = this.world.getComponent(slotId, TransformComponent);
       if (!transform) continue;
 
       const angle = this.elapsed + (i / instanced.instanceEntityIds.length) * Math.PI * 2;
@@ -225,7 +228,8 @@ export default class OrbitInstances extends Behaviour {
 Update the group component's fields. `InstancedMeshSystem` detects the change and rebuilds:
 
 ```typescript
-import { Behaviour, InstancedMeshComponent } from "@relu-interactives/spatial-ecs";
+import { Behaviour } from "@relu-interactives/spatial-ecs";
+import { InstancedMeshComponent } from "@relu-interactives/spatial-ecs/components";
 
 export default class ExpandSpheres extends Behaviour {
   protected onUpdate() {
@@ -244,7 +248,8 @@ export default class ExpandSpheres extends Behaviour {
 Remove the slot entity from the world and splice its ID out of the group:
 
 ```typescript
-import { Behaviour, InstancedMeshComponent } from "@relu-interactives/spatial-ecs";
+import { Behaviour } from "@relu-interactives/spatial-ecs";
+import { InstancedMeshComponent } from "@relu-interactives/spatial-ecs/components";
 
 export default class RemoveLastInstance extends Behaviour {
   protected init() {

package/dist/docs/guide/systems/input-system.md

@@ -149,12 +149,15 @@ Toggle visibility on Space, fire on left-click.
 
 ```ts
 import { KeyboardKeys, Behaviour } from "@relu-interactives/spatial-ecs";
+import { Object3DRef } from "@relu-interactives/spatial-ecs/components";
 
 export default class ActionHandler extends Behaviour {
   protected onUpdate() {
     // getKeyDown fires only on the first frame the key is pressed.
     if (this.world.getKeyDown(KeyboardKeys.Space)) {
-      this.transform.visible = !this.transform.visible;
+      // Visibility lives on Object3DRef, not on the transform.
+      const ref = this.getComponent(Object3DRef);
+      if (ref) ref.visibility = !ref.visibility;
     }
 
     // Left mouse button

package/dist/docs/guide/systems/script-object-system.md

@@ -29,7 +29,15 @@ The `moduleLoader` owns cache-busting: with the default dynamic-import loader th
 Construct it and pass it to `World.setup`:
 
 ```ts
-import { ScriptObjectSystem } from "@relu-interactives/spatial-ecs";
+import {
+  ScriptObjectSystem,
+  World,
+  type ModuleLoader,
+} from "@relu-interactives/spatial-ecs";
+
+declare const world: World;
+// Resolves a script URL to its ES module — the templates supply this.
+declare const myModuleLoader: ModuleLoader;
 
 world.setup({
   systems: [new ScriptObjectSystem(myModuleLoader)],