@khorsheed/dsh-library 0.0.0-stage → 0.1.1

package/lib/types/client/covers.js

@@ -0,0 +1,66 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { coverKind, coverTopic, isThickResource } from "../types.js";
+import css from './LibraryPane.module.css';
+/** A cover's one-line label. */
+export function coverLabel(cover, context, t) {
+    switch (coverKind(cover)) {
+        case 'resource': {
+            const resource = context.resources.find(candidate => candidate.id === cover.ref);
+            if (resource === undefined)
+                return cover.locator === undefined ? cover.ref : `${cover.ref} ${t('cover.chapters', { ranges: cover.locator })}`;
+            const title = isThickResource(resource) ? `《${resource.title}》` : resource.title;
+            return cover.locator === undefined ? title : `${title} ${t('cover.chapters', { ranges: cover.locator })}`;
+        }
+        case 'url':
+            return cover.title ?? cover.ref.replace(/^https?:\/\//, '').split('/')[0] ?? cover.ref;
+        case 'topic':
+            return `${t('cover.topic')}: ${coverTopic(cover) ?? ''}`;
+    }
+}
+/** The kind tag on a cover chip: book / link / teaching. */
+function coverKindLabel(cover, context, t) {
+    const kind = coverKind(cover);
+    if (kind === 'resource') {
+        const resource = context.resources.find(candidate => candidate.id === cover.ref);
+        return resource !== undefined && isThickResource(resource) ? t('cover.book') : t('cover.link');
+    }
+    return kind === 'topic' ? t('cover.topic') : t('cover.link');
+}
+/** A cover's provenance badge (absent on a shelf resource — its tocSource already records it). */
+export function ProvenanceBadge({ cover, t }) {
+    if (cover.by === undefined)
+        return null;
+    return _jsx("span", { className: css.prov, "data-by": cover.by, children: t(`prov.${cover.by}`) });
+}
+/** One station's covers as a chip row: label + provenance badge each. */
+export function CoverChips({ covers, context, t }) {
+    if (covers.length === 0)
+        return null;
+    return (_jsx("div", { className: css.chips, children: covers.map((cover, index) => (_jsxs("span", { className: css.chip, "data-tone": coverKind(cover) === 'resource' ? 'photo' : coverKind(cover) === 'topic' ? undefined : 'web', children: [coverKindLabel(cover, context, t), " \u00B7 ", coverLabel(cover, context, t), _jsx(ProvenanceBadge, { cover: cover, t: t })] }, `${coverKind(cover)}-${index}`))) }));
+}
+/** One line for a path row: 「《书》 第 3-5 章 · 链接 ×2 · 讲授 ×1」. */
+export function summarizeCovers(covers, context, t) {
+    const thick = [];
+    let links = 0;
+    let topics = 0;
+    for (const cover of covers) {
+        const kind = coverKind(cover);
+        if (kind === 'resource') {
+            const resource = context.resources.find(candidate => candidate.id === cover.ref);
+            if (resource !== undefined && isThickResource(resource))
+                thick.push(coverLabel(cover, context, t));
+            else
+                links += 1;
+        }
+        else if (kind === 'url')
+            links += 1;
+        else
+            topics += 1;
+    }
+    const parts = [...thick];
+    if (links > 0)
+        parts.push(`${t('cover.link')} ×${links}`);
+    if (topics > 0)
+        parts.push(`${t('cover.topic')} ×${topics}`);
+    return parts.join(' · ');
+}

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

@@ -0,0 +1,27 @@
+/**
+ * Stage one of the library's right-Sidebar registration: the tab type, the
+ * body of which is registered in `client/index.ts`.
+ *
+ * The kind is MINTED (`library`) rather than taken over: this is a page type
+ * of its own, not a superset of an official one, so it claims no address and
+ * ships no `patterns` / `canOpen`. It joins the guide page as its own card,
+ * which is how a learner finds it before pinning the tab.
+ *
+ * @module @khorsheed/dsh-library/client/definition
+ */
+import type { SidebarRightTabDefinition } from '@deepseek-ai/dsh-client-ui-sidebar-right/client';
+import type { TranslateNS } from '@deepseek-ai/dsh-client-locale/client';
+/** The tab kind: minted, since no official kind means "library". */
+export declare const LIBRARY_KIND = "library";
+/** This implementation's identity, and the key its body registers under. */
+export declare const LIBRARY_TAB_ID = "@khorsheed/dsh-library";
+/**
+ * The library type's registry definition. No `priority` (the default
+ * `extension` band is right for a type from outside the product) and no
+ * `patterns`/`canOpen` (a page type recognises no address).
+ *
+ * @param t - the library namespace's translator.
+ * @returns the definition to register.
+ */
+export declare function libraryDefinition(t: TranslateNS<'library'>): SidebarRightTabDefinition;
+//# sourceMappingURL=definition.d.ts.map

package/lib/types/client/definition.js

@@ -0,0 +1,32 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { IconBookOutlineMedium } from "./icons-local.js";
+/** The tab kind: minted, since no official kind means "library". */
+export const LIBRARY_KIND = 'library';
+/** This implementation's identity, and the key its body registers under. */
+export const LIBRARY_TAB_ID = '@khorsheed/dsh-library';
+/** The type's glyph on the guide card. */
+function LibraryGlyph({ size, className }) {
+    return _jsx(IconBookOutlineMedium, { size: size, className: className });
+}
+/**
+ * The library type's registry definition. No `priority` (the default
+ * `extension` band is right for a type from outside the product) and no
+ * `patterns`/`canOpen` (a page type recognises no address).
+ *
+ * @param t - the library namespace's translator.
+ * @returns the definition to register.
+ */
+export function libraryDefinition(t) {
+    return {
+        id: LIBRARY_TAB_ID,
+        kind: LIBRARY_KIND,
+        title: () => t('tab.label'),
+        guide: [{
+                id: LIBRARY_KIND,
+                order: 62,
+                title: () => t('tab.label'),
+                description: () => t('guide.description'),
+                icon: LibraryGlyph,
+            }],
+    };
+}

package/lib/types/client/icons-local.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Package-owned icons matching the official outline-icon conventions (16×16
+ * viewBox, `stroke="currentColor"` geometry) for glyphs ui-primitives does not
+ * ship — the supplement pattern message-tools and canvas established. Glyphs
+ * upstream does ship come from the generated icons.tsx
+ * (scripts/sync-icon-artwork.mts), which never touches this file.
+ *
+ * @module @khorsheed/dsh-library/client
+ */
+/** Shared props for every product icon component (mirrors the upstream IconProps). */
+export interface IconProps {
+    /** Square edge in px; defaults to the glyph's own drawn size. */
+    size?: number | undefined;
+    /** Extra class for layout placement; color rides currentColor. */
+    className?: string | undefined;
+}
+/** A book — the library's own glyph. */
+export declare const IconBookOutlineMedium: ({ size, className }: IconProps) => import("react").JSX.Element;
+/** A padlock — a locked roadmap node. */
+export declare const IconLockOutlineMedium: ({ size, className }: IconProps) => import("react").JSX.Element;
+/** A camera — photo provenance on a vocab entry. */
+export declare const IconCameraOutlineMedium: ({ size, className }: IconProps) => import("react").JSX.Element;
+/** Spark cards — the vocab book. */
+export declare const IconCardsOutlineMedium: ({ size, className }: IconProps) => import("react").JSX.Element;
+/** A pencil — editing a project. */
+export declare const IconPenOutlineMedium: ({ size, className }: IconProps) => import("react").JSX.Element;
+/** A page with lines — an article resource. */
+export declare const IconArticleOutlineMedium: ({ size, className }: IconProps) => import("react").JSX.Element;
+/** A box — a repo resource. */
+export declare const IconRepoOutlineMedium: ({ size, className }: IconProps) => import("react").JSX.Element;
+/** A gear — a tool resource. */
+export declare const IconToolOutlineMedium: ({ size, className }: IconProps) => import("react").JSX.Element;
+/** A graduation cap — a course resource. */
+export declare const IconCourseOutlineMedium: ({ size, className }: IconProps) => import("react").JSX.Element;
+/** A chip — a hardware resource. */
+export declare const IconHardwareOutlineMedium: ({ size, className }: IconProps) => import("react").JSX.Element;
+/** A speech bubble — ask the coach about a question. */
+export declare const IconChatOutlineMedium: ({ size, className }: IconProps) => import("react").JSX.Element;
+/** A flag — report a broken question. */
+export declare const IconFlagOutlineMedium: ({ size, className }: IconProps) => import("react").JSX.Element;
+//# sourceMappingURL=icons-local.d.ts.map

package/lib/types/client/icons-local.js

@@ -0,0 +1,25 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/** A book — the library's own glyph. */
+export const IconBookOutlineMedium = ({ size = 14, className }) => (_jsx("svg", { width: size, height: size, className: className, viewBox: "0 0 16 16", fill: "none", xmlns: "http://www.w3.org/2000/svg", "aria-hidden": "true", strokeWidth: 1.3, children: _jsx("path", { d: "M2.5 12.5V3.2C2.5 2.5 3.1 2 3.8 2H13.5V11.5H4C3.2 11.5 2.5 12.2 2.5 13C2.5 13.8 3.2 14.5 4 14.5H13.5", stroke: "currentColor", strokeLinecap: "round", strokeLinejoin: "round", transform: "translate(0,-0.5)" }) }));
+/** A padlock — a locked roadmap node. */
+export const IconLockOutlineMedium = ({ size = 16, className }) => (_jsxs("svg", { width: size, height: size, className: className, viewBox: "0 0 16 16", fill: "none", xmlns: "http://www.w3.org/2000/svg", "aria-hidden": "true", strokeWidth: 1.3, children: [_jsx("rect", { x: "3.2", y: "7", width: "9.6", height: "6.6", rx: "1.4", stroke: "currentColor" }), _jsx("path", { d: "M5.2 7V5.2C5.2 3.6 6.4 2.4 8 2.4C9.6 2.4 10.8 3.6 10.8 5.2V7", stroke: "currentColor" })] }));
+/** A camera — photo provenance on a vocab entry. */
+export const IconCameraOutlineMedium = ({ size = 16, className }) => (_jsxs("svg", { width: size, height: size, className: className, viewBox: "0 0 16 16", fill: "none", xmlns: "http://www.w3.org/2000/svg", "aria-hidden": "true", strokeWidth: 1.3, children: [_jsx("path", { d: "M2 5.2C2 4.65 2.45 4.2 3 4.2H4.8L5.7 2.6H10.3L11.2 4.2H13C13.55 4.2 14 4.65 14 5.2V12C14 12.55 13.55 13 13 13H3C2.45 13 2 12.55 2 12V5.2Z", stroke: "currentColor", strokeLinejoin: "round" }), _jsx("circle", { cx: "8", cy: "8.6", r: "2.5", stroke: "currentColor" })] }));
+/** Spark cards — the vocab book. */
+export const IconCardsOutlineMedium = ({ size = 16, className }) => (_jsxs("svg", { width: size, height: size, className: className, viewBox: "0 0 16 16", fill: "none", xmlns: "http://www.w3.org/2000/svg", "aria-hidden": "true", strokeWidth: 1.3, children: [_jsx("rect", { x: "4.4", y: "4.4", width: "9.2", height: "9.2", rx: "1.4", stroke: "currentColor" }), _jsx("path", { d: "M11.6 4.4V3.6C11.6 2.85 11.05 2.3 10.3 2.3H3.6C2.85 2.3 2.3 2.85 2.3 3.6V10.3C2.3 11.05 2.85 11.6 3.6 11.6H4.4", stroke: "currentColor" })] }));
+/** A pencil — editing a project. */
+export const IconPenOutlineMedium = ({ size = 16, className }) => (_jsx("svg", { width: size, height: size, className: className, viewBox: "0 0 16 16", fill: "none", xmlns: "http://www.w3.org/2000/svg", "aria-hidden": "true", strokeWidth: 1.3, children: _jsx("path", { d: "M2.5 13.5 3.2 10.6 10.8 3a1.4 1.4 0 0 1 2 0l.2.2a1.4 1.4 0 0 1 0 2L5.4 12.8 2.5 13.5ZM9.6 4.2l2.2 2.2", stroke: "currentColor", strokeLinecap: "round", strokeLinejoin: "round" }) }));
+/** A page with lines — an article resource. */
+export const IconArticleOutlineMedium = ({ size = 16, className }) => (_jsxs("svg", { width: size, height: size, className: className, viewBox: "0 0 16 16", fill: "none", xmlns: "http://www.w3.org/2000/svg", "aria-hidden": "true", strokeWidth: 1.3, children: [_jsx("path", { d: "M4 1.8H9.6L12.5 4.7V14.2H4V1.8Z", stroke: "currentColor", strokeLinejoin: "round" }), _jsx("path", { d: "M9.4 2V4.9H12.4", stroke: "currentColor", strokeLinejoin: "round" }), _jsx("path", { d: "M6 8H10.5M6 10.6H10.5", stroke: "currentColor", strokeLinecap: "round" })] }));
+/** A box — a repo resource. */
+export const IconRepoOutlineMedium = ({ size = 16, className }) => (_jsxs("svg", { width: size, height: size, className: className, viewBox: "0 0 16 16", fill: "none", xmlns: "http://www.w3.org/2000/svg", "aria-hidden": "true", strokeWidth: 1.3, children: [_jsx("path", { d: "M2.3 5.2 8 2.3 13.7 5.2V10.8L8 13.7 2.3 10.8V5.2Z", stroke: "currentColor", strokeLinejoin: "round" }), _jsx("path", { d: "M2.3 5.2 8 8.1 13.7 5.2M8 8.1V13.7", stroke: "currentColor", strokeLinejoin: "round" })] }));
+/** A gear — a tool resource. */
+export const IconToolOutlineMedium = ({ size = 16, className }) => (_jsxs("svg", { width: size, height: size, className: className, viewBox: "0 0 16 16", fill: "none", xmlns: "http://www.w3.org/2000/svg", "aria-hidden": "true", strokeWidth: 1.3, children: [_jsx("circle", { cx: "8", cy: "8", r: "2.3", stroke: "currentColor" }), _jsx("path", { d: "M8 2.3V4.3M8 11.7V13.7M2.3 8H4.3M11.7 8H13.7M3.9 3.9 5.3 5.3M10.7 10.7 12.1 12.1M12.1 3.9 10.7 5.3M5.3 10.7 3.9 12.1", stroke: "currentColor", strokeLinecap: "round" })] }));
+/** A graduation cap — a course resource. */
+export const IconCourseOutlineMedium = ({ size = 16, className }) => (_jsxs("svg", { width: size, height: size, className: className, viewBox: "0 0 16 16", fill: "none", xmlns: "http://www.w3.org/2000/svg", "aria-hidden": "true", strokeWidth: 1.3, children: [_jsx("path", { d: "M8 3.2 14.8 6.2 8 9.2 1.2 6.2 8 3.2Z", stroke: "currentColor", strokeLinejoin: "round" }), _jsx("path", { d: "M4.4 7.6V10.7C4.4 11.8 6 12.7 8 12.7 10 12.7 11.6 11.8 11.6 10.7V7.6", stroke: "currentColor", strokeLinecap: "round", strokeLinejoin: "round" }), _jsx("path", { d: "M14.8 6.2V9.8", stroke: "currentColor", strokeLinecap: "round" })] }));
+/** A chip — a hardware resource. */
+export const IconHardwareOutlineMedium = ({ size = 16, className }) => (_jsxs("svg", { width: size, height: size, className: className, viewBox: "0 0 16 16", fill: "none", xmlns: "http://www.w3.org/2000/svg", "aria-hidden": "true", strokeWidth: 1.3, children: [_jsx("rect", { x: "4.4", y: "4.4", width: "7.2", height: "7.2", rx: "1.2", stroke: "currentColor" }), _jsx("path", { d: "M6.4 2V4.4M9.6 2V4.4M6.4 11.6V14M9.6 11.6V14M2 6.4H4.4M2 9.6H4.4M11.6 6.4H14M11.6 9.6H14", stroke: "currentColor", strokeLinecap: "round" })] }));
+/** A speech bubble — ask the coach about a question. */
+export const IconChatOutlineMedium = ({ size = 16, className }) => (_jsx("svg", { width: size, height: size, className: className, viewBox: "0 0 16 16", fill: "none", xmlns: "http://www.w3.org/2000/svg", "aria-hidden": "true", strokeWidth: 1.3, children: _jsx("path", { d: "M3 3.5C3 2.9 3.4 2.5 4 2.5H12C12.6 2.5 13 2.9 13 3.5V9.5C13 10.1 12.6 10.5 12 10.5H7L4.5 13V10.5H4C3.4 10.5 3 10.1 3 9.5V3.5Z", stroke: "currentColor", strokeLinejoin: "round" }) }));
+/** A flag — report a broken question. */
+export const IconFlagOutlineMedium = ({ size = 16, className }) => (_jsx("svg", { width: size, height: size, className: className, viewBox: "0 0 16 16", fill: "none", xmlns: "http://www.w3.org/2000/svg", "aria-hidden": "true", strokeWidth: 1.3, children: _jsx("path", { d: "M4 14V2.5M4 3H12L10.5 6L12 9H4", stroke: "currentColor", strokeLinecap: "round", strokeLinejoin: "round" }) }));

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

@@ -0,0 +1,27 @@
+/**
+ * Generated by scripts/sync-icon-artwork.mts from @deepseek-ai/dsh-client-ui-primitives
+ * (v0.2.1-rc.1, harness 1600d8a1e1) — do not edit by hand. The 0.1.5 and rc.1 host lines
+ * share no icon export name, so the rc.1 artwork is inlined here: pure SVG,
+ * no host runtime identity, identical on every line. Re-run the generator
+ * after adding an icon import or bumping the harness checkout.
+ *
+ * @module @khorsheed/dsh-library/client
+ */
+/** Shared props for every product icon component (mirrors the upstream IconProps). */
+export interface IconProps {
+    /** Square edge in px; defaults to the glyph's own drawn size. */
+    size?: number | undefined;
+    /** Extra class for layout placement; color rides currentColor. */
+    className?: string | undefined;
+}
+export declare const IconCheckOutlineMedium: ({ size, className }: IconProps) => import("react").JSX.Element;
+export declare const IconChevronDownOutlineMedium: ({ size, className }: IconProps) => import("react").JSX.Element;
+export declare const IconInfoOutlineMedium: ({ size, className }: IconProps) => import("react").JSX.Element;
+export declare const IconLinkOutlineMedium: ({ size, className }: IconProps) => import("react").JSX.Element;
+export declare const IconPlayOutlineMedium: ({ size, className }: IconProps) => import("react").JSX.Element;
+export declare const IconPlusOutlineMedium: ({ size, className }: IconProps) => import("react").JSX.Element;
+export declare const IconRefreshOutlineMedium: ({ size, className }: IconProps) => import("react").JSX.Element;
+export declare const IconSearchOutlineMedium: ({ size, className }: IconProps) => import("react").JSX.Element;
+export declare const IconSparkleMedium: ({ size, className }: IconProps) => import("react").JSX.Element;
+export declare const IconTrashOutlineMedium: ({ size, className }: IconProps) => import("react").JSX.Element;
+//# sourceMappingURL=icons.d.ts.map

package/lib/types/client/icons.js

@@ -0,0 +1,11 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+export const IconCheckOutlineMedium = ({ size = 16, className }) => (_jsx("svg", { width: size, height: size, className: className, viewBox: "0 0 16 16", fill: "none", xmlns: "http://www.w3.org/2000/svg", "aria-hidden": "true", strokeWidth: 1.3, children: _jsx("path", { d: "M2.25 8.5L5.49732 11.7473C5.90519 12.1552 6.57263 12.1344 6.95426 11.7018L13.75 4", stroke: "currentColor" }) }));
+export const IconChevronDownOutlineMedium = ({ size = 14, className }) => (_jsx("svg", { width: size, height: size, className: className, viewBox: "0 0 16 16", fill: "none", xmlns: "http://www.w3.org/2000/svg", "aria-hidden": "true", strokeWidth: 1.3, children: _jsx("path", { d: "M4 6L7.29289 9.29289C7.68342 9.68342 8.31658 9.68342 8.70711 9.29289L12 6", stroke: "currentColor" }) }));
+export const IconInfoOutlineMedium = ({ size = 14, className }) => (_jsxs("svg", { width: size, height: size, className: className, viewBox: "0 0 14 14", fill: "none", xmlns: "http://www.w3.org/2000/svg", "aria-hidden": "true", strokeWidth: 1.3, children: [_jsx("path", { d: "M12.5757 7.00012C12.5757 3.92085 10.0794 1.42463 7.00012 1.42456C3.9208 1.42456 1.42456 3.9208 1.42456 7.00012C1.42463 10.0794 3.92085 12.5757 7.00012 12.5757C10.0793 12.5756 12.5756 10.0793 12.5757 7.00012ZM13.8002 7.00012C13.8001 10.7559 10.7559 13.8001 7.00012 13.8002C3.2443 13.8002 0.199291 10.7559 0.199219 7.00012C0.199219 3.24426 3.24426 0.199219 7.00012 0.199219C10.7559 0.199291 13.8002 3.2443 13.8002 7.00012Z", fill: "currentColor" }), _jsx("path", { d: "M7.6127 3.18921V4.55986H6.38735V3.18921H7.6127Z", fill: "currentColor" }), _jsx("path", { d: "M7.6127 5.68921V10.8109H6.38735V5.68921H7.6127Z", fill: "currentColor" })] }));
+export const IconLinkOutlineMedium = ({ size = 16, className }) => (_jsxs("svg", { width: size, height: size, className: className, viewBox: "0 0 16 16", fill: "none", xmlns: "http://www.w3.org/2000/svg", "aria-hidden": "true", strokeWidth: 1.3, children: [_jsx("path", { d: "M6.59961 9.40051C6.82779 9.6334 7.10015 9.81842 7.40074 9.94472C7.70132 10.071 8.02409 10.1361 8.35013 10.1361C8.67618 10.1361 8.99894 10.071 9.29953 9.94472C9.60011 9.81842 9.87247 9.6334 10.1007 9.40051L12.9015 6.59967C13.3658 6.13541 13.6266 5.50572 13.6266 4.84915C13.6266 4.19258 13.3658 3.56289 12.9015 3.09863C12.4372 2.63436 11.8075 2.37354 11.151 2.37354C10.4944 2.37354 9.86472 2.63436 9.40045 3.09863L9.05034 3.44873", stroke: "currentColor" }), _jsx("path", { d: "M9.40051 6.59959C9.17233 6.3667 8.89997 6.18169 8.59939 6.05538C8.2988 5.92907 7.97603 5.86401 7.64999 5.86401C7.32395 5.86401 7.00118 5.92907 6.70059 6.05538C6.40001 6.18169 6.12765 6.3667 5.89946 6.59959L3.09863 9.40043C2.63436 9.8647 2.37354 10.4944 2.37354 11.151C2.37354 11.8075 2.63436 12.4372 3.09863 12.9015C3.56289 13.3657 4.19258 13.6266 4.84915 13.6266C5.50572 13.6266 6.13541 13.3657 6.59967 12.9015L6.94978 12.5514", stroke: "currentColor" })] }));
+export const IconPlayOutlineMedium = ({ size = 16, className }) => (_jsxs("svg", { width: size, height: size, className: className, viewBox: "0 0 16 16", fill: "none", xmlns: "http://www.w3.org/2000/svg", "aria-hidden": "true", strokeWidth: 1.3, children: [_jsx("path", { d: "M8 14.5C11.5899 14.5 14.5 11.5899 14.5 8C14.5 4.41015 11.5899 1.5 8 1.5C4.41015 1.5 1.5 4.41015 1.5 8C1.5 11.5899 4.41015 14.5 8 14.5Z", stroke: "currentColor" }), _jsx("path", { d: "M10.3329 7.91346C10.3996 7.95195 10.3996 8.04818 10.3329 8.08667L6.78304 10.1362C6.71638 10.1747 6.63304 10.1266 6.63304 10.0496L6.63304 5.95055C6.63304 5.87357 6.71638 5.82546 6.78304 5.86395L10.3329 7.91346Z", stroke: "currentColor" })] }));
+export const IconPlusOutlineMedium = ({ size = 16, className }) => (_jsxs("svg", { width: size, height: size, className: className, viewBox: "0 0 16 16", fill: "none", xmlns: "http://www.w3.org/2000/svg", "aria-hidden": "true", strokeWidth: 1.3, children: [_jsx("path", { d: "M8 2V14", stroke: "currentColor" }), _jsx("path", { d: "M2 8H14", stroke: "currentColor" })] }));
+export const IconRefreshOutlineMedium = ({ size = 16, className }) => (_jsxs("svg", { width: size, height: size, className: className, viewBox: "0 0 16 16", fill: "none", xmlns: "http://www.w3.org/2000/svg", "aria-hidden": "true", strokeWidth: 1.3, children: [_jsx("path", { d: "M14.5001 8C14.5 9.28552 14.1188 10.5422 13.4045 11.611C12.6903 12.6799 11.6752 13.5129 10.4875 14.0049C9.29982 14.4968 7.99295 14.6255 6.73212 14.3747C5.4713 14.124 4.31314 13.505 3.4041 12.596C2.49514 11.687 1.87614 10.5288 1.62537 9.26798C1.37459 8.00716 1.50331 6.70028 1.99525 5.51261C2.48719 4.32494 3.32025 3.30981 4.3891 2.59557C5.45795 1.88134 6.71458 1.50008 8.0001 1.5C9.9001 1.5 11.7001 2.3 13.0001 3.6L14.5001 5.1", stroke: "currentColor" }), _jsx("path", { d: "M14.4999 1.5V5.1H10.8999", stroke: "currentColor" })] }));
+export const IconSearchOutlineMedium = ({ size = 16, className }) => (_jsxs("svg", { width: size, height: size, className: className, viewBox: "0 0 16 16", fill: "none", xmlns: "http://www.w3.org/2000/svg", "aria-hidden": "true", strokeWidth: 1.3, children: [_jsx("path", { d: "M6.58727 11.8586C9.55061 11.8586 11.9529 9.45637 11.9529 6.49304C11.9529 3.5297 9.55061 1.12744 6.58727 1.12744C3.62394 1.12744 1.22168 3.5297 1.22168 6.49304C1.22168 9.45637 3.62394 11.8586 6.58727 11.8586Z", stroke: "currentColor" }), _jsx("path", { d: "M10.2991 10.3933L14.7783 14.8725", stroke: "currentColor" })] }));
+export const IconSparkleMedium = ({ size = 16, className }) => (_jsxs("svg", { width: size, height: size, className: className, viewBox: "0 0 16 16", fill: "none", xmlns: "http://www.w3.org/2000/svg", "aria-hidden": "true", strokeWidth: 1.3, children: [_jsx("path", { d: "M5.875 3C5.875 6.33333 7.54167 8 10.875 8C7.54167 8 5.875 9.66667 5.875 13C5.875 9.66667 4.20833 8 0.875 8C4.20833 8 5.875 6.33333 5.875 3Z", stroke: "currentColor" }), _jsx("path", { d: "M12.375 1.55823C12.375 3.39156 13.2917 4.30823 15.125 4.30823C13.2917 4.30823 12.375 5.22489 12.375 7.05823C12.375 5.22489 11.4583 4.30823 9.625 4.30823C11.4583 4.30823 12.375 3.39156 12.375 1.55823Z", stroke: "currentColor" }), _jsx("path", { d: "M12.375 10.4418C12.375 11.7751 13.0417 12.4418 14.375 12.4418C13.0417 12.4418 12.375 13.1084 12.375 14.4418C12.375 13.1084 11.7083 12.4418 10.375 12.4418C11.7083 12.4418 12.375 11.7751 12.375 10.4418Z", stroke: "currentColor" })] }));
+export const IconTrashOutlineMedium = ({ size = 16, className }) => (_jsxs("svg", { width: size, height: size, className: className, viewBox: "0 0 16 16", fill: "none", xmlns: "http://www.w3.org/2000/svg", "aria-hidden": "true", strokeWidth: 1.3, children: [_jsx("path", { d: "M1.28149 3.88831H14.7187", stroke: "currentColor" }), _jsx("path", { d: "M5.41602 3.88833V2.47962C5.41602 2.29282 5.52492 2.11366 5.71876 1.98157C5.9126 1.84948 6.17551 1.77527 6.44964 1.77527H9.55053C9.82466 1.77527 10.0876 1.84948 10.2814 1.98157C10.4753 2.11366 10.5842 2.29282 10.5842 2.47962V3.88833", stroke: "currentColor" }), _jsx("path", { d: "M2.57349 3.88831L3.19366 13.2943C3.21937 13.5502 3.33952 13.7872 3.53065 13.9593C3.72178 14.1313 3.97016 14.2259 4.22729 14.2246H11.7728C12.0299 14.2259 12.2783 14.1313 12.4694 13.9593C12.6605 13.7872 12.7807 13.5502 12.8064 13.2943L13.4266 3.88831", stroke: "currentColor" }), _jsx("path", { d: "M6.44946 6.98926V11.1238", stroke: "currentColor" }), _jsx("path", { d: "M9.55054 6.98926V11.1238", stroke: "currentColor" })] }));

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

@@ -0,0 +1,35 @@
+/**
+ * The library's browser half: mount the Remote, register the dictionaries and
+ * the right-Sidebar tab, and hand the pane the gestures it cannot perform for
+ * itself (priming the conversation, binding the session).
+ *
+ * Failure policy is the repo's "degrade, don't explode": genuinely required
+ * wiring (`slots`, `remote`, `locale`, `sidebarRightTabs`, `sessions`) is
+ * declared in `inject` and logged when it fails, while every optional surface
+ * is probed per gesture — a session without a conversation input makes the
+ * re-split gesture answer false instead of throwing.
+ *
+ * @module @khorsheed/dsh-library/client
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import { LibraryPane } from './LibraryPane.tsx';
+export { LibraryPane };
+export { LIBRARY_KIND, LIBRARY_TAB_ID } from './definition.tsx';
+/**
+ * Required services: the pane seat, the wire channel, the locale, the tab-type
+ * registry, and sessions (the re-split's conversation draft lives behind a
+ * session scope, and the tab type's preset-visibility criterion reads the
+ * current session). `remote.library` is deliberately NOT an inject: this
+ * plugin both mounts the namespace and consumes it — the canvas pattern (a
+ * declared inject would deadlock the loader).
+ */
+export declare const inject: string[];
+/**
+ * Client plugin body: mount the Remote, register the dictionaries, then the
+ * tab type (gated by the preset-visibility criterion) and its body.
+ *
+ * @param ctx - client root context.
+ * @returns the teardown for everything this body registered.
+ */
+export declare function apply(ctx: Context): Promise<() => Promise<void>>;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/client/index.js

@@ -0,0 +1,231 @@
+import libraryRemote from '@khorsheed/dsh-library/remote';
+import { LIBRARY_KIND, LIBRARY_TAB_ID, libraryDefinition } from "./definition.js";
+import { LibraryPane } from "./LibraryPane.js";
+import { LibraryBindChip } from "./bind/BindChip.js";
+import { createLibraryStore } from "./store.js";
+import { RevealedProject } from "./reveal.js";
+import { en, NS, zh } from "./locales.js";
+import { LibraryTabVisibility, RegistrationToggle, } from "./preset-visibility.js";
+export { LibraryPane };
+export { LIBRARY_KIND, LIBRARY_TAB_ID } from "./definition.js";
+/**
+ * Required services: the pane seat, the wire channel, the locale, the tab-type
+ * registry, and sessions (the re-split's conversation draft lives behind a
+ * session scope, and the tab type's preset-visibility criterion reads the
+ * current session). `remote.library` is deliberately NOT an inject: this
+ * plugin both mounts the namespace and consumes it — the canvas pattern (a
+ * declared inject would deadlock the loader).
+ */
+export const inject = ['slots', 'remote', 'locale', 'sidebarRightTabs', 'sessions'];
+function mainSessionId(list) {
+    const view = list;
+    return Object.values(view.byId).find(s => (s.retainedBy?.mainView ?? 0) > 0)?.id ?? view.current;
+}
+/**
+ * Client plugin body: mount the Remote, register the dictionaries, then the
+ * tab type (gated by the preset-visibility criterion) and its body.
+ *
+ * @param ctx - client root context.
+ * @returns the teardown for everything this body registered.
+ */
+export async function apply(ctx) {
+    const disposers = [];
+    try {
+        disposers.push(await ctx.remote.$mount(libraryRemote));
+    }
+    catch (error) {
+        // A Remote already mounted by another composition fails loud; the rest of
+        // the plugin still registers, so the tab shows its empty state rather than
+        // disappearing.
+        ctx.logger.error(error);
+    }
+    ctx.effect(() => ctx.locale.register(NS, { zh, en }), 'library: dictionaries');
+    const t = ctx.locale.bind(NS);
+    // Read lazily and through `ctx.get`: a composition without the host half
+    // yields undefined, and the pane's reads answer a refusal instead of
+    // pending forever on an inject it cannot satisfy.
+    const remote = ctx.get('remote.library');
+    /** The session's conversation input, when the composition has one (the reader's structural reach). */
+    const inputFor = (sessionId) => {
+        try {
+            const scope = ctx.get('sessions')?.scope(sessionId);
+            const input = scope?.get('conversation')
+                ?.input?.for(scope);
+            const face = input;
+            return typeof face?.setDraft === 'function' && typeof face.state?.getSnapshot === 'function'
+                ? face
+                : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    };
+    /** The project the next reveal lands on (one per page; the pane takes it). */
+    const revealed = new RevealedProject();
+    /** The injected business face, identical for whichever session mounts it. */
+    const face = (sessionId) => ({
+        listProjects: () => remote.listProjects(),
+        getProject: id => remote.getProject({ id }),
+        createProject: request => remote.createProject(request),
+        updateProject: (projectId, patch) => remote.updateProject({ id: projectId, patch }),
+        deleteProject: projectId => remote.deleteProject({ id: projectId }),
+        removeResource: (projectId, resourceId) => remote.removeResource({ projectId, resourceId }),
+        moveResource: (projectId, resourceId, seq) => remote.moveResource({ projectId, resourceId, seq }),
+        setBookKind: (projectId, resourceId, bookKind) => remote.setBookKind({ projectId, resourceId, bookKind }),
+        getRoadmap: (projectId, resourceId) => remote.getRoadmap({ projectId, resourceId }),
+        adoptRoadmap: (projectId, resourceId) => remote.adoptRoadmap({ projectId, resourceId }),
+        discardDraft: (projectId, resourceId) => remote.discardDraft({ projectId, resourceId }),
+        markNodeRead: (projectId, resourceId, nodeId) => remote.markNodeRead(resourceId === undefined ? { projectId, nodeId } : { projectId, resourceId, nodeId }),
+        listPages: (projectId, resourceId, nodeId) => remote.listPages(nodeId === undefined ? { projectId, resourceId } : { projectId, resourceId, nodeId }),
+        readPagePhoto: (projectId, pageId) => remote.readPagePhoto({ projectId, pageId }),
+        listResources: projectId => remote.listResources({ projectId }),
+        listAttempts: (projectId, nodeId, assessmentId) => remote.listAttempts({ projectId, ...(nodeId === undefined ? {} : { nodeId }), ...(assessmentId === undefined ? {} : { assessmentId }) }),
+        listCards: query => remote.listCards(query),
+        dueCards: projectId => remote.dueCards(projectId === undefined ? {} : { projectId }),
+        editCard: (projectId, cardId, patch) => remote.editCard({ projectId, cardId, patch }),
+        undoCards: (projectId, ids, at) => remote.undoCards({ projectId, ids, at }),
+        reviewCard: (projectId, cardId, rating) => remote.reviewCard({ projectId, cardId, rating }),
+        listAssessments: (projectId, resourceId, nodeId, type) => remote.listAssessments({ projectId, ...(resourceId === undefined ? {} : { resourceId }), ...(nodeId === undefined ? {} : { nodeId }), ...(type === undefined ? {} : { type }) }),
+        getAssessment: (projectId, assessmentId) => remote.getAssessment({ projectId, assessmentId }),
+        putAttempt: (projectId, assessmentId, verdicts) => remote.putAttempt({ projectId, assessmentId, verdicts }),
+        recentRecords: () => remote.recentRecords({ limit: 3 }),
+        recentChanges: () => remote.recentChanges({ limit: 5 }),
+        createRetake: (projectId, resourceId, nodeId, keys) => remote.createRetake({ projectId, ...(resourceId === undefined ? {} : { resourceId }), ...(nodeId === undefined ? {} : { nodeId }), ...(keys === undefined ? {} : { keys }) }),
+        latestActivity: () => remote.latestActivity(),
+        boundTarget: () => remote.boundTarget(sessionId),
+        bindTarget: binding => remote.bindTarget(sessionId, { binding }),
+        revealed,
+        sendMessage: text => {
+            const input = inputFor(sessionId);
+            if (input?.submit === undefined)
+                return false;
+            input.setDraft(text);
+            input.submit('queue');
+            return true;
+        },
+        sendPhoto: (file, text) => {
+            const input = inputFor(sessionId);
+            const conversation = ctx.get('sessions')?.scope(sessionId)?.get('conversation');
+            if (input?.submit === undefined || input.addAttachments === undefined || conversation?.createDrafts === undefined)
+                return false;
+            try {
+                const drafts = conversation.createDrafts(sessionId, [file]);
+                input.setDraft(text);
+                if (!input.addAttachments(drafts.map(draft => draft.id))) {
+                    conversation.releaseDraftAttachments?.(drafts);
+                    return false;
+                }
+                input.submit('queue');
+                return true;
+            }
+            catch {
+                return false;
+            }
+        },
+        primeConversation: text => {
+            const input = inputFor(sessionId);
+            if (input === undefined)
+                return false;
+            const current = input.state.getSnapshot().draft;
+            input.setDraft(current.trim() === '' ? text : `${current}\n\n${text}`);
+            return true;
+        },
+    });
+    // Stage one of the right-Sidebar registration: the page type itself (guide
+    // entry, no address claims). The type registers exactly while the current
+    // session can reach the library tools — a root-mounted tool row (the
+    // community default) OR the session's preset composition naming it (the
+    // learning-mode recipe); every unreadable path fails open. Hidden means NOT
+    // registered: the guide enumerates the registry, opened tabs are stored per
+    // session, and an unregistered kind renders the host's tab.unavailable
+    // fallback.
+    const pluginInventory = ctx.get('remote.pluginInventory');
+    const tabVisibility = new LibraryTabVisibility(ctx, pluginInventory);
+    ctx.effect(() => {
+        const toggle = new RegistrationToggle(() => ctx.sidebarRightTabs.register(libraryDefinition(t)), () => tabVisibility.show(mainSessionId(ctx.sessions.list.getSnapshot())));
+        toggle.setReady(true);
+        const unsubscribe = tabVisibility.subscribe(() => { toggle.sync(); });
+        return () => { unsubscribe(); toggle.setReady(false); };
+    }, 'library: tab type visibility');
+    // Reveal the library beside the conversation that just started using it: a
+    // library tool from the on-screen session wrote (a project created, a book
+    // shelved, a path drafted) → open the 图书馆 tab on the session's bound
+    // project (the write bound it), once per session per page load, so closing
+    // it again sticks. The first read is the baseline (writes
+    // from before this page loaded never open anything). Degrades to nothing
+    // without the sidebar surface or the host half.
+    ctx.effect(() => {
+        const revealedSessions = new Set();
+        let baseline;
+        let primed = false;
+        const poll = () => {
+            if (remote === undefined || document.visibilityState !== 'visible')
+                return;
+            void remote.latestActivity().then((result) => {
+                if (!result.ok)
+                    return;
+                const write = result.value.session;
+                if (!primed) {
+                    primed = true;
+                    baseline = write?.at;
+                    return;
+                }
+                if (write === undefined || (baseline !== undefined && write.at <= baseline))
+                    return;
+                baseline = write.at;
+                const main = mainSessionId(ctx.sessions.list.getSnapshot());
+                if (main === undefined || String(main) !== write.id || revealedSessions.has(write.id) || !tabVisibility.show(main))
+                    return;
+                revealedSessions.add(write.id);
+                const open = () => {
+                    try {
+                        ctx.get('sidebarRight')?.openTab?.(LIBRARY_KIND);
+                    }
+                    catch {
+                        // No on-screen sidebar surface: nothing to reveal.
+                    }
+                };
+                // Land on the project the write bound; without a binding the tab opens on today.
+                void remote.boundTarget(main).then((bound) => {
+                    if (bound.ok && bound.value !== null)
+                        revealed.reveal(bound.value.projectId);
+                }, () => { }).finally(open);
+            }, () => { });
+        };
+        poll();
+        const timer = setInterval(poll, 5000);
+        return () => { clearInterval(timer); };
+    }, 'library: reveal on first write');
+    // Stage two: the tab body, under this package's id in the keyed pane seat.
+    ctx.effect(() => ctx.slots.inject('sidebar.right.pane.tab', () => ctx.slots.register({
+        name: 'sidebar.right.pane.tab',
+        key: LIBRARY_TAB_ID,
+        locale: NS,
+        store: createLibraryStore,
+        inject: face,
+    }, LibraryPane)), 'library: sidebar tab body');
+    // The session header's library chip: shown only in sessions that hold the
+    // library tools (the strict half of the criterion). The header seat is
+    // declared by ui-conversation, which this package does not depend on —
+    // without it the inject never fires.
+    const headerSlots = ctx.slots;
+    const bindFace = (sessionId) => ({
+        offered: () => tabVisibility.grants(sessionId),
+        subscribe: listener => tabVisibility.subscribe(listener),
+        boundTarget: () => remote.boundTarget(sessionId),
+        bindTarget: binding => remote.bindTarget(sessionId, { binding }),
+        listProjects: () => remote.listProjects(),
+    });
+    ctx.effect(() => headerSlots.inject('conversation.session.header.actions', () => headerSlots.register({
+        name: 'conversation.session.header.actions',
+        id: 'library-bind',
+        // After room's invite (30) and canvas's work chip (40).
+        order: 50,
+        locale: NS,
+        inject: bindFace,
+    }, LibraryBindChip)), 'library: session binding chip');
+    return async () => {
+        for (const dispose of disposers.reverse())
+            await dispose();
+    };
+}

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

@@ -0,0 +1,70 @@
+/**
+ * Judging the answers the sidebar can judge itself: a choice against its key
+ * (a letter, the option text, or a lettered option) and a fill-in against its
+ * key — the same text loosely (width, case, spaces, LaTeX vs unicode, the
+ * comma's width), or the same NUMBER (1/2 = 0.5 = \frac{1}{2}), part by part
+ * for a multi-blank answer; alternatives are written " / ", "|" or "或". What
+ * still disagrees, the learner may overrule (「我答对了」). Open answers are
+ * the coach's.
+ *
+ * @module @khorsheed/dsh-library/client/judge
+ */
+/**
+ * The value of a plain numeric expression — digits, + - × / ^, parentheses,
+ * √, π, a trailing % — or undefined. A tiny recursive-descent parser, never
+ * eval: 1/2, 0.5, √3/2, 2π/3 and 50% all read as numbers.
+ */
+export declare function numericValue(text: string): number | undefined;
+/** The option index an answer key names, or -1. */
+export declare function choiceIndex(options: readonly string[], answer: string): number;
+/**
+ * Whether a fill-in answer matches the key. The whole key is tried first —
+ * "1/2" is a fraction, never two alternatives — then alternatives written
+ * " / " (spaced), "|" or "或".
+ */
+export declare function fillMatches(input: string, answer: string): boolean;
+/**
+ * A fill-in judged by the project's profile: 'math' by text or value
+ * (fillMatches); 'spelling' also forgives a UK/US spelling or a plural.
+ */
+export declare function judgeFill(fill: 'math' | 'spelling', input: string, answer: string): boolean;
+/** How a due card is asked. */
+export type ReviewMode = 'cloze' | 'choice' | 'spell' | 'explain';
+/** The slice of a card the review needs. */
+export interface ReviewCardLike {
+    readonly id: string;
+    readonly kind: 'word' | 'concept';
+    readonly term: string;
+    readonly aliases: readonly string[];
+    readonly gloss: string;
+    readonly contexts: readonly {
+        readonly sentence: string;
+    }[];
+    readonly mastery: {
+        readonly box: number;
+        readonly streak: number;
+    };
+}
+/** The sentence with the term blanked, or undefined when the sentence does not hold it. */
+export declare function clozeOf(sentence: string, term: string, aliases?: readonly string[]): {
+    before: string;
+    after: string;
+    answer: string;
+} | undefined;
+/**
+ * Pick how to ask a card: a concept is explained; a word the learner already
+ * knows well (box 3+) is spelled; otherwise a word met in a sentence is a
+ * cloze or a meaning choice, alternating by its streak (the choice needs three
+ * other glosses for distractors).
+ */
+export declare function pickMode(card: ReviewCardLike, otherGlosses: number): ReviewMode;
+/** Whether a typed word is the term (case, width, a UK/US spelling and a plural apart). */
+export declare function spellMatches(input: string, answers: readonly string[]): boolean;
+/** Per-letter marks for a spelling attempt: true where the letter matches the target at that position. */
+export declare function letterMarks(input: string, target: string): boolean[];
+/** Three distractors from other cards' glosses, shuffled with the answer; `random` is injectable for tests. */
+export declare function choiceOptions(answer: string, others: readonly string[], random?: () => number): {
+    options: string[];
+    correct: number;
+};
+//# sourceMappingURL=judge.d.ts.map