Lessons Experience

// From learner-home.tsx:126-139
const generateLessonMutation = useMutation({
  mutationFn: (data: { 
    learnerId: number, 
    topic: string, 
    gradeLevel: number, 
    subject: string, 
    category: string, 
    difficulty: 'beginner' | 'intermediate' | 'advanced' 
  }) => {
    return apiRequest('POST', '/api/lessons/create', data).then(res => res.data);
  },
  retry: 2,
  retryDelay: 1000,

// From enhanced-lesson-service.ts:222-228
export async function generateEnhancedLesson(
  gradeLevel: number,
  topic: string,
  withImages: boolean = true,
  subject?: string,
  difficulty: 'beginner' | 'intermediate' | 'advanced' = 'beginner'
): Promise<EnhancedLessonSpec | null>

// Section type from schema.ts:101
type: "introduction"

type: "key_concepts"

type: "examples"

type: "practice"

type: "summary"

// From enhanced-lesson-service.ts:277-292
for (const section of content.sections) {
  const sectionImageIds: string[] = [];
  
  // If the section has an image description, create a placeholder
  if (section.imageDescription) {
    const imageId = generateId(10);
    allImagePrompts.push({
      id: imageId,
      description: section.imageDescription,
      prompt: buildImagePrompt(section.imageDescription, topic, gradeLevel)
    });
    sectionImageIds.push(imageId);
  }

// From enhanced-lesson-service.ts:199-210
function buildImagePrompt(description: string, topic: string, gradeLevel: number): string {
  return `${description}

Style: Simple, clean, flat illustration. Bright colors appropriate for grade ${gradeLevel} students. White background.

STRICT RULES:
- NO text, letters, words, or labels anywhere in the image
- NO numbers, fractions, mathematical notation, or symbols
- NO annotations, callouts, or speech bubbles
- Simple clean shapes and objects only

// From lesson-page.tsx:102-135
return (
  <SafeAreaView style={styles.container}>
    <SunschoolHeader subtitle={lesson.spec.title} />
    
    <ScrollView contentContainerStyle={styles.scrollContent}>
      <View style={styles.lessonContent}>
        <Text style={styles.lessonTitle}>{lesson.spec.title}</Text>
        
        <EnhancedLessonContent enhancedSpec={lesson.spec} />
      </View>

      <View style={styles.quizPrompt}>
        <Text style={styles.quizPromptTitle}>Think you've got it?</Text>
        <Text style={styles.quizPromptText}>
          Let's play a quick challenge about {lesson.spec.title.toLowerCase()}!
        </Text>
      </View>
    </ScrollView>

    <View style={styles.footer}>
      <TouchableOpacity style={styles.quizButton} onPress={handleStartQuiz}>
        <Text style={styles.quizButtonText}>Let's Go!</Text>
      </TouchableOpacity>
    </View>
  </SafeAreaView>
);

// From enhanced-lesson-service.ts:430-433
// Reject lessons with no real questions — throw so caller can retry
if (!enhancedLesson.questions || enhancedLesson.questions.length < 2) {
  throw new Error(`Generated lesson has insufficient questions (${enhancedLesson.questions?.length ?? 0})`);
}