@snap-rail/framework-shadcn 0.0.0-stage → 0.2.0

package/lib/types/settings-plugins-page.js

@@ -0,0 +1,466 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * The 插件 page — plugin management and discovery fused into one surface. The
+ * top row is a single tri-form input: a local path or an http(s) address
+ * inspects that zip (a plugin, or an offline combo package with `recipe.yml`
+ * at its root; both preview → confirm → install), a dropped file does the
+ * same, anything else searches every configured plugin feed (merged, rows
+ * carry their source). Below, every installed (non-builtin) row lists in
+ * one table — 名称/标识 split into columns, the version cell doubling as
+ * the update affordance (a muted pill normally; a success-colored pill with
+ * a refresh glyph and the feed version when an update is pending — clicking
+ * it updates directly, behind a key-change confirmation when the feed entry
+ * is signed by a different key than the installed copy). The preview shows
+ * the three-state signature verdict per plugin (a combo shows each member's
+ * own verdict — the archive itself is unsigned); an unverified member takes
+ * one extra explicit risk step before it installs. The feed sources hide
+ * behind a small icon button before the input; they default from the app's
+ * shipped `defaults.json` until the user writes their own list. Every write
+ * lands in `plugins.yml`/`settings.json` through the plugins and settings
+ * domains; the files stay the single interface.
+ *
+ * @module @snap-rail/framework-shadcn/settings-plugins-page
+ */
+// Wire rows for the plugins-domain methods this page calls.
+import '@snap-rail/app-boot/contract';
+import { rpcErrorText, subscribeFrame } from '@snap-rail/connection';
+import { PLUGINS_FEED_URLS_KEY, pluginUpdatesChangedSchema, } from '@snap-rail/app-boot/contract';
+import { Badge, Button, Dialog, DialogContent, DialogFooter, DialogTitle, Input, Switch, Table, TableBody, TableCell, TableHead, TableHeader, TableRow, } from "./ui/index.js";
+import { RefreshCw, Rss, Search } from 'lucide-react';
+import { useCallback, useEffect, useState } from 'react';
+/** The preview's signature row: one line, color carries the verdict. */
+function SignatureRow({ signature, directUrl }) {
+    if (signature.state === 'verified') {
+        return (_jsxs("div", { className: "flex justify-between gap-4", "data-signature-row": "verified", children: [_jsx("span", { className: "text-muted-foreground", children: "\u7B7E\u540D" }), _jsxs("span", { children: ["\u2713 \u5DF2\u9A8C\u8BC1", signature.publisher !== undefined ? ` · ${signature.publisher}` : ` · ${signature.keyId}`] })] }));
+    }
+    const detail = signature.keyId !== undefined
+        ? `未验证 · keyId ${signature.keyId}（未登记）`
+        : '未签名';
+    return (_jsxs("div", { className: "flex justify-between gap-4 text-warning", "data-signature-row": "unverified", children: [_jsx("span", { className: "text-muted-foreground", children: "\u7B7E\u540D" }), _jsxs("span", { children: ["\u26A0 ", detail, directUrl ? ' · 直链无完整性校验' : ''] })] }));
+}
+/** Kind → display label; shared with the search results' rows. */
+const KIND_LABELS = {
+    suite: '业务套件',
+    driver: '通讯驱动',
+    plugin: '插件',
+};
+/** The section a package groups under: a declared category wins whatever the
+ * source (dev's overlay mounts installable packages as protected builtin
+ * rows, and they keep their author markers); without one, installed and
+ * preset-carried rows fall into 其他 and the protected shipped set — which
+ * declares no category — pins into the single 内置 section. */
+const sectionOf = (row) => row.category ?? (row.source === 'pool' || row.source === 'preset' ? '其他' : '内置');
+/** The drag-and-drop bridge: turn a dropped `File` back into its host-side
+ * path through the preload's `zipPathOf` (`webUtils.getPathForFile`). Null
+ * when the carrier offers no bridge (test hosts, non-Electron shells). */
+function droppedZipPath(file) {
+    const zipPathOf = globalThis.snapRail?.zipPathOf;
+    if (typeof zipPathOf !== 'function')
+        return null;
+    const path = zipPathOf(file);
+    return typeof path === 'string' && path !== '' ? path : null;
+}
+/** Does the input name an http(s) address? */
+const isHttpUrl = (text) => /^https?:\/\//i.test(text);
+/** Does the input look like a filesystem path (drive letter, UNC, posix
+ * root, or a .zip name with a separator in it)? */
+const looksLikePath = (text) => /^[a-zA-Z]:[\\/]/.test(text) || text.startsWith('\\\\') || text.startsWith('/')
+    || (/\.zip$/i.test(text) && /[/\\]/.test(text));
+/** The version cell: a muted pill normally; when a feed update is pending,
+ * a success-colored pill carrying the refresh glyph and the feed version —
+ * clicking it updates directly (a key change confirmation intercepts first
+ * when the feed entry is signed by another key). */
+function VersionPill(props) {
+    const { update } = props;
+    if (update !== undefined) {
+        return (_jsxs(Button, { size: "sm", variant: "outline", "data-update-version": update.name, disabled: props.busy, title: update.keyChanged === true
+                ? `当前 ${update.installedVersion} → ${update.feedVersion}，发布者密钥已变更，点击确认更新`
+                : `当前 ${update.installedVersion} → ${update.feedVersion}，点击更新`, className: "h-7 bg-success/10 px-2 font-mono text-xs text-success", onClick: () => props.onUpdate(update), children: [_jsx(RefreshCw, { className: "h-4 w-4" }), props.busy ? '更新中…' : update.feedVersion] }));
+    }
+    return (_jsx("span", { className: "inline-flex h-7 items-center rounded-md border border-border bg-muted px-2 font-mono text-xs text-muted-foreground", children: props.version ?? '—' }));
+}
+/** The plugins page. */
+export function PluginsPage({ ctx }) {
+    const [rows, setRows] = useState([]);
+    const [failed, setFailed] = useState(false);
+    const [rendererNames, setRendererNames] = useState([]);
+    /** Rows changed since page open — the restart-required surface. */
+    const [touched, setTouched] = useState(new Set());
+    const [restartPrompt, setRestartPrompt] = useState(false);
+    const [uninstall, setUninstall] = useState({ phase: 'idle' });
+    const [installPhase, setInstallPhase] = useState({ phase: 'idle' });
+    // The tri-form input and its one non-address outcome: a feed search.
+    const [query, setQuery] = useState('');
+    const [searchResults, setSearchResults] = useState(undefined);
+    const [searching, setSearching] = useState(false);
+    const [actionError, setActionError] = useState(undefined);
+    /** The name whose update click is in flight (version pill busy state). */
+    const [updatingName, setUpdatingName] = useState(undefined);
+    /** The pending update whose click hit a key change — confirmed before the
+     * install fires. */
+    const [keyChange, setKeyChange] = useState(undefined);
+    // The feed-source dialog: the draft list, its input, and its own error line.
+    const [feedDialogOpen, setFeedDialogOpen] = useState(false);
+    const [feedUrls, setFeedUrls] = useState([]);
+    const [feedDraft, setFeedDraft] = useState('');
+    const [feedError, setFeedError] = useState(undefined);
+    /** Pending updates by package name (drives the version pills). */
+    const [updates, setUpdates] = useState(new Map());
+    const [dragging, setDragging] = useState(false);
+    const link = ctx.get('client').link;
+    const reload = useCallback(() => {
+        void link.call('plugins.list', {}).then(result => {
+            if (result.ok) {
+                setRows(result.value.plugins.map(info => ({
+                    name: info.name, source: info.source, enabled: info.enabled,
+                    packageName: info.packageName,
+                    ...info.kind !== undefined ? { kind: info.kind } : {},
+                    ...info.version !== undefined ? { version: info.version } : {},
+                    ...info.title !== undefined ? { title: info.title } : {},
+                    ...info.category !== undefined ? { category: info.category } : {},
+                    ...info.clientOnly ? { clientOnly: true } : {},
+                })));
+            }
+            else
+                setFailed(true);
+        }).catch(() => setFailed(true));
+        // Rides every reload: installs and uninstalls change which pool faces
+        // exist, and the restart prompt keys off this list.
+        void link.call('client-config.list', {}).then(result => {
+            if (result.ok)
+                setRendererNames(result.value.rows.map(row => row.name));
+        }).catch(() => undefined);
+        // The pending-update set keys the version pills.
+        void link.call('plugins.updates-check', {}).then(result => {
+            if (result.ok) {
+                setUpdates(new Map(result.value.updates.map(update => [update.name, update])));
+            }
+        }).catch(() => undefined);
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [link]);
+    useEffect(() => {
+        reload();
+        // The user's feed list rides settings.json — read once for the dialog
+        // (an empty read means the factory default list is in force).
+        void link.call('settings.get', { key: PLUGINS_FEED_URLS_KEY }).then(result => {
+            if (result.ok && Array.isArray(result.value.value)) {
+                setFeedUrls(result.value.value.filter((entry) => typeof entry === 'string'));
+            }
+        }).catch(() => undefined);
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [reload]);
+    useEffect(() => {
+        // The host sweep announces pending updates on the frame; the page folds
+        // them straight into the version pills.
+        const detach = subscribeFrame(link, 'plugins/updates-changed', pluginUpdatesChangedSchema, change => {
+            setUpdates(new Map(change.updates.map(update => [update.name, update])));
+        });
+        return () => { detach(); };
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [link]);
+    const toggle = (name, enabled) => {
+        setRows(current => current.map(row => row.name === name ? { ...row, enabled } : row));
+        if (rendererNames.includes(name)) {
+            setTouched(current => new Set([...current, name]));
+            setRestartPrompt(true);
+        }
+        void link.call('plugins.set-enabled', { name, enabled })
+            .then(result => {
+            if (!result.ok) {
+                setRows(current => current.map(row => row.name === name ? { ...row, enabled: !enabled } : row));
+                setTouched(current => { const next = new Set(current); next.delete(name); return next; });
+            }
+        })
+            .catch(() => {
+            setRows(current => current.map(row => row.name === name ? { ...row, enabled: !enabled } : row));
+            setTouched(current => { const next = new Set(current); next.delete(name); return next; });
+        });
+    };
+    /** The uninstall affordance opens a confirm first — the package and its
+     * data are deleted for real. */
+    const requestUninstall = (pkg) => {
+        setUninstall({ phase: 'confirm', pkg });
+    };
+    const runUninstall = (pkg) => {
+        void link.call('plugins.uninstall', { name: pkg }).then(result => {
+            if (!result.ok) {
+                setUninstall({ phase: 'error', message: rpcErrorText(result.error) });
+                return;
+            }
+            setUninstall({ phase: 'idle' });
+            reload();
+            // The renderer may still carry the uninstalled face until it reboots.
+            if (rendererNames.includes(pkg)) {
+                setTouched(current => new Set([...current, pkg]));
+                setRestartPrompt(true);
+            }
+        }).catch(cause => setUninstall({ phase: 'error', message: String(cause) }));
+    };
+    const markRestartIfNeeded = (name, updated) => {
+        if (updated && rendererNames.includes(name)) {
+            setTouched(current => new Set([...current, name]));
+            setRestartPrompt(true);
+        }
+    };
+    /** Inspect a zip the host can already reach (a local path, a picked file,
+     * or a dropped one). */
+    const inspectPath = (zipPath) => {
+        setInstallPhase({ phase: 'idle' });
+        void link.call('plugins.inspect', { zipPath }).then(result => {
+            if (!result.ok) {
+                setInstallPhase({ phase: 'error', message: rpcErrorText(result.error) });
+                return;
+            }
+            setInstallPhase({ phase: 'confirm', zipPath, archive: result.value.archive, viaUrl: false, risk: false });
+        }).catch(cause => setInstallPhase({ phase: 'error', message: String(cause) }));
+    };
+    /** Download and inspect a direct http(s) address — the host owns the
+     * temp file; its path feeds the confirm → install legs. */
+    const inspectFromUrl = (url, source) => {
+        setInstallPhase({ phase: 'idle' });
+        void link.call('plugins.inspect-from-url', { url }).then(result => {
+            if (!result.ok) {
+                setInstallPhase({ phase: 'error', message: rpcErrorText(result.error) });
+                return;
+            }
+            setInstallPhase({
+                phase: 'confirm',
+                zipPath: result.value.zipPath,
+                archive: result.value.archive,
+                viaUrl: true,
+                ...(source !== undefined ? { source } : {}),
+                risk: false,
+            });
+        }).catch(cause => setInstallPhase({ phase: 'error', message: String(cause) }));
+    };
+    const runInstall = (zipPath, archive) => {
+        setInstallPhase({ phase: 'installing' });
+        if (archive.kind === 'combo') {
+            void link.call('plugins.install-combo', { zipPath }).then(result => {
+                if (!result.ok) {
+                    setInstallPhase({ phase: 'error', message: rpcErrorText(result.error) });
+                    return;
+                }
+                setInstallPhase({ phase: 'idle' });
+                reload();
+                // A combo lands a preset that mounts its rows immediately; a renderer
+                // face may wait for the next boot, same surface as an in-place update.
+                if (archive.combo.hasClient)
+                    setRestartPrompt(true);
+            }).catch(cause => setInstallPhase({ phase: 'error', message: String(cause) }));
+            return;
+        }
+        void link.call('plugins.install', { zipPath }).then(result => {
+            if (!result.ok) {
+                setInstallPhase({ phase: 'error', message: rpcErrorText(result.error) });
+                return;
+            }
+            setInstallPhase({ phase: 'idle' });
+            reload();
+            // A fresh install lands disabled (no restart prompt). An update swaps
+            // the package under a possibly-running face, so the renderer may carry
+            // the old bundle until it reboots — same surface as the uninstall path.
+            markRestartIfNeeded(result.value.installed.name, result.value.installed.updated);
+        }).catch(cause => setInstallPhase({ phase: 'error', message: String(cause) }));
+    };
+    const pickZip = () => {
+        void link.call('window.pick-zip', { title: '选择插件包或组合包' }).then(result => {
+            if (!result.ok || result.value === null)
+                return;
+            inspectPath(result.value);
+        }).catch(() => undefined);
+    };
+    /** The tri-form input: address/path → inspect, anything else → feed search. */
+    const submitQuery = () => {
+        const text = query.trim();
+        if (text === '')
+            return;
+        setActionError(undefined);
+        if (isHttpUrl(text)) {
+            inspectFromUrl(text);
+            return;
+        }
+        if (looksLikePath(text)) {
+            inspectPath(text);
+            return;
+        }
+        runSearch(text);
+    };
+    const runSearch = (text) => {
+        setSearching(true);
+        setSearchResults(undefined);
+        void link.call('plugins.remote-list', {}).then(result => {
+            setSearching(false);
+            if (!result.ok) {
+                setActionError(rpcErrorText(result.error));
+                return;
+            }
+            const needle = text.toLowerCase();
+            setSearchResults(result.value.plugins.filter(item => item.name.toLowerCase().includes(needle)
+                || (item.title ?? '').toLowerCase().includes(needle)
+                || (item.description ?? '').toLowerCase().includes(needle)));
+        }).catch(cause => {
+            setSearching(false);
+            setActionError(String(cause));
+        });
+    };
+    /** A search-result entry that is not installed yet: preview first. The
+     * entry's own coordinates decide where the zip comes from — a federation
+     * row downloads from the author's release, a same-directory row from its
+     * feed base. */
+    const previewRemote = (item) => {
+        if (item.url !== undefined) {
+            inspectFromUrl(item.url, item.source);
+            return;
+        }
+        if (item.feedUrl === undefined || item.file === undefined)
+            return;
+        const base = item.feedUrl.endsWith('/') ? item.feedUrl : `${item.feedUrl}/`;
+        inspectFromUrl(`${base}${item.file}`, item.source);
+    };
+    /** The version pill's click: a plain update installs directly; a key
+     * change confirmation intercepts first. */
+    const requestUpdate = (update) => {
+        if (update.keyChanged === true) {
+            setKeyChange(update);
+            return;
+        }
+        updateNow(update.name);
+    };
+    /** The update itself: the feed's entry, no preview. */
+    const updateNow = (name) => {
+        setKeyChange(undefined);
+        setUpdatingName(name);
+        setActionError(undefined);
+        void link.call('plugins.remote-install', { name }).then(result => {
+            setUpdatingName(undefined);
+            if (!result.ok) {
+                setActionError(rpcErrorText(result.error));
+                return;
+            }
+            reload();
+            markRestartIfNeeded(result.value.installed.name, result.value.installed.updated);
+        }).catch(() => setUpdatingName(undefined));
+    };
+    const saveFeedUrls = () => {
+        for (const url of feedUrls) {
+            try {
+                const parsed = new URL(url);
+                if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:')
+                    throw new Error('protocol');
+            }
+            catch {
+                setFeedError('插件源地址需要以 http(s) 开头');
+                return;
+            }
+        }
+        setFeedError(undefined);
+        void link.call('settings.set', { key: PLUGINS_FEED_URLS_KEY, value: feedUrls }).then(result => {
+            if (!result.ok) {
+                setFeedError(rpcErrorText(result.error));
+                return;
+            }
+            setFeedDialogOpen(false);
+        }).catch(cause => setFeedError(String(cause)));
+    };
+    const appendFeedUrl = () => {
+        const value = feedDraft.trim();
+        if (value === '')
+            return;
+        try {
+            const parsed = new URL(value);
+            if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:')
+                throw new Error('protocol');
+        }
+        catch {
+            setFeedError('请填写 http(s) 开头的插件源地址');
+            return;
+        }
+        setFeedError(undefined);
+        setFeedDraft('');
+        setFeedUrls(current => current.includes(value) ? current : [...current, value]);
+    };
+    const onDrop = (event) => {
+        event.preventDefault();
+        setDragging(false);
+        const file = event.dataTransfer.files[0];
+        if (file === undefined)
+            return;
+        if (!file.name.toLowerCase().endsWith('.zip')) {
+            setActionError('只支持 .zip 插件包或组合包');
+            return;
+        }
+        const zipPath = droppedZipPath(file);
+        if (zipPath === null) {
+            setActionError('当前环境不支持拖拽安装（缺少路径桥）');
+            return;
+        }
+        inspectPath(zipPath);
+    };
+    const relaunch = () => {
+        void link.call('window.relaunch', {}).catch(() => undefined);
+    };
+    if (failed)
+        return _jsx("div", { className: "text-sm text-muted-foreground", children: "\u63D2\u4EF6\u5217\u8868\u8BFB\u53D6\u5931\u8D25\u3002" });
+    const needsRestart = (name) => touched.has(name);
+    // Built-ins never list: the shipped set is read-only by design (every
+    // operation on it is refused), so listing un-actionable rows is noise.
+    // Dev's overlay mounts installable packages as protected builtin rows —
+    // they hide here too; the layer files remain the development levers.
+    const listed = rows.filter(row => row.source !== 'builtin');
+    const confirmed = installPhase.phase === 'confirm' ? installPhase : undefined;
+    const confirmedPlugin = confirmed?.archive.kind === 'plugin' ? confirmed.archive.plugin : undefined;
+    const confirmedCombo = confirmed?.archive.kind === 'combo' ? confirmed.archive.combo : undefined;
+    return (_jsxs("div", { "data-region": "plugins-page", className: "flex min-h-0 flex-1 flex-col gap-4", onDragOver: event => {
+            event.preventDefault();
+            setDragging(true);
+        }, onDragLeave: () => setDragging(false), onDrop: event => onDrop(event), children: [dragging && (_jsx("div", { className: "pointer-events-none fixed inset-0 z-50 flex items-center justify-center bg-background", children: _jsx("div", { className: "rounded-lg border-2 border-dashed border-primary px-8 py-10 text-base text-primary", children: "\u677E\u5F00\u4EE5\u5B89\u88C5\u63D2\u4EF6\u5305\u6216\u7EC4\u5408\u5305\uFF08.zip\uFF09" }) })), _jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Button, { variant: "ghost", size: "icon", "aria-label": "\u914D\u7F6E\u63D2\u4EF6\u6E90", "data-feed-config": true, className: "h-9 w-9 shrink-0 text-muted-foreground", onClick: () => setFeedDialogOpen(true), children: _jsx(Rss, { className: "h-4 w-4" }) }), _jsx(Input, { value: query, placeholder: "\u7C98\u8D34\u672C\u5730/\u7F51\u7EDC\u5730\u5740\u5B89\u88C5\uFF0C\u6216\u8F93\u5165\u540D\u79F0\u641C\u7D22\u2026", "data-plugin-query": true, className: "flex-1", onChange: event => setQuery(event.target.value), onKeyDown: event => { if (event.key === 'Enter')
+                            submitQuery(); } }), _jsxs(Button, { variant: "outline", "data-plugin-search": true, disabled: searching, onClick: submitQuery, children: [_jsx(Search, { className: "h-4 w-4" }), searching ? '搜索中…' : '搜索'] }), _jsx(Button, { variant: "outline", "data-install-plugin": true, onClick: pickZip, children: "\u9009\u62E9\u6587\u4EF6" })] }), actionError !== undefined && (_jsx("p", { "data-plugin-action-error": true, className: "text-sm text-destructive", children: actionError })), searchResults !== undefined && (_jsxs("div", { "data-region": "plugin-search-results", className: "flex flex-col gap-2 rounded-md border border-border p-3", children: [_jsxs("div", { className: "flex items-center justify-between", children: [_jsxs("span", { className: "text-sm font-medium", children: ["\u641C\u7D22\u201C", query.trim(), "\u201D\uFF08", searchResults.length, "\uFF09"] }), _jsx(Button, { variant: "ghost", size: "sm", "aria-label": "\u5173\u95ED\u641C\u7D22\u7ED3\u679C", onClick: () => setSearchResults(undefined), children: "\u2715" })] }), searchResults.length === 0 && (_jsx("p", { className: "py-2 text-center text-sm text-muted-foreground", children: "\u6CA1\u6709\u5339\u914D\u7684\u63D2\u4EF6\uFF08\u63D2\u4EF6\u6E90\u4E2D\u6CA1\u6709\u8BE5\u540D\u79F0\u7684\u6761\u76EE\uFF09\u3002" })), searchResults.map(item => {
+                        const pillUpdate = item.action === 'update' && item.installed !== undefined
+                            ? {
+                                name: item.name,
+                                installedVersion: item.installed.version,
+                                feedVersion: item.version,
+                                ...(item.source !== undefined ? { title: item.source } : {}),
+                            }
+                            : undefined;
+                        return (_jsxs("div", { "data-search-row": item.name, className: "flex items-center justify-between gap-3 rounded-md border border-border px-4 py-3", children: [_jsxs("div", { className: "flex min-w-0 flex-col gap-1", children: [_jsxs("span", { className: "flex min-w-0 items-center gap-2", children: [_jsx("span", { className: "truncate text-sm font-medium", children: item.title ?? item.name }), item.kind !== undefined && _jsx(Badge, { variant: "secondary", children: KIND_LABELS[item.kind] ?? item.kind }), item.source !== undefined && _jsx(Badge, { variant: "outline", "data-search-source": item.name, children: item.source })] }), _jsxs("span", { className: "truncate font-mono text-xs text-muted-foreground", children: [item.name, " \u00B7 ", item.version] }), item.description !== undefined && item.description !== '' && (_jsx("span", { className: "truncate text-xs text-muted-foreground", children: item.description }))] }), item.action === 'install'
+                                    ? _jsx(Button, { size: "sm", "data-search-install": item.name, onClick: () => previewRemote(item), children: "\u5B89\u88C5" })
+                                    : pillUpdate !== undefined
+                                        ? _jsx(VersionPill, { update: pillUpdate, busy: updatingName === item.name, onUpdate: requestUpdate })
+                                        : _jsx(Badge, { variant: "secondary", children: item.action === 'current' ? '已是最新' : '本地更新' })] }, item.name));
+                    })] })), _jsxs("div", { className: "shrink-0 text-sm font-medium text-muted-foreground", children: ["\u5DF2\u5B89\u88C5\u63D2\u4EF6\uFF08", listed.length, "\uFF09"] }), _jsx("div", { className: "min-h-0 flex-1 overflow-auto rounded-md border border-border", children: _jsxs(Table, { "data-region": "plugins-table", children: [_jsx(TableHeader, { children: _jsxs(TableRow, { children: [_jsx(TableHead, { className: "w-14", children: "\u542F\u7528" }), _jsx(TableHead, { children: "\u540D\u79F0" }), _jsx(TableHead, { children: "\u6807\u8BC6" }), _jsx(TableHead, { className: "w-24", children: "\u5206\u7C7B" }), _jsx(TableHead, { className: "w-36", children: "\u7248\u672C" }), _jsx(TableHead, { className: "w-24", children: "\u64CD\u4F5C" })] }) }), _jsxs(TableBody, { children: [listed.map(row => {
+                                    const label = row.title ?? row.name;
+                                    return (_jsxs(TableRow, { "data-plugin-row": row.name, children: [_jsx(TableCell, { children: _jsx(Switch, { "aria-label": `启用 ${label}`, checked: row.enabled, onCheckedChange: checked => toggle(row.name, checked) }) }), _jsx(TableCell, { children: _jsxs("span", { className: "flex items-center gap-2 truncate text-sm font-medium", children: [label, needsRestart(row.name) && _jsx(Badge, { variant: "destructive", children: "\u5F85\u91CD\u542F" })] }) }), _jsx(TableCell, { className: "font-mono text-xs text-muted-foreground", children: row.name }), _jsx(TableCell, { className: "text-sm text-muted-foreground", children: row.category ?? '其他' }), _jsx(TableCell, { children: _jsx(VersionPill, { version: row.version, update: updates.get(row.packageName), busy: updatingName === row.packageName, onUpdate: requestUpdate }) }), _jsx(TableCell, { children: row.source === 'pool'
+                                                    ? (_jsx(Button, { "data-uninstall-plugin": row.packageName, variant: "ghost", size: "sm", className: "text-destructive hover:text-destructive", onClick: () => requestUninstall(row.packageName), children: "\u5378\u8F7D" }))
+                                                    : _jsx("span", { className: "text-xs text-muted-foreground", children: "\u2014" }) })] }, row.name));
+                                }), listed.length === 0 && (_jsx(TableRow, { children: _jsx(TableCell, { colSpan: 6, className: "py-8 text-center text-sm text-muted-foreground", children: "\u6682\u65E0\u5DF2\u5B89\u88C5\u63D2\u4EF6 \u2014\u2014 \u7C98\u8D34\u5730\u5740\u3001\u62D6\u5165\u63D2\u4EF6/\u7EC4\u5408 .zip\uFF0C\u6216\u8F93\u5165\u540D\u79F0\u4ECE\u63D2\u4EF6\u6E90\u641C\u7D22\u5B89\u88C5\u3002" }) }))] })] }) }), restartPrompt && (_jsx(Dialog, { open: true, onOpenChange: next => { if (!next)
+                    setRestartPrompt(false); }, children: _jsxs(DialogContent, { "aria-describedby": undefined, className: "max-w-sm", children: [_jsx(DialogTitle, { className: "text-base font-medium", children: "\u53D8\u66F4\u5F85\u91CD\u542F\u751F\u6548" }), _jsx("p", { className: "text-sm text-muted-foreground", children: "\u4E1A\u52A1\u5957\u4EF6\u4E0E\u9875\u9762\u7C7B\u63D2\u4EF6\u7684\u542F\u7528\u53D8\u66F4\u5C06\u5728\u4E0B\u6B21\u542F\u52A8\u65F6\u751F\u6548\uFF1B\u63D2\u4EF6\u66F4\u65B0\u6216\u5378\u8F7D\u540E\u7684\u754C\u9762\u6B8B\u7559\u4E5F\u4F1A\u968F\u4E4B\u6D88\u5931\u3002" }), _jsxs(DialogFooter, { children: [_jsx(Button, { variant: "outline", onClick: () => setRestartPrompt(false), children: "\u7A0D\u540E" }), _jsx(Button, { "data-restart-now": true, onClick: () => relaunch(), children: "\u7ACB\u5373\u91CD\u542F" })] })] }) })), confirmed !== undefined && (_jsx(Dialog, { open: true, onOpenChange: next => { if (!next)
+                    setInstallPhase({ phase: 'idle' }); }, children: _jsx(DialogContent, { "aria-describedby": undefined, className: "max-w-sm", children: confirmed.risk ? (_jsxs(_Fragment, { children: [_jsx(DialogTitle, { className: "text-base font-medium", "data-install-risk": true, children: confirmedCombo !== undefined ? '⚠ 此组合含未经发布者验证的插件' : '⚠ 此插件未经发布者验证' }), _jsxs("div", { className: "grid gap-2 text-sm", children: [confirmedPlugin !== undefined && (_jsxs("div", { className: "rounded-md border border-warning/30 bg-warning/10 px-3 py-2 text-sm", children: [_jsx("p", { "data-risk-package": true, className: "font-mono", children: confirmedPlugin.name }), _jsx("p", { className: "mt-1 text-muted-foreground", children: confirmedPlugin.signature.keyId !== undefined
+                                                    ? `签名 keyId ${confirmedPlugin.signature.keyId} 不在本机信任名单中，无法验证发布者。`
+                                                    : '这个包没有携带任何签名，也没有任何完整性校验。' })] })), confirmedCombo !== undefined && (_jsxs("div", { className: "rounded-md border border-warning/30 bg-warning/10 px-3 py-2 text-sm", children: [_jsxs("p", { "data-risk-package": true, className: "font-mono", children: [confirmedCombo.title, " \u00B7 ", confirmedCombo.id] }), _jsx("p", { className: "mt-1 text-muted-foreground", children: "\u7EC4\u5408\u5305\u672C\u8EAB\u6CA1\u6709\u7B7E\u540D\uFF0C\u4EE5\u4E0B\u6210\u5458\u65E0\u6CD5\u9A8C\u8BC1\u53D1\u5E03\u8005\uFF1A" }), _jsx("ul", { className: "mt-1 grid gap-1", children: confirmedCombo.plugins
+                                                    .filter(plugin => plugin.signature.state === 'unverified')
+                                                    .map(plugin => (_jsxs("li", { className: "font-mono text-xs", children: [plugin.name, " \u00B7 ", plugin.signature.keyId ?? '未签名'] }, plugin.name))) })] })), _jsx("p", { className: "text-muted-foreground", children: "\u00B7 \u8BF7\u786E\u8BA4\u63D2\u4EF6\u6765\u6E90\u53EF\u4FE1\u540E\u518D\u7EE7\u7EED\uFF1B\u5B89\u88C5\u540E\u53EF\u5728\u672C\u673A\u4FE1\u4EFB\u6587\u4EF6\u767B\u8BB0\u5176\u516C\u94A5\u3002" })] }), _jsxs(DialogFooter, { children: [_jsx(Button, { variant: "outline", onClick: () => setInstallPhase({ ...confirmed, risk: false }), children: "\u8FD4\u56DE" }), _jsx(Button, { "data-confirm-risk-install": true, onClick: () => runInstall(confirmed.zipPath, confirmed.archive), children: "\u6211\u77E5\u6653\u98CE\u9669\uFF0C\u4ECD\u8981\u5B89\u88C5" })] })] })) : confirmedCombo !== undefined ? (_jsxs(_Fragment, { children: [_jsx(DialogTitle, { className: "text-base font-medium", children: "\u5B89\u88C5\u7EC4\u5408\u5957\u4EF6" }), _jsxs("div", { className: "grid gap-2 text-sm", children: [_jsxs("div", { className: "flex justify-between gap-4", children: [_jsx("span", { className: "text-muted-foreground", children: "\u7EC4\u5408\u540D" }), _jsx("span", { className: "truncate", children: confirmedCombo.title })] }), _jsxs("div", { className: "flex justify-between gap-4", children: [_jsx("span", { className: "text-muted-foreground", children: "\u7EC4\u5408 ID" }), _jsx("span", { className: "truncate font-mono", children: confirmedCombo.id })] }), _jsxs("div", { className: "flex justify-between gap-4", children: [_jsx("span", { className: "text-muted-foreground", children: "\u7248\u672C" }), _jsx("span", { className: "font-mono", children: confirmedCombo.version })] }), confirmedCombo.description !== undefined && (_jsx("p", { className: "text-xs text-muted-foreground", children: confirmedCombo.description })), confirmed.source !== undefined && (_jsxs("div", { className: "flex justify-between gap-4", children: [_jsx("span", { className: "text-muted-foreground", children: "\u6765\u6E90" }), _jsx("span", { children: confirmed.source })] })), _jsx("div", { className: "grid max-h-48 gap-1 overflow-auto rounded-md border border-border px-3 py-2", children: confirmedCombo.plugins.map(plugin => {
+                                            const action = plugin.action === 'install' ? '安装' : plugin.action === 'update' ? '更新' : '保留';
+                                            const unverified = plugin.signature.state === 'unverified';
+                                            return (_jsxs("div", { "data-combo-member": plugin.name, className: "flex items-baseline justify-between gap-3 text-xs", children: [_jsx("span", { className: "truncate", children: plugin.title ?? plugin.name }), _jsxs("span", { className: `shrink-0 font-mono ${unverified ? 'text-warning' : 'text-muted-foreground'}`, children: [plugin.version, " \u00B7 ", action, unverified ? ' · ⚠ 未验证' : ''] })] }, plugin.name));
+                                        }) }), _jsx("p", { className: "text-xs text-muted-foreground", children: "\u7EC4\u5408\u5305\u672C\u8EAB\u4E0D\u7B7E\u540D\uFF1B\u6BCF\u4E2A\u6210\u5458\u90FD\u7ECF\u4E0E\u5355\u63D2\u4EF6\u76F8\u540C\u7684\u7B7E\u540D\u6821\u9A8C\u3002" }), confirmedCombo.missing.length > 0 && (_jsxs("p", { "data-combo-missing": true, className: "rounded-md border border-destructive/50 bg-destructive/10 px-3 py-2 text-sm text-destructive", children: ["\u7F3A\u5C11\u4F9D\u8D56\uFF1A", confirmedCombo.missing.join('、'), "\u2014\u2014\u7EC4\u5408\u4F1A\u7ACB\u5373\u542F\u7528\u5168\u90E8\u884C\uFF0C\u88C5\u9F50\u540E\u518D\u5B89\u88C5\u3002"] })), confirmedCombo.hasClient && (_jsx("p", { className: "text-xs text-muted-foreground", children: "\u7EC4\u5408\u542B\u754C\u9762\u63D2\u4EF6\uFF1B\u88C5\u597D\u540E\u91CD\u542F\u4E00\u6B21\u8BA9\u754C\u9762\u751F\u6548\u3002" }))] }), _jsxs(DialogFooter, { children: [_jsx(Button, { variant: "outline", onClick: () => setInstallPhase({ phase: 'idle' }), children: "\u53D6\u6D88" }), _jsx(Button, { "data-confirm-install-combo": true, disabled: confirmedCombo.missing.length > 0, onClick: () => {
+                                            if (confirmedCombo.plugins.some(plugin => plugin.signature.state === 'unverified')) {
+                                                setInstallPhase({ ...confirmed, risk: true });
+                                                return;
+                                            }
+                                            runInstall(confirmed.zipPath, confirmed.archive);
+                                        }, children: "\u5B89\u88C5\u7EC4\u5408" })] })] })) : confirmedPlugin !== undefined ? (_jsxs(_Fragment, { children: [_jsx(DialogTitle, { className: "text-base font-medium", children: confirmedPlugin.action === 'update' ? '更新插件' : '安装插件' }), _jsxs("div", { className: "grid gap-2 text-sm", children: [confirmedPlugin.title !== undefined && (_jsxs("div", { className: "flex justify-between gap-4", children: [_jsx("span", { className: "text-muted-foreground", children: "\u540D\u79F0" }), _jsx("span", { className: "truncate", children: confirmedPlugin.title })] })), _jsxs("div", { className: "flex justify-between gap-4", children: [_jsx("span", { className: "text-muted-foreground", children: "\u5305\u540D" }), _jsx("span", { className: "truncate font-mono", children: confirmedPlugin.name })] }), confirmedPlugin.action === 'update' ? (_jsxs(_Fragment, { children: [_jsxs("div", { className: "flex justify-between gap-4", children: [_jsx("span", { className: "text-muted-foreground", children: "\u5DF2\u5B89\u88C5\u7248\u672C" }), _jsx("span", { className: "font-mono", children: confirmedPlugin.installed?.version })] }), _jsxs("div", { className: "flex justify-between gap-4", children: [_jsx("span", { className: "text-muted-foreground", children: "\u5C06\u66F4\u65B0\u81F3" }), _jsx("span", { className: "font-mono", children: confirmedPlugin.version })] })] })) : (_jsxs("div", { className: "flex justify-between gap-4", children: [_jsx("span", { className: "text-muted-foreground", children: "\u7248\u672C" }), _jsx("span", { className: "font-mono", children: confirmedPlugin.version })] })), _jsxs("div", { className: "flex justify-between gap-4", children: [_jsx("span", { className: "text-muted-foreground", children: "\u5206\u7C7B" }), _jsx("span", { children: confirmedPlugin.category ?? '其他' })] }), confirmed.source !== undefined && (_jsxs("div", { className: "flex justify-between gap-4", children: [_jsx("span", { className: "text-muted-foreground", children: "\u6765\u6E90" }), _jsx("span", { children: confirmed.source })] })), _jsx(SignatureRow, { signature: confirmedPlugin.signature, directUrl: confirmed.viaUrl }), confirmedPlugin.hasClient && _jsxs("div", { className: "flex justify-between gap-4", children: [_jsx("span", { className: "text-muted-foreground", children: "\u754C\u9762" }), _jsx("span", { children: "\u542B\u9875\u9762" })] }), _jsxs("div", { className: "flex justify-between gap-4", children: [_jsx("span", { className: "text-muted-foreground", children: "\u6743\u9650" }), _jsx("span", { children: confirmedPlugin.permissions.length === 0 ? '无' : confirmedPlugin.permissions.join('、') })] }), confirmedPlugin.missing.length > 0 && (_jsxs("p", { className: "rounded-md border border-destructive/50 bg-destructive/10 px-3 py-2 text-sm text-destructive", children: ["\u5C1A\u672A\u5B89\u88C5\u7684\u4F9D\u8D56\uFF1A", confirmedPlugin.missing.join('、'), "\u2014\u2014\u53EF\u5148\u5B89\u88C5\u672C\u5305\uFF0C\u542F\u7528\u524D\u9700\u88C5\u9F50\u3002"] })), confirmedPlugin.action === 'update' && (_jsx("p", { className: "text-xs text-muted-foreground", children: "\u8986\u76D6\u540E\u4FDD\u7559\u8BE5\u63D2\u4EF6\u7684\u914D\u7F6E\u4E0E\u6570\u636E\uFF1B\u8FD0\u884C\u4E2D\u7684\u754C\u9762\u9700\u91CD\u542F\u540E\u751F\u6548\u3002" })), confirmedPlugin.action === 'blocked' && (_jsxs("p", { "data-install-blocked": true, className: "text-sm text-destructive", children: ["\u5DF2\u5B89\u88C5 v", confirmedPlugin.installed?.version, "\uFF0C\u5B89\u88C5\u5305 v", confirmedPlugin.version, " \u4E0D\u9AD8\u4E8E\u5DF2\u88C5\u7248\u672C\uFF0C\u65E0\u6CD5\u8986\u76D6\uFF08\u5378\u8F7D\u540E\u53EF\u964D\u7EA7\u5B89\u88C5\uFF09\u3002"] }))] }), _jsxs(DialogFooter, { children: [_jsx(Button, { variant: "outline", onClick: () => setInstallPhase({ phase: 'idle' }), children: "\u53D6\u6D88" }), _jsx(Button, { "data-confirm-install": true, disabled: confirmedPlugin.action === 'blocked', onClick: () => {
+                                            if (confirmedPlugin.signature.state === 'unverified') {
+                                                setInstallPhase({ ...confirmed, risk: true });
+                                                return;
+                                            }
+                                            runInstall(confirmed.zipPath, confirmed.archive);
+                                        }, children: confirmedPlugin.action === 'update' ? '更新' : '安装' })] })] })) : null }) })), keyChange !== undefined && (_jsx(Dialog, { open: true, onOpenChange: next => { if (!next)
+                    setKeyChange(undefined); }, children: _jsxs(DialogContent, { "aria-describedby": undefined, className: "max-w-sm", children: [_jsx(DialogTitle, { className: "text-base font-medium", children: "\u53D1\u5E03\u8005\u5BC6\u94A5\u5DF2\u53D8\u66F4" }), _jsxs("div", { className: "grid gap-2 text-sm", children: [_jsxs("p", { className: "text-muted-foreground", children: [_jsx("span", { className: "font-mono text-foreground", children: keyChange.name }), ' ', "\u7684\u65B0\u7248\u672C\u7531\u4E0D\u540C\u7684\u5BC6\u94A5\u7B7E\u540D\u3002\u82E5\u53D1\u5E03\u8005\u786E\u5B9E\u8F6E\u6362\u4E86\u5BC6\u94A5\uFF0C\u66F4\u65B0\u662F\u5B89\u5168\u7684\uFF1B\u5426\u5219\u4E0D\u8981\u7EE7\u7EED\u3002"] }), _jsxs("div", { className: "rounded-md border border-warning/30 bg-warning/10 px-3 py-2", children: [_jsxs("p", { children: ["\u5DF2\u5B89\u88C5 v", keyChange.installedVersion, " \u2192 \u6E90\u4E0A v", keyChange.feedVersion] }), _jsx("p", { className: "mt-1 text-muted-foreground", children: "\u8BF7\u6838\u5BF9\u53D1\u5E03\u8005\u516C\u544A\u4E2D\u7684\u65B0 keyId \u540E\u518D\u51B3\u5B9A\u3002" })] })] }), _jsxs(DialogFooter, { children: [_jsx(Button, { variant: "outline", onClick: () => setKeyChange(undefined), children: "\u53D6\u6D88" }), _jsx(Button, { "data-confirm-key-change": true, onClick: () => updateNow(keyChange.name), children: "\u4ECD\u8981\u66F4\u65B0" })] })] }) })), installPhase.phase === 'error' && (_jsx(Dialog, { open: true, onOpenChange: next => { if (!next)
+                    setInstallPhase({ phase: 'idle' }); }, children: _jsxs(DialogContent, { "aria-describedby": undefined, className: "max-w-sm", children: [_jsx(DialogTitle, { className: "text-base font-medium", children: "\u5B89\u88C5\u5931\u8D25" }), _jsx("p", { "data-install-error": true, className: "text-sm text-destructive", children: installPhase.message }), _jsx(DialogFooter, { children: _jsx(Button, { onClick: () => setInstallPhase({ phase: 'idle' }), children: "\u77E5\u9053\u4E86" }) })] }) })), uninstall.phase === 'confirm' && (_jsx(Dialog, { open: true, onOpenChange: next => { if (!next)
+                    setUninstall({ phase: 'idle' }); }, children: _jsxs(DialogContent, { "aria-describedby": undefined, className: "max-w-sm", children: [_jsx(DialogTitle, { className: "text-base font-medium", children: "\u5378\u8F7D\u63D2\u4EF6" }), _jsxs("p", { className: "text-sm text-muted-foreground", children: ["\u5C06\u4ECE\u63D2\u4EF6\u6C60\u79FB\u9664 ", _jsx("span", { className: "font-mono text-foreground", children: uninstall.pkg }), "\uFF0C\u5176\u6570\u636E\u4E00\u5E76\u5220\u9664\uFF0C\u4E0D\u53EF\u6062\u590D\u3002"] }), _jsxs(DialogFooter, { children: [_jsx(Button, { variant: "outline", onClick: () => setUninstall({ phase: 'idle' }), children: "\u53D6\u6D88" }), _jsx(Button, { variant: "destructive", "data-confirm-uninstall": true, onClick: () => runUninstall(uninstall.pkg), children: "\u5378\u8F7D" })] })] }) })), uninstall.phase === 'error' && (_jsx(Dialog, { open: true, onOpenChange: next => { if (!next)
+                    setUninstall({ phase: 'idle' }); }, children: _jsxs(DialogContent, { "aria-describedby": undefined, className: "max-w-sm", children: [_jsx(DialogTitle, { className: "text-base font-medium", children: "\u5378\u8F7D\u5931\u8D25" }), _jsx("p", { "data-uninstall-error": true, className: "text-sm text-destructive", children: uninstall.message }), _jsx(DialogFooter, { children: _jsx(Button, { onClick: () => setUninstall({ phase: 'idle' }), children: "\u77E5\u9053\u4E86" }) })] }) })), feedDialogOpen && (_jsx(Dialog, { open: true, onOpenChange: next => { if (!next)
+                    setFeedDialogOpen(false); }, children: _jsxs(DialogContent, { "aria-describedby": undefined, className: "max-w-md", children: [_jsx(DialogTitle, { className: "text-base font-medium", children: "\u63D2\u4EF6\u6E90" }), _jsxs("div", { className: "flex flex-col gap-2", children: [_jsx("label", { className: "text-sm text-muted-foreground", htmlFor: "plugin-feed-url", children: "\u641C\u7D22\u4E0E\u5728\u7EBF\u66F4\u65B0\u4F7F\u7528\u7684\u63D2\u4EF6\u6E90\u5217\u8868\uFF1A" }), feedUrls.length === 0 && (_jsx("p", { className: "text-xs text-muted-foreground", children: "\u5C1A\u672A\u6DFB\u52A0\u81EA\u5B9A\u4E49\u6E90\uFF08\u5F53\u524D\u4F7F\u7528\u51FA\u5382\u9ED8\u8BA4\u6E90\uFF09\u3002" })), feedUrls.map((url, index) => (_jsxs("div", { "data-feed-row": url, className: "flex items-center gap-2 rounded-md border border-border px-3 py-2", children: [_jsx("span", { className: "min-w-0 flex-1 truncate font-mono text-xs", children: url }), _jsx(Button, { variant: "ghost", size: "sm", "aria-label": `移除 ${url}`, "data-feed-remove": index, onClick: () => setFeedUrls(current => current.filter((_, at) => at !== index)), children: "\u2715" })] }, url))), _jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Input, { id: "plugin-feed-url", value: feedDraft, placeholder: "https://\u2026\uFF08\u6307\u5411\u542B index.json \u7684\u76EE\u5F55\uFF09", "data-feed-url-input": true, onChange: event => setFeedDraft(event.target.value), onKeyDown: event => { if (event.key === 'Enter')
+                                                appendFeedUrl(); } }), _jsx(Button, { variant: "outline", "data-feed-add": true, onClick: appendFeedUrl, children: "\u6DFB\u52A0\u6E90" })] }), feedError !== undefined && _jsx("p", { className: "text-sm text-destructive", children: feedError }), _jsx("p", { className: "text-xs text-muted-foreground", children: "\u672A\u4FEE\u6539\u65F6\u4F7F\u7528\u51FA\u5382\u9ED8\u8BA4\u6E90\uFF1B\u4FEE\u6539\u540E\u4FDD\u5B58\u5728\u672C\u673A\uFF0C\u4EC5\u5F71\u54CD\u672C\u673A\u3002\u793E\u533A\u63D2\u4EF6\u6E90\u5C31\u662F\u63D2\u4EF6\u4F5C\u8005\u81EA\u5DF1\u4ED3\u5E93\u7684 Release \u5730\u5740\u3002" })] }), _jsxs(DialogFooter, { children: [_jsx(Button, { variant: "outline", onClick: () => setFeedDialogOpen(false), children: "\u53D6\u6D88" }), _jsx(Button, { "data-feed-save": true, onClick: saveFeedUrls, children: "\u4FDD\u5B58" })] })] }) }))] }));
+}

package/lib/types/settings-update-page.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The 软件更新 settings page: one live snapshot of the update channel plus
+ * its two configuration seats. The phase (and progress) arrive as full
+ * `update/status` snapshots, so the view is a pure projection — check /
+ * download / restart-to-install buttons map one-to-one onto the update
+ * domain's methods, and the feed URL / auto-check seats write
+ * `settings.json` keys (hot-applied, no restart).
+ *
+ * @module @snap-rail/framework-shadcn/settings-update-page
+ */
+import '@snap-rail/app-boot/contract';
+import type { Context } from '@snap-rail/cordis';
+import { type ReactNode } from 'react';
+/** The 软件更新 page. */
+export declare function UpdatePage({ ctx }: {
+    ctx: Context;
+}): ReactNode;