@relu-interactives/spatial-ecs 0.2.21 → 0.2.22

package/dist/systems/index.d.cts

@@ -1,5 +1,5 @@
-import { k as EcsSystem, l as World } from '../System-me3iAcMF.cjs';
-export { v as ComponentFactory, B as EcsComponentFactoryKind, I as InputSystem, K as KeyboardKey, L as KeyboardKeys, M as MouseButton, O as ObjectManagementSystem, X as RenderSystem, a0 as TransformSyncSystem } from '../System-me3iAcMF.cjs';
+import { k as EcsSystem, l as World } from '../System-CYWZ_Zx5.cjs';
+export { v as ComponentFactory, B as EcsComponentFactoryKind, I as InputSystem, K as KeyboardKey, L as KeyboardKeys, M as MouseButton, O as ObjectManagementSystem, X as RenderSystem, a0 as TransformSyncSystem } from '../System-CYWZ_Zx5.cjs';
 import * as THREE from 'three';
 import '@dimforge/rapier3d-compat';
 
@@ -122,7 +122,15 @@ declare class InstancedMeshSystem implements EcsSystem {
     update(world: World): void;
 }
 
+/**
+ * Shared infrastructure for the script-hosting systems (`ScriptBehaviourSystem`
+ * and `ScriptObjectSystem`): module loading, class resolution, data-envelope
+ * merge/resolve/serialize. Extracted verbatim from `ScriptBehaviourSystem` so
+ * both systems stay behaviourally identical for the parts they share.
+ */
+/** Resolves a script URL to its ES module namespace. */
 type ModuleLoader = (scriptUrl: string) => Promise<Record<string, unknown>>;
+
 /**
  * Optional context that enables raycast-based onSelect / onDeselect dispatch.
  * When provided, pointer/touch taps on the canvas fire a raycast against the
@@ -166,6 +174,39 @@ declare class ScriptBehaviourSystem implements EcsSystem {
     private loadBehaviour;
 }
 
+/** Tags the Object3D a script's `build()` returned, so reloads can find/remove it. */
+declare const SCRIPT_OBJECT_ROOT_FLAG = "__scriptObjectRoot";
+/**
+ * Builds, ticks, and disposes {@link ScriptObject} scripts. Unlike
+ * `ScriptBehaviourSystem`, this runs in the editor AND at runtime — there is NO
+ * `isEditorMode` gating anywhere here. A script's `build()` output is attached
+ * under the entity's `Object3DRef.object` (so it inherits transform, selection
+ * and visibility). `runtimeState` is written on transitions only (never every
+ * frame).
+ *
+ * Construct it and pass it to `World.setup({ systems })`.
+ *
+ * @category Systems
+ */
+declare class ScriptObjectSystem implements EcsSystem {
+    private readonly moduleLoader;
+    private instances;
+    private loading;
+    /** Bumped by invalidate*() so in-flight loads that predate it are discarded. */
+    private epoch;
+    constructor(moduleLoader?: ModuleLoader);
+    update(world: World, deltaTime: number): void;
+    private loadScriptObject;
+    /** Dispose a record's instance + built subtree. `keepTombstone` leaves an error marker. */
+    private teardownRecord;
+    private markError;
+    /** Dispose all live instances so the next update() reloads with fresh modules. */
+    invalidateAll(): void;
+    /** Invalidate only the entities whose script matches `scriptUrl`. */
+    invalidate(scriptUrl: string): void;
+    dispose(world: World): void;
+}
+
 /**
  * Reconciles `AudioComponent` state with the underlying THREE.js audio objects
  * each frame.
@@ -235,4 +276,4 @@ declare class VideoSystem implements EcsSystem {
     dispose(_world: World): void;
 }
 
-export { AnimationSystem, AudioSystem, CameraSyncSystem, EnvironmentSyncSystem, InstancedMeshSystem, LightSyncSystem, MaterialSyncSystem, MeshGeometrySystem, ObjectVisibilitySystem, PhysicsSyncSystem, PostprocessingSyncSystem, ScriptBehaviourSystem, type SelectionContext, VideoSystem };
+export { AnimationSystem, AudioSystem, CameraSyncSystem, EnvironmentSyncSystem, InstancedMeshSystem, LightSyncSystem, MaterialSyncSystem, MeshGeometrySystem, type ModuleLoader, ObjectVisibilitySystem, PhysicsSyncSystem, PostprocessingSyncSystem, SCRIPT_OBJECT_ROOT_FLAG, ScriptBehaviourSystem, ScriptObjectSystem, type SelectionContext, VideoSystem };

package/dist/systems/index.d.ts

@@ -1,5 +1,5 @@
-import { k as EcsSystem, l as World } from '../System-me3iAcMF.js';
-export { v as ComponentFactory, B as EcsComponentFactoryKind, I as InputSystem, K as KeyboardKey, L as KeyboardKeys, M as MouseButton, O as ObjectManagementSystem, X as RenderSystem, a0 as TransformSyncSystem } from '../System-me3iAcMF.js';
+import { k as EcsSystem, l as World } from '../System-CYWZ_Zx5.js';
+export { v as ComponentFactory, B as EcsComponentFactoryKind, I as InputSystem, K as KeyboardKey, L as KeyboardKeys, M as MouseButton, O as ObjectManagementSystem, X as RenderSystem, a0 as TransformSyncSystem } from '../System-CYWZ_Zx5.js';
 import * as THREE from 'three';
 import '@dimforge/rapier3d-compat';
 
@@ -122,7 +122,15 @@ declare class InstancedMeshSystem implements EcsSystem {
     update(world: World): void;
 }
 
+/**
+ * Shared infrastructure for the script-hosting systems (`ScriptBehaviourSystem`
+ * and `ScriptObjectSystem`): module loading, class resolution, data-envelope
+ * merge/resolve/serialize. Extracted verbatim from `ScriptBehaviourSystem` so
+ * both systems stay behaviourally identical for the parts they share.
+ */
+/** Resolves a script URL to its ES module namespace. */
 type ModuleLoader = (scriptUrl: string) => Promise<Record<string, unknown>>;
+
 /**
  * Optional context that enables raycast-based onSelect / onDeselect dispatch.
  * When provided, pointer/touch taps on the canvas fire a raycast against the
@@ -166,6 +174,39 @@ declare class ScriptBehaviourSystem implements EcsSystem {
     private loadBehaviour;
 }
 
+/** Tags the Object3D a script's `build()` returned, so reloads can find/remove it. */
+declare const SCRIPT_OBJECT_ROOT_FLAG = "__scriptObjectRoot";
+/**
+ * Builds, ticks, and disposes {@link ScriptObject} scripts. Unlike
+ * `ScriptBehaviourSystem`, this runs in the editor AND at runtime — there is NO
+ * `isEditorMode` gating anywhere here. A script's `build()` output is attached
+ * under the entity's `Object3DRef.object` (so it inherits transform, selection
+ * and visibility). `runtimeState` is written on transitions only (never every
+ * frame).
+ *
+ * Construct it and pass it to `World.setup({ systems })`.
+ *
+ * @category Systems
+ */
+declare class ScriptObjectSystem implements EcsSystem {
+    private readonly moduleLoader;
+    private instances;
+    private loading;
+    /** Bumped by invalidate*() so in-flight loads that predate it are discarded. */
+    private epoch;
+    constructor(moduleLoader?: ModuleLoader);
+    update(world: World, deltaTime: number): void;
+    private loadScriptObject;
+    /** Dispose a record's instance + built subtree. `keepTombstone` leaves an error marker. */
+    private teardownRecord;
+    private markError;
+    /** Dispose all live instances so the next update() reloads with fresh modules. */
+    invalidateAll(): void;
+    /** Invalidate only the entities whose script matches `scriptUrl`. */
+    invalidate(scriptUrl: string): void;
+    dispose(world: World): void;
+}
+
 /**
  * Reconciles `AudioComponent` state with the underlying THREE.js audio objects
  * each frame.
@@ -235,4 +276,4 @@ declare class VideoSystem implements EcsSystem {
     dispose(_world: World): void;
 }
 
-export { AnimationSystem, AudioSystem, CameraSyncSystem, EnvironmentSyncSystem, InstancedMeshSystem, LightSyncSystem, MaterialSyncSystem, MeshGeometrySystem, ObjectVisibilitySystem, PhysicsSyncSystem, PostprocessingSyncSystem, ScriptBehaviourSystem, type SelectionContext, VideoSystem };
+export { AnimationSystem, AudioSystem, CameraSyncSystem, EnvironmentSyncSystem, InstancedMeshSystem, LightSyncSystem, MaterialSyncSystem, MeshGeometrySystem, type ModuleLoader, ObjectVisibilitySystem, PhysicsSyncSystem, PostprocessingSyncSystem, SCRIPT_OBJECT_ROOT_FLAG, ScriptBehaviourSystem, ScriptObjectSystem, type SelectionContext, VideoSystem };

package/dist/systems/index.js

@@ -1,6 +1,6 @@
-export { AnimationSystem, AudioSystem, CameraSyncSystem, EnvironmentSyncSystem, InputSystem, InstancedMeshSystem, KeyboardKeys, LightSyncSystem, MaterialSyncSystem, MeshGeometrySystem, ObjectVisibilitySystem, PhysicsSyncSystem, PostprocessingSyncSystem, RenderSystem, ScriptBehaviourSystem, TransformSyncSystem, VideoSystem } from '../chunk-5U3YS4JD.js';
-export { ObjectManagementSystem } from '../chunk-AXRCGF63.js';
-import '../chunk-V7BNVTJW.js';
+export { AnimationSystem, AudioSystem, CameraSyncSystem, EnvironmentSyncSystem, InputSystem, InstancedMeshSystem, KeyboardKeys, LightSyncSystem, MaterialSyncSystem, MeshGeometrySystem, ObjectVisibilitySystem, PhysicsSyncSystem, PostprocessingSyncSystem, RenderSystem, SCRIPT_OBJECT_ROOT_FLAG, ScriptBehaviourSystem, ScriptObjectSystem, TransformSyncSystem, VideoSystem } from '../chunk-GZ2NKSMV.js';
+export { ObjectManagementSystem } from '../chunk-WKGCC7YL.js';
+import '../chunk-JHCPRVBC.js';
 import '../chunk-OY7ZODZP.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/types.d.cts

@@ -1,3 +1,3 @@
 import 'three';
-export { A as AssetInput, t as CheckboxInput, u as ColorInput, w as ComponentInput, x as ComponentKind, y as DropdownInput, z as DropdownOption, F as EcsEntityEditorKind, p as EcsEntityKind, r as EntityId, G as EntityInput, H as FloatInput, J as IntersectionResult, o as ParentLookup, Y as SelectionListener, Z as SliderInput, _ as TextInput, $ as ToggleInput, a1 as Vec3, a2 as Vector2Input, a3 as Vector3Input, W as WorldEntityView } from './System-me3iAcMF.cjs';
+export { A as AssetInput, t as CheckboxInput, u as ColorInput, w as ComponentInput, x as ComponentKind, y as DropdownInput, z as DropdownOption, F as EcsEntityEditorKind, p as EcsEntityKind, r as EntityId, G as EntityInput, H as FloatInput, J as IntersectionResult, o as ParentLookup, Y as SelectionListener, Z as SliderInput, _ as TextInput, $ as ToggleInput, a1 as Vec3, a2 as Vector2Input, a3 as Vector3Input, W as WorldEntityView } from './System-CYWZ_Zx5.cjs';
 import '@dimforge/rapier3d-compat';

package/dist/types.d.ts

@@ -1,3 +1,3 @@
 import 'three';
-export { A as AssetInput, t as CheckboxInput, u as ColorInput, w as ComponentInput, x as ComponentKind, y as DropdownInput, z as DropdownOption, F as EcsEntityEditorKind, p as EcsEntityKind, r as EntityId, G as EntityInput, H as FloatInput, J as IntersectionResult, o as ParentLookup, Y as SelectionListener, Z as SliderInput, _ as TextInput, $ as ToggleInput, a1 as Vec3, a2 as Vector2Input, a3 as Vector3Input, W as WorldEntityView } from './System-me3iAcMF.js';
+export { A as AssetInput, t as CheckboxInput, u as ColorInput, w as ComponentInput, x as ComponentKind, y as DropdownInput, z as DropdownOption, F as EcsEntityEditorKind, p as EcsEntityKind, r as EntityId, G as EntityInput, H as FloatInput, J as IntersectionResult, o as ParentLookup, Y as SelectionListener, Z as SliderInput, _ as TextInput, $ as ToggleInput, a1 as Vec3, a2 as Vector2Input, a3 as Vector3Input, W as WorldEntityView } from './System-CYWZ_Zx5.js';
 import '@dimforge/rapier3d-compat';

package/dist/worldSnapshotUtils.d.cts

@@ -1,3 +1,3 @@
-export { ac as AnyComponent, n as ComponentClass, ad as DEBUG_CHANGE_IGNORED_SYSTEMS, ae as WorldHistorySnapshot, af as cloneHistoryValue, ag as normalizeDebugValue } from './System-me3iAcMF.cjs';
+export { ac as AnyComponent, n as ComponentClass, ad as DEBUG_CHANGE_IGNORED_SYSTEMS, ae as WorldHistorySnapshot, af as cloneHistoryValue, ag as normalizeDebugValue } from './System-CYWZ_Zx5.cjs';
 import 'three';
 import '@dimforge/rapier3d-compat';

package/dist/worldSnapshotUtils.d.ts

@@ -1,3 +1,3 @@
-export { ac as AnyComponent, n as ComponentClass, ad as DEBUG_CHANGE_IGNORED_SYSTEMS, ae as WorldHistorySnapshot, af as cloneHistoryValue, ag as normalizeDebugValue } from './System-me3iAcMF.js';
+export { ac as AnyComponent, n as ComponentClass, ad as DEBUG_CHANGE_IGNORED_SYSTEMS, ae as WorldHistorySnapshot, af as cloneHistoryValue, ag as normalizeDebugValue } from './System-CYWZ_Zx5.js';
 import 'three';
 import '@dimforge/rapier3d-compat';

package/package.json

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