@tinyweb_dev/oe-exam-sdk 0.2.12 → 0.2.14

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' | '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' | 'MATCH_COLUMNS_TO_MAKE_SENTENCES' | 'MATCH_WORD_TO_PICTURE_GROUP' | 'WORD_ORDERING_GROUP';
+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' | 'SORT_WORDS_INTO_CATEGORIES' | 'CHOOSE_THEN_ANSWER_GROUP' | 'MATCH_COLUMNS_TO_MAKE_SENTENCES' | 'MATCH_WORD_TO_PICTURE_GROUP' | 'WORD_ORDERING_GROUP';
 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

@@ -1,6 +1,7 @@
 export declare const ANSWER_THE_QUESTION_GROUP_GRADING_TYPE: "AI";
 export interface AnswerTheQuestionGroupItemContent {
     question: string;
+    imageUrl?: string | string[];
 }
 export interface AnswerTheQuestionGroupItemExpectedAnswer {
     expectedAnswers: string[];
@@ -17,6 +18,8 @@ export interface AnswerTheQuestionGroupContent {
     meta?: {
         instruction?: string;
         passage?: string;
+        audioUrl?: string;
+        imageUrl?: string | string[];
         gradingType: typeof ANSWER_THE_QUESTION_GROUP_GRADING_TYPE;
         isAiGraded: true;
     };

package/dist/shared/types/questions/choose-then-answer-group.d.ts

@@ -0,0 +1,46 @@
+export interface ChooseThenAnswerOption {
+    id: string;
+    text: string;
+}
+export interface ChooseThenAnswerItemAnswer {
+    optionId: string;
+}
+export interface ChooseThenAnswerStudentItemAnswer {
+    optionId: string;
+    text: string;
+}
+export interface ChooseThenAnswerGroupItemContent {
+    question: string;
+    options: ChooseThenAnswerOption[];
+}
+export interface ChooseThenAnswerGroupItem {
+    questionType?: string;
+    isExample?: boolean;
+    content: ChooseThenAnswerGroupItemContent;
+    correctAnswer?: {
+        answer: ChooseThenAnswerItemAnswer;
+    };
+    points?: number;
+    questionNumber?: number;
+}
+export interface ChooseThenAnswerGroupContent {
+    meta?: {
+        instruction?: string;
+        title?: string;
+    };
+    items: ChooseThenAnswerGroupItem[];
+}
+export interface ChooseThenAnswerGroupCorrectAnswer {
+    answer: ChooseThenAnswerItemAnswer[];
+}
+export interface ChooseThenAnswerGroupAPIPayload {
+    id?: string;
+    questionType: 'CHOOSE_THEN_ANSWER_GROUP';
+    content: ChooseThenAnswerGroupContent;
+    correctAnswer: ChooseThenAnswerGroupCorrectAnswer;
+    points: number;
+    explanation?: string;
+    questionNumber: number;
+    partId?: string;
+    partNo?: number;
+}

package/dist/shared/types/questions/choose-then-answer-group.js

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

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

@@ -3,12 +3,16 @@ export interface FillInBlankGroupItemAnswer {
     answers: string[][];
     caseSensitive?: boolean;
 }
+export type FillInBlankWordBankEntry = {
+    options: string[];
+} | null;
 export interface FillInBlankGroupItemContent {
     question: string;
-    imageUrl?: string;
+    imageUrl?: string | string[];
     audioUrl?: string;
     showHints?: boolean;
     hints?: string[];
+    wordBank?: FillInBlankWordBankEntry[];
 }
 export interface FillInBlankGroupItem {
     questionType?: typeof FILL_IN_BLANK_ITEM_TYPE;
@@ -21,10 +25,13 @@ export interface FillInBlankGroupItem {
 export interface FillInBlankGroupContent {
     meta?: {
         instruction?: string;
+        passage?: string;
         audioUrl?: string;
-        imageUrl?: string;
+        imageUrl?: string | string[];
         showHints?: boolean;
         hints?: string[];
+        viewMode?: 'WITH_OPTIONS';
+        wordBank?: FillInBlankWordBankEntry[];
     };
     items: FillInBlankGroupItem[];
 }

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

@@ -32,6 +32,8 @@ export * from './spontaneous-qa';
 export * from './word-order-and-match-group';
 export * from './crossword-puzzle';
 export * from './find-words-in-matrix';
+export * from './sort-words-into-categories';
+export * from './choose-then-answer-group';
 export * from './match-word-to-picture';
 export * from './matching-with-lines-group';
 export * from './match-columns-to-make-sentences';

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

@@ -50,6 +50,9 @@ export * from './word-order-and-match-group';
 export * from './crossword-puzzle';
 // FIND_WORDS_IN_MATRIX
 export * from './find-words-in-matrix';
+// SORT_WORDS_INTO_CATEGORIES
+export * from './sort-words-into-categories';
+export * from './choose-then-answer-group';
 // MATCH_WORD_TO_PICTURE
 export * from './match-word-to-picture';
 // MATCHING_WITH_LINES_GROUP

package/dist/shared/types/questions/match-word-to-picture-group.d.ts

@@ -3,7 +3,7 @@ export interface MatchWordToPictureGroupItem {
     questionType?: typeof MATCH_WORD_TO_PICTURE_ITEM_TYPE;
     isExample?: boolean;
     content: {
-        imageUrl: string;
+        imageUrl?: string | string[];
     };
     correctAnswer?: {
         answer: string;
@@ -13,7 +13,13 @@ export interface MatchWordToPictureGroupItem {
 }
 export interface MatchWordToPictureGroupContent {
     meta?: {
+        title?: string;
         instruction?: string;
+        /** Shared reading passage (HTML) above the match-word-to-picture UI. */
+        passage?: string;
+        /** Shared listening audio played once under the instruction. */
+        audioUrl?: string;
+        imageUrl?: string | string[];
         wordBank?: string[];
     };
     items: MatchWordToPictureGroupItem[];

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

@@ -1,9 +1,11 @@
 export interface MatchingWithLinesRightItem {
     id: string;
-    text: string;
+    text?: string;
+    imageUrl?: string;
 }
 export interface MatchingWithLinesGroupItemContent {
-    imageUrl: string;
+    imageUrl?: string;
+    text?: string;
 }
 export interface MatchingWithLinesGroupItem {
     isExample?: boolean;
@@ -18,6 +20,9 @@ export interface MatchingWithLinesGroupContent {
     meta?: {
         instruction?: string;
         title?: string;
+        audioUrl?: string;
+        passage?: string;
+        imageUrl?: string;
     };
     rightItems: MatchingWithLinesRightItem[];
     items: MatchingWithLinesGroupItem[];

package/dist/shared/types/questions/sort-words-into-categories.d.ts

@@ -0,0 +1,37 @@
+export interface SortWordsCategory {
+    id: string;
+    name: string;
+}
+export interface SortWordsWord {
+    id: string;
+    text: string;
+    points?: number;
+    isExample?: boolean;
+}
+export interface SortWordsPlacement {
+    wordId: string;
+    categoryId: string;
+}
+export interface SortWordsIntoCategoriesContent {
+    meta?: {
+        instruction?: string;
+        title?: string;
+    };
+    categories: SortWordsCategory[];
+    words: SortWordsWord[];
+}
+export interface SortWordsIntoCategoriesCorrectAnswer {
+    placements: SortWordsPlacement[];
+}
+export interface SortWordsIntoCategoriesAPIPayload {
+    id?: string;
+    questionType: 'SORT_WORDS_INTO_CATEGORIES';
+    content: SortWordsIntoCategoriesContent;
+    correctAnswer: SortWordsIntoCategoriesCorrectAnswer;
+    points: number;
+    explanation?: string;
+    questionNumber: number;
+    partId?: string;
+    partNo?: number;
+}
+export type SortWordsIntoCategoriesLocalStorage = SortWordsIntoCategoriesAPIPayload;

package/dist/shared/types/questions/sort-words-into-categories.js

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

package/package.json

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