@tinyweb_dev/oe-exam-sdk 1.0.7 → 1.0.9

package/dist/components/questions/viewer/CrossOutWordGroupViewer.js

@@ -2,7 +2,20 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { CrossOutWordGroupClient } from '../types/cross-out-word-group/CrossOutWordGroupClient';
 import { mapQuestionToCrossOutWordGroupData } from '../types/cross-out-word-group/map-cross-out-word-group-data';
-export function CrossOutWordGroupViewer({ question, isReviewMode = false, }) {
+function readCrossOutAnswers(value) {
+    if (Array.isArray(value)) {
+        return value;
+    }
+    if (value && typeof value === 'object' && Array.isArray(value.answer)) {
+        return value.answer;
+    }
+    return undefined;
+}
+export function CrossOutWordGroupViewer({ question, isReviewMode = false, userAnswer, onSubmitAnswer, }) {
     const questionData = mapQuestionToCrossOutWordGroupData(question);
-    return (_jsx(CrossOutWordGroupClient, { questionData: questionData, isReviewMode: isReviewMode, userAnswers: isReviewMode ? questionData.items.map((item) => item.correctAnswer) : [] }));
+    const storedAnswers = readCrossOutAnswers(userAnswer);
+    const userAnswers = isReviewMode && !storedAnswers
+        ? questionData.items.map((item) => item.correctAnswer)
+        : storedAnswers;
+    return (_jsx(CrossOutWordGroupClient, { questionData: questionData, isReviewMode: isReviewMode, userAnswers: userAnswers, onAnswerChange: isReviewMode ? undefined : onSubmitAnswer }));
 }

package/dist/components/questions/viewer/QuestionViewer.d.ts

@@ -4,6 +4,14 @@ interface QuestionViewerProps {
     onSubmitAnswer?: (answer: any) => void;
     isReviewMode?: boolean;
     userAnswer?: any;
+    gradeDetails?: Array<{
+        itemId: string;
+        isCorrect?: boolean;
+        userAnswer?: unknown;
+        correctAnswer?: unknown;
+        partialScore?: number;
+        feedback?: string;
+    }>;
 }
-export declare function QuestionViewer({ question, onSubmitAnswer, isReviewMode, userAnswer, }: QuestionViewerProps): import("react").JSX.Element;
+export declare function QuestionViewer({ question, onSubmitAnswer, isReviewMode, userAnswer, gradeDetails, }: QuestionViewerProps): import("react").JSX.Element;
 export {};

package/dist/components/questions/viewer/QuestionViewer.js

@@ -38,7 +38,7 @@ import { MatchWordToPictureViewer } from './MatchWordToPictureViewer';
 import { MatchWordToPictureGroupViewer } from './MatchWordToPictureGroupViewer';
 import { MatchColumnsToMakeSentencesViewer } from './MatchColumnsToMakeSentencesViewer';
 import { WordOrderingGroupViewer } from './WordOrderingGroupViewer';
-export function QuestionViewer({ question, onSubmitAnswer, isReviewMode = false, userAnswer, }) {
+export function QuestionViewer({ question, onSubmitAnswer, isReviewMode = false, userAnswer, gradeDetails, }) {
     const [selectedAnswer, setSelectedAnswer] = useState(userAnswer || null);
     const [playCount, setPlayCount] = useState(0);
     const audioRef = useRef(null);
@@ -477,6 +477,19 @@ export function QuestionViewer({ question, onSubmitAnswer, isReviewMode = false,
         }
         return (_jsxs("div", { className: "space-y-3", children: [content.title ? _jsx("h3", { className: "text-center text-lg font-bold uppercase text-slate-800", children: content.title }) : null, content.imageUrl ? (_jsx("div", { className: "flex justify-center", children: _jsx("img", { src: String(content.imageUrl), alt: "", className: "max-h-[180px] rounded-lg object-contain" }) })) : null, _jsx("div", { className: "space-y-2 text-base leading-relaxed text-slate-800", children: paragraph.split('\n').map((line, li) => (_jsx("div", { className: "flex flex-wrap items-baseline", children: renderLine(line, `wfp-${li}`) }, `wfp-l${li}`))) }), isReviewMode && correctAnswers.length > 0 ? (_jsxs("div", { className: "rounded-lg border border-emerald-200 bg-emerald-50/80 p-2.5 text-sm text-emerald-800", children: [_jsx("span", { className: "font-semibold", children: "\u0110\u00E1p \u00E1n: " }), correctAnswers.map((a, i) => (_jsxs("span", { className: "mr-2", children: ["(", i + 1, ") ", _jsx("span", { className: "font-bold underline", children: a || '—' })] }, `wfp-a${i}`)))] })) : null] }));
     };
+    const renderCrosswordPuzzle = () => {
+        const raw = userAnswer && typeof userAnswer === 'object' && !Array.isArray(userAnswer)
+            ? userAnswer
+            : {};
+        const answers = raw.answers && typeof raw.answers === 'object' && !Array.isArray(raw.answers)
+            ? raw.answers
+            : raw;
+        return (_jsx(CrosswordPuzzleClient, { content: question.content, correctAnswer: question.correctAnswer ?? question.answer, isReviewMode: isReviewMode, userAnswers: answers, onAnswerChange: isReviewMode
+                ? undefined
+                : (key, value) => {
+                    onSubmitAnswer?.({ answers: { ...answers, [key]: value } });
+                } }));
+    };
     const renderQuestion = () => {
         const resolvedType = String(question.type ||
             question.questionType ||
@@ -488,9 +501,9 @@ export function QuestionViewer({ question, onSubmitAnswer, isReviewMode = false,
             case 'CHOOSE_THE_CORRECT_ANSWER_GROUP':
                 return (_jsx(ChooseTheCorrectAnswerGroupViewer, { question: question, isReviewMode: isReviewMode, userAnswer: userAnswer, onSubmitAnswer: onSubmitAnswer }));
             case 'TRUE_FALSE_GROUP':
-                return (_jsx(TrueFalseGroupViewer, { question: question, isReviewMode: isReviewMode, userAnswer: userAnswer }));
+                return (_jsx(TrueFalseGroupViewer, { question: question, isReviewMode: isReviewMode, userAnswer: userAnswer, onSubmitAnswer: onSubmitAnswer }));
             case 'TRUE_FALSE_CORRECT_GROUP':
-                return (_jsx(TrueFalseCorrectGroupViewer, { question: question, isReviewMode: isReviewMode, userAnswer: userAnswer }));
+                return (_jsx(TrueFalseCorrectGroupViewer, { question: question, isReviewMode: isReviewMode, userAnswer: userAnswer, onSubmitAnswer: onSubmitAnswer }));
             case 'FILL_IN_BLANK_GROUP':
                 return (_jsx(FillInBlankGroupViewer, { question: question, isReviewMode: isReviewMode, userAnswer: userAnswer, onSubmitAnswer: onSubmitAnswer }));
             case 'MATCHING_WITH_LINES_GROUP':
@@ -498,11 +511,11 @@ export function QuestionViewer({ question, onSubmitAnswer, isReviewMode = false,
             case 'MATCH_COLUMNS_TO_MAKE_SENTENCES':
                 return (_jsx(MatchColumnsToMakeSentencesViewer, { question: question, isReviewMode: isReviewMode, userAnswer: userAnswer, onSubmitAnswer: onSubmitAnswer }));
             case 'CROSS_OUT_WORD_GROUP':
-                return (_jsx(CrossOutWordGroupViewer, { question: question, isReviewMode: isReviewMode }));
+                return (_jsx(CrossOutWordGroupViewer, { question: question, isReviewMode: isReviewMode, userAnswer: userAnswer, onSubmitAnswer: onSubmitAnswer }));
             case 'ANSWER_THE_QUESTION':
                 return (_jsx(AnswerTheQuestionViewer, { question: question, isReviewMode: isReviewMode, userAnswer: typeof userAnswer === 'string' ? userAnswer : undefined, onSubmitAnswer: onSubmitAnswer }));
             case 'ANSWER_THE_QUESTION_GROUP':
-                return (_jsx(AnswerTheQuestionGroupViewer, { question: question, isReviewMode: isReviewMode, userAnswer: userAnswer }));
+                return (_jsx(AnswerTheQuestionGroupViewer, { question: question, isReviewMode: isReviewMode, userAnswer: userAnswer, onSubmitAnswer: onSubmitAnswer }));
             case 'SPEAKING_CUE_CARD':
                 return (_jsx(SpeakingCueCardClient, { questionData: mapQuestionToSpeakingCueCardData(question), isReviewMode: isReviewMode }));
             case 'SPONTANEOUS_QA':
@@ -511,7 +524,7 @@ export function QuestionViewer({ question, onSubmitAnswer, isReviewMode = false,
                 return (_jsx(SpontaneousQaGroupViewer, { question: question, isReviewMode: isReviewMode }));
             case 'WORD_ORDER_AND_MATCH_GROUP':
             case 'WORD_ORDER_AND_MATCH':
-                return (_jsx(WordOrderAndMatchGroupViewer, { question: question, isReviewMode: isReviewMode, userAnswer: userAnswer }));
+                return (_jsx(WordOrderAndMatchGroupViewer, { question: question, isReviewMode: isReviewMode, userAnswer: userAnswer, onSubmitAnswer: onSubmitAnswer }));
             case 'WORD_ORDERING_GROUP':
                 return (_jsx(WordOrderingGroupViewer, { question: question, isReviewMode: isReviewMode, userAnswer: userAnswer, onSubmitAnswer: onSubmitAnswer }));
             case 'MATCH_WORD_TO_PICTURE_GROUP':
@@ -551,13 +564,13 @@ export function QuestionViewer({ question, onSubmitAnswer, isReviewMode = false,
             case 'WORD_FILL_STRUCTURED_FORM':
                 return (_jsx(WordFillStructuredFormViewer, { question: question, isReviewMode: isReviewMode, userAnswer: userAnswer, onSubmitAnswer: onSubmitAnswer }));
             case 'CROSSWORD_PUZZLE':
-                return (_jsx(CrosswordPuzzleClient, { content: question.content, correctAnswer: question.answer, isReviewMode: isReviewMode, userAnswers: userAnswer }));
+                return renderCrosswordPuzzle();
             case 'FIND_WORDS_IN_MATRIX':
-                return (_jsx(FindWordsInMatrixClient, { content: question.content, correctAnswer: question.answer, showSolution: isReviewMode }));
+                return (_jsx(FindWordsInMatrixClient, { content: question.content, correctAnswer: question.correctAnswer ?? question.answer, showSolution: isReviewMode, userAnswer: userAnswer, onAnswerChange: isReviewMode ? undefined : onSubmitAnswer }));
             case 'SORT_WORDS_INTO_CATEGORIES':
                 return (_jsx(SortWordsIntoCategoriesViewer, { question: question, isReviewMode: isReviewMode, userAnswer: userAnswer, onSubmitAnswer: onSubmitAnswer }));
             case 'CHOOSE_THEN_ANSWER_GROUP':
-                return (_jsx(ChooseThenAnswerGroupViewer, { question: question, isReviewMode: isReviewMode, userAnswer: userAnswer, onSubmitAnswer: onSubmitAnswer }));
+                return (_jsx(ChooseThenAnswerGroupViewer, { question: question, isReviewMode: isReviewMode, userAnswer: userAnswer, gradeDetails: gradeDetails, onSubmitAnswer: onSubmitAnswer }));
             default:
                 return _jsxs("div", { children: ["Lo\u1EA1i c\u00E2u h\u1ECFi kh\u00F4ng \u0111\u01B0\u1EE3c h\u1ED7 tr\u1EE3: ", question.type] });
         }

package/dist/components/questions/viewer/SpontaneousQaGroupViewer.js

@@ -1,82 +1,7 @@
 'use client';
-import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
-function isRecord(value) {
-    return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
-function asRecord(value) {
-    return isRecord(value) ? value : {};
-}
-function asString(value, fallback = '') {
-    return typeof value === 'string' ? value : fallback;
-}
-function mapItem(item, index) {
-    const record = asRecord(item);
-    const content = asRecord(record.content);
-    const correctAnswer = asRecord(record.correctAnswer);
-    const expected = Array.isArray(correctAnswer.expectedAnswers)
-        ? correctAnswer.expectedAnswers.map((value) => String(value ?? ''))
-        : [];
-    return {
-        questionText: asString(content.questionText) ||
-            asString(content.question) ||
-            asString(record.questionText),
-        audioUrl: asString(content.audioUrl) || undefined,
-        expectedAnswers: expected,
-        isExample: record.isExample === true,
-        points: typeof record.points === 'number' ? record.points : 1,
-        questionNumber: typeof record.questionNumber === 'number' ? record.questionNumber : index + 1,
-    };
-}
-function isNestedPart(item) {
-    const record = asRecord(item);
-    return Array.isArray(record.questions);
-}
-function resolveGroup(question) {
-    const content = asRecord(question.content);
-    const list = asRecord(question.spontaneousQAList ?? content.spontaneousQAList ?? content);
-    const itemsRaw = Array.isArray(list.items)
-        ? list.items
-        : Array.isArray(content.items)
-            ? content.items
-            : [];
-    const instruction = asString(asRecord(list.meta).instruction) ||
-        asString(asRecord(content.meta).instruction) ||
-        asString(question.explanation) ||
-        'Talk about the topic.';
-    if (itemsRaw.some(isNestedPart)) {
-        return {
-            instruction,
-            parts: itemsRaw.map((item, index) => {
-                const record = asRecord(item);
-                const questions = Array.isArray(record.questions)
-                    ? record.questions.map(mapItem)
-                    : [];
-                return {
-                    partNumber: typeof record.partNumber === 'number' ? record.partNumber : index + 1,
-                    partTitle: asString(record.partTitle) || `PART ${index + 1}`,
-                    topic: asString(record.topic),
-                    questions,
-                };
-            }),
-        };
-    }
-    return {
-        instruction,
-        parts: [
-            {
-                partNumber: 1,
-                partTitle: '',
-                topic: '',
-                questions: itemsRaw.map(mapItem),
-            },
-        ],
-    };
-}
-function QaPromptCard({ item, index, isReviewMode = false, }) {
-    return (_jsxs("div", { className: "overflow-hidden rounded-xl border border-gray-200 bg-white shadow-sm", children: [_jsxs("div", { className: "flex items-center justify-between border-b border-gray-100 bg-gray-50 px-4 py-2.5", children: [_jsxs("span", { className: "text-sm font-medium text-gray-700", children: ["C\u00E2u ", item.questionNumber || index + 1] }), _jsxs("span", { className: "text-xs text-gray-500", children: [item.points || 0, " \u0111i\u1EC3m"] })] }), _jsxs("div", { className: "space-y-2 p-4", children: [_jsx("p", { className: "text-sm font-semibold text-gray-800", children: item.questionText || 'Câu hỏi chưa được nhập' }), item.audioUrl ? (_jsxs("p", { className: "text-xs text-gray-500", children: ["Audio: ", item.audioUrl] })) : null, isReviewMode && item.expectedAnswers.length > 0 ? (_jsxs("div", { className: "rounded-lg border border-emerald-100 bg-emerald-50 px-3 py-2 text-sm text-emerald-800", children: [_jsx("p", { className: "mb-1 font-medium", children: "G\u1EE3i \u00FD \u0111\u00E1p \u00E1n" }), _jsx("ul", { className: "list-disc space-y-1 pl-4", children: item.expectedAnswers.map((answer) => (_jsx("li", { children: answer }, answer))) })] })) : null] })] }));
-}
+import { jsx as _jsx } from "react/jsx-runtime";
+import { SpontaneousQaGroupClient } from '../types/spontaneous-qa-group/SpontaneousQaGroupClient';
+import { mapQuestionToSpontaneousQaGroupData } from '../types/spontaneous-qa-group/map-spontaneous-qa-group-data';
 export function SpontaneousQaGroupViewer({ question, isReviewMode = false, }) {
-    const { instruction, parts } = resolveGroup(question);
-    const showPartChrome = parts.length > 1 || parts.some((part) => part.partTitle || part.topic);
-    return (_jsxs("div", { className: "space-y-5", children: [instruction ? (_jsx("div", { className: "rounded-xl border border-indigo-100 bg-indigo-50 px-4 py-3 text-sm font-medium text-indigo-800", children: instruction })) : null, parts.map((part) => (_jsxs("section", { className: "space-y-3", children: [showPartChrome ? (_jsxs("div", { children: [part.partTitle ? (_jsx("h3", { className: "text-base font-bold tracking-wide text-sky-600", children: part.partTitle })) : null, part.topic ? (_jsx("p", { className: "text-sm font-semibold text-slate-600", children: part.topic })) : null] })) : null, _jsx("div", { className: "space-y-3", children: part.questions.map((item, index) => (_jsx(QaPromptCard, { item: item, index: index, isReviewMode: isReviewMode }, `${part.partNumber}-${item.questionNumber}-${index}`))) })] }, `part-${part.partNumber}`)))] }));
+    return (_jsx(SpontaneousQaGroupClient, { questionData: mapQuestionToSpontaneousQaGroupData(question), isReviewMode: isReviewMode }));
 }

package/dist/components/questions/viewer/TrueFalseCorrectGroupViewer.d.ts

@@ -3,7 +3,8 @@ import type { TrueFalseCorrectStudentItemAnswer } from '../_shared/types/true-fa
 type TrueFalseCorrectGroupViewerProps = {
     question: Question;
     isReviewMode?: boolean;
-    userAnswer?: TrueFalseCorrectStudentItemAnswer[];
+    userAnswer?: unknown;
+    onSubmitAnswer?: (answer: TrueFalseCorrectStudentItemAnswer[]) => void;
 };
-export declare function TrueFalseCorrectGroupViewer({ question, isReviewMode, userAnswer, }: TrueFalseCorrectGroupViewerProps): import("react").JSX.Element;
+export declare function TrueFalseCorrectGroupViewer({ question, isReviewMode, userAnswer, onSubmitAnswer, }: TrueFalseCorrectGroupViewerProps): import("react").JSX.Element;
 export {};

package/dist/components/questions/viewer/TrueFalseCorrectGroupViewer.js

@@ -2,13 +2,23 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { TrueFalseCorrectGroupClient } from '../types/true-false-correct-group/TrueFalseCorrectGroupClient';
 import { mapQuestionToTrueFalseCorrectGroupData } from '../types/true-false-correct-group/map-true-false-correct-group-data';
-export function TrueFalseCorrectGroupViewer({ question, isReviewMode = false, userAnswer, }) {
+function readStudentAnswers(value) {
+    if (Array.isArray(value)) {
+        return value;
+    }
+    if (value && typeof value === 'object' && Array.isArray(value.answer)) {
+        return value.answer;
+    }
+    return undefined;
+}
+export function TrueFalseCorrectGroupViewer({ question, isReviewMode = false, userAnswer, onSubmitAnswer, }) {
     const questionData = mapQuestionToTrueFalseCorrectGroupData(question);
-    const reviewAnswers = isReviewMode && !userAnswer
+    const storedAnswers = readStudentAnswers(userAnswer);
+    const reviewAnswers = isReviewMode && !storedAnswers
         ? questionData.items.map((item) => ({
             isTrue: item.isTrue,
             correction: item.correction,
         }))
-        : userAnswer;
-    return (_jsx(TrueFalseCorrectGroupClient, { questionData: questionData, isReviewMode: isReviewMode, userAnswers: reviewAnswers }));
+        : storedAnswers;
+    return (_jsx(TrueFalseCorrectGroupClient, { questionData: questionData, isReviewMode: isReviewMode, userAnswers: reviewAnswers, onAnswerChange: isReviewMode ? undefined : onSubmitAnswer }));
 }

package/dist/components/questions/viewer/TrueFalseGroupViewer.d.ts

@@ -2,7 +2,10 @@ import type { Question } from '../../../shared/types/entities/question.types';
 type TrueFalseGroupViewerProps = {
     question: Question;
     isReviewMode?: boolean;
-    userAnswer?: boolean[];
+    userAnswer?: boolean[] | {
+        answer?: boolean[];
+    };
+    onSubmitAnswer?: (answer: boolean[]) => void;
 };
-export declare function TrueFalseGroupViewer({ question, isReviewMode, userAnswer, }: TrueFalseGroupViewerProps): import("react").JSX.Element;
+export declare function TrueFalseGroupViewer({ question, isReviewMode, userAnswer, onSubmitAnswer, }: TrueFalseGroupViewerProps): import("react").JSX.Element;
 export {};

package/dist/components/questions/viewer/TrueFalseGroupViewer.js

@@ -2,10 +2,20 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { TrueFalseGroupClient } from '../types/true-false-group/TrueFalseGroupClient';
 import { mapQuestionToTrueFalseGroupData } from '../types/true-false-group/map-true-false-group-data';
-export function TrueFalseGroupViewer({ question, isReviewMode = false, userAnswer, }) {
+function readBooleanAnswers(value) {
+    if (Array.isArray(value)) {
+        return value;
+    }
+    if (value && typeof value === 'object' && Array.isArray(value.answer)) {
+        return value.answer;
+    }
+    return undefined;
+}
+export function TrueFalseGroupViewer({ question, isReviewMode = false, userAnswer, onSubmitAnswer, }) {
     const questionData = mapQuestionToTrueFalseGroupData(question);
-    const reviewAnswers = isReviewMode && !userAnswer
+    const storedAnswers = readBooleanAnswers(userAnswer);
+    const reviewAnswers = isReviewMode && !storedAnswers
         ? questionData.items.map((item) => item.correctAnswer)
-        : userAnswer;
-    return (_jsx(TrueFalseGroupClient, { questionData: questionData, isReviewMode: isReviewMode, userAnswers: reviewAnswers }));
+        : storedAnswers;
+    return (_jsx(TrueFalseGroupClient, { questionData: questionData, isReviewMode: isReviewMode, userAnswers: reviewAnswers, onAnswerChange: isReviewMode ? undefined : onSubmitAnswer }));
 }

package/dist/components/questions/viewer/WordOrderAndMatchGroupViewer.d.ts

@@ -1,6 +1,10 @@
 import type { Question } from '../../../shared/types/entities/question.types';
-export declare function WordOrderAndMatchGroupViewer({ question, isReviewMode, userAnswer, }: {
+export declare function WordOrderAndMatchGroupViewer({ question, isReviewMode, userAnswer, onSubmitAnswer, }: {
     question: Question;
     isReviewMode?: boolean;
-    userAnswer?: any;
+    userAnswer?: unknown;
+    onSubmitAnswer?: (answer: Array<{
+        orderedPhrase: string;
+        matchLabel: string;
+    }>) => void;
 }): import("react").JSX.Element;

package/dist/components/questions/viewer/WordOrderAndMatchGroupViewer.js

@@ -76,20 +76,40 @@ function resolveGroup(question) {
         items: itemsRaw.map((item, idx) => mapItem(item, idx, answersRaw[idx])),
     };
 }
-export function WordOrderAndMatchGroupViewer({ question, isReviewMode = false, userAnswer, }) {
+function readMatchAnswers(value) {
+    if (Array.isArray(value)) {
+        return value;
+    }
+    if (value && typeof value === 'object' && Array.isArray(value.answer)) {
+        return value.answer;
+    }
+    return undefined;
+}
+export function WordOrderAndMatchGroupViewer({ question, isReviewMode = false, userAnswer, onSubmitAnswer, }) {
     const { instruction, matchOptions, items } = resolveGroup(question);
     const questionData = {
         instruction,
         matchOptions,
         items,
     };
-    const autoUserAnswers = isReviewMode
+    const storedAnswers = readMatchAnswers(userAnswer);
+    const autoUserAnswers = isReviewMode && !storedAnswers
         ? items.map((item) => ({
             orderedPhrase: item.orderedPhrase,
             matchLabel: item.matchLabel,
         }))
-        : Array.isArray(userAnswer)
-            ? userAnswer
-            : undefined;
-    return (_jsx(WordOrderAndMatchGroupClient, { questionData: questionData, isReviewMode: isReviewMode, userAnswers: autoUserAnswers }));
+        : storedAnswers;
+    return (_jsx(WordOrderAndMatchGroupClient, { questionData: questionData, isReviewMode: isReviewMode, userAnswers: autoUserAnswers, onAnswerChange: isReviewMode
+            ? undefined
+            : (itemIndex, next) => {
+                const current = items.map((_, index) => {
+                    const existing = storedAnswers?.[index];
+                    return {
+                        orderedPhrase: existing?.orderedPhrase || '',
+                        matchLabel: existing?.matchLabel || '',
+                    };
+                });
+                current[itemIndex] = next;
+                onSubmitAnswer?.(current);
+            } }));
 }

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

@@ -31,6 +31,6 @@ export function ReviewAnswerTheQuestionGroupRenderer({ partNumber, partName, que
                                             ? 'border-red-200 bg-red-50 text-red-800'
                                             : 'border-gray-200 bg-gray-50 text-gray-700'}`, children: question.isExample
                                         ? (question.exampleAnswer || '(Câu mẫu)')
-                                        : (studentAnswer || '(Chưa trả lời)') }), expectedAnswers.length > 0 && (_jsxs("div", { className: "space-y-1", children: [_jsx("p", { className: "text-xs font-medium text-gray-500", children: "\u0110\u00E1p \u00E1n m\u1EABu (AI)" }), _jsx("ul", { className: "list-disc space-y-1 pl-5 text-sm text-gray-700", children: expectedAnswers.map((answer) => (_jsx("li", { children: answer }, answer))) })] })), feedback && (_jsx("p", { className: "text-xs text-violet-700", children: feedback }))] })] }, question.id));
+                                        : (studentAnswer || '(Chưa trả lời)') }), expectedAnswers.length > 0 && (_jsxs("div", { className: "space-y-1", children: [_jsx("p", { className: "text-xs font-medium text-gray-500", children: "\u0110\u00E1p \u00E1n" }), _jsx("ul", { className: "list-disc space-y-1 pl-5 text-sm text-gray-700", children: expectedAnswers.map((answer) => (_jsx("li", { children: answer }, answer))) })] })), feedback && (_jsx("p", { className: "text-xs text-violet-700", children: feedback }))] })] }, question.id));
             })] }));
 }

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

@@ -231,7 +231,7 @@ const reverseChooseTheCorrectAnswerGroup = (apiQuestion) => {
         });
         const isExample = item.isExample === true;
         const imageUrl = normalizeChooseAnswerGroupImageUrl(itemContent.imageUrl);
-        const audioUrl = asString(itemContent.audioUrl).trim();
+        const audioUrl = normalizeChooseAnswerGroupImageUrl(itemContent.audioUrl);
         return {
             question: asString(itemContent.question),
             optionType: asString(itemContent.optionType, 'text') === 'image' ? 'image' : 'text',
@@ -251,17 +251,17 @@ const reverseChooseTheCorrectAnswerGroup = (apiQuestion) => {
             points: isExample ? 0 : asNumber(item.points, 1),
             questionNumber: asNumber(item.questionNumber, index + 1),
             ...(imageUrl !== undefined ? { imageUrl } : {}),
-            ...(audioUrl ? { audioUrl } : {}),
+            ...(audioUrl !== undefined ? { audioUrl } : {}),
         };
     });
-    const audioUrl = asString(asRecord(content.meta).audioUrl).trim();
+    const audioUrl = normalizeChooseAnswerGroupImageUrl(asRecord(content.meta).audioUrl);
     const imageUrl = normalizeChooseAnswerGroupImageUrl(asRecord(content.meta).imageUrl);
     return {
         content: '',
         answer: {
             instruction: asString(asRecord(content.meta).instruction, 'Choose the correct answer.'),
             passage: asString(asRecord(content.meta).passage),
-            ...(audioUrl ? { audioUrl } : {}),
+            ...(audioUrl !== undefined ? { audioUrl } : {}),
             ...(imageUrl !== undefined ? { imageUrl } : {}),
             items,
             explanation: asString(apiQuestion.explanation),
@@ -315,6 +315,7 @@ const reverseAnswerTheQuestionGroup = (apiQuestion) => {
             items,
             explanation: asString(apiQuestion.explanation),
             points: items.reduce((total, item) => (item.isExample ? total : total + item.points), 0),
+            ...(meta.gradingType === 'MAPPING' ? { gradingType: 'MAPPING' } : {}),
         },
     };
 };
@@ -404,6 +405,13 @@ const reverseChooseThenAnswerGroup = (apiQuestion) => {
             question: asString(itemContent.question),
             options,
             optionId: asString(rawAnswer.optionId) || options[0]?.id || '',
+            expectedAnswers: (() => {
+                const raw = asArray(rawAnswer.expectedAnswers)
+                    .filter((value) => typeof value === 'string')
+                    .map((value) => value.trim())
+                    .filter((value) => value !== '');
+                return raw.length > 0 ? raw : [''];
+            })(),
             isExample,
             points: isExample ? 0 : asNumber(item.points, 1),
             questionNumber: asNumber(item.questionNumber, index + 1),

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

@@ -1,4 +1,8 @@
-export declare const ANSWER_THE_QUESTION_GROUP_GRADING_TYPE: "AI";
+export declare const ANSWER_THE_QUESTION_GROUP_GRADING_TYPES: readonly ["AI", "MAPPING"];
+export type AnswerTheQuestionGroupGradingType = (typeof ANSWER_THE_QUESTION_GROUP_GRADING_TYPES)[number];
+/** Default for newly created groups. */
+export declare const ANSWER_THE_QUESTION_GROUP_GRADING_TYPE: AnswerTheQuestionGroupGradingType;
+export declare function resolveAnswerTheQuestionGroupGradingType(value: unknown): AnswerTheQuestionGroupGradingType;
 export interface AnswerTheQuestionGroupItemContent {
     question: string;
     imageUrl?: string | string[];
@@ -20,8 +24,9 @@ export interface AnswerTheQuestionGroupContent {
         passage?: string;
         audioUrl?: string;
         imageUrl?: string | string[];
-        gradingType: typeof ANSWER_THE_QUESTION_GROUP_GRADING_TYPE;
-        isAiGraded: true;
+        /** AI = LLM short-answer; MAPPING = exact-match expectedAnswers. */
+        gradingType: AnswerTheQuestionGroupGradingType;
+        isAiGraded: boolean;
     };
     items: AnswerTheQuestionGroupItem[];
 }

package/dist/shared/types/questions/answer-the-question-group.js

@@ -1 +1,6 @@
+export const ANSWER_THE_QUESTION_GROUP_GRADING_TYPES = ['AI', 'MAPPING'];
+/** Default for newly created groups. */
 export const ANSWER_THE_QUESTION_GROUP_GRADING_TYPE = 'AI';
+export function resolveAnswerTheQuestionGroupGradingType(value) {
+    return value === 'MAPPING' ? 'MAPPING' : 'AI';
+}

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

@@ -24,7 +24,7 @@ export interface ChooseTheCorrectAnswerGroupContent {
     meta?: {
         instruction?: string;
         passage?: string;
-        audioUrl?: string;
+        audioUrl?: string | string[];
         imageUrl?: string | string[];
     };
     items: ChooseTheCorrectAnswerGroupItem[];

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

@@ -4,6 +4,7 @@ export interface ChooseThenAnswerOption {
 }
 export interface ChooseThenAnswerItemAnswer {
     optionId: string;
+    expectedAnswers?: string[];
 }
 export interface ChooseThenAnswerStudentItemAnswer {
     optionId: string;
@@ -27,6 +28,8 @@ export interface ChooseThenAnswerGroupContent {
     meta?: {
         instruction?: string;
         title?: string;
+        gradingType?: 'AI';
+        isAiGraded?: boolean;
     };
     items: ChooseThenAnswerGroupItem[];
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tinyweb_dev/oe-exam-sdk",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "description": "Reusable OceanEdu question components.",
   "type": "module",
   "main": "./dist/index.js",