dsh-plugin-core 0.2.14 → 0.3.0

package/dist/explorer/preview/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/explorer/preview/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,IAAI,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,EAAE,CAAC,EAAkB,MAAM,qBAAqB,CAAA;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAC5C,OAAO,EAAE,aAAa,EAA2B,MAAM,aAAa,CAAA;AASpE,qCAAqC;AACrC,MAAM,UAAU,WAAW,CAAC,KAAuB;IACjD,cAAc,EAAE,CAAA;IAChB,MAAM,EAAE,GAAG,KAAK,CAAC,SAAS,IAAI,CAAC,CAAA;IAC/B,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IACtC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAA;IACrD,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAA;IAC7D,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IAE3C,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,KAAK,GAAG,IAAI,CAAA;QAChB,IAAI,GAAG,GAAkB,IAAI,CAAA;QAC7B,OAAO,CAAC,IAAI,CAAC,CAAA;QACb,WAAW,CAAC,IAAI,CAAC,CAAA;QACjB,SAAS,CAAC,KAAK,CAAC,CAAA;QAEhB,MAAM,GAAG,GAAG,KAAK,IAAmB,EAAE;YACpC,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;gBACpB,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;gBAC5E,IAAI,KAAK;oBAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;gBAC5B,OAAM;YACR,CAAC;YACD,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;gBACrB,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,cAAc,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;gBACjF,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,0BAA0B,CAAA;gBAC7D,2DAA2D;gBAC3D,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;gBACjE,GAAG,GAAG,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAA;gBAC/B,IAAI,KAAK;oBAAE,WAAW,CAAC,GAAG,CAAC,CAAA;gBAC3B,OAAM;YACR,CAAC;QACH,CAAC,CAAA;QAED,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE;YACf,IAAI,KAAK;gBAAE,SAAS,CAAC,IAAI,CAAC,CAAA;QAC5B,CAAC,CAAC,CAAA;QAEF,OAAO,GAAG,EAAE;YACV,KAAK,GAAG,KAAK,CAAA;YACb,IAAI,GAAG,KAAK,IAAI;gBAAE,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,CAAA;QAC5C,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC,CAAA;IAE7D,IAAI,IAAI,KAAK,aAAa,EAAE,CAAC;QAC3B,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,qBAAqB,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAA;IAC1E,CAAC;IACD,IAAI,MAAM;QAAE,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAA;IAC/E,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QACrB,OAAO,QAAQ,KAAK,IAAI;YACtB,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,iBAAiB,EAAE,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC;YACnE,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,kBAAkB,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;IACjF,CAAC;IACD,OAAO,IAAI,KAAK,IAAI;QAClB,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,iBAAiB,EAAE,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC;QACnE,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,iBAAiB,EAAE,EAAE,IAAI,CAAC,CAAA;AACtD,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/explorer/preview/index.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,4CAA4C;AAC5C,OAAO,EAAE,aAAa,IAAI,CAAC,EAAE,MAAM,OAAO,CAAA;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,EAAE,CAAC,EAAkB,MAAM,qBAAqB,CAAA;AACvD,OAAO,EAAE,aAAa,EAAiD,MAAM,aAAa,CAAA;AAC1F,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAE9C,OAAO,EAAE,YAAY,EAA0B,MAAM,mBAAmB,CAAA;AACxE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAyB,MAAM,kBAAkB,CAAA;AACtF,OAAO,EAAE,aAAa,EAA2B,MAAM,oBAAoB,CAAA;AAC3E,OAAO,EAAE,WAAW,EAAyB,MAAM,kBAAkB,CAAA;AAarE,MAAM,UAAU,WAAW,CAAC,KAAuB;IACjD,cAAc,EAAE,CAAA;IAChB,MAAM,EAAE,GAAG,KAAK,CAAC,SAAS,IAAI,CAAC,CAAA;IAC/B,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IACtC,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,KAAK,IAAI,CAAA;IAC5C,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,OAAO,CAAC;QACb,KAAK,KAAK;YACR,OAAO,CAAC,CAAC,YAAY,EAAE;gBACrB,cAAc,EAAE,KAAK,CAAC,cAAc;gBACpC,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,0BAA0B;gBAC7C,SAAS,EAAE,EAAE;aACd,CAAC,CAAA;QACJ,KAAK,QAAQ;YACX,OAAO,CAAC,CAAC,aAAa,EAAE;gBACtB,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,IAAI;gBACtC,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,SAAS,EAAE,EAAE;aACd,CAAC,CAAA;QACJ,KAAK,MAAM;YACT,OAAO,CAAC,CAAC,WAAW,EAAE;gBACpB,cAAc,EAAE,KAAK,CAAC,cAAc;gBACpC,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,UAAU;gBACV,SAAS,EAAE,EAAE;aACd,CAAC,CAAA;QACJ,KAAK,IAAI,CAAC;QACV,KAAK,MAAM;YACT,OAAO,CAAC,CAAC,WAAW,EAAE;gBACpB,cAAc,EAAE,KAAK,CAAC,cAAc;gBACpC,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,QAAQ,EAAE,IAAI,CAAC,IAAI,KAAK,IAAI;gBAC5B,UAAU;gBACV,SAAS,EAAE,EAAE;aACd,CAAC,CAAA;IACN,CAAC;IACD,+CAA+C;IAC/C,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/explorer/preview/md-labels.d.ts

@@ -0,0 +1,3 @@
+import type { MarkdownLabels } from '../../ui/official.js';
+export declare function markdownLabels(): MarkdownLabels;
+//# sourceMappingURL=md-labels.d.ts.map

package/dist/explorer/preview/md-labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"md-labels.d.ts","sourceRoot":"","sources":["../../../src/explorer/preview/md-labels.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAG1D,wBAAgB,cAAc,IAAI,cAAc,CAS/C"}

package/dist/explorer/preview/md-labels.js

@@ -0,0 +1,12 @@
+import { t } from '../../utils/i18n.js';
+export function markdownLabels() {
+    return {
+        code: {
+            copyLabel: t('mdCopy'),
+            copiedLabel: t('mdCopied'),
+            toolbarLabels: { codeLabel: t('mdCode'), wrapLabel: t('mdWrap'), unwrapLabel: t('mdUnwrap') },
+        },
+        footnotes: t('mdFootnotes'),
+    };
+}
+//# sourceMappingURL=md-labels.js.map

package/dist/explorer/preview/md-labels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"md-labels.js","sourceRoot":"","sources":["../../../src/explorer/preview/md-labels.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,qBAAqB,CAAA;AAEvC,MAAM,UAAU,cAAc;IAC5B,OAAO;QACL,IAAI,EAAE;YACJ,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC;YACtB,WAAW,EAAE,CAAC,CAAC,UAAU,CAAC;YAC1B,aAAa,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,UAAU,CAAC,EAAE;SAC9F;QACD,SAAS,EAAE,CAAC,CAAC,aAAa,CAAC;KAC5B,CAAA;AACH,CAAC"}

package/dist/explorer/types.d.ts

@@ -1,5 +1,7 @@
+import { extOf, mimeOf } from '../utils/path.js';
+import type { UtilMessageKey } from '../utils/i18n.js';
 export interface WorkspaceFilesFace {
-    /** 文本分页读。⚠️ `range` **必传**（官方按位置参数个数校验，省了会被远端拒）。 */
+    /** 文本分页读。⚠️ `range` **必传**（官方按位置参数个数校验，省了会被远端拒），读全量传 `{}`。 */
     read(sessionId: string, path: string, range: {
         offset?: number;
         limit?: number;
@@ -41,6 +43,14 @@ export interface WorkspaceFilesFace {
         bytes?: number;
     }>;
 }
+/**
+ * 官方 `remote.officeToPdf` 的消费面（本地结构化声明，零 npm 依赖，同 WorkspaceFilesFace 做法）。
+ * 运行时服务由宿主提供（宿主装了 @deepseek-ai/dsh-office-to-pdf 才有）；未装 ⇒ 调用方传 null ⇒
+ * Office 文件呈现「预览不可用」，不发起请求、不崩。
+ */
+export interface OfficeToPdfFace {
+    render(sessionId: string, path: string, priority: 'foreground' | 'background', signal?: AbortSignal): Promise<unknown>;
+}
 export interface DirEntry {
     name: string;
     type: 'file' | 'directory' | 'other';
@@ -51,8 +61,180 @@ export interface Listing {
     entries: DirEntry[];
     truncated: boolean;
 }
-/** 预览类型（决定用哪个预览体）。 */
-export type PreviewKind = 'text' | 'image' | 'unsupported';
-/** 按扩展名猜预览类型；猜不出就 `unsupported`（不硬撑，交给调用方决定兜底）。 */
+export type PreviewKind = 'image' | 'pdf' | 'md' | 'html' | 'office' | 'text';
+export interface PreviewInfo {
+    kind: PreviewKind;
+    ext: string;
+    mime?: string;
+}
+/** HTML 静态预览的扩展名（与官方 htmlBodyDefinition 同款）。 */
+export declare const HTML_KINDS: readonly string[];
+/**
+ * Office 预览扩展名（官方 remote.officeToPdf 转 PDF 后再渲染）。
+ * ⚠️ 官方 OfficeExtension 还含 xls / xlsx，按兄弟项目 2026-10-05 拍板「Excel 向后讨论」不纳入。
+ */
+export declare const OFFICE_KINDS: readonly string[];
+/** 源码态读取上限（256K，UTF-8 边界安全由截断处处理）。 */
+export declare const SOURCE_MAX_BYTES: number;
+/**
+ * 按扩展名分发预览类型。**没有 unsupported 档**：认不出的扩展名一律按 text 走，
+ * 由 read 抛 not-text 落「不是文本文件」空态——官方 read 才是真源，不本地猜二进制清单。
+ */
+export declare function previewInfoOf(path: string): PreviewInfo;
+/** 只要 kind（兼容旧用法）；要 ext/mime 用 previewInfoOf。 */
 export declare function previewKindOf(path: string): PreviewKind;
+type Envelope = {
+    kind: 'ok';
+    payload: unknown;
+} | {
+    kind: 'error';
+    error: unknown;
+};
+export declare function unwrapEnvelope(result: unknown): Envelope;
+/** 失败分支判空（TS 收窄用）。 */
+export declare function isFailed(value: unknown): value is {
+    failed: unknown;
+};
+export type Listed = Listing | {
+    failed: unknown;
+};
+/** `list` 结果防御解析：返回 Listing 或失败/非法信封。 */
+export declare function listingOf(result: unknown): Listed | null;
+export type TextPage = {
+    text: string;
+    offset: number;
+    lines: number;
+    eof: boolean;
+} | {
+    failed: unknown;
+} | null;
+/** `read` 结果防御解析：page.text 必须是字符串，否则错误态（防渲染器内部抛错整页黑屏）。 */
+export declare function textPageOf(result: unknown): TextPage;
+export type BytesRead = Uint8Array | {
+    failed: unknown;
+} | null;
+/** `readBytes` 结果防御解析：data 必须是 Uint8Array，否则错误态。 */
+export declare function bytesOf(result: unknown): BytesRead;
+/** `stat` 结果防御解析：只取 absolutePath（信封剥壳同款；stat 仅认 regular file）。 */
+export declare function absolutePathOf(result: unknown): string | null;
+/** 剥 wire 命名空间前缀（如 `workspace-file/not-found` ⇒ `not-found`）。 */
+export declare function bareCode(raw: unknown): string;
+/** 错误视图：文案键 + 占位参数。 */
+export interface ErrView {
+    key: UtilMessageKey;
+    params?: Record<string, string | number>;
+}
+/** 任意抛错/reject ⇒ 文案键。官方 code 分支 + 未知回落，绝不按消息文本猜。 */
+export declare function errView(error: unknown): ErrView;
+/** 子项排序：目录在前，文件在后，各自按名称（不区分大小写）升序。 */
+export declare function sortEntries(entries: readonly DirEntry[]): DirEntry[];
+/**
+ * 0.2.0-rc.1 起官方 list **拒绝空路径** ⇒ 空串（= 工作区根）一律以 `'.'` 上线
+ * （`'.'` 按 cwd = 工作区根归一解析为根本身；响应里根的 path 仍是 `''`）。
+ */
+export declare function listPathOf(dir: string): string;
+export interface RootCache {
+    get(sessionId: string): string | undefined;
+    set(sessionId: string, root: string): void;
+}
+export declare function createRootCache(): RootCache;
+/** 宿主绝对路径形态（/ 开头或 Windows 盘符）。 */
+export declare function isAbsoluteish(p: string): boolean;
+/** 工作区相对拼接（根下直接 name，不补前导 /）。 */
+export declare function relJoin(dir: string, name: string): string;
+/** 由「相对路径 + 该文件宿主绝对路径」反推工作区根并写入缓存；学不出返回 null。 */
+export declare function learnRoot(cache: RootCache, sessionId: string, relativePath: string, absolutePath: string): string | null;
+/** 把宿主绝对路径剥回工作区相对（根未知或不在根下 ⇒ 原样返回，退化）。 */
+export declare function relativizeToRoot(cache: RootCache, sessionId: string, dir: string): string;
+/**
+ * 在相对目录树里找**任意一个文件**并 stat（广度优先、有界：每层最多 5 个目录、最多 3 层）。
+ * 用于目标目录本身没有文件子项（空目录 / 只有子目录）时反推工作区根。
+ */
+export declare function findAnyFileAbs(workspaceFiles: WorkspaceFilesFace, sessionId: string, startDir: string): Promise<{
+    absolutePath: string;
+    relativePath: string;
+} | null>;
+/**
+ * 把「工作区相对名」的目录解析成宿主绝对路径（面包屑才能从工作区根往下列）。
+ * 优先级：① 根已缓存 ⇒ 根 + '/' + 规范相对路径（覆盖空目录 / 只有子目录）；
+ * ② 目录里有文件子项 ⇒ stat 它反推根；③ 有界 BFS 找任一文件反推根。
+ * 全部失败 ⇒ 退回入参，浏览不受影响。
+ */
+export declare function absolutizeDir(cache: RootCache, workspaceFiles: WorkspaceFilesFace, sessionId: string, dir: string, canonical: string, entries: readonly DirEntry[]): Promise<string>;
+/** 选择器过滤：`exts` = 只要这些扩展名（小写无点）；`dirs` = 只要文件夹；都不传 = 不限。 */
+export interface PickFilter {
+    exts?: readonly string[];
+    dirs?: boolean;
+}
+export declare function matchesFilter(path: string, isDir: boolean, filter: PickFilter | undefined): boolean;
+/** 面包屑段：把目录路径拆成可点层级（绝对路径保留前导 /）。 */
+export declare function crumbsOfDir(dir: string): {
+    label: string;
+    path: string;
+}[];
+/** 文件/目录的显示名（末段）。 */
+export declare function baseNameOfPath(p: string): string;
+/** 父目录（无父 = 空串）。 */
+export declare function dirnameOf(p: string): string;
+/** 路径拼接（处理根与绝对/相对；沿用 utils/path 的 joinPath 语义）。 */
+export { joinPath } from '../utils/path.js';
+/** mimeOf 再导出（预览体要用，避免各自 import utils）。 */
+export { extOf, mimeOf };
+/**
+ * 工作区锚点的候选结构（官方 `workspaces` 服务快照 `WorkspaceView` 的消费子集，
+ * 见 docs/design/external/dsh-host.md §11）。只要够必要的字段，谁都能传。
+ */
+export interface WorkspaceAnchorItem {
+    /** 工作区显示名（面包屑首段 / 传给 FileBrowser 的 rootName）。 */
+    title: string;
+    /**
+     * 工作区绝对路径（宿主 registry / `workspaces` 快照的 `path`，realpath 归一形态）。
+     * **按路径匹配的必需字段**：不传 = 该工作区不参与 `workspaceAnchorForPath` 匹配
+     * （仍可被 `pickWorkspaceAnchor` 按更新时间挑中）。
+     */
+    path?: string;
+    /** 本工作区名下的会话 id（追加序）；没有一个会话的工作区无法浏览。 */
+    sessionIds?: readonly string[];
+    /** 更新时间戳（毫秒/数字口径由宿主给）；用于「最近打开」排序。 */
+    updatedAt?: number;
+}
+export interface WorkspaceAnchor {
+    /** 该工作区的显示名。 */
+    title: string;
+    /** 用来 list / read 的会话 id（该工作区最近一个会话）。 */
+    sessionId: string;
+}
+/**
+ * 从宿主工作区清单里挑一个**真实浏览锚点**：最近更新过、且有会话的工作区。
+ *
+ * `workspaceFiles` 是会话作用域服务（list/read 都要 sessionId），所以「打开文件夹」必须先
+ * 落到一个真会话上 —— 这里是它的唯一落点。
+ *
+ * @param items 宿主工作区清单（真实快照）。
+ * @returns 锚点；清单为空 / 都没有会话则返回 null。
+ */
+export declare function pickWorkspaceAnchor(items: readonly WorkspaceAnchorItem[]): WorkspaceAnchor | null;
+/**
+ * 按**工作区 title** 取浏览锚点会话（`workspaceAnchors` 里该 title 最近一个会话）。
+ *
+ * 与 `workspaceAnchorForPath`（按路径匹配）互补：调用方有 title 归属信息时用这个
+ * （兄弟项目 `GET /options` 的 `Record<title, 会话id>` 同口径，无歧义）；
+ * 只有裸绝对路径时才走路径匹配。没有该 title / 没有会话 ⇒ null。
+ */
+export declare function anchorSessionForTitle(items: readonly WorkspaceAnchorItem[], title: string): string | null;
+/**
+ * 目标**绝对路径**落在哪个工作区 ⇒ 该工作区最近一个会话 id（list 的 sessionId）。
+ *
+ * 为什么需要：`workspaceFiles.list` 是会话作用域服务（按 sessionId 解析工作区根，目录 confinement
+ * 检查 `contains(root, target)`，官方 `lib/index.js:576-583`）。调用方只甩一个绝对路径进来时，
+ * 默认 sessionId 的工作区根未必含它 ⇒ 官方报 `outside-workspace` ⇒ 面板整条退化成只读。
+ * 这里把「路径 → 工作区 → 会话」的解析收敛到核心，调用方只需把宿主工作区清单（带 path）传进来。
+ *
+ * 口径：**最长前缀**赢（嵌套工作区取最具体的）；尾斜杠归一；字面大小写（宿主 path 与调用方
+ * 路径同源，不做大小写折叠——Windows 跨形态比较是调用方归一的责任）。
+ * shortcut: 只解一次（入口 path），不跟踪 dir 切换；跨工作区跳转由调用方经 onSelectWorkspace 处理。
+ *
+ * @returns 锚点；无 path 字段 / 都不匹配 / 命中工作区没有会话 ⇒ null（调用方回落默认 sessionId）。
+ */
+export declare function workspaceAnchorForPath(path: string, items: readonly WorkspaceAnchorItem[]): WorkspaceAnchor | null;
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/explorer/types.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,kBAAkB;IACjC,oDAAoD;IACpD,IAAI,CACF,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAC1C,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC;QACT,MAAM,EAAE,MAAM,CAAA;QACd,IAAI,EAAE,MAAM,CAAA;QACZ,KAAK,EAAE,MAAM,CAAA;QACb,GAAG,EAAE,OAAO,CAAA;QACZ,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;QACzB,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,CAAC,CAAA;IACF,0CAA0C;IAC1C,SAAS,CACP,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;QAAE,KAAK,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,EACzD,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,UAAU,CAAC;QAAC,GAAG,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC9E,wCAAwC;IACxC,IAAI,CACF,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC;QACT,IAAI,EAAE,MAAM,CAAA;QACZ,OAAO,EAAE,aAAa,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,OAAO,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;QAC7F,SAAS,EAAE,OAAO,CAAA;KACnB,CAAC,CAAA;IACF,6CAA6C;IAC7C,IAAI,CAAC,CACH,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAChF;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,OAAO,CAAA;IACpC,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,QAAQ,EAAE,CAAA;IACnB,SAAS,EAAE,OAAO,CAAA;CACnB;AAED,sBAAsB;AACtB,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,aAAa,CAAA;AAE1D,mDAAmD;AACnD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAUvD"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/explorer/types.ts"],"names":[],"mappings":"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"}