dsh-life-pack 0.3.4 → 0.3.5

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"
 		};
 		/** 版本读不到时两侧共用的降级字面量（面板照原样显示，不假装知道版本）。
 		*
@@ -1884,7 +1891,8 @@ window.__ModuleLoader__.load({
 				draft: deps.initialPath,
 				filter: "",
 				creating: null,
-				notice: null
+				notice: null,
+				roots: []
 			};
 			/** 每次列举带一个序号：晚回来的旧回执直接丢掉，不许覆盖新一层。 */
 			let generation = 0;
@@ -1895,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);
@@ -1952,6 +1972,7 @@ window.__ModuleLoader__.load({
 					return () => listeners.delete(listener);
 				},
 				async open() {
+					loadRoots();
 					const wanted = deps.initialPath.trim();
 					if (wanted !== "") {
 						await load(wanted);
@@ -2064,7 +2085,8 @@ 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(),
@@ -2086,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: {
@@ -2163,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,
@@ -2241,6 +2285,7 @@ window.__ModuleLoader__.load({
 			},
 			error: { color: "var(--dsw-alias-label-error, #e66)" }
 		};
+		/** 面包屑：从文件系统根到当前层，每一格都是跳转目标（`listing.crumbs` 由取数方给）。 */
 		function crumbRow(state, onEnter) {
 			const listing = state.listing;
 			if (listing === null || listing.crumbs.length === 0) return null;
@@ -2264,6 +2309,30 @@ window.__ModuleLoader__.load({
 			});
 			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,
@@ -2292,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: {
@@ -2317,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;
@@ -2327,6 +2412,7 @@ window.__ModuleLoader__.load({
 			const hidden = hiddenCount(listing);
 			const body = [];
 			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,
@@ -2421,6 +2507,42 @@ window.__ModuleLoader__.load({
 			});
 		}
 		//#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 侧；爱生活单卡方案）。
 		*
@@ -2811,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;