@tinyweb_dev/oe-exam-sdk 1.0.8 → 1.0.9

package/dist/components/questions/types/true-false-group/TrueFalseGroupClient.js

@@ -2,18 +2,28 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Check, CircleHelp, Lightbulb, Star, X } from 'lucide-react';
 import { cn } from '../../../../shared/lib/utils';
-export function TrueFalseGroupClient({ questionData, isReviewMode = false, userAnswers = [], }) {
+export function TrueFalseGroupClient({ questionData, isReviewMode = false, userAnswers = [], onAnswerChange, }) {
     const items = questionData.items || [];
+    const handleSelect = (itemIndex, value) => {
+        const item = items[itemIndex];
+        if (isReviewMode || item?.isExample || !onAnswerChange) {
+            return;
+        }
+        const next = items.map((_, index) => userAnswers[index]);
+        next[itemIndex] = value;
+        onAnswerChange(next);
+    };
     return (_jsxs("div", { className: "space-y-4", children: [questionData.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: questionData.instruction })), items.map((item, itemIndex) => {
-                const userValue = userAnswers[itemIndex];
+                const userValue = item.isExample ? item.correctAnswer : userAnswers[itemIndex];
                 const correctAnswer = item.correctAnswer;
+                const canSelect = !isReviewMode && !item.isExample && Boolean(onAnswerChange);
                 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-gradient-to-r from-gray-50 to-white px-3 py-2", children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx("div", { className: "flex h-7 w-7 items-center justify-center rounded-lg bg-gradient-to-br from-blue-500 to-indigo-600 text-white", children: _jsx(CircleHelp, { className: "h-3.5 w-3.5" }) }), _jsxs("span", { className: "text-sm font-medium text-gray-700", children: ["C\u00E2u ", item.questionNumber || itemIndex + 1] }), item.isExample && (_jsxs("span", { className: "inline-flex items-center gap-1 rounded-full bg-amber-100 px-2 py-0.5 text-xs font-semibold text-amber-700", children: [_jsx(Star, { className: "h-3 w-3" }), "Example"] }))] }), _jsxs("span", { className: "text-xs text-gray-500", children: [item.points || 0, " \u0111i\u1EC3m"] })] }), _jsxs("div", { className: "space-y-3 p-3", children: [_jsx("p", { className: "text-sm font-semibold leading-relaxed text-gray-800", children: item.question || 'Câu hỏi chưa được nhập' }), _jsx("div", { className: "flex items-center gap-3", children: [
                                         { value: true, label: 'True' },
                                         { value: false, label: 'False' },
                                     ].map((opt) => {
                                         const isCorrect = opt.value === correctAnswer;
                                         const isSelected = opt.value === userValue;
-                                        return (_jsxs("div", { className: cn('flex flex-1 items-center justify-center gap-2 rounded-lg border-2 px-4 py-2 text-sm font-semibold transition-colors', isReviewMode && isCorrect
+                                        return (_jsxs("button", { type: "button", disabled: !canSelect, onClick: () => handleSelect(itemIndex, opt.value), className: cn('flex flex-1 items-center justify-center gap-2 rounded-lg border-2 px-4 py-2 text-sm font-semibold transition-colors', canSelect ? 'cursor-pointer hover:border-blue-300' : 'cursor-default', isReviewMode && isCorrect
                                                 ? 'border-green-500 bg-green-50 text-green-700'
                                                 : isReviewMode && isSelected && !isCorrect
                                                     ? 'border-red-500 bg-red-50 text-red-700'

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

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

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

@@ -2,10 +2,17 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { AnswerTheQuestionGroupClient } from '../types/answer-the-question-group/AnswerTheQuestionGroupClient';
 import { mapQuestionToAnswerTheQuestionGroupData } from '../types/answer-the-question-group/map-answer-the-question-group-data';
-export function AnswerTheQuestionGroupViewer({ question, isReviewMode = false, userAnswer, }) {
+function readStringAnswers(value) {
+    if (Array.isArray(value)) {
+        return value.map((item) => String(item ?? ''));
+    }
+    if (value && typeof value === 'object' && Array.isArray(value.answer)) {
+        return value.answer.map((item) => String(item ?? ''));
+    }
+    return undefined;
+}
+export function AnswerTheQuestionGroupViewer({ question, isReviewMode = false, userAnswer, onSubmitAnswer, }) {
     const questionData = mapQuestionToAnswerTheQuestionGroupData(question);
-    const reviewAnswers = isReviewMode && !userAnswer
-        ? questionData.items.map((item) => item.expectedAnswers[0] || '')
-        : userAnswer;
-    return (_jsx(AnswerTheQuestionGroupClient, { questionData: questionData, isReviewMode: isReviewMode, userAnswers: reviewAnswers }));
+    const storedAnswers = readStringAnswers(userAnswer);
+    return (_jsx(AnswerTheQuestionGroupClient, { questionData: questionData, isReviewMode: isReviewMode, userAnswers: storedAnswers, onAnswerChange: isReviewMode ? undefined : onSubmitAnswer }));
 }

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

@@ -1,9 +1,10 @@
 import type { Question } from '../../../shared/types/entities/question.types';
-import type { ChooseThenAnswerStudentItemAnswer } from '../_shared/types/choose-then-answer-group.type';
-export declare function ChooseThenAnswerGroupViewer({ question, isReviewMode, userAnswer, onSubmitAnswer, }: {
+import type { ChooseThenAnswerGradeDetail, ChooseThenAnswerStudentItemAnswer } from '../_shared/types/choose-then-answer-group.type';
+export declare function ChooseThenAnswerGroupViewer({ question, isReviewMode, userAnswer, gradeDetails, onSubmitAnswer, }: {
     question: Question;
     isReviewMode?: boolean;
     userAnswer?: unknown;
+    gradeDetails?: ChooseThenAnswerGradeDetail[];
     onSubmitAnswer?: (answer: {
         answer: ChooseThenAnswerStudentItemAnswer[];
     }) => void;

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

@@ -2,7 +2,7 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { useState } from 'react';
 import { ChooseThenAnswerGroupClient } from '../types/choose-then-answer-group/ChooseThenAnswerGroupClient';
-import { mapQuestionToChooseThenAnswerGroupData, parseStudentAnswer, } from '../types/choose-then-answer-group/map-choose-then-answer-group-data';
+import { mapQuestionToChooseThenAnswerGroupData, parseStudentAnswer, toCtaItemResults, } from '../types/choose-then-answer-group/map-choose-then-answer-group-data';
 function readStudentAnswers(value, itemCount) {
     const record = value && typeof value === 'object' && !Array.isArray(value)
         ? value
@@ -16,7 +16,7 @@ function readStudentAnswers(value, itemCount) {
         return undefined;
     return Array.from({ length: itemCount }, (_, index) => parseStudentAnswer(raw[index]));
 }
-export function ChooseThenAnswerGroupViewer({ question, isReviewMode = false, userAnswer, onSubmitAnswer, }) {
+export function ChooseThenAnswerGroupViewer({ question, isReviewMode = false, userAnswer, gradeDetails, onSubmitAnswer, }) {
     const questionData = mapQuestionToChooseThenAnswerGroupData(question);
     const seed = questionData.items.map((item) => ({
         optionId: item.isExample ? item.optionId : '',
@@ -35,5 +35,6 @@ export function ChooseThenAnswerGroupViewer({ question, isReviewMode = false, us
         setLocalAnswers(updated);
         onSubmitAnswer?.({ answer: updated });
     };
-    return (_jsx(ChooseThenAnswerGroupClient, { questionData: questionData, isReviewMode: isReviewMode, userAnswers: isReviewMode && !parsedUser ? undefined : (parsedUser ?? localAnswers), onAnswerChange: isReviewMode ? undefined : handleChange }));
+    const displayedAnswers = isReviewMode && !parsedUser ? [] : (parsedUser ?? localAnswers);
+    return (_jsx(ChooseThenAnswerGroupClient, { questionData: questionData, isReviewMode: isReviewMode, userAnswers: isReviewMode && !parsedUser ? undefined : displayedAnswers, itemResults: toCtaItemResults(gradeDetails, questionData.items, displayedAnswers), onAnswerChange: isReviewMode ? undefined : handleChange }));
 }

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

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

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/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

@@ -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-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.8",
+  "version": "1.0.9",
   "description": "Reusable OceanEdu question components.",
   "type": "module",
   "main": "./dist/index.js",