@relu-interactives/spatial-ecs 0.2.11 → 0.2.13

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;
   }