dsh-life-pack 0.3.1 → 0.3.3

package/dist/client.js

@@ -34,12 +34,12 @@ window.__ModuleLoader__.load({
 		/** P3 定案 6 tab（order 升序即 + 号菜单顺序；已打开条不受 order 控制）。 */
 		const MANAGER_TABS = [
 			{
-				skill: "memo",
-				slotId: "ilife:memo",
+				skill: "bill",
+				slotId: "ilife:cookie",
 				order: 70,
-				title: "备忘录",
-				plugin: "dsh-memo-ilife",
-				channel: "/ilife-memo"
+				title: "饼干记账",
+				plugin: "dsh-bill-ilife",
+				channel: "/ilife-bill-ilife"
 			},
 			{
 				skill: "calorie",
@@ -49,10 +49,18 @@ window.__ModuleLoader__.load({
 				plugin: "dsh-calorie",
 				channel: "/ilife-calorie"
 			},
+			{
+				skill: "memo",
+				slotId: "ilife:memo",
+				order: 80,
+				title: "备忘录",
+				plugin: "dsh-memo-ilife",
+				channel: "/ilife-memo"
+			},
 			{
 				skill: "schedule",
 				slotId: "ilife:schedule",
-				order: 80,
+				order: 85,
 				title: "作息管家",
 				plugin: "dsh-schedule-ilife",
 				channel: "/ilife-schedule-ilife"
@@ -60,7 +68,7 @@ window.__ModuleLoader__.load({
 			{
 				skill: "home",
 				slotId: "ilife:home",
-				order: 85,
+				order: 90,
 				title: "居家管家",
 				plugin: "dsh-home-ilife",
 				channel: "/ilife-home-ilife"
@@ -68,18 +76,10 @@ window.__ModuleLoader__.load({
 			{
 				skill: "chef",
 				slotId: "ilife:chef",
-				order: 90,
+				order: 95,
 				title: "私家大厨",
 				plugin: "dsh-chef",
 				channel: "/ilife-chef"
-			},
-			{
-				skill: "bill",
-				slotId: "ilife:cookie",
-				order: 95,
-				title: "饼干记账",
-				plugin: "dsh-bill-ilife",
-				channel: "/ilife-bill-ilife"
 			}
 		];
 		function recoFor(tab) {
@@ -310,7 +310,13 @@ window.__ModuleLoader__.load({
 				version
 			});
 		}
-		/** 装上更新：查新版 → 提交安装 → 有界轮询查状态到任务收尾；凭证过期重查一次再提交。 */
+		/** 装上更新：查新版 → 提交安装 → 有界轮询查状态到任务收尾；凭证过期重查一次再提交。
+		*
+		* **第一句那次 `checkTarget` 不是多余的**（票 #740 第四轮）：凭证是「这一刻的安装态」的凭据，
+		* 更新包提交时拿它跟当时读到的安装态比（`service.js:309`／`:325`），不一样就拒。
+		* 而面板**从来只提交这一刻现签的凭证**——这就是「刚在本面板装过别家，这一家照样点得动
+		* 「装上更新」」的全部依据：旧快照只用来显示版本，不参与提交。（第四轮以前面板还把别家整行
+		* 换成「重新检查」——那是白挡一次本来会成功的点击，已删。） */
 		async function updateInstalled(call, target, pollMs) {
 			if (!target.phones) return failure("bad-request", { target: target.key });
 			const first = await checkTarget(call, target);
@@ -418,25 +424,14 @@ window.__ModuleLoader__.load({
 			if (verdict?.action) return verdict.action;
 			return phase === "failed" ? "recheck" : null;
 		}
-		/** 装成一家之后，其余各家的读数一律作废（票 #740）：七家共用同一份使用范围清单，
-		*  刚那次安装已经改写了它，旧快照再拿去装必然被守卫拦下。这句话就是那条守卫的人话。 */
-		function staleVerdict() {
-			return {
-				kind: "blocked",
-				text: "刚在本面板装过别的插件，共用的安装清单变了，这一家要先重读一次。点「重新检查」，再点「装上更新」。",
-				action: "recheck"
-			};
-		}
-		/** 把除 `keepKey` 之外的行全标成过期（票 #740）：装成一家 ⇒ 七家共用的安装清单被改写，
-		*  其余各家的旧快照再拿去装必然被守卫拦下。纯函数：状态源与单测共用同一份判据，
-		*  不关心行里还有什么（泛型只要求有 `stale` 这一格）。 */
-		function markStaleOthers(rows, keepKey) {
-			const next = {};
-			for (const [key, row] of Object.entries(rows)) next[key] = key === keepKey ? row : {
-				...row,
-				stale: true
-			};
-			return next;
+		/** 这一行要不要摊出那条手工命令（票 #740 第三轮定的形状，第四轮补的这一格）。
+		*
+		*  三种情形摊：① 上一次装失败（`failed`）；② 这句话自己指着「下面这条命令」（`manualHint`）。
+		*  **待重启**与 `incompatible-node` 不摊：它们那时该做的是**重启**（或升级 Node），不是重装一次。
+		*  （第四轮维护者真机截图逮到：待重启那张卡下面挂着一条「dsh plugin … add」——点它等于把刚装好的
+		*  那一版再装一遍，纯噪声，还会让人以为状态不对。） */
+		function showManualOf(verdict, phase) {
+			return phase === "failed" || verdict?.manualHint === true;
 		}
 		/** 把快照翻成一行结论：还没查 / 已是最新 / 有新版 / 待重启 / 装不了（附人话原因与下一步）。 */
 		function verdictOf(target, snapshot) {
@@ -823,10 +818,6 @@ window.__ModuleLoader__.load({
 					[key]: next
 				}));
 			}, []);
-			/** 装成一家 ⇒ 其余各家的旧快照一律作废（票 #740）：判据见 `markStaleOthers`。 */
-			const staleOthers = react.useCallback((keepKey) => {
-				setRows((previous) => markStaleOthers(previous, keepKey));
-			}, []);
 			return {
 				targets,
 				rows,
@@ -842,21 +833,18 @@ window.__ModuleLoader__.load({
 					for (const target of list) patch(target.key, {
 						phase: "checking",
 						outcome: rows[target.key]?.outcome ?? null,
-						failure: null,
-						stale: false
+						failure: null
 					});
 					Promise.all(list.map(async (target) => {
 						const result = await checkTarget(getCall(), target);
 						patch(target.key, result.ok ? {
 							phase: "ready",
 							outcome: result.value,
-							failure: null,
-							stale: false
+							failure: null
 						} : {
 							phase: "failed",
 							outcome: null,
-							failure: result,
-							stale: false
+							failure: result
 						});
 					})).finally(() => setChecking(false));
 				}, [
@@ -871,21 +859,18 @@ window.__ModuleLoader__.load({
 						patch(target.key, {
 							phase: "checking",
 							outcome: current.outcome,
-							failure: null,
-							stale: false
+							failure: null
 						});
 						(async () => {
 							const checked = await checkTarget(getCall(), target);
 							patch(target.key, checked.ok ? {
 								phase: "ready",
 								outcome: checked.value,
-								failure: null,
-								stale: false
+								failure: null
 							} : {
 								phase: "failed",
 								outcome: null,
-								failure: checked,
-								stale: false
+								failure: checked
 							});
 						})();
 						return;
@@ -893,8 +878,7 @@ window.__ModuleLoader__.load({
 					patch(target.key, {
 						...current,
 						phase: "installing",
-						failure: null,
-						stale: false
+						failure: null
 					});
 					(async () => {
 						const absent = isAbsent(target);
@@ -905,36 +889,29 @@ window.__ModuleLoader__.load({
 								patch(target.key, {
 									phase: "failed",
 									outcome: null,
-									failure: checked,
-									stale: false
+									failure: checked
 								});
 								return;
 							}
 							patch(target.key, {
 								phase: "installing",
 								outcome: checked.value,
-								failure: null,
-								stale: false
+								failure: null
 							});
 							version = checked.value.snapshot.latestVersion;
 						}
 						const result = absent ? await installAbsent(getCall(), target, version ?? "") : await updateInstalled(getCall(), target, pollMs);
 						if (result.ok) {
-							const before = current.outcome?.snapshot.installedVersion ?? null;
 							const refreshed = await checkTarget(getCall(), target, target.phones?.status);
-							const after = refreshed.ok ? refreshed.value.snapshot.installedVersion ?? null : null;
 							patch(target.key, refreshed.ok ? {
 								phase: "ready",
 								outcome: refreshed.value,
-								failure: null,
-								stale: false
+								failure: null
 							} : {
 								phase: "failed",
 								outcome: null,
-								failure: refreshed,
-								stale: false
+								failure: refreshed
 							});
-							if (after !== null && after !== before) staleOthers(target.key);
 							await reload();
 							return;
 						}
@@ -944,8 +921,7 @@ window.__ModuleLoader__.load({
 							failure: {
 								...result,
 								manual: result.manual ?? current.outcome?.manual ?? null
-							},
-							stale: false
+							}
 						});
 					})();
 				}, [
@@ -953,8 +929,7 @@ window.__ModuleLoader__.load({
 					patch,
 					pollMs,
 					reload,
-					rows,
-					staleOthers
+					rows
 				])
 			};
 		}
@@ -1007,10 +982,10 @@ window.__ModuleLoader__.load({
 			const body = shown.map((target) => {
 				const row = rows[target.key];
 				const snapshot = row.outcome?.snapshot ?? null;
-				const verdict = row.stale === true ? staleVerdict() : snapshot ? verdictOf(target, snapshot) : null;
+				const verdict = snapshot ? verdictOf(target, snapshot) : null;
 				const manual = manualForDisplay(target, row.failure?.manual ?? row.outcome?.manual ?? null);
 				const busy = row.phase === "installing";
-				const showManual = manual !== null && (row.phase === "failed" || verdict?.manualHint === true || verdict?.kind === "blocked" && verdict.action === null);
+				const showManual = manual !== null && showManualOf(verdict, row.phase);
 				const buttonAction = cardActionOf(verdict, row.phase);
 				const tone = rowToneOf(row, verdict);
 				const paint = ROW_TONE[tone];
@@ -1250,8 +1225,12 @@ window.__ModuleLoader__.load({
 				};
 			}
 		}
-		/** 取六家的体检报告（缺席的包不在此列，由调用方按账本判断）。 */
-		async function loadHealthReports(call, tabs) {
+		/** 取六家的体检报告（缺席的包不在此列，由调用方按账本判断）。
+		*
+		* `onRow`（票 #741）：某一家一落定就回调一次——面板据此**按家增量**画，不再等齐全部。
+		* 六家的电话是并发打出去的，但宿主里干活的只有一个线程（各单品宿主半 `spawnSync`），
+		* 所以真实到达顺序就是它们被串行干完的顺序；先回来的那家先画出来，用户才看得见进度。 */
+		async function loadHealthReports(call, tabs, onRow) {
 			if (typeof call !== "function") return {
 				rows: [],
 				error: "宿主连接缺席：connection.rpc.call 不可用"
@@ -1259,11 +1238,15 @@ window.__ModuleLoader__.load({
 			return {
 				rows: await Promise.all(tabs.map(async (tab) => {
 					const one = await fetchOne(call, tab);
-					return {
+					const row = {
 						id: tab.id,
 						report: one.report,
 						error: one.error
 					};
+					try {
+						onRow?.(row);
+					} catch {}
+					return row;
 				})),
 				error: null
 			};
@@ -1282,7 +1265,10 @@ window.__ModuleLoader__.load({
 			report: null,
 			error: null
 		};
-		/** 体检状态源：挂载时不自动跑（体检要读盘、要起子进程，按需跑），点一次跑六家。 */
+		/** 体检状态源：挂载时不自动跑（体检要读盘、要起子进程，按需跑），点一次跑六家。
+		*
+		* **按家增量**（票 #741）：某一家一落定就画那一家——不再等全部齐了才一次性 setRows。
+		* 取数口仍然只有一处（`loadHealthReports`），它把「一家好了」的回调交给这里 patch 状态。 */
 		function useHealthPanel(getCall, tabs) {
 			const [rows, setRows] = react.useState({});
 			const [error, setError] = react.useState(null);
@@ -1302,18 +1288,26 @@ window.__ModuleLoader__.load({
 						phase: "running"
 					}])));
 					(async () => {
-						const loaded = await loadHealthReports(getCall(), targets);
+						const patch = (row) => {
+							const next = {
+								phase: row.report ? "ready" : "failed",
+								report: row.report,
+								error: row.error
+							};
+							setRows((previous) => ({
+								...previous,
+								[row.id]: next
+							}));
+							try {
+								const diag = globalThis.__T706_RUN__;
+								if (Array.isArray(diag)) diag.push("row=" + row.id + " ok=" + String(row.report !== null) + " err=" + String(row.error));
+							} catch {}
+						};
+						const loaded = await loadHealthReports(getCall(), targets, patch);
 						try {
 							const diag = globalThis.__T706_RUN__;
 							if (Array.isArray(diag)) diag.push("rows=" + String(loaded.rows.length) + " err=" + String(loaded.error) + " first=" + String(loaded.rows[0]?.error ?? "null"));
 						} catch {}
-						const next = {};
-						for (const row of loaded.rows) next[row.id] = {
-							phase: row.report ? "ready" : "failed",
-							report: row.report,
-							error: row.error
-						};
-						setRows(next);
 						setError(loaded.error);
 						setRunning(false);
 					})();
@@ -1741,6 +1735,672 @@ window.__ModuleLoader__.load({
 			}, "· " + item.title))) : null) : null);
 		}
 		//#endregion
+		//#region src/directory-browser-contract.ts
+		/** 认一认某个值是不是可用的目录取数面（软依赖守卫用：认不出就当没有，绝不把页面带下来）。 */
+		function isBrowseFace(raw) {
+			if (typeof raw !== "object" || raw === null) return false;
+			const face = raw;
+			return typeof face.list === "function" && typeof face.createDirectory === "function";
+		}
+		/** 认一认某个值有没有 `pick`（对应宿主 composition 里的 `native` 能力）。 */
+		function hasPickFn(raw) {
+			if (typeof raw !== "object" || raw === null) return false;
+			return typeof raw.pick === "function";
+		}
+		/** 三态判定：先 native（有 pick），再 browse（有两格原语），都没有＝`none`。 */
+		function pickerModeOf(raw) {
+			if (hasPickFn(raw)) return "native";
+			return isBrowseFace(raw) ? "browse" : "none";
+		}
+		/** 平台回执 → 三态（**永不抛**）：成功回的是信封里的 `value` 不是路径；`ok:false` 是「供不了」不是「取消」。
+		*
+		* 出处：`@deepseek-ai/dsh-api-gateway/lib/client.js` 的 `invoke()`（失败不抛、成功也不回裸值），
+		* 第一方消费方 `@deepseek-ai/dsh-client-ui-workspace/lib/client.js:99-103` 就照这个信封拆。
+		* 裸串照收（老形状兜底），认不出的形状当「供不了」报出来，不当取消吞掉（#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 + "）") + "：请直接在框里填绝对路径。"
+			};
+		}
+		/** 一段路径里最后那个分隔符的位置（Windows 上 `\` 与 `/` 都算；POSIX 上 `\` 是合法文件名字符，不算）。 */
+		function lastSeparator(path) {
+			const back = path.lastIndexOf("\\");
+			const slash = path.lastIndexOf("/");
+			return back > slash ? back : slash;
+		}
+		/** 上一层：`'C:\\a\\b\\'` → `'C:\\a'`；已经是根则回自身；相对名（没有任何分隔符）也回自身。
+		*
+		* 尾分隔符先吃掉再切——否则「回上一级」会在原地打转。**盘根单独认**：`C:\` 掐掉尾分隔符会剩成
+		* `C:`，而 `C:` 是「当前盘」不是「上一层」，回它就会多跑一趟、还可能跨到别的盘上去。
+		* UNC（`\\server\share`）不特殊处理：切到头就是共享名本身，浏览停在共享根。 */
+		function parentOf(path) {
+			const trimmed = path.replace(/[\\/]+$/, "");
+			if (trimmed === "") return path;
+			const sep = path.includes("\\") ? "\\" : "/";
+			if (/^[A-Za-z]:$/.test(trimmed)) return trimmed + sep;
+			const cut = lastSeparator(trimmed);
+			if (cut === -1) return trimmed;
+			if (cut === 0) return path.slice(0, 1);
+			if (cut === 2 && /^[A-Za-z]:/.test(trimmed)) return trimmed.slice(0, 2) + sep;
+			return trimmed.slice(0, cut);
+		}
+		/** 把「当前路径 ＋ 一段输入」拼成一个目标路径。 */
+		function joinPath(directory, name) {
+			const sep = directory.includes("\\") ? "\\" : "/";
+			const base = directory.replace(/[\\/]+$/, "");
+			if (base === "") return sep + name;
+			return base + sep + name;
+		}
+		/** 一层列举里，哪些行可进：隐藏目录按开关过滤，其余照宿主给的顺序。 */
+		function visibleEntries(listing, showHidden) {
+			return showHidden ? listing.entries : listing.entries.filter((entry) => !entry.hidden);
+		}
+		/** 这一层有多少个被藏起来的目录（用来决定「显示隐藏目录」那个开关要不要出现在图上）。 */
+		function hiddenCount(listing) {
+			return listing.entries.filter((entry) => entry.hidden).length;
+		}
+		/** 拿一段文本按「最后一个分隔符」切成「目录部分 ＋ 筛选词」。
+		*
+		* 没打过任何分隔符时目录部分＝null（那段文字还不指任何目录，只当筛选词用）。
+		* Windows 上 `/` 也当分隔符（宿主那边两种都收），POSIX 上不。 */
+		function splitDraft(draft) {
+			const cut = lastSeparator(draft);
+			if (cut === -1) return {
+				directory: null,
+				filter: draft
+			};
+			return {
+				directory: draft.slice(0, cut + 1),
+				filter: draft.slice(cut + 1)
+			};
+		}
+		/** 按筛选词过一层目录（大小写不敏感；空筛选词＝全留）。 */
+		function filterEntries(entries, filter) {
+			const needle = filter.trim().toLowerCase();
+			if (needle === "") return entries;
+			return entries.filter((entry) => entry.name.toLowerCase().includes(needle));
+		}
+		/** 给界面用的一句话位置说明：优先显示相对 home 的说法，省得整条绝对路径占满一行。 */
+		function locationLabel(listing) {
+			const home = listing.home.replace(/[\\/]+$/, "");
+			if (home !== "" && listing.path !== home && listing.path.startsWith(home)) {
+				const tail = listing.path.slice(home.length).replace(/^[\\/]+/, "");
+				if (tail !== "") return "~" + (listing.path.includes("\\") ? "\\" : "/") + tail;
+			}
+			return listing.path;
+		}
+		/** 新建文件夹的名字合不合法（单个路径段：不许分隔符、不许空、不许 `.`／`..`）。
+		*
+		* 与宿主 browse 后端的校验同口径——这里先拦一道，是为了在图上给得出人话，不是替代宿主校验。 */
+		function validateFolderName(name) {
+			const trimmed = name.trim();
+			if (trimmed === "") return {
+				ok: false,
+				reason: "文件夹名不能为空。"
+			};
+			if (/[\\/]/.test(trimmed)) return {
+				ok: false,
+				reason: "文件夹名里不能带路径分隔符。"
+			};
+			if (trimmed === "." || trimmed === "..") return {
+				ok: false,
+				reason: "「.」与「..」不是文件夹名。"
+			};
+			return { ok: true };
+		}
+		//#endregion
+		//#region src/directory-browser-state.ts
+		/** 建一个浏览器控制器。取数、回调、初值全部由调用方给。 */
+		function createBrowseController(deps) {
+			const label = deps.failureLabel ?? "浏览失败";
+			const listeners = /* @__PURE__ */ new Set();
+			let state = {
+				phase: "idle",
+				listing: null,
+				failure: null,
+				selected: null,
+				showHidden: false,
+				draft: deps.initialPath,
+				filter: "",
+				creating: null,
+				notice: null
+			};
+			/** 每次列举带一个序号：晚回来的旧回执直接丢掉，不许覆盖新一层。 */
+			let generation = 0;
+			const emit = (next) => {
+				state = {
+					...state,
+					...next
+				};
+				for (const listener of [...listeners]) listener(state);
+			};
+			const humanize = (cause) => {
+				const raw = typeof cause === "object" && cause !== null ? cause : {};
+				const message = typeof raw.message === "string" && raw.message.trim() !== "" ? raw.message.trim() : String(cause);
+				return {
+					code: typeof raw.code === "string" && raw.code !== "" ? raw.code : "browse-failed",
+					message: `${label}：${message}`
+				};
+			};
+			const load = async (path) => {
+				const mine = ++generation;
+				emit({
+					phase: "loading",
+					failure: null,
+					notice: null
+				});
+				try {
+					const listing = path === null ? await deps.face.list() : await deps.face.list(path);
+					if (mine !== generation) return;
+					emit({
+						phase: "ready",
+						listing,
+						failure: null,
+						selected: null,
+						draft: listing.path,
+						filter: ""
+					});
+				} catch (cause) {
+					if (mine !== generation) return;
+					emit({
+						phase: "failed",
+						listing: null,
+						failure: humanize(cause),
+						selected: null
+					});
+				}
+			};
+			/** 草稿指到的那一层已经列举过时，按末段筛当前这一层的行；否则不过滤。
+			*
+			* 两边都先掐掉尾分隔符再比：草稿那边切开后天然带尾分隔符（`C:\a\` ＋ `b`），
+			* 而这一层的 `path` 由宿主给、不带尾分隔符。 */
+			const applyDraft = (draft) => {
+				const { directory, filter } = splitDraft(draft);
+				const listing = state.listing;
+				const sameLevel = listing !== null && directory !== null && normalize(directory) === normalize(listing.path);
+				emit({
+					draft,
+					filter: sameLevel ? filter : ""
+				});
+			};
+			const normalize = (path) => path.replace(/[\\/]+$/, "");
+			return {
+				getState: () => state,
+				subscribe(listener) {
+					listeners.add(listener);
+					return () => listeners.delete(listener);
+				},
+				open: () => load(null),
+				enter: (path) => load(path),
+				async up() {
+					const listing = state.listing;
+					if (listing === null) return;
+					const parent = parentOf(listing.path);
+					if (parent === listing.path) return;
+					await load(parent);
+				},
+				pick() {
+					const target = state.selected ?? state.listing?.path ?? null;
+					if (target === null) return;
+					deps.onPicked(target);
+				},
+				cancel() {
+					deps.onClose();
+				},
+				close() {
+					deps.onClose();
+				},
+				select(path) {
+					emit({
+						selected: state.selected === path ? null : path,
+						notice: null
+					});
+				},
+				toggleHidden() {
+					emit({ showHidden: !state.showHidden });
+				},
+				setDraft(draft) {
+					applyDraft(draft);
+				},
+				async commitDraft() {
+					const trimmed = state.draft.trim();
+					if (trimmed === "") return;
+					await load(trimmed);
+				},
+				setCreating(name) {
+					emit({
+						creating: name,
+						notice: null
+					});
+				},
+				async createFolder(name) {
+					const checked = validateFolderName(name);
+					if (!checked.ok) {
+						emit({ notice: checked.reason });
+						return;
+					}
+					const base = state.selected ?? state.listing?.path ?? null;
+					if (base === null) {
+						emit({ notice: "还没有打开任何目录，无法新建文件夹。" });
+						return;
+					}
+					try {
+						const created = await deps.face.createDirectory(base, name.trim());
+						emit({
+							creating: null,
+							notice: null
+						});
+						await load(created);
+						emit({ selected: created });
+					} catch (cause) {
+						const failure = humanize(cause);
+						emit({
+							notice: failure.message,
+							creating: null
+						});
+					}
+				}
+			};
+		}
+		/** 图上这一层要画的行（按隐藏开关与草稿末段过滤之后的）。 */
+		function rowsOf(state) {
+			if (state.listing === null) return [];
+			return filterEntries(visibleEntries(state.listing, state.showHidden), state.filter);
+		}
+		/** 图上这一层能不能回上一级（根目录不能）。 */
+		function canGoUp(state) {
+			if (state.listing === null) return false;
+			return parentOf(state.listing.path) !== state.listing.path;
+		}
+		/** 「打开」这颗按钮的目标：选中行优先，没选中就是当前层。 */
+		function targetOf(state) {
+			return state.selected ?? state.listing?.path ?? null;
+		}
+		/** 一段路径拼成可读的一句话（给用例与调试用；图上不直接显示）。 */
+		function describe(state) {
+			if (state.phase === "failed") return `${state.failure?.code ?? "browse-failed"} @ ${state.draft}`;
+			if (state.listing === null) return `${state.phase}`;
+			return `${state.listing.path}（${rowsOf(state).length} 行）`;
+		}
+		/** 一行子目录的完整路径（图上点行时用）。 */
+		function entryPath(directory, entry) {
+			return entry.path === "" ? joinPath(directory, entry.name) : entry.path;
+		}
+		/** 建一份「目录行接线」：给一个取数面与初值，回一组动作。
+		*
+		* 只做接线：把控制器算出来的状态与回调打包好，不取数、不画图、不认宿主。 */
+		function createDirectoryRowBrowser(deps) {
+			const controller = createBrowseController({
+				face: deps.face,
+				initialPath: deps.initialPath,
+				onPicked: deps.onPicked,
+				onClose: () => deps.onClosed?.(),
+				...deps.failureLabel === void 0 ? {} : { failureLabel: deps.failureLabel }
+			});
+			return {
+				open: () => controller.open(),
+				state: () => controller.getState(),
+				summary: () => describe(controller.getState()),
+				actions: {
+					onPick: () => controller.pick(),
+					onClose: () => controller.cancel(),
+					onEnter: (path) => void controller.enter(path),
+					onUp: () => void controller.up(),
+					onSelect: (path) => controller.select(path),
+					onToggleHidden: () => controller.toggleHidden(),
+					onDraft: (draft) => controller.setDraft(draft),
+					onCommitDraft: () => void controller.commitDraft(),
+					onCreate: (name) => void controller.createFolder(name),
+					onCreatingChange: (name) => controller.setCreating(name)
+				}
+			};
+		}
+		//#endregion
+		//#region src/directory-browser-ui.ts
+		/** 文件浏览器的视图半：把 `BrowseState` 画成一张对话框。**不认识宿主**，也不自己做 IO。
+		*
+		* 手写 `React.createElement`（本包 client 束禁 JSX，见 `tsdown.config.ts` 的既成口径）。
+		* 只读状态、只回调；进哪一层、选到什么由操作半（`directory-browser-state.ts`）算。
+		*/
+		const EMPTY_LISTING = {
+			path: "",
+			home: "",
+			crumbs: [],
+			entries: [],
+			truncated: false
+		};
+		const S$1 = {
+			scrim: {
+				position: "fixed",
+				inset: 0,
+				background: "rgba(0,0,0,0.35)",
+				display: "flex",
+				alignItems: "center",
+				justifyContent: "center",
+				zIndex: 9999
+			},
+			dialog: {
+				width: 680,
+				maxWidth: "92vw",
+				height: 500,
+				maxHeight: "86vh",
+				display: "flex",
+				flexDirection: "column",
+				background: "var(--dsw-alias-bg-layer-1, #1f1f23)",
+				color: "var(--dsw-alias-label-primary, inherit)",
+				border: "1px solid var(--dsw-alias-border-l2, rgba(128,128,128,0.35))",
+				borderRadius: 10,
+				boxShadow: "0 12px 32px rgba(0,0,0,0.35)",
+				overflow: "hidden"
+			},
+			head: {
+				display: "flex",
+				alignItems: "center",
+				gap: 8,
+				padding: "10px 12px",
+				borderBottom: "1px solid var(--dsw-alias-border-l2, rgba(128,128,128,0.25))"
+			},
+			title: {
+				fontSize: 14,
+				fontWeight: 700
+			},
+			headTail: {
+				marginLeft: "auto",
+				fontSize: 12,
+				opacity: .72,
+				overflow: "hidden",
+				textOverflow: "ellipsis",
+				whiteSpace: "nowrap"
+			},
+			crumbs: {
+				display: "flex",
+				flexWrap: "wrap",
+				alignItems: "center",
+				gap: 2,
+				padding: "8px 12px 0",
+				fontSize: 12
+			},
+			chromeButton: {
+				background: "transparent",
+				border: "none",
+				color: "var(--dsw-alias-label-primary, inherit)",
+				cursor: "pointer",
+				padding: "2px 4px",
+				fontSize: 12,
+				opacity: .85
+			},
+			crumbSep: {
+				opacity: .45,
+				fontSize: 12
+			},
+			pathRow: {
+				display: "flex",
+				gap: 6,
+				padding: "8px 12px"
+			},
+			input: {
+				flex: 1,
+				minWidth: 0,
+				fontSize: 12,
+				padding: "5px 8px",
+				background: "var(--dsw-alias-bg-layer-2, rgba(128,128,128,0.12))",
+				color: "inherit",
+				border: "1px solid var(--dsw-alias-border-l2, rgba(128,128,128,0.35))",
+				borderRadius: 6
+			},
+			button: {
+				fontSize: 12,
+				padding: "5px 10px",
+				cursor: "pointer",
+				background: "var(--dsw-alias-bg-layer-2, rgba(128,128,128,0.12))",
+				color: "inherit",
+				border: "1px solid var(--dsw-alias-border-l2, rgba(128,128,128,0.35))",
+				borderRadius: 6
+			},
+			buttonOff: {
+				opacity: .45,
+				cursor: "default"
+			},
+			list: {
+				flex: 1,
+				minHeight: 0,
+				overflowY: "auto",
+				margin: "0 12px",
+				border: "1px solid var(--dsw-alias-border-l2, rgba(128,128,128,0.25))",
+				borderRadius: 6
+			},
+			row: {
+				display: "flex",
+				alignItems: "center",
+				gap: 8,
+				width: "100%",
+				padding: "6px 10px",
+				textAlign: "left",
+				background: "transparent",
+				color: "inherit",
+				border: "none",
+				borderBottom: "1px solid var(--dsw-alias-border-l2, rgba(128,128,128,0.12))",
+				cursor: "pointer",
+				fontSize: 13
+			},
+			rowSelected: { background: "var(--dsw-alias-bg-layer-2, rgba(128,128,128,0.18))" },
+			empty: {
+				padding: "14px 12px",
+				fontSize: 12,
+				opacity: .7
+			},
+			footNote: {
+				padding: "6px 12px 0",
+				fontSize: 12,
+				minHeight: 20
+			},
+			foot: {
+				display: "flex",
+				alignItems: "center",
+				gap: 8,
+				padding: "10px 12px",
+				borderTop: "1px solid var(--dsw-alias-border-l2, rgba(128,128,128,0.25))"
+			},
+			target: {
+				marginRight: "auto",
+				fontSize: 12,
+				opacity: .8,
+				overflow: "hidden",
+				textOverflow: "ellipsis",
+				whiteSpace: "nowrap"
+			},
+			error: { color: "var(--dsw-alias-label-error, #e66)" }
+		};
+		function crumbRow(state, labels, onEnter) {
+			const listing = state.listing;
+			if (listing === null || listing.crumbs.length === 0) return null;
+			const parts = [];
+			listing.crumbs.forEach((crumb, index) => {
+				if (index > 0) parts.push(react.createElement("span", {
+					key: "sep-" + crumb.path,
+					style: S$1.crumbSep
+				}, "›"));
+				const isCurrent = crumb.path === listing.path;
+				parts.push(react.createElement("button", {
+					key: crumb.path,
+					type: "button",
+					style: {
+						...S$1.chromeButton,
+						fontWeight: isCurrent ? 700 : 400
+					},
+					title: crumb.path,
+					onClick: () => onEnter(crumb.path)
+				}, index === 0 ? labels.up : crumb.name));
+			});
+			return react.createElement("div", { style: S$1.crumbs }, parts);
+		}
+		function entryRow(entry, selected, labels, onToggleSelect, onEnter) {
+			return react.createElement("div", {
+				key: entry.path,
+				style: {
+					...S$1.row,
+					padding: 0,
+					...selected ? S$1.rowSelected : {}
+				}
+			}, react.createElement("button", {
+				type: "button",
+				style: {
+					...S$1.row,
+					flex: 1,
+					border: "none"
+				},
+				onClick: () => onEnter(entry.path)
+			}, "📁 " + entry.name), react.createElement("button", {
+				type: "button",
+				style: {
+					...S$1.button,
+					marginRight: 8,
+					padding: "2px 8px"
+				},
+				"aria-pressed": selected,
+				title: selected ? labels.selected : labels.select,
+				onClick: () => onToggleSelect(entry.path)
+			}, selected ? "✓" : labels.select));
+		}
+		function createRow(labels, onName, onCancel, onCreate, creatingName) {
+			if (creatingName === null) return null;
+			return react.createElement("div", { style: {
+				...S$1.pathRow,
+				borderTop: "1px solid var(--dsw-alias-border-l2, rgba(128,128,128,0.25))"
+			} }, react.createElement("input", {
+				style: S$1.input,
+				value: creatingName,
+				placeholder: labels.newFolder,
+				"aria-label": labels.newFolder,
+				onChange: (event) => onName(event.currentTarget.value),
+				onKeyDown: (event) => {
+					if (event.key === "Enter") onCreate(creatingName);
+					if (event.key === "Escape") onCancel();
+				}
+			}), react.createElement("button", {
+				type: "button",
+				style: S$1.button,
+				onClick: () => onCreate(creatingName)
+			}, labels.createConfirm), react.createElement("button", {
+				type: "button",
+				style: S$1.button,
+				onClick: onCancel
+			}, labels.createCancel));
+		}
+		/** 画一张文件浏览器对话框。`open=false` 时返回 null（本件不挂 portal，由调用方决定挂在哪）。 */
+		function DirectoryBrowser(props) {
+			const { open, state, labels } = props;
+			if (!open) return null;
+			const rows = rowsOf(state);
+			const target = targetOf(state);
+			const listing = state.listing ?? EMPTY_LISTING;
+			const hidden = hiddenCount(listing);
+			const body = [];
+			body.push(crumbRow(state, labels, props.onEnter));
+			body.push(react.createElement("div", { style: S$1.pathRow }, react.createElement("input", {
+				style: S$1.input,
+				value: state.draft,
+				placeholder: labels.pathPlaceholder,
+				"aria-label": labels.pathPlaceholder,
+				onChange: (event) => props.onDraft(event.currentTarget.value),
+				onKeyDown: (event) => {
+					if (event.key === "Enter") props.onCommitDraft();
+				}
+			}), react.createElement("button", {
+				type: "button",
+				style: S$1.button,
+				onClick: props.onUp
+			}, labels.up), react.createElement("button", {
+				type: "button",
+				style: S$1.button,
+				onClick: props.onCommitDraft
+			}, labels.go)));
+			body.push(react.createElement("div", {
+				style: S$1.list,
+				role: "listbox",
+				"aria-label": labels.title
+			}, rows.length === 0 ? react.createElement("div", { style: S$1.empty }, state.phase === "loading" ? labels.loading : labels.empty) : rows.map((entry) => entryRow(entry, state.selected === entry.path, labels, props.onSelect, props.onEnter))));
+			body.push(createRow(labels, props.onDraft, () => props.onCreatingChange(null), props.onCreate, state.creating));
+			body.push(react.createElement("div", { style: S$1.footNote }, hidden > 0 ? react.createElement("label", { style: {
+				fontSize: 12,
+				cursor: "pointer",
+				marginRight: 10
+			} }, react.createElement("input", {
+				type: "checkbox",
+				checked: state.showHidden,
+				onChange: props.onToggleHidden
+			}), " " + labels.showHidden(hidden)) : null, state.creating === null ? react.createElement("button", {
+				type: "button",
+				style: {
+					...S$1.chromeButton,
+					textDecoration: "underline"
+				},
+				onClick: () => props.onCreatingChange("")
+			}, labels.newFolder) : null, state.notice !== null ? react.createElement("div", { style: S$1.error }, state.notice) : null, state.phase === "failed" && state.failure !== null ? react.createElement("div", { style: S$1.error }, state.failure.message) : null));
+			body.push(react.createElement("div", { style: S$1.foot }, react.createElement("span", {
+				style: S$1.target,
+				title: target ?? ""
+			}, target === null ? "" : labels.willPick + target), react.createElement("button", {
+				type: "button",
+				style: {
+					...S$1.button,
+					...target === null ? S$1.buttonOff : {}
+				},
+				onClick: props.onPick
+			}, labels.open), react.createElement("button", {
+				type: "button",
+				style: S$1.button,
+				onClick: props.onClose
+			}, labels.cancel)));
+			return react.createElement("div", {
+				style: S$1.scrim,
+				role: "presentation",
+				onMouseDown: (event) => {
+					if (event.target === event.currentTarget) props.onClose();
+				}
+			}, react.createElement("div", {
+				style: S$1.dialog,
+				role: "dialog",
+				"aria-modal": true,
+				"aria-label": labels.title
+			}, react.createElement("div", { style: S$1.head }, react.createElement("span", { style: S$1.title }, labels.title), react.createElement("span", {
+				style: S$1.headTail,
+				title: listing.path
+			}, state.listing === null ? "" : locationLabel(listing)), react.createElement("button", {
+				type: "button",
+				style: S$1.button,
+				"aria-label": labels.close,
+				title: labels.close,
+				onClick: props.onClose
+			}, "✕")), body));
+		}
+		/** 目录行接线的 React 半边：把操作半那组动作直接喂给组件。
+		*
+		* 操作半（`directory-browser-state.ts` 的 `createDirectoryRowBrowser`）不碰 React，
+		* 这里只把它的 `actions` 摊进 props —— 于是「进哪一层」那套在 Node 里可测，这里只做接线。 */
+		function DirectoryBrowserFromRow(props) {
+			return DirectoryBrowser({
+				open: props.open,
+				state: props.row.state(),
+				labels: props.labels,
+				...props.row.actions
+			});
+		}
+		//#endregion
 		//#region src/client.ts
 		/** dsh-life-pack client 适配器（六边形：browser 侧；爱生活单卡方案）。
 		*
@@ -2126,8 +2786,17 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		exports.CONFIG_TAB_SLOT = CONFIG_TAB_SLOT;
+		exports.DirectoryBrowserFromRow = DirectoryBrowserFromRow;
 		exports.apply = apply;
+		exports.canGoUp = canGoUp;
+		exports.createBrowseController = createBrowseController;
+		exports.createDirectoryRowBrowser = createDirectoryRowBrowser;
+		exports.entryPath = entryPath;
 		exports.inject = inject;
+		exports.pickerModeOf = pickerModeOf;
+		exports.readPickAnswer = readPickAnswer;
+		exports.rowsOf = rowsOf;
+		exports.targetOf = targetOf;
 		return module.exports;
 	}
 });