@sage-rsc/talking-head-react 1.8.2 → 1.8.4

package/dist/index.js

@@ -1,5 +1,5 @@
 import { jsxs as Pe, jsx as ae } from "react/jsx-runtime";
-import { forwardRef as Ke, useRef as V, useState as pe, useEffect as Se, useCallback as U, useImperativeHandle as Je, useLayoutEffect as pt } from "react";
+import { forwardRef as Ke, useRef as V, useState as pe, useEffect as Se, useCallback as U, useImperativeHandle as $e, useLayoutEffect as pt } from "react";
 import * as b from "three";
 import { OrbitControls as gt } from "three/addons/controls/OrbitControls.js";
 import { GLTFLoader as yt } from "three/addons/loaders/GLTFLoader.js";
@@ -5200,9 +5200,9 @@ class nt {
         eyeLookOutRight: [null, 0],
         eyeContact: [0]
       }
-    })))), e > 2 * this.animFrameDur && (e = 2 * this.animFrameDur), (this.viewName !== "full" || this.isAvatarOnly) && (t = this.mtRandomized[Math.floor(Math.random() * this.mtRandomized.length)], o = this.mtAvatar[t], o.needsUpdate || Object.assign(o, { base: (this.mood.baseline[t] || 0) + (1 + a / 255) * Math.random() / 5, needsUpdate: !0 })), this.updatePoseBase(this.animClock), this.mixer && (this.mixer.update(e / 1e3 * this.mixer.timeScale), this.currentFBXActionForCallback && this.currentFBXActionForCallback.isRunning() && this.currentFBXActionClipDuration)) {
-      const r = this.currentFBXActionForCallback.time, h = this.currentFBXActionClipDuration;
-      (r >= h - 0.05 || r > 0 && !this.currentFBXActionForCallback.paused && r >= h - 0.1) && (this.currentFBXActionCallback && (this.currentFBXActionCallback(), this.currentFBXActionCallback = null), this.currentFBXActionForCallback = null, this.currentFBXActionStartTime = null, this.currentFBXActionClipDuration = null);
+    })))), e > 2 * this.animFrameDur && (e = 2 * this.animFrameDur), (this.viewName !== "full" || this.isAvatarOnly) && (t = this.mtRandomized[Math.floor(Math.random() * this.mtRandomized.length)], o = this.mtAvatar[t], o.needsUpdate || Object.assign(o, { base: (this.mood.baseline[t] || 0) + (1 + a / 255) * Math.random() / 5, needsUpdate: !0 })), this.updatePoseBase(this.animClock), this.mixer && (this.mixer.update(e / 1e3 * this.mixer.timeScale), this.currentFBXActionForCallback && this.currentFBXActionClipDuration)) {
+      const r = this.currentFBXActionForCallback, h = r.time, d = this.currentFBXActionClipDuration;
+      (!r.isRunning() || h >= d - 0.1 || r.getEffectiveTimeScale() === 0 && h > 0) && (console.log(`🎬 Manual check: Animation finished (time: ${h.toFixed(3)}/${d.toFixed(3)}, running: ${r.isRunning()})`), this.currentFBXActionCallback && (this.currentFBXActionCallback(), this.currentFBXActionCallback = null), this.currentFBXActionForCallback = null, this.currentFBXActionStartTime = null, this.currentFBXActionClipDuration = null);
     }
     if (this.updatePoseDelta(), (this.isSpeaking || this.isListening) && u ? a > this.volumeMax ? (this.volumeHeadBase = 0.05, Math.random() > 0.6 && (this.volumeHeadTarget = -0.05 - Math.random() / 15), this.volumeMax = a) : (this.volumeMax *= 0.92, this.volumeHeadTarget = this.volumeHeadBase - 0.9 * (this.volumeHeadBase - this.volumeHeadTarget)) : (this.volumeHeadTarget = 0, this.volumeMax = 0), t = this.volumeHeadTarget - this.volumeHeadCurrent, o = Math.abs(t), o > 1e-4 && (i = o * (this.volumeHeadEasing(Math.min(1, this.volumeHeadVelocity * e / 1e3 / o) / 2 + 0.5) - 0.5), this.volumeHeadCurrent += Math.sign(t) * Math.min(o, i)), Math.abs(this.volumeHeadCurrent) > 1e-4 && (ue.setFromAxisAngle(Bt, this.volumeHeadCurrent), this.objectNeck.quaternion.multiply(ue)), at.setFromObject(this.armature), this.objectLeftToeBase.getWorldPosition(Ue), Ue.sub(this.armature.position), this.objectRightToeBase.getWorldPosition(Xe), Xe.sub(this.armature.position), this.objectHips.position.y -= at.min.y / 2, this.objectHips.position.x -= (Ue.x + Xe.x) / 4, this.objectHips.position.z -= (Ue.z + Xe.z) / 2, this.dynamicbones.update(e), this.fbxAnimationLoader && this.fbxAnimationLoader.update(), this.opt.update && this.opt.update(e), this.updateMorphTargets(e), this.isAvatarOnly)
       this.stats && this.stats.end();
@@ -6449,15 +6449,15 @@ class nt {
         this.poseBase.props[h[0]] = h[1].clone(), this.poseTarget.props[h[0]] = h[1].clone(), this.poseTarget.props[h[0]].t = 0, this.poseTarget.props[h[0]].d = 1e3;
       }), this.mixer || (this.mixer = new b.AnimationMixer(this.armature)), this.animationFinishedCallback = a;
       const c = () => {
-        this.animationFinishedCallback && (this.animationFinishedCallback(), this.animationFinishedCallback = null), this.stopAnimation();
+        console.log(`🎬 Mixer 'finished' event fired for animation: ${n}`), this.animationFinishedCallback && (this.animationFinishedCallback(), this.animationFinishedCallback = null);
       }, r = this.mixer.clipAction(u.clip);
       if (t <= 0)
-        r.setLoop(b.LoopOnce, 1);
+        r.setLoop(b.LoopOnce, 1), console.log(`🎬 Setting animation to LoopOnce, duration: ${u.clip.duration.toFixed(3)}s`);
       else {
         const h = Math.ceil(t / u.clip.duration);
         r.setLoop(b.LoopRepeat, h);
       }
-      if (r.clampWhenFinished = !0, this.mixer.addEventListener("finished", c, { once: !0 }), this.currentFBXActionForCallback = r, this.currentFBXActionCallback = c, this.currentFBXActionClipDuration = u.clip.duration, this.currentFBXActionStartTime = null, this.currentFBXAction && this.currentFBXAction.isRunning()) {
+      if (r.clampWhenFinished = !0, r.time = 0, this.mixer.addEventListener("finished", c, { once: !0 }), this.currentFBXActionForCallback = r, this.currentFBXActionCallback = c, this.currentFBXActionClipDuration = u.clip.duration, this.currentFBXActionStartTime = null, this.currentFBXAction && this.currentFBXAction.isRunning()) {
         this.currentFBXAction.fadeOut(0.3), setTimeout(() => {
           this.currentFBXAction = r, this.currentFBXActionForCallback = r, this.currentFBXActionCallback = c, this.currentFBXActionClipDuration = u.clip.duration, this.currentFBXActionStartTime = this.mixer.time;
           try {
@@ -6842,7 +6842,7 @@ const Ze = {
     // Male, English - Powerful
   }
 };
-function $e() {
+function Je() {
   return {
     service: "elevenlabs",
     endpoint: Ze.endpoint,
@@ -6852,7 +6852,7 @@ function $e() {
   };
 }
 function qt() {
-  const Z = $e(), n = [];
+  const Z = Je(), n = [];
   return Object.entries(Z.voices).forEach(([e, t]) => {
     n.push({
       value: t,
@@ -6888,7 +6888,7 @@ const ct = Ke(({
   }, [me]), Se(() => {
     D.current = l;
   }, [l]);
-  const ye = $e(), Re = o || ye.service;
+  const ye = Je(), Re = o || ye.service;
   let he;
   Re === "browser" ? he = {
     service: "browser",
@@ -7118,7 +7118,7 @@ const ct = Ke(({
   }, [x]), ke = U(() => {
     m.current && m.current.onResize && m.current.onResize();
   }, []);
-  return Je(k, () => ({
+  return $e(k, () => ({
     speakText: Y,
     stopSpeaking: K,
     pauseSpeaking: q,
@@ -7249,7 +7249,7 @@ const Ot = Ke(({
   style: s = {},
   avatarConfig: i = {}
 }, a) => {
-  const u = V(null), l = V(null), [c, r] = pe(!0), [h, d] = pe(null), [g, R] = pe(!1), x = $e(), k = i.ttsService || x.service, G = k === "browser" ? {
+  const u = V(null), l = V(null), [c, r] = pe(!0), [h, d] = pe(null), [g, R] = pe(!1), x = Je(), k = i.ttsService || x.service, G = k === "browser" ? {
     endpoint: "",
     apiKey: null,
     defaultVoice: "Google US English"
@@ -7376,7 +7376,7 @@ const Ot = Ke(({
     } else
       console.warn("Animation system not available or animation not found:", I);
   }, []);
-  return Je(a, () => ({
+  return $e(a, () => ({
     speakText: y,
     stopSpeaking: P,
     setMood: L,
@@ -7615,12 +7615,12 @@ const Nt = Ke(({
             } catch {
             }
           if (typeof m.auto == "string") {
-            const H = m.auto, J = {
+            const H = m.auto, $ = {
               talking: `${H}/talking`,
               idle: `${H}/idle`
             }, W = C(e);
-            J[`${W}_talking`] = `${H}/${W}/talking`, J[`${W}_idle`] = `${H}/${W}/idle`, J.shared_talking = `${H}/shared/talking`, J.shared_idle = `${H}/shared/idle`;
-            const ie = await lt(J, e);
+            $[`${W}_talking`] = `${H}/${W}/talking`, $[`${W}_idle`] = `${H}/${W}/idle`, $.shared_talking = `${H}/shared/talking`, $.shared_idle = `${H}/shared/idle`;
+            const ie = await lt($, e);
             if (!Object.values(ie).some((j) => Array.isArray(j) && j.length > 0) && w) {
               O(w);
               return;
@@ -7631,22 +7631,22 @@ const Nt = Ke(({
                 shared: {}
               }
             };
-            Object.entries(ie).forEach(([j, $]) => {
+            Object.entries(ie).forEach(([j, J]) => {
               if (j.includes("_")) {
                 const [ee, ...ge] = j.split("_"), de = ge.join("_");
-                ee === "shared" ? (ce._genderSpecific.shared[de] || (ce._genderSpecific.shared[de] = []), ce._genderSpecific.shared[de].push(...$)) : ee === W && (ce._genderSpecific[W][de] || (ce._genderSpecific[W][de] = []), ce._genderSpecific[W][de].push(...$));
+                ee === "shared" ? (ce._genderSpecific.shared[de] || (ce._genderSpecific.shared[de] = []), ce._genderSpecific.shared[de].push(...J)) : ee === W && (ce._genderSpecific[W][de] || (ce._genderSpecific[W][de] = []), ce._genderSpecific[W][de].push(...J));
               } else
-                ce[j] = $;
+                ce[j] = J;
             }), w && (w._genderSpecific && Object.keys(w._genderSpecific).forEach((j) => {
-              ce._genderSpecific[j] || (ce._genderSpecific[j] = {}), Object.entries(w._genderSpecific[j]).forEach(([$, ee]) => {
-                ce._genderSpecific[j][$] || (ce._genderSpecific[j][$] = ee);
+              ce._genderSpecific[j] || (ce._genderSpecific[j] = {}), Object.entries(w._genderSpecific[j]).forEach(([J, ee]) => {
+                ce._genderSpecific[j][J] || (ce._genderSpecific[j][J] = ee);
               });
-            }), Object.entries(w).forEach(([j, $]) => {
-              j !== "_genderSpecific" && !ce[j] && (ce[j] = $);
+            }), Object.entries(w).forEach(([j, J]) => {
+              j !== "_genderSpecific" && !ce[j] && (ce[j] = J);
             })), O(ce);
           } else if (typeof m.auto == "object") {
-            const H = await lt(m.auto, e), J = Object.values(H).some((W) => Array.isArray(W) && W.length > 0);
-            O(!J && w ? w : H);
+            const H = await lt(m.auto, e), $ = Object.values(H).some((W) => Array.isArray(W) && W.length > 0);
+            O(!$ && w ? w : H);
           }
         } catch (w) {
           if (console.error("Failed to auto-discover animations:", w), m.manifest)
@@ -7665,7 +7665,7 @@ const Nt = Ke(({
   }, [m, e, C]), Se(() => {
     M.current = c;
   }, [c]);
-  const X = $e(), ne = s || X.service;
+  const X = Je(), ne = s || X.service;
   let se;
   ne === "browser" ? se = {
     service: "browser",
@@ -7739,8 +7739,8 @@ const Nt = Ke(({
       return [];
     let w = null;
     if (T._genderSpecific) {
-      const H = C(e), J = T._genderSpecific[H];
-      if (J && J[S] && Array.isArray(J[S]) && J[S].length > 0 && (w = J[S]), !w && T._genderSpecific.shared && T._genderSpecific.shared[S]) {
+      const H = C(e), $ = T._genderSpecific[H];
+      if ($ && $[S] && Array.isArray($[S]) && $[S].length > 0 && (w = $[S]), !w && T._genderSpecific.shared && T._genderSpecific.shared[S]) {
         const W = T._genderSpecific.shared[S];
         Array.isArray(W) && W.length > 0 && (w = W);
       }
@@ -7753,8 +7753,8 @@ const Nt = Ke(({
   }, [T, e, C]), He = U((S) => {
     const w = [...S];
     for (let H = w.length - 1; H > 0; H--) {
-      const J = Math.floor(Math.random() * (H + 1));
-      [w[H], w[J]] = [w[J], w[H]];
+      const $ = Math.floor(Math.random() * (H + 1));
+      [w[H], w[$]] = [w[$], w[H]];
     }
     return w;
   }, []), we = U((S) => {
@@ -7769,10 +7769,10 @@ const Nt = Ke(({
   }, [Be, He]), We = U((S) => S ? S.split("/").pop().replace(".fbx", "").replace(/[-_]/g, " ") : "Unknown", []), Oe = U((S, w = !1, H = null) => {
     if (!f.current || !K.current || q.current !== S)
       return null;
-    const J = we(S);
-    if (J)
+    const $ = we(S);
+    if ($)
       try {
-        const W = We(J);
+        const W = We($);
         console.log(`🎬 Playing animation: "${W}"`);
         const ie = () => {
           console.log("🎬 Animation finished, checking if should continue...");
@@ -7783,11 +7783,11 @@ const Nt = Ke(({
               return console.log("🎬 isSpeakingRef is false, stopping animations"), !1;
             if (q.current !== S)
               return console.log(`🎬 Animation group mismatch (${q.current} !== ${S}), stopping animations`), !1;
-            const j = f.current, $ = j.isAudioPlaying === !0, ee = j.audioPlaylist && j.audioPlaylist.length > 0, ge = j.speechQueue && j.speechQueue.length > 0, de = j.isSpeaking === !0, Ge = de || $ || ee || ge;
+            const j = f.current, J = j.isAudioPlaying === !0, ee = j.audioPlaylist && j.audioPlaylist.length > 0, ge = j.speechQueue && j.speechQueue.length > 0, de = j.isSpeaking === !0, Ge = de || J || ee || ge;
             return console.log("🎬 Still speaking check:", {
               isSpeakingRef: K.current,
               isTalkingHeadSpeaking: de,
-              hasAudioPlaying: $,
+              hasAudioPlaying: J,
               hasAudioInPlaylist: ee,
               hasItemsInQueue: ge,
               shouldContinue: Ge
@@ -7797,7 +7797,7 @@ const Nt = Ke(({
             le() ? (console.log("🎬 Playing next animation..."), Oe(S, w, H)) : (console.log("🎬 Speech ended, stopping animations"), K.current = !1, q.current = null, H && H());
           })) : (console.log("🎬 Speech has ended, stopping animations"), K.current = !1, q.current = null, H && H());
         };
-        return f.current.playAnimation(J, null, 0, 0, 0.01, w, ie), J;
+        return f.current.playAnimation($, null, 0, 0, 0.01, w, ie), $;
       } catch (W) {
         return console.error("Failed to play animation:", W), null;
       }
@@ -7805,8 +7805,8 @@ const Nt = Ke(({
       const W = () => {
         if (!f.current || !K.current || q.current !== S)
           return !1;
-        const le = f.current, ce = le.isAudioPlaying === !0, j = le.audioPlaylist && le.audioPlaylist.length > 0, $ = le.speechQueue && le.speechQueue.length > 0;
-        return le.isSpeaking === !0 || ce || j || $;
+        const le = f.current, ce = le.isAudioPlaying === !0, j = le.audioPlaylist && le.audioPlaylist.length > 0, J = le.speechQueue && le.speechQueue.length > 0;
+        return le.isSpeaking === !0 || ce || j || J;
       };
       W() && (Ie.current = [], fe.current = [], W() ? Oe(S, w, H) : (K.current = !1, q.current = null));
     }
@@ -7823,8 +7823,8 @@ const Nt = Ke(({
       console.warn("Error in onSpeechStart callback:", ie);
     }
     Q.current = { remainingText: null, originalText: null, options: null }, _.current = [], I.current = { text: S, options: w }, F.current && (clearInterval(F.current), F.current = null), v(!1), B.current = !1, te.current = !1;
-    const J = S.split(/[.!?]+/).filter((ie) => ie.trim().length > 0);
-    _.current = J, et.current = 0;
+    const $ = S.split(/[.!?]+/).filter((ie) => ie.trim().length > 0);
+    _.current = $, et.current = 0;
     const W = {
       lipsyncLang: w.lipsyncLang || "en"
     };
@@ -7833,11 +7833,11 @@ const Nt = Ke(({
       let le = 0;
       const ce = 1200;
       F.current && (clearInterval(F.current), F.current = null);
-      const j = { current: !1 }, $ = setInterval(() => {
+      const j = { current: !1 }, J = setInterval(() => {
         if (le++, B.current)
           return;
         if (le > ce) {
-          if ($ && (clearInterval($), F.current = null), !j.current && !B.current) {
+          if (J && (clearInterval(J), F.current = null), !j.current && !B.current) {
             j.current = !0, K.current = !1, q.current = null, Ie.current = [], fe.current = [], f.current && (f.current.isSpeaking = !1);
             try {
               w.onSpeechEnd && w.onSpeechEnd(), x();
@@ -7852,7 +7852,7 @@ const Nt = Ke(({
           const Te = f.current;
           if (!Te)
             return;
-          !B.current && (!Te.speechQueue || Te.speechQueue.length === 0) && (!Te.audioPlaylist || Te.audioPlaylist.length === 0) && Te.isAudioPlaying === !1 && Te.isSpeaking === !1 && !j.current && !B.current && (j.current = !0, $ && (clearInterval($), F.current = null), K.current = !1, q.current = null, Ie.current = [], fe.current = [], te.current = !0, Te && (Te.isSpeaking = !1), setTimeout(() => {
+          !B.current && (!Te.speechQueue || Te.speechQueue.length === 0) && (!Te.audioPlaylist || Te.audioPlaylist.length === 0) && Te.isAudioPlaying === !1 && Te.isSpeaking === !1 && !j.current && !B.current && (j.current = !0, J && (clearInterval(J), F.current = null), K.current = !1, q.current = null, Ie.current = [], fe.current = [], te.current = !0, Te && (Te.isSpeaking = !1), setTimeout(() => {
             try {
               w.onSpeechEnd && w.onSpeechEnd(), x(), setTimeout(() => {
                 te.current = !1;
@@ -7863,7 +7863,7 @@ const Nt = Ke(({
           }, 100));
         }, 200);
       }, 50);
-      F.current = $;
+      F.current = J;
     }
     try {
       f.current.speakText(S, W);
@@ -7892,12 +7892,12 @@ const Nt = Ke(({
         const S = f.current.isSpeaking || !1, w = [...f.current.audioPlaylist || []], H = [...f.current.speechQueue || []];
         if (S || w.length > 0 || H.length > 0) {
           F.current && (clearInterval(F.current), F.current = null);
-          const J = _.current;
+          const $ = _.current;
           let W = [];
           const ie = f.current.isAudioPlaying || !1;
-          if (J.length > 0) {
-            const ee = w.length + H.length, ge = ie ? 1 : 0, de = J.length - ee - ge, Ge = ie ? de : de + ge;
-            Ge < J.length && (W = J.slice(Ge));
+          if ($.length > 0) {
+            const ee = w.length + H.length, ge = ie ? 1 : 0, de = $.length - ee - ge, Ge = ie ? de : de + ge;
+            Ge < $.length && (W = $.slice(Ge));
           } else
             w.length > 0 && w.forEach((ee) => {
               if (ee.text)
@@ -7922,8 +7922,8 @@ const Nt = Ke(({
           };
           const j = f.current.isAudioPlaying || !1 ? [...f.current.speechQueue || []] : null;
           f.current.speechQueue.length = 0;
-          const $ = f.current.pauseSpeaking();
-          f.current.isSpeaking = !1, K.current = !1, q.current = null, $ && $.audio && j ? (ke.current = $, ke.current.savedSpeechQueue = j) : ke.current = $, v(!0), B.current = !0;
+          const J = f.current.pauseSpeaking();
+          f.current.isSpeaking = !1, K.current = !1, q.current = null, J && J.audio && j ? (ke.current = J, ke.current.savedSpeechQueue = j) : ke.current = J, v(!0), B.current = !0;
         }
       } catch (S) {
         console.warn("Error pausing speech:", S);
@@ -7937,14 +7937,14 @@ const Nt = Ke(({
           if (ie && (q.current = ie), ke.current.savedSpeechQueue && (f.current.speechQueue.length = 0, f.current.speechQueue.push(...ke.current.savedSpeechQueue)), f.current.isSpeaking = !0, f.current) {
             const le = f.current;
             let ce = 0;
-            const j = 1200, $ = { current: !1 };
+            const j = 1200, J = { current: !1 };
             F.current && (clearInterval(F.current), F.current = null);
             const ee = setInterval(() => {
               if (ce++, B.current)
                 return;
               if (ce > j) {
-                if (ee && (clearInterval(ee), F.current = null), !$.current && !B.current) {
-                  $.current = !0, K.current = !1, q.current = null, Ie.current = [], fe.current = [], f.current && (f.current.isSpeaking = !1);
+                if (ee && (clearInterval(ee), F.current = null), !J.current && !B.current) {
+                  J.current = !0, K.current = !1, q.current = null, Ie.current = [], fe.current = [], f.current && (f.current.isSpeaking = !1);
                   try {
                     W.onSpeechEnd && W.onSpeechEnd(), x();
                   } catch (Me) {
@@ -7954,10 +7954,10 @@ const Nt = Ke(({
                 return;
               }
               const ge = !le.speechQueue || le.speechQueue.length === 0, de = !le.audioPlaylist || le.audioPlaylist.length === 0, Ge = le.isAudioPlaying === !1;
-              le && !B.current && ge && de && Ge && le.isSpeaking === !1 && !$.current && !B.current && setTimeout(() => {
+              le && !B.current && ge && de && Ge && le.isSpeaking === !1 && !J.current && !B.current && setTimeout(() => {
                 const Me = f.current;
                 if (!Me) return;
-                !B.current && (!Me.speechQueue || Me.speechQueue.length === 0) && (!Me.audioPlaylist || Me.audioPlaylist.length === 0) && Me.isAudioPlaying === !1 && Me.isSpeaking === !1 && !$.current && !B.current && ($.current = !0, ee && (clearInterval(ee), F.current = null), K.current = !1, q.current = null, Ie.current = [], fe.current = [], te.current = !0, Me && (Me.isSpeaking = !1), setTimeout(() => {
+                !B.current && (!Me.speechQueue || Me.speechQueue.length === 0) && (!Me.audioPlaylist || Me.audioPlaylist.length === 0) && Me.isAudioPlaying === !1 && Me.isSpeaking === !1 && !J.current && !B.current && (J.current = !0, ee && (clearInterval(ee), F.current = null), K.current = !1, q.current = null, Ie.current = [], fe.current = [], te.current = !0, Me && (Me.isSpeaking = !1), setTimeout(() => {
                   try {
                     W.onSpeechEnd && W.onSpeechEnd(), x(), setTimeout(() => {
                       te.current = !1;
@@ -7973,8 +7973,8 @@ const Nt = Ke(({
           await f.current.playAudio(!1, ke.current), ie && !W.skipAnimation && (Ie.current = [], fe.current = [], Oe(ie)), ke.current = null;
           return;
         }
-        const S = Q.current?.remainingText, w = Q.current?.originalText || I.current?.text, H = Q.current?.options || I.current?.options || {}, J = S || w;
-        J && Ve(J, H), ke.current = null;
+        const S = Q.current?.remainingText, w = Q.current?.originalText || I.current?.text, H = Q.current?.options || I.current?.options || {}, $ = S || w;
+        $ && Ve($, H), ke.current = null;
       } catch (S) {
         console.warn("Error resuming speech:", S), v(!1), B.current = !1, ke.current = null;
       }
@@ -7988,7 +7988,7 @@ const Nt = Ke(({
       }
     }
   }, [x]);
-  return Je(P, () => ({
+  return $e(P, () => ({
     speakText: Ve,
     pauseSpeaking: tt,
     resumeSpeaking: ht,
@@ -8537,7 +8537,7 @@ const Ut = Ke(({
   }, [u, y]);
   pt(() => {
     d.current = Q, g.current = B, R.current = f, x.current = F, k.current = M, G.current = I, m.current = _;
-  }), Je(l, () => ({
+  }), $e(l, () => ({
     // Curriculum control methods
     startTeaching: Q,
     startQuestions: I,
@@ -9029,7 +9029,7 @@ const ut = {
     duration: 5e3,
     description: "Excited, energetic movement"
   }
-}, Kt = (Z) => ut[Z] || null, Jt = (Z) => ut.hasOwnProperty(Z);
+}, Kt = (Z) => ut[Z] || null, $t = (Z) => ut.hasOwnProperty(Z);
 export {
   _t as AnimationSelector,
   Ut as CurriculumLearning,
@@ -9037,8 +9037,8 @@ export {
   ct as TalkingHeadAvatar,
   Ot as TalkingHeadComponent,
   ut as animations,
-  $e as getActiveTTSConfig,
+  Je as getActiveTTSConfig,
   Kt as getAnimation,
   qt as getVoiceOptions,
-  Jt as hasAnimation
+  $t as hasAnimation
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sage-rsc/talking-head-react",
-  "version": "1.8.2",
+  "version": "1.8.4",
   "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

@@ -3174,15 +3174,20 @@ class TalkingHead {
       
       // Manually check if current FBX animation has finished (backup to mixer 'finished' event)
       // This ensures the callback fires reliably even if the mixer event doesn't
-      if (this.currentFBXActionForCallback && this.currentFBXActionForCallback.isRunning() && this.currentFBXActionClipDuration) {
-        const actionTime = this.currentFBXActionForCallback.time;
+      if (this.currentFBXActionForCallback && this.currentFBXActionClipDuration) {
+        const action = this.currentFBXActionForCallback;
+        const actionTime = action.time;
         const clipDuration = this.currentFBXActionClipDuration;
         
-        // For LoopOnce, action.time goes from 0 to clipDuration
-        // Check if animation has reached the end (with small tolerance for timing)
-        // Also check if action is paused (time doesn't advance when paused)
-        if (actionTime >= clipDuration - 0.05 || (actionTime > 0 && !this.currentFBXActionForCallback.paused && actionTime >= clipDuration - 0.1)) {
+        // Check if animation is no longer running (finished or stopped)
+        // For LoopOnce with clampWhenFinished, the action stops when it reaches the end
+        const isFinished = !action.isRunning() || 
+                          (actionTime >= clipDuration - 0.1) ||
+                          (action.getEffectiveTimeScale() === 0 && actionTime > 0);
+        
+        if (isFinished) {
           // Animation finished - call callback manually
+          console.log(`🎬 Manual check: Animation finished (time: ${actionTime.toFixed(3)}/${clipDuration.toFixed(3)}, running: ${action.isRunning()})`);
           if (this.currentFBXActionCallback) {
             this.currentFBXActionCallback();
             this.currentFBXActionCallback = null;
@@ -5570,25 +5575,29 @@ class TalkingHead {
       
       // Create handler that calls callback before stopping
       const finishedHandler = () => {
+        console.log(`🎬 Mixer 'finished' event fired for animation: ${url}`);
         if (this.animationFinishedCallback) {
           this.animationFinishedCallback();
           this.animationFinishedCallback = null;
         }
-        this.stopAnimation();
+        // Don't call stopAnimation() here - let the callback handle continuation
+        // The callback will decide whether to play next animation or stop
       };
-      
+
       // Play action with error handling
       // If dur is 0 or negative, play animation once (use clip's natural duration)
       const action = this.mixer.clipAction(item.clip);
       if (dur <= 0) {
         // Play once - use LoopOnce to ensure finished event fires
         action.setLoop( THREE.LoopOnce, 1 );
+        console.log(`🎬 Setting animation to LoopOnce, duration: ${item.clip.duration.toFixed(3)}s`);
       } else {
         // Play for specified duration
         const repeat = Math.ceil(dur / item.clip.duration);
-        action.setLoop( THREE.LoopRepeat, repeat );
+      action.setLoop( THREE.LoopRepeat, repeat );
       }
       action.clampWhenFinished = true;
+      action.time = 0; // Reset to start
       
       // Set up callback to check when animation finishes
       // Use both mixer 'finished' event and manual time checking for reliability