@intellectif/lk-react 18.0.0 → 19.0.0

package/dist/chunk-QRT2W5N5.js

@@ -0,0 +1,114 @@
+'use client';
+import { useAiExplanation, useAiHints } from './chunk-YIYMBCPV.js';
+import { useRef, useEffect } from 'react';
+import { jsxs, jsx } from 'react/jsx-runtime';
+
+function situation(input) {
+  const { data, response, submitted, renderMode, ai, locale, onInteraction } = input;
+  return {
+    data,
+    response,
+    submitted,
+    renderMode,
+    ...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-QRT2W5N5.js.map
+//# sourceMappingURL=chunk-QRT2W5N5.js.map

package/dist/chunk-QRT2W5N5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/shared/AiHelp.tsx"],"names":[],"mappings":"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","file":"chunk-QRT2W5N5.js","sourcesContent":["'use client';\n\nimport type { InteractionEvent, ItemOutcome, LearnerResponse } 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}\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} {\n  const { data, response, submitted, renderMode, ai, locale, onInteraction } = input;\n  return {\n    data,\n    response,\n    submitted,\n    renderMode,\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-QHK6PTUR.js → chunk-SEQTGOOU.js}

@@ -1,8 +1,9 @@
 'use client';
-import { AiHints, AiExplanation } from './chunk-GR33G5QM.js';
+import { AiHints, AiExplanation } from './chunk-QRT2W5N5.js';
 import { useLearnerAi } from './chunk-YNDKAYW3.js';
 import { FeedbackRegion } from './chunk-RCMYEWBE.js';
-import { ActivityErrorBoundary, isDevelopment, ANONYMOUS_ACTOR, objectIdFor } from './chunk-YTGRXD23.js';
+import { ActivityErrorBoundary } from './chunk-FEOFX4QW.js';
+import { isDevelopment, ANONYMOUS_ACTOR, objectIdFor } from './chunk-PPFVTXGJ.js';
 import { ActivityMedia } from './chunk-BY4UQH2Y.js';
 import { useActivityState } from './chunk-6N43WDVG.js';
 import { useLkStrings } from './chunk-YRNEOBXA.js';
@@ -392,5 +393,5 @@ function FillInTheBlanks2(props) {
 }
 
 export { FillInTheBlanks2 as FillInTheBlanks };
-//# sourceMappingURL=chunk-QHK6PTUR.js.map
-//# sourceMappingURL=chunk-QHK6PTUR.js.map
+//# sourceMappingURL=chunk-SEQTGOOU.js.map
+//# sourceMappingURL=chunk-SEQTGOOU.js.map

package/dist/chunk-SEQTGOOU.js.map

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

package/dist/chunk-SXU26SFO.cjs

@@ -0,0 +1,253 @@
+'use client';
+'use strict';
+
+var chunkZDYNAWDZ_cjs = require('./chunk-ZDYNAWDZ.cjs');
+var chunkJVWLXVYG_cjs = require('./chunk-JVWLXVYG.cjs');
+var chunkEANGKAKG_cjs = require('./chunk-EANGKAKG.cjs');
+var lkCore = require('@intellectif/lk-core');
+var react = require('react');
+
+var DEFAULT_MAX_HINTS = 3;
+var MAX_HINTS_CEILING = 10;
+function hintLimit(ai) {
+  const asked = ai?.maxHints;
+  return typeof asked === "number" && Number.isInteger(asked) && asked >= 1 ? Math.min(asked, MAX_HINTS_CEILING) : DEFAULT_MAX_HINTS;
+}
+function hintOffered(input) {
+  const { data, renderMode, submitted, disabled } = input;
+  return renderMode === "practice" && !submitted && !disabled && data.redacted !== true && lkCore.aiSupports(data.type, "hint") && lkCore.aiAllowedByContent(data, "hint");
+}
+function explanationOffered(input) {
+  const { data, renderMode, submitted, outcome } = input;
+  const graded = renderMode === "practice" && submitted || renderMode === "review" && outcome?.status === "scored";
+  return graded && lkCore.aiSupports(data.type, "explanation") && lkCore.aiAllowedByContent(data, "explanation");
+}
+function callPort(call) {
+  try {
+    return Promise.resolve(call());
+  } catch (error) {
+    return Promise.reject(error);
+  }
+}
+function warnRefused(feature, activityId, reason) {
+  if (chunkEANGKAKG_cjs.isDevelopment()) {
+    console.warn(
+      `learning-kit: the AI ${feature} for "${activityId}" was not shown (${reason}). The learner saw "not available" instead.`
+    );
+  }
+}
+var localeOf = (ai, locale) => {
+  const chosen = ai?.learnerLocale ?? locale;
+  return chosen === void 0 ? {} : { learnerLocale: chosen };
+};
+function explanationKey(renderMode, submitted, response, outcome) {
+  let graded = "";
+  if (outcome !== void 0) {
+    graded = `${outcome.status}:${"score" in outcome ? outcome.score : ""}`;
+  }
+  return `${renderMode}|${submitted}|${graded}|${JSON.stringify(response)}`;
+}
+
+// src/ai/useAiHelp.ts
+function modeInForce(asked, around) {
+  if (around === "exam") {
+    return "exam";
+  }
+  return asked ?? around ?? "practice";
+}
+function shownPayload(result) {
+  return {
+    ...result.provenance !== void 0 ? { provenance: result.provenance } : {},
+    ...result.usage !== void 0 ? { usage: result.usage } : {}
+  };
+}
+function useAiExplanation(input) {
+  const { data, response, submitted, outcome } = input;
+  const renderMode = modeInForce(input.renderMode, react.useContext(chunkJVWLXVYG_cjs.SequenceSlotContext)?.renderMode);
+  const ai = chunkZDYNAWDZ_cjs.useLearnerAi(input.ai);
+  const resetKey = explanationKey(renderMode, submitted, response, outcome);
+  const [state, setState] = react.useState({ key: resetKey, status: "idle" });
+  const run = react.useRef(0);
+  const controller = react.useRef(null);
+  const current = state.key === resetKey ? state : { key: resetKey, status: "idle" };
+  const offered = ai?.explain !== void 0 && explanationOffered({ data, renderMode, submitted, outcome });
+  const latest = react.useRef({ input, renderMode, ai, resetKey, offered, current });
+  latest.current = { input, renderMode, ai, resetKey, offered, current };
+  react.useEffect(() => {
+    return () => {
+      run.current += 1;
+      controller.current?.abort();
+      controller.current = null;
+    };
+  }, [resetKey]);
+  const ask = react.useCallback(() => {
+    const now = latest.current;
+    const port = now.ai?.explain;
+    if (port === void 0 || !now.offered || now.current.status === "loading") {
+      return;
+    }
+    const key = now.resetKey;
+    const request = lkCore.aiExplanationRequest({
+      data: now.input.data,
+      response: now.input.response,
+      ...now.renderMode === "review" && now.input.outcome !== void 0 ? { outcome: now.input.outcome } : {},
+      ...localeOf(now.ai, now.input.locale)
+    });
+    if (request === null) {
+      setState({ key, status: "unavailable" });
+      return;
+    }
+    run.current += 1;
+    const mine = run.current;
+    controller.current?.abort();
+    const abort = new AbortController();
+    controller.current = abort;
+    setState({ key, status: "loading" });
+    callPort(() => port(request, { signal: abort.signal })).then(
+      (raw) => {
+        if (run.current !== mine) {
+          return;
+        }
+        const checked = lkCore.checkAiExplanation(raw, request);
+        if (!checked.ok) {
+          warnRefused("explanation", now.input.data.id, checked.refusal);
+          setState({ key, status: "unavailable" });
+          latest.current.input.onInteraction?.({
+            type: "ai-help-refused",
+            activityId: now.input.data.id,
+            timestamp: Date.now(),
+            payload: { feature: "explanation", reason: checked.refusal }
+          });
+          return;
+        }
+        setState({ key, status: "shown", result: checked.result });
+        latest.current.input.onInteraction?.({
+          type: "ai-explanation-shown",
+          activityId: now.input.data.id,
+          timestamp: Date.now(),
+          payload: shownPayload(checked.result)
+        });
+      },
+      () => {
+        if (run.current === mine) {
+          setState({ key, status: "unavailable" });
+        }
+      }
+    );
+  }, []);
+  return {
+    offered,
+    status: current.status,
+    explanation: current.status === "shown" ? current.result : null,
+    ask
+  };
+}
+function useAiHints(input) {
+  const { data, submitted } = input;
+  const renderMode = modeInForce(input.renderMode, react.useContext(chunkJVWLXVYG_cjs.SequenceSlotContext)?.renderMode);
+  const disabled = input.disabled === true;
+  const ai = chunkZDYNAWDZ_cjs.useLearnerAi(input.ai);
+  const resetKey = data.id;
+  const [state, setState] = react.useState({ key: resetKey, hints: [], status: "idle" });
+  const run = react.useRef(0);
+  const controller = react.useRef(null);
+  const current = state.key === resetKey ? state : { key: resetKey, hints: [], status: "idle" };
+  const offered = ai?.hint !== void 0 && hintOffered({ data, renderMode, submitted, disabled });
+  const limit = hintLimit(ai);
+  const latest = react.useRef({ input, renderMode, ai, offered, limit, current });
+  latest.current = { input, renderMode, ai, offered, limit, current };
+  react.useEffect(() => {
+    return () => {
+      run.current += 1;
+      controller.current?.abort();
+      controller.current = null;
+    };
+  }, [resetKey]);
+  react.useEffect(() => {
+    if (!offered) {
+      run.current += 1;
+      controller.current?.abort();
+      controller.current = null;
+      setState(
+        (previous) => previous.status === "loading" ? { ...previous, status: "idle" } : previous
+      );
+    }
+  }, [offered]);
+  const ask = react.useCallback(() => {
+    const now = latest.current;
+    const port = now.ai?.hint;
+    const held = now.current;
+    if (port === void 0 || !now.offered || held.status === "loading" || held.hints.length >= now.limit) {
+      return;
+    }
+    const key = held.key;
+    const request = lkCore.aiHintRequest({
+      data: now.input.data,
+      response: now.input.response,
+      previousHints: held.hints.map((hint) => hint.text),
+      ...localeOf(now.ai, now.input.locale)
+    });
+    if (request === null) {
+      setState({ ...held, status: "unavailable" });
+      return;
+    }
+    run.current += 1;
+    const mine = run.current;
+    controller.current?.abort();
+    const abort = new AbortController();
+    controller.current = abort;
+    setState({ ...held, status: "loading" });
+    callPort(() => port(request, { signal: abort.signal })).then(
+      (raw) => {
+        if (run.current !== mine) {
+          return;
+        }
+        const checked = lkCore.checkAiHint(raw, request);
+        if (!checked.ok) {
+          warnRefused("hint", now.input.data.id, checked.refusal);
+          setState((shown) => ({ ...shown, status: "unavailable" }));
+          latest.current.input.onInteraction?.({
+            type: "ai-help-refused",
+            activityId: now.input.data.id,
+            timestamp: Date.now(),
+            payload: {
+              feature: "hint",
+              reason: checked.refusal,
+              hintNumber: request.hintNumber
+            }
+          });
+          return;
+        }
+        setState((shown) => ({
+          ...shown,
+          hints: shown.key === key ? [...shown.hints, checked.result] : shown.hints,
+          status: "idle"
+        }));
+        latest.current.input.onInteraction?.({
+          type: "ai-hint-shown",
+          activityId: now.input.data.id,
+          timestamp: Date.now(),
+          payload: { hintNumber: request.hintNumber, ...shownPayload(checked.result) }
+        });
+      },
+      () => {
+        if (run.current === mine) {
+          setState((shown) => ({ ...shown, status: "unavailable" }));
+        }
+      }
+    );
+  }, []);
+  return {
+    offered,
+    status: current.status,
+    hints: current.hints,
+    limit,
+    used: current.hints.length,
+    ask
+  };
+}
+
+exports.useAiExplanation = useAiExplanation;
+exports.useAiHints = useAiHints;
+//# sourceMappingURL=chunk-SXU26SFO.cjs.map
+//# sourceMappingURL=chunk-SXU26SFO.cjs.map

package/dist/chunk-SXU26SFO.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/ai/rules.ts","../src/ai/useAiHelp.ts"],"names":["aiSupports","aiAllowedByContent","isDevelopment","useContext","SequenceSlotContext","useLearnerAi","useState","useRef","useEffect","useCallback","aiExplanationRequest","checkAiExplanation","aiHintRequest","checkAiHint"],"mappings":"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","file":"chunk-SXU26SFO.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} 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}): boolean {\n  const { data, renderMode, submitted, disabled } = input;\n  return (\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}): boolean {\n  const { data, renderMode, submitted, outcome } = input;\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  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\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 renderMode = modeInForce(input.renderMode, useContext(SequenceSlotContext)?.renderMode);\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 && explanationOffered({ data, renderMode, submitted, outcome });\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 renderMode = modeInForce(input.renderMode, useContext(SequenceSlotContext)?.renderMode);\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 = ai?.hint !== undefined && hintOffered({ data, renderMode, submitted, disabled });\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-TEAVPUMX.js

@@ -0,0 +1,22 @@
+'use client';
+import { createContext } from 'react';
+
+// src/components/shared/sequence-slot.ts
+var SequenceSlotContext = createContext(null);
+var lastTake = 0;
+function mintTake() {
+  lastTake += 1;
+  return lastTake;
+}
+var takes = /* @__PURE__ */ new WeakMap();
+function stampTake(value, take) {
+  takes.set(value, take);
+  return value;
+}
+function takeOf(value) {
+  return typeof value === "object" && value !== null ? takes.get(value) : void 0;
+}
+
+export { SequenceSlotContext, mintTake, stampTake, takeOf };
+//# sourceMappingURL=chunk-TEAVPUMX.js.map
+//# sourceMappingURL=chunk-TEAVPUMX.js.map

package/dist/chunk-TEAVPUMX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/shared/sequence-slot.ts"],"names":[],"mappings":";;;AAiDO,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-TEAVPUMX.js","sourcesContent":["'use client';\n\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   * 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"]}