@tinyweb_dev/oe-exam-sdk 0.1.30 → 0.1.32

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

@@ -54,11 +54,23 @@ export function validateQuestionForTransform(question) {
         case 'WRITE_A_SHORT_LETTER':
             validateWordLimits(answer, errors);
             break;
+        case 'CROSSWORD_PUZZLE':
+            validateCrossword(content, answer, errors);
+            break;
         default:
             break;
     }
     return { isValid: errors.length === 0, errors };
 }
+function validateCrossword(content, answer, errors) {
+    const clues = (content?.clues || answer?.clues);
+    const hasAcrossOrDown = (Array.isArray(clues?.across) && clues.across.length > 0) ||
+        (Array.isArray(clues?.down) && clues.down.length > 0) ||
+        (Array.isArray(clues) && clues.length > 0);
+    if (!hasAcrossOrDown) {
+        errors.push('Cần ít nhất 1 gợi ý (Across hoặc Down) cho bài ô chữ');
+    }
+}
 function validateGrid(content, answer, errors) {
     if (!Array.isArray(content?.grid))
         errors.push('Grid is required for FILL_MISSING_WORDS_IN_GRID');

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';
@@ -40,6 +41,7 @@ import { transformSpeakingConversation } from '../../../components/questions/typ
 import { transformSpeakingCueCard } from '../../../components/questions/types/speaking-cue-card/transform';
 import { transformGNSpeakingInterview } from '../../../components/questions/types/gn-speaking-interview/transform';
 import { transformWordFillStructuredForm } from '../../../components/questions/types/word-fill-structured-form/transform';
+import { transformCrosswordPuzzle } from '../../../components/questions/types/crossword-puzzle/transform';
 // ─── Handler map ────────────────────────────────────────────────────────────
 const questionTransformHandlers = {
     // Look picture
@@ -63,6 +65,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,
@@ -86,6 +89,7 @@ const questionTransformHandlers = {
     SPEAKING_CUE_CARD: transformSpeakingCueCard,
     GN_SPEAKING_INTERVIEW: transformGNSpeakingInterview,
     WORD_FILL_STRUCTURED_FORM: transformWordFillStructuredForm,
+    CROSSWORD_PUZZLE: transformCrosswordPuzzle,
 };
 /**
  * Transform frontend question format to API format.

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' | 'CROSSWORD_PUZZLE';
 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/crossword-puzzle.d.ts

@@ -0,0 +1,50 @@
+/**
+ * CROSSWORD_PUZZLE Question Type Interfaces
+ *
+ * This question type displays an interactive crossword grid with Across & Down clues.
+ *
+ * API format:
+ * - content: { title?, gridSize: { rows, cols }, clues: { across, down } }
+ * - correctAnswer: { answers: Record<string, string>, caseSensitive?: boolean }
+ */
+import { QuestionBankSettings } from './choose-the-correct-answer';
+export interface CrosswordClue {
+    number: number;
+    clue: string;
+    startRow: number;
+    startCol: number;
+    length: number;
+    isExample?: boolean;
+}
+export type CrosswordSubtype = 'STANDARD' | 'HIDDEN_WORD';
+export interface CrosswordPuzzleContent {
+    type?: CrosswordSubtype;
+    title?: string;
+    gridSize: {
+        rows: number;
+        cols: number;
+    };
+    markedColumn?: number;
+    clues: {
+        across: CrosswordClue[];
+        down: CrosswordClue[];
+    };
+}
+export interface CrosswordPuzzleCorrectAnswer {
+    answers: Record<string, string>;
+    caseSensitive?: boolean;
+}
+export interface CrosswordPuzzleAPIPayload {
+    id?: string;
+    questionType: 'CROSSWORD_PUZZLE';
+    content: CrosswordPuzzleContent;
+    correctAnswer: CrosswordPuzzleCorrectAnswer;
+    points: number;
+    explanation?: string;
+    questionNumber: number;
+    partId?: string;
+    partNo?: number;
+    addToQuestionBank?: boolean;
+    questionBank?: QuestionBankSettings;
+}
+export type CrosswordPuzzleLocalStorage = Omit<CrosswordPuzzleAPIPayload, 'addToQuestionBank' | 'questionBank'>;

package/dist/shared/types/questions/crossword-puzzle.js

@@ -0,0 +1,10 @@
+/**
+ * CROSSWORD_PUZZLE Question Type Interfaces
+ *
+ * This question type displays an interactive crossword grid with Across & Down clues.
+ *
+ * API format:
+ * - content: { title?, gridSize: { rows, cols }, clues: { across, down } }
+ * - correctAnswer: { answers: Record<string, string>, caseSensitive?: boolean }
+ */
+export {};

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';
@@ -29,3 +30,4 @@ export * from './read-displayed-content';
 export * from './speaking-describe-image';
 export * from './spontaneous-qa';
 export * from './word-order-and-match-group';
+export * from './crossword-puzzle';

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
@@ -44,3 +46,5 @@ export * from './speaking-describe-image';
 export * from './spontaneous-qa';
 // WORD_ORDER_AND_MATCH_GROUP
 export * from './word-order-and-match-group';
+// CROSSWORD_PUZZLE
+export * from './crossword-puzzle';

package/package.json

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