@tinyweb_dev/oe-exam-sdk 0.1.27 → 0.1.29

package/dist/components/results/report/speaking-report.utils.js

@@ -1 +1,198 @@
-import{ReviewGradingStatus as e}from"../../../api/result-review";import{buildSkillMetrics as t}from"../utils/speaking-summary";export const SKILL_UI_BY_KEY={pronunciation:{icon:"speaker",colorVarClass:"text-[#4CAF50]",barClass:"bg-[#4CAF50]"},fluency:{icon:"bolt",colorVarClass:"text-[#2196F3]",barClass:"bg-[#2196F3]"},vocabulary:{icon:"message",colorVarClass:"text-[#FF9800]",barClass:"bg-[#FF9800]"},grammar:{icon:"check-double",colorVarClass:"text-[#9C27B0]",barClass:"bg-[#9C27B0]"},coherence:{icon:"music",colorVarClass:"text-[#00BCD4]",barClass:"bg-[#00BCD4]"}};const n={READ_DISPLAYED_CONTENT:"Read displayed content",SPEAKING_DESCRIBE_IMAGE:"Describe image",SPONTANEOUS_QA:"Spontaneous Q&A"},i={[e.PENDING]:"Đang chờ chấm điểm",[e.QUEUED]:"Đang xếp hàng chờ chấm điểm",[e.PROCESSING]:"Đang chấm điểm...",[e.MANUAL_REVIEW]:"Đang chờ giáo viên xem xét",[e.FAILED]:"Chấm điểm thất bại — đang xử lý lại"};export function withUi(e){return{...e,...SKILL_UI_BY_KEY[e.key]}}export function getLocalizedText(e){return"string"==typeof e?e:e&&"object"==typeof e?"string"==typeof e.vi&&e.vi.trim()?e.vi:"string"==typeof e.en&&e.en.trim()?e.en:"":""}export function formatScore(e,t=1){if(null==e||Number.isNaN(e))return"—";return e.toFixed(t).replace(/\.0+$/,"").replace(/(\.\d*[1-9])0+$/,"$1")}export function formatTotalScore(e){return null!=e&&Number.isFinite(e)?e<10?e.toFixed(1):String(Math.round(e)):"—"}export function getScoreStroke(e,t,n){if(n||null==e||t<=0)return"conic-gradient(#cbd5e1 0% 100%, #eef5ff 100% 100%)";const i=Math.max(0,Math.min(100,e/t*100));return`conic-gradient(#00AEEF 0% ${i}%, #eef5ff ${i}% 100%)`}export function getQuestionTypeLabel(e){return n[e]??e.replace(/_/g," ")}export function isGradingComplete(t){return t===e.GRADED||t===e.AUTO_GRADED}export function getPendingGradingLabel(t){return t?i[t]??i[e.PENDING]:i[e.PENDING]}export function deriveQuestionSkillMetrics(e){const n=e.aiAssessment??null,i=e.llmAssessment??null;return t({pronunciation:n?.pronunciation?.pronunciationScore??null,fluency:n?.pronunciation?.fluencyScore??null,vocabulary:i?.contentScore??null,grammar:n?.pronunciation?.accuracyScore??null,coherence:n?.pronunciation?.prosodyScore??null}).map(withUi)}export function extractPrompt(e){const t=e.questionContent??{};if("SPEAKING_CUE_CARD"===e.questionType&&"string"==typeof t.cueCardHtml&&t.cueCardHtml.trim())return{text:t.cueCardHtml,isHtml:!0};const n=[getLocalizedText(t.title),getLocalizedText(t.prompt),getLocalizedText(t.question),getLocalizedText(t.questionText),getLocalizedText(t.instruction),getLocalizedText(t.content),getLocalizedText(t.text),getLocalizedText(t.paragraph),getLocalizedText(t.referenceText),getLocalizedText(t.cueCard),getLocalizedText(t.topic)].filter(e=>e.trim().length>0);if(n.length>0)return{text:n[0],isHtml:!1};if("READ_DISPLAYED_CONTENT"===e.questionType){const e=[getLocalizedText(t.displayedContent),getLocalizedText(t.passage),getLocalizedText(t.sentence),getLocalizedText(t.referenceText)].filter(e=>e.trim().length>0);if(e.length>0)return{text:e.join(" "),isHtml:!1}}if("SPONTANEOUS_QA"===e.questionType){const e=(Array.isArray(t.questions)?t.questions:[]).map(e=>{const t=e;return getLocalizedText(t.text||t.question||t.content)}).filter(e=>e.trim().length>0);if(e.length>0)return{text:e.join(" / "),isHtml:!1}}return{text:"Nội dung câu hỏi đang được cập nhật.",isHtml:!1}}export function extractStudentAnswerText(e){const t=e.studentAnswer??{},n=[getLocalizedText(t.transcript),getLocalizedText(t.recognizedText),getLocalizedText(t.answerText),getLocalizedText(t.text),getLocalizedText(t.content),getLocalizedText(t.finalText),getLocalizedText(t.response)].filter(e=>e.trim().length>0);return n.length>0?n[0]:e.studentAnswerKey?"Đã gửi file ghi âm.":"Chưa có câu trả lời."}export function extractQuestionFeedback(e){const t=e.classification??null,n=[getLocalizedText(e.llmAssessment?.feedback),getLocalizedText(e.aiAssessment?.feedback),getLocalizedText(t?.feedback),getLocalizedText(t?.description),getLocalizedText(t?.title)].filter(e=>e.trim().length>0);if(n.length>0)return n[0];if(e.isPendingGrading)return"Câu hỏi này đang chờ chấm điểm chi tiết.";if(null==e.score)return"Chưa có nhận xét chi tiết cho câu hỏi này.";const i=e.maxScore>0?e.score/e.maxScore:0;return i>=.85?"Câu trả lời tốt, tiếp tục duy trì phong độ này.":i>=.6?"Câu trả lời khá ổn, có thể cải thiện thêm độ rõ ràng và tự tin.":"Nên luyện thêm để cải thiện độ chính xác và cách diễn đạt ở câu hỏi này."}export function getPartScore(e){const t=e.questions.reduce((e,t)=>e+(Number.isFinite(t.maxScore)?t.maxScore:0),0),n=e.questions.some(e=>!isGradingComplete(e.gradingStatus)),i=e.questions.filter(e=>isGradingComplete(e.gradingStatus)).map(e=>e.score).filter(e=>"number"==typeof e&&Number.isFinite(e));return{score:i.length>0?i.reduce((e,t)=>e+t,0):null,maxScore:t,hasPending:n}}export function resolveAssetUrl(e,t,n){if(t&&n){return`${t.replace(/\/$/,"")}/${n}`}return"string"==typeof e?e:e.src}
+import { ReviewGradingStatus } from '../../../api/result-review';
+import { flattenSpontaneousQaGroupContent } from '../../questions/types/spontaneous-qa-group/flatten';
+import { buildSkillMetrics, } from '../utils/speaking-summary';
+export const SKILL_UI_BY_KEY = {
+    pronunciation: { icon: 'speaker', colorVarClass: 'text-[#4CAF50]', barClass: 'bg-[#4CAF50]' },
+    fluency: { icon: 'bolt', colorVarClass: 'text-[#2196F3]', barClass: 'bg-[#2196F3]' },
+    vocabulary: { icon: 'message', colorVarClass: 'text-[#FF9800]', barClass: 'bg-[#FF9800]' },
+    grammar: { icon: 'check-double', colorVarClass: 'text-[#9C27B0]', barClass: 'bg-[#9C27B0]' },
+    coherence: { icon: 'music', colorVarClass: 'text-[#00BCD4]', barClass: 'bg-[#00BCD4]' },
+};
+const QUESTION_TYPE_LABELS = {
+    READ_DISPLAYED_CONTENT: 'Read displayed content',
+    SPEAKING_DESCRIBE_IMAGE: 'Describe image',
+    SPONTANEOUS_QA: 'Spontaneous Q&A',
+    SPONTANEOUS_QA_GROUP: 'Spontaneous Q&A group',
+};
+const PENDING_GRADING_LABELS = {
+    [ReviewGradingStatus.PENDING]: 'Đang chờ chấm điểm',
+    [ReviewGradingStatus.QUEUED]: 'Đang xếp hàng chờ chấm điểm',
+    [ReviewGradingStatus.PROCESSING]: 'Đang chấm điểm...',
+    [ReviewGradingStatus.MANUAL_REVIEW]: 'Đang chờ giáo viên xem xét',
+    [ReviewGradingStatus.FAILED]: 'Chấm điểm thất bại — đang xử lý lại',
+};
+export function withUi(metric) {
+    return { ...metric, ...SKILL_UI_BY_KEY[metric.key] };
+}
+export function getLocalizedText(value) {
+    if (typeof value === 'string')
+        return value;
+    if (!value || typeof value !== 'object')
+        return '';
+    if (typeof value.vi === 'string' && value.vi.trim())
+        return value.vi;
+    if (typeof value.en === 'string' && value.en.trim())
+        return value.en;
+    return '';
+}
+export function formatScore(score, digits = 1) {
+    if (score == null || Number.isNaN(score))
+        return '—';
+    const fixed = score.toFixed(digits);
+    return fixed.replace(/\.0+$/, '').replace(/(\.\d*[1-9])0+$/, '$1');
+}
+/** Format total score for "ĐIỂM TỔNG" display */
+export function formatTotalScore(score) {
+    if (score == null || !Number.isFinite(score))
+        return '—';
+    if (score < 10)
+        return score.toFixed(1);
+    return String(Math.round(score));
+}
+export function getScoreStroke(totalScore, maxScore, isPendingGrading) {
+    if (isPendingGrading || totalScore == null || maxScore <= 0) {
+        return 'conic-gradient(#cbd5e1 0% 100%, #eef5ff 100% 100%)';
+    }
+    const percentage = Math.max(0, Math.min(100, (totalScore / maxScore) * 100));
+    return `conic-gradient(#00AEEF 0% ${percentage}%, #eef5ff ${percentage}% 100%)`;
+}
+export function getQuestionTypeLabel(questionType) {
+    return QUESTION_TYPE_LABELS[questionType] ?? questionType.replace(/_/g, ' ');
+}
+export function isGradingComplete(gradingStatus) {
+    return (gradingStatus === ReviewGradingStatus.GRADED ||
+        gradingStatus === ReviewGradingStatus.AUTO_GRADED);
+}
+export function getPendingGradingLabel(gradingStatus) {
+    if (!gradingStatus)
+        return PENDING_GRADING_LABELS[ReviewGradingStatus.PENDING];
+    return PENDING_GRADING_LABELS[gradingStatus] ?? PENDING_GRADING_LABELS[ReviewGradingStatus.PENDING];
+}
+export function deriveQuestionSkillMetrics(question) {
+    const ai = (question.aiAssessment ?? null);
+    const llm = (question.llmAssessment ?? null);
+    return buildSkillMetrics({
+        pronunciation: ai?.pronunciation?.pronunciationScore ?? null,
+        fluency: ai?.pronunciation?.fluencyScore ?? null,
+        vocabulary: llm?.contentScore ?? null,
+        grammar: ai?.pronunciation?.accuracyScore ?? null,
+        coherence: ai?.pronunciation?.prosodyScore ?? null,
+    }).map(withUi);
+}
+export function extractPrompt(question) {
+    const content = (question.questionContent ?? {});
+    if (question.questionType === 'SPEAKING_CUE_CARD' &&
+        typeof content['cueCardHtml'] === 'string' &&
+        content['cueCardHtml'].trim()) {
+        return { text: content['cueCardHtml'], isHtml: true };
+    }
+    const candidates = [
+        getLocalizedText(content['title']),
+        getLocalizedText(content['prompt']),
+        getLocalizedText(content['question']),
+        getLocalizedText(content['questionText']),
+        getLocalizedText(content['instruction']),
+        getLocalizedText(content['content']),
+        getLocalizedText(content['text']),
+        getLocalizedText(content['paragraph']),
+        getLocalizedText(content['referenceText']),
+        getLocalizedText(content['cueCard']),
+        getLocalizedText(content['topic']),
+    ].filter((item) => item.trim().length > 0);
+    if (candidates.length > 0) {
+        return { text: candidates[0], isHtml: false };
+    }
+    if (question.questionType === 'READ_DISPLAYED_CONTENT') {
+        const lines = [
+            getLocalizedText(content['displayedContent']),
+            getLocalizedText(content['passage']),
+            getLocalizedText(content['sentence']),
+            getLocalizedText(content['referenceText']),
+        ].filter((item) => item.trim().length > 0);
+        if (lines.length > 0) {
+            return { text: lines.join(' '), isHtml: false };
+        }
+    }
+    if (question.questionType === 'SPONTANEOUS_QA') {
+        const questions = Array.isArray(content['questions']) ? content['questions'] : [];
+        const promptList = questions
+            .map((item) => {
+            const row = item;
+            return getLocalizedText((row['text'] || row['question'] || row['content']));
+        })
+            .filter((item) => item.trim().length > 0);
+        if (promptList.length > 0) {
+            return { text: promptList.join(' / '), isHtml: false };
+        }
+    }
+    if (question.questionType === 'SPONTANEOUS_QA_GROUP') {
+        const flattened = flattenSpontaneousQaGroupContent(content);
+        const promptList = flattened
+            .map((child) => {
+            const partLabel = [child.partTitle, child.topic].filter(Boolean).join(' — ');
+            return partLabel ? `${partLabel}: ${child.questionText}` : child.questionText;
+        })
+            .filter((item) => item.trim().length > 0);
+        if (promptList.length > 0) {
+            return { text: promptList.join(' / '), isHtml: false };
+        }
+    }
+    return { text: 'Nội dung câu hỏi đang được cập nhật.', isHtml: false };
+}
+export function extractStudentAnswerText(question) {
+    const studentAnswer = (question.studentAnswer ?? {});
+    const candidates = [
+        getLocalizedText(studentAnswer['transcript']),
+        getLocalizedText(studentAnswer['recognizedText']),
+        getLocalizedText(studentAnswer['answerText']),
+        getLocalizedText(studentAnswer['text']),
+        getLocalizedText(studentAnswer['content']),
+        getLocalizedText(studentAnswer['finalText']),
+        getLocalizedText(studentAnswer['response']),
+    ].filter((item) => item.trim().length > 0);
+    if (candidates.length > 0)
+        return candidates[0];
+    return question.studentAnswerKey ? 'Đã gửi file ghi âm.' : 'Chưa có câu trả lời.';
+}
+export function extractQuestionFeedback(question) {
+    const classification = (question.classification ?? null);
+    const feedbackCandidates = [
+        getLocalizedText(question.llmAssessment?.feedback),
+        getLocalizedText(question.aiAssessment?.feedback),
+        getLocalizedText(classification?.['feedback']),
+        getLocalizedText(classification?.['description']),
+        getLocalizedText(classification?.['title']),
+    ].filter((item) => item.trim().length > 0);
+    if (feedbackCandidates.length > 0)
+        return feedbackCandidates[0];
+    if (question.isPendingGrading)
+        return 'Câu hỏi này đang chờ chấm điểm chi tiết.';
+    if (question.score == null)
+        return 'Chưa có nhận xét chi tiết cho câu hỏi này.';
+    const ratio = question.maxScore > 0 ? question.score / question.maxScore : 0;
+    if (ratio >= 0.85)
+        return 'Câu trả lời tốt, tiếp tục duy trì phong độ này.';
+    if (ratio >= 0.6)
+        return 'Câu trả lời khá ổn, có thể cải thiện thêm độ rõ ràng và tự tin.';
+    return 'Nên luyện thêm để cải thiện độ chính xác và cách diễn đạt ở câu hỏi này.';
+}
+export function getPartScore(part) {
+    const maxScore = part.questions.reduce((sum, question) => sum + (Number.isFinite(question.maxScore) ? question.maxScore : 0), 0);
+    const hasPending = part.questions.some((q) => !isGradingComplete(q.gradingStatus));
+    const numericScores = part.questions
+        .filter((question) => isGradingComplete(question.gradingStatus))
+        .map((question) => question.score)
+        .filter((score) => typeof score === 'number' && Number.isFinite(score));
+    return {
+        score: numericScores.length > 0 ? numericScores.reduce((sum, score) => sum + score, 0) : null,
+        maxScore,
+        hasPending,
+    };
+}
+export function resolveAssetUrl(asset, assetBaseUrl, fileName) {
+    if (assetBaseUrl && fileName) {
+        const base = assetBaseUrl.replace(/\/$/, '');
+        return `${base}/${fileName}`;
+    }
+    return typeof asset === 'string' ? asset : asset.src;
+}

package/dist/components/results/result-review.utils.js

@@ -1 +1,6 @@
-export function unwrap(n){return function(n){return"object"==typeof n&&null!==n&&"data"in n}(n)?n.data:n}
+export function unwrap(value) {
+    return hasData(value) ? value.data : value;
+}
+function hasData(value) {
+    return typeof value === 'object' && value !== null && 'data' in value;
+}

package/dist/components/results/review-data.js

@@ -1 +1,222 @@
-const e=new Set(["READ_PASSAGE_AND_ANSWER_QUESTIONS","LOOK_PICTURE_FILL_WORD_HINT","LABEL_THE_PICTURE","READ_AND_COLOR_OBJECTS","IMAGE_OBJECT_MATCHING","CHOOSE_THE_CORRECT_ANSWER_GROUP"]);export function transformResultAnswersForReview(e,s=[]){const o=function(e){const r=new Map;return e.forEach(e=>{const t=[e.partId??"unknown",e.questionGroup?.id??"none",e.questionType].join(":");r.set(t,[...r.get(t)??[],e])}),r}(e),i={parts:[],studentAnswers:{},correctAnswersMap:new Map,isCorrectMap:{},correctAnswerTextMap:{},correctOptionIdMap:{},cellAnswersMap:{},essayGradingMap:{},partScoresMap:{},rawCorrectAnswerMap:{},rawStudentAnswerMap:{},questionScoreMap:{}},c=[];for(const e of o.values()){e.sort((e,r)=>e.questionNumber-r.questionNumber);const o=e[0];if(!o)continue;const u=s.find(e=>String(e.id)===String(o.partId)),p=r(u,o.questionNumber),A=a(u?.name)??o.partNo??0;i.parts.push({partId:o.partId,partNo:A,questionType:o.questionType,name:u?.name,instructions:p?.name||p?.instructions||u?.instructions,audioUrl:u?.audioUrl,questions:e.map(t)});const _=e.filter(e=>!e.isExample);c.push({score:_.reduce((e,r)=>e+(r.score??0),0),maxScore:_.reduce((e,r)=>e+r.maxScore,0),correctCount:_.filter(e=>!0===e.isCorrect).length,totalCount:_.length}),e.forEach(e=>n(i,e))}const u=i.parts.map((e,r)=>r).sort((e,r)=>{const t=i.parts[e],n=i.parts[r];return t.partNo-n.partNo||(t.questions[0]?.question_number??0)-(n.questions[0]?.question_number??0)});return i.parts=u.map(e=>i.parts[e]),u.forEach((e,r)=>{i.partScoresMap[r]=c[e]}),i}export const transformDetailedResultForReview=transformResultAnswersForReview;function r(e,r){const t=r-1;return e?.sections?.find(e=>null!=e.startIndex&&null!=e.endIndex&&t>=e.startIndex&&t<=e.endIndex)}function t(e){const r=o(e.questionContent);return{id:e.questionId,content:{...r,_correctAnswer:e.correctAnswer},correct_answer:e.correctAnswer,total_points:String(e.maxScore),question_type:e.questionType,is_example:e.isExample??!1,explanation:e.explanation??"",difficult_level:"MEDIUM",question_skill_type:"",exam_id:"",part_id:e.partId??"",part_no:e.partNo??0,question_number:e.questionNumber,questionGroup:e.questionGroup??null,score:e.score}}function n(r,t){const n=function(e,r,t){if(null==t)return;const n=o(t);if("CHOOSE_THE_CORRECT_ANSWER_GROUP"===r){const r=n.answer;if(!Array.isArray(r))return;return Object.fromEntries(r.map((r,t)=>[`${e}-item-${t}`,"string"==typeof r?r:""]))}if("CHOOSE_THE_CORRECT_ANSWER"===r||"CHOOSE_CORRECT_ADJECTIVE"===r){const r=n.answer??n.optionId??n.optionIds,t=s(e,r);return t.length>1?t:t[0]}if("READ_PASSAGE_AND_ANSWER_QUESTIONS"===r&&i(n.subAnswers))return Object.fromEntries(Object.entries(n.subAnswers).map(([e,r])=>[e,"number"==typeof r?`${e}-opt-${r}`:r]));if("LABEL_THE_PICTURE"===r)return n.answers??t;if("LOOK_PICTURE_FILL_WORD_HINT"===r&&"string"==typeof n.answer&&n.answer.includes(","))return Object.fromEntries(n.answer.split(",").map((r,t)=>[`${e}-blank-${t}`,r.trim()]));if("WORD_FILL_PARAGRAPH"===r){if(Array.isArray(n.answers))return n.answers;if(Array.isArray(n.answer))return n.answer;if(Array.isArray(t))return t;if("string"==typeof t)return[t];return Object.keys(n).filter(e=>/^\d+$/.test(e)).sort((e,r)=>Number(e)-Number(r)).map(e=>n[e])}return"READ_AND_COLOR_OBJECTS"===r||"IMAGE_OBJECT_MATCHING"===r?n.answers??t:"WRITE_A_SHORT_LETTER"===r?"string"==typeof t?t:n.answer??"":n.answer??t}(t.questionId,t.questionType,t.studentAnswer);void 0!==n&&(e.has(t.questionType)&&i(n)?Object.assign(r.studentAnswers,n):r.studentAnswers[t.questionId]=n),r.correctAnswersMap.set(t.questionId,t.correctAnswer),r.isCorrectMap[t.questionId]=t.isCorrect,r.rawCorrectAnswerMap[t.questionId]=t.correctAnswer,r.rawStudentAnswerMap[t.questionId]=t.studentAnswer,r.questionScoreMap[t.questionId]={score:t.score,maxScore:t.maxScore},function(e,r){const t=o(r.correctAnswer),n=s(r.questionId,t.answer);n.length&&(e.correctOptionIdMap[r.questionId]=n.join(","));if("CHOOSE_THE_CORRECT_ANSWER_GROUP"===r.questionType){const n=Array.isArray(o(r.questionContent).items)?o(r.questionContent).items:[],s=Array.isArray(t.answer)?t.answer:[];n.forEach((t,n)=>{const o=`${r.questionId}-item-${n}`,i=t?.correctAnswer?.answer||s[n];"string"==typeof i&&i&&(e.correctOptionIdMap[o]=i)})}"READ_PASSAGE_AND_ANSWER_QUESTIONS"===r.questionType&&i(t.answers)&&Object.entries(t.answers).forEach(([r,t])=>{"number"==typeof t&&(e.correctOptionIdMap[r]=`${r}-opt-${t}`)});const a=function(e){if(Array.isArray(e.answers))return e.answers.map(String);if(i(e.answers))return Object.values(e.answers).map(String);const r=e.answer??e.correctAnswer;return null==r?[]:[String(r)]}(t);a[0]&&(e.correctAnswerTextMap[r.questionId]=a[0]);"WORD_FILL_PARAGRAPH"===r.questionType&&a.forEach((t,n)=>{e.correctAnswerTextMap[`${r.questionId}-blank-${n}`]=t});"LABEL_THE_PICTURE"===r.questionType&&i(t.labels)&&Object.entries(t.labels).forEach(([r,t])=>{e.correctAnswerTextMap[r]=String(t)});"FILL_MISSING_WORDS_IN_GRID"===r.questionType&&i(t.cells)&&(e.cellAnswersMap[r.questionId]={cells:t.cells,caseSensitive:!0===t.caseSensitive})}(r,t),"WRITE_A_SHORT_LETTER"!==t.questionType&&"WRITE_SHORT_PARAGRAPH"!==t.questionType||(r.essayGradingMap[t.questionId]={score:t.teacherScore??t.score,maxScore:t.maxScore,teacherFeedback:t.teacherFeedback??null,writingAssessment:t.writingAssessment??null})}function s(e,r){return(Array.isArray(r)?r:[r]).filter(e=>"number"==typeof e||"string"==typeof e).map(r=>"number"==typeof r?`${e}-opt-${r}`:r)}function o(e){return i(e)?e:{}}function i(e){return"object"==typeof e&&null!==e&&!Array.isArray(e)}function a(e){const r=e?.match(/\d+/);return r?Number(r[0]):void 0}
+import { normalizeCrossOutWordGroupAnswer } from '../../components/exams/take/utils/cross-out-word-group.transformer';
+const FLATTENED_ANSWER_TYPES = new Set([
+    'READ_PASSAGE_AND_ANSWER_QUESTIONS',
+    'LOOK_PICTURE_FILL_WORD_HINT',
+    'LABEL_THE_PICTURE',
+    'READ_AND_COLOR_OBJECTS',
+    'IMAGE_OBJECT_MATCHING',
+    'CHOOSE_THE_CORRECT_ANSWER_GROUP',
+    'CROSS_OUT_WORD_GROUP',
+]);
+export function transformResultAnswersForReview(answers, templateParts = []) {
+    const groups = groupAnswers(answers);
+    const result = {
+        parts: [], studentAnswers: {}, correctAnswersMap: new Map(), isCorrectMap: {},
+        correctAnswerTextMap: {}, correctOptionIdMap: {}, cellAnswersMap: {},
+        essayGradingMap: {}, partScoresMap: {}, rawCorrectAnswerMap: {},
+        rawStudentAnswerMap: {}, questionScoreMap: {},
+    };
+    const scores = [];
+    for (const group of groups.values()) {
+        group.sort((a, b) => a.questionNumber - b.questionNumber);
+        const first = group[0];
+        if (!first)
+            continue;
+        const template = templateParts.find((part) => String(part.id) === String(first.partId));
+        const section = findSection(template, first.questionNumber);
+        const partNo = parsePartNo(template?.name) ?? first.partNo ?? 0;
+        result.parts.push({
+            partId: first.partId,
+            partNo,
+            questionType: first.questionType,
+            name: template?.name,
+            instructions: section?.name || section?.instructions || template?.instructions,
+            audioUrl: template?.audioUrl,
+            questions: group.map(toQuestion),
+        });
+        const gradable = group.filter((answer) => !answer.isExample);
+        scores.push({
+            score: gradable.reduce((sum, answer) => sum + (answer.score ?? 0), 0),
+            maxScore: gradable.reduce((sum, answer) => sum + answer.maxScore, 0),
+            correctCount: gradable.filter((answer) => answer.isCorrect === true).length,
+            totalCount: gradable.length,
+        });
+        group.forEach((answer) => addAnswerMaps(result, answer));
+    }
+    const order = result.parts.map((_, index) => index).sort((a, b) => {
+        const left = result.parts[a];
+        const right = result.parts[b];
+        return left.partNo - right.partNo || (left.questions[0]?.question_number ?? 0) - (right.questions[0]?.question_number ?? 0);
+    });
+    result.parts = order.map((index) => result.parts[index]);
+    order.forEach((sourceIndex, targetIndex) => { result.partScoresMap[targetIndex] = scores[sourceIndex]; });
+    return result;
+}
+export const transformDetailedResultForReview = transformResultAnswersForReview;
+function groupAnswers(answers) {
+    const groups = new Map();
+    answers.forEach((answer) => {
+        const key = [answer.partId ?? 'unknown', answer.questionGroup?.id ?? 'none', answer.questionType].join(':');
+        groups.set(key, [...(groups.get(key) ?? []), answer]);
+    });
+    return groups;
+}
+function findSection(template, questionNumber) {
+    const position = questionNumber - 1;
+    return template?.sections?.find((section) => section.startIndex != null && section.endIndex != null && position >= section.startIndex && position <= section.endIndex);
+}
+function toQuestion(answer) {
+    const content = asRecord(answer.questionContent);
+    return {
+        id: answer.questionId,
+        content: { ...content, _correctAnswer: answer.correctAnswer },
+        correct_answer: answer.correctAnswer,
+        total_points: String(answer.maxScore),
+        question_type: answer.questionType,
+        is_example: answer.isExample ?? false,
+        explanation: answer.explanation ?? '',
+        difficult_level: 'MEDIUM', question_skill_type: '', exam_id: '',
+        part_id: answer.partId ?? '', part_no: answer.partNo ?? 0,
+        question_number: answer.questionNumber,
+        questionGroup: answer.questionGroup ?? null,
+        score: answer.score,
+    };
+}
+function addAnswerMaps(result, answer) {
+    const student = transformStudentAnswer(answer.questionId, answer.questionType, answer.studentAnswer);
+    if (student !== undefined) {
+        if (FLATTENED_ANSWER_TYPES.has(answer.questionType) && isRecord(student))
+            Object.assign(result.studentAnswers, student);
+        else
+            result.studentAnswers[answer.questionId] = student;
+    }
+    result.correctAnswersMap.set(answer.questionId, answer.correctAnswer);
+    result.isCorrectMap[answer.questionId] = answer.isCorrect;
+    result.rawCorrectAnswerMap[answer.questionId] = answer.correctAnswer;
+    result.rawStudentAnswerMap[answer.questionId] = answer.studentAnswer;
+    result.questionScoreMap[answer.questionId] = { score: answer.score, maxScore: answer.maxScore };
+    addCorrectAnswerMaps(result, answer);
+    if (answer.questionType === 'WRITE_A_SHORT_LETTER' || answer.questionType === 'WRITE_SHORT_PARAGRAPH') {
+        result.essayGradingMap[answer.questionId] = {
+            score: answer.teacherScore ?? answer.score,
+            maxScore: answer.maxScore,
+            teacherFeedback: answer.teacherFeedback ?? null,
+            writingAssessment: answer.writingAssessment ?? null,
+        };
+    }
+}
+function addCorrectAnswerMaps(result, answer) {
+    const correct = asRecord(answer.correctAnswer);
+    const optionIds = getOptionIds(answer.questionId, correct.answer);
+    if (optionIds.length)
+        result.correctOptionIdMap[answer.questionId] = optionIds.join(',');
+    if (answer.questionType === 'CHOOSE_THE_CORRECT_ANSWER_GROUP') {
+        const items = Array.isArray(asRecord(answer.questionContent).items)
+            ? asRecord(answer.questionContent).items
+            : [];
+        const groupAnswers = Array.isArray(correct.answer) ? correct.answer : [];
+        items.forEach((item, index) => {
+            const itemId = `${answer.questionId}-item-${index}`;
+            const correctId = item?.correctAnswer?.answer || groupAnswers[index];
+            if (typeof correctId === 'string' && correctId) {
+                result.correctOptionIdMap[itemId] = correctId;
+            }
+        });
+    }
+    if (answer.questionType === 'READ_PASSAGE_AND_ANSWER_QUESTIONS' && isRecord(correct.answers)) {
+        Object.entries(correct.answers).forEach(([id, value]) => {
+            if (typeof value === 'number')
+                result.correctOptionIdMap[id] = `${id}-opt-${value}`;
+        });
+    }
+    const texts = readAnswerTexts(correct);
+    if (texts[0])
+        result.correctAnswerTextMap[answer.questionId] = texts[0];
+    if (answer.questionType === 'WORD_FILL_PARAGRAPH')
+        texts.forEach((text, index) => { result.correctAnswerTextMap[`${answer.questionId}-blank-${index}`] = text; });
+    if (answer.questionType === 'LABEL_THE_PICTURE' && isRecord(correct.labels))
+        Object.entries(correct.labels).forEach(([id, value]) => { result.correctAnswerTextMap[id] = String(value); });
+    if (answer.questionType === 'FILL_MISSING_WORDS_IN_GRID' && isRecord(correct.cells)) {
+        result.cellAnswersMap[answer.questionId] = { cells: correct.cells, caseSensitive: correct.caseSensitive === true };
+    }
+}
+function transformStudentAnswer(questionId, questionType, value) {
+    if (value == null)
+        return undefined;
+    if (questionType === 'SPONTANEOUS_QA_GROUP') {
+        return value;
+    }
+    const record = asRecord(value);
+    if (questionType === 'CHOOSE_THE_CORRECT_ANSWER_GROUP') {
+        const answer = record.answer;
+        if (!Array.isArray(answer))
+            return undefined;
+        return Object.fromEntries(answer.map((item, index) => [
+            `${questionId}-item-${index}`,
+            typeof item === 'string' ? item : '',
+        ]));
+    }
+    if (questionType === 'CROSS_OUT_WORD_GROUP') {
+        const answer = Array.isArray(record.answer)
+            ? record.answer
+            : Array.isArray(value)
+                ? value
+                : [];
+        return Object.fromEntries(answer.map((item, index) => [
+            `${questionId}-item-${index}`,
+            normalizeCrossOutWordGroupAnswer(item),
+        ]));
+    }
+    if (questionType === 'CHOOSE_THE_CORRECT_ANSWER' || questionType === 'CHOOSE_CORRECT_ADJECTIVE') {
+        const rawAns = record.answer ?? record.optionId ?? record.optionIds;
+        const ids = getOptionIds(questionId, rawAns);
+        return ids.length > 1 ? ids : ids[0];
+    }
+    if (questionType === 'READ_PASSAGE_AND_ANSWER_QUESTIONS' && isRecord(record.subAnswers)) {
+        return Object.fromEntries(Object.entries(record.subAnswers).map(([id, selected]) => [id, typeof selected === 'number' ? `${id}-opt-${selected}` : selected]));
+    }
+    if (questionType === 'LABEL_THE_PICTURE')
+        return record.answers ?? value;
+    if (questionType === 'LOOK_PICTURE_FILL_WORD_HINT' && typeof record.answer === 'string' && record.answer.includes(',')) {
+        return Object.fromEntries(record.answer.split(',').map((item, index) => [`${questionId}-blank-${index}`, item.trim()]));
+    }
+    if (questionType === 'WORD_FILL_PARAGRAPH') {
+        if (Array.isArray(record.answers))
+            return record.answers;
+        if (Array.isArray(record.answer))
+            return record.answer;
+        if (Array.isArray(value))
+            return value;
+        if (typeof value === 'string')
+            return [value];
+        const keys = Object.keys(record).filter((key) => /^\d+$/.test(key)).sort((a, b) => Number(a) - Number(b));
+        return keys.map((key) => record[key]);
+    }
+    if (questionType === 'READ_AND_COLOR_OBJECTS' || questionType === 'IMAGE_OBJECT_MATCHING')
+        return record.answers ?? value;
+    if (questionType === 'WRITE_A_SHORT_LETTER')
+        return typeof value === 'string' ? value : record.answer ?? '';
+    return record.answer ?? value;
+}
+function getOptionIds(questionId, answer) {
+    const values = Array.isArray(answer) ? answer : [answer];
+    return values.filter((value) => typeof value === 'number' || typeof value === 'string').map((value) => typeof value === 'number' ? `${questionId}-opt-${value}` : value);
+}
+function readAnswerTexts(correct) {
+    if (Array.isArray(correct.answers))
+        return correct.answers.map(String);
+    if (isRecord(correct.answers))
+        return Object.values(correct.answers).map(String);
+    const value = correct.answer ?? correct.correctAnswer;
+    return value == null ? [] : [String(value)];
+}
+function asRecord(value) {
+    return isRecord(value) ? value : {};
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function parsePartNo(value) {
+    const match = value?.match(/\d+/);
+    return match ? Number(match[0]) : undefined;
+}

package/dist/components/results/review-renderer.utils.js

@@ -1 +1,97 @@
-export function asRecord(e){return"object"==typeof e&&null!==e?e:{}}export function readString(e,...r){const t=asRecord(e);for(const e of r){const r=t[e];if("string"==typeof r)return r}return""}export function readArray(e,r){const t=asRecord(e)[r];return Array.isArray(t)?t:[]}export function readQuestionText(e){return readString(e.content,"questionText","question","text","sentence")||String(e.content??"")}export function transformChoiceQuestions(r){return r.map(r=>{const t=asRecord(r.content),n=readString(t,"optionType");return{id:r.id,questionNumber:r.question_number,questionText:readQuestionText(r),imageUrl:readString(t,"imageUrl"),optionType:n,multipleAnswers:Boolean(t.multipleAnswers),options:e(t,r.id,n)}})}export function transformFillQuestions(e){return e.map(e=>{const r=asRecord(e.content);return{id:e.id,questionNumber:e.question_number,textBefore:readString(r,"textBefore","sentenceBefore","prefixText"),textAfter:readString(r,"textAfter","sentenceAfter","suffixText"),imageUrl:readString(r,"imageUrl")}})}export function transformAdjectiveQuestions(r){return r.map(r=>{const t=asRecord(r.content);return{id:r.id,questionNumber:r.question_number,textBefore:"",textAfter:"",sentenceBefore:readString(t,"sentenceBefore","textBefore"),sentenceAfter:readString(t,"sentenceAfter","textAfter"),imageUrl:readString(t,"imageUrl"),options:e(t,r.id,"text")}})}export function transformColoring(e){const r=asRecord(e[0]?.content);return{instruction:readString(r,"instruction"),instructions:readArray(r,"instructions").filter(e=>"string"==typeof e),imageUrl:readString(r,"imageUrl","backgroundImageUrl"),audioUrl:readString(r,"audioUrl"),hintItems:readArray(r,"hintItems").map(e=>{const r=asRecord(e);return{id:String(r.id??""),label:readString(r,"label"),color:readString(r,"color")}}).filter(e=>e.id),regions:readArray(r,"regions").map(e=>{const r=asRecord(e);return{id:String(r.id??""),x:Number(r.x??0),y:Number(r.y??0),width:Number(r.width??0),height:Number(r.height??0)}}).filter(e=>e.id)}}function e(e,r,t){return readArray(e,"options").map((e,n)=>{const i=asRecord(e),o=String(i.id??`${r}-opt-${n}`),a=readString(i,"text","label","value","imageUrl");return{id:o,label:readString(i,"label")||String.fromCharCode(65+n),text:a,imageUrl:"image"===t?a:readString(i,"imageUrl")}})}export function normalizeSelected(e){return Array.isArray(e)?e.map(String):"string"==typeof e&&e?e.split(",").map(e=>e.trim()).filter(Boolean):[]}export function normalizeRecord(e){const r=asRecord(e);return Object.fromEntries(Object.entries(r).map(([e,r])=>[e,String(r??"")]))}
+export function asRecord(value) {
+    return typeof value === 'object' && value !== null ? value : {};
+}
+export function readString(value, ...keys) {
+    const record = asRecord(value);
+    for (const key of keys) {
+        const item = record[key];
+        if (typeof item === 'string')
+            return item;
+    }
+    return '';
+}
+export function readArray(value, key) {
+    const item = asRecord(value)[key];
+    return Array.isArray(item) ? item : [];
+}
+export function readQuestionText(question) {
+    return readString(question.content, 'questionText', 'question', 'text', 'sentence') || String(question.content ?? '');
+}
+export function transformChoiceQuestions(questions) {
+    return questions.map((question) => {
+        const content = asRecord(question.content);
+        const optionType = readString(content, 'optionType');
+        return {
+            id: question.id,
+            questionNumber: question.question_number,
+            questionText: readQuestionText(question),
+            imageUrl: readString(content, 'imageUrl'),
+            optionType,
+            multipleAnswers: Boolean(content.multipleAnswers),
+            options: readOptions(content, question.id, optionType),
+        };
+    });
+}
+export function transformFillQuestions(questions) {
+    return questions.map((question) => {
+        const content = asRecord(question.content);
+        return {
+            id: question.id,
+            questionNumber: question.question_number,
+            textBefore: readString(content, 'textBefore', 'sentenceBefore', 'prefixText'),
+            textAfter: readString(content, 'textAfter', 'sentenceAfter', 'suffixText'),
+            imageUrl: readString(content, 'imageUrl'),
+        };
+    });
+}
+export function transformAdjectiveQuestions(questions) {
+    return questions.map((question) => {
+        const content = asRecord(question.content);
+        return {
+            id: question.id,
+            questionNumber: question.question_number,
+            textBefore: '',
+            textAfter: '',
+            sentenceBefore: readString(content, 'sentenceBefore', 'textBefore'),
+            sentenceAfter: readString(content, 'sentenceAfter', 'textAfter'),
+            imageUrl: readString(content, 'imageUrl'),
+            options: readOptions(content, question.id, 'text'),
+        };
+    });
+}
+export function transformColoring(questions) {
+    const first = asRecord(questions[0]?.content);
+    return {
+        instruction: readString(first, 'instruction'),
+        instructions: readArray(first, 'instructions').filter((item) => typeof item === 'string'),
+        imageUrl: readString(first, 'imageUrl', 'backgroundImageUrl'),
+        audioUrl: readString(first, 'audioUrl'),
+        hintItems: readArray(first, 'hintItems').map((item) => {
+            const row = asRecord(item);
+            return { id: String(row.id ?? ''), label: readString(row, 'label'), color: readString(row, 'color') };
+        }).filter((item) => item.id),
+        regions: readArray(first, 'regions').map((item) => {
+            const row = asRecord(item);
+            return { id: String(row.id ?? ''), x: Number(row.x ?? 0), y: Number(row.y ?? 0), width: Number(row.width ?? 0), height: Number(row.height ?? 0) };
+        }).filter((item) => item.id),
+    };
+}
+function readOptions(content, questionId, optionType) {
+    return readArray(content, 'options').map((item, index) => {
+        const option = asRecord(item);
+        const id = String(option.id ?? `${questionId}-opt-${index}`);
+        const text = readString(option, 'text', 'label', 'value', 'imageUrl');
+        return { id, label: readString(option, 'label') || String.fromCharCode(65 + index), text, imageUrl: optionType === 'image' ? text : readString(option, 'imageUrl') };
+    });
+}
+export function normalizeSelected(value) {
+    if (Array.isArray(value))
+        return value.map(String);
+    if (typeof value === 'string' && value)
+        return value.split(',').map((item) => item.trim()).filter(Boolean);
+    return [];
+}
+export function normalizeRecord(value) {
+    const record = asRecord(value);
+    return Object.fromEntries(Object.entries(record).map(([key, item]) => [key, String(item ?? '')]));
+}

package/dist/components/results/review-status.utils.js

@@ -1 +1,36 @@
-const t=new Set(["RESULT_NOT_PUBLIC","FORBIDDEN"]);export function isResultNotPublic(e,n){const o=function(t){return"object"!=typeof t||null===t?null:t}(e);if(403!==o?.response?.status)return!1;const r=o.response.data?.errorCode;return r?t.has(r):n}export function setPdfReady(t){"undefined"!=typeof document&&(t?document.body.setAttribute("data-pdf-ready","true"):document.body.removeAttribute("data-pdf-ready"))}
+/** Status & access helpers for the result review screen. */
+/** HTTP status returned when a result is not publicly accessible. */
+const FORBIDDEN_STATUS = 403;
+/** Error codes the API uses to signal a private/forbidden result. */
+const NOT_PUBLIC_ERROR_CODES = new Set(['RESULT_NOT_PUBLIC', 'FORBIDDEN']);
+function asHttpError(error) {
+    if (typeof error !== 'object' || error === null)
+        return null;
+    return error;
+}
+/**
+ * Determine whether a load error means "this result is not public". Ports the
+ * host app's logic: a 403 with an explicit `RESULT_NOT_PUBLIC`/`FORBIDDEN` code,
+ * or any 403 reached via a token link (the only anonymous-access path).
+ */
+export function isResultNotPublic(error, hasToken) {
+    const httpError = asHttpError(error);
+    if (httpError?.response?.status !== FORBIDDEN_STATUS)
+        return false;
+    const errorCode = httpError.response.data?.errorCode;
+    if (errorCode)
+        return NOT_PUBLIC_ERROR_CODES.has(errorCode);
+    return hasToken;
+}
+/**
+ * Toggle the `data-pdf-ready` body attribute the headless PDF renderer waits on.
+ * Call with `true` once the result has finished loading in print mode.
+ */
+export function setPdfReady(ready) {
+    if (typeof document === 'undefined')
+        return;
+    if (ready)
+        document.body.setAttribute('data-pdf-ready', 'true');
+    else
+        document.body.removeAttribute('data-pdf-ready');
+}

package/dist/components/results/review-types.js

@@ -1 +1 @@
-export{};
+export {};