loomlarge 0.2.1 → 1.0.1

package/dist/index.js

@@ -241,119 +241,121 @@ var VISEME_KEYS = [
 ];
 var BONE_AU_TO_BINDINGS = {
   // Head turn and tilt (M51-M56) - use HEAD bone only (NECK should not rotate with head)
-  // Three.js Y rotation: positive = counter-clockwise from above = head turns LEFT (character POV)
   51: [
-    { node: "HEAD", channel: "ry", scale: 1, maxDegrees: 30 }
+    { node: "HEAD", channel: "ry", scale: 1, maxDegrees: 30, axis: "yaw" }
     // Head turn left
   ],
   52: [
-    { node: "HEAD", channel: "ry", scale: -1, maxDegrees: 30 }
+    { node: "HEAD", channel: "ry", scale: -1, maxDegrees: 30, axis: "yaw" }
     // Head turn right
   ],
   53: [
-    { node: "HEAD", channel: "rx", scale: -1, maxDegrees: 20 }
+    { node: "HEAD", channel: "rx", scale: -1, maxDegrees: 20, axis: "pitch" }
     // Head up
   ],
   54: [
-    { node: "HEAD", channel: "rx", scale: 1, maxDegrees: 20 }
+    { node: "HEAD", channel: "rx", scale: 1, maxDegrees: 20, axis: "pitch" }
     // Head down
   ],
   55: [
-    { node: "HEAD", channel: "rz", scale: -1, maxDegrees: 15 }
+    { node: "HEAD", channel: "rz", scale: -1, maxDegrees: 15, axis: "roll" }
     // Head tilt left
   ],
   56: [
-    { node: "HEAD", channel: "rz", scale: 1, maxDegrees: 15 }
+    { node: "HEAD", channel: "rz", scale: 1, maxDegrees: 15, axis: "roll" }
     // Head tilt right
   ],
   // Eyes horizontal (yaw) - CC4 rigs use rz for horizontal eye rotation
   61: [
-    { node: "EYE_L", channel: "rz", scale: 1, maxDegrees: 32 },
+    { node: "EYE_L", channel: "rz", scale: 1, maxDegrees: 32, axis: "yaw" },
     // Eyes look left
-    { node: "EYE_R", channel: "rz", scale: 1, maxDegrees: 32 }
+    { node: "EYE_R", channel: "rz", scale: 1, maxDegrees: 32, axis: "yaw" }
   ],
   62: [
-    { node: "EYE_L", channel: "rz", scale: -1, maxDegrees: 32 },
+    { node: "EYE_L", channel: "rz", scale: -1, maxDegrees: 32, axis: "yaw" },
     // Eyes look right
-    { node: "EYE_R", channel: "rz", scale: -1, maxDegrees: 32 }
+    { node: "EYE_R", channel: "rz", scale: -1, maxDegrees: 32, axis: "yaw" }
   ],
   63: [
-    { node: "EYE_L", channel: "rx", scale: -1, maxDegrees: 32 },
-    { node: "EYE_R", channel: "rx", scale: -1, maxDegrees: 32 }
+    { node: "EYE_L", channel: "rx", scale: -1, maxDegrees: 32, axis: "pitch" },
+    // Eyes Up
+    { node: "EYE_R", channel: "rx", scale: -1, maxDegrees: 32, axis: "pitch" }
   ],
   64: [
-    { node: "EYE_L", channel: "rx", scale: 1, maxDegrees: 32 },
-    { node: "EYE_R", channel: "rx", scale: 1, maxDegrees: 32 }
+    { node: "EYE_L", channel: "rx", scale: 1, maxDegrees: 32, axis: "pitch" },
+    // Eyes Down
+    { node: "EYE_R", channel: "rx", scale: 1, maxDegrees: 32, axis: "pitch" }
   ],
   // Single-eye (Left) — horizontal (rz for CC4) and vertical (rx)
-  65: [{ node: "EYE_L", channel: "rz", scale: -1, maxDegrees: 15 }],
-  66: [{ node: "EYE_L", channel: "rz", scale: 1, maxDegrees: 15 }],
-  67: [{ node: "EYE_L", channel: "rx", scale: -1, maxDegrees: 12 }],
-  68: [{ node: "EYE_L", channel: "rx", scale: 1, maxDegrees: 12 }],
+  65: [{ node: "EYE_L", channel: "rz", scale: -1, maxDegrees: 15, axis: "yaw" }],
+  66: [{ node: "EYE_L", channel: "rz", scale: 1, maxDegrees: 15, axis: "yaw" }],
+  67: [{ node: "EYE_L", channel: "rx", scale: -1, maxDegrees: 12, axis: "pitch" }],
+  // Left Eye Up
+  68: [{ node: "EYE_L", channel: "rx", scale: 1, maxDegrees: 12, axis: "pitch" }],
+  // Left Eye Down
   // Single-eye (Right) — horizontal (rz for CC4) and vertical (rx)
-  69: [{ node: "EYE_R", channel: "rz", scale: -1, maxDegrees: 15 }],
-  70: [{ node: "EYE_R", channel: "rz", scale: 1, maxDegrees: 15 }],
-  71: [{ node: "EYE_R", channel: "rx", scale: -1, maxDegrees: 12 }],
-  72: [{ node: "EYE_R", channel: "rx", scale: 1, maxDegrees: 12 }],
+  69: [{ node: "EYE_R", channel: "rz", scale: -1, maxDegrees: 15, axis: "yaw" }],
+  70: [{ node: "EYE_R", channel: "rz", scale: 1, maxDegrees: 15, axis: "yaw" }],
+  71: [{ node: "EYE_R", channel: "rx", scale: -1, maxDegrees: 12, axis: "pitch" }],
+  // Right Eye Up
+  72: [{ node: "EYE_R", channel: "rx", scale: 1, maxDegrees: 12, axis: "pitch" }],
+  // Right Eye Down
   // Jaw / Mouth
   8: [
     // Lips Toward Each Other - slight jaw open helps sell the lip press
-    { node: "JAW", channel: "rz", scale: 1, maxDegrees: 8 }
-    // Small downward rotation (jaw opening slightly)
+    { node: "JAW", channel: "rz", scale: 1, maxDegrees: 8, axis: "roll" }
   ],
   25: [
     // Lips Part — small jaw open
-    { node: "JAW", channel: "rz", scale: 1, maxDegrees: 5.84 }
-    // 73% of 8
+    { node: "JAW", channel: "rz", scale: 1, maxDegrees: 5.84, axis: "roll" }
   ],
   26: [
-    { node: "JAW", channel: "rz", scale: 1, maxDegrees: 28 }
-    // 73% of 20
+    { node: "JAW", channel: "rz", scale: 1, maxDegrees: 28, axis: "roll" }
   ],
   27: [
     // Mouth Stretch — larger jaw open
-    { node: "JAW", channel: "rz", scale: 1, maxDegrees: 32 }
-    // 73% of 25
+    { node: "JAW", channel: "rz", scale: 1, maxDegrees: 32, axis: "roll" }
   ],
   29: [
     { node: "JAW", channel: "tz", scale: -1, maxUnits: 0.02 }
-    // Negative for forward thrust
+    // Translation - no axis needed
   ],
   30: [
     // Jaw Left
-    { node: "JAW", channel: "ry", scale: -1, maxDegrees: 5 }
+    { node: "JAW", channel: "ry", scale: -1, maxDegrees: 5, axis: "yaw" }
   ],
   35: [
     // Jaw Right
-    { node: "JAW", channel: "ry", scale: 1, maxDegrees: 5 }
+    { node: "JAW", channel: "ry", scale: 1, maxDegrees: 5, axis: "yaw" }
   ],
   // Tongue
   19: [
     { node: "TONGUE", channel: "tz", scale: -1, maxUnits: 8e-3 }
+    // Translation - no axis needed
   ],
   37: [
     // Tongue Up
-    { node: "TONGUE", channel: "rz", scale: -1, maxDegrees: 45 }
+    { node: "TONGUE", channel: "rz", scale: -1, maxDegrees: 45, axis: "pitch" }
   ],
   38: [
     // Tongue Down
-    { node: "TONGUE", channel: "rz", scale: 1, maxDegrees: 45 }
+    { node: "TONGUE", channel: "rz", scale: 1, maxDegrees: 45, axis: "pitch" }
   ],
   39: [
     // Tongue Left
-    { node: "TONGUE", channel: "ry", scale: -1, maxDegrees: 10 }
+    { node: "TONGUE", channel: "ry", scale: -1, maxDegrees: 10, axis: "yaw" }
   ],
   40: [
     // Tongue Right
-    { node: "TONGUE", channel: "ry", scale: 1, maxDegrees: 10 }
+    { node: "TONGUE", channel: "ry", scale: 1, maxDegrees: 10, axis: "yaw" }
   ],
   41: [
     // Tongue Tilt Left
-    { node: "TONGUE", channel: "rx", scale: -1, maxDegrees: 20 }
+    { node: "TONGUE", channel: "rx", scale: -1, maxDegrees: 20, axis: "roll" }
   ],
   42: [
     // Tongue Tilt Right
-    { node: "TONGUE", channel: "rx", scale: 1, maxDegrees: 20 }
+    { node: "TONGUE", channel: "rx", scale: 1, maxDegrees: 20, axis: "roll" }
   ]
 };
 var isMixedAU = (id) => !!(AU_TO_MORPHS[id]?.length && BONE_AU_TO_BINDINGS[id]?.length);
@@ -795,8 +797,9 @@ var _LoomLargeThree = class _LoomLargeThree {
     if (bindings) {
       for (const binding of bindings) {
         if (binding.channel === "rx" || binding.channel === "ry" || binding.channel === "rz") {
-          const axis = binding.channel === "rx" ? "pitch" : binding.channel === "ry" ? "yaw" : "roll";
-          this.updateBoneRotation(binding.node, axis, v * binding.scale, binding.maxDegrees ?? 0);
+          if (binding.axis) {
+            this.updateBoneRotation(binding.node, binding.axis, v * binding.scale, binding.maxDegrees ?? 0);
+          }
         } else if (binding.channel === "tx" || binding.channel === "ty" || binding.channel === "tz") {
           if (binding.maxUnits !== void 0) {
             this.updateBoneTranslation(binding.node, binding.channel, v * binding.scale, binding.maxUnits);
@@ -834,8 +837,9 @@ var _LoomLargeThree = class _LoomLargeThree {
     }
     for (const binding of bindings) {
       if (binding.channel === "rx" || binding.channel === "ry" || binding.channel === "rz") {
-        const axis = binding.channel === "rx" ? "pitch" : binding.channel === "ry" ? "yaw" : "roll";
-        handles.push(this.transitionBoneRotation(binding.node, axis, target * binding.scale, binding.maxDegrees ?? 0, durationMs));
+        if (binding.axis) {
+          handles.push(this.transitionBoneRotation(binding.node, binding.axis, target * binding.scale, binding.maxDegrees ?? 0, durationMs));
+        }
       } else if (binding.channel === "tx" || binding.channel === "ty" || binding.channel === "tz") {
         if (binding.maxUnits !== void 0) {
           handles.push(this.transitionBoneTranslation(binding.node, binding.channel, target * binding.scale, binding.maxUnits, durationMs));
@@ -847,11 +851,16 @@ var _LoomLargeThree = class _LoomLargeThree {
   getAU(id) {
     return this.auValues[id] ?? 0;
   }
-  // ============================================================================
-  // MORPH CONTROL
-  // ============================================================================
-  setMorph(key, v, meshNames) {
+  setMorph(key, v, meshNamesOrTargets) {
     const val = clamp01(v);
+    if (Array.isArray(meshNamesOrTargets) && meshNamesOrTargets.length > 0 && typeof meshNamesOrTargets[0] === "object" && "infl" in meshNamesOrTargets[0]) {
+      const targets2 = meshNamesOrTargets;
+      for (const target of targets2) {
+        target.infl[target.idx] = val;
+      }
+      return;
+    }
+    const meshNames = meshNamesOrTargets;
     const targetMeshes = meshNames || this.config.morphToMesh?.face || [];
     const cached = this.morphCache.get(key);
     if (cached) {
@@ -890,11 +899,54 @@ var _LoomLargeThree = class _LoomLargeThree {
       this.morphCache.set(key, targets);
     }
   }
+  /**
+   * Resolve morph key to direct targets for ultra-fast repeated access.
+   * Use this when you need to set the same morph many times (e.g., in animation loops).
+   */
+  resolveMorphTargets(key, meshNames) {
+    const cached = this.morphCache.get(key);
+    if (cached) return cached;
+    const targetMeshes = meshNames || this.config.morphToMesh?.face || [];
+    const targets = [];
+    if (targetMeshes.length) {
+      for (const name of targetMeshes) {
+        const mesh = this.meshByName.get(name);
+        if (!mesh) continue;
+        const dict = mesh.morphTargetDictionary;
+        const infl = mesh.morphTargetInfluences;
+        if (!dict || !infl) continue;
+        const idx = dict[key];
+        if (idx !== void 0) {
+          targets.push({ infl, idx });
+        }
+      }
+    } else {
+      for (const mesh of this.meshes) {
+        const dict = mesh.morphTargetDictionary;
+        const infl = mesh.morphTargetInfluences;
+        if (!dict || !infl) continue;
+        const idx = dict[key];
+        if (idx !== void 0) {
+          targets.push({ infl, idx });
+        }
+      }
+    }
+    if (targets.length > 0) {
+      this.morphCache.set(key, targets);
+    }
+    return targets;
+  }
   transitionMorph(key, to, durationMs = 120, meshNames) {
     const transitionKey = `morph_${key}`;
     const from = this.getMorphValue(key);
     const target = clamp01(to);
-    return this.animation.addTransition(transitionKey, from, target, durationMs, (value) => this.setMorph(key, value, meshNames));
+    const targets = this.resolveMorphTargets(key, meshNames);
+    return this.animation.addTransition(transitionKey, from, target, durationMs, (value) => {
+      const val = clamp01(value);
+      for (const t of targets) {
+        t.infl[t.idx] = val;
+      }
+    });
   }
   // ============================================================================
   // VISEME CONTROL
@@ -997,6 +1049,33 @@ var _LoomLargeThree = class _LoomLargeThree {
     });
     return result;
   }
+  /** Get all morph targets grouped by mesh name */
+  getMorphTargets() {
+    const result = {};
+    for (const mesh of this.meshes) {
+      const dict = mesh.morphTargetDictionary;
+      if (dict) {
+        result[mesh.name] = Object.keys(dict).sort();
+      }
+    }
+    return result;
+  }
+  /** Get all resolved bone names and their current transforms */
+  getBones() {
+    const result = {};
+    for (const name of Object.keys(this.bones)) {
+      const entry = this.bones[name];
+      if (entry) {
+        const pos = entry.obj.position;
+        const rot = entry.obj.rotation;
+        result[name] = {
+          position: [pos.x, pos.y, pos.z],
+          rotation: [rot.x * 180 / Math.PI, rot.y * 180 / Math.PI, rot.z * 180 / Math.PI]
+        };
+      }
+    }
+    return result;
+  }
   setMeshVisible(meshName, visible) {
     if (!this.model) return;
     this.model.traverse((obj) => {
@@ -1005,6 +1084,70 @@ var _LoomLargeThree = class _LoomLargeThree {
       }
     });
   }
+  /** Get material config for a mesh */
+  getMeshMaterialConfig(meshName) {
+    if (!this.model) return null;
+    let result = null;
+    this.model.traverse((obj) => {
+      if (obj.isMesh && obj.name === meshName) {
+        const mat = obj.material;
+        if (mat) {
+          let blendingName = "Normal";
+          for (const [name, value] of Object.entries(_LoomLargeThree.BLENDING_MODES)) {
+            if (mat.blending === value) {
+              blendingName = name;
+              break;
+            }
+          }
+          result = {
+            renderOrder: obj.renderOrder,
+            transparent: mat.transparent,
+            opacity: mat.opacity,
+            depthWrite: mat.depthWrite,
+            depthTest: mat.depthTest,
+            blending: blendingName
+          };
+        }
+      }
+    });
+    return result;
+  }
+  /** Set material config for a mesh */
+  setMeshMaterialConfig(meshName, config) {
+    if (!this.model) return;
+    this.model.traverse((obj) => {
+      if (obj.isMesh && obj.name === meshName) {
+        const mat = obj.material;
+        if (config.renderOrder !== void 0) {
+          obj.renderOrder = config.renderOrder;
+        }
+        if (mat) {
+          if (config.opacity !== void 0) {
+            mat.opacity = config.opacity;
+            if (config.opacity < 1 && config.transparent === void 0) {
+              mat.transparent = true;
+            }
+          }
+          if (config.transparent !== void 0) {
+            mat.transparent = config.transparent;
+          }
+          if (config.depthWrite !== void 0) {
+            mat.depthWrite = config.depthWrite;
+          }
+          if (config.depthTest !== void 0) {
+            mat.depthTest = config.depthTest;
+          }
+          if (config.blending !== void 0) {
+            const blendValue = _LoomLargeThree.BLENDING_MODES[config.blending];
+            if (blendValue !== void 0) {
+              mat.blending = blendValue;
+            }
+          }
+          mat.needsUpdate = true;
+        }
+      }
+    });
+  }
   // ============================================================================
   // CONFIGURATION
   // ============================================================================
@@ -1196,6 +1339,13 @@ var _LoomLargeThree = class _LoomLargeThree {
         if (typeof settings.depthTest === "boolean") {
           obj.material.depthTest = settings.depthTest;
         }
+        if (typeof settings.blending === "string") {
+          const blendValue = _LoomLargeThree.BLENDING_MODES[settings.blending];
+          if (blendValue !== void 0) {
+            obj.material.blending = blendValue;
+          }
+        }
+        obj.material.needsUpdate = true;
       }
     });
   }
@@ -1219,6 +1369,19 @@ __publicField(_LoomLargeThree, "VISEME_JAW_AMOUNTS", [
   0.4
 ]);
 __publicField(_LoomLargeThree, "JAW_MAX_DEGREES", 28);
+/** Blending mode options for Three.js materials */
+__publicField(_LoomLargeThree, "BLENDING_MODES", {
+  "Normal": 1,
+  // THREE.NormalBlending
+  "Additive": 2,
+  // THREE.AdditiveBlending
+  "Subtractive": 3,
+  // THREE.SubtractiveBlending
+  "Multiply": 4,
+  // THREE.MultiplyBlending
+  "None": 0
+  // THREE.NoBlending
+});
 var LoomLargeThree = _LoomLargeThree;
 function collectMorphMeshes(root) {
   const meshes = [];
@@ -1232,6 +1395,20 @@ function collectMorphMeshes(root) {
   return meshes;
 }
 
+// src/mappings/types.ts
+var BLENDING_MODES = {
+  "Normal": 1,
+  // THREE.NormalBlending
+  "Additive": 2,
+  // THREE.AdditiveBlending
+  "Subtractive": 3,
+  // THREE.SubtractiveBlending
+  "Multiply": 4,
+  // THREE.MultiplyBlending
+  "None": 0
+  // THREE.NoBlending
+};
+
 // src/physics/HairPhysics.ts
 var DEFAULT_HAIR_PHYSICS_CONFIG = {
   mass: 1,
@@ -1356,6 +1533,6 @@ var HairPhysics = class {
   }
 };
 
-export { AU_INFO, AU_MIX_DEFAULTS, AU_TO_MORPHS, AnimationThree, BONE_AU_TO_BINDINGS, CC4_BONE_NODES, CC4_EYE_MESH_NODES, CC4_MESHES, CC4_PRESET, COMPOSITE_ROTATIONS, CONTINUUM_LABELS, CONTINUUM_PAIRS_MAP, DEFAULT_HAIR_PHYSICS_CONFIG, HairPhysics, LoomLargeThree, MORPH_TO_MESH, VISEME_KEYS, collectMorphMeshes, LoomLargeThree as default, hasLeftRightMorphs, isMixedAU };
+export { AU_INFO, AU_MIX_DEFAULTS, AU_TO_MORPHS, AnimationThree, BLENDING_MODES, BONE_AU_TO_BINDINGS, CC4_BONE_NODES, CC4_EYE_MESH_NODES, CC4_MESHES, CC4_PRESET, COMPOSITE_ROTATIONS, CONTINUUM_LABELS, CONTINUUM_PAIRS_MAP, DEFAULT_HAIR_PHYSICS_CONFIG, HairPhysics, LoomLargeThree, MORPH_TO_MESH, VISEME_KEYS, collectMorphMeshes, LoomLargeThree as default, hasLeftRightMorphs, isMixedAU };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map