@tinyweb_dev/oe-exam-sdk 0.1.3 → 0.1.4

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`:
@@ -129,12 +180,15 @@ Renderer câu hỏi trong màn làm bài hiện là `GenericQuestionRenderer`.
   attemptId={attemptId}
   token={token}
   api={createResultReviewApi({ baseUrl })}
+  isPrintMode={isPrintMode}
   topActionsSlot={null}
   beforeReportSlot={null}
   afterReportSlot={null}
 />
 ```
 
+Container tự poll lại kết quả khi còn câu đang chấm hoặc LLM assessment chưa sẵn sàng, dừng poll ở `isPrintMode` và phát tín hiệu `body[data-pdf-ready="true"]` cho headless PDF renderer. Lỗi 403 "kết quả chưa công khai" được nhận diện qua helper `isResultNotPublic` và hiển thị màn thông báo riêng thay vì toast lỗi.
+
 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.
 
 ## 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/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})]})}

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

@@ -0,0 +1,16 @@
+import type { ApiData, ExamEntryAttempt, ExamEntryRoom } from '../../../api/exam-entry.types';
+/** Entry screen state machine, mirrors the host app's EntryState. */
+export type ExamEntryState = 'LOADING' | 'BEFORE_START' | 'WITHIN_WINDOW' | 'EXPIRED' | 'ALREADY_SUBMITTED' | 'NO_EXAM' | 'NO_ACCESS' | 'REGISTRATION_REQUIRED';
+export declare function unwrap<T>(value: ApiData<T> | T): T;
+export declare function unwrapAttempt(value: ExamEntryAttempt | {
+    attempt: ExamEntryAttempt;
+}): ExamEntryAttempt;
+/**
+ * Determine the entry state from room + attempt data. Ported from the host
+ * app's `determineState`, including the `allowMultipleSubmissions` handling.
+ */
+export declare function determineEntryState(room: ExamEntryRoom, attempt: ExamEntryAttempt | null): ExamEntryState;
+/** Seconds remaining until a room's start time (clamped at 0). */
+export declare function getSecondsUntilStart(room: ExamEntryRoom): number;
+/** Human-friendly countdown string (days/hours/minutes/seconds). */
+export declare function formatCountdown(seconds: number): string;

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

@@ -0,0 +1 @@
+const t=new Set(["SUBMITTED","GRADED","PUBLISHED"]);export function unwrap(t){return function(t){return"object"==typeof t&&null!==t&&"data"in t}(t)?t.data:t}export function unwrapAttempt(t){return"attempt"in t?t.attempt:t}export function determineEntryState(e,n){const r=!0===e.allowMultipleSubmissions;if(n){const e=n.status??"";if(t.has(e))return r?"WITHIN_WINDOW":"ALREADY_SUBMITTED";if("IN_PROGRESS"===e)return"WITHIN_WINDOW"}const a=Date.now(),o=e.startDatetime?new Date(e.startDatetime).getTime():null,i=e.endDatetime?new Date(e.endDatetime).getTime():null;return!r&&i&&a>i?"EXPIRED":o&&a<o?"BEFORE_START":"WITHIN_WINDOW"}export function getSecondsUntilStart(t){if(!t.startDatetime)return 0;const e=new Date(t.startDatetime).getTime();return Math.max(0,Math.floor((e-Date.now())/1e3))}export function formatCountdown(t){const e=Math.floor(t/86400),n=Math.floor(t%86400/3600),r=Math.floor(t%3600/60),a=t%60;return e>0?`${e} ngày ${n} giờ ${r} phút`:n>0?`${n} giờ ${r} phút ${a} giây`:r>0?`${r} phút ${a} giây`:`${a} giây`}

package/dist/components/exams/entry/fullscreen-loading.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Fullscreen loading component for exam entry/taking.
+ * Matches the themed waiting-room visual style with a blurred background.
+ */
+export declare function FullscreenLoading(): import("react").JSX.Element;

package/dist/components/exams/entry/fullscreen-loading.js

@@ -0,0 +1 @@
+"use client";import{jsx as e,jsxs as t}from"react/jsx-runtime";import{Loader2 as s}from"lucide-react";import{getTheme as a}from"../../../shared/lib/themes";export function FullscreenLoading(){const r=a(),i=r.visuals?.backgroundFilter??"grayscale(1) blur(8px) saturate(0.85) brightness(0.9)",l=r.visuals?.backgroundOverlay??"linear-gradient(to bottom, rgba(0, 0, 0, 0.1), transparent, rgba(0, 0, 0, 0.2))";return t("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(${r.assets.background})`,filter:i}}),e("div",{className:"absolute inset-0",style:{background:l}}),t("div",{className:"relative z-10 flex flex-col items-center gap-4",children:[e(s,{className:"h-12 w-12 animate-spin text-white drop-shadow-lg"}),e("p",{className:"text-lg font-medium text-white drop-shadow-lg",children:"Đang tải..."})]})]})}

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

@@ -0,0 +1,7 @@
+export { StudentExamEntryPageContainer } from './StudentExamEntryPageContainer';
+export type { StudentExamEntryPageContainerProps } from './StudentExamEntryPageContainer';
+export { EntryRestartDialog } from './EntryRestartDialog';
+export type { EntryRestartDialogProps } from './EntryRestartDialog';
+export { EntryLoading, EntryMessage, EntryWaitingRoom } from './exam-entry.states';
+export { determineEntryState, formatCountdown, getSecondsUntilStart, unwrap, unwrapAttempt, } from './exam-entry.utils';
+export type { ExamEntryState } from './exam-entry.utils';

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

@@ -0,0 +1 @@
+export{StudentExamEntryPageContainer}from"./StudentExamEntryPageContainer";export{EntryRestartDialog}from"./EntryRestartDialog";export{EntryLoading,EntryMessage,EntryWaitingRoom}from"./exam-entry.states";export{determineEntryState,formatCountdown,getSecondsUntilStart,unwrap,unwrapAttempt}from"./exam-entry.utils";

package/dist/components/exams/index.d.ts

@@ -1,4 +1,12 @@
 export * from './take';
+export { StudentExamEntryPageContainer } from './entry';
+export type { StudentExamEntryPageContainerProps } from './entry';
+export { EntryRestartDialog, EntryLoading, EntryMessage, EntryWaitingRoom } from './entry';
+export type { EntryRestartDialogProps } from './entry';
+export { determineEntryState, formatCountdown, getSecondsUntilStart } from './entry';
+export type { ExamEntryState } from './entry';
+export { StudentContestRoomsPageContainer } from './rooms';
+export type { StudentContestRoomsPageContainerProps } from './rooms';
 export { CreateExamPageContainer } from './CreateExamPageContainer';
 export type { CreateExamPageContainerProps } from './CreateExamPageContainer';
 export { CreateExamInfoForm } from './CreateExamInfoForm';

package/dist/components/exams/index.js

@@ -1 +1 @@
-export*from"./take";export{CreateExamPageContainer}from"./CreateExamPageContainer";export{CreateExamInfoForm}from"./CreateExamInfoForm";export{TemplateSelector}from"./TemplateSelector";export{ExamCreator}from"./ExamCreator";export{ExamPartTabs}from"./ExamPartTabs";export{ExamQuestionGrid}from"./ExamQuestionGrid";export{PartAudioUploader}from"./PartAudioUploader";export{createExamQuestionsApi,createExamQuestionsFetchApi,createMockExamQuestionsApi}from"./api";export{ExamQuestionsPageContainer}from"./ExamQuestionsPageContainer";export{UnsavedChangesDialog}from"./UnsavedChangesDialog";export{CompletionDialog}from"./CompletionDialog";export{EXAM_DIFFICULTY,ExamViewDialog}from"./ExamViewDialog";export{ExamPreviewDialog}from"./ExamPreviewDialog";export{QuestionStatus,clearQuestionStatuses,getQuestionStatus,initializeQuestionStatusesFromAPI,setQuestionStatus}from"./exam-question-status";
+export*from"./take";export{StudentExamEntryPageContainer}from"./entry";export{EntryRestartDialog,EntryLoading,EntryMessage,EntryWaitingRoom}from"./entry";export{determineEntryState,formatCountdown,getSecondsUntilStart}from"./entry";export{StudentContestRoomsPageContainer}from"./rooms";export{CreateExamPageContainer}from"./CreateExamPageContainer";export{CreateExamInfoForm}from"./CreateExamInfoForm";export{TemplateSelector}from"./TemplateSelector";export{ExamCreator}from"./ExamCreator";export{ExamPartTabs}from"./ExamPartTabs";export{ExamQuestionGrid}from"./ExamQuestionGrid";export{PartAudioUploader}from"./PartAudioUploader";export{createExamQuestionsApi,createExamQuestionsFetchApi,createMockExamQuestionsApi}from"./api";export{ExamQuestionsPageContainer}from"./ExamQuestionsPageContainer";export{UnsavedChangesDialog}from"./UnsavedChangesDialog";export{CompletionDialog}from"./CompletionDialog";export{EXAM_DIFFICULTY,ExamViewDialog}from"./ExamViewDialog";export{ExamPreviewDialog}from"./ExamPreviewDialog";export{QuestionStatus,clearQuestionStatuses,getQuestionStatus,initializeQuestionStatusesFromAPI,setQuestionStatus}from"./exam-question-status";

package/dist/components/exams/rooms/StudentContestRoomsPageContainer.d.ts

@@ -0,0 +1,18 @@
+import type { ContestRoomsSdkApi } from '../../../api/contest-rooms.types';
+export interface StudentContestRoomsPageContainerProps {
+    /** Contest id from the route (`/student/contests/:contestId/rooms`). */
+    contestId: string;
+    /** API adapter; create one via `createContestRoomsApi`. */
+    api: ContestRoomsSdkApi;
+    /** Navigation callback; falls back to `window.location.href` when omitted. */
+    onNavigate?: (href: string) => void;
+    /** Build the exam-entry path from a roomId. */
+    enterPath?: (roomId: string) => string;
+}
+/**
+ * Renders the student contest rooms-list screen
+ * (`/student/contests/:contestId/rooms`). Fetches rooms + contest detail via
+ * the injected `api`, handles search/filter, room registration and
+ * cancellation, and navigates to the exam-entry screen on room selection.
+ */
+export declare function StudentContestRoomsPageContainer({ contestId, api, onNavigate, enterPath, }: StudentContestRoomsPageContainerProps): import("react").JSX.Element;

package/dist/components/exams/rooms/StudentContestRoomsPageContainer.js

@@ -0,0 +1 @@
+"use client";import{jsx as e,jsxs as t,Fragment as a}from"react/jsx-runtime";import{useEffect as r,useMemo as s,useState as l}from"react";import{Building2 as n,CheckCircle2 as i,ClipboardCheck as d,Clock as o,DoorOpen as c,Globe as m,Loader2 as h,Lock as x,PlayCircle as g,Search as b,Timer as f,Users as p,XCircle as u}from"lucide-react";import{Badge as N}from"../../../components/ui/badge";import{Button as y}from"../../../components/ui/button";import{Input as w}from"../../../components/ui/input";import{Skeleton as v}from"../../../components/ui/skeleton";import{useConfirm as k}from"../../../components/ui/confirm-dialog";import{canCancelRegistration as C,canEnterRoom as D,canRetakeRoom as S,getCountdownParts as E,getRoomSortPriority as R,hasRegistrationStatus as P,isUserEngaged as T,needsRegisterAndEnter as j,needsRegistration as A,unwrap as I}from"./contest-rooms.utils";function L({targetDate:s}){const[n,i]=l(()=>E(s));return r(()=>{const e=setInterval(()=>i(E(s)),1e3);return()=>clearInterval(e)},[s]),n?t("div",{className:"flex items-center gap-1.5",children:[n.days>0&&t(a,{children:[t("div",{className:"flex min-w-[36px] flex-col items-center rounded-md bg-white/80 px-1.5 py-1 shadow-sm",children:[e("span",{className:"text-sm font-bold leading-none text-[#07aff0]",children:n.days}),e("span",{className:"text-[9px] text-gray-400",children:"ngày"})]}),e("span",{className:"text-sm font-bold text-[#07aff0]/40",children:":"})]}),t("div",{className:"flex min-w-[36px] flex-col items-center rounded-md bg-white/80 px-1.5 py-1 shadow-sm",children:[e("span",{className:"text-sm font-bold leading-none text-[#07aff0]",children:String(n.hours).padStart(2,"0")}),e("span",{className:"text-[9px] text-gray-400",children:"giờ"})]}),e("span",{className:"text-sm font-bold text-[#07aff0]/40",children:":"}),t("div",{className:"flex min-w-[36px] flex-col items-center rounded-md bg-white/80 px-1.5 py-1 shadow-sm",children:[e("span",{className:"text-sm font-bold leading-none text-[#07aff0]",children:String(n.minutes).padStart(2,"0")}),e("span",{className:"text-[9px] text-gray-400",children:"phút"})]}),e("span",{className:"text-sm font-bold text-[#07aff0]/40",children:":"}),t("div",{className:"flex min-w-[36px] flex-col items-center rounded-md bg-white/80 px-1.5 py-1 shadow-sm",children:[e("span",{className:"text-sm font-bold leading-none text-[#07aff0]",children:String(n.seconds).padStart(2,"0")}),e("span",{className:"text-[9px] text-gray-400",children:"giây"})]})]}):null}function O({room:a,contest:r}){const s=function(e,t){const a=S(e,t);return e.isCompleted&&!a?{label:"Đã hoàn thành",icon:i,className:"border-emerald-200 bg-emerald-50 text-emerald-700"}:e.hasAttempt&&"COMPLETED"===e.status?{label:"Đã thi",icon:i,className:"border-emerald-200 bg-emerald-50 text-emerald-700"}:e.hasAttempt&&"IN_PROGRESS"===e.attemptStatus?{label:"Đang thi",icon:g,className:"border-blue-200 bg-blue-50 text-blue-700"}:"internal"===e.visibility?"PENDING"===e.registrationStatus?{label:"Chờ phê duyệt",icon:o,className:"border-yellow-200 bg-yellow-50 text-yellow-700"}:"REJECTED"===e.registrationStatus?{label:"Bị từ chối",icon:u,className:"border-red-200 bg-red-50 text-red-700"}:"APPROVED"===e.registrationStatus?{label:"Đã đăng ký",icon:i,className:"border-teal-200 bg-teal-50 text-teal-700"}:{label:"Chưa đăng ký",icon:d,className:"border-gray-200 bg-gray-50 text-gray-500"}:e.hasAttempt&&!a?{label:"Đã thi",icon:i,className:"border-emerald-200 bg-emerald-50 text-emerald-700"}:e.hasAttempt&&a?{label:"Có thể thi lại",icon:c,className:"border-sky-200 bg-sky-50 text-sky-700"}:{label:"Sẵn sàng",icon:c,className:"border-sky-200 bg-sky-50 text-sky-700"}}(a,r),l=s.icon;return t(N,{variant:"outline",className:`rounded-full border-2 px-3 py-1 text-xs font-extrabold uppercase tracking-wide ${s.className}`,children:[e(l,{className:"mr-1 h-3.5 w-3.5"}),s.label]})}export function StudentContestRoomsPageContainer({contestId:g,api:N,onNavigate:E,enterPath:z=e=>`/student/exams/${e}/enter`}){const[G,M]=l(null),[V,B]=l(),[H,J]=l(!0),[$,_]=l(""),[F,K]=l("all"),[Q,U]=l(null),{confirm:X,ConfirmDialog:q}=k(),W=e=>E?E(e):window.location.href=e,Y=async()=>{J(!0);try{const[e,t]=await Promise.all([N.getContestRooms(g),N.getContestDetail(g)]);M(I(e)),B(I(t))}finally{J(!1)}};r(()=>{Y()},[g]);const Z=s(()=>{if(!G||0===G.length)return[];let e=[...G];if($.trim()){const t=$.trim().toLowerCase();e=e.filter(e=>e.name.toLowerCase().includes(t))}return"registered"===F&&(e=e.filter(e=>"APPROVED"===e.registrationStatus||"PENDING"===e.registrationStatus||e.hasAttempt)),e.sort((e,t)=>R(e)-R(t))},[G,$,F]);return H?e("div",{className:"grid grid-cols-1 gap-4 md:grid-cols-2 lg:grid-cols-3",children:[1,2,3,4,5,6].map(a=>t("div",{className:"overflow-hidden rounded-xl border bg-white shadow-sm",children:[e(v,{className:"h-2 w-full"}),t("div",{className:"space-y-3 p-4",children:[e(v,{className:"h-5 w-3/4"}),e(v,{className:"h-4 w-1/2"}),e(v,{className:"h-4 w-2/3"}),t("div",{className:"flex gap-2 pt-2",children:[e(v,{className:"h-8 w-20"}),e(v,{className:"h-8 w-20"})]})]})]},a))}):G&&0!==G.length?t(a,{children:[t("div",{className:"mb-4 flex flex-col gap-3 sm:flex-row sm:items-center sm:justify-between",children:[t("div",{className:"relative w-full sm:max-w-xs",children:[e(b,{className:"absolute left-3.5 top-1/2 h-4 w-4 -translate-y-1/2 text-gray-400"}),e(w,{type:"text",placeholder:"Tìm kiếm phòng thi...",value:$,onChange:e=>_(e.target.value),className:"h-11 rounded-2xl border-2 border-gray-200 pl-10 text-sm font-semibold focus-visible:border-[#07aff0]/40 focus-visible:ring-0"})]}),t("div",{className:"flex items-center gap-1.5 rounded-2xl border-2 border-gray-100 bg-gray-50 p-1.5",children:[e("button",{type:"button",onClick:()=>K("all"),className:"rounded-xl px-4 py-2 text-xs font-extrabold uppercase tracking-wide transition-all "+("all"===F?"border-2 border-b-4 border-[#07aff0]/30 bg-white text-[#07aff0]":"border-2 border-transparent text-gray-400 hover:text-[#07aff0]"),children:"Tất cả"}),e("button",{type:"button",onClick:()=>K("registered"),className:"rounded-xl px-4 py-2 text-xs font-extrabold uppercase tracking-wide transition-all "+("registered"===F?"border-2 border-b-4 border-[#07aff0]/30 bg-white text-[#07aff0]":"border-2 border-transparent text-gray-400 hover:text-[#07aff0]"),children:"Đã đăng ký"})]})]}),0===Z.length&&t("div",{className:"flex flex-col items-center justify-center rounded-2xl border-2 border-dashed border-gray-200 bg-gradient-to-br from-gray-50 to-white py-12",children:[e("div",{className:"flex h-16 w-16 items-center justify-center rounded-full bg-gray-100",children:e(b,{className:"h-8 w-8 text-gray-300"})}),e("p",{className:"mt-3 text-base font-medium text-gray-400",children:"Không tìm thấy phòng thi phù hợp"}),e("p",{className:"mt-1 text-sm text-gray-400",children:"Thử thay đổi từ khóa tìm kiếm hoặc bộ lọc"})]}),e("div",{className:"grid grid-cols-1 gap-4 md:grid-cols-2 xl:grid-cols-3",children:Z.map(r=>{!function(e){if(e.isLocked)return{label:"Đã khóa",className:"border-red-200 bg-red-50 text-red-700",icon:x,canEnter:!1};switch(e.status){case"IN_PROGRESS":return{label:"Đang mở",className:"border-green-200 bg-green-50 text-green-700",icon:c,canEnter:!0};case"COMPLETED":return{label:"Đã kết thúc",className:"border-gray-200 bg-gray-50 text-gray-700",icon:o,canEnter:!1};default:;}}(r);const s=S(r,V),l=!(r.isLocked||"UPCOMING"!==r.status&&r.status),b=D(r,V),w=A(r),v=P(r),k=T(r),E=Q===r.id;return e("div",{className:"group relative flex flex-col overflow-hidden rounded-3xl border-2 border-b-[6px] bg-white shadow-sm transition-all duration-150 hover:-translate-y-0.5 "+(k?"border-[#07aff0]/30":"border-gray-200"),children:t("div",{className:"flex flex-1 flex-col p-5",children:[t("div",{className:"mb-3 flex items-start justify-between gap-3",children:[t("div",{className:"min-w-0 flex-1",children:[t("h3",{className:"flex items-center gap-2 truncate text-lg font-extrabold tracking-tight text-gray-800 group-hover:text-[#07aff0]",children:[(!r.visibility||"public"===r.visibility)&&e("span",{className:"flex h-7 w-7 flex-shrink-0 items-center justify-center rounded-xl bg-emerald-100",children:e(m,{className:"h-4 w-4 text-emerald-500"})}),"internal"===r.visibility&&e("span",{className:"flex h-7 w-7 flex-shrink-0 items-center justify-center rounded-xl bg-amber-100",children:e(n,{className:"h-4 w-4 text-amber-500"})}),"private"===r.visibility&&e("span",{className:"flex h-7 w-7 flex-shrink-0 items-center justify-center rounded-xl bg-gray-100",children:e(x,{className:"h-4 w-4 text-gray-400"})}),e("span",{className:"truncate",children:r.name})]}),t("p",{className:"mt-1 text-xs font-medium text-gray-400",children:["Mã: ",e("span",{className:"font-mono font-bold text-gray-500",children:r.code})]})]}),t("div",{className:"flex flex-shrink-0 items-start gap-2",children:[null!=r.registrationCount&&t("div",{className:"flex items-center gap-1 rounded-full bg-gray-100 px-2.5 py-1 text-gray-500",children:[e(p,{className:"h-3.5 w-3.5"}),e("span",{className:"text-xs font-bold",children:r.registrationCount})]}),r.startDatetime&&e("div",{className:"flex flex-col items-center overflow-hidden rounded-2xl border-2 border-gray-200 bg-white",children:t("div",{className:"flex flex-col items-center px-3 py-1.5",children:[e("span",{className:"text-xl font-extrabold leading-tight text-gray-800",children:new Date(r.startDatetime).getDate()}),t("span",{className:"text-[10px] font-bold uppercase text-gray-400",children:["Th ",new Date(r.startDatetime).getMonth()+1]})]})})]})]}),t("div",{className:"mb-3 space-y-2",children:[t("div",{className:"flex items-center gap-2 text-xs font-semibold text-gray-500",children:[e(d,{className:"h-4 w-4 flex-shrink-0 text-gray-400"}),e("span",{className:"truncate",children:r.examName})]}),r.startDatetime&&t("div",{className:"flex items-center gap-2 text-xs font-semibold text-gray-500",children:[e(o,{className:"h-4 w-4 flex-shrink-0 text-gray-400"}),t("span",{children:[new Date(r.startDatetime).toLocaleTimeString("vi-VN",{hour:"2-digit",minute:"2-digit"}),r.endDatetime&&t(a,{children:[" - ",new Date(r.endDatetime).toLocaleTimeString("vi-VN",{hour:"2-digit",minute:"2-digit"})]})]})]})]}),e("div",{className:"mb-3 flex flex-wrap items-center gap-1.5",children:e(O,{room:r,contest:V})}),!b&&!w&&!v&&l&&r.startDatetime&&t("div",{className:"mb-3 flex items-center gap-2 rounded-2xl border-2 border-[#07aff0]/15 bg-[#07aff0]/5 px-3 py-2",children:[e(f,{className:"h-4 w-4 flex-shrink-0 text-[#07aff0]"}),e("span",{className:"text-xs font-bold text-[#07aff0]",children:"Mở sau"}),e("div",{className:"ml-auto",children:e(L,{targetDate:r.startDatetime})})]}),e("div",{className:"mt-auto pt-3"}),t("div",{className:"flex flex-col gap-2",children:[t("div",{className:"flex flex-wrap items-center gap-2",children:[r.isCompleted&&!s&&t(y,{size:"sm",className:"h-11 flex-1 cursor-default rounded-2xl border-2 border-emerald-200 bg-emerald-50 text-sm font-extrabold uppercase tracking-wide text-emerald-600 hover:bg-emerald-50",disabled:!0,children:[e(i,{className:"mr-2 h-4 w-4"}),"Đã hoàn thành"]}),j(r,V)&&t(y,{size:"sm",className:"h-11 flex-1 rounded-2xl border-b-4 border-[#003d87] bg-[#07aff0] text-sm font-extrabold uppercase tracking-wide text-white shadow-none transition-all hover:bg-[#0060d0] active:translate-y-0.5 active:border-b-2",onClick:()=>(async e=>{U(e);try{await N.registerRoom(g,e),W(z(e))}finally{U(null)}})(r.id),disabled:E,children:[E?e(h,{className:"mr-2 h-4 w-4 animate-spin"}):e(c,{className:"mr-2 h-4 w-4"}),r.hasAttempt?"Đăng kí và Thi lại":"Vào phòng thi"]}),b&&!j(r,V)&&t("div",{className:"flex-1 flex flex-col gap-1.5",children:[r.hasAttempt&&e("div",{className:"rounded-xl border-2 border-amber-200/60 bg-amber-50 px-2 py-1 text-center text-xs font-bold text-amber-600",children:"Bạn đã hoàn thành bài thi"}),t(y,{size:"sm",className:"h-11 w-full rounded-2xl border-0 border-b-4 border-[#05a0db] bg-[#07aff0] text-sm font-extrabold uppercase tracking-wide text-white shadow-none transition-all hover:bg-[#06a0e0] active:translate-y-0.5 active:border-b-2",onClick:()=>W(z(r.id)),children:[e(c,{className:"mr-2 h-4 w-4"}),r.hasAttempt?"Thi lại":"Vào phòng thi"]})]}),w&&t(y,{size:"sm",className:"h-11 flex-1 rounded-2xl border-2 border-b-4 border-[#07aff0]/30 bg-white text-sm font-extrabold uppercase tracking-wide text-[#07aff0] shadow-none transition-all hover:bg-[#07aff0]/5 active:translate-y-0.5 active:border-b-2",onClick:()=>(async e=>{U(e);try{await N.registerRoom(g,e),await Y()}finally{U(null)}})(r.id),disabled:E,children:[E?e(h,{className:"mr-2 h-4 w-4 animate-spin"}):e(d,{className:"mr-2 h-4 w-4"}),"Đăng ký"]}),v&&"PENDING"===r.registrationStatus&&t(y,{size:"sm",className:"h-11 flex-1 cursor-default rounded-2xl border-2 border-yellow-200 bg-yellow-50 text-sm font-extrabold uppercase tracking-wide text-yellow-600 hover:bg-yellow-50",disabled:!0,children:[e(o,{className:"mr-2 h-4 w-4"}),"Đã gửi đăng ký"]}),v&&"REJECTED"===r.registrationStatus&&t(y,{size:"sm",className:"h-11 flex-1 cursor-default rounded-2xl border-2 border-red-200 bg-red-50 text-sm font-extrabold uppercase tracking-wide text-red-600 hover:bg-red-50",disabled:!0,children:[e(u,{className:"mr-2 h-4 w-4"}),"Bị từ chối"]})]}),C(r)&&e("button",{type:"button",className:"self-center text-[11px] font-semibold text-gray-400 underline-offset-2 hover:text-red-500 hover:underline transition-colors disabled:opacity-50",onClick:()=>(async e=>{if(await X({title:"Xác nhận hủy đăng ký",description:"Bạn có chắc chắn muốn hủy đăng ký phòng thi này không? Hành động này không thể hoàn tác.",confirmText:"Hủy đăng ký",cancelText:"Quay lại",variant:"destructive"})&&N.cancelRoomRegistration){U(e);try{await N.cancelRoomRegistration(g,e),await Y()}finally{U(null)}}})(r.id),disabled:E,children:E?"Đang hủy...":"Hủy đăng ký"})]})]})},r.id)})}),e(q,{})]}):t("div",{className:"flex flex-col items-center justify-center rounded-2xl border-2 border-dashed border-gray-200 bg-gradient-to-br from-gray-50 to-white py-16",children:[e("div",{className:"flex h-20 w-20 items-center justify-center rounded-full bg-gray-100",children:e(c,{className:"h-10 w-10 text-gray-300"})}),e("p",{className:"mt-4 text-lg font-medium text-gray-400",children:"Chưa có phòng thi nào trong kỳ thi này"})]})}

package/dist/components/exams/rooms/contest-rooms.utils.d.ts

@@ -0,0 +1,32 @@
+import type { ApiData } from '../../../api/exam-entry.types';
+import type { ContestRoomListItem, ContestRoomsContestDetail } from '../../../api/contest-rooms.types';
+export declare function unwrap<T>(value: ApiData<T> | T): T;
+/** Whether a student can retake a room (room override, falling back to contest default). */
+export declare function canRetakeRoom(room: ContestRoomListItem, contest?: ContestRoomsContestDetail): boolean;
+/** Whether the student can enter the room right now (status + registration gating). */
+export declare function canEnterRoom(room: ContestRoomListItem, contest?: ContestRoomsContestDetail): boolean;
+/**
+ * Public/private rooms need no student-initiated registration — the student
+ * enters directly (the backend auto-approves participation on first attempt).
+ * Registration is an internal-room concept only, so this is always false and
+ * public/private rooms fall through to the plain "enter" button. Kept as a
+ * named helper so the container's button logic reads intently.
+ */
+export declare function needsRegisterAndEnter(_room: ContestRoomListItem, _contest?: ContestRoomsContestDetail): boolean;
+/** Internal room the student hasn't requested registration for yet. */
+export declare function needsRegistration(room: ContestRoomListItem): boolean;
+/** Internal room registration is pending/rejected (i.e. not approved yet). */
+export declare function hasRegistrationStatus(room: ContestRoomListItem): boolean;
+/** Whether a "cancel registration" action should be offered. */
+export declare function canCancelRegistration(room: ContestRoomListItem): boolean;
+/** Whether the student has any meaningful engagement with this room. */
+export declare function isUserEngaged(room: ContestRoomListItem): boolean;
+/** Sort priority for a room; lower = shown first. */
+export declare function getRoomSortPriority(room: ContestRoomListItem): number;
+/** Human-friendly seconds-remaining breakdown for a room's start countdown. */
+export declare function getCountdownParts(targetIso: string): {
+    days: number;
+    hours: number;
+    minutes: number;
+    seconds: number;
+} | null;

package/dist/components/exams/rooms/contest-rooms.utils.js

@@ -0,0 +1 @@
+export function unwrap(t){return function(t){return"object"==typeof t&&null!==t&&"data"in t}(t)?t.data:t}export function canRetakeRoom(t,i){return!0===t.allowMultipleSubmissions||!1!==t.allowMultipleSubmissions&&!0===i?.allowMultipleSubmissions}export function canEnterRoom(t,i){const e=canRetakeRoom(t,i);return!(t.isCompleted&&!e)&&(!t.isLocked&&"IN_PROGRESS"===t.status&&("internal"!==t.visibility||"APPROVED"===t.registrationStatus))}export function needsRegisterAndEnter(t,i){return!1}export function needsRegistration(t){return"internal"===t.visibility&&!t.registrationStatus}export function hasRegistrationStatus(t){return"internal"===t.visibility&&!!t.registrationStatus&&"APPROVED"!==t.registrationStatus}export function canCancelRegistration(t){return!t.hasAttempt&&!t.isCompleted&&("PENDING"===t.registrationStatus||"APPROVED"===t.registrationStatus)}export function isUserEngaged(t){return!(!t.isCompleted&&!t.hasAttempt)||("APPROVED"===t.registrationStatus||"PENDING"===t.registrationStatus)}export function getRoomSortPriority(t){return t.hasAttempt&&"IN_PROGRESS"===t.attemptStatus?0:"IN_PROGRESS"!==t.status||t.isLocked||t.isCompleted||"internal"===t.visibility&&"APPROVED"!==t.registrationStatus?("internal"!==t.visibility||"APPROVED"!==t.registrationStatus||t.isCompleted)&&("internal"===t.visibility||t.hasAttempt||"UPCOMING"!==t.status)?"internal"===t.visibility&&"PENDING"===t.registrationStatus?3:t.isCompleted||t.hasAttempt?4:"internal"!==t.visibility||t.registrationStatus?"internal"===t.visibility&&"REJECTED"===t.registrationStatus?6:"COMPLETED"===t.status||t.isLocked?7:8:5:2:1}export function getCountdownParts(t){const i=new Date(t).getTime()-Date.now();return i<=0?null:{days:Math.floor(i/864e5),hours:Math.floor(i%864e5/36e5),minutes:Math.floor(i%36e5/6e4),seconds:Math.floor(i%6e4/1e3)}}