@thanh01.pmt/interactive-quiz-kit 1.0.66 → 1.0.68

package/HEADLESS.md

@@ -179,7 +179,7 @@ async function createAIQuestion() {
     console.log('Generating a Multiple Choice question about the Solar System...');
     const result = await generateMCQQuestion({
       topic: 'The Solar System',
-      difficulty: 'easy',
+      difficulty: 'Easy',
       language: 'English'
     }, 'YOUR_API_KEY');
 

package/README.md

@@ -5,7 +5,7 @@
 
 **Interactive Quiz Kit** is a comprehensive TypeScript library built with React, designed to effortlessly create, manage, play, and distribute interactive quizzes. It provides a robust core logic (`QuizEngine`), reusable React UI components, and support for a wide variety of question types.
 
-The library is architected for easy extension and integration, featuring a powerful authoring tool, AI-powered content generation (using Google's Genkit and Gemini), and SCORM packaging for seamless LMS integration.
+The library is architected for Easy extension and integration, featuring a powerful authoring tool, AI-powered content generation (using Google's Genkit and Gemini), and SCORM packaging for seamless LMS integration.
 
 ## ✨ Features
 
@@ -167,7 +167,7 @@ async function createNewQuestion() {
   try {
     const { question } = await generateTrueFalseQuestion({
       topic: "The history of the internet",
-      difficulty: "medium"
+      difficulty: "Medium"
     });
 
     if (question) {

package/dist/{ai-ecosystem-DqFRlFU3.d.cts → ai-ecosystem-DyQYZbyX.d.cts}

@@ -1,4 +1,4 @@
-import { R as RichContentString, Q as QuestionTypeStrings, s as QuizConfig } from './quiz-config-o4j2dfsu.cjs';
+import { R as RichContentString, Q as QuestionTypeStrings, s as QuizConfig } from './quiz-config-CwaP-pBs.cjs';
 
 interface TestCaseResult {
     testCaseId: string;
@@ -103,7 +103,7 @@ interface Achievement {
 }
 type PracticeDifficulty = 'Very Easy' | 'Easy' | 'Medium' | 'Hard' | 'Expert';
 interface PracticeSuggestionTopic {
-    loId: string;
+    code: string;
     topicName: string;
     reason: 'review' | 'explore';
     suggestedDifficulty?: PracticeDifficulty;
@@ -175,7 +175,7 @@ interface RoadmapItem {
     topicName: string;
     reason: string;
     suggestedDifficulty: PracticeDifficulty;
-    loId: string;
+    code: string;
     isCompleted: boolean;
 }
 interface WeeklyRoadmap {

package/dist/{ai-ecosystem-DqVlSO3r.d.ts → ai-ecosystem-Qa_SdE2T.d.ts}

@@ -1,4 +1,4 @@
-import { R as RichContentString, Q as QuestionTypeStrings, s as QuizConfig } from './quiz-config-o4j2dfsu.js';
+import { R as RichContentString, Q as QuestionTypeStrings, s as QuizConfig } from './quiz-config-CwaP-pBs.js';
 
 interface TestCaseResult {
     testCaseId: string;
@@ -103,7 +103,7 @@ interface Achievement {
 }
 type PracticeDifficulty = 'Very Easy' | 'Easy' | 'Medium' | 'Hard' | 'Expert';
 interface PracticeSuggestionTopic {
-    loId: string;
+    code: string;
     topicName: string;
     reason: 'review' | 'explore';
     suggestedDifficulty?: PracticeDifficulty;
@@ -175,7 +175,7 @@ interface RoadmapItem {
     topicName: string;
     reason: string;
     suggestedDifficulty: PracticeDifficulty;
-    loId: string;
+    code: string;
     isCompleted: boolean;
 }
 interface WeeklyRoadmap {

package/dist/ai.cjs

@@ -94,12 +94,12 @@ var QuizContextSchema = zod.z.object({
   originalSubject: zod.z.string().optional(),
   originalCategory: zod.z.string().optional(),
   originalTopic: zod.z.string().optional(),
-  loDescription: zod.z.string().optional().describe("The full description of the learning objective for deep context."),
+  description: zod.z.string().optional().describe("The full description of the learning objective for deep context."),
   gradeBand: zod.z.string().optional()
 });
 var BaseQuestionGenerationClientInputSchema = zod.z.object({
   language: zod.z.string().optional().default("English"),
-  difficulty: zod.z.enum(["easy", "medium", "hard"]),
+  difficulty: zod.z.enum(["Easy", "Medium", "Hard"]),
   quizContext: QuizContextSchema.optional(),
   imageUrl: zod.z.string().url().optional().describe("Optional URL of an image to be used as context.")
 });
@@ -108,7 +108,7 @@ var BaseQuestionZodSchema = zod.z.object({
   prompt: zod.z.string().min(1),
   points: zod.z.number().min(0).optional(),
   explanation: zod.z.string().optional(),
-  difficulty: zod.z.enum(["easy", "medium", "hard"]).optional(),
+  difficulty: zod.z.enum(["Easy", "Medium", "Hard"]).optional(),
   topic: zod.z.string().optional(),
   category: zod.z.string().optional(),
   subject: zod.z.string().optional(),
@@ -204,7 +204,7 @@ var AITrueFalseOutputFieldsSchema = zod.z.object({
   correctAnswer: zod.z.boolean(),
   explanation: zod.z.string().optional().describe("An explanation of why the statement is true or false, especially important if false."),
   points: zod.z.number().optional().default(10),
-  difficulty: zod.z.enum(["easy", "medium", "hard"]).optional(),
+  difficulty: zod.z.enum(["Easy", "Medium", "Hard"]).optional(),
   topic: zod.z.string().optional(),
   verifiedCategory: zod.z.string().optional()
   // Thêm để xác thực
@@ -225,7 +225,7 @@ Previous attempts failed. Ensure the JSON is valid and 'correctAnswer' is a bool
   const misconceptionGuidance = quizContext?.targetMisconception ? `**Target Misconception:** The statement you create MUST be FALSE and based on this common mistake: "${quizContext.targetMisconception}"` : "";
   const contextStrings = [
     `**Required Category:** ${category}`,
-    quizContext?.loDescription && `**Learning Objective:** ${quizContext.loDescription}`,
+    quizContext?.description && `**Learning Objective:** ${quizContext.description}`,
     imageContextInstruction,
     quizContext?.plannedBloomLevel && `**Cognitive Level (Bloom's):** ${quizContext.plannedBloomLevel}`,
     misconceptionGuidance,
@@ -236,7 +236,7 @@ Previous attempts failed. Ensure the JSON is valid and 'correctAnswer' is a bool
     correctAnswer: true,
     explanation: "Optional values in Swift represent the presence or absence of a value. To access the value when it exists, you must unwrap it using methods like 'if let', 'guard let', or the force unwrap operator '!'.",
     points: 10,
-    difficulty: "easy",
+    difficulty: "Easy",
     topic: "Swift Optionals",
     verifiedCategory: category
   }, null, 2);
@@ -366,7 +366,7 @@ var AIMCQOutputFieldsSchema = zod.z.object({
   correctTempOptionId: zod.z.string().describe("The temporary ID of the correct option from the generated options array."),
   explanation: zod.z.string().optional().describe("A brief explanation of why the answer is correct."),
   points: zod.z.number().optional().default(10),
-  difficulty: zod.z.enum(["easy", "medium", "hard"]).optional(),
+  difficulty: zod.z.enum(["Easy", "Medium", "Hard"]).optional(),
   topic: zod.z.string().optional(),
   verifiedCategory: zod.z.string().optional().describe("The category this question actually addresses.")
 });
@@ -385,7 +385,7 @@ Previous attempts failed...
   const imageContextInstruction = imageUrl ? `**Image Context:** You MUST analyze the provided image. The question and options must be directly related to the content of this image.` : "";
   const contextStrings = [
     `**Required Category:** ${category}`,
-    quizContext?.loDescription && `**Learning Objective:** ${quizContext.loDescription}`,
+    quizContext?.description && `**Learning Objective:** ${quizContext.description}`,
     imageContextInstruction,
     quizContext?.plannedBloomLevel && `**Cognitive Level (Bloom's):** ${quizContext.plannedBloomLevel}`,
     quizContext?.targetMisconception && `**Target Misconception:** Use this to create plausible incorrect answers: "${quizContext.targetMisconception}"`,
@@ -402,7 +402,7 @@ Previous attempts failed...
     correctTempOptionId: "C",
     explanation: `The 'guard' statement in ${category} provides an early exit from a scope (like a function) if a condition is false, enhancing code readability by handling required conditions upfront.`,
     points: 10,
-    difficulty: "easy",
+    difficulty: "Easy",
     topic: `Control Flow in ${category}`,
     verifiedCategory: category
   }, null, 2);
@@ -544,7 +544,7 @@ var AIMRQOutputFieldsSchema = zod.z.object({
   correctTempOptionIds: zod.z.array(zod.z.string()).min(1),
   explanation: zod.z.string().optional(),
   points: zod.z.number().optional().default(10),
-  difficulty: zod.z.enum(["easy", "medium", "hard"]).optional(),
+  difficulty: zod.z.enum(["Easy", "Medium", "Hard"]).optional(),
   topic: zod.z.string().optional(),
   verifiedCategory: zod.z.string().optional().describe("The category this question actually addresses.")
 });
@@ -563,7 +563,7 @@ Previous attempts failed due to validation errors. Pay close attention to the nu
   const imageContextInstruction = imageUrl ? `**Image Context:** You MUST analyze the provided image. The question and options must be directly related to the content of this image.` : "";
   const contextStrings = [
     `**Required Category:** ${category} (This is the ONLY language to be used)`,
-    quizContext?.loDescription && `**Learning Objective:** ${quizContext.loDescription}`,
+    quizContext?.description && `**Learning Objective:** ${quizContext.description}`,
     imageContextInstruction,
     quizContext?.plannedBloomLevel && `**Cognitive Level (Bloom's):** ${quizContext.plannedBloomLevel}`,
     quizContext?.targetMisconception && `**Target Misconception:** Use this to create plausible incorrect answers (distractors). The misconception is: "${quizContext.targetMisconception}"`,
@@ -581,7 +581,7 @@ Previous attempts failed due to validation errors. Pay close attention to the nu
     correctTempOptionIds: ["A", "C", "D"],
     explanation: "Object-Oriented, Functional, and Procedural are all major programming paradigms. Assembly is a low-level language, and Middleware is a type of software, not a paradigm.",
     points: 10,
-    difficulty: "medium",
+    difficulty: "Medium",
     topic: "Programming Paradigms",
     verifiedCategory: category
   }, null, 2);
@@ -739,7 +739,7 @@ var AIShortAnswerOutputFieldsSchema = zod.z.object({
   // isCaseSensitive không cần thiết ở đây, chúng ta sẽ quản lý nó ở phía client
   explanation: zod.z.string().optional(),
   points: zod.z.number().optional().default(10),
-  difficulty: zod.z.enum(["easy", "medium", "hard"]).optional(),
+  difficulty: zod.z.enum(["Easy", "Medium", "Hard"]).optional(),
   topic: zod.z.string().optional(),
   verifiedCategory: zod.z.string().optional()
   // Thêm để xác thực
@@ -759,7 +759,7 @@ Previous attempts failed. Ensure 'acceptedAnswers' is a non-empty array of strin
   const imageContextInstruction = imageUrl ? `**Image Context:** You MUST analyze the provided image. The question and its short answer must be directly related to the content of this image.` : "";
   const contextStrings = [
     `**Required Category:** ${category}`,
-    quizContext?.loDescription && `**Learning Objective:** ${quizContext.loDescription}`,
+    quizContext?.description && `**Learning Objective:** ${quizContext.description}`,
     imageContextInstruction,
     quizContext?.plannedBloomLevel && `**Cognitive Level (Bloom's):** ${quizContext.plannedBloomLevel}`,
     quizContext?.targetMisconception && `**Target Misconception:** The question should require an answer that corrects this specific misconception: "${quizContext.targetMisconception}"`
@@ -769,7 +769,7 @@ Previous attempts failed. Ensure 'acceptedAnswers' is a non-empty array of strin
     acceptedAnswers: ["let"],
     explanation: "The 'let' keyword is used to declare constants, which are values that cannot be changed after they are set. 'var' is used for variables.",
     points: 10,
-    difficulty: "easy",
+    difficulty: "Easy",
     topic: "Swift Constants",
     verifiedCategory: category
   }, null, 2);
@@ -896,7 +896,7 @@ var AINumericOutputFieldsSchema = zod.z.object({
   tolerance: zod.z.number().min(0).optional(),
   explanation: zod.z.string().optional(),
   points: zod.z.number().optional().default(10),
-  difficulty: zod.z.enum(["easy", "medium", "hard"]).optional(),
+  difficulty: zod.z.enum(["Easy", "Medium", "Hard"]).optional(),
   topic: zod.z.string().optional(),
   verifiedCategory: zod.z.string().optional()
   // Thêm để xác thực
@@ -916,7 +916,7 @@ Previous attempts failed. Ensure the 'answer' is a valid number and fits within
   const imageContextInstruction = imageUrl ? `**Image Context:** You MUST analyze the provided image. The question and its numerical answer must be directly related to the content of this image.` : "";
   const contextStrings = [
     `**Required Category:** ${category}`,
-    quizContext?.loDescription && `**Learning Objective:** ${quizContext.loDescription}`,
+    quizContext?.description && `**Learning Objective:** ${quizContext.description}`,
     imageContextInstruction,
     quizContext?.plannedBloomLevel && `**Cognitive Level (Bloom's):** ${quizContext.plannedBloomLevel}`,
     quizContext?.targetMisconception && `**Target Misconception:** The question should clarify this numerical error: "${quizContext.targetMisconception}"`
@@ -932,7 +932,7 @@ Previous attempts failed. Ensure the 'answer' is a valid number and fits within
     tolerance: 0,
     explanation: "An Int8 uses 8 bits. One bit is for the sign, leaving 7 bits for the value. The range is from -128 to 127 (2^7 - 1).",
     points: 10,
-    difficulty: "medium",
+    difficulty: "Medium",
     topic: "Swift Data Types",
     verifiedCategory: category
   }, null, 2);
@@ -1076,7 +1076,7 @@ var AIFillInTheBlanksOutputFieldsSchema = zod.z.object({
   })).min(1).describe("An array of text and blank segments representing the question."),
   explanation: zod.z.string().optional(),
   points: zod.z.number().optional().default(10),
-  difficulty: zod.z.enum(["easy", "medium", "hard"]).optional(),
+  difficulty: zod.z.enum(["Easy", "Medium", "Hard"]).optional(),
   topic: zod.z.string().optional(),
   verifiedCategory: zod.z.string().optional()
   // Thêm để xác thực
@@ -1096,7 +1096,7 @@ Previous attempts failed. Pay strict attention to the JSON schema, especially th
   const imageContextInstruction = imageUrl ? `**Image Context:** You MUST analyze the provided image. The question and blanks must be directly related to the content of this image.` : "";
   const contextStrings = [
     `**Required Category:** ${category}`,
-    quizContext?.loDescription && `**Learning Objective:** ${quizContext.loDescription}`,
+    quizContext?.description && `**Learning Objective:** ${quizContext.description}`,
     imageContextInstruction,
     quizContext?.plannedBloomLevel && `**Cognitive Level (Bloom's):** ${quizContext.plannedBloomLevel}`,
     quizContext?.targetMisconception && `**Target Misconception:** Design the blank to test this specific point: "${quizContext.targetMisconception}"`
@@ -1110,7 +1110,7 @@ Previous attempts failed. Pay strict attention to the JSON schema, especially th
     ],
     explanation: "The 'func' keyword is used to declare a function in the Swift programming language.",
     points: 10,
-    difficulty: "easy",
+    difficulty: "Easy",
     topic: "Swift Function Declaration",
     verifiedCategory: category
   }, null, 2);
@@ -1258,7 +1258,7 @@ var AISequenceOutputFieldsSchema = zod.z.object({
   itemsInCorrectOrder: zod.z.array(zod.z.string().min(1)).min(2).describe("An array of strings, with each string representing an item to be sequenced. The array itself MUST be in the correct final order."),
   explanation: zod.z.string().optional(),
   points: zod.z.number().optional().default(10),
-  difficulty: zod.z.enum(["easy", "medium", "hard"]).optional(),
+  difficulty: zod.z.enum(["Easy", "Medium", "Hard"]).optional(),
   topic: zod.z.string().optional(),
   verifiedCategory: zod.z.string().optional()
   // Thêm để xác thực
@@ -1278,7 +1278,7 @@ Previous attempts failed. Ensure the 'itemsInCorrectOrder' array has exactly the
   const imageContextInstruction = imageUrl ? `**Image Context:** You MUST analyze the provided image. The sequence of items must be directly related to the process or content shown in this image.` : "";
   const contextStrings = [
     `**Required Category:** ${category}`,
-    quizContext?.loDescription && `**Learning Objective:** ${quizContext.loDescription}`,
+    quizContext?.description && `**Learning Objective:** ${quizContext.description}`,
     imageContextInstruction,
     quizContext?.plannedBloomLevel && `**Cognitive Level (Bloom's):** ${quizContext.plannedBloomLevel}`,
     quizContext?.targetMisconception && `**Target Misconception:** The sequence should clarify this specific process error: "${quizContext.targetMisconception}"`
@@ -1293,7 +1293,7 @@ Previous attempts failed. Ensure the 'itemsInCorrectOrder' array has exactly the
     ],
     explanation: "This is the fundamental sequence for a basic data task in URLSession.",
     points: 10,
-    difficulty: "medium",
+    difficulty: "Medium",
     topic: "Swift Networking",
     verifiedCategory: category
   }, null, 2);
@@ -1429,7 +1429,7 @@ var AIMatchingOutputFieldsSchema = zod.z.object({
   })).min(2),
   explanation: zod.z.string().optional(),
   points: zod.z.number().optional().default(10),
-  difficulty: zod.z.enum(["easy", "medium", "hard"]).optional(),
+  difficulty: zod.z.enum(["Easy", "Medium", "Hard"]).optional(),
   topic: zod.z.string().optional(),
   verifiedCategory: zod.z.string().optional()
   // Thêm để xác thực
@@ -1449,7 +1449,7 @@ Previous attempts failed. Please ensure the 'correctPairs' array has exactly the
   const imageContextInstruction = imageUrl ? `**Image Context:** You MUST analyze the provided image. The matching pairs must be directly related to the content of this image.` : "";
   const contextStrings = [
     `**Required Category:** ${category}`,
-    quizContext?.loDescription && `**Learning Objective:** ${quizContext.loDescription}`,
+    quizContext?.description && `**Learning Objective:** ${quizContext.description}`,
     imageContextInstruction,
     quizContext?.plannedBloomLevel && `**Cognitive Level (Bloom's):** ${quizContext.plannedBloomLevel}`,
     quizContext?.targetMisconception && `**Target Misconception:** Design a pair that specifically tests this confusion: "${quizContext.targetMisconception}"`
@@ -1463,7 +1463,7 @@ Previous attempts failed. Please ensure the 'correctPairs' array has exactly the
     ],
     explanation: "These are the fundamental characteristics of Swift's main collection types.",
     points: 10,
-    difficulty: "easy",
+    difficulty: "Easy",
     topic: "Swift Collection Types",
     verifiedCategory: category
   }, null, 2);
@@ -1624,7 +1624,7 @@ Previous attempts failed. Pay strict attention to the JSON schema and all rules.
   const imageContextInstruction = imageUrl ? `**Image Context:** You MUST analyze the provided image. The coding problem must be directly related to processing or interpreting the content of this image.` : "";
   const contextStrings = [
     `**Subject:** ${subject}`,
-    quizContext?.loDescription && `**Learning Objective:** ${quizContext.loDescription}`,
+    quizContext?.description && `**Learning Objective:** ${quizContext.description}`,
     imageContextInstruction,
     quizContext?.plannedBloomLevel && `**Cognitive Level (Bloom's):** ${quizContext.plannedBloomLevel}`,
     quizContext?.targetMisconception && `**Target Misconception:** The problem should test against this common error: "${quizContext.targetMisconception}"`
@@ -2496,10 +2496,6 @@ function validateConsecutiveTypes(quizPlan) {
 
 // src/services/TopicDataService.ts
 var TopicDataService = class {
-  /**
-   * Saves an array of LearningObjective objects to Local Storage, overwriting existing data.
-   * @param data The array of learning objectives to save.
-   */
   static saveData(data) {
     try {
       if (typeof window === "undefined") return;
@@ -2509,24 +2505,15 @@ var TopicDataService = class {
       console.error("Error saving learning objectives to Local Storage:", error);
     }
   }
-  /**
-   * Merges a new set of learning objectives with the existing data in Local Storage.
-   * If an LO ID from newData already exists, it will be updated. Otherwise, it will be added.
-   * @param newData The array of new or updated learning objectives.
-   */
   static mergeData(newData) {
     const existingData = this.getData();
-    const loMap = new Map(existingData.map((lo) => [lo.loId, lo]));
+    const loMap = new Map(existingData.map((lo) => [lo.code, lo]));
     newData.forEach((newLo) => {
-      loMap.set(newLo.loId, newLo);
+      loMap.set(newLo.code, newLo);
     });
     const mergedData = Array.from(loMap.values());
     this.saveData(mergedData);
   }
-  /**
-   * Retrieves the array of LearningObjective objects from Local Storage.
-   * @returns An array of learning objectives, or an empty array if none are found or an error occurs.
-   */
   static getData() {
     try {
       if (typeof window === "undefined") return [];
@@ -2538,9 +2525,6 @@ var TopicDataService = class {
       return [];
     }
   }
-  /**
-   * Removes all learning objective data from Local Storage.
-   */
   static clearData() {
     try {
       if (typeof window === "undefined") return;
@@ -2549,11 +2533,6 @@ var TopicDataService = class {
       console.error("Error clearing learning objectives from Local Storage:", error);
     }
   }
-  /**
-   * Parses TSV content into an array of LearningObjective objects.
-   * @param tsvContent The raw string content from a .tsv file.
-   * @returns An object containing the successfully parsed data and any errors encountered.
-   */
   static parseTSV(tsvContent) {
     const lines = tsvContent.split("\n").filter((line) => line.trim() !== "");
     if (lines.length < 2) {
@@ -2575,6 +2554,7 @@ var TopicDataService = class {
       }
       const [
         loId,
+        name,
         loDescription,
         subject,
         category,
@@ -2584,18 +2564,21 @@ var TopicDataService = class {
         stemElementsStr,
         bloomLevelsStr
       ] = values;
-      if (!loId || !subject || !category || !topic) {
-        errors.push(`Line ${index + 2}: Missing required fields (LO ID, Subject, Category, or Topic).`);
+      if (!loId || !loDescription || !subject || !category || !topic) {
+        errors.push(`Line ${index + 2}: Missing required fields (LO ID, LO Description, Subject, Category, or Topic).`);
         return;
       }
       const learningObjective = {
-        loId,
-        loDescription,
+        id: generateUniqueId("lo_"),
+        code: loId,
+        name,
+        description: loDescription,
+        // Can be the same as name or enhanced later
         subject,
         category,
         topic,
-        keywords: keywordsStr.split(",").map((k) => k.trim()).filter(Boolean),
         grade,
+        keywords: keywordsStr.split(",").map((k) => k.trim()).filter(Boolean),
         stemElements: stemElementsStr.split(",").map((s) => s.trim()).filter(Boolean),
         bloomLevelsGuideline: bloomLevelsStr.split(",").map((b) => b.trim()).filter(Boolean)
       };
@@ -2603,40 +2586,21 @@ var TopicDataService = class {
     });
     return { data, errors };
   }
-  /**
-   * Gets a unique list of all subjects from the stored data.
-   * @returns An array of subject strings.
-   */
   static getSubjects() {
     const data = this.getData();
     const subjects = data.map((item) => item.subject);
     return [...new Set(subjects)].sort();
   }
-  /**
-   * Gets a unique list of categories for a given subject.
-   * @param subject The subject to filter by.
-   * @returns An array of category strings.
-   */
   static getCategoriesBySubject(subject) {
     const data = this.getData();
     const categories = data.filter((item) => item.subject === subject).map((item) => item.category);
     return [...new Set(categories)].sort();
   }
-  /**
-   * Gets a unique list of topics for a given category.
-   * @param category The category to filter by.
-   * @returns An array of topic strings.
-   */
   static getTopicsByCategory(category) {
     const data = this.getData();
     const topics = data.filter((item) => item.category === category).map((item) => item.topic);
     return [...new Set(topics)].sort();
   }
-  /**
-   * Retrieves all LearningObjective details for a given list of topics.
-   * @param topics An array of topic strings to search for.
-   * @returns An array of matching LearningObjective objects.
-   */
   static getLearningObjectivesByTopics(topics) {
     const data = this.getData();
     const topicSet = new Set(topics);
@@ -2684,9 +2648,9 @@ var calculateCombinedDifficulty = (plannedQ) => {
       break;
   }
   const totalScore = bloomScore + contextScore + questionTypeScore;
-  if (totalScore <= 4) return "easy";
-  if (totalScore <= 7) return "medium";
-  return "hard";
+  if (totalScore <= 4) return "Easy";
+  if (totalScore <= 7) return "Medium";
+  return "Hard";
 };
 async function generateQuestionsFromQuizPlan(clientInput, apiKey) {
   const { quizPlan, language, imageContexts } = clientInput;
@@ -2699,7 +2663,7 @@ async function generateQuestionsFromQuizPlan(clientInput, apiKey) {
     let lastError = null;
     for (let attempt = 1; attempt <= MAX_ATTEMPTS; attempt++) {
       try {
-        const fullLO = plannedQ.originalLoId ? allLearningObjectives.find((lo) => lo.loId === plannedQ.originalLoId) : null;
+        const fullLO = plannedQ.originalLoId ? allLearningObjectives.find((lo) => lo.code === plannedQ.originalLoId) : null;
         const quizContext = {
           plannedTopic: plannedQ.plannedTopic,
           plannedQuestionType: plannedQ.plannedQuestionType,
@@ -2712,7 +2676,7 @@ async function generateQuestionsFromQuizPlan(clientInput, apiKey) {
           originalSubject: plannedQ.originalSubject,
           originalCategory: plannedQ.originalCategory,
           originalTopic: plannedQ.originalTopic,
-          loDescription: fullLO?.loDescription || plannedQ.plannedTopic
+          description: fullLO?.description || plannedQ.plannedTopic
         };
         const imageUrl = plannedQ.imageId && imageContexts ? imageContexts.find((ctx) => ctx.id === plannedQ.imageId)?.imageUrl : void 0;
         const baseClientInput = {
@@ -2901,7 +2865,7 @@ zod.z.object({
     }))
   })).optional(),
   allAvailableTopics: zod.z.array(zod.z.object({
-    loId: zod.z.string(),
+    code: zod.z.string(),
     subject: zod.z.string(),
     category: zod.z.string(),
     topic: zod.z.string()
@@ -2910,7 +2874,7 @@ zod.z.object({
 var PracticeSuggestionOutputSchema = zod.z.object({
   suggestionText: zod.z.string().describe("The personalized message from the AI tutor in Markdown format."),
   suggestedTopics: zod.z.array(zod.z.object({
-    loId: zod.z.string(),
+    code: zod.z.string(),
     topicName: zod.z.string(),
     reason: zod.z.enum(["review", "explore"]),
     suggestedDifficulty: zod.z.enum(["Very Easy", "Easy", "Medium", "Hard", "Expert"])
@@ -2951,8 +2915,8 @@ Return a single, valid JSON object in this exact format. All text must be in ${l
 {
   "suggestionText": "Ch\xE0o ${userName || "b\u1EA1n"}, t\xF4i \u0111\xE3 xem qua k\u1EBFt qu\u1EA3 c\u1EE7a b\u1EA1n! \u0110\u1EC3 c\u1EE7ng c\u1ED1 ki\u1EBFn th\u1EE9c, ch\xFAng ta h\xE3y \xF4n l\u1EA1i ch\u1EE7 \u0111\u1EC1 [T\xEAn ch\u1EE7 \u0111\u1EC1 y\u1EBFu] \u1EDF m\u1EE9c \u0111\u1ED9 'Easy' nh\xE9. V\xEC b\u1EA1n \u0111\xE3 l\xE0m r\u1EA5t t\u1ED1t ph\u1EA7n [T\xEAn ch\u1EE7 \u0111\u1EC1 m\u1EA1nh], h\xE3y th\u1EED s\u1EE9c v\u1EDBi ch\u1EE7 \u0111\u1EC1 li\xEAn quan l\xE0 [T\xEAn ch\u1EE7 \u0111\u1EC1 kh\xE1m ph\xE1] \u1EDF m\u1EE9c \u0111\u1ED9 'Medium' xem sao!",
   "suggestedTopics": [
-    { "loId": "some-lo-id-1", "topicName": "[T\xEAn ch\u1EE7 \u0111\u1EC1 y\u1EBFu]", "reason": "review", "suggestedDifficulty": "Easy" },
-    { "loId": "some-lo-id-2", "topicName": "[T\xEAn ch\u1EE7 \u0111\u1EC1 kh\xE1m ph\xE1]", "reason": "explore", "suggestedDifficulty": "Medium" }
+    { "code": "some-lo-id-1", "topicName": "[T\xEAn ch\u1EE7 \u0111\u1EC1 y\u1EBFu]", "reason": "review", "suggestedDifficulty": "Easy" },
+    { "code": "some-lo-id-2", "topicName": "[T\xEAn ch\u1EE7 \u0111\u1EC1 kh\xE1m ph\xE1]", "reason": "explore", "suggestedDifficulty": "Medium" }
   ]
 }
 
@@ -2997,7 +2961,7 @@ zod.z.object({
   startDate: zod.z.string().describe("The start date for the analysis period in ISO format (YYYY-MM-DD)."),
   endDate: zod.z.string().describe("The end date for the analysis period in ISO format (YYYY-MM-DD)."),
   allAvailableTopics: zod.z.array(zod.z.object({
-    loId: zod.z.string(),
+    code: zod.z.string(),
     subject: zod.z.string(),
     category: zod.z.string(),
     topic: zod.z.string()
@@ -3008,7 +2972,7 @@ var RoadmapItemSchema = zod.z.object({
   topicName: zod.z.string(),
   reason: zod.z.string(),
   suggestedDifficulty: zod.z.enum(["Very Easy", "Easy", "Medium", "Hard", "Expert"]),
-  loId: zod.z.string(),
+  code: zod.z.string(),
   isCompleted: zod.z.boolean()
 });
 var WeeklyRoadmapSchema = zod.z.object({
@@ -3073,7 +3037,7 @@ All topic names and loIds in your "weeklyRoadmap" output MUST be chosen directly
     - **gamificationRemarks**: Write an encouraging message mentioning their achievements.
 2.  **For "weeklyRoadmap":**
     - Create a 5-item roadmap for the upcoming week.
-    - Prioritize the "areasForImprovement" you identified. For each, find the corresponding entry in "All Available Topics" and use its "topicName" and "loId".
+    - Prioritize the "areasForImprovement" you identified. For each, find the corresponding entry in "All Available Topics" and use its "topicName" and "code".
     - If more items are needed, select related topics from "All Available Topics".
 
 **IF Practice History IS EMPTY:**
@@ -3084,7 +3048,7 @@ All topic names and loIds in your "weeklyRoadmap" output MUST be chosen directly
     - **gamificationRemarks**: Write a general motivational message about starting to learn.
 2.  **For "weeklyRoadmap":**
     - Create a 5-item "starter" roadmap.
-    - Select 5 diverse and foundational topics directly from the "All Available Topics" list. Use their exact "topicName" and "loId".
+    - Select 5 diverse and foundational topics directly from the "All Available Topics" list. Use their exact "topicName" and "code".
     - For the "reason", explain that this is a good starting point to explore the subject.
 
 --- END LOGIC FLOW ---
@@ -3112,7 +3076,7 @@ The 'suggestedDifficulty' field MUST ALWAYS be one of these exact English string
         "topicName": "Topic C",
         "reason": "To strengthen your understanding of this key area.",
         "suggestedDifficulty": "Easy",
-        "loId": "lo-id-for-topic-c-from-the-list",
+        "code": "lo-id-for-topic-c-from-the-list",
         "isCompleted": false
       }
     ]
@@ -3350,11 +3314,11 @@ Now, generate the JSON for the requested knowledge card.`;
   }
 }
 var LearningObjectiveContextSchema = zod.z.object({
-  loId: zod.z.string(),
+  code: zod.z.string(),
   subject: zod.z.string(),
   category: zod.z.string(),
   topic: zod.z.string(),
-  loDescription: zod.z.string()
+  description: zod.z.string()
 });
 zod.z.object({
   language: zod.z.string().default("English"),
@@ -3362,7 +3326,7 @@ zod.z.object({
   learningObjectives: zod.z.array(LearningObjectiveContextSchema).min(1, { message: "At least one learning objective is required for mapping." })
 });
 var MappedLOSchema = zod.z.object({
-  loId: zod.z.string().describe("The exact loId from the provided learning objectives list that matches the document content."),
+  code: zod.z.string().describe("The exact code from the provided learning objectives list that matches the document content."),
   confidence: zod.z.number().min(0).max(100).describe("A confidence score (0-100) of how well the document maps to this LO."),
   reasoning: zod.z.string().describe("A brief explanation for why this mapping is relevant.")
 });
@@ -3398,7 +3362,7 @@ You are an expert curriculum analyst. Your task is to analyze a given document a
 1.  **Overall Relevance Assessment:** Read the document content and compare it against the entire list of LOs. Assign an overall "relevanceScore" from 0 (completely unrelated) to 100 (perfectly aligned with one or more LOs).
 
 2.  **Specific Mapping:** Identify which specific LOs from the list are directly addressed by the document. For each match you find, provide:
-    - The exact "loId" of the matched LO.
+    - The exact "code" of the matched LO.
     - A "confidence" score (0-100) for that specific match.
     - A brief "reasoning" in ${language} explaining why the document content maps to that LO.
 
@@ -3413,7 +3377,7 @@ Return a single, valid JSON object in this EXACT format. Do not include any othe
   "isFreestyleRecommended": false,
   "mappedLOs": [
     {
-      "loId": "SWIFT_FUNC_01",
+      "code": "SWIFT_FUNC_01",
       "confidence": 95,
       "reasoning": "The document provides a detailed explanation of function syntax and default parameters, which directly aligns with this learning objective."
     }
@@ -3502,7 +3466,7 @@ Return the response as a single JSON object with a key "generatedQuestions" cont
       "correctTempOptionId": "A",
       "explanation": "The document states that mitochondria are the powerhouses of the cell, responsible for cellular respiration.",
       "points": 10,
-      "difficulty": "medium",
+      "difficulty": "Medium",
       "topic": "Cell Biology"
     },
     {
@@ -3511,7 +3475,7 @@ Return the response as a single JSON object with a key "generatedQuestions" cont
       "correctAnswer": false,
       "explanation": "The text specifies that the cell wall is a feature of plant cells, not animal cells.",
       "points": 10,
-      "difficulty": "easy",
+      "difficulty": "Easy",
       "topic": "Cell Biology"
     }
   ]