dsh-wsl-workspace 0.3.2 → 0.4.2

package/lib/client.js

@@ -1,582 +1,616 @@
-window.__ModuleLoader__.load({
-	id: "dsh-wsl-workspace",
-	factory: (require) => {
-		var module = { exports: {} };
-		var exports = module.exports;
-		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-		let react = require("react");
-		let react_jsx_runtime = require("react/jsx-runtime");
-		//#region src/client/api.ts
-		/**
-		* Thin fetch client for the Host plugin route. The browser calls
-		* POST /wsl-workspace/api with a `{ method, params }` envelope and the Host
-		* answers `{ ok: true, value }` or `{ ok: false, error }`.
-		*/
-		/** Relative route the Host half registers (same-origin with the web server). */
-		const ENDPOINT = "/wsl-workspace/api";
-		/** Human text for an unknown rejection, reusing the repository's idiom. */
-		function errorMessage(value) {
-			return value instanceof Error ? value.message : String(value);
+window.__ModuleLoader__.load({ id: "dsh-wsl-workspace", factory: (require) => {
+var module = { exports: {} }; var exports = module.exports;
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+const react = __toESM(require("react"));
+const react_jsx_runtime = __toESM(require("react/jsx-runtime"));
+
+//#region src/client/api.ts
+/**
+* Thin fetch client for the Host plugin route. The browser calls
+* POST /wsl-workspace/api with a `{ method, params }` envelope and the Host
+* answers `{ ok: true, value }` or `{ ok: false, error }`.
+*/
+/** Relative route the Host half registers (same-origin with the web server). */
+const ENDPOINT = "/wsl-workspace/api";
+/** Human text for an unknown rejection, reusing the repository's idiom. */
+function errorMessage(value) {
+	return value instanceof Error ? value.message : String(value);
+}
+/**
+* Perform one POST call and unwrap the envelope.
+* @param method - the Host method name.
+* @param params - the method payload.
+* @returns the unwrapped value, or throws an Error on network or `ok:false`.
+*/
+async function call(method, params = {}) {
+	let response;
+	try {
+		response = await fetch(ENDPOINT, {
+			method: "POST",
+			headers: { "content-type": "application/json" },
+			body: JSON.stringify({
+				method,
+				params
+			})
+		});
+	} catch (error) {
+		throw new Error(`wsl-workspace request failed: ${errorMessage(error)}`);
+	}
+	let envelope;
+	try {
+		envelope = await response.json();
+	} catch {
+		throw new Error(`wsl-workspace answered non-JSON (${response.status})`);
+	}
+	if (!envelope.ok) throw new Error(envelope.error);
+	return envelope.value;
+}
+/**
+* List the WSL distros installed on the host.
+* @returns distro names in registry order.
+*/
+async function listDistros() {
+	return call("listDistros", {});
+}
+/**
+* List one directory level inside a distro.
+* @param distro - distro name.
+* @param path - absolute Linux directory to list.
+* @returns the level's listing with ancestry.
+*/
+async function listDir(distro, path) {
+	return call("listDir", {
+		distro,
+		path
+	});
+}
+/**
+* Check whether a Linux path exists and is a directory.
+* @param distro - distro name.
+* @param path - absolute Linux path.
+* @returns existence and directory facts.
+*/
+async function check(distro, path) {
+	return call("check", {
+		distro,
+		path
+	});
+}
+/**
+* Store (or clear, with an empty string) the username of one WSL workspace.
+* @param path - the workspace UNC path.
+* @param username - the Linux username; empty string clears the stored value.
+*/
+async function setWorkspaceUser(path, username) {
+	return call("setUser", {
+		path,
+		username
+	});
+}
+/**
+* Register a `/mnt/<drive>` WSL workspace under its Windows drive path,
+* recording the distro (and optional username) for the session env.
+* @param linuxPath - the `/mnt/<drive>/…` Linux path.
+* @param distro - the WSL distribution the workspace belongs to.
+* @param username - optional Linux username.
+*/
+async function registerWindows(linuxPath, distro, username) {
+	return call("registerWindows", {
+		linuxPath,
+		distro,
+		username
+	});
+}
+/**
+* List every registered WSL workspace key (canonical UNC and Windows drive
+* spellings). The client uses the drive keys to recognize `/mnt` workspaces
+* across page reloads.
+*/
+async function listWorkspaces() {
+	return call("listWorkspaces", {});
+}
+
+//#endregion
+//#region src/shared/paths.ts
+/**
+* WSL path helpers shared by the client and host halves. Pure and
+* dependency-free so both planes can import them without a runtime edge.
+*/
+/** WSL2 default loopback bridge host: `\\wsl.localhost\<distro>\...`. */
+const WSL_LOCALHOST_HOST = "wsl.localhost";
+/** Legacy WSL interop host: `\\wsl$\<distro>\...`. */
+const WSL_LEGACY_HOST = "wsl$";
+/** The two UNC hosts WSL exposes a distribution's filesystem under. */
+const UNC_HOSTS = [WSL_LOCALHOST_HOST, WSL_LEGACY_HOST];
+/**
+* Parse a WSL UNC path into its distro and Linux path. Accepts the WSL2
+* `\\wsl.localhost\<distro>\<linux>` form, the legacy `\\wsl$\<distro>\<linux>`
+* interop form, and forward-slash spellings of either.
+* @param raw - candidate absolute path.
+* @returns the parsed target, or null when the path is not a WSL UNC.
+*/
+function parseWslUnc(raw) {
+	const normalized = raw.replace(/\\/g, "/").replace(/\/\/+/g, "//");
+	if (!normalized.startsWith("//")) return null;
+	const segments = normalized.slice(2).split("/");
+	const host = (segments[0] ?? "").toLowerCase();
+	if (!UNC_HOSTS.includes(host)) return null;
+	const distro = segments[1] ?? "";
+	if (distro === "") return null;
+	const rest = segments.slice(2).filter((segment) => segment.length > 0);
+	return {
+		distro,
+		linuxPath: `/${rest.join("/")}`
+	};
+}
+/**
+* Whether a path resolves into a WSL distro through either UNC form.
+* @param raw - candidate absolute path.
+* @returns whether the path parses as a WSL UNC.
+*/
+function isWslUnc(raw) {
+	return parseWslUnc(raw) !== null;
+}
+/**
+* Normalize a Linux absolute path for the Host: collapse repeated slashes and
+* strip a trailing slash (root becomes `/`).
+* @param path - absolute Linux path.
+* @returns the normalized path.
+*/
+function normalizeLinuxPath(path) {
+	const collapsed = path.replace(/\/+/g, "/");
+	return collapsed === "/" ? "/" : collapsed.replace(/\/$/, "");
+}
+/**
+* Whether a path is an absolute, non-empty Linux path.
+* @param path - candidate.
+* @returns whether it starts with `/` and contains no NUL.
+*/
+function isAbsoluteLinuxPath(path) {
+	return path.startsWith("/") && !path.includes("\0");
+}
+/**
+* Join a distro and a Linux absolute path into the WSL2 UNC form used as the
+* workspace identity (`\\wsl.localhost\<distro>\<linux>`, backslash segments).
+* @param distro - distro name.
+* @param linuxPath - absolute Linux path (leading `/`).
+* @returns the UNC path.
+*/
+function joinUnc(distro, linuxPath) {
+	if (!isAbsoluteLinuxPath(linuxPath)) throw new Error(`wsl-workspace: cannot map a non-absolute Linux path "${linuxPath}" to UNC`);
+	if (distro === "" || distro === "." || distro === ".." || /[\\/]/.test(distro)) throw new Error(`wsl-workspace: invalid distribution name "${distro}"`);
+	const normalized = linuxPath.replace(/\/+/g, "/").replace(/\/$/, "");
+	const withoutLeading = normalized.startsWith("/") ? normalized.slice(1) : normalized;
+	const windowsSegments = withoutLeading.replace(/\//g, "\\");
+	const suffix = windowsSegments === "" ? "" : `\\${windowsSegments}`;
+	return `\\\\wsl.localhost\\${distro}${suffix}`;
+}
+/**
+* Translate a `/mnt/<drive>/…` path back to its Windows drive path.
+* @param linuxPath - the candidate Linux path.
+* @returns the `X:\…` drive path, or `null` when the path is not a drvfs mount.
+*/
+function mntToWindowsPath(linuxPath) {
+	const match = /^\/mnt\/([a-zA-Z])(?:\/(.*))?$/.exec(linuxPath);
+	if (match === null) return null;
+	const rest = (match[2] ?? "").replace(/\//g, "\\");
+	return `${(match[1] ?? "").toUpperCase()}:\\${rest}`;
+}
+/**
+* Canonical Windows drive path for store keys and cross-realm identity:
+* separators unified to `\`, trailing separator stripped, and the WHOLE path
+* lowercased — Windows paths compare case-insensitively, and the workspace
+* registry may realpath a different casing than the caller spelled (8.3 or
+* on-disk casing), so the store key must collide across casings.
+* @param path - candidate Windows drive path.
+* @returns the canonical form, or `null` when not drive-shaped.
+*/
+function canonicalWindowsPath(path) {
+	const match = /^([A-Za-z]):[\\/](.*)$/.exec(path);
+	if (match === null) return null;
+	const rest = (match[2] ?? "").replace(/[\\/]+/g, "\\").replace(/\\$/, "").toLowerCase();
+	return `${(match[1] ?? "").toLowerCase()}:\\${rest}`;
+}
+/** Linux username shape for `wsl.exe -u`: starts with a letter or underscore, then letters/digits/`_`/`.`/`-` (max 64). */
+const WSL_USERNAME_PATTERN = /^[A-Za-z_][A-Za-z0-9_.-]{0,63}$/;
+/**
+* Whether a value is a safe Linux username for `wsl.exe -u`. The check is
+* strict on purpose: a value starting with `-` could be parsed as a wsl.exe
+* option instead of a username.
+* @param value - candidate username.
+* @returns whether it matches the Linux username shape.
+*/
+function isValidWslUsername(value) {
+	return WSL_USERNAME_PATTERN.test(value);
+}
+
+//#endregion
+//#region src/client/AddWslWorkspace.tsx
+/**
+* Build the Linux child path one level below a parent, for the breadcrumb/
+* browse drill.
+* @param parent - the currently listed absolute path (`/` for root).
+* @param name - the child directory name.
+* @returns the child's absolute Linux path.
+*/
+function dirChildPath(parent, name) {
+	return parent === "/" ? `/${name}` : `${parent}/${name}`;
+}
+/** A tiny inline terminal glyph for the dialog's directory rows. */
+function WslGlyph({ size = 16 }) {
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("svg", {
+		width: size,
+		height: size,
+		viewBox: "0 0 24 24",
+		fill: "none",
+		"aria-hidden": "true",
+		children: [
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("rect", {
+				x: "2.5",
+				y: "4.5",
+				width: "19",
+				height: "15",
+				rx: "2.5",
+				stroke: "currentColor",
+				strokeWidth: "1.6"
+			}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", {
+				d: "M6 9l3.2 2.6L6 14",
+				stroke: "currentColor",
+				strokeWidth: "1.6",
+				strokeLinecap: "round",
+				strokeLinejoin: "round"
+			}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", {
+				d: "M12 14h5",
+				stroke: "currentColor",
+				strokeWidth: "1.6",
+				strokeLinecap: "round"
+			})
+		]
+	});
+}
+/**
+* The "Add WSL workspace…" footer action and its dialog.
+* @param props - owner share + injected face.
+*/
+function AddWslWorkspace({ wide, t, checkPreset, listDistros: listDistros$1, listDir: listDir$1, check: check$1, createWorkspace }) {
+	const [open, setOpen] = (0, react.useState)(false);
+	const [opening, setOpening] = (0, react.useState)(false);
+	const [distros, setDistros] = (0, react.useState)([]);
+	const [distro, setDistro] = (0, react.useState)("");
+	const [pathInput, setPathInput] = (0, react.useState)("/home/");
+	const [username, setUsername] = (0, react.useState)("");
+	const [listing, setListing] = (0, react.useState)(null);
+	const [browsePath, setBrowsePath] = (0, react.useState)("/");
+	const [browsing, setBrowsing] = (0, react.useState)(false);
+	const [error, setError] = (0, react.useState)(null);
+	const [busy, setBusy] = (0, react.useState)(false);
+	const browseSeq = (0, react.useRef)(0);
+	const refreshBrowse = async (root, targetDistro) => {
+		const seq = ++browseSeq.current;
+		setBrowsing(true);
+		setBrowsePath(root);
+		try {
+			const value = await listDir$1(targetDistro, root);
+			if (seq === browseSeq.current) setListing(value);
+		} catch {
+			if (seq === browseSeq.current) {
+				setListing(null);
+				setError((previous) => previous ?? t("error.loadDir"));
+			}
+		} finally {
+			if (seq === browseSeq.current) setBrowsing(false);
 		}
-		/**
-		* Perform one POST call and unwrap the envelope.
-		* @param method - the Host method name.
-		* @param params - the method payload.
-		* @returns the unwrapped value, or throws an Error on network or `ok:false`.
-		*/
-		async function call(method, params = {}) {
-			let response;
+	};
+	(0, react.useEffect)(() => {
+		if (!open) return;
+		let cancelled = false;
+		setError(null);
+		setOpening(true);
+		(async () => {
+			let presetIssue;
 			try {
-				response = await fetch(ENDPOINT, {
-					method: "POST",
-					headers: { "content-type": "application/json" },
-					body: JSON.stringify({
-						method,
-						params
-					})
-				});
-			} catch (error) {
-				throw new Error(`wsl-workspace request failed: ${errorMessage(error)}`);
+				presetIssue = await checkPreset();
+			} catch {
+				presetIssue = t("error.loadDistros");
 			}
-			let envelope;
+			let names;
 			try {
-				envelope = await response.json();
+				names = await listDistros$1();
 			} catch {
-				throw new Error(`wsl-workspace answered non-JSON (${response.status})`);
+				if (cancelled) return;
+				setOpening(false);
+				setError(t("error.loadDistros"));
+				return;
 			}
-			if (!envelope.ok) throw new Error(envelope.error);
-			return envelope.value;
-		}
-		/**
-		* List the WSL distros installed on the host.
-		* @returns distro names in registry order.
-		*/
-		async function listDistros() {
-			return call("listDistros", {});
-		}
-		/**
-		* List one directory level inside a distro.
-		* @param distro - distro name.
-		* @param path - absolute Linux directory to list.
-		* @returns the level's listing with ancestry.
-		*/
-		async function listDir(distro, path) {
-			return call("listDir", {
-				distro,
-				path
-			});
-		}
-		/**
-		* Check whether a Linux path exists and is a directory.
-		* @param distro - distro name.
-		* @param path - absolute Linux path.
-		* @returns existence and directory facts.
-		*/
-		async function check(distro, path) {
-			return call("check", {
-				distro,
-				path
-			});
-		}
-		/**
-		* Store (or clear, with an empty string) the username of one WSL workspace.
-		* @param path - the workspace UNC path.
-		* @param username - the Linux username; empty string clears the stored value.
-		*/
-		async function setWorkspaceUser(path, username) {
-			return call("setUser", {
-				path,
-				username
-			});
-		}
-		/**
-		* Register a `/mnt/<drive>` WSL workspace under its Windows drive path,
-		* recording the distro (and optional username) for the session env.
-		* @param linuxPath - the `/mnt/<drive>/…` Linux path.
-		* @param distro - the WSL distribution the workspace belongs to.
-		* @param username - optional Linux username.
-		*/
-		async function registerWindows(linuxPath, distro, username) {
-			return call("registerWindows", {
-				linuxPath,
-				distro,
-				username
-			});
-		}
-		/**
-		* List every registered WSL workspace key (canonical UNC and Windows drive
-		* spellings). The client uses the drive keys to recognize `/mnt` workspaces
-		* across page reloads.
-		*/
-		async function listWorkspaces() {
-			return call("listWorkspaces", {});
-		}
-		//#endregion
-		//#region src/shared/paths.ts
-		/** The two UNC hosts WSL exposes a distribution's filesystem under. */
-		const UNC_HOSTS = ["wsl.localhost", "wsl$"];
-		/**
-		* Parse a WSL UNC path into its distro and Linux path. Accepts the WSL2
-		* `\\wsl.localhost\<distro>\<linux>` form, the legacy `\\wsl$\<distro>\<linux>`
-		* interop form, and forward-slash spellings of either.
-		* @param raw - candidate absolute path.
-		* @returns the parsed target, or null when the path is not a WSL UNC.
-		*/
-		function parseWslUnc(raw) {
-			const normalized = raw.replace(/\\/g, "/").replace(/\/\/+/g, "//");
-			if (!normalized.startsWith("//")) return null;
-			const segments = normalized.slice(2).split("/");
-			const host = (segments[0] ?? "").toLowerCase();
-			if (!UNC_HOSTS.includes(host)) return null;
-			const distro = segments[1] ?? "";
-			if (distro === "") return null;
-			return {
-				distro,
-				linuxPath: `/${segments.slice(2).filter((segment) => segment.length > 0).join("/")}`
-			};
-		}
-		/**
-		* Whether a path resolves into a WSL distro through either UNC form.
-		* @param raw - candidate absolute path.
-		* @returns whether the path parses as a WSL UNC.
-		*/
-		function isWslUnc(raw) {
-			return parseWslUnc(raw) !== null;
-		}
-		/**
-		* Normalize a Linux absolute path for the Host: collapse repeated slashes and
-		* strip a trailing slash (root becomes `/`).
-		* @param path - absolute Linux path.
-		* @returns the normalized path.
-		*/
-		function normalizeLinuxPath(path) {
-			const collapsed = path.replace(/\/+/g, "/");
-			return collapsed === "/" ? "/" : collapsed.replace(/\/$/, "");
-		}
-		/**
-		* Whether a path is an absolute, non-empty Linux path.
-		* @param path - candidate.
-		* @returns whether it starts with `/` and contains no NUL.
-		*/
-		function isAbsoluteLinuxPath(path) {
-			return path.startsWith("/") && !path.includes("\0");
-		}
-		/**
-		* Join a distro and a Linux absolute path into the WSL2 UNC form used as the
-		* workspace identity (`\\wsl.localhost\<distro>\<linux>`, backslash segments).
-		* @param distro - distro name.
-		* @param linuxPath - absolute Linux path (leading `/`).
-		* @returns the UNC path.
-		*/
-		function joinUnc(distro, linuxPath) {
-			if (!isAbsoluteLinuxPath(linuxPath)) throw new Error(`wsl-workspace: cannot map a non-absolute Linux path "${linuxPath}" to UNC`);
-			if (distro === "" || distro === "." || distro === ".." || /[\\/]/.test(distro)) throw new Error(`wsl-workspace: invalid distribution name "${distro}"`);
-			const normalized = linuxPath.replace(/\/+/g, "/").replace(/\/$/, "");
-			const windowsSegments = (normalized.startsWith("/") ? normalized.slice(1) : normalized).replace(/\//g, "\\");
-			return `\\\\wsl.localhost\\${distro}${windowsSegments === "" ? "" : `\\${windowsSegments}`}`;
+			if (cancelled) return;
+			setDistros(names);
+			const first = names[0] ?? "";
+			setDistro(first);
+			setBrowsing(true);
+			setOpening(false);
+			if (presetIssue !== void 0) setError(presetIssue);
+			if (first !== "") refreshBrowse("/", first);
+		})();
+		return () => {
+			cancelled = true;
+		};
+	}, [open]);
+	(0, react.useEffect)(() => {
+		if (!open) return;
+		const onKey = (event) => {
+			if (event.key === "Escape" && !busy) setOpen(false);
+		};
+		window.addEventListener("keydown", onKey);
+		return () => window.removeEventListener("keydown", onKey);
+	}, [open, busy]);
+	if (!open) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+		type: "button",
+		className: wide ? "dww-action dww-action--wide" : "dww-action dww-action--rail",
+		title: t("action.title"),
+		"aria-label": t("action.title"),
+		onClick: () => setOpen(true),
+		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+			className: "dww-letter",
+			"aria-hidden": "true",
+			children: "W"
+		})
+	});
+	const onDrill = (name) => {
+		const next = dirChildPath(listing?.path ?? browsePath, name);
+		setPathInput(next);
+		refreshBrowse(next, distro);
+	};
+	const onUp = () => {
+		const parent = listing?.parent ?? null;
+		if (parent === null) return;
+		setPathInput(parent);
+		refreshBrowse(parent, distro);
+	};
+	const onDistroChange = (value) => {
+		setDistro(value);
+		refreshBrowse(browsePath, value);
+	};
+	const onCheck = async () => {
+		const path = normalizeLinuxPath(pathInput);
+		setError(null);
+		if (!isAbsoluteLinuxPath(path) || path === "/") {
+			setError(t("error.invalidPath"));
+			return;
 		}
-		/**
-		* Translate a `/mnt/<drive>/…` path back to its Windows drive path.
-		* @param linuxPath - the candidate Linux path.
-		* @returns the `X:\…` drive path, or `null` when the path is not a drvfs mount.
-		*/
-		function mntToWindowsPath(linuxPath) {
-			const match = /^\/mnt\/([a-zA-Z])(?:\/(.*))?$/.exec(linuxPath);
-			if (match === null) return null;
-			const rest = (match[2] ?? "").replace(/\//g, "\\");
-			return `${(match[1] ?? "").toUpperCase()}:\\${rest}`;
+		let facts;
+		try {
+			facts = await check$1(distro, path);
+		} catch {
+			setError(t("error.pathNotFound"));
+			return;
 		}
-		/**
-		* Canonical Windows drive path for store keys and cross-realm identity:
-		* separators unified to `\`, trailing separator stripped, and the WHOLE path
-		* lowercased — Windows paths compare case-insensitively, and the workspace
-		* registry may realpath a different casing than the caller spelled (8.3 or
-		* on-disk casing), so the store key must collide across casings.
-		* @param path - candidate Windows drive path.
-		* @returns the canonical form, or `null` when not drive-shaped.
-		*/
-		function canonicalWindowsPath(path) {
-			const match = /^([A-Za-z]):[\\/](.*)$/.exec(path);
-			if (match === null) return null;
-			const rest = (match[2] ?? "").replace(/[\\/]+/g, "\\").replace(/\\$/, "").toLowerCase();
-			return `${(match[1] ?? "").toLowerCase()}:\\${rest}`;
+		if (!facts.exists || !facts.isDirectory) {
+			setError(t("error.pathNotFound"));
+			return;
 		}
-		/** Linux username shape for `wsl.exe -u`: starts with a letter or underscore, then letters/digits/`_`/`.`/`-` (max 64). */
-		const WSL_USERNAME_PATTERN = /^[A-Za-z_][A-Za-z0-9_.-]{0,63}$/;
-		/**
-		* Whether a value is a safe Linux username for `wsl.exe -u`. The check is
-		* strict on purpose: a value starting with `-` could be parsed as a wsl.exe
-		* option instead of a username.
-		* @param value - candidate username.
-		* @returns whether it matches the Linux username shape.
-		*/
-		function isValidWslUsername(value) {
-			return WSL_USERNAME_PATTERN.test(value);
+		refreshBrowse(path, distro);
+	};
+	const onConfirm = async () => {
+		const path = normalizeLinuxPath(pathInput);
+		setError(null);
+		if (!isAbsoluteLinuxPath(path) || path === "/") {
+			setError(t("error.invalidPath"));
+			return;
 		}
-		//#endregion
-		//#region src/client/AddWslWorkspace.tsx
-		/**
-		* Build the Linux child path one level below a parent, for the breadcrumb/
-		* browse drill.
-		* @param parent - the currently listed absolute path (`/` for root).
-		* @param name - the child directory name.
-		* @returns the child's absolute Linux path.
-		*/
-		function dirChildPath(parent, name) {
-			return parent === "/" ? `/${name}` : `${parent}/${name}`;
+		const user = username.trim();
+		if (user !== "" && !isValidWslUsername(user)) {
+			setError(t("error.invalidUsername"));
+			return;
 		}
-		/** A tiny inline terminal glyph for the dialog's directory rows. */
-		function WslGlyph({ size = 16 }) {
-			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("svg", {
-				width: size,
-				height: size,
-				viewBox: "0 0 24 24",
-				fill: "none",
-				"aria-hidden": "true",
-				children: [
-					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("rect", {
-						x: "2.5",
-						y: "4.5",
-						width: "19",
-						height: "15",
-						rx: "2.5",
-						stroke: "currentColor",
-						strokeWidth: "1.6"
-					}),
-					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", {
-						d: "M6 9l3.2 2.6L6 14",
-						stroke: "currentColor",
-						strokeWidth: "1.6",
-						strokeLinecap: "round",
-						strokeLinejoin: "round"
-					}),
-					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", {
-						d: "M12 14h5",
-						stroke: "currentColor",
-						strokeWidth: "1.6",
-						strokeLinecap: "round"
-					})
-				]
-			});
+		setBusy(true);
+		try {
+			let facts;
+			try {
+				facts = await check$1(distro, path);
+			} catch {
+				setError(t("error.pathNotFound"));
+				return;
+			}
+			if (!facts.exists || !facts.isDirectory) {
+				setError(t("error.pathNotFound"));
+				return;
+			}
+			const failure = await createWorkspace(path, user, distro);
+			if (failure !== void 0) {
+				setError(failure);
+				return;
+			}
+			setOpen(false);
+		} finally {
+			setBusy(false);
 		}
-		/**
-		* The "Add WSL workspace…" footer action and its dialog.
-		* @param props - owner share + injected face.
-		*/
-		function AddWslWorkspace({ wide, t, checkPreset, listDistros, listDir, check, createWorkspace }) {
-			const [open, setOpen] = (0, react.useState)(false);
-			const [opening, setOpening] = (0, react.useState)(false);
-			const [distros, setDistros] = (0, react.useState)([]);
-			const [distro, setDistro] = (0, react.useState)("");
-			const [pathInput, setPathInput] = (0, react.useState)("/home/");
-			const [username, setUsername] = (0, react.useState)("");
-			const [listing, setListing] = (0, react.useState)(null);
-			const [browsePath, setBrowsePath] = (0, react.useState)("/");
-			const [browsing, setBrowsing] = (0, react.useState)(false);
-			const [error, setError] = (0, react.useState)(null);
-			const [busy, setBusy] = (0, react.useState)(false);
-			const browseSeq = (0, react.useRef)(0);
-			const refreshBrowse = async (root, targetDistro) => {
-				const seq = ++browseSeq.current;
-				setBrowsing(true);
-				setBrowsePath(root);
-				try {
-					const value = await listDir(targetDistro, root);
-					if (seq === browseSeq.current) setListing(value);
-				} catch {
-					if (seq === browseSeq.current) {
-						setListing(null);
-						setError((previous) => previous ?? t("error.loadDir"));
-					}
-				} finally {
-					if (seq === browseSeq.current) setBrowsing(false);
-				}
-			};
-			(0, react.useEffect)(() => {
-				if (!open) return;
-				let cancelled = false;
-				setError(null);
-				setOpening(true);
-				(async () => {
-					let presetIssue;
-					try {
-						presetIssue = await checkPreset();
-					} catch {
-						presetIssue = t("error.loadDistros");
-					}
-					let names;
-					try {
-						names = await listDistros();
-					} catch {
-						if (cancelled) return;
-						setOpening(false);
-						setError(t("error.loadDistros"));
-						return;
-					}
-					if (cancelled) return;
-					setDistros(names);
-					const first = names[0] ?? "";
-					setDistro(first);
-					setBrowsing(true);
-					setOpening(false);
-					if (presetIssue !== void 0) setError(presetIssue);
-					if (first !== "") refreshBrowse("/", first);
-				})();
-				return () => {
-					cancelled = true;
-				};
-			}, [open]);
-			(0, react.useEffect)(() => {
-				if (!open) return;
-				const onKey = (event) => {
-					if (event.key === "Escape" && !busy) setOpen(false);
-				};
-				window.addEventListener("keydown", onKey);
-				return () => window.removeEventListener("keydown", onKey);
-			}, [open, busy]);
-			if (!open) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-				type: "button",
-				className: wide ? "dww-action dww-action--wide" : "dww-action dww-action--rail",
-				title: t("action.title"),
-				"aria-label": t("action.title"),
-				onClick: () => setOpen(true),
-				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-					className: "dww-letter",
-					"aria-hidden": "true",
-					children: "W"
-				})
-			});
-			const onDrill = (name) => {
-				const next = dirChildPath(listing?.path ?? browsePath, name);
-				setPathInput(next);
-				refreshBrowse(next, distro);
-			};
-			const onUp = () => {
-				const parent = listing?.parent ?? null;
-				if (parent === null) return;
-				setPathInput(parent);
-				refreshBrowse(parent, distro);
-			};
-			const onDistroChange = (value) => {
-				setDistro(value);
-				refreshBrowse(browsePath, value);
-			};
-			const onCheck = async () => {
-				const path = normalizeLinuxPath(pathInput);
-				setError(null);
-				if (!isAbsoluteLinuxPath(path) || path === "/") {
-					setError(t("error.invalidPath"));
-					return;
-				}
-				let facts;
-				try {
-					facts = await check(distro, path);
-				} catch {
-					setError(t("error.pathNotFound"));
-					return;
-				}
-				if (!facts.exists || !facts.isDirectory) {
-					setError(t("error.pathNotFound"));
-					return;
-				}
-				refreshBrowse(path, distro);
-			};
-			const onConfirm = async () => {
-				const path = normalizeLinuxPath(pathInput);
-				setError(null);
-				if (!isAbsoluteLinuxPath(path) || path === "/") {
-					setError(t("error.invalidPath"));
-					return;
-				}
-				const user = username.trim();
-				if (user !== "" && !isValidWslUsername(user)) {
-					setError(t("error.invalidUsername"));
-					return;
-				}
-				setBusy(true);
-				try {
-					let facts;
-					try {
-						facts = await check(distro, path);
-					} catch {
-						setError(t("error.pathNotFound"));
-						return;
-					}
-					if (!facts.exists || !facts.isDirectory) {
-						setError(t("error.pathNotFound"));
-						return;
-					}
-					const failure = await createWorkspace(path, user, distro);
-					if (failure !== void 0) {
-						setError(failure);
-						return;
-					}
-					setOpen(false);
-				} finally {
-					setBusy(false);
-				}
-			};
-			const children = (listing?.entries.filter((entry) => entry.kind === "directory") ?? []).map((entry) => entry.name);
-			const maskClick = () => {
-				if (!busy) setOpen(false);
-			};
-			const listScroll = () => {};
-			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-				className: "dww-overlay",
-				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-					className: "dww-overlay-mask",
-					onClick: maskClick
-				}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-					className: "dww-card",
-					role: "dialog",
-					"aria-modal": "true",
-					"aria-label": t("dialog.title"),
+	};
+	const children = (listing?.entries.filter((entry) => entry.kind === "directory") ?? []).map((entry) => entry.name);
+	const maskClick = () => {
+		if (!busy) setOpen(false);
+	};
+	const listScroll = () => {};
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+		className: "dww-overlay",
+		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+			className: "dww-overlay-mask",
+			onClick: maskClick
+		}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+			className: "dww-card",
+			role: "dialog",
+			"aria-modal": "true",
+			"aria-label": t("dialog.title"),
+			children: [
+				/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					className: "dww-header",
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h2", {
+						className: "dww-title",
+						children: t("dialog.title")
+					}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+						type: "button",
+						className: "dww-close",
+						"aria-label": t("dialog.cancel"),
+						onClick: maskClick,
+						children: "✕"
+					})]
+				}),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					className: "dww-body",
 					children: [
-						/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-							className: "dww-header",
-							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h2", {
-								className: "dww-title",
-								children: t("dialog.title")
-							}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+						error !== null ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: "dww-error",
+							children: [error, /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 								type: "button",
-								className: "dww-close",
-								"aria-label": t("dialog.cancel"),
-								onClick: maskClick,
-								children: "✕"
+								className: "dww-retry",
+								onClick: () => setError(null),
+								children: t("dialog.retry")
+							})]
+						}) : null,
+						/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: "dww-field",
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("label", {
+								className: "dww-field-label",
+								htmlFor: "dww-distro",
+								children: t("dialog.distro")
+							}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("select", {
+								id: "dww-distro",
+								className: "dww-select",
+								value: distro,
+								disabled: opening || busy,
+								onChange: (event) => onDistroChange(event.target.value),
+								children: distros.length === 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
+									value: "",
+									children: opening ? t("dialog.loading") : ""
+								}) : distros.map((name) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
+									value: name,
+									children: name
+								}, name))
 							})]
 						}),
 						/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-							className: "dww-body",
-							children: [
-								error !== null ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-									className: "dww-error",
-									children: [error, /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-										type: "button",
-										className: "dww-retry",
-										onClick: () => setError(null),
-										children: t("dialog.retry")
-									})]
-								}) : null,
-								/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-									className: "dww-field",
-									children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("label", {
-										className: "dww-field-label",
-										htmlFor: "dww-distro",
-										children: t("dialog.distro")
-									}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("select", {
-										id: "dww-distro",
-										className: "dww-select",
-										value: distro,
-										disabled: opening || busy,
-										onChange: (event) => onDistroChange(event.target.value),
-										children: distros.length === 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
-											value: "",
-											children: opening ? t("dialog.loading") : ""
-										}) : distros.map((name) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
-											value: name,
-											children: name
-										}, name))
-									})]
-								}),
-								/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-									className: "dww-field",
-									children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("label", {
-										className: "dww-field-label",
-										htmlFor: "dww-path",
-										children: t("dialog.path")
-									}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-										className: "dww-input-row",
-										children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
-											id: "dww-path",
-											className: "dww-input",
-											value: pathInput,
-											placeholder: t("dialog.pathPlaceholder"),
-											disabled: opening || busy,
-											onChange: (event) => setPathInput(event.target.value)
-										}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-											type: "button",
-											className: "dww-check-btn",
-											disabled: opening || busy,
-											onClick: () => void onCheck(),
-											children: t("dialog.check")
-										})]
-									})]
-								}),
-								/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-									className: "dww-field",
-									children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("label", {
-										className: "dww-field-label",
-										htmlFor: "dww-username",
-										children: t("dialog.username")
-									}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
-										id: "dww-username",
-										className: "dww-input",
-										value: username,
-										placeholder: t("dialog.usernamePlaceholder"),
-										disabled: opening || busy,
-										autoComplete: "off",
-										spellCheck: false,
-										onChange: (event) => setUsername(event.target.value)
-									})]
-								}),
-								/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-									className: "dww-feedback",
-									children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-										className: "dww-breadcrumb",
-										children: browsePath
-									}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-										className: "dww-dirlist",
-										onScroll: listScroll,
-										children: [browsing ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-											className: "dww-dir-empty",
-											children: t("dialog.loading")
-										}) : listing?.parent !== null && listing !== null ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
-											type: "button",
-											className: "dww-dir-row dww-dir-row--up",
-											onClick: onUp,
-											children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(WslGlyph, { size: 14 }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: t("dialog.upLevel") })]
-										}) : null, !browsing && children.length === 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-											className: "dww-dir-empty",
-											children: t("dialog.browseEmpty")
-										}) : children.map((name) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
-											type: "button",
-											className: "dww-dir-row",
-											onClick: () => onDrill(name),
-											children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(WslGlyph, { size: 14 }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: name })]
-										}, name))]
-									})]
-								})
-							]
+							className: "dww-field",
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("label", {
+								className: "dww-field-label",
+								htmlFor: "dww-path",
+								children: t("dialog.path")
+							}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+								className: "dww-input-row",
+								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+									id: "dww-path",
+									className: "dww-input",
+									value: pathInput,
+									placeholder: t("dialog.pathPlaceholder"),
+									disabled: opening || busy,
+									onChange: (event) => setPathInput(event.target.value)
+								}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+									type: "button",
+									className: "dww-check-btn",
+									disabled: opening || busy,
+									onClick: () => void onCheck(),
+									children: t("dialog.check")
+								})]
+							})]
 						}),
 						/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-							className: "dww-actions",
-							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-								type: "button",
-								className: "dww-btn",
-								disabled: busy,
-								onClick: maskClick,
-								children: t("dialog.cancel")
-							}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-								type: "button",
-								className: "dww-btn dww-btn--primary",
-								disabled: busy || opening,
-								onClick: () => void onConfirm(),
-								children: busy ? t("dialog.loading") : t("dialog.confirm")
+							className: "dww-field",
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("label", {
+								className: "dww-field-label",
+								htmlFor: "dww-username",
+								children: t("dialog.username")
+							}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+								id: "dww-username",
+								className: "dww-input",
+								value: username,
+								placeholder: t("dialog.usernamePlaceholder"),
+								disabled: opening || busy,
+								autoComplete: "off",
+								spellCheck: false,
+								onChange: (event) => setUsername(event.target.value)
+							})]
+						}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: "dww-feedback",
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+								className: "dww-breadcrumb",
+								children: browsePath
+							}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+								className: "dww-dirlist",
+								onScroll: listScroll,
+								children: [browsing ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+									className: "dww-dir-empty",
+									children: t("dialog.loading")
+								}) : listing?.parent !== null && listing !== null ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
+									type: "button",
+									className: "dww-dir-row dww-dir-row--up",
+									onClick: onUp,
+									children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(WslGlyph, { size: 14 }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: t("dialog.upLevel") })]
+								}) : null, !browsing && children.length === 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+									className: "dww-dir-empty",
+									children: t("dialog.browseEmpty")
+								}) : children.map((name) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
+									type: "button",
+									className: "dww-dir-row",
+									onClick: () => onDrill(name),
+									children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(WslGlyph, { size: 14 }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: name })]
+								}, name))]
 							})]
 						})
 					]
-				})]
-			});
-		}
-		//#endregion
-		//#region src/client/styles.ts
-		/**
-		* Third-party stylesheet injection for the WSL workspace UI (the plugin
-		* builds no CSS bundle, so styles are injected as one idempotent `<style>`).
-		* Colors derive exclusively from the `--dsw-*` design tokens.
-		*/
-		const STYLE_TAG_DATA_ATTRIBUTE = "data-plugin=\"dsh-wsl-workspace\"";
-		const STYLES = `
+				}),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					className: "dww-actions",
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+						type: "button",
+						className: "dww-btn",
+						disabled: busy,
+						onClick: maskClick,
+						children: t("dialog.cancel")
+					}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+						type: "button",
+						className: "dww-btn dww-btn--primary",
+						disabled: busy || opening,
+						onClick: () => void onConfirm(),
+						children: busy ? t("dialog.loading") : t("dialog.confirm")
+					})]
+				})
+			]
+		})]
+	});
+}
+
+//#endregion
+//#region src/client/styles.ts
+/**
+* Third-party stylesheet injection for the WSL workspace UI (the plugin
+* builds no CSS bundle, so styles are injected as one idempotent `<style>`).
+* Colors derive exclusively from the `--dsw-*` design tokens.
+*/
+const STYLE_TAG_DATA_ATTRIBUTE = "data-plugin=\"dsh-wsl-workspace\"";
+const STYLES = `
 /* Sidebar-foot icon action beside Settings (28px round in the wide sidebar,
    36px round in the rail), matching the shell's icon-button language. */
 .dww-action {
@@ -837,217 +871,303 @@ window.__ModuleLoader__.load({
 .dww-btn--primary:hover:not(:disabled) { background: var(--dsw-alias-button-primary-hover); }
 .dww-btn:disabled { cursor: default; opacity: 0.6; }
 `;
-		/**
-		* Idempotently inject the plugin stylesheet. No-op when a tag with the
-		* plugin's data attribute already exists.
-		*/
-		function ensureStyles() {
-			if (typeof document === "undefined") return;
-			if (document.querySelector(`style[${STYLE_TAG_DATA_ATTRIBUTE}]`) !== null) return;
-			const style = document.createElement("style");
-			style.setAttribute("data-plugin", "dsh-wsl-workspace");
-			style.textContent = STYLES;
-			document.head.appendChild(style);
+/**
+* Idempotently inject the plugin stylesheet. No-op when a tag with the
+* plugin's data attribute already exists.
+*/
+function ensureStyles() {
+	if (typeof document === "undefined") return;
+	if (document.querySelector(`style[${STYLE_TAG_DATA_ATTRIBUTE}]`) !== null) return;
+	const style = document.createElement("style");
+	style.setAttribute("data-plugin", "dsh-wsl-workspace");
+	style.textContent = STYLES;
+	document.head.appendChild(style);
+}
+
+//#endregion
+//#region src/client/locales.ts
+/**
+* Bilingual dictionaries for the `wslWorkspace` locale namespace. Product copy
+* is Chinese; English is the parallel export for the standalone bundle.
+*/
+/**
+* The `wslWorkspace` translations (Chinese, the primary product copy).
+*/
+const zh = {
+	"action.add": "WSL 工作区",
+	"action.title": "添加 WSL 工作区…",
+	"dialog.title": "添加 WSL 工作区",
+	"dialog.distro": "发行版",
+	"dialog.path": "路径",
+	"dialog.pathPlaceholder": "/home/",
+	"dialog.username": "用户名",
+	"dialog.usernamePlaceholder": "留空则使用发行版默认用户",
+	"dialog.loading": "正在加载…",
+	"dialog.browseEmpty": "此目录没有子文件夹",
+	"dialog.upLevel": "..（返回上级）",
+	"dialog.browse": "浏览",
+	"dialog.check": "检查",
+	"dialog.confirm": "创建并打开",
+	"dialog.cancel": "取消",
+	"dialog.retry": "重试",
+	"error.loadDistros": "无法获取 WSL 发行版列表，请确认已安装 WSL 且插件宿主端可用",
+	"error.rateLimited": "操作过于频繁，请稍后重试",
+	"error.loadDir": "无法浏览该目录",
+	"error.presetMissing": "未找到健康的 wsl preset，请确认插件宿主端已安装并配置该 preset",
+	"error.invalidPath": "请输入以 / 开头的 Linux 绝对路径",
+	"error.invalidUsername": "用户名无效：需以字母或下划线开头，仅含字母、数字、_、.、-",
+	"error.pathNotFound": "该路径不存在或是文件，请选择一个文件夹",
+	"error.createFailed": "创建工作区失败"
+};
+/**
+* The `wslWorkspace` translations (English).
+*/
+const en = {
+	"action.add": "WSL Workspace",
+	"action.title": "Add WSL workspace…",
+	"dialog.title": "Add WSL workspace",
+	"dialog.distro": "Distro",
+	"dialog.path": "Path",
+	"dialog.pathPlaceholder": "/home/",
+	"dialog.username": "Username",
+	"dialog.usernamePlaceholder": "Leave empty to use the distro default user",
+	"dialog.loading": "Loading…",
+	"dialog.browseEmpty": "No subdirectories here",
+	"dialog.upLevel": ".. (up)",
+	"dialog.browse": "Browse",
+	"dialog.check": "Check",
+	"dialog.confirm": "Create & open",
+	"dialog.cancel": "Cancel",
+	"dialog.retry": "Retry",
+	"error.loadDistros": "Could not list WSL distros; confirm WSL is installed and the plugin host side is reachable",
+	"error.rateLimited": "Too many attempts; retry in a moment",
+	"error.loadDir": "Could not browse this directory",
+	"error.presetMissing": "No healthy \"wsl\" preset found; confirm the plugin host side installed and configured it",
+	"error.invalidPath": "Enter an absolute Linux path starting with /",
+	"error.invalidUsername": "Invalid username: start with a letter or underscore; only letters, digits, _ . -",
+	"error.pathNotFound": "The path does not exist or is a file; choose a folder",
+	"error.createFailed": "Failed to create the workspace"
+};
+
+//#endregion
+//#region src/client/index.ts
+/** Required services (cordis fiber inject). */
+const inject = [
+	"slots",
+	"locale",
+	"sessions",
+	"workspaces"
+];
+/** The legacy standalone WSL preset id (folded into the mode variants). */
+const LEGACY_WSL_PRESET_ID = "wsl";
+/**
+* Mount the sidebar action and the auto-binding effect.
+* @param ctx - the browser plugin context.
+*/
+function apply(ctx) {
+	const workspaces = ctx.get("workspaces");
+	const sessions = ctx.get("sessions");
+	const legacyApi = () => ctx.get("connection")?.api;
+	const remoteAgentPresets = () => ctx.get("remote.agentPresets");
+	const uiWorkspaceService = () => ctx.get("uiWorkspace");
+	const hasNoteAgentPreset = typeof sessions.noteAgentPreset === "function";
+	/** Unified agent-preset list: new `remote.agentPresets` namespace (v0.1.2-rc.1+) or legacy `connection.api` (v0.1.1-rc.2). */
+	const listAgentPresets = async () => {
+		const agentPresets = remoteAgentPresets();
+		if (agentPresets !== void 0) {
+			const r = await agentPresets.list();
+			if (!r.ok) return {
+				ok: false,
+				presets: [],
+				error: r.error?.message ?? "list failed"
+			};
+			return {
+				ok: true,
+				presets: r.value?.presets ?? []
+			};
+		}
+		const api = legacyApi();
+		if (api !== void 0) {
+			const r = await api.agentPresets.list({});
+			if (!r.result.ok) return {
+				ok: false,
+				presets: [],
+				error: r.result.error?.message ?? "list failed"
+			};
+			return {
+				ok: true,
+				presets: r.result.value?.presets ?? []
+			};
 		}
-		//#endregion
-		//#region src/client/locales.ts
-		/**
-		* Bilingual dictionaries for the `wslWorkspace` locale namespace. Product copy
-		* is Chinese; English is the parallel export for the standalone bundle.
-		*/
-		/**
-		* The `wslWorkspace` translations (Chinese, the primary product copy).
-		*/
-		const zh = {
-			"action.add": "WSL 工作区",
-			"action.title": "添加 WSL 工作区…",
-			"dialog.title": "添加 WSL 工作区",
-			"dialog.distro": "发行版",
-			"dialog.path": "路径",
-			"dialog.pathPlaceholder": "/home/",
-			"dialog.username": "用户名",
-			"dialog.usernamePlaceholder": "留空则使用发行版默认用户",
-			"dialog.loading": "正在加载…",
-			"dialog.browseEmpty": "此目录没有子文件夹",
-			"dialog.upLevel": "..（返回上级）",
-			"dialog.browse": "浏览",
-			"dialog.check": "检查",
-			"dialog.confirm": "创建并打开",
-			"dialog.cancel": "取消",
-			"dialog.retry": "重试",
-			"error.loadDistros": "无法获取 WSL 发行版列表，请确认已安装 WSL 且插件宿主端可用",
-			"error.rateLimited": "操作过于频繁，请稍后重试",
-			"error.loadDir": "无法浏览该目录",
-			"error.presetMissing": "未找到健康的 wsl preset，请确认插件宿主端已安装并配置该 preset",
-			"error.invalidPath": "请输入以 / 开头的 Linux 绝对路径",
-			"error.invalidUsername": "用户名无效：需以字母或下划线开头，仅含字母、数字、_、.、-",
-			"error.pathNotFound": "该路径不存在或是文件，请选择一个文件夹",
-			"error.createFailed": "创建工作区失败"
+		return {
+			ok: false,
+			presets: [],
+			error: "no remote api available"
 		};
-		/**
-		* The `wslWorkspace` translations (English).
-		*/
-		const en = {
-			"action.add": "WSL Workspace",
-			"action.title": "Add WSL workspace…",
-			"dialog.title": "Add WSL workspace",
-			"dialog.distro": "Distro",
-			"dialog.path": "Path",
-			"dialog.pathPlaceholder": "/home/",
-			"dialog.username": "Username",
-			"dialog.usernamePlaceholder": "Leave empty to use the distro default user",
-			"dialog.loading": "Loading…",
-			"dialog.browseEmpty": "No subdirectories here",
-			"dialog.upLevel": ".. (up)",
-			"dialog.browse": "Browse",
-			"dialog.check": "Check",
-			"dialog.confirm": "Create & open",
-			"dialog.cancel": "Cancel",
-			"dialog.retry": "Retry",
-			"error.loadDistros": "Could not list WSL distros; confirm WSL is installed and the plugin host side is reachable",
-			"error.rateLimited": "Too many attempts; retry in a moment",
-			"error.loadDir": "Could not browse this directory",
-			"error.presetMissing": "No healthy \"wsl\" preset found; confirm the plugin host side installed and configured it",
-			"error.invalidPath": "Enter an absolute Linux path starting with /",
-			"error.invalidUsername": "Invalid username: start with a letter or underscore; only letters, digits, _ . -",
-			"error.pathNotFound": "The path does not exist or is a file; choose a folder",
-			"error.createFailed": "Failed to create the workspace"
+	};
+	/** Unified agent-preset select: new `agentPresets.select(id, preset)` or legacy `connection.api.select({...})`. */
+	const selectAgentPreset = async (sessionId, presetId) => {
+		const agentPresets = remoteAgentPresets();
+		if (agentPresets !== void 0) return agentPresets.select(sessionId, presetId);
+		const api = legacyApi();
+		if (api !== void 0) {
+			const r = await api.agentPresets.select({
+				sessionId,
+				agentPreset: presetId
+			});
+			return { ok: r.result.ok };
+		}
+		return { ok: false };
+	};
+	/**
+	* Resolve how this release opens a session for a workspace - v0.1.2-rc.1+
+	* exposes `uiWorkspace.startSession`, v0.1.1-rc.2 keeps it on `workspaces`.
+	*
+	* Resolved BEFORE the workspace is written. A release that offers neither
+	* cannot open a session, and a silent fall-through would leave the workspace
+	* behind with an empty `sessionIds` while the dialog still reports success;
+	* failing here names the missing capability instead.
+	* @returns the starter for the service this release actually exposes.
+	* @throws Error naming both candidates when neither service is available.
+	*/
+	const resolveSessionStarter = () => {
+		const ui = uiWorkspaceService();
+		if (ui !== void 0) return (workspaceId) => {
+			ui.startSession(workspaceId);
 		};
-		//#endregion
-		//#region src/client/index.ts
-		/** Required services (cordis fiber inject). */
-		const inject = [
-			"slots",
-			"locale",
-			"connection",
-			"sessions",
-			"workspaces"
-		];
-		/** The legacy standalone WSL preset id (folded into the mode variants). */
-		const LEGACY_WSL_PRESET_ID = "wsl";
-		/**
-		* Mount the sidebar action and the auto-binding effect.
-		* @param ctx - the browser plugin context.
-		*/
-		function apply(ctx) {
-			const { api } = ctx.get("connection");
-			const workspaces = ctx.get("workspaces");
-			const sessions = ctx.get("sessions");
-			ensureStyles();
-			ctx.effect(() => ctx.locale.register("wslWorkspace", {
-				zh,
-				en
-			}), "dsh-wsl-workspace: locale dictionaries");
-			const t = ctx.locale.bind("wslWorkspace");
-			let wslWindowsPaths = /* @__PURE__ */ new Set();
-			const injected = () => ({
-				t,
-				checkPreset: async () => {
-					let roster;
-					try {
-						roster = (await api.agentPresets.list({})).result;
-					} catch (error) {
-						return error instanceof Error ? error.message : String(error);
-					}
-					if (!roster.ok) return roster.error.message;
-					if (roster.value.presets.find((entry) => entry.id.startsWith("wsl-") && entry.broken === void 0) === void 0) return t("error.presetMissing");
-				},
-				listDistros: () => listDistros(),
-				listDir: (distro, path) => listDir(distro, path),
-				check: (distro, path) => check(distro, path),
-				createWorkspace: async (linuxPath, username, distro) => {
-					try {
-						const winPath = mntToWindowsPath(linuxPath);
-						if (winPath !== null) {
-							const view = await workspaces.create({ path: winPath });
-							await registerWindows(linuxPath, distro, username);
-							const canonical = canonicalWindowsPath(winPath);
-							if (canonical !== null) wslWindowsPaths = new Set(wslWindowsPaths).add(canonical);
-							workspaces.startSession(view.workspaceId);
-							return;
-						}
-						const uncPath = joinUnc(distro, linuxPath);
-						const view = await workspaces.create({ path: uncPath });
-						await setWorkspaceUser(uncPath, username);
-						workspaces.startSession(view.workspaceId);
-						return;
-					} catch (error) {
-						return error instanceof Error ? error.message : String(error);
-					}
+		const legacyStart = workspaces.startSession;
+		if (typeof legacyStart === "function") return (workspaceId) => {
+			Reflect.apply(legacyStart, workspaces, [workspaceId]);
+		};
+		throw new Error("workspace session API unavailable: this DSH release exposes neither uiWorkspace.startSession nor workspaces.startSession");
+	};
+	/** Read agent preset — v0.1.2-rc.1+ uses projectionValues; v0.1.1-rc.2 uses direct field. */
+	const getAgentPreset = (summary) => {
+		if (summary.projectionValues?.agentPreset !== void 0) {
+			const v = summary.projectionValues.agentPreset;
+			return v === null ? void 0 : v;
+		}
+		return summary.agentPreset;
+	};
+	/** Note preset change — v0.1.1-rc.2 calls noteAgentPreset; v0.1.2-rc.1+ is auto-synced via projection. */
+	const noteAgentPresetCompat = (sessionId, presetId) => {
+		if (hasNoteAgentPreset && sessions.noteAgentPreset) sessions.noteAgentPreset(sessionId, presetId);
+	};
+	ensureStyles();
+	ctx.effect(() => ctx.locale.register("wslWorkspace", {
+		zh,
+		en
+	}), "dsh-wsl-workspace: locale dictionaries");
+	const t = ctx.locale.bind("wslWorkspace");
+	let wslWindowsPaths = /* @__PURE__ */ new Set();
+	const injected = () => ({
+		t,
+		checkPreset: async () => {
+			let roster;
+			try {
+				roster = await listAgentPresets();
+			} catch (error) {
+				return error instanceof Error ? error.message : String(error);
+			}
+			if (!roster.ok) return roster.error;
+			const healthy = roster.presets.find((entry) => entry.id.startsWith("wsl-") && entry.broken === void 0);
+			if (healthy === void 0) return t("error.presetMissing");
+			return void 0;
+		},
+		listDistros: () => listDistros(),
+		listDir: (distro, path) => listDir(distro, path),
+		check: (distro, path) => check(distro, path),
+		createWorkspace: async (linuxPath, username, distro) => {
+			try {
+				const startSession = resolveSessionStarter();
+				const winPath = mntToWindowsPath(linuxPath);
+				if (winPath !== null) {
+					const view$1 = await workspaces.create({ path: winPath });
+					await registerWindows(linuxPath, distro, username);
+					const canonical = canonicalWindowsPath(winPath);
+					if (canonical !== null) wslWindowsPaths = new Set(wslWindowsPaths).add(canonical);
+					await startSession(view$1.workspaceId);
+					return void 0;
 				}
-			});
-			ctx.effect(() => ctx.slots.inject("sidebar.footer.action", () => ctx.slots.register({
-				name: "sidebar.footer.action",
-				id: "wsl-workspace",
-				inject: injected
-			}, AddWslWorkspace)), "dsh-wsl-workspace: sidebar footer action");
-			ctx.effect(() => {
-				const inFlight = /* @__PURE__ */ new Set();
-				const attempts = /* @__PURE__ */ new Map();
-				const MAX_ATTEMPTS = 3;
-				let variants = /* @__PURE__ */ new Set();
-				let defaultPreset;
-				const refreshRoster = () => {
-					api.agentPresets.list({}).then((response) => {
-						const result = response.result;
-						if (!result.ok) return;
-						variants = new Set(result.value.presets.filter((entry) => entry.broken === void 0 && entry.id.startsWith("wsl-")).map((entry) => entry.id));
-						defaultPreset = result.value.presets.find((entry) => entry.isDefault === true)?.id;
-					}).catch(() => {});
-				};
-				refreshRoster();
-				const refreshWorkspaces = () => {
-					listWorkspaces().then((keys) => {
-						const next = /* @__PURE__ */ new Set();
-						for (const key of keys) {
-							const canonical = canonicalWindowsPath(key);
-							if (canonical !== null) next.add(canonical);
-						}
-						wslWindowsPaths = next;
-					}).catch(() => {});
-				};
-				refreshWorkspaces();
-				const maybeBind = () => {
-					const state = sessions.list.getSnapshot();
-					for (const id of state.ids) {
-						const summary = state.byId[id];
-						if (summary === void 0 || !summary.blank || summary.cwd === void 0) continue;
-						const canonical = canonicalWindowsPath(summary.cwd);
-						if (!(isWslUnc(summary.cwd) || canonical !== null && wslWindowsPaths.has(canonical))) continue;
-						const current = summary.agentPreset;
-						if (current !== void 0 && current.startsWith("wsl-")) continue;
-						const base = current === LEGACY_WSL_PRESET_ID ? defaultPreset ?? "standard" : current ?? defaultPreset;
-						if (base === void 0 || base === LEGACY_WSL_PRESET_ID || base.startsWith("wsl-")) continue;
-						const target = `wsl-${base.toLowerCase()}`;
-						if (!variants.has(target)) continue;
-						if (inFlight.has(id) || (attempts.get(id) ?? 0) >= MAX_ATTEMPTS) continue;
-						inFlight.add(id);
-						api.agentPresets.select({
-							sessionId: id,
-							agentPreset: target
-						}).then((response) => {
-							if (response.result.ok) sessions.noteAgentPreset(id, target);
-						}).catch(() => {
-							attempts.set(id, (attempts.get(id) ?? 0) + 1);
-						}).finally(() => {
-							inFlight.delete(id);
-						});
-					}
-				};
-				maybeBind();
-				const unsubscribe = sessions.list.subscribe(() => maybeBind());
-				const timer = window.setInterval(refreshRoster, 6e4);
-				return () => {
-					unsubscribe();
-					window.clearInterval(timer);
-				};
-			}, "dsh-wsl-workspace: WSL mode-variant binding");
+				const uncPath = joinUnc(distro, linuxPath);
+				const view = await workspaces.create({ path: uncPath });
+				await setWorkspaceUser(uncPath, username);
+				await startSession(view.workspaceId);
+				return void 0;
+			} catch (error) {
+				return error instanceof Error ? error.message : String(error);
+			}
 		}
-		//#endregion
-		exports.apply = apply;
-		exports.inject = inject;
-		return module.exports;
-	}
-});
+	});
+	ctx.effect(() => ctx.slots.inject("sidebar.footer.action", () => ctx.slots.register({
+		name: "sidebar.footer.action",
+		id: "wsl-workspace",
+		inject: injected
+	}, AddWslWorkspace)), "dsh-wsl-workspace: sidebar footer action");
+	ctx.effect(() => {
+		const inFlight = /* @__PURE__ */ new Set();
+		const attempts = /* @__PURE__ */ new Map();
+		const MAX_ATTEMPTS = 3;
+		let variants = /* @__PURE__ */ new Set();
+		let defaultPreset;
+		const refreshRoster = () => {
+			listAgentPresets().then((result) => {
+				if (!result.ok) return;
+				variants = new Set(result.presets.filter((entry) => entry.broken === void 0 && entry.id.startsWith("wsl-")).map((entry) => entry.id));
+				defaultPreset = result.presets.find((entry) => entry.isDefault === true)?.id;
+				maybeBind();
+			}).catch(() => {});
+		};
+		refreshRoster();
+		const refreshWorkspaces = () => {
+			listWorkspaces().then((keys) => {
+				const next = /* @__PURE__ */ new Set();
+				for (const key of keys) {
+					const canonical = canonicalWindowsPath(key);
+					if (canonical !== null) next.add(canonical);
+				}
+				wslWindowsPaths = next;
+				maybeBind();
+			}).catch(() => {});
+		};
+		refreshWorkspaces();
+		const maybeBind = () => {
+			const state = sessions.list.getSnapshot();
+			for (const id of state.ids) {
+				const summary = state.byId[id];
+				if (summary === void 0 || !summary.blank || summary.cwd === void 0) continue;
+				const canonical = canonicalWindowsPath(summary.cwd);
+				const isWsl = isWslUnc(summary.cwd) || canonical !== null && wslWindowsPaths.has(canonical);
+				if (!isWsl) continue;
+				const current = getAgentPreset(summary);
+				if (current !== void 0 && current.startsWith("wsl-")) continue;
+				const base = current === LEGACY_WSL_PRESET_ID ? defaultPreset ?? "standard" : current ?? defaultPreset;
+				if (base === void 0 || base === LEGACY_WSL_PRESET_ID || base.startsWith("wsl-")) continue;
+				const target = `wsl-${base.toLowerCase()}`;
+				if (!variants.has(target)) continue;
+				if (inFlight.has(id) || (attempts.get(id) ?? 0) >= MAX_ATTEMPTS) continue;
+				inFlight.add(id);
+				selectAgentPreset(id, target).then((result) => {
+					if (result.ok) noteAgentPresetCompat(id, target);
+				}).catch(() => {
+					attempts.set(id, (attempts.get(id) ?? 0) + 1);
+				}).finally(() => {
+					inFlight.delete(id);
+				});
+			}
+		};
+		maybeBind();
+		const unsubscribe = sessions.list.subscribe(() => maybeBind());
+		const timer = window.setInterval(refreshRoster, 6e4);
+		return () => {
+			unsubscribe();
+			window.clearInterval(timer);
+		};
+	}, "dsh-wsl-workspace: WSL mode-variant binding");
+}
 
+//#endregion
+exports.apply = apply;
+exports.inject = inject;
+return module.exports; } });
 //# sourceMappingURL=client.js.map