@tinyweb_dev/oe-exam-sdk 0.1.29 → 0.1.31

package/dist/components/questions/types/answer-the-question-group/map-answer-the-question-group-data.d.ts

@@ -0,0 +1,4 @@
+import type { AnswerTheQuestionGroupData, AnswerTheQuestionGroupItemData } from '../../_shared/types/answer-the-question-group.type';
+export declare function createEmptyAnswerTheQuestionGroupItem(questionNumber: number): AnswerTheQuestionGroupItemData;
+export declare function mapAnswerTheQuestionGroupItem(item: unknown, index: number, fallbackAnswers?: string[]): AnswerTheQuestionGroupItemData;
+export declare function mapQuestionToAnswerTheQuestionGroupData(question: Record<string, unknown> | null | undefined): AnswerTheQuestionGroupData;

package/dist/components/questions/types/answer-the-question-group/map-answer-the-question-group-data.js

@@ -0,0 +1,83 @@
+const DEFAULT_INSTRUCTION = 'Read the text again and answer the questions.';
+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 normalizeExpectedAnswers(value) {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    return value
+        .filter((item) => typeof item === 'string')
+        .map((item) => item.trim())
+        .filter((item) => item !== '');
+}
+export function createEmptyAnswerTheQuestionGroupItem(questionNumber) {
+    return {
+        question: '',
+        expectedAnswers: [''],
+        isExample: false,
+        points: 1,
+        questionNumber,
+    };
+}
+export function mapAnswerTheQuestionGroupItem(item, index, fallbackAnswers) {
+    const record = asRecord(item);
+    const content = asRecord(record.content);
+    const correctAnswer = asRecord(record.correctAnswer);
+    const isExample = record.isExample === true;
+    const nested = normalizeExpectedAnswers(correctAnswer.expectedAnswers);
+    const expectedAnswers = nested.length > 0
+        ? nested
+        : (normalizeExpectedAnswers(fallbackAnswers).length > 0
+            ? normalizeExpectedAnswers(fallbackAnswers)
+            : ['']);
+    return {
+        question: asString(content.question) || asString(record.question),
+        expectedAnswers,
+        isExample,
+        points: isExample ? 0 : (typeof record.points === 'number' ? record.points : 1),
+        questionNumber: typeof record.questionNumber === 'number' ? record.questionNumber : index + 1,
+    };
+}
+export function mapQuestionToAnswerTheQuestionGroupData(question) {
+    const source = asRecord(question);
+    const content = asRecord(source.content);
+    const answer = asRecord(source.answer);
+    const correctAnswer = asRecord(source.correctAnswer ?? source.correct_answer ?? answer.correctAnswer);
+    const explanation = String(source.explanation || answer.explanation || '');
+    const fallbackAnswers = Array.isArray(correctAnswer.answer)
+        ? correctAnswer.answer
+        : [];
+    if (Array.isArray(content.items)) {
+        const items = content.items.map((item, index) => mapAnswerTheQuestionGroupItem(item, index, fallbackAnswers[index]?.expectedAnswers));
+        return {
+            instruction: asString(asRecord(content.meta).instruction) || DEFAULT_INSTRUCTION,
+            passage: asString(asRecord(content.meta).passage),
+            items,
+            explanation,
+            points: items.reduce((total, item) => (item.isExample ? total : total + (item.points || 0)), 0),
+        };
+    }
+    if (Array.isArray(answer.items)) {
+        return {
+            instruction: asString(answer.instruction, DEFAULT_INSTRUCTION),
+            passage: asString(answer.passage),
+            items: answer.items,
+            explanation,
+            points: typeof answer.points === 'number' ? answer.points : 1,
+        };
+    }
+    return {
+        instruction: DEFAULT_INSTRUCTION,
+        passage: '',
+        items: [createEmptyAnswerTheQuestionGroupItem(1)],
+        explanation,
+        points: 1,
+    };
+}

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

@@ -0,0 +1,2 @@
+import type { QuestionTypeRegistration } from '../../creator/question-type-registry';
+export declare const answerTheQuestionGroupRegistration: QuestionTypeRegistration;

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

@@ -0,0 +1,36 @@
+import { AnswerTheQuestionGroupCreator } from './AnswerTheQuestionGroupCreator';
+import { mapQuestionToAnswerTheQuestionGroupData } from './map-answer-the-question-group-data';
+export const answerTheQuestionGroupRegistration = {
+    component: AnswerTheQuestionGroupCreator,
+    transformInitialData: (initialData) => mapQuestionToAnswerTheQuestionGroupData(initialData),
+    getExtraProps: (ctx) => ({
+        onUnsavedChangesChange: ctx.onUnsavedChangesChange,
+        validationRef: ctx.validationRef,
+    }),
+    wrapOnSave: (data, ctx) => {
+        const payload = data;
+        return {
+            type: ctx.questionType,
+            content: ctx.state.content,
+            points: payload.points ?? ctx.state.points ?? 1,
+            level: ctx.state.level,
+            difficulty: ctx.state.difficulty,
+            skill: ctx.state.skill,
+            answer: payload,
+            explanation: payload.explanation || '',
+        };
+    },
+    wrapOnChange: (data, ctx) => {
+        const payload = data;
+        return {
+            type: ctx.questionType,
+            content: ctx.state.content,
+            points: payload.points ?? ctx.state.points ?? 1,
+            level: ctx.state.level,
+            difficulty: ctx.state.difficulty,
+            skill: ctx.state.skill,
+            answer: payload,
+            explanation: payload.explanation || '',
+        };
+    },
+};

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

@@ -0,0 +1,2 @@
+import type { TransformHandler } from '../../../../shared/lib/utils/question-transform-types';
+export declare const transformAnswerTheQuestionGroup: TransformHandler;

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

@@ -0,0 +1,72 @@
+const CHILD_QUESTION_TYPE = 'ANSWER_THE_QUESTION';
+const GRADING_TYPE = 'AI';
+const DEFAULT_INSTRUCTION = 'Read the text again and answer the questions.';
+function normalizeExpectedAnswers(value) {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    return value
+        .filter((item) => typeof item === 'string')
+        .map((item) => item.trim())
+        .filter((item) => item !== '');
+}
+function sumGradablePoints(items) {
+    return items.reduce((total, item) => {
+        if (item.isExample) {
+            return total;
+        }
+        const points = typeof item.points === 'number' ? item.points : 1;
+        return total + points;
+    }, 0);
+}
+function isContentEmpty(html) {
+    return !html || html === '<p></p>' || html === '<p><br></p>' || html.trim() === '';
+}
+export const transformAnswerTheQuestionGroup = (question) => {
+    const answerData = question.answer;
+    const items = Array.isArray(answerData?.items) ? answerData.items : [];
+    if (items.length === 0) {
+        return {
+            apiContent: {
+                meta: {
+                    instruction: DEFAULT_INSTRUCTION,
+                    gradingType: GRADING_TYPE,
+                    isAiGraded: true,
+                },
+                items: [],
+            },
+            apiCorrectAnswer: { answer: [] },
+        };
+    }
+    const apiItems = items.map((item, index) => {
+        const expectedAnswers = normalizeExpectedAnswers(item.expectedAnswers);
+        return {
+            questionType: CHILD_QUESTION_TYPE,
+            ...(item.isExample ? { isExample: true } : {}),
+            content: {
+                question: item.question || '',
+            },
+            correctAnswer: { expectedAnswers },
+            points: item.isExample ? 0 : (typeof item.points === 'number' ? item.points : 1),
+            questionNumber: item.questionNumber || index + 1,
+        };
+    });
+    const passage = answerData?.passage?.trim();
+    return {
+        apiContent: {
+            meta: {
+                instruction: answerData?.instruction || DEFAULT_INSTRUCTION,
+                ...(!isContentEmpty(passage) ? { passage } : {}),
+                gradingType: GRADING_TYPE,
+                isAiGraded: true,
+            },
+            items: apiItems,
+        },
+        apiCorrectAnswer: {
+            answer: apiItems.map((item) => ({
+                expectedAnswers: item.correctAnswer.expectedAnswers,
+            })),
+        },
+        totalPoints: sumGradablePoints(items),
+    };
+};

package/dist/components/questions/types/speaking-conversation/SpeakingConversationPreviewClient.js

@@ -23,7 +23,7 @@ function PreviewImageItem({ url, label }) {
                 // eslint-disable-next-line @next/next/no-img-element
                 _jsx("img", { src: previewUrl, alt: label || 'Image', className: "w-full h-full object-cover" })) : (_jsx("div", { className: "w-full h-full flex items-center justify-center text-gray-300 text-xs", children: "\u0110ang t\u1EA3i..." })) }), label && _jsx("span", { className: "text-xs text-center text-gray-600 font-medium", children: label })] }));
 }
-export function SpeakingConversationPreviewClient({ questionData, isReviewMode = true, }) {
+export function SpeakingConversationPreviewClient({ questionData, isReviewMode = false, }) {
     const isPartnerQuestion = questionData.responder === 'PARTNER';
     const hasImages = questionData.images && questionData.images.length > 0;
     const gridCols = !hasImages || questionData.images.length <= 2

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

@@ -343,7 +343,7 @@ export function QuestionViewer({ question, onSubmitAnswer, isReviewMode = false,
             regionNodes: answer?.regionNodes || [],
             instructions: answer?.instructions || [],
         };
-        return (_jsx(ReadAndColorObjectsClient, { questionData: questionData, onSubmit: (userConnections) => {
+        return (_jsx(ReadAndColorObjectsClient, { questionData: questionData, isReviewMode: isReviewMode, onSubmit: (userConnections) => {
                 setSelectedAnswer(userConnections);
                 onSubmitAnswer?.(userConnections);
             } }));
@@ -600,7 +600,7 @@ export function QuestionViewer({ question, onSubmitAnswer, isReviewMode = false,
             case 'CROSS_OUT_WORD_GROUP':
                 return (_jsx(CrossOutWordGroupViewer, { question: question, isReviewMode: isReviewMode }));
             case 'SPONTANEOUS_QA_GROUP':
-                return _jsx(SpontaneousQaGroupViewer, { question: question });
+                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 }));

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

@@ -72,11 +72,11 @@ function resolveGroup(question) {
         ],
     };
 }
-function QaPromptCard({ item, index }) {
-    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, 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] })] }));
+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] })] }));
 }
-export function SpontaneousQaGroupViewer({ question, isReviewMode, }) {
+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 }, `${part.partNumber}-${item.questionNumber}-${index}`))) })] }, `part-${part.partNumber}`)))] }));
+    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}`)))] }));
 }

package/dist/components/results/ReviewQuestionRenderer.js

@@ -34,6 +34,7 @@ function renderQuestionBody({ part, reviewData, hidePerQuestionGrading = false,
         correctAnswerTextMap: reviewData.correctAnswerTextMap,
         correctOptionIdMap: reviewData.correctOptionIdMap,
         rawCorrectAnswerMap: reviewData.rawCorrectAnswerMap,
+        rawStudentAnswerMap: reviewData.rawStudentAnswerMap,
         questionScoreMap: reviewData.questionScoreMap,
         hidePerQuestionGrading,
     });

package/dist/components/results/renderers/ReviewAnswerTheQuestionGroupRenderer.d.ts

@@ -0,0 +1,19 @@
+import type { AnswerTheQuestionQuestion } from '../../../components/exams/take/utils/question-transformers';
+export interface ReviewAnswerTheQuestionGroupItemMeta {
+    expectedAnswers: string[];
+    isCorrect: boolean | null;
+    feedbackEn?: string;
+    feedbackVi?: string;
+}
+interface ReviewAnswerTheQuestionGroupRendererProps {
+    partNumber: number;
+    partName?: string;
+    questionCount: number;
+    instruction: string;
+    groupContent?: string;
+    questions: AnswerTheQuestionQuestion[];
+    answers: Record<string, string>;
+    itemMeta: Record<string, ReviewAnswerTheQuestionGroupItemMeta>;
+}
+export declare function ReviewAnswerTheQuestionGroupRenderer({ partNumber, partName, questionCount, instruction, groupContent, questions, answers, itemMeta, }: ReviewAnswerTheQuestionGroupRendererProps): import("react").JSX.Element;
+export {};

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

@@ -0,0 +1,27 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { BookOpen, Check, Sparkles, Star, X } from 'lucide-react';
+import CambridgeYlePartBanner from '../../../components/themes/cambridge-yle/CambridgeYlePartBanner';
+import CambridgeYleInstructionBanner from '../../../components/themes/cambridge-yle/CambridgeYleInstructionBanner';
+export function ReviewAnswerTheQuestionGroupRenderer({ partNumber, partName, questionCount, instruction, groupContent, questions, answers, itemMeta, }) {
+    return (_jsxs("div", { className: "space-y-4", children: [_jsx(CambridgeYlePartBanner, { partNumber: partNumber, partName: partName, questionCount: questionCount }), _jsx(CambridgeYleInstructionBanner, { instruction: instruction }), groupContent && (_jsxs("div", { className: "rounded-xl border border-gray-200 bg-white p-5 shadow-xs", children: [_jsxs("div", { className: "mb-2.5 flex items-center gap-2 text-xs font-bold uppercase tracking-wider text-indigo-700", children: [_jsx(BookOpen, { className: "h-4 w-4" }), _jsx("span", { children: "B\u00E0i \u0111\u1ECDc (Reading Passage)" })] }), _jsx("div", { className: "prose prose-sm max-w-none leading-relaxed text-gray-800", dangerouslySetInnerHTML: { __html: groupContent } })] })), questions.map((question) => {
+                const meta = itemMeta[question.id];
+                const studentAnswer = answers[question.id] || '';
+                const expectedAnswers = meta?.expectedAnswers || [];
+                const isCorrect = question.isExample ? true : meta?.isCorrect;
+                const feedback = meta?.feedbackVi || meta?.feedbackEn;
+                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-4 py-2.5", children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx("span", { className: `flex h-7 w-7 items-center justify-center rounded-full text-sm font-bold text-white ${question.isExample
+                                                ? 'bg-orange-400'
+                                                : isCorrect === true
+                                                    ? 'bg-green-500'
+                                                    : isCorrect === false
+                                                        ? 'bg-red-500'
+                                                        : 'bg-blue-500'}`, children: question.questionNumber }), _jsxs("span", { className: "text-sm font-medium text-gray-700", children: ["C\u00E2u ", question.questionNumber] }), question.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: "inline-flex items-center gap-1 rounded-full bg-violet-100 px-2 py-0.5 text-xs font-semibold text-violet-700", children: [_jsx(Sparkles, { className: "h-3 w-3" }), "AI"] })] }), isCorrect === true && _jsx(Check, { className: "h-4 w-4 text-green-600" }), isCorrect === false && _jsx(X, { className: "h-4 w-4 text-red-600" })] }), _jsxs("div", { className: "space-y-3 p-4", children: [_jsx("p", { className: "text-sm font-semibold leading-relaxed text-gray-800", children: question.question }), _jsx("div", { className: `rounded-lg border px-3 py-2 text-sm ${isCorrect === true
+                                        ? 'border-green-200 bg-green-50 text-green-800'
+                                        : isCorrect === false
+                                            ? '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));
+            })] }));
+}

package/dist/components/results/renderers/review-question-body-dedicated.d.ts

@@ -6,6 +6,7 @@ export interface DedicatedBodyContext {
     correctAnswerTextMap: Record<string, string>;
     correctOptionIdMap: Record<string, string>;
     rawCorrectAnswerMap: Record<string, unknown>;
+    rawStudentAnswerMap: Record<string, unknown>;
     questionScoreMap: Record<string, {
         score: number | null;
         maxScore: number;

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

@@ -4,8 +4,9 @@ import { jsx as _jsx } from "react/jsx-runtime";
  * Dedicated review renderer cases for ReviewQuestionRenderer.
  * Source: oe-exam-fe ReviewQuestionRenderer.tsx
  */
-import { transformChooseCorrectAdjective, transformChooseCorrectAnswer, transformChooseTheCorrectAnswerGroup, transformColorObjects, transformFillInBlank, transformWriteCorrectVerbForm, } from '../../../components/exams/take/utils/question-transformers';
+import { transformAnswerTheQuestionGroup, transformChooseCorrectAdjective, transformChooseCorrectAnswer, transformChooseTheCorrectAnswerGroup, transformColorObjects, transformFillInBlank, transformWriteCorrectVerbForm, } from '../../../components/exams/take/utils/question-transformers';
 import { normalizeColoringAssignments } from '../../../components/exams/take/utils/coloring-assignments';
+import { ReviewAnswerTheQuestionGroupRenderer } from './ReviewAnswerTheQuestionGroupRenderer';
 import { ReviewChooseAdjectiveRenderer } from './ReviewChooseAdjectiveRenderer';
 import { ReviewChooseBestAnswerRenderer } from './ReviewChooseBestAnswerRenderer';
 import { ReviewColoringRenderer } from './ReviewColoringRenderer';
@@ -20,7 +21,7 @@ function asApiQuestions(questions) {
     return questions;
 }
 export function renderDedicatedReviewBody(ctx) {
-    const { part, answers, isCorrectMap, correctAnswerTextMap, correctOptionIdMap, rawCorrectAnswerMap, questionScoreMap, hidePerQuestionGrading, } = ctx;
+    const { part, answers, isCorrectMap, correctAnswerTextMap, correctOptionIdMap, rawCorrectAnswerMap, rawStudentAnswerMap, questionScoreMap, hidePerQuestionGrading, } = ctx;
     const { partNo, questionType, questions } = part;
     const questionCount = questions.length;
     const apiQuestions = asApiQuestions(questions);
@@ -72,6 +73,50 @@ export function renderDedicatedReviewBody(ctx) {
         case 'LISTEN_AND_DRAG_OBJECTS_INTO_SCENE': {
             return (_jsx(ReviewListenDragObjectsRenderer, { partNumber: partNo, questionCount: questionCount, partName: part.name, questions: questions, studentAnswers: answers, rawCorrectAnswerMap: rawCorrectAnswerMap, isCorrectMap: isCorrectMap, questionScoreMap: questionScoreMap }));
         }
+        case 'ANSWER_THE_QUESTION_GROUP': {
+            const parent = questions[0];
+            if (!parent) {
+                return null;
+            }
+            const data = transformAnswerTheQuestionGroup(apiQuestions);
+            const parentId = parent.id || '';
+            const parentContent = asRecord(parent.content);
+            const items = Array.isArray(parentContent.items) ? parentContent.items : [];
+            const parentCorrect = asRecord(rawCorrectAnswerMap[parentId]);
+            const parentCorrectAnswers = Array.isArray(parentCorrect.answer)
+                ? parentCorrect.answer
+                : [];
+            const rawStudent = asRecord(rawStudentAnswerMap[parentId]);
+            const llmAssessment = asRecord(rawStudent.llmAssessment);
+            const llmItems = Array.isArray(llmAssessment.items) ? llmAssessment.items : [];
+            const llmByKey = new Map(llmItems
+                .map((item) => asRecord(item))
+                .filter((item) => typeof item.key === 'string')
+                .map((item) => [String(item.key), item]));
+            const itemMeta = Object.fromEntries(items.map((rawItem, index) => {
+                const item = asRecord(rawItem);
+                const itemCorrect = asRecord(item.correctAnswer);
+                const itemId = `${parentId}-item-${index}`;
+                const nested = Array.isArray(itemCorrect.expectedAnswers)
+                    ? itemCorrect.expectedAnswers.filter((value) => typeof value === 'string' && value.trim() !== '')
+                    : [];
+                const fallbackRaw = asRecord(parentCorrectAnswers[index]);
+                const fallback = Array.isArray(fallbackRaw.expectedAnswers)
+                    ? fallbackRaw.expectedAnswers.filter((value) => typeof value === 'string' && value.trim() !== '')
+                    : [];
+                const llmItem = asRecord(llmByKey.get(String(index)));
+                const feedback = asRecord(llmItem.feedback);
+                return [itemId, {
+                        expectedAnswers: nested.length > 0 ? nested : fallback,
+                        isCorrect: item.isExample === true
+                            ? true
+                            : (typeof llmItem.isCorrect === 'boolean' ? llmItem.isCorrect : null),
+                        feedbackEn: typeof feedback.en === 'string' ? feedback.en : undefined,
+                        feedbackVi: typeof feedback.vi === 'string' ? feedback.vi : undefined,
+                    }];
+            }));
+            return (_jsx(ReviewAnswerTheQuestionGroupRenderer, { partNumber: partNo, partName: part.name, questionCount: questionCount, instruction: part.instructions || data.instruction, groupContent: data.groupContent, questions: data.questions, answers: answers, itemMeta: itemMeta }));
+        }
         case 'SPONTANEOUS_QA_GROUP': {
             const parent = questions[0];
             if (!parent) {

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

@@ -6,6 +6,7 @@ const FLATTENED_ANSWER_TYPES = new Set([
     'READ_AND_COLOR_OBJECTS',
     'IMAGE_OBJECT_MATCHING',
     'CHOOSE_THE_CORRECT_ANSWER_GROUP',
+    'ANSWER_THE_QUESTION_GROUP',
     'CROSS_OUT_WORD_GROUP',
 ]);
 export function transformResultAnswersForReview(answers, templateParts = []) {
@@ -156,6 +157,17 @@ function transformStudentAnswer(questionId, questionType, value) {
             typeof item === 'string' ? item : '',
         ]));
     }
+    if (questionType === 'ANSWER_THE_QUESTION_GROUP') {
+        const answer = Array.isArray(record.answer)
+            ? record.answer
+            : Array.isArray(value)
+                ? value
+                : [];
+        return Object.fromEntries(answer.map((item, index) => [
+            `${questionId}-item-${index}`,
+            typeof item === 'string' ? item : '',
+        ]));
+    }
     if (questionType === 'CROSS_OUT_WORD_GROUP') {
         const answer = Array.isArray(record.answer)
             ? record.answer

package/dist/index.d.ts

@@ -7,7 +7,7 @@ export * as Themes from './components/themes';
 export * as Shared from './shared';
 export { buildExamTemplatePayload, createContestRoomsApi, createExamCreateApi, createExamEntryApi, createExamQuestionsApi, createExamQuestionsFetchApi, createExamTakingApi, createMockContestRoomsApi, createMockCreateExamApi, createMockExamEntryApi, createMockExamQuestionsApi, createMockExamTakingApi, createMockResultReviewApi, createResultReviewApi } from './api';
 export type { AnswerGradingStatusItem, AnswersGradingStatusResult, ContestRoomListItem, ContestRoomRegistrationStatus, ContestRoomVisibility, ContestRoomsContestDetail, ContestRoomsFetchApiOptions, ContestRoomsSdkApi, CreateExamFetchApiOptions, CreateExamPayload, CreateExamSdkApi, ExamFormData, ExamLevelOption, ExamQuestionsSdkApi, ExamResponse, ExamTakingAnswerValue, ExamTakingAttempt, ExamTakingFetchApiOptions, ExamTakingQuestion, ExamTakingQuestionsResult, ExamTakingRoom, ExamTakingSdkApi, ExamTakingTemplatePart, ExamTemplatePayload, ExamWithTemplate, ExistingQuestionBank, FetchApiOptions, GradingSummary, QuestionSearchItem, SaveExamInput, SaveExamTakingAnswersInput, SaveQuestionInput, SaveQuestionResult, SearchQuestionBankInput, SearchQuestionBankResult, SubmitExamTakingAttemptResult, UpdateExamTemplateInput, UpdatePartAudioInput, UploadAudioAnswerResult } from './api';
-export { CreateExamPageContainer, ExamPreviewDialog, ExamQuestionsPageContainer, ExamTakingPageContainer, ExamViewDialog, StudentContestRoomsPageContainer, StudentExamEntryPageContainer } from './components/exams';
+export { CreateExamPageContainer, ExamPreviewDialog, ExamPreviewMode, ExamQuestionsPageContainer, ExamTakingPageContainer, ExamViewDialog, StudentContestRoomsPageContainer, StudentExamEntryPageContainer } from './components/exams';
 export type { CreateExamPageContainerProps, CreateExamTexts, ExamPreviewDialogProps, ExamQuestionsPageContainerProps, ExamTakingPageContainerProps, ExamViewDialogExam, ExamViewDialogProps, StudentContestRoomsPageContainerProps, StudentExamEntryPageContainerProps } from './components/exams';
 export { ResultReviewPageContainer } from './components/results';
 export type { ResultReviewPageContainerProps } from './components/results';

package/dist/index.js

@@ -10,7 +10,7 @@ export * as Results from './components/results';
 export * as Themes from './components/themes';
 export * as Shared from './shared';
 export { buildExamTemplatePayload, createContestRoomsApi, createExamCreateApi, createExamEntryApi, createExamQuestionsApi, createExamQuestionsFetchApi, createExamTakingApi, createMockContestRoomsApi, createMockCreateExamApi, createMockExamEntryApi, createMockExamQuestionsApi, createMockExamTakingApi, createMockResultReviewApi, createResultReviewApi } from './api';
-export { CreateExamPageContainer, ExamPreviewDialog, ExamQuestionsPageContainer, ExamTakingPageContainer, ExamViewDialog, StudentContestRoomsPageContainer, StudentExamEntryPageContainer } from './components/exams';
+export { CreateExamPageContainer, ExamPreviewDialog, ExamPreviewMode, ExamQuestionsPageContainer, ExamTakingPageContainer, ExamViewDialog, StudentContestRoomsPageContainer, StudentExamEntryPageContainer } from './components/exams';
 export { ResultReviewPageContainer } from './components/results';
 export { QuestionCreator } from './components/questions/creator/QuestionCreator';
 export { QuestionGroupCreator } from './components/questions/creator/QuestionGroupCreator';

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

@@ -48,6 +48,7 @@ export const QUESTION_TYPE_SKILLS = {
     'FILL_MISSING_WORDS_IN_GRID': SkillEnum.READING,
     'READ_PASSAGE_AND_ANSWER_QUESTIONS': SkillEnum.READING,
     'ANSWER_THE_QUESTION': SkillEnum.READING,
+    'ANSWER_THE_QUESTION_GROUP': SkillEnum.READING,
     'WORD_ORDERING': SkillEnum.READING,
     'WORD_FILL_PARAGRAPH': SkillEnum.READING,
     'MATCH_BY_WRITING_ANSWER': SkillEnum.READING,
@@ -198,6 +199,7 @@ export const QUESTION_TYPE_LABELS = {
     'READING_PASSAGE_FILL': 'Đọc - Điền đoạn văn',
     'FILL_BLANK': 'Điền chỗ trống',
     'ANSWER_THE_QUESTION': 'Nghe - Đọc câu hỏi và viết đáp án',
+    'ANSWER_THE_QUESTION_GROUP': 'Đọc và trả lời câu hỏi (AI)',
     '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',

package/dist/shared/lib/i18n/messages/en/admin.d.ts

@@ -1477,6 +1477,9 @@ declare const admin: {
     readonly 'admin.exams.template.loading': "Loading exam information...";
     readonly 'admin.exams.template.loadingFallback': "Loading...";
     readonly 'admin.exams.preview.title': "Preview Exam: {name}";
+    readonly 'admin.exams.preview.mode.label': "Preview mode:";
+    readonly 'admin.exams.preview.mode.student': "Student View";
+    readonly 'admin.exams.preview.mode.answers': "Answer Key";
     readonly 'admin.exams.preview.examInfo': "Exam Information";
     readonly 'admin.exams.preview.duration': "Duration:";
     readonly 'admin.exams.preview.questionCount': "Questions:";
@@ -1503,6 +1506,8 @@ declare const admin: {
     readonly 'admin.exams.preview.next': "Next";
     readonly 'admin.exams.preview.questionLabel': "Question {number}";
     readonly 'admin.exams.preview.footerNote': "This is a preview mode to check the layout and content of the exam.";
+    readonly 'admin.exams.preview.footerNoteStudent': "Preview mode: Student test taking (You can try answering questions).";
+    readonly 'admin.exams.preview.footerNoteAnswers': "Preview mode: Showing correct answers and explanations.";
     readonly 'admin.exams.preview.close': "Close";
     readonly 'admin.exams.preview.loadError': "Unable to load questions. Please try again.";
     readonly 'admin.exams.preview.points': "{count} pts";

package/dist/shared/lib/i18n/messages/en/admin.js

@@ -1624,6 +1624,9 @@ const admin = {
     'admin.exams.template.loadingFallback': 'Loading...',
     // Preview dialog
     'admin.exams.preview.title': 'Preview Exam: {name}',
+    'admin.exams.preview.mode.label': 'Preview mode:',
+    'admin.exams.preview.mode.student': 'Student View',
+    'admin.exams.preview.mode.answers': 'Answer Key',
     'admin.exams.preview.examInfo': 'Exam Information',
     'admin.exams.preview.duration': 'Duration:',
     'admin.exams.preview.questionCount': 'Questions:',
@@ -1650,6 +1653,8 @@ const admin = {
     'admin.exams.preview.next': 'Next',
     'admin.exams.preview.questionLabel': 'Question {number}',
     'admin.exams.preview.footerNote': 'This is a preview mode to check the layout and content of the exam.',
+    'admin.exams.preview.footerNoteStudent': 'Preview mode: Student test taking (You can try answering questions).',
+    'admin.exams.preview.footerNoteAnswers': 'Preview mode: Showing correct answers and explanations.',
     'admin.exams.preview.close': 'Close',
     'admin.exams.preview.loadError': 'Unable to load questions. Please try again.',
     'admin.exams.preview.points': '{count} pts',

package/dist/shared/lib/i18n/messages/en.d.ts

@@ -1634,6 +1634,9 @@ declare const en: {
     readonly 'admin.exams.template.loading': "Loading exam information...";
     readonly 'admin.exams.template.loadingFallback': "Loading...";
     readonly 'admin.exams.preview.title': "Preview Exam: {name}";
+    readonly 'admin.exams.preview.mode.label': "Preview mode:";
+    readonly 'admin.exams.preview.mode.student': "Student View";
+    readonly 'admin.exams.preview.mode.answers': "Answer Key";
     readonly 'admin.exams.preview.examInfo': "Exam Information";
     readonly 'admin.exams.preview.duration': "Duration:";
     readonly 'admin.exams.preview.questionCount': "Questions:";
@@ -1660,6 +1663,8 @@ declare const en: {
     readonly 'admin.exams.preview.next': "Next";
     readonly 'admin.exams.preview.questionLabel': "Question {number}";
     readonly 'admin.exams.preview.footerNote': "This is a preview mode to check the layout and content of the exam.";
+    readonly 'admin.exams.preview.footerNoteStudent': "Preview mode: Student test taking (You can try answering questions).";
+    readonly 'admin.exams.preview.footerNoteAnswers': "Preview mode: Showing correct answers and explanations.";
     readonly 'admin.exams.preview.close': "Close";
     readonly 'admin.exams.preview.loadError': "Unable to load questions. Please try again.";
     readonly 'admin.exams.preview.points': "{count} pts";

package/dist/shared/lib/i18n/messages/vi/admin.d.ts

@@ -1477,6 +1477,9 @@ declare const admin: {
     readonly 'admin.exams.template.loading': "Đang tải thông tin đề thi...";
     readonly 'admin.exams.template.loadingFallback': "Đang tải...";
     readonly 'admin.exams.preview.title': "Xem trước đề thi: {name}";
+    readonly 'admin.exams.preview.mode.label': "Chế độ xem:";
+    readonly 'admin.exams.preview.mode.student': "Học sinh làm bài";
+    readonly 'admin.exams.preview.mode.answers': "Xem đáp án đúng";
     readonly 'admin.exams.preview.examInfo': "Thông tin đề thi";
     readonly 'admin.exams.preview.duration': "Thời gian:";
     readonly 'admin.exams.preview.questionCount': "Số câu hỏi:";
@@ -1503,6 +1506,8 @@ declare const admin: {
     readonly 'admin.exams.preview.next': "Tiếp";
     readonly 'admin.exams.preview.questionLabel': "Câu {number}";
     readonly 'admin.exams.preview.footerNote': "Đây là chế độ xem trước để kiểm tra bố cục và nội dung đề thi.";
+    readonly 'admin.exams.preview.footerNoteStudent': "Chế độ xem trước: Học sinh làm bài (Có thể thao tác thử trên câu hỏi).";
+    readonly 'admin.exams.preview.footerNoteAnswers': "Chế độ xem trước: Đang hiển thị đáp án đúng và hướng dẫn giải.";
     readonly 'admin.exams.preview.close': "Đóng";
     readonly 'admin.exams.preview.loadError': "Không thể tải câu hỏi. Vui lòng thử lại.";
     readonly 'admin.exams.preview.points': "{count} điểm";

package/dist/shared/lib/i18n/messages/vi/admin.js

@@ -1624,6 +1624,9 @@ const admin = {
     'admin.exams.template.loadingFallback': 'Đang tải...',
     // Preview dialog
     'admin.exams.preview.title': 'Xem trước đề thi: {name}',
+    'admin.exams.preview.mode.label': 'Chế độ xem:',
+    'admin.exams.preview.mode.student': 'Học sinh làm bài',
+    'admin.exams.preview.mode.answers': 'Xem đáp án đúng',
     'admin.exams.preview.examInfo': 'Thông tin đề thi',
     'admin.exams.preview.duration': 'Thời gian:',
     'admin.exams.preview.questionCount': 'Số câu hỏi:',
@@ -1650,6 +1653,8 @@ const admin = {
     'admin.exams.preview.next': 'Tiếp',
     'admin.exams.preview.questionLabel': 'Câu {number}',
     'admin.exams.preview.footerNote': 'Đây là chế độ xem trước để kiểm tra bố cục và nội dung đề thi.',
+    'admin.exams.preview.footerNoteStudent': 'Chế độ xem trước: Học sinh làm bài (Có thể thao tác thử trên câu hỏi).',
+    'admin.exams.preview.footerNoteAnswers': 'Chế độ xem trước: Đang hiển thị đáp án đúng và hướng dẫn giải.',
     'admin.exams.preview.close': 'Đóng',
     'admin.exams.preview.loadError': 'Không thể tải câu hỏi. Vui lòng thử lại.',
     'admin.exams.preview.points': '{count} điểm',

package/dist/shared/lib/i18n/messages/vi.d.ts

@@ -1634,6 +1634,9 @@ declare const vi: {
     readonly 'admin.exams.template.loading': "Đang tải thông tin đề thi...";
     readonly 'admin.exams.template.loadingFallback': "Đang tải...";
     readonly 'admin.exams.preview.title': "Xem trước đề thi: {name}";
+    readonly 'admin.exams.preview.mode.label': "Chế độ xem:";
+    readonly 'admin.exams.preview.mode.student': "Học sinh làm bài";
+    readonly 'admin.exams.preview.mode.answers': "Xem đáp án đúng";
     readonly 'admin.exams.preview.examInfo': "Thông tin đề thi";
     readonly 'admin.exams.preview.duration': "Thời gian:";
     readonly 'admin.exams.preview.questionCount': "Số câu hỏi:";
@@ -1660,6 +1663,8 @@ declare const vi: {
     readonly 'admin.exams.preview.next': "Tiếp";
     readonly 'admin.exams.preview.questionLabel': "Câu {number}";
     readonly 'admin.exams.preview.footerNote': "Đây là chế độ xem trước để kiểm tra bố cục và nội dung đề thi.";
+    readonly 'admin.exams.preview.footerNoteStudent': "Chế độ xem trước: Học sinh làm bài (Có thể thao tác thử trên câu hỏi).";
+    readonly 'admin.exams.preview.footerNoteAnswers': "Chế độ xem trước: Đang hiển thị đáp án đúng và hướng dẫn giải.";
     readonly 'admin.exams.preview.close': "Đóng";
     readonly 'admin.exams.preview.loadError': "Không thể tải câu hỏi. Vui lòng thử lại.";
     readonly 'admin.exams.preview.points': "{count} điểm";