@tinyweb_dev/oe-exam-sdk 0.1.31 → 0.2.0

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

@@ -41,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
@@ -88,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' | '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 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/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

@@ -30,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

@@ -46,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.31",
+  "version": "0.2.0",
   "description": "Reusable OceanEdu question components.",
   "type": "module",
   "main": "./dist/index.js",