@tinyweb_dev/oe-exam-sdk 0.1.3 → 0.1.5

package/README.md

@@ -18,9 +18,11 @@ import {
   ExamQuestionsPageContainer,
   ExamTakingPageContainer,
   ResultReviewPageContainer,
+  StudentExamEntryPageContainer,
 } from '@tinyweb_dev/oe-exam-sdk';
 import {
   createExamCreateApi,
+  createExamEntryApi,
   createExamQuestionsApi,
   createExamTakingApi,
   createResultReviewApi,
@@ -47,12 +49,26 @@ export function ExamQuestionsPage({ examId, router }) {
   );
 }
 
-export function ExamTakePage({ examId, router }) {
+export function ExamEnterPage({ roomId, inviteToken, router }) {
+  return (
+    <StudentExamEntryPageContainer
+      roomId={roomId}
+      inviteToken={inviteToken}
+      api={createExamEntryApi({ baseUrl })}
+      onNavigate={(href) => router.push(href)}
+    />
+  );
+}
+
+export function ExamTakePage({ roomId, router }) {
   return (
     <ExamTakingPageContainer
-      examId={examId}
+      roomId={roomId}
       api={createExamTakingApi({ baseUrl })}
       onNavigate={(href) => router.replace(href)}
+      resultPath={(attemptId) => `/student/results/${attemptId}/review`}
+      onSubmitted={({ attemptId }) => router.replace(`/student/results/${attemptId}/review`)}
+      proctoringEnabled
     />
   );
 }
@@ -77,8 +93,9 @@ export function ResultReviewPage({ attemptId, token, router }) {
 @tinyweb_dev/oe-exam-sdk/shared                # shared constants/types/helpers
 @tinyweb_dev/oe-exam-sdk/mcp                   # MCP server entry và tools
 @tinyweb_dev/oe-exam-sdk/components            # shared UI components
-@tinyweb_dev/oe-exam-sdk/components/exams      # màn tạo đề / câu hỏi / làm bài
-@tinyweb_dev/oe-exam-sdk/components/exams/take # màn làm bài + renderer generic
+@tinyweb_dev/oe-exam-sdk/components/exams      # màn tạo đề / câu hỏi / làm bài / vào phòng
+@tinyweb_dev/oe-exam-sdk/components/exams/entry # màn vào phòng (entry) + state machine
+@tinyweb_dev/oe-exam-sdk/components/exams/take # màn làm bài + renderer generic + hooks
 @tinyweb_dev/oe-exam-sdk/components/questions  # hệ thống tạo câu hỏi
 @tinyweb_dev/oe-exam-sdk/components/themes     # cambridge-yle, english-certification, summer-sky
 @tinyweb_dev/oe-exam-sdk/components/results    # màn xem chi tiết kết quả
@@ -109,6 +126,40 @@ Các adapter mặc định nhận:
 
 `createExamTakingApi` đã bao gồm các API cần cho màn làm bài: start/resume attempt, questions, save answers, submit, upload audio, proctoring snapshot, realtime grading, grading summary/status/detail, room/attempt detail và `keepalive` save.
 
+`createExamEntryApi` phục vụ màn vào phòng: room detail, active attempt theo room, start/delete attempt, join qua invite token và đăng ký contest (registration form).
+
+## Màn vào phòng (entry)
+
+`StudentExamEntryPageContainer` port toàn bộ luồng `/student/exams/:roomId/enter`: join qua invite, gating quyền truy cập / đề thi / form đăng ký, state machine theo cửa sổ thời gian (BEFORE_START / WITHIN_WINDOW / EXPIRED / ALREADY_SUBMITTED), resume attempt đang dở và dialog "làm tiếp / làm lại từ đầu".
+
+```tsx
+<StudentExamEntryPageContainer
+  roomId={roomId}
+  inviteToken={inviteToken}
+  api={createExamEntryApi({ baseUrl })}
+  onNavigate={(href) => router.push(href)}
+  takePath={(id) => `/student/exams/${id}/take`}
+  renderRegistrationForm={({ room, onSubmit, isSubmitting }) => (
+    <MyRegistrationDialog room={room} onSubmit={onSubmit} isSubmitting={isSubmitting} />
+  )}
+/>
+```
+
+Themed waiting room (TOEIC / Summer Sky / Cambridge YLE) và registration form là phần phụ thuộc host app — truyền qua `renderRegistrationForm` hoặc bọc container.
+
+## Hooks màn làm bài
+
+`@tinyweb_dev/oe-exam-sdk/components/exams/take` export các hook tái sử dụng:
+
+```txt
+useExamCountdown      # đếm ngược theo startedAt + duration, auto-submit khi hết giờ
+useAnswerAutosave     # lưu debounce theo batch + flush keepalive khi ẩn tab/unload + retry khi online
+useProctoringSnapshot # chụp webcam định kỳ và upload snapshot
+useAttemptSubmit      # nộp bài (flush trước), chống double-submit, trả pending/auto-graded answer ids
+```
+
+`ExamTakingPageContainer` đã nối sẵn các hook trên. `onSubmitted` nhận `{ attemptId, pendingAnswerIds }` để điều hướng sang màn review đúng ngữ cảnh; bật proctoring qua prop `proctoringEnabled` và truyền `achieversExamTitle` nếu cần gate video intro của giáo viên.
+
 ## Theme làm bài
 
 `ExamTakingPageContainer` tự chọn layout theo `examTemplate.theme`:
@@ -124,18 +175,66 @@ Renderer câu hỏi trong màn làm bài hiện là `GenericQuestionRenderer`.
 
 ## Màn xem kết quả
 
+`ResultReviewPageContainer` sở hữu toàn bộ màn review và tự chọn giao diện theo template:
+
+- `SPEAKING`: dùng report nói chuyên biệt, chi tiết từng phần/câu, audio, AI assessment và speaking rubric.
+- Template còn lại: dùng `OceanEduExamReport`, phân tích tổng quan, rubric (nếu có) và `ReviewQuestionRenderer` đầy đủ cho câu hỏi dedicated lẫn Movers fallback.
+- Template `PLACEMENT_TEST_KINDY_VER3` và `PLACEMENT_TEST_PRESCHOOL` dùng điểm rubric theo Part và ẩn chấm điểm từng câu.
+
 ```tsx
-<ResultReviewPageContainer
-  attemptId={attemptId}
-  token={token}
-  api={createResultReviewApi({ baseUrl })}
-  topActionsSlot={null}
-  beforeReportSlot={null}
-  afterReportSlot={null}
-/>
+'use client';
+
+import {
+  ResultReviewPageContainer,
+  createResultReviewApi,
+} from '@tinyweb_dev/oe-exam-sdk';
+
+export function ResultReviewPage({ attemptId, token, isPrintMode, router }) {
+  const reviewUrl = typeof window !== 'undefined' ? window.location.href : undefined;
+
+  return (
+    <ResultReviewPageContainer
+      attemptId={attemptId}
+      token={token}
+      api={createResultReviewApi({ baseUrl })}
+      isPrintMode={isPrintMode}
+      canExportPdf
+      reviewUrl={reviewUrl}
+      assetBaseUrl="/speaking/ocean-edu"
+      loginHref={`/auth/login?redirect=${encodeURIComponent(reviewUrl ?? '')}`}
+      onBack={() => router.back()}
+      onNavigate={(href) => router.push(href)}
+      topActionsSlot={<SummaryVideoAction attemptId={attemptId} />}
+      beforeReportSlot={<GiftClaimDialog attemptId={attemptId} />}
+      afterReportSlot={<ResultExtraContent attemptId={attemptId} />}
+    />
+  );
+}
 ```
 
-Các phần phụ thuộc app chính như gift dialog, upgrade modal, summary video/remotion nên truyền qua slot từ host app.
+### Props và hành vi
+
+| Prop | Hành vi |
+|---|---|
+| `attemptId`, `token`, `api` | Tải detail/attempt; `token` hỗ trợ link kết quả công khai. |
+| `isPrintMode` | Dừng polling và phát `body[data-pdf-ready="true"]` sau khi load để headless PDF renderer tiếp tục. |
+| `canExportPdf` | Hiện nút xuất PDF khi adapter có `exportPdf`; SDK tải blob bằng tên file từ API. |
+| `reviewUrl` | URL canonical đưa vào QR; SDK bổ sung verification token từ prop hoặc attempt. Mặc định dùng URL hiện tại trên browser. |
+| `assetBaseUrl` | Prefix tùy chọn cho `logo-ocean.png`, `penguin-main.png`, `penguin-small.png`, `dofu2.png`; bỏ prop để dùng asset bundle trong package. |
+| `loginHref` | Đích đăng nhập ở trạng thái 403/private; mặc định là `/auth/login?redirect=<current-url>`. |
+| `onBack`, `onNavigate` | Tích hợp router của host. Nếu có contest, back qua `onNavigate` về rooms của contest; nếu không có callback thì dùng browser history. |
+
+Container poll mỗi 5 giây khi còn grading status đang xử lý hoặc LLM assessment chưa sẵn sàng. Các trạng thái loading, lỗi chung và 403 chưa công khai có UI riêng. `showDetailedResults=false` chỉ ẩn phần câu hỏi chi tiết, không ẩn report tổng quan.
+
+### Slots và phạm vi host
+
+- `topActionsSlot`: action bổ sung cạnh nút xuất PDF, ví dụ summary video.
+- `beforeReportSlot`: nội dung trước report, ví dụ gift claim hoặc thông báo nâng cấp.
+- `afterReportSlot`: nội dung sau report.
+
+Gift claim, summary video/remotion, account upgrade, auth store và router không được nhúng trong SDK. Host truyền các phần này qua slot/callback; không cần nối lại page của `oe-exam-fe` để dùng container.
+
+Các report shell, renderer, transform helper, polling/status helper và result-review types cũng được export từ `@tinyweb_dev/oe-exam-sdk/components/results` khi host cần tái sử dụng riêng lẻ.
 
 ## MCP server
 

package/dist/api/contest-rooms.d.ts

@@ -0,0 +1,13 @@
+import type { ContestRoomListItem, ContestRoomsContestDetail, ContestRoomsFetchApiOptions, ContestRoomsSdkApi } from './contest-rooms.types';
+/**
+ * Default fetch-based adapter for the student contest rooms-list flow. Mirrors
+ * the host app endpoints used by the original `/student/contests/:contestId/rooms`
+ * page: contest detail, room list and room registration.
+ */
+export declare function createContestRoomsApi(options?: ContestRoomsFetchApiOptions): ContestRoomsSdkApi;
+/** In-memory mock adapter for demo/storybook/tests. */
+export declare function createMockContestRoomsApi(seed: {
+    contest: ContestRoomsContestDetail;
+    rooms: ContestRoomListItem[];
+}): ContestRoomsSdkApi;
+export type { ContestRoomListItem, ContestRoomRegistrationStatus, ContestRoomVisibility, ContestRoomsContestDetail, ContestRoomsFetchApiOptions, ContestRoomsSdkApi, } from './contest-rooms.types';

package/dist/api/contest-rooms.js

@@ -0,0 +1 @@
+import{API_BASE_URL as t,API_ENDPOINTS as e}from"../shared/constants/ApiConstant";export function createContestRoomsApi(n={}){const o=function({baseUrl:e=t??"",fetcher:n=fetch,headers:o}){return async function(t,s){const r=await n(`${e}${t}`,{credentials:"include",...s,headers:{"Content-Type":"application/json",...o,...s?.headers}});if(!r.ok)throw new Error(await async function(t){const e=await t.json().catch(()=>{});if("object"==typeof e&&null!==e&&"message"in e&&"string"==typeof e.message)return e.message;return t.statusText}(r));if(204!==r.status)return r.json()}}(n);return{getContestDetail:t=>o(e.STUDENT.CONTEST_DETAIL(t)),getContestRooms:t=>o(e.STUDENT.CONTEST_ROOMS(t)),registerRoom:(t,n)=>o(e.STUDENT.CONTEST_ROOM_REGISTER(t,n),{method:"POST"}),cancelRoomRegistration:(t,n)=>o(e.STUDENT.CONTEST_ROOM_REGISTER(t,n),{method:"DELETE"})}}export function createMockContestRoomsApi(t){const e=[...t.rooms];return{getContestDetail:async()=>t.contest,getContestRooms:async()=>e,registerRoom:async(t,n)=>{const o=e.find(t=>t.id===n);o&&(o.registrationStatus="PENDING")},cancelRoomRegistration:async(t,n)=>{const o=e.find(t=>t.id===n);o&&(o.registrationStatus=null)}}}

package/dist/api/contest-rooms.types.d.ts

@@ -0,0 +1,47 @@
+import type { ApiData } from './exam-entry.types';
+export type ContestRoomVisibility = 'public' | 'internal' | 'private';
+export type ContestRoomRegistrationStatus = 'PENDING' | 'APPROVED' | 'REJECTED';
+/** Contest summary needed by the rooms list header/gating. */
+export interface ContestRoomsContestDetail {
+    id: string;
+    name: string;
+    status?: 'UPCOMING' | 'IN_PROGRESS' | 'COMPLETED';
+    allowMultipleSubmissions?: boolean | null;
+}
+/** Room item as listed on `/student/contests/:contestId/rooms`. */
+export interface ContestRoomListItem {
+    id: string;
+    name: string;
+    code: string;
+    examName: string;
+    status: 'UPCOMING' | 'IN_PROGRESS' | 'COMPLETED';
+    startDatetime?: string;
+    endDatetime?: string;
+    isLocked: boolean;
+    hasAttempt: boolean;
+    attemptStatus?: string;
+    isCompleted?: boolean;
+    visibility?: ContestRoomVisibility;
+    registrationStatus?: ContestRoomRegistrationStatus | null;
+    registrationCount?: number;
+    allowMultipleSubmissions?: boolean | null;
+}
+/**
+ * API surface the rooms-list container depends on. Methods may return either
+ * the raw value or an `{ data }` envelope; the container unwraps both.
+ */
+export interface ContestRoomsSdkApi {
+    /** Fetch contest detail (used for header + multi-submission gating). */
+    getContestDetail: (contestId: string) => Promise<ApiData<ContestRoomsContestDetail> | ContestRoomsContestDetail>;
+    /** Fetch the list of rooms for a contest. */
+    getContestRooms: (contestId: string) => Promise<ApiData<ContestRoomListItem[]> | ContestRoomListItem[]>;
+    /** Register for an internal-visibility room. */
+    registerRoom: (contestId: string, roomId: string) => Promise<unknown>;
+    /** Cancel a pending/approved room registration. */
+    cancelRoomRegistration?: (contestId: string, roomId: string) => Promise<unknown>;
+}
+export interface ContestRoomsFetchApiOptions {
+    baseUrl?: string;
+    fetcher?: typeof fetch;
+    headers?: HeadersInit;
+}

package/dist/api/contest-rooms.types.js

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

package/dist/api/exam-entry.d.ts

@@ -0,0 +1,14 @@
+import type { ExamEntryAttempt, ExamEntryFetchApiOptions, ExamEntryRoom, ExamEntrySdkApi } from './exam-entry.types';
+/**
+ * Default fetch-based adapter for the student exam entry flow. Mirrors the host
+ * app endpoints used by the original `/student/exams/:roomId/enter` page:
+ * room detail, active attempt by room, start/delete attempt, invite join and
+ * contest registration.
+ */
+export declare function createExamEntryApi(options?: ExamEntryFetchApiOptions): ExamEntrySdkApi;
+/** In-memory mock adapter for demo/storybook/tests. */
+export declare function createMockExamEntryApi(seed: {
+    room: ExamEntryRoom;
+    attempt?: ExamEntryAttempt | null;
+}): ExamEntrySdkApi;
+export type { ExamEntryAttempt, ExamEntryContest, ExamEntryExam, ExamEntryFetchApiOptions, ExamEntryRegistrationField, ExamEntryRegistrationFormConfig, ExamEntryRoom, ExamEntrySdkApi, } from './exam-entry.types';

package/dist/api/exam-entry.js

@@ -0,0 +1 @@
+import{API_BASE_URL as t,API_ENDPOINTS as e}from"../shared/constants/ApiConstant";export function createExamEntryApi(n={}){const o=function({baseUrl:e=t??"",fetcher:n=fetch,headers:o}){return async function(t,a){const r=await n(`${e}${t}`,{credentials:"include",...a,headers:{"Content-Type":"application/json",...o,...a?.headers}});if(!r.ok)throw new Error(await async function(t){const e=await t.json().catch(()=>{});if("object"==typeof e&&null!==e&&"message"in e&&"string"==typeof e.message)return e.message;return t.statusText}(r));if(204!==r.status)return r.json()}}(n);return{getRoom:t=>o(e.STUDENT.ROOM_DETAIL(t)),getActiveAttemptByRoom:t=>o(e.STUDENT.ATTEMPTS_ACTIVE_BY_ROOM(t)),startAttempt:t=>o(e.STUDENT.ATTEMPTS_START,{method:"POST",body:JSON.stringify({examRoomId:t})}),deleteAttempt:t=>o(e.STUDENT.ATTEMPT_DELETE(t),{method:"DELETE"}),joinViaInvite:(t,n)=>o(e.STUDENT.ROOM_JOIN_INVITE(t,n),{method:"POST"}),registerContest:(t,n)=>o(e.STUDENT.CONTEST_REGISTER(t),{method:"POST",body:JSON.stringify(n)})}}export function createMockExamEntryApi(t){let e=t.attempt??null;return{getRoom:async()=>t.room,getActiveAttemptByRoom:async()=>e,startAttempt:async()=>(e={id:`mock-attempt-${Date.now()}`,startedAt:(new Date).toISOString(),durationMinutes:t.room.exam?.durationMinutes??30,examRoomId:t.room.id,status:"IN_PROGRESS"},e),deleteAttempt:async()=>{e=null},joinViaInvite:async()=>{},registerContest:async()=>{}}}

package/dist/api/exam-entry.types.d.ts

@@ -0,0 +1,93 @@
+import type { ExamTakingAttempt } from './exam-taking.types';
+/** Generic envelope used by the OE Exam API ({ data: ... }). */
+export interface ApiData<T> {
+    data: T;
+}
+/** Registration form field config for contest rooms. */
+export interface ExamEntryRegistrationField {
+    id: string;
+    label: string;
+    type: string;
+    required: boolean;
+    placeholder?: string;
+    options?: string[];
+    userPropertyMapping?: string;
+}
+/** Registration form config attached to a room. */
+export interface ExamEntryRegistrationFormConfig {
+    enabled: boolean;
+    fields: ExamEntryRegistrationField[];
+}
+/** Exam summary nested inside a room. */
+export interface ExamEntryExam {
+    id: string;
+    name?: string;
+    description?: string;
+    durationMinutes?: number;
+    totalScore?: number;
+    passScore?: number;
+    level?: string;
+    theme?: string;
+    template?: {
+        theme?: string;
+        subTitle?: string;
+        title?: string;
+    };
+}
+/** Contest summary nested inside a room. */
+export interface ExamEntryContest {
+    id: string;
+    code?: string | null;
+    name?: string;
+    status?: string;
+}
+/**
+ * Room as needed by the entry screen. Mirrors the fields the entry flow reads
+ * from `studentRoomsApi.getById` in the host app.
+ */
+export interface ExamEntryRoom {
+    id: string;
+    name: string;
+    description?: string;
+    code?: string;
+    examId?: string;
+    startDatetime?: string;
+    endDatetime?: string;
+    isLocked?: boolean;
+    hasJoined?: boolean;
+    canAccess?: boolean;
+    allowMultipleSubmissions?: boolean;
+    hasSubmittedFormData?: boolean;
+    registrationFormConfig?: ExamEntryRegistrationFormConfig;
+    exam?: ExamEntryExam;
+    contest?: ExamEntryContest;
+}
+/** Attempt as needed by the entry screen. */
+export type ExamEntryAttempt = ExamTakingAttempt;
+/**
+ * API surface the entry container depends on. All methods may return either the
+ * raw value or an `{ data }` envelope; the container unwraps both.
+ */
+export interface ExamEntrySdkApi {
+    /** Fetch room detail by id. */
+    getRoom: (roomId: string) => Promise<ApiData<ExamEntryRoom> | ExamEntryRoom>;
+    /** Fetch the active (IN_PROGRESS) attempt for a specific room, or null. */
+    getActiveAttemptByRoom: (roomId: string) => Promise<ApiData<ExamEntryAttempt | null> | ExamEntryAttempt | null>;
+    /** Start a new attempt for the room. */
+    startAttempt: (roomId: string) => Promise<ApiData<ExamEntryAttempt | {
+        attempt: ExamEntryAttempt;
+    }> | ExamEntryAttempt | {
+        attempt: ExamEntryAttempt;
+    }>;
+    /** Delete an attempt (used by "restart from scratch"). */
+    deleteAttempt: (attemptId: string) => Promise<unknown>;
+    /** Join a room via an invite token (best-effort; may already be a member). */
+    joinViaInvite?: (roomId: string, inviteToken: string) => Promise<unknown>;
+    /** Register for the contest backing the room (submits registration form data). */
+    registerContest?: (contestId: string, formData: Record<string, unknown>) => Promise<unknown>;
+}
+export interface ExamEntryFetchApiOptions {
+    baseUrl?: string;
+    fetcher?: typeof fetch;
+    headers?: HeadersInit;
+}

package/dist/api/exam-entry.types.js

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

package/dist/api/index.d.ts

@@ -1,6 +1,8 @@
 export * from './exam-create';
 export * from './exam-questions';
 export * from './exam-taking';
+export * from './exam-entry';
+export * from './contest-rooms';
 export * from './result-review';
 export * from '../shared/constants/ApiConstant';
 export * from '../shared/constants/QueryKeyConstant';

package/dist/api/index.js

@@ -1 +1 @@
-export*from"./exam-create";export*from"./exam-questions";export*from"./exam-taking";export*from"./result-review";export*from"../shared/constants/ApiConstant";export*from"../shared/constants/QueryKeyConstant";
+export*from"./exam-create";export*from"./exam-questions";export*from"./exam-taking";export*from"./exam-entry";export*from"./contest-rooms";export*from"./result-review";export*from"../shared/constants/ApiConstant";export*from"../shared/constants/QueryKeyConstant";

package/dist/api/result-review.d.ts

@@ -4,4 +4,5 @@ export declare function createMockResultReviewApi(seed: {
     detail: ResultReviewDetail;
     attempt?: ResultReviewAttempt;
 }): ResultReviewSdkApi;
-export type { ResultReviewAnswer, ResultReviewAttempt, ResultReviewDetail, ResultReviewFetchApiOptions, ResultReviewSdkApi } from './result-review.types';
+export { ResultTemplateType, ReviewGradingStatus } from './result-review.types';
+export type { ResultReviewAnswer, ResultReviewAttempt, ResultReviewDetail, ResultReviewFetchApiOptions, ResultReviewSdkApi, ResultReviewTemplatePart, ReviewAnswerValue, SpeakingRubric, SpeakingRubricCriterion, SpeakingRubricQuestion, SpeakingRubricSection, } from './result-review.types';

package/dist/api/result-review.js

@@ -1 +1 @@
-import{API_BASE_URL as e,API_ENDPOINTS as t}from"../shared/constants/ApiConstant";export function createResultReviewApi(i={}){const r=function({baseUrl:t=e??"",fetcher:n=fetch,headers:a}){return async function(e,i){const r=await n(`${t}${e}`,{credentials:"include",...i,headers:{"Content-Type":"application/json",...a,...i?.headers}});if(!r.ok)throw new Error(await o(r));return r.json()}}(i);return{getDetailedResult:(e,a)=>r(n(t.STUDENT.RESULT_DETAIL(e),a)),getAttempt:(e,a)=>r(n(t.STUDENT.ATTEMPT_DETAIL(e),a)),exportPdf:async(n,r)=>{const s=await(i.fetcher??fetch)(`${i.baseUrl??e??""}${t.STUDENT.EXPORT_NATIVE_PDF}`,{method:"POST",credentials:"include",headers:{"Content-Type":"application/json",...i.headers},body:JSON.stringify({attemptId:n,examType:r})});if(!s.ok)throw new Error(await o(s));return{blob:await s.blob(),filename:a(s.headers,n)}}}}export function createMockResultReviewApi(e){return{getDetailedResult:async()=>e.detail,getAttempt:async()=>e.attempt??{id:e.detail.id},exportPdf:async()=>({blob:new Blob(["mock pdf"],{type:"application/pdf"}),filename:`result-${e.detail.id}.pdf`})}}function n(e,t){if(!t)return e;const n=e.includes("?")?"&":"?";return`${e}${n}token=${encodeURIComponent(t)}`}function a(e,t){const n=e.get("content-disposition")??"";return n.match(/filename="?([^\"]+)"?/)?.[1]??`result-${t.slice(0,8)}.pdf`}async function o(e){const t=await e.json().catch(()=>{});return"object"==typeof t&&null!==t&&"message"in t&&"string"==typeof t.message?t.message:e.statusText}
+import{API_BASE_URL as e,API_ENDPOINTS as t}from"../shared/constants/ApiConstant";export function createResultReviewApi(r={}){const i=function({baseUrl:t=e??"",fetcher:n=fetch,headers:a}){return async function(e,r){const i=await n(`${t}${e}`,{credentials:"include",...r,headers:{"Content-Type":"application/json",...a,...r?.headers}});if(!i.ok)throw new Error(await o(i));return i.json()}}(r);return{getDetailedResult:(e,a)=>i(n(t.STUDENT.RESULT_DETAIL(e),a)),getAttempt:(e,a)=>i(n(t.STUDENT.ATTEMPT_DETAIL(e),a)),exportPdf:async(n,i)=>{const s=await(r.fetcher??fetch)(`${r.baseUrl??e??""}${t.STUDENT.EXPORT_NATIVE_PDF}`,{method:"POST",credentials:"include",headers:{"Content-Type":"application/json",...r.headers},body:JSON.stringify({attemptId:n,examType:i})});if(!s.ok)throw new Error(await o(s));return{blob:await s.blob(),filename:a(s.headers,n)}}}}export function createMockResultReviewApi(e){return{getDetailedResult:async()=>e.detail,getAttempt:async()=>e.attempt??{id:e.detail.id},exportPdf:async()=>({blob:new Blob(["mock pdf"],{type:"application/pdf"}),filename:`result-${e.detail.id}.pdf`})}}function n(e,t){if(!t)return e;const n=e.includes("?")?"&":"?";return`${e}${n}token=${encodeURIComponent(t)}`}function a(e,t){const n=e.get("content-disposition")??"";return n.match(/filename="?([^"]+)"?/)?.[1]??`result-${t.slice(0,8)}.pdf`}async function o(e){const t=await e.json().catch(()=>{});return"object"==typeof t&&null!==t&&"message"in t&&"string"==typeof t.message?t.message:e.statusText}export{ResultTemplateType,ReviewGradingStatus}from"./result-review.types";

package/dist/api/result-review.types.d.ts

@@ -1,4 +1,63 @@
 export type ReviewAnswerValue = string | number | boolean | string[] | Record<string, unknown> | null;
+export declare enum ResultTemplateType {
+    SPEAKING = "SPEAKING"
+}
+export declare enum ReviewGradingStatus {
+    PENDING = "PENDING",
+    QUEUED = "QUEUED",
+    PROCESSING = "PROCESSING",
+    AUTO_GRADED = "AUTO_GRADED",
+    GRADED = "GRADED",
+    COMPLETED = "COMPLETED",
+    FAILED = "FAILED",
+    MANUAL_REVIEW = "MANUAL_REVIEW",
+    NOT_ANSWERED = "NOT_ANSWERED"
+}
+export interface SpeakingRubricCriterion {
+    code: string;
+    score: number;
+    weightedScore?: number;
+    maxScore?: number;
+    evidence: string;
+}
+export interface SpeakingRubricQuestion {
+    questionNo: number;
+    score: number;
+    maxScore: number;
+    evidence: string;
+}
+export interface SpeakingRubricSection {
+    code: string;
+    score: number;
+    maxScore: number;
+    questions: SpeakingRubricQuestion[];
+}
+export interface SpeakingRubric {
+    scoringVersion: string;
+    criteria: SpeakingRubricCriterion[];
+    sections?: SpeakingRubricSection[] | null;
+    total: number;
+    maxScore: number;
+    feedback: {
+        en: string;
+        vi: string;
+    } | null;
+    assessedAt: string | null;
+}
+export interface ResultReviewTemplatePart {
+    id: string | number;
+    name?: string;
+    instructions?: string;
+    audioUrl?: string;
+    sections?: Array<{
+        sectionId?: number;
+        name?: string;
+        instructions?: string;
+        startIndex?: number;
+        endIndex?: number;
+        questionType?: string;
+    }>;
+}
 export interface ResultReviewAnswer {
     id?: string;
     questionId: string;
@@ -14,7 +73,11 @@ export interface ResultReviewAnswer {
     partNo: number | null;
     sectionId?: number | null;
     isExample?: boolean;
-    gradingStatus?: string | null;
+    gradingStatus?: ReviewGradingStatus | string | null;
+    questionGroup?: {
+        id?: string | number;
+        payload?: unknown;
+    } | null;
     explanation?: string;
     teacherScore?: number | null;
     teacherFeedback?: string | null;
@@ -42,6 +105,7 @@ export interface ResultReviewDetail {
     rank?: number;
     totalStudents?: number;
     status?: string;
+    templateCode?: string | null;
     isPendingGrading?: boolean;
     showDetailedResults?: boolean;
     answers: ResultReviewAnswer[];
@@ -51,6 +115,7 @@ export interface ResultReviewDetail {
         percentage: number;
         feedback: string;
     } | undefined> | null;
+    speakingRubric?: SpeakingRubric | null;
 }
 export interface ResultReviewAttempt {
     id: string;
@@ -62,8 +127,9 @@ export interface ResultReviewAttempt {
     exam?: {
         template?: {
             title?: string;
-            type?: string;
-            parts?: unknown[];
+            type?: ResultTemplateType | string;
+            code?: string;
+            parts?: ResultReviewTemplatePart[];
         };
     };
 }

package/dist/api/result-review.types.js

@@ -1 +1 @@
-export{};
+export var ResultTemplateType;!function(E){E.SPEAKING="SPEAKING"}(ResultTemplateType||(ResultTemplateType={}));export var ReviewGradingStatus;!function(E){E.PENDING="PENDING",E.QUEUED="QUEUED",E.PROCESSING="PROCESSING",E.AUTO_GRADED="AUTO_GRADED",E.GRADED="GRADED",E.COMPLETED="COMPLETED",E.FAILED="FAILED",E.MANUAL_REVIEW="MANUAL_REVIEW",E.NOT_ANSWERED="NOT_ANSWERED"}(ReviewGradingStatus||(ReviewGradingStatus={}));

package/dist/components/exams/entry/EntryRestartDialog.d.ts

@@ -0,0 +1,12 @@
+export interface EntryRestartDialogProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    isStarting: boolean;
+    onContinue: () => void;
+    onRestart: () => void;
+}
+/**
+ * Shown when the student already has an IN_PROGRESS attempt for this room.
+ * Lets them resume the existing attempt or discard it and start fresh.
+ */
+export declare function EntryRestartDialog({ open, onOpenChange, isStarting, onContinue, onRestart, }: EntryRestartDialogProps): import("react").JSX.Element;

package/dist/components/exams/entry/EntryRestartDialog.js

@@ -0,0 +1 @@
+"use client";import{jsx as n,jsxs as i,Fragment as e}from"react/jsx-runtime";import{AlertDialog as t,AlertDialogAction as r,AlertDialogCancel as l,AlertDialogContent as a,AlertDialogDescription as c,AlertDialogFooter as o,AlertDialogHeader as m,AlertDialogTitle as s}from"../../../components/ui/alert-dialog";import{Loader2 as d}from"lucide-react";export function EntryRestartDialog({open:h,onOpenChange:p,isStarting:u,onContinue:g,onRestart:b}){return n(t,{open:h,onOpenChange:p,children:i(a,{children:[i(m,{children:[n(s,{children:"Bạn đang có bài thi dở"}),n(c,{children:"Bạn đã bắt đầu làm bài thi này trước đó. Bạn muốn tiếp tục làm bài hay bắt đầu lại từ đầu?"})]}),i(o,{children:[n(l,{disabled:u,onClick:g,children:"Làm tiếp"}),n(r,{disabled:u,onClick:b,children:u?i(e,{children:[n(d,{className:"mr-2 h-4 w-4 animate-spin"}),"Đang xử lý..."]}):"Làm lại từ đầu"})]})]})})}

package/dist/components/exams/entry/StudentExamEntryPageContainer.d.ts

@@ -0,0 +1,31 @@
+import type { StudentRoom } from '../../../shared/types/student.types';
+import type { ExamEntrySdkApi, ExamEntryRoom } from '../../../api/exam-entry';
+export interface StudentExamEntryPageContainerProps {
+    /** Room id from the route (`/student/exams/:roomId/enter`). */
+    roomId: string;
+    /** Optional invite token (`?invite=...`) to silently join the room first. */
+    inviteToken?: string | null;
+    /** API adapter; create one via `createExamEntryApi`. */
+    api: ExamEntrySdkApi;
+    /** Navigation callback; falls back to `window.location.href` when omitted. */
+    onNavigate?: (href: string) => void;
+    /** Path to navigate to when starting/continuing the attempt. */
+    takePath?: (roomId: string) => string;
+    /** Path to navigate to on close/back. Overrides the default contest/discover logic. */
+    closePath?: (room: StudentRoom | null) => string;
+    /** Slot to render the host app's registration form when required. */
+    renderRegistrationForm?: (props: {
+        room: ExamEntryRoom;
+        onSubmit: (formData: Record<string, unknown>) => Promise<void> | void;
+        isSubmitting: boolean;
+    }) => React.ReactNode;
+}
+/**
+ * SDK container for the fullscreen student exam entry screen. Ports the host
+ * app's `/student/exams/:roomId/enter` flow: invite join, access/exam/
+ * registration gating, room-window state machine, active-attempt resume, the
+ * restart-or-continue dialog, and the themed waiting rooms (TOEIC / Cambridge
+ * YLE / Summer Sky). Infrastructure is injected via {@link ExamEntrySdkApi},
+ * `onNavigate`, and `renderRegistrationForm`.
+ */
+export declare function StudentExamEntryPageContainer({ roomId, inviteToken, api, onNavigate, takePath, closePath, renderRegistrationForm, }: StudentExamEntryPageContainerProps): import("react").JSX.Element;

package/dist/components/exams/entry/StudentExamEntryPageContainer.js

@@ -0,0 +1 @@
+"use client";import{jsx as e,Fragment as t,jsxs as a}from"react/jsx-runtime";import{useState as r,useEffect as n,useCallback as i,useMemo as o}from"react";import{Dialog as s,DialogContent as l,DialogDescription as d,DialogTitle as c}from"../../../components/ui/dialog";import{t as m}from"../../../shared/lib/i18n";import{ROUTES as h}from"../../../shared/constants/routes";import{normalizeExamTheme as x,resolveThemeConfig as u}from"../../../shared/lib/themes";import{unwrap as p}from"../take/exam-taking.utils";import{toast as g}from"sonner";import{Loader2 as b,Clock as f,Trophy as v,ArrowLeft as w}from"lucide-react";import y from"next/image";import{BeforeStartCard as N,ExpiredCard as _,AlreadySubmittedCard as k}from"../../../components/features/exam-entry";import{CloseButton as T}from"../../../components/features/exam-entry/themed/components";import{ToeicWaitingRoom as E}from"../../../components/features/exam-entry/themed/ToeicWaitingRoom";import{CambridgeYleWaitingRoom as D}from"../../../components/features/exam-entry/themed/CambridgeYleWaitingRoom";import{SummerSkyWaitingRoom as S}from"../../../components/themes/summer-sky/SummerSkyWaitingRoom";import{FullscreenLoading as R}from"./fullscreen-loading";export function StudentExamEntryPageContainer({roomId:I,inviteToken:A=null,api:O,onNavigate:M,takePath:C=e=>`/student/exams/${e}/take`,closePath:B,renderRegistrationForm:W}){const L=i(e=>{M?M(e):"undefined"!=typeof window&&(window.location.href=e)},[M]),[j,F]=r(null),[z,U]=r(null),[$,P]=r("LOADING"),[X,Y]=r(0),[H,V]=r(5),[G,K]=r(!1),[Q,q]=r(!1),[J,Z]=r(null),[ee,te]=r(!1),[ae,re]=r(!1),[ne,ie]=r(!1),oe=o(()=>{const e=j?.exam?.theme,t=j?.exam?.template?.theme;return u({examTheme:e,templateTheme:t,level:j?.exam?.level})},[j?.exam,I,j]),se=o(()=>B?B(j):j?.contest?.id?h.STUDENT.CONTEST_ROOMS(j.contest.id):h.STUDENT.CONTESTS_DISCOVER,[B,j]),le=i((e,t)=>{const a=!0===e.allowMultipleSubmissions;if(t){const e=t.status;if("SUBMITTED"===e||"GRADED"===e||"PUBLISHED"===e)return a?"WITHIN_WINDOW":"ALREADY_SUBMITTED";if("IN_PROGRESS"===e)return"WITHIN_WINDOW"}const r=(new Date).getTime(),n=e.startDatetime?new Date(e.startDatetime).getTime():null,i=e.endDatetime?new Date(e.endDatetime).getTime():null;return!a&&i&&r>i?"EXPIRED":n&&r<n?"BEFORE_START":"WITHIN_WINDOW"},[]);n(()=>{(async()=>{try{if(A)try{await(O.joinViaInvite?.(I,A))}catch{}const e=await O.getRoom(I),t=p(e);if(F(t),!t.canAccess&&!A)return void P("NO_ACCESS");if(t.registrationFormConfig?.enabled&&t.registrationFormConfig.fields?.length>0&&!t.hasSubmittedFormData)return void re(!0);if(!t.exam)return void P("NO_EXAM");const a=await O.getActiveAttemptByRoom(I),r=p(a);r&&(Z(r),U(r));const n=!0===t.allowMultipleSubmissions;if(t.hasJoined&&!r&&!n)return void P("ALREADY_SUBMITTED");const i=le(t,r??null);if(P(i),"BEFORE_START"===i&&t.startDatetime){const e=new Date(t.startDatetime).getTime(),a=(new Date).getTime();Y(Math.max(0,Math.floor((e-a)/1e3)))}}catch(e){console.error("Failed to load room data:",e),g.error(m("student.exam.entry.loadError"))}})()},[I,A,le]),n(()=>{if("BEFORE_START"!==$||X<=0)return;const e=setInterval(()=>{Y(e=>e<=1?(P("WITHIN_WINDOW"),0):e-1)},1e3);return()=>clearInterval(e)},[$,X]);const de=i(async()=>{try{K(!0),await O.startAttempt(I),L(C(I))}catch(e){const t=e,a=t.response?.data?.errorCode;"ROOM_NO_EXAM"===a?P("NO_EXAM"):"ROOM_NOT_STARTED"===a?(g.error(m("student.exam.entry.notStarted")),P("BEFORE_START"),q(!1),V(5)):"ROOM_ENDED"===a?(g.error(m("student.exam.entry.expired")),P("EXPIRED")):"ATTEMPT_ALREADY_SUBMITTED"===a?(g.error("Bạn đã hoàn thành bài thi này rồi."),P("ALREADY_SUBMITTED")):g.error(m("student.exam.entry.startError")),K(!1)}},[I]),ce=i(()=>{J?te(!0):de()},[J,de]),me=i(()=>{te(!1),g.success(m("student.exam.entry.continue")),L(C(I))},[I]),he=i(async()=>{if(J)try{te(!1),K(!0),await O.deleteAttempt(J.id),Z(null),await de()}catch(e){console.error("Failed to restart attempt:",e),g.error(m("student.exam.entry.restartError")),K(!1)}},[J,de]);n(()=>{if(!Q||H<=0)return;const e=setInterval(()=>{V(e=>e<=1?(L(C(I)),0):e-1)},1e3);return()=>clearInterval(e)},[Q,H,I]);const xe=i(async e=>{if(j?.contest?.id){ie(!0);try{await(O.registerContest?.(j.contest.id,e)),re(!1);const t=await O.getRoom(I),a=p(t);if(F(a),!a.exam)return void P("NO_EXAM");const r=await O.getActiveAttemptByRoom(I),n=p(r);n&&(Z(n),U(n));const i=!0===a.allowMultipleSubmissions;if(a.hasJoined&&!n&&!i)return void P("ALREADY_SUBMITTED");const o=le(a,n??null);if(P(o),"BEFORE_START"===o&&a.startDatetime){const e=new Date(a.startDatetime).getTime(),t=(new Date).getTime();Y(Math.max(0,Math.floor((e-t)/1e3)))}}catch{g.error("Không thể gửi thông tin đăng ký. Vui lòng thử lại.")}finally{ie(!1)}}},[j?.contest?.id,I,le]);if(ae&&j?.registrationFormConfig&&W)return a(t,{children:[e(R,{}),W({room:j,onSubmit:xe,isSubmitting:ne})]});if("LOADING"===$)return e(R,{});if("NO_EXAM"===$)return e("div",{className:"fixed inset-0 z-50 flex items-center justify-center overflow-hidden bg-gradient-to-b from-sky-100 via-blue-50 to-indigo-100",children:a("div",{className:"mx-auto max-w-md p-4 text-center",children:[e("div",{className:"mb-6 text-7xl",children:"📝✨"}),e("h2",{className:"mb-3 text-2xl font-bold text-sky-700",children:"Bài thi đang được chuẩn bị"}),j&&a("div",{className:"mb-4 rounded-xl bg-white/60 px-5 py-3 text-left text-sm text-sky-700 shadow-sm backdrop-blur-sm",children:[e("p",{className:"font-semibold text-base",children:j.name}),j.code&&a("p",{className:"mt-1 text-sky-500",children:["Mã phòng: ",e("span",{className:"font-mono font-medium",children:j.code})]}),(j.startDatetime||j.endDatetime)&&a("p",{className:"mt-1 text-sky-500",children:["Thời gian thi:"," ",j.startDatetime?new Date(j.startDatetime).toLocaleString("vi-VN"):"—"," → ",j.endDatetime?new Date(j.endDatetime).toLocaleString("vi-VN"):"—"]})]}),e("p",{className:"mb-6 text-base text-sky-600",children:"Thầy cô đang chuẩn bị đề thi cho phòng này. Bạn quay lại sau nhé! 😊"}),e("button",{className:"mx-auto inline-flex items-center gap-2 rounded-2xl border-b-4 border-sky-600 bg-sky-500 px-8 py-3 text-lg font-bold text-white shadow-md transition-all hover:brightness-110 active:translate-y-0.5 active:border-b-2 active:shadow-sm",onClick:()=>window.history.back(),children:"← Quay lại"})]})});if("NO_ACCESS"===$)return e("div",{className:"fixed inset-0 z-50 flex items-center justify-center overflow-hidden bg-gradient-to-b from-red-50 via-orange-50 to-amber-50",children:a("div",{className:"mx-auto max-w-md p-4 text-center",children:[e("div",{className:"mb-6 text-7xl",children:"🔒"}),e("h2",{className:"mb-3 text-2xl font-bold text-red-600",children:"Không có quyền truy cập"}),e("p",{className:"mb-6 text-base text-red-500",children:"Bạn chưa được đăng ký vào phòng thi này. Hãy liên hệ thầy cô để được thêm vào phòng thi nhé!"}),e("button",{className:"mx-auto inline-flex items-center gap-2 rounded-2xl border-b-4 border-red-600 bg-red-500 px-8 py-3 text-lg font-bold text-white shadow-md transition-all hover:brightness-110 active:translate-y-0.5 active:border-b-2 active:shadow-sm",onClick:()=>window.history.back(),children:"← Quay lại"})]})});const ue="TOEIC"===j?.exam?.template?.subTitle,pe="SUMMER_SKY"===x(j?.exam?.theme||j?.exam?.template?.theme);if("WITHIN_WINDOW"===$&&j)return a(t,{children:[ue?e(E,{room:j,onStart:ce,isStarting:G,showCountdown:Q,autoStartCountdown:H,closeRedirectUrl:se,onClose:()=>{L(se)}}):pe?e(S,{room:j,onStart:ce,isStarting:G,onExit:()=>{L(se)}}):e(D,{room:j,onStart:ce,isStarting:G,showCountdown:Q,autoStartCountdown:H,closeRedirectUrl:se,onClose:()=>{L(se)}}),e(s,{open:ee,onOpenChange:te,children:e(l,{className:"overflow-visible border-0 bg-transparent p-0 shadow-none sm:max-w-md",children:a("div",{className:"relative overflow-visible rounded-[28px] bg-gradient-to-br from-cyan-300/25 via-white/5 to-white/0 p-px shadow-[0_30px_80px_-20px_rgba(10,75,140,0.85)] backdrop-blur-xl",children:[e("div",{className:"pointer-events-none absolute -left-16 -top-16 h-48 w-48 rounded-full bg-cyan-400/35 blur-3xl"}),e("div",{className:"pointer-events-none absolute -right-16 -bottom-16 h-48 w-48 rounded-full bg-sky-500/30 blur-3xl"}),e("div",{className:"pointer-events-none absolute left-1/2 top-0 h-24 w-1/2 -translate-x-1/2 rounded-full bg-cyan-300/15 blur-2xl"}),a("div",{className:"relative overflow-hidden rounded-[calc(28px-1px)] bg-gradient-to-b from-[#0e3d70]/97 via-[#0a4b8c]/97 to-[#072d54]/97 ring-1 ring-cyan-300/25",children:[e("div",{className:"pointer-events-none absolute inset-0 opacity-[0.04]",style:{backgroundImage:"radial-gradient(circle at 1px 1px, white 1px, transparent 0)",backgroundSize:"24px 24px"}}),e("div",{className:"pointer-events-none absolute inset-x-0 top-0 h-px bg-gradient-to-r from-transparent via-cyan-300/40 to-transparent"}),a("div",{className:"relative flex flex-col items-center gap-4 px-8 pt-10 pb-6",children:[a("div",{className:"relative",children:[e("div",{className:"absolute inset-0 animate-ping rounded-full bg-cyan-300/30",style:{animationDuration:"2.8s"}}),e("div",{className:"absolute -inset-3 rounded-full bg-gradient-to-br from-cyan-300/15 to-sky-500/10 blur-md"}),e("div",{className:"absolute -inset-1.5 rounded-full bg-gradient-to-br from-cyan-200/30 to-sky-400/20"}),e("div",{className:"relative flex h-16 w-16 items-center justify-center rounded-full bg-gradient-to-br from-cyan-300 via-sky-500 to-sky-700 shadow-[0_10px_30px_-6px_rgba(34,211,238,0.7),inset_0_2px_4px_rgba(255,255,255,0.4)] ring-[3px] ring-cyan-200/40",children:a("svg",{className:"h-8 w-8 text-white drop-shadow-[0_2px_3px_rgba(0,0,0,0.3)]",viewBox:"0 0 24 24",fill:"none",stroke:"currentColor",strokeWidth:"2.5",strokeLinecap:"round",strokeLinejoin:"round",children:[e("path",{d:"M10.29 3.86L1.82 18a2 2 0 0 0 1.71 3h16.94a2 2 0 0 0 1.71-3L13.71 3.86a2 2 0 0 0-3.42 0z"}),e("line",{x1:"12",y1:"9",x2:"12",y2:"13"}),e("line",{x1:"12",y1:"17",x2:"12.01",y2:"17"})]})})]}),a("div",{className:"flex flex-col items-center gap-2",children:[e(c,{className:"text-center text-xl font-black tracking-tight text-white drop-shadow-[0_2px_8px_rgba(34,211,238,0.4)]",children:"Bạn đang có bài thi dở"}),e(d,{className:"max-w-sm text-center text-[13px] font-medium leading-relaxed text-cyan-100/75",children:"Bạn đã bắt đầu làm bài thi này trước đó. Bạn muốn tiếp tục làm bài hay bắt đầu lại từ đầu?"})]})]}),e("div",{className:"mx-8 h-px bg-gradient-to-r from-transparent via-cyan-300/30 to-transparent"}),a("div",{className:"relative flex flex-col-reverse gap-3 px-8 py-6 sm:flex-row sm:justify-center",children:[a("button",{onClick:me,className:"group relative inline-flex min-w-[140px] cursor-pointer items-center justify-center gap-2 overflow-hidden rounded-full bg-white/[0.08] px-7 py-3 text-sm font-bold text-white ring-1 ring-cyan-200/30 backdrop-blur-md transition-all duration-200 hover:-translate-y-0.5 hover:bg-white/[0.14] hover:ring-cyan-200/60 hover:shadow-[0_8px_20px_-4px_rgba(34,211,238,0.3)] active:translate-y-0",children:[e("span",{className:"pointer-events-none absolute inset-0 -translate-x-full bg-gradient-to-r from-transparent via-white/20 to-transparent transition-transform duration-700 group-hover:translate-x-full"}),e("span",{className:"relative",children:"Làm tiếp"})]}),a("button",{onClick:he,disabled:G,className:"group relative inline-flex min-w-[160px] cursor-pointer items-center justify-center gap-2 overflow-hidden rounded-full bg-gradient-to-b from-[#ffd54a] via-[#ffb733] to-[#ff8a1f] px-7 py-3 text-sm font-black uppercase tracking-wide text-white shadow-[0_6px_0_0_#c46410,0_10px_22px_rgba(255,138,31,0.5)] ring-2 ring-orange-300/70 transition-all duration-150 hover:-translate-y-0.5 hover:brightness-110 hover:shadow-[0_8px_0_0_#c46410,0_14px_26px_rgba(255,138,31,0.55)] active:translate-y-1.5 active:shadow-[0_1px_0_0_#c46410,0_3px_8px_rgba(255,138,31,0.3)] disabled:cursor-not-allowed disabled:opacity-70",style:{textShadow:"0 2px 0 rgba(180,80,10,0.55)"},children:[e("span",{className:"pointer-events-none absolute inset-x-0 top-0 h-1/2 bg-gradient-to-b from-white/30 to-transparent"}),G?a(t,{children:[e(b,{className:"relative h-4 w-4 animate-spin"}),e("span",{className:"relative",children:"Đang xử lý..."})]}):e("span",{className:"relative",children:"Làm lại từ đầu"})]})]})]})]})})})]});const ge=oe.visuals?.backgroundFilter??"grayscale(1) blur(10px) saturate(0.85) brightness(0.9)",be=oe.visuals?.backgroundOverlay??"linear-gradient(to bottom, rgba(0, 0, 0, 0.2), transparent, rgba(0, 0, 0, 0.3))",fe=oe.visuals?.cardBackground??"radial-gradient(60% 60% at 50% 40%, rgba(184, 229, 157, 0.85) 0%, rgba(115, 213, 133, 0.85) 100%)";return a("div",{className:"fixed inset-0 z-50 flex items-center justify-center overflow-hidden",children:[e("div",{className:"absolute inset-0 scale-110 bg-cover bg-center",style:{backgroundImage:`url(${oe.assets.background})`,filter:ge}}),e("div",{className:"absolute inset-0",style:{background:be}}),a("div",{className:"relative z-10 w-[88%] max-w-2xl sm:w-[70%] md:w-[50%] lg:w-[42%]",children:[e(T,{imageSrc:oe.assets.closeButton,onClick:()=>L(se),className:"absolute -right-3 -top-7 z-30",size:72}),a("div",{className:"absolute left-1/2 top-0 z-10 -translate-x-1/2 -translate-y-1/2",children:[e(y,{src:oe.assets.titleBar,alt:"",width:260,height:56,className:"drop-shadow-lg",priority:!0,unoptimized:!0}),e("span",{className:"absolute inset-0 mt-2.5 flex items-center justify-center pb-1 text-sm font-extrabold tracking-wider text-white drop-shadow",children:oe.displayName})]}),a("div",{className:"relative overflow-hidden rounded-3xl shadow-2xl ring-1 ring-white/20",children:[e("div",{className:"h-2 w-full",style:{backgroundImage:`url(${oe.assets.cardFrame})`,backgroundSize:"100% 100%"}}),a("div",{className:"relative p-6 pt-12 md:p-8 md:pt-14",style:{background:fe},children:[a("div",{className:"mb-4 rounded-2xl bg-black/20 px-4 py-3.5 text-center ring-1 ring-white/10 backdrop-blur-sm",children:[e("h2",{className:"text-base font-extrabold tracking-wide text-white drop-shadow-sm",children:j?.name}),j?.exam?.name&&e("p",{className:"mt-0.5 text-xs font-medium text-white/80",children:j.exam.name})]}),(j?.exam?.durationMinutes||j?.exam?.totalScore)&&a("div",{className:"mb-4 grid grid-cols-2 gap-3",children:[j?.exam?.durationMinutes&&a("div",{className:"flex flex-col items-center rounded-2xl bg-black/20 px-2 py-4 ring-1 ring-white/10 backdrop-blur-sm",children:[e("div",{className:"mb-2 flex h-8 w-8 items-center justify-center rounded-full bg-white/10",children:e(f,{className:"h-4 w-4 text-white"})}),e("span",{className:"text-2xl font-extrabold text-white",children:j.exam.durationMinutes}),e("span",{className:"text-xs font-semibold text-white/80",children:"Phút"})]}),j?.exam?.totalScore&&a("div",{className:"flex flex-col items-center rounded-2xl bg-black/20 px-2 py-4 ring-1 ring-white/10 backdrop-blur-sm",children:[e("div",{className:"mb-2 flex h-8 w-8 items-center justify-center rounded-full bg-white/10",children:e(v,{className:"h-4 w-4 text-white"})}),e("span",{className:"text-2xl font-extrabold text-white",children:j.exam.totalScore}),e("span",{className:"text-xs font-semibold text-white/80",children:"Thang điểm"})]})]}),"BEFORE_START"===$&&e(N,{countdown:X,formatCountdown:e=>{const t=Math.floor(e/86400),a=Math.floor(e%86400/3600),r=Math.floor(e%3600/60),n=e%60;return t>0?`${t} ngày ${a} giờ ${r} phút`:a>0?`${a} giờ ${r} phút ${n} giây`:r>0?`${r} phút ${n} giây`:`${n} giây`}}),"EXPIRED"===$&&e(_,{}),"ALREADY_SUBMITTED"===$&&e(k,{attempt:z}),e("div",{className:"mt-5 flex justify-center",children:a("button",{className:"group relative inline-flex cursor-pointer items-center gap-2 rounded-full bg-[#0473f9] px-8 py-3 shadow-[0_4px_0_0_#1d4ed8] transition-all duration-150 hover:brightness-110 active:translate-y-[2px] active:shadow-[0_2px_0_0_#1d4ed8]",onClick:()=>L(se),children:[e(w,{className:"h-5 w-5 text-white transition-transform group-hover:-translate-x-0.5"}),e("span",{className:"text-sm font-extrabold uppercase tracking-wider text-white",children:"Quay lại"})]})}),e("div",{className:"pointer-events-none absolute -bottom-1 -left-1 opacity-60",children:e(y,{src:oe.assets.bottomLeft,alt:"",width:80,height:80,unoptimized:!0})}),e("div",{className:"pointer-events-none absolute -bottom-1 -right-1 opacity-60",children:e(y,{src:oe.assets.bottomRight,alt:"",width:80,height:80,unoptimized:!0})})]})]})]})]})}

package/dist/components/exams/entry/exam-entry.states.d.ts

@@ -0,0 +1,22 @@
+import type { ExamEntryAttempt, ExamEntryRoom } from '../../../api/exam-entry.types';
+/** Fullscreen loader used while room/attempt data is being fetched. */
+export declare function EntryLoading(): import("react").JSX.Element;
+/** Child-friendly message screen shared by NO_EXAM / NO_ACCESS states. */
+export declare function EntryMessage({ emoji, title, description, room, tone, onBack, }: {
+    emoji: string;
+    title: string;
+    description: string;
+    room?: ExamEntryRoom | null;
+    tone: 'sky' | 'red';
+    onBack: () => void;
+}): import("react").JSX.Element;
+/** Default (non-themed) waiting room card with exam stats and a start button. */
+export declare function EntryWaitingRoom({ room, state, countdownLabel, attempt, isStarting, onStart, onBack, }: {
+    room: ExamEntryRoom;
+    state: 'BEFORE_START' | 'WITHIN_WINDOW' | 'EXPIRED' | 'ALREADY_SUBMITTED';
+    countdownLabel?: string;
+    attempt?: ExamEntryAttempt | null;
+    isStarting: boolean;
+    onStart: () => void;
+    onBack: () => void;
+}): import("react").JSX.Element;

package/dist/components/exams/entry/exam-entry.states.js

@@ -0,0 +1 @@
+"use client";import{jsx as e,jsxs as t}from"react/jsx-runtime";import{ArrowLeft as a,Clock as l,Loader2 as n,Trophy as s}from"lucide-react";import{Button as i}from"../../../components/ui/button";export function EntryLoading(){return e("div",{className:"fixed inset-0 z-50 flex items-center justify-center bg-gradient-to-b from-sky-100 via-blue-50 to-indigo-100",children:e(n,{className:"h-10 w-10 animate-spin text-sky-600"})})}export function EntryMessage({emoji:a,title:l,description:n,room:s,tone:i,onBack:r}){const o="red"===i?"text-red-600":"text-sky-700",m="red"===i?"border-red-600 bg-red-500":"border-sky-600 bg-sky-500";return e("div",{className:`fixed inset-0 z-50 flex items-center justify-center overflow-hidden bg-gradient-to-b ${"red"===i?"from-red-50 via-orange-50 to-amber-50":"from-sky-100 via-blue-50 to-indigo-100"}`,children:t("div",{className:"mx-auto max-w-md p-4 text-center",children:[e("div",{className:"mb-6 text-7xl",children:a}),e("h2",{className:`mb-3 text-2xl font-bold ${o}`,children:l}),s&&t("div",{className:"mb-4 rounded-xl bg-white/60 px-5 py-3 text-left text-sm text-sky-700 shadow-sm backdrop-blur-sm",children:[e("p",{className:"text-base font-semibold",children:s.name}),s.code&&t("p",{className:"mt-1 text-sky-500",children:["Mã phòng: ",e("span",{className:"font-mono font-medium",children:s.code})]})]}),e("p",{className:"mb-6 text-base "+("red"===i?"text-red-500":"text-sky-600"),children:n}),e("button",{className:`mx-auto inline-flex items-center gap-2 rounded-2xl border-b-4 px-8 py-3 text-lg font-bold text-white shadow-md transition-all hover:brightness-110 active:translate-y-0.5 active:border-b-2 active:shadow-sm ${m}`,onClick:r,children:"← Quay lại"})]})})}export function EntryWaitingRoom({room:o,state:m,countdownLabel:d,attempt:c,isStarting:x,onStart:b,onBack:h}){return e("div",{className:"fixed inset-0 z-50 flex items-center justify-center overflow-hidden bg-gradient-to-b from-sky-100 via-blue-50 to-indigo-100",children:t("div",{className:"relative z-10 w-[88%] max-w-lg rounded-3xl bg-white p-6 shadow-2xl md:p-8",children:[t("div",{className:"mb-4 rounded-2xl bg-slate-50 px-4 py-3.5 text-center",children:[e("h2",{className:"text-base font-extrabold tracking-wide text-slate-800",children:o.name}),o.exam?.name&&e("p",{className:"mt-0.5 text-xs font-medium text-slate-500",children:o.exam.name})]}),(o.exam?.durationMinutes||o.exam?.totalScore)&&t("div",{className:"mb-4 grid grid-cols-2 gap-3",children:[null!=o.exam?.durationMinutes&&e(r,{icon:e(l,{className:"h-4 w-4"}),value:o.exam.durationMinutes,label:"Phút"}),null!=o.exam?.totalScore&&e(r,{icon:e(s,{className:"h-4 w-4"}),value:o.exam.totalScore,label:"Thang điểm"})]}),"BEFORE_START"===m&&t("p",{className:"mb-5 text-center text-sm font-semibold text-slate-600",children:["Bài thi sẽ bắt đầu sau ",d]}),"EXPIRED"===m&&e("p",{className:"mb-5 text-center text-sm font-semibold text-red-500",children:"Bài thi đã kết thúc."}),"ALREADY_SUBMITTED"===m&&t("p",{className:"mb-5 text-center text-sm font-semibold text-slate-600",children:["Bạn đã hoàn thành bài thi này",null!=c?.totalScore?` • Điểm: ${c.totalScore}`:"","."]}),t("div",{className:"flex flex-col items-center gap-3",children:["WITHIN_WINDOW"===m&&t(i,{onClick:b,disabled:x,className:"min-w-[180px] bg-blue-600 hover:bg-blue-700",children:[x?e(n,{className:"mr-2 h-4 w-4 animate-spin"}):null,"Bắt đầu làm bài"]}),t(i,{variant:"outline",onClick:h,children:[e(a,{className:"mr-2 h-4 w-4"}),"Quay lại"]})]})]})})}function r({icon:a,value:l,label:n}){return t("div",{className:"flex flex-col items-center rounded-2xl bg-slate-50 px-2 py-4",children:[e("div",{className:"mb-2 flex h-8 w-8 items-center justify-center rounded-full bg-slate-100 text-slate-600",children:a}),e("span",{className:"text-2xl font-extrabold text-slate-800",children:l}),e("span",{className:"text-xs font-semibold text-slate-500",children:n})]})}