@tinyweb_dev/oe-exam-sdk 0.2.4 → 0.2.6

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, AnswerTheQuestionGroupViewer, } from './components/questions/viewer';
+export { QuestionViewer, QuestionGroupViewer, WordFillStructuredFormViewer, ChooseTheCorrectAnswerGroupViewer, TrueFalseGroupViewer, TrueFalseCorrectGroupViewer, FillInBlankGroupViewer, MatchingWithLinesGroupViewer, 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, AnswerTheQuestionGroupViewer, } from './components/questions/viewer';
+export { QuestionViewer, QuestionGroupViewer, WordFillStructuredFormViewer, ChooseTheCorrectAnswerGroupViewer, TrueFalseGroupViewer, TrueFalseCorrectGroupViewer, FillInBlankGroupViewer, MatchingWithLinesGroupViewer, CrossOutWordGroupViewer, SpontaneousQaGroupViewer, WordOrderAndMatchGroupViewer, AnswerTheQuestionGroupViewer, MatchWordToPictureViewer, MatchWordToPictureGroupViewer, } from './components/questions/viewer';

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

@@ -45,6 +45,7 @@ export const QUESTION_TYPE_SKILLS = {
     'CHOOSE_THE_CORRECT_ANSWER_GROUP': SkillEnum.READING,
     'CHOOSE_CORRECT_ADJECTIVE': SkillEnum.READING,
     'FILL_IN_BLANK': SkillEnum.READING,
+    'FILL_IN_BLANK_GROUP': SkillEnum.READING,
     'FILL_MISSING_WORDS_IN_GRID': SkillEnum.READING,
     'READ_PASSAGE_AND_ANSWER_QUESTIONS': SkillEnum.READING,
     'ANSWER_THE_QUESTION': SkillEnum.READING,
@@ -52,6 +53,8 @@ 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,
+    'MATCHING_WITH_LINES_GROUP': SkillEnum.READING,
     // Visual-based reading questions
     'LABEL_THE_PICTURE': SkillEnum.READING,
     'LOOK_PICTURE_CHOOSE_CORRECT_ANSWER': SkillEnum.READING,
@@ -62,6 +65,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,
@@ -175,6 +179,7 @@ export const QUESTION_TYPE_LABELS = {
     'CHOOSE_THE_CORRECT_ANSWER_GROUP': 'Chọn đáp án đúng (nhóm)',
     'CHOOSE_CORRECT_ADJECTIVE': 'Chọn tính từ',
     'FILL_IN_BLANK': 'Điền vào chỗ trống',
+    'FILL_IN_BLANK_GROUP': 'Điền chỗ trống (nhóm)',
     'FILL_MISSING_WORDS_IN_GRID': 'Điền từ vào lưới',
     'READ_PASSAGE_AND_ANSWER_QUESTIONS': 'Đọc hiểu - Trả lời',
     'LABEL_THE_PICTURE': 'Gắn nhãn hình ảnh',
@@ -185,6 +190,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 +211,8 @@ 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',
+    'MATCHING_WITH_LINES_GROUP': 'Nối bằng đường kẻ (nhóm)',
     '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,121 @@ 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 reverseFillInBlankGroup = (apiQuestion) => {
+    const content = asRecord(apiQuestion.content);
+    const answer = readAnswer(apiQuestion);
+    const fallbackAnswers = asArray(answer.answer);
+    const meta = asRecord(content.meta);
+    const items = asArray(content.items).map((rawItem, index) => {
+        const item = asRecord(rawItem);
+        const itemContent = asRecord(item.content);
+        const itemAnswer = asRecord(item.correctAnswer);
+        const fallback = asRecord(fallbackAnswers[index]);
+        const isExample = item.isExample === true;
+        const question = asString(itemContent.question, '{0}');
+        const rawAnswers = itemAnswer.answers ?? fallback.answers;
+        const answers = asArray(rawAnswers).map((blank) => {
+            const alts = Array.isArray(blank)
+                ? blank.map((alt) => String(alt ?? '').trim()).filter(Boolean)
+                : [String(blank ?? '').trim()].filter(Boolean);
+            return alts.length > 0 ? alts : [''];
+        });
+        return {
+            question,
+            answers: answers.length > 0 ? answers : [['']],
+            caseSensitive: itemAnswer.caseSensitive === true || fallback.caseSensitive === true,
+            imageUrl: asString(itemContent.imageUrl),
+            audioUrl: asString(itemContent.audioUrl),
+            showHints: itemContent.showHints === true,
+            hints: asArray(itemContent.hints).map((hint) => String(hint ?? '').trim()).filter(Boolean),
+            isExample,
+            points: isExample ? 0 : asNumber(item.points, 1),
+            questionNumber: asNumber(item.questionNumber, index + 1),
+        };
+    });
+    return {
+        content: '',
+        answer: {
+            instruction: asString(meta.instruction, 'Complete the sentences.'),
+            audioUrl: asString(meta.audioUrl),
+            imageUrl: asString(meta.imageUrl),
+            showHints: meta.showHints === true,
+            hints: asArray(meta.hints).map((hint) => String(hint ?? '').trim()).filter(Boolean),
+            items,
+            explanation: asString(apiQuestion.explanation),
+            points: items.reduce((total, item) => (item.isExample ? total : total + item.points), 0),
+        },
+    };
+};
+const reverseMatchingWithLinesGroup = (apiQuestion) => {
+    const content = asRecord(apiQuestion.content);
+    const answer = readAnswer(apiQuestion);
+    const fallbackAnswers = asArray(answer.answer);
+    const meta = asRecord(content.meta);
+    const rightItems = asArray(content.rightItems).map((raw, index) => {
+        const item = asRecord(raw);
+        return {
+            id: asString(item.id, `r${index + 1}`),
+            text: asString(item.text),
+        };
+    });
+    const items = asArray(content.items).map((rawItem, index) => {
+        const item = asRecord(rawItem);
+        const itemContent = asRecord(item.content);
+        const itemAnswer = asRecord(item.correctAnswer);
+        const fallback = fallbackAnswers[index];
+        const isExample = item.isExample === true;
+        return {
+            imageUrl: asString(itemContent.imageUrl),
+            correctAnswer: asString(itemAnswer.answer, typeof fallback === 'string' ? fallback : ''),
+            isExample,
+            points: isExample ? 0 : asNumber(item.points, 1),
+            questionNumber: asNumber(item.questionNumber, index + 1),
+        };
+    });
+    return {
+        content: '',
+        answer: {
+            title: asString(meta.title),
+            instruction: asString(meta.instruction, 'Look and match.'),
+            rightItems,
+            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 +543,9 @@ const handlers = {
     CHOOSE_THE_CORRECT_ANSWER_GROUP: reverseChooseTheCorrectAnswerGroup,
     ANSWER_THE_QUESTION_GROUP: reverseAnswerTheQuestionGroup,
     TRUE_FALSE_GROUP: reverseTrueFalseGroup,
+    TRUE_FALSE_CORRECT_GROUP: reverseTrueFalseCorrectGroup,
+    FILL_IN_BLANK_GROUP: reverseFillInBlankGroup,
+    MATCHING_WITH_LINES_GROUP: reverseMatchingWithLinesGroup,
     CROSS_OUT_WORD_GROUP: reverseCrossOutWordGroup,
     WORD_ORDER_AND_MATCH_GROUP: reverseWordOrderAndMatchGroup,
     WORD_ORDER_AND_MATCH: reverseWordOrderAndMatchGroup,
@@ -424,6 +563,7 @@ const handlers = {
     WORD_ORDERING: reverseSimpleAnswer,
     WORD_FILL_PARAGRAPH: reverseSimpleAnswer,
     MATCH_BY_WRITING_ANSWER: reverseGroupPayload,
+    MATCH_WORD_TO_PICTURE: reverseGroupPayload,
     WRITE_SHORT_PARAGRAPH: reverseWriteShortParagraph,
     WRITE_A_SHORT_LETTER: reverseWriteAShortLetter,
     WRITE_CORRECT_VERB_FORM: reverseSimpleAnswer,
@@ -454,6 +594,7 @@ function reverseWriteAShortLetter(apiQuestion) {
     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
@@ -471,6 +612,7 @@ function reverseWriteAShortLetter(apiQuestion) {
         instruction: asString(instructions.mainInstruction || instructions.instruction),
         informations,
         guideImages,
+        ...(passage ? { passage } : {}),
         contexts,
         minWords,
         maxWords,

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

@@ -13,6 +13,8 @@ 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 { transformFillInBlankGroup } from '../../../components/questions/types/fill-in-blank-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 +24,8 @@ 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 { transformMatchingWithLinesGroup } from '../../../components/questions/types/matching-with-lines-group/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 +66,8 @@ 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_GROUP: transformFillInBlankGroup,
     FILL_IN_BLANK: transformFillInBlank,
     WRITE_CORRECT_VERB_FORM: transformWriteCorrectVerbForm,
     CHOOSE_CORRECT_ADJECTIVE: transformChooseCorrectAdjective,
@@ -71,6 +77,8 @@ const questionTransformHandlers = {
     WORD_ORDERING: transformWordOrdering,
     WORD_FILL_PARAGRAPH: transformWordFillParagraph,
     MATCH_BY_WRITING_ANSWER: transformMatchByWritingAnswer,
+    MATCH_WORD_TO_PICTURE: transformMatchWordToPicture,
+    MATCHING_WITH_LINES_GROUP: transformMatchingWithLinesGroup,
     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' | 'FILL_IN_BLANK_GROUP' | 'MATCHING_WITH_LINES_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/fill-in-blank-group.d.ts

@@ -0,0 +1,45 @@
+export declare const FILL_IN_BLANK_ITEM_TYPE: "FILL_IN_BLANK";
+export interface FillInBlankGroupItemAnswer {
+    answers: string[][];
+    caseSensitive?: boolean;
+}
+export interface FillInBlankGroupItemContent {
+    question: string;
+    imageUrl?: string;
+    audioUrl?: string;
+    showHints?: boolean;
+    hints?: string[];
+}
+export interface FillInBlankGroupItem {
+    questionType?: typeof FILL_IN_BLANK_ITEM_TYPE;
+    isExample?: boolean;
+    content: FillInBlankGroupItemContent;
+    correctAnswer?: FillInBlankGroupItemAnswer;
+    points?: number;
+    questionNumber?: number;
+}
+export interface FillInBlankGroupContent {
+    meta?: {
+        instruction?: string;
+        audioUrl?: string;
+        imageUrl?: string;
+        showHints?: boolean;
+        hints?: string[];
+    };
+    items: FillInBlankGroupItem[];
+}
+export interface FillInBlankGroupCorrectAnswer {
+    answer: FillInBlankGroupItemAnswer[];
+}
+export interface FillInBlankGroupAPIPayload {
+    id?: string;
+    questionType: 'FILL_IN_BLANK_GROUP';
+    content: FillInBlankGroupContent;
+    correctAnswer: FillInBlankGroupCorrectAnswer;
+    points: number;
+    explanation?: string;
+    questionNumber: number;
+    partId?: string;
+    partNo?: number;
+}
+export type FillInBlankGroupLocalStorage = FillInBlankGroupAPIPayload;

package/dist/shared/types/questions/fill-in-blank-group.js

@@ -0,0 +1 @@
+export const FILL_IN_BLANK_ITEM_TYPE = 'FILL_IN_BLANK';

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

@@ -32,3 +32,7 @@ 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 './matching-with-lines-group';
+export * from './true-false-correct-group';
+export * from './fill-in-blank-group';

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

@@ -50,3 +50,11 @@ 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';
+// MATCHING_WITH_LINES_GROUP
+export * from './matching-with-lines-group';
+// TRUE_FALSE_CORRECT_GROUP
+export * from './true-false-correct-group';
+// FILL_IN_BLANK_GROUP
+export * from './fill-in-blank-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/matching-with-lines-group.d.ts

@@ -0,0 +1,39 @@
+export interface MatchingWithLinesRightItem {
+    id: string;
+    text: string;
+}
+export interface MatchingWithLinesGroupItemContent {
+    imageUrl: string;
+}
+export interface MatchingWithLinesGroupItem {
+    isExample?: boolean;
+    content: MatchingWithLinesGroupItemContent;
+    correctAnswer?: {
+        answer: string;
+    };
+    points?: number;
+    questionNumber?: number;
+}
+export interface MatchingWithLinesGroupContent {
+    meta?: {
+        instruction?: string;
+        title?: string;
+    };
+    rightItems: MatchingWithLinesRightItem[];
+    items: MatchingWithLinesGroupItem[];
+}
+export interface MatchingWithLinesGroupCorrectAnswer {
+    answer: string[];
+}
+export interface MatchingWithLinesGroupAPIPayload {
+    id?: string;
+    questionType: 'MATCHING_WITH_LINES_GROUP';
+    content: MatchingWithLinesGroupContent;
+    correctAnswer: MatchingWithLinesGroupCorrectAnswer;
+    points: number;
+    explanation?: string;
+    questionNumber: number;
+    partId?: string;
+    partNo?: number;
+}
+export type MatchingWithLinesGroupLocalStorage = MatchingWithLinesGroupAPIPayload;

package/dist/shared/types/questions/matching-with-lines-group.js

@@ -0,0 +1 @@
+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;

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

@@ -0,0 +1 @@
+export const TRUE_FALSE_CORRECT_ITEM_TYPE = 'TRUE_FALSE_CORRECT';