@tinyweb_dev/oe-exam-sdk 0.2.4 → 0.2.6

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

@@ -10,14 +10,18 @@ export { MoversLabelThePictureRenderer } from './MoversLabelThePictureRenderer';
 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';
 export { MoversWordOrderingRenderer } from './MoversWordOrderingRenderer';
 export { MoversWordFillParagraphRenderer } from './MoversWordFillParagraphRenderer';
 export { MoversMatchByWritingAnswerRenderer } from './MoversMatchByWritingAnswerRenderer';
+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

@@ -14,14 +14,18 @@ export { MoversFillWordHintRenderer } from './MoversFillWordHintRenderer';
 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';
 export { MoversWordOrderingRenderer } from './MoversWordOrderingRenderer';
 export { MoversWordFillParagraphRenderer } from './MoversWordFillParagraphRenderer';
 export { MoversMatchByWritingAnswerRenderer } from './MoversMatchByWritingAnswerRenderer';
+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/exam-taking.utils.d.ts

@@ -113,6 +113,7 @@ export declare function transformWriteShortLetter(question: ExamTakingQuestion |
     minWords: number | undefined;
     maxWords: number | undefined;
     guideImages: string[];
+    passage: string | undefined;
 };
 export declare function transformWordFillStructuredForm(questions: ExamTakingQuestion[]): {
     instruction: string;

package/dist/components/exams/take/exam-taking.utils.js

@@ -61,7 +61,7 @@ export function transformWordFillParagraph(questions) {
  */
 export function transformWriteShortLetter(question) {
     if (!question) {
-        return { prompt: '', requirements: [], minWords: undefined, maxWords: undefined, guideImages: [] };
+        return { prompt: '', requirements: [], minWords: undefined, maxWords: undefined, guideImages: [], passage: undefined };
     }
     const content = asRecord(question.content);
     const instructions = asRecord(content.instructions);
@@ -72,6 +72,12 @@ export function transformWriteShortLetter(question) {
     const guideImages = readStringArray(question.content, 'guideImages');
     const minWords = readNumber(question.content, 'minWords');
     const maxWords = readNumber(question.content, 'maxWords');
+    const passageRaw = content.passage ?? content.passages;
+    const passage = typeof passageRaw === 'string' && passageRaw.trim()
+        ? passageRaw
+        : Array.isArray(passageRaw)
+            ? passageRaw.filter((item) => typeof item === 'string' && item.trim().length > 0).join('\n\n') || undefined
+            : undefined;
     // New structure: use instructions.mainInstruction as prompt, informations as requirements
     if (mainInstruction || informations.length) {
         return {
@@ -80,6 +86,7 @@ export function transformWriteShortLetter(question) {
             minWords,
             maxWords,
             guideImages,
+            passage,
         };
     }
     // Legacy structure: build prompt from contexts array
@@ -99,6 +106,7 @@ export function transformWriteShortLetter(question) {
         minWords,
         maxWords,
         guideImages,
+        passage,
     };
 }
 export function transformWordFillStructuredForm(questions) {

package/dist/components/exams/take/types.d.ts

@@ -115,6 +115,7 @@ export interface ChooseBestAnswerOption {
     id: string;
     label: string;
     text: string;
+    imageUrl?: string;
 }
 export interface ChooseBestAnswerQuestion {
     id: string;
@@ -123,7 +124,7 @@ export interface ChooseBestAnswerQuestion {
     options: ChooseBestAnswerOption[];
     correctOptionId?: string;
     correctOptionIds?: string[];
-    imageUrl?: string;
+    imageUrl?: string | string[];
     audioUrl?: string;
     optionType?: 'text' | 'image';
     multipleAnswers?: boolean;
@@ -135,7 +136,7 @@ export interface ChooseBestAnswerExample {
     options: ChooseBestAnswerOption[];
     correctOptionId: string;
     optionType?: 'text' | 'image';
-    imageUrl?: string;
+    imageUrl?: string | string[];
     audioUrl?: string;
 }
 export interface MoversChooseBestAnswerRendererProps {

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

@@ -87,6 +87,9 @@ function findParentQuestion(subQuestionId, parts) {
         if (part.questionType === 'CHOOSE_THE_CORRECT_ANSWER_GROUP' ||
             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') {
@@ -369,6 +372,31 @@ export function transformAnswersForSubmission(answers, parts) {
                 if (parentType === 'CROSS_OUT_WORD_GROUP') {
                     return normalizeCrossOutWordGroupAnswer(raw);
                 }
+                if (parentType === 'TRUE_FALSE_CORRECT_GROUP') {
+                    if (raw && typeof raw === 'object' && !Array.isArray(raw)) {
+                        const obj = raw;
+                        const isTrue = obj.isTrue === true ? true : obj.isTrue === false ? false : null;
+                        return {
+                            isTrue,
+                            correction: typeof obj.correction === 'string' ? obj.correction : '',
+                        };
+                    }
+                    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' | 'CROSS_OUT_WORD_GROUP' | 'WORD_ORDERING' | 'WORD_FILL_PARAGRAPH' | 'MATCH_BY_WRITING_ANSWER' | '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;
@@ -184,6 +184,7 @@ export declare function transformWriteShortLetter(question: ApiQuestion): {
     minWords?: number;
     maxWords?: number;
     guideImages?: string[];
+    passage?: string;
 };
 export declare function transformColorObjects(questions: ApiQuestion[]): {
     instruction: string;
@@ -269,6 +270,46 @@ export declare function transformTrueFalseGroup(questions: ApiQuestion[]): {
     imageUrl?: string;
     groupContent?: string;
 };
+export interface TrueFalseCorrectItemAnswer {
+    isTrue: boolean | null;
+    correction: string;
+}
+export interface TrueFalseCorrectGroupQuestion {
+    id: string;
+    questionNumber: number;
+    question: string;
+    isExample: boolean;
+    exampleCorrectAnswer?: TrueFalseCorrectItemAnswer;
+}
+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;
@@ -321,6 +362,18 @@ export declare function transformMatchByWritingAnswer(questions: ApiQuestion[]):
     askerName?: string;
     answererName?: string;
 };
+export interface MatchWordToPictureQuestion {
+    id: string;
+    questionNumber: number;
+    imageUrl?: string;
+    isExample: boolean;
+    exampleAnswer?: string;
+}
+export declare function transformMatchWordToPicture(questions: ApiQuestion[]): {
+    questions: MatchWordToPictureQuestion[];
+    wordBank: string[];
+    instruction: string;
+};
 export declare function transformWriteSentences(questions: ApiQuestion[]): {
     questions: Array<{
         id: string;
@@ -477,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

@@ -428,23 +428,43 @@ export function transformChooseTheCorrectAnswerGroup(questions) {
             ...(isObj && opt.imageUrl ? { imageUrl: opt.imageUrl } : {}),
         };
     });
+    const toQuestionImageUrl = (value) => {
+        if (typeof value === 'string') {
+            const trimmed = value.trim();
+            return trimmed !== '' ? trimmed : undefined;
+        }
+        if (!Array.isArray(value)) {
+            return undefined;
+        }
+        const urls = value
+            .filter((url) => typeof url === 'string')
+            .map((url) => url.trim())
+            .filter((url) => url !== '');
+        if (urls.length === 0) {
+            return undefined;
+        }
+        return urls.length === 1 ? urls[0] : urls;
+    };
     let example;
     if (exampleItem) {
         const exampleIndex = items.indexOf(exampleItem);
         const exOptions = mapOptions(exampleItem.content?.options, `${parent.id}-ex`);
         const exCorrect = exampleItem.correctAnswer?.answer || parentCorrect[exampleIndex] || exOptions[0]?.id || '';
+        const exampleImageUrl = toQuestionImageUrl(exampleItem.content?.imageUrl);
         example = {
             questionNumber: exampleItem.questionNumber || exampleIndex + 1,
             questionText: exampleItem.content?.question || '',
             options: exOptions,
             correctOptionId: exCorrect,
             optionType: (exampleItem.content?.optionType || 'text'),
+            ...(exampleImageUrl !== undefined ? { imageUrl: exampleImageUrl } : {}),
         };
     }
     const transformed = regularItems.map((item) => {
         const itemIndex = items.indexOf(item);
         const options = mapOptions(item.content?.options, `${parent.id}-item-${itemIndex}`);
         const correctId = item.correctAnswer?.answer || parentCorrect[itemIndex] || '';
+        const itemImageUrl = toQuestionImageUrl(item.content?.imageUrl);
         return {
             id: `${parent.id}-item-${itemIndex}`,
             questionNumber: item.questionNumber || itemIndex + 1,
@@ -453,6 +473,7 @@ export function transformChooseTheCorrectAnswerGroup(questions) {
             correctOptionId: correctId,
             correctOptionIds: correctId ? [correctId] : [],
             optionType: (item.content?.optionType || 'text'),
+            ...(itemImageUrl !== undefined ? { imageUrl: itemImageUrl } : {}),
         };
     });
     return {
@@ -486,8 +507,19 @@ export function transformChooseCorrectAdjective(questions) {
         instruction: 'CHOOSE THE CORRECT ADJECTIVE',
     };
 }
+function extractWriteLetterPassage(content) {
+    const raw = content?.passage ?? content?.passages;
+    if (typeof raw === 'string' && raw.trim())
+        return raw;
+    if (Array.isArray(raw)) {
+        const parts = raw.filter((item) => typeof item === 'string' && item.trim().length > 0);
+        return parts.length ? parts.join('\n\n') : undefined;
+    }
+    return undefined;
+}
 export function transformWriteShortLetter(question) {
     const content = question.content;
+    const passage = extractWriteLetterPassage(content);
     // New structure: use instructions.mainInstruction as prompt, informations as requirements
     if (content.instructions?.mainInstruction || content.informations?.length) {
         return {
@@ -496,6 +528,7 @@ export function transformWriteShortLetter(question) {
             minWords: content.minWords,
             maxWords: content.maxWords,
             guideImages: content.guideImages,
+            passage,
         };
     }
     // Legacy structure: build prompt from contexts array
@@ -508,6 +541,7 @@ export function transformWriteShortLetter(question) {
         minWords: content.minWords,
         maxWords: content.maxWords,
         guideImages: content.guideImages,
+        passage,
     };
 }
 export function transformColorObjects(questions) {
@@ -889,6 +923,102 @@ export function transformTrueFalseGroup(questions) {
         instruction: content?.meta?.instruction || 'READ AND CHOOSE TRUE OR FALSE',
     };
 }
+function parseTrueFalseCorrectAnswer(raw) {
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+        return undefined;
+    }
+    const obj = raw;
+    if (typeof obj.isTrue !== 'boolean') {
+        return undefined;
+    }
+    return {
+        isTrue: obj.isTrue,
+        correction: obj.isTrue ? '' : (typeof obj.correction === 'string' ? obj.correction : ''),
+    };
+}
+export function transformTrueFalseCorrectGroup(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 transformed = items.map((item, index) => {
+        const isExample = item.isExample === true;
+        const exampleCorrectAnswer = isExample
+            ? parseTrueFalseCorrectAnswer(item.correctAnswer?.answer ?? parentCorrect[index])
+            : undefined;
+        return {
+            id: `${parent.id}-item-${index}`,
+            questionNumber: item.questionNumber || index + 1,
+            question: item.content?.question || '',
+            isExample,
+            exampleCorrectAnswer,
+        };
+    });
+    return {
+        questions: transformed,
+        instruction: content?.meta?.instruction
+            || '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;
@@ -993,6 +1123,31 @@ export function transformMatchByWritingAnswer(questions) {
         answererName: firstConversationQ?.answererName,
     };
 }
+export function transformMatchWordToPicture(questions) {
+    const groupPayload = questions[0]?.questionGroup?.payload;
+    const wordBank = Array.isArray(groupPayload?.wordBank)
+        ? groupPayload.wordBank.filter((word) => typeof word === 'string' && word.trim().length > 0)
+        : [];
+    const instruction = typeof groupPayload?.instruction === 'string' && groupPayload.instruction.trim()
+        ? groupPayload.instruction.trim()
+        : 'Look and complete.';
+    const transformed = questions.map((q) => {
+        const content = q.content;
+        const isExample = q.is_example || content.isExample || false;
+        return {
+            id: q.id,
+            questionNumber: q.question_number,
+            imageUrl: content.imageUrl,
+            isExample,
+            exampleAnswer: isExample ? q.correct_answer?.answer : undefined,
+        };
+    });
+    return {
+        questions: transformed,
+        wordBank,
+        instruction,
+    };
+}
 export function transformWriteSentences(questions) {
     const firstQuestion = questions[0];
     const content = firstQuestion?.content;
@@ -1228,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

@@ -172,6 +172,16 @@ export const QUESTION_TYPE_CONFIG = {
         requiresContent: true,
         hasDedicatedComponent: true,
     },
+    TRUE_FALSE_CORRECT_GROUP: {
+        label: 'Đúng/Sai + sửa câu (nhóm)',
+        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,
@@ -227,6 +237,16 @@ export const QUESTION_TYPE_CONFIG = {
         requiresContent: true,
         hasDedicatedComponent: true,
     },
+    MATCH_WORD_TO_PICTURE: {
+        label: 'Nối từ với tranh',
+        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,
@@ -343,6 +363,8 @@ export const QUESTION_TYPES_WITH_DEDICATED_COMPONENTS = [
     'CHOOSE_THE_CORRECT_ANSWER',
     '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',
@@ -353,6 +375,8 @@ export const QUESTION_TYPES_WITH_DEDICATED_COMPONENTS = [
     'WORD_ORDERING',
     '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/choose-the-correct-answer-group.type.d.ts

@@ -1,7 +1,14 @@
 export interface ChooseTheCorrectAnswerGroupOptionData {
     id: string;
     text: string;
+    imageUrl?: string;
 }
+export declare function getChooseAnswerGroupOptionImageSrc(option: Pick<ChooseTheCorrectAnswerGroupOptionData, 'imageUrl' | 'text'>): string;
+export declare function isChooseAnswerGroupOptionFilled(option: Pick<ChooseTheCorrectAnswerGroupOptionData, 'imageUrl' | 'text'>, optionType?: 'text' | 'image'): boolean;
+export type ChooseTheCorrectAnswerGroupImageUrl = string | string[];
+export declare function toChooseAnswerGroupImageUrls(value?: ChooseTheCorrectAnswerGroupImageUrl): string[];
+export declare function toEditableChooseAnswerGroupImageUrls(value?: ChooseTheCorrectAnswerGroupImageUrl): string[];
+export declare function fromChooseAnswerGroupImageUrls(urls: string[]): ChooseTheCorrectAnswerGroupImageUrl | undefined;
 export interface ChooseTheCorrectAnswerGroupItemData {
     question: string;
     optionType: 'text' | 'image';
@@ -10,6 +17,7 @@ export interface ChooseTheCorrectAnswerGroupItemData {
     isExample?: boolean;
     points: number;
     questionNumber: number;
+    imageUrl?: ChooseTheCorrectAnswerGroupImageUrl;
 }
 export interface ChooseTheCorrectAnswerGroupData {
     instruction: string;
@@ -34,4 +42,5 @@ export interface ChooseTheCorrectAnswerGroupClientProps {
     questionData: ChooseTheCorrectAnswerGroupData;
     isReviewMode?: boolean;
     userAnswers?: string[];
+    onAnswerChange?: (answers: string[]) => void;
 }

package/dist/components/questions/_shared/types/choose-the-correct-answer-group.type.js

@@ -1 +1,49 @@
-export {};
+export function getChooseAnswerGroupOptionImageSrc(option) {
+    if (typeof option.imageUrl === 'string' && option.imageUrl.trim() !== '') {
+        return option.imageUrl.trim();
+    }
+    if (typeof option.text === 'string' && option.text.trim() !== '') {
+        return option.text.trim();
+    }
+    return '';
+}
+export function isChooseAnswerGroupOptionFilled(option, optionType = 'text') {
+    if (optionType === 'image') {
+        return getChooseAnswerGroupOptionImageSrc(option) !== '';
+    }
+    return typeof option.text === 'string' && option.text.trim() !== '';
+}
+export function toChooseAnswerGroupImageUrls(value) {
+    if (Array.isArray(value)) {
+        return value
+            .filter((url) => typeof url === 'string')
+            .map((url) => url.trim())
+            .filter((url) => url !== '');
+    }
+    if (typeof value === 'string' && value.trim() !== '') {
+        return [value.trim()];
+    }
+    return [];
+}
+export function toEditableChooseAnswerGroupImageUrls(value) {
+    if (Array.isArray(value)) {
+        return value.filter((url) => typeof url === 'string');
+    }
+    if (typeof value === 'string') {
+        return [value];
+    }
+    return [];
+}
+export function fromChooseAnswerGroupImageUrls(urls) {
+    const cleaned = urls
+        .filter((url) => typeof url === 'string')
+        .map((url) => url.trim())
+        .filter((url) => url !== '');
+    if (cleaned.length === 0) {
+        return undefined;
+    }
+    if (cleaned.length === 1) {
+        return cleaned[0];
+    }
+    return cleaned;
+}