@dsh-plus/actual 0.1.0

package/lib/client.js

@@ -0,0 +1,924 @@
+window.__ModuleLoader__.load({
+	id: "@dsh-plus/actual",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		let react_jsx_runtime = require("react/jsx-runtime");
+		let react = require("react");
+		require("@deepseek-ai/dsh-client-ui-primitives");
+		//#region ../shared/src/client/card.tsx
+		const IDLE_STATUS = {
+			kind: "idle",
+			text: ""
+		};
+		function CardChrome(props) {
+			const p = props.prefix;
+			const badge = props.statusBadge;
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
+				className: `${p}-section`,
+				"aria-label": props.title,
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						className: `${p}-sectionHead`,
+						children: [
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h3", {
+								className: `${p}-sectionTitle`,
+								children: props.title
+							}),
+							badge !== void 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								className: `${p}-sectionBadge ${badge.on ? `${p}-statusOn` : `${p}-statusOff`}`,
+								children: badge.text
+							}) : null,
+							props.dirty ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								className: `${p}-pending`,
+								children: props.dirtyLabel
+							}) : null
+						]
+					}),
+					props.description === "" ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						className: `${p}-sectionDesc`,
+						children: props.description
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						className: `${p}-sectionBody`,
+						children: [
+							props.readOnlyNotice !== void 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+								className: `${p}-readOnly`,
+								role: "status",
+								children: props.readOnlyNotice
+							}) : null,
+							props.children,
+							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+								className: `${p}-sectionFooter`,
+								children: [props.status !== void 0 && props.status.kind !== "idle" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+									className: `${p}-status${props.status.kind === "error" ? ` ${p}-statusError` : ""}`,
+									role: "status",
+									children: props.status.text
+								}) : null, props.actions.map((action) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+									type: "button",
+									className: `${p}-btn ${action.variant === "primary" ? `${p}-btnPrimary` : `${p}-btnGhost`}`,
+									disabled: action.disabled === true,
+									onClick: action.onClick,
+									children: action.label
+								}, action.key))]
+							})
+						]
+					})
+				]
+			});
+		}
+		/** 取值未到达时的占位：与 CardChrome 同形态，避免宿主页里闪一次卡片外壳。 */
+		function CardLoading(props) {
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("section", {
+				className: `${props.prefix}-section`,
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+					className: `${props.prefix}-readOnly`,
+					role: "status",
+					children: props.text
+				})
+			});
+		}
+		//#endregion
+		//#region ../shared/src/client/config-slots.ts
+		/** dsh-plus 聚合 bundle 的包名（各插件 row 均经其补丁层插入 profile）。 */
+		const DSH_PLUS_BUNDLE = "@dsh-plus/bundle-main";
+		/**
+		* 把一张配置卡片注册进插件页的两个配置槽位。
+		* 两个槽位都由 0.2.1-alpha.1 的插件页声明，任一缺席即报错——不做版本探测。
+		*/
+		function injectPluginConfigCard(slots, reg) {
+			const base = {
+				locale: reg.ns,
+				inject: reg.inject
+			};
+			slots.inject("plugins.row.config", () => slots.register({
+				name: "plugins.row.config",
+				key: `${DSH_PLUS_BUNDLE}#${reg.rowId}`,
+				...base
+			}, reg.component));
+			slots.inject("plugins.bundle.config", () => slots.register({
+				name: "plugins.bundle.config",
+				key: reg.pkg,
+				...base
+			}, reg.component));
+		}
+		//#endregion
+		//#region ../shared/src/client/draft.ts
+		/**
+		* 单命名空间 staged 草稿（简单配置卡片共用）：读 scope 快照、播种草稿、
+		* 脏判定、保存（revision fencing + 重新装载）与状态行。
+		*
+		* 语义与官方 staged 表单一致：Host 更新不覆盖在途编辑，只有保存才写回；
+		* 保存成功后按 Host 解析值重置草稿。`from`/`patch` 参与 effect 与 useMemo
+		* 依赖，必须是模块级稳定函数（不要内联箭头函数）。
+		* @module @dsh-plus/shared/client/draft
+		*/
+		function useNamespaceDraft(options) {
+			const { scope, api, from, patch, saveFailedLabel } = options;
+			const snapshot = (0, react.useSyncExternalStore)((listener) => scope.subscribe(listener), () => scope.getSnapshot());
+			const value = snapshot.value;
+			const [draft, setDraftState] = (0, react.useState)(null);
+			const [saving, setSaving] = (0, react.useState)(false);
+			const [status, setStatus] = (0, react.useState)(IDLE_STATUS);
+			(0, react.useEffect)(() => {
+				if (value === void 0 || draft !== null) return;
+				setDraftState(from(value));
+			}, [
+				value,
+				draft,
+				from
+			]);
+			const dirty = (0, react.useMemo)(() => value !== void 0 && draft !== null && JSON.stringify(patch(draft)) !== JSON.stringify(patch(from(value))), [
+				value,
+				draft,
+				from,
+				patch
+			]);
+			const setDraft = (next) => {
+				setDraftState(next);
+				setStatus(IDLE_STATUS);
+			};
+			const edit = (part) => {
+				if (draft === null) return;
+				setDraft({
+					...draft,
+					...part
+				});
+			};
+			const reset = () => {
+				if (value === void 0) return;
+				setDraft(from(value));
+			};
+			const save = () => {
+				if (draft === null) return;
+				setSaving(true);
+				const revision = scope.getSnapshot().revision;
+				api.update(patch(draft), revision).then(async () => {
+					await scope.load();
+					const next = scope.getSnapshot().value;
+					if (next !== void 0) setDraftState(from(next));
+					setStatus(IDLE_STATUS);
+				}).catch((error) => {
+					const message = error instanceof Error ? error.message : String(error);
+					setStatus({
+						kind: "error",
+						text: `${saveFailedLabel}${message}`
+					});
+				}).finally(() => setSaving(false));
+			};
+			return {
+				value,
+				draft,
+				dirty,
+				saving,
+				status,
+				disabled: !snapshot.writable,
+				setDraft,
+				edit,
+				reset,
+				save
+			};
+		}
+		//#endregion
+		//#region ../shared/src/client/fields.tsx
+		function TextField(props) {
+			const p = props.prefix ?? "dshp";
+			const invalid = props.invalid === true;
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				className: `${p}-field`,
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						className: `${p}-head`,
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("label", {
+							className: `${p}-label`,
+							htmlFor: props.id,
+							children: props.label
+						}), props.badge !== void 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+							className: `${p}-badge ${props.badge.set ? `${p}-badgeSet` : `${p}-badgeUnset`}`,
+							children: props.badge.text
+						}) : null]
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+						id: props.id,
+						className: `${p}-input${invalid ? ` ${p}-inputInvalid` : ""}`,
+						type: props.password === true ? "password" : "text",
+						inputMode: props.numeric === true ? "numeric" : void 0,
+						autoComplete: props.password === true ? "off" : void 0,
+						"aria-invalid": invalid || void 0,
+						value: props.value,
+						disabled: props.disabled === true,
+						onChange: (event) => props.onEdit(event.target.value)
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						className: invalid ? `${p}-invalid` : `${p}-hint`,
+						children: invalid ? props.invalidLabel ?? "" : props.hint ?? ""
+					})
+				]
+			});
+		}
+		/**
+		* 勾选行：自绘圆角扁平开关（switch），对齐官方 WebUI 无原生 checkbox 的
+		* 设计语言（官方选择类控件全走胶囊/菜单，见 cardCss 的 -switch 规则）。
+		* 语义保持 checkbox（无障碍树与表单语义不变），视觉自绘。
+		*/
+		function CheckRow(props) {
+			const p = props.prefix ?? "dshp";
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				className: `${p}-checkRow`,
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+					id: props.id,
+					type: "checkbox",
+					role: "switch",
+					"aria-checked": props.checked,
+					checked: props.checked,
+					disabled: props.disabled === true,
+					onChange: (event) => props.onEdit(event.target.checked)
+				}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("label", {
+					htmlFor: props.id,
+					children: props.label
+				})]
+			});
+		}
+		function SelectField(props) {
+			const p = props.prefix ?? "dshp";
+			const invalid = props.invalid === true;
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				className: `${p}-field`,
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						className: `${p}-head`,
+						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("label", {
+							className: `${p}-label`,
+							htmlFor: props.id,
+							children: props.label
+						})
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("select", {
+						id: props.id,
+						className: `${p}-select${invalid ? ` ${p}-inputInvalid` : ""}`,
+						"aria-invalid": invalid || void 0,
+						value: props.value,
+						disabled: props.disabled === true,
+						onChange: (event) => props.onEdit(event.target.value),
+						children: props.options.map((option) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
+							value: option.value,
+							children: option.label
+						}, option.value))
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						className: invalid ? `${p}-invalid` : `${p}-hint`,
+						children: invalid ? props.invalidLabel ?? "" : props.hint ?? ""
+					})
+				]
+			});
+		}
+		//#endregion
+		//#region ../shared/src/client/i18n.ts
+		/** 卡片通用文案（save/discard/unsaved/loading 等四插件共有键）。 */
+		const commonZh = {
+			save: "保存",
+			saving: "保存中…",
+			discard: "放弃",
+			unsaved: "未保存",
+			loading: "加载中…",
+			unavailable: "配置服务不可用。",
+			readOnly: "当前部署无 settings provider，配置为只读；请编辑 settings.yaml。",
+			invalidNumber: "请输入正整数。",
+			collapse: "收起",
+			expand: "展开",
+			enabledOn: "已启用",
+			enabledOff: "未启用",
+			saveFailed: "保存失败，请检查填写内容。",
+			confirm: "确认",
+			cancel: "取消"
+		};
+		const commonEn = {
+			save: "Save",
+			saving: "Saving…",
+			discard: "Discard",
+			unsaved: "Unsaved",
+			loading: "Loading…",
+			unavailable: "Settings service unavailable.",
+			readOnly: "No settings provider in this deployment; config is read-only. Edit settings.yaml.",
+			invalidNumber: "Enter a positive integer.",
+			collapse: "Collapse",
+			expand: "Expand",
+			enabledOn: "On",
+			enabledOff: "Off",
+			saveFailed: "Save failed; check the fields.",
+			confirm: "Confirm",
+			cancel: "Cancel"
+		};
+		/**
+		* own 覆盖同键合并（返回新对象，入参不可变）。
+		* 返回类型保留两侧键集合，调用方据此派生 DictKey。
+		*/
+		function mergeDict(base, own) {
+			return {
+				...base,
+				...own
+			};
+		}
+		//#endregion
+		//#region ../shared/src/client/scope.ts
+		/**
+		* remote.settings 直连实现的命名空间 scope（官方配置页 tab 同款模式）。
+		* 读：describe 取命名空间视图（脱敏 value/revision + 顶层 writable）；
+		* 刷新：remote `settings/document-updated`（按命名空间过滤）与
+		* `connection/reset`；generation 防旧读覆盖新发布。任何页面 origin
+		* （loopback 或 tailnet 信任域名）下行为一致。
+		* effect 归属调用方 fiber（label 需含插件名以便诊断）。
+		*/
+		function createSettingsScope(c, ns, label) {
+			const remote = c.get("remote");
+			let state = {
+				status: "loading",
+				value: void 0,
+				revision: void 0,
+				writable: false
+			};
+			const listeners = /* @__PURE__ */ new Set();
+			let generation = 0;
+			const publish = (next) => {
+				state = next;
+				for (const listener of [...listeners]) listener();
+			};
+			const load = async () => {
+				const gen = ++generation;
+				let view;
+				try {
+					const response = await remote.settings.describe();
+					if (!response.ok) return;
+					view = response.value;
+				} catch {
+					return;
+				}
+				if (gen !== generation) return;
+				const namespace = view.namespaces.find((candidate) => candidate.ns === ns);
+				if (namespace === void 0) {
+					publish({
+						status: "unavailable",
+						value: void 0,
+						revision: void 0,
+						writable: view.writable
+					});
+					return;
+				}
+				publish({
+					status: "ready",
+					value: namespace.value,
+					revision: namespace.revision,
+					writable: view.writable
+				});
+			};
+			const refresh = (namespace) => {
+				if (namespace !== void 0 && namespace !== ns) return;
+				load();
+			};
+			const disposers = [remote.$on("settings/document-updated", refresh), c.on("connection/reset", () => {
+				load();
+			})];
+			c.effect(() => () => {
+				for (const dispose of disposers) dispose();
+			}, label);
+			load();
+			return {
+				getSnapshot: () => state,
+				subscribe: (listener) => {
+					listeners.add(listener);
+					return () => {
+						listeners.delete(listener);
+					};
+				},
+				load
+			};
+		}
+		/** 以 remote.settings 构造命名空间绑定的 api 面。 */
+		function createNamespaceApi(remote, ns) {
+			return {
+				update: async (patch, expectedRevision) => {
+					const response = await remote.update(ns, patch, expectedRevision);
+					if (!response.ok) throw new Error(response.error.message ?? "settings update failed");
+				},
+				describe: async () => {
+					const response = await remote.describe();
+					if (!response.ok) throw new Error(response.error.message ?? "settings describe failed");
+					return response.value;
+				}
+			};
+		}
+		//#endregion
+		//#region ../shared/src/client/styles.ts
+		/**
+		* 配置分节样式工厂（各插件 client 的公共收编版）。
+		*
+		* 目标宿主 dsh 0.2.1-alpha.1：插件页把配置视图放进已有页面级内边距的容器里
+		* （`div.detailSections[data-plugin-config]` 或 `section.detailSection[data-plugin-config]`），
+		* 外层无边框——故这里输出的是**无边框分节**（小节标题 13px/600、字段 12px 0、
+		* 横向零内边距、页脚非 sticky），度量对齐官方设置页
+		* （`@deepseek-ai/dsh-client-ui-primitives` 的 settings-form）。
+		*
+		* 移动端与可达性（767px 断点 + pointer:coarse，对齐 ui-mobile-fit 约定）：
+		* - 窄屏 input/textarea 16px（防 iOS 聚焦缩放）、可点目标 ≥44px；
+		* - 页脚按钮等宽换行、状态文字独占一行。
+		* 沿用官方 data-plugin / data-plugin-css 约定（HMR 据此卸载），不覆盖上游选择器。
+		* @module @dsh-plus/shared/client/styles
+		*/
+		/** 生成全套分节 CSS；prefix 为插件类名前缀（如 'dne'），extra 为插件特有规则。 */
+		function cardCss(prefix, extra = "") {
+			return `
+.${prefix}-section{box-sizing:border-box;flex-direction:column;width:100%;min-width:0;padding:16px 0;display:flex}
+.${prefix}-sectionHead{align-items:center;gap:8px;min-width:0;display:flex}
+.${prefix}-sectionTitle{min-width:0;color:var(--dsw-alias-label-primary);flex:1;margin:0;font-size:13px;font-weight:600;line-height:1.5}
+.${prefix}-sectionBadge{white-space:nowrap;border-radius:999px;flex:none;padding:1px 8px;font-size:11px;font-weight:500;line-height:17px}
+.${prefix}-sectionDesc{color:var(--dsw-alias-label-tertiary);margin:4px 0 0;font-size:12px;line-height:1.5}
+.${prefix}-sectionBody{flex-direction:column;min-width:0;display:flex}
+.${prefix}-sectionFooter{align-items:center;gap:8px;padding-top:16px;display:flex;flex-wrap:wrap}
+.${prefix}-pending{white-space:nowrap;background:var(--dsw-alias-bg-module-platform);color:var(--dsw-alias-label-secondary);border-radius:999px;flex:none;padding:1px 8px;font-size:11px;font-weight:500;line-height:17px}
+.${prefix}-statusOn{background:var(--dsw-alias-bg-module-platform);color:var(--dsw-alias-label-secondary)}
+.${prefix}-statusOff{color:var(--dsw-alias-label-tertiary)}
+.${prefix}-field{flex-direction:column;gap:6px;padding:12px 0;display:flex}
+.${prefix}-field+.${prefix}-field{border-top:1px solid var(--dsw-alias-border-l2)}
+.${prefix}-head{align-items:center;gap:8px;display:flex}
+.${prefix}-label{min-width:0;color:var(--dsw-alias-label-primary);flex:1;font-size:13px;font-weight:500;line-height:1.5}
+.${prefix}-badge{white-space:nowrap;border-radius:999px;padding:1px 8px;font-size:11px;font-weight:500;line-height:17px}
+.${prefix}-badgeSet{background:var(--dsw-alias-bg-module-platform);color:var(--dsw-alias-label-secondary)}
+.${prefix}-badgeUnset{color:var(--dsw-alias-label-tertiary)}
+.${prefix}-input{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-3);height:34px;font:inherit;color:var(--dsw-alias-label-primary);border-radius:8px;padding:0 12px;font-size:13px;transition:border-color .18s,background .18s}
+.${prefix}-input:hover:not(:disabled):not(:focus-visible){border-color:var(--dsw-alias-label-dimmed)}
+.${prefix}-input:focus-visible{border-color:var(--dsw-alias-brand-primary);outline:none}
+.${prefix}-input:disabled{color:var(--dsw-alias-label-tertiary);cursor:default}
+.${prefix}-inputInvalid{border-color:var(--dsw-alias-label-error)}
+.${prefix}-select{appearance:none;background:var(--dsw-alias-bg-module-platform);border:none;cursor:pointer;background-image:linear-gradient(45deg,transparent 50%,var(--dsw-alias-label-secondary) 50%),linear-gradient(135deg,var(--dsw-alias-label-secondary) 50%,transparent 50%);background-position:calc(100% - 16px) 50%,calc(100% - 11px) 50%;background-size:5px 5px;background-repeat:no-repeat;color:var(--dsw-alias-label-primary);font:inherit;font-size:13px;height:34px;box-sizing:border-box;border-radius:8px;padding:0 30px 0 12px;transition:background-color .18s}
+.${prefix}-select:hover:not(:disabled){background-color:var(--dsw-alias-interactive-bg-hover)}
+.${prefix}-hint{color:var(--dsw-alias-label-tertiary);margin:0;font-size:12px;line-height:1.5}
+.${prefix}-invalid{color:var(--dsw-alias-label-error);margin:0;font-size:12px;line-height:1.5}
+.${prefix}-checkRow{align-items:center;gap:10px;display:flex;padding:6px 0}
+.${prefix}-checkRow label{color:var(--dsw-alias-label-primary);font-size:13px;line-height:1.5;cursor:pointer;flex:1;min-width:0}
+/* 自绘圆角扁平开关（官方 UI 无可见原生 checkbox，选择类全走胶囊/菜单） */
+.${prefix}-checkRow input{appearance:none;-webkit-appearance:none;position:relative;box-sizing:border-box;background:var(--dsw-alias-bg-module-platform);border:none;border-radius:999px;width:34px;height:20px;flex:none;cursor:pointer;transition:background .18s;margin:0}
+.${prefix}-checkRow input::after{content:"";position:absolute;top:2px;left:2px;background:var(--dsw-alias-label-primary);border-radius:999px;width:16px;height:16px;transition:left .18s cubic-bezier(.4,0,.2,1)}
+.${prefix}-checkRow input:checked{background:var(--dsw-alias-brand-primary)}
+.${prefix}-checkRow input:checked::after{left:16px;background:var(--dsw-alias-bg-base)}
+.${prefix}-checkRow input:disabled{opacity:.4;cursor:default}
+.${prefix}-checkRow input:focus-visible{outline:2px solid var(--dsw-alias-brand-primary);outline-offset:2px}
+.${prefix}-groupLabel{color:var(--dsw-alias-label-secondary);font-size:12px;font-weight:600;padding:12px 0 2px;margin:0}
+.${prefix}-readOnly{color:var(--dsw-alias-label-tertiary);margin:12px 0 0;font-size:12px;line-height:1.5}
+.${prefix}-warn{color:var(--dsw-alias-label-error);margin:12px 0 0;font-size:12px;line-height:1.5}
+.${prefix}-status{min-width:0;color:var(--dsw-alias-label-secondary);flex:1;margin:0;font-size:12px;line-height:1.5}
+.${prefix}-statusError{color:var(--dsw-alias-label-error)}
+.${prefix}-btn{appearance:none;font:inherit;cursor:pointer;border:1px solid #0000;border-radius:8px;padding:5px 14px;font-size:13px;line-height:1.5}
+.${prefix}-btnGhost{border-color:var(--dsw-alias-border-l2);color:var(--dsw-alias-label-secondary);background:0 0}
+.${prefix}-btnGhost:hover:not(:disabled){color:var(--dsw-alias-label-primary);border-color:var(--dsw-alias-label-dimmed)}
+.${prefix}-btnPrimary{background:var(--dsw-alias-label-primary);color:var(--dsw-alias-bg-layer-3)}
+.${prefix}-btn:disabled{opacity:.4;cursor:default}
+.${prefix}-btn:focus-visible{outline:2px solid var(--dsw-alias-brand-primary);outline-offset:1px}
+@media (max-width:767px){
+.${prefix}-input,.${prefix}-select{font-size:16px;height:40px}
+.${prefix}-checkRow{min-height:44px;padding:8px 0}
+.${prefix}-status{flex-basis:100%;flex:none}
+.${prefix}-btn{min-height:44px;flex:1;min-width:96px}
+}
+@media (pointer:coarse){
+.${prefix}-btn{min-height:44px}
+.${prefix}-checkRow{min-height:44px}
+.${prefix}-input,.${prefix}-select{height:40px}
+}
+${extra}
+`;
+		}
+		/**
+		* 幂等注入样式标签（官方 data-plugin-css 约定）；返回新标签，
+		* 已存在或环境无 document 时返回 null（调用方 effect 卸载用）。
+		*/
+		function injectCardStyle(pluginId, css) {
+			if (typeof document === "undefined") return null;
+			const tagId = `${pluginId}/card.css`;
+			if (document.querySelector(`style[data-plugin-css=${JSON.stringify(tagId)}]`) !== null) return null;
+			const tag = document.createElement("style");
+			tag.dataset.plugin = pluginId;
+			tag.dataset.pluginCss = tagId;
+			tag.textContent = css;
+			document.head.appendChild(tag);
+			return tag;
+		}
+		//#endregion
+		//#region src/ns.ts
+		/**
+		* settings 命名空间字面量（纯常量，零依赖）。
+		*
+		* 宿主以字面量注册 settings section（用户层配置经 dsh-settings-file 持久化，
+		* 热生效）；与行级 cordis Config 共用同一份 schemastery schema（config.ts）。
+		* 浏览器半的配置卡片按同一字面量读写。
+		* @module @dsh-plus/actual/ns
+		*/
+		const SETTINGS_NS = "dsh-plus-actual";
+		//#endregion
+		//#region src/client/draft.ts
+		/** argv → 卡片文本（空格分隔）。 */
+		function argvToText(argv) {
+			return argv.join(" ");
+		}
+		/** 卡片文本 → argv；纯空白视为「自动探测」（空数组）。 */
+		function textToArgv(text) {
+			const trimmed = text.trim();
+			return trimmed === "" ? [] : trimmed.split(/\s+/);
+		}
+		/** 命名空间解析值 → 草稿。 */
+		function draftFromValue(value) {
+			return {
+				enabled: value.enabled,
+				serverUrl: value.serverUrl,
+				syncId: value.syncId,
+				cliCommand: argvToText(value.cliCommand),
+				cliVersionPolicy: value.cliVersionPolicy,
+				confirmWrites: value.confirmWrites,
+				auxTools: value.auxTools,
+				namePrefix: value.namePrefix
+			};
+		}
+		/** 草稿 → 命名空间补丁（仅本卡片负责的字段）。 */
+		function patchFromDraft(draft) {
+			return {
+				enabled: draft.enabled,
+				serverUrl: draft.serverUrl.trim(),
+				syncId: draft.syncId.trim(),
+				cliCommand: textToArgv(draft.cliCommand),
+				cliVersionPolicy: draft.cliVersionPolicy,
+				confirmWrites: draft.confirmWrites,
+				auxTools: draft.auxTools,
+				namePrefix: draft.namePrefix.trim()
+			};
+		}
+		/** 首个校验问题；全部合法返回 undefined（调用方据此禁用保存）。 */
+		function validateDraft(draft) {
+			if (!/^https?:\/\/\S+$/.test(draft.serverUrl.trim())) return {
+				field: "serverUrl",
+				messageKey: "serverUrlInvalid"
+			};
+			if (/["']/.test(draft.cliCommand)) return {
+				field: "cliCommand",
+				messageKey: "cliCommandInvalid"
+			};
+			if (!/^[A-Za-z0-9_-]*$/.test(draft.namePrefix.trim())) return {
+				field: "namePrefix",
+				messageKey: "namePrefixInvalid"
+			};
+		}
+		//#endregion
+		//#region src/client/card.tsx
+		/**
+		* 「Actual Budget 连接」配置卡片：经 injectPluginConfigCard 注册（插件页
+		* plugins.row.config / plugins.bundle.config，view 分发 summary/page）。
+		*
+		* 编辑范围只覆盖**非密钥**字段。密钥与高级字段没有编辑器，卡片内给出明确落点
+		* （见 i18n 的 secretsBody / advancedBody）——按《插件开发指南》，可配置项要么
+		* 有编辑器、要么写明为什么没有与改在哪里配。
+		*
+		* 字段按主题拆成两个小节组件，卡片本体只负责外壳、状态与保存动作。
+		* @module @dsh-plus/actual/client/card
+		*/
+		/** 模块级稳定函数：参与 useNamespaceDraft 的依赖比较。 */
+		function fromValue(value) {
+			return draftFromValue(value);
+		}
+		function toPatch(draft) {
+			return patchFromDraft(draft);
+		}
+		/**
+		* 条件式 invalid 属性：`exactOptionalPropertyTypes` 下不可显式传 `invalidLabel: undefined`，
+		* 只能按「有文案才带该键」构造。
+		*/
+		function violationProps(active, label) {
+			return active ? {
+				invalid: true,
+				invalidLabel: label
+			} : { invalid: false };
+		}
+		/** 说明段落（无编辑器的字段在此交代落点）。 */
+		function Note(props) {
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				className: "act-note",
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						className: "act-noteTitle",
+						children: props.title
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						className: "act-noteBody",
+						children: props.body
+					}),
+					props.snippet !== void 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("code", {
+						className: "act-snippet",
+						children: props.snippet
+					}) : null,
+					props.tail !== void 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						className: "act-noteBody",
+						children: props.tail
+					}) : null
+				]
+			});
+		}
+		/** 连接小节：服务器地址、预算、CLI 命令与版本策略。 */
+		function ConnectionSection(props) {
+			const { t, draft, disabled, violation, onEdit } = props;
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)(TextField, {
+					prefix: "act",
+					id: "act-server-url",
+					label: t("serverUrl"),
+					hint: t("serverUrlHint"),
+					value: draft.serverUrl,
+					disabled,
+					...violationProps(violation?.field === "serverUrl", t("serverUrlInvalid")),
+					onEdit: (value) => onEdit({ serverUrl: value })
+				}),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)(TextField, {
+					prefix: "act",
+					id: "act-sync-id",
+					label: t("syncId"),
+					hint: t("syncIdHint"),
+					value: draft.syncId,
+					disabled,
+					onEdit: (value) => onEdit({ syncId: value })
+				}),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)(TextField, {
+					prefix: "act",
+					id: "act-cli-command",
+					label: t("cliCommand"),
+					hint: t("cliCommandHint"),
+					value: draft.cliCommand,
+					disabled,
+					...violationProps(violation?.field === "cliCommand", t("cliCommandInvalid")),
+					onEdit: (value) => onEdit({ cliCommand: value })
+				}),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)(SelectField, {
+					prefix: "act",
+					id: "act-version-policy",
+					label: t("cliVersionPolicy"),
+					hint: t("cliVersionPolicyHint"),
+					value: draft.cliVersionPolicy,
+					options: [{
+						value: "warn",
+						label: t("policyWarn")
+					}, {
+						value: "strict",
+						label: t("policyStrict")
+					}],
+					disabled,
+					onEdit: (value) => onEdit({ cliVersionPolicy: value === "strict" ? "strict" : "warn" })
+				})
+			] });
+		}
+		/** 行为小节：写确认、辅助工具与工具名前缀。 */
+		function PolicySection(props) {
+			const { t, draft, disabled, violation, onEdit } = props;
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)(CheckRow, {
+					prefix: "act",
+					id: "act-confirm-writes",
+					label: t("confirmWrites"),
+					checked: draft.confirmWrites,
+					disabled,
+					onEdit: (value) => onEdit({ confirmWrites: value })
+				}),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+					className: "act-noteBody",
+					children: t("confirmWritesHint")
+				}),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)(CheckRow, {
+					prefix: "act",
+					id: "act-aux-tools",
+					label: t("auxTools"),
+					checked: draft.auxTools,
+					disabled,
+					onEdit: (value) => onEdit({ auxTools: value })
+				}),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+					className: "act-noteBody",
+					children: t("auxToolsHint")
+				}),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)(TextField, {
+					prefix: "act",
+					id: "act-name-prefix",
+					label: t("namePrefix"),
+					hint: t("namePrefixHint"),
+					value: draft.namePrefix,
+					disabled,
+					...violationProps(violation?.field === "namePrefix", t("namePrefixInvalid")),
+					onEdit: (value) => onEdit({ namePrefix: value })
+				})
+			] });
+		}
+		function ActualCard(props) {
+			const { t, scope, api } = props;
+			const { draft, dirty, saving, status, disabled, edit, reset, save } = useNamespaceDraft({
+				scope,
+				api,
+				from: fromValue,
+				patch: toPatch,
+				saveFailedLabel: t("saveFailed")
+			});
+			if (props.view === "summary") return t("summaryLine");
+			if (draft === null) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CardLoading, {
+				prefix: "act",
+				text: t("loading")
+			});
+			const violation = validateDraft(draft);
+			const section = {
+				t,
+				draft,
+				disabled,
+				violation,
+				onEdit: edit
+			};
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(CardChrome, {
+				prefix: "act",
+				title: t("title"),
+				description: t("description"),
+				statusBadge: {
+					text: t(draft.enabled ? "enabledOn" : "enabledOff"),
+					on: draft.enabled
+				},
+				dirty,
+				dirtyLabel: t("unsaved"),
+				readOnlyNotice: disabled ? t("readOnly") : void 0,
+				status,
+				actions: [{
+					key: "discard",
+					label: t("discard"),
+					disabled: !dirty || saving,
+					onClick: reset
+				}, {
+					key: "save",
+					label: t(saving ? "saving" : "save"),
+					variant: "primary",
+					disabled: !dirty || saving || violation !== void 0 || disabled,
+					onClick: save
+				}],
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(CheckRow, {
+						prefix: "act",
+						id: "act-enabled",
+						label: t("enabled"),
+						checked: draft.enabled,
+						disabled,
+						onEdit: (value) => edit({ enabled: value })
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						className: "act-noteBody",
+						children: t("enabledHint")
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ConnectionSection, { ...section }),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(PolicySection, { ...section }),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Note, {
+						title: t("secretsTitle"),
+						body: t("secretsBody"),
+						snippet: t("secretsSnippet"),
+						tail: t("secretsTail")
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Note, {
+						title: t("advancedTitle"),
+						body: t("advancedBody")
+					})
+				]
+			});
+		}
+		//#endregion
+		//#region src/client/i18n.ts
+		/**
+		* 配置卡片文案（zh/en）。经 ctx.locale.register 注册、bind 取用。
+		* 公共键（save/discard/unsaved 等）来自 shared 的 common 字典，本文件只维护业务键。
+		*
+		* 两处说明文案是有意为之的「落点」：密钥与高级字段都没有编辑器，必须在卡片内
+		* 写清「为什么没有、该去哪里配」，否则就是留给用户的空承诺。
+		* @module @dsh-plus/actual/client/i18n
+		*/
+		const NS = "dsh-plus-actual";
+		const ownZh = {
+			title: "Actual Budget 连接",
+			description: "配置本机 Actual 同步服务器与 CLI 行为。改动热生效，无需重载：连接相关字段会触发能力重新发现。",
+			summaryLine: "Actual 服务器地址、预算 Sync ID、CLI 与工具策略。",
+			enabled: "启用 actual 预设",
+			enabledHint: "关闭即不注册该预设（等价插件未安装）；已开的会话保持原组合，新会话起不再出现。",
+			serverUrl: "同步服务器地址",
+			serverUrlHint: "自托管默认 http://127.0.0.1:5006。服务端版本从 <地址>/info 读取，用于版本一致性告警。",
+			serverUrlInvalid: "必须是 http(s):// 开头的完整地址",
+			syncId: "预算 Sync ID",
+			syncIdHint: "Actual 客户端 → 设置 → 显示高级设置 → Sync ID。留空则读环境变量 ACTUAL_SYNC_ID。多数命令都需要它。",
+			cliCommand: "CLI 命令",
+			cliCommandHint: "留空 = 自动探测（ACTUAL_CLI 环境变量 → PATH 上的 actual → 包内 @actual-app/cli）。需要指定具体副本时填完整 argv，如 node /opt/actual/dist/cli.js（空格分隔，不支持引号）。",
+			cliCommandInvalid: "不支持引号：请直接以空格分隔各个参数",
+			cliVersionPolicy: "版本不一致处置",
+			cliVersionPolicyHint: "CLI 与服务端 major.minor 不一致时：warn 告警继续（Actual 服务端只做同步中继，通常仍可用）；strict 直接让发现失败。",
+			policyWarn: "warn —— 告警并继续",
+			policyStrict: "strict —— 直接失败",
+			confirmWrites: "写操作需确认",
+			confirmWritesHint: "经 DSH 审批策略生效：会话为「每次询问」时弹审批窗；「完全权限」下自动通过（绝不静默拒绝）。",
+			auxTools: "挂载辅助工具",
+			auxToolsHint: "额外提供 web 检索、结构化提问与待办跟踪三件套；它们不改动预算数据。",
+			namePrefix: "工具名前缀",
+			namePrefixHint: "模型可见的工具名 = 前缀 + 命令族名（如 actual_accounts）。留空则直接用裸族名——query、server 等过于通用，不建议。",
+			namePrefixInvalid: "只允许字母、数字、下划线与连字符",
+			secretsTitle: "服务器口令",
+			secretsBody: "口令属密钥：它不进用户层配置，卡片也不提供输入框（写进来会被脱敏遮蔽，等于白填）。请在 profile 的 cordis.patch.yml 里做行级注入，口令本身放环境变量：",
+			secretsSnippet: "- id: dsh-plus-actual\n  config:\n    syncId: !!js process.env.ACTUAL_SYNC_ID\n    password: !!js process.env.ACTUAL_PASSWORD",
+			secretsTail: "把 ACTUAL_PASSWORD 放进 dsh 服务进程的环境（systemd 的 EnvironmentFile）。官方 CLI 还支持 ACTUAL_PASSWORD_FILE——更适合密钥文件；encrypted 预算另需 ACTUAL_ENCRYPTION_PASSWORD。改动环境变量后需重启 dsh 服务。",
+			advancedTitle: "其余字段",
+			advancedBody: "以下字段只在 profile 的 cordis.patch.yml 里配置：预算目录与超时（dataDir / cacheTtl / lockTimeout / toolCallTimeoutMs）、工具暴露与读写判定（allow / deny / readActions / alwaysAsk / readTools）、预设显示与提示词（name / description / order / personaPrefix / includeRuntimeContext）。"
+		};
+		const ownEn = {
+			title: "Actual Budget connection",
+			description: "Configure the local Actual sync server and CLI behaviour. Changes apply hot — connection fields trigger a fresh capability discovery.",
+			summaryLine: "Actual server address, budget sync ID, CLI and tool policy.",
+			enabled: "Enable the actual preset",
+			enabledHint: "Off stops registering the preset (equivalent to not installed). Live sessions keep their composition; new ones will not see it.",
+			serverUrl: "Sync server URL",
+			serverUrlHint: "Self-hosted default is http://127.0.0.1:5006. The server version is read from <url>/info for the version-mismatch warning.",
+			serverUrlInvalid: "Must be a full http(s):// URL",
+			syncId: "Budget sync ID",
+			syncIdHint: "Actual client → Settings → Show advanced settings → Sync ID. Empty falls back to the ACTUAL_SYNC_ID environment variable. Most commands need it.",
+			cliCommand: "CLI command",
+			cliCommandHint: "Empty = auto-detect (ACTUAL_CLI env → actual on PATH → bundled @actual-app/cli). To pin a specific copy, give the full argv, e.g. node /opt/actual/dist/cli.js (space-separated, no quotes).",
+			cliCommandInvalid: "Quotes are not supported: separate arguments with spaces",
+			cliVersionPolicy: "On version mismatch",
+			cliVersionPolicyHint: "When CLI and server major.minor differ: warn keeps going (the Actual server is a sync relay, usually still fine); strict fails discovery outright.",
+			policyWarn: "warn — alert and continue",
+			policyStrict: "strict — fail outright",
+			confirmWrites: "Confirm write operations",
+			confirmWritesHint: "Routed through the DSH approval policy: prompts when the session asks every time, passes automatically under full permission (never silently denies).",
+			auxTools: "Mount auxiliary tools",
+			auxToolsHint: "Adds web search, structured questions and todo tracking; none of them touch budget data.",
+			namePrefix: "Tool name prefix",
+			namePrefixHint: "Model-visible tool name = prefix + command family (e.g. actual_accounts). Empty uses bare family names — query, server and tags are too generic, so a prefix is advised.",
+			namePrefixInvalid: "Letters, digits, underscore and hyphen only",
+			secretsTitle: "Server password",
+			secretsBody: "The password is a secret: it never enters the user-layer configuration, and this card offers no input for it (a value written here is masked away — filling it in would do nothing). Inject it at the profile row in cordis.patch.yml and keep the value in the environment:",
+			secretsSnippet: "- id: dsh-plus-actual\n  config:\n    syncId: !!js process.env.ACTUAL_SYNC_ID\n    password: !!js process.env.ACTUAL_PASSWORD",
+			secretsTail: "Put ACTUAL_PASSWORD into the dsh service process environment (systemd EnvironmentFile). The official CLI also supports ACTUAL_PASSWORD_FILE, which suits secret files better; an encrypted budget additionally needs ACTUAL_ENCRYPTION_PASSWORD. Restart the dsh service after changing environment variables.",
+			advancedTitle: "Remaining fields",
+			advancedBody: "These are configured only in the profile cordis.patch.yml: budget directory and timeouts (dataDir / cacheTtl / lockTimeout / toolCallTimeoutMs), tool exposure and read/write classification (allow / deny / readActions / alwaysAsk / readTools), and preset display and prompt (name / description / order / personaPrefix / includeRuntimeContext)."
+		};
+		const zh = mergeDict(commonZh, ownZh);
+		const en = mergeDict(commonEn, ownEn);
+		//#endregion
+		//#region src/client/styles.ts
+		/**
+		* 配置卡片样式：基础规则走 @dsh-plus/shared/client 的 cardCss('act')，
+		* 本文件只补插件特有规则（说明段落与代码片段）。
+		* 沿用官方 data-plugin / data-plugin-css 约定（HMR 据此卸载）。
+		* @module @dsh-plus/actual/client/styles
+		*/
+		const PLUGIN_ID = "@dsh-plus/actual";
+		const cardCssAll = cardCss("act", `
+.act-note{margin:14px 0 0;padding:10px 12px;border-radius:8px;background:var(--dsw-alias-bg-base);border:1px solid var(--dsw-alias-border-l2)}
+.act-noteTitle{margin:0 0 6px;font-size:13px;font-weight:600}
+.act-noteBody{margin:0;color:var(--dsw-alias-label-secondary);font-size:12px;line-height:1.6}
+.act-snippet{display:block;margin:8px 0 0;padding:8px 10px;border-radius:6px;background:var(--dsw-alias-bg-base);color:var(--dsw-alias-label-primary);font-family:var(--dsw-font-family-mono,monospace);font-size:11px;line-height:1.5;white-space:pre;overflow-x:auto}
+`);
+		/** 幂等注入样式标签；返回标签（已存在或环境无 document 时为 null）。 */
+		function injectStyle() {
+			return injectCardStyle(PLUGIN_ID, cardCssAll);
+		}
+		//#endregion
+		//#region src/client/client.ts
+		const name = "dsh-plus-actual";
+		/** 浏览器半需要的 cordis 服务 key（loader 据此注入；package.json 的 dsh.client.inject 管包加载顺序）。 */
+		const inject = [
+			"slots",
+			"locale",
+			"remote",
+			"remote.settings"
+		];
+		function apply(ctx) {
+			const c = ctx;
+			const tag = injectStyle();
+			c.effect(() => () => {
+				tag?.remove();
+			}, "actual: style");
+			c.effect(() => c.locale.register(NS, {
+				zh,
+				en
+			}), "actual: locale");
+			const scope = createSettingsScope(c, SETTINGS_NS, "actual: settings scope");
+			const api = createNamespaceApi(c.get("remote").settings, SETTINGS_NS);
+			injectPluginConfigCard(c.slots, {
+				ns: SETTINGS_NS,
+				rowId: "dsh-plus-actual",
+				pkg: "@dsh-plus/actual",
+				component: ActualCard,
+				inject: () => ({
+					t: c.locale.bind(NS),
+					scope,
+					api
+				})
+			});
+		}
+		//#endregion
+		exports.apply = apply;
+		exports.inject = inject;
+		exports.name = name;
+		return module.exports;
+	}
+});