@mml-io/3d-web-avatar 0.15.0 → 0.17.0

package/build/character/MMLCharacter.d.ts

@@ -1,14 +1,14 @@
+import { ModelLoadResult } from "@mml-io/model-loader";
 import { Object3D } from "three";
 import { MMLCharacterDescriptionPart } from "../helpers/parseMMLDescription";
-import { ModelLoader } from "./ModelLoader";
+type MMLCharacterModelLoader = {
+    load: (url: string) => Promise<ModelLoadResult>;
+};
 export declare class MMLCharacter {
     private modelLoader;
-    private skeletonHelpers;
-    private skinnedMeshesParent;
-    private sharedSkeleton;
-    private sharedMatrixWorld;
-    constructor(modelLoader: ModelLoader);
+    constructor(modelLoader: MMLCharacterModelLoader);
     private createBoneIndexMap;
     private remapBoneIndices;
     mergeBodyParts(fullBodyURL: string, bodyParts: Array<MMLCharacterDescriptionPart>): Promise<Object3D>;
 }
+export {};

package/build/helpers/cloneSkinnedMesh.d.ts

@@ -0,0 +1,2 @@
+import { Group } from "three";
+export declare function cloneSkinnedMesh(model: Group): import("three").Object3D<import("three").Object3DEventMap>;

package/build/index.d.ts

@@ -1,6 +1,5 @@
 export { MMLCharacter } from "./character/MMLCharacter";
-export { cloneModel } from "./helpers/SkeletonHelpers";
+export { cloneSkinnedMesh } from "./helpers/cloneSkinnedMesh";
 export { TimeManagerInterface } from "./character/types";
-export { ModelLoader } from "./character/ModelLoader";
 export { type LoadingErrors, type MMLCharacterDescriptionPart, type MMLCharacterDescription, parseMMLDescription, } from "./helpers/parseMMLDescription";
 export { createMMLCharacterString } from "./helpers/createMMLCharacterString";

package/build/index.js

@@ -1,177 +1,8 @@
 // src/character/MMLCharacter.ts
-import {
-  BufferAttribute,
-  Euler,
-  MathUtils,
-  Vector3
-} from "three";
-
-// src/helpers/SkeletonHelpers.ts
-import { Skeleton } from "three";
-import * as SkeletonUtils from "three/examples/jsm/utils/SkeletonUtils.js";
-function cloneModel(model) {
-  const clone2 = SkeletonUtils.clone(model);
-  return clone2;
-}
-var SkeletonHelpers = class {
-  constructor() {
-    this.debug = false;
-    this.hierarchies = [];
-    this.modelNames = [];
-  }
-  extractBoneHierarchy(node) {
-    if (node.type !== "Bone")
-      return null;
-    const boneMap = /* @__PURE__ */ new Map();
-    node.children.forEach((child) => {
-      const childHierarchy = this.extractBoneHierarchy(child);
-      if (childHierarchy)
-        boneMap.set(child.name, childHierarchy);
-    });
-    return boneMap;
-  }
-  areBoneHierarchiesEqual(a, b, modelNameA, modelNameB, path = []) {
-    let identical = true;
-    const differences = [];
-    if (a.size !== b.size) {
-      differences.push(
-        `Different number of children at path: ${path.join(
-          " -> "
-        )} in models ${modelNameA} and ${modelNameB}.`
-      );
-      identical = false;
-    }
-    for (const [key, value] of a) {
-      if (!b.has(key)) {
-        differences.push(
-          `Bone "${key}" was found in model ${modelNameA} but not in model ${modelNameB} at path: ${path.join(
-            " -> "
-          )}.`
-        );
-        identical = false;
-        continue;
-      }
-      const newPath = [...path, key];
-      const result = this.areBoneHierarchiesEqual(
-        value,
-        b.get(key),
-        modelNameA,
-        modelNameB,
-        newPath
-      );
-      if (!result.identical) {
-        identical = false;
-        differences.push(...result.differences);
-      }
-    }
-    for (const key of b.keys()) {
-      if (!a.has(key)) {
-        differences.push(
-          `Bone "${key}" was found in model ${modelNameB} but not in model ${modelNameA} at path: ${path.join(
-            " -> "
-          )}.`
-        );
-        identical = false;
-      }
-    }
-    return {
-      identical,
-      differences
-    };
-  }
-  extractAndStoreBoneHierarchy(node, modelName) {
-    const newHierarchy = this.extractBoneHierarchy(node);
-    if (!newHierarchy) {
-      console.log(`No bone hierarchy found in the model: ${modelName}.`);
-      return;
-    }
-    this.hierarchies.push(newHierarchy);
-    this.modelNames.push(modelName);
-  }
-  compareLatestHierarchies() {
-    if (this.hierarchies.length < 2)
-      return;
-    const latestHierarchy = this.hierarchies[this.hierarchies.length - 1];
-    const previousHierarchy = this.hierarchies[this.hierarchies.length - 2];
-    const diff = this.areBoneHierarchiesEqual(
-      previousHierarchy,
-      latestHierarchy,
-      this.modelNames[this.modelNames.length - 2],
-      this.modelNames[this.modelNames.length - 1],
-      []
-    );
-    if (diff.identical) {
-      if (this.debug)
-        console.log("The skeletons are identical.");
-    } else {
-      diff.differences.forEach((difference) => console.log(difference));
-    }
-  }
-  cloneGLTF(gltf, modelName) {
-    const clone2 = {
-      animations: gltf.animations,
-      scene: cloneModel(gltf.scene)
-    };
-    let sharedSkeleton = null;
-    let matrixWorld = null;
-    const skinnedMeshes = {};
-    gltf.scene.traverse((node) => {
-      if (node.type === "SkinnedMesh") {
-        skinnedMeshes[node.name] = node;
-      }
-    });
-    const cloneBones = {};
-    const cloneSkinnedMeshes = {};
-    let hierarchyCheck = false;
-    clone2.scene.traverse((node) => {
-      if (node.isMesh || node.isSkinnedMesh) {
-        node.castShadow = true;
-        node.receiveShadow = true;
-      }
-      if (node.type === "Bone") {
-        if (hierarchyCheck === false) {
-          hierarchyCheck = true;
-          this.extractAndStoreBoneHierarchy(node, modelName);
-        }
-        cloneBones[node.name] = node;
-      }
-      if (node.type === "SkinnedMesh") {
-        cloneSkinnedMeshes[node.name] = node;
-      }
-    });
-    for (const name in skinnedMeshes) {
-      const skinnedMesh = skinnedMeshes[name];
-      const skeleton = skinnedMesh.skeleton;
-      const cloneSkinnedMesh = cloneSkinnedMeshes[name];
-      const orderedCloneBones = [];
-      for (let i = 0; i < skeleton.bones.length; ++i) {
-        const cloneBone = cloneBones[skeleton.bones[i].name];
-        orderedCloneBones.push(cloneBone);
-      }
-      if (sharedSkeleton === null) {
-        sharedSkeleton = new Skeleton(orderedCloneBones, skeleton.boneInverses);
-      }
-      if (matrixWorld === null) {
-        matrixWorld = cloneSkinnedMesh.matrixWorld;
-      }
-      cloneSkinnedMesh.bind(sharedSkeleton, matrixWorld);
-    }
-    return {
-      gltf: clone2,
-      sharedSkeleton,
-      matrixWorld
-    };
-  }
-};
-
-// src/character/MMLCharacter.ts
+import { BufferAttribute, Group, MathUtils } from "three";
 var MMLCharacter = class {
   constructor(modelLoader) {
     this.modelLoader = modelLoader;
-    this.skeletonHelpers = new SkeletonHelpers();
-    this.skinnedMeshesParent = null;
-    this.sharedSkeleton = null;
-    this.sharedMatrixWorld = null;
   }
   createBoneIndexMap(originSkeleton, targetSkeleton) {
     const boneIndexMap = /* @__PURE__ */ new Map();
@@ -184,8 +15,7 @@ var MMLCharacter = class {
     }
     return boneIndexMap;
   }
-  remapBoneIndices(skinnedMesh) {
-    const targetSkeleton = this.sharedSkeleton;
+  remapBoneIndices(skinnedMesh, targetSkeleton) {
     const originSkeleton = skinnedMesh.skeleton;
     const originGeometry = skinnedMesh.geometry;
     const boneIndexMap = this.createBoneIndexMap(originSkeleton, targetSkeleton);
@@ -206,8 +36,8 @@ var MMLCharacter = class {
     );
   }
   async mergeBodyParts(fullBodyURL, bodyParts) {
-    const fullBodyAsset = await this.modelLoader.load(fullBodyURL);
-    const fullBodyGLTF = this.skeletonHelpers.cloneGLTF(fullBodyAsset, "fullBody");
+    const group = new Group();
+    const fullBodyAssetPromise = this.modelLoader.load(fullBodyURL);
     const assetPromises = bodyParts.map((part) => {
       return new Promise((resolve) => {
         this.modelLoader.load(part.url).then((asset) => {
@@ -215,11 +45,11 @@ var MMLCharacter = class {
         });
       });
     });
+    const fullBodyAsset = await fullBodyAssetPromise;
     const assets = await Promise.all(assetPromises);
-    const fullBodyModelGroup = fullBodyGLTF.gltf.scene;
-    this.skinnedMeshesParent = null;
+    const rawBodyGltf = fullBodyAsset.group;
     const availableBones = /* @__PURE__ */ new Map();
-    fullBodyModelGroup.traverse((child) => {
+    rawBodyGltf.traverse((child) => {
       const asBone = child;
       if (asBone.isBone) {
         availableBones.set(child.name, asBone);
@@ -228,17 +58,32 @@ var MMLCharacter = class {
       if (asSkinnedMesh.isSkinnedMesh) {
         asSkinnedMesh.castShadow = true;
         asSkinnedMesh.receiveShadow = true;
-        if (this.skinnedMeshesParent === null) {
-          this.skinnedMeshesParent = asSkinnedMesh.parent;
-        }
       }
     });
-    this.sharedSkeleton = fullBodyGLTF.sharedSkeleton;
-    this.sharedMatrixWorld = fullBodyGLTF.matrixWorld;
+    const foundSkinnedMeshes = [];
+    rawBodyGltf.traverse((child) => {
+      const asSkinnedMesh = child;
+      if (asSkinnedMesh.isSkinnedMesh) {
+        foundSkinnedMeshes.push(asSkinnedMesh);
+      }
+    });
+    if (foundSkinnedMeshes.length === 0) {
+      throw new Error("No skinned mesh in base model file");
+    }
+    if (foundSkinnedMeshes.length > 1) {
+      console.warn(
+        "Multiple skinned meshes in base model file. Expected 1. Using first for skeleton."
+      );
+    }
+    const skinnedMesh = foundSkinnedMeshes[0];
+    group.add(...foundSkinnedMeshes);
+    const sharedSkeleton = skinnedMesh.skeleton;
+    group.add(skinnedMesh.skeleton.bones[0]);
+    const sharedMatrixWorld = skinnedMesh.matrixWorld;
     for (const loadingAsset of assets) {
       const part = loadingAsset.part;
-      const gltf = this.skeletonHelpers.cloneGLTF(loadingAsset.asset, part.url);
-      const modelGroup = gltf.gltf.scene;
+      const rawGltf = loadingAsset.asset;
+      const modelGroup = rawGltf.group;
       if (part.socket) {
         const socketName = part.socket.socket;
         let bone = availableBones.get("root");
@@ -250,144 +95,46 @@ var MMLCharacter = class {
           );
         }
         if (bone) {
-          modelGroup.position.set(0, 0, 0);
-          modelGroup.rotation.set(0, 0, 0);
-          modelGroup.scale.set(1, 1, 1);
           bone.add(modelGroup);
-          modelGroup.rotateZ(-Math.PI / 2);
-          const offsetPosition = new Vector3(
+          modelGroup.position.set(
             part.socket.position.x,
             part.socket.position.y,
             part.socket.position.z
           );
-          modelGroup.position.copy(offsetPosition);
-          const offsetRotation = new Euler(
+          modelGroup.rotation.set(
             MathUtils.degToRad(part.socket.rotation.x),
             MathUtils.degToRad(part.socket.rotation.y),
             MathUtils.degToRad(part.socket.rotation.z)
           );
-          modelGroup.setRotationFromEuler(offsetRotation);
           modelGroup.scale.set(part.socket.scale.x, part.socket.scale.y, part.socket.scale.z);
         }
       } else {
+        const skinnedMeshes = [];
         modelGroup.traverse((child) => {
-          var _a;
           const asSkinnedMesh = child;
           if (asSkinnedMesh.isSkinnedMesh) {
-            const skinnedMeshClone = child.clone(true);
-            this.remapBoneIndices(skinnedMeshClone);
-            skinnedMeshClone.castShadow = true;
-            skinnedMeshClone.receiveShadow = true;
-            skinnedMeshClone.bind(this.sharedSkeleton, this.sharedMatrixWorld);
-            skinnedMeshClone.children = [];
-            (_a = this.skinnedMeshesParent) == null ? void 0 : _a.add(skinnedMeshClone);
+            skinnedMeshes.push(asSkinnedMesh);
           }
         });
+        for (const skinnedMeshPart of skinnedMeshes) {
+          this.remapBoneIndices(skinnedMeshPart, sharedSkeleton);
+          skinnedMeshPart.castShadow = true;
+          skinnedMeshPart.receiveShadow = true;
+          skinnedMeshPart.bind(sharedSkeleton, sharedMatrixWorld);
+          skinnedMeshPart.children = [];
+          group.add(skinnedMeshPart);
+        }
       }
     }
-    return fullBodyGLTF.gltf.scene;
+    return group;
   }
 };
 
-// src/character/ModelLoader.ts
-import { LoadingManager } from "three";
-import { GLTFLoader as ThreeGLTFLoader } from "three/examples/jsm/loaders/GLTFLoader.js";
-var CachedGLTFLoader = class extends ThreeGLTFLoader {
-  constructor(manager) {
-    super(manager);
-    this.blobCache = /* @__PURE__ */ new Map();
-  }
-  setBlobUrl(originalUrl, blobUrl) {
-    this.blobCache.set(originalUrl, blobUrl);
-  }
-  getBlobUrl(originalUrl) {
-    return this.blobCache.get(originalUrl);
-  }
-  load(url, onLoad, onProgress, onError) {
-    const blobUrl = this.getBlobUrl(url);
-    const effectiveUrl = blobUrl || url;
-    super.load(effectiveUrl, onLoad, onProgress, onError);
-  }
-};
-var LRUCache = class {
-  constructor(maxSize = 100) {
-    this.maxSize = maxSize;
-    this.cache = /* @__PURE__ */ new Map();
-  }
-  get(key) {
-    const item = this.cache.get(key);
-    if (item) {
-      this.cache.delete(key);
-      this.cache.set(key, item);
-    }
-    return item;
-  }
-  set(key, value) {
-    if (this.cache.size >= this.maxSize) {
-      const oldestKey = this.cache.keys().next().value;
-      this.cache.delete(oldestKey);
-    }
-    this.cache.set(key, value);
-  }
-};
-var _ModelLoader = class _ModelLoader {
-  constructor(maxCacheSize = 100, debug = false) {
-    this.debug = debug;
-    this.ongoingLoads = /* @__PURE__ */ new Map();
-    this.loadingManager = new LoadingManager();
-    this.gltfLoader = new CachedGLTFLoader(this.loadingManager);
-    this.modelCache = new LRUCache(maxCacheSize);
-  }
-  static getInstance() {
-    if (!_ModelLoader.instance) {
-      _ModelLoader.instance = new _ModelLoader();
-    }
-    return _ModelLoader.instance;
-  }
-  async load(fileUrl) {
-    const cachedModel = this.modelCache.get(fileUrl);
-    if (cachedModel) {
-      if (this.debug === true) {
-        console.log(`Loading ${fileUrl.split("/").pop()} from cache`);
-      }
-      const blobURL = URL.createObjectURL(cachedModel.blob);
-      this.gltfLoader.setBlobUrl(fileUrl, blobURL);
-      return this.loadFromUrl(blobURL);
-    } else {
-      if (this.debug === true) {
-        console.log(`Loading ${fileUrl} from server`);
-      }
-      const ongoingLoad = this.ongoingLoads.get(fileUrl);
-      if (ongoingLoad)
-        return ongoingLoad;
-      const loadPromise = fetch(fileUrl).then((response) => response.blob()).then((blob) => {
-        this.modelCache.set(fileUrl, { blob });
-        const blobURL = URL.createObjectURL(blob);
-        this.ongoingLoads.delete(fileUrl);
-        return this.loadFromUrl(blobURL);
-      });
-      this.ongoingLoads.set(fileUrl, loadPromise);
-      return loadPromise;
-    }
-  }
-  async loadFromUrl(url) {
-    return new Promise((resolve, reject) => {
-      this.gltfLoader.load(
-        url,
-        (object) => {
-          resolve(object);
-        },
-        void 0,
-        (error) => {
-          console.error(`Error loading model from ${url}: ${error}`);
-          reject(error);
-        }
-      );
-    });
-  }
-};
-_ModelLoader.instance = null;
-var ModelLoader = _ModelLoader;
+// src/helpers/cloneSkinnedMesh.ts
+import * as SkeletonUtils from "three/examples/jsm/utils/SkeletonUtils.js";
+function cloneSkinnedMesh(model) {
+  return SkeletonUtils.clone(model);
+}
 
 // src/helpers/parseMMLDescription.ts
 var parseMMLDescription = (mmlDescription) => {
@@ -487,8 +234,7 @@ var createMMLCharacterString = (characterDescription) => {
 };
 export {
   MMLCharacter,
-  ModelLoader,
-  cloneModel,
+  cloneSkinnedMesh,
   createMMLCharacterString,
   parseMMLDescription
 };

package/build/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../src/character/MMLCharacter.ts", "../src/helpers/SkeletonHelpers.ts", "../src/character/ModelLoader.ts", "../src/helpers/parseMMLDescription.ts", "../src/helpers/createMMLCharacterString.ts"],
-  "sourcesContent": ["import {\n  Bone,\n  BufferAttribute,\n  Euler,\n  Group,\n  MathUtils,\n  Matrix4,\n  MeshStandardMaterial,\n  Object3D,\n  Skeleton,\n  SkinnedMesh,\n  Vector3,\n} from \"three\";\nimport { GLTF } from \"three/examples/jsm/loaders/GLTFLoader.js\";\n\nimport { MMLCharacterDescriptionPart } from \"../helpers/parseMMLDescription\";\nimport { SkeletonHelpers } from \"../helpers/SkeletonHelpers\";\n\nimport { ModelLoader } from \"./ModelLoader\";\n\nexport class MMLCharacter {\n  private skeletonHelpers: SkeletonHelpers = new SkeletonHelpers();\n  private skinnedMeshesParent: Group | null = null;\n  private sharedSkeleton: Skeleton | null = null;\n  private sharedMatrixWorld: Matrix4 | null = null;\n\n  constructor(private modelLoader: ModelLoader) {}\n\n  private createBoneIndexMap(\n    originSkeleton: Skeleton,\n    targetSkeleton: Skeleton,\n  ): Map<number, number> {\n    const boneIndexMap = new Map<number, number>();\n\n    for (let i = 0; i < originSkeleton.bones.length; i++) {\n      const originBone = originSkeleton.bones[i];\n      const targetBone = targetSkeleton.bones.find((bone) => bone.name === originBone.name);\n      if (targetBone) {\n        boneIndexMap.set(i, targetSkeleton.bones.indexOf(targetBone));\n      }\n    }\n    return boneIndexMap;\n  }\n\n  private remapBoneIndices(skinnedMesh: SkinnedMesh): void {\n    const targetSkeleton = this.sharedSkeleton!;\n    const originSkeleton = skinnedMesh.skeleton;\n    const originGeometry = skinnedMesh.geometry;\n\n    const boneIndexMap = this.createBoneIndexMap(originSkeleton, targetSkeleton);\n\n    const newSkinIndexArray = [];\n    for (let i = 0; i < originGeometry.attributes.skinIndex.array.length; i++) {\n      const originIndex = originGeometry.attributes.skinIndex.array[i];\n      const targetIndex = boneIndexMap.get(originIndex);\n      if (targetIndex !== undefined) {\n        newSkinIndexArray.push(targetIndex);\n      } else {\n        console.error(\"Missing bone index\", originIndex);\n        newSkinIndexArray.push(0);\n      }\n    }\n    skinnedMesh.geometry.attributes.skinIndex = new BufferAttribute(\n      new Uint8Array(newSkinIndexArray),\n      4,\n    );\n  }\n\n  public async mergeBodyParts(\n    fullBodyURL: string,\n    bodyParts: Array<MMLCharacterDescriptionPart>,\n  ): Promise<Object3D> {\n    const fullBodyAsset = await this.modelLoader.load(fullBodyURL);\n    const fullBodyGLTF = this.skeletonHelpers.cloneGLTF(fullBodyAsset as GLTF, \"fullBody\");\n    const assetPromises: Array<Promise<{ asset: GLTF; part: MMLCharacterDescriptionPart }>> =\n      bodyParts.map((part) => {\n        return new Promise((resolve) => {\n          this.modelLoader.load(part.url).then((asset) => {\n            resolve({ asset: asset!, part });\n          });\n        });\n      });\n    const assets = await Promise.all(assetPromises);\n\n    const fullBodyModelGroup = fullBodyGLTF.gltf.scene;\n\n    this.skinnedMeshesParent = null;\n\n    const availableBones = new Map<string, Bone>();\n    fullBodyModelGroup.traverse((child) => {\n      const asBone = child as Bone;\n      if (asBone.isBone) {\n        availableBones.set(child.name, asBone);\n      }\n\n      const asSkinnedMesh = child as SkinnedMesh;\n      if (asSkinnedMesh.isSkinnedMesh) {\n        asSkinnedMesh.castShadow = true;\n        asSkinnedMesh.receiveShadow = true;\n        if (this.skinnedMeshesParent === null) {\n          this.skinnedMeshesParent = asSkinnedMesh.parent as Group;\n        }\n      }\n    });\n    this.sharedSkeleton = fullBodyGLTF.sharedSkeleton;\n    this.sharedMatrixWorld = fullBodyGLTF.matrixWorld;\n\n    for (const loadingAsset of assets) {\n      const part = loadingAsset.part;\n      const gltf = this.skeletonHelpers.cloneGLTF(loadingAsset.asset, part.url);\n      const modelGroup = gltf.gltf.scene;\n      if (part.socket) {\n        const socketName = part.socket.socket;\n        let bone = availableBones.get(\"root\");\n        if (availableBones.has(socketName)) {\n          bone = availableBones.get(socketName);\n        } else {\n          console.warn(\n            `WARNING: no bone found for [${socketName}] socket. Attatching to Root bone`,\n          );\n        }\n        if (bone) {\n          modelGroup.position.set(0, 0, 0);\n          modelGroup.rotation.set(0, 0, 0);\n          modelGroup.scale.set(1, 1, 1);\n\n          bone.add(modelGroup);\n\n          modelGroup.rotateZ(-Math.PI / 2);\n\n          const offsetPosition = new Vector3(\n            part.socket.position.x,\n            part.socket.position.y,\n            part.socket.position.z,\n          );\n          modelGroup.position.copy(offsetPosition);\n\n          const offsetRotation = new Euler(\n            MathUtils.degToRad(part.socket.rotation.x),\n            MathUtils.degToRad(part.socket.rotation.y),\n            MathUtils.degToRad(part.socket.rotation.z),\n          );\n          modelGroup.setRotationFromEuler(offsetRotation);\n\n          modelGroup.scale.set(part.socket.scale.x, part.socket.scale.y, part.socket.scale.z);\n        }\n      } else {\n        modelGroup.traverse((child) => {\n          const asSkinnedMesh = child as SkinnedMesh;\n          if (asSkinnedMesh.isSkinnedMesh) {\n            const skinnedMeshClone = child.clone(true) as SkinnedMesh;\n            this.remapBoneIndices(skinnedMeshClone);\n            skinnedMeshClone.castShadow = true;\n            skinnedMeshClone.receiveShadow = true;\n            skinnedMeshClone.bind(this.sharedSkeleton!, this.sharedMatrixWorld!);\n            skinnedMeshClone.children = [];\n            this.skinnedMeshesParent?.add(skinnedMeshClone);\n          }\n        });\n      }\n    }\n    return fullBodyGLTF!.gltf.scene as Object3D;\n  }\n}\n", "import { Bone, Group, Matrix4, Mesh, Object3D, Skeleton, SkinnedMesh } from \"three\";\nimport { GLTF } from \"three/examples/jsm/loaders/GLTFLoader.js\";\nimport * as SkeletonUtils from \"three/examples/jsm/utils/SkeletonUtils.js\";\n\ntype ClonedGLTFParts = {\n  gltf: GLTF;\n  sharedSkeleton: Skeleton;\n  matrixWorld: Matrix4;\n};\n\ntype BoneHierarchyMap = Map<string, BoneHierarchyMap>;\ntype DiffResult = {\n  identical: boolean;\n  differences: string[];\n};\n\nexport function cloneModel(model: Group) {\n  const clone = SkeletonUtils.clone(model);\n  return clone;\n}\n\nexport class SkeletonHelpers {\n  private debug: boolean = false;\n  private hierarchies: BoneHierarchyMap[] = [];\n  private modelNames: string[] = [];\n\n  private extractBoneHierarchy(node: Object3D): BoneHierarchyMap | null {\n    if (node.type !== \"Bone\") return null;\n    const boneMap: BoneHierarchyMap = new Map();\n    node.children.forEach((child) => {\n      const childHierarchy = this.extractBoneHierarchy(child);\n      if (childHierarchy) boneMap.set(child.name, childHierarchy);\n    });\n    return boneMap;\n  }\n\n  private areBoneHierarchiesEqual(\n    a: BoneHierarchyMap,\n    b: BoneHierarchyMap,\n    modelNameA: string,\n    modelNameB: string,\n    path: string[] = [],\n  ): DiffResult {\n    let identical = true;\n    const differences: string[] = [];\n\n    if (a.size !== b.size) {\n      differences.push(\n        `Different number of children at path: ${path.join(\n          \" -> \",\n        )} in models ${modelNameA} and ${modelNameB}.`,\n      );\n      identical = false;\n    }\n\n    for (const [key, value] of a) {\n      if (!b.has(key)) {\n        differences.push(\n          `Bone \"${key}\" was found in model ${modelNameA} but not in model ${modelNameB} at path: ${path.join(\n            \" -> \",\n          )}.`,\n        );\n        identical = false;\n        continue;\n      }\n\n      const newPath = [...path, key];\n      const result = this.areBoneHierarchiesEqual(\n        value,\n        b.get(key)!,\n        modelNameA,\n        modelNameB,\n        newPath,\n      );\n\n      if (!result.identical) {\n        identical = false;\n        differences.push(...result.differences);\n      }\n    }\n\n    for (const key of b.keys()) {\n      if (!a.has(key)) {\n        differences.push(\n          `Bone \"${key}\" was found in model ${modelNameB} but not in model ${modelNameA} at path: ${path.join(\n            \" -> \",\n          )}.`,\n        );\n        identical = false;\n      }\n    }\n\n    return {\n      identical,\n      differences,\n    };\n  }\n\n  public extractAndStoreBoneHierarchy(node: Object3D, modelName: string) {\n    const newHierarchy = this.extractBoneHierarchy(node);\n\n    if (!newHierarchy) {\n      console.log(`No bone hierarchy found in the model: ${modelName}.`);\n      return;\n    }\n\n    this.hierarchies.push(newHierarchy);\n    this.modelNames.push(modelName);\n  }\n\n  public compareLatestHierarchies() {\n    if (this.hierarchies.length < 2) return;\n\n    const latestHierarchy = this.hierarchies[this.hierarchies.length - 1];\n    const previousHierarchy = this.hierarchies[this.hierarchies.length - 2];\n\n    const diff = this.areBoneHierarchiesEqual(\n      previousHierarchy,\n      latestHierarchy,\n      this.modelNames[this.modelNames.length - 2],\n      this.modelNames[this.modelNames.length - 1],\n      [],\n    );\n\n    if (diff.identical) {\n      if (this.debug) console.log(\"The skeletons are identical.\");\n    } else {\n      diff.differences.forEach((difference) => console.log(difference));\n    }\n  }\n\n  public cloneGLTF(gltf: GLTF, modelName: string): ClonedGLTFParts {\n    const clone: Partial<GLTF> = {\n      animations: gltf.animations,\n      scene: cloneModel(gltf.scene) as Group,\n    };\n\n    let sharedSkeleton: Skeleton | null = null;\n    let matrixWorld: Matrix4 | null = null;\n\n    const skinnedMeshes: Record<string, SkinnedMesh> = {};\n\n    gltf.scene.traverse((node) => {\n      if (node.type === \"SkinnedMesh\") {\n        skinnedMeshes[node.name] = node as SkinnedMesh;\n      }\n    });\n\n    const cloneBones: Record<string, Bone> = {};\n    const cloneSkinnedMeshes: Record<string, SkinnedMesh> = {};\n\n    let hierarchyCheck = false;\n    clone.scene!.traverse((node) => {\n      if ((node as Mesh).isMesh || (node as SkinnedMesh).isSkinnedMesh) {\n        node.castShadow = true;\n        node.receiveShadow = true;\n      }\n      if (node.type === \"Bone\") {\n        if (hierarchyCheck === false) {\n          hierarchyCheck = true;\n          this.extractAndStoreBoneHierarchy(node, modelName);\n        }\n        cloneBones[node.name] = node as Bone;\n      }\n\n      if (node.type === \"SkinnedMesh\") {\n        cloneSkinnedMeshes[node.name] = node as SkinnedMesh;\n      }\n    });\n\n    for (const name in skinnedMeshes) {\n      const skinnedMesh = skinnedMeshes[name];\n      const skeleton = skinnedMesh.skeleton;\n      const cloneSkinnedMesh = cloneSkinnedMeshes[name];\n\n      const orderedCloneBones = [];\n\n      for (let i = 0; i < skeleton.bones.length; ++i) {\n        const cloneBone = cloneBones[skeleton.bones[i].name];\n        orderedCloneBones.push(cloneBone);\n      }\n\n      if (sharedSkeleton === null) {\n        sharedSkeleton = new Skeleton(orderedCloneBones, skeleton.boneInverses);\n      }\n\n      if (matrixWorld === null) {\n        matrixWorld = cloneSkinnedMesh.matrixWorld;\n      }\n\n      cloneSkinnedMesh.bind(sharedSkeleton, matrixWorld);\n    }\n\n    return {\n      gltf: clone as GLTF,\n      sharedSkeleton: sharedSkeleton as Skeleton,\n      matrixWorld: matrixWorld as Matrix4,\n    };\n  }\n}\n", "import { LoadingManager } from \"three\";\nimport { GLTF, GLTFLoader as ThreeGLTFLoader } from \"three/examples/jsm/loaders/GLTFLoader.js\";\n\nclass CachedGLTFLoader extends ThreeGLTFLoader {\n  private blobCache: Map<string, string>;\n\n  constructor(manager?: LoadingManager) {\n    super(manager);\n    this.blobCache = new Map();\n  }\n\n  setBlobUrl(originalUrl: string, blobUrl: string) {\n    this.blobCache.set(originalUrl, blobUrl);\n  }\n\n  getBlobUrl(originalUrl: string): string | undefined {\n    return this.blobCache.get(originalUrl);\n  }\n\n  load(\n    url: string,\n    onLoad: (gltf: GLTF) => void,\n    onProgress?: ((event: ProgressEvent<EventTarget>) => void) | undefined,\n    onError?: ((event: ErrorEvent) => void) | undefined,\n  ): void {\n    const blobUrl = this.getBlobUrl(url);\n    const effectiveUrl = blobUrl || url;\n    super.load(effectiveUrl, onLoad, onProgress, onError);\n  }\n}\n\nclass LRUCache<K, V> {\n  private maxSize: number;\n  private cache: Map<K, V>;\n\n  constructor(maxSize: number = 100) {\n    this.maxSize = maxSize;\n    this.cache = new Map();\n  }\n\n  get(key: K): V | undefined {\n    const item = this.cache.get(key);\n    if (item) {\n      this.cache.delete(key);\n      this.cache.set(key, item);\n    }\n    return item;\n  }\n\n  set(key: K, value: V): void {\n    if (this.cache.size >= this.maxSize) {\n      const oldestKey = this.cache.keys().next().value;\n      this.cache.delete(oldestKey);\n    }\n    this.cache.set(key, value);\n  }\n}\n\ninterface CachedModel {\n  blob: Blob;\n}\n\nexport class ModelLoader {\n  private static instance: ModelLoader | null = null;\n\n  private readonly loadingManager: LoadingManager;\n  private readonly gltfLoader: CachedGLTFLoader;\n  private modelCache: LRUCache<string, CachedModel>;\n  private ongoingLoads: Map<string, Promise<GLTF | undefined>> = new Map();\n\n  constructor(\n    maxCacheSize: number = 100,\n    private debug: boolean = false,\n  ) {\n    this.loadingManager = new LoadingManager();\n    this.gltfLoader = new CachedGLTFLoader(this.loadingManager);\n    this.modelCache = new LRUCache(maxCacheSize);\n  }\n\n  static getInstance(): ModelLoader {\n    if (!ModelLoader.instance) {\n      ModelLoader.instance = new ModelLoader();\n    }\n    return ModelLoader.instance;\n  }\n\n  async load(fileUrl: string): Promise<GLTF | undefined> {\n    const cachedModel = this.modelCache.get(fileUrl);\n\n    if (cachedModel) {\n      if (this.debug === true) {\n        console.log(`Loading ${fileUrl.split(\"/\").pop()} from cache`);\n      }\n      const blobURL = URL.createObjectURL(cachedModel.blob);\n      this.gltfLoader.setBlobUrl(fileUrl, blobURL);\n      return this.loadFromUrl(blobURL);\n    } else {\n      if (this.debug === true) {\n        console.log(`Loading ${fileUrl} from server`);\n      }\n      const ongoingLoad = this.ongoingLoads.get(fileUrl);\n      if (ongoingLoad) return ongoingLoad;\n\n      const loadPromise = fetch(fileUrl)\n        .then((response) => response.blob())\n        .then((blob) => {\n          this.modelCache.set(fileUrl, { blob });\n          const blobURL = URL.createObjectURL(blob);\n          this.ongoingLoads.delete(fileUrl);\n          return this.loadFromUrl(blobURL);\n        });\n\n      this.ongoingLoads.set(fileUrl, loadPromise);\n      return loadPromise;\n    }\n  }\n\n  private async loadFromUrl(url: string): Promise<GLTF | undefined> {\n    return new Promise((resolve, reject) => {\n      this.gltfLoader.load(\n        url,\n        (object: GLTF) => {\n          resolve(object);\n        },\n        undefined,\n        (error) => {\n          console.error(`Error loading model from ${url}: ${error}`);\n          reject(error);\n        },\n      );\n    });\n  }\n}\n", "export type MMLCharacterDescriptionPart = {\n  url: string;\n  type?: string;\n  socket?: {\n    socket: string;\n    position: { x: number; y: number; z: number };\n    scale: { x: number; y: number; z: number };\n    rotation: { x: number; y: number; z: number };\n  };\n};\n\nexport type MMLCharacterDescription = {\n  base: MMLCharacterDescriptionPart;\n  parts: MMLCharacterDescriptionPart[];\n};\n\nexport type LoadingErrors = string[];\n\nexport const parseMMLDescription = (\n  mmlDescription: string,\n): [MMLCharacterDescription, LoadingErrors] => {\n  const parser: DOMParser = new DOMParser();\n  const doc = parser.parseFromString(mmlDescription, \"text/html\");\n\n  const tag = (count: number) => {\n    return count > 1 ? \"tags\" : \"tag\";\n  };\n\n  const errors: string[] = [];\n\n  const warn = (errorMessage: string) => {\n    errors.push(errorMessage);\n    console.warn(errorMessage);\n  };\n\n  const characters = Array.from(doc.body.children).filter(\n    (child) => child.tagName.toLowerCase() === \"m-character\",\n  );\n  const validCharacter = characters.shift();\n\n  if (characters.length > 0) {\n    const tagStr = tag(characters.length);\n    warn(\n      `ignoring ${characters.length} extra <m-character> ${tagStr} found in the root of the document (only the first one is valid).`,\n    );\n  }\n\n  const nestedCharacters = doc.querySelectorAll(\"body * m-character\");\n  if (nestedCharacters.length > 0) {\n    const tagStr = tag(nestedCharacters.length);\n    warn(\n      `ignoring ${nestedCharacters.length} nested <m-character> ${tagStr} found within other tags. A valid <m-character> tag must be at the root of the document.`,\n    );\n  }\n\n  const rootModels = Array.from(doc.body.children).filter(\n    (child) => child.tagName.toLowerCase() === \"m-model\",\n  );\n  if (rootModels.length > 0) {\n    const tagStr = tag(rootModels.length);\n    warn(\n      `ignoring ${rootModels.length} <m-model> ${tagStr} were found at the root of the document (<m-model> tags must be children of a valid <m-character> tag).`,\n    );\n  }\n\n  let base: MMLCharacterDescriptionPart = { url: \"\" };\n  let parts: MMLCharacterDescriptionPart[] = [];\n\n  if (validCharacter) {\n    const baseSrc = validCharacter.getAttribute(\"src\") ?? \"\";\n    base = { url: baseSrc };\n\n    const directModelChildren = Array.from(validCharacter.children).filter(\n      (child) => child.tagName.toLowerCase() === \"m-model\",\n    );\n    parts = directModelChildren.map((model) => {\n      const partSrc = model.getAttribute(\"src\") ?? \"\";\n\n      const socketAttr = model.getAttribute(\"socket\");\n      const position = {\n        x: parseFloat(model.getAttribute(\"x\") ?? \"0\") || 0,\n        y: parseFloat(model.getAttribute(\"y\") ?? \"0\") || 0,\n        z: parseFloat(model.getAttribute(\"z\") ?? \"0\") || 0,\n      };\n      const scale = {\n        x: parseFloat(model.getAttribute(\"sx\") ?? \"1\") || 1,\n        y: parseFloat(model.getAttribute(\"sy\") ?? \"1\") || 1,\n        z: parseFloat(model.getAttribute(\"sz\") ?? \"1\") || 1,\n      };\n      const rotation = {\n        x: parseFloat(model.getAttribute(\"rx\") ?? \"0\") || 0,\n        y: parseFloat(model.getAttribute(\"ry\") ?? \"0\") || 0,\n        z: parseFloat(model.getAttribute(\"rz\") ?? \"0\") || 0,\n      };\n\n      const socketObj = socketAttr ? { socket: socketAttr, position, scale, rotation } : undefined;\n\n      return { url: partSrc, socket: socketObj };\n    });\n\n    const wrappedModelTags = Array.from(doc.querySelectorAll(\"m-character m-model\")).filter(\n      (model) => !directModelChildren.includes(model),\n    );\n    if (wrappedModelTags.length > 0) {\n      const tagStr = tag(wrappedModelTags.length);\n      warn(\n        `ignoring ${wrappedModelTags.length} <m-model> ${tagStr} that were found wrapped inside tags other than a valid <m-character> tag.`,\n      );\n    }\n  } else {\n    warn(`No valid <m-character> tag was found in the provided document.`);\n  }\n\n  const characterDescription: MMLCharacterDescription = {\n    base: base,\n    parts: parts,\n  };\n\n  return [characterDescription, errors];\n};\n", "import { MMLCharacterDescription } from \"./parseMMLDescription\";\n\nexport const createMMLCharacterString = (characterDescription: MMLCharacterDescription): string => {\n  const base = characterDescription.base.url;\n\n  const partsTags = characterDescription.parts.map(\n    (part) => `<m-model src=\"${part.url}\"${part.type ? ` type=\"${part.type}\"` : \"\"}></m-model>`,\n  );\n\n  return `<m-character src=\"${base}\">\n  ${partsTags.join(\"\\n  \")}\n</m-character>`;\n};\n"],
-  "mappings": ";AAAA;AAAA,EAEE;AAAA,EACA;AAAA,EAEA;AAAA,EAMA;AAAA,OACK;;;ACZP,SAA+C,gBAA6B;AAE5E,YAAY,mBAAmB;AAcxB,SAAS,WAAW,OAAc;AACvC,QAAMA,SAAsB,oBAAM,KAAK;AACvC,SAAOA;AACT;AAEO,IAAM,kBAAN,MAAsB;AAAA,EAAtB;AACL,SAAQ,QAAiB;AACzB,SAAQ,cAAkC,CAAC;AAC3C,SAAQ,aAAuB,CAAC;AAAA;AAAA,EAExB,qBAAqB,MAAyC;AACpE,QAAI,KAAK,SAAS;AAAQ,aAAO;AACjC,UAAM,UAA4B,oBAAI,IAAI;AAC1C,SAAK,SAAS,QAAQ,CAAC,UAAU;AAC/B,YAAM,iBAAiB,KAAK,qBAAqB,KAAK;AACtD,UAAI;AAAgB,gBAAQ,IAAI,MAAM,MAAM,cAAc;AAAA,IAC5D,CAAC;AACD,WAAO;AAAA,EACT;AAAA,EAEQ,wBACN,GACA,GACA,YACA,YACA,OAAiB,CAAC,GACN;AACZ,QAAI,YAAY;AAChB,UAAM,cAAwB,CAAC;AAE/B,QAAI,EAAE,SAAS,EAAE,MAAM;AACrB,kBAAY;AAAA,QACV,yCAAyC,KAAK;AAAA,UAC5C;AAAA,QACF,CAAC,cAAc,UAAU,QAAQ,UAAU;AAAA,MAC7C;AACA,kBAAY;AAAA,IACd;AAEA,eAAW,CAAC,KAAK,KAAK,KAAK,GAAG;AAC5B,UAAI,CAAC,EAAE,IAAI,GAAG,GAAG;AACf,oBAAY;AAAA,UACV,SAAS,GAAG,wBAAwB,UAAU,qBAAqB,UAAU,aAAa,KAAK;AAAA,YAC7F;AAAA,UACF,CAAC;AAAA,QACH;AACA,oBAAY;AACZ;AAAA,MACF;AAEA,YAAM,UAAU,CAAC,GAAG,MAAM,GAAG;AAC7B,YAAM,SAAS,KAAK;AAAA,QAClB;AAAA,QACA,EAAE,IAAI,GAAG;AAAA,QACT;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAEA,UAAI,CAAC,OAAO,WAAW;AACrB,oBAAY;AACZ,oBAAY,KAAK,GAAG,OAAO,WAAW;AAAA,MACxC;AAAA,IACF;AAEA,eAAW,OAAO,EAAE,KAAK,GAAG;AAC1B,UAAI,CAAC,EAAE,IAAI,GAAG,GAAG;AACf,oBAAY;AAAA,UACV,SAAS,GAAG,wBAAwB,UAAU,qBAAqB,UAAU,aAAa,KAAK;AAAA,YAC7F;AAAA,UACF,CAAC;AAAA,QACH;AACA,oBAAY;AAAA,MACd;AAAA,IACF;AAEA,WAAO;AAAA,MACL;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA,EAEO,6BAA6B,MAAgB,WAAmB;AACrE,UAAM,eAAe,KAAK,qBAAqB,IAAI;AAEnD,QAAI,CAAC,cAAc;AACjB,cAAQ,IAAI,yCAAyC,SAAS,GAAG;AACjE;AAAA,IACF;AAEA,SAAK,YAAY,KAAK,YAAY;AAClC,SAAK,WAAW,KAAK,SAAS;AAAA,EAChC;AAAA,EAEO,2BAA2B;AAChC,QAAI,KAAK,YAAY,SAAS;AAAG;AAEjC,UAAM,kBAAkB,KAAK,YAAY,KAAK,YAAY,SAAS,CAAC;AACpE,UAAM,oBAAoB,KAAK,YAAY,KAAK,YAAY,SAAS,CAAC;AAEtE,UAAM,OAAO,KAAK;AAAA,MAChB;AAAA,MACA;AAAA,MACA,KAAK,WAAW,KAAK,WAAW,SAAS,CAAC;AAAA,MAC1C,KAAK,WAAW,KAAK,WAAW,SAAS,CAAC;AAAA,MAC1C,CAAC;AAAA,IACH;AAEA,QAAI,KAAK,WAAW;AAClB,UAAI,KAAK;AAAO,gBAAQ,IAAI,8BAA8B;AAAA,IAC5D,OAAO;AACL,WAAK,YAAY,QAAQ,CAAC,eAAe,QAAQ,IAAI,UAAU,CAAC;AAAA,IAClE;AAAA,EACF;AAAA,EAEO,UAAU,MAAY,WAAoC;AAC/D,UAAMA,SAAuB;AAAA,MAC3B,YAAY,KAAK;AAAA,MACjB,OAAO,WAAW,KAAK,KAAK;AAAA,IAC9B;AAEA,QAAI,iBAAkC;AACtC,QAAI,cAA8B;AAElC,UAAM,gBAA6C,CAAC;AAEpD,SAAK,MAAM,SAAS,CAAC,SAAS;AAC5B,UAAI,KAAK,SAAS,eAAe;AAC/B,sBAAc,KAAK,IAAI,IAAI;AAAA,MAC7B;AAAA,IACF,CAAC;AAED,UAAM,aAAmC,CAAC;AAC1C,UAAM,qBAAkD,CAAC;AAEzD,QAAI,iBAAiB;AACrB,IAAAA,OAAM,MAAO,SAAS,CAAC,SAAS;AAC9B,UAAK,KAAc,UAAW,KAAqB,eAAe;AAChE,aAAK,aAAa;AAClB,aAAK,gBAAgB;AAAA,MACvB;AACA,UAAI,KAAK,SAAS,QAAQ;AACxB,YAAI,mBAAmB,OAAO;AAC5B,2BAAiB;AACjB,eAAK,6BAA6B,MAAM,SAAS;AAAA,QACnD;AACA,mBAAW,KAAK,IAAI,IAAI;AAAA,MAC1B;AAEA,UAAI,KAAK,SAAS,eAAe;AAC/B,2BAAmB,KAAK,IAAI,IAAI;AAAA,MAClC;AAAA,IACF,CAAC;AAED,eAAW,QAAQ,eAAe;AAChC,YAAM,cAAc,cAAc,IAAI;AACtC,YAAM,WAAW,YAAY;AAC7B,YAAM,mBAAmB,mBAAmB,IAAI;AAEhD,YAAM,oBAAoB,CAAC;AAE3B,eAAS,IAAI,GAAG,IAAI,SAAS,MAAM,QAAQ,EAAE,GAAG;AAC9C,cAAM,YAAY,WAAW,SAAS,MAAM,CAAC,EAAE,IAAI;AACnD,0BAAkB,KAAK,SAAS;AAAA,MAClC;AAEA,UAAI,mBAAmB,MAAM;AAC3B,yBAAiB,IAAI,SAAS,mBAAmB,SAAS,YAAY;AAAA,MACxE;AAEA,UAAI,gBAAgB,MAAM;AACxB,sBAAc,iBAAiB;AAAA,MACjC;AAEA,uBAAiB,KAAK,gBAAgB,WAAW;AAAA,IACnD;AAEA,WAAO;AAAA,MACL,MAAMA;AAAA,MACN;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACF;;;ADnLO,IAAM,eAAN,MAAmB;AAAA,EAMxB,YAAoB,aAA0B;AAA1B;AALpB,SAAQ,kBAAmC,IAAI,gBAAgB;AAC/D,SAAQ,sBAAoC;AAC5C,SAAQ,iBAAkC;AAC1C,SAAQ,oBAAoC;AAAA,EAEG;AAAA,EAEvC,mBACN,gBACA,gBACqB;AACrB,UAAM,eAAe,oBAAI,IAAoB;AAE7C,aAAS,IAAI,GAAG,IAAI,eAAe,MAAM,QAAQ,KAAK;AACpD,YAAM,aAAa,eAAe,MAAM,CAAC;AACzC,YAAM,aAAa,eAAe,MAAM,KAAK,CAAC,SAAS,KAAK,SAAS,WAAW,IAAI;AACpF,UAAI,YAAY;AACd,qBAAa,IAAI,GAAG,eAAe,MAAM,QAAQ,UAAU,CAAC;AAAA,MAC9D;AAAA,IACF;AACA,WAAO;AAAA,EACT;AAAA,EAEQ,iBAAiB,aAAgC;AACvD,UAAM,iBAAiB,KAAK;AAC5B,UAAM,iBAAiB,YAAY;AACnC,UAAM,iBAAiB,YAAY;AAEnC,UAAM,eAAe,KAAK,mBAAmB,gBAAgB,cAAc;AAE3E,UAAM,oBAAoB,CAAC;AAC3B,aAAS,IAAI,GAAG,IAAI,eAAe,WAAW,UAAU,MAAM,QAAQ,KAAK;AACzE,YAAM,cAAc,eAAe,WAAW,UAAU,MAAM,CAAC;AAC/D,YAAM,cAAc,aAAa,IAAI,WAAW;AAChD,UAAI,gBAAgB,QAAW;AAC7B,0BAAkB,KAAK,WAAW;AAAA,MACpC,OAAO;AACL,gBAAQ,MAAM,sBAAsB,WAAW;AAC/C,0BAAkB,KAAK,CAAC;AAAA,MAC1B;AAAA,IACF;AACA,gBAAY,SAAS,WAAW,YAAY,IAAI;AAAA,MAC9C,IAAI,WAAW,iBAAiB;AAAA,MAChC;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAa,eACX,aACA,WACmB;AACnB,UAAM,gBAAgB,MAAM,KAAK,YAAY,KAAK,WAAW;AAC7D,UAAM,eAAe,KAAK,gBAAgB,UAAU,eAAuB,UAAU;AACrF,UAAM,gBACJ,UAAU,IAAI,CAAC,SAAS;AACtB,aAAO,IAAI,QAAQ,CAAC,YAAY;AAC9B,aAAK,YAAY,KAAK,KAAK,GAAG,EAAE,KAAK,CAAC,UAAU;AAC9C,kBAAQ,EAAE,OAAe,KAAK,CAAC;AAAA,QACjC,CAAC;AAAA,MACH,CAAC;AAAA,IACH,CAAC;AACH,UAAM,SAAS,MAAM,QAAQ,IAAI,aAAa;AAE9C,UAAM,qBAAqB,aAAa,KAAK;AAE7C,SAAK,sBAAsB;AAE3B,UAAM,iBAAiB,oBAAI,IAAkB;AAC7C,uBAAmB,SAAS,CAAC,UAAU;AACrC,YAAM,SAAS;AACf,UAAI,OAAO,QAAQ;AACjB,uBAAe,IAAI,MAAM,MAAM,MAAM;AAAA,MACvC;AAEA,YAAM,gBAAgB;AACtB,UAAI,cAAc,eAAe;AAC/B,sBAAc,aAAa;AAC3B,sBAAc,gBAAgB;AAC9B,YAAI,KAAK,wBAAwB,MAAM;AACrC,eAAK,sBAAsB,cAAc;AAAA,QAC3C;AAAA,MACF;AAAA,IACF,CAAC;AACD,SAAK,iBAAiB,aAAa;AACnC,SAAK,oBAAoB,aAAa;AAEtC,eAAW,gBAAgB,QAAQ;AACjC,YAAM,OAAO,aAAa;AAC1B,YAAM,OAAO,KAAK,gBAAgB,UAAU,aAAa,OAAO,KAAK,GAAG;AACxE,YAAM,aAAa,KAAK,KAAK;AAC7B,UAAI,KAAK,QAAQ;AACf,cAAM,aAAa,KAAK,OAAO;AAC/B,YAAI,OAAO,eAAe,IAAI,MAAM;AACpC,YAAI,eAAe,IAAI,UAAU,GAAG;AAClC,iBAAO,eAAe,IAAI,UAAU;AAAA,QACtC,OAAO;AACL,kBAAQ;AAAA,YACN,+BAA+B,UAAU;AAAA,UAC3C;AAAA,QACF;AACA,YAAI,MAAM;AACR,qBAAW,SAAS,IAAI,GAAG,GAAG,CAAC;AAC/B,qBAAW,SAAS,IAAI,GAAG,GAAG,CAAC;AAC/B,qBAAW,MAAM,IAAI,GAAG,GAAG,CAAC;AAE5B,eAAK,IAAI,UAAU;AAEnB,qBAAW,QAAQ,CAAC,KAAK,KAAK,CAAC;AAE/B,gBAAM,iBAAiB,IAAI;AAAA,YACzB,KAAK,OAAO,SAAS;AAAA,YACrB,KAAK,OAAO,SAAS;AAAA,YACrB,KAAK,OAAO,SAAS;AAAA,UACvB;AACA,qBAAW,SAAS,KAAK,cAAc;AAEvC,gBAAM,iBAAiB,IAAI;AAAA,YACzB,UAAU,SAAS,KAAK,OAAO,SAAS,CAAC;AAAA,YACzC,UAAU,SAAS,KAAK,OAAO,SAAS,CAAC;AAAA,YACzC,UAAU,SAAS,KAAK,OAAO,SAAS,CAAC;AAAA,UAC3C;AACA,qBAAW,qBAAqB,cAAc;AAE9C,qBAAW,MAAM,IAAI,KAAK,OAAO,MAAM,GAAG,KAAK,OAAO,MAAM,GAAG,KAAK,OAAO,MAAM,CAAC;AAAA,QACpF;AAAA,MACF,OAAO;AACL,mBAAW,SAAS,CAAC,UAAU;AAnJvC;AAoJU,gBAAM,gBAAgB;AACtB,cAAI,cAAc,eAAe;AAC/B,kBAAM,mBAAmB,MAAM,MAAM,IAAI;AACzC,iBAAK,iBAAiB,gBAAgB;AACtC,6BAAiB,aAAa;AAC9B,6BAAiB,gBAAgB;AACjC,6BAAiB,KAAK,KAAK,gBAAiB,KAAK,iBAAkB;AACnE,6BAAiB,WAAW,CAAC;AAC7B,uBAAK,wBAAL,mBAA0B,IAAI;AAAA,UAChC;AAAA,QACF,CAAC;AAAA,MACH;AAAA,IACF;AACA,WAAO,aAAc,KAAK;AAAA,EAC5B;AACF;;;AEnKA,SAAS,sBAAsB;AAC/B,SAAe,cAAc,uBAAuB;AAEpD,IAAM,mBAAN,cAA+B,gBAAgB;AAAA,EAG7C,YAAY,SAA0B;AACpC,UAAM,OAAO;AACb,SAAK,YAAY,oBAAI,IAAI;AAAA,EAC3B;AAAA,EAEA,WAAW,aAAqB,SAAiB;AAC/C,SAAK,UAAU,IAAI,aAAa,OAAO;AAAA,EACzC;AAAA,EAEA,WAAW,aAAyC;AAClD,WAAO,KAAK,UAAU,IAAI,WAAW;AAAA,EACvC;AAAA,EAEA,KACE,KACA,QACA,YACA,SACM;AACN,UAAM,UAAU,KAAK,WAAW,GAAG;AACnC,UAAM,eAAe,WAAW;AAChC,UAAM,KAAK,cAAc,QAAQ,YAAY,OAAO;AAAA,EACtD;AACF;AAEA,IAAM,WAAN,MAAqB;AAAA,EAInB,YAAY,UAAkB,KAAK;AACjC,SAAK,UAAU;AACf,SAAK,QAAQ,oBAAI,IAAI;AAAA,EACvB;AAAA,EAEA,IAAI,KAAuB;AACzB,UAAM,OAAO,KAAK,MAAM,IAAI,GAAG;AAC/B,QAAI,MAAM;AACR,WAAK,MAAM,OAAO,GAAG;AACrB,WAAK,MAAM,IAAI,KAAK,IAAI;AAAA,IAC1B;AACA,WAAO;AAAA,EACT;AAAA,EAEA,IAAI,KAAQ,OAAgB;AAC1B,QAAI,KAAK,MAAM,QAAQ,KAAK,SAAS;AACnC,YAAM,YAAY,KAAK,MAAM,KAAK,EAAE,KAAK,EAAE;AAC3C,WAAK,MAAM,OAAO,SAAS;AAAA,IAC7B;AACA,SAAK,MAAM,IAAI,KAAK,KAAK;AAAA,EAC3B;AACF;AAMO,IAAM,eAAN,MAAM,aAAY;AAAA,EAQvB,YACE,eAAuB,KACf,QAAiB,OACzB;AADQ;AAJV,SAAQ,eAAuD,oBAAI,IAAI;AAMrE,SAAK,iBAAiB,IAAI,eAAe;AACzC,SAAK,aAAa,IAAI,iBAAiB,KAAK,cAAc;AAC1D,SAAK,aAAa,IAAI,SAAS,YAAY;AAAA,EAC7C;AAAA,EAEA,OAAO,cAA2B;AAChC,QAAI,CAAC,aAAY,UAAU;AACzB,mBAAY,WAAW,IAAI,aAAY;AAAA,IACzC;AACA,WAAO,aAAY;AAAA,EACrB;AAAA,EAEA,MAAM,KAAK,SAA4C;AACrD,UAAM,cAAc,KAAK,WAAW,IAAI,OAAO;AAE/C,QAAI,aAAa;AACf,UAAI,KAAK,UAAU,MAAM;AACvB,gBAAQ,IAAI,WAAW,QAAQ,MAAM,GAAG,EAAE,IAAI,CAAC,aAAa;AAAA,MAC9D;AACA,YAAM,UAAU,IAAI,gBAAgB,YAAY,IAAI;AACpD,WAAK,WAAW,WAAW,SAAS,OAAO;AAC3C,aAAO,KAAK,YAAY,OAAO;AAAA,IACjC,OAAO;AACL,UAAI,KAAK,UAAU,MAAM;AACvB,gBAAQ,IAAI,WAAW,OAAO,cAAc;AAAA,MAC9C;AACA,YAAM,cAAc,KAAK,aAAa,IAAI,OAAO;AACjD,UAAI;AAAa,eAAO;AAExB,YAAM,cAAc,MAAM,OAAO,EAC9B,KAAK,CAAC,aAAa,SAAS,KAAK,CAAC,EAClC,KAAK,CAAC,SAAS;AACd,aAAK,WAAW,IAAI,SAAS,EAAE,KAAK,CAAC;AACrC,cAAM,UAAU,IAAI,gBAAgB,IAAI;AACxC,aAAK,aAAa,OAAO,OAAO;AAChC,eAAO,KAAK,YAAY,OAAO;AAAA,MACjC,CAAC;AAEH,WAAK,aAAa,IAAI,SAAS,WAAW;AAC1C,aAAO;AAAA,IACT;AAAA,EACF;AAAA,EAEA,MAAc,YAAY,KAAwC;AAChE,WAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,WAAK,WAAW;AAAA,QACd;AAAA,QACA,CAAC,WAAiB;AAChB,kBAAQ,MAAM;AAAA,QAChB;AAAA,QACA;AAAA,QACA,CAAC,UAAU;AACT,kBAAQ,MAAM,4BAA4B,GAAG,KAAK,KAAK,EAAE;AACzD,iBAAO,KAAK;AAAA,QACd;AAAA,MACF;AAAA,IACF,CAAC;AAAA,EACH;AACF;AAtEa,aACI,WAA+B;AADzC,IAAM,cAAN;;;AC5CA,IAAM,sBAAsB,CACjC,mBAC6C;AAC7C,QAAM,SAAoB,IAAI,UAAU;AACxC,QAAM,MAAM,OAAO,gBAAgB,gBAAgB,WAAW;AAE9D,QAAM,MAAM,CAAC,UAAkB;AAC7B,WAAO,QAAQ,IAAI,SAAS;AAAA,EAC9B;AAEA,QAAM,SAAmB,CAAC;AAE1B,QAAM,OAAO,CAAC,iBAAyB;AACrC,WAAO,KAAK,YAAY;AACxB,YAAQ,KAAK,YAAY;AAAA,EAC3B;AAEA,QAAM,aAAa,MAAM,KAAK,IAAI,KAAK,QAAQ,EAAE;AAAA,IAC/C,CAAC,UAAU,MAAM,QAAQ,YAAY,MAAM;AAAA,EAC7C;AACA,QAAM,iBAAiB,WAAW,MAAM;AAExC,MAAI,WAAW,SAAS,GAAG;AACzB,UAAM,SAAS,IAAI,WAAW,MAAM;AACpC;AAAA,MACE,YAAY,WAAW,MAAM,wBAAwB,MAAM;AAAA,IAC7D;AAAA,EACF;AAEA,QAAM,mBAAmB,IAAI,iBAAiB,oBAAoB;AAClE,MAAI,iBAAiB,SAAS,GAAG;AAC/B,UAAM,SAAS,IAAI,iBAAiB,MAAM;AAC1C;AAAA,MACE,YAAY,iBAAiB,MAAM,yBAAyB,MAAM;AAAA,IACpE;AAAA,EACF;AAEA,QAAM,aAAa,MAAM,KAAK,IAAI,KAAK,QAAQ,EAAE;AAAA,IAC/C,CAAC,UAAU,MAAM,QAAQ,YAAY,MAAM;AAAA,EAC7C;AACA,MAAI,WAAW,SAAS,GAAG;AACzB,UAAM,SAAS,IAAI,WAAW,MAAM;AACpC;AAAA,MACE,YAAY,WAAW,MAAM,cAAc,MAAM;AAAA,IACnD;AAAA,EACF;AAEA,MAAI,OAAoC,EAAE,KAAK,GAAG;AAClD,MAAI,QAAuC,CAAC;AAE5C,MAAI,gBAAgB;AAClB,UAAM,UAAU,eAAe,aAAa,KAAK,KAAK;AACtD,WAAO,EAAE,KAAK,QAAQ;AAEtB,UAAM,sBAAsB,MAAM,KAAK,eAAe,QAAQ,EAAE;AAAA,MAC9D,CAAC,UAAU,MAAM,QAAQ,YAAY,MAAM;AAAA,IAC7C;AACA,YAAQ,oBAAoB,IAAI,CAAC,UAAU;AACzC,YAAM,UAAU,MAAM,aAAa,KAAK,KAAK;AAE7C,YAAM,aAAa,MAAM,aAAa,QAAQ;AAC9C,YAAM,WAAW;AAAA,QACf,GAAG,WAAW,MAAM,aAAa,GAAG,KAAK,GAAG,KAAK;AAAA,QACjD,GAAG,WAAW,MAAM,aAAa,GAAG,KAAK,GAAG,KAAK;AAAA,QACjD,GAAG,WAAW,MAAM,aAAa,GAAG,KAAK,GAAG,KAAK;AAAA,MACnD;AACA,YAAM,QAAQ;AAAA,QACZ,GAAG,WAAW,MAAM,aAAa,IAAI,KAAK,GAAG,KAAK;AAAA,QAClD,GAAG,WAAW,MAAM,aAAa,IAAI,KAAK,GAAG,KAAK;AAAA,QAClD,GAAG,WAAW,MAAM,aAAa,IAAI,KAAK,GAAG,KAAK;AAAA,MACpD;AACA,YAAM,WAAW;AAAA,QACf,GAAG,WAAW,MAAM,aAAa,IAAI,KAAK,GAAG,KAAK;AAAA,QAClD,GAAG,WAAW,MAAM,aAAa,IAAI,KAAK,GAAG,KAAK;AAAA,QAClD,GAAG,WAAW,MAAM,aAAa,IAAI,KAAK,GAAG,KAAK;AAAA,MACpD;AAEA,YAAM,YAAY,aAAa,EAAE,QAAQ,YAAY,UAAU,OAAO,SAAS,IAAI;AAEnF,aAAO,EAAE,KAAK,SAAS,QAAQ,UAAU;AAAA,IAC3C,CAAC;AAED,UAAM,mBAAmB,MAAM,KAAK,IAAI,iBAAiB,qBAAqB,CAAC,EAAE;AAAA,MAC/E,CAAC,UAAU,CAAC,oBAAoB,SAAS,KAAK;AAAA,IAChD;AACA,QAAI,iBAAiB,SAAS,GAAG;AAC/B,YAAM,SAAS,IAAI,iBAAiB,MAAM;AAC1C;AAAA,QACE,YAAY,iBAAiB,MAAM,cAAc,MAAM;AAAA,MACzD;AAAA,IACF;AAAA,EACF,OAAO;AACL,SAAK,gEAAgE;AAAA,EACvE;AAEA,QAAM,uBAAgD;AAAA,IACpD;AAAA,IACA;AAAA,EACF;AAEA,SAAO,CAAC,sBAAsB,MAAM;AACtC;;;ACrHO,IAAM,2BAA2B,CAAC,yBAA0D;AACjG,QAAM,OAAO,qBAAqB,KAAK;AAEvC,QAAM,YAAY,qBAAqB,MAAM;AAAA,IAC3C,CAAC,SAAS,iBAAiB,KAAK,GAAG,IAAI,KAAK,OAAO,UAAU,KAAK,IAAI,MAAM,EAAE;AAAA,EAChF;AAEA,SAAO,qBAAqB,IAAI;AAAA,IAC9B,UAAU,KAAK,MAAM,CAAC;AAAA;AAE1B;",
-  "names": ["clone"]
+  "sources": ["../src/character/MMLCharacter.ts", "../src/helpers/cloneSkinnedMesh.ts", "../src/helpers/parseMMLDescription.ts", "../src/helpers/createMMLCharacterString.ts"],
+  "sourcesContent": ["import { ModelLoadResult } from \"@mml-io/model-loader\";\nimport { Bone, BufferAttribute, Group, MathUtils, Object3D, Skeleton, SkinnedMesh } from \"three\";\n\nimport { MMLCharacterDescriptionPart } from \"../helpers/parseMMLDescription\";\n\ntype MMLCharacterModelLoader = {\n  load: (url: string) => Promise<ModelLoadResult>;\n};\n\nexport class MMLCharacter {\n  constructor(private modelLoader: MMLCharacterModelLoader) {}\n\n  private createBoneIndexMap(\n    originSkeleton: Skeleton,\n    targetSkeleton: Skeleton,\n  ): Map<number, number> {\n    const boneIndexMap = new Map<number, number>();\n\n    for (let i = 0; i < originSkeleton.bones.length; i++) {\n      const originBone = originSkeleton.bones[i];\n      const targetBone = targetSkeleton.bones.find((bone) => bone.name === originBone.name);\n      if (targetBone) {\n        boneIndexMap.set(i, targetSkeleton.bones.indexOf(targetBone));\n      }\n    }\n    return boneIndexMap;\n  }\n\n  private remapBoneIndices(skinnedMesh: SkinnedMesh, targetSkeleton: Skeleton): void {\n    const originSkeleton = skinnedMesh.skeleton;\n    const originGeometry = skinnedMesh.geometry;\n\n    const boneIndexMap = this.createBoneIndexMap(originSkeleton, targetSkeleton);\n\n    const newSkinIndexArray = [];\n    for (let i = 0; i < originGeometry.attributes.skinIndex.array.length; i++) {\n      const originIndex = originGeometry.attributes.skinIndex.array[i];\n      const targetIndex = boneIndexMap.get(originIndex);\n      if (targetIndex !== undefined) {\n        newSkinIndexArray.push(targetIndex);\n      } else {\n        console.error(\"Missing bone index\", originIndex);\n        newSkinIndexArray.push(0);\n      }\n    }\n    skinnedMesh.geometry.attributes.skinIndex = new BufferAttribute(\n      new Uint8Array(newSkinIndexArray),\n      4,\n    );\n  }\n\n  public async mergeBodyParts(\n    fullBodyURL: string,\n    bodyParts: Array<MMLCharacterDescriptionPart>,\n  ): Promise<Object3D> {\n    const group = new Group();\n\n    const fullBodyAssetPromise = this.modelLoader.load(fullBodyURL);\n\n    const assetPromises: Array<\n      Promise<{ asset: ModelLoadResult; part: MMLCharacterDescriptionPart }>\n    > = bodyParts.map((part) => {\n      return new Promise((resolve) => {\n        this.modelLoader.load(part.url).then((asset) => {\n          resolve({ asset, part });\n        });\n      });\n    });\n\n    const fullBodyAsset = await fullBodyAssetPromise;\n    const assets = await Promise.all(assetPromises);\n\n    const rawBodyGltf = fullBodyAsset.group;\n    const availableBones = new Map<string, Bone>();\n    rawBodyGltf.traverse((child) => {\n      const asBone = child as Bone;\n      if (asBone.isBone) {\n        availableBones.set(child.name, asBone);\n      }\n\n      const asSkinnedMesh = child as SkinnedMesh;\n      if (asSkinnedMesh.isSkinnedMesh) {\n        asSkinnedMesh.castShadow = true;\n        asSkinnedMesh.receiveShadow = true;\n      }\n    });\n    const foundSkinnedMeshes: Array<SkinnedMesh> = [];\n    rawBodyGltf.traverse((child) => {\n      const asSkinnedMesh = child as SkinnedMesh;\n      if (asSkinnedMesh.isSkinnedMesh) {\n        foundSkinnedMeshes.push(asSkinnedMesh);\n      }\n    });\n\n    if (foundSkinnedMeshes.length === 0) {\n      throw new Error(\"No skinned mesh in base model file\");\n    }\n    if (foundSkinnedMeshes.length > 1) {\n      console.warn(\n        \"Multiple skinned meshes in base model file. Expected 1. Using first for skeleton.\",\n      );\n    }\n    const skinnedMesh = foundSkinnedMeshes[0];\n    group.add(...foundSkinnedMeshes);\n    const sharedSkeleton = skinnedMesh.skeleton;\n    group.add(skinnedMesh.skeleton.bones[0]);\n    const sharedMatrixWorld = skinnedMesh.matrixWorld;\n\n    for (const loadingAsset of assets) {\n      const part = loadingAsset.part;\n      const rawGltf = loadingAsset.asset;\n\n      const modelGroup = rawGltf.group;\n      if (part.socket) {\n        const socketName = part.socket.socket;\n        let bone = availableBones.get(\"root\");\n        if (availableBones.has(socketName)) {\n          bone = availableBones.get(socketName);\n        } else {\n          console.warn(\n            `WARNING: no bone found for [${socketName}] socket. Attatching to Root bone`,\n          );\n        }\n        if (bone) {\n          bone.add(modelGroup);\n\n          modelGroup.position.set(\n            part.socket.position.x,\n            part.socket.position.y,\n            part.socket.position.z,\n          );\n\n          modelGroup.rotation.set(\n            MathUtils.degToRad(part.socket.rotation.x),\n            MathUtils.degToRad(part.socket.rotation.y),\n            MathUtils.degToRad(part.socket.rotation.z),\n          );\n\n          modelGroup.scale.set(part.socket.scale.x, part.socket.scale.y, part.socket.scale.z);\n        }\n      } else {\n        const skinnedMeshes: Array<SkinnedMesh> = [];\n        modelGroup.traverse((child) => {\n          const asSkinnedMesh = child as SkinnedMesh;\n          if (asSkinnedMesh.isSkinnedMesh) {\n            skinnedMeshes.push(asSkinnedMesh);\n          }\n        });\n        for (const skinnedMeshPart of skinnedMeshes) {\n          this.remapBoneIndices(skinnedMeshPart, sharedSkeleton);\n          skinnedMeshPart.castShadow = true;\n          skinnedMeshPart.receiveShadow = true;\n          skinnedMeshPart.bind(sharedSkeleton, sharedMatrixWorld!);\n          skinnedMeshPart.children = [];\n          group.add(skinnedMeshPart);\n        }\n      }\n    }\n    return group;\n  }\n}\n", "import { Group } from \"three\";\nimport * as SkeletonUtils from \"three/examples/jsm/utils/SkeletonUtils.js\";\n\nexport function cloneSkinnedMesh(model: Group) {\n  return SkeletonUtils.clone(model);\n}\n", "export type MMLCharacterDescriptionPart = {\n  url: string;\n  type?: string;\n  socket?: {\n    socket: string;\n    position: { x: number; y: number; z: number };\n    scale: { x: number; y: number; z: number };\n    rotation: { x: number; y: number; z: number };\n  };\n};\n\nexport type MMLCharacterDescription = {\n  base: MMLCharacterDescriptionPart;\n  parts: MMLCharacterDescriptionPart[];\n};\n\nexport type LoadingErrors = string[];\n\nexport const parseMMLDescription = (\n  mmlDescription: string,\n): [MMLCharacterDescription, LoadingErrors] => {\n  const parser: DOMParser = new DOMParser();\n  const doc = parser.parseFromString(mmlDescription, \"text/html\");\n\n  const tag = (count: number) => {\n    return count > 1 ? \"tags\" : \"tag\";\n  };\n\n  const errors: string[] = [];\n\n  const warn = (errorMessage: string) => {\n    errors.push(errorMessage);\n    console.warn(errorMessage);\n  };\n\n  const characters = Array.from(doc.body.children).filter(\n    (child) => child.tagName.toLowerCase() === \"m-character\",\n  );\n  const validCharacter = characters.shift();\n\n  if (characters.length > 0) {\n    const tagStr = tag(characters.length);\n    warn(\n      `ignoring ${characters.length} extra <m-character> ${tagStr} found in the root of the document (only the first one is valid).`,\n    );\n  }\n\n  const nestedCharacters = doc.querySelectorAll(\"body * m-character\");\n  if (nestedCharacters.length > 0) {\n    const tagStr = tag(nestedCharacters.length);\n    warn(\n      `ignoring ${nestedCharacters.length} nested <m-character> ${tagStr} found within other tags. A valid <m-character> tag must be at the root of the document.`,\n    );\n  }\n\n  const rootModels = Array.from(doc.body.children).filter(\n    (child) => child.tagName.toLowerCase() === \"m-model\",\n  );\n  if (rootModels.length > 0) {\n    const tagStr = tag(rootModels.length);\n    warn(\n      `ignoring ${rootModels.length} <m-model> ${tagStr} were found at the root of the document (<m-model> tags must be children of a valid <m-character> tag).`,\n    );\n  }\n\n  let base: MMLCharacterDescriptionPart = { url: \"\" };\n  let parts: MMLCharacterDescriptionPart[] = [];\n\n  if (validCharacter) {\n    const baseSrc = validCharacter.getAttribute(\"src\") ?? \"\";\n    base = { url: baseSrc };\n\n    const directModelChildren = Array.from(validCharacter.children).filter(\n      (child) => child.tagName.toLowerCase() === \"m-model\",\n    );\n    parts = directModelChildren.map((model) => {\n      const partSrc = model.getAttribute(\"src\") ?? \"\";\n\n      const socketAttr = model.getAttribute(\"socket\");\n      const position = {\n        x: parseFloat(model.getAttribute(\"x\") ?? \"0\") || 0,\n        y: parseFloat(model.getAttribute(\"y\") ?? \"0\") || 0,\n        z: parseFloat(model.getAttribute(\"z\") ?? \"0\") || 0,\n      };\n      const scale = {\n        x: parseFloat(model.getAttribute(\"sx\") ?? \"1\") || 1,\n        y: parseFloat(model.getAttribute(\"sy\") ?? \"1\") || 1,\n        z: parseFloat(model.getAttribute(\"sz\") ?? \"1\") || 1,\n      };\n      const rotation = {\n        x: parseFloat(model.getAttribute(\"rx\") ?? \"0\") || 0,\n        y: parseFloat(model.getAttribute(\"ry\") ?? \"0\") || 0,\n        z: parseFloat(model.getAttribute(\"rz\") ?? \"0\") || 0,\n      };\n\n      const socketObj = socketAttr ? { socket: socketAttr, position, scale, rotation } : undefined;\n\n      return { url: partSrc, socket: socketObj };\n    });\n\n    const wrappedModelTags = Array.from(doc.querySelectorAll(\"m-character m-model\")).filter(\n      (model) => !directModelChildren.includes(model),\n    );\n    if (wrappedModelTags.length > 0) {\n      const tagStr = tag(wrappedModelTags.length);\n      warn(\n        `ignoring ${wrappedModelTags.length} <m-model> ${tagStr} that were found wrapped inside tags other than a valid <m-character> tag.`,\n      );\n    }\n  } else {\n    warn(`No valid <m-character> tag was found in the provided document.`);\n  }\n\n  const characterDescription: MMLCharacterDescription = {\n    base: base,\n    parts: parts,\n  };\n\n  return [characterDescription, errors];\n};\n", "import { MMLCharacterDescription } from \"./parseMMLDescription\";\n\nexport const createMMLCharacterString = (characterDescription: MMLCharacterDescription): string => {\n  const base = characterDescription.base.url;\n\n  const partsTags = characterDescription.parts.map(\n    (part) => `<m-model src=\"${part.url}\"${part.type ? ` type=\"${part.type}\"` : \"\"}></m-model>`,\n  );\n\n  return `<m-character src=\"${base}\">\n  ${partsTags.join(\"\\n  \")}\n</m-character>`;\n};\n"],
+  "mappings": "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",
+  "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mml-io/3d-web-avatar",
-  "version": "0.15.0",
+  "version": "0.17.0",
   "publishConfig": {
     "access": "public"
   },
@@ -17,19 +17,20 @@
     "type-check": "tsc --noEmit",
     "lint": "eslint \"./{src,test}/**/*.{js,jsx,ts,tsx}\" --max-warnings 0",
     "lint-fix": "eslint \"./{src,test}/**/*.{js,jsx,ts,tsx}\" --fix",
-    "test": "jest"
+    "test": "NODE_OPTIONS=--experimental-vm-modules jest"
   },
   "dependencies": {
+    "@mml-io/model-loader": "0.15.0",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
-    "three": "0.153.0"
+    "three": "0.163.0"
   },
   "devDependencies": {
-    "@types/node": "^20.11.13",
-    "@types/react": "^18.2.48",
-    "@types/react-dom": "^18.2.18",
-    "@types/three": "0.153.0",
+    "@types/node": "^20.12.7",
+    "@types/react": "^18.2.79",
+    "@types/react-dom": "^18.2.25",
+    "@types/three": "0.163.0",
     "esbuild-css-modules-plugin": "3.1.0"
   },
-  "gitHead": "8e179c2269a7865766dcab19e6a8992aec44feaa"
+  "gitHead": "bc97b49ea69d920e0824a6885f7e8fca440e2e12"
 }

package/build/character/ModelLoader.d.ts

@@ -1,13 +0,0 @@
-import { GLTF } from "three/examples/jsm/loaders/GLTFLoader.js";
-export declare class ModelLoader {
-    private debug;
-    private static instance;
-    private readonly loadingManager;
-    private readonly gltfLoader;
-    private modelCache;
-    private ongoingLoads;
-    constructor(maxCacheSize?: number, debug?: boolean);
-    static getInstance(): ModelLoader;
-    load(fileUrl: string): Promise<GLTF | undefined>;
-    private loadFromUrl;
-}

package/build/helpers/SkeletonHelpers.d.ts

@@ -1,19 +0,0 @@
-import { Group, Matrix4, Object3D, Skeleton } from "three";
-import { GLTF } from "three/examples/jsm/loaders/GLTFLoader.js";
-type ClonedGLTFParts = {
-    gltf: GLTF;
-    sharedSkeleton: Skeleton;
-    matrixWorld: Matrix4;
-};
-export declare function cloneModel(model: Group): Object3D<import("three").Event>;
-export declare class SkeletonHelpers {
-    private debug;
-    private hierarchies;
-    private modelNames;
-    private extractBoneHierarchy;
-    private areBoneHierarchiesEqual;
-    extractAndStoreBoneHierarchy(node: Object3D, modelName: string): void;
-    compareLatestHierarchies(): void;
-    cloneGLTF(gltf: GLTF, modelName: string): ClonedGLTFParts;
-}
-export {};