@intellectif/lk-react 2.1.0 → 4.0.0

package/dist/components/ActivitySequence.d.ts

@@ -1,14 +1,135 @@
-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, 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
+ * of activity exist: those the SDK scores at submit time, and those a grader
+ * scores later. Collapsing them would mean inventing a score for ungraded
+ * work — the exact defect the deferred outcome exists to prevent.
+ */
+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
+ * activity `type` to put a consumer-defined type on screen — the React half of
+ * the activity-type registry, matching `registerActivityType` in lk-core.
+ */
+type ActivityRenderer = ComponentType<ActivityProps>;
 interface ActivitySequenceProps {
-    /** The ordered set of activities to present, one at a time. */
-    activities: ActivityData[];
-    /** Called whenever an individual activity is completed. */
-    onActivityComplete?: (result: ActivityResult, index: number) => void;
-    /** Called once every activity in the set has been completed. */
+    /**
+     * 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 — 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. It also carries `slotId` per item, which
+     * this callback's bare array cannot.
+     */
     onComplete?: (results: ActivityResult[]) => void;
+    /**
+     * Called once every activity has been completed, whether it was scored at
+     * submit time or submitted for later grading. Use this for any set that
+     * mixes graded and deferred-graded activities.
+     */
+    onFinished?: (items: SequenceItemOutcome[]) => void;
     /** Forwarded to each activity. */
     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;
@@ -19,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, onActivityComplete, onComplete, onInteraction, 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 { ActivitySequence, type ActivitySequenceProps };
+export { type ActivityRenderer, ActivitySequence, type ActivitySequenceProps, type SequenceItemOutcome };

package/dist/components/ActivitySequence.js

@@ -1,7 +1,10 @@
-export { ActivitySequence } from '../chunk-UASXUWHH.js';
-import '../chunk-ZVFWJTT4.js';
-import '../chunk-3X7MYAFT.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 chunk7BT6OXAR_cjs = require('../chunk-7BT6OXAR.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 chunk7BT6OXAR_cjs.WrittenResponse; }
+  get: function () { return chunkXQJFLAMD_cjs.WrittenResponse; }
 });
 //# sourceMappingURL=WrittenResponse.cjs.map
 //# sourceMappingURL=WrittenResponse.cjs.map

package/dist/components/WrittenResponse.d.cts

@@ -1,89 +1,8 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { WrittenResponseData, XAPIStatement, LearnerResponse, ItemOutcome, InteractionEvent, ThemeTokens } from '@intellectif/lk-core';
-import { a as Renderable, R as RenderMode, H as HtmlSanitizer } from '../types-CNmjqD6M.cjs';
-
-/**
- * Payload delivered when the learner submits a written response. Grading is
- * DEFERRED (asynchronous AI/human grading), so there is no score here — and
- * deliberately no fake one: an ungraded submission must never be shown or
- * stored as a 0. The consumer persists `text` and grades it out-of-band.
- */
-interface WrittenResponseSubmission {
-    /** The submitted text, verbatim. */
-    text: string;
-    /** Word count of `text`, recomputed with the canonical `countWords()`. */
-    wordCount: number;
-    /** Whether `wordCount` falls within the activity's `[minWords, maxWords]`. */
-    withinWordBounds: boolean;
-    /** Time in milliseconds from first interaction to submission. */
-    timeSpent: number;
-    /** The SUBMITTED-verb xAPI statement built for this submission (no score fields). */
-    xapiStatement: XAPIStatement;
-}
-/**
- * Props for {@link WrittenResponse}. Mirrors `ActivityProps` except for the
- * completion callback: a deferred-grading activity completes with a
- * {@link WrittenResponseSubmission} (`onSubmitted`), not a scored
- * `ActivityResult` (`onComplete`) — deviation from Req 22.8 recorded in the
- * roadmap (§3.1): fabricating a score of 0 for ungraded work is the exact
- * bug this type exists to fix. Everything else — controlled value, render
- * mode, server outcome, rich text — follows the shared `ActivityProps`
- * contract verbatim.
- */
-interface WrittenResponseProps {
-    /** Activity content. Accepts a `redact()` projection in `exam` mode. */
-    data: Renderable<WrittenResponseData>;
-    /**
-     * Called on submit with the ungraded submission (text, recomputed word
-     * count, bounds flag, timing, xAPI statement). Fires in `practice` and
-     * `exam` mode, after `onSubmit`; never in `review`.
-     *
-     * Optional since v0.4 so a `review`-mode render (which has no submit
-     * control) and an exam runner that only wants the raw response through
-     * `onSubmit` do not have to pass a no-op. Supply it in `practice`/`exam`
-     * unless `onSubmit` already captures everything you persist.
-     */
-    onSubmitted?: (submission: WrittenResponseSubmission) => void;
-    /**
-     * Called on submit with the raw learner response and no grade, BEFORE
-     * `onSubmitted`. This is the only submit callback an exam runner needs:
-     * the server grades the text and returns an {@link ItemOutcome} later.
-     */
-    onSubmit?: (response: LearnerResponse) => void;
-    /**
-     * Controlled value: the learner's current response. When present the
-     * textarea renders from it (never from internal state) and every keystroke
-     * goes out through `onChange` — restore an in-progress attempt, autosave a
-     * delta, or drive a review render with it.
-     */
-    value?: LearnerResponse;
-    /** Initial response for an uncontrolled component (ignored when `value` is set). */
-    defaultValue?: LearnerResponse;
-    /** Fires on every change to the learner's response. Required for a controlled component. */
-    onChange?: (response: LearnerResponse) => void;
-    /**
-     * Presentation mode, default `practice`. `practice` and `exam` are nearly
-     * identical here — a written response is never graded client-side, so
-     * there is no local score to withhold; `exam` additionally never calls
-     * `evaluate()` and renders happily from a `redact()` projection.
-     * `review` is read-only and shows the server's `outcome`.
-     */
-    renderMode?: RenderMode;
-    /**
-     * Server-computed outcome, rendered by `review` mode: `deferred` shows a
-     * "not graded yet" affordance, `scored` shows the returned grade and
-     * feedback. Ignored in other modes — this component never manufactures an
-     * outcome of its own.
-     */
-    outcome?: ItemOutcome;
-    /** Renders `data.promptHtml` when provided. See `HtmlSanitizer`. */
-    sanitizeHtml?: HtmlSanitizer;
-    onInteraction?: (event: InteractionEvent) => void;
-    /** Per-instance token overrides, applied as inline CSS vars on the root. */
-    theme?: Partial<ThemeTokens>;
-    locale?: string;
-    disabled?: boolean;
-}
+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';
 
 /**
  * Public Written Response activity: a labelled textarea with a live word
@@ -93,4 +12,4 @@ interface WrittenResponseProps {
  */
 declare function WrittenResponse(props: WrittenResponseProps): react_jsx_runtime.JSX.Element;
 
-export { HtmlSanitizer, RenderMode, Renderable, WrittenResponse, type WrittenResponseProps, type WrittenResponseSubmission };
+export { WrittenResponse, WrittenResponseProps };

package/dist/components/WrittenResponse.d.ts

@@ -1,89 +1,8 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { WrittenResponseData, XAPIStatement, LearnerResponse, ItemOutcome, InteractionEvent, ThemeTokens } from '@intellectif/lk-core';
-import { a as Renderable, R as RenderMode, H as HtmlSanitizer } from '../types-CNmjqD6M.js';
-
-/**
- * Payload delivered when the learner submits a written response. Grading is
- * DEFERRED (asynchronous AI/human grading), so there is no score here — and
- * deliberately no fake one: an ungraded submission must never be shown or
- * stored as a 0. The consumer persists `text` and grades it out-of-band.
- */
-interface WrittenResponseSubmission {
-    /** The submitted text, verbatim. */
-    text: string;
-    /** Word count of `text`, recomputed with the canonical `countWords()`. */
-    wordCount: number;
-    /** Whether `wordCount` falls within the activity's `[minWords, maxWords]`. */
-    withinWordBounds: boolean;
-    /** Time in milliseconds from first interaction to submission. */
-    timeSpent: number;
-    /** The SUBMITTED-verb xAPI statement built for this submission (no score fields). */
-    xapiStatement: XAPIStatement;
-}
-/**
- * Props for {@link WrittenResponse}. Mirrors `ActivityProps` except for the
- * completion callback: a deferred-grading activity completes with a
- * {@link WrittenResponseSubmission} (`onSubmitted`), not a scored
- * `ActivityResult` (`onComplete`) — deviation from Req 22.8 recorded in the
- * roadmap (§3.1): fabricating a score of 0 for ungraded work is the exact
- * bug this type exists to fix. Everything else — controlled value, render
- * mode, server outcome, rich text — follows the shared `ActivityProps`
- * contract verbatim.
- */
-interface WrittenResponseProps {
-    /** Activity content. Accepts a `redact()` projection in `exam` mode. */
-    data: Renderable<WrittenResponseData>;
-    /**
-     * Called on submit with the ungraded submission (text, recomputed word
-     * count, bounds flag, timing, xAPI statement). Fires in `practice` and
-     * `exam` mode, after `onSubmit`; never in `review`.
-     *
-     * Optional since v0.4 so a `review`-mode render (which has no submit
-     * control) and an exam runner that only wants the raw response through
-     * `onSubmit` do not have to pass a no-op. Supply it in `practice`/`exam`
-     * unless `onSubmit` already captures everything you persist.
-     */
-    onSubmitted?: (submission: WrittenResponseSubmission) => void;
-    /**
-     * Called on submit with the raw learner response and no grade, BEFORE
-     * `onSubmitted`. This is the only submit callback an exam runner needs:
-     * the server grades the text and returns an {@link ItemOutcome} later.
-     */
-    onSubmit?: (response: LearnerResponse) => void;
-    /**
-     * Controlled value: the learner's current response. When present the
-     * textarea renders from it (never from internal state) and every keystroke
-     * goes out through `onChange` — restore an in-progress attempt, autosave a
-     * delta, or drive a review render with it.
-     */
-    value?: LearnerResponse;
-    /** Initial response for an uncontrolled component (ignored when `value` is set). */
-    defaultValue?: LearnerResponse;
-    /** Fires on every change to the learner's response. Required for a controlled component. */
-    onChange?: (response: LearnerResponse) => void;
-    /**
-     * Presentation mode, default `practice`. `practice` and `exam` are nearly
-     * identical here — a written response is never graded client-side, so
-     * there is no local score to withhold; `exam` additionally never calls
-     * `evaluate()` and renders happily from a `redact()` projection.
-     * `review` is read-only and shows the server's `outcome`.
-     */
-    renderMode?: RenderMode;
-    /**
-     * Server-computed outcome, rendered by `review` mode: `deferred` shows a
-     * "not graded yet" affordance, `scored` shows the returned grade and
-     * feedback. Ignored in other modes — this component never manufactures an
-     * outcome of its own.
-     */
-    outcome?: ItemOutcome;
-    /** Renders `data.promptHtml` when provided. See `HtmlSanitizer`. */
-    sanitizeHtml?: HtmlSanitizer;
-    onInteraction?: (event: InteractionEvent) => void;
-    /** Per-instance token overrides, applied as inline CSS vars on the root. */
-    theme?: Partial<ThemeTokens>;
-    locale?: string;
-    disabled?: boolean;
-}
+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';
 
 /**
  * Public Written Response activity: a labelled textarea with a live word
@@ -93,4 +12,4 @@ interface WrittenResponseProps {
  */
 declare function WrittenResponse(props: WrittenResponseProps): react_jsx_runtime.JSX.Element;
 
-export { HtmlSanitizer, RenderMode, Renderable, WrittenResponse, type WrittenResponseProps, type WrittenResponseSubmission };
+export { WrittenResponse, WrittenResponseProps };

package/dist/components/WrittenResponse.js

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