@intellectif/lk-react 18.1.0 → 19.0.0

package/dist/components/MultipleChoice.cjs

@@ -1,9 +1,9 @@
 'use client';
 'use strict';
 
-var chunkX4YU6BX7_cjs = require('../chunk-X4YU6BX7.cjs');
-require('../chunk-NWGQ7JML.cjs');
-require('../chunk-TL3GVPBO.cjs');
+var chunkZME5FMED_cjs = require('../chunk-ZME5FMED.cjs');
+require('../chunk-KGDGYRBL.cjs');
+require('../chunk-SXU26SFO.cjs');
 require('../chunk-ZDYNAWDZ.cjs');
 require('../chunk-JVWLXVYG.cjs');
 require('../chunk-BRPEB43C.cjs');
@@ -17,7 +17,7 @@ require('../chunk-AHGB5HH6.cjs');
 
 Object.defineProperty(exports, "MultipleChoice", {
   enumerable: true,
-  get: function () { return chunkX4YU6BX7_cjs.MultipleChoice; }
+  get: function () { return chunkZME5FMED_cjs.MultipleChoice; }
 });
 //# sourceMappingURL=MultipleChoice.cjs.map
 //# sourceMappingURL=MultipleChoice.cjs.map

package/dist/components/MultipleChoice.js

@@ -1,7 +1,7 @@
 'use client';
-export { MultipleChoice } from '../chunk-JSRKES2Z.js';
-import '../chunk-BURYHHBM.js';
-import '../chunk-YGJE7RSW.js';
+export { MultipleChoice } from '../chunk-XHF376ES.js';
+import '../chunk-QRT2W5N5.js';
+import '../chunk-YIYMBCPV.js';
 import '../chunk-YNDKAYW3.js';
 import '../chunk-TEAVPUMX.js';
 import '../chunk-RCMYEWBE.js';

package/dist/index.cjs

@@ -3,17 +3,17 @@
 
 var chunkPNNUPUH4_cjs = require('./chunk-PNNUPUH4.cjs');
 var chunkK63VPFOV_cjs = require('./chunk-K63VPFOV.cjs');
-var chunkPROKRNL2_cjs = require('./chunk-PROKRNL2.cjs');
-var chunk3SDCALS3_cjs = require('./chunk-3SDCALS3.cjs');
-var chunkTXMP5AOW_cjs = require('./chunk-TXMP5AOW.cjs');
+var chunkWKA6FUR4_cjs = require('./chunk-WKA6FUR4.cjs');
+var chunk55W2472T_cjs = require('./chunk-55W2472T.cjs');
+var chunk2X2NZF46_cjs = require('./chunk-2X2NZF46.cjs');
 var chunk3FBBP5QR_cjs = require('./chunk-3FBBP5QR.cjs');
 var chunkCQNKZ435_cjs = require('./chunk-CQNKZ435.cjs');
-var chunkX4YU6BX7_cjs = require('./chunk-X4YU6BX7.cjs');
-var chunkJH77MAON_cjs = require('./chunk-JH77MAON.cjs');
-var chunk3SJ7TVL6_cjs = require('./chunk-3SJ7TVL6.cjs');
-var chunk7GYAUA56_cjs = require('./chunk-7GYAUA56.cjs');
-require('./chunk-NWGQ7JML.cjs');
-var chunkTL3GVPBO_cjs = require('./chunk-TL3GVPBO.cjs');
+var chunkZME5FMED_cjs = require('./chunk-ZME5FMED.cjs');
+var chunkXUQ4KRTT_cjs = require('./chunk-XUQ4KRTT.cjs');
+var chunkXAIJNGTU_cjs = require('./chunk-XAIJNGTU.cjs');
+var chunkNGFTSRKO_cjs = require('./chunk-NGFTSRKO.cjs');
+require('./chunk-KGDGYRBL.cjs');
+var chunkSXU26SFO_cjs = require('./chunk-SXU26SFO.cjs');
 var chunkZDYNAWDZ_cjs = require('./chunk-ZDYNAWDZ.cjs');
 var chunkNZM3M5IR_cjs = require('./chunk-NZM3M5IR.cjs');
 var chunkLX2X4KC7_cjs = require('./chunk-LX2X4KC7.cjs');
@@ -61,19 +61,19 @@ Object.defineProperty(exports, "useTheme", {
 });
 Object.defineProperty(exports, "InteractiveVideo", {
   enumerable: true,
-  get: function () { return chunkPROKRNL2_cjs.InteractiveVideo; }
+  get: function () { return chunkWKA6FUR4_cjs.InteractiveVideo; }
 });
 Object.defineProperty(exports, "resolveCaptionTracks", {
   enumerable: true,
-  get: function () { return chunkPROKRNL2_cjs.resolveCaptionTracks; }
+  get: function () { return chunkWKA6FUR4_cjs.resolveCaptionTracks; }
 });
 Object.defineProperty(exports, "ActivityPreview", {
   enumerable: true,
-  get: function () { return chunk3SDCALS3_cjs.ActivityPreview; }
+  get: function () { return chunk55W2472T_cjs.ActivityPreview; }
 });
 Object.defineProperty(exports, "ActivitySequence", {
   enumerable: true,
-  get: function () { return chunkTXMP5AOW_cjs.ActivitySequence; }
+  get: function () { return chunk2X2NZF46_cjs.ActivitySequence; }
 });
 Object.defineProperty(exports, "StimulusPanel", {
   enumerable: true,
@@ -85,27 +85,27 @@ Object.defineProperty(exports, "WrittenResponse", {
 });
 Object.defineProperty(exports, "MultipleChoice", {
   enumerable: true,
-  get: function () { return chunkX4YU6BX7_cjs.MultipleChoice; }
+  get: function () { return chunkZME5FMED_cjs.MultipleChoice; }
 });
 Object.defineProperty(exports, "FillInTheBlanks", {
   enumerable: true,
-  get: function () { return chunkJH77MAON_cjs.FillInTheBlanks; }
+  get: function () { return chunkXUQ4KRTT_cjs.FillInTheBlanks; }
 });
 Object.defineProperty(exports, "GapSelect", {
   enumerable: true,
-  get: function () { return chunk3SJ7TVL6_cjs.GapSelect; }
+  get: function () { return chunkXAIJNGTU_cjs.GapSelect; }
 });
 Object.defineProperty(exports, "Dictation", {
   enumerable: true,
-  get: function () { return chunk7GYAUA56_cjs.Dictation; }
+  get: function () { return chunkNGFTSRKO_cjs.Dictation; }
 });
 Object.defineProperty(exports, "useAiExplanation", {
   enumerable: true,
-  get: function () { return chunkTL3GVPBO_cjs.useAiExplanation; }
+  get: function () { return chunkSXU26SFO_cjs.useAiExplanation; }
 });
 Object.defineProperty(exports, "useAiHints", {
   enumerable: true,
-  get: function () { return chunkTL3GVPBO_cjs.useAiHints; }
+  get: function () { return chunkSXU26SFO_cjs.useAiHints; }
 });
 Object.defineProperty(exports, "LkAiProvider", {
   enumerable: true,

package/dist/index.js

@@ -1,17 +1,17 @@
 'use client';
 export { useXAPI } from './chunk-2TW6WLBC.js';
 export { ThemeProvider, createTailwindTheme, darkTheme, defaultTheme, useTheme } from './chunk-UHKZXOXD.js';
-export { InteractiveVideo, resolveCaptionTracks } from './chunk-6NY7OTOO.js';
-export { ActivityPreview } from './chunk-WSPVQR4O.js';
-export { ActivitySequence } from './chunk-MKWBLNTD.js';
+export { InteractiveVideo, resolveCaptionTracks } from './chunk-KOFA54C7.js';
+export { ActivityPreview } from './chunk-7NNMDZUU.js';
+export { ActivitySequence } from './chunk-OWV7VRMQ.js';
 export { StimulusPanel } from './chunk-7K4B2EMU.js';
 export { WrittenResponse } from './chunk-4NERCBOW.js';
-export { MultipleChoice } from './chunk-JSRKES2Z.js';
-export { FillInTheBlanks } from './chunk-IKV2I7KT.js';
-export { GapSelect } from './chunk-THHFIP4N.js';
-export { Dictation } from './chunk-GM4PXDZ2.js';
-import './chunk-BURYHHBM.js';
-export { useAiExplanation, useAiHints } from './chunk-YGJE7RSW.js';
+export { MultipleChoice } from './chunk-XHF376ES.js';
+export { FillInTheBlanks } from './chunk-SEQTGOOU.js';
+export { GapSelect } from './chunk-NLTU5JFD.js';
+export { Dictation } from './chunk-5QCZZBOX.js';
+import './chunk-QRT2W5N5.js';
+export { useAiExplanation, useAiHints } from './chunk-YIYMBCPV.js';
 export { LkAiProvider, useLearnerAi } from './chunk-YNDKAYW3.js';
 export { ReadAloud } from './chunk-UXV3V5NH.js';
 export { PronunciationFeedback } from './chunk-G7AGM2Y7.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intellectif/lk-react",
-  "version": "18.1.0",
+  "version": "19.0.0",
   "description": "Accessible React 19 assessment components — multiple choice, fill-in-the-blanks, written response — with a resumable exam/review pager, theming, and xAPI delivery.",
   "keywords": [
     "react",
@@ -237,7 +237,7 @@
   "peerDependencies": {
     "react": "^19",
     "react-dom": "^19",
-    "@intellectif/lk-core": "^0.18.0"
+    "@intellectif/lk-core": "^0.19.0"
   },
   "devDependencies": {
     "@axe-core/react": "^4.10.0",
@@ -256,7 +256,7 @@
     "tsup": "^8.3.0",
     "vitest": "^4.1.6",
     "vitest-axe": "^0.1.0",
-    "@intellectif/lk-core": "0.18.0"
+    "@intellectif/lk-core": "0.19.0"
   },
   "license": "MIT",
   "engines": {

package/dist/chunk-TL3GVPBO.cjs.map

@@ -1 +0,0 @@
-{"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"]}

package/dist/chunk-YGJE7RSW.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/ai/rules.ts","../src/ai/useAiHelp.ts"],"names":[],"mappings":"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","file":"chunk-YGJE7RSW.js","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"]}