@tinyweb_dev/oe-exam-sdk 0.1.30 → 0.1.32

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

@@ -19,6 +19,7 @@ import { LookPictureChooseCorrectAnswerClient } from '../types/look-picture-choo
 import { LookPictureFillBlankChooseAnswerClient } from '../types/look-picture-fill-blank-choose-answer/LookPictureFillBlankChooseAnswerClient';
 import { FillMissingWordsInGridClient } from '../types/fill-missing-words-in-grid/FillMissingWordsInGridClient';
 import { WordFillStructuredFormClient } from '../types/word-fill-structured-form/WordFillStructuredFormClient';
+import { CrosswordPuzzleClient } from '../types/crossword-puzzle/CrosswordPuzzleClient';
 import { parseFillBlankStemLine } from '../_shared/utils/parseFillBlankStem';
 import { WordFillStructuredFormViewer } from './WordFillStructuredFormViewer';
 import { ChooseTheCorrectAnswerGroupViewer } from './ChooseTheCorrectAnswerGroupViewer';
@@ -343,7 +344,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 +601,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 }));
@@ -643,6 +644,8 @@ export function QuestionViewer({ question, onSubmitAnswer, isReviewMode = false,
                 return renderWordFillParagraph();
             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 }));
             default:
                 return _jsxs("div", { children: ["Lo\u1EA1i c\u00E2u h\u1ECFi kh\u00F4ng \u0111\u01B0\u1EE3c h\u1ED7 tr\u1EE3: ", question.type] });
         }
@@ -653,8 +656,8 @@ export function QuestionViewer({ question, onSubmitAnswer, isReviewMode = false,
      * parseFillBlankStemLine (or paragraph renderer). Dumping raw text shows markdown.
      */
     const resolveCardTitle = () => {
-        // WFSF shows Bài N + instruction inside the client — no outer card label.
-        if (question.type === 'WORD_FILL_STRUCTURED_FORM') {
+        // WFSF and Crossword show title/instruction inside the client — no outer card label.
+        if (question.type === 'WORD_FILL_STRUCTURED_FORM' || question.type === 'CROSSWORD_PUZZLE') {
             return null;
         }
         // Modern fill stems live entirely in the body; title is a short label.
@@ -676,8 +679,8 @@ export function QuestionViewer({ question, onSubmitAnswer, isReviewMode = false,
         return stripLightweightMarkdown(raw) || 'Câu hỏi';
     };
     const cardTitle = resolveCardTitle();
-    // WFSF already has its own bordered shell — avoid double Card border.
-    if (question.type === 'WORD_FILL_STRUCTURED_FORM') {
+    // WFSF and Crossword already have their own bordered shell — avoid double Card border.
+    if (question.type === 'WORD_FILL_STRUCTURED_FORM' || question.type === 'CROSSWORD_PUZZLE') {
         return (_jsx("div", { className: "space-y-4", children: renderQuestion() }));
     }
     return (_jsxs(Card, { children: [cardTitle ? (_jsx(CardHeader, { children: _jsxs(CardTitle, { className: "flex items-center justify-between", children: [_jsx("span", { className: "min-w-0 pr-2 text-base font-semibold leading-snug", children: cardTitle }), _jsxs("span", { className: "shrink-0 text-sm font-normal text-gray-500", children: [question.points, " \u0111i\u1EC3m"] })] }) })) : null, _jsx(CardContent, { className: cardTitle ? 'space-y-4' : 'space-y-4 pt-4', children: renderQuestion() })] }));

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/renderers/review-question-body-movers.js

@@ -4,8 +4,8 @@ import { jsx as _jsx } from "react/jsx-runtime";
  * Movers fallback review cases (isReviewMode=true).
  * Source: oe-exam-fe ReviewQuestionRenderer.tsx
  */
-import { MoversAnswerTheQuestionRenderer, MoversFillWordHintRenderer, MoversGridFillRenderer, MoversLabelThePictureRenderer, MoversMatchByWritingAnswerRenderer, MoversPictureChooseRenderer, MoversPictureFillBlankChooseRenderer, MoversReadingPassageRenderer, MoversTrueFalseRenderer, MoversCrossOutWordGroupRenderer, MoversWordFillParagraphRenderer, MoversWordFillStructuredFormRenderer, MoversWordOrderingRenderer, MoversWriteSentencesRenderer, MoversWritingRenderer, } from '../../../components/exams/take/components/question-renderers';
-import { transformAnswerTheQuestion, transformFillWordHint, transformGridFill, transformLabelPicture, transformMatchByWritingAnswer, transformPictureChoose, transformPictureFillBlankChoose, transformReadingPassage, transformTrueFalse, transformWordFillParagraph, transformWordFillStructuredForm, transformWordOrdering, transformWriteSentences, transformWriteShortLetter, } from '../../../components/exams/take/utils/question-transformers';
+import { MoversAnswerTheQuestionRenderer, MoversFillWordHintRenderer, MoversGridFillRenderer, MoversLabelThePictureRenderer, MoversMatchByWritingAnswerRenderer, MoversPictureChooseRenderer, MoversPictureFillBlankChooseRenderer, MoversReadingPassageRenderer, MoversTrueFalseRenderer, MoversCrossOutWordGroupRenderer, MoversWordFillParagraphRenderer, MoversWordFillStructuredFormRenderer, MoversWordOrderingRenderer, MoversWriteSentencesRenderer, MoversWritingRenderer, MoversCrosswordPuzzleRenderer, } from '../../../components/exams/take/components/question-renderers';
+import { transformAnswerTheQuestion, transformFillWordHint, transformGridFill, transformLabelPicture, transformMatchByWritingAnswer, transformPictureChoose, transformPictureFillBlankChoose, transformReadingPassage, transformTrueFalse, transformWordFillParagraph, transformWordFillStructuredForm, transformWordOrdering, transformWriteSentences, transformWriteShortLetter, transformCrosswordPuzzle, } from '../../../components/exams/take/utils/question-transformers';
 import { normalizeCrossOutWordGroupAnswer, transformCrossOutWordGroup, } from '../../../components/exams/take/utils/cross-out-word-group.transformer';
 function asApiQuestions(questions) {
     return questions;
@@ -142,6 +142,11 @@ export function renderMoversReviewBody(ctx) {
             const data = transformWordFillStructuredForm(apiQuestions);
             return (_jsx(MoversWordFillStructuredFormRenderer, { partNumber: partNo, partName: part.name, instruction: part.instructions || data.instruction, questionCount: questionCount, audioUrl: data.audioUrl || part.audioUrl, groupTitle: data.groupTitle, groupContent: data.groupContent, groupImageUrl: data.groupImageUrl, questions: data.questions, answers: answers, onAnswerChange: handleAnswerChange, isReviewMode: true }));
         }
+        case 'CROSSWORD_PUZZLE': {
+            const data = transformCrosswordPuzzle(apiQuestions);
+            const firstQuestion = apiQuestions[0];
+            return (_jsx(MoversCrosswordPuzzleRenderer, { partNumber: partNo, partName: part.name, instruction: part.instructions || data.instruction, questionCount: questionCount, title: data.title, gridSize: data.gridSize, clues: data.clues, answers: answers, correctAnswers: data.correctAnswers, onAnswerChange: handleAnswerChange, isReviewMode: true, caseSensitive: firstQuestion?.correct_answer?.caseSensitive || false }));
+        }
         default:
             return null;
     }

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 = []) {
@@ -136,8 +137,12 @@ function addCorrectAnswerMaps(result, answer) {
         texts.forEach((text, index) => { result.correctAnswerTextMap[`${answer.questionId}-blank-${index}`] = text; });
     if (answer.questionType === 'LABEL_THE_PICTURE' && isRecord(correct.labels))
         Object.entries(correct.labels).forEach(([id, value]) => { result.correctAnswerTextMap[id] = String(value); });
-    if (answer.questionType === 'FILL_MISSING_WORDS_IN_GRID' && isRecord(correct.cells)) {
-        result.cellAnswersMap[answer.questionId] = { cells: correct.cells, caseSensitive: correct.caseSensitive === true };
+    if ((answer.questionType === 'FILL_MISSING_WORDS_IN_GRID' || answer.questionType === 'CROSSWORD_PUZZLE') && isRecord(correct.cells || correct.answers)) {
+        const rawCells = (correct.cells || correct.answers);
+        result.cellAnswersMap[answer.questionId] = {
+            cells: Object.fromEntries(Object.entries(rawCells).map(([k, v]) => [k, { correctAnswer: String(v) }])),
+            caseSensitive: correct.caseSensitive === true,
+        };
     }
 }
 function transformStudentAnswer(questionId, questionType, value) {
@@ -156,6 +161,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
@@ -192,8 +208,8 @@ function transformStudentAnswer(questionId, questionType, value) {
         const keys = Object.keys(record).filter((key) => /^\d+$/.test(key)).sort((a, b) => Number(a) - Number(b));
         return keys.map((key) => record[key]);
     }
-    if (questionType === 'READ_AND_COLOR_OBJECTS' || questionType === 'IMAGE_OBJECT_MATCHING')
-        return record.answers ?? value;
+    if (questionType === 'READ_AND_COLOR_OBJECTS' || questionType === 'IMAGE_OBJECT_MATCHING' || questionType === 'CROSSWORD_PUZZLE')
+        return record.cells ?? record.answers ?? value;
     if (questionType === 'WRITE_A_SHORT_LETTER')
         return typeof value === 'string' ? value : record.answer ?? '';
     return record.answer ?? value;

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,
@@ -77,6 +78,7 @@ export const QUESTION_TYPE_SKILLS = {
     'READING_PASSAGE_FILL': SkillEnum.READING,
     'FILL_BLANK': SkillEnum.READING,
     'WORD_FILL_STRUCTURED_FORM': SkillEnum.READING,
+    'CROSSWORD_PUZZLE': SkillEnum.READING,
     // ========================================
     // WRITING SKILLS (Viết)
     // ========================================
@@ -198,10 +200,12 @@ 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',
     'WORD_FILL_STRUCTURED_FORM': 'Điền từ vào biểu mẫu có cấu trúc',
+    'CROSSWORD_PUZZLE': 'Giải ô chữ (Crossword)',
     // ========================================
     // WRITING SKILLS (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";

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

@@ -186,6 +186,44 @@ const reverseChooseTheCorrectAnswerGroup = (apiQuestion) => {
         },
     };
 };
+const reverseAnswerTheQuestionGroup = (apiQuestion) => {
+    const content = asRecord(apiQuestion.content);
+    const answer = readAnswer(apiQuestion);
+    const fallbackAnswers = asArray(answer.answer);
+    const items = asArray(content.items).map((rawItem, index) => {
+        const item = asRecord(rawItem);
+        const itemContent = asRecord(item.content);
+        const itemAnswer = asRecord(item.correctAnswer);
+        const nested = asArray(itemAnswer.expectedAnswers)
+            .filter((value) => typeof value === 'string')
+            .map((value) => value.trim())
+            .filter((value) => value !== '');
+        const fallback = asRecord(fallbackAnswers[index]);
+        const fallbackExpected = asArray(fallback.expectedAnswers)
+            .filter((value) => typeof value === 'string')
+            .map((value) => value.trim())
+            .filter((value) => value !== '');
+        const expectedAnswers = nested.length > 0 ? nested : (fallbackExpected.length > 0 ? fallbackExpected : ['']);
+        const isExample = item.isExample === true;
+        return {
+            question: asString(itemContent.question),
+            expectedAnswers,
+            isExample,
+            points: isExample ? 0 : asNumber(item.points, 1),
+            questionNumber: asNumber(item.questionNumber, index + 1),
+        };
+    });
+    return {
+        content: '',
+        answer: {
+            instruction: asString(asRecord(content.meta).instruction, 'Read the text again and answer the questions.'),
+            passage: asString(asRecord(content.meta).passage),
+            items,
+            explanation: asString(apiQuestion.explanation),
+            points: items.reduce((total, item) => (item.isExample ? total : total + item.points), 0),
+        },
+    };
+};
 const reverseTrueFalseGroup = (apiQuestion) => {
     const content = asRecord(apiQuestion.content);
     const answer = readAnswer(apiQuestion);
@@ -367,6 +405,7 @@ const reverseSimpleAnswer = (apiQuestion) => {
 const handlers = {
     CHOOSE_THE_CORRECT_ANSWER: reverseChooseTheCorrectAnswer,
     CHOOSE_THE_CORRECT_ANSWER_GROUP: reverseChooseTheCorrectAnswerGroup,
+    ANSWER_THE_QUESTION_GROUP: reverseAnswerTheQuestionGroup,
     TRUE_FALSE_GROUP: reverseTrueFalseGroup,
     CROSS_OUT_WORD_GROUP: reverseCrossOutWordGroup,
     WORD_ORDER_AND_MATCH_GROUP: reverseWordOrderAndMatchGroup,
@@ -407,7 +446,61 @@ const handlers = {
     SPEAKING_CONVERSATION: reverseGroupPayload,
     SPEAKING_CUE_CARD: reverseSimpleAnswer,
     GN_SPEAKING_INTERVIEW: reverseGroupPayload,
+    CROSSWORD_PUZZLE: reverseCrosswordPuzzle,
 };
+function reverseCrosswordPuzzle(apiQuestion) {
+    const apiContent = (apiQuestion.content || {});
+    const apiAnswer = (apiQuestion.correctAnswer || apiQuestion.correct_answer || apiQuestion.answer || {});
+    const rows = apiContent.gridSize?.rows || apiContent.rows || 12;
+    const cols = apiContent.gridSize?.cols || apiContent.cols || 12;
+    const title = apiContent.title || '';
+    const across = Array.isArray(apiContent.clues?.across) ? apiContent.clues.across : [];
+    const down = Array.isArray(apiContent.clues?.down) ? apiContent.clues.down : [];
+    const answers = apiAnswer.answers || {};
+    const clues = [];
+    for (const a of across) {
+        clues.push({
+            id: `across-${a.number}-${Date.now()}-${Math.random()}`,
+            number: a.number,
+            clue: a.clue || '',
+            startRow: a.startRow || 1,
+            startCol: a.startCol || 1,
+            length: a.length || 1,
+            direction: 'across',
+            answer: answers[`across-${a.number}`] || '',
+        });
+    }
+    for (const d of down) {
+        clues.push({
+            id: `down-${d.number}-${Date.now()}-${Math.random()}`,
+            number: d.number,
+            clue: d.clue || '',
+            startRow: d.startRow || 1,
+            startCol: d.startCol || 1,
+            length: d.length || 1,
+            direction: 'down',
+            answer: answers[`down-${d.number}`] || '',
+        });
+    }
+    return {
+        content: {
+            title,
+            rows,
+            cols,
+            gridSize: { rows, cols },
+            clues: { across, down },
+        },
+        answer: {
+            title,
+            rows,
+            cols,
+            clues,
+            answers,
+            caseSensitive: apiAnswer.caseSensitive || false,
+            explanation: apiQuestion.explanation || '',
+        },
+    };
+}
 export function transformApiQuestionToFrontend(apiQuestion) {
     const questionType = String(apiQuestion.questionType ?? apiQuestion.question_type ?? apiQuestion.type ?? '');
     const handlerResult = (handlers[questionType] ?? defaultReverse)(apiQuestion);