@relu-interactives/spatial-ecs 0.2.21 → 0.2.22

package/dist/{System-me3iAcMF.d.cts → System-CYWZ_Zx5.d.cts}

@@ -333,7 +333,7 @@ type EntityId = number;
  * maps to an object factory in `core/factories/objects/*` that creates the
  * baseline component set.
  */
-type EcsEntityKind = "cube" | "sphere" | "plane" | "capsule" | "cylinder" | "empty" | "model" | "image" | "imageTarget" | "sprite" | "audio" | "camera" | "video" | "ambientLight" | "directionalLight" | "pointLight" | "spotLight" | "areaLight" | "instancedMesh" | "instanceSlot";
+type EcsEntityKind = "cube" | "sphere" | "plane" | "capsule" | "cylinder" | "empty" | "model" | "image" | "imageTarget" | "sprite" | "audio" | "camera" | "video" | "ambientLight" | "directionalLight" | "pointLight" | "spotLight" | "areaLight" | "instancedMesh" | "instanceSlot" | "scriptObject";
 /** {@link EcsEntityKind} extended with editor-only utility entities (gizmos, helpers). */
 type EcsEntityEditorKind = EcsEntityKind | "editorUtility";
 /** Callback invoked when the selected entity changes. `null` indicates a deselection. */
@@ -377,7 +377,7 @@ type EntityInput = {
     type: "entity";
     value: EntityId | null;
 };
-type ComponentKind = "Animation" | "Audio" | "Camera" | "Environment" | "EntityType" | "Image" | "ImageTarget" | "ImageTargetAnchor" | "InstancedMesh" | "InstanceSlot" | "Light" | "Material" | "Mesh" | "MeshGeometry" | "Model" | "Name" | "Object3DRef" | "ParentId" | "Physics" | "Postprocessing" | "Script" | "Selectable" | "SelectionTransformState" | "Sprite" | "Transform" | "Video";
+type ComponentKind = "Animation" | "Audio" | "Camera" | "Environment" | "EntityType" | "Image" | "ImageTarget" | "ImageTargetAnchor" | "InstancedMesh" | "InstanceSlot" | "Light" | "Material" | "Mesh" | "MeshGeometry" | "Model" | "Name" | "Object3DRef" | "ParentId" | "Physics" | "Postprocessing" | "Script" | "ScriptObject" | "Selectable" | "SelectionTransformState" | "Sprite" | "Transform" | "Video";
 /**
  * Inspector field that lets the user drag an entity and optionally pick a
  * component from it.
@@ -476,6 +476,7 @@ declare function cloneHistoryValue<T>(value: T, seen?: WeakMap<object, unknown>)
  *   - `ParentId.value`
  *   - `ScriptComponent.entries[].data` EntityInput (`{type:"entity", value}`)
  *     and ComponentInput (`{type:"component", value:{entityId, …}}`)
+ *   - `ScriptObjectComponent.data` EntityInput/ComponentInput (same shapes)
  *   - `InstancedMeshComponent.instanceEntityIds[]`
  *   - `InstanceSlotComponent.groupEntityId`
  *
@@ -611,7 +612,7 @@ type CreateContext = {
     isEditor?: boolean;
 };
 type EntityFactory = (context: CreateContext) => EntityId;
-type EcsComponentFactoryKind = "animation" | "audio" | "camera" | "environment" | "entityType" | "image" | "imageTargetAnchor" | "imageTarget" | "light" | "material" | "mesh" | "meshGeometry" | "model" | "name" | "object3DRef" | "parentId" | "physics" | "postprocessing" | "script" | "selectable" | "selectionTransformState" | "sprite" | "transform" | "video" | "instancedMesh";
+type EcsComponentFactoryKind = "animation" | "audio" | "camera" | "environment" | "entityType" | "image" | "imageTargetAnchor" | "imageTarget" | "light" | "material" | "mesh" | "meshGeometry" | "model" | "name" | "object3DRef" | "parentId" | "physics" | "postprocessing" | "script" | "scriptObject" | "selectable" | "selectionTransformState" | "sprite" | "transform" | "video" | "instancedMesh";
 type ComponentFactory = (world: World, entityId: EntityId, ...args: any[]) => unknown;
 declare class ObjectManagementSystem implements EcsSystem {
     private readonly scene;

package/dist/{System-me3iAcMF.d.ts → System-CYWZ_Zx5.d.ts}

@@ -333,7 +333,7 @@ type EntityId = number;
  * maps to an object factory in `core/factories/objects/*` that creates the
  * baseline component set.
  */
-type EcsEntityKind = "cube" | "sphere" | "plane" | "capsule" | "cylinder" | "empty" | "model" | "image" | "imageTarget" | "sprite" | "audio" | "camera" | "video" | "ambientLight" | "directionalLight" | "pointLight" | "spotLight" | "areaLight" | "instancedMesh" | "instanceSlot";
+type EcsEntityKind = "cube" | "sphere" | "plane" | "capsule" | "cylinder" | "empty" | "model" | "image" | "imageTarget" | "sprite" | "audio" | "camera" | "video" | "ambientLight" | "directionalLight" | "pointLight" | "spotLight" | "areaLight" | "instancedMesh" | "instanceSlot" | "scriptObject";
 /** {@link EcsEntityKind} extended with editor-only utility entities (gizmos, helpers). */
 type EcsEntityEditorKind = EcsEntityKind | "editorUtility";
 /** Callback invoked when the selected entity changes. `null` indicates a deselection. */
@@ -377,7 +377,7 @@ type EntityInput = {
     type: "entity";
     value: EntityId | null;
 };
-type ComponentKind = "Animation" | "Audio" | "Camera" | "Environment" | "EntityType" | "Image" | "ImageTarget" | "ImageTargetAnchor" | "InstancedMesh" | "InstanceSlot" | "Light" | "Material" | "Mesh" | "MeshGeometry" | "Model" | "Name" | "Object3DRef" | "ParentId" | "Physics" | "Postprocessing" | "Script" | "Selectable" | "SelectionTransformState" | "Sprite" | "Transform" | "Video";
+type ComponentKind = "Animation" | "Audio" | "Camera" | "Environment" | "EntityType" | "Image" | "ImageTarget" | "ImageTargetAnchor" | "InstancedMesh" | "InstanceSlot" | "Light" | "Material" | "Mesh" | "MeshGeometry" | "Model" | "Name" | "Object3DRef" | "ParentId" | "Physics" | "Postprocessing" | "Script" | "ScriptObject" | "Selectable" | "SelectionTransformState" | "Sprite" | "Transform" | "Video";
 /**
  * Inspector field that lets the user drag an entity and optionally pick a
  * component from it.
@@ -476,6 +476,7 @@ declare function cloneHistoryValue<T>(value: T, seen?: WeakMap<object, unknown>)
  *   - `ParentId.value`
  *   - `ScriptComponent.entries[].data` EntityInput (`{type:"entity", value}`)
  *     and ComponentInput (`{type:"component", value:{entityId, …}}`)
+ *   - `ScriptObjectComponent.data` EntityInput/ComponentInput (same shapes)
  *   - `InstancedMeshComponent.instanceEntityIds[]`
  *   - `InstanceSlotComponent.groupEntityId`
  *
@@ -611,7 +612,7 @@ type CreateContext = {
     isEditor?: boolean;
 };
 type EntityFactory = (context: CreateContext) => EntityId;
-type EcsComponentFactoryKind = "animation" | "audio" | "camera" | "environment" | "entityType" | "image" | "imageTargetAnchor" | "imageTarget" | "light" | "material" | "mesh" | "meshGeometry" | "model" | "name" | "object3DRef" | "parentId" | "physics" | "postprocessing" | "script" | "selectable" | "selectionTransformState" | "sprite" | "transform" | "video" | "instancedMesh";
+type EcsComponentFactoryKind = "animation" | "audio" | "camera" | "environment" | "entityType" | "image" | "imageTargetAnchor" | "imageTarget" | "light" | "material" | "mesh" | "meshGeometry" | "model" | "name" | "object3DRef" | "parentId" | "physics" | "postprocessing" | "script" | "scriptObject" | "selectable" | "selectionTransformState" | "sprite" | "transform" | "video" | "instancedMesh";
 type ComponentFactory = (world: World, entityId: EntityId, ...args: any[]) => unknown;
 declare class ObjectManagementSystem implements EcsSystem {
     private readonly scene;

package/dist/{Video-DHnxjGhW.d.ts → Video-C1IOat7L.d.ts}

@@ -1,5 +1,5 @@
 import * as THREE from 'three';
-import { C as Component, p as EcsEntityKind, F as EcsEntityEditorKind, r as EntityId } from './System-me3iAcMF.js';
+import { C as Component, p as EcsEntityKind, F as EcsEntityEditorKind, r as EntityId } from './System-CYWZ_Zx5.js';
 import * as RAPIER from '@dimforge/rapier3d-compat';
 
 interface StateMachine {
@@ -939,13 +939,6 @@ type ScriptEntry = {
     scriptUrl: string;
     /** When `false`, the script is skipped each frame. */
     enabled: boolean;
-    /**
-     * When `true`, the script is executed inside the editor (not just at preview/runtime).
-     * Enables direct Three.js scene access via `this.world.getScene()` / `getCamera()` /
-     * `getRenderer()` for logic the editor's object palette cannot produce (custom shaders,
-     * procedural geometry, grass, etc.). Defaults to `false`.
-     */
-    executeInEditor?: boolean;
     /** Inspector-bound payload exposed to the script as `this.data`. */
     data: Record<string, unknown>;
     /** Last load/runtime status reported by `ScriptBehaviourSystem`. */
@@ -974,6 +967,42 @@ declare class ScriptComponent extends Component {
     constructor(entries?: ScriptEntry[]);
 }
 
+type ScriptObjectRuntimeState = "idle" | "loading" | "ready" | "error";
+type ScriptObjectComponentInput = Partial<{
+    /** Compiled script URL (e.g. `localasset://.../scripts/foo.js`). */
+    scriptUrl: string | null;
+    /** Class name exported by the script module. */
+    className: string | null;
+    /** When `false`, the script object is not built/ticked. */
+    enabled: boolean;
+    /** Inspector-bound payload exposed to the script as `this.data`. */
+    data: Record<string, unknown>;
+    /** Last load/build status reported by `ScriptObjectSystem`. */
+    runtimeState: ScriptObjectRuntimeState;
+    /** Optional human-readable status message (e.g. compile/build error). */
+    runtimeMessage: string;
+}>;
+/**
+ * Component for a **script object** — a single {@link ScriptObject} whose
+ * THREE.js visual is built by user code and runs in the editor AND at runtime.
+ * Unlike {@link ScriptComponent} this holds ONE script (not an entries array).
+ * The live instance ref is non-enumerable so it never leaks into save data or
+ * undo history.
+ *
+ * @category Components
+ */
+declare class ScriptObjectComponent extends Component {
+    scriptUrl: string | null;
+    className: string | null;
+    enabled: boolean;
+    data: Record<string, unknown>;
+    runtimeState: ScriptObjectRuntimeState;
+    runtimeMessage?: string;
+    /** Live ScriptObject instance. Non-enumerable — never enters snapshots/history. */
+    instance: unknown | null;
+    constructor(input?: ScriptObjectComponentInput);
+}
+
 /**
  * Toggles whether the editor selection system can pick this entity. When
  * `enabled` is `false`, the entity is excluded from raycast hit tests.
@@ -1127,4 +1156,4 @@ declare class VideoComponent extends Component {
     stop(): void;
 }
 
-export { type TransformSpaceValue as $, AnimationComponent as A, MeshGeometryComponent as B, CameraComponent as C, DEFAULT_COLLIDER_STATE as D, type EditableMeshObjectKind as E, type MeshGeometryParameters as F, type MeshGeometryParametersByKind as G, ModelComponent as H, ImageComponent as I, type PhysicsState as J, type PlaneMeshParameters as K, LightComponent as L, MaterialComponent as M, Name as N, Object3DRef as O, PhysicsComponent as P, type RadiusMeshParameters as Q, type RadiusHeightMeshParameters as R, type RigidbodyState as S, type RigidbodyType as T, ScriptComponent as U, type ScriptEntry as V, Selectable as W, SelectionTransformState as X, SpriteComponent as Y, type TextureFilteringValue as Z, type TransformModeValue as _, type AnimationComponentOptions as a, VideoComponent as a0, defaultMaterialValue as a1, normalizePhysicsState as a2, type AnimationStateCallbacks as a3, AnimationStateMachine as a4, AnimationStateManager as a5, type StateMachine as a6, AudioComponent as b, type CameraComponentOptions as c, type CameraProjection as d, type CameraRuntimeType as e, type ColliderShape as f, type ColliderState as g, type CubeMeshParameters as h, DEFAULT_INSTANCED_MESH_PARAMETERS as i, DEFAULT_INSTANCE_TRANSFORM as j, DEFAULT_MESH_GEOMETRY_PARAMETERS as k, DEFAULT_PHYSICS_STATE as l, DEFAULT_RIGIDBODY_STATE as m, EntityType as n, ImageTarget as o, ImageTargetAnchor as p, type ImageTargetAnchorOptions as q, type ImageTargetReference as r, InstanceSlotComponent as s, type InstanceTransform as t, InstancedMeshComponent as u, type InstancedMeshKind as v, type LightValueState as w, type MaterialTypeValue as x, type MaterialValueState as y, MeshComponent as z };
+export { SpriteComponent as $, AnimationComponent as A, MeshGeometryComponent as B, CameraComponent as C, DEFAULT_COLLIDER_STATE as D, type EditableMeshObjectKind as E, type MeshGeometryParameters as F, type MeshGeometryParametersByKind as G, ModelComponent as H, ImageComponent as I, type PhysicsState as J, type PlaneMeshParameters as K, LightComponent as L, MaterialComponent as M, Name as N, Object3DRef as O, PhysicsComponent as P, type RadiusMeshParameters as Q, type RadiusHeightMeshParameters as R, type RigidbodyState as S, type RigidbodyType as T, ScriptComponent as U, type ScriptEntry as V, ScriptObjectComponent as W, type ScriptObjectComponentInput as X, type ScriptObjectRuntimeState as Y, Selectable as Z, SelectionTransformState as _, type AnimationComponentOptions as a, type TextureFilteringValue as a0, type TransformModeValue as a1, type TransformSpaceValue as a2, VideoComponent as a3, defaultMaterialValue as a4, normalizePhysicsState as a5, type AnimationStateCallbacks as a6, AnimationStateMachine as a7, AnimationStateManager as a8, type StateMachine as a9, AudioComponent as b, type CameraComponentOptions as c, type CameraProjection as d, type CameraRuntimeType as e, type ColliderShape as f, type ColliderState as g, type CubeMeshParameters as h, DEFAULT_INSTANCED_MESH_PARAMETERS as i, DEFAULT_INSTANCE_TRANSFORM as j, DEFAULT_MESH_GEOMETRY_PARAMETERS as k, DEFAULT_PHYSICS_STATE as l, DEFAULT_RIGIDBODY_STATE as m, EntityType as n, ImageTarget as o, ImageTargetAnchor as p, type ImageTargetAnchorOptions as q, type ImageTargetReference as r, InstanceSlotComponent as s, type InstanceTransform as t, InstancedMeshComponent as u, type InstancedMeshKind as v, type LightValueState as w, type MaterialTypeValue as x, type MaterialValueState as y, MeshComponent as z };

package/dist/{Video-U9hAnf9y.d.cts → Video-ppAXaKt0.d.cts}

@@ -1,5 +1,5 @@
 import * as THREE from 'three';
-import { C as Component, p as EcsEntityKind, F as EcsEntityEditorKind, r as EntityId } from './System-me3iAcMF.cjs';
+import { C as Component, p as EcsEntityKind, F as EcsEntityEditorKind, r as EntityId } from './System-CYWZ_Zx5.cjs';
 import * as RAPIER from '@dimforge/rapier3d-compat';
 
 interface StateMachine {
@@ -939,13 +939,6 @@ type ScriptEntry = {
     scriptUrl: string;
     /** When `false`, the script is skipped each frame. */
     enabled: boolean;
-    /**
-     * When `true`, the script is executed inside the editor (not just at preview/runtime).
-     * Enables direct Three.js scene access via `this.world.getScene()` / `getCamera()` /
-     * `getRenderer()` for logic the editor's object palette cannot produce (custom shaders,
-     * procedural geometry, grass, etc.). Defaults to `false`.
-     */
-    executeInEditor?: boolean;
     /** Inspector-bound payload exposed to the script as `this.data`. */
     data: Record<string, unknown>;
     /** Last load/runtime status reported by `ScriptBehaviourSystem`. */
@@ -974,6 +967,42 @@ declare class ScriptComponent extends Component {
     constructor(entries?: ScriptEntry[]);
 }
 
+type ScriptObjectRuntimeState = "idle" | "loading" | "ready" | "error";
+type ScriptObjectComponentInput = Partial<{
+    /** Compiled script URL (e.g. `localasset://.../scripts/foo.js`). */
+    scriptUrl: string | null;
+    /** Class name exported by the script module. */
+    className: string | null;
+    /** When `false`, the script object is not built/ticked. */
+    enabled: boolean;
+    /** Inspector-bound payload exposed to the script as `this.data`. */
+    data: Record<string, unknown>;
+    /** Last load/build status reported by `ScriptObjectSystem`. */
+    runtimeState: ScriptObjectRuntimeState;
+    /** Optional human-readable status message (e.g. compile/build error). */
+    runtimeMessage: string;
+}>;
+/**
+ * Component for a **script object** — a single {@link ScriptObject} whose
+ * THREE.js visual is built by user code and runs in the editor AND at runtime.
+ * Unlike {@link ScriptComponent} this holds ONE script (not an entries array).
+ * The live instance ref is non-enumerable so it never leaks into save data or
+ * undo history.
+ *
+ * @category Components
+ */
+declare class ScriptObjectComponent extends Component {
+    scriptUrl: string | null;
+    className: string | null;
+    enabled: boolean;
+    data: Record<string, unknown>;
+    runtimeState: ScriptObjectRuntimeState;
+    runtimeMessage?: string;
+    /** Live ScriptObject instance. Non-enumerable — never enters snapshots/history. */
+    instance: unknown | null;
+    constructor(input?: ScriptObjectComponentInput);
+}
+
 /**
  * Toggles whether the editor selection system can pick this entity. When
  * `enabled` is `false`, the entity is excluded from raycast hit tests.
@@ -1127,4 +1156,4 @@ declare class VideoComponent extends Component {
     stop(): void;
 }
 
-export { type TransformSpaceValue as $, AnimationComponent as A, MeshGeometryComponent as B, CameraComponent as C, DEFAULT_COLLIDER_STATE as D, type EditableMeshObjectKind as E, type MeshGeometryParameters as F, type MeshGeometryParametersByKind as G, ModelComponent as H, ImageComponent as I, type PhysicsState as J, type PlaneMeshParameters as K, LightComponent as L, MaterialComponent as M, Name as N, Object3DRef as O, PhysicsComponent as P, type RadiusMeshParameters as Q, type RadiusHeightMeshParameters as R, type RigidbodyState as S, type RigidbodyType as T, ScriptComponent as U, type ScriptEntry as V, Selectable as W, SelectionTransformState as X, SpriteComponent as Y, type TextureFilteringValue as Z, type TransformModeValue as _, type AnimationComponentOptions as a, VideoComponent as a0, defaultMaterialValue as a1, normalizePhysicsState as a2, type AnimationStateCallbacks as a3, AnimationStateMachine as a4, AnimationStateManager as a5, type StateMachine as a6, AudioComponent as b, type CameraComponentOptions as c, type CameraProjection as d, type CameraRuntimeType as e, type ColliderShape as f, type ColliderState as g, type CubeMeshParameters as h, DEFAULT_INSTANCED_MESH_PARAMETERS as i, DEFAULT_INSTANCE_TRANSFORM as j, DEFAULT_MESH_GEOMETRY_PARAMETERS as k, DEFAULT_PHYSICS_STATE as l, DEFAULT_RIGIDBODY_STATE as m, EntityType as n, ImageTarget as o, ImageTargetAnchor as p, type ImageTargetAnchorOptions as q, type ImageTargetReference as r, InstanceSlotComponent as s, type InstanceTransform as t, InstancedMeshComponent as u, type InstancedMeshKind as v, type LightValueState as w, type MaterialTypeValue as x, type MaterialValueState as y, MeshComponent as z };
+export { SpriteComponent as $, AnimationComponent as A, MeshGeometryComponent as B, CameraComponent as C, DEFAULT_COLLIDER_STATE as D, type EditableMeshObjectKind as E, type MeshGeometryParameters as F, type MeshGeometryParametersByKind as G, ModelComponent as H, ImageComponent as I, type PhysicsState as J, type PlaneMeshParameters as K, LightComponent as L, MaterialComponent as M, Name as N, Object3DRef as O, PhysicsComponent as P, type RadiusMeshParameters as Q, type RadiusHeightMeshParameters as R, type RigidbodyState as S, type RigidbodyType as T, ScriptComponent as U, type ScriptEntry as V, ScriptObjectComponent as W, type ScriptObjectComponentInput as X, type ScriptObjectRuntimeState as Y, Selectable as Z, SelectionTransformState as _, type AnimationComponentOptions as a, type TextureFilteringValue as a0, type TransformModeValue as a1, type TransformSpaceValue as a2, VideoComponent as a3, defaultMaterialValue as a4, normalizePhysicsState as a5, type AnimationStateCallbacks as a6, AnimationStateMachine as a7, AnimationStateManager as a8, type StateMachine as a9, AudioComponent as b, type CameraComponentOptions as c, type CameraProjection as d, type CameraRuntimeType as e, type ColliderShape as f, type ColliderState as g, type CubeMeshParameters as h, DEFAULT_INSTANCED_MESH_PARAMETERS as i, DEFAULT_INSTANCE_TRANSFORM as j, DEFAULT_MESH_GEOMETRY_PARAMETERS as k, DEFAULT_PHYSICS_STATE as l, DEFAULT_RIGIDBODY_STATE as m, EntityType as n, ImageTarget as o, ImageTargetAnchor as p, type ImageTargetAnchorOptions as q, type ImageTargetReference as r, InstanceSlotComponent as s, type InstanceTransform as t, InstancedMeshComponent as u, type InstancedMeshKind as v, type LightValueState as w, type MaterialTypeValue as x, type MaterialValueState as y, MeshComponent as z };