@intellectif/lk-react 3.0.0 → 5.0.0

package/dist/components/WrittenResponse.js

@@ -1,5 +1,6 @@
-export { WrittenResponse } from '../chunk-AEQQ7VPF.js';
-import '../chunk-UIGIYYGY.js';
+export { WrittenResponse } from '../chunk-67WDTQMG.js';
+import '../chunk-6F4X2NKL.js';
+import '../chunk-GB5URWM4.js';
 import '../chunk-5HVUKXF3.js';
 //# sourceMappingURL=WrittenResponse.js.map
 //# sourceMappingURL=WrittenResponse.js.map

package/dist/index.cjs

@@ -1,59 +1,69 @@
 'use strict';
 
-var chunkHO3AC3WQ_cjs = require('./chunk-HO3AC3WQ.cjs');
-var chunkW6BH2YMZ_cjs = require('./chunk-W6BH2YMZ.cjs');
-var chunkUXO6KYSZ_cjs = require('./chunk-UXO6KYSZ.cjs');
-var chunk7MW7HGOA_cjs = require('./chunk-7MW7HGOA.cjs');
-require('./chunk-QHOV2A6M.cjs');
+var chunkCPF2JJG6_cjs = require('./chunk-CPF2JJG6.cjs');
+var chunk3B4ACY4K_cjs = require('./chunk-3B4ACY4K.cjs');
+var chunkWCVD5LVG_cjs = require('./chunk-WCVD5LVG.cjs');
+var chunk67RIIDZX_cjs = require('./chunk-67RIIDZX.cjs');
+var chunk6COTYW77_cjs = require('./chunk-6COTYW77.cjs');
+require('./chunk-PGEG7UZJ.cjs');
+var chunkNEWGUDA5_cjs = require('./chunk-NEWGUDA5.cjs');
+require('./chunk-4HZ7LQIH.cjs');
 var chunkHD2AIQRD_cjs = require('./chunk-HD2AIQRD.cjs');
 var chunkIYLQSNLE_cjs = require('./chunk-IYLQSNLE.cjs');
-var chunkCPF2JJG6_cjs = require('./chunk-CPF2JJG6.cjs');
 
 // src/components/types.ts
 function asRenderable(redacted) {
   return redacted;
 }
+function asRenderableSequence(entries) {
+  return entries;
+}
 
-Object.defineProperty(exports, "ActivitySequence", {
+Object.defineProperty(exports, "ThemeProvider", {
   enumerable: true,
-  get: function () { return chunkHO3AC3WQ_cjs.ActivitySequence; }
+  get: function () { return chunkCPF2JJG6_cjs.ThemeProvider; }
 });
-Object.defineProperty(exports, "MultipleChoice", {
+Object.defineProperty(exports, "darkTheme", {
   enumerable: true,
-  get: function () { return chunkW6BH2YMZ_cjs.MultipleChoice; }
+  get: function () { return chunkCPF2JJG6_cjs.darkTheme; }
 });
-Object.defineProperty(exports, "FillInTheBlanks", {
+Object.defineProperty(exports, "defaultTheme", {
   enumerable: true,
-  get: function () { return chunkUXO6KYSZ_cjs.FillInTheBlanks; }
+  get: function () { return chunkCPF2JJG6_cjs.defaultTheme; }
 });
-Object.defineProperty(exports, "WrittenResponse", {
+Object.defineProperty(exports, "useTheme", {
   enumerable: true,
-  get: function () { return chunk7MW7HGOA_cjs.WrittenResponse; }
+  get: function () { return chunkCPF2JJG6_cjs.useTheme; }
 });
-Object.defineProperty(exports, "useActivityState", {
+Object.defineProperty(exports, "ActivitySequence", {
   enumerable: true,
-  get: function () { return chunkHD2AIQRD_cjs.useActivityState; }
+  get: function () { return chunk3B4ACY4K_cjs.ActivitySequence; }
 });
-Object.defineProperty(exports, "useXAPI", {
+Object.defineProperty(exports, "MultipleChoice", {
   enumerable: true,
-  get: function () { return chunkIYLQSNLE_cjs.useXAPI; }
+  get: function () { return chunkWCVD5LVG_cjs.MultipleChoice; }
 });
-Object.defineProperty(exports, "ThemeProvider", {
+Object.defineProperty(exports, "FillInTheBlanks", {
   enumerable: true,
-  get: function () { return chunkCPF2JJG6_cjs.ThemeProvider; }
+  get: function () { return chunk67RIIDZX_cjs.FillInTheBlanks; }
 });
-Object.defineProperty(exports, "darkTheme", {
+Object.defineProperty(exports, "WrittenResponse", {
   enumerable: true,
-  get: function () { return chunkCPF2JJG6_cjs.darkTheme; }
+  get: function () { return chunk6COTYW77_cjs.WrittenResponse; }
 });
-Object.defineProperty(exports, "defaultTheme", {
+Object.defineProperty(exports, "StimulusPanel", {
   enumerable: true,
-  get: function () { return chunkCPF2JJG6_cjs.defaultTheme; }
+  get: function () { return chunkNEWGUDA5_cjs.StimulusPanel; }
 });
-Object.defineProperty(exports, "useTheme", {
+Object.defineProperty(exports, "useActivityState", {
   enumerable: true,
-  get: function () { return chunkCPF2JJG6_cjs.useTheme; }
+  get: function () { return chunkHD2AIQRD_cjs.useActivityState; }
+});
+Object.defineProperty(exports, "useXAPI", {
+  enumerable: true,
+  get: function () { return chunkIYLQSNLE_cjs.useXAPI; }
 });
 exports.asRenderable = asRenderable;
+exports.asRenderableSequence = asRenderableSequence;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/components/types.ts"],"names":[],"mappings":";;;;;;;;;;;;AAqHO,SAAS,aACd,QAAA,EACmB;AACnB,EAAA,OAAO,QAAA;AACT","file":"index.cjs","sourcesContent":["import type {\n  ActivityData,\n  ActivityResult,\n  InteractionEvent,\n  ItemOutcome,\n  LearnerResponse,\n  RedactedActivityData,\n  ThemeTokens,\n} from '@intellectif/lk-core';\n\n/**\n * How an activity is being presented. This is the single switch that decides\n * whether the component may grade, reveal, or submit — the three things a\n * summative exam must take away from the client.\n *\n * - `practice` (default, v1 behaviour): the component owns the attempt. It\n *   scores locally on submit, reveals correctness and feedback, and calls\n *   `onComplete` with a full {@link ActivityResult}.\n * - `exam`: the component NEVER scores and NEVER reveals correctness. Submit\n *   emits the raw learner response through `onSubmit`; the server grades it.\n *   Safe to render redacted data, because nothing here needs the answer key.\n * - `review`: read-only. Renders the learner's submitted answer, and marks\n *   correctness only from an `outcome` the caller supplies (which the server\n *   computed). Nothing is submittable.\n */\nexport type RenderMode = 'practice' | 'exam' | 'review';\n\n/**\n * Makes the answer-key-bearing parts of an activity optional, so a component\n * can render either full activity data OR a `redact()` projection with the\n * same props. Fields the SDK classifies `answer-key` become optional here;\n * a component in `exam` mode must not read them at all.\n */\nexport type Renderable<TData> = Omit<TData, 'scoringStrategy'> & {\n  scoringStrategy?: unknown;\n  /** Present on a `redact()` projection. */\n  redacted?: true;\n};\n\n/**\n * Sanitiser for author-supplied rich text (`questionHtml`, `passageHtml`,\n * `promptHtml`). The SDK deliberately ships NO sanitiser — that would add a\n * dependency and, worse, a false promise. Rich text is rendered only when you\n * supply this function; without it the component falls back to the plain-text\n * field, which is always escaped. Fail-safe by construction: the SDK never\n * injects HTML it was not explicitly given a sanitiser for.\n */\nexport type HtmlSanitizer = (html: string) => string;\n\n/**\n * The prop contract shared by every activity component (Req 3.1). Defined\n * here (React-specific) rather than in lk-core, which is React-free.\n *\n * Controlled / uncontrolled follows the React convention: pass `value` +\n * `onChange` to own the learner's answer (restore an in-progress attempt,\n * autosave a delta, drive a review); pass `defaultValue` to seed an\n * uncontrolled component; pass neither for the v1 behaviour.\n */\nexport interface ActivityProps<TData extends ActivityData = ActivityData> {\n  /** Activity content. Accepts a `redact()` projection in `exam` mode. */\n  data: Renderable<TData>;\n  /**\n   * Called when the component scored the attempt itself. Only ever fires in\n   * `practice` mode — in `exam` mode the client does not grade, so there is\n   * no `ActivityResult` to give you; use `onSubmit`.\n   */\n  onComplete?: (result: ActivityResult) => void;\n  /**\n   * Called on submit with the raw learner response and no grade. Fires in\n   * every mode, before `onComplete`, so an exam runner can persist the\n   * response and let the server score it.\n   */\n  onSubmit?: (response: LearnerResponse) => void;\n  /** Controlled value: the learner's current response. */\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  /** Presentation mode. Defaults to `practice`. */\n  renderMode?: RenderMode;\n  /**\n   * Server-computed outcome, used by `review` mode to mark correctness\n   * without the client ever scoring. Ignored in other modes.\n   */\n  outcome?: ItemOutcome;\n  /** Renders author-supplied rich text when provided. See {@link 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 * Bridges a server-produced `redact()` projection into the `data` prop.\n *\n * `RedactedActivityData` is deliberately index-signature typed in lk-core — it\n * proves a payload is learner-safe, not what shape it has — so TypeScript\n * cannot know it still carries the public fields a renderer needs. This is the\n * SDK's single, documented crossing of that gap, so an exam runner does not\n * have to write `as unknown as` at every call site:\n *\n * ```tsx\n * <MultipleChoice\n *   data={asRenderable<MultipleChoiceData>(redactedFromServer)}\n *   renderMode=\"exam\"\n *   onSubmit={persist}\n * />\n * ```\n *\n * Safe because `exam` mode reads only public fields; the answer-key fields the\n * type claims are exactly the ones the component is forbidden to touch there.\n * A future release will derive per-type redacted interfaces so this becomes\n * unnecessary.\n */\nexport function asRenderable<TData extends ActivityData>(\n  redacted: RedactedActivityData,\n): Renderable<TData> {\n  return redacted as unknown as Renderable<TData>;\n}\n"]}
+{"version":3,"sources":["../src/components/types.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AA2IO,SAAS,aACd,QAAA,EACmB;AACnB,EAAA,OAAO,QAAA;AACT;AA4BO,SAAS,qBACd,OAAA,EAC8C;AAC9C,EAAA,OAAO,OAAA;AACT","file":"index.cjs","sourcesContent":["import type {\n  ActivityData,\n  ActivityResult,\n  InteractionEvent,\n  ItemGroup,\n  ItemOutcome,\n  LearnerResponse,\n  RedactedActivityData,\n  SequenceEntry,\n  ThemeTokens,\n} from '@intellectif/lk-core';\n\n/**\n * How an activity is being presented. This is the single switch that decides\n * whether the component may grade, reveal, or submit — the three things a\n * summative exam must take away from the client.\n *\n * - `practice` (default, v1 behaviour): the component owns the attempt. It\n *   scores locally on submit, reveals correctness and feedback, and calls\n *   `onComplete` with a full {@link ActivityResult}.\n * - `exam`: the component NEVER scores and NEVER reveals correctness. Submit\n *   emits the raw learner response through `onSubmit`; the server grades it.\n *   Safe to render redacted data, because nothing here needs the answer key.\n * - `review`: read-only. Renders the learner's submitted answer, and marks\n *   correctness only from an `outcome` the caller supplies (which the server\n *   computed). Nothing is submittable.\n */\nexport type RenderMode = 'practice' | 'exam' | 'review';\n\n/**\n * Makes the answer-key-bearing parts of an activity optional, so a component\n * can render either full activity data OR a `redact()` projection with the\n * same props. Fields the SDK classifies `answer-key` become optional here;\n * a component in `exam` mode must not read them at all.\n */\nexport type Renderable<TData> = Omit<TData, 'scoringStrategy'> & {\n  scoringStrategy?: unknown;\n  /** Present on a `redact()` projection. */\n  redacted?: true;\n};\n\n/**\n * {@link Renderable} DISTRIBUTED over a union of activity types.\n *\n * This distinction is load-bearing, not cosmetic. `Renderable<T>` is built on\n * `Omit`, and `Omit` does not distribute: `Omit<A | B, K>` collapses to the\n * keys A and B have IN COMMON, so `Renderable<ActivityData>` is a single\n * object type carrying only the fields every activity shares. Narrowing it\n * dies with it — after `if (data.type === 'multiple-choice')` the compiler\n * still refuses `data.options`, because the union it would narrow to no\n * longer exists.\n *\n * The conditional below re-distributes, so `RenderableActivity` is a real\n * union of per-type renderables and `.type` narrows again. Anything that\n * accepts \"some renderable activity, I don't know which\" — a custom renderer,\n * a sequence entry — must use THIS, not `Renderable<ActivityData>`.\n */\nexport type RenderableActivity<TData extends ActivityData = ActivityData> = TData extends unknown\n  ? Renderable<TData>\n  : never;\n\n/**\n * Sanitiser for author-supplied rich text (`questionHtml`, `passageHtml`,\n * `promptHtml`). The SDK deliberately ships NO sanitiser — that would add a\n * dependency and, worse, a false promise. Rich text is rendered only when you\n * supply this function; without it the component falls back to the plain-text\n * field, which is always escaped. Fail-safe by construction: the SDK never\n * injects HTML it was not explicitly given a sanitiser for.\n */\nexport type HtmlSanitizer = (html: string) => string;\n\n/**\n * The prop contract shared by every activity component (Req 3.1). Defined\n * here (React-specific) rather than in lk-core, which is React-free.\n *\n * Controlled / uncontrolled follows the React convention: pass `value` +\n * `onChange` to own the learner's answer (restore an in-progress attempt,\n * autosave a delta, drive a review); pass `defaultValue` to seed an\n * uncontrolled component; pass neither for the v1 behaviour.\n */\nexport interface ActivityProps<TData extends ActivityData = ActivityData> {\n  /** Activity content. Accepts a `redact()` projection in `exam` mode. */\n  data: RenderableActivity<TData>;\n  /**\n   * Called when the component scored the attempt itself. Only ever fires in\n   * `practice` mode — in `exam` mode the client does not grade, so there is\n   * no `ActivityResult` to give you; use `onSubmit`.\n   */\n  onComplete?: (result: ActivityResult) => void;\n  /**\n   * Called on submit with the raw learner response and no grade. Fires in\n   * every mode, before `onComplete`, so an exam runner can persist the\n   * response and let the server score it.\n   */\n  onSubmit?: (response: LearnerResponse) => void;\n  /** Controlled value: the learner's current response. */\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  /** Presentation mode. Defaults to `practice`. */\n  renderMode?: RenderMode;\n  /**\n   * Server-computed outcome, used by `review` mode to mark correctness\n   * without the client ever scoring. Ignored in other modes.\n   */\n  outcome?: ItemOutcome;\n  /** Renders author-supplied rich text when provided. See {@link 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 * Bridges a server-produced `redact()` projection into the `data` prop.\n *\n * `RedactedActivityData` is deliberately index-signature typed in lk-core — it\n * proves a payload is learner-safe, not what shape it has — so TypeScript\n * cannot know it still carries the public fields a renderer needs. This is the\n * SDK's single, documented crossing of that gap, so an exam runner does not\n * have to write `as unknown as` at every call site:\n *\n * ```tsx\n * <MultipleChoice\n *   data={asRenderable<MultipleChoiceData>(redactedFromServer)}\n *   renderMode=\"exam\"\n *   onSubmit={persist}\n * />\n * ```\n *\n * Safe because `exam` mode reads only public fields; the answer-key fields the\n * type claims are exactly the ones the component is forbidden to touch there.\n * A future release will derive per-type redacted interfaces so this becomes\n * unnecessary.\n */\nexport function asRenderable<TData extends ActivityData>(\n  redacted: RedactedActivityData,\n): Renderable<TData> {\n  return redacted as unknown as Renderable<TData>;\n}\n\n/**\n * The same bridge as {@link asRenderable}, for a whole sequence: activities\n * and item groups as a server hands them over, ready for `<ActivitySequence>`.\n *\n * Needed for the same reason and no other. `redactItemGroup` returns\n * `ItemGroup<RedactedActivityData>`, and `RedactedActivityData` is an\n * index-signature type whose fields are all `unknown` — so its `question` is\n * not a `string` and it satisfies no per-type renderable, however the prop is\n * widened. Widening alone cannot fix this; a crossing point is required, and\n * having exactly one keeps `as unknown as` out of consumer code.\n *\n * ```tsx\n * const entries = await fetchExam();            // redacted, server-side\n * <ActivitySequence\n *   activities={asRenderableSequence(entries)}\n *   renderMode=\"exam\"                           // REQUIRED: see below\n *   shuffleSeed={attemptId}\n *   onSubmit={persist}\n * />\n * ```\n *\n * Pass `renderMode=\"exam\"` (or `\"review\"`). Redacted data has no answer key,\n * and the default `practice` mode grades locally — the built-in components\n * throw at render rather than fail at submit time, so a mis-wired exam item is\n * loud, not silent.\n */\nexport function asRenderableSequence(\n  entries: readonly (RedactedActivityData | RedactedItemGroupData)[],\n): readonly SequenceEntry<RenderableActivity>[] {\n  return entries as unknown as readonly SequenceEntry<RenderableActivity>[];\n}\n\n/** Structural shape of a `redactItemGroup()` projection, as it arrives from a server. */\ntype RedactedItemGroupData = ItemGroup<RedactedActivityData> & { redacted: true };\n"]}

package/dist/index.d.cts

@@ -1,12 +1,13 @@
 export { ActivityRenderer, ActivitySequence, ActivitySequenceProps, SequenceItemOutcome } from './components/ActivitySequence.cjs';
 export { FillInTheBlanks, FillInTheBlanksProps } from './components/FillInTheBlanks.cjs';
 export { MultipleChoice, MultipleChoiceProps } from './components/MultipleChoice.cjs';
-export { A as ActivityProps, H as HtmlSanitizer, R as RenderMode, a as Renderable, b as asRenderable } from './types-CNmjqD6M.cjs';
+export { StimulusPanel, StimulusPanelProps } from './components/StimulusPanel.cjs';
+export { A as ActivityProps, H as HtmlSanitizer, R as RenderMode, a as Renderable, b as RenderableActivity, c as asRenderable, d as asRenderableSequence } from './types-CrURyd9-.cjs';
 export { WrittenResponse } from './components/WrittenResponse.cjs';
 export { ActivityState, UseActivityStateResult, useActivityState } from './hooks/useActivityState.cjs';
 export { UseXAPIResult, useXAPI } from './hooks/useXAPI.cjs';
 export { ThemeProvider, ThemeProviderProps, darkTheme, defaultTheme, useTheme } from './theme/ThemeProvider.cjs';
-export { W as WrittenResponseProps, a as WrittenResponseSubmission } from './WrittenResponse-B50EjVR0.cjs';
+export { W as WrittenResponseProps, a as WrittenResponseSubmission } from './WrittenResponse-DqQ0NjPK.cjs';
 import '@intellectif/lk-core';
 import 'react';
 import 'react/jsx-runtime';

package/dist/index.d.ts

@@ -1,12 +1,13 @@
 export { ActivityRenderer, ActivitySequence, ActivitySequenceProps, SequenceItemOutcome } from './components/ActivitySequence.js';
 export { FillInTheBlanks, FillInTheBlanksProps } from './components/FillInTheBlanks.js';
 export { MultipleChoice, MultipleChoiceProps } from './components/MultipleChoice.js';
-export { A as ActivityProps, H as HtmlSanitizer, R as RenderMode, a as Renderable, b as asRenderable } from './types-CNmjqD6M.js';
+export { StimulusPanel, StimulusPanelProps } from './components/StimulusPanel.js';
+export { A as ActivityProps, H as HtmlSanitizer, R as RenderMode, a as Renderable, b as RenderableActivity, c as asRenderable, d as asRenderableSequence } from './types-CrURyd9-.js';
 export { WrittenResponse } from './components/WrittenResponse.js';
 export { ActivityState, UseActivityStateResult, useActivityState } from './hooks/useActivityState.js';
 export { UseXAPIResult, useXAPI } from './hooks/useXAPI.js';
 export { ThemeProvider, ThemeProviderProps, darkTheme, defaultTheme, useTheme } from './theme/ThemeProvider.js';
-export { W as WrittenResponseProps, a as WrittenResponseSubmission } from './WrittenResponse-BHhP936i.js';
+export { W as WrittenResponseProps, a as WrittenResponseSubmission } from './WrittenResponse-Dkg7FUt-.js';
 import '@intellectif/lk-core';
 import 'react';
 import 'react/jsx-runtime';

package/dist/index.js

@@ -1,17 +1,22 @@
-export { ActivitySequence } from './chunk-BGWXN44S.js';
-export { MultipleChoice } from './chunk-ZVFWJTT4.js';
-export { FillInTheBlanks } from './chunk-3X7MYAFT.js';
-export { WrittenResponse } from './chunk-AEQQ7VPF.js';
-import './chunk-UIGIYYGY.js';
+export { ThemeProvider, darkTheme, defaultTheme, useTheme } from './chunk-B3FUUKZ2.js';
+export { ActivitySequence } from './chunk-NBFTCGQ5.js';
+export { MultipleChoice } from './chunk-5SYL5CJ2.js';
+export { FillInTheBlanks } from './chunk-3DNJDP73.js';
+export { WrittenResponse } from './chunk-67WDTQMG.js';
+import './chunk-6F4X2NKL.js';
+export { StimulusPanel } from './chunk-UQ3BBEIT.js';
+import './chunk-GB5URWM4.js';
 export { useActivityState } from './chunk-5HVUKXF3.js';
 export { useXAPI } from './chunk-E4MNA2IQ.js';
-export { ThemeProvider, darkTheme, defaultTheme, useTheme } from './chunk-B3FUUKZ2.js';
 
 // src/components/types.ts
 function asRenderable(redacted) {
   return redacted;
 }
+function asRenderableSequence(entries) {
+  return entries;
+}
 
-export { asRenderable };
+export { asRenderable, asRenderableSequence };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/components/types.ts"],"names":[],"mappings":";;;;;;;;;;AAqHO,SAAS,aACd,QAAA,EACmB;AACnB,EAAA,OAAO,QAAA;AACT","file":"index.js","sourcesContent":["import type {\n  ActivityData,\n  ActivityResult,\n  InteractionEvent,\n  ItemOutcome,\n  LearnerResponse,\n  RedactedActivityData,\n  ThemeTokens,\n} from '@intellectif/lk-core';\n\n/**\n * How an activity is being presented. This is the single switch that decides\n * whether the component may grade, reveal, or submit — the three things a\n * summative exam must take away from the client.\n *\n * - `practice` (default, v1 behaviour): the component owns the attempt. It\n *   scores locally on submit, reveals correctness and feedback, and calls\n *   `onComplete` with a full {@link ActivityResult}.\n * - `exam`: the component NEVER scores and NEVER reveals correctness. Submit\n *   emits the raw learner response through `onSubmit`; the server grades it.\n *   Safe to render redacted data, because nothing here needs the answer key.\n * - `review`: read-only. Renders the learner's submitted answer, and marks\n *   correctness only from an `outcome` the caller supplies (which the server\n *   computed). Nothing is submittable.\n */\nexport type RenderMode = 'practice' | 'exam' | 'review';\n\n/**\n * Makes the answer-key-bearing parts of an activity optional, so a component\n * can render either full activity data OR a `redact()` projection with the\n * same props. Fields the SDK classifies `answer-key` become optional here;\n * a component in `exam` mode must not read them at all.\n */\nexport type Renderable<TData> = Omit<TData, 'scoringStrategy'> & {\n  scoringStrategy?: unknown;\n  /** Present on a `redact()` projection. */\n  redacted?: true;\n};\n\n/**\n * Sanitiser for author-supplied rich text (`questionHtml`, `passageHtml`,\n * `promptHtml`). The SDK deliberately ships NO sanitiser — that would add a\n * dependency and, worse, a false promise. Rich text is rendered only when you\n * supply this function; without it the component falls back to the plain-text\n * field, which is always escaped. Fail-safe by construction: the SDK never\n * injects HTML it was not explicitly given a sanitiser for.\n */\nexport type HtmlSanitizer = (html: string) => string;\n\n/**\n * The prop contract shared by every activity component (Req 3.1). Defined\n * here (React-specific) rather than in lk-core, which is React-free.\n *\n * Controlled / uncontrolled follows the React convention: pass `value` +\n * `onChange` to own the learner's answer (restore an in-progress attempt,\n * autosave a delta, drive a review); pass `defaultValue` to seed an\n * uncontrolled component; pass neither for the v1 behaviour.\n */\nexport interface ActivityProps<TData extends ActivityData = ActivityData> {\n  /** Activity content. Accepts a `redact()` projection in `exam` mode. */\n  data: Renderable<TData>;\n  /**\n   * Called when the component scored the attempt itself. Only ever fires in\n   * `practice` mode — in `exam` mode the client does not grade, so there is\n   * no `ActivityResult` to give you; use `onSubmit`.\n   */\n  onComplete?: (result: ActivityResult) => void;\n  /**\n   * Called on submit with the raw learner response and no grade. Fires in\n   * every mode, before `onComplete`, so an exam runner can persist the\n   * response and let the server score it.\n   */\n  onSubmit?: (response: LearnerResponse) => void;\n  /** Controlled value: the learner's current response. */\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  /** Presentation mode. Defaults to `practice`. */\n  renderMode?: RenderMode;\n  /**\n   * Server-computed outcome, used by `review` mode to mark correctness\n   * without the client ever scoring. Ignored in other modes.\n   */\n  outcome?: ItemOutcome;\n  /** Renders author-supplied rich text when provided. See {@link 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 * Bridges a server-produced `redact()` projection into the `data` prop.\n *\n * `RedactedActivityData` is deliberately index-signature typed in lk-core — it\n * proves a payload is learner-safe, not what shape it has — so TypeScript\n * cannot know it still carries the public fields a renderer needs. This is the\n * SDK's single, documented crossing of that gap, so an exam runner does not\n * have to write `as unknown as` at every call site:\n *\n * ```tsx\n * <MultipleChoice\n *   data={asRenderable<MultipleChoiceData>(redactedFromServer)}\n *   renderMode=\"exam\"\n *   onSubmit={persist}\n * />\n * ```\n *\n * Safe because `exam` mode reads only public fields; the answer-key fields the\n * type claims are exactly the ones the component is forbidden to touch there.\n * A future release will derive per-type redacted interfaces so this becomes\n * unnecessary.\n */\nexport function asRenderable<TData extends ActivityData>(\n  redacted: RedactedActivityData,\n): Renderable<TData> {\n  return redacted as unknown as Renderable<TData>;\n}\n"]}
+{"version":3,"sources":["../src/components/types.ts"],"names":[],"mappings":";;;;;;;;;;;;AA2IO,SAAS,aACd,QAAA,EACmB;AACnB,EAAA,OAAO,QAAA;AACT;AA4BO,SAAS,qBACd,OAAA,EAC8C;AAC9C,EAAA,OAAO,OAAA;AACT","file":"index.js","sourcesContent":["import type {\n  ActivityData,\n  ActivityResult,\n  InteractionEvent,\n  ItemGroup,\n  ItemOutcome,\n  LearnerResponse,\n  RedactedActivityData,\n  SequenceEntry,\n  ThemeTokens,\n} from '@intellectif/lk-core';\n\n/**\n * How an activity is being presented. This is the single switch that decides\n * whether the component may grade, reveal, or submit — the three things a\n * summative exam must take away from the client.\n *\n * - `practice` (default, v1 behaviour): the component owns the attempt. It\n *   scores locally on submit, reveals correctness and feedback, and calls\n *   `onComplete` with a full {@link ActivityResult}.\n * - `exam`: the component NEVER scores and NEVER reveals correctness. Submit\n *   emits the raw learner response through `onSubmit`; the server grades it.\n *   Safe to render redacted data, because nothing here needs the answer key.\n * - `review`: read-only. Renders the learner's submitted answer, and marks\n *   correctness only from an `outcome` the caller supplies (which the server\n *   computed). Nothing is submittable.\n */\nexport type RenderMode = 'practice' | 'exam' | 'review';\n\n/**\n * Makes the answer-key-bearing parts of an activity optional, so a component\n * can render either full activity data OR a `redact()` projection with the\n * same props. Fields the SDK classifies `answer-key` become optional here;\n * a component in `exam` mode must not read them at all.\n */\nexport type Renderable<TData> = Omit<TData, 'scoringStrategy'> & {\n  scoringStrategy?: unknown;\n  /** Present on a `redact()` projection. */\n  redacted?: true;\n};\n\n/**\n * {@link Renderable} DISTRIBUTED over a union of activity types.\n *\n * This distinction is load-bearing, not cosmetic. `Renderable<T>` is built on\n * `Omit`, and `Omit` does not distribute: `Omit<A | B, K>` collapses to the\n * keys A and B have IN COMMON, so `Renderable<ActivityData>` is a single\n * object type carrying only the fields every activity shares. Narrowing it\n * dies with it — after `if (data.type === 'multiple-choice')` the compiler\n * still refuses `data.options`, because the union it would narrow to no\n * longer exists.\n *\n * The conditional below re-distributes, so `RenderableActivity` is a real\n * union of per-type renderables and `.type` narrows again. Anything that\n * accepts \"some renderable activity, I don't know which\" — a custom renderer,\n * a sequence entry — must use THIS, not `Renderable<ActivityData>`.\n */\nexport type RenderableActivity<TData extends ActivityData = ActivityData> = TData extends unknown\n  ? Renderable<TData>\n  : never;\n\n/**\n * Sanitiser for author-supplied rich text (`questionHtml`, `passageHtml`,\n * `promptHtml`). The SDK deliberately ships NO sanitiser — that would add a\n * dependency and, worse, a false promise. Rich text is rendered only when you\n * supply this function; without it the component falls back to the plain-text\n * field, which is always escaped. Fail-safe by construction: the SDK never\n * injects HTML it was not explicitly given a sanitiser for.\n */\nexport type HtmlSanitizer = (html: string) => string;\n\n/**\n * The prop contract shared by every activity component (Req 3.1). Defined\n * here (React-specific) rather than in lk-core, which is React-free.\n *\n * Controlled / uncontrolled follows the React convention: pass `value` +\n * `onChange` to own the learner's answer (restore an in-progress attempt,\n * autosave a delta, drive a review); pass `defaultValue` to seed an\n * uncontrolled component; pass neither for the v1 behaviour.\n */\nexport interface ActivityProps<TData extends ActivityData = ActivityData> {\n  /** Activity content. Accepts a `redact()` projection in `exam` mode. */\n  data: RenderableActivity<TData>;\n  /**\n   * Called when the component scored the attempt itself. Only ever fires in\n   * `practice` mode — in `exam` mode the client does not grade, so there is\n   * no `ActivityResult` to give you; use `onSubmit`.\n   */\n  onComplete?: (result: ActivityResult) => void;\n  /**\n   * Called on submit with the raw learner response and no grade. Fires in\n   * every mode, before `onComplete`, so an exam runner can persist the\n   * response and let the server score it.\n   */\n  onSubmit?: (response: LearnerResponse) => void;\n  /** Controlled value: the learner's current response. */\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  /** Presentation mode. Defaults to `practice`. */\n  renderMode?: RenderMode;\n  /**\n   * Server-computed outcome, used by `review` mode to mark correctness\n   * without the client ever scoring. Ignored in other modes.\n   */\n  outcome?: ItemOutcome;\n  /** Renders author-supplied rich text when provided. See {@link 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 * Bridges a server-produced `redact()` projection into the `data` prop.\n *\n * `RedactedActivityData` is deliberately index-signature typed in lk-core — it\n * proves a payload is learner-safe, not what shape it has — so TypeScript\n * cannot know it still carries the public fields a renderer needs. This is the\n * SDK's single, documented crossing of that gap, so an exam runner does not\n * have to write `as unknown as` at every call site:\n *\n * ```tsx\n * <MultipleChoice\n *   data={asRenderable<MultipleChoiceData>(redactedFromServer)}\n *   renderMode=\"exam\"\n *   onSubmit={persist}\n * />\n * ```\n *\n * Safe because `exam` mode reads only public fields; the answer-key fields the\n * type claims are exactly the ones the component is forbidden to touch there.\n * A future release will derive per-type redacted interfaces so this becomes\n * unnecessary.\n */\nexport function asRenderable<TData extends ActivityData>(\n  redacted: RedactedActivityData,\n): Renderable<TData> {\n  return redacted as unknown as Renderable<TData>;\n}\n\n/**\n * The same bridge as {@link asRenderable}, for a whole sequence: activities\n * and item groups as a server hands them over, ready for `<ActivitySequence>`.\n *\n * Needed for the same reason and no other. `redactItemGroup` returns\n * `ItemGroup<RedactedActivityData>`, and `RedactedActivityData` is an\n * index-signature type whose fields are all `unknown` — so its `question` is\n * not a `string` and it satisfies no per-type renderable, however the prop is\n * widened. Widening alone cannot fix this; a crossing point is required, and\n * having exactly one keeps `as unknown as` out of consumer code.\n *\n * ```tsx\n * const entries = await fetchExam();            // redacted, server-side\n * <ActivitySequence\n *   activities={asRenderableSequence(entries)}\n *   renderMode=\"exam\"                           // REQUIRED: see below\n *   shuffleSeed={attemptId}\n *   onSubmit={persist}\n * />\n * ```\n *\n * Pass `renderMode=\"exam\"` (or `\"review\"`). Redacted data has no answer key,\n * and the default `practice` mode grades locally — the built-in components\n * throw at render rather than fail at submit time, so a mis-wired exam item is\n * loud, not silent.\n */\nexport function asRenderableSequence(\n  entries: readonly (RedactedActivityData | RedactedItemGroupData)[],\n): readonly SequenceEntry<RenderableActivity>[] {\n  return entries as unknown as readonly SequenceEntry<RenderableActivity>[];\n}\n\n/** Structural shape of a `redactItemGroup()` projection, as it arrives from a server. */\ntype RedactedItemGroupData = ItemGroup<RedactedActivityData> & { redacted: true };\n"]}

package/dist/theme/skin.css

@@ -111,6 +111,55 @@
     cursor: default;
   }
 
+  /* ── Shared stimulus (an item group's passage / recording / image) ──── */
+  .lk-stimulus {
+    margin: 0 0 var(--lk-spacing-lg);
+    padding: var(--lk-spacing-md) var(--lk-spacing-lg);
+    background: var(--lk-color-surface-raised);
+    border: 1px solid var(--lk-color-border);
+    border-radius: var(--lk-radius-base);
+  }
+
+  .lk-stimulus-title {
+    margin: 0 0 var(--lk-spacing-xs);
+    font-size: var(--lk-font-size-lg);
+    font-weight: var(--lk-font-weight-bold);
+  }
+
+  .lk-stimulus-range {
+    margin: 0 0 var(--lk-spacing-md);
+    font-size: var(--lk-font-size-sm);
+    color: var(--lk-color-text-muted);
+  }
+
+  .lk-stimulus .lk-media {
+    margin-bottom: var(--lk-spacing-md);
+  }
+
+  .lk-stimulus-body {
+    margin: 0;
+    line-height: var(--lk-line-height-base);
+  }
+
+  /* A plain-text passage keeps its authored paragraph breaks. */
+  .lk-stimulus-body[data-format="text"] {
+    white-space: pre-wrap;
+  }
+
+  .lk-stimulus-body[data-format="html"] > :first-child {
+    margin-top: 0;
+  }
+
+  .lk-stimulus-body[data-format="html"] > :last-child {
+    margin-bottom: 0;
+  }
+
+  .lk-stimulus-attribution {
+    margin: var(--lk-spacing-sm) 0 0;
+    font-size: var(--lk-font-size-sm);
+    color: var(--lk-color-text-muted);
+  }
+
   /* ── Multiple choice options ─────────────────────────────────────────── */
   .lk-mc-option {
     display: flex;

package/dist/{types-CNmjqD6M.d.cts → types-CrURyd9-.d.cts}

@@ -1,4 +1,4 @@
-import { ActivityData, ActivityResult, LearnerResponse, ItemOutcome, InteractionEvent, ThemeTokens, RedactedActivityData } from '@intellectif/lk-core';
+import { ActivityData, ActivityResult, LearnerResponse, ItemOutcome, InteractionEvent, ThemeTokens, RedactedActivityData, ItemGroup, SequenceEntry } from '@intellectif/lk-core';
 
 /**
  * How an activity is being presented. This is the single switch that decides
@@ -27,6 +27,23 @@ type Renderable<TData> = Omit<TData, 'scoringStrategy'> & {
     /** Present on a `redact()` projection. */
     redacted?: true;
 };
+/**
+ * {@link Renderable} DISTRIBUTED over a union of activity types.
+ *
+ * This distinction is load-bearing, not cosmetic. `Renderable<T>` is built on
+ * `Omit`, and `Omit` does not distribute: `Omit<A | B, K>` collapses to the
+ * keys A and B have IN COMMON, so `Renderable<ActivityData>` is a single
+ * object type carrying only the fields every activity shares. Narrowing it
+ * dies with it — after `if (data.type === 'multiple-choice')` the compiler
+ * still refuses `data.options`, because the union it would narrow to no
+ * longer exists.
+ *
+ * The conditional below re-distributes, so `RenderableActivity` is a real
+ * union of per-type renderables and `.type` narrows again. Anything that
+ * accepts "some renderable activity, I don't know which" — a custom renderer,
+ * a sequence entry — must use THIS, not `Renderable<ActivityData>`.
+ */
+type RenderableActivity<TData extends ActivityData = ActivityData> = TData extends unknown ? Renderable<TData> : never;
 /**
  * Sanitiser for author-supplied rich text (`questionHtml`, `passageHtml`,
  * `promptHtml`). The SDK deliberately ships NO sanitiser — that would add a
@@ -47,7 +64,7 @@ type HtmlSanitizer = (html: string) => string;
  */
 interface ActivityProps<TData extends ActivityData = ActivityData> {
     /** Activity content. Accepts a `redact()` projection in `exam` mode. */
-    data: Renderable<TData>;
+    data: RenderableActivity<TData>;
     /**
      * Called when the component scored the attempt itself. Only ever fires in
      * `practice` mode — in `exam` mode the client does not grade, so there is
@@ -104,5 +121,36 @@ interface ActivityProps<TData extends ActivityData = ActivityData> {
  * unnecessary.
  */
 declare function asRenderable<TData extends ActivityData>(redacted: RedactedActivityData): Renderable<TData>;
+/**
+ * The same bridge as {@link asRenderable}, for a whole sequence: activities
+ * and item groups as a server hands them over, ready for `<ActivitySequence>`.
+ *
+ * Needed for the same reason and no other. `redactItemGroup` returns
+ * `ItemGroup<RedactedActivityData>`, and `RedactedActivityData` is an
+ * index-signature type whose fields are all `unknown` — so its `question` is
+ * not a `string` and it satisfies no per-type renderable, however the prop is
+ * widened. Widening alone cannot fix this; a crossing point is required, and
+ * having exactly one keeps `as unknown as` out of consumer code.
+ *
+ * ```tsx
+ * const entries = await fetchExam();            // redacted, server-side
+ * <ActivitySequence
+ *   activities={asRenderableSequence(entries)}
+ *   renderMode="exam"                           // REQUIRED: see below
+ *   shuffleSeed={attemptId}
+ *   onSubmit={persist}
+ * />
+ * ```
+ *
+ * Pass `renderMode="exam"` (or `"review"`). Redacted data has no answer key,
+ * and the default `practice` mode grades locally — the built-in components
+ * throw at render rather than fail at submit time, so a mis-wired exam item is
+ * loud, not silent.
+ */
+declare function asRenderableSequence(entries: readonly (RedactedActivityData | RedactedItemGroupData)[]): readonly SequenceEntry<RenderableActivity>[];
+/** Structural shape of a `redactItemGroup()` projection, as it arrives from a server. */
+type RedactedItemGroupData = ItemGroup<RedactedActivityData> & {
+    redacted: true;
+};
 
-export { type ActivityProps as A, type HtmlSanitizer as H, type RenderMode as R, type Renderable as a, asRenderable as b };
+export { type ActivityProps as A, type HtmlSanitizer as H, type RenderMode as R, type Renderable as a, type RenderableActivity as b, asRenderable as c, asRenderableSequence as d };

package/dist/{types-CNmjqD6M.d.ts → types-CrURyd9-.d.ts}

@@ -1,4 +1,4 @@
-import { ActivityData, ActivityResult, LearnerResponse, ItemOutcome, InteractionEvent, ThemeTokens, RedactedActivityData } from '@intellectif/lk-core';
+import { ActivityData, ActivityResult, LearnerResponse, ItemOutcome, InteractionEvent, ThemeTokens, RedactedActivityData, ItemGroup, SequenceEntry } from '@intellectif/lk-core';
 
 /**
  * How an activity is being presented. This is the single switch that decides
@@ -27,6 +27,23 @@ type Renderable<TData> = Omit<TData, 'scoringStrategy'> & {
     /** Present on a `redact()` projection. */
     redacted?: true;
 };
+/**
+ * {@link Renderable} DISTRIBUTED over a union of activity types.
+ *
+ * This distinction is load-bearing, not cosmetic. `Renderable<T>` is built on
+ * `Omit`, and `Omit` does not distribute: `Omit<A | B, K>` collapses to the
+ * keys A and B have IN COMMON, so `Renderable<ActivityData>` is a single
+ * object type carrying only the fields every activity shares. Narrowing it
+ * dies with it — after `if (data.type === 'multiple-choice')` the compiler
+ * still refuses `data.options`, because the union it would narrow to no
+ * longer exists.
+ *
+ * The conditional below re-distributes, so `RenderableActivity` is a real
+ * union of per-type renderables and `.type` narrows again. Anything that
+ * accepts "some renderable activity, I don't know which" — a custom renderer,
+ * a sequence entry — must use THIS, not `Renderable<ActivityData>`.
+ */
+type RenderableActivity<TData extends ActivityData = ActivityData> = TData extends unknown ? Renderable<TData> : never;
 /**
  * Sanitiser for author-supplied rich text (`questionHtml`, `passageHtml`,
  * `promptHtml`). The SDK deliberately ships NO sanitiser — that would add a
@@ -47,7 +64,7 @@ type HtmlSanitizer = (html: string) => string;
  */
 interface ActivityProps<TData extends ActivityData = ActivityData> {
     /** Activity content. Accepts a `redact()` projection in `exam` mode. */
-    data: Renderable<TData>;
+    data: RenderableActivity<TData>;
     /**
      * Called when the component scored the attempt itself. Only ever fires in
      * `practice` mode — in `exam` mode the client does not grade, so there is
@@ -104,5 +121,36 @@ interface ActivityProps<TData extends ActivityData = ActivityData> {
  * unnecessary.
  */
 declare function asRenderable<TData extends ActivityData>(redacted: RedactedActivityData): Renderable<TData>;
+/**
+ * The same bridge as {@link asRenderable}, for a whole sequence: activities
+ * and item groups as a server hands them over, ready for `<ActivitySequence>`.
+ *
+ * Needed for the same reason and no other. `redactItemGroup` returns
+ * `ItemGroup<RedactedActivityData>`, and `RedactedActivityData` is an
+ * index-signature type whose fields are all `unknown` — so its `question` is
+ * not a `string` and it satisfies no per-type renderable, however the prop is
+ * widened. Widening alone cannot fix this; a crossing point is required, and
+ * having exactly one keeps `as unknown as` out of consumer code.
+ *
+ * ```tsx
+ * const entries = await fetchExam();            // redacted, server-side
+ * <ActivitySequence
+ *   activities={asRenderableSequence(entries)}
+ *   renderMode="exam"                           // REQUIRED: see below
+ *   shuffleSeed={attemptId}
+ *   onSubmit={persist}
+ * />
+ * ```
+ *
+ * Pass `renderMode="exam"` (or `"review"`). Redacted data has no answer key,
+ * and the default `practice` mode grades locally — the built-in components
+ * throw at render rather than fail at submit time, so a mis-wired exam item is
+ * loud, not silent.
+ */
+declare function asRenderableSequence(entries: readonly (RedactedActivityData | RedactedItemGroupData)[]): readonly SequenceEntry<RenderableActivity>[];
+/** Structural shape of a `redactItemGroup()` projection, as it arrives from a server. */
+type RedactedItemGroupData = ItemGroup<RedactedActivityData> & {
+    redacted: true;
+};
 
-export { type ActivityProps as A, type HtmlSanitizer as H, type RenderMode as R, type Renderable as a, asRenderable as b };
+export { type ActivityProps as A, type HtmlSanitizer as H, type RenderMode as R, type Renderable as a, type RenderableActivity as b, asRenderable as c, asRenderableSequence as d };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intellectif/lk-react",
-  "version": "3.0.0",
+  "version": "5.0.0",
   "description": "React 19 activity components, hooks, and theming for learning-kit",
   "repository": {
     "type": "git",
@@ -52,6 +52,16 @@
         "default": "./dist/components/FillInTheBlanks.cjs"
       }
     },
+    "./components/StimulusPanel": {
+      "import": {
+        "types": "./dist/components/StimulusPanel.d.ts",
+        "default": "./dist/components/StimulusPanel.js"
+      },
+      "require": {
+        "types": "./dist/components/StimulusPanel.d.cts",
+        "default": "./dist/components/StimulusPanel.cjs"
+      }
+    },
     "./components/WrittenResponse": {
       "import": {
         "types": "./dist/components/WrittenResponse.d.ts",
@@ -105,7 +115,7 @@
   "peerDependencies": {
     "react": "^19",
     "react-dom": "^19",
-    "@intellectif/lk-core": "^0.4.0"
+    "@intellectif/lk-core": "^0.6.0"
   },
   "devDependencies": {
     "@axe-core/react": "^4.10.0",
@@ -124,7 +134,7 @@
     "tsup": "^8.3.0",
     "vitest": "^4.1.6",
     "vitest-axe": "^0.1.0",
-    "@intellectif/lk-core": "0.4.0"
+    "@intellectif/lk-core": "0.6.0"
   },
   "license": "MIT",
   "engines": {
@@ -137,6 +147,7 @@
     "lint": "biome check .",
     "e2e": "playwright test -c ../../playwright.config.ts",
     "publint": "publint",
-    "attw": "attw --pack . --ignore-rules no-resolution --exclude-entrypoints \"theme/defaults.css\" \"theme/skin.css\""
+    "attw": "attw --pack . --ignore-rules no-resolution --exclude-entrypoints \"theme/defaults.css\" \"theme/skin.css\"",
+    "typecheck": "tsc -p tsconfig.typecheck.json"
   }
 }

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

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