dsh-plugin-core 0.31.0 → 0.33.0

package/dist/adv/explorer/FileBrowser.d.ts

@@ -0,0 +1,58 @@
+import { createElement as h, type CSSProperties } from 'react';
+import { type Translate } from '../../utils/i18n.js';
+import { type OfficeToPdfFace, type PickFilter, type PickedPath, type WorkspaceAnchorItem } from './types.js';
+import type { FsFace } from './fs-face.js';
+export interface FileBrowserProps {
+    /** 只读文件面（绝对路径；列目录 / 读文件都走它）。 */
+    files: FsFace;
+    /** 官方 remote.officeToPdf；未就位传 null ⇒ Office 文件出「不可用」空态。 */
+    officeToPdf?: OfficeToPdfFace | null;
+    /** 相对路径的基准目录（工作区根）；不传 ⇒ 只认绝对路径。 */
+    rootPath?: string;
+    /** 只用来判断「默认落哪个工作区」；浏览本身不需要它。 */
+    sessionId?: string;
+    /** 起始路径：目录 ⇒ 直接列；文件 ⇒ 预览态（dir 取父目录，面包屑保留可返回）。 */
+    path: string;
+    /** 起始文件打开后定位到这一行（1 起）；树里另点别的文件不沿用。 */
+    focusLine?: number;
+    /**
+     * 重开令牌（`openFilePreview` 每次调用递增）：**同一 path 再点一次**也要回到该文件 /
+     * 重读内容，所以初始 effect 依赖它；它只触发重跑，**不重挂组件**（目录树、展开态、滚动位置保留）。
+     */
+    revision?: number;
+    /**
+     * 关闭回调：**只给没有自己关闭钮的容器**（picker 弹窗）用，第一排才补一枚 ✕。
+     * PanelDock 场景不传 —— 面板关闭归壳（用户 2026-11-04 定），内容不承担关闭。
+     */
+    onClose?: () => void;
+    /** 工作区根显示名（picker = 调用方选的工作区名）；不传 = 用缓存根的末段。 */
+    rootName?: string;
+    /**
+     * ▾ 下拉顶部的工作区清单（可选覆盖）；不传 = 用宿主快照里的工作区标题
+     * （picker 与 dock 同一份清单，用户 2026-11-03：两处显示必须一致）。
+     */
+    workspaces?: readonly string[];
+    /**
+     * 宿主工作区清单（带绝对 path，`workspaces` 服务快照的消费子集）——**路径 → 会话解析用**：
+     * props.path 是绝对路径时，按最长前缀匹配工作区，list 换用该工作区名下的会话 id
+     * （官方 list 按 sessionId 解析工作区根，默认 sessionId 的根不含该路径就会被官方判越界）。
+     * **可选覆盖**：不传 = 自动用宿主 workspaces 快照（connectHost 注入的 workspaceList）；
+     * 快照也没数据（未接线 / 宿主没给）⇒ 不匹配，一切 list 回落 props.sessionId。
+     */
+    workspaceAnchors?: readonly WorkspaceAnchorItem[];
+    /** 从 ▾ 下拉选择其他工作区（点当前工作区 = 回其根目录）。 */
+    onSelectWorkspace?: (name: string) => void;
+    /** 工作区根缓存（可注入；不传 = 内部自建，随组件废弃——不用模块级 Map）。 */
+    /** 外部容器样式（嵌入浮层时撑满高度用）。 */
+    style?: CSSProperties;
+    translate?: Translate;
+    /** 选择器态：点文件即 onPick（不进预览）；不传 = 浏览态。 */
+    picker?: boolean;
+    /** 选择器选中回调：path 为**工作区相对**路径，isDir = 选的是整个文件夹。 */
+    onPick?: (picked: PickedPath) => void;
+    /** 选择器过滤（exts = 只要这些扩展名；dirs = 只要文件夹；不传 = 不限）。 */
+    filter?: PickFilter;
+}
+/** 目录浏览器面板。详见 {@link FileBrowserProps}。 */
+export declare function FileBrowser(props: FileBrowserProps): ReturnType<typeof h>;
+//# sourceMappingURL=FileBrowser.d.ts.map

package/dist/adv/explorer/FileBrowser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileBrowser.d.ts","sourceRoot":"","sources":["../../../src/adv/explorer/FileBrowser.ts"],"names":[],"mappings":"AAeA,OAAO,EACL,aAAa,IAAI,CAAC,EASlB,KAAK,aAAa,EAEnB,MAAM,OAAO,CAAA;AASd,OAAO,EAAK,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAEvD,OAAO,EAkBL,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,UAAU,EAEf,KAAK,mBAAmB,EACzB,MAAM,YAAY,CAAA;AACnB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAqB1C,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,2DAA2D;IAC3D,WAAW,CAAC,EAAE,eAAe,GAAG,IAAI,CAAA;IACpC,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAA;IACZ,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;OAGG;IACH,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC9B;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAA;IACjD,qCAAqC;IACrC,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC1C,8CAA8C;IAC9C,0BAA0B;IAC1B,KAAK,CAAC,EAAE,aAAa,CAAA;IACrB,SAAS,CAAC,EAAE,SAAS,CAAA;IAGrB,uCAAuC;IACvC,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,kDAAkD;IAClD,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,CAAA;IACrC,kDAAkD;IAClD,MAAM,CAAC,EAAE,UAAU,CAAA;CACpB;AAED,2CAA2C;AAC3C,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAwpBzE"}