@intellectif/lk-react 18.0.0 → 18.1.0

package/CHANGELOG.md

@@ -1,5 +1,49 @@
 # @intellectif/lk-react
 
+## 18.1.0
+
+### Minor Changes
+
+- 50c3285: A question a host draws inside `<ActivitySequence>` gets everything one the SDK draws has, and the AI
+  rules are available without the SDK's buttons.
+
+  - **`renderers` overrides get a `question` prop** (`SequenceQuestion`), the pager's half of the
+    contract, as `renderQuestion` gave one to `<InteractiveVideo>` in 16.1.0:
+    - `active` — whether this is the question on screen. **Stop the microphone, any timer and any
+      speech when it turns `false`:** the pager pauses the media inside the question and stops the
+      recorders the SDK started, but cannot reach one it did not create;
+    - `setPending(true/false)` — work of your own is on its way (an upload, a save, a judgement).
+      `onFinished` and `onComplete` wait for it, so a set is never reported a moment before the last
+      answer settles. Call it with `false` however the work ends, a failure included;
+    - `portalContainer` — a node inside this question's own pane. Portal a popover into it rather than
+      into `document.body`, and it is hidden when the learner pages away and painted with the question
+      in fullscreen;
+    - `clear()` — the learner withdrew their answer: the slot holds nothing again, and the set is
+      unfinished until it is answered again;
+    - `emit(type, payload?)` — an interaction, with this question's `activityId` and the time filled
+      in;
+    - `slot` — the identity to store the answer against, the same object `onSubmit` is handed.
+  - **Every call keeps one identity for the life of the set**, `onSubmit` and `onComplete` included, so
+    a renderer may hold them in an effect and a host that re-renders on every keystroke does not re-run
+    it.
+  - **New: `useAiHints` and `useAiExplanation`** (`@intellectif/lk-react/ai/useAiHelp`, also on the
+    root) — AI help for a question you draw yourself: the same rules, facts, checks and records the
+    bundled components use, with your own markup. `ask` does nothing where the rules say no, so a page
+    drawing its own button reaches no model in an `exam`. The SDK's own components are built on these
+    hooks, so there is one implementation of the rules and not two.
+  - **The paper decides the mode.** A question inside `<ActivitySequence>` or `<InteractiveVideo>` now
+    knows the mode it is being delivered in, so the hooks refuse help on an `exam` paper even when the
+    host does not pass `renderMode` to them, or passes `practice` — which a component that defaults it
+    can do inside an exam. Without that, a host's own question under an `LkAiProvider` could reach a
+    model on a paper of record.
+
+  `ActivityRenderer` is now `ComponentType<ActivityProps & { question?: SequenceQuestion }>`. A
+  renderer written as `ComponentType<ActivityProps>` still fits and simply ignores the new prop; only
+  assigning an `ActivityRenderer` _back_ to a `ComponentType<ActivityProps>` variable needs a widened
+  annotation.
+
+  See `docs/ai.md` and the `renderers` documentation on `<ActivitySequence>`.
+
 ## 18.0.0
 
 ### Patch Changes

package/README.md

@@ -82,7 +82,8 @@ export function Demo() {
 - **`shuffleSeed`** — one seed drives question order *and* each item's option order, so a review render reproduces exactly the arrangement the learner sat. Shuffling in `exam` / `review` mode **requires** it.
 - **`<StimulusPanel>`** — a shared passage / recording / image (an item group's stimulus) as a landmark region; the sequence uses it, and a custom runner can too.
 - **`<ActivityPreview>`** — an editor's preview. Renders a draft in any `renderMode` with a simulated `response` (marked with `evaluate()` in `review`), and a translatable notice — or your `fallback`, handed the issues — while `validateDraft` says the draft is not finished. Nothing it renders is recorded, and a recording's play limit is counted in memory only.
-- **Custom activity types** — `renderers={{ 'my-type': MyRenderer }}` on the sequence; a key matching a built-in overrides it, so you can replace a bundled renderer without forking the sequencer.
+- **Custom activity types** — `renderers={{ 'my-type': MyRenderer }}` on the sequence; a key matching a built-in overrides it, so you can replace a bundled renderer without forking the sequencer. A renderer is given the same contract the SDK's own components have: a `question` prop that says when it is the question on screen (so it can stop its microphone), holds the set while its own work is in flight, gives it somewhere to portal a popover, and reports what the learner did through calls that keep one identity.
+- **AI help in a question you draw** — `useAiHints` and `useAiExplanation` give a host's own renderer the rules, the facts and the refusals the bundled components use, without their buttons. `ask` does nothing where the rules say no, so an exam reaches no model however the page asks.
 - **Rich text, opt-in** — `sanitizeHtml` renders author-supplied `questionHtml` / `promptHtml`. The SDK ships **no** sanitiser and injects no HTML without one; without it the escaped plain-text field is used. (`FillInTheBlanks` ignores `passageHtml` by design — its passage hosts the answer inputs.)
 - **Media per question** — optional `image` / `audio` / `video` / `embed` (YouTube/Vimeo iframe) above the question; alt-text required for `image`/`embed` (WCAG).
 - **Playback policy for listening papers** — an audio recording can declare `maxPlays`, `seek: 'none'` and `rate: 'fixed'`. The SDK then renders its own accessible transport (44px targets, a live plays-remaining status, an exhausted button that stays focusable and says why) and enforces the policy from the element's own events, so a hardware media key goes through the budget too. Wire `mediaBudget` on `<ActivitySequence>` to make a play budget survive a refresh.
@@ -116,6 +117,7 @@ export function Demo() {
 | `@intellectif/lk-react/hooks/useSpeechRecorder` | Microphone capture to 16 kHz mono WAV, and `CAPTURE_PROCESSOR_SOURCE` for a self-hosted worklet |
 | `@intellectif/lk-react/hooks/useXAPI` | LRS delivery (retry, never-throws) |
 | `@intellectif/lk-react/ai/LkAiProvider` | `<LkAiProvider>`, `useLearnerAi`, and the `LearnerAi` type |
+| `@intellectif/lk-react/ai/useAiHelp` | `useAiHints`, `useAiExplanation` — the AI rules without the SDK's own buttons |
 | `@intellectif/lk-react/i18n/LkIntlProvider` | `<LkIntlProvider>`, `useLkStrings`, `useLkDirection`, `DEFAULT_STRINGS`, `mergeStrings`, `directionForLocale` |
 | `@intellectif/lk-react/theme/ThemeProvider` | `<ThemeProvider>`, `darkTheme`, `useTheme`, `createTailwindTheme` |
 | `@intellectif/lk-react/theme/defaults.css` | Tokens (required) |

package/dist/{WrittenResponse-B4kY-U0v.d.ts → WrittenResponse-CeHY5u3W.d.ts}

@@ -1,5 +1,5 @@
 import { XAPIStatement, WrittenResponseData, LearnerResponse, ItemOutcome, InteractionEvent, ThemeTokens } from '@intellectif/lk-core';
-import { f as Renderable, e as RenderMode, H as HtmlSanitizer, M as MediaBudgetBinding, b as MediaTransportStrings, a as LkStringsOverride } from './strings-PCYKWCwd.js';
+import { f as Renderable, e as RenderMode, H as HtmlSanitizer, M as MediaBudgetBinding, b as MediaTransportStrings, a as LkStringsOverride } from './types-BY-4S5Rd.js';
 
 /**
  * Payload delivered when the learner submits a written response. Grading is

package/dist/{WrittenResponse-Dl3zah22.d.cts → WrittenResponse-DT_Yqbq1.d.cts}

@@ -1,5 +1,5 @@
 import { XAPIStatement, WrittenResponseData, LearnerResponse, ItemOutcome, InteractionEvent, ThemeTokens } from '@intellectif/lk-core';
-import { f as Renderable, e as RenderMode, H as HtmlSanitizer, M as MediaBudgetBinding, b as MediaTransportStrings, a as LkStringsOverride } from './strings-BOPKhnS-.cjs';
+import { f as Renderable, e as RenderMode, H as HtmlSanitizer, M as MediaBudgetBinding, b as MediaTransportStrings, a as LkStringsOverride } from './types-DtPYG1hh.cjs';
 
 /**
  * Payload delivered when the learner submits a written response. Grading is

package/dist/ai/useAiHelp.cjs

@@ -0,0 +1,20 @@
+'use client';
+'use strict';
+
+var chunkTL3GVPBO_cjs = require('../chunk-TL3GVPBO.cjs');
+require('../chunk-ZDYNAWDZ.cjs');
+require('../chunk-JVWLXVYG.cjs');
+require('../chunk-EANGKAKG.cjs');
+
+
+
+Object.defineProperty(exports, "useAiExplanation", {
+  enumerable: true,
+  get: function () { return chunkTL3GVPBO_cjs.useAiExplanation; }
+});
+Object.defineProperty(exports, "useAiHints", {
+  enumerable: true,
+  get: function () { return chunkTL3GVPBO_cjs.useAiHints; }
+});
+//# sourceMappingURL=useAiHelp.cjs.map
+//# sourceMappingURL=useAiHelp.cjs.map

package/dist/ai/useAiHelp.cjs.map

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

package/dist/ai/useAiHelp.d.cts

@@ -0,0 +1,146 @@
+import { AiTextResult, LearnerResponse, InteractionEvent, ItemOutcome } from '@intellectif/lk-core';
+import { g as RenderableActivity, e as RenderMode } from '../types-DtPYG1hh.cjs';
+import { LearnerAi } from './LkAiProvider.cjs';
+import '../machine-CuwKqWXC.cjs';
+import 'react';
+
+/**
+ * The question AI help is being asked about, as the SDK's own components know
+ * it. A host drawing its own question passes what it has; everything optional
+ * defaults to what the components pass.
+ */
+interface AiHelpSituation {
+    /** The question, as `data` is given to any activity component. */
+    data: RenderableActivity;
+    /** The learner's answer as it stands: submitted, restored, or being written. */
+    response: LearnerResponse;
+    /** Whether the learner has committed that answer. */
+    submitted: boolean;
+    /**
+     * Pass on the `renderMode` your question was given. Left out, the paper
+     * around the question answers for it — a question inside `<ActivitySequence>`
+     * or `<InteractiveVideo>` knows its mode — and `practice` only where there is
+     * no paper at all. An `exam` around the question wins over anything passed
+     * here.
+     */
+    renderMode?: RenderMode;
+    /**
+     * The AI ports to use, overriding {@link LkAiProvider}'s for this question.
+     * A question inside `<ActivitySequence>` or `<InteractiveVideo>` is handed
+     * the ports in force as `ai` — pass that straight in.
+     */
+    ai?: LearnerAi;
+    /** The interface language: the default language for what a model writes. */
+    locale?: string;
+    /** Where `ai-hint-shown` and `ai-explanation-shown` go. */
+    onInteraction?: (event: InteractionEvent) => void;
+}
+interface AiExplanationInput extends AiHelpSituation {
+    /** The grade of record, which `review` explains. */
+    outcome?: ItemOutcome;
+}
+interface AiExplanationHelp {
+    /**
+     * Whether to offer the learner an explanation at all: a port is present, the
+     * answer is graded, the type is one the SDK explains, and the author left
+     * explanations on. False in `exam`, always.
+     */
+    offered: boolean;
+    status: 'idle' | 'loading' | 'shown' | 'unavailable';
+    /** What to show, once it has arrived and been checked. Its `text` is text, never HTML. */
+    explanation: AiTextResult | null;
+    /**
+     * Asks the port, when the learner presses something. Does nothing while a
+     * call is on its way, and nothing at all where `offered` is false — so an
+     * exam cannot reach a model through this hook, whatever ports are in scope.
+     *
+     * One identity for the life of the question, so it is safe in an effect's
+     * dependencies.
+     */
+    ask: () => void;
+}
+interface AiHintsInput extends AiHelpSituation {
+    /** A disabled question gives no hints, as it takes no answer. */
+    disabled?: boolean;
+}
+interface AiHintsHelp {
+    /**
+     * Whether the learner may ask for hints here at all: a port is present, the
+     * mode is `practice`, the answer is not in, the question is not disabled or
+     * redacted, the type takes hints and the author left them on. It stays true
+     * once `used` reaches `limit` — there are no more to give, but the question
+     * is still one that gives them.
+     */
+    offered: boolean;
+    status: 'idle' | 'loading' | 'unavailable';
+    /** Every hint shown for this question, in the order they were given. */
+    hints: readonly AiTextResult[];
+    /** The host's `maxHints`, as a whole number from 1 to 10 (3 by default). */
+    limit: number;
+    /** How many hints have been shown. A refused hint is not counted. */
+    used: number;
+    /**
+     * Asks for the next hint. Does nothing at the limit, while a call is on its
+     * way, or where `offered` is false. One identity for the life of the
+     * question.
+     */
+    ask: () => void;
+}
+/**
+ * "Explain my answer", without the SDK's own button and panel: the rules, the
+ * call, the checks and the record, for a question you draw yourself.
+ *
+ * It is what `<MultipleChoice>` and the others use, so a host's own question
+ * offers help on exactly the same terms: never in `exam`, never where the
+ * item's author switched explanations off, and never an explanation whose
+ * verdict contradicts the grade the SDK computed.
+ *
+ * ```tsx
+ * const { offered, status, explanation, ask } = useAiExplanation({
+ *   data, response, submitted, renderMode, outcome, ai: question.ai,
+ * });
+ * if (!offered) return null;
+ * return explanation === null ? (
+ *   <button type="button" onClick={ask} aria-busy={status === 'loading'}>Explain my answer</button>
+ * ) : (
+ *   <section>
+ *     <p>{explanation.text}</p>
+ *     <p>Written by AI. It can make mistakes.</p>
+ *   </section>
+ * );
+ * ```
+ *
+ * **Say who wrote it.** The SDK's own panel carries "Written by AI. It can make
+ * mistakes."; a page that drops that line passes a model's words off as the
+ * course's.
+ *
+ * When the answer or its grade changes, the explanation is dropped and a call
+ * still on its way is abandoned — a late explanation never lands beside an
+ * answer it was not written for — as it is when the caller unmounts.
+ */
+declare function useAiExplanation(input: AiExplanationInput): AiExplanationHelp;
+/**
+ * "Get a hint", without the SDK's own button and list: the rules, the call, the
+ * checks and the record, for a question you draw yourself.
+ *
+ * It is what `<MultipleChoice>` and the others use, so a host's own question
+ * gives hints on exactly the same terms: only in `practice` before submit, up
+ * to the host's limit, never on a redacted item or a type the SDK does not hint
+ * for, and never a hint that gives the answer away — which is refused rather
+ * than shown, and not counted.
+ *
+ * ```tsx
+ * const { offered, status, hints, used, limit, ask } = useAiHints({
+ *   data, response, submitted, renderMode, ai: question.ai,
+ * });
+ * ```
+ *
+ * **Say who wrote them**, as the SDK's own list does: "Written by AI. It can
+ * make mistakes."
+ *
+ * Keep the hints on screen after submit — the learner can see what they were
+ * given — while `offered` turns false. Another question starts with none.
+ */
+declare function useAiHints(input: AiHintsInput): AiHintsHelp;
+
+export { type AiExplanationHelp, type AiExplanationInput, type AiHelpSituation, type AiHintsHelp, type AiHintsInput, useAiExplanation, useAiHints };

package/dist/ai/useAiHelp.d.ts

@@ -0,0 +1,146 @@
+import { AiTextResult, LearnerResponse, InteractionEvent, ItemOutcome } from '@intellectif/lk-core';
+import { g as RenderableActivity, e as RenderMode } from '../types-BY-4S5Rd.js';
+import { LearnerAi } from './LkAiProvider.js';
+import '../machine-CuwKqWXC.js';
+import 'react';
+
+/**
+ * The question AI help is being asked about, as the SDK's own components know
+ * it. A host drawing its own question passes what it has; everything optional
+ * defaults to what the components pass.
+ */
+interface AiHelpSituation {
+    /** The question, as `data` is given to any activity component. */
+    data: RenderableActivity;
+    /** The learner's answer as it stands: submitted, restored, or being written. */
+    response: LearnerResponse;
+    /** Whether the learner has committed that answer. */
+    submitted: boolean;
+    /**
+     * Pass on the `renderMode` your question was given. Left out, the paper
+     * around the question answers for it — a question inside `<ActivitySequence>`
+     * or `<InteractiveVideo>` knows its mode — and `practice` only where there is
+     * no paper at all. An `exam` around the question wins over anything passed
+     * here.
+     */
+    renderMode?: RenderMode;
+    /**
+     * The AI ports to use, overriding {@link LkAiProvider}'s for this question.
+     * A question inside `<ActivitySequence>` or `<InteractiveVideo>` is handed
+     * the ports in force as `ai` — pass that straight in.
+     */
+    ai?: LearnerAi;
+    /** The interface language: the default language for what a model writes. */
+    locale?: string;
+    /** Where `ai-hint-shown` and `ai-explanation-shown` go. */
+    onInteraction?: (event: InteractionEvent) => void;
+}
+interface AiExplanationInput extends AiHelpSituation {
+    /** The grade of record, which `review` explains. */
+    outcome?: ItemOutcome;
+}
+interface AiExplanationHelp {
+    /**
+     * Whether to offer the learner an explanation at all: a port is present, the
+     * answer is graded, the type is one the SDK explains, and the author left
+     * explanations on. False in `exam`, always.
+     */
+    offered: boolean;
+    status: 'idle' | 'loading' | 'shown' | 'unavailable';
+    /** What to show, once it has arrived and been checked. Its `text` is text, never HTML. */
+    explanation: AiTextResult | null;
+    /**
+     * Asks the port, when the learner presses something. Does nothing while a
+     * call is on its way, and nothing at all where `offered` is false — so an
+     * exam cannot reach a model through this hook, whatever ports are in scope.
+     *
+     * One identity for the life of the question, so it is safe in an effect's
+     * dependencies.
+     */
+    ask: () => void;
+}
+interface AiHintsInput extends AiHelpSituation {
+    /** A disabled question gives no hints, as it takes no answer. */
+    disabled?: boolean;
+}
+interface AiHintsHelp {
+    /**
+     * Whether the learner may ask for hints here at all: a port is present, the
+     * mode is `practice`, the answer is not in, the question is not disabled or
+     * redacted, the type takes hints and the author left them on. It stays true
+     * once `used` reaches `limit` — there are no more to give, but the question
+     * is still one that gives them.
+     */
+    offered: boolean;
+    status: 'idle' | 'loading' | 'unavailable';
+    /** Every hint shown for this question, in the order they were given. */
+    hints: readonly AiTextResult[];
+    /** The host's `maxHints`, as a whole number from 1 to 10 (3 by default). */
+    limit: number;
+    /** How many hints have been shown. A refused hint is not counted. */
+    used: number;
+    /**
+     * Asks for the next hint. Does nothing at the limit, while a call is on its
+     * way, or where `offered` is false. One identity for the life of the
+     * question.
+     */
+    ask: () => void;
+}
+/**
+ * "Explain my answer", without the SDK's own button and panel: the rules, the
+ * call, the checks and the record, for a question you draw yourself.
+ *
+ * It is what `<MultipleChoice>` and the others use, so a host's own question
+ * offers help on exactly the same terms: never in `exam`, never where the
+ * item's author switched explanations off, and never an explanation whose
+ * verdict contradicts the grade the SDK computed.
+ *
+ * ```tsx
+ * const { offered, status, explanation, ask } = useAiExplanation({
+ *   data, response, submitted, renderMode, outcome, ai: question.ai,
+ * });
+ * if (!offered) return null;
+ * return explanation === null ? (
+ *   <button type="button" onClick={ask} aria-busy={status === 'loading'}>Explain my answer</button>
+ * ) : (
+ *   <section>
+ *     <p>{explanation.text}</p>
+ *     <p>Written by AI. It can make mistakes.</p>
+ *   </section>
+ * );
+ * ```
+ *
+ * **Say who wrote it.** The SDK's own panel carries "Written by AI. It can make
+ * mistakes."; a page that drops that line passes a model's words off as the
+ * course's.
+ *
+ * When the answer or its grade changes, the explanation is dropped and a call
+ * still on its way is abandoned — a late explanation never lands beside an
+ * answer it was not written for — as it is when the caller unmounts.
+ */
+declare function useAiExplanation(input: AiExplanationInput): AiExplanationHelp;
+/**
+ * "Get a hint", without the SDK's own button and list: the rules, the call, the
+ * checks and the record, for a question you draw yourself.
+ *
+ * It is what `<MultipleChoice>` and the others use, so a host's own question
+ * gives hints on exactly the same terms: only in `practice` before submit, up
+ * to the host's limit, never on a redacted item or a type the SDK does not hint
+ * for, and never a hint that gives the answer away — which is refused rather
+ * than shown, and not counted.
+ *
+ * ```tsx
+ * const { offered, status, hints, used, limit, ask } = useAiHints({
+ *   data, response, submitted, renderMode, ai: question.ai,
+ * });
+ * ```
+ *
+ * **Say who wrote them**, as the SDK's own list does: "Written by AI. It can
+ * make mistakes."
+ *
+ * Keep the hints on screen after submit — the learner can see what they were
+ * given — while `offered` turns false. Another question starts with none.
+ */
+declare function useAiHints(input: AiHintsInput): AiHintsHelp;
+
+export { type AiExplanationHelp, type AiExplanationInput, type AiHelpSituation, type AiHintsHelp, type AiHintsInput, useAiExplanation, useAiHints };

package/dist/ai/useAiHelp.js

@@ -0,0 +1,7 @@
+'use client';
+export { useAiExplanation, useAiHints } from '../chunk-YGJE7RSW.js';
+import '../chunk-YNDKAYW3.js';
+import '../chunk-TEAVPUMX.js';
+import '../chunk-PPFVTXGJ.js';
+//# sourceMappingURL=useAiHelp.js.map
+//# sourceMappingURL=useAiHelp.js.map

package/dist/ai/useAiHelp.js.map

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

package/dist/{chunk-Z5XY66PO.cjs → chunk-3SDCALS3.cjs}

@@ -1,13 +1,13 @@
 'use client';
 'use strict';
 
-var chunkH63O5HPW_cjs = require('./chunk-H63O5HPW.cjs');
-var chunkJKMBFHER_cjs = require('./chunk-JKMBFHER.cjs');
-var chunkTI23GIFM_cjs = require('./chunk-TI23GIFM.cjs');
-var chunkQA42VDTA_cjs = require('./chunk-QA42VDTA.cjs');
-var chunkRZ52SEYV_cjs = require('./chunk-RZ52SEYV.cjs');
-var chunk6RRFH7C4_cjs = require('./chunk-6RRFH7C4.cjs');
-var chunkBAKLJKFZ_cjs = require('./chunk-BAKLJKFZ.cjs');
+var chunkCQNKZ435_cjs = require('./chunk-CQNKZ435.cjs');
+var chunkX4YU6BX7_cjs = require('./chunk-X4YU6BX7.cjs');
+var chunkJH77MAON_cjs = require('./chunk-JH77MAON.cjs');
+var chunk3SJ7TVL6_cjs = require('./chunk-3SJ7TVL6.cjs');
+var chunk7GYAUA56_cjs = require('./chunk-7GYAUA56.cjs');
+var chunkNZM3M5IR_cjs = require('./chunk-NZM3M5IR.cjs');
+var chunkAPZ6JFN6_cjs = require('./chunk-APZ6JFN6.cjs');
 var chunkAHGB5HH6_cjs = require('./chunk-AHGB5HH6.cjs');
 var lkCore = require('@intellectif/lk-core');
 var react = require('react');
@@ -106,7 +106,7 @@ function ActivityPreview({
   const data = result.data;
   const key = `${renderMode}:${responseKey}:${recordingKeyOf(data)}`;
   if (marking?.kind === "failed") {
-    return /* @__PURE__ */ jsxRuntime.jsx(chunkBAKLJKFZ_cjs.ActivityErrorBoundary, { activityTitle: data.title, strings: s, children: /* @__PURE__ */ jsxRuntime.jsx(Rethrow, { error: marking.error }) }, key);
+    return /* @__PURE__ */ jsxRuntime.jsx(chunkAPZ6JFN6_cjs.ActivityErrorBoundary, { activityTitle: data.title, strings: s, children: /* @__PURE__ */ jsxRuntime.jsx(Rethrow, { error: marking.error }) }, key);
   }
   const shared = {
     renderMode,
@@ -133,7 +133,7 @@ function ActivityPreview({
   switch (data.type) {
     case "multiple-choice":
       return /* @__PURE__ */ jsxRuntime.jsx(
-        chunkJKMBFHER_cjs.MultipleChoice,
+        chunkX4YU6BX7_cjs.MultipleChoice,
         {
           data,
           shuffleSeed: shuffleSeed ?? PREVIEW_SHUFFLE_SEED,
@@ -142,10 +142,10 @@ function ActivityPreview({
         key
       );
     case "fill-in-the-blanks":
-      return /* @__PURE__ */ jsxRuntime.jsx(chunkTI23GIFM_cjs.FillInTheBlanks, { data, ...shared }, key);
+      return /* @__PURE__ */ jsxRuntime.jsx(chunkJH77MAON_cjs.FillInTheBlanks, { data, ...shared }, key);
     case "gap-select":
       return /* @__PURE__ */ jsxRuntime.jsx(
-        chunkQA42VDTA_cjs.GapSelect,
+        chunk3SJ7TVL6_cjs.GapSelect,
         {
           data,
           shuffleSeed: shuffleSeed ?? PREVIEW_SHUFFLE_SEED,
@@ -154,11 +154,11 @@ function ActivityPreview({
         key
       );
     case "written-response":
-      return /* @__PURE__ */ jsxRuntime.jsx(chunkH63O5HPW_cjs.WrittenResponse, { data, ...shared }, key);
+      return /* @__PURE__ */ jsxRuntime.jsx(chunkCQNKZ435_cjs.WrittenResponse, { data, ...shared }, key);
     case "dictation":
-      return /* @__PURE__ */ jsxRuntime.jsx(chunkRZ52SEYV_cjs.Dictation, { data, ...shared }, key);
+      return /* @__PURE__ */ jsxRuntime.jsx(chunk7GYAUA56_cjs.Dictation, { data, ...shared }, key);
     case "read-aloud":
-      return /* @__PURE__ */ jsxRuntime.jsx(chunk6RRFH7C4_cjs.ReadAloud, { data, recordingBinding: PREVIEW_RECORDING, ...shared }, key);
+      return /* @__PURE__ */ jsxRuntime.jsx(chunkNZM3M5IR_cjs.ReadAloud, { data, recordingBinding: PREVIEW_RECORDING, ...shared }, key);
     default:
       return /* @__PURE__ */ jsxRuntime.jsx("div", { className: "lk-preview-unsupported", role: "note", children: s.unsupportedActivity });
   }
@@ -232,5 +232,5 @@ function contentKeyOf(value, enclosing = /* @__PURE__ */ new Set()) {
 }
 
 exports.ActivityPreview = ActivityPreview;
-//# sourceMappingURL=chunk-Z5XY66PO.cjs.map
-//# sourceMappingURL=chunk-Z5XY66PO.cjs.map
+//# sourceMappingURL=chunk-3SDCALS3.cjs.map
+//# sourceMappingURL=chunk-3SDCALS3.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/ActivityPreview/ActivityPreview.tsx"],"names":["useLkStrings","useMemo","validateDraft","evaluate","slotMediaKey","jsx","Fragment","ActivityErrorBoundary","MultipleChoice","FillInTheBlanks","GapSelect","WrittenResponse","Dictation","ReadAloud"],"mappings":"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","file":"chunk-3SDCALS3.cjs","sourcesContent":["'use client';\n\nimport {\n  type ActivityType,\n  type DraftNotComplete,\n  evaluate,\n  type ItemOutcome,\n  type LearnerResponse,\n  slotMediaKey,\n  type ThemeTokens,\n  validateDraft,\n} from '@intellectif/lk-core';\nimport { type ReactNode, useMemo } from 'react';\nimport { useLkStrings } from '../../i18n/LkIntlProvider.js';\nimport type { LkStringsOverride } from '../../i18n/strings.js';\nimport { ActivityErrorBoundary } from '../ActivityErrorBoundary.js';\nimport type { ActivityRenderer } from '../ActivitySequence/index.js';\nimport { Dictation } from '../Dictation/index.js';\nimport { FillInTheBlanks } from '../FillInTheBlanks/index.js';\nimport { GapSelect } from '../GapSelect/index.js';\nimport { MultipleChoice } from '../MultipleChoice/index.js';\nimport { ReadAloud } from '../ReadAloud/index.js';\nimport type { RecordingBinding } from '../ReadAloud/ReadAloud.js';\nimport type { HtmlSanitizer, MediaBudgetBinding, RenderMode } from '../types.js';\nimport { WrittenResponse } from '../WrittenResponse/index.js';\n\n/**\n * The option-shuffle seed a preview uses when none is given. Fixed, so a\n * shuffled question holds still while its author edits it instead of\n * re-ordering on every remount.\n */\nconst PREVIEW_SHUFFLE_SEED = 'lk-activity-preview';\n\n/**\n * The slot a previewed activity stands in for. A recording's play budget is\n * keyed to it and lives only in this mount: the preview counts plays so an\n * author hears the limit a learner gets, and records none of them.\n */\nconst PREVIEW_SLOT_ID = 'preview';\n\n/** Numbers the takes a preview mints keys for, so two are never the same take. */\nlet previewTakeCount = 0;\n\n/**\n * The store a previewed read-aloud records into: it keys the take so the whole\n * flow — record, play it back, submit — runs for the author, and keeps it\n * nowhere, like every other thing a preview does not record.\n *\n * It judges nothing, deliberately. `assess` is optional precisely so this can\n * exist: an author trying a reading out has no assessor to point at, and a\n * preview that demanded one would refuse to render the most common case. The\n * default `practice` mode then shows the \"assessment is not available\" notice,\n * which is the truth about this binding rather than a failure.\n */\nconst PREVIEW_RECORDING: RecordingBinding = {\n  upload: async (take) => {\n    previewTakeCount += 1;\n    return {\n      key: `${PREVIEW_SLOT_ID}-take-${previewTakeCount}`,\n      mimeType: take.mimeType,\n      durationMs: take.durationMs,\n    };\n  },\n};\n\nexport interface ActivityPreviewProps {\n  /**\n   * The activity as an editor holds it right now, finished or not. It is checked\n   * with `validateDraft` before anything renders — by content, on every render —\n   * so a half-written question never reaches a component that assumes a valid\n   * one.\n   */\n  draft: unknown;\n  /** The mode to preview in. Defaults to `practice`. */\n  renderMode?: RenderMode;\n  /**\n   * A learner response to show as if a learner had given it. In `practice` and\n   * `exam` it seeds the answer, which stays editable; in `review` it is the\n   * submitted answer, marked by `evaluate()` unless `outcome` is given.\n   */\n  response?: LearnerResponse;\n  /**\n   * The outcome `review` marks the response with, instead of the one\n   * `evaluate()` computes — which is how to preview a returned grade on a written\n   * response, since the SDK cannot score one. Ignored in other modes.\n   */\n  outcome?: ItemOutcome;\n  /**\n   * Rendered in place of the activity while the draft is not complete, with the\n   * issues `validateDraft` found — so an editor can list them in its own words.\n   * The issue messages are English, and a preview that rendered them would put\n   * untranslatable text on screen. Without it, the preview shows the\n   * `previewIncomplete` or `previewInvalid` string.\n   */\n  fallback?: (result: DraftNotComplete) => ReactNode;\n  /**\n   * Renderers for activity types beyond the built-ins, keyed by `type`, as on\n   * `<ActivitySequence>`. An entry receives the shared prop contract and\n   * nothing else, so — like the shuffle seed below — the in-memory recording\n   * binding a previewed read-aloud is given does not reach one. Nor does the\n   * `question` a sequence hands a renderer: a preview is one question with no\n   * set around it, so there is no slot to report to and nothing to page away\n   * from. A renderer that uses it must treat it as optional, which its type\n   * already says.\n   */\n  renderers?: Readonly<Record<string, ActivityRenderer>>;\n  /**\n   * Seeds `<MultipleChoice>`'s option shuffle. Defaults to a fixed seed, so the\n   * order holds while options are edited; adding or removing one deals them\n   * again, because the shuffle orders by position. A `renderers` entry is given\n   * no seed, as on `<ActivitySequence>`.\n   */\n  shuffleSeed?: string;\n  /** Renders author-supplied rich text. See `HtmlSanitizer`. */\n  sanitizeHtml?: HtmlSanitizer;\n  /** Overrides the SDK's chrome text, for the preview's notice and the activity alike. */\n  strings?: LkStringsOverride;\n  /** Per-instance token overrides, passed to the activity. */\n  theme?: Partial<ThemeTokens>;\n  /** BCP 47 tag of the interface language, passed to the activity. */\n  locale?: string;\n}\n\ntype Marking = { kind: 'marked'; outcome: ItemOutcome } | { kind: 'failed'; error: Error };\n\n/**\n * Renders an activity from an editor's draft, in any render mode, with a\n * simulated learner response — and renders a notice instead while the draft is\n * not an activity yet.\n *\n * Nothing it renders is recorded: no callback is wired, so a practice attempt in\n * a preview scores locally and goes nowhere, and a recording's play limit is\n * counted in memory only.\n *\n * A draft with no string `type`, a type nobody registered, and a `response` of a\n * different type from the draft are wiring errors, and throw.\n */\nexport function ActivityPreview({\n  draft,\n  renderMode = 'practice',\n  response,\n  outcome,\n  fallback,\n  renderers,\n  shuffleSeed,\n  sanitizeHtml,\n  strings,\n  theme,\n  locale,\n}: ActivityPreviewProps) {\n  const s = useLkStrings(strings);\n  const type = isRecord(draft) && typeof draft.type === 'string' ? draft.type : undefined;\n\n  // Validated on the draft's CONTENT, not its identity. The activity components\n  // restart whenever `data` changes identity, and an editor that rebuilds its\n  // payload on every change would otherwise restart the question an author is\n  // trying out each time anything else on the page was edited. The key is read\n  // on every render, so a draft changed in place is checked again too.\n  const contentKey = contentKeyOf(draft);\n  // biome-ignore lint/correctness/useExhaustiveDependencies: the draft's content (contentKey) is the trigger, not its identity\n  const result = useMemo(\n    () => (type === undefined ? undefined : validateDraft(type as ActivityType, draft)),\n    [type, contentKey],\n  );\n  const activity = result?.status === 'complete' ? result.data : undefined;\n  const responseFits = response === undefined || response.type === type;\n  const responseKey = response === undefined ? 'none' : contentKeyOf(response);\n\n  // biome-ignore lint/correctness/useExhaustiveDependencies: the response's content (responseKey) is the trigger, not its identity\n  const marking = useMemo((): Marking | undefined => {\n    if (renderMode !== 'review' || activity === undefined) {\n      return undefined;\n    }\n    if (outcome !== undefined) {\n      return { kind: 'marked', outcome };\n    }\n    if (response === undefined || !responseFits) {\n      return undefined;\n    }\n    try {\n      return { kind: 'marked', outcome: evaluate(activity, response) };\n    } catch (thrown) {\n      // Scored here, during this component's own render, where no error boundary\n      // inside the activity can catch it — so it is handed to one below.\n      return {\n        kind: 'failed',\n        error: thrown instanceof Error ? thrown : new Error(String(thrown)),\n      };\n    }\n  }, [renderMode, activity, outcome, responseKey, responseFits]);\n\n  const activityId = activity?.id;\n  const mediaBudget = useMemo<MediaBudgetBinding>(\n    () => ({\n      key: slotMediaKey(PREVIEW_SLOT_ID),\n      slotId: PREVIEW_SLOT_ID,\n      index: 0,\n      ...(activityId !== undefined ? { activityId } : {}),\n    }),\n    [activityId],\n  );\n\n  // All hooks are called before these throws, so hook order stays stable.\n  if (type === undefined || result === undefined) {\n    throw new Error(\n      '<ActivityPreview> needs a draft object with a string `type`, to know which activity to check and render.',\n    );\n  }\n  // Checked against the draft's own type, whatever state the draft is in. A\n  // mis-wired response is a wiring error however unfinished the draft is, and\n  // waiting for the draft to be complete would throw on the very edit that\n  // completes it.\n  if (response !== undefined && !responseFits) {\n    throw new Error(\n      `<ActivityPreview> was given a \"${response.type}\" response for a \"${type}\" activity.`,\n    );\n  }\n  if (result.status !== 'complete') {\n    if (fallback !== undefined) {\n      return <>{fallback(result)}</>;\n    }\n    return (\n      <div\n        className=\"lk-preview-unavailable\"\n        role=\"note\"\n        data-status={result.status}\n        {...(locale !== undefined ? { lang: locale } : {})}\n      >\n        {result.status === 'invalid' ? s.previewInvalid : s.previewIncomplete}\n      </div>\n    );\n  }\n  const data = result.data;\n\n  // A different simulated response, or a different mode, mounts the activity\n  // afresh, play count included: a seeded answer is read at mount, and a practice\n  // attempt the author submitted must not carry over into an exam preview. So\n  // does a different recording or playback policy, which is a different listening\n  // budget — the transport reads its count once, when it mounts.\n  const key = `${renderMode}:${responseKey}:${recordingKeyOf(data)}`;\n\n  if (marking?.kind === 'failed') {\n    // The response is one the scorer cannot read, or a registered scorer threw.\n    // Shown as the activity's error fallback, as a render failure would be.\n    return (\n      <ActivityErrorBoundary key={key} activityTitle={data.title} strings={s}>\n        <Rethrow error={marking.error} />\n      </ActivityErrorBoundary>\n    );\n  }\n\n  const shared = {\n    renderMode,\n    // Without a binding a budgeted recording counts nothing in `practice`, and in\n    // `exam` the media component refuses to render at all — rightly, on a real\n    // paper, where nothing would persist the count. A preview persists nothing by\n    // design, so it keeps the count in memory and says so.\n    mediaBudget,\n    ...(sanitizeHtml !== undefined ? { sanitizeHtml } : {}),\n    ...(strings !== undefined ? { strings } : {}),\n    ...(theme !== undefined ? { theme } : {}),\n    ...(locale !== undefined ? { locale } : {}),\n    // Seeded rather than controlled, in every mode, exactly as `<ActivitySequence>`\n    // hands a restored answer to its slots — so a renderer written for the\n    // sequence reads it here too. `review` is read-only either way, and `key`\n    // above re-seeds whenever the response changes.\n    ...(response !== undefined ? { defaultValue: response } : {}),\n    ...(marking !== undefined ? { outcome: marking.outcome } : {}),\n  };\n\n  const Custom = renderers?.[data.type];\n  if (Custom !== undefined) {\n    return <Custom key={key} data={data} {...shared} />;\n  }\n  switch (data.type) {\n    case 'multiple-choice':\n      return (\n        <MultipleChoice\n          key={key}\n          data={data}\n          shuffleSeed={shuffleSeed ?? PREVIEW_SHUFFLE_SEED}\n          {...shared}\n        />\n      );\n    case 'fill-in-the-blanks':\n      return <FillInTheBlanks key={key} data={data} {...shared} />;\n    case 'gap-select':\n      return (\n        <GapSelect\n          key={key}\n          data={data}\n          shuffleSeed={shuffleSeed ?? PREVIEW_SHUFFLE_SEED}\n          {...shared}\n        />\n      );\n    case 'written-response':\n      return <WrittenResponse key={key} data={data} {...shared} />;\n    case 'dictation':\n      return <Dictation key={key} data={data} {...shared} />;\n    case 'read-aloud':\n      return <ReadAloud key={key} data={data} recordingBinding={PREVIEW_RECORDING} {...shared} />;\n    default:\n      return (\n        <div className=\"lk-preview-unsupported\" role=\"note\">\n          {s.unsupportedActivity}\n        </div>\n      );\n  }\n}\n\n/** Throws `error` while rendering, so the error boundary around it shows its fallback. */\nfunction Rethrow({ error }: { error: Error }): never {\n  throw error;\n}\n\nfunction isRecord(value: unknown): value is Readonly<Record<string, unknown>> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\n/**\n * The recording and its playback policy — not its description, which changes\n * no budget — plus the slower file a dictation or a read-aloud carries, which\n * follows the same policy and must remount when it is swapped for another.\n */\nfunction recordingKeyOf(data: unknown): string {\n  const media = isRecord(data) ? data.media : undefined;\n  const slowMedia = isRecord(data) ? data.slowMedia : undefined;\n  const slowUrl = isRecord(slowMedia) ? slowMedia.url : undefined;\n  if (!isRecord(media) && slowUrl === undefined) {\n    return '';\n  }\n  return contentKeyOf([\n    isRecord(media) ? media.type : undefined,\n    isRecord(media) ? media.url : undefined,\n    isRecord(media) ? media.playback : undefined,\n    slowUrl,\n  ]);\n}\n\nconst identities = new WeakMap<object, number>();\nlet lastIdentity = 0;\n\n/** A key for a value compared by identity: the same object always gets the same one. */\nfunction identityKeyOf(value: object): string {\n  let identity = identities.get(value);\n  if (identity === undefined) {\n    lastIdentity += 1;\n    identity = lastIdentity;\n    identities.set(value, identity);\n  }\n  return `#${identity}`;\n}\n\n/**\n * A string that changes exactly when a value's content does.\n *\n * Object keys are sorted, because key order is not content: a draft saved to a\n * JSON column comes back with its keys reordered. Every value is written in a\n * form no other value shares — JSON would write a non-finite number as `null`\n * and drop `undefined`, and those decide different issues. What JSON does not\n * describe — an instance of a class, a function, a reference back to an\n * enclosing object — is compared by identity, and a symbol by its description.\n */\nfunction contentKeyOf(value: unknown, enclosing: Set<object> = new Set()): string {\n  switch (typeof value) {\n    case 'string':\n      return JSON.stringify(value);\n    case 'number':\n      // `String` keeps NaN, the infinities and every other number apart; only -0\n      // needs saying.\n      return Object.is(value, -0) ? '-0' : String(value);\n    case 'bigint':\n      return `${value}n`;\n    case 'boolean':\n    case 'undefined':\n      return String(value);\n    case 'symbol':\n      return `Symbol(${JSON.stringify(value.description ?? null)})`;\n    case 'function':\n      return identityKeyOf(value);\n  }\n  // Every other `typeof` has returned above: this is `null`, or an object.\n  if (value === null || typeof value !== 'object') {\n    return 'null';\n  }\n  const prototype = Object.getPrototypeOf(value);\n  const plain = Array.isArray(value) || prototype === Object.prototype || prototype === null;\n  if (!plain || enclosing.has(value)) {\n    return identityKeyOf(value);\n  }\n  enclosing.add(value);\n  try {\n    if (Array.isArray(value)) {\n      return `[${Array.from(value, (item) => contentKeyOf(item, enclosing)).join(',')}]`;\n    }\n    const record = value as Record<string, unknown>;\n    const fields = Object.keys(record)\n      .sort()\n      .map((field) => `${JSON.stringify(field)}:${contentKeyOf(record[field], enclosing)}`);\n    return `{${fields.join(',')}}`;\n  } finally {\n    enclosing.delete(value);\n  }\n}\n"]}

package/dist/{chunk-QA42VDTA.cjs → chunk-3SJ7TVL6.cjs}

@@ -1,10 +1,11 @@
 'use client';
 'use strict';
 
-var chunk5F4Q6JT7_cjs = require('./chunk-5F4Q6JT7.cjs');
+var chunkNWGQ7JML_cjs = require('./chunk-NWGQ7JML.cjs');
 var chunkZDYNAWDZ_cjs = require('./chunk-ZDYNAWDZ.cjs');
 var chunkBRPEB43C_cjs = require('./chunk-BRPEB43C.cjs');
-var chunkBAKLJKFZ_cjs = require('./chunk-BAKLJKFZ.cjs');
+var chunkAPZ6JFN6_cjs = require('./chunk-APZ6JFN6.cjs');
+var chunkEANGKAKG_cjs = require('./chunk-EANGKAKG.cjs');
 var chunkL7WY5YFQ_cjs = require('./chunk-L7WY5YFQ.cjs');
 var chunkXOR4MPEN_cjs = require('./chunk-XOR4MPEN.cjs');
 var chunkAHGB5HH6_cjs = require('./chunk-AHGB5HH6.cjs');
@@ -78,7 +79,7 @@ function GapSelect({
   const s = chunkAHGB5HH6_cjs.useLkStrings(strings);
   const ai = chunkZDYNAWDZ_cjs.useLearnerAi(aiProp);
   const devError = react.useMemo(() => {
-    if (!chunkBAKLJKFZ_cjs.isDevelopment()) {
+    if (!chunkEANGKAKG_cjs.isDevelopment()) {
       return null;
     }
     if (data.redacted === true) {
@@ -128,7 +129,7 @@ function GapSelect({
   const sessionIdRef = react.useRef(null);
   const choicesByGap = react.useMemo(() => {
     const map = /* @__PURE__ */ new Map();
-    const seedSource = shuffleSeed ?? (sessionIdRef.current ??= chunkBAKLJKFZ_cjs.randomSessionId());
+    const seedSource = shuffleSeed ?? (sessionIdRef.current ??= chunkEANGKAKG_cjs.randomSessionId());
     for (const gap of data.gaps) {
       const choices = choicesFor(data.banks, gap);
       map.set(
@@ -183,9 +184,9 @@ function GapSelect({
     complete();
     const timeSpent = getTimeSpent();
     const xapiStatement = lkCore.xAPIBuilder.buildAnsweredStatement({
-      actor: chunkBAKLJKFZ_cjs.ANONYMOUS_ACTOR,
+      actor: chunkEANGKAKG_cjs.ANONYMOUS_ACTOR,
       object: {
-        id: chunkBAKLJKFZ_cjs.objectIdFor(data.id),
+        id: chunkEANGKAKG_cjs.objectIdFor(data.id),
         name: { [data.locale ?? "en-US"]: data.title },
         ...lkCore.xapiDefinitionFor(data)
       },
@@ -299,7 +300,7 @@ function GapSelect({
             ] }, seg.id);
           }) }),
           /* @__PURE__ */ jsxRuntime.jsx(
-            chunk5F4Q6JT7_cjs.AiHints,
+            chunkNWGQ7JML_cjs.AiHints,
             {
               ai,
               data,
@@ -326,7 +327,7 @@ function GapSelect({
         ) : null,
         /* @__PURE__ */ jsxRuntime.jsx(chunkBRPEB43C_cjs.FeedbackRegion, { id: `${data.id}-feedback`, children: isReview ? reviewSummary : summary }),
         /* @__PURE__ */ jsxRuntime.jsx(
-          chunk5F4Q6JT7_cjs.AiExplanation,
+          chunkNWGQ7JML_cjs.AiExplanation,
           {
             ai,
             data,
@@ -345,9 +346,9 @@ function GapSelect({
 }
 function GapSelect2(props) {
   const strings = chunkAHGB5HH6_cjs.useLkStrings(props.strings);
-  return /* @__PURE__ */ jsxRuntime.jsx(chunkBAKLJKFZ_cjs.ActivityErrorBoundary, { activityTitle: props.data?.title, strings, children: /* @__PURE__ */ jsxRuntime.jsx(GapSelect, { ...props }) });
+  return /* @__PURE__ */ jsxRuntime.jsx(chunkAPZ6JFN6_cjs.ActivityErrorBoundary, { activityTitle: props.data?.title, strings, children: /* @__PURE__ */ jsxRuntime.jsx(GapSelect, { ...props }) });
 }
 
 exports.GapSelect = GapSelect2;
-//# sourceMappingURL=chunk-QA42VDTA.cjs.map
-//# sourceMappingURL=chunk-QA42VDTA.cjs.map
+//# sourceMappingURL=chunk-3SJ7TVL6.cjs.map
+//# sourceMappingURL=chunk-3SJ7TVL6.cjs.map