@lovelace_lol/loom3 1.0.0 → 1.0.2

package/dist/index.d.cts

@@ -519,6 +519,12 @@ interface ClipOptions {
     mixerWeight?: number;
     /** Left/right balance for bilateral AUs (-1 to 1, default: 0) */
     balance?: number;
+    /**
+     * Per-curve left/right balance overrides keyed by curve id (typically AU ids as strings).
+     * Example: { "43": 1, "12": 0.7 }.
+     * Falls back to `balance` when a curve id is not present.
+     */
+    balanceMap?: Record<string, number>;
     /** Jaw scale for viseme playback (default: 1.0) */
     jawScale?: number;
     /** Intensity scale multiplier (default: 1.0) */

package/dist/index.d.ts

@@ -519,6 +519,12 @@ interface ClipOptions {
     mixerWeight?: number;
     /** Left/right balance for bilateral AUs (-1 to 1, default: 0) */
     balance?: number;
+    /**
+     * Per-curve left/right balance overrides keyed by curve id (typically AU ids as strings).
+     * Example: { "43": 1, "12": 0.7 }.
+     * Falls back to `balance` when a curve id is not present.
+     */
+    balanceMap?: Record<string, number>;
     /** Jaw scale for viseme playback (default: 1.0) */
     jawScale?: number;
     /** Intensity scale multiplier (default: 1.0) */

package/dist/index.js

@@ -4,6 +4,20 @@ import { Vector3, Clock, Box3, Quaternion, LoopOnce, LoopPingPong, LoopRepeat, Q
 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/balanceUtils.ts
+function clampBalance(value) {
+  if (!Number.isFinite(value)) return 0;
+  return Math.max(-1, Math.min(1, value));
+}
+function resolveCurveBalance(curveId, globalBalance, balanceMap) {
+  if (balanceMap && Object.prototype.hasOwnProperty.call(balanceMap, curveId)) {
+    return clampBalance(Number(balanceMap[curveId]));
+  }
+  return clampBalance(globalBalance);
+}
+
+// src/engines/three/AnimationThree.ts
 var easeInOutQuad = (t) => t < 0.5 ? 2 * t * t : -1 + (4 - 2 * t) * t;
 var AnimationThree = class {
   constructor() {
@@ -363,7 +377,8 @@ var BakedAnimationController = class {
     }
     const tracks = [];
     const intensityScale = options?.intensityScale ?? 1;
-    const balance = options?.balance ?? 0;
+    const globalBalance = options?.balance ?? 0;
+    const balanceMap = options?.balanceMap;
     const meshNames = options?.meshNames;
     let maxTime = 0;
     const isNumericAU = (id) => /^\d+$/.test(id);
@@ -419,9 +434,10 @@ var BakedAnimationController = class {
           const leftKeys = morphsBySide?.left ?? [];
           const rightKeys = morphsBySide?.right ?? [];
           const centerKeys = morphsBySide?.center ?? [];
+          const curveBalance = resolveCurveBalance(curveId, globalBalance, balanceMap);
           for (const morphKey of leftKeys) {
             let effectiveScale = intensityScale * mixWeight;
-            if (balance > 0) effectiveScale *= 1 - balance;
+            if (curveBalance > 0) effectiveScale *= 1 - curveBalance;
             if (typeof morphKey === "number") {
               this.addMorphIndexTracks(tracks, morphKey, keyframes, effectiveScale, meshNames);
             } else {
@@ -430,7 +446,7 @@ var BakedAnimationController = class {
           }
           for (const morphKey of rightKeys) {
             let effectiveScale = intensityScale * mixWeight;
-            if (balance < 0) effectiveScale *= 1 + balance;
+            if (curveBalance < 0) effectiveScale *= 1 + curveBalance;
             if (typeof morphKey === "number") {
               this.addMorphIndexTracks(tracks, morphKey, keyframes, effectiveScale, meshNames);
             } else {