dsh-plugin-core 0.20.4 → 0.20.7

package/dist/explorer/fs-face.js

@@ -0,0 +1,74 @@
+/**
+ * client 侧的**只读文件面**：fetch 宿主 `serveFsRoute` 挂的那条路由（`src/host/fs-route.ts`）。
+ *
+ * 返回体沿用官方 remote 的信封（成功是值本身，失败是 `{ ok:false, error }`），所以
+ * `listingOf` / `textPageOf` / `bytesOf`（`./types.js`）原样能解析，不用再写一套。
+ *
+ * 与 `WorkspaceFilesFace` 的差别只有一个：**不吃 sessionId，路径一律绝对**。
+ * 这也是「入口不传会话」成立的原因 —— 浏览完全不需要会话；只有 Office 预览还要。
+ */
+/** 路由没就位 / 网络失败时的统一回执。 */
+function failure(message) {
+    return { ok: false, error: { code: 'service-unavailable', message } };
+}
+async function call(basePath, params, signal) {
+    const query = new URLSearchParams();
+    for (const [key, value] of Object.entries(params)) {
+        if (value !== undefined)
+            query.set(key, String(value));
+    }
+    let reply;
+    try {
+        const response = await fetch(`${basePath}?${query.toString()}`, { signal });
+        reply = (await response.json());
+    }
+    catch (error) {
+        if (signal?.aborted === true)
+            return failure('aborted');
+        return failure(error instanceof Error ? error.message : 'fs route unreachable');
+    }
+    if (reply === null || typeof reply !== 'object')
+        return failure('fs route returned a non-object');
+    if (reply.ok === false)
+        return reply;
+    return reply.value ?? reply;
+}
+/** 造一个走 HTTP 的文件面。`basePath` 必须与宿主 `serveFsRoute({ path })` 同一个常量。 */
+export function createHttpFsFace(basePath) {
+    return {
+        list: (path, signal) => call(basePath, { op: 'list', path }, signal),
+        read: (path, range, signal) => call(basePath, { op: 'read', path, offset: range.offset, limit: range.limit }, signal),
+        readBytes: async (path, options, signal) => {
+            const value = await call(basePath, {
+                op: 'readBytes',
+                path,
+                offset: options.range?.offset,
+                limit: options.range?.length,
+            }, signal);
+            const data = value?.data;
+            if (typeof data !== 'string')
+                return value;
+            const raw = atob(data);
+            const bytes = new Uint8Array(raw.length);
+            for (let index = 0; index < raw.length; index++)
+                bytes[index] = raw.charCodeAt(index);
+            return { ...value, data: bytes };
+        },
+        roots: async () => {
+            const value = (await call(basePath, { op: 'roots' }));
+            const list = value?.roots;
+            return Array.isArray(list) && list.every((item) => typeof item === 'string') ? list : ['/'];
+        },
+    };
+}
+// ── 单例接线（同 ui/host-data 的做法：绑一次，调用方不必每次传） ──
+let current;
+/** 接上宿主 `serveFsRoute` 挂的那条路由（插件 client `apply` 里调一次）。 */
+export function connectFs(options) {
+    current = createHttpFsFace(options.path);
+}
+/** 当前已接上的文件面；没接（宿主没这能力 / 没调 connectFs）⇒ undefined。 */
+export function getFsFace() {
+    return current;
+}
+//# sourceMappingURL=fs-face.js.map

package/dist/explorer/fs-face.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-face.js","sourceRoot":"","sources":["../../src/explorer/fs-face.ts"],"names":[],"mappings":"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"}

package/dist/explorer/index.d.ts

@@ -1,5 +1,6 @@
 export { FileBrowser, type FileBrowserProps } from './FileBrowser.js';
 export { openFilePreview, pickWorkspaceFile, type FilePreviewHandle, type OpenFilePreviewOptions, type PickedFile, type PickWorkspaceFileOptions, } from './open.js';
 export { FilePreview, type FilePreviewProps } from './preview/index.js';
-export { absolutizeDir, bareCode, createRootCache, errView, findAnyFileAbs, isFailed, joinPath, learnRoot, listPathOf, listingOf, matchesFilter, pickWorkspaceAnchor, previewInfoOf, previewKindOf, relativizeToRoot, sortEntries, workspaceAnchorForPath, anchorSessionForTitle, type DirEntry, type ErrView, type Listing, type OfficeToPdfFace, type PickFilter, type PreviewInfo, type PreviewKind, type RootCache, type WorkspaceAnchor, type WorkspaceAnchorItem, type WorkspaceFilesFace, } from './types.js';
+export { connectFs, createHttpFsFace, getFsFace, type FsFace } from './fs-face.js';
+export { bareCode, errView, isFailed, joinPath, listPathOf, listingOf, matchesFilter, pickWorkspaceAnchor, previewInfoOf, previewKindOf, sortEntries, workspaceAnchorForPath, anchorSessionForTitle, type DirEntry, type ErrView, type Listing, type OfficeToPdfFace, type PickFilter, type PickedPath, type PreviewInfo, type PreviewKind, type WorkspaceAnchor, type WorkspaceAnchorItem, type WorkspaceFilesFace, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/explorer/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/explorer/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACrE,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,UAAU,EACf,KAAK,wBAAwB,GAC9B,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACvE,OAAO,EACL,aAAa,EACb,QAAQ,EACR,eAAe,EACf,OAAO,EACP,cAAc,EACd,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,UAAU,EACV,SAAS,EACT,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,sBAAsB,EACtB,qBAAqB,EACrB,KAAK,QAAQ,EACb,KAAK,OAAO,EACZ,KAAK,OAAO,EACZ,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,GACxB,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/explorer/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACrE,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,UAAU,EACf,KAAK,wBAAwB,GAC9B,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACvE,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,SAAS,EAAE,KAAK,MAAM,EAAE,MAAM,cAAc,CAAA;AAClF,OAAO,EACL,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,SAAS,EACT,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,WAAW,EACX,sBAAsB,EACtB,qBAAqB,EACrB,KAAK,QAAQ,EACb,KAAK,OAAO,EACZ,KAAK,OAAO,EACZ,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,GACxB,MAAM,YAAY,CAAA"}

package/dist/explorer/index.js

@@ -1,5 +1,6 @@
 export { FileBrowser } from './FileBrowser.js';
 export { openFilePreview, pickWorkspaceFile, } from './open.js';
 export { FilePreview } from './preview/index.js';
-export { absolutizeDir, bareCode, createRootCache, errView, findAnyFileAbs, isFailed, joinPath, learnRoot, listPathOf, listingOf, matchesFilter, pickWorkspaceAnchor, previewInfoOf, previewKindOf, relativizeToRoot, sortEntries, workspaceAnchorForPath, anchorSessionForTitle, } from './types.js';
+export { connectFs, createHttpFsFace, getFsFace } from './fs-face.js';
+export { bareCode, errView, isFailed, joinPath, listPathOf, listingOf, matchesFilter, pickWorkspaceAnchor, previewInfoOf, previewKindOf, sortEntries, workspaceAnchorForPath, anchorSessionForTitle, } from './types.js';
 //# sourceMappingURL=index.js.map

package/dist/explorer/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/explorer/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAyB,MAAM,kBAAkB,CAAA;AACrE,OAAO,EACL,eAAe,EACf,iBAAiB,GAKlB,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,WAAW,EAAyB,MAAM,oBAAoB,CAAA;AACvE,OAAO,EACL,aAAa,EACb,QAAQ,EACR,eAAe,EACf,OAAO,EACP,cAAc,EACd,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,UAAU,EACV,SAAS,EACT,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,sBAAsB,EACtB,qBAAqB,GAYtB,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/explorer/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAyB,MAAM,kBAAkB,CAAA;AACrE,OAAO,EACL,eAAe,EACf,iBAAiB,GAKlB,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,WAAW,EAAyB,MAAM,oBAAoB,CAAA;AACvE,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,SAAS,EAAe,MAAM,cAAc,CAAA;AAClF,OAAO,EACL,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,SAAS,EACT,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,WAAW,EACX,sBAAsB,EACtB,qBAAqB,GAYtB,MAAM,YAAY,CAAA"}

package/dist/explorer/landing.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 落地页主体（picker 刚打开、还没进任何目录时的那张表）：上面一排根层（「根目录」或盘符），
+ * 下面全部工作区。行 = 进去，行尾钮 = 直接选这个目录。
+ *
+ * 2026-11-03 从 `FileBrowser.ts` 拆出：这里只有「怎么画」，状态与取数全在调用方。
+ */
+import { type ReactNode } from 'react';
+import type { Translate } from '../utils/i18n.js';
+import type { WorkspaceAnchorItem } from './types.js';
+export interface LandingBodyProps {
+    translate: Translate;
+    /** 根层条目：POSIX 单条「根目录」，Windows 一排盘符。 */
+    roots: ReadonlyArray<{
+        label: string;
+        path: string;
+    }>;
+    anchors: readonly WorkspaceAnchorItem[];
+    /** 选择器形态：行尾出「选择」钮（浏览器形态不出）。 */
+    pickable: boolean;
+    /** 进入该目录（点行 / 回车）。 */
+    onOpen: (target: string) => void;
+    /** 直接选中该目录（行尾钮）。 */
+    onPickDir: (target: string) => void;
+}
+export declare function LandingBody(props: LandingBodyProps): ReactNode;
+//# sourceMappingURL=landing.d.ts.map

package/dist/explorer/landing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"landing.d.ts","sourceRoot":"","sources":["../../src/explorer/landing.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAI1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAEjD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAErD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,SAAS,CAAA;IACpB,uCAAuC;IACvC,KAAK,EAAE,aAAa,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACrD,OAAO,EAAE,SAAS,mBAAmB,EAAE,CAAA;IACvC,+BAA+B;IAC/B,QAAQ,EAAE,OAAO,CAAA;IACjB,sBAAsB;IACtB,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IAChC,oBAAoB;IACpB,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;CACpC;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,SAAS,CA8C9D"}

package/dist/explorer/landing.js

@@ -0,0 +1,43 @@
+/**
+ * 落地页主体（picker 刚打开、还没进任何目录时的那张表）：上面一排根层（「根目录」或盘符），
+ * 下面全部工作区。行 = 进去，行尾钮 = 直接选这个目录。
+ *
+ * 2026-11-03 从 `FileBrowser.ts` 拆出：这里只有「怎么画」，状态与取数全在调用方。
+ */
+import { createElement as h } from 'react';
+import { Button } from '../ui/Button.js';
+import { IconFolderCloseRegular } from '../ui/official.js';
+import { ensureComponentStyles } from '../ui/css.js';
+import { EXPLORER_CSS } from './explorer-css.js';
+export function LandingBody(props) {
+    ensureComponentStyles('explorer', EXPLORER_CSS);
+    const { translate: tt, roots, anchors, pickable, onOpen, onPickDir } = props;
+    const row = (key, label, target) => h('div', {
+        key,
+        className: 'dshpc-fb__row',
+        role: 'button',
+        tabIndex: 0,
+        onClick: () => onOpen(target),
+        onKeyDown: (event) => {
+            if (event.key === 'Enter' || event.key === ' ')
+                onOpen(target);
+        },
+    }, h('span', { className: 'dshpc-fb__row-icon' }, h(IconFolderCloseRegular, { size: 18 })), h('span', { className: 'dshpc-fb__row-name' }, label), 
+    // 行 = 展开进去；行尾钮 = 直接选这个目录（根目录 / 盘符 / 工作区根本身都能选）。
+    pickable
+        ? h(Button, {
+            variant: 'outline',
+            size: 'sm',
+            className: 'dshpc-fb__row-act',
+            'aria-label': tt('explorerPickDirAria'),
+            onClick: (event) => {
+                event.stopPropagation();
+                onPickDir(target);
+            },
+        }, tt('explorerPickDir'))
+        : null);
+    return h('div', { className: 'dshpc-fb__tree' }, roots.map((root) => row(`root:${root.path}`, root.label, root.path)), anchors
+        .filter((item) => item.path !== undefined && item.path !== '')
+        .map((item) => row(`ws:${item.title}`, item.title, item.path)));
+}
+//# sourceMappingURL=landing.js.map

package/dist/explorer/landing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"landing.js","sourceRoot":"","sources":["../../src/explorer/landing.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,aAAa,IAAI,CAAC,EAAkB,MAAM,OAAO,CAAA;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AACxC,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAA;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AAEpD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAgBhD,MAAM,UAAU,WAAW,CAAC,KAAuB;IACjD,qBAAqB,CAAC,UAAU,EAAE,YAAY,CAAC,CAAA;IAC/C,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,KAAK,CAAA;IAE5E,MAAM,GAAG,GAAG,CAAC,GAAW,EAAE,KAAa,EAAE,MAAc,EAAa,EAAE,CACpE,CAAC,CACC,KAAK,EACL;QACE,GAAG;QACH,SAAS,EAAE,eAAe;QAC1B,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC;QACX,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC;QAC7B,SAAS,EAAE,CAAC,KAAsB,EAAE,EAAE;YACpC,IAAI,KAAK,CAAC,GAAG,KAAK,OAAO,IAAI,KAAK,CAAC,GAAG,KAAK,GAAG;gBAAE,MAAM,CAAC,MAAM,CAAC,CAAA;QAChE,CAAC;KACF,EACD,CAAC,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,oBAAoB,EAAE,EAAE,CAAC,CAAC,sBAAsB,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,EACvF,CAAC,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,oBAAoB,EAAE,EAAE,KAAK,CAAC;IACrD,gDAAgD;IAChD,QAAQ;QACN,CAAC,CAAC,CAAC,CACC,MAAM,EACN;YACE,OAAO,EAAE,SAAS;YAClB,IAAI,EAAE,IAAI;YACV,SAAS,EAAE,mBAAmB;YAC9B,YAAY,EAAE,EAAE,CAAC,qBAAqB,CAAC;YACvC,OAAO,EAAE,CAAC,KAAsC,EAAE,EAAE;gBAClD,KAAK,CAAC,eAAe,EAAE,CAAA;gBACvB,SAAS,CAAC,MAAM,CAAC,CAAA;YACnB,CAAC;SACF,EACD,EAAE,CAAC,iBAAiB,CAAC,CACtB;QACH,CAAC,CAAC,IAAI,CACT,CAAA;IAEH,OAAO,CAAC,CACN,KAAK,EACL,EAAE,SAAS,EAAE,gBAAgB,EAAE,EAC/B,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,IAAI,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,EACpE,OAAO;SACJ,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC;SAC7D,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,IAAc,CAAC,CAAC,CAC3E,CAAA;AACH,CAAC"}

package/dist/explorer/open.d.ts

@@ -1,6 +1,14 @@
 import { type ReactNode } from 'react';
 import { type Translate } from '../utils/i18n.js';
-import type { OfficeToPdfFace, PickFilter, RootCache, WorkspaceAnchorItem, WorkspaceFilesFace } from './types.js';
+import type { OfficeToPdfFace, PickedPath, PickFilter, WorkspaceAnchorItem } from './types.js';
+type Anchors = readonly WorkspaceAnchorItem[];
+/**
+ * 入参路径解析成**绝对路径**（`''` = 虚拟根）。用户 2026-11-03 定：绝对/相对都收。
+ *
+ * 相对路径必须有一个基准：显式 `sessionId` 所属工作区优先，其次「最近有会话的工作区」。
+ * 解析不出 ⇒ `null`（调用方提示 `explorerNoBase`，不猜）。
+ */
+export declare function resolveStartPath(path: string, anchors: Anchors, sessionId?: string): string | null;
 export interface FilePreviewHandle {
     /** 关闭预览（幂等）。 */
     close(): void;
@@ -8,15 +16,7 @@ export interface FilePreviewHandle {
     readonly path: string;
 }
 export interface OpenFilePreviewOptions {
-    /**
-     * 工作区文件服务。**一般不用传**：`connectHost(ctx)` 接线后核心自己持有
-     * （`getWorkspaceFiles()`）。传了就以传入的为准（多服务 / 覆盖场景）。
-     * 传了 `content` 时（自定义审阅内容，例如变更 diff），这一组文件定位参数都可省略。
-     */
-    workspaceFiles?: WorkspaceFilesFace;
-    /** 该工作区的真实会话 id。**一般不用传**：按路径匹配工作区 / 最近有会话的工作区自动解析。 */
-    sessionId?: string;
-    /** 文件或文件夹路径。与 `content` 二选一：传 `content` 时本字段可省略。 */
+    /** 文件或文件夹路径：绝对 / 工作区相对都收；`''` = 从根节点（工作区清单 + 盘符）开。 */
     path?: string;
     /**
      * 自定义审阅内容：传入则核心渲染它进右侧 dock，**替代**内置 FileBrowser（解耦用途——
@@ -24,18 +24,20 @@ export interface OpenFilePreviewOptions {
      */
     content?: () => ReactNode;
     officeToPdf?: OfficeToPdfFace | null;
-    /** 工作区根显示名（面包屑首段）。 */
+    /** 相对路径的基准工作区（也是 Office 预览用的会话）。可省。 */
+    sessionId?: string;
+    /** 工作区根显示名（面包屑第一段的兜底）。 */
     rootName?: string;
-    /** ▾ 下拉顶部的工作区清单（当前工作区展开 + 其余罗列；不传 = 下拉只有路径层）。 */
+    /** 相对路径 / 面包屑的基准目录；不传 = 按路径匹配出的工作区根。 */
+    rootPath?: string;
+    /** ▾ 下拉顶部的工作区清单（显示名）；不传 = 宿主快照里的全部。 */
     workspaces?: readonly string[];
     /**
-     * 宿主工作区清单（带绝对 path）：**可选覆盖**。path 为绝对路径时核心按最长前缀匹配所属
-     * 工作区、list 换该工作区的会话 id；▾ 下拉「切工作区」也由它驱动。
-     * **不传 = 自动用宿主 workspaces 快照**（connectHost 注入的 workspaceList）——
-     * 调用方零传参也能匹配、能切。仅在「覆盖快照 / 宿主未接线」时才需要显式传。
+     * 宿主工作区清单（带绝对 path）：**可选覆盖**。不传 = 自动用宿主 workspaces 快照
+     * （connectHost 注入的 workspaceList）——调用方零传参也能匹配、能切。
      */
     workspaceAnchors?: readonly WorkspaceAnchorItem[];
-    /** 从 ▾ 下拉选择其他工作区（点当前工作区 = 回其根目录，不走这里）。 */
+    /** 从 ▾ 下拉选择其他工作区（核心默认自己开，一般不用接）。 */
     onSelectWorkspace?: (name: string) => void;
     /** 关闭后回调（✕ / Esc / handle.close 都触发）。 */
     onClose?: () => void;
@@ -49,8 +51,6 @@ export interface OpenFilePreviewOptions {
     mainMinWidth?: number;
     /** 面板无障碍名（没有头部，只用于 aria-label）。 */
     title?: string;
-    /** 工作区根缓存（与调用方共享时传）。 */
-    rootCache?: RootCache;
     translate?: Translate;
     /**
      * **必填**：挂进哪个布局容器（`PanelDock` 是布局成员 —— 占宽度、把左边挤窄）。
@@ -65,46 +65,43 @@ export interface OpenFilePreviewOptions {
  * 打开工作区文件/文件夹的**停靠**预览（分栏：挤窄 `mount` 左边的兄弟，不是盖上去）。
  * 重复打开会关掉上一个（同侧边栏位）。
  *
- * 消费方最少写法（`connectHost(ctx)` 已接线）：
- * `openFilePreview({ mount, path })` —— 文件服务、会话 id 都由核心自己解。
+ * 消费方最少写法（`connectHost(ctx)` + `connectFs({ path })` 已接线）：
+ * `openFilePreview({ mount, path })` —— 路径解析、工作区匹配都由核心自己解。
  */
 export declare function openFilePreview(options: OpenFilePreviewOptions): FilePreviewHandle | null;
-export interface PickedFile {
-    /** 工作区相对路径。 */
-    path: string;
-    /** true = 选的是整个文件夹。 */
-    isDir: boolean;
-}
+/** 兼容旧名：`PickedPath` 的前身（`path` 现在是绝对路径）。 */
+export type PickedFile = PickedPath;
 export interface PickWorkspaceFileOptions {
-    /** 工作区文件服务。**一般不用传**：`connectHost(ctx)` 接线后核心自己持有。 */
-    workspaceFiles?: WorkspaceFilesFace;
-    /** 该工作区的真实会话 id。**一般不用传**：缺省取「最近有会话的工作区」。 */
-    sessionId?: string;
     /** 锚点元素：弹窗左缘与之对齐、优先落在它**下方**（下方不够才翻到上方）；不传 = 屏幕居中。 */
     anchor?: HTMLElement | null;
     /** 过滤：exts = 只要这些扩展名（小写无点）；dirs = 只要文件夹；不传 = 不限。 */
     filter?: PickFilter;
     officeToPdf?: OfficeToPdfFace | null;
-    /** 工作区根显示名。 */
+    /** 起步位置：绝对 / 相对路径都收；不传 = 根节点（工作区清单 + 盘符）。 */
+    path?: string;
+    /** 相对路径的基准工作区（也是 Office 预览用的会话）。可省。 */
+    sessionId?: string;
+    /** 工作区根显示名（面包屑第一段的兜底）。 */
     rootName?: string;
+    /** 相对路径 / 面包屑的基准目录；不传 = 按路径匹配出的工作区根。 */
+    rootPath?: string;
     /** ▾ 下拉的工作区清单（切换工作区浏览）。 */
     workspaces?: readonly string[];
     onSelectWorkspace?: (name: string) => void;
     /** 取消回调（Esc / 点外部 / ✕）。 */
     onCancel?: () => void;
-    rootCache?: RootCache;
     /**
-     * 文案注入：调用时把自己的 `t` 传进来，面板里所有文字（含「选择」「进入」、空态、错误文案）
-     * 就走你的字典；不传则用核心内置中英字典。**与 openFilePreview 同一个 prop、同一套文案**。
+     * 文案注入：调用时把自己的 `t` 传进来，面板里所有文字（就走你的字典）；不传则用核心内置中英字典。
      */
     translate?: Translate;
 }
 /**
- * 弹出「选择工作区文件」模态弹窗，Promise 返回选中结果；取消（Esc / 点外部 / ✕）resolve `null`。
+ * 弹出「选择文件」模态弹窗，Promise 返回选中结果；取消（Esc / 点外部 / ✕）resolve `null`。
  *
  * **面板内容与 `openFilePreview` 完完全全是同一个 `FileBrowser`**（不是复制一套）：
  * 差别只有 ① 承载（这里挂在锚点旁的弹窗面板里，那边挂在核心 PanelDock 分栏里）、
- * ② `picker` 形态参数（点文件即回传、行尾按钮变「选择」）。文案 / 根名 / 过滤都按调用时传的走。
+ * ② `picker` 形态参数（点文件即回传、行尾按钮变「选择」）。
  */
-export declare function pickWorkspaceFile(options: PickWorkspaceFileOptions): Promise<PickedFile | null>;
+export declare function pickWorkspaceFile(options: PickWorkspaceFileOptions): Promise<PickedPath | null>;
+export {};
 //# sourceMappingURL=open.d.ts.map

package/dist/explorer/open.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"open.d.ts","sourceRoot":"","sources":["../../src/explorer/open.ts"],"names":[],"mappings":"AAWA,OAAO,EAAgE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAIpG,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAGjD,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,SAAS,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAOjH,MAAM,WAAW,iBAAiB;IAChC,gBAAgB;IAChB,KAAK,IAAI,IAAI,CAAA;IACb,uBAAuB;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,cAAc,CAAC,EAAE,kBAAkB,CAAA;IACnC,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,SAAS,CAAA;IACzB,WAAW,CAAC,EAAE,eAAe,GAAG,IAAI,CAAA;IACpC,sBAAsB;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iDAAiD;IACjD,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC9B;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAA;IACjD,0CAA0C;IAC1C,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC1C,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB,uBAAuB;IACvB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,oBAAoB;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,+BAA+B;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,wBAAwB;IACxB,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB;;;;;;OAMG;IACH,KAAK,EAAE,WAAW,CAAA;CACnB;AAwFD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,iBAAiB,GAAG,IAAI,CAgLzF;AAID,MAAM,WAAW,UAAU;IACzB,eAAe;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,uBAAuB;IACvB,KAAK,EAAE,OAAO,CAAA;CACf;AAED,MAAM,WAAW,wBAAwB;IACvC,sDAAsD;IACtD,cAAc,CAAC,EAAE,kBAAkB,CAAA;IACnC,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,sDAAsD;IACtD,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CAAA;IAC3B,oDAAoD;IACpD,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,WAAW,CAAC,EAAE,eAAe,GAAG,IAAI,CAAA;IACpC,eAAe;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,2BAA2B;IAC3B,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC9B,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC1C,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,CAAA;CACtB;AAWD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAwG/F"}
+{"version":3,"file":"open.d.ts","sourceRoot":"","sources":["../../src/explorer/open.ts"],"names":[],"mappings":"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"}