@intellectif/lk-react 5.0.0 → 6.1.0

package/dist/{chunk-67RIIDZX.cjs → chunk-NPY2F7F6.cjs}

@@ -1,8 +1,9 @@
+'use client';
 'use strict';
 
 var chunkPGEG7UZJ_cjs = require('./chunk-PGEG7UZJ.cjs');
 var chunk4HZ7LQIH_cjs = require('./chunk-4HZ7LQIH.cjs');
-var chunkHD2AIQRD_cjs = require('./chunk-HD2AIQRD.cjs');
+var chunkXOR4MPEN_cjs = require('./chunk-XOR4MPEN.cjs');
 var lkCore = require('@intellectif/lk-core');
 var react = require('react');
 var jsxRuntime = require('react/jsx-runtime');
@@ -50,6 +51,7 @@ function FillInTheBlanks({
   onInteraction,
   value,
   defaultValue,
+  defaultSubmitted,
   renderMode = "practice",
   outcome,
   sanitizeHtml,
@@ -75,7 +77,9 @@ function FillInTheBlanks({
     const result2 = lkCore.validateActivity("fill-in-the-blanks", data);
     return result2.success ? null : new lkCore.ActivitySchemaError("fill-in-the-blanks", result2.errors);
   }, [data]);
-  const { state, start, complete, getTimeSpent, reset } = chunkHD2AIQRD_cjs.useActivityState();
+  const { state, start, complete, getTimeSpent, reset } = chunkXOR4MPEN_cjs.useActivityState(
+    defaultSubmitted === true ? "completed" : "idle"
+  );
   const isControlled = value !== void 0;
   const [internalAnswers, setInternalAnswers] = react.useState(
     () => answersOf(defaultValue)
@@ -89,13 +93,22 @@ function FillInTheBlanks({
   react.useEffect(() => {
     defaultValueRef.current = defaultValue;
   }, [defaultValue]);
+  const defaultSubmittedRef = react.useRef(defaultSubmitted);
+  react.useEffect(() => {
+    defaultSubmittedRef.current = defaultSubmitted;
+  }, [defaultSubmitted]);
+  const lastDataRef = react.useRef(data);
   react.useEffect(() => {
+    if (lastDataRef.current === data) {
+      return;
+    }
+    lastDataRef.current = data;
     setInternalAnswers(answersOf(defaultValueRef.current));
     setRevealed(/* @__PURE__ */ new Set());
     setResult(null);
     setSummary(null);
     setFeedbackHidden(false);
-    reset();
+    reset(defaultSubmittedRef.current === true ? "completed" : "idle");
   }, [data, reset]);
   react.useEffect(() => {
     if (chunkPGEG7UZJ_cjs.isDevelopment() && sanitizeHtml !== void 0 && data.passageHtml !== void 0) {
@@ -321,5 +334,5 @@ function FillInTheBlanks2(props) {
 }
 
 exports.FillInTheBlanks = FillInTheBlanks2;
-//# sourceMappingURL=chunk-67RIIDZX.cjs.map
-//# sourceMappingURL=chunk-67RIIDZX.cjs.map
+//# sourceMappingURL=chunk-NPY2F7F6.cjs.map
+//# sourceMappingURL=chunk-NPY2F7F6.cjs.map

package/dist/chunk-NPY2F7F6.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/FillInTheBlanks/FillInTheBlanks.tsx","../src/components/FillInTheBlanks/index.tsx"],"names":["useMemo","isDevelopment","assertRedacted","result","validateActivity","ActivitySchemaError","useActivityState","useState","useRef","useEffect","score","xAPIBuilder","ANONYMOUS_ACTOR","objectIdFor","xapiDefinitionFor","jsxs","jsx","ActivityMedia","Fragment","FeedbackRegion","FillInTheBlanks","ActivityErrorBoundary"],"mappings":"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","file":"chunk-NPY2F7F6.cjs","sourcesContent":["'use client';\n\nimport {\n  ActivitySchemaError,\n  assertRedacted,\n  type FillInTheBlanksData,\n  type FillInTheBlanksLearnerResponse,\n  type LearnerResponse,\n  type ScoringDetail,\n  type ScoringResult,\n  score,\n  validateActivity,\n  xAPIBuilder,\n  xapiDefinitionFor,\n} from '@intellectif/lk-core';\nimport { type CSSProperties, useEffect, useMemo, useRef, useState } from 'react';\nimport { useActivityState } from '../../hooks/useActivityState.js';\nimport { ANONYMOUS_ACTOR, isDevelopment, objectIdFor } from '../_internal.js';\nimport { ActivityMedia } from '../shared/ActivityMedia.js';\nimport { FeedbackRegion } from '../shared/FeedbackRegion.js';\nimport type { ActivityProps } from '../types.js';\n\nexport interface FillInTheBlanksProps extends ActivityProps<FillInTheBlanksData> {\n  /**\n   * After submission, replace each incorrectly-answered blank with its first\n   * accepted answer, styled distinctly (Req 5.7). Component-specific prop: it\n   * is presentation, not activity data, and is outside the fixed Req-3.1 set.\n   *\n   * Ignored in `exam` mode — revealing the key is precisely what an exam must\n   * not do, and on a `redact()` projection there is no key to reveal. In\n   * `review` mode it applies only to blanks the supplied `outcome` marks\n   * incorrect, and only when the caller passed data that still carries the key\n   * (e.g. `redact(data, { reveal: 'after-submit' })`).\n   */\n  showCorrectAnswers?: boolean;\n}\n\nconst PLACEHOLDER = /\\{\\{\\s*([^{}]+?)\\s*\\}\\}/g;\n\ntype Segment = { kind: 'text'; value: string } | { kind: 'blank'; id: string; ordinal: number };\n\nfunction parsePassage(passage: string): Segment[] {\n  const segments: Segment[] = [];\n  const re = new RegExp(PLACEHOLDER);\n  let last = 0;\n  let ordinal = 0;\n  let match = re.exec(passage);\n  while (match !== null) {\n    if (match.index > last) {\n      segments.push({ kind: 'text', value: passage.slice(last, match.index) });\n    }\n    ordinal += 1;\n    segments.push({ kind: 'blank', id: match[1] as string, ordinal });\n    last = match.index + match[0].length;\n    match = re.exec(passage);\n  }\n  if (last < passage.length) {\n    segments.push({ kind: 'text', value: passage.slice(last) });\n  }\n  return segments;\n}\n\n/** Shared empty map: keeps the \"no response supplied\" path allocation-free. */\nconst NO_ANSWERS: Record<string, string> = {};\n\n/**\n * Reads the answer map out of a `LearnerResponse`. A response of another\n * activity type is treated as \"no answers\" rather than throwing: a controlled\n * host that has not yet swapped its state on an activity change would\n * otherwise crash the attempt.\n */\nfunction answersOf(response: LearnerResponse | undefined): Record<string, string> {\n  return response !== undefined && response.type === 'fill-in-the-blanks'\n    ? response.answers\n    : NO_ANSWERS;\n}\n\n/**\n * Per-item correctness keyed by blank id. Prefers the unambiguous `outcome`\n * field (always written by the built-in scorers since lk-core 0.3.0) and\n * falls back to the deprecated `correct` boolean so a 0.2-era\n * consumer-constructed `ItemOutcome` still marks correctly in `review`.\n */\nfunction correctnessByItem(details: readonly ScoringDetail[]): Map<string, boolean> {\n  const map = new Map<string, boolean>();\n  for (const detail of details) {\n    map.set(\n      detail.itemId,\n      detail.outcome !== undefined ? detail.outcome === 'correct' : detail.correct,\n    );\n  }\n  return map;\n}\n\nexport function FillInTheBlanks({\n  data,\n  onComplete,\n  onSubmit,\n  onChange,\n  onInteraction,\n  value,\n  defaultValue,\n  defaultSubmitted,\n  renderMode = 'practice',\n  outcome,\n  sanitizeHtml,\n  theme,\n  locale,\n  disabled,\n  showCorrectAnswers,\n}: FillInTheBlanksProps) {\n  const isExam = renderMode === 'exam';\n  const isReview = renderMode === 'review';\n\n  // Dev-only boundary validation (Req 2.3); throws in render so the wrapping\n  // ActivityErrorBoundary catches it. Re-runs only when data changes.\n  const devError = useMemo(() => {\n    if (!isDevelopment()) {\n      return null;\n    }\n    if (data.redacted === true) {\n      // A redact() projection cannot satisfy the full content schema — the\n      // answer key is gone by design. Validate it against the STRICT redacted\n      // schema instead, which additionally proves the payload is learner-safe.\n      try {\n        assertRedacted(data);\n        return null;\n      } catch (error) {\n        return error instanceof Error ? error : new Error(String(error));\n      }\n    }\n    const result = validateActivity('fill-in-the-blanks', data);\n    return result.success ? null : new ActivitySchemaError('fill-in-the-blanks', result.errors);\n  }, [data]);\n\n  const { state, start, complete, getTimeSpent, reset } = useActivityState(\n    defaultSubmitted === true ? 'completed' : 'idle',\n  );\n  // Controlled when `value` is supplied: the answers rendered are ALWAYS the\n  // caller's, and internal state is never read. Uncontrolled otherwise,\n  // seeded from `defaultValue`.\n  const isControlled = value !== undefined;\n  const [internalAnswers, setInternalAnswers] = useState<Record<string, string>>(() =>\n    answersOf(defaultValue),\n  );\n  const [revealed, setRevealed] = useState<Set<string>>(() => new Set());\n  const [result, setResult] = useState<ScoringResult | null>(null);\n  const [summary, setSummary] = useState<string | null>(null);\n  const [feedbackHidden, setFeedbackHidden] = useState(false);\n\n  const answers = isControlled ? answersOf(value) : internalAnswers;\n\n  // `defaultValue` is read only by the reset effect, and it is commonly an\n  // inline object literal — putting it in that effect's deps would re-seed\n  // (and wipe) the learner's typing on every render. Mirror it into a ref in\n  // its own effect, which commits before the reset effect below.\n  const defaultValueRef = useRef(defaultValue);\n  useEffect(() => {\n    defaultValueRef.current = defaultValue;\n  }, [defaultValue]);\n\n  // Mirror `defaultSubmitted` so the reset below returns to the SEEDED state.\n  // Resetting unconditionally to idle unlocked an item the learner had already\n  // committed — which made `defaultSubmitted` a no-op here, since this effect\n  // runs right after the first paint.\n  const defaultSubmittedRef = useRef(defaultSubmitted);\n  useEffect(() => {\n    defaultSubmittedRef.current = defaultSubmitted;\n  }, [defaultSubmitted]);\n\n  // Identity guard so the MOUNT run is a no-op. Without it this effect fires\n  // after the first paint and undoes every seed it was just given; with it,\n  // only a real `data` change resets. A parent that rebuilds structurally\n  // identical entries in render (`activities={raw.map(redact)}`) must not\n  // unlock or revert a restored answer — the pager already remounts a slot\n  // whose activity actually changed, via its key.\n  const lastDataRef = useRef(data);\n  // `data` is an intentional reset trigger (Req 3.7), not read in the body.\n  // biome-ignore lint/correctness/useExhaustiveDependencies: data is the reset trigger (Req 3.7)\n  useEffect(() => {\n    if (lastDataRef.current === data) {\n      return;\n    }\n    lastDataRef.current = data;\n    setInternalAnswers(answersOf(defaultValueRef.current));\n    setRevealed(new Set());\n    setResult(null);\n    setSummary(null);\n    setFeedbackHidden(false);\n    reset(defaultSubmittedRef.current === true ? 'completed' : 'idle');\n  }, [data, reset]);\n\n  /*\n   * RICH TEXT — deliberate, documented limitation (see `sanitizeHtml`).\n   *\n   * Every other activity can render its `*Html` field through the caller's\n   * sanitiser, because the rich text is a LEAF: the sanitised string is\n   * handed to one `dangerouslySetInnerHTML` node and nothing is inserted into\n   * it. A fill-in-the-blanks passage is not a leaf — it is the CONTAINER of\n   * the React-controlled `<input>`s, one per `{{id}}` placeholder.\n   *\n   * Placing those inputs inside sanitised HTML means slicing the sanitised\n   * string at the placeholders and injecting each slice as its own HTML\n   * fragment, which is unsafe and broken on both counts:\n   *   1. Broken: the slices are unbalanced. `<p>A {{x}} B</p>` yields `<p>A `\n   *      and ` B</p>`; the fragment parser auto-closes both, so the input\n   *      lands OUTSIDE the paragraph and the authored block structure is\n   *      destroyed.\n   *   2. Unsafe: the sanitiser's guarantee covers the document it returned,\n   *      not arbitrary substrings of it. A placeholder inside an attribute\n   *      (`<img alt=\"{{x}}\">`) splits mid-attribute, and re-parsing the\n   *      halves in a fresh context is exactly the mutation (mXSS) class of\n   *      transformation that voids a sanitiser's output guarantee. An exam\n   *      runner must never depend on that.\n   *\n   * The safe alternative — parse the sanitised string once into a detached\n   * DOM, split only TEXT nodes at placeholders, and portal the inputs into\n   * anchors — needs a DOM at render time (no SSR) and a large imperative\n   * subsystem. Until that lands, the plain-text `passage` is rendered (always\n   * escaped by React), which is correct, answerable, and safe in every mode.\n   * `data.passageHtml` is carried and redacted by lk-core regardless, so no\n   * authored content is lost — only this component declines to render it.\n   */\n  useEffect(() => {\n    if (isDevelopment() && sanitizeHtml !== undefined && data.passageHtml !== undefined) {\n      console.warn(\n        '[lk-react] FillInTheBlanks ignores `passageHtml`: the passage hosts the answer inputs, ' +\n          'so rich HTML cannot be split at {{placeholders}} without voiding the sanitiser. ' +\n          'Rendering the plain `passage` instead.',\n      );\n    }\n  }, [sanitizeHtml, data.passageHtml]);\n\n  const segments = useMemo(() => parsePassage(data.passage), [data.passage]);\n  const blankById = useMemo(() => new Map(data.blanks.map((b) => [b.id, b])), [data.blanks]);\n\n  if (devError) {\n    throw devError;\n  }\n  // Practice grades locally, which a redacted projection cannot support: the\n  // submit handler below calls `score()`, which throws RedactedScoringError —\n  // from an event handler, where no error boundary can catch it, AFTER the\n  // learner has typed their answers. Fail loudly at render instead, in\n  // production too. This mirrors the identical guard in MultipleChoice;\n  // without it the two built-ins disagreed about the same accident, and\n  // wiring an exam item into the self-grading mode is precisely what\n  // `renderMode` exists to prevent.\n  if (data.redacted === true && renderMode === 'practice') {\n    throw new Error(\n      `Fill-in-the-Blanks \"${data.id}\" received redacted activity data in renderMode \"practice\", ` +\n        'which grades locally and has no answer key to grade against. ' +\n        'Render redacted data with renderMode=\"exam\" (server grades) or \"review\" (pass `outcome`).',\n    );\n  }\n\n  const submitted = state === 'completed';\n  const inactive = disabled === true || submitted || isReview;\n\n  /**\n   * Whether the component may show answer-key-derived information (per-blank\n   * correctness, authored feedback, correct answers). NEVER in `exam`; in\n   * `practice` only after the component scored locally; in `review` only once\n   * the caller supplies a SCORED outcome — an item that is still awaiting a\n   * grade must not have its key revealed just because it is being read back.\n   */\n  const revealing = isReview ? outcome?.status === 'scored' : !isExam && submitted;\n\n  const fireInteraction = (\n    type: 'blank-filled' | 'hint-requested' | 'submitted',\n    payload: Record<string, unknown>,\n  ): void => {\n    onInteraction?.({ type, activityId: data.id, timestamp: Date.now(), payload });\n  };\n\n  const handleChange = (blankId: string, text: string): void => {\n    if (inactive) {\n      return;\n    }\n    if (state === 'idle') {\n      start();\n    }\n    const next = { ...answers, [blankId]: text };\n    if (!isControlled) {\n      setInternalAnswers(next);\n    }\n    onChange?.({ type: 'fill-in-the-blanks', answers: next });\n    fireInteraction('blank-filled', { blankId, value: text });\n  };\n\n  const toggleHint = (blankId: string): void => {\n    if (inactive) {\n      return;\n    }\n    if (state === 'idle') {\n      start();\n    }\n    setRevealed((prev) => {\n      const next = new Set(prev);\n      if (next.has(blankId)) {\n        next.delete(blankId);\n        return next;\n      }\n      next.add(blankId);\n      return next;\n    });\n    // Only a reveal is a \"hint requested\"; hiding is not a new request.\n    if (!revealed.has(blankId)) {\n      fireInteraction('hint-requested', { blankId });\n    }\n  };\n\n  const handleSubmit = (event: React.FormEvent): void => {\n    event.preventDefault();\n    if (inactive) {\n      return;\n    }\n    const response: FillInTheBlanksLearnerResponse = { type: 'fill-in-the-blanks', answers };\n    // Fires in every submitting mode and always BEFORE onComplete, so an exam\n    // runner can persist the raw response regardless of local grading.\n    onSubmit?.(response);\n\n    if (isExam) {\n      // EXAM: the client neither grades nor reveals. No score()/evaluate(), no\n      // read of any answer-key field, no onComplete — and no xAPI statement,\n      // because its `correctResponsesPattern` IS the answer key. The server\n      // owns the grade; it emits the statement.\n      complete();\n      setSummary('Answer submitted.');\n      fireInteraction('submitted', { answers });\n      return;\n    }\n\n    // PRACTICE: unchanged v1 behaviour. `data` carries the key here — exam\n    // mode is the only path that may be handed a redact() projection.\n    const scoringResult = score('fill-in-the-blanks', data as FillInTheBlanksData, response);\n    complete();\n    const timeSpent = getTimeSpent();\n    const xapiStatement = xAPIBuilder.buildAnsweredStatement({\n      actor: ANONYMOUS_ACTOR,\n      object: {\n        id: objectIdFor(data.id),\n        name: { [data.locale ?? 'en-US']: data.title },\n        ...xapiDefinitionFor(data),\n      },\n      scoringResult,\n      timeSpentMs: timeSpent,\n      response: JSON.stringify(answers),\n    });\n    setResult(scoringResult);\n    onComplete?.({\n      score: scoringResult.score,\n      maxScore: scoringResult.maxScore,\n      passed: scoringResult.passed,\n      timeSpent,\n      xapiStatement,\n    });\n    // Core selects the authored overall feedback on `passed` (B3 fix).\n    const overall = scoringResult.feedback;\n    setSummary(\n      `Answer submitted. Score ${Math.round(scoringResult.score * 100)}%. ${\n        scoringResult.passed ? 'Passed.' : 'Not passed.'\n      }${overall ? ` ${overall}` : ''}`,\n    );\n    fireInteraction('submitted', { answers, score: scoringResult.score });\n  };\n\n  const correctByBlank = useMemo(() => {\n    if (isExam) {\n      // Nothing is ever marked client-side in an exam.\n      return new Map<string, boolean>();\n    }\n    if (isReview) {\n      // Correctness comes ONLY from the server-computed outcome; the component\n      // never scores in review, so an absent/ungraded outcome marks nothing.\n      return outcome?.status === 'scored'\n        ? correctnessByItem(outcome.details)\n        : new Map<string, boolean>();\n    }\n    return correctnessByItem(result?.details ?? []);\n  }, [isExam, isReview, outcome, result]);\n\n  /** Review has no local score: its summary is read off `outcome`, or nothing. */\n  const reviewSummary = useMemo(() => {\n    if (!isReview || outcome === undefined) {\n      return null;\n    }\n    if (outcome.status === 'scored') {\n      return `Score ${Math.round(outcome.score * 100)}%. ${\n        outcome.passed ? 'Passed.' : 'Not passed.'\n      }${outcome.feedback ? ` ${outcome.feedback}` : ''}`;\n    }\n    return outcome.status === 'deferred' ? 'Not graded yet.' : 'No grade available.';\n  }, [isReview, outcome]);\n\n  return (\n    <form\n      className=\"lk-fib\"\n      aria-label={data.title}\n      lang={locale}\n      data-render-mode={renderMode}\n      style={theme as CSSProperties | undefined}\n      onSubmit={handleSubmit}\n    >\n      {data.media ? <ActivityMedia media={data.media} /> : null}\n      <fieldset disabled={inactive}>\n        <p className=\"lk-fib-passage\">\n          {segments.map((seg, i) => {\n            if (seg.kind === 'text') {\n              // biome-ignore lint/suspicious/noArrayIndexKey: passage segments are positional and static\n              return <span key={`t${i}`}>{seg.value}</span>;\n            }\n            const blank = blankById.get(seg.id);\n            if (!blank) {\n              return null;\n            }\n            // `Renderable` only widens `scoringStrategy` at the type level, so\n            // the answer-key fields still LOOK required here while a redact()\n            // projection omits them at runtime. Read them defensively, and\n            // never at all in exam mode.\n            const acceptedAnswers: string[] | undefined = isExam\n              ? undefined\n              : blank.acceptedAnswers;\n            const blankFeedback = isExam ? undefined : blank.feedback;\n            const correctness = correctByBlank.get(seg.id);\n            const hintId = `${data.id}-hint-${seg.id}`;\n            const correctAnswer = acceptedAnswers?.[0];\n            if (revealing && showCorrectAnswers && correctness === false && correctAnswer) {\n              return (\n                <span key={seg.id} className=\"lk-fib-answer\" data-correct=\"false\">\n                  {correctAnswer}\n                </span>\n              );\n            }\n            return (\n              <span key={seg.id} className=\"lk-fib-blank\">\n                <input\n                  type=\"text\"\n                  aria-label={`Fill in blank ${seg.ordinal}`}\n                  aria-describedby={blank.hint ? hintId : undefined}\n                  value={answers[seg.id] ?? ''}\n                  disabled={inactive}\n                  aria-disabled={inactive || undefined}\n                  data-correct={\n                    revealing && correctness !== undefined ? String(correctness) : undefined\n                  }\n                  onChange={(e) => handleChange(seg.id, e.target.value)}\n                />\n                {/*\n                  Hints stay available in exam mode by design: lk-core's field\n                  policy classifies `blanks.hint` as `public`, so it survives\n                  redact() and is not part of the answer key.\n                */}\n                {blank.hint ? (\n                  <>\n                    {/*\n                      Default affordance is an icon; the accessible NAME stays\n                      text via aria-label (screen readers + tests rely on it).\n                      The glyph is restylable/replaceable via .lk-fib-hint-btn.\n                    */}\n                    <button\n                      type=\"button\"\n                      className=\"lk-fib-hint-btn\"\n                      aria-controls={hintId}\n                      aria-expanded={revealed.has(seg.id)}\n                      aria-label={revealed.has(seg.id) ? 'Hide hint' : 'Show hint'}\n                      disabled={inactive}\n                      onClick={() => toggleHint(seg.id)}\n                    >\n                      <svg\n                        className=\"lk-fib-hint-icon\"\n                        viewBox=\"0 0 24 24\"\n                        width=\"16\"\n                        height=\"16\"\n                        aria-hidden=\"true\"\n                        focusable=\"false\"\n                      >\n                        <path\n                          fill=\"currentColor\"\n                          d=\"M9 21h6v-1H9v1Zm3-19a7 7 0 0 0-4 12.74V17h8v-2.26A7 7 0 0 0 12 2Z\"\n                        />\n                      </svg>\n                    </button>\n                    {/*\n                      Not role=\"tooltip\": a real ARIA tooltip is a named\n                      hover/focus popup with strict WCAG 1.4.13 constraints.\n                      This is an accessible click-to-toggle disclosure that is\n                      the input's aria-describedby target and is announced via\n                      aria-live; the skin gives it a tooltip-like *visual*\n                      without the tooltip *semantics*. (Refines Task 15.3.)\n                    */}\n                    <span id={hintId} aria-live=\"polite\">\n                      {revealed.has(seg.id) ? blank.hint : ''}\n                    </span>\n                  </>\n                ) : null}\n                {revealing && !feedbackHidden && blankFeedback ? (\n                  <span\n                    className=\"lk-fib-blank-feedback\"\n                    role=\"note\"\n                    data-correct={correctness !== undefined ? String(correctness) : undefined}\n                  >\n                    {blankFeedback}\n                  </span>\n                ) : null}\n              </span>\n            );\n          })}\n        </p>\n        {/* Review is read-only: there is nothing to submit. */}\n        {isReview ? null : (\n          <button type=\"submit\" disabled={inactive}>\n            {isExam ? 'Submit answers' : 'Check answers'}\n          </button>\n        )}\n      </fieldset>\n      {revealing && data.blanks.some((b) => b.feedback) ? (\n        <button\n          type=\"button\"\n          className=\"lk-fib-feedback-toggle\"\n          aria-expanded={!feedbackHidden}\n          onClick={() => setFeedbackHidden((h) => !h)}\n        >\n          {feedbackHidden ? 'Show feedback' : 'Hide feedback'}\n        </button>\n      ) : null}\n      <FeedbackRegion id={`${data.id}-feedback`}>\n        {isReview ? reviewSummary : summary}\n      </FeedbackRegion>\n    </form>\n  );\n}\n","'use client';\n\nimport { ActivityErrorBoundary } from '../ActivityErrorBoundary.js';\nimport {\n  FillInTheBlanks as FillInTheBlanksCore,\n  type FillInTheBlanksProps,\n} from './FillInTheBlanks.js';\n\nexport type { FillInTheBlanksProps } from './FillInTheBlanks.js';\n\n/**\n * Public Fill-in-the-Blanks activity: the core wrapped in\n * `ActivityErrorBoundary` so a render failure (incl. the dev schema-validation\n * throw) degrades to an accessible fallback instead of crashing the host.\n */\nexport function FillInTheBlanks(props: FillInTheBlanksProps) {\n  return (\n    <ActivityErrorBoundary activityTitle={props.data?.title}>\n      <FillInTheBlanksCore {...props} />\n    </ActivityErrorBoundary>\n  );\n}\n"]}

package/dist/chunk-PGEG7UZJ.cjs

@@ -1,3 +1,4 @@
+'use client';
 'use strict';
 
 var react = require('react');

package/dist/{chunk-IYLQSNLE.cjs → chunk-PNNUPUH4.cjs}

@@ -1,3 +1,4 @@
+'use client';
 'use strict';
 
 var react = require('react');
@@ -77,5 +78,5 @@ function useXAPI(config) {
 }
 
 exports.useXAPI = useXAPI;
-//# sourceMappingURL=chunk-IYLQSNLE.cjs.map
-//# sourceMappingURL=chunk-IYLQSNLE.cjs.map
+//# sourceMappingURL=chunk-PNNUPUH4.cjs.map
+//# sourceMappingURL=chunk-PNNUPUH4.cjs.map

package/dist/chunk-PNNUPUH4.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hooks/useXAPI.ts"],"names":["useRef","useCallback"],"mappings":"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","file":"chunk-PNNUPUH4.cjs","sourcesContent":["'use client';\n\nimport type { XAPIConfig, XAPIStatement } from '@intellectif/lk-core';\nimport { useCallback, useRef } from 'react';\n\n/** Backoff before retry 1 / 2 / 3 (Req 10.4). */\nconst BACKOFF_MS = [1000, 2000, 4000] as const;\n\n/**\n * Applies the configured learner identity to a statement built by an activity\n * component. Components emit an anonymous placeholder actor and a\n * `urn:learning-kit:activity:*` object id (they cannot know identity — Req\n * 3.1); this hook is the documented place where `XAPIConfig.actor` and\n * `XAPIConfig.activityId` take over. Conservative on purpose: the actor is\n * replaced only when the statement still carries the SDK's anonymous\n * placeholder, and the object id only when it is still the SDK URN — a\n * consumer that already rewrote either keeps its own values.\n */\nfunction applyIdentity(statement: XAPIStatement, cfg: XAPIConfig): XAPIStatement {\n  const isAnonymous =\n    statement.actor?.account?.name === 'anonymous' &&\n    statement.actor.account.homePage === 'https://github.com/intellectif/learning-kit';\n  const isSdkObjectId =\n    statement.object?.objectType === 'Activity' &&\n    typeof statement.object.id === 'string' &&\n    statement.object.id.startsWith('urn:learning-kit:activity:');\n\n  if (!isAnonymous && !isSdkObjectId) {\n    return statement;\n  }\n  const mappedId =\n    isSdkObjectId && cfg.activityId\n      ? typeof cfg.activityId === 'function'\n        ? cfg.activityId(statement.object.id)\n        : cfg.activityId\n      : undefined;\n  return {\n    ...statement,\n    ...(isAnonymous && cfg.actor !== undefined ? { actor: cfg.actor } : {}),\n    ...(mappedId !== undefined ? { object: { ...statement.object, id: mappedId } } : {}),\n  };\n}\n\n/** UTF-8-safe base64 (`btoa` is Latin1-only and breaks on non-ASCII creds). */\nfunction toBase64Utf8(input: string): string {\n  const bytes = new TextEncoder().encode(input);\n  let binary = '';\n  for (const byte of bytes) {\n    binary += String.fromCharCode(byte);\n  }\n  return btoa(binary);\n}\n\nfunction authHeader(auth: XAPIConfig['auth']): string {\n  return auth.type === 'basic'\n    ? `Basic ${toBase64Utf8(`${auth.username}:${auth.password}`)}`\n    : `Bearer ${auth.token}`;\n}\n\nconst sleep = (ms: number): Promise<void> => new Promise((resolve) => setTimeout(resolve, ms));\n\nexport interface UseXAPIResult {\n  /**\n   * Sends a statement to the configured LRS. **Never rejects** — xAPI is\n   * fire-and-forget telemetry that must not break the learner's activity\n   * flow. Network errors and 5xx responses are retried (backoff 1s/2s/4s,\n   * up to 3 retries); a 4xx fails immediately. Any final failure is delivered\n   * to `config.onError`.\n   */\n  sendStatement: (statement: XAPIStatement) => Promise<void>;\n}\n\n/**\n * Delivers xAPI statements to a Learning Record Store, fire-and-forget.\n *\n * Telemetry must never break the learner's attempt, so\n * {@link UseXAPIResult.sendStatement} **never rejects**: network errors and 5xx\n * responses are retried (backoff 1s / 2s / 4s, up to 3 retries), a 4xx fails\n * immediately, and any final failure is reported to `config.onError` instead of\n * throwing. See `XAPIConfig` in `@intellectif/lk-core` for the options.\n *\n * The hook is also where learner identity is applied. Activity components\n * cannot know who the learner is, so they emit an anonymous placeholder actor\n * and a `urn:learning-kit:activity:*` object id; this hook substitutes\n * `config.actor` and `config.activityId` on the way out — and only while those\n * placeholders are still in place, so a statement you rewrote yourself is left\n * alone.\n *\n * `sendStatement` keeps a stable identity across renders even when `config` is\n * an inline object, so it is safe in a dependency array.\n *\n * ```tsx\n * const { sendStatement } = useXAPI({\n *   endpoint: 'https://your-lrs.example/xapi/statements',\n *   auth: { type: 'bearer', token: 'YOUR_TOKEN' },\n *   activityId: 'https://your-app.example/quiz/capital-jp',\n *   actor: { objectType: 'Agent', mbox: 'mailto:learner@example.com' },\n *   onError: (e) => console.error('xAPI send failed', e),\n * });\n *\n * <MultipleChoice data={quiz} onComplete={(r) => void sendStatement(r.xapiStatement)} />\n * ```\n */\nexport function useXAPI(config: XAPIConfig): UseXAPIResult {\n  // Keep the latest config without changing `sendStatement`'s identity when\n  // callers pass an inline config object.\n  const configRef = useRef(config);\n  configRef.current = config;\n\n  const sendStatement = useCallback(async (rawStatement: XAPIStatement): Promise<void> => {\n    const cfg = configRef.current;\n    const statement = applyIdentity(rawStatement, cfg);\n    const maxAttempts = 1 + BACKOFF_MS.length;\n\n    for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {\n      let statusCode: number | undefined;\n      let message = 'Request failed';\n\n      try {\n        const response = await fetch(cfg.endpoint, {\n          method: 'POST',\n          headers: {\n            'Content-Type': 'application/json',\n            'X-Experience-API-Version': '1.0.3',\n            Authorization: authHeader(cfg.auth),\n          },\n          body: JSON.stringify(statement),\n        });\n\n        if (response.ok) {\n          return;\n        }\n\n        statusCode = response.status;\n        message = `LRS responded with ${response.status}`;\n\n        // Only network errors and 5xx are retryable (Req 10.4). A 4xx is a\n        // client error — fail immediately rather than waste retries.\n        if (response.status < 500) {\n          cfg.onError?.({ statement, attempt, statusCode, message });\n          return;\n        }\n      } catch (error) {\n        message = error instanceof Error ? error.message : 'Network error';\n      }\n\n      if (attempt === maxAttempts) {\n        cfg.onError?.({\n          statement,\n          attempt,\n          ...(statusCode !== undefined ? { statusCode } : {}),\n          message,\n        });\n        return;\n      }\n\n      await sleep(BACKOFF_MS[attempt - 1]);\n    }\n  }, []);\n\n  return { sendStatement };\n}\n"]}

package/dist/chunk-UQ3BBEIT.js

@@ -1,3 +1,4 @@
+'use client';
 import { ActivityMedia } from './chunk-GB5URWM4.js';
 import { useId, useMemo } from 'react';
 import { jsxs, jsx } from 'react/jsx-runtime';

package/dist/{chunk-HD2AIQRD.cjs → chunk-XOR4MPEN.cjs}

@@ -1,10 +1,11 @@
+'use client';
 'use strict';
 
 var react = require('react');
 
 // src/hooks/useActivityState.ts
-function useActivityState() {
-  const [state, setState] = react.useState("idle");
+function useActivityState(initialState = "idle") {
+  const [state, setState] = react.useState(initialState);
   const startTimeRef = react.useRef(null);
   const start = react.useCallback(() => {
     if (startTimeRef.current === null) {
@@ -14,9 +15,9 @@ function useActivityState() {
   }, []);
   const complete = react.useCallback(() => setState("completed"), []);
   const review = react.useCallback(() => setState("reviewing"), []);
-  const reset = react.useCallback(() => {
+  const reset = react.useCallback((to = "idle") => {
     startTimeRef.current = null;
-    setState("idle");
+    setState(to);
   }, []);
   const getTimeSpent = react.useCallback(
     () => startTimeRef.current === null ? 0 : Date.now() - startTimeRef.current,
@@ -26,5 +27,5 @@ function useActivityState() {
 }
 
 exports.useActivityState = useActivityState;
-//# sourceMappingURL=chunk-HD2AIQRD.cjs.map
-//# sourceMappingURL=chunk-HD2AIQRD.cjs.map
+//# sourceMappingURL=chunk-XOR4MPEN.cjs.map
+//# sourceMappingURL=chunk-XOR4MPEN.cjs.map

package/dist/chunk-XOR4MPEN.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hooks/useActivityState.ts"],"names":["useState","useRef","useCallback"],"mappings":";;;;;AAgCO,SAAS,gBAAA,CAAiB,eAA8B,MAAA,EAAgC;AAM7F,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAIA,eAAwB,YAAY,CAAA;AAC9D,EAAA,MAAM,YAAA,GAAeC,aAAsB,IAAI,CAAA;AAE/C,EAAA,MAAM,KAAA,GAAQC,kBAAY,MAAM;AAG9B,IAAA,IAAI,YAAA,CAAa,YAAY,IAAA,EAAM;AACjC,MAAA,YAAA,CAAa,OAAA,GAAU,KAAK,GAAA,EAAI;AAAA,IAClC;AACA,IAAA,QAAA,CAAS,CAAC,IAAA,KAAU,IAAA,KAAS,MAAA,GAAS,gBAAgB,IAAK,CAAA;AAAA,EAC7D,CAAA,EAAG,EAAE,CAAA;AAEL,EAAA,MAAM,WAAWA,iBAAA,CAAY,MAAM,SAAS,WAAW,CAAA,EAAG,EAAE,CAAA;AAE5D,EAAA,MAAM,SAASA,iBAAA,CAAY,MAAM,SAAS,WAAW,CAAA,EAAG,EAAE,CAAA;AAE1D,EAAA,MAAM,KAAA,GAAQA,iBAAA,CAAY,CAAC,EAAA,GAAoB,MAAA,KAAW;AACxD,IAAA,YAAA,CAAa,OAAA,GAAU,IAAA;AACvB,IAAA,QAAA,CAAS,EAAE,CAAA;AAAA,EACb,CAAA,EAAG,EAAE,CAAA;AAEL,EAAA,MAAM,YAAA,GAAeA,iBAAA;AAAA,IACnB,MAAO,aAAa,OAAA,KAAY,IAAA,GAAO,IAAI,IAAA,CAAK,GAAA,KAAQ,YAAA,CAAa,OAAA;AAAA,IACrE;AAAC,GACH;AAEA,EAAA,OAAO,EAAE,KAAA,EAAO,KAAA,EAAO,QAAA,EAAU,MAAA,EAAQ,OAAO,YAAA,EAAa;AAC/D","file":"chunk-XOR4MPEN.cjs","sourcesContent":["'use client';\n\nimport { useCallback, useRef, useState } from 'react';\n\nexport type ActivityState = 'idle' | 'in-progress' | 'completed' | 'reviewing';\n\nexport interface UseActivityStateResult {\n  state: ActivityState;\n  /** idle → in-progress; records start time once. Idempotent: repeated calls\n   *  (e.g. every learner interaction) neither restart timing nor regress state. */\n  start: () => void;\n  /** → completed. */\n  complete: () => void;\n  /** → reviewing (e.g. when showing correct answers). */\n  review: () => void;\n  /**\n   * Clears timing and returns to `to`, defaulting to `idle`. Call when the\n   * activity `data` prop changes.\n   *\n   * The target is a parameter because \"reset\" for a RESTORED item does not\n   * mean idle: an item the learner had already submitted must come back\n   * submitted, or a data-prop change quietly unlocks committed work.\n   */\n  reset: (to?: ActivityState) => void;\n  /** Elapsed ms since `start()`; 0 when not started (or after `reset()`). */\n  getTimeSpent: () => number;\n}\n\n/**\n * Tracks an activity's lifecycle state and elapsed time. Timing is held in a\n * ref (no re-render) and `getTimeSpent()` is read imperatively at submission.\n */\nexport function useActivityState(initialState: ActivityState = 'idle'): UseActivityStateResult {\n  // `initialState` seeds the MOUNT only, like any `default*` value. It exists\n  // so a resumed attempt can reopen a question the learner had already\n  // submitted as submitted — without it, an exam that locks each question on\n  // submit silently unlocks every one of them after a crash, and the learner\n  // can answer and submit the same question twice.\n  const [state, setState] = useState<ActivityState>(initialState);\n  const startTimeRef = useRef<number | null>(null);\n\n  const start = useCallback(() => {\n    // Ref guard makes timing idempotent without a side effect in the updater\n    // (StrictMode double-invokes updaters); the updater itself stays pure.\n    if (startTimeRef.current === null) {\n      startTimeRef.current = Date.now();\n    }\n    setState((prev) => (prev === 'idle' ? 'in-progress' : prev));\n  }, []);\n\n  const complete = useCallback(() => setState('completed'), []);\n\n  const review = useCallback(() => setState('reviewing'), []);\n\n  const reset = useCallback((to: ActivityState = 'idle') => {\n    startTimeRef.current = null;\n    setState(to);\n  }, []);\n\n  const getTimeSpent = useCallback(\n    () => (startTimeRef.current === null ? 0 : Date.now() - startTimeRef.current),\n    [],\n  );\n\n  return { state, start, complete, review, reset, getTimeSpent };\n}\n"]}

package/dist/{chunk-5SYL5CJ2.js → chunk-ZLUMUJUQ.js}

@@ -1,6 +1,7 @@
+'use client';
 import { ActivityErrorBoundary, isDevelopment, randomSessionId, FeedbackRegion, ANONYMOUS_ACTOR, objectIdFor } from './chunk-6F4X2NKL.js';
 import { ActivityMedia } from './chunk-GB5URWM4.js';
-import { useActivityState } from './chunk-5HVUKXF3.js';
+import { useActivityState } from './chunk-6N43WDVG.js';
 import { validateActivity, ActivitySchemaError, seededShuffle, score, xAPIBuilder, xapiDefinitionFor } from '@intellectif/lk-core';
 import { useMemo, useRef, useState, useEffect } from 'react';
 import { jsx, jsxs } from 'react/jsx-runtime';
@@ -39,6 +40,7 @@ function MultipleChoice({
   onSubmit,
   value,
   defaultValue,
+  defaultSubmitted,
   onChange,
   renderMode = "practice",
   outcome,
@@ -60,20 +62,30 @@ function MultipleChoice({
     return result.success ? null : new ActivitySchemaError("multiple-choice", result.errors);
   }, [data]);
   const sessionIdRef = useRef(null);
-  const { state, start, complete, getTimeSpent, reset } = useActivityState();
+  const { state, start, complete, getTimeSpent, reset } = useActivityState(
+    defaultSubmitted === true ? "completed" : "idle"
+  );
   const [internalSelection, setInternalSelection] = useState(
     () => selectionOf(defaultValue)
   );
   const [summary, setSummary] = useState(null);
+  const defaultValueRef = useRef(defaultValue);
+  useEffect(() => {
+    defaultValueRef.current = defaultValue;
+  }, [defaultValue]);
+  const defaultSubmittedRef = useRef(defaultSubmitted);
+  useEffect(() => {
+    defaultSubmittedRef.current = defaultSubmitted;
+  }, [defaultSubmitted]);
   const lastDataRef = useRef(data);
   useEffect(() => {
     if (lastDataRef.current === data) {
       return;
     }
     lastDataRef.current = data;
-    setInternalSelection([]);
+    setInternalSelection(selectionOf(defaultValueRef.current));
     setSummary(null);
-    reset();
+    reset(defaultSubmittedRef.current === true ? "completed" : "idle");
   }, [data, reset]);
   const displayedOptions = useMemo(() => {
     if (!data.shuffle) {
@@ -235,5 +247,5 @@ function MultipleChoice2(props) {
 }
 
 export { MultipleChoice2 as MultipleChoice };
-//# sourceMappingURL=chunk-5SYL5CJ2.js.map
-//# sourceMappingURL=chunk-5SYL5CJ2.js.map
+//# sourceMappingURL=chunk-ZLUMUJUQ.js.map
+//# sourceMappingURL=chunk-ZLUMUJUQ.js.map

package/dist/chunk-ZLUMUJUQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/MultipleChoice/MultipleChoice.tsx","../src/components/MultipleChoice/index.tsx"],"names":["MultipleChoice","jsx"],"mappings":"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","file":"chunk-ZLUMUJUQ.js","sourcesContent":["'use client';\n\nimport {\n  ActivitySchemaError,\n  type ItemOutcome,\n  type LearnerResponse,\n  type MultipleChoiceData,\n  type MultipleChoiceLearnerResponse,\n  type MultipleChoiceOption,\n  type ScoringDetail,\n  score,\n  seededShuffle,\n  validateActivity,\n  xAPIBuilder,\n  xapiDefinitionFor,\n} from '@intellectif/lk-core';\nimport { type CSSProperties, useEffect, useMemo, useRef, useState } from 'react';\nimport { useActivityState } from '../../hooks/useActivityState.js';\nimport { ANONYMOUS_ACTOR, isDevelopment, objectIdFor, randomSessionId } from '../_internal.js';\nimport { ActivityMedia } from '../shared/ActivityMedia.js';\nimport { FeedbackRegion } from '../shared/FeedbackRegion.js';\nimport type { ActivityProps } from '../types.js';\n\n/**\n * Selected option ids carried by a learner response. Any other response shape\n * (a caller wiring the wrong item's state through `value`) reads as \"nothing\n * selected\" rather than throwing mid-exam.\n */\nfunction selectionOf(response: LearnerResponse | undefined): string[] {\n  return response?.type === 'multiple-choice' ? response.selectedOptionIds : [];\n}\n\n/**\n * Whether an option is part of the correct answer, derived from the SERVER's\n * outcome — review mode never holds an answer key of its own.\n * {@link ScoringDetail.outcome} states this unambiguously. For 0.2-era details\n * that carry only the deprecated `correct` flag (which means \"the learner\n * ACTED correctly on this option\", not \"this option is the answer\") the fact\n * is still recoverable, because we know whether the learner selected it:\n * `isCorrect = wasSelected ? correct : !correct`.\n */\nfunction isAnswerOption(detail: ScoringDetail, wasSelected: boolean): boolean {\n  switch (detail.outcome) {\n    case 'correct':\n    case 'incorrect-omission':\n      return true;\n    case 'incorrect':\n    case 'correct-omission':\n      return false;\n    default:\n      return wasSelected ? detail.correct : !detail.correct;\n  }\n}\n\n/** Announcement for `review` mode, built only from the server-supplied outcome. */\nfunction reviewAnnouncement(outcome: ItemOutcome | undefined): string | null {\n  if (outcome === undefined) {\n    return null;\n  }\n  if (outcome.status === 'scored') {\n    const overall = outcome.feedback;\n    return `Score ${Math.round(outcome.score * 100)}%. ${\n      outcome.passed ? 'Passed.' : 'Not passed.'\n    }${overall ? ` ${overall}` : ''}`;\n  }\n  if (outcome.status === 'deferred') {\n    // Never \"0%\": ungraded is not the same as wrong.\n    return 'Not graded yet.';\n  }\n  return null;\n}\n\nexport interface MultipleChoiceProps extends ActivityProps<MultipleChoiceData> {\n  /**\n   * Seed for the deterministic option shuffle. Supply one (e.g. the attempt\n   * id) to make the shuffled order reproducible server-side, stable across\n   * page reloads, and identical between SSR and hydration. When absent, a\n   * random per-mount session seed is used (order stable within the mount\n   * only — the behaviour before `shuffleSeed` existed).\n   */\n  shuffleSeed?: string;\n}\n\nexport function MultipleChoice({\n  data,\n  onComplete,\n  onSubmit,\n  value,\n  defaultValue,\n  defaultSubmitted,\n  onChange,\n  renderMode = 'practice',\n  outcome,\n  sanitizeHtml,\n  onInteraction,\n  theme,\n  locale,\n  disabled,\n  shuffleSeed,\n}: MultipleChoiceProps) {\n  // Dev-only boundary validation (Req 2.3). Throwing during render lets\n  // ActivityErrorBoundary catch it. Memoised so it only re-runs on data change.\n  const devError = useMemo(() => {\n    if (!isDevelopment()) {\n      return null;\n    }\n    // A `redact()` projection cannot satisfy the full content schema — the\n    // answer key is gone by design — and must not be checked against the\n    // strict redacted schema either, since a `reveal: 'after-submit'`\n    // projection legitimately carries answer-key fields for review renders.\n    if (data.redacted === true) {\n      return null;\n    }\n    const result = validateActivity('multiple-choice', data);\n    return result.success ? null : new ActivitySchemaError('multiple-choice', result.errors);\n  }, [data]);\n\n  // Lazily created only when shuffling without a caller seed: avoids calling\n  // crypto.randomUUID (absent on non-secure http origins) unless needed.\n  const sessionIdRef = useRef<string | null>(null);\n  const { state, start, complete, getTimeSpent, reset } = useActivityState(\n    defaultSubmitted === true ? 'completed' : 'idle',\n  );\n  // Uncontrolled state. `defaultValue` seeds the mount only (React convention);\n  // to re-seed later, remount with a `key` or drive the component with `value`.\n  const [internalSelection, setInternalSelection] = useState<string[]>(() =>\n    selectionOf(defaultValue),\n  );\n  const [summary, setSummary] = useState<string | null>(null);\n\n  // Reset on data-prop CHANGE (Req 3.7). The identity guard makes the mount\n  // run a no-op, which it always was before `defaultValue` existed — without\n  // it this effect would wipe the seed immediately after the first render.\n  // (It also makes the reset StrictMode-safe: a remount with unchanged data\n  // no longer discards the learner's selection.)\n  // Resets back to `defaultValue`, not to empty. Clearing looked safer — it\n  // cannot carry a stale answer into a different question — but `data`\n  // identity is a poor proxy for \"different question\": a parent that builds\n  // entries in render (`activities={raw.map(redact)}`, the documented exam\n  // pattern) hands over a new object every render, and clearing wiped every\n  // RESTORED answer on the first unrelated re-render, silently. `defaultValue`\n  // is by definition the caller's seed for the CURRENT data, which is what\n  // FillInTheBlanks already reset to; the two now agree.\n  const defaultValueRef = useRef(defaultValue);\n  useEffect(() => {\n    defaultValueRef.current = defaultValue;\n  }, [defaultValue]);\n  // A data change must return the item to its SEED, submitted state included —\n  // resetting to idle unlocked work the learner had already committed.\n  const defaultSubmittedRef = useRef(defaultSubmitted);\n  useEffect(() => {\n    defaultSubmittedRef.current = defaultSubmitted;\n  }, [defaultSubmitted]);\n  const lastDataRef = useRef(data);\n  useEffect(() => {\n    if (lastDataRef.current === data) {\n      return;\n    }\n    lastDataRef.current = data;\n    setInternalSelection(selectionOf(defaultValueRef.current));\n    setSummary(null);\n    reset(defaultSubmittedRef.current === true ? 'completed' : 'idle');\n  }, [data, reset]);\n\n  const displayedOptions = useMemo<MultipleChoiceOption[]>(() => {\n    if (!data.shuffle) {\n      return [...data.options];\n    }\n    // biome-ignore lint/suspicious/noAssignInExpressions: sanctioned lazy ref initialization\n    const seedSource = shuffleSeed ?? (sessionIdRef.current ??= randomSessionId());\n    // The seed string is unchanged from when the algorithm lived in this file,\n    // so an order a consumer recorded against a seed still reproduces.\n    return seededShuffle(data.options, `${seedSource}:${data.id}`);\n  }, [data, shuffleSeed]);\n\n  // Per-option correctness for `review`, indexed by option id. Null unless the\n  // caller supplied a SCORED outcome — the only source of truth this mode has.\n  const reviewDetails = useMemo(() => {\n    if (renderMode !== 'review' || outcome === undefined || outcome.status !== 'scored') {\n      return null;\n    }\n    return new Map(outcome.details.map((detail) => [detail.itemId, detail]));\n  }, [renderMode, outcome]);\n\n  // All hooks are called before these throws, so hook order stays stable.\n  if (devError) {\n    throw devError;\n  }\n  // Practice grades locally, which a redacted projection cannot support:\n  // `score()` would throw from the submit handler — where no error boundary\n  // can catch it — AFTER the learner has answered. Fail loudly at render\n  // instead, in production too. Wiring an exam item into the self-grading\n  // mode is precisely the accident `renderMode` exists to prevent.\n  if (data.redacted === true && renderMode === 'practice') {\n    throw new Error(\n      `Multiple Choice \"${data.id}\" received redacted activity data in renderMode \"practice\", ` +\n        'which grades locally and has no answer key to grade against. ' +\n        'Render redacted data with renderMode=\"exam\" (server grades) or \"review\" (pass `outcome`).',\n    );\n  }\n\n  const isSingle = data.mode === 'single';\n  const isExam = renderMode === 'exam';\n  const isReview = renderMode === 'review';\n  const submitted = state === 'completed';\n  const inactive = disabled === true || submitted || isReview;\n  const isControlled = value !== undefined;\n  const selected = isControlled ? selectionOf(value) : internalSelection;\n  /**\n   * Whether correctness and authored feedback may be shown. Practice earns it\n   * by grading locally after submit; review shows what the server already\n   * graded. Exam never reveals anything — not before, not after submit.\n   */\n  const reveal = isReview || (renderMode === 'practice' && submitted);\n\n  const fireInteraction = (\n    type: 'option-selected' | 'option-deselected' | 'submitted',\n    payload: Record<string, unknown>,\n  ): void => {\n    onInteraction?.({ type, activityId: data.id, timestamp: Date.now(), payload });\n  };\n\n  /** Single funnel for every response change: owns state only when uncontrolled. */\n  const emitChange = (selectedOptionIds: string[]): void => {\n    if (!isControlled) {\n      setInternalSelection(selectedOptionIds);\n    }\n    onChange?.({ type: 'multiple-choice', selectedOptionIds });\n  };\n\n  const selectSingle = (optionId: string): void => {\n    if (inactive) {\n      return;\n    }\n    if (state === 'idle') {\n      start();\n    }\n    emitChange([optionId]);\n    fireInteraction('option-selected', { optionId });\n  };\n\n  const toggleMulti = (optionId: string, checked: boolean): void => {\n    if (inactive) {\n      return;\n    }\n    if (state === 'idle') {\n      start();\n    }\n    emitChange(checked ? [...selected, optionId] : selected.filter((id) => id !== optionId));\n    fireInteraction(checked ? 'option-selected' : 'option-deselected', { optionId });\n  };\n\n  const handleSubmit = (event: React.FormEvent): void => {\n    event.preventDefault();\n    if (inactive) {\n      return;\n    }\n    const response: MultipleChoiceLearnerResponse = {\n      type: 'multiple-choice',\n      selectedOptionIds: selected,\n    };\n    // Always first, and before anything that can throw: an exam runner must be\n    // able to persist the raw response no matter what happens after.\n    onSubmit?.(response);\n\n    if (isExam) {\n      // No score(), no answer key read, no onComplete, no xAPI — the server\n      // grades. The announcement deliberately carries no correctness signal.\n      complete();\n      setSummary('Answer submitted.');\n      fireInteraction('submitted', { selectedOptionIds: selected });\n      return;\n    }\n\n    const scoringResult = score('multiple-choice', data as MultipleChoiceData, response);\n    complete();\n    const timeSpent = getTimeSpent();\n    const xapiStatement = xAPIBuilder.buildAnsweredStatement({\n      actor: ANONYMOUS_ACTOR,\n      object: {\n        id: objectIdFor(data.id),\n        name: { [data.locale ?? 'en-US']: data.title },\n        // Activity-type IRI, interaction type and correct-responses pattern\n        // come from the REGISTERED descriptor, so a consumer-registered type\n        // gets correct interop without touching this component.\n        ...xapiDefinitionFor(data),\n        choices: data.options.map((option) => ({\n          id: option.id,\n          description: { [data.locale ?? 'en-US']: option.text },\n        })),\n      },\n      scoringResult,\n      timeSpentMs: timeSpent,\n      response: selected.join(','),\n    });\n    onComplete?.({\n      score: scoringResult.score,\n      maxScore: scoringResult.maxScore,\n      passed: scoringResult.passed,\n      timeSpent,\n      xapiStatement,\n    });\n    // Core selects the authored overall feedback on `passed` (B3 fix).\n    const overall = scoringResult.feedback;\n    setSummary(\n      `Answer submitted. Score ${Math.round(scoringResult.score * 100)}%. ${\n        scoringResult.passed ? 'Passed.' : 'Not passed.'\n      }${overall ? ` ${overall}` : ''}`,\n    );\n    fireInteraction('submitted', {\n      selectedOptionIds: selected,\n      score: scoringResult.score,\n    });\n  };\n\n  const questionId = `${data.id}-question`;\n  // Rich text renders ONLY through a caller-supplied sanitiser; without one we\n  // fall back to the plain-text field, escaped by React (types.ts HtmlSanitizer).\n  const questionHtml =\n    sanitizeHtml !== undefined && data.questionHtml !== undefined\n      ? sanitizeHtml(data.questionHtml)\n      : null;\n\n  const optionList = displayedOptions.map((option) => {\n    const checked = selected.includes(option.id);\n    // `data-correct` means \"this option is part of the correct answer\".\n    let correctness: string | undefined;\n    if (isReview) {\n      const detail = reviewDetails?.get(option.id);\n      correctness = detail === undefined ? undefined : String(isAnswerOption(detail, checked));\n    } else if (reveal) {\n      correctness = String(option.isCorrect);\n    }\n    return (\n      <label key={option.id} className=\"lk-mc-option\" data-correct={correctness}>\n        <input\n          type={isSingle ? 'radio' : 'checkbox'}\n          name={isSingle ? `${data.id}-options` : undefined}\n          value={option.id}\n          checked={checked}\n          disabled={inactive}\n          aria-disabled={inactive || undefined}\n          onChange={(e) =>\n            isSingle ? selectSingle(option.id) : toggleMulti(option.id, e.target.checked)\n          }\n        />\n        <span>{option.text}</span>\n        {reveal && option.feedback ? (\n          <span className=\"lk-mc-option-feedback\" role=\"note\">\n            {option.feedback}\n          </span>\n        ) : null}\n      </label>\n    );\n  });\n\n  return (\n    <div className=\"lk-mc\" lang={locale} style={theme as CSSProperties | undefined}>\n      {data.media ? <ActivityMedia media={data.media} /> : null}\n      <form onSubmit={handleSubmit}>\n        <fieldset disabled={inactive}>\n          {questionHtml === null ? (\n            <legend id={questionId}>{data.question}</legend>\n          ) : (\n            <legend\n              id={questionId}\n              // biome-ignore lint/security/noDangerouslySetInnerHtml: HTML is the output of the caller-supplied sanitizeHtml (types.ts HtmlSanitizer contract)\n              dangerouslySetInnerHTML={{ __html: questionHtml }}\n            />\n          )}\n          {/*\n            single: an explicit radiogroup is meaningful (fieldset's implicit\n            role is `group`, not `radiogroup`). multi: the fieldset + legend\n            already provide a named group — an explicit role=\"group\" here would\n            be a redundant, duplicate same-named group in the a11y tree, so we\n            use a plain layout div. (Refines the design ARIA sketch.)\n          */}\n          {isSingle ? (\n            <div role=\"radiogroup\" aria-labelledby={questionId}>\n              {optionList}\n            </div>\n          ) : (\n            <div>{optionList}</div>\n          )}\n          {/* review is read-only: there is nothing left to submit. */}\n          {isReview ? null : (\n            <button type=\"submit\" disabled={inactive}>\n              Submit\n            </button>\n          )}\n        </fieldset>\n      </form>\n      <FeedbackRegion id={`${data.id}-feedback`}>\n        {isReview ? reviewAnnouncement(outcome) : summary}\n      </FeedbackRegion>\n    </div>\n  );\n}\n","'use client';\n\nimport { ActivityErrorBoundary } from '../ActivityErrorBoundary.js';\nimport {\n  MultipleChoice as MultipleChoiceCore,\n  type MultipleChoiceProps,\n} from './MultipleChoice.js';\n\nexport type { MultipleChoiceProps } from './MultipleChoice.js';\n\n/**\n * Public Multiple Choice activity: the core component wrapped in\n * `ActivityErrorBoundary` so a render failure (incl. the dev schema-validation\n * throw) degrades to an accessible fallback instead of crashing the host.\n */\nexport function MultipleChoice(props: MultipleChoiceProps) {\n  return (\n    <ActivityErrorBoundary activityTitle={props.data?.title}>\n      <MultipleChoiceCore {...props} />\n    </ActivityErrorBoundary>\n  );\n}\n"]}

package/dist/components/ActivitySequence.cjs

@@ -1,19 +1,20 @@
+'use client';
 'use strict';
 
-var chunk3B4ACY4K_cjs = require('../chunk-3B4ACY4K.cjs');
-require('../chunk-WCVD5LVG.cjs');
-require('../chunk-67RIIDZX.cjs');
-require('../chunk-6COTYW77.cjs');
+var chunkDUIWK272_cjs = require('../chunk-DUIWK272.cjs');
+require('../chunk-BE7R2X3S.cjs');
+require('../chunk-NPY2F7F6.cjs');
+require('../chunk-MDYKYDRN.cjs');
 require('../chunk-PGEG7UZJ.cjs');
 require('../chunk-NEWGUDA5.cjs');
 require('../chunk-4HZ7LQIH.cjs');
-require('../chunk-HD2AIQRD.cjs');
+require('../chunk-XOR4MPEN.cjs');
 
 
 
 Object.defineProperty(exports, "ActivitySequence", {
   enumerable: true,
-  get: function () { return chunk3B4ACY4K_cjs.ActivitySequence; }
+  get: function () { return chunkDUIWK272_cjs.ActivitySequence; }
 });
 //# sourceMappingURL=ActivitySequence.cjs.map
 //# sourceMappingURL=ActivitySequence.cjs.map

package/dist/components/ActivitySequence.d.cts

@@ -1,7 +1,7 @@
-import { SequenceEntry, ActivityResult, LearnerResponse, InteractionEvent, ThemeTokens } from '@intellectif/lk-core';
+import { SequenceEntry, ActivityResult, LearnerResponse, InteractionEvent, ItemOutcome, ThemeTokens } from '@intellectif/lk-core';
 import { ComponentType } from 'react';
-import { A as ActivityProps, b as RenderableActivity, R as RenderMode, H as HtmlSanitizer } from '../types-CrURyd9-.cjs';
-import { a as WrittenResponseSubmission } from '../WrittenResponse-DqQ0NjPK.cjs';
+import { A as ActivityProps, b as RenderableActivity, R as RenderMode, H as HtmlSanitizer } from '../types-9iS1Vs2I.cjs';
+import { a as WrittenResponseSubmission } from '../WrittenResponse-BXHidIaK.cjs';
 
 /**
  * What one finished slot in a sequence produced. Two kinds, because two kinds
@@ -24,6 +24,17 @@ type SequenceItemOutcome = {
     activityId: string;
     /** Ungraded submission; the grade arrives asynchronously. */
     submission: WrittenResponseSubmission;
+} | {
+    kind: 'restored';
+    index: number;
+    slotId: string;
+    activityId: string;
+    /**
+     * The answer as restored, when one was. A slot can be submitted with no
+     * stored response (a blank the learner committed), so this is optional —
+     * inventing one would be worse than admitting it is absent.
+     */
+    response?: LearnerResponse;
 } | {
     kind: 'responded';
     index: number;
@@ -118,16 +129,59 @@ interface ActivitySequenceProps {
      * server's `flattenSequence(entries, { seed })` derives the same order this
      * pager shows.
      *
-     * **Required in `exam` and `review` mode** — omitting it throws. An order
-     * nobody can reproduce cannot be reconciled with a recorded attempt, and
-     * failing at render is the only way that mistake surfaces before a learner
-     * sits the paper. In `practice` mode it stays optional: a random per-mount
-     * seed is used, which is stable within the mount and deliberately not
-     * reproducible. That fallback is also not SSR-safe (server and client would
-     * invent different orders and hydration would mismatch), so supply a seed
-     * for any server-rendered sequence regardless of mode.
+     * **Required whenever this sequence shuffles** — `shuffle: 'entries'`, or any
+     * group with `shuffle: 'within-group'` — in `exam` or `review` mode; omitting
+     * it then throws. An order nobody can reproduce cannot be reconciled with a
+     * recorded attempt, and failing at render is the only way that mistake
+     * surfaces before a learner sits the paper. A sequence that does not shuffle
+     * needs no seed in any mode.
+     *
+     * Note the guard does NOT cover an activity's own `data.shuffle`:
+     * `<MultipleChoice>` falls back to a per-mount seed there in every mode, so
+     * pass this whenever any item shuffles its options.
+     *
+     * In `practice` mode it stays optional: a random per-mount seed is used,
+     * stable within the mount and deliberately not reproducible. That fallback is
+     * also not SSR-safe (server and client would invent different orders and
+     * hydration would mismatch), so supply a seed for any server-rendered
+     * sequence regardless of mode.
      */
     shuffleSeed?: string;
+    /**
+     * Where to open. Defaults to the first question; pass a stored
+     * `AttemptState.index` to reopen an interrupted attempt where it was left.
+     * Read at mount only, like any `default*` prop.
+     */
+    defaultIndex?: number;
+    /**
+     * Fires whenever the learner moves. Persist it and the next resume reopens
+     * on the right question — without it, the pager's position is the one piece
+     * of an attempt a consumer cannot recover.
+     */
+    onIndexChange?: (index: number) => void;
+    /**
+     * Answers to restore, keyed by `slotId`, seeded into each slot as its
+     * `defaultValue`. This is the other half of resume: `AttemptState.responses`
+     * goes straight in.
+     *
+     * Read at mount only. To restore a different attempt, remount with a `key`.
+     */
+    responses?: Readonly<Record<string, LearnerResponse>>;
+    /**
+     * Slots the learner had already submitted, from `AttemptState.submittedSlotIds`.
+     * Each is mounted already submitted, so a resumed paper does not reopen a
+     * locked question as answerable — without this a learner can change and
+     * re-submit work they had already committed.
+     *
+     * Read at mount only, alongside `responses`.
+     */
+    submittedSlotIds?: readonly string[];
+    /**
+     * Server-computed outcomes keyed by `slotId`, forwarded to each slot. In
+     * `review` mode this is what marks correctness — the client never scores, so
+     * without it a review render has nothing to show.
+     */
+    outcomes?: Readonly<Record<string, ItemOutcome>>;
     /** Renders author-supplied rich text; forwarded to the stimulus panel and every activity. */
     sanitizeHtml?: HtmlSanitizer;
     theme?: Partial<ThemeTokens>;
@@ -146,6 +200,6 @@ interface ActivitySequenceProps {
  * alongside every question in the group — so a passage stays put, and a
  * recording keeps its position, as the learner moves between its questions.
  */
-declare function ActivitySequence({ activities, renderers, onActivityComplete, onComplete, onFinished, onSubmit, onInteraction, renderMode, shuffle, shuffleSeed, sanitizeHtml, theme, locale, disabled, }: ActivitySequenceProps): React.JSX.Element;
+declare function ActivitySequence({ activities, renderers, onActivityComplete, onComplete, onFinished, onSubmit, onInteraction, renderMode, shuffle, shuffleSeed, defaultIndex, onIndexChange, responses, submittedSlotIds, outcomes, sanitizeHtml, theme, locale, disabled, }: ActivitySequenceProps): React.JSX.Element;
 
 export { type ActivityRenderer, ActivitySequence, type ActivitySequenceProps, type SequenceItemOutcome };

package/dist/components/ActivitySequence.d.ts

@@ -1,7 +1,7 @@
-import { SequenceEntry, ActivityResult, LearnerResponse, InteractionEvent, ThemeTokens } from '@intellectif/lk-core';
+import { SequenceEntry, ActivityResult, LearnerResponse, InteractionEvent, ItemOutcome, ThemeTokens } from '@intellectif/lk-core';
 import { ComponentType } from 'react';
-import { A as ActivityProps, b as RenderableActivity, R as RenderMode, H as HtmlSanitizer } from '../types-CrURyd9-.js';
-import { a as WrittenResponseSubmission } from '../WrittenResponse-Dkg7FUt-.js';
+import { A as ActivityProps, b as RenderableActivity, R as RenderMode, H as HtmlSanitizer } from '../types-9iS1Vs2I.js';
+import { a as WrittenResponseSubmission } from '../WrittenResponse-DJYGuMKk.js';
 
 /**
  * What one finished slot in a sequence produced. Two kinds, because two kinds
@@ -24,6 +24,17 @@ type SequenceItemOutcome = {
     activityId: string;
     /** Ungraded submission; the grade arrives asynchronously. */
     submission: WrittenResponseSubmission;
+} | {
+    kind: 'restored';
+    index: number;
+    slotId: string;
+    activityId: string;
+    /**
+     * The answer as restored, when one was. A slot can be submitted with no
+     * stored response (a blank the learner committed), so this is optional —
+     * inventing one would be worse than admitting it is absent.
+     */
+    response?: LearnerResponse;
 } | {
     kind: 'responded';
     index: number;
@@ -118,16 +129,59 @@ interface ActivitySequenceProps {
      * server's `flattenSequence(entries, { seed })` derives the same order this
      * pager shows.
      *
-     * **Required in `exam` and `review` mode** — omitting it throws. An order
-     * nobody can reproduce cannot be reconciled with a recorded attempt, and
-     * failing at render is the only way that mistake surfaces before a learner
-     * sits the paper. In `practice` mode it stays optional: a random per-mount
-     * seed is used, which is stable within the mount and deliberately not
-     * reproducible. That fallback is also not SSR-safe (server and client would
-     * invent different orders and hydration would mismatch), so supply a seed
-     * for any server-rendered sequence regardless of mode.
+     * **Required whenever this sequence shuffles** — `shuffle: 'entries'`, or any
+     * group with `shuffle: 'within-group'` — in `exam` or `review` mode; omitting
+     * it then throws. An order nobody can reproduce cannot be reconciled with a
+     * recorded attempt, and failing at render is the only way that mistake
+     * surfaces before a learner sits the paper. A sequence that does not shuffle
+     * needs no seed in any mode.
+     *
+     * Note the guard does NOT cover an activity's own `data.shuffle`:
+     * `<MultipleChoice>` falls back to a per-mount seed there in every mode, so
+     * pass this whenever any item shuffles its options.
+     *
+     * In `practice` mode it stays optional: a random per-mount seed is used,
+     * stable within the mount and deliberately not reproducible. That fallback is
+     * also not SSR-safe (server and client would invent different orders and
+     * hydration would mismatch), so supply a seed for any server-rendered
+     * sequence regardless of mode.
      */
     shuffleSeed?: string;
+    /**
+     * Where to open. Defaults to the first question; pass a stored
+     * `AttemptState.index` to reopen an interrupted attempt where it was left.
+     * Read at mount only, like any `default*` prop.
+     */
+    defaultIndex?: number;
+    /**
+     * Fires whenever the learner moves. Persist it and the next resume reopens
+     * on the right question — without it, the pager's position is the one piece
+     * of an attempt a consumer cannot recover.
+     */
+    onIndexChange?: (index: number) => void;
+    /**
+     * Answers to restore, keyed by `slotId`, seeded into each slot as its
+     * `defaultValue`. This is the other half of resume: `AttemptState.responses`
+     * goes straight in.
+     *
+     * Read at mount only. To restore a different attempt, remount with a `key`.
+     */
+    responses?: Readonly<Record<string, LearnerResponse>>;
+    /**
+     * Slots the learner had already submitted, from `AttemptState.submittedSlotIds`.
+     * Each is mounted already submitted, so a resumed paper does not reopen a
+     * locked question as answerable — without this a learner can change and
+     * re-submit work they had already committed.
+     *
+     * Read at mount only, alongside `responses`.
+     */
+    submittedSlotIds?: readonly string[];
+    /**
+     * Server-computed outcomes keyed by `slotId`, forwarded to each slot. In
+     * `review` mode this is what marks correctness — the client never scores, so
+     * without it a review render has nothing to show.
+     */
+    outcomes?: Readonly<Record<string, ItemOutcome>>;
     /** Renders author-supplied rich text; forwarded to the stimulus panel and every activity. */
     sanitizeHtml?: HtmlSanitizer;
     theme?: Partial<ThemeTokens>;
@@ -146,6 +200,6 @@ interface ActivitySequenceProps {
  * alongside every question in the group — so a passage stays put, and a
  * recording keeps its position, as the learner moves between its questions.
  */
-declare function ActivitySequence({ activities, renderers, onActivityComplete, onComplete, onFinished, onSubmit, onInteraction, renderMode, shuffle, shuffleSeed, sanitizeHtml, theme, locale, disabled, }: ActivitySequenceProps): React.JSX.Element;
+declare function ActivitySequence({ activities, renderers, onActivityComplete, onComplete, onFinished, onSubmit, onInteraction, renderMode, shuffle, shuffleSeed, defaultIndex, onIndexChange, responses, submittedSlotIds, outcomes, sanitizeHtml, theme, locale, disabled, }: ActivitySequenceProps): React.JSX.Element;
 
 export { type ActivityRenderer, ActivitySequence, type ActivitySequenceProps, type SequenceItemOutcome };

package/dist/components/ActivitySequence.js

@@ -1,10 +1,11 @@
-export { ActivitySequence } from '../chunk-NBFTCGQ5.js';
-import '../chunk-5SYL5CJ2.js';
-import '../chunk-3DNJDP73.js';
-import '../chunk-67WDTQMG.js';
+'use client';
+export { ActivitySequence } from '../chunk-IUODGQXE.js';
+import '../chunk-ZLUMUJUQ.js';
+import '../chunk-57E3E2H4.js';
+import '../chunk-MDZMKC27.js';
 import '../chunk-6F4X2NKL.js';
 import '../chunk-UQ3BBEIT.js';
 import '../chunk-GB5URWM4.js';
-import '../chunk-5HVUKXF3.js';
+import '../chunk-6N43WDVG.js';
 //# sourceMappingURL=ActivitySequence.js.map
 //# sourceMappingURL=ActivitySequence.js.map