@intellectif/lk-react 1.0.1 → 2.1.0

package/dist/{chunk-O3GWWJFS.cjs → chunk-UXO6KYSZ.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunk6OBRYL4C_cjs = require('./chunk-6OBRYL4C.cjs');
+var chunkQHOV2A6M_cjs = require('./chunk-QHOV2A6M.cjs');
 var chunkHD2AIQRD_cjs = require('./chunk-HD2AIQRD.cjs');
 var lkCore = require('@intellectif/lk-core');
 var react = require('react');
@@ -27,55 +27,106 @@ function parsePassage(passage) {
   }
   return segments;
 }
+var NO_ANSWERS = {};
+function answersOf(response) {
+  return response !== void 0 && response.type === "fill-in-the-blanks" ? response.answers : NO_ANSWERS;
+}
+function correctnessByItem(details) {
+  const map = /* @__PURE__ */ new Map();
+  for (const detail of details) {
+    map.set(
+      detail.itemId,
+      detail.outcome !== void 0 ? detail.outcome === "correct" : detail.correct
+    );
+  }
+  return map;
+}
 function FillInTheBlanks({
   data,
   onComplete,
+  onSubmit,
+  onChange,
   onInteraction,
+  value,
+  defaultValue,
+  renderMode = "practice",
+  outcome,
+  sanitizeHtml,
   theme,
   locale,
   disabled,
   showCorrectAnswers
 }) {
+  const isExam = renderMode === "exam";
+  const isReview = renderMode === "review";
   const devError = react.useMemo(() => {
-    if (!chunk6OBRYL4C_cjs.isDevelopment()) {
+    if (!chunkQHOV2A6M_cjs.isDevelopment()) {
       return null;
     }
+    if (data.redacted === true) {
+      try {
+        lkCore.assertRedacted(data);
+        return null;
+      } catch (error) {
+        return error instanceof Error ? error : new Error(String(error));
+      }
+    }
     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 [answers, setAnswers] = react.useState({});
+  const isControlled = value !== void 0;
+  const [internalAnswers, setInternalAnswers] = react.useState(
+    () => answersOf(defaultValue)
+  );
   const [revealed, setRevealed] = react.useState(() => /* @__PURE__ */ new Set());
   const [result, setResult] = react.useState(null);
   const [summary, setSummary] = react.useState(null);
   const [feedbackHidden, setFeedbackHidden] = react.useState(false);
+  const answers = isControlled ? answersOf(value) : internalAnswers;
+  const defaultValueRef = react.useRef(defaultValue);
   react.useEffect(() => {
-    setAnswers({});
+    defaultValueRef.current = defaultValue;
+  }, [defaultValue]);
+  react.useEffect(() => {
+    setInternalAnswers(answersOf(defaultValueRef.current));
     setRevealed(/* @__PURE__ */ new Set());
     setResult(null);
     setSummary(null);
     setFeedbackHidden(false);
     reset();
   }, [data, reset]);
+  react.useEffect(() => {
+    if (chunkQHOV2A6M_cjs.isDevelopment() && sanitizeHtml !== void 0 && data.passageHtml !== void 0) {
+      console.warn(
+        "[lk-react] FillInTheBlanks ignores `passageHtml`: the passage hosts the answer inputs, so rich HTML cannot be split at {{placeholders}} without voiding the sanitiser. Rendering the plain `passage` instead."
+      );
+    }
+  }, [sanitizeHtml, data.passageHtml]);
   const segments = react.useMemo(() => parsePassage(data.passage), [data.passage]);
   const blankById = react.useMemo(() => new Map(data.blanks.map((b) => [b.id, b])), [data.blanks]);
   if (devError) {
     throw devError;
   }
   const submitted = state === "completed";
-  const inactive = disabled === true || submitted;
+  const inactive = disabled === true || submitted || isReview;
+  const revealing = isReview ? outcome?.status === "scored" : !isExam && submitted;
   const fireInteraction = (type, payload) => {
     onInteraction?.({ type, activityId: data.id, timestamp: Date.now(), payload });
   };
-  const handleChange = (blankId, value) => {
+  const handleChange = (blankId, text) => {
     if (inactive) {
       return;
     }
     if (state === "idle") {
       start();
     }
-    setAnswers((prev) => ({ ...prev, [blankId]: value }));
-    fireInteraction("blank-filled", { blankId, value });
+    const next = { ...answers, [blankId]: text };
+    if (!isControlled) {
+      setInternalAnswers(next);
+    }
+    onChange?.({ type: "fill-in-the-blanks", answers: next });
+    fireInteraction("blank-filled", { blankId, value: text });
   };
   const toggleHint = (blankId) => {
     if (inactive) {
@@ -103,47 +154,74 @@ function FillInTheBlanks({
       return;
     }
     const response = { type: "fill-in-the-blanks", answers };
+    onSubmit?.(response);
+    if (isExam) {
+      complete();
+      setSummary("Answer submitted.");
+      fireInteraction("submitted", { answers });
+      return;
+    }
     const scoringResult = lkCore.score("fill-in-the-blanks", data, response);
     complete();
     const timeSpent = getTimeSpent();
     const xapiStatement = lkCore.xAPIBuilder.buildAnsweredStatement({
-      actor: chunk6OBRYL4C_cjs.ANONYMOUS_ACTOR,
-      object: { id: chunk6OBRYL4C_cjs.objectIdFor(data.id), name: { "en-US": data.title } },
+      actor: chunkQHOV2A6M_cjs.ANONYMOUS_ACTOR,
+      object: {
+        id: chunkQHOV2A6M_cjs.objectIdFor(data.id),
+        name: { [data.locale ?? "en-US"]: data.title },
+        type: "http://adlnet.gov/expapi/activities/cmi.interaction",
+        interactionType: "fill-in",
+        correctResponsesPattern: [
+          data.blanks.map((blank) => blank.acceptedAnswers[0] ?? "").join("[,]")
+        ]
+      },
       scoringResult,
       timeSpentMs: timeSpent,
       response: JSON.stringify(answers)
     });
     setResult(scoringResult);
-    onComplete({
+    onComplete?.({
       score: scoringResult.score,
       maxScore: scoringResult.maxScore,
       passed: scoringResult.passed,
       timeSpent,
       xapiStatement
     });
-    const overall = scoringResult.passed ? data.feedback?.correct : data.feedback?.incorrect;
+    const overall = scoringResult.feedback;
     setSummary(
       `Answer submitted. Score ${Math.round(scoringResult.score * 100)}%. ${scoringResult.passed ? "Passed." : "Not passed."}${overall ? ` ${overall}` : ""}`
     );
     fireInteraction("submitted", { answers, score: scoringResult.score });
   };
   const correctByBlank = react.useMemo(() => {
-    const map = /* @__PURE__ */ new Map();
-    for (const detail of result?.details ?? []) {
-      map.set(detail.itemId, detail.correct);
+    if (isExam) {
+      return /* @__PURE__ */ new Map();
+    }
+    if (isReview) {
+      return outcome?.status === "scored" ? correctnessByItem(outcome.details) : /* @__PURE__ */ new Map();
+    }
+    return correctnessByItem(result?.details ?? []);
+  }, [isExam, isReview, outcome, result]);
+  const reviewSummary = react.useMemo(() => {
+    if (!isReview || outcome === void 0) {
+      return null;
+    }
+    if (outcome.status === "scored") {
+      return `Score ${Math.round(outcome.score * 100)}%. ${outcome.passed ? "Passed." : "Not passed."}${outcome.feedback ? ` ${outcome.feedback}` : ""}`;
     }
-    return map;
-  }, [result]);
+    return outcome.status === "deferred" ? "Not graded yet." : "No grade available.";
+  }, [isReview, outcome]);
   return /* @__PURE__ */ jsxRuntime.jsxs(
     "form",
     {
       className: "lk-fib",
       "aria-label": data.title,
       lang: locale,
+      "data-render-mode": renderMode,
       style: theme,
       onSubmit: handleSubmit,
       children: [
-        data.media ? /* @__PURE__ */ jsxRuntime.jsx(chunk6OBRYL4C_cjs.ActivityMedia, { media: data.media }) : null,
+        data.media ? /* @__PURE__ */ jsxRuntime.jsx(chunkQHOV2A6M_cjs.ActivityMedia, { media: data.media }) : null,
         /* @__PURE__ */ jsxRuntime.jsxs("fieldset", { disabled: inactive, children: [
           /* @__PURE__ */ jsxRuntime.jsx("p", { className: "lk-fib-passage", children: segments.map((seg, i) => {
             if (seg.kind === "text") {
@@ -153,10 +231,13 @@ function FillInTheBlanks({
             if (!blank) {
               return null;
             }
-            const isCorrect = correctByBlank.get(seg.id) === true;
+            const acceptedAnswers = isExam ? void 0 : blank.acceptedAnswers;
+            const blankFeedback = isExam ? void 0 : blank.feedback;
+            const correctness = correctByBlank.get(seg.id);
             const hintId = `${data.id}-hint-${seg.id}`;
-            if (submitted && showCorrectAnswers && !isCorrect) {
-              return /* @__PURE__ */ jsxRuntime.jsx("span", { className: "lk-fib-answer", "data-correct": "false", children: blank.acceptedAnswers[0] }, seg.id);
+            const correctAnswer = acceptedAnswers?.[0];
+            if (revealing && showCorrectAnswers && correctness === false && correctAnswer) {
+              return /* @__PURE__ */ jsxRuntime.jsx("span", { className: "lk-fib-answer", "data-correct": "false", children: correctAnswer }, seg.id);
             }
             return /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "lk-fib-blank", children: [
               /* @__PURE__ */ jsxRuntime.jsx(
@@ -168,7 +249,7 @@ function FillInTheBlanks({
                   value: answers[seg.id] ?? "",
                   disabled: inactive,
                   "aria-disabled": inactive || void 0,
-                  "data-correct": submitted ? String(isCorrect) : void 0,
+                  "data-correct": revealing && correctness !== void 0 ? String(correctness) : void 0,
                   onChange: (e) => handleChange(seg.id, e.target.value)
                 }
               ),
@@ -205,20 +286,20 @@ function FillInTheBlanks({
                 ),
                 /* @__PURE__ */ jsxRuntime.jsx("span", { id: hintId, "aria-live": "polite", children: revealed.has(seg.id) ? blank.hint : "" })
               ] }) : null,
-              submitted && !feedbackHidden && blank.feedback ? /* @__PURE__ */ jsxRuntime.jsx(
+              revealing && !feedbackHidden && blankFeedback ? /* @__PURE__ */ jsxRuntime.jsx(
                 "span",
                 {
                   className: "lk-fib-blank-feedback",
                   role: "note",
-                  "data-correct": String(isCorrect),
-                  children: blank.feedback
+                  "data-correct": correctness !== void 0 ? String(correctness) : void 0,
+                  children: blankFeedback
                 }
               ) : null
             ] }, seg.id);
           }) }),
-          /* @__PURE__ */ jsxRuntime.jsx("button", { type: "submit", disabled: inactive, children: "Check answers" })
+          isReview ? null : /* @__PURE__ */ jsxRuntime.jsx("button", { type: "submit", disabled: inactive, children: isExam ? "Submit answers" : "Check answers" })
         ] }),
-        submitted && data.blanks.some((b) => b.feedback) ? /* @__PURE__ */ jsxRuntime.jsx(
+        revealing && data.blanks.some((b) => b.feedback) ? /* @__PURE__ */ jsxRuntime.jsx(
           "button",
           {
             type: "button",
@@ -228,15 +309,15 @@ function FillInTheBlanks({
             children: feedbackHidden ? "Show feedback" : "Hide feedback"
           }
         ) : null,
-        /* @__PURE__ */ jsxRuntime.jsx(chunk6OBRYL4C_cjs.FeedbackRegion, { id: `${data.id}-feedback`, children: summary })
+        /* @__PURE__ */ jsxRuntime.jsx(chunkQHOV2A6M_cjs.FeedbackRegion, { id: `${data.id}-feedback`, children: isReview ? reviewSummary : summary })
       ]
     }
   );
 }
 function FillInTheBlanks2(props) {
-  return /* @__PURE__ */ jsxRuntime.jsx(chunk6OBRYL4C_cjs.ActivityErrorBoundary, { activityTitle: props.data?.title, children: /* @__PURE__ */ jsxRuntime.jsx(FillInTheBlanks, { ...props }) });
+  return /* @__PURE__ */ jsxRuntime.jsx(chunkQHOV2A6M_cjs.ActivityErrorBoundary, { activityTitle: props.data?.title, children: /* @__PURE__ */ jsxRuntime.jsx(FillInTheBlanks, { ...props }) });
 }
 
 exports.FillInTheBlanks = FillInTheBlanks2;
-//# sourceMappingURL=chunk-O3GWWJFS.cjs.map
-//# sourceMappingURL=chunk-O3GWWJFS.cjs.map
+//# sourceMappingURL=chunk-UXO6KYSZ.cjs.map
+//# sourceMappingURL=chunk-UXO6KYSZ.cjs.map

package/dist/chunk-UXO6KYSZ.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","jsxs","jsx","ActivityMedia","Fragment","FeedbackRegion","FillInTheBlanks","ActivityErrorBoundary"],"mappings":"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","file":"chunk-UXO6KYSZ.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} 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  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  // 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  // `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    setInternalAnswers(answersOf(defaultValueRef.current));\n    setRevealed(new Set());\n    setResult(null);\n    setSummary(null);\n    setFeedbackHidden(false);\n    reset();\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\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        type: 'http://adlnet.gov/expapi/activities/cmi.interaction',\n        interactionType: 'fill-in',\n        correctResponsesPattern: [\n          data.blanks.map((blank) => blank.acceptedAnswers[0] ?? '').join('[,]'),\n        ],\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-W6BH2YMZ.cjs

@@ -0,0 +1,259 @@
+'use strict';
+
+var chunkQHOV2A6M_cjs = require('./chunk-QHOV2A6M.cjs');
+var chunkHD2AIQRD_cjs = require('./chunk-HD2AIQRD.cjs');
+var lkCore = require('@intellectif/lk-core');
+var react = require('react');
+var jsxRuntime = require('react/jsx-runtime');
+
+function hashSeed(input) {
+  let h = 2166136261 >>> 0;
+  for (let i = 0; i < input.length; i += 1) {
+    h ^= input.charCodeAt(i);
+    h = Math.imul(h, 16777619) >>> 0;
+  }
+  return h;
+}
+function seededShuffle(items, seed) {
+  const out = [...items];
+  let s = seed >>> 0 || 1;
+  for (let i = out.length - 1; i > 0; i -= 1) {
+    s = Math.imul(s, 1664525) + 1013904223 >>> 0;
+    const j = s % (i + 1);
+    [out[i], out[j]] = [out[j], out[i]];
+  }
+  return out;
+}
+function selectionOf(response) {
+  return response?.type === "multiple-choice" ? response.selectedOptionIds : [];
+}
+function isAnswerOption(detail, wasSelected) {
+  switch (detail.outcome) {
+    case "correct":
+    case "incorrect-omission":
+      return true;
+    case "incorrect":
+    case "correct-omission":
+      return false;
+    default:
+      return wasSelected ? detail.correct : !detail.correct;
+  }
+}
+function reviewAnnouncement(outcome) {
+  if (outcome === void 0) {
+    return null;
+  }
+  if (outcome.status === "scored") {
+    const overall = outcome.feedback;
+    return `Score ${Math.round(outcome.score * 100)}%. ${outcome.passed ? "Passed." : "Not passed."}${overall ? ` ${overall}` : ""}`;
+  }
+  if (outcome.status === "deferred") {
+    return "Not graded yet.";
+  }
+  return null;
+}
+function MultipleChoice({
+  data,
+  onComplete,
+  onSubmit,
+  value,
+  defaultValue,
+  onChange,
+  renderMode = "practice",
+  outcome,
+  sanitizeHtml,
+  onInteraction,
+  theme,
+  locale,
+  disabled,
+  shuffleSeed
+}) {
+  const devError = react.useMemo(() => {
+    if (!chunkQHOV2A6M_cjs.isDevelopment()) {
+      return null;
+    }
+    if (data.redacted === true) {
+      return null;
+    }
+    const result = lkCore.validateActivity("multiple-choice", data);
+    return result.success ? null : new lkCore.ActivitySchemaError("multiple-choice", result.errors);
+  }, [data]);
+  const sessionIdRef = react.useRef(null);
+  const { state, start, complete, getTimeSpent, reset } = chunkHD2AIQRD_cjs.useActivityState();
+  const [internalSelection, setInternalSelection] = react.useState(
+    () => selectionOf(defaultValue)
+  );
+  const [summary, setSummary] = react.useState(null);
+  const lastDataRef = react.useRef(data);
+  react.useEffect(() => {
+    if (lastDataRef.current === data) {
+      return;
+    }
+    lastDataRef.current = data;
+    setInternalSelection([]);
+    setSummary(null);
+    reset();
+  }, [data, reset]);
+  const displayedOptions = react.useMemo(() => {
+    if (!data.shuffle) {
+      return [...data.options];
+    }
+    const seedSource = shuffleSeed ?? (sessionIdRef.current ??= chunkQHOV2A6M_cjs.randomSessionId());
+    return seededShuffle(data.options, hashSeed(`${seedSource}:${data.id}`));
+  }, [data, shuffleSeed]);
+  const reviewDetails = react.useMemo(() => {
+    if (renderMode !== "review" || outcome === void 0 || outcome.status !== "scored") {
+      return null;
+    }
+    return new Map(outcome.details.map((detail) => [detail.itemId, detail]));
+  }, [renderMode, outcome]);
+  if (devError) {
+    throw devError;
+  }
+  if (data.redacted === true && renderMode === "practice") {
+    throw new Error(
+      `Multiple Choice "${data.id}" received redacted activity data in renderMode "practice", which grades locally and has no answer key to grade against. Render redacted data with renderMode="exam" (server grades) or "review" (pass \`outcome\`).`
+    );
+  }
+  const isSingle = data.mode === "single";
+  const isExam = renderMode === "exam";
+  const isReview = renderMode === "review";
+  const submitted = state === "completed";
+  const inactive = disabled === true || submitted || isReview;
+  const isControlled = value !== void 0;
+  const selected = isControlled ? selectionOf(value) : internalSelection;
+  const reveal = isReview || renderMode === "practice" && submitted;
+  const fireInteraction = (type, payload) => {
+    onInteraction?.({ type, activityId: data.id, timestamp: Date.now(), payload });
+  };
+  const emitChange = (selectedOptionIds) => {
+    if (!isControlled) {
+      setInternalSelection(selectedOptionIds);
+    }
+    onChange?.({ type: "multiple-choice", selectedOptionIds });
+  };
+  const selectSingle = (optionId) => {
+    if (inactive) {
+      return;
+    }
+    if (state === "idle") {
+      start();
+    }
+    emitChange([optionId]);
+    fireInteraction("option-selected", { optionId });
+  };
+  const toggleMulti = (optionId, checked) => {
+    if (inactive) {
+      return;
+    }
+    if (state === "idle") {
+      start();
+    }
+    emitChange(checked ? [...selected, optionId] : selected.filter((id) => id !== optionId));
+    fireInteraction(checked ? "option-selected" : "option-deselected", { optionId });
+  };
+  const handleSubmit = (event) => {
+    event.preventDefault();
+    if (inactive) {
+      return;
+    }
+    const response = {
+      type: "multiple-choice",
+      selectedOptionIds: selected
+    };
+    onSubmit?.(response);
+    if (isExam) {
+      complete();
+      setSummary("Answer submitted.");
+      fireInteraction("submitted", { selectedOptionIds: selected });
+      return;
+    }
+    const scoringResult = lkCore.score("multiple-choice", data, response);
+    complete();
+    const timeSpent = getTimeSpent();
+    const xapiStatement = lkCore.xAPIBuilder.buildAnsweredStatement({
+      actor: chunkQHOV2A6M_cjs.ANONYMOUS_ACTOR,
+      object: {
+        id: chunkQHOV2A6M_cjs.objectIdFor(data.id),
+        name: { [data.locale ?? "en-US"]: data.title },
+        type: "http://adlnet.gov/expapi/activities/cmi.interaction",
+        interactionType: "choice",
+        correctResponsesPattern: [
+          data.options.filter((option) => option.isCorrect).map((option) => option.id).join("[,]")
+        ],
+        choices: data.options.map((option) => ({
+          id: option.id,
+          description: { [data.locale ?? "en-US"]: option.text }
+        }))
+      },
+      scoringResult,
+      timeSpentMs: timeSpent,
+      response: selected.join(",")
+    });
+    onComplete?.({
+      score: scoringResult.score,
+      maxScore: scoringResult.maxScore,
+      passed: scoringResult.passed,
+      timeSpent,
+      xapiStatement
+    });
+    const overall = scoringResult.feedback;
+    setSummary(
+      `Answer submitted. Score ${Math.round(scoringResult.score * 100)}%. ${scoringResult.passed ? "Passed." : "Not passed."}${overall ? ` ${overall}` : ""}`
+    );
+    fireInteraction("submitted", {
+      selectedOptionIds: selected,
+      score: scoringResult.score
+    });
+  };
+  const questionId = `${data.id}-question`;
+  const questionHtml = sanitizeHtml !== void 0 && data.questionHtml !== void 0 ? sanitizeHtml(data.questionHtml) : null;
+  const optionList = displayedOptions.map((option) => {
+    const checked = selected.includes(option.id);
+    let correctness;
+    if (isReview) {
+      const detail = reviewDetails?.get(option.id);
+      correctness = detail === void 0 ? void 0 : String(isAnswerOption(detail, checked));
+    } else if (reveal) {
+      correctness = String(option.isCorrect);
+    }
+    return /* @__PURE__ */ jsxRuntime.jsxs("label", { className: "lk-mc-option", "data-correct": correctness, children: [
+      /* @__PURE__ */ jsxRuntime.jsx(
+        "input",
+        {
+          type: isSingle ? "radio" : "checkbox",
+          name: isSingle ? `${data.id}-options` : void 0,
+          value: option.id,
+          checked,
+          disabled: inactive,
+          "aria-disabled": inactive || void 0,
+          onChange: (e) => isSingle ? selectSingle(option.id) : toggleMulti(option.id, e.target.checked)
+        }
+      ),
+      /* @__PURE__ */ jsxRuntime.jsx("span", { children: option.text }),
+      reveal && option.feedback ? /* @__PURE__ */ jsxRuntime.jsx("span", { className: "lk-mc-option-feedback", role: "note", children: option.feedback }) : null
+    ] }, option.id);
+  });
+  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "lk-mc", lang: locale, style: theme, children: [
+    data.media ? /* @__PURE__ */ jsxRuntime.jsx(chunkQHOV2A6M_cjs.ActivityMedia, { media: data.media }) : null,
+    /* @__PURE__ */ jsxRuntime.jsx("form", { onSubmit: handleSubmit, children: /* @__PURE__ */ jsxRuntime.jsxs("fieldset", { disabled: inactive, children: [
+      questionHtml === null ? /* @__PURE__ */ jsxRuntime.jsx("legend", { id: questionId, children: data.question }) : /* @__PURE__ */ jsxRuntime.jsx(
+        "legend",
+        {
+          id: questionId,
+          dangerouslySetInnerHTML: { __html: questionHtml }
+        }
+      ),
+      isSingle ? /* @__PURE__ */ jsxRuntime.jsx("div", { role: "radiogroup", "aria-labelledby": questionId, children: optionList }) : /* @__PURE__ */ jsxRuntime.jsx("div", { children: optionList }),
+      isReview ? null : /* @__PURE__ */ jsxRuntime.jsx("button", { type: "submit", disabled: inactive, children: "Submit" })
+    ] }) }),
+    /* @__PURE__ */ jsxRuntime.jsx(chunkQHOV2A6M_cjs.FeedbackRegion, { id: `${data.id}-feedback`, children: isReview ? reviewAnnouncement(outcome) : summary })
+  ] });
+}
+function MultipleChoice2(props) {
+  return /* @__PURE__ */ jsxRuntime.jsx(chunkQHOV2A6M_cjs.ActivityErrorBoundary, { activityTitle: props.data?.title, children: /* @__PURE__ */ jsxRuntime.jsx(MultipleChoice, { ...props }) });
+}
+
+exports.MultipleChoice = MultipleChoice2;
+//# sourceMappingURL=chunk-W6BH2YMZ.cjs.map
+//# sourceMappingURL=chunk-W6BH2YMZ.cjs.map