@relu-interactives/spatial-ecs 0.2.2 → 0.2.3

package/README.md

@@ -1,125 +1,56 @@
 # @relu-interactives/spatial-ecs
 
-Reusable ECS core engine for Relu Spatial editor and runtime experiences.
+Shared ECS (Entity-Component-System) engine powering the Relu Spatial editor and preview runtimes.
 
-## Package
+## What it is
 
-- Name: `@relu-interactives/spatial-ecs`
-- Registry: GitHub Packages (`https://npm.pkg.github.com`)
-- Publish workflow: `.github/workflows/publish-package.yml`
-- Publish trigger: push tags matching `v*` (or manual workflow dispatch)
-- Publish access: public (`npm publish --access public`)
+`@relu-interactives/spatial-ecs` is the source of truth for entity/component/system behavior used across Relu Spatial experiences. It provides a deterministic, serializable scene graph that can be saved, hydrated, and executed identically in both the editor authoring environment and deployed AR/VR previews.
 
-## Prerequisites
+## What it contains
 
-1. You have write access to this repository.
-2. GitHub Packages permissions are enabled for the repository.
-3. Your account/token has package read/write permissions.
-4. Node.js 20+ and npm are installed locally.
+| Area | Path | Description |
+|---|---|---|
+| **Components** | `core/components/**` | Runtime state containers (Transform, Model, Animation, Physics, Light, …) |
+| **Component factories** | `core/factories/components/**` | APIs for creating and updating component instances |
+| **Object factories** | `core/factories/objects/**` | Entity assembly — wires baseline components onto scene objects |
+| **Systems** | `core/systems/**` | Frame-by-frame runtime behavior and scene synchronization |
+| **World** | `core/World.ts` | ECS storage, lifecycle, system scheduling, snapshot and history management |
+| **Hydration** | `core/hydration/**` | World reconstruction from saved snapshot data |
+| **Snapshot utils** | `core/worldSnapshotUtils.ts` | Snapshot normalization, cloning, and debug helpers |
+| **Scripting** | `core/Behaviour.ts`, `core/ScriptTemplate.ts` | Base classes for user-authored ECS scripts |
 
-## Local Development
-
-Install dependencies:
+## Installation
 
 ```bash
-npm ci
-```
-
-Build package:
-
-```bash
-npm run build
-```
-
-Type check:
-
-```bash
-npm run typecheck
-```
-
-## Creating a Release Version
-
-Use one of the version scripts:
-
-```bash
-npm run release:patch
-# or
-npm run release:minor
+npm install @relu-interactives/spatial-ecs
 # or
-npm run release:major
+pnpm add @relu-interactives/spatial-ecs
 ```
 
-This updates `package.json` version and creates a git tag.
-
-## Publishing via GitHub Actions (Recommended)
-
-1. Commit your changes (including the version bump).
-2. Push commit and tag.
+`three` is a peer dependency and must be installed separately:
 
 ```bash
-git add .
-git commit -m "release: bump package version"
-git push && git push --tags
-git push --follow-tags
+npm install three
 ```
 
-3. GitHub Action `Publish Spatial ECS Package` runs automatically.
-4. Verify publish in:
-   - Repository `Actions` tab
-   - Repository `Packages` section
-
-## Make Package Public (GitHub UI)
-
-For already-published package versions, you may need a one-time visibility change in GitHub:
-
-1. Open repository `Packages`.
-2. Open package `@relu-interactives/spatial-ecs`.
-3. Go to `Package settings`.
-4. Under `Danger Zone`, change visibility to `Public`.
-
-After this, new releases published by the workflow remain public.
-
-## Manual Publish (Optional)
-
-If needed, publish from your machine.
-
-Create/update your user `.npmrc` with GitHub Packages auth:
-
-```ini
-@relu-interactives:registry=https://npm.pkg.github.com
-//npm.pkg.github.com/:_authToken=YOUR_GITHUB_TOKEN
-always-auth=true
-```
-
-Then run:
+## Local Development
 
 ```bash
-npm ci
-npm run build
-npm publish
+pnpm install
+pnpm run build
+pnpm run typecheck
 ```
 
-## Consuming This Package
+## Key Concepts
 
-In consumer projects, set scope registry:
+### Entities and Components
 
-```ini
-@relu-interactives:registry=https://npm.pkg.github.com
-//npm.pkg.github.com/:_authToken=${GITHUB_PACKAGES_TOKEN}
-always-auth=true
-```
+Entities are integer IDs. Components are plain data containers attached to entities and stored in the World. Systems query for entities that have specific component combinations and apply runtime behavior each frame.
 
-Install:
+### Snapshot and Hydration
 
-```bash
-npm install @relu-interactives/spatial-ecs
-```
+The world can be serialized to a plain JSON snapshot and fully reconstructed via `hydrateWorldFromSnapshotDetailed`. Snapshots are designed to be forward-compatible — hydration is tolerant of missing or legacy fields.
 
-## Troubleshooting
+### Editor / Preview Parity
 
-- `403 Forbidden` / `401 Unauthorized`:
-  - Check token permissions (`read:packages` for install, `write:packages` for publish).
-- `You cannot publish over the previously published versions`:
-  - Bump version before publishing.
-- Workflow succeeds build but fails publish:
-  - Confirm package name scope matches workflow scope (`@relu-interactives`).
+The same component contracts, factory logic, and hydration path are used by both the editor and the preview runtime. Changes to any of these must preserve behavior across both consumers.

package/dist/{System-rXAmagXA.d.cts → System-BTyYvKVH.d.cts}

@@ -464,6 +464,7 @@ declare class World {
     private readonly featureFlags;
     private components;
     private inputSystem;
+    private objectManagementSystem;
     private rapierModule;
     private rapierModulePromise;
     private physicsWorld;
@@ -590,6 +591,7 @@ declare class World {
     getEntitiesByName(name: string): WorldEntityView[];
     getEntityByName(name: string): WorldEntityView | null;
     getEntityById(entityId: number): WorldEntityView | null;
+    getObjectManagementSystem(): ObjectManagementSystem;
     /**
      * Cast a ray from `origin` along `direction` and return every intersected
      * entity-bound mesh, sorted by distance. Each result is a standard

package/dist/{System-rXAmagXA.d.ts → System-BTyYvKVH.d.ts}

@@ -464,6 +464,7 @@ declare class World {
     private readonly featureFlags;
     private components;
     private inputSystem;
+    private objectManagementSystem;
     private rapierModule;
     private rapierModulePromise;
     private physicsWorld;
@@ -590,6 +591,7 @@ declare class World {
     getEntitiesByName(name: string): WorldEntityView[];
     getEntityByName(name: string): WorldEntityView | null;
     getEntityById(entityId: number): WorldEntityView | null;
+    getObjectManagementSystem(): ObjectManagementSystem;
     /**
      * Cast a ray from `origin` along `direction` and return every intersected
      * entity-bound mesh, sorted by distance. Each result is a standard

package/dist/{Video-ChKV1UI7.d.ts → Video-BWhbvVPg.d.ts}

@@ -1,5 +1,5 @@
 import * as THREE from 'three';
-import { C as Component, e as EcsEntityKind, m as EcsEntityEditorKind, n as EntityId } from './System-rXAmagXA.js';
+import { C as Component, e as EcsEntityKind, m as EcsEntityEditorKind, n as EntityId } from './System-BTyYvKVH.js';
 import * as RAPIER from '@dimforge/rapier3d-compat';
 
 interface StateMachine {

package/dist/{Video-CDemv74U.d.cts → Video-D2H5H-K3.d.cts}

@@ -1,5 +1,5 @@
 import * as THREE from 'three';
-import { C as Component, e as EcsEntityKind, m as EcsEntityEditorKind, n as EntityId } from './System-rXAmagXA.cjs';
+import { C as Component, e as EcsEntityKind, m as EcsEntityEditorKind, n as EntityId } from './System-BTyYvKVH.cjs';
 import * as RAPIER from '@dimforge/rapier3d-compat';
 
 interface StateMachine {

package/dist/components/index.d.cts

@@ -1,4 +1,4 @@
-export { A as AnimationComponent, a as AnimationComponentOptions, b as AudioComponent, C as CameraComponent, c as CameraComponentOptions, d as CameraProjection, e as CameraRuntimeType, f as ColliderShape, g as ColliderState, h as CubeMeshParameters, D as DEFAULT_COLLIDER_STATE, i as DEFAULT_ENVIRONMENT_STATE, j as DEFAULT_MESH_GEOMETRY_PARAMETERS, k as DEFAULT_PHYSICS_STATE, l as DEFAULT_POSTPROCESSING_STATE, m as DEFAULT_RIGIDBODY_STATE, E as EditableMeshObjectKind, n as EntityType, o as Environment, p as EnvironmentFogState, q as EnvironmentFogType, r as EnvironmentGradientEffect, s as EnvironmentSkyboxState, t as EnvironmentSkyboxType, u as EnvironmentState, I as ImageComponent, v as ImageTarget, w as ImageTargetAnchor, x as ImageTargetAnchorOptions, y as ImageTargetReference, L as LightComponent, z as LightValueState, M as MaterialComponent, B as MaterialTypeValue, F as MaterialValueState, G as MeshComponent, H as MeshGeometryComponent, J as MeshGeometryParameters, K as MeshGeometryParametersByKind, N as ModelComponent, O as Name, P as Object3DRef, Q as PhysicsComponent, R as PhysicsState, S as PlaneMeshParameters, T as Postprocessing, U as PostprocessingState, V as RadiusHeightMeshParameters, W as RadiusMeshParameters, X as RigidbodyState, Y as RigidbodyType, Z as ScriptComponent, _ as ScriptEntry, $ as Selectable, a0 as SelectionTransformState, a1 as SpriteComponent, a2 as TextureFilteringValue, a3 as TransformModeValue, a4 as TransformSpaceValue, a5 as VideoComponent, a6 as normalizePhysicsState } from '../Video-CDemv74U.cjs';
-export { P as ParentId, T as TransformComponent, a as TransformData, V as Vec3 } from '../System-rXAmagXA.cjs';
+export { A as AnimationComponent, a as AnimationComponentOptions, b as AudioComponent, C as CameraComponent, c as CameraComponentOptions, d as CameraProjection, e as CameraRuntimeType, f as ColliderShape, g as ColliderState, h as CubeMeshParameters, D as DEFAULT_COLLIDER_STATE, i as DEFAULT_ENVIRONMENT_STATE, j as DEFAULT_MESH_GEOMETRY_PARAMETERS, k as DEFAULT_PHYSICS_STATE, l as DEFAULT_POSTPROCESSING_STATE, m as DEFAULT_RIGIDBODY_STATE, E as EditableMeshObjectKind, n as EntityType, o as Environment, p as EnvironmentFogState, q as EnvironmentFogType, r as EnvironmentGradientEffect, s as EnvironmentSkyboxState, t as EnvironmentSkyboxType, u as EnvironmentState, I as ImageComponent, v as ImageTarget, w as ImageTargetAnchor, x as ImageTargetAnchorOptions, y as ImageTargetReference, L as LightComponent, z as LightValueState, M as MaterialComponent, B as MaterialTypeValue, F as MaterialValueState, G as MeshComponent, H as MeshGeometryComponent, J as MeshGeometryParameters, K as MeshGeometryParametersByKind, N as ModelComponent, O as Name, P as Object3DRef, Q as PhysicsComponent, R as PhysicsState, S as PlaneMeshParameters, T as Postprocessing, U as PostprocessingState, V as RadiusHeightMeshParameters, W as RadiusMeshParameters, X as RigidbodyState, Y as RigidbodyType, Z as ScriptComponent, _ as ScriptEntry, $ as Selectable, a0 as SelectionTransformState, a1 as SpriteComponent, a2 as TextureFilteringValue, a3 as TransformModeValue, a4 as TransformSpaceValue, a5 as VideoComponent, a6 as normalizePhysicsState } from '../Video-D2H5H-K3.cjs';
+export { P as ParentId, T as TransformComponent, a as TransformData, V as Vec3 } from '../System-BTyYvKVH.cjs';
 import 'three';
 import '@dimforge/rapier3d-compat';

package/dist/components/index.d.ts

@@ -1,4 +1,4 @@
-export { A as AnimationComponent, a as AnimationComponentOptions, b as AudioComponent, C as CameraComponent, c as CameraComponentOptions, d as CameraProjection, e as CameraRuntimeType, f as ColliderShape, g as ColliderState, h as CubeMeshParameters, D as DEFAULT_COLLIDER_STATE, i as DEFAULT_ENVIRONMENT_STATE, j as DEFAULT_MESH_GEOMETRY_PARAMETERS, k as DEFAULT_PHYSICS_STATE, l as DEFAULT_POSTPROCESSING_STATE, m as DEFAULT_RIGIDBODY_STATE, E as EditableMeshObjectKind, n as EntityType, o as Environment, p as EnvironmentFogState, q as EnvironmentFogType, r as EnvironmentGradientEffect, s as EnvironmentSkyboxState, t as EnvironmentSkyboxType, u as EnvironmentState, I as ImageComponent, v as ImageTarget, w as ImageTargetAnchor, x as ImageTargetAnchorOptions, y as ImageTargetReference, L as LightComponent, z as LightValueState, M as MaterialComponent, B as MaterialTypeValue, F as MaterialValueState, G as MeshComponent, H as MeshGeometryComponent, J as MeshGeometryParameters, K as MeshGeometryParametersByKind, N as ModelComponent, O as Name, P as Object3DRef, Q as PhysicsComponent, R as PhysicsState, S as PlaneMeshParameters, T as Postprocessing, U as PostprocessingState, V as RadiusHeightMeshParameters, W as RadiusMeshParameters, X as RigidbodyState, Y as RigidbodyType, Z as ScriptComponent, _ as ScriptEntry, $ as Selectable, a0 as SelectionTransformState, a1 as SpriteComponent, a2 as TextureFilteringValue, a3 as TransformModeValue, a4 as TransformSpaceValue, a5 as VideoComponent, a6 as normalizePhysicsState } from '../Video-ChKV1UI7.js';
-export { P as ParentId, T as TransformComponent, a as TransformData, V as Vec3 } from '../System-rXAmagXA.js';
+export { A as AnimationComponent, a as AnimationComponentOptions, b as AudioComponent, C as CameraComponent, c as CameraComponentOptions, d as CameraProjection, e as CameraRuntimeType, f as ColliderShape, g as ColliderState, h as CubeMeshParameters, D as DEFAULT_COLLIDER_STATE, i as DEFAULT_ENVIRONMENT_STATE, j as DEFAULT_MESH_GEOMETRY_PARAMETERS, k as DEFAULT_PHYSICS_STATE, l as DEFAULT_POSTPROCESSING_STATE, m as DEFAULT_RIGIDBODY_STATE, E as EditableMeshObjectKind, n as EntityType, o as Environment, p as EnvironmentFogState, q as EnvironmentFogType, r as EnvironmentGradientEffect, s as EnvironmentSkyboxState, t as EnvironmentSkyboxType, u as EnvironmentState, I as ImageComponent, v as ImageTarget, w as ImageTargetAnchor, x as ImageTargetAnchorOptions, y as ImageTargetReference, L as LightComponent, z as LightValueState, M as MaterialComponent, B as MaterialTypeValue, F as MaterialValueState, G as MeshComponent, H as MeshGeometryComponent, J as MeshGeometryParameters, K as MeshGeometryParametersByKind, N as ModelComponent, O as Name, P as Object3DRef, Q as PhysicsComponent, R as PhysicsState, S as PlaneMeshParameters, T as Postprocessing, U as PostprocessingState, V as RadiusHeightMeshParameters, W as RadiusMeshParameters, X as RigidbodyState, Y as RigidbodyType, Z as ScriptComponent, _ as ScriptEntry, $ as Selectable, a0 as SelectionTransformState, a1 as SpriteComponent, a2 as TextureFilteringValue, a3 as TransformModeValue, a4 as TransformSpaceValue, a5 as VideoComponent, a6 as normalizePhysicsState } from '../Video-BWhbvVPg.js';
+export { P as ParentId, T as TransformComponent, a as TransformData, V as Vec3 } from '../System-BTyYvKVH.js';
 import 'three';
 import '@dimforge/rapier3d-compat';

package/dist/factories/index.d.cts

@@ -1,5 +1,5 @@
-import { A as AnimationComponent, b as AudioComponent, c as CameraComponentOptions, C as CameraComponent, X as RigidbodyState, g as ColliderState, Q as PhysicsComponent, u as EnvironmentState, o as Environment, n as EntityType, I as ImageComponent, w as ImageTargetAnchor, v as ImageTarget, L as LightComponent, M as MaterialComponent, G as MeshComponent, H as MeshGeometryComponent, N as ModelComponent, O as Name, P as Object3DRef, U as PostprocessingState, T as Postprocessing, _ as ScriptEntry, Z as ScriptComponent, $ as Selectable, a0 as SelectionTransformState, a1 as SpriteComponent, a5 as VideoComponent } from '../Video-CDemv74U.cjs';
-import { b as World, P as ParentId, T as TransformComponent, O as ObjectManagementSystem } from '../System-rXAmagXA.cjs';
+import { A as AnimationComponent, b as AudioComponent, c as CameraComponentOptions, C as CameraComponent, X as RigidbodyState, g as ColliderState, Q as PhysicsComponent, u as EnvironmentState, o as Environment, n as EntityType, I as ImageComponent, w as ImageTargetAnchor, v as ImageTarget, L as LightComponent, M as MaterialComponent, G as MeshComponent, H as MeshGeometryComponent, N as ModelComponent, O as Name, P as Object3DRef, U as PostprocessingState, T as Postprocessing, _ as ScriptEntry, Z as ScriptComponent, $ as Selectable, a0 as SelectionTransformState, a1 as SpriteComponent, a5 as VideoComponent } from '../Video-D2H5H-K3.cjs';
+import { b as World, P as ParentId, T as TransformComponent, O as ObjectManagementSystem } from '../System-BTyYvKVH.cjs';
 import * as THREE from 'three';
 import '@dimforge/rapier3d-compat';
 

package/dist/factories/index.d.ts

@@ -1,5 +1,5 @@
-import { A as AnimationComponent, b as AudioComponent, c as CameraComponentOptions, C as CameraComponent, X as RigidbodyState, g as ColliderState, Q as PhysicsComponent, u as EnvironmentState, o as Environment, n as EntityType, I as ImageComponent, w as ImageTargetAnchor, v as ImageTarget, L as LightComponent, M as MaterialComponent, G as MeshComponent, H as MeshGeometryComponent, N as ModelComponent, O as Name, P as Object3DRef, U as PostprocessingState, T as Postprocessing, _ as ScriptEntry, Z as ScriptComponent, $ as Selectable, a0 as SelectionTransformState, a1 as SpriteComponent, a5 as VideoComponent } from '../Video-ChKV1UI7.js';
-import { b as World, P as ParentId, T as TransformComponent, O as ObjectManagementSystem } from '../System-rXAmagXA.js';
+import { A as AnimationComponent, b as AudioComponent, c as CameraComponentOptions, C as CameraComponent, X as RigidbodyState, g as ColliderState, Q as PhysicsComponent, u as EnvironmentState, o as Environment, n as EntityType, I as ImageComponent, w as ImageTargetAnchor, v as ImageTarget, L as LightComponent, M as MaterialComponent, G as MeshComponent, H as MeshGeometryComponent, N as ModelComponent, O as Name, P as Object3DRef, U as PostprocessingState, T as Postprocessing, _ as ScriptEntry, Z as ScriptComponent, $ as Selectable, a0 as SelectionTransformState, a1 as SpriteComponent, a5 as VideoComponent } from '../Video-BWhbvVPg.js';
+import { b as World, P as ParentId, T as TransformComponent, O as ObjectManagementSystem } from '../System-BTyYvKVH.js';
 import * as THREE from 'three';
 import '@dimforge/rapier3d-compat';
 

package/dist/{index-BZUOKeTO.d.ts → index-Dm6zF1MY.d.ts}

@@ -1,5 +1,5 @@
-import { A as AnimationComponent, a as AnimationComponentOptions, b as AudioComponent, C as CameraComponent, c as CameraComponentOptions, d as CameraProjection, e as CameraRuntimeType, f as ColliderShape, g as ColliderState, h as CubeMeshParameters, D as DEFAULT_COLLIDER_STATE, i as DEFAULT_ENVIRONMENT_STATE, j as DEFAULT_MESH_GEOMETRY_PARAMETERS, k as DEFAULT_PHYSICS_STATE, l as DEFAULT_POSTPROCESSING_STATE, m as DEFAULT_RIGIDBODY_STATE, E as EditableMeshObjectKind, n as EntityType, o as Environment, p as EnvironmentFogState, q as EnvironmentFogType, r as EnvironmentGradientEffect, s as EnvironmentSkyboxState, t as EnvironmentSkyboxType, u as EnvironmentState, I as ImageComponent, v as ImageTarget, w as ImageTargetAnchor, x as ImageTargetAnchorOptions, y as ImageTargetReference, L as LightComponent, z as LightValueState, M as MaterialComponent, B as MaterialTypeValue, F as MaterialValueState, G as MeshComponent, H as MeshGeometryComponent, J as MeshGeometryParameters, K as MeshGeometryParametersByKind, N as ModelComponent, O as Name, P as Object3DRef, Q as PhysicsComponent, R as PhysicsState, S as PlaneMeshParameters, T as Postprocessing, U as PostprocessingState, V as RadiusHeightMeshParameters, W as RadiusMeshParameters, X as RigidbodyState, Y as RigidbodyType, Z as ScriptComponent, _ as ScriptEntry, $ as Selectable, a0 as SelectionTransformState, a1 as SpriteComponent, a2 as TextureFilteringValue, a3 as TransformModeValue, a4 as TransformSpaceValue, a5 as VideoComponent, a6 as normalizePhysicsState } from './Video-ChKV1UI7.js';
-import { P as ParentId, T as TransformComponent, a as TransformData, V as Vec3 } from './System-rXAmagXA.js';
+import { A as AnimationComponent, a as AnimationComponentOptions, b as AudioComponent, C as CameraComponent, c as CameraComponentOptions, d as CameraProjection, e as CameraRuntimeType, f as ColliderShape, g as ColliderState, h as CubeMeshParameters, D as DEFAULT_COLLIDER_STATE, i as DEFAULT_ENVIRONMENT_STATE, j as DEFAULT_MESH_GEOMETRY_PARAMETERS, k as DEFAULT_PHYSICS_STATE, l as DEFAULT_POSTPROCESSING_STATE, m as DEFAULT_RIGIDBODY_STATE, E as EditableMeshObjectKind, n as EntityType, o as Environment, p as EnvironmentFogState, q as EnvironmentFogType, r as EnvironmentGradientEffect, s as EnvironmentSkyboxState, t as EnvironmentSkyboxType, u as EnvironmentState, I as ImageComponent, v as ImageTarget, w as ImageTargetAnchor, x as ImageTargetAnchorOptions, y as ImageTargetReference, L as LightComponent, z as LightValueState, M as MaterialComponent, B as MaterialTypeValue, F as MaterialValueState, G as MeshComponent, H as MeshGeometryComponent, J as MeshGeometryParameters, K as MeshGeometryParametersByKind, N as ModelComponent, O as Name, P as Object3DRef, Q as PhysicsComponent, R as PhysicsState, S as PlaneMeshParameters, T as Postprocessing, U as PostprocessingState, V as RadiusHeightMeshParameters, W as RadiusMeshParameters, X as RigidbodyState, Y as RigidbodyType, Z as ScriptComponent, _ as ScriptEntry, $ as Selectable, a0 as SelectionTransformState, a1 as SpriteComponent, a2 as TextureFilteringValue, a3 as TransformModeValue, a4 as TransformSpaceValue, a5 as VideoComponent, a6 as normalizePhysicsState } from './Video-BWhbvVPg.js';
+import { P as ParentId, T as TransformComponent, a as TransformData, V as Vec3 } from './System-BTyYvKVH.js';
 
 declare const index_AnimationComponent: typeof AnimationComponent;
 declare const index_AnimationComponentOptions: typeof AnimationComponentOptions;

package/dist/{index-B4-YyUNR.d.cts → index-KdEzEZox.d.cts}

@@ -1,5 +1,5 @@
-import { A as AnimationComponent, a as AnimationComponentOptions, b as AudioComponent, C as CameraComponent, c as CameraComponentOptions, d as CameraProjection, e as CameraRuntimeType, f as ColliderShape, g as ColliderState, h as CubeMeshParameters, D as DEFAULT_COLLIDER_STATE, i as DEFAULT_ENVIRONMENT_STATE, j as DEFAULT_MESH_GEOMETRY_PARAMETERS, k as DEFAULT_PHYSICS_STATE, l as DEFAULT_POSTPROCESSING_STATE, m as DEFAULT_RIGIDBODY_STATE, E as EditableMeshObjectKind, n as EntityType, o as Environment, p as EnvironmentFogState, q as EnvironmentFogType, r as EnvironmentGradientEffect, s as EnvironmentSkyboxState, t as EnvironmentSkyboxType, u as EnvironmentState, I as ImageComponent, v as ImageTarget, w as ImageTargetAnchor, x as ImageTargetAnchorOptions, y as ImageTargetReference, L as LightComponent, z as LightValueState, M as MaterialComponent, B as MaterialTypeValue, F as MaterialValueState, G as MeshComponent, H as MeshGeometryComponent, J as MeshGeometryParameters, K as MeshGeometryParametersByKind, N as ModelComponent, O as Name, P as Object3DRef, Q as PhysicsComponent, R as PhysicsState, S as PlaneMeshParameters, T as Postprocessing, U as PostprocessingState, V as RadiusHeightMeshParameters, W as RadiusMeshParameters, X as RigidbodyState, Y as RigidbodyType, Z as ScriptComponent, _ as ScriptEntry, $ as Selectable, a0 as SelectionTransformState, a1 as SpriteComponent, a2 as TextureFilteringValue, a3 as TransformModeValue, a4 as TransformSpaceValue, a5 as VideoComponent, a6 as normalizePhysicsState } from './Video-CDemv74U.cjs';
-import { P as ParentId, T as TransformComponent, a as TransformData, V as Vec3 } from './System-rXAmagXA.cjs';
+import { A as AnimationComponent, a as AnimationComponentOptions, b as AudioComponent, C as CameraComponent, c as CameraComponentOptions, d as CameraProjection, e as CameraRuntimeType, f as ColliderShape, g as ColliderState, h as CubeMeshParameters, D as DEFAULT_COLLIDER_STATE, i as DEFAULT_ENVIRONMENT_STATE, j as DEFAULT_MESH_GEOMETRY_PARAMETERS, k as DEFAULT_PHYSICS_STATE, l as DEFAULT_POSTPROCESSING_STATE, m as DEFAULT_RIGIDBODY_STATE, E as EditableMeshObjectKind, n as EntityType, o as Environment, p as EnvironmentFogState, q as EnvironmentFogType, r as EnvironmentGradientEffect, s as EnvironmentSkyboxState, t as EnvironmentSkyboxType, u as EnvironmentState, I as ImageComponent, v as ImageTarget, w as ImageTargetAnchor, x as ImageTargetAnchorOptions, y as ImageTargetReference, L as LightComponent, z as LightValueState, M as MaterialComponent, B as MaterialTypeValue, F as MaterialValueState, G as MeshComponent, H as MeshGeometryComponent, J as MeshGeometryParameters, K as MeshGeometryParametersByKind, N as ModelComponent, O as Name, P as Object3DRef, Q as PhysicsComponent, R as PhysicsState, S as PlaneMeshParameters, T as Postprocessing, U as PostprocessingState, V as RadiusHeightMeshParameters, W as RadiusMeshParameters, X as RigidbodyState, Y as RigidbodyType, Z as ScriptComponent, _ as ScriptEntry, $ as Selectable, a0 as SelectionTransformState, a1 as SpriteComponent, a2 as TextureFilteringValue, a3 as TransformModeValue, a4 as TransformSpaceValue, a5 as VideoComponent, a6 as normalizePhysicsState } from './Video-D2H5H-K3.cjs';
+import { P as ParentId, T as TransformComponent, a as TransformData, V as Vec3 } from './System-BTyYvKVH.cjs';
 
 declare const index_AnimationComponent: typeof AnimationComponent;
 declare const index_AnimationComponentOptions: typeof AnimationComponentOptions;

package/dist/index.cjs

@@ -6825,6 +6825,7 @@ var _World = class _World {
     this.storeListeners = /* @__PURE__ */ new Set();
     this.components = /* @__PURE__ */ new Map();
     this.inputSystem = null;
+    this.objectManagementSystem = null;
     this.rapierModule = null;
     this.rapierModulePromise = null;
     this.physicsWorld = null;
@@ -7202,6 +7203,7 @@ var _World = class _World {
       );
     }
     this.isEditor = isEditor ?? false;
+    this.objectManagementSystem = objectManagementSystem;
     return {
       objectManagementSystem,
       transformSyncSystem,
@@ -7352,6 +7354,14 @@ var _World = class _World {
     }
     return this.toEntityView(entityId);
   }
+  getObjectManagementSystem() {
+    if (this.objectManagementSystem) return this.objectManagementSystem;
+    const objectManagementSystem = this.systems.find(
+      (system) => system.constructor.name === "ObjectManagementSystem"
+    );
+    this.objectManagementSystem = objectManagementSystem;
+    return this.objectManagementSystem;
+  }
   /**
    * Cast a ray from `origin` along `direction` and return every intersected
    * entity-bound mesh, sorted by distance. Each result is a standard