@sage-rsc/talking-head-react 1.1.2 → 1.1.3

package/dist/index.js

@@ -1,10 +1,10 @@
 import { jsxs as Pe, jsx as me } from "react/jsx-runtime";
-import { forwardRef as Me, useRef as D, useState as ce, useEffect as de, useCallback as T, useImperativeHandle as Ee, useLayoutEffect as Xe } from "react";
+import { forwardRef as Me, useRef as N, useState as ce, useEffect as de, useCallback as T, useImperativeHandle as Ee, useLayoutEffect as Xe } from "react";
 import * as f from "three";
 import { OrbitControls as Ye } from "three/addons/controls/OrbitControls.js";
 import { GLTFLoader as je } from "three/addons/loaders/GLTFLoader.js";
 import { DRACOLoader as Qe } from "three/addons/loaders/DRACOLoader.js";
-import { FBXLoader as De } from "three/addons/loaders/FBXLoader.js";
+import { FBXLoader as Ne } from "three/addons/loaders/FBXLoader.js";
 import { RoomEnvironment as qe } from "three/addons/environments/RoomEnvironment.js";
 import _e from "three/addons/libs/stats.module.js";
 let m, re, he;
@@ -2637,7 +2637,7 @@ new f.Vector3(0, 0, 1);
 const mt = new f.Vector3(1, 0, 0);
 new f.Vector3(0, 1, 0);
 new f.Vector3(0, 0, 1);
-class Be {
+class De {
   /**
   * Avatar.
   * @typedef {Object} Avatar
@@ -5264,10 +5264,10 @@ class Be {
     let h = "", a = "", c = 0, d = [], g = [];
     const x = Array.from(this.segmenter.segment(t), (b) => b.segment);
     for (let b = 0; b < x.length; b++) {
-      const I = b === x.length - 1, B = x[b].match(l);
+      const I = b === x.length - 1, D = x[b].match(l);
       let p = x[b].match(s);
       const M = x[b].match(u), z = x[b].match(o);
-      if (p && !I && !M && x[b + 1].match(s) && (p = !1), n && (h += x[b]), B && (!i || i.every((y) => b < y[0] || b > y[1])) && (a += x[b]), (z || p || I) && (a.length && (a = this.lipsyncPreProcessText(a, r), a.length && d.push({
+      if (p && !I && !M && x[b + 1].match(s) && (p = !1), n && (h += x[b]), D && (!i || i.every((y) => b < y[0] || b > y[1])) && (a += x[b]), (z || p || I) && (a.length && (a = this.lipsyncPreProcessText(a, r), a.length && d.push({
         mark: c,
         word: a
       })), h.length && (g.push({
@@ -5398,10 +5398,10 @@ class Be {
             let x = 0.6 + this.convertRange(g, [0, h], [0, 0.4]);
             if (h = Math.min(h, c.visemes.length * 200), d > 0)
               for (let b = 0; b < c.visemes.length; b++) {
-                const I = r + c.times[b] / d * h, B = c.durations[b] / d * h;
+                const I = r + c.times[b] / d * h, D = c.durations[b] / d * h;
                 o.push({
                   template: { name: "viseme" },
-                  ts: [I - Math.min(60, 2 * B / 3), I + Math.min(25, B / 2), I + B + Math.min(60, B / 2)],
+                  ts: [I - Math.min(60, 2 * D / 3), I + Math.min(25, D / 2), I + D + Math.min(60, D / 2)],
                   vs: {
                     ["viseme_" + c.visemes[b]]: [null, c.visemes[b] === "PP" || c.visemes[b] === "FF" ? 0.9 : x, 0]
                   }
@@ -5509,8 +5509,8 @@ class Be {
           });
         }
       }
-      const B = [...t.anim, ...I];
-      this.audioPlaylist.push({ anim: B, audio: d }), this.onSubtitles = t.onSubtitles || null, this.resetLips(), t.mood && this.setMood(t.mood), this.playAudio(), s.onend = () => {
+      const D = [...t.anim, ...I];
+      this.audioPlaylist.push({ anim: D, audio: d }), this.onSubtitles = t.onSubtitles || null, this.resetLips(), t.mood && this.setMood(t.mood), this.playAudio(), s.onend = () => {
         e();
       }, s.onerror = (p) => {
         console.error("Speech synthesis error:", p.error), n(p.error);
@@ -6202,7 +6202,7 @@ class Be {
     t === null && (t = u), e === null && (e = r), Q.copy(this.armature.quaternion), Q.multiply(this.poseTarget.props["Hips.quaternion"]), Q.multiply(this.poseTarget.props["Spine.quaternion"]), Q.multiply(this.poseTarget.props["Spine1.quaternion"]), Q.multiply(this.poseTarget.props["Spine2.quaternion"]), Q.multiply(this.poseTarget.props["Neck.quaternion"]), Q.multiply(this.poseTarget.props["Head.quaternion"]), V.setFromQuaternion(Q);
     let h = V.x / (40 / 24), a = V.y / (9 / 4), c = Math.min(0.4, Math.max(-0.4, this.camera.rotation.x)), d = Math.min(0.4, Math.max(-0.4, this.camera.rotation.y)), g = Math.max(window.innerWidth - u, u), x = Math.max(window.innerHeight - r, r), b = this.convertRange(e, [r - x, r + x], [-0.3, 0.6]) - h + c, I = this.convertRange(t, [u - g, u + g], [-0.8, 0.8]) - a + d;
     b = Math.min(0.6, Math.max(-0.3, b)), I = Math.min(0.8, Math.max(-0.8, I));
-    let B = (Math.random() - 0.5) / 4, p = (Math.random() - 0.5) / 4;
+    let D = (Math.random() - 0.5) / 4, p = (Math.random() - 0.5) / 4;
     if (n) {
       let M = this.animQueue.findIndex((y) => y.template.name === "lookat");
       M !== -1 && this.animQueue.splice(M, 1);
@@ -6210,9 +6210,9 @@ class Be {
         name: "lookat",
         dt: [750, n],
         vs: {
-          bodyRotateX: [b + B],
+          bodyRotateX: [b + D],
           bodyRotateY: [I + p],
-          eyesRotateX: [-3 * B + 0.1],
+          eyesRotateX: [-3 * D + 0.1],
           eyesRotateY: [-5 * p],
           browInnerUp: [[0, 0.7]],
           mouthLeft: [[0, 0.7]],
@@ -6402,7 +6402,7 @@ class Be {
     let n = t;
     if (n.startsWith("CC_Base_") && (n = n.replace("CC_Base_", "")), n = n.replace(/^mixamorig/i, ""), e.has(n))
       return n;
-    if (n.match(/^Spine\d+$/)) {
+    if (this._mappingDebugLog || (this._mappingDebugLog = /* @__PURE__ */ new Set()), this._mappingDebugLog.size < 5 && !this._mappingDebugLog.has(t) && (this._mappingDebugLog.add(t), console.debug(`Mapping attempt: "${t}" -> "${n}" (not found in available bones)`)), n.match(/^Spine\d+$/)) {
       const a = n.match(/\d+/)?.[0];
       if (a) {
         const c = `Spine${parseInt(a)}`;
@@ -6474,7 +6474,9 @@ class Be {
       if (e.has(a))
         return a;
     }
-    const s = n.toLowerCase(), o = s.match(/^[rl]_index(\d+)$/);
+    const s = n.toLowerCase();
+    n.charAt(0).toUpperCase() + n.slice(1).toLowerCase();
+    const o = s.match(/^[rl]_index(\d+)$/);
     if (o) {
       const a = o[1], d = `${s.startsWith("r") ? "Right" : "Left"}HandIndex${a}`;
       if (e.has(d))
@@ -6509,6 +6511,8 @@ class Be {
       if (e.has(c))
         return c;
     }
+    if (s.includes("upperarmtwist") || s.includes("forearmtwist"))
+      return null;
     if (s.match(/^[rl]_forearm/)) {
       const c = `${s.startsWith("r") ? "Right" : "Left"}ForeArm`;
       if (e.has(c))
@@ -6533,7 +6537,11 @@ class Be {
    */
   filterAnimationTracks(t, e) {
     const n = [], i = /* @__PURE__ */ new Set(), s = /* @__PURE__ */ new Map();
-    return t.tracks.forEach((o) => {
+    return this._loggedAvailableBones || (console.log(
+      "Available avatar bones:",
+      Array.from(e).sort().slice(0, 50).join(", "),
+      e.size > 50 ? `... (${e.size} total)` : ""
+    ), this._loggedAvailableBones = !0), t.tracks.forEach((o) => {
       const l = o.name.split("."), u = l[0], r = l[1], h = this.mapBoneName(u, e);
       if (h) {
         const a = `${h}.${r}`, c = o.clone();
@@ -6586,7 +6594,7 @@ class Be {
       } catch (c) {
         console.warn(`Could not verify file existence for ${t}, attempting to load anyway:`, c);
       }
-      const h = new De();
+      const h = new Ne();
       let a;
       try {
         a = await h.loadAsync(t, e);
@@ -6620,12 +6628,12 @@ class Be {
         const x = {};
         c.tracks.forEach((I) => {
           I.name = I.name.replaceAll("mixamorig", "");
-          const B = I.name.split(".");
-          if (B[1] === "position") {
+          const D = I.name.split(".");
+          if (D[1] === "position") {
             for (let p = 0; p < I.values.length; p++)
               I.values[p] = I.values[p] * s;
             x[I.name] = new f.Vector3(I.values[0], I.values[1], I.values[2]);
-          } else B[1] === "quaternion" ? x[I.name] = new f.Quaternion(I.values[0], I.values[1], I.values[2], I.values[3]) : B[1] === "rotation" && (x[B[0] + ".quaternion"] = new f.Quaternion().setFromEuler(new f.Euler(I.values[0], I.values[1], I.values[2], "XYZ")).normalize());
+          } else D[1] === "quaternion" ? x[I.name] = new f.Quaternion(I.values[0], I.values[1], I.values[2], I.values[3]) : D[1] === "rotation" && (x[D[0] + ".quaternion"] = new f.Quaternion().setFromEuler(new f.Euler(I.values[0], I.values[1], I.values[2], "XYZ")).normalize());
         });
         const b = { props: x };
         x["Hips.position"] && (x["Hips.position"].y < 0.5 ? b.lying = !0 : b.standing = !0), this.animClips.push({
@@ -6669,7 +6677,7 @@ class Be {
       let l = this.animQueue.find((u) => u.template.name === "pose");
       l && (l.ts[0] = this.animClock + n * 1e3 + 2e3), this.setPoseFromTemplate(o);
     } else {
-      let u = await new De().loadAsync(t, e);
+      let u = await new Ne().loadAsync(t, e);
       if (u && u.animations && u.animations[i]) {
         let r = u.animations[i];
         const h = {};
@@ -6766,7 +6774,7 @@ class Be {
     const b = t.iterations || 10;
     if (e)
       for (let I = 0; I < b; I++) {
-        let B = !1;
+        let D = !1;
         for (let p = 0, M = x.length; p < M; p++) {
           const z = x[p].bone;
           z.matrixWorld.decompose(u, r, h), r.invert(), o.setFromMatrixPosition(g.matrixWorld), l.subVectors(o, u), l.applyQuaternion(r), l.normalize(), s.subVectors(e, u), s.applyQuaternion(r), s.normalize();
@@ -6779,9 +6787,9 @@ class Be {
             x[p].maxx !== void 0 ? x[p].maxx : 1 / 0,
             x[p].maxy !== void 0 ? x[p].maxy : 1 / 0,
             x[p].maxz !== void 0 ? x[p].maxz : 1 / 0
-          ))), z.updateMatrixWorld(!0), B = !0);
+          ))), z.updateMatrixWorld(!0), D = !0);
         }
-        if (!B) break;
+        if (!D) break;
       }
     i && x.forEach((I) => {
       this.poseTarget.props[I.link + ".quaternion"].copy(I.bone.quaternion), this.poseTarget.props[I.link + ".quaternion"].t = this.animClock, this.poseTarget.props[I.link + ".quaternion"].d = i;
@@ -6874,7 +6882,7 @@ const Ve = Me(({
   style: x = {},
   animations: b = {}
 }, I) => {
-  const B = D(null), p = D(null), M = D(r), z = D(null), y = D(null), E = D(!1), P = D({ remainingText: null, originalText: null, options: null }), W = D([]), oe = D(0), [S, Z] = ce(!0), [_, X] = ce(null), [$, se] = ce(!1), [ae, pe] = ce(!1);
+  const D = N(null), p = N(null), M = N(r), z = N(null), y = N(null), E = N(!1), P = N({ remainingText: null, originalText: null, options: null }), W = N([]), oe = N(0), [S, Z] = ce(!0), [_, X] = ce(null), [$, se] = ce(!1), [ae, pe] = ce(!1);
   de(() => {
     E.current = ae;
   }, [ae]), de(() => {
@@ -6921,23 +6929,23 @@ const Ve = Me(({
     lipsyncModules: ["en"],
     cameraView: h
   }, k = T(async () => {
-    if (!(!B.current || p.current))
+    if (!(!D.current || p.current))
       try {
-        if (Z(!0), X(null), p.current = new Be(B.current, R), p.current.controls && (p.current.controls.enableRotate = !1, p.current.controls.enableZoom = !1, p.current.controls.enablePan = !1, p.current.controls.enableDamping = !1), b && Object.keys(b).length > 0 && (p.current.customAnimations = b), await p.current.showAvatar(v, (N) => {
-          if (N.lengthComputable) {
-            const J = Math.min(100, Math.round(N.loaded / N.total * 100));
+        if (Z(!0), X(null), p.current = new De(D.current, R), p.current.controls && (p.current.controls.enableRotate = !1, p.current.controls.enableZoom = !1, p.current.controls.enablePan = !1, p.current.controls.enableDamping = !1), b && Object.keys(b).length > 0 && (p.current.customAnimations = b), await p.current.showAvatar(v, (B) => {
+          if (B.lengthComputable) {
+            const J = Math.min(100, Math.round(B.loaded / B.total * 100));
             c(J);
           }
-        }), await new Promise((N) => {
+        }), await new Promise((B) => {
           const J = () => {
-            p.current.lipsync && Object.keys(p.current.lipsync).length > 0 ? N() : setTimeout(J, 100);
+            p.current.lipsync && Object.keys(p.current.lipsync).length > 0 ? B() : setTimeout(J, 100);
           };
           J();
         }), p.current && p.current.setShowFullAvatar)
           try {
             p.current.setShowFullAvatar(r);
-          } catch (N) {
-            console.warn("Error setting full body mode on initialization:", N);
+          } catch (B) {
+            console.warn("Error setting full body mode on initialization:", B);
           }
         p.current && p.current.controls && (p.current.controls.enableRotate = !1, p.current.controls.enableZoom = !1, p.current.controls.enablePan = !1, p.current.controls.enableDamping = !1, p.current.controls.update()), Z(!1), se(!0), a(p.current);
         const F = () => {
@@ -6953,12 +6961,12 @@ const Ve = Me(({
   de(() => (k(), () => {
     p.current && (p.current.stop(), p.current.dispose(), p.current = null);
   }), [k]), de(() => {
-    if (!B.current || !p.current) return;
-    const L = new ResizeObserver((N) => {
-      for (const J of N)
+    if (!D.current || !p.current) return;
+    const L = new ResizeObserver((B) => {
+      for (const J of B)
         p.current && p.current.onResize && p.current.onResize();
     });
-    L.observe(B.current);
+    L.observe(D.current);
     const F = () => {
       p.current && p.current.onResize && p.current.onResize();
     };
@@ -6977,7 +6985,7 @@ const Ve = Me(({
     if (p.current && $)
       try {
         y.current && (clearInterval(y.current), y.current = null), z.current = { text: L, options: F }, P.current = { remainingText: null, originalText: null, options: null };
-        const N = /[!\.\?\n\p{Extended_Pictographic}]/ug, J = L.split(N).map((Y) => Y.trim()).filter((Y) => Y.length > 0);
+        const B = /[!\.\?\n\p{Extended_Pictographic}]/ug, J = L.split(B).map((Y) => Y.trim()).filter((Y) => Y.length > 0);
         W.current = J, oe.current = 0, pe(!1), E.current = !1, await H();
         const ge = {
           ...F,
@@ -6996,8 +7004,8 @@ const Ve = Me(({
                 be = !0;
                 try {
                   F.onSpeechEnd();
-                } catch (Ne) {
-                  console.error("Error in onSpeechEnd callback (timeout):", Ne);
+                } catch (Be) {
+                  console.error("Error in onSpeechEnd callback (timeout):", Be);
                 }
               }
               return;
@@ -7018,8 +7026,8 @@ const Ve = Me(({
         p.current.lipsync && Object.keys(p.current.lipsync).length > 0 ? (p.current.setSlowdownRate && p.current.setSlowdownRate(1.05), p.current.speakText(L, ge)) : setTimeout(async () => {
           await H(), p.current && p.current.lipsync && (p.current.setSlowdownRate && p.current.setSlowdownRate(1.05), p.current.speakText(L, ge));
         }, 100);
-      } catch (N) {
-        console.error("Error speaking text:", N), X(N.message || "Failed to speak text");
+      } catch (B) {
+        console.error("Error speaking text:", B), X(B.message || "Failed to speak text");
       }
   }, [$, H, v.lipsyncLang]), K = T(() => {
     p.current && (p.current.stopSpeaking(), p.current.setSlowdownRate && p.current.setSlowdownRate(1), z.current = null, pe(!1));
@@ -7028,16 +7036,16 @@ const Ve = Me(({
       const L = p.current;
       if (L.isSpeaking || L.audioPlaylist && L.audioPlaylist.length > 0 || L.speechQueue && L.speechQueue.length > 0) {
         y.current && (clearInterval(y.current), y.current = null);
-        let N = "";
+        let B = "";
         if (z.current && W.current.length > 0) {
           const J = W.current.length, ge = L.speechQueue ? L.speechQueue.filter((Ae) => Ae && Ae.text && Array.isArray(Ae.text) && Ae.text.length > 0).length : 0, Y = L.audioPlaylist && L.audioPlaylist.length > 0, ue = ge + (Y ? 1 : 0), Se = J - ue;
-          if (ue > 0 && Se < J && (N = W.current.slice(Se).join(". ").trim(), !N && ge > 0 && L.speechQueue)) {
+          if (ue > 0 && Se < J && (B = W.current.slice(Se).join(". ").trim(), !B && ge > 0 && L.speechQueue)) {
             const be = L.speechQueue.filter((ye) => ye && ye.text && Array.isArray(ye.text) && ye.text.length > 0).map((ye) => ye.text.map((ke) => ke.word || "").filter((ke) => ke.length > 0).join(" ")).filter((ye) => ye.length > 0).join(" ");
-            be && be.trim() && (N = be.trim());
+            be && be.trim() && (B = be.trim());
           }
         }
         z.current && (P.current = {
-          remainingText: N || null,
+          remainingText: B || null,
           originalText: z.current.text,
           options: z.current.options
         }), L.speechQueue && (L.speechQueue.length = 0), p.current.pauseSpeaking(), E.current = !0, pe(!0);
@@ -7056,12 +7064,12 @@ const Ve = Me(({
       return;
     }
     pe(!1), E.current = !1, await H();
-    const N = {
+    const B = {
       ...F,
       lipsyncLang: F.lipsyncLang || v.lipsyncLang || "en"
     };
     try {
-      await U(L, N);
+      await U(L, B);
     } catch (J) {
       console.error("Error resuming speech:", J), pe(!1), E.current = !1;
     }
@@ -7194,7 +7202,7 @@ const Ve = Me(({
         /* @__PURE__ */ me(
           "div",
           {
-            ref: B,
+            ref: D,
             className: "talking-head-viewer",
             style: {
               width: "100%",
@@ -7241,7 +7249,7 @@ const pt = Me(({
   style: s = {},
   avatarConfig: o = {}
 }, l) => {
-  const u = D(null), r = D(null), [h, a] = ce(!0), [c, d] = ce(null), [g, x] = ce(!1), b = Fe(), I = o.ttsService || b.service, B = I === "browser" ? {
+  const u = N(null), r = N(null), [h, a] = ce(!0), [c, d] = ce(null), [g, x] = ce(!1), b = Fe(), I = o.ttsService || b.service, D = I === "browser" ? {
     endpoint: "",
     apiKey: null,
     defaultVoice: "Google US English"
@@ -7257,7 +7265,7 @@ const pt = Me(({
     body: "F",
     avatarMood: "neutral",
     ttsLang: I === "browser" ? "en-US" : "en",
-    ttsVoice: o.ttsVoice || B.defaultVoice,
+    ttsVoice: o.ttsVoice || D.defaultVoice,
     lipsyncLang: "en",
     // English lip-sync
     showFullAvatar: !0,
@@ -7266,15 +7274,15 @@ const pt = Me(({
     movementIntensity: 0.5,
     ...o
   }, M = {
-    ttsEndpoint: B.endpoint,
-    ttsApikey: B.apiKey,
+    ttsEndpoint: D.endpoint,
+    ttsApikey: D.apiKey,
     ttsService: I,
     lipsyncModules: ["en"],
     cameraView: "upper"
   }, z = T(async () => {
     if (!(!u.current || r.current))
       try {
-        if (a(!0), d(null), r.current = new Be(u.current, M), await r.current.showAvatar(p, (_) => {
+        if (a(!0), d(null), r.current = new De(u.current, M), await r.current.showAvatar(p, (_) => {
           if (_.lengthComputable) {
             const X = Math.min(100, Math.round(_.loaded / _.total * 100));
             t(X);
@@ -7493,10 +7501,10 @@ const gt = Me(({
   },
   className: b = "",
   style: I = {},
-  animations: B = {},
+  animations: D = {},
   autoSpeak: p = !1
 }, M) => {
-  const z = D(null), y = D(null), E = D(h), P = D(null), W = D(null), oe = D(!1), S = D({ remainingText: null, originalText: null, options: null }), Z = D([]), [_, X] = ce(!0), [$, se] = ce(null), [ae, pe] = ce(!1), [ee, le] = ce(!1);
+  const z = N(null), y = N(null), E = N(h), P = N(null), W = N(null), oe = N(!1), S = N({ remainingText: null, originalText: null, options: null }), Z = N([]), [_, X] = ce(!0), [$, se] = ce(null), [ae, pe] = ce(!1), [ee, le] = ce(!1);
   de(() => {
     oe.current = ee;
   }, [ee]), de(() => {
@@ -7544,7 +7552,7 @@ const gt = Me(({
   }, U = T(async () => {
     if (!(!z.current || y.current))
       try {
-        X(!0), se(null), y.current = new Be(z.current, H), console.log("Avatar config being passed:", {
+        X(!0), se(null), y.current = new De(z.current, H), console.log("Avatar config being passed:", {
           url: k.url,
           body: k.body,
           avatarMood: k.avatarMood
@@ -7585,7 +7593,7 @@ const gt = Me(({
       return;
     }
     await K(), S.current = { remainingText: null, originalText: null, options: null }, Z.current = [], P.current = { text: C, options: te }, W.current && (clearInterval(W.current), W.current = null), le(!1), oe.current = !1;
-    const L = C.split(/[.!?]+/).filter((N) => N.trim().length > 0);
+    const L = C.split(/[.!?]+/).filter((B) => B.trim().length > 0);
     Z.current = L;
     const F = {
       lipsyncLang: te.lipsyncLang || "en",
@@ -7595,8 +7603,8 @@ const gt = Me(({
     };
     try {
       y.current.speakText(C, F);
-    } catch (N) {
-      console.error("Error speaking text:", N), se(N.message || "Failed to speak text");
+    } catch (B) {
+      console.error("Error speaking text:", B), se(B.message || "Failed to speak text");
     }
   }, [ae, x, K]);
   de(() => {
@@ -7609,7 +7617,7 @@ const gt = Me(({
         if (C || te.length > 0 || L.length > 0) {
           W.current && (clearInterval(W.current), W.current = null);
           let F = "";
-          L.length > 0 && (F = L.map((N) => N.text && Array.isArray(N.text) ? N.text.map((J) => J.word).join(" ") : N.text || "").join(" ")), S.current = {
+          L.length > 0 && (F = L.map((B) => B.text && Array.isArray(B.text) ? B.text.map((J) => J.word).join(" ") : B.text || "").join(" ")), S.current = {
             remainingText: F || null,
             originalText: P.current?.text || null,
             options: P.current?.options || null
@@ -7704,7 +7712,7 @@ const yt = Me(({
   },
   autoStart: u = !1
 }, r) => {
-  const h = D(null), a = D({
+  const h = N(null), a = N({
     currentModuleIndex: 0,
     currentLessonIndex: 0,
     currentQuestionIndex: 0,
@@ -7714,18 +7722,18 @@ const yt = Me(({
     curriculumCompleted: !1,
     score: 0,
     totalQuestions: 0
-  }), c = D({
+  }), c = N({
     onLessonStart: n,
     onLessonComplete: i,
     onQuestionAnswer: s,
     onCurriculumComplete: o,
     onCustomAction: l
-  }), d = D(null), g = D(null), x = D(null), b = D(null), I = D(null), B = D(null), p = D(null), M = D(G?.curriculum || {
+  }), d = N(null), g = N(null), x = N(null), b = N(null), I = N(null), D = N(null), p = N(null), M = N(G?.curriculum || {
     title: "Default Curriculum",
     description: "No curriculum data provided",
     language: "en",
     modules: []
-  }), z = D({
+  }), z = N({
     avatarUrl: t.avatarUrl || "/avatars/brunette.glb",
     avatarBody: t.avatarBody || "F",
     mood: t.mood || "happy",
@@ -8176,7 +8184,7 @@ const yt = Me(({
     }, 10);
   }, [u, y]);
   Xe(() => {
-    d.current = X, g.current = _, x.current = W, b.current = Z, I.current = oe, B.current = S, p.current = $;
+    d.current = X, g.current = _, x.current = W, b.current = Z, I.current = oe, D.current = S, p.current = $;
   }), Ee(r, () => ({
     // Curriculum control methods
     startTeaching: X,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sage-rsc/talking-head-react",
-  "version": "1.1.2",
+  "version": "1.1.3",
   "description": "A reusable React component for 3D talking avatars with lip-sync and text-to-speech",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",

package/src/lib/talkinghead.mjs

@@ -2253,11 +2253,11 @@ class TalkingHead {
     if (this.lockedPosition && this.armature) {
       // Enforce the locked position - keep avatar exactly where it was locked
       // This prevents FBX animations from moving the avatar
-      this.armature.position.set(
-        this.lockedPosition.x,
+        this.armature.position.set(
+          this.lockedPosition.x,
         this.lockedPosition.y,
-        this.lockedPosition.z
-      );
+          this.lockedPosition.z
+        );
     }
   }
 
@@ -5354,6 +5354,7 @@ class TalkingHead {
 
     // Remove common prefixes
     let normalized = fbxBoneName;
+    const originalNormalized = normalized;
     
     // Remove CC_Base prefix (Character Creator)
     if (normalized.startsWith('CC_Base_')) {
@@ -5367,6 +5368,15 @@ class TalkingHead {
     if (availableBones.has(normalized)) {
       return normalized;
     }
+    
+    // Debug: Log first few failed mappings to help identify patterns
+    if (!this._mappingDebugLog) {
+      this._mappingDebugLog = new Set();
+    }
+    if (this._mappingDebugLog.size < 5 && !this._mappingDebugLog.has(fbxBoneName)) {
+      this._mappingDebugLog.add(fbxBoneName);
+      console.debug(`Mapping attempt: "${fbxBoneName}" -> "${normalized}" (not found in available bones)`);
+    }
 
     // Handle numbered bones (e.g., Spine01 -> Spine1)
     if (normalized.match(/^Spine\d+$/)) {
@@ -5459,8 +5469,9 @@ class TalkingHead {
 
     // Pattern-based matching for CC_Base and similar naming conventions
     const lowerNormalized = normalized.toLowerCase();
+    const upperFirst = normalized.charAt(0).toUpperCase() + normalized.slice(1).toLowerCase();
     
-    // Pattern: R_Index1/2/3 -> RightHandIndex1/2/3
+    // Pattern: R_Index1/2/3 or r_index1/2/3 -> RightHandIndex1/2/3
     const indexMatch = lowerNormalized.match(/^[rl]_index(\d+)$/);
     if (indexMatch) {
       const digit = indexMatch[1];
@@ -5515,7 +5526,7 @@ class TalkingHead {
       }
     }
     
-    // Pattern: R_Upperarm -> RightArm
+    // Pattern: R_Upperarm -> RightArm (case insensitive)
     if (lowerNormalized.match(/^[rl]_upperarm/)) {
       const side = lowerNormalized.startsWith('r') ? 'Right' : 'Left';
       const candidate = `${side}Arm`;
@@ -5524,6 +5535,11 @@ class TalkingHead {
       }
     }
     
+    // Pattern: R_UpperarmTwist01/02 -> ignore (twist bones)
+    if (lowerNormalized.includes('upperarmtwist') || lowerNormalized.includes('forearmtwist')) {
+      return null;
+    }
+    
     // Pattern: R_Forearm -> RightForeArm
     if (lowerNormalized.match(/^[rl]_forearm/)) {
       const side = lowerNormalized.startsWith('r') ? 'Right' : 'Left';
@@ -5564,6 +5580,13 @@ class TalkingHead {
     const missingBones = new Set();
     const mappedBones = new Map(); // Track mappings for logging
     
+    // Debug: Log available bones (first time only)
+    if (!this._loggedAvailableBones) {
+      console.log('Available avatar bones:', Array.from(availableBones).sort().slice(0, 50).join(', '), 
+        availableBones.size > 50 ? `... (${availableBones.size} total)` : '');
+      this._loggedAvailableBones = true;
+    }
+    
     clip.tracks.forEach(track => {
       // Extract bone name from track name (e.g., "CC_Base_R_Index3.position" -> "CC_Base_R_Index3")
       const trackNameParts = track.name.split('.');