loomlarge 0.1.0

package/dist/index.js

@@ -0,0 +1,1166 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/engines/three/AnimationThree.ts
+var easeInOutQuad = (t) => t < 0.5 ? 2 * t * t : -1 + (4 - 2 * t) * t;
+var AnimationThree = class {
+  constructor() {
+    __publicField(this, "transitions", /* @__PURE__ */ new Map());
+  }
+  /**
+   * Tick all active transitions by dt seconds.
+   * Applies eased interpolation and removes completed transitions.
+   * Respects individual transition pause state.
+   */
+  tick(dtSeconds) {
+    if (dtSeconds <= 0) return;
+    const completed = [];
+    this.transitions.forEach((t, key) => {
+      if (t.paused) return;
+      t.elapsed += dtSeconds;
+      const progress = Math.min(t.elapsed / t.duration, 1);
+      const easedProgress = t.easing(progress);
+      const value = t.from + (t.to - t.from) * easedProgress;
+      t.apply(value);
+      if (progress >= 1) {
+        completed.push(key);
+        t.resolve?.();
+      }
+    });
+    completed.forEach((key) => this.transitions.delete(key));
+  }
+  /**
+   * Add or replace a transition for the given key.
+   * If a transition with the same key exists, it is cancelled and replaced.
+   * @returns TransitionHandle with { promise, pause, resume, cancel }
+   */
+  addTransition(key, from, to, durationMs, apply, easing = easeInOutQuad) {
+    const durationSec = durationMs / 1e3;
+    const existing = this.transitions.get(key);
+    if (existing?.resolve) {
+      existing.resolve();
+    }
+    if (durationSec <= 0 || Math.abs(to - from) < 1e-6) {
+      apply(to);
+      return {
+        promise: Promise.resolve(),
+        pause: () => {
+        },
+        resume: () => {
+        },
+        cancel: () => {
+        }
+      };
+    }
+    const promise = new Promise((resolve) => {
+      const transitionObj = {
+        key,
+        from,
+        to,
+        duration: durationSec,
+        elapsed: 0,
+        apply,
+        easing,
+        resolve,
+        paused: false
+      };
+      this.transitions.set(key, transitionObj);
+    });
+    return {
+      promise,
+      pause: () => {
+        const t = this.transitions.get(key);
+        if (t) t.paused = true;
+      },
+      resume: () => {
+        const t = this.transitions.get(key);
+        if (t) t.paused = false;
+      },
+      cancel: () => {
+        const t = this.transitions.get(key);
+        if (t) {
+          t.resolve?.();
+          this.transitions.delete(key);
+        }
+      }
+    };
+  }
+  /** Clear all running transitions. */
+  clearTransitions() {
+    this.transitions.forEach((t) => t.resolve?.());
+    this.transitions.clear();
+  }
+  /** Get count of active transitions. */
+  getActiveTransitionCount() {
+    return this.transitions.size;
+  }
+};
+
+// src/presets/cc4.ts
+var AU_TO_MORPHS = {
+  // Brows / Forehead
+  1: ["Brow_Raise_Inner_L", "Brow_Raise_Inner_R"],
+  2: ["Brow_Raise_Outer_L", "Brow_Raise_Outer_R"],
+  4: ["Brow_Drop_L", "Brow_Drop_R"],
+  // Eyes / Lids
+  5: ["Eye_Wide_L", "Eye_Wide_R"],
+  6: ["Cheek_Raise_L", "Cheek_Raise_R"],
+  7: ["Eye_Squint_L", "Eye_Squint_R"],
+  43: ["Eye_Blink_L", "Eye_Blink_R"],
+  45: ["Eye_Blink_L", "Eye_Blink_R"],
+  // Blink alias
+  // Nose / Midface
+  9: ["Nose_Sneer_L", "Nose_Sneer_R"],
+  34: ["Cheek_Puff_L", "Cheek_Puff_R"],
+  // Mouth / Lips
+  8: ["Mouth_Press_L", "Mouth_Press_R", "Mouth_Close"],
+  10: ["Nose_Sneer_L", "Nose_Sneer_R"],
+  // Upper Lip Raiser (levator labii superioris) - raises upper lip in disgust/sneer
+  11: ["Mouth_Up_Upper_L", "Mouth_Up_Upper_R"],
+  // Nasolabial Deepener (zygomaticus minor) - no dedicated morph
+  12: ["Mouth_Smile_L", "Mouth_Smile_R"],
+  13: ["Mouth_Dimple_L", "Mouth_Dimple_R"],
+  // Sharp Lip Puller (levator anguli oris) - pulls lip corners up
+  14: ["Mouth_Press_L", "Mouth_Press_R"],
+  15: ["Mouth_Frown_L", "Mouth_Frown_R"],
+  16: ["Mouth_Down_Lower_L", "Mouth_Down_Lower_R"],
+  17: ["Mouth_Shrug_Lower"],
+  18: ["Mouth_Pucker"],
+  20: ["Mouth_Stretch_L", "Mouth_Stretch_R"],
+  22: ["Mouth_Funnel"],
+  23: ["Mouth_Press_L", "Mouth_Press_R"],
+  24: ["Mouth_Press_L", "Mouth_Press_R"],
+  25: ["Jaw_Open"],
+  // Lips Part - small jaw open with morph
+  26: ["Jaw_Open"],
+  // Jaw Drop - mixed: bone rotation + Jaw_Open morph
+  27: ["Jaw_Open"],
+  // Mouth Stretch - larger jaw open with morph
+  28: ["Mouth_Roll_In_Upper", "Mouth_Roll_In_Lower"],
+  32: ["Mouth_Roll_In_Lower"],
+  // Lip Bite - using roll in lower as approximation
+  // Tongue
+  19: ["Tongue_Out"],
+  36: ["Tongue_Bulge_L", "Tongue_Bulge_R"],
+  37: ["Tongue_Up"],
+  // Tongue Up - morph + bone rotation
+  38: ["Tongue_Down"],
+  // Tongue Down - morph + bone rotation
+  39: ["Tongue_L"],
+  // Tongue Left - morph + bone rotation
+  40: ["Tongue_R"],
+  // Tongue Right - morph + bone rotation
+  41: [],
+  // Tongue Tilt Left - BONE ONLY
+  42: [],
+  // Tongue Tilt Right - BONE ONLY
+  // Extended tongue morphs (CC4-specific)
+  73: ["Tongue_Narrow"],
+  74: ["Tongue_Wide"],
+  75: ["Tongue_Roll"],
+  76: ["Tongue_Tip_Up"],
+  77: ["Tongue_Tip_Down"],
+  // Jaw
+  29: ["Jaw_Forward"],
+  30: ["Jaw_L"],
+  // Jaw Left - mixed: bone rotation + Jaw_L morph
+  31: [],
+  // Jaw Clencher (masseter/temporalis) - no dedicated CC4 morph
+  35: ["Jaw_R"],
+  // Jaw Right - mixed: bone rotation + Jaw_R morph
+  // Head position (M51-M56 in FACS notation)
+  51: ["Head_Turn_L"],
+  // Head turn left
+  52: ["Head_Turn_R"],
+  // Head turn right
+  53: ["Head_Turn_Up"],
+  // Head up
+  54: ["Head_Turn_Down"],
+  55: ["Head_Tilt_L"],
+  56: ["Head_Tilt_R"],
+  // Eye Direction (convenience)
+  61: ["Eye_L_Look_L", "Eye_R_Look_L"],
+  62: ["Eye_L_Look_R", "Eye_R_Look_R"],
+  63: ["Eye_L_Look_Up", "Eye_R_Look_Up"],
+  64: ["Eye_L_Look_Down", "Eye_R_Look_Down"],
+  // Single-eye controls (Left eye)
+  65: ["Eye_L_Look_L"],
+  66: ["Eye_L_Look_R"],
+  67: ["Eye_L_Look_Up"],
+  68: ["Eye_L_Look_Down"],
+  // Single-eye controls (Right eye)
+  69: ["Eye_R_Look_L"],
+  70: ["Eye_R_Look_R"],
+  71: ["Eye_R_Look_Up"],
+  72: ["Eye_R_Look_Down"],
+  // Eye morphs (CC_Base_Eye meshes)
+  // EO morphs control the shadow/depth around the eyes
+  80: ["EO Bulge L", "EO Bulge R"],
+  81: ["EO Depth L", "EO Depth R"],
+  82: ["EO Inner Depth L", "EO Inner Depth R"],
+  83: ["EO Inner Height L", "EO Inner Height R"],
+  84: ["EO Inner Width L", "EO Inner Width R"],
+  85: ["EO Outer Depth L", "EO Outer Depth R"],
+  86: ["EO Outer Height L", "EO Outer Height R"],
+  87: ["EO Outer Width L", "EO Outer Width R"],
+  88: ["EO Upper Depth L", "EO Upper Depth R"],
+  89: ["EO Lower Depth L", "EO Lower Depth R"],
+  90: ["EO Center Upper Depth L", "EO Center Upper Depth R"],
+  91: ["EO Center Upper Height L", "EO Center Upper Height R"],
+  92: ["EO Center Lower Depth L", "EO Center Lower Depth R"],
+  93: ["EO Center Lower Height L", "EO Center Lower Height R"],
+  94: ["EO Inner Upper Depth L", "EO Inner Upper Depth R"],
+  95: ["EO Inner Upper Height L", "EO Inner Upper Height R"],
+  96: ["EO Inner Lower Depth L", "EO Inner Lower Depth R"],
+  97: ["EO Inner Lower Height L", "EO Inner Lower Height R"],
+  98: ["EO Outer Upper Depth L", "EO Outer Upper Depth R"],
+  99: ["EO Outer Upper Height L", "EO Outer Upper Height R"],
+  100: ["EO Outer Lower Depth L", "EO Outer Lower Depth R"],
+  101: ["EO Outer Lower Height L", "EO Outer Lower Height R"],
+  102: ["EO Duct Depth L", "EO Duct Depth R"]
+};
+var VISEME_KEYS = [
+  "EE",
+  "Er",
+  "IH",
+  "Ah",
+  "Oh",
+  "W_OO",
+  "S_Z",
+  "Ch_J",
+  "F_V",
+  "TH",
+  "T_L_D_N",
+  "B_M_P",
+  "K_G_H_NG",
+  "AE",
+  "R"
+];
+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 }
+    // Head turn left
+  ],
+  52: [
+    { node: "HEAD", channel: "ry", scale: -1, maxDegrees: 30 }
+    // Head turn right
+  ],
+  53: [
+    { node: "HEAD", channel: "rx", scale: -1, maxDegrees: 20 }
+    // Head up
+  ],
+  54: [
+    { node: "HEAD", channel: "rx", scale: 1, maxDegrees: 20 }
+    // Head down
+  ],
+  55: [
+    { node: "HEAD", channel: "rz", scale: -1, maxDegrees: 15 }
+    // Head tilt left
+  ],
+  56: [
+    { node: "HEAD", channel: "rz", scale: 1, maxDegrees: 15 }
+    // Head tilt right
+  ],
+  // Eyes horizontal (yaw) - CC4 rigs use rz for horizontal eye rotation
+  61: [
+    { node: "EYE_L", channel: "rz", scale: 1, maxDegrees: 32 },
+    // Eyes look left
+    { node: "EYE_R", channel: "rz", scale: 1, maxDegrees: 32 }
+  ],
+  62: [
+    { node: "EYE_L", channel: "rz", scale: -1, maxDegrees: 32 },
+    // Eyes look right
+    { node: "EYE_R", channel: "rz", scale: -1, maxDegrees: 32 }
+  ],
+  63: [
+    { node: "EYE_L", channel: "rx", scale: -1, maxDegrees: 32 },
+    { node: "EYE_R", channel: "rx", scale: -1, maxDegrees: 32 }
+  ],
+  64: [
+    { node: "EYE_L", channel: "rx", scale: 1, maxDegrees: 32 },
+    { node: "EYE_R", channel: "rx", scale: 1, maxDegrees: 32 }
+  ],
+  // 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 }],
+  // 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 }],
+  // 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)
+  ],
+  25: [
+    // Lips Part — small jaw open
+    { node: "JAW", channel: "rz", scale: 1, maxDegrees: 5.84 }
+    // 73% of 8
+  ],
+  26: [
+    { node: "JAW", channel: "rz", scale: 1, maxDegrees: 28 }
+    // 73% of 20
+  ],
+  27: [
+    // Mouth Stretch — larger jaw open
+    { node: "JAW", channel: "rz", scale: 1, maxDegrees: 32 }
+    // 73% of 25
+  ],
+  29: [
+    { node: "JAW", channel: "tz", scale: -1, maxUnits: 0.02 }
+    // Negative for forward thrust
+  ],
+  30: [
+    // Jaw Left
+    { node: "JAW", channel: "ry", scale: -1, maxDegrees: 5 }
+  ],
+  35: [
+    // Jaw Right
+    { node: "JAW", channel: "ry", scale: 1, maxDegrees: 5 }
+  ],
+  // Tongue
+  19: [
+    { node: "TONGUE", channel: "tz", scale: -1, maxUnits: 8e-3 }
+  ],
+  37: [
+    // Tongue Up
+    { node: "TONGUE", channel: "rz", scale: -1, maxDegrees: 45 }
+  ],
+  38: [
+    // Tongue Down
+    { node: "TONGUE", channel: "rz", scale: 1, maxDegrees: 45 }
+  ],
+  39: [
+    // Tongue Left
+    { node: "TONGUE", channel: "ry", scale: -1, maxDegrees: 10 }
+  ],
+  40: [
+    // Tongue Right
+    { node: "TONGUE", channel: "ry", scale: 1, maxDegrees: 10 }
+  ],
+  41: [
+    // Tongue Tilt Left
+    { node: "TONGUE", channel: "rx", scale: -1, maxDegrees: 20 }
+  ],
+  42: [
+    // Tongue Tilt Right
+    { node: "TONGUE", channel: "rx", scale: 1, maxDegrees: 20 }
+  ]
+};
+var CC4_BONE_NODES = {
+  EYE_L: "CC_Base_L_Eye",
+  EYE_R: "CC_Base_R_Eye",
+  HEAD: "CC_Base_Head",
+  NECK: "CC_Base_NeckTwist01",
+  NECK_TWIST: "CC_Base_NeckTwist02",
+  JAW: "CC_Base_JawRoot",
+  TONGUE: "CC_Base_Tongue01"
+};
+var CC4_EYE_MESH_NODES = {
+  LEFT: "CC_Base_Eye",
+  RIGHT: "CC_Base_Eye_1"
+};
+var AU_INFO = {
+  // Forehead / Brow (Upper)
+  "1": { id: "1", name: "Inner Brow Raiser", muscularBasis: "frontalis (pars medialis)", links: ["https://en.wikipedia.org/wiki/Frontalis_muscle"], faceArea: "Upper", facePart: "Forehead" },
+  "2": { id: "2", name: "Outer Brow Raiser", muscularBasis: "frontalis (pars lateralis)", links: ["https://en.wikipedia.org/wiki/Frontalis_muscle"], faceArea: "Upper", facePart: "Forehead" },
+  "4": { id: "4", name: "Brow Lowerer", muscularBasis: "corrugator/depressor supercilii", links: ["https://en.wikipedia.org/wiki/Corrugator_supercilii"], faceArea: "Upper", facePart: "Forehead" },
+  // Eyelids / Eyes (Upper)
+  "5": { id: "5", name: "Upper Lid Raiser", muscularBasis: "levator palpebrae superioris", links: ["https://en.wikipedia.org/wiki/Levator_palpebrae_superioris"], faceArea: "Upper", facePart: "Eyelids" },
+  "6": { id: "6", name: "Cheek Raiser", muscularBasis: "orbicularis oculi (pars orbitalis)", links: ["https://en.wikipedia.org/wiki/Orbicularis_oculi"], faceArea: "Upper", facePart: "Cheeks" },
+  "7": { id: "7", name: "Lid Tightener", muscularBasis: "orbicularis oculi (pars palpebralis)", links: ["https://en.wikipedia.org/wiki/Orbicularis_oculi"], faceArea: "Upper", facePart: "Eyelids" },
+  "43": { id: "43", name: "Eyes Closed", muscularBasis: "orbicularis oculi", links: ["https://en.wikipedia.org/wiki/Orbicularis_oculi_muscle"], faceArea: "Upper", facePart: "Eyelids" },
+  "45": { id: "45", name: "Blink", muscularBasis: "orbicularis oculi", links: ["https://en.wikipedia.org/wiki/Orbicularis_oculi_muscle"], faceArea: "Upper", facePart: "Eyelids" },
+  "61": { id: "61", name: "Eyes Turn Left", faceArea: "Upper", facePart: "Eyes" },
+  "62": { id: "62", name: "Eyes Turn Right", faceArea: "Upper", facePart: "Eyes" },
+  "63": { id: "63", name: "Eyes Up", faceArea: "Upper", facePart: "Eyes" },
+  "64": { id: "64", name: "Eyes Down", faceArea: "Upper", facePart: "Eyes" },
+  "65": { id: "65", name: "Left Eye Look Left", faceArea: "Upper", facePart: "Eyes" },
+  "66": { id: "66", name: "Left Eye Look Right", faceArea: "Upper", facePart: "Eyes" },
+  "67": { id: "67", name: "Left Eye Look Up", faceArea: "Upper", facePart: "Eyes" },
+  "68": { id: "68", name: "Left Eye Look Down", faceArea: "Upper", facePart: "Eyes" },
+  "69": { id: "69", name: "Right Eye Look Left", faceArea: "Upper", facePart: "Eyes" },
+  "70": { id: "70", name: "Right Eye Look Right", faceArea: "Upper", facePart: "Eyes" },
+  "71": { id: "71", name: "Right Eye Look Up", faceArea: "Upper", facePart: "Eyes" },
+  "72": { id: "72", name: "Right Eye Look Down", faceArea: "Upper", facePart: "Eyes" },
+  // Nose / Cheeks
+  "9": { id: "9", name: "Nose Wrinkler", muscularBasis: "levator labii superioris alaeque nasi", links: ["https://en.wikipedia.org/wiki/Levator_labii_superioris_alaeque_nasi"], faceArea: "Upper", facePart: "Nose" },
+  "34": { id: "34", name: "Cheek Puff", faceArea: "Lower", facePart: "Cheeks" },
+  // Mouth (Lower)
+  "8": { id: "8", name: "Lips Toward Each Other", muscularBasis: "orbicularis oris", links: ["https://en.wikipedia.org/wiki/Orbicularis_oris"], faceArea: "Lower", facePart: "Mouth" },
+  "10": { id: "10", name: "Upper Lip Raiser", muscularBasis: "levator labii superioris", links: ["https://en.wikipedia.org/wiki/Levator_labii_superioris"], faceArea: "Lower", facePart: "Mouth" },
+  "11": { id: "11", name: "Nasolabial Deepener", muscularBasis: "zygomaticus minor", links: ["https://en.wikipedia.org/wiki/Zygomaticus_minor"], faceArea: "Lower", facePart: "Cheeks" },
+  "12": { id: "12", name: "Lip Corner Puller", muscularBasis: "zygomaticus major", links: ["https://en.wikipedia.org/wiki/Zygomaticus_major"], faceArea: "Lower", facePart: "Mouth" },
+  "13": { id: "13", name: "Sharp Lip Puller", muscularBasis: "levator anguli oris", links: ["https://en.wikipedia.org/wiki/Levator_anguli_oris"], faceArea: "Lower", facePart: "Mouth" },
+  "14": { id: "14", name: "Dimpler", muscularBasis: "buccinator", links: ["https://en.wikipedia.org/wiki/Buccinator"], faceArea: "Lower", facePart: "Cheeks" },
+  "15": { id: "15", name: "Lip Corner Depressor", muscularBasis: "depressor anguli oris", links: ["https://en.wikipedia.org/wiki/Depressor_anguli_oris"], faceArea: "Lower", facePart: "Mouth" },
+  "16": { id: "16", name: "Lower Lip Depressor", muscularBasis: "depressor labii inferioris", links: ["https://en.wikipedia.org/wiki/Depressor_labii_inferioris"], faceArea: "Lower", facePart: "Mouth" },
+  "17": { id: "17", name: "Chin Raiser", muscularBasis: "mentalis", links: ["https://en.wikipedia.org/wiki/Mentalis"], faceArea: "Lower", facePart: "Chin" },
+  "18": { id: "18", name: "Lip Pucker", faceArea: "Lower", facePart: "Mouth" },
+  "20": { id: "20", name: "Lip Stretcher", muscularBasis: "risorius + platysma", links: ["https://en.wikipedia.org/wiki/Risorius", "https://en.wikipedia.org/wiki/Platysma"], faceArea: "Lower", facePart: "Mouth" },
+  "22": { id: "22", name: "Lip Funneler", muscularBasis: "orbicularis oris", links: ["https://en.wikipedia.org/wiki/Orbicularis_oris"], faceArea: "Lower", facePart: "Mouth" },
+  "23": { id: "23", name: "Lip Tightener", muscularBasis: "orbicularis oris", faceArea: "Lower", facePart: "Mouth" },
+  "24": { id: "24", name: "Lip Presser", muscularBasis: "orbicularis oris", faceArea: "Lower", facePart: "Mouth" },
+  "25": { id: "25", name: "Lips Part", faceArea: "Lower", facePart: "Mouth" },
+  "27": { id: "27", name: "Mouth Stretch", muscularBasis: "pterygoids + digastric", links: ["https://en.wikipedia.org/wiki/Pterygoid_bone", "https://en.wikipedia.org/wiki/Digastric_muscle"], faceArea: "Lower", facePart: "Mouth" },
+  "28": { id: "28", name: "Lip Suck", muscularBasis: "orbicularis oris", faceArea: "Lower", facePart: "Mouth" },
+  // Tongue (Lower)
+  "19": { id: "19", name: "Tongue Show", faceArea: "Lower", facePart: "Tongue" },
+  "36": { id: "36", name: "Tongue Bulge", faceArea: "Lower", facePart: "Tongue" },
+  "37": { id: "37", name: "Tongue Up", faceArea: "Lower", facePart: "Tongue" },
+  "38": { id: "38", name: "Tongue Down", faceArea: "Lower", facePart: "Tongue" },
+  "39": { id: "39", name: "Tongue Left", faceArea: "Lower", facePart: "Tongue" },
+  "40": { id: "40", name: "Tongue Right", faceArea: "Lower", facePart: "Tongue" },
+  "41": { id: "41", name: "Tongue Tilt Left", faceArea: "Lower", facePart: "Tongue" },
+  "42": { id: "42", name: "Tongue Tilt Right", faceArea: "Lower", facePart: "Tongue" },
+  // Extended tongue controls (CC4-specific morphs)
+  "73": { id: "73", name: "Tongue Narrow", faceArea: "Lower", facePart: "Tongue" },
+  "74": { id: "74", name: "Tongue Wide", faceArea: "Lower", facePart: "Tongue" },
+  "75": { id: "75", name: "Tongue Roll", faceArea: "Lower", facePart: "Tongue" },
+  "76": { id: "76", name: "Tongue Tip Up", faceArea: "Lower", facePart: "Tongue" },
+  "77": { id: "77", name: "Tongue Tip Down", faceArea: "Lower", facePart: "Tongue" },
+  // Jaw (Lower)
+  "26": { id: "26", name: "Jaw Drop", muscularBasis: "masseter (relax temporalis)", links: ["https://en.wikipedia.org/wiki/Masseter_muscle"], faceArea: "Lower", facePart: "Jaw" },
+  "29": { id: "29", name: "Jaw Thrust", faceArea: "Lower", facePart: "Jaw" },
+  "30": { id: "30", name: "Jaw Left", faceArea: "Lower", facePart: "Jaw" },
+  "31": { id: "31", name: "Jaw Clencher", muscularBasis: "masseter + temporalis", faceArea: "Lower", facePart: "Jaw" },
+  "32": { id: "32", name: "Lip Bite", muscularBasis: "orbicularis oris", faceArea: "Lower", facePart: "Mouth" },
+  "35": { id: "35", name: "Jaw Right", faceArea: "Lower", facePart: "Jaw" },
+  // Head position (M51-M56 in FACS notation)
+  "51": { id: "51", name: "Head Turn Left", faceArea: "Upper", facePart: "Head" },
+  "52": { id: "52", name: "Head Turn Right", faceArea: "Upper", facePart: "Head" },
+  "53": { id: "53", name: "Head Up", faceArea: "Upper", facePart: "Head" },
+  "54": { id: "54", name: "Head Down", faceArea: "Upper", facePart: "Head" },
+  "55": { id: "55", name: "Head Tilt Left", faceArea: "Upper", facePart: "Head" },
+  "56": { id: "56", name: "Head Tilt Right", faceArea: "Upper", facePart: "Head" },
+  // Eye (Upper) - EO morphs applied to CC_Base_Eye meshes
+  "80": { id: "80", name: "Eye Bulge", faceArea: "Upper", facePart: "Eye" },
+  "81": { id: "81", name: "Eye Depth", faceArea: "Upper", facePart: "Eye" },
+  "82": { id: "82", name: "Eye Inner Depth", faceArea: "Upper", facePart: "Eye" },
+  "83": { id: "83", name: "Eye Inner Height", faceArea: "Upper", facePart: "Eye" },
+  "84": { id: "84", name: "Eye Inner Width", faceArea: "Upper", facePart: "Eye" },
+  "85": { id: "85", name: "Eye Outer Depth", faceArea: "Upper", facePart: "Eye" },
+  "86": { id: "86", name: "Eye Outer Height", faceArea: "Upper", facePart: "Eye" },
+  "87": { id: "87", name: "Eye Outer Width", faceArea: "Upper", facePart: "Eye" },
+  "88": { id: "88", name: "Eye Upper Depth", faceArea: "Upper", facePart: "Eye" },
+  "89": { id: "89", name: "Eye Lower Depth", faceArea: "Upper", facePart: "Eye" },
+  "90": { id: "90", name: "Eye Center Upper Depth", faceArea: "Upper", facePart: "Eye" },
+  "91": { id: "91", name: "Eye Center Upper Height", faceArea: "Upper", facePart: "Eye" },
+  "92": { id: "92", name: "Eye Center Lower Depth", faceArea: "Upper", facePart: "Eye" },
+  "93": { id: "93", name: "Eye Center Lower Height", faceArea: "Upper", facePart: "Eye" },
+  "94": { id: "94", name: "Eye Inner Upper Depth", faceArea: "Upper", facePart: "Eye" },
+  "95": { id: "95", name: "Eye Inner Upper Height", faceArea: "Upper", facePart: "Eye" },
+  "96": { id: "96", name: "Eye Inner Lower Depth", faceArea: "Upper", facePart: "Eye" },
+  "97": { id: "97", name: "Eye Inner Lower Height", faceArea: "Upper", facePart: "Eye" },
+  "98": { id: "98", name: "Eye Outer Upper Depth", faceArea: "Upper", facePart: "Eye" },
+  "99": { id: "99", name: "Eye Outer Upper Height", faceArea: "Upper", facePart: "Eye" },
+  "100": { id: "100", name: "Eye Outer Lower Depth", faceArea: "Upper", facePart: "Eye" },
+  "101": { id: "101", name: "Eye Outer Lower Height", faceArea: "Upper", facePart: "Eye" },
+  "102": { id: "102", name: "Eye Duct Depth", faceArea: "Upper", facePart: "Eye" }
+};
+var AU_MIX_DEFAULTS = {
+  31: 0.7,
+  32: 0.7,
+  33: 0.7,
+  54: 0.7,
+  55: 0.7,
+  56: 0.7,
+  // head
+  61: 0.5,
+  62: 0.5,
+  63: 0.5,
+  64: 0.5,
+  // eyes
+  25: 0.5,
+  26: 0.5,
+  27: 0.5,
+  // jaw open (lips part, jaw drop, mouth stretch)
+  30: 0.5,
+  35: 0.5
+  // jaw left/right
+};
+var MORPH_TO_MESH = {
+  // Face/AU morphs affect the main face mesh and both eyebrow meshes.
+  face: ["CC_Base_Body_1", "Male_Bushy_1", "Male_Bushy_2"],
+  viseme: ["CC_Base_Body_1"],
+  eye: ["CC_Base_EyeOcclusion_1", "CC_Base_EyeOcclusion_2"],
+  tearLine: ["CC_Base_TearLine_1", "CC_Base_TearLine_2"],
+  tongue: ["CC_Base_Tongue"],
+  hair: ["Side_part_wavy_1", "Side_part_wavy_2"]
+};
+var CC4_PRESET = {
+  auToMorphs: AU_TO_MORPHS,
+  auToBones: BONE_AU_TO_BINDINGS,
+  boneNodes: CC4_BONE_NODES,
+  morphToMesh: MORPH_TO_MESH,
+  visemeKeys: VISEME_KEYS,
+  auMixDefaults: AU_MIX_DEFAULTS,
+  auInfo: AU_INFO,
+  eyeMeshNodes: CC4_EYE_MESH_NODES
+};
+
+// src/engines/three/LoomLargeThree.ts
+var deg2rad = (d) => d * Math.PI / 180;
+function clamp01(x) {
+  return x < 0 ? 0 : x > 1 ? 1 : x;
+}
+var _LoomLargeThree = class _LoomLargeThree {
+  constructor(config = {}, animation) {
+    // Configuration
+    __publicField(this, "config");
+    // Animation system (injectable)
+    __publicField(this, "animation");
+    // State
+    __publicField(this, "auValues", {});
+    __publicField(this, "rigReady", false);
+    __publicField(this, "missingBoneWarnings", /* @__PURE__ */ new Set());
+    // Rotation state
+    __publicField(this, "rotations", {});
+    __publicField(this, "pendingCompositeNodes", /* @__PURE__ */ new Set());
+    __publicField(this, "isPaused", false);
+    __publicField(this, "translations", {});
+    // Mesh references
+    __publicField(this, "faceMesh", null);
+    __publicField(this, "meshes", []);
+    __publicField(this, "model", null);
+    __publicField(this, "meshByName", /* @__PURE__ */ new Map());
+    __publicField(this, "morphCache", /* @__PURE__ */ new Map());
+    // Bones
+    __publicField(this, "bones", {});
+    __publicField(this, "mixWeights", {});
+    // Viseme state
+    __publicField(this, "visemeValues", new Array(15).fill(0));
+    this.config = config.auMappings || CC4_PRESET;
+    this.mixWeights = { ...this.config.auMixDefaults };
+    this.animation = animation || new AnimationThree();
+  }
+  // ============================================================================
+  // PUBLIC API
+  // ============================================================================
+  onReady(payload) {
+    const { meshes, model } = payload;
+    this.meshes = meshes;
+    this.model = model;
+    this.meshByName.clear();
+    this.morphCache.clear();
+    model.traverse((obj) => {
+      if (obj.isMesh && obj.name) {
+        const infl = obj.morphTargetInfluences;
+        if (Array.isArray(infl) && infl.length > 0) {
+          this.meshByName.set(obj.name, obj);
+        }
+      }
+    });
+    const faceMeshNames = this.config.morphToMesh?.face || [];
+    const defaultFace = meshes.find((m) => faceMeshNames.includes(m.name));
+    if (defaultFace) {
+      this.faceMesh = defaultFace;
+    } else {
+      const candidate = meshes.find((m) => {
+        const dict = m.morphTargetDictionary;
+        return dict && typeof dict === "object" && "Brow_Drop_L" in dict;
+      });
+      this.faceMesh = candidate || null;
+    }
+    this.bones = this.resolveBones(model);
+    this.rigReady = true;
+    this.missingBoneWarnings.clear();
+    this.initBoneRotations();
+  }
+  update(deltaSeconds) {
+    const dtSeconds = Math.max(0, deltaSeconds || 0);
+    if (dtSeconds <= 0 || this.isPaused) return;
+    this.animation.tick(dtSeconds);
+    this.flushPendingComposites();
+  }
+  dispose() {
+    this.clearTransitions();
+    this.meshes = [];
+    this.model = null;
+    this.bones = {};
+  }
+  // ============================================================================
+  // AU CONTROL
+  // ============================================================================
+  setAU(id, v, balance) {
+    if (typeof id === "string") {
+      const match = id.match(/^(\d+)([LR])$/i);
+      if (match) {
+        const au = Number(match[1]);
+        const side = match[2].toUpperCase();
+        const sideBalance = side === "L" ? -1 : 1;
+        this.setAU(au, v, sideBalance);
+        return;
+      }
+      const n = Number(id);
+      if (!Number.isNaN(n)) {
+        this.setAU(n, v, balance);
+      }
+      return;
+    }
+    this.auValues[id] = v;
+    const keys = this.config.auToMorphs[id] || [];
+    if (keys.length) {
+      const mixWeight = this.isMixedAU(id) ? this.getAUMixWeight(id) : 1;
+      const base = clamp01(v) * mixWeight;
+      const meshNames = this.getMeshNamesForAU(id);
+      const leftKeys = keys.filter((k) => /(_L$| L$|Left$)/i.test(k));
+      const rightKeys = keys.filter((k) => /(_R$| R$|Right$)/i.test(k));
+      const centerKeys = keys.filter((k) => !/(_L$| L$|Left$|_R$| R$|Right$)/i.test(k));
+      const { left: leftVal, right: rightVal } = this.computeSideValues(base, balance);
+      if (leftKeys.length || rightKeys.length) {
+        for (const k of leftKeys) this.setMorph(k, leftVal, meshNames);
+        for (const k of rightKeys) this.setMorph(k, rightVal, meshNames);
+      } else {
+        centerKeys.push(...keys);
+      }
+      for (const k of centerKeys) {
+        this.setMorph(k, base, meshNames);
+      }
+    }
+    const bindings = this.config.auToBones[id];
+    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);
+        } 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);
+          }
+        }
+      }
+    }
+  }
+  transitionAU(id, to, durationMs = 200, balance) {
+    const numId = typeof id === "string" ? Number(id.replace(/[^\d]/g, "")) : id;
+    const target = clamp01(to);
+    const morphKeys = this.config.auToMorphs[numId] || [];
+    const bindings = this.config.auToBones[numId] || [];
+    const mixWeight = this.isMixedAU(numId) ? this.getAUMixWeight(numId) : 1;
+    const base = target * mixWeight;
+    const { left: leftVal, right: rightVal } = this.computeSideValues(base, balance);
+    this.auValues[numId] = target;
+    const handles = [];
+    const meshNames = this.getMeshNamesForAU(numId);
+    const leftKeys = morphKeys.filter((k) => /(_L$|Left$)/.test(k));
+    const rightKeys = morphKeys.filter((k) => /(_R$|Right$)/.test(k));
+    const centerKeys = morphKeys.filter((k) => !/(_L$|Left$|_R$|Right$)/.test(k));
+    if (leftKeys.length || rightKeys.length) {
+      for (const k of leftKeys) {
+        handles.push(this.transitionMorph(k, leftVal, durationMs, meshNames));
+      }
+      for (const k of rightKeys) {
+        handles.push(this.transitionMorph(k, rightVal, durationMs, meshNames));
+      }
+    } else {
+      centerKeys.push(...morphKeys);
+    }
+    for (const k of centerKeys) {
+      handles.push(this.transitionMorph(k, base, durationMs, meshNames));
+    }
+    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));
+      } 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));
+        }
+      }
+    }
+    return this.combineHandles(handles);
+  }
+  getAU(id) {
+    return this.auValues[id] ?? 0;
+  }
+  // ============================================================================
+  // MORPH CONTROL
+  // ============================================================================
+  setMorph(key, v, meshNames) {
+    const val = clamp01(v);
+    const targetMeshes = meshNames || this.config.morphToMesh?.face || [];
+    const cached = this.morphCache.get(key);
+    if (cached) {
+      for (const target of cached) {
+        target.infl[target.idx] = val;
+      }
+      return;
+    }
+    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 });
+          infl[idx] = val;
+        }
+      }
+    } 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 });
+          infl[idx] = val;
+        }
+      }
+    }
+    if (targets.length > 0) {
+      this.morphCache.set(key, 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));
+  }
+  // ============================================================================
+  // VISEME CONTROL
+  // ============================================================================
+  setViseme(visemeIndex, value, jawScale = 1) {
+    if (visemeIndex < 0 || visemeIndex >= this.config.visemeKeys.length) return;
+    const val = clamp01(value);
+    this.visemeValues[visemeIndex] = val;
+    const morphKey = this.config.visemeKeys[visemeIndex];
+    this.setMorph(morphKey, val);
+    const jawAmount = _LoomLargeThree.VISEME_JAW_AMOUNTS[visemeIndex] * val * jawScale;
+    if (Math.abs(jawScale) > 1e-6 && Math.abs(jawAmount) > 1e-6) {
+      this.updateBoneRotation("JAW", "roll", jawAmount, _LoomLargeThree.JAW_MAX_DEGREES);
+    }
+  }
+  transitionViseme(visemeIndex, to, durationMs = 80, jawScale = 1) {
+    if (visemeIndex < 0 || visemeIndex >= this.config.visemeKeys.length) {
+      return { promise: Promise.resolve(), pause: () => {
+      }, resume: () => {
+      }, cancel: () => {
+      } };
+    }
+    const morphKey = this.config.visemeKeys[visemeIndex];
+    const target = clamp01(to);
+    this.visemeValues[visemeIndex] = target;
+    const morphHandle = this.transitionMorph(morphKey, target, durationMs);
+    const jawAmount = _LoomLargeThree.VISEME_JAW_AMOUNTS[visemeIndex] * target * jawScale;
+    if (Math.abs(jawScale) <= 1e-6 || Math.abs(jawAmount) <= 1e-6) {
+      return morphHandle;
+    }
+    const jawHandle = this.transitionBoneRotation("JAW", "roll", jawAmount, _LoomLargeThree.JAW_MAX_DEGREES, durationMs);
+    return this.combineHandles([morphHandle, jawHandle]);
+  }
+  // ============================================================================
+  // MIX WEIGHT CONTROL
+  // ============================================================================
+  setAUMixWeight(id, weight) {
+    this.mixWeights[id] = clamp01(weight);
+    const v = this.auValues[id] ?? 0;
+    if (v > 0) this.setAU(id, v);
+    const boneBindings = this.config.auToBones[id];
+    if (boneBindings) {
+      for (const binding of boneBindings) {
+        this.pendingCompositeNodes.add(binding.node);
+      }
+    }
+  }
+  getAUMixWeight(id) {
+    return this.mixWeights[id] ?? this.config.auMixDefaults?.[id] ?? 1;
+  }
+  // ============================================================================
+  // PLAYBACK CONTROL
+  // ============================================================================
+  pause() {
+    this.isPaused = true;
+  }
+  resume() {
+    this.isPaused = false;
+  }
+  getPaused() {
+    return this.isPaused;
+  }
+  clearTransitions() {
+    this.animation.clearTransitions();
+  }
+  getActiveTransitionCount() {
+    return this.animation.getActiveTransitionCount();
+  }
+  resetToNeutral() {
+    this.auValues = {};
+    this.initBoneRotations();
+    this.clearTransitions();
+    for (const m of this.meshes) {
+      const infl = m.morphTargetInfluences;
+      if (!infl) continue;
+      for (let i = 0; i < infl.length; i++) {
+        infl[i] = 0;
+      }
+    }
+    Object.values(this.bones).forEach((entry) => {
+      if (!entry) return;
+      entry.obj.position.copy(entry.basePos);
+      entry.obj.quaternion.copy(entry.baseQuat);
+    });
+  }
+  // ============================================================================
+  // MESH CONTROL
+  // ============================================================================
+  getMeshList() {
+    if (!this.model) return [];
+    const result = [];
+    this.model.traverse((obj) => {
+      if (obj.isMesh) {
+        result.push({
+          name: obj.name,
+          visible: obj.visible,
+          morphCount: obj.morphTargetInfluences?.length || 0
+        });
+      }
+    });
+    return result;
+  }
+  setMeshVisible(meshName, visible) {
+    if (!this.model) return;
+    this.model.traverse((obj) => {
+      if (obj.isMesh && obj.name === meshName) {
+        obj.visible = visible;
+      }
+    });
+  }
+  // ============================================================================
+  // CONFIGURATION
+  // ============================================================================
+  setAUMappings(mappings) {
+    this.config = mappings;
+    this.mixWeights = { ...mappings.auMixDefaults };
+  }
+  getAUMappings() {
+    return this.config;
+  }
+  // ============================================================================
+  // PRIVATE METHODS
+  // ============================================================================
+  computeSideValues(base, balance) {
+    const b = Math.max(-1, Math.min(1, balance ?? 0));
+    if (b === 0) return { left: base, right: base };
+    if (b < 0) return { left: base, right: base * (1 + b) };
+    return { left: base * (1 - b), right: base };
+  }
+  getMeshNamesForAU(auId) {
+    const info = this.config.auInfo?.[String(auId)];
+    if (!info?.facePart) return this.config.morphToMesh?.face || [];
+    switch (info.facePart) {
+      case "Tongue":
+        return this.config.morphToMesh?.tongue || [];
+      case "Eye":
+        return this.config.morphToMesh?.eye || [];
+      default:
+        return this.config.morphToMesh?.face || [];
+    }
+  }
+  getMorphValue(key) {
+    if (this.faceMesh) {
+      const dict = this.faceMesh.morphTargetDictionary;
+      const infl = this.faceMesh.morphTargetInfluences;
+      if (dict && infl) {
+        const idx = dict[key];
+        if (idx !== void 0) return infl[idx] ?? 0;
+      }
+      return 0;
+    }
+    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) return infl[idx] ?? 0;
+    }
+    return 0;
+  }
+  isMixedAU(id) {
+    return !!(this.config.auToMorphs[id]?.length && this.config.auToBones[id]?.length);
+  }
+  initBoneRotations() {
+    const zeroAxis = { value: 0, maxRadians: 0 };
+    this.rotations = {};
+    this.pendingCompositeNodes.clear();
+    const allBoneKeys = Array.from(
+      new Set(Object.values(this.config.auToBones).flat().map((binding) => binding.node))
+    );
+    for (const node of allBoneKeys) {
+      this.rotations[node] = { pitch: { ...zeroAxis }, yaw: { ...zeroAxis }, roll: { ...zeroAxis } };
+      this.pendingCompositeNodes.add(node);
+    }
+  }
+  updateBoneRotation(nodeKey, axis, value, maxDegrees) {
+    if (!this.rotations[nodeKey]) return;
+    this.rotations[nodeKey][axis] = { value: Math.max(-1, Math.min(1, value)), maxRadians: deg2rad(maxDegrees) };
+    this.pendingCompositeNodes.add(nodeKey);
+  }
+  updateBoneTranslation(nodeKey, channel, value, maxUnits) {
+    if (!this.translations[nodeKey]) this.translations[nodeKey] = { x: 0, y: 0, z: 0 };
+    const clamped = Math.max(-1, Math.min(1, value));
+    const offset = clamped * maxUnits;
+    if (channel === "tx") this.translations[nodeKey].x = offset;
+    else if (channel === "ty") this.translations[nodeKey].y = offset;
+    else this.translations[nodeKey].z = offset;
+    this.pendingCompositeNodes.add(nodeKey);
+  }
+  transitionBoneRotation(nodeKey, axis, to, maxDegrees, durationMs = 200) {
+    const transitionKey = `bone_${nodeKey}_${axis}`;
+    const from = this.rotations[nodeKey]?.[axis]?.value ?? 0;
+    const target = Math.max(-1, Math.min(1, to));
+    return this.animation.addTransition(transitionKey, from, target, durationMs, (value) => this.updateBoneRotation(nodeKey, axis, value, maxDegrees));
+  }
+  transitionBoneTranslation(nodeKey, channel, to, maxUnits, durationMs = 200) {
+    const transitionKey = `boneT_${nodeKey}_${channel}`;
+    const current = this.translations[nodeKey] || { x: 0, y: 0, z: 0 };
+    const currentOffset = channel === "tx" ? current.x : channel === "ty" ? current.y : current.z;
+    const from = maxUnits !== 0 ? Math.max(-1, Math.min(1, currentOffset / maxUnits)) : 0;
+    const target = Math.max(-1, Math.min(1, to));
+    return this.animation.addTransition(transitionKey, from, target, durationMs, (value) => this.updateBoneTranslation(nodeKey, channel, value, maxUnits));
+  }
+  flushPendingComposites() {
+    if (this.pendingCompositeNodes.size === 0) return;
+    for (const nodeKey of this.pendingCompositeNodes) {
+      this.applyCompositeRotation(nodeKey);
+    }
+    this.pendingCompositeNodes.clear();
+  }
+  applyCompositeRotation(nodeKey) {
+    const entry = this.bones[nodeKey];
+    if (!entry || !this.model) {
+      if (!entry && this.rigReady && !this.missingBoneWarnings.has(nodeKey)) {
+        this.missingBoneWarnings.add(nodeKey);
+      }
+      return;
+    }
+    const { obj, basePos, baseEuler } = entry;
+    const rotState = this.rotations[nodeKey];
+    if (!rotState) return;
+    const yawRad = rotState.yaw.maxRadians * rotState.yaw.value;
+    const pitchRad = rotState.pitch.maxRadians * rotState.pitch.value;
+    const rollRad = rotState.roll.maxRadians * rotState.roll.value;
+    obj.position.copy(basePos);
+    const t = this.translations[nodeKey];
+    if (t) {
+      obj.position.x += t.x;
+      obj.position.y += t.y;
+      obj.position.z += t.z;
+    }
+    obj.rotation.set(baseEuler.x + pitchRad, baseEuler.y + yawRad, baseEuler.z + rollRad, baseEuler.order);
+    obj.updateMatrixWorld(false);
+    this.model.updateMatrixWorld(true);
+  }
+  resolveBones(root) {
+    const resolved = {};
+    const snapshot = (obj) => ({
+      obj,
+      basePos: { x: obj.position.x, y: obj.position.y, z: obj.position.z },
+      baseQuat: obj.quaternion.clone(),
+      baseEuler: { x: obj.rotation.x, y: obj.rotation.y, z: obj.rotation.z, order: obj.rotation.order }
+    });
+    const findNode = (name) => {
+      if (!name) return void 0;
+      return root.getObjectByName(name);
+    };
+    for (const [key, nodeName] of Object.entries(this.config.boneNodes)) {
+      const node = findNode(nodeName);
+      if (node) resolved[key] = snapshot(node);
+    }
+    if (!resolved.EYE_L && this.config.eyeMeshNodes) {
+      const node = findNode(this.config.eyeMeshNodes.LEFT);
+      if (node) resolved.EYE_L = snapshot(node);
+    }
+    if (!resolved.EYE_R && this.config.eyeMeshNodes) {
+      const node = findNode(this.config.eyeMeshNodes.RIGHT);
+      if (node) resolved.EYE_R = snapshot(node);
+    }
+    return resolved;
+  }
+  combineHandles(handles) {
+    if (handles.length === 0) return { promise: Promise.resolve(), pause: () => {
+    }, resume: () => {
+    }, cancel: () => {
+    } };
+    if (handles.length === 1) return handles[0];
+    return {
+      promise: Promise.all(handles.map((h) => h.promise)).then(() => {
+      }),
+      pause: () => handles.forEach((h) => h.pause()),
+      resume: () => handles.forEach((h) => h.resume()),
+      cancel: () => handles.forEach((h) => h.cancel())
+    };
+  }
+};
+// Viseme jaw amounts
+__publicField(_LoomLargeThree, "VISEME_JAW_AMOUNTS", [
+  0.15,
+  0.35,
+  0.25,
+  0.7,
+  0.55,
+  0.3,
+  0.1,
+  0.2,
+  0.08,
+  0.12,
+  0.18,
+  0.02,
+  0.25,
+  0.6,
+  0.4
+]);
+__publicField(_LoomLargeThree, "JAW_MAX_DEGREES", 28);
+var LoomLargeThree = _LoomLargeThree;
+function collectMorphMeshes(root) {
+  const meshes = [];
+  root.traverse((obj) => {
+    if (obj.isMesh) {
+      if (Array.isArray(obj.morphTargetInfluences) && obj.morphTargetInfluences.length > 0) {
+        meshes.push(obj);
+      }
+    }
+  });
+  return meshes;
+}
+
+// src/physics/HairPhysics.ts
+var DEFAULT_HAIR_PHYSICS_CONFIG = {
+  mass: 1,
+  stiffness: 15,
+  damping: 0.8,
+  gravity: 9.8,
+  headInfluence: 0.5,
+  windEnabled: false,
+  windStrength: 0,
+  windDirectionX: 1,
+  windDirectionZ: 0,
+  windTurbulence: 0.2,
+  windFrequency: 0.5
+};
+var HairPhysics = class {
+  constructor(config = {}) {
+    __publicField(this, "config");
+    __publicField(this, "state");
+    __publicField(this, "time", 0);
+    // Previous head state for velocity calculation
+    __publicField(this, "prevHeadYaw", 0);
+    __publicField(this, "prevHeadPitch", 0);
+    this.config = { ...DEFAULT_HAIR_PHYSICS_CONFIG, ...config };
+    this.state = { x: 0, z: 0, vx: 0, vz: 0 };
+  }
+  /**
+   * Update physics simulation
+   * @param dt Delta time in seconds
+   * @param headState Current head orientation and velocity
+   * @returns Morph values to apply to hair meshes
+   */
+  update(dt, headState) {
+    if (dt <= 0 || dt > 0.1) {
+      return this.computeMorphOutput();
+    }
+    this.time += dt;
+    const { mass, stiffness, damping, gravity, headInfluence, windEnabled } = this.config;
+    const headYawVel = headState.yawVelocity !== 0 ? headState.yawVelocity : (headState.yaw - this.prevHeadYaw) / dt;
+    const headPitchVel = headState.pitchVelocity !== 0 ? headState.pitchVelocity : (headState.pitch - this.prevHeadPitch) / dt;
+    this.prevHeadYaw = headState.yaw;
+    this.prevHeadPitch = headState.pitch;
+    const springFx = -stiffness * this.state.x;
+    const springFz = -stiffness * this.state.z;
+    const dampFx = -damping * this.state.vx;
+    const dampFz = -damping * this.state.vz;
+    const gravityFz = gravity * Math.sin(headState.pitch) * 0.1;
+    const inertiaFx = -headYawVel * headInfluence * mass * 2;
+    const inertiaFz = -headPitchVel * headInfluence * mass * 2;
+    let windFx = 0;
+    let windFz = 0;
+    if (windEnabled && this.config.windStrength > 0) {
+      const { windStrength, windDirectionX, windDirectionZ, windTurbulence, windFrequency } = this.config;
+      const windPhase = this.time * windFrequency * Math.PI * 2;
+      const windOscillation = Math.sin(windPhase);
+      const turbulencePhase = this.time * windFrequency * 3.7;
+      const turbulence = Math.sin(turbulencePhase) * windTurbulence;
+      windFx = windStrength * windDirectionX * (0.5 + 0.5 * windOscillation) + turbulence * -windDirectionZ;
+      windFz = windStrength * windDirectionZ * (0.5 + 0.5 * windOscillation) + turbulence * windDirectionX;
+    }
+    const totalFx = springFx + dampFx + inertiaFx + windFx;
+    const totalFz = springFz + dampFz + gravityFz + inertiaFz + windFz;
+    const ax = totalFx / mass;
+    const az = totalFz / mass;
+    this.state.vx += ax * dt;
+    this.state.vz += az * dt;
+    const maxVel = 10;
+    this.state.vx = Math.max(-maxVel, Math.min(maxVel, this.state.vx));
+    this.state.vz = Math.max(-maxVel, Math.min(maxVel, this.state.vz));
+    this.state.x += this.state.vx * dt;
+    this.state.z += this.state.vz * dt;
+    this.state.x = Math.max(-1, Math.min(1, this.state.x));
+    this.state.z = Math.max(-1, Math.min(1, this.state.z));
+    return this.computeMorphOutput();
+  }
+  /**
+   * Convert physics state to morph target values
+   * Maps pendulum position to left/right/front morphs for both sides
+   */
+  computeMorphOutput() {
+    const { x, z } = this.state;
+    const L_Hair_Left = Math.max(0, -x);
+    const L_Hair_Right = Math.max(0, x);
+    const L_Hair_Front = Math.max(0, z);
+    const R_Hair_Left = Math.max(0, -x);
+    const R_Hair_Right = Math.max(0, x);
+    const R_Hair_Front = Math.max(0, z);
+    return {
+      L_Hair_Left,
+      L_Hair_Right,
+      L_Hair_Front,
+      R_Hair_Left,
+      R_Hair_Right,
+      R_Hair_Front
+    };
+  }
+  /**
+   * Get current physics state (for debugging/UI)
+   */
+  getState() {
+    return { ...this.state };
+  }
+  /**
+   * Update configuration
+   */
+  setConfig(config) {
+    this.config = { ...this.config, ...config };
+  }
+  /**
+   * Get current configuration
+   */
+  getConfig() {
+    return { ...this.config };
+  }
+  /**
+   * Reset physics state to rest position
+   */
+  reset() {
+    this.state = { x: 0, z: 0, vx: 0, vz: 0 };
+    this.time = 0;
+    this.prevHeadYaw = 0;
+    this.prevHeadPitch = 0;
+  }
+};
+
+export { AnimationThree, CC4_PRESET, DEFAULT_HAIR_PHYSICS_CONFIG, HairPhysics, LoomLargeThree, collectMorphMeshes, LoomLargeThree as default };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map