@sage-rsc/talking-head-react 1.0.54 → 1.0.56

package/dist/index.js

@@ -2629,7 +2629,7 @@ const $e = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   fr: qe,
   fi: Ke,
   lt: $e
-}, U = new f.Quaternion(), E = new f.Euler(), te = new f.Vector3(), ie = new f.Vector3(), Ae = new f.Box3();
+}, W = new f.Quaternion(), E = new f.Euler(), te = new f.Vector3(), ie = new f.Vector3(), Ae = new f.Box3();
 new f.Matrix4();
 new f.Matrix4();
 new f.Vector3();
@@ -2712,8 +2712,8 @@ class we {
       ttsVoice: "fi-FI-Standard-A",
       ttsRate: 1,
       ttsPitch: 0,
-      ttsVolume: 0,
-      mixerGainSpeech: null,
+      ttsVolume: 0.3,
+      mixerGainSpeech: 1.2,
       mixerGainBackground: null,
       lipsyncLang: "fi",
       lipsyncModules: ["fi", "en", "lt"],
@@ -4376,7 +4376,7 @@ class we {
       if (e.x === 0 && e.y === 0 && e.z === 0) continue;
       E.set(e.x, e.y, e.z);
       const i = this.poseAvatar.props[t];
-      i.isQuaternion ? (U.setFromEuler(E), i.multiply(U)) : i.isVector3 && i.add(E);
+      i.isQuaternion ? (W.setFromEuler(E), i.multiply(W)) : i.isVector3 && i.add(E);
     }
   }
   /**
@@ -5180,7 +5180,7 @@ class we {
         eyeLookOutRight: [null, 0],
         eyeContact: [0]
       }
-    })))), e > 2 * this.animFrameDur && (e = 2 * this.animFrameDur), (this.viewName !== "full" || this.isAvatarOnly) && (i = this.mtRandomized[Math.floor(Math.random() * this.mtRandomized.length)], n = this.mtAvatar[i], n.needsUpdate || Object.assign(n, { base: (this.mood.baseline[i] || 0) + (1 + l / 255) * Math.random() / 5, needsUpdate: !0 })), this.updatePoseBase(this.animClock), this.mixer && this.mixer.update(e / 1e3 * this.mixer.timeScale), this.updatePoseDelta(), (this.isSpeaking || this.isListening) && u ? l > this.volumeMax ? (this.volumeHeadBase = 0.05, Math.random() > 0.6 && (this.volumeHeadTarget = -0.05 - Math.random() / 15), this.volumeMax = l) : (this.volumeMax *= 0.92, this.volumeHeadTarget = this.volumeHeadBase - 0.9 * (this.volumeHeadBase - this.volumeHeadTarget)) : (this.volumeHeadTarget = 0, this.volumeMax = 0), i = this.volumeHeadTarget - this.volumeHeadCurrent, n = Math.abs(i), n > 1e-4 && (o = n * (this.volumeHeadEasing(Math.min(1, this.volumeHeadVelocity * e / 1e3 / n) / 2 + 0.5) - 0.5), this.volumeHeadCurrent += Math.sign(i) * Math.min(n, o)), Math.abs(this.volumeHeadCurrent) > 1e-4 && (U.setFromAxisAngle(tt, this.volumeHeadCurrent), this.objectNeck.quaternion.multiply(U)), Ae.setFromObject(this.armature), this.objectLeftToeBase.getWorldPosition(te), te.sub(this.armature.position), this.objectRightToeBase.getWorldPosition(ie), ie.sub(this.armature.position), this.objectHips.position.y -= Ae.min.y / 2, this.objectHips.position.x -= (te.x + ie.x) / 4, this.objectHips.position.z -= (te.z + ie.z) / 2, this.dynamicbones.update(e), this.fbxAnimationLoader && this.fbxAnimationLoader.update(), this.opt.update && this.opt.update(e), this.updateMorphTargets(e), this.isAvatarOnly)
+    })))), e > 2 * this.animFrameDur && (e = 2 * this.animFrameDur), (this.viewName !== "full" || this.isAvatarOnly) && (i = this.mtRandomized[Math.floor(Math.random() * this.mtRandomized.length)], n = this.mtAvatar[i], n.needsUpdate || Object.assign(n, { base: (this.mood.baseline[i] || 0) + (1 + l / 255) * Math.random() / 5, needsUpdate: !0 })), this.updatePoseBase(this.animClock), this.mixer && this.mixer.update(e / 1e3 * this.mixer.timeScale), this.updatePoseDelta(), (this.isSpeaking || this.isListening) && u ? l > this.volumeMax ? (this.volumeHeadBase = 0.05, Math.random() > 0.6 && (this.volumeHeadTarget = -0.05 - Math.random() / 15), this.volumeMax = l) : (this.volumeMax *= 0.92, this.volumeHeadTarget = this.volumeHeadBase - 0.9 * (this.volumeHeadBase - this.volumeHeadTarget)) : (this.volumeHeadTarget = 0, this.volumeMax = 0), i = this.volumeHeadTarget - this.volumeHeadCurrent, n = Math.abs(i), n > 1e-4 && (o = n * (this.volumeHeadEasing(Math.min(1, this.volumeHeadVelocity * e / 1e3 / n) / 2 + 0.5) - 0.5), this.volumeHeadCurrent += Math.sign(i) * Math.min(n, o)), Math.abs(this.volumeHeadCurrent) > 1e-4 && (W.setFromAxisAngle(tt, this.volumeHeadCurrent), this.objectNeck.quaternion.multiply(W)), Ae.setFromObject(this.armature), this.objectLeftToeBase.getWorldPosition(te), te.sub(this.armature.position), this.objectRightToeBase.getWorldPosition(ie), ie.sub(this.armature.position), this.objectHips.position.y -= Ae.min.y / 2, this.objectHips.position.x -= (te.x + ie.x) / 4, this.objectHips.position.z -= (te.z + ie.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();
     else {
       if (this.cameraClock !== null && this.cameraClock < 1e3) {
@@ -6146,10 +6146,10 @@ class we {
       this.lookAt(null, null, t);
       return;
     }
-    this.objectLeftEye.updateMatrixWorld(!0), this.objectRightEye.updateMatrixWorld(!0), te.setFromMatrixPosition(this.objectLeftEye.matrixWorld), ie.setFromMatrixPosition(this.objectRightEye.matrixWorld), te.add(ie).divideScalar(2), U.copy(this.armature.quaternion), U.multiply(this.poseTarget.props["Hips.quaternion"]), U.multiply(this.poseTarget.props["Spine.quaternion"]), U.multiply(this.poseTarget.props["Spine1.quaternion"]), U.multiply(this.poseTarget.props["Spine2.quaternion"]), U.multiply(this.poseTarget.props["Neck.quaternion"]), U.multiply(this.poseTarget.props["Head.quaternion"]);
+    this.objectLeftEye.updateMatrixWorld(!0), this.objectRightEye.updateMatrixWorld(!0), te.setFromMatrixPosition(this.objectLeftEye.matrixWorld), ie.setFromMatrixPosition(this.objectRightEye.matrixWorld), te.add(ie).divideScalar(2), W.copy(this.armature.quaternion), W.multiply(this.poseTarget.props["Hips.quaternion"]), W.multiply(this.poseTarget.props["Spine.quaternion"]), W.multiply(this.poseTarget.props["Spine1.quaternion"]), W.multiply(this.poseTarget.props["Spine2.quaternion"]), W.multiply(this.poseTarget.props["Neck.quaternion"]), W.multiply(this.poseTarget.props["Head.quaternion"]);
     const i = new f.Vector3().subVectors(e, te).normalize(), n = Math.atan2(i.x, i.z), s = Math.asin(-i.y);
     E.set(s, n, 0, "YXZ");
-    const l = new f.Quaternion().setFromEuler(E), u = new f.Quaternion().copy(l).multiply(U.clone().invert());
+    const l = new f.Quaternion().setFromEuler(E), u = new f.Quaternion().copy(l).multiply(W.clone().invert());
     E.setFromQuaternion(u, "YXZ");
     let a = E.x / (40 / 24) + 0.2, h = E.y / (9 / 4), r = Math.min(0.6, Math.max(-0.3, a)), d = Math.min(0.8, Math.max(-0.8, h)), c = (Math.random() - 0.5) / 4, g = (Math.random() - 0.5) / 4;
     if (t) {
@@ -6186,7 +6186,7 @@ class we {
     const s = new f.Vector3().setFromMatrixPosition(this.objectLeftEye.matrixWorld), o = new f.Vector3().setFromMatrixPosition(this.objectRightEye.matrixWorld), l = new f.Vector3().addVectors(s, o).divideScalar(2);
     l.project(this.camera);
     let u = (l.x + 1) / 2 * n.width + n.left, a = -(l.y - 1) / 2 * n.height + n.top;
-    t === null && (t = u), e === null && (e = a), U.copy(this.armature.quaternion), U.multiply(this.poseTarget.props["Hips.quaternion"]), U.multiply(this.poseTarget.props["Spine.quaternion"]), U.multiply(this.poseTarget.props["Spine1.quaternion"]), U.multiply(this.poseTarget.props["Spine2.quaternion"]), U.multiply(this.poseTarget.props["Neck.quaternion"]), U.multiply(this.poseTarget.props["Head.quaternion"]), E.setFromQuaternion(U);
+    t === null && (t = u), e === null && (e = a), W.copy(this.armature.quaternion), W.multiply(this.poseTarget.props["Hips.quaternion"]), W.multiply(this.poseTarget.props["Spine.quaternion"]), W.multiply(this.poseTarget.props["Spine1.quaternion"]), W.multiply(this.poseTarget.props["Spine2.quaternion"]), W.multiply(this.poseTarget.props["Neck.quaternion"]), W.multiply(this.poseTarget.props["Head.quaternion"]), E.setFromQuaternion(W);
     let h = E.x / (40 / 24), r = E.y / (9 / 4), d = Math.min(0.4, Math.max(-0.4, this.camera.rotation.x)), c = Math.min(0.4, Math.max(-0.4, this.camera.rotation.y)), g = Math.max(window.innerWidth - u, u), y = Math.max(window.innerHeight - a, a), x = this.convertRange(e, [a - y, a + y], [-0.3, 0.6]) - h + d, L = this.convertRange(t, [u - g, u + g], [-0.8, 0.8]) - r + c;
     x = Math.min(0.6, Math.max(-0.3, x)), L = Math.min(0.8, Math.max(-0.8, L));
     let F = (Math.random() - 0.5) / 4, p = (Math.random() - 0.5) / 4;
@@ -6582,7 +6582,7 @@ class we {
           const T = y[p].bone;
           T.matrixWorld.decompose(u, a, h), a.invert(), o.setFromMatrixPosition(g.matrixWorld), l.subVectors(o, u), l.applyQuaternion(a), l.normalize(), s.subVectors(e, u), s.applyQuaternion(a), s.normalize();
           let I = s.dot(l);
-          I > 1 ? I = 1 : I < -1 && (I = -1), I = Math.acos(I), !(I < 1e-5) && (y[p].minAngle !== void 0 && I < y[p].minAngle && (I = y[p].minAngle), y[p].maxAngle !== void 0 && I > y[p].maxAngle && (I = y[p].maxAngle), r.crossVectors(l, s), r.normalize(), U.setFromAxisAngle(r, I), T.quaternion.multiply(U), T.rotation.setFromVector3(d.setFromEuler(T.rotation).clamp(new f.Vector3(
+          I > 1 ? I = 1 : I < -1 && (I = -1), I = Math.acos(I), !(I < 1e-5) && (y[p].minAngle !== void 0 && I < y[p].minAngle && (I = y[p].minAngle), y[p].maxAngle !== void 0 && I > y[p].maxAngle && (I = y[p].maxAngle), r.crossVectors(l, s), r.normalize(), W.setFromAxisAngle(r, I), T.quaternion.multiply(W), T.rotation.setFromVector3(d.setFromEuler(T.rotation).clamp(new f.Vector3(
             y[p].minx !== void 0 ? y[p].minx : -1 / 0,
             y[p].miny !== void 0 ? y[p].miny : -1 / 0,
             y[p].minz !== void 0 ? y[p].minz : -1 / 0
@@ -6713,7 +6713,7 @@ const ze = fe(({
     // Override API key if provided via props
     apiKey: o !== null ? o : S.apiKey
   };
-  const W = {
+  const V = {
     url: N,
     body: t,
     avatarMood: e,
@@ -6732,7 +6732,7 @@ const ze = fe(({
   }, K = M(async () => {
     if (!(!F.current || p.current))
       try {
-        if (I(!0), D(null), p.current = new we(F.current, _), p.current.controls && (p.current.controls.enableRotate = !1, p.current.controls.enableZoom = !1, p.current.controls.enablePan = !1, p.current.controls.enableDamping = !1), x && Object.keys(x).length > 0 && (p.current.customAnimations = x), await p.current.showAvatar(W, (z) => {
+        if (I(!0), D(null), p.current = new we(F.current, _), p.current.controls && (p.current.controls.enableRotate = !1, p.current.controls.enableZoom = !1, p.current.controls.enablePan = !1, p.current.controls.enableDamping = !1), x && Object.keys(x).length > 0 && (p.current.customAnimations = x), await p.current.showAvatar(V, (z) => {
           if (z.lengthComputable) {
             const C = Math.min(100, Math.round(z.loaded / z.total * 100));
             d(C);
@@ -6788,16 +6788,16 @@ const ze = fe(({
         await se();
         const z = {
           ...k,
-          lipsyncLang: k.lipsyncLang || W.lipsyncLang || "en"
+          lipsyncLang: k.lipsyncLang || V.lipsyncLang || "en"
         };
         if (k.onSpeechEnd && p.current) {
           const C = p.current;
-          let V = null, J = 0;
+          let U = null, J = 0;
           const ye = 1200;
           let he = !1;
-          V = setInterval(() => {
+          U = setInterval(() => {
             if (J++, J > ye) {
-              if (V && (clearInterval(V), V = null), !he) {
+              if (U && (clearInterval(U), U = null), !he) {
                 he = !0;
                 try {
                   k.onSpeechEnd();
@@ -6810,7 +6810,7 @@ const ze = fe(({
             const He = !C.speechQueue || C.speechQueue.length === 0, Te = !C.audioPlaylist || C.audioPlaylist.length === 0;
             C && C.isSpeaking === !1 && He && Te && C.isAudioPlaying === !1 && !he && setTimeout(() => {
               if (C && C.isSpeaking === !1 && (!C.speechQueue || C.speechQueue.length === 0) && (!C.audioPlaylist || C.audioPlaylist.length === 0) && C.isAudioPlaying === !1 && !he) {
-                he = !0, V && (clearInterval(V), V = null);
+                he = !0, U && (clearInterval(U), U = null);
                 try {
                   k.onSpeechEnd();
                 } catch (Me) {
@@ -6826,7 +6826,7 @@ const ze = fe(({
       } catch (z) {
         console.error("Error speaking text:", z), D(z.message || "Failed to speak text");
       }
-  }, [Y, se, W.lipsyncLang]), ue = M(() => {
+  }, [Y, se, V.lipsyncLang]), ue = M(() => {
     p.current && (p.current.stopSpeaking(), p.current.setSlowdownRate && p.current.setSlowdownRate(1));
   }, []), ge = M((v) => {
     p.current && p.current.setMood(v);
@@ -6847,20 +6847,20 @@ const ze = fe(({
           console.warn(`Failed to play ${v}:`, C);
           try {
             p.current.setBodyMovement("idle");
-          } catch (V) {
-            console.warn("Fallback animation also failed:", V);
+          } catch (U) {
+            console.warn("Fallback animation also failed:", U);
           }
         }
       else {
         const C = [".fbx", ".glb", ".gltf"];
-        let V = !1;
+        let U = !1;
         for (const J of C)
           try {
-            p.current.playAnimation(v + J, null, 10, 0, 0.01, k), V = !0;
+            p.current.playAnimation(v + J, null, 10, 0, 0.01, k), U = !0;
             break;
           } catch {
           }
-        if (!V) {
+        if (!U) {
           console.warn("Animation not found:", v);
           try {
             p.current.setBodyMovement("idle");
@@ -7036,20 +7036,20 @@ const it = fe(({
       try {
         if (r(!0), c(null), a.current = new we(u.current, H), await a.current.showAvatar(p, (O) => {
           if (O.lengthComputable) {
-            const W = Math.min(100, Math.round(O.loaded / O.total * 100));
-            t(W);
+            const V = Math.min(100, Math.round(O.loaded / O.total * 100));
+            t(V);
           }
         }), a.current.morphs && a.current.morphs.length > 0) {
           const O = a.current.morphs[0].morphTargetDictionary;
           console.log("Available morph targets:", Object.keys(O));
-          const W = Object.keys(O).filter((_) => _.startsWith("viseme_"));
-          console.log("Viseme morph targets found:", W), W.length === 0 && (console.warn("No viseme morph targets found! Lip-sync will not work properly."), console.log("Expected viseme targets: viseme_aa, viseme_E, viseme_I, viseme_O, viseme_U, viseme_PP, viseme_SS, viseme_TH, viseme_DD, viseme_FF, viseme_kk, viseme_nn, viseme_RR, viseme_CH, viseme_sil"));
+          const V = Object.keys(O).filter((_) => _.startsWith("viseme_"));
+          console.log("Viseme morph targets found:", V), V.length === 0 && (console.warn("No viseme morph targets found! Lip-sync will not work properly."), console.log("Expected viseme targets: viseme_aa, viseme_E, viseme_I, viseme_O, viseme_U, viseme_PP, viseme_SS, viseme_TH, viseme_DD, viseme_FF, viseme_kk, viseme_nn, viseme_RR, viseme_CH, viseme_sil"));
         }
         if (await new Promise((O) => {
-          const W = () => {
-            a.current.lipsync && Object.keys(a.current.lipsync).length > 0 ? (console.log("Lip-sync modules loaded:", Object.keys(a.current.lipsync)), O()) : (console.log("Waiting for lip-sync modules to load..."), setTimeout(W, 100));
+          const V = () => {
+            a.current.lipsync && Object.keys(a.current.lipsync).length > 0 ? (console.log("Lip-sync modules loaded:", Object.keys(a.current.lipsync)), O()) : (console.log("Waiting for lip-sync modules to load..."), setTimeout(V, 100));
           };
-          W();
+          V();
         }), a.current && a.current.setShowFullAvatar)
           try {
             a.current.setShowFullAvatar(!0), console.log("Avatar initialized in full body mode");
@@ -7092,14 +7092,14 @@ const it = fe(({
       if (a.current.setShowFullAvatar)
         try {
           a.current.setShowFullAvatar(!0);
-        } catch (W) {
-          console.warn("Error setting full body mode:", W);
+        } catch (V) {
+          console.warn("Error setting full body mode:", V);
         }
       if (S.includes("."))
         try {
           a.current.playAnimation(S, null, 10, 0, 0.01, P), console.log("Playing animation:", S);
-        } catch (W) {
-          console.log(`Failed to play ${S}:`, W);
+        } catch (V) {
+          console.log(`Failed to play ${S}:`, V);
           try {
             a.current.setBodyMovement("idle"), console.log("Fallback to idle animation");
           } catch (_) {
@@ -7107,9 +7107,9 @@ const it = fe(({
           }
         }
       else {
-        const W = [".fbx", ".glb", ".gltf"];
+        const V = [".fbx", ".glb", ".gltf"];
         let _ = !1;
-        for (const K of W)
+        for (const K of V)
           try {
             a.current.playAnimation(S + K, null, 10, 0, 0.01, P), console.log("Playing animation:", S + K), _ = !0;
             break;
@@ -7334,7 +7334,7 @@ const nt = fe(({
         } catch {
           h.current.playCelebration();
         }
-      const v = H.current || { modules: [] }, k = v.modules[r.current.currentModuleIndex], z = r.current.currentLessonIndex < (k?.lessons?.length || 0) - 1, C = r.current.currentModuleIndex < (v.modules?.length || 0) - 1, V = z || C, J = T.current || { lipsyncLang: "en" };
+      const v = H.current || { modules: [] }, k = v.modules[r.current.currentModuleIndex], z = r.current.currentLessonIndex < (k?.lessons?.length || 0) - 1, C = r.current.currentModuleIndex < (v.modules?.length || 0) - 1, U = z || C, J = T.current || { lipsyncLang: "en" };
       h.current.speakText(R, {
         lipsyncLang: J.lipsyncLang,
         onSpeechEnd: () => {
@@ -7345,7 +7345,7 @@ const nt = fe(({
             score: r.current.score,
             totalQuestions: r.current.totalQuestions,
             percentage: b,
-            hasNextLesson: V
+            hasNextLesson: U
           });
         }
       });
@@ -7368,7 +7368,7 @@ const nt = fe(({
     }
   }, [e.curriculumComplete]), S = M(() => {
     const b = I();
-    r.current.isQuestionMode = !0, r.current.currentQuestionIndex = 0, r.current.totalQuestions = b?.questions?.length || 0;
+    r.current.isQuestionMode = !0, r.current.currentQuestionIndex = 0, r.current.totalQuestions = b?.questions?.length || 0, r.current.score = 0;
     const R = B();
     R && d.current.onCustomAction({
       type: "questionStart",
@@ -7376,7 +7376,8 @@ const nt = fe(({
       lessonIndex: r.current.currentLessonIndex,
       questionIndex: r.current.currentQuestionIndex,
       totalQuestions: r.current.totalQuestions,
-      question: R
+      question: R,
+      score: r.current.score
     });
     const v = () => {
       if (!h.current || !R) return;
@@ -7405,7 +7406,7 @@ const nt = fe(({
   }, [e.questionStart, I, B]), P = M(() => {
     const b = I();
     if (r.current.currentQuestionIndex < (b?.questions?.length || 0) - 1) {
-      r.current.currentQuestionIndex += 1;
+      h.current && h.current.stopSpeaking && h.current.stopSpeaking(), r.current.currentQuestionIndex += 1;
       const R = B();
       R && d.current.onCustomAction({
         type: "nextQuestion",
@@ -7413,7 +7414,8 @@ const nt = fe(({
         lessonIndex: r.current.currentLessonIndex,
         questionIndex: r.current.currentQuestionIndex,
         totalQuestions: r.current.totalQuestions,
-        question: R
+        question: R,
+        score: r.current.score
       });
       const v = () => {
         if (!h.current || !R) return;
@@ -7456,12 +7458,12 @@ const nt = fe(({
     const b = H.current || { modules: [] }, R = b.modules[r.current.currentModuleIndex];
     if (r.current.currentLessonIndex < (R?.lessons?.length || 0) - 1) {
       r.current.currentLessonIndex += 1, r.current.currentQuestionIndex = 0, r.current.lessonCompleted = !1, r.current.isQuestionMode = !1, r.current.isTeaching = !1, r.current.score = 0, r.current.totalQuestions = 0;
-      const k = b.modules[r.current.currentModuleIndex], z = r.current.currentLessonIndex < (k?.lessons?.length || 0) - 1, C = r.current.currentModuleIndex < (b.modules?.length || 0) - 1, V = z || C;
+      const k = b.modules[r.current.currentModuleIndex], z = r.current.currentLessonIndex < (k?.lessons?.length || 0) - 1, C = r.current.currentModuleIndex < (b.modules?.length || 0) - 1, U = z || C;
       d.current.onCustomAction({
         type: "lessonStart",
         moduleIndex: r.current.currentModuleIndex,
         lessonIndex: r.current.currentLessonIndex,
-        hasNextLesson: V
+        hasNextLesson: U
       }), d.current.onLessonStart({
         moduleIndex: r.current.currentModuleIndex,
         lessonIndex: r.current.currentLessonIndex,
@@ -7469,7 +7471,7 @@ const nt = fe(({
       }), h.current && (h.current.setMood("happy"), h.current.setBodyMovement("idle"));
     } else if (r.current.currentModuleIndex < (b.modules?.length || 0) - 1) {
       r.current.currentModuleIndex += 1, r.current.currentLessonIndex = 0, r.current.currentQuestionIndex = 0, r.current.lessonCompleted = !1, r.current.isQuestionMode = !1, r.current.isTeaching = !1, r.current.score = 0, r.current.totalQuestions = 0;
-      const z = b.modules[r.current.currentModuleIndex], C = r.current.currentLessonIndex < (z?.lessons?.length || 0) - 1, V = r.current.currentModuleIndex < (b.modules?.length || 0) - 1, J = C || V;
+      const z = b.modules[r.current.currentModuleIndex], C = r.current.currentLessonIndex < (z?.lessons?.length || 0) - 1, U = r.current.currentModuleIndex < (b.modules?.length || 0) - 1, J = C || U;
       d.current.onCustomAction({
         type: "lessonStart",
         moduleIndex: r.current.currentModuleIndex,
@@ -7482,7 +7484,7 @@ const nt = fe(({
       }), h.current && (h.current.setMood("happy"), h.current.setBodyMovement("idle"));
     } else
       L.current && L.current();
-  }, []), W = M(() => {
+  }, []), V = M(() => {
     const b = I();
     let R = null;
     if (b?.avatar_script && b?.body) {
@@ -7491,7 +7493,7 @@ const nt = fe(({
     } else
       R = b?.avatar_script || b?.body || null;
     if (h.current && h.current.isReady && R) {
-      r.current.isTeaching = !0, r.current.isQuestionMode = !1, h.current.setMood("happy");
+      r.current.isTeaching = !0, r.current.isQuestionMode = !1, r.current.score = 0, r.current.totalQuestions = 0, h.current.setMood("happy");
       let v = !1;
       if (e.teaching)
         try {
@@ -7545,13 +7547,16 @@ const nt = fe(({
         h.current.speakText(k, {
           lipsyncLang: z.lipsyncLang,
           onSpeechEnd: () => {
+            const U = I()?.questions?.length || 0;
             d.current.onCustomAction({
               type: "answerFeedbackComplete",
               moduleIndex: r.current.currentModuleIndex,
               lessonIndex: r.current.currentLessonIndex,
               questionIndex: r.current.currentQuestionIndex,
               isCorrect: !0,
-              hasNextQuestion: r.current.currentQuestionIndex < (I()?.questions?.length || 0) - 1
+              hasNextQuestion: r.current.currentQuestionIndex < U - 1,
+              score: r.current.score,
+              totalQuestions: r.current.totalQuestions
             });
           }
         });
@@ -7567,27 +7572,34 @@ const nt = fe(({
         h.current.speakText(k, {
           lipsyncLang: z.lipsyncLang,
           onSpeechEnd: () => {
+            const U = I()?.questions?.length || 0;
             d.current.onCustomAction({
               type: "answerFeedbackComplete",
               moduleIndex: r.current.currentModuleIndex,
               lessonIndex: r.current.currentLessonIndex,
               questionIndex: r.current.currentQuestionIndex,
               isCorrect: !1,
-              hasNextQuestion: r.current.currentQuestionIndex < (I()?.questions?.length || 0) - 1
+              hasNextQuestion: r.current.currentQuestionIndex < U - 1,
+              score: r.current.score,
+              totalQuestions: r.current.totalQuestions
             });
           }
         });
       }
-    else
+    else {
+      const z = I()?.questions?.length || 0;
       d.current.onCustomAction({
         type: "answerFeedbackComplete",
         moduleIndex: r.current.currentModuleIndex,
         lessonIndex: r.current.currentLessonIndex,
         questionIndex: r.current.currentQuestionIndex,
         isCorrect: v,
-        hasNextQuestion: r.current.currentQuestionIndex < (I()?.questions?.length || 0) - 1,
+        hasNextQuestion: r.current.currentQuestionIndex < z - 1,
+        score: r.current.score,
+        totalQuestions: r.current.totalQuestions,
         avatarNotReady: !0
       });
+    }
   }, [e.correct, e.incorrect, B, I, D]), K = M((b) => {
     const R = B();
     if (!b || typeof b != "object") {
@@ -7626,7 +7638,8 @@ const nt = fe(({
         lessonIndex: r.current.currentLessonIndex,
         questionIndex: r.current.currentQuestionIndex,
         totalQuestions: r.current.totalQuestions,
-        question: b
+        question: b,
+        score: r.current.score
       });
       const R = () => {
         if (!h.current || !b) return;
@@ -7683,10 +7696,10 @@ const nt = fe(({
     }, 10);
   }, [u, I]);
   Ee(() => {
-    c.current = W, g.current = O, y.current = Y, x.current = P, L.current = oe, F.current = S, p.current = _;
+    c.current = V, g.current = O, y.current = Y, x.current = P, L.current = oe, F.current = S, p.current = _;
   }), xe(a, () => ({
     // Curriculum control methods
-    startTeaching: W,
+    startTeaching: V,
     startQuestions: S,
     handleAnswerSelect: _,
     handleCodeTestResult: K,
@@ -7747,7 +7760,7 @@ const nt = fe(({
     handleResize: () => h.current?.handleResize(),
     // Avatar readiness check (always returns current value)
     isAvatarReady: () => h.current?.isReady || !1
-  }), [W, S, _, K, P, O, Y, oe, ue, B, I]);
+  }), [V, S, _, K, P, O, Y, oe, ue, B, I]);
   const Q = T.current || {
     avatarUrl: "/avatars/brunette.glb",
     avatarBody: "F",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sage-rsc/talking-head-react",
-  "version": "1.0.54",
+  "version": "1.0.56",
   "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/components/CurriculumLearning.jsx

@@ -284,6 +284,8 @@ const CurriculumLearning = forwardRef(({
     stateRef.current.isQuestionMode = true;
     stateRef.current.currentQuestionIndex = 0;
     stateRef.current.totalQuestions = currentLesson?.questions?.length || 0;
+    // Reset score when starting questions for a lesson
+    stateRef.current.score = 0;
       
     // Trigger custom action IMMEDIATELY for UI to show the first question
     const firstQuestion = getCurrentQuestion();
@@ -293,10 +295,11 @@ const CurriculumLearning = forwardRef(({
         type: 'questionStart',
         moduleIndex: stateRef.current.currentModuleIndex,
         lessonIndex: stateRef.current.currentLessonIndex,
-        questionIndex: stateRef.current.currentQuestionIndex,
-        totalQuestions: stateRef.current.totalQuestions,
-        question: firstQuestion
-      });
+          questionIndex: stateRef.current.currentQuestionIndex,
+          totalQuestions: stateRef.current.totalQuestions,
+          question: firstQuestion,
+          score: stateRef.current.score
+        });
     }
       
     // Function to speak the first question
@@ -357,6 +360,11 @@ const CurriculumLearning = forwardRef(({
   const nextQuestion = useCallback(() => {
     const currentLesson = getCurrentLesson();
     if (stateRef.current.currentQuestionIndex < (currentLesson?.questions?.length || 0) - 1) {
+      // Stop any current speech/feedback before skipping to next question
+      if (avatarRef.current && avatarRef.current.stopSpeaking) {
+        avatarRef.current.stopSpeaking();
+      }
+      
       stateRef.current.currentQuestionIndex += 1;
     
       // Trigger custom action IMMEDIATELY for UI update (before avatar speaks)
@@ -369,7 +377,8 @@ const CurriculumLearning = forwardRef(({
           lessonIndex: stateRef.current.currentLessonIndex,
           questionIndex: stateRef.current.currentQuestionIndex,
           totalQuestions: stateRef.current.totalQuestions,
-          question: nextQuestionObj
+          question: nextQuestionObj,
+          score: stateRef.current.score
         });
       }
     
@@ -554,6 +563,9 @@ const CurriculumLearning = forwardRef(({
     if (avatarRef.current && avatarRef.current.isReady && teachingText) {
       stateRef.current.isTeaching = true;
       stateRef.current.isQuestionMode = false;
+      // Reset score and totalQuestions when starting a new lesson teaching
+      stateRef.current.score = 0;
+      stateRef.current.totalQuestions = 0;
       
       avatarRef.current.setMood("happy");
       
@@ -646,13 +658,17 @@ const CurriculumLearning = forwardRef(({
           lipsyncLang: config.lipsyncLang,
           onSpeechEnd: () => {
             // Notify parent that feedback is complete - parent decides next action
+            const currentLesson = getCurrentLesson();
+            const totalQuestionsInLesson = currentLesson?.questions?.length || 0;
             callbacksRef.current.onCustomAction({
               type: 'answerFeedbackComplete',
               moduleIndex: stateRef.current.currentModuleIndex,
               lessonIndex: stateRef.current.currentLessonIndex,
               questionIndex: stateRef.current.currentQuestionIndex,
               isCorrect: true,
-              hasNextQuestion: stateRef.current.currentQuestionIndex < (getCurrentLesson()?.questions?.length || 0) - 1
+              hasNextQuestion: stateRef.current.currentQuestionIndex < totalQuestionsInLesson - 1,
+              score: stateRef.current.score,
+              totalQuestions: stateRef.current.totalQuestions
             });
           }
         });
@@ -677,26 +693,34 @@ const CurriculumLearning = forwardRef(({
           lipsyncLang: config.lipsyncLang,
           onSpeechEnd: () => {
             // Notify parent that feedback is complete - parent decides next action
+            const currentLesson = getCurrentLesson();
+            const totalQuestionsInLesson = currentLesson?.questions?.length || 0;
             callbacksRef.current.onCustomAction({
               type: 'answerFeedbackComplete',
               moduleIndex: stateRef.current.currentModuleIndex,
               lessonIndex: stateRef.current.currentLessonIndex,
               questionIndex: stateRef.current.currentQuestionIndex,
               isCorrect: false,
-              hasNextQuestion: stateRef.current.currentQuestionIndex < (getCurrentLesson()?.questions?.length || 0) - 1
+              hasNextQuestion: stateRef.current.currentQuestionIndex < totalQuestionsInLesson - 1,
+              score: stateRef.current.score,
+              totalQuestions: stateRef.current.totalQuestions
             });
           }
         });
       }
     } else {
       // Avatar not ready - notify parent
+      const currentLesson = getCurrentLesson();
+      const totalQuestionsInLesson = currentLesson?.questions?.length || 0;
       callbacksRef.current.onCustomAction({
         type: 'answerFeedbackComplete',
         moduleIndex: stateRef.current.currentModuleIndex,
         lessonIndex: stateRef.current.currentLessonIndex,
         questionIndex: stateRef.current.currentQuestionIndex,
         isCorrect: isCorrect,
-        hasNextQuestion: stateRef.current.currentQuestionIndex < (getCurrentLesson()?.questions?.length || 0) - 1,
+        hasNextQuestion: stateRef.current.currentQuestionIndex < totalQuestionsInLesson - 1,
+        score: stateRef.current.score,
+        totalQuestions: stateRef.current.totalQuestions,
         avatarNotReady: true
       });
     }
@@ -760,7 +784,8 @@ const CurriculumLearning = forwardRef(({
           lessonIndex: stateRef.current.currentLessonIndex,
           questionIndex: stateRef.current.currentQuestionIndex,
           totalQuestions: stateRef.current.totalQuestions,
-          question: prevQuestionObj
+          question: prevQuestionObj,
+          score: stateRef.current.score
         });
       }
       

package/src/lib/talkinghead.mjs

@@ -146,8 +146,8 @@ class TalkingHead {
       ttsVoice: "fi-FI-Standard-A",
       ttsRate: 1,
       ttsPitch: 0,
-      ttsVolume: 0,
-      mixerGainSpeech: null,
+      ttsVolume: 0.3,
+      mixerGainSpeech: 1.2,
       mixerGainBackground: null,
       lipsyncLang: 'fi',
       lipsyncModules: ['fi','en','lt'],