dsh-bill-ilife 0.2.2 → 0.3.1

package/dist/client.js

@@ -51,7 +51,7 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region src/slot.ts
-		const SLOT_TITLE = "记账";
+		const SLOT_TITLE = "饼干记账";
 		const PLUGIN = "dsh-bill-ilife";
 		//#endregion
 		//#region src/settings.ts
@@ -61,29 +61,30 @@ window.__ModuleLoader__.load({
 				key: "db.dir",
 				title: "数据目录",
 				tier: "common",
-				control: "text",
-				hint: "库文件与备份的根目录。留空＝按默认落点（配置目录下的 data/），也就是改造前那个位置。"
+				control: "directory",
+				prefillFrom: "dataDir",
+				hint: "库文件与备份的根目录。留空＝用默认目录。"
 			},
 			{
 				key: "db.name",
 				title: "库文件名",
 				tier: "common",
 				control: "text",
-				hint: "数据目录下的数据库文件名。改它等于换一个账本，老账留在旧文件里不会跟过来。"
+				hint: "数据目录下的数据库文件名。改名＝换库，旧数据不会被读入。"
 			},
 			{
 				key: "db.goals",
 				title: "预算／账户文件名",
 				tier: "common",
 				control: "text",
-				hint: "跟库同目录的那份预算与账户数据。改它之后旧的预算与账户不会被读出来。"
+				hint: "与库同目录的预算与账户数据文件名。改名后旧文件不会再被读取。"
 			},
 			{
 				key: "html.dir",
 				title: "HELP 产物目录名",
 				tier: "common",
 				control: "text",
-				hint: "数据目录下放 HELP 与速查表文件的子目录名。改它之后新产物落新地方，旧的留在原处。"
+				hint: "数据目录下存放 HELP 与速查表的子目录名。改名后新产物落新目录。"
 			}
 		];
 		/** 高级项：默认收起。改错了多半只是自己撞上麻烦，不确定就别动。 */
@@ -92,29 +93,29 @@ window.__ModuleLoader__.load({
 				key: "backup.dir",
 				title: "备份目录",
 				tier: "advanced",
-				control: "text",
-				hint: "备份与恢复读写的位置。留空＝库目录下的 backups。恢复时按文件名取最新一份。"
+				control: "directory",
+				hint: "备份与恢复的读写目录。留空＝库目录下的 backups。"
 			},
 			{
 				key: "backup.stem",
 				title: "备份名主体",
 				tier: "advanced",
 				control: "text",
-				hint: "备份文件名的前缀，后面自动跟时间戳。改它之后旧的备份不再被当成恢复候选。"
+				hint: "备份文件名的前缀，后面自动加时间戳。"
 			},
 			{
 				key: "html.helpStem",
 				title: "产物名主体 · HELP",
 				tier: "advanced",
 				control: "text",
-				hint: "HELP 文件的文件名前缀。改它之后旧的 HELP 产物不再被复用。"
+				hint: "HELP 文件名前缀。"
 			},
 			{
 				key: "html.quickRefStem",
 				title: "产物名主体 · 速查表",
 				tier: "advanced",
 				control: "text",
-				hint: "速查表文件的文件名前缀。"
+				hint: "速查表文件名前缀。"
 			}
 		];
 		/** 设置页的行表，顺序即页面顺序。 */
@@ -123,7 +124,7 @@ window.__ModuleLoader__.load({
 		const COMMON_ITEM_COUNT = COMMON.length;
 		/** 高级组标题与副文案。 */
 		const ADVANCED_GROUP_TITLE = "高级";
-		const ADVANCED_GROUP_NOTE = "不常改。留空＝按默认落点（改造前那个位置），不确定就别动。";
+		const ADVANCED_GROUP_NOTE = "不常改。留空＝用默认值。";
 		/** 按 `a.b` 路径从配置取值里读（缺层或类型不符一律回 undefined）。 */
 		function readPath(values, key) {
 			const parts = key.split(".");
@@ -147,6 +148,10 @@ window.__ModuleLoader__.load({
 			cur[parts[parts.length - 1]] = value;
 		}
 		//#endregion
+		//#region src/dsh-ctx.ts
+		/** 宿主目录选择命名空间的服务名（#736；出处与禁令见 cookbook §13）。 */
+		const REMOTE_DIRECTORY_PICKER = "remote.directoryPicker";
+		//#endregion
 		//#region src/client.ts
 		/** dsh-bill-ilife client 适配器（六边形：port=contract，adapter=本文件）。
 		*
@@ -163,6 +168,8 @@ window.__ModuleLoader__.load({
 		* 宿主再 spawn 技能 CLI 的 `bill.config.*` 三个 key。本文件仍禁 node：不读盘、不算默认值。
 		* 照 CONTEXT.md，「技能设置页」只配置、不干活：本页没有查账、记一笔之类的入口。
 		*/
+		/** client 短名声明：只有这两个（#736 的目录选择走**可选查找**，不写进来——
+		* 写进来＝硬依赖，提供方缺席时整包被停靠，设置页会跟着装不上；见 cookbook §13）。 */
 		const inject = ["slots", "connection"];
 		/** 面板视觉（内联 style；颜色走 DSH 主题别名，深浅主题自适应，写死值只做回退）。 */
 		const S = {
@@ -172,26 +179,25 @@ window.__ModuleLoader__.load({
 				border: "1px solid var(--dsw-alias-border, rgba(128,128,128,.35))",
 				background: "var(--dsw-alias-bg-base, transparent)",
 				color: "var(--dsw-alias-label-primary, inherit)",
-				fontSize: 13,
 				lineHeight: 1.6
 			},
 			title: {
-				fontSize: 14,
+				fontSize: "1.08em",
 				fontWeight: 700,
 				marginBottom: 8
 			},
 			muted: {
 				color: "var(--dsw-alias-label-secondary, #9a9a9a)",
-				fontSize: 12
+				fontSize: "0.92em"
 			},
 			error: {
 				color: "var(--dsw-alias-state-error-primary, #ff6b6b)",
-				fontSize: 13,
+				fontSize: "1em",
 				whiteSpace: "pre-wrap"
 			},
 			okText: {
 				color: "var(--dsw-alias-state-success-primary, #12805c)",
-				fontSize: 12.5
+				fontSize: "0.96em"
 			},
 			rows: {
 				marginTop: 8,
@@ -203,22 +209,18 @@ window.__ModuleLoader__.load({
 				paddingTop: 8,
 				borderTop: "1px dashed var(--dsw-alias-border, rgba(128,128,128,.25))",
 				color: "var(--dsw-alias-label-tertiary, #8a8a8a)",
-				fontSize: 12
+				fontSize: "0.92em"
 			},
 			info: {
-				margin: "6px 0 0",
-				font: "12px/1.5 ui-monospace,Consolas,monospace",
+				fontSize: "0.92em",
 				color: "var(--dsw-alias-label-secondary, #9a9a9a)",
-				wordBreak: "break-all"
+				overflowWrap: "anywhere"
 			},
 			row: { marginTop: 10 },
-			label: {
-				fontSize: 12.5,
-				fontWeight: 600
-			},
+			label: { fontWeight: 600 },
 			hint: {
 				color: "var(--dsw-alias-label-tertiary, #8a8a8a)",
-				fontSize: 11.5,
+				fontSize: "0.92em",
 				margin: "1px 0 4px"
 			},
 			input: {
@@ -228,8 +230,22 @@ window.__ModuleLoader__.load({
 				borderRadius: 6,
 				border: "1px solid var(--dsw-alias-border, rgba(128,128,128,.45))",
 				background: "var(--dsw-alias-bg-base, transparent)",
+				color: "var(--dsw-alias-label-primary, inherit)"
+			},
+			pickRow: {
+				display: "flex",
+				gap: 6,
+				alignItems: "center"
+			},
+			btnPick: {
+				flex: "0 0 auto",
+				padding: "4px 10px",
+				borderRadius: 6,
+				border: "1px solid var(--dsw-alias-border, rgba(128,128,128,.45))",
+				background: "var(--dsw-alias-bg-base, transparent)",
 				color: "var(--dsw-alias-label-primary, inherit)",
-				font: "12.5px/1.5 ui-monospace,Consolas,monospace"
+				whiteSpace: "nowrap",
+				cursor: "pointer"
 			},
 			bar: {
 				marginTop: 14,
@@ -244,7 +260,6 @@ window.__ModuleLoader__.load({
 				border: "1px solid var(--dsw-alias-border, rgba(128,128,128,.45))",
 				background: "var(--dsw-alias-bg-base, transparent)",
 				color: "var(--dsw-alias-label-primary, inherit)",
-				fontSize: 12.5,
 				cursor: "pointer"
 			},
 			btnPrimary: {
@@ -253,7 +268,6 @@ window.__ModuleLoader__.load({
 				border: "1px solid var(--dsw-alias-brand-primary, #2f6fed)",
 				background: "var(--dsw-alias-brand-primary, #2f6fed)",
 				color: "#fff",
-				fontSize: 12.5,
 				cursor: "pointer"
 			},
 			adv: {
@@ -263,7 +277,6 @@ window.__ModuleLoader__.load({
 			},
 			advSummary: {
 				cursor: "pointer",
-				fontSize: 12.5,
 				fontWeight: 600
 			}
 		};
@@ -294,11 +307,11 @@ window.__ModuleLoader__.load({
 		*/
 		function humanizeConfigFailure(code, message) {
 			const text = message.trim().length > 0 ? message.trim() : `（${code}，宿主未给报文）`;
-			if (/解析|YAML|parse/i.test(text)) return `${text}\n改回「键: 值」的写法，或点「重置为默认」重来一份（重置会先留一份 .bak）。`;
-			if (/不认识|未知键|UNKNOWN_KEY/i.test(text)) return `${text}\n本页只认表里这些项；多余的行删掉，或点「重置为默认」。`;
-			if (/类型|TYPE_MISMATCH/i.test(text)) return `${text}\n按本页给的形状填（文本填文本、数字填数字），或点「重置为默认」。`;
-			if (/缺席|missing-cli/.test(text)) return `${text}\n技能出口没找着：先确认技能包已构建（packages/skill-bill/dist/cli/cmd_read.js）。`;
-			return `${text}\n改不动就点「重置为默认」（会先留一份 .bak），或照报文里的路径手工改配置文件。`;
+			if (/解析|YAML|parse/i.test(text)) return `${text}\n改回「键: 值」的写法，或点「重置为默认」。`;
+			if (/不认识|未知键|UNKNOWN_KEY/i.test(text)) return `${text}\n删掉页面上没有的行，或点「重置为默认」。`;
+			if (/类型|TYPE_MISMATCH/i.test(text)) return `${text}\n按本页的控件形状填，或点「重置为默认」。`;
+			if (/缺席|missing-cli/.test(text)) return `${text}\n技能出口没找到：先确认技能包已装好，再点「重新读取」。`;
+			return `${text}\n改不动就点「重置为默认」，或照上面那条路径手工改配置文件。`;
 		}
 		/** 一次配置 RPC（永不抛，失败落字；UI 因此不转圈、不返空）。 */
 		async function configRpc(call, method, payload) {
@@ -353,12 +366,17 @@ window.__ModuleLoader__.load({
 			if (!r.ok) return r;
 			return fetchConfigSurface(call);
 		}
-		/** 把配置取值铺成「行键 → 输入框文本」（页面表单态；值缺项即空串，不返空留白）。 */
-		function toDraft(values) {
+		/** 把配置取值铺成「行键 → 输入框文本」（页面表单态；值缺项即空串，不返空留白）。
+		*
+		* `prefill` 是**落点回执**（配置面那几格解析出来的绝对路径）：标了 `prefillFrom` 的行在取值空着时
+		* 直接显示那条绝对路径——用户不必自己拼路径（#743），显示的就是技能真会用的那个目录（逐字相同）。 */
+		function toDraft(values, prefill = {}) {
 			const draft = {};
 			for (const item of CONFIG_ITEMS) {
 				const v = readPath(values, item.key);
-				draft[item.key] = v === void 0 || v === null ? "" : String(v);
+				const raw = v === void 0 || v === null ? "" : String(v);
+				const fallback = item.prefillFrom === void 0 ? void 0 : prefill[item.prefillFrom];
+				draft[item.key] = raw === "" && typeof fallback === "string" && fallback !== "" ? fallback : raw;
 			}
 			return draft;
 		}
@@ -375,7 +393,73 @@ window.__ModuleLoader__.load({
 			}
 			return values;
 		}
-		/** 一行输入（三种控件对齐受限 YAML 子集：文本／数字／布尔）。 */
+		/** 形状守卫：拿到的那个东西像不像目录选择命名空间（本包只认 `pick` 是函数）。 */
+		function isDirectoryPicker(raw) {
+			if (typeof raw !== "object" || raw === null) return false;
+			return typeof raw.pick === "function";
+		}
+		/** 现取目录选择命名空间：**软依赖**，拿不到回 null（页面据此不出入口）。
+		*
+		* 为什么不用 `inject` 声明：见 cookbook §13——写进声明＝硬依赖，提供方缺席时整包被停靠，
+		* 设置页会跟着装不上。这里按平台给的「可选查找」办：缺席只是没有入口。
+		* 守卫拒绝或提供方中途卸载会抛，一律当「没有」，绝不把设置页带下来。 */
+		function resolveDirectoryPicker(getService) {
+			if (typeof getService !== "function") return null;
+			try {
+				const raw = getService(REMOTE_DIRECTORY_PICKER);
+				return isDirectoryPicker(raw) ? raw : null;
+			} catch {
+				return null;
+			}
+		}
+		/** 平台回执 → 三种结果（**永不抛**）。回执是信封 `{ok, value|error}`（见 dsh-ctx.ts 的
+		* `DirectoryPickerAnswer`）：成功回的是 `value` 不是路径本身，被拒回的是 `ok:false` 不是抛——
+		* 照裸值解会把两种情况都误判成「用户取消」（#743 真机现象：点「选择文件夹」什么都没发生）。
+		* 裸串照收（老形状兜底），认不出的形状当「供不了」报出来，不当取消吞掉。 */
+		function readPickAnswer(raw) {
+			if (typeof raw === "string") return raw.trim() === "" ? { kind: "cancelled" } : {
+				kind: "picked",
+				path: raw
+			};
+			const answer = typeof raw === "object" && raw !== null ? raw : {};
+			if (answer.ok === true) {
+				const value = answer.value;
+				return typeof value === "string" && value.trim() !== "" ? {
+					kind: "picked",
+					path: value
+				} : { kind: "cancelled" };
+			}
+			const detail = answer.error?.message?.trim() ?? "";
+			return {
+				kind: "unavailable",
+				message: "打不开系统文件夹对话框" + (detail === "" ? "" : "（" + detail + "）") + "：请直接在框里填绝对路径。"
+			};
+		}
+		/** 唤起一次系统文件夹选择器并归一结果（**永不抛**）。 */
+		async function pickDirectory(picker) {
+			try {
+				return readPickAnswer(await picker.pick());
+			} catch (e) {
+				return {
+					kind: "unavailable",
+					message: "打不开系统文件夹对话框（" + (e instanceof Error ? e.message : String(e)) + "）：请直接在框里填绝对路径。"
+				};
+			}
+		}
+		/** 「选择文件夹」按钮的真装配函数（目录行渲染出来的按钮，onClick 就是它）。
+		*
+		* 回 Promise 是为了本地可判（用例直接 await）；接进 React 时调用方 `void` 掉。 */
+		function createBrowseHandler(deps) {
+			return async (key) => {
+				const outcome = await pickDirectory(deps.picker);
+				if (outcome.kind === "picked") deps.onChange(key, outcome.path);
+				else if (outcome.kind === "unavailable") deps.onUnavailable(outcome.message);
+			};
+		}
+		/** 一行输入（四种控件对齐受限 YAML 子集：文本／数字／布尔／目录）。
+		*
+		* 目录档＝文本框 ＋ 一枚唤起系统文件夹选择器的按钮；`onBrowse` 缺席（命名空间拿不到、
+		* 或这条路已被拒）时不画按钮，文本框照旧——那是该缝自己的契约（供不了就收起入口，不是失败）。 */
 		function Row(props) {
 			const { item } = props;
 			const onChange = (e) => props.onChange(item.key, e.target.value);
@@ -392,13 +476,21 @@ window.__ModuleLoader__.load({
 				spellCheck: false,
 				onChange
 			});
-			return react.createElement("div", { style: S.row }, react.createElement("div", { style: S.label }, item.title), react.createElement("div", { style: S.hint }, item.hint), control);
+			const browse = item.control === "directory" && props.onBrowse !== void 0 ? react.createElement("button", {
+				style: S.btnPick,
+				type: "button",
+				disabled: props.disabled,
+				onClick: () => props.onBrowse?.(item.key)
+			}, "选择文件夹…") : null;
+			return react.createElement("div", { style: S.row }, react.createElement("div", { style: S.label }, item.title), react.createElement("div", { style: S.hint }, item.hint), browse === null ? control : react.createElement("div", { style: S.pickRow }, control, browse));
 		}
 		/** 技能设置页：承载饼干记账自己的全部可配置项（只配置，不干活）。
 		*
 		* 三态：loading（一次 RPC 内）／ready（真表单）／failed（人话报错 ＋ 指引，不返空、不转圈）。 */
 		function BillConfig(props) {
 			const [state, setState] = react.useState({ kind: "loading" });
+			const [pickerGone, setPickerGone] = react.useState(false);
+			const [picking, setPicking] = react.useState(false);
 			const [draft, setDraft] = react.useState({});
 			const [busy, setBusy] = react.useState(false);
 			const [notice, setNotice] = react.useState(null);
@@ -408,7 +500,7 @@ window.__ModuleLoader__.load({
 					kind: "ready",
 					surface
 				});
-				setDraft(toDraft(surface.values));
+				setDraft(toDraft(surface.values, surface));
 			}, []);
 			const load = react.useCallback(async () => {
 				setNotice(null);
@@ -443,8 +535,26 @@ window.__ModuleLoader__.load({
 				setNotice(null);
 				setError(null);
 			}, []);
+			/** 目录选择：拿不到命名空间就没有入口；被拒一次即收起入口（不留死按钮）。 */
+			const picker = pickerGone ? null : props.getPicker();
+			const onBrowse = react.useMemo(() => {
+				if (picker === null) return void 0;
+				const browse = createBrowseHandler({
+					picker,
+					onChange,
+					onUnavailable: (message) => {
+						setError(message);
+						setPickerGone(true);
+					}
+				});
+				return (key) => {
+					setPicking(true);
+					setError(null);
+					browse(key).finally(() => setPicking(false));
+				};
+			}, [picker, onChange]);
 			const surface = state.kind === "ready" ? state.surface : null;
-			const dirty = surface !== null && CONFIG_ITEMS.some((i) => (draft[i.key] ?? "") !== (toDraft(surface.values)[i.key] ?? ""));
+			const dirty = surface !== null && CONFIG_ITEMS.some((i) => (draft[i.key] ?? "") !== (toDraft(surface.values, surface)[i.key] ?? ""));
 			const onSave = react.useCallback(async () => {
 				setBusy(true);
 				setNotice(null);
@@ -471,7 +581,7 @@ window.__ModuleLoader__.load({
 					setNotice("已重置为默认（原配置已另存一份 .bak）");
 				} else setError(r.message);
 			}, [apply, props.getCall]);
-			const head = react.createElement("div", null, react.createElement("div", { style: S.title }, `${SLOT_TITLE} · 配置`), surface !== null ? react.createElement("div", null, react.createElement("div", { style: S.info }, `配置文件 ${surface.path}`), react.createElement("div", { style: S.info }, `数据目录 ${surface.dataDir}`), surface.created ? react.createElement("div", { style: S.muted }, "（这份配置是刚按默认值建出来的）") : null) : null);
+			const head = react.createElement("div", null, react.createElement("div", { style: S.title }, `${SLOT_TITLE} · 配置`), surface !== null ? react.createElement("div", null, react.createElement("div", { style: S.info }, `配置文件 ${surface.path}`), react.createElement("div", { style: S.info }, `数据目录 ${surface.dataDir}`), surface.created ? react.createElement("div", { style: S.muted }, "（配置文件刚按默认值生成）") : null) : null);
 			if (state.kind === "loading") return react.createElement("div", { style: S.card }, head, react.createElement("div", { style: S.muted }, "配置读取中…"));
 			if (state.kind === "failed") return react.createElement("div", { style: S.card }, react.createElement("div", { style: S.title }, `${SLOT_TITLE} · 配置`), react.createElement("div", { style: S.error }, state.message), react.createElement("div", { style: S.bar }, react.createElement("button", {
 				style: S.btn,
@@ -481,7 +591,7 @@ window.__ModuleLoader__.load({
 				style: S.btn,
 				type: "button",
 				onClick: () => void onReset()
-			}, "重置为默认")), react.createElement("div", { style: S.version }, `${PLUGIN} 设置页住单品包；本页只配置，不干活`));
+			}, "重置为默认")), react.createElement("div", { style: S.version }, `${PLUGIN} 本页只配置；记账在对话里说。`));
 			const common = CONFIG_ITEMS.slice(0, COMMON_ITEM_COUNT);
 			const advanced = CONFIG_ITEMS.slice(COMMON_ITEM_COUNT);
 			const renderRow = (item) => react.createElement(Row, {
@@ -489,7 +599,8 @@ window.__ModuleLoader__.load({
 				item,
 				value: draft[item.key] ?? "",
 				disabled: busy,
-				onChange
+				onChange,
+				onBrowse
 			});
 			return react.createElement("div", { style: S.card }, head, react.createElement("div", { style: S.rows }, common.map(renderRow)), react.createElement("details", { style: S.adv }, react.createElement("summary", { style: S.advSummary }, ADVANCED_GROUP_TITLE), react.createElement("div", { style: S.muted }, ADVANCED_GROUP_NOTE), advanced.map(renderRow)), react.createElement("div", { style: S.bar }, react.createElement("button", {
 				style: dirty ? S.btnPrimary : S.btn,
@@ -506,25 +617,35 @@ window.__ModuleLoader__.load({
 				type: "button",
 				disabled: busy,
 				onClick: () => void load()
-			}, "重新读取")), notice !== null ? react.createElement("div", { style: S.okText }, notice) : null, error !== null ? react.createElement("div", { style: S.error }, error) : null, react.createElement("div", { style: S.version }, `${PLUGIN} 设置页住单品包；本页只配置，不干活`));
+			}, "重新读取")), picking ? react.createElement("div", { style: S.muted }, "已唤起系统文件夹对话框：选中后自动填上，取消则不动。") : null, notice !== null ? react.createElement("div", { style: S.okText }, notice) : null, error !== null ? react.createElement("div", { style: S.error }, error) : null, react.createElement("div", { style: S.version }, `${PLUGIN} 本页只配置；记账在对话里说。`));
 		}
 		function apply(ctx) {
 			const getCall = () => ctx.connection?.rpc?.call ?? null;
+			const getPicker = () => typeof ctx.get === "function" ? resolveDirectoryPicker((name) => ctx.get?.(name)) : null;
 			ctx.slots.inject("ilife.config-tab", () => ctx.slots.register({
 				name: "ilife.config-tab",
 				id: PLUGIN,
 				order: 95,
 				label: () => SLOT_TITLE,
 				channel: RPC_CHANNEL
-			}, () => react.createElement(BillConfig, { getCall })));
+			}, () => react.createElement(BillConfig, {
+				getCall,
+				getPicker
+			})));
 		}
 		//#endregion
+		exports.Row = Row;
 		exports.apply = apply;
+		exports.createBrowseHandler = createBrowseHandler;
 		exports.fetchConfigSurface = fetchConfigSurface;
 		exports.fromDraft = fromDraft;
 		exports.humanizeConfigFailure = humanizeConfigFailure;
 		exports.inject = inject;
+		exports.isDirectoryPicker = isDirectoryPicker;
+		exports.pickDirectory = pickDirectory;
+		exports.readPickAnswer = readPickAnswer;
 		exports.resetConfigSurface = resetConfigSurface;
+		exports.resolveDirectoryPicker = resolveDirectoryPicker;
 		exports.saveConfigSurface = saveConfigSurface;
 		exports.toDraft = toDraft;
 		return module.exports;