@lessonkit/react 1.1.0 → 1.3.0

package/dist/index.cjs

@@ -30,33 +30,49 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.tsx
 var index_exports = {};
 __export(index_exports, {
+  Accordion: () => Accordion,
   AssessmentSequence: () => AssessmentSequence,
   BLOCK_CATALOG: () => BLOCK_CATALOG,
   BLOCK_CATALOG_V2: () => BLOCK_CATALOG_V2,
+  BLOCK_CATALOG_V3: () => BLOCK_CATALOG_V3,
   Course: () => Course,
+  DialogCards: () => DialogCards,
   DragAndDrop: () => DragAndDrop,
   DragTheWords: () => DragTheWords,
   FillInTheBlanks: () => FillInTheBlanks,
+  FindHotspot: () => FindHotspot,
+  FindMultipleHotspots: () => FindMultipleHotspots,
+  Flashcards: () => Flashcards,
+  Heading: () => Heading,
+  Image: () => Image,
+  ImageHotspots: () => ImageHotspots,
+  ImageSlider: () => ImageSlider,
+  InteractiveBook: () => InteractiveBook,
   KnowledgeCheck: () => KnowledgeCheck,
   Lesson: () => Lesson,
   LessonkitProvider: () => LessonkitProvider,
   MarkTheWords: () => MarkTheWords,
+  Page: () => Page,
   ProgressTracker: () => ProgressTracker,
   Quiz: () => Quiz,
   Reflection: () => Reflection,
   Scenario: () => Scenario,
+  Slide: () => Slide,
+  SlideDeck: () => SlideDeck,
+  Text: () => Text,
   ThemeProvider: () => ThemeProvider,
   TrueFalse: () => TrueFalse,
   blockCatalogV2Version: () => blockCatalogV2Version,
+  blockCatalogV3Version: () => blockCatalogV3Version,
   blockCatalogVersion: () => blockCatalogVersion,
   buildBlockCatalog: () => buildBlockCatalog,
-  buildTelemetryEvent: () => import_core10.buildTelemetryEvent,
-  createLessonkitRuntime: () => import_core10.createLessonkitRuntime,
-  createPluginRegistry: () => import_core10.createPluginRegistry,
-  createTelemetryPipeline: () => import_core10.createTelemetryPipeline,
-  defineAssessmentPlugin: () => import_core10.defineAssessmentPlugin,
-  defineLifecyclePlugin: () => import_core10.defineLifecyclePlugin,
-  defineTelemetryPlugin: () => import_core10.defineTelemetryPlugin,
+  buildTelemetryEvent: () => import_core19.buildTelemetryEvent,
+  createLessonkitRuntime: () => import_core19.createLessonkitRuntime,
+  createPluginRegistry: () => import_core19.createPluginRegistry,
+  createTelemetryPipeline: () => import_core19.createTelemetryPipeline,
+  defineAssessmentPlugin: () => import_core19.defineAssessmentPlugin,
+  defineLifecyclePlugin: () => import_core19.defineLifecyclePlugin,
+  defineTelemetryPlugin: () => import_core19.defineTelemetryPlugin,
   getBlockCatalogEntry: () => getBlockCatalogEntry,
   resetAssessmentWarningsForTests: () => resetAssessmentWarningsForTests,
   resetQuizWarningsForTests: () => resetQuizWarningsForTests,
@@ -71,31 +87,8 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/components.tsx
-var import_react6 = require("react");
-var import_accessibility = require("@lessonkit/accessibility");
-
-// src/assessment/scoring.ts
-function resolvePassingThreshold(passingScore, maxScore) {
-  return passingScore ?? maxScore;
-}
-function meetsPassingThreshold(score, maxScore, passingScore) {
-  const threshold = resolvePassingThreshold(passingScore, maxScore);
-  return score >= threshold;
-}
-function scoreFromCustom(custom, fallbackCorrect, fallbackMax = 1, passingScore) {
-  const maxScore = custom?.maxScore ?? fallbackMax;
-  if (custom?.passed !== void 0) {
-    const score2 = custom.passed ? custom.score ?? maxScore : custom.score ?? 0;
-    return { score: score2, maxScore, passed: custom.passed };
-  }
-  if (custom?.maxScore != null && custom.maxScore > 0 && custom.score != null) {
-    const passed2 = meetsPassingThreshold(custom.score, custom.maxScore, passingScore);
-    return { score: custom.score, maxScore: custom.maxScore, passed: passed2 };
-  }
-  const score = fallbackCorrect ? maxScore : 0;
-  const passed = meetsPassingThreshold(score, maxScore, passingScore);
-  return { score, maxScore, passed };
-}
+var import_react13 = require("react");
+var import_accessibility2 = require("@lessonkit/accessibility");
 
 // src/context.tsx
 var import_react2 = require("react");
@@ -103,7 +96,39 @@ var import_react2 = require("react");
 // src/provider/useLessonkitProviderRuntime.ts
 var import_react = require("react");
 var import_core8 = require("@lessonkit/core");
-var import_xapi4 = require("@lessonkit/xapi");
+
+// src/runtime/observability.ts
+var import_xapi = require("@lessonkit/xapi");
+function createXapiQueueFromObservability(observability) {
+  const opts = {};
+  if (observability?.onXapiQueueDepth) {
+    opts.onDepth = observability.onXapiQueueDepth;
+  }
+  if (observability?.onXapiQueueCap) {
+    opts.onCap = observability.onXapiQueueCap;
+  }
+  return (0, import_xapi.createInMemoryXAPIQueue)(opts);
+}
+function wrapTrackingSink(sink, observability) {
+  if (!sink || !observability?.onTelemetrySinkError) return sink;
+  const onError = observability.onTelemetrySinkError;
+  return ((event) => {
+    try {
+      const result = sink(event);
+      if (result != null && typeof result.catch === "function") {
+        return result.catch((err) => {
+          onError(err, { sinkId: "tracking" });
+        });
+      }
+      return result;
+    } catch (err) {
+      onError(err, { sinkId: "tracking" });
+      return void 0;
+    }
+  });
+}
+
+// src/provider/useLessonkitProviderRuntime.ts
 var import_xapi5 = require("@lessonkit/xapi");
 
 // src/runtime/emitTelemetry.ts
@@ -111,11 +136,20 @@ var import_core2 = require("@lessonkit/core");
 
 // src/runtime/telemetryPipeline.ts
 var import_core = require("@lessonkit/core");
-var import_xapi = require("@lessonkit/xapi");
+var import_xapi2 = require("@lessonkit/xapi");
 
 // src/runtime/lxpackBridge.ts
 var import_bridge = require("@lessonkit/lxpack/bridge");
-function forwardTelemetryToLxpack(event, mode = "auto") {
+var BRIDGE_MISS_EVENT_NAMES = /* @__PURE__ */ new Set([
+  "course_completed",
+  "lesson_completed",
+  "assessment_completed",
+  "quiz_completed"
+]);
+function forwardTelemetryToLxpack(event, mode = "auto", opts) {
+  if (mode === "auto" && opts?.onBridgeMiss && BRIDGE_MISS_EVENT_NAMES.has(event.name) && !(0, import_bridge.getLxpackBridge)()) {
+    opts.onBridgeMiss(event);
+  }
   (0, import_bridge.forwardTelemetryToBridge)(event, mode);
 }
 
@@ -131,7 +165,7 @@ function createLegacyPipeline(opts, extraSinks = []) {
       id: "xapi",
       emit(event) {
         try {
-          const statement = (0, import_xapi.telemetryEventToXAPIStatement)(event);
+          const statement = (0, import_xapi2.telemetryEventToXAPIStatement)(event);
           if (statement) opts.xapi?.send(statement);
         } catch (err) {
           if (isDevEnvironment()) {
@@ -146,7 +180,9 @@ function createLegacyPipeline(opts, extraSinks = []) {
     {
       id: "lxpack-bridge",
       emit(event) {
-        forwardTelemetryToLxpack(event, opts.lxpackBridge);
+        forwardTelemetryToLxpack(event, opts.lxpackBridge, {
+          onBridgeMiss: opts.onLxpackBridgeMiss
+        });
       }
     },
     ...extraSinks
@@ -173,7 +209,8 @@ function emitTelemetry(tracking, xapi, event, opts) {
   const legacy = {
     tracking,
     xapi,
-    lxpackBridge: opts?.lxpackBridge ?? "auto"
+    lxpackBridge: opts?.lxpackBridge ?? "auto",
+    onLxpackBridgeMiss: opts?.onLxpackBridgeMiss
   };
   emitThroughPipeline(event, legacy, opts?.extraSinks);
 }
@@ -181,18 +218,21 @@ function emitTelemetry(tracking, xapi, event, opts) {
 // src/runtime/ports.ts
 var import_core3 = require("@lessonkit/core");
 
+// src/provider/useLessonkitProviderRuntime.ts
+var import_core9 = require("@lessonkit/core");
+
 // src/runtime/progress.ts
 var import_core4 = require("@lessonkit/core");
 
 // src/runtime/xapi.ts
-var import_xapi2 = require("@lessonkit/xapi");
+var import_xapi3 = require("@lessonkit/xapi");
 function createXapiClientFromConfig(config, queue) {
   if (config.xapi?.enabled === false) return null;
   if (config.xapi?.client) return config.xapi.client;
   if (!config.courseId) return null;
   const hasTransport = typeof config.xapi?.transport === "function";
   if (!hasTransport && config.xapi?.enabled !== true) return null;
-  return (0, import_xapi2.createXAPIClient)({
+  return (0, import_xapi3.createXAPIClient)({
     courseId: config.courseId,
     transport: config.xapi?.transport,
     queue
@@ -203,7 +243,7 @@ function createXapiClientFromConfig(config, queue) {
 var import_core5 = require("@lessonkit/core");
 
 // src/runtime/courseStartedPipeline.ts
-var import_xapi3 = require("@lessonkit/xapi");
+var import_xapi4 = require("@lessonkit/xapi");
 function isDevEnvironment3() {
   const g = globalThis;
   return typeof g.process !== "undefined" && g.process.env?.NODE_ENV !== "production";
@@ -240,13 +280,15 @@ async function emitExtraSinks(sinks, event, emitCtx) {
 async function emitCourseStartedNonTrackingPipeline(opts) {
   let xapiStatementSent = false;
   if (!opts.skipXapi && opts.xapi) {
-    const statement = (0, import_xapi3.telemetryEventToXAPIStatement)(opts.event);
+    const statement = (0, import_xapi4.telemetryEventToXAPIStatement)(opts.event);
     if (statement) {
       opts.xapi.send(statement);
       xapiStatementSent = true;
     }
   }
-  forwardTelemetryToLxpack(opts.event, opts.lxpackBridge);
+  forwardTelemetryToLxpack(opts.event, opts.lxpackBridge, {
+    onBridgeMiss: opts.onLxpackBridgeMiss
+  });
   const emitCtx = {
     courseId: opts.event.courseId,
     sessionId: opts.event.sessionId,
@@ -263,50 +305,19 @@ function createReactPluginHost(plugins) {
   return (0, import_core6.createPluginRegistry)(plugins);
 }
 function buildPluginContext(opts) {
-  return {
-    courseId: opts.courseId,
-    sessionId: opts.sessionId,
-    attemptId: opts.attemptId,
-    user: opts.user
-  };
+  return (0, import_core6.buildPluginContext)(opts);
 }
 function emitTelemetryWithPlugins(opts) {
   const next = opts.pluginHost ? opts.pluginHost.runTelemetry(opts.event, opts.pluginCtx) : opts.event;
   if (next === null) return;
   emitTelemetry(opts.tracking, opts.xapi, next, {
     lxpackBridge: opts.lxpackBridge ?? "auto",
-    extraSinks: opts.extraSinks
-  });
-}
-
-// src/runtime/telemetry.ts
-var import_core7 = require("@lessonkit/core");
-function createTrackingClientFromConfig(config) {
-  if (config.tracking?.enabled === false) return (0, import_core7.createTrackingClient)();
-  if (config.tracking?.createClient) return config.tracking.createClient();
-  return (0, import_core7.createTrackingClient)({
-    sink: config.tracking?.sink,
-    batchSink: config.tracking?.batchSink,
-    batch: config.tracking?.batch
+    extraSinks: opts.extraSinks,
+    onLxpackBridgeMiss: opts.onLxpackBridgeMiss
   });
 }
-async function disposeTrackingClient(client) {
-  try {
-    await client?.flush?.();
-  } catch {
-  }
-  try {
-    await client?.dispose?.();
-  } catch {
-  }
-}
 
-// src/provider/useLessonkitProviderRuntime.ts
-var useIsoLayoutEffect = (
-  /* v8 ignore next -- SSR uses useEffect when window is unavailable */
-  typeof window !== "undefined" ? import_react.useLayoutEffect : import_react.useEffect
-);
-var defaultStorage = (0, import_core3.createSessionStoragePort)();
+// src/provider/courseStarted/emit.ts
 var courseStartedTrackingFlightKey = null;
 function isTrackingActive(tracking) {
   return tracking?.enabled !== false;
@@ -342,9 +353,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;
     (0, import_core5.markCourseStartedEmittedToTracking)(storage, sessionId, courseId);
+    const delivered = await tracking.flush?.();
+    if (delivered === false) return false;
+    if (shouldCommit && !shouldCommit()) return false;
     return true;
   } catch {
     return false;
@@ -361,6 +373,7 @@ async function emitCourseStartedPipelineOnly(opts) {
       event: opts.event,
       xapi: opts.xapi,
       lxpackBridge: opts.lxpackBridge,
+      onLxpackBridgeMiss: opts.onLxpackBridgeMiss,
       extraSinks: opts.extraSinks,
       skipXapi: opts.skipXapi
     });
@@ -413,6 +426,7 @@ async function emitCourseStartedToTrackingOnly(opts) {
       event,
       xapi: null,
       lxpackBridge: opts.lxpackBridge,
+      onLxpackBridgeMiss: opts.onLxpackBridgeMiss,
       extraSinks: opts.extraSinks,
       skipXapi: true
     });
@@ -466,6 +480,36 @@ function assertTrackingSinkConfig(tracking) {
     "[lessonkit] tracking.sink and tracking.batchSink cannot both be set; use batchSink alone for batched delivery"
   );
 }
+
+// src/runtime/telemetry.ts
+var import_core7 = require("@lessonkit/core");
+function createTrackingClientFromConfig(config, observability) {
+  if (config.tracking?.enabled === false) return (0, import_core7.createTrackingClient)();
+  if (config.tracking?.createClient) return config.tracking.createClient();
+  return (0, import_core7.createTrackingClient)({
+    sink: config.tracking?.sink,
+    batchSink: config.tracking?.batchSink,
+    batch: config.tracking?.batch,
+    onBufferDrop: observability?.onTelemetryBufferDrop
+  });
+}
+async function disposeTrackingClient(client) {
+  try {
+    await client?.flush?.();
+  } catch {
+  }
+  try {
+    await client?.dispose?.();
+  } catch {
+  }
+}
+
+// src/provider/useLessonkitProviderRuntime.ts
+var useIsoLayoutEffect = (
+  /* v8 ignore next -- SSR uses useEffect when window is unavailable */
+  typeof window !== "undefined" ? import_react.useLayoutEffect : import_react.useEffect
+);
+var defaultStorage = (0, import_core3.createSessionStoragePort)();
 function useLessonkitProviderRuntime(config) {
   const normalizedCourseId = (0, import_react.useMemo)(
     () => (0, import_core8.assertValidId)(config.courseId, "courseId"),
@@ -476,6 +520,14 @@ function useLessonkitProviderRuntime(config) {
     [config, normalizedCourseId]
   );
   const useV2Runtime = normalizedConfig.runtimeVersion !== "v1";
+  (0, import_react.useEffect)(() => {
+    if (useV2Runtime) return;
+    const g = globalThis;
+    if (typeof g.process !== "undefined" && g.process.env?.NODE_ENV === "production") return;
+    console.warn(
+      '[lessonkit] LessonkitProvider runtimeVersion "v1" is deprecated; omit or use "v2" (default). v1 will be removed in LessonKit 2.0.'
+    );
+  }, [useV2Runtime]);
   const extraSinksRef = (0, import_react.useRef)(normalizedConfig.sinks);
   extraSinksRef.current = normalizedConfig.sinks;
   const headlessRef = (0, import_react.useRef)(null);
@@ -494,7 +546,16 @@ function useLessonkitProviderRuntime(config) {
   courseIdRef.current = normalizedCourseId;
   const lxpackBridgeModeRef = (0, import_react.useRef)(normalizedConfig.lxpack?.bridge ?? "auto");
   lxpackBridgeModeRef.current = normalizedConfig.lxpack?.bridge ?? "auto";
-  const pluginHost = (0, import_react.useMemo)(() => createReactPluginHost(normalizedConfig.plugins), [normalizedConfig.plugins]);
+  const observabilityRef = (0, import_react.useRef)(normalizedConfig.observability);
+  observabilityRef.current = normalizedConfig.observability;
+  const onLxpackBridgeMiss = (0, import_react.useCallback)((event) => {
+    observabilityRef.current?.onLxpackBridgeMiss?.(event);
+  }, []);
+  const pluginsFingerprint = normalizedConfig.plugins?.map((p) => `${p.id}\0${p.version}`).join("|") ?? "";
+  const pluginHost = (0, import_react.useMemo)(
+    () => createReactPluginHost(normalizedConfig.plugins),
+    [pluginsFingerprint]
+  );
   const pluginHostRef = (0, import_react.useRef)(pluginHost);
   pluginHostRef.current = pluginHost;
   const progressRef = (0, import_react.useRef)((0, import_core4.createProgressController)());
@@ -510,7 +571,9 @@ function useLessonkitProviderRuntime(config) {
       headlessRef.current = (0, import_core8.createLessonkitRuntime)({
         courseId: normalizedCourseId,
         runtimeVersion: "v2",
-        session: normalizedConfig.session
+        session: normalizedConfig.session,
+        plugins: pluginHostRef.current ?? normalizedConfig.plugins,
+        deferPluginSetup: true
       });
       progressRef.current = headlessRef.current.progress;
     } else {
@@ -524,7 +587,9 @@ function useLessonkitProviderRuntime(config) {
     headlessRef.current = (0, import_core8.createLessonkitRuntime)({
       courseId: normalizedCourseId,
       runtimeVersion: "v2",
-      session: normalizedConfig.session
+      session: normalizedConfig.session,
+      plugins: pluginHostRef.current ?? normalizedConfig.plugins,
+      deferPluginSetup: true
     });
   }
   if (prevCourseIdForProgressRef.current !== normalizedCourseId) {
@@ -548,7 +613,7 @@ function useLessonkitProviderRuntime(config) {
   }, []);
   const activeLessonIdRef = (0, import_react.useRef)(progress.activeLessonId);
   activeLessonIdRef.current = progress.activeLessonId;
-  const xapiQueueRef = (0, import_react.useRef)((0, import_xapi4.createInMemoryXAPIQueue)());
+  const xapiQueueRef = (0, import_react.useRef)(createXapiQueueFromObservability(normalizedConfig.observability));
   const xapiRef = (0, import_react.useRef)(null);
   const [xapi, setXapi] = (0, import_react.useState)(null);
   const prevXapiCourseIdRef = (0, import_react.useRef)(normalizedCourseId);
@@ -569,7 +634,7 @@ function useLessonkitProviderRuntime(config) {
         }
         void xapiRef.current?.flush();
       }
-      xapiQueueRef.current = (0, import_xapi4.createInMemoryXAPIQueue)();
+      xapiQueueRef.current = createXapiQueueFromObservability(observabilityRef.current);
       prevXapiCourseIdRef.current = courseId;
       xapiCourseStartedSentOnClientRef.current = false;
     }
@@ -648,7 +713,7 @@ function useLessonkitProviderRuntime(config) {
   );
   useIsoLayoutEffect(() => {
     const prev = trackingRef.current;
-    const baseSink = normalizedConfig.tracking?.sink;
+    const baseSink = wrapTrackingSink(normalizedConfig.tracking?.sink, observabilityRef.current);
     const userBatchSink = normalizedConfig.tracking?.batchSink;
     assertTrackingSinkConfig(normalizedConfig.tracking);
     const sink = pluginHostRef.current && baseSink ? (
@@ -669,9 +734,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);
@@ -698,6 +766,7 @@ function useLessonkitProviderRuntime(config) {
           attemptId: attemptIdRef.current,
           user: userRef.current,
           lxpackBridge: lxpackBridgeModeRef.current,
+          onLxpackBridgeMiss,
           extraSinks: extraSinksRef.current,
           skipXapi: xapiCourseStartedSentOnClientRef.current,
           onXapiStatementSent: () => {
@@ -739,9 +808,10 @@ function useLessonkitProviderRuntime(config) {
         user: userRef.current
       }),
       lxpackBridge: lxpackBridgeModeRef.current,
+      onLxpackBridgeMiss,
       extraSinks: extraSinksRef.current
     });
-  }, []);
+  }, [onLxpackBridgeMiss]);
   const emitLifecycleEvent = (0, import_react.useCallback)(
     (name, data, lessonId) => {
       const event = (0, import_core2.tryBuildTelemetryEvent)({
@@ -797,12 +867,13 @@ function useLessonkitProviderRuntime(config) {
           attemptId: attemptIdRef.current,
           user: userRef.current,
           lxpackBridge: lxpackBridgeModeRef.current,
+          onLxpackBridgeMiss,
           extraSinks: extraSinksRef.current
         });
         courseStartedEmittedToSinkRef.current = isCourseStartedSinkSettled(result);
       }
     })();
-  }, [normalizedCourseId, normalizedConfig.tracking?.enabled, syncProgress]);
+  }, [normalizedCourseId, normalizedConfig.tracking?.enabled, syncProgress, onLxpackBridgeMiss]);
   const emitLessonCompleted = (0, import_react.useCallback)(
     (lessonId, durationMs) => {
       track("lesson_completed", { lessonId, durationMs }, { lessonId });
@@ -851,6 +922,22 @@ function useLessonkitProviderRuntime(config) {
       })();
     };
   }, []);
+  (0, import_react.useEffect)(() => {
+    if (typeof document === "undefined") return;
+    const flushOnExit = () => {
+      void xapiRef.current?.flush();
+      void trackingRef.current?.flush?.();
+    };
+    const onVisibilityChange = () => {
+      if (document.visibilityState === "hidden") flushOnExit();
+    };
+    document.addEventListener("visibilitychange", onVisibilityChange);
+    window.addEventListener("pagehide", flushOnExit);
+    return () => {
+      document.removeEventListener("visibilitychange", onVisibilityChange);
+      window.removeEventListener("pagehide", flushOnExit);
+    };
+  }, []);
   const setActiveLesson = (0, import_react.useCallback)(
     (lessonId) => {
       if (useV2Runtime && headlessRef.current) {
@@ -914,20 +1001,34 @@ function useLessonkitProviderRuntime(config) {
         session: normalizedConfig.session
       });
     }
-  }, [useV2Runtime, normalizedCourseId, sessionAttemptId, sessionConfiguredId, sessionUserKey, normalizedConfig.session]);
+  }, [
+    useV2Runtime,
+    normalizedCourseId,
+    sessionAttemptId,
+    sessionConfiguredId,
+    sessionUserKey,
+    normalizedConfig.session
+  ]);
+  (0, import_react.useEffect)(() => {
+    if (!useV2Runtime || !headlessRef.current) return;
+    headlessRef.current.updateConfig({
+      plugins: pluginHostRef.current ?? normalizedConfig.plugins
+    });
+  }, [useV2Runtime, pluginHost]);
   (0, import_react.useEffect)(() => {
-    if (!pluginHost) return;
+    const host = useV2Runtime ? headlessRef.current?.pluginHost ?? null : pluginHost;
+    if (!host) return;
     const ctx = buildPluginContext({
       courseId: courseIdRef.current,
       sessionId: sessionIdRef.current,
       attemptId: attemptIdRef.current,
       user: userRef.current
     });
-    pluginHost.setupAll(ctx);
+    host.setupAll(ctx);
     return () => {
-      pluginHost.disposeAll();
+      host.disposeAll();
     };
-  }, [pluginHost, normalizedCourseId, sessionAttemptId, sessionConfiguredId, sessionUserKey]);
+  }, [pluginHost, useV2Runtime, normalizedCourseId, sessionAttemptId, sessionConfiguredId, sessionUserKey]);
   (0, import_react.useEffect)(() => {
     const nextConfigured = normalizedConfig.session?.sessionId;
     const prevConfigured = prevConfiguredSessionIdRef.current;
@@ -956,6 +1057,7 @@ function useLessonkitProviderRuntime(config) {
       config: normalizedConfig,
       tracking,
       xapi,
+      storage: defaultStorage,
       session: { sessionId: sessionIdRef.current, attemptId: attemptIdRef.current, user: userRef.current },
       progress,
       setActiveLesson,
@@ -1053,17 +1155,17 @@ function useEnclosingLessonId() {
 }
 
 // src/runtime/validateComponentId.ts
-var import_core9 = require("@lessonkit/core");
+var import_core10 = require("@lessonkit/core");
 function isDevEnvironment4() {
   const g = globalThis;
   return typeof g.process !== "undefined" && g.process.env?.NODE_ENV !== "production";
 }
 function normalizeComponentId(id, path) {
-  if (path === "courseId") return (0, import_core9.assertValidId)(id, "courseId");
-  if (path === "lessonId") return (0, import_core9.assertValidId)(id, "lessonId");
-  if (path === "checkId") return (0, import_core9.assertValidId)(id, "checkId");
-  if (path === "blockId") return (0, import_core9.assertValidId)(id, "blockId");
-  return (0, import_core9.assertValidId)(id, path);
+  if (path === "courseId") return (0, import_core10.assertValidId)(id, "courseId");
+  if (path === "lessonId") return (0, import_core10.assertValidId)(id, "lessonId");
+  if (path === "checkId") return (0, import_core10.assertValidId)(id, "checkId");
+  if (path === "blockId") return (0, import_core10.assertValidId)(id, "blockId");
+  return (0, import_core10.assertValidId)(id, path);
 }
 
 // src/runtime/lessonMountRegistry.ts
@@ -1090,188 +1192,451 @@ function getLessonMountCount(lessonId) {
   return mountCounts.get(lessonId) ?? 0;
 }
 
-// src/components.tsx
+// src/components/Quiz.tsx
+var import_react12 = require("react");
+var import_accessibility = require("@lessonkit/accessibility");
+
+// src/assessment/AssessmentLessonGuard.tsx
+var import_react6 = require("react");
 var import_jsx_runtime2 = require("react/jsx-runtime");
-var warnedQuizOutsideLesson = false;
-function resetQuizWarningsForTests() {
-  warnedQuizOutsideLesson = false;
-}
-function Course(props) {
-  const courseId = (0, import_react6.useMemo)(() => normalizeComponentId(props.courseId, "courseId"), [props.courseId]);
-  const providerConfig = (0, import_react6.useMemo)(
-    () => ({ ...props.config, courseId }),
-    [props.config, courseId]
-  );
-  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(LessonkitProvider, { config: providerConfig, children: /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("section", { "aria-label": props.title, children: [
-    /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("h1", { children: props.title }),
-    /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("div", { children: props.children })
-  ] }) });
-}
-function Lesson(props) {
-  const lessonId = (0, import_react6.useMemo)(() => normalizeComponentId(props.lessonId, "lessonId"), [props.lessonId]);
-  const autoComplete = props.autoCompleteOnUnmount !== false;
-  const { setActiveLesson, config } = useLessonkit();
-  const { completeLesson } = useCompletion();
-  const lessonMountGenerationRef = (0, import_react6.useRef)(0);
-  const liveCourseIdRef = (0, import_react6.useRef)(config.courseId);
-  liveCourseIdRef.current = config.courseId;
-  (0, import_react6.useEffect)(() => {
-    const unregister = registerLessonMount(lessonId);
-    const generation = ++lessonMountGenerationRef.current;
-    const mountedCourseId = config.courseId;
-    let effectSurvivedTick = false;
-    queueMicrotask(() => {
-      queueMicrotask(() => {
-        effectSurvivedTick = true;
-      });
-    });
-    setActiveLesson(lessonId);
-    return () => {
-      unregister();
-      if (getLessonMountCount(lessonId) > 0) {
-        return;
-      }
-      if (!autoComplete) return;
-      queueMicrotask(() => {
-        if (!effectSurvivedTick) return;
-        if (lessonMountGenerationRef.current !== generation) return;
-        if (liveCourseIdRef.current !== mountedCourseId) return;
-        completeLesson(lessonId, { courseId: mountedCourseId });
-      });
-    };
-  }, [lessonId, config.courseId, setActiveLesson, completeLesson, autoComplete]);
-  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(LessonContext.Provider, { value: lessonId, children: /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("article", { "aria-label": props.title, children: [
-    /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("h2", { children: props.title }),
-    /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("div", { children: props.children })
-  ] }) });
-}
-function Scenario(props) {
-  const blockId = (0, import_react6.useMemo)(
-    () => props.blockId !== void 0 ? normalizeComponentId(props.blockId, "blockId") : void 0,
-    [props.blockId]
-  );
-  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("section", { "aria-label": "Scenario", "data-lk-block-id": blockId, children: props.children });
-}
-function Reflection(props) {
-  const blockId = (0, import_react6.useMemo)(
-    () => props.blockId !== void 0 ? normalizeComponentId(props.blockId, "blockId") : void 0,
-    [props.blockId]
-  );
-  const promptId = (0, import_react6.useId)();
-  const hintId = (0, import_react6.useId)();
-  const [internalValue, setInternalValue] = (0, import_react6.useState)("");
-  const isControlled = props.value !== void 0;
-  const value = isControlled ? props.value : internalValue;
-  const handleChange = (event) => {
-    if (!isControlled) setInternalValue(event.target.value);
-    props.onChange?.(event.target.value);
-  };
-  return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("section", { "aria-label": "Reflection", "data-lk-block-id": blockId, children: [
-    props.prompt ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("p", { id: promptId, children: props.prompt }) : null,
-    props.hint ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("p", { id: hintId, style: import_accessibility.visuallyHiddenStyle, children: props.hint }) : null,
-    props.children,
-    /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
-      "textarea",
-      {
-        value,
-        onChange: handleChange,
-        "aria-labelledby": props.prompt ? promptId : void 0,
-        "aria-describedby": props.hint ? hintId : void 0,
-        "aria-label": props.prompt ? void 0 : "Reflection response"
-      }
-    )
-  ] });
-}
-function KnowledgeCheck(props) {
-  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
-    Quiz,
-    {
-      checkId: props.checkId,
-      question: props.question,
-      choices: props.choices,
-      answer: props.answer,
-      passingScore: props.passingScore
-    }
-  );
+var warnedAssessmentOutsideLesson = false;
+function resetAssessmentWarningsForTests() {
+  warnedAssessmentOutsideLesson = false;
 }
-function Quiz(props) {
+function AssessmentLessonGuard(props) {
   const enclosingLessonId = useEnclosingLessonId();
   const missingLesson = enclosingLessonId === void 0;
   (0, import_react6.useEffect)(() => {
     if (!missingLesson || isDevEnvironment4()) return;
-    if (!warnedQuizOutsideLesson) {
-      warnedQuizOutsideLesson = true;
+    if (!warnedAssessmentOutsideLesson) {
+      warnedAssessmentOutsideLesson = true;
       console.error(
-        "[lessonkit] <Quiz> must be wrapped in <Lesson>; quiz telemetry will not be emitted."
+        `[lessonkit] <${props.blockLabel}> must be wrapped in <Lesson>; assessment telemetry will not be emitted.`
       );
     }
-  }, [missingLesson]);
+  }, [missingLesson, props.blockLabel]);
   if (missingLesson && isDevEnvironment4()) {
-    throw new Error("[lessonkit] <Quiz> must be wrapped in <Lesson>");
+    throw new Error(`[lessonkit] <${props.blockLabel}> must be wrapped in <Lesson>`);
   }
   if (missingLesson) {
-    return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("section", { role: "alert", "aria-label": "Quiz configuration error", "data-lk-check-id": props.checkId, children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("p", { children: "Quiz must be placed inside a Lesson." }) });
+    return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("section", { role: "alert", "aria-label": `${props.blockLabel} configuration error`, "data-lk-check-id": props.checkId, children: /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("p", { children: [
+      props.blockLabel,
+      " must be placed inside a Lesson."
+    ] }) });
   }
-  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(QuizInner, { ...props, enclosingLessonId });
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_jsx_runtime2.Fragment, { children: props.children(enclosingLessonId) });
 }
-function QuizInner(props) {
-  const { enclosingLessonId } = props;
-  const checkId = (0, import_react6.useMemo)(() => normalizeComponentId(props.checkId, "checkId"), [props.checkId]);
-  const quiz = useQuizState(enclosingLessonId);
-  const { plugins, config, session } = useLessonkit();
-  const [selected, setSelected] = (0, import_react6.useState)(null);
-  const [selectionCorrect, setSelectionCorrect] = (0, import_react6.useState)(null);
-  const [quizPassed, setQuizPassed] = (0, import_react6.useState)(false);
-  const completedRef = (0, import_react6.useRef)(false);
-  const questionId = (0, import_react6.useId)();
-  const choicesKey = props.choices.join("\0");
-  (0, import_react6.useEffect)(() => {
-    completedRef.current = false;
-    setQuizPassed(false);
-    setSelected(null);
-    setSelectionCorrect(null);
-  }, [checkId, props.answer, props.question, config.courseId, enclosingLessonId, choicesKey]);
-  const isChoiceCorrect = (choice, custom) => {
-    if (!custom) return choice === props.answer;
-    if (custom.passed !== void 0) return custom.passed;
-    if (custom.maxScore != null && custom.maxScore > 0 && custom.score != null) {
-      return meetsPassingThreshold(custom.score, custom.maxScore, props.passingScore);
-    }
-    return choice === props.answer;
+
+// src/assessment/internal/buildAssessmentHandle.ts
+function buildAssessmentHandle(opts) {
+  return {
+    getScore: opts.getScore,
+    getMaxScore: opts.getMaxScore,
+    getAnswerGiven: opts.getAnswerGiven,
+    resetTask: opts.resetTask,
+    showSolutions: opts.showSolutions,
+    getXAPIData: opts.getXAPIData,
+    ...opts.getCurrentState ? { getCurrentState: opts.getCurrentState } : {},
+    ...opts.resume ? { resume: opts.resume } : {}
   };
-  const passed = quizPassed;
-  return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("section", { "aria-label": "Quiz", "data-lk-check-id": checkId, children: [
-    /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("p", { id: questionId, children: props.question }),
-    /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("fieldset", { "aria-labelledby": questionId, children: [
-      /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("legend", { style: import_accessibility.visuallyHiddenStyle, children: "Quiz choices" }),
-      props.choices.map((c, i) => /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("label", { style: { display: "block" }, children: [
-        /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
-          "input",
-          {
-            type: "radio",
-            name: questionId,
-            value: c,
-            checked: selected === c,
-            disabled: passed,
-            "aria-invalid": selected === c && selectionCorrect === false ? true : void 0,
-            onChange: () => {
-              if (passed) return;
-              setSelected(c);
-              const pluginCtx = buildPluginContext({
-                courseId: config.courseId,
-                sessionId: session.sessionId,
-                attemptId: session.attemptId,
-                user: session.user
-              });
-              const custom = plugins?.scoreAssessment(
-                {
-                  checkId,
-                  lessonId: enclosingLessonId,
-                  response: c
-                },
-                pluginCtx
-              ) ?? null;
-              const correct = isChoiceCorrect(c, custom);
+}
+
+// src/assessment/internal/resumeState.ts
+function readBooleanField(state, key) {
+  const value = state[key];
+  if (value === true || value === false || value === null) return value;
+  return void 0;
+}
+function readStringField(state, key) {
+  const value = 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);
+}
+
+// src/assessment/internal/useAssessmentHandleRegistration.ts
+var import_react10 = require("react");
+
+// src/compound/CompoundProvider.tsx
+var import_react9 = __toESM(require("react"), 1);
+var import_core11 = require("@lessonkit/core");
+
+// src/compound/aggregateScores.ts
+function aggregateAssessmentScores(handles, opts) {
+  let score = 0;
+  let maxScore = 0;
+  let allAnswered = true;
+  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();
+    const countsForAnswerGiven = opts?.answerPageIndex === void 0 || pageIndex === void 0 || pageIndex === opts.answerPageIndex;
+    if (countsForAnswerGiven && !handle.getAnswerGiven()) allAnswered = false;
+  }
+  return { score, maxScore, allAnswered };
+}
+
+// src/compound/CompoundHydrationBridge.tsx
+var import_react7 = require("react");
+var import_jsx_runtime3 = require("react/jsx-runtime");
+var CompoundHydrationBridgeContext = (0, import_react7.createContext)(
+  null
+);
+function CompoundHydrationBridgeProvider({ children }) {
+  const bridgeRef = (0, import_react7.useRef)(null);
+  return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(CompoundHydrationBridgeContext.Provider, { value: bridgeRef, children });
+}
+function useCompoundHydrationBridgeRef() {
+  return (0, import_react7.useContext)(CompoundHydrationBridgeContext);
+}
+
+// src/compound/CompoundPageIndexContext.tsx
+var import_react8 = require("react");
+var import_jsx_runtime4 = require("react/jsx-runtime");
+var CompoundPageIndexContext = (0, import_react8.createContext)(void 0);
+function CompoundPageIndexProvider({
+  pageIndex,
+  children
+}) {
+  return /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(CompoundPageIndexContext.Provider, { value: pageIndex, children });
+}
+function useCompoundPageIndex() {
+  return (0, import_react8.useContext)(CompoundPageIndexContext);
+}
+
+// src/compound/CompoundProvider.tsx
+var import_jsx_runtime5 = require("react/jsx-runtime");
+var CompoundRegistryContext = (0, import_react9.createContext)(null);
+var CompoundHandlesVersionContext = (0, import_react9.createContext)(0);
+function CompoundProvider({
+  children,
+  activePageIndex: _activePageIndex,
+  onActivePageIndexChange: _onActivePageIndexChange
+}) {
+  const registryRef = (0, import_react9.useRef)(/* @__PURE__ */ new Map());
+  const [handlesVersion, setHandlesVersion] = (0, import_react9.useState)(0);
+  const register = (0, import_react9.useCallback)((checkId, handle, pageIndex) => {
+    const prev = registryRef.current.get(checkId);
+    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 () => {
+      const current = registryRef.current.get(checkId);
+      if (current?.handle === handle) {
+        registryRef.current.delete(checkId);
+        setHandlesVersion((v) => v + 1);
+      }
+    };
+  }, []);
+  const registryValue = (0, import_react9.useMemo)(
+    () => ({
+      register,
+      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__ */ (0, import_jsx_runtime5.jsx)(CompoundHydrationBridgeProvider, { children: /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(CompoundRegistryContext.Provider, { value: registryValue, children: /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(CompoundHandlesVersionContext.Provider, { value: handlesVersion, children }) }) });
+}
+function useCompoundRegistry() {
+  const registry = (0, import_react9.useContext)(CompoundRegistryContext);
+  const handlesVersion = (0, import_react9.useContext)(CompoundHandlesVersionContext);
+  if (!registry) return null;
+  return { ...registry, handlesVersion };
+}
+function useCompoundHandlesVersion() {
+  return (0, import_react9.useContext)(CompoundHandlesVersionContext);
+}
+function useRegisterAssessmentHandle(checkId, handle) {
+  const registry = (0, import_react9.useContext)(CompoundRegistryContext);
+  const pageIndex = useCompoundPageIndex();
+  import_react9.default.useLayoutEffect(() => {
+    if (!registry || !handle) return;
+    return registry.register(checkId, handle, pageIndex);
+  }, [registry, checkId, handle, pageIndex]);
+}
+function useCompoundHandleRef(ref, opts) {
+  const { activePageIndex, setActivePageIndex, getHandles, getRegisteredHandles, pageCount } = opts;
+  const bridgeRef = useCompoundHydrationBridgeRef();
+  const setIndexClamped = (0, import_react9.useCallback)(
+    (index) => {
+      const next = pageCount !== void 0 ? (0, import_core11.clampCompoundPageIndex)(index, pageCount) : Math.max(0, Math.floor(index));
+      setActivePageIndex(next);
+    },
+    [pageCount, setActivePageIndex]
+  );
+  (0, import_react9.useImperativeHandle)(
+    ref,
+    () => ({
+      getScore: () => aggregateAssessmentScores(getRegisteredHandles().values()).score,
+      getMaxScore: () => aggregateAssessmentScores(getRegisteredHandles().values()).maxScore,
+      getAnswerGiven: () => aggregateAssessmentScores(getRegisteredHandles().values(), {
+        answerPageIndex: activePageIndex
+      }).allAnswered,
+      resetTask: () => {
+        for (const entry of getRegisteredHandles().values()) entry.handle.resetTask();
+      },
+      showSolutions: () => {
+        if (!opts.enableSolutionsButton) return;
+        for (const entry of getRegisteredHandles().values()) entry.handle.showSolutions();
+      },
+      getCurrentState: () => {
+        const childStates = {};
+        for (const [checkId, entry] of getRegisteredHandles()) {
+          if (entry.handle.getCurrentState) {
+            childStates[checkId] = entry.handle.getCurrentState();
+          }
+        }
+        return (0, import_core11.createCompoundResumeState)({ activePageIndex, childStates });
+      },
+      resume: (state) => {
+        bridgeRef?.current?.notifyImperativeResume(state);
+      }
+    }),
+    [activePageIndex, setIndexClamped, getHandles, getRegisteredHandles, opts.enableSolutionsButton, bridgeRef]
+  );
+}
+
+// src/assessment/internal/useAssessmentHandleRegistration.ts
+function useAssessmentHandleRegistration(checkId, handle, ref) {
+  (0, import_react10.useImperativeHandle)(ref, () => handle, [handle]);
+  useRegisterAssessmentHandle(checkId, handle);
+}
+
+// src/assessment/internal/usePluginScoring.ts
+var import_react11 = require("react");
+
+// src/assessment/scoring.ts
+function resolvePassingThreshold(passingScore, maxScore) {
+  return passingScore ?? maxScore;
+}
+function meetsPassingThreshold(score, maxScore, passingScore) {
+  const threshold = resolvePassingThreshold(passingScore, maxScore);
+  return score >= threshold;
+}
+function scoreFromCustom(custom, fallbackCorrect, fallbackMax = 1, passingScore) {
+  const maxScore = custom?.maxScore ?? fallbackMax;
+  if (custom?.passed !== void 0) {
+    const score2 = custom.passed ? custom.score ?? maxScore : custom.score ?? 0;
+    return { score: score2, maxScore, passed: custom.passed };
+  }
+  if (custom?.maxScore != null && custom.maxScore > 0 && custom.score != null) {
+    const passed2 = meetsPassingThreshold(custom.score, custom.maxScore, passingScore);
+    return { score: custom.score, maxScore: custom.maxScore, passed: passed2 };
+  }
+  const score = fallbackCorrect ? maxScore : 0;
+  const passed = meetsPassingThreshold(score, maxScore, passingScore);
+  return { score, maxScore, passed };
+}
+
+// src/assessment/internal/usePluginScoring.ts
+function usePluginScoring(checkId, lessonId) {
+  const { plugins, config, session } = useLessonkit();
+  const getPluginScore = (0, import_react11.useCallback)(
+    (response) => {
+      const pluginCtx = buildPluginContext({
+        courseId: config.courseId,
+        sessionId: session.sessionId,
+        attemptId: session.attemptId,
+        user: session.user
+      });
+      return plugins?.scoreAssessment({ checkId, lessonId, response }, pluginCtx) ?? null;
+    },
+    [checkId, config.courseId, lessonId, plugins, session.attemptId, session.sessionId, session.user]
+  );
+  const scoreResponse = (0, import_react11.useCallback)(
+    (response, defaultCorrect, maxScore = 1, passingScore) => scoreFromCustom(getPluginScore(response), defaultCorrect, maxScore, passingScore),
+    [getPluginScore]
+  );
+  const isChoiceCorrect = (0, import_react11.useCallback)(
+    (choice, answer, custom, passingScore) => {
+      if (!custom) return choice === answer;
+      if (custom.passed !== void 0) return custom.passed;
+      if (custom.maxScore != null && custom.maxScore > 0 && custom.score != null) {
+        return meetsPassingThreshold(custom.score, custom.maxScore, passingScore);
+      }
+      return choice === answer;
+    },
+    []
+  );
+  return { getPluginScore, scoreResponse, isChoiceCorrect };
+}
+
+// src/components/Quiz.tsx
+var import_jsx_runtime6 = require("react/jsx-runtime");
+function QuizInner(props, ref) {
+  const { enclosingLessonId } = props;
+  const checkId = (0, import_react12.useMemo)(() => normalizeComponentId(props.checkId, "checkId"), [props.checkId]);
+  const quiz = useQuizState(enclosingLessonId);
+  const { getPluginScore, isChoiceCorrect } = usePluginScoring(checkId, enclosingLessonId);
+  const [selected, setSelected] = (0, import_react12.useState)(null);
+  const [selectionCorrect, setSelectionCorrect] = (0, import_react12.useState)(null);
+  const [quizPassed, setQuizPassed] = (0, import_react12.useState)(false);
+  const [completedScore, setCompletedScore] = (0, import_react12.useState)(null);
+  const [completedMaxScore, setCompletedMaxScore] = (0, import_react12.useState)(null);
+  const completedRef = (0, import_react12.useRef)(false);
+  const telemetryReplayedRef = (0, import_react12.useRef)(false);
+  const questionId = (0, import_react12.useId)();
+  const choicesKey = props.choices.join("\0");
+  (0, import_react12.useEffect)(() => {
+    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 = (0, import_react12.useMemo)(
+    () => buildAssessmentHandle({
+      checkId,
+      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: () => {
+        const { score, maxScore } = resolveScores();
+        return {
+          checkId,
+          interactionType: "mcq",
+          response: selected ?? void 0,
+          correct: selectionCorrect ?? void 0,
+          score,
+          maxScore
+        };
+      },
+      getCurrentState: () => ({
+        selected,
+        selectionCorrect,
+        quizPassed,
+        completedScore,
+        completedMaxScore
+      }),
+      resume: (state) => {
+        const nextSelected = readStringField(state, "selected");
+        if (typeof nextSelected === "string" || nextSelected === null) setSelected(nextSelected);
+        const nextCorrect = readBooleanField(state, "selectionCorrect");
+        if (nextCorrect === true || nextCorrect === false || nextCorrect === null) {
+          setSelectionCorrect(nextCorrect);
+        }
+        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,
+      completedMaxScore,
+      completedScore,
+      props.passingScore,
+      props.question,
+      quiz,
+      quizPassed,
+      selected,
+      selectionCorrect
+    ]
+  );
+  useAssessmentHandleRegistration(checkId, handle, ref);
+  return /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("section", { "aria-label": "Quiz", "data-lk-check-id": checkId, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("p", { id: questionId, children: props.question }),
+    /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("fieldset", { "aria-labelledby": questionId, children: [
+      /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("legend", { style: import_accessibility.visuallyHiddenStyle, children: "Quiz choices" }),
+      props.choices.map((c, i) => /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("label", { style: { display: "block" }, children: [
+        /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(
+          "input",
+          {
+            type: "radio",
+            name: questionId,
+            value: c,
+            checked: selected === c,
+            disabled: passed,
+            "aria-invalid": selected === c && selectionCorrect === false ? true : void 0,
+            onChange: () => {
+              if (passed) return;
+              setSelected(c);
+              const custom = getPluginScore(c);
+              const correct = isChoiceCorrect(c, props.answer, custom, props.passingScore);
               setSelectionCorrect(correct);
               quiz.answer({
                 checkId,
@@ -1283,9 +1648,12 @@ function QuizInner(props) {
                 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
                 });
@@ -1296,7 +1664,115 @@ function QuizInner(props) {
         c
       ] }, `${questionId}-${i}`))
     ] }),
-    selected && selectionCorrect !== null ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("p", { role: "status", "aria-live": "polite", children: selectionCorrect ? "Correct" : "Try again" }) : null
+    selected && selectionCorrect !== null ? /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("p", { role: "status", "aria-live": "polite", children: selectionCorrect ? "Correct" : "Try again" }) : null
+  ] });
+}
+var QuizInnerForwarded = (0, import_react12.forwardRef)(QuizInner);
+var Quiz = (0, import_react12.forwardRef)(function Quiz2(props, ref) {
+  return /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(AssessmentLessonGuard, { blockLabel: "Quiz", checkId: props.checkId, children: (lessonId) => /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(QuizInnerForwarded, { ...props, enclosingLessonId: lessonId, ref }) });
+});
+function KnowledgeCheck(props) {
+  return /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(
+    Quiz,
+    {
+      checkId: props.checkId,
+      question: props.question,
+      choices: props.choices,
+      answer: props.answer,
+      passingScore: props.passingScore
+    }
+  );
+}
+function resetQuizWarningsForTests() {
+  resetAssessmentWarningsForTests();
+}
+
+// src/components.tsx
+var import_jsx_runtime7 = require("react/jsx-runtime");
+function Course(props) {
+  const courseId = (0, import_react13.useMemo)(() => normalizeComponentId(props.courseId, "courseId"), [props.courseId]);
+  const providerConfig = (0, import_react13.useMemo)(
+    () => ({ ...props.config, courseId }),
+    [props.config, courseId]
+  );
+  return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(LessonkitProvider, { config: providerConfig, children: /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("section", { "aria-label": props.title, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("h1", { children: props.title }),
+    /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("div", { children: props.children })
+  ] }) });
+}
+function Lesson(props) {
+  const lessonId = (0, import_react13.useMemo)(() => normalizeComponentId(props.lessonId, "lessonId"), [props.lessonId]);
+  const autoComplete = props.autoCompleteOnUnmount !== false;
+  const { setActiveLesson, config } = useLessonkit();
+  const { completeLesson } = useCompletion();
+  const lessonMountGenerationRef = (0, import_react13.useRef)(0);
+  const liveCourseIdRef = (0, import_react13.useRef)(config.courseId);
+  liveCourseIdRef.current = config.courseId;
+  (0, import_react13.useEffect)(() => {
+    const unregister = registerLessonMount(lessonId);
+    const generation = ++lessonMountGenerationRef.current;
+    const mountedCourseId = config.courseId;
+    let effectSurvivedTick = false;
+    queueMicrotask(() => {
+      queueMicrotask(() => {
+        effectSurvivedTick = true;
+      });
+    });
+    setActiveLesson(lessonId);
+    return () => {
+      unregister();
+      if (getLessonMountCount(lessonId) > 0) {
+        return;
+      }
+      if (!autoComplete) return;
+      queueMicrotask(() => {
+        if (!effectSurvivedTick) return;
+        if (lessonMountGenerationRef.current !== generation) return;
+        if (liveCourseIdRef.current !== mountedCourseId) return;
+        completeLesson(lessonId, { courseId: mountedCourseId });
+      });
+    };
+  }, [lessonId, config.courseId, setActiveLesson, completeLesson, autoComplete]);
+  return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(LessonContext.Provider, { value: lessonId, children: /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("article", { "aria-label": props.title, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("h2", { children: props.title }),
+    /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("div", { children: props.children })
+  ] }) });
+}
+function Scenario(props) {
+  const blockId = (0, import_react13.useMemo)(
+    () => props.blockId !== void 0 ? normalizeComponentId(props.blockId, "blockId") : void 0,
+    [props.blockId]
+  );
+  return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("section", { "aria-label": "Scenario", "data-lk-block-id": blockId, children: props.children });
+}
+function Reflection(props) {
+  const blockId = (0, import_react13.useMemo)(
+    () => props.blockId !== void 0 ? normalizeComponentId(props.blockId, "blockId") : void 0,
+    [props.blockId]
+  );
+  const promptId = (0, import_react13.useId)();
+  const hintId = (0, import_react13.useId)();
+  const [internalValue, setInternalValue] = (0, import_react13.useState)("");
+  const isControlled = props.value !== void 0;
+  const value = isControlled ? props.value : internalValue;
+  const handleChange = (event) => {
+    if (!isControlled) setInternalValue(event.target.value);
+    props.onChange?.(event.target.value);
+  };
+  return /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("section", { "aria-label": "Reflection", "data-lk-block-id": blockId, children: [
+    props.prompt ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("p", { id: promptId, children: props.prompt }) : null,
+    props.hint ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("p", { id: hintId, style: import_accessibility2.visuallyHiddenStyle, children: props.hint }) : null,
+    props.children,
+    /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
+      "textarea",
+      {
+        value,
+        onChange: handleChange,
+        "aria-labelledby": props.prompt ? promptId : void 0,
+        "aria-describedby": props.hint ? hintId : void 0,
+        "aria-label": props.prompt ? void 0 : "Reflection response"
+      }
+    )
   ] });
 }
 function ProgressTracker(props) {
@@ -1305,7 +1781,7 @@ function ProgressTracker(props) {
   if (props.totalLessons != null) {
     const total = props.totalLessons;
     const displayed = Math.min(completed, total);
-    return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("aside", { "aria-label": "Progress", children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+    return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("aside", { "aria-label": "Progress", children: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
       "div",
       {
         role: "progressbar",
@@ -1313,7 +1789,7 @@ function ProgressTracker(props) {
         "aria-valuemax": total,
         "aria-valuenow": displayed,
         "aria-label": "Lessons completed",
-        children: /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("p", { children: [
+        children: /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("p", { children: [
           "Lessons completed: ",
           displayed,
           " of ",
@@ -1322,138 +1798,146 @@ function ProgressTracker(props) {
       }
     ) });
   }
-  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("aside", { "aria-label": "Progress", role: "status", children: /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("p", { children: [
+  return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("aside", { "aria-label": "Progress", role: "status", children: /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("p", { children: [
     "Lessons completed: ",
     completed
   ] }) });
 }
 
 // src/blocks/TrueFalse.tsx
-var import_react9 = __toESM(require("react"), 1);
-
-// src/assessment/AssessmentLessonGuard.tsx
-var import_react7 = require("react");
-var import_jsx_runtime3 = require("react/jsx-runtime");
-var warnedAssessmentOutsideLesson = false;
-function resetAssessmentWarningsForTests() {
-  warnedAssessmentOutsideLesson = false;
-}
-function AssessmentLessonGuard(props) {
-  const enclosingLessonId = useEnclosingLessonId();
-  const missingLesson = enclosingLessonId === void 0;
-  (0, import_react7.useEffect)(() => {
-    if (!missingLesson || isDevEnvironment4()) return;
-    if (!warnedAssessmentOutsideLesson) {
-      warnedAssessmentOutsideLesson = true;
-      console.error(
-        `[lessonkit] <${props.blockLabel}> must be wrapped in <Lesson>; assessment telemetry will not be emitted.`
-      );
-    }
-  }, [missingLesson, props.blockLabel]);
-  if (missingLesson && isDevEnvironment4()) {
-    throw new Error(`[lessonkit] <${props.blockLabel}> must be wrapped in <Lesson>`);
-  }
-  if (missingLesson) {
-    return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("section", { role: "alert", "aria-label": `${props.blockLabel} configuration error`, "data-lk-check-id": props.checkId, children: /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("p", { children: [
-      props.blockLabel,
-      " must be placed inside a Lesson."
-    ] }) });
-  }
-  return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_jsx_runtime3.Fragment, { children: props.children(enclosingLessonId) });
-}
-
-// src/assessment/AssessmentSequenceContext.tsx
-var import_react8 = __toESM(require("react"), 1);
-var import_jsx_runtime4 = require("react/jsx-runtime");
-var AssessmentSequenceContext = (0, import_react8.createContext)(null);
-function AssessmentSequenceProvider({ children }) {
-  const registryRef = (0, import_react8.useRef)(/* @__PURE__ */ new Map());
-  const register = (0, import_react8.useCallback)((checkId, handle) => {
-    registryRef.current.set(checkId, handle);
-    return () => {
-      registryRef.current.delete(checkId);
-    };
-  }, []);
-  const value = (0, import_react8.useMemo)(
-    () => ({
-      register,
-      getHandles: () => registryRef.current
-    }),
-    [register]
-  );
-  return /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(AssessmentSequenceContext.Provider, { value, children });
-}
-function useAssessmentSequenceRegistry() {
-  return (0, import_react8.useContext)(AssessmentSequenceContext);
-}
-function useRegisterAssessmentHandle(checkId, handle) {
-  const ctx = useAssessmentSequenceRegistry();
-  import_react8.default.useEffect(() => {
-    if (!ctx || !handle) return;
-    return ctx.register(checkId, handle);
-  }, [ctx, checkId, handle]);
-}
-
-// src/blocks/TrueFalse.tsx
-var import_jsx_runtime5 = require("react/jsx-runtime");
+var import_react14 = __toESM(require("react"), 1);
+var import_jsx_runtime8 = require("react/jsx-runtime");
 var INTERACTION = "trueFalse";
 function TrueFalseInner(props, ref) {
   const { enclosingLessonId } = props;
-  const checkId = (0, import_react9.useMemo)(() => normalizeComponentId(props.checkId, "checkId"), [props.checkId]);
+  const checkId = (0, import_react14.useMemo)(() => normalizeComponentId(props.checkId, "checkId"), [props.checkId]);
   const assessment = useAssessmentState(enclosingLessonId);
-  const { plugins, config, session } = useLessonkit();
-  const [selected, setSelected] = (0, import_react9.useState)(null);
-  const [selectionCorrect, setSelectionCorrect] = (0, import_react9.useState)(null);
-  const [showSolutions, setShowSolutions] = (0, import_react9.useState)(false);
-  const [passed, setPassed] = (0, import_react9.useState)(false);
-  const completedRef = (0, import_react9.useRef)(false);
-  const questionId = import_react9.default.useId();
+  const { config } = useLessonkit();
+  const { scoreResponse } = usePluginScoring(checkId, enclosingLessonId);
+  const [selected, setSelected] = (0, import_react14.useState)(null);
+  const [selectionCorrect, setSelectionCorrect] = (0, import_react14.useState)(null);
+  const [showSolutions, setShowSolutions] = (0, import_react14.useState)(false);
+  const [passed, setPassed] = (0, import_react14.useState)(false);
+  const [completedScore, setCompletedScore] = (0, import_react14.useState)(null);
+  const [completedMaxScore, setCompletedMaxScore] = (0, import_react14.useState)(null);
+  const completedRef = (0, import_react14.useRef)(false);
+  const telemetryReplayedRef = (0, import_react14.useRef)(false);
+  const questionId = import_react14.default.useId();
   const reset = () => {
     completedRef.current = false;
+    telemetryReplayedRef.current = false;
     setPassed(false);
     setSelected(null);
     setSelectionCorrect(null);
     setShowSolutions(false);
+    setCompletedScore(null);
+    setCompletedMaxScore(null);
   };
-  (0, import_react9.useEffect)(() => {
+  (0, import_react14.useEffect)(() => {
     reset();
   }, [checkId, props.answer, props.question, config.courseId, enclosingLessonId]);
-  const handle = (0, import_react9.useMemo)(() => {
-    const maxScore = 1;
-    const score = passed ? maxScore : selected === null ? 0 : selected === props.answer ? maxScore : 0;
-    return {
-      getScore: () => score,
-      getMaxScore: () => maxScore,
+  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 = (0, import_react14.useMemo)(
+    () => buildAssessmentHandle({
+      checkId,
+      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,
-        maxScore
-      })
-    };
-  }, [checkId, passed, props.answer, selected]);
-  (0, import_react9.useImperativeHandle)(ref, () => handle, [handle]);
-  useRegisterAssessmentHandle(checkId, handle);
+      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
+      }),
+      resume: (state) => {
+        const nextSelected = readBooleanField(state, "selected");
+        if (nextSelected === true || nextSelected === false || nextSelected === null) {
+          setSelected(nextSelected);
+        }
+        const nextCorrect = readBooleanField(state, "selectionCorrect");
+        if (nextCorrect === true || nextCorrect === false || nextCorrect === null) {
+          setSelectionCorrect(nextCorrect);
+        }
+        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);
+      }
+    }),
+    [
+      assessment,
+      checkId,
+      completedMaxScore,
+      completedScore,
+      passed,
+      props.passingScore,
+      props.question,
+      selected,
+      selectionCorrect,
+      showSolutions
+    ]
+  );
+  useAssessmentHandleRegistration(checkId, handle, ref);
   const submit = (value) => {
     if (passed && !props.enableRetry) return;
     setSelected(value);
-    const pluginCtx = buildPluginContext({
-      courseId: config.courseId,
-      sessionId: session.sessionId,
-      attemptId: session.attemptId,
-      user: session.user
-    });
-    const custom = plugins?.scoreAssessment(
-      { checkId, lessonId: enclosingLessonId, response: value },
-      pluginCtx
-    ) ?? null;
     const correct = value === props.answer;
-    const scored = scoreFromCustom(custom, correct, 1, props.passingScore);
+    const scored = scoreResponse(value, correct, 1, props.passingScore);
     setSelectionCorrect(scored.passed);
     assessment.answer({
       checkId,
@@ -1465,6 +1949,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,
@@ -1475,12 +1961,12 @@ function TrueFalseInner(props, ref) {
     }
   };
   const reveal = showSolutions || passed && props.enableSolutionsButton;
-  return /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("section", { "aria-label": "True or False", "data-lk-check-id": checkId, children: [
-    /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("p", { id: questionId, children: props.question }),
-    /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("fieldset", { "aria-labelledby": questionId, children: [
-      /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("legend", { className: "lk-visually-hidden", children: "True or False" }),
-      /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("label", { style: { display: "block", marginRight: "1rem" }, children: [
-        /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
+  return /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)("section", { "aria-label": "True or False", "data-lk-check-id": checkId, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("p", { id: questionId, children: props.question }),
+    /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)("fieldset", { "aria-labelledby": questionId, children: [
+      /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("legend", { className: "lk-visually-hidden", children: "True or False" }),
+      /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)("label", { style: { display: "block", marginRight: "1rem" }, children: [
+        /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(
           "input",
           {
             type: "radio",
@@ -1492,8 +1978,8 @@ function TrueFalseInner(props, ref) {
         ),
         "True"
       ] }),
-      /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("label", { style: { display: "block" }, children: [
-        /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
+      /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)("label", { style: { display: "block" }, children: [
+        /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(
           "input",
           {
             type: "radio",
@@ -1506,49 +1992,49 @@ function TrueFalseInner(props, ref) {
         "False"
       ] })
     ] }),
-    reveal ? /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("p", { children: [
+    reveal ? /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)("p", { children: [
       "Correct answer: ",
-      /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("strong", { children: props.answer ? "True" : "False" })
+      /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("strong", { children: props.answer ? "True" : "False" })
     ] }) : null,
-    selected !== null && selectionCorrect !== null ? /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("p", { role: "status", "aria-live": "polite", children: selectionCorrect ? "Correct" : "Try again" }) : null,
-    props.enableRetry && passed ? /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("button", { type: "button", onClick: reset, children: "Try again" }) : null,
-    props.enableSolutionsButton && !reveal ? /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("button", { type: "button", onClick: () => setShowSolutions(true), children: "Show solution" }) : null
+    selected !== null && selectionCorrect !== null ? /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("p", { role: "status", "aria-live": "polite", children: selectionCorrect ? "Correct" : "Try again" }) : null,
+    props.enableRetry && passed ? /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("button", { type: "button", onClick: reset, children: "Try again" }) : null,
+    props.enableSolutionsButton && !reveal ? /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("button", { type: "button", onClick: () => setShowSolutions(true), children: "Show solution" }) : null
   ] });
 }
-var TrueFalseInnerForwarded = (0, import_react9.forwardRef)(TrueFalseInner);
-var TrueFalse = (0, import_react9.forwardRef)(function TrueFalse2(props, ref) {
-  return /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(AssessmentLessonGuard, { blockLabel: "TrueFalse", checkId: props.checkId, children: (lessonId) => /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(TrueFalseInnerForwarded, { ...props, enclosingLessonId: lessonId, ref }) });
+var TrueFalseInnerForwarded = (0, import_react14.forwardRef)(TrueFalseInner);
+var TrueFalse = (0, import_react14.forwardRef)(function TrueFalse2(props, ref) {
+  return /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(AssessmentLessonGuard, { blockLabel: "TrueFalse", checkId: props.checkId, children: (lessonId) => /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(TrueFalseInnerForwarded, { ...props, enclosingLessonId: lessonId, ref }) });
 });
 
 // src/blocks/MarkTheWords.tsx
-var import_react10 = __toESM(require("react"), 1);
-var import_jsx_runtime6 = require("react/jsx-runtime");
+var import_react15 = __toESM(require("react"), 1);
+var import_jsx_runtime9 = require("react/jsx-runtime");
 var INTERACTION2 = "markTheWords";
 function tokenize(text) {
   return text.split(/(\s+)/).filter((t) => t.length > 0);
 }
 function MarkTheWordsInner(props, ref) {
-  const checkId = (0, import_react10.useMemo)(() => normalizeComponentId(props.checkId, "checkId"), [props.checkId]);
+  const checkId = (0, import_react15.useMemo)(() => normalizeComponentId(props.checkId, "checkId"), [props.checkId]);
   const assessment = useAssessmentState(props.enclosingLessonId);
-  const tokens = (0, import_react10.useMemo)(() => tokenize(props.text), [props.text]);
-  const correctSet = (0, import_react10.useMemo)(
+  const tokens = (0, import_react15.useMemo)(() => tokenize(props.text), [props.text]);
+  const correctSet = (0, import_react15.useMemo)(
     () => new Set(props.correctWords.map((w) => w.toLowerCase())),
     [props.correctWords]
   );
-  const [marked, setMarked] = (0, import_react10.useState)(() => /* @__PURE__ */ new Set());
-  const [passed, setPassed] = (0, import_react10.useState)(false);
-  const [showSolutions, setShowSolutions] = (0, import_react10.useState)(false);
-  const completedRef = (0, import_react10.useRef)(false);
+  const [marked, setMarked] = (0, import_react15.useState)(() => /* @__PURE__ */ new Set());
+  const [passed, setPassed] = (0, import_react15.useState)(false);
+  const [showSolutions, setShowSolutions] = (0, import_react15.useState)(false);
+  const completedRef = (0, import_react15.useRef)(false);
   const reset = () => {
     completedRef.current = false;
     setPassed(false);
     setMarked(/* @__PURE__ */ new Set());
     setShowSolutions(false);
   };
-  (0, import_react10.useEffect)(() => {
+  (0, import_react15.useEffect)(() => {
     reset();
   }, [checkId, props.text, props.correctWords.join("\0")]);
-  const selectableIndices = (0, import_react10.useMemo)(() => {
+  const selectableIndices = (0, import_react15.useMemo)(() => {
     const indices = [];
     tokens.forEach((t, i) => {
       if (!/^\s+$/.test(t) && correctSet.has(t.toLowerCase())) indices.push(i);
@@ -1560,11 +2046,11 @@ function MarkTheWordsInner(props, ref) {
   const maxScore = selectableIndices.length;
   const score = allMarked ? maxScore : marked.size;
   const passedThreshold = meetsPassingThreshold(score, maxScore || 1, props.passingScore);
-  const handle = (0, import_react10.useMemo)(() => {
-    const handleMax = maxScore || 1;
-    return {
+  const handle = (0, import_react15.useMemo)(
+    () => buildAssessmentHandle({
+      checkId,
       getScore: () => score,
-      getMaxScore: () => handleMax,
+      getMaxScore: () => maxScore || 1,
       getAnswerGiven: () => marked.size > 0,
       resetTask: reset,
       showSolutions: () => setShowSolutions(true),
@@ -1574,12 +2060,22 @@ function MarkTheWordsInner(props, ref) {
         response: [...marked].map((i) => tokens[i]),
         correct: passedThreshold,
         score,
-        maxScore: handleMax
-      })
-    };
-  }, [checkId, marked, maxScore, passedThreshold, score, tokens]);
-  (0, import_react10.useImperativeHandle)(ref, () => handle, [handle]);
-  useRegisterAssessmentHandle(checkId, handle);
+        maxScore: maxScore || 1
+      }),
+      getCurrentState: () => ({ marked: [...marked], passed, showSolutions }),
+      resume: (state) => {
+        const raw = state.marked;
+        if (Array.isArray(raw)) setMarked(new Set(raw.filter((i) => typeof i === "number")));
+        readBooleanStateField(state, "passed", (value) => {
+          setPassed(value);
+          completedRef.current = value;
+        });
+        readBooleanStateField(state, "showSolutions", setShowSolutions);
+      }
+    }),
+    [checkId, marked, maxScore, passed, passedThreshold, score, showSolutions, tokens]
+  );
+  useAssessmentHandleRegistration(checkId, handle, ref);
   const toggle = (index) => {
     if (passed && !props.enableRetry) return;
     setMarked((prev) => {
@@ -1589,7 +2085,7 @@ function MarkTheWordsInner(props, ref) {
       return next;
     });
   };
-  (0, import_react10.useEffect)(() => {
+  (0, import_react15.useEffect)(() => {
     if (!hasTargets) {
       if (isDevEnvironment4()) {
         console.warn(
@@ -1607,7 +2103,7 @@ function MarkTheWordsInner(props, ref) {
       interactionType: INTERACTION2,
       question: props.text,
       response: [...marked].map((i) => tokens[i]),
-      correct: true
+      correct: passedThreshold
     });
     assessment.complete({
       checkId,
@@ -1629,20 +2125,20 @@ function MarkTheWordsInner(props, ref) {
     score,
     tokens
   ]);
-  return /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("section", { "aria-label": "Mark the Words", "data-lk-check-id": checkId, children: [
-    !hasTargets ? /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("p", { role: "alert", children: [
+  return /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)("section", { "aria-label": "Mark the Words", "data-lk-check-id": checkId, children: [
+    !hasTargets ? /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)("p", { role: "alert", children: [
       "No words in this sentence match ",
-      /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("code", { children: "correctWords" }),
+      /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("code", { children: "correctWords" }),
       ". Check spelling and capitalization in the source text."
     ] }) : null,
-    /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("p", { id: `${checkId}-hint`, children: "Select the correct words in the sentence." }),
-    /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("p", { "aria-describedby": `${checkId}-hint`, children: tokens.map((token, i) => {
+    /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("p", { id: `${checkId}-hint`, children: "Select the correct words in the sentence." }),
+    /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("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__ */ (0, import_jsx_runtime6.jsx)(import_react10.default.Fragment, { children: token }, i);
+      if (!isTarget) return /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(import_react15.default.Fragment, { children: token }, i);
       const selected = marked.has(i);
       const solution = showSolutions || passed && props.enableSolutionsButton;
-      return /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(
+      return /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(
         "button",
         {
           type: "button",
@@ -1660,57 +2156,69 @@ function MarkTheWordsInner(props, ref) {
         i
       );
     }) }),
-    allMarked ? /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("p", { role: "status", "aria-live": "polite", children: "Correct" }) : null,
-    props.enableRetry && passed ? /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("button", { type: "button", onClick: reset, children: "Try again" }) : null,
-    props.enableSolutionsButton && !showSolutions ? /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("button", { type: "button", onClick: () => setShowSolutions(true), children: "Show solution" }) : null
+    allMarked ? /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("p", { role: "status", "aria-live": "polite", children: "Correct" }) : null,
+    props.enableRetry && passed ? /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("button", { type: "button", onClick: reset, children: "Try again" }) : null,
+    props.enableSolutionsButton && !showSolutions ? /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("button", { type: "button", onClick: () => setShowSolutions(true), children: "Show solution" }) : null
   ] });
 }
-var MarkTheWordsInnerForwarded = (0, import_react10.forwardRef)(MarkTheWordsInner);
-var MarkTheWords = (0, import_react10.forwardRef)(function MarkTheWords2(props, ref) {
-  return /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(AssessmentLessonGuard, { blockLabel: "MarkTheWords", checkId: props.checkId, children: (lessonId) => /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(MarkTheWordsInnerForwarded, { ...props, enclosingLessonId: lessonId, ref }) });
+var MarkTheWordsInnerForwarded = (0, import_react15.forwardRef)(MarkTheWordsInner);
+var MarkTheWords = (0, import_react15.forwardRef)(function MarkTheWords2(props, ref) {
+  return /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(AssessmentLessonGuard, { blockLabel: "MarkTheWords", checkId: props.checkId, children: (lessonId) => /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(MarkTheWordsInnerForwarded, { ...props, enclosingLessonId: lessonId, ref }) });
 });
 
 // src/blocks/FillInTheBlanks.tsx
-var import_react11 = __toESM(require("react"), 1);
-var import_jsx_runtime7 = require("react/jsx-runtime");
-var INTERACTION3 = "fillInBlanks";
-function parseTemplate(template) {
+var import_react16 = __toESM(require("react"), 1);
+
+// src/assessment/internal/parseStarDelimitedTemplate.ts
+function parseStarDelimitedTemplate(template, idPrefix) {
   const parts = [];
-  const blanks = [];
+  const values = [];
   const re = /\*([^*]+)\*/g;
   let last = 0;
   let match;
   let n = 0;
   while ((match = re.exec(template)) !== null) {
     parts.push(template.slice(last, match.index));
-    const id = `blank-${n++}`;
-    blanks.push({ id, answer: match[1].trim() });
-    parts.push(id);
+    values.push(match[1].trim());
+    parts.push(`${idPrefix}-${n++}`);
     last = match.index + match[0].length;
   }
   parts.push(template.slice(last));
-  return { parts, blanks };
+  return { parts, values };
+}
+
+// src/blocks/FillInTheBlanks.tsx
+var import_jsx_runtime10 = require("react/jsx-runtime");
+var INTERACTION3 = "fillInBlanks";
+function parseTemplate(template) {
+  const { parts, values } = parseStarDelimitedTemplate(template, "blank");
+  return {
+    parts,
+    blanks: values.map((answer, i) => ({ id: `blank-${i}`, answer }))
+  };
 }
 function FillInTheBlanksInner(props, ref) {
-  const checkId = (0, import_react11.useMemo)(() => normalizeComponentId(props.checkId, "checkId"), [props.checkId]);
+  const checkId = (0, import_react16.useMemo)(() => normalizeComponentId(props.checkId, "checkId"), [props.checkId]);
   const assessment = useAssessmentState(props.enclosingLessonId);
-  const parsed = (0, import_react11.useMemo)(() => parseTemplate(props.template), [props.template]);
+  const parsed = (0, import_react16.useMemo)(() => parseTemplate(props.template), [props.template]);
   const blanks = props.blanks ?? parsed.blanks;
-  const [values, setValues] = (0, import_react11.useState)(
+  const [values, setValues] = (0, import_react16.useState)(
     () => Object.fromEntries(blanks.map((b) => [b.id, ""]))
   );
-  const [passed, setPassed] = (0, import_react11.useState)(false);
-  const [showSolutions, setShowSolutions] = (0, import_react11.useState)(false);
-  const completedRef = (0, import_react11.useRef)(false);
-  const answeredRef = (0, import_react11.useRef)(false);
+  const [passed, setPassed] = (0, import_react16.useState)(false);
+  const [showSolutions, setShowSolutions] = (0, import_react16.useState)(false);
+  const [submitted, setSubmitted] = (0, import_react16.useState)(false);
+  const completedRef = (0, import_react16.useRef)(false);
+  const answeredRef = (0, import_react16.useRef)(false);
   const reset = () => {
     completedRef.current = false;
     answeredRef.current = false;
     setPassed(false);
     setValues(Object.fromEntries(blanks.map((b) => [b.id, ""])));
     setShowSolutions(false);
+    setSubmitted(false);
   };
-  (0, import_react11.useEffect)(() => {
+  (0, import_react16.useEffect)(() => {
     reset();
   }, [checkId, props.template, blanks.map((b) => b.answer).join("\0")]);
   const hasBlanks = blanks.length > 0;
@@ -1721,11 +2229,11 @@ function FillInTheBlanksInner(props, ref) {
   });
   const maxScore = blanks.length;
   const passedThreshold = meetsPassingThreshold(score, maxScore || 1, props.passingScore);
-  const handle = (0, import_react11.useMemo)(() => {
-    const handleMax = maxScore || 1;
-    return {
+  const handle = (0, import_react16.useMemo)(
+    () => buildAssessmentHandle({
+      checkId,
       getScore: () => score,
-      getMaxScore: () => handleMax,
+      getMaxScore: () => maxScore || 1,
       getAnswerGiven: () => allFilled,
       resetTask: reset,
       showSolutions: () => setShowSolutions(true),
@@ -1735,12 +2243,27 @@ function FillInTheBlanksInner(props, ref) {
         response: values,
         correct: passedThreshold,
         score,
-        maxScore: handleMax
-      })
-    };
-  }, [allFilled, blanks.length, checkId, maxScore, passedThreshold, score, values]);
-  (0, import_react11.useImperativeHandle)(ref, () => handle, [handle]);
-  useRegisterAssessmentHandle(checkId, handle);
+        maxScore: maxScore || 1
+      }),
+      getCurrentState: () => ({ values, passed, showSolutions, submitted }),
+      resume: (state) => {
+        const raw = state.values;
+        if (raw && typeof raw === "object") setValues({ ...raw });
+        readBooleanStateField(state, "passed", (value) => {
+          setPassed(value);
+          completedRef.current = value;
+          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, submitted, values]
+  );
+  useAssessmentHandleRegistration(checkId, handle, ref);
   const check = () => {
     if (!hasBlanks) {
       if (isDevEnvironment4()) {
@@ -1749,16 +2272,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);
@@ -1771,20 +2294,23 @@ function FillInTheBlanksInner(props, ref) {
       });
     }
   };
-  (0, import_react11.useEffect)(() => {
-    if (!allFilled) answeredRef.current = false;
+  (0, import_react16.useEffect)(() => {
+    if (!allFilled) {
+      answeredRef.current = false;
+      setSubmitted(false);
+    }
   }, [allFilled]);
-  (0, import_react11.useEffect)(() => {
+  (0, import_react16.useEffect)(() => {
     if (props.autoCheck && allFilled) check();
   }, [allFilled, props.autoCheck, values, passedThreshold]);
   const reveal = showSolutions || passed && props.enableSolutionsButton;
-  return /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("section", { "aria-label": "Fill in the Blanks", "data-lk-check-id": checkId, children: [
-    /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("p", { children: parsed.parts.map((part, i) => {
+  return /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)("section", { "aria-label": "Fill in the Blanks", "data-lk-check-id": checkId, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("p", { children: parsed.parts.map((part, i) => {
       const blank = blanks.find((b) => b.id === part);
-      if (!blank) return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(import_react11.default.Fragment, { children: part }, i);
-      return /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("label", { style: { margin: "0 0.25em" }, children: [
-        /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("span", { className: "lk-visually-hidden", children: blank.answer }),
-        /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
+      if (!blank) return /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(import_react16.default.Fragment, { children: part }, i);
+      return /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)("label", { style: { margin: "0 0.25em" }, children: [
+        /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("span", { className: "lk-visually-hidden", children: blank.answer }),
+        /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(
           "input",
           {
             type: "text",
@@ -1800,61 +2326,51 @@ function FillInTheBlanksInner(props, ref) {
         )
       ] }, blank.id);
     }) }),
-    !props.autoCheck ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("button", { type: "button", "data-testid": "check-blanks", disabled: !allFilled || passed, onClick: check, children: "Check" }) : null,
-    !hasBlanks ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("p", { role: "alert", children: "This activity has no blanks. Add text wrapped in asterisks, e.g. The *answer* here." }) : null,
-    allFilled ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("p", { role: "status", "aria-live": "polite", children: passed || passedThreshold ? "Correct" : "Try again" }) : null,
-    props.enableRetry && passed ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("button", { type: "button", onClick: reset, children: "Try again" }) : null,
-    props.enableSolutionsButton && !reveal ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("button", { type: "button", onClick: () => setShowSolutions(true), children: "Show solution" }) : null
+    !props.autoCheck ? /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("button", { type: "button", "data-testid": "check-blanks", disabled: !allFilled || passed, onClick: check, children: "Check" }) : null,
+    !hasBlanks ? /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("p", { role: "alert", children: "This activity has no blanks. Add text wrapped in asterisks, e.g. The *answer* here." }) : null,
+    submitted ? /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("p", { role: "status", "aria-live": "polite", children: passed || passedThreshold ? "Correct" : "Try again" }) : null,
+    props.enableRetry && passed ? /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("button", { type: "button", onClick: reset, children: "Try again" }) : null,
+    props.enableSolutionsButton && !reveal ? /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("button", { type: "button", onClick: () => setShowSolutions(true), children: "Show solution" }) : null
   ] });
 }
-var FillInTheBlanksInnerForwarded = (0, import_react11.forwardRef)(FillInTheBlanksInner);
-var FillInTheBlanks = (0, import_react11.forwardRef)(
+var FillInTheBlanksInnerForwarded = (0, import_react16.forwardRef)(FillInTheBlanksInner);
+var FillInTheBlanks = (0, import_react16.forwardRef)(
   function FillInTheBlanks2(props, ref) {
-    return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(AssessmentLessonGuard, { blockLabel: "FillInTheBlanks", checkId: props.checkId, children: (lessonId) => /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(FillInTheBlanksInnerForwarded, { ...props, enclosingLessonId: lessonId, ref }) });
+    return /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(AssessmentLessonGuard, { blockLabel: "FillInTheBlanks", checkId: props.checkId, children: (lessonId) => /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(FillInTheBlanksInnerForwarded, { ...props, enclosingLessonId: lessonId, ref }) });
   }
 );
 
 // src/blocks/DragTheWords.tsx
-var import_react12 = __toESM(require("react"), 1);
-var import_jsx_runtime8 = require("react/jsx-runtime");
+var import_react17 = __toESM(require("react"), 1);
+var import_jsx_runtime11 = require("react/jsx-runtime");
 var INTERACTION4 = "dragTheWords";
 function parseZones(template) {
-  const parts = [];
-  const answers = [];
-  const re = /\*([^*]+)\*/g;
-  let last = 0;
-  let match;
-  let n = 0;
-  while ((match = re.exec(template)) !== null) {
-    parts.push(template.slice(last, match.index));
-    answers.push(match[1].trim());
-    parts.push(`zone-${n++}`);
-    last = match.index + match[0].length;
-  }
-  parts.push(template.slice(last));
-  return { parts, answers };
+  const { parts, values } = parseStarDelimitedTemplate(template, "zone");
+  return { parts, answers: values };
 }
 function DragTheWordsInner(props, ref) {
-  const checkId = (0, import_react12.useMemo)(() => normalizeComponentId(props.checkId, "checkId"), [props.checkId]);
+  const checkId = (0, import_react17.useMemo)(() => normalizeComponentId(props.checkId, "checkId"), [props.checkId]);
   const assessment = useAssessmentState(props.enclosingLessonId);
-  const { parts, answers } = (0, import_react12.useMemo)(() => parseZones(props.template), [props.template]);
-  const [zones, setZones] = (0, import_react12.useState)(
+  const { parts, answers } = (0, import_react17.useMemo)(() => parseZones(props.template), [props.template]);
+  const [zones, setZones] = (0, import_react17.useState)(
     () => Object.fromEntries(answers.map((_, i) => [`zone-${i}`, ""]))
   );
-  const [pool, setPool] = (0, import_react12.useState)(() => [...props.words]);
-  const [keyboardWord, setKeyboardWord] = (0, import_react12.useState)(null);
-  const [passed, setPassed] = (0, import_react12.useState)(false);
-  const completedRef = (0, import_react12.useRef)(false);
-  const answeredRef = (0, import_react12.useRef)(false);
+  const [pool, setPool] = (0, import_react17.useState)(() => [...props.words]);
+  const [keyboardWord, setKeyboardWord] = (0, import_react17.useState)(null);
+  const [passed, setPassed] = (0, import_react17.useState)(false);
+  const [submitted, setSubmitted] = (0, import_react17.useState)(false);
+  const completedRef = (0, import_react17.useRef)(false);
+  const answeredRef = (0, import_react17.useRef)(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);
   };
-  (0, import_react12.useEffect)(() => {
+  (0, import_react17.useEffect)(() => {
     reset();
   }, [checkId, props.template, props.words.join("\0")]);
   const hasZones = answers.length > 0;
@@ -1865,11 +2381,11 @@ function DragTheWordsInner(props, ref) {
   });
   const maxScore = answers.length;
   const passedThreshold = meetsPassingThreshold(score, maxScore || 1, props.passingScore);
-  const handle = (0, import_react12.useMemo)(() => {
-    const handleMax = maxScore || 1;
-    return {
+  const handle = (0, import_react17.useMemo)(
+    () => buildAssessmentHandle({
+      checkId,
       getScore: () => score,
-      getMaxScore: () => handleMax,
+      getMaxScore: () => maxScore || 1,
       getAnswerGiven: () => allFilled,
       resetTask: reset,
       showSolutions: () => {
@@ -1880,12 +2396,29 @@ function DragTheWordsInner(props, ref) {
         response: zones,
         correct: passedThreshold,
         score,
-        maxScore: handleMax
-      })
-    };
-  }, [allFilled, answers.length, checkId, maxScore, passedThreshold, score, zones]);
-  (0, import_react12.useImperativeHandle)(ref, () => handle, [handle]);
-  useRegisterAssessmentHandle(checkId, handle);
+        maxScore: maxScore || 1
+      }),
+      getCurrentState: () => ({ zones, pool, passed, keyboardWord, submitted }),
+      resume: (state) => {
+        const rawZones = state.zones;
+        if (rawZones && typeof rawZones === "object") setZones({ ...rawZones });
+        if (Array.isArray(state.pool)) setPool([...state.pool]);
+        readBooleanStateField(state, "passed", (value) => {
+          setPassed(value);
+          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, submitted, zones]
+  );
+  useAssessmentHandleRegistration(checkId, handle, ref);
   const placeInZone = (zoneId, word) => {
     if (passed && !props.enableRetry) return;
     const prev = zones[zoneId];
@@ -1913,16 +2446,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);
@@ -1935,15 +2468,18 @@ function DragTheWordsInner(props, ref) {
       });
     }
   };
-  (0, import_react12.useEffect)(() => {
-    if (!allFilled) answeredRef.current = false;
+  (0, import_react17.useEffect)(() => {
+    if (!allFilled) {
+      answeredRef.current = false;
+      setSubmitted(false);
+    }
   }, [allFilled]);
-  (0, import_react12.useEffect)(() => {
+  (0, import_react17.useEffect)(() => {
     if (props.autoCheck && allFilled) check();
   }, [allFilled, props.autoCheck, zones, passedThreshold]);
-  return /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)("section", { "aria-label": "Drag the Words", "data-lk-check-id": checkId, children: [
-    /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("p", { children: "Drag words into the blanks (or select a word, then activate a blank)." }),
-    /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("div", { role: "list", "aria-label": "Word bank", "data-testid": "word-bank", children: pool.map((word) => /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(
+  return /* @__PURE__ */ (0, import_jsx_runtime11.jsxs)("section", { "aria-label": "Drag the Words", "data-lk-check-id": checkId, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime11.jsx)("p", { children: "Drag words into the blanks (or select a word, then activate a blank)." }),
+    /* @__PURE__ */ (0, import_jsx_runtime11.jsx)("div", { role: "list", "aria-label": "Word bank", "data-testid": "word-bank", children: pool.map((word) => /* @__PURE__ */ (0, import_jsx_runtime11.jsx)(
       "button",
       {
         type: "button",
@@ -1957,9 +2493,9 @@ function DragTheWordsInner(props, ref) {
       },
       word
     )) }),
-    /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("p", { children: parts.map((part, i) => {
-      if (!part.startsWith("zone-")) return /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(import_react12.default.Fragment, { children: part }, i);
-      return /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(
+    /* @__PURE__ */ (0, import_jsx_runtime11.jsx)("p", { children: parts.map((part, i) => {
+      if (!part.startsWith("zone-")) return /* @__PURE__ */ (0, import_jsx_runtime11.jsx)(import_react17.default.Fragment, { children: part }, i);
+      return /* @__PURE__ */ (0, import_jsx_runtime11.jsx)(
         "span",
         {
           role: "button",
@@ -1972,220 +2508,1598 @@ function DragTheWordsInner(props, ref) {
             if (e.key === "Enter" && keyboardWord) placeInZone(part, keyboardWord);
           },
           style: {
-            display: "inline-block",
-            minWidth: "6em",
-            border: "1px dashed currentColor",
-            padding: "0.2em 0.5em",
-            margin: "0 0.2em"
+            display: "inline-block",
+            minWidth: "6em",
+            border: "1px dashed currentColor",
+            padding: "0.2em 0.5em",
+            margin: "0 0.2em"
+          },
+          children: zones[part] || "___"
+        },
+        part
+      );
+    }) }),
+    /* @__PURE__ */ (0, import_jsx_runtime11.jsx)("button", { type: "button", "data-testid": "check-drag-words", disabled: !allFilled || passed, onClick: check, children: "Check" }),
+    !hasZones ? /* @__PURE__ */ (0, import_jsx_runtime11.jsx)("p", { role: "alert", children: "This activity has no drop zones. Wrap answers in asterisks in the template." }) : null,
+    submitted ? /* @__PURE__ */ (0, import_jsx_runtime11.jsx)("p", { role: "status", "aria-live": "polite", children: passed || passedThreshold ? "Correct" : "Try again" }) : null
+  ] });
+}
+var DragTheWordsInnerForwarded = (0, import_react17.forwardRef)(DragTheWordsInner);
+var DragTheWords = (0, import_react17.forwardRef)(function DragTheWords2(props, ref) {
+  return /* @__PURE__ */ (0, import_jsx_runtime11.jsx)(AssessmentLessonGuard, { blockLabel: "DragTheWords", checkId: props.checkId, children: (lessonId) => /* @__PURE__ */ (0, import_jsx_runtime11.jsx)(DragTheWordsInnerForwarded, { ...props, enclosingLessonId: lessonId, ref }) });
+});
+
+// src/blocks/DragAndDrop.tsx
+var import_react18 = require("react");
+var import_jsx_runtime12 = require("react/jsx-runtime");
+var INTERACTION5 = "dragAndDrop";
+function DragAndDropInner(props, ref) {
+  const checkId = (0, import_react18.useMemo)(() => normalizeComponentId(props.checkId, "checkId"), [props.checkId]);
+  const assessment = useAssessmentState(props.enclosingLessonId);
+  const [assignments, setAssignments] = (0, import_react18.useState)(
+    () => Object.fromEntries(props.targets.map((t) => [t.id, ""]))
+  );
+  const [pool, setPool] = (0, import_react18.useState)(() => props.items.map((i) => i.id));
+  const [keyboardItem, setKeyboardItem] = (0, import_react18.useState)(null);
+  const [passed, setPassed] = (0, import_react18.useState)(false);
+  const [checked, setChecked] = (0, import_react18.useState)(false);
+  const completedRef = (0, import_react18.useRef)(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);
+  };
+  (0, import_react18.useEffect)(() => {
+    reset();
+  }, [checkId, props.items.map((i) => i.id).join(","), props.targets.map((t) => t.id).join(",")]);
+  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 = (0, import_react18.useMemo)(() => {
+    return buildAssessmentHandle({
+      checkId,
+      getScore: () => score,
+      getMaxScore: () => maxScore,
+      getAnswerGiven: () => hasTargets && allFilled,
+      resetTask: reset,
+      showSolutions: () => {
+      },
+      getXAPIData: () => ({
+        checkId,
+        interactionType: INTERACTION5,
+        response: assignments,
+        correct: passedThreshold,
+        score,
+        maxScore
+      }),
+      getCurrentState: () => ({ assignments, pool, passed, checked, keyboardItem }),
+      resume: (state) => {
+        const rawAssignments = state.assignments;
+        if (rawAssignments && typeof rawAssignments === "object") {
+          setAssignments({ ...rawAssignments });
+        }
+        if (Array.isArray(state.pool)) setPool([...state.pool]);
+        readBooleanStateField(state, "passed", (value) => {
+          setPassed(value);
+          completedRef.current = value;
+        });
+        readBooleanStateField(state, "checked", setChecked);
+        const item = state.keyboardItem;
+        if (item === null || typeof item === "string") setKeyboardItem(item ?? null);
+      }
+    });
+  }, [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) => {
+      const next = p.filter((id) => id !== itemId);
+      if (prev) next.push(prev);
+      return next;
+    });
+    setKeyboardItem(null);
+  };
+  const check = () => {
+    if (!allFilled) return;
+    setChecked(true);
+    assessment.answer({
+      checkId,
+      interactionType: INTERACTION5,
+      response: assignments,
+      correct: passedThreshold
+    });
+    if (passedThreshold && !completedRef.current) {
+      completedRef.current = true;
+      setPassed(true);
+      assessment.complete({
+        checkId,
+        interactionType: INTERACTION5,
+        score,
+        maxScore,
+        passingScore: props.passingScore ?? maxScore
+      });
+    }
+  };
+  return /* @__PURE__ */ (0, import_jsx_runtime12.jsxs)("section", { "aria-label": "Drag and Drop", "data-lk-check-id": checkId, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime12.jsx)("p", { children: "Match each item to the correct target (drag or use keyboard: select item, then activate target)." }),
+    /* @__PURE__ */ (0, import_jsx_runtime12.jsx)("div", { role: "list", "aria-label": "Draggable items", children: pool.flatMap((id) => {
+      const item = props.items.find((i) => i.id === id);
+      if (!item) return [];
+      return /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(
+        "button",
+        {
+          type: "button",
+          draggable: true,
+          "data-testid": `drag-item-${id}`,
+          "aria-pressed": keyboardItem === id,
+          onDragStart: (e) => e.dataTransfer.setData("text/plain", id),
+          onClick: () => setKeyboardItem(keyboardItem === id ? null : id),
+          style: { margin: "0.25rem" },
+          children: item.label
+        },
+        id
+      );
+    }) }),
+    /* @__PURE__ */ (0, import_jsx_runtime12.jsx)("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__ */ (0, import_jsx_runtime12.jsxs)("li", { children: [
+        /* @__PURE__ */ (0, import_jsx_runtime12.jsx)("strong", { children: target.label }),
+        " ",
+        /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(
+          "span",
+          {
+            role: "button",
+            tabIndex: 0,
+            "data-testid": `drop-${target.id}`,
+            onDragOver: (e) => e.preventDefault(),
+            onDrop: (e) => {
+              e.preventDefault();
+              const id = e.dataTransfer.getData("text/plain");
+              if (id) place(target.id, id);
+            },
+            onClick: () => keyboardItem && place(target.id, keyboardItem),
+            onKeyDown: (e) => {
+              if (e.key === "Enter" && keyboardItem) place(target.id, keyboardItem);
+            },
+            style: {
+              display: "inline-block",
+              minWidth: "8em",
+              border: "1px dashed currentColor",
+              padding: "0.25em"
+            },
+            children: label
+          }
+        )
+      ] }, target.id);
+    }) }),
+    /* @__PURE__ */ (0, import_jsx_runtime12.jsx)("button", { type: "button", "data-testid": "check-drag-drop", disabled: !hasTargets || !allFilled || passed, onClick: check, children: "Check" }),
+    checked ? /* @__PURE__ */ (0, import_jsx_runtime12.jsx)("p", { role: "status", "aria-live": "polite", children: passedThreshold ? "Correct" : "Try again" }) : null
+  ] });
+}
+var DragAndDropInnerForwarded = (0, import_react18.forwardRef)(DragAndDropInner);
+var DragAndDrop = (0, import_react18.forwardRef)(function DragAndDrop2(props, ref) {
+  return /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(AssessmentLessonGuard, { blockLabel: "DragAndDrop", checkId: props.checkId, children: (lessonId) => /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(DragAndDropInnerForwarded, { ...props, enclosingLessonId: lessonId, ref }) });
+});
+
+// src/blocks/AssessmentSequence.tsx
+var import_react24 = __toESM(require("react"), 1);
+var import_core17 = require("@lessonkit/core");
+
+// src/compound/useCompoundShell.ts
+var import_react22 = require("react");
+var import_core15 = require("@lessonkit/core");
+
+// src/compound/useCompoundNavigation.ts
+var import_react19 = require("react");
+function useCompoundNavigation(pageCount, index, setIndex) {
+  const goNext = (0, import_react19.useCallback)(() => {
+    if (pageCount < 1) return;
+    setIndex((i) => Math.min(i + 1, pageCount - 1));
+  }, [pageCount, setIndex]);
+  const goPrev = (0, import_react19.useCallback)(() => {
+    setIndex((i) => Math.max(i - 1, 0));
+  }, [setIndex]);
+  const clampedIndex = pageCount < 1 ? 0 : Math.min(index, pageCount - 1);
+  return {
+    index: clampedIndex,
+    setIndex,
+    goNext,
+    goPrev,
+    progress: { current: pageCount < 1 ? 0 : clampedIndex + 1, total: pageCount }
+  };
+}
+
+// src/compound/useCompoundPersistence.ts
+var import_react21 = require("react");
+var import_core14 = require("@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
+var import_react20 = require("react");
+var import_core12 = require("@lessonkit/core");
+var import_core13 = require("@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 lessonkitCtx = (0, import_react20.useContext)(LessonkitContext);
+  const storageRef = (0, import_react20.useRef)(opts.storage ?? lessonkitCtx?.storage ?? (0, import_core13.createSessionStoragePort)());
+  const resumedRef = (0, import_react20.useRef)(false);
+  const resumeKeyRef = (0, import_react20.useRef)("");
+  const prevEnabledRef = (0, import_react20.useRef)(opts.enabled);
+  (0, import_react20.useEffect)(() => {
+    storageRef.current = opts.storage ?? lessonkitCtx?.storage ?? (0, import_core13.createSessionStoragePort)();
+  }, [opts.storage, lessonkitCtx?.storage]);
+  (0, import_react20.useEffect)(() => {
+    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 = (0, import_core12.loadCompoundState)(storageRef.current, opts.courseId, opts.compoundId);
+    if (saved) {
+      resumedRef.current = true;
+      opts.onResume?.(saved);
+    }
+  }, [opts.enabled, opts.courseId, opts.compoundId, opts.onResume]);
+  return (0, import_react20.useCallback)(
+    (state) => {
+      if (!opts.enabled || !opts.courseId) return;
+      const persisted = (0, import_core12.saveCompoundState)(storageRef.current, opts.courseId, opts.compoundId, state);
+      if (!persisted) warnCompoundPersistFailure();
+    },
+    [opts.enabled, opts.courseId, opts.compoundId]
+  );
+}
+
+// src/compound/useCompoundPersistence.ts
+function readCompoundInitialIndex(courseId, compoundId, pageCount, enabled, storage = (0, import_core14.createSessionStoragePort)()) {
+  if (!enabled || !courseId || pageCount < 1) return 0;
+  const saved = (0, import_core14.loadCompoundState)(storage, courseId, compoundId);
+  if (!saved) return 0;
+  return (0, import_core14.clampCompoundPageIndex)(saved.activePageIndex, pageCount);
+}
+function stripOrphanChildStates(handles, childStates) {
+  return filterRegisteredChildStates(handles, childStates);
+}
+function useCompoundPersistence(opts) {
+  const lessonkitCtx = (0, import_react21.useContext)(LessonkitContext);
+  const storage = opts.storage ?? lessonkitCtx?.storage ?? (0, import_core14.createSessionStoragePort)();
+  const ctx = useCompoundRegistry();
+  const handlesVersion = useCompoundHandlesVersion();
+  const bridgeRef = useCompoundHydrationBridgeRef();
+  const pendingChildResumeRef = (0, import_react21.useRef)(null);
+  const resumedChildKeysRef = (0, import_react21.useRef)(/* @__PURE__ */ new Set());
+  const loadedChildStatesRef = (0, import_react21.useRef)({});
+  const skipSaveUntilHydratedRef = (0, import_react21.useRef)(false);
+  const hydrationKeyRef = (0, import_react21.useRef)("");
+  const hydrationInitRef = (0, import_react21.useRef)(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 = (0, import_core14.loadCompoundState)(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 = (0, import_react21.useCallback)(() => {
+    const childStates = {
+      ...loadedChildStatesRef.current
+    };
+    if (ctx) {
+      for (const [checkId, entry] of ctx.getRegisteredHandles()) {
+        const handle = entry.handle;
+        if (handle.getCurrentState) {
+          childStates[checkId] = handle.getCurrentState();
+          delete loadedChildStatesRef.current[checkId];
+        }
+      }
+    }
+    return (0, import_core14.createCompoundResumeState)({
+      activePageIndex: (0, import_core14.clampCompoundPageIndex)(opts.index, opts.pageCount),
+      childStates
+    });
+  }, [ctx, opts.index, opts.pageCount]);
+  const buildStateRef = (0, import_react21.useRef)(buildState);
+  buildStateRef.current = buildState;
+  const finalizeHydration = (0, import_react21.useCallback)(
+    (childStates) => {
+      loadedChildStatesRef.current = {
+        ...loadedChildStatesRef.current,
+        ...childStates
+      };
+      skipSaveUntilHydratedRef.current = false;
+      pendingChildResumeRef.current = null;
+    },
+    []
+  );
+  const applyPendingChildResume = (0, import_react21.useCallback)(() => {
+    const pending = pendingChildResumeRef.current;
+    if (!pending || !ctx) return;
+    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,
+    enabled: opts.enabled,
+    storage,
+    onResume: (state) => {
+      const clamped = (0, import_core14.clampCompoundPageIndex)(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());
+    }
+  });
+  const persistNow = (0, import_react21.useCallback)(() => {
+    if (!opts.enabled || !opts.courseId) return;
+    saveResume(buildStateRef.current());
+  }, [opts.enabled, opts.courseId, saveResume]);
+  const notifyImperativeResume = (0, import_react21.useCallback)(
+    (state) => {
+      const clamped = (0, import_core14.clampCompoundPageIndex)(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]
+  );
+  (0, import_react21.useEffect)(() => {
+    if (!bridgeRef) return;
+    bridgeRef.current = { notifyImperativeResume };
+    return () => {
+      if (bridgeRef.current?.notifyImperativeResume === notifyImperativeResume) {
+        bridgeRef.current = null;
+      }
+    };
+  }, [bridgeRef, notifyImperativeResume]);
+  (0, import_react21.useEffect)(() => {
+    persistNow();
+  }, [persistNow, opts.index, opts.pageCount, handlesVersion]);
+  (0, import_react21.useEffect)(() => {
+    applyPendingChildResume();
+  }, [opts.index, handlesVersion, applyPendingChildResume]);
+  (0, import_react21.useEffect)(() => {
+    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
+function useCompoundShell(opts) {
+  const ctx = useCompoundRegistry();
+  useCompoundPersistence({
+    courseId: opts.courseId,
+    compoundId: opts.compoundId,
+    pageCount: opts.pageCount,
+    index: opts.index,
+    setIndex: opts.setIndex,
+    enabled: opts.persistEnabled,
+    storage: opts.storage
+  });
+  const { goNext, goPrev, progress } = useCompoundNavigation(opts.pageCount, opts.index, opts.setIndex);
+  const visibleIndex = (0, import_core15.clampCompoundPageIndex)(opts.index, opts.pageCount);
+  useCompoundHandleRef(opts.ref, {
+    activePageIndex: visibleIndex,
+    setActivePageIndex: opts.setIndex,
+    getHandles: () => ctx?.getHandles() ?? /* @__PURE__ */ new Map(),
+    getRegisteredHandles: () => ctx?.getRegisteredHandles() ?? /* @__PURE__ */ new Map(),
+    pageCount: opts.pageCount,
+    enableSolutionsButton: opts.enableSolutionsButton
+  });
+  return { visibleIndex, goNext, goPrev, progress, ctx };
+}
+function useCompoundInitialIndex(opts) {
+  return (0, import_react22.useMemo)(
+    () => readCompoundInitialIndex(
+      opts.courseId,
+      opts.compoundId,
+      opts.pageCount,
+      opts.persistEnabled,
+      opts.storage
+    ),
+    [opts.courseId, opts.compoundId, opts.pageCount, opts.persistEnabled, opts.storage]
+  );
+}
+
+// src/compound/validateChildren.ts
+var import_react23 = __toESM(require("react"), 1);
+var import_core16 = require("@lessonkit/core");
+
+// src/compound/blockType.ts
+var LESSONKIT_BLOCK_TYPE = /* @__PURE__ */ Symbol.for("lessonkit.blockType");
+function setLessonkitBlockType(component, blockType) {
+  component[LESSONKIT_BLOCK_TYPE] = blockType;
+  if (!component.displayName) {
+    component.displayName = blockType;
+  }
+  return component;
+}
+function getLessonkitBlockType(component) {
+  if (!component || typeof component !== "object" && typeof component !== "function") {
+    return void 0;
+  }
+  const typed = component;
+  return typed[LESSONKIT_BLOCK_TYPE] ?? typed.displayName;
+}
+
+// src/compound/validateChildren.ts
+var warnedPairs = /* @__PURE__ */ new Set();
+var COMPOUND_CONTAINER_TYPES = /* @__PURE__ */ new Set([
+  "Page",
+  "InteractiveBook",
+  "Slide",
+  "SlideDeck",
+  "AssessmentSequence"
+]);
+function warnOrThrow(msg, strict) {
+  if (strict) throw new Error(msg);
+  if (!warnedPairs.has(msg)) {
+    warnedPairs.add(msg);
+    console.warn(msg);
+  }
+}
+function validateNode(parent, node, depth, strict) {
+  import_react23.default.Children.forEach(node, (child) => {
+    if (!import_react23.default.isValidElement(child)) return;
+    const blockType = getLessonkitBlockType(child.type);
+    if (!blockType) {
+      if (child.props && typeof child.props === "object" && "children" in child.props) {
+        validateNode(parent, child.props.children, depth, strict);
+      }
+      return;
+    }
+    if (!(0, import_core16.isChildTypeAllowed)(parent, blockType)) {
+      const key = `${parent}:${blockType}`;
+      if (!warnedPairs.has(key)) {
+        warnedPairs.add(key);
+        const msg = `[lessonkit] Block "${blockType}" is not in the allowlist for "${parent}"`;
+        if (strict) throw new Error(msg);
+        console.warn(msg);
+      }
+    }
+    if (COMPOUND_CONTAINER_TYPES.has(blockType)) {
+      const maxDepth = import_core16.COMPOUND_MAX_NESTING_DEPTH[parent];
+      if (depth >= maxDepth) {
+        warnOrThrow(
+          `[lessonkit] Block "${blockType}" exceeds max nesting depth (${maxDepth}) for "${parent}"`,
+          strict
+        );
+      }
+      const nestedParent = blockType;
+      validateNode(nestedParent, child.props.children, depth + 1, strict);
+    } else if (blockType === "Accordion") {
+      const sections = child.props.sections;
+      if (sections) validateAccordionSections(sections, strict);
+    } else if (child.props && typeof child.props === "object" && "children" in child.props) {
+      validateSubtreeForForbidden(
+        child.props.children,
+        import_core16.ACCORDION_FORBIDDEN_CHILD_TYPES,
+        strict
+      );
+    }
+  });
+}
+function validateSubtreeForForbidden(node, forbidden, strict) {
+  import_react23.default.Children.forEach(node, (child) => {
+    if (!import_react23.default.isValidElement(child)) return;
+    const blockType = getLessonkitBlockType(child.type);
+    if (blockType && forbidden.includes(blockType)) {
+      warnOrThrow(`[lessonkit] Block "${blockType}" must not nest inside Accordion`, strict);
+    }
+    if (blockType === "Accordion") {
+      const sections = child.props.sections;
+      if (sections) validateAccordionSections(sections, strict);
+      return;
+    }
+    if (child.props && typeof child.props === "object" && "children" in child.props) {
+      validateSubtreeForForbidden(
+        child.props.children,
+        forbidden,
+        strict
+      );
+    }
+  });
+}
+function validateAccordionSections(sections, strict) {
+  if (!isDevEnvironment4() && !strict) return;
+  for (const section of sections) {
+    validateSubtreeForForbidden(section.content, import_core16.ACCORDION_FORBIDDEN_CHILD_TYPES, strict);
+  }
+}
+function validateCompoundChildren(parent, children, strict) {
+  if (!isDevEnvironment4() && !strict) return;
+  validateNode(parent, children, 0, strict);
+}
+
+// src/compound/warnPersistence.ts
+var DEFAULT_ASSESSMENT_SEQUENCE_COMPOUND_ID = "assessment-sequence";
+function warnSharedCompoundStorageKey(opts) {
+  if (!opts.persistEnabled || opts.hasExplicitBlockId || !isDevEnvironment4()) return;
+  console.warn(
+    `[lessonkit] <${opts.componentName}> without blockId shares one sessionStorage key when persistCompoundState is enabled; set a unique blockId per instance.`
+  );
+}
+
+// src/blocks/AssessmentSequence.tsx
+var import_jsx_runtime13 = require("react/jsx-runtime");
+var AssessmentSequenceInner = (0, import_react24.forwardRef)(
+  function AssessmentSequenceInner2(props, ref) {
+    const { compoundId, childArray, index, setIndex, persistEnabled } = props;
+    const sequential = props.sequential !== false;
+    const { config } = useLessonkit();
+    const { visibleIndex, goNext, goPrev, progress } = useCompoundShell({
+      courseId: config.courseId,
+      compoundId,
+      pageCount: childArray.length,
+      index,
+      setIndex,
+      persistEnabled,
+      ref,
+      enableSolutionsButton: props.enableSolutionsButton
+    });
+    validateCompoundChildren("AssessmentSequence", props.children);
+    if (!sequential) {
+      return /* @__PURE__ */ (0, import_jsx_runtime13.jsx)("section", { "aria-label": "Assessment sequence", "data-testid": "assessment-sequence", children: props.children });
+    }
+    return /* @__PURE__ */ (0, import_jsx_runtime13.jsxs)("section", { "aria-label": "Assessment sequence", "data-testid": "assessment-sequence", children: [
+      /* @__PURE__ */ (0, import_jsx_runtime13.jsxs)("p", { children: [
+        "Question ",
+        progress.current,
+        " of ",
+        progress.total
+      ] }),
+      /* @__PURE__ */ (0, import_jsx_runtime13.jsx)("div", { "data-testid": "assessment-sequence-step", children: childArray.map((child, i) => /* @__PURE__ */ (0, import_jsx_runtime13.jsx)("div", { hidden: i !== visibleIndex, children: /* @__PURE__ */ (0, import_jsx_runtime13.jsx)(CompoundPageIndexProvider, { pageIndex: i, children: child }) }, child.key ?? i)) }),
+      /* @__PURE__ */ (0, import_jsx_runtime13.jsxs)("nav", { "aria-label": "Sequence navigation", children: [
+        /* @__PURE__ */ (0, import_jsx_runtime13.jsx)(
+          "button",
+          {
+            type: "button",
+            "data-testid": "sequence-prev",
+            disabled: visibleIndex === 0 || childArray.length === 0,
+            onClick: goPrev,
+            children: "Previous"
+          }
+        ),
+        /* @__PURE__ */ (0, import_jsx_runtime13.jsx)(
+          "button",
+          {
+            type: "button",
+            "data-testid": "sequence-next",
+            disabled: visibleIndex >= childArray.length - 1 || childArray.length === 0,
+            onClick: goNext,
+            children: "Next"
+          }
+        )
+      ] })
+    ] });
+  }
+);
+var AssessmentSequence = (0, import_react24.forwardRef)(
+  function AssessmentSequence2(props, ref) {
+    const reactInstanceId = (0, import_react24.useId)();
+    const autoCompoundIdRef = (0, import_react24.useRef)(null);
+    if (!props.blockId && !autoCompoundIdRef.current) {
+      autoCompoundIdRef.current = (0, import_core17.deriveId)(`assessment-sequence-${reactInstanceId}`);
+    }
+    const compoundId = (0, import_react24.useMemo)(
+      () => props.blockId ? normalizeComponentId(props.blockId, "blockId") : autoCompoundIdRef.current ?? DEFAULT_ASSESSMENT_SEQUENCE_COMPOUND_ID,
+      [props.blockId]
+    );
+    const childArray = import_react24.default.Children.toArray(props.children).filter(
+      import_react24.default.isValidElement
+    );
+    const { config, storage } = useLessonkit();
+    const persistEnabled = config.session?.persistCompoundState !== false;
+    (0, import_react24.useEffect)(() => {
+      warnSharedCompoundStorageKey({
+        persistEnabled,
+        hasExplicitBlockId: Boolean(props.blockId),
+        componentName: "AssessmentSequence"
+      });
+    }, [persistEnabled, props.blockId]);
+    const initialIndex = useCompoundInitialIndex({
+      courseId: config.courseId,
+      compoundId,
+      pageCount: childArray.length,
+      persistEnabled,
+      storage
+    });
+    const [index, setIndex] = (0, import_react24.useState)(initialIndex);
+    const setIndexStable = (0, import_react24.useCallback)((i) => setIndex(i), []);
+    (0, import_react24.useEffect)(() => {
+      setIndex(initialIndex);
+    }, [config.courseId, compoundId, initialIndex]);
+    return /* @__PURE__ */ (0, import_jsx_runtime13.jsx)(CompoundProvider, { activePageIndex: index, onActivePageIndexChange: setIndexStable, children: /* @__PURE__ */ (0, import_jsx_runtime13.jsx)(
+      AssessmentSequenceInner,
+      {
+        ...props,
+        ref,
+        compoundId,
+        childArray,
+        index,
+        setIndex,
+        persistEnabled
+      }
+    ) });
+  }
+);
+setLessonkitBlockType(AssessmentSequence, "AssessmentSequence");
+
+// src/blocks/Text.tsx
+var import_react25 = require("react");
+var import_jsx_runtime14 = require("react/jsx-runtime");
+function Text(props) {
+  return /* @__PURE__ */ (0, import_jsx_runtime14.jsx)("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
+var import_jsx_runtime15 = require("react/jsx-runtime");
+function Heading(props) {
+  const Tag = `h${props.level}`;
+  return /* @__PURE__ */ (0, import_jsx_runtime15.jsx)(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
+var import_jsx_runtime16 = require("react/jsx-runtime");
+function Image(props) {
+  return /* @__PURE__ */ (0, import_jsx_runtime16.jsx)(
+    "img",
+    {
+      src: props.src,
+      alt: props.alt,
+      "data-lk-block-id": props.blockId,
+      "data-testid": props.blockId ? `image-${props.blockId}` : "image",
+      style: { maxWidth: "100%", height: "auto" }
+    }
+  );
+}
+setLessonkitBlockType(Image, "Image");
+
+// src/blocks/Page.tsx
+var import_react26 = require("react");
+var import_jsx_runtime17 = require("react/jsx-runtime");
+function Page(props) {
+  validateCompoundChildren("Page", props.children);
+  const { track } = useLessonkit();
+  const lessonId = useEnclosingLessonId();
+  (0, import_react26.useEffect)(() => {
+    if (props.hidden || !lessonId || props.parentType) return;
+    track(
+      "compound_page_viewed",
+      {
+        blockId: props.blockId,
+        pageIndex: props.pageIndex ?? 0,
+        parentType: props.parentType
+      },
+      { lessonId }
+    );
+  }, [props.hidden, props.pageIndex, props.parentType, props.blockId, lessonId, track]);
+  return /* @__PURE__ */ (0, import_jsx_runtime17.jsxs)(
+    "section",
+    {
+      "aria-label": props.title ?? "Page",
+      "data-lk-block-id": props.blockId,
+      "data-testid": `page-${props.blockId}`,
+      hidden: props.hidden ? true : void 0,
+      children: [
+        props.title ? /* @__PURE__ */ (0, import_jsx_runtime17.jsx)("h3", { children: props.title }) : null,
+        /* @__PURE__ */ (0, import_jsx_runtime17.jsx)(CompoundPageIndexProvider, { pageIndex: props.pageIndex ?? 0, children: /* @__PURE__ */ (0, import_jsx_runtime17.jsx)("div", { children: props.children }) })
+      ]
+    }
+  );
+}
+setLessonkitBlockType(Page, "Page");
+
+// src/blocks/InteractiveBook.tsx
+var import_react27 = __toESM(require("react"), 1);
+var import_jsx_runtime18 = require("react/jsx-runtime");
+var InteractiveBookInner = (0, import_react27.forwardRef)(
+  function InteractiveBookInner2(props, ref) {
+    const { blockId, pages, index, setIndex, persistEnabled } = props;
+    validateCompoundChildren("InteractiveBook", pages);
+    const { config, track } = useLessonkit();
+    const lessonId = useEnclosingLessonId();
+    const { visibleIndex, goNext, goPrev, progress, ctx } = useCompoundShell({
+      courseId: config.courseId,
+      compoundId: blockId,
+      pageCount: pages.length,
+      index,
+      setIndex,
+      persistEnabled,
+      ref
+    });
+    const pageTitles = (0, import_react27.useMemo)(
+      () => pages.map((page) => page.props.title),
+      [pages]
+    );
+    (0, import_react27.useEffect)(() => {
+      if (!lessonId || pages.length === 0) return;
+      track(
+        "book_page_viewed",
+        {
+          blockId,
+          pageIndex: visibleIndex,
+          pageTitle: pageTitles[visibleIndex]
+        },
+        { lessonId }
+      );
+    }, [visibleIndex, blockId, lessonId, pages.length, pageTitles, track]);
+    return /* @__PURE__ */ (0, import_jsx_runtime18.jsxs)("section", { "aria-label": props.title, "data-testid": "interactive-book", "data-lk-block-id": blockId, children: [
+      /* @__PURE__ */ (0, import_jsx_runtime18.jsx)("h3", { children: props.title }),
+      /* @__PURE__ */ (0, import_jsx_runtime18.jsxs)("p", { children: [
+        "Page ",
+        progress.current,
+        " of ",
+        progress.total
+      ] }),
+      props.showBookScore && ctx ? /* @__PURE__ */ (0, import_jsx_runtime18.jsxs)("p", { "data-testid": "book-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__ */ (0, import_jsx_runtime18.jsx)("div", { "data-testid": "interactive-book-page", children: pages.map(
+        (page, i) => import_react27.default.cloneElement(page, {
+          key: page.key ?? page.props.blockId,
+          hidden: i !== visibleIndex,
+          pageIndex: i,
+          parentType: "InteractiveBook"
+        })
+      ) }),
+      /* @__PURE__ */ (0, import_jsx_runtime18.jsxs)("nav", { "aria-label": "Book navigation", children: [
+        /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
+          "button",
+          {
+            type: "button",
+            "data-testid": "book-prev",
+            disabled: visibleIndex === 0 || pages.length === 0,
+            onClick: goPrev,
+            children: "Previous"
+          }
+        ),
+        /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
+          "button",
+          {
+            type: "button",
+            "data-testid": "book-next",
+            disabled: visibleIndex >= pages.length - 1 || pages.length === 0,
+            onClick: goNext,
+            children: "Next"
+          }
+        )
+      ] })
+    ] });
+  }
+);
+var InteractiveBook = (0, import_react27.forwardRef)(function InteractiveBook2(props, ref) {
+  const blockId = (0, import_react27.useMemo)(
+    () => normalizeComponentId(props.blockId, "blockId"),
+    [props.blockId]
+  );
+  const pages = import_react27.default.Children.toArray(props.children).filter(
+    import_react27.default.isValidElement
+  );
+  const { config, storage } = useLessonkit();
+  const persistEnabled = config.session?.persistCompoundState !== false;
+  const initialIndex = useCompoundInitialIndex({
+    courseId: config.courseId,
+    compoundId: blockId,
+    pageCount: pages.length,
+    persistEnabled,
+    storage
+  });
+  const [index, setIndex] = (0, import_react27.useState)(initialIndex);
+  const setIndexStable = (0, import_react27.useCallback)((i) => setIndex(i), []);
+  (0, import_react27.useEffect)(() => {
+    setIndex(initialIndex);
+  }, [config.courseId, blockId, initialIndex]);
+  return /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(CompoundProvider, { activePageIndex: index, onActivePageIndexChange: setIndexStable, children: /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
+    InteractiveBookInner,
+    {
+      ...props,
+      ref,
+      blockId,
+      pages,
+      index,
+      setIndex,
+      persistEnabled
+    }
+  ) });
+});
+setLessonkitBlockType(InteractiveBook, "InteractiveBook");
+
+// src/blocks/Slide.tsx
+var import_react28 = require("react");
+var import_jsx_runtime19 = require("react/jsx-runtime");
+function Slide(props) {
+  validateCompoundChildren("Slide", props.children);
+  const { track } = useLessonkit();
+  const lessonId = useEnclosingLessonId();
+  (0, import_react28.useEffect)(() => {
+    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__ */ (0, import_jsx_runtime19.jsxs)(
+    "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__ */ (0, import_jsx_runtime19.jsx)("h3", { children: props.title }) : null,
+        /* @__PURE__ */ (0, import_jsx_runtime19.jsx)(CompoundPageIndexProvider, { pageIndex: props.slideIndex ?? 0, children: /* @__PURE__ */ (0, import_jsx_runtime19.jsx)("div", { children: props.children }) })
+      ]
+    }
+  );
+}
+setLessonkitBlockType(Slide, "Slide");
+
+// src/blocks/SlideDeck.tsx
+var import_react30 = __toESM(require("react"), 1);
+
+// src/compound/useCompoundKeyboardNav.ts
+var import_react29 = require("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;
+  (0, import_react29.useEffect)(() => {
+    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
+var import_jsx_runtime20 = require("react/jsx-runtime");
+var SlideDeckInner = (0, import_react30.forwardRef)(function SlideDeckInner2(props, ref) {
+  const { blockId, slides, index, setIndex, persistEnabled } = props;
+  validateCompoundChildren("SlideDeck", slides);
+  const { config, track } = useLessonkit();
+  const lessonId = useEnclosingLessonId();
+  const containerRef = (0, import_react30.useRef)(null);
+  const { visibleIndex, goNext, goPrev, progress, ctx } = useCompoundShell({
+    courseId: config.courseId,
+    compoundId: blockId,
+    pageCount: slides.length,
+    index,
+    setIndex,
+    persistEnabled,
+    ref
+  });
+  const setIndexStable = (0, import_react30.useCallback)((i) => setIndex(i), [setIndex]);
+  useCompoundKeyboardNav({
+    containerRef,
+    visibleIndex,
+    pageCount: slides.length,
+    goNext,
+    goPrev,
+    setIndex: setIndexStable
+  });
+  const slideTitles = (0, import_react30.useMemo)(
+    () => slides.map((slide) => slide.props.title),
+    [slides]
+  );
+  (0, import_react30.useEffect)(() => {
+    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__ */ (0, import_jsx_runtime20.jsxs)(
+    "section",
+    {
+      ref: containerRef,
+      tabIndex: -1,
+      "aria-label": props.title,
+      "data-testid": "slide-deck",
+      "data-lk-block-id": blockId,
+      children: [
+        /* @__PURE__ */ (0, import_jsx_runtime20.jsx)("h3", { children: props.title }),
+        /* @__PURE__ */ (0, import_jsx_runtime20.jsxs)("p", { children: [
+          "Slide ",
+          progress.current,
+          " of ",
+          progress.total
+        ] }),
+        props.showDeckScore && ctx ? /* @__PURE__ */ (0, import_jsx_runtime20.jsxs)("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__ */ (0, import_jsx_runtime20.jsx)("div", { "data-testid": "slide-deck-slide", children: slides.map(
+          (slide, i) => import_react30.default.cloneElement(slide, {
+            key: slide.key ?? slide.props.blockId,
+            hidden: i !== visibleIndex,
+            slideIndex: i,
+            parentType: "SlideDeck"
+          })
+        ) }),
+        /* @__PURE__ */ (0, import_jsx_runtime20.jsxs)("nav", { "aria-label": "Slide navigation", children: [
+          /* @__PURE__ */ (0, import_jsx_runtime20.jsx)(
+            "button",
+            {
+              type: "button",
+              "data-testid": "slide-prev",
+              disabled: visibleIndex === 0 || slides.length === 0,
+              onClick: goPrev,
+              children: "Previous slide"
+            }
+          ),
+          /* @__PURE__ */ (0, import_jsx_runtime20.jsx)(
+            "button",
+            {
+              type: "button",
+              "data-testid": "slide-next",
+              disabled: visibleIndex >= slides.length - 1 || slides.length === 0,
+              onClick: goNext,
+              children: "Next slide"
+            }
+          )
+        ] })
+      ]
+    }
+  );
+});
+var SlideDeck = (0, import_react30.forwardRef)(function SlideDeck2(props, ref) {
+  const blockId = (0, import_react30.useMemo)(
+    () => normalizeComponentId(props.blockId, "blockId"),
+    [props.blockId]
+  );
+  const slides = import_react30.default.Children.toArray(props.children).filter(
+    import_react30.default.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] = (0, import_react30.useState)(initialIndex);
+  const setIndexStable = (0, import_react30.useCallback)((i) => setIndex(i), []);
+  (0, import_react30.useEffect)(() => {
+    setIndex(initialIndex);
+  }, [config.courseId, blockId, initialIndex]);
+  return /* @__PURE__ */ (0, import_jsx_runtime20.jsx)(CompoundProvider, { activePageIndex: index, onActivePageIndexChange: setIndexStable, children: /* @__PURE__ */ (0, import_jsx_runtime20.jsx)(
+    SlideDeckInner,
+    {
+      ...props,
+      ref,
+      blockId,
+      slides,
+      index,
+      setIndex,
+      persistEnabled
+    }
+  ) });
+});
+setLessonkitBlockType(SlideDeck, "SlideDeck");
+
+// src/blocks/Accordion.tsx
+var import_react31 = require("react");
+var import_jsx_runtime21 = require("react/jsx-runtime");
+function Accordion(props) {
+  if (isDevEnvironment4()) {
+    validateAccordionSections(props.sections);
+  }
+  const [open, setOpen] = (0, import_react31.useState)(/* @__PURE__ */ new Set());
+  const { track } = useLessonkit();
+  const lessonId = useEnclosingLessonId();
+  const baseId = (0, import_react31.useId)();
+  const toggle = (sectionId) => {
+    setOpen((prev) => {
+      const next = new Set(prev);
+      const expanded = !next.has(sectionId);
+      if (expanded) next.add(sectionId);
+      else next.delete(sectionId);
+      track(
+        "accordion_section_toggled",
+        { blockId: props.blockId, sectionId, expanded },
+        lessonId ? { lessonId } : void 0
+      );
+      return next;
+    });
+  };
+  return /* @__PURE__ */ (0, import_jsx_runtime21.jsx)("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__ */ (0, import_jsx_runtime21.jsxs)("div", { "data-testid": `accordion-section-${section.id}`, children: [
+      /* @__PURE__ */ (0, import_jsx_runtime21.jsx)("h4", { children: /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(
+        "button",
+        {
+          id: triggerId,
+          type: "button",
+          "aria-expanded": expanded,
+          "aria-controls": panelId,
+          "data-testid": `accordion-trigger-${section.id}`,
+          onClick: () => toggle(section.id),
+          children: section.title
+        }
+      ) }),
+      expanded ? /* @__PURE__ */ (0, import_jsx_runtime21.jsx)("div", { id: panelId, role: "region", "aria-labelledby": triggerId, children: section.content }) : null
+    ] }, section.id);
+  }) });
+}
+setLessonkitBlockType(Accordion, "Accordion");
+
+// src/blocks/DialogCards.tsx
+var import_react32 = require("react");
+var import_jsx_runtime22 = require("react/jsx-runtime");
+function DialogCards(props) {
+  const [index, setIndex] = (0, import_react32.useState)(0);
+  const [flipped, setFlipped] = (0, import_react32.useState)(false);
+  const card = props.cards[index];
+  if (!card) return null;
+  return /* @__PURE__ */ (0, import_jsx_runtime22.jsxs)("section", { "aria-label": "Dialog cards", "data-lk-block-id": props.blockId, "data-testid": "dialog-cards", children: [
+    /* @__PURE__ */ (0, import_jsx_runtime22.jsxs)("p", { children: [
+      "Card ",
+      index + 1,
+      " of ",
+      props.cards.length
+    ] }),
+    /* @__PURE__ */ (0, import_jsx_runtime22.jsx)(
+      "button",
+      {
+        type: "button",
+        "data-testid": "dialog-card-flip",
+        "aria-pressed": flipped,
+        onClick: () => setFlipped((f) => !f),
+        style: { minHeight: "6rem", width: "100%" },
+        children: flipped ? card.back : card.front
+      }
+    ),
+    /* @__PURE__ */ (0, import_jsx_runtime22.jsxs)("nav", { "aria-label": "Card navigation", children: [
+      /* @__PURE__ */ (0, import_jsx_runtime22.jsx)(
+        "button",
+        {
+          type: "button",
+          "data-testid": "dialog-prev",
+          disabled: index === 0,
+          onClick: () => {
+            setIndex((i) => i - 1);
+            setFlipped(false);
+          },
+          children: "Previous"
+        }
+      ),
+      /* @__PURE__ */ (0, import_jsx_runtime22.jsx)(
+        "button",
+        {
+          type: "button",
+          "data-testid": "dialog-next",
+          disabled: index >= props.cards.length - 1,
+          onClick: () => {
+            setIndex((i) => i + 1);
+            setFlipped(false);
+          },
+          children: "Next"
+        }
+      )
+    ] })
+  ] });
+}
+setLessonkitBlockType(DialogCards, "DialogCards");
+
+// src/blocks/Flashcards.tsx
+var import_react33 = require("react");
+var import_jsx_runtime23 = require("react/jsx-runtime");
+function Flashcards(props) {
+  const [index, setIndex] = (0, import_react33.useState)(0);
+  const [face, setFace] = (0, import_react33.useState)("front");
+  const { track } = useLessonkit();
+  const lessonId = useEnclosingLessonId();
+  const card = props.cards[index];
+  if (!card) return null;
+  const flip = () => {
+    const next = face === "front" ? "back" : "front";
+    setFace(next);
+    track(
+      "flashcard_flipped",
+      { blockId: props.blockId, cardIndex: index, face: next },
+      lessonId ? { lessonId } : void 0
+    );
+  };
+  return /* @__PURE__ */ (0, import_jsx_runtime23.jsxs)("section", { "aria-label": "Flashcards", "data-lk-block-id": props.blockId, "data-testid": "flashcards", children: [
+    /* @__PURE__ */ (0, import_jsx_runtime23.jsx)("button", { type: "button", "data-testid": "flashcard-flip", onClick: flip, style: { minHeight: "6rem", width: "100%" }, children: face === "front" ? card.front : card.back }),
+    props.selfScore ? /* @__PURE__ */ (0, import_jsx_runtime23.jsx)("p", { "data-testid": "flashcard-self-score", children: "Self-score mode enabled" }) : null,
+    /* @__PURE__ */ (0, import_jsx_runtime23.jsx)(
+      "button",
+      {
+        type: "button",
+        "data-testid": "flashcard-next",
+        disabled: index >= props.cards.length - 1,
+        onClick: () => {
+          setIndex((i) => i + 1);
+          setFace("front");
+        },
+        children: "Next card"
+      }
+    )
+  ] });
+}
+setLessonkitBlockType(Flashcards, "Flashcards");
+
+// src/blocks/ImageHotspots.tsx
+var import_react34 = require("react");
+var import_jsx_runtime24 = require("react/jsx-runtime");
+function ImageHotspots(props) {
+  const [active, setActive] = (0, import_react34.useState)(null);
+  const { track } = useLessonkit();
+  const lessonId = useEnclosingLessonId();
+  const open = (hotspotId) => {
+    setActive(hotspotId);
+    track(
+      "hotspot_opened",
+      { blockId: props.blockId, hotspotId },
+      lessonId ? { lessonId } : void 0
+    );
+  };
+  return /* @__PURE__ */ (0, import_jsx_runtime24.jsxs)("section", { "aria-label": "Image hotspots", "data-lk-block-id": props.blockId, "data-testid": "image-hotspots", children: [
+    /* @__PURE__ */ (0, import_jsx_runtime24.jsxs)("div", { style: { position: "relative", display: "inline-block" }, children: [
+      /* @__PURE__ */ (0, import_jsx_runtime24.jsx)("img", { src: props.src, alt: props.alt, style: { maxWidth: "100%" } }),
+      props.hotspots.map((h) => /* @__PURE__ */ (0, import_jsx_runtime24.jsx)(
+        "button",
+        {
+          type: "button",
+          "aria-expanded": active === h.id,
+          "aria-label": h.label,
+          "data-testid": `hotspot-${h.id}`,
+          style: {
+            position: "absolute",
+            left: `${h.x}%`,
+            top: `${h.y}%`,
+            transform: "translate(-50%, -50%)"
+          },
+          onClick: () => open(h.id),
+          children: "+"
+        },
+        h.id
+      ))
+    ] }),
+    active ? /* @__PURE__ */ (0, import_jsx_runtime24.jsxs)("div", { role: "dialog", "aria-label": "Hotspot details", "data-testid": "hotspot-popover", children: [
+      props.hotspots.find((h) => h.id === active)?.content,
+      /* @__PURE__ */ (0, import_jsx_runtime24.jsx)("button", { type: "button", onClick: () => setActive(null), children: "Close" })
+    ] }) : null
+  ] });
+}
+setLessonkitBlockType(ImageHotspots, "ImageHotspots");
+
+// src/blocks/ImageSlider.tsx
+var import_react35 = require("react");
+var import_jsx_runtime25 = require("react/jsx-runtime");
+function ImageSlider(props) {
+  const [index, setIndex] = (0, import_react35.useState)(0);
+  const { track } = useLessonkit();
+  const lessonId = useEnclosingLessonId();
+  const slide = props.slides[index];
+  if (!slide) return null;
+  const goTo = (next) => {
+    setIndex(next);
+    track(
+      "image_slider_changed",
+      { blockId: props.blockId, slideIndex: next },
+      lessonId ? { lessonId } : void 0
+    );
+  };
+  return /* @__PURE__ */ (0, import_jsx_runtime25.jsxs)("section", { "aria-label": "Image slider", "data-lk-block-id": props.blockId, "data-testid": "image-slider", children: [
+    /* @__PURE__ */ (0, import_jsx_runtime25.jsx)("img", { src: slide.src, alt: slide.alt, style: { maxWidth: "100%" } }),
+    slide.caption ? /* @__PURE__ */ (0, import_jsx_runtime25.jsx)("p", { children: slide.caption }) : null,
+    /* @__PURE__ */ (0, import_jsx_runtime25.jsxs)("nav", { "aria-label": "Slide navigation", children: [
+      /* @__PURE__ */ (0, import_jsx_runtime25.jsx)(
+        "button",
+        {
+          type: "button",
+          "data-testid": "slider-prev",
+          disabled: index === 0,
+          onClick: () => goTo(index - 1),
+          children: "Previous"
+        }
+      ),
+      /* @__PURE__ */ (0, import_jsx_runtime25.jsxs)("span", { children: [
+        index + 1,
+        " / ",
+        props.slides.length
+      ] }),
+      /* @__PURE__ */ (0, import_jsx_runtime25.jsx)(
+        "button",
+        {
+          type: "button",
+          "data-testid": "slider-next",
+          disabled: index >= props.slides.length - 1,
+          onClick: () => goTo(index + 1),
+          children: "Next"
+        }
+      )
+    ] })
+  ] });
+}
+setLessonkitBlockType(ImageSlider, "ImageSlider");
+
+// src/blocks/FindHotspot.tsx
+var import_react36 = require("react");
+var import_jsx_runtime26 = require("react/jsx-runtime");
+var INTERACTION6 = "findHotspot";
+function FindHotspotInner(props, ref) {
+  const checkId = (0, import_react36.useMemo)(() => normalizeComponentId(props.checkId, "checkId"), [props.checkId]);
+  const [selected, setSelected] = (0, import_react36.useState)(null);
+  const [checked, setChecked] = (0, import_react36.useState)(false);
+  const assessment = useAssessmentState(props.enclosingLessonId);
+  const targetIdsKey = props.targets.map((t) => t.id).join("\0");
+  (0, import_react36.useEffect)(() => {
+    setSelected(null);
+    setChecked(false);
+  }, [checkId, props.correctTargetId, targetIdsKey]);
+  const correct = selected === props.correctTargetId;
+  const handle = (0, import_react36.useMemo)(
+    () => buildAssessmentHandle({
+      checkId,
+      getScore: () => checked && correct ? 1 : 0,
+      getMaxScore: () => 1,
+      getAnswerGiven: () => selected !== null,
+      resetTask: () => {
+        setSelected(null);
+        setChecked(false);
+      },
+      showSolutions: () => setSelected(props.correctTargetId),
+      getXAPIData: () => ({
+        checkId,
+        interactionType: INTERACTION6,
+        response: selected ?? void 0,
+        correct: checked ? correct : void 0,
+        score: checked && correct ? 1 : 0,
+        maxScore: 1
+      }),
+      getCurrentState: () => ({ selected, checked }),
+      resume: (state) => {
+        const nextSelected = readStringField(state, "selected");
+        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, props.targets]
+  );
+  useAssessmentHandleRegistration(checkId, handle, ref);
+  const selectTarget = (id) => {
+    setSelected(id);
+    setChecked(false);
+  };
+  const submit = () => {
+    if (!selected || checked) return;
+    setChecked(true);
+    assessment.answer({
+      checkId,
+      interactionType: INTERACTION6,
+      response: selected,
+      correct
+    });
+    if (correct) {
+      assessment.complete({
+        checkId,
+        interactionType: INTERACTION6,
+        score: 1,
+        maxScore: 1,
+        passingScore: props.passingScore ?? 1
+      });
+    }
+  };
+  return /* @__PURE__ */ (0, import_jsx_runtime26.jsxs)("section", { "aria-label": "Find the hotspot", "data-lk-check-id": checkId, "data-testid": "find-hotspot", children: [
+    /* @__PURE__ */ (0, import_jsx_runtime26.jsxs)("div", { style: { position: "relative", display: "inline-block" }, children: [
+      /* @__PURE__ */ (0, import_jsx_runtime26.jsx)("img", { src: props.src, alt: props.alt, style: { maxWidth: "100%" } }),
+      props.targets.map((t) => /* @__PURE__ */ (0, import_jsx_runtime26.jsx)(
+        "button",
+        {
+          type: "button",
+          "aria-label": t.label,
+          "aria-pressed": selected === t.id,
+          "data-testid": `target-${t.id}`,
+          style: {
+            position: "absolute",
+            left: `${t.x}%`,
+            top: `${t.y}%`,
+            transform: "translate(-50%, -50%)"
           },
-          children: zones[part] || "___"
+          onClick: () => selectTarget(t.id),
+          children: t.label
         },
-        part
-      );
-    }) }),
-    /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("button", { type: "button", "data-testid": "check-drag-words", disabled: !allFilled || passed, onClick: check, children: "Check" }),
-    !hasZones ? /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("p", { role: "alert", children: "This activity has no drop zones. Wrap answers in asterisks in the template." }) : null,
-    allFilled ? /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("p", { role: "status", "aria-live": "polite", children: passed || passedThreshold ? "Correct" : "Try again" }) : null
+        t.id
+      ))
+    ] }),
+    /* @__PURE__ */ (0, import_jsx_runtime26.jsx)("button", { type: "button", "data-testid": "check-hotspot", disabled: !selected, onClick: submit, children: "Check" }),
+    checked ? /* @__PURE__ */ (0, import_jsx_runtime26.jsx)("p", { role: "status", children: correct ? "Correct" : "Try again" }) : null
   ] });
 }
-var DragTheWordsInnerForwarded = (0, import_react12.forwardRef)(DragTheWordsInner);
-var DragTheWords = (0, import_react12.forwardRef)(function DragTheWords2(props, ref) {
-  return /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(AssessmentLessonGuard, { blockLabel: "DragTheWords", checkId: props.checkId, children: (lessonId) => /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(DragTheWordsInnerForwarded, { ...props, enclosingLessonId: lessonId, ref }) });
+var FindHotspotInnerForwarded = (0, import_react36.forwardRef)(FindHotspotInner);
+var FindHotspot = (0, import_react36.forwardRef)(function FindHotspot2(props, ref) {
+  return /* @__PURE__ */ (0, import_jsx_runtime26.jsx)(AssessmentLessonGuard, { blockLabel: "FindHotspot", checkId: props.checkId, children: (enclosingLessonId) => /* @__PURE__ */ (0, import_jsx_runtime26.jsx)(FindHotspotInnerForwarded, { ...props, enclosingLessonId, ref }) });
 });
+setLessonkitBlockType(FindHotspot, "FindHotspot");
 
-// src/blocks/DragAndDrop.tsx
-var import_react13 = require("react");
-var import_jsx_runtime9 = require("react/jsx-runtime");
-var INTERACTION5 = "dragAndDrop";
-function DragAndDropInner(props, ref) {
-  const checkId = (0, import_react13.useMemo)(() => normalizeComponentId(props.checkId, "checkId"), [props.checkId]);
+// src/blocks/FindMultipleHotspots.tsx
+var import_react37 = require("react");
+var import_jsx_runtime27 = require("react/jsx-runtime");
+var INTERACTION7 = "findMultipleHotspots";
+function FindMultipleHotspotsInner(props, ref) {
+  const checkId = (0, import_react37.useMemo)(() => normalizeComponentId(props.checkId, "checkId"), [props.checkId]);
+  const [selected, setSelected] = (0, import_react37.useState)(/* @__PURE__ */ new Set());
+  const [checked, setChecked] = (0, import_react37.useState)(false);
   const assessment = useAssessmentState(props.enclosingLessonId);
-  const [assignments, setAssignments] = (0, import_react13.useState)(
-    () => Object.fromEntries(props.targets.map((t) => [t.id, ""]))
-  );
-  const [pool, setPool] = (0, import_react13.useState)(() => props.items.map((i) => i.id));
-  const [keyboardItem, setKeyboardItem] = (0, import_react13.useState)(null);
-  const [passed, setPassed] = (0, import_react13.useState)(false);
-  const completedRef = (0, import_react13.useRef)(false);
-  const reset = () => {
-    completedRef.current = false;
-    setPassed(false);
-    setAssignments(Object.fromEntries(props.targets.map((t) => [t.id, ""])));
-    setPool(props.items.map((i) => i.id));
-    setKeyboardItem(null);
-  };
-  (0, import_react13.useEffect)(() => {
-    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 handle = (0, import_react13.useMemo)(() => {
-    const maxScore = props.targets.length || 1;
-    let score = 0;
-    props.targets.forEach((t) => {
-      if (assignments[t.id] === t.accepts) score += 1;
+  const toggle = (id) => {
+    setSelected((prev) => {
+      const next = new Set(prev);
+      if (next.has(id)) next.delete(id);
+      else next.add(id);
+      return next;
     });
-    return {
-      getScore: () => score,
-      getMaxScore: () => maxScore,
-      getAnswerGiven: () => allFilled,
-      resetTask: reset,
-      showSolutions: () => {
+    setChecked(false);
+  };
+  const correct = selected.size === props.correctTargetIds.length && props.correctTargetIds.every((id) => selected.has(id));
+  const handle = (0, import_react37.useMemo)(
+    () => buildAssessmentHandle({
+      checkId,
+      getScore: () => checked && correct ? 1 : 0,
+      getMaxScore: () => 1,
+      getAnswerGiven: () => selected.size > 0,
+      resetTask: () => {
+        setSelected(/* @__PURE__ */ new Set());
+        setChecked(false);
       },
+      showSolutions: () => setSelected(new Set(props.correctTargetIds)),
       getXAPIData: () => ({
         checkId,
-        interactionType: INTERACTION5,
-        response: assignments,
-        correct: allCorrect,
-        score,
-        maxScore
-      })
-    };
-  }, [allCorrect, allFilled, assignments, checkId, props.targets]);
-  (0, import_react13.useImperativeHandle)(ref, () => handle, [handle]);
-  useRegisterAssessmentHandle(checkId, handle);
-  const place = (targetId, itemId) => {
-    if (passed && !props.enableRetry) return;
-    const prev = assignments[targetId];
-    setAssignments((a) => ({ ...a, [targetId]: itemId }));
-    setPool((p) => {
-      const next = p.filter((id) => id !== itemId);
-      if (prev) next.push(prev);
-      return next;
-    });
-    setKeyboardItem(null);
-  };
-  const check = () => {
-    if (!allFilled) return;
+        interactionType: INTERACTION7,
+        response: [...selected],
+        correct: checked ? correct : void 0,
+        score: checked && correct ? 1 : 0,
+        maxScore: 1
+      }),
+      getCurrentState: () => ({ selected: [...selected], checked }),
+      resume: (state) => {
+        const raw = state.selected;
+        if (Array.isArray(raw)) setSelected(new Set(raw.filter((id) => typeof id === "string")));
+        readBooleanStateField(state, "checked", setChecked);
+      }
+    }),
+    [checkId, selected, checked, correct, props.correctTargetIds]
+  );
+  useAssessmentHandleRegistration(checkId, handle, ref);
+  const submit = () => {
+    if (selected.size === 0 || checked) return;
+    setChecked(true);
     assessment.answer({
       checkId,
-      interactionType: INTERACTION5,
-      response: assignments,
-      correct: allCorrect
+      interactionType: INTERACTION7,
+      response: [...selected],
+      correct
     });
-    if (allCorrect && !completedRef.current) {
-      completedRef.current = true;
-      setPassed(true);
+    if (correct) {
       assessment.complete({
         checkId,
-        interactionType: INTERACTION5,
-        score: props.targets.length,
-        maxScore: props.targets.length,
-        passingScore: props.passingScore ?? props.targets.length
+        interactionType: INTERACTION7,
+        score: 1,
+        maxScore: 1,
+        passingScore: props.passingScore ?? 1
       });
     }
   };
-  return /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)("section", { "aria-label": "Drag and Drop", "data-lk-check-id": checkId, children: [
-    /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("p", { children: "Match each item to the correct target (drag or use keyboard: select item, then activate target)." }),
-    /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("div", { role: "list", "aria-label": "Draggable items", children: pool.map((id) => {
-      const item = props.items.find((i) => i.id === id);
-      return /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(
+  return /* @__PURE__ */ (0, import_jsx_runtime27.jsxs)("section", { "aria-label": "Find multiple hotspots", "data-lk-check-id": checkId, "data-testid": "find-multiple-hotspots", children: [
+    /* @__PURE__ */ (0, import_jsx_runtime27.jsxs)("div", { style: { position: "relative", display: "inline-block" }, children: [
+      /* @__PURE__ */ (0, import_jsx_runtime27.jsx)("img", { src: props.src, alt: props.alt, style: { maxWidth: "100%" } }),
+      props.targets.map((t) => /* @__PURE__ */ (0, import_jsx_runtime27.jsx)(
         "button",
         {
           type: "button",
-          draggable: true,
-          "data-testid": `drag-item-${id}`,
-          "aria-pressed": keyboardItem === id,
-          onDragStart: (e) => e.dataTransfer.setData("text/plain", id),
-          onClick: () => setKeyboardItem(keyboardItem === id ? null : id),
-          style: { margin: "0.25rem" },
-          children: item.label
+          "aria-label": t.label,
+          "aria-pressed": selected.has(t.id),
+          "data-testid": `target-${t.id}`,
+          style: {
+            position: "absolute",
+            left: `${t.x}%`,
+            top: `${t.y}%`,
+            transform: "translate(-50%, -50%)"
+          },
+          onClick: () => toggle(t.id),
+          children: t.label
         },
-        id
-      );
-    }) }),
-    /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("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__ */ (0, import_jsx_runtime9.jsxs)("li", { children: [
-        /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("strong", { children: target.label }),
-        " ",
-        /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(
-          "span",
-          {
-            role: "button",
-            tabIndex: 0,
-            "data-testid": `drop-${target.id}`,
-            onDragOver: (e) => e.preventDefault(),
-            onDrop: (e) => {
-              e.preventDefault();
-              const id = e.dataTransfer.getData("text/plain");
-              if (id) place(target.id, id);
-            },
-            onClick: () => keyboardItem && place(target.id, keyboardItem),
-            onKeyDown: (e) => {
-              if (e.key === "Enter" && keyboardItem) place(target.id, keyboardItem);
-            },
-            style: {
-              display: "inline-block",
-              minWidth: "8em",
-              border: "1px dashed currentColor",
-              padding: "0.25em"
-            },
-            children: label
-          }
-        )
-      ] }, target.id);
-    }) }),
-    /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("button", { type: "button", "data-testid": "check-drag-drop", disabled: !allFilled || passed, onClick: check, children: "Check" }),
-    allFilled ? /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("p", { role: "status", "aria-live": "polite", children: passed || allCorrect ? "Correct" : "Try again" }) : null
+        t.id
+      ))
+    ] }),
+    /* @__PURE__ */ (0, import_jsx_runtime27.jsx)("button", { type: "button", "data-testid": "check-hotspots", disabled: selected.size === 0, onClick: submit, children: "Check" }),
+    checked ? /* @__PURE__ */ (0, import_jsx_runtime27.jsx)("p", { role: "status", children: correct ? "Correct" : "Try again" }) : null
   ] });
 }
-var DragAndDropInnerForwarded = (0, import_react13.forwardRef)(DragAndDropInner);
-var DragAndDrop = (0, import_react13.forwardRef)(function DragAndDrop2(props, ref) {
-  return /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(AssessmentLessonGuard, { blockLabel: "DragAndDrop", checkId: props.checkId, children: (lessonId) => /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(DragAndDropInnerForwarded, { ...props, enclosingLessonId: lessonId, ref }) });
-});
-
-// src/blocks/AssessmentSequence.tsx
-var import_react14 = __toESM(require("react"), 1);
-var import_jsx_runtime10 = require("react/jsx-runtime");
-function AssessmentSequence(props) {
-  const sequential = props.sequential !== false;
-  const childArray = import_react14.default.Children.toArray(props.children).filter(import_react14.default.isValidElement);
-  const [index, setIndex] = (0, import_react14.useState)(0);
-  const current = childArray[index] ?? null;
-  const goNext = (0, import_react14.useCallback)(() => {
-    setIndex((i) => Math.min(i + 1, childArray.length - 1));
-  }, [childArray.length]);
-  const goPrev = (0, import_react14.useCallback)(() => {
-    setIndex((i) => Math.max(i - 1, 0));
-  }, []);
-  const progress = (0, import_react14.useMemo)(
-    () => ({ current: index + 1, total: childArray.length }),
-    [index, childArray.length]
-  );
-  if (!sequential) {
-    return /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(AssessmentSequenceProvider, { children: /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("section", { "aria-label": "Assessment sequence", children: props.children }) });
+var FindMultipleHotspotsInnerForwarded = (0, import_react37.forwardRef)(FindMultipleHotspotsInner);
+var FindMultipleHotspots = (0, import_react37.forwardRef)(
+  function FindMultipleHotspots2(props, ref) {
+    return /* @__PURE__ */ (0, import_jsx_runtime27.jsx)(AssessmentLessonGuard, { blockLabel: "FindMultipleHotspots", checkId: props.checkId, children: (enclosingLessonId) => /* @__PURE__ */ (0, import_jsx_runtime27.jsx)(FindMultipleHotspotsInnerForwarded, { ...props, enclosingLessonId, ref }) });
   }
-  return /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(AssessmentSequenceProvider, { children: /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)("section", { "aria-label": "Assessment sequence", "data-testid": "assessment-sequence", children: [
-    /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)("p", { children: [
-      "Question ",
-      progress.current,
-      " of ",
-      progress.total
-    ] }),
-    /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("div", { "data-testid": "assessment-sequence-step", children: current }),
-    /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)("nav", { "aria-label": "Sequence navigation", children: [
-      /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("button", { type: "button", "data-testid": "sequence-prev", disabled: index === 0, onClick: goPrev, children: "Previous" }),
-      /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(
-        "button",
-        {
-          type: "button",
-          "data-testid": "sequence-next",
-          disabled: index >= childArray.length - 1,
-          onClick: goNext,
-          children: "Next"
-        }
-      )
-    ] })
-  ] }) });
-}
+);
+setLessonkitBlockType(FindMultipleHotspots, "FindMultipleHotspots");
 
 // src/index.tsx
-var import_core10 = require("@lessonkit/core");
+var import_core19 = require("@lessonkit/core");
 
 // src/theme/ThemeProvider.tsx
-var import_react15 = __toESM(require("react"), 1);
+var import_react38 = __toESM(require("react"), 1);
 var import_themes = require("@lessonkit/themes");
 
 // src/theme/applyCssVariables.ts
@@ -2204,11 +4118,11 @@ function applyCssVariables(target, vars, previousKeys) {
 }
 
 // src/theme/ThemeProvider.tsx
-var import_jsx_runtime11 = require("react/jsx-runtime");
-var ThemeContext = (0, import_react15.createContext)(null);
+var import_jsx_runtime28 = require("react/jsx-runtime");
+var ThemeContext = (0, import_react38.createContext)(null);
 var useIsoLayoutEffect2 = (
   /* v8 ignore next -- SSR uses useEffect when window is unavailable */
-  typeof window !== "undefined" ? import_react15.useLayoutEffect : import_react15.default.useEffect
+  typeof window !== "undefined" ? import_react38.useLayoutEffect : import_react38.default.useEffect
 );
 function getSystemMode() {
   if (typeof window === "undefined" || typeof window.matchMedia !== "function") {
@@ -2227,7 +4141,7 @@ function ThemeProvider(props) {
   const preset = props.preset ?? "default";
   const mode = props.mode ?? "light";
   const targetKind = props.target ?? "document";
-  const [resolvedMode, setResolvedMode] = (0, import_react15.useState)(
+  const [resolvedMode, setResolvedMode] = (0, import_react38.useState)(
     () => mode === "system" ? getSystemMode() : mode
   );
   useIsoLayoutEffect2(() => {
@@ -2243,20 +4157,20 @@ function ThemeProvider(props) {
     return () => mq.removeEventListener("change", onChange);
   }, [mode]);
   const dataTheme = mode === "system" ? resolvedMode : mode === "dark" ? "dark" : "light";
-  const effectiveTheme = (0, import_react15.useMemo)(() => {
+  const effectiveTheme = (0, import_react38.useMemo)(() => {
     const modeBase = resolveModeBase(mode, dataTheme);
     const base = preset === "default" ? modeBase : preset === "brand" ? (0, import_themes.mergeThemes)(modeBase, import_themes.brandThemeOverrides) : (0, import_themes.mergeThemes)(modeBase, (0, import_themes.getPresetTheme)(preset));
     return (0, import_themes.mergeThemes)(base, props.theme ?? {});
   }, [preset, mode, dataTheme, props.theme]);
-  const hostRef = (0, import_react15.useRef)(null);
-  const appliedKeysRef = (0, import_react15.useRef)(/* @__PURE__ */ new Set());
+  const hostRef = (0, import_react38.useRef)(null);
+  const appliedKeysRef = (0, import_react38.useRef)(/* @__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 = (0, import_react15.useCallback)(() => {
+  const inject = (0, import_react38.useCallback)(() => {
     const vars = (0, import_themes.themeToCssVariables)(effectiveTheme);
     const el = targetKind === "document" && typeof document !== "undefined" ? document.documentElement : hostRef.current;
     if (!el) return;
@@ -2273,7 +4187,7 @@ function ThemeProvider(props) {
       appliedKeysRef.current = /* @__PURE__ */ new Set();
     };
   }, [inject, targetKind]);
-  const value = (0, import_react15.useMemo)(
+  const value = (0, import_react38.useMemo)(
     () => ({
       theme: effectiveTheme,
       preset,
@@ -2283,21 +4197,324 @@ function ThemeProvider(props) {
     [effectiveTheme, preset, mode, dataTheme]
   );
   if (targetKind === "document") {
-    return /* @__PURE__ */ (0, import_jsx_runtime11.jsx)(ThemeContext.Provider, { value, children: /* @__PURE__ */ (0, import_jsx_runtime11.jsx)("div", { "data-lk-theme": dataTheme, style: { display: "contents" }, children: props.children }) });
+    return /* @__PURE__ */ (0, import_jsx_runtime28.jsx)(ThemeContext.Provider, { value, children: /* @__PURE__ */ (0, import_jsx_runtime28.jsx)("div", { "data-lk-theme": dataTheme, style: { display: "contents" }, children: props.children }) });
   }
-  return /* @__PURE__ */ (0, import_jsx_runtime11.jsx)(ThemeContext.Provider, { value, children: /* @__PURE__ */ (0, import_jsx_runtime11.jsx)("div", { ref: hostRef, "data-lk-theme": dataTheme, children: props.children }) });
+  return /* @__PURE__ */ (0, import_jsx_runtime28.jsx)(ThemeContext.Provider, { value, children: /* @__PURE__ */ (0, import_jsx_runtime28.jsx)("div", { ref: hostRef, "data-lk-theme": dataTheme, children: props.children }) });
 }
 function useTheme() {
-  const ctx = (0, import_react15.useContext)(ThemeContext);
+  const ctx = (0, import_react38.useContext)(ThemeContext);
   if (!ctx) {
     throw new Error("useTheme must be used within a ThemeProvider");
   }
   return ctx;
 }
 
+// src/catalogV3Entries.ts
+var import_core18 = require("@lessonkit/core");
+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]);
+  return { ...entry, parentConstraints: [...merged] };
+}
+var assessmentBehaviourProps = [
+  { name: "enableRetry", type: "boolean", required: false, description: "Allow retry after completion." },
+  { name: "enableSolutionsButton", type: "boolean", required: false, description: "Show solution control." },
+  { name: "autoCheck", type: "boolean", required: false, description: "Check answers automatically when possible." },
+  { name: "passingScore", type: "number", required: false, description: "Minimum score to pass." }
+];
+var v3CompoundAndContentEntries = [
+  {
+    type: "Text",
+    category: "content",
+    description: "Paragraph text content.",
+    props: [
+      { name: "blockId", type: "BlockId", required: false, description: "Stable block id." },
+      { name: "children", type: "ReactNode", required: true, description: "Text body." }
+    ],
+    requiredIds: [],
+    parentConstraints: [...COMPOUND_PARENTS],
+    a11y: { element: "p", ariaLabel: "Text", keyboard: "N/A", notes: "Semantic paragraph." },
+    theming: { surface: "global-inherit", stylingNotes: "Inherits theme." },
+    telemetry: { emits: [] }
+  },
+  {
+    type: "Heading",
+    category: "content",
+    description: "Heading levels 1\u20133.",
+    props: [
+      { name: "blockId", type: "BlockId", required: false, description: "Stable block id." },
+      { name: "level", type: "1 | 2 | 3", required: true, description: "Heading level." },
+      { name: "children", type: "ReactNode", required: true, description: "Heading text." }
+    ],
+    requiredIds: [],
+    parentConstraints: [...COMPOUND_PARENTS],
+    a11y: { element: "h1-h3", ariaLabel: "Heading", keyboard: "N/A", notes: "Use one level per outline." },
+    theming: { surface: "global-inherit", stylingNotes: "Inherits theme." },
+    telemetry: { emits: [] }
+  },
+  {
+    type: "Image",
+    category: "content",
+    description: "Image with required alt text.",
+    props: [
+      { name: "blockId", type: "BlockId", required: false, description: "Stable block id." },
+      { name: "src", type: "string", required: true, description: "Image URL." },
+      { name: "alt", type: "string", required: true, description: "Alt text." }
+    ],
+    requiredIds: [],
+    parentConstraints: [...COMPOUND_PARENTS],
+    a11y: { element: "img", ariaLabel: "Image", keyboard: "N/A", notes: "Requires alt." },
+    theming: { surface: "global-inherit", stylingNotes: "Responsive max-width." },
+    telemetry: { emits: [] }
+  },
+  {
+    type: "Page",
+    category: "container",
+    compoundContract: true,
+    h5pMachineName: "H5P.Column",
+    h5pAlias: "Column",
+    description: "Column layout container (H5P Column / Page).",
+    allowedChildTypes: [...import_core18.PAGE_ALLOWED_CHILD_TYPES],
+    maxNestingDepth: import_core18.COMPOUND_MAX_NESTING_DEPTH.Page,
+    props: [
+      { name: "blockId", type: "BlockId", required: true, description: "Stable block id." },
+      { name: "title", type: "string", required: false, description: "Page title." },
+      { name: "children", type: "ReactNode", required: true, description: "Page content." }
+    ],
+    requiredIds: [],
+    optionalIds: ["blockId"],
+    parentConstraints: ["Lesson", "InteractiveBook"],
+    a11y: { element: "section", ariaLabel: "Page", keyboard: "N/A", notes: "H5P Column equivalent." },
+    theming: { surface: "global-inherit", stylingNotes: "Container." },
+    telemetry: { emits: ["compound_page_viewed"], requiresActiveLesson: true }
+  },
+  {
+    type: "InteractiveBook",
+    category: "container",
+    compoundContract: true,
+    h5pMachineName: "H5P.InteractiveBook",
+    h5pAlias: "Interactive Book",
+    description: "Multi-page book with chapter navigation.",
+    allowedChildTypes: [...import_core18.INTERACTIVE_BOOK_ALLOWED_CHILD_TYPES],
+    maxNestingDepth: import_core18.COMPOUND_MAX_NESTING_DEPTH.InteractiveBook,
+    props: [
+      { name: "blockId", type: "BlockId", required: true, description: "Stable block id." },
+      { name: "title", type: "string", required: true, description: "Book title." },
+      { name: "showBookScore", type: "boolean", required: false, description: "Show aggregate score." },
+      { name: "children", type: "Page[]", required: true, description: "Page chapters." }
+    ],
+    requiredIds: ["blockId"],
+    parentConstraints: ["Lesson"],
+    a11y: {
+      element: "section",
+      ariaLabel: "Interactive book",
+      keyboard: "Previous/Next chapter navigation.",
+      notes: "H5P Interactive Book equivalent."
+    },
+    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: [...import_core18.SLIDE_ALLOWED_CHILD_TYPES],
+    maxNestingDepth: import_core18.COMPOUND_MAX_NESTING_DEPTH.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: [...import_core18.SLIDE_DECK_ALLOWED_CHILD_TYPES],
+    maxNestingDepth: import_core18.COMPOUND_MAX_NESTING_DEPTH.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",
+    h5pMachineName: "H5P.Accordion",
+    h5pAlias: "Accordion",
+    description: "Expandable sections.",
+    props: [
+      { name: "blockId", type: "BlockId", required: true, description: "Stable block id." },
+      { name: "sections", type: "AccordionSection[]", required: true, description: "Sections." }
+    ],
+    requiredIds: ["blockId"],
+    parentConstraints: [...COMPOUND_PARENTS],
+    a11y: { element: "section", ariaLabel: "Accordion", keyboard: "Button toggles sections.", notes: "No nested accordions." },
+    theming: { surface: "global-inherit", stylingNotes: "Disclosure pattern." },
+    telemetry: { emits: ["accordion_section_toggled"] }
+  },
+  {
+    type: "DialogCards",
+    category: "content",
+    h5pMachineName: "H5P.Dialogcards",
+    h5pAlias: "Dialog Cards",
+    description: "Flip cards with front/back text.",
+    props: [
+      { name: "blockId", type: "BlockId", required: true, description: "Stable block id." },
+      { name: "cards", type: "DialogCard[]", required: true, description: "Cards." }
+    ],
+    requiredIds: ["blockId"],
+    parentConstraints: [...COMPOUND_PARENTS],
+    a11y: { element: "section", ariaLabel: "Dialog cards", keyboard: "Flip and navigate cards.", notes: "Reduced motion safe." },
+    theming: { surface: "global-inherit", stylingNotes: "Card flip." },
+    telemetry: { emits: [] }
+  },
+  {
+    type: "Flashcards",
+    category: "content",
+    h5pMachineName: "H5P.Flashcards",
+    h5pAlias: "Flashcards",
+    description: "Study flashcards with optional self-score.",
+    props: [
+      { name: "blockId", type: "BlockId", required: true, description: "Stable block id." },
+      { name: "cards", type: "Flashcard[]", required: true, description: "Cards." },
+      { name: "selfScore", type: "boolean", required: false, description: "Self-score mode." }
+    ],
+    requiredIds: ["blockId"],
+    parentConstraints: [...COMPOUND_PARENTS],
+    a11y: { element: "section", ariaLabel: "Flashcards", keyboard: "Flip and next.", notes: "Not LMS-scored by default." },
+    theming: { surface: "global-inherit", stylingNotes: "Study mode." },
+    telemetry: { emits: ["flashcard_flipped"] }
+  },
+  {
+    type: "ImageHotspots",
+    category: "content",
+    h5pMachineName: "H5P.ImageHotspots",
+    h5pAlias: "Image Hotspots",
+    description: "Image with clickable hotspot popovers.",
+    props: [
+      { name: "blockId", type: "BlockId", required: true, description: "Stable block id." },
+      { name: "src", type: "string", required: true, description: "Image URL." },
+      { name: "alt", type: "string", required: true, description: "Alt text." },
+      { name: "hotspots", type: "HotspotSpec[]", required: true, description: "Hotspots." }
+    ],
+    requiredIds: ["blockId"],
+    parentConstraints: [...COMPOUND_PARENTS],
+    a11y: { element: "section", ariaLabel: "Image hotspots", keyboard: "Buttons on image.", notes: "Popover dialog." },
+    theming: { surface: "global-inherit", stylingNotes: "Positioned hotspots." },
+    telemetry: { emits: ["hotspot_opened"] }
+  },
+  {
+    type: "ImageSlider",
+    category: "content",
+    h5pMachineName: "H5P.ImageSlider",
+    h5pAlias: "Image Slider",
+    description: "Carousel of images.",
+    props: [
+      { name: "blockId", type: "BlockId", required: true, description: "Stable block id." },
+      { name: "slides", type: "ImageSlide[]", required: true, description: "Slides." }
+    ],
+    requiredIds: ["blockId"],
+    parentConstraints: [...COMPOUND_PARENTS],
+    a11y: { element: "section", ariaLabel: "Image slider", keyboard: "Previous/next slide.", notes: "Carousel." },
+    theming: { surface: "global-inherit", stylingNotes: "Slider." },
+    telemetry: { emits: ["image_slider_changed"] }
+  },
+  {
+    type: "FindHotspot",
+    category: "assessment",
+    assessmentContract: true,
+    h5pMachineName: "H5P.ImageHotspotQuestion",
+    h5pAlias: "Find the Hotspot",
+    description: "Select the correct region on an image.",
+    props: [
+      { name: "checkId", type: "CheckId", required: true, description: "Stable check id." },
+      { name: "src", type: "string", required: true, description: "Image URL." },
+      { name: "alt", type: "string", required: true, description: "Alt text." },
+      { name: "targets", type: "HotspotTarget[]", required: true, description: "Targets." },
+      { name: "correctTargetId", type: "string", required: true, description: "Correct target id." },
+      ...assessmentBehaviourProps
+    ],
+    requiredIds: ["checkId"],
+    parentConstraints: [...COMPOUND_PARENTS],
+    a11y: { element: "section", ariaLabel: "Find the hotspot", keyboard: "Select target buttons.", notes: "Scored." },
+    theming: { surface: "global-inherit", dataAttributes: ["data-lk-check-id"], stylingNotes: "Uses data-lk-check-id." },
+    telemetry: { emits: ["assessment_answered", "assessment_completed"], requiresActiveLesson: true }
+  },
+  {
+    type: "FindMultipleHotspots",
+    category: "assessment",
+    assessmentContract: true,
+    h5pMachineName: "H5P.ImageMultipleHotspotQuestion",
+    h5pAlias: "Find Multiple Hotspots",
+    description: "Select all correct regions on an image.",
+    props: [
+      { name: "checkId", type: "CheckId", required: true, description: "Stable check id." },
+      { name: "src", type: "string", required: true, description: "Image URL." },
+      { name: "alt", type: "string", required: true, description: "Alt text." },
+      { name: "targets", type: "HotspotTarget[]", required: true, description: "Targets." },
+      { name: "correctTargetIds", type: "string[]", required: true, description: "Correct target ids." },
+      ...assessmentBehaviourProps
+    ],
+    requiredIds: ["checkId"],
+    parentConstraints: [...COMPOUND_PARENTS],
+    a11y: { element: "section", ariaLabel: "Find multiple hotspots", keyboard: "Toggle targets.", notes: "Scored." },
+    theming: { surface: "global-inherit", dataAttributes: ["data-lk-check-id"], stylingNotes: "Uses data-lk-check-id." },
+    telemetry: { emits: ["assessment_answered", "assessment_completed"], requiresActiveLesson: true }
+  }
+];
+function buildV3CatalogFromV2(v2) {
+  const patched = v2.map((entry) => {
+    const base = extendParents(entry);
+    if (entry.type === "AssessmentSequence") {
+      return {
+        ...base,
+        compoundContract: true,
+        allowedChildTypes: [...import_core18.ASSESSMENT_SEQUENCE_ALLOWED_CHILD_TYPES],
+        maxNestingDepth: import_core18.COMPOUND_MAX_NESTING_DEPTH.AssessmentSequence
+      };
+    }
+    return base;
+  });
+  return [...patched, ...v3CompoundAndContentEntries];
+}
+
 // src/blockCatalog.ts
 var blockCatalogVersion = 1;
 var blockCatalogV2Version = 2;
+var blockCatalogV3Version = 3;
 var BLOCK_CATALOG = [
   {
     type: "Course",
@@ -2484,7 +4701,7 @@ var BLOCK_CATALOG = [
     }
   }
 ];
-var assessmentBehaviourProps = [
+var assessmentBehaviourProps2 = [
   { name: "enableRetry", type: "boolean", required: false, description: "Allow retry after completion." },
   { name: "enableSolutionsButton", type: "boolean", required: false, description: "Show solution control." },
   { name: "autoCheck", type: "boolean", required: false, description: "Check answers automatically when possible." },
@@ -2502,7 +4719,7 @@ var v2AssessmentEntries = [
       { name: "checkId", type: "CheckId", required: true, description: "Stable check id." },
       { name: "question", type: "string", required: true, description: "Question text." },
       { name: "answer", type: "boolean", required: true, description: "Correct answer." },
-      ...assessmentBehaviourProps
+      ...assessmentBehaviourProps2
     ],
     requiredIds: ["checkId"],
     parentConstraints: ["Lesson", "AssessmentSequence"],
@@ -2527,7 +4744,7 @@ var v2AssessmentEntries = [
       { name: "checkId", type: "CheckId", required: true, description: "Stable check id." },
       { name: "template", type: "string", required: true, description: "Text with *blank* markers." },
       { name: "blanks", type: "FillInBlankSpec[]", required: false, description: "Explicit blank specs." },
-      ...assessmentBehaviourProps
+      ...assessmentBehaviourProps2
     ],
     requiredIds: ["checkId"],
     parentConstraints: ["Lesson", "AssessmentSequence"],
@@ -2551,7 +4768,7 @@ var v2AssessmentEntries = [
       { name: "checkId", type: "CheckId", required: true, description: "Stable check id." },
       { name: "items", type: "DragItem[]", required: true, description: "Draggable items." },
       { name: "targets", type: "DropTarget[]", required: true, description: "Drop targets." },
-      ...assessmentBehaviourProps
+      ...assessmentBehaviourProps2
     ],
     requiredIds: ["checkId"],
     parentConstraints: ["Lesson", "AssessmentSequence"],
@@ -2575,7 +4792,7 @@ var v2AssessmentEntries = [
       { name: "checkId", type: "CheckId", required: true, description: "Stable check id." },
       { name: "template", type: "string", required: true, description: "Sentence with *blank* zones." },
       { name: "words", type: "string[]", required: true, description: "Draggable word bank." },
-      ...assessmentBehaviourProps
+      ...assessmentBehaviourProps2
     ],
     requiredIds: ["checkId"],
     parentConstraints: ["Lesson", "AssessmentSequence"],
@@ -2599,7 +4816,7 @@ var v2AssessmentEntries = [
       { name: "checkId", type: "CheckId", required: true, description: "Stable check id." },
       { name: "text", type: "string", required: true, description: "Source text." },
       { name: "correctWords", type: "string[]", required: true, description: "Words to mark." },
-      ...assessmentBehaviourProps
+      ...assessmentBehaviourProps2
     ],
     requiredIds: ["checkId"],
     parentConstraints: ["Lesson", "AssessmentSequence"],
@@ -2621,7 +4838,7 @@ var v2AssessmentEntries = [
     props: [
       { name: "children", type: "ReactNode", required: true, description: "Assessment blocks." },
       { name: "sequential", type: "boolean", required: false, description: "One question at a time." },
-      ...assessmentBehaviourProps.filter((p) => p.name !== "passingScore")
+      ...assessmentBehaviourProps2.filter((p) => p.name !== "passingScore")
     ],
     requiredIds: [],
     parentConstraints: ["Lesson"],
@@ -2639,6 +4856,7 @@ var BLOCK_CATALOG_V2 = [
   ...BLOCK_CATALOG,
   ...v2AssessmentEntries
 ];
+var BLOCK_CATALOG_V3 = buildV3CatalogFromV2(BLOCK_CATALOG_V2);
 function cloneCatalogEntry(entry) {
   return {
     ...entry,
@@ -2646,6 +4864,7 @@ function cloneCatalogEntry(entry) {
     aliases: entry.aliases ? [...entry.aliases] : void 0,
     optionalIds: entry.optionalIds ? [...entry.optionalIds] : void 0,
     parentConstraints: entry.parentConstraints ? [...entry.parentConstraints] : void 0,
+    allowedChildTypes: entry.allowedChildTypes ? [...entry.allowedChildTypes] : void 0,
     a11y: { ...entry.a11y },
     theming: {
       ...entry.theming,
@@ -2658,35 +4877,51 @@ function cloneCatalogEntry(entry) {
   };
 }
 function buildBlockCatalog(opts) {
-  const version = opts?.version ?? 2;
-  const source = version === 2 ? BLOCK_CATALOG_V2 : BLOCK_CATALOG;
+  const version = opts?.version ?? 3;
+  const source = version === 3 ? BLOCK_CATALOG_V3 : version === 2 ? BLOCK_CATALOG_V2 : BLOCK_CATALOG;
   return source.map((entry) => cloneCatalogEntry(entry));
 }
 function getBlockCatalogEntry(type, opts) {
-  const version = opts?.version ?? 2;
-  const source = version === 2 ? BLOCK_CATALOG_V2 : BLOCK_CATALOG;
+  const version = opts?.version ?? 3;
+  const source = version === 3 ? BLOCK_CATALOG_V3 : version === 2 ? BLOCK_CATALOG_V2 : BLOCK_CATALOG;
   return source.find((entry) => entry.type === type || entry.aliases?.includes(type));
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  Accordion,
   AssessmentSequence,
   BLOCK_CATALOG,
   BLOCK_CATALOG_V2,
+  BLOCK_CATALOG_V3,
   Course,
+  DialogCards,
   DragAndDrop,
   DragTheWords,
   FillInTheBlanks,
+  FindHotspot,
+  FindMultipleHotspots,
+  Flashcards,
+  Heading,
+  Image,
+  ImageHotspots,
+  ImageSlider,
+  InteractiveBook,
   KnowledgeCheck,
   Lesson,
   LessonkitProvider,
   MarkTheWords,
+  Page,
   ProgressTracker,
   Quiz,
   Reflection,
   Scenario,
+  Slide,
+  SlideDeck,
+  Text,
   ThemeProvider,
   TrueFalse,
   blockCatalogV2Version,
+  blockCatalogV3Version,
   blockCatalogVersion,
   buildBlockCatalog,
   buildTelemetryEvent,