@hpyperry/dsh-ref-lib 0.7.0

package/lib/client.js

@@ -0,0 +1,1377 @@
+window.__ModuleLoader__.load({
+	id: "@hpyperry/dsh-ref-lib",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		let react = require("react");
+		let _deepseek_ai_dsh_client_ui_primitives = require("@deepseek-ai/dsh-client-ui-primitives");
+		let react_jsx_runtime = require("react/jsx-runtime");
+		//#region src/validate.ts
+		/** 校验一个未知对象是否为合法条目（宽松：仅要求 id/path 字符串、note 可选字符串）。 */
+		function isRefLibEntry(value) {
+			if (typeof value !== "object" || value === null) return false;
+			const { id, path, note } = value;
+			if (typeof id !== "string" || typeof path !== "string") return false;
+			return note === void 0 || typeof note === "string";
+		}
+		//#endregion
+		//#region src/client/data.ts
+		/** 带 wire code 的 API 错误：code 用于本地化文案映射，message 为原始消息兜底。 */
+		var RefLibApiError = class extends Error {
+			code;
+			details;
+			/**
+			* @param code - wire 错误码（如 ref-lib/missing）。
+			* @param message - 服务端原始错误消息。
+			* @param details - 附加字段（path/id）。
+			*/
+			constructor(code, message, details = {}) {
+				super(message);
+				this.code = code;
+				this.details = details;
+				this.name = "RefLibApiError";
+			}
+		};
+		/**
+		* 从失败的 /api/ref-lib/* 响应体解析错误码；无 code 的畸形体返回 null。
+		* @param value - 非 2xx 响应体（可为任意 JSON）。
+		* @returns 错误码 + 原始消息 + 附加字段；无法解析时为 null。
+		*/
+		function parseApiErrorPayload(value) {
+			if (typeof value !== "object" || value === null) return null;
+			const { error, code, path, id } = value;
+			if (typeof code !== "string" || code === "") return null;
+			const details = {
+				...typeof path === "string" ? { path } : {},
+				...typeof id === "string" ? { id } : {}
+			};
+			return {
+				code,
+				message: typeof error === "string" ? error : code,
+				details
+			};
+		}
+		/**
+		* 从 /api/ref-lib/list 路由响应（{ libs: [...] }）解析参考库列表；
+		* 缺失/畸形返回空列表。
+		* @param value - 路由响应体。
+		* @returns 当前参考库列表。
+		*/
+		function parseLibsPayload(value) {
+			if (typeof value !== "object" || value === null) return [];
+			const libs = value.libs;
+			if (!Array.isArray(libs)) return [];
+			return libs.filter(isRefLibEntry);
+		}
+		/**
+		* 提取目录路径的展示用基名（列表行主行的可读标题）。
+		* 兼容 POSIX 与 Windows 分隔符；去掉尾部分隔符后取最后一段；
+		* 根路径（/、C:\）原样返回。
+		* @param path - 规范化绝对路径。
+		* @returns 基名（如 /a/b/core → core）。
+		*/
+		function libBasename(path) {
+			const trimmed = path.replace(/[\\/]+$/, "");
+			if (trimmed === "") return path;
+			if (/^[A-Za-z]:$/.test(trimmed)) return path;
+			const idx = Math.max(trimmed.lastIndexOf("/"), trimmed.lastIndexOf("\\"));
+			return idx === -1 ? trimmed : trimmed.slice(idx + 1);
+		}
+		//#endregion
+		//#region src/client/RefLibBrowser.tsx
+		/**
+		* 应用内目录浏览器（browse 后端可用时，「选择目录」的落地实现）。
+		*
+		* 为什么需要它：v6 起 profile 把 directory-picker 从 -auto（本机解析为 native，
+		* OS 对话框硬编码英文且每次拉 osascript 进程）切换为 -browse 后，
+		* `host.pickDirectory`（native 专用 RPC）不再可用；本组件用 `listDirectory`
+		* （Node stdlib 列目录，zh/en 本地化、无 OS 进程）提供等价的目录选择：
+		* 面包屑 + 路径编辑 + 子目录列表，点击下行进入，「选择此目录」把当前层级添加为
+		* 参考库。简化为单列（与官方 DirectoryBrowser 的 Miller 双列相比），
+		* 但覆盖添加参考库的核心路径。
+		* @module @hpyperry/dsh-ref-lib/src/client/RefLibBrowser
+		*/
+		/** 面包屑展示：主目录子树内以本地化 Home 开头；之外显示完整祖先链。 */
+		function displayCrumbs(listing, homeLabel) {
+			const homeIndex = listing.crumbs.findIndex((crumb) => crumb.path === listing.home);
+			if (homeIndex === -1) return listing.crumbs;
+			const tail = listing.crumbs.slice(homeIndex + 1);
+			return [{
+				name: homeLabel,
+				path: listing.home,
+				hidden: false
+			}, ...tail];
+		}
+		/** 平台分隔符（由宿主主目录推断，绝不从键入文本推断）。 */
+		function separatorOf(listing) {
+			return listing.home.includes("\\") ? "\\" : "/";
+		}
+		/**
+		* 渲染应用内目录浏览器。
+		* @param props - 见 {@link RefLibBrowserProps}。
+		* @returns 对话框元素（关闭时 Modal 返回 null）。
+		*/
+		function RefLibBrowser(props) {
+			const { open, onClose, listDirectory, t, onOpen } = props;
+			const [listing, setListing] = (0, react.useState)(null);
+			const [loading, setLoading] = (0, react.useState)(false);
+			const [error, setError] = (0, react.useState)(null);
+			const [pathDraft, setPathDraft] = (0, react.useState)(null);
+			const seq = (0, react.useRef)(0);
+			const controller = (0, react.useRef)(null);
+			const composing = (0, react.useRef)(false);
+			/** 新意图胜出：中止在途扫描并使旧结果失效。 */
+			const navigate = (target) => {
+				controller.current?.abort();
+				controller.current = null;
+				const mine = ++seq.current;
+				setLoading(true);
+				setError(null);
+				const ctrl = new AbortController();
+				controller.current = ctrl;
+				listDirectory(target, ctrl.signal).then((next) => {
+					if (mine !== seq.current) return;
+					setListing(next);
+					setLoading(false);
+				}, (cause) => {
+					if (mine !== seq.current) return;
+					setLoading(false);
+					setError(cause instanceof Error ? cause.message : String(cause));
+				});
+			};
+			(0, react.useEffect)(() => {
+				if (open) navigate();
+				else {
+					seq.current += 1;
+					controller.current?.abort();
+					controller.current = null;
+					setPathDraft(null);
+					setError(null);
+				}
+			}, [open]);
+			const openPathEditor = () => {
+				if (listing === null) {
+					setPathDraft("");
+					return;
+				}
+				const sep = separatorOf(listing);
+				const base = listing.path;
+				setPathDraft(base.endsWith(sep) ? base : base + sep);
+			};
+			const commitPath = () => {
+				const draft = pathDraft ?? "";
+				if (draft.trim() === "") return;
+				navigate(draft);
+				setPathDraft(null);
+			};
+			const crumbs = listing === null ? [] : displayCrumbs(listing, t("browser.home"));
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Modal, {
+				open,
+				onClose,
+				title: t("browser.title"),
+				closeLabel: t("browser.cancel"),
+				className: "reflib-browser",
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					className: "reflib-panel",
+					children: [
+						error !== null && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: "reflib-error",
+							role: "alert",
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconWarningOutline16, {
+								size: 14,
+								className: "reflib-errorIcon"
+							}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: error })]
+						}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+							className: "reflib-browserPath",
+							children: pathDraft === null ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								className: "reflib-browserCrumbs",
+								role: "navigation",
+								children: crumbs.map((crumb, index) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+									className: "reflib-browserCrumb",
+									children: [index > 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconChevronRightOutline14, {
+										size: 12,
+										className: "reflib-browserCrumbChevron"
+									}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+										type: "button",
+										className: "reflib-browserCrumbBtn",
+										disabled: loading,
+										onClick: () => {
+											navigate(crumb.path);
+										},
+										children: crumb.name
+									})]
+								}, crumb.path))
+							}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								className: "reflib-browserEdit",
+								"aria-label": t("browser.editPath"),
+								title: t("browser.editPath"),
+								disabled: loading,
+								onClick: openPathEditor,
+								children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconEditOutline16, { size: 14 })
+							})] }) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+								className: "reflib-browserInput",
+								value: pathDraft,
+								"aria-label": t("browser.editPath"),
+								placeholder: t("browser.pathPlaceholder"),
+								autoFocus: true,
+								disabled: loading,
+								onChange: (event) => {
+									setPathDraft(event.currentTarget.value);
+								},
+								onCompositionStart: () => {
+									composing.current = true;
+								},
+								onCompositionEnd: () => {
+									composing.current = false;
+								},
+								onKeyDown: (event) => {
+									if (event.key === "Enter" && !composing.current) {
+										event.preventDefault();
+										commitPath();
+									}
+									if (event.key === "Escape") {
+										event.stopPropagation();
+										setPathDraft(null);
+									}
+								}
+							})
+						}),
+						loading ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: "reflib-status",
+							role: "status",
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconLoadingOutline16, {
+								size: 20,
+								className: "reflib-spin reflib-statusIcon"
+							}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								className: "reflib-statusText",
+								children: t("browser.loading")
+							})]
+						}) : listing !== null && listing.entries.length === 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: "reflib-status",
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconFolderOpen16, {
+								size: 22,
+								className: "reflib-statusIcon"
+							}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								className: "reflib-statusText",
+								children: t("browser.empty")
+							})]
+						}) : listing !== null && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+							className: "reflib-browserList",
+							children: listing.entries.map((entry) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
+								type: "button",
+								className: "reflib-browserRow",
+								"aria-label": t("browser.enter.aria", { name: entry.name }),
+								disabled: loading,
+								onClick: () => {
+									navigate(entry.path);
+								},
+								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconFolderClose16, {
+									size: 16,
+									className: "reflib-browserRowIcon"
+								}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+									className: "reflib-browserRowName",
+									children: entry.name
+								})]
+							}, entry.path))
+						}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", { className: "reflib-divider" }),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: "reflib-browserFooter",
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+								variant: "outline",
+								size: "sm",
+								disabled: loading,
+								onClick: onClose,
+								children: t("browser.cancel")
+							}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+								variant: "primary",
+								size: "sm",
+								disabled: loading || listing === null,
+								"aria-label": t("browser.open.aria"),
+								onClick: () => {
+									if (listing !== null) onOpen(listing.path);
+								},
+								children: t("browser.open")
+							})]
+						})
+					]
+				})
+			});
+		}
+		//#endregion
+		//#region src/client/RefLibPanel.tsx
+		/**
+		* 参考库管理面板（Modal）：列表（基名 + 全路径、移除操作）+ 添加表单。
+		*
+		* 设计（优化点 1/2）：全部样式走 “--dsw-*” 设计令牌（随浅/深主题适配），
+		* 列表行以「基名为主行、完整路径为次行」呈现，移除为带危险 hover 的图标按钮，
+		* 添加为主按钮 + 路径输入（支持直接粘贴路径，绕开卡顿的系统选择器）+ 系统选择器
+		* 兜底；空态/加载态/错误态各有独立视觉。文案全部经 `t` 本地化（zh/en）。
+		* 本组件为纯展示：异步操作与错误归集由 RefLibDock 持有。
+		* @module @hpyperry/dsh-ref-lib/src/client/RefLibPanel
+		*/
+		/**
+		* 渲染参考库管理面板。
+		* @param props - 见 {@link RefLibPanelProps}。
+		* @returns 对话框元素（关闭时 Modal 返回 null）。
+		*/
+		function RefLibPanel(props) {
+			const { open, onClose, libs, loading, busy, picking, removingId, error, t, onRemove, onAddPath, onBrowse } = props;
+			const [draft, setDraft] = (0, react.useState)("");
+			(0, react.useEffect)(() => {
+				if (!open) setDraft("");
+			}, [open]);
+			const handleSubmit = async () => {
+				const trimmed = draft.trim();
+				if (trimmed === "") return;
+				try {
+					await onAddPath(trimmed);
+					setDraft("");
+				} catch {}
+			};
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Modal, {
+				open,
+				onClose,
+				title: t("panel.title"),
+				closeLabel: t("panel.close"),
+				description: t("panel.description", { count: String(libs.length) }),
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					className: "reflib-panel",
+					children: [
+						error !== null && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: "reflib-error",
+							role: "alert",
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconWarningOutline16, {
+								size: 14,
+								className: "reflib-errorIcon"
+							}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: error })]
+						}),
+						loading ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: "reflib-status",
+							role: "status",
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconLoadingOutline16, {
+								size: 20,
+								className: "reflib-spin reflib-statusIcon"
+							}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								className: "reflib-statusText",
+								children: t("list.loading")
+							})]
+						}) : libs.length === 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: "reflib-status",
+							children: [
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconFolderOpen16, {
+									size: 22,
+									className: "reflib-statusIcon"
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+									className: "reflib-statusText",
+									children: t("list.empty")
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+									className: "reflib-statusHint",
+									children: t("list.empty.hint")
+								})
+							]
+						}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+							className: "reflib-list",
+							children: libs.map((entry) => {
+								const name = libBasename(entry.path);
+								const removing = removingId === entry.id;
+								return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+									className: "reflib-row",
+									"data-removing": removing || void 0,
+									children: [
+										/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconFolderOpen16, {
+											size: 16,
+											className: "reflib-rowIcon"
+										}),
+										/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+											className: "reflib-rowBody",
+											children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+												className: "reflib-rowName",
+												title: entry.path,
+												children: name
+											}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+												className: "reflib-rowPath",
+												title: entry.path,
+												children: entry.path
+											})]
+										}),
+										/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Tooltip, {
+											label: t("list.remove"),
+											side: "top",
+											delayMs: 400,
+											children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+												type: "button",
+												className: "reflib-rowRemove",
+												"aria-label": t("list.remove.aria", { name }),
+												disabled: busy || removingId !== null,
+												onClick: () => {
+													onRemove(entry.id);
+												},
+												children: removing ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconLoadingOutline16, {
+													size: 14,
+													className: "reflib-spin"
+												}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconTrashOutline16, { size: 14 })
+											})
+										})
+									]
+								}, entry.id);
+							})
+						}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", { className: "reflib-divider" }),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: "reflib-add",
+							children: [
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+									className: "reflib-addLabel",
+									children: t("add.label")
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+									variant: "primary",
+									className: "reflib-addBrowseMain",
+									icon: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconSearchOutline16, { size: 16 }),
+									disabled: busy || picking,
+									onClick: () => {
+										onBrowse();
+									},
+									children: t("add.browse")
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+									className: "reflib-addManual",
+									children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+										className: "reflib-addManualLabel",
+										children: t("add.manual")
+									}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+										className: "reflib-addRow",
+										children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Input, {
+											className: "reflib-addInputWrap",
+											value: draft,
+											placeholder: t("add.placeholder"),
+											"aria-label": t("add.label"),
+											disabled: busy || picking,
+											onChange: (event) => {
+												setDraft(event.currentTarget.value);
+											},
+											onKeyDown: (event) => {
+												if (event.key === "Enter" && !event.nativeEvent.isComposing) {
+													event.preventDefault();
+													handleSubmit();
+												}
+											}
+										}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+											variant: "primary",
+											size: "sm",
+											icon: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconPlusOutline16, { size: 14 }),
+											disabled: busy || picking || draft.trim() === "",
+											onClick: () => {
+												handleSubmit();
+											},
+											children: t("add.submit")
+										})]
+									})]
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+									className: "reflib-addHint",
+									children: t("add.hint")
+								})
+							]
+						})
+					]
+				})
+			});
+		}
+		//#endregion
+		//#region src/client/styles.ts
+		/**
+		* ref-lib client 样式注入：在文档头挂一张本插件专属的 <style data-plugin> 标签。
+		*
+		* 为什么不用 CSS Modules：ref-lib 的 tsdown 配置未移植 core 的 lightningcss
+		* CSS-Modules 插件（避免新增 native 依赖与构建面），而内联 style 无法表达
+		* hover/媒体查询/动画。因此采用运行时注入单张样式表——与 loader 的清理契约
+		* 兼容（`data-plugin` 标签在插件卸载/HMR 时由 loader 移除，重新物化时本模块
+		* 重新注入，幂等）。类名统一 `reflib-` 前缀防碰撞；颜色/字号/圆角全部走
+		* `--dsw-*` 设计令牌，随主题（浅色/深色）自动适配——这是"字体显示不一致、
+		* 没有设计感"的根因修复之一（旧实现硬编码 #d33 等，不随主题变化）。
+		* @module @hpyperry/dsh-ref-lib/src/client/styles
+		*/
+		/** 插件 id（与 package.json 的 bundle 手递一致，loader 按它清理样式）。 */
+		const PLUGIN_ID = "@hpyperry/dsh-ref-lib";
+		/** 样式标签稳定 id（幂等注入的判据）。 */
+		const STYLE_TAG_ID = "@hpyperry/dsh-ref-lib/styles";
+		const CSS = `
+/* ── 输入卡正上方的入口胶囊行（dock）──
+   独立一行，横跨整个 composer 列；chip 与输入卡左缘对齐——用官方设计令牌
+   （--dsh-composer-side-clearance / --dsh-composer-card-max-width）纯 CSS 计算，
+   零 JS 测量（v7 起取消 hero 相位测量/绝对定位）；hero 与 active 一致，
+   plan/model 等工具行座位的启停不影响本行位置。 */
+.reflib-dock {
+  box-sizing: border-box;
+  display: flex;
+  align-items: center;
+  min-width: 0;
+  /* 镜像输入卡居中：chip 落在输入卡左缘之上（宽视口 = 居中余量，窄视口 = clearance） */
+  padding-left: max(
+    var(--dsh-composer-side-clearance, 16px),
+    calc((100% - var(--dsh-composer-card-max-width, 100%)) / 2)
+  );
+}
+
+.reflib-chip {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  max-width: 100%;
+  height: 30px;
+  padding: 0 10px 0 8px;
+  border: 1px solid var(--dsw-alias-border-l1);
+  border-radius: 15px;
+  background: transparent;
+  color: var(--dsw-alias-label-secondary);
+  font-size: 12px;
+  line-height: 18px;
+  font-weight: 500;
+  cursor: pointer;
+  transition: background-color 120ms ease, border-color 120ms ease;
+}
+
+.reflib-chip:hover {
+  background: var(--dsw-alias-interactive-bg-hover);
+  color: var(--dsw-alias-label-primary);
+}
+
+.reflib-chip:active {
+  background: var(--dsw-alias-interactive-bg-active);
+}
+
+.reflib-chip[data-active='true'] {
+  background: var(--dsw-alias-interactive-bg-hover);
+  border-color: var(--dsw-alias-border-l2);
+  color: var(--dsw-alias-label-primary);
+}
+
+.reflib-chipIcon {
+  display: inline-flex;
+  flex: none;
+  color: var(--dsw-alias-label-tertiary);
+}
+
+.reflib-chipLabel {
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.reflib-chipBadge {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  min-width: 18px;
+  height: 18px;
+  padding: 0 5px;
+  border-radius: 9px;
+  background: var(--dsw-alias-state-business-tertiary);
+  color: var(--dsw-alias-label-primary-bluish);
+  font-size: 11px;
+  line-height: 18px;
+  font-weight: 500;
+}
+
+/* ── 应用内目录浏览器（browse 后端）── */
+.reflib-browser {
+  width: min(460px, 100%);
+}
+
+.reflib-browserPath {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  min-width: 0;
+  height: 32px;
+  padding: 0 8px;
+  border: 1px solid var(--dsw-alias-border-l2);
+  border-radius: 8px;
+  background: var(--dsw-alias-bg-layer-1);
+}
+
+.reflib-browserCrumbs {
+  display: flex;
+  flex: 1;
+  align-items: center;
+  min-width: 0;
+  overflow-x: auto;
+  white-space: nowrap;
+  scrollbar-width: none;
+}
+
+.reflib-browserCrumbs::-webkit-scrollbar {
+  display: none;
+}
+
+.reflib-browserCrumb {
+  display: inline-flex;
+  align-items: center;
+  flex: none;
+}
+
+.reflib-browserCrumbChevron {
+  flex: none;
+  color: var(--dsw-alias-label-caption);
+}
+
+.reflib-browserCrumbBtn {
+  display: inline-flex;
+  align-items: center;
+  max-width: 160px;
+  padding: 2px 6px;
+  border: none;
+  border-radius: 6px;
+  background: transparent;
+  color: var(--dsw-alias-label-secondary);
+  font-size: 12px;
+  line-height: 18px;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  cursor: pointer;
+}
+
+.reflib-browserCrumbBtn:hover:not(:disabled) {
+  background: var(--dsw-alias-interactive-bg-hover);
+  color: var(--dsw-alias-label-primary);
+}
+
+.reflib-browserCrumbBtn:disabled {
+  opacity: 0.5;
+  cursor: default;
+}
+
+.reflib-browserEdit {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  flex: none;
+  width: 24px;
+  height: 24px;
+  padding: 0;
+  border: none;
+  border-radius: 6px;
+  background: transparent;
+  color: var(--dsw-alias-label-tertiary);
+  cursor: pointer;
+}
+
+.reflib-browserEdit:hover:not(:disabled) {
+  background: var(--dsw-alias-interactive-bg-hover);
+  color: var(--dsw-alias-label-primary);
+}
+
+.reflib-browserEdit:disabled {
+  opacity: 0.5;
+  cursor: default;
+}
+
+.reflib-browserInput {
+  flex: 1;
+  min-width: 0;
+  border: none;
+  outline: none;
+  background: transparent;
+  color: var(--dsw-alias-label-primary);
+  font-size: 12px;
+  line-height: 18px;
+}
+
+.reflib-browserInput::placeholder {
+  color: var(--dsw-alias-label-dimmed);
+}
+
+.reflib-browserList {
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+  max-height: 264px;
+  min-height: 60px;
+  overflow-y: auto;
+  margin: 0 -8px;
+  padding: 0 8px;
+}
+
+.reflib-browserRow {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  min-width: 0;
+  padding: 7px 8px;
+  border: none;
+  border-radius: 8px;
+  background: transparent;
+  color: var(--dsw-alias-label-primary);
+  font-size: 13px;
+  line-height: 18px;
+  cursor: pointer;
+  text-align: left;
+}
+
+.reflib-browserRow:hover:not(:disabled) {
+  background: var(--dsw-alias-interactive-bg-hover);
+}
+
+.reflib-browserRow:disabled {
+  opacity: 0.5;
+  cursor: default;
+}
+
+.reflib-browserRowIcon {
+  flex: none;
+  color: var(--dsw-alias-label-tertiary);
+}
+
+.reflib-browserRowName {
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.reflib-browserFooter {
+  display: flex;
+  align-items: center;
+  justify-content: flex-end;
+  gap: 8px;
+  min-width: 0;
+}
+
+/* ── 管理面板 ── */
+.reflib-panel {
+  display: flex;
+  flex-direction: column;
+  gap: 10px;
+  min-width: 0;
+}
+
+/* 列表：固定最大高度 + 内滚动（旧实现整个面板滚动、无设计，此处分层） */
+.reflib-list {
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+  max-height: 264px;
+  min-height: 0;
+  overflow-y: auto;
+  margin: 0 -8px;
+  padding: 0 8px;
+}
+
+.reflib-row {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  min-width: 0;
+  padding: 7px 8px;
+  border-radius: 10px;
+  background: transparent;
+  transition: background-color 120ms ease;
+}
+
+.reflib-row:hover {
+  background: var(--dsw-alias-interactive-bg-hover);
+}
+
+.reflib-row[data-removing='true'] {
+  opacity: 0.55;
+  pointer-events: none;
+}
+
+.reflib-rowIcon {
+  display: inline-flex;
+  flex: none;
+  color: var(--dsw-alias-label-tertiary);
+}
+
+.reflib-rowBody {
+  display: flex;
+  flex: 1;
+  flex-direction: column;
+  gap: 1px;
+  min-width: 0;
+}
+
+.reflib-rowName {
+  overflow: hidden;
+  color: var(--dsw-alias-label-primary);
+  font-size: 13px;
+  line-height: 18px;
+  font-weight: 500;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.reflib-rowPath {
+  overflow: hidden;
+  color: var(--dsw-alias-label-tertiary);
+  font-family: var(--ds-font-family-code);
+  font-size: 11px;
+  line-height: 16px;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.reflib-rowRemove {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  flex: none;
+  width: 28px;
+  height: 28px;
+  padding: 0;
+  border: none;
+  border-radius: 8px;
+  background: transparent;
+  color: var(--dsw-alias-label-tertiary);
+  cursor: pointer;
+  transition: background-color 120ms ease, color 120ms ease;
+}
+
+.reflib-rowRemove:hover:not(:disabled) {
+  background: var(--dsw-alias-interactive-bg-hover-danger);
+  color: var(--dsw-alias-state-error-primary);
+}
+
+.reflib-rowRemove:disabled {
+  opacity: 0.4;
+  cursor: default;
+}
+
+/* 空态 / 加载态 / 错误态 */
+.reflib-status {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 6px;
+  padding: 22px 8px;
+  color: var(--dsw-alias-label-caption);
+  text-align: center;
+}
+
+.reflib-statusIcon {
+  display: inline-flex;
+  color: var(--dsw-alias-label-tertiary);
+}
+
+.reflib-statusText {
+  font-size: 13px;
+  line-height: 18px;
+  font-weight: 500;
+  color: var(--dsw-alias-label-secondary);
+}
+
+.reflib-statusHint {
+  max-width: 260px;
+  font-size: 12px;
+  line-height: 18px;
+  color: var(--dsw-alias-label-caption);
+}
+
+.reflib-error {
+  display: flex;
+  align-items: flex-start;
+  gap: 6px;
+  padding: 6px 10px;
+  border-radius: 8px;
+  background: var(--dsw-alias-interactive-bg-hover-danger);
+  color: var(--dsw-alias-state-error-primary);
+  font-size: 12px;
+  line-height: 18px;
+  word-break: break-word;
+}
+
+.reflib-errorIcon {
+  display: inline-flex;
+  flex: none;
+  margin-top: 1px;
+}
+
+.reflib-spin {
+  animation: reflib-spin 800ms linear infinite;
+}
+
+@keyframes reflib-spin {
+  to {
+    transform: rotate(360deg);
+  }
+}
+
+.reflib-divider {
+  height: 1px;
+  margin: 2px 0;
+  background: var(--dsw-alias-border-l2);
+}
+
+/* ── 添加表单 ──
+   两组操作分离（优化点 2.1）：手动输入路径 + 「添加」是一组（主路径）；
+   「选择目录」是另一组备选方式，独占一行，避免并排造成困惑。 */
+.reflib-add {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  min-width: 0;
+}
+
+.reflib-addLabel {
+  font-size: 12px;
+  line-height: 16px;
+  font-weight: 500;
+  color: var(--dsw-alias-label-secondary);
+}
+
+/* 主方式：选择目录 —— 全宽主按钮（优先级最高） */
+.reflib-addBrowseMain {
+  width: 100%;
+}
+
+/* 备选：手动输入路径组 */
+.reflib-addManual {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  min-width: 0;
+}
+
+.reflib-addManualLabel {
+  font-size: 12px;
+  line-height: 16px;
+  color: var(--dsw-alias-label-caption);
+}
+
+.reflib-addRow {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  min-width: 0;
+}
+
+.reflib-addInputWrap {
+  flex: 1 1 180px;
+  min-width: 0;
+}
+
+/* 输入字体与面板一致（13px，同列表行名），placeholder 不再比整体大；
+   文案已缩短保证完整显示 */
+.reflib-addInputWrap > input {
+  width: 100%;
+  box-sizing: border-box;
+  font-size: 13px;
+  line-height: 18px;
+}
+
+.reflib-addHint {
+  font-size: 11px;
+  line-height: 16px;
+  color: var(--dsw-alias-label-caption);
+}
+
+/* 窄视口：主路径行换行，输入框占满一行 */
+@media (max-width: 440px) {
+  .reflib-addRow {
+    flex-wrap: wrap;
+  }
+
+  .reflib-addInputWrap {
+    flex: 1 1 100%;
+  }
+
+  .reflib-addRow > button:last-child {
+    margin-left: auto;
+  }
+}
+`;
+		/** 注入/确保样式表存在（幂等；HMR 重执行时旧标签已被 loader 移除，重新注入）。 */
+		function ensureRefLibStyles() {
+			if (typeof document === "undefined") return;
+			if (document.querySelector("style[data-plugin-css=\"@hpyperry/dsh-ref-lib/styles\"]") !== null) return;
+			const tag = document.createElement("style");
+			tag.dataset.plugin = PLUGIN_ID;
+			tag.dataset.pluginCss = STYLE_TAG_ID;
+			tag.textContent = CSS;
+			document.head.appendChild(tag);
+		}
+		//#endregion
+		//#region src/client/RefLibDock.tsx
+		/**
+		* 参考库入口（conversation.input.dock，输入卡正上方）+ 面板状态持有者。
+		*
+		* 位置（v7）：v5/v6 曾在 hero 相位把胶囊**测量定位**提入官方 hero 行（紧跟"标准
+		* 模式"chip 之后）。该像素测量与 hero 行的异步内容存在竞态——模式 chip 的 roster
+		* 经 RPC 异步挂载、Web 字体异步加载、其他插件 chip 异步加入——而重测触发面
+		* （hero 行/槽位出口/栈均为固定盒或 display:contents）对"行内内容变化"是盲区，
+		* 导致偶发与模式按钮重叠。v7 起**取消测量与绝对定位**：胶囊统一渲染在 dock 槽位
+		* （输入卡正上方）的独立一行，左缘经官方设计令牌（--dsh-composer-side-clearance /
+		* --dsh-composer-card-max-width）纯 CSS 与输入卡左缘对齐——hero/active 一致、
+		* 零 JS 测量、零竞态；plan/model 等工具行座位的启停不影响本行位置；与其他 dock
+		* 条带（todo/goal/queue）按 order 流式堆叠，天然不重叠。
+		*
+		* 数据（v4/v5）：读/写经 /api/ref-lib/* 路由（静默、无命令卡片）；
+		* 目录选择走系统原生选择器，另提供路径输入直加（绕开卡顿的原生对话框）。
+		* @module @hpyperry/dsh-ref-lib/src/client/RefLibDock
+		*/
+		/** wire 错误码 → 本地化文案键（未知码回退原始消息）。 */
+		const ERROR_KEYS = {
+			"ref-lib/missing": "error.missing",
+			"ref-lib/not-directory": "error.notDirectory",
+			"ref-lib/unsafe": "error.unsafe",
+			"ref-lib/unknown-id": "error.unknownId"
+		};
+		/** 把未知错误规整为可展示文案。 */
+		function messageOf(cause) {
+			return cause instanceof Error ? cause.message : String(cause);
+		}
+		/**
+		* 把 API 错误本地化：已知 wire code 映射为当前语言文案（带 path/id 参数），
+		* 其余错误原样展示服务端消息。
+		*/
+		function formatError(cause, t) {
+			if (cause instanceof RefLibApiError) {
+				const key = ERROR_KEYS[cause.code];
+				if (key !== void 0) return t(key, cause.details.path !== void 0 ? { path: cause.details.path } : cause.details.id !== void 0 ? { id: cause.details.id } : void 0);
+			}
+			return messageOf(cause);
+		}
+		ensureRefLibStyles();
+		/**
+		* 输入卡正上方的参考库入口：胶囊按钮（图标 + 文案 + 数量徽标）唤起管理面板。
+		* 位置由 .reflib-dock 的纯 CSS padding 与输入卡左缘对齐，无任何 JS 测量。
+		* @param props - sessionId 与注入面。
+		* @returns 胶囊入口（+ 打开时的管理面板）。
+		*/
+		function RefLibDock(props) {
+			const { sessionId, load, add, remove, pickDirectory, listDirectory, t } = props;
+			const [open, setOpen] = (0, react.useState)(false);
+			const [libs, setLibs] = (0, react.useState)([]);
+			const [loading, setLoading] = (0, react.useState)(false);
+			const [busy, setBusy] = (0, react.useState)(false);
+			const [picking, setPicking] = (0, react.useState)(false);
+			const [removingId, setRemovingId] = (0, react.useState)(null);
+			const [error, setError] = (0, react.useState)(null);
+			const seq = (0, react.useRef)(0);
+			const [pickerMode, setPickerMode] = (0, react.useState)(null);
+			const [browserOpen, setBrowserOpen] = (0, react.useState)(false);
+			const detectPicker = async () => {
+				if (pickerMode !== null) return pickerMode;
+				let mode;
+				try {
+					await listDirectory(void 0, new AbortController().signal);
+					mode = "browse";
+				} catch {
+					mode = "native";
+				}
+				setPickerMode(mode);
+				return mode;
+			};
+			const refresh = async () => {
+				const mine = ++seq.current;
+				try {
+					const next = await load(sessionId);
+					if (mine !== seq.current) return;
+					setLibs(next);
+					setError(null);
+				} catch (cause) {
+					if (mine !== seq.current) return;
+					setError(formatError(cause, t));
+				} finally {
+					if (mine === seq.current) setLoading(false);
+				}
+			};
+			(0, react.useEffect)(() => {
+				ensureRefLibStyles();
+				refresh();
+			}, [sessionId]);
+			(0, react.useEffect)(() => {
+				if (open) {
+					setLoading(true);
+					refresh();
+				}
+			}, [open]);
+			const handleRemove = async (id) => {
+				setRemovingId(id);
+				setBusy(true);
+				setError(null);
+				try {
+					await remove(sessionId, id);
+					await refresh();
+				} catch (cause) {
+					setError(formatError(cause, t));
+				} finally {
+					setRemovingId(null);
+					setBusy(false);
+				}
+			};
+			const handleAddPath = async (path) => {
+				setBusy(true);
+				setError(null);
+				try {
+					await add(sessionId, path);
+					await refresh();
+				} catch (cause) {
+					setError(formatError(cause, t));
+					throw cause;
+				} finally {
+					setBusy(false);
+				}
+			};
+			/** 添加一个已选定目录并刷新列表；返回是否成功（失败时错误已入错误槽，不抛出）。 */
+			const addPath = async (path) => {
+				setBusy(true);
+				setError(null);
+				try {
+					await add(sessionId, path);
+					await refresh();
+					return true;
+				} catch (cause) {
+					setError(formatError(cause, t));
+					return false;
+				} finally {
+					setBusy(false);
+				}
+			};
+			const handleBrowse = async () => {
+				setError(null);
+				let mode;
+				try {
+					mode = await detectPicker();
+				} catch (cause) {
+					setError(formatError(cause, t));
+					return;
+				}
+				if (mode === "browse") {
+					setBrowserOpen(true);
+					return;
+				}
+				setPicking(true);
+				try {
+					const picked = await pickDirectory();
+					if (picked !== null) await addPath(picked);
+				} catch (cause) {
+					setError(formatError(cause, t));
+				} finally {
+					setPicking(false);
+				}
+			};
+			/** 应用内浏览器选定目录 → 添加成功才关闭（失败时错误显示在面板，浏览器保持打开便于重试）。 */
+			const handleBrowserPick = async (path) => {
+				if (await addPath(path)) setBrowserOpen(false);
+			};
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+					className: "reflib-dock",
+					children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
+						type: "button",
+						className: "reflib-chip",
+						"data-active": open || void 0,
+						"aria-haspopup": "dialog",
+						"aria-expanded": open,
+						"aria-label": libs.length > 0 ? t("dock.count.aria", { count: String(libs.length) }) : t("dock.aria"),
+						title: t("dock.aria"),
+						onClick: () => {
+							setOpen((value) => !value);
+						},
+						children: [
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								className: "reflib-chipIcon",
+								children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconFolderOpen16, { size: 14 })
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								className: "reflib-chipLabel",
+								children: t("dock.label")
+							}),
+							libs.length > 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								className: "reflib-chipBadge",
+								children: libs.length
+							})
+						]
+					})
+				}),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)(RefLibPanel, {
+					open,
+					onClose: () => {
+						setOpen(false);
+					},
+					libs,
+					loading,
+					busy,
+					picking,
+					removingId,
+					error,
+					t,
+					onRemove: (id) => {
+						handleRemove(id);
+					},
+					onAddPath: handleAddPath,
+					onBrowse: handleBrowse
+				}),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)(RefLibBrowser, {
+					open: browserOpen,
+					onClose: () => {
+						setBrowserOpen(false);
+					},
+					listDirectory,
+					t,
+					onOpen: (path) => {
+						handleBrowserPick(path);
+					}
+				})
+			] });
+		}
+		//#endregion
+		//#region src/client/locales.ts
+		/**
+		* ref-lib client 本地化字典（zh 为键集唯一来源，en 与之逐键对齐）。
+		*
+		* 语言适配（优化点 2）：面板、入口胶囊与添加表单的全部文案经
+		* `ctx.locale.register(NS, { zh, en })` 注册，槽位注册声明 `locale: NS`，
+		* 组件经框架注入的 `t` seat 取词（活动语言实时切换，缺省回退 zh）。
+		* 键对等由 `satisfies Record<RefLibKey, string>` 在编译期强制。
+		* @module @hpyperry/dsh-ref-lib/src/client/locales
+		*/
+		/** 简体中文字典（键集唯一来源）。 */
+		const zh = {
+			"dock.label": "参考库",
+			"dock.aria": "管理只读参考库",
+			"dock.count.aria": "参考库，共 {count} 个",
+			"panel.title": "参考库",
+			"panel.close": "关闭",
+			"panel.description": "共 {count} 个只读参考库：供 agent 读取参考，禁止修改其中文件",
+			"list.remove": "移除",
+			"list.remove.aria": "移除参考库 {name}",
+			"list.empty": "还没有参考库",
+			"list.empty.hint": "在下方输入目录路径，或点击「选择目录」从系统选择",
+			"list.loading": "正在加载…",
+			"add.label": "添加参考库",
+			"add.placeholder": "输入目录路径（支持 ~ 与相对）",
+			"add.submit": "添加",
+			"add.manual": "或手动输入路径",
+			"add.browse": "选择目录",
+			"add.hint": "目录仅作只读参考；位于工作区之外时由系统强制只读",
+			"browser.title": "选择目录",
+			"browser.home": "主目录",
+			"browser.open": "选择此目录",
+			"browser.open.aria": "添加当前目录为参考库",
+			"browser.enter.aria": "进入目录 {name}",
+			"browser.editPath": "编辑路径",
+			"browser.pathPlaceholder": "输入绝对路径，回车跳转",
+			"browser.empty": "该目录下没有子目录",
+			"browser.loading": "加载中…",
+			"browser.cancel": "取消",
+			"error.missing": "目录不存在：{path}",
+			"error.notDirectory": "不是目录：{path}",
+			"error.unsafe": "路径包含控制字符，已拒绝：{path}",
+			"error.unknownId": "未找到参考库条目：{id}"
+		};
+		/** 英文词典，与 zh 键集逐键对齐（编译期校验）。 */
+		const en = {
+			"dock.label": "Reference Library",
+			"dock.aria": "Manage read-only reference libraries",
+			"dock.count.aria": "Reference library, {count} total",
+			"panel.title": "Reference Library",
+			"panel.close": "Close",
+			"panel.description": "{count} read-only reference libraries: the agent may read them for reference, but must not modify any files",
+			"list.remove": "Remove",
+			"list.remove.aria": "Remove reference library {name}",
+			"list.empty": "No reference libraries yet",
+			"list.empty.hint": "Enter a directory path below, or click “Choose directory” to pick one",
+			"list.loading": "Loading…",
+			"add.label": "Add a reference library",
+			"add.placeholder": "Enter a directory path (~ or relative)",
+			"add.submit": "Add",
+			"add.manual": "or enter a path manually",
+			"add.browse": "Choose directory",
+			"add.hint": "Directories are read-only references; outside the workspace they are enforced read-only by the system",
+			"browser.title": "Select Directory",
+			"browser.home": "Home",
+			"browser.open": "Select this folder",
+			"browser.open.aria": "Add the current directory as a reference library",
+			"browser.enter.aria": "Open folder {name}",
+			"browser.editPath": "Edit path",
+			"browser.pathPlaceholder": "Type an absolute path and press Enter",
+			"browser.empty": "No subdirectories here",
+			"browser.loading": "Loading…",
+			"browser.cancel": "Cancel",
+			"error.missing": "Directory does not exist: {path}",
+			"error.notDirectory": "Not a directory: {path}",
+			"error.unsafe": "Path contains control characters and was rejected: {path}",
+			"error.unknownId": "Reference library entry not found: {id}"
+		};
+		//#endregion
+		//#region src/client/index.ts
+		/** 所需服务（cordis fiber inject）。 */
+		const inject = [
+			"slots",
+			"workspaces",
+			"locale"
+		];
+		/** 本插件文案命名空间。 */
+		const NS = "ref-lib";
+		/**
+		* 一条对宿主 /api/ref-lib 路由族的 JSON 调用；失败时优先抛出带 wire code 的
+		* RefLibApiError（用于本地化），无 code 时回退普通 Error。
+		*/
+		async function api(path, payload, method = "POST") {
+			const res = await fetch("/api/ref-lib" + path, payload === void 0 ? void 0 : {
+				method,
+				headers: { "content-type": "application/json" },
+				body: JSON.stringify(payload)
+			});
+			let body = null;
+			try {
+				body = await res.json();
+			} catch {}
+			if (!res.ok) {
+				const parsed = parseApiErrorPayload(body);
+				if (parsed !== null) throw new RefLibApiError(parsed.code, parsed.message, parsed.details);
+				const message = body?.error ?? "HTTP " + res.status;
+				throw new Error(typeof message === "string" ? message : String(message));
+			}
+			return body;
+		}
+		/**
+		* 注册输入框上方的「参考库」入口与管理面板。
+		* @param ctx - client 根上下文。
+		*/
+		function apply(ctx) {
+			ctx.effect(() => ctx.locale.register(NS, {
+				zh,
+				en
+			}), "ref-lib: dictionaries");
+			const injected = () => ({
+				load: async (sessionId) => parseLibsPayload(await api(`/list?session=${encodeURIComponent(sessionId)}`, void 0, "GET")),
+				add: async (sessionId, path) => {
+					await api("/add", {
+						session: sessionId,
+						path
+					});
+				},
+				remove: async (sessionId, id) => {
+					await api("/remove", {
+						session: sessionId,
+						id
+					});
+				},
+				pickDirectory: () => ctx.workspaces.pickDirectory(),
+				listDirectory: (path, signal) => ctx.workspaces.listDirectory(path, signal)
+			});
+			ctx.slots.inject("conversation.input.dock", () => ctx.slots.register({
+				name: "conversation.input.dock",
+				id: "ref-lib",
+				order: 200,
+				locale: NS,
+				inject: injected
+			}, RefLibDock));
+		}
+		//#endregion
+		exports.apply = apply;
+		exports.inject = inject;
+		return module.exports;
+	}
+});
+
+//# sourceMappingURL=client.js.map