@tinyweb_dev/oe-exam-sdk 0.1.27 → 0.1.29

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

@@ -1 +1,212 @@
-import{create as e}from"zustand";const a=()=>({data:{},isCompleted:!1});export const useExamQuestionStore=e((e,t)=>({examId:null,templateId:null,totalQuestions:0,currentQuestionIndex:0,questions:{},initialized:!1,sharedHintLetters:{},sharedPassageData:{},sharedSceneData:{},sharedAnswerGroupData:{},sharedListData:{},sharedCompareImagesData:{},sharedInfoExchangeData:{},initializeExam:({examId:t,templateId:s,totalQuestions:r})=>{const n={};for(let e=0;e<r;e++)n[e]=a();e({examId:t,templateId:s,totalQuestions:r,currentQuestionIndex:0,questions:n,initialized:!0})},setCurrentQuestionIndex:a=>{e({currentQuestionIndex:a})},upsertQuestionData:(a,t)=>{e(e=>{const s=e.questions[a]??{data:{},isCompleted:!1};return{questions:{...e.questions,[a]:{...s,data:{...s.data,...t}}}}})},clearQuestionData:a=>{e(e=>({questions:{...e.questions,[a]:{data:{},isCompleted:!1}}}))},markQuestionCompleted:(a,t)=>{e(e=>{const s=e.questions[a]??{data:{},isCompleted:!1};return{questions:{...e.questions,[a]:{...s,data:{...s.data,isCompleted:t},isCompleted:t}}}})},getQuestionData:e=>t().questions[e]?.data,getCompletedQuestionIndices:()=>Object.entries(t().questions).filter(([,e])=>e.isCompleted).map(([e])=>Number(e)).sort((e,a)=>e-a),setSharedHintLetters:(a,t,s)=>{const r=`${a}_${t}`;e(e=>({sharedHintLetters:{...e.sharedHintLetters,[r]:s}}))},getSharedHintLetters:(e,a)=>{const s=`${e}_${a}`;return t().sharedHintLetters[s]},setSharedPassageData:(a,t,s)=>{const r=`${a}_${t}`;e(e=>({sharedPassageData:{...e.sharedPassageData,[r]:s}}))},getSharedPassageData:(e,a)=>{const s=`${e}_${a}`;return t().sharedPassageData[s]},setSharedSceneData:(a,t,s)=>{const r=`${a}_${t}`;e(e=>({sharedSceneData:{...e.sharedSceneData,[r]:s}}))},getSharedSceneData:(e,a)=>{const s=`${e}_${a}`;return t().sharedSceneData[s]},setSharedAnswerGroupData:(a,t,s)=>{const r=`${a}_${t}`;e(e=>({sharedAnswerGroupData:{...e.sharedAnswerGroupData,[r]:s}}))},getSharedAnswerGroupData:(e,a)=>{const s=`${e}_${a}`;return t().sharedAnswerGroupData[s]},setSharedListData:(a,t,s)=>{const r=`${a}_${t}`;e(e=>({sharedListData:{...e.sharedListData,[r]:s}}))},getSharedListData:(e,a)=>{const s=`${e}_${a}`;return t().sharedListData[s]},setSharedCompareImagesData:(a,t,s)=>{const r=`${a}_${t}`;e(e=>({sharedCompareImagesData:{...e.sharedCompareImagesData,[r]:s}}))},getSharedCompareImagesData:(e,a)=>{const s=`${e}_${a}`;return t().sharedCompareImagesData[s]},setSharedInfoExchangeData:(a,t,s)=>{const r=`${a}_${t}`;e(e=>({sharedInfoExchangeData:{...e.sharedInfoExchangeData,[r]:s}}))},getSharedInfoExchangeData:(e,a)=>{const s=`${e}_${a}`;return t().sharedInfoExchangeData[s]},resetStore:()=>{e({examId:null,templateId:null,totalQuestions:0,currentQuestionIndex:0,questions:{},initialized:!1,sharedHintLetters:{},sharedPassageData:{},sharedSceneData:{},sharedAnswerGroupData:{},sharedListData:{},sharedCompareImagesData:{}})}}));
+import { create } from 'zustand';
+const createEmptyQuestionEntry = () => ({
+    data: {},
+    isCompleted: false,
+});
+export const useExamQuestionStore = create((set, get) => ({
+    examId: null,
+    templateId: null,
+    totalQuestions: 0,
+    currentQuestionIndex: 0,
+    questions: {},
+    initialized: false,
+    sharedHintLetters: {},
+    sharedPassageData: {},
+    sharedSceneData: {},
+    sharedAnswerGroupData: {},
+    sharedListData: {},
+    sharedCompareImagesData: {},
+    sharedInfoExchangeData: {},
+    initializeExam: ({ examId, templateId, totalQuestions }) => {
+        const questions = {};
+        // Initialize empty questions (no localStorage loading)
+        for (let index = 0; index < totalQuestions; index++) {
+            questions[index] = createEmptyQuestionEntry();
+        }
+        set({
+            examId,
+            templateId,
+            totalQuestions,
+            currentQuestionIndex: 0,
+            questions,
+            initialized: true,
+        });
+    },
+    setCurrentQuestionIndex: (questionIndex) => {
+        set({ currentQuestionIndex: questionIndex });
+    },
+    upsertQuestionData: (questionIndex, data) => {
+        set((state) => {
+            const existingEntry = state.questions[questionIndex] ?? createEmptyQuestionEntry();
+            return {
+                questions: {
+                    ...state.questions,
+                    [questionIndex]: {
+                        ...existingEntry,
+                        data: {
+                            ...existingEntry.data,
+                            ...data,
+                        },
+                    },
+                },
+            };
+        });
+    },
+    // Clear/reset question data to empty state (used when discarding unsaved changes for new questions)
+    clearQuestionData: (questionIndex) => {
+        set((state) => ({
+            questions: {
+                ...state.questions,
+                [questionIndex]: createEmptyQuestionEntry(),
+            },
+        }));
+    },
+    markQuestionCompleted: (questionIndex, isCompleted) => {
+        set((state) => {
+            const existingEntry = state.questions[questionIndex] ?? createEmptyQuestionEntry();
+            return {
+                questions: {
+                    ...state.questions,
+                    [questionIndex]: {
+                        ...existingEntry,
+                        data: {
+                            ...existingEntry.data,
+                            isCompleted,
+                        },
+                        isCompleted,
+                    },
+                },
+            };
+        });
+    },
+    getQuestionData: (questionIndex) => {
+        return get().questions[questionIndex]?.data;
+    },
+    getCompletedQuestionIndices: () => {
+        return Object.entries(get().questions)
+            .filter(([, entry]) => entry.isCompleted)
+            .map(([index]) => Number(index))
+            .sort((a, b) => a - b);
+    },
+    // Set shared hintLetters for a specific partId + groupNumber combination
+    setSharedHintLetters: (partId, groupNumber, hintLetters) => {
+        const key = `${partId}_${groupNumber}`;
+        set((state) => ({
+            sharedHintLetters: {
+                ...state.sharedHintLetters,
+                [key]: hintLetters,
+            },
+        }));
+    },
+    // Get shared hintLetters for a specific partId + groupNumber combination
+    getSharedHintLetters: (partId, groupNumber) => {
+        const key = `${partId}_${groupNumber}`;
+        return get().sharedHintLetters[key];
+    },
+    // Set shared passage data for a specific partId + groupNumber combination
+    setSharedPassageData: (partId, groupNumber, data) => {
+        const key = `${partId}_${groupNumber}`;
+        set((state) => ({
+            sharedPassageData: {
+                ...state.sharedPassageData,
+                [key]: data,
+            },
+        }));
+    },
+    // Get shared passage data for a specific partId + groupNumber combination
+    getSharedPassageData: (partId, groupNumber) => {
+        const key = `${partId}_${groupNumber}`;
+        return get().sharedPassageData[key];
+    },
+    // Set shared scene data for a specific partId + groupNumber combination
+    setSharedSceneData: (partId, groupNumber, data) => {
+        const key = `${partId}_${groupNumber}`;
+        set((state) => ({
+            sharedSceneData: {
+                ...state.sharedSceneData,
+                [key]: data,
+            },
+        }));
+    },
+    // Get shared scene data for a specific partId + groupNumber combination
+    getSharedSceneData: (partId, groupNumber) => {
+        const key = `${partId}_${groupNumber}`;
+        return get().sharedSceneData[key];
+    },
+    // Set shared answer group data for a specific partId + groupNumber combination
+    setSharedAnswerGroupData: (partId, groupNumber, data) => {
+        const key = `${partId}_${groupNumber}`;
+        set((state) => ({
+            sharedAnswerGroupData: {
+                ...state.sharedAnswerGroupData,
+                [key]: data,
+            },
+        }));
+    },
+    // Get shared answer group data for a specific partId + groupNumber combination
+    getSharedAnswerGroupData: (partId, groupNumber) => {
+        const key = `${partId}_${groupNumber}`;
+        return get().sharedAnswerGroupData[key];
+    },
+    // Set shared list data for a specific partId + groupNumber combination
+    setSharedListData: (partId, groupNumber, data) => {
+        const key = `${partId}_${groupNumber}`;
+        set((state) => ({
+            sharedListData: {
+                ...state.sharedListData,
+                [key]: data,
+            },
+        }));
+    },
+    // Get shared list data for a specific partId + groupNumber combination
+    getSharedListData: (partId, groupNumber) => {
+        const key = `${partId}_${groupNumber}`;
+        return get().sharedListData[key];
+    },
+    // Set shared compare images data for a specific partId + groupNumber combination
+    setSharedCompareImagesData: (partId, groupNumber, data) => {
+        const key = `${partId}_${groupNumber}`;
+        set((state) => ({
+            sharedCompareImagesData: {
+                ...state.sharedCompareImagesData,
+                [key]: data,
+            },
+        }));
+    },
+    // Get shared compare images data for a specific partId + groupNumber combination
+    getSharedCompareImagesData: (partId, groupNumber) => {
+        const key = `${partId}_${groupNumber}`;
+        return get().sharedCompareImagesData[key];
+    },
+    // Set shared info exchange data for a specific partId + groupNumber combination
+    setSharedInfoExchangeData: (partId, groupNumber, data) => {
+        const key = `${partId}_${groupNumber}`;
+        set((state) => ({
+            sharedInfoExchangeData: {
+                ...state.sharedInfoExchangeData,
+                [key]: data,
+            },
+        }));
+    },
+    // Get shared info exchange data for a specific partId + groupNumber combination
+    getSharedInfoExchangeData: (partId, groupNumber) => {
+        const key = `${partId}_${groupNumber}`;
+        return get().sharedInfoExchangeData[key];
+    },
+    resetStore: () => {
+        set({
+            examId: null,
+            templateId: null,
+            totalQuestions: 0,
+            currentQuestionIndex: 0,
+            questions: {},
+            initialized: false,
+            sharedHintLetters: {},
+            sharedPassageData: {},
+            sharedSceneData: {},
+            sharedAnswerGroupData: {},
+            sharedListData: {},
+            sharedCompareImagesData: {},
+        });
+    },
+}));

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

@@ -1 +1,240 @@
-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})}));
+import { create } from 'zustand';
+import { persist, createJSONStorage } from 'zustand/middleware';
+/**
+ * JSON storage with Set <-> Array support so persisted `flaggedQuestions` and
+ * `playedIntroParts` (both Sets) survive serialization. We tag Sets on the way
+ * out and rebuild them on the way in.
+ *
+ * `() => localStorage` is SSR-safe: on the server `localStorage` is undefined and
+ * throws, which `createJSONStorage` catches and treats as "no storage" (persist
+ * becomes a no-op until the client rehydrates).
+ */
+const SET_TAG = '__set__';
+const examTakingStorage = createJSONStorage(() => localStorage, {
+    replacer: (_key, value) => {
+        if (value instanceof Set) {
+            return { [SET_TAG]: Array.from(value) };
+        }
+        return value;
+    },
+    reviver: (_key, value) => {
+        if (value &&
+            typeof value === 'object' &&
+            Array.isArray(value[SET_TAG])) {
+            return new Set(value[SET_TAG]);
+        }
+        return value;
+    },
+});
+export const useExamTakingStore = create()(persist((set, get) => ({
+    attemptId: null,
+    examRoomId: null,
+    questions: [],
+    answers: {},
+    currentIndex: 0,
+    remainingSeconds: 0,
+    endsAt: null,
+    isInitialized: false,
+    isDirty: false,
+    lastSavedAt: null,
+    isSubmitting: false,
+    isNavDisabled: false,
+    // TOEIC-specific defaults
+    flaggedQuestions: new Set(),
+    currentPartIndex: 0,
+    currentQuestionGlobalIndex: 0,
+    playedIntroParts: new Set(),
+    playedListeningAudioParts: new Set(),
+    examType: null,
+    examTitle: null,
+    parts: [],
+    /**
+     * Merge server data with any locally-persisted progress.
+     *
+     * Server fields (questions, parts, time, exam metadata) are always
+     * authoritative and refreshed. Student-owned progress (answers, current
+     * position, flags, played intros) is preserved ONLY when the persisted
+     * state belongs to the same attempt — otherwise it is reset so answers
+     * from a previous attempt never leak into a new one.
+     */
+    hydrateFromServer: (data) => {
+        const startedAt = new Date(data.startedAt);
+        const durationMs = data.durationMinutes * 60 * 1000;
+        const endTime = startedAt.getTime() + durationMs;
+        const now = Date.now();
+        const remainingMs = Math.max(0, endTime - now);
+        const remainingSeconds = Math.floor(remainingMs / 1000);
+        const prev = get();
+        const sameAttempt = prev.attemptId === data.attemptId;
+        set({
+            attemptId: data.attemptId,
+            examRoomId: data.examRoomId,
+            questions: data.questions,
+            remainingSeconds,
+            endsAt: endTime,
+            isInitialized: true,
+            // Transient flags always reset on (re)load
+            isDirty: false,
+            lastSavedAt: null,
+            isSubmitting: false,
+            isNavDisabled: false,
+            // Server-authoritative exam metadata
+            examType: data.examType ?? null,
+            examTitle: data.examTitle ?? null,
+            parts: data.parts ?? [],
+            // Preserve student progress only for the same attempt; otherwise reset
+            answers: sameAttempt ? prev.answers : {},
+            currentIndex: sameAttempt ? prev.currentIndex : 0,
+            currentPartIndex: sameAttempt ? prev.currentPartIndex : 0,
+            currentQuestionGlobalIndex: sameAttempt ? prev.currentQuestionGlobalIndex : 0,
+            flaggedQuestions: sameAttempt ? prev.flaggedQuestions : new Set(),
+            playedIntroParts: sameAttempt ? prev.playedIntroParts : new Set(),
+            playedListeningAudioParts: sameAttempt
+                ? prev.playedListeningAudioParts
+                : new Set(),
+        });
+    },
+    setAnswer: (questionId, answer) => {
+        set((state) => ({
+            answers: {
+                ...state.answers,
+                [questionId]: answer,
+            },
+            isDirty: true,
+        }));
+    },
+    nextQuestion: () => {
+        set((state) => {
+            const nextIndex = state.currentIndex + 1;
+            if (nextIndex < state.questions.length) {
+                return { currentIndex: nextIndex };
+            }
+            return state;
+        });
+    },
+    prevQuestion: () => {
+        set((state) => {
+            const prevIndex = state.currentIndex - 1;
+            if (prevIndex >= 0) {
+                return { currentIndex: prevIndex };
+            }
+            return state;
+        });
+    },
+    goToQuestion: (index) => {
+        set((state) => {
+            if (index >= 0 && index < state.questions.length) {
+                return { currentIndex: index };
+            }
+            return state;
+        });
+    },
+    // Recompute remaining time from the absolute end time (wall-clock) instead
+    // of decrementing a counter. This keeps the countdown accurate even when
+    // the tab was backgrounded/throttled: no extra time is granted, and the
+    // value jumps to the correct remaining as soon as this runs again.
+    syncRemainingSeconds: () => {
+        const { endsAt, remainingSeconds } = get();
+        if (endsAt == null)
+            return remainingSeconds;
+        const remaining = Math.max(0, Math.round((endsAt - Date.now()) / 1000));
+        set({ remainingSeconds: remaining });
+        return remaining;
+    },
+    markSaved: () => {
+        set({
+            isDirty: false,
+            lastSavedAt: new Date(),
+        });
+    },
+    setIsSubmitting: (value) => {
+        set({ isSubmitting: value });
+    },
+    setIsNavDisabled: (value) => {
+        set({ isNavDisabled: value });
+    },
+    toggleFlag: (questionId) => {
+        set((state) => {
+            const next = new Set(state.flaggedQuestions);
+            if (next.has(questionId))
+                next.delete(questionId);
+            else
+                next.add(questionId);
+            return { flaggedQuestions: next };
+        });
+    },
+    setCurrentPartIndex: (index) => {
+        set({ currentPartIndex: index });
+    },
+    setCurrentQuestionGlobalIndex: (index) => {
+        set({ currentQuestionGlobalIndex: index });
+    },
+    markIntroPlayed: (partIndex) => {
+        set((state) => {
+            if (state.playedIntroParts.has(partIndex))
+                return state;
+            const next = new Set(state.playedIntroParts);
+            next.add(partIndex);
+            return { playedIntroParts: next };
+        });
+    },
+    markListeningAudioPlayed: (partId) => {
+        set((state) => {
+            if (state.playedListeningAudioParts.has(partId))
+                return state;
+            const next = new Set(state.playedListeningAudioParts);
+            next.add(partId);
+            return { playedListeningAudioParts: next };
+        });
+    },
+    setExamType: (type) => {
+        set({ examType: type });
+    },
+    setParts: (parts) => {
+        set({ parts });
+    },
+    reset: () => {
+        set({
+            attemptId: null,
+            examRoomId: null,
+            questions: [],
+            answers: {},
+            currentIndex: 0,
+            remainingSeconds: 0,
+            endsAt: null,
+            isInitialized: false,
+            isDirty: false,
+            lastSavedAt: null,
+            isSubmitting: false,
+            isNavDisabled: false,
+            flaggedQuestions: new Set(),
+            currentPartIndex: 0,
+            currentQuestionGlobalIndex: 0,
+            playedIntroParts: new Set(),
+            playedListeningAudioParts: new Set(),
+            examType: null,
+            examTitle: null,
+            parts: [],
+        });
+        // Drop persisted progress so a reload after reset/submit starts clean
+        useExamTakingStore.persist.clearStorage();
+    },
+}), {
+    name: 'exam-taking-storage',
+    storage: examTakingStorage,
+    // Persist only student-owned progress. Server data (questions, parts,
+    // time) is refetched on load; transient flags must not be restored.
+    partialize: (state) => ({
+        attemptId: state.attemptId,
+        examRoomId: state.examRoomId,
+        answers: state.answers,
+        currentIndex: state.currentIndex,
+        currentPartIndex: state.currentPartIndex,
+        currentQuestionGlobalIndex: state.currentQuestionGlobalIndex,
+        flaggedQuestions: state.flaggedQuestions,
+        playedIntroParts: state.playedIntroParts,
+        playedListeningAudioParts: state.playedListeningAudioParts,
+        examType: state.examType,
+        examTitle: state.examTitle,
+    }),
+}));

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

@@ -1 +1,39 @@
-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}})}}));
+import { create } from 'zustand';
+const TTL_MS = 5 * 60 * 1000; // 5 min — enough to navigate to the result page
+export const useGradingTransientStore = create((set, get) => ({
+    pendingByAttempt: {},
+    setAtByAttempt: {},
+    setPending: (attemptId, answerIds) => {
+        set((state) => ({
+            pendingByAttempt: {
+                ...state.pendingByAttempt,
+                [attemptId]: answerIds,
+            },
+            setAtByAttempt: {
+                ...state.setAtByAttempt,
+                [attemptId]: Date.now(),
+            },
+        }));
+    },
+    getPending: (attemptId) => {
+        const setAt = get().setAtByAttempt[attemptId];
+        if (!setAt)
+            return undefined;
+        // Auto-expire stale entries
+        if (Date.now() - setAt > TTL_MS) {
+            get().clear(attemptId);
+            return undefined;
+        }
+        return get().pendingByAttempt[attemptId];
+    },
+    clear: (attemptId) => {
+        set((state) => {
+            const { [attemptId]: _, ...restPending } = state.pendingByAttempt;
+            const { [attemptId]: __, ...restSetAt } = state.setAtByAttempt;
+            return {
+                pendingByAttempt: restPending,
+                setAtByAttempt: restSetAt,
+            };
+        });
+    },
+}));

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

@@ -1 +1,10 @@
-import{create as e}from"zustand";import{persist as o}from"zustand/middleware";export const useLocaleStore=e()(o(e=>({locale:"vi",setLocale:o=>{e({locale:o})}}),{name:"locale-storage"}));
+import { create } from 'zustand';
+import { persist } from 'zustand/middleware';
+export const useLocaleStore = create()(persist((set) => ({
+    locale: 'vi',
+    setLocale: (locale) => {
+        set({ locale });
+    },
+}), {
+    name: 'locale-storage',
+}));

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

@@ -1 +1,71 @@
-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%)"}};
+// Starters Theme Configuration (Cambridge YLE Pre-A1/A1)
+// Static imports from cambridge-yle assets — Next.js bundles these automatically
+import neutralBgImage from '../../../../components/themes/cambridge-yle/assets/images/background-ocean-edu-2.png';
+import bgTitleImage from '../../../../components/themes/cambridge-yle/assets/images/bg-title.png';
+import borderImage from '../../../../components/themes/cambridge-yle/assets/images/border.png';
+import closeImage from '../../../../components/themes/cambridge-yle/assets/images/close.png';
+import rocketImage from '../../../../components/themes/cambridge-yle/assets/images/rocket.png';
+import iconBottomLeftImage from '../../../../components/themes/cambridge-yle/assets/images/icon-bottom-left.png';
+import iconBottomRightImage from '../../../../components/themes/cambridge-yle/assets/images/icon-bottom-right.png';
+import feedbackButtonImage from '../../../../components/themes/cambridge-yle/assets/images/button_feedback_vi.png';
+// Ocean Edu brand colors:
+// - Sky cyan: #0ea5e9
+// - Brand blue: #0473f9
+// - Deep blue: #1d4ed8
+// - Navy: #002249
+export const startersTheme = {
+    id: 'starters',
+    displayName: 'STARTERS',
+    colors: {
+        primary: '#0473f9', // Ocean Edu brand blue
+        secondary: '#0ea5e9', // Sky cyan
+        background: '#e0f2fe', // Sky-100
+        text: '#002249', // Ocean Edu navy
+        cardBg: '#0473f9',
+        cardBorder: '#1d4ed8',
+    },
+    assets: {
+        background: neutralBgImage.src,
+        cardFrame: borderImage.src,
+        titleBar: bgTitleImage.src,
+        logo: bgTitleImage.src, // reuse title bar as logo placeholder
+        closeButton: closeImage.src,
+        startIcon: rocketImage.src,
+        bottomLeft: iconBottomLeftImage.src,
+        bottomRight: iconBottomRightImage.src,
+        feedbackButton: feedbackButtonImage.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: neutralBgImage.src,
+        cardFrame: borderImage.src,
+        titleBar: bgTitleImage.src,
+        logo: bgTitleImage.src, // reuse title bar as logo placeholder
+        closeButton: closeImage.src,
+        startIcon: rocketImage.src,
+        bottomLeft: iconBottomLeftImage.src,
+        bottomRight: iconBottomRightImage.src,
+        feedbackButton: feedbackButtonImage.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.js

@@ -1 +1,49 @@
-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}
+// Theme System Registry
+import { commonTheme, startersTheme } from './config/starters.config';
+const themeRegistry = {
+    common: commonTheme,
+    starters: startersTheme,
+    movers: startersTheme, // TODO: Create movers theme
+    flyers: startersTheme, // TODO: Create flyers theme
+};
+export function normalizeExamTheme(theme) {
+    return typeof theme === 'string' ? theme.trim().toUpperCase() : '';
+}
+export function getThemeConfigByExamTheme(_theme) {
+    return null;
+}
+export function resolveThemeConfig(options) {
+    return (getThemeConfigByExamTheme(options.examTheme) ??
+        getThemeConfigByExamTheme(options.templateTheme) ??
+        getThemeForLevel(options.level ?? undefined));
+}
+/**
+ * Get theme based on exam level string
+ * Maps Cambridge YLE levels to themes
+ */
+export function getThemeForLevel(level) {
+    if (!level)
+        return commonTheme;
+    const levelLower = level.toLowerCase();
+    if (levelLower.includes('pre-a1') ||
+        levelLower.includes('a1') ||
+        levelLower.includes('starter')) {
+        return themeRegistry.starters;
+    }
+    if (levelLower.includes('a2') || levelLower.includes('mover')) {
+        return themeRegistry.movers;
+    }
+    if (levelLower.includes('b1') ||
+        levelLower.includes('b2') ||
+        levelLower.includes('flyer')) {
+        return themeRegistry.flyers;
+    }
+    // Default to starters for children's platform
+    return commonTheme;
+}
+/**
+ * Get default theme (starters)
+ */
+export function getTheme() {
+    return startersTheme;
+}

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

@@ -1 +1,2 @@
-export{};
+// Theme System Types for Exam Waiting Room
+export {};