@polarfront-lab/ionian 1.0.6 → 1.1.0

package/dist/ionian.js

@@ -3,6 +3,7 @@ var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { en
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 import * as THREE from "three";
 import { Mesh, OrthographicCamera, BufferGeometry, Float32BufferAttribute, NearestFilter, ShaderMaterial, WebGLRenderTarget, FloatType, RGBAFormat, DataTexture, ClampToEdgeWrapping } from "three";
+import { GLTFLoader, DRACOLoader } from "three-stdlib";
 const linear = (n) => n;
 function mitt(n) {
   return { all: n = n || /* @__PURE__ */ new Map(), on: function(t, e) {
@@ -2033,7 +2034,7 @@ var genericPoolExports = requireGenericPool();
 const genericPool = /* @__PURE__ */ getDefaultExportFromCjs(genericPoolExports);
 const workerFactory = {
   create: async () => {
-    const workerPath = new URL("data:video/mp2t;base64,aW1wb3J0IHsgTWVzaERhdGEgfSBmcm9tICdAL3R5cGVzJzsKaW1wb3J0ICogYXMgQ29tbGluayBmcm9tICdjb21saW5rJzsKaW1wb3J0ICogYXMgVEhSRUUgZnJvbSAndGhyZWUnOwppbXBvcnQgeyBNZXNoU3VyZmFjZVNhbXBsZXIgfSBmcm9tICd0aHJlZS9leGFtcGxlcy9qc20vbWF0aC9NZXNoU3VyZmFjZVNhbXBsZXIuanMnOwoKZXhwb3J0IGludGVyZmFjZSBNZXNoU2FtcGxlckFQSSB7CiAgc2FtcGxlTWVzaDogKG1lc2hEYXRhOiBNZXNoRGF0YSwgc2l6ZTogbnVtYmVyKSA9PiBQcm9taXNlPEZsb2F0MzJBcnJheT47Cn0KCmNvbnN0IGFwaSA9IHsKICBzYW1wbGVNZXNoOiAobWVzaERhdGE6IE1lc2hEYXRhLCBzaXplOiBudW1iZXIpOiBGbG9hdDMyQXJyYXkgPT4gewogICAgY29uc3QgZ2VvbWV0cnkgPSBuZXcgVEhSRUUuQnVmZmVyR2VvbWV0cnkoKTsKICAgIGdlb21ldHJ5LnNldEF0dHJpYnV0ZSgncG9zaXRpb24nLCBuZXcgVEhSRUUuQnVmZmVyQXR0cmlidXRlKG5ldyBGbG9hdDMyQXJyYXkobWVzaERhdGEucG9zaXRpb24pLCAzKSk7CiAgICBpZiAobWVzaERhdGEubm9ybWFsKSB7CiAgICAgIGdlb21ldHJ5LnNldEF0dHJpYnV0ZSgnbm9ybWFsJywgbmV3IFRIUkVFLkJ1ZmZlckF0dHJpYnV0ZShuZXcgRmxvYXQzMkFycmF5KG1lc2hEYXRhLm5vcm1hbCksIDMpKTsKICAgIH0KICAgIGNvbnN0IG1hdGVyaWFsID0gbmV3IFRIUkVFLk1lc2hCYXNpY01hdGVyaWFsKCk7CiAgICBjb25zdCBtZXNoID0gbmV3IFRIUkVFLk1lc2goZ2VvbWV0cnksIG1hdGVyaWFsKTsKICAgIG1lc2guc2NhbGUuc2V0KG1lc2hEYXRhLnNjYWxlLngsIG1lc2hEYXRhLnNjYWxlLnksIG1lc2hEYXRhLnNjYWxlLnopOwoKICAgIGNvbnN0IHNhbXBsZXIgPSBuZXcgTWVzaFN1cmZhY2VTYW1wbGVyKG1lc2gpLmJ1aWxkKCk7CiAgICBjb25zdCBkYXRhID0gbmV3IEZsb2F0MzJBcnJheShzaXplICogc2l6ZSAqIDQpOwogICAgY29uc3QgcG9zaXRpb24gPSBuZXcgVEhSRUUuVmVjdG9yMygpOwoKICAgIGZvciAobGV0IGkgPSAwOyBpIDwgc2l6ZTsgaSsrKSB7CiAgICAgIGZvciAobGV0IGogPSAwOyBqIDwgc2l6ZTsgaisrKSB7CiAgICAgICAgY29uc3QgaW5kZXggPSBpICogc2l6ZSArIGo7CiAgICAgICAgc2FtcGxlci5zYW1wbGUocG9zaXRpb24pOwogICAgICAgIGRhdGFbNCAqIGluZGV4XSA9IHBvc2l0aW9uLnggKiBtZXNoRGF0YS5zY2FsZS54OwogICAgICAgIGRhdGFbNCAqIGluZGV4ICsgMV0gPSBwb3NpdGlvbi55ICogbWVzaERhdGEuc2NhbGUueTsKICAgICAgICBkYXRhWzQgKiBpbmRleCArIDJdID0gcG9zaXRpb24ueiAqIG1lc2hEYXRhLnNjYWxlLno7CiAgICAgICAgZGF0YVs0ICogaW5kZXggKyAzXSA9IChNYXRoLnJhbmRvbSgpIC0gMC41KSAqIDAuMDE7CiAgICAgIH0KICAgIH0KCiAgICByZXR1cm4gZGF0YTsKICB9LAp9OwoKQ29tbGluay5leHBvc2UoYXBpKTsK", import.meta.url);
+    const workerPath = new URL("data:video/mp2t;base64,aW1wb3J0IHsgTWVzaERhdGEgfSBmcm9tICdAL2xpYi90eXBlcyc7CmltcG9ydCAqIGFzIENvbWxpbmsgZnJvbSAnY29tbGluayc7CmltcG9ydCAqIGFzIFRIUkVFIGZyb20gJ3RocmVlJzsKaW1wb3J0IHsgTWVzaFN1cmZhY2VTYW1wbGVyIH0gZnJvbSAndGhyZWUvZXhhbXBsZXMvanNtL21hdGgvTWVzaFN1cmZhY2VTYW1wbGVyLmpzJzsKCmV4cG9ydCBpbnRlcmZhY2UgTWVzaFNhbXBsZXJBUEkgewogIHNhbXBsZU1lc2g6IChtZXNoRGF0YTogTWVzaERhdGEsIHNpemU6IG51bWJlcikgPT4gUHJvbWlzZTxGbG9hdDMyQXJyYXk+Owp9Cgpjb25zdCBhcGkgPSB7CiAgc2FtcGxlTWVzaDogKG1lc2hEYXRhOiBNZXNoRGF0YSwgc2l6ZTogbnVtYmVyKTogRmxvYXQzMkFycmF5ID0+IHsKICAgIGNvbnN0IGdlb21ldHJ5ID0gbmV3IFRIUkVFLkJ1ZmZlckdlb21ldHJ5KCk7CiAgICBnZW9tZXRyeS5zZXRBdHRyaWJ1dGUoJ3Bvc2l0aW9uJywgbmV3IFRIUkVFLkJ1ZmZlckF0dHJpYnV0ZShuZXcgRmxvYXQzMkFycmF5KG1lc2hEYXRhLnBvc2l0aW9uKSwgMykpOwogICAgaWYgKG1lc2hEYXRhLm5vcm1hbCkgewogICAgICBnZW9tZXRyeS5zZXRBdHRyaWJ1dGUoJ25vcm1hbCcsIG5ldyBUSFJFRS5CdWZmZXJBdHRyaWJ1dGUobmV3IEZsb2F0MzJBcnJheShtZXNoRGF0YS5ub3JtYWwpLCAzKSk7CiAgICB9CiAgICBjb25zdCBtYXRlcmlhbCA9IG5ldyBUSFJFRS5NZXNoQmFzaWNNYXRlcmlhbCgpOwogICAgY29uc3QgbWVzaCA9IG5ldyBUSFJFRS5NZXNoKGdlb21ldHJ5LCBtYXRlcmlhbCk7CiAgICBtZXNoLnNjYWxlLnNldChtZXNoRGF0YS5zY2FsZS54LCBtZXNoRGF0YS5zY2FsZS55LCBtZXNoRGF0YS5zY2FsZS56KTsKCiAgICBjb25zdCBzYW1wbGVyID0gbmV3IE1lc2hTdXJmYWNlU2FtcGxlcihtZXNoKS5idWlsZCgpOwogICAgY29uc3QgZGF0YSA9IG5ldyBGbG9hdDMyQXJyYXkoc2l6ZSAqIHNpemUgKiA0KTsKICAgIGNvbnN0IHBvc2l0aW9uID0gbmV3IFRIUkVFLlZlY3RvcjMoKTsKCiAgICBmb3IgKGxldCBpID0gMDsgaSA8IHNpemU7IGkrKykgewogICAgICBmb3IgKGxldCBqID0gMDsgaiA8IHNpemU7IGorKykgewogICAgICAgIGNvbnN0IGluZGV4ID0gaSAqIHNpemUgKyBqOwogICAgICAgIHNhbXBsZXIuc2FtcGxlKHBvc2l0aW9uKTsKICAgICAgICBkYXRhWzQgKiBpbmRleF0gPSBwb3NpdGlvbi54ICogbWVzaERhdGEuc2NhbGUueDsKICAgICAgICBkYXRhWzQgKiBpbmRleCArIDFdID0gcG9zaXRpb24ueSAqIG1lc2hEYXRhLnNjYWxlLnk7CiAgICAgICAgZGF0YVs0ICogaW5kZXggKyAyXSA9IHBvc2l0aW9uLnogKiBtZXNoRGF0YS5zY2FsZS56OwogICAgICAgIGRhdGFbNCAqIGluZGV4ICsgM10gPSAoTWF0aC5yYW5kb20oKSAtIDAuNSkgKiAwLjAxOwogICAgICB9CiAgICB9CgogICAgcmV0dXJuIGRhdGE7CiAgfSwKfTsKCkNvbWxpbmsuZXhwb3NlKGFwaSk7Cg==", import.meta.url);
     const worker = new Worker(workerPath, { type: "module" });
     return wrap(worker);
   },
@@ -2071,16 +2072,13 @@ function createSpherePoints(size) {
   }
   return createDataTexture(data, size);
 }
-function copyOf(source) {
-  const map = /* @__PURE__ */ new Map();
-  if (source) {
-    if (Array.isArray(source)) {
-      source.forEach(({ id, item }) => map.set(id, item));
-    } else {
-      map.set(source.id, source.item);
-    }
+function disposeMesh(mesh) {
+  mesh.geometry.dispose();
+  if (mesh.material instanceof THREE.Material) {
+    mesh.material.dispose();
+  } else {
+    mesh.material.forEach((material) => material.dispose());
   }
-  return map;
 }
 function clamp(value, min, max) {
   value = Math.min(value, max);
@@ -2092,71 +2090,44 @@ class DataTextureService {
    * Creates a new DataTextureManager instance.
    * @param eventEmitter
    * @param textureSize
-   * @param meshes Optional initial meshes.
    */
-  constructor(eventEmitter, textureSize, meshes) {
+  constructor(eventEmitter, textureSize) {
     __publicField(this, "textureSize");
-    __publicField(this, "meshes");
     __publicField(this, "dataTextures");
     __publicField(this, "eventEmitter");
     this.eventEmitter = eventEmitter;
     this.textureSize = textureSize;
-    this.meshes = copyOf(meshes);
     this.dataTextures = /* @__PURE__ */ new Map();
     this.updateServiceState("ready");
   }
-  /**
-   * Registers a mesh.
-   * @param id The ID of the mesh.
-   * @param mesh The mesh to register.
-   */
-  async register(id, mesh) {
-    this.meshes.set(id, mesh);
-  }
   setTextureSize(textureSize) {
     if (this.textureSize === textureSize) return;
     this.textureSize = textureSize;
     this.dataTextures.forEach((texture) => texture.dispose());
     this.dataTextures.clear();
   }
-  getMesh(id) {
-    return this.meshes.get(id);
-  }
-  /**
-   * Gets the data texture for the specified mesh ID and current texture size.
-   * Returns the fallback data texture if the specified mesh ID is not found.
-   * @param id The ID of the mesh.
-   * @returns The data texture, or undefined if not found and no fallback is available.
-   */
-  async getDataTexture(id) {
-    return await this.prepareMesh(id);
-  }
   /**
    * Prepares a mesh for sampling.
-   * @param id The ID of the mesh to prepare.
+   * @returns The prepared data texture.
+   * @param asset The asset to prepare.
    */
-  async prepareMesh(id) {
-    if (!this.meshes.has(id)) {
-      throw new Error(`Mesh with id "${id}" does not exist.`);
-    }
-    const texture = this.dataTextures.get(id);
+  async getDataTexture(asset) {
+    const texture = this.dataTextures.get(asset.name);
     if (texture) {
       return texture;
     }
-    const mesh = this.meshes.get(id);
-    const meshData = parseMeshData(mesh);
+    const meshData = parseMeshData(asset);
     const worker = await pool.acquire();
     try {
-      const data = await worker.sampleMesh(meshData, this.textureSize);
-      const texture2 = createDataTexture(data, this.textureSize);
-      texture2.name = id;
-      return texture2;
+      const array = await worker.sampleMesh(meshData, this.textureSize);
+      const dataTexture = createDataTexture(array, this.textureSize);
+      dataTexture.name = asset.name;
+      return dataTexture;
     } finally {
       await pool.release(worker);
     }
   }
   async dispose() {
-    this.meshes.clear();
     this.dataTextures.clear();
     this.updateServiceState("disposed");
   }
@@ -2298,11 +2269,9 @@ class InstancedMeshManager {
    * @param matcap The matcap texture to set.
    */
   setOriginMatcap(matcap) {
-    console.log("set source matcap", matcap);
     this.matcapMaterial.uniforms.uSourceMatcap.value = matcap;
   }
   setDestinationMatcap(matcap) {
-    console.log("set target matcap", matcap);
     this.matcapMaterial.uniforms.uTargetMatcap.value = matcap;
   }
   setProgress(float) {
@@ -2319,7 +2288,6 @@ class InstancedMeshManager {
    * Use the matcap material for the instanced mesh.
    */
   useMatcapMaterial() {
-    console.log("Using matcap material");
     this.mesh.material = this.matcapMaterial;
   }
   /**
@@ -2330,8 +2298,6 @@ class InstancedMeshManager {
     const material = this.materials.get(id);
     if (material) {
       this.mesh.material = material;
-    } else {
-      console.warn(`material with id "${id}" not found`);
     }
   }
   /**
@@ -2342,8 +2308,6 @@ class InstancedMeshManager {
     const geometry = this.geometries.get(id);
     if (geometry) {
       this.mesh.geometry = geometry;
-    } else {
-      console.warn(`geometry with id "${id}" not found`);
     }
   }
   /**
@@ -2394,7 +2358,6 @@ class InstancedMeshManager {
       if (previous === geometry) {
         return;
       }
-      console.log(`geometry with id "${id}" already exists. replacing...`);
     }
     const uvRefs = this.getUVRefs(this.size);
     geometry.setAttribute("uvRef", uvRefs);
@@ -2415,7 +2378,6 @@ class InstancedMeshManager {
       if (previous === material) {
         return;
       }
-      console.log(`material with id "${id}" already exists. replacing...`);
     }
     if (this.mesh.material === previous) {
       this.mesh.material = material;
@@ -2470,8 +2432,6 @@ class IntersectionService {
   constructor(eventEmitter, camera, originGeometry, destinationGeometry) {
     __publicField(this, "raycaster", new THREE.Raycaster());
     __publicField(this, "mousePosition", new THREE.Vector2());
-    __publicField(this, "mouseEntered", false);
-    __publicField(this, "mousePositionChanged", false);
     __publicField(this, "camera");
     __publicField(this, "originGeometry");
     __publicField(this, "destinationGeometry");
@@ -2489,6 +2449,9 @@ class IntersectionService {
     this.destinationGeometry = destinationGeometry;
     this.geometryNeedsUpdate = true;
   }
+  getIntersectionMesh() {
+    return this.intersectionMesh;
+  }
   /**
    * Set the camera used for raycasting.
    * @param camera
@@ -2533,36 +2496,23 @@ class IntersectionService {
    * @param mousePosition
    */
   setMousePosition(mousePosition) {
-    if (mousePosition) {
-      if (!this.mousePosition.equals(mousePosition)) {
-        this.mousePosition.copy(mousePosition);
-        this.mousePositionChanged = true;
-      }
-      this.mouseEntered = true;
-    } else {
-      this.mouseEntered = false;
-      this.mousePositionChanged = false;
-    }
+    if (mousePosition) this.mousePosition.copy(mousePosition);
   }
   /**
    * Calculate the intersection.
    * @returns The intersection point or undefined if no intersection was found.
    */
-  calculate() {
+  calculate(instancedMesh) {
+    this.updateIntersectionMesh(instancedMesh);
     if (!this.camera) return;
-    if (!this.mouseEntered) return;
     if (this.geometryNeedsUpdate) {
       this.geometryNeedsUpdate = false;
       this.blendedGeometry = this.getBlendedGeometry();
-      this.mousePositionChanged = true;
     }
-    if (this.mousePositionChanged) {
-      this.mousePositionChanged = false;
-      if (this.blendedGeometry) {
-        this.intersection = this.getFirstIntersection(this.blendedGeometry, this.camera);
-      } else {
-        this.intersection = void 0;
-      }
+    if (this.blendedGeometry) {
+      this.intersection = this.getFirstIntersection(this.camera, instancedMesh);
+    } else {
+      this.intersection = void 0;
     }
     if (this.intersection) {
       this.eventEmitter.emit("interactionPositionUpdated", { position: this.intersection });
@@ -2579,12 +2529,25 @@ class IntersectionService {
     (_a = this.blendedGeometry) == null ? void 0 : _a.dispose();
     this.intersectionMesh.geometry.dispose();
   }
-  getFirstIntersection(geometry, camera) {
+  updateIntersectionMesh(instancedMesh) {
+    if (this.blendedGeometry) {
+      if (this.blendedGeometry.uuid !== this.intersectionMesh.geometry.uuid) {
+        this.intersectionMesh.geometry.dispose();
+        this.intersectionMesh.geometry = this.blendedGeometry;
+      }
+    }
+    this.intersectionMesh.matrix.copy(instancedMesh.matrixWorld);
+    this.intersectionMesh.matrixWorld.copy(instancedMesh.matrixWorld);
+    this.intersectionMesh.matrixAutoUpdate = false;
+    this.intersectionMesh.updateMatrixWorld(true);
+  }
+  getFirstIntersection(camera, instancedMesh) {
     this.raycaster.setFromCamera(this.mousePosition, camera);
-    this.intersectionMesh.geometry = geometry;
     const intersection = this.raycaster.intersectObject(this.intersectionMesh, false)[0];
     if (intersection) {
-      return new THREE.Vector4(intersection.point.x, intersection.point.y, intersection.point.z, 1);
+      const worldPoint = intersection.point.clone();
+      const localPoint = instancedMesh.worldToLocal(worldPoint);
+      return new THREE.Vector4(localPoint.x, localPoint.y, localPoint.z, 1);
     }
   }
   getBlendedGeometry() {
@@ -2622,46 +2585,6 @@ class IntersectionService {
     return blended;
   }
 }
-class MatcapService {
-  constructor(eventEmitter, matcaps) {
-    __publicField(this, "matcaps", /* @__PURE__ */ new Map());
-    __publicField(this, "eventEmitter");
-    __publicField(this, "fallbackMatcap", new THREE.DataTexture(new Uint8Array([127, 127, 127, 255]), 1, 1, THREE.RGBAFormat));
-    this.eventEmitter = eventEmitter;
-    if (matcaps) {
-      matcaps.forEach(({ id, item }) => this.setMatcap(id, item));
-    }
-    this.updateServiceState("ready");
-  }
-  getMatcap(id) {
-    const texture = this.matcaps.get(id);
-    if (!texture) {
-      this.eventEmitter.emit("invalidRequest", { message: `invalid matcap request: ${id}` });
-      return this.fallbackMatcap;
-    } else {
-      return texture;
-    }
-  }
-  setMatcap(id, texture) {
-    const previous = this.matcaps.get(id);
-    if (previous === texture) return;
-    this.matcaps.set(id, texture);
-    if (previous) {
-      this.eventEmitter.emit("matcapReplaced", { id });
-      previous.dispose();
-    } else {
-      this.eventEmitter.emit("matcapRegistered", { id });
-    }
-  }
-  dispose() {
-    this.updateServiceState("disposed");
-    this.matcaps.forEach((texture) => texture.dispose());
-    this.matcaps.clear();
-  }
-  updateServiceState(serviceState) {
-    this.eventEmitter.emit("serviceStateUpdated", { type: "matcap", state: serviceState });
-  }
-}
 const _camera = new OrthographicCamera(-1, 1, 1, -1, 0, 1);
 class FullscreenTriangleGeometry extends BufferGeometry {
   constructor() {
@@ -3264,6 +3187,122 @@ class TransitionService {
     this.eventEmitter.emit("transitionFinished", { type });
   }
 }
+class AssetService {
+  constructor(eventEmitter) {
+    __publicField(this, "serviceState", "created");
+    __publicField(this, "eventEmitter");
+    __publicField(this, "meshes", /* @__PURE__ */ new Map());
+    __publicField(this, "textures", /* @__PURE__ */ new Map());
+    __publicField(this, "gltfLoader", new GLTFLoader());
+    __publicField(this, "textureLoader", new THREE.TextureLoader());
+    __publicField(this, "dracoLoader", new DRACOLoader());
+    __publicField(this, "solidColorTexture", new THREE.DataTexture(new Uint8Array([127, 127, 127, 255]), 1, 1, THREE.RGBAFormat));
+    this.eventEmitter = eventEmitter;
+    this.dracoLoader.setDecoderPath("https://www.gstatic.com/draco/versioned/decoders/1.5.7/");
+    this.gltfLoader.setDRACOLoader(this.dracoLoader);
+    this.updateServiceState("ready");
+  }
+  /**
+   * Registers an asset.
+   * @param id - The ID of the asset.
+   * @param item - The asset to set.
+   */
+  register(id, item) {
+    item.name = id;
+    if (item instanceof THREE.Mesh) {
+      const prev = this.meshes.get(id);
+      if (prev) disposeMesh(prev);
+      this.meshes.set(id, item);
+    } else {
+      const prev = this.textures.get(id);
+      if (prev) prev.dispose();
+      this.textures.set(id, item);
+    }
+    this.eventEmitter.emit("assetRegistered", { id });
+  }
+  setSolidColor(color) {
+    this.changeColor(color);
+  }
+  getSolidColorTexture() {
+    return this.solidColorTexture;
+  }
+  getMesh(id) {
+    return this.meshes.get(id) ?? null;
+  }
+  getMatcap(id) {
+    const texture = this.textures.get(id);
+    if (!texture) this.eventEmitter.emit("invalidRequest", { message: `texture with id "${id}" not found. using solid color texture instead...` });
+    return texture ?? this.solidColorTexture;
+  }
+  getMeshIDs() {
+    return Array.from(this.meshes.keys());
+  }
+  getTextureIDs() {
+    return Array.from(this.textures.keys());
+  }
+  getMeshes() {
+    return Array.from(this.meshes.values());
+  }
+  getTextures() {
+    return Array.from(this.textures.values());
+  }
+  /**
+   * Loads a mesh asynchronously.
+   * @param id - The ID of the mesh.
+   * @param url - The URL of the mesh.
+   * @param options - Optional parameters.
+   * @returns The loaded mesh or null.
+   */
+  async loadMeshAsync(id, url, options = {}) {
+    const gltf = await this.gltfLoader.loadAsync(url);
+    try {
+      if (options.meshName) {
+        const mesh = gltf.scene.getObjectByName(options.meshName);
+        this.register(id, mesh);
+        return mesh;
+      } else {
+        const mesh = gltf.scene.children[0];
+        this.register(id, mesh);
+        return mesh;
+      }
+    } catch (error) {
+      this.eventEmitter.emit("invalidRequest", { message: `failed to load mesh: ${id}. ${error}` });
+      return null;
+    }
+  }
+  /**
+   * Loads a texture asynchronously.
+   * @param id - The ID of the texture.
+   * @param url - The URL of the texture.
+   * @returns The loaded texture or null.
+   */
+  async loadTextureAsync(id, url) {
+    try {
+      const texture = await this.textureLoader.loadAsync(url);
+      this.register(id, texture);
+      return texture;
+    } catch (error) {
+      this.eventEmitter.emit("invalidRequest", { message: `failed to load texture: ${id}. ${error}` });
+      return null;
+    }
+  }
+  dispose() {
+    this.updateServiceState("disposed");
+    this.meshes.forEach((mesh) => disposeMesh(mesh));
+    this.meshes.clear();
+    this.textures.forEach((texture) => texture.dispose());
+    this.textures.clear();
+  }
+  changeColor(color) {
+    const actual = new THREE.Color(color);
+    this.solidColorTexture = new THREE.DataTexture(new Uint8Array([actual.r, actual.g, actual.b, 255]), 1, 1, THREE.RGBAFormat);
+    this.solidColorTexture.needsUpdate = true;
+  }
+  updateServiceState(serviceState) {
+    this.serviceState = serviceState;
+    this.eventEmitter.emit("serviceStateUpdated", { type: "asset", state: serviceState });
+  }
+}
 class ParticlesEngine {
   /**
    * Creates a new ParticlesEngine instance.
@@ -3276,8 +3315,8 @@ class ParticlesEngine {
     __publicField(this, "scene");
     __publicField(this, "serviceStates");
     // assets
+    __publicField(this, "assetService");
     __publicField(this, "dataTextureManager");
-    __publicField(this, "matcapService");
     __publicField(this, "instancedMeshManager");
     __publicField(this, "transitionService");
     __publicField(this, "engineState");
@@ -3288,9 +3327,9 @@ class ParticlesEngine {
     this.scene = params.scene;
     this.renderer = params.renderer;
     this.engineState = this.initialEngineState(params.textureSize);
+    this.assetService = new AssetService(this.eventEmitter);
     this.transitionService = new TransitionService(this.eventEmitter);
-    this.dataTextureManager = new DataTextureService(this.eventEmitter, params.textureSize, params.meshes);
-    this.matcapService = new MatcapService(this.eventEmitter, params.matcaps);
+    this.dataTextureManager = new DataTextureService(this.eventEmitter, params.textureSize);
     this.simulationRendererService = new SimulationRendererService(this.eventEmitter, params.textureSize, this.renderer);
     this.instancedMeshManager = new InstancedMeshManager(params.textureSize);
     this.instancedMeshManager.useMatcapMaterial();
@@ -3304,7 +3343,7 @@ class ParticlesEngine {
    * @param elapsedTime The elapsed time since the last frame.
    */
   render(elapsedTime) {
-    this.intersectionService.calculate();
+    this.intersectionService.calculate(this.instancedMeshManager.getMesh());
     this.transitionService.compute(elapsedTime);
     this.simulationRendererService.compute(elapsedTime);
     this.instancedMeshManager.update(elapsedTime);
@@ -3313,24 +3352,31 @@ class ParticlesEngine {
   }
   setOriginDataTexture(meshID, override = false) {
     if (override) this.eventEmitter.emit("transitionCancelled", { type: "data-texture" });
-    this.dataTextureManager.getDataTexture(meshID).then((texture) => {
+    const mesh = this.assetService.getMesh(meshID);
+    if (!mesh) {
+      this.eventEmitter.emit("invalidRequest", { message: `Mesh with id "${meshID}" does not exist` });
+      return;
+    }
+    this.dataTextureManager.getDataTexture(mesh).then((dataTexture) => {
       this.engineState.originMeshID = meshID;
-      this.simulationRendererService.setOriginDataTexture({
-        dataTexture: texture,
-        textureSize: this.engineState.textureSize
-      });
-      this.intersectionService.setOriginGeometry(this.dataTextureManager.getMesh(meshID));
+      this.simulationRendererService.setOriginDataTexture({ dataTexture, textureSize: this.engineState.textureSize });
+      this.intersectionService.setOriginGeometry(mesh);
     });
   }
   setDestinationDataTexture(meshID, override = false) {
     if (override) this.eventEmitter.emit("transitionCancelled", { type: "data-texture" });
-    this.dataTextureManager.getDataTexture(meshID).then((texture) => {
+    const mesh = this.assetService.getMesh(meshID);
+    if (!mesh) {
+      this.eventEmitter.emit("invalidRequest", { message: `Mesh with id "${meshID}" does not exist` });
+      return;
+    }
+    this.dataTextureManager.getDataTexture(mesh).then((texture) => {
       this.engineState.destinationMeshID = meshID;
       this.simulationRendererService.setDestinationDataTexture({
         dataTexture: texture,
         textureSize: this.engineState.textureSize
       });
-      this.intersectionService.setDestinationGeometry(this.dataTextureManager.getMesh(meshID));
+      this.intersectionService.setDestinationGeometry(mesh);
     });
   }
   setDataTextureTransitionProgress(progress, override = false) {
@@ -3342,12 +3388,12 @@ class ParticlesEngine {
   setOriginMatcap(matcapID, override = false) {
     if (override) this.eventEmitter.emit("transitionCancelled", { type: "matcap" });
     this.engineState.originMatcapID = matcapID;
-    this.instancedMeshManager.setOriginMatcap(this.matcapService.getMatcap(matcapID));
+    this.instancedMeshManager.setOriginMatcap(this.assetService.getMatcap(matcapID));
   }
   setDestinationMatcap(matcapID, override = false) {
     if (override) this.eventEmitter.emit("transitionCancelled", { type: "matcap" });
     this.engineState.destinationMatcapID = matcapID;
-    this.instancedMeshManager.setDestinationMatcap(this.matcapService.getMatcap(matcapID));
+    this.instancedMeshManager.setDestinationMatcap(this.assetService.getMatcap(matcapID));
   }
   setMatcapProgress(progress, override = false) {
     if (override) this.eventEmitter.emit("transitionCancelled", { type: "matcap" });
@@ -3359,8 +3405,18 @@ class ParticlesEngine {
     this.dataTextureManager.setTextureSize(size);
     this.simulationRendererService.setTextureSize(size);
     this.instancedMeshManager.resize(size);
-    this.dataTextureManager.getDataTexture(this.engineState.originMeshID).then((texture) => this.simulationRendererService.setOriginDataTexture({ dataTexture: texture, textureSize: size }));
-    this.dataTextureManager.getDataTexture(this.engineState.destinationMeshID).then(
+    const originMesh = this.assetService.getMesh(this.engineState.originMeshID);
+    if (!originMesh) {
+      this.eventEmitter.emit("invalidRequest", { message: `Mesh with id "${this.engineState.originMeshID}" does not exist` });
+      return;
+    }
+    const destinationMesh = this.assetService.getMesh(this.engineState.destinationMeshID);
+    if (!destinationMesh) {
+      this.eventEmitter.emit("invalidRequest", { message: `Mesh with id "${this.engineState.destinationMeshID}" does not exist` });
+      return;
+    }
+    this.dataTextureManager.getDataTexture(originMesh).then((texture) => this.simulationRendererService.setOriginDataTexture({ dataTexture: texture, textureSize: size }));
+    this.dataTextureManager.getDataTexture(destinationMesh).then(
       (texture) => this.simulationRendererService.setDestinationDataTexture({
         dataTexture: texture,
         textureSize: size
@@ -3369,11 +3425,23 @@ class ParticlesEngine {
     this.simulationRendererService.setDataTextureTransitionProgress(this.engineState.dataTextureTransitionProgress);
     this.simulationRendererService.setVelocityTractionForce(this.engineState.velocityTractionForce);
     this.simulationRendererService.setPositionalTractionForce(this.engineState.positionalTractionForce);
-    this.instancedMeshManager.setOriginMatcap(this.matcapService.getMatcap(this.engineState.originMatcapID));
-    this.instancedMeshManager.setDestinationMatcap(this.matcapService.getMatcap(this.engineState.destinationMatcapID));
+    this.instancedMeshManager.setOriginMatcap(this.assetService.getMatcap(this.engineState.originMatcapID));
+    this.instancedMeshManager.setDestinationMatcap(this.assetService.getMatcap(this.engineState.destinationMatcapID));
     this.instancedMeshManager.setProgress(this.engineState.matcapTransitionProgress);
     this.instancedMeshManager.setGeometrySize(this.engineState.instanceGeometryScale);
   }
+  registerMesh(id, mesh) {
+    this.assetService.register(id, mesh);
+  }
+  registerMatcap(id, matcap) {
+    this.assetService.register(id, matcap);
+  }
+  async fetchAndRegisterMesh(id, url) {
+    return await this.assetService.loadMeshAsync(id, url);
+  }
+  async fetchAndRegisterMatcap(id, url) {
+    return await this.assetService.loadTextureAsync(id, url);
+  }
   setPointerPosition(position) {
     this.engineState.pointerPosition = position;
     this.intersectionService.setMousePosition(position);
@@ -3421,19 +3489,27 @@ class ParticlesEngine {
     );
   }
   handleServiceStateUpdated({ type, state }) {
-    console.log("service state updated", type, state);
     this.serviceStates[type] = state;
   }
+  getObject() {
+    return this.instancedMeshManager.getMesh();
+  }
+  getMeshIDs() {
+    return this.assetService.getMeshIDs();
+  }
+  getMatcapIDs() {
+    return this.assetService.getTextureIDs();
+  }
   /**
    * Disposes the resources used by the engine.
    */
   dispose() {
     this.scene.remove(this.instancedMeshManager.getMesh());
-    this.matcapService.dispose();
     this.simulationRendererService.dispose();
     this.instancedMeshManager.dispose();
     this.intersectionService.dispose();
-    this.dataTextureManager.dispose().then(() => console.log("engine disposed"));
+    this.assetService.dispose();
+    this.dataTextureManager.dispose();
   }
   initialEngineState(textureSize) {
     return {
@@ -3456,7 +3532,8 @@ class ParticlesEngine {
       "data-texture": "created",
       "instanced-mesh": "created",
       matcap: "created",
-      simulation: "created"
+      simulation: "created",
+      asset: "created"
     };
   }
   handleTransitionProgress({ type, progress }) {