dsh-life-pack 0.3.3 → 0.3.5

package/README.md

@@ -0,0 +1,38 @@
+# 爱生活（dsh-life-pack）
+
+DSH 设置弹窗里的「爱生活」卡：把六个技能（备忘录、卡路里、私家大厨、居家管家、作息管家、饼干记账）的**设置页**收进一排页签，另带**配置体检**与**更新区**。
+
+One settings card for the iLife home-life suite: memo, calorie, chef, home, schedule and bill in a tab bar, with a read-only config health check and an update panel.
+
+## 装
+
+```sh
+dsh plugin add dsh-life-pack                      # 只要这张卡
+dsh plugin add dsh-life-pack dsh-calorie          # 卡 ＋ 某一个技能（一条命令两个包）
+```
+
+某个技能没装时，那一个页签的位置会变成**补装提示**，带上该条可直接复制的命令——不需要先装齐六个。
+
+## 卡里有什么
+
+| 区域 | 做什么 |
+| --- | --- |
+| 页签条 | 六个技能的设置页各自注册进「爱生活页签槽」；点谁切谁 |
+| 配置体检 | 点一次，按家取数：顶部一行总账，每家一张表（每条：灯／标题／档／一句话／去哪修）。**只读**——不建目录、不改配置、不自动重置 |
+| 更新区 | 七个包（它自己 ＋ 六家）检查更新、逐个安装；装完按事实给下一步（重启 DSH 生效／重试／重新检查） |
+| 面板入口 | 右上角：检查更新、去仓库点 Star、反馈问题；底部一句「作者其他插件」 |
+
+## 它不做什么
+
+不 import 任何一个单品包，也不依赖它们——依赖方向是反的（单品硬依赖 `dsh-life-pack`）。总管只做导航与聚合：六家的页面各自注册进槽位，缺席就渲染补装提示，不轮询、不代管。
+
+## 配置与数据
+
+- 配置：`~/.ilife/<技能>.yaml`（六个技能各一份，在各自的设置页里改）
+- 数据目录：默认 `~/.ilife/data`（可在各技能设置页里改；留空＝用默认）
+
+## 链接
+
+- 仓库与整套插件（六个单品同仓）：<https://github.com/FeatherHunter/ilife>
+- 问题与建议：<https://github.com/FeatherHunter/ilife/issues>
+- 许可：MIT

package/dist/client.js

@@ -179,7 +179,14 @@ window.__ModuleLoader__.load({
 			* 宿主读**自己这份已安装包**的 `package.json`（`manager-version.ts`），面板只渲染读到的值。
 			* 为什么走电话：面板是浏览器产物，禁 node 内建（`test/client-bundle-48.test.mjs` 看门），
 			* 读盘只许在宿主半；与卡路里 #130 同一条路（host 读 → RPC → client 纯渲染）。 */
-			version: "ilife-manager.version"
+			version: "ilife-manager.version",
+			/** 本机「根」清单（票 #744）：入参 `{}`，回包 `{roots: [{path, kind}]}`。
+			*
+			* 为什么这条能力住在总管：浏览器里没有卷清单接口，而宿主那条目录选择接缝只有
+			* `list`／`createDirectory` 两格——「这台机器上有哪些盘」只能由宿主去问操作系统。
+			* 六家的目录浏览器都取这一通电话，故名字与实现都只有这一处（清单本身见 `roots.ts`）。
+			* 回包**恒成功**：列不出来是空清单，不是错误码（界面据此只是不画那一行）。 */
+			roots: "ilife-manager.roots"
 		};
 		/** 版本读不到时两侧共用的降级字面量（面板照原样显示，不假装知道版本）。
 		*
@@ -1747,10 +1754,15 @@ window.__ModuleLoader__.load({
 			if (typeof raw !== "object" || raw === null) return false;
 			return typeof raw.pick === "function";
 		}
-		/** 三态判定：先 native（有 pick），再 browse（有两格原语），都没有＝`none`。 */
+		/** 三态判定：**先看两格浏览原语**（都在＝应用内浏览器这条路在），再看单独的 `pick`，都没有＝`none`。
+		*
+		* 为什么浏览优先：客户端命名空间上三条动词一定都在（由 `TYPERT_REMOTE.descriptors` 生成，
+		* 与组合里服务哪种能力无关），所以两格原语在＝这台宿主**可能**给浏览；真调一次才知道给不给，
+		* 不给（{@link CAPABILITY_REFUSED}）再由调用方换系统对话框。反过来先认 `pick` 就会在
+		* Desktop 这种「只服务 browse」的宿主上每次都去唤一次系统对话框、被拒一次（#744 实测）。 */
 		function pickerModeOf(raw) {
-			if (hasPickFn(raw)) return "native";
-			return isBrowseFace(raw) ? "browse" : "none";
+			if (isBrowseFace(raw)) return "browse";
+			return hasPickFn(raw) ? "native" : "none";
 		}
 		/** 平台回执 → 三态（**永不抛**）：成功回的是信封里的 `value` 不是路径；`ok:false` 是「供不了」不是「取消」。
 		*
@@ -1771,8 +1783,10 @@ window.__ModuleLoader__.load({
 				} : { kind: "cancelled" };
 			}
 			const detail = answer.error?.message?.trim() ?? "";
+			const code = answer.error?.code;
 			return {
 				kind: "unavailable",
+				...typeof code === "string" && code !== "" ? { code } : {},
 				message: "打不开系统文件夹对话框" + (detail === "" ? "" : "（" + detail + "）") + "：请直接在框里填绝对路径。"
 			};
 		}
@@ -1877,7 +1891,8 @@ window.__ModuleLoader__.load({
 				draft: deps.initialPath,
 				filter: "",
 				creating: null,
-				notice: null
+				notice: null,
+				roots: []
 			};
 			/** 每次列举带一个序号：晚回来的旧回执直接丢掉，不许覆盖新一层。 */
 			let generation = 0;
@@ -1888,6 +1903,18 @@ window.__ModuleLoader__.load({
 				};
 				for (const listener of [...listeners]) listener(state);
 			};
+			/** 根清单只问一次：取不到就是空（不报错、不重试——它只是图上的一行入口）。
+			*
+			* 「问一次」钉在这里而不是图里：视图那半每次重画都会重新求值，问在这里才谈得上一次。 */
+			let rootsAsked = false;
+			const loadRoots = async () => {
+				if (rootsAsked || deps.rootsSource === void 0) return;
+				rootsAsked = true;
+				try {
+					const roots = await deps.rootsSource();
+					if (roots.length > 0) emit({ roots });
+				} catch {}
+			};
 			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);
@@ -1944,7 +1971,16 @@ window.__ModuleLoader__.load({
 					listeners.add(listener);
 					return () => listeners.delete(listener);
 				},
-				open: () => load(null),
+				async open() {
+					loadRoots();
+					const wanted = deps.initialPath.trim();
+					if (wanted !== "") {
+						await load(wanted);
+						if (state.phase === "ready") return state;
+					}
+					await load(null);
+					return state;
+				},
 				enter: (path) => load(path),
 				async up() {
 					const listing = state.listing;
@@ -2049,10 +2085,12 @@ window.__ModuleLoader__.load({
 				initialPath: deps.initialPath,
 				onPicked: deps.onPicked,
 				onClose: () => deps.onClosed?.(),
-				...deps.failureLabel === void 0 ? {} : { failureLabel: deps.failureLabel }
+				...deps.failureLabel === void 0 ? {} : { failureLabel: deps.failureLabel },
+				...deps.rootsSource === void 0 ? {} : { rootsSource: deps.rootsSource }
 			});
 			return {
 				open: () => controller.open(),
+				subscribe: (listener) => controller.subscribe(listener),
 				state: () => controller.getState(),
 				summary: () => describe(controller.getState()),
 				actions: {
@@ -2070,18 +2108,22 @@ window.__ModuleLoader__.load({
 			};
 		}
 		//#endregion
-		//#region src/directory-browser-ui.ts
-		/** 文件浏览器的视图半：把 `BrowseState` 画成一张对话框。**不认识宿主**，也不自己做 IO。
+		//#region src/directory-browser-parts.ts
+		/** 文件浏览器视图半的**零件**：样式表与四行控件（面包屑／根／一行子目录／新建行）。
 		*
-		* 手写 `React.createElement`（本包 client 束禁 JSX，见 `tsdown.config.ts` 的既成口径）。
-		* 只读状态、只回调；进哪一层、选到什么由操作半（`directory-browser-state.ts`）算。
+		* 为什么拆出来：整张对话框的组版与这些零件的变化频率不同——零件跟着「图上多一行／少一行」动，
+		* 组版跟着「对话框长什么样」动。拆开之后两边都在 350 行告警线内，而对外面不变
+		* （`directory-browser-ui.ts` 照旧转出组件与两个接线函数）。
+		*
+		* 本件与视图半同样**不认识宿主**：只认状态与文案。
 		*/
-		const EMPTY_LISTING = {
-			path: "",
-			home: "",
-			crumbs: [],
-			entries: [],
-			truncated: false
+		/** 根的类型说明（悬停可见）：**本件自己的词汇**，与取数方无关。 */
+		const ROOT_KIND_TEXT = {
+			fixed: "固定磁盘",
+			network: "网络驱动器",
+			removable: "可移动磁盘",
+			optical: "光驱",
+			other: "磁盘"
 		};
 		const S$1 = {
 			scrim: {
@@ -2147,6 +2189,24 @@ window.__ModuleLoader__.load({
 				opacity: .45,
 				fontSize: 12
 			},
+			roots: {
+				display: "flex",
+				flexWrap: "wrap",
+				alignItems: "center",
+				gap: 6,
+				padding: "0 12px 8px",
+				fontSize: 12
+			},
+			rootsLabel: {
+				opacity: .72,
+				marginRight: 2
+			},
+			rootButton: {
+				border: "1px solid var(--dsw-alias-border-l2, rgba(128,128,128,0.35))",
+				borderRadius: 6,
+				padding: "3px 8px",
+				opacity: 1
+			},
 			pathRow: {
 				display: "flex",
 				gap: 6,
@@ -2225,7 +2285,8 @@ window.__ModuleLoader__.load({
 			},
 			error: { color: "var(--dsw-alias-label-error, #e66)" }
 		};
-		function crumbRow(state, labels, onEnter) {
+		/** 面包屑：从文件系统根到当前层，每一格都是跳转目标（`listing.crumbs` 由取数方给）。 */
+		function crumbRow(state, onEnter) {
 			const listing = state.listing;
 			if (listing === null || listing.crumbs.length === 0) return null;
 			const parts = [];
@@ -2244,10 +2305,34 @@ window.__ModuleLoader__.load({
 					},
 					title: crumb.path,
 					onClick: () => onEnter(crumb.path)
-				}, index === 0 ? labels.up : crumb.name));
+				}, crumb.name));
 			});
 			return react.createElement("div", { style: S$1.crumbs }, parts);
 		}
+		/** 可跳转的根那一行（Windows 上的盘符等）。**少于两个根就不画**：一个根没有「跳到别处」可言。 */
+		function rootsRow(state, labels, onEnter) {
+			if (state.roots.length < 2) return null;
+			const parts = [react.createElement("span", {
+				key: "roots-label",
+				style: S$1.rootsLabel
+			}, labels.roots)];
+			for (const root of state.roots) parts.push(react.createElement("button", {
+				key: root.path,
+				type: "button",
+				style: {
+					...S$1.chromeButton,
+					...S$1.rootButton
+				},
+				title: ROOT_KIND_TEXT[root.kind] ?? ROOT_KIND_TEXT.other,
+				onClick: () => onEnter(root.path)
+			}, root.path));
+			return react.createElement("div", {
+				style: S$1.roots,
+				role: "group",
+				"aria-label": labels.roots
+			}, parts);
+		}
+		/** 一行子目录：点名字进它，点「选」把它当目标（「选」再点一次取消）。 */
 		function entryRow(entry, selected, labels, onToggleSelect, onEnter) {
 			return react.createElement("div", {
 				key: entry.path,
@@ -2276,6 +2361,7 @@ window.__ModuleLoader__.load({
 				onClick: () => onToggleSelect(entry.path)
 			}, selected ? "✓" : labels.select));
 		}
+		/** 「新建文件夹」那一行（`creatingName === null` 时收起）。 */
 		function createRow(labels, onName, onCancel, onCreate, creatingName) {
 			if (creatingName === null) return null;
 			return react.createElement("div", { style: {
@@ -2301,6 +2387,21 @@ window.__ModuleLoader__.load({
 				onClick: onCancel
 			}, labels.createCancel));
 		}
+		//#endregion
+		//#region src/directory-browser-ui.ts
+		/** 文件浏览器的视图半：把 `BrowseState` 画成一张对话框。**不认识宿主**，也不自己做 IO。
+		*
+		* 手写 `React.createElement`（本包 client 束禁 JSX，见 `tsdown.config.ts` 的既成口径）。
+		* 只读状态、只回调；进哪一层、选到什么由操作半（`directory-browser-state.ts`）算。
+		* 样式与四行控件在 `directory-browser-parts.ts`（那里跟着「多一行／少一行」动，本件只管组版）。
+		*/
+		const EMPTY_LISTING = {
+			path: "",
+			home: "",
+			crumbs: [],
+			entries: [],
+			truncated: false
+		};
 		/** 画一张文件浏览器对话框。`open=false` 时返回 null（本件不挂 portal，由调用方决定挂在哪）。 */
 		function DirectoryBrowser(props) {
 			const { open, state, labels } = props;
@@ -2310,7 +2411,8 @@ window.__ModuleLoader__.load({
 			const listing = state.listing ?? EMPTY_LISTING;
 			const hidden = hiddenCount(listing);
 			const body = [];
-			body.push(crumbRow(state, labels, props.onEnter));
+			body.push(crumbRow(state, props.onEnter));
+			body.push(rootsRow(state, labels, props.onEnter));
 			body.push(react.createElement("div", { style: S$1.pathRow }, react.createElement("input", {
 				style: S$1.input,
 				value: state.draft,
@@ -2391,16 +2493,56 @@ window.__ModuleLoader__.load({
 		/** 目录行接线的 React 半边：把操作半那组动作直接喂给组件。
 		*
 		* 操作半（`directory-browser-state.ts` 的 `createDirectoryRowBrowser`）不碰 React，
-		* 这里只把它的 `actions` 摊进 props —— 于是「进哪一层」那套在 Node 里可测，这里只做接线。 */
+		* 这里只把它的 `actions` 摊进 props —— 于是「进哪一层」那套在 Node 里可测，这里只做接线。
+		*
+		* `useSyncExternalStore` 是**必需**的：列举是异步落定的，不订阅的话这一帧画完就再没有重画，
+		* 图上会永远停在「正在读取…」（#744 实测）。 */
 		function DirectoryBrowserFromRow(props) {
+			const state = react.useSyncExternalStore(props.row.subscribe, props.row.state);
 			return DirectoryBrowser({
 				open: props.open,
-				state: props.row.state(),
+				state,
 				labels: props.labels,
 				...props.row.actions
 			});
 		}
 		//#endregion
+		//#region src/directory-browser-roots.ts
+		/** 认一认某个值像不像一个根（认不出的行丢掉：图的干净比多画一行重要）。 */
+		function isRootRow(raw) {
+			if (typeof raw !== "object" || raw === null) return false;
+			const row = raw;
+			return typeof row.path === "string" && row.path !== "" && typeof row.kind === "string";
+		}
+		/** 信封 → 根清单（纯函数，**永不抛**）：`{ok:true, value:{roots:[…]}}` 之外的形状一律当空。 */
+		function readRootsAnswer(raw) {
+			const answer = typeof raw === "object" && raw !== null ? raw : {};
+			if (answer.ok !== true) return [];
+			const value = typeof answer.value === "object" && answer.value !== null ? answer.value : {};
+			if (!Array.isArray(value.roots)) return [];
+			return value.roots.filter(isRootRow).map((row) => ({
+				path: row.path,
+				kind: row.kind
+			}));
+		}
+		/** 建一个「根清单取数器」：给调用口与三个名字，回一个 `() => Promise<RootRow[]>`。
+		*
+		* 界面按需调它（开图一次），不在渲染里调，也不缓存到这里——缓存是宿主半的事。 */
+		function createRootsSource(input) {
+			return async () => {
+				const call = input.getCall();
+				if (typeof call !== "function") return [];
+				try {
+					return readRootsAnswer(await call(input.base, input.endpoint, {
+						method: input.method,
+						payload: {}
+					}));
+				} catch {
+					return [];
+				}
+			};
+		}
+		//#endregion
 		//#region src/client.ts
 		/** dsh-life-pack client 适配器（六边形：browser 侧；爱生活单卡方案）。
 		*
@@ -2791,10 +2933,12 @@ window.__ModuleLoader__.load({
 		exports.canGoUp = canGoUp;
 		exports.createBrowseController = createBrowseController;
 		exports.createDirectoryRowBrowser = createDirectoryRowBrowser;
+		exports.createRootsSource = createRootsSource;
 		exports.entryPath = entryPath;
 		exports.inject = inject;
 		exports.pickerModeOf = pickerModeOf;
 		exports.readPickAnswer = readPickAnswer;
+		exports.readRootsAnswer = readRootsAnswer;
 		exports.rowsOf = rowsOf;
 		exports.targetOf = targetOf;
 		return module.exports;