@lessonkit/react 1.4.0 → 1.5.0

package/dist/blocks-entry.cjs

@@ -33,9 +33,14 @@ __export(blocks_entry_exports, {
   Accordion: () => Accordion,
   ArithmeticQuiz: () => ArithmeticQuiz,
   AssessmentSequence: () => AssessmentSequence,
+  BranchChoice: () => BranchChoice,
+  BranchNode: () => BranchNode,
+  BranchingScenario: () => BranchingScenario,
+  Chart: () => Chart,
   DialogCards: () => DialogCards,
   DragAndDrop: () => DragAndDrop,
   DragTheWords: () => DragTheWords,
+  Embed: () => Embed,
   Essay: () => Essay,
   FillInTheBlanks: () => FillInTheBlanks,
   FindHotspot: () => FindHotspot,
@@ -336,9 +341,6 @@ var import_core10 = require("@lessonkit/core");
 // src/runtime/observability.ts
 var import_xapi = require("@lessonkit/xapi");
 
-// src/provider/useLessonkitProviderRuntime.ts
-var import_xapi5 = require("@lessonkit/xapi");
-
 // src/runtime/emitTelemetry.ts
 var import_core4 = require("@lessonkit/core");
 
@@ -349,36 +351,45 @@ var import_xapi2 = require("@lessonkit/xapi");
 // src/runtime/lxpackBridge.ts
 var import_bridge = require("@lessonkit/lxpack/bridge");
 
-// src/runtime/ports.ts
-var import_core5 = require("@lessonkit/core");
+// src/runtime/courseStartedPipeline.ts
+var import_xapi3 = require("@lessonkit/xapi");
 
-// src/provider/useLessonkitProviderRuntime.ts
-var import_core11 = require("@lessonkit/core");
+// src/runtime/plugins.ts
+var import_core5 = require("@lessonkit/core");
+function buildPluginContext(opts) {
+  return (0, import_core5.buildPluginContext)(opts);
+}
 
-// src/runtime/progress.ts
+// src/runtime/session.ts
 var import_core6 = require("@lessonkit/core");
 
-// src/runtime/xapi.ts
-var import_xapi3 = require("@lessonkit/xapi");
+// src/provider/courseStarted/emit.ts
+function createCourseStartedFlightScope() {
+  return {
+    trackingFlights: /* @__PURE__ */ new Map(),
+    emitFlights: /* @__PURE__ */ new Map()
+  };
+}
+var defaultFlightScope = createCourseStartedFlightScope();
 
-// src/runtime/session.ts
+// src/provider/useLessonkitProviderRuntime.ts
+var import_xapi5 = require("@lessonkit/xapi");
+
+// src/runtime/ports.ts
 var import_core7 = require("@lessonkit/core");
 
-// src/runtime/courseStartedPipeline.ts
-var import_xapi4 = require("@lessonkit/xapi");
+// src/provider/useLessonkitProviderRuntime.ts
+var import_core11 = require("@lessonkit/core");
 
-// src/runtime/plugins.ts
+// src/runtime/progress.ts
 var import_core8 = require("@lessonkit/core");
-function buildPluginContext(opts) {
-  return (0, import_core8.buildPluginContext)(opts);
-}
+
+// src/runtime/xapi.ts
+var import_xapi4 = require("@lessonkit/xapi");
 
 // src/runtime/telemetry.ts
 var import_core9 = require("@lessonkit/core");
 
-// src/provider/useLessonkitProviderRuntime.ts
-var defaultStorage = (0, import_core5.createSessionStoragePort)();
-
 // src/context.tsx
 var import_jsx_runtime5 = require("react/jsx-runtime");
 var LessonkitContext = (0, import_react8.createContext)(null);
@@ -418,14 +429,15 @@ function meetsPassingThreshold(score, maxScore, passingScore) {
 }
 function scoreFromCustom(custom, fallbackCorrect, fallbackMax = 1, passingScore) {
   const maxScore = custom?.maxScore ?? fallbackMax;
+  const hasNumericScore = custom?.score != null && Number.isFinite(custom.score);
+  if (hasNumericScore) {
+    const passed2 = custom.passed !== void 0 ? custom.passed : meetsPassingThreshold(custom.score, maxScore, passingScore);
+    return { score: custom.score, maxScore, passed: passed2 };
+  }
   if (custom?.passed !== void 0) {
-    const score2 = custom.passed ? custom.score ?? maxScore : custom.score ?? 0;
+    const score2 = custom.passed ? maxScore : 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 };
@@ -500,7 +512,7 @@ function TrueFalseInner(props, ref) {
     if (passed) {
       return { score: completedScore ?? maxScore, maxScore };
     }
-    if (selectionCorrect) {
+    if (selected !== null && selectionCorrect) {
       return { score: completedMaxScore ?? maxScore, maxScore };
     }
     return { score: 0, maxScore };
@@ -572,7 +584,9 @@ function TrueFalseInner(props, ref) {
           if (nextPassed) {
             const maxScore = nextCompletedMaxScore ?? completedMaxScore ?? 1;
             const score = nextCompletedScore ?? completedScore ?? maxScore;
-            replayTelemetry(nextSelected ?? null, nextCorrect ?? null, nextPassed, score, maxScore);
+            if (config.tracking?.replayResumeEvents === true) {
+              replayTelemetry(nextSelected ?? null, nextCorrect ?? null, nextPassed, score, maxScore);
+            }
           }
         }
         readBooleanStateField(state, "showSolutions", setShowSolutions);
@@ -588,7 +602,8 @@ function TrueFalseInner(props, ref) {
       props.question,
       selected,
       selectionCorrect,
-      showSolutions
+      showSolutions,
+      config.tracking?.replayResumeEvents
     ]
   );
   useAssessmentHandleRegistration(checkId, handle, ref);
@@ -617,6 +632,17 @@ function TrueFalseInner(props, ref) {
         maxScore: scored.maxScore,
         passingScore: props.passingScore ?? scored.maxScore
       });
+    } else if (!scored.passed && props.enableRetry === false && !completedRef.current) {
+      completedRef.current = true;
+      setCompletedScore(scored.score);
+      setCompletedMaxScore(scored.maxScore);
+      assessment.complete({
+        checkId,
+        interactionType: INTERACTION,
+        score: scored.score,
+        maxScore: scored.maxScore,
+        passingScore: props.passingScore ?? scored.maxScore
+      });
     }
   };
   const reveal = showSolutions || passed && props.enableSolutionsButton;
@@ -682,11 +708,13 @@ function MarkTheWordsInner(props, ref) {
   );
   const [marked, setMarked] = (0, import_react13.useState)(() => /* @__PURE__ */ new Set());
   const [passed, setPassed] = (0, import_react13.useState)(false);
+  const [submitted, setSubmitted] = (0, import_react13.useState)(false);
   const [showSolutions, setShowSolutions] = (0, import_react13.useState)(false);
   const completedRef = (0, import_react13.useRef)(false);
   const reset = () => {
     completedRef.current = false;
     setPassed(false);
+    setSubmitted(false);
     setMarked(/* @__PURE__ */ new Set());
     setShowSolutions(false);
   };
@@ -744,6 +772,27 @@ function MarkTheWordsInner(props, ref) {
       return next;
     });
   };
+  const submitMarks = () => {
+    if (!hasTargets || completedRef.current || marked.size === 0) return;
+    completedRef.current = true;
+    setSubmitted(true);
+    const didPass = passedThreshold;
+    if (didPass) setPassed(true);
+    assessment.answer({
+      checkId,
+      interactionType: INTERACTION2,
+      question: props.text,
+      response: [...marked].map((i) => tokens[i]),
+      correct: didPass
+    });
+    assessment.complete({
+      checkId,
+      interactionType: INTERACTION2,
+      score,
+      maxScore,
+      passingScore: props.passingScore ?? maxScore
+    });
+  };
   (0, import_react13.useEffect)(() => {
     if (!hasTargets) {
       if (isDevEnvironment()) {
@@ -754,8 +803,10 @@ function MarkTheWordsInner(props, ref) {
       }
       return;
     }
+    if (props.enableRetry === false) return;
     if (!passedThreshold || completedRef.current) return;
     completedRef.current = true;
+    setSubmitted(true);
     setPassed(true);
     assessment.answer({
       checkId,
@@ -778,6 +829,7 @@ function MarkTheWordsInner(props, ref) {
     marked,
     maxScore,
     passedThreshold,
+    props.enableRetry,
     props.passingScore,
     props.correctWords,
     props.text,
@@ -815,7 +867,8 @@ function MarkTheWordsInner(props, ref) {
         i
       );
     }) }),
-    allMarked ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("p", { role: "status", "aria-live": "polite", children: "Correct" }) : null,
+    passedThreshold ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("p", { role: "status", "aria-live": "polite", children: "Correct" }) : null,
+    props.enableRetry === false && hasTargets && marked.size > 0 && !submitted ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("button", { type: "button", "data-testid": "mark-the-words-submit", onClick: submitMarks, children: "Submit" }) : null,
     props.enableRetry && passed ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("button", { type: "button", onClick: reset, children: "Try again" }) : null,
     props.enableSolutionsButton && !showSolutions ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("button", { type: "button", onClick: () => setShowSolutions(true), children: "Show solution" }) : null
   ] });
@@ -856,11 +909,43 @@ function parseTemplate(template) {
     blanks: values.map((answer, i) => ({ id: `blank-${i}`, answer }))
   };
 }
+function normalizeBlanks(blanks) {
+  return blanks.map((b) => ({ id: b.id.trim(), answer: b.answer.trim() })).filter((b) => b.id.length > 0 && b.answer.length > 0);
+}
+function resolveBlanks(template, explicitBlanks) {
+  const parsed = parseTemplate(template);
+  if (!explicitBlanks) {
+    return { parts: parsed.parts, blanks: parsed.blanks };
+  }
+  const normalized = normalizeBlanks(explicitBlanks);
+  if (normalized.length !== parsed.blanks.length) {
+    if (isDevEnvironment()) {
+      console.warn(
+        "[lessonkit] FillInTheBlanks: blanks length does not match template; using parsed blanks",
+        { templateBlanks: parsed.blanks.length, explicitBlanks: normalized.length }
+      );
+    }
+    return { parts: parsed.parts, blanks: parsed.blanks };
+  }
+  let blankIdx = 0;
+  const interleavedParts = parsed.parts.map((part) => {
+    if (part.startsWith("blank-")) {
+      const id = normalized[blankIdx]?.id;
+      blankIdx += 1;
+      return id ?? part;
+    }
+    return part;
+  });
+  return { parts: interleavedParts, blanks: normalized };
+}
 function FillInTheBlanksInner(props, ref) {
   const checkId = (0, import_react14.useMemo)(() => normalizeComponentId(props.checkId, "checkId"), [props.checkId]);
   const assessment = useAssessmentState(props.enclosingLessonId);
-  const parsed = (0, import_react14.useMemo)(() => parseTemplate(props.template), [props.template]);
-  const blanks = props.blanks ?? parsed.blanks;
+  const { config } = useLessonkit();
+  const { parts, blanks } = (0, import_react14.useMemo)(
+    () => resolveBlanks(props.template, props.blanks),
+    [props.template, props.blanks]
+  );
   const [values, setValues] = (0, import_react14.useState)(
     () => Object.fromEntries(blanks.map((b) => [b.id, ""]))
   );
@@ -959,13 +1044,14 @@ function FillInTheBlanksInner(props, ref) {
         blanks.forEach((b) => {
           if ((nextValues[b.id] ?? "").trim().toLowerCase() === b.answer.toLowerCase()) nextScore += 1;
         });
-        replayTelemetry(nextValues, nextPassed, nextSubmitted, nextScore, blanks.length);
+        if (config.tracking?.replayResumeEvents === true) {
+          replayTelemetry(nextValues, nextPassed, nextSubmitted, nextScore, blanks.length);
+        }
       }
     }),
-    [allFilled, assessment, blanks, checkId, maxScore, passed, passedThreshold, props.passingScore, props.template, score, showSolutions, submitted, values]
+    [allFilled, assessment, blanks, checkId, config.tracking?.replayResumeEvents, maxScore, passed, passedThreshold, props.passingScore, props.template, score, showSolutions, submitted, values]
   );
-  useAssessmentHandleRegistration(checkId, handle, ref);
-  const check = () => {
+  const check = (0, import_react14.useCallback)(() => {
     if (!hasBlanks) {
       if (isDevEnvironment()) {
         console.warn("[lessonkit] FillInTheBlanks has no blanks in template");
@@ -973,7 +1059,7 @@ function FillInTheBlanksInner(props, ref) {
       return;
     }
     if (!allFilled) return;
-    if (passed) return;
+    if (passed && !props.enableRetry) return;
     const snapshot = JSON.stringify(values);
     if (checkSnapshotRef.current === snapshot) return;
     checkSnapshotRef.current = snapshot;
@@ -986,9 +1072,9 @@ function FillInTheBlanksInner(props, ref) {
       response: values,
       correct: passedThreshold
     });
-    if (passedThreshold && !completedRef.current) {
+    if ((passedThreshold || props.enableRetry === false) && !completedRef.current) {
       completedRef.current = true;
-      setPassed(true);
+      if (passedThreshold) setPassed(true);
       assessment.complete({
         checkId,
         interactionType: INTERACTION3,
@@ -997,7 +1083,22 @@ function FillInTheBlanksInner(props, ref) {
         passingScore: props.passingScore ?? maxScore
       });
     }
-  };
+  }, [
+    allFilled,
+    assessment,
+    blanks.length,
+    checkId,
+    hasBlanks,
+    maxScore,
+    passed,
+    passedThreshold,
+    props.enableRetry,
+    props.passingScore,
+    props.template,
+    score,
+    values
+  ]);
+  useAssessmentHandleRegistration(checkId, handle, ref);
   (0, import_react14.useEffect)(() => {
     if (!allFilled) {
       answeredRef.current = false;
@@ -1007,14 +1108,17 @@ function FillInTheBlanksInner(props, ref) {
   }, [allFilled]);
   (0, import_react14.useEffect)(() => {
     if (props.autoCheck && allFilled && !passed) check();
-  }, [allFilled, props.autoCheck, values, passedThreshold, passed]);
+  }, [allFilled, check, passed, props.autoCheck]);
   const reveal = showSolutions || passed && props.enableSolutionsButton;
   return /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)("section", { "aria-label": "Fill in the Blanks", "data-lk-check-id": checkId, children: [
-    /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("p", { children: parsed.parts.map((part, i) => {
+    /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("p", { children: parts.map((part, i) => {
       const blank = blanks.find((b) => b.id === part);
       if (!blank) return /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(import_react14.default.Fragment, { children: part }, i);
       return /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)("label", { style: { margin: "0 0.25em" }, children: [
-        /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("span", { className: "lk-visually-hidden", children: blank.answer }),
+        /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)("span", { className: "lk-visually-hidden", children: [
+          "Blank ",
+          blank.id
+        ] }),
         /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(
           "input",
           {
@@ -1031,7 +1135,16 @@ function FillInTheBlanksInner(props, ref) {
         )
       ] }, blank.id);
     }) }),
-    !props.autoCheck ? /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("button", { type: "button", "data-testid": "check-blanks", disabled: !allFilled || passed, onClick: check, children: "Check" }) : null,
+    !props.autoCheck ? /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(
+      "button",
+      {
+        type: "button",
+        "data-testid": "check-blanks",
+        disabled: !allFilled || passed && !props.enableRetry,
+        onClick: check,
+        children: "Check"
+      }
+    ) : null,
     !hasBlanks ? /* @__PURE__ */ (0, import_jsx_runtime8.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_runtime8.jsx)("p", { role: "status", "aria-live": "polite", children: passed || passedThreshold ? "Correct" : "Try again" }) : null,
     props.enableRetry && passed ? /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("button", { type: "button", onClick: reset, children: "Try again" }) : null,
@@ -1056,6 +1169,7 @@ function parseZones(template) {
 function DragTheWordsInner(props, ref) {
   const checkId = (0, import_react15.useMemo)(() => normalizeComponentId(props.checkId, "checkId"), [props.checkId]);
   const assessment = useAssessmentState(props.enclosingLessonId);
+  const { config } = useLessonkit();
   const { parts, answers } = (0, import_react15.useMemo)(() => parseZones(props.template), [props.template]);
   const [zones, setZones] = (0, import_react15.useState)(
     () => Object.fromEntries(answers.map((_, i) => [`zone-${i}`, ""]))
@@ -1160,10 +1274,12 @@ function DragTheWordsInner(props, ref) {
         answers.forEach((ans, i) => {
           if ((nextZones[`zone-${i}`] ?? "").trim().toLowerCase() === ans.toLowerCase()) nextScore += 1;
         });
-        replayTelemetry(nextZones, nextPassed, nextSubmitted, nextScore, answers.length);
+        if (config.tracking?.replayResumeEvents === true) {
+          replayTelemetry(nextZones, nextPassed, nextSubmitted, nextScore, answers.length);
+        }
       }
     }),
-    [allFilled, answers, assessment, checkId, keyboardWord, maxScore, passed, passedThreshold, pool, props.passingScore, props.template, score, submitted, zones]
+    [allFilled, answers, assessment, checkId, config.tracking?.replayResumeEvents, keyboardWord, maxScore, passed, passedThreshold, pool, props.passingScore, props.template, score, submitted, zones]
   );
   useAssessmentHandleRegistration(checkId, handle, ref);
   const placeInZone = (zoneId, word) => {
@@ -1206,9 +1322,9 @@ function DragTheWordsInner(props, ref) {
       response: zones,
       correct: passedThreshold
     });
-    if (passedThreshold && !completedRef.current) {
+    if ((passedThreshold || props.enableRetry === false) && !completedRef.current) {
       completedRef.current = true;
-      setPassed(true);
+      if (passedThreshold) setPassed(true);
       assessment.complete({
         checkId,
         interactionType: INTERACTION4,
@@ -1270,7 +1386,16 @@ function DragTheWordsInner(props, ref) {
         part
       );
     }) }),
-    /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("button", { type: "button", "data-testid": "check-drag-words", disabled: !allFilled || passed, onClick: check, children: "Check" }),
+    /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(
+      "button",
+      {
+        type: "button",
+        "data-testid": "check-drag-words",
+        disabled: !allFilled || passed && !props.enableRetry,
+        onClick: check,
+        children: "Check"
+      }
+    ),
     !hasZones ? /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("p", { role: "alert", children: "This activity has no drop zones. Wrap answers in asterisks in the template." }) : null,
     submitted ? /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("p", { role: "status", "aria-live": "polite", children: passed || passedThreshold ? "Correct" : "Try again" }) : null
   ] });
@@ -1284,6 +1409,37 @@ var DragTheWords = (0, import_react15.forwardRef)(function DragTheWords2(props,
 var import_react16 = require("react");
 var import_jsx_runtime10 = require("react/jsx-runtime");
 var INTERACTION5 = "dragAndDrop";
+function normalizeDragAndDropState(rawAssignments, rawPool, items, targets) {
+  const itemIds = new Set(items.map((i) => i.id));
+  const targetIds = targets.map((t) => t.id);
+  const assignments = Object.fromEntries(targetIds.map((id) => [id, ""]));
+  if (rawAssignments && typeof rawAssignments === "object") {
+    for (const targetId of targetIds) {
+      const value = rawAssignments[targetId];
+      if (typeof value === "string" && (value === "" || itemIds.has(value))) {
+        assignments[targetId] = value;
+      }
+    }
+  }
+  const assigned = new Set(Object.values(assignments).filter(Boolean));
+  const pool = [];
+  const seen = /* @__PURE__ */ new Set();
+  if (Array.isArray(rawPool)) {
+    for (const id of rawPool) {
+      if (typeof id === "string" && itemIds.has(id) && !assigned.has(id) && !seen.has(id)) {
+        pool.push(id);
+        seen.add(id);
+      }
+    }
+  }
+  for (const item of items) {
+    if (!assigned.has(item.id) && !seen.has(item.id)) {
+      pool.push(item.id);
+      seen.add(item.id);
+    }
+  }
+  return { assignments, pool };
+}
 function DragAndDropInner(props, ref) {
   const checkId = (0, import_react16.useMemo)(() => normalizeComponentId(props.checkId, "checkId"), [props.checkId]);
   const assessment = useAssessmentState(props.enclosingLessonId);
@@ -1333,11 +1489,14 @@ function DragAndDropInner(props, ref) {
       }),
       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]);
+        const normalized = normalizeDragAndDropState(
+          state.assignments,
+          state.pool,
+          props.items,
+          props.targets
+        );
+        setAssignments(normalized.assignments);
+        setPool(normalized.pool);
         readBooleanStateField(state, "passed", (value) => {
           setPassed(value);
           completedRef.current = value;
@@ -1370,9 +1529,9 @@ function DragAndDropInner(props, ref) {
       response: assignments,
       correct: passedThreshold
     });
-    if (passedThreshold && !completedRef.current) {
+    if ((passedThreshold || props.enableRetry === false) && !completedRef.current) {
       completedRef.current = true;
-      setPassed(true);
+      if (passedThreshold) setPassed(true);
       assessment.complete({
         checkId,
         interactionType: INTERACTION5,
@@ -1435,7 +1594,16 @@ function DragAndDropInner(props, ref) {
         )
       ] }, target.id);
     }) }),
-    /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("button", { type: "button", "data-testid": "check-drag-drop", disabled: !hasTargets || !allFilled || passed, onClick: check, children: "Check" }),
+    /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(
+      "button",
+      {
+        type: "button",
+        "data-testid": "check-drag-drop",
+        disabled: !hasTargets || !allFilled || passed && !props.enableRetry,
+        onClick: check,
+        children: "Check"
+      }
+    ),
     checked ? /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("p", { role: "status", "aria-live": "polite", children: passedThreshold ? "Correct" : "Try again" }) : null
   ] });
 }
@@ -1446,11 +1614,11 @@ var DragAndDrop = (0, import_react16.forwardRef)(function DragAndDrop2(props, re
 
 // src/blocks/AssessmentSequence.tsx
 var import_react22 = __toESM(require("react"), 1);
-var import_core17 = require("@lessonkit/core");
+var import_core19 = require("@lessonkit/core");
 
 // src/compound/useCompoundShell.ts
 var import_react20 = require("react");
-var import_core15 = require("@lessonkit/core");
+var import_core17 = require("@lessonkit/core");
 
 // src/compound/useCompoundNavigation.ts
 var import_react17 = require("react");
@@ -1474,28 +1642,132 @@ function useCompoundNavigation(pageCount, index, setIndex) {
 
 // src/compound/useCompoundPersistence.ts
 var import_react19 = require("react");
-var import_core14 = require("@lessonkit/core");
+var import_core16 = require("@lessonkit/core");
+
+// src/compound/compoundHydration.ts
+var hydratedKeys = /* @__PURE__ */ new Set();
+function compoundHydrationKey(courseId, compoundId) {
+  return `${courseId}:${compoundId}`;
+}
+function markCompoundHydrated(key) {
+  hydratedKeys.add(key);
+}
+function isCompoundHydrated(key) {
+  return hydratedKeys.has(key);
+}
+function clearCompoundHydrated(key) {
+  hydratedKeys.delete(key);
+}
+
+// src/compound/useCompoundBranchShell.ts
+var import_core12 = require("@lessonkit/core");
+var BS_META_KEY = "__lk_bs__";
+function createInitialBranchMeta(startNodeId) {
+  return { activeNodeId: startNodeId, visitedNodeIds: [startNodeId] };
+}
+function readBranchingScenarioMeta(childStates) {
+  const raw = childStates[BS_META_KEY];
+  if (!raw || typeof raw !== "object") return null;
+  const activeNodeId = typeof raw.activeNodeId === "string" ? raw.activeNodeId : "";
+  const visitedNodeIds = Array.isArray(raw.visitedNodeIds) ? raw.visitedNodeIds.filter((id) => typeof id === "string") : [];
+  const choiceScores = raw.choiceScores && typeof raw.choiceScores === "object" && !Array.isArray(raw.choiceScores) ? raw.choiceScores : void 0;
+  if (!activeNodeId) return null;
+  return { activeNodeId, visitedNodeIds, choiceScores };
+}
+function sanitizeBranchMeta(meta, nodeIndexMap, startNodeId, validChoiceKeys) {
+  const knownIds = new Set(nodeIndexMap.keys());
+  const activeNodeId = knownIds.has(meta.activeNodeId) ? meta.activeNodeId : startNodeId;
+  const visitedNodeIds = meta.visitedNodeIds.filter((id) => knownIds.has(id));
+  if (!visitedNodeIds.includes(activeNodeId)) {
+    visitedNodeIds.push(activeNodeId);
+  }
+  if (visitedNodeIds.length === 0) {
+    visitedNodeIds.push(startNodeId);
+  }
+  const choiceScores = meta.choiceScores ? Object.fromEntries(
+    Object.entries(meta.choiceScores).filter(
+      ([key]) => validChoiceKeys ? validChoiceKeys.has(key) : knownIds.has(key.split(":")[0] ?? "")
+    )
+  ) : void 0;
+  return {
+    activeNodeId,
+    visitedNodeIds,
+    ...Object.keys(choiceScores ?? {}).length > 0 ? { choiceScores } : {}
+  };
+}
+function mergeBranchMetaIntoState(state, meta) {
+  return {
+    ...state,
+    childStates: {
+      ...state.childStates,
+      [BS_META_KEY]: meta
+    }
+  };
+}
+function choiceScoreKey(fromNodeId, toNodeId) {
+  return `${fromNodeId}:${toNodeId}`;
+}
+function applyChoiceScoreUpdate(prev, fromNodeId, toNodeId, scoreWeight) {
+  if (scoreWeight === void 0) return prev;
+  const next = { ...prev ?? {} };
+  for (const key of Object.keys(next)) {
+    if (key.startsWith(`${fromNodeId}:`)) {
+      delete next[key];
+    }
+  }
+  next[choiceScoreKey(fromNodeId, toNodeId)] = scoreWeight;
+  return next;
+}
+function sumChoiceScores(choiceScores) {
+  if (!choiceScores) return 0;
+  return Object.values(choiceScores).reduce((sum, value) => sum + (Number.isFinite(value) ? value : 0), 0);
+}
+
+// src/compound/useCompoundVideoShell.ts
+var import_core13 = require("@lessonkit/core");
+var IV_META_KEY = "__lk_iv__";
+function readInteractiveVideoMeta(childStates) {
+  const raw = childStates[IV_META_KEY];
+  if (!raw || typeof raw !== "object") return null;
+  const currentTime = typeof raw.currentTime === "number" ? raw.currentTime : 0;
+  const completedCueIndices = Array.isArray(raw.completedCueIndices) ? raw.completedCueIndices.filter((n) => typeof n === "number") : [];
+  const firedCueIndices = Array.isArray(raw.firedCueIndices) ? raw.firedCueIndices.filter((n) => typeof n === "number") : completedCueIndices;
+  return { currentTime, completedCueIndices, firedCueIndices };
+}
+function mergeVideoMetaIntoState(state, meta) {
+  return {
+    ...state,
+    childStates: {
+      ...state.childStates,
+      [IV_META_KEY]: meta
+    }
+  };
+}
 
 // src/compound/resumeChildHandles.ts
-function filterRegisteredChildStates(handles, childStates) {
+var DEFAULT_PRESERVED_CHILD_STATE_KEYS = /* @__PURE__ */ new Set([BS_META_KEY, IV_META_KEY]);
+function registerablePendingKeys(childStates, preserveKeys = DEFAULT_PRESERVED_CHILD_STATE_KEYS) {
+  return Object.keys(childStates).filter((key) => !preserveKeys.has(key));
+}
+function filterRegisteredChildStates(handles, childStates, preserveKeys = DEFAULT_PRESERVED_CHILD_STATE_KEYS) {
   const filtered = {};
   for (const [key, value] of Object.entries(childStates)) {
-    if (handles.has(key)) {
+    if (preserveKeys.has(key) || 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) {
+  const registerableKeys = registerablePendingKeys(childStates);
+  if (opts?.waitForHandles && registerableKeys.length > 0) {
     if (handles.size === 0) return false;
-    const registeredPending = pendingKeys.filter((k) => handles.has(k));
+    const registeredPending = registerableKeys.filter((k) => handles.has(k));
     if (registeredPending.length === 0) {
       return false;
     }
-    if (registeredPending.length < pendingKeys.length) {
+    if (registeredPending.length < registerableKeys.length) {
       for (const key of registeredPending) {
         if (alreadyResumed?.has(key)) continue;
         const handle = handles.get(key);
@@ -1521,24 +1793,36 @@ function resumeChildHandles(handles, childStates, opts) {
 
 // src/compound/useCompoundResume.ts
 var import_react18 = require("react");
-var import_core12 = require("@lessonkit/core");
-var import_core13 = require("@lessonkit/core");
-var warnedCompoundPersistFailure = false;
-function warnCompoundPersistFailure() {
-  if (warnedCompoundPersistFailure || !isDevEnvironment()) return;
-  warnedCompoundPersistFailure = true;
+var import_core14 = require("@lessonkit/core");
+var import_core15 = require("@lessonkit/core");
+
+// src/compound/compoundLoadOpts.ts
+function compoundLoadOpts(ctx, compoundId) {
+  const onCorruptHook = ctx?.config?.observability?.onCompoundResumeCorrupt;
+  if (!onCorruptHook) return void 0;
+  return {
+    onCorrupt: () => onCorruptHook({ compoundId, corrupt: true }),
+    onDroppedChildKeys: (droppedChildKeys) => onCorruptHook({ compoundId, droppedChildKeys })
+  };
+}
+
+// src/compound/useCompoundResume.ts
+var warnedCompoundPersistFailures = /* @__PURE__ */ new Set();
+function warnCompoundPersistFailure(compoundId) {
+  if (warnedCompoundPersistFailures.has(compoundId) || !isDevEnvironment()) return;
+  warnedCompoundPersistFailures.add(compoundId);
   console.warn(
-    "[lessonkit] compound resume state could not be saved to sessionStorage (quota or privacy mode); progress may be lost on reload."
+    `[lessonkit] compound resume state for "${compoundId}" could not be saved to sessionStorage (quota or privacy mode); progress may be lost on reload.`
   );
 }
 function useCompoundResume(opts) {
   const lessonkitCtx = (0, import_react18.useContext)(LessonkitContext);
-  const storageRef = (0, import_react18.useRef)(opts.storage ?? lessonkitCtx?.storage ?? (0, import_core13.createSessionStoragePort)());
+  const storageRef = (0, import_react18.useRef)(opts.storage ?? lessonkitCtx?.storage ?? (0, import_core15.createSessionStoragePort)());
   const resumedRef = (0, import_react18.useRef)(false);
   const resumeKeyRef = (0, import_react18.useRef)("");
   const prevEnabledRef = (0, import_react18.useRef)(opts.enabled);
   (0, import_react18.useEffect)(() => {
-    storageRef.current = opts.storage ?? lessonkitCtx?.storage ?? (0, import_core13.createSessionStoragePort)();
+    storageRef.current = opts.storage ?? lessonkitCtx?.storage ?? (0, import_core15.createSessionStoragePort)();
   }, [opts.storage, lessonkitCtx?.storage]);
   (0, import_react18.useEffect)(() => {
     if (!prevEnabledRef.current && opts.enabled) {
@@ -1551,7 +1835,16 @@ function useCompoundResume(opts) {
       resumedRef.current = false;
     }
     if (!opts.enabled || !opts.courseId || resumedRef.current) return;
-    const saved = (0, import_core12.loadCompoundState)(storageRef.current, opts.courseId, opts.compoundId);
+    if (isCompoundHydrated(key)) {
+      resumedRef.current = true;
+      return;
+    }
+    const saved = (0, import_core14.loadCompoundState)(
+      storageRef.current,
+      opts.courseId,
+      opts.compoundId,
+      compoundLoadOpts(lessonkitCtx, opts.compoundId)
+    );
     if (saved) {
       resumedRef.current = true;
       opts.onResume?.(saved);
@@ -1560,26 +1853,31 @@ function useCompoundResume(opts) {
   return (0, import_react18.useCallback)(
     (state) => {
       if (!opts.enabled || !opts.courseId) return;
-      const persisted = (0, import_core12.saveCompoundState)(storageRef.current, opts.courseId, opts.compoundId, state);
-      if (!persisted) warnCompoundPersistFailure();
+      const persisted = (0, import_core14.saveCompoundState)(storageRef.current, opts.courseId, opts.compoundId, state);
+      if (!persisted) warnCompoundPersistFailure(opts.compoundId);
     },
     [opts.enabled, opts.courseId, opts.compoundId]
   );
 }
 
 // src/compound/useCompoundPersistence.ts
-function readCompoundInitialIndex(courseId, compoundId, pageCount, enabled, storage = (0, import_core14.createSessionStoragePort)()) {
+var MAX_HYDRATION_RETRIES = 10;
+function isEmptyResumeState(state) {
+  if (!state || typeof state !== "object") return true;
+  return Object.keys(state).length === 0;
+}
+function readCompoundInitialIndex(courseId, compoundId, pageCount, enabled, storage = (0, import_core16.createSessionStoragePort)()) {
   if (!enabled || !courseId || pageCount < 1) return 0;
-  const saved = (0, import_core14.loadCompoundState)(storage, courseId, compoundId);
+  const saved = (0, import_core16.loadCompoundState)(storage, courseId, compoundId);
   if (!saved) return 0;
-  return (0, import_core14.clampCompoundPageIndex)(saved.activePageIndex, pageCount);
+  return (0, import_core16.clampCompoundPageIndex)(saved.activePageIndex, pageCount);
 }
 function stripOrphanChildStates(handles, childStates) {
   return filterRegisteredChildStates(handles, childStates);
 }
 function useCompoundPersistence(opts) {
   const lessonkitCtx = (0, import_react19.useContext)(LessonkitContext);
-  const storage = opts.storage ?? lessonkitCtx?.storage ?? (0, import_core14.createSessionStoragePort)();
+  const storage = opts.storage ?? lessonkitCtx?.storage ?? (0, import_core16.createSessionStoragePort)();
   const ctx = useCompoundRegistry();
   const handlesVersion = useCompoundHandlesVersion();
   const bridgeRef = useCompoundHydrationBridgeRef();
@@ -1587,25 +1885,21 @@ function useCompoundPersistence(opts) {
   const resumedChildKeysRef = (0, import_react19.useRef)(/* @__PURE__ */ new Set());
   const loadedChildStatesRef = (0, import_react19.useRef)({});
   const skipSaveUntilHydratedRef = (0, import_react19.useRef)(false);
+  const postResumePersistPendingRef = (0, import_react19.useRef)(false);
   const hydrationKeyRef = (0, import_react19.useRef)("");
-  const hydrationInitRef = (0, import_react19.useRef)(false);
+  const hydrationRetryRef = (0, import_react19.useRef)(0);
   const hydrationKey = `${opts.courseId ?? ""}:${opts.compoundId}`;
   if (hydrationKeyRef.current !== hydrationKey) {
+    if (hydrationKeyRef.current) {
+      clearCompoundHydrated(hydrationKeyRef.current);
+    }
     hydrationKeyRef.current = hydrationKey;
-    hydrationInitRef.current = false;
     loadedChildStatesRef.current = {};
     skipSaveUntilHydratedRef.current = false;
+    postResumePersistPendingRef.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;
-    }
+    hydrationRetryRef.current = 0;
   }
   const buildState = (0, import_react19.useCallback)(() => {
     const childStates = {
@@ -1613,22 +1907,35 @@ function useCompoundPersistence(opts) {
     };
     if (ctx) {
       for (const [checkId, entry] of ctx.getRegisteredHandles()) {
+        if (opts.shouldIncludeChildState && !opts.shouldIncludeChildState(checkId, entry.pageIndex)) {
+          continue;
+        }
         const handle = entry.handle;
         if (handle.getCurrentState) {
-          childStates[checkId] = handle.getCurrentState();
-          delete loadedChildStatesRef.current[checkId];
+          const live = handle.getCurrentState();
+          const loaded = loadedChildStatesRef.current[checkId];
+          if (loaded !== void 0 && isEmptyResumeState(live)) {
+            childStates[checkId] = loaded;
+          } else {
+            childStates[checkId] = live;
+            if (!isEmptyResumeState(live)) {
+              delete loadedChildStatesRef.current[checkId];
+            }
+          }
         }
       }
     }
-    return (0, import_core14.createCompoundResumeState)({
-      activePageIndex: (0, import_core14.clampCompoundPageIndex)(opts.index, opts.pageCount),
+    return (0, import_core16.createCompoundResumeState)({
+      activePageIndex: (0, import_core16.clampCompoundPageIndex)(opts.index, opts.pageCount),
       childStates
     });
-  }, [ctx, opts.index, opts.pageCount]);
+  }, [ctx, opts.index, opts.pageCount, opts.shouldIncludeChildState]);
   const buildStateRef = (0, import_react19.useRef)(buildState);
   buildStateRef.current = buildState;
   const transformStateRef = (0, import_react19.useRef)(opts.transformState);
   transformStateRef.current = opts.transformState;
+  const onCompoundResumeRef = (0, import_react19.useRef)(opts.onCompoundResume);
+  onCompoundResumeRef.current = opts.onCompoundResume;
   const persistNowRef = (0, import_react19.useRef)(() => {
   });
   const finalizeHydration = (0, import_react19.useCallback)(
@@ -1639,10 +1946,19 @@ function useCompoundPersistence(opts) {
       };
       skipSaveUntilHydratedRef.current = false;
       pendingChildResumeRef.current = null;
-      queueMicrotask(() => persistNowRef.current());
+      hydrationRetryRef.current = 0;
+      postResumePersistPendingRef.current = true;
+      requestAnimationFrame(() => {
+        requestAnimationFrame(() => {
+          postResumePersistPendingRef.current = false;
+          persistNowRef.current();
+        });
+      });
     },
     []
   );
+  const applyPendingChildResumeRef = (0, import_react19.useRef)(() => {
+  });
   const applyPendingChildResume = (0, import_react19.useCallback)(() => {
     const pending = pendingChildResumeRef.current;
     if (!pending || !ctx) return;
@@ -1652,62 +1968,125 @@ function useCompoundPersistence(opts) {
       alreadyResumed: resumedChildKeysRef.current
     });
     if (!applied) {
-      if (handles.size === 0) {
-        const registeredOnly2 = stripOrphanChildStates(handles, pending.childStates);
-        resumeChildHandles(handles, registeredOnly2, {
-          alreadyResumed: resumedChildKeysRef.current
-        });
-        finalizeHydration(registeredOnly2);
+      const registerable = registerablePendingKeys(pending.childStates);
+      const missing = registerable.filter((k) => !handles.has(k));
+      if (missing.length > 0 && hydrationRetryRef.current < MAX_HYDRATION_RETRIES) {
+        hydrationRetryRef.current += 1;
+        requestAnimationFrame(() => applyPendingChildResumeRef.current());
         return;
       }
-      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);
+      if (missing.length > 0 && isDevEnvironment()) {
+        console.warn(
+          `[lessonkit] Compound hydration: ${missing.length} child state(s) not restored (missing handles: ${missing.join(", ")})`
+        );
+      }
+      lessonkitCtx?.config?.observability?.onCompoundHydrationPartial?.({
+        compoundId: opts.compoundId,
+        missingCheckIds: missing
+      });
+      for (const key of missing) {
+        const state = pending.childStates[key];
+        if (state) {
+          loadedChildStatesRef.current[key] = state;
+        }
+      }
+      const registeredOnly2 = stripOrphanChildStates(handles, pending.childStates);
+      resumeChildHandles(handles, registeredOnly2, {
+        alreadyResumed: resumedChildKeysRef.current
+      });
+      finalizeHydration({
+        ...loadedChildStatesRef.current,
+        ...registeredOnly2
       });
       return;
     }
     const registeredOnly = stripOrphanChildStates(handles, pending.childStates);
     finalizeHydration(registeredOnly);
   }, [ctx, finalizeHydration]);
+  applyPendingChildResumeRef.current = applyPendingChildResume;
+  (0, import_react19.useLayoutEffect)(() => {
+    if (!opts.enabled || !opts.courseId) return;
+    markCompoundHydrated(compoundHydrationKey(opts.courseId, opts.compoundId));
+    const saved = (0, import_core16.loadCompoundState)(storage, opts.courseId, opts.compoundId);
+    if (!saved) return;
+    if (Object.keys(saved.childStates).length > 0) {
+      loadedChildStatesRef.current = { ...saved.childStates };
+      skipSaveUntilHydratedRef.current = true;
+      pendingChildResumeRef.current = saved;
+    }
+    const clamped = (0, import_core16.clampCompoundPageIndex)(saved.activePageIndex, opts.pageCount);
+    onCompoundResumeRef.current?.({ ...saved, activePageIndex: clamped });
+    opts.setIndex(clamped);
+    queueMicrotask(() => applyPendingChildResumeRef.current());
+  }, [hydrationKey, opts.courseId, opts.compoundId, opts.enabled, opts.pageCount, storage]);
   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);
+      const clamped = (0, import_core16.clampCompoundPageIndex)(state.activePageIndex, opts.pageCount);
       loadedChildStatesRef.current = { ...state.childStates };
       skipSaveUntilHydratedRef.current = Object.keys(state.childStates).length > 0;
+      onCompoundResumeRef.current?.({ ...state, activePageIndex: clamped });
       opts.setIndex(clamped);
       resumedChildKeysRef.current = /* @__PURE__ */ new Set();
+      hydrationRetryRef.current = 0;
       pendingChildResumeRef.current = { ...state, activePageIndex: clamped, childStates: state.childStates };
       queueMicrotask(() => applyPendingChildResume());
     }
   });
-  const persistNow = (0, import_react19.useCallback)(() => {
-    if (!opts.enabled || !opts.courseId) return;
-    if (skipSaveUntilHydratedRef.current) return;
-    const built = buildStateRef.current();
-    const state = transformStateRef.current ? transformStateRef.current(built) : built;
-    saveResume(state);
-  }, [opts.enabled, opts.courseId, saveResume]);
+  const buildBestEffortState = (0, import_react19.useCallback)(() => {
+    const childStates = {
+      ...loadedChildStatesRef.current
+    };
+    if (ctx) {
+      for (const [checkId, entry] of ctx.getRegisteredHandles()) {
+        if (opts.shouldIncludeChildState && !opts.shouldIncludeChildState(checkId, entry.pageIndex)) {
+          continue;
+        }
+        const handle = entry.handle;
+        if (handle.getCurrentState) {
+          const live = handle.getCurrentState();
+          if (!isEmptyResumeState(live)) {
+            childStates[checkId] = live;
+          }
+        }
+      }
+    }
+    const built = (0, import_core16.createCompoundResumeState)({
+      activePageIndex: (0, import_core16.clampCompoundPageIndex)(opts.index, opts.pageCount),
+      childStates
+    });
+    return transformStateRef.current ? transformStateRef.current(built) : built;
+  }, [ctx, opts.index, opts.pageCount, opts.shouldIncludeChildState]);
+  const persistNow = (0, import_react19.useCallback)(
+    (options) => {
+      if (!opts.enabled || !opts.courseId) return;
+      if (options?.forceDuringHydration) {
+        saveResume(buildBestEffortState());
+        return;
+      }
+      if (skipSaveUntilHydratedRef.current) return;
+      if (postResumePersistPendingRef.current) return;
+      const built = buildStateRef.current();
+      const state = transformStateRef.current ? transformStateRef.current(built) : built;
+      saveResume(state);
+    },
+    [opts.enabled, opts.courseId, saveResume, buildBestEffortState]
+  );
   (0, import_react19.useEffect)(() => {
     persistNowRef.current = persistNow;
   }, [persistNow]);
   const notifyImperativeResume = (0, import_react19.useCallback)(
     (state) => {
-      const clamped = (0, import_core14.clampCompoundPageIndex)(state.activePageIndex, opts.pageCount);
+      const clamped = (0, import_core16.clampCompoundPageIndex)(state.activePageIndex, opts.pageCount);
       loadedChildStatesRef.current = { ...state.childStates };
       skipSaveUntilHydratedRef.current = Object.keys(state.childStates).length > 0;
+      onCompoundResumeRef.current?.({ ...state, activePageIndex: clamped });
       opts.setIndex(clamped);
       resumedChildKeysRef.current = /* @__PURE__ */ new Set();
+      hydrationRetryRef.current = 0;
       pendingChildResumeRef.current = { ...state, activePageIndex: clamped, childStates: state.childStates };
       queueMicrotask(() => applyPendingChildResume());
     },
@@ -1727,17 +2106,22 @@ function useCompoundPersistence(opts) {
   }, [opts.index, handlesVersion, applyPendingChildResume]);
   (0, import_react19.useEffect)(() => {
     persistNow();
-  }, [persistNow, opts.index, opts.pageCount, handlesVersion]);
+  }, [persistNow, opts.index, opts.pageCount, handlesVersion, opts.persistTrigger]);
   (0, import_react19.useEffect)(() => {
     if (!opts.enabled || !opts.courseId || typeof document === "undefined") return;
     const flushOnExit = () => {
-      if (document.visibilityState === "hidden") persistNow();
+      if (document.visibilityState === "hidden") {
+        persistNow({ forceDuringHydration: skipSaveUntilHydratedRef.current });
+      }
     };
     document.addEventListener("visibilitychange", flushOnExit);
-    window.addEventListener("pagehide", flushOnExit);
+    const flushOnPageHide = () => {
+      persistNow({ forceDuringHydration: skipSaveUntilHydratedRef.current });
+    };
+    window.addEventListener("pagehide", flushOnPageHide);
     return () => {
       document.removeEventListener("visibilitychange", flushOnExit);
-      window.removeEventListener("pagehide", flushOnExit);
+      window.removeEventListener("pagehide", flushOnPageHide);
     };
   }, [opts.enabled, opts.courseId, persistNow]);
 }
@@ -1753,10 +2137,12 @@ function useCompoundShell(opts) {
     setIndex: opts.setIndex,
     enabled: opts.persistEnabled,
     storage: opts.storage,
-    transformState: opts.transformState
+    transformState: opts.transformState,
+    persistTrigger: opts.persistTrigger,
+    onCompoundResume: opts.onCompoundResume
   });
   const { goNext, goPrev, progress } = useCompoundNavigation(opts.pageCount, opts.index, opts.setIndex);
-  const visibleIndex = (0, import_core15.clampCompoundPageIndex)(opts.index, opts.pageCount);
+  const visibleIndex = (0, import_core17.clampCompoundPageIndex)(opts.index, opts.pageCount);
   useCompoundHandleRef(opts.ref, {
     activePageIndex: visibleIndex,
     setActivePageIndex: opts.setIndex,
@@ -1782,7 +2168,7 @@ function useCompoundInitialIndex(opts) {
 
 // src/compound/validateChildren.ts
 var import_react21 = __toESM(require("react"), 1);
-var import_core16 = require("@lessonkit/core");
+var import_core18 = require("@lessonkit/core");
 
 // src/compound/blockType.ts
 var LESSONKIT_BLOCK_TYPE = /* @__PURE__ */ Symbol.for("lessonkit.blockType");
@@ -1810,7 +2196,9 @@ var COMPOUND_CONTAINER_TYPES = /* @__PURE__ */ new Set([
   "SlideDeck",
   "TimedCue",
   "InteractiveVideo",
-  "AssessmentSequence"
+  "AssessmentSequence",
+  "BranchingScenario",
+  "BranchNode"
 ]);
 function warnOrThrow(msg, strict) {
   if (strict) throw new Error(msg);
@@ -1829,7 +2217,7 @@ function validateNode(parent, node, depth, strict) {
       }
       return;
     }
-    if (!(0, import_core16.isChildTypeAllowed)(parent, blockType)) {
+    if (!(0, import_core18.isChildTypeAllowed)(parent, blockType)) {
       const key = `${parent}:${blockType}`;
       if (!warnedPairs.has(key)) {
         warnedPairs.add(key);
@@ -1839,7 +2227,7 @@ function validateNode(parent, node, depth, strict) {
       }
     }
     if (COMPOUND_CONTAINER_TYPES.has(blockType)) {
-      const maxDepth = import_core16.COMPOUND_MAX_NESTING_DEPTH[parent];
+      const maxDepth = import_core18.COMPOUND_MAX_NESTING_DEPTH[parent];
       if (depth >= maxDepth) {
         warnOrThrow(
           `[lessonkit] Block "${blockType}" exceeds max nesting depth (${maxDepth}) for "${parent}"`,
@@ -1854,7 +2242,7 @@ function validateNode(parent, node, depth, strict) {
     } else if (child.props && typeof child.props === "object" && "children" in child.props) {
       validateSubtreeForForbidden(
         child.props.children,
-        import_core16.ACCORDION_FORBIDDEN_CHILD_TYPES,
+        import_core18.ACCORDION_FORBIDDEN_CHILD_TYPES,
         strict
       );
     }
@@ -1882,23 +2270,29 @@ function validateSubtreeForForbidden(node, forbidden, strict) {
   });
 }
 function validateAccordionSections(sections, strict) {
-  if (!isDevEnvironment() && !strict) return;
+  const enforceStrict = strict ?? !isDevEnvironment();
   for (const section of sections) {
-    validateSubtreeForForbidden(section.content, import_core16.ACCORDION_FORBIDDEN_CHILD_TYPES, strict);
+    validateSubtreeForForbidden(section.content, import_core18.ACCORDION_FORBIDDEN_CHILD_TYPES, enforceStrict);
   }
 }
 function validateCompoundChildren(parent, children, strict) {
-  if (!isDevEnvironment() && !strict) return;
-  validateNode(parent, children, 0, strict);
+  const enforceStrict = strict ?? !isDevEnvironment();
+  validateNode(parent, children, 0, enforceStrict);
 }
 
-// src/compound/warnPersistence.ts
-var DEFAULT_ASSESSMENT_SEQUENCE_COMPOUND_ID = "assessment-sequence";
-function warnSharedCompoundStorageKey(opts) {
-  if (!opts.persistEnabled || opts.hasExplicitBlockId || !isDevEnvironment()) return;
-  console.warn(
-    `[lessonkit] <${opts.componentName}> without blockId shares one sessionStorage key when persistCompoundState is enabled; set a unique blockId per instance.`
-  );
+// src/compound/requireCompoundBlockId.ts
+var MissingCompoundBlockIdError = class extends Error {
+  constructor(componentName) {
+    super(
+      `[lessonkit] <${componentName}> requires a unique blockId when session.persistCompoundState is enabled`
+    );
+    this.name = "MissingCompoundBlockIdError";
+  }
+};
+function requireCompoundBlockIdWhenPersisting(opts) {
+  if (opts.persistEnabled && !opts.blockId) {
+    throw new MissingCompoundBlockIdError(opts.componentName);
+  }
 }
 
 // src/blocks/AssessmentSequence.tsx
@@ -1907,7 +2301,10 @@ var AssessmentSequenceInner = (0, import_react22.forwardRef)(
   function AssessmentSequenceInner2(props, ref) {
     const { compoundId, childArray, index, setIndex, persistEnabled } = props;
     const sequential = props.sequential !== false;
+    const requireAnswerBeforeNext = props.requireAnswerBeforeNext !== false;
     const { config } = useLessonkit();
+    const registry = useCompoundRegistry();
+    const handlesVersion = useCompoundHandlesVersion();
     const { visibleIndex, goNext, goPrev, progress } = useCompoundShell({
       courseId: config.courseId,
       compoundId,
@@ -1919,6 +2316,21 @@ var AssessmentSequenceInner = (0, import_react22.forwardRef)(
       enableSolutionsButton: props.enableSolutionsButton
     });
     validateCompoundChildren("AssessmentSequence", props.children);
+    const activeStepAnswered = (0, import_react22.useMemo)(() => {
+      if (!requireAnswerBeforeNext || !registry) return true;
+      let handlesForStep = 0;
+      for (const entry of registry.getRegisteredHandles().values()) {
+        if (entry.pageIndex !== visibleIndex) continue;
+        handlesForStep += 1;
+        if (!entry.handle.getAnswerGiven()) return false;
+      }
+      if (handlesForStep === 0) {
+        const child = childArray[visibleIndex];
+        const childProps = child?.props;
+        if (child && typeof childProps?.checkId === "string") return false;
+      }
+      return true;
+    }, [childArray, handlesVersion, registry, requireAnswerBeforeNext, visibleIndex]);
     if (!sequential) {
       return /* @__PURE__ */ (0, import_jsx_runtime11.jsx)("section", { "aria-label": "Assessment sequence", "data-testid": "assessment-sequence", children: props.children });
     }
@@ -1946,7 +2358,7 @@ var AssessmentSequenceInner = (0, import_react22.forwardRef)(
           {
             type: "button",
             "data-testid": "sequence-next",
-            disabled: visibleIndex >= childArray.length - 1 || childArray.length === 0,
+            disabled: visibleIndex >= childArray.length - 1 || childArray.length === 0 || !activeStepAnswered,
             onClick: goNext,
             children: "Next"
           }
@@ -1960,24 +2372,24 @@ var AssessmentSequence = (0, import_react22.forwardRef)(
     const reactInstanceId = (0, import_react22.useId)();
     const autoCompoundIdRef = (0, import_react22.useRef)(null);
     if (!props.blockId && !autoCompoundIdRef.current) {
-      autoCompoundIdRef.current = (0, import_core17.deriveId)(`assessment-sequence-${reactInstanceId}`);
+      autoCompoundIdRef.current = (0, import_core19.deriveId)(`assessment-sequence-${reactInstanceId}`);
     }
-    const compoundId = (0, import_react22.useMemo)(
-      () => props.blockId ? normalizeComponentId(props.blockId, "blockId") : autoCompoundIdRef.current ?? DEFAULT_ASSESSMENT_SEQUENCE_COMPOUND_ID,
-      [props.blockId]
-    );
+    const compoundId = (0, import_react22.useMemo)(() => {
+      if (props.blockId) {
+        return normalizeComponentId(props.blockId, "blockId");
+      }
+      return autoCompoundIdRef.current ?? (0, import_core19.deriveId)(`assessment-sequence-${reactInstanceId}`);
+    }, [props.blockId, reactInstanceId]);
     const childArray = import_react22.default.Children.toArray(props.children).filter(
       import_react22.default.isValidElement
     );
     const { config, storage } = useLessonkit();
     const persistEnabled = config.session?.persistCompoundState !== false;
-    (0, import_react22.useEffect)(() => {
-      warnSharedCompoundStorageKey({
-        persistEnabled,
-        hasExplicitBlockId: Boolean(props.blockId),
-        componentName: "AssessmentSequence"
-      });
-    }, [persistEnabled, props.blockId]);
+    requireCompoundBlockIdWhenPersisting({
+      persistEnabled,
+      blockId: props.blockId,
+      componentName: "AssessmentSequence"
+    });
     const initialIndex = useCompoundInitialIndex({
       courseId: config.courseId,
       compoundId,
@@ -2022,13 +2434,180 @@ function Heading(props) {
 }
 setLessonkitBlockType(Heading, "Heading");
 
+// src/blocks/embedSecurity.ts
+var import_meta = {};
+var BLOCKED_SANDBOX_TOKENS = /* @__PURE__ */ new Set([
+  "allow-top-navigation",
+  "allow-top-navigation-by-user-activation",
+  "allow-modals",
+  "allow-downloads",
+  "allow-popups-to-escape-sandbox"
+]);
+var ALLOWED_SANDBOX_TOKENS = /* @__PURE__ */ new Set([
+  "allow-forms",
+  "allow-popups",
+  "allow-presentation"
+]);
+var DEFAULT_SANDBOX = "allow-scripts";
+function isProductionEmbedBuild() {
+  try {
+    if (import_meta.env?.PROD === true) return true;
+  } catch {
+  }
+  const g = globalThis;
+  return typeof g.process !== "undefined" && g.process.env?.NODE_ENV === "production";
+}
+function allowedEmbedSchemes() {
+  return isProductionEmbedBuild() ? /* @__PURE__ */ new Set(["https:"]) : /* @__PURE__ */ new Set(["https:", "http:"]);
+}
+function normalizeHostname(hostname) {
+  return hostname.replace(/^\[/, "").replace(/\]$/, "").toLowerCase();
+}
+function expandIpv4Literal(hostname) {
+  if (/^\d+$/.test(hostname)) {
+    const value2 = Number(hostname);
+    if (!Number.isInteger(value2) || value2 < 0 || value2 > 4294967295) return null;
+    return `${value2 >>> 24 & 255}.${value2 >>> 16 & 255}.${value2 >>> 8 & 255}.${value2 & 255}`;
+  }
+  if (!/^\d+(?:\.\d+){1,3}$/.test(hostname)) return null;
+  const parts = hostname.split(".").map((part) => Number(part));
+  if (parts.some((part) => !Number.isInteger(part) || part < 0 || part > 255)) return null;
+  let value = 0;
+  for (const part of parts) {
+    value = value << 8 | part;
+  }
+  value <<= (4 - parts.length) * 8;
+  return `${value >>> 24 & 255}.${value >>> 16 & 255}.${value >>> 8 & 255}.${value & 255}`;
+}
+function canonicalHostnameForBlocklist(hostname) {
+  const normalized = normalizeHostname(hostname);
+  return expandIpv4Literal(normalized) ?? normalized;
+}
+function isIpv4MappedAddress(hostname) {
+  const match = hostname.match(/^::ffff:(\d+\.\d+\.\d+\.\d+)$/i);
+  return match?.[1] ?? null;
+}
+function isLoopbackHost(hostname) {
+  const ipv4Mapped = isIpv4MappedAddress(hostname);
+  if (ipv4Mapped) return isLoopbackHost(ipv4Mapped);
+  return hostname === "localhost" || hostname.endsWith(".localhost") || hostname === "127.0.0.1" || /^127\.\d{1,3}\.\d{1,3}\.\d{1,3}$/.test(hostname) || hostname === "::1" || hostname === "0.0.0.0";
+}
+function isIpv6UniqueLocalHost(hostname) {
+  return /^f[cd][0-9a-f]{0,2}:/i.test(hostname);
+}
+function isLinkLocalOrMetadataHost(hostname) {
+  if (hostname === "169.254.169.254") return true;
+  if (/^169\.254\./.test(hostname)) return true;
+  if (/^fe80:/i.test(hostname)) return true;
+  return false;
+}
+function isRfc1918Host(hostname) {
+  const ipv4Mapped = isIpv4MappedAddress(hostname);
+  if (ipv4Mapped) return isRfc1918Host(ipv4Mapped);
+  if (/^10\./.test(hostname)) return true;
+  if (/^192\.168\./.test(hostname)) return true;
+  const parts = hostname.split(".").map(Number);
+  if (parts.length === 4 && parts[0] === 172 && parts[1] >= 16 && parts[1] <= 31) return true;
+  return false;
+}
+function isBlockedHost(hostname, allowedHosts) {
+  const normalized = normalizeHostname(hostname);
+  const canonical = canonicalHostnameForBlocklist(hostname);
+  if (allowedHosts?.some((host) => {
+    const allowedNormalized = normalizeHostname(host);
+    return canonicalHostnameForBlocklist(host) === canonical || allowedNormalized === normalized;
+  })) {
+    return false;
+  }
+  if (!isProductionEmbedBuild()) return false;
+  return isLoopbackHost(canonical) || isLinkLocalOrMetadataHost(canonical) || isRfc1918Host(canonical) || isIpv6UniqueLocalHost(normalized);
+}
+function resolveAllowedUrl(src, options) {
+  const trimmed = src.trim();
+  if (!trimmed) return null;
+  try {
+    const base = typeof window !== "undefined" ? window.location.href : "https://example.com/";
+    const url = new URL(trimmed, base);
+    if (!allowedEmbedSchemes().has(url.protocol)) return null;
+    if (isBlockedHost(url.hostname, options?.allowedHosts)) return null;
+    if (typeof window !== "undefined") {
+      const pageOrigin = window.location.origin;
+      const isAbsolute = /^[a-zA-Z][a-zA-Z\d+\-.]*:/.test(trimmed) || trimmed.startsWith("//");
+      if (!isAbsolute && url.origin !== pageOrigin) return null;
+      if (trimmed.startsWith("//") && url.origin !== pageOrigin) return null;
+    }
+    url.username = "";
+    url.password = "";
+    return url.href;
+  } catch {
+    return null;
+  }
+}
+function resolveEmbedSrc(src, options) {
+  return resolveAllowedUrl(src, options);
+}
+function resolveMediaSrc(src, options) {
+  if (src === void 0) return null;
+  return resolveAllowedUrl(src, options);
+}
+function buildEmbedSandbox(allow, options) {
+  const tokens = /* @__PURE__ */ new Set([DEFAULT_SANDBOX]);
+  if (allow) {
+    for (const raw of allow.split(/\s+/)) {
+      const token = raw.trim();
+      if (!token || BLOCKED_SANDBOX_TOKENS.has(token)) continue;
+      if (ALLOWED_SANDBOX_TOKENS.has(token)) tokens.add(token);
+    }
+  }
+  if (options?.restrictPopupsInProduction !== false && isProductionEmbedBuild()) {
+    tokens.delete("allow-popups");
+  }
+  return [...tokens].join(" ");
+}
+function telemetryEmbedSrc(src) {
+  try {
+    const url = new URL(src);
+    url.username = "";
+    url.password = "";
+    url.search = "";
+    url.hash = "";
+    return `${url.origin}${url.pathname}`;
+  } catch {
+    return src;
+  }
+}
+function resolveEmbedAspectRatio(aspectRatio) {
+  if (!aspectRatio) return void 0;
+  const trimmed = aspectRatio.trim();
+  if (!/^\d+(\.\d+)?\s*\/\s*\d+(\.\d+)?$/.test(trimmed)) return void 0;
+  const [numRaw, denRaw] = trimmed.split("/").map((part) => part.trim());
+  const num = Number(numRaw);
+  const den = Number(denRaw);
+  if (!Number.isFinite(num) || !Number.isFinite(den) || num <= 0 || den <= 0) return void 0;
+  return trimmed;
+}
+
 // src/blocks/Image.tsx
 var import_jsx_runtime14 = require("react/jsx-runtime");
 function Image(props) {
+  const { config } = useLessonkit();
+  const resolvedSrc = resolveMediaSrc(props.src, {
+    allowedHosts: config.embed?.allowedHosts
+  });
+  if (!resolvedSrc) {
+    return /* @__PURE__ */ (0, import_jsx_runtime14.jsx)(
+      "figure",
+      {
+        "data-lk-block-id": props.blockId,
+        "data-testid": props.blockId ? `image-${props.blockId}` : "image",
+        children: /* @__PURE__ */ (0, import_jsx_runtime14.jsx)("p", { role: "alert", children: "This image URL is not allowed." })
+      }
+    );
+  }
   return /* @__PURE__ */ (0, import_jsx_runtime14.jsx)(
     "img",
     {
-      src: props.src,
+      src: resolvedSrc,
       alt: props.alt,
       "data-lk-block-id": props.blockId,
       "data-testid": props.blockId ? `image-${props.blockId}` : "image",
@@ -2042,10 +2621,21 @@ setLessonkitBlockType(Image, "Image");
 var import_react24 = require("react");
 var import_jsx_runtime15 = require("react/jsx-runtime");
 function Video(props) {
+  const { config } = useLessonkit();
   const blockId = (0, import_react24.useMemo)(
     () => normalizeComponentId(props.blockId, "blockId"),
     [props.blockId]
   );
+  const mediaOptions = { allowedHosts: config.embed?.allowedHosts };
+  const resolvedSrc = resolveMediaSrc(props.src, mediaOptions);
+  const resolvedPoster = resolveMediaSrc(props.poster, mediaOptions);
+  const resolvedCaptions = resolveMediaSrc(props.captions, mediaOptions);
+  if (!resolvedSrc) {
+    return /* @__PURE__ */ (0, import_jsx_runtime15.jsxs)("section", { "aria-label": props.title ?? "Video", "data-lk-block-id": blockId, "data-testid": "video", children: [
+      props.title ? /* @__PURE__ */ (0, import_jsx_runtime15.jsx)("h3", { "data-testid": "video-title", children: props.title }) : null,
+      /* @__PURE__ */ (0, import_jsx_runtime15.jsx)("p", { role: "alert", "data-testid": "video-blocked", children: "This video URL is not allowed." })
+    ] });
+  }
   return /* @__PURE__ */ (0, import_jsx_runtime15.jsxs)("section", { "aria-label": props.title ?? "Video", "data-lk-block-id": blockId, "data-testid": "video", children: [
     props.title ? /* @__PURE__ */ (0, import_jsx_runtime15.jsx)("h3", { "data-testid": "video-title", children: props.title }) : null,
     /* @__PURE__ */ (0, import_jsx_runtime15.jsx)(
@@ -2053,11 +2643,20 @@ function Video(props) {
       {
         controls: true,
         preload: "metadata",
-        poster: props.poster,
-        src: props.src,
+        poster: resolvedPoster ?? void 0,
+        src: resolvedSrc,
         "data-testid": "video-player",
         style: { maxWidth: "100%" },
-        children: props.captions ? /* @__PURE__ */ (0, import_jsx_runtime15.jsx)("track", { kind: "captions", src: props.captions, srcLang: "en", label: "Captions", default: true }) : null
+        children: resolvedCaptions ? /* @__PURE__ */ (0, import_jsx_runtime15.jsx)(
+          "track",
+          {
+            kind: "captions",
+            src: resolvedCaptions,
+            srcLang: "en",
+            label: "Captions",
+            default: true
+          }
+        ) : null
       }
     )
   ] });
@@ -2182,15 +2781,20 @@ var InteractiveBookInner = (0, import_react26.forwardRef)(
   }
 );
 var InteractiveBook = (0, import_react26.forwardRef)(function InteractiveBook2(props, ref) {
-  const blockId = (0, import_react26.useMemo)(
-    () => normalizeComponentId(props.blockId, "blockId"),
-    [props.blockId]
-  );
   const pages = import_react26.default.Children.toArray(props.children).filter(
     import_react26.default.isValidElement
   );
   const { config, storage } = useLessonkit();
   const persistEnabled = config.session?.persistCompoundState !== false;
+  requireCompoundBlockIdWhenPersisting({
+    persistEnabled,
+    blockId: props.blockId,
+    componentName: "InteractiveBook"
+  });
+  const blockId = (0, import_react26.useMemo)(
+    () => normalizeComponentId(props.blockId, "blockId"),
+    [props.blockId]
+  );
   const initialIndex = useCompoundInitialIndex({
     courseId: config.courseId,
     compoundId: blockId,
@@ -2414,15 +3018,20 @@ var SlideDeckInner = (0, import_react29.forwardRef)(function SlideDeckInner2(pro
   );
 });
 var SlideDeck = (0, import_react29.forwardRef)(function SlideDeck2(props, ref) {
-  const blockId = (0, import_react29.useMemo)(
-    () => normalizeComponentId(props.blockId, "blockId"),
-    [props.blockId]
-  );
   const slides = import_react29.default.Children.toArray(props.children).filter(
     import_react29.default.isValidElement
   );
   const { config, storage } = useLessonkit();
   const persistEnabled = config.session?.persistCompoundState !== false;
+  requireCompoundBlockIdWhenPersisting({
+    persistEnabled,
+    blockId: props.blockId,
+    componentName: "SlideDeck"
+  });
+  const blockId = (0, import_react29.useMemo)(
+    () => normalizeComponentId(props.blockId, "blockId"),
+    [props.blockId]
+  );
   const initialIndex = useCompoundInitialIndex({
     courseId: config.courseId,
     compoundId: blockId,
@@ -2499,36 +3108,18 @@ setLessonkitBlockType(TimedCue, "TimedCue");
 
 // src/blocks/InteractiveVideo.tsx
 var import_react31 = __toESM(require("react"), 1);
-var import_core19 = require("@lessonkit/core");
-
-// src/compound/useCompoundVideoShell.ts
-var import_core18 = require("@lessonkit/core");
-var IV_META_KEY = "__lk_iv__";
-function readInteractiveVideoMeta(childStates) {
-  const raw = childStates[IV_META_KEY];
-  if (!raw || typeof raw !== "object") return null;
-  const currentTime = typeof raw.currentTime === "number" ? raw.currentTime : 0;
-  const completedCueIndices = Array.isArray(raw.completedCueIndices) ? raw.completedCueIndices.filter((n) => typeof n === "number") : [];
-  return { currentTime, completedCueIndices };
-}
-function mergeVideoMetaIntoState(state, meta) {
-  return {
-    ...state,
-    childStates: {
-      ...state.childStates,
-      [IV_META_KEY]: meta
-    }
-  };
-}
-
-// src/blocks/InteractiveVideo.tsx
+var import_core20 = require("@lessonkit/core");
 var import_jsx_runtime21 = require("react/jsx-runtime");
+function sortCuesByTime(cues) {
+  return [...cues].sort((a, b) => (a.props.atSeconds ?? 0) - (b.props.atSeconds ?? 0));
+}
 function loadVideoMeta(storage, courseId, blockId, enabled) {
-  if (!enabled || !courseId) return { currentTime: 0, completedCueIndices: [] };
-  const saved = (0, import_core19.loadCompoundState)(storage, courseId, blockId);
-  if (!saved) return { currentTime: 0, completedCueIndices: [] };
+  const empty = { currentTime: 0, completedCueIndices: [], firedCueIndices: [] };
+  if (!enabled || !courseId) return empty;
+  const saved = (0, import_core20.loadCompoundState)(storage, courseId, blockId);
+  if (!saved) return empty;
   const meta = readInteractiveVideoMeta(saved.childStates);
-  return meta ?? { currentTime: 0, completedCueIndices: [] };
+  return meta ?? empty;
 }
 function getCueChildCheckId(cue) {
   const child = import_react31.default.Children.only(cue.props.children);
@@ -2545,29 +3136,59 @@ var InteractiveVideoInner = (0, import_react31.forwardRef)(function InteractiveV
   validateCompoundChildren("InteractiveVideo", cues);
   const { config, track, storage } = useLessonkit();
   const lessonId = useEnclosingLessonId();
+  const mediaOptions = { allowedHosts: config.embed?.allowedHosts };
+  const resolvedSrc = resolveMediaSrc(props.src, mediaOptions);
+  const resolvedPoster = resolveMediaSrc(props.poster, mediaOptions);
+  const resolvedCaptions = resolveMediaSrc(props.captions, mediaOptions);
   const videoRef = (0, import_react31.useRef)(null);
+  const lastKnownTimeRef = (0, import_react31.useRef)(initialMeta.currentTime);
   const completedCuesRef = (0, import_react31.useRef)(new Set(initialMeta.completedCueIndices));
   const [completedCues, setCompletedCues] = (0, import_react31.useState)(
     () => new Set(initialMeta.completedCueIndices)
   );
   const [overlayActive, setOverlayActive] = (0, import_react31.useState)(false);
-  const firedCuesRef = (0, import_react31.useRef)(new Set(initialMeta.completedCueIndices));
-  const resumeOverlayCheckedRef = (0, import_react31.useRef)(false);
-  const sortedCues = (0, import_react31.useMemo)(
-    () => [...cues].sort((a, b) => (a.props.atSeconds ?? 0) - (b.props.atSeconds ?? 0)),
-    [cues]
+  const firedCuesRef = (0, import_react31.useRef)(
+    new Set(
+      initialMeta.firedCueIndices.length > 0 ? initialMeta.firedCueIndices : initialMeta.completedCueIndices
+    )
   );
+  const resumeOverlayCheckedRef = (0, import_react31.useRef)(false);
+  const [persistTrigger, setPersistTrigger] = (0, import_react31.useState)(0);
+  const lastPersistTimeRef = (0, import_react31.useRef)(0);
+  const sortedCues = cues;
   (0, import_react31.useEffect)(() => {
     completedCuesRef.current = completedCues;
   }, [completedCues]);
   const transformState = (0, import_react31.useCallback)(
-    (state) => mergeVideoMetaIntoState(state, {
-      currentTime: videoRef.current?.currentTime ?? initialMeta.currentTime,
-      completedCueIndices: [...completedCuesRef.current]
-    }),
-    [initialMeta.currentTime]
+    (state) => {
+      const liveTime = videoRef.current?.currentTime;
+      const currentTime = Math.max(
+        lastKnownTimeRef.current,
+        typeof liveTime === "number" && Number.isFinite(liveTime) ? liveTime : 0
+      );
+      return mergeVideoMetaIntoState(state, {
+        currentTime,
+        completedCueIndices: [...completedCuesRef.current],
+        firedCueIndices: [...firedCuesRef.current]
+      });
+    },
+    []
   );
-  const { ctx } = useCompoundShell({
+  const applyVideoMetaFromState = (0, import_react31.useCallback)((state) => {
+    const meta = readInteractiveVideoMeta(state.childStates);
+    if (!meta) return;
+    lastKnownTimeRef.current = meta.currentTime;
+    completedCuesRef.current = new Set(meta.completedCueIndices);
+    firedCuesRef.current = new Set(
+      meta.firedCueIndices.length > 0 ? meta.firedCueIndices : meta.completedCueIndices
+    );
+    setCompletedCues(new Set(meta.completedCueIndices));
+    const video = videoRef.current;
+    if (video && meta.currentTime > 0) {
+      video.currentTime = meta.currentTime;
+    }
+  }, []);
+  const { visibleIndex, ctx } = useCompoundShell({
     courseId: config.courseId,
     compoundId: blockId,
     pageCount: sortedCues.length,
@@ -2576,9 +3197,11 @@ var InteractiveVideoInner = (0, import_react31.forwardRef)(function InteractiveV
     persistEnabled,
     ref,
     storage,
-    transformState
+    transformState,
+    persistTrigger,
+    onCompoundResume: applyVideoMetaFromState
   });
-  const activeCue = sortedCues[index];
+  const activeCue = sortedCues[visibleIndex];
   const cueCanContinue = (0, import_react31.useCallback)(
     (cue) => {
       if (!cue || !cueRequiresAnswer(cue)) return true;
@@ -2599,12 +3222,12 @@ var InteractiveVideoInner = (0, import_react31.forwardRef)(function InteractiveV
   (0, import_react31.useEffect)(() => {
     if (resumeOverlayCheckedRef.current || sortedCues.length === 0) return;
     resumeOverlayCheckedRef.current = true;
-    const hasSavedProgress = initialMeta.currentTime > 0 || initialMeta.completedCueIndices.length > 0 || persistEnabled && config.courseId && (0, import_core19.loadCompoundState)(storage, config.courseId, blockId) !== null;
+    const hasSavedProgress = initialMeta.currentTime > 0 || initialMeta.completedCueIndices.length > 0 || persistEnabled && config.courseId && (0, import_core20.loadCompoundState)(storage, config.courseId, blockId) !== null;
     if (!hasSavedProgress) return;
     const video = videoRef.current;
     if (!video) return;
-    const cue = sortedCues[index];
-    if (!cue || completedCues.has(index)) return;
+    const cue = sortedCues[visibleIndex];
+    if (!cue || completedCues.has(visibleIndex)) return;
     setOverlayActive(true);
     video.pause();
     const at = cue.props.atSeconds ?? 0;
@@ -2616,6 +3239,7 @@ var InteractiveVideoInner = (0, import_react31.forwardRef)(function InteractiveV
     completedCues,
     config.courseId,
     index,
+    visibleIndex,
     initialMeta.completedCueIndices.length,
     initialMeta.currentTime,
     persistEnabled,
@@ -2655,6 +3279,12 @@ var InteractiveVideoInner = (0, import_react31.forwardRef)(function InteractiveV
     const video = videoRef.current;
     if (!video || overlayActive) return;
     const t = video.currentTime;
+    lastKnownTimeRef.current = Math.max(lastKnownTimeRef.current, t);
+    const now = Date.now();
+    if (now - lastPersistTimeRef.current >= 5e3) {
+      lastPersistTimeRef.current = now;
+      setPersistTrigger((n) => n + 1);
+    }
     const blockSeek = mandatoryIncompleteBefore(t);
     if (blockSeek !== null && t > blockSeek + 0.5) {
       video.currentTime = blockSeek;
@@ -2670,10 +3300,10 @@ var InteractiveVideoInner = (0, import_react31.forwardRef)(function InteractiveV
     }
   };
   const completeCue = () => {
-    const cue = sortedCues[index];
+    const cue = sortedCues[visibleIndex];
     if (!cue || !cueCanContinue(cue)) return;
     setCompletedCues((prev) => {
-      const next = /* @__PURE__ */ new Set([...prev, index]);
+      const next = /* @__PURE__ */ new Set([...prev, visibleIndex]);
       completedCuesRef.current = next;
       return next;
     });
@@ -2683,7 +3313,7 @@ var InteractiveVideoInner = (0, import_react31.forwardRef)(function InteractiveV
         "video_segment_completed",
         {
           blockId,
-          segmentIndex: index,
+          segmentIndex: visibleIndex,
           atSeconds: cue.props.atSeconds ?? 0,
           segmentLabel: cue.props.label
         },
@@ -2702,12 +3332,12 @@ var InteractiveVideoInner = (0, import_react31.forwardRef)(function InteractiveV
       " ",
       Array.from(ctx.getHandles().values()).reduce((s, h) => s + h.getMaxScore(), 0)
     ] }) : null,
-    /* @__PURE__ */ (0, import_jsx_runtime21.jsx)("div", { style: { position: "relative" }, children: /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(
+    !resolvedSrc ? /* @__PURE__ */ (0, import_jsx_runtime21.jsx)("p", { role: "alert", "data-testid": "interactive-video-blocked", children: "This video URL is not allowed." }) : /* @__PURE__ */ (0, import_jsx_runtime21.jsx)("div", { style: { position: "relative" }, children: /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(
       "video",
       {
         ref: videoRef,
-        src: props.src,
-        poster: props.poster,
+        src: resolvedSrc,
+        poster: resolvedPoster ?? void 0,
         controls: true,
         "data-testid": "interactive-video-player",
         onTimeUpdate,
@@ -2719,13 +3349,22 @@ var InteractiveVideoInner = (0, import_react31.forwardRef)(function InteractiveV
             video.currentTime = blockSeek;
           }
         },
-        children: props.captions ? /* @__PURE__ */ (0, import_jsx_runtime21.jsx)("track", { kind: "captions", src: props.captions, srcLang: "en", label: "Captions", default: true }) : null
+        children: resolvedCaptions ? /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(
+          "track",
+          {
+            kind: "captions",
+            src: resolvedCaptions,
+            srcLang: "en",
+            label: "Captions",
+            default: true
+          }
+        ) : null
       }
     ) }),
     /* @__PURE__ */ (0, import_jsx_runtime21.jsx)("div", { "data-testid": "interactive-video-cues", children: sortedCues.map(
       (cue, i) => import_react31.default.cloneElement(cue, {
         key: cue.key ?? i,
-        hidden: !overlayActive || i !== index,
+        hidden: !overlayActive || i !== visibleIndex,
         cueIndex: i,
         parentType: "InteractiveVideo"
       })
@@ -2748,15 +3387,21 @@ var InteractiveVideoInner = (0, import_react31.forwardRef)(function InteractiveV
 });
 var InteractiveVideo = (0, import_react31.forwardRef)(
   function InteractiveVideo2(props, ref) {
-    const blockId = (0, import_react31.useMemo)(
-      () => normalizeComponentId(props.blockId, "blockId"),
-      [props.blockId]
-    );
     const cues = import_react31.default.Children.toArray(props.children).filter(
       import_react31.default.isValidElement
     );
+    const sortedCues = (0, import_react31.useMemo)(() => sortCuesByTime(cues), [cues]);
     const { config, storage } = useLessonkit();
     const persistEnabled = config.session?.persistCompoundState !== false;
+    requireCompoundBlockIdWhenPersisting({
+      persistEnabled,
+      blockId: props.blockId,
+      componentName: "InteractiveVideo"
+    });
+    const blockId = (0, import_react31.useMemo)(
+      () => normalizeComponentId(props.blockId, "blockId"),
+      [props.blockId]
+    );
     const initialMeta = (0, import_react31.useMemo)(
       () => loadVideoMeta(storage, config.courseId, blockId, persistEnabled),
       [storage, config.courseId, blockId, persistEnabled]
@@ -2764,7 +3409,7 @@ var InteractiveVideo = (0, import_react31.forwardRef)(
     const initialIndex = useCompoundInitialIndex({
       courseId: config.courseId,
       compoundId: blockId,
-      pageCount: cues.length,
+      pageCount: sortedCues.length,
       persistEnabled,
       storage
     });
@@ -2772,14 +3417,14 @@ var InteractiveVideo = (0, import_react31.forwardRef)(
     const setIndexStable = (0, import_react31.useCallback)((i) => setIndex(i), []);
     (0, import_react31.useEffect)(() => {
       setIndex(initialIndex);
-    }, [config.courseId, blockId, initialIndex]);
+    }, [config.courseId, blockId, initialIndex, sortedCues.length]);
     return /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(CompoundProvider, { activePageIndex: index, onActivePageIndexChange: setIndexStable, children: /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(
       InteractiveVideoInner,
       {
         ...props,
         ref,
         blockId,
-        cues,
+        cues: sortedCues,
         index,
         setIndex,
         persistEnabled,
@@ -2792,10 +3437,18 @@ setLessonkitBlockType(InteractiveVideo, "InteractiveVideo");
 
 // src/blocks/Summary.tsx
 var import_react32 = require("react");
+
+// src/assessment/shouldReplayResumeTelemetry.ts
+function shouldReplayResumeTelemetry(config) {
+  return config?.tracking?.replayResumeEvents === true;
+}
+
+// src/blocks/Summary.tsx
 var import_jsx_runtime22 = require("react/jsx-runtime");
 var INTERACTION6 = "summary";
 function SummaryInner(props, ref) {
   const checkId = (0, import_react32.useMemo)(() => normalizeComponentId(props.checkId, "checkId"), [props.checkId]);
+  const { config } = useLessonkit();
   const assessment = useAssessmentState(props.enclosingLessonId);
   const [selectedIndices, setSelectedIndices] = (0, import_react32.useState)([]);
   const [passed, setPassed] = (0, import_react32.useState)(false);
@@ -2823,7 +3476,7 @@ function SummaryInner(props, ref) {
   const handle = (0, import_react32.useMemo)(
     () => buildAssessmentHandle({
       checkId,
-      getScore: () => passed ? score : 0,
+      getScore: () => score,
       getMaxScore: () => maxScore,
       getAnswerGiven: () => selectedIndices.length > 0,
       resetTask: reset,
@@ -2834,7 +3487,7 @@ function SummaryInner(props, ref) {
         interactionType: INTERACTION6,
         response: selected,
         correct: passedThreshold,
-        score: passed ? score : 0,
+        score,
         maxScore
       }),
       getCurrentState: () => ({ selectedIndices, passed, checked }),
@@ -2844,34 +3497,48 @@ function SummaryInner(props, ref) {
           nextIndices = [...state.selectedIndices];
         } else if (Array.isArray(state.selected)) {
           const legacy = state.selected;
+          if (isDevEnvironment()) {
+            const seen = /* @__PURE__ */ new Set();
+            for (const text of props.statements) {
+              if (seen.has(text)) {
+                console.warn(
+                  "[lessonkit] Summary: duplicate statement strings; legacy selected resume may be ambiguous",
+                  text
+                );
+                break;
+              }
+              seen.add(text);
+            }
+          }
           nextIndices = legacy.map((text) => props.statements.indexOf(text)).filter((i) => i >= 0);
         }
         setSelectedIndices(nextIndices);
         const nextSelected = nextIndices.map((i) => props.statements[i] ?? "");
         const nextIsCorrect = nextSelected.length === props.correct.length && nextSelected.every((s, i) => s === props.correct[i]);
         const nextScore = nextIsCorrect ? maxScore : 0;
-        readBooleanStateField(state, "passed", (value) => {
-          setPassed(value);
-          completedRef.current = value;
-          if (value) {
-            if (!telemetryReplayedRef.current) {
-              telemetryReplayedRef.current = true;
-              assessment.answer({
-                checkId,
-                interactionType: INTERACTION6,
-                response: nextSelected,
-                correct: true
-              });
-              assessment.complete({
-                checkId,
-                interactionType: INTERACTION6,
-                score: nextScore,
-                maxScore,
-                passingScore: props.passingScore ?? maxScore
-              });
-            }
-          }
-        });
+        const nextPassedThreshold = meetsPassingThreshold(
+          nextScore,
+          maxScore,
+          props.passingScore
+        );
+        setPassed(nextPassedThreshold);
+        completedRef.current = nextPassedThreshold;
+        if (nextPassedThreshold && !telemetryReplayedRef.current && shouldReplayResumeTelemetry(config)) {
+          telemetryReplayedRef.current = true;
+          assessment.answer({
+            checkId,
+            interactionType: INTERACTION6,
+            response: nextSelected,
+            correct: nextPassedThreshold
+          });
+          assessment.complete({
+            checkId,
+            interactionType: INTERACTION6,
+            score: nextScore,
+            maxScore,
+            passingScore: props.passingScore ?? maxScore
+          });
+        }
         readBooleanStateField(state, "checked", setChecked);
       }
     }),
@@ -2879,14 +3546,16 @@ function SummaryInner(props, ref) {
       assessment,
       checkId,
       checked,
+      config,
       maxScore,
       passed,
       passedThreshold,
+      props.correct,
       props.passingScore,
       props.statements,
       score,
       selected,
-      selectedIndices.length
+      selectedIndices
     ]
   );
   useAssessmentHandleRegistration(checkId, handle, ref);
@@ -2909,9 +3578,9 @@ function SummaryInner(props, ref) {
       response: selected,
       correct: passedThreshold
     });
-    if (passedThreshold && !completedRef.current) {
+    if ((passedThreshold || props.enableRetry === false) && !completedRef.current) {
       completedRef.current = true;
-      setPassed(true);
+      if (passedThreshold) setPassed(true);
       assessment.complete({
         checkId,
         interactionType: INTERACTION6,
@@ -2989,8 +3658,34 @@ function buildDeck(pairs) {
   );
   return shuffleCards(cards);
 }
+function rebuildCardsFromKeys(pairs, cardKeys) {
+  const pairMap = new Map(pairs.map((pair) => [pair.id, pair]));
+  if (cardKeys.length !== pairs.length * 2) return null;
+  const seen = /* @__PURE__ */ new Set();
+  const cards = [];
+  for (const cardKey of cardKeys) {
+    if (seen.has(cardKey)) return null;
+    seen.add(cardKey);
+    const match = /^(.+)-([01])$/.exec(cardKey);
+    if (!match) return null;
+    const pairId = match[1];
+    const copy = Number(match[2]);
+    if (copy !== 0 && copy !== 1) return null;
+    const pair = pairMap.get(pairId);
+    if (!pair) return null;
+    cards.push({
+      cardKey,
+      pairId: pair.id,
+      label: pair.label,
+      imageSrc: pair.imageSrc
+    });
+  }
+  return cards;
+}
 function ImagePairingInner(props, ref) {
   const checkId = (0, import_react33.useMemo)(() => normalizeComponentId(props.checkId, "checkId"), [props.checkId]);
+  const { config } = useLessonkit();
+  const mediaOptions = { allowedHosts: config.embed?.allowedHosts };
   const assessment = useAssessmentState(props.enclosingLessonId);
   const pairsKey = props.pairs.map((p) => p.id).join("\0");
   const [cards, setCards] = (0, import_react33.useState)(() => buildDeck(props.pairs));
@@ -2998,9 +3693,15 @@ function ImagePairingInner(props, ref) {
   const [revealed, setRevealed] = (0, import_react33.useState)(() => /* @__PURE__ */ new Set());
   const [keyboardSelection, setKeyboardSelection] = (0, import_react33.useState)(null);
   const [passed, setPassed] = (0, import_react33.useState)(false);
+  const [submitted, setSubmitted] = (0, import_react33.useState)(false);
   const completedRef = (0, import_react33.useRef)(false);
   const telemetryReplayedRef = (0, import_react33.useRef)(false);
+  const mismatchTimeoutRef = (0, import_react33.useRef)(null);
   const reset = () => {
+    if (mismatchTimeoutRef.current !== null) {
+      window.clearTimeout(mismatchTimeoutRef.current);
+      mismatchTimeoutRef.current = null;
+    }
     completedRef.current = false;
     telemetryReplayedRef.current = false;
     setCards(buildDeck(props.pairs));
@@ -3008,10 +3709,19 @@ function ImagePairingInner(props, ref) {
     setRevealed(/* @__PURE__ */ new Set());
     setKeyboardSelection(null);
     setPassed(false);
+    setSubmitted(false);
   };
   (0, import_react33.useEffect)(() => {
     reset();
   }, [checkId, pairsKey]);
+  (0, import_react33.useEffect)(
+    () => () => {
+      if (mismatchTimeoutRef.current !== null) {
+        window.clearTimeout(mismatchTimeoutRef.current);
+      }
+    },
+    []
+  );
   const totalPairs = props.pairs.length;
   const matchedCount = matched.size;
   const maxScore = totalPairs || 1;
@@ -3019,25 +3729,34 @@ function ImagePairingInner(props, ref) {
   const allMatched = totalPairs > 0 && matchedCount === totalPairs;
   const passedThreshold = meetsPassingThreshold(score, maxScore, props.passingScore);
   const completeIfReady = (nextMatched) => {
-    if (nextMatched.size === totalPairs && totalPairs > 0 && !completedRef.current) {
-      const finalScore = nextMatched.size;
-      const finalPassed = meetsPassingThreshold(finalScore, maxScore, props.passingScore);
-      completedRef.current = true;
-      setPassed(true);
-      assessment.answer({
-        checkId,
-        interactionType: INTERACTION7,
-        response: { matchedPairIds: [...nextMatched] },
-        correct: finalPassed
-      });
-      assessment.complete({
-        checkId,
-        interactionType: INTERACTION7,
-        score: finalScore,
-        maxScore,
-        passingScore: props.passingScore ?? maxScore
-      });
-    }
+    if (totalPairs === 0 || completedRef.current) return;
+    const finalScore = nextMatched.size;
+    const finalPassed = meetsPassingThreshold(finalScore, maxScore, props.passingScore);
+    if (!finalPassed && nextMatched.size < totalPairs) return;
+    completeWithScore(nextMatched, finalScore, finalPassed);
+  };
+  const completeWithScore = (nextMatched, finalScore, finalPassed) => {
+    if (completedRef.current) return;
+    completedRef.current = true;
+    setSubmitted(true);
+    setPassed(finalPassed);
+    assessment.answer({
+      checkId,
+      interactionType: INTERACTION7,
+      response: { matchedPairIds: [...nextMatched] },
+      correct: finalPassed
+    });
+    assessment.complete({
+      checkId,
+      interactionType: INTERACTION7,
+      score: finalScore,
+      maxScore,
+      passingScore: props.passingScore ?? maxScore
+    });
+  };
+  const finishAttempt = () => {
+    if (completedRef.current || matchedCount === 0) return;
+    completeWithScore(matched, matchedCount, passedThreshold);
   };
   const tryMatch = (firstKey, secondKey) => {
     if (firstKey === secondKey) return;
@@ -3054,7 +3773,11 @@ function ImagePairingInner(props, ref) {
       setRevealed(/* @__PURE__ */ new Set());
       setKeyboardSelection(null);
     } else {
-      window.setTimeout(() => {
+      if (mismatchTimeoutRef.current !== null) {
+        window.clearTimeout(mismatchTimeoutRef.current);
+      }
+      mismatchTimeoutRef.current = window.setTimeout(() => {
+        mismatchTimeoutRef.current = null;
         setRevealed((prev) => {
           const next = new Set(prev);
           next.delete(firstKey);
@@ -3097,17 +3820,22 @@ function ImagePairingInner(props, ref) {
         checkId,
         interactionType: INTERACTION7,
         response: { matchedPairIds: [...matched] },
-        correct: allMatched && passedThreshold,
+        correct: passedThreshold,
         score,
         maxScore
       }),
       getCurrentState: () => ({
+        cardKeys: cards.map((card) => card.cardKey),
         matched: [...matched],
         revealed: [...revealed],
         keyboardSelection,
         passed
       }),
       resume: (state) => {
+        if (Array.isArray(state.cardKeys)) {
+          const restored = rebuildCardsFromKeys(props.pairs, state.cardKeys);
+          if (restored) setCards(restored);
+        }
         if (Array.isArray(state.matched)) setMatched(new Set(state.matched));
         if (Array.isArray(state.revealed)) setRevealed(new Set(state.revealed));
         const sel = state.keyboardSelection;
@@ -3115,15 +3843,20 @@ function ImagePairingInner(props, ref) {
         readBooleanStateField(state, "passed", (value) => {
           setPassed(value);
           completedRef.current = value;
-          if (value && !telemetryReplayedRef.current) {
+          if (value && !telemetryReplayedRef.current && shouldReplayResumeTelemetry(config)) {
             telemetryReplayedRef.current = true;
             const matchedIds = Array.isArray(state.matched) ? state.matched : [...matched];
             const finalScore = matchedIds.length;
+            const finalPassed = meetsPassingThreshold(
+              finalScore,
+              maxScore,
+              props.passingScore
+            );
             assessment.answer({
               checkId,
               interactionType: INTERACTION7,
               response: { matchedPairIds: matchedIds },
-              correct: true
+              correct: finalPassed
             });
             assessment.complete({
               checkId,
@@ -3136,7 +3869,7 @@ function ImagePairingInner(props, ref) {
         });
       }
     }),
-    [allMatched, checkId, keyboardSelection, matched, matchedCount, maxScore, passed, passedThreshold, revealed, score]
+    [allMatched, assessment, cards, checkId, config, keyboardSelection, matched, matchedCount, maxScore, passed, passedThreshold, props.pairs, props.passingScore, revealed, score]
   );
   useAssessmentHandleRegistration(checkId, handle, ref);
   return /* @__PURE__ */ (0, import_jsx_runtime23.jsxs)("section", { "aria-label": "Image Pairing", "data-lk-check-id": checkId, "data-testid": "image-pairing", children: [
@@ -3145,6 +3878,7 @@ function ImagePairingInner(props, ref) {
       const isMatched = matched.has(card.pairId);
       const isRevealed = isMatched || revealed.has(card.cardKey);
       const isSelected = keyboardSelection === card.cardKey;
+      const resolvedCardSrc = resolveMediaSrc(card.imageSrc, mediaOptions);
       return /* @__PURE__ */ (0, import_jsx_runtime23.jsx)(
         "button",
         {
@@ -3161,7 +3895,14 @@ function ImagePairingInner(props, ref) {
             border: isSelected ? "2px solid currentColor" : "1px solid currentColor"
           },
           children: isRevealed ? /* @__PURE__ */ (0, import_jsx_runtime23.jsxs)(import_jsx_runtime23.Fragment, { children: [
-            /* @__PURE__ */ (0, import_jsx_runtime23.jsx)("img", { src: card.imageSrc, alt: card.label, style: { maxWidth: "5rem", maxHeight: "5rem" } }),
+            resolvedCardSrc ? /* @__PURE__ */ (0, import_jsx_runtime23.jsx)(
+              "img",
+              {
+                src: resolvedCardSrc,
+                alt: card.label,
+                style: { maxWidth: "5rem", maxHeight: "5rem" }
+              }
+            ) : /* @__PURE__ */ (0, import_jsx_runtime23.jsx)("span", { "aria-hidden": "true", children: "!" }),
             /* @__PURE__ */ (0, import_jsx_runtime23.jsx)("span", { className: "lk-visually-hidden", children: card.label })
           ] }) : "?"
         },
@@ -3174,6 +3915,7 @@ function ImagePairingInner(props, ref) {
       totalPairs,
       " pairs matched"
     ] }),
+    props.enableRetry === false && matchedCount > 0 && !submitted ? /* @__PURE__ */ (0, import_jsx_runtime23.jsx)("button", { type: "button", "data-testid": "image-pairing-finish", onClick: finishAttempt, children: "Submit" }) : null,
     props.enableRetry && passed ? /* @__PURE__ */ (0, import_jsx_runtime23.jsx)("button", { type: "button", "data-testid": "image-pairing-retry", onClick: reset, children: "Try again" }) : null
   ] });
 }
@@ -3189,6 +3931,8 @@ var import_jsx_runtime24 = require("react/jsx-runtime");
 var INTERACTION8 = "imageSequencing";
 function ImageSequencingInner(props, ref) {
   const checkId = (0, import_react34.useMemo)(() => normalizeComponentId(props.checkId, "checkId"), [props.checkId]);
+  const { config } = useLessonkit();
+  const mediaOptions = { allowedHosts: config.embed?.allowedHosts };
   const assessment = useAssessmentState(props.enclosingLessonId);
   const imagesKey = props.images.map((i) => i.id).join("\0");
   const orderKey = props.correctOrder.join("\0");
@@ -3225,9 +3969,9 @@ function ImageSequencingInner(props, ref) {
   const handle = (0, import_react34.useMemo)(
     () => buildAssessmentHandle({
       checkId,
-      getScore: () => passed ? score : 0,
+      getScore: () => score,
       getMaxScore: () => maxScore,
-      getAnswerGiven: () => order.length > 0,
+      getAnswerGiven: () => checked,
       resetTask: reset,
       showSolutions: () => {
       },
@@ -3236,7 +3980,7 @@ function ImageSequencingInner(props, ref) {
         interactionType: INTERACTION8,
         response: order,
         correct: passedThreshold,
-        score: passed ? score : 0,
+        score,
         maxScore
       }),
       getCurrentState: () => ({ order, passed, checked }),
@@ -3249,7 +3993,7 @@ function ImageSequencingInner(props, ref) {
         readBooleanStateField(state, "passed", (value) => {
           setPassed(value);
           completedRef.current = value;
-          if (value && !telemetryReplayedRef.current) {
+          if (value && !telemetryReplayedRef.current && shouldReplayResumeTelemetry(config)) {
             telemetryReplayedRef.current = true;
             const nextIsCorrect = nextOrder.every((id, i) => id === props.correctOrder[i]);
             const nextScore = nextIsCorrect ? maxScore : 0;
@@ -3271,7 +4015,7 @@ function ImageSequencingInner(props, ref) {
         readBooleanStateField(state, "checked", setChecked);
       }
     }),
-    [checkId, checked, maxScore, order, passed, passedThreshold, score]
+    [assessment, checkId, checked, config, maxScore, order, passed, passedThreshold, props.correctOrder, props.passingScore, score]
   );
   useAssessmentHandleRegistration(checkId, handle, ref);
   const check = () => {
@@ -3282,9 +4026,9 @@ function ImageSequencingInner(props, ref) {
       response: order,
       correct: passedThreshold
     });
-    if (passedThreshold && !completedRef.current) {
+    if ((passedThreshold || props.enableRetry === false) && !completedRef.current) {
       completedRef.current = true;
-      setPassed(true);
+      if (passedThreshold) setPassed(true);
       assessment.complete({
         checkId,
         interactionType: INTERACTION8,
@@ -3299,8 +4043,16 @@ function ImageSequencingInner(props, ref) {
     /* @__PURE__ */ (0, import_jsx_runtime24.jsx)("ol", { "data-testid": "image-sequencing-list", children: order.map((id, index) => {
       const image = props.images.find((i) => i.id === id);
       if (!image) return null;
+      const resolvedSrc = resolveMediaSrc(image.src, mediaOptions);
       return /* @__PURE__ */ (0, import_jsx_runtime24.jsxs)("li", { "data-testid": `sequencing-item-${id}`, children: [
-        /* @__PURE__ */ (0, import_jsx_runtime24.jsx)("img", { src: image.src, alt: image.alt, style: { maxWidth: "8rem", verticalAlign: "middle" } }),
+        resolvedSrc ? /* @__PURE__ */ (0, import_jsx_runtime24.jsx)(
+          "img",
+          {
+            src: resolvedSrc,
+            alt: image.alt,
+            style: { maxWidth: "8rem", verticalAlign: "middle" }
+          }
+        ) : /* @__PURE__ */ (0, import_jsx_runtime24.jsx)("span", { "aria-hidden": "true", children: "!" }),
         /* @__PURE__ */ (0, import_jsx_runtime24.jsx)(
           "button",
           {
@@ -3353,6 +4105,7 @@ var import_jsx_runtime25 = require("react/jsx-runtime");
 var INTERACTION9 = "arithmeticQuiz";
 function ArithmeticQuizInner(props, ref) {
   const checkId = (0, import_react35.useMemo)(() => normalizeComponentId(props.checkId, "checkId"), [props.checkId]);
+  const { config } = useLessonkit();
   const assessment = useAssessmentState(props.enclosingLessonId);
   const problemsKey = props.problems.map((p) => `${p.question}\0${p.answer}`).join("|");
   const [answers, setAnswers] = (0, import_react35.useState)(
@@ -3393,9 +4146,9 @@ function ArithmeticQuizInner(props, ref) {
         response: answers,
         correct: passedThreshold
       });
-      if (passedThreshold && !completedRef.current) {
+      if ((passedThreshold || props.enableRetry === false) && !completedRef.current) {
         completedRef.current = true;
-        setPassed(true);
+        setPassed(passedThreshold);
         assessment.complete({
           checkId,
           interactionType: INTERACTION9,
@@ -3419,7 +4172,7 @@ function ArithmeticQuizInner(props, ref) {
   const handle = (0, import_react35.useMemo)(
     () => buildAssessmentHandle({
       checkId,
-      getScore: () => passed ? score : 0,
+      getScore: () => score,
       getMaxScore: () => maxScore,
       getAnswerGiven: () => allFilled,
       resetTask: reset,
@@ -3430,7 +4183,7 @@ function ArithmeticQuizInner(props, ref) {
         interactionType: INTERACTION9,
         response: answers,
         correct: passedThreshold,
-        score: passed ? score : 0,
+        score,
         maxScore
       }),
       getCurrentState: () => ({ answers, passed, checked, timeLeft }),
@@ -3444,17 +4197,18 @@ function ArithmeticQuizInner(props, ref) {
         readBooleanStateField(state, "passed", (value) => {
           setPassed(value);
           completedRef.current = value;
-          if (value && !telemetryReplayedRef.current) {
+          if (value && !telemetryReplayedRef.current && shouldReplayResumeTelemetry(config)) {
             telemetryReplayedRef.current = true;
             let nextScore = 0;
             props.problems.forEach((p, i) => {
               if ((nextAnswers[i] ?? "").trim() === p.answer.trim()) nextScore += 1;
             });
+            const replayCorrect = nextScore >= (props.passingScore ?? maxScore);
             assessment.answer({
               checkId,
               interactionType: INTERACTION9,
               response: nextAnswers,
-              correct: true
+              correct: replayCorrect
             });
             assessment.complete({
               checkId,
@@ -3469,7 +4223,7 @@ function ArithmeticQuizInner(props, ref) {
         if (typeof state.timeLeft === "number") setTimeLeft(state.timeLeft);
       }
     }),
-    [allFilled, answers, checkId, checked, maxScore, passed, passedThreshold, score, timeLeft]
+    [allFilled, answers, checkId, checked, config, maxScore, passed, passedThreshold, props.problems, props.passingScore, score, timeLeft]
   );
   useAssessmentHandleRegistration(checkId, handle, ref);
   const onInput = (index, value) => {
@@ -3533,6 +4287,7 @@ var import_jsx_runtime26 = require("react/jsx-runtime");
 var INTERACTION10 = "essay";
 function EssayInner(props, ref) {
   const checkId = (0, import_react36.useMemo)(() => normalizeComponentId(props.checkId, "checkId"), [props.checkId]);
+  const { config } = useLessonkit();
   const assessment = useAssessmentState(props.enclosingLessonId);
   const [text, setText] = (0, import_react36.useState)("");
   const [submitted, setSubmitted] = (0, import_react36.useState)(false);
@@ -3572,16 +4327,22 @@ function EssayInner(props, ref) {
         const nextText = readStringField(state, "text");
         if (typeof nextText === "string") setText(nextText);
         readBooleanStateField(state, "submitted", (value) => {
+          const textVal = typeof nextText === "string" ? nextText : text;
+          const meetsMin = textVal.trim().length >= minLength;
+          if (value && !meetsMin) {
+            setSubmitted(false);
+            completedRef.current = false;
+            return;
+          }
           setSubmitted(value);
           completedRef.current = value;
-          if (value && !telemetryReplayedRef.current) {
+          if (value && !telemetryReplayedRef.current && shouldReplayResumeTelemetry(config)) {
             telemetryReplayedRef.current = true;
-            const response = typeof nextText === "string" ? nextText : text;
             assessment.answer({
               checkId,
               interactionType: INTERACTION10,
               question: props.question,
-              response,
+              response: textVal,
               correct: false
             });
             assessment.complete({
@@ -3595,7 +4356,7 @@ function EssayInner(props, ref) {
         });
       }
     }),
-    [checkId, meetsMinLength, props.question, submitted, text]
+    [assessment, checkId, config, meetsMinLength, minLength, props.passingScore, props.question, submitted, text]
   );
   useAssessmentHandleRegistration(checkId, handle, ref);
   const submit = () => {
@@ -3773,16 +4534,29 @@ function MemoryGame(props) {
   const [revealed, setRevealed] = (0, import_react38.useState)(() => /* @__PURE__ */ new Set());
   const [selection, setSelection] = (0, import_react38.useState)(null);
   const [complete, setComplete] = (0, import_react38.useState)(false);
+  const mismatchTimeoutRef = (0, import_react38.useRef)(null);
   const { track } = useLessonkit();
   const lessonId = useEnclosingLessonId();
   const trackOpts = lessonId ? { lessonId } : void 0;
   (0, import_react38.useEffect)(() => {
+    if (mismatchTimeoutRef.current !== null) {
+      window.clearTimeout(mismatchTimeoutRef.current);
+      mismatchTimeoutRef.current = null;
+    }
     setCards(buildDeck2(props.pairs));
     setMatched(/* @__PURE__ */ new Set());
     setRevealed(/* @__PURE__ */ new Set());
     setSelection(null);
     setComplete(false);
   }, [props.blockId, pairsKey]);
+  (0, import_react38.useEffect)(
+    () => () => {
+      if (mismatchTimeoutRef.current !== null) {
+        window.clearTimeout(mismatchTimeoutRef.current);
+      }
+    },
+    []
+  );
   const cardIndexByKey = (0, import_react38.useMemo)(
     () => Object.fromEntries(cards.map((c, i) => [c.cardKey, i])),
     [cards]
@@ -3812,7 +4586,11 @@ function MemoryGame(props) {
       setRevealed(/* @__PURE__ */ new Set());
       setSelection(null);
     } else {
-      window.setTimeout(() => {
+      if (mismatchTimeoutRef.current !== null) {
+        window.clearTimeout(mismatchTimeoutRef.current);
+      }
+      mismatchTimeoutRef.current = window.setTimeout(() => {
+        mismatchTimeoutRef.current = null;
         setRevealed((prev) => {
           const next = new Set(prev);
           next.delete(firstKey);
@@ -3969,10 +4747,16 @@ function usePrefersReducedMotion() {
 function ParallaxSlideshow(props) {
   const [index, setIndex] = (0, import_react40.useState)(0);
   const reducedMotion = usePrefersReducedMotion();
-  const { track } = useLessonkit();
+  const { track, config } = useLessonkit();
   const lessonId = useEnclosingLessonId();
   const trackOpts = lessonId ? { lessonId } : void 0;
   const slide = props.slides[index];
+  const mediaOptions = { allowedHosts: config.embed?.allowedHosts };
+  const resolvedImageSrc = slide?.imageSrc ? resolveMediaSrc(slide.imageSrc, mediaOptions) : null;
+  (0, import_react40.useEffect)(() => {
+    if (props.slides.length < 1) return;
+    setIndex((current) => Math.min(current, props.slides.length - 1));
+  }, [props.slides.length]);
   (0, import_react40.useEffect)(() => {
     track(
       "parallax_slide_viewed",
@@ -3999,22 +4783,23 @@ function ParallaxSlideshow(props) {
             "data-testid": `parallax-slide-${index}`,
             style: reducedMotion ? void 0 : {
               backgroundAttachment: "fixed",
-              backgroundImage: slide.imageSrc ? `url(${slide.imageSrc})` : void 0,
+              backgroundImage: resolvedImageSrc ? `url("${resolvedImageSrc}")` : void 0,
               backgroundPosition: "center",
               backgroundSize: "cover",
               minHeight: "12rem",
               padding: "1rem"
             },
             children: [
-              reducedMotion && slide.imageSrc ? /* @__PURE__ */ (0, import_jsx_runtime30.jsx)(
+              reducedMotion && resolvedImageSrc ? /* @__PURE__ */ (0, import_jsx_runtime30.jsx)(
                 "img",
                 {
-                  src: slide.imageSrc,
+                  src: resolvedImageSrc,
                   alt: "",
                   "data-testid": "parallax-slide-image",
                   style: { maxWidth: "100%" }
                 }
               ) : null,
+              !reducedMotion && slide.imageSrc && !resolvedImageSrc ? /* @__PURE__ */ (0, import_jsx_runtime30.jsx)("p", { role: "alert", children: "This image URL is not allowed." }) : null,
               /* @__PURE__ */ (0, import_jsx_runtime30.jsx)("h3", { "data-testid": "parallax-slide-title", children: slide.title }),
               /* @__PURE__ */ (0, import_jsx_runtime30.jsx)("p", { "data-testid": "parallax-slide-body", children: slide.body })
             ]
@@ -4203,8 +4988,9 @@ var import_react44 = require("react");
 var import_jsx_runtime34 = require("react/jsx-runtime");
 function ImageHotspots(props) {
   const [active, setActive] = (0, import_react44.useState)(null);
-  const { track } = useLessonkit();
+  const { track, config } = useLessonkit();
   const lessonId = useEnclosingLessonId();
+  const resolvedSrc = resolveMediaSrc(props.src, { allowedHosts: config.embed?.allowedHosts });
   const open = (hotspotId) => {
     setActive(hotspotId);
     track(
@@ -4215,7 +5001,7 @@ function ImageHotspots(props) {
   };
   return /* @__PURE__ */ (0, import_jsx_runtime34.jsxs)("section", { "aria-label": "Image hotspots", "data-lk-block-id": props.blockId, "data-testid": "image-hotspots", children: [
     /* @__PURE__ */ (0, import_jsx_runtime34.jsxs)("div", { style: { position: "relative", display: "inline-block" }, children: [
-      /* @__PURE__ */ (0, import_jsx_runtime34.jsx)("img", { src: props.src, alt: props.alt, style: { maxWidth: "100%" } }),
+      resolvedSrc ? /* @__PURE__ */ (0, import_jsx_runtime34.jsx)("img", { src: resolvedSrc, alt: props.alt, style: { maxWidth: "100%" } }) : /* @__PURE__ */ (0, import_jsx_runtime34.jsx)("p", { role: "alert", children: "This image URL is not allowed." }),
       props.hotspots.map((h) => /* @__PURE__ */ (0, import_jsx_runtime34.jsx)(
         "button",
         {
@@ -4248,9 +5034,11 @@ var import_react45 = require("react");
 var import_jsx_runtime35 = require("react/jsx-runtime");
 function ImageSlider(props) {
   const [index, setIndex] = (0, import_react45.useState)(0);
-  const { track } = useLessonkit();
+  const { track, config } = useLessonkit();
   const lessonId = useEnclosingLessonId();
   const slide = props.slides[index];
+  const mediaOptions = { allowedHosts: config.embed?.allowedHosts };
+  const resolvedSrc = slide ? resolveMediaSrc(slide.src, mediaOptions) : null;
   if (!slide) return null;
   const goTo = (next) => {
     setIndex(next);
@@ -4261,7 +5049,7 @@ function ImageSlider(props) {
     );
   };
   return /* @__PURE__ */ (0, import_jsx_runtime35.jsxs)("section", { "aria-label": "Image slider", "data-lk-block-id": props.blockId, "data-testid": "image-slider", children: [
-    /* @__PURE__ */ (0, import_jsx_runtime35.jsx)("img", { src: slide.src, alt: slide.alt, style: { maxWidth: "100%" } }),
+    resolvedSrc ? /* @__PURE__ */ (0, import_jsx_runtime35.jsx)("img", { src: resolvedSrc, alt: slide.alt, style: { maxWidth: "100%" } }) : /* @__PURE__ */ (0, import_jsx_runtime35.jsx)("p", { role: "alert", children: "This image URL is not allowed." }),
     slide.caption ? /* @__PURE__ */ (0, import_jsx_runtime35.jsx)("p", { children: slide.caption }) : null,
     /* @__PURE__ */ (0, import_jsx_runtime35.jsxs)("nav", { "aria-label": "Slide navigation", children: [
       /* @__PURE__ */ (0, import_jsx_runtime35.jsx)(
@@ -4300,6 +5088,8 @@ var import_jsx_runtime36 = require("react/jsx-runtime");
 var INTERACTION11 = "findHotspot";
 function FindHotspotInner(props, ref) {
   const checkId = (0, import_react46.useMemo)(() => normalizeComponentId(props.checkId, "checkId"), [props.checkId]);
+  const { config } = useLessonkit();
+  const resolvedSrc = resolveMediaSrc(props.src, { allowedHosts: config.embed?.allowedHosts });
   const [selected, setSelected] = (0, import_react46.useState)(null);
   const [checked, setChecked] = (0, import_react46.useState)(false);
   const telemetryReplayedRef = (0, import_react46.useRef)(false);
@@ -4335,7 +5125,7 @@ function FindHotspotInner(props, ref) {
       checkId,
       getScore: () => checked && correct ? 1 : 0,
       getMaxScore: () => 1,
-      getAnswerGiven: () => selected !== null,
+      getAnswerGiven: () => checked,
       resetTask: () => {
         setSelected(null);
         setChecked(false);
@@ -4365,10 +5155,12 @@ function FindHotspotInner(props, ref) {
           setChecked(value);
         });
         const nextCorrect = nextSelected === props.correctTargetId;
-        replayTelemetry(nextSelected, nextChecked, nextCorrect);
+        if (config.tracking?.replayResumeEvents === true) {
+          replayTelemetry(nextSelected, nextChecked, nextCorrect);
+        }
       }
     }),
-    [assessment, checkId, checked, correct, props.correctTargetId, props.passingScore, props.targets, selected]
+    [assessment, checkId, checked, config.tracking?.replayResumeEvents, correct, props.correctTargetId, props.passingScore, props.targets, selected]
   );
   useAssessmentHandleRegistration(checkId, handle, ref);
   const selectTarget = (id) => {
@@ -4392,11 +5184,19 @@ function FindHotspotInner(props, ref) {
         maxScore: 1,
         passingScore: props.passingScore ?? 1
       });
+    } else if (props.enableRetry === false) {
+      assessment.complete({
+        checkId,
+        interactionType: INTERACTION11,
+        score: 0,
+        maxScore: 1,
+        passingScore: props.passingScore ?? 1
+      });
     }
   };
   return /* @__PURE__ */ (0, import_jsx_runtime36.jsxs)("section", { "aria-label": "Find the hotspot", "data-lk-check-id": checkId, "data-testid": "find-hotspot", children: [
     /* @__PURE__ */ (0, import_jsx_runtime36.jsxs)("div", { style: { position: "relative", display: "inline-block" }, children: [
-      /* @__PURE__ */ (0, import_jsx_runtime36.jsx)("img", { src: props.src, alt: props.alt, style: { maxWidth: "100%" } }),
+      resolvedSrc ? /* @__PURE__ */ (0, import_jsx_runtime36.jsx)("img", { src: resolvedSrc, alt: props.alt, style: { maxWidth: "100%" } }) : /* @__PURE__ */ (0, import_jsx_runtime36.jsx)("p", { role: "alert", children: "This image URL is not allowed." }),
       props.targets.map((t) => /* @__PURE__ */ (0, import_jsx_runtime36.jsx)(
         "button",
         {
@@ -4432,9 +5232,21 @@ var import_jsx_runtime37 = require("react/jsx-runtime");
 var INTERACTION12 = "findMultipleHotspots";
 function FindMultipleHotspotsInner(props, ref) {
   const checkId = (0, import_react47.useMemo)(() => normalizeComponentId(props.checkId, "checkId"), [props.checkId]);
+  const { config } = useLessonkit();
+  const resolvedSrc = resolveMediaSrc(props.src, { allowedHosts: config.embed?.allowedHosts });
   const [selected, setSelected] = (0, import_react47.useState)(/* @__PURE__ */ new Set());
   const [checked, setChecked] = (0, import_react47.useState)(false);
   const assessment = useAssessmentState(props.enclosingLessonId);
+  const correctSet = (0, import_react47.useMemo)(
+    () => new Set(props.correctTargetIds),
+    [props.correctTargetIds]
+  );
+  const targetIdsKey = props.targets.map((t) => t.id).join("\0");
+  const correctIdsKey = props.correctTargetIds.join("\0");
+  (0, import_react47.useEffect)(() => {
+    setSelected(/* @__PURE__ */ new Set());
+    setChecked(false);
+  }, [checkId, correctIdsKey, targetIdsKey]);
   const toggle = (id) => {
     setSelected((prev) => {
       const next = new Set(prev);
@@ -4444,13 +5256,26 @@ function FindMultipleHotspotsInner(props, ref) {
     });
     setChecked(false);
   };
-  const correct = selected.size === props.correctTargetIds.length && props.correctTargetIds.every((id) => selected.has(id));
+  const maxScore = props.correctTargetIds.length || 1;
+  const score = props.correctTargetIds.filter((id) => selected.has(id)).length;
+  const wrongSelected = [...selected].filter((id) => !correctSet.has(id)).length;
+  const passedThreshold = meetsPassingThreshold(score, maxScore, props.passingScore) && wrongSelected === 0;
+  const isFactuallyCorrect = (sel) => {
+    const wrong = [...sel].filter((id) => !correctSet.has(id)).length;
+    const matched = props.correctTargetIds.filter((id) => sel.has(id)).length;
+    return wrong === 0 && sel.size === props.correctTargetIds.length && matched === maxScore;
+  };
+  const factualCorrect = checked ? isFactuallyCorrect(selected) : false;
+  const validTargetIds = (0, import_react47.useMemo)(
+    () => new Set(props.targets.map((t) => t.id)),
+    [props.targets]
+  );
   const handle = (0, import_react47.useMemo)(
     () => buildAssessmentHandle({
       checkId,
-      getScore: () => checked && correct ? 1 : 0,
-      getMaxScore: () => 1,
-      getAnswerGiven: () => selected.size > 0,
+      getScore: () => score,
+      getMaxScore: () => maxScore,
+      getAnswerGiven: () => checked,
       resetTask: () => {
         setSelected(/* @__PURE__ */ new Set());
         setChecked(false);
@@ -4460,42 +5285,68 @@ function FindMultipleHotspotsInner(props, ref) {
         checkId,
         interactionType: INTERACTION12,
         response: [...selected],
-        correct: checked ? correct : void 0,
-        score: checked && correct ? 1 : 0,
-        maxScore: 1
+        correct: checked ? factualCorrect : void 0,
+        score: checked ? score : 0,
+        maxScore
       }),
       getCurrentState: () => ({ selected: [...selected], checked }),
       resume: (state) => {
         const raw = state.selected;
-        if (Array.isArray(raw)) setSelected(new Set(raw.filter((id) => typeof id === "string")));
+        if (Array.isArray(raw)) {
+          setSelected(
+            new Set(
+              raw.filter(
+                (id) => typeof id === "string" && validTargetIds.has(id)
+              )
+            )
+          );
+        }
         readBooleanStateField(state, "checked", setChecked);
       }
     }),
-    [checkId, selected, checked, correct, props.correctTargetIds]
+    [
+      checkId,
+      checked,
+      factualCorrect,
+      maxScore,
+      props.correctTargetIds,
+      score,
+      selected,
+      validTargetIds
+    ]
   );
   useAssessmentHandleRegistration(checkId, handle, ref);
   const submit = () => {
     if (selected.size === 0 || checked) return;
+    const correctAtSubmit = isFactuallyCorrect(selected);
     setChecked(true);
     assessment.answer({
       checkId,
       interactionType: INTERACTION12,
       response: [...selected],
-      correct
+      correct: correctAtSubmit
     });
-    if (correct) {
+    if (passedThreshold) {
       assessment.complete({
         checkId,
         interactionType: INTERACTION12,
-        score: 1,
-        maxScore: 1,
-        passingScore: props.passingScore ?? 1
+        score,
+        maxScore,
+        passingScore: props.passingScore ?? maxScore
+      });
+    } else if (props.enableRetry === false) {
+      assessment.complete({
+        checkId,
+        interactionType: INTERACTION12,
+        score,
+        maxScore,
+        passingScore: props.passingScore ?? maxScore
       });
     }
   };
   return /* @__PURE__ */ (0, import_jsx_runtime37.jsxs)("section", { "aria-label": "Find multiple hotspots", "data-lk-check-id": checkId, "data-testid": "find-multiple-hotspots", children: [
     /* @__PURE__ */ (0, import_jsx_runtime37.jsxs)("div", { style: { position: "relative", display: "inline-block" }, children: [
-      /* @__PURE__ */ (0, import_jsx_runtime37.jsx)("img", { src: props.src, alt: props.alt, style: { maxWidth: "100%" } }),
+      resolvedSrc ? /* @__PURE__ */ (0, import_jsx_runtime37.jsx)("img", { src: resolvedSrc, alt: props.alt, style: { maxWidth: "100%" } }) : /* @__PURE__ */ (0, import_jsx_runtime37.jsx)("p", { role: "alert", children: "This image URL is not allowed." }),
       props.targets.map((t) => /* @__PURE__ */ (0, import_jsx_runtime37.jsx)(
         "button",
         {
@@ -4516,7 +5367,7 @@ function FindMultipleHotspotsInner(props, ref) {
       ))
     ] }),
     /* @__PURE__ */ (0, import_jsx_runtime37.jsx)("button", { type: "button", "data-testid": "check-hotspots", disabled: selected.size === 0, onClick: submit, children: "Check" }),
-    checked ? /* @__PURE__ */ (0, import_jsx_runtime37.jsx)("p", { role: "status", children: correct ? "Correct" : "Try again" }) : null
+    checked ? /* @__PURE__ */ (0, import_jsx_runtime37.jsx)("p", { role: "status", children: passedThreshold ? "Correct" : "Try again" }) : null
   ] });
 }
 var FindMultipleHotspotsInnerForwarded = (0, import_react47.forwardRef)(FindMultipleHotspotsInner);
@@ -4526,14 +5377,685 @@ var FindMultipleHotspots = (0, import_react47.forwardRef)(
   }
 );
 setLessonkitBlockType(FindMultipleHotspots, "FindMultipleHotspots");
+
+// src/blocks/BranchingScenario.tsx
+var import_react51 = __toESM(require("react"), 1);
+var import_core23 = require("@lessonkit/core");
+
+// src/compound/useCompoundBranchHandle.ts
+var import_react48 = require("react");
+var import_core21 = require("@lessonkit/core");
+function useCompoundBranchHandle(ref, opts) {
+  const bridgeRef = useCompoundHydrationBridgeRef();
+  const {
+    activePageIndex,
+    getRegisteredHandles,
+    visitedNodeIndices,
+    choiceScores,
+    meta,
+    maxChoiceScore = 0,
+    onResetMeta,
+    enableSolutionsButton
+  } = opts;
+  const filterVisited = (0, import_react48.useCallback)(
+    (handles) => {
+      const filtered = [];
+      for (const entry of handles) {
+        const { pageIndex } = entry;
+        if (pageIndex === void 0) continue;
+        if (visitedNodeIndices.has(pageIndex)) filtered.push(entry);
+      }
+      return filtered;
+    },
+    [visitedNodeIndices]
+  );
+  (0, import_react48.useImperativeHandle)(
+    ref,
+    () => ({
+      getScore: () => {
+        const assessment = aggregateAssessmentScores(filterVisited(getRegisteredHandles().values()));
+        return assessment.score + sumChoiceScores(choiceScores);
+      },
+      getMaxScore: () => {
+        const assessment = aggregateAssessmentScores(filterVisited(getRegisteredHandles().values()));
+        return assessment.maxScore + maxChoiceScore;
+      },
+      getAnswerGiven: () => aggregateAssessmentScores(filterVisited(getRegisteredHandles().values())).allAnswered,
+      resetTask: () => {
+        onResetMeta();
+        for (const entry of filterVisited(getRegisteredHandles().values())) {
+          entry.handle.resetTask();
+        }
+      },
+      showSolutions: () => {
+        if (!enableSolutionsButton) return;
+        for (const entry of filterVisited(getRegisteredHandles().values())) {
+          entry.handle.showSolutions();
+        }
+      },
+      getCurrentState: () => {
+        const childStates = {};
+        for (const [checkId, entry] of getRegisteredHandles()) {
+          const { pageIndex } = entry;
+          if (pageIndex === void 0 || !visitedNodeIndices.has(pageIndex)) continue;
+          if (entry.handle.getCurrentState) {
+            childStates[checkId] = entry.handle.getCurrentState();
+          }
+        }
+        return mergeBranchMetaIntoState(
+          (0, import_core21.createCompoundResumeState)({ activePageIndex, childStates }),
+          meta
+        );
+      },
+      resume: (state) => {
+        bridgeRef?.current?.notifyImperativeResume(state);
+      }
+    }),
+    [
+      activePageIndex,
+      bridgeRef,
+      choiceScores,
+      enableSolutionsButton,
+      filterVisited,
+      getRegisteredHandles,
+      meta,
+      maxChoiceScore,
+      onResetMeta,
+      visitedNodeIndices
+    ]
+  );
+}
+
+// src/compound/useBranchingScenario.tsx
+var import_react49 = require("react");
+var import_jsx_runtime38 = require("react/jsx-runtime");
+var BranchingScenarioContext = (0, import_react49.createContext)(null);
+function BranchingScenarioProvider(props) {
+  return /* @__PURE__ */ (0, import_jsx_runtime38.jsx)(BranchingScenarioContext.Provider, { value: props.value, children: props.children });
+}
+function useBranchingScenarioOptional() {
+  return (0, import_react49.useContext)(BranchingScenarioContext);
+}
+
+// src/compound/validateBranchGraph.ts
+var import_react50 = __toESM(require("react"), 1);
+var import_core22 = require("@lessonkit/core");
+function extractBranchGraph(nodes) {
+  return nodes.map((node) => {
+    const choices = [];
+    import_react50.default.Children.forEach(node.props.children, (child) => {
+      if (!import_react50.default.isValidElement(child)) return;
+      if (getLessonkitBlockType(child.type) !== "BranchChoice") return;
+      const targetNodeId = child.props.targetNodeId;
+      if (typeof targetNodeId === "string") {
+        choices.push({ targetNodeId: normalizeComponentId(targetNodeId, "blockId") });
+      }
+    });
+    return {
+      nodeId: normalizeComponentId(node.props.nodeId, "blockId"),
+      terminal: Boolean(node.props.terminal),
+      choices
+    };
+  });
+}
+function validateBranchGraphAtMount(startNodeId, nodes, strict) {
+  const graph = extractBranchGraph(nodes);
+  const result = (0, import_core22.validateBranchGraph)(startNodeId, graph.map(({ nodeId, choices }) => ({ nodeId, choices })));
+  for (const node of graph) {
+    if (node.terminal && node.choices.length > 0) {
+      const msg = `[lessonkit] BranchingScenario: terminal node "${node.nodeId}" must not contain BranchChoice children`;
+      if (strict || !isDevEnvironment()) {
+        throw new Error(msg);
+      }
+      console.warn(msg);
+    }
+  }
+  for (const issue of result.issues) {
+    const msg = `[lessonkit] BranchingScenario: ${issue.message}`;
+    if (strict || !isDevEnvironment()) {
+      throw new Error(msg);
+    }
+    console.warn(msg);
+  }
+}
+function buildNodeIndexMap(nodes) {
+  const map = /* @__PURE__ */ new Map();
+  nodes.forEach((node, index) => {
+    map.set(normalizeComponentId(node.props.nodeId, "blockId"), index);
+  });
+  return map;
+}
+function buildNodeLabels(nodes) {
+  const map = /* @__PURE__ */ new Map();
+  for (const node of nodes) {
+    const nodeId = normalizeComponentId(node.props.nodeId, "blockId");
+    map.set(nodeId, node.props.title ?? nodeId);
+  }
+  return map;
+}
+function filterBranchNodeContent(children) {
+  const filtered = [];
+  import_react50.default.Children.forEach(children, (child) => {
+    if (!import_react50.default.isValidElement(child)) {
+      filtered.push(child);
+      return;
+    }
+    if (getLessonkitBlockType(child.type) === "BranchChoice") return;
+    filtered.push(child);
+  });
+  return filtered;
+}
+function nodeHasChoices(node) {
+  let hasChoice = false;
+  import_react50.default.Children.forEach(node.props.children, (child) => {
+    if (!import_react50.default.isValidElement(child)) return;
+    if (getLessonkitBlockType(child.type) === "BranchChoice") hasChoice = true;
+  });
+  return hasChoice;
+}
+
+// src/blocks/BranchingScenario.tsx
+var import_jsx_runtime39 = require("react/jsx-runtime");
+var BranchingScenarioInner = (0, import_react51.forwardRef)(function BranchingScenarioInner2(props, ref) {
+  const { blockId, nodes, persistEnabled, startNodeId } = props;
+  validateCompoundChildren("BranchingScenario", nodes);
+  (0, import_react51.useLayoutEffect)(() => {
+    validateBranchGraphAtMount(startNodeId, nodes);
+  }, [startNodeId, nodes]);
+  const { config, track, storage } = useLessonkit();
+  const lessonId = useEnclosingLessonId();
+  const ctx = useCompoundRegistry();
+  const nodeIndexMap = (0, import_react51.useMemo)(() => buildNodeIndexMap(nodes), [nodes]);
+  const nodeLabels = (0, import_react51.useMemo)(() => buildNodeLabels(nodes), [nodes]);
+  const [meta, setMeta] = (0, import_react51.useState)(() => createInitialBranchMeta(startNodeId));
+  const metaRef = (0, import_react51.useRef)(meta);
+  const branchViewedRef = (0, import_react51.useRef)(/* @__PURE__ */ new Set());
+  const legacyResumeWarnedRef = (0, import_react51.useRef)(false);
+  const commitMeta = (0, import_react51.useCallback)((next) => {
+    metaRef.current = next;
+    setMeta(next);
+  }, []);
+  const activeIndex = nodeIndexMap.get(meta.activeNodeId) ?? 0;
+  const visitedNodeIndices = (0, import_react51.useMemo)(() => {
+    const indices = /* @__PURE__ */ new Set();
+    for (const nodeId of meta.visitedNodeIds) {
+      const i = nodeIndexMap.get(nodeId);
+      if (i !== void 0) indices.add(i);
+    }
+    return indices;
+  }, [meta.visitedNodeIds, nodeIndexMap]);
+  const syncBranchViewedRef = (0, import_react51.useCallback)(
+    (restoredMeta) => {
+      const next = /* @__PURE__ */ new Set();
+      for (const nodeId of restoredMeta.visitedNodeIds) {
+        if (nodeId !== restoredMeta.activeNodeId) {
+          next.add(`${blockId}:${nodeId}`);
+        }
+      }
+      branchViewedRef.current = next;
+    },
+    [blockId]
+  );
+  const applyResumeState = (0, import_react51.useCallback)(
+    (state) => {
+      const fromMeta = readBranchingScenarioMeta(state.childStates);
+      if (fromMeta) {
+        const sanitized = sanitizeBranchMeta(fromMeta, nodeIndexMap, startNodeId);
+        commitMeta(sanitized);
+        syncBranchViewedRef(sanitized);
+        return;
+      }
+      const hasChildCheckStates = Object.keys(state.childStates).some((k) => k !== BS_META_KEY);
+      const clampedIndex = (0, import_core23.clampCompoundPageIndex)(state.activePageIndex, nodes.length);
+      const nodeAtIndex = nodes[clampedIndex];
+      if (nodeAtIndex || hasChildCheckStates) {
+        const nodeId = nodeAtIndex?.props.nodeId ?? startNodeId;
+        const visitedNodeIds = [startNodeId];
+        if (nodeId !== startNodeId) visitedNodeIds.push(nodeId);
+        const legacyMeta = sanitizeBranchMeta(
+          { activeNodeId: nodeId, visitedNodeIds, choiceScores: {} },
+          nodeIndexMap,
+          startNodeId
+        );
+        commitMeta(legacyMeta);
+        syncBranchViewedRef(legacyMeta);
+        if (!legacyResumeWarnedRef.current && isDevEnvironment() && (hasChildCheckStates || state.activePageIndex !== 0)) {
+          legacyResumeWarnedRef.current = true;
+          console.warn(
+            "[lessonkit] BranchingScenario: legacy save without branch meta; restored via activePageIndex and child states"
+          );
+        }
+        return;
+      }
+      if (!legacyResumeWarnedRef.current && isDevEnvironment() && (state.activePageIndex !== 0 || Object.keys(state.childStates).length > 0)) {
+        legacyResumeWarnedRef.current = true;
+        console.warn(
+          "[lessonkit] BranchingScenario: legacy save without branch meta; starting at startNodeId"
+        );
+      }
+      const fresh = sanitizeBranchMeta(createInitialBranchMeta(startNodeId), nodeIndexMap, startNodeId);
+      commitMeta(fresh);
+      syncBranchViewedRef(fresh);
+    },
+    [commitMeta, nodeIndexMap, nodes, startNodeId, syncBranchViewedRef]
+  );
+  const resetBranchMeta = (0, import_react51.useCallback)(() => {
+    commitMeta(createInitialBranchMeta(startNodeId));
+    branchViewedRef.current = /* @__PURE__ */ new Set();
+  }, [commitMeta, startNodeId]);
+  const transformState = (0, import_react51.useCallback)(
+    (state) => mergeBranchMetaIntoState(state, metaRef.current),
+    []
+  );
+  const shouldIncludeChildState = (0, import_react51.useCallback)(
+    (_checkId, pageIndex) => pageIndex !== void 0 && visitedNodeIndices.has(pageIndex),
+    [visitedNodeIndices]
+  );
+  useCompoundPersistence({
+    courseId: config.courseId,
+    compoundId: blockId,
+    pageCount: nodes.length,
+    index: activeIndex,
+    setIndex: () => {
+    },
+    enabled: persistEnabled,
+    storage,
+    transformState,
+    onCompoundResume: applyResumeState,
+    shouldIncludeChildState
+  });
+  const maxChoiceScoreOnPath = (0, import_react51.useMemo)(() => {
+    if (!meta.choiceScores) return 0;
+    const branchFromIds = /* @__PURE__ */ new Set();
+    for (const key of Object.keys(meta.choiceScores)) {
+      const fromId = key.split(":")[0];
+      if (fromId) branchFromIds.add(fromId);
+    }
+    let total = 0;
+    for (const node of nodes) {
+      const nodeId = node.props.nodeId;
+      if (!branchFromIds.has(nodeId)) continue;
+      let maxWeight = 0;
+      let found = false;
+      for (const child of import_react51.default.Children.toArray(node.props.children)) {
+        if (!import_react51.default.isValidElement(child)) continue;
+        const weight = child.props.scoreWeight;
+        if (typeof weight === "number" && Number.isFinite(weight)) {
+          found = true;
+          maxWeight = Math.max(maxWeight, weight);
+        }
+      }
+      if (found) total += maxWeight;
+    }
+    return total;
+  }, [meta.choiceScores, nodes]);
+  useCompoundBranchHandle(ref, {
+    activePageIndex: activeIndex,
+    getRegisteredHandles: () => ctx?.getRegisteredHandles() ?? /* @__PURE__ */ new Map(),
+    visitedNodeIndices,
+    choiceScores: meta.choiceScores ?? {},
+    meta,
+    maxChoiceScore: maxChoiceScoreOnPath,
+    onResetMeta: resetBranchMeta,
+    enableSolutionsButton: props.enableSolutionsButton
+  });
+  const activeNode = nodes[activeIndex];
+  const isTerminal = Boolean(activeNode?.props.terminal) || (activeNode ? !nodeHasChoices(activeNode) && meta.activeNodeId !== startNodeId : false);
+  const visitedLabels = (0, import_react51.useMemo)(
+    () => meta.visitedNodeIds.map((id) => ({
+      nodeId: id,
+      label: nodeLabels.get(id) ?? id
+    })),
+    [meta.visitedNodeIds, nodeLabels]
+  );
+  (0, import_react51.useEffect)(() => {
+    if (!lessonId || !activeNode) return;
+    const dedupeKey = `${blockId}:${meta.activeNodeId}`;
+    if (branchViewedRef.current.has(dedupeKey)) return;
+    branchViewedRef.current.add(dedupeKey);
+    track(
+      "branch_node_viewed",
+      {
+        blockId,
+        nodeId: meta.activeNodeId,
+        nodeIndex: activeIndex,
+        nodeTitle: activeNode.props.title
+      },
+      { lessonId }
+    );
+  }, [activeIndex, activeNode, blockId, lessonId, meta.activeNodeId, track]);
+  const navigateToNode = (0, import_react51.useCallback)(
+    (opts) => {
+      const toNodeId = normalizeComponentId(opts.toNodeId, "blockId");
+      const fromNodeId = normalizeComponentId(opts.fromNodeId, "blockId");
+      if (!nodeIndexMap.has(toNodeId)) {
+        if (isDevEnvironment()) {
+          console.warn(
+            `[lessonkit] BranchingScenario: unknown targetNodeId "${toNodeId}" from "${fromNodeId}"`
+          );
+        }
+        return;
+      }
+      const activeNodeId = metaRef.current.activeNodeId;
+      if (fromNodeId !== activeNodeId) {
+        if (isDevEnvironment()) {
+          console.warn(
+            `[lessonkit] BranchingScenario: navigateToNode from "${fromNodeId}" but active node is "${activeNodeId}"`
+          );
+        }
+        return;
+      }
+      if (lessonId) {
+        track(
+          "branch_selected",
+          {
+            blockId,
+            fromNodeId,
+            toNodeId,
+            label: opts.label,
+            scoreWeight: opts.scoreWeight
+          },
+          { lessonId }
+        );
+      }
+      setMeta((prev) => {
+        const choiceScores = applyChoiceScoreUpdate(
+          prev.choiceScores,
+          fromNodeId,
+          toNodeId,
+          opts.scoreWeight
+        );
+        const visited = prev.visitedNodeIds.includes(toNodeId) ? prev.visitedNodeIds : [...prev.visitedNodeIds, toNodeId];
+        const next = sanitizeBranchMeta(
+          {
+            activeNodeId: toNodeId,
+            visitedNodeIds: visited,
+            choiceScores
+          },
+          nodeIndexMap,
+          startNodeId
+        );
+        metaRef.current = next;
+        return next;
+      });
+    },
+    [blockId, lessonId, nodeIndexMap, startNodeId, track]
+  );
+  const choicesLocked = isTerminal;
+  const contextValue = (0, import_react51.useMemo)(
+    () => ({
+      compoundBlockId: blockId,
+      activeNodeId: meta.activeNodeId,
+      visitedNodeIds: meta.visitedNodeIds,
+      visitedLabels: visitedLabels.map((entry) => entry.label),
+      navigateToNode,
+      isTerminal,
+      choicesLocked
+    }),
+    [blockId, choicesLocked, isTerminal, meta.activeNodeId, meta.visitedNodeIds, navigateToNode, visitedLabels]
+  );
+  const pathScore = ctx ? Array.from(ctx.getRegisteredHandles().values()).filter((h) => h.pageIndex !== void 0 && visitedNodeIndices.has(h.pageIndex)).reduce((s, h) => s + h.handle.getScore(), 0) + sumChoiceScores(meta.choiceScores) : 0;
+  const pathMaxScore = ctx ? Array.from(ctx.getRegisteredHandles().values()).filter((h) => h.pageIndex !== void 0 && visitedNodeIndices.has(h.pageIndex)).reduce((s, h) => s + h.handle.getMaxScore(), 0) + maxChoiceScoreOnPath : 0;
+  return /* @__PURE__ */ (0, import_jsx_runtime39.jsx)(BranchingScenarioProvider, { value: contextValue, children: /* @__PURE__ */ (0, import_jsx_runtime39.jsxs)("section", { "aria-label": props.title, "data-testid": "branching-scenario", "data-lk-block-id": blockId, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime39.jsx)("h3", { children: props.title }),
+    props.showPathScore && ctx ? /* @__PURE__ */ (0, import_jsx_runtime39.jsxs)("p", { "data-testid": "branch-score", children: [
+      "Score: ",
+      pathScore,
+      " / ",
+      pathMaxScore
+    ] }) : null,
+    props.showPathRecap && isTerminal && meta.visitedNodeIds.length > 0 ? /* @__PURE__ */ (0, import_jsx_runtime39.jsxs)("aside", { "data-testid": "branch-path-recap", "aria-label": "Your path", children: [
+      /* @__PURE__ */ (0, import_jsx_runtime39.jsx)("h4", { children: "Your path" }),
+      /* @__PURE__ */ (0, import_jsx_runtime39.jsx)("ol", { children: visitedLabels.map((entry) => /* @__PURE__ */ (0, import_jsx_runtime39.jsx)("li", { children: entry.label }, entry.nodeId)) })
+    ] }) : null,
+    /* @__PURE__ */ (0, import_jsx_runtime39.jsx)("div", { "data-testid": "branching-scenario-active-node", children: nodes.map((node, i) => {
+      const content = import_react51.default.Children.map(node.props.children, (child) => {
+        if (!import_react51.default.isValidElement(child)) return child;
+        if (getLessonkitBlockType(child.type) !== "BranchChoice") return child;
+        return import_react51.default.cloneElement(child, {
+          fromNodeId: node.props.nodeId
+        });
+      });
+      return import_react51.default.cloneElement(node, {
+        key: node.key ?? node.props.nodeId,
+        hidden: i !== activeIndex,
+        nodeIndex: i,
+        children: content
+      });
+    }) })
+  ] }) });
+});
+var BranchingScenario = (0, import_react51.forwardRef)(
+  function BranchingScenario2(props, ref) {
+    const nodes = import_react51.default.Children.toArray(props.children).filter(
+      import_react51.default.isValidElement
+    );
+    const { config } = useLessonkit();
+    const persistEnabled = config.session?.persistCompoundState !== false;
+    requireCompoundBlockIdWhenPersisting({
+      persistEnabled,
+      blockId: props.blockId,
+      componentName: "BranchingScenario"
+    });
+    const blockId = (0, import_react51.useMemo)(
+      () => normalizeComponentId(props.blockId, "blockId"),
+      [props.blockId]
+    );
+    const startNodeId = (0, import_react51.useMemo)(
+      () => normalizeComponentId(props.startNodeId, "blockId"),
+      [props.startNodeId]
+    );
+    const nodeIndexMap = (0, import_react51.useMemo)(() => buildNodeIndexMap(nodes), [nodes]);
+    const initialIndex = nodeIndexMap.get(startNodeId) ?? 0;
+    const hydrationKey = `${config.courseId ?? "no-course"}:${blockId}`;
+    const setIndexStable = (0, import_react51.useCallback)(() => {
+    }, []);
+    return /* @__PURE__ */ (0, import_jsx_runtime39.jsx)(CompoundProvider, { activePageIndex: initialIndex, onActivePageIndexChange: setIndexStable, children: /* @__PURE__ */ (0, import_jsx_runtime39.jsx)(
+      BranchingScenarioInner,
+      {
+        ...props,
+        startNodeId,
+        ref,
+        blockId,
+        nodes,
+        persistEnabled
+      },
+      hydrationKey
+    ) });
+  }
+);
+setLessonkitBlockType(BranchingScenario, "BranchingScenario");
+
+// src/blocks/BranchNode.tsx
+var import_react52 = require("react");
+var import_jsx_runtime40 = require("react/jsx-runtime");
+function BranchNode(props) {
+  validateCompoundChildren("BranchNode", filterBranchNodeContent(props.children));
+  return /* @__PURE__ */ (0, import_jsx_runtime40.jsxs)(
+    "section",
+    {
+      "aria-label": props.title ?? props.nodeId,
+      "data-lk-node-id": props.nodeId,
+      "data-testid": `branch-node-${props.nodeId}`,
+      hidden: props.hidden ? true : void 0,
+      style: props.hidden ? { display: "none" } : void 0,
+      children: [
+        props.title ? /* @__PURE__ */ (0, import_jsx_runtime40.jsx)("h4", { children: props.title }) : null,
+        /* @__PURE__ */ (0, import_jsx_runtime40.jsx)(CompoundPageIndexProvider, { pageIndex: props.nodeIndex ?? 0, children: /* @__PURE__ */ (0, import_jsx_runtime40.jsx)("div", { children: props.children }) })
+      ]
+    }
+  );
+}
+setLessonkitBlockType(BranchNode, "BranchNode");
+
+// src/blocks/BranchChoice.tsx
+var import_react53 = require("react");
+var import_jsx_runtime41 = require("react/jsx-runtime");
+function BranchChoice(props) {
+  const ctx = useBranchingScenarioOptional();
+  const groupId = (0, import_react53.useId)();
+  const fromNodeId = props.fromNodeId ?? ctx?.activeNodeId ?? "";
+  const isActiveNode = ctx ? ctx.activeNodeId === fromNodeId : true;
+  const locked = ctx?.choicesLocked ?? false;
+  const onSelect = () => {
+    if (!ctx || !fromNodeId || props.disabled || locked || !isActiveNode) return;
+    ctx.navigateToNode({
+      fromNodeId,
+      toNodeId: props.targetNodeId,
+      label: props.label,
+      scoreWeight: props.scoreWeight
+    });
+  };
+  return /* @__PURE__ */ (0, import_jsx_runtime41.jsx)(
+    "button",
+    {
+      type: "button",
+      role: "radio",
+      "aria-checked": false,
+      "aria-labelledby": groupId,
+      "data-testid": `branch-choice-${props.targetNodeId}`,
+      disabled: props.disabled || locked || !isActiveNode,
+      onClick: onSelect,
+      children: /* @__PURE__ */ (0, import_jsx_runtime41.jsx)("span", { id: groupId, children: props.label })
+    }
+  );
+}
+setLessonkitBlockType(BranchChoice, "BranchChoice");
+
+// src/blocks/Embed.tsx
+var import_react54 = require("react");
+var import_jsx_runtime42 = require("react/jsx-runtime");
+function Embed(props) {
+  const blockId = normalizeComponentId(props.blockId, "blockId");
+  const { config, track } = useLessonkit();
+  const lessonId = useEnclosingLessonId();
+  const resolvedSrc = resolveEmbedSrc(props.src, {
+    allowedHosts: config.embed?.allowedHosts
+  });
+  const sandbox = buildEmbedSandbox(props.allow, {
+    restrictPopupsInProduction: config.embed?.restrictPopupsInProduction ?? true
+  });
+  const aspectRatio = resolveEmbedAspectRatio(props.aspectRatio);
+  (0, import_react54.useEffect)(() => {
+    if (!resolvedSrc) return;
+    track(
+      "interaction",
+      { kind: "embed_viewed", blockId, src: telemetryEmbedSrc(resolvedSrc) },
+      lessonId ? { lessonId } : void 0
+    );
+  }, [blockId, lessonId, resolvedSrc, track]);
+  if (!resolvedSrc) {
+    return /* @__PURE__ */ (0, import_jsx_runtime42.jsx)("figure", { "data-lk-block-id": blockId, "data-testid": `embed-${blockId}`, children: /* @__PURE__ */ (0, import_jsx_runtime42.jsx)("p", { role: "alert", children: "This embed URL is not allowed." }) });
+  }
+  return /* @__PURE__ */ (0, import_jsx_runtime42.jsxs)("figure", { "data-lk-block-id": blockId, "data-testid": `embed-${blockId}`, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime42.jsx)(
+      "iframe",
+      {
+        title: props.title,
+        src: resolvedSrc,
+        sandbox,
+        referrerPolicy: "no-referrer",
+        style: aspectRatio ? { aspectRatio, width: "100%", border: 0 } : { width: "100%", border: 0 }
+      }
+    ),
+    /* @__PURE__ */ (0, import_jsx_runtime42.jsx)("figcaption", { className: "lk-visually-hidden", children: props.title })
+  ] });
+}
+setLessonkitBlockType(Embed, "Embed");
+
+// src/blocks/Chart.tsx
+var import_react55 = require("react");
+
+// src/blocks/chartUtils.ts
+function normalizeChartType(type) {
+  if (type === "bar" || type === "pie") return type;
+  if (type !== void 0 && isDevEnvironment()) {
+    console.warn(`[lessonkit] Chart: unknown type "${type}"; rendering data table only.`);
+  }
+  return type === void 0 ? "pie" : "table";
+}
+function normalizeChartData(data) {
+  if (!Array.isArray(data)) return [];
+  const rows = [];
+  for (let i = 0; i < data.length; i += 1) {
+    const row = data[i];
+    if (!row || typeof row !== "object") continue;
+    const label = typeof row.label === "string" ? row.label : `Item ${i + 1}`;
+    const raw = Number(row.value);
+    const value = Number.isFinite(raw) && raw >= 0 ? raw : 0;
+    rows.push({ label, value, key: `${label}-${i}` });
+  }
+  return rows;
+}
+function chartMaxValue(rows) {
+  if (rows.length === 0) return 1;
+  return Math.max(...rows.map((row) => row.value), 1);
+}
+
+// src/blocks/Chart.tsx
+var import_jsx_runtime43 = require("react/jsx-runtime");
+function Chart(props) {
+  const blockId = normalizeComponentId(props.blockId, "blockId");
+  const { track } = useLessonkit();
+  const lessonId = useEnclosingLessonId();
+  const chartType = normalizeChartType(props.type);
+  const rows = (0, import_react55.useMemo)(() => normalizeChartData(props.data), [props.data]);
+  const max = (0, import_react55.useMemo)(() => chartMaxValue(rows), [rows]);
+  (0, import_react55.useEffect)(() => {
+    track(
+      "interaction",
+      { kind: "chart_viewed", blockId, chartType },
+      lessonId ? { lessonId } : void 0
+    );
+  }, [blockId, chartType, lessonId, track]);
+  return /* @__PURE__ */ (0, import_jsx_runtime43.jsxs)("figure", { "data-lk-block-id": blockId, "data-testid": `chart-${blockId}`, children: [
+    props.title ? /* @__PURE__ */ (0, import_jsx_runtime43.jsx)("figcaption", { children: props.title }) : null,
+    rows.length === 0 ? /* @__PURE__ */ (0, import_jsx_runtime43.jsx)("p", { "data-testid": "chart-empty", children: "No chart data." }) : chartType === "table" ? null : chartType === "bar" ? /* @__PURE__ */ (0, import_jsx_runtime43.jsx)("div", { role: "img", "aria-label": props.title ?? "Bar chart", "aria-describedby": `${blockId}-table`, children: rows.map((datum) => /* @__PURE__ */ (0, import_jsx_runtime43.jsxs)("div", { style: { display: "flex", alignItems: "center", gap: "0.5rem" }, children: [
+      /* @__PURE__ */ (0, import_jsx_runtime43.jsx)("span", { style: { minWidth: "6rem" }, children: datum.label }),
+      /* @__PURE__ */ (0, import_jsx_runtime43.jsx)(
+        "div",
+        {
+          style: {
+            height: "1rem",
+            width: `${datum.value / max * 100}%`,
+            background: "var(--lk-color-primary, #2563eb)"
+          },
+          "aria-hidden": true
+        }
+      ),
+      /* @__PURE__ */ (0, import_jsx_runtime43.jsx)("span", { children: datum.value })
+    ] }, datum.key)) }) : /* @__PURE__ */ (0, import_jsx_runtime43.jsx)("ul", { role: "list", "aria-label": props.title ?? "Pie chart segments", children: rows.map((datum) => /* @__PURE__ */ (0, import_jsx_runtime43.jsxs)("li", { children: [
+      datum.label,
+      ": ",
+      datum.value
+    ] }, datum.key)) }),
+    /* @__PURE__ */ (0, import_jsx_runtime43.jsxs)("table", { id: `${blockId}-table`, children: [
+      /* @__PURE__ */ (0, import_jsx_runtime43.jsx)("caption", { children: props.title ?? "Chart data" }),
+      /* @__PURE__ */ (0, import_jsx_runtime43.jsx)("thead", { children: /* @__PURE__ */ (0, import_jsx_runtime43.jsxs)("tr", { children: [
+        /* @__PURE__ */ (0, import_jsx_runtime43.jsx)("th", { scope: "col", children: "Label" }),
+        /* @__PURE__ */ (0, import_jsx_runtime43.jsx)("th", { scope: "col", children: "Value" })
+      ] }) }),
+      /* @__PURE__ */ (0, import_jsx_runtime43.jsx)("tbody", { children: rows.map((datum) => /* @__PURE__ */ (0, import_jsx_runtime43.jsxs)("tr", { children: [
+        /* @__PURE__ */ (0, import_jsx_runtime43.jsx)("th", { scope: "row", children: datum.label }),
+        /* @__PURE__ */ (0, import_jsx_runtime43.jsx)("td", { children: datum.value })
+      ] }, datum.key)) })
+    ] })
+  ] });
+}
+setLessonkitBlockType(Chart, "Chart");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Accordion,
   ArithmeticQuiz,
   AssessmentSequence,
+  BranchChoice,
+  BranchNode,
+  BranchingScenario,
+  Chart,
   DialogCards,
   DragAndDrop,
   DragTheWords,
+  Embed,
   Essay,
   FillInTheBlanks,
   FindHotspot,