@intellectif/lk-react 20.0.0 → 22.0.0

package/dist/chunk-RUS42NMN.js

@@ -1,115 +0,0 @@
-'use client';
-import { useAiExplanation, useAiHints } from './chunk-AQIAQHJC.js';
-import { useRef, useEffect } from 'react';
-import { jsxs, jsx } from 'react/jsx-runtime';
-
-function situation(input) {
-  const { data, response, submitted, renderMode, ai, locale, onInteraction, delivery } = input;
-  return {
-    data,
-    response,
-    submitted,
-    renderMode,
-    delivery,
-    ...ai !== void 0 ? { ai } : {},
-    ...locale !== void 0 ? { locale } : {},
-    ...onInteraction !== void 0 ? { onInteraction } : {}
-  };
-}
-function AiExplanation({
-  outcome,
-  ...rest
-}) {
-  const s = rest.strings;
-  const help = useAiExplanation({
-    ...situation(rest),
-    ...outcome !== void 0 ? { outcome } : {}
-  });
-  const buttonRef = useRef(null);
-  const panelRef = useRef(null);
-  const refocus = useRef(false);
-  useEffect(() => {
-    if (help.status === "shown" && refocus.current) {
-      refocus.current = false;
-      panelRef.current?.focus();
-    }
-    if (help.status === "unavailable") {
-      refocus.current = false;
-    }
-  }, [help.status]);
-  if (!help.offered) {
-    return null;
-  }
-  const ask = () => {
-    refocus.current = typeof document !== "undefined" && document.activeElement === buttonRef.current;
-    help.ask();
-  };
-  const loading = help.status === "loading";
-  return /* @__PURE__ */ jsxs("div", { className: "lk-ai", "data-state": help.status, children: [
-    help.explanation === null ? /* @__PURE__ */ jsx(
-      "button",
-      {
-        ref: buttonRef,
-        type: "button",
-        className: "lk-ai-button",
-        "aria-busy": loading || void 0,
-        "aria-disabled": loading || void 0,
-        onClick: ask,
-        children: loading ? s.aiExplaining : s.aiExplain
-      }
-    ) : null,
-    /* @__PURE__ */ jsx("div", { "aria-live": "polite", children: help.explanation !== null ? /* @__PURE__ */ jsxs(
-      "section",
-      {
-        ref: panelRef,
-        className: "lk-ai-panel",
-        tabIndex: -1,
-        "aria-label": s.aiExplanation,
-        children: [
-          /* @__PURE__ */ jsx("p", { className: "lk-ai-heading", children: s.aiExplanation }),
-          /* @__PURE__ */ jsx("p", { className: "lk-ai-text", children: help.explanation.text }),
-          /* @__PURE__ */ jsx("p", { className: "lk-ai-notice", children: s.aiNotice })
-        ]
-      }
-    ) : help.status === "unavailable" ? /* @__PURE__ */ jsx("p", { className: "lk-ai-unavailable", children: s.aiExplanationUnavailable }) : null })
-  ] });
-}
-function AiHints({ disabled, ...rest }) {
-  const s = rest.strings;
-  const help = useAiHints({ ...situation(rest), disabled });
-  const used = help.used;
-  if (rest.ai?.hint === void 0 || !help.offered && used === 0) {
-    return null;
-  }
-  const loading = help.status === "loading";
-  return /* @__PURE__ */ jsxs("div", { className: "lk-ai lk-ai-hint-area", "data-state": help.status, children: [
-    /* @__PURE__ */ jsxs("div", { "aria-live": "polite", children: [
-      used > 0 ? /* @__PURE__ */ jsx("ol", { className: "lk-ai-hints", "aria-label": s.aiHints, children: help.hints.map((hint, index) => (
-        // Hints are only ever appended, so a position is a stable key.
-        // biome-ignore lint/suspicious/noArrayIndexKey: an append-only list
-        /* @__PURE__ */ jsxs("li", { className: "lk-ai-hint", children: [
-          /* @__PURE__ */ jsx("span", { className: "lk-ai-hint-label", children: s.aiHintNumber(index + 1) }),
-          " ",
-          /* @__PURE__ */ jsx("span", { className: "lk-ai-text", children: hint.text })
-        ] }, index)
-      )) }) : null,
-      help.status === "unavailable" ? /* @__PURE__ */ jsx("p", { className: "lk-ai-unavailable", children: s.aiHintUnavailable }) : null
-    ] }),
-    help.offered ? used < help.limit ? /* @__PURE__ */ jsx(
-      "button",
-      {
-        type: "button",
-        className: "lk-ai-button",
-        "aria-busy": loading || void 0,
-        "aria-disabled": loading || void 0,
-        onClick: help.ask,
-        children: loading ? s.aiHintLoading : s.aiHint
-      }
-    ) : /* @__PURE__ */ jsx("p", { className: "lk-ai-note", children: s.aiNoMoreHints }) : null,
-    used > 0 ? /* @__PURE__ */ jsx("p", { className: "lk-ai-notice", children: s.aiNotice }) : null
-  ] });
-}
-
-export { AiExplanation, AiHints };
-//# sourceMappingURL=chunk-RUS42NMN.js.map
-//# sourceMappingURL=chunk-RUS42NMN.js.map

package/dist/chunk-RUS42NMN.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/components/shared/AiHelp.tsx"],"names":[],"mappings":"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","file":"chunk-RUS42NMN.js","sourcesContent":["'use client';\n\nimport type {\n  InteractionEvent,\n  ItemOutcome,\n  LearnerResponse,\n  ResolvedDeliveryPolicy,\n} from '@intellectif/lk-core';\nimport { useEffect, useRef } from 'react';\nimport type { LearnerAi } from '../../ai/LkAiProvider.js';\nimport { useAiExplanation, useAiHints } from '../../ai/useAiHelp.js';\nimport type { LkStrings } from '../../i18n/strings.js';\nimport type { RenderableActivity, RenderMode } from '../types.js';\n\ninterface Situation {\n  ai: LearnerAi | undefined;\n  data: RenderableActivity;\n  renderMode: RenderMode;\n  submitted: boolean;\n  /** The learner's answer as it stands: submitted, restored, or being written. */\n  response: LearnerResponse;\n  /** The component's `locale`, the default language for what is written. */\n  locale: string | undefined;\n  onInteraction: ((event: InteractionEvent) => void) | undefined;\n  strings: LkStrings;\n  /** The policy the component resolved, the paper's included. */\n  delivery: ResolvedDeliveryPolicy;\n}\n\n/** What the hooks take, from what a component holds: the optional half, without `undefined` values. */\nfunction situation(input: Situation): {\n  data: RenderableActivity;\n  response: LearnerResponse;\n  submitted: boolean;\n  renderMode: RenderMode;\n  ai?: LearnerAi;\n  locale?: string;\n  onInteraction?: (event: InteractionEvent) => void;\n  delivery: ResolvedDeliveryPolicy;\n} {\n  const { data, response, submitted, renderMode, ai, locale, onInteraction, delivery } = input;\n  return {\n    data,\n    response,\n    submitted,\n    renderMode,\n    delivery,\n    ...(ai !== undefined ? { ai } : {}),\n    ...(locale !== undefined ? { locale } : {}),\n    ...(onInteraction !== undefined ? { onInteraction } : {}),\n  };\n}\n\n/**\n * \"Explain my answer\": the SDK's own surface over {@link useAiExplanation} — a\n * button, the explanation with who wrote it, and \"not available\" when a call\n * fails or its answer is refused.\n *\n * Nothing renders without a port, or where the rules say no explanation.\n */\nexport function AiExplanation({\n  outcome,\n  ...rest\n}: Situation & { outcome: ItemOutcome | undefined }) {\n  const s = rest.strings;\n  const help = useAiExplanation({\n    ...situation(rest),\n    ...(outcome !== undefined ? { outcome } : {}),\n  });\n  const buttonRef = useRef<HTMLButtonElement>(null);\n  const panelRef = useRef<HTMLElement>(null);\n  const refocus = useRef(false);\n\n  // The button that asked goes away when the explanation arrives; focus moves\n  // to what it asked for rather than falling to the page.\n  useEffect(() => {\n    if (help.status === 'shown' && refocus.current) {\n      refocus.current = false;\n      panelRef.current?.focus();\n    }\n    if (help.status === 'unavailable') {\n      refocus.current = false;\n    }\n  }, [help.status]);\n\n  if (!help.offered) {\n    return null;\n  }\n\n  const ask = (): void => {\n    refocus.current =\n      typeof document !== 'undefined' && document.activeElement === buttonRef.current;\n    help.ask();\n  };\n\n  const loading = help.status === 'loading';\n  return (\n    <div className=\"lk-ai\" data-state={help.status}>\n      {help.explanation === null ? (\n        <button\n          ref={buttonRef}\n          type=\"button\"\n          className=\"lk-ai-button\"\n          aria-busy={loading || undefined}\n          aria-disabled={loading || undefined}\n          onClick={ask}\n        >\n          {loading ? s.aiExplaining : s.aiExplain}\n        </button>\n      ) : null}\n      <div aria-live=\"polite\">\n        {help.explanation !== null ? (\n          <section\n            ref={panelRef}\n            className=\"lk-ai-panel\"\n            tabIndex={-1}\n            aria-label={s.aiExplanation}\n          >\n            <p className=\"lk-ai-heading\">{s.aiExplanation}</p>\n            <p className=\"lk-ai-text\">{help.explanation.text}</p>\n            <p className=\"lk-ai-notice\">{s.aiNotice}</p>\n          </section>\n        ) : help.status === 'unavailable' ? (\n          <p className=\"lk-ai-unavailable\">{s.aiExplanationUnavailable}</p>\n        ) : null}\n      </div>\n    </div>\n  );\n}\n\n/**\n * \"Get a hint\": the SDK's own surface over {@link useAiHints} — a button, the\n * hints given so far as a numbered list, and who wrote them.\n *\n * The hints stay listed after submit, so the learner can see what they were\n * given, but no more can be asked for. Another question starts with none.\n */\nexport function AiHints({ disabled, ...rest }: Situation & { disabled: boolean }) {\n  const s = rest.strings;\n  const help = useAiHints({ ...situation(rest), disabled });\n  const used = help.used;\n\n  if (rest.ai?.hint === undefined || (!help.offered && used === 0)) {\n    return null;\n  }\n\n  const loading = help.status === 'loading';\n  return (\n    <div className=\"lk-ai lk-ai-hint-area\" data-state={help.status}>\n      <div aria-live=\"polite\">\n        {used > 0 ? (\n          <ol className=\"lk-ai-hints\" aria-label={s.aiHints}>\n            {help.hints.map((hint, index) => (\n              // Hints are only ever appended, so a position is a stable key.\n              // biome-ignore lint/suspicious/noArrayIndexKey: an append-only list\n              <li key={index} className=\"lk-ai-hint\">\n                <span className=\"lk-ai-hint-label\">{s.aiHintNumber(index + 1)}</span>{' '}\n                <span className=\"lk-ai-text\">{hint.text}</span>\n              </li>\n            ))}\n          </ol>\n        ) : null}\n        {help.status === 'unavailable' ? (\n          <p className=\"lk-ai-unavailable\">{s.aiHintUnavailable}</p>\n        ) : null}\n      </div>\n      {help.offered ? (\n        used < help.limit ? (\n          <button\n            type=\"button\"\n            className=\"lk-ai-button\"\n            aria-busy={loading || undefined}\n            aria-disabled={loading || undefined}\n            onClick={help.ask}\n          >\n            {loading ? s.aiHintLoading : s.aiHint}\n          </button>\n        ) : (\n          <p className=\"lk-ai-note\">{s.aiNoMoreHints}</p>\n        )\n      ) : null}\n      {used > 0 ? <p className=\"lk-ai-notice\">{s.aiNotice}</p> : null}\n    </div>\n  );\n}\n"]}

package/dist/chunk-TRMWBJWT.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/ai/rules.ts","../src/ai/useAiHelp.ts"],"names":["OPEN_DELIVERY_POLICY","aiSupports","aiAllowedByContent","isDevelopment","useContext","SequenceSlotContext","combineDeliveryPolicies","useLearnerAi","useState","useRef","useEffect","useCallback","aiExplanationRequest","checkAiExplanation","aiHintRequest","checkAiHint"],"mappings":"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","file":"chunk-TRMWBJWT.cjs","sourcesContent":["/**\n * When AI help is offered, and what the SDK does with what a port answers.\n *\n * Internal: these are the rules behind {@link useAiHints} and\n * {@link useAiExplanation}, which are what a host calls. They live apart from\n * the hooks so the hooks' module exports nothing but the hooks themselves.\n */\nimport {\n  type AiRefusal,\n  aiAllowedByContent,\n  aiSupports,\n  type ItemOutcome,\n  type LearnerResponse,\n  OPEN_DELIVERY_POLICY,\n  type ResolvedDeliveryPolicy,\n} from '@intellectif/lk-core';\nimport { isDevelopment } from '../components/_internal.js';\nimport type { RenderableActivity, RenderMode } from '../components/types.js';\nimport type { LearnerAi } from './LkAiProvider.js';\n\n/** The most hints a question gives when the host names no number, and the most it may name. */\nconst DEFAULT_MAX_HINTS = 3;\nconst MAX_HINTS_CEILING = 10;\n\n/** `maxHints` as a whole number from 1 to 10; anything else is the default. */\nexport function hintLimit(ai: LearnerAi | undefined): number {\n  const asked = ai?.maxHints;\n  return typeof asked === 'number' && Number.isInteger(asked) && asked >= 1\n    ? Math.min(asked, MAX_HINTS_CEILING)\n    : DEFAULT_MAX_HINTS;\n}\n\n/**\n * Whether the learner may ask for a hint: `practice`, before submit, on a\n * question that is not disabled, of a type that takes hints, whose author left\n * hints on, and whole — a redacted item is an exam's, and gives none.\n */\nexport function hintOffered(input: {\n  data: RenderableActivity;\n  renderMode: RenderMode;\n  submitted: boolean;\n  disabled: boolean;\n  /** The paper's policy: hints at all, and AI hints in particular. Open when absent. */\n  delivery?: ResolvedDeliveryPolicy;\n}): boolean {\n  const { data, renderMode, submitted, disabled } = input;\n  const delivery = input.delivery ?? OPEN_DELIVERY_POLICY;\n  return (\n    delivery.hints &&\n    delivery.ai.hints &&\n    renderMode === 'practice' &&\n    !submitted &&\n    !disabled &&\n    data.redacted !== true &&\n    aiSupports(data.type, 'hint') &&\n    aiAllowedByContent(data, 'hint')\n  );\n}\n\n/**\n * Whether the learner may ask for an explanation: of a graded answer — in\n * `practice` once submitted, or in `review` when the grade of record is\n * scored — of a type the SDK explains, whose author left explanations on.\n * Never in `exam`.\n */\nexport function explanationOffered(input: {\n  data: RenderableActivity;\n  renderMode: RenderMode;\n  submitted: boolean;\n  outcome: ItemOutcome | undefined;\n  /**\n   * The paper's policy. An explanation needs AI explanations on, and more: it\n   * explains a grade, so it needs the grade shown (`feedback`), and it all but\n   * always says what the right answer was, so it needs `solutions` too. On a\n   * paper that hides the answer, \"Explain my answer\" would hand it over.\n   */\n  delivery?: ResolvedDeliveryPolicy;\n}): boolean {\n  const { data, renderMode, submitted, outcome } = input;\n  const delivery = input.delivery ?? OPEN_DELIVERY_POLICY;\n  if (!delivery.feedback || !delivery.solutions || !delivery.ai.explanations) {\n    return false;\n  }\n  const graded =\n    (renderMode === 'practice' && submitted) ||\n    (renderMode === 'review' && outcome?.status === 'scored');\n  return graded && aiSupports(data.type, 'explanation') && aiAllowedByContent(data, 'explanation');\n}\n\n/** Calls a port, turning a synchronous throw into a rejection. */\nexport function callPort<T>(call: () => Promise<T>): Promise<T> {\n  try {\n    return Promise.resolve(call());\n  } catch (error) {\n    return Promise.reject(error);\n  }\n}\n\n/** Tells a developer why a port's answer was not shown. Silent in production. */\nexport function warnRefused(\n  feature: 'explanation' | 'hint',\n  activityId: string,\n  reason: AiRefusal,\n): void {\n  if (isDevelopment()) {\n    console.warn(\n      `learning-kit: the AI ${feature} for \"${activityId}\" was not shown (${reason}). The learner saw \"not available\" instead.`,\n    );\n  }\n}\n\n/** The language to write in: the host's choice for the learner, else the interface language. */\nexport const localeOf = (\n  ai: LearnerAi | undefined,\n  locale: string | undefined,\n): { learnerLocale?: string } => {\n  const chosen = ai?.learnerLocale ?? locale;\n  return chosen === undefined ? {} : { learnerLocale: chosen };\n};\n\n/** What an explanation is about: when any of it changes, the explanation shown no longer is. */\nexport function explanationKey(\n  renderMode: RenderMode,\n  submitted: boolean,\n  response: LearnerResponse,\n  outcome: ItemOutcome | undefined,\n): string {\n  let graded = '';\n  if (outcome !== undefined) {\n    graded = `${outcome.status}:${'score' in outcome ? outcome.score : ''}`;\n  }\n  return `${renderMode}|${submitted}|${graded}|${JSON.stringify(response)}`;\n}\n","'use client';\n\nimport {\n  type AiTextResult,\n  aiExplanationRequest,\n  aiHintRequest,\n  checkAiExplanation,\n  checkAiHint,\n  combineDeliveryPolicies,\n  type DeliveryPolicy,\n  type InteractionEvent,\n  type ItemOutcome,\n  type LearnerResponse,\n} from '@intellectif/lk-core';\nimport { useCallback, useContext, useEffect, useRef, useState } from 'react';\nimport { SequenceSlotContext } from '../components/shared/sequence-slot.js';\nimport type { RenderableActivity, RenderMode } from '../components/types.js';\nimport { type LearnerAi, useLearnerAi } from './LkAiProvider.js';\nimport {\n  callPort,\n  explanationKey,\n  explanationOffered,\n  hintLimit,\n  hintOffered,\n  localeOf,\n  warnRefused,\n} from './rules.js';\n\n/**\n * The question AI help is being asked about, as the SDK's own components know\n * it. A host drawing its own question passes what it has; everything optional\n * defaults to what the components pass.\n */\nexport interface AiHelpSituation {\n  /** The question, as `data` is given to any activity component. */\n  data: RenderableActivity;\n  /** The learner's answer as it stands: submitted, restored, or being written. */\n  response: LearnerResponse;\n  /** Whether the learner has committed that answer. */\n  submitted: boolean;\n  /**\n   * Pass on the `renderMode` your question was given. Left out, the paper\n   * around the question answers for it — a question inside `<ActivitySequence>`\n   * or `<InteractiveVideo>` knows its mode — and `practice` only where there is\n   * no paper at all. An `exam` around the question wins over anything passed\n   * here.\n   */\n  renderMode?: RenderMode;\n  /**\n   * The AI ports to use, overriding {@link LkAiProvider}'s for this question.\n   * A question inside `<ActivitySequence>` or `<InteractiveVideo>` is handed\n   * the ports in force as `ai` — pass that straight in.\n   */\n  ai?: LearnerAi;\n  /** The interface language: the default language for what a model writes. */\n  locale?: string;\n  /** Where `ai-hint-shown` and `ai-explanation-shown` go. */\n  onInteraction?: (event: InteractionEvent) => void;\n  /**\n   * The delivery policy your question was handed. The paper around the\n   * question holds as well — a set that switched AI hints off keeps them off\n   * here, whatever is passed — so leaving it out never turns anything on.\n   */\n  delivery?: DeliveryPolicy | null;\n}\n\nexport interface AiExplanationInput extends AiHelpSituation {\n  /** The grade of record, which `review` explains. */\n  outcome?: ItemOutcome;\n}\n\nexport interface AiExplanationHelp {\n  /**\n   * Whether to offer the learner an explanation at all: a port is present, the\n   * answer is graded, the type is one the SDK explains, and the author left\n   * explanations on. False in `exam`, always.\n   */\n  offered: boolean;\n  status: 'idle' | 'loading' | 'shown' | 'unavailable';\n  /** What to show, once it has arrived and been checked. Its `text` is text, never HTML. */\n  explanation: AiTextResult | null;\n  /**\n   * Asks the port, when the learner presses something. Does nothing while a\n   * call is on its way, and nothing at all where `offered` is false — so an\n   * exam cannot reach a model through this hook, whatever ports are in scope.\n   *\n   * One identity for the life of the question, so it is safe in an effect's\n   * dependencies.\n   */\n  ask: () => void;\n}\n\nexport interface AiHintsInput extends AiHelpSituation {\n  /** A disabled question gives no hints, as it takes no answer. */\n  disabled?: boolean;\n}\n\nexport interface AiHintsHelp {\n  /**\n   * Whether the learner may ask for hints here at all: a port is present, the\n   * mode is `practice`, the answer is not in, the question is not disabled or\n   * redacted, the type takes hints and the author left them on. It stays true\n   * once `used` reaches `limit` — there are no more to give, but the question\n   * is still one that gives them.\n   */\n  offered: boolean;\n  status: 'idle' | 'loading' | 'unavailable';\n  /** Every hint shown for this question, in the order they were given. */\n  hints: readonly AiTextResult[];\n  /** The host's `maxHints`, as a whole number from 1 to 10 (3 by default). */\n  limit: number;\n  /** How many hints have been shown. A refused hint is not counted. */\n  used: number;\n  /**\n   * Asks for the next hint. Does nothing at the limit, while a call is on its\n   * way, or where `offered` is false. One identity for the life of the\n   * question.\n   */\n  ask: () => void;\n}\n\n/**\n * The mode a question is answered in: what the caller says, and what the paper\n * around it says.\n *\n * A host drawing its own question is given `renderMode` like every other prop\n * and is expected to pass it on, but nothing makes it — and a hook that took\n * `practice` on trust would offer hints on a paper of record, as soon as an\n * `LkAiProvider` sat anywhere above the pager. So an `exam` around the question\n * wins, and where the caller says nothing the paper answers for it. A question\n * standing on its own belongs to no paper, and is `practice` as before.\n */\nfunction modeInForce(asked: RenderMode | undefined, around: RenderMode | undefined): RenderMode {\n  if (around === 'exam') {\n    return 'exam';\n  }\n  return asked ?? around ?? 'practice';\n}\n\n/**\n * What the record of help a learner was shown carries beside the fact of it:\n * who wrote it, and what the call cost — both only where the port sent them.\n *\n * The text is deliberately absent. A host that wants to keep what a learner\n * read has it in its own port; an interaction is a record of what happened, and\n * is kept for every learner and every question.\n */\nfunction shownPayload(result: AiTextResult): Record<string, unknown> {\n  return {\n    ...(result.provenance !== undefined ? { provenance: result.provenance } : {}),\n    ...(result.usage !== undefined ? { usage: result.usage } : {}),\n  };\n}\n\ntype ExplanationState =\n  | { key: string; status: 'idle' | 'loading' | 'unavailable' }\n  | { key: string; status: 'shown'; result: AiTextResult };\n\n/**\n * \"Explain my answer\", without the SDK's own button and panel: the rules, the\n * call, the checks and the record, for a question you draw yourself.\n *\n * It is what `<MultipleChoice>` and the others use, so a host's own question\n * offers help on exactly the same terms: never in `exam`, never where the\n * item's author switched explanations off, and never an explanation whose\n * verdict contradicts the grade the SDK computed.\n *\n * ```tsx\n * const { offered, status, explanation, ask } = useAiExplanation({\n *   data, response, submitted, renderMode, outcome, ai: question.ai,\n * });\n * if (!offered) return null;\n * return explanation === null ? (\n *   <button type=\"button\" onClick={ask} aria-busy={status === 'loading'}>Explain my answer</button>\n * ) : (\n *   <section>\n *     <p>{explanation.text}</p>\n *     <p>Written by AI. It can make mistakes.</p>\n *   </section>\n * );\n * ```\n *\n * **Say who wrote it.** The SDK's own panel carries \"Written by AI. It can make\n * mistakes.\"; a page that drops that line passes a model's words off as the\n * course's.\n *\n * When the answer or its grade changes, the explanation is dropped and a call\n * still on its way is abandoned — a late explanation never lands beside an\n * answer it was not written for — as it is when the caller unmounts.\n */\nexport function useAiExplanation(input: AiExplanationInput): AiExplanationHelp {\n  const { data, response, submitted, outcome } = input;\n  const around = useContext(SequenceSlotContext);\n  const renderMode = modeInForce(input.renderMode, around?.renderMode);\n  const delivery = combineDeliveryPolicies(input.delivery, around?.delivery);\n  const ai = useLearnerAi(input.ai);\n  const resetKey = explanationKey(renderMode, submitted, response, outcome);\n  const [state, setState] = useState<ExplanationState>({ key: resetKey, status: 'idle' });\n  const run = useRef(0);\n  const controller = useRef<AbortController | null>(null);\n  const current: ExplanationState =\n    state.key === resetKey ? state : { key: resetKey, status: 'idle' };\n  const offered =\n    ai?.explain !== undefined &&\n    explanationOffered({ data, renderMode, submitted, outcome, delivery });\n\n  // What `ask` reads, as of this render, so `ask` itself can keep one identity\n  // for the life of the question. The state goes in too: an event handler runs\n  // after the render that set it, so the ref is what the learner last saw.\n  const latest = useRef({ input, renderMode, ai, resetKey, offered, current });\n  latest.current = { input, renderMode, ai, resetKey, offered, current };\n\n  // Another answer, or the caller going away: abandon the call in flight.\n  // biome-ignore lint/correctness/useExhaustiveDependencies: the key is the trigger — its cleanup runs when the answer changes\n  useEffect(() => {\n    return () => {\n      run.current += 1;\n      controller.current?.abort();\n      controller.current = null;\n    };\n  }, [resetKey]);\n\n  const ask = useCallback((): void => {\n    const now = latest.current;\n    const port = now.ai?.explain;\n    if (port === undefined || !now.offered || now.current.status === 'loading') {\n      return;\n    }\n    const key = now.resetKey;\n    const request = aiExplanationRequest({\n      data: now.input.data,\n      response: now.input.response,\n      ...(now.renderMode === 'review' && now.input.outcome !== undefined\n        ? { outcome: now.input.outcome }\n        : {}),\n      ...localeOf(now.ai, now.input.locale),\n    });\n    if (request === null) {\n      setState({ key, status: 'unavailable' });\n      return;\n    }\n    run.current += 1;\n    const mine = run.current;\n    controller.current?.abort();\n    const abort = new AbortController();\n    controller.current = abort;\n    setState({ key, status: 'loading' });\n    callPort(() => port(request, { signal: abort.signal })).then(\n      (raw) => {\n        if (run.current !== mine) {\n          return;\n        }\n        const checked = checkAiExplanation(raw, request);\n        if (!checked.ok) {\n          warnRefused('explanation', now.input.data.id, checked.refusal);\n          setState({ key, status: 'unavailable' });\n          latest.current.input.onInteraction?.({\n            type: 'ai-help-refused',\n            activityId: now.input.data.id,\n            timestamp: Date.now(),\n            payload: { feature: 'explanation', reason: checked.refusal },\n          });\n          return;\n        }\n        setState({ key, status: 'shown', result: checked.result });\n        latest.current.input.onInteraction?.({\n          type: 'ai-explanation-shown',\n          activityId: now.input.data.id,\n          timestamp: Date.now(),\n          payload: shownPayload(checked.result),\n        });\n      },\n      () => {\n        if (run.current === mine) {\n          setState({ key, status: 'unavailable' });\n        }\n      },\n    );\n  }, []);\n\n  return {\n    offered,\n    status: current.status,\n    explanation: current.status === 'shown' ? current.result : null,\n    ask,\n  };\n}\n\ninterface HintState {\n  key: string;\n  hints: AiTextResult[];\n  status: 'idle' | 'loading' | 'unavailable';\n}\n\n/**\n * \"Get a hint\", without the SDK's own button and list: the rules, the call, the\n * checks and the record, for a question you draw yourself.\n *\n * It is what `<MultipleChoice>` and the others use, so a host's own question\n * gives hints on exactly the same terms: only in `practice` before submit, up\n * to the host's limit, never on a redacted item or a type the SDK does not hint\n * for, and never a hint that gives the answer away — which is refused rather\n * than shown, and not counted.\n *\n * ```tsx\n * const { offered, status, hints, used, limit, ask } = useAiHints({\n *   data, response, submitted, renderMode, ai: question.ai,\n * });\n * ```\n *\n * **Say who wrote them**, as the SDK's own list does: \"Written by AI. It can\n * make mistakes.\"\n *\n * Keep the hints on screen after submit — the learner can see what they were\n * given — while `offered` turns false. Another question starts with none.\n */\nexport function useAiHints(input: AiHintsInput): AiHintsHelp {\n  const { data, submitted } = input;\n  const around = useContext(SequenceSlotContext);\n  const renderMode = modeInForce(input.renderMode, around?.renderMode);\n  const delivery = combineDeliveryPolicies(input.delivery, around?.delivery);\n  const disabled = input.disabled === true;\n  const ai = useLearnerAi(input.ai);\n  const resetKey = data.id;\n  const [state, setState] = useState<HintState>({ key: resetKey, hints: [], status: 'idle' });\n  const run = useRef(0);\n  const controller = useRef<AbortController | null>(null);\n  const current: HintState =\n    state.key === resetKey ? state : { key: resetKey, hints: [], status: 'idle' };\n  const offered =\n    ai?.hint !== undefined && hintOffered({ data, renderMode, submitted, disabled, delivery });\n  const limit = hintLimit(ai);\n\n  const latest = useRef({ input, renderMode, ai, offered, limit, current });\n  latest.current = { input, renderMode, ai, offered, limit, current };\n\n  // Another question, or the caller going away: abandon the call in flight.\n  // biome-ignore lint/correctness/useExhaustiveDependencies: the key is the trigger — its cleanup runs when the question changes\n  useEffect(() => {\n    return () => {\n      run.current += 1;\n      controller.current?.abort();\n      controller.current = null;\n    };\n  }, [resetKey]);\n\n  // Submitted, or disabled, while a hint was on its way: it would arrive for an\n  // answer that can no longer use it.\n  useEffect(() => {\n    if (!offered) {\n      run.current += 1;\n      controller.current?.abort();\n      controller.current = null;\n      setState((previous) =>\n        previous.status === 'loading' ? { ...previous, status: 'idle' } : previous,\n      );\n    }\n  }, [offered]);\n\n  const ask = useCallback((): void => {\n    const now = latest.current;\n    const port = now.ai?.hint;\n    const held = now.current;\n    if (\n      port === undefined ||\n      !now.offered ||\n      held.status === 'loading' ||\n      held.hints.length >= now.limit\n    ) {\n      return;\n    }\n    const key = held.key;\n    const request = aiHintRequest({\n      data: now.input.data,\n      response: now.input.response,\n      previousHints: held.hints.map((hint) => hint.text),\n      ...localeOf(now.ai, now.input.locale),\n    });\n    if (request === null) {\n      setState({ ...held, status: 'unavailable' });\n      return;\n    }\n    run.current += 1;\n    const mine = run.current;\n    controller.current?.abort();\n    const abort = new AbortController();\n    controller.current = abort;\n    setState({ ...held, status: 'loading' });\n    callPort(() => port(request, { signal: abort.signal })).then(\n      (raw) => {\n        if (run.current !== mine) {\n          return;\n        }\n        const checked = checkAiHint(raw, request);\n        if (!checked.ok) {\n          warnRefused('hint', now.input.data.id, checked.refusal);\n          setState((shown) => ({ ...shown, status: 'unavailable' }));\n          latest.current.input.onInteraction?.({\n            type: 'ai-help-refused',\n            activityId: now.input.data.id,\n            timestamp: Date.now(),\n            payload: {\n              feature: 'hint',\n              reason: checked.refusal,\n              hintNumber: request.hintNumber,\n            },\n          });\n          return;\n        }\n        setState((shown) => ({\n          ...shown,\n          hints: shown.key === key ? [...shown.hints, checked.result] : shown.hints,\n          status: 'idle',\n        }));\n        latest.current.input.onInteraction?.({\n          type: 'ai-hint-shown',\n          activityId: now.input.data.id,\n          timestamp: Date.now(),\n          payload: { hintNumber: request.hintNumber, ...shownPayload(checked.result) },\n        });\n      },\n      () => {\n        if (run.current === mine) {\n          setState((shown) => ({ ...shown, status: 'unavailable' }));\n        }\n      },\n    );\n  }, []);\n\n  return {\n    offered,\n    status: current.status,\n    hints: current.hints,\n    limit,\n    used: current.hints.length,\n    ask,\n  };\n}\n"]}

package/dist/chunk-UHIOVOFK.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/components/WrittenResponse/WrittenResponse.tsx","../src/components/WrittenResponse/index.tsx"],"names":["jsxs","Fragment","jsx","useLkStrings","useDeliveryPolicy","useMemo","isDevelopment","validateActivity","ActivitySchemaError","useActivityState","useState","useRef","useEffect","countWords","evaluate","xAPIBuilder","ANONYMOUS_ACTOR","objectIdFor","ActivityMedia","FeedbackRegion","outcomeShowsMarks","WrittenResponse","ActivityErrorBoundary"],"mappings":"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","file":"chunk-UHIOVOFK.cjs","sourcesContent":["'use client';\n\nimport {\n  ActivitySchemaError,\n  type CriterionScore,\n  countWords,\n  type DeliveryPolicy,\n  evaluate,\n  type GradeRecord,\n  type InlineCorrection,\n  type InteractionEvent,\n  type ItemOutcome,\n  type LearnerResponse,\n  type ThemeTokens,\n  validateActivity,\n  type WrittenResponseData,\n  type XAPIStatement,\n  xAPIBuilder,\n} from '@intellectif/lk-core';\nimport { type CSSProperties, useEffect, useMemo, useRef, useState } from 'react';\nimport { useActivityState } from '../../hooks/useActivityState.js';\nimport { useLkStrings } from '../../i18n/LkIntlProvider.js';\nimport type { LkStrings, LkStringsOverride } from '../../i18n/strings.js';\nimport { ANONYMOUS_ACTOR, isDevelopment, objectIdFor } from '../_internal.js';\nimport { ActivityMedia } from '../shared/ActivityMedia.js';\nimport { outcomeShowsMarks, useDeliveryPolicy } from '../shared/delivery.js';\nimport { FeedbackRegion } from '../shared/FeedbackRegion.js';\nimport type {\n  HtmlSanitizer,\n  MediaBudgetBinding,\n  MediaTransportStrings,\n  Renderable,\n  RenderMode,\n} from '../types.js';\n\n/**\n * Payload delivered when the learner submits a written response. Grading is\n * DEFERRED (asynchronous AI/human grading), so there is no score here — and\n * deliberately no fake one: an ungraded submission must never be shown or\n * stored as a 0. The consumer persists `text` and grades it out-of-band.\n */\nexport interface WrittenResponseSubmission {\n  /** The submitted text, verbatim. */\n  text: string;\n  /** Word count of `text`, recomputed with the canonical `countWords()`. */\n  wordCount: number;\n  /** Whether `wordCount` falls within the activity's `[minWords, maxWords]`. */\n  withinWordBounds: boolean;\n  /** Time in milliseconds from first interaction to submission. */\n  timeSpent: number;\n  /** The SUBMITTED-verb xAPI statement built for this submission (no score fields). */\n  xapiStatement: XAPIStatement;\n}\n\n/**\n * Props for {@link WrittenResponse}. Mirrors `ActivityProps` except for the\n * completion callback: a deferred-grading activity completes with a\n * {@link WrittenResponseSubmission} (`onSubmitted`), not a scored\n * `ActivityResult` (`onComplete`) — deviation from Req 22.8 recorded in the\n * roadmap (§3.1): fabricating a score of 0 for ungraded work is the exact\n * bug this type exists to fix. Everything else — controlled value, render\n * mode, server outcome, rich text — follows the shared `ActivityProps`\n * contract verbatim.\n */\nexport interface WrittenResponseProps {\n  /** Activity content. Accepts a `redact()` projection in `exam` mode. */\n  data: Renderable<WrittenResponseData>;\n  /**\n   * Called on submit with the ungraded submission (text, recomputed word\n   * count, bounds flag, timing, xAPI statement). Fires in `practice` and\n   * `exam` mode, after `onSubmit`; never in `review`.\n   *\n   * Optional since lk-react 2.1.0 so a `review`-mode render (which has no submit\n   * control) and an exam runner that only wants the raw response through\n   * `onSubmit` do not have to pass a no-op. Supply it in `practice`/`exam`\n   * unless `onSubmit` already captures everything you persist.\n   */\n  onSubmitted?: (submission: WrittenResponseSubmission) => void;\n  /**\n   * Called on submit with the raw learner response and no grade, BEFORE\n   * `onSubmitted`. This is the only submit callback an exam runner needs:\n   * the server grades the text and returns an {@link ItemOutcome} later.\n   */\n  onSubmit?: (response: LearnerResponse) => void;\n  /**\n   * Controlled value: the learner's current response. When present the\n   * textarea renders from it (never from internal state) and every keystroke\n   * goes out through `onChange` — restore an in-progress attempt, autosave a\n   * delta, or drive a review render with it.\n   */\n  value?: LearnerResponse;\n  /** Initial response for an uncontrolled component (ignored when `value` is set). */\n  defaultValue?: LearnerResponse;\n  /**\n   * Mount as already submitted — read at mount only. Without it a resumed\n   * attempt reopens an essay the learner had already submitted as editable\n   * and re-submittable.\n   */\n  defaultSubmitted?: boolean;\n  /** Fires on every change to the learner's response. Required for a controlled component. */\n  onChange?: (response: LearnerResponse) => void;\n  /**\n   * Presentation mode, default `practice`. `practice` and `exam` are nearly\n   * identical here — a written response is never graded client-side, so\n   * there is no local score to withhold; `exam` additionally never calls\n   * `evaluate()` and renders happily from a `redact()` projection.\n   * `review` is read-only and shows the server's `outcome`.\n   */\n  renderMode?: RenderMode;\n  /**\n   * Server-computed outcome, rendered by `review` mode: `deferred` shows a\n   * \"not graded yet\" affordance, `scored` shows the returned grade and\n   * feedback. Ignored in other modes — this component never manufactures an\n   * outcome of its own.\n   */\n  outcome?: ItemOutcome;\n  /** Renders `data.promptHtml` when provided. See `HtmlSanitizer`. */\n  sanitizeHtml?: HtmlSanitizer;\n  /** Binds this activity's own `data.media` to a play budget. See {@link MediaBudgetBinding}. */\n  mediaBudget?: MediaBudgetBinding;\n  /** Translations for the audio transport chrome. See {@link MediaTransportStrings}. */\n  mediaStrings?: Partial<MediaTransportStrings>;\n  /** Overrides the SDK's chrome text for this activity. See {@link LkIntlProvider}. */\n  strings?: LkStringsOverride;\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   * The delivery policy. An essay is graded later, so only `feedback` reaches\n   * it: `false` reads a returned grade back as nothing in `review`. See\n   * `DeliveryPolicy` in lk-core.\n   */\n  delivery?: DeliveryPolicy | null;\n}\n\n/**\n * Reads the text out of a learner response. Another activity type's response\n * shape (the `value`/`defaultValue` props take the `LearnerResponse` union,\n * so a generic runner can hand any of them over) reads as empty rather than\n * throwing mid-exam.\n */\nfunction textOf(response: LearnerResponse | undefined): string {\n  return response !== undefined && response.type === 'written-response' ? response.text : '';\n}\n\n/**\n * One criterion's score as a percentage of its OWN maximum.\n *\n * `CriterionScore.maxScore` defaults to 1 — the SDK's scaled convention — but\n * a grader may work out of 100, or out of 9 for a CEFR band, and\n * `gradeFromRubric` deliberately stores those judgements verbatim so a grade\n * stays auditable in the units the grader actually used. It normalises when it\n * computes the total; anything DISPLAYING a criterion has to normalise too, or\n * a perfectly ordinary 82/100 renders as \"8200%\". This is the same guard the\n * overall score already applies against `outcome.maxScore`.\n */\nfunction criterionPercent(criterion: CriterionScore): string {\n  const max = criterion.maxScore !== undefined && criterion.maxScore > 0 ? criterion.maxScore : 1;\n  return `${Math.round(((criterion.score as number) / max) * 100)}%`;\n}\n\n/**\n * Pairs each correction with a list key that is unique by construction. The\n * same mistake made twice carries the same `original`/`corrected` pair, so\n * the grader's `range` is what tells the occurrences apart. `range` is\n * optional and nothing validates it, so a correction without one — or one\n * whose range the grader already used — is keyed by its position instead.\n * Only position keys start with `#`, so the two kinds never collide.\n */\nfunction keyedCorrections(\n  corrections: readonly InlineCorrection[],\n): { key: string; correction: InlineCorrection }[] {\n  const used = new Set<string>();\n  return corrections.map((correction, index) => {\n    const anchored = correction.range\n      ? `${correction.range.start}-${correction.range.end}:${correction.corrected}`\n      : undefined;\n    const key = anchored !== undefined && !used.has(anchored) ? anchored : `#${index}`;\n    used.add(key);\n    return { key, correction };\n  });\n}\n\n/**\n * Renders the server-computed outcome in `review` mode. The grade shown here\n * always came back from the asynchronous grader — nothing on this path scores,\n * infers, or defaults a grade. A `written-response` outcome carries no\n * per-item `details` (there are no options or blanks to mark), so the render\n * is the scaled score, the pass state, and the grader's feedback.\n */\nfunction GradeBody({ grade, s }: { grade: GradeRecord; s: LkStrings }) {\n  return (\n    <>\n      {grade.feedback ? <p className=\"lk-wr-grade-feedback\">{grade.feedback}</p> : null}\n      {grade.criteria && grade.criteria.length > 0 ? (\n        <ul className=\"lk-wr-criteria\">\n          {grade.criteria.map((criterion) => (\n            <li\n              className=\"lk-wr-criterion\"\n              key={criterion.name}\n              data-na={String(criterion.notApplicable === true)}\n            >\n              <span className=\"lk-wr-criterion-name\">{criterion.name}</span>\n              {criterion.notApplicable === true ? (\n                <span className=\"lk-wr-criterion-score\">{s.notApplicable}</span>\n              ) : (\n                <span className=\"lk-wr-criterion-score\">\n                  {criterion.band ??\n                    (typeof criterion.score === 'number' ? criterionPercent(criterion) : '')}\n                </span>\n              )}\n              {criterion.comment ? (\n                <span className=\"lk-wr-criterion-comment\">{criterion.comment}</span>\n              ) : null}\n            </li>\n          ))}\n        </ul>\n      ) : null}\n      {grade.corrections && grade.corrections.length > 0 ? (\n        <ul className=\"lk-wr-corrections\">\n          {keyedCorrections(grade.corrections).map(({ key, correction }) => (\n            <li className=\"lk-wr-correction\" key={key}>\n              <del className=\"lk-wr-correction-original\">{correction.original}</del>{' '}\n              <ins className=\"lk-wr-correction-corrected\">{correction.corrected}</ins>\n              {correction.explanation ? (\n                <span className=\"lk-wr-correction-explanation\">{correction.explanation}</span>\n              ) : null}\n            </li>\n          ))}\n        </ul>\n      ) : null}\n      {grade.requiresHumanReview === true ? (\n        <p className=\"lk-wr-review-flag\">{s.awaitingHumanReview}</p>\n      ) : null}\n    </>\n  );\n}\n\n/**\n * Renders the server-computed outcome in `review` mode. The grade shown here\n * always came back from the grader — nothing on this path scores, infers, or\n * defaults a grade.\n */\nfunction OutcomeSummary({ outcome, s }: { outcome: ItemOutcome; s: LkStrings }) {\n  if (outcome.status === 'scored' || outcome.status === 'graded') {\n    // `score` is scaled [0–1] against `maxScore`; normalising by `maxScore`\n    // is a no-op for the canonical maxScore of 1 and keeps an unscaled\n    // grader payload (8.5 / 10) from rendering as 850%.\n    const percent =\n      outcome.maxScore > 0\n        ? Math.round((outcome.score / outcome.maxScore) * 100)\n        : Math.round(outcome.score * 100);\n    return (\n      <div\n        className=\"lk-wr-outcome\"\n        data-status={outcome.status}\n        data-passed={String(outcome.passed)}\n      >\n        <p className=\"lk-wr-grade\">{s.scoreAnnouncement(percent, outcome.passed)}</p>\n        {outcome.status === 'graded' ? (\n          <GradeBody grade={outcome.grade} s={s} />\n        ) : outcome.feedback ? (\n          <p className=\"lk-wr-grade-feedback\">{outcome.feedback}</p>\n        ) : null}\n      </div>\n    );\n  }\n  if (outcome.status === 'deferred') {\n    return (\n      <div className=\"lk-wr-outcome\" data-status=\"deferred\">\n        <p className=\"lk-wr-grade\">{s.awaitingGrade}</p>\n      </div>\n    );\n  }\n  // `unscorable` reasons are developer-facing strings; surface the state, not\n  // the reason, and leave it on the element for diagnostics.\n  return (\n    <div className=\"lk-wr-outcome\" data-status=\"unscorable\" data-reason={outcome.reason}>\n      <p className=\"lk-wr-grade\">{s.couldNotBeGraded}</p>\n    </div>\n  );\n}\n\nexport function WrittenResponse({\n  data,\n  onSubmitted,\n  onSubmit,\n  value,\n  defaultValue,\n  defaultSubmitted,\n  onChange,\n  renderMode = 'practice',\n  outcome,\n  sanitizeHtml,\n  mediaBudget,\n  mediaStrings,\n  strings,\n  onInteraction,\n  theme,\n  locale,\n  disabled,\n  delivery,\n}: WrittenResponseProps) {\n  // Dev-only boundary validation (Req 2.3), same convention as MC/FIB. The\n  // content schema is loose, so a `redact()` projection validates too.\n  const s = useLkStrings(strings);\n  // An essay is graded later, so `feedback` is the one setting that reaches\n  // it: whether a returned grade — the score, each criterion, the corrections\n  // — is read back in review.\n  const policy = useDeliveryPolicy(delivery);\n\n  const devError = useMemo(() => {\n    if (!isDevelopment()) {\n      return null;\n    }\n    const result = validateActivity('written-response', data);\n    return result.success ? null : new ActivitySchemaError('written-response', result.errors);\n  }, [data]);\n\n  const { state, start, complete, getTimeSpent, reset } = useActivityState(\n    defaultSubmitted === true ? 'completed' : 'idle',\n  );\n  const isControlled = value !== undefined;\n  const [innerText, setInnerText] = useState<string>(() => textOf(defaultValue));\n  const [summary, setSummary] = useState<string | null>(null);\n\n  /**\n   * Rich text is rendered ONLY through a caller-supplied sanitiser, and only\n   * when the author actually shipped the HTML sidecar. Without both, the\n   * plain-text prompt is rendered as an escaped React child.\n   */\n  const promptHtml = useMemo(() => {\n    if (sanitizeHtml === undefined || typeof data.promptHtml !== 'string') {\n      return null;\n    }\n    return sanitizeHtml(data.promptHtml);\n  }, [data.promptHtml, sanitizeHtml]);\n\n  // Latest seed text, kept in a ref so `defaultValue` is NOT a reset trigger:\n  // callers pass an object literal, whose identity changes every render.\n  const defaultTextRef = useRef<string>(textOf(defaultValue));\n  useEffect(() => {\n    defaultTextRef.current = textOf(defaultValue);\n  }, [defaultValue]);\n\n  // Reset on data-prop change (Req 3.7): back to the seed (empty when there\n  // is none — the v1 behaviour), never the previous activity's draft.\n  // Mirror `defaultSubmitted` so the reset below returns to the SEEDED state.\n  // Resetting unconditionally to idle unlocked an item the learner had already\n  // committed — which made `defaultSubmitted` a no-op here, since this effect\n  // runs right after the first paint.\n  const defaultSubmittedRef = useRef(defaultSubmitted);\n  useEffect(() => {\n    defaultSubmittedRef.current = defaultSubmitted;\n  }, [defaultSubmitted]);\n\n  // Identity guard so the MOUNT run is a no-op. Without it this effect fires\n  // after the first paint and undoes every seed it was just given; with it,\n  // only a real `data` change resets. A parent that rebuilds structurally\n  // identical entries in render (`activities={raw.map(redact)}`) must not\n  // unlock or revert a restored answer — the pager already remounts a slot\n  // whose activity actually changed, via its key.\n  const lastDataRef = useRef(data);\n  useEffect(() => {\n    if (lastDataRef.current === data) {\n      return;\n    }\n    lastDataRef.current = data;\n    setInnerText(defaultTextRef.current);\n    setSummary(null);\n    reset(defaultSubmittedRef.current === true ? 'completed' : 'idle');\n  }, [data, reset]);\n\n  if (devError) {\n    throw devError;\n  }\n\n  const isExam = renderMode === 'exam';\n  const isReview = renderMode === 'review';\n\n  const text = isControlled ? textOf(value) : innerText;\n  const submitted = state === 'completed';\n  const inactive = disabled === true || submitted || isReview;\n  const wordCount = countWords(text);\n  const withinBounds = wordCount >= data.minWords && wordCount <= data.maxWords;\n\n  const handleChange = (next: string): void => {\n    if (inactive) {\n      return;\n    }\n    if (state === 'idle') {\n      start();\n    }\n    // A controlled component renders from `props.value` only; the caller's\n    // state is the single source of truth for the text.\n    if (!isControlled) {\n      setInnerText(next);\n    }\n    const nextWordCount = countWords(next);\n    onChange?.({ type: 'written-response', text: next, wordCount: nextWordCount });\n    onInteraction?.({\n      type: 'text-changed',\n      activityId: data.id,\n      timestamp: Date.now(),\n      payload: { wordCount: nextWordCount },\n    });\n  };\n\n  // Practice reveals nothing an essay could leak, but it DOES run the local\n  // submit path and emit a practice xAPI statement for work the server is\n  // supposed to grade. MultipleChoice and FillInTheBlanks have refused\n  // redacted data in `practice` since 0.5.0; this component silently accepted\n  // it, so an all-essay redacted paper mounted without `renderMode` looked\n  // entirely healthy end to end. Fail at render, like its siblings.\n  if (data.redacted === true && renderMode === 'practice') {\n    throw new Error(\n      `Written Response \"${data.id}\" received redacted activity data in renderMode \"practice\". ` +\n        'Practice runs the local submit path and emits a practice-mode xAPI statement, so an ' +\n        'exam item wired this way is graded nowhere and looks fine while it happens. ' +\n        'Render redacted data with renderMode=\"exam\" (server grades) or \"review\" (pass `outcome`).',\n    );\n  }\n\n  const handleSubmit = (event: React.FormEvent): void => {\n    event.preventDefault();\n    if (inactive || text.trim().length === 0) {\n      return;\n    }\n    let finalWordCount = wordCount;\n    let finalWithinBounds = withinBounds;\n    // `exam` mode must not call evaluate(): the component does not grade, and\n    // a redacted projection carries no scoring input anyway. The two facts\n    // evaluate() returns for a deferred type (recomputed word count, bounds)\n    // are exactly what is computed above, so the payload is identical either\n    // way; practice keeps going through core so the numbers stay canonical.\n    if (!isExam) {\n      const itemOutcome = evaluate(data, { type: 'written-response', text, wordCount });\n      const partial = itemOutcome.status === 'deferred' ? itemOutcome.partial : undefined;\n      if (typeof partial?.wordCount === 'number') {\n        finalWordCount = partial.wordCount;\n      }\n      if (typeof partial?.withinWordBounds === 'boolean') {\n        finalWithinBounds = partial.withinWordBounds;\n      }\n    }\n    complete();\n    const timeSpent = getTimeSpent();\n    const xapiStatement = xAPIBuilder.buildSubmittedStatement({\n      actor: ANONYMOUS_ACTOR,\n      object: {\n        id: objectIdFor(data.id),\n        name: { [data.locale ?? 'en-US']: data.title },\n        type: 'http://adlnet.gov/expapi/activities/cmi.interaction',\n        interactionType: 'long-fill-in',\n      },\n      timeSpentMs: timeSpent,\n      response: text,\n      resultExtensions: {\n        'urn:learning-kit:extension:word-count': finalWordCount,\n        'urn:learning-kit:extension:within-word-bounds': finalWithinBounds,\n      },\n    });\n    // Raw response first (an exam runner persists this), then the fuller\n    // ungraded submission — mirroring `onSubmit` before `onComplete`.\n    onSubmit?.({ type: 'written-response', text, wordCount: finalWordCount });\n    onSubmitted?.({\n      text,\n      wordCount: finalWordCount,\n      withinWordBounds: finalWithinBounds,\n      timeSpent,\n      xapiStatement,\n    });\n    setSummary(s.responseSubmitted);\n    onInteraction?.({\n      type: 'submitted',\n      activityId: data.id,\n      timestamp: Date.now(),\n      payload: { wordCount: finalWordCount, withinWordBounds: finalWithinBounds },\n    });\n  };\n\n  const promptId = `${data.id}-prompt`;\n  const counterId = `${data.id}-counter`;\n  const boundsLabel = s.wordBounds(data.minWords, data.maxWords);\n\n  return (\n    <form\n      className=\"lk-wr\"\n      aria-label={data.title}\n      lang={locale}\n      data-render-mode={renderMode}\n      style={theme as CSSProperties | undefined}\n      onSubmit={handleSubmit}\n    >\n      {data.media ? (\n        <ActivityMedia\n          media={data.media}\n          renderMode={renderMode}\n          {...(mediaBudget !== undefined ? { mediaBudget } : {})}\n          {...(mediaStrings !== undefined ? { mediaStrings } : {})}\n          {...(strings !== undefined ? { strings } : {})}\n          {...(onInteraction !== undefined ? { onInteraction } : {})}\n          {...(locale !== undefined ? { locale } : {})}\n        />\n      ) : null}\n      {promptHtml === null ? (\n        <p className=\"lk-wr-prompt\" id={promptId}>\n          {data.prompt}\n        </p>\n      ) : (\n        // A div, not a p: sanitised author HTML may contain block content.\n        <div\n          className=\"lk-wr-prompt\"\n          id={promptId}\n          // biome-ignore lint/security/noDangerouslySetInnerHtml: rendered only through the caller-supplied HtmlSanitizer — the SDK never injects unsanitised markup\n          dangerouslySetInnerHTML={{ __html: promptHtml }}\n        />\n      )}\n      <textarea\n        className=\"lk-wr-textarea\"\n        aria-labelledby={promptId}\n        aria-describedby={counterId}\n        value={text}\n        onChange={(event) => handleChange(event.target.value)}\n        // `review` uses readOnly rather than disabled: the submitted essay\n        // must stay focusable, selectable and scrollable for a screen reader\n        // and a keyboard, while remaining uneditable.\n        disabled={!isReview && inactive}\n        readOnly={isReview}\n        rows={8}\n      />\n      <div\n        className=\"lk-wr-counter\"\n        id={counterId}\n        aria-live=\"polite\"\n        data-within-bounds={withinBounds}\n      >\n        {s.wordCount(wordCount)} ({boundsLabel})\n      </div>\n      {isReview ? null : (\n        <button\n          type=\"submit\"\n          className=\"lk-wr-submit\"\n          disabled={inactive || text.trim().length === 0}\n        >\n          {s.submit}\n        </button>\n      )}\n      <FeedbackRegion id={`${data.id}-feedback`}>\n        {isReview ? (\n          outcome && (policy.feedback || !outcomeShowsMarks(outcome)) ? (\n            <OutcomeSummary outcome={outcome} s={s} />\n          ) : null\n        ) : (\n          summary\n        )}\n      </FeedbackRegion>\n    </form>\n  );\n}\n","'use client';\n\nimport { useLkStrings } from '../../i18n/LkIntlProvider.js';\nimport { ActivityErrorBoundary } from '../ActivityErrorBoundary.js';\nimport {\n  WrittenResponse as WrittenResponseCore,\n  type WrittenResponseProps,\n} from './WrittenResponse.js';\n\nexport type { HtmlSanitizer, Renderable, RenderMode } from '../types.js';\nexport type { WrittenResponseProps, WrittenResponseSubmission } from './WrittenResponse.js';\n\n/**\n * Public Written Response activity: a labelled textarea with a live word\n * counter for free-text writing graded asynchronously (AI or human). The core\n * is wrapped in `ActivityErrorBoundary` so a render failure (incl. the dev\n * schema-validation throw) degrades to an accessible fallback.\n */\nexport function WrittenResponse(props: WrittenResponseProps) {\n  // Read here rather than in the boundary: a class component cannot call a\n  // hook, and the fallback it renders is learner-facing text like any other.\n  const strings = useLkStrings(props.strings);\n  return (\n    <ActivityErrorBoundary activityTitle={props.data?.title} strings={strings}>\n      <WrittenResponseCore {...props} />\n    </ActivityErrorBoundary>\n  );\n}\n"]}

package/dist/chunk-WBLYD5QA.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/components/shared/sequence-slot.ts"],"names":[],"mappings":";;;AAwDO,IAAM,mBAAA,GAAsB,cAA0C,IAAI;AASjF,IAAI,QAAA,GAAW,CAAA;AAGR,SAAS,QAAA,GAAmB;AACjC,EAAA,QAAA,IAAY,CAAA;AACZ,EAAA,OAAO,QAAA;AACT;AAOA,IAAM,KAAA,uBAAY,OAAA,EAAwB;AAGnC,SAAS,SAAA,CAA4B,OAAU,IAAA,EAAiB;AACrE,EAAA,KAAA,CAAM,GAAA,CAAI,OAAO,IAAI,CAAA;AACrB,EAAA,OAAO,KAAA;AACT;AAGO,SAAS,OAAO,KAAA,EAAoC;AACzD,EAAA,OAAO,OAAO,UAAU,QAAA,IAAY,KAAA,KAAU,OAAO,KAAA,CAAM,GAAA,CAAI,KAAK,CAAA,GAAI,MAAA;AAC1E","file":"chunk-WBLYD5QA.js","sourcesContent":["'use client';\n\nimport type { ResolvedDeliveryPolicy } from '@intellectif/lk-core';\nimport { createContext } from 'react';\nimport type { RenderMode } from '../types.js';\n\n/**\n * How far a take that was handed in has got, as a pager deciding whether its\n * set is finished needs to know it.\n *\n * - `in-flight` — being stored or being judged. The set waits for it.\n * - `retryable` — it failed, and the learner is being offered another try at\n *   the SAME take. The set waits for it while the learner is on that question.\n * - `settled` — nothing more will come of it: a grade, a take with no grade, a\n *   failure nobody can retry, or a take the learner walked away from.\n */\nexport type TakeState = 'in-flight' | 'retryable' | 'settled';\n\n/**\n * What a pager hands the one slot it renders, and only through\n * {@link SequenceSlotContext} — never as a prop, so none of it can appear on a\n * public component's signature. A consumer string in any of it could stop\n * another component's microphone or finish another paper's set.\n */\nexport interface SequenceSlotChannel {\n  /**\n   * The capture-registry group whose captures stop when the slot's pane is\n   * hidden. Minted per pager and per slot, so no two pagers share one.\n   */\n  readonly captureGroup: string;\n  /**\n   * The mode the PAPER around this question is being delivered in, read live.\n   *\n   * It is how the AI hooks know an exam they were not told about. A host that\n   * draws its own question passes `renderMode` on to them, but nothing makes\n   * it: the hooks would then default to `practice` and, under an\n   * `LkAiProvider` somewhere above, offer hints on a paper of record. The set\n   * around the question decides, and an `exam` here wins over anything the\n   * caller passes or forgets to pass.\n   */\n  readonly renderMode: RenderMode;\n  /**\n   * The delivery policy of the PAPER around this question, read live, for the\n   * same reason as the mode: whatever a host's own question was handed, the\n   * paper's restrictions hold in it. See `useDeliveryPolicy`.\n   */\n  readonly delivery: ResolvedDeliveryPolicy;\n  /**\n   * Reports the state of the take numbered `take`, a number from\n   * {@link mintTake}. A take numbered below the slot's latest is a take the\n   * learner has since replaced, and the pager ignores it.\n   */\n  takeState(take: number, state: TakeState): void;\n}\n\n/** `null` outside a pager: a standalone component belongs to no slot. */\nexport const SequenceSlotContext = createContext<SequenceSlotChannel | null>(null);\n\n/**\n * The last take number handed out. Module-level and never reset, so a number\n * is unique for the life of the page: across mounts, across papers, and across\n * two pagers side by side. A result can therefore only ever match the take that\n * produced it, whatever slot and activity ids a later paper reuses — ids a host\n * chooses, and can repeat, never decide it.\n */\nlet lastTake = 0;\n\n/** A take number no other take on this page has had, or will have. */\nexport function mintTake(): number {\n  lastTake += 1;\n  return lastTake;\n}\n\n/**\n * The take each reported value belongs to. A `WeakMap` rather than a field, so\n * a response or a result a host receives carries no extra key it would persist\n * or compare, and the number never outlives the object.\n */\nconst takes = new WeakMap<object, number>();\n\n/** Marks `value` as produced by take `take`, and returns it. */\nexport function stampTake<T extends object>(value: T, take: number): T {\n  takes.set(value, take);\n  return value;\n}\n\n/** The take `value` was produced by, or `undefined` when nothing stamped it. */\nexport function takeOf(value: unknown): number | undefined {\n  return typeof value === 'object' && value !== null ? takes.get(value) : undefined;\n}\n"]}

package/dist/chunk-YNDKAYW3.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/ai/LkAiProvider.tsx"],"names":[],"mappings":";;;;AAuCA,IAAM,WAAA,GAAc,cAAgC,IAAI,CAAA;AAqBjD,SAAS,YAAA,CAAa,EAAE,EAAA,EAAI,QAAA,EAAS,EAAyC;AACnF,EAAA,2BAAQ,WAAA,CAAY,QAAA,EAAZ,EAAqB,KAAA,EAAO,IAAK,QAAA,EAAS,CAAA;AACpD;AAGO,SAAS,aAAa,QAAA,EAA6C;AACxE,EAAA,MAAM,OAAA,GAAU,WAAW,WAAW,CAAA;AACtC,EAAA,OAAO,YAAY,OAAA,IAAW,MAAA;AAChC","file":"chunk-YNDKAYW3.js","sourcesContent":["'use client';\n\nimport type { AiExplanationRequest, AiHintRequest, AiTextResult } from '@intellectif/lk-core';\nimport { createContext, type ReactNode, useContext } from 'react';\n\n/**\n * The model a host runs for learners, as the components call it. The SDK never\n * calls a model, holds a key or writes a prompt: each port is the host's\n * function — usually a request to its own server, which holds the key and the\n * prompt and chooses the model.\n *\n * A port is called only when the learner asks — a button, never on render —\n * and gets an `AbortSignal` that fires when the answer it was asked about goes\n * away. Whatever it resolves to is checked before a learner sees it: see\n * `checkAiExplanation` and `checkAiHint` in lk-core. A port that rejects, or\n * resolves to something refused, costs the learner the help, never the\n * question.\n *\n * Leave a port out to switch that feature off. Nothing AI renders in `exam`,\n * whatever is passed.\n */\nexport interface LearnerAi {\n  /** Explains a graded answer. */\n  explain?: (\n    request: AiExplanationRequest,\n    options: { signal: AbortSignal },\n  ) => Promise<AiTextResult>;\n  /** Writes the next hint for an answer not yet submitted. */\n  hint?: (request: AiHintRequest, options: { signal: AbortSignal }) => Promise<AiTextResult>;\n  /** The most hints a learner can ask for on one question. Default 3, at most 10. */\n  maxHints?: number;\n  /**\n   * The language to write explanations and hints in — the learner's own,\n   * which in a language course need not be the item's. Defaults to the\n   * component's `locale`.\n   */\n  learnerLocale?: string;\n}\n\nconst LkAiContext = createContext<LearnerAi | null>(null);\n\nexport interface LkAiProviderProps {\n  ai: LearnerAi;\n  children: ReactNode;\n}\n\n/**\n * Supplies the host's AI ports to every activity beneath, as `LkIntlProvider`\n * supplies strings. A component's own `ai` prop wins over it, whole.\n *\n * ```tsx\n * <LkAiProvider ai={{\n *   explain: (request, { signal }) => api.explain(request, signal),\n *   hint: (request, { signal }) => api.hint(request, signal),\n *   learnerLocale: learner.language,\n * }}>\n *   <ActivitySequence … />\n * </LkAiProvider>\n * ```\n */\nexport function LkAiProvider({ ai, children }: LkAiProviderProps): React.JSX.Element {\n  return <LkAiContext.Provider value={ai}>{children}</LkAiContext.Provider>;\n}\n\n/** The ports in force: a component's own, else the provider's, else none. */\nexport function useLearnerAi(override?: LearnerAi): LearnerAi | undefined {\n  const context = useContext(LkAiContext);\n  return override ?? context ?? undefined;\n}\n"]}

package/dist/chunk-YRNEOBXA.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/i18n/strings.ts","../src/i18n/LkIntlProvider.tsx"],"names":[],"mappings":"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","file":"chunk-YRNEOBXA.js","sourcesContent":["import type { ReadAloudDimension, ReadAloudWordState, Stimulus } from '@intellectif/lk-core';\nimport type { CaptionSize } from '../components/InteractiveVideo/prefs.js';\nimport type { VideoShortcutAction } from '../components/InteractiveVideo/shortcuts.js';\nimport type { MediaTransportStrings } from '../components/types.js';\nimport type { SpeechRecorderError } from '../hooks/useSpeechRecorder.js';\n\n/**\n * Every string the SDK's own chrome renders.\n *\n * Until 0.8.1 these were literals, and `locale` set only the `lang` attribute —\n * so a learner sitting a Spanish paper read a Spanish passage inside an English\n * scaffold, and \"No plays remaining\" on a listening exam was untranslatable.\n * This is the whole surface, in one place, so a consumer can replace it.\n *\n * **Interpolation and plurals are functions, not format strings.** A message\n * like `\"Question {n} of {total}\"` needs a parser, and a parser needs plural\n * rules for every locale the SDK does not know. A function hands both problems\n * to the consumer, who has `Intl.PluralRules` and knows their own language:\n *\n * ```ts\n * questionProgress: (index, total) => `Pregunta ${index} de ${total}`,\n * wordCount: (n) => `${n} ${n === 1 ? 'palabra' : 'palabras'}`,\n * ```\n *\n * It also lets a translation reorder its arguments, which a positional token\n * cannot, and TypeScript checks the arity. No parser, no message catalogue\n * format, no runtime dependency.\n *\n * **What is deliberately NOT here: thrown errors.** Every `throw` in this\n * package is addressed to the developer who wired the component up, not to the\n * learner. Translating them would make them unsearchable and would put the one\n * audience who can act on them behind a translation. They stay English.\n */\nexport interface LkStrings {\n  // ── Submission ─────────────────────────────────────────────────────────\n  /** Multiple Choice submit button, and Written Response. */\n  submit: string;\n  /** Fill-in-the-Blanks in `practice`: the learner is checking their own work. */\n  checkAnswers: string;\n  /** Fill-in-the-Blanks in `exam`: nothing is checked on the client. */\n  submitAnswers: string;\n\n  // ── Outcome, announced after submit ────────────────────────────────────\n  /**\n   * The scored result, read by a screen reader on submit.\n   *\n   * `percent` is already rounded to a whole number. The authored overall\n   * feedback is appended SEPARATELY by the component, so a translation of this\n   * sentence never has to carry the author's words — the two were previously\n   * concatenated into one literal, which made the score sentence untranslatable\n   * without also touching authored content.\n   */\n  scoreAnnouncement: (percent: number, passed: boolean) => string;\n  /** Prefix announced on submit, before the score sentence. */\n  answerSubmitted: string;\n  /** An answer submitted for grading that has none yet. Never rendered as 0%. */\n  notGradedYet: string;\n  /** An outcome that carries no grade and never will. */\n  noGradeAvailable: string;\n\n  // ── Feedback disclosure ────────────────────────────────────────────────\n  showFeedback: string;\n  hideFeedback: string;\n\n  // ── Fill-in-the-Blanks ─────────────────────────────────────────────────\n  /** Accessible name of a blank's input. `ordinal` is 1-based. */\n  blankLabel: (ordinal: number) => string;\n\n  // ── Gap select ────────────────────────────────────────────────────────────\n  /** Accessible name of the selector for one gap in a Gap Select passage. */\n  gapLabel: (ordinal: number) => string;\n  /**\n   * The empty first entry of a gap's selector — how a learner leaves a gap\n   * alone, and how they take an answer back. Never a real choice.\n   */\n  gapPlaceholder: string;\n  showHint: string;\n  hideHint: string;\n\n  // ── Written Response ───────────────────────────────────────────────────\n  /**\n   * Announced when an essay is handed in. Distinct from {@link LkStrings.awaitingGrade},\n   * which is the `review`-mode state of a submission made earlier: this one\n   * confirms the act, and is the only thing a learner hears at the moment they\n   * commit work that nothing on the client will grade.\n   */\n  responseSubmitted: string;\n  /** Live word counter. Needs the count for languages whose plural rules differ. */\n  wordCount: (count: number) => string;\n  /** The authored bounds, e.g. \"50–200 words\". `min` is 0 when unbounded below. */\n  wordBounds: (min: number, max: number) => string;\n  /** A rubric criterion the grader marked not applicable. */\n  notApplicable: string;\n  /** A returned grade flagged for a human to look at — learner-visible by design. */\n  awaitingHumanReview: string;\n  /** Submitted, no grade back yet. */\n  awaitingGrade: string;\n  /** The grader could not produce a grade. */\n  couldNotBeGraded: string;\n\n  // ── Sequence pager ─────────────────────────────────────────────────────\n  previous: string;\n  next: string;\n  /** Progress label, also the question region's accessible name. `index` is 1-based. */\n  questionProgress: (index: number, total: number) => string;\n  /** Shown when no renderer is registered for an activity type. */\n  unsupportedActivity: string;\n\n  // ── Dictation ──────────────────────────────────────────────────────────\n  /** Accessible name of the box the learner types the recording into. */\n  dictationInputLabel: string;\n  /** Accessible name of the group holding the recording. */\n  dictationRecording: string;\n  /** Accessible name of the group holding the slower recording, and its default `alt`. */\n  dictationSlowRecording: string;\n  /** The progressive-hint button, with how many transcript words are shown so far. */\n  dictationRevealNextWord: (revealed: number, total: number) => string;\n  /** Hides every revealed hint word again. */\n  dictationResetHints: string;\n  /** The solution toggle: shows the transcript after the attempt is marked. */\n  showSolution: string;\n  hideSolution: string;\n  /** Accessible name of the revealed transcript. */\n  dictationSolutionLabel: string;\n  /** Accessible name of the word-by-word marked result. */\n  dictationMarksLabel: string;\n  /** Tells the learner the marks compare the normalised text, not what they typed. */\n  dictationDiffNote: string;\n  /**\n   * The four sentences a screen reader hears for a marked word — the only\n   * channel the marks have for assistive technology; the glyphs and the\n   * character diff are decoration.\n   */\n  dictationWordCorrect: (word: string) => string;\n  dictationWordWrong: (word: string, expected: string) => string;\n  dictationWordMissing: (expected: string) => string;\n  dictationWordExtra: (word: string) => string;\n  /** The legend rows; the character-level marks reuse the same four. */\n  dictationLegendCorrect: string;\n  dictationLegendWrong: string;\n  dictationLegendMissing: string;\n  dictationLegendExtra: string;\n  /** Marked result of an attempt with no words in it once punctuation and spacing are ignored, an empty one included. */\n  dictationNothingTyped: string;\n  /**\n   * Appended to the score announcement, e.g. \"4 of 6 words correct.\" — a whole\n   * sentence, because authored feedback may follow it.\n   */\n  dictationWordsSummary: (correct: number, total: number) => string;\n\n  // ── Read aloud ─────────────────────────────────────────────────────────\n  /** Accessible name of the group holding the model recording. */\n  readAloudModelRecording: string;\n  /** Accessible name of the group holding the slower model recording, and its default `alt`. */\n  readAloudSlowRecording: string;\n  /** Starts a take. */\n  readAloudRecord: string;\n  /** Ends the take in progress. */\n  readAloudStop: string;\n  /** Throws the take away so the learner can start over. */\n  readAloudRerecord: string;\n  /** Accessible name of the player for the take the learner just made. */\n  readAloudYourRecording: string;\n  /**\n   * In place of the player for the learner's own take, and of the buttons that\n   * play one word of it, when the page refuses to play it — most often a\n   * Content-Security-Policy whose `media-src` does not allow `blob:`. Said\n   * rather than left as controls that do nothing when pressed.\n   */\n  readAloudPlaybackUnavailable: string;\n  /**\n   * Live progress while recording. Whole seconds, not a `m:ss` clock: a\n   * recording is bounded in seconds by the item, and a translation should not\n   * have to reimplement a clock to change the word around it.\n   *\n   * Shown on screen and hidden from assistive technology: it changes every\n   * second, and a screen reader that spoke each change would speak into the\n   * take being assessed. The two sentences below are what is announced instead.\n   */\n  readAloudRecordingProgress: (seconds: number, maxSeconds: number) => string;\n  /** Announced once when a capture begins. */\n  readAloudRecordingStarted: string;\n  /**\n   * Announced once when a capture ends, by the learner or at its own bound.\n   * Carries the length because the progress counter is not announced: a take\n   * that reads back as \"20 of 20 seconds\" is one that stopped itself.\n   */\n  readAloudRecordingStopped: (seconds: number, maxSeconds: number) => string;\n  /** How many takes are left. Called with 0 as well, so the wording is one translation's. */\n  readAloudTakesRemaining: (remaining: number, max: number) => string;\n  /** `exam` only: hands the item in with no recording at all, deliberately. */\n  readAloudSubmitWithoutRecording: string;\n  /** Pending, while the take travels to the application's storage. */\n  readAloudUploading: string;\n  /** The take never reached storage, so nothing was submitted. */\n  readAloudUploadFailed: string;\n  /** Retries whichever step just failed. */\n  readAloudTryAgain: string;\n  /** Pending, while the assessor judges the take. */\n  readAloudAssessing: string;\n  /** The binding stores recordings but judges none, so there is no feedback to show. */\n  readAloudAssessmentUnavailable: string;\n  /** The assessor found no speech, or too little of it, in the take. */\n  readAloudNotHeard: string;\n  /** The assessor produced no grade for any other reason. The code itself is never shown. */\n  readAloudNotAssessed: string;\n  /** The assessment could not be run at all — a failure of the call, not of the reading. */\n  readAloudAssessmentFailed: string;\n  /**\n   * What went wrong with the microphone or with the take. One function rather\n   * than five keys, so a translation keeps the five sentences together and the\n   * SDK keeps one name for the concept.\n   */\n  readAloudRecorderError: (reason: SpeechRecorderError) => string;\n\n  // ── Pronunciation feedback ─────────────────────────────────────────────\n  /** Accessible name of the whole feedback region. */\n  pronunciationFeedbackLabel: string;\n  /** Name of one scored dimension, as a learner reads it. */\n  pronunciationDimension: (dimension: ReadAloudDimension) => string;\n  /** A dimension or a word the engine did not measure. NEVER rendered as 0%. */\n  pronunciationNotAssessed: string;\n  /** Accessible name of the word-by-word marks. */\n  pronunciationWordsLabel: string;\n  /** One legend row per marking state — the same four states the marks carry. */\n  pronunciationLegend: (state: ReadAloudWordState) => string;\n  /**\n   * The four sentences a screen reader hears for a marked word: the only\n   * channel the marks have for assistive technology, since the glyph and the\n   * decoration are both hidden from it.\n   */\n  pronunciationWordCorrect: (word: string) => string;\n  pronunciationWordMispronounced: (word: string) => string;\n  pronunciationWordOmitted: (word: string) => string;\n  pronunciationWordInserted: (word: string) => string;\n  /** Opens one word's syllables, sounds and timings. */\n  pronunciationWordDetails: (word: string) => string;\n  pronunciationSyllables: string;\n  pronunciationPhonemes: string;\n  /** A syllable the engine also spelled out, e.g. `('ˈhæ', 'ha')`. */\n  pronunciationSyllableSpelling: (syllable: string, grapheme: string) => string;\n  /** A sound the engine named no symbol for; `ordinal` is 1-based. */\n  pronunciationPhonemePosition: (ordinal: number) => string;\n  /** Introduces the sounds the engine thought it heard in a sound's place. */\n  pronunciationHeardAs: string;\n  /** Plays one word out of the learner's own take. */\n  pronunciationPlayWord: (word: string) => string;\n  pronunciationBreakUnexpected: string;\n  pronunciationBreakMissing: string;\n  /** Shown only past the caller's own monotone threshold; the SDK sets none. */\n  pronunciationMonotone: string;\n  /** Names the alphabet the phoneme symbols are written in. */\n  pronunciationIpaNote: string;\n\n  // ── Interactive video ──────────────────────────────────────────────────\n  // Play, pause, mute, volume, speed, the progress bar's name and the time\n  // readout are the `media` strings below: the same controls, the same words.\n  /** Jump buttons, e.g. \"Back 10 seconds\". */\n  videoBack: (seconds: number) => string;\n  videoForward: (seconds: number) => string;\n  /** The centre button once the video has ended. */\n  videoReplay: string;\n  /** The time readout flips between elapsed and remaining; these name what a press shows next. */\n  videoShowRemaining: string;\n  videoShowElapsed: string;\n  /** The captions button, named by what a press does. */\n  videoCaptionsShow: string;\n  videoCaptionsHide: string;\n  /** In the captions menu when a caption file could not be read. */\n  videoCaptionsFailed: string;\n  /** The same, for the second language: the first line keeps working. */\n  videoSecondaryCaptionsFailed: string;\n  /** A speed in the speed menu, e.g. \"1.25×\". */\n  videoSpeedValue: (rate: number) => string;\n  videoSettings: string;\n  videoCaptionLanguage: string;\n  /** The captions page's item, and page, for a second caption line under the first. */\n  videoSecondCaptionLanguage: string;\n  /**\n   * The captions row of the settings menu when two languages show, from the\n   * tracks' own labels: \"English + Español\". A translation may order them as its\n   * language reads, but the first argument is always the upper line.\n   */\n  videoCaptionPair: (primary: string, secondary: string) => string;\n  /** Announced when Shift + C finds no other language to show. */\n  videoNoSecondLanguage: string;\n  videoCaptionSize: string;\n  videoCaptionSizeValue: (size: CaptionSize) => string;\n  videoCaptionBackground: string;\n  videoKeyboardShortcuts: string;\n  videoShortcutList: string;\n  /** Closes the shortcut list. */\n  videoClose: string;\n  /** A setting's state in the settings menu. */\n  videoOn: string;\n  videoOff: string;\n  /** What each row of the shortcut list does. */\n  videoShortcut: (action: VideoShortcutAction) => string;\n  /** The button that opens the panel below the video, and its two tabs. */\n  videoPanel: string;\n  videoContents: string;\n  videoTranscript: string;\n  videoTranscriptSearch: string;\n  videoTranscriptNoMatch: string;\n  videoPictureInPicture: string;\n  videoFullscreen: string;\n  videoExitFullscreen: string;\n  /**\n   * Why the video will not play, by `MediaError.code` (1 aborted, 2 network,\n   * 3 decode, 4 source), with 0 for anything else.\n   */\n  videoError: (code: number) => string;\n  videoTryAgain: string;\n  /** A quiz with no title of its own. */\n  videoQuiz: string;\n  /** Where the learner is inside a quiz, e.g. \"Question 2 of 5\". */\n  videoQuestionProgress: (index: number, total: number) => string;\n  /** A step of the quiz's step indicator, for assistive technology. */\n  videoQuestionStep: (index: number, answered: boolean) => string;\n  videoNextQuestion: string;\n  videoContinue: string;\n  videoSkipQuiz: string;\n  videoRewatch: string;\n  /** Exam mode, once a question is submitted: saved, not graded. */\n  videoAnswerSaved: string;\n  /** The end card, while an answer is still being stored or graded: why Finish waits. */\n  videoAnswerPending: string;\n  videoRequired: string;\n  /** A quiz's progress in the contents panel and on the end screen. */\n  videoQuizProgress: (answered: number, total: number) => string;\n  /** Announced when a quiz opens. */\n  videoQuizOpened: (time: string, questions: number) => string;\n  /** Announced when a seek stopped at a required quiz. */\n  videoHeldAtQuiz: (time: string) => string;\n  /** Announced when a seek stopped at the furthest point reached. */\n  videoHeldAhead: string;\n  videoEnded: string;\n  /** Practice end screen: questions answered, and the score. */\n  videoEndScore: (answered: number, total: number, percent: number) => string;\n  /** Exam end screen: questions answered, no score. */\n  videoEndAnswered: (answered: number, total: number) => string;\n  videoWatchAgain: string;\n  videoFinish: string;\n\n  // ── Authoring preview ──────────────────────────────────────────────────\n  /**\n   * `<ActivityPreview>`, in place of a draft that still has something missing.\n   * Author-facing, not learner-facing — but an editor is translated too.\n   */\n  previewIncomplete: string;\n  /** `<ActivityPreview>`, in place of a draft with something wrong in it. */\n  previewInvalid: string;\n\n  // ── Embedded media ────────────────────────────────────────────────────────\n  /**\n   * Accessible name of a provider iframe whose author supplied no `alt`.\n   * `MediaSchema` requires `alt` on an embed, so validated content never\n   * reaches this — but `validateActivity` is opt-in, and a screen-reader\n   * learner meeting an unvalidated one should not meet it in English.\n   */\n  embeddedMedia: string;\n\n  // ── Shared stimulus ────────────────────────────────────────────────────\n  /**\n   * Accessible name of the stimulus region when the author gave it no title.\n   * Keyed by `Stimulus['kind']`, because \"Recording\" and \"Passage\" do not share\n   * a gender or an article in every language.\n   */\n  stimulusKind: Record<Stimulus['kind'], string>;\n  /**\n   * How far the material carries, e.g. \"Questions 3–8\". Called with equal\n   * `first` and `last` for a single question, so a translation can choose its\n   * own singular rather than receive a pre-pluralised English one.\n   */\n  stimulusRange: (first: number, last: number) => string;\n\n  // ── Error boundary ─────────────────────────────────────────────────────\n  /** Production fallback when an activity throws during render. */\n  activityFailed: string;\n  /** The same, when the activity's title is known. */\n  activityFailedNamed: (title: string) => string;\n  /** Production fallback when the activity has no title to name. */\n  activityFailedUnnamed: string;\n\n  // ── AI help ────────────────────────────────────────────────────────────\n  /** The button that asks for an explanation of a graded answer. */\n  aiExplain: string;\n  /** The same button while the explanation is being written. */\n  aiExplaining: string;\n  /** The heading over an explanation, and its accessible name. */\n  aiExplanation: string;\n  /** When no explanation can be shown: the port failed, or its answer was refused. */\n  aiExplanationUnavailable: string;\n  /** The button that asks for a hint. */\n  aiHint: string;\n  /** The same button while the hint is being written. */\n  aiHintLoading: string;\n  /** The label before each hint. */\n  aiHintNumber: (hintNumber: number) => string;\n  /** The accessible name of the list of hints. */\n  aiHints: string;\n  /** When no hint can be shown: the port failed, or its hint gave the answer away. */\n  aiHintUnavailable: string;\n  /** In place of the hint button once every hint has been used. */\n  aiNoMoreHints: string;\n  /** Beneath every AI text: who wrote it. */\n  aiNotice: string;\n\n  // ── Audio transport ────────────────────────────────────────────────────\n  /**\n   * The listening-paper transport. Shipped in 0.8.0 as its own `mediaStrings`\n   * prop, which still works — this is the same shape, reachable from the one\n   * provider so a consumer does not wire two mechanisms.\n   */\n  media: MediaTransportStrings;\n}\n\n/** A partial override, nested one level for {@link LkStrings.media}. */\nexport type LkStringsOverride = Partial<Omit<LkStrings, 'media' | 'stimulusKind'>> & {\n  media?: Partial<MediaTransportStrings>;\n  stimulusKind?: Partial<Record<Stimulus['kind'], string>>;\n};\n\n/**\n * English defaults, byte-identical to what every component rendered before the\n * strings surface existed. Supplying no override changes nothing on screen.\n */\nexport const DEFAULT_STRINGS: LkStrings = {\n  submit: 'Submit',\n  checkAnswers: 'Check answers',\n  submitAnswers: 'Submit answers',\n\n  scoreAnnouncement: (percent, passed) =>\n    `Score ${percent}%. ${passed ? 'Passed.' : 'Not passed.'}`,\n  answerSubmitted: 'Answer submitted.',\n  notGradedYet: 'Not graded yet.',\n  noGradeAvailable: 'No grade available.',\n\n  showFeedback: 'Show feedback',\n  hideFeedback: 'Hide feedback',\n\n  blankLabel: (ordinal) => `Fill in blank ${ordinal}`,\n\n  gapLabel: (ordinal) => `Choose the answer for gap ${ordinal}`,\n  gapPlaceholder: 'Choose…',\n  showHint: 'Show hint',\n  hideHint: 'Hide hint',\n\n  responseSubmitted:\n    'Response submitted. It will be graded and your result will appear here later.',\n  wordCount: (count) => `${count} ${count === 1 ? 'word' : 'words'}`,\n  wordBounds: (min, max) => (min > 0 ? `${min}–${max} words` : `up to ${max} words`),\n  notApplicable: 'Not applicable',\n  awaitingHumanReview: 'This grade is awaiting review by a teacher.',\n  awaitingGrade: 'Not graded yet. This response is waiting for its grade.',\n  couldNotBeGraded: 'This response could not be graded.',\n\n  previous: 'Previous',\n  next: 'Next',\n  questionProgress: (index, total) => `Question ${index} of ${total}`,\n  unsupportedActivity: 'This activity type has no renderer. Supply one through the renderers prop.',\n\n  dictationInputLabel: 'Type what you hear',\n  dictationRecording: 'Recording',\n  dictationSlowRecording: 'Slow recording',\n  dictationRevealNextWord: (revealed, total) =>\n    `Reveal the next word (${revealed} of ${total} shown)`,\n  dictationResetHints: 'Reset hints',\n  showSolution: 'Show solution',\n  hideSolution: 'Hide solution',\n  dictationSolutionLabel: 'Solution',\n  dictationMarksLabel: 'Your answer, word by word',\n  dictationDiffNote: 'Compared after ignoring case, punctuation and extra spaces.',\n  dictationWordCorrect: (word) => `“${word}” is correct`,\n  dictationWordWrong: (word, expected) => `“${word}” should be “${expected}”`,\n  dictationWordMissing: (expected) => `“${expected}” is missing`,\n  dictationWordExtra: (word) => `“${word}” is extra`,\n  dictationLegendCorrect: 'Correct',\n  dictationLegendWrong: 'Wrong',\n  dictationLegendMissing: 'Missing',\n  dictationLegendExtra: 'Extra',\n  dictationNothingTyped: 'Nothing to compare: no words were entered.',\n  dictationWordsSummary: (correct, total) =>\n    `${correct} of ${total} ${total === 1 ? 'word' : 'words'} correct.`,\n\n  readAloudModelRecording: 'Model recording',\n  readAloudSlowRecording: 'Slow model recording',\n  readAloudRecord: 'Record',\n  readAloudStop: 'Stop recording',\n  readAloudRerecord: 'Record again',\n  readAloudYourRecording: 'Your recording',\n  readAloudPlaybackUnavailable: 'Your recording cannot be played back on this page.',\n  readAloudRecordingProgress: (seconds, maxSeconds) =>\n    `Recording: ${seconds} of ${maxSeconds} seconds`,\n  readAloudRecordingStarted: 'Recording started.',\n  readAloudRecordingStopped: (seconds, maxSeconds) =>\n    `Recording stopped. ${seconds} of ${maxSeconds} seconds recorded.`,\n  readAloudTakesRemaining: (remaining, max) =>\n    `${remaining} of ${max} recording${max === 1 ? '' : 's'} left`,\n  readAloudSubmitWithoutRecording: 'Submit without recording',\n  readAloudUploading: 'Sending your recording…',\n  readAloudUploadFailed: 'Your recording could not be sent.',\n  readAloudTryAgain: 'Try again',\n  readAloudAssessing: 'Checking your pronunciation…',\n  readAloudAssessmentUnavailable: 'Pronunciation feedback is not available for this activity.',\n  readAloudNotHeard: 'We could not hear you. Record again somewhere quieter.',\n  readAloudNotAssessed: 'This recording could not be assessed. Try recording it again.',\n  readAloudAssessmentFailed: 'Your pronunciation could not be checked.',\n  readAloudRecorderError: (reason) => {\n    switch (reason) {\n      case 'permission-denied':\n        return 'This page is not allowed to use the microphone.';\n      case 'no-device':\n        return 'No microphone was found.';\n      case 'unsupported':\n        return 'This browser cannot record audio.';\n      case 'too-short':\n        return 'That recording was too short.';\n      default:\n        return 'The recording could not be made.';\n    }\n  },\n\n  pronunciationFeedbackLabel: 'Pronunciation feedback',\n  pronunciationDimension: (dimension) => {\n    switch (dimension) {\n      case 'accuracy':\n        return 'Accuracy';\n      case 'fluency':\n        return 'Fluency';\n      case 'completeness':\n        return 'Completeness';\n      default:\n        return 'Intonation';\n    }\n  },\n  pronunciationNotAssessed: 'Not assessed',\n  pronunciationWordsLabel: 'Your reading, word by word',\n  pronunciationLegend: (state) => {\n    switch (state) {\n      case 'correct':\n        return 'Read correctly';\n      case 'mispronounced':\n        return 'Mispronounced';\n      case 'omitted':\n        return 'Not read';\n      default:\n        return 'Added';\n    }\n  },\n  pronunciationWordCorrect: (word) => `“${word}” was read correctly`,\n  pronunciationWordMispronounced: (word) => `“${word}” was mispronounced`,\n  pronunciationWordOmitted: (word) => `“${word}” was not read`,\n  pronunciationWordInserted: (word) => `“${word}” was added`,\n  pronunciationWordDetails: (word) => `Details for “${word}”`,\n  pronunciationSyllables: 'Syllables',\n  pronunciationPhonemes: 'Sounds',\n  pronunciationSyllableSpelling: (syllable, grapheme) => `${syllable} (spelled “${grapheme}”)`,\n  pronunciationPhonemePosition: (ordinal) => `Sound ${ordinal}`,\n  pronunciationHeardAs: 'Heard as',\n  pronunciationPlayWord: (word) => `Play “${word}”`,\n  pronunciationBreakUnexpected: 'There was an unexpected pause here.',\n  pronunciationBreakMissing: 'A pause was expected here.',\n  pronunciationMonotone: 'Your reading stayed on one note. Try varying your pitch.',\n  pronunciationIpaNote: 'Sounds are written in the International Phonetic Alphabet.',\n  videoBack: (seconds) => `Back ${seconds} seconds`,\n  videoForward: (seconds) => `Forward ${seconds} seconds`,\n  videoReplay: 'Replay',\n  videoShowRemaining: 'Show time remaining',\n  videoShowElapsed: 'Show time elapsed',\n  videoCaptionsShow: 'Show captions',\n  videoCaptionsHide: 'Hide captions',\n  videoCaptionsFailed: 'Captions could not be loaded.',\n  videoSecondaryCaptionsFailed: 'The second language could not be loaded.',\n  videoSpeedValue: (rate) => (rate === 1 ? 'Normal' : `${rate}×`),\n  videoSettings: 'Settings',\n  videoCaptionLanguage: 'Captions',\n  videoSecondCaptionLanguage: 'Second language',\n  videoCaptionPair: (primary, secondary) => `${primary} + ${secondary}`,\n  videoNoSecondLanguage: 'No second language for this video.',\n  videoCaptionSize: 'Caption size',\n  videoCaptionSizeValue: (size) =>\n    size === 'small' ? 'Small' : size === 'large' ? 'Large' : 'Medium',\n  videoCaptionBackground: 'Caption background',\n  videoKeyboardShortcuts: 'Keyboard shortcuts',\n  videoShortcutList: 'Shortcut list',\n  videoClose: 'Close',\n  videoOn: 'On',\n  videoOff: 'Off',\n  videoShortcut: (action) => {\n    switch (action) {\n      case 'play-pause':\n        return 'Play or pause';\n      case 'jump-10':\n        return 'Back or forward 10 seconds';\n      case 'jump-5':\n        return 'Back or forward 5 seconds';\n      case 'jump-1':\n        return 'Back or forward 1 second';\n      case 'frame':\n        return 'Previous or next frame, while paused';\n      case 'speed':\n        return 'Slower or faster';\n      case 'percent':\n        return 'Jump to 0% – 90%';\n      case 'start-end':\n        return 'Start or end';\n      case 'chapter':\n        return 'Previous or next chapter or quiz';\n      case 'mute':\n        return 'Mute';\n      case 'captions':\n        return 'Captions';\n      case 'secondary-captions':\n        return 'Second caption language on/off';\n      case 'transcript':\n        return 'Transcript';\n      case 'picture-in-picture':\n        return 'Picture in picture';\n      case 'fullscreen':\n        return 'Fullscreen';\n      default:\n        return 'This list';\n    }\n  },\n  videoPanel: 'Contents and transcript',\n  videoContents: 'Contents',\n  videoTranscript: 'Transcript',\n  videoTranscriptSearch: 'Search the transcript',\n  videoTranscriptNoMatch: 'No lines match.',\n  videoPictureInPicture: 'Picture in picture',\n  videoFullscreen: 'Fullscreen',\n  videoExitFullscreen: 'Exit fullscreen',\n  videoError: (code) =>\n    code === 2\n      ? 'The connection dropped while the video was loading.'\n      : code === 3\n        ? 'This video file could not be played.'\n        : code === 4\n          ? 'The video could not be loaded.'\n          : 'The video stopped before it could play.',\n  videoTryAgain: 'Try again',\n  videoQuiz: 'Quiz',\n  videoQuestionProgress: (index, total) => `Question ${index} of ${total}`,\n  videoQuestionStep: (index, answered) => `Question ${index}${answered ? ', answered' : ''}`,\n  videoNextQuestion: 'Next question',\n  videoContinue: 'Continue video',\n  videoSkipQuiz: 'Skip quiz',\n  videoRewatch: 'Rewatch',\n  videoAnswerSaved: 'Answer saved',\n  videoAnswerPending: 'Saving your answer…',\n  videoRequired: 'Required',\n  videoQuizProgress: (answered, total) =>\n    answered === total\n      ? 'Answered'\n      : answered === 0\n        ? 'Not started'\n        : `${answered} of ${total} answered`,\n  videoQuizOpened: (time, questions) =>\n    `Video paused. Quiz at ${time}, ${questions} question${questions === 1 ? '' : 's'}.`,\n  videoHeldAtQuiz: (time) => `Finish the quiz at ${time} to continue.`,\n  videoHeldAhead: 'You can rewind, but not skip ahead.',\n  videoEnded: 'You reached the end',\n  videoEndScore: (answered, total, percent) => `You answered ${answered} of ${total} · ${percent}%`,\n  videoEndAnswered: (answered, total) => `You answered ${answered} of ${total} questions`,\n  videoWatchAgain: 'Watch again',\n  videoFinish: 'Finish',\n\n  previewIncomplete: 'This activity is not finished yet, so it cannot be previewed.',\n  previewInvalid: 'This activity has a problem to fix before it can be previewed.',\n\n  embeddedMedia: 'Embedded media',\n\n  stimulusKind: {\n    text: 'Passage',\n    audio: 'Recording',\n    video: 'Video',\n    image: 'Image',\n    mixed: 'Material',\n  },\n  stimulusRange: (first, last) =>\n    first === last ? `Question ${first}` : `Questions ${first}–${last}`,\n\n  activityFailed: 'Activity failed to render',\n  activityFailedNamed: (title) => `\"${title}\" could not be displayed.`,\n  activityFailedUnnamed: 'This activity could not be displayed.',\n  aiExplain: 'Explain my answer',\n  aiExplaining: 'Explaining…',\n  aiExplanation: 'Explanation',\n  aiExplanationUnavailable: 'No explanation is available right now.',\n  aiHint: 'Get a hint',\n  aiHintLoading: 'Finding a hint…',\n  aiHintNumber: (hintNumber) => `Hint ${hintNumber}`,\n  aiHints: 'Hints',\n  aiHintUnavailable: 'No hint is available right now.',\n  aiNoMoreHints: 'No more hints for this question.',\n  aiNotice: 'Written by AI. It can make mistakes.',\n\n  media: {\n    play: 'Play',\n    pause: 'Pause',\n    preparing: 'Preparing…',\n    mute: 'Mute',\n    unmute: 'Unmute',\n    volume: 'Volume',\n    speed: 'Playback speed',\n    seek: 'Seek',\n    timeValue: (elapsed, duration) => `${elapsed} of ${duration}`,\n    playsRemaining: (remaining, max) =>\n      `${remaining} of ${max} play${max === 1 ? '' : 's'} remaining`,\n    noPlaysRemaining: 'No plays remaining',\n    lastPlayConfirm: 'This is your last play. Start it now?',\n    lastPlayStart: 'Start last play',\n    lastPlayCancel: 'Not yet',\n    seekBlocked: 'Rewinding is not available for this recording.',\n    rateBlocked: 'Playback speed is fixed for this recording.',\n    playFailed: 'The recording could not be started. Try again.',\n  },\n};\n\n/**\n * Layers an override onto a base dictionary.\n *\n * Two levels deep and no further, because the shape is two levels deep. A\n * generic deep merge would silently accept a nested object where a function\n * belongs and fail at render instead of at the call site.\n */\nexport function mergeStrings(base: LkStrings, override?: LkStringsOverride): LkStrings {\n  if (override === undefined) {\n    return base;\n  }\n  const { media, stimulusKind, ...flat } = override;\n  return {\n    ...base,\n    ...flat,\n    stimulusKind: { ...base.stimulusKind, ...stimulusKind },\n    media: { ...base.media, ...media },\n  };\n}\n","'use client';\n\nimport { createContext, useContext, useMemo } from 'react';\nimport type { LkStrings, LkStringsOverride } from './strings.js';\nimport { DEFAULT_STRINGS, mergeStrings } from './strings.js';\n\nexport type { LkStrings, LkStringsOverride } from './strings.js';\nexport { DEFAULT_STRINGS, mergeStrings } from './strings.js';\n\n/** Writing direction of the surrounding UI. `auto` defers to the locale. */\nexport type LkDirection = 'ltr' | 'rtl' | 'auto';\n\ninterface LkIntlValue {\n  strings: LkStrings;\n  locale: string | undefined;\n  direction: 'ltr' | 'rtl';\n}\n\nconst LkIntlContext = createContext<LkIntlValue | null>(null);\n\n/**\n * Locales written right-to-left, by language subtag.\n *\n * A short list rather than a dependency: these are the RTL scripts in living\n * use, and the set has not changed in decades. `Intl.Locale.textInfo` would be\n * better but is not available everywhere this package runs, and an explicit\n * `direction` prop overrides this in either direction anyway.\n */\nconst RTL_LANGUAGES = new Set(['ar', 'arc', 'dv', 'fa', 'he', 'ku', 'ps', 'sd', 'ug', 'ur', 'yi']);\n\n/** Resolves a BCP 47 tag to a writing direction. */\nexport function directionForLocale(locale: string | undefined): 'ltr' | 'rtl' {\n  if (locale === undefined) {\n    return 'ltr';\n  }\n  const language = locale.split('-')[0]?.toLowerCase() ?? '';\n  return RTL_LANGUAGES.has(language) ? 'rtl' : 'ltr';\n}\n\nexport interface LkIntlProviderProps {\n  /**\n   * Replaces the SDK's own chrome text. Anything omitted keeps its English\n   * default, so a partial translation degrades to mixed rather than to blank.\n   *\n   * A nested provider REPLACES the one above it rather than layering onto it —\n   * as a nested `ThemeProvider` restarts from `defaultTheme`. To layer, use a\n   * component's own `strings` prop, or compose with `mergeStrings`.\n   */\n  strings?: LkStringsOverride;\n  /**\n   * BCP 47 tag for the SDK's chrome — NOT for the authored content, which\n   * carries its own `locale`. Sets `lang` on the wrapper so a screen reader\n   * reads \"Question 3 of 10\" in the interface language rather than in the\n   * language of the passage beside it (WCAG 3.1.2).\n   */\n  locale?: string;\n  /**\n   * Writing direction. Defaults to `auto`, which derives it from `locale`.\n   * Set it explicitly when the surrounding application already manages `dir`\n   * and you do not want a second element declaring one.\n   */\n  direction?: LkDirection;\n  children: React.ReactNode;\n}\n\n/**\n * Supplies the SDK's chrome text and writing direction to everything beneath.\n *\n * Mirrors `ThemeProvider`: a provider for the whole tree, and a per-component\n * prop for the exceptions. The component prop wins, so a single activity can\n * be relabelled without a second provider.\n *\n * ```tsx\n * <LkIntlProvider locale=\"es\" strings={{\n *   submit: 'Enviar',\n *   checkAnswers: 'Comprobar respuestas',\n *   questionProgress: (i, total) => `Pregunta ${i} de ${total}`,\n *   wordCount: (n) => `${n} ${n === 1 ? 'palabra' : 'palabras'}`,\n *   media: { noPlaysRemaining: 'No quedan reproducciones' },\n * }}>\n *   <ActivitySequence … />\n * </LkIntlProvider>\n * ```\n *\n * The SDK ships **English only**. Bundling Spanish, Portuguese or Arabic would\n * mean shipping translations nobody in this repo can review, and a wrong\n * \"No plays remaining\" on a listening exam is worse than an English one that a\n * teacher can see is untranslated. The mechanism is the deliverable; the words\n * belong to whoever speaks the language.\n */\nexport function LkIntlProvider({\n  strings,\n  locale,\n  direction = 'auto',\n  children,\n}: LkIntlProviderProps): React.JSX.Element {\n  const value = useMemo<LkIntlValue>(\n    () => ({\n      strings: mergeStrings(DEFAULT_STRINGS, strings),\n      locale,\n      direction: direction === 'auto' ? directionForLocale(locale) : direction,\n    }),\n    [strings, locale, direction],\n  );\n\n  // Declare `dir` only when something actually told us the direction. With no\n  // locale and no explicit `direction`, writing dir=\"ltr\" would flip an RTL\n  // host's own subtree back to left-to-right — the context value stays\n  // concrete for `useLkDirection`; it is only the DOM declaration we withhold.\n  const declared = direction === 'auto' && locale === undefined ? undefined : value.direction;\n\n  return (\n    <LkIntlContext.Provider value={value}>\n      <div className=\"lk-intl\" lang={locale} dir={declared}>\n        {children}\n      </div>\n    </LkIntlContext.Provider>\n  );\n}\n\n/**\n * The strings in force, with an optional per-component override layered on top.\n *\n * Usable without a provider: every component calls this, and one rendered\n * standalone still needs its labels. Falling back to the English defaults is\n * what keeps `<MultipleChoice>` working with no setup at all.\n */\nexport function useLkStrings(override?: LkStringsOverride): LkStrings {\n  const context = useContext(LkIntlContext);\n  const base = context?.strings ?? DEFAULT_STRINGS;\n  return useMemo(() => mergeStrings(base, override), [base, override]);\n}\n\n/** The direction in force. `ltr` with no provider. */\nexport function useLkDirection(): 'ltr' | 'rtl' {\n  return useContext(LkIntlContext)?.direction ?? 'ltr';\n}\n"]}

package/dist/chunk-ZDYNAWDZ.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/ai/LkAiProvider.tsx"],"names":["createContext","useContext"],"mappings":";;;;;;AAuCA,IAAM,WAAA,GAAcA,oBAAgC,IAAI,CAAA;AAqBjD,SAAS,YAAA,CAAa,EAAE,EAAA,EAAI,QAAA,EAAS,EAAyC;AACnF,EAAA,sCAAQ,WAAA,CAAY,QAAA,EAAZ,EAAqB,KAAA,EAAO,IAAK,QAAA,EAAS,CAAA;AACpD;AAGO,SAAS,aAAa,QAAA,EAA6C;AACxE,EAAA,MAAM,OAAA,GAAUC,iBAAW,WAAW,CAAA;AACtC,EAAA,OAAO,YAAY,OAAA,IAAW,MAAA;AAChC","file":"chunk-ZDYNAWDZ.cjs","sourcesContent":["'use client';\n\nimport type { AiExplanationRequest, AiHintRequest, AiTextResult } from '@intellectif/lk-core';\nimport { createContext, type ReactNode, useContext } from 'react';\n\n/**\n * The model a host runs for learners, as the components call it. The SDK never\n * calls a model, holds a key or writes a prompt: each port is the host's\n * function — usually a request to its own server, which holds the key and the\n * prompt and chooses the model.\n *\n * A port is called only when the learner asks — a button, never on render —\n * and gets an `AbortSignal` that fires when the answer it was asked about goes\n * away. Whatever it resolves to is checked before a learner sees it: see\n * `checkAiExplanation` and `checkAiHint` in lk-core. A port that rejects, or\n * resolves to something refused, costs the learner the help, never the\n * question.\n *\n * Leave a port out to switch that feature off. Nothing AI renders in `exam`,\n * whatever is passed.\n */\nexport interface LearnerAi {\n  /** Explains a graded answer. */\n  explain?: (\n    request: AiExplanationRequest,\n    options: { signal: AbortSignal },\n  ) => Promise<AiTextResult>;\n  /** Writes the next hint for an answer not yet submitted. */\n  hint?: (request: AiHintRequest, options: { signal: AbortSignal }) => Promise<AiTextResult>;\n  /** The most hints a learner can ask for on one question. Default 3, at most 10. */\n  maxHints?: number;\n  /**\n   * The language to write explanations and hints in — the learner's own,\n   * which in a language course need not be the item's. Defaults to the\n   * component's `locale`.\n   */\n  learnerLocale?: string;\n}\n\nconst LkAiContext = createContext<LearnerAi | null>(null);\n\nexport interface LkAiProviderProps {\n  ai: LearnerAi;\n  children: ReactNode;\n}\n\n/**\n * Supplies the host's AI ports to every activity beneath, as `LkIntlProvider`\n * supplies strings. A component's own `ai` prop wins over it, whole.\n *\n * ```tsx\n * <LkAiProvider ai={{\n *   explain: (request, { signal }) => api.explain(request, signal),\n *   hint: (request, { signal }) => api.hint(request, signal),\n *   learnerLocale: learner.language,\n * }}>\n *   <ActivitySequence … />\n * </LkAiProvider>\n * ```\n */\nexport function LkAiProvider({ ai, children }: LkAiProviderProps): React.JSX.Element {\n  return <LkAiContext.Provider value={ai}>{children}</LkAiContext.Provider>;\n}\n\n/** The ports in force: a component's own, else the provider's, else none. */\nexport function useLearnerAi(override?: LearnerAi): LearnerAi | undefined {\n  const context = useContext(LkAiContext);\n  return override ?? context ?? undefined;\n}\n"]}