@tinyweb_dev/oe-exam-sdk 0.1.28 → 0.1.30

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

@@ -1 +1,194 @@
-const n=n=>"string"==typeof n&&n.trim().length>0,t=n=>Array.isArray(n)&&n.length>0,e=n=>"object"==typeof n&&null!==n&&!Array.isArray(n),s=n=>e(n)?n:void 0,u=n=>"number"==typeof n&&Number.isFinite(n)&&n>0;export function validateQuestionForTransform(r){const h=[];r.type||h.push("Question type is required");const o=s(r.answer),p=s(r.content);switch(r.type){case"FILL_MISSING_WORDS_IN_GRID":!function(n,t,s){Array.isArray(n?.grid)||s.push("Grid is required for FILL_MISSING_WORDS_IN_GRID");u(n?.rows)||s.push("Rows must be at least 1");u(n?.columns)||s.push("Columns must be at least 1");i=t?.answers,e(i)&&Object.keys(i).length>0||s.push("At least one missing letter is required");var i}(p,o,h);break;case"LOOK_PICTURE_FILL_BLANK_CHOOSE_ANSWER":!function(t,e){n(t?.imageUrl)||e.push("Vui lòng upload hình ảnh");n(t?.question)||e.push("Vui lòng nhập nội dung câu hỏi");i(t?.options,e),(void 0===t?.correctAnswer||-1===t.correctAnswer)&&e.push("Vui lòng chọn đáp án đúng")}(o,h);break;case"LOOK_PICTURE_CHOOSE_CORRECT_ANSWER":!function(t,e){n(t?.imageUrl)||e.push("Vui lòng upload hình ảnh");i(t?.options,e),("number"!=typeof t?.correctAnswer||t.correctAnswer<0)&&e.push("Vui lòng chọn đáp án đúng")}(o,h);break;case"LOOK_PICTURE_FILL_WORD_HINT":!function(e,u){if(!t(e?.subQuestions))return void u.push("Vui lòng nhập dữ liệu câu hỏi");e.subQuestions.forEach(t=>{const e=s(t);n(e?.imageUrl)||u.push("Vui lòng upload hình ảnh"),n(e?.word)||u.push("Vui lòng nhập từ có chỗ trống"),n(e?.correctAnswer)||u.push("Vui lòng nhập đáp án đúng")})}(o,h);break;case"LABEL_THE_PICTURE":!function(e,s){n(e?.imageUrl)||s.push("Vui lòng upload hình ảnh");t(e?.labels)||s.push("Vui lòng thêm ít nhất một vị trí cần điền")}(o,h);break;case"READ_AND_COLOR_OBJECTS":case"IMAGE_OBJECT_MATCHING":!function(e,s){n(e?.backgroundImageUrl)||s.push("Vui lòng upload ảnh nền");t(e?.colorNodes)||s.push("Vui lòng thêm ít nhất một màu");t(e?.regionNodes)||s.push("Vui lòng thêm ít nhất một vùng tô màu")}(o,h);break;case"READ_PASSAGE_AND_ANSWER_QUESTIONS":!function(t,e){n(t?.passage)||e.push("Vui lòng nhập nội dung đoạn văn");const u=s(t?.singleQuestion);if(!u)return void e.push("Vui lòng nhập dữ liệu câu hỏi");n(u.question)||e.push("Vui lòng nhập câu hỏi");i(u.options,e),("number"!=typeof u.correctAnswer||u.correctAnswer<0)&&e.push("Vui lòng chọn đáp án đúng")}(o,h);break;case"CHOOSE_CORRECT_ADJECTIVE":!function(t,e,s){n(t?.sentence)||s.push("Vui lòng nhập câu hỏi");i(t?.options,s),("number"!=typeof e?.answer||e.answer<0)&&s.push("Vui lòng chọn đáp án đúng")}(p,o,h);break;case"ANSWER_THE_QUESTION":!function(t,e){n(t?.question)||e.push("Vui lòng nhập câu hỏi");n(t?.correctAnswer)||e.push("Vui lòng nhập đáp án")}(o,h);break;case"WORD_ORDERING":!function(n,e){(!t(n?.words)||n.words.length<2)&&e.push("Cần ít nhất 2 từ/chữ cái");(!t(n?.answer)||n.answer.length<2)&&e.push("Cần ít nhất 2 từ/chữ cái trong đáp án")}(o,h);break;case"WORD_FILL_PARAGRAPH":!function(e,s){n(e?.paragraph)||s.push("Vui lòng nhập đoạn văn");"DEFAULT"===e?.viewMode||"EMAIL"===e?.viewMode||t(e?.wordBank)||s.push("Cần ít nhất 1 chỗ trống");t(e?.answers)||s.push("Cần ít nhất 1 đáp án")}(o,h);break;case"LISTEN_AND_CHOOSE_FROM_ANSWER_GROUP":!function(e,s){(!t(e?.options)||e.options.length<2)&&s.push("Cần tối thiểu 2 đáp án trong nhóm");n(e?.audioUrl)||s.push("Phải có file audio");n(e?.correctAnswer)||s.push("Phải chọn đáp án đúng")}(o,h);break;case"LISTEN_AND_SPEAK_QUESTION_LIST":!function(e,s){n(e?.audioUrl)||s.push("Vui lòng tải lên file âm thanh");n(e?.activeQuestionId)||s.push("Vui lòng chọn câu hỏi");t(e?.expectedAnswers)||s.push("Cần ít nhất 1 đáp án mong muốn")}(o,h);break;case"WRITE_A_SHORT_LETTER":!function(n,t){u(n?.minWords)||t.push("Số từ tối thiểu phải >= 1");"number"==typeof n?.maxWords&&"number"==typeof n.minWords&&n.maxWords<n.minWords&&t.push("Số từ tối đa phải >= số từ tối thiểu")}(o,h)}return{isValid:0===h.length,errors:h}}function i(e,u){if(!t(e)||e.length<2)return void u.push("Phải có ít nhất 2 lựa chọn");e.filter(t=>{const e="string"==typeof t?t:s(t)?.text;return n(e)}).length<2&&u.push("Phải có ít nhất 2 đáp án được điền")}
+const hasText = (value) => typeof value === 'string' && value.trim().length > 0;
+const hasItems = (value) => Array.isArray(value) && value.length > 0;
+const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+const asRecord = (value) => isRecord(value) ? value : undefined;
+const asPositiveNumber = (value) => typeof value === 'number' && Number.isFinite(value) && value > 0;
+export function validateQuestionForTransform(question) {
+    const errors = [];
+    if (!question.type) {
+        errors.push('Question type is required');
+    }
+    const answer = asRecord(question.answer);
+    const content = asRecord(question.content);
+    switch (question.type) {
+        case 'FILL_MISSING_WORDS_IN_GRID':
+            validateGrid(content, answer, errors);
+            break;
+        case 'LOOK_PICTURE_FILL_BLANK_CHOOSE_ANSWER':
+            validatePictureFillBlank(answer, errors);
+            break;
+        case 'LOOK_PICTURE_CHOOSE_CORRECT_ANSWER':
+            validatePictureChoose(answer, errors);
+            break;
+        case 'LOOK_PICTURE_FILL_WORD_HINT':
+            validateWordHint(answer, errors);
+            break;
+        case 'LABEL_THE_PICTURE':
+            validateLabelPicture(answer, errors);
+            break;
+        case 'READ_AND_COLOR_OBJECTS':
+        case 'IMAGE_OBJECT_MATCHING':
+            validateColoring(answer, errors);
+            break;
+        case 'READ_PASSAGE_AND_ANSWER_QUESTIONS':
+            validateReadingPassage(answer, errors);
+            break;
+        case 'CHOOSE_CORRECT_ADJECTIVE':
+            validateChooseAdjective(content, answer, errors);
+            break;
+        case 'ANSWER_THE_QUESTION':
+            validateAnswerTheQuestion(answer, errors);
+            break;
+        case 'WORD_ORDERING':
+            validateWordOrdering(answer, errors);
+            break;
+        case 'WORD_FILL_PARAGRAPH':
+            validateWordFillParagraph(answer, errors);
+            break;
+        case 'LISTEN_AND_CHOOSE_FROM_ANSWER_GROUP':
+            validateListenChooseAnswerGroup(answer, errors);
+            break;
+        case 'LISTEN_AND_SPEAK_QUESTION_LIST':
+            validateListenSpeakQuestionList(answer, errors);
+            break;
+        case 'WRITE_A_SHORT_LETTER':
+            validateWordLimits(answer, errors);
+            break;
+        default:
+            break;
+    }
+    return { isValid: errors.length === 0, errors };
+}
+function validateGrid(content, answer, errors) {
+    if (!Array.isArray(content?.grid))
+        errors.push('Grid is required for FILL_MISSING_WORDS_IN_GRID');
+    if (!asPositiveNumber(content?.rows))
+        errors.push('Rows must be at least 1');
+    if (!asPositiveNumber(content?.columns))
+        errors.push('Columns must be at least 1');
+    if (!isNonEmptyRecord(answer?.answers))
+        errors.push('At least one missing letter is required');
+}
+function validatePictureFillBlank(answer, errors) {
+    if (!hasText(answer?.imageUrl))
+        errors.push('Vui lòng upload hình ảnh');
+    if (!hasText(answer?.question))
+        errors.push('Vui lòng nhập nội dung câu hỏi');
+    validateOptions(answer?.options, errors);
+    if (answer?.correctAnswer === undefined || answer.correctAnswer === -1)
+        errors.push('Vui lòng chọn đáp án đúng');
+}
+function validatePictureChoose(answer, errors) {
+    if (!hasText(answer?.imageUrl))
+        errors.push('Vui lòng upload hình ảnh');
+    validateOptions(answer?.options, errors);
+    if (typeof answer?.correctAnswer !== 'number' || answer.correctAnswer < 0)
+        errors.push('Vui lòng chọn đáp án đúng');
+}
+function validateWordHint(answer, errors) {
+    if (!hasItems(answer?.subQuestions)) {
+        errors.push('Vui lòng nhập dữ liệu câu hỏi');
+        return;
+    }
+    answer.subQuestions.forEach((rawSubQuestion) => {
+        const subQuestion = asRecord(rawSubQuestion);
+        if (!hasText(subQuestion?.imageUrl))
+            errors.push('Vui lòng upload hình ảnh');
+        if (!hasText(subQuestion?.word))
+            errors.push('Vui lòng nhập từ có chỗ trống');
+        if (!hasText(subQuestion?.correctAnswer))
+            errors.push('Vui lòng nhập đáp án đúng');
+    });
+}
+function validateLabelPicture(answer, errors) {
+    if (!hasText(answer?.imageUrl))
+        errors.push('Vui lòng upload hình ảnh');
+    if (!hasItems(answer?.labels))
+        errors.push('Vui lòng thêm ít nhất một vị trí cần điền');
+}
+function validateColoring(answer, errors) {
+    if (!hasText(answer?.backgroundImageUrl))
+        errors.push('Vui lòng upload ảnh nền');
+    if (!hasItems(answer?.colorNodes))
+        errors.push('Vui lòng thêm ít nhất một màu');
+    if (!hasItems(answer?.regionNodes))
+        errors.push('Vui lòng thêm ít nhất một vùng tô màu');
+}
+function validateReadingPassage(answer, errors) {
+    if (!hasText(answer?.passage))
+        errors.push('Vui lòng nhập nội dung đoạn văn');
+    const singleQuestion = asRecord(answer?.singleQuestion);
+    if (!singleQuestion) {
+        errors.push('Vui lòng nhập dữ liệu câu hỏi');
+        return;
+    }
+    if (!hasText(singleQuestion.question))
+        errors.push('Vui lòng nhập câu hỏi');
+    validateOptions(singleQuestion.options, errors);
+    if (typeof singleQuestion.correctAnswer !== 'number' || singleQuestion.correctAnswer < 0)
+        errors.push('Vui lòng chọn đáp án đúng');
+}
+function validateChooseAdjective(content, answer, errors) {
+    if (!hasText(content?.sentence))
+        errors.push('Vui lòng nhập câu hỏi');
+    validateOptions(content?.options, errors);
+    if (typeof answer?.answer !== 'number' || answer.answer < 0)
+        errors.push('Vui lòng chọn đáp án đúng');
+}
+function validateAnswerTheQuestion(answer, errors) {
+    if (!hasText(answer?.question))
+        errors.push('Vui lòng nhập câu hỏi');
+    if (!hasText(answer?.correctAnswer))
+        errors.push('Vui lòng nhập đáp án');
+}
+function validateWordOrdering(answer, errors) {
+    if (!hasItems(answer?.words) || answer.words.length < 2)
+        errors.push('Cần ít nhất 2 từ/chữ cái');
+    if (!hasItems(answer?.answer) || answer.answer.length < 2)
+        errors.push('Cần ít nhất 2 từ/chữ cái trong đáp án');
+}
+function validateWordFillParagraph(answer, errors) {
+    if (!hasText(answer?.paragraph))
+        errors.push('Vui lòng nhập đoạn văn');
+    if (answer?.viewMode !== 'DEFAULT' && answer?.viewMode !== 'EMAIL' && !hasItems(answer?.wordBank))
+        errors.push('Cần ít nhất 1 chỗ trống');
+    if (!hasItems(answer?.answers))
+        errors.push('Cần ít nhất 1 đáp án');
+}
+function validateListenChooseAnswerGroup(answer, errors) {
+    if (!hasItems(answer?.options) || answer.options.length < 2)
+        errors.push('Cần tối thiểu 2 đáp án trong nhóm');
+    if (!hasText(answer?.audioUrl))
+        errors.push('Phải có file audio');
+    if (!hasText(answer?.correctAnswer))
+        errors.push('Phải chọn đáp án đúng');
+}
+function validateListenSpeakQuestionList(answer, errors) {
+    if (!hasText(answer?.audioUrl))
+        errors.push('Vui lòng tải lên file âm thanh');
+    if (!hasText(answer?.activeQuestionId))
+        errors.push('Vui lòng chọn câu hỏi');
+    if (!hasItems(answer?.expectedAnswers))
+        errors.push('Cần ít nhất 1 đáp án mong muốn');
+}
+function validateWordLimits(answer, errors) {
+    if (!asPositiveNumber(answer?.minWords))
+        errors.push('Số từ tối thiểu phải >= 1');
+    if (typeof answer?.maxWords === 'number' && typeof answer.minWords === 'number' && answer.maxWords < answer.minWords)
+        errors.push('Số từ tối đa phải >= số từ tối thiểu');
+}
+function validateOptions(options, errors) {
+    if (!hasItems(options) || options.length < 2) {
+        errors.push('Phải có ít nhất 2 lựa chọn');
+        return;
+    }
+    const filledOptions = options.filter((option) => {
+        const text = typeof option === 'string' ? option : asRecord(option)?.text;
+        return hasText(text);
+    });
+    if (filledOptions.length < 2)
+        errors.push('Phải có ít nhất 2 đáp án được điền');
+}
+function isNonEmptyRecord(value) {
+    return isRecord(value) && Object.keys(value).length > 0;
+}

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

@@ -1 +1,199 @@
-import{validateQuestionForTransform as o}from"./question-transform-validation";import{transformLookPictureChooseCorrectAnswer as t}from"../../../components/questions/types/look-picture-choose-correct-answer/transform";import{transformLookPictureFillBlankChooseAnswer as s}from"../../../components/questions/types/look-picture-fill-blank-choose-answer/transform";import{transformLookPictureFillWordHint as e}from"../../../components/questions/types/look-picture-fill-word-hint/transform";import{transformReadAndColorObjects as n}from"../../../components/questions/types/read-and-color-objects/transform";import{transformReadPassageAndAnswerQuestions as r}from"../../../components/questions/types/read-passage-and-answer-questions/transform";import{transformArrangeLettersIntoWords as a}from"../../../components/questions/types/arrange-letters-into-words/transform";import{transformWriteShortParagraph as i}from"../../../components/questions/types/write-short-paragraph/transform";import{transformWriteAShortLetter as p}from"../../../components/questions/types/write-a-short-letter/transform";import{transformFillMissingWordsInGrid as m}from"../../../components/questions/types/fill-missing-words-in-grid/transform";import{transformLabelThePicture as u}from"../../../components/questions/types/label-the-picture/transform";import{transformChooseTheCorrectAnswer as c}from"../../../components/questions/types/choose-the-correct-answer/transform";import{transformChooseTheCorrectAnswerGroup as _}from"../../../components/questions/types/choose-the-correct-answer-group/transform";import{transformCrossOutWordGroup as E}from"../../../components/questions/types/cross-out-word-group/transform";import{transformFillInBlank as f}from"../../../components/questions/types/fill-in-blank/transform";import{transformWriteCorrectVerbForm as N}from"../../../components/questions/types/write-correct-verb-form/transform";import{transformChooseCorrectAdjective as A}from"../../../components/questions/types/choose-correct-adjective/transform";import{transformAnswerTheQuestion as I}from"../../../components/questions/types/answer-the-question/transform";import{transformTrueFalse as T}from"../../../components/questions/types/true-false/transform";import{transformWordOrdering as d}from"../../../components/questions/types/word-ordering/transform";import{transformWordFillParagraph as R}from"../../../components/questions/types/word-fill-paragraph/transform";import{transformMatchByWritingAnswer as S}from"../../../components/questions/types/match-by-writing-answer/transform";import{transformWriteSentences as l}from"../../../components/questions/types/write-sentences/transform";import{transformListenAndChooseFromAnswerGroup as O}from"../../../components/questions/types/listen-and-choose-from-answer-group/transform";import{transformListenAndChooseObjectsInScene as q}from"../../../components/questions/types/listen-and-choose-objects-in-scene/transform";import{transformListenAndDragObjectsIntoScene as D}from"../../../components/questions/types/listen-and-drag-objects-into-scene/transform";import{transformListenAndSpeakAnswer as C}from"../../../components/questions/types/listen-and-speak-answer/transform";import{transformListenAndSpeakImageGroup as y}from"../../../components/questions/types/listen-and-speak-image-group/transform";import{transformListenAndSpeakQuestionList as L}from"../../../components/questions/types/listen-and-speak-question-list/transform";import{transformListenAndSpeakCompareImages as G}from"../../../components/questions/types/listen-and-speak-compare-images/transform";import{transformListenAndSpeakOddOneOut as g}from"../../../components/questions/types/listen-and-speak-odd-one-out/transform";import{transformListenAndSpeakWithStoryImages as w}from"../../../components/questions/types/listen-and-speak-with-story-images/transform";import{transformListenAndSpeakInfoExchange as h}from"../../../components/questions/types/listen-and-speak-info-exchange/transform";import{transformSpeakingDescribeImage as k}from"../../../components/questions/types/speaking-describe-image/transform";import{transformReadDisplayedContent as P}from"../../../components/questions/types/read-displayed-content/transform";import{transformSpontaneousQA as b}from"../../../components/questions/types/spontaneous-qa/transform";import{transformSpeakingConversation as W}from"../../../components/questions/types/speaking-conversation/transform";import{transformSpeakingCueCard as B}from"../../../components/questions/types/speaking-cue-card/transform";import{transformGNSpeakingInterview as H}from"../../../components/questions/types/gn-speaking-interview/transform";import{transformWordFillStructuredForm as U}from"../../../components/questions/types/word-fill-structured-form/transform";const v={LOOK_PICTURE_CHOOSE_CORRECT_ANSWER:t,LOOK_PICTURE_FILL_BLANK_CHOOSE_ANSWER:s,LOOK_PICTURE_FILL_WORD_HINT:e,READ_AND_COLOR_OBJECTS:n,IMAGE_OBJECT_MATCHING:n,READ_PASSAGE_AND_ANSWER_QUESTIONS:r,ARRANGE_LETTERS_INTO_WORDS:a,WRITE_SHORT_PARAGRAPH:i,WRITE_A_SHORT_LETTER:p,FILL_MISSING_WORDS_IN_GRID:m,LABEL_THE_PICTURE:u,CHOOSE_THE_CORRECT_ANSWER:c,CHOOSE_THE_CORRECT_ANSWER_GROUP:_,CROSS_OUT_WORD_GROUP:E,FILL_IN_BLANK:f,WRITE_CORRECT_VERB_FORM:N,CHOOSE_CORRECT_ADJECTIVE:A,ANSWER_THE_QUESTION:I,TRUE_FALSE:T,WORD_ORDERING:d,WORD_FILL_PARAGRAPH:R,MATCH_BY_WRITING_ANSWER:S,WRITE_SENTENCES:l,LISTEN_AND_CHOOSE_FROM_ANSWER_GROUP:O,LISTEN_AND_CHOOSE_OBJECTS_IN_SCENE:q,LISTEN_AND_DRAG_OBJECTS_INTO_SCENE:D,LISTEN_AND_SPEAK_ANSWER:C,LISTEN_AND_SPEAK_IMAGE_GROUP:y,LISTEN_AND_SPEAK_QUESTION_LIST:L,LISTEN_AND_SPEAK_COMPARE_IMAGES:G,LISTEN_AND_SPEAK_ODD_ONE_OUT:g,LISTEN_AND_SPEAK_WITH_STORY_IMAGES:w,LISTEN_AND_SPEAK_INFO_EXCHANGE:h,SPEAKING_DESCRIBE_IMAGE:k,READ_DISPLAYED_CONTENT:P,SPONTANEOUS_QA:b,SPEAKING_CONVERSATION:W,SPEAKING_CUE_CARD:B,GN_SPEAKING_INTERVIEW:H,WORD_FILL_STRUCTURED_FORM:U};export function transformQuestionToApiFormat(o,t={}){const{partId:s,partNo:e,questionNumber:n,addToQuestionBank:r,questionBankCode:a,questionBankTitle:i,sectionId:p,examLevel:m,subjectId:u}=t,{id:c,type:_,points:E,explanation:f}=o,N=_?v[_]:void 0,A=N?N(o):{apiContent:{},apiCorrectAnswer:{}},{apiContent:I,apiCorrectAnswer:T,totalPoints:d,hintLetters:R,groupNumber:S,passageData:l,imageData:O,basicGroupData:q,questionListGroupData:D,sceneData:C,answerGroupData:y,compareImagesGroupData:L,infoExchangeGroupData:G,conversationGroupData:g,isExample:w,suggestedAnswers:h}=A,k=o.answer,P=o.content,b={id:c,questionType:_||"",content:I,correctAnswer:T||{},points:d??E??1,explanation:A.explanation||f||k?.explanation||P?.explanation||"",questionNumber:n,partId:s,partNo:e,...null!=p?{sectionId:p}:{},questionSkillType:o.skill,examLevel:m,subjectId:u,addToQuestionBank:r??!1,questionBank:r&&a&&i?{code:a,title:i}:void 0,isExample:w||!1};h&&h.length>0&&(b.suggestedAnswers=h);const W=function(o){const{hintLetters:t,passageData:s,imageData:e,basicGroupData:n,sceneData:r,answerGroupData:a,questionListGroupData:i,compareImagesGroupData:p,infoExchangeGroupData:m,conversationGroupData:u}=o;if(t&&t.length>0)return{hintLetters:t};if(s)return s;if(e)return e;if(n&&(n.title||n.subtitle||n.content||n.imageUrl||n.articles))return n;return r||(a||(i||(p||(m||(u||void 0)))))}({hintLetters:R,passageData:l,imageData:O,basicGroupData:q,sceneData:C,answerGroupData:y,questionListGroupData:D,compareImagesGroupData:L,infoExchangeGroupData:G,conversationGroupData:g});return W&&(b.isGroup=!0,b.questionGroup={payload:W,groupNumber:S||1}),b}export function transformQuestionsToApiFormat(t){const s=[],e=[];return t.forEach((t,n)=>{const{question:r,partId:a,partNo:i,sectionId:p,addToQuestionBank:m,questionBankCode:u,questionBankTitle:c,examLevel:_,subjectId:E}=t,f=o(r);if(!f.isValid)return void e.push({index:n,errors:f.errors});const N=r.questionNumber??n+1;s.push(transformQuestionToApiFormat(r,{partId:a,partNo:i,questionNumber:N,addToQuestionBank:m,questionBankCode:u,questionBankTitle:c,sectionId:p,examLevel:_,subjectId:E}))}),{validQuestions:s,invalidQuestions:e}}
+import { validateQuestionForTransform } from './question-transform-validation';
+// ─── Import transforms từ từng question type ────────────────────────────────
+import { transformLookPictureChooseCorrectAnswer } from '../../../components/questions/types/look-picture-choose-correct-answer/transform';
+import { transformLookPictureFillBlankChooseAnswer } from '../../../components/questions/types/look-picture-fill-blank-choose-answer/transform';
+import { transformLookPictureFillWordHint } from '../../../components/questions/types/look-picture-fill-word-hint/transform';
+import { transformReadAndColorObjects } from '../../../components/questions/types/read-and-color-objects/transform';
+import { transformReadPassageAndAnswerQuestions } from '../../../components/questions/types/read-passage-and-answer-questions/transform';
+import { transformArrangeLettersIntoWords } from '../../../components/questions/types/arrange-letters-into-words/transform';
+import { transformWriteShortParagraph } from '../../../components/questions/types/write-short-paragraph/transform';
+import { transformWriteAShortLetter } from '../../../components/questions/types/write-a-short-letter/transform';
+import { transformFillMissingWordsInGrid } from '../../../components/questions/types/fill-missing-words-in-grid/transform';
+import { transformLabelThePicture } from '../../../components/questions/types/label-the-picture/transform';
+import { transformChooseTheCorrectAnswer } from '../../../components/questions/types/choose-the-correct-answer/transform';
+import { transformChooseTheCorrectAnswerGroup } from '../../../components/questions/types/choose-the-correct-answer-group/transform';
+import { transformCrossOutWordGroup } from '../../../components/questions/types/cross-out-word-group/transform';
+import { transformFillInBlank } from '../../../components/questions/types/fill-in-blank/transform';
+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 { 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';
+import { transformMatchByWritingAnswer } from '../../../components/questions/types/match-by-writing-answer/transform';
+import { transformWriteSentences } from '../../../components/questions/types/write-sentences/transform';
+import { transformListenAndChooseFromAnswerGroup } from '../../../components/questions/types/listen-and-choose-from-answer-group/transform';
+import { transformListenAndChooseObjectsInScene } from '../../../components/questions/types/listen-and-choose-objects-in-scene/transform';
+import { transformListenAndDragObjectsIntoScene } from '../../../components/questions/types/listen-and-drag-objects-into-scene/transform';
+import { transformListenAndSpeakAnswer } from '../../../components/questions/types/listen-and-speak-answer/transform';
+import { transformListenAndSpeakImageGroup } from '../../../components/questions/types/listen-and-speak-image-group/transform';
+import { transformListenAndSpeakQuestionList } from '../../../components/questions/types/listen-and-speak-question-list/transform';
+import { transformListenAndSpeakCompareImages } from '../../../components/questions/types/listen-and-speak-compare-images/transform';
+import { transformListenAndSpeakOddOneOut } from '../../../components/questions/types/listen-and-speak-odd-one-out/transform';
+import { transformListenAndSpeakWithStoryImages } from '../../../components/questions/types/listen-and-speak-with-story-images/transform';
+import { transformListenAndSpeakInfoExchange } from '../../../components/questions/types/listen-and-speak-info-exchange/transform';
+import { transformSpeakingDescribeImage } from '../../../components/questions/types/speaking-describe-image/transform';
+import { transformReadDisplayedContent } from '../../../components/questions/types/read-displayed-content/transform';
+import { transformSpontaneousQA } from '../../../components/questions/types/spontaneous-qa/transform';
+import { transformSpontaneousQaGroup } from '../../../components/questions/types/spontaneous-qa-group/transform';
+import { transformSpeakingConversation } from '../../../components/questions/types/speaking-conversation/transform';
+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';
+// ─── Handler map ────────────────────────────────────────────────────────────
+const questionTransformHandlers = {
+    // Look picture
+    LOOK_PICTURE_CHOOSE_CORRECT_ANSWER: transformLookPictureChooseCorrectAnswer,
+    LOOK_PICTURE_FILL_BLANK_CHOOSE_ANSWER: transformLookPictureFillBlankChooseAnswer,
+    LOOK_PICTURE_FILL_WORD_HINT: transformLookPictureFillWordHint,
+    // Reading
+    READ_AND_COLOR_OBJECTS: transformReadAndColorObjects,
+    IMAGE_OBJECT_MATCHING: transformReadAndColorObjects,
+    READ_PASSAGE_AND_ANSWER_QUESTIONS: transformReadPassageAndAnswerQuestions,
+    // Fill / Write / General
+    ARRANGE_LETTERS_INTO_WORDS: transformArrangeLettersIntoWords,
+    WRITE_SHORT_PARAGRAPH: transformWriteShortParagraph,
+    WRITE_A_SHORT_LETTER: transformWriteAShortLetter,
+    FILL_MISSING_WORDS_IN_GRID: transformFillMissingWordsInGrid,
+    LABEL_THE_PICTURE: transformLabelThePicture,
+    CHOOSE_THE_CORRECT_ANSWER: transformChooseTheCorrectAnswer,
+    CHOOSE_THE_CORRECT_ANSWER_GROUP: transformChooseTheCorrectAnswerGroup,
+    CROSS_OUT_WORD_GROUP: transformCrossOutWordGroup,
+    FILL_IN_BLANK: transformFillInBlank,
+    WRITE_CORRECT_VERB_FORM: transformWriteCorrectVerbForm,
+    CHOOSE_CORRECT_ADJECTIVE: transformChooseCorrectAdjective,
+    ANSWER_THE_QUESTION: transformAnswerTheQuestion,
+    TRUE_FALSE: transformTrueFalse,
+    WORD_ORDERING: transformWordOrdering,
+    WORD_FILL_PARAGRAPH: transformWordFillParagraph,
+    MATCH_BY_WRITING_ANSWER: transformMatchByWritingAnswer,
+    WRITE_SENTENCES: transformWriteSentences,
+    LISTEN_AND_CHOOSE_FROM_ANSWER_GROUP: transformListenAndChooseFromAnswerGroup,
+    LISTEN_AND_CHOOSE_OBJECTS_IN_SCENE: transformListenAndChooseObjectsInScene,
+    LISTEN_AND_DRAG_OBJECTS_INTO_SCENE: transformListenAndDragObjectsIntoScene,
+    LISTEN_AND_SPEAK_ANSWER: transformListenAndSpeakAnswer,
+    LISTEN_AND_SPEAK_IMAGE_GROUP: transformListenAndSpeakImageGroup,
+    LISTEN_AND_SPEAK_QUESTION_LIST: transformListenAndSpeakQuestionList,
+    LISTEN_AND_SPEAK_COMPARE_IMAGES: transformListenAndSpeakCompareImages,
+    LISTEN_AND_SPEAK_ODD_ONE_OUT: transformListenAndSpeakOddOneOut,
+    LISTEN_AND_SPEAK_WITH_STORY_IMAGES: transformListenAndSpeakWithStoryImages,
+    LISTEN_AND_SPEAK_INFO_EXCHANGE: transformListenAndSpeakInfoExchange,
+    SPEAKING_DESCRIBE_IMAGE: transformSpeakingDescribeImage,
+    READ_DISPLAYED_CONTENT: transformReadDisplayedContent,
+    SPONTANEOUS_QA: transformSpontaneousQA,
+    SPONTANEOUS_QA_GROUP: transformSpontaneousQaGroup,
+    SPEAKING_CONVERSATION: transformSpeakingConversation,
+    SPEAKING_CUE_CARD: transformSpeakingCueCard,
+    GN_SPEAKING_INTERVIEW: transformGNSpeakingInterview,
+    WORD_FILL_STRUCTURED_FORM: transformWordFillStructuredForm,
+};
+/**
+ * Transform frontend question format to API format.
+ * API expects camelCase: questionType, content, correctAnswer, points, explanation, questionNumber.
+ */
+export function transformQuestionToApiFormat(question, options = {}) {
+    const { partId, partNo, questionNumber, addToQuestionBank, questionBankCode, questionBankTitle, sectionId, examLevel, subjectId } = options;
+    const { id, type, points, explanation } = question;
+    const handler = type ? questionTransformHandlers[type] : undefined;
+    const handlerResult = handler ? handler(question) : { apiContent: {}, apiCorrectAnswer: {} };
+    const { apiContent, apiCorrectAnswer, totalPoints, hintLetters, groupNumber, passageData, imageData, basicGroupData, questionListGroupData, sceneData, answerGroupData, compareImagesGroupData, infoExchangeGroupData, conversationGroupData, isExample, suggestedAnswers, } = handlerResult;
+    const answerData = question.answer;
+    const contentData = question.content;
+    const handlerExplanation = handlerResult.explanation;
+    const finalExplanation = handlerExplanation || explanation || answerData?.explanation || contentData?.explanation || '';
+    const finalPoints = totalPoints ?? points ?? 1;
+    const payload = {
+        id,
+        questionType: type || '',
+        content: apiContent,
+        correctAnswer: apiCorrectAnswer || {},
+        points: finalPoints,
+        explanation: finalExplanation,
+        questionNumber,
+        partId,
+        partNo,
+        ...(sectionId != null ? { sectionId } : {}),
+        questionSkillType: question.skill,
+        examLevel,
+        subjectId,
+        addToQuestionBank: addToQuestionBank ?? false,
+        questionBank: addToQuestionBank && questionBankCode && questionBankTitle
+            ? { code: questionBankCode, title: questionBankTitle }
+            : undefined,
+        isExample: isExample || false,
+    };
+    if (suggestedAnswers && suggestedAnswers.length > 0) {
+        payload.suggestedAnswers = suggestedAnswers;
+    }
+    const groupPayload = resolveQuestionGroupPayload({
+        hintLetters,
+        passageData,
+        imageData,
+        basicGroupData,
+        sceneData,
+        answerGroupData,
+        questionListGroupData,
+        compareImagesGroupData,
+        infoExchangeGroupData,
+        conversationGroupData,
+    });
+    if (groupPayload) {
+        payload.isGroup = true;
+        payload.questionGroup = { payload: groupPayload, groupNumber: groupNumber || 1 };
+    }
+    return payload;
+}
+function resolveQuestionGroupPayload(sources) {
+    const { hintLetters, passageData, imageData, basicGroupData, sceneData, answerGroupData, questionListGroupData, compareImagesGroupData, infoExchangeGroupData, conversationGroupData, } = sources;
+    if (hintLetters && hintLetters.length > 0)
+        return { hintLetters };
+    if (passageData)
+        return passageData;
+    if (imageData)
+        return imageData;
+    if (basicGroupData && (basicGroupData.title || basicGroupData.subtitle || basicGroupData.content || basicGroupData.imageUrl || basicGroupData.articles)) {
+        return basicGroupData;
+    }
+    if (sceneData)
+        return sceneData;
+    if (answerGroupData)
+        return answerGroupData;
+    if (questionListGroupData)
+        return questionListGroupData;
+    if (compareImagesGroupData)
+        return compareImagesGroupData;
+    if (infoExchangeGroupData)
+        return infoExchangeGroupData;
+    if (conversationGroupData)
+        return conversationGroupData;
+    return undefined;
+}
+/**
+ * Transform multiple questions to API format with the same validation gate used
+ * by the host frontend screen.
+ */
+export function transformQuestionsToApiFormat(questions) {
+    const validQuestions = [];
+    const invalidQuestions = [];
+    questions.forEach((item, index) => {
+        const { question, partId, partNo, sectionId, addToQuestionBank, questionBankCode, questionBankTitle, examLevel, subjectId } = item;
+        const validation = validateQuestionForTransform(question);
+        if (!validation.isValid) {
+            invalidQuestions.push({ index, errors: validation.errors });
+            return;
+        }
+        const questionNumber = question.questionNumber ?? index + 1;
+        validQuestions.push(transformQuestionToApiFormat(question, {
+            partId,
+            partNo,
+            questionNumber,
+            addToQuestionBank,
+            questionBankCode,
+            questionBankTitle,
+            sectionId,
+            examLevel,
+            subjectId,
+        }));
+    });
+    return { validQuestions, invalidQuestions };
+}

package/dist/shared/lib/utils.js

@@ -1 +1,168 @@
-import{clsx as t}from"clsx";import{twMerge as e}from"tailwind-merge";export function cn(...r){return e(t(r))}export function formatDate(t,e="DD/MM/YYYY"){const r=new Date(t),n=String(r.getDate()).padStart(2,"0"),a=String(r.getMonth()+1).padStart(2,"0"),o=r.getFullYear(),i=String(r.getHours()).padStart(2,"0"),u=String(r.getMinutes()).padStart(2,"0");return e.replace("DD",n).replace("MM",a).replace("YYYY",String(o)).replace("HH",i).replace("mm",u)}export function formatDuration(t){const e=Math.floor(t/3600),r=Math.floor(t%3600/60),n=t%60;return e>0?`${e}h ${r}m ${n}s`:r>0?`${r}m ${n}s`:`${n}s`}export function debounce(t,e){let r;return(...n)=>{clearTimeout(r),r=setTimeout(()=>t(...n),e)}}export function truncate(t,e){return t.length<=e?t:`${t.slice(0,e)}...`}export function getInitials(t){return t.split(" ").map(t=>t[0]).join("").toUpperCase().slice(0,2)}export function formatNumber(t){return t.toString().replace(/\B(?=(\d{3})+(?!\d))/g,",")}export function calculatePercentage(t,e){return 0===e?0:Math.round(t/e*100)}export function formatDateTimeVN(t,e="DD/MM/YYYY HH:mm"){if(!t)return"";try{const r=new Date(t);if(isNaN(r.getTime()))return"Invalid Date";const n=new Date(r.getTime()+252e5),a=String(n.getUTCDate()).padStart(2,"0"),o=String(n.getUTCMonth()+1).padStart(2,"0"),i=n.getUTCFullYear(),u=String(n.getUTCHours()).padStart(2,"0"),c=String(n.getUTCMinutes()).padStart(2,"0");return e.replace("DD",a).replace("MM",o).replace("YYYY",String(i)).replace("HH",u).replace("mm",c)}catch{return"Invalid Date"}}export function formatTimeVN(t){return formatDateTimeVN(t,"HH:mm")}export function formatDateVN(t){return formatDateTimeVN(t,"DD/MM/YYYY")}export function getDateInputValue(t){if(!t)return"";try{const e=new Date(t);if(isNaN(e.getTime()))return"";const r=new Date(e.getTime()+252e5),n=r.getUTCFullYear(),a=String(r.getUTCMonth()+1).padStart(2,"0");return`${n}-${a}-${String(r.getUTCDate()).padStart(2,"0")}`}catch{return""}}export function getTimeInputValue(t){return formatTimeVN(t)}export function cleanPayload(t){return Object.fromEntries(Object.entries(t).filter(([,t])=>void 0!==t&&""!==t&&null!==t))}
+import { clsx } from 'clsx';
+import { twMerge } from 'tailwind-merge';
+/**
+ * Merge Tailwind CSS classes with clsx
+ */
+export function cn(...inputs) {
+    return twMerge(clsx(inputs));
+}
+/**
+ * Format date to readable string
+ */
+export function formatDate(date, format = 'DD/MM/YYYY') {
+    const d = new Date(date);
+    const day = String(d.getDate()).padStart(2, '0');
+    const month = String(d.getMonth() + 1).padStart(2, '0');
+    const year = d.getFullYear();
+    const hours = String(d.getHours()).padStart(2, '0');
+    const minutes = String(d.getMinutes()).padStart(2, '0');
+    return format
+        .replace('DD', day)
+        .replace('MM', month)
+        .replace('YYYY', String(year))
+        .replace('HH', hours)
+        .replace('mm', minutes);
+}
+/**
+ * Format duration in seconds to readable string
+ */
+export function formatDuration(seconds) {
+    const hours = Math.floor(seconds / 3600);
+    const minutes = Math.floor((seconds % 3600) / 60);
+    const secs = seconds % 60;
+    if (hours > 0) {
+        return `${hours}h ${minutes}m ${secs}s`;
+    }
+    if (minutes > 0) {
+        return `${minutes}m ${secs}s`;
+    }
+    return `${secs}s`;
+}
+/**
+ * Debounce function
+ */
+export function debounce(func, delay) {
+    let timeoutId;
+    return (...args) => {
+        clearTimeout(timeoutId);
+        timeoutId = setTimeout(() => func(...args), delay);
+    };
+}
+/**
+ * Truncate string
+ */
+export function truncate(str, length) {
+    if (str.length <= length)
+        return str;
+    return `${str.slice(0, length)}...`;
+}
+/**
+ * Get initials from name
+ */
+export function getInitials(name) {
+    return name
+        .split(' ')
+        .map((n) => n[0])
+        .join('')
+        .toUpperCase()
+        .slice(0, 2);
+}
+/**
+ * Format number with commas
+ */
+export function formatNumber(num) {
+    return num.toString().replace(/\B(?=(\d{3})+(?!\d))/g, ',');
+}
+/**
+ * Calculate percentage
+ */
+export function calculatePercentage(value, total) {
+    if (total === 0)
+        return 0;
+    return Math.round((value / total) * 100);
+}
+/**
+ * Format date/time to Vietnam timezone (UTC+7)
+ * @param date - ISO date string or Date object
+ * @param format - Output format (default: 'DD/MM/YYYY HH:mm')
+ * @returns Formatted date string in UTC+7
+ */
+export function formatDateTimeVN(date, format = 'DD/MM/YYYY HH:mm') {
+    if (!date)
+        return '';
+    try {
+        const d = new Date(date);
+        if (isNaN(d.getTime()))
+            return 'Invalid Date';
+        // Convert to Vietnam timezone (UTC+7)
+        const vietnamTime = new Date(d.getTime() + (7 * 60 * 60 * 1000));
+        const day = String(vietnamTime.getUTCDate()).padStart(2, '0');
+        const month = String(vietnamTime.getUTCMonth() + 1).padStart(2, '0');
+        const year = vietnamTime.getUTCFullYear();
+        const hours = String(vietnamTime.getUTCHours()).padStart(2, '0');
+        const minutes = String(vietnamTime.getUTCMinutes()).padStart(2, '0');
+        return format
+            .replace('DD', day)
+            .replace('MM', month)
+            .replace('YYYY', String(year))
+            .replace('HH', hours)
+            .replace('mm', minutes);
+    }
+    catch {
+        return 'Invalid Date';
+    }
+}
+/**
+ * Format ISO datetime to time only in Vietnam timezone (UTC+7)
+ * @param date - ISO date string or Date object
+ * @returns Time string in HH:mm format (UTC+7)
+ */
+export function formatTimeVN(date) {
+    return formatDateTimeVN(date, 'HH:mm');
+}
+/**
+ * Format date only in Vietnam timezone (UTC+7)
+ * @param date - ISO date string or Date object
+ * @returns Date string in DD/MM/YYYY format (UTC+7)
+ */
+export function formatDateVN(date) {
+    return formatDateTimeVN(date, 'DD/MM/YYYY');
+}
+/**
+ * Extract date part from ISO string in Vietnam timezone (for date input)
+ * @param date - ISO date string or Date object
+ * @returns Date string in YYYY-MM-DD format (for HTML date input)
+ */
+export function getDateInputValue(date) {
+    if (!date)
+        return '';
+    try {
+        const d = new Date(date);
+        if (isNaN(d.getTime()))
+            return '';
+        // Convert to Vietnam timezone (UTC+7)
+        const vietnamTime = new Date(d.getTime() + (7 * 60 * 60 * 1000));
+        const year = vietnamTime.getUTCFullYear();
+        const month = String(vietnamTime.getUTCMonth() + 1).padStart(2, '0');
+        const day = String(vietnamTime.getUTCDate()).padStart(2, '0');
+        return `${year}-${month}-${day}`;
+    }
+    catch {
+        return '';
+    }
+}
+/**
+ * Extract time part from ISO string in Vietnam timezone (for time input)
+ * @param date - ISO date string or Date object
+ * @returns Time string in HH:mm format (for HTML time input)
+ */
+export function getTimeInputValue(date) {
+    return formatTimeVN(date);
+}
+/**
+ * Remove undefined, null, and empty string values from an object.
+ * Useful for cleaning API payloads before sending to backend.
+ */
+export function cleanPayload(payload) {
+    return Object.fromEntries(Object.entries(payload).filter(([, v]) => v !== undefined && v !== '' && v !== null));
+}