@intellectif/lk-react 23.1.0 → 23.1.2

package/dist/theme/ThemeProvider.d.ts

@@ -1,59 +1,2 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import { ThemeTokens } from '@intellectif/lk-core';
-import { ReactNode } from 'react';
-
-/**
- * Dark-mode colour overrides, merged over {@link defaultTheme} by
- * `ThemeProvider`. Colours only — spacing/typography/shape/motion are
- * theme-invariant. All pairs verified WCAG 2.2 AA against the dark surface.
- */
-declare const darkTheme: Partial<ThemeTokens>;
-
-/**
- * Shape consumed by a Tailwind config's `theme.extend`. Every entry is a
- * `var(--lk-token, <fallback>)` reference: the var keeps utilities live
- * (ThemeProvider / dark-mode override at runtime); the fallback makes them
- * work with zero setup (no provider, no `defaults.css` import).
- */
-interface TailwindThemeExtension {
-    colors: Record<string, string>;
-    spacing: Record<string, string>;
-    borderRadius: Record<string, string>;
-    fontFamily: Record<string, string>;
-    fontSize: Record<string, string>;
-}
-/**
- * Converts SDK theme tokens into a Tailwind `theme.extend` object so Tailwind
- * projects consume the same `--lk-*` tokens as the components — one shared
- * source of truth rather than a parallel, conflicting palette.
- */
-declare function createTailwindTheme(theme: Partial<ThemeTokens>): TailwindThemeExtension;
-
-/**
- * Canonical default theme token values. `defaults.css` mirrors these exactly.
- * Palette is a neutral monochrome, deliberately unbranded, so the SDK carries
- * nobody's look out of the box; consumers rebrand via `ThemeProvider`. All
- * colour pairs are verified to meet WCAG 2.2 AA: 4.5:1 for normal text, 3:1 for
- * UI / focus ring (see theme/__tests__/contrast.test.ts).
- */
-declare const defaultTheme: ThemeTokens;
-
-interface ThemeProviderProps {
-    /** Partial token overrides. When provided, dark auto-detection is disabled. */
-    theme?: Partial<ThemeTokens>;
-    children: ReactNode;
-}
-/**
- * Provides theme tokens to descendant activity components as scoped inline CSS
- * custom properties on a wrapper `<div>`, and via {@link useTheme}.
- *
- * Resolution: an explicit `theme` prop merges over {@link defaultTheme} (and
- * suppresses dark auto-detect, per Req 13.5). With no `theme` prop, the OS
- * `prefers-color-scheme: dark` preference auto-applies {@link darkTheme}.
- * SSR-safe: the server snapshot is always light, so hydration never mismatches.
- */
-declare function ThemeProvider({ theme, children }: ThemeProviderProps): react_jsx_runtime.JSX.Element;
-/** Returns the currently active theme tokens (defaults when no provider). */
-declare function useTheme(): ThemeTokens;
-
-export { type TailwindThemeExtension, ThemeProvider, type ThemeProviderProps, createTailwindTheme, darkTheme, defaultTheme, useTheme };
+import { a as TailwindThemeExtension, i as defaultTheme, n as ThemeProviderProps, o as createTailwindTheme, r as useTheme, s as darkTheme, t as ThemeProvider } from "../ThemeProvider-BCrxBaY-.js";
+export { type TailwindThemeExtension, ThemeProvider, ThemeProviderProps, createTailwindTheme, darkTheme, defaultTheme, useTheme };

package/dist/theme/ThemeProvider.js

@@ -1,4 +1,4 @@
 'use client';
-export { ThemeProvider, createTailwindTheme, darkTheme, defaultTheme, useTheme } from '../chunk-UHKZXOXD.js';
-//# sourceMappingURL=ThemeProvider.js.map
-//# sourceMappingURL=ThemeProvider.js.map
+"use client";
+import { a as darkTheme, i as defaultTheme, n as useTheme, r as createTailwindTheme, t as ThemeProvider } from "../ThemeProvider-C7K9iMLX.js";
+export { ThemeProvider, createTailwindTheme, darkTheme, defaultTheme, useTheme };

package/dist/tries-CbbtZkdG.cjs

@@ -0,0 +1,363 @@
+'use client';
+const require_useAiHelp = require("./useAiHelp-h9yOLFqt.cjs");
+let react = require("react");
+let react_jsx_runtime = require("react/jsx-runtime");
+let _intellectif_lk_core = require("@intellectif/lk-core");
+//#region src/components/shared/AiHelp.tsx
+/** What the hooks take, from what a component holds: the optional half, without `undefined` values. */
+function situation(input) {
+	const { data, response, submitted, renderMode, ai, locale, onInteraction, delivery } = input;
+	return {
+		data,
+		response,
+		submitted,
+		renderMode,
+		delivery,
+		...ai !== void 0 ? { ai } : {},
+		...locale !== void 0 ? { locale } : {},
+		...onInteraction !== void 0 ? { onInteraction } : {}
+	};
+}
+/**
+* "Explain my answer": the SDK's own surface over {@link useAiExplanation} — a
+* button, the explanation with who wrote it, and "not available" when a call
+* fails or its answer is refused.
+*
+* Nothing renders without a port, or where the rules say no explanation.
+*/
+function AiExplanation({ outcome, ...rest }) {
+	const s = rest.strings;
+	const help = require_useAiHelp.useAiExplanation({
+		...situation(rest),
+		...outcome !== void 0 ? { outcome } : {}
+	});
+	const buttonRef = (0, react.useRef)(null);
+	const panelRef = (0, react.useRef)(null);
+	const refocus = (0, react.useRef)(false);
+	(0, react.useEffect)(() => {
+		if (help.status === "shown" && refocus.current) {
+			refocus.current = false;
+			panelRef.current?.focus();
+		}
+		if (help.status === "unavailable") refocus.current = false;
+	}, [help.status]);
+	if (!help.offered) return null;
+	const ask = () => {
+		refocus.current = typeof document !== "undefined" && document.activeElement === buttonRef.current;
+		help.ask();
+	};
+	const loading = help.status === "loading";
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+		className: "lk-ai",
+		"data-state": help.status,
+		children: [help.explanation === null ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+			ref: buttonRef,
+			type: "button",
+			className: "lk-ai-button",
+			"aria-busy": loading || void 0,
+			"aria-disabled": loading || void 0,
+			onClick: ask,
+			children: loading ? s.aiExplaining : s.aiExplain
+		}) : null, /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+			"aria-live": "polite",
+			children: help.explanation !== null ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
+				ref: panelRef,
+				className: "lk-ai-panel",
+				tabIndex: -1,
+				"aria-label": s.aiExplanation,
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						className: "lk-ai-heading",
+						children: s.aiExplanation
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						className: "lk-ai-text",
+						children: help.explanation.text
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						className: "lk-ai-notice",
+						children: s.aiNotice
+					})
+				]
+			}) : help.status === "unavailable" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+				className: "lk-ai-unavailable",
+				children: s.aiExplanationUnavailable
+			}) : null
+		})]
+	});
+}
+/**
+* The AI hints of one of the SDK's own questions: {@link useAiHints}, called
+* by the component itself so it can count the hints its learner was shown.
+*/
+function useComponentAiHints({ disabled, ...rest }) {
+	return require_useAiHelp.useAiHints({
+		...situation(rest),
+		disabled
+	});
+}
+/**
+* "Get a hint": the SDK's own surface over {@link useAiHints} — a button, the
+* hints given so far as a numbered list, and who wrote them.
+*
+* The hints stay listed after submit, so the learner can see what they were
+* given, but no more can be asked for — until a "Try again" reopens the
+* answer, when the same list carries on. Another question starts with none.
+*/
+function AiHints({ help, ai, strings: s }) {
+	const used = help.used;
+	if (ai?.hint === void 0 || !help.offered && used === 0) return null;
+	const loading = help.status === "loading";
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+		className: "lk-ai lk-ai-hint-area",
+		"data-state": help.status,
+		children: [
+			/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				"aria-live": "polite",
+				children: [used > 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("ol", {
+					className: "lk-ai-hints",
+					"aria-label": s.aiHints,
+					children: help.hints.map((hint, index) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("li", {
+						className: "lk-ai-hint",
+						children: [
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								className: "lk-ai-hint-label",
+								children: s.aiHintNumber(index + 1)
+							}),
+							" ",
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								className: "lk-ai-text",
+								children: hint.text
+							})
+						]
+					}, index))
+				}) : null, help.status === "unavailable" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+					className: "lk-ai-unavailable",
+					children: s.aiHintUnavailable
+				}) : null]
+			}),
+			help.offered ? used < help.limit ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+				type: "button",
+				className: "lk-ai-button",
+				"aria-busy": loading || void 0,
+				"aria-disabled": loading || void 0,
+				onClick: help.ask,
+				children: loading ? s.aiHintLoading : s.aiHint
+			}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+				className: "lk-ai-note",
+				children: s.aiNoMoreHints
+			}) : null,
+			used > 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+				className: "lk-ai-notice",
+				children: s.aiNotice
+			}) : null
+		]
+	});
+}
+//#endregion
+//#region src/components/shared/tries.tsx
+/**
+* The scoring policy a question is under: the paper's, when the paper around
+* it was given one, else its own.
+*
+* Not combined, as delivery policies are: a cost and a count of tries have no
+* "stricter" to pick. The paper decides, as it decides the mode — so a
+* question drawn inside a set is scored by the set's rules whatever it was
+* handed.
+*
+* A policy `validateItemScoringPolicy` refuses throws here, at render. Every
+* setting in it moves a grade, and there is no safe way to read one wrongly:
+* the question fails loudly rather than grade by a guess.
+*/
+function useItemScoringPolicy(given) {
+	const around = (0, react.useContext)(require_useAiHelp.SequenceSlotContext)?.scoring;
+	const key = policyKey(given);
+	const own = (0, react.useMemo)(() => around === void 0 ? (0, _intellectif_lk_core.resolveItemScoringPolicy)(given) : null, [around, key]);
+	return around ?? own;
+}
+function policyKey(given) {
+	try {
+		return JSON.stringify(given) ?? "";
+	} catch {
+		return String(given);
+	}
+}
+/** A hint count as a response carries it: anything but a whole number above 0 is none. */
+function hintsOf(response) {
+	const count = response?.hintsRevealed;
+	return typeof count === "number" && Number.isSafeInteger(count) && count > 0 ? count : 0;
+}
+/** Whether a try earned every mark there was: float noise above the maximum included. */
+const fullMarks = (one) => one.score / one.maxScore >= 1 - 1e-9;
+/** Whether, after the tries `made`, a question offers another: the rule `open` reads. */
+function offersAfter(now, made, shut) {
+	const last = made[made.length - 1];
+	return now.graded && !now.disabled && !shut && now.channel?.triesClosed !== true && last !== void 0 && made.length < 1 + now.policy.retries && !fullMarks(last);
+}
+/**
+* The tries a question has had and whether it offers another: the SDK's own
+* components' rules for "Try again", in one place.
+*
+* Reports whether a try is on offer to the paper around the question, which
+* waits for it before reporting the set while the question is on screen — and
+* closes every question's tries once it has reported.
+*/
+function useTries({ policy, graded, submitted, disabled }) {
+	const channel = (0, react.useContext)(require_useAiHelp.SequenceSlotContext);
+	const [tries, setTries] = (0, react.useState)([]);
+	const [closed, setClosed] = (0, react.useState)(false);
+	const triesRef = (0, react.useRef)([]);
+	const closedRef = (0, react.useRef)(false);
+	const latest = (0, react.useRef)({
+		policy,
+		graded,
+		disabled,
+		channel
+	});
+	latest.current = {
+		policy,
+		graded,
+		disabled,
+		channel
+	};
+	const record = (0, react.useCallback)((one) => {
+		const next = [...triesRef.current, one];
+		triesRef.current = next;
+		setTries(next);
+		if (offersAfter(latest.current, next, closedRef.current)) latest.current.channel?.triesState("offered");
+		return (0, _intellectif_lk_core.scoreTries)(next, latest.current.policy);
+	}, []);
+	const close = (0, react.useCallback)(() => {
+		closedRef.current = true;
+		setClosed(true);
+	}, []);
+	const reset = (0, react.useCallback)(() => {
+		triesRef.current = [];
+		closedRef.current = false;
+		setTries([]);
+		setClosed(false);
+	}, []);
+	const allowed = 1 + policy.retries;
+	const left = Math.max(0, allowed - tries.length);
+	const open = submitted && offersAfter(latest.current, tries, closed);
+	const retrying = !submitted && tries.length > 0 && !closed && graded && !disabled && channel?.triesClosed !== true;
+	const state = open ? "offered" : retrying ? "retrying" : "none";
+	const report = channel?.triesState;
+	(0, react.useEffect)(() => {
+		report?.(state);
+	}, [report, state]);
+	(0, react.useEffect)(() => () => report?.("none"), [report]);
+	return {
+		tries,
+		counted: (0, react.useMemo)(() => tries.length === 0 ? null : (0, _intellectif_lk_core.scoreTries)(tries, policy), [tries, policy]),
+		open,
+		left,
+		record,
+		close,
+		reset
+	};
+}
+/** A fraction of the marks as the whole percentage a learner reads. */
+const percentOf = (fraction) => Math.round(fraction * 100);
+/**
+* The sentences after the score, on a question whose policy changed it: which
+* try counts when it is not the one just made, what this answer scored before
+* its costs, and how many tries are left.
+*/
+function triesSummary(s, policy, counted, offered) {
+	const parts = [];
+	const latest = counted.tries.length - 1;
+	const mine = counted.tries[latest];
+	if (mine !== void 0) {
+		if (counted.counted !== latest) parts.push(s.countedTry(policy.counts === "best" ? "best" : "first", percentOf(mine.scored / mine.maxScore)));
+		else if (mine.scored !== mine.score) parts.push(s.scoreBeforeCosts(percentOf(mine.score / mine.maxScore)));
+	}
+	if (offered) parts.push(s.triesLeft(policy.retries + 1 - counted.tries.length, percentOf(policy.retryPenalty)));
+	return parts.join(" ");
+}
+/**
+* "Try again" and "Show answer" — or "Keep this answer", on a paper that shows
+* no right answers — after a graded try that did not earn full marks.
+*/
+function TryActions({ tries, solutions, strings: s, onRetry, onClose }) {
+	if (!tries.open) return null;
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+		className: "lk-tries",
+		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+			type: "button",
+			className: "lk-tries-again",
+			onClick: onRetry,
+			children: s.tryAgain
+		}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+			type: "button",
+			className: "lk-tries-close",
+			onClick: onClose,
+			children: solutions ? s.showAnswer : s.keepAnswer
+		})]
+	});
+}
+/** What a hint costs, said before the learner asks for one. */
+function HintCost({ policy, strings: s }) {
+	if (policy.hintPenalty <= 0) return null;
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+		className: "lk-hint-cost",
+		children: s.hintCost(percentOf(policy.hintPenalty))
+	});
+}
+//#endregion
+Object.defineProperty(exports, "AiExplanation", {
+	enumerable: true,
+	get: function() {
+		return AiExplanation;
+	}
+});
+Object.defineProperty(exports, "AiHints", {
+	enumerable: true,
+	get: function() {
+		return AiHints;
+	}
+});
+Object.defineProperty(exports, "HintCost", {
+	enumerable: true,
+	get: function() {
+		return HintCost;
+	}
+});
+Object.defineProperty(exports, "TryActions", {
+	enumerable: true,
+	get: function() {
+		return TryActions;
+	}
+});
+Object.defineProperty(exports, "hintsOf", {
+	enumerable: true,
+	get: function() {
+		return hintsOf;
+	}
+});
+Object.defineProperty(exports, "triesSummary", {
+	enumerable: true,
+	get: function() {
+		return triesSummary;
+	}
+});
+Object.defineProperty(exports, "useComponentAiHints", {
+	enumerable: true,
+	get: function() {
+		return useComponentAiHints;
+	}
+});
+Object.defineProperty(exports, "useItemScoringPolicy", {
+	enumerable: true,
+	get: function() {
+		return useItemScoringPolicy;
+	}
+});
+Object.defineProperty(exports, "useTries", {
+	enumerable: true,
+	get: function() {
+		return useTries;
+	}
+});
+
+//# sourceMappingURL=tries-CbbtZkdG.cjs.map

package/dist/tries-CbbtZkdG.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tries-CbbtZkdG.cjs","names":["useAiExplanation","useRef","useAiHints","useContext","SequenceSlotContext","useMemo","resolveItemScoringPolicy","useState","useRef","useCallback","scoreTries"],"sources":["../src/components/shared/AiHelp.tsx","../src/components/shared/tries.tsx"],"sourcesContent":["'use client';\n\nimport type {\n  InteractionEvent,\n  ItemOutcome,\n  LearnerResponse,\n  ResolvedDeliveryPolicy,\n} from '@intellectif/lk-core';\nimport { useEffect, useRef } from 'react';\nimport type { LearnerAi } from '../../ai/LkAiProvider.js';\nimport { type AiHintsHelp, useAiExplanation, useAiHints } from '../../ai/useAiHelp.js';\nimport type { LkStrings } from '../../i18n/strings.js';\nimport type { RenderableActivity, RenderMode } from '../types.js';\n\ninterface Situation {\n  ai: LearnerAi | undefined;\n  data: RenderableActivity;\n  renderMode: RenderMode;\n  submitted: boolean;\n  /** The learner's answer as it stands: submitted, restored, or being written. */\n  response: LearnerResponse;\n  /** The component's `locale`, the default language for what is written. */\n  locale: string | undefined;\n  onInteraction: ((event: InteractionEvent) => void) | undefined;\n  strings: LkStrings;\n  /** The policy the component resolved, the paper's included. */\n  delivery: ResolvedDeliveryPolicy;\n}\n\n/** What the hooks take, from what a component holds: the optional half, without `undefined` values. */\nfunction situation(input: Situation): {\n  data: RenderableActivity;\n  response: LearnerResponse;\n  submitted: boolean;\n  renderMode: RenderMode;\n  ai?: LearnerAi;\n  locale?: string;\n  onInteraction?: (event: InteractionEvent) => void;\n  delivery: ResolvedDeliveryPolicy;\n} {\n  const { data, response, submitted, renderMode, ai, locale, onInteraction, delivery } = input;\n  return {\n    data,\n    response,\n    submitted,\n    renderMode,\n    delivery,\n    ...(ai !== undefined ? { ai } : {}),\n    ...(locale !== undefined ? { locale } : {}),\n    ...(onInteraction !== undefined ? { onInteraction } : {}),\n  };\n}\n\n/**\n * \"Explain my answer\": the SDK's own surface over {@link useAiExplanation} — a\n * button, the explanation with who wrote it, and \"not available\" when a call\n * fails or its answer is refused.\n *\n * Nothing renders without a port, or where the rules say no explanation.\n */\nexport function AiExplanation({\n  outcome,\n  ...rest\n}: Situation & { outcome: ItemOutcome | undefined }) {\n  const s = rest.strings;\n  const help = useAiExplanation({\n    ...situation(rest),\n    ...(outcome !== undefined ? { outcome } : {}),\n  });\n  const buttonRef = useRef<HTMLButtonElement>(null);\n  const panelRef = useRef<HTMLElement>(null);\n  const refocus = useRef(false);\n\n  // The button that asked goes away when the explanation arrives; focus moves\n  // to what it asked for rather than falling to the page.\n  useEffect(() => {\n    if (help.status === 'shown' && refocus.current) {\n      refocus.current = false;\n      panelRef.current?.focus();\n    }\n    if (help.status === 'unavailable') {\n      refocus.current = false;\n    }\n  }, [help.status]);\n\n  if (!help.offered) {\n    return null;\n  }\n\n  const ask = (): void => {\n    refocus.current =\n      typeof document !== 'undefined' && document.activeElement === buttonRef.current;\n    help.ask();\n  };\n\n  const loading = help.status === 'loading';\n  return (\n    <div className=\"lk-ai\" data-state={help.status}>\n      {help.explanation === null ? (\n        <button\n          ref={buttonRef}\n          type=\"button\"\n          className=\"lk-ai-button\"\n          aria-busy={loading || undefined}\n          aria-disabled={loading || undefined}\n          onClick={ask}\n        >\n          {loading ? s.aiExplaining : s.aiExplain}\n        </button>\n      ) : null}\n      <div aria-live=\"polite\">\n        {help.explanation !== null ? (\n          <section\n            ref={panelRef}\n            className=\"lk-ai-panel\"\n            tabIndex={-1}\n            aria-label={s.aiExplanation}\n          >\n            <p className=\"lk-ai-heading\">{s.aiExplanation}</p>\n            <p className=\"lk-ai-text\">{help.explanation.text}</p>\n            <p className=\"lk-ai-notice\">{s.aiNotice}</p>\n          </section>\n        ) : help.status === 'unavailable' ? (\n          <p className=\"lk-ai-unavailable\">{s.aiExplanationUnavailable}</p>\n        ) : null}\n      </div>\n    </div>\n  );\n}\n\n/**\n * The AI hints of one of the SDK's own questions: {@link useAiHints}, called\n * by the component itself so it can count the hints its learner was shown.\n */\nexport function useComponentAiHints({\n  disabled,\n  ...rest\n}: Situation & { disabled: boolean }): AiHintsHelp {\n  return useAiHints({ ...situation(rest), disabled });\n}\n\n/**\n * \"Get a hint\": the SDK's own surface over {@link useAiHints} — a button, the\n * hints given so far as a numbered list, and who wrote them.\n *\n * The hints stay listed after submit, so the learner can see what they were\n * given, but no more can be asked for — until a \"Try again\" reopens the\n * answer, when the same list carries on. Another question starts with none.\n */\nexport function AiHints({\n  help,\n  ai,\n  strings: s,\n}: {\n  help: AiHintsHelp;\n  ai: LearnerAi | undefined;\n  strings: LkStrings;\n}) {\n  const used = help.used;\n\n  if (ai?.hint === undefined || (!help.offered && used === 0)) {\n    return null;\n  }\n\n  const loading = help.status === 'loading';\n  return (\n    <div className=\"lk-ai lk-ai-hint-area\" data-state={help.status}>\n      <div aria-live=\"polite\">\n        {used > 0 ? (\n          <ol className=\"lk-ai-hints\" aria-label={s.aiHints}>\n            {help.hints.map((hint, index) => (\n              // Hints are only ever appended, so a position is a stable key.\n              // biome-ignore lint/suspicious/noArrayIndexKey: an append-only list\n              <li key={index} className=\"lk-ai-hint\">\n                <span className=\"lk-ai-hint-label\">{s.aiHintNumber(index + 1)}</span>{' '}\n                <span className=\"lk-ai-text\">{hint.text}</span>\n              </li>\n            ))}\n          </ol>\n        ) : null}\n        {help.status === 'unavailable' ? (\n          <p className=\"lk-ai-unavailable\">{s.aiHintUnavailable}</p>\n        ) : null}\n      </div>\n      {help.offered ? (\n        used < help.limit ? (\n          <button\n            type=\"button\"\n            className=\"lk-ai-button\"\n            aria-busy={loading || undefined}\n            aria-disabled={loading || undefined}\n            onClick={help.ask}\n          >\n            {loading ? s.aiHintLoading : s.aiHint}\n          </button>\n        ) : (\n          <p className=\"lk-ai-note\">{s.aiNoMoreHints}</p>\n        )\n      ) : null}\n      {used > 0 ? <p className=\"lk-ai-notice\">{s.aiNotice}</p> : null}\n    </div>\n  );\n}\n","'use client';\n\nimport {\n  type ItemScoringPolicy,\n  type ItemTriesScore,\n  type ItemTry,\n  type ResolvedItemScoringPolicy,\n  resolveItemScoringPolicy,\n  scoreTries,\n} from '@intellectif/lk-core';\nimport { useCallback, useContext, useEffect, useMemo, useRef, useState } from 'react';\nimport type { LkStrings } from '../../i18n/strings.js';\nimport { SequenceSlotContext, type TriesState } from './sequence-slot.js';\n\n/**\n * The scoring policy a question is under: the paper's, when the paper around\n * it was given one, else its own.\n *\n * Not combined, as delivery policies are: a cost and a count of tries have no\n * \"stricter\" to pick. The paper decides, as it decides the mode — so a\n * question drawn inside a set is scored by the set's rules whatever it was\n * handed.\n *\n * A policy `validateItemScoringPolicy` refuses throws here, at render. Every\n * setting in it moves a grade, and there is no safe way to read one wrongly:\n * the question fails loudly rather than grade by a guess.\n */\nexport function useItemScoringPolicy(\n  given: ItemScoringPolicy | null | undefined,\n): ResolvedItemScoringPolicy {\n  const around = useContext(SequenceSlotContext)?.scoring;\n  const key = policyKey(given);\n  // biome-ignore lint/correctness/useExhaustiveDependencies: the policy's content is the trigger, not its identity\n  const own = useMemo(\n    () => (around === undefined ? resolveItemScoringPolicy(given) : null),\n    [around, key],\n  );\n  return around ?? (own as ResolvedItemScoringPolicy);\n}\n\nfunction policyKey(given: unknown): string {\n  try {\n    return JSON.stringify(given) ?? '';\n  } catch {\n    return String(given);\n  }\n}\n\n/** A hint count as a response carries it: anything but a whole number above 0 is none. */\nexport function hintsOf(response: unknown): number {\n  const count = (response as { hintsRevealed?: unknown } | null | undefined)?.hintsRevealed;\n  return typeof count === 'number' && Number.isSafeInteger(count) && count > 0 ? count : 0;\n}\n\n/** Whether a try earned every mark there was: float noise above the maximum included. */\nconst fullMarks = (one: ItemTry): boolean => one.score / one.maxScore >= 1 - 1e-9;\n\n/** Whether, after the tries `made`, a question offers another: the rule `open` reads. */\nfunction offersAfter(\n  now: {\n    policy: ResolvedItemScoringPolicy;\n    graded: boolean;\n    disabled: boolean;\n    channel: { triesClosed: boolean } | null;\n  },\n  made: readonly ItemTry[],\n  shut: boolean,\n): boolean {\n  const last = made[made.length - 1];\n  return (\n    now.graded &&\n    !now.disabled &&\n    !shut &&\n    now.channel?.triesClosed !== true &&\n    last !== undefined &&\n    made.length < 1 + now.policy.retries &&\n    !fullMarks(last)\n  );\n}\n\nexport interface TriesInput {\n  policy: ResolvedItemScoringPolicy;\n  /**\n   * Whether the component grades this answer itself and the learner may see\n   * how it went: `practice`, with `feedback` on. \"Try again\" anywhere else\n   * would be meaningless, or would say an answer was wrong on a paper that\n   * does not say so.\n   */\n  graded: boolean;\n  submitted: boolean;\n  disabled: boolean;\n}\n\nexport interface Tries {\n  /** Every graded try so far, in order. */\n  tries: readonly ItemTry[];\n  /** The question's score under the policy, once a try has been graded. */\n  counted: ItemTriesScore | null;\n  /**\n   * Whether the learner is being offered another try at a graded answer: the\n   * last try earned less than full marks, the policy has tries left, and\n   * nothing has closed the question. While it is, the question shows no right\n   * answer and no explanation — either would hand over the answer the next try\n   * is for.\n   */\n  open: boolean;\n  /** Tries still to come after the last graded one. */\n  left: number;\n  /** Records a graded try and returns the question's score under the policy. */\n  record: (graded: ItemTry) => ItemTriesScore;\n  /** Ends the question's tries: \"Show answer\". */\n  close: () => void;\n  /** Forgets every try: a different question. */\n  reset: () => void;\n}\n\n/**\n * The tries a question has had and whether it offers another: the SDK's own\n * components' rules for \"Try again\", in one place.\n *\n * Reports whether a try is on offer to the paper around the question, which\n * waits for it before reporting the set while the question is on screen — and\n * closes every question's tries once it has reported.\n */\nexport function useTries({ policy, graded, submitted, disabled }: TriesInput): Tries {\n  const channel = useContext(SequenceSlotContext);\n  const [tries, setTries] = useState<readonly ItemTry[]>([]);\n  const [closed, setClosed] = useState(false);\n  // Written synchronously, so a submit that records a try and reports it reads\n  // every try before it, whatever React has rendered.\n  const triesRef = useRef<readonly ItemTry[]>([]);\n  const closedRef = useRef(false);\n  const latest = useRef({ policy, graded, disabled, channel });\n  latest.current = { policy, graded, disabled, channel };\n\n  const record = useCallback((one: ItemTry): ItemTriesScore => {\n    const next = [...triesRef.current, one];\n    triesRef.current = next;\n    setTries(next);\n    // An offer of another try is reported before the grade is handed on, not\n    // after the next render: the paper reports its set when a grade fills its\n    // last slot, and must already know to wait. The end of the tries is not:\n    // said now, it would let the paper report the grade this try is replacing.\n    // The effect below says it once this grade has landed.\n    if (offersAfter(latest.current, next, closedRef.current)) {\n      latest.current.channel?.triesState('offered');\n    }\n    return scoreTries(next, latest.current.policy);\n  }, []);\n  const close = useCallback(() => {\n    closedRef.current = true;\n    setClosed(true);\n  }, []);\n  const reset = useCallback(() => {\n    triesRef.current = [];\n    closedRef.current = false;\n    setTries([]);\n    setClosed(false);\n  }, []);\n\n  const allowed = 1 + policy.retries;\n  const left = Math.max(0, allowed - tries.length);\n  const open = submitted && offersAfter(latest.current, tries, closed);\n  // A try the learner is making now — after \"Try again\", before the answer is\n  // in again. Reporting the set then would hand on the grade the learner is in\n  // the middle of replacing.\n  const retrying =\n    !submitted &&\n    tries.length > 0 &&\n    !closed &&\n    graded &&\n    !disabled &&\n    channel?.triesClosed !== true;\n  const state: TriesState = open ? 'offered' : retrying ? 'retrying' : 'none';\n\n  const report = channel?.triesState;\n  useEffect(() => {\n    report?.(state);\n  }, [report, state]);\n  // A question that goes away offers nothing: the paper must not wait for it.\n  useEffect(() => () => report?.('none'), [report]);\n\n  const counted = useMemo(\n    () => (tries.length === 0 ? null : scoreTries(tries, policy)),\n    [tries, policy],\n  );\n  return { tries, counted, open, left, record, close, reset };\n}\n\n/** A fraction of the marks as the whole percentage a learner reads. */\nexport const percentOf = (fraction: number): number => Math.round(fraction * 100);\n\n/**\n * The sentences after the score, on a question whose policy changed it: which\n * try counts when it is not the one just made, what this answer scored before\n * its costs, and how many tries are left.\n */\nexport function triesSummary(\n  s: LkStrings,\n  policy: ResolvedItemScoringPolicy,\n  counted: ItemTriesScore,\n  offered: boolean,\n): string {\n  const parts: string[] = [];\n  const latest = counted.tries.length - 1;\n  const mine = counted.tries[latest];\n  if (mine !== undefined) {\n    if (counted.counted !== latest) {\n      parts.push(\n        s.countedTry(\n          policy.counts === 'best' ? 'best' : 'first',\n          percentOf(mine.scored / mine.maxScore),\n        ),\n      );\n    } else if (mine.scored !== mine.score) {\n      parts.push(s.scoreBeforeCosts(percentOf(mine.score / mine.maxScore)));\n    }\n  }\n  if (offered) {\n    parts.push(\n      s.triesLeft(policy.retries + 1 - counted.tries.length, percentOf(policy.retryPenalty)),\n    );\n  }\n  return parts.join(' ');\n}\n\n/**\n * \"Try again\" and \"Show answer\" — or \"Keep this answer\", on a paper that shows\n * no right answers — after a graded try that did not earn full marks.\n */\nexport function TryActions({\n  tries,\n  solutions,\n  strings: s,\n  onRetry,\n  onClose,\n}: {\n  tries: Tries;\n  /** Whether closing the question will show the right answer. */\n  solutions: boolean;\n  strings: LkStrings;\n  onRetry: () => void;\n  onClose: () => void;\n}): React.JSX.Element | null {\n  if (!tries.open) {\n    return null;\n  }\n  return (\n    <div className=\"lk-tries\">\n      <button type=\"button\" className=\"lk-tries-again\" onClick={onRetry}>\n        {s.tryAgain}\n      </button>\n      <button type=\"button\" className=\"lk-tries-close\" onClick={onClose}>\n        {solutions ? s.showAnswer : s.keepAnswer}\n      </button>\n    </div>\n  );\n}\n\n/** What a hint costs, said before the learner asks for one. */\nexport function HintCost({\n  policy,\n  strings: s,\n}: {\n  policy: ResolvedItemScoringPolicy;\n  strings: LkStrings;\n}): React.JSX.Element | null {\n  if (policy.hintPenalty <= 0) {\n    return null;\n  }\n  return <p className=\"lk-hint-cost\">{s.hintCost(percentOf(policy.hintPenalty))}</p>;\n}\n"],"mappings":"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"}