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

package/dist/ai.mjs

@@ -92,12 +92,12 @@ var QuizContextSchema = z.object({
   originalSubject: z.string().optional(),
   originalCategory: z.string().optional(),
   originalTopic: z.string().optional(),
-  loDescription: z.string().optional().describe("The full description of the learning objective for deep context."),
+  description: z.string().optional().describe("The full description of the learning objective for deep context."),
   gradeBand: z.string().optional()
 });
 var BaseQuestionGenerationClientInputSchema = z.object({
   language: z.string().optional().default("English"),
-  difficulty: z.enum(["easy", "medium", "hard"]),
+  difficulty: z.enum(["Easy", "Medium", "Hard"]),
   quizContext: QuizContextSchema.optional(),
   imageUrl: z.string().url().optional().describe("Optional URL of an image to be used as context.")
 });
@@ -106,7 +106,7 @@ var BaseQuestionZodSchema = z.object({
   prompt: z.string().min(1),
   points: z.number().min(0).optional(),
   explanation: z.string().optional(),
-  difficulty: z.enum(["easy", "medium", "hard"]).optional(),
+  difficulty: z.enum(["Easy", "Medium", "Hard"]).optional(),
   topic: z.string().optional(),
   category: z.string().optional(),
   subject: z.string().optional(),
@@ -202,7 +202,7 @@ var AITrueFalseOutputFieldsSchema = z.object({
   correctAnswer: z.boolean(),
   explanation: z.string().optional().describe("An explanation of why the statement is true or false, especially important if false."),
   points: z.number().optional().default(10),
-  difficulty: z.enum(["easy", "medium", "hard"]).optional(),
+  difficulty: z.enum(["Easy", "Medium", "Hard"]).optional(),
   topic: z.string().optional(),
   verifiedCategory: z.string().optional()
   // Thêm để xác thực
@@ -223,7 +223,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,
@@ -234,7 +234,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);
@@ -364,7 +364,7 @@ var AIMCQOutputFieldsSchema = z.object({
   correctTempOptionId: z.string().describe("The temporary ID of the correct option from the generated options array."),
   explanation: z.string().optional().describe("A brief explanation of why the answer is correct."),
   points: z.number().optional().default(10),
-  difficulty: z.enum(["easy", "medium", "hard"]).optional(),
+  difficulty: z.enum(["Easy", "Medium", "Hard"]).optional(),
   topic: z.string().optional(),
   verifiedCategory: z.string().optional().describe("The category this question actually addresses.")
 });
@@ -383,7 +383,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}"`,
@@ -400,7 +400,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);
@@ -542,7 +542,7 @@ var AIMRQOutputFieldsSchema = z.object({
   correctTempOptionIds: z.array(z.string()).min(1),
   explanation: z.string().optional(),
   points: z.number().optional().default(10),
-  difficulty: z.enum(["easy", "medium", "hard"]).optional(),
+  difficulty: z.enum(["Easy", "Medium", "Hard"]).optional(),
   topic: z.string().optional(),
   verifiedCategory: z.string().optional().describe("The category this question actually addresses.")
 });
@@ -561,7 +561,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}"`,
@@ -579,7 +579,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);
@@ -737,7 +737,7 @@ var AIShortAnswerOutputFieldsSchema = z.object({
   // isCaseSensitive không cần thiết ở đây, chúng ta sẽ quản lý nó ở phía client
   explanation: z.string().optional(),
   points: z.number().optional().default(10),
-  difficulty: z.enum(["easy", "medium", "hard"]).optional(),
+  difficulty: z.enum(["Easy", "Medium", "Hard"]).optional(),
   topic: z.string().optional(),
   verifiedCategory: z.string().optional()
   // Thêm để xác thực
@@ -757,7 +757,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}"`
@@ -767,7 +767,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);
@@ -894,7 +894,7 @@ var AINumericOutputFieldsSchema = z.object({
   tolerance: z.number().min(0).optional(),
   explanation: z.string().optional(),
   points: z.number().optional().default(10),
-  difficulty: z.enum(["easy", "medium", "hard"]).optional(),
+  difficulty: z.enum(["Easy", "Medium", "Hard"]).optional(),
   topic: z.string().optional(),
   verifiedCategory: z.string().optional()
   // Thêm để xác thực
@@ -914,7 +914,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}"`
@@ -930,7 +930,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);
@@ -1074,7 +1074,7 @@ var AIFillInTheBlanksOutputFieldsSchema = z.object({
   })).min(1).describe("An array of text and blank segments representing the question."),
   explanation: z.string().optional(),
   points: z.number().optional().default(10),
-  difficulty: z.enum(["easy", "medium", "hard"]).optional(),
+  difficulty: z.enum(["Easy", "Medium", "Hard"]).optional(),
   topic: z.string().optional(),
   verifiedCategory: z.string().optional()
   // Thêm để xác thực
@@ -1094,7 +1094,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}"`
@@ -1108,7 +1108,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);
@@ -1256,7 +1256,7 @@ var AISequenceOutputFieldsSchema = z.object({
   itemsInCorrectOrder: z.array(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: z.string().optional(),
   points: z.number().optional().default(10),
-  difficulty: z.enum(["easy", "medium", "hard"]).optional(),
+  difficulty: z.enum(["Easy", "Medium", "Hard"]).optional(),
   topic: z.string().optional(),
   verifiedCategory: z.string().optional()
   // Thêm để xác thực
@@ -1276,7 +1276,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}"`
@@ -1291,7 +1291,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);
@@ -1427,7 +1427,7 @@ var AIMatchingOutputFieldsSchema = z.object({
   })).min(2),
   explanation: z.string().optional(),
   points: z.number().optional().default(10),
-  difficulty: z.enum(["easy", "medium", "hard"]).optional(),
+  difficulty: z.enum(["Easy", "Medium", "Hard"]).optional(),
   topic: z.string().optional(),
   verifiedCategory: z.string().optional()
   // Thêm để xác thực
@@ -1447,7 +1447,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}"`
@@ -1461,7 +1461,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);
@@ -1622,7 +1622,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}"`
@@ -2494,10 +2494,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;
@@ -2507,24 +2503,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 [];
@@ -2536,9 +2523,6 @@ var TopicDataService = class {
       return [];
     }
   }
-  /**
-   * Removes all learning objective data from Local Storage.
-   */
   static clearData() {
     try {
       if (typeof window === "undefined") return;
@@ -2547,11 +2531,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) {
@@ -2573,6 +2552,7 @@ var TopicDataService = class {
       }
       const [
         loId,
+        name,
         loDescription,
         subject,
         category,
@@ -2582,18 +2562,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)
       };
@@ -2601,40 +2584,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);
@@ -2682,9 +2646,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;
@@ -2697,7 +2661,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,
@@ -2710,7 +2674,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 = {
@@ -2899,7 +2863,7 @@ z.object({
     }))
   })).optional(),
   allAvailableTopics: z.array(z.object({
-    loId: z.string(),
+    code: z.string(),
     subject: z.string(),
     category: z.string(),
     topic: z.string()
@@ -2908,7 +2872,7 @@ z.object({
 var PracticeSuggestionOutputSchema = z.object({
   suggestionText: z.string().describe("The personalized message from the AI tutor in Markdown format."),
   suggestedTopics: z.array(z.object({
-    loId: z.string(),
+    code: z.string(),
     topicName: z.string(),
     reason: z.enum(["review", "explore"]),
     suggestedDifficulty: z.enum(["Very Easy", "Easy", "Medium", "Hard", "Expert"])
@@ -2949,8 +2913,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" }
   ]
 }
 
@@ -2995,7 +2959,7 @@ z.object({
   startDate: z.string().describe("The start date for the analysis period in ISO format (YYYY-MM-DD)."),
   endDate: z.string().describe("The end date for the analysis period in ISO format (YYYY-MM-DD)."),
   allAvailableTopics: z.array(z.object({
-    loId: z.string(),
+    code: z.string(),
     subject: z.string(),
     category: z.string(),
     topic: z.string()
@@ -3006,7 +2970,7 @@ var RoadmapItemSchema = z.object({
   topicName: z.string(),
   reason: z.string(),
   suggestedDifficulty: z.enum(["Very Easy", "Easy", "Medium", "Hard", "Expert"]),
-  loId: z.string(),
+  code: z.string(),
   isCompleted: z.boolean()
 });
 var WeeklyRoadmapSchema = z.object({
@@ -3071,7 +3035,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:**
@@ -3082,7 +3046,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 ---
@@ -3110,7 +3074,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
       }
     ]
@@ -3348,11 +3312,11 @@ Now, generate the JSON for the requested knowledge card.`;
   }
 }
 var LearningObjectiveContextSchema = z.object({
-  loId: z.string(),
+  code: z.string(),
   subject: z.string(),
   category: z.string(),
   topic: z.string(),
-  loDescription: z.string()
+  description: z.string()
 });
 z.object({
   language: z.string().default("English"),
@@ -3360,7 +3324,7 @@ z.object({
   learningObjectives: z.array(LearningObjectiveContextSchema).min(1, { message: "At least one learning objective is required for mapping." })
 });
 var MappedLOSchema = z.object({
-  loId: z.string().describe("The exact loId from the provided learning objectives list that matches the document content."),
+  code: z.string().describe("The exact code from the provided learning objectives list that matches the document content."),
   confidence: z.number().min(0).max(100).describe("A confidence score (0-100) of how well the document maps to this LO."),
   reasoning: z.string().describe("A brief explanation for why this mapping is relevant.")
 });
@@ -3396,7 +3360,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.
 
@@ -3411,7 +3375,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."
     }
@@ -3500,7 +3464,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"
     },
     {
@@ -3509,7 +3473,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"
     }
   ]