@tinyweb_dev/oe-exam-sdk 0.1.29 → 0.1.31

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

@@ -186,6 +186,44 @@ const reverseChooseTheCorrectAnswerGroup = (apiQuestion) => {
         },
     };
 };
+const reverseAnswerTheQuestionGroup = (apiQuestion) => {
+    const content = asRecord(apiQuestion.content);
+    const answer = readAnswer(apiQuestion);
+    const fallbackAnswers = asArray(answer.answer);
+    const items = asArray(content.items).map((rawItem, index) => {
+        const item = asRecord(rawItem);
+        const itemContent = asRecord(item.content);
+        const itemAnswer = asRecord(item.correctAnswer);
+        const nested = asArray(itemAnswer.expectedAnswers)
+            .filter((value) => typeof value === 'string')
+            .map((value) => value.trim())
+            .filter((value) => value !== '');
+        const fallback = asRecord(fallbackAnswers[index]);
+        const fallbackExpected = asArray(fallback.expectedAnswers)
+            .filter((value) => typeof value === 'string')
+            .map((value) => value.trim())
+            .filter((value) => value !== '');
+        const expectedAnswers = nested.length > 0 ? nested : (fallbackExpected.length > 0 ? fallbackExpected : ['']);
+        const isExample = item.isExample === true;
+        return {
+            question: asString(itemContent.question),
+            expectedAnswers,
+            isExample,
+            points: isExample ? 0 : asNumber(item.points, 1),
+            questionNumber: asNumber(item.questionNumber, index + 1),
+        };
+    });
+    return {
+        content: '',
+        answer: {
+            instruction: asString(asRecord(content.meta).instruction, 'Read the text again and answer the questions.'),
+            passage: asString(asRecord(content.meta).passage),
+            items,
+            explanation: asString(apiQuestion.explanation),
+            points: items.reduce((total, item) => (item.isExample ? total : total + item.points), 0),
+        },
+    };
+};
 const reverseTrueFalseGroup = (apiQuestion) => {
     const content = asRecord(apiQuestion.content);
     const answer = readAnswer(apiQuestion);
@@ -367,6 +405,7 @@ const reverseSimpleAnswer = (apiQuestion) => {
 const handlers = {
     CHOOSE_THE_CORRECT_ANSWER: reverseChooseTheCorrectAnswer,
     CHOOSE_THE_CORRECT_ANSWER_GROUP: reverseChooseTheCorrectAnswerGroup,
+    ANSWER_THE_QUESTION_GROUP: reverseAnswerTheQuestionGroup,
     TRUE_FALSE_GROUP: reverseTrueFalseGroup,
     CROSS_OUT_WORD_GROUP: reverseCrossOutWordGroup,
     WORD_ORDER_AND_MATCH_GROUP: reverseWordOrderAndMatchGroup,

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

@@ -17,6 +17,7 @@ import { transformFillInBlank } from '../../../components/questions/types/fill-i
 import { transformWriteCorrectVerbForm } from '../../../components/questions/types/write-correct-verb-form/transform';
 import { transformChooseCorrectAdjective } from '../../../components/questions/types/choose-correct-adjective/transform';
 import { transformAnswerTheQuestion } from '../../../components/questions/types/answer-the-question/transform';
+import { transformAnswerTheQuestionGroup } from '../../../components/questions/types/answer-the-question-group/transform';
 import { transformTrueFalse } from '../../../components/questions/types/true-false/transform';
 import { transformWordOrdering } from '../../../components/questions/types/word-ordering/transform';
 import { transformWordFillParagraph } from '../../../components/questions/types/word-fill-paragraph/transform';
@@ -63,6 +64,7 @@ const questionTransformHandlers = {
     WRITE_CORRECT_VERB_FORM: transformWriteCorrectVerbForm,
     CHOOSE_CORRECT_ADJECTIVE: transformChooseCorrectAdjective,
     ANSWER_THE_QUESTION: transformAnswerTheQuestion,
+    ANSWER_THE_QUESTION_GROUP: transformAnswerTheQuestionGroup,
     TRUE_FALSE: transformTrueFalse,
     WORD_ORDERING: transformWordOrdering,
     WORD_FILL_PARAGRAPH: transformWordFillParagraph,

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' | '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' | 'WORD_ORDERING' | 'WORD_FILL_PARAGRAPH' | 'MATCH_BY_WRITING_ANSWER' | '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';
+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' | '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' | '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';
 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/answer-the-question-group.d.ts

@@ -0,0 +1,39 @@
+export declare const ANSWER_THE_QUESTION_GROUP_GRADING_TYPE: "AI";
+export interface AnswerTheQuestionGroupItemContent {
+    question: string;
+}
+export interface AnswerTheQuestionGroupItemExpectedAnswer {
+    expectedAnswers: string[];
+}
+export interface AnswerTheQuestionGroupItem {
+    questionType?: 'ANSWER_THE_QUESTION';
+    isExample?: boolean;
+    content: AnswerTheQuestionGroupItemContent;
+    correctAnswer?: AnswerTheQuestionGroupItemExpectedAnswer;
+    points?: number;
+    questionNumber?: number;
+}
+export interface AnswerTheQuestionGroupContent {
+    meta?: {
+        instruction?: string;
+        passage?: string;
+        gradingType: typeof ANSWER_THE_QUESTION_GROUP_GRADING_TYPE;
+        isAiGraded: true;
+    };
+    items: AnswerTheQuestionGroupItem[];
+}
+export interface AnswerTheQuestionGroupCorrectAnswer {
+    answer: AnswerTheQuestionGroupItemExpectedAnswer[];
+}
+export interface AnswerTheQuestionGroupAPIPayload {
+    id?: string;
+    questionType: 'ANSWER_THE_QUESTION_GROUP';
+    content: AnswerTheQuestionGroupContent;
+    correctAnswer: AnswerTheQuestionGroupCorrectAnswer;
+    points: number;
+    explanation?: string;
+    questionNumber: number;
+    partId?: string;
+    partNo?: number;
+}
+export type AnswerTheQuestionGroupLocalStorage = AnswerTheQuestionGroupAPIPayload;

package/dist/shared/types/questions/answer-the-question-group.js

@@ -0,0 +1 @@
+export const ANSWER_THE_QUESTION_GROUP_GRADING_TYPE = 'AI';

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

@@ -16,6 +16,7 @@
  * - LocalStorage: Same format but WITHOUT addToQuestionBank and questionBank
  */
 export * from './choose-the-correct-answer';
+export * from './answer-the-question-group';
 export * from './choose-the-correct-answer-group';
 export * from './cross-out-word-group';
 export * from './write-correct-verb-form';

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

@@ -17,6 +17,8 @@
  */
 // CHOOSE_THE_CORRECT_ANSWER
 export * from './choose-the-correct-answer';
+// ANSWER_THE_QUESTION_GROUP
+export * from './answer-the-question-group';
 // CHOOSE_THE_CORRECT_ANSWER_GROUP
 export * from './choose-the-correct-answer-group';
 // CROSS_OUT_WORD_GROUP

package/package.json

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