@tinyweb_dev/oe-exam-sdk 0.2.5 → 0.2.6

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

@@ -0,0 +1,44 @@
+import { MATCHING_WITH_LINES_GROUP_DEFAULT_INSTRUCTION } from '../../_shared/types/matching-with-lines-group.type';
+function sumGradablePoints(items) {
+    return items.reduce((total, item) => {
+        if (item.isExample)
+            return total;
+        const points = typeof item.points === 'number' ? item.points : 1;
+        return total + points;
+    }, 0);
+}
+export const transformMatchingWithLinesGroup = (question) => {
+    const answerData = question.answer;
+    const items = Array.isArray(answerData?.items) ? answerData.items : [];
+    const rightItems = Array.isArray(answerData?.rightItems) ? answerData.rightItems : [];
+    if (items.length === 0) {
+        return { apiContent: { rightItems: [], items: [] }, apiCorrectAnswer: { answer: [] } };
+    }
+    const apiItems = items.map((item, index) => ({
+        ...(item.isExample ? { isExample: true } : {}),
+        content: {
+            imageUrl: item.imageUrl || '',
+        },
+        correctAnswer: { answer: item.correctAnswer || '' },
+        points: item.isExample ? 0 : (typeof item.points === 'number' ? item.points : 1),
+        questionNumber: item.questionNumber || index + 1,
+    }));
+    const title = typeof answerData?.title === 'string' ? answerData.title.trim() : '';
+    return {
+        apiContent: {
+            meta: {
+                instruction: answerData?.instruction || MATCHING_WITH_LINES_GROUP_DEFAULT_INSTRUCTION,
+                ...(title ? { title } : {}),
+            },
+            rightItems: rightItems.map((item) => ({
+                id: item.id || '',
+                text: item.text || '',
+            })),
+            items: apiItems,
+        },
+        apiCorrectAnswer: {
+            answer: apiItems.map((item) => item.correctAnswer.answer),
+        },
+        totalPoints: sumGradablePoints(items),
+    };
+};

package/dist/components/questions/viewer/FillInBlankGroupViewer.d.ts

@@ -0,0 +1,10 @@
+import type { Question } from '../../../shared/types/entities/question.types';
+import type { FillInBlankGroupStudentItemAnswer } from '../_shared/types/fill-in-blank-group.type';
+type FillInBlankGroupViewerProps = {
+    question: Question;
+    isReviewMode?: boolean;
+    userAnswer?: FillInBlankGroupStudentItemAnswer[];
+    onSubmitAnswer?: (answer: FillInBlankGroupStudentItemAnswer[]) => void;
+};
+export declare function FillInBlankGroupViewer({ question, isReviewMode, userAnswer, onSubmitAnswer, }: FillInBlankGroupViewerProps): import("react").JSX.Element;
+export {};

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

@@ -0,0 +1,14 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { FillInBlankGroupClient } from '../types/fill-in-blank-group/FillInBlankGroupClient';
+import { mapQuestionToFillInBlankGroupData } from '../types/fill-in-blank-group/map-fill-in-blank-group-data';
+export function FillInBlankGroupViewer({ question, isReviewMode = false, userAnswer, onSubmitAnswer, }) {
+    const questionData = mapQuestionToFillInBlankGroupData(question);
+    const studentAnswers = Array.isArray(userAnswer) ? userAnswer : undefined;
+    const reviewAnswers = isReviewMode && !studentAnswers
+        ? questionData.items.map((item) => ({
+            answers: item.answers.map((alts) => alts[0] || ''),
+        }))
+        : studentAnswers;
+    return (_jsx(FillInBlankGroupClient, { questionData: questionData, isReviewMode: isReviewMode, userAnswers: reviewAnswers, onAnswerChange: isReviewMode ? undefined : onSubmitAnswer }));
+}

package/dist/components/questions/viewer/MatchingWithLinesGroupViewer.d.ts

@@ -0,0 +1,7 @@
+import type { Question } from '../../../shared/types/entities/question.types';
+export declare function MatchingWithLinesGroupViewer({ question, isReviewMode, userAnswer, onSubmitAnswer, }: {
+    question: Question;
+    isReviewMode?: boolean;
+    userAnswer?: unknown;
+    onSubmitAnswer?: (answer: string[]) => void;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,48 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useState } from 'react';
+import { MatchingWithLinesGroupClient } from '../types/matching-with-lines-group/MatchingWithLinesGroupClient';
+import { mapQuestionToMatchingWithLinesGroupData } from '../types/matching-with-lines-group/map-matching-with-lines-group-data';
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function emptyAnswers(length) {
+    return Array.from({ length }, () => '');
+}
+function parseMatchingAnswers(value, length) {
+    const source = Array.isArray(value)
+        ? value
+        : isRecord(value) && Array.isArray(value.answer)
+            ? value.answer
+            : null;
+    if (!source)
+        return undefined;
+    return Array.from({ length }, (_, index) => typeof source[index] === 'string' ? source[index] : '');
+}
+export function MatchingWithLinesGroupViewer({ question, isReviewMode = false, userAnswer, onSubmitAnswer, }) {
+    const questionData = mapQuestionToMatchingWithLinesGroupData(question);
+    const itemCount = questionData.items.length;
+    const parsedUser = parseMatchingAnswers(userAnswer, itemCount);
+    const questionKey = `${question.id}:${question.type}:${itemCount}:${questionData.rightItems
+        .map((item) => `${item.id}:${item.text}`)
+        .join(',')}`;
+    const [cachedKey, setCachedKey] = useState(questionKey);
+    const [localAnswers, setLocalAnswers] = useState(() => parsedUser ?? emptyAnswers(itemCount));
+    if (cachedKey !== questionKey) {
+        setCachedKey(questionKey);
+        setLocalAnswers(parsedUser ?? emptyAnswers(itemCount));
+    }
+    const userAnswers = isReviewMode && !parsedUser
+        ? questionData.items.map((item) => item.correctAnswer)
+        : parsedUser ?? localAnswers;
+    const handleAnswersChange = (next) => {
+        const padded = questionData.items.map((item, index) => {
+            if (item.isExample)
+                return item.correctAnswer || '';
+            return typeof next[index] === 'string' ? next[index] : '';
+        });
+        setLocalAnswers(padded);
+        onSubmitAnswer?.(padded);
+    };
+    return (_jsx(MatchingWithLinesGroupClient, { questionData: questionData, isReviewMode: isReviewMode, userAnswers: userAnswers, onAnswersChange: isReviewMode ? undefined : handleAnswersChange }));
+}

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

@@ -26,6 +26,8 @@ import { WordFillStructuredFormViewer } from './WordFillStructuredFormViewer';
 import { ChooseTheCorrectAnswerGroupViewer } from './ChooseTheCorrectAnswerGroupViewer';
 import { TrueFalseGroupViewer } from './TrueFalseGroupViewer';
 import { TrueFalseCorrectGroupViewer } from './TrueFalseCorrectGroupViewer';
+import { FillInBlankGroupViewer } from './FillInBlankGroupViewer';
+import { MatchingWithLinesGroupViewer } from './MatchingWithLinesGroupViewer';
 import { CrossOutWordGroupViewer } from './CrossOutWordGroupViewer';
 import { SpontaneousQaGroupViewer } from './SpontaneousQaGroupViewer';
 import { WordOrderAndMatchGroupViewer } from './WordOrderAndMatchGroupViewer';
@@ -635,6 +637,10 @@ export function QuestionViewer({ question, onSubmitAnswer, isReviewMode = false,
                 return (_jsx(TrueFalseGroupViewer, { question: question, isReviewMode: isReviewMode, userAnswer: userAnswer }));
             case 'TRUE_FALSE_CORRECT_GROUP':
                 return (_jsx(TrueFalseCorrectGroupViewer, { question: question, isReviewMode: isReviewMode, userAnswer: userAnswer }));
+            case 'FILL_IN_BLANK_GROUP':
+                return (_jsx(FillInBlankGroupViewer, { question: question, isReviewMode: isReviewMode, userAnswer: userAnswer, onSubmitAnswer: onSubmitAnswer }));
+            case 'MATCHING_WITH_LINES_GROUP':
+                return (_jsx(MatchingWithLinesGroupViewer, { question: question, isReviewMode: isReviewMode, userAnswer: userAnswer, onSubmitAnswer: onSubmitAnswer }));
             case 'CROSS_OUT_WORD_GROUP':
                 return (_jsx(CrossOutWordGroupViewer, { question: question, isReviewMode: isReviewMode }));
             case 'ANSWER_THE_QUESTION_GROUP':

package/dist/components/questions/viewer/index.d.ts

@@ -4,6 +4,8 @@ export { WordFillStructuredFormViewer } from './WordFillStructuredFormViewer';
 export { ChooseTheCorrectAnswerGroupViewer } from './ChooseTheCorrectAnswerGroupViewer';
 export { TrueFalseGroupViewer } from './TrueFalseGroupViewer';
 export { TrueFalseCorrectGroupViewer } from './TrueFalseCorrectGroupViewer';
+export { FillInBlankGroupViewer } from './FillInBlankGroupViewer';
+export { MatchingWithLinesGroupViewer } from './MatchingWithLinesGroupViewer';
 export { CrossOutWordGroupViewer } from './CrossOutWordGroupViewer';
 export { SpontaneousQaGroupViewer } from './SpontaneousQaGroupViewer';
 export { WordOrderAndMatchGroupViewer } from './WordOrderAndMatchGroupViewer';

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

@@ -4,6 +4,8 @@ export { WordFillStructuredFormViewer } from './WordFillStructuredFormViewer';
 export { ChooseTheCorrectAnswerGroupViewer } from './ChooseTheCorrectAnswerGroupViewer';
 export { TrueFalseGroupViewer } from './TrueFalseGroupViewer';
 export { TrueFalseCorrectGroupViewer } from './TrueFalseCorrectGroupViewer';
+export { FillInBlankGroupViewer } from './FillInBlankGroupViewer';
+export { MatchingWithLinesGroupViewer } from './MatchingWithLinesGroupViewer';
 export { CrossOutWordGroupViewer } from './CrossOutWordGroupViewer';
 export { SpontaneousQaGroupViewer } from './SpontaneousQaGroupViewer';
 export { WordOrderAndMatchGroupViewer } from './WordOrderAndMatchGroupViewer';

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

@@ -4,8 +4,8 @@ import { jsx as _jsx } from "react/jsx-runtime";
  * Movers fallback review cases (isReviewMode=true).
  * Source: oe-exam-fe ReviewQuestionRenderer.tsx
  */
-import { MoversAnswerTheQuestionRenderer, MoversFillWordHintRenderer, MoversGridFillRenderer, MoversLabelThePictureRenderer, MoversMatchByWritingAnswerRenderer, MoversMatchWordToPictureRenderer, MoversPictureChooseRenderer, MoversPictureFillBlankChooseRenderer, MoversReadingPassageRenderer, MoversTrueFalseRenderer, MoversTrueFalseCorrectGroupRenderer, MoversCrossOutWordGroupRenderer, MoversWordFillParagraphRenderer, MoversWordFillStructuredFormRenderer, MoversWordOrderingRenderer, MoversWriteSentencesRenderer, MoversWritingRenderer, MoversCrosswordPuzzleRenderer, } from '../../../components/exams/take/components/question-renderers';
-import { transformAnswerTheQuestion, transformFillWordHint, transformGridFill, transformLabelPicture, transformMatchByWritingAnswer, transformMatchWordToPicture, transformPictureChoose, transformPictureFillBlankChoose, transformReadingPassage, transformTrueFalse, transformTrueFalseCorrectGroup, transformWordFillParagraph, transformWordFillStructuredForm, transformWordOrdering, transformWriteSentences, transformWriteShortLetter, transformCrosswordPuzzle, } from '../../../components/exams/take/utils/question-transformers';
+import { MoversAnswerTheQuestionRenderer, MoversFillWordHintRenderer, MoversGridFillRenderer, MoversLabelThePictureRenderer, MoversMatchByWritingAnswerRenderer, MoversMatchWordToPictureRenderer, MoversPictureChooseRenderer, MoversPictureFillBlankChooseRenderer, MoversReadingPassageRenderer, MoversTrueFalseRenderer, MoversTrueFalseCorrectGroupRenderer, MoversFillInBlankGroupRenderer, MoversMatchingWithLinesGroupRenderer, MoversCrossOutWordGroupRenderer, MoversWordFillParagraphRenderer, MoversWordFillStructuredFormRenderer, MoversWordOrderingRenderer, MoversWriteSentencesRenderer, MoversWritingRenderer, MoversCrosswordPuzzleRenderer, } from '../../../components/exams/take/components/question-renderers';
+import { transformAnswerTheQuestion, transformFillWordHint, transformGridFill, transformLabelPicture, transformMatchByWritingAnswer, transformMatchWordToPicture, transformPictureChoose, transformPictureFillBlankChoose, transformReadingPassage, transformTrueFalse, transformTrueFalseCorrectGroup, transformFillInBlankGroup, transformMatchingWithLinesGroup, transformWordFillParagraph, transformWordFillStructuredForm, transformWordOrdering, transformWriteSentences, transformWriteShortLetter, transformCrosswordPuzzle, } from '../../../components/exams/take/utils/question-transformers';
 import { normalizeCrossOutWordGroupAnswer, transformCrossOutWordGroup, } from '../../../components/exams/take/utils/cross-out-word-group.transformer';
 function asApiQuestions(questions) {
     return questions;
@@ -142,6 +142,41 @@ export function renderMoversReviewBody(ctx) {
             });
             return (_jsx(MoversTrueFalseCorrectGroupRenderer, { partNumber: partNo, partName: part.name, instruction: part.instructions || data.instruction, questionCount: questionCount, questions: data.questions, answers: answers, onAnswerChange: handleAnswerChange, isReviewMode: true, correctAnswerMap: correctAnswerMap }));
         }
+        case 'FILL_IN_BLANK_GROUP': {
+            const data = transformFillInBlankGroup(apiQuestions);
+            const correctAnswerMap = {};
+            const parent = apiQuestions[0];
+            const rawCorrect = parent?.id ? rawCorrectAnswerMap[parent.id] : undefined;
+            const rawCorrectRecord = rawCorrect && typeof rawCorrect === 'object' && !Array.isArray(rawCorrect)
+                ? rawCorrect
+                : undefined;
+            const correctArr = Array.isArray(rawCorrectRecord?.answer)
+                ? rawCorrectRecord.answer
+                : Array.isArray(parent?.correct_answer?.answer)
+                    ? parent.correct_answer.answer
+                    : [];
+            data.questions.forEach((question, index) => {
+                const rawItem = correctArr[index];
+                if (!rawItem || typeof rawItem !== 'object' || Array.isArray(rawItem)) {
+                    return;
+                }
+                const obj = rawItem;
+                if (!Array.isArray(obj.answers)) {
+                    return;
+                }
+                correctAnswerMap[question.id] = {
+                    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,
+                };
+            });
+            return (_jsx(MoversFillInBlankGroupRenderer, { partNumber: partNo, partName: part.name, instruction: part.instructions || data.instruction, questionCount: data.questions.filter((question) => !question.isExample).length, audioUrl: data.audioUrl, imageUrl: data.imageUrl, showHints: data.showHints, hints: data.hints, questions: data.questions, answers: answers, onAnswerChange: handleAnswerChange, isReviewMode: true, correctAnswerMap: correctAnswerMap }));
+        }
+        case 'MATCHING_WITH_LINES_GROUP': {
+            const data = transformMatchingWithLinesGroup(apiQuestions);
+            return (_jsx(MoversMatchingWithLinesGroupRenderer, { partNumber: partNo, partName: part.name, instruction: part.instructions || data.instruction, questionCount: questionCount, data: data, answers: answers, onAnswerChange: handleAnswerChange, isReviewMode: true }));
+        }
         case 'TRUE_FALSE': {
             const data = transformTrueFalse(apiQuestions);
             return (_jsx(MoversTrueFalseRenderer, { partNumber: partNo, partName: part.name, instruction: part.instructions || data.instruction, questionCount: questionCount, imageUrl: data.imageUrl, questions: data.questions, answers: answers, onAnswerChange: handleAnswerChange, isReviewMode: true, correctAnswerTextMap: correctAnswerTextMap }));

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

@@ -9,6 +9,8 @@ const FLATTENED_ANSWER_TYPES = new Set([
     'ANSWER_THE_QUESTION_GROUP',
     'CROSS_OUT_WORD_GROUP',
     'TRUE_FALSE_CORRECT_GROUP',
+    'FILL_IN_BLANK_GROUP',
+    'MATCHING_WITH_LINES_GROUP',
 ]);
 export function transformResultAnswersForReview(answers, templateParts = []) {
     const groups = groupAnswers(answers);
@@ -205,6 +207,41 @@ function transformStudentAnswer(questionId, questionType, value) {
             return [`${questionId}-item-${index}`, { isTrue: null, correction: '' }];
         }));
     }
+    if (questionType === 'FILL_IN_BLANK_GROUP') {
+        const answer = Array.isArray(record.answer)
+            ? record.answer
+            : Array.isArray(value)
+                ? value
+                : [];
+        return Object.fromEntries(answer.map((item, index) => {
+            if (item && typeof item === 'object' && !Array.isArray(item) && Array.isArray(item.answers)) {
+                return [
+                    `${questionId}-item-${index}`,
+                    {
+                        answers: item.answers.map((value) => String(value ?? '')),
+                    },
+                ];
+            }
+            if (Array.isArray(item)) {
+                return [`${questionId}-item-${index}`, { answers: item.map((value) => String(value ?? '')) }];
+            }
+            if (typeof item === 'string') {
+                return [`${questionId}-item-${index}`, { answers: [item] }];
+            }
+            return [`${questionId}-item-${index}`, { answers: [] }];
+        }));
+    }
+    if (questionType === 'MATCHING_WITH_LINES_GROUP') {
+        const answer = Array.isArray(record.answer)
+            ? record.answer
+            : Array.isArray(value)
+                ? value
+                : [];
+        return Object.fromEntries(answer.map((item, index) => [
+            `${questionId}-item-${index}`,
+            typeof item === 'string' ? item : '',
+        ]));
+    }
     if (questionType === 'CHOOSE_THE_CORRECT_ANSWER' || questionType === 'CHOOSE_CORRECT_ADJECTIVE') {
         const rawAns = record.answer ?? record.optionId ?? record.optionIds;
         const ids = getOptionIds(questionId, rawAns);

package/dist/index.d.ts

@@ -26,4 +26,4 @@ export { validateQuestion } from './components/questions/_shared/utils/question-
 export { buildAnswerPayload } from './components/questions/_shared/utils/answer-builder';
 export type { QuestionFormState } from './components/questions/_shared/hooks/useQuestionFormState';
 export * from './components/questions/_shared/types';
-export { QuestionViewer, QuestionGroupViewer, WordFillStructuredFormViewer, ChooseTheCorrectAnswerGroupViewer, TrueFalseGroupViewer, TrueFalseCorrectGroupViewer, CrossOutWordGroupViewer, SpontaneousQaGroupViewer, WordOrderAndMatchGroupViewer, AnswerTheQuestionGroupViewer, MatchWordToPictureViewer, MatchWordToPictureGroupViewer, } from './components/questions/viewer';
+export { QuestionViewer, QuestionGroupViewer, WordFillStructuredFormViewer, ChooseTheCorrectAnswerGroupViewer, TrueFalseGroupViewer, TrueFalseCorrectGroupViewer, FillInBlankGroupViewer, MatchingWithLinesGroupViewer, CrossOutWordGroupViewer, SpontaneousQaGroupViewer, WordOrderAndMatchGroupViewer, AnswerTheQuestionGroupViewer, MatchWordToPictureViewer, MatchWordToPictureGroupViewer, } from './components/questions/viewer';

package/dist/index.js

@@ -21,4 +21,4 @@ export { QUESTION_TYPE_CONFIG, QUESTION_TYPES_WITH_DEDICATED_COMPONENTS } from '
 export { validateQuestion } from './components/questions/_shared/utils/question-validation';
 export { buildAnswerPayload } from './components/questions/_shared/utils/answer-builder';
 export * from './components/questions/_shared/types';
-export { QuestionViewer, QuestionGroupViewer, WordFillStructuredFormViewer, ChooseTheCorrectAnswerGroupViewer, TrueFalseGroupViewer, TrueFalseCorrectGroupViewer, CrossOutWordGroupViewer, SpontaneousQaGroupViewer, WordOrderAndMatchGroupViewer, AnswerTheQuestionGroupViewer, MatchWordToPictureViewer, MatchWordToPictureGroupViewer, } from './components/questions/viewer';
+export { QuestionViewer, QuestionGroupViewer, WordFillStructuredFormViewer, ChooseTheCorrectAnswerGroupViewer, TrueFalseGroupViewer, TrueFalseCorrectGroupViewer, FillInBlankGroupViewer, MatchingWithLinesGroupViewer, CrossOutWordGroupViewer, SpontaneousQaGroupViewer, WordOrderAndMatchGroupViewer, AnswerTheQuestionGroupViewer, MatchWordToPictureViewer, MatchWordToPictureGroupViewer, } from './components/questions/viewer';

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

@@ -45,6 +45,7 @@ export const QUESTION_TYPE_SKILLS = {
     'CHOOSE_THE_CORRECT_ANSWER_GROUP': SkillEnum.READING,
     'CHOOSE_CORRECT_ADJECTIVE': SkillEnum.READING,
     'FILL_IN_BLANK': SkillEnum.READING,
+    'FILL_IN_BLANK_GROUP': SkillEnum.READING,
     'FILL_MISSING_WORDS_IN_GRID': SkillEnum.READING,
     'READ_PASSAGE_AND_ANSWER_QUESTIONS': SkillEnum.READING,
     'ANSWER_THE_QUESTION': SkillEnum.READING,
@@ -53,6 +54,7 @@ export const QUESTION_TYPE_SKILLS = {
     'WORD_FILL_PARAGRAPH': SkillEnum.READING,
     'MATCH_BY_WRITING_ANSWER': SkillEnum.READING,
     'MATCH_WORD_TO_PICTURE': SkillEnum.READING,
+    'MATCHING_WITH_LINES_GROUP': SkillEnum.READING,
     // Visual-based reading questions
     'LABEL_THE_PICTURE': SkillEnum.READING,
     'LOOK_PICTURE_CHOOSE_CORRECT_ANSWER': SkillEnum.READING,
@@ -177,6 +179,7 @@ export const QUESTION_TYPE_LABELS = {
     'CHOOSE_THE_CORRECT_ANSWER_GROUP': 'Chọn đáp án đúng (nhóm)',
     'CHOOSE_CORRECT_ADJECTIVE': 'Chọn tính từ',
     'FILL_IN_BLANK': 'Điền vào chỗ trống',
+    'FILL_IN_BLANK_GROUP': 'Điền chỗ trống (nhóm)',
     'FILL_MISSING_WORDS_IN_GRID': 'Điền từ vào lưới',
     'READ_PASSAGE_AND_ANSWER_QUESTIONS': 'Đọc hiểu - Trả lời',
     'LABEL_THE_PICTURE': 'Gắn nhãn hình ảnh',
@@ -209,6 +212,7 @@ export const QUESTION_TYPE_LABELS = {
     'WORD_FILL_PARAGRAPH': 'Điền từ vào đoạn văn',
     'MATCH_BY_WRITING_ANSWER': 'Ghép đáp án bằng cách viết',
     'MATCH_WORD_TO_PICTURE': 'Nối từ với tranh',
+    'MATCHING_WITH_LINES_GROUP': 'Nối bằng đường kẻ (nhóm)',
     'WORD_FILL_STRUCTURED_FORM': 'Điền từ vào biểu mẫu có cấu trúc',
     'CROSSWORD_PUZZLE': 'Giải ô chữ (Crossword)',
     'FIND_WORDS_IN_MATRIX': 'Tìm từ trong ma trận (Word Search)',

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

@@ -308,6 +308,90 @@ const reverseTrueFalseCorrectGroup = (apiQuestion) => {
         },
     };
 };
+const reverseFillInBlankGroup = (apiQuestion) => {
+    const content = asRecord(apiQuestion.content);
+    const answer = readAnswer(apiQuestion);
+    const fallbackAnswers = asArray(answer.answer);
+    const meta = asRecord(content.meta);
+    const items = asArray(content.items).map((rawItem, index) => {
+        const item = asRecord(rawItem);
+        const itemContent = asRecord(item.content);
+        const itemAnswer = asRecord(item.correctAnswer);
+        const fallback = asRecord(fallbackAnswers[index]);
+        const isExample = item.isExample === true;
+        const question = asString(itemContent.question, '{0}');
+        const rawAnswers = itemAnswer.answers ?? fallback.answers;
+        const answers = asArray(rawAnswers).map((blank) => {
+            const alts = Array.isArray(blank)
+                ? blank.map((alt) => String(alt ?? '').trim()).filter(Boolean)
+                : [String(blank ?? '').trim()].filter(Boolean);
+            return alts.length > 0 ? alts : [''];
+        });
+        return {
+            question,
+            answers: answers.length > 0 ? answers : [['']],
+            caseSensitive: itemAnswer.caseSensitive === true || fallback.caseSensitive === true,
+            imageUrl: asString(itemContent.imageUrl),
+            audioUrl: asString(itemContent.audioUrl),
+            showHints: itemContent.showHints === true,
+            hints: asArray(itemContent.hints).map((hint) => String(hint ?? '').trim()).filter(Boolean),
+            isExample,
+            points: isExample ? 0 : asNumber(item.points, 1),
+            questionNumber: asNumber(item.questionNumber, index + 1),
+        };
+    });
+    return {
+        content: '',
+        answer: {
+            instruction: asString(meta.instruction, 'Complete the sentences.'),
+            audioUrl: asString(meta.audioUrl),
+            imageUrl: asString(meta.imageUrl),
+            showHints: meta.showHints === true,
+            hints: asArray(meta.hints).map((hint) => String(hint ?? '').trim()).filter(Boolean),
+            items,
+            explanation: asString(apiQuestion.explanation),
+            points: items.reduce((total, item) => (item.isExample ? total : total + item.points), 0),
+        },
+    };
+};
+const reverseMatchingWithLinesGroup = (apiQuestion) => {
+    const content = asRecord(apiQuestion.content);
+    const answer = readAnswer(apiQuestion);
+    const fallbackAnswers = asArray(answer.answer);
+    const meta = asRecord(content.meta);
+    const rightItems = asArray(content.rightItems).map((raw, index) => {
+        const item = asRecord(raw);
+        return {
+            id: asString(item.id, `r${index + 1}`),
+            text: asString(item.text),
+        };
+    });
+    const items = asArray(content.items).map((rawItem, index) => {
+        const item = asRecord(rawItem);
+        const itemContent = asRecord(item.content);
+        const itemAnswer = asRecord(item.correctAnswer);
+        const fallback = fallbackAnswers[index];
+        const isExample = item.isExample === true;
+        return {
+            imageUrl: asString(itemContent.imageUrl),
+            correctAnswer: asString(itemAnswer.answer, typeof fallback === 'string' ? fallback : ''),
+            isExample,
+            points: isExample ? 0 : asNumber(item.points, 1),
+            questionNumber: asNumber(item.questionNumber, index + 1),
+        };
+    });
+    return {
+        content: '',
+        answer: {
+            title: asString(meta.title),
+            instruction: asString(meta.instruction, 'Look and match.'),
+            rightItems,
+            items,
+            explanation: asString(apiQuestion.explanation),
+            points: items.reduce((total, item) => (item.isExample ? total : total + item.points), 0),
+        },
+    };
+};
 const reverseCrossOutWordGroup = (apiQuestion) => {
     const content = asRecord(apiQuestion.content);
     const answer = readAnswer(apiQuestion);
@@ -460,6 +544,8 @@ const handlers = {
     ANSWER_THE_QUESTION_GROUP: reverseAnswerTheQuestionGroup,
     TRUE_FALSE_GROUP: reverseTrueFalseGroup,
     TRUE_FALSE_CORRECT_GROUP: reverseTrueFalseCorrectGroup,
+    FILL_IN_BLANK_GROUP: reverseFillInBlankGroup,
+    MATCHING_WITH_LINES_GROUP: reverseMatchingWithLinesGroup,
     CROSS_OUT_WORD_GROUP: reverseCrossOutWordGroup,
     WORD_ORDER_AND_MATCH_GROUP: reverseWordOrderAndMatchGroup,
     WORD_ORDER_AND_MATCH: reverseWordOrderAndMatchGroup,

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

@@ -14,6 +14,7 @@ import { transformChooseTheCorrectAnswer } from '../../../components/questions/t
 import { transformChooseTheCorrectAnswerGroup } from '../../../components/questions/types/choose-the-correct-answer-group/transform';
 import { transformCrossOutWordGroup } from '../../../components/questions/types/cross-out-word-group/transform';
 import { transformTrueFalseCorrectGroup } from '../../../components/questions/types/true-false-correct-group/transform';
+import { transformFillInBlankGroup } from '../../../components/questions/types/fill-in-blank-group/transform';
 import { transformFillInBlank } from '../../../components/questions/types/fill-in-blank/transform';
 import { transformWriteCorrectVerbForm } from '../../../components/questions/types/write-correct-verb-form/transform';
 import { transformChooseCorrectAdjective } from '../../../components/questions/types/choose-correct-adjective/transform';
@@ -24,6 +25,7 @@ import { transformWordOrdering } from '../../../components/questions/types/word-
 import { transformWordFillParagraph } from '../../../components/questions/types/word-fill-paragraph/transform';
 import { transformMatchByWritingAnswer } from '../../../components/questions/types/match-by-writing-answer/transform';
 import { transformMatchWordToPicture } from '../../../components/questions/types/match-word-to-picture/transform';
+import { transformMatchingWithLinesGroup } from '../../../components/questions/types/matching-with-lines-group/transform';
 import { transformWriteSentences } from '../../../components/questions/types/write-sentences/transform';
 import { transformListenAndChooseFromAnswerGroup } from '../../../components/questions/types/listen-and-choose-from-answer-group/transform';
 import { transformListenAndChooseObjectsInScene } from '../../../components/questions/types/listen-and-choose-objects-in-scene/transform';
@@ -65,6 +67,7 @@ const questionTransformHandlers = {
     CHOOSE_THE_CORRECT_ANSWER_GROUP: transformChooseTheCorrectAnswerGroup,
     CROSS_OUT_WORD_GROUP: transformCrossOutWordGroup,
     TRUE_FALSE_CORRECT_GROUP: transformTrueFalseCorrectGroup,
+    FILL_IN_BLANK_GROUP: transformFillInBlankGroup,
     FILL_IN_BLANK: transformFillInBlank,
     WRITE_CORRECT_VERB_FORM: transformWriteCorrectVerbForm,
     CHOOSE_CORRECT_ADJECTIVE: transformChooseCorrectAdjective,
@@ -75,6 +78,7 @@ const questionTransformHandlers = {
     WORD_FILL_PARAGRAPH: transformWordFillParagraph,
     MATCH_BY_WRITING_ANSWER: transformMatchByWritingAnswer,
     MATCH_WORD_TO_PICTURE: transformMatchWordToPicture,
+    MATCHING_WITH_LINES_GROUP: transformMatchingWithLinesGroup,
     WRITE_SENTENCES: transformWriteSentences,
     LISTEN_AND_CHOOSE_FROM_ANSWER_GROUP: transformListenAndChooseFromAnswerGroup,
     LISTEN_AND_CHOOSE_OBJECTS_IN_SCENE: transformListenAndChooseObjectsInScene,

package/dist/shared/types/common.types.d.ts

@@ -29,7 +29,7 @@ export declare enum StudentSelectionType {
 }
 export type ResultStatus = 'PENDING' | 'PARTIAL_GRADED' | 'GRADED';
 export type StudentStatus = 'NOT_STARTED' | 'IN_PROGRESS' | 'SUBMITTED';
-export type QuestionType = 'FILL_IN_BLANK' | 'TRUE_FALSE' | 'MATCHING' | 'ORDERING' | 'LISTENING' | 'COLORING' | 'ESSAY' | 'LISTEN_AND_FILL_IN_THE_BLANK_WITH_IMAGE' | 'LISTEN_AND_TICK_ANSWER' | 'LISTEN_AND_FILL_NAME_NUMBER' | 'LISTENING_FILL_BLANK' | 'LISTENING_COLOR' | 'TICK_TRUE_OR_FALSE' | 'TICK_YES_OR_NO' | 'READING_TICK_CROSS' | 'ARRANGE_LETTERS_INTO_WORDS' | 'READ_PASSAGE_AND_COMPLETE_STORY' | 'CLOZE_TEST_WITH_TICK_BOX' | 'READ_AND_CHOOSE_APPROPRIATE_WORD' | 'WRITE_SHORT_PARAGRAPH' | 'LABEL_THE_PICTURE' | 'READING_LETTER_ARRANGE' | 'READING_PASSAGE_FILL' | 'FILL_BLANK' | 'FILL_MISSING_WORDS_IN_GRID' | 'LOOK_PICTURE_CHOOSE_CORRECT_ANSWER' | 'LOOK_PICTURE_FILL_BLANK_CHOOSE_ANSWER' | 'LOOK_PICTURE_FILL_WORD_HINT' | 'LABEL_THE_PICTURE' | 'READ_AND_COLOR_OBJECTS' | 'IMAGE_OBJECT_MATCHING' | 'READ_PASSAGE_AND_ANSWER_QUESTIONS' | 'CHOOSE_THE_CORRECT_ANSWER' | 'CHOOSE_THE_CORRECT_ANSWER_GROUP' | 'TRUE_FALSE_GROUP' | 'TRUE_FALSE_CORRECT_GROUP' | 'CROSS_OUT_WORD_GROUP' | 'SPONTANEOUS_QA_GROUP' | 'WORD_ORDER_AND_MATCH_GROUP' | 'WRITE_A_SHORT_LETTER' | 'WRITE_CORRECT_VERB_FORM' | 'CHOOSE_CORRECT_ADJECTIVE' | 'ANSWER_THE_QUESTION' | 'ANSWER_THE_QUESTION_GROUP' | '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' | 'LISTEN_AND_DRAG_OBJECTS_INTO_SCENE' | 'LISTEN_AND_SPEAK_ANSWER' | 'LISTEN_AND_SPEAK_IMAGE_GROUP' | 'LISTEN_AND_SPEAK_QUESTION_LIST' | 'LISTEN_AND_SPEAK_COMPARE_IMAGES' | 'LISTEN_AND_SPEAK_WITH_STORY_IMAGES' | 'LISTEN_AND_SPEAK_ODD_ONE_OUT' | 'LISTEN_AND_SPEAK_INFO_EXCHANGE' | 'READ_DISPLAYED_CONTENT' | 'SPEAKING_DESCRIBE_IMAGE' | 'SPONTANEOUS_QA' | 'SPEAKING_CONVERSATION' | 'GN_SPEAKING_INTERVIEW' | 'SPEAKING_CUE_CARD' | 'WORD_FILL_STRUCTURED_FORM' | 'CROSSWORD_PUZZLE' | 'FIND_WORDS_IN_MATRIX';
+export type QuestionType = 'FILL_IN_BLANK' | 'TRUE_FALSE' | 'MATCHING' | 'ORDERING' | 'LISTENING' | 'COLORING' | 'ESSAY' | 'LISTEN_AND_FILL_IN_THE_BLANK_WITH_IMAGE' | 'LISTEN_AND_TICK_ANSWER' | 'LISTEN_AND_FILL_NAME_NUMBER' | 'LISTENING_FILL_BLANK' | 'LISTENING_COLOR' | 'TICK_TRUE_OR_FALSE' | 'TICK_YES_OR_NO' | 'READING_TICK_CROSS' | 'ARRANGE_LETTERS_INTO_WORDS' | 'READ_PASSAGE_AND_COMPLETE_STORY' | 'CLOZE_TEST_WITH_TICK_BOX' | 'READ_AND_CHOOSE_APPROPRIATE_WORD' | 'WRITE_SHORT_PARAGRAPH' | 'LABEL_THE_PICTURE' | 'READING_LETTER_ARRANGE' | 'READING_PASSAGE_FILL' | 'FILL_BLANK' | 'FILL_MISSING_WORDS_IN_GRID' | 'LOOK_PICTURE_CHOOSE_CORRECT_ANSWER' | 'LOOK_PICTURE_FILL_BLANK_CHOOSE_ANSWER' | 'LOOK_PICTURE_FILL_WORD_HINT' | 'LABEL_THE_PICTURE' | 'READ_AND_COLOR_OBJECTS' | 'IMAGE_OBJECT_MATCHING' | 'READ_PASSAGE_AND_ANSWER_QUESTIONS' | 'CHOOSE_THE_CORRECT_ANSWER' | 'CHOOSE_THE_CORRECT_ANSWER_GROUP' | 'TRUE_FALSE_GROUP' | 'TRUE_FALSE_CORRECT_GROUP' | 'FILL_IN_BLANK_GROUP' | 'MATCHING_WITH_LINES_GROUP' | 'CROSS_OUT_WORD_GROUP' | 'SPONTANEOUS_QA_GROUP' | 'WORD_ORDER_AND_MATCH_GROUP' | 'WRITE_A_SHORT_LETTER' | 'WRITE_CORRECT_VERB_FORM' | 'CHOOSE_CORRECT_ADJECTIVE' | 'ANSWER_THE_QUESTION' | 'ANSWER_THE_QUESTION_GROUP' | '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' | 'LISTEN_AND_DRAG_OBJECTS_INTO_SCENE' | 'LISTEN_AND_SPEAK_ANSWER' | 'LISTEN_AND_SPEAK_IMAGE_GROUP' | 'LISTEN_AND_SPEAK_QUESTION_LIST' | 'LISTEN_AND_SPEAK_COMPARE_IMAGES' | 'LISTEN_AND_SPEAK_WITH_STORY_IMAGES' | 'LISTEN_AND_SPEAK_ODD_ONE_OUT' | 'LISTEN_AND_SPEAK_INFO_EXCHANGE' | 'READ_DISPLAYED_CONTENT' | 'SPEAKING_DESCRIBE_IMAGE' | 'SPONTANEOUS_QA' | 'SPEAKING_CONVERSATION' | 'GN_SPEAKING_INTERVIEW' | 'SPEAKING_CUE_CARD' | 'WORD_FILL_STRUCTURED_FORM' | 'CROSSWORD_PUZZLE' | 'FIND_WORDS_IN_MATRIX';
 export type Level = 'Pre-A1' | 'A1' | 'A2' | 'B1' | 'B2' | 'C1' | 'C2';
 export type Difficulty = 'EASY' | 'MEDIUM' | 'HARD';
 export type Skill = 'LISTENING' | 'READING' | 'WRITING' | 'SPEAKING';

package/dist/shared/types/questions/fill-in-blank-group.d.ts

@@ -0,0 +1,45 @@
+export declare const FILL_IN_BLANK_ITEM_TYPE: "FILL_IN_BLANK";
+export interface FillInBlankGroupItemAnswer {
+    answers: string[][];
+    caseSensitive?: boolean;
+}
+export interface FillInBlankGroupItemContent {
+    question: string;
+    imageUrl?: string;
+    audioUrl?: string;
+    showHints?: boolean;
+    hints?: string[];
+}
+export interface FillInBlankGroupItem {
+    questionType?: typeof FILL_IN_BLANK_ITEM_TYPE;
+    isExample?: boolean;
+    content: FillInBlankGroupItemContent;
+    correctAnswer?: FillInBlankGroupItemAnswer;
+    points?: number;
+    questionNumber?: number;
+}
+export interface FillInBlankGroupContent {
+    meta?: {
+        instruction?: string;
+        audioUrl?: string;
+        imageUrl?: string;
+        showHints?: boolean;
+        hints?: string[];
+    };
+    items: FillInBlankGroupItem[];
+}
+export interface FillInBlankGroupCorrectAnswer {
+    answer: FillInBlankGroupItemAnswer[];
+}
+export interface FillInBlankGroupAPIPayload {
+    id?: string;
+    questionType: 'FILL_IN_BLANK_GROUP';
+    content: FillInBlankGroupContent;
+    correctAnswer: FillInBlankGroupCorrectAnswer;
+    points: number;
+    explanation?: string;
+    questionNumber: number;
+    partId?: string;
+    partNo?: number;
+}
+export type FillInBlankGroupLocalStorage = FillInBlankGroupAPIPayload;

package/dist/shared/types/questions/fill-in-blank-group.js

@@ -0,0 +1 @@
+export const FILL_IN_BLANK_ITEM_TYPE = 'FILL_IN_BLANK';

package/dist/shared/types/questions/index.d.ts

@@ -33,4 +33,6 @@ export * from './word-order-and-match-group';
 export * from './crossword-puzzle';
 export * from './find-words-in-matrix';
 export * from './match-word-to-picture';
+export * from './matching-with-lines-group';
 export * from './true-false-correct-group';
+export * from './fill-in-blank-group';

package/dist/shared/types/questions/index.js

@@ -52,5 +52,9 @@ export * from './crossword-puzzle';
 export * from './find-words-in-matrix';
 // MATCH_WORD_TO_PICTURE
 export * from './match-word-to-picture';
+// MATCHING_WITH_LINES_GROUP
+export * from './matching-with-lines-group';
 // TRUE_FALSE_CORRECT_GROUP
 export * from './true-false-correct-group';
+// FILL_IN_BLANK_GROUP
+export * from './fill-in-blank-group';

package/dist/shared/types/questions/matching-with-lines-group.d.ts

@@ -0,0 +1,39 @@
+export interface MatchingWithLinesRightItem {
+    id: string;
+    text: string;
+}
+export interface MatchingWithLinesGroupItemContent {
+    imageUrl: string;
+}
+export interface MatchingWithLinesGroupItem {
+    isExample?: boolean;
+    content: MatchingWithLinesGroupItemContent;
+    correctAnswer?: {
+        answer: string;
+    };
+    points?: number;
+    questionNumber?: number;
+}
+export interface MatchingWithLinesGroupContent {
+    meta?: {
+        instruction?: string;
+        title?: string;
+    };
+    rightItems: MatchingWithLinesRightItem[];
+    items: MatchingWithLinesGroupItem[];
+}
+export interface MatchingWithLinesGroupCorrectAnswer {
+    answer: string[];
+}
+export interface MatchingWithLinesGroupAPIPayload {
+    id?: string;
+    questionType: 'MATCHING_WITH_LINES_GROUP';
+    content: MatchingWithLinesGroupContent;
+    correctAnswer: MatchingWithLinesGroupCorrectAnswer;
+    points: number;
+    explanation?: string;
+    questionNumber: number;
+    partId?: string;
+    partNo?: number;
+}
+export type MatchingWithLinesGroupLocalStorage = MatchingWithLinesGroupAPIPayload;

package/dist/shared/types/questions/matching-with-lines-group.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tinyweb_dev/oe-exam-sdk",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "description": "Reusable OceanEdu question components.",
   "type": "module",
   "main": "./dist/index.js",