@tinyweb_dev/oe-exam-sdk 0.2.3 → 0.2.5

package/dist/components/results/renderers/ReviewChooseBestAnswerRenderer.js

@@ -1,16 +1,11 @@
 'use client';
-import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { Check, X, ZoomIn } from 'lucide-react';
-import { useState } from 'react';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Check, X } from 'lucide-react';
 import { ResolvedImage } from '../../../components/common/ResolvedImage';
 import CambridgeYlePartBanner from '../../../components/themes/cambridge-yle/CambridgeYlePartBanner';
 import CambridgeYleInstructionBanner from '../../../components/themes/cambridge-yle/CambridgeYleInstructionBanner';
 import CambridgeYleAudioPlayer from '../../../components/themes/cambridge-yle/CambridgeYleAudioPlayer';
-// Image with zoom functionality
-function QuestionImage({ imageUrl }) {
-    const [isZoomed, setIsZoomed] = useState(false);
-    return (_jsxs(_Fragment, { children: [_jsxs("div", { className: "relative flex items-center justify-center", children: [_jsx(ResolvedImage, { src: imageUrl, alt: "Question illustration", className: "max-h-[250px] cursor-pointer rounded-lg object-contain shadow-md", onClick: () => setIsZoomed(true) }), _jsx("button", { type: "button", onClick: () => setIsZoomed(true), className: "absolute right-2 top-2 rounded-full bg-white/80 p-1.5 shadow-md hover:bg-white", "aria-label": "Zoom image", children: _jsx(ZoomIn, { className: "h-4 w-4 text-gray-600" }) })] }), isZoomed && (_jsx("div", { className: "fixed inset-0 z-50 flex items-center justify-center bg-black/70", onClick: () => setIsZoomed(false), children: _jsx(ResolvedImage, { src: imageUrl, alt: "Question illustration (zoomed)", className: "max-h-[90vh] max-w-[90vw] rounded-lg object-contain", showLoadingState: false }) }))] }));
-}
+import { ChooseBestAnswerImages, getChooseBestAnswerOptionImageSrc } from '../../../components/exams/take/components/question-renderers/ChooseBestAnswerImages';
 // Single Question Component for Review Mode
 function ReviewQuestionItem({ question, selectedOptionIds, isCorrect, correctOptionIds, }) {
     const hasStudentAnswered = selectedOptionIds.length > 0;
@@ -48,7 +43,7 @@ function ReviewQuestionItem({ question, selectedOptionIds, isCorrect, correctOpt
         }
         return _jsx("div", { className: `flex h-5 w-5 items-center justify-center border-2 border-gray-300 bg-white ${shapeClass}` });
     };
-    return (_jsxs("div", { className: "mb-4", children: [_jsxs("p", { className: "mb-2 text-lg font-bold text-gray-900", children: [question.questionNumber, ". ", question.questionText] }), isMultipleAnswers && (_jsx("p", { className: "mb-3 pl-2 text-sm font-medium text-blue-600", children: "Ch\u1ECDn nhi\u1EC1u \u0111\u00E1p \u00E1n" })), question.imageUrl && (_jsx("div", { className: "mb-3", children: _jsx(QuestionImage, { imageUrl: question.imageUrl }) })), isImageOptions ? (_jsx("div", { className: "grid gap-3 px-2", style: { gridTemplateColumns: `repeat(${question.options.length}, minmax(0, 1fr))` }, children: question.options.map((option) => (_jsxs("div", { className: `relative flex flex-col items-center gap-1 rounded-lg border-2 p-2 cursor-default ${getOptionStyle(option.id)}`, children: [_jsx("span", { className: "text-xs font-medium text-gray-600", children: option.label }), _jsx(ResolvedImage, { src: option.text, alt: `Option ${option.label}`, className: "h-28 w-28 rounded object-contain" }), renderIndicator(option.id)] }, option.id))) })) : (
+    return (_jsxs("div", { className: "mb-4", children: [_jsxs("p", { className: "mb-2 text-lg font-bold text-gray-900", children: [question.questionNumber, ". ", question.questionText] }), isMultipleAnswers && (_jsx("p", { className: "mb-3 pl-2 text-sm font-medium text-blue-600", children: "Ch\u1ECDn nhi\u1EC1u \u0111\u00E1p \u00E1n" })), _jsx(ChooseBestAnswerImages, { imageUrl: question.imageUrl, className: "mb-3" }), isImageOptions ? (_jsx("div", { className: "grid gap-3 px-2", style: { gridTemplateColumns: `repeat(${question.options.length}, minmax(0, 1fr))` }, children: question.options.map((option) => (_jsxs("div", { className: `relative flex flex-col items-center gap-1 rounded-lg border-2 p-2 cursor-default ${getOptionStyle(option.id)}`, children: [_jsx("span", { className: "text-xs font-medium text-gray-600", children: option.label }), _jsx(ResolvedImage, { src: getChooseBestAnswerOptionImageSrc(option), alt: `Option ${option.label}`, className: "h-28 w-28 rounded object-contain" }), renderIndicator(option.id)] }, option.id))) })) : (
             /* Options — text variant */
             _jsx("div", { className: "flex flex-col gap-2 pl-2", children: question.options.map((option) => (_jsxs("div", { className: `flex items-center gap-3 rounded-lg border-2 px-3 py-2 cursor-default ${getOptionStyle(option.id)}`, children: [_jsxs("span", { className: "text-sm font-medium text-gray-600", children: [option.label, "."] }), _jsx("span", { className: "flex-1 text-sm text-gray-700", children: option.text }), renderIndicator(option.id)] }, option.id))) }))] }));
 }

package/dist/components/results/renderers/review-question-body-movers.js

@@ -4,8 +4,8 @@ import { jsx as _jsx } from "react/jsx-runtime";
  * Movers fallback review cases (isReviewMode=true).
  * Source: oe-exam-fe ReviewQuestionRenderer.tsx
  */
-import { MoversAnswerTheQuestionRenderer, MoversFillWordHintRenderer, MoversGridFillRenderer, MoversLabelThePictureRenderer, MoversMatchByWritingAnswerRenderer, MoversPictureChooseRenderer, MoversPictureFillBlankChooseRenderer, MoversReadingPassageRenderer, MoversTrueFalseRenderer, MoversCrossOutWordGroupRenderer, MoversWordFillParagraphRenderer, MoversWordFillStructuredFormRenderer, MoversWordOrderingRenderer, MoversWriteSentencesRenderer, MoversWritingRenderer, MoversCrosswordPuzzleRenderer, } from '../../../components/exams/take/components/question-renderers';
-import { transformAnswerTheQuestion, transformFillWordHint, transformGridFill, transformLabelPicture, transformMatchByWritingAnswer, transformPictureChoose, transformPictureFillBlankChoose, transformReadingPassage, transformTrueFalse, transformWordFillParagraph, transformWordFillStructuredForm, transformWordOrdering, transformWriteSentences, transformWriteShortLetter, transformCrosswordPuzzle, } from '../../../components/exams/take/utils/question-transformers';
+import { MoversAnswerTheQuestionRenderer, MoversFillWordHintRenderer, MoversGridFillRenderer, MoversLabelThePictureRenderer, MoversMatchByWritingAnswerRenderer, MoversMatchWordToPictureRenderer, MoversPictureChooseRenderer, MoversPictureFillBlankChooseRenderer, MoversReadingPassageRenderer, MoversTrueFalseRenderer, MoversTrueFalseCorrectGroupRenderer, MoversCrossOutWordGroupRenderer, MoversWordFillParagraphRenderer, MoversWordFillStructuredFormRenderer, MoversWordOrderingRenderer, MoversWriteSentencesRenderer, MoversWritingRenderer, MoversCrosswordPuzzleRenderer, } from '../../../components/exams/take/components/question-renderers';
+import { transformAnswerTheQuestion, transformFillWordHint, transformGridFill, transformLabelPicture, transformMatchByWritingAnswer, transformMatchWordToPicture, transformPictureChoose, transformPictureFillBlankChoose, transformReadingPassage, transformTrueFalse, transformTrueFalseCorrectGroup, transformWordFillParagraph, transformWordFillStructuredForm, transformWordOrdering, transformWriteSentences, transformWriteShortLetter, transformCrosswordPuzzle, } from '../../../components/exams/take/utils/question-transformers';
 import { normalizeCrossOutWordGroupAnswer, transformCrossOutWordGroup, } from '../../../components/exams/take/utils/cross-out-word-group.transformer';
 function asApiQuestions(questions) {
     return questions;
@@ -26,7 +26,7 @@ export function renderMoversReviewBody(ctx) {
             const data = transformWriteShortLetter(firstQuestion);
             const writingAnswer = answers[firstQuestion.id] || '';
             const gradingInfo = essayGradingMap[firstQuestion.id];
-            return (_jsx(MoversWritingRenderer, { partNumber: partNo, partName: part.name, prompt: data.prompt, requirements: data.requirements, minWords: data.minWords, maxWords: data.maxWords, answer: writingAnswer, onAnswerChange: handleAnswerChange, isReviewMode: true, teacherScore: gradingInfo?.score, maxScore: gradingInfo?.maxScore, teacherFeedback: gradingInfo?.teacherFeedback, writingAssessment: gradingInfo?.writingAssessment }));
+            return (_jsx(MoversWritingRenderer, { partNumber: partNo, partName: part.name, prompt: data.prompt, requirements: data.requirements, minWords: data.minWords, maxWords: data.maxWords, answer: writingAnswer, onAnswerChange: handleAnswerChange, isReviewMode: true, guideImages: data.guideImages, passage: data.passage, teacherScore: gradingInfo?.score, maxScore: gradingInfo?.maxScore, teacherFeedback: gradingInfo?.teacherFeedback, writingAssessment: gradingInfo?.writingAssessment }));
         }
         case 'LOOK_PICTURE_CHOOSE_CORRECT_ANSWER': {
             const data = transformPictureChoose(apiQuestions);
@@ -110,6 +110,38 @@ export function renderMoversReviewBody(ctx) {
             });
             return (_jsx(MoversCrossOutWordGroupRenderer, { partNumber: partNo, partName: part.name, instruction: part.instructions || data.instruction, questionCount: questionCount, questions: data.questions, answers: answers, onAnswerChange: handleAnswerChange, isReviewMode: true, correctAnswerMap: correctAnswerMap }));
         }
+        case 'TRUE_FALSE_CORRECT_GROUP': {
+            const data = transformTrueFalseCorrectGroup(apiQuestions);
+            const correctAnswerMap = {};
+            data.questions.forEach((question) => {
+                if (question.exampleCorrectAnswer) {
+                    correctAnswerMap[question.id] = question.exampleCorrectAnswer;
+                }
+            });
+            const parent = apiQuestions[0];
+            const rawCorrect = parent?.id ? rawCorrectAnswerMap[parent.id] : undefined;
+            const rawCorrectRecord = rawCorrect && typeof rawCorrect === 'object' && !Array.isArray(rawCorrect)
+                ? rawCorrect
+                : undefined;
+            const correctArr = Array.isArray(rawCorrectRecord?.answer)
+                ? rawCorrectRecord.answer
+                : Array.isArray(parent?.correct_answer?.answer)
+                    ? parent.correct_answer.answer
+                    : [];
+            data.questions.forEach((question, index) => {
+                if (!question.isExample && correctArr[index] && typeof correctArr[index] === 'object') {
+                    const obj = correctArr[index];
+                    const isTrue = obj.isTrue === true ? true : obj.isTrue === false ? false : null;
+                    if (isTrue !== null) {
+                        correctAnswerMap[question.id] = {
+                            isTrue,
+                            correction: typeof obj.correction === 'string' ? obj.correction : '',
+                        };
+                    }
+                }
+            });
+            return (_jsx(MoversTrueFalseCorrectGroupRenderer, { partNumber: partNo, partName: part.name, instruction: part.instructions || data.instruction, questionCount: questionCount, questions: data.questions, answers: answers, onAnswerChange: handleAnswerChange, isReviewMode: true, correctAnswerMap: correctAnswerMap }));
+        }
         case 'TRUE_FALSE': {
             const data = transformTrueFalse(apiQuestions);
             return (_jsx(MoversTrueFalseRenderer, { partNumber: partNo, partName: part.name, instruction: part.instructions || data.instruction, questionCount: questionCount, imageUrl: data.imageUrl, questions: data.questions, answers: answers, onAnswerChange: handleAnswerChange, isReviewMode: true, correctAnswerTextMap: correctAnswerTextMap }));
@@ -118,6 +150,10 @@ export function renderMoversReviewBody(ctx) {
             const data = transformMatchByWritingAnswer(apiQuestions);
             return (_jsx(MoversMatchByWritingAnswerRenderer, { partNumber: partNo, partName: part.name, instruction: part.instructions || data.instruction, questionCount: questionCount, audioUrl: part.audioUrl, options: data.options, questions: data.questions, answers: answers, onAnswerChange: handleAnswerChange, isReviewMode: true, viewMode: data.viewMode, groupImageUrl: data.groupImageUrl, correctAnswerTextMap: correctAnswerTextMap, isCorrectMap: isCorrectMap }));
         }
+        case 'MATCH_WORD_TO_PICTURE': {
+            const data = transformMatchWordToPicture(apiQuestions);
+            return (_jsx(MoversMatchWordToPictureRenderer, { partNumber: partNo, partName: part.name, instruction: part.instructions || data.instruction, questionCount: questionCount, wordBank: data.wordBank, questions: data.questions, answers: answers, onAnswerChange: handleAnswerChange, isReviewMode: true, correctAnswerTextMap: correctAnswerTextMap, isCorrectMap: isCorrectMap }));
+        }
         case 'WORD_ORDERING': {
             const data = transformWordOrdering(apiQuestions);
             return (_jsx(MoversWordOrderingRenderer, { partNumber: partNo, partName: part.name, instruction: part.instructions || data.instruction, questionCount: questionCount, questions: data.questions, answers: answers, onAnswerChange: handleAnswerChange, isReviewMode: true, rawCorrectAnswerMap: rawCorrectAnswerMap, isCorrectMap: isCorrectMap }));

package/dist/components/results/review-data.js

@@ -8,6 +8,7 @@ const FLATTENED_ANSWER_TYPES = new Set([
     'CHOOSE_THE_CORRECT_ANSWER_GROUP',
     'ANSWER_THE_QUESTION_GROUP',
     'CROSS_OUT_WORD_GROUP',
+    'TRUE_FALSE_CORRECT_GROUP',
 ]);
 export function transformResultAnswersForReview(answers, templateParts = []) {
     const groups = groupAnswers(answers);
@@ -183,6 +184,27 @@ function transformStudentAnswer(questionId, questionType, value) {
             normalizeCrossOutWordGroupAnswer(item),
         ]));
     }
+    if (questionType === 'TRUE_FALSE_CORRECT_GROUP') {
+        const answer = Array.isArray(record.answer)
+            ? record.answer
+            : Array.isArray(value)
+                ? value
+                : [];
+        return Object.fromEntries(answer.map((item, index) => {
+            if (item && typeof item === 'object' && !Array.isArray(item)) {
+                const obj = item;
+                const isTrue = obj.isTrue === true ? true : obj.isTrue === false ? false : null;
+                return [
+                    `${questionId}-item-${index}`,
+                    {
+                        isTrue,
+                        correction: typeof obj.correction === 'string' ? obj.correction : '',
+                    },
+                ];
+            }
+            return [`${questionId}-item-${index}`, { isTrue: null, correction: '' }];
+        }));
+    }
     if (questionType === 'CHOOSE_THE_CORRECT_ANSWER' || questionType === 'CHOOSE_CORRECT_ADJECTIVE') {
         const rawAns = record.answer ?? record.optionId ?? record.optionIds;
         const ids = getOptionIds(questionId, rawAns);

package/dist/components/themes/english-certification/EcWritingTask.js

@@ -46,7 +46,7 @@ export function EcWritingTask({ part, answers, onAnswerChange, isReviewMode = fa
     if (!firstQuestion || !data) {
         return null;
     }
-    const { prompt, requirements, guideImages } = data;
+    const { prompt, requirements, guideImages, passage } = data;
     const meetsMin = minWords ? wordCount >= minWords : true;
     const withinMax = maxWords ? wordCount <= maxWords : true;
     const isValid = meetsMin && withinMax;
@@ -54,7 +54,7 @@ export function EcWritingTask({ part, answers, onAnswerChange, isReviewMode = fa
     const progressPct = progressTarget
         ? Math.min(100, Math.round((wordCount / progressTarget) * 100))
         : 0;
-    return (_jsxs("div", { id: englishCertQuestionDomId(firstQuestion.id), className: "scroll-mt-24 flex flex-col gap-5", children: [_jsxs("div", { className: "flex flex-col gap-5", children: [_jsxs("div", { className: "overflow-hidden rounded-2xl border border-[#cfe0f7] bg-white shadow-[0_18px_40px_rgba(13,71,161,0.10)]", children: [prompt && (_jsx(HtmlOrText, { value: prompt, as: "div", className: "whitespace-pre-line px-5 pb-4 pt-5 text-base leading-relaxed text-[#0f1730]" })), requirements && requirements.length > 0 && (_jsx("div", { className: cn('px-5 pb-4', !prompt && 'pt-5'), children: _jsxs("div", { className: "rounded-xl border border-[#e3edfb] bg-[#f6faff] p-4", children: [_jsxs("div", { className: "flex items-center gap-1.5 text-[11px] font-bold uppercase tracking-wider text-[#0b57d0]", children: [_jsx(ListChecks, { className: "h-3.5 w-3.5" }), "Requirements"] }), _jsx("ul", { className: "mt-2 list-inside list-disc space-y-1.5 text-sm text-[#0f1730]", children: requirements.map((req, idx) => (_jsx("li", { children: _jsx(HtmlOrText, { value: req, as: "span" }) }, idx))) })] }) })), minWords && (_jsxs("div", { className: "border-t border-[#e3edfb] bg-[#f9fbfe] px-5 py-3 text-sm font-semibold text-[#0f1730]", children: ["Write at least ", minWords, " words."] }))] }), guideImages && guideImages.length > 0 && (_jsx("div", { className: "flex flex-col items-center justify-center gap-4 rounded-2xl border border-[#d9e4f2] bg-white/60 p-4", children: guideImages.map((img, idx) => (_jsx(ResolvedImage, { src: img, alt: `Guide ${idx + 1}`, className: "w-full max-w-3xl rounded-xl bg-white object-contain shadow-sm" }, idx))) }))] }), _jsxs("div", { className: "overflow-hidden rounded-2xl border border-[#cfe0f7] bg-white shadow-[0_18px_40px_rgba(13,71,161,0.10)]", children: [_jsxs("div", { className: "flex items-center gap-1.5 border-b border-[#e3edfb] bg-[#f6faff] px-4 py-2.5 text-xs font-bold uppercase tracking-wider text-[#0b57d0]", children: [_jsx(PenLine, { className: "h-3.5 w-3.5" }), "Your answer"] }), _jsx("textarea", { value: answer, disabled: isReviewMode, placeholder: "Write your essay here\u2026", onChange: (e) => onAnswerChange(firstQuestion.id, e.target.value), rows: 14, className: cn('w-full resize-y border-0 bg-white px-5 py-4 text-sm leading-relaxed text-[#0f1730] outline-none transition-all placeholder:text-[#9aa9c2] focus:bg-[#fbfdff]', isReviewMode && 'cursor-not-allowed opacity-80') }), _jsxs("div", { className: "flex flex-col gap-2 border-t border-[#e3edfb] bg-[#f9fbfe] px-4 py-3", children: [_jsxs("div", { className: "flex items-center justify-between text-xs", children: [_jsxs("span", { className: cn('inline-flex items-center gap-1.5 rounded-full px-2.5 py-1 font-semibold', isValid
+    return (_jsxs("div", { id: englishCertQuestionDomId(firstQuestion.id), className: "scroll-mt-24 flex flex-col gap-5", children: [_jsxs("div", { className: "flex flex-col gap-5", children: [_jsxs("div", { className: "overflow-hidden rounded-2xl border border-[#cfe0f7] bg-white shadow-[0_18px_40px_rgba(13,71,161,0.10)]", children: [prompt && (_jsx(HtmlOrText, { value: prompt, as: "div", className: "whitespace-pre-line px-5 pb-4 pt-5 text-base leading-relaxed text-[#0f1730]" })), passage?.trim() && (_jsx("div", { className: "px-5 pb-4", children: _jsxs("div", { className: "rounded-xl border border-[#e3edfb] bg-[#f6faff] p-4", children: [_jsx("p", { className: "text-[11px] font-bold uppercase tracking-wider text-[#0b57d0]", children: "Read" }), _jsx(HtmlOrText, { value: passage, as: "div", className: "mt-2 text-sm leading-relaxed text-[#0f1730]" })] }) })), requirements && requirements.length > 0 && (_jsx("div", { className: cn('px-5 pb-4', !prompt && 'pt-5'), children: _jsxs("div", { className: "rounded-xl border border-[#e3edfb] bg-[#f6faff] p-4", children: [_jsxs("div", { className: "flex items-center gap-1.5 text-[11px] font-bold uppercase tracking-wider text-[#0b57d0]", children: [_jsx(ListChecks, { className: "h-3.5 w-3.5" }), "Requirements"] }), _jsx("ul", { className: "mt-2 list-inside list-disc space-y-1.5 text-sm text-[#0f1730]", children: requirements.map((req, idx) => (_jsx("li", { children: _jsx(HtmlOrText, { value: req, as: "span" }) }, idx))) })] }) })), minWords && (_jsxs("div", { className: "border-t border-[#e3edfb] bg-[#f9fbfe] px-5 py-3 text-sm font-semibold text-[#0f1730]", children: ["Write at least ", minWords, " words."] }))] }), guideImages && guideImages.length > 0 && (_jsx("div", { className: "flex flex-col items-center justify-center gap-4 rounded-2xl border border-[#d9e4f2] bg-white/60 p-4", children: guideImages.map((img, idx) => (_jsx(ResolvedImage, { src: img, alt: `Guide ${idx + 1}`, className: "w-full max-w-3xl rounded-xl bg-white object-contain shadow-sm" }, idx))) }))] }), _jsxs("div", { className: "overflow-hidden rounded-2xl border border-[#cfe0f7] bg-white shadow-[0_18px_40px_rgba(13,71,161,0.10)]", children: [_jsxs("div", { className: "flex items-center gap-1.5 border-b border-[#e3edfb] bg-[#f6faff] px-4 py-2.5 text-xs font-bold uppercase tracking-wider text-[#0b57d0]", children: [_jsx(PenLine, { className: "h-3.5 w-3.5" }), "Your answer"] }), _jsx("textarea", { value: answer, disabled: isReviewMode, placeholder: "Write your essay here\u2026", onChange: (e) => onAnswerChange(firstQuestion.id, e.target.value), rows: 14, className: cn('w-full resize-y border-0 bg-white px-5 py-4 text-sm leading-relaxed text-[#0f1730] outline-none transition-all placeholder:text-[#9aa9c2] focus:bg-[#fbfdff]', isReviewMode && 'cursor-not-allowed opacity-80') }), _jsxs("div", { className: "flex flex-col gap-2 border-t border-[#e3edfb] bg-[#f9fbfe] px-4 py-3", children: [_jsxs("div", { className: "flex items-center justify-between text-xs", children: [_jsxs("span", { className: cn('inline-flex items-center gap-1.5 rounded-full px-2.5 py-1 font-semibold', isValid
                                             ? 'bg-[#ddf8e7] text-[#15803d]'
                                             : 'bg-[#fde8e8] text-[#ef4444]'), children: [wordCount, " words"] }), (minWords || maxWords) && (_jsxs("span", { className: "font-medium text-[#64748b]", children: [minWords ? `Min ${minWords}` : '', minWords && maxWords ? ' · ' : '', maxWords ? `Max ${maxWords}` : ''] }))] }), progressTarget > 0 && (_jsx("div", { className: "h-1.5 w-full overflow-hidden rounded-full bg-[#e3edfb]", children: _jsx("div", { className: cn('h-full rounded-full transition-all', isValid ? 'bg-[#15803d]' : 'bg-[#1167e8]'), style: { width: `${progressPct}%` } }) })), statusMessage && (_jsxs("div", { className: cn('flex items-center gap-1.5 text-xs font-medium', statusMessage.ok ? 'text-[#15803d]' : 'text-[#64748b]'), children: [statusMessage.ok ? (_jsx(CheckCircle2, { className: "h-3.5 w-3.5 shrink-0" })) : (_jsx(AlertCircle, { className: "h-3.5 w-3.5 shrink-0" })), statusMessage.text] }))] })] })] }));
 }

package/dist/index.d.ts

@@ -26,4 +26,4 @@ export { validateQuestion } from './components/questions/_shared/utils/question-
 export { buildAnswerPayload } from './components/questions/_shared/utils/answer-builder';
 export type { QuestionFormState } from './components/questions/_shared/hooks/useQuestionFormState';
 export * from './components/questions/_shared/types';
-export { QuestionViewer, QuestionGroupViewer, WordFillStructuredFormViewer, ChooseTheCorrectAnswerGroupViewer, TrueFalseGroupViewer, CrossOutWordGroupViewer, SpontaneousQaGroupViewer, WordOrderAndMatchGroupViewer, } from './components/questions/viewer';
+export { QuestionViewer, QuestionGroupViewer, WordFillStructuredFormViewer, ChooseTheCorrectAnswerGroupViewer, TrueFalseGroupViewer, TrueFalseCorrectGroupViewer, CrossOutWordGroupViewer, SpontaneousQaGroupViewer, WordOrderAndMatchGroupViewer, AnswerTheQuestionGroupViewer, MatchWordToPictureViewer, MatchWordToPictureGroupViewer, } from './components/questions/viewer';

package/dist/index.js

@@ -21,4 +21,4 @@ export { QUESTION_TYPE_CONFIG, QUESTION_TYPES_WITH_DEDICATED_COMPONENTS } from '
 export { validateQuestion } from './components/questions/_shared/utils/question-validation';
 export { buildAnswerPayload } from './components/questions/_shared/utils/answer-builder';
 export * from './components/questions/_shared/types';
-export { QuestionViewer, QuestionGroupViewer, WordFillStructuredFormViewer, ChooseTheCorrectAnswerGroupViewer, TrueFalseGroupViewer, CrossOutWordGroupViewer, SpontaneousQaGroupViewer, WordOrderAndMatchGroupViewer, } from './components/questions/viewer';
+export { QuestionViewer, QuestionGroupViewer, WordFillStructuredFormViewer, ChooseTheCorrectAnswerGroupViewer, TrueFalseGroupViewer, TrueFalseCorrectGroupViewer, CrossOutWordGroupViewer, SpontaneousQaGroupViewer, WordOrderAndMatchGroupViewer, AnswerTheQuestionGroupViewer, MatchWordToPictureViewer, MatchWordToPictureGroupViewer, } from './components/questions/viewer';

package/dist/shared/constants/question-skills.js

@@ -52,6 +52,7 @@ export const QUESTION_TYPE_SKILLS = {
     'WORD_ORDERING': SkillEnum.READING,
     'WORD_FILL_PARAGRAPH': SkillEnum.READING,
     'MATCH_BY_WRITING_ANSWER': SkillEnum.READING,
+    'MATCH_WORD_TO_PICTURE': SkillEnum.READING,
     // Visual-based reading questions
     'LABEL_THE_PICTURE': SkillEnum.READING,
     'LOOK_PICTURE_CHOOSE_CORRECT_ANSWER': SkillEnum.READING,
@@ -62,6 +63,7 @@ export const QUESTION_TYPE_SKILLS = {
     // Other reading types
     'TRUE_FALSE': SkillEnum.READING,
     'TRUE_FALSE_GROUP': SkillEnum.READING,
+    'TRUE_FALSE_CORRECT_GROUP': SkillEnum.READING,
     'CROSS_OUT_WORD_GROUP': SkillEnum.READING,
     'SPONTANEOUS_QA_GROUP': SkillEnum.SPEAKING,
     'WORD_ORDER_AND_MATCH_GROUP': SkillEnum.READING,
@@ -185,6 +187,7 @@ export const QUESTION_TYPE_LABELS = {
     'IMAGE_OBJECT_MATCHING': 'Ghép hình ảnh - Đối tượng',
     'TRUE_FALSE': 'Đúng/Sai',
     'TRUE_FALSE_GROUP': 'Đúng/Sai (nhóm)',
+    'TRUE_FALSE_CORRECT_GROUP': 'Đúng/Sai + sửa câu (nhóm)',
     'CROSS_OUT_WORD_GROUP': 'Gạch từ / sửa từ (nhóm)',
     'SPONTANEOUS_QA_GROUP': 'Hỏi đáp tự phát (nhóm)',
     'WORD_ORDER_AND_MATCH_GROUP': 'Sắp xếp từ và nối nhãn (nhóm)',
@@ -205,6 +208,7 @@ export const QUESTION_TYPE_LABELS = {
     'WORD_ORDERING': 'Sắp xếp từ',
     'WORD_FILL_PARAGRAPH': 'Điền từ vào đoạn văn',
     'MATCH_BY_WRITING_ANSWER': 'Ghép đáp án bằng cách viết',
+    'MATCH_WORD_TO_PICTURE': 'Nối từ với tranh',
     'WORD_FILL_STRUCTURED_FORM': 'Điền từ vào biểu mẫu có cấu trúc',
     'CROSSWORD_PUZZLE': 'Giải ô chữ (Crossword)',
     'FIND_WORDS_IN_MATRIX': 'Tìm từ trong ma trận (Word Search)',

package/dist/shared/lib/hooks/usePresignedFileUrl.d.ts

@@ -9,7 +9,9 @@ export interface PresignedUrlResponse {
  * - Empty/undefined → empty string.
  * - Already a URL (http/https/blob/data) → returned unchanged.
  * - An S3 storage key (e.g. `exams/:id/audio/x.wav`) → resolved to a presigned
- *   URL via the host API (`/api/v1/exam-storage/:key`).
+ *   URL via the host API. Tries `/api/v1/exam-storage/:key` (oe-class proxy)
+ *   then `/api/v1/storage/:key` (oe-exam-api). Override with
+ *   `NEXT_PUBLIC_EXAM_STORAGE_PATH`.
  */
 export declare function usePresignedFileUrl(fileKey: string | undefined): {
     previewUrl: string;

package/dist/shared/lib/hooks/usePresignedFileUrl.js

@@ -6,7 +6,14 @@ import { useEffect, useMemo, useState } from 'react';
  * owns them. Reads NEXT_PUBLIC_API_URL — inlined at build time in the host.
  */
 const HOST_API_BASE_URL = (process.env.NEXT_PUBLIC_API_URL ?? '').replace(/\/+$/, '');
-const EXAM_STORAGE_PATH = '/api/v1/exam-storage';
+const DEFAULT_STORAGE_PATHS = ['/api/v1/exam-storage', '/api/v1/storage'];
+function getStoragePaths() {
+    const configured = process.env.NEXT_PUBLIC_EXAM_STORAGE_PATH;
+    const paths = configured
+        ? [configured, ...DEFAULT_STORAGE_PATHS]
+        : DEFAULT_STORAGE_PATHS;
+    return [...new Set(paths.map((path) => path.replace(/\/+$/, '')).filter(Boolean))];
+}
 /** A resolved key is displayable as-is when it's already a URL or inline data. */
 function isDisplayableUrl(value) {
     return (value.startsWith('http://') ||
@@ -33,17 +40,26 @@ async function resolvePresignedUrl(key) {
             // caller at least doesn't crash. It won't load, but nothing throws.
             return key;
         }
-        const response = await fetch(`${HOST_API_BASE_URL}${EXAM_STORAGE_PATH}/${encodeURIComponent(key)}`, { credentials: 'include' });
-        if (!response.ok) {
-            throw new Error(`Failed to resolve file URL (${response.status})`);
-        }
-        const body = (await response.json());
-        const resolved = 'data' in body ? body.data?.url : body.url;
-        if (!resolved) {
-            throw new Error('Presigned URL missing in response');
+        let lastError = null;
+        for (const storagePath of getStoragePaths()) {
+            try {
+                const response = await fetch(`${HOST_API_BASE_URL}${storagePath}/${encodeURIComponent(key)}`, { credentials: 'include' });
+                if (!response.ok) {
+                    throw new Error(`Failed to resolve file URL (${response.status})`);
+                }
+                const body = (await response.json());
+                const resolved = 'data' in body ? body.data?.url : body.url;
+                if (!resolved) {
+                    throw new Error('Presigned URL missing in response');
+                }
+                urlCache.set(key, resolved);
+                return resolved;
+            }
+            catch (error) {
+                lastError = error instanceof Error ? error : new Error(String(error));
+            }
         }
-        urlCache.set(key, resolved);
-        return resolved;
+        throw lastError ?? new Error('Failed to resolve file URL');
     })().finally(() => {
         inFlight.delete(key);
     });
@@ -56,7 +72,9 @@ async function resolvePresignedUrl(key) {
  * - Empty/undefined → empty string.
  * - Already a URL (http/https/blob/data) → returned unchanged.
  * - An S3 storage key (e.g. `exams/:id/audio/x.wav`) → resolved to a presigned
- *   URL via the host API (`/api/v1/exam-storage/:key`).
+ *   URL via the host API. Tries `/api/v1/exam-storage/:key` (oe-class proxy)
+ *   then `/api/v1/storage/:key` (oe-exam-api). Override with
+ *   `NEXT_PUBLIC_EXAM_STORAGE_PATH`.
  */
 export function usePresignedFileUrl(fileKey) {
     const safeKey = typeof fileKey === 'string' ? fileKey : '';

package/dist/shared/lib/utils/question-reverse-transform.js

@@ -145,6 +145,23 @@ const reverseGroupPayload = (apiQuestion) => {
         },
     };
 };
+function normalizeChooseAnswerGroupImageUrl(value) {
+    if (typeof value === 'string') {
+        const trimmed = value.trim();
+        return trimmed !== '' ? trimmed : undefined;
+    }
+    if (!Array.isArray(value)) {
+        return undefined;
+    }
+    const urls = value
+        .filter((url) => typeof url === 'string')
+        .map((url) => url.trim())
+        .filter((url) => url !== '');
+    if (urls.length === 0) {
+        return undefined;
+    }
+    return urls.length === 1 ? urls[0] : urls;
+}
 const reverseChooseTheCorrectAnswerGroup = (apiQuestion) => {
     const content = asRecord(apiQuestion.content);
     const answer = readAnswer(apiQuestion);
@@ -155,12 +172,15 @@ const reverseChooseTheCorrectAnswerGroup = (apiQuestion) => {
         const itemAnswer = asRecord(item.correctAnswer);
         const options = asArray(itemContent.options).map((rawOption, optionIndex) => {
             const option = asRecord(rawOption);
+            const imageUrl = asString(option.imageUrl);
             return {
                 id: asString(option.id, `opt-${optionIndex + 1}`),
                 text: asString(option.text),
+                ...(imageUrl ? { imageUrl } : {}),
             };
         });
         const isExample = item.isExample === true;
+        const imageUrl = normalizeChooseAnswerGroupImageUrl(itemContent.imageUrl);
         return {
             question: asString(itemContent.question),
             optionType: asString(itemContent.optionType, 'text') === 'image' ? 'image' : 'text',
@@ -173,6 +193,7 @@ const reverseChooseTheCorrectAnswerGroup = (apiQuestion) => {
             isExample,
             points: isExample ? 0 : asNumber(item.points, 1),
             questionNumber: asNumber(item.questionNumber, index + 1),
+            ...(imageUrl !== undefined ? { imageUrl } : {}),
         };
     });
     return {
@@ -256,6 +277,37 @@ const reverseTrueFalseGroup = (apiQuestion) => {
         },
     };
 };
+const reverseTrueFalseCorrectGroup = (apiQuestion) => {
+    const content = asRecord(apiQuestion.content);
+    const answer = readAnswer(apiQuestion);
+    const fallbackAnswers = asArray(answer.answer);
+    const items = asArray(content.items).map((rawItem, index) => {
+        const item = asRecord(rawItem);
+        const itemContent = asRecord(item.content);
+        const itemAnswer = asRecord(asRecord(item.correctAnswer).answer);
+        const fallback = asRecord(fallbackAnswers[index]);
+        const rawAnswer = Object.keys(itemAnswer).length > 0 ? itemAnswer : fallback;
+        const isExample = item.isExample === true;
+        const isTrue = rawAnswer.isTrue === true;
+        return {
+            question: asString(itemContent.question),
+            isTrue,
+            correction: isTrue ? '' : asString(rawAnswer.correction),
+            isExample,
+            points: isExample ? 0 : asNumber(item.points, 1),
+            questionNumber: asNumber(item.questionNumber, index + 1),
+        };
+    });
+    return {
+        content: '',
+        answer: {
+            instruction: asString(asRecord(content.meta).instruction, 'Tick (✓) the true and cross (✗) the false sentences. Correct the false sentences.'),
+            items,
+            explanation: asString(apiQuestion.explanation),
+            points: items.reduce((total, item) => (item.isExample ? total : total + item.points), 0),
+        },
+    };
+};
 const reverseCrossOutWordGroup = (apiQuestion) => {
     const content = asRecord(apiQuestion.content);
     const answer = readAnswer(apiQuestion);
@@ -407,6 +459,7 @@ const handlers = {
     CHOOSE_THE_CORRECT_ANSWER_GROUP: reverseChooseTheCorrectAnswerGroup,
     ANSWER_THE_QUESTION_GROUP: reverseAnswerTheQuestionGroup,
     TRUE_FALSE_GROUP: reverseTrueFalseGroup,
+    TRUE_FALSE_CORRECT_GROUP: reverseTrueFalseCorrectGroup,
     CROSS_OUT_WORD_GROUP: reverseCrossOutWordGroup,
     WORD_ORDER_AND_MATCH_GROUP: reverseWordOrderAndMatchGroup,
     WORD_ORDER_AND_MATCH: reverseWordOrderAndMatchGroup,
@@ -424,8 +477,9 @@ const handlers = {
     WORD_ORDERING: reverseSimpleAnswer,
     WORD_FILL_PARAGRAPH: reverseSimpleAnswer,
     MATCH_BY_WRITING_ANSWER: reverseGroupPayload,
-    WRITE_SENTENCES: reverseGroupPayload,
-    WRITE_A_SHORT_LETTER: reverseSimpleAnswer,
+    MATCH_WORD_TO_PICTURE: reverseGroupPayload,
+    WRITE_SHORT_PARAGRAPH: reverseWriteShortParagraph,
+    WRITE_A_SHORT_LETTER: reverseWriteAShortLetter,
     WRITE_CORRECT_VERB_FORM: reverseSimpleAnswer,
     CHOOSE_CORRECT_ADJECTIVE: reverseSimpleAnswer,
     WORD_FILL_STRUCTURED_FORM: reverseGroupPayload,
@@ -449,6 +503,61 @@ const handlers = {
     CROSSWORD_PUZZLE: reverseCrosswordPuzzle,
     FIND_WORDS_IN_MATRIX: reverseFindWordsInMatrix,
 };
+function reverseWriteAShortLetter(apiQuestion) {
+    const content = asRecord(apiQuestion.content);
+    const answer = readAnswer(apiQuestion);
+    const informations = asArray(content.informations ?? answer.informations).map((item) => asString(item)).filter(Boolean);
+    const guideImages = asArray(content.guideImages ?? answer.guideImages).map((item) => asString(item)).filter(Boolean);
+    const passage = asString(content.passage ?? answer.passage);
+    const contexts = asArray(content.contexts ?? answer.contexts);
+    const instructions = isRecord(content.instructions)
+        ? content.instructions
+        : isRecord(answer.instructions)
+            ? answer.instructions
+            : { mainInstruction: asString(content.instruction ?? content.prompt ?? answer.instruction ?? answer.prompt) };
+    const minWords = asNumber(content.minWords ?? answer.minWords, 20);
+    const maxWords = content.maxWords !== undefined && content.maxWords !== null
+        ? asNumber(content.maxWords, 0) || null
+        : answer.maxWords !== undefined && answer.maxWords !== null
+            ? asNumber(answer.maxWords, 0) || null
+            : null;
+    const resolved = {
+        instructions,
+        instruction: asString(instructions.mainInstruction || instructions.instruction),
+        informations,
+        guideImages,
+        ...(passage ? { passage } : {}),
+        contexts,
+        minWords,
+        maxWords,
+    };
+    return {
+        content: resolved,
+        answer: resolved,
+    };
+}
+function reverseWriteShortParagraph(apiQuestion) {
+    const content = asRecord(apiQuestion.content);
+    const answer = readAnswer(apiQuestion);
+    const contexts = asArray(content.contexts ?? answer.contexts);
+    const instruction = asString(content.instruction ?? content.instructions?.mainInstruction ?? answer.instruction);
+    const minWords = asNumber(content.minWords ?? answer.minWords, 20);
+    const maxWords = content.maxWords !== undefined && content.maxWords !== null
+        ? asNumber(content.maxWords, 0) || null
+        : answer.maxWords !== undefined && answer.maxWords !== null
+            ? asNumber(answer.maxWords, 0) || null
+            : null;
+    const resolved = {
+        instruction,
+        contexts,
+        minWords,
+        maxWords,
+    };
+    return {
+        content: resolved,
+        answer: resolved,
+    };
+}
 function reverseCrosswordPuzzle(apiQuestion) {
     const apiContent = (apiQuestion.content || {});
     const apiAnswer = (apiQuestion.correctAnswer || apiQuestion.correct_answer || apiQuestion.answer || {});

package/dist/shared/lib/utils/question-transform.js

@@ -13,6 +13,7 @@ import { transformLabelThePicture } from '../../../components/questions/types/la
 import { transformChooseTheCorrectAnswer } from '../../../components/questions/types/choose-the-correct-answer/transform';
 import { transformChooseTheCorrectAnswerGroup } from '../../../components/questions/types/choose-the-correct-answer-group/transform';
 import { transformCrossOutWordGroup } from '../../../components/questions/types/cross-out-word-group/transform';
+import { transformTrueFalseCorrectGroup } from '../../../components/questions/types/true-false-correct-group/transform';
 import { transformFillInBlank } from '../../../components/questions/types/fill-in-blank/transform';
 import { transformWriteCorrectVerbForm } from '../../../components/questions/types/write-correct-verb-form/transform';
 import { transformChooseCorrectAdjective } from '../../../components/questions/types/choose-correct-adjective/transform';
@@ -22,6 +23,7 @@ import { transformTrueFalse } from '../../../components/questions/types/true-fal
 import { transformWordOrdering } from '../../../components/questions/types/word-ordering/transform';
 import { transformWordFillParagraph } from '../../../components/questions/types/word-fill-paragraph/transform';
 import { transformMatchByWritingAnswer } from '../../../components/questions/types/match-by-writing-answer/transform';
+import { transformMatchWordToPicture } from '../../../components/questions/types/match-word-to-picture/transform';
 import { transformWriteSentences } from '../../../components/questions/types/write-sentences/transform';
 import { transformListenAndChooseFromAnswerGroup } from '../../../components/questions/types/listen-and-choose-from-answer-group/transform';
 import { transformListenAndChooseObjectsInScene } from '../../../components/questions/types/listen-and-choose-objects-in-scene/transform';
@@ -62,6 +64,7 @@ const questionTransformHandlers = {
     CHOOSE_THE_CORRECT_ANSWER: transformChooseTheCorrectAnswer,
     CHOOSE_THE_CORRECT_ANSWER_GROUP: transformChooseTheCorrectAnswerGroup,
     CROSS_OUT_WORD_GROUP: transformCrossOutWordGroup,
+    TRUE_FALSE_CORRECT_GROUP: transformTrueFalseCorrectGroup,
     FILL_IN_BLANK: transformFillInBlank,
     WRITE_CORRECT_VERB_FORM: transformWriteCorrectVerbForm,
     CHOOSE_CORRECT_ADJECTIVE: transformChooseCorrectAdjective,
@@ -71,6 +74,7 @@ const questionTransformHandlers = {
     WORD_ORDERING: transformWordOrdering,
     WORD_FILL_PARAGRAPH: transformWordFillParagraph,
     MATCH_BY_WRITING_ANSWER: transformMatchByWritingAnswer,
+    MATCH_WORD_TO_PICTURE: transformMatchWordToPicture,
     WRITE_SENTENCES: transformWriteSentences,
     LISTEN_AND_CHOOSE_FROM_ANSWER_GROUP: transformListenAndChooseFromAnswerGroup,
     LISTEN_AND_CHOOSE_OBJECTS_IN_SCENE: transformListenAndChooseObjectsInScene,

package/dist/shared/types/common.types.d.ts

@@ -29,7 +29,7 @@ export declare enum StudentSelectionType {
 }
 export type ResultStatus = 'PENDING' | 'PARTIAL_GRADED' | 'GRADED';
 export type StudentStatus = 'NOT_STARTED' | 'IN_PROGRESS' | 'SUBMITTED';
-export type QuestionType = 'FILL_IN_BLANK' | 'TRUE_FALSE' | 'MATCHING' | 'ORDERING' | 'LISTENING' | 'COLORING' | 'ESSAY' | 'LISTEN_AND_FILL_IN_THE_BLANK_WITH_IMAGE' | 'LISTEN_AND_TICK_ANSWER' | 'LISTEN_AND_FILL_NAME_NUMBER' | 'LISTENING_FILL_BLANK' | 'LISTENING_COLOR' | 'TICK_TRUE_OR_FALSE' | 'TICK_YES_OR_NO' | 'READING_TICK_CROSS' | 'ARRANGE_LETTERS_INTO_WORDS' | 'READ_PASSAGE_AND_COMPLETE_STORY' | 'CLOZE_TEST_WITH_TICK_BOX' | 'READ_AND_CHOOSE_APPROPRIATE_WORD' | 'WRITE_SHORT_PARAGRAPH' | 'LABEL_THE_PICTURE' | 'READING_LETTER_ARRANGE' | 'READING_PASSAGE_FILL' | 'FILL_BLANK' | 'FILL_MISSING_WORDS_IN_GRID' | 'LOOK_PICTURE_CHOOSE_CORRECT_ANSWER' | 'LOOK_PICTURE_FILL_BLANK_CHOOSE_ANSWER' | 'LOOK_PICTURE_FILL_WORD_HINT' | 'LABEL_THE_PICTURE' | 'READ_AND_COLOR_OBJECTS' | 'IMAGE_OBJECT_MATCHING' | 'READ_PASSAGE_AND_ANSWER_QUESTIONS' | 'CHOOSE_THE_CORRECT_ANSWER' | 'CHOOSE_THE_CORRECT_ANSWER_GROUP' | 'TRUE_FALSE_GROUP' | 'CROSS_OUT_WORD_GROUP' | 'SPONTANEOUS_QA_GROUP' | 'WORD_ORDER_AND_MATCH_GROUP' | 'WRITE_A_SHORT_LETTER' | 'WRITE_CORRECT_VERB_FORM' | 'CHOOSE_CORRECT_ADJECTIVE' | 'ANSWER_THE_QUESTION' | 'ANSWER_THE_QUESTION_GROUP' | 'WORD_ORDERING' | 'WORD_FILL_PARAGRAPH' | 'MATCH_BY_WRITING_ANSWER' | 'WRITE_SENTENCES' | 'LISTEN_AND_CHOOSE_FROM_ANSWER_GROUP' | 'LISTEN_AND_CHOOSE_OBJECTS_IN_SCENE' | 'LISTEN_AND_DRAG_OBJECTS_INTO_SCENE' | 'LISTEN_AND_SPEAK_ANSWER' | 'LISTEN_AND_SPEAK_IMAGE_GROUP' | 'LISTEN_AND_SPEAK_QUESTION_LIST' | 'LISTEN_AND_SPEAK_COMPARE_IMAGES' | 'LISTEN_AND_SPEAK_WITH_STORY_IMAGES' | 'LISTEN_AND_SPEAK_ODD_ONE_OUT' | 'LISTEN_AND_SPEAK_INFO_EXCHANGE' | 'READ_DISPLAYED_CONTENT' | 'SPEAKING_DESCRIBE_IMAGE' | 'SPONTANEOUS_QA' | 'SPEAKING_CONVERSATION' | 'GN_SPEAKING_INTERVIEW' | 'SPEAKING_CUE_CARD' | 'WORD_FILL_STRUCTURED_FORM' | 'CROSSWORD_PUZZLE' | 'FIND_WORDS_IN_MATRIX';
+export type QuestionType = 'FILL_IN_BLANK' | 'TRUE_FALSE' | 'MATCHING' | 'ORDERING' | 'LISTENING' | 'COLORING' | 'ESSAY' | 'LISTEN_AND_FILL_IN_THE_BLANK_WITH_IMAGE' | 'LISTEN_AND_TICK_ANSWER' | 'LISTEN_AND_FILL_NAME_NUMBER' | 'LISTENING_FILL_BLANK' | 'LISTENING_COLOR' | 'TICK_TRUE_OR_FALSE' | 'TICK_YES_OR_NO' | 'READING_TICK_CROSS' | 'ARRANGE_LETTERS_INTO_WORDS' | 'READ_PASSAGE_AND_COMPLETE_STORY' | 'CLOZE_TEST_WITH_TICK_BOX' | 'READ_AND_CHOOSE_APPROPRIATE_WORD' | 'WRITE_SHORT_PARAGRAPH' | 'LABEL_THE_PICTURE' | 'READING_LETTER_ARRANGE' | 'READING_PASSAGE_FILL' | 'FILL_BLANK' | 'FILL_MISSING_WORDS_IN_GRID' | 'LOOK_PICTURE_CHOOSE_CORRECT_ANSWER' | 'LOOK_PICTURE_FILL_BLANK_CHOOSE_ANSWER' | 'LOOK_PICTURE_FILL_WORD_HINT' | 'LABEL_THE_PICTURE' | 'READ_AND_COLOR_OBJECTS' | 'IMAGE_OBJECT_MATCHING' | 'READ_PASSAGE_AND_ANSWER_QUESTIONS' | 'CHOOSE_THE_CORRECT_ANSWER' | 'CHOOSE_THE_CORRECT_ANSWER_GROUP' | 'TRUE_FALSE_GROUP' | 'TRUE_FALSE_CORRECT_GROUP' | 'CROSS_OUT_WORD_GROUP' | 'SPONTANEOUS_QA_GROUP' | 'WORD_ORDER_AND_MATCH_GROUP' | 'WRITE_A_SHORT_LETTER' | 'WRITE_CORRECT_VERB_FORM' | 'CHOOSE_CORRECT_ADJECTIVE' | 'ANSWER_THE_QUESTION' | 'ANSWER_THE_QUESTION_GROUP' | 'WORD_ORDERING' | 'WORD_FILL_PARAGRAPH' | 'MATCH_BY_WRITING_ANSWER' | 'MATCH_WORD_TO_PICTURE' | 'WRITE_SENTENCES' | 'LISTEN_AND_CHOOSE_FROM_ANSWER_GROUP' | 'LISTEN_AND_CHOOSE_OBJECTS_IN_SCENE' | 'LISTEN_AND_DRAG_OBJECTS_INTO_SCENE' | 'LISTEN_AND_SPEAK_ANSWER' | 'LISTEN_AND_SPEAK_IMAGE_GROUP' | 'LISTEN_AND_SPEAK_QUESTION_LIST' | 'LISTEN_AND_SPEAK_COMPARE_IMAGES' | 'LISTEN_AND_SPEAK_WITH_STORY_IMAGES' | 'LISTEN_AND_SPEAK_ODD_ONE_OUT' | 'LISTEN_AND_SPEAK_INFO_EXCHANGE' | 'READ_DISPLAYED_CONTENT' | 'SPEAKING_DESCRIBE_IMAGE' | 'SPONTANEOUS_QA' | 'SPEAKING_CONVERSATION' | 'GN_SPEAKING_INTERVIEW' | 'SPEAKING_CUE_CARD' | 'WORD_FILL_STRUCTURED_FORM' | 'CROSSWORD_PUZZLE' | 'FIND_WORDS_IN_MATRIX';
 export type Level = 'Pre-A1' | 'A1' | 'A2' | 'B1' | 'B2' | 'C1' | 'C2';
 export type Difficulty = 'EASY' | 'MEDIUM' | 'HARD';
 export type Skill = 'LISTENING' | 'READING' | 'WRITING' | 'SPEAKING';

package/dist/shared/types/questions/choose-the-correct-answer-group.d.ts

@@ -7,6 +7,7 @@ export interface ChooseTheCorrectAnswerGroupItemContent {
     question: string;
     options: ChooseTheCorrectAnswerGroupOption[];
     optionType?: 'text' | 'image';
+    imageUrl?: string | string[];
 }
 export interface ChooseTheCorrectAnswerGroupItem {
     questionType?: 'CHOOSE_THE_CORRECT_ANSWER';

package/dist/shared/types/questions/index.d.ts

@@ -32,3 +32,5 @@ export * from './spontaneous-qa';
 export * from './word-order-and-match-group';
 export * from './crossword-puzzle';
 export * from './find-words-in-matrix';
+export * from './match-word-to-picture';
+export * from './true-false-correct-group';

package/dist/shared/types/questions/index.js

@@ -50,3 +50,7 @@ export * from './word-order-and-match-group';
 export * from './crossword-puzzle';
 // FIND_WORDS_IN_MATRIX
 export * from './find-words-in-matrix';
+// MATCH_WORD_TO_PICTURE
+export * from './match-word-to-picture';
+// TRUE_FALSE_CORRECT_GROUP
+export * from './true-false-correct-group';

package/dist/shared/types/questions/match-word-to-picture.d.ts

@@ -0,0 +1,35 @@
+/**
+ * API Types for MATCH_WORD_TO_PICTURE question type
+ * Reference: .agents/templates/MATCH_WORD_TO_PICTURE.sample.json
+ */
+import { QuestionBankSettings } from './choose-the-correct-answer';
+export interface MatchWordToPictureContent {
+    imageUrl: string;
+}
+export interface MatchWordToPictureCorrectAnswer {
+    answer: string;
+}
+export interface MatchWordToPictureGroupPayload {
+    wordBank: string[];
+    instruction?: string;
+}
+export interface MatchWordToPictureAPIPayload {
+    id?: string;
+    questionType: 'MATCH_WORD_TO_PICTURE';
+    content: MatchWordToPictureContent;
+    correctAnswer: MatchWordToPictureCorrectAnswer;
+    isGroup: true;
+    isExample?: boolean;
+    questionGroup: {
+        groupNumber: number;
+        payload: MatchWordToPictureGroupPayload;
+    };
+    points: number;
+    explanation?: string;
+    questionNumber: number;
+    partId?: string;
+    partNo?: number;
+    addToQuestionBank?: boolean;
+    questionBank?: QuestionBankSettings;
+}
+export type MatchWordToPictureLocalStorage = Omit<MatchWordToPictureAPIPayload, 'addToQuestionBank' | 'questionBank'>;

package/dist/shared/types/questions/match-word-to-picture.js

@@ -0,0 +1,5 @@
+/**
+ * API Types for MATCH_WORD_TO_PICTURE question type
+ * Reference: .agents/templates/MATCH_WORD_TO_PICTURE.sample.json
+ */
+export {};

package/dist/shared/types/questions/true-false-correct-group.d.ts

@@ -0,0 +1,39 @@
+export declare const TRUE_FALSE_CORRECT_ITEM_TYPE: "TRUE_FALSE_CORRECT";
+export interface TrueFalseCorrectItemAnswer {
+    isTrue: boolean;
+    correction: string;
+}
+export interface TrueFalseCorrectGroupItemContent {
+    question: string;
+}
+export interface TrueFalseCorrectGroupItem {
+    questionType?: typeof TRUE_FALSE_CORRECT_ITEM_TYPE;
+    isExample?: boolean;
+    content: TrueFalseCorrectGroupItemContent;
+    correctAnswer?: {
+        answer: TrueFalseCorrectItemAnswer;
+    };
+    points?: number;
+    questionNumber?: number;
+}
+export interface TrueFalseCorrectGroupContent {
+    meta?: {
+        instruction?: string;
+    };
+    items: TrueFalseCorrectGroupItem[];
+}
+export interface TrueFalseCorrectGroupCorrectAnswer {
+    answer: TrueFalseCorrectItemAnswer[];
+}
+export interface TrueFalseCorrectGroupAPIPayload {
+    id?: string;
+    questionType: 'TRUE_FALSE_CORRECT_GROUP';
+    content: TrueFalseCorrectGroupContent;
+    correctAnswer: TrueFalseCorrectGroupCorrectAnswer;
+    points: number;
+    explanation?: string;
+    questionNumber: number;
+    partId?: string;
+    partNo?: number;
+}
+export type TrueFalseCorrectGroupLocalStorage = TrueFalseCorrectGroupAPIPayload;