@thanh01.pmt/interactive-quiz-kit 1.0.46 → 1.0.48

package/dist/authoring.cjs

@@ -3980,6 +3980,11 @@ var UserConfigService = class {
 init_react_shim();
 var LOCAL_STORAGE_KEY = "iqk_practice_history_v2";
 var PracticeHistoryService = class {
+  // NEW: A configuration method to allow the host app (QMS) to inject its sync logic
+  static configure(provider) {
+    this.syncProvider = provider.syncProvider;
+    console.log("PracticeHistoryService configured with a sync provider.");
+  }
   static getPracticeHistory() {
     if (typeof window === "undefined") return [];
     try {
@@ -3993,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)}`,
@@ -4023,6 +4038,14 @@ var PracticeHistoryService = class {
     };
     history2.unshift(newSession);
     this.saveHistory(history2);
+    if (this.syncProvider) {
+      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);
+      });
+    }
     return newSession.id;
   }
   static updatePracticeReview(sessionId, review) {
@@ -4032,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) {
@@ -4090,7 +4115,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 {
@@ -4122,22 +4149,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 {
@@ -4155,6 +4191,8 @@ var PracticeHistoryService = class {
     }
   }
 };
+// NEW: A static property to hold the injected sync provider
+PracticeHistoryService.syncProvider = null;
 
 // src/services/AchievementService.ts
 init_react_shim();

package/dist/authoring.mjs

@@ -3954,6 +3954,11 @@ var UserConfigService = class {
 init_react_shim();
 var LOCAL_STORAGE_KEY = "iqk_practice_history_v2";
 var PracticeHistoryService = class {
+  // NEW: A configuration method to allow the host app (QMS) to inject its sync logic
+  static configure(provider) {
+    this.syncProvider = provider.syncProvider;
+    console.log("PracticeHistoryService configured with a sync provider.");
+  }
   static getPracticeHistory() {
     if (typeof window === "undefined") return [];
     try {
@@ -3967,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)}`,
@@ -3997,6 +4012,14 @@ var PracticeHistoryService = class {
     };
     history2.unshift(newSession);
     this.saveHistory(history2);
+    if (this.syncProvider) {
+      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);
+      });
+    }
     return newSession.id;
   }
   static updatePracticeReview(sessionId, review) {
@@ -4006,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) {
@@ -4064,7 +4089,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 {
@@ -4096,22 +4123,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 {
@@ -4129,6 +4165,8 @@ var PracticeHistoryService = class {
     }
   }
 };
+// NEW: A static property to hold the injected sync provider
+PracticeHistoryService.syncProvider = null;
 
 // src/services/AchievementService.ts
 init_react_shim();

package/dist/index.cjs

@@ -1946,6 +1946,11 @@ var UserConfigService = class {
 // src/services/PracticeHistoryService.ts
 var LOCAL_STORAGE_KEY = "iqk_practice_history_v2";
 var PracticeHistoryService = class {
+  // NEW: A configuration method to allow the host app (QMS) to inject its sync logic
+  static configure(provider) {
+    this.syncProvider = provider.syncProvider;
+    console.log("PracticeHistoryService configured with a sync provider.");
+  }
   static getPracticeHistory() {
     if (typeof window === "undefined") return [];
     try {
@@ -1959,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)}`,
@@ -1989,6 +2004,14 @@ var PracticeHistoryService = class {
     };
     history.unshift(newSession);
     this.saveHistory(history);
+    if (this.syncProvider) {
+      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);
+      });
+    }
     return newSession.id;
   }
   static updatePracticeReview(sessionId, review) {
@@ -1998,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) {
@@ -2056,7 +2081,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 {
@@ -2088,22 +2115,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 {
@@ -2121,6 +2157,8 @@ var PracticeHistoryService = class {
     }
   }
 };
+// NEW: A static property to hold the injected sync provider
+PracticeHistoryService.syncProvider = null;
 
 // src/data/achievements.json
 var achievements_default = [

package/dist/index.d.cts

@@ -230,7 +230,14 @@ declare class UserConfigService {
     static deleteGoal(goalId: string): void;
 }
 
+interface SyncProvider {
+    pushSession: (session: PracticeSession) => Promise<void>;
+}
 declare class PracticeHistoryService {
+    private static syncProvider;
+    static configure(provider: {
+        syncProvider: SyncProvider;
+    }): void;
     static getPracticeHistory(): PracticeSession[];
     private static saveHistory;
     static saveCompletedPracticeSession(quizConfig: QuizConfig, result: QuizResultType, review?: QuizReviewContent | null): string;

package/dist/index.d.ts

@@ -230,7 +230,14 @@ declare class UserConfigService {
     static deleteGoal(goalId: string): void;
 }
 
+interface SyncProvider {
+    pushSession: (session: PracticeSession) => Promise<void>;
+}
 declare class PracticeHistoryService {
+    private static syncProvider;
+    static configure(provider: {
+        syncProvider: SyncProvider;
+    }): void;
     static getPracticeHistory(): PracticeSession[];
     private static saveHistory;
     static saveCompletedPracticeSession(quizConfig: QuizConfig, result: QuizResultType, review?: QuizReviewContent | null): string;

package/dist/index.mjs

@@ -1940,6 +1940,11 @@ var UserConfigService = class {
 // src/services/PracticeHistoryService.ts
 var LOCAL_STORAGE_KEY = "iqk_practice_history_v2";
 var PracticeHistoryService = class {
+  // NEW: A configuration method to allow the host app (QMS) to inject its sync logic
+  static configure(provider) {
+    this.syncProvider = provider.syncProvider;
+    console.log("PracticeHistoryService configured with a sync provider.");
+  }
   static getPracticeHistory() {
     if (typeof window === "undefined") return [];
     try {
@@ -1953,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)}`,
@@ -1983,6 +1998,14 @@ var PracticeHistoryService = class {
     };
     history.unshift(newSession);
     this.saveHistory(history);
+    if (this.syncProvider) {
+      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);
+      });
+    }
     return newSession.id;
   }
   static updatePracticeReview(sessionId, review) {
@@ -1992,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) {
@@ -2050,7 +2075,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 {
@@ -2082,22 +2109,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 {
@@ -2115,6 +2151,8 @@ var PracticeHistoryService = class {
     }
   }
 };
+// NEW: A static property to hold the injected sync provider
+PracticeHistoryService.syncProvider = null;
 
 // src/data/achievements.json
 var achievements_default = [

package/dist/react-ui.cjs

@@ -139570,6 +139570,11 @@ AlertDialogCancel2.displayName = Cancel.displayName;
 init_react_shim();
 var LOCAL_STORAGE_KEY = "iqk_practice_history_v2";
 var PracticeHistoryService = class {
+  // NEW: A configuration method to allow the host app (QMS) to inject its sync logic
+  static configure(provider) {
+    this.syncProvider = provider.syncProvider;
+    console.log("PracticeHistoryService configured with a sync provider.");
+  }
   static getPracticeHistory() {
     if (typeof window === "undefined") return [];
     try {
@@ -139583,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)}`,
@@ -139613,6 +139628,14 @@ var PracticeHistoryService = class {
     };
     history2.unshift(newSession);
     this.saveHistory(history2);
+    if (this.syncProvider) {
+      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);
+      });
+    }
     return newSession.id;
   }
   static updatePracticeReview(sessionId, review) {
@@ -139622,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) {
@@ -139680,7 +139705,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 {
@@ -139712,22 +139739,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 {
@@ -139745,6 +139781,8 @@ var PracticeHistoryService = class {
     }
   }
 };
+// NEW: A static property to hold the injected sync provider
+PracticeHistoryService.syncProvider = null;
 
 // src/services/RoadmapService.ts
 init_react_shim();
@@ -167225,15 +167263,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);
@@ -167247,6 +167289,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();
@@ -167275,10 +167321,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

@@ -139543,6 +139543,11 @@ AlertDialogCancel2.displayName = Cancel.displayName;
 init_react_shim();
 var LOCAL_STORAGE_KEY = "iqk_practice_history_v2";
 var PracticeHistoryService = class {
+  // NEW: A configuration method to allow the host app (QMS) to inject its sync logic
+  static configure(provider) {
+    this.syncProvider = provider.syncProvider;
+    console.log("PracticeHistoryService configured with a sync provider.");
+  }
   static getPracticeHistory() {
     if (typeof window === "undefined") return [];
     try {
@@ -139556,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)}`,
@@ -139586,6 +139601,14 @@ var PracticeHistoryService = class {
     };
     history2.unshift(newSession);
     this.saveHistory(history2);
+    if (this.syncProvider) {
+      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);
+      });
+    }
     return newSession.id;
   }
   static updatePracticeReview(sessionId, review) {
@@ -139595,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) {
@@ -139653,7 +139678,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 {
@@ -139685,22 +139712,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 {
@@ -139718,6 +139754,8 @@ var PracticeHistoryService = class {
     }
   }
 };
+// NEW: A static property to hold the injected sync provider
+PracticeHistoryService.syncProvider = null;
 
 // src/services/RoadmapService.ts
 init_react_shim();
@@ -167198,15 +167236,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);
@@ -167220,6 +167262,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();
@@ -167248,10 +167294,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.46",
+  "version": "1.0.48",
   "description": "A comprehensive library for creating, managing, and playing interactive quizzes, with AI generation and SCORM support.",
   "keywords": [
     "react",