@khorsheed/dsh-reader 0.2.0

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.1.7-rc.1, harness 46a7f68b09) — 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-reader/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 IconChevronDownOutlineMedium: ({ size, className }: IconProps) => import("react").JSX.Element;
+export declare const IconChevronLeftOutlineMedium: ({ size, className }: IconProps) => import("react").JSX.Element;
+export declare const IconClockOutlineMedium: ({ size, className }: IconProps) => import("react").JSX.Element;
+export declare const IconCopyOutlineMedium: ({ size, className }: IconProps) => import("react").JSX.Element;
+export declare const IconGlobeOutlineMedium: ({ 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 IconRightUpOutlineMedium: ({ size, className }: IconProps) => import("react").JSX.Element;
+export declare const IconSettingsOutlineMedium: ({ 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 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 IconChevronLeftOutlineMedium = ({ 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: "M10 4L6.70711 7.29289C6.31658 7.68342 6.31658 8.31658 6.70711 8.70711L10 12", stroke: "currentColor" }) }));
+export const IconClockOutlineMedium = ({ 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: "M8 4V8.5L11.25 10.25", stroke: "currentColor" })] }));
+export const IconCopyOutlineMedium = ({ 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: "1.52075", y: "4.07373", width: "10.3932", height: "10.3932", rx: "2", stroke: "currentColor" }), _jsx("path", { d: "M11.9792 1.53296C13.36 1.53296 14.4792 2.65225 14.4792 4.03296V9.42847C14.4792 10.3756 13.9521 11.1987 13.1755 11.6228V10.3298C13.3652 10.0787 13.4792 9.7674 13.4792 9.42847V4.03296C13.4792 3.20453 12.8077 2.53296 11.9792 2.53296H6.58374C6.27966 2.53301 5.99684 2.6235 5.7605 2.77905H4.42358C4.85652 2.03463 5.66056 1.53304 6.58374 1.53296H11.9792Z", fill: "currentColor" })] }));
+export const IconGlobeOutlineMedium = ({ size = 14, 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: "M7.99986 14.0887C11.3626 14.0887 14.0886 11.3627 14.0886 7.99998C14.0886 4.63727 11.3626 1.91125 7.99986 1.91125C4.63715 1.91125 1.91113 4.63727 1.91113 7.99998C1.91113 11.3627 4.63715 14.0887 7.99986 14.0887Z", stroke: "currentColor" }), _jsx("path", { d: "M2.34619 8H13.6538", stroke: "currentColor", strokeLinecap: "square" }), _jsx("path", { d: "M7.99976 14.0889C9.23509 14.0889 10.1743 11.3629 10.1743 8.00006C10.1743 4.63739 9.23509 1.91138 7.99976 1.91138", stroke: "currentColor" }), _jsx("path", { d: "M7.99973 14.0889C6.76445 14.0889 5.8252 11.3629 5.8252 8.00006C5.8252 4.63739 6.76445 1.91138 7.99973 1.91138", 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 IconRightUpOutlineMedium = ({ 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: "M11.7256 2.77441C12.5538 2.77469 13.2256 3.44616 13.2256 4.27441V10.1416H12.2256V4.27441C12.2256 3.99844 12.0015 3.77469 11.7256 3.77441H5.7207V2.77441H11.7256Z", fill: "currentColor" }), _jsx("path", { d: "M2.77441 13.2255L12.3756 3.62427", stroke: "currentColor" })] }));
+export const IconSettingsOutlineMedium = ({ 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 9.75012C8.9665 9.75012 9.75 8.96662 9.75 8.00012C9.75 7.03362 8.9665 6.25012 8 6.25012C7.0335 6.25012 6.25 7.03362 6.25 8.00012C6.25 8.96662 7.0335 9.75012 8 9.75012Z", stroke: "currentColor" }), _jsx("path", { d: "M13.0107 7.79377C12.9505 7.89401 12.9205 7.94413 12.9205 7.99951C12.9205 8.0549 12.9505 8.10502 13.0106 8.20528L13.9849 9.83006C14.045 9.93029 14.0751 9.9804 14.0751 10.0358C14.0751 10.0911 14.045 10.1413 13.9849 10.2415L13.0037 11.8777C12.9468 11.9726 12.9184 12.0201 12.8725 12.0461C12.8267 12.072 12.7713 12.072 12.6607 12.072H10.6704C10.5598 12.072 10.5045 12.072 10.4586 12.098C10.4128 12.1239 10.3843 12.1714 10.3274 12.2662L9.33825 13.9142C9.28133 14.009 9.25287 14.0564 9.20703 14.0823C9.16118 14.1083 9.10588 14.1083 8.99529 14.1083H7.00486C6.89426 14.1083 6.83896 14.1083 6.79312 14.0823C6.74727 14.0564 6.71881 14.009 6.6619 13.9142L5.67273 12.2662C5.61581 12.1714 5.58735 12.1239 5.54151 12.098C5.49566 12.072 5.44036 12.072 5.32977 12.072H3.33945C3.2288 12.072 3.17347 12.072 3.12761 12.0461C3.08176 12.0201 3.0533 11.9726 2.9964 11.8777L2.0152 10.2415C1.9551 10.1413 1.92505 10.0911 1.92505 10.0358C1.92505 9.9804 1.9551 9.93029 2.0152 9.83006L2.98951 8.20528C3.04963 8.10502 3.07969 8.0549 3.07969 7.99951C3.07968 7.94413 3.04961 7.89401 2.98946 7.79377L2.01529 6.17011C1.95514 6.06987 1.92507 6.01975 1.92507 5.96437C1.92506 5.90899 1.95512 5.85886 2.01524 5.7586L2.9964 4.1224C3.0533 4.0275 3.08176 3.98005 3.12761 3.95408C3.17347 3.92811 3.2288 3.92811 3.33945 3.92811H5.32977C5.44036 3.92811 5.49566 3.92811 5.54151 3.90216C5.58735 3.87621 5.61581 3.82879 5.67273 3.73397L6.6619 2.08599C6.71881 1.99116 6.74727 1.94375 6.79312 1.9178C6.83896 1.89185 6.89426 1.89185 7.00486 1.89185H8.99529C9.10588 1.89185 9.16118 1.89185 9.20703 1.9178C9.25287 1.94375 9.28133 1.99116 9.33825 2.08599L10.3274 3.73397C10.3843 3.82879 10.4128 3.87621 10.4586 3.90216C10.5045 3.92811 10.5598 3.92811 10.6704 3.92811H12.6607C12.7713 3.92811 12.8267 3.92811 12.8725 3.95408C12.9184 3.98005 12.9468 4.0275 13.0037 4.1224L13.9849 5.7586C14.045 5.85886 14.0751 5.90899 14.0751 5.96437C14.0751 6.01975 14.045 6.06987 13.9849 6.17011L13.0107 7.79377Z", stroke: "currentColor", strokeMiterlimit: "10" })] }));
+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,34 @@
+/**
+ * The reader's browser half: mount the Remote, register the dictionaries and
+ * the right-Sidebar tab, and hand the pane the four gestures it cannot perform
+ * for itself (the conversation draft, the clipboard, the browser, and the
+ * side-chat hop).
+ *
+ * Failure policy is the repo's "degrade, don't explode": genuinely required
+ * wiring (`slots`, `remote`, `locale`, `sidebarRightTabs`) is declared in
+ * `inject` and logged when it fails, while every OPTIONAL capability is probed
+ * per gesture — no `sideChat` hides the side-chat action, no conversation
+ * surface makes the draft gestures no-ops, and an unavailable clipboard reports
+ * failure instead of pretending to have copied.
+ *
+ * @module @khorsheed/dsh-reader/client
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import { ReaderPane } from './ReaderPane.tsx';
+export { ReaderPane };
+export { READER_KIND, READER_TAB_ID } from './definition.tsx';
+/**
+ * Required services: the pane seat, the wire channel, the locale,
+ * the tab-type registry, and sessions (the conversation draft lives behind a
+ * session scope, and the session id alone is not enough to reach it).
+ */
+export declare const inject: string[];
+/**
+ * Client plugin body: mount the Remote, register the dictionaries and the
+ * sidebar tab, and return the disposer.
+ *
+ * @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,222 @@
+import readerRemote from '@khorsheed/dsh-reader/remote';
+import { extractArticle } from "./extract-article.js";
+import { translationHash } from "./translate.js";
+import { READER_TAB_ID, readerDefinition } from "./definition.js";
+import { ReaderPane } from "./ReaderPane.js";
+import { createReaderStore } from "./store.js";
+import { en, NS, zh } from "./locales.js";
+export { ReaderPane };
+export { READER_KIND, READER_TAB_ID } from "./definition.js";
+/**
+ * Required services: the pane seat, the wire channel, the locale,
+ * the tab-type registry, and sessions (the conversation draft lives behind a
+ * session scope, and the session id alone is not enough to reach it).
+ */
+export const inject = ['slots', 'remote', 'locale', 'sidebarRightTabs', 'sessions'];
+/**
+ * Client plugin body: mount the Remote, register the dictionaries and the
+ * sidebar tab, and return the disposer.
+ *
+ * @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(readerRemote));
+    }
+    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 }), 'reader: dictionaries');
+    const t = ctx.locale.bind(NS);
+    const remote = ctx.get('remote.reader');
+    /** Copy text through the clipboard API, reporting whether it worked. */
+    const copyText = async (text) => {
+        try {
+            await navigator.clipboard.writeText(text);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    };
+    /**
+     * Open a URL in the user's browser.
+     *
+     * The host exposes no plugin-facing "open this URL" service today (the
+     * open-in-app routes launch local files into an app), so this rides the
+     * browser's own user-invoked navigation: a click handler calling
+     * `window.open` with `noopener` is a user gesture, not a popup. The design
+     * records this as the one unverified seam, to be re-checked on the
+     * acceptance instance.
+     */
+    const openExternal = (url) => {
+        try {
+            const opened = window.open(url, '_blank', 'noopener,noreferrer');
+            if (opened !== null)
+                return true;
+        }
+        catch {
+            // fall through to the anchor path
+        }
+        try {
+            const anchor = document.createElement('a');
+            anchor.href = url;
+            anchor.target = '_blank';
+            anchor.rel = 'noopener noreferrer';
+            anchor.click();
+            return true;
+        }
+        catch {
+            return false;
+        }
+    };
+    /**
+     * The in-app Sidebar Browser, probed live (the canvas/quote pattern).
+     *
+     * Two services, both optional: the tab-type registry answers whether the
+     * `browser` kind is registered (host 0.1.6-alpha.2 mounts it; older hosts do
+     * not), and the navigation face performs the open. `openTab` throws for a
+     * kind nothing registered and for a missing session binding, so the call is
+     * wrapped — the pane's fallback is the external link.
+     */
+    const sidebarBrowser = () => {
+        const tabs = ctx.get('sidebarRightTabs');
+        if (tabs?.get('browser') === undefined)
+            return undefined;
+        return ctx.get('sidebarRight');
+    };
+    /**
+     * Fetch one entry's article and cache the extraction.
+     *
+     * The split is the host/browser boundary: the host owns the network (its
+     * sanctioned egress seam), this process owns the DOM, and neither can do the
+     * other's half — so the view calls this one function and both halves happen.
+     */
+    const fetchEntryBody = async (entryId, url) => {
+        const fetched = await remote.fetchEntryBody({ entryId, url });
+        if (!fetched.ok) {
+            return { entryId, cached: false, fresh: false, fromFeed: false, error: fetched.error.message };
+        }
+        const value = fetched.value;
+        if (value.raw === undefined || value.url === undefined) {
+            return { entryId, cached: false, fresh: false, fromFeed: false, error: value.error ?? 'fetch-failed' };
+        }
+        const extracted = extractArticle(value.raw, value.url);
+        if (!extracted.ok) {
+            return { entryId, cached: false, fresh: false, fromFeed: false, error: extracted.error };
+        }
+        const meta = {
+            ...(extracted.title === undefined ? {} : { title: extracted.title }),
+            ...(extracted.excerpt === undefined ? {} : { excerpt: extracted.excerpt }),
+        };
+        const stored = await remote.storeEntryBody({
+            entryId,
+            url: value.url,
+            html: extracted.html,
+            // The entry's translation map is keyed to the body's hash: a refetch that
+            // changes the body retires the map in the same commit.
+            bodyHash: translationHash(extracted.html),
+            ...meta,
+            ...(value.truncated === true ? { truncated: true } : {}),
+            ...(extracted.scriptFigures === undefined ? {} : { scriptFigures: extracted.scriptFigures }),
+        });
+        return stored.ok
+            ? { ...stored.value, ...meta }
+            : { entryId, cached: false, fresh: false, fromFeed: false, error: stored.error.message };
+    };
+    /** The injected business face, identical for whichever session mounts it. */
+    const face = (sessionId) => ({
+        capabilities: () => remote.capabilities(),
+        listSources: () => remote.listSources(),
+        addSource: url => remote.addSource({ url }),
+        updateSource: request => remote.updateSource(request),
+        removeSource: (id, entryIds) => remote.removeSource({ id, ...(entryIds === undefined ? {} : { entryIds }) }),
+        refresh: ids => remote.refresh(ids === undefined ? {} : { ids }),
+        getBodies: ids => remote.getBodies({ ids }),
+        quoteToSideChat: request => remote.quoteToSideChat(request),
+        entryFetchStates: entryIds => remote.entryFetchStates({ entryIds }),
+        getRawBody: entryId => remote.getRawBody({ entryId }),
+        storeEntryBody: request => remote.storeEntryBody(request),
+        listBackfillCandidates: entries => remote.listBackfillCandidates({ entries }),
+        getEntryBody: request => remote.getEntryBody(request),
+        fetchEntryBody,
+        getEntryTranslation: entryId => remote.getEntryTranslation({ entryId }),
+        getSentenceTranslations: request => remote.getSentenceTranslations(request),
+        rememberSentences: request => remote.rememberSentences(request),
+        entryTags: entryId => remote.entryTags({ entryId }),
+        listTags: () => remote.listTags(),
+        createTag: name => remote.createTag({ name }),
+        tagEntry: (entryId, tagId, on) => remote.tagEntry({ entryId, tagId, on }),
+        renameTag: (id, name) => remote.renameTag({ id, name }),
+        deleteTag: id => remote.deleteTag({ id }),
+        pruneTags: () => remote.pruneTags(),
+        recordRead: request => remote.recordRead(request),
+        listRecent: () => remote.listRecent(),
+        clearRecent: () => remote.clearRecent(),
+        getCachePolicy: () => remote.getCachePolicy(),
+        setCachePolicy: (ttlHours, maxEntries, translationBudgetChars) => remote.setCachePolicy({
+            ttlHours,
+            ...(maxEntries === undefined ? {} : { maxEntries }),
+            ...(translationBudgetChars === undefined ? {} : { translationBudgetChars }),
+        }),
+        getStorageStats: () => remote.getStorageStats(),
+        clearTranslations: () => remote.clearTranslations(),
+        readDraft: () => readDraft(sessionId),
+        setDraft: merged => { setDraft(sessionId, merged); },
+        copyText,
+        openExternal,
+        browserTabAvailable: () => sidebarBrowser() !== undefined,
+        openBrowserTab: url => {
+            const browser = sidebarBrowser();
+            if (browser === undefined)
+                return false;
+            try {
+                browser.openTab('browser', { params: { url } });
+                return true;
+            }
+            catch {
+                return false;
+            }
+        },
+        // The capture package (the ingest proposal's M1): probed live per gesture,
+        // absent today — the 「渲染抓取」 slot renders only while this answers.
+        captureRemote: () => {
+            const capture = ctx.get('remote.capture');
+            return typeof capture?.render === 'function' ? capture : undefined;
+        },
+    });
+    /** The conversation input for a session, when the composition has one. */
+    const inputFor = (sessionId) => {
+        const scope = ctx.get('sessions')?.scope(sessionId);
+        return scope?.get('conversation')?.input.for(scope);
+    };
+    /** Read the session's current draft; an empty string when there is none. */
+    const readDraft = (sessionId) => {
+        const input = inputFor(sessionId);
+        return input?.state.getSnapshot().draft ?? '';
+    };
+    /** Replace the session's draft; a silent no-op without a conversation surface. */
+    const setDraft = (sessionId, merged) => {
+        inputFor(sessionId)?.setDraft(merged);
+    };
+    // Two-stage right-Sidebar registration: the type into the registry, the body
+    // into the keyed pane seat under the type's id. Both ride `ctx.effect` so a
+    // reload or unload removes them.
+    ctx.effect(() => ctx.sidebarRightTabs.register(readerDefinition(t)), 'reader: tab type');
+    ctx.effect(() => ctx.slots.inject('sidebar.right.pane.tab', () => ctx.slots.register({
+        name: 'sidebar.right.pane.tab',
+        key: READER_TAB_ID,
+        locale: NS,
+        store: createReaderStore,
+        inject: face,
+    }, ReaderPane)), 'reader: sidebar tab body');
+    return async () => {
+        for (const dispose of disposers.reverse())
+            await dispose();
+    };
+}