loomlarge 0.1.4 → 0.2.0

package/dist/index.cjs

@@ -2,6 +2,8 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
+var three = require('three');
+
 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);
@@ -358,6 +360,107 @@ var BONE_AU_TO_BINDINGS = {
     { node: "TONGUE", channel: "rx", scale: 1, maxDegrees: 20 }
   ]
 };
+var isMixedAU = (id) => !!(AU_TO_MORPHS[id]?.length && BONE_AU_TO_BINDINGS[id]?.length);
+var hasLeftRightMorphs = (auId) => {
+  const keys = AU_TO_MORPHS[auId] || [];
+  return keys.some((k) => /_L$|_R$| L$| R$|Left$|Right$/i.test(k));
+};
+var COMPOSITE_ROTATIONS = [
+  {
+    node: "JAW",
+    pitch: { aus: [25, 26, 27], axis: "rz" },
+    // Jaw drop (opens mouth downward)
+    yaw: { aus: [30, 35], axis: "ry", negative: 30, positive: 35 },
+    // Jaw lateral (left/right)
+    roll: null
+    // Jaw doesn't have roll
+  },
+  {
+    node: "HEAD",
+    pitch: { aus: [54, 53], axis: "rx", negative: 54, positive: 53 },
+    // Head down/up
+    yaw: { aus: [51, 52], axis: "ry", negative: 51, positive: 52 },
+    // Head turn left/right
+    roll: { aus: [55, 56], axis: "rz", negative: 55, positive: 56 }
+    // Head tilt left/right
+  },
+  {
+    node: "EYE_L",
+    pitch: { aus: [64, 63], axis: "rx", negative: 64, positive: 63 },
+    // Eyes down/up
+    yaw: { aus: [61, 62], axis: "rz", negative: 61, positive: 62 },
+    // Eyes left/right (rz for CC4)
+    roll: null
+    // Eyes don't have roll
+  },
+  {
+    node: "EYE_R",
+    pitch: { aus: [64, 63], axis: "rx", negative: 64, positive: 63 },
+    // Eyes down/up
+    yaw: { aus: [61, 62], axis: "rz", negative: 61, positive: 62 },
+    // Eyes left/right (rz for CC4)
+    roll: null
+    // Eyes don't have roll
+  },
+  {
+    node: "TONGUE",
+    pitch: { aus: [38, 37], axis: "rz", negative: 38, positive: 37 },
+    // Tongue down/up
+    yaw: { aus: [39, 40], axis: "ry", negative: 39, positive: 40 },
+    // Tongue left/right
+    roll: { aus: [41, 42], axis: "rx", negative: 41, positive: 42 }
+    // Tongue tilt left/right
+  }
+];
+var CONTINUUM_PAIRS_MAP = {
+  // Eyes horizontal (yaw) - both eyes share same AUs
+  61: { pairId: 62, isNegative: true, axis: "yaw", node: "EYE_L" },
+  62: { pairId: 61, isNegative: false, axis: "yaw", node: "EYE_L" },
+  // Eyes vertical (pitch)
+  64: { pairId: 63, isNegative: true, axis: "pitch", node: "EYE_L" },
+  63: { pairId: 64, isNegative: false, axis: "pitch", node: "EYE_L" },
+  // Head yaw (turn left/right)
+  51: { pairId: 52, isNegative: true, axis: "yaw", node: "HEAD" },
+  52: { pairId: 51, isNegative: false, axis: "yaw", node: "HEAD" },
+  // Head pitch (up/down)
+  54: { pairId: 53, isNegative: true, axis: "pitch", node: "HEAD" },
+  53: { pairId: 54, isNegative: false, axis: "pitch", node: "HEAD" },
+  // Head roll (tilt left/right)
+  55: { pairId: 56, isNegative: true, axis: "roll", node: "HEAD" },
+  56: { pairId: 55, isNegative: false, axis: "roll", node: "HEAD" },
+  // Jaw yaw (left/right)
+  30: { pairId: 35, isNegative: true, axis: "yaw", node: "JAW" },
+  35: { pairId: 30, isNegative: false, axis: "yaw", node: "JAW" },
+  // Tongue yaw (left/right)
+  39: { pairId: 40, isNegative: true, axis: "yaw", node: "TONGUE" },
+  40: { pairId: 39, isNegative: false, axis: "yaw", node: "TONGUE" },
+  // Tongue pitch (up/down)
+  38: { pairId: 37, isNegative: true, axis: "pitch", node: "TONGUE" },
+  37: { pairId: 38, isNegative: false, axis: "pitch", node: "TONGUE" },
+  // Tongue roll (tilt left/right)
+  41: { pairId: 42, isNegative: true, axis: "roll", node: "TONGUE" },
+  42: { pairId: 41, isNegative: false, axis: "roll", node: "TONGUE" },
+  // Extended tongue morphs (continuum pairs)
+  73: { pairId: 74, isNegative: true, axis: "yaw", node: "TONGUE" },
+  // Tongue Narrow/Wide
+  74: { pairId: 73, isNegative: false, axis: "yaw", node: "TONGUE" },
+  76: { pairId: 77, isNegative: false, axis: "pitch", node: "TONGUE" },
+  // Tongue Tip Up/Down
+  77: { pairId: 76, isNegative: true, axis: "pitch", node: "TONGUE" }
+};
+var CONTINUUM_LABELS = {
+  "61-62": "Eyes \u2014 Horizontal",
+  "64-63": "Eyes \u2014 Vertical",
+  "51-52": "Head \u2014 Horizontal",
+  "54-53": "Head \u2014 Vertical",
+  "55-56": "Head \u2014 Tilt",
+  "30-35": "Jaw \u2014 Horizontal",
+  "38-37": "Tongue \u2014 Vertical",
+  "39-40": "Tongue \u2014 Horizontal",
+  "41-42": "Tongue \u2014 Tilt",
+  "73-74": "Tongue \u2014 Width",
+  "76-77": "Tongue Tip \u2014 Vertical"
+};
 var CC4_BONE_NODES = {
   EYE_L: "CC_Base_L_Eye",
   EYE_R: "CC_Base_R_Eye",
@@ -490,6 +593,41 @@ var AU_MIX_DEFAULTS = {
   35: 0.5
   // jaw left/right
 };
+var CC4_MESHES = {
+  // Body (6 meshes, 80 morphs each) - default render order 0
+  "CC_Base_Body_1": { category: "body", morphCount: 80 },
+  "CC_Base_Body_2": { category: "body", morphCount: 80 },
+  "CC_Base_Body_3": { category: "body", morphCount: 80 },
+  "CC_Base_Body_4": { category: "body", morphCount: 80 },
+  "CC_Base_Body_5": { category: "body", morphCount: 80 },
+  "CC_Base_Body_6": { category: "body", morphCount: 80 },
+  // Eyes (bone-driven, no morphs) - render first (behind everything)
+  "CC_Base_Eye": { category: "eye", morphCount: 0, material: { renderOrder: -10 } },
+  "CC_Base_Eye_1": { category: "eye", morphCount: 0, material: { renderOrder: -10 } },
+  "CC_Base_Eye_2": { category: "eye", morphCount: 0, material: { renderOrder: -10 } },
+  "CC_Base_Eye_3": { category: "eye", morphCount: 0, material: { renderOrder: -10 } },
+  "CC_Base_Eye_4": { category: "eye", morphCount: 0, material: { renderOrder: -10 } },
+  // Eye occlusion (94 morphs each) - render on top of eyes with transparency support
+  "CC_Base_EyeOcclusion_1": { category: "eyeOcclusion", morphCount: 94, material: { renderOrder: 2, transparent: true, opacity: 1, depthWrite: true, depthTest: true, blending: "Normal" } },
+  "CC_Base_EyeOcclusion_2": { category: "eyeOcclusion", morphCount: 94, material: { renderOrder: 2, transparent: true, opacity: 1, depthWrite: true, depthTest: true, blending: "Normal" } },
+  // Tear lines (90 morphs each) - on top of eyes/face
+  "CC_Base_TearLine_1": { category: "tearLine", morphCount: 90, material: { renderOrder: 2 } },
+  "CC_Base_TearLine_2": { category: "tearLine", morphCount: 90, material: { renderOrder: 2 } },
+  // Cornea (no morphs) - render first with eyes
+  "CC_Base_Cornea": { category: "cornea", morphCount: 0, material: { renderOrder: -10 } },
+  "CC_Base_Cornea_1": { category: "cornea", morphCount: 0, material: { renderOrder: -10 } },
+  // Teeth (no morphs, follow jaw bone) - default render order
+  "CC_Base_Teeth_1": { category: "teeth", morphCount: 0 },
+  "CC_Base_Teeth_2": { category: "teeth", morphCount: 0 },
+  // Tongue (23 morphs) - default render order
+  "CC_Base_Tongue": { category: "tongue", morphCount: 23 },
+  // Eyebrows (91 morphs each) - above face
+  "Male_Bushy_1": { category: "eyebrow", morphCount: 91, material: { renderOrder: 5 } },
+  "Male_Bushy_2": { category: "eyebrow", morphCount: 91, material: { renderOrder: 5 } },
+  // Hair (14 styling morphs each) - render last (on top of everything)
+  "Side_part_wavy_1": { category: "hair", morphCount: 14, material: { renderOrder: 10 } },
+  "Side_part_wavy_2": { category: "hair", morphCount: 14, material: { renderOrder: 10 } }
+};
 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"],
@@ -541,6 +679,10 @@ var _LoomLargeThree = class _LoomLargeThree {
     __publicField(this, "mixWeights", {});
     // Viseme state
     __publicField(this, "visemeValues", new Array(15).fill(0));
+    // Internal RAF loop
+    __publicField(this, "clock", new three.Clock());
+    __publicField(this, "rafId", null);
+    __publicField(this, "running", false);
     this.config = config.auMappings || CC4_PRESET;
     this.mixWeights = { ...this.config.auMixDefaults };
     this.animation = animation || new AnimationThree();
@@ -577,6 +719,7 @@ var _LoomLargeThree = class _LoomLargeThree {
     this.rigReady = true;
     this.missingBoneWarnings.clear();
     this.initBoneRotations();
+    this.applyMeshMaterialSettings(model);
   }
   update(deltaSeconds) {
     const dtSeconds = Math.max(0, deltaSeconds || 0);
@@ -584,7 +727,30 @@ var _LoomLargeThree = class _LoomLargeThree {
     this.animation.tick(dtSeconds);
     this.flushPendingComposites();
   }
+  /** Start the internal RAF loop */
+  start() {
+    if (this.running) return;
+    this.running = true;
+    this.clock.start();
+    const tick = () => {
+      if (!this.running) return;
+      const dt = this.clock.getDelta();
+      this.update(dt);
+      this.rafId = requestAnimationFrame(tick);
+    };
+    this.rafId = requestAnimationFrame(tick);
+  }
+  /** Stop the internal RAF loop */
+  stop() {
+    this.running = false;
+    if (this.rafId !== null) {
+      cancelAnimationFrame(this.rafId);
+      this.rafId = null;
+    }
+    this.clock.stop();
+  }
   dispose() {
+    this.stop();
     this.clearTransitions();
     this.meshes = [];
     this.model = null;
@@ -1008,6 +1174,35 @@ var _LoomLargeThree = class _LoomLargeThree {
       cancel: () => handles.forEach((h) => h.cancel())
     };
   }
+  /**
+   * Apply render order and material settings from CC4_MESHES to all meshes.
+   * This ensures proper layering (e.g., hair renders on top of eyebrows).
+   */
+  applyMeshMaterialSettings(root) {
+    root.traverse((obj) => {
+      if (!obj.isMesh || !obj.name) return;
+      const meshInfo = CC4_MESHES[obj.name];
+      if (!meshInfo?.material) return;
+      const settings = meshInfo.material;
+      if (typeof settings.renderOrder === "number") {
+        obj.renderOrder = settings.renderOrder;
+      }
+      if (obj.material) {
+        if (typeof settings.transparent === "boolean") {
+          obj.material.transparent = settings.transparent;
+        }
+        if (typeof settings.opacity === "number") {
+          obj.material.opacity = settings.opacity;
+        }
+        if (typeof settings.depthWrite === "boolean") {
+          obj.material.depthWrite = settings.depthWrite;
+        }
+        if (typeof settings.depthTest === "boolean") {
+          obj.material.depthTest = settings.depthTest;
+        }
+      }
+    });
+  }
 };
 // Viseme jaw amounts
 __publicField(_LoomLargeThree, "VISEME_JAW_AMOUNTS", [
@@ -1165,12 +1360,26 @@ var HairPhysics = class {
   }
 };
 
+exports.AU_INFO = AU_INFO;
+exports.AU_MIX_DEFAULTS = AU_MIX_DEFAULTS;
+exports.AU_TO_MORPHS = AU_TO_MORPHS;
 exports.AnimationThree = AnimationThree;
+exports.BONE_AU_TO_BINDINGS = BONE_AU_TO_BINDINGS;
+exports.CC4_BONE_NODES = CC4_BONE_NODES;
+exports.CC4_EYE_MESH_NODES = CC4_EYE_MESH_NODES;
+exports.CC4_MESHES = CC4_MESHES;
 exports.CC4_PRESET = CC4_PRESET;
+exports.COMPOSITE_ROTATIONS = COMPOSITE_ROTATIONS;
+exports.CONTINUUM_LABELS = CONTINUUM_LABELS;
+exports.CONTINUUM_PAIRS_MAP = CONTINUUM_PAIRS_MAP;
 exports.DEFAULT_HAIR_PHYSICS_CONFIG = DEFAULT_HAIR_PHYSICS_CONFIG;
 exports.HairPhysics = HairPhysics;
 exports.LoomLargeThree = LoomLargeThree;
+exports.MORPH_TO_MESH = MORPH_TO_MESH;
+exports.VISEME_KEYS = VISEME_KEYS;
 exports.collectMorphMeshes = collectMorphMeshes;
 exports.default = LoomLargeThree;
+exports.hasLeftRightMorphs = hasLeftRightMorphs;
+exports.isMixedAU = isMixedAU;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map