@relu-interactives/spatial-ecs 0.5.2 → 0.8.0

package/dist/chunk-WJD2VKEH.js

@@ -1,315 +0,0 @@
-import { TransformComponent, Object3DRef, ParentId } from './chunk-BUEKOSR5.js';
-import { __name } from './chunk-OY7ZODZP.js';
-import * as THREE2 from 'three';
-import { clone } from 'three/examples/jsm/utils/SkeletonUtils.js';
-
-var SHARED_MODEL_RESOURCE_FLAG = "spatialEcsSharedModelResource";
-var modelCache = /* @__PURE__ */ new Map();
-function markSharedResources(root) {
-  root.traverse((child) => {
-    if (!(child instanceof THREE2.Mesh)) {
-      return;
-    }
-    if (child.geometry) {
-      child.geometry.userData[SHARED_MODEL_RESOURCE_FLAG] = true;
-    }
-    const materials = Array.isArray(child.material) ? child.material : [child.material];
-    for (const material of materials) {
-      if (material) {
-        material.userData[SHARED_MODEL_RESOURCE_FLAG] = true;
-      }
-    }
-  });
-}
-__name(markSharedResources, "markSharedResources");
-function loadSharedGltf(url, load) {
-  let pending = modelCache.get(url);
-  if (!pending) {
-    pending = load().then((gltf) => {
-      markSharedResources(gltf.scene);
-      return gltf;
-    });
-    pending.catch(() => {
-      modelCache.delete(url);
-    });
-    modelCache.set(url, pending);
-  }
-  return pending;
-}
-__name(loadSharedGltf, "loadSharedGltf");
-function cloneModelScene(scene) {
-  return clone(scene);
-}
-__name(cloneModelScene, "cloneModelScene");
-function clearModelCache(url) {
-  if (typeof url === "string") {
-    modelCache.delete(url);
-    return;
-  }
-  modelCache.clear();
-}
-__name(clearModelCache, "clearModelCache");
-function createTransform(input) {
-  return new TransformComponent(input);
-}
-__name(createTransform, "createTransform");
-function applyTransform(object, transform) {
-  object.position.set(
-    transform.position.x,
-    transform.position.y,
-    transform.position.z
-  );
-  object.rotation.set(
-    transform.rotation.x,
-    transform.rotation.y,
-    transform.rotation.z
-  );
-  object.scale.set(transform.scale.x, transform.scale.y, transform.scale.z);
-}
-__name(applyTransform, "applyTransform");
-var _ObjectManagementSystem = class _ObjectManagementSystem {
-  constructor(scene, camera, isEditor = false) {
-    this.registry = /* @__PURE__ */ new Map();
-    this.componentRegistry = /* @__PURE__ */ new Map();
-    this.createQueue = [];
-    this.scene = scene;
-    this.camera = camera;
-    this.isEditor = isEditor;
-  }
-  register(kind, factory) {
-    this.registry.set(kind, factory);
-  }
-  registerComponentFactory(kind, factory) {
-    this.componentRegistry.set(kind, factory);
-  }
-  getOrCreateAudioListener() {
-    const existing = this.camera.userData.ecsAudioListener;
-    if (existing instanceof THREE2.AudioListener) {
-      return existing;
-    }
-    const listener = new THREE2.AudioListener();
-    this.camera.add(listener);
-    this.camera.userData.ecsAudioListener = listener;
-    return listener;
-  }
-  isEditorMode() {
-    return this.isEditor;
-  }
-  getComponentFactory(kind) {
-    return this.componentRegistry.get(kind) ?? null;
-  }
-  createComponentNow(kind, world, entityId, ...args) {
-    const factory = this.componentRegistry.get(kind);
-    if (!factory) {
-      throw new Error(`Unknown component kind: ${kind}`);
-    }
-    return factory(world, entityId, ...args);
-  }
-  requestCreate(kind, payload = {}, onCreated) {
-    this.createQueue.push({ kind, payload, onCreated });
-  }
-  createNow(kind, world, payload = {}) {
-    const factory = this.registry.get(kind);
-    if (!factory) {
-      throw new Error(`Unknown object kind: ${kind}`);
-    }
-    const entityId = factory({
-      world,
-      scene: this.scene,
-      camera: this.camera,
-      payload,
-      isEditor: this.isEditor
-    });
-    const object = world.getComponent(entityId, Object3DRef)?.object;
-    if (object) {
-      object.userData.ecsKind = kind;
-    }
-    if (payload.parentId !== void 0) {
-      world.addComponent(entityId, new ParentId(payload.parentId));
-    }
-    return 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;
-    }
-    const object3d = world.getComponent(entityId, Object3DRef)?.object;
-    if (object3d?.parent) {
-      object3d.parent.remove(object3d);
-    }
-    if (dispose && object3d) {
-      object3d.traverse((child) => {
-        if (child instanceof THREE2.Mesh) {
-          if (!child.geometry?.userData?.[SHARED_MODEL_RESOURCE_FLAG]) {
-            child.geometry?.dispose();
-          }
-          const materials = Array.isArray(child.material) ? child.material : [child.material];
-          for (const mat of materials) {
-            if (mat && !mat.userData?.[SHARED_MODEL_RESOURCE_FLAG]) {
-              mat.dispose();
-            }
-          }
-        }
-      });
-    }
-    world.destroyEntity(entityId);
-    return true;
-  }
-  setParent(world, entityId, parentId, options) {
-    if (!world.hasEntity(entityId)) {
-      return false;
-    }
-    if (parentId !== null && !world.hasEntity(parentId)) {
-      return false;
-    }
-    if (parentId === entityId) {
-      return false;
-    }
-    let ancestor = parentId;
-    while (ancestor !== null) {
-      if (ancestor === entityId) {
-        return false;
-      }
-      ancestor = world.getComponent(ancestor, ParentId)?.value ?? null;
-    }
-    const parentComponent = world.getComponent(entityId, ParentId);
-    if (parentComponent) {
-      if (parentComponent.value === parentId) {
-        return false;
-      }
-      parentComponent.value = parentId;
-    } else {
-      world.addComponent(entityId, new ParentId(parentId));
-    }
-    const preserveWorldTransform = options?.preserveWorldTransform ?? true;
-    if (preserveWorldTransform) {
-      const object = world.getComponent(entityId, Object3DRef)?.object;
-      const parentObject = parentId !== null ? world.getComponent(parentId, Object3DRef)?.object ?? null : null;
-      if (object) {
-        this.scene.updateMatrixWorld(true);
-        if (parentObject && parentObject !== object) {
-          parentObject.attach(object);
-        } else {
-          this.scene.attach(object);
-        }
-        object.updateMatrixWorld(true);
-        this.syncTransformComponentFromObject(world, entityId, object);
-      }
-    }
-    this.reconcileSceneFromWorld(world);
-    return true;
-  }
-  syncTransformComponentFromObject(world, entityId, object) {
-    const transform = world.getComponent(entityId, TransformComponent);
-    if (!transform) {
-      return;
-    }
-    transform.position.x = object.position.x;
-    transform.position.y = object.position.y;
-    transform.position.z = object.position.z;
-    transform.rotation.x = object.rotation.x;
-    transform.rotation.y = object.rotation.y;
-    transform.rotation.z = object.rotation.z;
-    transform.scale.x = object.scale.x;
-    transform.scale.y = object.scale.y;
-    transform.scale.z = object.scale.z;
-  }
-  reconcileSceneFromWorld(world) {
-    const worldObjects = /* @__PURE__ */ new Map();
-    const entityIds = world.query(Object3DRef);
-    for (const entityId of entityIds) {
-      const object = world.getComponent(entityId, Object3DRef)?.object;
-      if (!object) {
-        continue;
-      }
-      worldObjects.set(entityId, object);
-    }
-    for (const child of [...this.scene.children]) {
-      const entityId = child.userData?.entityId;
-      if (typeof entityId === "number" && !world.hasEntity(entityId)) {
-        this.scene.remove(child);
-      }
-    }
-    for (const [entityId, object] of worldObjects.entries()) {
-      const parentEntityId = world.getComponent(entityId, ParentId)?.value;
-      const parentObject = typeof parentEntityId === "number" ? worldObjects.get(parentEntityId) : void 0;
-      if (parentObject && parentObject !== object) {
-        if (object.parent !== parentObject) {
-          parentObject.add(object);
-          object.updateMatrixWorld(true);
-        }
-        continue;
-      }
-      if (object.parent !== this.scene) {
-        this.scene.add(object);
-        object.updateMatrixWorld(true);
-      }
-    }
-  }
-  update(world) {
-    for (const request of this.createQueue.splice(0)) {
-      const entityId = this.createNow(request.kind, world, request.payload);
-      request.onCreated?.(entityId);
-    }
-    this.reconcileSceneFromWorld(world);
-  }
-};
-__name(_ObjectManagementSystem, "ObjectManagementSystem");
-var ObjectManagementSystem = _ObjectManagementSystem;
-
-// core/utils/dracoDecoderPath.ts
-var LOCAL_DRACO_DECODER_RELATIVE_PATH = "./assets/draco/";
-var DRACO_DECODER_CDN_PATH = "https://www.gstatic.com/draco/versioned/decoders/1.5.7/";
-var dracoDecoderPathOverride = null;
-function setDracoDecoderPath(path) {
-  dracoDecoderPathOverride = path;
-}
-__name(setDracoDecoderPath, "setDracoDecoderPath");
-function isBlockedBrowserFileUrl(url) {
-  return url.startsWith("file://");
-}
-__name(isBlockedBrowserFileUrl, "isBlockedBrowserFileUrl");
-function resolveDracoDecoderPath() {
-  if (dracoDecoderPathOverride) {
-    return dracoDecoderPathOverride;
-  }
-  try {
-    const resolvedPath = new URL(
-      LOCAL_DRACO_DECODER_RELATIVE_PATH,
-      import.meta.url
-    ).toString();
-    if (isBlockedBrowserFileUrl(resolvedPath)) {
-      return DRACO_DECODER_CDN_PATH;
-    }
-    return resolvedPath;
-  } catch {
-    return DRACO_DECODER_CDN_PATH;
-  }
-}
-__name(resolveDracoDecoderPath, "resolveDracoDecoderPath");
-
-export { ObjectManagementSystem, SHARED_MODEL_RESOURCE_FLAG, applyTransform, clearModelCache, cloneModelScene, createTransform, loadSharedGltf, resolveDracoDecoderPath, setDracoDecoderPath };
-//# sourceMappingURL=chunk-WJD2VKEH.js.map
-//# sourceMappingURL=chunk-WJD2VKEH.js.map

package/dist/chunk-WJD2VKEH.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../core/utils/modelCache.ts","../core/systems/ObjectManagementSystem.ts","../core/utils/dracoDecoderPath.ts"],"names":["THREE","cloneWithSkeleton"],"mappings":"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","file":"chunk-WJD2VKEH.js","sourcesContent":["import * as THREE from \"three\";\nimport type { GLTF } from \"three/examples/jsm/loaders/GLTFLoader.js\";\nimport { clone as cloneWithSkeleton } from \"three/examples/jsm/utils/SkeletonUtils.js\";\n\n/**\n * userData flag set on geometries/materials that back shared (cached) model\n * scenes. Entity disposal must skip these — other live clones and future\n * spawns reference the same GPU resources.\n */\nexport const SHARED_MODEL_RESOURCE_FLAG = \"spatialEcsSharedModelResource\";\n\nconst modelCache = new Map<string, Promise<GLTF>>();\n\nfunction markSharedResources(root: THREE.Object3D): void {\n  root.traverse((child) => {\n    if (!(child instanceof THREE.Mesh)) {\n      return;\n    }\n    if (child.geometry) {\n      child.geometry.userData[SHARED_MODEL_RESOURCE_FLAG] = true;\n    }\n    const materials = Array.isArray(child.material)\n      ? child.material\n      : [child.material];\n    for (const material of materials) {\n      if (material) {\n        material.userData[SHARED_MODEL_RESOURCE_FLAG] = true;\n      }\n    }\n  });\n}\n\n/**\n * Load a GLTF once per URL and share the parsed result, so repeated spawns of\n * the same model skip both the fetch and the parse. The cached scene must\n * never be mounted directly (an Object3D has a single parent) — mount a\n * cloneModelScene() of it. Failed loads are evicted so a retry re-fetches.\n */\nexport function loadSharedGltf(\n  url: string,\n  load: () => Promise<GLTF>,\n): Promise<GLTF> {\n  let pending = modelCache.get(url);\n  if (!pending) {\n    pending = load().then((gltf) => {\n      markSharedResources(gltf.scene);\n      return gltf;\n    });\n    pending.catch(() => {\n      modelCache.delete(url);\n    });\n    modelCache.set(url, pending);\n  }\n  return pending;\n}\n\n/**\n * Skeleton-aware clone of a cached model scene for mounting. Geometries and\n * materials are shared with the cached original (marked via\n * SHARED_MODEL_RESOURCE_FLAG); the object hierarchy — including rebound\n * skeletons for skinned meshes — is fresh per call.\n */\nexport function cloneModelScene(scene: THREE.Object3D): THREE.Object3D {\n  return cloneWithSkeleton(scene);\n}\n\n/**\n * Forget cached models (one URL, or everything). Subsequent loads fetch and\n * parse anew. Does not dispose GPU resources — live clones may still use them.\n */\nexport function clearModelCache(url?: string): void {\n  if (typeof url === \"string\") {\n    modelCache.delete(url);\n    return;\n  }\n  modelCache.clear();\n}\n","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 { SHARED_MODEL_RESOURCE_FLAG } from \"../utils/modelCache\";\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   * Suppress the default child entities a factory would otherwise create.\n   *\n   * Set during hydration: the snapshot already contains those children, so\n   * letting the factory add its own too duplicates them on every load.\n   */\n  skipDefaultChildren?: 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  | \"scriptObject\"\n  | \"selectable\"\n  | \"selectionTransformState\"\n  | \"sprite\"\n  | \"transform\"\n  | \"video\"\n  | \"instancedMesh\"\n  | \"xrRig\"\n  | \"vrTeleportArea\"\n  | \"xrHandPose\"\n  | \"xrAnchor\"\n  | \"uiPanel\"\n  | \"uiText\"\n  | \"uiButton\"\n  | \"uiToggle\"\n  | \"uiSlider\"\n  | \"xrInteractable\"\n  | \"xrInteractor\"\n  | \"xrInteractorSide\";\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          // Resources backing shared (cached) model scenes are skipped —\n          // other live clones and future spawns reference the same objects.\n          if (!child.geometry?.userData?.[SHARED_MODEL_RESOURCE_FLAG]) {\n            child.geometry?.dispose();\n          }\n          const materials = Array.isArray(child.material)\n            ? child.material\n            : [child.material];\n          for (const mat of materials) {\n            if (mat && !mat.userData?.[SHARED_MODEL_RESOURCE_FLAG]) {\n              mat.dispose();\n            }\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\nlet dracoDecoderPathOverride: string | null = null;\n\n/**\n * Override where the DRACO decoder files (draco_wasm_wrapper.js,\n * draco_decoder.wasm, draco_decoder.js) are fetched from. Embedding apps\n * whose bundlers relocate this package's chunks — making the default\n * import.meta.url resolution point at a location that is never populated —\n * should call this before any model loads. The path must end with \"/\".\n * Pass null to restore the default resolution.\n */\nexport function setDracoDecoderPath(path: string | null): void {\n  dracoDecoderPathOverride = path;\n}\n\nfunction isBlockedBrowserFileUrl(url: string): boolean {\n  return url.startsWith(\"file://\");\n}\n\nexport function resolveDracoDecoderPath(): string {\n  if (dracoDecoderPathOverride) {\n    return dracoDecoderPathOverride;\n  }\n\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"]}