@intellectif/lk-react 3.0.0 → 5.0.0

package/README.md

@@ -64,7 +64,9 @@ export function Demo() {
 
 - **`<MultipleChoice>`** — single / multi select, all-or-nothing or partial scoring, deterministic per-session shuffle, per-option `feedback`.
 - **`<FillInTheBlanks>`** — `{{id}}` placeholders, case/whitespace options, per-blank `hint` (Show/Hide toggle as an icon), per-blank `feedback` shown inline on submit with a learner-controlled **Hide/Show feedback** toggle, optional `showCorrectAnswers`.
-- **`<ActivitySequence>`** — in-place "question set" pager (Previous/Next, "Question X of N", no scrolling, focus-managed).
+- **`<WrittenResponse>`** — free-text writing with a live word counter and bounds messaging, graded **asynchronously**: it emits an ungraded submission (never a fake zero) and a SUBMITTED-verb xAPI statement, and renders a returned `GradeRecord` in `review` mode with per-criterion scores and inline corrections.
+- **`<ActivitySequence>`** — in-place "question set" pager (Previous/Next, "Question X of N", no scrolling, focus-managed). Accepts item groups and keeps their stimulus beside every question; `onSubmit` reports every raw answer with its `slotId`, which is the only response channel an `exam` sequence has.
+- **`<StimulusPanel>`** — a shared passage / recording / image (an item group's stimulus) as a landmark region; the sequence uses it, and a custom runner can too.
 - **Media per question** — optional `image` / `audio` / `video` / `embed` (YouTube/Vimeo iframe) above the question; alt-text required for `image`/`embed` (WCAG).
 - **Activity-level overall feedback** — `{ correct, incorrect }` shown after submit (h5p "Overall Feedback" parity).
 - **`useXAPI(config)`** — fire-and-forget LRS delivery with retry/backoff for 5xx/network (1 s / 2 s / 4 s), immediate fail on 4xx, never throws.
@@ -81,7 +83,9 @@ export function Demo() {
 | `@intellectif/lk-react` | Everything (barrel) |
 | `@intellectif/lk-react/components/MultipleChoice` | `<MultipleChoice>` (boundary-wrapped) |
 | `@intellectif/lk-react/components/FillInTheBlanks` | `<FillInTheBlanks>` (boundary-wrapped) |
+| `@intellectif/lk-react/components/WrittenResponse` | `<WrittenResponse>` (boundary-wrapped) |
 | `@intellectif/lk-react/components/ActivitySequence` | `<ActivitySequence>` question-set pager |
+| `@intellectif/lk-react/components/StimulusPanel` | `<StimulusPanel>` shared-stimulus region |
 | `@intellectif/lk-react/hooks/useActivityState` | Lifecycle + timing |
 | `@intellectif/lk-react/hooks/useXAPI` | LRS delivery (retry, never-throws) |
 | `@intellectif/lk-react/theme/ThemeProvider` | `<ThemeProvider>`, `darkTheme`, `useTheme`, `createTailwindTheme` |
@@ -97,12 +101,13 @@ ESM + CJS + `.d.ts` for every entry. Tree-shakeable.
 | **Scoring** | Pure & deterministic; `all-or-nothing` and `partial`. |
 | **Feedback** | Per-item (MC per-option, FIB per-blank) shown inline on submit with Hide/Show toggle, + activity-level overall. |
 | **Retry** | Pass a new `data` reference or change the React `key` → activity resets (no built-in button — retry *policy* is yours). |
-| **Persistence / resume** | Not in the SDK — capture `onInteraction` / `onComplete` and persist as you wish. No `initialResponse` prop in V1 (cannot re-hydrate a partial attempt). |
+| **Persistence / resume** | Storage is yours — capture `onSubmit` / `onChange` / `onInteraction` and persist as you wish. Re-hydration **is** supported: pass `defaultValue` to seed a component, or `value` + `onChange` to control it outright (since 2.1.0). |
 | **Authoring / content storage / CDN / auth** | Consumer responsibility — typed schemas + `validateActivity` + JSON Schema export are provided for you to build authoring on. |
 | **SSR / RSC** | Fully supported. |
 
 ## Documentation
 
+- [Upgrading](https://github.com/intellectif/learning-kit/blob/main/docs/upgrading.md) — start here if you are on 2.x.
 - [Authoring & content storage](https://github.com/intellectif/learning-kit/blob/main/docs/authoring.md)
 - [Styling](https://github.com/intellectif/learning-kit/blob/main/docs/styling.md) — tokens, the skin, overrides, dark mode, Tailwind.
 - [Project README](https://github.com/intellectif/learning-kit#readme) — full picture & monorepo layout.

package/dist/{WrittenResponse-BHhP936i.d.ts → WrittenResponse-Dkg7FUt-.d.ts}

@@ -1,5 +1,5 @@
 import { XAPIStatement, WrittenResponseData, LearnerResponse, ItemOutcome, InteractionEvent, ThemeTokens } from '@intellectif/lk-core';
-import { a as Renderable, R as RenderMode, H as HtmlSanitizer } from './types-CNmjqD6M.js';
+import { a as Renderable, R as RenderMode, H as HtmlSanitizer } from './types-CrURyd9-.js';
 
 /**
  * Payload delivered when the learner submits a written response. Grading is

package/dist/{WrittenResponse-B50EjVR0.d.cts → WrittenResponse-DqQ0NjPK.d.cts}

@@ -1,5 +1,5 @@
 import { XAPIStatement, WrittenResponseData, LearnerResponse, ItemOutcome, InteractionEvent, ThemeTokens } from '@intellectif/lk-core';
-import { a as Renderable, R as RenderMode, H as HtmlSanitizer } from './types-CNmjqD6M.cjs';
+import { a as Renderable, R as RenderMode, H as HtmlSanitizer } from './types-CrURyd9-.cjs';
 
 /**
  * Payload delivered when the learner submits a written response. Grading is

package/dist/chunk-3B4ACY4K.cjs

@@ -0,0 +1,249 @@
+'use strict';
+
+var chunkWCVD5LVG_cjs = require('./chunk-WCVD5LVG.cjs');
+var chunk67RIIDZX_cjs = require('./chunk-67RIIDZX.cjs');
+var chunk6COTYW77_cjs = require('./chunk-6COTYW77.cjs');
+var chunkPGEG7UZJ_cjs = require('./chunk-PGEG7UZJ.cjs');
+var chunkNEWGUDA5_cjs = require('./chunk-NEWGUDA5.cjs');
+var lkCore = require('@intellectif/lk-core');
+var react = require('react');
+var jsxRuntime = require('react/jsx-runtime');
+
+function entryKeyOf(slot) {
+  return slot.slotId.split(".")[0] ?? slot.slotId;
+}
+function SequencePane({
+  className,
+  hidden,
+  children
+}) {
+  const ref = react.useRef(null);
+  react.useEffect(() => {
+    if (!hidden) {
+      return;
+    }
+    const node = ref.current;
+    if (node === null) {
+      return;
+    }
+    for (const media of node.querySelectorAll("audio, video")) {
+      const element = media;
+      if (!element.paused) {
+        element.pause();
+      }
+    }
+  }, [hidden]);
+  return /* @__PURE__ */ jsxRuntime.jsx("div", { className, hidden, ref, children });
+}
+function ActivitySequence({
+  activities,
+  renderers,
+  onActivityComplete,
+  onComplete,
+  onFinished,
+  onSubmit,
+  onInteraction,
+  renderMode = "practice",
+  shuffle,
+  shuffleSeed,
+  sanitizeHtml,
+  theme,
+  locale,
+  disabled
+}) {
+  const sessionIdRef = react.useRef(null);
+  const shuffleEntries = shuffle === "entries";
+  const needsSeed = shuffleEntries || activities.some((entry) => lkCore.isItemGroup(entry) && entry.shuffle === "within-group");
+  if (needsSeed && shuffleSeed === void 0 && renderMode !== "practice") {
+    throw new Error(
+      `ActivitySequence: renderMode "${renderMode}" requires a \`shuffleSeed\` when shuffling (shuffle="entries", or a group with shuffle: "within-group"). Pass the attempt id, so the server's flattenSequence(entries, { seed }) reproduces the order the learner saw.`
+    );
+  }
+  const seed = needsSeed ? (
+    // biome-ignore lint/suspicious/noAssignInExpressions: sanctioned lazy ref initialization
+    shuffleSeed ?? (sessionIdRef.current ??= chunkPGEG7UZJ_cjs.randomSessionId())
+  ) : void 0;
+  const slots = react.useMemo(
+    () => lkCore.flattenSequence(activities, { shuffleEntries, ...seed !== void 0 ? { seed } : {} }),
+    [activities, shuffleEntries, seed]
+  );
+  const [index, setIndex] = react.useState(0);
+  const outcomesRef = react.useRef(null);
+  if (outcomesRef.current === null) {
+    outcomesRef.current = slots.map(() => null);
+  }
+  const regionRef = react.useRef(null);
+  const mountedRef = react.useRef(false);
+  const setKey = JSON.stringify(slots.map((slot) => [slot.slotId, slot.activity.id]));
+  const [prevSetKey, setPrevSetKey] = react.useState(setKey);
+  if (prevSetKey !== setKey) {
+    setPrevSetKey(setKey);
+    setIndex(0);
+    outcomesRef.current = slots.map(() => null);
+  }
+  react.useEffect(() => {
+    if (mountedRef.current) {
+      regionRef.current?.focus();
+    } else {
+      mountedRef.current = true;
+    }
+  }, [index]);
+  const stimulusMounts = react.useMemo(() => {
+    const mounts = /* @__PURE__ */ new Map();
+    for (const slot of slots) {
+      if (slot.group === void 0) {
+        continue;
+      }
+      const entryKey = entryKeyOf(slot);
+      const existing = mounts.get(entryKey);
+      if (existing === void 0) {
+        mounts.set(entryKey, { entryKey, group: slot.group, first: slot.index, last: slot.index });
+      } else {
+        existing.last = slot.index;
+      }
+    }
+    return [...mounts.values()];
+  }, [slots]);
+  const total = slots.length;
+  const current = slots[index];
+  const go = (next) => {
+    setIndex(next);
+  };
+  const record = (outcome) => {
+    const current2 = outcomesRef.current;
+    if (current2 === null || current2[outcome.index] != null) {
+      return;
+    }
+    const next = current2.slice();
+    next[outcome.index] = outcome;
+    outcomesRef.current = next;
+    if (outcome.kind === "scored") {
+      onActivityComplete?.(outcome.result, outcome.index, outcome.slotId);
+    }
+    if (!next.every((item) => item !== null)) {
+      return;
+    }
+    onFinished?.(next);
+    const scored = [];
+    for (const item of next) {
+      if (item.kind !== "scored") {
+        return;
+      }
+      scored.push(item.result);
+    }
+    onComplete?.(scored);
+  };
+  if (!current) {
+    return /* @__PURE__ */ jsxRuntime.jsx("div", { className: "lk-seq" });
+  }
+  const forwarded = {
+    ...onInteraction ? { onInteraction } : {},
+    renderMode,
+    ...sanitizeHtml ? { sanitizeHtml } : {},
+    ...theme ? { theme } : {},
+    ...locale ? { locale } : {},
+    ...disabled ? { disabled } : {}
+  };
+  const renderSlot = (slot) => {
+    const activity = slot.activity;
+    const { slotId, index: slotIndex } = slot;
+    const activityId = activity.id;
+    const childProps = {
+      onComplete: (result) => record({ kind: "scored", index: slotIndex, slotId, activityId, result }),
+      onSubmit: (response) => {
+        onSubmit?.(response, { slotId, index: slotIndex, activityId });
+        if (renderMode !== "practice" && activity.type !== "written-response") {
+          record({ kind: "responded", index: slotIndex, slotId, activityId, response });
+        }
+      },
+      ...forwarded
+    };
+    const CustomRenderer = renderers?.[activity.type];
+    if (CustomRenderer) {
+      return /* @__PURE__ */ jsxRuntime.jsx(CustomRenderer, { data: activity, ...childProps });
+    }
+    if (activity.type === "multiple-choice") {
+      return /* @__PURE__ */ jsxRuntime.jsx(chunkWCVD5LVG_cjs.MultipleChoice, { data: activity, ...childProps });
+    }
+    if (activity.type === "fill-in-the-blanks") {
+      return /* @__PURE__ */ jsxRuntime.jsx(chunk67RIIDZX_cjs.FillInTheBlanks, { data: activity, ...childProps });
+    }
+    if (activity.type === "written-response") {
+      return /* @__PURE__ */ jsxRuntime.jsx(
+        chunk6COTYW77_cjs.WrittenResponse,
+        {
+          data: activity,
+          onSubmitted: (submission) => record({ kind: "submitted", index: slotIndex, slotId, activityId, submission }),
+          onSubmit: childProps.onSubmit,
+          ...forwarded
+        }
+      );
+    }
+    return /* @__PURE__ */ jsxRuntime.jsx("div", { className: "lk-seq-unsupported", role: "note", children: "This activity type has no renderer. Supply one through the renderers prop." });
+  };
+  const currentEntryKey = entryKeyOf(current);
+  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "lk-seq", lang: locale, children: [
+    /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "lk-seq-progress", "aria-live": "polite", role: "status", children: [
+      "Question ",
+      index + 1,
+      " of ",
+      total
+    ] }),
+    stimulusMounts.map(({ entryKey, group, first, last }) => /* @__PURE__ */ jsxRuntime.jsx(
+      SequencePane,
+      {
+        className: "lk-seq-stimulus",
+        hidden: entryKey !== currentEntryKey,
+        children: /* @__PURE__ */ jsxRuntime.jsx(
+          chunkNEWGUDA5_cjs.StimulusPanel,
+          {
+            stimulus: group.stimulus,
+            range: { first: first + 1, last: last + 1 },
+            ...sanitizeHtml ? { sanitizeHtml } : {},
+            ...locale ? { locale } : {}
+          }
+        )
+      },
+      `group-${entryKey}`
+    )),
+    /* @__PURE__ */ jsxRuntime.jsx(
+      "section",
+      {
+        className: "lk-seq-question",
+        ref: regionRef,
+        tabIndex: -1,
+        "aria-label": `Question ${index + 1} of ${total}`,
+        children: slots.map((slot) => {
+          const slotKey = `${setKey}::slot-${slot.slotId}-${slot.activity.id}`;
+          return /* @__PURE__ */ jsxRuntime.jsx(SequencePane, { className: "lk-seq-slot", hidden: slot.index !== index, children: renderSlot(slot) }, slotKey);
+        })
+      }
+    ),
+    /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "lk-seq-nav", children: [
+      /* @__PURE__ */ jsxRuntime.jsx(
+        "button",
+        {
+          type: "button",
+          className: "lk-seq-prev",
+          onClick: () => go(index - 1),
+          disabled: index === 0,
+          children: "Previous"
+        }
+      ),
+      /* @__PURE__ */ jsxRuntime.jsx(
+        "button",
+        {
+          type: "button",
+          className: "lk-seq-next",
+          onClick: () => go(index + 1),
+          disabled: index === total - 1,
+          children: "Next"
+        }
+      )
+    ] })
+  ] });
+}
+
+exports.ActivitySequence = ActivitySequence;
+//# sourceMappingURL=chunk-3B4ACY4K.cjs.map
+//# sourceMappingURL=chunk-3B4ACY4K.cjs.map

package/dist/chunk-3B4ACY4K.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/ActivitySequence/ActivitySequence.tsx"],"names":["useRef","useEffect","jsx","isItemGroup","randomSessionId","useMemo","flattenSequence","useState","current","MultipleChoice","FillInTheBlanks","WrittenResponse","jsxs","StimulusPanel"],"mappings":"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","file":"chunk-3B4ACY4K.cjs","sourcesContent":["'use client';\n\nimport {\n  type ActivityResult,\n  flattenSequence,\n  type InteractionEvent,\n  isItemGroup,\n  type LearnerResponse,\n  type SequenceEntry,\n  type SequenceSlot,\n  type SequenceSlotGroup,\n  type ThemeTokens,\n} from '@intellectif/lk-core';\nimport { type ComponentType, useEffect, useMemo, useRef, useState } from 'react';\nimport { randomSessionId } from '../_internal.js';\nimport { FillInTheBlanks } from '../FillInTheBlanks/index.js';\nimport { MultipleChoice } from '../MultipleChoice/index.js';\nimport { StimulusPanel } from '../StimulusPanel/index.js';\nimport type { ActivityProps, HtmlSanitizer, RenderableActivity, RenderMode } from '../types.js';\nimport { WrittenResponse, type WrittenResponseSubmission } from '../WrittenResponse/index.js';\n\n/**\n * What one finished slot in a sequence produced. Two kinds, because two kinds\n * of activity exist: those the SDK scores at submit time, and those a grader\n * scores later. Collapsing them would mean inventing a score for ungraded\n * work — the exact defect the deferred outcome exists to prevent.\n */\nexport type SequenceItemOutcome =\n  | {\n      kind: 'scored';\n      /** Presented position. */\n      index: number;\n      /** Slot identity from `flattenSequence` — stable under shuffling; the `slotId` to score with. */\n      slotId: string;\n      activityId: string;\n      result: ActivityResult;\n    }\n  | {\n      kind: 'submitted';\n      index: number;\n      slotId: string;\n      activityId: string;\n      /** Ungraded submission; the grade arrives asynchronously. */\n      submission: WrittenResponseSubmission;\n    }\n  | {\n      kind: 'responded';\n      index: number;\n      slotId: string;\n      activityId: string;\n      /**\n       * The raw answer, with no grade of any kind. This is what an `exam` slot\n       * produces: the client is forbidden to score, so a response is all there\n       * is until the server grades it.\n       */\n      response: LearnerResponse;\n    };\n\n/**\n * A component that can render one activity inside a sequence. Register one per\n * activity `type` to put a consumer-defined type on screen — the React half of\n * the activity-type registry, matching `registerActivityType` in lk-core.\n */\nexport type ActivityRenderer = ComponentType<ActivityProps>;\n\nexport interface ActivitySequenceProps {\n  /**\n   * The ordered set of entries to present, one question at a time: loose\n   * activities, and item groups — a shared passage, recording or image with\n   * the questions that refer to it. A group's stimulus stays on screen\n   * alongside each of its questions.\n   *\n   * Accepts `redact()` projections. For data straight off a server, pass it\n   * through `asRenderableSequence()` — see that helper for why a cast is\n   * unavoidable there — and set `renderMode=\"exam\"`.\n   */\n  activities: readonly SequenceEntry<RenderableActivity>[];\n  /**\n   * Renderers for activity types beyond the built-ins, keyed by `data.type`.\n   * A key matching a built-in overrides it, so a consumer can replace the\n   * bundled renderer without forking the sequencer.\n   */\n  renderers?: Readonly<Record<string, ActivityRenderer>>;\n  /**\n   * Called whenever an individual activity is scored at submit time — the\n   * incremental persist hook.\n   *\n   * `slotId` is the identity to store the result against, NOT `index`.\n   * `index` is where the question was PRESENTED, which is not stable: it moves\n   * under shuffling, and it already differs from the slot identity whenever a\n   * group is present (the second entry of a sequence is presented at index 1\n   * but is slot `\"1.0\"` if it is a group's first question). `composeAssessmentScore`\n   * scores by `slotId`, so persisting `index` cannot be reconciled with it.\n   */\n  onActivityComplete?: (result: ActivityResult, index: number, slotId: string) => void;\n  /**\n   * Called on every submit with the learner's raw response and the identity of\n   * the slot that produced it — before any grading, in every render mode.\n   *\n   * **This is the only response channel an `exam` sequence has.** In `exam`\n   * mode the components never grade, so `onActivityComplete` cannot fire and\n   * `onComplete` never will; without this prop nothing a learner submitted\n   * would reach the consumer at all. Persist `response` against `slotId`.\n   */\n  onSubmit?: (\n    response: LearnerResponse,\n    slot: { slotId: string; index: number; activityId: string },\n  ) => void;\n  /**\n   * Called once every activity has been completed, with the scored results.\n   *\n   * Fires only when EVERY item produced a score. A set containing a\n   * deferred-graded activity (a written response) can never satisfy that, so\n   * use `onFinished` for mixed sets — it is the general completion signal and\n   * reports both kinds of outcome. It also carries `slotId` per item, which\n   * this callback's bare array cannot.\n   */\n  onComplete?: (results: ActivityResult[]) => void;\n  /**\n   * Called once every activity has been completed, whether it was scored at\n   * submit time or submitted for later grading. Use this for any set that\n   * mixes graded and deferred-graded activities.\n   */\n  onFinished?: (items: SequenceItemOutcome[]) => void;\n  /** Forwarded to each activity. */\n  onInteraction?: (event: InteractionEvent) => void;\n  /** Forwarded to each activity. `exam` and `review` disable local scoring. */\n  renderMode?: RenderMode;\n  /**\n   * `entries` shuffles the top-level entries; a group moves as one block, and\n   * the order INSIDE a group follows the group's own `shuffle` setting.\n   * Default `none`: authored order.\n   */\n  shuffle?: 'none' | 'entries';\n  /**\n   * Seed for every shuffle in this sequence (`shuffle: 'entries'` and any\n   * group with `shuffle: 'within-group'`). Supply the attempt id, so the\n   * server's `flattenSequence(entries, { seed })` derives the same order this\n   * pager shows.\n   *\n   * **Required in `exam` and `review` mode** — omitting it throws. An order\n   * nobody can reproduce cannot be reconciled with a recorded attempt, and\n   * failing at render is the only way that mistake surfaces before a learner\n   * sits the paper. In `practice` mode it stays optional: a random per-mount\n   * seed is used, which is stable within the mount and deliberately not\n   * reproducible. That fallback is also not SSR-safe (server and client would\n   * invent different orders and hydration would mismatch), so supply a seed\n   * for any server-rendered sequence regardless of mode.\n   */\n  shuffleSeed?: string;\n  /** Renders author-supplied rich text; forwarded to the stimulus panel and every activity. */\n  sanitizeHtml?: HtmlSanitizer;\n  theme?: Partial<ThemeTokens>;\n  locale?: string;\n  disabled?: boolean;\n}\n\n/** One stimulus panel to keep mounted: the group, and the presented span of its questions. */\ninterface StimulusMount {\n  /** Authored entry position — unique per group in the sequence even if two groups share an id. */\n  entryKey: string;\n  group: SequenceSlotGroup;\n  first: number;\n  last: number;\n}\n\n/** The authored-entry prefix of a slot id: `\"3\"` for `\"3\"` and for `\"3.1\"`. */\nfunction entryKeyOf(slot: SequenceSlot<RenderableActivity>): string {\n  return slot.slotId.split('.')[0] ?? slot.slotId;\n}\n\n/**\n * A pane that is kept MOUNTED but shown only when it is the current one, and\n * that stops any media it contains on the way out.\n *\n * `hidden` alone is not enough. It resolves to `display: none`, and CSS does\n * not touch playback: an `<audio>` or `<video>` inside a hidden subtree keeps\n * playing to the end. (The HTML spec pauses a media element when it is\n * REMOVED from the document — a different thing, and the thing this pager\n * deliberately does not do, because unmounting is what used to destroy the\n * learner's answers.) So a recording started for one question would carry on\n * underneath the next, which for a listening paper means the passage plays\n * while the learner is somewhere else entirely.\n *\n * Pausing preserves `currentTime`: coming back to a group resumes where the\n * learner left off. Nothing auto-plays on the way in — starting audio the\n * learner did not ask for is its own defect.\n *\n * `embed` media (a provider iframe) cannot be paused this way: controlling a\n * third-party player needs its own JS API, which the SDK has no reliable\n * access to because the author supplies the embed URL. Use `audio`/`video`\n * media for anything that must stop when the learner navigates.\n */\nfunction SequencePane({\n  className,\n  hidden,\n  children,\n}: {\n  className: string;\n  hidden: boolean;\n  children: React.ReactNode;\n}): React.JSX.Element {\n  const ref = useRef<HTMLDivElement>(null);\n\n  useEffect(() => {\n    if (!hidden) {\n      return;\n    }\n    const node = ref.current;\n    if (node === null) {\n      return;\n    }\n    for (const media of node.querySelectorAll('audio, video')) {\n      const element = media as HTMLMediaElement;\n      if (!element.paused) {\n        element.pause();\n      }\n    }\n  }, [hidden]);\n\n  return (\n    <div className={className} hidden={hidden} ref={ref}>\n      {children}\n    </div>\n  );\n}\n\n/**\n * Presents a set of activities as an in-place pager: one question visible at a\n * time, navigated with Prev/Next (no page scrolling). Linear free navigation —\n * the learner may move back and forth; activities keep their own submit and\n * scoring. On navigation, focus moves to the question region and the position\n * is announced via an aria-live region.\n *\n * Item groups are flattened into consecutive questions; the group's stimulus\n * is mounted ONCE, beside the question region rather than inside it, and shown\n * alongside every question in the group — so a passage stays put, and a\n * recording keeps its position, as the learner moves between its questions.\n */\nexport function ActivitySequence({\n  activities,\n  renderers,\n  onActivityComplete,\n  onComplete,\n  onFinished,\n  onSubmit,\n  onInteraction,\n  renderMode = 'practice',\n  shuffle,\n  shuffleSeed,\n  sanitizeHtml,\n  theme,\n  locale,\n  disabled,\n}: ActivitySequenceProps): React.JSX.Element {\n  const sessionIdRef = useRef<string | null>(null);\n\n  // The presented order comes from lk-core, never computed here: the server\n  // that records an attempt calls the same function with the same seed.\n  const shuffleEntries = shuffle === 'entries';\n  const needsSeed =\n    shuffleEntries ||\n    activities.some((entry) => isItemGroup(entry) && entry.shuffle === 'within-group');\n\n  // An unreproducible order is a practice-only affordance. Under `exam` or\n  // `review` the server has to be able to rebuild exactly what the learner\n  // saw, so a missing seed is an error rather than something to paper over —\n  // the same reason `flattenSequence` refuses to invent one.\n  if (needsSeed && shuffleSeed === undefined && renderMode !== 'practice') {\n    throw new Error(\n      `ActivitySequence: renderMode \"${renderMode}\" requires a \\`shuffleSeed\\` when shuffling ` +\n        '(shuffle=\"entries\", or a group with shuffle: \"within-group\"). Pass the attempt id, so ' +\n        \"the server's flattenSequence(entries, { seed }) reproduces the order the learner saw.\",\n    );\n  }\n\n  // Lazily created only when shuffling in practice without a caller seed (same\n  // contract as MultipleChoice.shuffleSeed): a per-mount session seed, stable\n  // across re-renders, never reproducible.\n  const seed = needsSeed\n    ? // biome-ignore lint/suspicious/noAssignInExpressions: sanctioned lazy ref initialization\n      (shuffleSeed ?? (sessionIdRef.current ??= randomSessionId()))\n    : undefined;\n  const slots = useMemo(\n    () => flattenSequence(activities, { shuffleEntries, ...(seed !== undefined ? { seed } : {}) }),\n    [activities, shuffleEntries, seed],\n  );\n\n  const [index, setIndex] = useState(0);\n  // Outcomes live in a ref, not state: nothing renders from them, and a ref is\n  // written SYNCHRONOUSLY. Reading them from a `useState` closure meant two\n  // slots completing in the same tick both saw the pre-update array — the\n  // second overwrote the first, so one answer vanished and completion never\n  // fired. Every slot is mounted at once here, so same-tick completions are\n  // reachable (a custom renderer that completes from a mount effect).\n  const outcomesRef = useRef<(SequenceItemOutcome | null)[] | null>(null);\n  if (outcomesRef.current === null) {\n    outcomesRef.current = slots.map(() => null);\n  }\n  const regionRef = useRef<HTMLDivElement>(null);\n  const mountedRef = useRef(false);\n\n  // Reset pager position and outcomes when the presented SET changes (B8):\n  // without this, results from the previous set leak into the new one and can\n  // fire completion with a mixed old/new array. Keyed on the set's CONTENT\n  // identity (ordered slot and activity ids), not the array reference — a\n  // parent that re-creates a structurally identical array on every render\n  // (inline literals, .map() in render) must not wipe in-progress answers.\n  // JSON.stringify (not join) so ids containing the separator cannot collide.\n  const setKey = JSON.stringify(slots.map((slot) => [slot.slotId, slot.activity.id]));\n  const [prevSetKey, setPrevSetKey] = useState(setKey);\n  if (prevSetKey !== setKey) {\n    setPrevSetKey(setKey);\n    setIndex(0);\n    outcomesRef.current = slots.map(() => null);\n  }\n\n  // After a navigation (not the initial mount) move focus to the question\n  // region so screen-reader / keyboard users land on the new question.\n  // biome-ignore lint/correctness/useExhaustiveDependencies: index is the intended trigger\n  useEffect(() => {\n    if (mountedRef.current) {\n      regionRef.current?.focus();\n    } else {\n      mountedRef.current = true;\n    }\n  }, [index]);\n\n  // One panel per group, spanning the presented positions of its questions.\n  const stimulusMounts = useMemo<StimulusMount[]>(() => {\n    const mounts = new Map<string, StimulusMount>();\n    for (const slot of slots) {\n      if (slot.group === undefined) {\n        continue;\n      }\n      const entryKey = entryKeyOf(slot);\n      const existing = mounts.get(entryKey);\n      if (existing === undefined) {\n        mounts.set(entryKey, { entryKey, group: slot.group, first: slot.index, last: slot.index });\n      } else {\n        existing.last = slot.index;\n      }\n    }\n    return [...mounts.values()];\n  }, [slots]);\n\n  const total = slots.length;\n  const current = slots[index];\n\n  const go = (next: number): void => {\n    setIndex(next);\n  };\n\n  /**\n   * Records a finished slot and fires completion callbacks when the set is\n   * done. A slot that already holds an outcome is FINAL: re-recording it would\n   * fire completion a second time for one attempt, so a consumer persisting on\n   * `onFinished` would write the same attempt twice.\n   */\n  const record = (outcome: SequenceItemOutcome): void => {\n    const current = outcomesRef.current;\n    if (current === null || current[outcome.index] != null) {\n      return;\n    }\n    const next = current.slice();\n    next[outcome.index] = outcome;\n    // Commit before firing anything: a second record() in the same tick must\n    // see this one.\n    outcomesRef.current = next;\n\n    if (outcome.kind === 'scored') {\n      onActivityComplete?.(outcome.result, outcome.index, outcome.slotId);\n    }\n\n    if (!next.every((item): item is SequenceItemOutcome => item !== null)) {\n      return;\n    }\n    onFinished?.(next);\n\n    // `onComplete` predates deferred grading and promises ActivityResult[].\n    // Fire it only when every slot really was scored, rather than inventing a\n    // result for work nobody has graded.\n    const scored: ActivityResult[] = [];\n    for (const item of next) {\n      if (item.kind !== 'scored') {\n        return;\n      }\n      scored.push(item.result);\n    }\n    onComplete?.(scored);\n  };\n\n  if (!current) {\n    return <div className=\"lk-seq\" />;\n  }\n\n  const forwarded = {\n    ...(onInteraction ? { onInteraction } : {}),\n    renderMode,\n    ...(sanitizeHtml ? { sanitizeHtml } : {}),\n    ...(theme ? { theme } : {}),\n    ...(locale ? { locale } : {}),\n    ...(disabled ? { disabled } : {}),\n  };\n\n  const renderSlot = (slot: SequenceSlot<RenderableActivity>): React.JSX.Element => {\n    const activity = slot.activity;\n    const { slotId, index: slotIndex } = slot;\n    const activityId = activity.id;\n    const childProps = {\n      onComplete: (result: ActivityResult) =>\n        record({ kind: 'scored', index: slotIndex, slotId, activityId, result }),\n      onSubmit: (response: LearnerResponse) => {\n        onSubmit?.(response, { slotId, index: slotIndex, activityId });\n        // Outside `practice` the components do not grade, so a raw response is\n        // the ONLY outcome this slot will ever produce — record it, or the set\n        // could never complete and `onFinished` would be dead in exam mode.\n        // Written responses are excluded because they report something richer\n        // through `onSubmitted` a moment later, and the first outcome wins.\n        if (renderMode !== 'practice' && activity.type !== 'written-response') {\n          record({ kind: 'responded', index: slotIndex, slotId, activityId, response });\n        }\n      },\n      ...forwarded,\n    };\n\n    const CustomRenderer = renderers?.[activity.type];\n    if (CustomRenderer) {\n      return <CustomRenderer data={activity} {...childProps} />;\n    }\n    if (activity.type === 'multiple-choice') {\n      return <MultipleChoice data={activity} {...childProps} />;\n    }\n    if (activity.type === 'fill-in-the-blanks') {\n      return <FillInTheBlanks data={activity} {...childProps} />;\n    }\n    if (activity.type === 'written-response') {\n      return (\n        <WrittenResponse\n          data={activity}\n          onSubmitted={(submission) =>\n            record({ kind: 'submitted', index: slotIndex, slotId, activityId, submission })\n          }\n          // Explicit rather than spread: WrittenResponse has no `onComplete`\n          // (it never grades), so `childProps` does not fit it — but it must\n          // still report the raw response like every other slot.\n          onSubmit={childProps.onSubmit}\n          {...forwarded}\n        />\n      );\n    }\n    return (\n      <div className=\"lk-seq-unsupported\" role=\"note\">\n        This activity type has no renderer. Supply one through the renderers prop.\n      </div>\n    );\n  };\n\n  const currentEntryKey = entryKeyOf(current);\n\n  return (\n    <div className=\"lk-seq\" lang={locale}>\n      <div className=\"lk-seq-progress\" aria-live=\"polite\" role=\"status\">\n        Question {index + 1} of {total}\n      </div>\n\n      {/*\n        Each group's stimulus is mounted ONCE and only hidden while the current\n        question is outside its group. That — not re-rendering it per slot — is\n        what makes the passage the same DOM node throughout, and what lets a\n        recording keep its position between questions of one group.\n\n        It sits BESIDE the question region, not inside it. Inside, every\n        navigation dropped focus onto a container whose first content was the\n        whole passage: the region promised \"Question 3 of 5\" and then began\n        with the passage, keyboard users tabbed through the stimulus (audio\n        controls included) before reaching the question, and the passage was a\n        landmark nested inside another landmark. As a sibling it stays a\n        landmark the learner can jump back to, while focus lands on the\n        question that was actually navigated to.\n      */}\n      {stimulusMounts.map(({ entryKey, group, first, last }) => (\n        <SequencePane\n          className=\"lk-seq-stimulus\"\n          hidden={entryKey !== currentEntryKey}\n          key={`group-${entryKey}`}\n        >\n          <StimulusPanel\n            stimulus={group.stimulus}\n            range={{ first: first + 1, last: last + 1 }}\n            {...(sanitizeHtml ? { sanitizeHtml } : {})}\n            {...(locale ? { locale } : {})}\n          />\n        </SequencePane>\n      ))}\n\n      <section\n        className=\"lk-seq-question\"\n        ref={regionRef}\n        tabIndex={-1}\n        aria-label={`Question ${index + 1} of ${total}`}\n      >\n        {/*\n          Every slot stays MOUNTED; only the current one is visible. Rendering\n          just the current activity unmounted the others, so navigating back to\n          an answered question showed it blank and re-answerable — the learner\n          silently lost their answer and a second submit fired completion\n          again. `hidden` removes the inactive slots from the accessibility\n          tree and from tab order, so only the current question is reachable.\n        */}\n        {slots.map((slot) => {\n          // The slot id (authored position) plus the activity id: the same\n          // activity may legitimately fill two slots, and each must keep its\n          // own answer state; and a different activity in the same slot must\n          // remount rather than inherit the previous one's state.\n          //\n          // `setKey` leads, so a set change remounts every child. Without it a\n          // pure REORDER changed `setKey` — clearing the outcomes — while each\n          // child kept its key and therefore its `completed` state. Those\n          // slots could not be answered again and no outcome would ever refill\n          // them, so the sequence could never finish. A reset has to reset\n          // both halves or neither. A parent re-creating a structurally\n          // identical array leaves `setKey` untouched, so answers still\n          // survive that.\n          const slotKey = `${setKey}::slot-${slot.slotId}-${slot.activity.id}`;\n          return (\n            <SequencePane className=\"lk-seq-slot\" hidden={slot.index !== index} key={slotKey}>\n              {renderSlot(slot)}\n            </SequencePane>\n          );\n        })}\n      </section>\n\n      <div className=\"lk-seq-nav\">\n        <button\n          type=\"button\"\n          className=\"lk-seq-prev\"\n          onClick={() => go(index - 1)}\n          disabled={index === 0}\n        >\n          Previous\n        </button>\n        <button\n          type=\"button\"\n          className=\"lk-seq-next\"\n          onClick={() => go(index + 1)}\n          disabled={index === total - 1}\n        >\n          Next\n        </button>\n      </div>\n    </div>\n  );\n}\n"]}

package/dist/{chunk-3X7MYAFT.js → chunk-3DNJDP73.js}

@@ -1,6 +1,7 @@
-import { ActivityErrorBoundary, isDevelopment, ActivityMedia, FeedbackRegion, ANONYMOUS_ACTOR, objectIdFor } from './chunk-UIGIYYGY.js';
+import { ActivityErrorBoundary, isDevelopment, FeedbackRegion, ANONYMOUS_ACTOR, objectIdFor } from './chunk-6F4X2NKL.js';
+import { ActivityMedia } from './chunk-GB5URWM4.js';
 import { useActivityState } from './chunk-5HVUKXF3.js';
-import { assertRedacted, validateActivity, ActivitySchemaError, score, xAPIBuilder } from '@intellectif/lk-core';
+import { assertRedacted, validateActivity, ActivitySchemaError, score, xAPIBuilder, xapiDefinitionFor } from '@intellectif/lk-core';
 import { useMemo, useState, useRef, useEffect } from 'react';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 
@@ -106,6 +107,11 @@ function FillInTheBlanks({
   if (devError) {
     throw devError;
   }
+  if (data.redacted === true && renderMode === "practice") {
+    throw new Error(
+      `Fill-in-the-Blanks "${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 submitted = state === "completed";
   const inactive = disabled === true || submitted || isReview;
   const revealing = isReview ? outcome?.status === "scored" : !isExam && submitted;
@@ -167,11 +173,7 @@ function FillInTheBlanks({
       object: {
         id: 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("[,]")
-        ]
+        ...xapiDefinitionFor(data)
       },
       scoringResult,
       timeSpentMs: timeSpent,
@@ -317,5 +319,5 @@ function FillInTheBlanks2(props) {
 }
 
 export { FillInTheBlanks2 as FillInTheBlanks };
-//# sourceMappingURL=chunk-3X7MYAFT.js.map
-//# sourceMappingURL=chunk-3X7MYAFT.js.map
+//# sourceMappingURL=chunk-3DNJDP73.js.map
+//# sourceMappingURL=chunk-3DNJDP73.js.map

package/dist/chunk-3DNJDP73.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/FillInTheBlanks/FillInTheBlanks.tsx","../src/components/FillInTheBlanks/index.tsx"],"names":["result","FillInTheBlanks","jsx"],"mappings":"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","file":"chunk-3DNJDP73.js","sourcesContent":["'use client';\n\nimport {\n  ActivitySchemaError,\n  assertRedacted,\n  type FillInTheBlanksData,\n  type FillInTheBlanksLearnerResponse,\n  type LearnerResponse,\n  type ScoringDetail,\n  type ScoringResult,\n  score,\n  validateActivity,\n  xAPIBuilder,\n  xapiDefinitionFor,\n} from '@intellectif/lk-core';\nimport { type CSSProperties, useEffect, useMemo, useRef, useState } from 'react';\nimport { useActivityState } from '../../hooks/useActivityState.js';\nimport { ANONYMOUS_ACTOR, isDevelopment, objectIdFor } from '../_internal.js';\nimport { ActivityMedia } from '../shared/ActivityMedia.js';\nimport { FeedbackRegion } from '../shared/FeedbackRegion.js';\nimport type { ActivityProps } from '../types.js';\n\nexport interface FillInTheBlanksProps extends ActivityProps<FillInTheBlanksData> {\n  /**\n   * After submission, replace each incorrectly-answered blank with its first\n   * accepted answer, styled distinctly (Req 5.7). Component-specific prop: it\n   * is presentation, not activity data, and is outside the fixed Req-3.1 set.\n   *\n   * Ignored in `exam` mode — revealing the key is precisely what an exam must\n   * not do, and on a `redact()` projection there is no key to reveal. In\n   * `review` mode it applies only to blanks the supplied `outcome` marks\n   * incorrect, and only when the caller passed data that still carries the key\n   * (e.g. `redact(data, { reveal: 'after-submit' })`).\n   */\n  showCorrectAnswers?: boolean;\n}\n\nconst PLACEHOLDER = /\\{\\{\\s*([^{}]+?)\\s*\\}\\}/g;\n\ntype Segment = { kind: 'text'; value: string } | { kind: 'blank'; id: string; ordinal: number };\n\nfunction parsePassage(passage: string): Segment[] {\n  const segments: Segment[] = [];\n  const re = new RegExp(PLACEHOLDER);\n  let last = 0;\n  let ordinal = 0;\n  let match = re.exec(passage);\n  while (match !== null) {\n    if (match.index > last) {\n      segments.push({ kind: 'text', value: passage.slice(last, match.index) });\n    }\n    ordinal += 1;\n    segments.push({ kind: 'blank', id: match[1] as string, ordinal });\n    last = match.index + match[0].length;\n    match = re.exec(passage);\n  }\n  if (last < passage.length) {\n    segments.push({ kind: 'text', value: passage.slice(last) });\n  }\n  return segments;\n}\n\n/** Shared empty map: keeps the \"no response supplied\" path allocation-free. */\nconst NO_ANSWERS: Record<string, string> = {};\n\n/**\n * Reads the answer map out of a `LearnerResponse`. A response of another\n * activity type is treated as \"no answers\" rather than throwing: a controlled\n * host that has not yet swapped its state on an activity change would\n * otherwise crash the attempt.\n */\nfunction answersOf(response: LearnerResponse | undefined): Record<string, string> {\n  return response !== undefined && response.type === 'fill-in-the-blanks'\n    ? response.answers\n    : NO_ANSWERS;\n}\n\n/**\n * Per-item correctness keyed by blank id. Prefers the unambiguous `outcome`\n * field (always written by the built-in scorers since lk-core 0.3.0) and\n * falls back to the deprecated `correct` boolean so a 0.2-era\n * consumer-constructed `ItemOutcome` still marks correctly in `review`.\n */\nfunction correctnessByItem(details: readonly ScoringDetail[]): Map<string, boolean> {\n  const map = new Map<string, boolean>();\n  for (const detail of details) {\n    map.set(\n      detail.itemId,\n      detail.outcome !== undefined ? detail.outcome === 'correct' : detail.correct,\n    );\n  }\n  return map;\n}\n\nexport function FillInTheBlanks({\n  data,\n  onComplete,\n  onSubmit,\n  onChange,\n  onInteraction,\n  value,\n  defaultValue,\n  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  // Practice grades locally, which a redacted projection cannot support: the\n  // submit handler below calls `score()`, which throws RedactedScoringError —\n  // from an event handler, where no error boundary can catch it, AFTER the\n  // learner has typed their answers. Fail loudly at render instead, in\n  // production too. This mirrors the identical guard in MultipleChoice;\n  // without it the two built-ins disagreed about the same accident, and\n  // wiring an exam item into the self-grading mode is precisely what\n  // `renderMode` exists to prevent.\n  if (data.redacted === true && renderMode === 'practice') {\n    throw new Error(\n      `Fill-in-the-Blanks \"${data.id}\" received redacted activity data in renderMode \"practice\", ` +\n        'which grades locally and has no answer key to grade against. ' +\n        'Render redacted data with renderMode=\"exam\" (server grades) or \"review\" (pass `outcome`).',\n    );\n  }\n\n  const submitted = state === 'completed';\n  const inactive = disabled === true || submitted || isReview;\n\n  /**\n   * Whether the component may show answer-key-derived information (per-blank\n   * correctness, authored feedback, correct answers). NEVER in `exam`; in\n   * `practice` only after the component scored locally; in `review` only once\n   * the caller supplies a SCORED outcome — an item that is still awaiting a\n   * grade must not have its key revealed just because it is being read back.\n   */\n  const revealing = isReview ? outcome?.status === 'scored' : !isExam && submitted;\n\n  const fireInteraction = (\n    type: 'blank-filled' | 'hint-requested' | 'submitted',\n    payload: Record<string, unknown>,\n  ): void => {\n    onInteraction?.({ type, activityId: data.id, timestamp: Date.now(), payload });\n  };\n\n  const handleChange = (blankId: string, text: string): void => {\n    if (inactive) {\n      return;\n    }\n    if (state === 'idle') {\n      start();\n    }\n    const next = { ...answers, [blankId]: text };\n    if (!isControlled) {\n      setInternalAnswers(next);\n    }\n    onChange?.({ type: 'fill-in-the-blanks', answers: next });\n    fireInteraction('blank-filled', { blankId, value: text });\n  };\n\n  const toggleHint = (blankId: string): void => {\n    if (inactive) {\n      return;\n    }\n    if (state === 'idle') {\n      start();\n    }\n    setRevealed((prev) => {\n      const next = new Set(prev);\n      if (next.has(blankId)) {\n        next.delete(blankId);\n        return next;\n      }\n      next.add(blankId);\n      return next;\n    });\n    // Only a reveal is a \"hint requested\"; hiding is not a new request.\n    if (!revealed.has(blankId)) {\n      fireInteraction('hint-requested', { blankId });\n    }\n  };\n\n  const handleSubmit = (event: React.FormEvent): void => {\n    event.preventDefault();\n    if (inactive) {\n      return;\n    }\n    const response: FillInTheBlanksLearnerResponse = { type: 'fill-in-the-blanks', answers };\n    // Fires in every submitting mode and always BEFORE onComplete, so an exam\n    // runner can persist the raw response regardless of local grading.\n    onSubmit?.(response);\n\n    if (isExam) {\n      // EXAM: the client neither grades nor reveals. No score()/evaluate(), no\n      // read of any answer-key field, no onComplete — and no xAPI statement,\n      // because its `correctResponsesPattern` IS the answer key. The server\n      // owns the grade; it emits the statement.\n      complete();\n      setSummary('Answer submitted.');\n      fireInteraction('submitted', { answers });\n      return;\n    }\n\n    // PRACTICE: unchanged v1 behaviour. `data` carries the key here — exam\n    // mode is the only path that may be handed a redact() projection.\n    const scoringResult = score('fill-in-the-blanks', data as FillInTheBlanksData, response);\n    complete();\n    const timeSpent = getTimeSpent();\n    const xapiStatement = xAPIBuilder.buildAnsweredStatement({\n      actor: ANONYMOUS_ACTOR,\n      object: {\n        id: objectIdFor(data.id),\n        name: { [data.locale ?? 'en-US']: data.title },\n        ...xapiDefinitionFor(data),\n      },\n      scoringResult,\n      timeSpentMs: timeSpent,\n      response: JSON.stringify(answers),\n    });\n    setResult(scoringResult);\n    onComplete?.({\n      score: scoringResult.score,\n      maxScore: scoringResult.maxScore,\n      passed: scoringResult.passed,\n      timeSpent,\n      xapiStatement,\n    });\n    // Core selects the authored overall feedback on `passed` (B3 fix).\n    const overall = scoringResult.feedback;\n    setSummary(\n      `Answer submitted. Score ${Math.round(scoringResult.score * 100)}%. ${\n        scoringResult.passed ? 'Passed.' : 'Not passed.'\n      }${overall ? ` ${overall}` : ''}`,\n    );\n    fireInteraction('submitted', { answers, score: scoringResult.score });\n  };\n\n  const correctByBlank = useMemo(() => {\n    if (isExam) {\n      // Nothing is ever marked client-side in an exam.\n      return new Map<string, boolean>();\n    }\n    if (isReview) {\n      // Correctness comes ONLY from the server-computed outcome; the component\n      // never scores in review, so an absent/ungraded outcome marks nothing.\n      return outcome?.status === 'scored'\n        ? correctnessByItem(outcome.details)\n        : new Map<string, boolean>();\n    }\n    return correctnessByItem(result?.details ?? []);\n  }, [isExam, isReview, outcome, result]);\n\n  /** Review has no local score: its summary is read off `outcome`, or nothing. */\n  const reviewSummary = useMemo(() => {\n    if (!isReview || outcome === undefined) {\n      return null;\n    }\n    if (outcome.status === 'scored') {\n      return `Score ${Math.round(outcome.score * 100)}%. ${\n        outcome.passed ? 'Passed.' : 'Not passed.'\n      }${outcome.feedback ? ` ${outcome.feedback}` : ''}`;\n    }\n    return outcome.status === 'deferred' ? 'Not graded yet.' : 'No grade available.';\n  }, [isReview, outcome]);\n\n  return (\n    <form\n      className=\"lk-fib\"\n      aria-label={data.title}\n      lang={locale}\n      data-render-mode={renderMode}\n      style={theme as CSSProperties | undefined}\n      onSubmit={handleSubmit}\n    >\n      {data.media ? <ActivityMedia media={data.media} /> : null}\n      <fieldset disabled={inactive}>\n        <p className=\"lk-fib-passage\">\n          {segments.map((seg, i) => {\n            if (seg.kind === 'text') {\n              // biome-ignore lint/suspicious/noArrayIndexKey: passage segments are positional and static\n              return <span key={`t${i}`}>{seg.value}</span>;\n            }\n            const blank = blankById.get(seg.id);\n            if (!blank) {\n              return null;\n            }\n            // `Renderable` only widens `scoringStrategy` at the type level, so\n            // the answer-key fields still LOOK required here while a redact()\n            // projection omits them at runtime. Read them defensively, and\n            // never at all in exam mode.\n            const acceptedAnswers: string[] | undefined = isExam\n              ? undefined\n              : blank.acceptedAnswers;\n            const blankFeedback = isExam ? undefined : blank.feedback;\n            const correctness = correctByBlank.get(seg.id);\n            const hintId = `${data.id}-hint-${seg.id}`;\n            const correctAnswer = acceptedAnswers?.[0];\n            if (revealing && showCorrectAnswers && correctness === false && correctAnswer) {\n              return (\n                <span key={seg.id} className=\"lk-fib-answer\" data-correct=\"false\">\n                  {correctAnswer}\n                </span>\n              );\n            }\n            return (\n              <span key={seg.id} className=\"lk-fib-blank\">\n                <input\n                  type=\"text\"\n                  aria-label={`Fill in blank ${seg.ordinal}`}\n                  aria-describedby={blank.hint ? hintId : undefined}\n                  value={answers[seg.id] ?? ''}\n                  disabled={inactive}\n                  aria-disabled={inactive || undefined}\n                  data-correct={\n                    revealing && correctness !== undefined ? String(correctness) : undefined\n                  }\n                  onChange={(e) => handleChange(seg.id, e.target.value)}\n                />\n                {/*\n                  Hints stay available in exam mode by design: lk-core's field\n                  policy classifies `blanks.hint` as `public`, so it survives\n                  redact() and is not part of the answer key.\n                */}\n                {blank.hint ? (\n                  <>\n                    {/*\n                      Default affordance is an icon; the accessible NAME stays\n                      text via aria-label (screen readers + tests rely on it).\n                      The glyph is restylable/replaceable via .lk-fib-hint-btn.\n                    */}\n                    <button\n                      type=\"button\"\n                      className=\"lk-fib-hint-btn\"\n                      aria-controls={hintId}\n                      aria-expanded={revealed.has(seg.id)}\n                      aria-label={revealed.has(seg.id) ? 'Hide hint' : 'Show hint'}\n                      disabled={inactive}\n                      onClick={() => toggleHint(seg.id)}\n                    >\n                      <svg\n                        className=\"lk-fib-hint-icon\"\n                        viewBox=\"0 0 24 24\"\n                        width=\"16\"\n                        height=\"16\"\n                        aria-hidden=\"true\"\n                        focusable=\"false\"\n                      >\n                        <path\n                          fill=\"currentColor\"\n                          d=\"M9 21h6v-1H9v1Zm3-19a7 7 0 0 0-4 12.74V17h8v-2.26A7 7 0 0 0 12 2Z\"\n                        />\n                      </svg>\n                    </button>\n                    {/*\n                      Not role=\"tooltip\": a real ARIA tooltip is a named\n                      hover/focus popup with strict WCAG 1.4.13 constraints.\n                      This is an accessible click-to-toggle disclosure that is\n                      the input's aria-describedby target and is announced via\n                      aria-live; the skin gives it a tooltip-like *visual*\n                      without the tooltip *semantics*. (Refines Task 15.3.)\n                    */}\n                    <span id={hintId} aria-live=\"polite\">\n                      {revealed.has(seg.id) ? blank.hint : ''}\n                    </span>\n                  </>\n                ) : null}\n                {revealing && !feedbackHidden && blankFeedback ? (\n                  <span\n                    className=\"lk-fib-blank-feedback\"\n                    role=\"note\"\n                    data-correct={correctness !== undefined ? String(correctness) : undefined}\n                  >\n                    {blankFeedback}\n                  </span>\n                ) : null}\n              </span>\n            );\n          })}\n        </p>\n        {/* Review is read-only: there is nothing to submit. */}\n        {isReview ? null : (\n          <button type=\"submit\" disabled={inactive}>\n            {isExam ? 'Submit answers' : 'Check answers'}\n          </button>\n        )}\n      </fieldset>\n      {revealing && data.blanks.some((b) => b.feedback) ? (\n        <button\n          type=\"button\"\n          className=\"lk-fib-feedback-toggle\"\n          aria-expanded={!feedbackHidden}\n          onClick={() => setFeedbackHidden((h) => !h)}\n        >\n          {feedbackHidden ? 'Show feedback' : 'Hide feedback'}\n        </button>\n      ) : null}\n      <FeedbackRegion id={`${data.id}-feedback`}>\n        {isReview ? reviewSummary : summary}\n      </FeedbackRegion>\n    </form>\n  );\n}\n","'use client';\n\nimport { ActivityErrorBoundary } from '../ActivityErrorBoundary.js';\nimport {\n  FillInTheBlanks as FillInTheBlanksCore,\n  type FillInTheBlanksProps,\n} from './FillInTheBlanks.js';\n\nexport type { FillInTheBlanksProps } from './FillInTheBlanks.js';\n\n/**\n * Public Fill-in-the-Blanks activity: the core wrapped in\n * `ActivityErrorBoundary` so a render failure (incl. the dev schema-validation\n * throw) degrades to an accessible fallback instead of crashing the host.\n */\nexport function FillInTheBlanks(props: FillInTheBlanksProps) {\n  return (\n    <ActivityErrorBoundary activityTitle={props.data?.title}>\n      <FillInTheBlanksCore {...props} />\n    </ActivityErrorBoundary>\n  );\n}\n"]}

package/dist/chunk-4HZ7LQIH.cjs

@@ -0,0 +1,40 @@
+'use strict';
+
+var jsxRuntime = require('react/jsx-runtime');
+
+// src/components/shared/ActivityMedia.tsx
+function ActivityMedia({ media }) {
+  const { type, url, alt, captionsUrl } = media;
+  if (type === "image") {
+    return /* @__PURE__ */ jsxRuntime.jsx("figure", { className: "lk-media", children: /* @__PURE__ */ jsxRuntime.jsx("img", { className: "lk-media-el", src: url, alt: alt ?? "" }) });
+  }
+  if (type === "audio") {
+    return /* @__PURE__ */ jsxRuntime.jsx("figure", { className: "lk-media", children: /* @__PURE__ */ jsxRuntime.jsxs("audio", { className: "lk-media-el", controls: true, "aria-label": alt || void 0, children: [
+      /* @__PURE__ */ jsxRuntime.jsx("source", { src: url }),
+      captionsUrl ? /* @__PURE__ */ jsxRuntime.jsx("track", { kind: "captions", src: captionsUrl, default: true }) : null
+    ] }) });
+  }
+  if (type === "embed") {
+    return /* @__PURE__ */ jsxRuntime.jsx("figure", { className: "lk-media", children: /* @__PURE__ */ jsxRuntime.jsx("div", { className: "lk-media-embed", children: /* @__PURE__ */ jsxRuntime.jsx(
+      "iframe",
+      {
+        className: "lk-media-el",
+        src: url,
+        title: alt ?? "Embedded media",
+        loading: "lazy",
+        referrerPolicy: "strict-origin-when-cross-origin",
+        sandbox: "allow-scripts allow-same-origin allow-presentation",
+        allow: "accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share",
+        allowFullScreen: true
+      }
+    ) }) });
+  }
+  return /* @__PURE__ */ jsxRuntime.jsx("figure", { className: "lk-media", children: /* @__PURE__ */ jsxRuntime.jsxs("video", { className: "lk-media-el", controls: true, "aria-label": alt || void 0, children: [
+    /* @__PURE__ */ jsxRuntime.jsx("source", { src: url }),
+    captionsUrl ? /* @__PURE__ */ jsxRuntime.jsx("track", { kind: "captions", src: captionsUrl, default: true }) : null
+  ] }) });
+}
+
+exports.ActivityMedia = ActivityMedia;
+//# sourceMappingURL=chunk-4HZ7LQIH.cjs.map
+//# sourceMappingURL=chunk-4HZ7LQIH.cjs.map

package/dist/chunk-4HZ7LQIH.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/shared/ActivityMedia.tsx"],"names":["jsx","jsxs"],"mappings":";;;;;AAUO,SAAS,aAAA,CAAc,EAAE,KAAA,EAAM,EAAoD;AACxF,EAAA,MAAM,EAAE,IAAA,EAAM,GAAA,EAAK,GAAA,EAAK,aAAY,GAAI,KAAA;AAExC,EAAA,IAAI,SAAS,OAAA,EAAS;AACpB,IAAA,uBACEA,cAAA,CAAC,QAAA,EAAA,EAAO,SAAA,EAAU,UAAA,EAChB,QAAA,kBAAAA,cAAA,CAAC,KAAA,EAAA,EAAI,SAAA,EAAU,aAAA,EAAc,GAAA,EAAK,GAAA,EAAK,GAAA,EAAK,GAAA,IAAO,IAAI,CAAA,EACzD,CAAA;AAAA,EAEJ;AAEA,EAAA,IAAI,SAAS,OAAA,EAAS;AACpB,IAAA,uBACEA,cAAA,CAAC,QAAA,EAAA,EAAO,SAAA,EAAU,UAAA,EAEhB,QAAA,kBAAAC,eAAA,CAAC,OAAA,EAAA,EAAM,SAAA,EAAU,aAAA,EAAc,QAAA,EAAQ,IAAA,EAAC,YAAA,EAAY,GAAA,IAAO,MAAA,EACzD,QAAA,EAAA;AAAA,sBAAAD,cAAA,CAAC,QAAA,EAAA,EAAO,KAAK,GAAA,EAAK,CAAA;AAAA,MACjB,WAAA,kCAAe,OAAA,EAAA,EAAM,IAAA,EAAK,YAAW,GAAA,EAAK,WAAA,EAAa,OAAA,EAAO,IAAA,EAAC,CAAA,GAAK;AAAA,KAAA,EACvE,CAAA,EACF,CAAA;AAAA,EAEJ;AAEA,EAAA,IAAI,SAAS,OAAA,EAAS;AACpB,IAAA,sCACG,QAAA,EAAA,EAAO,SAAA,EAAU,YAChB,QAAA,kBAAAA,cAAA,CAAC,KAAA,EAAA,EAAI,WAAU,gBAAA,EACb,QAAA,kBAAAA,cAAA;AAAA,MAAC,QAAA;AAAA,MAAA;AAAA,QACC,SAAA,EAAU,aAAA;AAAA,QACV,GAAA,EAAK,GAAA;AAAA,QACL,OAAO,GAAA,IAAO,gBAAA;AAAA,QACd,OAAA,EAAQ,MAAA;AAAA,QACR,cAAA,EAAe,iCAAA;AAAA,QAMf,OAAA,EAAQ,oDAAA;AAAA,QACR,KAAA,EAAM,qGAAA;AAAA,QACN,eAAA,EAAe;AAAA;AAAA,OAEnB,CAAA,EACF,CAAA;AAAA,EAEJ;AAEA,EAAA,uBACEA,cAAA,CAAC,QAAA,EAAA,EAAO,SAAA,EAAU,UAAA,EAEhB,QAAA,kBAAAC,eAAA,CAAC,OAAA,EAAA,EAAM,SAAA,EAAU,aAAA,EAAc,QAAA,EAAQ,IAAA,EAAC,YAAA,EAAY,GAAA,IAAO,MAAA,EACzD,QAAA,EAAA;AAAA,oBAAAD,cAAA,CAAC,QAAA,EAAA,EAAO,KAAK,GAAA,EAAK,CAAA;AAAA,IACjB,WAAA,kCAAe,OAAA,EAAA,EAAM,IAAA,EAAK,YAAW,GAAA,EAAK,WAAA,EAAa,OAAA,EAAO,IAAA,EAAC,CAAA,GAAK;AAAA,GAAA,EACvE,CAAA,EACF,CAAA;AAEJ","file":"chunk-4HZ7LQIH.cjs","sourcesContent":["import type { ActivityMedia as ActivityMediaData } from '@intellectif/lk-core';\n\n/**\n * Presentational media block shown above a question or passage. URL-only:\n * the SDK does not host media (consumer responsibility). Accessibility:\n * images use `alt` (schema requires it non-empty); audio/video expose an\n * optional label and a captions `<track>` when `captionsUrl` is provided;\n * `embed` renders a responsive sandboxed iframe with `alt` as its required\n * accessible `title` (Req 14.5).\n */\nexport function ActivityMedia({ media }: { media: ActivityMediaData }): React.JSX.Element {\n  const { type, url, alt, captionsUrl } = media;\n\n  if (type === 'image') {\n    return (\n      <figure className=\"lk-media\">\n        <img className=\"lk-media-el\" src={url} alt={alt ?? ''} />\n      </figure>\n    );\n  }\n\n  if (type === 'audio') {\n    return (\n      <figure className=\"lk-media\">\n        {/* biome-ignore lint/a11y/useMediaCaption: captions are optional in the data contract — a <track> is rendered when captionsUrl is provided; absence is the author's documented choice (Req 14.5) */}\n        <audio className=\"lk-media-el\" controls aria-label={alt || undefined}>\n          <source src={url} />\n          {captionsUrl ? <track kind=\"captions\" src={captionsUrl} default /> : null}\n        </audio>\n      </figure>\n    );\n  }\n\n  if (type === 'embed') {\n    return (\n      <figure className=\"lk-media\">\n        <div className=\"lk-media-embed\">\n          <iframe\n            className=\"lk-media-el\"\n            src={url}\n            title={alt ?? 'Embedded media'}\n            loading=\"lazy\"\n            referrerPolicy=\"strict-origin-when-cross-origin\"\n            // The docblock always promised a sandboxed iframe; now it is one.\n            // allow-scripts + allow-same-origin are required by provider\n            // players (YouTube/Vimeo); top-navigation, forms, downloads and\n            // popups stay blocked. Scheme allow-listing in MediaSchema is the\n            // primary defense; this is depth.\n            sandbox=\"allow-scripts allow-same-origin allow-presentation\"\n            allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share\"\n            allowFullScreen\n          />\n        </div>\n      </figure>\n    );\n  }\n\n  return (\n    <figure className=\"lk-media\">\n      {/* biome-ignore lint/a11y/useMediaCaption: captions are optional in the data contract — a <track> is rendered when captionsUrl is provided; absence is the author's documented choice (Req 14.5) */}\n      <video className=\"lk-media-el\" controls aria-label={alt || undefined}>\n        <source src={url} />\n        {captionsUrl ? <track kind=\"captions\" src={captionsUrl} default /> : null}\n      </video>\n    </figure>\n  );\n}\n"]}

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

@@ -1,27 +1,10 @@
-import { ActivityErrorBoundary, isDevelopment, randomSessionId, ActivityMedia, FeedbackRegion, ANONYMOUS_ACTOR, objectIdFor } from './chunk-UIGIYYGY.js';
+import { ActivityErrorBoundary, isDevelopment, randomSessionId, FeedbackRegion, ANONYMOUS_ACTOR, objectIdFor } from './chunk-6F4X2NKL.js';
+import { ActivityMedia } from './chunk-GB5URWM4.js';
 import { useActivityState } from './chunk-5HVUKXF3.js';
-import { validateActivity, ActivitySchemaError, score, xAPIBuilder } from '@intellectif/lk-core';
+import { validateActivity, ActivitySchemaError, seededShuffle, score, xAPIBuilder, xapiDefinitionFor } from '@intellectif/lk-core';
 import { useMemo, useRef, useState, useEffect } from 'react';
 import { jsx, jsxs } from 'react/jsx-runtime';
 
-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 : [];
 }
@@ -97,7 +80,7 @@ function MultipleChoice({
       return [...data.options];
     }
     const seedSource = shuffleSeed ?? (sessionIdRef.current ??= randomSessionId());
-    return seededShuffle(data.options, hashSeed(`${seedSource}:${data.id}`));
+    return seededShuffle(data.options, `${seedSource}:${data.id}`);
   }, [data, shuffleSeed]);
   const reviewDetails = useMemo(() => {
     if (renderMode !== "review" || outcome === void 0 || outcome.status !== "scored") {
@@ -174,11 +157,10 @@ function MultipleChoice({
       object: {
         id: 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("[,]")
-        ],
+        // Activity-type IRI, interaction type and correct-responses pattern
+        // come from the REGISTERED descriptor, so a consumer-registered type
+        // gets correct interop without touching this component.
+        ...xapiDefinitionFor(data),
         choices: data.options.map((option) => ({
           id: option.id,
           description: { [data.locale ?? "en-US"]: option.text }
@@ -253,5 +235,5 @@ function MultipleChoice2(props) {
 }
 
 export { MultipleChoice2 as MultipleChoice };
-//# sourceMappingURL=chunk-ZVFWJTT4.js.map
-//# sourceMappingURL=chunk-ZVFWJTT4.js.map
+//# sourceMappingURL=chunk-5SYL5CJ2.js.map
+//# sourceMappingURL=chunk-5SYL5CJ2.js.map