@intellectif/lk-react 18.0.0 → 18.1.0

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"]}

package/dist/{chunk-ALH6TUX2.js → chunk-THHFIP4N.js}

@@ -1,8 +1,9 @@
 'use client';
-import { AiHints, AiExplanation } from './chunk-GR33G5QM.js';
+import { AiHints, AiExplanation } from './chunk-BURYHHBM.js';
 import { useLearnerAi } from './chunk-YNDKAYW3.js';
 import { FeedbackRegion } from './chunk-RCMYEWBE.js';
-import { ActivityErrorBoundary, isDevelopment, randomSessionId, ANONYMOUS_ACTOR, objectIdFor } from './chunk-YTGRXD23.js';
+import { ActivityErrorBoundary } from './chunk-FEOFX4QW.js';
+import { isDevelopment, randomSessionId, 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';
@@ -347,5 +348,5 @@ function GapSelect2(props) {
 }
 
 export { GapSelect2 as GapSelect };
-//# sourceMappingURL=chunk-ALH6TUX2.js.map
-//# sourceMappingURL=chunk-ALH6TUX2.js.map
+//# sourceMappingURL=chunk-THHFIP4N.js.map
+//# sourceMappingURL=chunk-THHFIP4N.js.map

package/dist/chunk-THHFIP4N.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/GapSelect/GapSelect.tsx","../src/components/GapSelect/index.tsx"],"names":["result","GapSelect","jsx"],"mappings":"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","file":"chunk-THHFIP4N.js","sourcesContent":["'use client';\n\nimport {\n  ActivitySchemaError,\n  assertRedacted,\n  type GapSelectBank,\n  type GapSelectChoice,\n  type GapSelectData,\n  type GapSelectGap,\n  type GapSelectLearnerResponse,\n  type LearnerResponse,\n  type ScoringDetail,\n  type ScoringResult,\n  score,\n  seededShuffle,\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, randomSessionId } 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 GapSelectProps extends ActivityProps<GapSelectData> {\n  /**\n   * Seeds the per-gap choice shuffle when `data.shuffleChoices` is set. Pass\n   * the attempt id, exactly as on `<MultipleChoice>`: an order nobody can\n   * reproduce cannot be reconciled with the attempt a server recorded. Without\n   * one, a random per-mount seed is used — stable within the mount, and\n   * deliberately not reproducible.\n   */\n  shuffleSeed?: string;\n}\n\nconst PLACEHOLDER = /\\{\\{\\s*([^{}]+?)\\s*\\}\\}/g;\n\ntype Segment = { kind: 'text'; value: string } | { kind: 'gap'; id: string; ordinal: number };\n\n/** Splits a passage into literal text and its `{{id}}` gaps, in order. */\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: 'gap', 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\nconst NO_SELECTIONS: Record<string, string> = {};\n\n/**\n * The selections out of a `LearnerResponse`. A response of another activity\n * type reads as \"nothing selected\" rather than throwing — a controlled host\n * that has not yet swapped its state on an activity change would otherwise\n * crash the attempt.\n */\nfunction selectionsOf(response: LearnerResponse | undefined): Record<string, string> {\n  return response !== undefined && response.type === 'gap-select'\n    ? response.selections\n    : NO_SELECTIONS;\n}\n\n/** Per-gap correctness keyed by gap id, preferring the unambiguous `outcome`. */\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\n/**\n * The choices a gap offers: its own list, or the bank it names.\n *\n * Both survive redaction — they are what the learner picks from — so this is\n * the one resolution that works identically on full and redacted data.\n */\nfunction choicesFor(\n  banks: readonly GapSelectBank[] | undefined,\n  gap: GapSelectGap,\n): readonly GapSelectChoice[] {\n  if (gap.choices !== undefined) {\n    return gap.choices;\n  }\n  return banks?.find((bank) => bank.id === gap.bankId)?.choices ?? [];\n}\n\nexport function GapSelect({\n  data,\n  onComplete,\n  onSubmit,\n  onChange,\n  onInteraction,\n  value,\n  defaultValue,\n  defaultSubmitted,\n  renderMode = 'practice',\n  outcome,\n  mediaBudget,\n  mediaStrings,\n  strings,\n  theme,\n  locale,\n  disabled,\n  shuffleSeed,\n  ai: aiProp,\n}: GapSelectProps) {\n  const isExam = renderMode === 'exam';\n  const isReview = renderMode === 'review';\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      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('gap-select', data);\n    return result.success ? null : new ActivitySchemaError('gap-select', 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 [internalSelections, setInternalSelections] = useState<Record<string, string>>(() =>\n    selectionsOf(defaultValue),\n  );\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 selections = isControlled ? selectionsOf(value) : internalSelections;\n\n  const defaultValueRef = useRef(defaultValue);\n  useEffect(() => {\n    defaultValueRef.current = defaultValue;\n  }, [defaultValue]);\n\n  const defaultSubmittedRef = useRef(defaultSubmitted);\n  useEffect(() => {\n    defaultSubmittedRef.current = defaultSubmitted;\n  }, [defaultSubmitted]);\n\n  // Identity-guarded so the mount run is a no-op: without it this fires after\n  // the first paint and undoes every seed it was just given (Req 3.7).\n  const lastDataRef = useRef(data);\n  useEffect(() => {\n    if (lastDataRef.current === data) {\n      return;\n    }\n    lastDataRef.current = data;\n    setInternalSelections(selectionsOf(defaultValueRef.current));\n    setResult(null);\n    setSummary(null);\n    setFeedbackHidden(false);\n    reset(defaultSubmittedRef.current === true ? 'completed' : 'idle');\n  }, [data, reset]);\n\n  const segments = useMemo(() => parsePassage(data.passage), [data.passage]);\n  const gapById = useMemo(() => new Map(data.gaps.map((gap) => [gap.id, gap])), [data.gaps]);\n\n  const sessionIdRef = useRef<string | null>(null);\n  /**\n   * The choices each gap shows, in the order it shows them.\n   *\n   * Seeded PER GAP, not once for the activity: two gaps drawing on the same\n   * word bank must not be dealt the same order, or the bank's distractors line\n   * up column-wise and the second gap becomes easier than the first.\n   */\n  const choicesByGap = useMemo(() => {\n    const map = new Map<string, readonly GapSelectChoice[]>();\n    // biome-ignore lint/suspicious/noAssignInExpressions: sanctioned lazy ref initialization\n    const seedSource = shuffleSeed ?? (sessionIdRef.current ??= randomSessionId());\n    for (const gap of data.gaps) {\n      const choices = choicesFor(data.banks, gap);\n      map.set(\n        gap.id,\n        data.shuffleChoices === true\n          ? seededShuffle(choices, `${seedSource}:${data.id}:${gap.id}`)\n          : choices,\n      );\n    }\n    return map;\n  }, [data, shuffleSeed]);\n\n  // All hooks are called before these throws, so hook order stays stable.\n  if (devError) {\n    throw devError;\n  }\n  // Practice grades locally, and a redacted projection has no answer key to\n  // grade against — `score()` would throw RedactedScoringError from the submit\n  // handler, where no error boundary can reach it and after the learner has\n  // answered. Fail at render instead, in production too, exactly as every other\n  // built-in does.\n  if (data.redacted === true && renderMode === 'practice') {\n    throw new Error(\n      `Gap Select \"${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 answer-key-derived information may be shown. Never in `exam`; in\n   * `practice` only once this component has scored; in `review` only once the\n   * caller supplies a SCORED outcome.\n   */\n  const revealing = isReview ? outcome?.status === 'scored' : !isExam && submitted;\n\n  const fireInteraction = (\n    type: 'gap-selected' | 'submitted',\n    payload: Record<string, unknown>,\n  ): void => {\n    onInteraction?.({ type, activityId: data.id, timestamp: Date.now(), payload });\n  };\n\n  const handleSelect = (gapId: string, choiceId: string): void => {\n    if (inactive) {\n      return;\n    }\n    if (state === 'idle') {\n      start();\n    }\n    const next = { ...selections, [gapId]: choiceId };\n    if (!isControlled) {\n      setInternalSelections(next);\n    }\n    onChange?.({ type: 'gap-select', selections: next });\n    fireInteraction('gap-selected', { gapId, choiceId });\n  };\n\n  const handleSubmit = (event: React.FormEvent): void => {\n    event.preventDefault();\n    if (inactive) {\n      return;\n    }\n    const response: GapSelectLearnerResponse = { type: 'gap-select', selections };\n    onSubmit?.(response);\n\n    if (isExam) {\n      // The client neither grades nor reveals: no score(), no read of any\n      // answer-key field, no onComplete, and no xAPI statement — its\n      // correctResponsesPattern IS the answer key.\n      complete();\n      setSummary(s.answerSubmitted);\n      fireInteraction('submitted', { selections });\n      return;\n    }\n\n    const scoringResult = score('gap-select', data as GapSelectData, 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(selections),\n    });\n    setResult(scoringResult);\n    onComplete?.({\n      score: scoringResult.score,\n      maxScore: scoringResult.maxScore,\n      passed: scoringResult.passed,\n      timeSpent,\n      xapiStatement,\n    });\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', { selections, score: scoringResult.score });\n  };\n\n  const correctByGap = useMemo(() => {\n    if (isExam) {\n      return new Map<string, boolean>();\n    }\n    if (isReview) {\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  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    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  const anyFeedback = data.gaps.some((gap) => gap.feedback !== undefined);\n\n  return (\n    <form\n      className=\"lk-gs\"\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-gs-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 gap = gapById.get(seg.id);\n            if (!gap) {\n              return null;\n            }\n            const choices = choicesByGap.get(seg.id) ?? [];\n            const correctness = correctByGap.get(seg.id);\n            // Read defensively and never in exam: a redact() projection omits\n            // both at runtime while the type still says they are there.\n            const gapFeedback = isExam ? undefined : gap.feedback;\n            return (\n              <span key={seg.id} className=\"lk-gs-gap\">\n                <select\n                  className=\"lk-gs-select\"\n                  aria-label={s.gapLabel(seg.ordinal)}\n                  value={selections[seg.id] ?? ''}\n                  disabled={inactive}\n                  aria-disabled={inactive || undefined}\n                  data-correct={\n                    revealing && correctness !== undefined ? String(correctness) : undefined\n                  }\n                  onChange={(e) => handleSelect(seg.id, e.target.value)}\n                >\n                  {/*\n                    The empty entry is part of the contract, not a decoration.\n                    It is how a learner leaves a gap alone — and how they take\n                    an answer back — so \"not answered\" stays distinguishable\n                    from \"answered wrongly\" all the way into ItemOutcome, where\n                    the scorer reports it as `incorrect-omission`.\n                  */}\n                  <option value=\"\">{s.gapPlaceholder}</option>\n                  {choices.map((choice) => (\n                    <option key={choice.id} value={choice.id}>\n                      {choice.text}\n                    </option>\n                  ))}\n                </select>\n                {revealing && !feedbackHidden && gapFeedback ? (\n                  <span\n                    className=\"lk-gs-gap-feedback\"\n                    role=\"note\"\n                    data-correct={correctness !== undefined ? String(correctness) : undefined}\n                  >\n                    {gapFeedback}\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: 'gap-select', selections }}\n          locale={locale}\n          onInteraction={onInteraction}\n          strings={s}\n        />\n        {isReview ? null : (\n          <button type=\"submit\" disabled={inactive}>\n            {isExam ? s.submitAnswers : s.checkAnswers}\n          </button>\n        )}\n      </fieldset>\n      {revealing && anyFeedback ? (\n        <button\n          type=\"button\"\n          className=\"lk-gs-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: 'gap-select', selections }}\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 { GapSelect as GapSelectCore, type GapSelectProps } from './GapSelect.js';\n\nexport type { GapSelectProps } from './GapSelect.js';\n\n/**\n * Public Gap Select activity: the core wrapped in `ActivityErrorBoundary` so a\n * render failure (including the dev schema-validation throw and the\n * redacted-in-`practice` guard) degrades to an accessible fallback instead of\n * crashing the host.\n */\nexport function GapSelect(props: GapSelectProps) {\n  const strings = useLkStrings(props.strings);\n  return (\n    <ActivityErrorBoundary activityTitle={props.data?.title} strings={strings}>\n      <GapSelectCore {...props} />\n    </ActivityErrorBoundary>\n  );\n}\n"]}

package/dist/chunk-TL3GVPBO.cjs

@@ -0,0 +1,234 @@
+'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 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" });
+          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: checked.result.provenance !== void 0 ? { provenance: checked.result.provenance } : {}
+        });
+      },
+      () => {
+        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" }));
+          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,
+            ...checked.result.provenance !== void 0 ? { provenance: checked.result.provenance } : {}
+          }
+        });
+      },
+      () => {
+        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-TL3GVPBO.cjs.map
+//# sourceMappingURL=chunk-TL3GVPBO.cjs.map

package/dist/chunk-TL3GVPBO.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-TL3GVPBO.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\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          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:\n            checked.result.provenance !== undefined\n              ? { provenance: checked.result.provenance }\n              : {},\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          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: {\n            hintNumber: request.hintNumber,\n            ...(checked.result.provenance !== undefined\n              ? { provenance: checked.result.provenance }\n              : {}),\n          },\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"]}