@relu-interactives/spatial-ecs 0.2.10 → 0.2.12

package/dist/index.d.cts

@@ -1,9 +1,9 @@
-import { E as EcsSystem, C as Component, W as WorldEntityView, T as TransformComponent, b as World, c as ComponentClass, d as ParentLookup, e as EcsEntityKind, O as ObjectManagementSystem } from './System-AV2_87Zr.cjs';
-export { A as AssetInput, f as CheckboxInput, g as ColorInput, h as ComponentFactory, i as ComponentInput, j as ComponentKind, D as DropdownInput, k as DropdownOption, l as EcsComponentFactoryKind, m as EcsEntityEditorKind, n as EntityId, o as EntityInput, F as FloatInput, I as InputSystem, p as IntersectionResult, K as KeyboardKey, q as KeyboardKeys, M as MouseButton, R as RenderSystem, S as SelectionListener, r as SliderInput, s as TextInput, t as ToggleInput, u as TransformSyncSystem, v as Vec3, w as Vector2Input, x as Vector3Input } from './System-AV2_87Zr.cjs';
+import { E as EcsSystem, C as Component, W as WorldEntityView, T as TransformComponent, b as World, c as ComponentClass, d as ParentLookup, e as EcsEntityKind, O as ObjectManagementSystem } from './System-CHCucemW.cjs';
+export { A as AssetInput, f as CheckboxInput, g as ColorInput, h as ComponentFactory, i as ComponentInput, j as ComponentKind, D as DropdownInput, k as DropdownOption, l as EcsComponentFactoryKind, m as EcsEntityEditorKind, n as EntityId, o as EntityInput, F as FloatInput, I as InputSystem, p as IntersectionResult, K as KeyboardKey, q as KeyboardKeys, M as MouseButton, R as RenderSystem, S as SelectionListener, r as SliderInput, s as TextInput, t as ToggleInput, u as TransformSyncSystem, v as Vec3, w as Vector2Input, x as Vector3Input } from './System-CHCucemW.cjs';
 import * as THREE from 'three';
-import { V as Object3DRef } from './Video-Bn93p6XV.cjs';
-export { ad as AnimationStateCallbacks, ae as AnimationStateMachine, af as AnimationStateManager, ag as StateMachine } from './Video-Bn93p6XV.cjs';
-export { i as CoreComponents } from './index-B4-ABchF.cjs';
+import { V as Object3DRef } from './Video-ACTSfWjH.cjs';
+export { ad as AnimationStateCallbacks, ae as AnimationStateMachine, af as AnimationStateManager, ag as StateMachine } from './Video-ACTSfWjH.cjs';
+export { i as CoreComponents } from './index-kx5O2mVU.cjs';
 export { AnimationSystem, AudioSystem, CameraSyncSystem, EnvironmentSyncSystem, InstancedMeshSystem, LightSyncSystem, MaterialSyncSystem, MeshGeometrySystem, ObjectVisibilitySystem, PhysicsSyncSystem, PostprocessingSyncSystem, ScriptBehaviourSystem, SelectionContext, VideoSystem } from './systems/index.cjs';
 export { createAnimationComponent, createAudioComponent, createCameraComponent, createEntityTypeComponent, createEnvironmentComponent, createImageComponent, createImageTargetAnchorComponent, createImageTargetComponent, createInstanceSlotComponent, createInstancedMeshComponent, createLightComponent, createMaterialComponent, createMeshComponent, createMeshGeometryComponent, createModelComponent, createNameComponent, createObject3DRefComponent, createParentIdComponent, createPhysicsComponent, createPostprocessingComponent, createScriptComponent, createSelectableComponent, createSelectionTransformStateComponent, createSpriteComponent, createTransformComponent, createVideoComponent, registerDefaultComponentFactories, registerDefaultFactories } from './factories/index.cjs';
 import '@dimforge/rapier3d-compat';

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-import { E as EcsSystem, C as Component, W as WorldEntityView, T as TransformComponent, b as World, c as ComponentClass, d as ParentLookup, e as EcsEntityKind, O as ObjectManagementSystem } from './System-AV2_87Zr.js';
-export { A as AssetInput, f as CheckboxInput, g as ColorInput, h as ComponentFactory, i as ComponentInput, j as ComponentKind, D as DropdownInput, k as DropdownOption, l as EcsComponentFactoryKind, m as EcsEntityEditorKind, n as EntityId, o as EntityInput, F as FloatInput, I as InputSystem, p as IntersectionResult, K as KeyboardKey, q as KeyboardKeys, M as MouseButton, R as RenderSystem, S as SelectionListener, r as SliderInput, s as TextInput, t as ToggleInput, u as TransformSyncSystem, v as Vec3, w as Vector2Input, x as Vector3Input } from './System-AV2_87Zr.js';
+import { E as EcsSystem, C as Component, W as WorldEntityView, T as TransformComponent, b as World, c as ComponentClass, d as ParentLookup, e as EcsEntityKind, O as ObjectManagementSystem } from './System-CHCucemW.js';
+export { A as AssetInput, f as CheckboxInput, g as ColorInput, h as ComponentFactory, i as ComponentInput, j as ComponentKind, D as DropdownInput, k as DropdownOption, l as EcsComponentFactoryKind, m as EcsEntityEditorKind, n as EntityId, o as EntityInput, F as FloatInput, I as InputSystem, p as IntersectionResult, K as KeyboardKey, q as KeyboardKeys, M as MouseButton, R as RenderSystem, S as SelectionListener, r as SliderInput, s as TextInput, t as ToggleInput, u as TransformSyncSystem, v as Vec3, w as Vector2Input, x as Vector3Input } from './System-CHCucemW.js';
 import * as THREE from 'three';
-import { V as Object3DRef } from './Video-D6mObK_5.js';
-export { ad as AnimationStateCallbacks, ae as AnimationStateMachine, af as AnimationStateManager, ag as StateMachine } from './Video-D6mObK_5.js';
-export { i as CoreComponents } from './index-BO49V8aS.js';
+import { V as Object3DRef } from './Video-B9ZKmBIT.js';
+export { ad as AnimationStateCallbacks, ae as AnimationStateMachine, af as AnimationStateManager, ag as StateMachine } from './Video-B9ZKmBIT.js';
+export { i as CoreComponents } from './index-B5JcGMJ5.js';
 export { AnimationSystem, AudioSystem, CameraSyncSystem, EnvironmentSyncSystem, InstancedMeshSystem, LightSyncSystem, MaterialSyncSystem, MeshGeometrySystem, ObjectVisibilitySystem, PhysicsSyncSystem, PostprocessingSyncSystem, ScriptBehaviourSystem, SelectionContext, VideoSystem } from './systems/index.js';
 export { createAnimationComponent, createAudioComponent, createCameraComponent, createEntityTypeComponent, createEnvironmentComponent, createImageComponent, createImageTargetAnchorComponent, createImageTargetComponent, createInstanceSlotComponent, createInstancedMeshComponent, createLightComponent, createMaterialComponent, createMeshComponent, createMeshGeometryComponent, createModelComponent, createNameComponent, createObject3DRefComponent, createParentIdComponent, createPhysicsComponent, createPostprocessingComponent, createScriptComponent, createSelectableComponent, createSelectionTransformStateComponent, createSpriteComponent, createTransformComponent, createVideoComponent, registerDefaultComponentFactories, registerDefaultFactories } from './factories/index.js';
 import '@dimforge/rapier3d-compat';

package/dist/index.js

@@ -1,11 +1,11 @@
-import { MeshGeometrySystem, InstancedMeshSystem, EnvironmentSyncSystem, PostprocessingSyncSystem, LightSyncSystem, MaterialSyncSystem, PhysicsSyncSystem, AnimationSystem, AudioSystem, VideoSystem, CameraSyncSystem, TransformSyncSystem, ObjectVisibilitySystem, RenderSystem } from './chunk-Y7KXYSPD.js';
-export { AnimationSystem, AudioSystem, Behaviour, CameraSyncSystem, EnvironmentSyncSystem, InputSystem, InstancedMeshSystem, KeyboardKeys, LightSyncSystem, MaterialSyncSystem, MeshGeometrySystem, ObjectVisibilitySystem, PhysicsSyncSystem, PostprocessingSyncSystem, RenderSystem, ScriptBehaviourSystem, TransformSyncSystem, VideoSystem } from './chunk-Y7KXYSPD.js';
-import { registerDefaultFactories } from './chunk-LE6ARNYQ.js';
-export { createAnimationComponent, createAudioComponent, createCameraComponent, createEntityTypeComponent, createEnvironmentComponent, createImageComponent, createImageTargetAnchorComponent, createImageTargetComponent, createInstanceSlotComponent, createInstancedMeshComponent, createLightComponent, createMaterialComponent, createMeshComponent, createMeshGeometryComponent, createModelComponent, createNameComponent, createObject3DRefComponent, createParentIdComponent, createPhysicsComponent, createPostprocessingComponent, createScriptComponent, createSelectableComponent, createSelectionTransformStateComponent, createSpriteComponent, createTransformComponent, createVideoComponent, registerDefaultComponentFactories, registerDefaultFactories } from './chunk-LE6ARNYQ.js';
-import { ObjectManagementSystem, applyTransform } from './chunk-ODCWJHPS.js';
-export { ObjectManagementSystem } from './chunk-ODCWJHPS.js';
-import { SelectionTransformState, Object3DRef, Name, EntityType, ScriptComponent, InstancedMeshComponent, InstanceSlotComponent, AnimationComponent, TransformComponent, ModelComponent, ImageComponent, SpriteComponent, VideoComponent, AudioComponent, CameraComponent, Environment, Postprocessing, ImageTarget, LightComponent, MaterialComponent, MeshGeometryComponent, Selectable, PhysicsComponent } from './chunk-AZR6SLQN.js';
-export { AnimationStateMachine, AnimationStateManager, components_exports as CoreComponents } from './chunk-AZR6SLQN.js';
+import { MeshGeometrySystem, InstancedMeshSystem, EnvironmentSyncSystem, PostprocessingSyncSystem, LightSyncSystem, MaterialSyncSystem, PhysicsSyncSystem, AnimationSystem, AudioSystem, VideoSystem, CameraSyncSystem, TransformSyncSystem, ObjectVisibilitySystem, RenderSystem } from './chunk-ON4E5E5O.js';
+export { AnimationSystem, AudioSystem, Behaviour, CameraSyncSystem, EnvironmentSyncSystem, InputSystem, InstancedMeshSystem, KeyboardKeys, LightSyncSystem, MaterialSyncSystem, MeshGeometrySystem, ObjectVisibilitySystem, PhysicsSyncSystem, PostprocessingSyncSystem, RenderSystem, ScriptBehaviourSystem, TransformSyncSystem, VideoSystem } from './chunk-ON4E5E5O.js';
+import { registerDefaultFactories } from './chunk-ZCEMOTH4.js';
+export { createAnimationComponent, createAudioComponent, createCameraComponent, createEntityTypeComponent, createEnvironmentComponent, createImageComponent, createImageTargetAnchorComponent, createImageTargetComponent, createInstanceSlotComponent, createInstancedMeshComponent, createLightComponent, createMaterialComponent, createMeshComponent, createMeshGeometryComponent, createModelComponent, createNameComponent, createObject3DRefComponent, createParentIdComponent, createPhysicsComponent, createPostprocessingComponent, createScriptComponent, createSelectableComponent, createSelectionTransformStateComponent, createSpriteComponent, createTransformComponent, createVideoComponent, registerDefaultComponentFactories, registerDefaultFactories } from './chunk-ZCEMOTH4.js';
+import { ObjectManagementSystem, applyTransform } from './chunk-PH43YHUT.js';
+export { ObjectManagementSystem } from './chunk-PH43YHUT.js';
+import { SelectionTransformState, Object3DRef, Name, EntityType, ScriptComponent, InstancedMeshComponent, InstanceSlotComponent, AnimationComponent, TransformComponent, ModelComponent, ImageComponent, SpriteComponent, VideoComponent, AudioComponent, CameraComponent, Environment, Postprocessing, ImageTarget, LightComponent, MaterialComponent, MeshGeometryComponent, Selectable, PhysicsComponent } from './chunk-XPCVEXMY.js';
+export { AnimationStateMachine, AnimationStateManager, components_exports as CoreComponents } from './chunk-XPCVEXMY.js';
 import './chunk-QHILSPT4.js';
 import { normalizeDebugValue, DEBUG_CHANGE_IGNORED_SYSTEMS, cloneHistoryValue } from './chunk-R2WMVXZZ.js';
 import { __name } from './chunk-OY7ZODZP.js';

package/dist/systems/index.cjs

@@ -225,7 +225,29 @@ var _ObjectManagementSystem = class _ObjectManagementSystem {
     }
     return entityId;
   }
-  deleteEntity(world, entityId) {
+  /**
+   * Removes an entity from the ECS world and its associated `Object3D` from the
+   * THREE.js scene graph.
+   *
+   * @param world - The world the entity belongs to.
+   * @param entityId - The entity to remove.
+   * @param dispose - When `true`, traverses the entity's `Object3D` subtree and
+   *   calls `.dispose()` on every `BufferGeometry` and `Material` found. Pass
+   *   `true` when the entity will not be reused and you want to free GPU memory
+   *   immediately (e.g. dynamically spawned objects). Defaults to `false`.
+   * @returns `true` if the entity existed and was removed; `false` if the entity
+   *   was not found.
+   *
+   * @example
+   * ```ts
+   * // Remove from scene, keep GPU resources (safe if geometry is shared)
+   * objects.deleteEntity(world, entityId);
+   *
+   * // Remove from scene and free GPU memory (use for one-off spawned objects)
+   * objects.deleteEntity(world, entityId, true);
+   * ```
+   */
+  deleteEntity(world, entityId, dispose = false) {
     if (!world.hasEntity(entityId)) {
       return false;
     }
@@ -233,6 +255,20 @@ var _ObjectManagementSystem = class _ObjectManagementSystem {
     if (object3d?.parent) {
       object3d.parent.remove(object3d);
     }
+    if (dispose && object3d) {
+      object3d.traverse((child) => {
+        if (child instanceof THREE13__namespace.Mesh) {
+          child.geometry?.dispose();
+          if (Array.isArray(child.material)) {
+            for (const mat of child.material) {
+              mat.dispose();
+            }
+          } else {
+            child.material?.dispose();
+          }
+        }
+      });
+    }
     world.destroyEntity(entityId);
     return true;
   }