@relu-interactives/spatial-ecs 0.3.19 → 0.3.21

package/dist/docs/guide/accessing-components.md

@@ -89,11 +89,12 @@ export default class Jumper extends Behaviour {
       true, // wake the body if sleeping
     );
 
-    // Change mass at runtime
-    this.physics.rigidbody.mass = 2;
+    // Change mass at runtime. Rapier exposes `mass()` as a READ-ONLY getter —
+    // extra mass is added rather than assigned.
+    this.physics.rigidBody.setAdditionalMass(2, true);
 
-    // Lock rotation so the body can't tip over
-    this.physics.rigidbody.lockRotations = true;
+    // Lock rotation so the body can't tip over (locked, wakeUp)
+    this.physics.rigidBody.lockRotations(true, true);
   }
 }
 ```
@@ -296,7 +297,7 @@ export default class MaterialSwap extends Behaviour {
     if (!this.mat) return;
 
     // applyValues patches one or more fields on a slot (default slot index 0)
-    this.mat.applyValues(0, {
+    this.mat.updateValue(0, {
       color:     this.data.color,
       roughness: this.data.roughness,
       metalness: this.data.metalness,
@@ -410,7 +411,7 @@ export default class Tagger extends Behaviour {
     if (!entity) return;
 
     // Give the entity a display name
-    this.world.addComponent(entity.entityId, new Name({ value: "Tagged" }));
+    this.world.addComponent(entity.entityId, new Name("Tagged"));
   }
 }
 ```

package/dist/docs/guide/behaviour-data-binding/component-input.md

@@ -15,8 +15,8 @@ import { Behaviour, type ComponentInput } from "@relu-interactives/spatial-ecs";
 
 export default class Demo extends Behaviour {
   data = {
-    cam:   { type: "component", componentKind: "CameraComponent", value: null } as ComponentInput,
-    audio: { type: "component", componentKind: "AudioComponent",  value: null } as ComponentInput,
+    cam:   { type: "component", componentKind: "Camera", value: null } as ComponentInput,
+    audio: { type: "component", componentKind: "Audio",  value: null } as ComponentInput,
   };
 }
 ```
@@ -28,13 +28,15 @@ At runtime, `.value` is resolved to the **live component instance**. Cast to the
 ```ts
 import {
   Behaviour,
-  CameraComponent,
   type ComponentInput,
 } from "@relu-interactives/spatial-ecs";
+import {
+  CameraComponent,
+} from "@relu-interactives/spatial-ecs/components";
 
 export default class FovReader extends Behaviour {
   data = {
-    camera: { type: "component", componentKind: "CameraComponent", value: null } as ComponentInput,
+    camera: { type: "component", componentKind: "Camera", value: null } as ComponentInput,
   };
 
   onUpdate() {
@@ -53,14 +55,16 @@ Mutate the instance directly — the system that owns the component picks up cha
 ```ts
 import {
   Behaviour,
-  CameraComponent,
   type ComponentInput,
   type FloatInput,
 } from "@relu-interactives/spatial-ecs";
+import {
+  CameraComponent,
+} from "@relu-interactives/spatial-ecs/components";
 
 export default class FovAnimator extends Behaviour {
   data = {
-    camera:    { type: "component", componentKind: "CameraComponent", value: null } as ComponentInput,
+    camera:    { type: "component", componentKind: "Camera", value: null } as ComponentInput,
     targetFov: 90 as FloatInput,
     speed:     30 as FloatInput,
   };

package/dist/docs/guide/behaviour-data-binding/entity-input.md

@@ -23,11 +23,17 @@ export default class Demo extends Behaviour {
 At runtime, `.value` is resolved to a **`WorldEntityView`** — not a raw ID. Always guard for `null` (no entity selected):
 
 ```ts
-import { type WorldEntityView } from "@relu-interactives/spatial-ecs";
+import { Behaviour, type EntityInput, type WorldEntityView } from "@relu-interactives/spatial-ecs";
 
-onUpdate() {
-  const target = this.data.target.value as WorldEntityView | null;
-  if (!target) return; // no entity assigned in the inspector
+export default class FollowTarget extends Behaviour {
+  data = {
+    target: { type: "entity", value: null } as unknown as EntityInput,
+  };
+
+  onUpdate() {
+    const target = this.data.target.value as WorldEntityView | null;
+    if (!target) return; // no entity assigned in the inspector
+  }
 }
 ```
 
@@ -69,11 +75,13 @@ Use the entity's `components` array to find and mutate a specific component:
 ```ts
 import {
   Behaviour,
-  TransformComponent,
   type EntityInput,
   type WorldEntityView,
   type FloatInput,
 } from "@relu-interactives/spatial-ecs";
+import {
+  TransformComponent,
+} from "@relu-interactives/spatial-ecs/components";
 
 export default class Mover extends Behaviour {
   data = {

package/dist/docs/guide/camera-rigs.md

@@ -166,7 +166,7 @@ Two cooperating scripts: the **camera** orbits behind the character under pointe
 
 ```ts
 // ThirdPersonCamera.ts — attach to the CAMERA entity
-import { Behaviour } from "@relu-interactives/spatial-ecs";
+import { Behaviour, KeyboardKeys } from "@relu-interactives/spatial-ecs";
 import type { FloatInput, TextInput } from "@relu-interactives/spatial-ecs";
 import {
   PhysicsComponent,
@@ -220,7 +220,7 @@ export default class ThirdPersonCamera extends Behaviour {
 
     // Pointer lock on click; Escape releases it.
     if (this.world.getMouseDown("left")) this.world.lockMousePointer();
-    if (this.world.getKeyDown("Escape")) this.world.unlockMousePointer();
+    if (this.world.getKeyDown(KeyboardKeys.Escape)) this.world.unlockMousePointer();
 
     // Orbit with the mouse while locked.
     if (this.world.isMousePointerLocked()) {

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

@@ -52,7 +52,8 @@ if (other) {
 Transition between an idle and a walk state based on arrow-key input. The cross-fade duration is set from the inspector.
 
 ```typescript
-import { Behaviour, AnimationComponent, KeyboardKeys } from "@relu-interactives/spatial-ecs";
+import { Behaviour, KeyboardKeys } from "@relu-interactives/spatial-ecs";
+import { AnimationComponent } from "@relu-interactives/spatial-ecs/components";
 import type { TextInput, FloatInput } from "@relu-interactives/spatial-ecs";
 
 export default class AnimationController extends Behaviour {
@@ -90,7 +91,8 @@ export default class AnimationController extends Behaviour {
 Drive `timeScale` and `paused` live from inspector fields, useful for slow-motion or freeze effects.
 
 ```typescript
-import { Behaviour, AnimationComponent } from "@relu-interactives/spatial-ecs";
+import { Behaviour } from "@relu-interactives/spatial-ecs";
+import { AnimationComponent } from "@relu-interactives/spatial-ecs/components";
 import type { FloatInput, ToggleInput } from "@relu-interactives/spatial-ecs";
 
 export default class AnimationSpeedDriver extends Behaviour {
@@ -130,7 +132,8 @@ anim.addState({ name: "Walk", clip: "Walk", loop: true }); // ← broken
 Guard on `availableClips.length > 0` inside `onUpdate` until the model is ready, then register states once:
 
 ```typescript
-import { Behaviour, AnimationComponent } from "@relu-interactives/spatial-ecs";
+import { Behaviour } from "@relu-interactives/spatial-ecs";
+import { AnimationComponent } from "@relu-interactives/spatial-ecs/components";
 
 export default class AnimSetup extends Behaviour {
   private ready = false;
@@ -158,9 +161,11 @@ You can also pick this component from the inspector using a `ComponentInput` fie
 ```typescript
 import {
   Behaviour,
-  AnimationComponent,
   type ComponentInput,
 } from "@relu-interactives/spatial-ecs";
+import {
+  AnimationComponent,
+} from "@relu-interactives/spatial-ecs/components";
 
 export default class Example extends Behaviour {
   data = {
@@ -185,10 +190,12 @@ Alternatively, pick an entity from the inspector using an `EntityInput` field an
 ```typescript
 import {
   Behaviour,
-  AnimationComponent,
   type EntityInput,
   type WorldEntityView,
 } from "@relu-interactives/spatial-ecs";
+import {
+  AnimationComponent,
+} from "@relu-interactives/spatial-ecs/components";
 
 export default class Example extends Behaviour {
   data = {

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

@@ -46,7 +46,8 @@ if (other) {
 Toggle audio playback when the player presses Space. Volume is exposed as an inspector field.
 
 ```typescript
-import { Behaviour, AudioComponent, KeyboardKeys } from "@relu-interactives/spatial-ecs";
+import { Behaviour, KeyboardKeys } from "@relu-interactives/spatial-ecs";
+import { AudioComponent } from "@relu-interactives/spatial-ecs/components";
 import type { FloatInput } from "@relu-interactives/spatial-ecs";
 
 export default class AudioController extends Behaviour {
@@ -82,7 +83,8 @@ export default class AudioController extends Behaviour {
 Start playing when the camera comes within a configurable range, and stop when it moves away.
 
 ```typescript
-import { Behaviour, AudioComponent, TransformComponent, CameraComponent } from "@relu-interactives/spatial-ecs";
+import { Behaviour } from "@relu-interactives/spatial-ecs";
+import { AudioComponent, TransformComponent, CameraComponent } from "@relu-interactives/spatial-ecs/components";
 import type { FloatInput } from "@relu-interactives/spatial-ecs";
 
 export default class ProximityAudio extends Behaviour {
@@ -96,8 +98,9 @@ export default class ProximityAudio extends Behaviour {
 
     // Find the default camera entity
     let cameraPos = { x: 0, y: 0, z: 0 };
-    for (const [id, cam] of this.world.query([CameraComponent])) {
-      if (cam.isDefault) {
+    for (const id of this.world.query(CameraComponent)) {
+      const cam = this.world.getComponent(id, CameraComponent);
+      if (cam?.isDefault) {
         const ct = this.world.getComponent(id, TransformComponent);
         if (ct) cameraPos = ct.position;
         break;
@@ -129,9 +132,11 @@ You can also pick this component from the inspector using a `ComponentInput` fie
 ```typescript
 import {
   Behaviour,
-  AudioComponent,
   type ComponentInput,
 } from "@relu-interactives/spatial-ecs";
+import {
+  AudioComponent,
+} from "@relu-interactives/spatial-ecs/components";
 
 export default class Example extends Behaviour {
   data = {
@@ -156,10 +161,12 @@ Alternatively, pick an entity from the inspector using an `EntityInput` field an
 ```typescript
 import {
   Behaviour,
-  AudioComponent,
   type EntityInput,
   type WorldEntityView,
 } from "@relu-interactives/spatial-ecs";
+import {
+  AudioComponent,
+} from "@relu-interactives/spatial-ecs/components";
 
 export default class Example extends Behaviour {
   data = {

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

@@ -52,7 +52,8 @@ if (other) {
 Smoothly lerp the field-of-view toward a zoomed-in value while Shift is held, then lerp back out.
 
 ```typescript
-import { Behaviour, CameraComponent, KeyboardKeys } from "@relu-interactives/spatial-ecs";
+import { Behaviour, KeyboardKeys } from "@relu-interactives/spatial-ecs";
+import { CameraComponent } from "@relu-interactives/spatial-ecs/components";
 import type { FloatInput } from "@relu-interactives/spatial-ecs";
 
 export default class CameraZoom extends Behaviour {
@@ -91,7 +92,8 @@ export default class CameraZoom extends Behaviour {
 Rotate the camera entity's position around the scene origin at a configurable radius and height.
 
 ```typescript
-import { Behaviour, CameraComponent } from "@relu-interactives/spatial-ecs";
+import { Behaviour } from "@relu-interactives/spatial-ecs";
+import { CameraComponent } from "@relu-interactives/spatial-ecs/components";
 import type { FloatInput } from "@relu-interactives/spatial-ecs";
 
 export default class OrbitCamera extends Behaviour {
@@ -127,9 +129,11 @@ You can also pick this component from the inspector using a `ComponentInput` fie
 ```typescript
 import {
   Behaviour,
-  CameraComponent,
   type ComponentInput,
 } from "@relu-interactives/spatial-ecs";
+import {
+  CameraComponent,
+} from "@relu-interactives/spatial-ecs/components";
 
 export default class Example extends Behaviour {
   data = {
@@ -154,10 +158,12 @@ Alternatively, pick an entity from the inspector using an `EntityInput` field an
 ```typescript
 import {
   Behaviour,
-  CameraComponent,
   type EntityInput,
   type WorldEntityView,
 } from "@relu-interactives/spatial-ecs";
+import {
+  CameraComponent,
+} from "@relu-interactives/spatial-ecs/components";
 
 export default class Example extends Behaviour {
   data = {

package/dist/docs/guide/components/entity-type.md

@@ -35,7 +35,8 @@ if (other) {
 Branch behaviour based on what kind of entity this script is attached to.
 
 ```typescript
-import { Behaviour, EntityType } from "@relu-interactives/spatial-ecs";
+import { Behaviour } from "@relu-interactives/spatial-ecs";
+import { EntityType } from "@relu-interactives/spatial-ecs/components";
 
 export default class TypeAwareSetup extends Behaviour {
   protected init() {
@@ -58,7 +59,8 @@ export default class TypeAwareSetup extends Behaviour {
 Iterate all entities in the scene and apply logic only to those of a specific type.
 
 ```typescript
-import { Behaviour, EntityType, TransformComponent } from "@relu-interactives/spatial-ecs";
+import { Behaviour } from "@relu-interactives/spatial-ecs";
+import { EntityType, TransformComponent } from "@relu-interactives/spatial-ecs/components";
 import type { TextInput, FloatInput } from "@relu-interactives/spatial-ecs";
 
 export default class TypeFilter extends Behaviour {
@@ -68,8 +70,9 @@ export default class TypeFilter extends Behaviour {
   };
 
   protected onUpdate() {
-    for (const [id, entityType] of this.world.query([EntityType])) {
-      if (entityType.value !== this.data.targetKind) continue;
+    for (const id of this.world.query(EntityType)) {
+      const entityType = this.world.getComponent(id, EntityType);
+      if (entityType?.value !== this.data.targetKind) continue;
 
       const t = this.world.getComponent(id, TransformComponent);
       if (t) t.rotation.y += this.data.spinSpeed * this.deltaTime;
@@ -89,9 +92,11 @@ You can also pick this component from the inspector using a `ComponentInput` fie
 ```typescript
 import {
   Behaviour,
-  EntityType,
   type ComponentInput,
 } from "@relu-interactives/spatial-ecs";
+import {
+  EntityType,
+} from "@relu-interactives/spatial-ecs/components";
 
 export default class Example extends Behaviour {
   data = {
@@ -116,10 +121,12 @@ Alternatively, pick an entity from the inspector using an `EntityInput` field an
 ```typescript
 import {
   Behaviour,
-  EntityType,
   type EntityInput,
   type WorldEntityView,
 } from "@relu-interactives/spatial-ecs";
+import {
+  EntityType,
+} from "@relu-interactives/spatial-ecs/components";
 
 export default class Example extends Behaviour {
   data = {

package/dist/docs/guide/components/image-target-anchor.md

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

package/dist/docs/guide/components/image-target.md

@@ -43,16 +43,17 @@ if (other) {
 The image-tracking system reveals the entity when its target is detected and hides it when lost. Attach this script to a child entity that has `ImageTargetAnchor` to run logic on those transitions.
 
 ```typescript
-import { Behaviour, Object3DRef, AudioComponent } from "@relu-interactives/spatial-ecs";
+import { Behaviour } from "@relu-interactives/spatial-ecs";
+import { Object3DRef, AudioComponent } from "@relu-interactives/spatial-ecs/components";
 
 export default class TargetFoundReactor extends Behaviour {
-  private onTargetFound() {
+  onTargetFound() {
     // Play audio, trigger animation, spawn objects, etc.
     const audio = this.getComponent(AudioComponent);
     audio?.play();
   }
 
-  private onTargetLost() {
+  onTargetLost() {
     const audio = this.getComponent(AudioComponent);
     audio?.stop();
   }
@@ -70,9 +71,11 @@ You can also pick this component from the inspector using a `ComponentInput` fie
 ```typescript
 import {
   Behaviour,
-  ImageTarget,
   type ComponentInput,
 } from "@relu-interactives/spatial-ecs";
+import {
+  ImageTarget,
+} from "@relu-interactives/spatial-ecs/components";
 
 export default class Example extends Behaviour {
   data = {
@@ -97,10 +100,12 @@ Alternatively, pick an entity from the inspector using an `EntityInput` field an
 ```typescript
 import {
   Behaviour,
-  ImageTarget,
   type EntityInput,
   type WorldEntityView,
 } from "@relu-interactives/spatial-ecs";
+import {
+  ImageTarget,
+} from "@relu-interactives/spatial-ecs/components";
 
 export default class Example extends Behaviour {
   data = {

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

@@ -43,7 +43,8 @@ if (other) {
 Lerp the image quad's dimensions toward inspector-defined target values, useful for animated UI reveals or zoom effects.
 
 ```typescript
-import { Behaviour, ImageComponent } from "@relu-interactives/spatial-ecs";
+import { Behaviour } from "@relu-interactives/spatial-ecs";
+import { ImageComponent } from "@relu-interactives/spatial-ecs/components";
 import type { FloatInput } from "@relu-interactives/spatial-ecs";
 
 export default class ImageResizer extends Behaviour {
@@ -69,7 +70,8 @@ export default class ImageResizer extends Behaviour {
 Drive the quad's visibility from the inspector or from game logic via `Object3DRef`.
 
 ```typescript
-import { Behaviour, ImageComponent, Object3DRef } from "@relu-interactives/spatial-ecs";
+import { Behaviour } from "@relu-interactives/spatial-ecs";
+import { ImageComponent, Object3DRef } from "@relu-interactives/spatial-ecs/components";
 import type { ToggleInput } from "@relu-interactives/spatial-ecs";
 
 export default class ImageVisibility extends Behaviour {
@@ -94,9 +96,11 @@ You can also pick this component from the inspector using a `ComponentInput` fie
 ```typescript
 import {
   Behaviour,
-  ImageComponent,
   type ComponentInput,
 } from "@relu-interactives/spatial-ecs";
+import {
+  ImageComponent,
+} from "@relu-interactives/spatial-ecs/components";
 
 export default class Example extends Behaviour {
   data = {
@@ -121,10 +125,12 @@ Alternatively, pick an entity from the inspector using an `EntityInput` field an
 ```typescript
 import {
   Behaviour,
-  ImageComponent,
   type EntityInput,
   type WorldEntityView,
 } from "@relu-interactives/spatial-ecs";
+import {
+  ImageComponent,
+} from "@relu-interactives/spatial-ecs/components";
 
 export default class Example extends Behaviour {
   data = {

package/dist/docs/guide/components/instance-slot.md

@@ -40,9 +40,11 @@ if (other) {
 ```typescript
 import {
   Behaviour,
+} from "@relu-interactives/spatial-ecs";
+import {
   InstanceSlotComponent,
   InstancedMeshComponent,
-} from "@relu-interactives/spatial-ecs";
+} from "@relu-interactives/spatial-ecs/components";
 
 export default class SlotInfo extends Behaviour {
   protected init() {
@@ -67,9 +69,11 @@ Use a `ComponentInput` field so the inspector can wire any instance slot entity
 ```typescript
 import {
   Behaviour,
+} from "@relu-interactives/spatial-ecs";
+import {
   InstanceSlotComponent,
   TransformComponent,
-} from "@relu-interactives/spatial-ecs";
+} from "@relu-interactives/spatial-ecs/components";
 import type { ComponentInput, FloatInput } from "@relu-interactives/spatial-ecs";
 
 export default class MoveSlot extends Behaviour {
@@ -86,7 +90,7 @@ export default class MoveSlot extends Behaviour {
     const slot = this.data.targetSlot.value as InstanceSlotComponent | null;
     if (!slot) return;
 
-    const transform = this.world.getComponentById(slot.groupEntityId, TransformComponent);
+    const transform = this.world.getComponent(slot.groupEntityId, TransformComponent);
     // Operate on the slot entity's own transform instead:
     const slotEntity = this.world.getEntityById(
       // find the slot entity ID from the group

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

@@ -47,7 +47,8 @@ if (other) {
 ### Read instance count
 
 ```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 InstanceCounter extends Behaviour {
   protected init() {
@@ -62,7 +63,8 @@ export default class InstanceCounter extends Behaviour {
 ### Toggle shadows on all instances at runtime
 
 ```typescript
-import { Behaviour, InstancedMeshComponent } from "@relu-interactives/spatial-ecs";
+import { Behaviour } from "@relu-interactives/spatial-ecs";
+import { InstancedMeshComponent } from "@relu-interactives/spatial-ecs/components";
 import type { ToggleInput } from "@relu-interactives/spatial-ecs";
 
 export default class ToggleShadows extends Behaviour {
@@ -87,9 +89,11 @@ Move each slot entity up and down using a sine wave. `InstancedMeshSystem` reads
 ```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 WaveInstances extends Behaviour {
   private elapsed = 0;
@@ -102,7 +106,7 @@ export default class WaveInstances 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) {
         transform.position.y = Math.sin(this.elapsed + i * 0.5) * 2;
       }
@@ -118,9 +122,11 @@ Use a `ComponentInput` field so the inspector can wire any `InstancedMeshCompone
 ```typescript
 import {
   Behaviour,
+} from "@relu-interactives/spatial-ecs";
+import {
   InstancedMeshComponent,
   TransformComponent,
-} from "@relu-interactives/spatial-ecs";
+} from "@relu-interactives/spatial-ecs/components";
 import type { ComponentInput } from "@relu-interactives/spatial-ecs";
 
 export default class ScatterInstances extends Behaviour {
@@ -138,7 +144,7 @@ export default class ScatterInstances extends Behaviour {
 
     // Scatter each instance randomly within a 10-unit area
     for (const slotId of instanced.instanceEntityIds) {
-      const transform = this.world.getComponentById(slotId, TransformComponent);
+      const transform = this.world.getComponent(slotId, TransformComponent);
       if (transform) {
         transform.position.x = (Math.random() - 0.5) * 10;
         transform.position.z = (Math.random() - 0.5) * 10;
@@ -155,8 +161,10 @@ Add a new slot entity to an existing group from a script. The new slot's transfo
 ```typescript
 import {
   Behaviour,
-  InstancedMeshComponent,
 } from "@relu-interactives/spatial-ecs";
+import {
+  InstancedMeshComponent,
+} from "@relu-interactives/spatial-ecs/components";
 
 export default class DynamicSpawner extends Behaviour {
   protected init() {

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

@@ -43,7 +43,8 @@ if (other) {
 Animate the light's intensity between a min and max value using a sine wave — useful for flickering flames or heartbeat effects.
 
 ```typescript
-import { Behaviour, LightComponent } from "@relu-interactives/spatial-ecs";
+import { Behaviour } from "@relu-interactives/spatial-ecs";
+import { LightComponent } from "@relu-interactives/spatial-ecs/components";
 import type { FloatInput } from "@relu-interactives/spatial-ecs";
 
 export default class LightPulse extends Behaviour {
@@ -72,7 +73,8 @@ export default class LightPulse extends Behaviour {
 Cycle the light's color through the RGB spectrum over a configurable period.
 
 ```typescript
-import { Behaviour, LightComponent } from "@relu-interactives/spatial-ecs";
+import { Behaviour } from "@relu-interactives/spatial-ecs";
+import { LightComponent } from "@relu-interactives/spatial-ecs/components";
 import type { FloatInput } from "@relu-interactives/spatial-ecs";
 
 export default class LightColorCycle extends Behaviour {
@@ -105,9 +107,11 @@ You can also pick this component from the inspector using a `ComponentInput` fie
 ```typescript
 import {
   Behaviour,
-  LightComponent,
   type ComponentInput,
 } from "@relu-interactives/spatial-ecs";
+import {
+  LightComponent,
+} from "@relu-interactives/spatial-ecs/components";
 
 export default class Example extends Behaviour {
   data = {
@@ -132,10 +136,12 @@ Alternatively, pick an entity from the inspector using an `EntityInput` field an
 ```typescript
 import {
   Behaviour,
-  LightComponent,
   type EntityInput,
   type WorldEntityView,
 } from "@relu-interactives/spatial-ecs";
+import {
+  LightComponent,
+} from "@relu-interactives/spatial-ecs/components";
 
 export default class Example extends Behaviour {
   data = {