@tinyweb_dev/oe-exam-sdk 0.1.28 → 0.1.30

package/dist/components/exams/take/utils/question-transformers.d.ts

@@ -5,7 +5,7 @@
  * Each transformer handles specific question type data structure.
  */
 import type { FillBlankQuestion, ChooseBestAnswerQuestion, PictureChooseSubQuestion, PictureFillBlankSubQuestion, ReadingPassageQuestion, LabelThePictureLabel, FillWordHintSubQuestion, ColoringHintItem, ColoringRegion } from '../types';
-export type QuestionType = 'FILL_IN_BLANK' | 'WRITE_CORRECT_VERB_FORM' | 'CHOOSE_THE_CORRECT_ANSWER' | 'CHOOSE_THE_CORRECT_ANSWER_GROUP' | 'CHOOSE_CORRECT_ADJECTIVE' | 'WRITE_A_SHORT_LETTER' | 'READ_AND_COLOR_OBJECTS' | 'LOOK_PICTURE_CHOOSE_CORRECT_ANSWER' | 'LOOK_PICTURE_FILL_BLANK_CHOOSE_ANSWER' | 'READ_PASSAGE_AND_ANSWER_QUESTIONS' | 'LABEL_THE_PICTURE' | 'LOOK_PICTURE_FILL_WORD_HINT' | 'FILL_MISSING_WORDS_IN_GRID' | 'IMAGE_OBJECT_MATCHING' | 'ANSWER_THE_QUESTION' | 'TRUE_FALSE' | 'WORD_ORDERING' | 'WORD_FILL_PARAGRAPH' | 'MATCH_BY_WRITING_ANSWER' | 'WRITE_SENTENCES' | 'WORD_FILL_STRUCTURED_FORM' | 'LISTEN_AND_CHOOSE_OBJECTS_IN_SCENE' | 'LISTEN_AND_CHOOSE_FROM_ANSWER_GROUP' | 'LISTEN_AND_DRAG_OBJECTS_INTO_SCENE' | 'LISTEN_AND_SPEAK_ANSWER' | 'LISTEN_AND_SPEAK_COMPARE_IMAGES' | 'LISTEN_AND_SPEAK_WITH_STORY_IMAGES' | 'LISTEN_AND_SPEAK_IMAGE_GROUP' | 'LISTEN_AND_SPEAK_ODD_ONE_OUT' | 'LISTEN_AND_SPEAK_QUESTION_LIST' | 'LISTEN_AND_SPEAK_INFO_EXCHANGE' | 'READ_DISPLAYED_CONTENT' | 'SPEAKING_DESCRIBE_IMAGE' | 'SPONTANEOUS_QA' | 'SPEAKING_CONVERSATION' | 'GN_SPEAKING_INTERVIEW' | 'SPEAKING_CUE_CARD';
+export type QuestionType = 'FILL_IN_BLANK' | 'WRITE_CORRECT_VERB_FORM' | 'CHOOSE_THE_CORRECT_ANSWER' | 'CHOOSE_THE_CORRECT_ANSWER_GROUP' | 'CHOOSE_CORRECT_ADJECTIVE' | 'WRITE_A_SHORT_LETTER' | 'READ_AND_COLOR_OBJECTS' | 'LOOK_PICTURE_CHOOSE_CORRECT_ANSWER' | 'LOOK_PICTURE_FILL_BLANK_CHOOSE_ANSWER' | 'READ_PASSAGE_AND_ANSWER_QUESTIONS' | 'LABEL_THE_PICTURE' | 'LOOK_PICTURE_FILL_WORD_HINT' | 'FILL_MISSING_WORDS_IN_GRID' | 'IMAGE_OBJECT_MATCHING' | 'ANSWER_THE_QUESTION' | 'TRUE_FALSE' | 'TRUE_FALSE_GROUP' | 'CROSS_OUT_WORD_GROUP' | 'WORD_ORDERING' | 'WORD_FILL_PARAGRAPH' | 'MATCH_BY_WRITING_ANSWER' | 'WRITE_SENTENCES' | 'WORD_FILL_STRUCTURED_FORM' | 'WORD_ORDER_AND_MATCH_GROUP' | 'LISTEN_AND_CHOOSE_OBJECTS_IN_SCENE' | 'LISTEN_AND_CHOOSE_FROM_ANSWER_GROUP' | 'LISTEN_AND_DRAG_OBJECTS_INTO_SCENE' | 'LISTEN_AND_SPEAK_ANSWER' | 'LISTEN_AND_SPEAK_COMPARE_IMAGES' | 'LISTEN_AND_SPEAK_WITH_STORY_IMAGES' | 'LISTEN_AND_SPEAK_IMAGE_GROUP' | 'LISTEN_AND_SPEAK_ODD_ONE_OUT' | 'LISTEN_AND_SPEAK_QUESTION_LIST' | 'LISTEN_AND_SPEAK_INFO_EXCHANGE' | 'READ_DISPLAYED_CONTENT' | 'SPEAKING_DESCRIBE_IMAGE' | 'SPONTANEOUS_QA' | 'SPONTANEOUS_QA_GROUP' | 'SPEAKING_CONVERSATION' | 'GN_SPEAKING_INTERVIEW' | 'SPEAKING_CUE_CARD';
 export interface ApiQuestion {
     id: string;
     content: any;
@@ -140,7 +140,9 @@ export declare function transformWriteCorrectVerbForm(questions: ApiQuestion[]):
     title: string;
     instruction: string;
 };
-export declare function transformChooseCorrectAnswer(questions: ApiQuestion[]): {
+export declare function transformChooseCorrectAnswer(questions: ApiQuestion[], optionsConfig?: {
+    shuffleOptions?: boolean;
+}): {
     questions: ChooseBestAnswerQuestion[];
     example?: import('../types').ChooseBestAnswerExample;
     imageUrl?: string;
@@ -256,6 +258,12 @@ export declare function transformTrueFalse(questions: ApiQuestion[]): {
     imageUrl?: string;
     groupContent?: string;
 };
+export declare function transformTrueFalseGroup(questions: ApiQuestion[]): {
+    questions: TrueFalseQuestion[];
+    instruction: string;
+    imageUrl?: string;
+    groupContent?: string;
+};
 export interface WordOrderingQuestion {
     id: string;
     questionNumber: number;
@@ -318,6 +326,13 @@ export declare function transformWriteSentences(questions: ApiQuestion[]): {
     title?: string;
     groupContent?: string;
 };
+export type WfsfBlankStyle = 'letter' | 'word' | 'phrase';
+export type WfsfWordBankEntry = {
+    options: string[];
+} | {
+    word: string;
+    isExample?: boolean;
+} | null;
 export interface WordFillStructuredFormQuestion {
     id: string;
     questionNumber: number;
@@ -326,6 +341,12 @@ export interface WordFillStructuredFormQuestion {
     content: string;
     answers: Record<string, string>;
     caseSensitive: boolean;
+    /** letter = square boxes; word / phrase = underline width */
+    blankStyle: WfsfBlankStyle;
+    /** WITH_OPTIONS when choice-inline options present (plan 0024). */
+    viewMode?: string;
+    /** Index i ↔ blank key "i" (or order of {n} appearance). */
+    wordBank?: WfsfWordBankEntry[];
 }
 export declare function transformWordFillStructuredForm(questions: ApiQuestion[]): {
     questions: WordFillStructuredFormQuestion[];
@@ -369,3 +390,23 @@ export declare function transformListenSpeakAnswer(questions: ApiQuestion[]): {
     }>;
     instruction: string;
 };
+export interface WordOrderAndMatchGroupItemAnswer {
+    orderedPhrase: string;
+    matchLabel: string;
+}
+export interface WordOrderAndMatchGroupQuestionItem {
+    id: string;
+    questionNumber: number;
+    scrambledWords: string[];
+    orderedPhrase: string;
+    matchLabel: string;
+    isExample: boolean;
+    points: number;
+}
+export interface WordOrderAndMatchGroupPartData {
+    questions: WordOrderAndMatchGroupQuestionItem[];
+    instruction: string;
+    matchOptions: string[];
+    explanation?: string;
+}
+export declare function transformWordOrderAndMatchGroup(questions: ApiQuestion[]): WordOrderAndMatchGroupPartData;