@intellectif/lk-react 3.0.0 → 4.0.0

package/dist/chunk-XQJFLAMD.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/WrittenResponse/WrittenResponse.tsx","../src/components/WrittenResponse/index.tsx"],"names":["jsxs","Fragment","jsx","useMemo","isDevelopment","validateActivity","ActivitySchemaError","useActivityState","useState","useRef","useEffect","countWords","evaluate","xAPIBuilder","ANONYMOUS_ACTOR","objectIdFor","ActivityMedia","FeedbackRegion","WrittenResponse","ActivityErrorBoundary"],"mappings":"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","file":"chunk-XQJFLAMD.cjs","sourcesContent":["'use client';\n\nimport {\n  ActivitySchemaError,\n  countWords,\n  evaluate,\n  type GradeRecord,\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 GradeBody({ grade }: { grade: GradeRecord }) {\n  return (\n    <>\n      {grade.feedback ? <p className=\"lk-wr-grade-feedback\">{grade.feedback}</p> : null}\n      {grade.criteria && grade.criteria.length > 0 ? (\n        <ul className=\"lk-wr-criteria\">\n          {grade.criteria.map((criterion) => (\n            <li\n              className=\"lk-wr-criterion\"\n              key={criterion.name}\n              data-na={String(criterion.notApplicable === true)}\n            >\n              <span className=\"lk-wr-criterion-name\">{criterion.name}</span>\n              {criterion.notApplicable === true ? (\n                <span className=\"lk-wr-criterion-score\">Not applicable</span>\n              ) : (\n                <span className=\"lk-wr-criterion-score\">\n                  {criterion.band ??\n                    (typeof criterion.score === 'number'\n                      ? `${Math.round(criterion.score * 100)}%`\n                      : '')}\n                </span>\n              )}\n              {criterion.comment ? (\n                <span className=\"lk-wr-criterion-comment\">{criterion.comment}</span>\n              ) : null}\n            </li>\n          ))}\n        </ul>\n      ) : null}\n      {grade.corrections && grade.corrections.length > 0 ? (\n        <ul className=\"lk-wr-corrections\">\n          {grade.corrections.map((correction) => (\n            <li className=\"lk-wr-correction\" key={`${correction.original}:${correction.corrected}`}>\n              <del className=\"lk-wr-correction-original\">{correction.original}</del>{' '}\n              <ins className=\"lk-wr-correction-corrected\">{correction.corrected}</ins>\n              {correction.explanation ? (\n                <span className=\"lk-wr-correction-explanation\">{correction.explanation}</span>\n              ) : null}\n            </li>\n          ))}\n        </ul>\n      ) : null}\n      {grade.requiresHumanReview === true ? (\n        <p className=\"lk-wr-review-flag\">This grade is awaiting review by a teacher.</p>\n      ) : null}\n    </>\n  );\n}\n\n/**\n * Renders the server-computed outcome in `review` mode. The grade shown here\n * always came back from the grader — nothing on this path scores, infers, or\n * defaults a grade.\n */\nfunction OutcomeSummary({ outcome }: { outcome: ItemOutcome }) {\n  if (outcome.status === 'scored' || outcome.status === 'graded') {\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\n        className=\"lk-wr-outcome\"\n        data-status={outcome.status}\n        data-passed={String(outcome.passed)}\n      >\n        <p className=\"lk-wr-grade\">\n          Score {percent}%. {outcome.passed ? 'Passed.' : 'Not passed.'}\n        </p>\n        {outcome.status === 'graded' ? (\n          <GradeBody grade={outcome.grade} />\n        ) : outcome.feedback ? (\n          <p className=\"lk-wr-grade-feedback\">{outcome.feedback}</p>\n        ) : 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"]}

package/dist/components/ActivitySequence.cjs

@@ -1,17 +1,19 @@
 'use strict';
 
-var chunkHO3AC3WQ_cjs = require('../chunk-HO3AC3WQ.cjs');
-require('../chunk-W6BH2YMZ.cjs');
-require('../chunk-UXO6KYSZ.cjs');
-require('../chunk-7MW7HGOA.cjs');
-require('../chunk-QHOV2A6M.cjs');
+var chunk525EWDUT_cjs = require('../chunk-525EWDUT.cjs');
+require('../chunk-WCVD5LVG.cjs');
+require('../chunk-67RIIDZX.cjs');
+require('../chunk-XQJFLAMD.cjs');
+require('../chunk-PGEG7UZJ.cjs');
+require('../chunk-NEWGUDA5.cjs');
+require('../chunk-4HZ7LQIH.cjs');
 require('../chunk-HD2AIQRD.cjs');
 
 
 
 Object.defineProperty(exports, "ActivitySequence", {
   enumerable: true,
-  get: function () { return chunkHO3AC3WQ_cjs.ActivitySequence; }
+  get: function () { return chunk525EWDUT_cjs.ActivitySequence; }
 });
 //# sourceMappingURL=ActivitySequence.cjs.map
 //# sourceMappingURL=ActivitySequence.cjs.map

package/dist/components/ActivitySequence.d.cts

@@ -1,7 +1,7 @@
-import { ActivityData, ActivityResult, InteractionEvent, ThemeTokens } from '@intellectif/lk-core';
+import { SequenceEntry, ActivityResult, LearnerResponse, InteractionEvent, ThemeTokens } from '@intellectif/lk-core';
 import { ComponentType } from 'react';
-import { A as ActivityProps, R as RenderMode } from '../types-CNmjqD6M.cjs';
-import { a as WrittenResponseSubmission } from '../WrittenResponse-B50EjVR0.cjs';
+import { A as ActivityProps, b as RenderableActivity, R as RenderMode, H as HtmlSanitizer } from '../types-CrURyd9-.cjs';
+import { a as WrittenResponseSubmission } from '../WrittenResponse-DqQ0NjPK.cjs';
 
 /**
  * What one finished slot in a sequence produced. Two kinds, because two kinds
@@ -11,15 +11,30 @@ import { a as WrittenResponseSubmission } from '../WrittenResponse-B50EjVR0.cjs'
  */
 type SequenceItemOutcome = {
     kind: 'scored';
+    /** Presented position. */
     index: number;
+    /** Slot identity from `flattenSequence` — stable under shuffling; the `slotId` to score with. */
+    slotId: string;
     activityId: string;
     result: ActivityResult;
 } | {
     kind: 'submitted';
     index: number;
+    slotId: string;
     activityId: string;
     /** Ungraded submission; the grade arrives asynchronously. */
     submission: WrittenResponseSubmission;
+} | {
+    kind: 'responded';
+    index: number;
+    slotId: string;
+    activityId: string;
+    /**
+     * The raw answer, with no grade of any kind. This is what an `exam` slot
+     * produces: the client is forbidden to score, so a response is all there
+     * is until the server grades it.
+     */
+    response: LearnerResponse;
 };
 /**
  * A component that can render one activity inside a sequence. Register one per
@@ -28,23 +43,57 @@ type SequenceItemOutcome = {
  */
 type ActivityRenderer = ComponentType<ActivityProps>;
 interface ActivitySequenceProps {
-    /** The ordered set of activities to present, one at a time. */
-    activities: ActivityData[];
+    /**
+     * The ordered set of entries to present, one question at a time: loose
+     * activities, and item groups — a shared passage, recording or image with
+     * the questions that refer to it. A group's stimulus stays on screen
+     * alongside each of its questions.
+     *
+     * Accepts `redact()` projections. For data straight off a server, pass it
+     * through `asRenderableSequence()` — see that helper for why a cast is
+     * unavoidable there — and set `renderMode="exam"`.
+     */
+    activities: readonly SequenceEntry<RenderableActivity>[];
     /**
      * Renderers for activity types beyond the built-ins, keyed by `data.type`.
      * A key matching a built-in overrides it, so a consumer can replace the
      * bundled renderer without forking the sequencer.
      */
     renderers?: Readonly<Record<string, ActivityRenderer>>;
-    /** Called whenever an individual activity is scored at submit time. */
-    onActivityComplete?: (result: ActivityResult, index: number) => void;
+    /**
+     * Called whenever an individual activity is scored at submit time — the
+     * incremental persist hook.
+     *
+     * `slotId` is the identity to store the result against, NOT `index`.
+     * `index` is where the question was PRESENTED, which is not stable: it moves
+     * under shuffling, and it already differs from the slot identity whenever a
+     * group is present (the second entry of a sequence is presented at index 1
+     * but is slot `"1.0"` if it is a group's first question). `composeAssessmentScore`
+     * scores by `slotId`, so persisting `index` cannot be reconciled with it.
+     */
+    onActivityComplete?: (result: ActivityResult, index: number, slotId: string) => void;
+    /**
+     * Called on every submit with the learner's raw response and the identity of
+     * the slot that produced it — before any grading, in every render mode.
+     *
+     * **This is the only response channel an `exam` sequence has.** In `exam`
+     * mode the components never grade, so `onActivityComplete` cannot fire and
+     * `onComplete` never will; without this prop nothing a learner submitted
+     * would reach the consumer at all. Persist `response` against `slotId`.
+     */
+    onSubmit?: (response: LearnerResponse, slot: {
+        slotId: string;
+        index: number;
+        activityId: string;
+    }) => void;
     /**
      * Called once every activity has been completed, with the scored results.
      *
      * Fires only when EVERY item produced a score. A set containing a
      * deferred-graded activity (a written response) can never satisfy that, so
      * use `onFinished` for mixed sets — it is the general completion signal and
-     * reports both kinds of outcome.
+     * reports both kinds of outcome. It also carries `slotId` per item, which
+     * this callback's bare array cannot.
      */
     onComplete?: (results: ActivityResult[]) => void;
     /**
@@ -57,6 +106,30 @@ interface ActivitySequenceProps {
     onInteraction?: (event: InteractionEvent) => void;
     /** Forwarded to each activity. `exam` and `review` disable local scoring. */
     renderMode?: RenderMode;
+    /**
+     * `entries` shuffles the top-level entries; a group moves as one block, and
+     * the order INSIDE a group follows the group's own `shuffle` setting.
+     * Default `none`: authored order.
+     */
+    shuffle?: 'none' | 'entries';
+    /**
+     * Seed for every shuffle in this sequence (`shuffle: 'entries'` and any
+     * group with `shuffle: 'within-group'`). Supply the attempt id, so the
+     * server's `flattenSequence(entries, { seed })` derives the same order this
+     * pager shows.
+     *
+     * **Required in `exam` and `review` mode** — omitting it throws. An order
+     * nobody can reproduce cannot be reconciled with a recorded attempt, and
+     * failing at render is the only way that mistake surfaces before a learner
+     * sits the paper. In `practice` mode it stays optional: a random per-mount
+     * seed is used, which is stable within the mount and deliberately not
+     * reproducible. That fallback is also not SSR-safe (server and client would
+     * invent different orders and hydration would mismatch), so supply a seed
+     * for any server-rendered sequence regardless of mode.
+     */
+    shuffleSeed?: string;
+    /** Renders author-supplied rich text; forwarded to the stimulus panel and every activity. */
+    sanitizeHtml?: HtmlSanitizer;
     theme?: Partial<ThemeTokens>;
     locale?: string;
     disabled?: boolean;
@@ -67,7 +140,12 @@ interface ActivitySequenceProps {
  * the learner may move back and forth; activities keep their own submit and
  * scoring. On navigation, focus moves to the question region and the position
  * is announced via an aria-live region.
+ *
+ * Item groups are flattened into consecutive questions; the group's stimulus
+ * is mounted ONCE, beside the question region rather than inside it, and shown
+ * alongside every question in the group — so a passage stays put, and a
+ * recording keeps its position, as the learner moves between its questions.
  */
-declare function ActivitySequence({ activities, renderers, onActivityComplete, onComplete, onFinished, onInteraction, renderMode, theme, locale, disabled, }: ActivitySequenceProps): React.JSX.Element;
+declare function ActivitySequence({ activities, renderers, onActivityComplete, onComplete, onFinished, onSubmit, onInteraction, renderMode, shuffle, shuffleSeed, sanitizeHtml, theme, locale, disabled, }: ActivitySequenceProps): React.JSX.Element;
 
 export { type ActivityRenderer, ActivitySequence, type ActivitySequenceProps, type SequenceItemOutcome };

package/dist/components/ActivitySequence.d.ts

@@ -1,7 +1,7 @@
-import { ActivityData, ActivityResult, InteractionEvent, ThemeTokens } from '@intellectif/lk-core';
+import { SequenceEntry, ActivityResult, LearnerResponse, InteractionEvent, ThemeTokens } from '@intellectif/lk-core';
 import { ComponentType } from 'react';
-import { A as ActivityProps, R as RenderMode } from '../types-CNmjqD6M.js';
-import { a as WrittenResponseSubmission } from '../WrittenResponse-BHhP936i.js';
+import { A as ActivityProps, b as RenderableActivity, R as RenderMode, H as HtmlSanitizer } from '../types-CrURyd9-.js';
+import { a as WrittenResponseSubmission } from '../WrittenResponse-Dkg7FUt-.js';
 
 /**
  * What one finished slot in a sequence produced. Two kinds, because two kinds
@@ -11,15 +11,30 @@ import { a as WrittenResponseSubmission } from '../WrittenResponse-BHhP936i.js';
  */
 type SequenceItemOutcome = {
     kind: 'scored';
+    /** Presented position. */
     index: number;
+    /** Slot identity from `flattenSequence` — stable under shuffling; the `slotId` to score with. */
+    slotId: string;
     activityId: string;
     result: ActivityResult;
 } | {
     kind: 'submitted';
     index: number;
+    slotId: string;
     activityId: string;
     /** Ungraded submission; the grade arrives asynchronously. */
     submission: WrittenResponseSubmission;
+} | {
+    kind: 'responded';
+    index: number;
+    slotId: string;
+    activityId: string;
+    /**
+     * The raw answer, with no grade of any kind. This is what an `exam` slot
+     * produces: the client is forbidden to score, so a response is all there
+     * is until the server grades it.
+     */
+    response: LearnerResponse;
 };
 /**
  * A component that can render one activity inside a sequence. Register one per
@@ -28,23 +43,57 @@ type SequenceItemOutcome = {
  */
 type ActivityRenderer = ComponentType<ActivityProps>;
 interface ActivitySequenceProps {
-    /** The ordered set of activities to present, one at a time. */
-    activities: ActivityData[];
+    /**
+     * The ordered set of entries to present, one question at a time: loose
+     * activities, and item groups — a shared passage, recording or image with
+     * the questions that refer to it. A group's stimulus stays on screen
+     * alongside each of its questions.
+     *
+     * Accepts `redact()` projections. For data straight off a server, pass it
+     * through `asRenderableSequence()` — see that helper for why a cast is
+     * unavoidable there — and set `renderMode="exam"`.
+     */
+    activities: readonly SequenceEntry<RenderableActivity>[];
     /**
      * Renderers for activity types beyond the built-ins, keyed by `data.type`.
      * A key matching a built-in overrides it, so a consumer can replace the
      * bundled renderer without forking the sequencer.
      */
     renderers?: Readonly<Record<string, ActivityRenderer>>;
-    /** Called whenever an individual activity is scored at submit time. */
-    onActivityComplete?: (result: ActivityResult, index: number) => void;
+    /**
+     * Called whenever an individual activity is scored at submit time — the
+     * incremental persist hook.
+     *
+     * `slotId` is the identity to store the result against, NOT `index`.
+     * `index` is where the question was PRESENTED, which is not stable: it moves
+     * under shuffling, and it already differs from the slot identity whenever a
+     * group is present (the second entry of a sequence is presented at index 1
+     * but is slot `"1.0"` if it is a group's first question). `composeAssessmentScore`
+     * scores by `slotId`, so persisting `index` cannot be reconciled with it.
+     */
+    onActivityComplete?: (result: ActivityResult, index: number, slotId: string) => void;
+    /**
+     * Called on every submit with the learner's raw response and the identity of
+     * the slot that produced it — before any grading, in every render mode.
+     *
+     * **This is the only response channel an `exam` sequence has.** In `exam`
+     * mode the components never grade, so `onActivityComplete` cannot fire and
+     * `onComplete` never will; without this prop nothing a learner submitted
+     * would reach the consumer at all. Persist `response` against `slotId`.
+     */
+    onSubmit?: (response: LearnerResponse, slot: {
+        slotId: string;
+        index: number;
+        activityId: string;
+    }) => void;
     /**
      * Called once every activity has been completed, with the scored results.
      *
      * Fires only when EVERY item produced a score. A set containing a
      * deferred-graded activity (a written response) can never satisfy that, so
      * use `onFinished` for mixed sets — it is the general completion signal and
-     * reports both kinds of outcome.
+     * reports both kinds of outcome. It also carries `slotId` per item, which
+     * this callback's bare array cannot.
      */
     onComplete?: (results: ActivityResult[]) => void;
     /**
@@ -57,6 +106,30 @@ interface ActivitySequenceProps {
     onInteraction?: (event: InteractionEvent) => void;
     /** Forwarded to each activity. `exam` and `review` disable local scoring. */
     renderMode?: RenderMode;
+    /**
+     * `entries` shuffles the top-level entries; a group moves as one block, and
+     * the order INSIDE a group follows the group's own `shuffle` setting.
+     * Default `none`: authored order.
+     */
+    shuffle?: 'none' | 'entries';
+    /**
+     * Seed for every shuffle in this sequence (`shuffle: 'entries'` and any
+     * group with `shuffle: 'within-group'`). Supply the attempt id, so the
+     * server's `flattenSequence(entries, { seed })` derives the same order this
+     * pager shows.
+     *
+     * **Required in `exam` and `review` mode** — omitting it throws. An order
+     * nobody can reproduce cannot be reconciled with a recorded attempt, and
+     * failing at render is the only way that mistake surfaces before a learner
+     * sits the paper. In `practice` mode it stays optional: a random per-mount
+     * seed is used, which is stable within the mount and deliberately not
+     * reproducible. That fallback is also not SSR-safe (server and client would
+     * invent different orders and hydration would mismatch), so supply a seed
+     * for any server-rendered sequence regardless of mode.
+     */
+    shuffleSeed?: string;
+    /** Renders author-supplied rich text; forwarded to the stimulus panel and every activity. */
+    sanitizeHtml?: HtmlSanitizer;
     theme?: Partial<ThemeTokens>;
     locale?: string;
     disabled?: boolean;
@@ -67,7 +140,12 @@ interface ActivitySequenceProps {
  * the learner may move back and forth; activities keep their own submit and
  * scoring. On navigation, focus moves to the question region and the position
  * is announced via an aria-live region.
+ *
+ * Item groups are flattened into consecutive questions; the group's stimulus
+ * is mounted ONCE, beside the question region rather than inside it, and shown
+ * alongside every question in the group — so a passage stays put, and a
+ * recording keeps its position, as the learner moves between its questions.
  */
-declare function ActivitySequence({ activities, renderers, onActivityComplete, onComplete, onFinished, onInteraction, renderMode, theme, locale, disabled, }: ActivitySequenceProps): React.JSX.Element;
+declare function ActivitySequence({ activities, renderers, onActivityComplete, onComplete, onFinished, onSubmit, onInteraction, renderMode, shuffle, shuffleSeed, sanitizeHtml, theme, locale, disabled, }: ActivitySequenceProps): React.JSX.Element;
 
 export { type ActivityRenderer, ActivitySequence, type ActivitySequenceProps, type SequenceItemOutcome };

package/dist/components/ActivitySequence.js

@@ -1,8 +1,10 @@
-export { ActivitySequence } from '../chunk-BGWXN44S.js';
-import '../chunk-ZVFWJTT4.js';
-import '../chunk-3X7MYAFT.js';
-import '../chunk-AEQQ7VPF.js';
-import '../chunk-UIGIYYGY.js';
+export { ActivitySequence } from '../chunk-GMU77L52.js';
+import '../chunk-5SYL5CJ2.js';
+import '../chunk-3DNJDP73.js';
+import '../chunk-SWZRB3VY.js';
+import '../chunk-6F4X2NKL.js';
+import '../chunk-UQ3BBEIT.js';
+import '../chunk-GB5URWM4.js';
 import '../chunk-5HVUKXF3.js';
 //# sourceMappingURL=ActivitySequence.js.map
 //# sourceMappingURL=ActivitySequence.js.map

package/dist/components/FillInTheBlanks.cjs

@@ -1,14 +1,15 @@
 'use strict';
 
-var chunkUXO6KYSZ_cjs = require('../chunk-UXO6KYSZ.cjs');
-require('../chunk-QHOV2A6M.cjs');
+var chunk67RIIDZX_cjs = require('../chunk-67RIIDZX.cjs');
+require('../chunk-PGEG7UZJ.cjs');
+require('../chunk-4HZ7LQIH.cjs');
 require('../chunk-HD2AIQRD.cjs');
 
 
 
 Object.defineProperty(exports, "FillInTheBlanks", {
   enumerable: true,
-  get: function () { return chunkUXO6KYSZ_cjs.FillInTheBlanks; }
+  get: function () { return chunk67RIIDZX_cjs.FillInTheBlanks; }
 });
 //# sourceMappingURL=FillInTheBlanks.cjs.map
 //# sourceMappingURL=FillInTheBlanks.cjs.map

package/dist/components/FillInTheBlanks.d.cts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { FillInTheBlanksData } from '@intellectif/lk-core';
-import { A as ActivityProps } from '../types-CNmjqD6M.cjs';
+import { A as ActivityProps } from '../types-CrURyd9-.cjs';
 
 interface FillInTheBlanksProps extends ActivityProps<FillInTheBlanksData> {
     /**

package/dist/components/FillInTheBlanks.d.ts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { FillInTheBlanksData } from '@intellectif/lk-core';
-import { A as ActivityProps } from '../types-CNmjqD6M.js';
+import { A as ActivityProps } from '../types-CrURyd9-.js';
 
 interface FillInTheBlanksProps extends ActivityProps<FillInTheBlanksData> {
     /**

package/dist/components/FillInTheBlanks.js

@@ -1,5 +1,6 @@
-export { FillInTheBlanks } from '../chunk-3X7MYAFT.js';
-import '../chunk-UIGIYYGY.js';
+export { FillInTheBlanks } from '../chunk-3DNJDP73.js';
+import '../chunk-6F4X2NKL.js';
+import '../chunk-GB5URWM4.js';
 import '../chunk-5HVUKXF3.js';
 //# sourceMappingURL=FillInTheBlanks.js.map
 //# sourceMappingURL=FillInTheBlanks.js.map

package/dist/components/MultipleChoice.cjs

@@ -1,14 +1,15 @@
 'use strict';
 
-var chunkW6BH2YMZ_cjs = require('../chunk-W6BH2YMZ.cjs');
-require('../chunk-QHOV2A6M.cjs');
+var chunkWCVD5LVG_cjs = require('../chunk-WCVD5LVG.cjs');
+require('../chunk-PGEG7UZJ.cjs');
+require('../chunk-4HZ7LQIH.cjs');
 require('../chunk-HD2AIQRD.cjs');
 
 
 
 Object.defineProperty(exports, "MultipleChoice", {
   enumerable: true,
-  get: function () { return chunkW6BH2YMZ_cjs.MultipleChoice; }
+  get: function () { return chunkWCVD5LVG_cjs.MultipleChoice; }
 });
 //# sourceMappingURL=MultipleChoice.cjs.map
 //# sourceMappingURL=MultipleChoice.cjs.map

package/dist/components/MultipleChoice.d.cts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { MultipleChoiceData } from '@intellectif/lk-core';
-import { A as ActivityProps } from '../types-CNmjqD6M.cjs';
+import { A as ActivityProps } from '../types-CrURyd9-.cjs';
 
 interface MultipleChoiceProps extends ActivityProps<MultipleChoiceData> {
     /**

package/dist/components/MultipleChoice.d.ts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { MultipleChoiceData } from '@intellectif/lk-core';
-import { A as ActivityProps } from '../types-CNmjqD6M.js';
+import { A as ActivityProps } from '../types-CrURyd9-.js';
 
 interface MultipleChoiceProps extends ActivityProps<MultipleChoiceData> {
     /**

package/dist/components/MultipleChoice.js

@@ -1,5 +1,6 @@
-export { MultipleChoice } from '../chunk-ZVFWJTT4.js';
-import '../chunk-UIGIYYGY.js';
+export { MultipleChoice } from '../chunk-5SYL5CJ2.js';
+import '../chunk-6F4X2NKL.js';
+import '../chunk-GB5URWM4.js';
 import '../chunk-5HVUKXF3.js';
 //# sourceMappingURL=MultipleChoice.js.map
 //# sourceMappingURL=MultipleChoice.js.map

package/dist/components/StimulusPanel.cjs

@@ -0,0 +1,13 @@
+'use strict';
+
+var chunkNEWGUDA5_cjs = require('../chunk-NEWGUDA5.cjs');
+require('../chunk-4HZ7LQIH.cjs');
+
+
+
+Object.defineProperty(exports, "StimulusPanel", {
+  enumerable: true,
+  get: function () { return chunkNEWGUDA5_cjs.StimulusPanel; }
+});
+//# sourceMappingURL=StimulusPanel.cjs.map
+//# sourceMappingURL=StimulusPanel.cjs.map

package/dist/components/StimulusPanel.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"StimulusPanel.cjs"}

package/dist/components/StimulusPanel.d.cts

@@ -0,0 +1,30 @@
+import { Stimulus } from '@intellectif/lk-core';
+import { H as HtmlSanitizer } from '../types-CrURyd9-.cjs';
+
+interface StimulusPanelProps {
+    stimulus: Stimulus;
+    /**
+     * 1-based presented positions of the first and last question this material
+     * serves, rendered as "Questions 3–8" so a learner knows how far the
+     * passage carries.
+     */
+    range?: {
+        first: number;
+        last: number;
+    };
+    /** Renders `stimulus.bodyHtml` when provided. See `HtmlSanitizer`. */
+    sanitizeHtml?: HtmlSanitizer;
+    locale?: string;
+}
+/**
+ * Presents a shared stimulus — the passage, recording or image an item group's
+ * questions refer to. A landmark region named by its title (or by its kind),
+ * so a screen-reader user can jump back to the material from any question.
+ *
+ * Rich text follows the SDK-wide rule: `bodyHtml` is rendered only through a
+ * caller-supplied sanitiser, and the plain `body` is the fallback — which the
+ * schema guarantees exists whenever `bodyHtml` does.
+ */
+declare function StimulusPanel({ stimulus, range, sanitizeHtml, locale, }: StimulusPanelProps): React.JSX.Element;
+
+export { StimulusPanel, type StimulusPanelProps };

package/dist/components/StimulusPanel.d.ts

@@ -0,0 +1,30 @@
+import { Stimulus } from '@intellectif/lk-core';
+import { H as HtmlSanitizer } from '../types-CrURyd9-.js';
+
+interface StimulusPanelProps {
+    stimulus: Stimulus;
+    /**
+     * 1-based presented positions of the first and last question this material
+     * serves, rendered as "Questions 3–8" so a learner knows how far the
+     * passage carries.
+     */
+    range?: {
+        first: number;
+        last: number;
+    };
+    /** Renders `stimulus.bodyHtml` when provided. See `HtmlSanitizer`. */
+    sanitizeHtml?: HtmlSanitizer;
+    locale?: string;
+}
+/**
+ * Presents a shared stimulus — the passage, recording or image an item group's
+ * questions refer to. A landmark region named by its title (or by its kind),
+ * so a screen-reader user can jump back to the material from any question.
+ *
+ * Rich text follows the SDK-wide rule: `bodyHtml` is rendered only through a
+ * caller-supplied sanitiser, and the plain `body` is the fallback — which the
+ * schema guarantees exists whenever `bodyHtml` does.
+ */
+declare function StimulusPanel({ stimulus, range, sanitizeHtml, locale, }: StimulusPanelProps): React.JSX.Element;
+
+export { StimulusPanel, type StimulusPanelProps };

package/dist/components/StimulusPanel.js

@@ -0,0 +1,4 @@
+export { StimulusPanel } from '../chunk-UQ3BBEIT.js';
+import '../chunk-GB5URWM4.js';
+//# sourceMappingURL=StimulusPanel.js.map
+//# sourceMappingURL=StimulusPanel.js.map

package/dist/components/StimulusPanel.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"StimulusPanel.js"}

package/dist/components/WrittenResponse.cjs

@@ -1,14 +1,15 @@
 'use strict';
 
-var chunk7MW7HGOA_cjs = require('../chunk-7MW7HGOA.cjs');
-require('../chunk-QHOV2A6M.cjs');
+var chunkXQJFLAMD_cjs = require('../chunk-XQJFLAMD.cjs');
+require('../chunk-PGEG7UZJ.cjs');
+require('../chunk-4HZ7LQIH.cjs');
 require('../chunk-HD2AIQRD.cjs');
 
 
 
 Object.defineProperty(exports, "WrittenResponse", {
   enumerable: true,
-  get: function () { return chunk7MW7HGOA_cjs.WrittenResponse; }
+  get: function () { return chunkXQJFLAMD_cjs.WrittenResponse; }
 });
 //# sourceMappingURL=WrittenResponse.cjs.map
 //# sourceMappingURL=WrittenResponse.cjs.map

package/dist/components/WrittenResponse.d.cts

@@ -1,7 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { W as WrittenResponseProps } from '../WrittenResponse-B50EjVR0.cjs';
-export { a as WrittenResponseSubmission } from '../WrittenResponse-B50EjVR0.cjs';
-export { H as HtmlSanitizer, R as RenderMode, a as Renderable } from '../types-CNmjqD6M.cjs';
+import { W as WrittenResponseProps } from '../WrittenResponse-DqQ0NjPK.cjs';
+export { a as WrittenResponseSubmission } from '../WrittenResponse-DqQ0NjPK.cjs';
+export { H as HtmlSanitizer, R as RenderMode, a as Renderable } from '../types-CrURyd9-.cjs';
 import '@intellectif/lk-core';
 
 /**

package/dist/components/WrittenResponse.d.ts

@@ -1,7 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { W as WrittenResponseProps } from '../WrittenResponse-BHhP936i.js';
-export { a as WrittenResponseSubmission } from '../WrittenResponse-BHhP936i.js';
-export { H as HtmlSanitizer, R as RenderMode, a as Renderable } from '../types-CNmjqD6M.js';
+import { W as WrittenResponseProps } from '../WrittenResponse-Dkg7FUt-.js';
+export { a as WrittenResponseSubmission } from '../WrittenResponse-Dkg7FUt-.js';
+export { H as HtmlSanitizer, R as RenderMode, a as Renderable } from '../types-CrURyd9-.js';
 import '@intellectif/lk-core';
 
 /**