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

package/package.json

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

@@ -303,7 +303,7 @@ const CurriculumLearning = forwardRef(({
     const speakFirstQuestion = () => {
       if (!avatarRef.current || !firstQuestion) return;
       
-      avatarRef.current.setMood("curious");
+      avatarRef.current.setMood("happy");
       
       // Play custom animation if available
       if (animations.questionStart) {
@@ -404,7 +404,7 @@ const CurriculumLearning = forwardRef(({
           avatarRef.current.speakText(`Now let's try this one: ${nextQuestionObj.question}`, { 
             lipsyncLang: config.lipsyncLang 
           });
-        } else {
+    } else {
           avatarRef.current.speakText(`Here's the next question: ${nextQuestionObj.question}`, { 
             lipsyncLang: config.lipsyncLang 
           });
@@ -459,11 +459,18 @@ const CurriculumLearning = forwardRef(({
       stateRef.current.score = 0;
       stateRef.current.totalQuestions = 0;
       
+      // Check if there's a next lesson available after this one
+      const currentModuleAfterMove = curriculum.modules[stateRef.current.currentModuleIndex];
+      const hasNextLessonInModuleAfterMove = stateRef.current.currentLessonIndex < (currentModuleAfterMove?.lessons?.length || 0) - 1;
+      const hasNextModuleAfterMove = stateRef.current.currentModuleIndex < (curriculum.modules?.length || 0) - 1;
+      const hasNextLessonAfterMove = hasNextLessonInModuleAfterMove || hasNextModuleAfterMove;
+      
       // Clear current question in UI and notify parent
       callbacksRef.current.onCustomAction({
         type: 'lessonStart',
         moduleIndex: stateRef.current.currentModuleIndex,
-        lessonIndex: stateRef.current.currentLessonIndex
+        lessonIndex: stateRef.current.currentLessonIndex,
+        hasNextLesson: hasNextLessonAfterMove
       });
       
       // Notify parent that lesson has changed - parent decides when to start teaching
@@ -475,7 +482,7 @@ const CurriculumLearning = forwardRef(({
     
     if (avatarRef.current) {
       avatarRef.current.setMood("happy");
-        avatarRef.current.setBodyMovement("idle");
+      avatarRef.current.setBodyMovement("idle");
       }
     } else {
       // No more lessons in current module - check if there's a next module
@@ -492,11 +499,18 @@ const CurriculumLearning = forwardRef(({
         stateRef.current.score = 0;
         stateRef.current.totalQuestions = 0;
         
+        // Check if there's a next lesson available after this one
+        const currentModuleAfterMove = curriculum.modules[stateRef.current.currentModuleIndex];
+        const hasNextLessonInModuleAfterMove = stateRef.current.currentLessonIndex < (currentModuleAfterMove?.lessons?.length || 0) - 1;
+        const hasNextModuleAfterMove = stateRef.current.currentModuleIndex < (curriculum.modules?.length || 0) - 1;
+        const hasNextLessonAfterMove = hasNextLessonInModuleAfterMove || hasNextModuleAfterMove;
+        
         // Clear current question in UI and notify parent
         callbacksRef.current.onCustomAction({
           type: 'lessonStart',
           moduleIndex: stateRef.current.currentModuleIndex,
-          lessonIndex: stateRef.current.currentLessonIndex
+          lessonIndex: stateRef.current.currentLessonIndex,
+          hasNextLesson: hasNextLessonAfterMove
         });
     
         // Notify parent that lesson has changed - parent decides when to start teaching
@@ -647,7 +661,7 @@ const CurriculumLearning = forwardRef(({
         if (animations.incorrect) {
           try {
             avatarRef.current.playAnimation(animations.incorrect, true);
-          } catch (error) {
+      } catch (error) {
             avatarRef.current.setBodyMovement("idle");
           }
         }
@@ -732,6 +746,136 @@ const CurriculumLearning = forwardRef(({
     }
   }, [getCurrentQuestion, checkAnswer]);
 
+  // Move to previous question
+  const previousQuestion = useCallback(() => {
+    if (stateRef.current.currentQuestionIndex > 0) {
+      stateRef.current.currentQuestionIndex -= 1;
+      
+      // Trigger custom action for UI update
+      const prevQuestionObj = getCurrentQuestion();
+      if (prevQuestionObj) {
+        callbacksRef.current.onCustomAction({
+          type: 'questionStart',
+          moduleIndex: stateRef.current.currentModuleIndex,
+          lessonIndex: stateRef.current.currentLessonIndex,
+          questionIndex: stateRef.current.currentQuestionIndex,
+          totalQuestions: stateRef.current.totalQuestions,
+          question: prevQuestionObj
+        });
+      }
+      
+      // Function to speak the previous question
+      const speakPrevQuestion = () => {
+        if (!avatarRef.current || !prevQuestionObj) return;
+        
+        avatarRef.current.setMood("happy");
+        avatarRef.current.setBodyMovement("idle");
+        
+        const config = defaultAvatarConfigRef.current || { lipsyncLang: 'en' };
+        
+        // Speak the question text
+        if (prevQuestionObj.type === 'code_test') {
+          avatarRef.current.speakText(`Let's go back to this coding challenge: ${prevQuestionObj.question}`, { 
+            lipsyncLang: config.lipsyncLang 
+          });
+        } else {
+          avatarRef.current.speakText(`Going back to: ${prevQuestionObj.question}`, { 
+            lipsyncLang: config.lipsyncLang 
+          });
+        }
+      };
+      
+      // Try to speak immediately if avatar is ready
+      if (avatarRef.current && avatarRef.current.isReady && prevQuestionObj) {
+        speakPrevQuestion();
+      } else if (prevQuestionObj) {
+        // Avatar not ready yet - wait for it to be ready, then speak
+        const checkReady = setInterval(() => {
+          if (avatarRef.current && avatarRef.current.isReady) {
+            clearInterval(checkReady);
+            speakPrevQuestion();
+          }
+        }, 100);
+        
+        setTimeout(() => {
+          clearInterval(checkReady);
+        }, 5000);
+      }
+    }
+  }, [getCurrentQuestion]);
+
+  // Move to previous lesson
+  const previousLesson = useCallback(() => {
+    const curriculum = curriculumRef.current || { modules: [] };
+    const currentModule = curriculum.modules[stateRef.current.currentModuleIndex];
+    
+    // Check if there's a previous lesson in the current module
+    const hasPrevLessonInModule = stateRef.current.currentLessonIndex > 0;
+    
+    if (hasPrevLessonInModule) {
+      // Move to previous lesson in current module
+      stateRef.current.currentLessonIndex -= 1;
+      stateRef.current.currentQuestionIndex = 0;
+      stateRef.current.lessonCompleted = false;
+      stateRef.current.isQuestionMode = false;
+      stateRef.current.isTeaching = false;
+      stateRef.current.score = 0;
+      stateRef.current.totalQuestions = 0;
+      
+      // Notify parent that lesson has changed
+      callbacksRef.current.onCustomAction({
+        type: 'lessonStart',
+        moduleIndex: stateRef.current.currentModuleIndex,
+        lessonIndex: stateRef.current.currentLessonIndex
+      });
+      
+      callbacksRef.current.onLessonStart({
+        moduleIndex: stateRef.current.currentModuleIndex,
+        lessonIndex: stateRef.current.currentLessonIndex,
+        lesson: getCurrentLesson()
+      });
+      
+      if (avatarRef.current) {
+        avatarRef.current.setMood("happy");
+        avatarRef.current.setBodyMovement("idle");
+      }
+    } else {
+      // No previous lesson in current module - check if there's a previous module
+      const hasPrevModule = stateRef.current.currentModuleIndex > 0;
+      
+      if (hasPrevModule) {
+        // Move to last lesson of previous module
+        const prevModule = curriculum.modules[stateRef.current.currentModuleIndex - 1];
+        stateRef.current.currentModuleIndex -= 1;
+        stateRef.current.currentLessonIndex = (prevModule?.lessons?.length || 1) - 1;
+        stateRef.current.currentQuestionIndex = 0;
+        stateRef.current.lessonCompleted = false;
+        stateRef.current.isQuestionMode = false;
+        stateRef.current.isTeaching = false;
+        stateRef.current.score = 0;
+        stateRef.current.totalQuestions = 0;
+        
+        // Notify parent that lesson has changed
+        callbacksRef.current.onCustomAction({
+          type: 'lessonStart',
+          moduleIndex: stateRef.current.currentModuleIndex,
+          lessonIndex: stateRef.current.currentLessonIndex
+        });
+        
+        callbacksRef.current.onLessonStart({
+          moduleIndex: stateRef.current.currentModuleIndex,
+          lessonIndex: stateRef.current.currentLessonIndex,
+          lesson: getCurrentLesson()
+        });
+        
+        if (avatarRef.current) {
+          avatarRef.current.setMood("happy");
+          avatarRef.current.setBodyMovement("idle");
+        }
+      }
+    }
+  }, [getCurrentLesson]);
+
   // Reset curriculum
   const resetCurriculum = useCallback(() => {
     stateRef.current.currentModuleIndex = 0;
@@ -781,7 +925,9 @@ const CurriculumLearning = forwardRef(({
     handleAnswerSelect,
     handleCodeTestResult,
     nextQuestion,
+    previousQuestion,
     nextLesson,
+    previousLesson,
     completeLesson,
     completeCurriculum,
     resetCurriculum,