@khorsheed/dsh-library 0.0.0-stage → 0.1.0

package/lib/types/client/store.d.ts

@@ -0,0 +1,109 @@
+/**
+ * The library pane's transient store: where the learner is in the sidebar —
+ * a stack of routes, so 「‹」 always returns to the screen they came from —
+ * and a revision counter the views reload on. Everything durable lives in the
+ * host's `state/dsh-library/`; each view re-reads it on mount and on `rev`.
+ *
+ * @module @khorsheed/dsh-library/client/store
+ */
+import { type EngineStoreHandle } from '@deepseek-ai/dsh-client-store';
+import type { LibraryAssessResult, LibraryQuizFocus, LibraryQuizQuestion } from '../types.ts';
+/** The card list's filters. */
+export type LibraryCardFilter = 'all' | 'photo' | 'chat' | 'quiz' | 'due';
+/** The node page's tabs. */
+export type LibraryNodeTab = 'guide' | 'pages' | 'notes' | 'quiz';
+/** One screen of the sidebar. */
+export type LibraryRoute = {
+    readonly view: 'today';
+} | {
+    readonly view: 'newProject';
+} | {
+    readonly view: 'project';
+    readonly projectId: string;
+} | {
+    readonly view: 'resource';
+    readonly projectId: string;
+    readonly resourceId: string;
+} | {
+    readonly view: 'node';
+    readonly projectId: string;
+    readonly resourceId: string;
+    readonly nodeId: string;
+    readonly tab: LibraryNodeTab;
+} | {
+    readonly view: 'lesson';
+    readonly projectId: string;
+    readonly resourceId: string;
+    readonly nodeId: string;
+} | {
+    readonly view: 'cards';
+    readonly projectId: string;
+    readonly filter: LibraryCardFilter;
+} | {
+    readonly view: 'quiz';
+    readonly projectId: string;
+    readonly resourceId?: string;
+    readonly quizId: string;
+} | {
+    readonly view: 'result';
+    readonly projectId: string;
+    readonly resourceId?: string;
+    readonly result: LibraryAssessResult;
+} | {
+    readonly view: 'review';
+    readonly projectId?: string;
+};
+/** A station's 章节考 settings, as the learner left them. */
+export interface LibraryQuizSettings {
+    readonly focus: LibraryQuizFocus;
+    readonly kinds: readonly LibraryQuizQuestion['kind'][];
+    readonly countText: string;
+    /** The picked points (重点出这些) — empty means the coach picks by weakness. */
+    readonly picked: readonly string[];
+}
+/** An ask sent to the coach that has not landed yet: when, the paper count it must beat, and what was asked. */
+export interface LibraryQuizAsk {
+    readonly since: number;
+    readonly count: number;
+    readonly summary: string;
+}
+/** One station's quiz state, kept across tab switches (keyed `project:resource:node`). */
+export interface LibraryStationQuiz {
+    readonly settings?: LibraryQuizSettings;
+    readonly ask?: LibraryQuizAsk;
+}
+/** The pane's state. */
+export interface LibraryState {
+    /** The route stack; the last entry is on screen. */
+    stack: LibraryRoute[];
+    /** Bumped to make the open view re-read the host. */
+    rev: number;
+    /** Per-station quiz settings and the pending ask — they outlive the tab that shows them. */
+    quiz: Record<string, LibraryStationQuiz>;
+    /** Stations whose 讲义 the learner asked for (开始学这一站), keyed `project:resource:node` → when. */
+    preparing: Record<string, number>;
+}
+/** Annotation twin of the actions literal below. */
+export type LibraryActions = {
+    /** Open a screen on top of the current one. */
+    push: (draft: LibraryState, route: LibraryRoute) => void;
+    /** Replace the current screen (tab switches, filter changes). */
+    replace: (draft: LibraryState, route: LibraryRoute) => void;
+    /** Back one screen (never past today). */
+    pop: (draft: LibraryState) => void;
+    /** Back to today. */
+    home: (draft: LibraryState) => void;
+    refresh: (draft: LibraryState) => void;
+    /** Remember a station's 章节考 settings. */
+    setQuizSettings: (draft: LibraryState, key: string, settings: LibraryQuizSettings) => void;
+    /** Start (or clear, with undefined) a station's pending ask. */
+    setQuizAsk: (draft: LibraryState, key: string, ask: LibraryQuizAsk | undefined) => void;
+    /** Start (or clear) waiting for a station's 讲义. */
+    setPreparing: (draft: LibraryState, key: string, since: number | undefined) => void;
+};
+/**
+ * Create the library pane's store handle.
+ * @returns the store handle (spec, type, identity and factory in one).
+ */
+export declare function createLibraryStore(): EngineStoreHandle<LibraryState, LibraryActions>;
+//# sourceMappingURL=store.d.ts.map

package/lib/types/client/store.js

@@ -0,0 +1,44 @@
+/**
+ * The library pane's transient store: where the learner is in the sidebar —
+ * a stack of routes, so 「‹」 always returns to the screen they came from —
+ * and a revision counter the views reload on. Everything durable lives in the
+ * host's `state/dsh-library/`; each view re-reads it on mount and on `rev`.
+ *
+ * @module @khorsheed/dsh-library/client/store
+ */
+import { defineStore } from '@deepseek-ai/dsh-client-store';
+const TODAY = { view: 'today' };
+/**
+ * Create the library pane's store handle.
+ * @returns the store handle (spec, type, identity and factory in one).
+ */
+export function createLibraryStore() {
+    return defineStore({
+        init: () => ({ stack: [TODAY], rev: 0, quiz: {}, preparing: {} }),
+        actions: {
+            push: (d, route) => { d.stack.push(route); },
+            replace: (d, route) => { d.stack[d.stack.length - 1] = route; },
+            pop: (d) => {
+                if (d.stack.length > 1)
+                    d.stack.pop();
+                d.rev += 1;
+            },
+            home: (d) => {
+                d.stack = [TODAY];
+                d.rev += 1;
+            },
+            refresh: (d) => { d.rev += 1; },
+            setQuizSettings: (d, key, settings) => { d.quiz[key] = { ...d.quiz[key], settings }; },
+            setQuizAsk: (d, key, ask) => {
+                const { ask: _previous, ...rest } = d.quiz[key] ?? {};
+                d.quiz[key] = ask === undefined ? rest : { ...rest, ask };
+            },
+            setPreparing: (d, key, since) => {
+                if (since === undefined)
+                    delete d.preparing[key];
+                else
+                    d.preparing[key] = since;
+            },
+        },
+    });
+}

package/lib/types/client/titles.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Display forms of the titles the coach writes: a textbook's main title with
+ * its trailing parenthesis split off as a subtitle, and a station's title
+ * without the 「站 1：」 prefix (the disc carries the number) or a trailing
+ * 「（教材 A 第 1-3 章）」 (the meta line carries the rows). Stored titles are
+ * untouched.
+ *
+ * @module @khorsheed/dsh-library/client/titles
+ */
+/** 「Blender 4.5 手册（Getting Started / …）」 → main + sub; a title that is all parenthesis stays whole. */
+export declare function splitTitle(title: string): {
+    main: string;
+    sub?: string;
+};
+/** A station title as the rail and cards show it. */
+export declare function stationTitle(title: string): string;
+//# sourceMappingURL=titles.d.ts.map

package/lib/types/client/titles.js

@@ -0,0 +1,23 @@
+/**
+ * Display forms of the titles the coach writes: a textbook's main title with
+ * its trailing parenthesis split off as a subtitle, and a station's title
+ * without the 「站 1：」 prefix (the disc carries the number) or a trailing
+ * 「（教材 A 第 1-3 章）」 (the meta line carries the rows). Stored titles are
+ * untouched.
+ *
+ * @module @khorsheed/dsh-library/client/titles
+ */
+/** 「Blender 4.5 手册（Getting Started / …）」 → main + sub; a title that is all parenthesis stays whole. */
+export function splitTitle(title) {
+    const match = /^(.+?)\s*[（(]([^（）()]+)[)）]\s*$/.exec(title.trim());
+    if (match === null || match[1].trim() === '')
+        return { main: title.trim() };
+    return { main: match[1].trim(), sub: match[2].trim() };
+}
+/** A station title as the rail and cards show it. */
+export function stationTitle(title) {
+    const cleaned = title.trim()
+        .replace(/^(?:站|第)\s*\d+\s*站?\s*[:：.、\s-]\s*/, '')
+        .replace(/\s*[（(][^（）()]*(?:第\s*[\d\s,，、–—-]+\s*章|章节?\s*\d)[^（）()]*[)）]\s*$/, '');
+    return cleaned === '' ? title.trim() : cleaned;
+}

package/lib/types/client/ui.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Small shared pieces of the library sidebar: the loading hook every view
+ * reads the host through, outcome unwrapping, and the few presentational
+ * atoms (state lines, weakness bars, review boxes, the term highlighter,
+ * the origin tag, the destructive-action confirm dialog).
+ *
+ * @module @khorsheed/dsh-library/client/ui
+ */
+import { type ReactNode } from 'react';
+import type { RemoteResult } from '@deepseek-ai/dsh-typert-protocol';
+import type { LibraryOutcome, LibraryResourceOrigin } from '../types.ts';
+import type { LibraryPaneProps } from './contract.ts';
+/** What every view receives. */
+export interface ViewProps {
+    readonly p: LibraryPaneProps;
+}
+/** A load's state. */
+export interface Loaded<T> {
+    readonly data: T | undefined;
+    readonly error: string | undefined;
+    readonly loading: boolean;
+}
+/**
+ * Read the host once per `deps` change (the store's `rev` is always one of
+ * them, so every mutation re-reads). A stale answer never lands.
+ */
+export declare function useLoad<T>(load: () => Promise<T>, deps: readonly unknown[]): Loaded<T>;
+/** The value inside a Remote envelope, or a thrown Error with the wire's message. */
+export declare function value<T>(answer: Promise<RemoteResult<T>>): Promise<T>;
+/** The domain value inside an envelope + outcome, or a thrown Error with the refusal's lesson. */
+export declare function outcome<T>(answer: Promise<RemoteResult<LibraryOutcome<T>>>): Promise<T>;
+/** Loading / error / empty lines, in one place. */
+export declare function StateLine({ loaded, t }: {
+    loaded: Loaded<unknown>;
+    t: LibraryPaneProps['t'];
+}): ReactNode;
+/** Weakness as three bars (filled = how stuck). */
+export declare function WeaknessBars({ weakness, label }: {
+    weakness: number;
+    label: string;
+}): ReactNode;
+/** Review progress as five boxes. */
+export declare function BoxDots({ box, label }: {
+    box: number;
+    label: string;
+}): ReactNode;
+/** A sentence with its term marked (case-insensitive, first occurrence). */
+export declare function Highlight({ sentence, term }: {
+    sentence: string;
+    term: string;
+}): ReactNode;
+/** A relative time, coarse. */
+export declare function when(at: string, t: LibraryPaneProps['t']): string;
+/** A gloss short enough for a one-line row: up to its first dash or semicolon, then capped. */
+export declare function shortGloss(gloss: string, max?: number): string;
+/** Days from now until an ISO moment, at least 0. */
+export declare function daysUntil(at: string): number;
+/** A textbook's origin as a small colored tag (你的书 / 模型选的书 / 电子资料 / 模型自编). */
+export declare function OriginTag({ origin, digital, t }: {
+    origin: LibraryResourceOrigin | undefined;
+    digital: boolean;
+    t: LibraryPaneProps['t'];
+}): ReactNode;
+/**
+ * The destructive-action confirm, on the host's own Modal (the blurred mask,
+ * the title bar with its close button, outline buttons — what the host's
+ * archive confirm uses): what goes as a grouped list with each count set
+ * off, what stays with a check, a red-text confirm. Esc, the mask and the
+ * close button cancel (not while busy); focus starts on 取消 so a stray
+ * Enter never deletes.
+ */
+export declare function ConfirmDialog({ title, lines, keep, note, confirmLabel, cancelLabel, busy, error, onConfirm, onCancel }: {
+    title: string;
+    /** What the action removes, one consequence per line (a leading count is set off). */
+    lines: readonly string[];
+    /** What survives it. */
+    keep?: string | undefined;
+    note?: string | undefined;
+    confirmLabel: string;
+    cancelLabel: string;
+    busy: boolean;
+    error?: string | undefined;
+    onConfirm: () => void;
+    onCancel: () => void;
+}): ReactNode;
+/**
+ * A progress bar cut into one segment per station: passed ones filled, the
+ * next one started — so an empty path still reads as progress, not a rule.
+ * Over 40 stations it collapses to one continuous bar.
+ */
+export declare function Segments({ done, total, label }: {
+    done: number;
+    total: number;
+    label?: string | undefined;
+}): ReactNode;
+//# sourceMappingURL=ui.d.ts.map

package/lib/types/client/ui.js

@@ -0,0 +1,124 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Small shared pieces of the library sidebar: the loading hook every view
+ * reads the host through, outcome unwrapping, and the few presentational
+ * atoms (state lines, weakness bars, review boxes, the term highlighter,
+ * the origin tag, the destructive-action confirm dialog).
+ *
+ * @module @khorsheed/dsh-library/client/ui
+ */
+import { useEffect, useRef, useState } from 'react';
+import { Button, Modal } from '@deepseek-ai/dsh-client-ui-primitives';
+import { IconCheckOutlineMedium } from "./icons.js";
+import css from './LibraryPane.module.css';
+/**
+ * Read the host once per `deps` change (the store's `rev` is always one of
+ * them, so every mutation re-reads). A stale answer never lands.
+ */
+export function useLoad(load, deps) {
+    const [state, setState] = useState({ data: undefined, error: undefined, loading: true });
+    useEffect(() => {
+        let cancelled = false;
+        setState(previous => ({ ...previous, loading: true }));
+        load().then(data => { if (!cancelled)
+            setState({ data, error: undefined, loading: false }); }, (error) => { if (!cancelled)
+            setState({ data: undefined, error: error instanceof Error ? error.message : String(error), loading: false }); });
+        return () => { cancelled = true; };
+    }, deps);
+    return state;
+}
+/** The value inside a Remote envelope, or a thrown Error with the wire's message. */
+export async function value(answer) {
+    const result = await answer;
+    if (!result.ok)
+        throw new Error(result.error.message);
+    return result.value;
+}
+/** The domain value inside an envelope + outcome, or a thrown Error with the refusal's lesson. */
+export async function outcome(answer) {
+    const inner = await value(answer);
+    if (!inner.ok)
+        throw new Error(inner.message);
+    return inner;
+}
+/** Loading / error / empty lines, in one place. */
+export function StateLine({ loaded, t }) {
+    if (loaded.error !== undefined)
+        return _jsx("div", { className: css.error, children: t('state.error', { reason: loaded.error }) });
+    if (loaded.loading && loaded.data === undefined)
+        return _jsx("div", { className: css.muted, children: t('state.loading') });
+    return null;
+}
+/** Weakness as three bars (filled = how stuck). */
+export function WeaknessBars({ weakness, label }) {
+    return (_jsx("span", { className: css.weak, role: "img", "aria-label": label, children: [1, 2, 3].map(level => _jsx("i", { "data-on": weakness >= level ? 'true' : 'false' }, level)) }));
+}
+/** Review progress as five boxes. */
+export function BoxDots({ box, label }) {
+    return (_jsx("span", { className: css.boxes, role: "img", "aria-label": label, children: [1, 2, 3, 4, 5].map(level => _jsx("i", { "data-on": box >= level ? 'true' : 'false' }, level)) }));
+}
+/** A sentence with its term marked (case-insensitive, first occurrence). */
+export function Highlight({ sentence, term }) {
+    const at = sentence.toLowerCase().indexOf(term.toLowerCase());
+    if (at < 0 || term === '')
+        return _jsx(_Fragment, { children: sentence });
+    return _jsxs(_Fragment, { children: [sentence.slice(0, at), _jsx("mark", { className: css.mark, children: sentence.slice(at, at + term.length) }), sentence.slice(at + term.length)] });
+}
+/** A relative time, coarse. */
+export function when(at, t) {
+    const minutes = Math.floor((Date.now() - Date.parse(at)) / 60_000);
+    if (!Number.isFinite(minutes) || minutes < 1)
+        return t('when.justNow');
+    if (minutes < 60)
+        return t('when.minutes', { count: String(minutes) });
+    const hours = Math.floor(minutes / 60);
+    if (hours < 24)
+        return t('when.hours', { count: String(hours) });
+    const days = Math.floor(hours / 24);
+    return days === 1 ? t('when.yesterday') : t('when.days', { count: String(days) });
+}
+/** A gloss short enough for a one-line row: up to its first dash or semicolon, then capped. */
+export function shortGloss(gloss, max = 18) {
+    const head = gloss.split(/\s*(?:——|—|;|；)\s*/)[0] ?? gloss;
+    return head.length > max ? `${head.slice(0, max)}…` : head;
+}
+/** Days from now until an ISO moment, at least 0. */
+export function daysUntil(at) {
+    return Math.max(0, Math.ceil((Date.parse(at) - Date.now()) / 86_400_000));
+}
+/** A textbook's origin as a small colored tag (你的书 / 模型选的书 / 电子资料 / 模型自编). */
+export function OriginTag({ origin, digital, t }) {
+    const key = origin === 'authored' ? 'authored' : origin === 'learner' ? 'learner' : digital ? 'digital' : 'picked';
+    return _jsx("span", { className: css.originTag, "data-origin": key, children: t(`origin.${key}`) });
+}
+/**
+ * The destructive-action confirm, on the host's own Modal (the blurred mask,
+ * the title bar with its close button, outline buttons — what the host's
+ * archive confirm uses): what goes as a grouped list with each count set
+ * off, what stays with a check, a red-text confirm. Esc, the mask and the
+ * close button cancel (not while busy); focus starts on 取消 so a stray
+ * Enter never deletes.
+ */
+export function ConfirmDialog({ title, lines, keep, note, confirmLabel, cancelLabel, busy, error, onConfirm, onCancel }) {
+    const cancelRef = useRef(null);
+    useEffect(() => { cancelRef.current?.focus(); }, []);
+    const close = () => { if (!busy)
+        onCancel(); };
+    return (_jsx(Modal, { open: true, onClose: close, closeLabel: cancelLabel, title: title, footer: (_jsxs(_Fragment, { children: [_jsx(Button, { ref: cancelRef, variant: "outline", disabled: busy, onClick: close, children: cancelLabel }), _jsx(Button, { variant: "outline", className: css.dialogDanger, disabled: busy, onClick: onConfirm, children: confirmLabel })] })), children: _jsxs("div", { className: css.dialogBody, children: [lines.length > 0 && (_jsx("ul", { className: css.dialogList, children: lines.map(line => {
+                        const counted = /^(\d+)\s*(.*)$/.exec(line);
+                        return (_jsx("li", { className: css.dialogRow, children: counted === null ? line : _jsxs(_Fragment, { children: [_jsx("b", { className: css.dialogCount, children: counted[1] }), _jsx("span", { children: counted[2] })] }) }, line));
+                    }) })), keep !== undefined && _jsxs("div", { className: css.dialogKeep, children: [_jsx(IconCheckOutlineMedium, { size: 14 }), keep] }), note !== undefined && _jsx("div", { className: css.dialogNote, children: note }), error !== undefined && _jsx("div", { className: css.error, children: error })] }) }));
+}
+/**
+ * A progress bar cut into one segment per station: passed ones filled, the
+ * next one started — so an empty path still reads as progress, not a rule.
+ * Over 40 stations it collapses to one continuous bar.
+ */
+export function Segments({ done, total, label }) {
+    if (total <= 0)
+        return null;
+    if (total > 40) {
+        return _jsxs("span", { className: css.segs, role: "img", "aria-label": label, children: [_jsx("i", { "data-state": "done", style: { gridColumn: `span ${Math.max(1, done)}` } }), _jsx("i", { style: { gridColumn: `span ${Math.max(1, total - done)}` } })] });
+    }
+    return (_jsx("span", { className: css.segs, role: "img", "aria-label": label, children: Array.from({ length: total }, (_, index) => _jsx("i", { "data-state": index < done ? 'done' : index === done ? 'next' : undefined }, index)) }));
+}

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

@@ -0,0 +1,57 @@
+/**
+ * One textbook in the sidebar (a book, a course, a coach-authored outline):
+ * its place in the study order and origin, its roadmap draft waiting for
+ * 采用, its adopted path as an S-shaped trail of nodes, the chapters the path
+ * skips, and one node's page. Every path belongs to a textbook — the
+ * project carries none. 「我的记录」 exists only when the station covers
+ * its own textbook. Every station carries the same four tabs —
+ * 导读 / 我的记录 / 讲义 / 章节考: the gate tab is the station's quiz on a
+ * quiz / read node, and its acceptance sheet (the coach judges the rubric
+ * with library_assess) on an acceptance node.
+ *
+ * @module @khorsheed/dsh-library/client/views/book
+ */
+import { type ReactNode } from 'react';
+import { type LibraryAssessment, type LibraryResource, type LibraryRoadmap, type RoadmapNode } from '../../types.ts';
+import { type CoverContext } from '../covers.tsx';
+import { type ViewProps } from '../ui.tsx';
+/** A node's contents rows of one thick resource, as titles. */
+export declare function rowsOf(node: RoadmapNode, resource: LibraryResource): string[];
+/** The kind line of a thick resource: a book's bookKind, else its kind label. */
+export declare function kindLabelOf(resource: LibraryResource, t: ViewProps['p']['t']): string;
+/** One resource: draft card, path, or the ask for one. */
+export declare function BookView({ p, projectId, resourceId }: ViewProps & {
+    projectId: string;
+    resourceId: string;
+}): ReactNode;
+/** The draft card on a textbook's page: what the coach proposes, what it skips, and the learner's 采用 / 放弃. */
+export declare function DraftCard({ p, draft, context, tocBy, skipped, replaces, busy, onAdopt, onDiscard }: {
+    p: ViewProps['p'];
+    draft: LibraryRoadmap;
+    /** The project's shelf, for labeling covers. */
+    context: CoverContext;
+    /** The textbook's contents-source badge. */
+    tocBy?: 'web' | 'model' | 'photo' | undefined;
+    /** The contents rows no station covers. */
+    skipped: readonly {
+        n: number;
+        title: string;
+    }[];
+    replaces: boolean;
+    busy: boolean;
+    onAdopt: () => void;
+    onDiscard: () => void;
+}): ReactNode;
+/**
+ * Rows of quizzes that gate no station (the resource page's 本书测验, the project
+ * page's 自由测验, a station's same-scope list) — each opens the paper. The
+ * route's resource comes from the quiz's own scope.
+ */
+export declare function QuizRows({ p, projectId, quizzes }: {
+    p: ViewProps['p'];
+    projectId: string;
+    quizzes: readonly LibraryAssessment[];
+}): ReactNode;
+/** 「照片 3 · 领域知识 7」 for a quiz row. */
+export declare function sourceMix(kinds: readonly string[], t: ViewProps['p']['t']): string;
+//# sourceMappingURL=book.d.ts.map

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

@@ -0,0 +1,164 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * One textbook in the sidebar (a book, a course, a coach-authored outline):
+ * its place in the study order and origin, its roadmap draft waiting for
+ * 采用, its adopted path as an S-shaped trail of nodes, the chapters the path
+ * skips, and one node's page. Every path belongs to a textbook — the
+ * project carries none. 「我的记录」 exists only when the station covers
+ * its own textbook. Every station carries the same four tabs —
+ * 导读 / 我的记录 / 讲义 / 章节考: the gate tab is the station's quiz on a
+ * quiz / read node, and its acceptance sheet (the coach judges the rubric
+ * with library_assess) on an acceptance node.
+ *
+ * @module @khorsheed/dsh-library/client/views/book
+ */
+import { useState } from 'react';
+import { ListRow, PanelHeader } from '@khorsheed/dsh-client-ui-panel-kit/src/client/index.ts';
+import { coverKind, isThickResource, parseLocator, } from "../../types.js";
+import { colorOf, Cover, coverOf } from "../look.js";
+import { CoverChips } from "../covers.js";
+import { IconRefreshOutlineMedium, IconSparkleMedium, IconTrashOutlineMedium } from "../icons.js";
+import { ConfirmDialog, OriginTag, outcome, StateLine, useLoad, value, when } from "../ui.js";
+import css from '../LibraryPane.module.css';
+import { Path } from "./path.js";
+import { splitTitle } from "../titles.js";
+/** A node's contents rows of one thick resource, as titles. */
+export function rowsOf(node, resource) {
+    const toc = resource.toc ?? [];
+    return node.covers
+        .flatMap(cover => (coverKind(cover) === 'resource' && cover.ref === resource.id && cover.locator !== undefined ? parseLocator(cover.locator) : []))
+        .flatMap(range => toc.filter(row => row.n >= range.from && row.n <= range.to).map(row => row.title));
+}
+/** The kind line of a thick resource: a book's bookKind, else its kind label. */
+export function kindLabelOf(resource, t) {
+    return resource.kind === 'book' ? t(`bookKind.${resource.meta?.bookKind ?? 'knowledge'}`) : t(`resource.kind.${resource.kind}`);
+}
+/** One resource: draft card, path, or the ask for one. */
+export function BookView({ p, projectId, resourceId }) {
+    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))]);
+        return { resource: detail.resources.find(candidate => candidate.id === resourceId), resources: detail.resources, project: detail.project, shade: Math.max(0, detail.resources.filter(isThickResource).findIndex(candidate => candidate.id === resourceId)), ...roadmaps };
+    }, [projectId, resourceId, rev]);
+    // Resource-level quizzes hang on no station — this section is their entry.
+    const assessments = useLoad(() => value(p.listAssessments(projectId, resourceId)), [projectId, resourceId, rev]);
+    const [notice, setNotice] = useState();
+    const [busy, setBusy] = useState(false);
+    const [confirmingDelete, setConfirmingDelete] = useState(false);
+    const [deleteError, setDeleteError] = useState();
+    // The delete dialog names the photographed pages that go with the textbook.
+    const pages = useLoad(() => confirmingDelete ? value(p.listPages(projectId, resourceId)) : Promise.resolve(undefined), [projectId, resourceId, confirmingDelete]);
+    const resource = loaded.data?.resource;
+    const looseQuizzes = (assessments.data?.assessments ?? []).filter(quiz => quiz.type === 'quiz' && quiz.scope.nodeId === undefined).sort((a, b) => b.createdAt.localeCompare(a.createdAt));
+    const prime = (text) => {
+        void p.bindTarget({ projectId, resourceId });
+        setNotice(p.primeConversation(text) ? t('notice.primed') : t('notice.noConversation'));
+    };
+    const act = async (run) => {
+        setBusy(true);
+        try {
+            await run();
+            actions.refresh();
+        }
+        catch (failure) {
+            setNotice(failure instanceof Error ? failure.message : String(failure));
+        }
+        finally {
+            setBusy(false);
+        }
+    };
+    const remove = async () => {
+        setBusy(true);
+        setDeleteError(undefined);
+        try {
+            await outcome(p.removeResource(projectId, resourceId));
+            setConfirmingDelete(false);
+            actions.refresh();
+            actions.pop();
+        }
+        catch (failure) {
+            setDeleteError(failure instanceof Error ? failure.message : String(failure));
+            setBusy(false);
+        }
+    };
+    return (_jsxs(_Fragment, { children: [_jsx(PanelHeader, { title: resource === undefined ? '' : splitTitle(resource.title).main, onBack: () => { actions.pop(); }, backLabel: t('action.back'), actions: resource === undefined ? [] : [
+                    { id: 'ask', label: t('action.askCoach'), icon: _jsx(IconSparkleMedium, {}), onSelect: () => { prime(t('prime.readBook', { book: resource.title })); } },
+                    { id: 'replan', label: t('book.replan'), icon: _jsx(IconRefreshOutlineMedium, {}), onSelect: () => { prime(t('prime.replan', { book: resource.title })); } },
+                    { id: 'bind', label: t('action.bindBook'), icon: _jsx(IconSparkleMedium, {}), menuOnly: true, onSelect: () => { void p.bindTarget({ projectId, resourceId }).then(() => { setNotice(t('notice.bound')); }); } },
+                    // 知识型 / 材料型 is rarely changed: it lives in the menu, not on the page.
+                    ...(isThickResource(resource) ? [{ id: 'kind', label: t(resource.meta?.bookKind === 'material' ? 'book.kindToKnowledge' : 'book.kindToMaterial'), icon: _jsx(IconRefreshOutlineMedium, {}), menuOnly: true, onSelect: () => { void act(() => outcome(p.setBookKind(projectId, resourceId, resource.meta?.bookKind === 'material' ? 'knowledge' : 'material'))); } }] : []),
+                    { id: 'delete', label: t('book.delete'), icon: _jsx(IconTrashOutlineMedium, {}), menuOnly: true, onSelect: () => { setDeleteError(undefined); setConfirmingDelete(true); } },
+                ], moreLabel: t('action.more') }), _jsxs("div", { className: css.body, "data-color": loaded.data?.project === undefined ? undefined : colorOf(loaded.data.project), children: [_jsx(StateLine, { loaded: loaded, t: t }), notice !== undefined && _jsx("div", { className: css.notice, children: notice }), resource !== undefined && (_jsxs("section", { className: css.bookHero, children: [_jsx(Cover, { book: coverOf(resource), shade: loaded.data?.shade ?? 0, size: "hero" }), _jsxs("span", { className: css.bookHeroText, children: [_jsx("span", { className: css.bookHeroTitle, children: splitTitle(resource.title).main }), splitTitle(resource.title).sub !== undefined && _jsx("span", { className: css.muted, children: splitTitle(resource.title).sub }), _jsxs("span", { className: css.bookHeroMeta, children: [_jsx(OriginTag, { origin: resource.origin, digital: resource.kind === 'course', t: t }), resource.meta?.bookKind === 'material' && _jsx("span", { className: css.chip, "data-tone": "warn", children: t('bookKind.material') }), [resource.meta?.edition, resource.seq === undefined ? undefined : t('book.seqOf', { seq: String(resource.seq) })].filter(Boolean).map(part => _jsx("span", { children: part }, part))] })] })] })), resource?.meta?.extras !== undefined && resource.meta.extras.length > 0 && _jsx(Extras, { p: p, resource: resource }), resource !== undefined && loaded.data?.draft !== undefined && (_jsx(DraftCard, { p: p, draft: loaded.data.draft, context: { resources: loaded.data.resources }, tocBy: resource.tocSource?.by, skipped: skippedRows(loaded.data.draft, resource), replaces: loaded.data.roadmap !== undefined, busy: busy, onAdopt: () => { void act(() => outcome(p.adoptRoadmap(projectId, resourceId))); }, onDiscard: () => { void act(() => outcome(p.discardDraft(projectId, resourceId))); } })), resource !== undefined && loaded.data?.roadmap !== undefined && (_jsx(_Fragment, { children: _jsx(Path, { p: p, projectId: projectId, resource: resource, roadmap: loaded.data.roadmap, onOpen: node => { actions.push({ view: 'node', projectId, resourceId, nodeId: node.id, tab: 'guide' }); }, onLesson: node => { actions.push({ view: 'lesson', projectId, resourceId, nodeId: node.id }); }, onRetake: node => { actions.push({ view: 'node', projectId, resourceId, nodeId: node.id, tab: 'quiz' }); } }) })), resource !== undefined && loaded.data?.roadmap === undefined && loaded.data?.draft === undefined && (_jsxs("div", { className: css.empty, children: [_jsx("div", { className: css.emptyTitle, children: t('book.noRoadmap') }), _jsx("div", { className: css.muted, children: t('book.noRoadmapBody') }), _jsx("button", { type: "button", className: css.primary, onClick: () => { prime(t('prime.plan', { book: resource.title })); }, children: t('book.askPlan') })] })), resource !== undefined && looseQuizzes.length > 0 && (_jsxs("section", { className: css.section, children: [_jsx("h3", { className: css.sectionTitle, children: t('book.quizzes', { count: String(looseQuizzes.length) }) }), _jsx(QuizRows, { p: p, projectId: projectId, quizzes: looseQuizzes })] })), resource !== undefined && isThickResource(resource) && (_jsx(Contents, { p: p, resource: resource, skipped: loaded.data?.roadmap === undefined ? [] : skippedRows(loaded.data.roadmap, resource) }))] }), confirmingDelete && resource !== undefined && (_jsx(ConfirmDialog, { title: t('book.deleteTitle', { book: resource.title, project: loaded.data?.project.name ?? '' }), lines: [
+                    loaded.data?.roadmap !== undefined
+                        ? t('book.deletePath', { done: String(loaded.data.roadmap.nodes.filter(node => node.state === 'done').length), total: String(loaded.data.roadmap.nodes.length) })
+                        : loaded.data?.draft !== undefined ? t('book.deleteDraft') : undefined,
+                    t('book.deletePages', { count: String(pages.data?.pages.length ?? 0) }),
+                    (assessments.data?.assessments.length ?? 0) > 0 ? t('book.deleteQuizzes', { count: String(assessments.data.assessments.length) }) : undefined,
+                ].filter((line) => line !== undefined), keep: t('book.deleteKeep'), note: resource.seq !== undefined ? t('book.deleteRenumber') : undefined, confirmLabel: t('book.deleteConfirmButton'), cancelLabel: t('action.cancel'), busy: busy, error: deleteError, onConfirm: () => { void remove(); }, onCancel: () => { setConfirmingDelete(false); } }))] }));
+}
+/** The textbook's contents rows no station of `roadmap` covers — what this path skips. */
+function skippedRows(roadmap, resource) {
+    const covered = new Set();
+    let whole = false;
+    for (const node of roadmap.nodes) {
+        for (const cover of node.covers) {
+            if (coverKind(cover) !== 'resource' || cover.ref !== resource.id)
+                continue;
+            if (cover.locator === undefined) {
+                whole = true;
+                continue;
+            }
+            for (const range of parseLocator(cover.locator)) {
+                for (let n = range.from; n <= range.to; n += 1)
+                    covered.add(n);
+            }
+        }
+    }
+    if (whole || covered.size === 0)
+        return [];
+    return (resource.toc ?? []).filter(row => !covered.has(row.n)).map(row => ({ n: row.n, title: row.title }));
+}
+/** 「本路线不学」 on a draft card: the skipped chapters, folded. */
+function SkippedRows({ p, rows }) {
+    const { t } = p;
+    if (rows.length === 0)
+        return null;
+    return (_jsxs("details", { className: css.skipped, children: [_jsx("summary", { children: t('book.skipped', { count: String(rows.length) }) }), _jsx("ul", { children: rows.map(row => _jsx("li", { children: row.title }, row.n)) })] }));
+}
+/** The contents, folded into one line: how many chapters, how many this path skips; open for the rows (skipped ones dimmed) and where the contents came from. */
+function Contents({ p, resource, skipped }) {
+    const { t } = p;
+    const skippedRows = new Set(skipped.map(row => row.n));
+    const rows = resource.toc ?? [];
+    return (_jsxs("details", { className: css.contentsFold, children: [_jsxs("summary", { children: [_jsxs("span", { children: [t('book.contentsLine', { rows: String(rows.length) }), skipped.length > 0 ? ` · ${t('book.skipped', { count: String(skipped.length) })}` : ''] }), _jsx("span", { className: css.muted, children: t('book.contentsOpen') })] }), _jsx("ol", { className: css.contentsList, children: rows.map(row => _jsxs("li", { "data-skipped": skippedRows.has(row.n) ? 'true' : undefined, children: [row.part === undefined ? row.title : `${row.part} · ${row.title}`, skippedRows.has(row.n) ? ` · ${t('book.skippedTag')}` : ''] }, row.n)) }), resource.tocSource?.url !== undefined && _jsx("a", { className: css.link, href: resource.tocSource.url, target: "_blank", rel: "noreferrer", children: t('book.contentsSource') })] }));
+}
+/** The draft card on a textbook's page: what the coach proposes, what it skips, and the learner's 采用 / 放弃. */
+export function DraftCard({ p, draft, context, tocBy, skipped, replaces, busy, onAdopt, onDiscard }) {
+    const { t } = p;
+    return (_jsxs("section", { className: css.draft, children: [_jsxs("div", { className: css.draftHead, children: [_jsx("span", { className: css.draftTitle, children: t('book.draftTitle') }), tocBy !== undefined && _jsx("span", { className: css.chip, "data-tone": tocBy === 'web' ? 'web' : 'know', children: t(`tocSource.${tocBy}`) })] }), _jsxs("div", { className: css.muted, children: [t('book.draftMeta', { count: String(draft.nodes.length) }), draft.note === undefined ? '' : ` · ${draft.note}`] }), _jsx("ol", { className: css.draftNodes, children: draft.nodes.map(node => (_jsxs("li", { children: [_jsx("span", { className: css.kind, "data-kind": node.gate, children: t(`nodeKind.${node.gate}`) }), _jsxs("div", { className: css.extraText, children: [_jsx("span", { children: node.title }), node.goals.length > 0 && _jsx("span", { className: css.muted, children: node.goals[0] }), node.gate === 'quiz' && node.points !== undefined && node.points.length > 0 && (_jsx("span", { className: css.muted, children: t('book.points', { points: node.points.map(point => point.title).join(' / ') }) })), node.gate === 'acceptance' && node.acceptance !== undefined && (_jsx("span", { className: css.muted, children: t('accept.meta', { count: String(node.acceptance.length) }) })), _jsx(CoverChips, { covers: node.covers, context: context, t: t })] })] }, node.id))) }), _jsx(SkippedRows, { p: p, rows: skipped }), replaces && _jsx("div", { className: css.muted, children: t('book.draftReplaces') }), _jsxs("div", { className: css.actions, children: [_jsx("button", { type: "button", className: css.primary, disabled: busy, onClick: onAdopt, children: t('book.adopt') }), _jsx("button", { type: "button", className: css.ghost, disabled: busy, onClick: onDiscard, children: t('book.discard') })] })] }));
+}
+/** The 「开始前 / 附录」 strip: what the resource holds that is not a stop on the path. */
+function Extras({ p, resource }) {
+    const { t } = p;
+    const [open, setOpen] = useState(false);
+    const extras = resource.meta?.extras ?? [];
+    const before = extras.filter(extra => extra.when === 'before');
+    return (_jsxs("section", { className: css.extras, children: [_jsxs("button", { type: "button", className: css.extrasHead, "aria-expanded": open, onClick: () => { setOpen(!open); }, children: [_jsx("span", { children: before.length > 0 ? t('book.extrasBefore', { first: before[0].title }) : t('book.extrasTitle') }), _jsxs("span", { className: css.muted, children: [t('book.extrasCount', { count: String(extras.length) }), open ? ' ▴' : ' ▾'] })] }), open && (_jsx("ul", { className: css.extrasList, children: extras.map(extra => (_jsxs("li", { children: [_jsx("span", { className: css.kind, "data-kind": extra.when === 'before' ? 'quiz' : 'read', children: t(extra.when === 'before' ? 'book.extraBefore' : 'book.extraReference') }), _jsxs("span", { className: css.extraText, children: [_jsx("b", { children: extra.title }), (extra.note !== undefined || extra.where !== undefined) && _jsx("span", { className: css.muted, children: [extra.where, extra.note].filter(Boolean).join(' · ') })] })] }, extra.title))) }))] }));
+}
+/**
+ * Rows of quizzes that gate no station (the resource page's 本书测验, the project
+ * page's 自由测验, a station's same-scope list) — each opens the paper. The
+ * route's resource comes from the quiz's own scope.
+ */
+export function QuizRows({ p, projectId, quizzes }) {
+    const { t, actions } = p;
+    return (_jsx(_Fragment, { children: quizzes.map(quiz => (_jsx(ListRow, { title: t('node.quizRow', { count: String(quiz.questions?.length ?? 0) }), meta: [t(`focus.${quiz.focus ?? 'mixed'}`), sourceMix((quiz.questions ?? []).map(question => question.evidence.kind), t), when(quiz.createdAt, t)].join(' · '), trailing: _jsx("span", { className: css.linkText, children: t('quiz.start') }), onSelect: () => { actions.push({ view: 'quiz', projectId, ...(quiz.scope.resourceId === undefined ? {} : { resourceId: quiz.scope.resourceId }), quizId: quiz.id }); } }, quiz.id))) }));
+}
+/** 「照片 3 · 领域知识 7」 for a quiz row. */
+export function sourceMix(kinds, t) {
+    const counts = new Map();
+    for (const kind of kinds)
+        counts.set(kind, (counts.get(kind) ?? 0) + 1);
+    return [...counts].map(([kind, count]) => `${t(kind === 'photo' ? 'evidence.photo' : kind === 'web' ? 'evidence.web' : 'evidence.knowledge')} ${count}`).join(' · ');
+}