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

package/lib/index.js

@@ -0,0 +1,3036 @@
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { Context } from "@snap-rail/cordis";
+import { TimerService } from "@snap-rail/cordis-plugin-timer";
+import { clsx } from "clsx";
+import { twMerge } from "tailwind-merge";
+import { Fragment as Fragment$1, createContext, createElement, forwardRef, useCallback, useContext, useEffect, useRef, useState } from "react";
+import { Slot } from "@radix-ui/react-slot";
+import { cva } from "class-variance-authority";
+import * as SwitchPrimitive from "@radix-ui/react-switch";
+import "@radix-ui/react-tooltip";
+import "@radix-ui/react-scroll-area";
+import * as DialogPrimitive from "@radix-ui/react-dialog";
+import * as LabelPrimitive from "@radix-ui/react-label";
+import "@radix-ui/react-checkbox";
+import * as ProgressPrimitive from "@radix-ui/react-progress";
+import "@radix-ui/react-radio-group";
+import * as TabsPrimitive from "@radix-ui/react-tabs";
+import "@radix-ui/react-collapsible";
+import { z } from "zod";
+import { rpcErrorText, subscribeFrame } from "@snap-rail/connection";
+import { SESSION_OPERATOR_KEY, settingsChangedSchema } from "@snap-rail/station-rpc/contract";
+import { PLUGINS_FEED_URLS_KEY, UPDATE_AUTO_CHECK_KEY, UPDATE_FEED_URL_KEY, pluginUpdatesChangedSchema, updateStatusSchema } from "@snap-rail/app-boot/contract";
+import { equipmentFrameSchemas, pointKey } from "@snap-rail/equipment/contract";
+import { createRoot } from "react-dom/client";
+//#region lib/types/settings-pages.js
+/**
+* Mounts the `ctx.settingsPages` registry. All state lives in
+* construction-time closures: traceable context proxies rebind `this` on
+* every method access, so `this`-reached state cannot back a service here
+* (the uiSlots lesson).
+*/
+const settingsPlugin = {
+	name: "client-settings",
+	apply(ctx) {
+		const pages = /* @__PURE__ */ new Map();
+		let nextSeq = 0;
+		let open = false;
+		let requestedId;
+		const firstId = () => [...pages.values()].sort((a, b) => a.def.order - b.def.order || a.seq - b.seq)[0]?.def.id;
+		const activeId = () => {
+			if (!open) return void 0;
+			if (requestedId !== void 0 && pages.has(requestedId)) return requestedId;
+			return firstId();
+		};
+		const openDialog = (id) => {
+			if (id !== void 0) requestedId = id;
+			if (open && id === void 0) return;
+			open = true;
+			ctx.emit("settings/open-changed");
+		};
+		const closeDialog = () => {
+			if (!open) return;
+			open = false;
+			ctx.emit("settings/open-changed");
+		};
+		ctx.provide("settingsPages", {
+			list() {
+				const current = activeId();
+				return [...pages.values()].sort((a, b) => a.def.order - b.def.order || a.seq - b.seq).map(({ def }) => ({
+					...def,
+					active: def.id === current
+				}));
+			},
+			register(caller, def) {
+				const replaced = pages.has(def.id);
+				pages.set(def.id, {
+					def,
+					seq: nextSeq++
+				});
+				ctx.emit(replaced ? "settings/open-changed" : "settings/pages-changed");
+				const remove = () => {
+					if (pages.delete(def.id)) ctx.emit("settings/pages-changed");
+				};
+				caller.effect(() => remove);
+				return remove;
+			},
+			open: openDialog,
+			close: closeDialog,
+			toggle() {
+				if (open) closeDialog();
+				else openDialog();
+			},
+			isOpen() {
+				return open;
+			},
+			active: activeId
+		});
+	}
+};
+//#endregion
+//#region lib/types/slots.js
+/** Stable semantic slot names shared by every layout implementation. */
+const UI_SLOT_IDS = {
+	layout: "shell.layout",
+	titlebar: "shell.titlebar",
+	titlebarActions: "shell.titlebar.actions",
+	menu: "shell.menu",
+	sidebar: "shell.sidebar",
+	main: "shell.main",
+	view: "shell.view",
+	statusbar: "shell.statusbar",
+	overlay: "shell.overlay"
+};
+/** Runtime set used by manifest/semantic validation as well as TypeScript. */
+const STANDARD_UI_SLOT_IDS = new Set(Object.values(UI_SLOT_IDS));
+/** A custom slot is owned by a publisher and a local slot name. */
+const CUSTOM_UI_SLOT_PATTERN = /^custom:[a-z0-9][a-z0-9-]*\.[a-z0-9][a-z0-9-]*$/;
+/** Check the public slot naming contract at runtime. */
+function isValidUiSlotId(value) {
+	return STANDARD_UI_SLOT_IDS.has(value) || CUSTOM_UI_SLOT_PATTERN.test(value);
+}
+/**
+* The mode table for the standard slots — the framework owns it.
+*
+* `titlebar` and `main` are `single`: exactly one tenant renders (a skin or
+* replacement displaces the default and falls back on unload). `layout`
+* stays `stack` on purpose — the settings dialog is a permanent overlay
+* occupant beside the active layout, and the fallback shell yields by
+* counting; every other slot collects contributions.
+*/
+const UI_SLOT_MODES = {
+	[UI_SLOT_IDS.layout]: "stack",
+	[UI_SLOT_IDS.titlebar]: "single",
+	[UI_SLOT_IDS.titlebarActions]: "stack",
+	[UI_SLOT_IDS.menu]: "stack",
+	[UI_SLOT_IDS.sidebar]: "stack",
+	[UI_SLOT_IDS.main]: "single",
+	[UI_SLOT_IDS.view]: "stack",
+	[UI_SLOT_IDS.statusbar]: "stack",
+	[UI_SLOT_IDS.overlay]: "stack"
+};
+const STANDARD_SLOT_MODES = new Map(Object.entries(UI_SLOT_MODES));
+/** The occupancy mode of a slot; `custom:*` slots are `stack`. */
+function slotModeOf(slot) {
+	return STANDARD_SLOT_MODES.get(slot) ?? "stack";
+}
+/** Mounts the `ctx.uiSlots` registry.
+*
+* The facade binds everything to construction-time closures: traceable
+* context proxies rebind `this` on every method access, so `this`-reached
+* state cannot back a service here (mirrors the field seam's external core).
+*/
+const slotsPlugin = {
+	name: "framework slots",
+	apply(ctx) {
+		const slots = /* @__PURE__ */ new Map();
+		const entryOf = (slot) => {
+			let entry = slots.get(slot);
+			if (entry === void 0) {
+				entry = {
+					occupants: /* @__PURE__ */ new Map(),
+					nextSeq: 0
+				};
+				slots.set(slot, entry);
+			}
+			return entry;
+		};
+		ctx.provide("uiSlots", {
+			list(slot) {
+				const ranked = [...entryOf(slot).occupants.values()].sort((a, b) => a.occupant.order - b.occupant.order || a.seq - b.seq);
+				if (slotModeOf(slot) === "single" && ranked.length > 0) return [ranked.reduce((best, item) => {
+					const byPrecedence = (item.occupant.precedence ?? 0) - (best.occupant.precedence ?? 0);
+					return byPrecedence > 0 || byPrecedence === 0 && item.seq > best.seq ? item : best;
+				}).occupant];
+				return ranked.map((item) => item.occupant);
+			},
+			register(caller, slot, occupant) {
+				const entry = entryOf(slot);
+				entry.occupants.set(occupant.id, {
+					occupant,
+					seq: entry.nextSeq++
+				});
+				ctx.emit("ui/slot-changed", slot);
+				const remove = () => {
+					if (entry.occupants.delete(occupant.id)) ctx.emit("ui/slot-changed", slot);
+				};
+				caller.effect(() => remove);
+				return remove;
+			}
+		});
+	}
+};
+//#endregion
+//#region lib/types/ui/utils.js
+/**
+* Class-name combiner: clsx joins, tailwind-merge resolves conflicting
+* Tailwind utilities with the last one winning — the shadcn convention.
+*
+* @module @snap-rail/framework-shadcn/ui/utils
+*/
+/**
+* Merge conditional class names into one Tailwind-aware string.
+* @param inputs - class values (strings, arrays, conditional objects).
+* @returns the merged class string.
+*/
+function cn(...inputs) {
+	return twMerge(clsx(inputs));
+}
+//#endregion
+//#region lib/types/ui/hooks.js
+/**
+* Shared React recipes over the client runtime's event fabric.
+*
+* @module @snap-rail/framework-shadcn/ui/hooks
+*/
+/**
+* Re-render the component whenever any of the named ctx events fires —
+* the standard "surface follows the seam" tick. The cordis import is
+* type-only: this module stays a pure React utility at runtime.
+*
+* @param ctx - the plugin context whose events drive the refresh.
+* @param events - event names to listen on (identity is not part of the
+* effect key; a freshly built array literal is fine).
+*/
+function useRefresh(ctx, events) {
+	const [, setTick] = useState(0);
+	const key = events.join("\n");
+	useEffect(() => {
+		const bump = () => setTick((value) => value + 1);
+		const detachers = (key === "" ? [] : key.split("\n")).map((event) => ctx.on(event, bump));
+		return () => {
+			for (const detach of detachers) detach();
+		};
+	}, [ctx, key]);
+}
+//#endregion
+//#region lib/types/ui/button.js
+/**
+* Button: cva variants over a native button. Ghost/outline cover chrome
+* surfaces (titlebar, panel toggles); `icon` size squares the padding for
+* glyph-only controls.
+*
+* @module @snap-rail/framework-shadcn/ui/button
+*/
+const buttonVariants = cva("inline-flex items-center justify-center gap-2 whitespace-nowrap rounded-md text-base font-medium transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring disabled:pointer-events-none disabled:opacity-50 [&_svg]:pointer-events-none [&_svg]:shrink-0", {
+	variants: {
+		variant: {
+			default: "bg-primary text-primary-foreground hover:bg-primary/90",
+			destructive: "bg-destructive/90 text-destructive-foreground hover:bg-destructive",
+			outline: "border border-border bg-transparent hover:bg-accent hover:text-accent-foreground",
+			secondary: "bg-secondary text-secondary-foreground hover:bg-secondary/80",
+			ghost: "hover:bg-accent hover:text-accent-foreground",
+			link: "text-primary underline-offset-4 hover:underline"
+		},
+		size: {
+			xl: "h-16 px-8 text-lg",
+			lg: "h-14 px-6 text-lg",
+			default: "h-12 px-5 py-1.5",
+			sm: "h-10 px-4 text-sm",
+			icon: "h-12 w-12"
+		}
+	},
+	defaultVariants: {
+		variant: "default",
+		size: "default"
+	}
+});
+/** A themed button; `asChild` renders the child element instead. */
+function Button({ className, variant, size, asChild = false, ...props }) {
+	return jsx(asChild ? Slot : "button", {
+		className: cn(buttonVariants({
+			variant,
+			size
+		}), className),
+		...props
+	});
+}
+//#endregion
+//#region lib/types/ui/badge.js
+/**
+* Badge: small status/label chip. `success` carries the online/live state,
+* `warning` the attention state (e.g. partial failure, float type),
+* `destructive` the offline/abnormal one.
+*
+* @module @snap-rail/framework-shadcn/ui/badge
+*/
+const badgeVariants = cva("inline-flex items-center gap-1 rounded-md border px-2.5 py-1 text-sm font-medium whitespace-nowrap", {
+	variants: { variant: {
+		default: "border-transparent bg-primary text-primary-foreground",
+		secondary: "border-transparent bg-secondary text-secondary-foreground",
+		success: "border-transparent bg-success/15 text-success",
+		warning: "border-transparent bg-warning/15 text-warning",
+		destructive: "border-transparent bg-destructive/15 text-destructive",
+		outline: "text-muted-foreground"
+	} },
+	defaultVariants: { variant: "default" }
+});
+/** A themed status chip. */
+function Badge({ className, variant, ...props }) {
+	return jsx("span", {
+		className: cn(badgeVariants({ variant }), className),
+		...props
+	});
+}
+//#endregion
+//#region lib/types/ui/switch.js
+/**
+* Switch: the Radix switch with snap-rail chrome — boolean control for
+* toggles like the offline simulation.
+*
+* @module @snap-rail/framework-shadcn/ui/switch
+*/
+/** A themed on/off control. */
+function Switch({ className, ...props }) {
+	return jsx(SwitchPrimitive.Root, {
+		className: cn("peer inline-flex h-6 w-12 shrink-0 cursor-pointer items-center rounded-full border border-transparent transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring disabled:cursor-not-allowed disabled:opacity-50 data-[state=checked]:bg-primary data-[state=unchecked]:bg-secondary", className),
+		...props,
+		children: jsx(SwitchPrimitive.Thumb, { className: "pointer-events-none block h-5 w-5 rounded-full bg-foreground shadow transition-transform data-[state=checked]:translate-x-6 data-[state=unchecked]:translate-x-1" })
+	});
+}
+//#endregion
+//#region lib/types/ui/dialog.js
+/**
+* Dialog: modal overlay + panel over Radix Dialog. Chrome surfaces use it
+* for confirmations (window close, technician id entry); content pages use
+* it for small forms. No built-in close affordance — callers render their
+* own buttons in the footer.
+*
+* @module @snap-rail/framework-shadcn/ui/dialog
+*/
+/** Controlled/uncontrolled root; re-exported so callers need one import. */
+const Dialog = DialogPrimitive.Root;
+/** The overlay + centered panel; mounts through a portal into body. */
+function DialogContent({ className, children, ...props }) {
+	return jsxs(DialogPrimitive.Portal, { children: [jsx(DialogPrimitive.Overlay, { className: "overlay-in fixed inset-0 z-50 bg-background/80 backdrop-blur-[1px]" }), jsx(DialogPrimitive.Content, {
+		className: cn("dialog-in fixed left-1/2 top-1/2 z-50 w-[calc(100%-2.5rem)] max-w-md -translate-x-1/2 -translate-y-1/2", "rounded-lg border border-border bg-card text-card-foreground shadow-xl", "p-5 focus:outline-none", className),
+		...props,
+		children
+	})] });
+}
+/** The dialog's accessible title. */
+const DialogTitle = DialogPrimitive.Title;
+/** Action row (buttons) at the bottom; defaults to right-aligned. */
+function DialogFooter({ className, ...props }) {
+	return jsx("div", {
+		className: cn("mt-5 flex justify-end gap-3", className),
+		...props
+	});
+}
+//#endregion
+//#region lib/types/ui/input.js
+/** A themed text input. */
+function Input({ className, type = "text", ...props }) {
+	return jsx("input", {
+		type,
+		className: cn("flex h-12 w-full rounded-md border border-input bg-transparent px-4 py-2 text-base", "placeholder:text-muted-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", "disabled:cursor-not-allowed disabled:opacity-50", className),
+		...props
+	});
+}
+//#endregion
+//#region lib/types/ui/label.js
+/**
+* Label: form field caption over Radix Label (click focuses the control).
+*
+* @module @snap-rail/framework-shadcn/ui/label
+*/
+/** A themed field label. */
+function Label({ className, ...props }) {
+	return jsx(LabelPrimitive.Root, {
+		className: cn("text-sm font-medium text-muted-foreground select-none", className),
+		...props
+	});
+}
+//#endregion
+//#region lib/types/ui/progress.js
+/**
+* Progress: the Radix progress bar with snap-rail chrome — determinate
+* download/scan progress for long-running host work.
+*
+* @module @snap-rail/framework-shadcn/ui/progress
+*/
+/** A themed linear progress bar (`value` 0–100, `aria-valuenow` included). */
+function Progress({ className, value, ...props }) {
+	const percent = typeof value === "number" ? Math.min(100, Math.max(0, value)) : 0;
+	return jsx(ProgressPrimitive.Root, {
+		className: cn("relative h-2 w-full overflow-hidden rounded-full bg-secondary", className),
+		...props,
+		children: jsx(ProgressPrimitive.Indicator, {
+			className: "h-full w-full rounded-full bg-primary transition-transform",
+			style: { transform: `translateX(-${100 - percent}%)` }
+		})
+	});
+}
+//#endregion
+//#region lib/types/ui/drag-scroll.js
+/**
+* DragScroll: an overflow-auto container that also pans when held and
+* dragged with the mouse (both axes). Touch and pen keep Chromium's native
+* pan, so only mouse pointers are intercepted. A 6px threshold separates a
+* pan from a press; the click that follows a pan is swallowed so dragged
+* rows never fire. DragScrolls nest (a table inside a scrolled page); only
+* the innermost container under the pressed target takes the gesture.
+*
+* @module @snap-rail/framework-shadcn/ui/drag-scroll
+*/
+/** Movement (px) before a held press turns into a pan. */
+const PAN_THRESHOLD = 6;
+/** An auto-scrolling div that pans under a held mouse drag. */
+function DragScroll({ className, children, ...props }) {
+	const container = useRef(null);
+	const pan = useRef(null);
+	const swallowClick = useRef(false);
+	const onPointerDown = (event) => {
+		if (event.pointerType !== "mouse" || event.button !== 0) return;
+		if (container.current === null) return;
+		const innermost = event.target instanceof Element ? event.target.closest("[data-drag-scroll]") : null;
+		if (innermost !== null && innermost !== container.current) return;
+		pan.current = {
+			id: event.pointerId,
+			x: event.clientX,
+			y: event.clientY,
+			moved: false
+		};
+	};
+	const onPointerMove = (event) => {
+		const state = pan.current;
+		if (state === null || state.id !== event.pointerId) return;
+		if (event.buttons === 0) {
+			pan.current = null;
+			return;
+		}
+		const el = container.current;
+		if (el === null) return;
+		const dx = state.x - event.clientX;
+		const dy = state.y - event.clientY;
+		if (!state.moved) {
+			if (Math.hypot(dx, dy) < PAN_THRESHOLD) return;
+			state.moved = true;
+			el.setPointerCapture(event.pointerId);
+			el.dataset.panning = "true";
+		}
+		el.scrollLeft += dx;
+		el.scrollTop += dy;
+		state.x = event.clientX;
+		state.y = event.clientY;
+	};
+	const endPan = (event) => {
+		const state = pan.current;
+		if (state === null || state.id !== event.pointerId) return;
+		pan.current = null;
+		const el = container.current;
+		if (el === null) return;
+		if (state.moved) {
+			if (el.hasPointerCapture(event.pointerId)) el.releasePointerCapture(event.pointerId);
+			delete el.dataset.panning;
+			swallowClick.current = true;
+		}
+	};
+	return jsx("div", {
+		ref: container,
+		"data-drag-scroll": "",
+		className: cn("overflow-auto", className),
+		onPointerDown,
+		onPointerMove,
+		onPointerUp: endPan,
+		onPointerCancel: endPan,
+		onClickCapture: (event) => {
+			if (!swallowClick.current) return;
+			swallowClick.current = false;
+			event.preventDefault();
+			event.stopPropagation();
+		},
+		...props,
+		children
+	});
+}
+//#endregion
+//#region lib/types/ui/table.js
+/** The grid container with a hairline bottom rule; the wrapper pans under
+* a held mouse drag (see {@link DragScroll}). */
+function Table({ className, ...props }) {
+	return jsx(DragScroll, {
+		className: "w-full",
+		children: jsx("table", {
+			className: cn("w-full caption-bottom text-sm", className),
+			...props
+		})
+	});
+}
+/** Header group. */
+function TableHeader({ className, ...props }) {
+	return jsx("thead", {
+		className: cn("[&_tr]:border-b", className),
+		...props
+	});
+}
+/** Body group. */
+function TableBody({ className, ...props }) {
+	return jsx("tbody", {
+		className: cn("[&_tr:last-child]:border-0", className),
+		...props
+	});
+}
+/** One row: hairline separators, hover affordance when interactive. */
+function TableRow({ className, ...props }) {
+	return jsx("tr", {
+		className: cn("border-b border-border transition-colors hover:bg-accent/40 data-[state=selected]:bg-accent", className),
+		...props
+	});
+}
+/** One column head: muted, left-aligned unless overridden. */
+function TableHead({ className, ...props }) {
+	return jsx("th", {
+		className: cn("h-11 px-3 text-left align-middle text-sm font-medium text-muted-foreground", className),
+		...props
+	});
+}
+/** One cell. */
+function TableCell({ className, ...props }) {
+	return jsx("td", {
+		className: cn("px-3 py-3 align-middle", className),
+		...props
+	});
+}
+//#endregion
+//#region lib/types/ui/tabs.js
+/**
+* Tabs: themed pager over Radix Tabs (list, trigger, content). Icons are
+* inline strokes so the UI seam needs no icon dependency.
+*
+* @module @snap-rail/framework-shadcn/ui/tabs
+*/
+/** Controlled/uncontrolled root; re-exported so callers need one import. */
+const Tabs = TabsPrimitive.Root;
+/** The tab strip; triggers rest on the muted surface, the active one lifts. */
+function TabsList({ className, ...props }) {
+	return jsx(TabsPrimitive.List, {
+		className: cn("inline-flex h-12 items-center gap-1 rounded-lg bg-muted p-1 text-muted-foreground", className),
+		...props
+	});
+}
+/** One tab button; the data attributes carry the active/hover styling. */
+function TabsTrigger({ className, ...props }) {
+	return jsx(TabsPrimitive.Trigger, {
+		className: cn("inline-flex items-center gap-1.5 whitespace-nowrap rounded-md px-5 py-1.5 text-base font-medium", "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", "disabled:pointer-events-none disabled:opacity-50", "data-[state=active]:bg-background data-[state=active]:text-foreground data-[state=active]:shadow-sm", className),
+		...props
+	});
+}
+//#endregion
+//#region lib/types/ui/theme.js
+/**
+* Theme settings: the `ui.theme` settings.json row (a mode choice — the
+* cobalt accent is fixed per mode) and its DOM application. The renderer
+* resident that owns the 主题 settings page reads and writes the row; the
+* `settings/changed` frame hot-applies it on every surface without a
+* restart.
+*
+* @module @snap-rail/framework-shadcn/ui/theme
+*/
+/** settings.json key carrying the theme row. */
+const THEME_SETTINGS_KEY = "ui.theme";
+/** The theme row; invalid stored rows fall back to {@link DEFAULT_THEME}. */
+const themeSettingsSchema = z.object({ mode: z.enum([
+	"system",
+	"light",
+	"dark"
+]) });
+/** Applied before any settings arrive; keeps the terminal dark as before. */
+const DEFAULT_THEME = { mode: "dark" };
+/** The mode a setting resolves to (`system` consults the OS preference). */
+function resolveThemeMode(mode, prefersLight) {
+	if (mode === "system") return prefersLight ? "light" : "dark";
+	return mode;
+}
+/** Apply a theme row: sets `data-mode` on the document element (the token
+* blocks in theme.css key off it). A missing matchMedia — as in tests —
+* resolves `system` to dark. */
+function applyTheme(document, theme) {
+	const view = document.defaultView;
+	const prefersLight = view !== null && typeof view.matchMedia === "function" && view.matchMedia("(prefers-color-scheme: light)").matches;
+	document.documentElement.dataset.mode = resolveThemeMode(theme.mode, prefersLight);
+}
+//#endregion
+//#region lib/types/fallback.js
+/** The settings dialog's occupant id (a Dialog portal, not a layout). */
+const SETTINGS_OCCUPANT_ID = "settings-dialog";
+/** Window-control glyphs; inline so the shell needs no icon dependency. */
+function ControlIcons(props) {
+	const base = "flex h-10 w-10 items-center justify-center text-muted-foreground transition-colors hover:bg-accent hover:text-accent-foreground";
+	return jsxs("div", {
+		className: "flex items-center",
+		children: [
+			jsx("button", {
+				type: "button",
+				"aria-label": "最小化",
+				className: base,
+				onClick: props.onMinimize,
+				children: jsx("svg", {
+					viewBox: "0 0 12 12",
+					className: "h-3 w-3",
+					fill: "none",
+					children: jsx("path", {
+						d: "M2 6h8",
+						stroke: "currentColor",
+						strokeWidth: "1.4"
+					})
+				})
+			}),
+			jsx("button", {
+				type: "button",
+				"aria-label": "最大化",
+				className: base,
+				onClick: props.onToggleMaximize,
+				children: jsx("svg", {
+					viewBox: "0 0 12 12",
+					className: "h-3 w-3",
+					fill: "none",
+					children: jsx("rect", {
+						x: "2.5",
+						y: "2.5",
+						width: "7",
+						height: "7",
+						stroke: "currentColor",
+						strokeWidth: "1.2"
+					})
+				})
+			}),
+			jsx("button", {
+				type: "button",
+				"aria-label": "关闭",
+				className: `${base} hover:bg-destructive hover:text-white`,
+				onClick: props.onClose,
+				children: jsx("svg", {
+					viewBox: "0 0 12 12",
+					className: "h-3 w-3",
+					fill: "none",
+					children: jsx("path", {
+						d: "m3 3 6 6M9 3l-6 6",
+						stroke: "currentColor",
+						strokeWidth: "1.4"
+					})
+				})
+			})
+		]
+	});
+}
+/** The fallback body: minimal titlebar + install guidance. */
+function FallbackShell(props) {
+	useRefresh(props.ctx, ["ui/slot-changed", "settings/open-changed"]);
+	if (props.ctx.uiSlots.list(UI_SLOT_IDS.layout).filter((occupant) => occupant.id !== SETTINGS_OCCUPANT_ID).length > 1) return null;
+	const windowControl = (action) => {
+		props.link.call("window.control", { action }).catch(() => void 0);
+	};
+	return jsxs("div", {
+		className: "flex h-full flex-col",
+		"data-region": "fallback-shell",
+		children: [jsxs("div", {
+			className: "flex h-10 shrink-0 items-center justify-between border-b border-border pl-4 select-none",
+			style: { WebkitAppRegion: "drag" },
+			children: [jsx("span", {
+				className: "text-sm text-muted-foreground",
+				children: "snap-rail"
+			}), jsxs("div", {
+				className: "flex items-center",
+				style: { WebkitAppRegion: "no-drag" },
+				children: [
+					props.ctx.uiSlots.list(UI_SLOT_IDS.titlebarActions).map((occupant) => jsx(Fragment$1, { children: occupant.render() }, occupant.id)),
+					jsx("button", {
+						type: "button",
+						"aria-label": "设置",
+						className: "flex h-10 w-10 items-center justify-center text-muted-foreground transition-colors hover:bg-accent hover:text-accent-foreground",
+						onClick: () => props.ctx.settingsPages.open(),
+						children: jsxs("svg", {
+							viewBox: "0 0 24 24",
+							className: "h-5 w-5",
+							fill: "none",
+							stroke: "currentColor",
+							strokeWidth: "1.6",
+							children: [jsx("circle", {
+								cx: "12",
+								cy: "12",
+								r: "3.2"
+							}), jsx("path", { d: "M19.4 15a1.7 1.7 0 0 0 .34 1.87l.06.06a2 2 0 1 1-2.83 2.83l-.06-.06a1.7 1.7 0 0 0-1.87-.34 1.7 1.7 0 0 0-1 1.55V21a2 2 0 1 1-4 0v-.09a1.7 1.7 0 0 0-1-1.55 1.7 1.7 0 0 0-1.87.34l-.06.06a2 2 0 1 1-2.83-2.83l.06-.06a1.7 1.7 0 0 0 .34-1.87 1.7 1.7 0 0 0-1.55-1H3a2 2 0 1 1 0-4h.09a1.7 1.7 0 0 0 1.55-1 1.7 1.7 0 0 0-.34-1.87l-.06-.06a2 2 0 1 1 2.83-2.83l.06.06a1.7 1.7 0 0 0 1.87.34h0a1.7 1.7 0 0 0 1-1.55V3a2 2 0 1 1 4 0v.09a1.7 1.7 0 0 0 1 1.55h0a1.7 1.7 0 0 0 1.87-.34l.06-.06a2 2 0 1 1 2.83 2.83l-.06.06a1.7 1.7 0 0 0-.34 1.87v0a1.7 1.7 0 0 0 1.55 1H21a2 2 0 1 1 0 4h-.09a1.7 1.7 0 0 0-1.55 1Z" })]
+						})
+					}),
+					jsx(ControlIcons, {
+						onMinimize: () => windowControl("minimize"),
+						onToggleMaximize: () => windowControl("toggle-maximize"),
+						onClose: () => windowControl("close")
+					})
+				]
+			})]
+		}), jsx("div", {
+			className: "flex min-h-0 flex-1 items-center justify-center p-6",
+			children: jsxs("div", {
+				className: "grid max-w-md gap-4 text-center",
+				children: [
+					jsx("div", {
+						className: "text-xl font-medium text-foreground",
+						children: "尚未激活业务套件"
+					}),
+					jsx("p", {
+						className: "text-sm text-muted-foreground",
+						children: "打开设置的「插件管理」页，安装并激活一个业务套件；通讯驱动也在同一处安装。"
+					}),
+					jsx("div", { children: jsx(Button, {
+						"data-fallback-open-settings": true,
+						onClick: () => props.ctx.settingsPages.open(),
+						children: "打开设置"
+					}) })
+				]
+			})
+		})]
+	});
+}
+/** The fallback shell occupant. */
+const fallbackShellPlugin = {
+	name: "framework fallback",
+	inject: ["uiSlots", "settingsPages"],
+	apply(ctx) {
+		const client = ctx.get("client");
+		ctx.uiSlots.register(ctx, UI_SLOT_IDS.layout, {
+			id: "fallback-shell",
+			order: 200,
+			render() {
+				return jsx(FallbackShell, {
+					ctx,
+					link: client.link
+				});
+			}
+		});
+	}
+};
+//#endregion
+//#region lib/types/semantic.js
+/** Mount the semantic contribution registry on top of the slot registry. */
+const semanticPlugin = {
+	name: "framework semantic ui contract",
+	inject: ["uiSlots"],
+	apply(ctx) {
+		const slots = ctx.uiSlots;
+		const views = /* @__PURE__ */ new Map();
+		const layouts = /* @__PURE__ */ new Map();
+		const navigation = /* @__PURE__ */ new Map();
+		let sequence = 0;
+		const ordered = (values) => [...values].sort((a, b) => a.value.order - b.value.order || a.seq - b.seq).map((item) => item.value);
+		const register = (table, caller, id, value, disposeSlot) => {
+			table.set(id, {
+				value,
+				seq: sequence++
+			});
+			const kind = table === views ? "view" : table === layouts ? "layout" : "navigation";
+			ctx.emit("ui/semantic-changed", kind);
+			const remove = () => {
+				if (!table.delete(id)) return;
+				disposeSlot?.();
+				ctx.emit("ui/semantic-changed", kind);
+			};
+			caller.effect(() => remove);
+			return remove;
+		};
+		const validateSlot = (kind, id, slot) => {
+			if (!isValidUiSlotId(slot)) ctx.emit("ui/semantic-invalid", kind, id, slot);
+		};
+		ctx.provide("uiContract", {
+			registerView(caller, contribution) {
+				validateSlot("view", contribution.id, contribution.slot);
+				const disposeSlot = slots.register(caller, contribution.slot, contribution);
+				return register(views, caller, contribution.id, contribution, disposeSlot);
+			},
+			registerLayout(caller, contribution) {
+				for (const slot of contribution.slots) validateSlot("layout", contribution.id, slot);
+				const disposeSlot = slots.register(caller, UI_SLOT_IDS.layout, contribution);
+				return register(layouts, caller, contribution.id, contribution, disposeSlot);
+			},
+			registerNavigation(caller, contribution) {
+				return register(navigation, caller, contribution.id, contribution);
+			},
+			listViews: () => ordered(views.values()),
+			listLayouts: () => ordered(layouts.values()),
+			listNavigation: () => ordered(navigation.values())
+		});
+	}
+};
+//#endregion
+//#region ../../node_modules/.pnpm/lucide-react@1.34.0_react@19.2.8/node_modules/lucide-react/dist/esm/shared/src/utils/mergeClasses.mjs
+/**
+* @license lucide-react v1.34.0 - ISC
+*
+* This source code is licensed under the ISC license.
+* See the LICENSE file in the root directory of this source tree.
+*/
+const mergeClasses = (...classes) => classes.filter((className, index, array) => {
+	return Boolean(className) && className.trim() !== "" && array.indexOf(className) === index;
+}).join(" ").trim();
+//#endregion
+//#region ../../node_modules/.pnpm/lucide-react@1.34.0_react@19.2.8/node_modules/lucide-react/dist/esm/shared/src/utils/toKebabCase.mjs
+/**
+* @license lucide-react v1.34.0 - ISC
+*
+* This source code is licensed under the ISC license.
+* See the LICENSE file in the root directory of this source tree.
+*/
+const toKebabCase = (string) => string.replace(/([a-z0-9])([A-Z])/g, "$1-$2").toLowerCase();
+//#endregion
+//#region ../../node_modules/.pnpm/lucide-react@1.34.0_react@19.2.8/node_modules/lucide-react/dist/esm/shared/src/utils/toCamelCase.mjs
+/**
+* @license lucide-react v1.34.0 - ISC
+*
+* This source code is licensed under the ISC license.
+* See the LICENSE file in the root directory of this source tree.
+*/
+const toCamelCase = (string) => string.replace(/^([A-Z])|[\s-_]+(\w)/g, (match, p1, p2) => p2 ? p2.toUpperCase() : p1.toLowerCase());
+//#endregion
+//#region ../../node_modules/.pnpm/lucide-react@1.34.0_react@19.2.8/node_modules/lucide-react/dist/esm/shared/src/utils/toPascalCase.mjs
+/**
+* @license lucide-react v1.34.0 - ISC
+*
+* This source code is licensed under the ISC license.
+* See the LICENSE file in the root directory of this source tree.
+*/
+const toPascalCase = (string) => {
+	const camelCase = toCamelCase(string);
+	return camelCase.charAt(0).toUpperCase() + camelCase.slice(1);
+};
+//#endregion
+//#region ../../node_modules/.pnpm/lucide-react@1.34.0_react@19.2.8/node_modules/lucide-react/dist/esm/defaultAttributes.mjs
+/**
+* @license lucide-react v1.34.0 - ISC
+*
+* This source code is licensed under the ISC license.
+* See the LICENSE file in the root directory of this source tree.
+*/
+var defaultAttributes = {
+	xmlns: "http://www.w3.org/2000/svg",
+	width: 24,
+	height: 24,
+	viewBox: "0 0 24 24",
+	fill: "none",
+	stroke: "currentColor",
+	strokeWidth: 2,
+	strokeLinecap: "round",
+	strokeLinejoin: "round"
+};
+//#endregion
+//#region ../../node_modules/.pnpm/lucide-react@1.34.0_react@19.2.8/node_modules/lucide-react/dist/esm/shared/src/utils/hasA11yProp.mjs
+/**
+* @license lucide-react v1.34.0 - ISC
+*
+* This source code is licensed under the ISC license.
+* See the LICENSE file in the root directory of this source tree.
+*/
+const hasA11yProp = (props) => {
+	for (const prop in props) if (prop.startsWith("aria-") || prop === "role" || prop === "title") return true;
+	return false;
+};
+//#endregion
+//#region ../../node_modules/.pnpm/lucide-react@1.34.0_react@19.2.8/node_modules/lucide-react/dist/esm/context.mjs
+/**
+* @license lucide-react v1.34.0 - ISC
+*
+* This source code is licensed under the ISC license.
+* See the LICENSE file in the root directory of this source tree.
+*/
+const LucideContext = createContext({});
+const useLucideContext = () => useContext(LucideContext);
+//#endregion
+//#region ../../node_modules/.pnpm/lucide-react@1.34.0_react@19.2.8/node_modules/lucide-react/dist/esm/Icon.mjs
+/**
+* @license lucide-react v1.34.0 - ISC
+*
+* This source code is licensed under the ISC license.
+* See the LICENSE file in the root directory of this source tree.
+*/
+const Icon = forwardRef(({ color, size, strokeWidth, absoluteStrokeWidth, className = "", children, iconNode, ...rest }, ref) => {
+	const { size: contextSize = 24, strokeWidth: contextStrokeWidth = 2, absoluteStrokeWidth: contextAbsoluteStrokeWidth = false, color: contextColor = "currentColor", className: contextClass = "" } = useLucideContext() ?? {};
+	const calculatedStrokeWidth = absoluteStrokeWidth ?? contextAbsoluteStrokeWidth ? Number(strokeWidth ?? contextStrokeWidth) * 24 / Number(size ?? contextSize) : strokeWidth ?? contextStrokeWidth;
+	return createElement("svg", {
+		ref,
+		...defaultAttributes,
+		width: size ?? contextSize ?? defaultAttributes.width,
+		height: size ?? contextSize ?? defaultAttributes.height,
+		stroke: color ?? contextColor,
+		strokeWidth: calculatedStrokeWidth,
+		className: mergeClasses("lucide", contextClass, className),
+		...!children && !hasA11yProp(rest) && { "aria-hidden": "true" },
+		...rest
+	}, [...iconNode.map(([tag, attrs]) => createElement(tag, attrs)), ...Array.isArray(children) ? children : [children]]);
+});
+//#endregion
+//#region ../../node_modules/.pnpm/lucide-react@1.34.0_react@19.2.8/node_modules/lucide-react/dist/esm/createLucideIcon.mjs
+/**
+* @license lucide-react v1.34.0 - ISC
+*
+* This source code is licensed under the ISC license.
+* See the LICENSE file in the root directory of this source tree.
+*/
+const createLucideIcon = (iconName, iconNode) => {
+	const Component = forwardRef(({ className, ...props }, ref) => createElement(Icon, {
+		ref,
+		iconNode,
+		className: mergeClasses(`lucide-${toKebabCase(toPascalCase(iconName))}`, `lucide-${iconName}`, className),
+		...props
+	}));
+	Component.displayName = toPascalCase(iconName);
+	return Component;
+};
+/**
+* @license lucide-react v1.34.0 - ISC
+*
+* This source code is licensed under the ISC license.
+* See the LICENSE file in the root directory of this source tree.
+*/
+const RefreshCw = createLucideIcon("refresh-cw", [
+	["path", {
+		d: "M3 12a9 9 0 0 1 9-9 9.75 9.75 0 0 1 6.74 2.74L21 8",
+		key: "v9h5vc"
+	}],
+	["path", {
+		d: "M21 3v5h-5",
+		key: "1q7to0"
+	}],
+	["path", {
+		d: "M21 12a9 9 0 0 1-9 9 9.75 9.75 0 0 1-6.74-2.74L3 16",
+		key: "3uifl3"
+	}],
+	["path", {
+		d: "M8 16H3v5",
+		key: "1cv678"
+	}]
+]);
+/**
+* @license lucide-react v1.34.0 - ISC
+*
+* This source code is licensed under the ISC license.
+* See the LICENSE file in the root directory of this source tree.
+*/
+const Rss = createLucideIcon("rss", [
+	["path", {
+		d: "M4 11a9 9 0 0 1 9 9",
+		key: "pv89mb"
+	}],
+	["path", {
+		d: "M4 4a16 16 0 0 1 16 16",
+		key: "k0647b"
+	}],
+	["circle", {
+		cx: "5",
+		cy: "19",
+		r: "1",
+		key: "bfqh0e"
+	}]
+]);
+/**
+* @license lucide-react v1.34.0 - ISC
+*
+* This source code is licensed under the ISC license.
+* See the LICENSE file in the root directory of this source tree.
+*/
+const Search = createLucideIcon("search", [["path", {
+	d: "m21 21-4.34-4.34",
+	key: "14j7rj"
+}], ["circle", {
+	cx: "11",
+	cy: "11",
+	r: "8",
+	key: "4ej97u"
+}]]);
+/**
+* @license lucide-react v1.34.0 - ISC
+*
+* This source code is licensed under the ISC license.
+* See the LICENSE file in the root directory of this source tree.
+*/
+const X = createLucideIcon("x", [["path", {
+	d: "M18 6 6 18",
+	key: "1bl5f8"
+}], ["path", {
+	d: "m6 6 12 12",
+	key: "d8bk6v"
+}]]);
+//#endregion
+//#region lib/types/settings-plugins-page.js
+/** 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: "签名"
+		}), jsxs("span", { children: ["✓ 已验证", signature.publisher !== void 0 ? ` · ${signature.publisher}` : ` · ${signature.keyId}`] })]
+	});
+	const detail = signature.keyId !== void 0 ? `未验证 · 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: "签名"
+		}), jsxs("span", { children: [
+			"⚠ ",
+			detail,
+			directUrl ? " · 直链无完整性校验" : ""
+		] })]
+	});
+}
+/** Kind → display label; shared with the search results' rows. */
+const KIND_LABELS = {
+	suite: "业务套件",
+	driver: "通讯驱动",
+	plugin: "插件"
+};
+/** 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 !== void 0) 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. */
+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(/* @__PURE__ */ new Set());
+	const [restartPrompt, setRestartPrompt] = useState(false);
+	const [uninstall, setUninstall] = useState({ phase: "idle" });
+	const [installPhase, setInstallPhase] = useState({ phase: "idle" });
+	const [query, setQuery] = useState("");
+	const [searchResults, setSearchResults] = useState(void 0);
+	const [searching, setSearching] = useState(false);
+	const [actionError, setActionError] = useState(void 0);
+	/** The name whose update click is in flight (version pill busy state). */
+	const [updatingName, setUpdatingName] = useState(void 0);
+	/** The pending update whose click hit a key change — confirmed before the
+	* install fires. */
+	const [keyChange, setKeyChange] = useState(void 0);
+	const [feedDialogOpen, setFeedDialogOpen] = useState(false);
+	const [feedUrls, setFeedUrls] = useState([]);
+	const [feedDraft, setFeedDraft] = useState("");
+	const [feedError, setFeedError] = useState(void 0);
+	/** Pending updates by package name (drives the version pills). */
+	const [updates, setUpdates] = useState(/* @__PURE__ */ new Map());
+	const [dragging, setDragging] = useState(false);
+	const link = ctx.get("client").link;
+	const reload = useCallback(() => {
+		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 !== void 0 ? { kind: info.kind } : {},
+				...info.version !== void 0 ? { version: info.version } : {},
+				...info.title !== void 0 ? { title: info.title } : {},
+				...info.category !== void 0 ? { category: info.category } : {},
+				...info.clientOnly ? { clientOnly: true } : {}
+			})));
+			else setFailed(true);
+		}).catch(() => setFailed(true));
+		link.call("client-config.list", {}).then((result) => {
+			if (result.ok) setRendererNames(result.value.rows.map((row) => row.name));
+		}).catch(() => void 0);
+		link.call("plugins.updates-check", {}).then((result) => {
+			if (result.ok) setUpdates(new Map(result.value.updates.map((update) => [update.name, update])));
+		}).catch(() => void 0);
+	}, [link]);
+	useEffect(() => {
+		reload();
+		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(() => void 0);
+	}, [reload]);
+	useEffect(() => {
+		const detach = subscribeFrame(link, "plugins/updates-changed", pluginUpdatesChangedSchema, (change) => {
+			setUpdates(new Map(change.updates.map((update) => [update.name, update])));
+		});
+		return () => {
+			detach();
+		};
+	}, [link]);
+	const toggle = (name, enabled) => {
+		setRows((current) => current.map((row) => row.name === name ? {
+			...row,
+			enabled
+		} : row));
+		if (rendererNames.includes(name)) {
+			setTouched((current) => /* @__PURE__ */ new Set([...current, name]));
+			setRestartPrompt(true);
+		}
+		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) => {
+		link.call("plugins.uninstall", { name: pkg }).then((result) => {
+			if (!result.ok) {
+				setUninstall({
+					phase: "error",
+					message: rpcErrorText(result.error)
+				});
+				return;
+			}
+			setUninstall({ phase: "idle" });
+			reload();
+			if (rendererNames.includes(pkg)) {
+				setTouched((current) => /* @__PURE__ */ 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) => /* @__PURE__ */ 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" });
+		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" });
+		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 !== void 0 ? { source } : {},
+				risk: false
+			});
+		}).catch((cause) => setInstallPhase({
+			phase: "error",
+			message: String(cause)
+		}));
+	};
+	const runInstall = (zipPath, archive) => {
+		setInstallPhase({ phase: "installing" });
+		if (archive.kind === "combo") {
+			link.call("plugins.install-combo", { zipPath }).then((result) => {
+				if (!result.ok) {
+					setInstallPhase({
+						phase: "error",
+						message: rpcErrorText(result.error)
+					});
+					return;
+				}
+				setInstallPhase({ phase: "idle" });
+				reload();
+				if (archive.combo.hasClient) setRestartPrompt(true);
+			}).catch((cause) => setInstallPhase({
+				phase: "error",
+				message: String(cause)
+			}));
+			return;
+		}
+		link.call("plugins.install", { zipPath }).then((result) => {
+			if (!result.ok) {
+				setInstallPhase({
+					phase: "error",
+					message: rpcErrorText(result.error)
+				});
+				return;
+			}
+			setInstallPhase({ phase: "idle" });
+			reload();
+			markRestartIfNeeded(result.value.installed.name, result.value.installed.updated);
+		}).catch((cause) => setInstallPhase({
+			phase: "error",
+			message: String(cause)
+		}));
+	};
+	const pickZip = () => {
+		link.call("window.pick-zip", { title: "选择插件包或组合包" }).then((result) => {
+			if (!result.ok || result.value === null) return;
+			inspectPath(result.value);
+		}).catch(() => void 0);
+	};
+	/** The tri-form input: address/path → inspect, anything else → feed search. */
+	const submitQuery = () => {
+		const text = query.trim();
+		if (text === "") return;
+		setActionError(void 0);
+		if (isHttpUrl(text)) {
+			inspectFromUrl(text);
+			return;
+		}
+		if (looksLikePath(text)) {
+			inspectPath(text);
+			return;
+		}
+		runSearch(text);
+	};
+	const runSearch = (text) => {
+		setSearching(true);
+		setSearchResults(void 0);
+		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 !== void 0) {
+			inspectFromUrl(item.url, item.source);
+			return;
+		}
+		if (item.feedUrl === void 0 || item.file === void 0) 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(void 0);
+		setUpdatingName(name);
+		setActionError(void 0);
+		link.call("plugins.remote-install", { name }).then((result) => {
+			setUpdatingName(void 0);
+			if (!result.ok) {
+				setActionError(rpcErrorText(result.error));
+				return;
+			}
+			reload();
+			markRestartIfNeeded(result.value.installed.name, result.value.installed.updated);
+		}).catch(() => setUpdatingName(void 0));
+	};
+	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(void 0);
+		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(void 0);
+		setFeedDraft("");
+		setFeedUrls((current) => current.includes(value) ? current : [...current, value]);
+	};
+	const onDrop = (event) => {
+		event.preventDefault();
+		setDragging(false);
+		const file = event.dataTransfer.files[0];
+		if (file === void 0) return;
+		if (!file.name.toLowerCase().endsWith(".zip")) {
+			setActionError("只支持 .zip 插件包或组合包");
+			return;
+		}
+		const zipPath = droppedZipPath(file);
+		if (zipPath === null) {
+			setActionError("当前环境不支持拖拽安装（缺少路径桥）");
+			return;
+		}
+		inspectPath(zipPath);
+	};
+	const relaunch = () => {
+		link.call("window.relaunch", {}).catch(() => void 0);
+	};
+	if (failed) return jsx("div", {
+		className: "text-sm text-muted-foreground",
+		children: "插件列表读取失败。"
+	});
+	const needsRestart = (name) => touched.has(name);
+	const listed = rows.filter((row) => row.source !== "builtin");
+	const confirmed = installPhase.phase === "confirm" ? installPhase : void 0;
+	const confirmedPlugin = confirmed?.archive.kind === "plugin" ? confirmed.archive.plugin : void 0;
+	const confirmedCombo = confirmed?.archive.kind === "combo" ? confirmed.archive.combo : void 0;
+	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: "松开以安装插件包或组合包（.zip）"
+				})
+			}),
+			jsxs("div", {
+				className: "flex items-center gap-2",
+				children: [
+					jsx(Button, {
+						variant: "ghost",
+						size: "icon",
+						"aria-label": "配置插件源",
+						"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: "粘贴本地/网络地址安装，或输入名称搜索…",
+						"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: "选择文件"
+					})
+				]
+			}),
+			actionError !== void 0 && jsx("p", {
+				"data-plugin-action-error": true,
+				className: "text-sm text-destructive",
+				children: actionError
+			}),
+			searchResults !== void 0 && 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: [
+								"搜索“",
+								query.trim(),
+								"”（",
+								searchResults.length,
+								"）"
+							]
+						}), jsx(Button, {
+							variant: "ghost",
+							size: "sm",
+							"aria-label": "关闭搜索结果",
+							onClick: () => setSearchResults(void 0),
+							children: "✕"
+						})]
+					}),
+					searchResults.length === 0 && jsx("p", {
+						className: "py-2 text-center text-sm text-muted-foreground",
+						children: "没有匹配的插件（插件源中没有该名称的条目）。"
+					}),
+					searchResults.map((item) => {
+						const pillUpdate = item.action === "update" && item.installed !== void 0 ? {
+							name: item.name,
+							installedVersion: item.installed.version,
+							feedVersion: item.version,
+							...item.source !== void 0 ? { title: item.source } : {}
+						} : void 0;
+						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 !== void 0 && jsx(Badge, {
+												variant: "secondary",
+												children: KIND_LABELS[item.kind] ?? item.kind
+											}),
+											item.source !== void 0 && 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,
+											" · ",
+											item.version
+										]
+									}),
+									item.description !== void 0 && 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: "安装"
+							}) : pillUpdate !== void 0 ? 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: [
+					"已安装插件（",
+					listed.length,
+					"）"
+				]
+			}),
+			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: "启用"
+						}),
+						jsx(TableHead, { children: "名称" }),
+						jsx(TableHead, { children: "标识" }),
+						jsx(TableHead, {
+							className: "w-24",
+							children: "分类"
+						}),
+						jsx(TableHead, {
+							className: "w-36",
+							children: "版本"
+						}),
+						jsx(TableHead, {
+							className: "w-24",
+							children: "操作"
+						})
+					] }) }), 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: "待重启"
+									})]
+								}) }),
+								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: "卸载"
+								}) : jsx("span", {
+									className: "text-xs text-muted-foreground",
+									children: "—"
+								}) })
+							]
+						}, row.name);
+					}), listed.length === 0 && jsx(TableRow, { children: jsx(TableCell, {
+						colSpan: 6,
+						className: "py-8 text-center text-sm text-muted-foreground",
+						children: "暂无已安装插件 —— 粘贴地址、拖入插件/组合 .zip，或输入名称从插件源搜索安装。"
+					}) })] })]
+				})
+			}),
+			restartPrompt && jsx(Dialog, {
+				open: true,
+				onOpenChange: (next) => {
+					if (!next) setRestartPrompt(false);
+				},
+				children: jsxs(DialogContent, {
+					"aria-describedby": void 0,
+					className: "max-w-sm",
+					children: [
+						jsx(DialogTitle, {
+							className: "text-base font-medium",
+							children: "变更待重启生效"
+						}),
+						jsx("p", {
+							className: "text-sm text-muted-foreground",
+							children: "业务套件与页面类插件的启用变更将在下次启动时生效；插件更新或卸载后的界面残留也会随之消失。"
+						}),
+						jsxs(DialogFooter, { children: [jsx(Button, {
+							variant: "outline",
+							onClick: () => setRestartPrompt(false),
+							children: "稍后"
+						}), jsx(Button, {
+							"data-restart-now": true,
+							onClick: () => relaunch(),
+							children: "立即重启"
+						})] })
+					]
+				})
+			}),
+			confirmed !== void 0 && jsx(Dialog, {
+				open: true,
+				onOpenChange: (next) => {
+					if (!next) setInstallPhase({ phase: "idle" });
+				},
+				children: jsx(DialogContent, {
+					"aria-describedby": void 0,
+					className: "max-w-sm",
+					children: confirmed.risk ? jsxs(Fragment, { children: [
+						jsx(DialogTitle, {
+							className: "text-base font-medium",
+							"data-install-risk": true,
+							children: confirmedCombo !== void 0 ? "⚠ 此组合含未经发布者验证的插件" : "⚠ 此插件未经发布者验证"
+						}),
+						jsxs("div", {
+							className: "grid gap-2 text-sm",
+							children: [
+								confirmedPlugin !== void 0 && 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 !== void 0 ? `签名 keyId ${confirmedPlugin.signature.keyId} 不在本机信任名单中，无法验证发布者。` : "这个包没有携带任何签名，也没有任何完整性校验。"
+									})]
+								}),
+								confirmedCombo !== void 0 && 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,
+												" · ",
+												confirmedCombo.id
+											]
+										}),
+										jsx("p", {
+											className: "mt-1 text-muted-foreground",
+											children: "组合包本身没有签名，以下成员无法验证发布者："
+										}),
+										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,
+													" · ",
+													plugin.signature.keyId ?? "未签名"
+												]
+											}, plugin.name))
+										})
+									]
+								}),
+								jsx("p", {
+									className: "text-muted-foreground",
+									children: "· 请确认插件来源可信后再继续；安装后可在本机信任文件登记其公钥。"
+								})
+							]
+						}),
+						jsxs(DialogFooter, { children: [jsx(Button, {
+							variant: "outline",
+							onClick: () => setInstallPhase({
+								...confirmed,
+								risk: false
+							}),
+							children: "返回"
+						}), jsx(Button, {
+							"data-confirm-risk-install": true,
+							onClick: () => runInstall(confirmed.zipPath, confirmed.archive),
+							children: "我知晓风险，仍要安装"
+						})] })
+					] }) : confirmedCombo !== void 0 ? jsxs(Fragment, { children: [
+						jsx(DialogTitle, {
+							className: "text-base font-medium",
+							children: "安装组合套件"
+						}),
+						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: "组合名"
+									}), jsx("span", {
+										className: "truncate",
+										children: confirmedCombo.title
+									})]
+								}),
+								jsxs("div", {
+									className: "flex justify-between gap-4",
+									children: [jsx("span", {
+										className: "text-muted-foreground",
+										children: "组合 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: "版本"
+									}), jsx("span", {
+										className: "font-mono",
+										children: confirmedCombo.version
+									})]
+								}),
+								confirmedCombo.description !== void 0 && jsx("p", {
+									className: "text-xs text-muted-foreground",
+									children: confirmedCombo.description
+								}),
+								confirmed.source !== void 0 && jsxs("div", {
+									className: "flex justify-between gap-4",
+									children: [jsx("span", {
+										className: "text-muted-foreground",
+										children: "来源"
+									}), 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,
+													" · ",
+													action,
+													unverified ? " · ⚠ 未验证" : ""
+												]
+											})]
+										}, plugin.name);
+									})
+								}),
+								jsx("p", {
+									className: "text-xs text-muted-foreground",
+									children: "组合包本身不签名；每个成员都经与单插件相同的签名校验。"
+								}),
+								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: [
+										"缺少依赖：",
+										confirmedCombo.missing.join("、"),
+										"——组合会立即启用全部行，装齐后再安装。"
+									]
+								}),
+								confirmedCombo.hasClient && jsx("p", {
+									className: "text-xs text-muted-foreground",
+									children: "组合含界面插件；装好后重启一次让界面生效。"
+								})
+							]
+						}),
+						jsxs(DialogFooter, { children: [jsx(Button, {
+							variant: "outline",
+							onClick: () => setInstallPhase({ phase: "idle" }),
+							children: "取消"
+						}), 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: "安装组合"
+						})] })
+					] }) : confirmedPlugin !== void 0 ? 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 !== void 0 && jsxs("div", {
+									className: "flex justify-between gap-4",
+									children: [jsx("span", {
+										className: "text-muted-foreground",
+										children: "名称"
+									}), jsx("span", {
+										className: "truncate",
+										children: confirmedPlugin.title
+									})]
+								}),
+								jsxs("div", {
+									className: "flex justify-between gap-4",
+									children: [jsx("span", {
+										className: "text-muted-foreground",
+										children: "包名"
+									}), 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: "已安装版本"
+									}), 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: "将更新至"
+									}), jsx("span", {
+										className: "font-mono",
+										children: confirmedPlugin.version
+									})]
+								})] }) : jsxs("div", {
+									className: "flex justify-between gap-4",
+									children: [jsx("span", {
+										className: "text-muted-foreground",
+										children: "版本"
+									}), jsx("span", {
+										className: "font-mono",
+										children: confirmedPlugin.version
+									})]
+								}),
+								jsxs("div", {
+									className: "flex justify-between gap-4",
+									children: [jsx("span", {
+										className: "text-muted-foreground",
+										children: "分类"
+									}), jsx("span", { children: confirmedPlugin.category ?? "其他" })]
+								}),
+								confirmed.source !== void 0 && jsxs("div", {
+									className: "flex justify-between gap-4",
+									children: [jsx("span", {
+										className: "text-muted-foreground",
+										children: "来源"
+									}), 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: "界面"
+									}), jsx("span", { children: "含页面" })]
+								}),
+								jsxs("div", {
+									className: "flex justify-between gap-4",
+									children: [jsx("span", {
+										className: "text-muted-foreground",
+										children: "权限"
+									}), 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: [
+										"尚未安装的依赖：",
+										confirmedPlugin.missing.join("、"),
+										"——可先安装本包，启用前需装齐。"
+									]
+								}),
+								confirmedPlugin.action === "update" && jsx("p", {
+									className: "text-xs text-muted-foreground",
+									children: "覆盖后保留该插件的配置与数据；运行中的界面需重启后生效。"
+								}),
+								confirmedPlugin.action === "blocked" && jsxs("p", {
+									"data-install-blocked": true,
+									className: "text-sm text-destructive",
+									children: [
+										"已安装 v",
+										confirmedPlugin.installed?.version,
+										"，安装包 v",
+										confirmedPlugin.version,
+										" 不高于已装版本，无法覆盖（卸载后可降级安装）。"
+									]
+								})
+							]
+						}),
+						jsxs(DialogFooter, { children: [jsx(Button, {
+							variant: "outline",
+							onClick: () => setInstallPhase({ phase: "idle" }),
+							children: "取消"
+						}), 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 !== void 0 && jsx(Dialog, {
+				open: true,
+				onOpenChange: (next) => {
+					if (!next) setKeyChange(void 0);
+				},
+				children: jsxs(DialogContent, {
+					"aria-describedby": void 0,
+					className: "max-w-sm",
+					children: [
+						jsx(DialogTitle, {
+							className: "text-base font-medium",
+							children: "发布者密钥已变更"
+						}),
+						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
+									}),
+									" ",
+									"的新版本由不同的密钥签名。若发布者确实轮换了密钥，更新是安全的；否则不要继续。"
+								]
+							}), jsxs("div", {
+								className: "rounded-md border border-warning/30 bg-warning/10 px-3 py-2",
+								children: [jsxs("p", { children: [
+									"已安装 v",
+									keyChange.installedVersion,
+									" → 源上 v",
+									keyChange.feedVersion
+								] }), jsx("p", {
+									className: "mt-1 text-muted-foreground",
+									children: "请核对发布者公告中的新 keyId 后再决定。"
+								})]
+							})]
+						}),
+						jsxs(DialogFooter, { children: [jsx(Button, {
+							variant: "outline",
+							onClick: () => setKeyChange(void 0),
+							children: "取消"
+						}), jsx(Button, {
+							"data-confirm-key-change": true,
+							onClick: () => updateNow(keyChange.name),
+							children: "仍要更新"
+						})] })
+					]
+				})
+			}),
+			installPhase.phase === "error" && jsx(Dialog, {
+				open: true,
+				onOpenChange: (next) => {
+					if (!next) setInstallPhase({ phase: "idle" });
+				},
+				children: jsxs(DialogContent, {
+					"aria-describedby": void 0,
+					className: "max-w-sm",
+					children: [
+						jsx(DialogTitle, {
+							className: "text-base font-medium",
+							children: "安装失败"
+						}),
+						jsx("p", {
+							"data-install-error": true,
+							className: "text-sm text-destructive",
+							children: installPhase.message
+						}),
+						jsx(DialogFooter, { children: jsx(Button, {
+							onClick: () => setInstallPhase({ phase: "idle" }),
+							children: "知道了"
+						}) })
+					]
+				})
+			}),
+			uninstall.phase === "confirm" && jsx(Dialog, {
+				open: true,
+				onOpenChange: (next) => {
+					if (!next) setUninstall({ phase: "idle" });
+				},
+				children: jsxs(DialogContent, {
+					"aria-describedby": void 0,
+					className: "max-w-sm",
+					children: [
+						jsx(DialogTitle, {
+							className: "text-base font-medium",
+							children: "卸载插件"
+						}),
+						jsxs("p", {
+							className: "text-sm text-muted-foreground",
+							children: [
+								"将从插件池移除 ",
+								jsx("span", {
+									className: "font-mono text-foreground",
+									children: uninstall.pkg
+								}),
+								"，其数据一并删除，不可恢复。"
+							]
+						}),
+						jsxs(DialogFooter, { children: [jsx(Button, {
+							variant: "outline",
+							onClick: () => setUninstall({ phase: "idle" }),
+							children: "取消"
+						}), jsx(Button, {
+							variant: "destructive",
+							"data-confirm-uninstall": true,
+							onClick: () => runUninstall(uninstall.pkg),
+							children: "卸载"
+						})] })
+					]
+				})
+			}),
+			uninstall.phase === "error" && jsx(Dialog, {
+				open: true,
+				onOpenChange: (next) => {
+					if (!next) setUninstall({ phase: "idle" });
+				},
+				children: jsxs(DialogContent, {
+					"aria-describedby": void 0,
+					className: "max-w-sm",
+					children: [
+						jsx(DialogTitle, {
+							className: "text-base font-medium",
+							children: "卸载失败"
+						}),
+						jsx("p", {
+							"data-uninstall-error": true,
+							className: "text-sm text-destructive",
+							children: uninstall.message
+						}),
+						jsx(DialogFooter, { children: jsx(Button, {
+							onClick: () => setUninstall({ phase: "idle" }),
+							children: "知道了"
+						}) })
+					]
+				})
+			}),
+			feedDialogOpen && jsx(Dialog, {
+				open: true,
+				onOpenChange: (next) => {
+					if (!next) setFeedDialogOpen(false);
+				},
+				children: jsxs(DialogContent, {
+					"aria-describedby": void 0,
+					className: "max-w-md",
+					children: [
+						jsx(DialogTitle, {
+							className: "text-base font-medium",
+							children: "插件源"
+						}),
+						jsxs("div", {
+							className: "flex flex-col gap-2",
+							children: [
+								jsx("label", {
+									className: "text-sm text-muted-foreground",
+									htmlFor: "plugin-feed-url",
+									children: "搜索与在线更新使用的插件源列表："
+								}),
+								feedUrls.length === 0 && jsx("p", {
+									className: "text-xs text-muted-foreground",
+									children: "尚未添加自定义源（当前使用出厂默认源）。"
+								}),
+								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: "✕"
+									})]
+								}, url)),
+								jsxs("div", {
+									className: "flex items-center gap-2",
+									children: [jsx(Input, {
+										id: "plugin-feed-url",
+										value: feedDraft,
+										placeholder: "https://…（指向含 index.json 的目录）",
+										"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: "添加源"
+									})]
+								}),
+								feedError !== void 0 && jsx("p", {
+									className: "text-sm text-destructive",
+									children: feedError
+								}),
+								jsx("p", {
+									className: "text-xs text-muted-foreground",
+									children: "未修改时使用出厂默认源；修改后保存在本机，仅影响本机。社区插件源就是插件作者自己仓库的 Release 地址。"
+								})
+							]
+						}),
+						jsxs(DialogFooter, { children: [jsx(Button, {
+							variant: "outline",
+							onClick: () => setFeedDialogOpen(false),
+							children: "取消"
+						}), jsx(Button, {
+							"data-feed-save": true,
+							onClick: saveFeedUrls,
+							children: "保存"
+						})] })
+					]
+				})
+			})
+		]
+	});
+}
+//#endregion
+//#region lib/types/settings-update-page.js
+/** The phase's one-line copy; `error`/`unconfigured` carry their own message. */
+function phaseHint(status) {
+	switch (status.phase) {
+		case "unsupported": return "当前为开发模式，无法检查更新。";
+		case "unconfigured": return status.message ?? "未配置更新源。";
+		case "idle": return "就绪，可手动检查更新。";
+		case "checking": return "正在检查更新…";
+		case "available": return "发现新版本，正在后台自动下载。";
+		case "none": return "已是最新版本。";
+		case "downloading": return `正在下载新版本… ${Math.round(status.percent ?? 0)}%`;
+		case "ready": return "新版本已就绪，重启后自动完成安装。";
+		case "error": return `更新失败：${status.message ?? "未知错误"}`;
+	}
+}
+/** The 软件更新 page. */
+function UpdatePage({ ctx }) {
+	const [status, setStatus] = useState(void 0);
+	const [failed, setFailed] = useState(false);
+	const [busy, setBusy] = useState(false);
+	const [actionError, setActionError] = useState(void 0);
+	const [feedUrl, setFeedUrl] = useState("");
+	const [feedError, setFeedError] = useState(void 0);
+	const [autoCheck, setAutoCheck] = useState(true);
+	const link = ctx.get("client").link;
+	useEffect(() => {
+		link.call("update.state", {}).then((result) => {
+			if (result.ok) setStatus(result.value.status);
+			else setFailed(true);
+		}).catch(() => setFailed(true));
+		link.call("settings.get", { key: UPDATE_AUTO_CHECK_KEY }).then((result) => {
+			if (result.ok && typeof result.value.value === "boolean") setAutoCheck(result.value.value);
+		}).catch(() => void 0);
+		link.call("settings.get", { key: UPDATE_FEED_URL_KEY }).then((result) => {
+			if (result.ok && typeof result.value.value === "string") setFeedUrl(result.value.value);
+		}).catch(() => void 0);
+		const offStatus = subscribeFrame(link, "update/status", updateStatusSchema, (next) => setStatus(next));
+		const offSettings = subscribeFrame(link, "settings/changed", settingsChangedSchema, (change) => {
+			if (change.key === UPDATE_FEED_URL_KEY) setFeedUrl(typeof change.value === "string" ? change.value : "");
+			if (change.key === UPDATE_AUTO_CHECK_KEY) setAutoCheck(change.value !== false);
+		});
+		return () => {
+			offStatus();
+			offSettings();
+		};
+	}, [ctx]);
+	/** Run a snapshot-returning update method; failures surface next to the buttons. */
+	const run = (method) => {
+		setBusy(true);
+		setActionError(void 0);
+		link.call(method, {}).then((result) => {
+			if (result.ok) setStatus(result.value.status);
+			else setActionError(rpcErrorText(result.error));
+			setBusy(false);
+		}).catch(() => setBusy(false));
+	};
+	const install = () => {
+		setBusy(true);
+		setActionError(void 0);
+		link.call("update.install", {}).then((result) => {
+			if (!result.ok) {
+				setActionError(rpcErrorText(result.error));
+				setBusy(false);
+			}
+		}).catch(() => setBusy(false));
+	};
+	const saveFeedUrl = () => {
+		const value = feedUrl.trim();
+		if (value !== "") try {
+			const parsed = new URL(value);
+			if (parsed.protocol !== "http:" && parsed.protocol !== "https:") throw new Error("protocol");
+		} catch {
+			setFeedError("请填写 http(s) 开头的更新源地址");
+			return;
+		}
+		setFeedError(void 0);
+		link.call("settings.set", {
+			key: UPDATE_FEED_URL_KEY,
+			value
+		});
+	};
+	if (failed) return jsx("div", {
+		className: "text-sm text-muted-foreground",
+		children: "更新状态读取失败。"
+	});
+	if (status === void 0) return jsx("div", {
+		className: "text-sm text-muted-foreground",
+		children: "正在连接更新通道…"
+	});
+	const phase = status.phase;
+	const showCheck = phase === "idle" || phase === "none" || phase === "error" || phase === "available";
+	const percent = Math.min(100, Math.max(0, Math.round(status.percent ?? 0)));
+	return jsxs("div", {
+		"data-region": "update-page",
+		className: "flex max-w-xl flex-col gap-4",
+		children: [jsxs("div", {
+			"data-update-status": phase,
+			className: "flex flex-col gap-3 rounded-md border border-border px-4 py-4",
+			children: [
+				jsxs("div", {
+					className: "flex items-center justify-between",
+					children: [jsx("span", {
+						className: "text-sm text-muted-foreground",
+						children: "当前版本"
+					}), jsx("span", {
+						className: "font-mono text-sm",
+						children: status.currentVersion
+					})]
+				}),
+				status.version !== void 0 && jsxs("div", {
+					className: "flex items-center justify-between",
+					children: [jsx("span", {
+						className: "text-sm text-muted-foreground",
+						children: "新版本"
+					}), jsx("span", {
+						className: "font-mono text-sm",
+						children: status.version
+					})]
+				}),
+				jsx("p", {
+					"data-update-hint": true,
+					className: "text-sm text-muted-foreground",
+					children: phaseHint(status)
+				}),
+				phase === "downloading" && jsx(Progress, {
+					"data-update-progress": percent,
+					"aria-label": "下载进度",
+					value: percent
+				}),
+				actionError !== void 0 && jsx("p", {
+					"data-update-error": true,
+					className: "text-sm text-destructive",
+					children: actionError
+				}),
+				jsxs("div", {
+					className: "flex items-center gap-2",
+					children: [
+						showCheck && jsx(Button, {
+							"data-update-check": true,
+							disabled: busy,
+							onClick: () => run("update.check"),
+							children: phase === "error" ? "重新检查" : "检查更新"
+						}),
+						phase === "available" && jsx(Button, {
+							"data-update-download": true,
+							variant: "outline",
+							disabled: busy,
+							onClick: () => run("update.download"),
+							children: "立即下载"
+						}),
+						phase === "ready" && jsx(Button, {
+							"data-update-install": true,
+							disabled: busy,
+							onClick: install,
+							children: "重启并安装"
+						})
+					]
+				})
+			]
+		}), jsxs("div", {
+			className: "flex flex-col gap-3 rounded-md border border-border px-4 py-4",
+			children: [jsxs("div", {
+				className: "flex items-center justify-between gap-4",
+				children: [jsxs("div", {
+					className: "flex flex-col gap-0.5",
+					children: [jsx("span", {
+						className: "text-sm",
+						children: "启动时自动检查更新"
+					}), jsx("span", {
+						className: "text-xs text-muted-foreground",
+						children: "发现新版本后自动后台下载；安装仍需手动确认重启。"
+					})]
+				}), jsx(Switch, {
+					"aria-label": "启动时自动检查更新",
+					checked: autoCheck,
+					onCheckedChange: (next) => {
+						setAutoCheck(next);
+						link.call("settings.set", {
+							key: UPDATE_AUTO_CHECK_KEY,
+							value: next
+						});
+					}
+				})]
+			}), jsxs("div", {
+				className: "flex flex-col gap-1.5",
+				children: [
+					jsx(Label, {
+						htmlFor: "update-feed-url",
+						children: "更新源地址"
+					}),
+					jsxs("div", {
+						className: "flex items-center gap-2",
+						children: [jsx(Input, {
+							id: "update-feed-url",
+							value: feedUrl,
+							placeholder: "https://updates.example.com/snap-rail/",
+							onChange: (event) => setFeedUrl(event.target.value)
+						}), jsx(Button, {
+							variant: "outline",
+							"data-update-save-feed": true,
+							onClick: saveFeedUrl,
+							children: "保存"
+						})]
+					}),
+					feedError !== void 0 && jsx("p", {
+						className: "text-sm text-destructive",
+						children: feedError
+					}),
+					jsx("p", {
+						className: "text-xs text-muted-foreground",
+						children: "指向存放安装包与 latest.yml 的目录；留空时使用安装包内置配置。保存后再点「检查更新」立即生效。"
+					})
+				]
+			})]
+		})]
+	});
+}
+//#endregion
+//#region lib/types/settings-dialog.js
+/** The 主题 settings page: one mode choice (跟随系统/白天/黑夜). The write
+* hot-applies everywhere via the `settings/changed` frame — no restart. */
+function ThemePage(props) {
+	const [mode, setMode] = useState(props.initial.mode);
+	return jsxs("div", {
+		"data-region": "theme-page",
+		className: "flex max-w-xl flex-col gap-4",
+		children: [jsx("p", {
+			className: "text-sm text-muted-foreground",
+			children: "模式立即生效并写入配置文件；跟随系统时随操作系统的日夜间设置自动切换。"
+		}), jsx(Tabs, {
+			value: mode,
+			onValueChange: (next) => {
+				const choice = next;
+				setMode(choice);
+				props.onChoose({ mode: choice });
+			},
+			children: jsxs(TabsList, {
+				"aria-label": "主题模式",
+				children: [
+					jsx(TabsTrigger, {
+						value: "system",
+						"data-mode-option": "system",
+						children: "跟随系统"
+					}),
+					jsx(TabsTrigger, {
+						value: "light",
+						"data-mode-option": "light",
+						children: "白天"
+					}),
+					jsx(TabsTrigger, {
+						value: "dark",
+						"data-mode-option": "dark",
+						children: "黑夜"
+					})
+				]
+			})
+		})]
+	});
+}
+/** The settings shell: a fullscreen surface that renders the registered
+* pages as a menu on the left and the active page's content on the right.
+* Pages come from any plugin via the settings seam; the shell itself
+* contributes the first-party plugin page (management and market fused)
+* plus theme and app-update pages. */
+function SettingsDialog({ ctx }) {
+	useRefresh(ctx, ["settings/open-changed", "settings/pages-changed"]);
+	const open = ctx.settingsPages.isOpen();
+	const pages = ctx.settingsPages.list();
+	const activeId = ctx.settingsPages.active();
+	const active = pages.find((page) => page.id === activeId);
+	useEffect(() => {
+		if (!open) return;
+		const onKey = (event) => {
+			if (event.key === "Escape") ctx.settingsPages.close();
+		};
+		window.addEventListener("keydown", onKey);
+		return () => {
+			window.removeEventListener("keydown", onKey);
+		};
+	}, [open]);
+	if (!open) return null;
+	return jsxs("div", {
+		"data-region": "settings-shell",
+		"data-active-page": activeId,
+		className: "fixed inset-0 z-50 flex flex-col bg-background",
+		children: [jsxs("div", {
+			className: "flex items-center justify-between border-b border-border px-5 py-3",
+			children: [jsx("span", {
+				className: "text-lg font-medium",
+				children: "设置"
+			}), jsx(Button, {
+				variant: "ghost",
+				size: "icon",
+				"aria-label": "关闭设置",
+				onClick: () => ctx.settingsPages.close(),
+				children: jsx(X, { className: "h-5 w-5" })
+			})]
+		}), jsxs("div", {
+			className: "flex min-h-0 flex-1",
+			children: [jsx(DragScroll, {
+				"data-region": "settings-menu",
+				className: "flex w-60 shrink-0 flex-col gap-1 border-r border-border p-2",
+				children: pages.map((page) => jsx("button", {
+					type: "button",
+					"data-settings-page": page.id,
+					"aria-current": page.active || void 0,
+					className: `flex h-12 w-full items-center rounded-md px-4 text-left text-base transition-colors hover:bg-accent ${page.active ? "bg-accent font-medium text-accent-foreground channel-keyline" : "text-muted-foreground"}`,
+					onClick: () => ctx.settingsPages.open(page.id),
+					children: page.title
+				}, page.id))
+			}), jsx("div", {
+				"data-region": "settings-content",
+				"data-active-page": activeId,
+				className: "flex min-w-0 flex-1 flex-col overflow-auto p-6",
+				children: active?.render()
+			})]
+		})]
+	});
+}
+/** The settings dialog occupant. */
+const settingsDialogPlugin = {
+	name: "framework settings",
+	inject: ["uiContract", "settingsPages"],
+	apply(ctx) {
+		const client = ctx.get("client");
+		let theme = DEFAULT_THEME;
+		const adoptTheme = (value) => {
+			const parsed = themeSettingsSchema.safeParse(value);
+			if (!parsed.success) return;
+			theme = parsed.data;
+			applyTheme(document, theme);
+		};
+		applyTheme(document, theme);
+		client.link.call("settings.get", { key: THEME_SETTINGS_KEY }).then((result) => {
+			if (result.ok) adoptTheme(result.value.value);
+		}).catch(() => {});
+		ctx.effect(() => subscribeFrame(client.link, "settings/changed", settingsChangedSchema, (change) => {
+			if (change.key === "ui.theme") adoptTheme(change.value);
+		}));
+		const osPreference = window.matchMedia("(prefers-color-scheme: light)");
+		ctx.effect(() => {
+			const sync = () => {
+				if (theme.mode === "system") applyTheme(document, theme);
+			};
+			osPreference.addEventListener("change", sync);
+			return () => {
+				osPreference.removeEventListener("change", sync);
+			};
+		});
+		const chooseTheme = (next) => {
+			theme = next;
+			applyTheme(document, next);
+			client.link.call("settings.set", {
+				key: THEME_SETTINGS_KEY,
+				value: next
+			});
+		};
+		ctx.settingsPages.register(ctx, {
+			id: "plugins",
+			title: "插件",
+			order: 0,
+			render() {
+				return jsx(PluginsPage, { ctx });
+			}
+		});
+		ctx.settingsPages.register(ctx, {
+			id: "theme",
+			title: "主题",
+			order: 1,
+			render() {
+				return jsx(ThemePage, {
+					initial: theme,
+					onChoose: chooseTheme
+				});
+			}
+		});
+		ctx.settingsPages.register(ctx, {
+			id: "update",
+			title: "软件更新",
+			order: 2,
+			render() {
+				return jsx(UpdatePage, { ctx });
+			}
+		});
+		ctx.uiContract.registerLayout(ctx, {
+			id: "settings-dialog",
+			order: 100,
+			slots: [UI_SLOT_IDS.overlay],
+			render() {
+				return jsx(SettingsDialog, { ctx });
+			}
+		});
+	}
+};
+//#endregion
+//#region lib/types/session.js
+/** Mounts the `ctx.session` mirror; state lives in the apply closure. */
+const sessionPlugin = {
+	name: "client-session",
+	inject: ["client"],
+	apply(ctx) {
+		const { link } = ctx.client;
+		let operator = null;
+		let restored = false;
+		const sync = (next) => {
+			operator = next;
+			ctx.emit("session/changed", operator);
+		};
+		link.call("session.current", {}).then((result) => {
+			if (result.ok) sync(result.value.operator);
+		}).catch(() => {}).finally(() => {
+			restored = true;
+			ctx.emit("session/restored");
+		});
+		ctx.effect(() => subscribeFrame(link, "settings/changed", settingsChangedSchema, (change) => {
+			if (change.key !== SESSION_OPERATOR_KEY) return;
+			link.call("session.current", {}).then((result) => {
+				if (result.ok && result.value.operator !== operator) sync(result.value.operator);
+			}).catch(() => {});
+		}));
+		ctx.provide("session", {
+			current: () => operator,
+			restored: () => restored,
+			async login(raw) {
+				const trimmed = raw.trim();
+				if (trimmed === "") throw new Error("工号不能为空");
+				const result = await link.call("session.login", { operator: trimmed });
+				if (!result.ok) throw new Error(`登录失败（${result.error.code}）`);
+				sync(trimmed);
+			},
+			async logout() {
+				const result = await link.call("session.logout", {});
+				if (!result.ok) throw new Error(`退出失败（${result.error.code}）`);
+				sync(null);
+			}
+		});
+	}
+};
+//#endregion
+//#region lib/types/variables.js
+/**
+* Mounts the `ctx.variables` registry. All state lives in construction-time
+* closures: traceable context proxies rebind `this` on every method access,
+* so `this`-reached state cannot back a service here (the uiSlots lesson).
+*/
+const variablesPlugin = {
+	name: "client-variables",
+	apply(ctx) {
+		const variables = /* @__PURE__ */ new Map();
+		ctx.provide("variables", {
+			list() {
+				return [...variables.values()];
+			},
+			register(caller, defs) {
+				const keys = defs.map((def) => pointKey(def));
+				if (new Set(keys).size !== keys.length) throw new Error(`variables: duplicate addresses in one registration: ${keys.join(", ")}`);
+				const installed = [];
+				for (const def of defs) {
+					const entry = {
+						...def,
+						source: "plugin"
+					};
+					const key = pointKey(def);
+					installed.push({
+						key,
+						entry
+					});
+					variables.set(key, entry);
+				}
+				ctx.emit("variables/changed");
+				const remove = () => {
+					let changed = false;
+					for (const { key, entry } of installed) if (variables.get(key) === entry) {
+						variables.delete(key);
+						changed = true;
+					}
+					if (changed) ctx.emit("variables/changed");
+				};
+				caller.effect(() => remove);
+				return remove;
+			}
+		});
+	}
+};
+/**
+* Resolve a binding against the generic mapping document. The device must
+* exist, the group entity must exist on it, and the point form must find
+* the point in exactly that group — an unknown group name must read as
+* unresolved, never as "all normal". A group resolves with at least one
+* member, in the document's order (the driver's projection defines it; the
+* first active member is a stable "primary").
+*/
+function resolveBinding(doc, binding) {
+	if (!doc.devices.some((device) => device.id === binding.device)) return void 0;
+	if (!doc.groups.some((group) => group.deviceId === binding.device && group.name === binding.group)) return void 0;
+	if ("name" in binding) {
+		if (!doc.points.some((point) => point.deviceId === binding.device && point.group === binding.group && point.name === binding.name)) return void 0;
+		return {
+			kind: "point",
+			ref: {
+				device: binding.device,
+				group: binding.group,
+				name: binding.name
+			},
+			name: binding.name
+		};
+	}
+	const members = doc.points.filter((point) => point.deviceId === binding.device && point.group === binding.group).map((point) => ({
+		ref: {
+			device: point.deviceId,
+			group: point.group,
+			name: point.name
+		},
+		name: point.name
+	}));
+	if (members.length === 0) return void 0;
+	return {
+		kind: "group",
+		device: binding.device,
+		group: binding.group,
+		members
+	};
+}
+/** Any-active truthiness: `true`, a nonzero number/bigint, a non-empty string. */
+function isActiveValue(value) {
+	if (value === null) return false;
+	if (typeof value === "boolean") return value;
+	if (typeof value === "bigint") return value !== 0n;
+	if (typeof value === "number") return value !== 0;
+	return value.length > 0;
+}
+/**
+* Watch one binding and emit a `BindingView` on every change. The watcher
+* resolves the generic mapping document itself, seeds current values with
+* one `field.points.read`, follows `field/point-updated` frames, and
+* re-resolves on a `field/mappings-changed` frame — re-mapping takes effect
+* without remounting the consumer.
+*
+* The returned stop function drops this watcher's subscription references;
+* the host counts references per address, so overlapping watchers of one
+* address never starve each other.
+*/
+function watchBinding(ctx, binding, listener) {
+	const { link } = ctx.client;
+	let live = true;
+	let resolved;
+	let refs = [];
+	const samples = /* @__PURE__ */ new Map();
+	const compute = () => {
+		if (resolved === void 0) {
+			listener({ kind: "unresolved" });
+			return;
+		}
+		if (resolved.kind === "point") {
+			listener({
+				kind: "point",
+				ref: resolved.ref,
+				name: resolved.name,
+				sample: samples.get(pointKey(resolved.ref))
+			});
+			return;
+		}
+		const active = [];
+		const abnormal = [];
+		const pending = [];
+		for (const member of resolved.members) {
+			const sample = samples.get(pointKey(member.ref));
+			if (sample === void 0 || sample.value === null && sample.time === 0) pending.push(member.name);
+			else if (sample.value === null) abnormal.push(member.name);
+			else if (isActiveValue(sample.value)) active.push({
+				name: member.name,
+				value: sample.value,
+				time: sample.time
+			});
+		}
+		listener({
+			kind: "group",
+			device: resolved.device,
+			group: resolved.group,
+			status: active.length > 0 ? "active" : "normal",
+			active,
+			abnormal,
+			pending
+		});
+	};
+	const resubscribe = () => {
+		link.call("equipment.mappings.list", {}).then((result) => {
+			if (!live || !result.ok) return;
+			const next = resolveBinding(result.value.mappings, binding);
+			const nextRefs = next === void 0 ? [] : next.kind === "point" ? [next.ref] : next.members.map((member) => member.ref);
+			const wanted = new Set(nextRefs.map(pointKey));
+			for (const ref of refs) if (!wanted.has(pointKey(ref))) link.call("equipment.points.unsubscribe", { points: [ref] }).catch(() => {});
+			for (const ref of nextRefs) if (!refs.some((current) => pointKey(current) === pointKey(ref))) link.call("equipment.points.subscribe", { points: [ref] }).catch(() => {});
+			refs = nextRefs;
+			resolved = next;
+			samples.clear();
+			if (nextRefs.length === 0) {
+				compute();
+				return;
+			}
+			link.call("equipment.points.read", { points: [...nextRefs] }).then((read) => {
+				if (!live) return;
+				if (read.ok) for (const sample of read.value.samples) samples.set(pointKey(sample), {
+					value: sample.value,
+					time: sample.time
+				});
+				compute();
+			}).catch(() => {
+				if (live) compute();
+			});
+		}).catch(() => {});
+	};
+	const detachUpdates = subscribeFrame(link, "equipment/point-updated", equipmentFrameSchemas["equipment/point-updated"], (frame) => {
+		const ref = {
+			device: frame.device,
+			group: frame.group,
+			name: frame.name
+		};
+		if (!refs.some((current) => pointKey(current) === pointKey(ref))) return;
+		samples.set(pointKey(ref), {
+			value: frame.value,
+			time: frame.time
+		});
+		compute();
+	});
+	const detachConfig = link.subscribe("equipment/mappings-changed", () => {
+		resubscribe();
+	});
+	resubscribe();
+	return () => {
+		live = false;
+		detachUpdates();
+		detachConfig();
+		if (refs.length > 0) link.call("equipment.points.unsubscribe", { points: [...refs] }).catch(() => {});
+	};
+}
+/** Stable identity of a binding for hook dependency lists. */
+function bindingKey(binding) {
+	return "name" in binding ? `${binding.device}/${binding.group}/${binding.name}` : `${binding.device}/${binding.group}`;
+}
+/** The React recipe over `watchBinding`; `unresolved` until first observation. */
+function useBinding(ctx, binding) {
+	const [view, setView] = useState({ kind: "unresolved" });
+	const { link } = ctx.client;
+	const key = bindingKey(binding);
+	useEffect(() => watchBinding(ctx, binding, setView), [link, key]);
+	return view;
+}
+/**
+* The consume recipe for demand plugins: seed the current value with a
+* `field.points.read`, then follow `field/point-updated` increments. Returns
+* `undefined` until the first observation — an unmapped declaration stays
+* undefined.
+*
+* The hook holds one subscription reference for its lifetime; the matching
+* `field.points.unsubscribe` fires on unmount, and the host's reference
+* counting keeps other watchers of the same address live.
+*/
+function usePoint(ctx, binding) {
+	const [sample, setSample] = useState(void 0);
+	const { link } = ctx.client;
+	const key = pointKey(binding);
+	useEffect(() => {
+		let live = true;
+		const detach = subscribeFrame(link, "equipment/point-updated", equipmentFrameSchemas["equipment/point-updated"], (frame) => {
+			const frameRef = {
+				device: frame.device,
+				group: frame.group,
+				name: frame.name
+			};
+			if (pointKey(frameRef) !== key) return;
+			if (live) setSample({
+				value: frame.value,
+				time: frame.time
+			});
+		});
+		link.call("equipment.points.subscribe", { points: [binding] }).catch(() => {});
+		link.call("equipment.points.read", { points: [binding] }).then((result) => {
+			if (!live || !result.ok) return;
+			const first = result.value.samples[0];
+			if (first !== void 0) setSample({
+				value: first.value,
+				time: first.time
+			});
+		}).catch(() => {});
+		return () => {
+			live = false;
+			detach();
+			link.call("equipment.points.unsubscribe", { points: [binding] }).catch(() => {});
+		};
+	}, [link, key]);
+	return sample;
+}
+//#endregion
+//#region lib/types/workflows.js
+/** Whether two epoch-ms times fall on the same local calendar day. */
+function sameLocalDay(a, b) {
+	return new Date(a).toDateString() === new Date(b).toDateString();
+}
+/**
+* Mounts the `ctx.workflows` registry. All state lives in construction-time
+* closures: traceable context proxies rebind `this` on every method access,
+* so `this`-reached state cannot back a service here (the uiSlots lesson).
+*/
+const workflowsPlugin = {
+	name: "client-workflows",
+	apply(ctx) {
+		const workflows = /* @__PURE__ */ new Map();
+		let nextSeq = 0;
+		let activeId;
+		let operator = null;
+		let events = [];
+		const satisfies = (requirement) => events.some((event) => event.action === requirement.action && (requirement.scope === "day" ? sameLocalDay(event.time, Date.now()) : event.actor === operator && sameLocalDay(event.time, Date.now())));
+		const changed = () => {
+			ctx.emit("workflow/changed");
+		};
+		ctx.provide("workflows", {
+			list() {
+				return [...workflows.values()].sort((a, b) => a.def.order - b.def.order || a.seq - b.seq).map(({ def, alert }) => ({
+					...def,
+					unlocked: def.requires.every(satisfies),
+					active: def.id === activeId,
+					alert
+				}));
+			},
+			register(caller, def) {
+				workflows.set(def.id, {
+					def,
+					alert: null,
+					seq: nextSeq++
+				});
+				changed();
+				const remove = () => {
+					if (workflows.delete(def.id)) {
+						if (activeId === def.id) activeId = void 0;
+						changed();
+					}
+				};
+				caller.effect(() => remove);
+				return remove;
+			},
+			setActive(id) {
+				if (activeId === id) return;
+				activeId = id;
+				changed();
+			},
+			setAlert(id, alert) {
+				const entry = workflows.get(id);
+				if (entry === void 0 || entry.alert === alert) return;
+				if (alert !== null && alert.kind === "halo") alert = {
+					kind: "halo",
+					progress: Math.min(1, Math.max(0, alert.progress))
+				};
+				entry.alert = alert;
+				changed();
+			},
+			setOperator(next) {
+				if (operator === next) return;
+				operator = next;
+				changed();
+			},
+			feedEvents(next) {
+				events = [...next].sort((a, b) => a.time - b.time);
+				changed();
+			},
+			announce(action, actor) {
+				events = [...events, {
+					action,
+					actor: actor ?? operator ?? "client",
+					time: Date.now()
+				}];
+				changed();
+			}
+		});
+	}
+};
+//#endregion
+//#region lib/types/Shell.js
+/** Shell root; mounted once by {@link ../index.tsx | createClientRuntime}. */
+function Shell(props) {
+	const [tick, setTick] = useState(0);
+	useEffect(() => {
+		const detach = props.ctx.on("ui/slot-changed", () => setTick((value) => value + 1));
+		return () => {
+			detach();
+		};
+	}, [props.ctx]);
+	const layouts = props.ctx.uiSlots.list(UI_SLOT_IDS.layout);
+	const content = layouts.length > 0 ? layouts.map((occupant) => jsx(Fragment$1, { children: occupant.render() }, occupant.id)) : jsx("div", {
+		className: "m-auto text-muted-foreground",
+		children: "没有已加载的布局插件。"
+	});
+	return jsx("div", {
+		className: "flex h-full flex-col",
+		"data-tick": tick,
+		children: content
+	});
+}
+//#endregion
+//#region lib/types/runtime.js
+/**
+* The client renderer host: takes over the React root from the kernel,
+* mounts the phase-1 occupant plugins into one client Cordis context, and
+* renders the slot-driven shell that re-renders whenever any occupied slot
+* changes. When no layout plugin registered, the shell degrades to a notice
+* instead of an empty window.
+*
+* @module @snap-rail/framework-shadcn/runtime
+*/
+/**
+* Take over the booted root: stop the startup page, mount the client plugin
+* tree, render the shell.
+*
+* @param handle - the kernel's boot result.
+* @param options - see {@link RuntimeOptions}.
+*/
+async function createClientRuntime(handle, options) {
+	const ctx = new Context();
+	ctx.provide("client", { link: handle.link });
+	await ctx.plugin(TimerService);
+	await ctx.plugin(slotsPlugin);
+	await ctx.plugin(semanticPlugin);
+	await ctx.plugin(settingsPlugin);
+	await ctx.plugin(settingsDialogPlugin);
+	await ctx.plugin(variablesPlugin);
+	await ctx.plugin(sessionPlugin);
+	await ctx.plugin(workflowsPlugin);
+	for (const seat of options.plugins) {
+		const spec = "plugin" in seat ? seat : { plugin: seat };
+		const plugin = spec.plugin;
+		await ctx.plugin(plugin, spec.config === void 0 ? {} : spec.config);
+	}
+	await ctx.plugin(fallbackShellPlugin);
+	handle.root.unmount();
+	const shellRoot = createRoot(handle.element);
+	shellRoot.render(jsx(Shell, { ctx }));
+	return {
+		ctx,
+		dispose: () => ctx.fiber.dispose().then(() => {
+			shellRoot.unmount();
+		})
+	};
+}
+//#endregion
+export { CUSTOM_UI_SLOT_PATTERN, STANDARD_UI_SLOT_IDS, UI_SLOT_IDS, UI_SLOT_MODES, createClientRuntime, isValidUiSlotId, resolveBinding, slotModeOf, useBinding, usePoint, watchBinding };