@tinyweb_dev/oe-exam-sdk 0.2.5 → 0.2.6

package/dist/components/exams/take/ExamTakingPageContainer.js

@@ -631,6 +631,12 @@ function ExamTakingPageContainerInner({ roomId, api, onNavigate, resultPath = (a
                         map.set(`${question.id}-item-${index}`, question.id);
                     });
                 }
+                if (part.questionType === 'FILL_IN_BLANK_GROUP' &&
+                    Array.isArray(content?.items)) {
+                    content.items.forEach((_, index) => {
+                        map.set(`${question.id}-item-${index}`, question.id);
+                    });
+                }
             });
         });
         return map;

package/dist/components/exams/take/components/QuestionRenderer.js

@@ -8,9 +8,9 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  * 2. Transforms data to renderer-specific props
  * 3. Renders the correct component for each question type
  */
-import { MoversListenAndWriteRenderer, MoversChooseBestAnswerRenderer, MoversChooseAdjectiveRenderer, MoversWritingRenderer, MoversColoringRenderer, MoversPictureChooseRenderer, MoversPictureFillBlankChooseRenderer, MoversReadingPassageRenderer, MoversLabelThePictureRenderer, MoversFillWordHintRenderer, MoversGridFillRenderer, MoversTrueFalseRenderer, MoversTrueFalseCorrectGroupRenderer, MoversCrossOutWordGroupRenderer, MoversAnswerTheQuestionRenderer, MoversWriteSentencesRenderer, MoversWordOrderingRenderer, MoversWordFillParagraphRenderer, MoversMatchByWritingAnswerRenderer, MoversMatchWordToPictureRenderer, MoversWordFillStructuredFormRenderer, MoversWordOrderAndMatchGroupRenderer, MoversCrosswordPuzzleRenderer, FindWordsInMatrixRenderer, } from './question-renderers';
+import { MoversListenAndWriteRenderer, MoversChooseBestAnswerRenderer, MoversChooseAdjectiveRenderer, MoversWritingRenderer, MoversColoringRenderer, MoversPictureChooseRenderer, MoversPictureFillBlankChooseRenderer, MoversReadingPassageRenderer, MoversLabelThePictureRenderer, MoversFillWordHintRenderer, MoversGridFillRenderer, MoversTrueFalseRenderer, MoversTrueFalseCorrectGroupRenderer, MoversFillInBlankGroupRenderer, MoversCrossOutWordGroupRenderer, MoversAnswerTheQuestionRenderer, MoversWriteSentencesRenderer, MoversWordOrderingRenderer, MoversWordFillParagraphRenderer, MoversMatchByWritingAnswerRenderer, MoversMatchWordToPictureRenderer, MoversWordFillStructuredFormRenderer, MoversWordOrderAndMatchGroupRenderer, MoversMatchingWithLinesGroupRenderer, MoversCrosswordPuzzleRenderer, FindWordsInMatrixRenderer, } from './question-renderers';
 import { SpeakingQuestionRenderer } from './speaking/renderers';
-import { transformFillInBlank, transformWriteCorrectVerbForm, transformChooseCorrectAnswer, transformChooseTheCorrectAnswerGroup, transformChooseCorrectAdjective, transformWriteShortLetter, transformColorObjects, transformPictureChoose, transformPictureFillBlankChoose, transformReadingPassage, transformLabelPicture, transformFillWordHint, transformGridFill, transformAnswerTheQuestion, transformAnswerTheQuestionGroup, transformTrueFalse, transformTrueFalseGroup, transformTrueFalseCorrectGroup, transformWordOrdering, transformWordFillParagraph, transformMatchByWritingAnswer, transformMatchWordToPicture, transformWriteSentences, transformWordFillStructuredForm, transformWordOrderAndMatchGroup, transformCrosswordPuzzle, transformFindWordsInMatrix, } from '../utils/question-transformers';
+import { transformFillInBlank, transformWriteCorrectVerbForm, transformChooseCorrectAnswer, transformChooseTheCorrectAnswerGroup, transformChooseCorrectAdjective, transformWriteShortLetter, transformColorObjects, transformPictureChoose, transformPictureFillBlankChoose, transformReadingPassage, transformLabelPicture, transformFillWordHint, transformGridFill, transformAnswerTheQuestion, transformAnswerTheQuestionGroup, transformTrueFalse, transformTrueFalseGroup, transformTrueFalseCorrectGroup, transformFillInBlankGroup, transformWordOrdering, transformWordFillParagraph, transformMatchByWritingAnswer, transformMatchWordToPicture, transformWriteSentences, transformWordFillStructuredForm, transformWordOrderAndMatchGroup, transformMatchingWithLinesGroup, transformCrosswordPuzzle, transformFindWordsInMatrix, } from '../utils/question-transformers';
 import { transformCrossOutWordGroup } from '../utils/cross-out-word-group.transformer';
 import { normalizeColoringAssignments } from '../utils/coloring-assignments';
 export function QuestionRenderer({ part, answers, onAnswerChange, isReviewMode = false, onExit, onPartComplete, onPartBack, speakingTheme, initialQuestionIndex, skipTeacherVideo, onTeacherIntroPlayed, currentQuestionIndex, }) {
@@ -161,6 +161,10 @@ export function QuestionRenderer({ part, answers, onAnswerChange, isReviewMode =
             const data = transformTrueFalseCorrectGroup(questions);
             return (_jsx(MoversTrueFalseCorrectGroupRenderer, { partNumber: partNo, partName: part.name, questionCount: questionCount, instruction: part.instructions || data.instruction, questions: getRenderQuestions(data.questions), answers: answers, onAnswerChange: onAnswerChange, isReviewMode: isReviewMode }));
         }
+        case 'FILL_IN_BLANK_GROUP': {
+            const data = transformFillInBlankGroup(questions);
+            return (_jsx(MoversFillInBlankGroupRenderer, { partNumber: partNo, partName: part.name, questionCount: data.questions.filter((question) => !question.isExample).length, instruction: part.instructions || data.instruction, audioUrl: data.audioUrl || part.audioUrl, imageUrl: data.imageUrl, showHints: data.showHints, hints: data.hints, questions: getRenderQuestions(data.questions), answers: answers, onAnswerChange: onAnswerChange, isReviewMode: isReviewMode }));
+        }
         case 'CROSS_OUT_WORD_GROUP': {
             const data = transformCrossOutWordGroup(questions);
             return (_jsx(MoversCrossOutWordGroupRenderer, { partNumber: partNo, partName: part.name, questionCount: questionCount, instruction: part.instructions || data.instruction, questions: getRenderQuestions(data.questions), answers: answers, onAnswerChange: onAnswerChange, isReviewMode: isReviewMode }));
@@ -169,6 +173,10 @@ export function QuestionRenderer({ part, answers, onAnswerChange, isReviewMode =
             const data = transformWordOrderAndMatchGroup(questions);
             return (_jsx(MoversWordOrderAndMatchGroupRenderer, { partNumber: partNo, partName: part.name, questionCount: questionCount, instruction: part.instructions || data.instruction, matchOptions: data.matchOptions, questions: getRenderQuestions(data.questions), answers: answers, onAnswerChange: onAnswerChange, isReviewMode: isReviewMode }));
         }
+        case 'MATCHING_WITH_LINES_GROUP': {
+            const data = transformMatchingWithLinesGroup(questions);
+            return (_jsx(MoversMatchingWithLinesGroupRenderer, { partNumber: partNo, partName: part.name, questionCount: questionCount, instruction: part.instructions || data.instruction, data: data, answers: answers, onAnswerChange: onAnswerChange, isReviewMode: isReviewMode }));
+        }
         case 'TRUE_FALSE': {
             const data = transformTrueFalse(questions);
             return (_jsx(MoversTrueFalseRenderer, { partNumber: partNo, partName: part.name, questionCount: questionCount, instruction: part.instructions || data.instruction, imageUrl: data.imageUrl, groupContent: data.groupContent, questions: getRenderQuestions(data.questions), answers: answers, onAnswerChange: onAnswerChange, isReviewMode: isReviewMode }));

package/dist/components/exams/take/components/question-renderers/MoversFillInBlankGroupRenderer.d.ts

@@ -0,0 +1,22 @@
+/**
+ * FILL_IN_BLANK_GROUP Renderer
+ * Shared audio/image on top, then each item: picture + fill blanks.
+ */
+import type { FillInBlankGroupQuestion, FillInBlankGroupItemAnswer, FillInBlankGroupStudentItemAnswer } from '../../utils/question-transformers';
+interface MoversFillInBlankGroupRendererProps {
+    partNumber: number;
+    partName?: string;
+    questionCount: number;
+    instruction: string;
+    audioUrl?: string;
+    imageUrl?: string;
+    showHints?: boolean;
+    hints?: string[];
+    questions: FillInBlankGroupQuestion[];
+    answers: Record<string, FillInBlankGroupStudentItemAnswer | undefined>;
+    onAnswerChange: (questionId: string, value: FillInBlankGroupStudentItemAnswer) => void;
+    isReviewMode?: boolean;
+    correctAnswerMap?: Record<string, FillInBlankGroupItemAnswer>;
+}
+export declare function MoversFillInBlankGroupRenderer({ partNumber, partName, questionCount, instruction, audioUrl, imageUrl, showHints, hints, questions, answers, onAnswerChange, isReviewMode, correctAnswerMap, }: MoversFillInBlankGroupRendererProps): import("react").JSX.Element;
+export {};

package/dist/components/exams/take/components/question-renderers/MoversFillInBlankGroupRenderer.js

@@ -0,0 +1,60 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * FILL_IN_BLANK_GROUP Renderer
+ * Shared audio/image on top, then each item: picture + fill blanks.
+ */
+import { Fragment } from 'react';
+import { ResolvedImage } from '../../../../../components/common/ResolvedImage';
+import CambridgeYlePartBanner from '../../../../../components/themes/cambridge-yle/CambridgeYlePartBanner';
+import CambridgeYleInstructionBanner from '../../../../../components/themes/cambridge-yle/CambridgeYleInstructionBanner';
+import CambridgeYleAudioPlayer from '../../../../../components/themes/cambridge-yle/CambridgeYleAudioPlayer';
+import { extractPlaceholderIndices, isBlankMatch, padStudentAnswers, splitStem, } from '../../../../questions/types/fill-in-blank-group/blank-utils';
+function emptyAnswer(blankCount) {
+    return { answers: Array.from({ length: blankCount }, () => '') };
+}
+function ItemCard({ question, answer, onAnswerChange, isReviewMode, correctAnswer, }) {
+    const isDisabled = isReviewMode || question.isExample;
+    const current = question.isExample
+        ? { answers: question.exampleAnswers || emptyAnswer(question.blankCount).answers }
+        : { answers: padStudentAnswers(answer, question.blankCount) };
+    const stem = splitStem(question.question || '{0}');
+    const expected = correctAnswer?.answers || [];
+    const blankIndices = extractPlaceholderIndices(question.question || '{0}');
+    const allCorrect = isReviewMode
+        && !question.isExample
+        && blankIndices.length > 0
+        && blankIndices.every((index) => isBlankMatch(current.answers[index], expected[index]));
+    const anyFilled = current.answers.some((value) => value.trim().length > 0);
+    const isWrong = isReviewMode && !question.isExample && anyFilled && !allCorrect;
+    const setBlank = (blankIndex, value) => {
+        const next = [...current.answers];
+        next[blankIndex] = value;
+        onAnswerChange(question.id, { answers: next });
+    };
+    return (_jsxs("div", { id: `question-${question.id}`, className: `rounded-2xl border p-3 sm:p-4 transition-all ${question.isExample
+            ? 'border-amber-200 bg-amber-50/60'
+            : allCorrect
+                ? 'border-emerald-300 bg-emerald-50/30'
+                : isWrong
+                    ? 'border-rose-300 bg-rose-50/30'
+                    : 'border-slate-200 bg-white'}`, children: [_jsxs("div", { className: "mb-2 flex items-center gap-2", children: [_jsx("span", { className: `flex h-7 w-7 items-center justify-center rounded-full text-xs font-black text-white ${question.isExample ? 'bg-amber-500' : allCorrect ? 'bg-emerald-500' : isWrong ? 'bg-rose-500' : 'bg-blue-600'}`, children: question.questionNumber }), question.isExample && (_jsx("span", { className: "rounded-full bg-amber-100 px-2 py-0.5 text-[10px] font-extrabold uppercase text-amber-800", children: "Example" }))] }), question.audioUrl && (_jsx("div", { className: "mb-2", children: _jsx(CambridgeYleAudioPlayer, { audioSrc: question.audioUrl, compact: true, dense: true }) })), _jsxs("div", { className: "flex items-center gap-3", children: [question.imageUrl && (_jsx(ResolvedImage, { src: question.imageUrl, alt: `Question ${question.questionNumber}`, className: "h-24 w-24 flex-shrink-0 rounded-lg object-contain" })), _jsx("div", { className: "min-w-0 flex-1 text-[15px] leading-relaxed text-slate-800", children: stem.map((part, partIndex) => {
+                            if (part.type === 'text') {
+                                const lines = part.value.split('\n');
+                                return (_jsx(Fragment, { children: lines.map((line, lineIndex) => (_jsxs(Fragment, { children: [lineIndex > 0 ? _jsx("br", {}) : null, line] }, lineIndex))) }, partIndex));
+                            }
+                            const student = current.answers[part.index] || '';
+                            const alts = expected[part.index] || [];
+                            const blankCorrect = isReviewMode && !question.isExample && isBlankMatch(student, alts);
+                            const blankWrong = isReviewMode && !question.isExample && student.trim().length > 0 && !blankCorrect;
+                            return (_jsx("input", { type: "text", value: student, disabled: isDisabled, onChange: (event) => setBlank(part.index, event.target.value), placeholder: question.isExample ? '' : '...', className: `mx-1 inline-block w-[4.5rem] rounded-md border-2 px-1 py-1 text-center text-sm font-semibold outline-none sm:w-20 ${question.isExample
+                                    ? 'border-amber-300 bg-amber-100/70 text-amber-800'
+                                    : blankCorrect
+                                        ? 'border-emerald-400 bg-emerald-50 text-emerald-800'
+                                        : blankWrong
+                                            ? 'border-rose-400 bg-rose-50 text-rose-800'
+                                            : 'border-blue-200 bg-blue-50/40 text-blue-900 focus:border-blue-500 focus:bg-white'}` }, partIndex));
+                        }) })] }), isReviewMode && !question.isExample && expected.length > 0 && (_jsxs("div", { className: "mt-2 rounded-lg border border-emerald-200 bg-emerald-50 px-2.5 py-2 text-sm text-emerald-800", children: ["\u0110\u00E1p \u00E1n \u0111\u00FAng: ", expected.map((alts) => alts.join(' / ') || '(trống)').join(' | ')] }))] }));
+}
+export function MoversFillInBlankGroupRenderer({ partNumber, partName, questionCount, instruction, audioUrl, imageUrl, showHints = false, hints = [], questions, answers, onAnswerChange, isReviewMode = false, correctAnswerMap, }) {
+    return (_jsxs("div", { className: "relative flex h-full flex-col gap-4 overflow-y-auto custom-scrollbar sm:gap-6", children: [_jsxs("div", { className: "flex flex-col gap-2 p-3 sm:gap-3 sm:px-6 sm:pt-4", children: [_jsx(CambridgeYlePartBanner, { partNumber: partNumber, questionCount: questionCount, partName: partName, isReviewMode: isReviewMode }), _jsx(CambridgeYleInstructionBanner, { instruction: instruction, isReviewMode: isReviewMode })] }), (audioUrl || imageUrl) && (_jsxs("div", { className: "sticky top-0 z-20 flex flex-col gap-3 border-b border-gray-100 bg-white/95 p-3 pb-2 shadow-sm backdrop-blur sm:px-6", children: [audioUrl && _jsx(CambridgeYleAudioPlayer, { audioSrc: audioUrl, compact: true }), imageUrl && (_jsx("div", { className: "flex justify-center", children: _jsx(ResolvedImage, { src: imageUrl, alt: "Shared illustration", className: "max-h-[180px] rounded-lg object-contain" }) }))] })), showHints && hints.length > 0 && !isReviewMode && (_jsx("div", { className: "flex flex-wrap gap-2 px-3 sm:px-6", children: hints.map((hint) => (_jsx("span", { className: "rounded-full border border-blue-200 bg-blue-50 px-3 py-1 text-xs font-semibold text-blue-700", children: hint }, hint))) })), _jsx("div", { className: "grid grid-cols-1 gap-3 p-3 sm:grid-cols-2 sm:px-6 lg:grid-cols-3", children: questions.map((question) => (_jsx(ItemCard, { question: question, answer: answers[question.id], onAnswerChange: onAnswerChange, isReviewMode: isReviewMode, correctAnswer: correctAnswerMap?.[question.id] }, question.id))) })] }));
+}

package/dist/components/exams/take/components/question-renderers/MoversMatchingWithLinesGroupRenderer.d.ts

@@ -0,0 +1,13 @@
+import type { MatchingWithLinesGroupPartData } from '../../utils/question-transformers';
+interface MoversMatchingWithLinesGroupRendererProps {
+    partNumber: number;
+    partName?: string;
+    questionCount: number;
+    instruction: string;
+    data: MatchingWithLinesGroupPartData;
+    answers: Record<string, string | undefined>;
+    onAnswerChange: (questionId: string, value: string) => void;
+    isReviewMode?: boolean;
+}
+export declare function MoversMatchingWithLinesGroupRenderer({ partNumber, partName, questionCount, instruction, data, answers, onAnswerChange, isReviewMode, }: MoversMatchingWithLinesGroupRendererProps): import("react").JSX.Element;
+export {};

package/dist/components/exams/take/components/question-renderers/MoversMatchingWithLinesGroupRenderer.js

@@ -0,0 +1,31 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import CambridgeYlePartBanner from '../../../../../components/themes/cambridge-yle/CambridgeYlePartBanner';
+import CambridgeYleInstructionBanner from '../../../../../components/themes/cambridge-yle/CambridgeYleInstructionBanner';
+import { MatchingWithLinesGroupClient } from '../../../../questions/types/matching-with-lines-group/MatchingWithLinesGroupClient';
+export function MoversMatchingWithLinesGroupRenderer({ partNumber, partName, questionCount, instruction, data, answers, onAnswerChange, isReviewMode = false, }) {
+    const userAnswers = data.questions.map((question) => {
+        if (question.isExample)
+            return question.correctRightId;
+        const raw = answers[question.id];
+        return typeof raw === 'string' ? raw : '';
+    });
+    return (_jsxs("div", { className: "w-full space-y-4", children: [_jsx(CambridgeYlePartBanner, { partNumber: partNumber, partName: partName, questionCount: questionCount }), _jsx(CambridgeYleInstructionBanner, { instruction: instruction }), _jsx("div", { className: "mt-4", children: _jsx(MatchingWithLinesGroupClient, { questionData: {
+                        title: data.title,
+                        instruction: data.instruction,
+                        rightItems: data.rightItems,
+                        items: data.questions.map((question) => ({
+                            imageUrl: question.imageUrl,
+                            correctAnswer: question.correctRightId,
+                            isExample: question.isExample,
+                            points: question.points,
+                            questionNumber: question.questionNumber,
+                        })),
+                        explanation: data.explanation,
+                    }, isReviewMode: isReviewMode, userAnswers: userAnswers, onAnswerChange: (index, rightId) => {
+                        const target = data.questions[index];
+                        if (target && !target.isExample) {
+                            onAnswerChange(target.id, rightId);
+                        }
+                    } }) })] }));
+}

package/dist/components/exams/take/components/question-renderers/index.d.ts

@@ -11,6 +11,7 @@ export { MoversFillWordHintRenderer } from './MoversFillWordHintRenderer';
 export { MoversGridFillRenderer } from './MoversGridFillRenderer';
 export { MoversTrueFalseRenderer } from './MoversTrueFalseRenderer';
 export { MoversTrueFalseCorrectGroupRenderer } from './MoversTrueFalseCorrectGroupRenderer';
+export { MoversFillInBlankGroupRenderer } from './MoversFillInBlankGroupRenderer';
 export { MoversCrossOutWordGroupRenderer } from './MoversCrossOutWordGroupRenderer';
 export { MoversAnswerTheQuestionRenderer } from './MoversAnswerTheQuestionRenderer';
 export { MoversWriteSentencesRenderer } from './MoversWriteSentencesRenderer';
@@ -20,6 +21,7 @@ export { MoversMatchByWritingAnswerRenderer } from './MoversMatchByWritingAnswer
 export { MoversMatchWordToPictureRenderer } from './MoversMatchWordToPictureRenderer';
 export { MoversWordFillStructuredFormRenderer } from './MoversWordFillStructuredFormRenderer';
 export { MoversWordOrderAndMatchGroupRenderer } from './MoversWordOrderAndMatchGroupRenderer';
+export { MoversMatchingWithLinesGroupRenderer } from './MoversMatchingWithLinesGroupRenderer';
 export { MoversCrosswordPuzzleRenderer } from './MoversCrosswordPuzzleRenderer';
 export { FindWordsInMatrixRenderer } from './FindWordsInMatrixRenderer';
 export { ArticlesViewer } from './ArticlesViewer';

package/dist/components/exams/take/components/question-renderers/index.js

@@ -15,6 +15,7 @@ export { MoversGridFillRenderer } from './MoversGridFillRenderer';
 // Starters & Movers renderers
 export { MoversTrueFalseRenderer } from './MoversTrueFalseRenderer';
 export { MoversTrueFalseCorrectGroupRenderer } from './MoversTrueFalseCorrectGroupRenderer';
+export { MoversFillInBlankGroupRenderer } from './MoversFillInBlankGroupRenderer';
 export { MoversCrossOutWordGroupRenderer } from './MoversCrossOutWordGroupRenderer';
 export { MoversAnswerTheQuestionRenderer } from './MoversAnswerTheQuestionRenderer';
 export { MoversWriteSentencesRenderer } from './MoversWriteSentencesRenderer';
@@ -24,6 +25,7 @@ export { MoversMatchByWritingAnswerRenderer } from './MoversMatchByWritingAnswer
 export { MoversMatchWordToPictureRenderer } from './MoversMatchWordToPictureRenderer';
 export { MoversWordFillStructuredFormRenderer } from './MoversWordFillStructuredFormRenderer';
 export { MoversWordOrderAndMatchGroupRenderer } from './MoversWordOrderAndMatchGroupRenderer';
+export { MoversMatchingWithLinesGroupRenderer } from './MoversMatchingWithLinesGroupRenderer';
 export { MoversCrosswordPuzzleRenderer } from './MoversCrosswordPuzzleRenderer';
 export { FindWordsInMatrixRenderer } from './FindWordsInMatrixRenderer';
 export { ArticlesViewer } from './ArticlesViewer';

package/dist/components/exams/take/utils/answer-transformers.js

@@ -88,6 +88,8 @@ function findParentQuestion(subQuestionId, parts) {
             part.questionType === 'CROSS_OUT_WORD_GROUP' ||
             part.questionType === 'TRUE_FALSE_GROUP' ||
             part.questionType === 'TRUE_FALSE_CORRECT_GROUP' ||
+            part.questionType === 'FILL_IN_BLANK_GROUP' ||
+            part.questionType === 'MATCHING_WITH_LINES_GROUP' ||
             part.questionType === 'WORD_ORDER_AND_MATCH_GROUP' ||
             part.questionType === 'SPONTANEOUS_QA_GROUP' ||
             part.questionType === 'ANSWER_THE_QUESTION_GROUP') {
@@ -381,6 +383,20 @@ export function transformAnswersForSubmission(answers, parts) {
                     }
                     return { isTrue: null, correction: '' };
                 }
+                if (parentType === 'FILL_IN_BLANK_GROUP') {
+                    if (raw && typeof raw === 'object' && !Array.isArray(raw) && Array.isArray(raw.answers)) {
+                        return {
+                            answers: raw.answers.map((value) => String(value ?? '')),
+                        };
+                    }
+                    if (Array.isArray(raw)) {
+                        return { answers: raw.map((value) => String(value ?? '')) };
+                    }
+                    if (typeof raw === 'string') {
+                        return { answers: [raw] };
+                    }
+                    return { answers: [] };
+                }
                 if (parentType === 'WORD_ORDER_AND_MATCH_GROUP') {
                     if (raw && typeof raw === 'object' && !Array.isArray(raw)) {
                         const obj = raw;

package/dist/components/exams/take/utils/question-transformers.d.ts

@@ -5,7 +5,7 @@
  * Each transformer handles specific question type data structure.
  */
 import type { FillBlankQuestion, ChooseBestAnswerQuestion, PictureChooseSubQuestion, PictureFillBlankSubQuestion, ReadingPassageQuestion, LabelThePictureLabel, FillWordHintSubQuestion, ColoringHintItem, ColoringRegion } from '../types';
-export type QuestionType = 'FILL_IN_BLANK' | 'WRITE_CORRECT_VERB_FORM' | 'CHOOSE_THE_CORRECT_ANSWER' | 'CHOOSE_THE_CORRECT_ANSWER_GROUP' | 'CHOOSE_CORRECT_ADJECTIVE' | 'WRITE_A_SHORT_LETTER' | 'READ_AND_COLOR_OBJECTS' | 'LOOK_PICTURE_CHOOSE_CORRECT_ANSWER' | 'LOOK_PICTURE_FILL_BLANK_CHOOSE_ANSWER' | 'READ_PASSAGE_AND_ANSWER_QUESTIONS' | 'LABEL_THE_PICTURE' | 'LOOK_PICTURE_FILL_WORD_HINT' | 'FILL_MISSING_WORDS_IN_GRID' | 'IMAGE_OBJECT_MATCHING' | 'ANSWER_THE_QUESTION' | 'ANSWER_THE_QUESTION_GROUP' | 'TRUE_FALSE' | 'TRUE_FALSE_GROUP' | 'TRUE_FALSE_CORRECT_GROUP' | 'CROSS_OUT_WORD_GROUP' | 'WORD_ORDERING' | 'WORD_FILL_PARAGRAPH' | 'MATCH_BY_WRITING_ANSWER' | 'MATCH_WORD_TO_PICTURE' | 'WRITE_SENTENCES' | 'WORD_FILL_STRUCTURED_FORM' | 'CROSSWORD_PUZZLE' | 'FIND_WORDS_IN_MATRIX' | 'WORD_ORDER_AND_MATCH_GROUP' | 'LISTEN_AND_CHOOSE_OBJECTS_IN_SCENE' | 'LISTEN_AND_CHOOSE_FROM_ANSWER_GROUP' | 'LISTEN_AND_DRAG_OBJECTS_INTO_SCENE' | 'LISTEN_AND_SPEAK_ANSWER' | 'LISTEN_AND_SPEAK_COMPARE_IMAGES' | 'LISTEN_AND_SPEAK_WITH_STORY_IMAGES' | 'LISTEN_AND_SPEAK_IMAGE_GROUP' | 'LISTEN_AND_SPEAK_ODD_ONE_OUT' | 'LISTEN_AND_SPEAK_QUESTION_LIST' | 'LISTEN_AND_SPEAK_INFO_EXCHANGE' | 'READ_DISPLAYED_CONTENT' | 'SPEAKING_DESCRIBE_IMAGE' | 'SPONTANEOUS_QA' | 'SPONTANEOUS_QA_GROUP' | 'SPEAKING_CONVERSATION' | 'GN_SPEAKING_INTERVIEW' | 'SPEAKING_CUE_CARD';
+export type QuestionType = 'FILL_IN_BLANK' | 'WRITE_CORRECT_VERB_FORM' | 'CHOOSE_THE_CORRECT_ANSWER' | 'CHOOSE_THE_CORRECT_ANSWER_GROUP' | 'CHOOSE_CORRECT_ADJECTIVE' | 'WRITE_A_SHORT_LETTER' | 'READ_AND_COLOR_OBJECTS' | 'LOOK_PICTURE_CHOOSE_CORRECT_ANSWER' | 'LOOK_PICTURE_FILL_BLANK_CHOOSE_ANSWER' | 'READ_PASSAGE_AND_ANSWER_QUESTIONS' | 'LABEL_THE_PICTURE' | 'LOOK_PICTURE_FILL_WORD_HINT' | 'FILL_MISSING_WORDS_IN_GRID' | 'IMAGE_OBJECT_MATCHING' | 'ANSWER_THE_QUESTION' | 'ANSWER_THE_QUESTION_GROUP' | 'TRUE_FALSE' | 'TRUE_FALSE_GROUP' | 'TRUE_FALSE_CORRECT_GROUP' | 'FILL_IN_BLANK_GROUP' | 'MATCHING_WITH_LINES_GROUP' | 'CROSS_OUT_WORD_GROUP' | 'WORD_ORDERING' | 'WORD_FILL_PARAGRAPH' | 'MATCH_BY_WRITING_ANSWER' | 'MATCH_WORD_TO_PICTURE' | 'WRITE_SENTENCES' | 'WORD_FILL_STRUCTURED_FORM' | 'CROSSWORD_PUZZLE' | 'FIND_WORDS_IN_MATRIX' | 'WORD_ORDER_AND_MATCH_GROUP' | 'LISTEN_AND_CHOOSE_OBJECTS_IN_SCENE' | 'LISTEN_AND_CHOOSE_FROM_ANSWER_GROUP' | 'LISTEN_AND_DRAG_OBJECTS_INTO_SCENE' | 'LISTEN_AND_SPEAK_ANSWER' | 'LISTEN_AND_SPEAK_COMPARE_IMAGES' | 'LISTEN_AND_SPEAK_WITH_STORY_IMAGES' | 'LISTEN_AND_SPEAK_IMAGE_GROUP' | 'LISTEN_AND_SPEAK_ODD_ONE_OUT' | 'LISTEN_AND_SPEAK_QUESTION_LIST' | 'LISTEN_AND_SPEAK_INFO_EXCHANGE' | 'READ_DISPLAYED_CONTENT' | 'SPEAKING_DESCRIBE_IMAGE' | 'SPONTANEOUS_QA' | 'SPONTANEOUS_QA_GROUP' | 'SPEAKING_CONVERSATION' | 'GN_SPEAKING_INTERVIEW' | 'SPEAKING_CUE_CARD';
 export interface ApiQuestion {
     id: string;
     content: any;
@@ -285,6 +285,31 @@ export declare function transformTrueFalseCorrectGroup(questions: ApiQuestion[])
     questions: TrueFalseCorrectGroupQuestion[];
     instruction: string;
 };
+export interface FillInBlankGroupItemAnswer {
+    answers: string[][];
+    caseSensitive?: boolean;
+}
+export interface FillInBlankGroupStudentItemAnswer {
+    answers: string[];
+}
+export interface FillInBlankGroupQuestion {
+    id: string;
+    questionNumber: number;
+    question: string;
+    imageUrl?: string;
+    audioUrl?: string;
+    isExample: boolean;
+    blankCount: number;
+    exampleAnswers?: string[];
+}
+export declare function transformFillInBlankGroup(questions: ApiQuestion[]): {
+    questions: FillInBlankGroupQuestion[];
+    instruction: string;
+    audioUrl?: string;
+    imageUrl?: string;
+    showHints?: boolean;
+    hints?: string[];
+};
 export interface WordOrderingQuestion {
     id: string;
     questionNumber: number;
@@ -505,3 +530,22 @@ export interface FindWordsInMatrixPartData {
     explanation?: string;
 }
 export declare function transformFindWordsInMatrix(questions: ApiQuestion[]): FindWordsInMatrixPartData;
+export interface MatchingWithLinesGroupQuestionItem {
+    id: string;
+    questionNumber: number;
+    imageUrl: string;
+    correctRightId: string;
+    isExample: boolean;
+    points: number;
+}
+export interface MatchingWithLinesGroupPartData {
+    questions: MatchingWithLinesGroupQuestionItem[];
+    rightItems: Array<{
+        id: string;
+        text: string;
+    }>;
+    title?: string;
+    instruction: string;
+    explanation?: string;
+}
+export declare function transformMatchingWithLinesGroup(questions: ApiQuestion[]): MatchingWithLinesGroupPartData;

package/dist/components/exams/take/utils/question-transformers.js

@@ -962,6 +962,63 @@ export function transformTrueFalseCorrectGroup(questions) {
             || 'Tick (✓) the true and cross (✗) the false sentences. Correct the false sentences.',
     };
 }
+function parseFillInBlankGroupAnswer(raw) {
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+        return undefined;
+    }
+    const obj = raw;
+    if (!Array.isArray(obj.answers)) {
+        return undefined;
+    }
+    return {
+        answers: obj.answers.map((blank) => (Array.isArray(blank)
+            ? blank.map((alt) => String(alt ?? '').trim()).filter(Boolean)
+            : [String(blank ?? '').trim()].filter(Boolean))),
+        caseSensitive: obj.caseSensitive === true,
+    };
+}
+function blankCountFromMatches(matches) {
+    const indices = matches.map((match) => Number.parseInt(match[1], 10));
+    return Math.max(...indices, 0) + 1;
+}
+export function transformFillInBlankGroup(questions) {
+    const parent = questions[0];
+    const content = parent?.content;
+    const items = Array.isArray(content?.items) ? content.items : [];
+    const parentCorrect = Array.isArray(parent?.correct_answer?.answer)
+        ? parent.correct_answer.answer
+        : [];
+    const groupAudioUrl = content?.meta?.audioUrl?.trim() || '';
+    const transformed = items.map((item, index) => {
+        const parsed = parseFillInBlankGroupAnswer(item.correctAnswer ?? parentCorrect[index]);
+        const question = item.content?.question || '{0}';
+        const blankMatches = [...question.matchAll(/\{(\d+)\}/g)];
+        const blankCount = blankMatches.length > 0 ? blankCountFromMatches(blankMatches) : 1;
+        const isExample = item.isExample === true;
+        return {
+            id: `${parent.id}-item-${index}`,
+            questionNumber: item.questionNumber || index + 1,
+            question,
+            imageUrl: item.content?.imageUrl,
+            audioUrl: groupAudioUrl ? undefined : item.content?.audioUrl,
+            isExample,
+            blankCount,
+            exampleAnswers: isExample
+                ? Array.from({ length: blankCount }, (_, slot) => parsed?.answers?.[slot]?.[0] || '')
+                : undefined,
+        };
+    });
+    return {
+        questions: transformed,
+        instruction: content?.meta?.instruction || 'Complete the sentences.',
+        audioUrl: groupAudioUrl || undefined,
+        imageUrl: content?.meta?.imageUrl,
+        showHints: content?.meta?.showHints === true,
+        hints: Array.isArray(content?.meta?.hints)
+            ? content.meta.hints.map((hint) => String(hint ?? '').trim()).filter(Boolean)
+            : [],
+    };
+}
 export function transformWordOrdering(questions) {
     const transformed = questions.map((q) => {
         const content = q.content;
@@ -1326,3 +1383,36 @@ export function transformFindWordsInMatrix(questions) {
         explanation: question?.explanation,
     };
 }
+export function transformMatchingWithLinesGroup(questions) {
+    const parent = questions[0];
+    const content = (parent?.content || {});
+    const items = Array.isArray(content.items) ? content.items : [];
+    const parentCorrect = Array.isArray(parent?.correct_answer?.answer)
+        ? parent.correct_answer.answer
+        : [];
+    const rightItems = Array.isArray(content.rightItems)
+        ? content.rightItems.map((item, index) => ({
+            id: typeof item?.id === 'string' ? item.id : `r${index + 1}`,
+            text: typeof item?.text === 'string' ? item.text : '',
+        }))
+        : [];
+    return {
+        questions: items.map((item, index) => {
+            const isExample = item.isExample === true;
+            const fromItem = typeof item.correctAnswer?.answer === 'string' ? item.correctAnswer.answer : '';
+            const fromParent = typeof parentCorrect[index] === 'string' ? parentCorrect[index] : '';
+            return {
+                id: `${parent?.id || 'q'}-item-${index}`,
+                questionNumber: item.questionNumber || index + 1,
+                imageUrl: item.content?.imageUrl || '',
+                correctRightId: fromItem || fromParent,
+                isExample,
+                points: isExample ? 0 : (typeof item.points === 'number' ? item.points : 1),
+            };
+        }),
+        rightItems,
+        title: content.meta?.title || '',
+        instruction: content.meta?.instruction || 'Look and match.',
+        explanation: parent?.explanation,
+    };
+}

package/dist/components/questions/_shared/config/question-types.config.js

@@ -177,6 +177,11 @@ export const QUESTION_TYPE_CONFIG = {
         requiresContent: true,
         hasDedicatedComponent: true,
     },
+    FILL_IN_BLANK_GROUP: {
+        label: 'Điền chỗ trống (nhóm)',
+        requiresContent: true,
+        hasDedicatedComponent: true,
+    },
     CROSS_OUT_WORD_GROUP: {
         label: 'Cross out word (group)',
         requiresContent: true,
@@ -237,6 +242,11 @@ export const QUESTION_TYPE_CONFIG = {
         requiresContent: true,
         hasDedicatedComponent: true,
     },
+    MATCHING_WITH_LINES_GROUP: {
+        label: 'Nối bằng đường kẻ (nhóm)',
+        requiresContent: true,
+        hasDedicatedComponent: true,
+    },
     WRITE_SENTENCES: {
         label: 'Viết câu',
         requiresContent: true,
@@ -354,6 +364,7 @@ export const QUESTION_TYPES_WITH_DEDICATED_COMPONENTS = [
     'CHOOSE_THE_CORRECT_ANSWER_GROUP',
     'TRUE_FALSE_GROUP',
     'TRUE_FALSE_CORRECT_GROUP',
+    'FILL_IN_BLANK_GROUP',
     'CROSS_OUT_WORD_GROUP',
     'WRITE_A_SHORT_LETTER',
     'WRITE_CORRECT_VERB_FORM',
@@ -365,6 +376,7 @@ export const QUESTION_TYPES_WITH_DEDICATED_COMPONENTS = [
     'WORD_FILL_PARAGRAPH',
     'MATCH_BY_WRITING_ANSWER',
     'MATCH_WORD_TO_PICTURE',
+    'MATCHING_WITH_LINES_GROUP',
     'WRITE_SENTENCES',
     'LISTEN_AND_CHOOSE_FROM_ANSWER_GROUP',
     'LISTEN_AND_CHOOSE_OBJECTS_IN_SCENE',

package/dist/components/questions/_shared/types/fill-in-blank-group.type.d.ts

@@ -0,0 +1,50 @@
+import type { MutableRefObject } from 'react';
+export declare const FILL_IN_BLANK_ITEM_TYPE: "FILL_IN_BLANK";
+export declare const FILL_IN_BLANK_GROUP_DEFAULT_INSTRUCTION = "Complete the sentences.";
+export interface FillInBlankGroupItemAnswer {
+    answers: string[][];
+    caseSensitive?: boolean;
+}
+export interface FillInBlankGroupStudentItemAnswer {
+    answers: string[];
+}
+export interface FillInBlankGroupItemData {
+    question: string;
+    answers: string[][];
+    caseSensitive?: boolean;
+    imageUrl?: string;
+    audioUrl?: string;
+    showHints?: boolean;
+    hints?: string[];
+    isExample?: boolean;
+    points: number;
+    questionNumber: number;
+}
+export interface FillInBlankGroupData {
+    instruction: string;
+    audioUrl?: string;
+    imageUrl?: string;
+    showHints?: boolean;
+    hints?: string[];
+    items: FillInBlankGroupItemData[];
+    explanation?: string;
+    points?: number;
+}
+export interface FillInBlankGroupCreatorProps {
+    initialData?: FillInBlankGroupData;
+    onSave?: (data: FillInBlankGroupData) => void;
+    onCancel?: () => void;
+    onChange?: (data: FillInBlankGroupData) => void;
+    externalErrors?: string[];
+    onUnsavedChangesChange?: (hasUnsavedChanges: boolean) => void;
+    validationRef?: MutableRefObject<{
+        triggerValidation: () => Promise<boolean>;
+        getFormData?: () => FillInBlankGroupData;
+    } | null>;
+}
+export interface FillInBlankGroupClientProps {
+    questionData: FillInBlankGroupData;
+    isReviewMode?: boolean;
+    userAnswers?: FillInBlankGroupStudentItemAnswer[];
+    onAnswerChange?: (answers: FillInBlankGroupStudentItemAnswer[]) => void;
+}

package/dist/components/questions/_shared/types/fill-in-blank-group.type.js

@@ -0,0 +1,2 @@
+export const FILL_IN_BLANK_ITEM_TYPE = 'FILL_IN_BLANK';
+export const FILL_IN_BLANK_GROUP_DEFAULT_INSTRUCTION = 'Complete the sentences.';

package/dist/components/questions/_shared/types/index.d.ts

@@ -12,5 +12,7 @@ export * from './fill-in-blank.type';
 export * from './read-passage-and-answer-questions.type';
 export * from './word-fill-structured-form.type';
 export * from './true-false-correct-group.type';
+export * from './fill-in-blank-group.type';
 export * from './match-word-to-picture.type';
+export * from './matching-with-lines-group.type';
 export * from './spontaneous-qa-group.type';

package/dist/components/questions/_shared/types/index.js

@@ -12,5 +12,7 @@ export * from './fill-in-blank.type';
 export * from './read-passage-and-answer-questions.type';
 export * from './word-fill-structured-form.type';
 export * from './true-false-correct-group.type';
+export * from './fill-in-blank-group.type';
 export * from './match-word-to-picture.type';
+export * from './matching-with-lines-group.type';
 export * from './spontaneous-qa-group.type';

package/dist/components/questions/_shared/types/matching-with-lines-group.type.d.ts

@@ -0,0 +1,40 @@
+import type { MutableRefObject } from 'react';
+export declare const MATCHING_WITH_LINES_GROUP_DEFAULT_INSTRUCTION = "Look and match.";
+export interface MatchingWithLinesRightItem {
+    id: string;
+    text: string;
+}
+export interface MatchingWithLinesGroupItemData {
+    imageUrl: string;
+    correctAnswer: string;
+    isExample?: boolean;
+    points: number;
+    questionNumber: number;
+}
+export interface MatchingWithLinesGroupData {
+    title?: string;
+    instruction: string;
+    rightItems: MatchingWithLinesRightItem[];
+    items: MatchingWithLinesGroupItemData[];
+    explanation?: string;
+    points?: number;
+}
+export interface MatchingWithLinesGroupCreatorProps {
+    initialData?: MatchingWithLinesGroupData;
+    onSave?: (data: MatchingWithLinesGroupData) => void;
+    onCancel?: () => void;
+    onChange?: (data: MatchingWithLinesGroupData) => void;
+    externalErrors?: string[];
+    onUnsavedChangesChange?: (hasUnsavedChanges: boolean) => void;
+    validationRef?: MutableRefObject<{
+        triggerValidation: () => Promise<boolean>;
+        getFormData?: () => MatchingWithLinesGroupData;
+    } | null>;
+}
+export interface MatchingWithLinesGroupClientProps {
+    questionData: MatchingWithLinesGroupData;
+    isReviewMode?: boolean;
+    userAnswers?: string[];
+    onAnswerChange?: (index: number, rightId: string) => void;
+    onAnswersChange?: (next: string[]) => void;
+}

package/dist/components/questions/_shared/types/matching-with-lines-group.type.js

@@ -0,0 +1 @@
+export const MATCHING_WITH_LINES_GROUP_DEFAULT_INSTRUCTION = 'Look and match.';

package/dist/components/questions/components/QuestionSearchDropdown.js

@@ -23,11 +23,13 @@ const IMAGE_BASED_TYPES = [
     'LOOK_PICTURE_CHOOSE_CORRECT_ANSWER',
     'LOOK_PICTURE_FILL_WORD_HINT',
     'FILL_IN_BLANK',
+    'FILL_IN_BLANK_GROUP',
     'LABEL_THE_PICTURE',
     'READ_AND_COLOR_OBJECTS',
     'IMAGE_OBJECT_MATCHING',
     'FILL_IN_BLANK',
     'MATCH_WORD_TO_PICTURE',
+    'MATCHING_WITH_LINES_GROUP',
 ];
 // Passage-based question types
 const PASSAGE_BASED_TYPES = [
@@ -62,8 +64,10 @@ const getQuestionTypeName = (type) => {
         'IMAGE_OBJECT_MATCHING': 'Ghép hình ảnh - Đối tượng',
         'WRITE_CORRECT_VERB_FORM': 'Viết dạng động từ',
         'FILL_IN_BLANK': 'Điền vào chỗ trống',
+        'FILL_IN_BLANK_GROUP': 'Điền chỗ trống (nhóm)',
         'READ_PASSAGE_AND_ANSWER_QUESTIONS': 'Đọc hiểu',
         'MATCH_WORD_TO_PICTURE': 'Nối từ với tranh',
+        'MATCHING_WITH_LINES_GROUP': 'Nối bằng đường kẻ (nhóm)',
     };
     return type ? typeMap[type] || type.replace(/_/g, ' ').toLowerCase() : 'Chưa xác định';
 };

package/dist/components/questions/components/QuestionTypeSelector.js

@@ -27,7 +27,9 @@ export function QuestionTypeSelector({ value, onValueChange, disabled, }) {
         'WORD_ORDERING',
         'MATCH_BY_WRITING_ANSWER',
         'MATCH_WORD_TO_PICTURE',
+        'MATCHING_WITH_LINES_GROUP',
         'WRITE_SENTENCES',
+        'FILL_IN_BLANK_GROUP',
     ];
     return (_jsxs(Select, { value: value, onValueChange: onValueChange, disabled: disabled, children: [_jsx(SelectTrigger, { id: "questionType", className: "mt-1", children: _jsx(SelectValue, { placeholder: "Ch\u1ECDn lo\u1EA1i c\u00E2u h\u1ECFi" }) }), _jsx(SelectContent, { children: questionTypes.map((type) => (_jsx(SelectItem, { value: type, children: getQuestionTypeLabel(type) }, type))) })] }));
 }