@relu-interactives/spatial-ecs 0.2.20 → 0.2.22

package/dist/{System-BjwOBx81.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`
  *
@@ -523,6 +524,10 @@ declare function remapSnapshotEntityIds(snapshot: SubtreeSnapshot, idMap: Map<nu
 };
 
 declare const PREFAB_FILE_VERSION = 1;
+/** Written for files containing NESTED instances (parse accepts either). */
+declare const PREFAB_FILE_VERSION_NESTED = 2;
+/** File version to write for a given snapshot: 2 iff it nests instances. */
+declare function prefabFileVersionFor(snapshot: SubtreeSnapshot): number;
 /**
  * Envelope of a `.prefab` asset file (and, later, `.scene` assets — same
  * shape with `type: "scene"`). `snapshot` is the same columnar world-snapshot
@@ -607,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;
@@ -1114,4 +1119,4 @@ interface EcsSystem {
     dispose?(world: World): void;
 }
 
-export { TransformSyncSystem as $, type AssetInput as A, type EcsComponentFactoryKind as B, Component as C, DEFAULT_ENVIRONMENT_STATE as D, Environment as E, type EcsEntityEditorKind as F, type EntityInput as G, type FloatInput as H, InputSystem as I, type IntersectionResult as J, type KeyboardKey as K, KeyboardKeys as L, type MouseButton as M, PREFAB_FILE_VERSION as N, ObjectManagementSystem as O, ParentId as P, type PrefabAsset as Q, type RemapSnapshotOptions as R, type SpawnPrefabSource as S, TransformComponent as T, RenderSystem as U, type Vec3$1 as V, type WorldEntityView$1 as W, type SelectionListener as X, type SliderInput as Y, type TextInput as Z, type ToggleInput as _, DEFAULT_POSTPROCESSING_STATE as a, type Vec3 as a0, type Vector2Input as a1, type Vector3Input as a2, clearPrefabCache as a3, despawnPrefab as a4, loadPrefab as a5, parsePrefabAsset as a6, remapSnapshotEntityIds as a7, setPrefabAssetUrlResolver as a8, spawnPrefab as a9, type AnyComponent as aa, DEBUG_CHANGE_IGNORED_SYSTEMS as ab, type WorldHistorySnapshot as ac, cloneHistoryValue as ad, normalizeDebugValue as ae, type EnvironmentFogState as b, type EnvironmentFogType as c, type EnvironmentGradientEffect as d, type EnvironmentSkyboxState as e, type EnvironmentSkyboxType as f, type EnvironmentState as g, Postprocessing as h, type PostprocessingState as i, type TransformData as j, type EcsSystem as k, World as l, type SpawnPrefabOptions as m, type ComponentClass as n, type ParentLookup as o, type EcsEntityKind as p, type EntityId as q, type SubtreeSnapshot as r, type ExternalRefWarning as s, type CheckboxInput as t, type ColorInput as u, type ComponentFactory as v, type ComponentInput as w, type ComponentKind as x, type DropdownInput as y, type DropdownOption as z };
+export { type ToggleInput as $, type AssetInput as A, type EcsComponentFactoryKind as B, Component as C, DEFAULT_ENVIRONMENT_STATE as D, Environment as E, type EcsEntityEditorKind as F, type EntityInput as G, type FloatInput as H, InputSystem as I, type IntersectionResult as J, type KeyboardKey as K, KeyboardKeys as L, type MouseButton as M, PREFAB_FILE_VERSION as N, ObjectManagementSystem as O, ParentId as P, PREFAB_FILE_VERSION_NESTED as Q, type PrefabAsset as R, type SpawnPrefabSource as S, TransformComponent as T, type RemapSnapshotOptions as U, type Vec3$1 as V, type WorldEntityView$1 as W, RenderSystem as X, type SelectionListener as Y, type SliderInput as Z, type TextInput as _, DEFAULT_POSTPROCESSING_STATE as a, TransformSyncSystem as a0, type Vec3 as a1, type Vector2Input as a2, type Vector3Input as a3, clearPrefabCache as a4, despawnPrefab as a5, loadPrefab as a6, parsePrefabAsset as a7, prefabFileVersionFor as a8, remapSnapshotEntityIds as a9, setPrefabAssetUrlResolver as aa, spawnPrefab as ab, type AnyComponent as ac, DEBUG_CHANGE_IGNORED_SYSTEMS as ad, type WorldHistorySnapshot as ae, cloneHistoryValue as af, normalizeDebugValue as ag, type EnvironmentFogState as b, type EnvironmentFogType as c, type EnvironmentGradientEffect as d, type EnvironmentSkyboxState as e, type EnvironmentSkyboxType as f, type EnvironmentState as g, Postprocessing as h, type PostprocessingState as i, type TransformData as j, type EcsSystem as k, World as l, type SpawnPrefabOptions as m, type ComponentClass as n, type ParentLookup as o, type EcsEntityKind as p, type SubtreeSnapshot as q, type EntityId as r, type ExternalRefWarning as s, type CheckboxInput as t, type ColorInput as u, type ComponentFactory as v, type ComponentInput as w, type ComponentKind as x, type DropdownInput as y, type DropdownOption as z };

package/dist/{System-BjwOBx81.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`
  *
@@ -523,6 +524,10 @@ declare function remapSnapshotEntityIds(snapshot: SubtreeSnapshot, idMap: Map<nu
 };
 
 declare const PREFAB_FILE_VERSION = 1;
+/** Written for files containing NESTED instances (parse accepts either). */
+declare const PREFAB_FILE_VERSION_NESTED = 2;
+/** File version to write for a given snapshot: 2 iff it nests instances. */
+declare function prefabFileVersionFor(snapshot: SubtreeSnapshot): number;
 /**
  * Envelope of a `.prefab` asset file (and, later, `.scene` assets — same
  * shape with `type: "scene"`). `snapshot` is the same columnar world-snapshot
@@ -607,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;
@@ -1114,4 +1119,4 @@ interface EcsSystem {
     dispose?(world: World): void;
 }
 
-export { TransformSyncSystem as $, type AssetInput as A, type EcsComponentFactoryKind as B, Component as C, DEFAULT_ENVIRONMENT_STATE as D, Environment as E, type EcsEntityEditorKind as F, type EntityInput as G, type FloatInput as H, InputSystem as I, type IntersectionResult as J, type KeyboardKey as K, KeyboardKeys as L, type MouseButton as M, PREFAB_FILE_VERSION as N, ObjectManagementSystem as O, ParentId as P, type PrefabAsset as Q, type RemapSnapshotOptions as R, type SpawnPrefabSource as S, TransformComponent as T, RenderSystem as U, type Vec3$1 as V, type WorldEntityView$1 as W, type SelectionListener as X, type SliderInput as Y, type TextInput as Z, type ToggleInput as _, DEFAULT_POSTPROCESSING_STATE as a, type Vec3 as a0, type Vector2Input as a1, type Vector3Input as a2, clearPrefabCache as a3, despawnPrefab as a4, loadPrefab as a5, parsePrefabAsset as a6, remapSnapshotEntityIds as a7, setPrefabAssetUrlResolver as a8, spawnPrefab as a9, type AnyComponent as aa, DEBUG_CHANGE_IGNORED_SYSTEMS as ab, type WorldHistorySnapshot as ac, cloneHistoryValue as ad, normalizeDebugValue as ae, type EnvironmentFogState as b, type EnvironmentFogType as c, type EnvironmentGradientEffect as d, type EnvironmentSkyboxState as e, type EnvironmentSkyboxType as f, type EnvironmentState as g, Postprocessing as h, type PostprocessingState as i, type TransformData as j, type EcsSystem as k, World as l, type SpawnPrefabOptions as m, type ComponentClass as n, type ParentLookup as o, type EcsEntityKind as p, type EntityId as q, type SubtreeSnapshot as r, type ExternalRefWarning as s, type CheckboxInput as t, type ColorInput as u, type ComponentFactory as v, type ComponentInput as w, type ComponentKind as x, type DropdownInput as y, type DropdownOption as z };
+export { type ToggleInput as $, type AssetInput as A, type EcsComponentFactoryKind as B, Component as C, DEFAULT_ENVIRONMENT_STATE as D, Environment as E, type EcsEntityEditorKind as F, type EntityInput as G, type FloatInput as H, InputSystem as I, type IntersectionResult as J, type KeyboardKey as K, KeyboardKeys as L, type MouseButton as M, PREFAB_FILE_VERSION as N, ObjectManagementSystem as O, ParentId as P, PREFAB_FILE_VERSION_NESTED as Q, type PrefabAsset as R, type SpawnPrefabSource as S, TransformComponent as T, type RemapSnapshotOptions as U, type Vec3$1 as V, type WorldEntityView$1 as W, RenderSystem as X, type SelectionListener as Y, type SliderInput as Z, type TextInput as _, DEFAULT_POSTPROCESSING_STATE as a, TransformSyncSystem as a0, type Vec3 as a1, type Vector2Input as a2, type Vector3Input as a3, clearPrefabCache as a4, despawnPrefab as a5, loadPrefab as a6, parsePrefabAsset as a7, prefabFileVersionFor as a8, remapSnapshotEntityIds as a9, setPrefabAssetUrlResolver as aa, spawnPrefab as ab, type AnyComponent as ac, DEBUG_CHANGE_IGNORED_SYSTEMS as ad, type WorldHistorySnapshot as ae, cloneHistoryValue as af, normalizeDebugValue as ag, type EnvironmentFogState as b, type EnvironmentFogType as c, type EnvironmentGradientEffect as d, type EnvironmentSkyboxState as e, type EnvironmentSkyboxType as f, type EnvironmentState as g, Postprocessing as h, type PostprocessingState as i, type TransformData as j, type EcsSystem as k, World as l, type SpawnPrefabOptions as m, type ComponentClass as n, type ParentLookup as o, type EcsEntityKind as p, type SubtreeSnapshot as q, type EntityId as r, type ExternalRefWarning as s, type CheckboxInput as t, type ColorInput as u, type ComponentFactory as v, type ComponentInput as w, type ComponentKind as x, type DropdownInput as y, type DropdownOption as z };

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

@@ -1,5 +1,5 @@
 import * as THREE from 'three';
-import { C as Component, p as EcsEntityKind, F as EcsEntityEditorKind, q as EntityId } from './System-BjwOBx81.cjs';
+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-B9z5AtIf.d.ts → Video-ppAXaKt0.d.cts}

@@ -1,5 +1,5 @@
 import * as THREE from 'three';
-import { C as Component, p as EcsEntityKind, F as EcsEntityEditorKind, q as EntityId } from './System-BjwOBx81.js';
+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 };