@lijian-ui/dsh-file-manager 0.2.3 → 0.2.4

package/lib/index.js

@@ -1,7 +1,7 @@
 import { Service } from "@deepseek-ai/cordis";
 import { mkdir, open, readFile, readdir, realpath, rename, rm, stat, writeFile } from "node:fs/promises";
 import { dirname, join, relative } from "node:path";
-import { createReadStream } from "node:fs";
+import { createReadStream, existsSync, watch } from "node:fs";
 import { pipeline } from "node:stream/promises";
 import { fileURLToPath } from "node:url";
 //#region \0rolldown/runtime.js
@@ -224,7 +224,7 @@ function installSettingsSection(ctx, ns, schema, entry, hooks) {
 	});
 }
 //#endregion
-//#region node_modules/cosmokit/lib/index.cjs
+//#region ../../node_modules/cosmokit/lib/index.cjs
 var require_lib$1 = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	var __defProp = Object.defineProperty;
 	var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -1458,7 +1458,13 @@ function mimeByExtension(rel) {
 		ico: "image/x-icon",
 		avif: "image/avif",
 		bmp: "image/bmp",
-		pdf: "application/pdf"
+		pdf: "application/pdf",
+		doc: "application/msword",
+		docx: "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+		xls: "application/vnd.ms-excel",
+		xlsx: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+		ppt: "application/vnd.ms-powerpoint",
+		pptx: "application/vnd.openxmlformats-officedocument.presentationml.presentation"
 	}[rel.split(".").pop()?.toLowerCase() ?? ""];
 }
 /** Derive the mime type for a raw read from the extension, then the content. */
@@ -2488,11 +2494,11 @@ function isLoopbackRequest(request) {
 }
 //#endregion
 //#region src/host/routes.ts
-const OK = (value) => ({
+const OK$1 = (value) => ({
 	ok: true,
 	value
 });
-const FAIL = (error) => ({
+const FAIL$1 = (error) => ({
 	ok: false,
 	error
 });
@@ -2565,6 +2571,14 @@ const GIT_POLL_MS = 3e4;
 /** SSE keep-alive comment interval (proxies drop idle connections). */
 const HEARTBEAT_MS = 15e3;
 /**
+* Debounce window for coalescing fs.watch events into one `{kind:'fs'}`
+* push. LLM/ad-hoc file writes (e.g. an agent creating work products with a
+* subprocess) often land several events in quick succession; a single trailing
+* push per burst keeps the client's refresh amortized (client also coalesces
+* with its own FS_COALESCE_MS).
+*/
+const FS_WATCH_DEBOUNCE_MS = 200;
+/**
 * Parse a `Range: bytes=start-end` header against the file size. RFC 7233
 * lets a server ignore any Range it does not support, so unknown units,
 * malformed headers and multi-range requests all return null (the caller
@@ -2675,7 +2689,7 @@ function strArray(payload, key) {
 	return value;
 }
 /** Write one JSON envelope response. */
-function json(res, envelope, status = 200) {
+function json$1(res, envelope, status = 200) {
 	res.writeHead(status, { "content-type": "application/json; charset=utf-8" });
 	res.end(JSON.stringify(envelope));
 }
@@ -2743,6 +2757,49 @@ function registerPanelRoutes(ctx, fs, git) {
 		gitPoll.stop();
 		gitPoll = void 0;
 	};
+	let fsWatcher;
+	let fsWatchTimer;
+	const pushFsChange = () => {
+		if (fsWatchTimer !== void 0) return;
+		fsWatchTimer = setTimeout(() => {
+			fsWatchTimer = void 0;
+			for (const subscriber of subscribers) push(subscriber, { kind: "fs" });
+		}, FS_WATCH_DEBOUNCE_MS);
+	};
+	/** Start watching one canonical root; recursive watch falls back to non-recursive when unsupported. */
+	const startFsWatch = () => {
+		if (fsWatcher !== void 0) return;
+		let watcher;
+		try {
+			watcher = watch(subscribersRoot(), { recursive: true });
+		} catch (error) {
+			ctx.logger.warn(`dsh-filemgr: recursive fs.watch unavailable (${String(error)}), falling back to shallow watch`);
+			try {
+				watcher = watch(subscribersRoot());
+			} catch (fallbackError) {
+				ctx.logger.warn(`dsh-filemgr: fs.watch failed, live directory changes will not auto-refresh (${String(fallbackError)})`);
+				return;
+			}
+		}
+		fsWatcher = watcher;
+		const onEvent = () => pushFsChange();
+		watcher.on("change", (_eventType, _filename) => onEvent());
+		watcher.on("error", (error) => {
+			ctx.logger.warn(`dsh-filemgr: fs.watch error (${String(error)}), live refresh degraded`);
+		});
+		ctx.logger.debug(`dsh-filemgr: watching ${subscribersRoot()} for live directory changes`);
+	};
+	const stopFsWatch = () => {
+		if (fsWatchTimer !== void 0) {
+			clearTimeout(fsWatchTimer);
+			fsWatchTimer = void 0;
+		}
+		if (fsWatcher === void 0) return;
+		fsWatcher.close();
+		fsWatcher = void 0;
+	};
+	/** The canonical root of the single connected subscriber; '' when none. */
+	const subscribersRoot = () => subscribers.size > 0 ? [...subscribers][0].root : "";
 	/**
 	* GET /filemgr/raw: stream one workspace file (markdown image srcs,
 	* pdf preview). Gated like every other operation; FsService.readRaw only
@@ -2757,13 +2814,13 @@ function registerPanelRoutes(ctx, fs, git) {
 		const root = url.searchParams.get("root");
 		const path = url.searchParams.get("path");
 		if (root === null || root === "" || path === null || path === "") {
-			json(res, FAIL(BAD_REQUEST), 400);
+			json$1(res, FAIL$1(BAD_REQUEST), 400);
 			return;
 		}
 		const result = await fs.readRaw(root, path);
 		if (!("abs" in result)) {
 			const status = result.code === "path-outside-root" || result.code === "is-directory" ? 403 : 404;
-			json(res, FAIL(result), status);
+			json$1(res, FAIL$1(result), status);
 			return;
 		}
 		const etag = `W/"${result.size}-${Math.floor(result.mtime)}"`;
@@ -2875,172 +2932,172 @@ function registerPanelRoutes(ctx, fs, git) {
 			return;
 		}
 		if (!(req.headers["content-type"] ?? "").toLowerCase().startsWith("application/json")) {
-			json(res, FAIL(BAD_REQUEST), 415);
+			json$1(res, FAIL$1(BAD_REQUEST), 415);
 			return;
 		}
 		const pathname = new URL(req.url ?? "/", "http://x").pathname;
 		const payload = await readJsonBody(req);
 		if (payload === null) {
-			json(res, FAIL(BAD_REQUEST));
+			json$1(res, FAIL$1(BAD_REQUEST));
 			return;
 		}
 		const root = strField(payload, "root");
 		if (root === null) {
-			json(res, FAIL(BAD_REQUEST));
+			json$1(res, FAIL$1(BAD_REQUEST));
 			return;
 		}
 		switch (pathname) {
 			case "/filemgr/list": {
 				const path = strField(payload, "path") ?? "";
 				const result = await fs.list(root, path);
-				json(res, "entries" in result ? OK(result) : FAIL(result));
+				json$1(res, "entries" in result ? OK$1(result) : FAIL$1(result));
 				return;
 			}
 			case "/filemgr/read": {
 				const path = strField(payload, "path");
 				if (path === null) {
-					json(res, FAIL(BAD_REQUEST));
+					json$1(res, FAIL$1(BAD_REQUEST));
 					return;
 				}
 				const asImage = typeof payload === "object" && payload !== null ? payload.asImage === true : false;
 				const result = await fs.read(root, path, asImage);
-				json(res, "content" in result ? OK(result) : FAIL(result));
+				json$1(res, "content" in result ? OK$1(result) : FAIL$1(result));
 				return;
 			}
 			case "/filemgr/write": {
 				const path = strField(payload, "path");
 				const content = strOrEmpty(payload, "content");
 				if (path === null || content === null) {
-					json(res, FAIL(BAD_REQUEST));
+					json$1(res, FAIL$1(BAD_REQUEST));
 					return;
 				}
 				const rawBase = typeof payload === "object" && payload !== null ? payload.baseMtime : void 0;
 				const baseMtime = typeof rawBase === "number" && Number.isFinite(rawBase) ? rawBase : void 0;
 				const result = await fs.write(root, path, content, baseMtime);
-				json(res, "mtime" in result ? OK(result) : FAIL(result));
+				json$1(res, "mtime" in result ? OK$1(result) : FAIL$1(result));
 				return;
 			}
 			case "/filemgr/search": {
 				const query = strField(payload, "query") ?? "";
 				const result = await fs.search(root, query);
-				json(res, "hits" in result ? OK(result) : FAIL(result));
+				json$1(res, "hits" in result ? OK$1(result) : FAIL$1(result));
 				return;
 			}
 			case "/filemgr/delete": {
 				const path = strField(payload, "path");
 				if (path === null) {
-					json(res, FAIL(BAD_REQUEST));
+					json$1(res, FAIL$1(BAD_REQUEST));
 					return;
 				}
 				const result = await fs.delete(root, path);
-				json(res, "ok" in result ? OK(result) : FAIL(result));
+				json$1(res, "ok" in result ? OK$1(result) : FAIL$1(result));
 				return;
 			}
 			case "/filemgr/reveal": {
 				const path = strField(payload, "path");
 				if (path === null) {
-					json(res, FAIL(BAD_REQUEST));
+					json$1(res, FAIL$1(BAD_REQUEST));
 					return;
 				}
 				const resolved = await fs.resolveAbsolute(root, path);
 				if (!("ok" in resolved)) {
-					json(res, FAIL(resolved));
+					json$1(res, FAIL$1(resolved));
 					return;
 				}
 				const error = spawnOsCommand(ctx, revealArgv(process.platform, resolved.abs));
-				json(res, error === null ? OK({ ok: true }) : FAIL(error));
+				json$1(res, error === null ? OK$1({ ok: true }) : FAIL$1(error));
 				return;
 			}
 			case "/filemgr/open-with-default": {
 				const path = strField(payload, "path");
 				if (path === null) {
-					json(res, FAIL(BAD_REQUEST));
+					json$1(res, FAIL$1(BAD_REQUEST));
 					return;
 				}
 				const resolved = await fs.resolveAbsolute(root, path);
 				if (!("ok" in resolved)) {
-					json(res, FAIL(resolved));
+					json$1(res, FAIL$1(resolved));
 					return;
 				}
 				const error = spawnOsCommand(ctx, openArgv(process.platform, resolved.abs));
-				json(res, error === null ? OK({ ok: true }) : FAIL(error));
+				json$1(res, error === null ? OK$1({ ok: true }) : FAIL$1(error));
 				return;
 			}
 			case "/filemgr/rename": {
 				const path = strField(payload, "path");
 				const newName = strField(payload, "newName");
 				if (path === null || newName === null) {
-					json(res, FAIL(BAD_REQUEST));
+					json$1(res, FAIL$1(BAD_REQUEST));
 					return;
 				}
 				const result = await fs.rename(root, path, newName);
-				json(res, "ok" in result ? OK(result) : FAIL(result));
+				json$1(res, "ok" in result ? OK$1(result) : FAIL$1(result));
 				return;
 			}
 			case "/filemgr/mkdir": {
 				const path = strField(payload, "path");
 				if (path === null) {
-					json(res, FAIL(BAD_REQUEST));
+					json$1(res, FAIL$1(BAD_REQUEST));
 					return;
 				}
 				const result = await fs.mkdir(root, path);
-				json(res, "ok" in result ? OK(result) : FAIL(result));
+				json$1(res, "ok" in result ? OK$1(result) : FAIL$1(result));
 				return;
 			}
 			case "/filemgr/new-file": {
 				const path = strField(payload, "path");
 				if (path === null) {
-					json(res, FAIL(BAD_REQUEST));
+					json$1(res, FAIL$1(BAD_REQUEST));
 					return;
 				}
 				const result = await fs.newFile(root, path);
-				json(res, "ok" in result ? OK(result) : FAIL(result));
+				json$1(res, "ok" in result ? OK$1(result) : FAIL$1(result));
 				return;
 			}
 			case "/filemgr/git-status": {
 				const result = await git.status(root);
-				json(res, result === null ? OK(null) : "root" in result ? OK(result) : FAIL(result));
+				json$1(res, result === null ? OK$1(null) : "root" in result ? OK$1(result) : FAIL$1(result));
 				return;
 			}
 			case "/filemgr/git-diff": {
 				const path = strField(payload, "path");
 				if (path === null) {
-					json(res, FAIL(BAD_REQUEST));
+					json$1(res, FAIL$1(BAD_REQUEST));
 					return;
 				}
 				const staged = typeof payload === "object" && payload !== null ? payload.staged === true : false;
 				const result = await git.diff(root, path, staged);
-				json(res, "content" in result ? OK(result) : FAIL(result));
+				json$1(res, "content" in result ? OK$1(result) : FAIL$1(result));
 				return;
 			}
 			case "/filemgr/git-stage": {
 				const paths = strArray(payload, "paths");
 				if (paths === null) {
-					json(res, FAIL(BAD_REQUEST));
+					json$1(res, FAIL$1(BAD_REQUEST));
 					return;
 				}
 				const result = await git.stage(root, paths);
-				json(res, "applied" in result ? OK(result) : FAIL(result));
+				json$1(res, "applied" in result ? OK$1(result) : FAIL$1(result));
 				return;
 			}
 			case "/filemgr/git-unstage": {
 				const paths = strArray(payload, "paths");
 				if (paths === null) {
-					json(res, FAIL(BAD_REQUEST));
+					json$1(res, FAIL$1(BAD_REQUEST));
 					return;
 				}
 				const result = await git.unstage(root, paths);
-				json(res, "applied" in result ? OK(result) : FAIL(result));
+				json$1(res, "applied" in result ? OK$1(result) : FAIL$1(result));
 				return;
 			}
 			case "/filemgr/git-discard": {
 				const paths = strArray(payload, "paths");
 				if (paths === null) {
-					json(res, FAIL(BAD_REQUEST));
+					json$1(res, FAIL$1(BAD_REQUEST));
 					return;
 				}
 				const result = await git.discard(root, paths);
-				json(res, "applied" in result ? OK(result) : FAIL(result));
+				json$1(res, "applied" in result ? OK$1(result) : FAIL$1(result));
 				return;
 			}
 			default:
@@ -3061,7 +3118,7 @@ function registerPanelRoutes(ctx, fs, git) {
 		}
 		const gated = await fs.verify(root);
 		if (!gated.ok) {
-			json(res, FAIL(gated.error), 400);
+			json$1(res, FAIL$1(gated.error), 400);
 			return;
 		}
 		res.writeHead(200, {
@@ -3078,6 +3135,7 @@ function registerPanelRoutes(ctx, fs, git) {
 		subscribers.add(subscriber);
 		if (gitUnavailable) push(subscriber, { kind: "gitUnavailable" });
 		startGitPoll();
+		startFsWatch();
 		if (heartbeatTimer === void 0) heartbeatTimer = setInterval(() => {
 			for (const current of subscribers) current.res.write(": ping\n\n");
 		}, HEARTBEAT_MS);
@@ -3085,6 +3143,7 @@ function registerPanelRoutes(ctx, fs, git) {
 			subscribers.delete(subscriber);
 			if (subscribers.size === 0) {
 				stopGitPoll();
+				stopFsWatch();
 				if (heartbeatTimer !== void 0) clearInterval(heartbeatTimer);
 				heartbeatTimer = void 0;
 			}
@@ -3102,12 +3161,381 @@ function registerPanelRoutes(ctx, fs, git) {
 	return () => {
 		for (const dispose of disposers) dispose();
 		stopGitPoll();
+		stopFsWatch();
 		if (heartbeatTimer !== void 0) clearInterval(heartbeatTimer);
 		for (const subscriber of subscribers) subscriber.res.end();
 		subscribers.clear();
 	};
 }
 //#endregion
+//#region src/host/office-preview.ts
+const OK = (value) => JSON.stringify({
+	ok: true,
+	value
+});
+const FAIL = (error) => JSON.stringify({
+	ok: false,
+	error
+});
+/**
+* Check if officecli is available.
+* In production (packaged) the binary is bundled via electron-builder extraResources
+* and injected into PATH by dsh-process.ts addOfficecliPath().
+* In development we check the vendor/officecli/ directory first, then fall back to PATH.
+* Cached to avoid repeated probing.
+*/
+let officecliAvailable = null;
+let officecliPath = null;
+function resolveBundledOfficecli() {
+	const binName = process.platform === "win32" ? "officecli.exe" : "officecli";
+	const os = process.platform === "win32" ? "win" : process.platform === "darwin" ? "mac" : "linux";
+	const arch = process.arch === "arm64" ? "arm64" : "x64";
+	try {
+		const vendorPath = join(fileURLToPath(new URL(".", import.meta.url)), "..", "..", "..", "vendor", "officecli", `${os}-${arch}`, binName);
+		if (existsSync(vendorPath)) return vendorPath;
+	} catch {}
+	return null;
+}
+async function probeOfficecli(ctx) {
+	if (officecliAvailable !== null) return officecliAvailable;
+	const bundled = resolveBundledOfficecli();
+	if (bundled !== null) {
+		officecliPath = bundled;
+		officecliAvailable = true;
+		ctx.logger.info(`[dsh-filemgr] officecli found at ${bundled}, OfficeCLI preview enabled`);
+		return true;
+	}
+	const subprocess = ctx.get("subprocess");
+	try {
+		officecliAvailable = (await subprocess.spawn({
+			argv: ["officecli", "--version"],
+			cwd: process.cwd(),
+			stdio: {
+				stdin: "ignore",
+				stdout: { maxBytes: 1024 },
+				stderr: { maxBytes: 1024 }
+			},
+			graceMs: 5e3
+		}).done).exitCode === 0;
+		if (officecliAvailable) {
+			officecliPath = "officecli";
+			ctx.logger.info("[dsh-filemgr] officecli found on PATH, OfficeCLI preview enabled");
+		} else ctx.logger.warn("[dsh-filemgr] officecli not available, OfficeCLI preview disabled");
+	} catch {
+		officecliAvailable = false;
+		ctx.logger.warn("[dsh-filemgr] officecli probe failed, OfficeCLI preview disabled");
+	}
+	return officecliAvailable;
+}
+/** Write JSON response. */
+function json(res, status, body) {
+	res.writeHead(status, {
+		"content-type": "application/json; charset=utf-8",
+		"cache-control": "no-cache"
+	});
+	res.end(body);
+}
+/** Write HTML response. */
+function html(res, body) {
+	res.writeHead(200, {
+		"content-type": "text/html; charset=utf-8",
+		"cache-control": "no-cache"
+	});
+	res.end(body);
+}
+/**
+* Inject a bootstrap that turns OfficeCLI's full-document HTML into a single-
+* slide browse view that KEEPS the thumbnail sidebar. OfficeCLI ships a
+* fullscreen engine (`enterFullscreen()` + ←/→/space + thumbnail jumps) but its
+* `.fullscreen` CSS hides the sidebar (pure presentation mode) — so we:
+*   1. auto-enter fullscreen after first paint (single page at a time), and
+*   2. override the fullscreen CSS to restore the sidebar and shrink `.main`
+*      so the thumbnail column stays clickable for page jumps.
+*/
+/**
+* Injected frame/patch add-ons on top of the raw OfficeCLI HTML.
+*
+* OfficeCLI colours its chrome (body, sidebar, borders, counter) with hard-coded
+* dark values and does not follow the dsh light/dark theme. The preview is
+* rendered inside an isolated blob iframe, so the outer document's
+* `body[data-ds-dark-theme]` token is NOT visible here — the host sends the
+* current theme via postMessage and we react by toggling a data attribute that
+* this stylesheet consumes.
+*
+* The slide artwork itself (`.slide`, `.thumb-slide`, `--slide-*`) is authored
+* by the deck and intentionally left untouched.
+*/
+function injectSlideShowMode(htmlContent) {
+	return htmlContent.replace("</body>", `
+<style data-dsh-officecli-fullscreen>
+/* Restore the thumbnail sidebar in single-slide (fullscreen) mode and give the
+   slide stage a wider initial viewport by narrowing the sidebar. */
+body.fullscreen .sidebar { display: flex; width: 140px; min-width: 140px; }
+body.fullscreen .main { width: calc(100vw - 140px); }
+body.fullscreen .slide-container { width: 100%; }
+/* Scale the single slide down so it fits within the stage without being clipped.
+   Using zoom (not transform) because zoom changes both rendering AND layout size,
+   so the parent container adapts naturally. transform:scale() only changes visual
+   size but keeps the original layout footprint, causing overflow clipping. */
+body.fullscreen .slide {
+  zoom: 0.85;
+}
+
+/* Light-theme chrome (host sends theme via postMessage; default stays dark). */
+body[data-dsh-theme="light"] { background: #f7f7f8; }
+body[data-dsh-theme="light"] .sidebar {
+  background: #eef0f3;
+  border-right: 1px solid rgba(0,0,0,0.09);
+}
+body[data-dsh-theme="light"] .sidebar-title,
+body[data-dsh-theme="light"] .thumb-num,
+body[data-dsh-theme="light"] .sidebar-toggle { color: #5f6368; }
+body[data-dsh-theme="light"] .thumb:hover { border-color: #b9bdc6; }
+body[data-dsh-theme="light"] .page-counter { background: rgba(0,0,0,0.55); color: #f1f3f4; }
+</style>
+<script data-dsh-officecli-fullscreen>
+(function () {
+  // --- single-slide browsing mode (F) ---
+  function boot() {
+    // Only decks carry the fullscreen machinery; skip docs/sheets.
+    if (!document.querySelector('.main .slide-container')) return;
+    if (document.body.classList.contains('fullscreen')) return;
+    document.dispatchEvent(new KeyboardEvent('keydown', { key: 'F', code: 'KeyF', bubbles: true }));
+  }
+  function onReady(fn) {
+    if (document.readyState === 'loading') document.addEventListener('DOMContentLoaded', fn, { once: true });
+    else fn();
+  }
+  onReady(boot);
+
+  // --- follow the host light/dark theme via postMessage (blob iframe isolation) ---
+  window.addEventListener('message', function (event) {
+    if (!event.data || event.data.source !== 'dsh-filemgr' || event.data.type !== 'dsh-theme') return;
+    document.body.setAttribute('data-dsh-theme', event.data.dark ? 'dark' : 'light');
+  });
+})();
+<\/script>
+<style data-dsh-officecli-sheet>
+  .dsh-sheet-selected { outline: 1px solid #2e7df6 !important; outline-offset: -1px; background: rgba(46, 125, 246, 0.12) !important; }
+</style>
+<script data-dsh-officecli-sheet-select>
+(function () {
+  // Excel selection -> host reference. OfficeCLI annotates every cell with
+  // data-path="/<sheet>/<A1>" (column headers use col[A], row headers row[1]).
+  // Some renderers set user-select:none, so a native text selection cannot span
+  // cells; instead we track a pointer drag ourselves (cell under pointerdown ->
+  // cell under the pointer), highlight the bounding rectangle, and postMessage
+  // the sheet + A1 range up. The host turns that into a "引用到对话" chip
+  // (相对路径!Sheet!Range). Docs/slides have no .sheet-content, so this block
+  // is inert for Word/PPT.
+  var MAX_HIGHLIGHT_CELLS = 4000;
+  function isSheetDoc() { return !!document.querySelector('.sheet-content'); }
+  function colToNum(letters) {
+    var n = 0;
+    for (var i = 0; i < letters.length; i++) n = n * 26 + (letters.charCodeAt(i) - 64);
+    return n;
+  }
+  function numToCol(n) {
+    var s = '';
+    while (n > 0) { var r = (n - 1) % 26; s = String.fromCharCode(65 + r) + s; n = (n - r - 1) / 26 | 0; }
+    return s;
+  }
+  function parsePath(el) {
+    var p = el && el.getAttribute && el.getAttribute('data-path'); if (!p) return null;
+    var parts = p.split('/'); // ['', sheet, ref]
+    if (parts.length < 3) return null;
+    var m = /^([A-Z]+)([0-9]+)$/.exec(parts[2]); if (!m) return null;
+    return { sheet: parts[1], col: colToNum(m[1]), row: +m[2] };
+  }
+  // Walk from a DOM node up to the nearest data cell (or null).
+  function pickCell(node) {
+    var el = node;
+    while (el && el !== document) {
+      if (el.nodeType === 1 && el.hasAttribute('data-path')) {
+        var p = parsePath(el); if (p) return p;
+      }
+      el = el.parentElement;
+    }
+    return null;
+  }
+  function clearHighlight() {
+    var els = document.querySelectorAll('.dsh-sheet-selected');
+    for (var i = 0; i < els.length; i++) els[i].classList.remove('dsh-sheet-selected');
+  }
+  function applyHighlight(r) {
+    clearHighlight();
+    if (!r) return;
+    if ((r.c2 - r.c1 + 1) * (r.r2 - r.r1 + 1) > MAX_HIGHLIGHT_CELLS) return; // skip huge ranges
+    var els = document.querySelectorAll('td[data-path], th[data-path]');
+    for (var i = 0; i < els.length; i++) {
+      var p = parsePath(els[i]);
+      if (p && p.sheet === r.sheet && p.row >= r.r1 && p.row <= r.r2 && p.col >= r.c1 && p.col <= r.c2) {
+        els[i].classList.add('dsh-sheet-selected');
+      }
+    }
+  }
+  function send(payload) {
+    parent.postMessage(Object.assign({ source: 'dsh-filemgr', type: 'dsh-sheet-select' }, payload), '*');
+  }
+  function update(from, to) {
+    var refs = [from, to].filter(Boolean);
+    if (!refs.length) { send({ sheet: null, range: null, x: 0, y: 0 }); applyHighlight(null); return; }
+    if (refs[0].sheet !== (refs[1] ? refs[1].sheet : refs[0].sheet)) { send({ sheet: null, range: null, x: 0, y: 0 }); applyHighlight(null); return; }
+    var sheet = refs[0].sheet;
+    var c1 = 1e9, c2 = 0, r1 = 1e9, r2 = 0;
+    refs.forEach(function (p) { c1 = Math.min(c1, p.col); c2 = Math.max(c2, p.col); r1 = Math.min(r1, p.row); r2 = Math.max(r2, p.row); });
+    var corner = numToCol(c1) + r1, corner2 = numToCol(c2) + r2;
+    var range = corner === corner2 ? corner : corner + ':' + corner2;
+    var anchorEl = to ? findCellEl(sheet, refs[1].col, refs[1].row) : findCellEl(sheet, from.col, from.row);
+    var rect = anchorEl ? anchorEl.getBoundingClientRect() : null;
+    applyHighlight({ sheet: sheet, c1: c1, c2: c2, r1: r1, r2: r2 });
+    send({ sheet: sheet, range: range, x: rect ? rect.left : 0, y: rect ? rect.bottom + 6 : 0 });
+  }
+  function findCellEl(sheet, col, row) {
+    var els = document.querySelectorAll('td[data-path], th[data-path]');
+    for (var i = 0; i < els.length; i++) {
+      var p = parsePath(els[i]);
+      if (p && p.sheet === sheet && p.col === col && p.row === row) return els[i];
+    }
+    return null;
+  }
+  var origin = null, dragging = false;
+  document.addEventListener('pointerdown', function (e) {
+    if (!isSheetDoc()) return;
+    var p = pickCell(e.target);
+    if (!p) return; // corner / header / outside — leave selection as-is
+    dragging = true; origin = p; update(p, p);
+  }, true);
+  document.addEventListener('pointermove', function (e) {
+    if (!dragging || !origin) return;
+    var cur = pickCell(document.elementFromPoint(e.clientX, e.clientY));
+    if (cur) update(origin, cur);
+  }, true);
+  window.addEventListener('pointerup', function () {
+    if (!dragging) return;
+    dragging = false; origin = null;
+  }, true);
+})();
+<\/script>
+</body>`);
+}
+/** Forbidden (non-loopback request). */
+function writeForbidden(res) {
+	json(res, 403, FAIL({
+		code: "internal",
+		message: "forbidden: loopback-only"
+	}));
+}
+/**
+* Handle one GET /filemgr/office-preview request.
+* Query params: root=workspace/root&path=relative/to/root/file.pptx, probe=1 for mtime check.
+* Uses the same root+path convention as /filemgr/raw.
+*/
+async function handleOfficePreview(ctx, req, res) {
+	if (!isLoopbackRequest(req)) {
+		writeForbidden(res);
+		return;
+	}
+	const url = new URL(req.url ?? "/", "http://x");
+	const root = url.searchParams.get("root");
+	const path = url.searchParams.get("path");
+	if (root === null || root === "" || path === null || path === "") {
+		json(res, 400, FAIL({
+			code: "internal",
+			message: "missing root or path parameter"
+		}));
+		return;
+	}
+	const absPath = join(root, path);
+	if (url.searchParams.get("probe") === "1") {
+		try {
+			const info = await stat(absPath);
+			json(res, 200, OK({ mtime: info.mtimeMs }));
+		} catch {
+			json(res, 404, FAIL({
+				code: "not-found",
+				message: "file not found"
+			}));
+		}
+		return;
+	}
+	if (!await probeOfficecli(ctx) || officecliPath === null) {
+		json(res, 501, FAIL({
+			code: "internal",
+			message: "officecli not installed or not on PATH"
+		}));
+		return;
+	}
+	const subprocess = ctx.get("subprocess");
+	let timeoutMs = 6e4;
+	const controller = new AbortController();
+	const timer = setTimeout(() => controller.abort(), timeoutMs);
+	try {
+		const handle = subprocess.spawn({
+			argv: [
+				officecliPath,
+				"view",
+				absPath,
+				"html"
+			],
+			cwd: process.cwd(),
+			stdio: {
+				stdin: "ignore",
+				stdout: { maxBytes: 10 * 1024 * 1024 },
+				stderr: { maxBytes: 1 << 20 }
+			},
+			graceMs: 5e3,
+			signal: controller.signal
+		});
+		const outcome = await handle.done;
+		clearTimeout(timer);
+		if (controller.signal.aborted) {
+			json(res, 504, FAIL({
+				code: "internal",
+				message: "officecli rendering timed out after 60s"
+			}));
+			return;
+		}
+		const readStdout = () => handle.collected?.stdout?.readFrom(0).text ?? "";
+		const readStderr = () => handle.collected?.stderr?.readFrom(0).text ?? "";
+		if (outcome.exitCode !== 0) {
+			const stderr = readStderr();
+			const stdout = readStdout();
+			const error = `officecli exited with code ${String(outcome.exitCode)}\n${stderr}\n${stdout}`.slice(0, 1e3);
+			json(res, 422, FAIL({
+				code: "read-failed",
+				message: error.trim()
+			}));
+			return;
+		}
+		const htmlContent = readStdout();
+		if (htmlContent === "") {
+			json(res, 422, FAIL({
+				code: "read-failed",
+				message: "officecli returned empty output"
+			}));
+			return;
+		}
+		html(res, injectSlideShowMode(htmlContent));
+	} catch (error) {
+		clearTimeout(timer);
+		const msg = error instanceof Error ? error.message : String(error);
+		json(res, 500, FAIL({
+			code: "internal",
+			message: `officecli invocation failed: ${msg}`
+		}));
+	}
+}
+/** Register the /filemgr/office-preview route on the web server. */
+function registerOfficePreviewRoute(ctx) {
+	probeOfficecli(ctx);
+	return ctx.webServer.register({
+		kind: "prefix",
+		path: "/filemgr/office-preview",
+		handler: (req, res) => handleOfficePreview(ctx, req, res)
+	});
+}
+//#endregion
 //#region src/mount-once.ts
 /**
 * Host single-instance guard shared by the plugin family. The family bundle
@@ -3181,7 +3609,11 @@ function applyImpl(ctx, config = {}) {
 		if (disposePanel === void 0 && enabled) {
 			disposePanel = ctx.effect(() => {
 				const disposeRoutes = registerPanelRoutes(ctx, fs, git);
-				return () => disposeRoutes();
+				const disposeOffice = registerOfficePreviewRoute(ctx);
+				return () => {
+					disposeRoutes();
+					disposeOffice();
+				};
 			}, "dsh-filemgr: /filemgr routes");
 			disposePrompt = ctx.effect(() => ctx.systemPrompt.section({
 				name: "plugin:filemgr",