@tinyweb_dev/oe-exam-sdk 0.1.3 → 0.1.5

package/dist/components/themes/spaceship/assets/styles/SpaceshipWaitingRoom.module.css

@@ -0,0 +1,395 @@
+.waitingRoomContainer {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: flex-start;
+  width: 100%;
+  height: 100%;
+}
+
+.introBoard {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  position: relative;
+  height: 100%;
+  width: 100%;
+}
+
+.title {
+  margin-top: 20px;
+  text-transform: uppercase;
+  font-family: var(--font-nunito-theme), 'Open Sans', system-ui, sans-serif;
+  font-size: 42px;
+  text-align: center;
+  font-weight: 800;
+  letter-spacing: 1.5px;
+  line-height: 1.25;
+  color: #E6635D;
+  margin-bottom: 50px;
+  text-shadow: 2px 3px 0px rgba(230, 99, 93, 0.15);
+}
+
+.instructionIconsWrap {
+  display: flex;
+  justify-content: space-between;
+  gap: 4px;
+  width: 100%;
+  padding: 0 100px;
+  margin-bottom: 2rem;
+}
+
+.instructionIconItem {
+  display: flex;
+  gap: 4px;
+  align-items: center;
+}
+
+.instructionIconImg {
+  width: 120px;
+  height: 120px;
+}
+
+.instructionIconText {
+  color: #541F0C;
+  font-size: 22px;
+  line-height: 26px;
+  font-weight: 400;
+  width: 210px;
+}
+
+.aiBanner {
+  margin: 0 116px 2.5rem;
+  padding: 20px 36px;
+  background: linear-gradient(135deg, #fff5f4 0%, #fceae9 100%);
+  border: 2px solid #e6635d;
+  border-radius: 16px;
+  display: flex;
+  align-items: center;
+  gap: 20px;
+  box-shadow: 0 4px 16px rgba(230, 99, 93, 0.12);
+}
+
+.aiBannerIcon {
+  flex-shrink: 0;
+  width: 60px;
+  height: 60px;
+  background: white;
+  border-radius: 50%;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  box-shadow: 0 2px 10px rgba(230, 99, 93, 0.2);
+}
+
+.aiBannerContent {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+}
+
+.aiBannerTitle {
+  color: #E6635D;
+  font-size: 20px;
+  font-weight: 700;
+  text-transform: uppercase;
+  letter-spacing: 0.5px;
+  margin: 0;
+  line-height: 1.2;
+}
+
+.aiBannerDesc {
+  color: #541F0C;
+  font-size: 18px;
+  font-weight: 400;
+  line-height: 1.5;
+  margin: 0;
+}
+
+.stepButtonContainer {
+  display: flex;
+  justify-content: center;
+  margin-bottom: 30px;
+}
+
+.btnAction {
+  position: relative;
+  display: flex;
+  cursor: pointer;
+}
+
+.btnActionBg {
+  z-index: 0;
+  height: 57px;
+  width: 258px;
+}
+
+.btnActionInner {
+  position: absolute;
+  inset: 0;
+  cursor: pointer;
+  display: flex;
+  justify-content: center;
+  align-items: center;
+  padding-top: 12px;
+}
+
+.btnActionText {
+  color: white;
+  line-height: 1.25;
+  font-family: var(--font-nunito-theme), 'Open Sans', system-ui, sans-serif;
+  font-weight: 800;
+  letter-spacing: 0.5px;
+  text-align: center;
+  margin: 0;
+  width: 100%;
+  user-select: none;
+}
+
+.btnActionTextInner {
+  font-size: 22px;
+  text-transform: uppercase;
+  display: block;
+  text-shadow: rgba(0, 0, 0, 0.25) 0px 3px 0px;
+}
+
+.spacer {
+  height: 60px;
+}
+
+/* Mic Test */
+.micTestTitle {
+  margin-top: 20px;
+  text-transform: uppercase;
+  font-family: var(--font-nunito-theme), 'Open Sans', system-ui, sans-serif;
+  font-size: 42px;
+  text-align: center;
+  font-weight: 800;
+  letter-spacing: 1.5px;
+  line-height: 1.25;
+  color: #E6635D;
+  margin-bottom: 50px;
+  text-shadow: 2px 3px 0px rgba(230, 99, 93, 0.15);
+}
+
+.micTestContainer {
+  background-color: #FCEAE9;
+  border-radius: 10px;
+  width: 1031px;
+  display: flex;
+  flex-direction: column;
+  justify-content: center;
+  align-items: center;
+  padding-top: 35px;
+  padding-bottom: 44px;
+  margin-bottom: 43px;
+}
+
+@media (max-width: 1536px) {
+  .micTestContainer {
+    width: 80%;
+  }
+}
+
+.micTestSubTitle {
+  color: #E6635D;
+  text-align: center;
+  font-size: 16px;
+  font-weight: 400;
+  line-height: 25px;
+  width: 550px;
+}
+
+.micTestInstructionWrap {
+  margin: 0 auto 30px auto;
+  width: fit-content;
+  max-width: 700px;
+  text-align: left;
+  color: #E6635D;
+  font-size: 16px;
+  line-height: 1.6;
+}
+
+.micTestInstructionWrap p {
+  font-weight: 700;
+  margin: 0 0 10px 0;
+  font-size: 17px;
+  text-transform: uppercase;
+}
+
+.micTestList {
+  list-style-type: decimal;
+  padding-left: 36px;
+  margin: 0;
+}
+
+.micTestList li {
+  margin-bottom: 12px;
+  padding-left: 4px;
+}
+
+.micTestBarWrap {
+  position: relative;
+  width: 693px;
+  height: 54px;
+  margin-top: 0px;
+}
+
+.audioBarImg {
+  z-index: 0;
+  filter: hue-rotate(140deg) brightness(0.9) saturate(1.5);
+  width: 100%;
+}
+
+.micTestBarInner {
+  position: absolute;
+  inset: 0;
+}
+
+.relativeFull {
+  position: relative;
+  width: 100%;
+  height: 100%;
+}
+
+.micTestIconWrap {
+  position: absolute;
+  top: -20px;
+  left: -10px;
+  width: 94px;
+  height: 94px;
+  cursor: pointer;
+}
+
+.purpleCircleImg {
+  z-index: 0;
+  filter: hue-rotate(90deg) brightness(1.1) saturate(1.2);
+}
+
+.micTestIconInner {
+  position: absolute;
+  inset: 0;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+}
+
+.focusVectorImg {
+  position: absolute;
+  top: -40px;
+  filter: hue-rotate(120deg) saturate(2);
+}
+
+.microImg {
+  transition: transform 0.2s;
+}
+
+.microImg:hover {
+  transform: scale(1.1);
+}
+
+.micTestTrackWrap {
+  margin-left: 97px;
+  height: 100%;
+  display: flex;
+  align-items: center;
+  gap: 7px;
+  padding-top: 4px;
+  padding-right: 24px;
+}
+
+.micTestTime {
+  color: white;
+  font-size: 14px;
+  font-weight: 700;
+  transform: translateY(2px);
+  white-space: nowrap;
+  padding-right: 8px;
+}
+
+.micTestTrack {
+  border-radius: 2px;
+  height: 10px;
+  background-color: #541F0C;
+  overflow: hidden;
+  flex-grow: 1;
+  box-shadow: rgba(0, 0, 0, 0.5) 0px 0.587px 0px 0px;
+}
+
+.micTestFill {
+  height: 100%;
+  border-radius: 1px;
+  background-color: #FFDC30;
+  box-shadow: rgb(247, 171, 22) 0px -4px 0px 0px inset;
+  transition: width 0.05s linear;
+}
+
+/* ===== Teacher Floating (Phương án B) ===== */
+.teacherFloating {
+  position: fixed;
+  bottom: 0;
+  left: clamp(0px, calc(50vw - 950px), 24px);
+  z-index: 90;
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  animation: teacherSlideIn 1s cubic-bezier(0.16, 1, 0.3, 1) both;
+  animation-delay: 0.3s;
+}
+
+.teacherVideo {
+  width: clamp(120px, calc(50vw - 750px), 280px);
+  height: auto;
+  display: block;
+  filter: drop-shadow(0 4px 24px rgba(230, 99, 93, 0.35));
+  pointer-events: none;
+}
+
+.teacherGlow {
+  position: absolute;
+  bottom: 8px;
+  left: 50%;
+  transform: translateX(-50%);
+  width: clamp(80px, calc(50vw - 780px), 200px);
+  height: clamp(20px, calc(10vw - 150px), 50px);
+  background: radial-gradient(ellipse, rgba(230, 99, 93, 0.3) 0%, transparent 70%);
+  border-radius: 50%;
+  animation: glowPulse 3s ease-in-out infinite;
+  pointer-events: none;
+}
+
+@keyframes teacherSlideIn {
+  0% {
+    opacity: 0;
+    transform: translateY(50px);
+  }
+
+  100% {
+    opacity: 1;
+    transform: translateY(0);
+  }
+}
+
+@keyframes glowPulse {
+
+  0%,
+  100% {
+    opacity: 0.3;
+  }
+
+  50% {
+    opacity: 0.7;
+  }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .teacherFloating {
+    animation: none;
+    opacity: 1;
+  }
+
+  .teacherGlow {
+    animation: none;
+    opacity: 0.5;
+  }
+}

package/dist/components/ui/badge.d.ts

@@ -7,7 +7,7 @@ import { type VariantProps } from 'class-variance-authority';
  * No border by default
  */
 declare const badgeVariants: (props?: {
-    variant?: "default" | "destructive" | "outline" | "secondary" | "success" | "info" | "warning" | "dark";
+    variant?: "default" | "destructive" | "outline" | "secondary" | "warning" | "success" | "info" | "dark";
 } & import("class-variance-authority/types").ClassProp) => string;
 export interface BadgeProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof badgeVariants> {
 }

package/dist/index.d.ts

@@ -6,10 +6,10 @@ export * as Questions from './components/questions';
 export * as Results from './components/results';
 export * as Themes from './components/themes';
 export * as Shared from './shared';
-export { buildExamTemplatePayload, createExamCreateApi, createExamQuestionsApi, createExamQuestionsFetchApi, createExamTakingApi, createMockCreateExamApi, createMockExamQuestionsApi, createMockExamTakingApi, createMockResultReviewApi, createResultReviewApi } from './api';
-export type { AnswerGradingStatusItem, AnswersGradingStatusResult, CreateExamFetchApiOptions, CreateExamPayload, CreateExamSdkApi, ExamFormData, ExamLevelOption, ExamQuestionsSdkApi, ExamResponse, ExamTakingAnswerValue, ExamTakingAttempt, ExamTakingFetchApiOptions, ExamTakingQuestion, ExamTakingQuestionsResult, ExamTakingRoom, ExamTakingSdkApi, ExamTakingTemplatePart, ExamTemplatePayload, ExamWithTemplate, ExistingQuestionBank, FetchApiOptions, GradingSummary, QuestionSearchItem, SaveExamInput, SaveExamTakingAnswersInput, SaveQuestionInput, SaveQuestionResult, SearchQuestionBankInput, SearchQuestionBankResult, SubmitExamTakingAttemptResult, UpdateExamTemplateInput, UpdatePartAudioInput, UploadAudioAnswerResult } from './api';
-export { CreateExamPageContainer, ExamPreviewDialog, ExamQuestionsPageContainer, ExamTakingPageContainer, ExamViewDialog } from './components/exams';
-export type { CreateExamPageContainerProps, CreateExamTexts, ExamPreviewDialogProps, ExamQuestionsPageContainerProps, ExamTakingPageContainerProps, ExamViewDialogExam, ExamViewDialogProps } from './components/exams';
+export { buildExamTemplatePayload, createContestRoomsApi, createExamCreateApi, createExamEntryApi, createExamQuestionsApi, createExamQuestionsFetchApi, createExamTakingApi, createMockContestRoomsApi, createMockCreateExamApi, createMockExamEntryApi, createMockExamQuestionsApi, createMockExamTakingApi, createMockResultReviewApi, createResultReviewApi } from './api';
+export type { AnswerGradingStatusItem, AnswersGradingStatusResult, ContestRoomListItem, ContestRoomRegistrationStatus, ContestRoomVisibility, ContestRoomsContestDetail, ContestRoomsFetchApiOptions, ContestRoomsSdkApi, CreateExamFetchApiOptions, CreateExamPayload, CreateExamSdkApi, ExamFormData, ExamLevelOption, ExamQuestionsSdkApi, ExamResponse, ExamTakingAnswerValue, ExamTakingAttempt, ExamTakingFetchApiOptions, ExamTakingQuestion, ExamTakingQuestionsResult, ExamTakingRoom, ExamTakingSdkApi, ExamTakingTemplatePart, ExamTemplatePayload, ExamWithTemplate, ExistingQuestionBank, FetchApiOptions, GradingSummary, QuestionSearchItem, SaveExamInput, SaveExamTakingAnswersInput, SaveQuestionInput, SaveQuestionResult, SearchQuestionBankInput, SearchQuestionBankResult, SubmitExamTakingAttemptResult, UpdateExamTemplateInput, UpdatePartAudioInput, UploadAudioAnswerResult } from './api';
+export { CreateExamPageContainer, ExamPreviewDialog, ExamQuestionsPageContainer, ExamTakingPageContainer, ExamViewDialog, StudentContestRoomsPageContainer, StudentExamEntryPageContainer } from './components/exams';
+export type { CreateExamPageContainerProps, CreateExamTexts, ExamPreviewDialogProps, ExamQuestionsPageContainerProps, ExamTakingPageContainerProps, ExamViewDialogExam, ExamViewDialogProps, StudentContestRoomsPageContainerProps, StudentExamEntryPageContainerProps } from './components/exams';
 export { ResultReviewPageContainer } from './components/results';
 export type { ResultReviewPageContainerProps } from './components/results';
 export { QuestionCreator } from './components/questions/creator/QuestionCreator';

package/dist/index.js

@@ -1 +1 @@
-export*as Api from"./api";export*as Components from"./components";export*as Mcp from"./mcp";export*as Exams from"./components/exams";export*as Questions from"./components/questions";export*as Results from"./components/results";export*as Themes from"./components/themes";export*as Shared from"./shared";export{buildExamTemplatePayload,createExamCreateApi,createExamQuestionsApi,createExamQuestionsFetchApi,createExamTakingApi,createMockCreateExamApi,createMockExamQuestionsApi,createMockExamTakingApi,createMockResultReviewApi,createResultReviewApi}from"./api";export{CreateExamPageContainer,ExamPreviewDialog,ExamQuestionsPageContainer,ExamTakingPageContainer,ExamViewDialog}from"./components/exams";export{ResultReviewPageContainer}from"./components/results";export{QuestionCreator}from"./components/questions/creator/QuestionCreator";export{QuestionGroupCreator}from"./components/questions/creator/QuestionGroupCreator";export{renderDedicatedComponent}from"./components/questions/creator/dedicated-component-router";export{questionTypeRegistry}from"./components/questions/creator/question-type-registry";export{QUESTION_TYPE_CONFIG,QUESTION_TYPES_WITH_DEDICATED_COMPONENTS}from"./components/questions/_shared/config/question-types.config";export{validateQuestion}from"./components/questions/_shared/utils/question-validation";export{buildAnswerPayload}from"./components/questions/_shared/utils/answer-builder";export*from"./components/questions/_shared/types";
+export*as Api from"./api";export*as Components from"./components";export*as Mcp from"./mcp";export*as Exams from"./components/exams";export*as Questions from"./components/questions";export*as Results from"./components/results";export*as Themes from"./components/themes";export*as Shared from"./shared";export{buildExamTemplatePayload,createContestRoomsApi,createExamCreateApi,createExamEntryApi,createExamQuestionsApi,createExamQuestionsFetchApi,createExamTakingApi,createMockContestRoomsApi,createMockCreateExamApi,createMockExamEntryApi,createMockExamQuestionsApi,createMockExamTakingApi,createMockResultReviewApi,createResultReviewApi}from"./api";export{CreateExamPageContainer,ExamPreviewDialog,ExamQuestionsPageContainer,ExamTakingPageContainer,ExamViewDialog,StudentContestRoomsPageContainer,StudentExamEntryPageContainer}from"./components/exams";export{ResultReviewPageContainer}from"./components/results";export{QuestionCreator}from"./components/questions/creator/QuestionCreator";export{QuestionGroupCreator}from"./components/questions/creator/QuestionGroupCreator";export{renderDedicatedComponent}from"./components/questions/creator/dedicated-component-router";export{questionTypeRegistry}from"./components/questions/creator/question-type-registry";export{QUESTION_TYPE_CONFIG,QUESTION_TYPES_WITH_DEDICATED_COMPONENTS}from"./components/questions/_shared/config/question-types.config";export{validateQuestion}from"./components/questions/_shared/utils/question-validation";export{buildAnswerPayload}from"./components/questions/_shared/utils/answer-builder";export*from"./components/questions/_shared/types";

package/dist/shared/lib/stores/examTakingStore.d.ts

@@ -0,0 +1,54 @@
+import type { StudentQuestion, InitializeData, StoreTemplatePart } from '../../types/exam-taking.types';
+interface ExamTakingState {
+    attemptId: string | null;
+    examRoomId: string | null;
+    questions: StudentQuestion[];
+    answers: Record<string, any>;
+    currentIndex: number;
+    remainingSeconds: number;
+    endsAt: number | null;
+    isInitialized: boolean;
+    isDirty: boolean;
+    lastSavedAt: Date | null;
+    isSubmitting: boolean;
+    isNavDisabled: boolean;
+    flaggedQuestions: Set<string>;
+    currentPartIndex: number;
+    currentQuestionGlobalIndex: number;
+    playedIntroParts: Set<number>;
+    playedListeningAudioParts: Set<string>;
+    examType: string | null;
+    examTitle: string | null;
+    parts: StoreTemplatePart[];
+    hydrateFromServer: (data: InitializeData) => void;
+    setAnswer: (questionId: string, answer: any) => void;
+    nextQuestion: () => void;
+    prevQuestion: () => void;
+    goToQuestion: (index: number) => void;
+    syncRemainingSeconds: () => number;
+    markSaved: () => void;
+    setIsSubmitting: (value: boolean) => void;
+    setIsNavDisabled: (value: boolean) => void;
+    toggleFlag: (questionId: string) => void;
+    setCurrentPartIndex: (index: number) => void;
+    setCurrentQuestionGlobalIndex: (index: number) => void;
+    markIntroPlayed: (partIndex: number) => void;
+    markListeningAudioPlayed: (partId: string) => void;
+    setExamType: (type: string) => void;
+    setParts: (parts: StoreTemplatePart[]) => void;
+    reset: () => void;
+}
+export declare const useExamTakingStore: import("zustand").UseBoundStore<Omit<import("zustand").StoreApi<ExamTakingState>, "setState" | "persist"> & {
+    setState(partial: ExamTakingState | Partial<ExamTakingState> | ((state: ExamTakingState) => ExamTakingState | Partial<ExamTakingState>), replace?: false): unknown;
+    setState(state: ExamTakingState | ((state: ExamTakingState) => ExamTakingState), replace: true): unknown;
+    persist: {
+        setOptions: (options: Partial<import("zustand/middleware").PersistOptions<ExamTakingState, unknown, unknown>>) => void;
+        clearStorage: () => void;
+        rehydrate: () => Promise<void> | void;
+        hasHydrated: () => boolean;
+        onHydrate: (fn: (state: ExamTakingState) => void) => () => void;
+        onFinishHydration: (fn: (state: ExamTakingState) => void) => () => void;
+        getOptions: () => Partial<import("zustand/middleware").PersistOptions<ExamTakingState, unknown, unknown>>;
+    };
+}>;
+export {};

package/dist/shared/lib/stores/examTakingStore.js

@@ -0,0 +1 @@
+import{create as e}from"zustand";import{persist as t,createJSONStorage as n}from"zustand/middleware";const a="__set__",r=n(()=>localStorage,{replacer:(e,t)=>t instanceof Set?{[a]:Array.from(t)}:t,reviver:(e,t)=>t&&"object"==typeof t&&Array.isArray(t[a])?new Set(t[a]):t});export const useExamTakingStore=e()(t((e,t)=>({attemptId:null,examRoomId:null,questions:[],answers:{},currentIndex:0,remainingSeconds:0,endsAt:null,isInitialized:!1,isDirty:!1,lastSavedAt:null,isSubmitting:!1,isNavDisabled:!1,flaggedQuestions:new Set,currentPartIndex:0,currentQuestionGlobalIndex:0,playedIntroParts:new Set,playedListeningAudioParts:new Set,examType:null,examTitle:null,parts:[],hydrateFromServer:n=>{const a=new Date(n.startedAt),r=60*n.durationMinutes*1e3,s=a.getTime()+r,i=Date.now(),d=Math.max(0,s-i),o=Math.floor(d/1e3),l=t(),u=l.attemptId===n.attemptId;e({attemptId:n.attemptId,examRoomId:n.examRoomId,questions:n.questions,remainingSeconds:o,endsAt:s,isInitialized:!0,isDirty:!1,lastSavedAt:null,isSubmitting:!1,isNavDisabled:!1,examType:n.examType??null,examTitle:n.examTitle??null,parts:n.parts??[],answers:u?l.answers:{},currentIndex:u?l.currentIndex:0,currentPartIndex:u?l.currentPartIndex:0,currentQuestionGlobalIndex:u?l.currentQuestionGlobalIndex:0,flaggedQuestions:u?l.flaggedQuestions:new Set,playedIntroParts:u?l.playedIntroParts:new Set,playedListeningAudioParts:u?l.playedListeningAudioParts:new Set})},setAnswer:(t,n)=>{e(e=>({answers:{...e.answers,[t]:n},isDirty:!0}))},nextQuestion:()=>{e(e=>{const t=e.currentIndex+1;return t<e.questions.length?{currentIndex:t}:e})},prevQuestion:()=>{e(e=>{const t=e.currentIndex-1;return t>=0?{currentIndex:t}:e})},goToQuestion:t=>{e(e=>t>=0&&t<e.questions.length?{currentIndex:t}:e)},syncRemainingSeconds:()=>{const{endsAt:n,remainingSeconds:a}=t();if(null==n)return a;const r=Math.max(0,Math.round((n-Date.now())/1e3));return e({remainingSeconds:r}),r},markSaved:()=>{e({isDirty:!1,lastSavedAt:new Date})},setIsSubmitting:t=>{e({isSubmitting:t})},setIsNavDisabled:t=>{e({isNavDisabled:t})},toggleFlag:t=>{e(e=>{const n=new Set(e.flaggedQuestions);return n.has(t)?n.delete(t):n.add(t),{flaggedQuestions:n}})},setCurrentPartIndex:t=>{e({currentPartIndex:t})},setCurrentQuestionGlobalIndex:t=>{e({currentQuestionGlobalIndex:t})},markIntroPlayed:t=>{e(e=>{if(e.playedIntroParts.has(t))return e;const n=new Set(e.playedIntroParts);return n.add(t),{playedIntroParts:n}})},markListeningAudioPlayed:t=>{e(e=>{if(e.playedListeningAudioParts.has(t))return e;const n=new Set(e.playedListeningAudioParts);return n.add(t),{playedListeningAudioParts:n}})},setExamType:t=>{e({examType:t})},setParts:t=>{e({parts:t})},reset:()=>{e({attemptId:null,examRoomId:null,questions:[],answers:{},currentIndex:0,remainingSeconds:0,endsAt:null,isInitialized:!1,isDirty:!1,lastSavedAt:null,isSubmitting:!1,isNavDisabled:!1,flaggedQuestions:new Set,currentPartIndex:0,currentQuestionGlobalIndex:0,playedIntroParts:new Set,playedListeningAudioParts:new Set,examType:null,examTitle:null,parts:[]}),useExamTakingStore.persist.clearStorage()}}),{name:"exam-taking-storage",storage:r,partialize:e=>({attemptId:e.attemptId,examRoomId:e.examRoomId,answers:e.answers,currentIndex:e.currentIndex,currentPartIndex:e.currentPartIndex,currentQuestionGlobalIndex:e.currentQuestionGlobalIndex,flaggedQuestions:e.flaggedQuestions,playedIntroParts:e.playedIntroParts,playedListeningAudioParts:e.playedListeningAudioParts,examType:e.examType,examTitle:e.examTitle})}));

package/dist/shared/lib/stores/gradingTransientStore.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Transient (in-memory only) store for handing off `pendingAnswerIds`
+ * from the submit page to the result page after fire-and-forget submit.
+ *
+ * Why a store instead of query params or localStorage?
+ * - Query params: pollute URL, large lists overflow
+ * - localStorage: leaks across tabs/sessions, hard to invalidate
+ * - Zustand transient: cheap, auto-clears on tab close, scoped to this attempt
+ *
+ * Falls back to GET /grading-summary if user navigates directly to result page
+ * (e.g. refresh, deep link, new tab) and the store is empty.
+ */
+interface GradingTransientState {
+    /** Map attemptId → pending answer IDs (just-submitted handoff) */
+    pendingByAttempt: Record<string, string[]>;
+    /** Last time setPending was called for an attempt (for TTL cleanup) */
+    setAtByAttempt: Record<string, number>;
+    setPending: (attemptId: string, answerIds: string[]) => void;
+    getPending: (attemptId: string) => string[] | undefined;
+    clear: (attemptId: string) => void;
+}
+export declare const useGradingTransientStore: import("zustand").UseBoundStore<import("zustand").StoreApi<GradingTransientState>>;
+export {};

package/dist/shared/lib/stores/gradingTransientStore.js

@@ -0,0 +1 @@
+import{create as t}from"zustand";export const useGradingTransientStore=t((t,e)=>({pendingByAttempt:{},setAtByAttempt:{},setPending:(e,n)=>{t(t=>({pendingByAttempt:{...t.pendingByAttempt,[e]:n},setAtByAttempt:{...t.setAtByAttempt,[e]:Date.now()}}))},getPending:t=>{const n=e().setAtByAttempt[t];if(n){if(!(Date.now()-n>3e5))return e().pendingByAttempt[t];e().clear(t)}},clear:e=>{t(t=>{const{[e]:n,...p}=t.pendingByAttempt,{[e]:A,...m}=t.setAtByAttempt;return{pendingByAttempt:p,setAtByAttempt:m}})}}));

package/dist/shared/lib/themes/config/starters.config.d.ts

@@ -0,0 +1,3 @@
+import type { ThemeConfig } from '../types';
+export declare const startersTheme: ThemeConfig;
+export declare const commonTheme: ThemeConfig;

package/dist/shared/lib/themes/config/starters.config.js

@@ -0,0 +1 @@
+import e from"../../../../components/themes/cambridge-yle/assets/images/background-ocean-edu-2.png";import r from"../../../../components/themes/cambridge-yle/assets/images/bg-title.png";import t from"../../../../components/themes/cambridge-yle/assets/images/border.png";import s from"../../../../components/themes/cambridge-yle/assets/images/close.png";import a from"../../../../components/themes/cambridge-yle/assets/images/rocket.png";import o from"../../../../components/themes/cambridge-yle/assets/images/icon-bottom-left.png";import c from"../../../../components/themes/cambridge-yle/assets/images/icon-bottom-right.png";import m from"../../../../components/themes/cambridge-yle/assets/images/button_feedback_vi.png";export const startersTheme={id:"starters",displayName:"STARTERS",colors:{primary:"#0473f9",secondary:"#0ea5e9",background:"#e0f2fe",text:"#002249",cardBg:"#0473f9",cardBorder:"#1d4ed8"},assets:{background:e.src,cardFrame:t.src,titleBar:r.src,logo:r.src,closeButton:s.src,startIcon:a.src,bottomLeft:o.src,bottomRight:c.src,feedbackButton:m.src},visuals:{backgroundFilter:"blur(2px) brightness(0.8) saturate(0.9)",backgroundOverlay:"linear-gradient(to bottom, rgba(23, 37, 84, 0.5), rgba(30, 58, 138, 0.4), rgba(23, 37, 84, 0.6))",cardBackground:"radial-gradient(60% 60% at 50% 40%, rgba(56, 189, 248, 0.90) 0%, rgba(4, 115, 249, 0.92) 100%)"}};export const commonTheme={id:"common",displayName:"NHIỆM VỤ ĐẦU",colors:{primary:"#0473f9",secondary:"#0ea5e9",background:"#e0f2fe",text:"#002249",cardBg:"#0473f9",cardBorder:"#1d4ed8"},assets:{background:e.src,cardFrame:t.src,titleBar:r.src,logo:r.src,closeButton:s.src,startIcon:a.src,bottomLeft:o.src,bottomRight:c.src,feedbackButton:m.src},visuals:{backgroundFilter:"blur(2px) brightness(0.8) saturate(0.9)",backgroundOverlay:"linear-gradient(to bottom, rgba(23, 37, 84, 0.5), rgba(30, 58, 138, 0.4), rgba(23, 37, 84, 0.6))",cardBackground:"radial-gradient(60% 60% at 50% 40%, rgba(56, 189, 248, 0.90) 0%, rgba(4, 115, 249, 0.92) 100%)"}};

package/dist/shared/lib/themes/index.d.ts

@@ -0,0 +1,18 @@
+import type { ThemeConfig } from './types';
+export declare function normalizeExamTheme(theme?: string | null): string;
+export declare function getThemeConfigByExamTheme(_theme?: string | null): ThemeConfig | null;
+export declare function resolveThemeConfig(options: {
+    examTheme?: string | null;
+    templateTheme?: string | null;
+    level?: string | null;
+}): ThemeConfig;
+/**
+ * Get theme based on exam level string
+ * Maps Cambridge YLE levels to themes
+ */
+export declare function getThemeForLevel(level?: string): ThemeConfig;
+/**
+ * Get default theme (starters)
+ */
+export declare function getTheme(): ThemeConfig;
+export type { ThemeConfig, ExamTheme, ThemeColors, ThemeAssets, ThemeVisuals } from './types';

package/dist/shared/lib/themes/index.js

@@ -0,0 +1 @@
+import{commonTheme as e,startersTheme as r}from"./config/starters.config";const t={common:e,starters:r,movers:r,flyers:r};export function normalizeExamTheme(e){return"string"==typeof e?e.trim().toUpperCase():""}export function getThemeConfigByExamTheme(e){return null}export function resolveThemeConfig(e){return getThemeConfigByExamTheme(e.examTheme)??getThemeConfigByExamTheme(e.templateTheme)??getThemeForLevel(e.level??void 0)}export function getThemeForLevel(r){if(!r)return e;const n=r.toLowerCase();return n.includes("pre-a1")||n.includes("a1")||n.includes("starter")?t.starters:n.includes("a2")||n.includes("mover")?t.movers:n.includes("b1")||n.includes("b2")||n.includes("flyer")?t.flyers:e}export function getTheme(){return r}

package/dist/shared/lib/themes/types.d.ts

@@ -0,0 +1,39 @@
+export type ExamTheme = 'common' | 'starters' | 'movers' | 'flyers';
+export interface ThemeColors {
+    primary: string;
+    secondary: string;
+    background: string;
+    text: string;
+    cardBg: string;
+    cardBorder: string;
+}
+export interface ThemeAssets {
+    background: string;
+    cardFrame: string;
+    titleBar: string;
+    logo: string;
+    closeButton: string;
+    startIcon: string;
+    bottomLeft: string;
+    bottomRight: string;
+    feedbackButton?: string;
+}
+export interface ThemeVisuals {
+    /** CSS filter applied to the fullscreen background image */
+    backgroundFilter?: string;
+    /** CSS background value rendered above the fullscreen background image */
+    backgroundOverlay?: string;
+    /** CSS background value used for the main waiting-room card surface */
+    cardBackground?: string;
+}
+export interface ThemeConfig {
+    id: ExamTheme;
+    displayName: string;
+    colors: ThemeColors;
+    assets: ThemeAssets;
+    visuals?: ThemeVisuals;
+    /** CSS filter applied to the close button and card frame border images */
+    assetFilter?: string;
+    /** CSS filter applied specifically to the title bar image (may differ from assetFilter) */
+    titleBarFilter?: string;
+}

package/dist/shared/lib/themes/types.js

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

package/dist/shared/lib/toast.d.ts

@@ -0,0 +1,19 @@
+export declare const toast: {
+    success: (message: string, description?: string) => string | number;
+    error: (message: string, description?: string) => string | number;
+    warning: (message: string, description?: string) => string | number;
+    info: (message: string, description?: string) => string | number;
+    loading: (message: string, description?: string) => string | number;
+    promise: <T>(promise: Promise<T>, { loading, success, error, }: {
+        loading: string;
+        success: string | ((data: T) => string);
+        error: string | ((error: any) => string);
+    }) => (string & {
+        unwrap: () => Promise<T>;
+    }) | (number & {
+        unwrap: () => Promise<T>;
+    }) | {
+        unwrap: () => Promise<T>;
+    };
+    dismiss: (id?: string | number) => string | number;
+};

package/dist/shared/lib/toast.js

@@ -0,0 +1 @@
+import{toast as s}from"sonner";export const toast={success:(i,r)=>s.success(i,{description:r,duration:3e3}),error:(i,r)=>s.error(i,{description:r,duration:4e3}),warning:(i,r)=>s.warning(i,{description:r,duration:3500}),info:(i,r)=>s.info(i,{description:r,duration:3e3}),loading:(i,r)=>s.loading(i,{description:r}),promise:(i,{loading:r,success:o,error:n})=>s.promise(i,{loading:r,success:o,error:n}),dismiss:i=>s.dismiss(i)};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tinyweb_dev/oe-exam-sdk",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Reusable OceanEdu question components.",
   "type": "module",
   "main": "./dist/index.js",
@@ -21,7 +21,7 @@
     "build:compile": "tsc -p tsconfig.build.json",
     "build:alias": "tsc-alias -p tsconfig.build.json",
     "build:ts": "npm run build:compile && npm run build:assets && npm run build:alias",
-    "build:assets": "for d in cambridge-yle english-certification summer-sky; do [ -d src/components/themes/$d/assets ] && cp -R src/components/themes/$d/assets dist/components/themes/$d/ || true; done && cp src/global.d.ts dist/global.d.ts",
+    "build:assets": "for d in cambridge-yle english-certification summer-sky spaceship; do [ -d src/components/themes/$d/assets ] && cp -R src/components/themes/$d/assets dist/components/themes/$d/ || true; done; [ -d src/components/shared/audio/assets ] && cp -R src/components/shared/audio/assets dist/components/shared/audio/ || true; [ -d src/components/results/report/assets ] && mkdir -p dist/components/results/report && cp -R src/components/results/report/assets dist/components/results/report/ || true; (cd src && find . -name '*.module.css' -exec cp --parents {} ../dist/ \\;); cp src/global.d.ts dist/global.d.ts",
     "minify:js": "find dist -name '*.js' -type f -exec sh -c 'for f do terser \"$f\" --compress directives=false --mangle --module --comments false --output \"$f\"; done' sh {} +",
     "build": "npm run clean && npm run build:ts && npm run minify:js",
     "pack:local": "npm pack",
@@ -57,6 +57,14 @@
       "types": "./dist/components/exams/take/index.d.ts",
       "import": "./dist/components/exams/take/index.js"
     },
+    "./components/exams/entry": {
+      "types": "./dist/components/exams/entry/index.d.ts",
+      "import": "./dist/components/exams/entry/index.js"
+    },
+    "./components/exams/rooms": {
+      "types": "./dist/components/exams/rooms/index.d.ts",
+      "import": "./dist/components/exams/rooms/index.js"
+    },
     "./components/questions": {
       "types": "./dist/components/questions/index.d.ts",
       "import": "./dist/components/questions/index.js"
@@ -101,6 +109,7 @@
     "@dnd-kit/core": "^6.3.1",
     "@dnd-kit/sortable": "^10.0.0",
     "@dnd-kit/utilities": "^3.2.2",
+    "@fortawesome/free-solid-svg-icons": "^7.3.1",
     "@fortawesome/react-fontawesome": "^3.3.1",
     "@hookform/resolvers": "^5.2.2",
     "@modelcontextprotocol/sdk": "^1.29.0",
@@ -131,6 +140,7 @@
     "@tiptap/pm": "^3.22.3",
     "@tiptap/react": "^3.22.3",
     "@tiptap/starter-kit": "^3.22.3",
+    "@types/qrcode": "^1.5.6",
     "@xyflow/react": "^12.8.6",
     "axios": "^1.12.2",
     "class-variance-authority": "^0.7.1",