@tinyweb_dev/oe-exam-sdk 0.2.3 → 0.2.5

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' | '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,21 @@ 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 WordOrderingQuestion {
     id: string;
     questionNumber: number;
@@ -321,6 +337,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;

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,45 @@ 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.',
+    };
+}
 export function transformWordOrdering(questions) {
     const transformed = questions.map((q) => {
         const content = q.content;
@@ -993,6 +1066,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;

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

@@ -172,6 +172,11 @@ 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,
+    },
     CROSS_OUT_WORD_GROUP: {
         label: 'Cross out word (group)',
         requiresContent: true,
@@ -227,6 +232,11 @@ export const QUESTION_TYPE_CONFIG = {
         requiresContent: true,
         hasDedicatedComponent: true,
     },
+    MATCH_WORD_TO_PICTURE: {
+        label: 'Nối từ với tranh',
+        requiresContent: true,
+        hasDedicatedComponent: true,
+    },
     WRITE_SENTENCES: {
         label: 'Viết câu',
         requiresContent: true,
@@ -343,6 +353,7 @@ export const QUESTION_TYPES_WITH_DEDICATED_COMPONENTS = [
     'CHOOSE_THE_CORRECT_ANSWER',
     'CHOOSE_THE_CORRECT_ANSWER_GROUP',
     'TRUE_FALSE_GROUP',
+    'TRUE_FALSE_CORRECT_GROUP',
     'CROSS_OUT_WORD_GROUP',
     'WRITE_A_SHORT_LETTER',
     'WRITE_CORRECT_VERB_FORM',
@@ -353,6 +364,7 @@ export const QUESTION_TYPES_WITH_DEDICATED_COMPONENTS = [
     'WORD_ORDERING',
     'WORD_FILL_PARAGRAPH',
     'MATCH_BY_WRITING_ANSWER',
+    'MATCH_WORD_TO_PICTURE',
     '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;
+}

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

@@ -11,4 +11,6 @@ export * from './read-and-color-objects.type';
 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 './match-word-to-picture.type';
 export * from './spontaneous-qa-group.type';

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

@@ -11,4 +11,6 @@ export * from './read-and-color-objects.type';
 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 './match-word-to-picture.type';
 export * from './spontaneous-qa-group.type';

package/dist/components/questions/_shared/types/match-word-to-picture.type.d.ts

@@ -0,0 +1,62 @@
+import React from 'react';
+import type { ValidationRef } from './look-and-choose-answer.type';
+export type { ValidationRef };
+export declare const MATCH_WORD_TO_PICTURE_DEFAULT_INSTRUCTION = "Look and complete.";
+export interface MatchWordToPictureGroup {
+    number: number;
+    questionCount: number;
+}
+export interface MatchWordToPictureData {
+    imageUrl: string;
+    correctAnswer: string;
+    points?: number;
+    groupNumber?: number;
+    isExample?: boolean;
+    wordBank: string[];
+    instruction?: string;
+    groups?: MatchWordToPictureGroup[];
+    explanation?: string;
+}
+export interface MatchWordToPictureCreatorProps {
+    initialData?: MatchWordToPictureData;
+    onSave?: (data: MatchWordToPictureData) => void;
+    onSaveToQuestionBank?: (data: MatchWordToPictureData) => void;
+    onCancel?: () => void;
+    onChange?: (data: MatchWordToPictureData) => void;
+    onUnsavedChangesChange?: (hasUnsavedChanges: boolean) => void;
+    externalErrors?: string[];
+    groups?: MatchWordToPictureGroup[];
+    groupConfig?: string[];
+    questionConfig?: string[];
+    questionIndexInPart?: number;
+    partId?: string;
+    validationRef?: React.MutableRefObject<ValidationRef | null>;
+}
+export interface MatchWordToPictureClientProps {
+    questionData: MatchWordToPictureData;
+    onSubmit?: (answer: string) => void;
+    isReviewMode?: boolean;
+    userAnswer?: string;
+    autoFillCorrectAnswers?: boolean;
+    explanation?: string;
+}
+export interface MatchWordToPictureGroupItemData {
+    imageUrl: string;
+    correctAnswer: string;
+    isExample?: boolean;
+    points: number;
+    questionNumber: number;
+}
+export interface MatchWordToPictureGroupData {
+    instruction: string;
+    wordBank: string[];
+    items: MatchWordToPictureGroupItemData[];
+    explanation?: string;
+    points?: number;
+}
+export interface MatchWordToPictureGroupClientProps {
+    questionData: MatchWordToPictureGroupData;
+    isReviewMode?: boolean;
+    userAnswers?: string[];
+    onAnswerChange?: (answers: string[]) => void;
+}

package/dist/components/questions/_shared/types/match-word-to-picture.type.js

@@ -0,0 +1 @@
+export const MATCH_WORD_TO_PICTURE_DEFAULT_INSTRUCTION = 'Look and complete.';

package/dist/components/questions/_shared/types/true-false-correct-group.type.d.ts

@@ -0,0 +1,42 @@
+import type { MutableRefObject } from 'react';
+export declare const TRUE_FALSE_CORRECT_ITEM_TYPE: "TRUE_FALSE_CORRECT";
+export declare const TRUE_FALSE_CORRECT_GROUP_DEFAULT_INSTRUCTION = "Tick (\u2713) the true and cross (\u2717) the false sentences. Correct the false sentences.";
+export interface TrueFalseCorrectItemAnswer {
+    isTrue: boolean;
+    correction: string;
+}
+export interface TrueFalseCorrectStudentItemAnswer {
+    isTrue: boolean | null;
+    correction: string;
+}
+export interface TrueFalseCorrectGroupItemData {
+    question: string;
+    isTrue: boolean;
+    correction: string;
+    isExample?: boolean;
+    points: number;
+    questionNumber: number;
+}
+export interface TrueFalseCorrectGroupData {
+    instruction: string;
+    items: TrueFalseCorrectGroupItemData[];
+    explanation?: string;
+    points?: number;
+}
+export interface TrueFalseCorrectGroupCreatorProps {
+    initialData?: TrueFalseCorrectGroupData;
+    onSave?: (data: TrueFalseCorrectGroupData) => void;
+    onCancel?: () => void;
+    onChange?: (data: TrueFalseCorrectGroupData) => void;
+    externalErrors?: string[];
+    onUnsavedChangesChange?: (hasUnsavedChanges: boolean) => void;
+    validationRef?: MutableRefObject<{
+        triggerValidation: () => Promise<boolean>;
+        getFormData?: () => TrueFalseCorrectGroupData;
+    } | null>;
+}
+export interface TrueFalseCorrectGroupClientProps {
+    questionData: TrueFalseCorrectGroupData;
+    isReviewMode?: boolean;
+    userAnswers?: TrueFalseCorrectStudentItemAnswer[];
+}

package/dist/components/questions/_shared/types/true-false-correct-group.type.js

@@ -0,0 +1,2 @@
+export const TRUE_FALSE_CORRECT_ITEM_TYPE = 'TRUE_FALSE_CORRECT';
+export const TRUE_FALSE_CORRECT_GROUP_DEFAULT_INSTRUCTION = 'Tick (✓) the true and cross (✗) the false sentences. Correct the false sentences.';

package/dist/components/questions/_shared/types/write-a-short-letter.type.d.ts

@@ -7,6 +7,8 @@ export interface WriteAShortLetterData {
     maxWords?: number;
     instructions?: WriteAShortLetterInstructions;
     guideImages?: string[];
+    /** Optional HTML/text article the student must read before writing. */
+    passage?: string;
     points?: number;
 }
 export interface WriteAShortLetterCreatorProps {
@@ -26,6 +28,8 @@ export interface WriteAShortLetterQuestionData {
     maxWords?: number;
     instructions?: WriteAShortLetterInstructions;
     guideImages?: string[];
+    /** Optional HTML/text article the student must read before writing. */
+    passage?: string;
 }
 export interface WriteAShortLetterClientProps {
     questionData: WriteAShortLetterQuestionData;

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

@@ -27,6 +27,7 @@ const IMAGE_BASED_TYPES = [
     'READ_AND_COLOR_OBJECTS',
     'IMAGE_OBJECT_MATCHING',
     'FILL_IN_BLANK',
+    'MATCH_WORD_TO_PICTURE',
 ];
 // Passage-based question types
 const PASSAGE_BASED_TYPES = [
@@ -62,6 +63,7 @@ const getQuestionTypeName = (type) => {
         'WRITE_CORRECT_VERB_FORM': 'Viết dạng động từ',
         'FILL_IN_BLANK': 'Điền vào chỗ trống',
         'READ_PASSAGE_AND_ANSWER_QUESTIONS': 'Đọc hiểu',
+        'MATCH_WORD_TO_PICTURE': 'Nối từ với tranh',
     };
     return type ? typeMap[type] || type.replace(/_/g, ' ').toLowerCase() : 'Chưa xác định';
 };

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

@@ -26,6 +26,7 @@ export function QuestionTypeSelector({ value, onValueChange, disabled, }) {
         'ANSWER_THE_QUESTION',
         'WORD_ORDERING',
         'MATCH_BY_WRITING_ANSWER',
+        'MATCH_WORD_TO_PICTURE',
         'WRITE_SENTENCES',
     ];
     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))) })] }));

package/dist/components/questions/creator/question-type-registry.js

@@ -13,6 +13,7 @@ import { readPassageAndAnswerQuestionsRegistration } from '../types/read-passage
 import { chooseTheCorrectAnswerRegistration } from '../types/choose-the-correct-answer/register';
 import { chooseTheCorrectAnswerGroupRegistration } from '../types/choose-the-correct-answer-group/register';
 import { trueFalseGroupRegistration } from '../types/true-false-group/register';
+import { trueFalseCorrectGroupRegistration } from '../types/true-false-correct-group/register';
 import { crossOutWordGroupRegistration } from '../types/cross-out-word-group/register';
 import { writeAShortLetterRegistration } from '../types/write-a-short-letter/register';
 import { writeCorrectVerbFormRegistration } from '../types/write-correct-verb-form/register';
@@ -23,6 +24,7 @@ import { trueFalseRegistration } from '../types/true-false/register';
 import { wordOrderingRegistration } from '../types/word-ordering/register';
 import { wordFillParagraphRegistration } from '../types/word-fill-paragraph/register';
 import { matchByWritingAnswerRegistration } from '../types/match-by-writing-answer/register';
+import { matchWordToPictureRegistration } from '../types/match-word-to-picture/register';
 import { writeSentencesRegistration } from '../types/write-sentences/register';
 import { listenAndChooseFromAnswerGroupRegistration } from '../types/listen-and-choose-from-answer-group/register';
 import { listenAndChooseObjectsInSceneRegistration } from '../types/listen-and-choose-objects-in-scene/register';
@@ -50,6 +52,7 @@ export const questionTypeRegistry = {
     CHOOSE_THE_CORRECT_ANSWER: chooseTheCorrectAnswerRegistration,
     CHOOSE_THE_CORRECT_ANSWER_GROUP: chooseTheCorrectAnswerGroupRegistration,
     TRUE_FALSE_GROUP: trueFalseGroupRegistration,
+    TRUE_FALSE_CORRECT_GROUP: trueFalseCorrectGroupRegistration,
     CROSS_OUT_WORD_GROUP: crossOutWordGroupRegistration,
     WORD_ORDER_AND_MATCH_GROUP: wordOrderAndMatchGroupRegistration,
     FILL_IN_BLANK: fillInBlankRegistration,
@@ -72,6 +75,7 @@ export const questionTypeRegistry = {
     WORD_ORDERING: wordOrderingRegistration,
     WORD_FILL_PARAGRAPH: wordFillParagraphRegistration, // Will need to handle viewMode mapping either here or in wrapper
     MATCH_BY_WRITING_ANSWER: matchByWritingAnswerRegistration,
+    MATCH_WORD_TO_PICTURE: matchWordToPictureRegistration,
     WRITE_SENTENCES: writeSentencesRegistration,
     LISTEN_AND_CHOOSE_FROM_ANSWER_GROUP: listenAndChooseFromAnswerGroupRegistration,
     LISTEN_AND_CHOOSE_OBJECTS_IN_SCENE: listenAndChooseObjectsInSceneRegistration,

package/dist/components/questions/types/choose-the-correct-answer-group/ChooseAnswerGroupImageUpload.d.ts

@@ -0,0 +1,13 @@
+export declare function ChooseAnswerGroupImageUploadItem({ index, itemIndex, imageUrl, onChange, onRemove, }: {
+    index: number;
+    itemIndex: number;
+    imageUrl: string;
+    onChange: (url: string) => void;
+    onRemove: () => void;
+}): import("react").JSX.Element;
+export declare function ChooseAnswerGroupOptionImageField({ itemIndex, optionIndex, imageUrl, onChange, }: {
+    itemIndex: number;
+    optionIndex: number;
+    imageUrl: string;
+    onChange: (url: string) => void;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,32 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from 'react';
+import { Button } from '../../../../components/ui/button';
+import { FileUpload } from '../../../../components/ui/file-upload';
+import { ImagePreview } from '../../../../components/ui/image-preview';
+import { usePresignedFileUrl } from '../../../../shared/lib/hooks';
+import { Trash2 } from 'lucide-react';
+function resolveDisplayUrl(imageUrl, previewOverride, fetchedPreviewUrl) {
+    if (previewOverride) {
+        return previewOverride;
+    }
+    if (fetchedPreviewUrl) {
+        return fetchedPreviewUrl;
+    }
+    if (imageUrl.startsWith('http') || imageUrl.startsWith('blob:')) {
+        return imageUrl;
+    }
+    return '';
+}
+export function ChooseAnswerGroupImageUploadItem({ index, itemIndex, imageUrl, onChange, onRemove, }) {
+    const [previewOverride, setPreviewOverride] = useState('');
+    const { previewUrl: fetchedPreviewUrl } = usePresignedFileUrl(imageUrl);
+    const displayUrl = resolveDisplayUrl(imageUrl, previewOverride, fetchedPreviewUrl);
+    return (_jsxs("div", { className: "space-y-2 rounded-lg border border-gray-200 bg-gray-50/40 p-3", children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx("span", { className: "flex h-6 w-6 shrink-0 items-center justify-center rounded-full bg-teal-100 text-xs font-semibold text-teal-700", children: index + 1 }), _jsx("div", { className: "flex-1", children: _jsx(FileUpload, { id: `choose-answer-group-image-${itemIndex}-${index}`, label: "", accept: "image/*", value: imageUrl, onChange: onChange, onPresignedUrlChange: setPreviewOverride, maxSize: 5, placeholder: "Upload \u1EA3nh ho\u1EB7c paste URL", autoUpload: true, prefix: "questions" }) }), _jsx(Button, { type: "button", variant: "ghost", size: "icon", onClick: onRemove, title: "Xo\u00E1 \u1EA3nh n\u00E0y", className: "h-8 w-8 text-gray-400 hover:bg-red-50 hover:text-red-600", children: _jsx(Trash2, { className: "h-4 w-4" }) })] }), displayUrl && (_jsx("div", { className: "pl-8", children: _jsx(ImagePreview, { src: displayUrl, alt: `Hình ảnh ${index + 1}`, className: "h-40 w-full max-w-sm rounded-lg border border-gray-200 bg-white object-contain" }) }))] }));
+}
+export function ChooseAnswerGroupOptionImageField({ itemIndex, optionIndex, imageUrl, onChange, }) {
+    const [previewOverride, setPreviewOverride] = useState('');
+    const { previewUrl: fetchedPreviewUrl } = usePresignedFileUrl(imageUrl);
+    const displayUrl = resolveDisplayUrl(imageUrl, previewOverride, fetchedPreviewUrl);
+    return (_jsxs("div", { className: "flex-1 space-y-2", children: [_jsx(FileUpload, { id: `choose-answer-group-option-${itemIndex}-${optionIndex}`, label: "", accept: "image/*", value: imageUrl, onChange: onChange, onPresignedUrlChange: setPreviewOverride, maxSize: 5, placeholder: `Upload ảnh đáp án ${optionIndex + 1}`, autoUpload: true, prefix: "questions/options" }), displayUrl && (_jsx(ImagePreview, { src: displayUrl, alt: `Đáp án ${optionIndex + 1}`, className: "h-28 w-28 rounded-lg border border-gray-200 bg-white object-contain" }))] }));
+}

package/dist/components/questions/types/choose-the-correct-answer-group/ChooseTheCorrectAnswerGroupClient.d.ts

@@ -1,2 +1,2 @@
 import type { ChooseTheCorrectAnswerGroupClientProps } from '../../_shared/types/choose-the-correct-answer-group.type';
-export declare function ChooseTheCorrectAnswerGroupClient({ questionData, isReviewMode, userAnswers, }: ChooseTheCorrectAnswerGroupClientProps): import("react").JSX.Element;
+export declare function ChooseTheCorrectAnswerGroupClient({ questionData, isReviewMode, userAnswers, onAnswerChange, }: ChooseTheCorrectAnswerGroupClientProps): import("react").JSX.Element;