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

package/dist/react-ui.mjs

@@ -100064,899 +100064,638 @@ async function generateMCQQuestion(clientInput, apiKey) {
   return { error: errorMessage };
 }
 
-// src/react-ui/components/authoring/AIQuestionGeneratorModal.tsx
-var supportedQuestionTypesForAI = [
-  { value: "true_false", label: "True/False" },
-  { value: "multiple_choice", label: "Multiple Choice" },
-  { value: "multiple_response", label: "Multiple Response" },
-  { value: "short_answer", label: "Short Answer" },
-  { value: "numeric", label: "Numeric" },
-  { value: "fill_in_the_blanks", label: "Fill In The Blanks" },
-  { value: "sequence", label: "Sequence" },
-  { value: "matching", label: "Matching" }
-];
-var AIQuestionGeneratorModal = ({
-  isOpen,
-  onClose,
-  onQuestionGenerated,
-  language: language3,
-  questionType: questionTypeProp,
-  subjects = [],
-  topics = [],
-  gradeLevels = [],
-  bloomLevels = []
-}) => {
-  const [prompt, setPrompt] = useState("");
-  const [isLoading, setIsLoading] = useState(false);
-  const [error, setError] = useState(null);
-  const { toast: toast2 } = useToast();
-  const [subjectCode, setSubjectCode] = useState("");
-  const [topicCode, setTopicCode] = useState("");
-  const [gradeBand, setGradeBand] = useState("");
-  const [bloomLevelCode, setBloomLevelCode] = useState("");
-  const [selectedQuestionType, setSelectedQuestionType] = useState("multiple_choice");
-  const [isApiKeyManagerModalOpen, setIsApiKeyManagerModalOpen] = useState(false);
-  const [geminiApiKeyExists, setGeminiApiKeyExists] = useState(false);
-  const finalQuestionType = questionTypeProp || selectedQuestionType;
-  useEffect(() => {
-    if (isOpen) {
-      setPrompt("");
-      setError(null);
-      setIsLoading(false);
-      setSubjectCode("");
-      setTopicCode("");
-      setGradeBand("");
-      setBloomLevelCode("");
-      setSelectedQuestionType(questionTypeProp || "multiple_choice");
-      setGeminiApiKeyExists(APIKeyService.hasAPIKey(GEMINI_API_KEY_SERVICE_NAME));
-    }
-  }, [isOpen, questionTypeProp]);
-  const filteredTopics = useMemo(() => {
-    if (!subjectCode) return [];
-    return topics.filter((t4) => t4.subjectCode === subjectCode);
-  }, [subjectCode, topics]);
-  const handleApiKeyModalClose = () => {
-    setIsApiKeyManagerModalOpen(false);
-    setGeminiApiKeyExists(APIKeyService.hasAPIKey(GEMINI_API_KEY_SERVICE_NAME));
-  };
-  const handleSubmit = async () => {
-    if (!prompt.trim()) {
-      setError("Please provide a prompt for the question.");
-      return;
-    }
-    const geminiKey = APIKeyService.getAPIKey(GEMINI_API_KEY_SERVICE_NAME);
-    if (!geminiKey) {
-      setError("Gemini API Key is not set. Please configure it.");
-      setGeminiApiKeyExists(false);
-      return;
-    }
-    setGeminiApiKeyExists(true);
-    setError(null);
-    setIsLoading(true);
-    try {
-      const quizContext = {
-        plannedTopic: prompt,
-        originalSubject: subjectCode,
-        originalTopic: topicCode,
-        gradeBand,
-        plannedBloomLevel: bloomLevelCode
-      };
-      const baseClientInput = {
-        language: language3,
-        difficulty: "medium",
-        quizContext
-      };
-      let generatedResult = {};
-      switch (finalQuestionType) {
-        case "true_false":
-          generatedResult = await generateTrueFalseQuestion(baseClientInput, geminiKey);
-          break;
-        case "multiple_choice":
-          generatedResult = await generateMCQQuestion({ ...baseClientInput, numberOfOptions: 4 }, geminiKey);
-          break;
-        // Add other cases as needed
-        default:
-          throw new Error(`AI generation for '${finalQuestionType}' is not implemented in this flow.`);
-      }
-      if (generatedResult.error) {
-        throw new Error(generatedResult.error);
-      }
-      if (generatedResult.question) {
-        const completeQuestion = generatedResult.question;
-        completeQuestion.subject = subjectCode;
-        completeQuestion.topic = topicCode;
-        completeQuestion.gradeBand = gradeBand;
-        completeQuestion.bloomLevel = bloomLevelCode;
-        if (completeQuestion.points === void 0) completeQuestion.points = 10;
-        onQuestionGenerated(completeQuestion);
-        toast2({ title: "AI Question Generated", description: "Review and edit the generated question." });
-        onClose();
-      } else {
-        throw new Error("AI did not return a valid question object.");
-      }
-    } catch (e3) {
-      console.error("AI Question Generation Error:", e3);
-      let errorMessage = e3.message || "An unknown error occurred.";
-      if (typeof errorMessage === "string" && errorMessage.includes("API key not valid")) {
-        errorMessage = "The provided Google Gemini API Key is invalid. Please check it.";
-        setGeminiApiKeyExists(false);
-      }
-      setError(errorMessage);
-      toast2({ title: "AI Generation Failed", description: errorMessage, variant: "destructive" });
-    } finally {
-      setIsLoading(false);
-    }
-  };
-  const comboboxOptions = {
-    subjects: subjects.map((s4) => ({ value: s4.code, label: s4.name })),
-    topics: filteredTopics.map((t4) => ({ value: t4.code, label: t4.name })),
-    gradeLevels: gradeLevels.map((g) => ({ value: g.code, label: g.name })),
-    bloomLevels: bloomLevels.map((b2) => ({ value: b2.code, label: b2.name }))
-  };
-  return /* @__PURE__ */ React169__default.createElement(React169__default.Fragment, null, /* @__PURE__ */ React169__default.createElement(Dialog2, { open: isOpen, onOpenChange: (open) => {
-    if (!open) onClose();
-  } }, /* @__PURE__ */ React169__default.createElement(DialogContent2, { className: "sm:max-w-[600px]" }, /* @__PURE__ */ React169__default.createElement(DialogHeader, null, /* @__PURE__ */ React169__default.createElement(DialogTitle2, { className: "flex items-center font-headline text-2xl" }, /* @__PURE__ */ React169__default.createElement(WandSparkles, { className: "mr-2 h-6 w-6 text-primary" }), " AI Question Generator"), /* @__PURE__ */ React169__default.createElement(DialogDescription2, null, "Provide a prompt and metadata to generate a '", finalQuestionType, "' question.")), /* @__PURE__ */ React169__default.createElement("div", { className: "space-y-4 py-4 max-h-[60vh] overflow-y-auto px-2" }, !geminiApiKeyExists && /* @__PURE__ */ React169__default.createElement("div", { className: "p-3 mb-4 border border-amber-500 bg-amber-50 rounded-md text-amber-700" }), !questionTypeProp && /* @__PURE__ */ React169__default.createElement("div", { className: "space-y-2" }, /* @__PURE__ */ React169__default.createElement(Label2, { htmlFor: "ai-q-type-select" }, "Question Type"), /* @__PURE__ */ React169__default.createElement(Select2, { value: selectedQuestionType, onValueChange: (v) => setSelectedQuestionType(v) }, /* @__PURE__ */ React169__default.createElement(SelectTrigger2, { id: "ai-q-type-select" }, /* @__PURE__ */ React169__default.createElement(SelectValue2, null)), /* @__PURE__ */ React169__default.createElement(SelectContent2, null, supportedQuestionTypesForAI.map((type) => /* @__PURE__ */ React169__default.createElement(SelectItem2, { key: type.value, value: type.value }, type.label))))), /* @__PURE__ */ React169__default.createElement("div", { className: "space-y-2" }, /* @__PURE__ */ React169__default.createElement(Label2, { htmlFor: "ai-prompt" }, "Prompt / Topic"), /* @__PURE__ */ React169__default.createElement(
-    Textarea,
-    {
-      id: "ai-prompt",
-      value: prompt,
-      onChange: (e3) => setPrompt(e3.target.value),
-      placeholder: "e.g., The process of photosynthesis, The causes of World War II, Basic Algebra Equations",
-      className: "min-h-[100px]"
-    }
-  )), /* @__PURE__ */ React169__default.createElement("div", { className: "grid grid-cols-2 gap-4" }, /* @__PURE__ */ React169__default.createElement("div", { className: "space-y-2" }, /* @__PURE__ */ React169__default.createElement(Label2, null, "Subject"), /* @__PURE__ */ React169__default.createElement(EditableCombobox, { options: comboboxOptions.subjects, value: subjectCode, onChange: setSubjectCode, placeholder: "Select or type a Subject..." })), /* @__PURE__ */ React169__default.createElement("div", { className: "space-y-2" }, /* @__PURE__ */ React169__default.createElement(Label2, null, "Topic"), /* @__PURE__ */ React169__default.createElement(EditableCombobox, { options: comboboxOptions.topics, value: topicCode, onChange: setTopicCode, placeholder: "Select or type a Topic...", disabled: !subjectCode })), /* @__PURE__ */ React169__default.createElement("div", { className: "space-y-2" }, /* @__PURE__ */ React169__default.createElement(Label2, null, "Grade Level"), /* @__PURE__ */ React169__default.createElement(EditableCombobox, { options: comboboxOptions.gradeLevels, value: gradeBand, onChange: setGradeBand, placeholder: "Select or type a Grade..." })), /* @__PURE__ */ React169__default.createElement("div", { className: "space-y-2" }, /* @__PURE__ */ React169__default.createElement(Label2, null, "Bloom's Level"), /* @__PURE__ */ React169__default.createElement(EditableCombobox, { options: comboboxOptions.bloomLevels, value: bloomLevelCode, onChange: setBloomLevelCode, placeholder: "Select a Bloom's Level..." }))), error && /* @__PURE__ */ React169__default.createElement("p", { className: "text-sm text-destructive flex items-center mt-2" }, /* @__PURE__ */ React169__default.createElement(TriangleAlert, { className: "mr-1 h-4 w-4" }), " ", error)), /* @__PURE__ */ React169__default.createElement(DialogFooter, null, /* @__PURE__ */ React169__default.createElement(DialogClose2, { asChild: true }, /* @__PURE__ */ React169__default.createElement(Button, { type: "button", variant: "outline" }, "Cancel")), /* @__PURE__ */ React169__default.createElement(Button, { type: "button", onClick: handleSubmit, disabled: isLoading || !prompt.trim() || !geminiApiKeyExists }, isLoading ? /* @__PURE__ */ React169__default.createElement(LoaderCircle, { className: "mr-2 h-4 w-4 animate-spin" }) : /* @__PURE__ */ React169__default.createElement(WandSparkles, { className: "mr-2 h-4 w-4" }), "Generate Question")))), /* @__PURE__ */ React169__default.createElement(APIKeyManagerModal, { isOpen: isApiKeyManagerModalOpen, onClose: handleApiKeyModalClose }));
-};
-
-// src/react-ui/components/authoring/AIFullQuizGeneratorModal.tsx
-init_react_shim();
-
-// src/ai/flows/generate-quiz-plan.ts
+// src/ai/flows/question-gen/generate-mrq-question.ts
 init_react_shim();
 
-// src/ai/flows/generate-quiz-plan-types.ts
+// src/ai/flows/question-gen/generate-mrq-question-types.ts
 init_react_shim();
-var TopicWithMetadataSchema = z.object({
-  topic: z.string().min(1),
-  ratio: z.number().min(0).max(100),
-  originalLoId: z.string().optional(),
-  originalSubject: z.string().optional(),
-  originalCategory: z.string().optional(),
-  originalTopic: z.string().optional(),
-  commonMisconceptions: z.array(z.string()).optional()
-});
-var BloomLevelStringsEnum = z.enum(["remembering", "understanding", "applying", "analyzing", "evaluating", "creating"]);
-var fullQuizSupportedQuestionTypesArray = [
-  "true_false",
-  "multiple_choice",
-  "multiple_response",
-  "short_answer",
-  "numeric",
-  "fill_in_the_blanks",
-  "sequence",
-  "matching",
-  "drag_and_drop",
-  "coding"
-];
-z.object({
-  language: z.string().optional().default("English"),
-  totalQuestions: z.number().int().min(1).max(50),
-  numCodingQuestions: z.number().optional().default(0),
-  topics: z.array(TopicWithMetadataSchema).min(1),
-  bloomLevels: z.array(z.object({
-    level: BloomLevelStringsEnum,
-    ratio: z.number().min(0).max(100)
-  })).min(1),
-  selectedContextIds: z.array(z.string()).optional(),
-  selectedQuestionTypes: z.array(z.enum(fullQuizSupportedQuestionTypesArray)).min(1),
-  imageContexts: z.array(z.custom()).optional().describe("Library of available image contexts for the AI to use.")
-});
-var PlannedQuestionSchema = z.object({
-  plannedTopic: z.string().min(1).describe("The specific, assessable topic for this question."),
-  plannedQuestionType: z.enum(fullQuizSupportedQuestionTypesArray).describe("The specific question type chosen."),
-  plannedBloomLevel: BloomLevelStringsEnum.describe("The Bloom's level assigned."),
-  plannedContextId: z.string().optional().describe("The specific context ID chosen for this question."),
-  imageId: z.string().nullable().optional().describe("The ID of the image from the context library to be used for this question."),
-  targetMisconception: z.string().optional().describe("A specific common misconception this question should target."),
-  difficultyReason: z.string().optional().describe("Strategic explanation of difficulty choice and placement."),
-  topicSpecificity: z.enum(["broad", "focused", "specific"]).optional().describe("How specific the topic coverage should be."),
-  originalLoId: z.string().optional(),
-  originalSubject: z.string().optional(),
-  originalCategory: z.string().optional(),
-  originalTopic: z.string().optional()
+BaseQuestionGenerationClientInputSchema.extend({
+  numberOfOptions: z.number().int().min(2).max(8).optional().default(5),
+  minCorrectAnswers: z.number().int().min(1).optional().default(2),
+  maxCorrectAnswers: z.number().int().min(1).optional().default(3)
 });
-var GenerateQuizPlanOutputSchema = z.object({
-  quizPlan: z.array(PlannedQuestionSchema).describe("A detailed plan for each question in the quiz."),
-  diversityMetrics: z.object({
-    questionTypeDistribution: z.record(z.number()).optional(),
-    bloomLevelDistribution: z.record(z.number()).optional(),
-    maxConsecutiveSameType: z.number().optional()
-  }).optional().describe("Metrics showing the diversity achieved in the plan."),
-  planningStrategy: z.object({
-    overallApproach: z.string().optional(),
-    keyDecisions: z.array(z.string()).optional()
-  }).optional()
+var AIMRQOutputFieldsSchema = z.object({
+  prompt: z.string(),
+  options: z.array(z.object({ tempId: z.string(), text: z.string() })).min(2).max(8),
+  correctTempOptionIds: z.array(z.string()).min(1),
+  explanation: z.string().optional(),
+  points: z.number().optional().default(10),
+  difficulty: z.enum(["easy", "medium", "hard"]).optional(),
+  topic: z.string().optional(),
+  verifiedCategory: z.string().optional().describe("The category this question actually addresses.")
 });
 
-// src/ai/flows/generate-quiz-plan.ts
-var QuizPlanLogger = class {
-  constructor() {
-    this.logs = [];
-    this.startTime = Date.now();
-  }
-  log(phase, data, duration) {
-    this.logs.push({
-      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-      phase,
-      data,
-      duration
-    });
-    if (duration !== void 0) {
-      console.log(`[${phase}] Completed in ${duration}ms:`, data);
-    } else {
-      console.log(`[${phase}]:`, data);
-    }
-  }
-  getLogs() {
-    return this.logs;
-  }
-  getTotalDuration() {
-    return Date.now() - this.startTime;
-  }
-};
-function generateQuestionTypeSelectionGuidance() {
-  return `
-QUESTION TYPE SELECTION BEST PRACTICES:
-
-**TRUE_FALSE (true_false)**
-- Best for: Binary concepts, fact verification, common misconceptions
-- Bloom levels: Primarily Remembering, Understanding
-- Use when: Testing definitive statements, clarifying misconceptions
-- Example: "Photosynthesis only occurs during daytime" (targets timing misconception)
-
-**MULTIPLE CHOICE (multiple_choice)**
-- Best for: Concept selection, process understanding, comparison
-- Bloom levels: All levels, especially Understanding and Applying
-- Use when: Testing conceptual understanding with clear alternatives
-- Example: "Which factor most affects enzyme activity?" (applying knowledge)
-
-**MULTIPLE RESPONSE (multiple_response)**
-- Best for: Identifying multiple correct factors, comprehensive understanding
-- Bloom levels: Understanding, Analyzing, Evaluating
-- Use when: Multiple correct answers exist, testing thorough knowledge
-- Example: "Select all factors that influence plant growth" (analyzing components)
-
-**FILL IN THE BLANKS (fill_in_the_blanks)**
-- Best for: Key terminology, formulas, specific facts
-- Bloom levels: Remembering, Understanding
-- Use when: Testing precise recall of important terms/concepts
-- Example: "The process of _____ converts light energy to chemical energy"
-
-**NUMERIC (numeric)**
-- Best for: Calculations, quantitative problems, formula application
-- Bloom levels: Applying, Analyzing
-- Use when: Mathematical computations are required
-- Example: "Calculate the molarity of a 2L solution containing 0.5 moles of NaCl"
-
-**MATCHING (matching)**
-- Best for: Connecting related concepts, terminology pairs
-- Bloom levels: Remembering, Understanding
-- Use when: Testing relationships between terms and definitions
-- Example: Match organelles with their functions
-
-**SEQUENCE (sequence)**
-- Best for: Process steps, chronological order, procedural knowledge
-- Bloom levels: Understanding, Applying, Analyzing
-- Use when: Order or sequence is critical to understanding
-- Example: "Arrange the steps of mitosis in correct order"
-
-**DRAG AND DROP (drag_and_drop)**
-- Best for: Categorization, classification, spatial relationships
-- Bloom levels: Understanding, Applying, Analyzing
-- Use when: Grouping or organizing information is key
-- Example: "Classify these compounds as acids, bases, or neutral"
-
-**SHORT ANSWER (short_answer)**
-- Best for: Explanations, definitions, problem-solving steps
-- Bloom levels: Understanding, Applying, Analyzing, Evaluating, Creating
-- Use when: Requiring explanatory responses, open-ended thinking
-- Example: "Explain why enzymes are specific to certain substrates"
-
-**CODING (coding)**
-- Best for: Programming problems, algorithm implementation
-- Bloom levels: Applying, Analyzing, Evaluating, Creating
-- Use when: Technical implementation or code analysis is required
-- Example: "Write a function to calculate factorial recursively"
-`;
-}
-function generateAdvancedBloomGuidance() {
-  return `
-ADVANCED BLOOM'S TAXONOMY & QUESTION TYPE OPTIMIZATION:
-
-**REMEMBERING (Knowledge Recall)**
-- Primary types: true_false, fill_in_the_blanks, matching
-- Secondary types: multiple_choice (simple recall)
-- Focus: Facts, terms, basic concepts, definitions
-- Misconception addressing: Use true_false to clarify common confusions
-
-**UNDERSTANDING (Comprehension)**
-- Primary types: multiple_choice, short_answer, matching
-- Secondary types: multiple_response, sequence
-- Focus: Explanations, interpretations, examples, classifications
-- Best for: "Explain why...", "What does this mean...", "Give an example..."
+// src/ai/flows/question-gen/generate-mrq-question.ts
+var MAX_RETRY_ATTEMPTS3 = 3;
+var RETRY_DELAY_MS3 = 3e3;
+function buildEnhancedPrompt3(clientInput, attemptNumber) {
+  const { quizContext, language: language3, difficulty, numberOfOptions, minCorrectAnswers, maxCorrectAnswers, imageUrl } = clientInput;
+  const category = quizContext?.originalCategory || "the specified technical category";
+  const attemptInfo = attemptNumber > 1 ? `
+## DEBUG INFO - This is attempt #${attemptNumber}
+Previous attempts failed due to validation errors. Pay close attention to the number of correct answers and the JSON schema.
 
-**APPLYING (Using Knowledge)**
-- Primary types: numeric, short_answer, sequence, coding
-- Secondary types: multiple_choice, drag_and_drop
-- Focus: Problem-solving, implementing procedures, using methods
-- Best for: Calculations, step-by-step processes, practical applications
+` : "";
+  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}`,
+    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}"`,
+    quizContext?.difficultyReason && `**Pedagogical Reason:** ${quizContext.difficultyReason}`
+  ].filter(Boolean).map((s4) => `- ${s4}`).join("\n");
+  const exampleJson = JSON.stringify({
+    prompt: "Which of the following are considered programming paradigms?",
+    options: [
+      { "tempId": "A", "text": "Object-Oriented" },
+      { "tempId": "B", "text": "Assembly" },
+      { "tempId": "C", "text": "Functional" },
+      { "tempId": "D", "text": "Procedural" },
+      { "tempId": "E", "text": "Middleware" }
+    ],
+    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",
+    topic: "Programming Paradigms",
+    verifiedCategory: category
+  }, null, 2);
+  return `${attemptInfo}You are an expert Question Author for advanced technical education, specializing in the programming language: ${category}.
+Your sole mission is to create a high-quality, technically accurate Multiple Response Question. You must adhere to the following rules at all times.
 
-**ANALYZING (Breaking Down Information)**
-- Primary types: multiple_response, short_answer, sequence, coding
-- Secondary types: drag_and_drop, multiple_choice
-- Focus: Identifying components, relationships, cause-effect
-- Best for: "What are the factors...", "How do these relate...", "Break down..."
+## Core Rules (Non-negotiable)
+1.  **Category Purity:** The question, options, and explanation MUST be exclusively about **${category}**.
+2.  **Context Adherence:** The question's content must directly align with all provided context.
+3.  **Format Integrity:** You MUST return ONLY a single, valid JSON object that strictly follows the provided schema. Do not include any extra text or comments.
 
-**EVALUATING (Making Judgments)**
-- Primary types: short_answer, multiple_response, coding
-- Secondary types: multiple_choice (with justification)
-- Focus: Critiquing, judging, comparing alternatives, decision-making
-- Best for: "Which is better and why...", "Evaluate the approach...", "Critique..."
+## CRITICAL CONTEXT FOR THIS QUESTION
+${contextStrings}
 
-**CREATING (Producing New Work)**
-- Primary types: short_answer, coding, sequence
-- Secondary types: drag_and_drop (design tasks)
-- Focus: Designing, planning, producing, constructing
-- Best for: "Design a solution...", "Create a plan...", "Develop a strategy..."
-`;
-}
-function generateDiversityRules() {
-  return `
-ENHANCED DIVERSITY & QUALITY ASSURANCE RULES:
+## Task: Generate the Question
+Based on all the rules and context above, generate a single Multiple Response Question.
 
-**Question Type Distribution Strategy:**
-1. Never place more than 3 consecutive questions of the same type
-2. Distribute question types based on their cognitive complexity
-3. For quizzes with 10+ questions, use at least 4 different question types
-4. For quizzes with 20+ questions, use at least 6 different question types
-5. Balance quick-answer types (true_false, multiple_choice) with deeper types (short_answer, coding)
+### Input Parameters
+- **Topic for Question:** ${quizContext?.plannedTopic || "General"}
+- **Language for Text:** ${language3}
+- **Difficulty Level:** ${difficulty}
+- **Number of Options:** Generate exactly ${numberOfOptions} options.
+- **Number of Correct Answers:** The 'correctTempOptionIds' array MUST contain between ${minCorrectAnswers} and ${maxCorrectAnswers} valid IDs from the options you generate.
 
-**Intelligent Difficulty Progression:**
-1. Opening (20%): Start with confidence-building questions (Remembering/Understanding)
-2. Building (40%): Gradually increase complexity (Understanding/Applying)
-3. Peak (30%): Most challenging questions (Analyzing/Evaluating/Creating)
-4. Closing (10%): Moderate challenge to end positively
+### Required JSON Output Format
+Your response must be ONLY the JSON object, matching this exact structure and field names.
 
-**Misconception-Driven Planning:**
-- When common misconceptions are provided, prioritize question types that can effectively address them
-- Use true_false for binary misconceptions
-- Use multiple_choice for concept selection misconceptions
-- Use short_answer for complex misconceptions requiring explanation
+${exampleJson}
 
-**Contextual Intelligence:**
-- Programming/Technical topics: Favor coding, numeric, short_answer
-- Process-oriented topics: Favor sequence, short_answer, drag_and_drop
-- Conceptual topics: Favor multiple_choice, multiple_response, true_false
-- Factual topics: Favor fill_in_the_blanks, matching, true_false
-`;
+Now, generate the JSON for the requested question.`;
 }
-async function generateQuizPlan(clientInput, apiKey, imageContexts = []) {
-  const logger = new QuizPlanLogger();
-  try {
-    logger.log("VALIDATION_START", {
-      totalQuestions: clientInput.totalQuestions,
-      availableTypes: clientInput.selectedQuestionTypes,
-      topicCount: clientInput.topics.length,
-      bloomLevelCount: clientInput.bloomLevels.length
-    });
-    const totalTopicRatio = clientInput.topics.reduce((sum, t4) => sum + t4.ratio, 0);
-    if (Math.abs(totalTopicRatio - 100) > 1) {
-      throw new Error(`Total topic ratio must be 100%. Current sum: ${totalTopicRatio.toFixed(1)}%`);
-    }
-    const totalBloomRatio = clientInput.bloomLevels.reduce((sum, b2) => sum + b2.ratio, 0);
-    if (Math.abs(totalBloomRatio - 100) > 1) {
-      throw new Error(`Total Bloom level ratio must be 100%. Current sum: ${totalBloomRatio.toFixed(1)}%`);
+async function generateMRQQuestion(clientInput, apiKey) {
+  if (clientInput.minCorrectAnswers > clientInput.maxCorrectAnswers) {
+    return { error: `Invalid input: minCorrectAnswers (${clientInput.minCorrectAnswers}) cannot be greater than maxCorrectAnswers (${clientInput.maxCorrectAnswers}).` };
+  }
+  if (clientInput.maxCorrectAnswers >= clientInput.numberOfOptions) {
+    return { error: `Invalid input: maxCorrectAnswers (${clientInput.maxCorrectAnswers}) must be less than the total numberOfOptions (${clientInput.numberOfOptions}).` };
+  }
+  const ai = new GoogleGenAI({ apiKey });
+  const model = "gemini-2.5-flash";
+  const config3 = {
+    temperature: 0.8,
+    responseMimeType: "application/json",
+    thinkingConfig: {
+      thinkingBudget: 4e3
     }
-    logger.log("VALIDATION_SUCCESS", {
-      topicRatioSum: totalTopicRatio,
-      bloomRatioSum: totalBloomRatio
-    });
-    const aiStartTime = Date.now();
-    const ai = new GoogleGenAI({
-      apiKey
-    });
-    const model = "gemini-2.5-pro";
-    const config3 = {
-      temperature: 0.8,
-      thinkingConfig: {
-        thinkingBudget: 4096
-      },
-      responseMimeType: "application/json"
-    };
-    logger.log("AI_INITIALIZATION", { model }, Date.now() - aiStartTime);
-    const { language: language3, totalQuestions, numCodingQuestions = 0 } = clientInput;
-    const promptStartTime = Date.now();
-    const topicsDistribution = clientInput.topics.map((t4) => {
-      let topicString = `- Topic Context: "${t4.topic}", LoId: "${t4.originalLoId || "nil"}", Subject: "${t4.originalSubject || "nil"}", Category: "${t4.originalCategory || "nil"}", Topic: "${t4.originalTopic || "nil"}", Ratio: ${t4.ratio}%`;
-      if (t4.commonMisconceptions && t4.commonMisconceptions.length > 0) {
-        topicString += `
-    - Common Misconceptions: [${t4.commonMisconceptions.join(", ")}]`;
+  };
+  const attemptResults = [];
+  let lastError = null;
+  for (let attempt = 1; attempt <= MAX_RETRY_ATTEMPTS3; attempt++) {
+    const startTime = Date.now();
+    const promptText = buildEnhancedPrompt3(clientInput, attempt);
+    const promptHash = Buffer.from(promptText).toString("base64").slice(0, 10);
+    try {
+      DebugLogger.logPrompt(attempt, promptText, { ...clientInput, attemptNumber: attempt, promptHash });
+      const parts = [{ text: promptText }];
+      if (clientInput.imageUrl) {
+        const mimeType = clientInput.imageUrl.endsWith(".png") ? "image/png" : "image/jpeg";
+        const imagePart = await urlToGenerativePart(clientInput.imageUrl, mimeType);
+        parts.unshift(imagePart);
+      }
+      const contents = [{ role: "user", parts }];
+      const aiResult = await ai.models.generateContent({
+        model,
+        config: config3,
+        contents
+      });
+      const response = aiResult;
+      const rawText = response.candidates?.[0]?.content?.parts?.[0]?.text || "";
+      const duration = Date.now() - startTime;
+      DebugLogger.logResponse(attempt, rawText);
+      if (!rawText) {
+        throw new Error("AI returned an empty response.");
+      }
+      const parsedJson = JSON.parse(rawText);
+      DebugLogger.logValidation(attempt, "JSON Parsed Successfully", parsedJson);
+      const aiGeneratedContent = AIMRQOutputFieldsSchema.parse(parsedJson);
+      DebugLogger.logValidation(attempt, "Zod Schema Validated", aiGeneratedContent);
+      if (aiGeneratedContent.options.length !== clientInput.numberOfOptions) {
+        throw new Error(`AI generated ${aiGeneratedContent.options.length} options, but ${clientInput.numberOfOptions} were required.`);
+      }
+      const correctCount = aiGeneratedContent.correctTempOptionIds.length;
+      if (correctCount < clientInput.minCorrectAnswers || correctCount > clientInput.maxCorrectAnswers) {
+        throw new Error(`AI provided ${correctCount} correct answers, which is outside the required range of ${clientInput.minCorrectAnswers}-${clientInput.maxCorrectAnswers}.`);
+      }
+      if (clientInput.quizContext?.originalCategory) {
+        const verifiedCategory = aiGeneratedContent.verifiedCategory?.toLowerCase();
+        const requiredCategory = clientInput.quizContext.originalCategory.toLowerCase();
+        if (verifiedCategory && verifiedCategory !== requiredCategory) {
+          throw new Error(`Category mismatch: Required ${requiredCategory}, got ${verifiedCategory}`);
+        }
+      }
+      const finalOptions = [];
+      const tempIdToFinalIdMap = {};
+      const allTempIds = /* @__PURE__ */ new Set();
+      aiGeneratedContent.options.forEach((aiOption) => {
+        const finalId = generateUniqueId("opt_mr_");
+        finalOptions.push({ id: finalId, text: aiOption.text });
+        tempIdToFinalIdMap[aiOption.tempId] = finalId;
+        allTempIds.add(aiOption.tempId);
+      });
+      const finalCorrectAnswerIds = aiGeneratedContent.correctTempOptionIds.map((tempId) => {
+        if (!allTempIds.has(tempId)) {
+          throw new Error(`AI provided an invalid correctTempOptionId ('${tempId}') which does not exist in the generated options.`);
+        }
+        return tempIdToFinalIdMap[tempId];
+      });
+      const completeQuestion = {
+        id: generateUniqueId("mrq_ai_"),
+        questionType: "multiple_response",
+        prompt: aiGeneratedContent.prompt,
+        options: finalOptions,
+        correctAnswerIds: finalCorrectAnswerIds,
+        explanation: aiGeneratedContent.explanation,
+        points: aiGeneratedContent.points,
+        topic: aiGeneratedContent.topic || clientInput.quizContext?.originalTopic,
+        difficulty: aiGeneratedContent.difficulty || clientInput.difficulty,
+        contextCode: clientInput.quizContext?.plannedContextId,
+        bloomLevel: clientInput.quizContext?.plannedBloomLevel,
+        learningObjective: clientInput.quizContext?.originalLoId,
+        subject: clientInput.quizContext?.originalSubject,
+        category: clientInput.quizContext?.originalCategory,
+        imageUrl: clientInput.imageUrl
+      };
+      const validatedQuestion = MultipleResponseQuestionZodSchema.parse(completeQuestion);
+      attemptResults.push({ success: true, duration, promptLength: promptText.length, responseLength: rawText.length, promptHash });
+      console.log(`
+\u2705 MRQ generation successful on attempt ${attempt} (${duration}ms)`);
+      if (attempt > 1) DebugLogger.logAttemptSummary(attemptResults);
+      return { question: validatedQuestion };
+    } catch (error) {
+      lastError = error;
+      const duration = Date.now() - startTime;
+      attemptResults.push({ success: false, duration, error: error.message, promptLength: promptText.length, promptHash });
+      const willRetry = attempt < MAX_RETRY_ATTEMPTS3;
+      DebugLogger.logRetryInfo(attempt, error, willRetry);
+      if (willRetry) {
+        console.log(`\u23F3 Retrying in ${RETRY_DELAY_MS3}ms...`);
+        await new Promise((resolve) => setTimeout(resolve, RETRY_DELAY_MS3));
       }
-      return topicString;
-    }).join("\n    ");
-    const bloomDistribution = clientInput.bloomLevels.map(
-      (b2) => `- Level: "${b2.level}", Ratio: ${b2.ratio}%`
-    ).join("\n    ");
-    let questionTypesForPrompt = [...clientInput.selectedQuestionTypes];
-    if (numCodingQuestions === 0) {
-      questionTypesForPrompt = questionTypesForPrompt.filter(
-        (type) => type !== "short_answer" && type !== "coding"
-      );
     }
-    const allowedQuestionTypes = questionTypesForPrompt.map((t4) => `'${t4}'`).join(", ");
-    const codingRequirement = numCodingQuestions > 0 ? `
-**CRITICAL CODING REQUIREMENT**: Exactly ${numCodingQuestions} questions in the plan MUST be of type 'coding'. These should typically be at 'applying' or higher Bloom levels and focus on implementation, debugging, or algorithm design.` : "";
-    const imageContextSection = imageContexts && imageContexts.length > 0 ? `
-## AVAILABLE IMAGE CONTEXT LIBRARY
-You have access to a library of pre-described images. When planning a question, if its subject, category, and topic match an image in this library AND the image's description is relevant to the planned question's topic, you MUST include the corresponding \`imageId\` in your output. Otherwise, leave the \`imageId\` field null or omit it.
-
-\`\`\`json
-${JSON.stringify(imageContexts.map((img) => ({ imageId: img.id, subject: img.subject, category: img.category, topic: img.topic, description: img.detailedDescription })), null, 2)}
-\`\`\`
-` : "";
-    const enhancedPromptText = `You are an elite educational assessment architect with expertise in cognitive science and adaptive learning. Your mission is to create a strategically optimized quiz plan that maximizes learning effectiveness.
-
-${generateQuestionTypeSelectionGuidance()}
-
-${generateAdvancedBloomGuidance()}
-
-${generateDiversityRules()}
+  }
+  DebugLogger.logAttemptSummary(attemptResults);
+  const errorMessage = `Failed to generate MRQ question after ${MAX_RETRY_ATTEMPTS3} attempts. Last error: ${lastError?.message}`;
+  console.error("\n\u274C Final Result: FAILED");
+  console.error(errorMessage);
+  return { error: errorMessage };
+}
 
-## COMPREHENSIVE QUIZ REQUIREMENTS:
+// src/ai/flows/question-gen/generate-short-answer-question.ts
+init_react_shim();
 
-**Target Language**: ${language3}
-**Total Questions**: ${totalQuestions}${codingRequirement}
+// src/ai/flows/question-gen/generate-short-answer-question-types.ts
+init_react_shim();
+BaseQuestionGenerationClientInputSchema.extend({
+  isCaseSensitive: z.boolean().optional().default(false)
+});
+var AIShortAnswerOutputFieldsSchema = z.object({
+  prompt: z.string().describe("The question text that prompts the user for a short answer."),
+  acceptedAnswers: z.array(z.string().min(1)).min(1).describe("An array of one or more acceptable short answers. Include common variations if applicable."),
+  // 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(),
+  topic: z.string().optional(),
+  verifiedCategory: z.string().optional()
+  // Thêm để xác thực
+});
 
-**Topic Distribution & Learning Context** (follow precisely):
-    ${topicsDistribution}
+// src/ai/flows/question-gen/generate-short-answer-question.ts
+var MAX_RETRY_ATTEMPTS4 = 3;
+var RETRY_DELAY_MS4 = 3e3;
+function buildEnhancedPrompt4(clientInput, attemptNumber) {
+  const { quizContext, language: language3, difficulty, imageUrl } = clientInput;
+  const category = quizContext?.originalCategory || "the specified technical category";
+  const attemptInfo = attemptNumber > 1 ? `
+## DEBUG INFO - This is attempt #${attemptNumber}
+Previous attempts failed. Ensure 'acceptedAnswers' is a non-empty array of strings and the JSON is valid.
 
-**Cognitive Complexity Distribution** (follow precisely):
-    ${bloomDistribution}
+` : "";
+  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}`,
+    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}"`
+  ].filter(Boolean).map((s4) => `- ${s4}`).join("\n");
+  const exampleJson = JSON.stringify({
+    prompt: "In Swift, what keyword is used to declare a constant?",
+    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",
+    topic: "Swift Constants",
+    verifiedCategory: category
+  }, null, 2);
+  return `${attemptInfo}You are an expert Question Author for advanced technical education, specializing in: ${category}.
+Your mission is to create a high-quality, technically accurate Short Answer Question.
 
-**Available Question Arsenal**: ${allowedQuestionTypes}
+## Core Rules (Non-negotiable)
+1.  **Category Purity:** The question MUST be exclusively about **${category}**.
+2.  **Objective Answer:** The question must have a short, factual, and objective answer. Avoid questions that are subjective or require long explanations.
+3.  **Schema Integrity:** The response MUST be ONLY a single, valid JSON object.
 
-**Image Resources**: ${imageContextSection} 
+## CRITICAL CONTEXT FOR THIS QUESTION
+${contextStrings}
 
-## STRATEGIC PLANNING METHODOLOGY:
+## Task: Generate the Question
+Based on all the rules and context above, generate a single Short Answer Question.
 
-1. **Misconception Analysis**: If common misconceptions are provided, design questions specifically to address and correct them
-2. **Question Type Intelligence**: Select question types based on the cognitive demands and content nature
-3. **Difficulty Orchestration**: Create a learning journey that builds confidence while challenging appropriately
-4. **Diversity Optimization**: Ensure variety prevents monotony and maintains engagement
-5. **Context Sensitivity**: Match question types to topic characteristics (technical, conceptual, procedural)
-6. **Image Context Integration**: Intelligently associate questions with relevant images from the provided library to enhance contextual understanding.
+### Input Parameters
+- **Topic for Question:** ${quizContext?.plannedTopic || "General"}
+- **Language for Text:** ${language3}
+- **Difficulty Level:** ${difficulty}
 
-## ENHANCED OUTPUT FORMAT:
+### Required JSON Output Format
+Your response must be ONLY the JSON object, matching this exact structure:
 
-Return ONLY a JSON object with this EXACT structure:
+${exampleJson}
 
-\`\`\`json
-{
-  "quizPlan": [
-   {
-      "plannedTopic": "Specific, assessable topic derived from provided context",
-      "plannedQuestionType": "question_type_from_allowed_list",
-      "plannedBloomLevel": "bloom_level_from_requirements",
-      "plannedContextId": "THEO_ABS",
-      "imageId": "imgctx_12345abcde", // or null
-      "targetMisconception": "Specific misconception this question addresses (or 'none' if not applicable)",
-      "difficultyReason": "Strategic explanation of difficulty choice and placement",
-      "topicSpecificity": "broad|focused|specific",
-      "originalLoId": "corresponding_LoId_from_input",
-      "originalSubject": "corresponding_Subject_from_input",
-      "originalCategory": "corresponding_Category_from_input",
-      "originalTopic": "corresponding_Topic_from_input"
-    }
-  ],
-  "diversityMetrics": {
-    "questionTypeDistribution": {"type1": count1, "type2": count2},
-    "bloomLevelDistribution": {"level1": count1, "level2": count2},
-    "maxConsecutiveSameType": number,
-    "difficultyProgression": "description of how difficulty progresses",
-    "misconceptionCoverage": number_of_misconceptions_addressed
-  },
-  "planningStrategy": {
-    "overallApproach": "Brief description of the strategic approach taken",
-    "keyDecisions": ["Major decision 1", "Major decision 2", "Major decision 3"]
-  }
+Now, generate the JSON for the requested question.`;
 }
-\`\`\`
-
-Execute this plan with pedagogical precision. The quiz should feel like a carefully crafted learning journey that challenges and educates simultaneously.`;
-    logger.log("PROMPT_PREPARATION", {
-      promptLength: enhancedPromptText.length,
-      topicCount: clientInput.topics.length,
-      misconceptionCount: clientInput.topics.reduce((sum, t4) => sum + (t4.commonMisconceptions?.length || 0), 0)
-    }, Date.now() - promptStartTime);
-    const generationStartTime = Date.now();
-    const contents = [
-      {
-        role: "user",
-        parts: [
-          {
-            text: enhancedPromptText
-          }
-        ]
-      }
-    ];
-    const aiResult = await ai.models.generateContent({
-      model,
-      config: config3,
-      contents
-    });
-    const response = aiResult;
-    const generationDuration = Date.now() - generationStartTime;
-    logger.log("AI_GENERATION", {
-      responseLength: response.candidates?.[0]?.content?.parts?.[0]?.text?.length || 0,
-      duration: generationDuration
-    }, generationDuration);
-    const processingStartTime = Date.now();
-    const rawText = response.candidates?.[0]?.content?.parts?.[0]?.text || "";
-    let jsonText = rawText;
-    if (!rawText.trim().startsWith("{") && !rawText.trim().startsWith("[")) {
-      jsonText = extractJsonFromMarkdown(rawText);
-    }
-    logger.log("JSON_EXTRACTION", {
-      rawTextLength: rawText.length,
-      extractedJsonLength: jsonText.length
-    });
-    const aiGeneratedContent = GenerateQuizPlanOutputSchema.parse(JSON.parse(jsonText));
-    logger.log("SCHEMA_VALIDATION", { success: true }, Date.now() - processingStartTime);
-    const validationStartTime = Date.now();
-    if (aiGeneratedContent.quizPlan.length !== clientInput.totalQuestions) {
-      throw new Error(`AI planned for ${aiGeneratedContent.quizPlan.length} questions, but ${clientInput.totalQuestions} were requested.`);
+async function generateShortAnswerQuestion(clientInput, apiKey) {
+  const ai = new GoogleGenAI({ apiKey });
+  const model = "gemini-2.5-flash";
+  const config3 = {
+    temperature: 0.5,
+    responseMimeType: "application/json",
+    thinkingConfig: {
+      thinkingBudget: 4e3
     }
-    const invalidTypes = [];
-    aiGeneratedContent.quizPlan.forEach((item, index3) => {
-      if (!clientInput.selectedQuestionTypes.includes(item.plannedQuestionType)) {
-        invalidTypes.push(`Question ${index3 + 1}: '${item.plannedQuestionType}'`);
+  };
+  const attemptResults = [];
+  let lastError = null;
+  for (let attempt = 1; attempt <= MAX_RETRY_ATTEMPTS4; attempt++) {
+    const startTime = Date.now();
+    const promptText = buildEnhancedPrompt4(clientInput, attempt);
+    const promptHash = Buffer.from(promptText).toString("base64").slice(0, 10);
+    try {
+      DebugLogger.logPrompt(attempt, promptText, { ...clientInput, attemptNumber: attempt, promptHash });
+      const parts = [{ text: promptText }];
+      if (clientInput.imageUrl) {
+        const mimeType = clientInput.imageUrl.endsWith(".png") ? "image/png" : "image/jpeg";
+        const imagePart = await urlToGenerativePart(clientInput.imageUrl, mimeType);
+        parts.unshift(imagePart);
       }
-    });
-    if (invalidTypes.length > 0) {
-      throw new Error(`Invalid question types found: ${invalidTypes.join(", ")}`);
-    }
-    const codingQuestions = aiGeneratedContent.quizPlan.filter((q2) => q2.plannedQuestionType === "coding");
-    if (numCodingQuestions > 0 && codingQuestions.length !== numCodingQuestions) {
-      throw new Error(`Expected ${numCodingQuestions} coding questions, but got ${codingQuestions.length}`);
-    }
-    const diversityAnalysis = validateConsecutiveTypes(aiGeneratedContent.quizPlan);
-    logger.log("VALIDATION_COMPLETE", {
-      questionCount: aiGeneratedContent.quizPlan.length,
-      codingQuestionCount: codingQuestions.length,
-      maxConsecutiveType: diversityAnalysis.maxConsecutive,
-      questionTypeDistribution: aiGeneratedContent.diversityMetrics?.questionTypeDistribution || {}
-    }, Date.now() - validationStartTime);
-    const finalResult = {
-      ...aiGeneratedContent,
-      logs: logger.getLogs()
-    };
-    logger.log("GENERATION_COMPLETE", {
-      totalDuration: logger.getTotalDuration(),
-      success: true,
-      finalQuestionCount: finalResult.quizPlan.length
-    }, logger.getTotalDuration());
-    console.log("\n=== QUIZ PLAN GENERATION SUMMARY ===");
-    console.log(`\u2705 Successfully generated ${finalResult.quizPlan.length} questions`);
-    console.log(`\u23F1\uFE0F Total generation time: ${logger.getTotalDuration()}ms`);
-    console.log(`\u{1F3AF} Question types: ${Object.keys(finalResult.diversityMetrics?.questionTypeDistribution || {}).join(", ")}`);
-    console.log(`\u{1F9E0} Bloom levels: ${Object.keys(finalResult.diversityMetrics?.bloomLevelDistribution || {}).join(", ")}`);
-    if (numCodingQuestions > 0) {
-      console.log(`\u{1F4BB} Coding questions: ${codingQuestions.length}/${numCodingQuestions} required`);
-    }
-    console.log(JSON.stringify(finalResult));
-    console.log("=====================================\n");
-    return finalResult;
-  } catch (error) {
-    logger.log("ERROR", {
-      message: error.message,
-      stack: error.stack,
-      totalDuration: logger.getTotalDuration()
-    });
-    console.error("\u274C Quiz Plan Generation Failed:", error.message);
-    console.error("\u{1F4CB} Full logs available in returned object");
-    throw new Error(`Failed to generate Quiz Plan: ${error.message}`);
-  }
-}
-function validateConsecutiveTypes(quizPlan) {
-  let maxConsecutive = 1;
-  let maxType = quizPlan[0]?.plannedQuestionType || "";
-  let maxStartIndex = 0;
-  let currentConsecutive = 1;
-  let currentType = quizPlan[0]?.plannedQuestionType || "";
-  let currentStartIndex = 0;
-  for (let i2 = 1; i2 < quizPlan.length; i2++) {
-    if (quizPlan[i2].plannedQuestionType === currentType) {
-      currentConsecutive++;
-    } else {
-      if (currentConsecutive > maxConsecutive) {
-        maxConsecutive = currentConsecutive;
-        maxType = currentType;
-        maxStartIndex = currentStartIndex;
+      const contents = [{ role: "user", parts }];
+      const aiResult = await ai.models.generateContent({ model, config: config3, contents });
+      const response = aiResult;
+      const rawText = response.candidates?.[0]?.content?.parts?.[0]?.text || "";
+      const duration = Date.now() - startTime;
+      DebugLogger.logResponse(attempt, rawText);
+      if (!rawText) throw new Error("AI returned an empty response.");
+      const parsedJson = JSON.parse(rawText);
+      DebugLogger.logValidation(attempt, "JSON Parsed Successfully", parsedJson);
+      const aiGeneratedContent = AIShortAnswerOutputFieldsSchema.parse(parsedJson);
+      DebugLogger.logValidation(attempt, "Zod Schema Validated", aiGeneratedContent);
+      if (clientInput.quizContext?.originalCategory) {
+        const verifiedCategory = aiGeneratedContent.verifiedCategory?.toLowerCase();
+        const requiredCategory = clientInput.quizContext.originalCategory.toLowerCase();
+        if (verifiedCategory && verifiedCategory !== requiredCategory) {
+          throw new Error(`Category mismatch: Required ${requiredCategory}, got ${verifiedCategory}`);
+        }
+      }
+      const completeQuestion = {
+        id: generateUniqueId("saq_ai_"),
+        questionType: "short_answer",
+        prompt: aiGeneratedContent.prompt,
+        acceptedAnswers: aiGeneratedContent.acceptedAnswers,
+        isCaseSensitive: clientInput.isCaseSensitive,
+        explanation: aiGeneratedContent.explanation,
+        points: aiGeneratedContent.points,
+        topic: aiGeneratedContent.topic || clientInput.quizContext?.originalTopic,
+        difficulty: clientInput.difficulty,
+        contextCode: clientInput.quizContext?.plannedContextId,
+        bloomLevel: clientInput.quizContext?.plannedBloomLevel,
+        learningObjective: clientInput.quizContext?.originalLoId,
+        subject: clientInput.quizContext?.originalSubject,
+        category: clientInput.quizContext?.originalCategory,
+        imageUrl: clientInput.imageUrl
+      };
+      const validatedQuestion = ShortAnswerQuestionZodSchema.parse(completeQuestion);
+      attemptResults.push({ success: true, duration, promptLength: promptText.length, responseLength: rawText.length, promptHash });
+      console.log(`
+\u2705 Short Answer generation successful on attempt ${attempt} (${duration}ms)`);
+      if (attempt > 1) DebugLogger.logAttemptSummary(attemptResults);
+      return { question: validatedQuestion };
+    } catch (error) {
+      lastError = error;
+      const duration = Date.now() - startTime;
+      attemptResults.push({ success: false, duration, error: error.message, promptLength: promptText.length, promptHash });
+      const willRetry = attempt < MAX_RETRY_ATTEMPTS4;
+      DebugLogger.logRetryInfo(attempt, error, willRetry);
+      if (willRetry) {
+        console.log(`\u23F3 Retrying in ${RETRY_DELAY_MS4}ms...`);
+        await new Promise((resolve) => setTimeout(resolve, RETRY_DELAY_MS4));
       }
-      currentConsecutive = 1;
-      currentType = quizPlan[i2].plannedQuestionType;
-      currentStartIndex = i2;
     }
   }
-  if (currentConsecutive > maxConsecutive) {
-    maxConsecutive = currentConsecutive;
-    maxType = currentType;
-    maxStartIndex = currentStartIndex;
-  }
-  return {
-    maxConsecutive,
-    type: maxType,
-    startIndex: maxStartIndex
-  };
+  DebugLogger.logAttemptSummary(attemptResults);
+  const errorMessage = `Failed to generate Short Answer question after ${MAX_RETRY_ATTEMPTS4} attempts. Last error: ${lastError?.message}`;
+  console.error("\n\u274C Final Result: FAILED");
+  console.error(errorMessage);
+  return { error: errorMessage };
 }
 
-// src/ai/flows/generate-questions-from-quiz-plan.ts
+// src/ai/flows/question-gen/generate-numeric-question.ts
 init_react_shim();
 
-// src/services/TopicDataService.ts
+// src/ai/flows/question-gen/generate-numeric-question-types.ts
 init_react_shim();
-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;
-      const serializedData = JSON.stringify(data);
-      localStorage.setItem(this.STORAGE_KEY, serializedData);
-    } catch (error) {
-      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]));
-    newData.forEach((newLo) => {
-      loMap.set(newLo.loId, newLo);
-    });
-    const mergedData = Array.from(loMap.values());
-    this.saveData(mergedData);
+BaseQuestionGenerationClientInputSchema.extend({
+  allowDecimals: z.boolean().optional().default(true),
+  minRange: z.number().optional(),
+  maxRange: z.number().optional(),
+  // Thêm trường tolerance để client có thể tùy chỉnh
+  tolerance: z.number().min(0).optional().default(0)
+});
+var AINumericOutputFieldsSchema = z.object({
+  prompt: z.string(),
+  answer: z.number(),
+  // AI có thể đề xuất một tolerance, nhưng chúng ta sẽ ưu tiên của client
+  tolerance: z.number().min(0).optional(),
+  explanation: z.string().optional(),
+  points: z.number().optional().default(10),
+  difficulty: z.enum(["easy", "medium", "hard"]).optional(),
+  topic: z.string().optional(),
+  verifiedCategory: z.string().optional()
+  // Thêm để xác thực
+});
+
+// src/ai/flows/question-gen/generate-numeric-question.ts
+var MAX_RETRY_ATTEMPTS5 = 3;
+var RETRY_DELAY_MS5 = 3e3;
+function buildEnhancedPrompt5(clientInput, attemptNumber) {
+  const { quizContext, language: language3, difficulty, minRange, maxRange, allowDecimals, imageUrl } = clientInput;
+  const category = quizContext?.originalCategory || "the specified technical category";
+  const attemptInfo = attemptNumber > 1 ? `
+## DEBUG INFO - This is attempt #${attemptNumber}
+Previous attempts failed. Ensure the 'answer' is a valid number and fits within the specified constraints.
+
+` : "";
+  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}`,
+    imageContextInstruction,
+    quizContext?.plannedBloomLevel && `**Cognitive Level (Bloom's):** ${quizContext.plannedBloomLevel}`,
+    quizContext?.targetMisconception && `**Target Misconception:** The question should clarify this numerical error: "${quizContext.targetMisconception}"`
+  ].filter(Boolean).map((s4) => `- ${s4}`).join("\n");
+  const constraintStrings = [
+    minRange !== void 0 && `The final 'answer' MUST be greater than or equal to ${minRange}.`,
+    maxRange !== void 0 && `The final 'answer' MUST be less than or equal to ${maxRange}.`,
+    !allowDecimals && `The final 'answer' MUST be an integer (whole number).`
+  ].filter(Boolean).join("\n");
+  const exampleJson = JSON.stringify({
+    prompt: "A Swift `Int` on a 64-bit platform can store a maximum value of 2^63 - 1. What is the maximum value for an `Int8`?",
+    answer: 127,
+    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",
+    topic: "Swift Data Types",
+    verifiedCategory: category
+  }, null, 2);
+  return `${attemptInfo}You are an expert Question Author for advanced technical education, specializing in: ${category}.
+Your mission is to create a high-quality, technically accurate Numeric Question.
+
+## Core Rules (Non-negotiable)
+1.  **Category Purity:** The question MUST be exclusively about **${category}**.
+2.  **Quantitative Answer:** The question MUST ask for a specific, objective numerical answer.
+3.  **Schema Integrity:** The response MUST be ONLY a single, valid JSON object.
+
+## CRITICAL CONTEXT FOR THIS QUESTION
+${contextStrings}
+
+## Task: Generate the Question
+Based on all the rules and context above, generate a single Numeric Question.
+
+### Input Parameters & Constraints
+- **Topic for Question:** ${quizContext?.plannedTopic || "General"}
+- **Language for Text:** ${language3}
+- **Difficulty Level:** ${difficulty}
+${constraintStrings ? `
+### CRITICAL CONSTRAINTS ON THE ANSWER
+${constraintStrings}` : ""}
+
+### Required JSON Output Format
+Your response must be ONLY the JSON object, matching this exact structure:
+
+${exampleJson}
+
+Now, generate the JSON for the requested question.`;
+}
+async function generateNumericQuestion(clientInput, apiKey) {
+  if (clientInput.minRange !== void 0 && clientInput.maxRange !== void 0 && clientInput.minRange > clientInput.maxRange) {
+    return { error: `Invalid input: minRange (${clientInput.minRange}) cannot be greater than maxRange (${clientInput.maxRange}).` };
   }
-  /**
-   * 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 [];
-      const storedData = localStorage.getItem(this.STORAGE_KEY);
-      return storedData ? JSON.parse(storedData) : [];
-    } catch (error) {
-      console.error("Error retrieving learning objectives from Local Storage:", error);
-      this.clearData();
-      return [];
+  const ai = new GoogleGenAI({ apiKey });
+  const model = "gemini-2.5-flash";
+  const config3 = {
+    temperature: 0.4,
+    // Giữ nhiệt độ thấp cho các câu trả lời chính xác
+    responseMimeType: "application/json",
+    thinkingConfig: {
+      thinkingBudget: 4e3
     }
-  }
-  /**
-   * Removes all learning objective data from Local Storage.
-   */
-  static clearData() {
+  };
+  const attemptResults = [];
+  let lastError = null;
+  for (let attempt = 1; attempt <= MAX_RETRY_ATTEMPTS5; attempt++) {
+    const startTime = Date.now();
+    const promptText = buildEnhancedPrompt5(clientInput, attempt);
+    const promptHash = Buffer.from(promptText).toString("base64").slice(0, 10);
     try {
-      if (typeof window === "undefined") return;
-      localStorage.removeItem(this.STORAGE_KEY);
-    } catch (error) {
-      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) {
-      return { data: [], errors: ["File is empty or contains only a header."] };
-    }
-    const headerLine = lines.shift();
-    const headers = headerLine.split("	").map((h3) => h3.trim());
-    if (headers.length !== this.EXPECTED_HEADERS.length || !this.EXPECTED_HEADERS.every((h3, i2) => h3 === headers[i2])) {
-      const errorMsg = `Invalid TSV header. Expected: "${this.EXPECTED_HEADERS.join("	")}". Received: "${headers.join("	")}"`;
-      return { data: [], errors: [errorMsg] };
-    }
-    const data = [];
-    const errors2 = [];
-    lines.forEach((line, index3) => {
-      const values = line.split("	").map((v) => v.trim());
-      if (values.length !== this.EXPECTED_HEADERS.length) {
-        errors2.push(`Line ${index3 + 2}: Incorrect number of columns. Expected ${this.EXPECTED_HEADERS.length}, but got ${values.length}.`);
-        return;
+      DebugLogger.logPrompt(attempt, promptText, { ...clientInput, attemptNumber: attempt, promptHash });
+      const parts = [{ text: promptText }];
+      if (clientInput.imageUrl) {
+        const mimeType = clientInput.imageUrl.endsWith(".png") ? "image/png" : "image/jpeg";
+        const imagePart = await urlToGenerativePart(clientInput.imageUrl, mimeType);
+        parts.unshift(imagePart);
       }
-      const [
-        loId,
-        loDescription,
-        subject,
-        category,
-        topic,
-        keywordsStr,
-        grade,
-        stemElementsStr,
-        bloomLevelsStr
-      ] = values;
-      if (!loId || !subject || !category || !topic) {
-        errors2.push(`Line ${index3 + 2}: Missing required fields (LO ID, Subject, Category, or Topic).`);
-        return;
+      const contents = [{ role: "user", parts }];
+      const aiResult = await ai.models.generateContent({ model, config: config3, contents });
+      const response = aiResult;
+      const rawText = response.candidates?.[0]?.content?.parts?.[0]?.text || "";
+      const duration = Date.now() - startTime;
+      DebugLogger.logResponse(attempt, rawText);
+      if (!rawText) throw new Error("AI returned an empty response.");
+      const parsedJson = JSON.parse(rawText);
+      DebugLogger.logValidation(attempt, "JSON Parsed Successfully", parsedJson);
+      const aiGeneratedContent = AINumericOutputFieldsSchema.parse(parsedJson);
+      DebugLogger.logValidation(attempt, "Zod Schema Validated", aiGeneratedContent);
+      const answer = aiGeneratedContent.answer;
+      if (clientInput.minRange !== void 0 && answer < clientInput.minRange) {
+        throw new Error(`AI answer ${answer} is less than the required minRange of ${clientInput.minRange}.`);
       }
-      const learningObjective = {
-        loId,
-        loDescription,
-        subject,
-        category,
-        topic,
-        keywords: keywordsStr.split(",").map((k3) => k3.trim()).filter(Boolean),
-        grade,
-        stemElements: stemElementsStr.split(",").map((s4) => s4.trim()).filter(Boolean),
-        bloomLevelsGuideline: bloomLevelsStr.split(",").map((b2) => b2.trim()).filter(Boolean)
+      if (clientInput.maxRange !== void 0 && answer > clientInput.maxRange) {
+        throw new Error(`AI answer ${answer} is greater than the required maxRange of ${clientInput.maxRange}.`);
+      }
+      if (!clientInput.allowDecimals && !Number.isInteger(answer)) {
+        throw new Error(`AI answer ${answer} is not an integer, but decimals are not allowed.`);
+      }
+      if (clientInput.quizContext?.originalCategory) {
+        const verifiedCategory = aiGeneratedContent.verifiedCategory?.toLowerCase();
+        const requiredCategory = clientInput.quizContext.originalCategory.toLowerCase();
+        if (verifiedCategory && verifiedCategory !== requiredCategory) {
+          throw new Error(`Category mismatch: Required ${requiredCategory}, got ${verifiedCategory}`);
+        }
+      }
+      const completeQuestion = {
+        id: generateUniqueId("num_ai_"),
+        questionType: "numeric",
+        prompt: aiGeneratedContent.prompt,
+        answer: aiGeneratedContent.answer,
+        tolerance: clientInput.tolerance ?? aiGeneratedContent.tolerance ?? 0,
+        explanation: aiGeneratedContent.explanation,
+        points: aiGeneratedContent.points,
+        topic: aiGeneratedContent.topic || clientInput.quizContext?.originalTopic,
+        difficulty: clientInput.difficulty,
+        contextCode: clientInput.quizContext?.plannedContextId,
+        bloomLevel: clientInput.quizContext?.plannedBloomLevel,
+        learningObjective: clientInput.quizContext?.originalLoId,
+        subject: clientInput.quizContext?.originalSubject,
+        category: clientInput.quizContext?.originalCategory,
+        imageUrl: clientInput.imageUrl
       };
-      data.push(learningObjective);
-    });
-    return { data, errors: errors2 };
-  }
-  /**
-   * 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);
-    return data.filter((item) => topicSet.has(item.topic));
+      const validatedQuestion = NumericQuestionZodSchema.parse(completeQuestion);
+      attemptResults.push({ success: true, duration, promptLength: promptText.length, responseLength: rawText.length, promptHash });
+      console.log(`
+\u2705 Numeric generation successful on attempt ${attempt} (${duration}ms)`);
+      if (attempt > 1) DebugLogger.logAttemptSummary(attemptResults);
+      return { question: validatedQuestion };
+    } catch (error) {
+      lastError = error;
+      const duration = Date.now() - startTime;
+      attemptResults.push({ success: false, duration, error: error.message, promptLength: promptText.length, promptHash });
+      const willRetry = attempt < MAX_RETRY_ATTEMPTS5;
+      DebugLogger.logRetryInfo(attempt, error, willRetry);
+      if (willRetry) {
+        console.log(`\u23F3 Retrying in ${RETRY_DELAY_MS5}ms...`);
+        await new Promise((resolve) => setTimeout(resolve, RETRY_DELAY_MS5));
+      }
+    }
   }
-};
-TopicDataService.STORAGE_KEY = "interactive_quiz_kit_learning_objectives";
-TopicDataService.EXPECTED_HEADERS = [
-  "LO ID",
-  "LO Description",
-  "Subject",
-  "Category",
-  "Topic",
-  "Keywords",
-  "Grade",
-  "STEM Element(s)",
-  "Bloom\u2019s Level(s) Guideline"
-];
+  DebugLogger.logAttemptSummary(attemptResults);
+  const errorMessage = `Failed to generate Numeric question after ${MAX_RETRY_ATTEMPTS5} attempts. Last error: ${lastError?.message}`;
+  console.error("\n\u274C Final Result: FAILED");
+  console.error(errorMessage);
+  return { error: errorMessage };
+}
 
-// src/ai/flows/question-gen/generate-mrq-question.ts
+// src/ai/flows/question-gen/generate-fitb-question.ts
 init_react_shim();
 
-// src/ai/flows/question-gen/generate-mrq-question-types.ts
+// src/ai/flows/question-gen/generate-fitb-question-types.ts
 init_react_shim();
 BaseQuestionGenerationClientInputSchema.extend({
-  numberOfOptions: z.number().int().min(2).max(8).optional().default(5),
-  minCorrectAnswers: z.number().int().min(1).optional().default(2),
-  maxCorrectAnswers: z.number().int().min(1).optional().default(3)
+  numberOfBlanks: z.number().int().min(1).max(5).optional().default(1),
+  isCaseSensitive: z.boolean().optional().default(false)
 });
-var AIMRQOutputFieldsSchema = z.object({
-  prompt: z.string(),
-  options: z.array(z.object({ tempId: z.string(), text: z.string() })).min(2).max(8),
-  correctTempOptionIds: z.array(z.string()).min(1),
+var AIFillInTheBlanksOutputFieldsSchema = z.object({
+  prompt: z.string().describe("The instructional text for the user, e.g., 'Fill in the blanks to complete the sentence.'"),
+  // Yêu cầu AI trả về cấu trúc segments trực tiếp
+  segments: z.array(z.object({
+    type: z.enum(["text", "blank"]),
+    content: z.string().optional().describe("The text content for a 'text' segment."),
+    acceptedAnswers: z.array(z.string().min(1)).min(1).optional().describe("An array of correct answers for a 'blank' segment.")
+  })).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(),
   topic: z.string().optional(),
-  verifiedCategory: z.string().optional().describe("The category this question actually addresses.")
+  verifiedCategory: z.string().optional()
+  // Thêm để xác thực
 });
 
-// src/ai/flows/question-gen/generate-mrq-question.ts
-var MAX_RETRY_ATTEMPTS3 = 3;
-var RETRY_DELAY_MS3 = 3e3;
-function buildEnhancedPrompt3(clientInput, attemptNumber) {
-  const { quizContext, language: language3, difficulty, numberOfOptions, minCorrectAnswers, maxCorrectAnswers, imageUrl } = clientInput;
+// src/ai/flows/question-gen/generate-fitb-question.ts
+var MAX_RETRY_ATTEMPTS6 = 3;
+var RETRY_DELAY_MS6 = 3e3;
+function buildEnhancedPrompt6(clientInput, attemptNumber) {
+  const { quizContext, language: language3, difficulty, numberOfBlanks, imageUrl } = clientInput;
   const category = quizContext?.originalCategory || "the specified technical category";
   const attemptInfo = attemptNumber > 1 ? `
 ## DEBUG INFO - This is attempt #${attemptNumber}
-Previous attempts failed due to validation errors. Pay close attention to the number of correct answers and the JSON schema.
+Previous attempts failed. Pay strict attention to the JSON schema, especially the 'segments' array structure. Ensure 'blank' segments have 'acceptedAnswers' and 'text' segments have 'content'.
 
 ` : "";
-  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 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} (This is the ONLY language to be used)`,
+    `**Required Category:** ${category}`,
     quizContext?.loDescription && `**Learning Objective:** ${quizContext.loDescription}`,
     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}"`,
-    quizContext?.difficultyReason && `**Pedagogical Reason:** ${quizContext.difficultyReason}`
+    quizContext?.targetMisconception && `**Target Misconception:** Design the blank to test this specific point: "${quizContext.targetMisconception}"`
   ].filter(Boolean).map((s4) => `- ${s4}`).join("\n");
   const exampleJson = JSON.stringify({
-    prompt: "Which of the following are considered programming paradigms?",
-    options: [
-      { "tempId": "A", "text": "Object-Oriented" },
-      { "tempId": "B", "text": "Assembly" },
-      { "tempId": "C", "text": "Functional" },
-      { "tempId": "D", "text": "Procedural" },
-      { "tempId": "E", "text": "Middleware" }
+    prompt: "Complete the following Swift code snippet.",
+    segments: [
+      { "type": "text", "content": "To declare a new function in Swift, you use the `" },
+      { "type": "blank", "acceptedAnswers": ["func"] },
+      { "type": "text", "content": "` keyword." }
     ],
-    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.",
+    explanation: "The 'func' keyword is used to declare a function in the Swift programming language.",
     points: 10,
-    difficulty: "medium",
-    topic: "Programming Paradigms",
+    difficulty: "easy",
+    topic: "Swift Function Declaration",
     verifiedCategory: category
   }, null, 2);
-  return `${attemptInfo}You are an expert Question Author for advanced technical education, specializing in the programming language: ${category}.
-Your sole mission is to create a high-quality, technically accurate Multiple Response Question. You must adhere to the following rules at all times.
+  return `${attemptInfo}You are an expert Question Author for advanced technical education, specializing in: ${category}.
+Your mission is to create a high-quality, technically accurate Fill-in-the-Blanks Question.
 
 ## Core Rules (Non-negotiable)
-1.  **Category Purity:** The question, options, and explanation MUST be exclusively about **${category}**.
-2.  **Context Adherence:** The question's content must directly align with all provided context.
-3.  **Format Integrity:** You MUST return ONLY a single, valid JSON object that strictly follows the provided schema. Do not include any extra text or comments.
+1.  **Category Purity:** The question MUST be exclusively about **${category}**.
+2.  **Schema Integrity:** The response MUST be ONLY a single, valid JSON object that strictly follows the provided schema.
+3.  **Logical Segments:** For 'blank' segments, you MUST provide 'acceptedAnswers'. For 'text' segments, you MUST provide 'content'. Do not mix them.
 
 ## CRITICAL CONTEXT FOR THIS QUESTION
 ${contextStrings}
 
 ## Task: Generate the Question
-Based on all the rules and context above, generate a single Multiple Response Question.
+Based on all the rules and context above, generate a single Fill-in-the-Blanks Question.
 
 ### Input Parameters
 - **Topic for Question:** ${quizContext?.plannedTopic || "General"}
 - **Language for Text:** ${language3}
 - **Difficulty Level:** ${difficulty}
-- **Number of Options:** Generate exactly ${numberOfOptions} options.
-- **Number of Correct Answers:** The 'correctTempOptionIds' array MUST contain between ${minCorrectAnswers} and ${maxCorrectAnswers} valid IDs from the options you generate.
+- **Number of Blanks:** Generate exactly ${numberOfBlanks} segment(s) with type 'blank'.
 
 ### Required JSON Output Format
-Your response must be ONLY the JSON object, matching this exact structure and field names.
+Your response must be ONLY the JSON object, matching this exact structure:
 
 ${exampleJson}
 
 Now, generate the JSON for the requested question.`;
 }
-async function generateMRQQuestion(clientInput, apiKey) {
-  if (clientInput.minCorrectAnswers > clientInput.maxCorrectAnswers) {
-    return { error: `Invalid input: minCorrectAnswers (${clientInput.minCorrectAnswers}) cannot be greater than maxCorrectAnswers (${clientInput.maxCorrectAnswers}).` };
-  }
-  if (clientInput.maxCorrectAnswers >= clientInput.numberOfOptions) {
-    return { error: `Invalid input: maxCorrectAnswers (${clientInput.maxCorrectAnswers}) must be less than the total numberOfOptions (${clientInput.numberOfOptions}).` };
-  }
+async function generateFillInTheBlanksQuestion(clientInput, apiKey) {
   const ai = new GoogleGenAI({ apiKey });
   const model = "gemini-2.5-flash";
   const config3 = {
@@ -100968,9 +100707,9 @@ async function generateMRQQuestion(clientInput, apiKey) {
   };
   const attemptResults = [];
   let lastError = null;
-  for (let attempt = 1; attempt <= MAX_RETRY_ATTEMPTS3; attempt++) {
+  for (let attempt = 1; attempt <= MAX_RETRY_ATTEMPTS6; attempt++) {
     const startTime = Date.now();
-    const promptText = buildEnhancedPrompt3(clientInput, attempt);
+    const promptText = buildEnhancedPrompt6(clientInput, attempt);
     const promptHash = Buffer.from(promptText).toString("base64").slice(0, 10);
     try {
       DebugLogger.logPrompt(attempt, promptText, { ...clientInput, attemptNumber: attempt, promptHash });
@@ -100981,61 +100720,57 @@ async function generateMRQQuestion(clientInput, apiKey) {
         parts.unshift(imagePart);
       }
       const contents = [{ role: "user", parts }];
-      const aiResult = await ai.models.generateContent({
-        model,
-        config: config3,
-        contents
-      });
+      const aiResult = await ai.models.generateContent({ model, config: config3, contents });
       const response = aiResult;
       const rawText = response.candidates?.[0]?.content?.parts?.[0]?.text || "";
       const duration = Date.now() - startTime;
       DebugLogger.logResponse(attempt, rawText);
-      if (!rawText) {
-        throw new Error("AI returned an empty response.");
-      }
+      if (!rawText) throw new Error("AI returned an empty response.");
       const parsedJson = JSON.parse(rawText);
       DebugLogger.logValidation(attempt, "JSON Parsed Successfully", parsedJson);
-      const aiGeneratedContent = AIMRQOutputFieldsSchema.parse(parsedJson);
+      const aiGeneratedContent = AIFillInTheBlanksOutputFieldsSchema.parse(parsedJson);
       DebugLogger.logValidation(attempt, "Zod Schema Validated", aiGeneratedContent);
-      if (aiGeneratedContent.options.length !== clientInput.numberOfOptions) {
-        throw new Error(`AI generated ${aiGeneratedContent.options.length} options, but ${clientInput.numberOfOptions} were required.`);
-      }
-      const correctCount = aiGeneratedContent.correctTempOptionIds.length;
-      if (correctCount < clientInput.minCorrectAnswers || correctCount > clientInput.maxCorrectAnswers) {
-        throw new Error(`AI provided ${correctCount} correct answers, which is outside the required range of ${clientInput.minCorrectAnswers}-${clientInput.maxCorrectAnswers}.`);
+      const blankCount = aiGeneratedContent.segments.filter((s4) => s4.type === "blank").length;
+      if (blankCount !== clientInput.numberOfBlanks) {
+        throw new Error(`AI generated ${blankCount} blanks, but ${clientInput.numberOfBlanks} were required.`);
       }
+      aiGeneratedContent.segments.forEach((segment, index3) => {
+        if (segment.type === "blank" && (!segment.acceptedAnswers || segment.acceptedAnswers.length === 0)) {
+          throw new Error(`Segment ${index3} is a 'blank' but is missing 'acceptedAnswers'.`);
+        }
+        if (segment.type === "text" && typeof segment.content !== "string") {
+          throw new Error(`Segment ${index3} is 'text' but is missing 'content'.`);
+        }
+      });
       if (clientInput.quizContext?.originalCategory) {
         const verifiedCategory = aiGeneratedContent.verifiedCategory?.toLowerCase();
         const requiredCategory = clientInput.quizContext.originalCategory.toLowerCase();
         if (verifiedCategory && verifiedCategory !== requiredCategory) {
           throw new Error(`Category mismatch: Required ${requiredCategory}, got ${verifiedCategory}`);
         }
-      }
-      const finalOptions = [];
-      const tempIdToFinalIdMap = {};
-      const allTempIds = /* @__PURE__ */ new Set();
-      aiGeneratedContent.options.forEach((aiOption) => {
-        const finalId = generateUniqueId("opt_mr_");
-        finalOptions.push({ id: finalId, text: aiOption.text });
-        tempIdToFinalIdMap[aiOption.tempId] = finalId;
-        allTempIds.add(aiOption.tempId);
-      });
-      const finalCorrectAnswerIds = aiGeneratedContent.correctTempOptionIds.map((tempId) => {
-        if (!allTempIds.has(tempId)) {
-          throw new Error(`AI provided an invalid correctTempOptionId ('${tempId}') which does not exist in the generated options.`);
+      }
+      const finalSegments = [];
+      const finalAnswers = [];
+      aiGeneratedContent.segments.forEach((segment) => {
+        if (segment.type === "text") {
+          finalSegments.push({ type: "text", content: segment.content });
+        } else if (segment.type === "blank" && segment.acceptedAnswers) {
+          const blankId = generateUniqueId("blank_");
+          finalSegments.push({ type: "blank", id: blankId });
+          finalAnswers.push({ blankId, acceptedValues: segment.acceptedAnswers });
         }
-        return tempIdToFinalIdMap[tempId];
       });
       const completeQuestion = {
-        id: generateUniqueId("mrq_ai_"),
-        questionType: "multiple_response",
+        id: generateUniqueId("fitb_ai_"),
+        questionType: "fill_in_the_blanks",
         prompt: aiGeneratedContent.prompt,
-        options: finalOptions,
-        correctAnswerIds: finalCorrectAnswerIds,
+        segments: finalSegments,
+        answers: finalAnswers,
+        isCaseSensitive: clientInput.isCaseSensitive,
         explanation: aiGeneratedContent.explanation,
         points: aiGeneratedContent.points,
         topic: aiGeneratedContent.topic || clientInput.quizContext?.originalTopic,
-        difficulty: aiGeneratedContent.difficulty || clientInput.difficulty,
+        difficulty: clientInput.difficulty,
         contextCode: clientInput.quizContext?.plannedContextId,
         bloomLevel: clientInput.quizContext?.plannedBloomLevel,
         learningObjective: clientInput.quizContext?.originalLoId,
@@ -101043,43 +100778,44 @@ async function generateMRQQuestion(clientInput, apiKey) {
         category: clientInput.quizContext?.originalCategory,
         imageUrl: clientInput.imageUrl
       };
-      const validatedQuestion = MultipleResponseQuestionZodSchema.parse(completeQuestion);
+      const validatedQuestion = FillInTheBlanksQuestionZodSchema.parse(completeQuestion);
       attemptResults.push({ success: true, duration, promptLength: promptText.length, responseLength: rawText.length, promptHash });
       console.log(`
-\u2705 MRQ generation successful on attempt ${attempt} (${duration}ms)`);
+\u2705 FITB generation successful on attempt ${attempt} (${duration}ms)`);
       if (attempt > 1) DebugLogger.logAttemptSummary(attemptResults);
       return { question: validatedQuestion };
     } catch (error) {
       lastError = error;
       const duration = Date.now() - startTime;
       attemptResults.push({ success: false, duration, error: error.message, promptLength: promptText.length, promptHash });
-      const willRetry = attempt < MAX_RETRY_ATTEMPTS3;
+      const willRetry = attempt < MAX_RETRY_ATTEMPTS6;
       DebugLogger.logRetryInfo(attempt, error, willRetry);
       if (willRetry) {
-        console.log(`\u23F3 Retrying in ${RETRY_DELAY_MS3}ms...`);
-        await new Promise((resolve) => setTimeout(resolve, RETRY_DELAY_MS3));
+        console.log(`\u23F3 Retrying in ${RETRY_DELAY_MS6}ms...`);
+        await new Promise((resolve) => setTimeout(resolve, RETRY_DELAY_MS6));
       }
     }
   }
   DebugLogger.logAttemptSummary(attemptResults);
-  const errorMessage = `Failed to generate MRQ question after ${MAX_RETRY_ATTEMPTS3} attempts. Last error: ${lastError?.message}`;
+  const errorMessage = `Failed to generate FITB question after ${MAX_RETRY_ATTEMPTS6} attempts. Last error: ${lastError?.message}`;
   console.error("\n\u274C Final Result: FAILED");
   console.error(errorMessage);
   return { error: errorMessage };
 }
 
-// src/ai/flows/question-gen/generate-short-answer-question.ts
+// src/ai/flows/question-gen/generate-sequence-question.ts
 init_react_shim();
 
-// src/ai/flows/question-gen/generate-short-answer-question-types.ts
+// src/ai/flows/question-gen/generate-sequence-question-types.ts
 init_react_shim();
 BaseQuestionGenerationClientInputSchema.extend({
-  isCaseSensitive: z.boolean().optional().default(false)
+  numberOfItems: z.number().int().min(2).max(10).optional().default(4)
 });
-var AIShortAnswerOutputFieldsSchema = z.object({
-  prompt: z.string().describe("The question text that prompts the user for a short answer."),
-  acceptedAnswers: z.array(z.string().min(1)).min(1).describe("An array of one or more acceptable short answers. Include common variations if applicable."),
-  // isCaseSensitive không cần thiết ở đây, chúng ta sẽ quản lý nó ở phía client
+var AISequenceOutputFieldsSchema = z.object({
+  prompt: z.string().describe("The instructional text for the user, e.g., 'Arrange the steps in the correct order.'"),
+  // Yêu cầu AI cung cấp các item dưới dạng một mảng duy nhất đã được sắp xếp đúng thứ tự
+  // Điều này đơn giản hóa logic và giảm rủi ro
+  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(),
@@ -101088,52 +100824,58 @@ var AIShortAnswerOutputFieldsSchema = z.object({
   // Thêm để xác thực
 });
 
-// src/ai/flows/question-gen/generate-short-answer-question.ts
-var MAX_RETRY_ATTEMPTS4 = 3;
-var RETRY_DELAY_MS4 = 3e3;
-function buildEnhancedPrompt4(clientInput, attemptNumber) {
-  const { quizContext, language: language3, difficulty, imageUrl } = clientInput;
+// src/ai/flows/question-gen/generate-sequence-question.ts
+var MAX_RETRY_ATTEMPTS7 = 3;
+var RETRY_DELAY_MS7 = 3e3;
+function buildEnhancedPrompt7(clientInput, attemptNumber) {
+  const { quizContext, language: language3, difficulty, numberOfItems, imageUrl } = clientInput;
   const category = quizContext?.originalCategory || "the specified technical category";
   const attemptInfo = attemptNumber > 1 ? `
 ## DEBUG INFO - This is attempt #${attemptNumber}
-Previous attempts failed. Ensure 'acceptedAnswers' is a non-empty array of strings and the JSON is valid.
+Previous attempts failed. Ensure the 'itemsInCorrectOrder' array has exactly the required number of items and the JSON is valid.
 
 ` : "";
-  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 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}`,
     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}"`
+    quizContext?.targetMisconception && `**Target Misconception:** The sequence should clarify this specific process error: "${quizContext.targetMisconception}"`
   ].filter(Boolean).map((s4) => `- ${s4}`).join("\n");
   const exampleJson = JSON.stringify({
-    prompt: "In Swift, what keyword is used to declare a constant?",
-    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.",
+    prompt: "Arrange the steps to make a network request in Swift using URLSession.",
+    itemsInCorrectOrder: [
+      "Create a URL object.",
+      "Create a URLSessionDataTask with the URL.",
+      "Start the task by calling its resume() method.",
+      "Handle the completion handler with data, response, and error."
+    ],
+    explanation: "This is the fundamental sequence for a basic data task in URLSession.",
     points: 10,
-    difficulty: "easy",
-    topic: "Swift Constants",
+    difficulty: "medium",
+    topic: "Swift Networking",
     verifiedCategory: category
   }, null, 2);
   return `${attemptInfo}You are an expert Question Author for advanced technical education, specializing in: ${category}.
-Your mission is to create a high-quality, technically accurate Short Answer Question.
+Your mission is to create a high-quality, technically accurate Sequence Question.
 
 ## Core Rules (Non-negotiable)
 1.  **Category Purity:** The question MUST be exclusively about **${category}**.
-2.  **Objective Answer:** The question must have a short, factual, and objective answer. Avoid questions that are subjective or require long explanations.
-3.  **Schema Integrity:** The response MUST be ONLY a single, valid JSON object.
+2.  **Unambiguous Order:** The items MUST represent a clear, objective process, timeline, or order with only one correct sequence.
+3.  **Schema Integrity:** The response MUST be ONLY a single, valid JSON object that strictly follows the provided schema.
 
 ## CRITICAL CONTEXT FOR THIS QUESTION
 ${contextStrings}
 
 ## Task: Generate the Question
-Based on all the rules and context above, generate a single Short Answer Question.
+Based on all the rules and context above, generate a single Sequence Question.
 
 ### Input Parameters
 - **Topic for Question:** ${quizContext?.plannedTopic || "General"}
 - **Language for Text:** ${language3}
 - **Difficulty Level:** ${difficulty}
+- **Number of Items:** Generate an array 'itemsInCorrectOrder' containing exactly ${numberOfItems} items. The array itself MUST be in the correct final sequence.
 
 ### Required JSON Output Format
 Your response must be ONLY the JSON object, matching this exact structure:
@@ -101142,11 +100884,11 @@ ${exampleJson}
 
 Now, generate the JSON for the requested question.`;
 }
-async function generateShortAnswerQuestion(clientInput, apiKey) {
+async function generateSequenceQuestion(clientInput, apiKey) {
   const ai = new GoogleGenAI({ apiKey });
   const model = "gemini-2.5-flash";
   const config3 = {
-    temperature: 0.5,
+    temperature: 0.7,
     responseMimeType: "application/json",
     thinkingConfig: {
       thinkingBudget: 4e3
@@ -101154,9 +100896,9 @@ async function generateShortAnswerQuestion(clientInput, apiKey) {
   };
   const attemptResults = [];
   let lastError = null;
-  for (let attempt = 1; attempt <= MAX_RETRY_ATTEMPTS4; attempt++) {
+  for (let attempt = 1; attempt <= MAX_RETRY_ATTEMPTS7; attempt++) {
     const startTime = Date.now();
-    const promptText = buildEnhancedPrompt4(clientInput, attempt);
+    const promptText = buildEnhancedPrompt7(clientInput, attempt);
     const promptHash = Buffer.from(promptText).toString("base64").slice(0, 10);
     try {
       DebugLogger.logPrompt(attempt, promptText, { ...clientInput, attemptNumber: attempt, promptHash });
@@ -101175,8 +100917,11 @@ async function generateShortAnswerQuestion(clientInput, apiKey) {
       if (!rawText) throw new Error("AI returned an empty response.");
       const parsedJson = JSON.parse(rawText);
       DebugLogger.logValidation(attempt, "JSON Parsed Successfully", parsedJson);
-      const aiGeneratedContent = AIShortAnswerOutputFieldsSchema.parse(parsedJson);
+      const aiGeneratedContent = AISequenceOutputFieldsSchema.parse(parsedJson);
       DebugLogger.logValidation(attempt, "Zod Schema Validated", aiGeneratedContent);
+      if (aiGeneratedContent.itemsInCorrectOrder.length !== clientInput.numberOfItems) {
+        throw new Error(`AI generated ${aiGeneratedContent.itemsInCorrectOrder.length} items, but ${clientInput.numberOfItems} were required.`);
+      }
       if (clientInput.quizContext?.originalCategory) {
         const verifiedCategory = aiGeneratedContent.verifiedCategory?.toLowerCase();
         const requiredCategory = clientInput.quizContext.originalCategory.toLowerCase();
@@ -101184,12 +100929,19 @@ async function generateShortAnswerQuestion(clientInput, apiKey) {
           throw new Error(`Category mismatch: Required ${requiredCategory}, got ${verifiedCategory}`);
         }
       }
+      const finalItems = [];
+      const finalCorrectOrder = [];
+      aiGeneratedContent.itemsInCorrectOrder.forEach((content4) => {
+        const id3 = generateUniqueId("seqi_");
+        finalItems.push({ id: id3, content: content4 });
+        finalCorrectOrder.push(id3);
+      });
       const completeQuestion = {
-        id: generateUniqueId("saq_ai_"),
-        questionType: "short_answer",
+        id: generateUniqueId("seq_ai_"),
+        questionType: "sequence",
         prompt: aiGeneratedContent.prompt,
-        acceptedAnswers: aiGeneratedContent.acceptedAnswers,
-        isCaseSensitive: clientInput.isCaseSensitive,
+        items: finalItems,
+        correctOrder: finalCorrectOrder,
         explanation: aiGeneratedContent.explanation,
         points: aiGeneratedContent.points,
         topic: aiGeneratedContent.topic || clientInput.quizContext?.originalTopic,
@@ -101201,48 +100953,46 @@ async function generateShortAnswerQuestion(clientInput, apiKey) {
         category: clientInput.quizContext?.originalCategory,
         imageUrl: clientInput.imageUrl
       };
-      const validatedQuestion = ShortAnswerQuestionZodSchema.parse(completeQuestion);
+      const validatedQuestion = SequenceQuestionZodSchema.parse(completeQuestion);
       attemptResults.push({ success: true, duration, promptLength: promptText.length, responseLength: rawText.length, promptHash });
       console.log(`
-\u2705 Short Answer generation successful on attempt ${attempt} (${duration}ms)`);
+\u2705 Sequence generation successful on attempt ${attempt} (${duration}ms)`);
       if (attempt > 1) DebugLogger.logAttemptSummary(attemptResults);
       return { question: validatedQuestion };
     } catch (error) {
       lastError = error;
       const duration = Date.now() - startTime;
       attemptResults.push({ success: false, duration, error: error.message, promptLength: promptText.length, promptHash });
-      const willRetry = attempt < MAX_RETRY_ATTEMPTS4;
+      const willRetry = attempt < MAX_RETRY_ATTEMPTS7;
       DebugLogger.logRetryInfo(attempt, error, willRetry);
       if (willRetry) {
-        console.log(`\u23F3 Retrying in ${RETRY_DELAY_MS4}ms...`);
-        await new Promise((resolve) => setTimeout(resolve, RETRY_DELAY_MS4));
+        console.log(`\u23F3 Retrying in ${RETRY_DELAY_MS7}ms...`);
+        await new Promise((resolve) => setTimeout(resolve, RETRY_DELAY_MS7));
       }
     }
   }
   DebugLogger.logAttemptSummary(attemptResults);
-  const errorMessage = `Failed to generate Short Answer question after ${MAX_RETRY_ATTEMPTS4} attempts. Last error: ${lastError?.message}`;
+  const errorMessage = `Failed to generate Sequence question after ${MAX_RETRY_ATTEMPTS7} attempts. Last error: ${lastError?.message}`;
   console.error("\n\u274C Final Result: FAILED");
   console.error(errorMessage);
   return { error: errorMessage };
 }
 
-// src/ai/flows/question-gen/generate-numeric-question.ts
+// src/ai/flows/question-gen/generate-matching-question.ts
 init_react_shim();
 
-// src/ai/flows/question-gen/generate-numeric-question-types.ts
+// src/ai/flows/question-gen/generate-matching-question-types.ts
 init_react_shim();
 BaseQuestionGenerationClientInputSchema.extend({
-  allowDecimals: z.boolean().optional().default(true),
-  minRange: z.number().optional(),
-  maxRange: z.number().optional(),
-  // Thêm trường tolerance để client có thể tùy chỉnh
-  tolerance: z.number().min(0).optional().default(0)
+  numberOfPairs: z.number().int().min(2).max(8).optional().default(4),
+  shuffleOptions: z.boolean().optional().default(true)
 });
-var AINumericOutputFieldsSchema = z.object({
-  prompt: z.string(),
-  answer: z.number(),
-  // AI có thể đề xuất một tolerance, nhưng chúng ta sẽ ưu tiên của client
-  tolerance: z.number().min(0).optional(),
+var AIMatchingOutputFieldsSchema = z.object({
+  prompt: z.string().describe("The instructional text for the user, e.g., 'Match the concept to its definition.'"),
+  correctPairs: z.array(z.object({
+    promptText: z.string().min(1).describe("The text for the left-hand side item (the prompt)."),
+    optionText: z.string().min(1).describe("The text for the right-hand side item (the matching option).")
+  })).min(2),
   explanation: z.string().optional(),
   points: z.number().optional().default(10),
   difficulty: z.enum(["easy", "medium", "hard"]).optional(),
@@ -101251,61 +101001,57 @@ var AINumericOutputFieldsSchema = z.object({
   // Thêm để xác thực
 });
 
-// src/ai/flows/question-gen/generate-numeric-question.ts
-var MAX_RETRY_ATTEMPTS5 = 3;
-var RETRY_DELAY_MS5 = 3e3;
-function buildEnhancedPrompt5(clientInput, attemptNumber) {
-  const { quizContext, language: language3, difficulty, minRange, maxRange, allowDecimals, imageUrl } = clientInput;
+// src/ai/flows/question-gen/generate-matching-question.ts
+var MAX_RETRY_ATTEMPTS8 = 3;
+var RETRY_DELAY_MS8 = 3e3;
+function buildEnhancedPrompt8(clientInput, attemptNumber) {
+  const { quizContext, language: language3, difficulty, numberOfPairs, imageUrl } = clientInput;
   const category = quizContext?.originalCategory || "the specified technical category";
   const attemptInfo = attemptNumber > 1 ? `
 ## DEBUG INFO - This is attempt #${attemptNumber}
-Previous attempts failed. Ensure the 'answer' is a valid number and fits within the specified constraints.
+Previous attempts failed. Please ensure the 'correctPairs' array has exactly the required number of items and the JSON is valid.
 
 ` : "";
-  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 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}`,
     imageContextInstruction,
     quizContext?.plannedBloomLevel && `**Cognitive Level (Bloom's):** ${quizContext.plannedBloomLevel}`,
-    quizContext?.targetMisconception && `**Target Misconception:** The question should clarify this numerical error: "${quizContext.targetMisconception}"`
+    quizContext?.targetMisconception && `**Target Misconception:** Design a pair that specifically tests this confusion: "${quizContext.targetMisconception}"`
   ].filter(Boolean).map((s4) => `- ${s4}`).join("\n");
-  const constraintStrings = [
-    minRange !== void 0 && `The final 'answer' MUST be greater than or equal to ${minRange}.`,
-    maxRange !== void 0 && `The final 'answer' MUST be less than or equal to ${maxRange}.`,
-    !allowDecimals && `The final 'answer' MUST be an integer (whole number).`
-  ].filter(Boolean).join("\n");
   const exampleJson = JSON.stringify({
-    prompt: "A Swift `Int` on a 64-bit platform can store a maximum value of 2^63 - 1. What is the maximum value for an `Int8`?",
-    answer: 127,
-    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).",
+    prompt: "Match each Swift collection type to its primary characteristic.",
+    correctPairs: [
+      { "promptText": "Array", "optionText": "An ordered, random-access collection." },
+      { "promptText": "Set", "optionText": "An unordered collection of unique elements." },
+      { "promptText": "Dictionary", "optionText": "An unordered collection of key-value associations." }
+    ],
+    explanation: "These are the fundamental characteristics of Swift's main collection types.",
     points: 10,
-    difficulty: "medium",
-    topic: "Swift Data Types",
+    difficulty: "easy",
+    topic: "Swift Collection Types",
     verifiedCategory: category
   }, null, 2);
   return `${attemptInfo}You are an expert Question Author for advanced technical education, specializing in: ${category}.
-Your mission is to create a high-quality, technically accurate Numeric Question.
+Your mission is to create a high-quality, technically accurate Matching Question.
 
 ## Core Rules (Non-negotiable)
 1.  **Category Purity:** The question MUST be exclusively about **${category}**.
-2.  **Quantitative Answer:** The question MUST ask for a specific, objective numerical answer.
-3.  **Schema Integrity:** The response MUST be ONLY a single, valid JSON object.
+2.  **Logical Pairs:** The items to be matched must have a clear, one-to-one relationship.
+3.  **Schema Integrity:** The response MUST be ONLY a single, valid JSON object that strictly follows the provided schema.
 
 ## CRITICAL CONTEXT FOR THIS QUESTION
 ${contextStrings}
 
 ## Task: Generate the Question
-Based on all the rules and context above, generate a single Numeric Question.
+Based on all the rules and context above, generate a single Matching Question.
 
-### Input Parameters & Constraints
+### Input Parameters
 - **Topic for Question:** ${quizContext?.plannedTopic || "General"}
 - **Language for Text:** ${language3}
 - **Difficulty Level:** ${difficulty}
-${constraintStrings ? `
-### CRITICAL CONSTRAINTS ON THE ANSWER
-${constraintStrings}` : ""}
+- **Number of Pairs:** Generate exactly ${numberOfPairs} correct pairs in the 'correctPairs' array.
 
 ### Required JSON Output Format
 Your response must be ONLY the JSON object, matching this exact structure:
@@ -101314,15 +101060,11 @@ ${exampleJson}
 
 Now, generate the JSON for the requested question.`;
 }
-async function generateNumericQuestion(clientInput, apiKey) {
-  if (clientInput.minRange !== void 0 && clientInput.maxRange !== void 0 && clientInput.minRange > clientInput.maxRange) {
-    return { error: `Invalid input: minRange (${clientInput.minRange}) cannot be greater than maxRange (${clientInput.maxRange}).` };
-  }
+async function generateMatchingQuestion(clientInput, apiKey) {
   const ai = new GoogleGenAI({ apiKey });
   const model = "gemini-2.5-flash";
   const config3 = {
-    temperature: 0.4,
-    // Giữ nhiệt độ thấp cho các câu trả lời chính xác
+    temperature: 0.8,
     responseMimeType: "application/json",
     thinkingConfig: {
       thinkingBudget: 4e3
@@ -101330,9 +101072,9 @@ async function generateNumericQuestion(clientInput, apiKey) {
   };
   const attemptResults = [];
   let lastError = null;
-  for (let attempt = 1; attempt <= MAX_RETRY_ATTEMPTS5; attempt++) {
+  for (let attempt = 1; attempt <= MAX_RETRY_ATTEMPTS8; attempt++) {
     const startTime = Date.now();
-    const promptText = buildEnhancedPrompt5(clientInput, attempt);
+    const promptText = buildEnhancedPrompt8(clientInput, attempt);
     const promptHash = Buffer.from(promptText).toString("base64").slice(0, 10);
     try {
       DebugLogger.logPrompt(attempt, promptText, { ...clientInput, attemptNumber: attempt, promptHash });
@@ -101351,17 +101093,10 @@ async function generateNumericQuestion(clientInput, apiKey) {
       if (!rawText) throw new Error("AI returned an empty response.");
       const parsedJson = JSON.parse(rawText);
       DebugLogger.logValidation(attempt, "JSON Parsed Successfully", parsedJson);
-      const aiGeneratedContent = AINumericOutputFieldsSchema.parse(parsedJson);
+      const aiGeneratedContent = AIMatchingOutputFieldsSchema.parse(parsedJson);
       DebugLogger.logValidation(attempt, "Zod Schema Validated", aiGeneratedContent);
-      const answer = aiGeneratedContent.answer;
-      if (clientInput.minRange !== void 0 && answer < clientInput.minRange) {
-        throw new Error(`AI answer ${answer} is less than the required minRange of ${clientInput.minRange}.`);
-      }
-      if (clientInput.maxRange !== void 0 && answer > clientInput.maxRange) {
-        throw new Error(`AI answer ${answer} is greater than the required maxRange of ${clientInput.maxRange}.`);
-      }
-      if (!clientInput.allowDecimals && !Number.isInteger(answer)) {
-        throw new Error(`AI answer ${answer} is not an integer, but decimals are not allowed.`);
+      if (aiGeneratedContent.correctPairs.length !== clientInput.numberOfPairs) {
+        throw new Error(`AI generated ${aiGeneratedContent.correctPairs.length} pairs, but ${clientInput.numberOfPairs} were required.`);
       }
       if (clientInput.quizContext?.originalCategory) {
         const verifiedCategory = aiGeneratedContent.verifiedCategory?.toLowerCase();
@@ -101370,12 +101105,24 @@ async function generateNumericQuestion(clientInput, apiKey) {
           throw new Error(`Category mismatch: Required ${requiredCategory}, got ${verifiedCategory}`);
         }
       }
+      const finalPrompts = [];
+      const finalOptions = [];
+      const finalCorrectAnswerMap = [];
+      aiGeneratedContent.correctPairs.forEach((pair2) => {
+        const promptId = generateUniqueId("m_p_");
+        const optionId = generateUniqueId("m_o_");
+        finalPrompts.push({ id: promptId, content: pair2.promptText });
+        finalOptions.push({ id: optionId, content: pair2.optionText });
+        finalCorrectAnswerMap.push({ promptId, optionId });
+      });
       const completeQuestion = {
-        id: generateUniqueId("num_ai_"),
-        questionType: "numeric",
+        id: generateUniqueId("match_ai_"),
+        questionType: "matching",
         prompt: aiGeneratedContent.prompt,
-        answer: aiGeneratedContent.answer,
-        tolerance: clientInput.tolerance ?? aiGeneratedContent.tolerance ?? 0,
+        prompts: finalPrompts,
+        options: finalOptions,
+        correctAnswerMap: finalCorrectAnswerMap,
+        shuffleOptions: clientInput.shuffleOptions,
         explanation: aiGeneratedContent.explanation,
         points: aiGeneratedContent.points,
         topic: aiGeneratedContent.topic || clientInput.quizContext?.originalTopic,
@@ -101387,578 +101134,881 @@ async function generateNumericQuestion(clientInput, apiKey) {
         category: clientInput.quizContext?.originalCategory,
         imageUrl: clientInput.imageUrl
       };
-      const validatedQuestion = NumericQuestionZodSchema.parse(completeQuestion);
+      const validatedQuestion = MatchingQuestionZodSchema.parse(completeQuestion);
       attemptResults.push({ success: true, duration, promptLength: promptText.length, responseLength: rawText.length, promptHash });
       console.log(`
-\u2705 Numeric generation successful on attempt ${attempt} (${duration}ms)`);
+\u2705 Matching generation successful on attempt ${attempt} (${duration}ms)`);
       if (attempt > 1) DebugLogger.logAttemptSummary(attemptResults);
       return { question: validatedQuestion };
     } catch (error) {
       lastError = error;
       const duration = Date.now() - startTime;
       attemptResults.push({ success: false, duration, error: error.message, promptLength: promptText.length, promptHash });
-      const willRetry = attempt < MAX_RETRY_ATTEMPTS5;
+      const willRetry = attempt < MAX_RETRY_ATTEMPTS8;
       DebugLogger.logRetryInfo(attempt, error, willRetry);
       if (willRetry) {
-        console.log(`\u23F3 Retrying in ${RETRY_DELAY_MS5}ms...`);
-        await new Promise((resolve) => setTimeout(resolve, RETRY_DELAY_MS5));
+        console.log(`\u23F3 Retrying in ${RETRY_DELAY_MS8}ms...`);
+        await new Promise((resolve) => setTimeout(resolve, RETRY_DELAY_MS8));
       }
     }
   }
   DebugLogger.logAttemptSummary(attemptResults);
-  const errorMessage = `Failed to generate Numeric question after ${MAX_RETRY_ATTEMPTS5} attempts. Last error: ${lastError?.message}`;
+  const errorMessage = `Failed to generate Matching question after ${MAX_RETRY_ATTEMPTS8} attempts. Last error: ${lastError?.message}`;
   console.error("\n\u274C Final Result: FAILED");
   console.error(errorMessage);
   return { error: errorMessage };
 }
 
-// src/ai/flows/question-gen/generate-fitb-question.ts
+// src/react-ui/components/authoring/AIQuestionGeneratorModal.tsx
+var supportedQuestionTypesForAI = [
+  { value: "true_false", label: "True/False" },
+  { value: "multiple_choice", label: "Multiple Choice" },
+  { value: "multiple_response", label: "Multiple Response" },
+  { value: "short_answer", label: "Short Answer" },
+  { value: "numeric", label: "Numeric" },
+  { value: "fill_in_the_blanks", label: "Fill In The Blanks" },
+  { value: "sequence", label: "Sequence" },
+  { value: "matching", label: "Matching" }
+];
+var AIQuestionGeneratorModal = ({
+  isOpen,
+  onClose,
+  onQuestionGenerated,
+  language: language3,
+  questionType: questionTypeProp,
+  subjects = [],
+  topics = [],
+  gradeLevels = [],
+  bloomLevels = []
+}) => {
+  const [prompt, setPrompt] = useState("");
+  const [isLoading, setIsLoading] = useState(false);
+  const [error, setError] = useState(null);
+  const { toast: toast2 } = useToast();
+  const [subjectCode, setSubjectCode] = useState("");
+  const [topicCode, setTopicCode] = useState("");
+  const [gradeBand, setGradeBand] = useState("");
+  const [bloomLevelCode, setBloomLevelCode] = useState("");
+  const [selectedQuestionType, setSelectedQuestionType] = useState("multiple_choice");
+  const [numberOfOptions, setNumberOfOptions] = useState(4);
+  const [minCorrectAnswers, setMinCorrectAnswers] = useState(2);
+  const [maxCorrectAnswers, setMaxCorrectAnswers] = useState(3);
+  const [isCaseSensitive, setIsCaseSensitive] = useState(false);
+  const [numberOfBlanks, setNumberOfBlanks] = useState(2);
+  const [numberOfSequenceItems, setNumberOfSequenceItems] = useState(4);
+  const [numberOfMatchingPairs, setNumberOfMatchingPairs] = useState(4);
+  const [isApiKeyManagerModalOpen, setIsApiKeyManagerModalOpen] = useState(false);
+  const [geminiApiKeyExists, setGeminiApiKeyExists] = useState(false);
+  const finalQuestionType = questionTypeProp || selectedQuestionType;
+  useEffect(() => {
+    if (isOpen) {
+      setPrompt("");
+      setError(null);
+      setIsLoading(false);
+      setSubjectCode("");
+      setTopicCode("");
+      setGradeBand("");
+      setBloomLevelCode("");
+      setSelectedQuestionType(questionTypeProp || "multiple_choice");
+      setGeminiApiKeyExists(APIKeyService.hasAPIKey(GEMINI_API_KEY_SERVICE_NAME));
+    }
+  }, [isOpen, questionTypeProp]);
+  const filteredTopics = useMemo(() => {
+    if (!subjectCode) return [];
+    return topics.filter((t4) => t4.subjectCode === subjectCode);
+  }, [subjectCode, topics]);
+  const handleApiKeyModalClose = () => {
+    setIsApiKeyManagerModalOpen(false);
+    setGeminiApiKeyExists(APIKeyService.hasAPIKey(GEMINI_API_KEY_SERVICE_NAME));
+  };
+  const handleSubmit = async () => {
+    if (!prompt.trim()) {
+      setError("Please provide a prompt for the question.");
+      return;
+    }
+    const geminiKey = APIKeyService.getAPIKey(GEMINI_API_KEY_SERVICE_NAME);
+    if (!geminiKey) {
+      setError("Gemini API Key is not set. Please configure it.");
+      setGeminiApiKeyExists(false);
+      return;
+    }
+    setGeminiApiKeyExists(true);
+    setError(null);
+    setIsLoading(true);
+    try {
+      const quizContext = {
+        plannedTopic: prompt,
+        originalSubject: subjectCode,
+        originalTopic: topicCode,
+        gradeBand,
+        plannedBloomLevel: bloomLevelCode
+      };
+      const baseClientInput = {
+        language: language3,
+        difficulty: "medium",
+        quizContext
+      };
+      let generatedResult = {};
+      switch (finalQuestionType) {
+        case "true_false":
+          generatedResult = await generateTrueFalseQuestion(baseClientInput, geminiKey);
+          break;
+        case "multiple_choice":
+          generatedResult = await generateMCQQuestion({ ...baseClientInput, numberOfOptions }, geminiKey);
+          break;
+        case "multiple_response":
+          generatedResult = await generateMRQQuestion({ ...baseClientInput, numberOfOptions, minCorrectAnswers, maxCorrectAnswers }, geminiKey);
+          break;
+        case "short_answer":
+          generatedResult = await generateShortAnswerQuestion({ ...baseClientInput, isCaseSensitive }, geminiKey);
+          break;
+        case "numeric":
+          generatedResult = await generateNumericQuestion({ ...baseClientInput, allowDecimals: true, tolerance: 0 }, geminiKey);
+          break;
+        case "fill_in_the_blanks":
+          generatedResult = await generateFillInTheBlanksQuestion({ ...baseClientInput, numberOfBlanks, isCaseSensitive }, geminiKey);
+          break;
+        case "sequence":
+          generatedResult = await generateSequenceQuestion({ ...baseClientInput, numberOfItems: numberOfSequenceItems }, geminiKey);
+          break;
+        case "matching":
+          generatedResult = await generateMatchingQuestion({ ...baseClientInput, numberOfPairs: numberOfMatchingPairs, shuffleOptions: true }, geminiKey);
+          break;
+        default:
+          throw new Error(`AI generation for '${finalQuestionType}' is not implemented in this flow.`);
+      }
+      if (generatedResult.error) {
+        throw new Error(generatedResult.error);
+      }
+      if (generatedResult.question) {
+        const completeQuestion = generatedResult.question;
+        completeQuestion.subject = subjectCode;
+        completeQuestion.topic = topicCode;
+        completeQuestion.gradeBand = gradeBand;
+        completeQuestion.bloomLevel = bloomLevelCode;
+        if (completeQuestion.points === void 0) completeQuestion.points = 10;
+        onQuestionGenerated(completeQuestion);
+        toast2({ title: "AI Question Generated", description: "Review and edit the generated question." });
+        onClose();
+      } else {
+        throw new Error("AI did not return a valid question object.");
+      }
+    } catch (e3) {
+      console.error("AI Question Generation Error:", e3);
+      let errorMessage = e3.message || "An unknown error occurred.";
+      if (typeof errorMessage === "string" && errorMessage.includes("API key not valid")) {
+        errorMessage = "The provided Google Gemini API Key is invalid. Please check it.";
+        setGeminiApiKeyExists(false);
+      }
+      setError(errorMessage);
+      toast2({ title: "AI Generation Failed", description: errorMessage, variant: "destructive" });
+    } finally {
+      setIsLoading(false);
+    }
+  };
+  const comboboxOptions = {
+    subjects: subjects.map((s4) => ({ value: s4.code, label: s4.name })),
+    topics: filteredTopics.map((t4) => ({ value: t4.code, label: t4.name })),
+    gradeLevels: gradeLevels.map((g) => ({ value: g.code, label: g.name })),
+    bloomLevels: bloomLevels.map((b2) => ({ value: b2.code, label: b2.name }))
+  };
+  const renderSpecificParams = () => {
+    switch (finalQuestionType) {
+      case "multiple_choice":
+      case "multiple_response":
+        return /* @__PURE__ */ React169__default.createElement("div", { className: "space-y-2 pt-4 border-t" }, /* @__PURE__ */ React169__default.createElement(Label2, { htmlFor: "ai-num-options" }, "Number of Options (2-8)"), /* @__PURE__ */ React169__default.createElement(
+          Input,
+          {
+            id: "ai-num-options",
+            type: "number",
+            value: numberOfOptions,
+            onChange: (e3) => setNumberOfOptions(parseInt(e3.target.value, 10)),
+            min: 2,
+            max: 8
+          }
+        ), finalQuestionType === "multiple_response" && /* @__PURE__ */ React169__default.createElement(React169__default.Fragment, null, /* @__PURE__ */ React169__default.createElement(Label2, { htmlFor: "ai-min-correct" }, "Min Correct Answers"), /* @__PURE__ */ React169__default.createElement(Input, { id: "ai-min-correct", type: "number", value: minCorrectAnswers, onChange: (e3) => setMinCorrectAnswers(parseInt(e3.target.value, 10)), min: 1, max: numberOfOptions }), /* @__PURE__ */ React169__default.createElement(Label2, { htmlFor: "ai-max-correct" }, "Max Correct Answers"), /* @__PURE__ */ React169__default.createElement(Input, { id: "ai-max-correct", type: "number", value: maxCorrectAnswers, onChange: (e3) => setMaxCorrectAnswers(parseInt(e3.target.value, 10)), min: minCorrectAnswers, max: numberOfOptions })));
+      case "short_answer":
+      case "fill_in_the_blanks":
+        return /* @__PURE__ */ React169__default.createElement("div", { className: "flex items-center space-x-2 pt-4 border-t" }, /* @__PURE__ */ React169__default.createElement("input", { type: "checkbox", id: "ai-case-sensitive", checked: isCaseSensitive, onChange: (e3) => setIsCaseSensitive(e3.target.checked), className: "h-4 w-4 rounded border-gray-300 text-primary focus:ring-primary" }), /* @__PURE__ */ React169__default.createElement(Label2, { htmlFor: "ai-case-sensitive" }, "Case Sensitive Answers"), finalQuestionType === "fill_in_the_blanks" && /* @__PURE__ */ React169__default.createElement("div", { className: "space-y-1 ml-4" }, /* @__PURE__ */ React169__default.createElement(Label2, { htmlFor: "ai-num-blanks" }, "Number of Blanks (1-5)"), /* @__PURE__ */ React169__default.createElement(Input, { id: "ai-num-blanks", type: "number", value: numberOfBlanks, onChange: (e3) => setNumberOfBlanks(parseInt(e3.target.value, 10)), min: 1, max: 5 })));
+      case "sequence":
+        return /* @__PURE__ */ React169__default.createElement("div", { className: "space-y-2 pt-4 border-t" }, /* @__PURE__ */ React169__default.createElement(Label2, { htmlFor: "ai-num-seq-items" }, "Number of Items to Sequence (2-10)"), /* @__PURE__ */ React169__default.createElement(Input, { id: "ai-num-seq-items", type: "number", value: numberOfSequenceItems, onChange: (e3) => setNumberOfSequenceItems(parseInt(e3.target.value, 10)), min: 2, max: 10 }));
+      case "matching":
+        return /* @__PURE__ */ React169__default.createElement("div", { className: "space-y-2 pt-4 border-t" }, /* @__PURE__ */ React169__default.createElement(Label2, { htmlFor: "ai-num-match-pairs" }, "Number of Pairs to Match (2-8)"), /* @__PURE__ */ React169__default.createElement(Input, { id: "ai-num-match-pairs", type: "number", value: numberOfMatchingPairs, onChange: (e3) => setNumberOfMatchingPairs(parseInt(e3.target.value, 10)), min: 2, max: 8 }));
+      default:
+        return null;
+    }
+  };
+  return /* @__PURE__ */ React169__default.createElement(React169__default.Fragment, null, /* @__PURE__ */ React169__default.createElement(Dialog2, { open: isOpen, onOpenChange: (open) => {
+    if (!open) onClose();
+  } }, /* @__PURE__ */ React169__default.createElement(DialogContent2, { className: "sm:max-w-[600px]" }, /* @__PURE__ */ React169__default.createElement(DialogHeader, null, /* @__PURE__ */ React169__default.createElement(DialogTitle2, { className: "flex items-center font-headline text-2xl" }, /* @__PURE__ */ React169__default.createElement(WandSparkles, { className: "mr-2 h-6 w-6 text-primary" }), " AI Question Generator"), /* @__PURE__ */ React169__default.createElement(DialogDescription2, null, "Provide a prompt and metadata to generate a '", finalQuestionType, "' question.")), /* @__PURE__ */ React169__default.createElement("div", { className: "space-y-4 py-4 max-h-[60vh] overflow-y-auto px-2" }, !geminiApiKeyExists && /* @__PURE__ */ React169__default.createElement("div", { className: "p-3 mb-4 border border-amber-500 bg-amber-50 rounded-md text-amber-700" }), !questionTypeProp && /* @__PURE__ */ React169__default.createElement("div", { className: "space-y-2" }, /* @__PURE__ */ React169__default.createElement(Label2, { htmlFor: "ai-q-type-select" }, "Question Type"), /* @__PURE__ */ React169__default.createElement(Select2, { value: selectedQuestionType, onValueChange: (v) => setSelectedQuestionType(v) }, /* @__PURE__ */ React169__default.createElement(SelectTrigger2, { id: "ai-q-type-select" }, /* @__PURE__ */ React169__default.createElement(SelectValue2, null)), /* @__PURE__ */ React169__default.createElement(SelectContent2, null, supportedQuestionTypesForAI.map((type) => /* @__PURE__ */ React169__default.createElement(SelectItem2, { key: type.value, value: type.value }, type.label))))), /* @__PURE__ */ React169__default.createElement("div", { className: "space-y-2" }, /* @__PURE__ */ React169__default.createElement(Label2, { htmlFor: "ai-prompt" }, "Prompt / Topic"), /* @__PURE__ */ React169__default.createElement(
+    Textarea,
+    {
+      id: "ai-prompt",
+      value: prompt,
+      onChange: (e3) => setPrompt(e3.target.value),
+      placeholder: "e.g., The process of photosynthesis, The causes of World War II, Basic Algebra Equations",
+      className: "min-h-[100px]"
+    }
+  )), /* @__PURE__ */ React169__default.createElement("div", { className: "grid grid-cols-2 gap-4" }, /* @__PURE__ */ React169__default.createElement("div", { className: "space-y-2" }, /* @__PURE__ */ React169__default.createElement(Label2, null, "Subject"), /* @__PURE__ */ React169__default.createElement(EditableCombobox, { options: comboboxOptions.subjects, value: subjectCode, onChange: setSubjectCode, placeholder: "Select or type a Subject..." })), /* @__PURE__ */ React169__default.createElement("div", { className: "space-y-2" }, /* @__PURE__ */ React169__default.createElement(Label2, null, "Topic"), /* @__PURE__ */ React169__default.createElement(EditableCombobox, { options: comboboxOptions.topics, value: topicCode, onChange: setTopicCode, placeholder: "Select or type a Topic...", disabled: !subjectCode })), /* @__PURE__ */ React169__default.createElement("div", { className: "space-y-2" }, /* @__PURE__ */ React169__default.createElement(Label2, null, "Grade Level"), /* @__PURE__ */ React169__default.createElement(EditableCombobox, { options: comboboxOptions.gradeLevels, value: gradeBand, onChange: setGradeBand, placeholder: "Select or type a Grade..." })), /* @__PURE__ */ React169__default.createElement("div", { className: "space-y-2" }, /* @__PURE__ */ React169__default.createElement(Label2, null, "Bloom's Level"), /* @__PURE__ */ React169__default.createElement(EditableCombobox, { options: comboboxOptions.bloomLevels, value: bloomLevelCode, onChange: setBloomLevelCode, placeholder: "Select a Bloom's Level..." }))), renderSpecificParams(), error && /* @__PURE__ */ React169__default.createElement("p", { className: "text-sm text-destructive flex items-center mt-2" }, /* @__PURE__ */ React169__default.createElement(TriangleAlert, { className: "mr-1 h-4 w-4" }), " ", error)), /* @__PURE__ */ React169__default.createElement(DialogFooter, null, /* @__PURE__ */ React169__default.createElement(DialogClose2, { asChild: true }, /* @__PURE__ */ React169__default.createElement(Button, { type: "button", variant: "outline" }, "Cancel")), /* @__PURE__ */ React169__default.createElement(Button, { type: "button", onClick: handleSubmit, disabled: isLoading || !prompt.trim() || !geminiApiKeyExists }, isLoading ? /* @__PURE__ */ React169__default.createElement(LoaderCircle, { className: "mr-2 h-4 w-4 animate-spin" }) : /* @__PURE__ */ React169__default.createElement(WandSparkles, { className: "mr-2 h-4 w-4" }), "Generate Question")))), /* @__PURE__ */ React169__default.createElement(APIKeyManagerModal, { isOpen: isApiKeyManagerModalOpen, onClose: handleApiKeyModalClose }));
+};
+
+// src/react-ui/components/authoring/AIFullQuizGeneratorModal.tsx
+init_react_shim();
+
+// src/ai/flows/generate-quiz-plan.ts
+init_react_shim();
+
+// src/ai/flows/generate-quiz-plan-types.ts
 init_react_shim();
+var TopicWithMetadataSchema = z.object({
+  topic: z.string().min(1),
+  ratio: z.number().min(0).max(100),
+  originalLoId: z.string().optional(),
+  originalSubject: z.string().optional(),
+  originalCategory: z.string().optional(),
+  originalTopic: z.string().optional(),
+  commonMisconceptions: z.array(z.string()).optional()
+});
+var BloomLevelStringsEnum = z.enum(["remembering", "understanding", "applying", "analyzing", "evaluating", "creating"]);
+var fullQuizSupportedQuestionTypesArray = [
+  "true_false",
+  "multiple_choice",
+  "multiple_response",
+  "short_answer",
+  "numeric",
+  "fill_in_the_blanks",
+  "sequence",
+  "matching",
+  "drag_and_drop",
+  "coding"
+];
+z.object({
+  language: z.string().optional().default("English"),
+  totalQuestions: z.number().int().min(1).max(50),
+  numCodingQuestions: z.number().optional().default(0),
+  topics: z.array(TopicWithMetadataSchema).min(1),
+  bloomLevels: z.array(z.object({
+    level: BloomLevelStringsEnum,
+    ratio: z.number().min(0).max(100)
+  })).min(1),
+  selectedContextIds: z.array(z.string()).optional(),
+  selectedQuestionTypes: z.array(z.enum(fullQuizSupportedQuestionTypesArray)).min(1),
+  imageContexts: z.array(z.custom()).optional().describe("Library of available image contexts for the AI to use.")
+});
+var PlannedQuestionSchema = z.object({
+  plannedTopic: z.string().min(1).describe("The specific, assessable topic for this question."),
+  plannedQuestionType: z.enum(fullQuizSupportedQuestionTypesArray).describe("The specific question type chosen."),
+  plannedBloomLevel: BloomLevelStringsEnum.describe("The Bloom's level assigned."),
+  plannedContextId: z.string().optional().describe("The specific context ID chosen for this question."),
+  imageId: z.string().nullable().optional().describe("The ID of the image from the context library to be used for this question."),
+  targetMisconception: z.string().optional().describe("A specific common misconception this question should target."),
+  difficultyReason: z.string().optional().describe("Strategic explanation of difficulty choice and placement."),
+  topicSpecificity: z.enum(["broad", "focused", "specific"]).optional().describe("How specific the topic coverage should be."),
+  originalLoId: z.string().optional(),
+  originalSubject: z.string().optional(),
+  originalCategory: z.string().optional(),
+  originalTopic: z.string().optional()
+});
+var GenerateQuizPlanOutputSchema = z.object({
+  quizPlan: z.array(PlannedQuestionSchema).describe("A detailed plan for each question in the quiz."),
+  diversityMetrics: z.object({
+    questionTypeDistribution: z.record(z.number()).optional(),
+    bloomLevelDistribution: z.record(z.number()).optional(),
+    maxConsecutiveSameType: z.number().optional()
+  }).optional().describe("Metrics showing the diversity achieved in the plan."),
+  planningStrategy: z.object({
+    overallApproach: z.string().optional(),
+    keyDecisions: z.array(z.string()).optional()
+  }).optional()
+});
+
+// src/ai/flows/generate-quiz-plan.ts
+var QuizPlanLogger = class {
+  constructor() {
+    this.logs = [];
+    this.startTime = Date.now();
+  }
+  log(phase, data, duration) {
+    this.logs.push({
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      phase,
+      data,
+      duration
+    });
+    if (duration !== void 0) {
+      console.log(`[${phase}] Completed in ${duration}ms:`, data);
+    } else {
+      console.log(`[${phase}]:`, data);
+    }
+  }
+  getLogs() {
+    return this.logs;
+  }
+  getTotalDuration() {
+    return Date.now() - this.startTime;
+  }
+};
+function generateQuestionTypeSelectionGuidance() {
+  return `
+QUESTION TYPE SELECTION BEST PRACTICES:
 
-// src/ai/flows/question-gen/generate-fitb-question-types.ts
-init_react_shim();
-BaseQuestionGenerationClientInputSchema.extend({
-  numberOfBlanks: z.number().int().min(1).max(5).optional().default(1),
-  isCaseSensitive: z.boolean().optional().default(false)
-});
-var AIFillInTheBlanksOutputFieldsSchema = z.object({
-  prompt: z.string().describe("The instructional text for the user, e.g., 'Fill in the blanks to complete the sentence.'"),
-  // Yêu cầu AI trả về cấu trúc segments trực tiếp
-  segments: z.array(z.object({
-    type: z.enum(["text", "blank"]),
-    content: z.string().optional().describe("The text content for a 'text' segment."),
-    acceptedAnswers: z.array(z.string().min(1)).min(1).optional().describe("An array of correct answers for a 'blank' segment.")
-  })).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(),
-  topic: z.string().optional(),
-  verifiedCategory: z.string().optional()
-  // Thêm để xác thực
-});
+**TRUE_FALSE (true_false)**
+- Best for: Binary concepts, fact verification, common misconceptions
+- Bloom levels: Primarily Remembering, Understanding
+- Use when: Testing definitive statements, clarifying misconceptions
+- Example: "Photosynthesis only occurs during daytime" (targets timing misconception)
 
-// src/ai/flows/question-gen/generate-fitb-question.ts
-var MAX_RETRY_ATTEMPTS6 = 3;
-var RETRY_DELAY_MS6 = 3e3;
-function buildEnhancedPrompt6(clientInput, attemptNumber) {
-  const { quizContext, language: language3, difficulty, numberOfBlanks, imageUrl } = clientInput;
-  const category = quizContext?.originalCategory || "the specified technical category";
-  const attemptInfo = attemptNumber > 1 ? `
-## DEBUG INFO - This is attempt #${attemptNumber}
-Previous attempts failed. Pay strict attention to the JSON schema, especially the 'segments' array structure. Ensure 'blank' segments have 'acceptedAnswers' and 'text' segments have 'content'.
+**MULTIPLE CHOICE (multiple_choice)**
+- Best for: Concept selection, process understanding, comparison
+- Bloom levels: All levels, especially Understanding and Applying
+- Use when: Testing conceptual understanding with clear alternatives
+- Example: "Which factor most affects enzyme activity?" (applying knowledge)
 
-` : "";
-  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}`,
-    imageContextInstruction,
-    quizContext?.plannedBloomLevel && `**Cognitive Level (Bloom's):** ${quizContext.plannedBloomLevel}`,
-    quizContext?.targetMisconception && `**Target Misconception:** Design the blank to test this specific point: "${quizContext.targetMisconception}"`
-  ].filter(Boolean).map((s4) => `- ${s4}`).join("\n");
-  const exampleJson = JSON.stringify({
-    prompt: "Complete the following Swift code snippet.",
-    segments: [
-      { "type": "text", "content": "To declare a new function in Swift, you use the `" },
-      { "type": "blank", "acceptedAnswers": ["func"] },
-      { "type": "text", "content": "` keyword." }
-    ],
-    explanation: "The 'func' keyword is used to declare a function in the Swift programming language.",
-    points: 10,
-    difficulty: "easy",
-    topic: "Swift Function Declaration",
-    verifiedCategory: category
-  }, null, 2);
-  return `${attemptInfo}You are an expert Question Author for advanced technical education, specializing in: ${category}.
-Your mission is to create a high-quality, technically accurate Fill-in-the-Blanks Question.
+**MULTIPLE RESPONSE (multiple_response)**
+- Best for: Identifying multiple correct factors, comprehensive understanding
+- Bloom levels: Understanding, Analyzing, Evaluating
+- Use when: Multiple correct answers exist, testing thorough knowledge
+- Example: "Select all factors that influence plant growth" (analyzing components)
 
-## Core Rules (Non-negotiable)
-1.  **Category Purity:** The question MUST be exclusively about **${category}**.
-2.  **Schema Integrity:** The response MUST be ONLY a single, valid JSON object that strictly follows the provided schema.
-3.  **Logical Segments:** For 'blank' segments, you MUST provide 'acceptedAnswers'. For 'text' segments, you MUST provide 'content'. Do not mix them.
+**FILL IN THE BLANKS (fill_in_the_blanks)**
+- Best for: Key terminology, formulas, specific facts
+- Bloom levels: Remembering, Understanding
+- Use when: Testing precise recall of important terms/concepts
+- Example: "The process of _____ converts light energy to chemical energy"
 
-## CRITICAL CONTEXT FOR THIS QUESTION
-${contextStrings}
+**NUMERIC (numeric)**
+- Best for: Calculations, quantitative problems, formula application
+- Bloom levels: Applying, Analyzing
+- Use when: Mathematical computations are required
+- Example: "Calculate the molarity of a 2L solution containing 0.5 moles of NaCl"
 
-## Task: Generate the Question
-Based on all the rules and context above, generate a single Fill-in-the-Blanks Question.
+**MATCHING (matching)**
+- Best for: Connecting related concepts, terminology pairs
+- Bloom levels: Remembering, Understanding
+- Use when: Testing relationships between terms and definitions
+- Example: Match organelles with their functions
 
-### Input Parameters
-- **Topic for Question:** ${quizContext?.plannedTopic || "General"}
-- **Language for Text:** ${language3}
-- **Difficulty Level:** ${difficulty}
-- **Number of Blanks:** Generate exactly ${numberOfBlanks} segment(s) with type 'blank'.
+**SEQUENCE (sequence)**
+- Best for: Process steps, chronological order, procedural knowledge
+- Bloom levels: Understanding, Applying, Analyzing
+- Use when: Order or sequence is critical to understanding
+- Example: "Arrange the steps of mitosis in correct order"
 
-### Required JSON Output Format
-Your response must be ONLY the JSON object, matching this exact structure:
+**DRAG AND DROP (drag_and_drop)**
+- Best for: Categorization, classification, spatial relationships
+- Bloom levels: Understanding, Applying, Analyzing
+- Use when: Grouping or organizing information is key
+- Example: "Classify these compounds as acids, bases, or neutral"
 
-${exampleJson}
+**SHORT ANSWER (short_answer)**
+- Best for: Explanations, definitions, problem-solving steps
+- Bloom levels: Understanding, Applying, Analyzing, Evaluating, Creating
+- Use when: Requiring explanatory responses, open-ended thinking
+- Example: "Explain why enzymes are specific to certain substrates"
 
-Now, generate the JSON for the requested question.`;
-}
-async function generateFillInTheBlanksQuestion(clientInput, apiKey) {
-  const ai = new GoogleGenAI({ apiKey });
-  const model = "gemini-2.5-flash";
-  const config3 = {
-    temperature: 0.8,
-    responseMimeType: "application/json",
-    thinkingConfig: {
-      thinkingBudget: 4e3
-    }
-  };
-  const attemptResults = [];
-  let lastError = null;
-  for (let attempt = 1; attempt <= MAX_RETRY_ATTEMPTS6; attempt++) {
-    const startTime = Date.now();
-    const promptText = buildEnhancedPrompt6(clientInput, attempt);
-    const promptHash = Buffer.from(promptText).toString("base64").slice(0, 10);
-    try {
-      DebugLogger.logPrompt(attempt, promptText, { ...clientInput, attemptNumber: attempt, promptHash });
-      const parts = [{ text: promptText }];
-      if (clientInput.imageUrl) {
-        const mimeType = clientInput.imageUrl.endsWith(".png") ? "image/png" : "image/jpeg";
-        const imagePart = await urlToGenerativePart(clientInput.imageUrl, mimeType);
-        parts.unshift(imagePart);
-      }
-      const contents = [{ role: "user", parts }];
-      const aiResult = await ai.models.generateContent({ model, config: config3, contents });
-      const response = aiResult;
-      const rawText = response.candidates?.[0]?.content?.parts?.[0]?.text || "";
-      const duration = Date.now() - startTime;
-      DebugLogger.logResponse(attempt, rawText);
-      if (!rawText) throw new Error("AI returned an empty response.");
-      const parsedJson = JSON.parse(rawText);
-      DebugLogger.logValidation(attempt, "JSON Parsed Successfully", parsedJson);
-      const aiGeneratedContent = AIFillInTheBlanksOutputFieldsSchema.parse(parsedJson);
-      DebugLogger.logValidation(attempt, "Zod Schema Validated", aiGeneratedContent);
-      const blankCount = aiGeneratedContent.segments.filter((s4) => s4.type === "blank").length;
-      if (blankCount !== clientInput.numberOfBlanks) {
-        throw new Error(`AI generated ${blankCount} blanks, but ${clientInput.numberOfBlanks} were required.`);
-      }
-      aiGeneratedContent.segments.forEach((segment, index3) => {
-        if (segment.type === "blank" && (!segment.acceptedAnswers || segment.acceptedAnswers.length === 0)) {
-          throw new Error(`Segment ${index3} is a 'blank' but is missing 'acceptedAnswers'.`);
-        }
-        if (segment.type === "text" && typeof segment.content !== "string") {
-          throw new Error(`Segment ${index3} is 'text' but is missing 'content'.`);
-        }
-      });
-      if (clientInput.quizContext?.originalCategory) {
-        const verifiedCategory = aiGeneratedContent.verifiedCategory?.toLowerCase();
-        const requiredCategory = clientInput.quizContext.originalCategory.toLowerCase();
-        if (verifiedCategory && verifiedCategory !== requiredCategory) {
-          throw new Error(`Category mismatch: Required ${requiredCategory}, got ${verifiedCategory}`);
-        }
-      }
-      const finalSegments = [];
-      const finalAnswers = [];
-      aiGeneratedContent.segments.forEach((segment) => {
-        if (segment.type === "text") {
-          finalSegments.push({ type: "text", content: segment.content });
-        } else if (segment.type === "blank" && segment.acceptedAnswers) {
-          const blankId = generateUniqueId("blank_");
-          finalSegments.push({ type: "blank", id: blankId });
-          finalAnswers.push({ blankId, acceptedValues: segment.acceptedAnswers });
-        }
-      });
-      const completeQuestion = {
-        id: generateUniqueId("fitb_ai_"),
-        questionType: "fill_in_the_blanks",
-        prompt: aiGeneratedContent.prompt,
-        segments: finalSegments,
-        answers: finalAnswers,
-        isCaseSensitive: clientInput.isCaseSensitive,
-        explanation: aiGeneratedContent.explanation,
-        points: aiGeneratedContent.points,
-        topic: aiGeneratedContent.topic || clientInput.quizContext?.originalTopic,
-        difficulty: clientInput.difficulty,
-        contextCode: clientInput.quizContext?.plannedContextId,
-        bloomLevel: clientInput.quizContext?.plannedBloomLevel,
-        learningObjective: clientInput.quizContext?.originalLoId,
-        subject: clientInput.quizContext?.originalSubject,
-        category: clientInput.quizContext?.originalCategory,
-        imageUrl: clientInput.imageUrl
-      };
-      const validatedQuestion = FillInTheBlanksQuestionZodSchema.parse(completeQuestion);
-      attemptResults.push({ success: true, duration, promptLength: promptText.length, responseLength: rawText.length, promptHash });
-      console.log(`
-\u2705 FITB generation successful on attempt ${attempt} (${duration}ms)`);
-      if (attempt > 1) DebugLogger.logAttemptSummary(attemptResults);
-      return { question: validatedQuestion };
-    } catch (error) {
-      lastError = error;
-      const duration = Date.now() - startTime;
-      attemptResults.push({ success: false, duration, error: error.message, promptLength: promptText.length, promptHash });
-      const willRetry = attempt < MAX_RETRY_ATTEMPTS6;
-      DebugLogger.logRetryInfo(attempt, error, willRetry);
-      if (willRetry) {
-        console.log(`\u23F3 Retrying in ${RETRY_DELAY_MS6}ms...`);
-        await new Promise((resolve) => setTimeout(resolve, RETRY_DELAY_MS6));
-      }
-    }
-  }
-  DebugLogger.logAttemptSummary(attemptResults);
-  const errorMessage = `Failed to generate FITB question after ${MAX_RETRY_ATTEMPTS6} attempts. Last error: ${lastError?.message}`;
-  console.error("\n\u274C Final Result: FAILED");
-  console.error(errorMessage);
-  return { error: errorMessage };
+**CODING (coding)**
+- Best for: Programming problems, algorithm implementation
+- Bloom levels: Applying, Analyzing, Evaluating, Creating
+- Use when: Technical implementation or code analysis is required
+- Example: "Write a function to calculate factorial recursively"
+`;
 }
+function generateAdvancedBloomGuidance() {
+  return `
+ADVANCED BLOOM'S TAXONOMY & QUESTION TYPE OPTIMIZATION:
 
-// src/ai/flows/question-gen/generate-sequence-question.ts
-init_react_shim();
-
-// src/ai/flows/question-gen/generate-sequence-question-types.ts
-init_react_shim();
-BaseQuestionGenerationClientInputSchema.extend({
-  numberOfItems: z.number().int().min(2).max(10).optional().default(4)
-});
-var AISequenceOutputFieldsSchema = z.object({
-  prompt: z.string().describe("The instructional text for the user, e.g., 'Arrange the steps in the correct order.'"),
-  // Yêu cầu AI cung cấp các item dưới dạng một mảng duy nhất đã được sắp xếp đúng thứ tự
-  // Điều này đơn giản hóa logic và giảm rủi ro
-  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(),
-  topic: z.string().optional(),
-  verifiedCategory: z.string().optional()
-  // Thêm để xác thực
-});
-
-// src/ai/flows/question-gen/generate-sequence-question.ts
-var MAX_RETRY_ATTEMPTS7 = 3;
-var RETRY_DELAY_MS7 = 3e3;
-function buildEnhancedPrompt7(clientInput, attemptNumber) {
-  const { quizContext, language: language3, difficulty, numberOfItems, imageUrl } = clientInput;
-  const category = quizContext?.originalCategory || "the specified technical category";
-  const attemptInfo = attemptNumber > 1 ? `
-## DEBUG INFO - This is attempt #${attemptNumber}
-Previous attempts failed. Ensure the 'itemsInCorrectOrder' array has exactly the required number of items and the JSON is valid.
+**REMEMBERING (Knowledge Recall)**
+- Primary types: true_false, fill_in_the_blanks, matching
+- Secondary types: multiple_choice (simple recall)
+- Focus: Facts, terms, basic concepts, definitions
+- Misconception addressing: Use true_false to clarify common confusions
 
-` : "";
-  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}`,
-    imageContextInstruction,
-    quizContext?.plannedBloomLevel && `**Cognitive Level (Bloom's):** ${quizContext.plannedBloomLevel}`,
-    quizContext?.targetMisconception && `**Target Misconception:** The sequence should clarify this specific process error: "${quizContext.targetMisconception}"`
-  ].filter(Boolean).map((s4) => `- ${s4}`).join("\n");
-  const exampleJson = JSON.stringify({
-    prompt: "Arrange the steps to make a network request in Swift using URLSession.",
-    itemsInCorrectOrder: [
-      "Create a URL object.",
-      "Create a URLSessionDataTask with the URL.",
-      "Start the task by calling its resume() method.",
-      "Handle the completion handler with data, response, and error."
-    ],
-    explanation: "This is the fundamental sequence for a basic data task in URLSession.",
-    points: 10,
-    difficulty: "medium",
-    topic: "Swift Networking",
-    verifiedCategory: category
-  }, null, 2);
-  return `${attemptInfo}You are an expert Question Author for advanced technical education, specializing in: ${category}.
-Your mission is to create a high-quality, technically accurate Sequence Question.
+**UNDERSTANDING (Comprehension)**
+- Primary types: multiple_choice, short_answer, matching
+- Secondary types: multiple_response, sequence
+- Focus: Explanations, interpretations, examples, classifications
+- Best for: "Explain why...", "What does this mean...", "Give an example..."
 
-## Core Rules (Non-negotiable)
-1.  **Category Purity:** The question MUST be exclusively about **${category}**.
-2.  **Unambiguous Order:** The items MUST represent a clear, objective process, timeline, or order with only one correct sequence.
-3.  **Schema Integrity:** The response MUST be ONLY a single, valid JSON object that strictly follows the provided schema.
+**APPLYING (Using Knowledge)**
+- Primary types: numeric, short_answer, sequence, coding
+- Secondary types: multiple_choice, drag_and_drop
+- Focus: Problem-solving, implementing procedures, using methods
+- Best for: Calculations, step-by-step processes, practical applications
 
-## CRITICAL CONTEXT FOR THIS QUESTION
-${contextStrings}
+**ANALYZING (Breaking Down Information)**
+- Primary types: multiple_response, short_answer, sequence, coding
+- Secondary types: drag_and_drop, multiple_choice
+- Focus: Identifying components, relationships, cause-effect
+- Best for: "What are the factors...", "How do these relate...", "Break down..."
 
-## Task: Generate the Question
-Based on all the rules and context above, generate a single Sequence Question.
+**EVALUATING (Making Judgments)**
+- Primary types: short_answer, multiple_response, coding
+- Secondary types: multiple_choice (with justification)
+- Focus: Critiquing, judging, comparing alternatives, decision-making
+- Best for: "Which is better and why...", "Evaluate the approach...", "Critique..."
 
-### Input Parameters
-- **Topic for Question:** ${quizContext?.plannedTopic || "General"}
-- **Language for Text:** ${language3}
-- **Difficulty Level:** ${difficulty}
-- **Number of Items:** Generate an array 'itemsInCorrectOrder' containing exactly ${numberOfItems} items. The array itself MUST be in the correct final sequence.
+**CREATING (Producing New Work)**
+- Primary types: short_answer, coding, sequence
+- Secondary types: drag_and_drop (design tasks)
+- Focus: Designing, planning, producing, constructing
+- Best for: "Design a solution...", "Create a plan...", "Develop a strategy..."
+`;
+}
+function generateDiversityRules() {
+  return `
+ENHANCED DIVERSITY & QUALITY ASSURANCE RULES:
 
-### Required JSON Output Format
-Your response must be ONLY the JSON object, matching this exact structure:
+**Question Type Distribution Strategy:**
+1. Never place more than 3 consecutive questions of the same type
+2. Distribute question types based on their cognitive complexity
+3. For quizzes with 10+ questions, use at least 4 different question types
+4. For quizzes with 20+ questions, use at least 6 different question types
+5. Balance quick-answer types (true_false, multiple_choice) with deeper types (short_answer, coding)
 
-${exampleJson}
+**Intelligent Difficulty Progression:**
+1. Opening (20%): Start with confidence-building questions (Remembering/Understanding)
+2. Building (40%): Gradually increase complexity (Understanding/Applying)
+3. Peak (30%): Most challenging questions (Analyzing/Evaluating/Creating)
+4. Closing (10%): Moderate challenge to end positively
 
-Now, generate the JSON for the requested question.`;
+**Misconception-Driven Planning:**
+- When common misconceptions are provided, prioritize question types that can effectively address them
+- Use true_false for binary misconceptions
+- Use multiple_choice for concept selection misconceptions
+- Use short_answer for complex misconceptions requiring explanation
+
+**Contextual Intelligence:**
+- Programming/Technical topics: Favor coding, numeric, short_answer
+- Process-oriented topics: Favor sequence, short_answer, drag_and_drop
+- Conceptual topics: Favor multiple_choice, multiple_response, true_false
+- Factual topics: Favor fill_in_the_blanks, matching, true_false
+`;
 }
-async function generateSequenceQuestion(clientInput, apiKey) {
-  const ai = new GoogleGenAI({ apiKey });
-  const model = "gemini-2.5-flash";
-  const config3 = {
-    temperature: 0.7,
-    responseMimeType: "application/json",
-    thinkingConfig: {
-      thinkingBudget: 4e3
+async function generateQuizPlan(clientInput, apiKey, imageContexts = []) {
+  const logger = new QuizPlanLogger();
+  try {
+    logger.log("VALIDATION_START", {
+      totalQuestions: clientInput.totalQuestions,
+      availableTypes: clientInput.selectedQuestionTypes,
+      topicCount: clientInput.topics.length,
+      bloomLevelCount: clientInput.bloomLevels.length
+    });
+    const totalTopicRatio = clientInput.topics.reduce((sum, t4) => sum + t4.ratio, 0);
+    if (Math.abs(totalTopicRatio - 100) > 1) {
+      throw new Error(`Total topic ratio must be 100%. Current sum: ${totalTopicRatio.toFixed(1)}%`);
     }
-  };
-  const attemptResults = [];
-  let lastError = null;
-  for (let attempt = 1; attempt <= MAX_RETRY_ATTEMPTS7; attempt++) {
-    const startTime = Date.now();
-    const promptText = buildEnhancedPrompt7(clientInput, attempt);
-    const promptHash = Buffer.from(promptText).toString("base64").slice(0, 10);
-    try {
-      DebugLogger.logPrompt(attempt, promptText, { ...clientInput, attemptNumber: attempt, promptHash });
-      const parts = [{ text: promptText }];
-      if (clientInput.imageUrl) {
-        const mimeType = clientInput.imageUrl.endsWith(".png") ? "image/png" : "image/jpeg";
-        const imagePart = await urlToGenerativePart(clientInput.imageUrl, mimeType);
-        parts.unshift(imagePart);
-      }
-      const contents = [{ role: "user", parts }];
-      const aiResult = await ai.models.generateContent({ model, config: config3, contents });
-      const response = aiResult;
-      const rawText = response.candidates?.[0]?.content?.parts?.[0]?.text || "";
-      const duration = Date.now() - startTime;
-      DebugLogger.logResponse(attempt, rawText);
-      if (!rawText) throw new Error("AI returned an empty response.");
-      const parsedJson = JSON.parse(rawText);
-      DebugLogger.logValidation(attempt, "JSON Parsed Successfully", parsedJson);
-      const aiGeneratedContent = AISequenceOutputFieldsSchema.parse(parsedJson);
-      DebugLogger.logValidation(attempt, "Zod Schema Validated", aiGeneratedContent);
-      if (aiGeneratedContent.itemsInCorrectOrder.length !== clientInput.numberOfItems) {
-        throw new Error(`AI generated ${aiGeneratedContent.itemsInCorrectOrder.length} items, but ${clientInput.numberOfItems} were required.`);
-      }
-      if (clientInput.quizContext?.originalCategory) {
-        const verifiedCategory = aiGeneratedContent.verifiedCategory?.toLowerCase();
-        const requiredCategory = clientInput.quizContext.originalCategory.toLowerCase();
-        if (verifiedCategory && verifiedCategory !== requiredCategory) {
-          throw new Error(`Category mismatch: Required ${requiredCategory}, got ${verifiedCategory}`);
-        }
-      }
-      const finalItems = [];
-      const finalCorrectOrder = [];
-      aiGeneratedContent.itemsInCorrectOrder.forEach((content4) => {
-        const id3 = generateUniqueId("seqi_");
-        finalItems.push({ id: id3, content: content4 });
-        finalCorrectOrder.push(id3);
-      });
-      const completeQuestion = {
-        id: generateUniqueId("seq_ai_"),
-        questionType: "sequence",
-        prompt: aiGeneratedContent.prompt,
-        items: finalItems,
-        correctOrder: finalCorrectOrder,
-        explanation: aiGeneratedContent.explanation,
-        points: aiGeneratedContent.points,
-        topic: aiGeneratedContent.topic || clientInput.quizContext?.originalTopic,
-        difficulty: clientInput.difficulty,
-        contextCode: clientInput.quizContext?.plannedContextId,
-        bloomLevel: clientInput.quizContext?.plannedBloomLevel,
-        learningObjective: clientInput.quizContext?.originalLoId,
-        subject: clientInput.quizContext?.originalSubject,
-        category: clientInput.quizContext?.originalCategory,
-        imageUrl: clientInput.imageUrl
-      };
-      const validatedQuestion = SequenceQuestionZodSchema.parse(completeQuestion);
-      attemptResults.push({ success: true, duration, promptLength: promptText.length, responseLength: rawText.length, promptHash });
-      console.log(`
-\u2705 Sequence generation successful on attempt ${attempt} (${duration}ms)`);
-      if (attempt > 1) DebugLogger.logAttemptSummary(attemptResults);
-      return { question: validatedQuestion };
-    } catch (error) {
-      lastError = error;
-      const duration = Date.now() - startTime;
-      attemptResults.push({ success: false, duration, error: error.message, promptLength: promptText.length, promptHash });
-      const willRetry = attempt < MAX_RETRY_ATTEMPTS7;
-      DebugLogger.logRetryInfo(attempt, error, willRetry);
-      if (willRetry) {
-        console.log(`\u23F3 Retrying in ${RETRY_DELAY_MS7}ms...`);
-        await new Promise((resolve) => setTimeout(resolve, RETRY_DELAY_MS7));
+    const totalBloomRatio = clientInput.bloomLevels.reduce((sum, b2) => sum + b2.ratio, 0);
+    if (Math.abs(totalBloomRatio - 100) > 1) {
+      throw new Error(`Total Bloom level ratio must be 100%. Current sum: ${totalBloomRatio.toFixed(1)}%`);
+    }
+    logger.log("VALIDATION_SUCCESS", {
+      topicRatioSum: totalTopicRatio,
+      bloomRatioSum: totalBloomRatio
+    });
+    const aiStartTime = Date.now();
+    const ai = new GoogleGenAI({
+      apiKey
+    });
+    const model = "gemini-2.5-pro";
+    const config3 = {
+      temperature: 0.8,
+      thinkingConfig: {
+        thinkingBudget: 4096
+      },
+      responseMimeType: "application/json"
+    };
+    logger.log("AI_INITIALIZATION", { model }, Date.now() - aiStartTime);
+    const { language: language3, totalQuestions, numCodingQuestions = 0 } = clientInput;
+    const promptStartTime = Date.now();
+    const topicsDistribution = clientInput.topics.map((t4) => {
+      let topicString = `- Topic Context: "${t4.topic}", LoId: "${t4.originalLoId || "nil"}", Subject: "${t4.originalSubject || "nil"}", Category: "${t4.originalCategory || "nil"}", Topic: "${t4.originalTopic || "nil"}", Ratio: ${t4.ratio}%`;
+      if (t4.commonMisconceptions && t4.commonMisconceptions.length > 0) {
+        topicString += `
+    - Common Misconceptions: [${t4.commonMisconceptions.join(", ")}]`;
       }
+      return topicString;
+    }).join("\n    ");
+    const bloomDistribution = clientInput.bloomLevels.map(
+      (b2) => `- Level: "${b2.level}", Ratio: ${b2.ratio}%`
+    ).join("\n    ");
+    let questionTypesForPrompt = [...clientInput.selectedQuestionTypes];
+    if (numCodingQuestions === 0) {
+      questionTypesForPrompt = questionTypesForPrompt.filter(
+        (type) => type !== "short_answer" && type !== "coding"
+      );
     }
-  }
-  DebugLogger.logAttemptSummary(attemptResults);
-  const errorMessage = `Failed to generate Sequence question after ${MAX_RETRY_ATTEMPTS7} attempts. Last error: ${lastError?.message}`;
-  console.error("\n\u274C Final Result: FAILED");
-  console.error(errorMessage);
-  return { error: errorMessage };
-}
+    const allowedQuestionTypes = questionTypesForPrompt.map((t4) => `'${t4}'`).join(", ");
+    const codingRequirement = numCodingQuestions > 0 ? `
+**CRITICAL CODING REQUIREMENT**: Exactly ${numCodingQuestions} questions in the plan MUST be of type 'coding'. These should typically be at 'applying' or higher Bloom levels and focus on implementation, debugging, or algorithm design.` : "";
+    const imageContextSection = imageContexts && imageContexts.length > 0 ? `
+## AVAILABLE IMAGE CONTEXT LIBRARY
+You have access to a library of pre-described images. When planning a question, if its subject, category, and topic match an image in this library AND the image's description is relevant to the planned question's topic, you MUST include the corresponding \`imageId\` in your output. Otherwise, leave the \`imageId\` field null or omit it.
+
+\`\`\`json
+${JSON.stringify(imageContexts.map((img) => ({ imageId: img.id, subject: img.subject, category: img.category, topic: img.topic, description: img.detailedDescription })), null, 2)}
+\`\`\`
+` : "";
+    const enhancedPromptText = `You are an elite educational assessment architect with expertise in cognitive science and adaptive learning. Your mission is to create a strategically optimized quiz plan that maximizes learning effectiveness.
 
-// src/ai/flows/question-gen/generate-matching-question.ts
-init_react_shim();
+${generateQuestionTypeSelectionGuidance()}
 
-// src/ai/flows/question-gen/generate-matching-question-types.ts
-init_react_shim();
-BaseQuestionGenerationClientInputSchema.extend({
-  numberOfPairs: z.number().int().min(2).max(8).optional().default(4),
-  shuffleOptions: z.boolean().optional().default(true)
-});
-var AIMatchingOutputFieldsSchema = z.object({
-  prompt: z.string().describe("The instructional text for the user, e.g., 'Match the concept to its definition.'"),
-  correctPairs: z.array(z.object({
-    promptText: z.string().min(1).describe("The text for the left-hand side item (the prompt)."),
-    optionText: z.string().min(1).describe("The text for the right-hand side item (the matching option).")
-  })).min(2),
-  explanation: z.string().optional(),
-  points: z.number().optional().default(10),
-  difficulty: z.enum(["easy", "medium", "hard"]).optional(),
-  topic: z.string().optional(),
-  verifiedCategory: z.string().optional()
-  // Thêm để xác thực
-});
+${generateAdvancedBloomGuidance()}
 
-// src/ai/flows/question-gen/generate-matching-question.ts
-var MAX_RETRY_ATTEMPTS8 = 3;
-var RETRY_DELAY_MS8 = 3e3;
-function buildEnhancedPrompt8(clientInput, attemptNumber) {
-  const { quizContext, language: language3, difficulty, numberOfPairs, imageUrl } = clientInput;
-  const category = quizContext?.originalCategory || "the specified technical category";
-  const attemptInfo = attemptNumber > 1 ? `
-## DEBUG INFO - This is attempt #${attemptNumber}
-Previous attempts failed. Please ensure the 'correctPairs' array has exactly the required number of items and the JSON is valid.
+${generateDiversityRules()}
 
-` : "";
-  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}`,
-    imageContextInstruction,
-    quizContext?.plannedBloomLevel && `**Cognitive Level (Bloom's):** ${quizContext.plannedBloomLevel}`,
-    quizContext?.targetMisconception && `**Target Misconception:** Design a pair that specifically tests this confusion: "${quizContext.targetMisconception}"`
-  ].filter(Boolean).map((s4) => `- ${s4}`).join("\n");
-  const exampleJson = JSON.stringify({
-    prompt: "Match each Swift collection type to its primary characteristic.",
-    correctPairs: [
-      { "promptText": "Array", "optionText": "An ordered, random-access collection." },
-      { "promptText": "Set", "optionText": "An unordered collection of unique elements." },
-      { "promptText": "Dictionary", "optionText": "An unordered collection of key-value associations." }
-    ],
-    explanation: "These are the fundamental characteristics of Swift's main collection types.",
-    points: 10,
-    difficulty: "easy",
-    topic: "Swift Collection Types",
-    verifiedCategory: category
-  }, null, 2);
-  return `${attemptInfo}You are an expert Question Author for advanced technical education, specializing in: ${category}.
-Your mission is to create a high-quality, technically accurate Matching Question.
+## COMPREHENSIVE QUIZ REQUIREMENTS:
 
-## Core Rules (Non-negotiable)
-1.  **Category Purity:** The question MUST be exclusively about **${category}**.
-2.  **Logical Pairs:** The items to be matched must have a clear, one-to-one relationship.
-3.  **Schema Integrity:** The response MUST be ONLY a single, valid JSON object that strictly follows the provided schema.
+**Target Language**: ${language3}
+**Total Questions**: ${totalQuestions}${codingRequirement}
 
-## CRITICAL CONTEXT FOR THIS QUESTION
-${contextStrings}
+**Topic Distribution & Learning Context** (follow precisely):
+    ${topicsDistribution}
 
-## Task: Generate the Question
-Based on all the rules and context above, generate a single Matching Question.
+**Cognitive Complexity Distribution** (follow precisely):
+    ${bloomDistribution}
 
-### Input Parameters
-- **Topic for Question:** ${quizContext?.plannedTopic || "General"}
-- **Language for Text:** ${language3}
-- **Difficulty Level:** ${difficulty}
-- **Number of Pairs:** Generate exactly ${numberOfPairs} correct pairs in the 'correctPairs' array.
+**Available Question Arsenal**: ${allowedQuestionTypes}
 
-### Required JSON Output Format
-Your response must be ONLY the JSON object, matching this exact structure:
+**Image Resources**: ${imageContextSection} 
+
+## STRATEGIC PLANNING METHODOLOGY:
+
+1. **Misconception Analysis**: If common misconceptions are provided, design questions specifically to address and correct them
+2. **Question Type Intelligence**: Select question types based on the cognitive demands and content nature
+3. **Difficulty Orchestration**: Create a learning journey that builds confidence while challenging appropriately
+4. **Diversity Optimization**: Ensure variety prevents monotony and maintains engagement
+5. **Context Sensitivity**: Match question types to topic characteristics (technical, conceptual, procedural)
+6. **Image Context Integration**: Intelligently associate questions with relevant images from the provided library to enhance contextual understanding.
+
+## ENHANCED OUTPUT FORMAT:
+
+Return ONLY a JSON object with this EXACT structure:
+
+\`\`\`json
+{
+  "quizPlan": [
+   {
+      "plannedTopic": "Specific, assessable topic derived from provided context",
+      "plannedQuestionType": "question_type_from_allowed_list",
+      "plannedBloomLevel": "bloom_level_from_requirements",
+      "plannedContextId": "THEO_ABS",
+      "imageId": "imgctx_12345abcde", // or null
+      "targetMisconception": "Specific misconception this question addresses (or 'none' if not applicable)",
+      "difficultyReason": "Strategic explanation of difficulty choice and placement",
+      "topicSpecificity": "broad|focused|specific",
+      "originalLoId": "corresponding_LoId_from_input",
+      "originalSubject": "corresponding_Subject_from_input",
+      "originalCategory": "corresponding_Category_from_input",
+      "originalTopic": "corresponding_Topic_from_input"
+    }
+  ],
+  "diversityMetrics": {
+    "questionTypeDistribution": {"type1": count1, "type2": count2},
+    "bloomLevelDistribution": {"level1": count1, "level2": count2},
+    "maxConsecutiveSameType": number,
+    "difficultyProgression": "description of how difficulty progresses",
+    "misconceptionCoverage": number_of_misconceptions_addressed
+  },
+  "planningStrategy": {
+    "overallApproach": "Brief description of the strategic approach taken",
+    "keyDecisions": ["Major decision 1", "Major decision 2", "Major decision 3"]
+  }
+}
+\`\`\`
+
+Execute this plan with pedagogical precision. The quiz should feel like a carefully crafted learning journey that challenges and educates simultaneously.`;
+    logger.log("PROMPT_PREPARATION", {
+      promptLength: enhancedPromptText.length,
+      topicCount: clientInput.topics.length,
+      misconceptionCount: clientInput.topics.reduce((sum, t4) => sum + (t4.commonMisconceptions?.length || 0), 0)
+    }, Date.now() - promptStartTime);
+    const generationStartTime = Date.now();
+    const contents = [
+      {
+        role: "user",
+        parts: [
+          {
+            text: enhancedPromptText
+          }
+        ]
+      }
+    ];
+    const aiResult = await ai.models.generateContent({
+      model,
+      config: config3,
+      contents
+    });
+    const response = aiResult;
+    const generationDuration = Date.now() - generationStartTime;
+    logger.log("AI_GENERATION", {
+      responseLength: response.candidates?.[0]?.content?.parts?.[0]?.text?.length || 0,
+      duration: generationDuration
+    }, generationDuration);
+    const processingStartTime = Date.now();
+    const rawText = response.candidates?.[0]?.content?.parts?.[0]?.text || "";
+    let jsonText = rawText;
+    if (!rawText.trim().startsWith("{") && !rawText.trim().startsWith("[")) {
+      jsonText = extractJsonFromMarkdown(rawText);
+    }
+    logger.log("JSON_EXTRACTION", {
+      rawTextLength: rawText.length,
+      extractedJsonLength: jsonText.length
+    });
+    const aiGeneratedContent = GenerateQuizPlanOutputSchema.parse(JSON.parse(jsonText));
+    logger.log("SCHEMA_VALIDATION", { success: true }, Date.now() - processingStartTime);
+    const validationStartTime = Date.now();
+    if (aiGeneratedContent.quizPlan.length !== clientInput.totalQuestions) {
+      throw new Error(`AI planned for ${aiGeneratedContent.quizPlan.length} questions, but ${clientInput.totalQuestions} were requested.`);
+    }
+    const invalidTypes = [];
+    aiGeneratedContent.quizPlan.forEach((item, index3) => {
+      if (!clientInput.selectedQuestionTypes.includes(item.plannedQuestionType)) {
+        invalidTypes.push(`Question ${index3 + 1}: '${item.plannedQuestionType}'`);
+      }
+    });
+    if (invalidTypes.length > 0) {
+      throw new Error(`Invalid question types found: ${invalidTypes.join(", ")}`);
+    }
+    const codingQuestions = aiGeneratedContent.quizPlan.filter((q2) => q2.plannedQuestionType === "coding");
+    if (numCodingQuestions > 0 && codingQuestions.length !== numCodingQuestions) {
+      throw new Error(`Expected ${numCodingQuestions} coding questions, but got ${codingQuestions.length}`);
+    }
+    const diversityAnalysis = validateConsecutiveTypes(aiGeneratedContent.quizPlan);
+    logger.log("VALIDATION_COMPLETE", {
+      questionCount: aiGeneratedContent.quizPlan.length,
+      codingQuestionCount: codingQuestions.length,
+      maxConsecutiveType: diversityAnalysis.maxConsecutive,
+      questionTypeDistribution: aiGeneratedContent.diversityMetrics?.questionTypeDistribution || {}
+    }, Date.now() - validationStartTime);
+    const finalResult = {
+      ...aiGeneratedContent,
+      logs: logger.getLogs()
+    };
+    logger.log("GENERATION_COMPLETE", {
+      totalDuration: logger.getTotalDuration(),
+      success: true,
+      finalQuestionCount: finalResult.quizPlan.length
+    }, logger.getTotalDuration());
+    console.log("\n=== QUIZ PLAN GENERATION SUMMARY ===");
+    console.log(`\u2705 Successfully generated ${finalResult.quizPlan.length} questions`);
+    console.log(`\u23F1\uFE0F Total generation time: ${logger.getTotalDuration()}ms`);
+    console.log(`\u{1F3AF} Question types: ${Object.keys(finalResult.diversityMetrics?.questionTypeDistribution || {}).join(", ")}`);
+    console.log(`\u{1F9E0} Bloom levels: ${Object.keys(finalResult.diversityMetrics?.bloomLevelDistribution || {}).join(", ")}`);
+    if (numCodingQuestions > 0) {
+      console.log(`\u{1F4BB} Coding questions: ${codingQuestions.length}/${numCodingQuestions} required`);
+    }
+    console.log(JSON.stringify(finalResult));
+    console.log("=====================================\n");
+    return finalResult;
+  } catch (error) {
+    logger.log("ERROR", {
+      message: error.message,
+      stack: error.stack,
+      totalDuration: logger.getTotalDuration()
+    });
+    console.error("\u274C Quiz Plan Generation Failed:", error.message);
+    console.error("\u{1F4CB} Full logs available in returned object");
+    throw new Error(`Failed to generate Quiz Plan: ${error.message}`);
+  }
+}
+function validateConsecutiveTypes(quizPlan) {
+  let maxConsecutive = 1;
+  let maxType = quizPlan[0]?.plannedQuestionType || "";
+  let maxStartIndex = 0;
+  let currentConsecutive = 1;
+  let currentType = quizPlan[0]?.plannedQuestionType || "";
+  let currentStartIndex = 0;
+  for (let i2 = 1; i2 < quizPlan.length; i2++) {
+    if (quizPlan[i2].plannedQuestionType === currentType) {
+      currentConsecutive++;
+    } else {
+      if (currentConsecutive > maxConsecutive) {
+        maxConsecutive = currentConsecutive;
+        maxType = currentType;
+        maxStartIndex = currentStartIndex;
+      }
+      currentConsecutive = 1;
+      currentType = quizPlan[i2].plannedQuestionType;
+      currentStartIndex = i2;
+    }
+  }
+  if (currentConsecutive > maxConsecutive) {
+    maxConsecutive = currentConsecutive;
+    maxType = currentType;
+    maxStartIndex = currentStartIndex;
+  }
+  return {
+    maxConsecutive,
+    type: maxType,
+    startIndex: maxStartIndex
+  };
+}
 
-${exampleJson}
+// src/ai/flows/generate-questions-from-quiz-plan.ts
+init_react_shim();
 
-Now, generate the JSON for the requested question.`;
-}
-async function generateMatchingQuestion(clientInput, apiKey) {
-  const ai = new GoogleGenAI({ apiKey });
-  const model = "gemini-2.5-flash";
-  const config3 = {
-    temperature: 0.8,
-    responseMimeType: "application/json",
-    thinkingConfig: {
-      thinkingBudget: 4e3
+// src/services/TopicDataService.ts
+init_react_shim();
+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;
+      const serializedData = JSON.stringify(data);
+      localStorage.setItem(this.STORAGE_KEY, serializedData);
+    } catch (error) {
+      console.error("Error saving learning objectives to Local Storage:", error);
     }
-  };
-  const attemptResults = [];
-  let lastError = null;
-  for (let attempt = 1; attempt <= MAX_RETRY_ATTEMPTS8; attempt++) {
-    const startTime = Date.now();
-    const promptText = buildEnhancedPrompt8(clientInput, attempt);
-    const promptHash = Buffer.from(promptText).toString("base64").slice(0, 10);
+  }
+  /**
+   * 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]));
+    newData.forEach((newLo) => {
+      loMap.set(newLo.loId, 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 {
-      DebugLogger.logPrompt(attempt, promptText, { ...clientInput, attemptNumber: attempt, promptHash });
-      const parts = [{ text: promptText }];
-      if (clientInput.imageUrl) {
-        const mimeType = clientInput.imageUrl.endsWith(".png") ? "image/png" : "image/jpeg";
-        const imagePart = await urlToGenerativePart(clientInput.imageUrl, mimeType);
-        parts.unshift(imagePart);
-      }
-      const contents = [{ role: "user", parts }];
-      const aiResult = await ai.models.generateContent({ model, config: config3, contents });
-      const response = aiResult;
-      const rawText = response.candidates?.[0]?.content?.parts?.[0]?.text || "";
-      const duration = Date.now() - startTime;
-      DebugLogger.logResponse(attempt, rawText);
-      if (!rawText) throw new Error("AI returned an empty response.");
-      const parsedJson = JSON.parse(rawText);
-      DebugLogger.logValidation(attempt, "JSON Parsed Successfully", parsedJson);
-      const aiGeneratedContent = AIMatchingOutputFieldsSchema.parse(parsedJson);
-      DebugLogger.logValidation(attempt, "Zod Schema Validated", aiGeneratedContent);
-      if (aiGeneratedContent.correctPairs.length !== clientInput.numberOfPairs) {
-        throw new Error(`AI generated ${aiGeneratedContent.correctPairs.length} pairs, but ${clientInput.numberOfPairs} were required.`);
+      if (typeof window === "undefined") return [];
+      const storedData = localStorage.getItem(this.STORAGE_KEY);
+      return storedData ? JSON.parse(storedData) : [];
+    } catch (error) {
+      console.error("Error retrieving learning objectives from Local Storage:", error);
+      this.clearData();
+      return [];
+    }
+  }
+  /**
+   * Removes all learning objective data from Local Storage.
+   */
+  static clearData() {
+    try {
+      if (typeof window === "undefined") return;
+      localStorage.removeItem(this.STORAGE_KEY);
+    } catch (error) {
+      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) {
+      return { data: [], errors: ["File is empty or contains only a header."] };
+    }
+    const headerLine = lines.shift();
+    const headers = headerLine.split("	").map((h3) => h3.trim());
+    if (headers.length !== this.EXPECTED_HEADERS.length || !this.EXPECTED_HEADERS.every((h3, i2) => h3 === headers[i2])) {
+      const errorMsg = `Invalid TSV header. Expected: "${this.EXPECTED_HEADERS.join("	")}". Received: "${headers.join("	")}"`;
+      return { data: [], errors: [errorMsg] };
+    }
+    const data = [];
+    const errors2 = [];
+    lines.forEach((line, index3) => {
+      const values = line.split("	").map((v) => v.trim());
+      if (values.length !== this.EXPECTED_HEADERS.length) {
+        errors2.push(`Line ${index3 + 2}: Incorrect number of columns. Expected ${this.EXPECTED_HEADERS.length}, but got ${values.length}.`);
+        return;
       }
-      if (clientInput.quizContext?.originalCategory) {
-        const verifiedCategory = aiGeneratedContent.verifiedCategory?.toLowerCase();
-        const requiredCategory = clientInput.quizContext.originalCategory.toLowerCase();
-        if (verifiedCategory && verifiedCategory !== requiredCategory) {
-          throw new Error(`Category mismatch: Required ${requiredCategory}, got ${verifiedCategory}`);
-        }
+      const [
+        loId,
+        loDescription,
+        subject,
+        category,
+        topic,
+        keywordsStr,
+        grade,
+        stemElementsStr,
+        bloomLevelsStr
+      ] = values;
+      if (!loId || !subject || !category || !topic) {
+        errors2.push(`Line ${index3 + 2}: Missing required fields (LO ID, Subject, Category, or Topic).`);
+        return;
       }
-      const finalPrompts = [];
-      const finalOptions = [];
-      const finalCorrectAnswerMap = [];
-      aiGeneratedContent.correctPairs.forEach((pair2) => {
-        const promptId = generateUniqueId("m_p_");
-        const optionId = generateUniqueId("m_o_");
-        finalPrompts.push({ id: promptId, content: pair2.promptText });
-        finalOptions.push({ id: optionId, content: pair2.optionText });
-        finalCorrectAnswerMap.push({ promptId, optionId });
-      });
-      const completeQuestion = {
-        id: generateUniqueId("match_ai_"),
-        questionType: "matching",
-        prompt: aiGeneratedContent.prompt,
-        prompts: finalPrompts,
-        options: finalOptions,
-        correctAnswerMap: finalCorrectAnswerMap,
-        shuffleOptions: clientInput.shuffleOptions,
-        explanation: aiGeneratedContent.explanation,
-        points: aiGeneratedContent.points,
-        topic: aiGeneratedContent.topic || clientInput.quizContext?.originalTopic,
-        difficulty: clientInput.difficulty,
-        contextCode: clientInput.quizContext?.plannedContextId,
-        bloomLevel: clientInput.quizContext?.plannedBloomLevel,
-        learningObjective: clientInput.quizContext?.originalLoId,
-        subject: clientInput.quizContext?.originalSubject,
-        category: clientInput.quizContext?.originalCategory,
-        imageUrl: clientInput.imageUrl
+      const learningObjective = {
+        loId,
+        loDescription,
+        subject,
+        category,
+        topic,
+        keywords: keywordsStr.split(",").map((k3) => k3.trim()).filter(Boolean),
+        grade,
+        stemElements: stemElementsStr.split(",").map((s4) => s4.trim()).filter(Boolean),
+        bloomLevelsGuideline: bloomLevelsStr.split(",").map((b2) => b2.trim()).filter(Boolean)
       };
-      const validatedQuestion = MatchingQuestionZodSchema.parse(completeQuestion);
-      attemptResults.push({ success: true, duration, promptLength: promptText.length, responseLength: rawText.length, promptHash });
-      console.log(`
-\u2705 Matching generation successful on attempt ${attempt} (${duration}ms)`);
-      if (attempt > 1) DebugLogger.logAttemptSummary(attemptResults);
-      return { question: validatedQuestion };
-    } catch (error) {
-      lastError = error;
-      const duration = Date.now() - startTime;
-      attemptResults.push({ success: false, duration, error: error.message, promptLength: promptText.length, promptHash });
-      const willRetry = attempt < MAX_RETRY_ATTEMPTS8;
-      DebugLogger.logRetryInfo(attempt, error, willRetry);
-      if (willRetry) {
-        console.log(`\u23F3 Retrying in ${RETRY_DELAY_MS8}ms...`);
-        await new Promise((resolve) => setTimeout(resolve, RETRY_DELAY_MS8));
-      }
-    }
+      data.push(learningObjective);
+    });
+    return { data, errors: errors2 };
   }
-  DebugLogger.logAttemptSummary(attemptResults);
-  const errorMessage = `Failed to generate Matching question after ${MAX_RETRY_ATTEMPTS8} attempts. Last error: ${lastError?.message}`;
-  console.error("\n\u274C Final Result: FAILED");
-  console.error(errorMessage);
-  return { error: errorMessage };
-}
+  /**
+   * 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);
+    return data.filter((item) => topicSet.has(item.topic));
+  }
+};
+TopicDataService.STORAGE_KEY = "interactive_quiz_kit_learning_objectives";
+TopicDataService.EXPECTED_HEADERS = [
+  "LO ID",
+  "LO Description",
+  "Subject",
+  "Category",
+  "Topic",
+  "Keywords",
+  "Grade",
+  "STEM Element(s)",
+  "Bloom\u2019s Level(s) Guideline"
+];
 
 // src/ai/flows/question-gen/generate-coding-question.ts
 init_react_shim();