@tinyweb_dev/oe-exam-sdk 0.1.3 → 0.1.5

package/dist/components/results/report/SpeakingReportShared.js

@@ -0,0 +1 @@
+"use client";import{jsx as e,jsxs as t}from"react/jsx-runtime";import{CheckCheck as s,Clock as r,MessageSquare as l,MessageSquareQuote as a,Music2 as n,Volume2 as i,Zap as d}from"lucide-react";import{ReviewGradingStatus as c}from"../../../api/result-review";import{ResolvedImage as x}from"../../../components/common/ResolvedImage";import{cn as o}from"../../../shared/lib/utils";import{SpeakingResultAudioPlayer as m}from"../speaking/SpeakingResultAudioPlayer";import{deriveQuestionSkillMetrics as p,extractPrompt as u,extractQuestionFeedback as h,extractStudentAnswerText as f,formatScore as b,getPendingGradingLabel as g,getQuestionTypeLabel as N,isGradingComplete as w}from"./speaking-report.utils";export function InfoRow({icon:s,label:r,value:l}){return t("p",{className:"flex items-start text-[13px] font-medium text-[#333] xs:text-sm sm:text-base md:text-lg",children:[e(s,{className:"mr-2 mt-0.5 h-[14px] w-[14px] shrink-0 text-[#0054A6] xs:h-[16px] xs:w-[16px] sm:mr-3 sm:h-[18px] sm:w-[18px]"}),t("span",{className:"flex flex-wrap items-baseline gap-x-1.5",children:[t("span",{className:"whitespace-nowrap",children:[r," :"]}),e("strong",{suppressHydrationWarning:!0,className:"font-bold text-[#0054A6]",children:l})]})]})}function v({metric:t}){const r="h-[18px] w-[18px] text-white";switch(t.icon){case"speaker":return e(i,{className:r});case"bolt":return e(d,{className:r});case"message":return e(l,{className:r});case"check-double":return e(s,{className:r});case"music":return e(n,{className:r});default:return null}}export function SkillRow({metric:s,compact:r=!1}){const l=b(r?s.score/10:s.score,1),a=r?"/10":"/100";return t("div",{className:o("flex items-center rounded-full border border-[#eef4fb] bg-white shadow-[0_1px_0_rgba(255,255,255,0.9)] last:mb-0",r?"min-h-[70px] pl-[12px] pr-4":"mb-2 px-3 py-2 sm:mb-3 sm:px-4 sm:py-3"),children:[e("div",{className:"flex h-[48px] w-[48px] shrink-0 items-center justify-center rounded-full bg-white shadow-[0_4px_12px_rgba(15,23,42,0.08)] xs:h-[52px] xs:w-[52px] sm:h-[58px] sm:w-[58px]",children:e("div",{className:o("flex items-center justify-center rounded-full text-white",r?"h-[42px] w-[42px]":"h-[36px] w-[36px] xs:h-[38px] xs:w-[38px] sm:h-[42px] sm:w-[42px]",s.barClass),children:e(v,{metric:s})})}),t("div",{className:o("ml-2 mr-2 flex-1 border-r border-dashed border-[#d9e0ea] pr-2 xs:ml-3 xs:mr-3 xs:pr-3 sm:pr-4",r?"w-[148px]":"min-w-0"),children:[e("h4",{className:o("truncate font-extrabold leading-5 text-[#0054A6]",r?"text-[15px]":"text-[13px] xs:text-[14px] sm:text-[15px]"),children:s.label}),e("span",{className:o("mt-0.5 block truncate text-[#8b97a8] sm:mt-1",r?"text-[11px]":"text-[10px] xs:text-[10.5px] sm:text-[11px]"),children:s.sublabel})]}),t("div",{className:o("shrink-0 font-extrabold text-[#0054A6]",r?"w-[86px] text-[18px]":"w-[60px] text-[16px] xs:w-[70px] xs:text-[17px] sm:w-20 sm:text-xl"),children:[l," ",e("small",{className:o("font-semibold text-[#c5ced8]",r?"text-[12px]":"text-[11px] xs:text-[11.5px] sm:text-[13px]"),children:a})]}),e("div",{className:o("ml-2 flex-1 overflow-hidden rounded-full bg-[#edf0f4] xs:ml-2.5 sm:ml-3",r?"h-[12px]":"h-[10px] sm:h-[11px]"),children:e("div",{className:o("h-full rounded-full",s.barClass),style:{width:`${s.score}%`}})})]})}export function PendingGradingCard({gradingStatus:s}){const l=g(s),a=s===c.FAILED;return t("div",{className:o("flex flex-col items-center justify-center gap-3 rounded-2xl border px-6 py-8 text-center",a?"border-orange-200 bg-orange-50":"border-[#dbeafe] bg-[#F4F9FF]"),children:[e("div",{className:o("flex h-14 w-14 items-center justify-center rounded-full",a?"bg-orange-100":"bg-[#E8F6FF]"),children:e(r,{className:o("h-7 w-7 animate-pulse",a?"text-orange-500":"text-[#00AEEF]")})}),t("div",{children:[e("p",{className:o("text-base font-bold",a?"text-orange-600":"text-[#0054A6]"),children:l}),e("p",{className:"mt-1 text-sm text-slate-500",children:"Kết quả sẽ được cập nhật sớm nhất có thể."})]})]})}export function NotAnsweredCard(){return t("div",{className:"flex flex-col items-center justify-center gap-3 rounded-2xl border border-slate-200 bg-slate-50 px-6 py-8 text-center",children:[e("div",{className:"flex h-14 w-14 items-center justify-center rounded-full bg-slate-100",children:e(i,{className:"h-7 w-7 text-slate-300"})}),t("div",{children:[e("p",{className:"text-base font-bold text-slate-500",children:"Học sinh chưa trả lời câu hỏi"}),e("p",{className:"mt-1 text-sm text-slate-400",children:"Câu hỏi này không có bài ghi âm."})]})]})}export function QuestionScorePill({question:s}){return s.gradingStatus===c.NOT_ANSWERED?t("div",{className:"inline-flex items-center rounded-full bg-slate-100 px-3.5 py-2 text-sm font-bold text-slate-500 shadow-sm ring-1 ring-slate-200",children:["Bỏ qua — 0 / ",b(s.maxScore,0)]}):w(s.gradingStatus)?e("div",{className:"inline-flex items-center rounded-full bg-[#E8F6FF] px-3.5 py-2 text-sm font-extrabold text-[#0054A6] shadow-sm ring-1 ring-[#b9dcff]",children:null==s.score?`Chưa chấm / ${b(s.maxScore,0)}`:`${b(s.score,2)} / ${b(s.maxScore,0)}`}):t("div",{className:"inline-flex items-center gap-1.5 rounded-full bg-[#FFF8E8] px-3.5 py-2 text-sm font-bold text-[#D97706] shadow-sm ring-1 ring-[#fcd34d]",children:[e(r,{className:"h-3.5 w-3.5"}),"Chờ chấm"]})}export function PromptBlock({question:s}){const r=s.questionContent??{},l=r.imageUrl||r.image||r.promptImageUrl,a=s.audioUrl||r.audioUrl||r.audio||r.questionAudio,n=u(s);return t("div",{className:"rounded-xl border border-[#dbeafe] bg-[#F8FBFF] px-4 py-3",children:[e("div",{className:"mb-2 text-xs font-bold uppercase tracking-wide text-[#00AEEF]",children:"Câu hỏi"}),n.text&&"Nội dung câu hỏi đang được cập nhật."!==n.text&&(n.isHtml?e("div",{className:"mb-3 text-sm leading-relaxed text-slate-700 [&_ul]:list-disc [&_ul]:pl-5 [&_ol]:list-decimal [&_ol]:pl-5 [&_li]:my-0.5 [&_p]:my-1",dangerouslySetInnerHTML:{__html:n.text}}):e("p",{className:"mb-3 text-center text-sm leading-relaxed text-slate-700",children:n.text})),a?e("div",{className:"mb-3",children:e(m,{audioKey:a})}):null,l?e("div",{className:"overflow-hidden rounded-lg border border-slate-200",children:e(x,{src:l,alt:"Question image",className:"h-auto w-full"})}):null]})}export function AnswerBlock({question:s}){const r=f(s);return s.studentAnswerKey?t("div",{className:"rounded-xl border border-slate-200 bg-white px-4 py-3",children:[t("div",{className:"mb-2.5 flex items-center gap-2 text-xs font-bold text-[#0054A6]",children:[e(i,{className:"h-3.5 w-3.5 text-[#00AEEF]"}),"Bài nói của học viên"]}),e(m,{audioKey:s.studentAnswerKey})]}):t("div",{className:"rounded-xl border border-slate-200 bg-slate-50 px-4 py-3",children:[e("div",{className:"mb-1.5 text-[10px] font-semibold uppercase tracking-wider text-slate-400",children:"Câu trả lời của học viên"}),e("p",{className:"text-sm leading-relaxed text-slate-600",children:r})]})}export function QuestionComponentScores({question:s}){const r=p(s);return t("div",{className:"rounded-[28px] border border-[#cfe4ff] bg-[#F3F8FF] px-4 py-5 md:px-5 md:py-6",children:[e("div",{className:"mb-5 text-center text-[20px] font-black uppercase tracking-tight text-[#0054A6]",children:"ĐIỂM THÀNH PHẦN"}),e("div",{className:"space-y-3",children:r.map(t=>e(SkillRow,{metric:t,compact:!0},`${s.questionId}-${t.key}`))})]})}export function FeedbackBlock({question:s}){return t("div",{className:"rounded-xl border border-[#ffe6b3] bg-[#FFF8E8] px-4 py-3",children:[t("div",{className:"mb-1.5 flex items-center gap-1.5 text-xs font-bold text-[#D97706]",children:[e(a,{className:"h-3.5 w-3.5"}),"Nhận xét AI"]}),e("p",{className:"text-sm leading-relaxed text-slate-700",children:h(s)})]})}export function QuestionCard({question:s}){const r=w(s.gradingStatus),l=s.gradingStatus===c.NOT_ANSWERED;return t("article",{className:"rounded-[28px] border border-[#cfe4ff] bg-white p-4 shadow-[0_10px_28px_rgba(15,23,42,0.06)] md:p-6",children:[e("div",{className:"mb-5 rounded-[22px] border border-[#dbeafe] bg-[linear-gradient(135deg,#f8fbff_0%,#eef6ff_100%)] px-4 py-4 md:px-5",children:t("div",{className:"flex flex-col gap-4 md:flex-row md:items-start md:justify-between",children:[t("div",{className:"min-w-0",children:[t("div",{className:"text-xl font-black text-[#0054A6]",children:["Câu ",s.questionNumber]}),e("div",{className:"mt-1 text-sm font-semibold text-slate-500",children:N(s.questionType)})]}),e("div",{className:"shrink-0 self-start",children:e(QuestionScorePill,{question:s})})]})}),t("div",r?{className:"grid gap-5 xl:grid-cols-[minmax(0,1fr)_minmax(0,1fr)] xl:items-start",children:[t("div",{className:"space-y-4",children:[e(PromptBlock,{question:s}),e(AnswerBlock,{question:s}),e(FeedbackBlock,{question:s})]}),e("aside",{className:"min-w-0",children:e(QuestionComponentScores,{question:s})})]}:l?{className:"space-y-4",children:[e(PromptBlock,{question:s}),e(NotAnsweredCard,{})]}:{className:"space-y-4",children:[e(PromptBlock,{question:s}),e(PendingGradingCard,{gradingStatus:s.gradingStatus})]})]})}

package/dist/components/results/report/SpeakingRubricSection.d.ts

@@ -0,0 +1,21 @@
+import type { SpeakingRubric } from '../../../api/result-review';
+export declare enum SpeakingRubricScoringVersion {
+    TEENS_FOCUS_PEARSON_V2 = "TEENS_FOCUS_PEARSON_V2",
+    PRESCHOOL_PLACEMENT_V1 = "PRESCHOOL_PLACEMENT_V1",
+    KINDY_PLACEMENT_V1 = "KINDY_PLACEMENT_V1"
+}
+export declare enum KidsRubricSectionCode {
+    WARM_UP = "WARM_UP",
+    PART_1 = "PART_1",
+    PART_2 = "PART_2",
+    PART_3 = "PART_3"
+}
+export interface SpeakingRubricSectionProps {
+    rubric: SpeakingRubric;
+    badgeNumber?: string;
+}
+/**
+ * Attempt-level speaking rubric breakdown for TEENS / PRESCHOOL / KINDY / KIDS.
+ * Source: oe-exam-fe/.../review/components/SpeakingRubricSection.tsx
+ */
+export declare function SpeakingRubricSection({ rubric, badgeNumber, }: SpeakingRubricSectionProps): import("react").JSX.Element;

package/dist/components/results/report/SpeakingRubricSection.js

@@ -0,0 +1 @@
+"use client";import{jsx as e,jsxs as n}from"react/jsx-runtime";import{Star as t}from"lucide-react";import{BadgeTitle as i}from"./BadgeTitle";export var SpeakingRubricScoringVersion;!function(e){e.TEENS_FOCUS_PEARSON_V2="TEENS_FOCUS_PEARSON_V2",e.PRESCHOOL_PLACEMENT_V1="PRESCHOOL_PLACEMENT_V1",e.KINDY_PLACEMENT_V1="KINDY_PLACEMENT_V1"}(SpeakingRubricScoringVersion||(SpeakingRubricScoringVersion={}));export var KidsRubricSectionCode;!function(e){e.WARM_UP="WARM_UP",e.PART_1="PART_1",e.PART_2="PART_2",e.PART_3="PART_3"}(KidsRubricSectionCode||(KidsRubricSectionCode={}));const c={[SpeakingRubricScoringVersion.TEENS_FOCUS_PEARSON_V2]:{C1:{vi:"Ngữ pháp & Từ vựng",en:"Grammar & Vocabulary",hint:"Cấu trúc câu, thì động từ và độ đa dạng từ vựng"},C2:{vi:"Phát âm",en:"Pronunciation",hint:"Độ rõ ràng, trọng âm từ và ngữ điệu câu"},C3:{vi:"Giao tiếp tương tác",en:"Interactive Communication",hint:"Phản hồi đủ ý và tự mở rộng câu trả lời"},C4:{vi:"Quản lý diễn ngôn",en:"Discourse Management",hint:"Mạch lạc, tổ chức và phát triển ý rõ ràng"}},[SpeakingRubricScoringVersion.PRESCHOOL_PLACEMENT_V1]:{C1:{vi:"Nhận biết số đếm (1–10)",en:"Cardinal Numbers (1–10)",hint:"Đếm 1–10 và nhận ra từng số"},C2:{vi:"Nhận biết màu sắc",en:"Basic Colours",hint:"Gọi tên màu sắc và màu yêu thích"},C3:{vi:"Nhận biết hình học",en:"Basic Shapes",hint:"Gọi tên các hình cơ bản"},C4:{vi:"Nhận biết động vật",en:"Animals",hint:"Gọi tên động vật và con vật yêu thích"}},[SpeakingRubricScoringVersion.KINDY_PLACEMENT_V1]:{C1:{vi:"Chào hỏi & Giới thiệu bản thân",en:"Greeting & Self-Introduction",hint:"Giao tiếp xã hội cơ bản"},C2:{vi:"Nhận biết số đếm (1–20)",en:"Cardinal Numbers (1–20)",hint:"Từ vựng số học"},C3:{vi:"Đọc bảng chữ cái",en:"The Alphabet",hint:"Nhận biết chữ cái"},C4:{vi:"Nhận biết hình dạng",en:"Shapes",hint:"Từ vựng hình học"},C5:{vi:"Nhận biết màu sắc",en:"Colours",hint:"Từ vựng màu sắc"},C6:{vi:"Nhận biết động vật",en:"Animals",hint:"Từ vựng chủ đề quen thuộc"},C7:{vi:"Nhận biết thức ăn",en:"Food/Drinks",hint:"Từ vựng chủ đề quen thuộc"}}},r={5:{text:"#166534",bg:"#dcfce7",accent:"#16a34a"},4:{text:"#15803d",bg:"#dcfce7",accent:"#22c55e"},3:{text:"#b45309",bg:"#fef3c7",accent:"#f59e0b"},2:{text:"#c2410c",bg:"#ffedd5",accent:"#f97316"},1:{text:"#b91c1c",bg:"#fee2e2",accent:"#ef4444"}},a={5:"Excellent",4:"Good",3:"Adequate",2:"Weak",1:"Very weak"},s={5:"Vượt kỳ vọng",4:"Đáp ứng kỳ vọng (Cao)",3:"Đáp ứng kỳ vọng (Thấp)",2:"Dưới kỳ vọng",1:"Không thực hiện"},l={[SpeakingRubricScoringVersion.TEENS_FOCUS_PEARSON_V2]:a,[SpeakingRubricScoringVersion.PRESCHOOL_PLACEMENT_V1]:s,[SpeakingRubricScoringVersion.KINDY_PLACEMENT_V1]:s},o={[KidsRubricSectionCode.WARM_UP]:{vi:"Khởi động",en:"Warm-up Questions"},[KidsRubricSectionCode.PART_1]:{vi:"Part 1 — Nhận diện qua tranh",en:"Picture Identification"},[KidsRubricSectionCode.PART_2]:{vi:"Part 2 — Đọc và cung cấp thông tin",en:"Reading and Giving Information"},[KidsRubricSectionCode.PART_3]:{vi:"Part 3 — Mô tả tranh",en:"Picture Description"}};function d({score:n}){const i=Math.max(0,Math.min(5,Math.round(n)));return e("span",{className:"inline-flex items-center gap-0.5","aria-label":`${i}/5`,children:Array.from({length:5}).map((n,c)=>e(t,{"aria-hidden":!0,className:c<i?"h-4 w-4 fill-[#FFC107] text-[#FFC107]":"h-4 w-4 fill-[#e6edf5] text-[#e6edf5]"},c))})}function h({rubric:t}){const i=c[t.scoringVersion]??{},s=l[t.scoringVersion]??a;return e("div",{className:"overflow-hidden rounded-xl border border-[#00AEEF]/20 shadow-sm",children:e("div",{className:"overflow-x-auto",children:n("table",{className:"w-full min-w-[640px] text-left text-sm text-slate-700",children:[e("thead",{className:"border-b border-[#00AEEF]/20 bg-[#f0f8ff] text-[#0054A6]",children:n("tr",{className:"text-center",children:[e("th",{scope:"col",className:"w-[30%] border-r border-[#00AEEF]/10 px-4 py-3 font-bold",children:"Tiêu chí"}),e("th",{scope:"col",className:"border-r border-[#00AEEF]/10 px-4 py-3 font-bold",children:"Nhận xét chi tiết"}),e("th",{scope:"col",className:"w-[22%] px-4 py-3 font-bold",children:"Điểm"})]})}),e("tbody",{className:"divide-y divide-slate-100",children:t.criteria.map(t=>{const c=i[t.code]??{vi:t.code,en:"",hint:""},a=Math.round(t.score),l=Math.max(1,Math.min(5,a)),o=s[l],h=r[l];return n("tr",{className:"align-top transition-colors hover:bg-slate-50/70",children:[n("td",{className:"border-r border-[#00AEEF]/10 px-4 py-4",style:{boxShadow:`inset 4px 0 0 ${h.accent}`},children:[e("div",{className:"font-bold text-slate-800",children:c.vi}),c.en?e("div",{className:"text-xs italic text-slate-500",children:c.en}):null,c.hint?e("div",{className:"mt-1 text-[11px] leading-snug text-slate-400",children:c.hint}):null]}),e("td",{className:"border-r border-[#00AEEF]/10 px-4 py-4 leading-relaxed text-slate-700",children:t.evidence?.trim()?t.evidence:e("span",{className:"italic text-slate-400",children:"Không có nhận xét chi tiết."})}),n("td",{className:"px-4 py-4",children:[e(d,{score:t.score}),n("div",{className:"mt-1.5 flex items-baseline gap-1",children:[e("span",{className:"text-lg font-black leading-none text-[#0054A6]",children:a}),e("span",{className:"text-xs font-semibold text-slate-400",children:"/ 5"})]}),o?e("span",{className:"mt-1.5 inline-block whitespace-nowrap rounded-full px-2.5 py-0.5 text-xs font-bold",style:{backgroundColor:h.bg,color:h.text},children:o}):null]})]},t.code)})})]})})})}function m({section:t}){const i=o[t.code]??{vi:t.code,en:""},c=t.maxScore>0?Math.max(0,Math.min(100,t.score/t.maxScore*100)):0;return n("div",{className:"overflow-hidden rounded-xl border border-[#00AEEF]/20 shadow-sm",children:[n("div",{className:"flex flex-col gap-2 border-b border-[#00AEEF]/20 bg-[#f0f8ff] px-4 py-3 sm:flex-row sm:items-center sm:justify-between",children:[n("div",{children:[e("div",{className:"font-bold text-[#0054A6]",children:i.vi}),i.en?e("div",{className:"text-xs italic text-slate-500",children:i.en}):null]}),n("div",{className:"flex items-center gap-3",children:[e("div",{className:"h-[9px] w-24 overflow-hidden rounded-full bg-[#e6edf5]",children:e("div",{className:"h-full rounded-full bg-[#4CAF50]",style:{width:`${c}%`}})}),n("div",{className:"whitespace-nowrap text-sm font-black text-[#0054A6]",children:[t.score,n("span",{className:"text-xs font-semibold text-slate-400",children:[" / ",t.maxScore]})]})]})]}),e("table",{className:"w-full text-left text-sm text-slate-700",children:e("tbody",{className:"divide-y divide-[#00AEEF]/10",children:t.questions.map(t=>n("tr",{className:"align-top hover:bg-slate-50",children:[e("td",{className:"w-[72px] px-4 py-3",children:n("span",{className:"inline-flex h-7 min-w-7 items-center justify-center rounded-full bg-[#eaf4ff] px-2 text-xs font-black text-[#0054A6]",children:["Câu ",t.questionNo]})}),n("td",{className:"w-[88px] whitespace-nowrap px-2 py-3 font-black text-[#0054A6]",children:[t.score,n("span",{className:"text-xs font-semibold text-slate-400",children:[" / ",t.maxScore]})]}),e("td",{className:"px-4 py-3 leading-relaxed text-slate-700",children:t.evidence?.trim()?t.evidence:e("span",{className:"italic text-slate-400",children:"Không có nhận xét chi tiết."})})]},t.questionNo))})})]})}export function SpeakingRubricSection({rubric:t,badgeNumber:c="4"}){const r=t.criteria?.length>0,a=(t.sections?.length??0)>0;return r||a?n("section",{className:"relative mt-8 rounded-[20px] border-2 border-[#00AEEF] px-5 pb-6 pt-11 md:px-8",children:[e(i,{number:c,title:"ĐÁNH GIÁ KỸ NĂNG NÓI"}),a?e("div",{className:"space-y-4",children:(t.sections??[]).map(n=>e(m,{section:n},n.code))}):e(h,{rubric:t})]}):null}

package/dist/components/results/report/speaking-report.utils.d.ts

@@ -0,0 +1,37 @@
+import type { SpeakingReviewPart, SpeakingReviewQuestion } from '../utils/transform-speaking-review';
+import { type SkillMetric as SharedSkillMetric } from '../utils/speaking-summary';
+export type LocalizedText = string | {
+    vi?: string;
+    en?: string;
+} | null | undefined;
+export type SkillUiIcon = 'speaker' | 'bolt' | 'message' | 'check-double' | 'music';
+export interface SkillMetric extends SharedSkillMetric {
+    icon: SkillUiIcon;
+    colorVarClass: string;
+    barClass: string;
+}
+export declare const SKILL_UI_BY_KEY: Record<SharedSkillMetric['key'], Pick<SkillMetric, 'icon' | 'colorVarClass' | 'barClass'>>;
+export declare function withUi(metric: SharedSkillMetric): SkillMetric;
+export declare function getLocalizedText(value: LocalizedText): string;
+export declare function formatScore(score: number | null | undefined, digits?: number): string;
+/** Format total score for "ĐIỂM TỔNG" display */
+export declare function formatTotalScore(score: number | null | undefined): string;
+export declare function getScoreStroke(totalScore: number | null, maxScore: number, isPendingGrading: boolean): string;
+export declare function getQuestionTypeLabel(questionType: string): string;
+export declare function isGradingComplete(gradingStatus: string | null | undefined): boolean;
+export declare function getPendingGradingLabel(gradingStatus: string | null | undefined): string;
+export declare function deriveQuestionSkillMetrics(question: SpeakingReviewQuestion): SkillMetric[];
+export declare function extractPrompt(question: SpeakingReviewQuestion): {
+    text: string;
+    isHtml: boolean;
+};
+export declare function extractStudentAnswerText(question: SpeakingReviewQuestion): string;
+export declare function extractQuestionFeedback(question: SpeakingReviewQuestion): string;
+export declare function getPartScore(part: SpeakingReviewPart): {
+    score: number | null;
+    maxScore: number;
+    hasPending: boolean;
+};
+export declare function resolveAssetUrl(asset: {
+    src: string;
+} | string, assetBaseUrl?: string, fileName?: string): string;

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

@@ -0,0 +1 @@
+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}

package/dist/components/results/review-data.d.ts

@@ -1,2 +1,3 @@
 import type { ReviewAnswer, ReviewTransformResult, ResultReviewTemplatePart } from './review-types';
 export declare function transformResultAnswersForReview(answers: ReviewAnswer[], templateParts?: ResultReviewTemplatePart[]): ReviewTransformResult;
+export declare const transformDetailedResultForReview: typeof transformResultAnswersForReview;

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

@@ -1 +1 @@
-export function transformResultAnswersForReview(r,n=[]){const o=new Map;for(const t of r){const e=[t.partId??"unknown",t.questionGroup?.id??"none",t.questionType].join(":");o.set(e,[...o.get(e)??[],t])}const i={parts:[],studentAnswers:{},isCorrectMap:{},correctAnswerTextMap:{},correctOptionIdMap:{},essayGradingMap:{},partScoresMap:{},rawCorrectAnswerMap:{},rawStudentAnswerMap:{},questionScoreMap:{}},u=[];for(const r of o.values()){r.sort((t,e)=>t.questionNumber-e.questionNumber);const o=r[0];if(!o)continue;const a=n.find(t=>String(t.id)===String(o.partId)),c=o.partNo??s(a?.name)??0;i.parts.push({partId:o.partId,partNo:c,questionType:o.questionType,name:a?.name,instructions:a?.instructions,audioUrl:a?.audioUrl,questions:r.map(t)});const p=r.filter(t=>!t.isExample);u.push({score:p.reduce((t,e)=>t+(e.score??0),0),maxScore:p.reduce((t,e)=>t+e.maxScore,0),correctCount:p.filter(t=>!0===t.isCorrect).length,totalCount:p.length});for(const t of r)e(i,t)}const a=i.parts.map((t,e)=>e).sort((t,e)=>i.parts[t].partNo-i.parts[e].partNo||(i.parts[t].questions[0]?.question_number??0)-(i.parts[e].questions[0]?.question_number??0));return i.parts=a.map(t=>i.parts[t]),a.forEach((t,e)=>{i.partScoresMap[e]=u[t]}),i}function t(t){return{id:t.questionId,content:t.questionContent,correct_answer:t.correctAnswer,total_points:String(t.maxScore),question_type:t.questionType,is_example:t.isExample??!1,explanation:t.explanation??"",difficult_level:"MEDIUM",question_skill_type:"",exam_id:"",part_id:t.partId??"",part_no:t.partNo??0,question_number:t.questionNumber,questionGroup:t.questionGroup??null}}function e(t,e){const s=function(t,e,o){const s=n(o);if(null==o)return;if("CHOOSE_THE_CORRECT_ANSWER"===e)return r(t,o);if(["FILL_IN_BLANK","WRITE_CORRECT_VERB_FORM","ANSWER_THE_QUESTION","TRUE_FALSE","WRITE_SENTENCES"].includes(e))return"string"==typeof o?o:s.answer??o;return"READ_AND_COLOR_OBJECTS"===e||"IMAGE_OBJECT_MATCHING"===e?s.answers??o:e.startsWith("LISTEN_AND_")?o:s.answer??o}(e.questionId,e.questionType,e.studentAnswer);void 0!==s&&(t.studentAnswers[e.questionId]=s),t.isCorrectMap[e.questionId]=e.isCorrect,t.rawCorrectAnswerMap[e.questionId]=e.correctAnswer,t.rawStudentAnswerMap[e.questionId]=e.studentAnswer,t.questionScoreMap[e.questionId]={score:e.score,maxScore:e.maxScore};const i=function(t){const e=n(t);if("string"==typeof e.answer)return e.answer;if("string"==typeof e.correctAnswer)return e.correctAnswer;const r=e.answers;return Array.isArray(r)?String(r[0]??""):r&&"object"==typeof r?String(Object.values(r)[0]??""):""}(e.correctAnswer);i&&(t.correctAnswerTextMap[e.questionId]=i);const u=r(e.questionId,e.correctAnswer);if(u&&(t.correctOptionIdMap[e.questionId]=u),"CHOOSE_CORRECT_ADJECTIVE"===e.questionType){const r=o(e.studentAnswer,"answer"),n=o(e.correctAnswer,"answer");void 0!==r&&(t.studentAnswers[e.questionId]=`${e.questionId}-opt-${r}`),void 0!==n&&(t.correctOptionIdMap[e.questionId]=`${e.questionId}-opt-${n}`)}"WRITE_A_SHORT_LETTER"!==e.questionType&&"WRITE_SHORT_PARAGRAPH"!==e.questionType||(t.essayGradingMap[e.questionId]={score:e.teacherScore??e.score,maxScore:e.maxScore,teacherFeedback:e.teacherFeedback??null})}function r(t,e){const r=n(e).answer;return"number"==typeof r?`${t}-opt-${r}`:"string"==typeof r?r:Array.isArray(r)?r.map(e=>"number"==typeof e?`${t}-opt-${e}`:String(e)).join(","):""}function n(t){return"object"==typeof t&&null!==t?t:{}}function o(t,e){const r=n(t)[e];return"number"==typeof r?r:void 0}function s(t){const e=t?.match(/\d+/);return e?Number(e[0]):void 0}
+const e=new Set(["READ_PASSAGE_AND_ANSWER_QUESTIONS","LOOK_PICTURE_FILL_WORD_HINT","LABEL_THE_PICTURE","READ_AND_COLOR_OBJECTS","IMAGE_OBJECT_MATCHING"]);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),a={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=i(u?.name)??o.partNo??0;a.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(a,e))}const u=a.parts.map((e,r)=>r).sort((e,r)=>{const t=a.parts[e],n=a.parts[r];return t.partNo-n.partNo||(t.questions[0]?.question_number??0)-(n.questions[0]?.question_number??0)});return a.parts=u.map(e=>a.parts[e]),u.forEach((e,r)=>{a.partScoresMap[r]=c[e]}),a}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"===r||"CHOOSE_CORRECT_ADJECTIVE"===r){const r=s(e,n.answer);return r.length>1?r:r[0]}if("READ_PASSAGE_AND_ANSWER_QUESTIONS"===r&&a(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)&&a(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(","));"READ_PASSAGE_AND_ANSWER_QUESTIONS"===r.questionType&&a(t.answers)&&Object.entries(t.answers).forEach(([r,t])=>{"number"==typeof t&&(e.correctOptionIdMap[r]=`${r}-opt-${t}`)});const i=function(e){if(Array.isArray(e.answers))return e.answers.map(String);if(a(e.answers))return Object.values(e.answers).map(String);const r=e.answer??e.correctAnswer;return null==r?[]:[String(r)]}(t);i[0]&&(e.correctAnswerTextMap[r.questionId]=i[0]);"WORD_FILL_PARAGRAPH"===r.questionType&&i.forEach((t,n)=>{e.correctAnswerTextMap[`${r.questionId}-blank-${n}`]=t});"LABEL_THE_PICTURE"===r.questionType&&a(t.labels)&&Object.entries(t.labels).forEach(([r,t])=>{e.correctAnswerTextMap[r]=String(t)});"FILL_MISSING_WORDS_IN_GRID"===r.questionType&&a(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})}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 a(e)?e:{}}function a(e){return"object"==typeof e&&null!==e&&!Array.isArray(e)}function i(e){const r=e?.match(/\d+/);return r?Number(r[0]):void 0}

package/dist/components/results/review-status.utils.d.ts

@@ -0,0 +1,12 @@
+/** Status & access helpers for the result review screen. */
+/**
+ * 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 declare function isResultNotPublic(error: unknown, hasToken: boolean): boolean;
+/**
+ * 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 declare function setPdfReady(ready: boolean): void;

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

@@ -0,0 +1 @@
+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"))}

package/dist/components/results/review-types.d.ts

@@ -26,9 +26,16 @@ export interface PartScoreInfo {
 export interface ReviewTransformResult {
     parts: ReviewQuestionPart[];
     studentAnswers: ReviewAnswerMap;
+    correctAnswersMap: Map<string, unknown>;
     isCorrectMap: CorrectMap;
     correctAnswerTextMap: Record<string, string>;
     correctOptionIdMap: Record<string, string>;
+    cellAnswersMap: Record<string, {
+        cells: Record<string, {
+            correctAnswer: string;
+        }>;
+        caseSensitive: boolean;
+    }>;
     essayGradingMap: Record<string, EssayGradingInfo>;
     partScoresMap: Record<number, PartScoreInfo>;
     rawCorrectAnswerMap: Record<string, unknown>;
@@ -44,6 +51,13 @@ export interface ResultReviewTemplatePart {
     instructions?: string;
     audioUrl?: string;
     questionType?: string;
+    sections?: Array<{
+        sectionId?: number;
+        name?: string;
+        instructions?: string;
+        startIndex?: number;
+        endIndex?: number;
+    }>;
 }
 export type ReviewQuestion = ExamTakingQuestion & {
     explanation?: string | null;

package/dist/components/results/speaking/SpeakingResultAudioPlayer.d.ts

@@ -0,0 +1,17 @@
+export type SpeakingResultAudioPlayerVariant = 'student' | 'admin';
+export interface SpeakingResultAudioPlayerProps {
+    /** S3 key or displayable URL for the recorded audio answer */
+    audioKey: string;
+    /**
+     * Visual theme variant.
+     * - student (default): ocean-blue
+     * - admin: neutral gray
+     */
+    variant?: SpeakingResultAudioPlayerVariant;
+    /**
+     * Optional verification token. Hosts that resolve storage keys can pass this
+     * through their own fetcher; the default SDK hook is a pass-through.
+     */
+    token?: string | null;
+}
+export declare function SpeakingResultAudioPlayer({ audioKey, variant, token: _token, }: SpeakingResultAudioPlayerProps): import("react").JSX.Element;

package/dist/components/results/speaking/SpeakingResultAudioPlayer.js

@@ -0,0 +1 @@
+"use client";import{jsx as e,jsxs as t}from"react/jsx-runtime";import{useCallback as r,useRef as a,useState as n}from"react";import{Loader2 as i,Mic as s,Pause as l,Play as o,RefreshCw as d}from"lucide-react";import{usePresignedFileUrl as u}from"../../../shared/lib/hooks/usePresignedFileUrl";import{cn as c}from"../../../shared/lib/utils";function m(e){if(!isFinite(e)||isNaN(e))return"--:--";return`${Math.floor(e/60)}:${Math.floor(e%60).toString().padStart(2,"0")}`}export function SpeakingResultAudioPlayer({audioKey:h,variant:b="student",token:g=null}){const{previewUrl:p,isLoading:x,error:f}=u(h),w=a(null),[y,N]=n(!1),[v,k]=n(0),[_,A]=n(0),j=r(()=>{const e=w.current;e&&p&&(y?e.pause():e.play().catch(e=>{console.error("Audio play failed:",e)}))},[y,p]),T=r(e=>{const t=w.current;if(!t)return;const r=Number(e.target.value);t.currentTime=r,k(r)},[]),P=r(()=>{const e=w.current;e&&k(e.currentTime)},[]),M=r(()=>{const e=w.current;e&&A(e.duration||0)},[]),S=r(()=>{N(!1),k(0);const e=w.current;e&&(e.currentTime=0)},[]),U=_>0?v/_*100:0,$="admin"===b;return t("div",x?{className:c("flex items-center justify-center gap-2 rounded-xl px-4 py-3.5",$?"bg-gray-100":"bg-gradient-to-r from-[#2874A6] to-[#3498DB]"),children:[e(i,{className:c("h-4 w-4 animate-spin",$?"text-gray-500":"text-white/80")}),e("span",{className:c("text-sm font-medium",$?"text-gray-600":"text-white/80"),children:"Đang tải âm thanh..."})]}:f||!p?{className:"flex items-center gap-2.5 rounded-xl border border-red-200 bg-red-50 px-4 py-3",children:[e(d,{className:"h-4 w-4 text-red-400"}),e("span",{className:"text-sm font-medium text-red-600",children:"Không thể phát âm thanh"})]}:{className:"overflow-hidden rounded-2xl border border-gray-100 bg-white shadow-[0_2px_12px_rgba(0,0,0,0.02)] transition-all hover:shadow-[0_4px_16px_rgba(0,0,0,0.04)] ring-1 ring-gray-900/5",children:[e("audio",{ref:w,src:p,onPlay:()=>N(!0),onPause:()=>N(!1),onTimeUpdate:P,onLoadedMetadata:M,onEnded:S,preload:"metadata"}),t("div",{className:"flex items-center gap-3 px-4 py-3",children:[e("div",{className:c("flex h-9 w-9 shrink-0 items-center justify-center rounded-full transition-all",y?"bg-blue-50 ring-4 ring-blue-50/50":"bg-gray-50"),children:e(s,{className:c("h-4 w-4 transition-transform",y?"text-[#2874A6] animate-pulse":"text-gray-400")})}),e("button",{type:"button",onClick:j,className:c("flex h-10 w-10 shrink-0 items-center justify-center rounded-full shadow-sm transition-all active:scale-95",$?y?"bg-gray-600 text-white hover:bg-gray-700":"bg-gray-500 text-white hover:bg-gray-600":y?"bg-[#1A5276] text-white hover:bg-[#154360]":"bg-[#2874A6] text-white hover:bg-[#1A5276]"),"aria-label":y?"Tạm dừng":"Phát",children:y?e(l,{className:"h-4 w-4"}):e(o,{className:"h-4 w-4 ml-0.5"})}),t("div",{className:"flex flex-1 flex-col gap-1.5 px-2",children:[t("div",{className:"flex items-center justify-between",children:[e("span",{className:"text-[10px] font-bold tabular-nums text-gray-500 tracking-wide",children:m(v)}),e("span",{className:"text-[10px] font-bold tabular-nums text-gray-400 tracking-wide",children:_>0?m(_):"--:--"})]}),t("div",{className:"relative flex h-2 items-center",children:[e("input",{type:"range",min:0,max:_||1,step:.1,value:v,onChange:T,className:c("absolute inset-0 z-10 h-1.5 w-full cursor-pointer appearance-none rounded-full bg-transparent","[&::-webkit-slider-thumb]:h-3.5 [&::-webkit-slider-thumb]:w-3.5","[&::-webkit-slider-thumb]:appearance-none","[&::-webkit-slider-thumb]:rounded-full","[&::-webkit-slider-thumb]:bg-white","[&::-webkit-slider-thumb]:shadow-[0_1px_4px_rgba(0,0,0,0.2)]","[&::-webkit-slider-thumb]:border [&::-webkit-slider-thumb]:border-gray-200","[&::-webkit-slider-thumb]:transition-transform","[&::-webkit-slider-thumb]:hover:scale-110"),"aria-label":"Tiến trình phát"}),e("div",{className:"pointer-events-none absolute left-0 right-0 h-1.5 rounded-full bg-gray-100"}),e("div",{className:c("pointer-events-none absolute left-0 h-1.5 rounded-full transition-all duration-100 ease-linear",$?"bg-blue-500":"bg-gradient-to-r from-[#2874A6] to-[#3498DB]"),style:{width:`${U}%`}})]})]})]})]})}

package/dist/components/results/speaking/SpeakingReviewResult.d.ts

@@ -0,0 +1,30 @@
+import { type ReactNode } from 'react';
+import type { SpeakingRubric } from '../../../api/result-review';
+import type { SpeakingReviewData } from '../utils/transform-speaking-review';
+export declare const SPEAKING_REVIEW_POLL_INTERVAL_MS = 5000;
+export interface SpeakingReviewResultProps {
+    reviewData: SpeakingReviewData;
+    studentName?: string | null;
+    studentCode?: string | null;
+    branchName?: string | null;
+    examDateText?: string;
+    examTitle?: string | null;
+    showDetailedResults?: boolean;
+    speakingRubric?: SpeakingRubric | null;
+    reviewUrl?: string;
+    assetBaseUrl?: string;
+    canExportPdf?: boolean;
+    isExporting?: boolean;
+    /** True when any question is still in a pollable grading status. */
+    hasPendingQuestions?: boolean;
+    onBack?: () => void;
+    onExportPdf?: () => void | Promise<void>;
+    topActionsSlot?: ReactNode;
+    beforeReportSlot?: ReactNode;
+    afterReportSlot?: ReactNode;
+}
+/**
+ * Speaking review page shell (toolbar + banners + report).
+ * Source: oe-exam-fe/.../speaking-review/page.tsx (SDK-owned portion only).
+ */
+export declare function SpeakingReviewResult({ reviewData, studentName, studentCode, branchName, examDateText, examTitle, showDetailedResults, speakingRubric, reviewUrl, assetBaseUrl, canExportPdf, isExporting: isExportingProp, hasPendingQuestions, onBack, onExportPdf, topActionsSlot, beforeReportSlot, afterReportSlot, }: SpeakingReviewResultProps): import("react").JSX.Element;

package/dist/components/results/speaking/SpeakingReviewResult.js

@@ -0,0 +1 @@
+"use client";import{jsx as e,jsxs as t,Fragment as a}from"react/jsx-runtime";import{useMemo as s,useState as r}from"react";import{AlertTriangle as i,ChevronLeft as n,Download as l,Loader2 as o,Sparkles as d}from"lucide-react";import{OceanEduSpeakingReport as c}from"../report/OceanEduSpeakingReport";export const SPEAKING_REVIEW_POLL_INTERVAL_MS=5e3;export function SpeakingReviewResult({reviewData:m,studentName:h,studentCode:u,branchName:f,examDateText:p,examTitle:x,showDetailedResults:b,speakingRubric:g,reviewUrl:v,assetBaseUrl:w,canExportPdf:N=!1,isExporting:y,hasPendingQuestions:E=!1,onBack:A,onExportPdf:D,topActionsSlot:k,beforeReportSlot:R,afterReportSlot:S}){const[F,P]=r(!1),T=y??F,j=s(()=>{if(p)return p;if(m.submittedAt){const e=new Date(m.submittedAt);if(!Number.isNaN(e.getTime()))return e.toLocaleDateString("vi-VN")}return(new Date).toLocaleDateString("vi-VN")},[p,m.submittedAt]);return e("div",{className:"min-h-screen bg-[#e0e0e0] py-4 md:py-6",children:t("div",{className:"mx-auto flex w-full max-w-[1160px] flex-col gap-4 px-0 sm:px-4",children:[t("div",{className:"flex items-center justify-between gap-3 px-3 print:hidden sm:px-0",children:[t("button",{type:"button",onClick:()=>{A?A():"undefined"!=typeof window&&window.history.back()},className:"inline-flex items-center gap-2 rounded-xl border border-slate-200 bg-white px-4 py-2.5 text-sm font-semibold text-slate-700 shadow-sm transition hover:border-slate-300 hover:bg-slate-50",children:[e(n,{className:"h-4 w-4"}),"Quay lại"]}),t("div",{className:"flex items-center gap-2",children:[N&&D?t("button",{type:"button",onClick:()=>{(async()=>{if(D){void 0===y&&P(!0);try{await D()}finally{void 0===y&&P(!1)}}})()},disabled:T,className:"group relative inline-flex items-center gap-2.5 overflow-hidden rounded-xl bg-gradient-to-r from-[#00AEEF] via-[#0099D6] to-[#00AEEF] bg-[length:200%_100%] px-5 py-3 text-sm font-bold text-white shadow-lg shadow-[#00AEEF]/30 transition-all duration-300 hover:bg-[position:100%_0] hover:shadow-xl hover:shadow-[#00AEEF]/40 hover:scale-[1.02] active:scale-[0.98] disabled:opacity-50 disabled:cursor-not-allowed disabled:hover:scale-100 disabled:hover:shadow-lg focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[#00AEEF] focus-visible:ring-offset-2",children:[e("span",{className:"absolute inset-0 -translate-x-full bg-gradient-to-r from-transparent via-white/20 to-transparent transition-transform duration-1000 group-hover:translate-x-full"}),t(a,T?{children:[e(o,{className:"relative z-10 h-4 w-4 animate-spin"}),e("span",{className:"relative z-10",children:"Đang xuất..."})]}:{children:[e(l,{className:"relative z-10 h-4 w-4 transition-transform duration-300 group-hover:-translate-y-0.5 group-hover:scale-110"}),e("span",{className:"relative z-10",children:"Xuất PDF"})]})]}):null,k]})]}),E?t("div",{className:"flex items-center gap-3 rounded-2xl border border-[#b3dfff] bg-gradient-to-r from-[#e8f6ff] to-[#f0f8ff] px-5 py-4 shadow-sm",children:[e("div",{className:"flex h-10 w-10 shrink-0 items-center justify-center rounded-full bg-[#d0edff]",children:e(d,{className:"h-5 w-5 animate-pulse text-[#00AEEF]"})}),t("div",{className:"flex-1",children:[e("p",{className:"text-sm font-bold text-[#0054A6]",children:"AI đang chấm điểm..."}),t("p",{className:"text-xs text-[#0078c8]",children:["Trang sẽ tự động cập nhật sau mỗi ",5," giây cho đến khi hoàn tất."]})]})]}):null,m.isPendingGrading?t("div",{className:"flex items-center gap-3 rounded-2xl border border-amber-200 bg-gradient-to-r from-amber-50 to-yellow-50 px-5 py-4 shadow-sm",children:[e("div",{className:"flex h-10 w-10 shrink-0 items-center justify-center rounded-full bg-amber-100",children:e(i,{className:"h-5 w-5 text-amber-600"})}),t("div",{children:[e("p",{className:"text-sm font-bold text-amber-800",children:"Đang chờ chấm điểm"}),e("p",{className:"text-xs text-amber-600",children:"Giáo viên sẽ chấm điểm bài thi của bạn sớm nhất có thể."})]})]}):null,R,e(c,{reviewData:m,studentName:h??m.studentName,studentCode:u,branchName:f,examDateText:j,examTitle:x,showDetailedResults:b,reviewUrl:v,speakingRubric:g,assetBaseUrl:w}),S]})})}

package/dist/components/results/utils/review-score.utils.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Score display helpers for the general (non-speaking) exam result report.
+ * Source thresholds mirror oe-exam-fe OceanEduExamReport.
+ */
+/** Percentage bands for general exam total-score labels / messages. */
+export declare const ReviewScoreBand: {
+    readonly EXCELLENT: 90;
+    readonly GOOD: 80;
+    readonly FAIR: 65;
+    readonly AVERAGE: 50;
+};
+export declare function formatScore(score: number | null | undefined, digits?: number): string;
+/** Format total score for "ĐIỂM TỔNG" display. */
+export declare function formatTotalScore(score: number | null | undefined): string;
+export declare function getScoreStroke(totalScore: number | null, maxScore: number, isPendingGrading: boolean): string;
+export declare function getScoreLabel(totalScore: number | null, maxScore: number, isPendingGrading: boolean): string;
+/**
+ * Score-aware mascot message. Mirrors {@link getScoreLabel} thresholds so the
+ * encouragement text matches the actual result.
+ */
+export declare function getScoreMessage(totalScore: number | null, maxScore: number, isPendingGrading: boolean): string;

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

@@ -0,0 +1 @@
+export const ReviewScoreBand={EXCELLENT:90,GOOD:80,FAIR:65,AVERAGE:50};export function formatScore(n,e=1){if(null==n||Number.isNaN(n))return"—";return n.toFixed(e).replace(/\.0+$/,"").replace(/(\.\d*[1-9])0+$/,"$1")}export function formatTotalScore(n){return null!=n&&Number.isFinite(n)?n<10?n.toFixed(1):String(Math.round(n)):"—"}export function getScoreStroke(n,e,i){if(i||null==n||e<=0)return"conic-gradient(#cbd5e1 0% 100%, #eef5ff 100% 100%)";const t=Math.max(0,Math.min(100,n/e*100));return`conic-gradient(#00AEEF 0% ${t}%, #eef5ff ${t}% 100%)`}export function getScoreLabel(n,e,i){if(i||null==n||e<=0)return"Đang chấm điểm";const t=n/e*100;return t>=ReviewScoreBand.EXCELLENT?"Xuất sắc":t>=ReviewScoreBand.GOOD?"Giỏi":t>=ReviewScoreBand.FAIR?"Khá":t>=ReviewScoreBand.AVERAGE?"Trung bình":"Cần cố gắng"}export function getScoreMessage(n,e,i){if(i)return"Bài làm của bạn đang có câu hỏi tự luận chờ giáo viên chấm điểm. Điểm số sẽ được cập nhật sớm nhất.";if(null==n||e<=0)return"Đừng nản nhé! Hãy xem lại chi tiết bài làm phía dưới và ôn lại kiến thức nhé.";const t=n/e*100;return t>=ReviewScoreBand.EXCELLENT?"Xuất sắc! Bạn nắm rất vững kiến thức. Xem lại chi tiết phía dưới nhé.":t>=ReviewScoreBand.GOOD?"Làm tốt lắm! Xem lại chi tiết bài làm phía dưới để hoàn thiện hơn nhé.":t>=ReviewScoreBand.FAIR?"Khá tốt! Hãy xem lại các câu chưa đúng phía dưới để tiến bộ hơn nhé.":t>=ReviewScoreBand.AVERAGE?"Bạn đã cố gắng! Xem lại kỹ phần chi tiết phía dưới để cải thiện nhé.":"Đừng nản nhé! Hãy xem lại chi tiết bài làm phía dưới và ôn lại kiến thức nhé."}

package/dist/components/results/utils/speaking-summary.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Shared logic for Speaking Review "NHẬN XÉT TỔNG QUAN TỪ AI".
+ * Source: oe-exam-fe/.../speaking-review/_utils/speaking-summary.ts
+ */
+import type { SpeakingReviewData, SpeakingReviewQuestion } from './transform-speaking-review';
+export type SpeakingSkillKey = 'pronunciation' | 'fluency' | 'vocabulary' | 'grammar' | 'coherence';
+export interface SkillScores {
+    pronunciation: number | null;
+    fluency: number | null;
+    vocabulary: number | null;
+    grammar: number | null;
+    coherence: number | null;
+}
+export interface SkillMetric {
+    key: SpeakingSkillKey;
+    label: string;
+    sublabel: string;
+    score: number;
+    color: string;
+}
+export type SummaryPointIcon = 'check' | 'star';
+export interface SummaryPoint {
+    icon: SummaryPointIcon;
+    text: string;
+    highlight?: boolean;
+}
+export declare const SPEAKING_SKILL_COLORS: {
+    readonly pronunciation: "#4CAF50";
+    readonly fluency: "#2196F3";
+    readonly vocabulary: "#FF9800";
+    readonly grammar: "#9C27B0";
+    readonly coherence: "#00BCD4";
+};
+export declare function deriveSkillScores(reviewData: SpeakingReviewData): SkillScores;
+export declare function buildSkillMetrics(scores: SkillScores): SkillMetric[];
+export declare function deriveSkillMetrics(reviewData: SpeakingReviewData): SkillMetric[];
+export declare function deriveQuestionSkillMetrics(question: SpeakingReviewQuestion): SkillMetric[];
+export declare function getOverallStatusText(totalScore: number | null, maxScore: number, isPendingGrading: boolean): string;
+export declare function getScoreLabel(totalScore: number | null, maxScore: number, isPendingGrading: boolean): string;
+export declare function deriveFeedback(reviewData: SpeakingReviewData): string;
+export declare function deriveSummaryPoints(reviewData: SpeakingReviewData, metrics: SkillMetric[]): SummaryPoint[];

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

@@ -0,0 +1 @@
+export const SPEAKING_SKILL_COLORS={pronunciation:"#4CAF50",fluency:"#2196F3",vocabulary:"#FF9800",grammar:"#9C27B0",coherence:"#00BCD4"};function n(n){return null!=n&&Number.isFinite(n)?Math.round(Math.max(0,Math.min(100,n))):0}function t(n,t){if(t<=0)return null;return n.reduce((n,t)=>n+("number"==typeof t&&Number.isFinite(t)?t:0),0)/t}function e(n){return n&&"object"==typeof n?n:null}function c(n){const t=e(n);return e(t?.pronunciation)}export function deriveSkillScores(n){const r=function(n){return n.parts.flatMap(n=>n.questions)}(n),i=r.filter(n=>!n.isExample),o=i.length;return{pronunciation:t(i.map(n=>{const t=c(n.aiAssessment)?.pronunciationScore;return"number"==typeof t?t:null}),o),fluency:t(i.map(n=>{const t=c(n.aiAssessment)?.fluencyScore;return"number"==typeof t?t:null}),o),vocabulary:t(i.map(n=>{const t=e(n.llmAssessment)?.contentScore;return"number"==typeof t?t:null}),o),grammar:t(i.map(n=>{const t=c(n.aiAssessment)?.accuracyScore;return"number"==typeof t?t:null}),o),coherence:t(i.map(n=>{const t=c(n.aiAssessment)?.prosodyScore;return"number"==typeof t?t:null}),o)}}export function buildSkillMetrics(t){return[{key:"pronunciation",label:"Pronunciation",sublabel:"Phát âm",score:n(t.pronunciation),color:SPEAKING_SKILL_COLORS.pronunciation},{key:"fluency",label:"Fluency",sublabel:"Độ trôi chảy",score:n(t.fluency),color:SPEAKING_SKILL_COLORS.fluency},{key:"grammar",label:"Accuracy",sublabel:"Chính xác phát âm",score:n(t.grammar),color:SPEAKING_SKILL_COLORS.grammar},{key:"coherence",label:"Prosody",sublabel:"Ngữ điệu",score:n(t.coherence),color:SPEAKING_SKILL_COLORS.coherence},{key:"vocabulary",label:"Content",sublabel:"Nội dung",score:n(t.vocabulary),color:SPEAKING_SKILL_COLORS.vocabulary}]}export function deriveSkillMetrics(n){return buildSkillMetrics(deriveSkillScores(n))}export function deriveQuestionSkillMetrics(n){const t=c(n.aiAssessment),r=e(n.llmAssessment);return buildSkillMetrics({pronunciation:"number"==typeof t?.pronunciationScore?t.pronunciationScore:null,fluency:"number"==typeof t?.fluencyScore?t.fluencyScore:null,vocabulary:"number"==typeof r?.contentScore?r.contentScore:null,grammar:"number"==typeof t?.accuracyScore?t.accuracyScore:null,coherence:"number"==typeof t?.prosodyScore?t.prosodyScore:null})}export function getOverallStatusText(n,t,e){if(e||null==n)return"Đang chờ hoàn tất chấm điểm. Kết quả tổng quan sẽ được cập nhật ngay khi có đủ dữ liệu.";const c=t>0?n/t*100:0;return c>=85?"Trình độ rất tốt. Tiếp tục phát huy nhé!":c>=70?"Kết quả tốt. Hãy tiếp tục luyện tập để bứt phá hơn nữa!":c>=50?"Bạn đang tiến bộ tốt. Hãy luyện tập thêm để cải thiện toàn diện hơn.":"Cần luyện tập thêm để nâng cao kỹ năng nói và sự tự tin khi giao tiếp."}export function getScoreLabel(n,t,e){if(e||null==n)return"ĐANG CHỜ";const c=t>0?n/t*100:0;return c>=85?"XUẤT SẮC":c>=70?"TỐT":c>=50?"KHÁ":"CẦN CỐ GẮNG HƠN"}export function deriveFeedback(n){if(n.isPendingGrading)return"Bài thi đang chờ hệ thống hoặc giáo viên hoàn tất chấm điểm. Kết quả chi tiết sẽ được cập nhật sớm nhất có thể.";const t=n.maxScore>0?(n.totalScore??0)/n.maxScore*100:0;return t>=85?"Tuyệt vời! Bạn đã thể hiện khả năng nói tiếng Anh rất tốt. Hãy tiếp tục phát huy và chinh phục những thử thách cao hơn nhé!":t>=70?"Bạn đã có nền tảng nói tiếng Anh khá tốt. Tiếp tục luyện phát âm, mở rộng vốn từ và duy trì sự tự tin khi trả lời.":t>=50?"Bạn cần cố gắng hơn nữa. Hãy dành thêm thời gian luyện phát âm rõ ràng hơn và trả lời mạch lạc hơn ở từng phần thi.":"Bạn cần cố gắng nhiều hơn. Hãy luyện tập từng ngày để nâng cao khả năng nói, sự trôi chảy và mức độ tự tin khi giao tiếp bằng tiếng Anh."}export function deriveSummaryPoints(n,t){const e=Object.fromEntries(t.map(n=>[n.key,n.score])),c=[];return(e.pronunciation??0)>=75?c.push({icon:"check",text:"Phát âm rõ ràng, tự nhiên, ngữ điệu khá tốt."}):c.push({icon:"check",text:"Cần luyện thêm phát âm từng âm và nhấn trọng âm để nói rõ hơn."}),(e.grammar??0)>=75?c.push({icon:"check",text:"Phát âm từng âm chuẩn xác, ít mắc lỗi sai âm."}):c.push({icon:"check",text:"Cần luyện phát âm chuẩn từng âm tiết, đặc biệt các âm tiếng Anh dễ nhầm."}),(e.fluency??0)>=75?c.push({icon:"check",text:"Diễn đạt trôi chảy, tốc độ nói khá tốt."}):c.push({icon:"check",text:"Cần tăng độ trôi chảy và giảm các khoảng ngập ngừng khi trả lời."}),(e.coherence??0)>=75?c.push({icon:"check",text:"Ngữ điệu tự nhiên, nhấn nhá và nhịp điệu khi nói khá tốt."}):c.push({icon:"check",text:"Nên luyện ngữ điệu lên xuống tự nhiên hơn và chú ý nhịp điệu khi nói."}),(e.vocabulary??0)>=75?c.push({icon:"check",text:"Nội dung trả lời bám sát câu hỏi và đầy đủ ý chính."}):c.push({icon:"check",text:"Cần trả lời đúng trọng tâm câu hỏi và đầy đủ ý chính hơn."}),c.push({icon:"star",text:getOverallStatusText(n.totalScore,n.maxScore,n.isPendingGrading),highlight:!0}),c.slice(0,6)}

package/dist/components/results/utils/transform-speaking-review.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Transform DetailedResult API response to SpeakingReviewData format.
+ * Source: oe-exam-fe/.../speaking-review/_utils/transform-speaking-review.ts
+ */
+import { ReviewGradingStatus, type ResultReviewDetail, type ResultReviewTemplatePart } from '../../../api/result-review';
+export declare const SPEAKING_ANSWER_COMPLETED: "completed";
+export declare const SPEAKING_STORY_IMAGES_TYPE: "LISTEN_AND_SPEAK_WITH_STORY_IMAGES";
+export interface SpeakingReviewQuestion {
+    questionId: string;
+    /** DB answer record ID — used for individual polling. Falls back to questionId. */
+    answerId: string;
+    questionNumber: number;
+    /** Question prompt audio URL — S3 key that needs presigned URL resolution */
+    audioUrl: string;
+    /** S3 key for student's recorded answer, "completed", or null */
+    studentAnswerKey: string | null;
+    score: number | null;
+    maxScore: number;
+    isPendingGrading: boolean;
+    isCorrect: boolean | null;
+    /** Whether this is a partner example question (responder: PARTNER) — not graded */
+    isExample: boolean;
+    /** S3 key for partner's pre-recorded example answer audio */
+    partnerAudioUrl: string;
+    questionType: string;
+    questionContent: unknown;
+    studentAnswer: unknown;
+    correctAnswer: unknown;
+    questionGroup: {
+        id?: string | number;
+        payload?: unknown;
+    } | null;
+    aiAssessment?: unknown;
+    llmAssessment?: unknown;
+    classification?: unknown;
+    gradingStatus?: ReviewGradingStatus | string | null;
+}
+export interface SpeakingReviewPart {
+    partId: string;
+    partNo: number;
+    partName: string;
+    partSectionName: string;
+    instructions: string;
+    questionType: string;
+    questions: SpeakingReviewQuestion[];
+    groupPayload: unknown;
+}
+export interface SpeakingReviewData {
+    parts: SpeakingReviewPart[];
+    examName: string;
+    examSubTitle: string;
+    studentName: string;
+    submittedAt: string;
+    totalScore: number | null;
+    maxScore: number;
+    isPendingGrading: boolean;
+}
+/**
+ * Main transformer: convert ResultReviewDetail to SpeakingReviewData.
+ */
+export declare function transformSpeakingResultForReview(result: ResultReviewDetail, studentName: string, templateParts?: ResultReviewTemplatePart[] | null): SpeakingReviewData;
+export declare function isSpeakingTemplateType(type: string | null | undefined): boolean;

package/dist/components/results/utils/transform-speaking-review.js

@@ -0,0 +1 @@
+import{ResultTemplateType as t}from"../../../api/result-review";export const SPEAKING_ANSWER_COMPLETED="completed";export const SPEAKING_STORY_IMAGES_TYPE="LISTEN_AND_SPEAK_WITH_STORY_IMAGES";function e(t){if(null==t)return null;if("string"==typeof t)return t||null;if("object"==typeof t&&null!==t){const e=t;if("string"==typeof e.answer)return e.answer||null;if("string"==typeof e.audioKey)return e.audioKey||null;if("string"==typeof e.objectId)return"completed"}return null}function n(t){if(!t||"object"!=typeof t)return"";const e=t;return"string"==typeof e.audioUrl?e.audioUrl:"string"==typeof e.audio?e.audio:"string"==typeof e.questionAudio?e.questionAudio:"string"==typeof e.interlocutorAudioUrl?e.interlocutorAudioUrl:""}function o(t){if(!t||"object"!=typeof t)return"";const e=t;return"string"==typeof e.partnerAudioUrl?e.partnerAudioUrl:""}function r(t){const e=null!=t.sectionId?`_${t.sectionId}`:"";return`${t.partId??"unknown"}_${t.questionType}${e}`}function s(t,e,n){if(n<=1)return`Part ${t}`;return`Part ${t}${String.fromCharCode(97+e)}`}export function transformSpeakingResultForReview(t,i,u){const{answers:a,examName:c,submittedAt:l,totalScore:p,maxScore:d,isPendingGrading:f}=t,m=Boolean(f),g=new Map;for(const t of a){const e=r(t),n=g.get(e);n?n.push(t):g.set(e,[t])}const A=new Map,S=new Map;for(const[,t]of g){const e=t[0]?.partNo??0;S.set(e,(S.get(e)??0)+1)}const q=[];for(const[,t]of g){t.sort((t,e)=>t.questionNumber-e.questionNumber);const r=t[0];if(!r)continue;const i=r.partId??"unknown",a=r.partNo??0,c=r.questionType,l=r.sectionId,p=A.get(a)??0;A.set(a,p+1);const d=u?.find(t=>String(t.id)===String(i));let f,g=d?.instructions??"";if(d?.sections&&null!=l){const t=d.sections.find(t=>t.sectionId===l);if(t?.name)f=t.name;else{f=s(a,p,S.get(a)??1)}t?.instructions&&(g=t.instructions)}else{f=s(a,p,S.get(a)??1)}const N=`Part ${a}`,y=t.map((t,r)=>{const s=(i=t.studentAnswer)&&"object"==typeof i?i:null;var i;return{questionId:t.questionId,answerId:t.id??t.questionId,questionNumber:r+1,audioUrl:n(t.questionContent),studentAnswerKey:e(t.studentAnswer),isExample:t.isExample??!1,partnerAudioUrl:o(t.questionContent),score:t.score,maxScore:t.maxScore,isPendingGrading:m,isCorrect:t.isCorrect,questionType:t.questionType,questionContent:t.questionContent,studentAnswer:t.studentAnswer,correctAnswer:t.correctAnswer,questionGroup:t.questionGroup??null,aiAssessment:s?.aiAssessment,llmAssessment:s?.llmAssessment,classification:s?.classification,gradingStatus:t.gradingStatus??null}});let I=r.questionGroup?.payload??null;if(c===SPEAKING_STORY_IMAGES_TYPE&&!I){const t=r.questionContent;t?.images&&(I={images:t.images})}q.push({partId:i,partNo:a,partName:N,partSectionName:f,instructions:g,questionType:c,questions:y,groupPayload:I})}return q.sort((t,e)=>t.partNo!==e.partNo?t.partNo-e.partNo:(t.questions[0]?.questionNumber??0)-(e.questions[0]?.questionNumber??0)),{parts:q,examName:c??"",examSubTitle:t.roomName??"",studentName:i,submittedAt:String(l??""),totalScore:m?null:p,maxScore:d,isPendingGrading:m}}export function isSpeakingTemplateType(e){return e===t.SPEAKING}

package/dist/components/shared/audio/SpeakingAudioPlayer.d.ts

@@ -0,0 +1,12 @@
+interface SpeakingAudioPlayerProps {
+    audioUrl: string;
+    onPlayingChange?: (isPlaying: boolean) => void;
+    /**
+     * Auto-play the audio a few seconds (3s) after it loads or changes — e.g.
+     * when navigating to the next question. Defaults to false so other usages
+     * (such as model-pronunciation playback) are not auto-triggered.
+     */
+    autoPlay?: boolean;
+}
+export declare function SpeakingAudioPlayer({ audioUrl, onPlayingChange, autoPlay }: SpeakingAudioPlayerProps): import("react").JSX.Element;
+export {};

package/dist/components/shared/audio/SpeakingAudioPlayer.js

@@ -0,0 +1 @@
+"use client";import{jsx as e,jsxs as a}from"react/jsx-runtime";import{useRef as t,useState as n,useEffect as r}from"react";import{Pause as i,Play as o}from"lucide-react";import{usePresignedFileUrl as d}from"../../../shared/lib/hooks/usePresignedFileUrl";import{useDelayedAutoPlay as l}from"../../../shared/lib/hooks/useDelayedAutoPlay";import s from"./SpeakingAudioPlayer.module.css";const u=[.4,.6,.85,.55,.75,1,.65,.45,.7,.9,.6,.5,.8,.65,.95,.7,.5,.6,.8,.45];export function SpeakingAudioPlayer({audioUrl:c,onPlayingChange:m,autoPlay:p=!1}){const v=t(null),[h,y]=n(!1),[g,f]=n(0),[L,E]=n(0),{previewUrl:N}=d(c||void 0);r(()=>{const e=v.current;if(!e)return;const a=()=>{e.duration&&!isNaN(e.duration)&&isFinite(e.duration)&&E(e.duration)},t=()=>{f(e.currentTime),a()},n=()=>{y(!0),m?.(!0)},r=()=>{y(!1),m?.(!1)},i=()=>{y(!1),f(0),m?.(!1)};return a(),e.addEventListener("loadedmetadata",a),e.addEventListener("durationchange",a),e.addEventListener("canplay",a),e.addEventListener("timeupdate",t),e.addEventListener("play",n),e.addEventListener("pause",r),e.addEventListener("ended",i),()=>{e.removeEventListener("loadedmetadata",a),e.removeEventListener("durationchange",a),e.removeEventListener("canplay",a),e.removeEventListener("timeupdate",t),e.removeEventListener("play",n),e.removeEventListener("pause",r),e.removeEventListener("ended",i)}},[N]),r(()=>{y(!1),f(0),E(0)},[N]),l({audioRef:v,audioUrl:N,enabled:p});const b=L>0?g/L:0,P=!N;return a("div",{className:s.audioPill,children:[e("audio",{ref:v,...N?{src:N}:{},preload:"metadata"}),e("button",{type:"button",className:`${s.playButton} ${h?s.playButtonPlaying:""} ${P?s.playButtonDisabled:""}`,onClick:P?void 0:()=>{const e=v.current;e&&(h?e.pause():e.play().catch(e=>{console.warn("Audio play request was interrupted:",e)}))},disabled:P,"aria-label":P?"Không có âm thanh đính kèm":h?"Tạm dừng":"Nghe câu hỏi",title:P?"Không có âm thanh đính kèm":h?"Tạm dừng":"Nghe câu hỏi",children:h?e(i,{className:s.playIcon,fill:"currentColor"}):e(o,{className:s.playIcon,fill:"currentColor",style:{marginLeft:"2px"}})}),e("div",{className:s.waveform,"aria-hidden":"true",children:u.map((a,t)=>{const n=(t+.5)/u.length<=b;return e("span",{className:`${s.waveBar} ${h&&n?s.waveBarPlaying:""}`,style:{height:100*a+"%",background:n?"linear-gradient(180deg, #ffc93c, #ff9900)":"#d8e0ea",animationDelay:h&&n?t%6*.1+"s":void 0}},t)})})]})}

package/dist/components/shared/audio/SpeakingAudioPlayer.module.css

@@ -0,0 +1,115 @@
+/* ===== Speaking Audio Player — "Listen to the question" ===== */
+/* Small, simple, kid-friendly player for light backgrounds (Summer Sky theme):
+   a sky-blue play/replay button + a sunny-amber waveform progress indicator.
+   No time digits, no seek — compact and tap-friendly. */
+
+.audioPill {
+    display: flex;
+    align-items: center;
+    gap: 10px;
+    width: 100%;
+    padding: 5px 14px 5px 5px;
+    background: #ffffff;
+    border: 2px solid #dcebff;
+    border-radius: 999px;
+    box-shadow: 0 3px 10px rgba(0, 0, 0, 0.08);
+    box-sizing: border-box;
+}
+
+/* ===== Play / Pause button ===== */
+.playButton {
+    flex-shrink: 0;
+    height: 42px;
+    width: 42px;
+    min-width: 42px;
+    border: none;
+    border-radius: 50%;
+    background: linear-gradient(135deg, #5ba8e8, #357abd);
+    color: #ffffff;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    cursor: pointer;
+    padding: 0;
+    box-shadow: 0 3px 8px rgba(53, 122, 189, 0.35);
+    transition: transform 0.15s ease, box-shadow 0.15s ease, background 0.2s ease;
+}
+
+.playButton:hover {
+    transform: scale(1.08);
+}
+
+.playButton:active {
+    transform: scale(0.95);
+}
+
+.playIcon {
+    width: 20px;
+    height: 20px;
+}
+
+/* Playing — coral with a gentle pulsing ring */
+.playButtonPlaying {
+    background: linear-gradient(135deg, #ff8a8a, #ff6b6b);
+    box-shadow: 0 0 0 0 rgba(255, 107, 107, 0.5);
+    animation: playPulse 1.5s infinite;
+}
+
+@keyframes playPulse {
+    0% {
+        box-shadow: 0 0 0 0 rgba(255, 107, 107, 0.5);
+    }
+
+    70% {
+        box-shadow: 0 0 0 8px rgba(255, 107, 107, 0);
+    }
+
+    100% {
+        box-shadow: 0 0 0 0 rgba(255, 107, 107, 0);
+    }
+}
+
+/* Disabled — no audio attached */
+.playButtonDisabled {
+    background: #cbd5e1;
+    box-shadow: none;
+    cursor: not-allowed;
+    opacity: 0.7;
+    animation: none;
+}
+
+.playButtonDisabled:hover {
+    transform: none;
+}
+
+/* ===== Waveform progress indicator (display-only, fills L→R with progress) ===== */
+.waveform {
+    flex: 1;
+    min-width: 0;
+    height: 20px;
+    display: flex;
+    align-items: center;
+    gap: 2px;
+}
+
+.waveBar {
+    flex: 1;
+    min-width: 0;
+    border-radius: 999px;
+    transform-origin: center;
+}
+
+/* Subtle liveliness on the already-played region while playing */
+.waveBarPlaying {
+    animation: waveBounce 0.9s ease-in-out infinite alternate;
+}
+
+@keyframes waveBounce {
+    0% {
+        transform: scaleY(0.7);
+    }
+
+    100% {
+        transform: scaleY(1);
+    }
+}