@tinyweb_dev/oe-exam-sdk 0.2.3 → 0.2.4

package/dist/components/questions/types/write-a-short-letter/WriteAShortLetterClient.js

@@ -17,8 +17,22 @@ function GuideImageDisplay({ imageKey }) {
             } }) }));
 }
 export function WriteAShortLetterClient({ questionData, onSubmit, isReviewMode = false, userAnswer, explanation, }) {
-    const { informations, minWords, maxWords, instructions, guideImages } = questionData;
-    const instruction = instructions?.mainInstruction || '';
+    const { minWords = 20, maxWords } = questionData;
+    const instruction = questionData.instructions?.mainInstruction ||
+        (typeof questionData.instructions === 'string' ? questionData.instructions : '') ||
+        questionData.instruction ||
+        questionData.prompt ||
+        '';
+    const informations = Array.isArray(questionData.informations)
+        ? questionData.informations
+        : Array.isArray(questionData.requirements)
+            ? questionData.requirements
+            : [];
+    const guideImages = Array.isArray(questionData.guideImages)
+        ? questionData.guideImages
+        : Array.isArray(questionData.images)
+            ? questionData.images
+            : [];
     // Initialize answer state - ensure it's always a string
     const [answer, setAnswer] = useState(typeof userAnswer === 'string' ? userAnswer : '');
     // Sync userAnswer when it changes (e.g., when loading from server in review mode)

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

@@ -0,0 +1,8 @@
+import type { Question } from '../../../shared/types/entities/question.types';
+type AnswerTheQuestionGroupViewerProps = {
+    question: Question;
+    isReviewMode?: boolean;
+    userAnswer?: string[];
+};
+export declare function AnswerTheQuestionGroupViewer({ question, isReviewMode, userAnswer, }: AnswerTheQuestionGroupViewerProps): import("react").JSX.Element;
+export {};

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

@@ -0,0 +1,11 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { AnswerTheQuestionGroupClient } from '../types/answer-the-question-group/AnswerTheQuestionGroupClient';
+import { mapQuestionToAnswerTheQuestionGroupData } from '../types/answer-the-question-group/map-answer-the-question-group-data';
+export function AnswerTheQuestionGroupViewer({ question, isReviewMode = false, userAnswer, }) {
+    const questionData = mapQuestionToAnswerTheQuestionGroupData(question);
+    const reviewAnswers = isReviewMode && !userAnswer
+        ? questionData.items.map((item) => item.expectedAnswers[0] || '')
+        : userAnswer;
+    return (_jsx(AnswerTheQuestionGroupClient, { questionData: questionData, isReviewMode: isReviewMode, userAnswers: reviewAnswers }));
+}

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

@@ -20,6 +20,7 @@ import { LookPictureFillBlankChooseAnswerClient } from '../types/look-picture-fi
 import { FillMissingWordsInGridClient } from '../types/fill-missing-words-in-grid/FillMissingWordsInGridClient';
 import { WordFillStructuredFormClient } from '../types/word-fill-structured-form/WordFillStructuredFormClient';
 import { CrosswordPuzzleClient } from '../types/crossword-puzzle/CrosswordPuzzleClient';
+import { FindWordsInMatrixClient } from '../types/find-words-in-matrix/FindWordsInMatrixClient';
 import { parseFillBlankStemLine } from '../_shared/utils/parseFillBlankStem';
 import { WordFillStructuredFormViewer } from './WordFillStructuredFormViewer';
 import { ChooseTheCorrectAnswerGroupViewer } from './ChooseTheCorrectAnswerGroupViewer';
@@ -27,6 +28,7 @@ import { TrueFalseGroupViewer } from './TrueFalseGroupViewer';
 import { CrossOutWordGroupViewer } from './CrossOutWordGroupViewer';
 import { SpontaneousQaGroupViewer } from './SpontaneousQaGroupViewer';
 import { WordOrderAndMatchGroupViewer } from './WordOrderAndMatchGroupViewer';
+import { AnswerTheQuestionGroupViewer } from './AnswerTheQuestionGroupViewer';
 export function QuestionViewer({ question, onSubmitAnswer, isReviewMode = false, userAnswer, }) {
     const [selectedAnswer, setSelectedAnswer] = useState(userAnswer || null);
     const [playCount, setPlayCount] = useState(0);
@@ -314,13 +316,41 @@ export function QuestionViewer({ question, onSubmitAnswer, isReviewMode = false,
             }, isReviewMode: isReviewMode, userAnswer: userAnswer }));
     };
     const renderWriteAShortLetter = () => {
-        const answer = question.answer;
+        const content = (question.content || {});
+        const answer = (question.answer || {});
+        const mainInstruction = content?.instructions?.mainInstruction ||
+            content?.instruction ||
+            content?.prompt ||
+            answer?.instructions?.mainInstruction ||
+            answer?.instruction ||
+            (typeof content?.instructions === 'string' ? content.instructions : '') ||
+            (typeof content === 'string' ? content : '') ||
+            '';
+        const informations = (Array.isArray(content?.informations)
+            ? content.informations
+            : Array.isArray(content?.requirements)
+                ? content.requirements
+                : Array.isArray(answer?.informations)
+                    ? answer.informations
+                    : []).map((info) => typeof info === 'string' ? info : (info.text || info.content || ''));
+        const guideImages = Array.isArray(content?.guideImages)
+            ? content.guideImages
+            : Array.isArray(answer?.guideImages)
+                ? answer.guideImages
+                : [];
+        const contexts = content?.contexts || answer?.contexts || [];
+        const minWords = content?.minWords ?? answer?.minWords ?? 20;
+        const maxWords = content?.maxWords ?? answer?.maxWords ?? null;
         const questionData = {
-            contexts: answer?.contexts || [],
-            informations: answer?.informations || [],
-            minWords: answer?.minWords || 20,
-            maxWords: answer?.maxWords,
-            instruction: answer?.instruction || '',
+            contexts,
+            informations,
+            guideImages,
+            minWords,
+            maxWords,
+            instructions: {
+                mainInstruction,
+            },
+            instruction: mainInstruction,
         };
         return (_jsx(WriteAShortLetterClient, { questionData: questionData, onSubmit: (answerText) => {
                 setSelectedAnswer(answerText);
@@ -600,6 +630,8 @@ export function QuestionViewer({ question, onSubmitAnswer, isReviewMode = false,
                 return (_jsx(TrueFalseGroupViewer, { question: question, isReviewMode: isReviewMode, userAnswer: userAnswer }));
             case 'CROSS_OUT_WORD_GROUP':
                 return (_jsx(CrossOutWordGroupViewer, { question: question, isReviewMode: isReviewMode }));
+            case 'ANSWER_THE_QUESTION_GROUP':
+                return (_jsx(AnswerTheQuestionGroupViewer, { question: question, isReviewMode: isReviewMode, userAnswer: userAnswer }));
             case 'SPONTANEOUS_QA_GROUP':
                 return (_jsx(SpontaneousQaGroupViewer, { question: question, isReviewMode: isReviewMode }));
             case 'WORD_ORDER_AND_MATCH_GROUP':
@@ -646,6 +678,8 @@ export function QuestionViewer({ question, onSubmitAnswer, isReviewMode = false,
                 return (_jsx(WordFillStructuredFormViewer, { question: question, isReviewMode: isReviewMode, userAnswer: userAnswer, onSubmitAnswer: onSubmitAnswer }));
             case 'CROSSWORD_PUZZLE':
                 return (_jsx(CrosswordPuzzleClient, { content: question.content, correctAnswer: question.answer, isReviewMode: isReviewMode, userAnswers: userAnswer }));
+            case 'FIND_WORDS_IN_MATRIX':
+                return (_jsx(FindWordsInMatrixClient, { content: question.content, correctAnswer: question.answer, showSolution: isReviewMode }));
             default:
                 return _jsxs("div", { children: ["Lo\u1EA1i c\u00E2u h\u1ECFi kh\u00F4ng \u0111\u01B0\u1EE3c h\u1ED7 tr\u1EE3: ", question.type] });
         }

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

@@ -6,3 +6,4 @@ export { TrueFalseGroupViewer } from './TrueFalseGroupViewer';
 export { CrossOutWordGroupViewer } from './CrossOutWordGroupViewer';
 export { SpontaneousQaGroupViewer } from './SpontaneousQaGroupViewer';
 export { WordOrderAndMatchGroupViewer } from './WordOrderAndMatchGroupViewer';
+export { AnswerTheQuestionGroupViewer } from './AnswerTheQuestionGroupViewer';

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

@@ -6,3 +6,4 @@ export { TrueFalseGroupViewer } from './TrueFalseGroupViewer';
 export { CrossOutWordGroupViewer } from './CrossOutWordGroupViewer';
 export { SpontaneousQaGroupViewer } from './SpontaneousQaGroupViewer';
 export { WordOrderAndMatchGroupViewer } from './WordOrderAndMatchGroupViewer';
+export { AnswerTheQuestionGroupViewer } from './AnswerTheQuestionGroupViewer';

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, CrossOutWordGroupViewer, SpontaneousQaGroupViewer, WordOrderAndMatchGroupViewer, } from './components/questions/viewer';
+export { QuestionViewer, QuestionGroupViewer, WordFillStructuredFormViewer, ChooseTheCorrectAnswerGroupViewer, TrueFalseGroupViewer, CrossOutWordGroupViewer, SpontaneousQaGroupViewer, WordOrderAndMatchGroupViewer, AnswerTheQuestionGroupViewer, } 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, CrossOutWordGroupViewer, SpontaneousQaGroupViewer, WordOrderAndMatchGroupViewer, } from './components/questions/viewer';
+export { QuestionViewer, QuestionGroupViewer, WordFillStructuredFormViewer, ChooseTheCorrectAnswerGroupViewer, TrueFalseGroupViewer, CrossOutWordGroupViewer, SpontaneousQaGroupViewer, WordOrderAndMatchGroupViewer, AnswerTheQuestionGroupViewer, } from './components/questions/viewer';

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

@@ -424,8 +424,8 @@ const handlers = {
     WORD_ORDERING: reverseSimpleAnswer,
     WORD_FILL_PARAGRAPH: reverseSimpleAnswer,
     MATCH_BY_WRITING_ANSWER: reverseGroupPayload,
-    WRITE_SENTENCES: reverseGroupPayload,
-    WRITE_A_SHORT_LETTER: reverseSimpleAnswer,
+    WRITE_SHORT_PARAGRAPH: reverseWriteShortParagraph,
+    WRITE_A_SHORT_LETTER: reverseWriteAShortLetter,
     WRITE_CORRECT_VERB_FORM: reverseSimpleAnswer,
     CHOOSE_CORRECT_ADJECTIVE: reverseSimpleAnswer,
     WORD_FILL_STRUCTURED_FORM: reverseGroupPayload,
@@ -449,6 +449,59 @@ const handlers = {
     CROSSWORD_PUZZLE: reverseCrosswordPuzzle,
     FIND_WORDS_IN_MATRIX: reverseFindWordsInMatrix,
 };
+function reverseWriteAShortLetter(apiQuestion) {
+    const content = asRecord(apiQuestion.content);
+    const answer = readAnswer(apiQuestion);
+    const informations = asArray(content.informations ?? answer.informations).map((item) => asString(item)).filter(Boolean);
+    const guideImages = asArray(content.guideImages ?? answer.guideImages).map((item) => asString(item)).filter(Boolean);
+    const contexts = asArray(content.contexts ?? answer.contexts);
+    const instructions = isRecord(content.instructions)
+        ? content.instructions
+        : isRecord(answer.instructions)
+            ? answer.instructions
+            : { mainInstruction: asString(content.instruction ?? content.prompt ?? answer.instruction ?? answer.prompt) };
+    const minWords = asNumber(content.minWords ?? answer.minWords, 20);
+    const maxWords = content.maxWords !== undefined && content.maxWords !== null
+        ? asNumber(content.maxWords, 0) || null
+        : answer.maxWords !== undefined && answer.maxWords !== null
+            ? asNumber(answer.maxWords, 0) || null
+            : null;
+    const resolved = {
+        instructions,
+        instruction: asString(instructions.mainInstruction || instructions.instruction),
+        informations,
+        guideImages,
+        contexts,
+        minWords,
+        maxWords,
+    };
+    return {
+        content: resolved,
+        answer: resolved,
+    };
+}
+function reverseWriteShortParagraph(apiQuestion) {
+    const content = asRecord(apiQuestion.content);
+    const answer = readAnswer(apiQuestion);
+    const contexts = asArray(content.contexts ?? answer.contexts);
+    const instruction = asString(content.instruction ?? content.instructions?.mainInstruction ?? answer.instruction);
+    const minWords = asNumber(content.minWords ?? answer.minWords, 20);
+    const maxWords = content.maxWords !== undefined && content.maxWords !== null
+        ? asNumber(content.maxWords, 0) || null
+        : answer.maxWords !== undefined && answer.maxWords !== null
+            ? asNumber(answer.maxWords, 0) || null
+            : null;
+    const resolved = {
+        instruction,
+        contexts,
+        minWords,
+        maxWords,
+    };
+    return {
+        content: resolved,
+        answer: resolved,
+    };
+}
 function reverseCrosswordPuzzle(apiQuestion) {
     const apiContent = (apiQuestion.content || {});
     const apiAnswer = (apiQuestion.correctAnswer || apiQuestion.correct_answer || apiQuestion.answer || {});

package/package.json

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