@intellectif/lk-react 2.0.0 → 2.1.0

package/dist/{chunk-MKH5THDR.cjs → chunk-W6BH2YMZ.cjs}

@@ -24,9 +24,44 @@ function seededShuffle(items, seed) {
   }
   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,
@@ -37,15 +72,25 @@ function MultipleChoice({
     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 [selected, setSelected] = react.useState([]);
+  const [internalSelection, setInternalSelection] = react.useState(
+    () => selectionOf(defaultValue)
+  );
   const [summary, setSummary] = react.useState(null);
+  const lastDataRef = react.useRef(data);
   react.useEffect(() => {
-    setSelected([]);
+    if (lastDataRef.current === data) {
+      return;
+    }
+    lastDataRef.current = data;
+    setInternalSelection([]);
     setSummary(null);
     reset();
   }, [data, reset]);
@@ -56,15 +101,37 @@ function MultipleChoice({
     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;
+  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;
@@ -72,7 +139,7 @@ function MultipleChoice({
     if (state === "idle") {
       start();
     }
-    setSelected([optionId]);
+    emitChange([optionId]);
     fireInteraction("option-selected", { optionId });
   };
   const toggleMulti = (optionId, checked) => {
@@ -82,7 +149,7 @@ function MultipleChoice({
     if (state === "idle") {
       start();
     }
-    setSelected((prev) => checked ? [...prev, optionId] : prev.filter((id) => id !== optionId));
+    emitChange(checked ? [...selected, optionId] : selected.filter((id) => id !== optionId));
     fireInteraction(checked ? "option-selected" : "option-deselected", { optionId });
   };
   const handleSubmit = (event) => {
@@ -90,7 +157,17 @@ function MultipleChoice({
     if (inactive) {
       return;
     }
-    const response = { type: "multiple-choice", selectedOptionIds: selected };
+    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();
@@ -113,7 +190,7 @@ function MultipleChoice({
       timeSpentMs: timeSpent,
       response: selected.join(",")
     });
-    onComplete({
+    onComplete?.({
       score: scoringResult.score,
       maxScore: scoringResult.maxScore,
       passed: scoringResult.passed,
@@ -130,41 +207,47 @@ function MultipleChoice({
     });
   };
   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);
-    return /* @__PURE__ */ jsxRuntime.jsxs(
-      "label",
-      {
-        className: "lk-mc-option",
-        "data-correct": submitted ? String(option.isCorrect) : void 0,
-        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 }),
-          submitted && option.feedback ? /* @__PURE__ */ jsxRuntime.jsx("span", { className: "lk-mc-option-feedback", role: "note", children: option.feedback }) : null
-        ]
-      },
-      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: [
-      /* @__PURE__ */ jsxRuntime.jsx("legend", { id: questionId, children: data.question }),
+      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 }),
-      /* @__PURE__ */ jsxRuntime.jsx("button", { type: "submit", disabled: inactive, children: "Submit" })
+      isReview ? null : /* @__PURE__ */ jsxRuntime.jsx("button", { type: "submit", disabled: inactive, children: "Submit" })
     ] }) }),
-    /* @__PURE__ */ jsxRuntime.jsx(chunkQHOV2A6M_cjs.FeedbackRegion, { id: `${data.id}-feedback`, children: summary })
+    /* @__PURE__ */ jsxRuntime.jsx(chunkQHOV2A6M_cjs.FeedbackRegion, { id: `${data.id}-feedback`, children: isReview ? reviewAnnouncement(outcome) : summary })
   ] });
 }
 function MultipleChoice2(props) {
@@ -172,5 +255,5 @@ function MultipleChoice2(props) {
 }
 
 exports.MultipleChoice = MultipleChoice2;
-//# sourceMappingURL=chunk-MKH5THDR.cjs.map
-//# sourceMappingURL=chunk-MKH5THDR.cjs.map
+//# sourceMappingURL=chunk-W6BH2YMZ.cjs.map
+//# sourceMappingURL=chunk-W6BH2YMZ.cjs.map

package/dist/chunk-W6BH2YMZ.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/MultipleChoice/MultipleChoice.tsx","../src/components/MultipleChoice/index.tsx"],"names":["useMemo","isDevelopment","validateActivity","ActivitySchemaError","useRef","useActivityState","useState","useEffect","randomSessionId","score","xAPIBuilder","ANONYMOUS_ACTOR","objectIdFor","jsxs","jsx","ActivityMedia","FeedbackRegion","MultipleChoice","ActivityErrorBoundary"],"mappings":"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","file":"chunk-W6BH2YMZ.cjs","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  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, randomSessionId } from '../_internal.js';\nimport { ActivityMedia } from '../shared/ActivityMedia.js';\nimport { FeedbackRegion } from '../shared/FeedbackRegion.js';\nimport type { ActivityProps } from '../types.js';\n\n/** FNV-1a hash → 32-bit seed. */\nfunction hashSeed(input: string): number {\n  let h = 2166136261 >>> 0;\n  for (let i = 0; i < input.length; i += 1) {\n    h ^= input.charCodeAt(i);\n    h = Math.imul(h, 16777619) >>> 0;\n  }\n  return h;\n}\n\n/** Deterministic LCG Fisher–Yates; returns a permutation (no loss/dupe). */\nfunction seededShuffle<T>(items: readonly T[], seed: number): T[] {\n  const out = [...items];\n  let s = seed >>> 0 || 1;\n  for (let i = out.length - 1; i > 0; i -= 1) {\n    s = (Math.imul(s, 1664525) + 1013904223) >>> 0;\n    const j = s % (i + 1);\n    [out[i], out[j]] = [out[j] as T, out[i] as T];\n  }\n  return out;\n}\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 v1 behaviour).\n   */\n  shuffleSeed?: string;\n}\n\nexport function MultipleChoice({\n  data,\n  onComplete,\n  onSubmit,\n  value,\n  defaultValue,\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  // 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  // Clears to empty rather than back to `defaultValue`: carrying a stale\n  // answer into a different question is the one failure mode a summative\n  // component must never have.\n  const lastDataRef = useRef(data);\n  useEffect(() => {\n    if (lastDataRef.current === data) {\n      return;\n    }\n    lastDataRef.current = data;\n    setInternalSelection([]);\n    setSummary(null);\n    reset();\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    return seededShuffle(data.options, hashSeed(`${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        type: 'http://adlnet.gov/expapi/activities/cmi.interaction',\n        interactionType: 'choice',\n        correctResponsesPattern: [\n          data.options\n            .filter((option) => option.isCorrect)\n            .map((option) => option.id)\n            .join('[,]'),\n        ],\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/{chunk-V5EN3ESV.js → chunk-XTJ22JAP.js}

@@ -1,12 +1,40 @@
 import { ActivityErrorBoundary, isDevelopment, ActivityMedia, FeedbackRegion, ANONYMOUS_ACTOR, objectIdFor } from './chunk-UIGIYYGY.js';
 import { useActivityState } from './chunk-5HVUKXF3.js';
 import { validateActivity, ActivitySchemaError, countWords, evaluate, xAPIBuilder } from '@intellectif/lk-core';
-import { useMemo, useState, useEffect } from 'react';
+import { useMemo, useState, useRef, useEffect } from 'react';
 import { jsx, jsxs } from 'react/jsx-runtime';
 
+function textOf(response) {
+  return response !== void 0 && response.type === "written-response" ? response.text : "";
+}
+function OutcomeSummary({ outcome }) {
+  if (outcome.status === "scored") {
+    const percent = outcome.maxScore > 0 ? Math.round(outcome.score / outcome.maxScore * 100) : Math.round(outcome.score * 100);
+    return /* @__PURE__ */ jsxs("div", { className: "lk-wr-outcome", "data-status": "scored", "data-passed": String(outcome.passed), children: [
+      /* @__PURE__ */ jsxs("p", { className: "lk-wr-grade", children: [
+        "Score ",
+        percent,
+        "%. ",
+        outcome.passed ? "Passed." : "Not passed."
+      ] }),
+      outcome.feedback ? /* @__PURE__ */ jsx("p", { className: "lk-wr-grade-feedback", children: outcome.feedback }) : null
+    ] });
+  }
+  if (outcome.status === "deferred") {
+    return /* @__PURE__ */ jsx("div", { className: "lk-wr-outcome", "data-status": "deferred", children: /* @__PURE__ */ jsx("p", { className: "lk-wr-grade", children: "Not graded yet. This response is waiting for its grade." }) });
+  }
+  return /* @__PURE__ */ jsx("div", { className: "lk-wr-outcome", "data-status": "unscorable", "data-reason": outcome.reason, children: /* @__PURE__ */ jsx("p", { className: "lk-wr-grade", children: "This response could not be graded." }) });
+}
 function WrittenResponse({
   data,
   onSubmitted,
+  onSubmit,
+  value,
+  defaultValue,
+  onChange,
+  renderMode = "practice",
+  outcome,
+  sanitizeHtml,
   onInteraction,
   theme,
   locale,
@@ -20,33 +48,51 @@ function WrittenResponse({
     return result.success ? null : new ActivitySchemaError("written-response", result.errors);
   }, [data]);
   const { state, start, complete, getTimeSpent, reset } = useActivityState();
-  const [text, setText] = useState("");
+  const isControlled = value !== void 0;
+  const [innerText, setInnerText] = useState(() => textOf(defaultValue));
   const [summary, setSummary] = useState(null);
+  const promptHtml = useMemo(() => {
+    if (sanitizeHtml === void 0 || typeof data.promptHtml !== "string") {
+      return null;
+    }
+    return sanitizeHtml(data.promptHtml);
+  }, [data.promptHtml, sanitizeHtml]);
+  const defaultTextRef = useRef(textOf(defaultValue));
+  useEffect(() => {
+    defaultTextRef.current = textOf(defaultValue);
+  }, [defaultValue]);
   useEffect(() => {
-    setText("");
+    setInnerText(defaultTextRef.current);
     setSummary(null);
     reset();
   }, [data, reset]);
   if (devError) {
     throw devError;
   }
+  const isExam = renderMode === "exam";
+  const isReview = renderMode === "review";
+  const text = isControlled ? textOf(value) : innerText;
   const submitted = state === "completed";
-  const inactive = disabled === true || submitted;
+  const inactive = disabled === true || submitted || isReview;
   const wordCount = countWords(text);
   const withinBounds = wordCount >= data.minWords && wordCount <= data.maxWords;
-  const handleChange = (value) => {
+  const handleChange = (next) => {
     if (inactive) {
       return;
     }
     if (state === "idle") {
       start();
     }
-    setText(value);
+    if (!isControlled) {
+      setInnerText(next);
+    }
+    const nextWordCount = countWords(next);
+    onChange?.({ type: "written-response", text: next, wordCount: nextWordCount });
     onInteraction?.({
       type: "text-changed",
       activityId: data.id,
       timestamp: Date.now(),
-      payload: { wordCount: countWords(value) }
+      payload: { wordCount: nextWordCount }
     });
   };
   const handleSubmit = (event) => {
@@ -54,12 +100,20 @@ function WrittenResponse({
     if (inactive || text.trim().length === 0) {
       return;
     }
-    const outcome = evaluate(data, { type: "written-response", text, wordCount });
+    let finalWordCount = wordCount;
+    let finalWithinBounds = withinBounds;
+    if (!isExam) {
+      const itemOutcome = evaluate(data, { type: "written-response", text, wordCount });
+      const partial = itemOutcome.status === "deferred" ? itemOutcome.partial : void 0;
+      if (typeof partial?.wordCount === "number") {
+        finalWordCount = partial.wordCount;
+      }
+      if (typeof partial?.withinWordBounds === "boolean") {
+        finalWithinBounds = partial.withinWordBounds;
+      }
+    }
     complete();
     const timeSpent = getTimeSpent();
-    const partial = outcome.status === "deferred" ? outcome.partial : void 0;
-    const finalWordCount = typeof partial?.wordCount === "number" ? partial.wordCount : wordCount;
-    const finalWithinBounds = typeof partial?.withinWordBounds === "boolean" ? partial.withinWordBounds : withinBounds;
     const xapiStatement = xAPIBuilder.buildSubmittedStatement({
       actor: ANONYMOUS_ACTOR,
       object: {
@@ -75,7 +129,8 @@ function WrittenResponse({
         "urn:learning-kit:extension:within-word-bounds": finalWithinBounds
       }
     });
-    onSubmitted({
+    onSubmit?.({ type: "written-response", text, wordCount: finalWordCount });
+    onSubmitted?.({
       text,
       wordCount: finalWordCount,
       withinWordBounds: finalWithinBounds,
@@ -99,11 +154,22 @@ function WrittenResponse({
       className: "lk-wr",
       "aria-label": data.title,
       lang: locale,
+      "data-render-mode": renderMode,
       style: theme,
       onSubmit: handleSubmit,
       children: [
         data.media ? /* @__PURE__ */ jsx(ActivityMedia, { media: data.media }) : null,
-        /* @__PURE__ */ jsx("p", { className: "lk-wr-prompt", id: promptId, children: data.prompt }),
+        promptHtml === null ? /* @__PURE__ */ jsx("p", { className: "lk-wr-prompt", id: promptId, children: data.prompt }) : (
+          // A div, not a p: sanitised author HTML may contain block content.
+          /* @__PURE__ */ jsx(
+            "div",
+            {
+              className: "lk-wr-prompt",
+              id: promptId,
+              dangerouslySetInnerHTML: { __html: promptHtml }
+            }
+          )
+        ),
         /* @__PURE__ */ jsx(
           "textarea",
           {
@@ -112,7 +178,8 @@ function WrittenResponse({
             "aria-describedby": counterId,
             value: text,
             onChange: (event) => handleChange(event.target.value),
-            disabled: inactive,
+            disabled: !isReview && inactive,
+            readOnly: isReview,
             rows: 8
           }
         ),
@@ -133,7 +200,7 @@ function WrittenResponse({
             ]
           }
         ),
-        /* @__PURE__ */ jsx(
+        isReview ? null : /* @__PURE__ */ jsx(
           "button",
           {
             type: "submit",
@@ -142,7 +209,7 @@ function WrittenResponse({
             children: "Submit"
           }
         ),
-        /* @__PURE__ */ jsx(FeedbackRegion, { id: `${data.id}-feedback`, children: summary })
+        /* @__PURE__ */ jsx(FeedbackRegion, { id: `${data.id}-feedback`, children: isReview ? outcome ? /* @__PURE__ */ jsx(OutcomeSummary, { outcome }) : null : summary })
       ]
     }
   );
@@ -152,5 +219,5 @@ function WrittenResponse2(props) {
 }
 
 export { WrittenResponse2 as WrittenResponse };
-//# sourceMappingURL=chunk-V5EN3ESV.js.map
-//# sourceMappingURL=chunk-V5EN3ESV.js.map
+//# sourceMappingURL=chunk-XTJ22JAP.js.map
+//# sourceMappingURL=chunk-XTJ22JAP.js.map

package/dist/chunk-XTJ22JAP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/WrittenResponse/WrittenResponse.tsx","../src/components/WrittenResponse/index.tsx"],"names":["WrittenResponse","jsx"],"mappings":"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","file":"chunk-XTJ22JAP.js","sourcesContent":["'use client';\n\nimport {\n  ActivitySchemaError,\n  countWords,\n  evaluate,\n  type InteractionEvent,\n  type ItemOutcome,\n  type LearnerResponse,\n  type ThemeTokens,\n  validateActivity,\n  type WrittenResponseData,\n  type XAPIStatement,\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 { HtmlSanitizer, Renderable, RenderMode } from '../types.js';\n\n/**\n * Payload delivered when the learner submits a written response. Grading is\n * DEFERRED (asynchronous AI/human grading), so there is no score here — and\n * deliberately no fake one: an ungraded submission must never be shown or\n * stored as a 0. The consumer persists `text` and grades it out-of-band.\n */\nexport interface WrittenResponseSubmission {\n  /** The submitted text, verbatim. */\n  text: string;\n  /** Word count of `text`, recomputed with the canonical `countWords()`. */\n  wordCount: number;\n  /** Whether `wordCount` falls within the activity's `[minWords, maxWords]`. */\n  withinWordBounds: boolean;\n  /** Time in milliseconds from first interaction to submission. */\n  timeSpent: number;\n  /** The SUBMITTED-verb xAPI statement built for this submission (no score fields). */\n  xapiStatement: XAPIStatement;\n}\n\n/**\n * Props for {@link WrittenResponse}. Mirrors `ActivityProps` except for the\n * completion callback: a deferred-grading activity completes with a\n * {@link WrittenResponseSubmission} (`onSubmitted`), not a scored\n * `ActivityResult` (`onComplete`) — deviation from Req 22.8 recorded in the\n * roadmap (§3.1): fabricating a score of 0 for ungraded work is the exact\n * bug this type exists to fix. Everything else — controlled value, render\n * mode, server outcome, rich text — follows the shared `ActivityProps`\n * contract verbatim.\n */\nexport interface WrittenResponseProps {\n  /** Activity content. Accepts a `redact()` projection in `exam` mode. */\n  data: Renderable<WrittenResponseData>;\n  /**\n   * Called on submit with the ungraded submission (text, recomputed word\n   * count, bounds flag, timing, xAPI statement). Fires in `practice` and\n   * `exam` mode, after `onSubmit`; never in `review`.\n   *\n   * Optional since v0.4 so a `review`-mode render (which has no submit\n   * control) and an exam runner that only wants the raw response through\n   * `onSubmit` do not have to pass a no-op. Supply it in `practice`/`exam`\n   * unless `onSubmit` already captures everything you persist.\n   */\n  onSubmitted?: (submission: WrittenResponseSubmission) => void;\n  /**\n   * Called on submit with the raw learner response and no grade, BEFORE\n   * `onSubmitted`. This is the only submit callback an exam runner needs:\n   * the server grades the text and returns an {@link ItemOutcome} later.\n   */\n  onSubmit?: (response: LearnerResponse) => void;\n  /**\n   * Controlled value: the learner's current response. When present the\n   * textarea renders from it (never from internal state) and every keystroke\n   * goes out through `onChange` — restore an in-progress attempt, autosave a\n   * delta, or drive a review render with it.\n   */\n  value?: LearnerResponse;\n  /** Initial response for an uncontrolled component (ignored when `value` is set). */\n  defaultValue?: LearnerResponse;\n  /** Fires on every change to the learner's response. Required for a controlled component. */\n  onChange?: (response: LearnerResponse) => void;\n  /**\n   * Presentation mode, default `practice`. `practice` and `exam` are nearly\n   * identical here — a written response is never graded client-side, so\n   * there is no local score to withhold; `exam` additionally never calls\n   * `evaluate()` and renders happily from a `redact()` projection.\n   * `review` is read-only and shows the server's `outcome`.\n   */\n  renderMode?: RenderMode;\n  /**\n   * Server-computed outcome, rendered by `review` mode: `deferred` shows a\n   * \"not graded yet\" affordance, `scored` shows the returned grade and\n   * feedback. Ignored in other modes — this component never manufactures an\n   * outcome of its own.\n   */\n  outcome?: ItemOutcome;\n  /** Renders `data.promptHtml` when provided. See `HtmlSanitizer`. */\n  sanitizeHtml?: HtmlSanitizer;\n  onInteraction?: (event: InteractionEvent) => void;\n  /** Per-instance token overrides, applied as inline CSS vars on the root. */\n  theme?: Partial<ThemeTokens>;\n  locale?: string;\n  disabled?: boolean;\n}\n\n/**\n * Reads the text out of a learner response. Another activity type's response\n * shape (the `value`/`defaultValue` props take the `LearnerResponse` union,\n * so a generic runner can hand any of them over) reads as empty rather than\n * throwing mid-exam.\n */\nfunction textOf(response: LearnerResponse | undefined): string {\n  return response !== undefined && response.type === 'written-response' ? response.text : '';\n}\n\n/**\n * Renders the server-computed outcome in `review` mode. The grade shown here\n * always came back from the asynchronous grader — nothing on this path scores,\n * infers, or defaults a grade. A `written-response` outcome carries no\n * per-item `details` (there are no options or blanks to mark), so the render\n * is the scaled score, the pass state, and the grader's feedback.\n */\nfunction OutcomeSummary({ outcome }: { outcome: ItemOutcome }) {\n  if (outcome.status === 'scored') {\n    // `score` is scaled [0–1] against `maxScore`; normalising by `maxScore`\n    // is a no-op for the canonical maxScore of 1 and keeps an unscaled\n    // grader payload (8.5 / 10) from rendering as 850%.\n    const percent =\n      outcome.maxScore > 0\n        ? Math.round((outcome.score / outcome.maxScore) * 100)\n        : Math.round(outcome.score * 100);\n    return (\n      <div className=\"lk-wr-outcome\" data-status=\"scored\" data-passed={String(outcome.passed)}>\n        <p className=\"lk-wr-grade\">\n          Score {percent}%. {outcome.passed ? 'Passed.' : 'Not passed.'}\n        </p>\n        {outcome.feedback ? <p className=\"lk-wr-grade-feedback\">{outcome.feedback}</p> : null}\n      </div>\n    );\n  }\n  if (outcome.status === 'deferred') {\n    return (\n      <div className=\"lk-wr-outcome\" data-status=\"deferred\">\n        <p className=\"lk-wr-grade\">Not graded yet. This response is waiting for its grade.</p>\n      </div>\n    );\n  }\n  // `unscorable` reasons are developer-facing strings; surface the state, not\n  // the reason, and leave it on the element for diagnostics.\n  return (\n    <div className=\"lk-wr-outcome\" data-status=\"unscorable\" data-reason={outcome.reason}>\n      <p className=\"lk-wr-grade\">This response could not be graded.</p>\n    </div>\n  );\n}\n\nexport function WrittenResponse({\n  data,\n  onSubmitted,\n  onSubmit,\n  value,\n  defaultValue,\n  onChange,\n  renderMode = 'practice',\n  outcome,\n  sanitizeHtml,\n  onInteraction,\n  theme,\n  locale,\n  disabled,\n}: WrittenResponseProps) {\n  // Dev-only boundary validation (Req 2.3), same convention as MC/FIB. The\n  // content schema is loose, so a `redact()` projection validates too.\n  const devError = useMemo(() => {\n    if (!isDevelopment()) {\n      return null;\n    }\n    const result = validateActivity('written-response', data);\n    return result.success ? null : new ActivitySchemaError('written-response', result.errors);\n  }, [data]);\n\n  const { state, start, complete, getTimeSpent, reset } = useActivityState();\n  const isControlled = value !== undefined;\n  const [innerText, setInnerText] = useState<string>(() => textOf(defaultValue));\n  const [summary, setSummary] = useState<string | null>(null);\n\n  /**\n   * Rich text is rendered ONLY through a caller-supplied sanitiser, and only\n   * when the author actually shipped the HTML sidecar. Without both, the\n   * plain-text prompt is rendered as an escaped React child.\n   */\n  const promptHtml = useMemo(() => {\n    if (sanitizeHtml === undefined || typeof data.promptHtml !== 'string') {\n      return null;\n    }\n    return sanitizeHtml(data.promptHtml);\n  }, [data.promptHtml, sanitizeHtml]);\n\n  // Latest seed text, kept in a ref so `defaultValue` is NOT a reset trigger:\n  // callers pass an object literal, whose identity changes every render.\n  const defaultTextRef = useRef<string>(textOf(defaultValue));\n  useEffect(() => {\n    defaultTextRef.current = textOf(defaultValue);\n  }, [defaultValue]);\n\n  // Reset on data-prop change (Req 3.7): back to the seed (empty when there\n  // is none — the v1 behaviour), never the previous activity's draft.\n  // biome-ignore lint/correctness/useExhaustiveDependencies: data is the reset trigger (Req 3.7)\n  useEffect(() => {\n    setInnerText(defaultTextRef.current);\n    setSummary(null);\n    reset();\n  }, [data, reset]);\n\n  if (devError) {\n    throw devError;\n  }\n\n  const isExam = renderMode === 'exam';\n  const isReview = renderMode === 'review';\n\n  const text = isControlled ? textOf(value) : innerText;\n  const submitted = state === 'completed';\n  const inactive = disabled === true || submitted || isReview;\n  const wordCount = countWords(text);\n  const withinBounds = wordCount >= data.minWords && wordCount <= data.maxWords;\n\n  const handleChange = (next: string): void => {\n    if (inactive) {\n      return;\n    }\n    if (state === 'idle') {\n      start();\n    }\n    // A controlled component renders from `props.value` only; the caller's\n    // state is the single source of truth for the text.\n    if (!isControlled) {\n      setInnerText(next);\n    }\n    const nextWordCount = countWords(next);\n    onChange?.({ type: 'written-response', text: next, wordCount: nextWordCount });\n    onInteraction?.({\n      type: 'text-changed',\n      activityId: data.id,\n      timestamp: Date.now(),\n      payload: { wordCount: nextWordCount },\n    });\n  };\n\n  const handleSubmit = (event: React.FormEvent): void => {\n    event.preventDefault();\n    if (inactive || text.trim().length === 0) {\n      return;\n    }\n    let finalWordCount = wordCount;\n    let finalWithinBounds = withinBounds;\n    // `exam` mode must not call evaluate(): the component does not grade, and\n    // a redacted projection carries no scoring input anyway. The two facts\n    // evaluate() returns for a deferred type (recomputed word count, bounds)\n    // are exactly what is computed above, so the payload is identical either\n    // way; practice keeps going through core so the numbers stay canonical.\n    if (!isExam) {\n      const itemOutcome = evaluate(data, { type: 'written-response', text, wordCount });\n      const partial = itemOutcome.status === 'deferred' ? itemOutcome.partial : undefined;\n      if (typeof partial?.wordCount === 'number') {\n        finalWordCount = partial.wordCount;\n      }\n      if (typeof partial?.withinWordBounds === 'boolean') {\n        finalWithinBounds = partial.withinWordBounds;\n      }\n    }\n    complete();\n    const timeSpent = getTimeSpent();\n    const xapiStatement = xAPIBuilder.buildSubmittedStatement({\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: 'long-fill-in',\n      },\n      timeSpentMs: timeSpent,\n      response: text,\n      resultExtensions: {\n        'urn:learning-kit:extension:word-count': finalWordCount,\n        'urn:learning-kit:extension:within-word-bounds': finalWithinBounds,\n      },\n    });\n    // Raw response first (an exam runner persists this), then the fuller\n    // ungraded submission — mirroring `onSubmit` before `onComplete`.\n    onSubmit?.({ type: 'written-response', text, wordCount: finalWordCount });\n    onSubmitted?.({\n      text,\n      wordCount: finalWordCount,\n      withinWordBounds: finalWithinBounds,\n      timeSpent,\n      xapiStatement,\n    });\n    setSummary('Response submitted. It will be graded and your result will appear here later.');\n    onInteraction?.({\n      type: 'submitted',\n      activityId: data.id,\n      timestamp: Date.now(),\n      payload: { wordCount: finalWordCount, withinWordBounds: finalWithinBounds },\n    });\n  };\n\n  const promptId = `${data.id}-prompt`;\n  const counterId = `${data.id}-counter`;\n  const boundsLabel =\n    data.minWords > 0 ? `${data.minWords}–${data.maxWords} words` : `up to ${data.maxWords} words`;\n\n  return (\n    <form\n      className=\"lk-wr\"\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      {promptHtml === null ? (\n        <p className=\"lk-wr-prompt\" id={promptId}>\n          {data.prompt}\n        </p>\n      ) : (\n        // A div, not a p: sanitised author HTML may contain block content.\n        <div\n          className=\"lk-wr-prompt\"\n          id={promptId}\n          // biome-ignore lint/security/noDangerouslySetInnerHtml: rendered only through the caller-supplied HtmlSanitizer — the SDK never injects unsanitised markup\n          dangerouslySetInnerHTML={{ __html: promptHtml }}\n        />\n      )}\n      <textarea\n        className=\"lk-wr-textarea\"\n        aria-labelledby={promptId}\n        aria-describedby={counterId}\n        value={text}\n        onChange={(event) => handleChange(event.target.value)}\n        // `review` uses readOnly rather than disabled: the submitted essay\n        // must stay focusable, selectable and scrollable for a screen reader\n        // and a keyboard, while remaining uneditable.\n        disabled={!isReview && inactive}\n        readOnly={isReview}\n        rows={8}\n      />\n      <div\n        className=\"lk-wr-counter\"\n        id={counterId}\n        aria-live=\"polite\"\n        data-within-bounds={withinBounds}\n      >\n        {wordCount} {wordCount === 1 ? 'word' : 'words'} ({boundsLabel})\n      </div>\n      {isReview ? null : (\n        <button\n          type=\"submit\"\n          className=\"lk-wr-submit\"\n          disabled={inactive || text.trim().length === 0}\n        >\n          Submit\n        </button>\n      )}\n      <FeedbackRegion id={`${data.id}-feedback`}>\n        {isReview ? outcome ? <OutcomeSummary outcome={outcome} /> : null : summary}\n      </FeedbackRegion>\n    </form>\n  );\n}\n","'use client';\n\nimport { ActivityErrorBoundary } from '../ActivityErrorBoundary.js';\nimport {\n  WrittenResponse as WrittenResponseCore,\n  type WrittenResponseProps,\n} from './WrittenResponse.js';\n\nexport type { HtmlSanitizer, Renderable, RenderMode } from '../types.js';\nexport type { WrittenResponseProps, WrittenResponseSubmission } from './WrittenResponse.js';\n\n/**\n * Public Written Response activity: a labelled textarea with a live word\n * counter for free-text writing graded asynchronously (AI or human). The core\n * is wrapped in `ActivityErrorBoundary` so a render failure (incl. the dev\n * schema-validation throw) degrades to an accessible fallback.\n */\nexport function WrittenResponse(props: WrittenResponseProps) {\n  return (\n    <ActivityErrorBoundary activityTitle={props.data?.title}>\n      <WrittenResponseCore {...props} />\n    </ActivityErrorBoundary>\n  );\n}\n"]}