@tinyweb_dev/oe-exam-sdk 0.1.28 → 0.1.30

package/dist/shared/constants/question-skills.js

@@ -1 +1,277 @@
-import{SkillEnum as E}from"../types/common.types";export const QUESTION_TYPE_SKILLS={LISTEN_AND_FILL_IN_THE_BLANK_WITH_IMAGE:E.LISTENING,LISTEN_AND_TICK_ANSWER:E.LISTENING,LISTEN_AND_FILL_NAME_NUMBER:E.LISTENING,LISTENING_FILL_BLANK:E.LISTENING,LISTENING_COLOR:E.LISTENING,LISTENING:E.LISTENING,LISTEN_AND_CHOOSE_FROM_ANSWER_GROUP:E.SPEAKING,LISTEN_AND_CHOOSE_OBJECTS_IN_SCENE:E.SPEAKING,LISTEN_AND_DRAG_OBJECTS_INTO_SCENE:E.SPEAKING,LISTEN_AND_SPEAK_ANSWER:E.SPEAKING,LISTEN_AND_SPEAK_IMAGE_GROUP:E.SPEAKING,LISTEN_AND_SPEAK_QUESTION_LIST:E.SPEAKING,LISTEN_AND_SPEAK_COMPARE_IMAGES:E.SPEAKING,LISTEN_AND_SPEAK_WITH_STORY_IMAGES:E.SPEAKING,LISTEN_AND_SPEAK_ODD_ONE_OUT:E.SPEAKING,LISTEN_AND_SPEAK_INFO_EXCHANGE:E.SPEAKING,READ_DISPLAYED_CONTENT:E.SPEAKING,SPEAKING_DESCRIBE_IMAGE:E.SPEAKING,SPONTANEOUS_QA:E.SPEAKING,SPEAKING_CONVERSATION:E.SPEAKING,SPEAKING_CUE_CARD:E.SPEAKING,GN_SPEAKING_INTERVIEW:E.SPEAKING,CHOOSE_THE_CORRECT_ANSWER:E.READING,CHOOSE_THE_CORRECT_ANSWER_GROUP:E.READING,CHOOSE_CORRECT_ADJECTIVE:E.READING,FILL_IN_BLANK:E.READING,FILL_MISSING_WORDS_IN_GRID:E.READING,READ_PASSAGE_AND_ANSWER_QUESTIONS:E.READING,ANSWER_THE_QUESTION:E.READING,WORD_ORDERING:E.READING,WORD_FILL_PARAGRAPH:E.READING,MATCH_BY_WRITING_ANSWER:E.READING,LABEL_THE_PICTURE:E.READING,LOOK_PICTURE_CHOOSE_CORRECT_ANSWER:E.READING,LOOK_PICTURE_FILL_BLANK_CHOOSE_ANSWER:E.READING,LOOK_PICTURE_FILL_WORD_HINT:E.READING,READ_AND_COLOR_OBJECTS:E.READING,IMAGE_OBJECT_MATCHING:E.READING,TRUE_FALSE:E.READING,TRUE_FALSE_GROUP:E.READING,CROSS_OUT_WORD_GROUP:E.READING,SPONTANEOUS_QA_GROUP:E.SPEAKING,WORD_ORDER_AND_MATCH_GROUP:E.READING,MATCHING:E.READING,ORDERING:E.READING,TICK_TRUE_OR_FALSE:E.READING,TICK_YES_OR_NO:E.READING,READING_TICK_CROSS:E.READING,ARRANGE_LETTERS_INTO_WORDS:E.READING,READ_PASSAGE_AND_COMPLETE_STORY:E.READING,CLOZE_TEST_WITH_TICK_BOX:E.READING,READ_AND_CHOOSE_APPROPRIATE_WORD:E.READING,READING_LETTER_ARRANGE:E.READING,READING_PASSAGE_FILL:E.READING,FILL_BLANK:E.READING,WORD_FILL_STRUCTURED_FORM:E.READING,WRITE_A_SHORT_LETTER:E.WRITING,WRITE_CORRECT_VERB_FORM:E.WRITING,WRITE_SHORT_PARAGRAPH:E.WRITING,WRITE_SENTENCES:E.WRITING,ESSAY:E.WRITING,COLORING:E.WRITING};export function getQuestionTypeSkill(E){return QUESTION_TYPE_SKILLS[E]||"READING"}export function getQuestionTypesBySkill(E){return Object.entries(QUESTION_TYPE_SKILLS).filter(([_,N])=>N===E).map(([E,_])=>E)}export const QUESTION_TYPES_BY_SKILL={LISTENING:getQuestionTypesBySkill("LISTENING"),SPEAKING:getQuestionTypesBySkill("SPEAKING"),READING:getQuestionTypesBySkill("READING"),WRITING:getQuestionTypesBySkill("WRITING")};export const MARKETING_QUESTION_TYPES_BY_SKILL={[E.LISTENING]:[],[E.SPEAKING]:[],[E.READING]:["CHOOSE_THE_CORRECT_ANSWER","CHOOSE_CORRECT_ADJECTIVE","FILL_IN_BLANK","FILL_MISSING_WORDS_IN_GRID","LABEL_THE_PICTURE","LOOK_PICTURE_CHOOSE_CORRECT_ANSWER","LOOK_PICTURE_FILL_BLANK_CHOOSE_ANSWER","LOOK_PICTURE_FILL_WORD_HINT","READ_AND_COLOR_OBJECTS","IMAGE_OBJECT_MATCHING","READ_PASSAGE_AND_ANSWER_QUESTIONS"],[E.WRITING]:["WRITE_A_SHORT_LETTER","WRITE_CORRECT_VERB_FORM","WRITE_SENTENCES"]};export function isMarketingQuestionType(E){return Object.values(MARKETING_QUESTION_TYPES_BY_SKILL).flat().includes(E)}export const QUESTION_TYPE_LABELS={LISTEN_AND_FILL_IN_THE_BLANK_WITH_IMAGE:"Nghe - Điền từ có hình",LISTEN_AND_TICK_ANSWER:"Nghe - Đánh dấu",LISTEN_AND_FILL_NAME_NUMBER:"Nghe - Điền tên/số",LISTENING_FILL_BLANK:"Nghe - Điền chỗ trống",LISTENING_COLOR:"Nghe - Tô màu",LISTENING:"Nghe",CHOOSE_THE_CORRECT_ANSWER:"Chọn đáp án đúng",CHOOSE_THE_CORRECT_ANSWER_GROUP:"Chọn đáp án đúng (nhóm)",CHOOSE_CORRECT_ADJECTIVE:"Chọn tính từ",FILL_IN_BLANK:"Điền vào chỗ trống",FILL_MISSING_WORDS_IN_GRID:"Điền từ vào lưới",READ_PASSAGE_AND_ANSWER_QUESTIONS:"Đọc hiểu - Trả lời",LABEL_THE_PICTURE:"Gắn nhãn hình ảnh",LOOK_PICTURE_CHOOSE_CORRECT_ANSWER:"Nhìn ảnh - Chọn đáp án",LOOK_PICTURE_FILL_BLANK_CHOOSE_ANSWER:"Nhìn ảnh - Điền và chọn",LOOK_PICTURE_FILL_WORD_HINT:"Nhìn ảnh - Điền từ gợi ý",READ_AND_COLOR_OBJECTS:"Đọc - Tô màu",IMAGE_OBJECT_MATCHING:"Ghép hình ảnh - Đối tượng",TRUE_FALSE:"Đúng/Sai",TRUE_FALSE_GROUP:"Đúng/Sai (nhóm)",CROSS_OUT_WORD_GROUP:"Gạch từ / sửa từ (nhóm)",SPONTANEOUS_QA_GROUP:"Hỏi đáp tự phát (nhóm)",WORD_ORDER_AND_MATCH_GROUP:"Sắp xếp từ và nối nhãn (nhóm)",MATCHING:"Ghép nối",ORDERING:"Sắp xếp",TICK_TRUE_OR_FALSE:"Đánh dấu Đúng/Sai",TICK_YES_OR_NO:"Đánh dấu Có/Không",READING_TICK_CROSS:"Đọc - Đánh dấu",ARRANGE_LETTERS_INTO_WORDS:"Sắp xếp chữ cái thành từ",READ_PASSAGE_AND_COMPLETE_STORY:"Đọc - Hoàn thành câu chuyện",CLOZE_TEST_WITH_TICK_BOX:"Điền từ - Đánh dấu",READ_AND_CHOOSE_APPROPRIATE_WORD:"Đọc - Chọn từ phù hợp",READING_LETTER_ARRANGE:"Đọc - Sắp xếp chữ cái",READING_PASSAGE_FILL:"Đọc - Điền đoạn văn",FILL_BLANK:"Điền chỗ trống",ANSWER_THE_QUESTION:"Nghe - Đọc câu hỏi và viết đáp án",WORD_ORDERING:"Sắp xếp từ",WORD_FILL_PARAGRAPH:"Điền từ vào đoạn văn",MATCH_BY_WRITING_ANSWER:"Ghép đáp án bằng cách viết",WORD_FILL_STRUCTURED_FORM:"Điền từ vào biểu mẫu có cấu trúc",WRITE_A_SHORT_LETTER:"Viết thư",WRITE_CORRECT_VERB_FORM:"Chia động từ",WRITE_SHORT_PARAGRAPH:"Viết đoạn văn ngắn",WRITE_SENTENCES:"Viết câu",ESSAY:"Viết luận",COLORING:"Tô màu",LISTEN_AND_CHOOSE_FROM_ANSWER_GROUP:"Nghe và chọn trong nhóm đáp án",LISTEN_AND_CHOOSE_OBJECTS_IN_SCENE:"Nghe và chọn đối tượng trong cảnh",LISTEN_AND_DRAG_OBJECTS_INTO_SCENE:"Nghe và kéo thả đối tượng vào cảnh",LISTEN_AND_SPEAK_ANSWER:"Nghe và trả lời (Speaking)",LISTEN_AND_SPEAK_IMAGE_GROUP:"Nghe, nhìn nhóm ảnh và trả lời (Speaking)",LISTEN_AND_SPEAK_QUESTION_LIST:"Nghe, chọn câu hỏi và trả lời (Speaking)",LISTEN_AND_SPEAK_COMPARE_IMAGES:"Nghe và so sánh ảnh (Speaking)",LISTEN_AND_SPEAK_WITH_STORY_IMAGES:"Nghe, nhìn ảnh truyện và kể lại (Speaking)",LISTEN_AND_SPEAK_ODD_ONE_OUT:"Nghe, chọn hình khác loại và giải thích (Speaking)",LISTEN_AND_SPEAK_INFO_EXCHANGE:"Trao đổi thông tin (Speaking)",READ_DISPLAYED_CONTENT:"Đọc nội dung hiển thị (Speaking)",SPEAKING_DESCRIBE_IMAGE:"Nhìn tranh và mô tả (Speaking Part 2)",SPONTANEOUS_QA:"Hỏi đáp tự phát (Speaking Part 3)",SPEAKING_CONVERSATION:"Hội thoại Speaking (KFS Speaking)",GN_SPEAKING_INTERVIEW:"GN Speaking - Hỏi đáp (Virtual + Real)"};export function getQuestionTypeLabel(E){return QUESTION_TYPE_LABELS[E]||E}export const SKILL_METADATA={[E.LISTENING]:{name:"Nghe",emoji:"🎧",color:"text-blue-600",bgColor:"bg-blue-50",borderColor:"border-blue-200",description:"Kỹ năng nghe hiểu"},[E.SPEAKING]:{name:"Nói",emoji:"🗣️",color:"text-green-600",bgColor:"bg-green-50",borderColor:"border-green-200",description:"Kỹ năng giao tiếp"},[E.READING]:{name:"Đọc",emoji:"📖",color:"text-purple-600",bgColor:"bg-purple-50",borderColor:"border-purple-200",description:"Kỹ năng đọc hiểu"},[E.WRITING]:{name:"Viết",emoji:"✏️",color:"text-orange-600",bgColor:"bg-orange-50",borderColor:"border-orange-200",description:"Kỹ năng viết"}};
+/**
+ * Question Type to Skill Mapping
+ *
+ * This file defines the mapping between question types and skills.
+ * Each question type belongs to one of the four skills: LISTENING, SPEAKING, READING, or WRITING.
+ */
+import { SkillEnum } from '../types/common.types';
+/**
+ * Maps each question type to its corresponding skill
+ */
+export const QUESTION_TYPE_SKILLS = {
+    // ========================================
+    // LISTENING SKILLS (Nghe)
+    // ========================================
+    'LISTEN_AND_FILL_IN_THE_BLANK_WITH_IMAGE': SkillEnum.LISTENING,
+    'LISTEN_AND_TICK_ANSWER': SkillEnum.LISTENING,
+    'LISTEN_AND_FILL_NAME_NUMBER': SkillEnum.LISTENING,
+    'LISTENING_FILL_BLANK': SkillEnum.LISTENING,
+    'LISTENING_COLOR': SkillEnum.LISTENING,
+    'LISTENING': SkillEnum.LISTENING,
+    // ========================================
+    // SPEAKING SKILLS (Nói)
+    // ========================================
+    'LISTEN_AND_CHOOSE_FROM_ANSWER_GROUP': SkillEnum.SPEAKING,
+    'LISTEN_AND_CHOOSE_OBJECTS_IN_SCENE': SkillEnum.SPEAKING,
+    'LISTEN_AND_DRAG_OBJECTS_INTO_SCENE': SkillEnum.SPEAKING,
+    'LISTEN_AND_SPEAK_ANSWER': SkillEnum.SPEAKING,
+    'LISTEN_AND_SPEAK_IMAGE_GROUP': SkillEnum.SPEAKING,
+    'LISTEN_AND_SPEAK_QUESTION_LIST': SkillEnum.SPEAKING,
+    'LISTEN_AND_SPEAK_COMPARE_IMAGES': SkillEnum.SPEAKING,
+    'LISTEN_AND_SPEAK_WITH_STORY_IMAGES': SkillEnum.SPEAKING,
+    'LISTEN_AND_SPEAK_ODD_ONE_OUT': SkillEnum.SPEAKING,
+    'LISTEN_AND_SPEAK_INFO_EXCHANGE': SkillEnum.SPEAKING,
+    'READ_DISPLAYED_CONTENT': SkillEnum.SPEAKING,
+    'SPEAKING_DESCRIBE_IMAGE': SkillEnum.SPEAKING,
+    'SPONTANEOUS_QA': SkillEnum.SPEAKING,
+    'SPEAKING_CONVERSATION': SkillEnum.SPEAKING,
+    'SPEAKING_CUE_CARD': SkillEnum.SPEAKING,
+    'GN_SPEAKING_INTERVIEW': SkillEnum.SPEAKING,
+    // ========================================
+    // READING SKILLS (Đọc) - Marketing Exam Types
+    // ========================================
+    // Basic reading questions
+    'CHOOSE_THE_CORRECT_ANSWER': SkillEnum.READING,
+    'CHOOSE_THE_CORRECT_ANSWER_GROUP': SkillEnum.READING,
+    'CHOOSE_CORRECT_ADJECTIVE': SkillEnum.READING,
+    'FILL_IN_BLANK': SkillEnum.READING,
+    'FILL_MISSING_WORDS_IN_GRID': SkillEnum.READING,
+    'READ_PASSAGE_AND_ANSWER_QUESTIONS': SkillEnum.READING,
+    'ANSWER_THE_QUESTION': SkillEnum.READING,
+    'WORD_ORDERING': SkillEnum.READING,
+    'WORD_FILL_PARAGRAPH': SkillEnum.READING,
+    'MATCH_BY_WRITING_ANSWER': SkillEnum.READING,
+    // Visual-based reading questions
+    'LABEL_THE_PICTURE': SkillEnum.READING,
+    'LOOK_PICTURE_CHOOSE_CORRECT_ANSWER': SkillEnum.READING,
+    'LOOK_PICTURE_FILL_BLANK_CHOOSE_ANSWER': SkillEnum.READING,
+    'LOOK_PICTURE_FILL_WORD_HINT': SkillEnum.READING,
+    'READ_AND_COLOR_OBJECTS': SkillEnum.READING,
+    'IMAGE_OBJECT_MATCHING': SkillEnum.READING,
+    // Other reading types
+    'TRUE_FALSE': SkillEnum.READING,
+    'TRUE_FALSE_GROUP': SkillEnum.READING,
+    'CROSS_OUT_WORD_GROUP': SkillEnum.READING,
+    'SPONTANEOUS_QA_GROUP': SkillEnum.SPEAKING,
+    'WORD_ORDER_AND_MATCH_GROUP': SkillEnum.READING,
+    'MATCHING': SkillEnum.READING,
+    'ORDERING': SkillEnum.READING,
+    'TICK_TRUE_OR_FALSE': SkillEnum.READING,
+    'TICK_YES_OR_NO': SkillEnum.READING,
+    'READING_TICK_CROSS': SkillEnum.READING,
+    'ARRANGE_LETTERS_INTO_WORDS': SkillEnum.READING,
+    'READ_PASSAGE_AND_COMPLETE_STORY': SkillEnum.READING,
+    'CLOZE_TEST_WITH_TICK_BOX': SkillEnum.READING,
+    'READ_AND_CHOOSE_APPROPRIATE_WORD': SkillEnum.READING,
+    'READING_LETTER_ARRANGE': SkillEnum.READING,
+    'READING_PASSAGE_FILL': SkillEnum.READING,
+    'FILL_BLANK': SkillEnum.READING,
+    'WORD_FILL_STRUCTURED_FORM': SkillEnum.READING,
+    // ========================================
+    // WRITING SKILLS (Viết)
+    // ========================================
+    'WRITE_A_SHORT_LETTER': SkillEnum.WRITING,
+    'WRITE_CORRECT_VERB_FORM': SkillEnum.WRITING,
+    'WRITE_SHORT_PARAGRAPH': SkillEnum.WRITING,
+    'WRITE_SENTENCES': SkillEnum.WRITING,
+    'ESSAY': SkillEnum.WRITING,
+    'COLORING': SkillEnum.WRITING, // Coloring could be considered a form of writing/drawing
+};
+/**
+ * Get the skill for a given question type
+ * @param questionType - The question type
+ * @returns The corresponding skill, or 'READING' as default
+ */
+export function getQuestionTypeSkill(questionType) {
+    return QUESTION_TYPE_SKILLS[questionType] || 'READING';
+}
+/**
+ * Get all question types for a specific skill
+ * @param skill - The skill to filter by
+ * @returns Array of question types that belong to the skill
+ */
+export function getQuestionTypesBySkill(skill) {
+    return Object.entries(QUESTION_TYPE_SKILLS)
+        .filter(([_, questionSkill]) => questionSkill === skill)
+        .map(([type, _]) => type);
+}
+/**
+ * All question types organized by skill
+ * This is auto-generated from QUESTION_TYPE_SKILLS mapping
+ */
+export const QUESTION_TYPES_BY_SKILL = {
+    LISTENING: getQuestionTypesBySkill('LISTENING'),
+    SPEAKING: getQuestionTypesBySkill('SPEAKING'),
+    READING: getQuestionTypesBySkill('READING'),
+    WRITING: getQuestionTypesBySkill('WRITING'),
+};
+/**
+ * Marketing exam question types grouped by skill
+ * These are the 12 main question types used in marketing exams (Grade 1-8)
+ */
+export const MARKETING_QUESTION_TYPES_BY_SKILL = {
+    [SkillEnum.LISTENING]: [], // No listening types yet
+    [SkillEnum.SPEAKING]: [], // No speaking types yet
+    [SkillEnum.READING]: [
+        'CHOOSE_THE_CORRECT_ANSWER',
+        'CHOOSE_CORRECT_ADJECTIVE',
+        'FILL_IN_BLANK',
+        'FILL_MISSING_WORDS_IN_GRID',
+        'LABEL_THE_PICTURE',
+        'LOOK_PICTURE_CHOOSE_CORRECT_ANSWER',
+        'LOOK_PICTURE_FILL_BLANK_CHOOSE_ANSWER',
+        'LOOK_PICTURE_FILL_WORD_HINT',
+        'READ_AND_COLOR_OBJECTS',
+        'IMAGE_OBJECT_MATCHING',
+        'READ_PASSAGE_AND_ANSWER_QUESTIONS',
+    ],
+    [SkillEnum.WRITING]: [
+        'WRITE_A_SHORT_LETTER',
+        'WRITE_CORRECT_VERB_FORM',
+        'WRITE_SENTENCES',
+    ],
+};
+/**
+ * Check if a question type is a marketing exam type
+ * @param questionType - The question type to check
+ * @returns true if it's a marketing exam type
+ */
+export function isMarketingQuestionType(questionType) {
+    return Object.values(MARKETING_QUESTION_TYPES_BY_SKILL)
+        .flat()
+        .includes(questionType);
+}
+/**
+ * Question type labels for UI display (Vietnamese)
+ * Common mapping used across all components
+ */
+export const QUESTION_TYPE_LABELS = {
+    // ========================================
+    // LISTENING SKILLS (Nghe)
+    // ========================================
+    'LISTEN_AND_FILL_IN_THE_BLANK_WITH_IMAGE': 'Nghe - Điền từ có hình',
+    'LISTEN_AND_TICK_ANSWER': 'Nghe - Đánh dấu',
+    'LISTEN_AND_FILL_NAME_NUMBER': 'Nghe - Điền tên/số',
+    'LISTENING_FILL_BLANK': 'Nghe - Điền chỗ trống',
+    'LISTENING_COLOR': 'Nghe - Tô màu',
+    'LISTENING': 'Nghe',
+    // ========================================
+    // READING SKILLS (Đọc) - Marketing Exam Types
+    // ========================================
+    'CHOOSE_THE_CORRECT_ANSWER': 'Chọn đáp án đúng',
+    'CHOOSE_THE_CORRECT_ANSWER_GROUP': 'Chọn đáp án đúng (nhóm)',
+    'CHOOSE_CORRECT_ADJECTIVE': 'Chọn tính từ',
+    'FILL_IN_BLANK': 'Điền vào chỗ trống',
+    'FILL_MISSING_WORDS_IN_GRID': 'Điền từ vào lưới',
+    'READ_PASSAGE_AND_ANSWER_QUESTIONS': 'Đọc hiểu - Trả lời',
+    'LABEL_THE_PICTURE': 'Gắn nhãn hình ảnh',
+    'LOOK_PICTURE_CHOOSE_CORRECT_ANSWER': 'Nhìn ảnh - Chọn đáp án',
+    'LOOK_PICTURE_FILL_BLANK_CHOOSE_ANSWER': 'Nhìn ảnh - Điền và chọn',
+    'LOOK_PICTURE_FILL_WORD_HINT': 'Nhìn ảnh - Điền từ gợi ý',
+    'READ_AND_COLOR_OBJECTS': 'Đọc - Tô màu',
+    'IMAGE_OBJECT_MATCHING': 'Ghép hình ảnh - Đối tượng',
+    'TRUE_FALSE': 'Đúng/Sai',
+    'TRUE_FALSE_GROUP': 'Đúng/Sai (nhóm)',
+    'CROSS_OUT_WORD_GROUP': 'Gạch từ / sửa từ (nhóm)',
+    'SPONTANEOUS_QA_GROUP': 'Hỏi đáp tự phát (nhóm)',
+    'WORD_ORDER_AND_MATCH_GROUP': 'Sắp xếp từ và nối nhãn (nhóm)',
+    'MATCHING': 'Ghép nối',
+    'ORDERING': 'Sắp xếp',
+    'TICK_TRUE_OR_FALSE': 'Đánh dấu Đúng/Sai',
+    'TICK_YES_OR_NO': 'Đánh dấu Có/Không',
+    'READING_TICK_CROSS': 'Đọc - Đánh dấu',
+    'ARRANGE_LETTERS_INTO_WORDS': 'Sắp xếp chữ cái thành từ',
+    'READ_PASSAGE_AND_COMPLETE_STORY': 'Đọc - Hoàn thành câu chuyện',
+    'CLOZE_TEST_WITH_TICK_BOX': 'Điền từ - Đánh dấu',
+    'READ_AND_CHOOSE_APPROPRIATE_WORD': 'Đọc - Chọn từ phù hợp',
+    'READING_LETTER_ARRANGE': 'Đọc - Sắp xếp chữ cái',
+    'READING_PASSAGE_FILL': 'Đọc - Điền đoạn văn',
+    'FILL_BLANK': 'Điền chỗ trống',
+    'ANSWER_THE_QUESTION': 'Nghe - Đọc câu hỏi và viết đáp án',
+    'WORD_ORDERING': 'Sắp xếp từ',
+    'WORD_FILL_PARAGRAPH': 'Điền từ vào đoạn văn',
+    'MATCH_BY_WRITING_ANSWER': 'Ghép đáp án bằng cách viết',
+    'WORD_FILL_STRUCTURED_FORM': 'Điền từ vào biểu mẫu có cấu trúc',
+    // ========================================
+    // WRITING SKILLS (Viết)
+    // ========================================
+    'WRITE_A_SHORT_LETTER': 'Viết thư',
+    'WRITE_CORRECT_VERB_FORM': 'Chia động từ',
+    'WRITE_SHORT_PARAGRAPH': 'Viết đoạn văn ngắn',
+    'WRITE_SENTENCES': 'Viết câu',
+    'ESSAY': 'Viết luận',
+    'COLORING': 'Tô màu',
+    // ========================================
+    // SPEAKING SKILLS (Nói)
+    // ========================================
+    'LISTEN_AND_CHOOSE_FROM_ANSWER_GROUP': 'Nghe và chọn trong nhóm đáp án',
+    'LISTEN_AND_CHOOSE_OBJECTS_IN_SCENE': 'Nghe và chọn đối tượng trong cảnh',
+    'LISTEN_AND_DRAG_OBJECTS_INTO_SCENE': 'Nghe và kéo thả đối tượng vào cảnh',
+    'LISTEN_AND_SPEAK_ANSWER': 'Nghe và trả lời (Speaking)',
+    'LISTEN_AND_SPEAK_IMAGE_GROUP': 'Nghe, nhìn nhóm ảnh và trả lời (Speaking)',
+    'LISTEN_AND_SPEAK_QUESTION_LIST': 'Nghe, chọn câu hỏi và trả lời (Speaking)',
+    'LISTEN_AND_SPEAK_COMPARE_IMAGES': 'Nghe và so sánh ảnh (Speaking)',
+    'LISTEN_AND_SPEAK_WITH_STORY_IMAGES': 'Nghe, nhìn ảnh truyện và kể lại (Speaking)',
+    'LISTEN_AND_SPEAK_ODD_ONE_OUT': 'Nghe, chọn hình khác loại và giải thích (Speaking)',
+    'LISTEN_AND_SPEAK_INFO_EXCHANGE': 'Trao đổi thông tin (Speaking)',
+    'READ_DISPLAYED_CONTENT': 'Đọc nội dung hiển thị (Speaking)',
+    'SPEAKING_DESCRIBE_IMAGE': 'Nhìn tranh và mô tả (Speaking Part 2)',
+    'SPONTANEOUS_QA': 'Hỏi đáp tự phát (Speaking Part 3)',
+    'SPEAKING_CONVERSATION': 'Hội thoại Speaking (KFS Speaking)',
+    'GN_SPEAKING_INTERVIEW': 'GN Speaking - Hỏi đáp (Virtual + Real)',
+};
+/**
+ * Get the label for a question type
+ * @param questionType - The question type
+ * @returns The Vietnamese label for the question type, or the type itself if not found
+ */
+export function getQuestionTypeLabel(questionType) {
+    return QUESTION_TYPE_LABELS[questionType] || questionType;
+}
+/**
+ * Skill metadata for UI display
+ */
+export const SKILL_METADATA = {
+    [SkillEnum.LISTENING]: {
+        name: 'Nghe',
+        emoji: '🎧',
+        color: 'text-blue-600',
+        bgColor: 'bg-blue-50',
+        borderColor: 'border-blue-200',
+        description: 'Kỹ năng nghe hiểu',
+    },
+    [SkillEnum.SPEAKING]: {
+        name: 'Nói',
+        emoji: '🗣️',
+        color: 'text-green-600',
+        bgColor: 'bg-green-50',
+        borderColor: 'border-green-200',
+        description: 'Kỹ năng giao tiếp',
+    },
+    [SkillEnum.READING]: {
+        name: 'Đọc',
+        emoji: '📖',
+        color: 'text-purple-600',
+        bgColor: 'bg-purple-50',
+        borderColor: 'border-purple-200',
+        description: 'Kỹ năng đọc hiểu',
+    },
+    [SkillEnum.WRITING]: {
+        name: 'Viết',
+        emoji: '✏️',
+        color: 'text-orange-600',
+        bgColor: 'bg-orange-50',
+        borderColor: 'border-orange-200',
+        description: 'Kỹ năng viết',
+    },
+};

package/dist/shared/constants/routes.js

@@ -1 +1,81 @@
-export function r(e){return e}export const ROUTES={LOGIN:"/login",LOGOUT:"/logout",CHANGE_PASSWORD:"/change-password",SYSTEM_ADMIN:{DASHBOARD:"/system-admin/dashboard",USERS:"/system-admin/users",TAGS:"/system-admin/tags",OEA_RESULTS:"/system-admin/oea-results"},MANAGE:{DASHBOARD:"/manage/contests",USERS:"/manage/users",USERS_CREATE:"/manage/users/create",USERS_EDIT:e=>`/manage/users/${e}/edit`,QUESTION_BANK:"/manage/question-bank",QUESTION_CREATE:"/manage/question-bank/create",QUESTION_EDIT:e=>`/manage/question-bank/${e}/edit`,EXAMS:"/manage/exams",EXAMS_CREATE:"/manage/exams/create",EXAMS_EDIT:e=>`/manage/exams/${e}/edit`,EXAM_CLASSES:"/manage/exam-classes",EXAM_CLASSES_CREATE:"/manage/exam-classes/create",EXAM_SESSIONS:"/manage/exam-sessions",EXAM_SESSIONS_CREATE:"/manage/exam-sessions/create",EXAM_ROOMS:"/manage/exam-rooms",EXAM_ROOMS_CREATE:"/manage/exam-rooms/create",EXAM_ROOMS_DETAIL:e=>`/manage/exam-rooms/${e}`,TEMPLATES:"/manage/templates",TEMPLATE_DETAIL:e=>`/manage/templates/${e}`,REPORTS:"/manage/reports",REPORTS_ROOMS:"/manage/reports/rooms",SETTINGS:"/manage/settings",STUDENT_TEST_PARTICIPANTS:"/manage/students/test-participants",USER_DETAIL:e=>`/manage/users/${e}`,ROLES:"/manage/roles",ROLE_DETAIL:e=>`/manage/roles/${e}`,ROOMS:"/manage/rooms",ROOM_DETAIL:e=>`/manage/rooms/${e}`,ROOM_MONITOR:e=>`/manage/rooms/${e}/monitor`},get ADMIN(){return this.MANAGE},STUDENT:{DASHBOARD:"/student/contests/discover",CONTESTS_DISCOVER:"/student/contests/discover",CONTESTS_MY:"/student/contests/my-contests",CONTEST_DETAIL:e=>`/student/contests/${e}`,CONTEST_ROOMS:e=>`/student/contests/${e}/rooms`,CONTEST_RESULTS:e=>`/student/contests/${e}/results`,CONTEST_HISTORY:e=>`/student/contests/${e}/history`,CONTEST_ROUNDS:e=>`/student/contests/${e}/rounds`,CONTEST_GALLERY:e=>`/student/contests/${e}/gallery`,CONTEST_DOCUMENTS:e=>`/student/contests/${e}/documents`,EXAM_ROOM:e=>`/student/exams/${e}`,EXAM_ENTER:e=>`/student/exams/${e}/enter`,EXAM_TAKE:e=>`/student/exams/${e}/take`,RESULTS:"/student/results",RESULT_DETAIL:(e,s)=>s?`/student/results/${e}/review?token=${s}`:`/student/results/${e}/review`,PROFILE:"/student/profile"}};
+/**
+ * Application routes constants
+ */
+/**
+ * Route helper — identity function kept for backward compatibility.
+ * Previously converted paths to subdomain-aware URLs; now a no-op.
+ */
+export function r(path) {
+    return path;
+}
+export const ROUTES = {
+    // Auth routes
+    LOGIN: '/login',
+    LOGOUT: '/logout',
+    CHANGE_PASSWORD: '/change-password',
+    // System Admin routes
+    SYSTEM_ADMIN: {
+        DASHBOARD: '/system-admin/dashboard',
+        USERS: '/system-admin/users',
+        TAGS: '/system-admin/tags',
+        OEA_RESULTS: '/system-admin/oea-results',
+    },
+    // Manage routes (unified admin + teacher)
+    MANAGE: {
+        DASHBOARD: '/manage/contests',
+        USERS: '/manage/users',
+        USERS_CREATE: '/manage/users/create',
+        USERS_EDIT: (id) => `/manage/users/${id}/edit`,
+        QUESTION_BANK: '/manage/question-bank',
+        QUESTION_CREATE: '/manage/question-bank/create',
+        QUESTION_EDIT: (id) => `/manage/question-bank/${id}/edit`,
+        EXAMS: '/manage/exams',
+        EXAMS_CREATE: '/manage/exams/create',
+        EXAMS_EDIT: (id) => `/manage/exams/${id}/edit`,
+        EXAM_CLASSES: '/manage/exam-classes',
+        EXAM_CLASSES_CREATE: '/manage/exam-classes/create',
+        EXAM_SESSIONS: '/manage/exam-sessions',
+        EXAM_SESSIONS_CREATE: '/manage/exam-sessions/create',
+        EXAM_ROOMS: '/manage/exam-rooms',
+        EXAM_ROOMS_CREATE: '/manage/exam-rooms/create',
+        EXAM_ROOMS_DETAIL: (id) => `/manage/exam-rooms/${id}`,
+        TEMPLATES: '/manage/templates',
+        TEMPLATE_DETAIL: (id) => `/manage/templates/${id}`,
+        REPORTS: '/manage/reports',
+        REPORTS_ROOMS: '/manage/reports/rooms',
+        SETTINGS: '/manage/settings',
+        STUDENT_TEST_PARTICIPANTS: '/manage/students/test-participants',
+        USER_DETAIL: (id) => `/manage/users/${id}`,
+        ROLES: '/manage/roles',
+        ROLE_DETAIL: (id) => `/manage/roles/${id}`,
+        ROOMS: '/manage/rooms',
+        ROOM_DETAIL: (id) => `/manage/rooms/${id}`,
+        ROOM_MONITOR: (id) => `/manage/rooms/${id}/monitor`,
+    },
+    // Backward-compatible alias: ADMIN → MANAGE
+    // TODO: Remove after all frontend consumers are migrated to use MANAGE
+    get ADMIN() {
+        return this.MANAGE;
+    },
+    // Student routes
+    STUDENT: {
+        DASHBOARD: '/student/contests/discover',
+        // Contest routes
+        CONTESTS_DISCOVER: '/student/contests/discover',
+        CONTESTS_MY: '/student/contests/my-contests',
+        CONTEST_DETAIL: (id) => `/student/contests/${id}`,
+        CONTEST_ROOMS: (id) => `/student/contests/${id}/rooms`,
+        CONTEST_RESULTS: (id) => `/student/contests/${id}/results`,
+        CONTEST_HISTORY: (id) => `/student/contests/${id}/history`,
+        CONTEST_ROUNDS: (id) => `/student/contests/${id}/rounds`,
+        CONTEST_GALLERY: (id) => `/student/contests/${id}/gallery`,
+        CONTEST_DOCUMENTS: (id) => `/student/contests/${id}/documents`,
+        // Exam routes (fullscreen, accessed via contest rooms)
+        EXAM_ROOM: (id) => `/student/exams/${id}`,
+        EXAM_ENTER: (id) => `/student/exams/${id}/enter`,
+        EXAM_TAKE: (roomId) => `/student/exams/${roomId}/take`,
+        RESULTS: '/student/results',
+        RESULT_DETAIL: (id, token) => token ? `/student/results/${id}/review?token=${token}` : `/student/results/${id}/review`,
+        PROFILE: '/student/profile',
+    },
+};

package/dist/shared/index.js

@@ -1 +1,10 @@
-export*from"./constants/ApiConstant";export*from"./constants/QueryKeyConstant";export*from"./constants/exam-level.enum";export*from"./constants/routes";export*from"./lib/utils";export*from"../components/questions/_shared";export*from"./types";export*from"./lib/utils/question-transform";export*from"./lib/utils/question-reverse-transform";export*from"./lib/utils/question-transform-validation";
+export * from './constants/ApiConstant';
+export * from './constants/QueryKeyConstant';
+export * from './constants/exam-level.enum';
+export * from './constants/routes';
+export * from './lib/utils';
+export * from '../components/questions/_shared';
+export * from './types';
+export * from './lib/utils/question-transform';
+export * from './lib/utils/question-reverse-transform';
+export * from './lib/utils/question-transform-validation';

package/dist/shared/lib/hooks/index.js

@@ -1 +1,10 @@
-export{useAlertDialog}from"./useAlertDialog";export{useConfirmDialog}from"./useConfirmDialog";export{useToast}from"./useToast";export{usePresignedFileUrl}from"./usePresignedFileUrl";export{useAudioPreview}from"./useAudioPreview";export{useAudioPlayCounter}from"./useAudioPlayCounter";export{useAudioUpload}from"./useAudioUpload";export{useReactHookForm}from"./useReactHookForm";export{useDebouncedCallback}from"./useDebouncedCallback";export{useDelayedAutoPlay,DEFAULT_AUTO_PLAY_DELAY_MS}from"./useDelayedAutoPlay";
+export { useAlertDialog } from './useAlertDialog';
+export { useConfirmDialog } from './useConfirmDialog';
+export { useToast } from './useToast';
+export { usePresignedFileUrl } from './usePresignedFileUrl';
+export { useAudioPreview } from './useAudioPreview';
+export { useAudioPlayCounter } from './useAudioPlayCounter';
+export { useAudioUpload } from './useAudioUpload';
+export { useReactHookForm } from './useReactHookForm';
+export { useDebouncedCallback } from './useDebouncedCallback';
+export { useDelayedAutoPlay, DEFAULT_AUTO_PLAY_DELAY_MS } from './useDelayedAutoPlay';

package/dist/shared/lib/hooks/useAlertDialog.js

@@ -1 +1,57 @@
-"use client";import{useCallback as e,useState as i}from"react";const n={actionLabel:"OK",cancelLabel:"Cancel",isDestructive:!1,isLoading:!1};export function useAlertDialog(){const[s,o]=i({isOpen:!1,title:"",description:"",...n}),t=e(e=>{o(i=>({...i,...e,isOpen:!0,isLoading:!1}))},[]),c=e(()=>{o(e=>({...e,isOpen:!1}))},[]),a=e(e=>{o(i=>({...i,isLoading:e}))},[]);return{isOpen:s.isOpen,config:s,open:t,close:c,setLoading:a}}
+'use client';
+import { useCallback, useState } from 'react';
+const DEFAULT_CONFIG = {
+    actionLabel: 'OK',
+    cancelLabel: 'Cancel',
+    isDestructive: false,
+    isLoading: false,
+};
+/**
+ * Hook for managing AlertDialog state and callbacks
+ * Use this hook when you need a simple confirmation/alert dialog
+ *
+ * @example
+ * const { isOpen, config, open, close } = useAlertDialog();
+ *
+ * // To show a simple alert
+ * open({
+ *   title: 'Confirm Action',
+ *   description: 'Are you sure?',
+ *   onConfirm: () => console.log('Confirmed')
+ * });
+ */
+export function useAlertDialog() {
+    const [state, setState] = useState({
+        isOpen: false,
+        title: '',
+        description: '',
+        ...DEFAULT_CONFIG,
+    });
+    const open = useCallback((config) => {
+        setState((prev) => ({
+            ...prev,
+            ...config,
+            isOpen: true,
+            isLoading: false,
+        }));
+    }, []);
+    const close = useCallback(() => {
+        setState((prev) => ({
+            ...prev,
+            isOpen: false,
+        }));
+    }, []);
+    const setLoading = useCallback((isLoading) => {
+        setState((prev) => ({
+            ...prev,
+            isLoading,
+        }));
+    }, []);
+    return {
+        isOpen: state.isOpen,
+        config: state,
+        open,
+        close,
+        setLoading,
+    };
+}

package/dist/shared/lib/hooks/useAudioPlayCounter.js

@@ -1 +1,30 @@
-import{useEffect as r,useState as n}from"react";import{toast as t}from"sonner";import{t as e}from"../../lib/i18n";export function useAudioPlayCounter(o,i,a=!1){const[u,m]=n(0);return r(()=>{const r=o.current;if(!r)return;const n=()=>{if(u>=i&&!a)return r.pause(),void t.warning(e("student.audio.maxPlayReached",{maxPlayCount:String(i)}));a||m(r=>r+1)};return r.addEventListener("play",n),()=>{r.removeEventListener("play",n)}},[u,i,a,o]),{playCount:u}}
+import { useEffect, useState } from 'react';
+import { toast } from 'sonner';
+import { t } from '../../lib/i18n';
+/**
+ * Hook to track and limit audio play count
+ * Automatically pauses audio when max play count is reached
+ */
+export function useAudioPlayCounter(audioRef, maxPlayCount, isReviewMode = false) {
+    const [playCount, setPlayCount] = useState(0);
+    useEffect(() => {
+        const audio = audioRef.current;
+        if (!audio)
+            return;
+        const handlePlay = () => {
+            if (playCount >= maxPlayCount && !isReviewMode) {
+                audio.pause();
+                toast.warning(t('student.audio.maxPlayReached', { maxPlayCount: String(maxPlayCount) }));
+                return;
+            }
+            if (!isReviewMode) {
+                setPlayCount((prev) => prev + 1);
+            }
+        };
+        audio.addEventListener('play', handlePlay);
+        return () => {
+            audio.removeEventListener('play', handlePlay);
+        };
+    }, [playCount, maxPlayCount, isReviewMode, audioRef]);
+    return { playCount };
+}

package/dist/shared/lib/hooks/useAudioPreview.js

@@ -1 +1,81 @@
-import{useEffect as e,useRef as t,useState as r}from"react";export function useAudioPreview(n){const[a,u]=r(!1),[i,d]=r(0),[o,c]=r(0),s=t(null);e(()=>{if(!n)return s.current&&(s.current.pause(),s.current=null),u(!1),d(0),void c(0);const e=new Audio(n);s.current=e;const t=()=>d(e.currentTime),r=()=>c(e.duration),a=()=>{u(!1),d(0)};return e.addEventListener("timeupdate",t),e.addEventListener("loadedmetadata",r),e.addEventListener("ended",a),e.load(),()=>{e.removeEventListener("timeupdate",t),e.removeEventListener("loadedmetadata",r),e.removeEventListener("ended",a),e.pause(),s.current=null}},[n]);return{audioRef:s,isPlaying:a,currentTime:i,duration:o,progressPercentage:o>0?i/o*100:0,handlePlayPause:()=>{s.current&&(a?(s.current.pause(),u(!1)):(s.current.play(),u(!0)))},handleProgressClick:e=>{if(!s.current||!o)return;const t=e.currentTarget.getBoundingClientRect(),r=(e.clientX-t.left)/t.width*o;s.current.currentTime=r,d(r)},formatTime:e=>{if(isNaN(e))return"00:00";const t=Math.floor(e/60),r=Math.floor(e%60);return`${t.toString().padStart(2,"0")}:${r.toString().padStart(2,"0")}`}}}
+import { useEffect, useRef, useState } from 'react';
+/**
+ * Hook to manage audio preview player with play/pause and progress tracking
+ */
+export function useAudioPreview(audioUrl) {
+    const [isPlaying, setIsPlaying] = useState(false);
+    const [currentTime, setCurrentTime] = useState(0);
+    const [duration, setDuration] = useState(0);
+    const audioRef = useRef(null);
+    useEffect(() => {
+        if (!audioUrl) {
+            if (audioRef.current) {
+                audioRef.current.pause();
+                audioRef.current = null;
+            }
+            setIsPlaying(false);
+            setCurrentTime(0);
+            setDuration(0);
+            return;
+        }
+        const audio = new Audio(audioUrl);
+        audioRef.current = audio;
+        const handleTimeUpdate = () => setCurrentTime(audio.currentTime);
+        const handleLoadedMetadata = () => setDuration(audio.duration);
+        const handleEnded = () => {
+            setIsPlaying(false);
+            setCurrentTime(0);
+        };
+        audio.addEventListener('timeupdate', handleTimeUpdate);
+        audio.addEventListener('loadedmetadata', handleLoadedMetadata);
+        audio.addEventListener('ended', handleEnded);
+        audio.load();
+        return () => {
+            audio.removeEventListener('timeupdate', handleTimeUpdate);
+            audio.removeEventListener('loadedmetadata', handleLoadedMetadata);
+            audio.removeEventListener('ended', handleEnded);
+            audio.pause();
+            audioRef.current = null;
+        };
+    }, [audioUrl]);
+    const handlePlayPause = () => {
+        if (!audioRef.current)
+            return;
+        if (isPlaying) {
+            audioRef.current.pause();
+            setIsPlaying(false);
+        }
+        else {
+            audioRef.current.play();
+            setIsPlaying(true);
+        }
+    };
+    const formatTime = (seconds) => {
+        if (isNaN(seconds))
+            return '00:00';
+        const mins = Math.floor(seconds / 60);
+        const secs = Math.floor(seconds % 60);
+        return `${mins.toString().padStart(2, '0')}:${secs.toString().padStart(2, '0')}`;
+    };
+    const handleProgressClick = (e) => {
+        if (!audioRef.current || !duration)
+            return;
+        const rect = e.currentTarget.getBoundingClientRect();
+        const x = e.clientX - rect.left;
+        const percentage = x / rect.width;
+        const newTime = percentage * duration;
+        audioRef.current.currentTime = newTime;
+        setCurrentTime(newTime);
+    };
+    const progressPercentage = duration > 0 ? (currentTime / duration) * 100 : 0;
+    return {
+        audioRef,
+        isPlaying,
+        currentTime,
+        duration,
+        progressPercentage,
+        handlePlayPause,
+        handleProgressClick,
+        formatTime,
+    };
+}

package/dist/shared/lib/hooks/useAudioUpload.js

@@ -1 +1,24 @@
-import{useState as r,useCallback as o}from"react";export function useAudioUpload(n){const[e,t]=r(!1),[l,c]=r(null),u=o(async r=>{t(!0),c(null);try{const o=URL.createObjectURL(r);return n.onSuccess?.(o,o),{key:o,presignedUrl:o}}catch(r){const o=r instanceof Error?r:new Error("Upload audio failed");return c(o),n.onError?.(o),null}finally{t(!1)}},[n]);return{uploadAudio:u,isUploading:e,error:l}}
+import { useState, useCallback } from 'react';
+export function useAudioUpload(options) {
+    const [isUploading, setIsUploading] = useState(false);
+    const [error, setError] = useState(null);
+    const uploadAudio = useCallback(async (file) => {
+        setIsUploading(true);
+        setError(null);
+        try {
+            const url = URL.createObjectURL(file);
+            options.onSuccess?.(url, url);
+            return { key: url, presignedUrl: url };
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error('Upload audio failed');
+            setError(error);
+            options.onError?.(error);
+            return null;
+        }
+        finally {
+            setIsUploading(false);
+        }
+    }, [options]);
+    return { uploadAudio, isUploading, error };
+}