@relu-interactives/spatial-ecs 0.2.3 → 0.2.4

package/dist/docs/guide/spawning/ambient-light.md

@@ -3,11 +3,11 @@
 A scene-wide light that adds uniform color to every surface. No shadows, no direction.
 
 ```ts
-import { Behaviour, ObjectManagementSystem } from "@relu-interactives/spatial-ecs";
+import { Behaviour } from "@relu-interactives/spatial-ecs";
 
 export default class SpawnAmbient extends Behaviour {
   init() {
-    const objects = this.world.getSystem(ObjectManagementSystem);
+    const objects = this.world.getObjectManagementSystem();
     objects?.requestCreate("ambientLight", { name: "Fill" });
   }
 }

package/dist/docs/guide/spawning/area-light.md

@@ -3,11 +3,11 @@
 A rectangular area light (`THREE.RectAreaLight`). Great for soft "softbox" lighting. Only `MeshStandardMaterial` and `MeshPhysicalMaterial` are affected.
 
 ```ts
-import { Behaviour, ObjectManagementSystem } from "@relu-interactives/spatial-ecs";
+import { Behaviour } from "@relu-interactives/spatial-ecs";
 
 export default class SpawnSoftbox extends Behaviour {
   init() {
-    const objects = this.world.getSystem(ObjectManagementSystem);
+    const objects = this.world.getObjectManagementSystem();
     objects?.requestCreate("areaLight", {
       name: "Softbox",
       transform: { position: { x: 0, y: 4, z: 0 } },

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

@@ -3,16 +3,27 @@
 A 3D positional audio source attached to the active camera's `AudioListener`.
 
 ```ts
-import { Behaviour, ObjectManagementSystem } from "@relu-interactives/spatial-ecs";
+import {
+  Behaviour,
+  
+} from "@relu-interactives/spatial-ecs";
 
 export default class SpawnSound extends Behaviour {
   init() {
-    const objects = this.world.getSystem(ObjectManagementSystem);
+    const objects = this.world.getObjectManagementSystem();
     objects?.requestCreate("audio", {
       name: "Ambience",
       path: "/assets/audio/ambience.mp3",
       transform: { position: { x: 0, y: 1, z: 0 } },
-      options: { autoplay: true, loop: true, volume: 0.5 },
+      options: {
+        autoplay: true,
+        loop: true,
+        volume: 0.5,
+        positional: true,
+        distanceModel: "linear",
+        refDistance: 1,
+        rolloffFactor: 1,
+      },
     });
   }
 }
@@ -20,22 +31,22 @@ export default class SpawnSound extends Behaviour {
 
 ## Payload
 
-| Field | Type | Default | Description |
-| --- | --- | --- | --- |
-| `name` | `string` | `"Audio"` | Display name. |
-| `path` | `string` | `""` | URL or local-asset path to the audio clip (MP3, WAV, OGG). |
-| `transform` | `TransformData` | identity | Position / rotation / scale (position drives spatialization). |
-| `parentId` | `EntityId \| null` | `null` | Optional parent entity. |
+| Field       | Type               | Default   | Description                                                   |
+| ----------- | ------------------ | --------- | ------------------------------------------------------------- |
+| `name`      | `string`           | `"Audio"` | Display name.                                                 |
+| `path`      | `string`           | `""`      | URL or local-asset path to the audio clip (MP3, WAV, OGG).    |
+| `transform` | `TransformData`    | identity  | Position / rotation / scale (position drives spatialization). |
+| `parentId`  | `EntityId \| null` | `null`    | Optional parent entity.                                       |
 
 ### `options`
 
-| Option | Type | Default | Description |
-| --- | --- | --- | --- |
-| `autoplay` | `boolean` | `false` | Start playback as soon as the clip is loaded. |
-| `loop` | `boolean` | `false` | Loop playback indefinitely. |
-| `volume` | `number` (0–1) | `1` | Linear gain. |
-| `refDistance` | `number` | `1` | Distance at which volume is unattenuated. |
-| `rolloffFactor` | `number` | `1` | How quickly volume falls off past `refDistance`. |
+| Option          | Type           | Default | Description                                      |
+| --------------- | -------------- | ------- | ------------------------------------------------ |
+| `autoplay`      | `boolean`      | `false` | Start playback as soon as the clip is loaded.    |
+| `loop`          | `boolean`      | `false` | Loop playback indefinitely.                      |
+| `volume`        | `number` (0–1) | `1`     | Linear gain.                                     |
+| `refDistance`   | `number`       | `1`     | Distance at which volume is unattenuated.        |
+| `rolloffFactor` | `number`       | `1`     | How quickly volume falls off past `refDistance`. |
 
 ## Components attached
 

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

@@ -3,11 +3,11 @@
 Spawn an additional camera entity. Useful for cinematics, picture-in-picture, or AR cameras.
 
 ```ts
-import { Behaviour, ObjectManagementSystem } from "@relu-interactives/spatial-ecs";
+import { Behaviour } from "@relu-interactives/spatial-ecs";
 
 export default class SpawnCamera extends Behaviour {
   init() {
-    const objects = this.world.getSystem(ObjectManagementSystem);
+    const objects = this.world.getObjectManagementSystem();
     objects?.requestCreate("camera", {
       name: "Cinematic",
       transform: { position: { x: 0, y: 2, z: 5 } },

package/dist/docs/guide/spawning/capsule.md

@@ -3,11 +3,11 @@
 A `THREE.CapsuleGeometry` with radius `0.5`, length `1`, 4 cap subdivisions, and 8 radial segments.
 
 ```ts
-import { Behaviour, ObjectManagementSystem } from "@relu-interactives/spatial-ecs";
+import { Behaviour } from "@relu-interactives/spatial-ecs";
 
 export default class SpawnCapsule extends Behaviour {
   init() {
-    const objects = this.world.getSystem(ObjectManagementSystem);
+    const objects = this.world.getObjectManagementSystem();
     objects?.requestCreate("capsule", {
       name: "Player",
       transform: { position: { x: 0, y: 1, z: 0 } },

package/dist/docs/guide/spawning/cube.md

@@ -3,11 +3,11 @@
 A unit `1×1×1` `THREE.BoxGeometry` mesh with a default white `MeshStandardMaterial`.
 
 ```ts
-import { Behaviour, ObjectManagementSystem } from "@relu-interactives/spatial-ecs";
+import { Behaviour } from "@relu-interactives/spatial-ecs";
 
 export default class SpawnCube extends Behaviour {
   init() {
-    const objects = this.world.getSystem(ObjectManagementSystem);
+    const objects = this.world.getObjectManagementSystem();
     objects?.requestCreate("cube", {
       name: "Crate",
       transform: { position: { x: 0, y: 1, z: 0 } },

package/dist/docs/guide/spawning/cylinder.md

@@ -3,11 +3,11 @@
 A `THREE.CylinderGeometry` with radius `0.5`, height `1`, and 20 radial segments.
 
 ```ts
-import { Behaviour, ObjectManagementSystem } from "@relu-interactives/spatial-ecs";
+import { Behaviour } from "@relu-interactives/spatial-ecs";
 
 export default class SpawnCylinder extends Behaviour {
   init() {
-    const objects = this.world.getSystem(ObjectManagementSystem);
+    const objects = this.world.getObjectManagementSystem();
     objects?.requestCreate("cylinder", {
       name: "Pillar",
       transform: { position: { x: 0, y: 0.5, z: 0 } },

package/dist/docs/guide/spawning/directional-light.md

@@ -3,11 +3,11 @@
 A parallel-ray light source — like the sun. Casts shadows by default.
 
 ```ts
-import { Behaviour, ObjectManagementSystem } from "@relu-interactives/spatial-ecs";
+import { Behaviour } from "@relu-interactives/spatial-ecs";
 
 export default class SpawnSun extends Behaviour {
   init() {
-    const objects = this.world.getSystem(ObjectManagementSystem);
+    const objects = this.world.getObjectManagementSystem();
     objects?.requestCreate("directionalLight", {
       name: "Sun",
       transform: { position: { x: 5, y: 8, z: 5 } },

package/dist/docs/guide/spawning/empty.md

@@ -3,11 +3,11 @@
 An invisible `THREE.Group`. Useful as a parent / pivot / spawn anchor.
 
 ```ts
-import { Behaviour, ObjectManagementSystem } from "@relu-interactives/spatial-ecs";
+import { Behaviour } from "@relu-interactives/spatial-ecs";
 
 export default class SpawnAnchor extends Behaviour {
   init() {
-    const objects = this.world.getSystem(ObjectManagementSystem);
+    const objects = this.world.getObjectManagementSystem();
     objects?.requestCreate("empty", {
       name: "SpawnPoint",
       transform: { position: { x: 0, y: 0, z: -3 } },

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

@@ -3,11 +3,11 @@
 An AR image-tracking anchor. Children of an image-target entity are revealed and aligned when the tracker recognizes the printed image at runtime.
 
 ```ts
-import { Behaviour, ObjectManagementSystem } from "@relu-interactives/spatial-ecs";
+import { Behaviour } from "@relu-interactives/spatial-ecs";
 
 export default class SpawnTarget extends Behaviour {
   init() {
-    const objects = this.world.getSystem(ObjectManagementSystem);
+    const objects = this.world.getObjectManagementSystem();
     objects?.requestCreate("imageTarget", {
       name: "PosterTarget",
       path: "/assets/targets/poster.png",

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

@@ -3,11 +3,11 @@
 A flat textured plane that auto-sizes to the loaded image's aspect ratio. Useful for billboards, UI quads, or photo planes.
 
 ```ts
-import { Behaviour, ObjectManagementSystem } from "@relu-interactives/spatial-ecs";
+import { Behaviour } from "@relu-interactives/spatial-ecs";
 
 export default class SpawnPoster extends Behaviour {
   init() {
-    const objects = this.world.getSystem(ObjectManagementSystem);
+    const objects = this.world.getObjectManagementSystem();
     objects?.requestCreate("image", {
       name: "Poster",
       path: "/assets/images/poster.png",

package/dist/docs/guide/spawning/index.md

@@ -3,11 +3,11 @@
 `ObjectManagementSystem` is the runtime factory the editor uses to create every built-in object kind. From inside a `Behaviour` you can ask it to spawn the same primitives at runtime — pre-wired with all of their default components.
 
 ```ts
-import { Behaviour, ObjectManagementSystem } from "@relu-interactives/spatial-ecs";
+import { Behaviour } from "@relu-interactives/spatial-ecs";
 
 export default class Example extends Behaviour {
   init() {
-    const objects = this.world.getSystem(ObjectManagementSystem);
+    const objects = this.world.getObjectManagementSystem();
     objects?.requestCreate("cube", { name: "MyCube" }, (entityId) => {
       console.log("spawned", entityId);
     });

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

@@ -3,11 +3,11 @@
 Loads a glTF / glb model (with optional Draco compression). The entity is created immediately; the model meshes attach asynchronously once the file is loaded.
 
 ```ts
-import { Behaviour, ObjectManagementSystem } from "@relu-interactives/spatial-ecs";
+import { Behaviour } from "@relu-interactives/spatial-ecs";
 
 export default class SpawnModel extends Behaviour {
   init() {
-    const objects = this.world.getSystem(ObjectManagementSystem);
+    const objects = this.world.getObjectManagementSystem();
     objects?.requestCreate("model", {
       name: "Robot",
       path: "/assets/models/robot.glb",

package/dist/docs/guide/spawning/plane.md

@@ -3,11 +3,11 @@
 A `100 × 100` double-sided `THREE.PlaneGeometry`. By default it is rotated `-π/2` on the X-axis so it lies flat (XZ ground plane).
 
 ```ts
-import { Behaviour, ObjectManagementSystem } from "@relu-interactives/spatial-ecs";
+import { Behaviour } from "@relu-interactives/spatial-ecs";
 
 export default class SpawnFloor extends Behaviour {
   init() {
-    const objects = this.world.getSystem(ObjectManagementSystem);
+    const objects = this.world.getObjectManagementSystem();
     objects?.requestCreate("plane", { name: "Floor" });
   }
 }

package/dist/docs/guide/spawning/point-light.md

@@ -3,11 +3,11 @@
 An omnidirectional light that radiates equally in all directions, with falloff over `distance`.
 
 ```ts
-import { Behaviour, ObjectManagementSystem } from "@relu-interactives/spatial-ecs";
+import { Behaviour } from "@relu-interactives/spatial-ecs";
 
 export default class SpawnTorch extends Behaviour {
   init() {
-    const objects = this.world.getSystem(ObjectManagementSystem);
+    const objects = this.world.getObjectManagementSystem();
     objects?.requestCreate("pointLight", {
       name: "Torch",
       transform: { position: { x: 0, y: 2, z: 0 } },

package/dist/docs/guide/spawning/sphere.md

@@ -3,11 +3,11 @@
 A radius `0.5` `THREE.SphereGeometry` (24 width × 24 height segments) with a default white `MeshStandardMaterial`.
 
 ```ts
-import { Behaviour, ObjectManagementSystem } from "@relu-interactives/spatial-ecs";
+import { Behaviour } from "@relu-interactives/spatial-ecs";
 
 export default class SpawnSphere extends Behaviour {
   init() {
-    const objects = this.world.getSystem(ObjectManagementSystem);
+    const objects = this.world.getObjectManagementSystem();
     objects?.requestCreate("sphere", {
       name: "Ball",
       transform: { position: { x: 0, y: 0.5, z: 0 } },

package/dist/docs/guide/spawning/spot-light.md

@@ -3,11 +3,11 @@
 A cone-shaped light with adjustable angle, penumbra, and distance falloff.
 
 ```ts
-import { Behaviour, ObjectManagementSystem } from "@relu-interactives/spatial-ecs";
+import { Behaviour } from "@relu-interactives/spatial-ecs";
 
 export default class SpawnSpot extends Behaviour {
   init() {
-    const objects = this.world.getSystem(ObjectManagementSystem);
+    const objects = this.world.getObjectManagementSystem();
     objects?.requestCreate("spotLight", {
       name: "Stage",
       transform: { position: { x: 0, y: 5, z: 0 } },

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

@@ -3,11 +3,11 @@
 A camera-facing `THREE.Sprite` textured with an image. Always faces the active camera.
 
 ```ts
-import { Behaviour, ObjectManagementSystem } from "@relu-interactives/spatial-ecs";
+import { Behaviour } from "@relu-interactives/spatial-ecs";
 
 export default class SpawnIcon extends Behaviour {
   init() {
-    const objects = this.world.getSystem(ObjectManagementSystem);
+    const objects = this.world.getObjectManagementSystem();
     objects?.requestCreate("sprite", {
       name: "Marker",
       path: "/assets/images/marker.png",

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

@@ -3,11 +3,11 @@
 A textured plane playing a video file, with optional chroma-keying (green-screen) so you can composite the video over the live scene.
 
 ```ts
-import { Behaviour, ObjectManagementSystem } from "@relu-interactives/spatial-ecs";
+import { Behaviour } from "@relu-interactives/spatial-ecs";
 
 export default class SpawnVideo extends Behaviour {
   init() {
-    const objects = this.world.getSystem(ObjectManagementSystem);
+    const objects = this.world.getObjectManagementSystem();
     objects?.requestCreate("video", {
       name: "Promo",
       path: "/assets/videos/promo.mp4",

package/dist/docs/guide/world-api.md

@@ -101,6 +101,7 @@ Both methods accept `Vec3` (`THREE.Vector3` or `{ x, y, z }`) and return `Inters
 | --- | --- |
 | `getSystem(SystemClass)` | Resolve a registered system instance. |
 | `hasSystem(SystemClass)` | `true` if the system is registered. |
+| `getObjectManagementSystem()` | Shorthand for the built-in `ObjectManagementSystem`. Use this to spawn or destroy entities at runtime (`requestCreate`, `createNow`, `deleteEntity`). |
 
 ### World lifecycle
 
@@ -207,14 +208,11 @@ export default class Spawner extends Behaviour {
 `ObjectManagementSystem` is the same system the editor uses to create objects, so the new entity comes pre-wired with the correct components for its kind.
 
 ```ts
-import {
-  Behaviour,
-  ObjectManagementSystem,
-} from "@relu-interactives/spatial-ecs";
+import { Behaviour } from "@relu-interactives/spatial-ecs";
 
 export default class CubeSpawner extends Behaviour {
   init() {
-    const objects = this.world.getSystem(ObjectManagementSystem);
+    const objects = this.world.getObjectManagementSystem();
     if (!objects) return;
 
     // Supported kinds:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@relu-interactives/spatial-ecs",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "Reusable ECS core engine for Relu Spatial editor and runtime experiences.",
   "license": "MIT",
   "private": false,