@thanh01.pmt/interactive-quiz-kit 1.0.47 → 1.0.49

package/dist/authoring.cjs

@@ -3998,20 +3998,30 @@ var PracticeHistoryService = class {
   static saveHistory(history2) {
     if (typeof window !== "undefined") {
       try {
-        localStorage.setItem(LOCAL_STORAGE_KEY, JSON.stringify(history2));
+        localStorage.setItem(
+          LOCAL_STORAGE_KEY,
+          JSON.stringify(history2)
+        );
       } catch (e2) {
-        console.error("Error saving practice history to localStorage:", e2);
+        console.error(
+          "Error saving practice history to localStorage:",
+          e2
+        );
       }
     }
   }
   static saveCompletedPracticeSession(quizConfig, result, review = null) {
     const history2 = this.getPracticeHistory();
     const topicsCovered = Array.from(
-      new Set(quizConfig.questions.map((q) => JSON.stringify({
-        subject: q.subject || "Uncategorized",
-        category: q.category || "General",
-        topic: q.topic || "General Topic"
-      })))
+      new Set(
+        quizConfig.questions.map(
+          (q) => JSON.stringify({
+            subject: q.subject || "Uncategorized",
+            category: q.category || "General",
+            topic: q.topic || "General Topic"
+          })
+        )
+      )
     ).map((s2) => JSON.parse(s2));
     const newSession = {
       id: `session_${Date.now()}_${Math.random().toString(36).substring(2, 7)}`,
@@ -4029,7 +4039,9 @@ var PracticeHistoryService = class {
     history2.unshift(newSession);
     this.saveHistory(history2);
     if (this.syncProvider) {
-      console.log(`Sync provider found. Pushing session ${newSession.id} to backend.`);
+      console.log(
+        `Sync provider found. Pushing session ${newSession.id} to backend.`
+      );
       this.syncProvider.pushSession(newSession).catch((err) => {
         console.error("Sync provider failed to push session:", err);
       });
@@ -4043,7 +4055,9 @@ var PracticeHistoryService = class {
       history2[sessionIndex].quizReview = review;
       this.saveHistory(history2);
     } else {
-      console.warn(`Could not find session with ID "${sessionId}" to update review.`);
+      console.warn(
+        `Could not find session with ID "${sessionId}" to update review.`
+      );
     }
   }
   static getPracticeSessionById(sessionId) {
@@ -4063,6 +4077,14 @@ var PracticeHistoryService = class {
   }
   static getPracticeStats() {
     const history2 = this.getPracticeHistory();
+    return this.calculateStatsFromHistory(history2);
+  }
+  static clearHistory() {
+    if (typeof window !== "undefined") {
+      localStorage.removeItem(LOCAL_STORAGE_KEY);
+    }
+  }
+  static calculateStatsFromHistory(history2) {
     if (history2.length === 0) {
       return {
         totalSessions: 0,
@@ -4101,7 +4123,9 @@ var PracticeHistoryService = class {
           const currentDay = new Date(sortedDays[i]);
           const nextDay = new Date(sortedDays[i + 1]);
           const diffTime = currentDay.getTime() - nextDay.getTime();
-          const diffDays = Math.round(diffTime / (1e3 * 60 * 60 * 24));
+          const diffDays = Math.round(
+            diffTime / (1e3 * 60 * 60 * 24)
+          );
           if (diffDays === 1) {
             currentStreak++;
           } else {
@@ -4133,22 +4157,31 @@ var PracticeHistoryService = class {
     const subjectPerf = {};
     const topicPerf = {};
     history2.forEach((session) => {
-      session.summary.topics.forEach((topicInfo) => {
-        if (session.summary.percentage !== null) {
-          if (!subjectPerf[topicInfo.subject]) subjectPerf[topicInfo.subject] = { total: 0, count: 0 };
-          subjectPerf[topicInfo.subject].total += session.summary.percentage;
-          subjectPerf[topicInfo.subject].count++;
-          if (!topicPerf[topicInfo.topic]) topicPerf[topicInfo.topic] = { total: 0, count: 0 };
-          topicPerf[topicInfo.topic].total += session.summary.percentage;
-          topicPerf[topicInfo.topic].count++;
+      session.summary.topics.forEach(
+        (topicInfo) => {
+          if (session.summary.percentage !== null) {
+            if (!subjectPerf[topicInfo.subject])
+              subjectPerf[topicInfo.subject] = {
+                total: 0,
+                count: 0
+              };
+            subjectPerf[topicInfo.subject].total += session.summary.percentage;
+            subjectPerf[topicInfo.subject].count++;
+            if (!topicPerf[topicInfo.topic])
+              topicPerf[topicInfo.topic] = { total: 0, count: 0 };
+            topicPerf[topicInfo.topic].total += session.summary.percentage;
+            topicPerf[topicInfo.topic].count++;
+          }
         }
-      });
+      );
     });
     const formatPerf = (perfData) => {
       return Object.entries(perfData).map(([name3, data]) => ({
         name: name3,
         totalSessions: data.count,
-        averageScore: parseFloat((data.total / data.count).toFixed(2))
+        averageScore: parseFloat(
+          (data.total / data.count).toFixed(2)
+        )
       })).sort((a2, b) => b.totalSessions - a2.totalSessions);
     };
     return {
@@ -4160,11 +4193,6 @@ var PracticeHistoryService = class {
       performanceByTopic: formatPerf(topicPerf)
     };
   }
-  static clearHistory() {
-    if (typeof window !== "undefined") {
-      localStorage.removeItem(LOCAL_STORAGE_KEY);
-    }
-  }
 };
 // NEW: A static property to hold the injected sync provider
 PracticeHistoryService.syncProvider = null;

package/dist/authoring.mjs

@@ -3972,20 +3972,30 @@ var PracticeHistoryService = class {
   static saveHistory(history2) {
     if (typeof window !== "undefined") {
       try {
-        localStorage.setItem(LOCAL_STORAGE_KEY, JSON.stringify(history2));
+        localStorage.setItem(
+          LOCAL_STORAGE_KEY,
+          JSON.stringify(history2)
+        );
       } catch (e2) {
-        console.error("Error saving practice history to localStorage:", e2);
+        console.error(
+          "Error saving practice history to localStorage:",
+          e2
+        );
       }
     }
   }
   static saveCompletedPracticeSession(quizConfig, result, review = null) {
     const history2 = this.getPracticeHistory();
     const topicsCovered = Array.from(
-      new Set(quizConfig.questions.map((q) => JSON.stringify({
-        subject: q.subject || "Uncategorized",
-        category: q.category || "General",
-        topic: q.topic || "General Topic"
-      })))
+      new Set(
+        quizConfig.questions.map(
+          (q) => JSON.stringify({
+            subject: q.subject || "Uncategorized",
+            category: q.category || "General",
+            topic: q.topic || "General Topic"
+          })
+        )
+      )
     ).map((s2) => JSON.parse(s2));
     const newSession = {
       id: `session_${Date.now()}_${Math.random().toString(36).substring(2, 7)}`,
@@ -4003,7 +4013,9 @@ var PracticeHistoryService = class {
     history2.unshift(newSession);
     this.saveHistory(history2);
     if (this.syncProvider) {
-      console.log(`Sync provider found. Pushing session ${newSession.id} to backend.`);
+      console.log(
+        `Sync provider found. Pushing session ${newSession.id} to backend.`
+      );
       this.syncProvider.pushSession(newSession).catch((err) => {
         console.error("Sync provider failed to push session:", err);
       });
@@ -4017,7 +4029,9 @@ var PracticeHistoryService = class {
       history2[sessionIndex].quizReview = review;
       this.saveHistory(history2);
     } else {
-      console.warn(`Could not find session with ID "${sessionId}" to update review.`);
+      console.warn(
+        `Could not find session with ID "${sessionId}" to update review.`
+      );
     }
   }
   static getPracticeSessionById(sessionId) {
@@ -4037,6 +4051,14 @@ var PracticeHistoryService = class {
   }
   static getPracticeStats() {
     const history2 = this.getPracticeHistory();
+    return this.calculateStatsFromHistory(history2);
+  }
+  static clearHistory() {
+    if (typeof window !== "undefined") {
+      localStorage.removeItem(LOCAL_STORAGE_KEY);
+    }
+  }
+  static calculateStatsFromHistory(history2) {
     if (history2.length === 0) {
       return {
         totalSessions: 0,
@@ -4075,7 +4097,9 @@ var PracticeHistoryService = class {
           const currentDay = new Date(sortedDays[i]);
           const nextDay = new Date(sortedDays[i + 1]);
           const diffTime = currentDay.getTime() - nextDay.getTime();
-          const diffDays = Math.round(diffTime / (1e3 * 60 * 60 * 24));
+          const diffDays = Math.round(
+            diffTime / (1e3 * 60 * 60 * 24)
+          );
           if (diffDays === 1) {
             currentStreak++;
           } else {
@@ -4107,22 +4131,31 @@ var PracticeHistoryService = class {
     const subjectPerf = {};
     const topicPerf = {};
     history2.forEach((session) => {
-      session.summary.topics.forEach((topicInfo) => {
-        if (session.summary.percentage !== null) {
-          if (!subjectPerf[topicInfo.subject]) subjectPerf[topicInfo.subject] = { total: 0, count: 0 };
-          subjectPerf[topicInfo.subject].total += session.summary.percentage;
-          subjectPerf[topicInfo.subject].count++;
-          if (!topicPerf[topicInfo.topic]) topicPerf[topicInfo.topic] = { total: 0, count: 0 };
-          topicPerf[topicInfo.topic].total += session.summary.percentage;
-          topicPerf[topicInfo.topic].count++;
+      session.summary.topics.forEach(
+        (topicInfo) => {
+          if (session.summary.percentage !== null) {
+            if (!subjectPerf[topicInfo.subject])
+              subjectPerf[topicInfo.subject] = {
+                total: 0,
+                count: 0
+              };
+            subjectPerf[topicInfo.subject].total += session.summary.percentage;
+            subjectPerf[topicInfo.subject].count++;
+            if (!topicPerf[topicInfo.topic])
+              topicPerf[topicInfo.topic] = { total: 0, count: 0 };
+            topicPerf[topicInfo.topic].total += session.summary.percentage;
+            topicPerf[topicInfo.topic].count++;
+          }
         }
-      });
+      );
     });
     const formatPerf = (perfData) => {
       return Object.entries(perfData).map(([name3, data]) => ({
         name: name3,
         totalSessions: data.count,
-        averageScore: parseFloat((data.total / data.count).toFixed(2))
+        averageScore: parseFloat(
+          (data.total / data.count).toFixed(2)
+        )
       })).sort((a2, b) => b.totalSessions - a2.totalSessions);
     };
     return {
@@ -4134,11 +4167,6 @@ var PracticeHistoryService = class {
       performanceByTopic: formatPerf(topicPerf)
     };
   }
-  static clearHistory() {
-    if (typeof window !== "undefined") {
-      localStorage.removeItem(LOCAL_STORAGE_KEY);
-    }
-  }
 };
 // NEW: A static property to hold the injected sync provider
 PracticeHistoryService.syncProvider = null;

package/dist/index.cjs

@@ -1964,20 +1964,30 @@ var PracticeHistoryService = class {
   static saveHistory(history) {
     if (typeof window !== "undefined") {
       try {
-        localStorage.setItem(LOCAL_STORAGE_KEY, JSON.stringify(history));
+        localStorage.setItem(
+          LOCAL_STORAGE_KEY,
+          JSON.stringify(history)
+        );
       } catch (e) {
-        console.error("Error saving practice history to localStorage:", e);
+        console.error(
+          "Error saving practice history to localStorage:",
+          e
+        );
       }
     }
   }
   static saveCompletedPracticeSession(quizConfig, result, review = null) {
     const history = this.getPracticeHistory();
     const topicsCovered = Array.from(
-      new Set(quizConfig.questions.map((q) => JSON.stringify({
-        subject: q.subject || "Uncategorized",
-        category: q.category || "General",
-        topic: q.topic || "General Topic"
-      })))
+      new Set(
+        quizConfig.questions.map(
+          (q) => JSON.stringify({
+            subject: q.subject || "Uncategorized",
+            category: q.category || "General",
+            topic: q.topic || "General Topic"
+          })
+        )
+      )
     ).map((s) => JSON.parse(s));
     const newSession = {
       id: `session_${Date.now()}_${Math.random().toString(36).substring(2, 7)}`,
@@ -1995,7 +2005,9 @@ var PracticeHistoryService = class {
     history.unshift(newSession);
     this.saveHistory(history);
     if (this.syncProvider) {
-      console.log(`Sync provider found. Pushing session ${newSession.id} to backend.`);
+      console.log(
+        `Sync provider found. Pushing session ${newSession.id} to backend.`
+      );
       this.syncProvider.pushSession(newSession).catch((err) => {
         console.error("Sync provider failed to push session:", err);
       });
@@ -2009,7 +2021,9 @@ var PracticeHistoryService = class {
       history[sessionIndex].quizReview = review;
       this.saveHistory(history);
     } else {
-      console.warn(`Could not find session with ID "${sessionId}" to update review.`);
+      console.warn(
+        `Could not find session with ID "${sessionId}" to update review.`
+      );
     }
   }
   static getPracticeSessionById(sessionId) {
@@ -2029,6 +2043,14 @@ var PracticeHistoryService = class {
   }
   static getPracticeStats() {
     const history = this.getPracticeHistory();
+    return this.calculateStatsFromHistory(history);
+  }
+  static clearHistory() {
+    if (typeof window !== "undefined") {
+      localStorage.removeItem(LOCAL_STORAGE_KEY);
+    }
+  }
+  static calculateStatsFromHistory(history) {
     if (history.length === 0) {
       return {
         totalSessions: 0,
@@ -2067,7 +2089,9 @@ var PracticeHistoryService = class {
           const currentDay = new Date(sortedDays[i]);
           const nextDay = new Date(sortedDays[i + 1]);
           const diffTime = currentDay.getTime() - nextDay.getTime();
-          const diffDays = Math.round(diffTime / (1e3 * 60 * 60 * 24));
+          const diffDays = Math.round(
+            diffTime / (1e3 * 60 * 60 * 24)
+          );
           if (diffDays === 1) {
             currentStreak++;
           } else {
@@ -2099,22 +2123,31 @@ var PracticeHistoryService = class {
     const subjectPerf = {};
     const topicPerf = {};
     history.forEach((session) => {
-      session.summary.topics.forEach((topicInfo) => {
-        if (session.summary.percentage !== null) {
-          if (!subjectPerf[topicInfo.subject]) subjectPerf[topicInfo.subject] = { total: 0, count: 0 };
-          subjectPerf[topicInfo.subject].total += session.summary.percentage;
-          subjectPerf[topicInfo.subject].count++;
-          if (!topicPerf[topicInfo.topic]) topicPerf[topicInfo.topic] = { total: 0, count: 0 };
-          topicPerf[topicInfo.topic].total += session.summary.percentage;
-          topicPerf[topicInfo.topic].count++;
+      session.summary.topics.forEach(
+        (topicInfo) => {
+          if (session.summary.percentage !== null) {
+            if (!subjectPerf[topicInfo.subject])
+              subjectPerf[topicInfo.subject] = {
+                total: 0,
+                count: 0
+              };
+            subjectPerf[topicInfo.subject].total += session.summary.percentage;
+            subjectPerf[topicInfo.subject].count++;
+            if (!topicPerf[topicInfo.topic])
+              topicPerf[topicInfo.topic] = { total: 0, count: 0 };
+            topicPerf[topicInfo.topic].total += session.summary.percentage;
+            topicPerf[topicInfo.topic].count++;
+          }
         }
-      });
+      );
     });
     const formatPerf = (perfData) => {
       return Object.entries(perfData).map(([name, data]) => ({
         name,
         totalSessions: data.count,
-        averageScore: parseFloat((data.total / data.count).toFixed(2))
+        averageScore: parseFloat(
+          (data.total / data.count).toFixed(2)
+        )
       })).sort((a, b) => b.totalSessions - a.totalSessions);
     };
     return {
@@ -2126,11 +2159,6 @@ var PracticeHistoryService = class {
       performanceByTopic: formatPerf(topicPerf)
     };
   }
-  static clearHistory() {
-    if (typeof window !== "undefined") {
-      localStorage.removeItem(LOCAL_STORAGE_KEY);
-    }
-  }
 };
 // NEW: A static property to hold the injected sync provider
 PracticeHistoryService.syncProvider = null;

package/dist/index.d.cts

@@ -246,6 +246,7 @@ declare class PracticeHistoryService {
     static getPracticeHistorySummary(): PracticeSessionSummary[];
     static getPracticeStats(): PracticeStats;
     static clearHistory(): void;
+    static calculateStatsFromHistory(history: PracticeSession[]): PracticeStats;
 }
 
 declare class AchievementService {

package/dist/index.d.ts

@@ -246,6 +246,7 @@ declare class PracticeHistoryService {
     static getPracticeHistorySummary(): PracticeSessionSummary[];
     static getPracticeStats(): PracticeStats;
     static clearHistory(): void;
+    static calculateStatsFromHistory(history: PracticeSession[]): PracticeStats;
 }
 
 declare class AchievementService {

package/dist/index.mjs

@@ -1958,20 +1958,30 @@ var PracticeHistoryService = class {
   static saveHistory(history) {
     if (typeof window !== "undefined") {
       try {
-        localStorage.setItem(LOCAL_STORAGE_KEY, JSON.stringify(history));
+        localStorage.setItem(
+          LOCAL_STORAGE_KEY,
+          JSON.stringify(history)
+        );
       } catch (e) {
-        console.error("Error saving practice history to localStorage:", e);
+        console.error(
+          "Error saving practice history to localStorage:",
+          e
+        );
       }
     }
   }
   static saveCompletedPracticeSession(quizConfig, result, review = null) {
     const history = this.getPracticeHistory();
     const topicsCovered = Array.from(
-      new Set(quizConfig.questions.map((q) => JSON.stringify({
-        subject: q.subject || "Uncategorized",
-        category: q.category || "General",
-        topic: q.topic || "General Topic"
-      })))
+      new Set(
+        quizConfig.questions.map(
+          (q) => JSON.stringify({
+            subject: q.subject || "Uncategorized",
+            category: q.category || "General",
+            topic: q.topic || "General Topic"
+          })
+        )
+      )
     ).map((s) => JSON.parse(s));
     const newSession = {
       id: `session_${Date.now()}_${Math.random().toString(36).substring(2, 7)}`,
@@ -1989,7 +1999,9 @@ var PracticeHistoryService = class {
     history.unshift(newSession);
     this.saveHistory(history);
     if (this.syncProvider) {
-      console.log(`Sync provider found. Pushing session ${newSession.id} to backend.`);
+      console.log(
+        `Sync provider found. Pushing session ${newSession.id} to backend.`
+      );
       this.syncProvider.pushSession(newSession).catch((err) => {
         console.error("Sync provider failed to push session:", err);
       });
@@ -2003,7 +2015,9 @@ var PracticeHistoryService = class {
       history[sessionIndex].quizReview = review;
       this.saveHistory(history);
     } else {
-      console.warn(`Could not find session with ID "${sessionId}" to update review.`);
+      console.warn(
+        `Could not find session with ID "${sessionId}" to update review.`
+      );
     }
   }
   static getPracticeSessionById(sessionId) {
@@ -2023,6 +2037,14 @@ var PracticeHistoryService = class {
   }
   static getPracticeStats() {
     const history = this.getPracticeHistory();
+    return this.calculateStatsFromHistory(history);
+  }
+  static clearHistory() {
+    if (typeof window !== "undefined") {
+      localStorage.removeItem(LOCAL_STORAGE_KEY);
+    }
+  }
+  static calculateStatsFromHistory(history) {
     if (history.length === 0) {
       return {
         totalSessions: 0,
@@ -2061,7 +2083,9 @@ var PracticeHistoryService = class {
           const currentDay = new Date(sortedDays[i]);
           const nextDay = new Date(sortedDays[i + 1]);
           const diffTime = currentDay.getTime() - nextDay.getTime();
-          const diffDays = Math.round(diffTime / (1e3 * 60 * 60 * 24));
+          const diffDays = Math.round(
+            diffTime / (1e3 * 60 * 60 * 24)
+          );
           if (diffDays === 1) {
             currentStreak++;
           } else {
@@ -2093,22 +2117,31 @@ var PracticeHistoryService = class {
     const subjectPerf = {};
     const topicPerf = {};
     history.forEach((session) => {
-      session.summary.topics.forEach((topicInfo) => {
-        if (session.summary.percentage !== null) {
-          if (!subjectPerf[topicInfo.subject]) subjectPerf[topicInfo.subject] = { total: 0, count: 0 };
-          subjectPerf[topicInfo.subject].total += session.summary.percentage;
-          subjectPerf[topicInfo.subject].count++;
-          if (!topicPerf[topicInfo.topic]) topicPerf[topicInfo.topic] = { total: 0, count: 0 };
-          topicPerf[topicInfo.topic].total += session.summary.percentage;
-          topicPerf[topicInfo.topic].count++;
+      session.summary.topics.forEach(
+        (topicInfo) => {
+          if (session.summary.percentage !== null) {
+            if (!subjectPerf[topicInfo.subject])
+              subjectPerf[topicInfo.subject] = {
+                total: 0,
+                count: 0
+              };
+            subjectPerf[topicInfo.subject].total += session.summary.percentage;
+            subjectPerf[topicInfo.subject].count++;
+            if (!topicPerf[topicInfo.topic])
+              topicPerf[topicInfo.topic] = { total: 0, count: 0 };
+            topicPerf[topicInfo.topic].total += session.summary.percentage;
+            topicPerf[topicInfo.topic].count++;
+          }
         }
-      });
+      );
     });
     const formatPerf = (perfData) => {
       return Object.entries(perfData).map(([name, data]) => ({
         name,
         totalSessions: data.count,
-        averageScore: parseFloat((data.total / data.count).toFixed(2))
+        averageScore: parseFloat(
+          (data.total / data.count).toFixed(2)
+        )
       })).sort((a, b) => b.totalSessions - a.totalSessions);
     };
     return {
@@ -2120,11 +2153,6 @@ var PracticeHistoryService = class {
       performanceByTopic: formatPerf(topicPerf)
     };
   }
-  static clearHistory() {
-    if (typeof window !== "undefined") {
-      localStorage.removeItem(LOCAL_STORAGE_KEY);
-    }
-  }
 };
 // NEW: A static property to hold the injected sync provider
 PracticeHistoryService.syncProvider = null;

package/dist/react-ui.cjs

@@ -139588,20 +139588,30 @@ var PracticeHistoryService = class {
   static saveHistory(history2) {
     if (typeof window !== "undefined") {
       try {
-        localStorage.setItem(LOCAL_STORAGE_KEY, JSON.stringify(history2));
+        localStorage.setItem(
+          LOCAL_STORAGE_KEY,
+          JSON.stringify(history2)
+        );
       } catch (e3) {
-        console.error("Error saving practice history to localStorage:", e3);
+        console.error(
+          "Error saving practice history to localStorage:",
+          e3
+        );
       }
     }
   }
   static saveCompletedPracticeSession(quizConfig, result, review = null) {
     const history2 = this.getPracticeHistory();
     const topicsCovered = Array.from(
-      new Set(quizConfig.questions.map((q2) => JSON.stringify({
-        subject: q2.subject || "Uncategorized",
-        category: q2.category || "General",
-        topic: q2.topic || "General Topic"
-      })))
+      new Set(
+        quizConfig.questions.map(
+          (q2) => JSON.stringify({
+            subject: q2.subject || "Uncategorized",
+            category: q2.category || "General",
+            topic: q2.topic || "General Topic"
+          })
+        )
+      )
     ).map((s4) => JSON.parse(s4));
     const newSession = {
       id: `session_${Date.now()}_${Math.random().toString(36).substring(2, 7)}`,
@@ -139619,7 +139629,9 @@ var PracticeHistoryService = class {
     history2.unshift(newSession);
     this.saveHistory(history2);
     if (this.syncProvider) {
-      console.log(`Sync provider found. Pushing session ${newSession.id} to backend.`);
+      console.log(
+        `Sync provider found. Pushing session ${newSession.id} to backend.`
+      );
       this.syncProvider.pushSession(newSession).catch((err) => {
         console.error("Sync provider failed to push session:", err);
       });
@@ -139633,7 +139645,9 @@ var PracticeHistoryService = class {
       history2[sessionIndex].quizReview = review;
       this.saveHistory(history2);
     } else {
-      console.warn(`Could not find session with ID "${sessionId}" to update review.`);
+      console.warn(
+        `Could not find session with ID "${sessionId}" to update review.`
+      );
     }
   }
   static getPracticeSessionById(sessionId) {
@@ -139653,6 +139667,14 @@ var PracticeHistoryService = class {
   }
   static getPracticeStats() {
     const history2 = this.getPracticeHistory();
+    return this.calculateStatsFromHistory(history2);
+  }
+  static clearHistory() {
+    if (typeof window !== "undefined") {
+      localStorage.removeItem(LOCAL_STORAGE_KEY);
+    }
+  }
+  static calculateStatsFromHistory(history2) {
     if (history2.length === 0) {
       return {
         totalSessions: 0,
@@ -139691,7 +139713,9 @@ var PracticeHistoryService = class {
           const currentDay = new Date(sortedDays[i2]);
           const nextDay = new Date(sortedDays[i2 + 1]);
           const diffTime = currentDay.getTime() - nextDay.getTime();
-          const diffDays = Math.round(diffTime / (1e3 * 60 * 60 * 24));
+          const diffDays = Math.round(
+            diffTime / (1e3 * 60 * 60 * 24)
+          );
           if (diffDays === 1) {
             currentStreak++;
           } else {
@@ -139723,22 +139747,31 @@ var PracticeHistoryService = class {
     const subjectPerf = {};
     const topicPerf = {};
     history2.forEach((session) => {
-      session.summary.topics.forEach((topicInfo) => {
-        if (session.summary.percentage !== null) {
-          if (!subjectPerf[topicInfo.subject]) subjectPerf[topicInfo.subject] = { total: 0, count: 0 };
-          subjectPerf[topicInfo.subject].total += session.summary.percentage;
-          subjectPerf[topicInfo.subject].count++;
-          if (!topicPerf[topicInfo.topic]) topicPerf[topicInfo.topic] = { total: 0, count: 0 };
-          topicPerf[topicInfo.topic].total += session.summary.percentage;
-          topicPerf[topicInfo.topic].count++;
+      session.summary.topics.forEach(
+        (topicInfo) => {
+          if (session.summary.percentage !== null) {
+            if (!subjectPerf[topicInfo.subject])
+              subjectPerf[topicInfo.subject] = {
+                total: 0,
+                count: 0
+              };
+            subjectPerf[topicInfo.subject].total += session.summary.percentage;
+            subjectPerf[topicInfo.subject].count++;
+            if (!topicPerf[topicInfo.topic])
+              topicPerf[topicInfo.topic] = { total: 0, count: 0 };
+            topicPerf[topicInfo.topic].total += session.summary.percentage;
+            topicPerf[topicInfo.topic].count++;
+          }
         }
-      });
+      );
     });
     const formatPerf = (perfData) => {
       return Object.entries(perfData).map(([name3, data]) => ({
         name: name3,
         totalSessions: data.count,
-        averageScore: parseFloat((data.total / data.count).toFixed(2))
+        averageScore: parseFloat(
+          (data.total / data.count).toFixed(2)
+        )
       })).sort((a4, b2) => b2.totalSessions - a4.totalSessions);
     };
     return {
@@ -139750,11 +139783,6 @@ var PracticeHistoryService = class {
       performanceByTopic: formatPerf(topicPerf)
     };
   }
-  static clearHistory() {
-    if (typeof window !== "undefined") {
-      localStorage.removeItem(LOCAL_STORAGE_KEY);
-    }
-  }
 };
 // NEW: A static property to hold the injected sync provider
 PracticeHistoryService.syncProvider = null;
@@ -167238,15 +167266,19 @@ var ClientTranslation = ({ tKey, options, fallback: fallback2 }) => {
 };
 
 // src/react-ui/components/app/PersonalPracticeDashboard.tsx
-var PersonalPracticeDashboard = ({ settingsPath }) => {
+var PersonalPracticeDashboard = ({ settingsPath, initialHistory, initialStats, isControlled = false }) => {
   const router = navigation.useRouter();
   const { toast: toast2 } = useToast();
   const { t: t4, i18n } = useTranslation();
   const [isMounted, setIsMounted] = React163.useState(false);
   React163.useEffect(() => setIsMounted(true), []);
   const [isLoading, setIsLoading] = React163.useState(true);
-  const [stats, setStats] = React163.useState(null);
-  const [history2, setHistory] = React163.useState([]);
+  const [stats, setStats] = React163.useState(
+    initialStats || null
+  );
+  const [history2, setHistory] = React163.useState(
+    initialHistory || []
+  );
   const [userName, setUserName] = React163.useState(null);
   const [allAchievements, setAllAchievements] = React163.useState([]);
   const [motivationalQuote, setMotivationalQuote] = React163.useState(null);
@@ -167260,6 +167292,10 @@ var PersonalPracticeDashboard = ({ settingsPath }) => {
   );
   const [isSettingsModalOpen, setIsSettingsModalOpen] = React163.useState(false);
   const loadDashboardData = React163.useCallback(() => {
+    if (isControlled) {
+      setIsLoading(false);
+      return;
+    }
     setIsLoading(true);
     setDashboardLayout(DashboardLayoutService.getLayout());
     const practiceHistory = PracticeHistoryService.getPracticeHistory();
@@ -167288,10 +167324,20 @@ var PersonalPracticeDashboard = ({ settingsPath }) => {
     if (KnowledgeCardService.getPendingConcepts().length > 0) {
       CardGenerationProcessor.processQueue();
     }
-  }, [toast2, t4]);
+  }, [isControlled, toast2, t4]);
   React163.useEffect(() => {
-    loadDashboardData();
-  }, [loadDashboardData]);
+    if (isControlled) {
+      setHistory(initialHistory || []);
+      setStats(initialStats || null);
+      const name3 = UserConfigService.getFullName();
+      setUserName(name3);
+      const achievementsWithStatus = AchievementService.getAllAchievementsWithStatus();
+      setAllAchievements(achievementsWithStatus);
+      setIsLoading(false);
+    } else {
+      loadDashboardData();
+    }
+  }, [isControlled, initialHistory, initialStats, loadDashboardData]);
   React163.useEffect(() => {
     setMotivationalQuote(QuoteService.getRandomQuote());
     const fetchAIQuote = async () => {

package/dist/react-ui.d.cts

@@ -1,8 +1,8 @@
 import { s as QuizConfig, g as QuizQuestion } from './quiz-config-o4j2dfsu.cjs';
 export { B as BaseQuestion, e as BlocklyProgrammingQuestion, C as CodingQuestion, D as DragAndDropQuestion, l as DraggableItem, m as DropZone, F as FillInTheBlanksQuestion, n as HotspotArea, H as HotspotQuestion, M as MarkdownString, k as MatchOptionItem, j as MatchPromptItem, d as MatchingQuestion, a as MultipleChoiceQuestion, b as MultipleResponseQuestion, N as NumericQuestion, h as QuestionOption, Q as QuestionTypeStrings, r as QuizSettings, R as RichContentString, q as SCORMSettings, f as ScratchProgrammingQuestion, i as SequenceItem, c as SequenceQuestion, S as ShortAnswerQuestion, p as SupportedCodingLanguage, o as TestCase, T as TrueFalseQuestion } from './quiz-config-o4j2dfsu.cjs';
 export { APIKeyService, AchievementService, Approach, ApproachTableRawDifficulty, BloomLevelName, BloomLevelType, Category, CodeNamedEntity, Context, GEMINI_API_KEY_SERVICE_NAME, GradeLevel, KnowledgeCardService, KnowledgeDimension, LearningObjective, LearningObjectiveMetadata, MetadataService, PracticeHistoryService, QuestionBankService, QuestionImportService, QuestionInBank, QuestionTypeType, QuizEditorService, QuizEngine, QuizEngineCallbacks, QuizEngineConstructorOptions, QuoteService, SCORMService, StandardDifficulty, Subject, Topic, UserConfigService, cn, emptyQuiz, exportQuizAsSCORMZip, generateLauncherHTML, generateSCORMManifest, generateUniqueId, sampleQuiz } from './index.cjs';
-import { Q as QuizResultType, U as UserAnswerType, m as PracticeSuggestion, l as PracticeSuggestionTopic, i as Achievement, o as PracticeStats, p as PracticeSessionSummary, h as QuizReviewContent } from './ai-ecosystem-DqFRlFU3.cjs';
-export { j as AchievementDefinition, r as ActivityCalendarData, u as AnalysisReport, A as AnswerDetail, x as ChatContext, C as ChatMessage, v as DashboardCardConfig, D as DashboardCardId, w as DashboardLayout, y as Goal, G as GoalType, t as ImageContextItem, I as ImportError, K as KnowledgeCard, L as LearningAnalysis, e as PerformanceByBloomLevel, b as PerformanceByCategory, d as PerformanceByDifficulty, P as PerformanceByLearningObjective, c as PerformanceByTopic, f as PerformanceMetric, s as PerformanceSummary, k as PracticeDifficulty, n as PracticeSession, q as PracticeTopicSummary, g as QuestionReview, R as RoadmapItem, T as TestCaseResult, a as UserAnswers, W as WeeklyRoadmap } from './ai-ecosystem-DqFRlFU3.cjs';
+import { Q as QuizResultType, U as UserAnswerType, n as PracticeSession, o as PracticeStats, m as PracticeSuggestion, l as PracticeSuggestionTopic, i as Achievement, p as PracticeSessionSummary, h as QuizReviewContent } from './ai-ecosystem-DqFRlFU3.cjs';
+export { j as AchievementDefinition, r as ActivityCalendarData, u as AnalysisReport, A as AnswerDetail, x as ChatContext, C as ChatMessage, v as DashboardCardConfig, D as DashboardCardId, w as DashboardLayout, y as Goal, G as GoalType, t as ImageContextItem, I as ImportError, K as KnowledgeCard, L as LearningAnalysis, e as PerformanceByBloomLevel, b as PerformanceByCategory, d as PerformanceByDifficulty, P as PerformanceByLearningObjective, c as PerformanceByTopic, f as PerformanceMetric, s as PerformanceSummary, k as PracticeDifficulty, q as PracticeTopicSummary, g as QuestionReview, R as RoadmapItem, T as TestCaseResult, a as UserAnswers, W as WeeklyRoadmap } from './ai-ecosystem-DqFRlFU3.cjs';
 import * as React$1 from 'react';
 import React__default, { ReactNode } from 'react';
 export { a as AIFullQuizGeneratorModal, A as AIQuestionGeneratorModal, b as APIKeyManagerModal, c as ApiKeySettings, j as ApproachManager, B as BloomLevelManager, C as CategoryManager, i as ContextManager, E as EditQuestionModal, G as GradeLevelManager, I as ImportQuestionsModal, L as LearningObjectiveManager, M as MetadataTabs, e as QuestionFilters, f as QuestionFormDialog, d as QuestionList, h as QuestionTypeManager, Q as QuizAuthoringTool, S as SCORMExportModal, g as SubjectManager, k as Toaster, T as TopicManager, t as toast, u as useToast } from './toaster-DfLqsPwa.cjs';
@@ -72,6 +72,9 @@ declare const QuestionRenderer: React__default.ForwardRefExoticComponent<Questio
 
 interface PersonalPracticeDashboardProps {
     settingsPath?: string;
+    initialHistory?: PracticeSession[];
+    initialStats?: PracticeStats | null;
+    isControlled?: boolean;
 }
 declare const PersonalPracticeDashboard: React__default.FC<PersonalPracticeDashboardProps>;
 
@@ -215,4 +218,4 @@ declare const TabsList: React$1.ForwardRefExoticComponent<Omit<TabsPrimitive.Tab
 declare const TabsTrigger: React$1.ForwardRefExoticComponent<Omit<TabsPrimitive.TabsTriggerProps & React$1.RefAttributes<HTMLButtonElement>, "ref"> & React$1.RefAttributes<HTMLButtonElement>>;
 declare const TabsContent: React$1.ForwardRefExoticComponent<Omit<TabsPrimitive.TabsContentProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 
-export { Accordion, AccordionContent, AccordionItem, AccordionTrigger, Achievement, Achievements, ActivityCalendar, Alert, AlertDescription, AlertTitle, Badge, Button, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Cheatsheet, Checkbox, Dialog, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle, FreestyleQuizzesCard, GeneratedQuizzesCard, Input, Label, LanguageProvider, ManageTopics, PerformanceCharts, PersonalPracticeDashboard, PracticeHistoryTable, PracticeModeController, PracticeSessionSummary, PracticeStats, PracticeSuggestion, PracticeSuggestionTopic, Progress, QuestionRenderer, QuizConfig, QuizDataManagement, QuizPlayer, QuizQuestion, QuizResult, QuizResultType, QuizReview, QuizReviewContent, RadioGroup, RadioGroupItem, ScrollArea, Select, SelectContent, SelectItem, SelectTrigger, SelectValue, SettingsModal, Skeleton, SuggestionDialog, Tabs, TabsContent, TabsList, TabsTrigger, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, UploadResourceModal, UserAnswerType };
+export { Accordion, AccordionContent, AccordionItem, AccordionTrigger, Achievement, Achievements, ActivityCalendar, Alert, AlertDescription, AlertTitle, Badge, Button, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Cheatsheet, Checkbox, Dialog, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle, FreestyleQuizzesCard, GeneratedQuizzesCard, Input, Label, LanguageProvider, ManageTopics, PerformanceCharts, PersonalPracticeDashboard, PracticeHistoryTable, PracticeModeController, PracticeSession, PracticeSessionSummary, PracticeStats, PracticeSuggestion, PracticeSuggestionTopic, Progress, QuestionRenderer, QuizConfig, QuizDataManagement, QuizPlayer, QuizQuestion, QuizResult, QuizResultType, QuizReview, QuizReviewContent, RadioGroup, RadioGroupItem, ScrollArea, Select, SelectContent, SelectItem, SelectTrigger, SelectValue, SettingsModal, Skeleton, SuggestionDialog, Tabs, TabsContent, TabsList, TabsTrigger, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, UploadResourceModal, UserAnswerType };

package/dist/react-ui.d.ts

@@ -1,8 +1,8 @@
 import { s as QuizConfig, g as QuizQuestion } from './quiz-config-o4j2dfsu.js';
 export { B as BaseQuestion, e as BlocklyProgrammingQuestion, C as CodingQuestion, D as DragAndDropQuestion, l as DraggableItem, m as DropZone, F as FillInTheBlanksQuestion, n as HotspotArea, H as HotspotQuestion, M as MarkdownString, k as MatchOptionItem, j as MatchPromptItem, d as MatchingQuestion, a as MultipleChoiceQuestion, b as MultipleResponseQuestion, N as NumericQuestion, h as QuestionOption, Q as QuestionTypeStrings, r as QuizSettings, R as RichContentString, q as SCORMSettings, f as ScratchProgrammingQuestion, i as SequenceItem, c as SequenceQuestion, S as ShortAnswerQuestion, p as SupportedCodingLanguage, o as TestCase, T as TrueFalseQuestion } from './quiz-config-o4j2dfsu.js';
 export { APIKeyService, AchievementService, Approach, ApproachTableRawDifficulty, BloomLevelName, BloomLevelType, Category, CodeNamedEntity, Context, GEMINI_API_KEY_SERVICE_NAME, GradeLevel, KnowledgeCardService, KnowledgeDimension, LearningObjective, LearningObjectiveMetadata, MetadataService, PracticeHistoryService, QuestionBankService, QuestionImportService, QuestionInBank, QuestionTypeType, QuizEditorService, QuizEngine, QuizEngineCallbacks, QuizEngineConstructorOptions, QuoteService, SCORMService, StandardDifficulty, Subject, Topic, UserConfigService, cn, emptyQuiz, exportQuizAsSCORMZip, generateLauncherHTML, generateSCORMManifest, generateUniqueId, sampleQuiz } from './index.js';
-import { Q as QuizResultType, U as UserAnswerType, m as PracticeSuggestion, l as PracticeSuggestionTopic, i as Achievement, o as PracticeStats, p as PracticeSessionSummary, h as QuizReviewContent } from './ai-ecosystem-DqVlSO3r.js';
-export { j as AchievementDefinition, r as ActivityCalendarData, u as AnalysisReport, A as AnswerDetail, x as ChatContext, C as ChatMessage, v as DashboardCardConfig, D as DashboardCardId, w as DashboardLayout, y as Goal, G as GoalType, t as ImageContextItem, I as ImportError, K as KnowledgeCard, L as LearningAnalysis, e as PerformanceByBloomLevel, b as PerformanceByCategory, d as PerformanceByDifficulty, P as PerformanceByLearningObjective, c as PerformanceByTopic, f as PerformanceMetric, s as PerformanceSummary, k as PracticeDifficulty, n as PracticeSession, q as PracticeTopicSummary, g as QuestionReview, R as RoadmapItem, T as TestCaseResult, a as UserAnswers, W as WeeklyRoadmap } from './ai-ecosystem-DqVlSO3r.js';
+import { Q as QuizResultType, U as UserAnswerType, n as PracticeSession, o as PracticeStats, m as PracticeSuggestion, l as PracticeSuggestionTopic, i as Achievement, p as PracticeSessionSummary, h as QuizReviewContent } from './ai-ecosystem-DqVlSO3r.js';
+export { j as AchievementDefinition, r as ActivityCalendarData, u as AnalysisReport, A as AnswerDetail, x as ChatContext, C as ChatMessage, v as DashboardCardConfig, D as DashboardCardId, w as DashboardLayout, y as Goal, G as GoalType, t as ImageContextItem, I as ImportError, K as KnowledgeCard, L as LearningAnalysis, e as PerformanceByBloomLevel, b as PerformanceByCategory, d as PerformanceByDifficulty, P as PerformanceByLearningObjective, c as PerformanceByTopic, f as PerformanceMetric, s as PerformanceSummary, k as PracticeDifficulty, q as PracticeTopicSummary, g as QuestionReview, R as RoadmapItem, T as TestCaseResult, a as UserAnswers, W as WeeklyRoadmap } from './ai-ecosystem-DqVlSO3r.js';
 import * as React$1 from 'react';
 import React__default, { ReactNode } from 'react';
 export { a as AIFullQuizGeneratorModal, A as AIQuestionGeneratorModal, b as APIKeyManagerModal, c as ApiKeySettings, j as ApproachManager, B as BloomLevelManager, C as CategoryManager, i as ContextManager, E as EditQuestionModal, G as GradeLevelManager, I as ImportQuestionsModal, L as LearningObjectiveManager, M as MetadataTabs, e as QuestionFilters, f as QuestionFormDialog, d as QuestionList, h as QuestionTypeManager, Q as QuizAuthoringTool, S as SCORMExportModal, g as SubjectManager, k as Toaster, T as TopicManager, t as toast, u as useToast } from './toaster-Z0Qz6kch.js';
@@ -72,6 +72,9 @@ declare const QuestionRenderer: React__default.ForwardRefExoticComponent<Questio
 
 interface PersonalPracticeDashboardProps {
     settingsPath?: string;
+    initialHistory?: PracticeSession[];
+    initialStats?: PracticeStats | null;
+    isControlled?: boolean;
 }
 declare const PersonalPracticeDashboard: React__default.FC<PersonalPracticeDashboardProps>;
 
@@ -215,4 +218,4 @@ declare const TabsList: React$1.ForwardRefExoticComponent<Omit<TabsPrimitive.Tab
 declare const TabsTrigger: React$1.ForwardRefExoticComponent<Omit<TabsPrimitive.TabsTriggerProps & React$1.RefAttributes<HTMLButtonElement>, "ref"> & React$1.RefAttributes<HTMLButtonElement>>;
 declare const TabsContent: React$1.ForwardRefExoticComponent<Omit<TabsPrimitive.TabsContentProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 
-export { Accordion, AccordionContent, AccordionItem, AccordionTrigger, Achievement, Achievements, ActivityCalendar, Alert, AlertDescription, AlertTitle, Badge, Button, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Cheatsheet, Checkbox, Dialog, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle, FreestyleQuizzesCard, GeneratedQuizzesCard, Input, Label, LanguageProvider, ManageTopics, PerformanceCharts, PersonalPracticeDashboard, PracticeHistoryTable, PracticeModeController, PracticeSessionSummary, PracticeStats, PracticeSuggestion, PracticeSuggestionTopic, Progress, QuestionRenderer, QuizConfig, QuizDataManagement, QuizPlayer, QuizQuestion, QuizResult, QuizResultType, QuizReview, QuizReviewContent, RadioGroup, RadioGroupItem, ScrollArea, Select, SelectContent, SelectItem, SelectTrigger, SelectValue, SettingsModal, Skeleton, SuggestionDialog, Tabs, TabsContent, TabsList, TabsTrigger, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, UploadResourceModal, UserAnswerType };
+export { Accordion, AccordionContent, AccordionItem, AccordionTrigger, Achievement, Achievements, ActivityCalendar, Alert, AlertDescription, AlertTitle, Badge, Button, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Cheatsheet, Checkbox, Dialog, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle, FreestyleQuizzesCard, GeneratedQuizzesCard, Input, Label, LanguageProvider, ManageTopics, PerformanceCharts, PersonalPracticeDashboard, PracticeHistoryTable, PracticeModeController, PracticeSession, PracticeSessionSummary, PracticeStats, PracticeSuggestion, PracticeSuggestionTopic, Progress, QuestionRenderer, QuizConfig, QuizDataManagement, QuizPlayer, QuizQuestion, QuizResult, QuizResultType, QuizReview, QuizReviewContent, RadioGroup, RadioGroupItem, ScrollArea, Select, SelectContent, SelectItem, SelectTrigger, SelectValue, SettingsModal, Skeleton, SuggestionDialog, Tabs, TabsContent, TabsList, TabsTrigger, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, UploadResourceModal, UserAnswerType };

package/dist/react-ui.mjs

@@ -139561,20 +139561,30 @@ var PracticeHistoryService = class {
   static saveHistory(history2) {
     if (typeof window !== "undefined") {
       try {
-        localStorage.setItem(LOCAL_STORAGE_KEY, JSON.stringify(history2));
+        localStorage.setItem(
+          LOCAL_STORAGE_KEY,
+          JSON.stringify(history2)
+        );
       } catch (e3) {
-        console.error("Error saving practice history to localStorage:", e3);
+        console.error(
+          "Error saving practice history to localStorage:",
+          e3
+        );
       }
     }
   }
   static saveCompletedPracticeSession(quizConfig, result, review = null) {
     const history2 = this.getPracticeHistory();
     const topicsCovered = Array.from(
-      new Set(quizConfig.questions.map((q2) => JSON.stringify({
-        subject: q2.subject || "Uncategorized",
-        category: q2.category || "General",
-        topic: q2.topic || "General Topic"
-      })))
+      new Set(
+        quizConfig.questions.map(
+          (q2) => JSON.stringify({
+            subject: q2.subject || "Uncategorized",
+            category: q2.category || "General",
+            topic: q2.topic || "General Topic"
+          })
+        )
+      )
     ).map((s4) => JSON.parse(s4));
     const newSession = {
       id: `session_${Date.now()}_${Math.random().toString(36).substring(2, 7)}`,
@@ -139592,7 +139602,9 @@ var PracticeHistoryService = class {
     history2.unshift(newSession);
     this.saveHistory(history2);
     if (this.syncProvider) {
-      console.log(`Sync provider found. Pushing session ${newSession.id} to backend.`);
+      console.log(
+        `Sync provider found. Pushing session ${newSession.id} to backend.`
+      );
       this.syncProvider.pushSession(newSession).catch((err) => {
         console.error("Sync provider failed to push session:", err);
       });
@@ -139606,7 +139618,9 @@ var PracticeHistoryService = class {
       history2[sessionIndex].quizReview = review;
       this.saveHistory(history2);
     } else {
-      console.warn(`Could not find session with ID "${sessionId}" to update review.`);
+      console.warn(
+        `Could not find session with ID "${sessionId}" to update review.`
+      );
     }
   }
   static getPracticeSessionById(sessionId) {
@@ -139626,6 +139640,14 @@ var PracticeHistoryService = class {
   }
   static getPracticeStats() {
     const history2 = this.getPracticeHistory();
+    return this.calculateStatsFromHistory(history2);
+  }
+  static clearHistory() {
+    if (typeof window !== "undefined") {
+      localStorage.removeItem(LOCAL_STORAGE_KEY);
+    }
+  }
+  static calculateStatsFromHistory(history2) {
     if (history2.length === 0) {
       return {
         totalSessions: 0,
@@ -139664,7 +139686,9 @@ var PracticeHistoryService = class {
           const currentDay = new Date(sortedDays[i2]);
           const nextDay = new Date(sortedDays[i2 + 1]);
           const diffTime = currentDay.getTime() - nextDay.getTime();
-          const diffDays = Math.round(diffTime / (1e3 * 60 * 60 * 24));
+          const diffDays = Math.round(
+            diffTime / (1e3 * 60 * 60 * 24)
+          );
           if (diffDays === 1) {
             currentStreak++;
           } else {
@@ -139696,22 +139720,31 @@ var PracticeHistoryService = class {
     const subjectPerf = {};
     const topicPerf = {};
     history2.forEach((session) => {
-      session.summary.topics.forEach((topicInfo) => {
-        if (session.summary.percentage !== null) {
-          if (!subjectPerf[topicInfo.subject]) subjectPerf[topicInfo.subject] = { total: 0, count: 0 };
-          subjectPerf[topicInfo.subject].total += session.summary.percentage;
-          subjectPerf[topicInfo.subject].count++;
-          if (!topicPerf[topicInfo.topic]) topicPerf[topicInfo.topic] = { total: 0, count: 0 };
-          topicPerf[topicInfo.topic].total += session.summary.percentage;
-          topicPerf[topicInfo.topic].count++;
+      session.summary.topics.forEach(
+        (topicInfo) => {
+          if (session.summary.percentage !== null) {
+            if (!subjectPerf[topicInfo.subject])
+              subjectPerf[topicInfo.subject] = {
+                total: 0,
+                count: 0
+              };
+            subjectPerf[topicInfo.subject].total += session.summary.percentage;
+            subjectPerf[topicInfo.subject].count++;
+            if (!topicPerf[topicInfo.topic])
+              topicPerf[topicInfo.topic] = { total: 0, count: 0 };
+            topicPerf[topicInfo.topic].total += session.summary.percentage;
+            topicPerf[topicInfo.topic].count++;
+          }
         }
-      });
+      );
     });
     const formatPerf = (perfData) => {
       return Object.entries(perfData).map(([name3, data]) => ({
         name: name3,
         totalSessions: data.count,
-        averageScore: parseFloat((data.total / data.count).toFixed(2))
+        averageScore: parseFloat(
+          (data.total / data.count).toFixed(2)
+        )
       })).sort((a4, b2) => b2.totalSessions - a4.totalSessions);
     };
     return {
@@ -139723,11 +139756,6 @@ var PracticeHistoryService = class {
       performanceByTopic: formatPerf(topicPerf)
     };
   }
-  static clearHistory() {
-    if (typeof window !== "undefined") {
-      localStorage.removeItem(LOCAL_STORAGE_KEY);
-    }
-  }
 };
 // NEW: A static property to hold the injected sync provider
 PracticeHistoryService.syncProvider = null;
@@ -167211,15 +167239,19 @@ var ClientTranslation = ({ tKey, options, fallback: fallback2 }) => {
 };
 
 // src/react-ui/components/app/PersonalPracticeDashboard.tsx
-var PersonalPracticeDashboard = ({ settingsPath }) => {
+var PersonalPracticeDashboard = ({ settingsPath, initialHistory, initialStats, isControlled = false }) => {
   const router = useRouter();
   const { toast: toast2 } = useToast();
   const { t: t4, i18n } = useTranslation();
   const [isMounted, setIsMounted] = useState(false);
   useEffect(() => setIsMounted(true), []);
   const [isLoading, setIsLoading] = useState(true);
-  const [stats, setStats] = useState(null);
-  const [history2, setHistory] = useState([]);
+  const [stats, setStats] = useState(
+    initialStats || null
+  );
+  const [history2, setHistory] = useState(
+    initialHistory || []
+  );
   const [userName, setUserName] = useState(null);
   const [allAchievements, setAllAchievements] = useState([]);
   const [motivationalQuote, setMotivationalQuote] = useState(null);
@@ -167233,6 +167265,10 @@ var PersonalPracticeDashboard = ({ settingsPath }) => {
   );
   const [isSettingsModalOpen, setIsSettingsModalOpen] = useState(false);
   const loadDashboardData = useCallback(() => {
+    if (isControlled) {
+      setIsLoading(false);
+      return;
+    }
     setIsLoading(true);
     setDashboardLayout(DashboardLayoutService.getLayout());
     const practiceHistory = PracticeHistoryService.getPracticeHistory();
@@ -167261,10 +167297,20 @@ var PersonalPracticeDashboard = ({ settingsPath }) => {
     if (KnowledgeCardService.getPendingConcepts().length > 0) {
       CardGenerationProcessor.processQueue();
     }
-  }, [toast2, t4]);
+  }, [isControlled, toast2, t4]);
   useEffect(() => {
-    loadDashboardData();
-  }, [loadDashboardData]);
+    if (isControlled) {
+      setHistory(initialHistory || []);
+      setStats(initialStats || null);
+      const name3 = UserConfigService.getFullName();
+      setUserName(name3);
+      const achievementsWithStatus = AchievementService.getAllAchievementsWithStatus();
+      setAllAchievements(achievementsWithStatus);
+      setIsLoading(false);
+    } else {
+      loadDashboardData();
+    }
+  }, [isControlled, initialHistory, initialStats, loadDashboardData]);
   useEffect(() => {
     setMotivationalQuote(QuoteService.getRandomQuote());
     const fetchAIQuote = async () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thanh01.pmt/interactive-quiz-kit",
-  "version": "1.0.47",
+  "version": "1.0.49",
   "description": "A comprehensive library for creating, managing, and playing interactive quizzes, with AI generation and SCORM support.",
   "keywords": [
     "react",