@relu-interactives/spatial-ecs 0.2.10 → 0.2.12

package/dist/{chunk-ODCWJHPS.js → chunk-PH43YHUT.js}

@@ -1,4 +1,4 @@
-import { TransformComponent, Object3DRef, ParentId } from './chunk-AZR6SLQN.js';
+import { TransformComponent, Object3DRef, ParentId } from './chunk-XPCVEXMY.js';
 import { __name } from './chunk-OY7ZODZP.js';
 import * as THREE from 'three';
 
@@ -82,7 +82,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;
     }
@@ -90,6 +112,20 @@ var _ObjectManagementSystem = class _ObjectManagementSystem {
     if (object3d?.parent) {
       object3d.parent.remove(object3d);
     }
+    if (dispose && object3d) {
+      object3d.traverse((child) => {
+        if (child instanceof THREE.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;
   }
@@ -219,5 +255,5 @@ function resolveDracoDecoderPath() {
 __name(resolveDracoDecoderPath, "resolveDracoDecoderPath");
 
 export { ObjectManagementSystem, applyTransform, createTransform, resolveDracoDecoderPath };
-//# sourceMappingURL=chunk-ODCWJHPS.js.map
-//# sourceMappingURL=chunk-ODCWJHPS.js.map
+//# sourceMappingURL=chunk-PH43YHUT.js.map
+//# sourceMappingURL=chunk-PH43YHUT.js.map

package/dist/chunk-PH43YHUT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../core/systems/ObjectManagementSystem.ts","../core/utils/dracoDecoderPath.ts"],"names":[],"mappings":"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","file":"chunk-PH43YHUT.js","sourcesContent":["import * as THREE from \"three\";\n\nimport { Object3DRef } from \"../components/Object3DRef\";\nimport { ParentId } from \"../components/ParentId\";\nimport type { TransformData } from \"../components/Transform\";\nimport { TransformComponent } from \"../components/Transform\";\nimport type { EcsSystem } from \"../System\";\nimport type { World } from \"../World\";\nimport type { EntityId, EcsEntityKind } from \"../types\";\n\nexport type CreatePayload = {\n  name?: string;\n  transform?: TransformData;\n  parentId?: EntityId | null;\n  path?: string;\n  options?: Record<string, unknown>;\n  camera?: Record<string, unknown>;\n  useWorldCamera?: boolean;\n};\n\nexport type CreateContext = {\n  world: World;\n  scene: THREE.Scene;\n  camera: THREE.PerspectiveCamera;\n  payload: CreatePayload;\n  isEditor?: boolean;\n};\n\nexport type EntityFactory = (context: CreateContext) => EntityId;\n\nexport type EcsComponentFactoryKind =\n  | \"animation\"\n  | \"audio\"\n  | \"camera\"\n  | \"environment\"\n  | \"entityType\"\n  | \"image\"\n  | \"imageTargetAnchor\"\n  | \"imageTarget\"\n  | \"light\"\n  | \"material\"\n  | \"mesh\"\n  | \"meshGeometry\"\n  | \"model\"\n  | \"name\"\n  | \"object3DRef\"\n  | \"parentId\"\n  | \"physics\"\n  | \"postprocessing\"\n  | \"script\"\n  | \"selectable\"\n  | \"selectionTransformState\"\n  | \"sprite\"\n  | \"transform\"\n  | \"video\"\n  | \"instancedMesh\";\n\nexport type ComponentFactory = (\n  world: World,\n  entityId: EntityId,\n  ...args: any[]\n) => unknown;\n\ntype CreateRequest = {\n  kind: EcsEntityKind;\n  payload: CreatePayload;\n  onCreated?: (entityId: EntityId) => void;\n};\n\nexport function createTransform(input?: TransformData): TransformComponent {\n  return new TransformComponent(input);\n}\n\nexport function applyTransform(\n  object: THREE.Object3D,\n  transform: TransformComponent,\n): void {\n  object.position.set(\n    transform.position.x,\n    transform.position.y,\n    transform.position.z,\n  );\n  object.rotation.set(\n    transform.rotation.x,\n    transform.rotation.y,\n    transform.rotation.z,\n  );\n  object.scale.set(transform.scale.x, transform.scale.y, transform.scale.z);\n}\n\nexport class ObjectManagementSystem implements EcsSystem {\n  private readonly scene: THREE.Scene;\n  private readonly camera: THREE.PerspectiveCamera;\n  private readonly isEditor: boolean;\n  private readonly registry = new Map<EcsEntityKind, EntityFactory>();\n  private readonly componentRegistry = new Map<\n    EcsComponentFactoryKind,\n    ComponentFactory\n  >();\n  private readonly createQueue: CreateRequest[] = [];\n\n  constructor(\n    scene: THREE.Scene,\n    camera: THREE.PerspectiveCamera,\n    isEditor = false,\n  ) {\n    this.scene = scene;\n    this.camera = camera;\n    this.isEditor = isEditor;\n  }\n\n  register(kind: EcsEntityKind, factory: EntityFactory): void {\n    this.registry.set(kind, factory);\n  }\n\n  registerComponentFactory(\n    kind: EcsComponentFactoryKind,\n    factory: ComponentFactory,\n  ): void {\n    this.componentRegistry.set(kind, factory);\n  }\n\n  getOrCreateAudioListener(): THREE.AudioListener {\n    const existing = this.camera.userData.ecsAudioListener;\n    if (existing instanceof THREE.AudioListener) {\n      return existing;\n    }\n\n    const listener = new THREE.AudioListener();\n    this.camera.add(listener);\n    this.camera.userData.ecsAudioListener = listener;\n    return listener;\n  }\n\n  isEditorMode(): boolean {\n    return this.isEditor;\n  }\n\n  getComponentFactory(kind: EcsComponentFactoryKind): ComponentFactory | null {\n    return this.componentRegistry.get(kind) ?? null;\n  }\n\n  createComponentNow(\n    kind: EcsComponentFactoryKind,\n    world: World,\n    entityId: EntityId,\n    ...args: any[]\n  ): unknown {\n    const factory = this.componentRegistry.get(kind);\n    if (!factory) {\n      throw new Error(`Unknown component kind: ${kind}`);\n    }\n\n    return factory(world, entityId, ...args);\n  }\n\n  requestCreate(\n    kind: EcsEntityKind,\n    payload: CreatePayload = {},\n    onCreated?: (entityId: EntityId) => void,\n  ): void {\n    this.createQueue.push({ kind, payload, onCreated });\n  }\n\n  createNow(\n    kind: EcsEntityKind,\n    world: World,\n    payload: CreatePayload = {},\n  ): EntityId {\n    const factory = this.registry.get(kind);\n    if (!factory) {\n      throw new Error(`Unknown object kind: ${kind}`);\n    }\n\n    const entityId = factory({\n      world,\n      scene: this.scene,\n      camera: this.camera,\n      payload,\n      isEditor: this.isEditor,\n    });\n\n    const object = world.getComponent(entityId, Object3DRef)?.object;\n    if (object) {\n      object.userData.ecsKind = kind;\n    }\n\n    if (payload.parentId !== undefined) {\n      world.addComponent(entityId, new ParentId(payload.parentId));\n    }\n\n    return entityId;\n  }\n\n  /**\n   * Removes an entity from the ECS world and its associated `Object3D` from the\n   * THREE.js scene graph.\n   *\n   * @param world - The world the entity belongs to.\n   * @param entityId - The entity to remove.\n   * @param dispose - When `true`, traverses the entity's `Object3D` subtree and\n   *   calls `.dispose()` on every `BufferGeometry` and `Material` found. Pass\n   *   `true` when the entity will not be reused and you want to free GPU memory\n   *   immediately (e.g. dynamically spawned objects). Defaults to `false`.\n   * @returns `true` if the entity existed and was removed; `false` if the entity\n   *   was not found.\n   *\n   * @example\n   * ```ts\n   * // Remove from scene, keep GPU resources (safe if geometry is shared)\n   * objects.deleteEntity(world, entityId);\n   *\n   * // Remove from scene and free GPU memory (use for one-off spawned objects)\n   * objects.deleteEntity(world, entityId, true);\n   * ```\n   */\n  deleteEntity(world: World, entityId: EntityId, dispose = false): boolean {\n    if (!world.hasEntity(entityId)) {\n      return false;\n    }\n\n    const object3d = world.getComponent(entityId, Object3DRef)?.object;\n    if (object3d?.parent) {\n      object3d.parent.remove(object3d);\n    }\n\n    if (dispose && object3d) {\n      object3d.traverse((child) => {\n        if (child instanceof THREE.Mesh) {\n          child.geometry?.dispose();\n          if (Array.isArray(child.material)) {\n            for (const mat of child.material) {\n              mat.dispose();\n            }\n          } else {\n            child.material?.dispose();\n          }\n        }\n      });\n    }\n\n    world.destroyEntity(entityId);\n    return true;\n  }\n\n  setParent(\n    world: World,\n    entityId: EntityId,\n    parentId: EntityId | null,\n    options?: {\n      preserveWorldTransform?: boolean;\n    },\n  ): boolean {\n    if (!world.hasEntity(entityId)) {\n      return false;\n    }\n\n    if (parentId !== null && !world.hasEntity(parentId)) {\n      return false;\n    }\n\n    if (parentId === entityId) {\n      return false;\n    }\n\n    let ancestor = parentId;\n    while (ancestor !== null) {\n      if (ancestor === entityId) {\n        return false;\n      }\n\n      ancestor = world.getComponent(ancestor, ParentId)?.value ?? null;\n    }\n\n    const parentComponent = world.getComponent(entityId, ParentId);\n    if (parentComponent) {\n      if (parentComponent.value === parentId) {\n        return false;\n      }\n\n      parentComponent.value = parentId;\n    } else {\n      world.addComponent(entityId, new ParentId(parentId));\n    }\n\n    const preserveWorldTransform = options?.preserveWorldTransform ?? true;\n    if (preserveWorldTransform) {\n      const object = world.getComponent(entityId, Object3DRef)?.object;\n      const parentObject =\n        parentId !== null\n          ? world.getComponent(parentId, Object3DRef)?.object ?? null\n          : null;\n\n      if (object) {\n        // Refresh matrixWorld before attach so world-space preservation is accurate.\n        this.scene.updateMatrixWorld(true);\n\n        if (parentObject && parentObject !== object) {\n          parentObject.attach(object);\n        } else {\n          this.scene.attach(object);\n        }\n\n        object.updateMatrixWorld(true);\n        this.syncTransformComponentFromObject(world, entityId, object);\n      }\n    }\n\n    this.reconcileSceneFromWorld(world);\n    return true;\n  }\n\n  private syncTransformComponentFromObject(\n    world: World,\n    entityId: EntityId,\n    object: THREE.Object3D,\n  ): void {\n    const transform = world.getComponent(entityId, TransformComponent);\n    if (!transform) {\n      return;\n    }\n\n    transform.position.x = object.position.x;\n    transform.position.y = object.position.y;\n    transform.position.z = object.position.z;\n\n    transform.rotation.x = object.rotation.x;\n    transform.rotation.y = object.rotation.y;\n    transform.rotation.z = object.rotation.z;\n\n    transform.scale.x = object.scale.x;\n    transform.scale.y = object.scale.y;\n    transform.scale.z = object.scale.z;\n  }\n\n  reconcileSceneFromWorld(world: World): void {\n    const worldObjects = new Map<EntityId, THREE.Object3D>();\n    const entityIds = world.query(Object3DRef);\n\n    for (const entityId of entityIds) {\n      const object = world.getComponent(entityId, Object3DRef)?.object;\n      if (!object) {\n        continue;\n      }\n\n      worldObjects.set(entityId, object);\n    }\n\n    for (const child of [...this.scene.children]) {\n      const entityId = child.userData?.entityId;\n      if (typeof entityId === \"number\" && !world.hasEntity(entityId)) {\n        this.scene.remove(child);\n      }\n    }\n\n    for (const [entityId, object] of worldObjects.entries()) {\n      const parentEntityId = world.getComponent(entityId, ParentId)?.value;\n      const parentObject =\n        typeof parentEntityId === \"number\"\n          ? worldObjects.get(parentEntityId)\n          : undefined;\n\n      if (parentObject && parentObject !== object) {\n        if (object.parent !== parentObject) {\n          // Reconcile hierarchy from ParentId while keeping Transform as local source of truth.\n          parentObject.add(object);\n          object.updateMatrixWorld(true);\n        }\n        continue;\n      }\n\n      if (object.parent !== this.scene) {\n        // Reconcile hierarchy from ParentId while keeping Transform as local source of truth.\n        this.scene.add(object);\n        object.updateMatrixWorld(true);\n      }\n    }\n  }\n\n  update(world: World): void {\n    for (const request of this.createQueue.splice(0)) {\n      const entityId = this.createNow(request.kind, world, request.payload);\n      request.onCreated?.(entityId);\n    }\n\n    this.reconcileSceneFromWorld(world);\n  }\n}\n","const LOCAL_DRACO_DECODER_RELATIVE_PATH = \"./assets/draco/\";\nexport const DRACO_DECODER_CDN_PATH =\n  \"https://www.gstatic.com/draco/versioned/decoders/1.5.7/\";\n\nfunction isBlockedBrowserFileUrl(url: string): boolean {\n  return url.startsWith(\"file://\");\n}\n\nexport function resolveDracoDecoderPath(): string {\n  try {\n    // Prefer vendored decoder assets shipped with this package.\n    const resolvedPath = new URL(\n      LOCAL_DRACO_DECODER_RELATIVE_PATH,\n      import.meta.url,\n    ).toString();\n\n    // Browser loaders cannot fetch file:// resources from package install paths.\n    // Fall back to CDN decoders when bundlers emit file URLs for node_modules assets.\n    if (isBlockedBrowserFileUrl(resolvedPath)) {\n      return DRACO_DECODER_CDN_PATH;\n    }\n\n    return resolvedPath;\n  } catch {\n    // Fallback keeps compatibility in runtimes that cannot resolve package-relative URLs.\n    return DRACO_DECODER_CDN_PATH;\n  }\n}\n"]}

package/dist/{chunk-AZR6SLQN.js → chunk-XPCVEXMY.js}

@@ -1802,5 +1802,5 @@ __name(_VideoComponent, "VideoComponent");
 var VideoComponent = _VideoComponent;
 
 export { AnimationComponent, AnimationStateMachine, AnimationStateManager, AudioComponent, CameraComponent, DEFAULT_COLLIDER_STATE, DEFAULT_ENVIRONMENT_STATE, DEFAULT_INSTANCED_MESH_PARAMETERS, DEFAULT_INSTANCE_TRANSFORM, DEFAULT_MESH_GEOMETRY_PARAMETERS, DEFAULT_PHYSICS_STATE, DEFAULT_POSTPROCESSING_STATE, DEFAULT_RIGIDBODY_STATE, EntityType, Environment, ImageComponent, ImageTarget, ImageTargetAnchor, InstanceSlotComponent, InstancedMeshComponent, LightComponent, MaterialComponent, MeshComponent, MeshGeometryComponent, ModelComponent, Name, Object3DRef, ParentId, PhysicsComponent, Postprocessing, ScriptComponent, Selectable, SelectionTransformState, SpriteComponent, TransformComponent, VideoComponent, components_exports, normalizePhysicsState };
-//# sourceMappingURL=chunk-AZR6SLQN.js.map
-//# sourceMappingURL=chunk-AZR6SLQN.js.map
+//# sourceMappingURL=chunk-XPCVEXMY.js.map
+//# sourceMappingURL=chunk-XPCVEXMY.js.map