@tinyweb_dev/oe-exam-sdk 0.1.3 → 0.1.4

package/dist/components/exams/take/types.d.ts

@@ -1 +1,286 @@
-export type { ExamTakingAnswerValue, ExamTakingAttempt, ExamTakingQuestion, ExamTakingQuestionsResult, ExamTakingSdkApi, ExamTakingTemplatePart, SaveExamTakingAnswersInput } from '../../../api/exam-taking';
+/**
+ * Types for Movers Exam UI
+ */
+import type { ReactNode } from 'react';
+export interface FillBlankQuestion {
+    id: string;
+    questionNumber: number;
+    textBefore: string;
+    textAfter: string;
+    verbHint?: string;
+    correctAnswer?: string;
+    imageUrl?: string;
+    hints?: string[];
+    isExample?: boolean;
+}
+export interface MoversListenAndWriteRendererProps {
+    partNumber: number;
+    partName?: string;
+    questionCount: number;
+    instruction: string;
+    imageUrl?: string;
+    audioUrl?: string;
+    title: string;
+    exampleText?: string;
+    exampleHighlight?: string;
+    questions: FillBlankQuestion[];
+    answers: Record<string, string>;
+    onAnswerChange: (questionId: string, value: string) => void;
+    isReviewMode?: boolean;
+    showHints?: boolean;
+}
+export interface MoversExamLayoutProps {
+    children: ReactNode;
+    headerProps: {
+        remainingSeconds: number;
+        totalQuestions: number;
+        answeredCount: number;
+        progress: number;
+    };
+    onPrevious: () => void;
+    onNext: () => void;
+    isFirstQuestion: boolean;
+    isLastQuestion: boolean;
+}
+export interface MoversQuestionCardProps {
+    children: ReactNode;
+    className?: string;
+}
+export interface MoversPartBannerProps {
+    partNumber: number;
+    questionCount: number;
+    partName?: string;
+}
+export interface MoversInstructionBannerProps {
+    instruction: string;
+}
+export interface MoversAudioPlayerProps {
+    audioUrl: string;
+}
+export interface MoversExampleTextProps {
+    text: string;
+    highlight?: string;
+}
+export interface WritingQuestion {
+    id: string;
+    partNumber: number;
+    prompt: string;
+    requirements?: string[];
+    minWords?: number;
+    maxWords?: number;
+}
+export interface MoversWritingRendererProps {
+    partNumber: number;
+    prompt: string;
+    requirements?: string[];
+    minWords?: number;
+    maxWords?: number;
+    answer: string;
+    onAnswerChange: (value: string) => void;
+    isReviewMode?: boolean;
+}
+/** Hint item - có thể là color-only, text-only, hoặc cả hai */
+export interface ColoringHintItem {
+    id: string;
+    color?: string;
+    label?: string;
+}
+/** Region trên image để drop hint */
+export interface ColoringRegion {
+    id: string;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    correctHintId: string;
+}
+/** Props cho MoversColoringRenderer */
+export interface MoversColoringRendererProps {
+    partNumber: number;
+    partName?: string;
+    questionCount: number;
+    instruction: string;
+    instructions?: string[];
+    hasExample?: boolean;
+    imageUrl: string;
+    audioUrl?: string;
+    hintItems: ColoringHintItem[];
+    regions: ColoringRegion[];
+    assignments: Record<string, string>;
+    onAssignmentChange: (regionId: string, hintItemId: string | null) => void;
+    isReviewMode?: boolean;
+}
+export interface ChooseBestAnswerOption {
+    id: string;
+    label: string;
+    text: string;
+}
+export interface ChooseBestAnswerQuestion {
+    id: string;
+    questionNumber: number;
+    questionText: string;
+    options: ChooseBestAnswerOption[];
+    correctOptionId?: string;
+    correctOptionIds?: string[];
+    imageUrl?: string;
+    optionType?: 'text' | 'image';
+    multipleAnswers?: boolean;
+    explanation?: string;
+}
+export interface ChooseBestAnswerExample {
+    questionNumber: number;
+    questionText: string;
+    options: ChooseBestAnswerOption[];
+    correctOptionId: string;
+    optionType?: 'text' | 'image';
+    imageUrl?: string;
+}
+export interface MoversChooseBestAnswerRendererProps {
+    partNumber: number;
+    partName?: string;
+    questionCount: number;
+    instruction: string;
+    imageUrl?: string;
+    groupTitle?: string;
+    groupContent?: string;
+    audioUrl?: string;
+    example?: ChooseBestAnswerExample;
+    questions: ChooseBestAnswerQuestion[];
+    answers: Record<string, string | string[]>;
+    onAnswerChange: (questionId: string, optionId: string | string[]) => void;
+    isReviewMode?: boolean;
+    articles?: ArticleItem[];
+}
+/** Article data for ARTICLES group type (e.g., KFS Reading Part 2) */
+export interface ArticleItem {
+    name: string;
+    content: string;
+    imageUrl?: string;
+}
+export interface PictureChooseOption {
+    id: string;
+    label: string;
+    text: string;
+}
+export interface PictureChooseSubQuestion {
+    id: string;
+    questionNumber: number;
+    imageUrl: string;
+    questionText?: string;
+    options: PictureChooseOption[];
+    correctOptionId?: string;
+}
+export interface MoversPictureChooseRendererProps {
+    partNumber: number;
+    partName?: string;
+    questionCount: number;
+    instruction: string;
+    subQuestions: PictureChooseSubQuestion[];
+    answers: Record<string, string>;
+    onAnswerChange: (subQuestionId: string, optionId: string) => void;
+    isReviewMode?: boolean;
+}
+export interface PictureFillBlankOption {
+    id: string;
+    label: string;
+    text: string;
+}
+export interface PictureFillBlankSubQuestion {
+    id: string;
+    questionNumber: number;
+    imageUrl: string;
+    question: string;
+    options: PictureFillBlankOption[];
+    correctOptionId?: string;
+}
+export interface MoversPictureFillBlankChooseRendererProps {
+    partNumber: number;
+    partName?: string;
+    questionCount: number;
+    instruction: string;
+    subQuestions: PictureFillBlankSubQuestion[];
+    answers: Record<string, string>;
+    onAnswerChange: (subQuestionId: string, optionId: string) => void;
+    isReviewMode?: boolean;
+}
+export interface ReadingPassageOption {
+    id: string;
+    label: string;
+    text: string;
+}
+export interface ReadingPassageQuestion {
+    id: string;
+    questionNumber: number;
+    questionText: string;
+    options: ReadingPassageOption[];
+    correctOptionId?: string;
+}
+export interface MoversReadingPassageRendererProps {
+    partNumber: number;
+    partName?: string;
+    questionCount: number;
+    instruction: string;
+    passageTitle?: string;
+    passage: string;
+    passageImageUrl?: string;
+    questions: ReadingPassageQuestion[];
+    answers: Record<string, string>;
+    onAnswerChange: (questionId: string, optionId: string) => void;
+    isReviewMode?: boolean;
+    correctOptionIdMap?: Record<string, string>;
+}
+export interface LabelThePictureLabel {
+    id: string;
+    number: number;
+    correctAnswer?: string;
+    isPreFilled?: boolean;
+}
+export interface MoversLabelThePictureRendererProps {
+    partNumber: number;
+    partName?: string;
+    questionCount: number;
+    instruction: string;
+    imageUrl: string;
+    wordBank: string[];
+    labels: LabelThePictureLabel[];
+    answers: Record<string, string>;
+    onAnswerChange: (labelId: string, value: string) => void;
+    isReviewMode?: boolean;
+}
+export interface FillWordHintSubQuestion {
+    id: string;
+    questionNumber: number;
+    imageUrl: string;
+    word: string;
+    correctAnswer?: string;
+    blankIndex?: number;
+}
+export interface MoversFillWordHintRendererProps {
+    partNumber: number;
+    partName?: string;
+    questionCount: number;
+    instruction: string;
+    hintLetters: string[];
+    subQuestions: FillWordHintSubQuestion[];
+    answers: Record<string, string>;
+    onAnswerChange: (subQuestionId: string, value: string) => void;
+    isReviewMode?: boolean;
+}
+export interface GridCellAnswer {
+    correctAnswer: string;
+}
+export interface MoversGridFillRendererProps {
+    partNumber: number;
+    partName?: string;
+    questionCount: number;
+    instruction: string;
+    grid: (string | null)[][];
+    rows: number;
+    columns: number;
+    cellAnswers: Record<string, GridCellAnswer>;
+    answers: Record<string, string>;
+    onAnswerChange: (cellKey: string, value: string) => void;
+    isReviewMode?: boolean;
+    caseSensitive?: boolean;
+    disabledCells?: string[];
+}

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

@@ -0,0 +1,26 @@
+/**
+ * Answer Transformers - Transform frontend answers to API format
+ *
+ * Frontend stores answers with synthetic IDs for UI convenience.
+ * This module transforms them to the format backend expects.
+ *
+ * Backend grading service expects:
+ * - Single choice: { answer: optionIndex } or { optionId: "uuid" }
+ * - Fill blank: { answer: "text" } or { answers: ["text1", "text2"] }
+ * - Matching: { pairs: [{ left: "id1", right: "id2" }] }
+ */
+import type { SaveAnswerRequest } from '../../../../shared/types/student.types';
+import type { QuestionPart } from './question-transformers';
+/**
+ * Transform frontend answers to API format
+ *
+ * @param answers - Record of questionId -> answer from store
+ * @param parts - Question parts for context
+ * @returns Array of SaveAnswerRequest ready for API
+ */
+export declare function transformAnswersForSubmission(answers: Record<string, any>, parts: QuestionPart[]): SaveAnswerRequest[];
+/**
+ * Get all valid question IDs from parts
+ * Used to filter out invalid IDs before submission
+ */
+export declare function getValidQuestionIds(parts: QuestionPart[]): Set<string>;

package/dist/components/exams/take/utils/answer-transformers.js

@@ -0,0 +1 @@
+function n(n){const t=n.match(/-opt-(\d+)$/);return t?parseInt(t[1],10):0}function t(n){return"string"==typeof n&&n.includes("-opt-")}function e(n){return Array.isArray(n)&&n.every(n=>t(n))}function s(n){return"object"==typeof n&&null!==n&&!Array.isArray(n)&&t(n.optionId)}function o(n){return n.startsWith("sq-")||n.includes("-sq-")||n.includes("-blank-")}function r(n){return/^\d+-\d+$/.test(n)}function i(n){return n.startsWith("label-")}function u(n){return n.startsWith("region-")}function f(n,t){for(const n of t)if("READ_PASSAGE_AND_ANSWER_QUESTIONS"===n.questionType&&n.questions.length>0)return{parentId:n.questions[0].id,questionType:n.questionType};return null}function a(n){for(const t of n)if("FILL_MISSING_WORDS_IN_GRID"===t.questionType&&t.questions.length>0)return{parentId:t.questions[0].id,questionType:t.questionType};return null}function c(n){for(const t of n)if("LABEL_THE_PICTURE"===t.questionType&&t.questions.length>0)return{parentId:t.questions[0].id,questionType:t.questionType};return null}function p(n,t){for(const e of t)if(("READ_AND_COLOR_OBJECTS"===e.questionType||"IMAGE_OBJECT_MATCHING"===e.questionType)&&e.questions.length>0){const t=e.questions[0],s=t.content;if((s?.regions||s?.regionNodes||[]).some(t=>t.id===n))return{parentId:t.id,questionType:e.questionType}}return null}function d(n,t){for(const e of t)if("LOOK_PICTURE_FILL_WORD_HINT"===e.questionType)for(const t of e.questions){if(n.startsWith(`${t.id}-blank-`))return{parentId:t.id,questionType:e.questionType};const s=t.content;if(s?.subQuestions?.some(t=>t.id===n))return{parentId:t.id,questionType:e.questionType}}return null}function I(n,t){for(const e of t)for(const t of e.questions)if(t.id===n)return e.questionType;return null}function q(n,t){return"number"==typeof n||"string"==typeof n?{answer:n}:Array.isArray(n)?"WORD_FILL_PARAGRAPH"===t?{answers:n}:{answer:n}:"object"==typeof n&&null!==n?n:{answer:n}}export function transformAnswersForSubmission(l,y){const T=[],_=new Map,h=new Map,w=new Map,A=new Map,g=new Set;for(const n of y)for(const t of n.questions)"SPEAKING"===t.question_skill_type&&g.add(t.id);for(const[S,b]of Object.entries(l)){if(null==b||""===b)continue;if(g.has(S)&&"string"==typeof b)continue;if(r(S)){const n=a(y);n&&(h.has(n.parentId)||h.set(n.parentId,{}),h.get(n.parentId)[S]=String(b));continue}if(i(S)){const n=c(y);n&&(w.has(n.parentId)||w.set(n.parentId,{}),w.get(n.parentId)[S]=String(b));continue}if(u(S)){const n=p(S,y);n&&(A.has(n.parentId)||A.set(n.parentId,{}),A.get(n.parentId)[S]=String(b));continue}if(o(S)){let e=f(0,y);if(e||(e=d(S,y)),e){_.has(e.parentId)||_.set(e.parentId,{});const s=t(b)?n(b):b;_.get(e.parentId)[S]=s}continue}const l=I(S,y);let E;E=t(b)?q(n(b),l):e(b)?q(b.map(t=>n(t)),l):s(b)?q(n(b.optionId),l):q(b,l),T.push({questionId:S,answer:E})}for(const[n,t]of _){if(Object.keys(t).some(n=>n.includes("-blank-"))){const e=Object.entries(t).sort(([n],[t])=>{const e=n.match(/-blank-(\d+)$/),s=t.match(/-blank-(\d+)$/);return(e?parseInt(e[1],10):0)-(s?parseInt(s[1],10):0)}).map(([,n])=>n).join(", ");T.push({questionId:n,answer:{answer:e}})}else T.push({questionId:n,answer:{subAnswers:t}})}for(const[n,t]of h)T.push({questionId:n,answer:{answers:t}});for(const[n,t]of w)T.push({questionId:n,answer:{answers:t}});for(const[n,t]of A)T.push({questionId:n,answer:{answers:t}});return T}export function getValidQuestionIds(n){const t=new Set;for(const e of n)for(const n of e.questions)t.add(n.id);return t}

package/dist/components/exams/take/utils/coloring-assignments.d.ts

@@ -0,0 +1,5 @@
+export interface ColoringHintItemLike {
+    id: string;
+    color?: string | null;
+}
+export declare function normalizeColoringAssignments(rawAssignments: unknown, hintItems: ColoringHintItemLike[]): Record<string, string>;

package/dist/components/exams/take/utils/coloring-assignments.js

@@ -0,0 +1 @@
+function t(t){return"object"==typeof t&&null!==t}export function normalizeColoringAssignments(n,r){if(!t(n))return{};const o={};return Object.entries(n).forEach(([n,i])=>{const e=function(n){if("string"==typeof n)return n;if(!t(n))return null;const r=["hintItemId","id","value","color"];for(const t of r){const r=n[t];if("string"==typeof r&&r.trim())return r}return null}(i);if(e){if(e.startsWith("#")){const t=r.find(t=>t.color===e);return void(t&&(o[n]=t.id))}o[n]=e}}),o}

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

@@ -0,0 +1,362 @@
+/**
+ * Question Transformers - Transform API response to renderer props
+ *
+ * Maps backend question types to frontend renderer props.
+ * 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_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 interface ApiQuestion {
+    id: string;
+    content: any;
+    is_example: boolean;
+    total_points: string;
+    question_type: QuestionType;
+    explanation: string;
+    difficult_level: string;
+    question_skill_type: string;
+    exam_id: string;
+    part_id: string;
+    part_no: number;
+    question_number: number;
+    correct_answer?: any;
+    audio_url?: string;
+    group_id?: string;
+    questionGroup?: {
+        id: string;
+        payload: {
+            passage?: string;
+            passageTitle?: string;
+            passageImageUrl?: string;
+            mainImageUrl?: string;
+            instructions?: string;
+            hintLetters?: string[];
+            [key: string]: any;
+        };
+    } | null;
+}
+export interface QuestionPart {
+    partId: string;
+    partNo: number;
+    questionType: QuestionType;
+    questions: ApiQuestion[];
+    name?: string;
+    instructions?: string;
+    audioUrl?: string;
+    templateOrder?: number;
+    category?: string;
+    /** Section-level metadata carried from the template when a part is split by sections. */
+    sectionId?: number;
+    isGroup?: boolean;
+    optionMode?: string;
+    optionCount?: number;
+    viewMode?: string;
+    defaultValue?: string[];
+    multipleAnswers?: boolean;
+    questionConfig?: string[];
+    wordBankConfig?: string[];
+    group?: TemplateGroupConfig;
+    /** Section list kept whole for IELTS Reading parts (DOCUMENT passage + mixed sub-sections). */
+    sections?: TemplateSection[];
+    /** Zero-based exam-order start index of this part/section (for question numbering). */
+    startIndex?: number;
+    endIndex?: number;
+}
+/** Nested template group payload ({ items, config, type }) from the API template. */
+export interface TemplateGroupConfig {
+    items?: Array<{
+        number: number;
+        questionCount: number;
+    }>;
+    config?: string[];
+    type?: string;
+}
+/**
+ * Section within a template part (for parts with mixed question types)
+ * Used in Movers P8 (2 sections) and P11 (3 sections), and IELTS parts
+ * whose sections mix question types (e.g. SECTION 2 / Reading passages).
+ */
+export interface TemplateSection {
+    name?: string;
+    sectionId?: number;
+    startIndex: number;
+    endIndex: number;
+    questionType: QuestionType;
+    questionCount: number;
+    viewMode?: string;
+    instructions?: string;
+    isGroup?: boolean;
+    optionMode?: string;
+    optionCount?: number;
+    defaultValue?: string[];
+    multipleAnswers?: boolean;
+    questionConfig?: string[];
+    wordBankConfig?: string[];
+    group?: TemplateGroupConfig;
+}
+/**
+ * Template part structure from exam.template.parts
+ */
+export interface TemplatePart {
+    id: string | number;
+    name: string;
+    instructions?: string;
+    sections?: TemplateSection[];
+    audioUrl?: string;
+    category?: string;
+}
+/**
+ * Group questions by part_id AND questionGroup.id
+ * This ensures questions with different passages (different questionGroups)
+ * within the same part are properly separated.
+ *
+ * Handles template sections: parts with `sections` array are split into
+ * multiple QuestionPart entries with section-specific questionTypes.
+ * Used for Movers P8 (2 sections) and P11 (3 sections).
+ *
+ * @param questions - API questions to group
+ * @param templateParts - Optional template parts with name/instructions metadata
+ */
+export declare function groupQuestionsByPart(questions: ApiQuestion[], templateParts?: TemplatePart[]): QuestionPart[];
+export declare function transformFillInBlank(questions: ApiQuestion[]): {
+    questions: FillBlankQuestion[];
+    title: string;
+    imageUrl?: string;
+    audioUrl?: string;
+    exampleText?: string;
+    exampleHighlight?: string;
+    instruction: string;
+    showHints?: boolean;
+    groupContent?: string;
+    groupTitle?: string;
+    groupImageUrl?: string;
+};
+export declare function transformWriteCorrectVerbForm(questions: ApiQuestion[]): {
+    questions: FillBlankQuestion[];
+    title: string;
+    instruction: string;
+};
+export declare function transformChooseCorrectAnswer(questions: ApiQuestion[]): {
+    questions: ChooseBestAnswerQuestion[];
+    example?: import('../types').ChooseBestAnswerExample;
+    imageUrl?: string;
+    groupImageUrl?: string;
+    groupTitle?: string;
+    groupContent?: string;
+    articles?: Array<{
+        name: string;
+        content: string;
+        imageUrl?: string;
+    }>;
+    audioUrl?: string;
+    instruction: string;
+};
+export interface ChooseAdjectiveOption {
+    id: string;
+    label: string;
+    text: string;
+}
+export interface ChooseAdjectiveQuestion {
+    id: string;
+    questionNumber: number;
+    sentenceBefore: string;
+    sentenceAfter: string;
+    options: ChooseAdjectiveOption[];
+}
+export declare function transformChooseCorrectAdjective(questions: ApiQuestion[]): {
+    questions: ChooseAdjectiveQuestion[];
+    instruction: string;
+};
+export declare function transformWriteShortLetter(question: ApiQuestion): {
+    prompt: string;
+    requirements?: string[];
+    minWords?: number;
+    maxWords?: number;
+    guideImages?: string[];
+};
+export declare function transformColorObjects(questions: ApiQuestion[]): {
+    instruction: string;
+    instructions?: string[];
+    imageUrl: string;
+    audioUrl?: string;
+    hintItems: ColoringHintItem[];
+    regions: ColoringRegion[];
+};
+export declare function transformPictureChoose(questions: ApiQuestion[]): {
+    subQuestions: PictureChooseSubQuestion[];
+    instruction: string;
+};
+export declare function transformPictureFillBlankChoose(questions: ApiQuestion[]): {
+    subQuestions: PictureFillBlankSubQuestion[];
+    instruction: string;
+};
+export declare function transformReadingPassage(questions: ApiQuestion[]): {
+    passage: string;
+    passageTitle?: string;
+    passageImageUrl?: string;
+    instruction: string;
+    questions: ReadingPassageQuestion[];
+};
+export declare function transformLabelPicture(questions: ApiQuestion[]): {
+    imageUrl: string;
+    wordBank: string[];
+    labels: LabelThePictureLabel[];
+    instruction: string;
+};
+export declare function transformFillWordHint(questions: ApiQuestion[]): {
+    subQuestions: FillWordHintSubQuestion[];
+    hintLetters: string[];
+    instruction: string;
+};
+export declare function transformGridFill(questions: ApiQuestion[]): {
+    grid: (string | null)[][];
+    rows: number;
+    columns: number;
+    instruction: string;
+    disabledCells: string[];
+};
+export interface AnswerTheQuestionQuestion {
+    id: string;
+    questionNumber: number;
+    question: string;
+    imageUrl?: string;
+    prefixText?: string;
+    suffixText?: string;
+    suggestedAnswers?: string[];
+    isExample: boolean;
+    exampleAnswer?: string;
+}
+export declare function transformAnswerTheQuestion(questions: ApiQuestion[]): {
+    questions: AnswerTheQuestionQuestion[];
+    instruction: string;
+    imageUrl?: string;
+    title?: string;
+    groupContent?: string;
+};
+export interface TrueFalseQuestion {
+    id: string;
+    questionNumber: number;
+    question: string;
+    imageUrl?: string;
+    isExample: boolean;
+    exampleCorrectAnswer?: boolean;
+}
+export declare function transformTrueFalse(questions: ApiQuestion[]): {
+    questions: TrueFalseQuestion[];
+    instruction: string;
+    imageUrl?: string;
+    groupContent?: string;
+};
+export interface WordOrderingQuestion {
+    id: string;
+    questionNumber: number;
+    words: string[];
+    imageUrl?: string;
+    isExample: boolean;
+    exampleAnswer?: string[];
+}
+export declare function transformWordOrdering(questions: ApiQuestion[]): {
+    questions: WordOrderingQuestion[];
+    instruction: string;
+};
+export declare function transformWordFillParagraph(questions: ApiQuestion[]): {
+    questionId: string;
+    paragraph: string;
+    title?: string;
+    imageUrl?: string;
+    wordBank: Array<{
+        word: string;
+        imageUrl?: string;
+        isExample?: boolean;
+    }>;
+    viewMode: 'WITH_WORD_BANK' | 'WITH_OPTIONS' | 'DEFAULT' | 'EMAIL';
+    instruction: string;
+    exampleAnswer?: string[];
+    emailFrom?: string;
+    emailTo?: string;
+};
+export interface MatchByWritingAnswerQuestion {
+    id: string;
+    questionNumber: number;
+    question: string;
+    imageUrl?: string;
+    isExample: boolean;
+    exampleAnswer?: string;
+    askerName?: string;
+    answererName?: string;
+}
+export interface MatchByWritingAnswerOption {
+    answer: string;
+    imageUrl: string;
+    content?: string;
+}
+export declare function transformMatchByWritingAnswer(questions: ApiQuestion[]): {
+    questions: MatchByWritingAnswerQuestion[];
+    options: MatchByWritingAnswerOption[];
+    instruction: string;
+    viewMode: 'DEFAULT' | 'CONVERSATION';
+    groupImageUrl?: string;
+    askerName?: string;
+    answererName?: string;
+};
+export declare function transformWriteSentences(questions: ApiQuestion[]): {
+    questions: Array<{
+        id: string;
+        questionNumber: number;
+    }>;
+    instruction: string;
+    imageUrl?: string;
+    title?: string;
+    groupContent?: string;
+};
+export interface WordFillStructuredFormQuestion {
+    id: string;
+    questionNumber: number;
+    title: string;
+    imageUrl?: string;
+    content: string;
+    answers: Record<string, string>;
+    caseSensitive: boolean;
+}
+export declare function transformWordFillStructuredForm(questions: ApiQuestion[]): {
+    questions: WordFillStructuredFormQuestion[];
+    instruction: string;
+    groupTitle?: string;
+    groupContent?: string;
+    groupImageUrl?: string;
+    audioUrl?: string;
+};
+export interface SceneObjectNode {
+    id: string;
+    imageUrl: string;
+    label: string;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export declare function transformListenChooseObjects(questions: ApiQuestion[]): {
+    audioUrl: string;
+    backgroundImageUrl: string;
+    objectNodes: SceneObjectNode[];
+    correctObjectId: string;
+    isBackup: boolean;
+    instruction: string;
+};
+export interface ListenSpeakAnswerArrowNode {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export declare function transformListenSpeakAnswer(questions: ApiQuestion[]): {
+    questions: Array<{
+        id: string;
+        questionNumber: number;
+        audioUrl: string;
+        arrowNode?: ListenSpeakAnswerArrowNode;
+        backgroundImageUrl: string;
+        isBackup: boolean;
+    }>;
+    instruction: string;
+};