@tinyweb_dev/oe-exam-sdk 1.0.9 → 1.0.11

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

@@ -511,14 +511,29 @@ const reverseMatchingWithLinesGroup = (apiQuestion) => {
             questionNumber: asNumber(item.questionNumber, index + 1),
         };
     });
+    const readMatchingMedia = (value) => {
+        if (Array.isArray(value)) {
+            const cleaned = value
+                .filter((item) => typeof item === 'string')
+                .map((item) => item.trim())
+                .filter((item) => item !== '');
+            if (cleaned.length === 0)
+                return undefined;
+            return cleaned.length === 1 ? cleaned[0] : cleaned;
+        }
+        const single = asString(value).trim();
+        return single || undefined;
+    };
+    const audioUrl = readMatchingMedia(meta.audioUrl);
+    const imageUrl = readMatchingMedia(meta.imageUrl);
     return {
         content: '',
         answer: {
             title: asString(meta.title),
             instruction: asString(meta.instruction, 'Look and match.'),
             ...(asString(meta.passage).trim() ? { passage: asString(meta.passage).trim() } : {}),
-            ...(asString(meta.audioUrl).trim() ? { audioUrl: asString(meta.audioUrl).trim() } : {}),
-            ...(asString(meta.imageUrl).trim() ? { imageUrl: asString(meta.imageUrl).trim() } : {}),
+            ...(audioUrl !== undefined ? { audioUrl } : {}),
+            ...(imageUrl !== undefined ? { imageUrl } : {}),
             rightItems,
             items,
             explanation: asString(apiQuestion.explanation),
@@ -537,18 +552,27 @@ const reverseCrossOutWordGroup = (apiQuestion) => {
         const fallback = asRecord(fallbackAnswers[index]);
         const answerRaw = Object.keys(itemAnswer).length > 0 ? itemAnswer : fallback;
         const isExample = item.isExample === true;
-        const type = itemContent.type === 'CROSS_OUT_AND_REPLACE' ||
-            answerRaw.type === 'CROSS_OUT_AND_REPLACE'
+        const type = itemContent.type === 'CROSS_OUT_AND_REPLACE'
             ? 'CROSS_OUT_AND_REPLACE'
-            : 'CROSS_OUT';
+            : itemContent.type === 'CROSS_OUT'
+                ? 'CROSS_OUT'
+                : answerRaw.type === 'CROSS_OUT_AND_REPLACE'
+                    ? 'CROSS_OUT_AND_REPLACE'
+                    : 'CROSS_OUT';
+        const rawIndex = answerRaw.wordIndex;
+        const wordIndex = typeof rawIndex === 'number' && Number.isInteger(rawIndex) && rawIndex >= 0
+            ? rawIndex
+            : null;
         const correctAnswer = type === 'CROSS_OUT_AND_REPLACE'
             ? {
                 type: 'CROSS_OUT_AND_REPLACE',
+                wordIndex,
                 crossOut: asString(answerRaw.crossOut),
                 replaceWith: asString(answerRaw.replaceWith),
             }
             : {
                 type: 'CROSS_OUT',
+                wordIndex,
                 crossOut: asString(answerRaw.crossOut),
             };
         return {
@@ -638,12 +662,14 @@ const reverseSpontaneousQaGroup = (apiQuestion) => {
                 const fallback = asRecord(flattenedAnswers[questionIndex]);
                 const expected = asArray(childAnswer.expectedAnswers ?? fallback.expectedAnswers)
                     .filter((value) => typeof value === 'string');
+                const isExample = child.isExample === true;
                 return {
                     questionText: asString(childContent.questionText),
                     inputType: asString(childContent.inputType, 'TEXT') === 'AUDIO' ? 'AUDIO' : 'TEXT',
                     audioUrl: asString(childContent.audioUrl),
                     expectedAnswers: expected.length > 0 ? expected : [''],
-                    points: asNumber(child.points, 1),
+                    isExample,
+                    points: isExample ? 0 : asNumber(child.points, 1),
                     questionNumber: asNumber(child.questionNumber, questionIndex + 1),
                 };
             }),
@@ -890,6 +916,9 @@ function reverseCrosswordPuzzle(apiQuestion) {
     const rows = apiContent.gridSize?.rows || apiContent.rows || 12;
     const cols = apiContent.gridSize?.cols || apiContent.cols || 12;
     const title = apiContent.title || '';
+    const type = apiContent.type === 'HIDDEN_WORD' ? 'HIDDEN_WORD' : 'STANDARD';
+    const instruction = asString(apiQuestion.instruction, asString(apiContent.instruction));
+    const markedColumn = typeof apiContent.markedColumn === 'number' ? apiContent.markedColumn : undefined;
     const across = Array.isArray(apiContent.clues?.across) ? apiContent.clues.across : [];
     const down = Array.isArray(apiContent.clues?.down) ? apiContent.clues.down : [];
     const answers = apiAnswer.answers || {};
@@ -904,6 +933,7 @@ function reverseCrosswordPuzzle(apiQuestion) {
             length: a.length || 1,
             direction: 'across',
             answer: answers[`across-${a.number}`] || '',
+            ...(a.isExample === true ? { isExample: true } : {}),
         });
     }
     for (const d of down) {
@@ -916,24 +946,32 @@ function reverseCrosswordPuzzle(apiQuestion) {
             length: d.length || 1,
             direction: 'down',
             answer: answers[`down-${d.number}`] || '',
+            ...(d.isExample === true ? { isExample: true } : {}),
         });
     }
     return {
         content: {
+            type,
             title,
+            instruction,
             rows,
             cols,
             gridSize: { rows, cols },
+            ...(type === 'HIDDEN_WORD' && markedColumn ? { markedColumn } : {}),
             clues: { across, down },
         },
         answer: {
+            type,
             title,
+            instruction,
             rows,
             cols,
+            ...(type === 'HIDDEN_WORD' && markedColumn ? { markedColumn } : {}),
+            hiddenWord: answers['hidden-word'] || '',
             clues,
             answers,
             caseSensitive: apiAnswer.caseSensitive || false,
-            explanation: apiQuestion.explanation || '',
+            explanation: asString(apiQuestion.explanation),
         },
     };
 }
@@ -944,6 +982,7 @@ function reverseFindWordsInMatrix(apiQuestion) {
     const rows = apiContent.gridSize?.rows || (Array.isArray(apiContent.grid) ? apiContent.grid.length : 14);
     const cols = apiContent.gridSize?.cols || (Array.isArray(apiContent.grid?.[0]) ? apiContent.grid[0].length : 14);
     const title = apiContent.title || '';
+    const instruction = typeof apiContent.instruction === 'string' ? apiContent.instruction : '';
     const grid = Array.isArray(apiContent.grid) ? apiContent.grid : [];
     const categories = Array.isArray(apiContent.categories) ? apiContent.categories : [];
     const wordBank = Array.isArray(apiContent.wordBank) ? apiContent.wordBank : [];
@@ -977,6 +1016,7 @@ function reverseFindWordsInMatrix(apiQuestion) {
         content: {
             type,
             title,
+            instruction,
             rows,
             cols,
             gridSize: { rows, cols },
@@ -989,6 +1029,7 @@ function reverseFindWordsInMatrix(apiQuestion) {
         answer: {
             type,
             title,
+            instruction,
             rows,
             cols,
             grid,

package/dist/shared/types/questions/crossword-puzzle.d.ts

@@ -20,6 +20,7 @@ export type CrosswordSubtype = 'STANDARD' | 'HIDDEN_WORD';
 export interface CrosswordPuzzleContent {
     type?: CrosswordSubtype;
     title?: string;
+    instruction?: string;
     gridSize: {
         rows: number;
         cols: number;

package/dist/shared/types/questions/find-words-in-matrix.d.ts

@@ -30,6 +30,7 @@ export interface ExampleSelection {
 export interface FindWordsInMatrixContent {
     type?: FindWordsInMatrixType;
     title?: string;
+    instruction?: string;
     gridSize: {
         rows: number;
         cols: number;

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

@@ -20,9 +20,9 @@ export interface MatchingWithLinesGroupContent {
     meta?: {
         instruction?: string;
         title?: string;
-        audioUrl?: string;
+        audioUrl?: string | string[];
         passage?: string;
-        imageUrl?: string;
+        imageUrl?: string | string[];
     };
     rightItems: MatchingWithLinesRightItem[];
     items: MatchingWithLinesGroupItem[];

package/package.json

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