@khorsheed/dsh-library 0.0.0-stage → 0.1.0

package/lib/types/client/views/station-quiz.js

@@ -0,0 +1,203 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * A station's gate tab: 章节考 on a quiz / read station (the paper card, the
+ * points, the ask settings with the pending ask kept per station, the
+ * station's own mistakes folded into one card, earlier papers), and the
+ * acceptance sheet on an acceptance station.
+ *
+ * @module @khorsheed/dsh-library/client/views/station-quiz
+ */
+import { useEffect, useState } from 'react';
+import { ListRow } from '@khorsheed/dsh-client-ui-panel-kit/src/client/index.ts';
+import { acceptanceLines, coverKind, } from "../../types.js";
+import { collectVoided } from "../mistakes.js";
+import { IconCheckOutlineMedium, IconInfoOutlineMedium } from "../icons.js";
+import { outcome, StateLine, useLoad, value, when } from "../ui.js";
+import { MASTERY_MIN_RIGHT, MASTERY_MIN_SITTINGS, stationMastery } from "../../mastery.js";
+import { MathText } from "../math.js";
+import css from '../LibraryPane.module.css';
+import { QuizRows, sourceMix } from "./book.js";
+/** The right answer as a row caption: choice questions get their letter. */
+function answerText(question) {
+    const at = question.options?.indexOf(question.answer) ?? -1;
+    return at >= 0 ? `${String.fromCharCode(65 + at)}. ${question.answer}` : question.answer;
+}
+/** One missed / flagged question row: the mark, the prompt, and where it sits (answer · when · book). */
+function MissRow({ p, row, variant, book }) {
+    const { t } = p;
+    return (_jsxs("div", { className: css.missRow, children: [_jsx("span", { className: css.missMark, "data-void": variant === 'voided' ? 'true' : undefined, "aria-hidden": "true", children: variant === 'voided' ? '?' : '✕' }), _jsxs("div", { className: css.missText, children: [_jsx("span", { children: _jsx(MathText, { text: row.question.prompt }) }), _jsxs("span", { className: css.muted, children: [variant === 'missed' && _jsxs(_Fragment, { children: [_jsx(MathText, { text: t('node.missedAnswer', { answer: answerText(row.question) }) }), " \u00B7 "] }), when(row.at, t), book === undefined ? '' : ` · ${book}`] })] })] }));
+}
+/**
+ * 章节考 on a quiz / read station, one line of travel (proposal
+ * 2026-10-19-library-point-mastery): the pass line, the points map (tap a
+ * point for why and what to do), then ONE primary action by state — an
+ * untaken paper → 开始作答; open misses → 开始订正 (a retake paper, judged
+ * here, never counted toward passing); else → 出题, its settings folded into
+ * a one-line summary beside the button. Earlier papers fold at the bottom.
+ * The settings and the pending ask live in the pane store per station.
+ */
+export function QuizTab({ p, projectId, resourceId, node, passRatio, onPrime, onReplace }) {
+    const { t, actions, useStore } = p;
+    const rev = useStore(s => s.rev);
+    const [showSettings, setShowSettings] = useState(false);
+    const [showPointsHint, setShowPointsHint] = useState(false);
+    const [expanded, setExpanded] = useState();
+    const [retaking, setRetaking] = useState(false);
+    const [error, setError] = useState();
+    // The settings (范围 / 重点 / 题型 / 题量) and the pending ask live in the pane
+    // store per station, so leaving the tab and coming back keeps both.
+    const stationKey = `${projectId}:${resourceId ?? ''}:${node.id}`;
+    const station = useStore(s => s.quiz[stationKey]);
+    const settings = station?.settings ?? DEFAULT_SETTINGS;
+    const direction = settings.focus;
+    const picked = settings.picked;
+    const kinds = settings.kinds;
+    const countText = settings.countText;
+    const update = (patch) => { actions.setQuizSettings(stationKey, { ...settings, ...patch }); };
+    // After asking, re-read until the coach has stored the new quiz; past the
+    // patience window the card says so instead of silently giving up.
+    const watching = station?.ask;
+    const [now, setNow] = useState(Date.now());
+    const stale = watching !== undefined && now - watching.since > ASK_PATIENCE_MS;
+    const [tick, setTick] = useState(0);
+    useEffect(() => {
+        if (watching === undefined || stale)
+            return;
+        const timer = setInterval(() => {
+            setNow(Date.now());
+            setTick(current => current + 1);
+        }, 4000);
+        return () => { clearInterval(timer); };
+    }, [watching, stale]);
+    // Every assessment of the project (papers, retakes): mastery reads them all.
+    const assessments = useLoad(() => value(p.listAssessments(projectId)), [projectId, rev, tick]);
+    const attempts = useLoad(() => value(p.listAttempts(projectId)), [projectId, rev]);
+    const mine = useLoad(() => value(p.listCards({ projectId, nodeId: node.id, limit: 5 })), [projectId, node.id, rev]);
+    const all = assessments.data?.assessments ?? [];
+    const allAttempts = attempts.data?.attempts ?? [];
+    const shown = all.filter(quiz => quiz.type === 'quiz'
+        && (quiz.scope.nodeId === node.id || (quiz.scope.nodeId === undefined && (resourceId !== undefined ? quiz.scope.resourceId === resourceId : quiz.scope.resourceId === undefined))));
+    const quizCount = shown.length;
+    // The quiz the learner is waiting for opens itself when it lands.
+    useEffect(() => {
+        if (watching === undefined || assessments.data === undefined || quizCount <= watching.count)
+            return;
+        actions.setQuizAsk(stationKey, undefined);
+        const landed = shown.at(-1);
+        if (landed !== undefined)
+            actions.push({ view: 'quiz', projectId, ...(landed.scope.resourceId === undefined ? {} : { resourceId: landed.scope.resourceId }), quizId: landed.id });
+    }, [quizCount, watching]);
+    const stats = node.quizStats;
+    const mineCount = mine.data?.total ?? 0;
+    const papers = shown.filter(quiz => quiz.scope.nodeId === node.id);
+    const live = papers.filter(quiz => quiz.supersededBy === undefined);
+    const latest = live.at(-1) ?? papers.at(-1);
+    const loose = shown.filter(quiz => quiz.scope.nodeId === undefined);
+    const latestByQuiz = new Map();
+    for (const attempt of [...allAttempts].sort((a, b) => b.at.localeCompare(a.at))) {
+        if (attempt.assessmentId !== undefined && !latestByQuiz.has(attempt.assessmentId))
+            latestByQuiz.set(attempt.assessmentId, attempt);
+    }
+    const untaken = latest !== undefined && !latestByQuiz.has(latest.id) ? latest : undefined;
+    const mastery = stationMastery(node, all, allAttempts);
+    const open = mastery.open;
+    const voided = collectVoided(allAttempts, latest === undefined ? [] : [latest]);
+    const weakTitles = mastery.points.filter(point => point.state === 'weak').map(point => point.title);
+    const pickedTitles = mastery.points.filter(point => picked.includes(point.id)).map(point => point.title);
+    const primary = untaken !== undefined ? 'answer' : open.length > 0 ? 'retake' : 'ask';
+    const openPaper = (quiz) => {
+        actions.push({ view: 'quiz', projectId, ...(quiz.scope.resourceId === undefined ? (resourceId === undefined ? {} : { resourceId }) : { resourceId: quiz.scope.resourceId }), quizId: quiz.id });
+    };
+    const parsedCount = () => {
+        const parsed = Number.parseInt(countText.trim(), 10);
+        return Number.isFinite(parsed) ? Math.min(Math.max(parsed, 1), MAX_QUIZ_COUNT) : DEFAULT_QUIZ_COUNT;
+    };
+    const ask = (focusPoints) => {
+        const count = parsedCount();
+        // No picked points: the weak ones are the focus (the coach also reads them every turn).
+        const points = focusPoints ?? (pickedTitles.length > 0 ? pickedTitles : weakTitles);
+        onPrime(direction, { weak: weakTitles, points, kinds, count });
+        const summary = [t(`focus.${direction}`), kinds.length === 0 ? t('node.kindsMixed') : kinds.map(kind => t(`kind.${kind}`)).join('、'), t('node.askCount', { count: String(count) }), ...(points.length > 0 ? [t('node.askFocusPicked', { points: points.join('、') })] : [])].join(' · ');
+        actions.setQuizAsk(stationKey, { since: Date.now(), count: quizCount, summary });
+        setNow(Date.now());
+    };
+    const retake = async (keys) => {
+        if (resourceId === undefined || retaking)
+            return;
+        setRetaking(true);
+        setError(undefined);
+        try {
+            const created = await outcome(p.createRetake(projectId, resourceId, node.id, keys));
+            setExpanded(undefined);
+            actions.push({ view: 'quiz', projectId, resourceId, quizId: created.assessment.id });
+        }
+        catch (failure) {
+            setError(failure instanceof Error ? failure.message : String(failure));
+        }
+        finally {
+            setRetaking(false);
+        }
+    };
+    const asking = watching !== undefined && !stale;
+    const askParts = [
+        [t('node.setting.range'), t(`focus.${direction}`)],
+        [t('node.kindsTitle'), kinds.length === 0 || kinds.length === QUIZ_KINDS.length ? t('node.kindsMixed') : kinds.map(kind => t(`kind.${kind}`)).join('、')],
+        [t('node.countTitle'), t('node.askCount', { count: String(parsedCount()) })],
+        [t('node.focusPoints'), pickedTitles.length > 0 ? t('node.pointsPicked', { count: String(pickedTitles.length) }) : weakTitles.length > 0 ? t('node.pointsWeak', { count: String(weakTitles.length) }) : t('node.pointsCoach')],
+    ];
+    const openByPoint = mastery.points.filter(point => point.open.length > 0).map(point => `${point.title} ${point.open.length}`);
+    const openLoose = open.filter(miss => miss.question.point === undefined || !mastery.points.some(point => point.id === miss.question.point)).length;
+    return (_jsxs(_Fragment, { children: [node.state === 'locked' && _jsx("div", { className: css.notice, children: t('node.locked') }), _jsxs("div", { className: css.muted, children: [t('node.passRule', { percent: String(Math.round(passRatio * 100)) }), stats !== undefined && stats.attempts > 0 ? ` · ${t('node.best', { percent: String(Math.round((stats.bestRatio ?? 0) * 100)), attempts: String(stats.attempts) })}` : ` · ${t('node.neverSat')}`, node.state === 'done' ? ` · ${t('node.passedTag')}` : ''] }), _jsx(StateLine, { loaded: assessments, t: t }), error !== undefined && _jsx("div", { className: css.error, children: error }), watching !== undefined && (_jsxs("section", { className: css.asking, role: "status", "data-stale": stale, children: [_jsxs("span", { className: css.askingText, children: [_jsx("strong", { children: stale ? t('node.askStale') : t('node.asking') }), _jsxs("span", { className: css.muted, children: [watching.summary, " \u00B7 ", t('node.askSince', { minutes: String(Math.max(1, Math.round((now - watching.since) / 60_000))) })] })] }), stale ? _jsx("button", { type: "button", className: css.secondary, onClick: () => { ask(); }, children: t('node.askAgain') }) : null, _jsx("button", { type: "button", className: css.textButton, onClick: () => { actions.setQuizAsk(stationKey, undefined); }, children: t('node.askDismiss') })] })), mastery.points.length > 0 && (_jsxs("section", { className: css.section, children: [_jsxs("h3", { className: `${css.sectionTitle} ${css.pointsHead}`, children: [t('node.pointsTitle'), _jsx("button", { type: "button", className: css.infoButton, "aria-expanded": showPointsHint, "aria-label": t('node.pointsHintLabel'), onClick: () => { setShowPointsHint(shown => !shown); }, children: _jsx(IconInfoOutlineMedium, { size: 13 }) })] }), _jsx("div", { className: css.pointRows, children: mastery.points.map(point => {
+                            const isOpen = expanded === point.id;
+                            return (_jsxs("div", { className: css.pointItem, "data-open": isOpen, children: [_jsxs("button", { type: "button", className: css.pointRow, "aria-expanded": isOpen, onClick: () => { setExpanded(isOpen ? undefined : point.id); }, children: [_jsxs("span", { className: css.pointRowMain, children: [_jsx("span", { className: css.pointRowTitle, children: point.title }), _jsxs("span", { className: css.muted, children: [point.asked === 0 ? t('point.never') : t('point.counts', { asked: String(point.asked), right: String(point.right) }), point.open.length > 0 ? ` · ${t('node.pointOpen', { count: String(point.open.length) })}` : '', point.notes.length > 0 ? ` · ${t('point.noteCount', { count: String(point.notes.length) })}` : ''] })] }), _jsx("span", { className: css.pointBadge, "data-state": point.state, children: t(`point.${point.state}`) }), _jsx("span", { className: css.chevron, "aria-hidden": "true", children: "\u203A" })] }), isOpen && _jsx(PointDetail, { p: p, point: point, busy: retaking, onRetake: () => { void retake(point.open.map(miss => miss.key)); } })] }, point.id));
+                        }) }), showPointsHint && _jsx("div", { className: css.muted, children: t('node.pointsRule') })] })), untaken !== undefined && (_jsxs("section", { className: css.stepBox, children: [_jsxs("span", { className: css.stepText, children: [_jsx("strong", { children: t('node.untakenBox', { count: String(untaken.questions?.length ?? 0) }) }), _jsx("span", { className: css.muted, children: [t(`focus.${untaken.focus ?? 'mixed'}`), sourceMix((untaken.questions ?? []).map(question => question.evidence.kind), t), when(untaken.createdAt, t)].join(' · ') })] }), _jsx("button", { type: "button", className: css.primary, onClick: () => { openPaper(untaken); }, children: t('quiz.startNow') })] })), open.length > 0 && (_jsxs("section", { className: css.stepBox, children: [_jsxs("span", { className: css.stepText, children: [_jsx("strong", { children: t('node.retakeBox', { count: String(open.length) }) }), _jsx("span", { className: css.muted, children: [...openByPoint, ...(openLoose > 0 ? [t('node.retakeOther', { count: String(openLoose) })] : []), t('node.missedMeta', { when: when(open[0].at, t) })].join(' · ') }), _jsx("span", { className: css.muted, children: t('node.retakeHint') })] }), _jsx("button", { type: "button", className: primary === 'retake' ? css.primary : css.secondary, disabled: retaking || resourceId === undefined, onClick: () => { void retake(); }, children: t('node.retakeStart') })] })), _jsxs("section", { className: `${css.stepBox} ${css.stepBoxPlain}`, children: [_jsxs("span", { className: css.stepText, children: [_jsx("strong", { children: t('node.askBox') }), _jsx("span", { className: css.askParts, children: askParts.map(([label, valueText]) => _jsxs("span", { className: css.askPart, children: [_jsx("span", { className: css.muted, children: label }), valueText] }, label)) })] }), _jsxs("span", { className: css.askActions, children: [_jsx("button", { type: "button", className: css.ghost, "aria-expanded": showSettings, onClick: () => { setShowSettings(!showSettings); }, children: showSettings ? t('node.askDone') : t('node.askAdjust') }), _jsx("button", { type: "button", className: primary === 'ask' ? css.primary : css.secondary, disabled: asking, onClick: () => { ask(); }, children: asking ? t('node.quizWaiting') : t('node.askGo') })] }), showSettings && (_jsxs("div", { className: css.stepSettings, children: [_jsxs("div", { className: css.settingRow, children: [_jsx("span", { className: css.settingLabel, children: t('node.setting.range') }), _jsxs("div", { className: css.settingControl, children: [_jsx("div", { className: css.pickWrap, role: "radiogroup", "aria-label": t('node.setting.range'), children: FOCUSES.map(id => (_jsxs("button", { type: "button", role: "radio", className: css.pick, "aria-checked": direction === id, "aria-pressed": direction === id, onClick: () => { update({ focus: id }); }, children: [t(`focus.${id}`), id === 'mine' ? _jsx("span", { className: css.pickState, children: mineCount }) : null] }, id))) }), _jsx("div", { className: css.muted, children: direction === 'mine'
+                                                    ? mineCount === 0 ? t('node.focusMineEmpty') : t('node.focusMineHint', { terms: (mine.data?.cards ?? []).map(card => card.term).join('、') })
+                                                    : t(`node.focusHint.${direction}`) })] })] }), _jsxs("div", { className: css.settingRow, children: [_jsx("span", { className: css.settingLabel, children: t('node.kindsTitle') }), _jsxs("div", { className: css.settingControl, children: [_jsx("div", { className: css.pickWrap, role: "group", "aria-label": t('node.kindsTitle'), children: QUIZ_KINDS.map(id => (_jsx("button", { type: "button", className: css.pick, "aria-pressed": kinds.includes(id), onClick: () => { update({ kinds: kinds.includes(id) ? kinds.filter(kind => kind !== id) : [...kinds, id] }); }, children: t(`kind.${id}`) }, id))) }), _jsx("div", { className: css.muted, children: t('node.kindsHint') })] })] }), _jsxs("div", { className: css.settingRow, children: [_jsx("span", { className: css.settingLabel, children: t('node.countTitle') }), _jsx("input", { className: `${css.input} ${css.countInput}`, inputMode: "numeric", "aria-label": t('node.countTitle'), placeholder: String(DEFAULT_QUIZ_COUNT), value: countText, onChange: event => { update({ countText: event.target.value }); }, onBlur: () => { update({ countText: String(parsedCount()) }); } })] }), mastery.points.length > 0 && (_jsxs("div", { className: css.settingRow, children: [_jsx("span", { className: css.settingLabel, children: t('node.focusPoints') }), _jsxs("div", { className: css.settingControl, children: [_jsx("div", { className: css.pickWrap, role: "group", "aria-label": t('node.focusPoints'), children: mastery.points.map(point => (_jsxs("button", { type: "button", className: css.pick, "aria-pressed": picked.includes(point.id), onClick: () => { update({ picked: picked.includes(point.id) ? picked.filter(entry => entry !== point.id) : [...picked, point.id] }); }, children: [point.title, _jsx("span", { className: css.pickState, "data-state": point.state, children: t(`point.${point.state}`) })] }, point.id))) }), _jsx("div", { className: css.muted, children: t('node.focusPointsHint') })] })] }))] }))] }), voided.length > 0 && (_jsxs("div", { className: css.muted, children: [t('node.voidedSummary', { count: String(voided.length) }), ' · ', _jsx("button", { type: "button", className: css.textButton, onClick: () => { onReplace(voided.map(row => row.question.prompt)); }, children: t('node.voidedReplace') })] })), papers.length > 0 && (_jsxs("details", { className: css.earlier, children: [_jsx("summary", { children: t('node.earlier', { count: String(papers.length) }) }), [...papers].reverse().map(quiz => {
+                        const sat = latestByQuiz.get(quiz.id);
+                        return (_jsx(ListRow, { title: t('node.quizRow', { count: String(quiz.questions?.length ?? 0) }), meta: [sat === undefined ? t('node.paperUntaken') : `${Math.round(sat.ratio * 100)}%`, t(`focus.${quiz.focus ?? 'mixed'}`), when(quiz.createdAt, t)].join(' · '), trailing: _jsx("span", { className: css.linkText, children: sat === undefined ? t('quiz.start') : t('node.redoSame') }), onSelect: () => { openPaper(quiz); } }, quiz.id));
+                    })] })), loose.length > 0 && (_jsxs("section", { className: css.section, children: [_jsx("h3", { className: css.sectionTitle, children: t(resourceId === undefined ? 'project.quizzes' : 'book.quizzes', { count: String(loose.length) }) }), _jsx(QuizRows, { p: p, projectId: projectId, quizzes: loose.slice().reverse() })] }))] }));
+}
+/** One point, expanded under its row: why it stands where it does, and the way forward. */
+function PointDetail({ p, point, busy, onRetake }) {
+    const { t } = p;
+    const needRight = Math.max(0, MASTERY_MIN_RIGHT - point.right);
+    const needSittings = Math.max(0, MASTERY_MIN_SITTINGS - point.rightSittings);
+    return (_jsxs("div", { className: css.pointDetail, children: [_jsx("div", { className: css.muted, children: t(`point.why.${point.state}`, { right: String(needRight), sittings: String(needSittings) }) }), point.state === 'practicing' && (_jsxs("div", { className: css.pointNeed, children: [needRight > 0 && _jsx("span", { children: t('point.needRight', { count: String(needRight) }) }), needSittings > 0 && _jsx("span", { children: t('point.needSitting') })] })), point.history.length > 0 && (_jsxs("div", { className: css.pointBlock, children: [_jsx("h4", { className: css.pointBlockTitle, children: t('point.history') }), point.history.map(sitting => (_jsxs("div", { className: css.moveRow, children: [_jsxs("span", { children: [when(sitting.at, t), " \u00B7 ", t(sitting.retake ? 'point.sitRetake' : 'point.sitPaper')] }), _jsx("span", { className: sitting.right === sitting.total ? css.ok : css.bad, children: t('point.sitScore', { right: String(sitting.right), total: String(sitting.total) }) })] }, sitting.at)))] })), point.notes.length > 0 && (_jsxs("div", { className: css.pointBlock, children: [_jsx("h4", { className: css.pointBlockTitle, children: t('point.notes') }), [...point.notes].reverse().map(note => (_jsxs("div", { className: css.pointNote, children: [_jsx(MathText, { text: note.text }), _jsxs("span", { className: css.muted, children: [" \u00B7 ", when(note.at, t)] })] }, note.at)))] })), point.open.length > 0 && (_jsxs("div", { className: css.pointBlock, children: [_jsx("h4", { className: css.pointBlockTitle, children: t('point.open', { count: String(point.open.length) }) }), _jsx("div", { className: css.mistakeRows, children: point.open.map(miss => _jsx(MissRow, { p: p, row: { question: miss.question, at: miss.at }, variant: "missed" }, miss.key)) }), _jsx("div", { className: css.actions, children: _jsx("button", { type: "button", className: css.primary, disabled: busy, onClick: onRetake, children: t('point.retake', { count: String(point.open.length) }) }) })] })), point.open.length === 0 && point.state !== 'mastered' && _jsx("div", { className: css.muted, children: t('point.askBelow') })] }));
+}
+/** An acceptance station's gate tab: the rubric, the submit gesture, the history. */
+export function AcceptanceTab({ p, projectId, node, passRatio, onPrime }) {
+    const { t, actions, useStore } = p;
+    const rev = useStore(s => s.rev);
+    const attempts = useLoad(() => value(p.listAttempts(projectId, node.id)), [projectId, node.id, rev]);
+    // The station gates no quiz itself, but its covered thick resources may hold
+    // resource-level ones (本书测验) — the acceptance lines often ref them.
+    const coveredThick = [...new Set(node.covers.flatMap(cover => coverKind(cover) === 'resource' ? [cover.ref] : []))];
+    const looseQuizzes = useLoad(async () => {
+        const lists = await Promise.all(coveredThick.map(id => value(p.listAssessments(projectId, id, undefined, 'quiz'))));
+        return lists.flatMap(result => result.assessments).filter(quiz => quiz.scope.nodeId === undefined);
+    }, [projectId, node.id, rev, coveredThick.join(',')]);
+    // A ref line's live state, before any acceptance sitting: the referenced
+    // assessment's latest sitting does the judging (attempts arrive newest first).
+    const allAttempts = useLoad(() => value(p.listAttempts(projectId)), [projectId, rev]);
+    const latest = attempts.data?.attempts[0];
+    const rubric = acceptanceLines(node);
+    const verdictOf = (line) => latest?.verdicts.find(verdict => (verdict.task === line.id || verdict.criterion === line.line) && verdict.void !== true)
+        ?? (line.ref === undefined ? undefined : (() => {
+            const sitting = (allAttempts.data?.attempts ?? []).find(attempt => attempt.assessmentId === line.ref);
+            return sitting === undefined ? undefined : { task: line.id, criterion: line.line, pass: sitting.ratio >= passRatio, ratio: sitting.ratio, evidence: '', by: 'auto' };
+        })());
+    return (_jsxs(_Fragment, { children: [node.state === 'locked' && _jsx("div", { className: css.notice, children: t('node.locked') }), _jsxs("div", { className: css.muted, children: [t('accept.station', { count: String(rubric.length) }), " \u00B7 ", t('accept.passRule', { percent: String(Math.round(passRatio * 100)) })] }), _jsxs("section", { className: css.section, children: [_jsx("h3", { className: css.sectionTitle, children: t('accept.title') }), _jsx("ul", { className: css.acceptList, children: rubric.map(line => {
+                            const verdict = verdictOf(line);
+                            return (_jsxs("li", { className: css.acceptItem, children: [_jsx("span", { className: css.acceptMark, "data-state": verdict === undefined ? 'none' : (verdict.pass && (verdict.ratio ?? 1) >= 0.5) ? 'pass' : 'fail', "aria-hidden": "true", children: verdict === undefined ? '' : (verdict.pass && (verdict.ratio ?? 1) >= 0.5) ? _jsx(IconCheckOutlineMedium, { size: 11 }) : '✕' }), _jsxs("span", { className: css.acceptText, children: [line.line, line.ref !== undefined && (_jsxs("button", { type: "button", className: css.textButton, onClick: () => { actions.push({ view: 'quiz', projectId, quizId: line.ref }); }, children: [t('accept.machine'), " \u2192"] })), verdict !== undefined && verdict.ratio !== undefined && verdict.ratio > 0 && verdict.ratio < 1 ? _jsxs("span", { className: css.muted, children: [" \u00B7 ", Math.round(verdict.ratio * 100), "%"] }) : null] })] }, line.id));
+                        }) }), _jsx("div", { className: css.muted, children: t('accept.hint') })] }), (looseQuizzes.data?.length ?? 0) > 0 && (_jsxs("section", { className: css.section, children: [_jsx("h3", { className: css.sectionTitle, children: t('book.quizzes', { count: String(looseQuizzes.data.length) }) }), _jsx(QuizRows, { p: p, projectId: projectId, quizzes: looseQuizzes.data })] })), _jsx("div", { className: css.actions, children: _jsx("button", { type: "button", className: css.primary, onClick: onPrime, children: t('accept.submit') }) }), _jsx("div", { className: css.muted, children: t('accept.submitHint') }), (attempts.data?.attempts.length ?? 0) > 0 && (_jsxs("section", { className: css.section, children: [_jsx("h3", { className: css.sectionTitle, children: t('accept.history') }), attempts.data.attempts.map(attempt => (_jsxs("div", { className: css.moveRow, children: [_jsxs("span", { children: [Math.round(attempt.ratio * 100), "%"] }), _jsx("span", { className: css.muted, children: when(attempt.at, t) })] }, attempt.id)))] }))] }));
+}
+const FOCUSES = ['mine', 'book', 'mixed'];
+const QUIZ_KINDS = ['choice', 'fill', 'free'];
+/** 题量 field's default — a chapter quiz's one-sitting size. */
+const DEFAULT_QUIZ_COUNT = 10;
+/** A station's 章节考 settings before the learner touches them: 都考, the coach's mix of kinds, 10 questions. */
+const DEFAULT_SETTINGS = { focus: 'mixed', kinds: [], countText: String(DEFAULT_QUIZ_COUNT), picked: [] };
+/** How long the tab waits for an asked quiz before saying it has not landed (a 20-question paper takes minutes). */
+const ASK_PATIENCE_MS = 8 * 60_000;
+/** The 题量 field's cap — past this a chapter quiz stops being one sitting. */
+const MAX_QUIZ_COUNT = 20;

package/lib/types/client/views/station.d.ts

@@ -0,0 +1,18 @@
+/**
+ * One station of a textbook's path: 导读 (with the lesson card: 开始学这一站 /
+ * 打开讲义 — the 讲义 are their own page, views/lesson.tsx) / 我的记录 (the
+ * photographed pages) / 章节考 (views/station-quiz.tsx).
+ *
+ * @module @khorsheed/dsh-library/client/views/station
+ */
+import { type ReactNode } from 'react';
+import type { LibraryNodeTab } from '../store.ts';
+import { type ViewProps } from '../ui.tsx';
+/** One node: guide (with the lesson card), photographed pages, and the gate tab 章节考 — on every kind of station. */
+export declare function NodeView({ p, projectId, resourceId, nodeId, tab }: ViewProps & {
+    projectId: string;
+    resourceId: string;
+    nodeId: string;
+    tab: LibraryNodeTab;
+}): ReactNode;
+//# sourceMappingURL=station.d.ts.map

package/lib/types/client/views/station.js

@@ -0,0 +1,142 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * One station of a textbook's path: 导读 (with the lesson card: 开始学这一站 /
+ * 打开讲义 — the 讲义 are their own page, views/lesson.tsx) / 我的记录 (the
+ * photographed pages) / 章节考 (views/station-quiz.tsx).
+ *
+ * @module @khorsheed/dsh-library/client/views/station
+ */
+import { useEffect, useState } from 'react';
+import { ListRow, PanelHeader, UnderlineTabs } from '@khorsheed/dsh-client-ui-panel-kit/src/client/index.ts';
+import { acceptanceLines, coverKind, isThickResource } from "../../types.js";
+import { CoverChips, coverLabel } from "../covers.js";
+import { IconSparkleMedium } from "../icons.js";
+import { IconCameraOutlineMedium } from "../icons-local.js";
+import { outcome, shortGloss, StateLine, useLoad, value, WeaknessBars } from "../ui.js";
+import css from '../LibraryPane.module.css';
+/** The zigzag column (0..2) a node at `index` sits in. */
+import { AcceptanceTab, QuizTab } from "./station-quiz.js";
+import { rowsOf } from "./book.js";
+import { LessonCard } from "./lesson.js";
+/** One node: guide (with the lesson card), photographed pages, and the gate tab 章节考 — on every kind of station. */
+export function NodeView({ p, projectId, resourceId, nodeId, tab }) {
+    const { t, actions, useStore } = p;
+    const rev = useStore(s => s.rev);
+    const loaded = useLoad(async () => {
+        const [detail, roadmaps] = await Promise.all([outcome(p.getProject(projectId)), value(p.getRoadmap(projectId, resourceId))]);
+        const resource = detail.resources.find(candidate => candidate.id === resourceId);
+        const node = roadmaps.roadmap?.nodes.find(candidate => candidate.id === nodeId);
+        return { resource, resources: detail.resources, project: detail.project, node, passRatio: roadmaps.roadmap?.passRatio ?? 0.8 };
+    }, [projectId, resourceId, nodeId, rev]);
+    const [notice, setNotice] = useState();
+    const node = loaded.data?.node;
+    // The pages tab rides the station's own textbook, when the station covers it.
+    const coversOwn = (node?.covers ?? []).some(cover => coverKind(cover) === 'resource' && cover.ref === resourceId);
+    const resource = loaded.data?.resource;
+    const prime = (text) => {
+        void p.bindTarget({ projectId, resourceId });
+        setNotice(p.primeConversation(text) ? t('notice.primed') : t('notice.noConversation'));
+    };
+    const tabs = [
+        { id: 'guide', label: t('node.guide') },
+        ...(coversOwn && resource !== undefined && isThickResource(resource) ? [{ id: 'pages', label: t('node.pages') }] : []),
+        // Every station ends in 章节考: a quiz / read station's papers, an
+        // acceptance station's rubric sheet.
+        { id: 'quiz', label: t('node.quiz') },
+    ];
+    const activeTab = tabs.some(candidate => candidate.id === tab) ? tab : 'guide';
+    const coverContext = { resources: loaded.data?.resources ?? [] };
+    return (_jsxs(_Fragment, { children: [_jsx(PanelHeader, { title: node?.title ?? '', meta: resource?.title ?? loaded.data?.project.name, onBack: () => { actions.pop(); }, backLabel: t('action.back'), actions: node === undefined ? [] : [
+                    { id: 'ask', label: t('action.askCoach'), icon: _jsx(IconSparkleMedium, {}), onSelect: () => { prime(t('prime.node', { book: resource?.title ?? '', node: node.title })); } },
+                ], moreLabel: t('action.more') }), node !== undefined && (_jsx("div", { className: css.coversRow, children: _jsx(CoverChips, { covers: node.covers, context: coverContext, t: t }) })), _jsx(UnderlineTabs, { label: t('node.tabs'), tabs: tabs, value: activeTab, onChange: next => { actions.replace({ view: 'node', projectId, resourceId, nodeId, tab: next }); } }), _jsxs("div", { className: css.body, children: [_jsx(StateLine, { loaded: loaded, t: t }), notice !== undefined && _jsx("div", { className: css.notice, children: notice }), node !== undefined && activeTab === 'guide' && (_jsx(GuideTab, { p: p, projectId: projectId, resourceId: resourceId, node: node, resource: resource, coverContext: coverContext })), node !== undefined && activeTab === 'pages' && resource !== undefined && (_jsx(PagesTab, { p: p, projectId: projectId, resourceId: resourceId, resourceTitle: resource.title, node: node, onBind: () => { void p.bindTarget({ projectId, resourceId }); } })), node !== undefined && activeTab === 'quiz' && node.gate === 'acceptance' && (_jsx(AcceptanceTab, { p: p, projectId: projectId, node: node, passRatio: loaded.data?.passRatio ?? 0.8, onPrime: () => { prime(t('prime.accept', { node: node.title, nodeId: node.id, criteria: acceptanceLines(node).map(line => `- ${line.id}: ${line.line}`).join('\n') })); } })), node !== undefined && activeTab === 'quiz' && node.gate !== 'acceptance' && (_jsx(QuizTab, { p: p, projectId: projectId, resourceId: resourceId, node: node, passRatio: loaded.data?.passRatio ?? 0.8, onPrime: (focus, context) => {
+                            const base = t(`prime.quiz.${focus}`, { book: resource?.title ?? '', node: node.title });
+                            const weak = context?.weak ?? [];
+                            const points = context?.points ?? [];
+                            const kinds = context?.kinds ?? [];
+                            prime(base
+                                + (weak.length > 0 ? t('prime.quiz.weakSuffix', { terms: weak.join('、') }) : '')
+                                + (points.length > 0 ? t('prime.quiz.pointsSuffix', { points: points.join('、') }) : '')
+                                + (kinds.length > 0 ? t('prime.quiz.kindsSuffix', { kinds: kinds.map(kind => t(`kind.${kind}`)).join('、') }) : '')
+                                + (context?.count !== undefined ? t('prime.quiz.countSuffix', { count: String(context.count) }) : ''));
+                        }, onReplace: prompts => { prime(t('prime.quiz.replace', { node: node.title, list: prompts.map(prompt => `- ${prompt}`).join('\n') })); } }))] })] }));
+}
+function GuideTab({ p, projectId, resourceId, node, resource, coverContext }) {
+    const { t, actions } = p;
+    const rows = resource === undefined ? [] : rowsOf(node, resource);
+    const [error, setError] = useState();
+    const [marking, setMarking] = useState(false);
+    return (_jsxs(_Fragment, { children: [node.state === 'locked' && _jsx("div", { className: css.notice, children: t('node.locked') }), resourceId !== undefined && _jsx(LessonCard, { p: p, projectId: projectId, resourceId: resourceId, node: node, resource: resource }), node.goals.length > 0 && (_jsxs("section", { className: css.section, children: [_jsx("h3", { className: css.sectionTitle, children: t('node.goals') }), _jsx("ul", { className: css.goals, children: node.goals.map(goal => _jsx("li", { children: goal }, goal)) })] })), rows.length > 0 && (_jsxs("section", { className: css.section, children: [_jsx("h3", { className: css.sectionTitle, children: t('node.covers') }), _jsx("ul", { className: css.goals, children: rows.map(row => _jsx("li", { children: row }, row)) })] })), resource === undefined && node.covers.length > 0 && (_jsxs("section", { className: css.section, children: [_jsx("h3", { className: css.sectionTitle, children: t('node.covers') }), _jsx("ul", { className: css.goals, children: node.covers.map((cover, at) => _jsx("li", { children: coverLabel(cover, coverContext, t) }, at)) })] })), _jsx("div", { className: css.actions, children: node.gate === 'read' && node.state === 'current' && (_jsx("button", { type: "button", className: css.primary, disabled: marking, onClick: () => {
+                        setMarking(true);
+                        void outcome(p.markNodeRead(projectId, resourceId, node.id)).then(() => { actions.pop(); }, (failure) => { setError(String(failure)); setMarking(false); });
+                    }, children: t('node.markRead') })) }), error !== undefined && _jsx("div", { className: css.error, children: error })] }));
+}
+function PagesTab({ p, projectId, resourceId, resourceTitle, node, onBind }) {
+    const { t, useStore, actions } = p;
+    const rev = useStore(s => s.rev);
+    const [notice, setNotice] = useState();
+    // After a photo goes out, re-read every few seconds until the coach has
+    // recorded a new page (or two minutes pass) — the page lands here by itself.
+    const [watching, setWatching] = useState();
+    const [tick, setTick] = useState(0);
+    useEffect(() => {
+        if (watching === undefined)
+            return;
+        const timer = setInterval(() => {
+            if (Date.now() - watching.since > 120_000)
+                setWatching(undefined);
+            else
+                setTick(value => value + 1);
+        }, 4000);
+        return () => { clearInterval(timer); };
+    }, [watching]);
+    const pages = useLoad(() => value(p.listPages(projectId, resourceId, node.id)), [projectId, resourceId, node.id, rev, tick]);
+    const cards = useLoad(() => value(p.listCards({ projectId, nodeId: node.id, limit: 50 })), [projectId, node.id, rev, tick]);
+    const count = pages.data?.pages.length ?? 0;
+    useEffect(() => {
+        if (watching !== undefined && count > watching.pages) {
+            setWatching(undefined);
+            setNotice(t('node.photoRecorded'));
+        }
+    }, [count, watching]);
+    const send = (sent, ok) => {
+        setNotice(sent ? ok : t('notice.noConversation'));
+    };
+    const onPick = (file) => {
+        if (file === undefined)
+            return;
+        onBind();
+        const sent = p.sendPhoto(file, t('prime.photo', { book: resourceTitle, node: node.title }));
+        if (sent)
+            setWatching({ since: Date.now(), pages: count });
+        send(sent, t('node.photoSent'));
+    };
+    return (_jsxs(_Fragment, { children: [_jsx(StateLine, { loaded: pages, t: t }), notice !== undefined && _jsx("div", { className: css.notice, children: notice }), _jsxs("div", { className: css.pages, children: [(pages.data?.pages ?? []).map(page => _jsx(PageThumb, { p: p, projectId: projectId, page: page }, page.id)), _jsxs("label", { className: css.pageAdd, children: [_jsx(IconCameraOutlineMedium, {}), _jsx("span", { children: watching === undefined ? t('node.photo') : t('node.photoWaiting') }), _jsx("input", { className: css.fileInput, type: "file", accept: "image/*", capture: "environment", onChange: event => { onPick(event.target.files?.[0]); event.target.value = ''; } })] })] }), (pages.data?.pages ?? []).map(page => (_jsx(PageFixes, { p: p, page: page, onSend: (text, ok) => { onBind(); send(p.sendMessage(text), ok); } }, page.id))), (cards.data?.cards.length ?? 0) > 0 && (_jsxs("section", { className: css.section, children: [_jsx("h3", { className: css.sectionTitle, children: t('node.cardsHere', { count: String(cards.data.total) }) }), cards.data.cards.map(card => (_jsx(ListRow, { title: card.term, meta: shortGloss(card.gloss), trailing: _jsx(WeaknessBars, { weakness: card.weakness, label: t('cards.weakness', { level: String(card.weakness) }) }), onSelect: () => { actions.push({ view: 'cards', projectId, filter: 'all' }); } }, card.id)))] }))] }));
+}
+/**
+ * One page's corrections: the marks the coach was unsure of (tap to keep
+ * one) and a word it missed (type it). Both go out as the learner's own
+ * message, so the chat shows what was asked and the coach cards it in context.
+ */
+function PageFixes({ p, page, onSend }) {
+    const { t } = p;
+    const [adding, setAdding] = useState(false);
+    const [word, setWord] = useState('');
+    const label = page.label ?? t('node.thisPage');
+    const uncertain = page.marks.filter(mark => mark.uncertain === true);
+    return (_jsxs("section", { className: css.fixes, children: [_jsxs("div", { className: css.fixesHead, children: [_jsx("span", { className: css.muted, children: label }), !adding && _jsx("button", { type: "button", className: css.textButton, onClick: () => { setAdding(true); }, children: t('node.addMissed') })] }), uncertain.length > 0 && (_jsxs("div", { className: css.chips, children: [_jsx("span", { className: css.muted, children: t('node.uncertain') }), uncertain.map(mark => (_jsx("button", { type: "button", className: css.chipButton, onClick: () => { onSend(t('prime.keepMark', { page: label, word: mark.text }), t('node.fixSent')); }, children: mark.text }, mark.text)))] })), adding && (_jsxs("form", { className: css.row, onSubmit: event => {
+                    event.preventDefault();
+                    if (word.trim() === '')
+                        return;
+                    onSend(t('prime.addMissed', { page: label, word: word.trim() }), t('node.fixSent'));
+                    setWord('');
+                    setAdding(false);
+                }, children: [_jsx("input", { className: css.input, autoFocus: true, value: word, placeholder: t('node.addMissedPlaceholder'), onChange: event => { setWord(event.target.value); } }), _jsx("button", { type: "submit", className: css.secondary, disabled: word.trim() === '', children: t('node.send') })] }))] }));
+}
+/** A page thumbnail: the photo read back on demand, its label and mark count. */
+function PageThumb({ p, projectId, page }) {
+    const { t } = p;
+    const photo = useLoad(() => outcome(p.readPagePhoto(projectId, page.id)), [projectId, page.id]);
+    return (_jsxs("figure", { className: css.page, children: [photo.data !== undefined
+                ? _jsx("img", { className: css.pageImage, src: `data:${photo.data.mediaType};base64,${photo.data.data}`, alt: page.label ?? '' })
+                : _jsx("span", { className: css.pageImage, "aria-hidden": "true" }), _jsx("figcaption", { className: css.muted, children: t('node.pageCaption', { label: page.label ?? '', marks: String(page.marks.length) }) })] }));
+}

package/lib/types/image-refs.d.ts

@@ -0,0 +1,35 @@
+/**
+ * The image references a session's messages carried, remembered as they are
+ * committed — so recording a photographed page never depends on the model
+ * copying a reference it only partly sees.
+ *
+ * Live trial (2026-10-06, deepseek-flash): the model sees an image block's id
+ * without its `sha256:` prefix and without `bytes`, and guessed the rest four
+ * times over. The full reference is on the committed `user/message` event,
+ * so the tool row watches `session/event` and keeps the last few per session
+ * (the synchronous history readers are deprecated; this is the delivered
+ * current event). A restarted host starts empty: a page then needs the full
+ * reference, or a photo sent after the restart.
+ *
+ * @module @khorsheed/dsh-library/image-refs
+ */
+import type { LibraryAttachmentRef } from './types.ts';
+/** A whole reference, when a value carries every field. */
+export declare function asAttachmentRef(value: unknown): LibraryAttachmentRef | undefined;
+/** The image references each session's user messages carried, newest last. */
+export declare class ImageRefCache {
+    private readonly bySession;
+    /** Remember the images one committed event carries (non-image events are ignored). */
+    observe(sessionId: string, event: {
+        type?: unknown;
+        data?: unknown;
+    }): void;
+    remember(sessionId: string, ref: LibraryAttachmentRef): void;
+    /**
+     * The whole reference for what the model wrote: a complete reference
+     * passes through; an id (with or without its prefix) is looked up; nothing
+     * at all means the session's latest photo.
+     */
+    resolve(sessionId: string | undefined, written: unknown): LibraryAttachmentRef | undefined;
+}
+//# sourceMappingURL=image-refs.d.ts.map

package/lib/types/image-refs.js

@@ -0,0 +1,71 @@
+/** How many images per session are remembered. */
+const PER_SESSION = 20;
+/** How many sessions are remembered. */
+const SESSIONS = 200;
+/** The id without its digest prefix, for matching what the model wrote. */
+function bareId(id) {
+    return id.replace(/^sha256:/, '');
+}
+/** A whole reference, when a value carries every field. */
+export function asAttachmentRef(value) {
+    if (typeof value !== 'object' || value === null)
+        return undefined;
+    const ref = value;
+    if (typeof ref.attachmentId !== 'string' || typeof ref.mediaType !== 'string')
+        return undefined;
+    if (typeof ref.bytes !== 'number' || ref.bytes <= 0)
+        return undefined;
+    if (typeof ref.width !== 'number' || typeof ref.height !== 'number')
+        return undefined;
+    return { attachmentId: ref.attachmentId, mediaType: ref.mediaType, bytes: ref.bytes, width: ref.width, height: ref.height };
+}
+/** The image references each session's user messages carried, newest last. */
+export class ImageRefCache {
+    bySession = new Map();
+    /** Remember the images one committed event carries (non-image events are ignored). */
+    observe(sessionId, event) {
+        if (event.type !== 'user/message')
+            return;
+        const content = event.data?.content;
+        if (!Array.isArray(content))
+            return;
+        for (const block of content) {
+            if (block?.type !== 'image')
+                continue;
+            const ref = asAttachmentRef(block.attachment);
+            if (ref !== undefined)
+                this.remember(sessionId, ref);
+        }
+    }
+    remember(sessionId, ref) {
+        const list = this.bySession.get(sessionId) ?? [];
+        const kept = list.filter(entry => entry.attachmentId !== ref.attachmentId);
+        kept.push(ref);
+        this.bySession.delete(sessionId);
+        this.bySession.set(sessionId, kept.slice(-PER_SESSION));
+        while (this.bySession.size > SESSIONS)
+            this.bySession.delete(this.bySession.keys().next().value);
+    }
+    /**
+     * The whole reference for what the model wrote: a complete reference
+     * passes through; an id (with or without its prefix) is looked up; nothing
+     * at all means the session's latest photo.
+     */
+    resolve(sessionId, written) {
+        const whole = asAttachmentRef(written);
+        const known = sessionId === undefined ? [] : this.bySession.get(sessionId) ?? [];
+        const id = typeof written === 'string'
+            ? written
+            : typeof written?.attachmentId === 'string'
+                ? written.attachmentId
+                : undefined;
+        if (id !== undefined) {
+            const match = known.find(ref => bareId(ref.attachmentId) === bareId(id));
+            if (match !== undefined)
+                return match;
+        }
+        if (whole !== undefined)
+            return whole;
+        return id === undefined ? known.at(-1) : undefined;
+    }
+}

package/lib/types/index.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Library plugin, host half: provides the service core and mounts its Remote
+ * face. Composing this plugin out of a profile removes every surface it adds.
+ *
+ * The host half owns the two things the browser cannot do: persisting state
+ * next to the deployment (`$DSH_HOME/state/dsh-library`, plain `node:fs` — the
+ * reader precedent; `ctx.fs` is the session-fenced sandbox and refuses it) and
+ * the attachment store (saving sidebar photos, reading page photos back). The
+ * browser half renders.
+ *
+ * The model face (library_read, one library_<noun> tool per write,
+ * library_assess, the coach prompt section, the per-turn bound context) is
+ * deliberately NOT here: it is the `./tool` composition entry
+ * (`src/tool.ts`), which an agent preset names — the evaluation-family fold
+ * pattern.
+ *
+ * @module @khorsheed/dsh-library
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import { LibraryService } from './service.ts';
+export { LibraryService, LibraryDisposedError, leitnerDueAt, unlockReady, validateRoadmapShape, coversVerbatimBlocker } from './service.ts';
+export { cardKey, cardKeys, cardMatchesQuery, exactMatch, keySimilarity, nearMatches, NEAR_DUPLICATE } from './cards.ts';
+export { LibraryRemoteService } from './remote.ts';
+export type { LibraryRemoteConfig } from './remote.ts';
+export { acquireLibraryLock, assertLibraryId, emptyLibraryIndex, LibraryStore, LibraryStoreError, mintLibraryId, normalizeAssessment, normalizeAttachmentRef, normalizeAttempt, normalizeBindings, normalizeCard, normalizeEvent, normalizeNodeCover, normalizePage, normalizeLibraryIndex, normalizeProject, normalizeResource, normalizeRoadmap, resolveLibraryStateRoot, } from './store.ts';
+export * from './types.ts';
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        /** The library plugin's service core. */
+        library: LibraryService;
+    }
+}
+/** Cordis plugin name used by loader diagnostics. */
+export declare const name = "library";
+/** Optional state-root override, for deployments that keep state elsewhere. */
+export interface LibraryConfig {
+    /** Directory holding `state.json`; defaults to `$DSH_HOME/state/dsh-library`. */
+    readonly stateRoot?: string;
+}
+/**
+ * Plugin body: provide the service core, then mount the Remote data face.
+ *
+ * No `static inject`: every optional capability (`attachments`) is probed at
+ * the point of use, so the row boots in any composition and degrades —
+ * `unavailable`/`storage-unavailable` refusals instead of a boot failure.
+ *
+ * @param ctx - owning Cordis context.
+ * @param config - optional plugin config.
+ */
+export declare function apply(ctx: Context, config?: LibraryConfig): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/index.js

@@ -0,0 +1,31 @@
+import { LibraryService } from "./service.js";
+import { LibraryRemoteService } from "./remote.js";
+import { libraryErrorMessage } from "./types.js";
+export { LibraryService, LibraryDisposedError, leitnerDueAt, unlockReady, validateRoadmapShape, coversVerbatimBlocker } from "./service.js";
+export { cardKey, cardKeys, cardMatchesQuery, exactMatch, keySimilarity, nearMatches, NEAR_DUPLICATE } from "./cards.js";
+export { LibraryRemoteService } from "./remote.js";
+export { acquireLibraryLock, assertLibraryId, emptyLibraryIndex, LibraryStore, LibraryStoreError, mintLibraryId, normalizeAssessment, normalizeAttachmentRef, normalizeAttempt, normalizeBindings, normalizeCard, normalizeEvent, normalizeNodeCover, normalizePage, normalizeLibraryIndex, normalizeProject, normalizeResource, normalizeRoadmap, resolveLibraryStateRoot, } from "./store.js";
+export * from "./types.js";
+/** Cordis plugin name used by loader diagnostics. */
+export const name = 'library';
+/**
+ * Plugin body: provide the service core, then mount the Remote data face.
+ *
+ * No `static inject`: every optional capability (`attachments`) is probed at
+ * the point of use, so the row boots in any composition and degrades —
+ * `unavailable`/`storage-unavailable` refusals instead of a boot failure.
+ *
+ * @param ctx - owning Cordis context.
+ * @param config - optional plugin config.
+ */
+export function apply(ctx, config = {}) {
+    const service = new LibraryService(ctx, config);
+    ctx.provide('library', service);
+    ctx.plugin(LibraryRemoteService, {});
+    // Migrate a v2 state root to v3 (roadmap nodes' chapterRanges → covers).
+    // Fire-and-forget: reads tolerate v2 until it lands, and a failed pass (a
+    // read-only root) only means the files stay v2 — never a boot failure.
+    void service.store.migrateState().catch((error) => {
+        ctx.logger.warn(`library: state migration did not run — ${libraryErrorMessage(error)}`);
+    });
+}