@sage-rsc/talking-head-react 1.0.57 → 1.0.59

package/package.json

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

@@ -185,7 +185,11 @@ const CurriculumLearning = forwardRef(({
       : 100;
     let feedbackMessage = `Congratulations! You've completed this lesson`;
     if (stateRef.current.totalQuestions > 0) {
-      feedbackMessage += ` with a score of ${stateRef.current.score} out of ${stateRef.current.totalQuestions} (${percentage}%). `;
+      // Rephrase for clearer TTS: "You got X correct out of Y questions, which is Z percent"
+      const scoreText = stateRef.current.score === 1 ? 'one' : stateRef.current.score;
+      const totalText = stateRef.current.totalQuestions === 1 ? 'one' : stateRef.current.totalQuestions;
+      const percentText = percentage === 50 ? 'fifty' : `${percentage}`;
+      feedbackMessage += ` You got ${scoreText} correct out of ${totalText} question${stateRef.current.totalQuestions === 1 ? '' : 's'}, which is ${percentText} percent. `;
         } else {
       feedbackMessage += `! `;
     }
@@ -994,7 +998,12 @@ const CurriculumLearning = forwardRef(({
     stopSpeaking: () => avatarRef.current?.stopSpeaking(),
     pauseSpeaking: () => avatarRef.current?.pauseSpeaking(),
     resumeSpeaking: async () => await avatarRef.current?.resumeSpeaking(),
-    isPaused: () => avatarRef.current?.isPaused || false,
+    isPaused: () => {
+      if (avatarRef.current && typeof avatarRef.current.isPaused !== 'undefined') {
+        return avatarRef.current.isPaused;
+      }
+      return false;
+    },
     setMood: (mood) => avatarRef.current?.setMood(mood),
     playAnimation: (animationName, disablePositionLock) => avatarRef.current?.playAnimation(animationName, disablePositionLock),
     setBodyMovement: (movement) => avatarRef.current?.setBodyMovement(movement),

package/src/components/TalkingHeadAvatar.jsx

@@ -399,8 +399,19 @@ const TalkingHeadAvatar = forwardRef(({
 
   const pauseSpeaking = useCallback(() => {
     if (talkingHeadRef.current && talkingHeadRef.current.pauseSpeaking) {
-      // Only pause if we have paused speech stored (meaning something is currently speaking)
-      if (pausedSpeechRef.current && pausedSpeechRef.current.text) {
+      // Check if avatar is currently speaking
+      const talkingHead = talkingHeadRef.current;
+      const isCurrentlySpeaking = talkingHead.isSpeaking || 
+                                   (talkingHead.audioPlaylist && talkingHead.audioPlaylist.length > 0) ||
+                                   (talkingHead.speechQueue && talkingHead.speechQueue.length > 0);
+      
+      // Only pause if avatar is actually speaking
+      if (isCurrentlySpeaking && pausedSpeechRef.current && pausedSpeechRef.current.text) {
+        talkingHeadRef.current.pauseSpeaking();
+        setIsPaused(true);
+      } else if (isCurrentlySpeaking) {
+        // If speaking but no paused speech stored, try to pause anyway
+        // This handles cases where speech started before we could track it
         talkingHeadRef.current.pauseSpeaking();
         setIsPaused(true);
       }
@@ -408,16 +419,17 @@ const TalkingHeadAvatar = forwardRef(({
   }, []);
 
   const resumeSpeaking = useCallback(async () => {
-    if (talkingHeadRef.current && pausedSpeechRef.current) {
+    if (talkingHeadRef.current && isPaused) {
       setIsPaused(false);
-      const pausedSpeech = pausedSpeechRef.current;
-      pausedSpeechRef.current = null;
       
       // Resume audio context
       await resumeAudioContext();
       
-      // Re-speak the paused text
-      if (pausedSpeech.text) {
+      // Re-speak the paused text if we have it stored
+      if (pausedSpeechRef.current && pausedSpeechRef.current.text) {
+        const pausedSpeech = pausedSpeechRef.current;
+        pausedSpeechRef.current = null; // Clear after getting the text
+        
         const speakOptions = {
           ...pausedSpeech.options,
           lipsyncLang: pausedSpeech.options.lipsyncLang || defaultAvatarConfig.lipsyncLang || 'en'
@@ -429,9 +441,12 @@ const TalkingHeadAvatar = forwardRef(({
           }
           talkingHeadRef.current.speakText(pausedSpeech.text, speakOptions);
         }
+      } else {
+        // If no paused speech stored, just clear the pause state
+        pausedSpeechRef.current = null;
       }
     }
-  }, [resumeAudioContext]);
+  }, [resumeAudioContext, isPaused]);
 
   const setMood = useCallback((mood) => {
     if (talkingHeadRef.current) {
@@ -517,7 +532,7 @@ const TalkingHeadAvatar = forwardRef(({
     setTimingAdjustment,
     playAnimation,
     isReady,
-    isPaused,
+    isPaused: isPaused,
     talkingHead: talkingHeadRef.current,
     handleResize,
     setBodyMovement: (movement) => {