@lessonkit/react 1.2.0 → 1.3.0

package/dist/index.js

@@ -1,5 +1,5 @@
 // src/components.tsx
-import { useEffect as useEffect4, useId as useId2, useMemo as useMemo6, useRef as useRef4, useState as useState4 } from "react";
+import { useEffect as useEffect4, useId as useId2, useMemo as useMemo6, useRef as useRef5, useState as useState4 } from "react";
 import { visuallyHiddenStyle as visuallyHiddenStyle2 } from "@lessonkit/accessibility";
 
 // src/context.tsx
@@ -152,6 +152,9 @@ import {
   resetStoragePortForTests
 } from "@lessonkit/core";
 
+// src/provider/useLessonkitProviderRuntime.ts
+import { resetSharedVolatileSessionIdForTests } from "@lessonkit/core";
+
 // src/runtime/progress.ts
 import { createProgressController } from "@lessonkit/core";
 
@@ -295,9 +298,10 @@ async function emitCourseStartedToTracking(tracking, storage, sessionId, courseI
   try {
     if (shouldCommit && !shouldCommit()) return false;
     tracking.track(event);
-    await tracking.flush?.();
-    if (shouldCommit && !shouldCommit()) return false;
     markCourseStartedEmittedToTracking(storage, sessionId, courseId);
+    const delivered = await tracking.flush?.();
+    if (delivered === false) return false;
+    if (shouldCommit && !shouldCommit()) return false;
     return true;
   } catch {
     return false;
@@ -424,13 +428,14 @@ function assertTrackingSinkConfig(tracking) {
 
 // src/runtime/telemetry.ts
 import { createTrackingClient } from "@lessonkit/core";
-function createTrackingClientFromConfig(config) {
+function createTrackingClientFromConfig(config, observability) {
   if (config.tracking?.enabled === false) return createTrackingClient();
   if (config.tracking?.createClient) return config.tracking.createClient();
   return createTrackingClient({
     sink: config.tracking?.sink,
     batchSink: config.tracking?.batchSink,
-    batch: config.tracking?.batch
+    batch: config.tracking?.batch,
+    onBufferDrop: observability?.onTelemetryBufferDrop
   });
 }
 async function disposeTrackingClient(client) {
@@ -512,7 +517,8 @@ function useLessonkitProviderRuntime(config) {
         courseId: normalizedCourseId,
         runtimeVersion: "v2",
         session: normalizedConfig.session,
-        plugins: pluginHostRef.current ?? normalizedConfig.plugins
+        plugins: pluginHostRef.current ?? normalizedConfig.plugins,
+        deferPluginSetup: true
       });
       progressRef.current = headlessRef.current.progress;
     } else {
@@ -527,7 +533,8 @@ function useLessonkitProviderRuntime(config) {
       courseId: normalizedCourseId,
       runtimeVersion: "v2",
       session: normalizedConfig.session,
-      plugins: pluginHostRef.current ?? normalizedConfig.plugins
+      plugins: pluginHostRef.current ?? normalizedConfig.plugins,
+      deferPluginSetup: true
     });
   }
   if (prevCourseIdForProgressRef.current !== normalizedCourseId) {
@@ -672,9 +679,12 @@ function useLessonkitProviderRuntime(config) {
       }
       return userBatchSink(perEventForBatch);
     } : userBatchSink;
-    const next = createTrackingClientFromConfig({
-      tracking: { ...normalizedConfig.tracking, sink, batchSink }
-    });
+    const next = createTrackingClientFromConfig(
+      {
+        tracking: { ...normalizedConfig.tracking, sink, batchSink }
+      },
+      observabilityRef.current
+    );
     trackingRef.current = next;
     trackingClientForUnmountRef.current = next;
     setTracking(next);
@@ -992,6 +1002,7 @@ function useLessonkitProviderRuntime(config) {
       config: normalizedConfig,
       tracking,
       xapi,
+      storage: defaultStorage,
       session: { sessionId: sessionIdRef.current, attemptId: attemptIdRef.current, user: userRef.current },
       progress,
       setActiveLesson,
@@ -1127,7 +1138,7 @@ function getLessonMountCount(lessonId) {
 }
 
 // src/components/Quiz.tsx
-import { forwardRef, useEffect as useEffect3, useId, useMemo as useMemo5, useRef as useRef3, useState as useState3 } from "react";
+import { forwardRef, useEffect as useEffect3, useId, useMemo as useMemo5, useRef as useRef4, useState as useState3 } from "react";
 import { visuallyHiddenStyle } from "@lessonkit/accessibility";
 
 // src/assessment/AssessmentLessonGuard.tsx
@@ -1186,6 +1197,12 @@ function readStringField(state, key) {
   if (typeof value === "string" || value === null) return value;
   return void 0;
 }
+function readNumberField(state, key) {
+  const value = state[key];
+  if (typeof value === "number" && Number.isFinite(value)) return value;
+  if (value === null) return null;
+  return void 0;
+}
 function readBooleanStateField(state, key, apply) {
   const value = state[key];
   if (typeof value === "boolean") apply(value);
@@ -1195,53 +1212,81 @@ function readBooleanStateField(state, key, apply) {
 import { useImperativeHandle as useImperativeHandle2 } from "react";
 
 // src/compound/CompoundProvider.tsx
-import React3, { createContext as createContext3, useCallback as useCallback2, useContext as useContext3, useImperativeHandle, useMemo as useMemo4, useRef as useRef2, useState as useState2 } from "react";
+import React5, { createContext as createContext5, useCallback as useCallback2, useContext as useContext5, useImperativeHandle, useMemo as useMemo4, useRef as useRef3, useState as useState2 } from "react";
 import { clampCompoundPageIndex, createCompoundResumeState } from "@lessonkit/core";
 
 // src/compound/aggregateScores.ts
-function aggregateAssessmentScores(handles) {
+function aggregateAssessmentScores(handles, opts) {
   let score = 0;
   let maxScore = 0;
   let allAnswered = true;
-  for (const handle of handles) {
+  for (const entry of handles) {
+    const handle = "handle" in entry ? entry.handle : entry;
+    const pageIndex = "handle" in entry ? entry.pageIndex : void 0;
     score += handle.getScore();
     maxScore += handle.getMaxScore();
-    if (!handle.getAnswerGiven()) allAnswered = false;
+    const countsForAnswerGiven = opts?.answerPageIndex === void 0 || pageIndex === void 0 || pageIndex === opts.answerPageIndex;
+    if (countsForAnswerGiven && !handle.getAnswerGiven()) allAnswered = false;
   }
   return { score, maxScore, allAnswered };
 }
 
-// src/compound/resumeChildHandles.ts
-function resumeChildHandles(handles, childStates, opts) {
-  if (opts?.waitForHandles && handles.size === 0 && Object.keys(childStates).length > 0) {
-    return false;
-  }
-  for (const [checkId, handle] of handles) {
-    const child = childStates[checkId];
-    if (child && handle.resume) handle.resume(child);
-  }
-  return true;
+// src/compound/CompoundHydrationBridge.tsx
+import { createContext as createContext3, useContext as useContext3, useRef as useRef2 } from "react";
+import { jsx as jsx3 } from "react/jsx-runtime";
+var CompoundHydrationBridgeContext = createContext3(
+  null
+);
+function CompoundHydrationBridgeProvider({ children }) {
+  const bridgeRef = useRef2(null);
+  return /* @__PURE__ */ jsx3(CompoundHydrationBridgeContext.Provider, { value: bridgeRef, children });
+}
+function useCompoundHydrationBridgeRef() {
+  return useContext3(CompoundHydrationBridgeContext);
+}
+
+// src/compound/CompoundPageIndexContext.tsx
+import { createContext as createContext4, useContext as useContext4 } from "react";
+import { jsx as jsx4 } from "react/jsx-runtime";
+var CompoundPageIndexContext = createContext4(void 0);
+function CompoundPageIndexProvider({
+  pageIndex,
+  children
+}) {
+  return /* @__PURE__ */ jsx4(CompoundPageIndexContext.Provider, { value: pageIndex, children });
+}
+function useCompoundPageIndex() {
+  return useContext4(CompoundPageIndexContext);
 }
 
 // src/compound/CompoundProvider.tsx
-import { jsx as jsx3 } from "react/jsx-runtime";
-var CompoundRegistryContext = createContext3(null);
-var CompoundHandlesVersionContext = createContext3(0);
+import { jsx as jsx5 } from "react/jsx-runtime";
+var CompoundRegistryContext = createContext5(null);
+var CompoundHandlesVersionContext = createContext5(0);
 function CompoundProvider({
   children,
   activePageIndex: _activePageIndex,
   onActivePageIndexChange: _onActivePageIndexChange
 }) {
-  const registryRef = useRef2(/* @__PURE__ */ new Map());
+  const registryRef = useRef3(/* @__PURE__ */ new Map());
   const [handlesVersion, setHandlesVersion] = useState2(0);
-  const register = useCallback2((checkId, handle) => {
+  const register = useCallback2((checkId, handle, pageIndex) => {
     const prev = registryRef.current.get(checkId);
-    registryRef.current.set(checkId, handle);
-    if (prev !== handle) {
+    if (prev && prev.handle !== handle) {
+      const message = `[lessonkit] duplicate checkId "${checkId}" registered in the same compound container; the previous handle was replaced.`;
+      if (isDevEnvironment4()) {
+        console.error(message);
+      } else {
+        console.warn(message);
+      }
+    }
+    registryRef.current.set(checkId, { handle, pageIndex });
+    if (prev?.handle !== handle || prev?.pageIndex !== pageIndex) {
       setHandlesVersion((v) => v + 1);
     }
     return () => {
-      if (registryRef.current.get(checkId) === handle) {
+      const current = registryRef.current.get(checkId);
+      if (current?.handle === handle) {
         registryRef.current.delete(checkId);
         setHandlesVersion((v) => v + 1);
       }
@@ -1250,30 +1295,39 @@ function CompoundProvider({
   const registryValue = useMemo4(
     () => ({
       register,
-      getHandles: () => registryRef.current
+      getHandles: () => {
+        const handles = /* @__PURE__ */ new Map();
+        for (const [checkId, entry] of registryRef.current) {
+          handles.set(checkId, entry.handle);
+        }
+        return handles;
+      },
+      getRegisteredHandles: () => registryRef.current
     }),
     [register]
   );
-  return /* @__PURE__ */ jsx3(CompoundRegistryContext.Provider, { value: registryValue, children: /* @__PURE__ */ jsx3(CompoundHandlesVersionContext.Provider, { value: handlesVersion, children }) });
+  return /* @__PURE__ */ jsx5(CompoundHydrationBridgeProvider, { children: /* @__PURE__ */ jsx5(CompoundRegistryContext.Provider, { value: registryValue, children: /* @__PURE__ */ jsx5(CompoundHandlesVersionContext.Provider, { value: handlesVersion, children }) }) });
 }
 function useCompoundRegistry() {
-  const registry = useContext3(CompoundRegistryContext);
-  const handlesVersion = useContext3(CompoundHandlesVersionContext);
+  const registry = useContext5(CompoundRegistryContext);
+  const handlesVersion = useContext5(CompoundHandlesVersionContext);
   if (!registry) return null;
   return { ...registry, handlesVersion };
 }
 function useCompoundHandlesVersion() {
-  return useContext3(CompoundHandlesVersionContext);
+  return useContext5(CompoundHandlesVersionContext);
 }
 function useRegisterAssessmentHandle(checkId, handle) {
-  const registry = useContext3(CompoundRegistryContext);
-  React3.useEffect(() => {
+  const registry = useContext5(CompoundRegistryContext);
+  const pageIndex = useCompoundPageIndex();
+  React5.useLayoutEffect(() => {
     if (!registry || !handle) return;
-    return registry.register(checkId, handle);
-  }, [registry, checkId, handle]);
+    return registry.register(checkId, handle, pageIndex);
+  }, [registry, checkId, handle, pageIndex]);
 }
 function useCompoundHandleRef(ref, opts) {
-  const { activePageIndex, setActivePageIndex, getHandles, pageCount } = opts;
+  const { activePageIndex, setActivePageIndex, getHandles, getRegisteredHandles, pageCount } = opts;
+  const bridgeRef = useCompoundHydrationBridgeRef();
   const setIndexClamped = useCallback2(
     (index) => {
       const next = pageCount !== void 0 ? clampCompoundPageIndex(index, pageCount) : Math.max(0, Math.floor(index));
@@ -1284,31 +1338,32 @@ function useCompoundHandleRef(ref, opts) {
   useImperativeHandle(
     ref,
     () => ({
-      getScore: () => aggregateAssessmentScores(getHandles().values()).score,
-      getMaxScore: () => aggregateAssessmentScores(getHandles().values()).maxScore,
-      getAnswerGiven: () => aggregateAssessmentScores(getHandles().values()).allAnswered,
+      getScore: () => aggregateAssessmentScores(getRegisteredHandles().values()).score,
+      getMaxScore: () => aggregateAssessmentScores(getRegisteredHandles().values()).maxScore,
+      getAnswerGiven: () => aggregateAssessmentScores(getRegisteredHandles().values(), {
+        answerPageIndex: activePageIndex
+      }).allAnswered,
       resetTask: () => {
-        for (const handle of getHandles().values()) handle.resetTask();
+        for (const entry of getRegisteredHandles().values()) entry.handle.resetTask();
       },
       showSolutions: () => {
         if (!opts.enableSolutionsButton) return;
-        for (const handle of getHandles().values()) handle.showSolutions();
+        for (const entry of getRegisteredHandles().values()) entry.handle.showSolutions();
       },
       getCurrentState: () => {
         const childStates = {};
-        for (const [checkId, handle] of getHandles()) {
-          if (handle.getCurrentState) {
-            childStates[checkId] = handle.getCurrentState();
+        for (const [checkId, entry] of getRegisteredHandles()) {
+          if (entry.handle.getCurrentState) {
+            childStates[checkId] = entry.handle.getCurrentState();
           }
         }
         return createCompoundResumeState({ activePageIndex, childStates });
       },
       resume: (state) => {
-        setIndexClamped(state.activePageIndex);
-        resumeChildHandles(getHandles(), state.childStates);
+        bridgeRef?.current?.notifyImperativeResume(state);
       }
     }),
-    [activePageIndex, setIndexClamped, getHandles, opts.enableSolutionsButton]
+    [activePageIndex, setIndexClamped, getHandles, getRegisteredHandles, opts.enableSolutionsButton, bridgeRef]
   );
 }
 
@@ -1378,7 +1433,7 @@ function usePluginScoring(checkId, lessonId) {
 }
 
 // src/components/Quiz.tsx
-import { jsx as jsx4, jsxs as jsxs2 } from "react/jsx-runtime";
+import { jsx as jsx6, jsxs as jsxs2 } from "react/jsx-runtime";
 function QuizInner(props, ref) {
   const { enclosingLessonId } = props;
   const checkId = useMemo5(() => normalizeComponentId(props.checkId, "checkId"), [props.checkId]);
@@ -1387,44 +1442,85 @@ function QuizInner(props, ref) {
   const [selected, setSelected] = useState3(null);
   const [selectionCorrect, setSelectionCorrect] = useState3(null);
   const [quizPassed, setQuizPassed] = useState3(false);
-  const completedRef = useRef3(false);
+  const [completedScore, setCompletedScore] = useState3(null);
+  const [completedMaxScore, setCompletedMaxScore] = useState3(null);
+  const completedRef = useRef4(false);
+  const telemetryReplayedRef = useRef4(false);
   const questionId = useId();
   const choicesKey = props.choices.join("\0");
   useEffect3(() => {
     completedRef.current = false;
+    telemetryReplayedRef.current = false;
     setQuizPassed(false);
     setSelected(null);
     setSelectionCorrect(null);
+    setCompletedScore(null);
+    setCompletedMaxScore(null);
   }, [checkId, props.answer, props.question, choicesKey]);
   const passed = quizPassed;
+  const resolveScores = () => {
+    const maxScore = completedMaxScore ?? 1;
+    if (quizPassed) {
+      return { score: completedScore ?? maxScore, maxScore };
+    }
+    if (selected !== null && selectionCorrect) {
+      return { score: completedMaxScore ?? maxScore, maxScore };
+    }
+    return { score: 0, maxScore };
+  };
+  const replayTelemetry = (nextSelected, nextCorrect, nextPassed, nextScore, nextMaxScore) => {
+    if (!nextPassed || telemetryReplayedRef.current) return;
+    telemetryReplayedRef.current = true;
+    if (nextSelected !== null) {
+      quiz.answer({
+        checkId,
+        question: props.question,
+        choice: nextSelected,
+        correct: nextCorrect ?? false
+      });
+    }
+    quiz.complete({
+      checkId,
+      score: nextScore,
+      maxScore: nextMaxScore,
+      passingScore: props.passingScore ?? nextMaxScore
+    });
+  };
   const handle = useMemo5(
     () => buildAssessmentHandle({
       checkId,
-      getScore: () => {
-        const maxScore = 1;
-        if (quizPassed && selected !== null) return maxScore;
-        if (selected === null) return 0;
-        return selectionCorrect ? maxScore : 0;
-      },
-      getMaxScore: () => 1,
+      getScore: () => resolveScores().score,
+      getMaxScore: () => resolveScores().maxScore,
       getAnswerGiven: () => selected !== null,
       resetTask: () => {
         completedRef.current = false;
+        telemetryReplayedRef.current = false;
         setQuizPassed(false);
         setSelected(null);
         setSelectionCorrect(null);
+        setCompletedScore(null);
+        setCompletedMaxScore(null);
       },
       showSolutions: () => {
       },
-      getXAPIData: () => ({
-        checkId,
-        interactionType: "mcq",
-        response: selected ?? void 0,
-        correct: selectionCorrect ?? void 0,
-        score: quizPassed && selected !== null ? 1 : selected === null ? 0 : selectionCorrect ? 1 : 0,
-        maxScore: 1
+      getXAPIData: () => {
+        const { score, maxScore } = resolveScores();
+        return {
+          checkId,
+          interactionType: "mcq",
+          response: selected ?? void 0,
+          correct: selectionCorrect ?? void 0,
+          score,
+          maxScore
+        };
+      },
+      getCurrentState: () => ({
+        selected,
+        selectionCorrect,
+        quizPassed,
+        completedScore,
+        completedMaxScore
       }),
-      getCurrentState: () => ({ selected, selectionCorrect, quizPassed }),
       resume: (state) => {
         const nextSelected = readStringField(state, "selected");
         if (typeof nextSelected === "string" || nextSelected === null) setSelected(nextSelected);
@@ -1432,21 +1528,47 @@ function QuizInner(props, ref) {
         if (nextCorrect === true || nextCorrect === false || nextCorrect === null) {
           setSelectionCorrect(nextCorrect);
         }
-        readBooleanStateField(state, "quizPassed", (value) => {
-          setQuizPassed(value);
-          completedRef.current = value;
-        });
+        const nextCompletedScore = readNumberField(state, "completedScore");
+        if (typeof nextCompletedScore === "number") setCompletedScore(nextCompletedScore);
+        const nextCompletedMaxScore = readNumberField(state, "completedMaxScore");
+        if (typeof nextCompletedMaxScore === "number") setCompletedMaxScore(nextCompletedMaxScore);
+        const nextPassed = readBooleanField(state, "quizPassed");
+        if (nextPassed === true || nextPassed === false) {
+          setQuizPassed(nextPassed);
+          completedRef.current = nextPassed;
+          if (nextPassed) {
+            const maxScore = nextCompletedMaxScore ?? completedMaxScore ?? 1;
+            const score = nextCompletedScore ?? completedScore ?? maxScore;
+            replayTelemetry(
+              nextSelected ?? null,
+              nextCorrect ?? null,
+              nextPassed,
+              score,
+              maxScore
+            );
+          }
+        }
       }
     }),
-    [checkId, quizPassed, selected, selectionCorrect]
+    [
+      checkId,
+      completedMaxScore,
+      completedScore,
+      props.passingScore,
+      props.question,
+      quiz,
+      quizPassed,
+      selected,
+      selectionCorrect
+    ]
   );
   useAssessmentHandleRegistration(checkId, handle, ref);
   return /* @__PURE__ */ jsxs2("section", { "aria-label": "Quiz", "data-lk-check-id": checkId, children: [
-    /* @__PURE__ */ jsx4("p", { id: questionId, children: props.question }),
+    /* @__PURE__ */ jsx6("p", { id: questionId, children: props.question }),
     /* @__PURE__ */ jsxs2("fieldset", { "aria-labelledby": questionId, children: [
-      /* @__PURE__ */ jsx4("legend", { style: visuallyHiddenStyle, children: "Quiz choices" }),
+      /* @__PURE__ */ jsx6("legend", { style: visuallyHiddenStyle, children: "Quiz choices" }),
       props.choices.map((c, i) => /* @__PURE__ */ jsxs2("label", { style: { display: "block" }, children: [
-        /* @__PURE__ */ jsx4(
+        /* @__PURE__ */ jsx6(
           "input",
           {
             type: "radio",
@@ -1471,9 +1593,12 @@ function QuizInner(props, ref) {
                 completedRef.current = true;
                 setQuizPassed(true);
                 const maxScore = custom?.maxScore ?? 1;
+                const score = custom?.score ?? maxScore;
+                setCompletedScore(score);
+                setCompletedMaxScore(maxScore);
                 quiz.complete({
                   checkId,
-                  score: custom?.score ?? maxScore,
+                  score,
                   maxScore,
                   passingScore: props.passingScore ?? maxScore
                 });
@@ -1484,15 +1609,15 @@ function QuizInner(props, ref) {
         c
       ] }, `${questionId}-${i}`))
     ] }),
-    selected && selectionCorrect !== null ? /* @__PURE__ */ jsx4("p", { role: "status", "aria-live": "polite", children: selectionCorrect ? "Correct" : "Try again" }) : null
+    selected && selectionCorrect !== null ? /* @__PURE__ */ jsx6("p", { role: "status", "aria-live": "polite", children: selectionCorrect ? "Correct" : "Try again" }) : null
   ] });
 }
 var QuizInnerForwarded = forwardRef(QuizInner);
 var Quiz = forwardRef(function Quiz2(props, ref) {
-  return /* @__PURE__ */ jsx4(AssessmentLessonGuard, { blockLabel: "Quiz", checkId: props.checkId, children: (lessonId) => /* @__PURE__ */ jsx4(QuizInnerForwarded, { ...props, enclosingLessonId: lessonId, ref }) });
+  return /* @__PURE__ */ jsx6(AssessmentLessonGuard, { blockLabel: "Quiz", checkId: props.checkId, children: (lessonId) => /* @__PURE__ */ jsx6(QuizInnerForwarded, { ...props, enclosingLessonId: lessonId, ref }) });
 });
 function KnowledgeCheck(props) {
-  return /* @__PURE__ */ jsx4(
+  return /* @__PURE__ */ jsx6(
     Quiz,
     {
       checkId: props.checkId,
@@ -1508,16 +1633,16 @@ function resetQuizWarningsForTests() {
 }
 
 // src/components.tsx
-import { jsx as jsx5, jsxs as jsxs3 } from "react/jsx-runtime";
+import { jsx as jsx7, jsxs as jsxs3 } from "react/jsx-runtime";
 function Course(props) {
   const courseId = useMemo6(() => normalizeComponentId(props.courseId, "courseId"), [props.courseId]);
   const providerConfig = useMemo6(
     () => ({ ...props.config, courseId }),
     [props.config, courseId]
   );
-  return /* @__PURE__ */ jsx5(LessonkitProvider, { config: providerConfig, children: /* @__PURE__ */ jsxs3("section", { "aria-label": props.title, children: [
-    /* @__PURE__ */ jsx5("h1", { children: props.title }),
-    /* @__PURE__ */ jsx5("div", { children: props.children })
+  return /* @__PURE__ */ jsx7(LessonkitProvider, { config: providerConfig, children: /* @__PURE__ */ jsxs3("section", { "aria-label": props.title, children: [
+    /* @__PURE__ */ jsx7("h1", { children: props.title }),
+    /* @__PURE__ */ jsx7("div", { children: props.children })
   ] }) });
 }
 function Lesson(props) {
@@ -1525,8 +1650,8 @@ function Lesson(props) {
   const autoComplete = props.autoCompleteOnUnmount !== false;
   const { setActiveLesson, config } = useLessonkit();
   const { completeLesson } = useCompletion();
-  const lessonMountGenerationRef = useRef4(0);
-  const liveCourseIdRef = useRef4(config.courseId);
+  const lessonMountGenerationRef = useRef5(0);
+  const liveCourseIdRef = useRef5(config.courseId);
   liveCourseIdRef.current = config.courseId;
   useEffect4(() => {
     const unregister = registerLessonMount(lessonId);
@@ -1553,9 +1678,9 @@ function Lesson(props) {
       });
     };
   }, [lessonId, config.courseId, setActiveLesson, completeLesson, autoComplete]);
-  return /* @__PURE__ */ jsx5(LessonContext.Provider, { value: lessonId, children: /* @__PURE__ */ jsxs3("article", { "aria-label": props.title, children: [
-    /* @__PURE__ */ jsx5("h2", { children: props.title }),
-    /* @__PURE__ */ jsx5("div", { children: props.children })
+  return /* @__PURE__ */ jsx7(LessonContext.Provider, { value: lessonId, children: /* @__PURE__ */ jsxs3("article", { "aria-label": props.title, children: [
+    /* @__PURE__ */ jsx7("h2", { children: props.title }),
+    /* @__PURE__ */ jsx7("div", { children: props.children })
   ] }) });
 }
 function Scenario(props) {
@@ -1563,7 +1688,7 @@ function Scenario(props) {
     () => props.blockId !== void 0 ? normalizeComponentId(props.blockId, "blockId") : void 0,
     [props.blockId]
   );
-  return /* @__PURE__ */ jsx5("section", { "aria-label": "Scenario", "data-lk-block-id": blockId, children: props.children });
+  return /* @__PURE__ */ jsx7("section", { "aria-label": "Scenario", "data-lk-block-id": blockId, children: props.children });
 }
 function Reflection(props) {
   const blockId = useMemo6(
@@ -1580,10 +1705,10 @@ function Reflection(props) {
     props.onChange?.(event.target.value);
   };
   return /* @__PURE__ */ jsxs3("section", { "aria-label": "Reflection", "data-lk-block-id": blockId, children: [
-    props.prompt ? /* @__PURE__ */ jsx5("p", { id: promptId, children: props.prompt }) : null,
-    props.hint ? /* @__PURE__ */ jsx5("p", { id: hintId, style: visuallyHiddenStyle2, children: props.hint }) : null,
+    props.prompt ? /* @__PURE__ */ jsx7("p", { id: promptId, children: props.prompt }) : null,
+    props.hint ? /* @__PURE__ */ jsx7("p", { id: hintId, style: visuallyHiddenStyle2, children: props.hint }) : null,
     props.children,
-    /* @__PURE__ */ jsx5(
+    /* @__PURE__ */ jsx7(
       "textarea",
       {
         value,
@@ -1601,7 +1726,7 @@ function ProgressTracker(props) {
   if (props.totalLessons != null) {
     const total = props.totalLessons;
     const displayed = Math.min(completed, total);
-    return /* @__PURE__ */ jsx5("aside", { "aria-label": "Progress", children: /* @__PURE__ */ jsx5(
+    return /* @__PURE__ */ jsx7("aside", { "aria-label": "Progress", children: /* @__PURE__ */ jsx7(
       "div",
       {
         role: "progressbar",
@@ -1618,15 +1743,15 @@ function ProgressTracker(props) {
       }
     ) });
   }
-  return /* @__PURE__ */ jsx5("aside", { "aria-label": "Progress", role: "status", children: /* @__PURE__ */ jsxs3("p", { children: [
+  return /* @__PURE__ */ jsx7("aside", { "aria-label": "Progress", role: "status", children: /* @__PURE__ */ jsxs3("p", { children: [
     "Lessons completed: ",
     completed
   ] }) });
 }
 
 // src/blocks/TrueFalse.tsx
-import React7, { forwardRef as forwardRef2, useEffect as useEffect5, useMemo as useMemo7, useRef as useRef5, useState as useState5 } from "react";
-import { jsx as jsx6, jsxs as jsxs4 } from "react/jsx-runtime";
+import React9, { forwardRef as forwardRef2, useEffect as useEffect5, useMemo as useMemo7, useRef as useRef6, useState as useState5 } from "react";
+import { jsx as jsx8, jsxs as jsxs4 } from "react/jsx-runtime";
 var INTERACTION = "trueFalse";
 function TrueFalseInner(props, ref) {
   const { enclosingLessonId } = props;
@@ -1638,38 +1763,81 @@ function TrueFalseInner(props, ref) {
   const [selectionCorrect, setSelectionCorrect] = useState5(null);
   const [showSolutions, setShowSolutions] = useState5(false);
   const [passed, setPassed] = useState5(false);
-  const completedRef = useRef5(false);
-  const questionId = React7.useId();
+  const [completedScore, setCompletedScore] = useState5(null);
+  const [completedMaxScore, setCompletedMaxScore] = useState5(null);
+  const completedRef = useRef6(false);
+  const telemetryReplayedRef = useRef6(false);
+  const questionId = React9.useId();
   const reset = () => {
     completedRef.current = false;
+    telemetryReplayedRef.current = false;
     setPassed(false);
     setSelected(null);
     setSelectionCorrect(null);
     setShowSolutions(false);
+    setCompletedScore(null);
+    setCompletedMaxScore(null);
   };
   useEffect5(() => {
     reset();
   }, [checkId, props.answer, props.question, config.courseId, enclosingLessonId]);
+  const resolveScores = () => {
+    const maxScore = completedMaxScore ?? 1;
+    if (passed) {
+      return { score: completedScore ?? maxScore, maxScore };
+    }
+    if (selectionCorrect) {
+      return { score: completedMaxScore ?? maxScore, maxScore };
+    }
+    return { score: 0, maxScore };
+  };
+  const replayTelemetry = (nextSelected, nextCorrect, nextPassed, nextScore, nextMaxScore) => {
+    if (!nextPassed || telemetryReplayedRef.current) return;
+    telemetryReplayedRef.current = true;
+    if (nextSelected !== null) {
+      assessment.answer({
+        checkId,
+        interactionType: INTERACTION,
+        question: props.question,
+        response: nextSelected,
+        correct: nextCorrect ?? false
+      });
+    }
+    assessment.complete({
+      checkId,
+      interactionType: INTERACTION,
+      score: nextScore,
+      maxScore: nextMaxScore,
+      passingScore: props.passingScore ?? nextMaxScore
+    });
+  };
   const handle = useMemo7(
     () => buildAssessmentHandle({
       checkId,
-      getScore: () => {
-        const maxScore = 1;
-        return passed ? maxScore : selected === null ? 0 : selected === props.answer ? maxScore : 0;
-      },
-      getMaxScore: () => 1,
+      getScore: () => resolveScores().score,
+      getMaxScore: () => resolveScores().maxScore,
       getAnswerGiven: () => selected !== null,
       resetTask: reset,
       showSolutions: () => setShowSolutions(true),
-      getXAPIData: () => ({
-        checkId,
-        interactionType: INTERACTION,
-        response: selected ?? void 0,
-        correct: selected === props.answer,
-        score: passed ? 1 : selected === null ? 0 : selected === props.answer ? 1 : 0,
-        maxScore: 1
+      getXAPIData: () => {
+        const { score, maxScore } = resolveScores();
+        return {
+          checkId,
+          interactionType: INTERACTION,
+          response: selected ?? void 0,
+          correct: selectionCorrect ?? void 0,
+          score,
+          maxScore
+        };
+      },
+      getCurrentState: () => ({
+        selected,
+        selectionCorrect,
+        passed,
+        showSolutions,
+        completedScore,
+        completedMaxScore
       }),
-      getCurrentState: () => ({ selected, selectionCorrect, passed, showSolutions }),
       resume: (state) => {
         const nextSelected = readBooleanField(state, "selected");
         if (nextSelected === true || nextSelected === false || nextSelected === null) {
@@ -1679,14 +1847,35 @@ function TrueFalseInner(props, ref) {
         if (nextCorrect === true || nextCorrect === false || nextCorrect === null) {
           setSelectionCorrect(nextCorrect);
         }
-        readBooleanStateField(state, "passed", (value) => {
-          setPassed(value);
-          completedRef.current = value;
-        });
+        const nextCompletedScore = readNumberField(state, "completedScore");
+        if (typeof nextCompletedScore === "number") setCompletedScore(nextCompletedScore);
+        const nextCompletedMaxScore = readNumberField(state, "completedMaxScore");
+        if (typeof nextCompletedMaxScore === "number") setCompletedMaxScore(nextCompletedMaxScore);
+        const nextPassed = readBooleanField(state, "passed");
+        if (nextPassed === true || nextPassed === false) {
+          setPassed(nextPassed);
+          completedRef.current = nextPassed;
+          if (nextPassed) {
+            const maxScore = nextCompletedMaxScore ?? completedMaxScore ?? 1;
+            const score = nextCompletedScore ?? completedScore ?? maxScore;
+            replayTelemetry(nextSelected ?? null, nextCorrect ?? null, nextPassed, score, maxScore);
+          }
+        }
         readBooleanStateField(state, "showSolutions", setShowSolutions);
       }
     }),
-    [checkId, passed, props.answer, selected, selectionCorrect, showSolutions]
+    [
+      assessment,
+      checkId,
+      completedMaxScore,
+      completedScore,
+      passed,
+      props.passingScore,
+      props.question,
+      selected,
+      selectionCorrect,
+      showSolutions
+    ]
   );
   useAssessmentHandleRegistration(checkId, handle, ref);
   const submit = (value) => {
@@ -1705,6 +1894,8 @@ function TrueFalseInner(props, ref) {
     if (scored.passed && !completedRef.current) {
       completedRef.current = true;
       setPassed(true);
+      setCompletedScore(scored.score);
+      setCompletedMaxScore(scored.maxScore);
       assessment.complete({
         checkId,
         interactionType: INTERACTION,
@@ -1716,11 +1907,11 @@ function TrueFalseInner(props, ref) {
   };
   const reveal = showSolutions || passed && props.enableSolutionsButton;
   return /* @__PURE__ */ jsxs4("section", { "aria-label": "True or False", "data-lk-check-id": checkId, children: [
-    /* @__PURE__ */ jsx6("p", { id: questionId, children: props.question }),
+    /* @__PURE__ */ jsx8("p", { id: questionId, children: props.question }),
     /* @__PURE__ */ jsxs4("fieldset", { "aria-labelledby": questionId, children: [
-      /* @__PURE__ */ jsx6("legend", { className: "lk-visually-hidden", children: "True or False" }),
+      /* @__PURE__ */ jsx8("legend", { className: "lk-visually-hidden", children: "True or False" }),
       /* @__PURE__ */ jsxs4("label", { style: { display: "block", marginRight: "1rem" }, children: [
-        /* @__PURE__ */ jsx6(
+        /* @__PURE__ */ jsx8(
           "input",
           {
             type: "radio",
@@ -1733,7 +1924,7 @@ function TrueFalseInner(props, ref) {
         "True"
       ] }),
       /* @__PURE__ */ jsxs4("label", { style: { display: "block" }, children: [
-        /* @__PURE__ */ jsx6(
+        /* @__PURE__ */ jsx8(
           "input",
           {
             type: "radio",
@@ -1748,21 +1939,21 @@ function TrueFalseInner(props, ref) {
     ] }),
     reveal ? /* @__PURE__ */ jsxs4("p", { children: [
       "Correct answer: ",
-      /* @__PURE__ */ jsx6("strong", { children: props.answer ? "True" : "False" })
+      /* @__PURE__ */ jsx8("strong", { children: props.answer ? "True" : "False" })
     ] }) : null,
-    selected !== null && selectionCorrect !== null ? /* @__PURE__ */ jsx6("p", { role: "status", "aria-live": "polite", children: selectionCorrect ? "Correct" : "Try again" }) : null,
-    props.enableRetry && passed ? /* @__PURE__ */ jsx6("button", { type: "button", onClick: reset, children: "Try again" }) : null,
-    props.enableSolutionsButton && !reveal ? /* @__PURE__ */ jsx6("button", { type: "button", onClick: () => setShowSolutions(true), children: "Show solution" }) : null
+    selected !== null && selectionCorrect !== null ? /* @__PURE__ */ jsx8("p", { role: "status", "aria-live": "polite", children: selectionCorrect ? "Correct" : "Try again" }) : null,
+    props.enableRetry && passed ? /* @__PURE__ */ jsx8("button", { type: "button", onClick: reset, children: "Try again" }) : null,
+    props.enableSolutionsButton && !reveal ? /* @__PURE__ */ jsx8("button", { type: "button", onClick: () => setShowSolutions(true), children: "Show solution" }) : null
   ] });
 }
 var TrueFalseInnerForwarded = forwardRef2(TrueFalseInner);
 var TrueFalse = forwardRef2(function TrueFalse2(props, ref) {
-  return /* @__PURE__ */ jsx6(AssessmentLessonGuard, { blockLabel: "TrueFalse", checkId: props.checkId, children: (lessonId) => /* @__PURE__ */ jsx6(TrueFalseInnerForwarded, { ...props, enclosingLessonId: lessonId, ref }) });
+  return /* @__PURE__ */ jsx8(AssessmentLessonGuard, { blockLabel: "TrueFalse", checkId: props.checkId, children: (lessonId) => /* @__PURE__ */ jsx8(TrueFalseInnerForwarded, { ...props, enclosingLessonId: lessonId, ref }) });
 });
 
 // src/blocks/MarkTheWords.tsx
-import React8, { forwardRef as forwardRef3, useEffect as useEffect6, useMemo as useMemo8, useRef as useRef6, useState as useState6 } from "react";
-import { jsx as jsx7, jsxs as jsxs5 } from "react/jsx-runtime";
+import React10, { forwardRef as forwardRef3, useEffect as useEffect6, useMemo as useMemo8, useRef as useRef7, useState as useState6 } from "react";
+import { jsx as jsx9, jsxs as jsxs5 } from "react/jsx-runtime";
 var INTERACTION2 = "markTheWords";
 function tokenize(text) {
   return text.split(/(\s+)/).filter((t) => t.length > 0);
@@ -1778,7 +1969,7 @@ function MarkTheWordsInner(props, ref) {
   const [marked, setMarked] = useState6(() => /* @__PURE__ */ new Set());
   const [passed, setPassed] = useState6(false);
   const [showSolutions, setShowSolutions] = useState6(false);
-  const completedRef = useRef6(false);
+  const completedRef = useRef7(false);
   const reset = () => {
     completedRef.current = false;
     setPassed(false);
@@ -1857,7 +2048,7 @@ function MarkTheWordsInner(props, ref) {
       interactionType: INTERACTION2,
       question: props.text,
       response: [...marked].map((i) => tokens[i]),
-      correct: true
+      correct: passedThreshold
     });
     assessment.complete({
       checkId,
@@ -1882,17 +2073,17 @@ function MarkTheWordsInner(props, ref) {
   return /* @__PURE__ */ jsxs5("section", { "aria-label": "Mark the Words", "data-lk-check-id": checkId, children: [
     !hasTargets ? /* @__PURE__ */ jsxs5("p", { role: "alert", children: [
       "No words in this sentence match ",
-      /* @__PURE__ */ jsx7("code", { children: "correctWords" }),
+      /* @__PURE__ */ jsx9("code", { children: "correctWords" }),
       ". Check spelling and capitalization in the source text."
     ] }) : null,
-    /* @__PURE__ */ jsx7("p", { id: `${checkId}-hint`, children: "Select the correct words in the sentence." }),
-    /* @__PURE__ */ jsx7("p", { "aria-describedby": `${checkId}-hint`, children: tokens.map((token, i) => {
+    /* @__PURE__ */ jsx9("p", { id: `${checkId}-hint`, children: "Select the correct words in the sentence." }),
+    /* @__PURE__ */ jsx9("p", { "aria-describedby": `${checkId}-hint`, children: tokens.map((token, i) => {
       const isWord = !/^\s+$/.test(token);
       const isTarget = isWord && correctSet.has(token.toLowerCase());
-      if (!isTarget) return /* @__PURE__ */ jsx7(React8.Fragment, { children: token }, i);
+      if (!isTarget) return /* @__PURE__ */ jsx9(React10.Fragment, { children: token }, i);
       const selected = marked.has(i);
       const solution = showSolutions || passed && props.enableSolutionsButton;
-      return /* @__PURE__ */ jsx7(
+      return /* @__PURE__ */ jsx9(
         "button",
         {
           type: "button",
@@ -1910,18 +2101,18 @@ function MarkTheWordsInner(props, ref) {
         i
       );
     }) }),
-    allMarked ? /* @__PURE__ */ jsx7("p", { role: "status", "aria-live": "polite", children: "Correct" }) : null,
-    props.enableRetry && passed ? /* @__PURE__ */ jsx7("button", { type: "button", onClick: reset, children: "Try again" }) : null,
-    props.enableSolutionsButton && !showSolutions ? /* @__PURE__ */ jsx7("button", { type: "button", onClick: () => setShowSolutions(true), children: "Show solution" }) : null
+    allMarked ? /* @__PURE__ */ jsx9("p", { role: "status", "aria-live": "polite", children: "Correct" }) : null,
+    props.enableRetry && passed ? /* @__PURE__ */ jsx9("button", { type: "button", onClick: reset, children: "Try again" }) : null,
+    props.enableSolutionsButton && !showSolutions ? /* @__PURE__ */ jsx9("button", { type: "button", onClick: () => setShowSolutions(true), children: "Show solution" }) : null
   ] });
 }
 var MarkTheWordsInnerForwarded = forwardRef3(MarkTheWordsInner);
 var MarkTheWords = forwardRef3(function MarkTheWords2(props, ref) {
-  return /* @__PURE__ */ jsx7(AssessmentLessonGuard, { blockLabel: "MarkTheWords", checkId: props.checkId, children: (lessonId) => /* @__PURE__ */ jsx7(MarkTheWordsInnerForwarded, { ...props, enclosingLessonId: lessonId, ref }) });
+  return /* @__PURE__ */ jsx9(AssessmentLessonGuard, { blockLabel: "MarkTheWords", checkId: props.checkId, children: (lessonId) => /* @__PURE__ */ jsx9(MarkTheWordsInnerForwarded, { ...props, enclosingLessonId: lessonId, ref }) });
 });
 
 // src/blocks/FillInTheBlanks.tsx
-import React9, { forwardRef as forwardRef4, useEffect as useEffect7, useMemo as useMemo9, useRef as useRef7, useState as useState7 } from "react";
+import React11, { forwardRef as forwardRef4, useEffect as useEffect7, useMemo as useMemo9, useRef as useRef8, useState as useState7 } from "react";
 
 // src/assessment/internal/parseStarDelimitedTemplate.ts
 function parseStarDelimitedTemplate(template, idPrefix) {
@@ -1942,7 +2133,7 @@ function parseStarDelimitedTemplate(template, idPrefix) {
 }
 
 // src/blocks/FillInTheBlanks.tsx
-import { jsx as jsx8, jsxs as jsxs6 } from "react/jsx-runtime";
+import { jsx as jsx10, jsxs as jsxs6 } from "react/jsx-runtime";
 var INTERACTION3 = "fillInBlanks";
 function parseTemplate(template) {
   const { parts, values } = parseStarDelimitedTemplate(template, "blank");
@@ -1961,14 +2152,16 @@ function FillInTheBlanksInner(props, ref) {
   );
   const [passed, setPassed] = useState7(false);
   const [showSolutions, setShowSolutions] = useState7(false);
-  const completedRef = useRef7(false);
-  const answeredRef = useRef7(false);
+  const [submitted, setSubmitted] = useState7(false);
+  const completedRef = useRef8(false);
+  const answeredRef = useRef8(false);
   const reset = () => {
     completedRef.current = false;
     answeredRef.current = false;
     setPassed(false);
     setValues(Object.fromEntries(blanks.map((b) => [b.id, ""])));
     setShowSolutions(false);
+    setSubmitted(false);
   };
   useEffect7(() => {
     reset();
@@ -1997,7 +2190,7 @@ function FillInTheBlanksInner(props, ref) {
         score,
         maxScore: maxScore || 1
       }),
-      getCurrentState: () => ({ values, passed, showSolutions }),
+      getCurrentState: () => ({ values, passed, showSolutions, submitted }),
       resume: (state) => {
         const raw = state.values;
         if (raw && typeof raw === "object") setValues({ ...raw });
@@ -2007,9 +2200,13 @@ function FillInTheBlanksInner(props, ref) {
           answeredRef.current = value;
         });
         readBooleanStateField(state, "showSolutions", setShowSolutions);
+        readBooleanStateField(state, "submitted", (value) => {
+          setSubmitted(value);
+          if (value) answeredRef.current = true;
+        });
       }
     }),
-    [allFilled, checkId, maxScore, passed, passedThreshold, score, showSolutions, values]
+    [allFilled, checkId, maxScore, passed, passedThreshold, score, showSolutions, submitted, values]
   );
   useAssessmentHandleRegistration(checkId, handle, ref);
   const check = () => {
@@ -2020,16 +2217,16 @@ function FillInTheBlanksInner(props, ref) {
       return;
     }
     if (!allFilled) return;
-    if (!answeredRef.current) {
-      answeredRef.current = true;
-      assessment.answer({
-        checkId,
-        interactionType: INTERACTION3,
-        question: props.template,
-        response: values,
-        correct: passedThreshold
-      });
-    }
+    if (answeredRef.current || submitted) return;
+    answeredRef.current = true;
+    setSubmitted(true);
+    assessment.answer({
+      checkId,
+      interactionType: INTERACTION3,
+      question: props.template,
+      response: values,
+      correct: passedThreshold
+    });
     if (passedThreshold && !completedRef.current) {
       completedRef.current = true;
       setPassed(true);
@@ -2043,19 +2240,22 @@ function FillInTheBlanksInner(props, ref) {
     }
   };
   useEffect7(() => {
-    if (!allFilled) answeredRef.current = false;
+    if (!allFilled) {
+      answeredRef.current = false;
+      setSubmitted(false);
+    }
   }, [allFilled]);
   useEffect7(() => {
     if (props.autoCheck && allFilled) check();
   }, [allFilled, props.autoCheck, values, passedThreshold]);
   const reveal = showSolutions || passed && props.enableSolutionsButton;
   return /* @__PURE__ */ jsxs6("section", { "aria-label": "Fill in the Blanks", "data-lk-check-id": checkId, children: [
-    /* @__PURE__ */ jsx8("p", { children: parsed.parts.map((part, i) => {
+    /* @__PURE__ */ jsx10("p", { children: parsed.parts.map((part, i) => {
       const blank = blanks.find((b) => b.id === part);
-      if (!blank) return /* @__PURE__ */ jsx8(React9.Fragment, { children: part }, i);
+      if (!blank) return /* @__PURE__ */ jsx10(React11.Fragment, { children: part }, i);
       return /* @__PURE__ */ jsxs6("label", { style: { margin: "0 0.25em" }, children: [
-        /* @__PURE__ */ jsx8("span", { className: "lk-visually-hidden", children: blank.answer }),
-        /* @__PURE__ */ jsx8(
+        /* @__PURE__ */ jsx10("span", { className: "lk-visually-hidden", children: blank.answer }),
+        /* @__PURE__ */ jsx10(
           "input",
           {
             type: "text",
@@ -2071,23 +2271,23 @@ function FillInTheBlanksInner(props, ref) {
         )
       ] }, blank.id);
     }) }),
-    !props.autoCheck ? /* @__PURE__ */ jsx8("button", { type: "button", "data-testid": "check-blanks", disabled: !allFilled || passed, onClick: check, children: "Check" }) : null,
-    !hasBlanks ? /* @__PURE__ */ jsx8("p", { role: "alert", children: "This activity has no blanks. Add text wrapped in asterisks, e.g. The *answer* here." }) : null,
-    allFilled ? /* @__PURE__ */ jsx8("p", { role: "status", "aria-live": "polite", children: passed || passedThreshold ? "Correct" : "Try again" }) : null,
-    props.enableRetry && passed ? /* @__PURE__ */ jsx8("button", { type: "button", onClick: reset, children: "Try again" }) : null,
-    props.enableSolutionsButton && !reveal ? /* @__PURE__ */ jsx8("button", { type: "button", onClick: () => setShowSolutions(true), children: "Show solution" }) : null
+    !props.autoCheck ? /* @__PURE__ */ jsx10("button", { type: "button", "data-testid": "check-blanks", disabled: !allFilled || passed, onClick: check, children: "Check" }) : null,
+    !hasBlanks ? /* @__PURE__ */ jsx10("p", { role: "alert", children: "This activity has no blanks. Add text wrapped in asterisks, e.g. The *answer* here." }) : null,
+    submitted ? /* @__PURE__ */ jsx10("p", { role: "status", "aria-live": "polite", children: passed || passedThreshold ? "Correct" : "Try again" }) : null,
+    props.enableRetry && passed ? /* @__PURE__ */ jsx10("button", { type: "button", onClick: reset, children: "Try again" }) : null,
+    props.enableSolutionsButton && !reveal ? /* @__PURE__ */ jsx10("button", { type: "button", onClick: () => setShowSolutions(true), children: "Show solution" }) : null
   ] });
 }
 var FillInTheBlanksInnerForwarded = forwardRef4(FillInTheBlanksInner);
 var FillInTheBlanks = forwardRef4(
   function FillInTheBlanks2(props, ref) {
-    return /* @__PURE__ */ jsx8(AssessmentLessonGuard, { blockLabel: "FillInTheBlanks", checkId: props.checkId, children: (lessonId) => /* @__PURE__ */ jsx8(FillInTheBlanksInnerForwarded, { ...props, enclosingLessonId: lessonId, ref }) });
+    return /* @__PURE__ */ jsx10(AssessmentLessonGuard, { blockLabel: "FillInTheBlanks", checkId: props.checkId, children: (lessonId) => /* @__PURE__ */ jsx10(FillInTheBlanksInnerForwarded, { ...props, enclosingLessonId: lessonId, ref }) });
   }
 );
 
 // src/blocks/DragTheWords.tsx
-import React10, { forwardRef as forwardRef5, useEffect as useEffect8, useMemo as useMemo10, useRef as useRef8, useState as useState8 } from "react";
-import { jsx as jsx9, jsxs as jsxs7 } from "react/jsx-runtime";
+import React12, { forwardRef as forwardRef5, useEffect as useEffect8, useMemo as useMemo10, useRef as useRef9, useState as useState8 } from "react";
+import { jsx as jsx11, jsxs as jsxs7 } from "react/jsx-runtime";
 var INTERACTION4 = "dragTheWords";
 function parseZones(template) {
   const { parts, values } = parseStarDelimitedTemplate(template, "zone");
@@ -2103,12 +2303,14 @@ function DragTheWordsInner(props, ref) {
   const [pool, setPool] = useState8(() => [...props.words]);
   const [keyboardWord, setKeyboardWord] = useState8(null);
   const [passed, setPassed] = useState8(false);
-  const completedRef = useRef8(false);
-  const answeredRef = useRef8(false);
+  const [submitted, setSubmitted] = useState8(false);
+  const completedRef = useRef9(false);
+  const answeredRef = useRef9(false);
   const reset = () => {
     completedRef.current = false;
     answeredRef.current = false;
     setPassed(false);
+    setSubmitted(false);
     setZones(Object.fromEntries(answers.map((_, i) => [`zone-${i}`, ""])));
     setPool([...props.words]);
     setKeyboardWord(null);
@@ -2141,7 +2343,7 @@ function DragTheWordsInner(props, ref) {
         score,
         maxScore: maxScore || 1
       }),
-      getCurrentState: () => ({ zones, pool, passed, keyboardWord }),
+      getCurrentState: () => ({ zones, pool, passed, keyboardWord, submitted }),
       resume: (state) => {
         const rawZones = state.zones;
         if (rawZones && typeof rawZones === "object") setZones({ ...rawZones });
@@ -2151,11 +2353,15 @@ function DragTheWordsInner(props, ref) {
           completedRef.current = value;
           answeredRef.current = value;
         });
+        readBooleanStateField(state, "submitted", (value) => {
+          setSubmitted(value);
+          if (value) answeredRef.current = true;
+        });
         const kw = state.keyboardWord;
         if (kw === null || typeof kw === "string") setKeyboardWord(kw ?? null);
       }
     }),
-    [allFilled, checkId, keyboardWord, maxScore, passed, passedThreshold, pool, score, zones]
+    [allFilled, checkId, keyboardWord, maxScore, passed, passedThreshold, pool, score, submitted, zones]
   );
   useAssessmentHandleRegistration(checkId, handle, ref);
   const placeInZone = (zoneId, word) => {
@@ -2185,16 +2391,16 @@ function DragTheWordsInner(props, ref) {
       return;
     }
     if (!allFilled) return;
-    if (!answeredRef.current) {
-      answeredRef.current = true;
-      assessment.answer({
-        checkId,
-        interactionType: INTERACTION4,
-        question: props.template,
-        response: zones,
-        correct: passedThreshold
-      });
-    }
+    if (answeredRef.current || submitted) return;
+    answeredRef.current = true;
+    setSubmitted(true);
+    assessment.answer({
+      checkId,
+      interactionType: INTERACTION4,
+      question: props.template,
+      response: zones,
+      correct: passedThreshold
+    });
     if (passedThreshold && !completedRef.current) {
       completedRef.current = true;
       setPassed(true);
@@ -2208,14 +2414,17 @@ function DragTheWordsInner(props, ref) {
     }
   };
   useEffect8(() => {
-    if (!allFilled) answeredRef.current = false;
+    if (!allFilled) {
+      answeredRef.current = false;
+      setSubmitted(false);
+    }
   }, [allFilled]);
   useEffect8(() => {
     if (props.autoCheck && allFilled) check();
   }, [allFilled, props.autoCheck, zones, passedThreshold]);
   return /* @__PURE__ */ jsxs7("section", { "aria-label": "Drag the Words", "data-lk-check-id": checkId, children: [
-    /* @__PURE__ */ jsx9("p", { children: "Drag words into the blanks (or select a word, then activate a blank)." }),
-    /* @__PURE__ */ jsx9("div", { role: "list", "aria-label": "Word bank", "data-testid": "word-bank", children: pool.map((word) => /* @__PURE__ */ jsx9(
+    /* @__PURE__ */ jsx11("p", { children: "Drag words into the blanks (or select a word, then activate a blank)." }),
+    /* @__PURE__ */ jsx11("div", { role: "list", "aria-label": "Word bank", "data-testid": "word-bank", children: pool.map((word) => /* @__PURE__ */ jsx11(
       "button",
       {
         type: "button",
@@ -2229,9 +2438,9 @@ function DragTheWordsInner(props, ref) {
       },
       word
     )) }),
-    /* @__PURE__ */ jsx9("p", { children: parts.map((part, i) => {
-      if (!part.startsWith("zone-")) return /* @__PURE__ */ jsx9(React10.Fragment, { children: part }, i);
-      return /* @__PURE__ */ jsx9(
+    /* @__PURE__ */ jsx11("p", { children: parts.map((part, i) => {
+      if (!part.startsWith("zone-")) return /* @__PURE__ */ jsx11(React12.Fragment, { children: part }, i);
+      return /* @__PURE__ */ jsx11(
         "span",
         {
           role: "button",
@@ -2255,19 +2464,19 @@ function DragTheWordsInner(props, ref) {
         part
       );
     }) }),
-    /* @__PURE__ */ jsx9("button", { type: "button", "data-testid": "check-drag-words", disabled: !allFilled || passed, onClick: check, children: "Check" }),
-    !hasZones ? /* @__PURE__ */ jsx9("p", { role: "alert", children: "This activity has no drop zones. Wrap answers in asterisks in the template." }) : null,
-    allFilled ? /* @__PURE__ */ jsx9("p", { role: "status", "aria-live": "polite", children: passed || passedThreshold ? "Correct" : "Try again" }) : null
+    /* @__PURE__ */ jsx11("button", { type: "button", "data-testid": "check-drag-words", disabled: !allFilled || passed, onClick: check, children: "Check" }),
+    !hasZones ? /* @__PURE__ */ jsx11("p", { role: "alert", children: "This activity has no drop zones. Wrap answers in asterisks in the template." }) : null,
+    submitted ? /* @__PURE__ */ jsx11("p", { role: "status", "aria-live": "polite", children: passed || passedThreshold ? "Correct" : "Try again" }) : null
   ] });
 }
 var DragTheWordsInnerForwarded = forwardRef5(DragTheWordsInner);
 var DragTheWords = forwardRef5(function DragTheWords2(props, ref) {
-  return /* @__PURE__ */ jsx9(AssessmentLessonGuard, { blockLabel: "DragTheWords", checkId: props.checkId, children: (lessonId) => /* @__PURE__ */ jsx9(DragTheWordsInnerForwarded, { ...props, enclosingLessonId: lessonId, ref }) });
+  return /* @__PURE__ */ jsx11(AssessmentLessonGuard, { blockLabel: "DragTheWords", checkId: props.checkId, children: (lessonId) => /* @__PURE__ */ jsx11(DragTheWordsInnerForwarded, { ...props, enclosingLessonId: lessonId, ref }) });
 });
 
 // src/blocks/DragAndDrop.tsx
-import { forwardRef as forwardRef6, useEffect as useEffect9, useMemo as useMemo11, useRef as useRef9, useState as useState9 } from "react";
-import { jsx as jsx10, jsxs as jsxs8 } from "react/jsx-runtime";
+import { forwardRef as forwardRef6, useEffect as useEffect9, useMemo as useMemo11, useRef as useRef10, useState as useState9 } from "react";
+import { jsx as jsx12, jsxs as jsxs8 } from "react/jsx-runtime";
 var INTERACTION5 = "dragAndDrop";
 function DragAndDropInner(props, ref) {
   const checkId = useMemo11(() => normalizeComponentId(props.checkId, "checkId"), [props.checkId]);
@@ -2278,10 +2487,12 @@ function DragAndDropInner(props, ref) {
   const [pool, setPool] = useState9(() => props.items.map((i) => i.id));
   const [keyboardItem, setKeyboardItem] = useState9(null);
   const [passed, setPassed] = useState9(false);
-  const completedRef = useRef9(false);
+  const [checked, setChecked] = useState9(false);
+  const completedRef = useRef10(false);
   const reset = () => {
     completedRef.current = false;
     setPassed(false);
+    setChecked(false);
     setAssignments(Object.fromEntries(props.targets.map((t) => [t.id, ""])));
     setPool(props.items.map((i) => i.id));
     setKeyboardItem(null);
@@ -2289,19 +2500,20 @@ function DragAndDropInner(props, ref) {
   useEffect9(() => {
     reset();
   }, [checkId, props.items.map((i) => i.id).join(","), props.targets.map((t) => t.id).join(",")]);
-  const allFilled = props.targets.every((t) => (assignments[t.id] ?? "").length > 0);
-  const allCorrect = props.targets.every((t) => assignments[t.id] === t.accepts);
+  const hasTargets = props.targets.length > 0;
+  const allFilled = hasTargets && props.targets.every((t) => (assignments[t.id] ?? "").length > 0);
+  let score = 0;
+  props.targets.forEach((t) => {
+    if (assignments[t.id] === t.accepts) score += 1;
+  });
+  const maxScore = props.targets.length || 1;
+  const passedThreshold = meetsPassingThreshold(score, maxScore, props.passingScore);
   const handle = useMemo11(() => {
-    const maxScore = props.targets.length || 1;
-    let score = 0;
-    props.targets.forEach((t) => {
-      if (assignments[t.id] === t.accepts) score += 1;
-    });
     return buildAssessmentHandle({
       checkId,
       getScore: () => score,
       getMaxScore: () => maxScore,
-      getAnswerGiven: () => allFilled,
+      getAnswerGiven: () => hasTargets && allFilled,
       resetTask: reset,
       showSolutions: () => {
       },
@@ -2309,11 +2521,11 @@ function DragAndDropInner(props, ref) {
         checkId,
         interactionType: INTERACTION5,
         response: assignments,
-        correct: allCorrect,
+        correct: passedThreshold,
         score,
         maxScore
       }),
-      getCurrentState: () => ({ assignments, pool, passed, keyboardItem }),
+      getCurrentState: () => ({ assignments, pool, passed, checked, keyboardItem }),
       resume: (state) => {
         const rawAssignments = state.assignments;
         if (rawAssignments && typeof rawAssignments === "object") {
@@ -2324,14 +2536,16 @@ function DragAndDropInner(props, ref) {
           setPassed(value);
           completedRef.current = value;
         });
+        readBooleanStateField(state, "checked", setChecked);
         const item = state.keyboardItem;
         if (item === null || typeof item === "string") setKeyboardItem(item ?? null);
       }
     });
-  }, [allCorrect, allFilled, assignments, checkId, keyboardItem, passed, pool, props.targets]);
+  }, [allFilled, assignments, checkId, checked, hasTargets, keyboardItem, maxScore, passed, passedThreshold, pool, props.targets, score]);
   useAssessmentHandleRegistration(checkId, handle, ref);
   const place = (targetId, itemId) => {
     if (passed && !props.enableRetry) return;
+    setChecked(false);
     const prev = assignments[targetId];
     setAssignments((a) => ({ ...a, [targetId]: itemId }));
     setPool((p) => {
@@ -2343,29 +2557,31 @@ function DragAndDropInner(props, ref) {
   };
   const check = () => {
     if (!allFilled) return;
+    setChecked(true);
     assessment.answer({
       checkId,
       interactionType: INTERACTION5,
       response: assignments,
-      correct: allCorrect
+      correct: passedThreshold
     });
-    if (allCorrect && !completedRef.current) {
+    if (passedThreshold && !completedRef.current) {
       completedRef.current = true;
       setPassed(true);
       assessment.complete({
         checkId,
         interactionType: INTERACTION5,
-        score: props.targets.length,
-        maxScore: props.targets.length,
-        passingScore: props.passingScore ?? props.targets.length
+        score,
+        maxScore,
+        passingScore: props.passingScore ?? maxScore
       });
     }
   };
   return /* @__PURE__ */ jsxs8("section", { "aria-label": "Drag and Drop", "data-lk-check-id": checkId, children: [
-    /* @__PURE__ */ jsx10("p", { children: "Match each item to the correct target (drag or use keyboard: select item, then activate target)." }),
-    /* @__PURE__ */ jsx10("div", { role: "list", "aria-label": "Draggable items", children: pool.map((id) => {
+    /* @__PURE__ */ jsx12("p", { children: "Match each item to the correct target (drag or use keyboard: select item, then activate target)." }),
+    /* @__PURE__ */ jsx12("div", { role: "list", "aria-label": "Draggable items", children: pool.flatMap((id) => {
       const item = props.items.find((i) => i.id === id);
-      return /* @__PURE__ */ jsx10(
+      if (!item) return [];
+      return /* @__PURE__ */ jsx12(
         "button",
         {
           type: "button",
@@ -2380,13 +2596,13 @@ function DragAndDropInner(props, ref) {
         id
       );
     }) }),
-    /* @__PURE__ */ jsx10("ul", { children: props.targets.map((target) => {
+    /* @__PURE__ */ jsx12("ul", { children: props.targets.map((target) => {
       const assigned = assignments[target.id];
       const label = assigned ? props.items.find((i) => i.id === assigned)?.label ?? assigned : "Drop here";
       return /* @__PURE__ */ jsxs8("li", { children: [
-        /* @__PURE__ */ jsx10("strong", { children: target.label }),
+        /* @__PURE__ */ jsx12("strong", { children: target.label }),
         " ",
-        /* @__PURE__ */ jsx10(
+        /* @__PURE__ */ jsx12(
           "span",
           {
             role: "button",
@@ -2413,17 +2629,18 @@ function DragAndDropInner(props, ref) {
         )
       ] }, target.id);
     }) }),
-    /* @__PURE__ */ jsx10("button", { type: "button", "data-testid": "check-drag-drop", disabled: !allFilled || passed, onClick: check, children: "Check" }),
-    allFilled ? /* @__PURE__ */ jsx10("p", { role: "status", "aria-live": "polite", children: passed || allCorrect ? "Correct" : "Try again" }) : null
+    /* @__PURE__ */ jsx12("button", { type: "button", "data-testid": "check-drag-drop", disabled: !hasTargets || !allFilled || passed, onClick: check, children: "Check" }),
+    checked ? /* @__PURE__ */ jsx12("p", { role: "status", "aria-live": "polite", children: passedThreshold ? "Correct" : "Try again" }) : null
   ] });
 }
 var DragAndDropInnerForwarded = forwardRef6(DragAndDropInner);
 var DragAndDrop = forwardRef6(function DragAndDrop2(props, ref) {
-  return /* @__PURE__ */ jsx10(AssessmentLessonGuard, { blockLabel: "DragAndDrop", checkId: props.checkId, children: (lessonId) => /* @__PURE__ */ jsx10(DragAndDropInnerForwarded, { ...props, enclosingLessonId: lessonId, ref }) });
+  return /* @__PURE__ */ jsx12(AssessmentLessonGuard, { blockLabel: "DragAndDrop", checkId: props.checkId, children: (lessonId) => /* @__PURE__ */ jsx12(DragAndDropInnerForwarded, { ...props, enclosingLessonId: lessonId, ref }) });
 });
 
 // src/blocks/AssessmentSequence.tsx
-import React14, { forwardRef as forwardRef7, useCallback as useCallback7, useEffect as useEffect12, useMemo as useMemo13, useState as useState10 } from "react";
+import React16, { forwardRef as forwardRef7, useCallback as useCallback7, useEffect as useEffect12, useId as useId3, useMemo as useMemo13, useRef as useRef13, useState as useState10 } from "react";
+import { deriveId } from "@lessonkit/core";
 
 // src/compound/useCompoundShell.ts
 import { useMemo as useMemo12 } from "react";
@@ -2450,7 +2667,7 @@ function useCompoundNavigation(pageCount, index, setIndex) {
 }
 
 // src/compound/useCompoundPersistence.ts
-import { useCallback as useCallback6, useEffect as useEffect11, useRef as useRef11 } from "react";
+import { useCallback as useCallback6, useContext as useContext7, useEffect as useEffect11, useRef as useRef12 } from "react";
 import {
   clampCompoundPageIndex as clampCompoundPageIndex2,
   createCompoundResumeState as createCompoundResumeState2,
@@ -2458,14 +2675,80 @@ import {
   loadCompoundState as loadCompoundState2
 } from "@lessonkit/core";
 
+// src/compound/resumeChildHandles.ts
+function filterRegisteredChildStates(handles, childStates) {
+  const filtered = {};
+  for (const [key, value] of Object.entries(childStates)) {
+    if (handles.has(key)) {
+      filtered[key] = value;
+    }
+  }
+  return filtered;
+}
+function resumeChildHandles(handles, childStates, opts) {
+  const pendingKeys = Object.keys(childStates);
+  const alreadyResumed = opts?.alreadyResumed;
+  if (opts?.waitForHandles && pendingKeys.length > 0) {
+    if (handles.size === 0) return false;
+    const registeredPending = pendingKeys.filter((k) => handles.has(k));
+    if (registeredPending.length === 0) {
+      return false;
+    }
+    if (registeredPending.length < pendingKeys.length) {
+      for (const key of registeredPending) {
+        if (alreadyResumed?.has(key)) continue;
+        const handle = handles.get(key);
+        const child = childStates[key];
+        if (handle?.resume && child) {
+          handle.resume(child);
+          alreadyResumed?.add(key);
+        }
+      }
+      return false;
+    }
+  }
+  for (const [checkId, handle] of handles) {
+    if (alreadyResumed?.has(checkId)) continue;
+    const child = childStates[checkId];
+    if (child && handle.resume) {
+      handle.resume(child);
+      alreadyResumed?.add(checkId);
+    }
+  }
+  return true;
+}
+
 // src/compound/useCompoundResume.ts
-import { useCallback as useCallback5, useEffect as useEffect10, useRef as useRef10 } from "react";
+import { useCallback as useCallback5, useContext as useContext6, useEffect as useEffect10, useRef as useRef11 } from "react";
 import { loadCompoundState, saveCompoundState } from "@lessonkit/core";
 import { createSessionStoragePort as createSessionStoragePort2 } from "@lessonkit/core";
+var warnedCompoundPersistFailure = false;
+function warnCompoundPersistFailure() {
+  if (warnedCompoundPersistFailure || !isDevEnvironment4()) return;
+  warnedCompoundPersistFailure = true;
+  console.warn(
+    "[lessonkit] compound resume state could not be saved to sessionStorage (quota or privacy mode); progress may be lost on reload."
+  );
+}
 function useCompoundResume(opts) {
-  const storageRef = useRef10(opts.storage ?? createSessionStoragePort2());
-  const resumedRef = useRef10(false);
+  const lessonkitCtx = useContext6(LessonkitContext);
+  const storageRef = useRef11(opts.storage ?? lessonkitCtx?.storage ?? createSessionStoragePort2());
+  const resumedRef = useRef11(false);
+  const resumeKeyRef = useRef11("");
+  const prevEnabledRef = useRef11(opts.enabled);
+  useEffect10(() => {
+    storageRef.current = opts.storage ?? lessonkitCtx?.storage ?? createSessionStoragePort2();
+  }, [opts.storage, lessonkitCtx?.storage]);
   useEffect10(() => {
+    if (!prevEnabledRef.current && opts.enabled) {
+      resumedRef.current = false;
+    }
+    prevEnabledRef.current = opts.enabled;
+    const key = `${opts.courseId ?? ""}:${opts.compoundId}`;
+    if (resumeKeyRef.current !== key) {
+      resumeKeyRef.current = key;
+      resumedRef.current = false;
+    }
     if (!opts.enabled || !opts.courseId || resumedRef.current) return;
     const saved = loadCompoundState(storageRef.current, opts.courseId, opts.compoundId);
     if (saved) {
@@ -2476,7 +2759,8 @@ function useCompoundResume(opts) {
   return useCallback5(
     (state) => {
       if (!opts.enabled || !opts.courseId) return;
-      saveCompoundState(storageRef.current, opts.courseId, opts.compoundId, state);
+      const persisted = saveCompoundState(storageRef.current, opts.courseId, opts.compoundId, state);
+      if (!persisted) warnCompoundPersistFailure();
     },
     [opts.enabled, opts.courseId, opts.compoundId]
   );
@@ -2489,19 +2773,46 @@ function readCompoundInitialIndex(courseId, compoundId, pageCount, enabled, stor
   if (!saved) return 0;
   return clampCompoundPageIndex2(saved.activePageIndex, pageCount);
 }
+function stripOrphanChildStates(handles, childStates) {
+  return filterRegisteredChildStates(handles, childStates);
+}
 function useCompoundPersistence(opts) {
-  const storage = opts.storage ?? createSessionStoragePort3();
+  const lessonkitCtx = useContext7(LessonkitContext);
+  const storage = opts.storage ?? lessonkitCtx?.storage ?? createSessionStoragePort3();
   const ctx = useCompoundRegistry();
   const handlesVersion = useCompoundHandlesVersion();
-  const pendingChildResumeRef = useRef11(null);
-  const loadedChildStatesRef = useRef11({});
-  const skipSaveUntilHydratedRef = useRef11(false);
+  const bridgeRef = useCompoundHydrationBridgeRef();
+  const pendingChildResumeRef = useRef12(null);
+  const resumedChildKeysRef = useRef12(/* @__PURE__ */ new Set());
+  const loadedChildStatesRef = useRef12({});
+  const skipSaveUntilHydratedRef = useRef12(false);
+  const hydrationKeyRef = useRef12("");
+  const hydrationInitRef = useRef12(false);
+  const hydrationKey = `${opts.courseId ?? ""}:${opts.compoundId}`;
+  if (hydrationKeyRef.current !== hydrationKey) {
+    hydrationKeyRef.current = hydrationKey;
+    hydrationInitRef.current = false;
+    loadedChildStatesRef.current = {};
+    skipSaveUntilHydratedRef.current = false;
+    pendingChildResumeRef.current = null;
+    resumedChildKeysRef.current = /* @__PURE__ */ new Set();
+  }
+  if (!hydrationInitRef.current && opts.enabled && opts.courseId) {
+    hydrationInitRef.current = true;
+    const saved = loadCompoundState2(storage, opts.courseId, opts.compoundId);
+    if (saved && Object.keys(saved.childStates).length > 0) {
+      loadedChildStatesRef.current = { ...saved.childStates };
+      skipSaveUntilHydratedRef.current = true;
+      pendingChildResumeRef.current = saved;
+    }
+  }
   const buildState = useCallback6(() => {
     const childStates = {
       ...loadedChildStatesRef.current
     };
     if (ctx) {
-      for (const [checkId, handle] of ctx.getHandles()) {
+      for (const [checkId, entry] of ctx.getRegisteredHandles()) {
+        const handle = entry.handle;
         if (handle.getCurrentState) {
           childStates[checkId] = handle.getCurrentState();
           delete loadedChildStatesRef.current[checkId];
@@ -2513,14 +2824,44 @@ function useCompoundPersistence(opts) {
       childStates
     });
   }, [ctx, opts.index, opts.pageCount]);
+  const buildStateRef = useRef12(buildState);
+  buildStateRef.current = buildState;
+  const finalizeHydration = useCallback6(
+    (childStates) => {
+      loadedChildStatesRef.current = {
+        ...loadedChildStatesRef.current,
+        ...childStates
+      };
+      skipSaveUntilHydratedRef.current = false;
+      pendingChildResumeRef.current = null;
+    },
+    []
+  );
   const applyPendingChildResume = useCallback6(() => {
     const pending = pendingChildResumeRef.current;
     if (!pending || !ctx) return;
-    const applied = resumeChildHandles(ctx.getHandles(), pending.childStates, { waitForHandles: true });
-    if (!applied) return;
-    pendingChildResumeRef.current = null;
-    skipSaveUntilHydratedRef.current = false;
-  }, [ctx]);
+    const handles = ctx.getHandles();
+    const applied = resumeChildHandles(handles, pending.childStates, {
+      waitForHandles: true,
+      alreadyResumed: resumedChildKeysRef.current
+    });
+    if (!applied) {
+      const handlesAtWait = handles.size;
+      queueMicrotask(() => {
+        if (pendingChildResumeRef.current !== pending) return;
+        const handlesNow = ctx.getHandles();
+        if (handlesNow.size !== handlesAtWait) return;
+        const registeredOnly2 = stripOrphanChildStates(handlesNow, pending.childStates);
+        resumeChildHandles(handlesNow, registeredOnly2, {
+          alreadyResumed: resumedChildKeysRef.current
+        });
+        finalizeHydration(registeredOnly2);
+      });
+      return;
+    }
+    const registeredOnly = stripOrphanChildStates(handles, pending.childStates);
+    finalizeHydration(registeredOnly);
+  }, [ctx, finalizeHydration]);
   const saveResume = useCompoundResume({
     courseId: opts.courseId,
     compoundId: opts.compoundId,
@@ -2531,26 +2872,54 @@ function useCompoundPersistence(opts) {
       loadedChildStatesRef.current = { ...state.childStates };
       skipSaveUntilHydratedRef.current = Object.keys(state.childStates).length > 0;
       opts.setIndex(clamped);
-      pendingChildResumeRef.current = { ...state, activePageIndex: clamped };
+      resumedChildKeysRef.current = /* @__PURE__ */ new Set();
+      pendingChildResumeRef.current = { ...state, activePageIndex: clamped, childStates: state.childStates };
       queueMicrotask(() => applyPendingChildResume());
     }
   });
-  useEffect11(() => {
+  const persistNow = useCallback6(() => {
     if (!opts.enabled || !opts.courseId) return;
-    if (skipSaveUntilHydratedRef.current) return;
-    saveResume(buildState());
-  }, [
-    opts.enabled,
-    opts.courseId,
-    opts.index,
-    opts.pageCount,
-    handlesVersion,
-    saveResume,
-    buildState
-  ]);
+    saveResume(buildStateRef.current());
+  }, [opts.enabled, opts.courseId, saveResume]);
+  const notifyImperativeResume = useCallback6(
+    (state) => {
+      const clamped = clampCompoundPageIndex2(state.activePageIndex, opts.pageCount);
+      loadedChildStatesRef.current = { ...state.childStates };
+      skipSaveUntilHydratedRef.current = Object.keys(state.childStates).length > 0;
+      opts.setIndex(clamped);
+      resumedChildKeysRef.current = /* @__PURE__ */ new Set();
+      pendingChildResumeRef.current = { ...state, activePageIndex: clamped, childStates: state.childStates };
+      queueMicrotask(() => applyPendingChildResume());
+    },
+    [opts.pageCount, opts.setIndex, applyPendingChildResume]
+  );
+  useEffect11(() => {
+    if (!bridgeRef) return;
+    bridgeRef.current = { notifyImperativeResume };
+    return () => {
+      if (bridgeRef.current?.notifyImperativeResume === notifyImperativeResume) {
+        bridgeRef.current = null;
+      }
+    };
+  }, [bridgeRef, notifyImperativeResume]);
+  useEffect11(() => {
+    persistNow();
+  }, [persistNow, opts.index, opts.pageCount, handlesVersion]);
   useEffect11(() => {
     applyPendingChildResume();
   }, [opts.index, handlesVersion, applyPendingChildResume]);
+  useEffect11(() => {
+    if (!opts.enabled || !opts.courseId || typeof document === "undefined") return;
+    const flushOnExit = () => {
+      if (document.visibilityState === "hidden") persistNow();
+    };
+    document.addEventListener("visibilitychange", flushOnExit);
+    window.addEventListener("pagehide", flushOnExit);
+    return () => {
+      document.removeEventListener("visibilitychange", flushOnExit);
+      window.removeEventListener("pagehide", flushOnExit);
+    };
+  }, [opts.enabled, opts.courseId, persistNow]);
 }
 
 // src/compound/useCompoundShell.ts
@@ -2571,6 +2940,7 @@ function useCompoundShell(opts) {
     activePageIndex: visibleIndex,
     setActivePageIndex: opts.setIndex,
     getHandles: () => ctx?.getHandles() ?? /* @__PURE__ */ new Map(),
+    getRegisteredHandles: () => ctx?.getRegisteredHandles() ?? /* @__PURE__ */ new Map(),
     pageCount: opts.pageCount,
     enableSolutionsButton: opts.enableSolutionsButton
   });
@@ -2590,7 +2960,7 @@ function useCompoundInitialIndex(opts) {
 }
 
 // src/compound/validateChildren.ts
-import React13 from "react";
+import React15 from "react";
 import {
   ACCORDION_FORBIDDEN_CHILD_TYPES,
   COMPOUND_MAX_NESTING_DEPTH,
@@ -2619,6 +2989,8 @@ var warnedPairs = /* @__PURE__ */ new Set();
 var COMPOUND_CONTAINER_TYPES = /* @__PURE__ */ new Set([
   "Page",
   "InteractiveBook",
+  "Slide",
+  "SlideDeck",
   "AssessmentSequence"
 ]);
 function warnOrThrow(msg, strict) {
@@ -2629,8 +3001,8 @@ function warnOrThrow(msg, strict) {
   }
 }
 function validateNode(parent, node, depth, strict) {
-  React13.Children.forEach(node, (child) => {
-    if (!React13.isValidElement(child)) return;
+  React15.Children.forEach(node, (child) => {
+    if (!React15.isValidElement(child)) return;
     const blockType = getLessonkitBlockType(child.type);
     if (!blockType) {
       if (child.props && typeof child.props === "object" && "children" in child.props) {
@@ -2670,8 +3042,8 @@ function validateNode(parent, node, depth, strict) {
   });
 }
 function validateSubtreeForForbidden(node, forbidden, strict) {
-  React13.Children.forEach(node, (child) => {
-    if (!React13.isValidElement(child)) return;
+  React15.Children.forEach(node, (child) => {
+    if (!React15.isValidElement(child)) return;
     const blockType = getLessonkitBlockType(child.type);
     if (blockType && forbidden.includes(blockType)) {
       warnOrThrow(`[lessonkit] Block "${blockType}" must not nest inside Accordion`, strict);
@@ -2711,7 +3083,7 @@ function warnSharedCompoundStorageKey(opts) {
 }
 
 // src/blocks/AssessmentSequence.tsx
-import { jsx as jsx11, jsxs as jsxs9 } from "react/jsx-runtime";
+import { jsx as jsx13, jsxs as jsxs9 } from "react/jsx-runtime";
 var AssessmentSequenceInner = forwardRef7(
   function AssessmentSequenceInner2(props, ref) {
     const { compoundId, childArray, index, setIndex, persistEnabled } = props;
@@ -2729,7 +3101,7 @@ var AssessmentSequenceInner = forwardRef7(
     });
     validateCompoundChildren("AssessmentSequence", props.children);
     if (!sequential) {
-      return /* @__PURE__ */ jsx11("section", { "aria-label": "Assessment sequence", "data-testid": "assessment-sequence", children: props.children });
+      return /* @__PURE__ */ jsx13("section", { "aria-label": "Assessment sequence", "data-testid": "assessment-sequence", children: props.children });
     }
     return /* @__PURE__ */ jsxs9("section", { "aria-label": "Assessment sequence", "data-testid": "assessment-sequence", children: [
       /* @__PURE__ */ jsxs9("p", { children: [
@@ -2738,9 +3110,9 @@ var AssessmentSequenceInner = forwardRef7(
         " of ",
         progress.total
       ] }),
-      /* @__PURE__ */ jsx11("div", { "data-testid": "assessment-sequence-step", children: childArray.map((child, i) => /* @__PURE__ */ jsx11("div", { hidden: i !== visibleIndex, children: child }, child.key ?? i)) }),
+      /* @__PURE__ */ jsx13("div", { "data-testid": "assessment-sequence-step", children: childArray.map((child, i) => /* @__PURE__ */ jsx13("div", { hidden: i !== visibleIndex, children: /* @__PURE__ */ jsx13(CompoundPageIndexProvider, { pageIndex: i, children: child }) }, child.key ?? i)) }),
       /* @__PURE__ */ jsxs9("nav", { "aria-label": "Sequence navigation", children: [
-        /* @__PURE__ */ jsx11(
+        /* @__PURE__ */ jsx13(
           "button",
           {
             type: "button",
@@ -2750,7 +3122,7 @@ var AssessmentSequenceInner = forwardRef7(
             children: "Previous"
           }
         ),
-        /* @__PURE__ */ jsx11(
+        /* @__PURE__ */ jsx13(
           "button",
           {
             type: "button",
@@ -2766,14 +3138,19 @@ var AssessmentSequenceInner = forwardRef7(
 );
 var AssessmentSequence = forwardRef7(
   function AssessmentSequence2(props, ref) {
+    const reactInstanceId = useId3();
+    const autoCompoundIdRef = useRef13(null);
+    if (!props.blockId && !autoCompoundIdRef.current) {
+      autoCompoundIdRef.current = deriveId(`assessment-sequence-${reactInstanceId}`);
+    }
     const compoundId = useMemo13(
-      () => props.blockId ? normalizeComponentId(props.blockId, "blockId") : DEFAULT_ASSESSMENT_SEQUENCE_COMPOUND_ID,
+      () => props.blockId ? normalizeComponentId(props.blockId, "blockId") : autoCompoundIdRef.current ?? DEFAULT_ASSESSMENT_SEQUENCE_COMPOUND_ID,
       [props.blockId]
     );
-    const childArray = React14.Children.toArray(props.children).filter(
-      React14.isValidElement
+    const childArray = React16.Children.toArray(props.children).filter(
+      React16.isValidElement
     );
-    const { config } = useLessonkit();
+    const { config, storage } = useLessonkit();
     const persistEnabled = config.session?.persistCompoundState !== false;
     useEffect12(() => {
       warnSharedCompoundStorageKey({
@@ -2786,11 +3163,15 @@ var AssessmentSequence = forwardRef7(
       courseId: config.courseId,
       compoundId,
       pageCount: childArray.length,
-      persistEnabled
+      persistEnabled,
+      storage
     });
     const [index, setIndex] = useState10(initialIndex);
     const setIndexStable = useCallback7((i) => setIndex(i), []);
-    return /* @__PURE__ */ jsx11(CompoundProvider, { activePageIndex: index, onActivePageIndexChange: setIndexStable, children: /* @__PURE__ */ jsx11(
+    useEffect12(() => {
+      setIndex(initialIndex);
+    }, [config.courseId, compoundId, initialIndex]);
+    return /* @__PURE__ */ jsx13(CompoundProvider, { activePageIndex: index, onActivePageIndexChange: setIndexStable, children: /* @__PURE__ */ jsx13(
       AssessmentSequenceInner,
       {
         ...props,
@@ -2808,24 +3189,24 @@ setLessonkitBlockType(AssessmentSequence, "AssessmentSequence");
 
 // src/blocks/Text.tsx
 import "react";
-import { jsx as jsx12 } from "react/jsx-runtime";
+import { jsx as jsx14 } from "react/jsx-runtime";
 function Text(props) {
-  return /* @__PURE__ */ jsx12("p", { "data-lk-block-id": props.blockId, "data-testid": props.blockId ? `text-${props.blockId}` : "text", children: props.children });
+  return /* @__PURE__ */ jsx14("p", { "data-lk-block-id": props.blockId, "data-testid": props.blockId ? `text-${props.blockId}` : "text", children: props.children });
 }
 setLessonkitBlockType(Text, "Text");
 
 // src/blocks/Heading.tsx
-import { jsx as jsx13 } from "react/jsx-runtime";
+import { jsx as jsx15 } from "react/jsx-runtime";
 function Heading(props) {
   const Tag = `h${props.level}`;
-  return /* @__PURE__ */ jsx13(Tag, { "data-lk-block-id": props.blockId, "data-testid": props.blockId ? `heading-${props.blockId}` : "heading", children: props.children });
+  return /* @__PURE__ */ jsx15(Tag, { "data-lk-block-id": props.blockId, "data-testid": props.blockId ? `heading-${props.blockId}` : "heading", children: props.children });
 }
 setLessonkitBlockType(Heading, "Heading");
 
 // src/blocks/Image.tsx
-import { jsx as jsx14 } from "react/jsx-runtime";
+import { jsx as jsx16 } from "react/jsx-runtime";
 function Image(props) {
-  return /* @__PURE__ */ jsx14(
+  return /* @__PURE__ */ jsx16(
     "img",
     {
       src: props.src,
@@ -2840,13 +3221,13 @@ setLessonkitBlockType(Image, "Image");
 
 // src/blocks/Page.tsx
 import { useEffect as useEffect13 } from "react";
-import { jsx as jsx15, jsxs as jsxs10 } from "react/jsx-runtime";
+import { jsx as jsx17, jsxs as jsxs10 } from "react/jsx-runtime";
 function Page(props) {
   validateCompoundChildren("Page", props.children);
   const { track } = useLessonkit();
   const lessonId = useEnclosingLessonId();
   useEffect13(() => {
-    if (props.hidden || !lessonId) return;
+    if (props.hidden || !lessonId || props.parentType) return;
     track(
       "compound_page_viewed",
       {
@@ -2865,8 +3246,8 @@ function Page(props) {
       "data-testid": `page-${props.blockId}`,
       hidden: props.hidden ? true : void 0,
       children: [
-        props.title ? /* @__PURE__ */ jsx15("h3", { children: props.title }) : null,
-        /* @__PURE__ */ jsx15("div", { children: props.children })
+        props.title ? /* @__PURE__ */ jsx17("h3", { children: props.title }) : null,
+        /* @__PURE__ */ jsx17(CompoundPageIndexProvider, { pageIndex: props.pageIndex ?? 0, children: /* @__PURE__ */ jsx17("div", { children: props.children }) })
       ]
     }
   );
@@ -2874,8 +3255,8 @@ function Page(props) {
 setLessonkitBlockType(Page, "Page");
 
 // src/blocks/InteractiveBook.tsx
-import React17, { forwardRef as forwardRef8, useCallback as useCallback8, useEffect as useEffect14, useMemo as useMemo14, useState as useState11 } from "react";
-import { jsx as jsx16, jsxs as jsxs11 } from "react/jsx-runtime";
+import React19, { forwardRef as forwardRef8, useCallback as useCallback8, useEffect as useEffect14, useMemo as useMemo14, useState as useState11 } from "react";
+import { jsx as jsx18, jsxs as jsxs11 } from "react/jsx-runtime";
 var InteractiveBookInner = forwardRef8(
   function InteractiveBookInner2(props, ref) {
     const { blockId, pages, index, setIndex, persistEnabled } = props;
@@ -2908,7 +3289,7 @@ var InteractiveBookInner = forwardRef8(
       );
     }, [visibleIndex, blockId, lessonId, pages.length, pageTitles, track]);
     return /* @__PURE__ */ jsxs11("section", { "aria-label": props.title, "data-testid": "interactive-book", "data-lk-block-id": blockId, children: [
-      /* @__PURE__ */ jsx16("h3", { children: props.title }),
+      /* @__PURE__ */ jsx18("h3", { children: props.title }),
       /* @__PURE__ */ jsxs11("p", { children: [
         "Page ",
         progress.current,
@@ -2922,8 +3303,8 @@ var InteractiveBookInner = forwardRef8(
         " ",
         Array.from(ctx.getHandles().values()).reduce((s, h) => s + h.getMaxScore(), 0)
       ] }) : null,
-      /* @__PURE__ */ jsx16("div", { "data-testid": "interactive-book-page", children: pages.map(
-        (page, i) => React17.cloneElement(page, {
+      /* @__PURE__ */ jsx18("div", { "data-testid": "interactive-book-page", children: pages.map(
+        (page, i) => React19.cloneElement(page, {
           key: page.key ?? page.props.blockId,
           hidden: i !== visibleIndex,
           pageIndex: i,
@@ -2931,7 +3312,7 @@ var InteractiveBookInner = forwardRef8(
         })
       ) }),
       /* @__PURE__ */ jsxs11("nav", { "aria-label": "Book navigation", children: [
-        /* @__PURE__ */ jsx16(
+        /* @__PURE__ */ jsx18(
           "button",
           {
             type: "button",
@@ -2941,7 +3322,7 @@ var InteractiveBookInner = forwardRef8(
             children: "Previous"
           }
         ),
-        /* @__PURE__ */ jsx16(
+        /* @__PURE__ */ jsx18(
           "button",
           {
             type: "button",
@@ -2960,20 +3341,24 @@ var InteractiveBook = forwardRef8(function InteractiveBook2(props, ref) {
     () => normalizeComponentId(props.blockId, "blockId"),
     [props.blockId]
   );
-  const pages = React17.Children.toArray(props.children).filter(
-    React17.isValidElement
+  const pages = React19.Children.toArray(props.children).filter(
+    React19.isValidElement
   );
-  const { config } = useLessonkit();
+  const { config, storage } = useLessonkit();
   const persistEnabled = config.session?.persistCompoundState !== false;
   const initialIndex = useCompoundInitialIndex({
     courseId: config.courseId,
     compoundId: blockId,
     pageCount: pages.length,
-    persistEnabled
+    persistEnabled,
+    storage
   });
   const [index, setIndex] = useState11(initialIndex);
   const setIndexStable = useCallback8((i) => setIndex(i), []);
-  return /* @__PURE__ */ jsx16(CompoundProvider, { activePageIndex: index, onActivePageIndexChange: setIndexStable, children: /* @__PURE__ */ jsx16(
+  useEffect14(() => {
+    setIndex(initialIndex);
+  }, [config.courseId, blockId, initialIndex]);
+  return /* @__PURE__ */ jsx18(CompoundProvider, { activePageIndex: index, onActivePageIndexChange: setIndexStable, children: /* @__PURE__ */ jsx18(
     InteractiveBookInner,
     {
       ...props,
@@ -2988,17 +3373,249 @@ var InteractiveBook = forwardRef8(function InteractiveBook2(props, ref) {
 });
 setLessonkitBlockType(InteractiveBook, "InteractiveBook");
 
+// src/blocks/Slide.tsx
+import { useEffect as useEffect15 } from "react";
+import { jsx as jsx19, jsxs as jsxs12 } from "react/jsx-runtime";
+function Slide(props) {
+  validateCompoundChildren("Slide", props.children);
+  const { track } = useLessonkit();
+  const lessonId = useEnclosingLessonId();
+  useEffect15(() => {
+    if (props.hidden || !lessonId || props.parentType) return;
+    track(
+      "compound_page_viewed",
+      {
+        blockId: props.blockId,
+        pageIndex: props.slideIndex ?? 0,
+        parentType: props.parentType
+      },
+      { lessonId }
+    );
+  }, [props.hidden, props.slideIndex, props.parentType, props.blockId, lessonId, track]);
+  return /* @__PURE__ */ jsxs12(
+    "section",
+    {
+      "aria-label": props.title ?? "Slide",
+      "data-lk-block-id": props.blockId,
+      "data-testid": `slide-${props.blockId}`,
+      hidden: props.hidden ? true : void 0,
+      children: [
+        props.title ? /* @__PURE__ */ jsx19("h3", { children: props.title }) : null,
+        /* @__PURE__ */ jsx19(CompoundPageIndexProvider, { pageIndex: props.slideIndex ?? 0, children: /* @__PURE__ */ jsx19("div", { children: props.children }) })
+      ]
+    }
+  );
+}
+setLessonkitBlockType(Slide, "Slide");
+
+// src/blocks/SlideDeck.tsx
+import React21, { forwardRef as forwardRef9, useCallback as useCallback9, useEffect as useEffect17, useMemo as useMemo15, useRef as useRef14, useState as useState12 } from "react";
+
+// src/compound/useCompoundKeyboardNav.ts
+import { useEffect as useEffect16 } from "react";
+var INTERACTIVE_TAGS = /* @__PURE__ */ new Set(["INPUT", "TEXTAREA", "SELECT", "BUTTON"]);
+function isEditableTarget(target) {
+  if (!(target instanceof HTMLElement)) return false;
+  if (INTERACTIVE_TAGS.has(target.tagName)) return true;
+  if (target.isContentEditable) return true;
+  if (target.closest("[role='slider'], [role='listbox'], [data-lk-assessment-interactive]")) {
+    return true;
+  }
+  return false;
+}
+function useCompoundKeyboardNav(opts) {
+  const { containerRef, visibleIndex, pageCount, goNext, goPrev, setIndex } = opts;
+  useEffect16(() => {
+    const el = containerRef.current;
+    if (!el || pageCount === 0) return;
+    const onKeyDown = (event) => {
+      if (!el.contains(document.activeElement) && document.activeElement !== document.body) {
+        return;
+      }
+      if (isEditableTarget(event.target)) return;
+      switch (event.key) {
+        case "ArrowRight":
+        case "ArrowDown":
+          if (visibleIndex < pageCount - 1) {
+            event.preventDefault();
+            goNext();
+          }
+          break;
+        case "ArrowLeft":
+        case "ArrowUp":
+          if (visibleIndex > 0) {
+            event.preventDefault();
+            goPrev();
+          }
+          break;
+        case "Home":
+          if (visibleIndex !== 0) {
+            event.preventDefault();
+            setIndex(0);
+          }
+          break;
+        case "End":
+          if (visibleIndex !== pageCount - 1) {
+            event.preventDefault();
+            setIndex(pageCount - 1);
+          }
+          break;
+        default:
+          break;
+      }
+    };
+    el.addEventListener("keydown", onKeyDown);
+    return () => el.removeEventListener("keydown", onKeyDown);
+  }, [containerRef, visibleIndex, pageCount, goNext, goPrev, setIndex]);
+}
+
+// src/blocks/SlideDeck.tsx
+import { jsx as jsx20, jsxs as jsxs13 } from "react/jsx-runtime";
+var SlideDeckInner = forwardRef9(function SlideDeckInner2(props, ref) {
+  const { blockId, slides, index, setIndex, persistEnabled } = props;
+  validateCompoundChildren("SlideDeck", slides);
+  const { config, track } = useLessonkit();
+  const lessonId = useEnclosingLessonId();
+  const containerRef = useRef14(null);
+  const { visibleIndex, goNext, goPrev, progress, ctx } = useCompoundShell({
+    courseId: config.courseId,
+    compoundId: blockId,
+    pageCount: slides.length,
+    index,
+    setIndex,
+    persistEnabled,
+    ref
+  });
+  const setIndexStable = useCallback9((i) => setIndex(i), [setIndex]);
+  useCompoundKeyboardNav({
+    containerRef,
+    visibleIndex,
+    pageCount: slides.length,
+    goNext,
+    goPrev,
+    setIndex: setIndexStable
+  });
+  const slideTitles = useMemo15(
+    () => slides.map((slide) => slide.props.title),
+    [slides]
+  );
+  useEffect17(() => {
+    if (!lessonId || slides.length === 0) return;
+    track(
+      "slide_viewed",
+      {
+        blockId,
+        slideIndex: visibleIndex,
+        slideTitle: slideTitles[visibleIndex]
+      },
+      { lessonId }
+    );
+  }, [visibleIndex, blockId, lessonId, slides.length, slideTitles, track]);
+  return /* @__PURE__ */ jsxs13(
+    "section",
+    {
+      ref: containerRef,
+      tabIndex: -1,
+      "aria-label": props.title,
+      "data-testid": "slide-deck",
+      "data-lk-block-id": blockId,
+      children: [
+        /* @__PURE__ */ jsx20("h3", { children: props.title }),
+        /* @__PURE__ */ jsxs13("p", { children: [
+          "Slide ",
+          progress.current,
+          " of ",
+          progress.total
+        ] }),
+        props.showDeckScore && ctx ? /* @__PURE__ */ jsxs13("p", { "data-testid": "deck-score", children: [
+          "Score: ",
+          Array.from(ctx.getHandles().values()).reduce((s, h) => s + h.getScore(), 0),
+          " /",
+          " ",
+          Array.from(ctx.getHandles().values()).reduce((s, h) => s + h.getMaxScore(), 0)
+        ] }) : null,
+        /* @__PURE__ */ jsx20("div", { "data-testid": "slide-deck-slide", children: slides.map(
+          (slide, i) => React21.cloneElement(slide, {
+            key: slide.key ?? slide.props.blockId,
+            hidden: i !== visibleIndex,
+            slideIndex: i,
+            parentType: "SlideDeck"
+          })
+        ) }),
+        /* @__PURE__ */ jsxs13("nav", { "aria-label": "Slide navigation", children: [
+          /* @__PURE__ */ jsx20(
+            "button",
+            {
+              type: "button",
+              "data-testid": "slide-prev",
+              disabled: visibleIndex === 0 || slides.length === 0,
+              onClick: goPrev,
+              children: "Previous slide"
+            }
+          ),
+          /* @__PURE__ */ jsx20(
+            "button",
+            {
+              type: "button",
+              "data-testid": "slide-next",
+              disabled: visibleIndex >= slides.length - 1 || slides.length === 0,
+              onClick: goNext,
+              children: "Next slide"
+            }
+          )
+        ] })
+      ]
+    }
+  );
+});
+var SlideDeck = forwardRef9(function SlideDeck2(props, ref) {
+  const blockId = useMemo15(
+    () => normalizeComponentId(props.blockId, "blockId"),
+    [props.blockId]
+  );
+  const slides = React21.Children.toArray(props.children).filter(
+    React21.isValidElement
+  );
+  const { config, storage } = useLessonkit();
+  const persistEnabled = config.session?.persistCompoundState !== false;
+  const initialIndex = useCompoundInitialIndex({
+    courseId: config.courseId,
+    compoundId: blockId,
+    pageCount: slides.length,
+    persistEnabled,
+    storage
+  });
+  const [index, setIndex] = useState12(initialIndex);
+  const setIndexStable = useCallback9((i) => setIndex(i), []);
+  useEffect17(() => {
+    setIndex(initialIndex);
+  }, [config.courseId, blockId, initialIndex]);
+  return /* @__PURE__ */ jsx20(CompoundProvider, { activePageIndex: index, onActivePageIndexChange: setIndexStable, children: /* @__PURE__ */ jsx20(
+    SlideDeckInner,
+    {
+      ...props,
+      ref,
+      blockId,
+      slides,
+      index,
+      setIndex,
+      persistEnabled
+    }
+  ) });
+});
+setLessonkitBlockType(SlideDeck, "SlideDeck");
+
 // src/blocks/Accordion.tsx
-import { useId as useId3, useState as useState12 } from "react";
-import { jsx as jsx17, jsxs as jsxs12 } from "react/jsx-runtime";
+import { useId as useId4, useState as useState13 } from "react";
+import { jsx as jsx21, jsxs as jsxs14 } from "react/jsx-runtime";
 function Accordion(props) {
   if (isDevEnvironment4()) {
     validateAccordionSections(props.sections);
   }
-  const [open, setOpen] = useState12(/* @__PURE__ */ new Set());
+  const [open, setOpen] = useState13(/* @__PURE__ */ new Set());
   const { track } = useLessonkit();
   const lessonId = useEnclosingLessonId();
-  const baseId = useId3();
+  const baseId = useId4();
   const toggle = (sectionId) => {
     setOpen((prev) => {
       const next = new Set(prev);
@@ -3013,12 +3630,12 @@ function Accordion(props) {
       return next;
     });
   };
-  return /* @__PURE__ */ jsx17("section", { "aria-label": "Accordion", "data-lk-block-id": props.blockId, "data-testid": "accordion", children: props.sections.map((section) => {
+  return /* @__PURE__ */ jsx21("section", { "aria-label": "Accordion", "data-lk-block-id": props.blockId, "data-testid": "accordion", children: props.sections.map((section) => {
     const expanded = open.has(section.id);
     const panelId = `${baseId}-${section.id}`;
     const triggerId = `${baseId}-trigger-${section.id}`;
-    return /* @__PURE__ */ jsxs12("div", { "data-testid": `accordion-section-${section.id}`, children: [
-      /* @__PURE__ */ jsx17("h4", { children: /* @__PURE__ */ jsx17(
+    return /* @__PURE__ */ jsxs14("div", { "data-testid": `accordion-section-${section.id}`, children: [
+      /* @__PURE__ */ jsx21("h4", { children: /* @__PURE__ */ jsx21(
         "button",
         {
           id: triggerId,
@@ -3030,28 +3647,28 @@ function Accordion(props) {
           children: section.title
         }
       ) }),
-      expanded ? /* @__PURE__ */ jsx17("div", { id: panelId, role: "region", "aria-labelledby": triggerId, children: section.content }) : null
+      expanded ? /* @__PURE__ */ jsx21("div", { id: panelId, role: "region", "aria-labelledby": triggerId, children: section.content }) : null
     ] }, section.id);
   }) });
 }
 setLessonkitBlockType(Accordion, "Accordion");
 
 // src/blocks/DialogCards.tsx
-import { useState as useState13 } from "react";
-import { jsx as jsx18, jsxs as jsxs13 } from "react/jsx-runtime";
+import { useState as useState14 } from "react";
+import { jsx as jsx22, jsxs as jsxs15 } from "react/jsx-runtime";
 function DialogCards(props) {
-  const [index, setIndex] = useState13(0);
-  const [flipped, setFlipped] = useState13(false);
+  const [index, setIndex] = useState14(0);
+  const [flipped, setFlipped] = useState14(false);
   const card = props.cards[index];
   if (!card) return null;
-  return /* @__PURE__ */ jsxs13("section", { "aria-label": "Dialog cards", "data-lk-block-id": props.blockId, "data-testid": "dialog-cards", children: [
-    /* @__PURE__ */ jsxs13("p", { children: [
+  return /* @__PURE__ */ jsxs15("section", { "aria-label": "Dialog cards", "data-lk-block-id": props.blockId, "data-testid": "dialog-cards", children: [
+    /* @__PURE__ */ jsxs15("p", { children: [
       "Card ",
       index + 1,
       " of ",
       props.cards.length
     ] }),
-    /* @__PURE__ */ jsx18(
+    /* @__PURE__ */ jsx22(
       "button",
       {
         type: "button",
@@ -3062,8 +3679,8 @@ function DialogCards(props) {
         children: flipped ? card.back : card.front
       }
     ),
-    /* @__PURE__ */ jsxs13("nav", { "aria-label": "Card navigation", children: [
-      /* @__PURE__ */ jsx18(
+    /* @__PURE__ */ jsxs15("nav", { "aria-label": "Card navigation", children: [
+      /* @__PURE__ */ jsx22(
         "button",
         {
           type: "button",
@@ -3076,7 +3693,7 @@ function DialogCards(props) {
           children: "Previous"
         }
       ),
-      /* @__PURE__ */ jsx18(
+      /* @__PURE__ */ jsx22(
         "button",
         {
           type: "button",
@@ -3095,11 +3712,11 @@ function DialogCards(props) {
 setLessonkitBlockType(DialogCards, "DialogCards");
 
 // src/blocks/Flashcards.tsx
-import { useState as useState14 } from "react";
-import { jsx as jsx19, jsxs as jsxs14 } from "react/jsx-runtime";
+import { useState as useState15 } from "react";
+import { jsx as jsx23, jsxs as jsxs16 } from "react/jsx-runtime";
 function Flashcards(props) {
-  const [index, setIndex] = useState14(0);
-  const [face, setFace] = useState14("front");
+  const [index, setIndex] = useState15(0);
+  const [face, setFace] = useState15("front");
   const { track } = useLessonkit();
   const lessonId = useEnclosingLessonId();
   const card = props.cards[index];
@@ -3113,10 +3730,10 @@ function Flashcards(props) {
       lessonId ? { lessonId } : void 0
     );
   };
-  return /* @__PURE__ */ jsxs14("section", { "aria-label": "Flashcards", "data-lk-block-id": props.blockId, "data-testid": "flashcards", children: [
-    /* @__PURE__ */ jsx19("button", { type: "button", "data-testid": "flashcard-flip", onClick: flip, style: { minHeight: "6rem", width: "100%" }, children: face === "front" ? card.front : card.back }),
-    props.selfScore ? /* @__PURE__ */ jsx19("p", { "data-testid": "flashcard-self-score", children: "Self-score mode enabled" }) : null,
-    /* @__PURE__ */ jsx19(
+  return /* @__PURE__ */ jsxs16("section", { "aria-label": "Flashcards", "data-lk-block-id": props.blockId, "data-testid": "flashcards", children: [
+    /* @__PURE__ */ jsx23("button", { type: "button", "data-testid": "flashcard-flip", onClick: flip, style: { minHeight: "6rem", width: "100%" }, children: face === "front" ? card.front : card.back }),
+    props.selfScore ? /* @__PURE__ */ jsx23("p", { "data-testid": "flashcard-self-score", children: "Self-score mode enabled" }) : null,
+    /* @__PURE__ */ jsx23(
       "button",
       {
         type: "button",
@@ -3134,10 +3751,10 @@ function Flashcards(props) {
 setLessonkitBlockType(Flashcards, "Flashcards");
 
 // src/blocks/ImageHotspots.tsx
-import { useState as useState15 } from "react";
-import { jsx as jsx20, jsxs as jsxs15 } from "react/jsx-runtime";
+import { useState as useState16 } from "react";
+import { jsx as jsx24, jsxs as jsxs17 } from "react/jsx-runtime";
 function ImageHotspots(props) {
-  const [active, setActive] = useState15(null);
+  const [active, setActive] = useState16(null);
   const { track } = useLessonkit();
   const lessonId = useEnclosingLessonId();
   const open = (hotspotId) => {
@@ -3148,10 +3765,10 @@ function ImageHotspots(props) {
       lessonId ? { lessonId } : void 0
     );
   };
-  return /* @__PURE__ */ jsxs15("section", { "aria-label": "Image hotspots", "data-lk-block-id": props.blockId, "data-testid": "image-hotspots", children: [
-    /* @__PURE__ */ jsxs15("div", { style: { position: "relative", display: "inline-block" }, children: [
-      /* @__PURE__ */ jsx20("img", { src: props.src, alt: props.alt, style: { maxWidth: "100%" } }),
-      props.hotspots.map((h) => /* @__PURE__ */ jsx20(
+  return /* @__PURE__ */ jsxs17("section", { "aria-label": "Image hotspots", "data-lk-block-id": props.blockId, "data-testid": "image-hotspots", children: [
+    /* @__PURE__ */ jsxs17("div", { style: { position: "relative", display: "inline-block" }, children: [
+      /* @__PURE__ */ jsx24("img", { src: props.src, alt: props.alt, style: { maxWidth: "100%" } }),
+      props.hotspots.map((h) => /* @__PURE__ */ jsx24(
         "button",
         {
           type: "button",
@@ -3170,19 +3787,19 @@ function ImageHotspots(props) {
         h.id
       ))
     ] }),
-    active ? /* @__PURE__ */ jsxs15("div", { role: "dialog", "aria-label": "Hotspot details", "data-testid": "hotspot-popover", children: [
+    active ? /* @__PURE__ */ jsxs17("div", { role: "dialog", "aria-label": "Hotspot details", "data-testid": "hotspot-popover", children: [
       props.hotspots.find((h) => h.id === active)?.content,
-      /* @__PURE__ */ jsx20("button", { type: "button", onClick: () => setActive(null), children: "Close" })
+      /* @__PURE__ */ jsx24("button", { type: "button", onClick: () => setActive(null), children: "Close" })
     ] }) : null
   ] });
 }
 setLessonkitBlockType(ImageHotspots, "ImageHotspots");
 
 // src/blocks/ImageSlider.tsx
-import { useState as useState16 } from "react";
-import { jsx as jsx21, jsxs as jsxs16 } from "react/jsx-runtime";
+import { useState as useState17 } from "react";
+import { jsx as jsx25, jsxs as jsxs18 } from "react/jsx-runtime";
 function ImageSlider(props) {
-  const [index, setIndex] = useState16(0);
+  const [index, setIndex] = useState17(0);
   const { track } = useLessonkit();
   const lessonId = useEnclosingLessonId();
   const slide = props.slides[index];
@@ -3195,11 +3812,11 @@ function ImageSlider(props) {
       lessonId ? { lessonId } : void 0
     );
   };
-  return /* @__PURE__ */ jsxs16("section", { "aria-label": "Image slider", "data-lk-block-id": props.blockId, "data-testid": "image-slider", children: [
-    /* @__PURE__ */ jsx21("img", { src: slide.src, alt: slide.alt, style: { maxWidth: "100%" } }),
-    slide.caption ? /* @__PURE__ */ jsx21("p", { children: slide.caption }) : null,
-    /* @__PURE__ */ jsxs16("nav", { "aria-label": "Slide navigation", children: [
-      /* @__PURE__ */ jsx21(
+  return /* @__PURE__ */ jsxs18("section", { "aria-label": "Image slider", "data-lk-block-id": props.blockId, "data-testid": "image-slider", children: [
+    /* @__PURE__ */ jsx25("img", { src: slide.src, alt: slide.alt, style: { maxWidth: "100%" } }),
+    slide.caption ? /* @__PURE__ */ jsx25("p", { children: slide.caption }) : null,
+    /* @__PURE__ */ jsxs18("nav", { "aria-label": "Slide navigation", children: [
+      /* @__PURE__ */ jsx25(
         "button",
         {
           type: "button",
@@ -3209,12 +3826,12 @@ function ImageSlider(props) {
           children: "Previous"
         }
       ),
-      /* @__PURE__ */ jsxs16("span", { children: [
+      /* @__PURE__ */ jsxs18("span", { children: [
         index + 1,
         " / ",
         props.slides.length
       ] }),
-      /* @__PURE__ */ jsx21(
+      /* @__PURE__ */ jsx25(
         "button",
         {
           type: "button",
@@ -3230,16 +3847,21 @@ function ImageSlider(props) {
 setLessonkitBlockType(ImageSlider, "ImageSlider");
 
 // src/blocks/FindHotspot.tsx
-import { forwardRef as forwardRef9, useMemo as useMemo15, useState as useState17 } from "react";
-import { jsx as jsx22, jsxs as jsxs17 } from "react/jsx-runtime";
+import { forwardRef as forwardRef10, useEffect as useEffect18, useMemo as useMemo16, useState as useState18 } from "react";
+import { jsx as jsx26, jsxs as jsxs19 } from "react/jsx-runtime";
 var INTERACTION6 = "findHotspot";
 function FindHotspotInner(props, ref) {
-  const checkId = useMemo15(() => normalizeComponentId(props.checkId, "checkId"), [props.checkId]);
-  const [selected, setSelected] = useState17(null);
-  const [checked, setChecked] = useState17(false);
+  const checkId = useMemo16(() => normalizeComponentId(props.checkId, "checkId"), [props.checkId]);
+  const [selected, setSelected] = useState18(null);
+  const [checked, setChecked] = useState18(false);
   const assessment = useAssessmentState(props.enclosingLessonId);
+  const targetIdsKey = props.targets.map((t) => t.id).join("\0");
+  useEffect18(() => {
+    setSelected(null);
+    setChecked(false);
+  }, [checkId, props.correctTargetId, targetIdsKey]);
   const correct = selected === props.correctTargetId;
-  const handle = useMemo15(
+  const handle = useMemo16(
     () => buildAssessmentHandle({
       checkId,
       getScore: () => checked && correct ? 1 : 0,
@@ -3261,15 +3883,22 @@ function FindHotspotInner(props, ref) {
       getCurrentState: () => ({ selected, checked }),
       resume: (state) => {
         const nextSelected = readStringField(state, "selected");
-        if (typeof nextSelected === "string") setSelected(nextSelected);
+        if (typeof nextSelected === "string" || nextSelected === null) {
+          const valid = nextSelected === null || props.targets.some((t) => t.id === nextSelected);
+          setSelected(valid ? nextSelected : null);
+        }
         readBooleanStateField(state, "checked", setChecked);
       }
     }),
-    [checkId, selected, checked, correct, props.correctTargetId]
+    [checkId, selected, checked, correct, props.correctTargetId, props.targets]
   );
   useAssessmentHandleRegistration(checkId, handle, ref);
+  const selectTarget = (id) => {
+    setSelected(id);
+    setChecked(false);
+  };
   const submit = () => {
-    if (!selected) return;
+    if (!selected || checked) return;
     setChecked(true);
     assessment.answer({
       checkId,
@@ -3283,14 +3912,14 @@ function FindHotspotInner(props, ref) {
         interactionType: INTERACTION6,
         score: 1,
         maxScore: 1,
-        passingScore: props.passingScore
+        passingScore: props.passingScore ?? 1
       });
     }
   };
-  return /* @__PURE__ */ jsxs17("section", { "aria-label": "Find the hotspot", "data-lk-check-id": checkId, "data-testid": "find-hotspot", children: [
-    /* @__PURE__ */ jsxs17("div", { style: { position: "relative", display: "inline-block" }, children: [
-      /* @__PURE__ */ jsx22("img", { src: props.src, alt: props.alt, style: { maxWidth: "100%" } }),
-      props.targets.map((t) => /* @__PURE__ */ jsx22(
+  return /* @__PURE__ */ jsxs19("section", { "aria-label": "Find the hotspot", "data-lk-check-id": checkId, "data-testid": "find-hotspot", children: [
+    /* @__PURE__ */ jsxs19("div", { style: { position: "relative", display: "inline-block" }, children: [
+      /* @__PURE__ */ jsx26("img", { src: props.src, alt: props.alt, style: { maxWidth: "100%" } }),
+      props.targets.map((t) => /* @__PURE__ */ jsx26(
         "button",
         {
           type: "button",
@@ -3303,30 +3932,30 @@ function FindHotspotInner(props, ref) {
             top: `${t.y}%`,
             transform: "translate(-50%, -50%)"
           },
-          onClick: () => setSelected(t.id),
+          onClick: () => selectTarget(t.id),
           children: t.label
         },
         t.id
       ))
     ] }),
-    /* @__PURE__ */ jsx22("button", { type: "button", "data-testid": "check-hotspot", disabled: !selected, onClick: submit, children: "Check" }),
-    checked ? /* @__PURE__ */ jsx22("p", { role: "status", children: correct ? "Correct" : "Try again" }) : null
+    /* @__PURE__ */ jsx26("button", { type: "button", "data-testid": "check-hotspot", disabled: !selected, onClick: submit, children: "Check" }),
+    checked ? /* @__PURE__ */ jsx26("p", { role: "status", children: correct ? "Correct" : "Try again" }) : null
   ] });
 }
-var FindHotspotInnerForwarded = forwardRef9(FindHotspotInner);
-var FindHotspot = forwardRef9(function FindHotspot2(props, ref) {
-  return /* @__PURE__ */ jsx22(AssessmentLessonGuard, { blockLabel: "FindHotspot", checkId: props.checkId, children: (enclosingLessonId) => /* @__PURE__ */ jsx22(FindHotspotInnerForwarded, { ...props, enclosingLessonId, ref }) });
+var FindHotspotInnerForwarded = forwardRef10(FindHotspotInner);
+var FindHotspot = forwardRef10(function FindHotspot2(props, ref) {
+  return /* @__PURE__ */ jsx26(AssessmentLessonGuard, { blockLabel: "FindHotspot", checkId: props.checkId, children: (enclosingLessonId) => /* @__PURE__ */ jsx26(FindHotspotInnerForwarded, { ...props, enclosingLessonId, ref }) });
 });
 setLessonkitBlockType(FindHotspot, "FindHotspot");
 
 // src/blocks/FindMultipleHotspots.tsx
-import { forwardRef as forwardRef10, useMemo as useMemo16, useState as useState18 } from "react";
-import { jsx as jsx23, jsxs as jsxs18 } from "react/jsx-runtime";
+import { forwardRef as forwardRef11, useMemo as useMemo17, useState as useState19 } from "react";
+import { jsx as jsx27, jsxs as jsxs20 } from "react/jsx-runtime";
 var INTERACTION7 = "findMultipleHotspots";
 function FindMultipleHotspotsInner(props, ref) {
-  const checkId = useMemo16(() => normalizeComponentId(props.checkId, "checkId"), [props.checkId]);
-  const [selected, setSelected] = useState18(/* @__PURE__ */ new Set());
-  const [checked, setChecked] = useState18(false);
+  const checkId = useMemo17(() => normalizeComponentId(props.checkId, "checkId"), [props.checkId]);
+  const [selected, setSelected] = useState19(/* @__PURE__ */ new Set());
+  const [checked, setChecked] = useState19(false);
   const assessment = useAssessmentState(props.enclosingLessonId);
   const toggle = (id) => {
     setSelected((prev) => {
@@ -3335,9 +3964,10 @@ function FindMultipleHotspotsInner(props, ref) {
       else next.add(id);
       return next;
     });
+    setChecked(false);
   };
   const correct = selected.size === props.correctTargetIds.length && props.correctTargetIds.every((id) => selected.has(id));
-  const handle = useMemo16(
+  const handle = useMemo17(
     () => buildAssessmentHandle({
       checkId,
       getScore: () => checked && correct ? 1 : 0,
@@ -3367,7 +3997,7 @@ function FindMultipleHotspotsInner(props, ref) {
   );
   useAssessmentHandleRegistration(checkId, handle, ref);
   const submit = () => {
-    if (selected.size === 0) return;
+    if (selected.size === 0 || checked) return;
     setChecked(true);
     assessment.answer({
       checkId,
@@ -3381,14 +4011,14 @@ function FindMultipleHotspotsInner(props, ref) {
         interactionType: INTERACTION7,
         score: 1,
         maxScore: 1,
-        passingScore: props.passingScore
+        passingScore: props.passingScore ?? 1
       });
     }
   };
-  return /* @__PURE__ */ jsxs18("section", { "aria-label": "Find multiple hotspots", "data-lk-check-id": checkId, "data-testid": "find-multiple-hotspots", children: [
-    /* @__PURE__ */ jsxs18("div", { style: { position: "relative", display: "inline-block" }, children: [
-      /* @__PURE__ */ jsx23("img", { src: props.src, alt: props.alt, style: { maxWidth: "100%" } }),
-      props.targets.map((t) => /* @__PURE__ */ jsx23(
+  return /* @__PURE__ */ jsxs20("section", { "aria-label": "Find multiple hotspots", "data-lk-check-id": checkId, "data-testid": "find-multiple-hotspots", children: [
+    /* @__PURE__ */ jsxs20("div", { style: { position: "relative", display: "inline-block" }, children: [
+      /* @__PURE__ */ jsx27("img", { src: props.src, alt: props.alt, style: { maxWidth: "100%" } }),
+      props.targets.map((t) => /* @__PURE__ */ jsx27(
         "button",
         {
           type: "button",
@@ -3407,14 +4037,14 @@ function FindMultipleHotspotsInner(props, ref) {
         t.id
       ))
     ] }),
-    /* @__PURE__ */ jsx23("button", { type: "button", "data-testid": "check-hotspots", disabled: selected.size === 0, onClick: submit, children: "Check" }),
-    checked ? /* @__PURE__ */ jsx23("p", { role: "status", children: correct ? "Correct" : "Try again" }) : null
+    /* @__PURE__ */ jsx27("button", { type: "button", "data-testid": "check-hotspots", disabled: selected.size === 0, onClick: submit, children: "Check" }),
+    checked ? /* @__PURE__ */ jsx27("p", { role: "status", children: correct ? "Correct" : "Try again" }) : null
   ] });
 }
-var FindMultipleHotspotsInnerForwarded = forwardRef10(FindMultipleHotspotsInner);
-var FindMultipleHotspots = forwardRef10(
+var FindMultipleHotspotsInnerForwarded = forwardRef11(FindMultipleHotspotsInner);
+var FindMultipleHotspots = forwardRef11(
   function FindMultipleHotspots2(props, ref) {
-    return /* @__PURE__ */ jsx23(AssessmentLessonGuard, { blockLabel: "FindMultipleHotspots", checkId: props.checkId, children: (enclosingLessonId) => /* @__PURE__ */ jsx23(FindMultipleHotspotsInnerForwarded, { ...props, enclosingLessonId, ref }) });
+    return /* @__PURE__ */ jsx27(AssessmentLessonGuard, { blockLabel: "FindMultipleHotspots", checkId: props.checkId, children: (enclosingLessonId) => /* @__PURE__ */ jsx27(FindMultipleHotspotsInnerForwarded, { ...props, enclosingLessonId, ref }) });
   }
 );
 setLessonkitBlockType(FindMultipleHotspots, "FindMultipleHotspots");
@@ -3431,14 +4061,14 @@ import {
 } from "@lessonkit/core";
 
 // src/theme/ThemeProvider.tsx
-import React25, {
-  createContext as createContext4,
-  useCallback as useCallback9,
-  useContext as useContext4,
+import React29, {
+  createContext as createContext6,
+  useCallback as useCallback10,
+  useContext as useContext8,
   useLayoutEffect as useLayoutEffect2,
-  useMemo as useMemo17,
-  useRef as useRef12,
-  useState as useState19
+  useMemo as useMemo18,
+  useRef as useRef15,
+  useState as useState20
 } from "react";
 import {
   brandThemeOverrides,
@@ -3465,11 +4095,11 @@ function applyCssVariables(target, vars, previousKeys) {
 }
 
 // src/theme/ThemeProvider.tsx
-import { jsx as jsx24 } from "react/jsx-runtime";
-var ThemeContext = createContext4(null);
+import { jsx as jsx28 } from "react/jsx-runtime";
+var ThemeContext = createContext6(null);
 var useIsoLayoutEffect2 = (
   /* v8 ignore next -- SSR uses useEffect when window is unavailable */
-  typeof window !== "undefined" ? useLayoutEffect2 : React25.useEffect
+  typeof window !== "undefined" ? useLayoutEffect2 : React29.useEffect
 );
 function getSystemMode() {
   if (typeof window === "undefined" || typeof window.matchMedia !== "function") {
@@ -3488,7 +4118,7 @@ function ThemeProvider(props) {
   const preset = props.preset ?? "default";
   const mode = props.mode ?? "light";
   const targetKind = props.target ?? "document";
-  const [resolvedMode, setResolvedMode] = useState19(
+  const [resolvedMode, setResolvedMode] = useState20(
     () => mode === "system" ? getSystemMode() : mode
   );
   useIsoLayoutEffect2(() => {
@@ -3504,20 +4134,20 @@ function ThemeProvider(props) {
     return () => mq.removeEventListener("change", onChange);
   }, [mode]);
   const dataTheme = mode === "system" ? resolvedMode : mode === "dark" ? "dark" : "light";
-  const effectiveTheme = useMemo17(() => {
+  const effectiveTheme = useMemo18(() => {
     const modeBase = resolveModeBase(mode, dataTheme);
     const base = preset === "default" ? modeBase : preset === "brand" ? mergeThemes(modeBase, brandThemeOverrides) : mergeThemes(modeBase, getPresetTheme(preset));
     return mergeThemes(base, props.theme ?? {});
   }, [preset, mode, dataTheme, props.theme]);
-  const hostRef = useRef12(null);
-  const appliedKeysRef = useRef12(/* @__PURE__ */ new Set());
+  const hostRef = useRef15(null);
+  const appliedKeysRef = useRef15(/* @__PURE__ */ new Set());
   useIsoLayoutEffect2(() => {
     if (targetKind === "document" && typeof document !== "undefined") {
       document.documentElement.setAttribute("data-lk-theme", dataTheme);
       return () => document.documentElement.removeAttribute("data-lk-theme");
     }
   }, [targetKind, dataTheme]);
-  const inject = useCallback9(() => {
+  const inject = useCallback10(() => {
     const vars = themeToCssVariables(effectiveTheme);
     const el = targetKind === "document" && typeof document !== "undefined" ? document.documentElement : hostRef.current;
     if (!el) return;
@@ -3534,7 +4164,7 @@ function ThemeProvider(props) {
       appliedKeysRef.current = /* @__PURE__ */ new Set();
     };
   }, [inject, targetKind]);
-  const value = useMemo17(
+  const value = useMemo18(
     () => ({
       theme: effectiveTheme,
       preset,
@@ -3544,12 +4174,12 @@ function ThemeProvider(props) {
     [effectiveTheme, preset, mode, dataTheme]
   );
   if (targetKind === "document") {
-    return /* @__PURE__ */ jsx24(ThemeContext.Provider, { value, children: /* @__PURE__ */ jsx24("div", { "data-lk-theme": dataTheme, style: { display: "contents" }, children: props.children }) });
+    return /* @__PURE__ */ jsx28(ThemeContext.Provider, { value, children: /* @__PURE__ */ jsx28("div", { "data-lk-theme": dataTheme, style: { display: "contents" }, children: props.children }) });
   }
-  return /* @__PURE__ */ jsx24(ThemeContext.Provider, { value, children: /* @__PURE__ */ jsx24("div", { ref: hostRef, "data-lk-theme": dataTheme, children: props.children }) });
+  return /* @__PURE__ */ jsx28(ThemeContext.Provider, { value, children: /* @__PURE__ */ jsx28("div", { ref: hostRef, "data-lk-theme": dataTheme, children: props.children }) });
 }
 function useTheme() {
-  const ctx = useContext4(ThemeContext);
+  const ctx = useContext8(ThemeContext);
   if (!ctx) {
     throw new Error("useTheme must be used within a ThemeProvider");
   }
@@ -3561,9 +4191,18 @@ import {
   ASSESSMENT_SEQUENCE_ALLOWED_CHILD_TYPES,
   INTERACTIVE_BOOK_ALLOWED_CHILD_TYPES,
   PAGE_ALLOWED_CHILD_TYPES,
+  SLIDE_ALLOWED_CHILD_TYPES,
+  SLIDE_DECK_ALLOWED_CHILD_TYPES,
   COMPOUND_MAX_NESTING_DEPTH as COMPOUND_MAX_NESTING_DEPTH2
 } from "@lessonkit/core";
-var COMPOUND_PARENTS = ["Lesson", "Page", "InteractiveBook", "AssessmentSequence"];
+var COMPOUND_PARENTS = [
+  "Lesson",
+  "Page",
+  "InteractiveBook",
+  "Slide",
+  "SlideDeck",
+  "AssessmentSequence"
+];
 function extendParents(entry) {
   if (!entry.parentConstraints?.length) return entry;
   const merged = /* @__PURE__ */ new Set([...entry.parentConstraints, ...COMPOUND_PARENTS]);
@@ -3667,6 +4306,53 @@ var v3CompoundAndContentEntries = [
     theming: { surface: "global-inherit", stylingNotes: "Book chrome." },
     telemetry: { emits: ["book_page_viewed"], requiresActiveLesson: true }
   },
+  {
+    type: "Slide",
+    category: "container",
+    compoundContract: true,
+    h5pMachineName: "H5P.CoursePresentation",
+    h5pAlias: "Course Presentation slide",
+    description: "Single slide row in a SlideDeck. Planned allowlist expansion: Video, Summary.",
+    allowedChildTypes: [...SLIDE_ALLOWED_CHILD_TYPES],
+    maxNestingDepth: COMPOUND_MAX_NESTING_DEPTH2.Slide,
+    props: [
+      { name: "blockId", type: "BlockId", required: true, description: "Stable block id." },
+      { name: "title", type: "string", required: false, description: "Slide title." },
+      { name: "children", type: "ReactNode", required: true, description: "Slide content." }
+    ],
+    requiredIds: [],
+    optionalIds: ["blockId"],
+    parentConstraints: ["SlideDeck"],
+    a11y: { element: "section", ariaLabel: "Slide", keyboard: "N/A", notes: "H5P Course Presentation slide row." },
+    theming: { surface: "global-inherit", stylingNotes: "Container." },
+    telemetry: { emits: ["compound_page_viewed"], requiresActiveLesson: true }
+  },
+  {
+    type: "SlideDeck",
+    category: "container",
+    compoundContract: true,
+    h5pMachineName: "H5P.CoursePresentation",
+    h5pAlias: "Course Presentation",
+    description: "Multi-slide presentation with keyboard navigation.",
+    allowedChildTypes: [...SLIDE_DECK_ALLOWED_CHILD_TYPES],
+    maxNestingDepth: COMPOUND_MAX_NESTING_DEPTH2.SlideDeck,
+    props: [
+      { name: "blockId", type: "BlockId", required: true, description: "Stable block id." },
+      { name: "title", type: "string", required: true, description: "Deck title." },
+      { name: "showDeckScore", type: "boolean", required: false, description: "Show aggregate score." },
+      { name: "children", type: "Slide[]", required: true, description: "Slides." }
+    ],
+    requiredIds: ["blockId"],
+    parentConstraints: ["Lesson"],
+    a11y: {
+      element: "section",
+      ariaLabel: "Slide deck",
+      keyboard: "Arrow keys, Home, End, Previous/Next slide buttons.",
+      notes: "H5P Course Presentation equivalent."
+    },
+    theming: { surface: "global-inherit", stylingNotes: "Deck chrome." },
+    telemetry: { emits: ["slide_viewed"], requiresActiveLesson: true }
+  },
   {
     type: "Accordion",
     category: "content",
@@ -4212,6 +4898,8 @@ export {
   Quiz,
   Reflection,
   Scenario,
+  Slide,
+  SlideDeck,
   Text,
   ThemeProvider,
   TrueFalse,