dsh-life-pack 0.3.2 → 0.3.3

package/dist/directory-browser-api.d.ts

@@ -0,0 +1,23 @@
+/** 目录浏览器的公开门（**六家只 import 这一个名字**）。
+ *
+ * 为什么需要它：`package.json` 的 exports 一条子路径只能指一个文件，而本件分三份写
+ * （契约／状态／视图）。若把 `./directory-browser` 直接指到 `directory-browser-contract.js`，
+ * 六家就取不到「开图接线」（它在 state 那份里）。故设这一个门，把两份纯逻辑都转出；
+ * 视图那一份走 `./directory-browser-ui`（它要吃 React，单独一条）。
+ *
+ * 本件不含实现、也不含判断，只做转出——实现见同目录三份。
+ */
+export { filterEntries, hasPickFn, hiddenCount, isBrowseFace, joinPath, locationLabel, parentOf, pickerModeOf, readPickAnswer, splitDraft, validateFolderName, visibleEntries, } from './directory-browser-contract.js';
+export type { BrowseFailure, DirectoryBrowseFace, DirectoryCrumb, DirectoryEntry, DirectoryListing, PickEnvelope, PickerMode, PickOutcome, } from './directory-browser-contract.js';
+export { canGoUp, createBaseOf, createBrowseController, createDirectoryRowBrowser, describe, entryPath, rowsOf, targetOf, } from './directory-browser-state.js';
+export type { BrowseController, BrowseListener, BrowsePhase, BrowseState, DirectoryRowBrowser, } from './directory-browser-state.js';
+import type { PickerMode } from './directory-browser-contract.js';
+/** 一行目录配置的入口（**六家画按钮就靠这两格**）：
+ *  `mode` 决定按钮写什么（`native`＝「选择文件夹…」／`browse`＝「浏览…」），
+ *  `onOpen` 是点下去的动作（系统对话框或应用内浏览器，由各家自己接线）。
+ *  `mode === 'none'` 时调用方不该画入口——供不了就收起入口，不是失败。 */
+export interface DirectoryRowEntry {
+    readonly mode: PickerMode;
+    readonly onOpen: (key: string) => Promise<void> | undefined;
+}
+//# sourceMappingURL=directory-browser-api.d.ts.map

package/dist/directory-browser-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory-browser-api.d.ts","sourceRoot":"","sources":["../src/directory-browser-api.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,aAAa,EACb,SAAS,EACT,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,aAAa,EACb,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,UAAU,EACV,kBAAkB,EAClB,cAAc,GACf,MAAM,iCAAiC,CAAC;AACzC,YAAY,EACV,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,UAAU,EACV,WAAW,GACZ,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,OAAO,EACP,YAAY,EACZ,sBAAsB,EACtB,yBAAyB,EACzB,QAAQ,EACR,SAAS,EACT,MAAM,EACN,QAAQ,GACT,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACV,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,WAAW,EACX,mBAAmB,GACpB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAElE;;;kDAGkD;AAClD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;CAC7D"}

package/dist/directory-browser-api.js

@@ -0,0 +1,12 @@
+/** 目录浏览器的公开门（**六家只 import 这一个名字**）。
+ *
+ * 为什么需要它：`package.json` 的 exports 一条子路径只能指一个文件，而本件分三份写
+ * （契约／状态／视图）。若把 `./directory-browser` 直接指到 `directory-browser-contract.js`，
+ * 六家就取不到「开图接线」（它在 state 那份里）。故设这一个门，把两份纯逻辑都转出；
+ * 视图那一份走 `./directory-browser-ui`（它要吃 React，单独一条）。
+ *
+ * 本件不含实现、也不含判断，只做转出——实现见同目录三份。
+ */
+export { filterEntries, hasPickFn, hiddenCount, isBrowseFace, joinPath, locationLabel, parentOf, pickerModeOf, readPickAnswer, splitDraft, validateFolderName, visibleEntries, } from './directory-browser-contract.js';
+export { canGoUp, createBaseOf, createBrowseController, createDirectoryRowBrowser, describe, entryPath, rowsOf, targetOf, } from './directory-browser-state.js';
+//# sourceMappingURL=directory-browser-api.js.map

package/dist/directory-browser-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory-browser-api.js","sourceRoot":"","sources":["../src/directory-browser-api.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,aAAa,EACb,SAAS,EACT,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,aAAa,EACb,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,UAAU,EACV,kBAAkB,EAClB,cAAc,GACf,MAAM,iCAAiC,CAAC;AAYzC,OAAO,EACL,OAAO,EACP,YAAY,EACZ,sBAAsB,EACtB,yBAAyB,EACzB,QAAQ,EACR,SAAS,EACT,MAAM,EACN,QAAQ,GACT,MAAM,8BAA8B,CAAC"}

package/dist/directory-browser-contract.d.ts

@@ -0,0 +1,111 @@
+/** 目录浏览器的纯逻辑半（**不认识宿主**：只认两格原语）。
+ *
+ * 为什么在这里：六个单品插件的设置页各有一批「值是一个目录」的行，它们要的界面是同一个东西。
+ * 界面的**取数**来自宿主给的两个原语（`list`／`createDirectory`），而这两个原语的形状是**调用方喂进来的**
+ * ——本件不 import 宿主的任何实现，也不认识 `remote.directoryPicker` 这个名字（那两件住在各家的
+ * `dsh-ctx.ts` 镜像里）。于是本件在 Windows 桌面、远程浏览器、SSH 三种部署下是同一份代码。
+ *
+ * 装什么：本次要浏览的那一层怎么走（进子目录／回上一级／跳面包屑）、路径怎么切出「目录部分」与
+ * 「筛选词」、回执怎么认。**不装**任何 IO、不装任何持久化——`list`／`createDirectory` 由调用方执行。
+ *
+ * 与平台自带浏览器件的关系：`@deepseek-ai/dsh-client-ui-directory-picker-browse` 的 `DirectoryBrowser`
+ * 是包内私有件（只经 `ui-workspace` 的流程空位暴露），插件侧取不到，所以这里是一份独立实现，
+ * 只对齐它的**交互结果**（进/选/新建），不对齐它的 DOM。
+ */
+/** 一层目录里的一个子目录。`hidden` 由宿主判，本件只照传。 */
+export interface DirectoryEntry {
+    readonly name: string;
+    readonly path: string;
+    readonly hidden: boolean;
+}
+/** 面包屑的一格：从文件系统根到当前层，每一格都是一个可跳转目标。 */
+export interface DirectoryCrumb {
+    readonly name: string;
+    readonly path: string;
+    readonly hidden: boolean;
+}
+/** 一次列举的回执（形状照宿主 browse 原语：`path`／`home`／`crumbs`／`entries`／`truncated`）。 */
+export interface DirectoryListing {
+    readonly path: string;
+    readonly home: string;
+    readonly crumbs: readonly DirectoryCrumb[];
+    readonly entries: readonly DirectoryEntry[];
+    readonly truncated: boolean;
+}
+/** 取数面：由调用方注入。本件只调这两个方法，别的什么都不调。 */
+export interface DirectoryBrowseFace {
+    list(path?: string, signal?: AbortSignal): Promise<DirectoryListing>;
+    createDirectory(path: string, name: string): Promise<string>;
+}
+/** 浏览失败的人话（`code` 保留给用例断言，`message` 直接上图）。 */
+export interface BrowseFailure {
+    readonly code: string;
+    readonly message: string;
+}
+/** 目录行入口的三态判定结果：拿到的能力是哪种，决定界面上画什么。 */
+export type PickerMode = 'native' | 'browse' | 'none';
+/** 平台回执的信封（各家的 `DirectoryPickerAnswer` 与此同形；本件只认这三格，不认别家的类名）。 */
+export interface PickEnvelope {
+    readonly ok: boolean;
+    readonly value?: string | null;
+    readonly error?: {
+        readonly code?: string;
+        readonly message?: string;
+    };
+}
+/** 一次「唤起选择器」的归一结果：选中／取消／供不了，永不抛。 */
+export type PickOutcome = {
+    readonly kind: 'picked';
+    readonly path: string;
+} | {
+    readonly kind: 'cancelled';
+} | {
+    readonly kind: 'unavailable';
+    readonly message: string;
+};
+/** 认一认某个值是不是可用的目录取数面（软依赖守卫用：认不出就当没有，绝不把页面带下来）。 */
+export declare function isBrowseFace(raw: unknown): raw is DirectoryBrowseFace;
+/** 认一认某个值有没有 `pick`（对应宿主 composition 里的 `native` 能力）。 */
+export declare function hasPickFn(raw: unknown): boolean;
+/** 三态判定：先 native（有 pick），再 browse（有两格原语），都没有＝`none`。 */
+export declare function pickerModeOf(raw: unknown): PickerMode;
+/** 平台回执 → 三态（**永不抛**）：成功回的是信封里的 `value` 不是路径；`ok:false` 是「供不了」不是「取消」。
+ *
+ * 出处：`@deepseek-ai/dsh-api-gateway/lib/client.js` 的 `invoke()`（失败不抛、成功也不回裸值），
+ * 第一方消费方 `@deepseek-ai/dsh-client-ui-workspace/lib/client.js:99-103` 就照这个信封拆。
+ * 裸串照收（老形状兜底），认不出的形状当「供不了」报出来，不当取消吞掉（#743 的教训）。 */
+export declare function readPickAnswer(raw: unknown): PickOutcome;
+/** 上一层：`'C:\\a\\b\\'` → `'C:\\a'`；已经是根则回自身；相对名（没有任何分隔符）也回自身。
+ *
+ * 尾分隔符先吃掉再切——否则「回上一级」会在原地打转。**盘根单独认**：`C:\` 掐掉尾分隔符会剩成
+ * `C:`，而 `C:` 是「当前盘」不是「上一层」，回它就会多跑一趟、还可能跨到别的盘上去。
+ * UNC（`\\server\share`）不特殊处理：切到头就是共享名本身，浏览停在共享根。 */
+export declare function parentOf(path: string): string;
+/** 把「当前路径 ＋ 一段输入」拼成一个目标路径。 */
+export declare function joinPath(directory: string, name: string): string;
+/** 一层列举里，哪些行可进：隐藏目录按开关过滤，其余照宿主给的顺序。 */
+export declare function visibleEntries(listing: DirectoryListing, showHidden: boolean): readonly DirectoryEntry[];
+/** 这一层有多少个被藏起来的目录（用来决定「显示隐藏目录」那个开关要不要出现在图上）。 */
+export declare function hiddenCount(listing: DirectoryListing): number;
+/** 拿一段文本按「最后一个分隔符」切成「目录部分 ＋ 筛选词」。
+ *
+ * 没打过任何分隔符时目录部分＝null（那段文字还不指任何目录，只当筛选词用）。
+ * Windows 上 `/` 也当分隔符（宿主那边两种都收），POSIX 上不。 */
+export declare function splitDraft(draft: string): {
+    readonly directory: string | null;
+    readonly filter: string;
+};
+/** 按筛选词过一层目录（大小写不敏感；空筛选词＝全留）。 */
+export declare function filterEntries(entries: readonly DirectoryEntry[], filter: string): readonly DirectoryEntry[];
+/** 给界面用的一句话位置说明：优先显示相对 home 的说法，省得整条绝对路径占满一行。 */
+export declare function locationLabel(listing: DirectoryListing): string;
+/** 新建文件夹的名字合不合法（单个路径段：不许分隔符、不许空、不许 `.`／`..`）。
+ *
+ * 与宿主 browse 后端的校验同口径——这里先拦一道，是为了在图上给得出人话，不是替代宿主校验。 */
+export declare function validateFolderName(name: string): {
+    readonly ok: true;
+} | {
+    readonly ok: false;
+    readonly reason: string;
+};
+//# sourceMappingURL=directory-browser-contract.d.ts.map

package/dist/directory-browser-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory-browser-contract.d.ts","sourceRoot":"","sources":["../src/directory-browser-contract.ts"],"names":[],"mappings":"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"}

package/dist/directory-browser-contract.js

@@ -0,0 +1,134 @@
+/** 目录浏览器的纯逻辑半（**不认识宿主**：只认两格原语）。
+ *
+ * 为什么在这里：六个单品插件的设置页各有一批「值是一个目录」的行，它们要的界面是同一个东西。
+ * 界面的**取数**来自宿主给的两个原语（`list`／`createDirectory`），而这两个原语的形状是**调用方喂进来的**
+ * ——本件不 import 宿主的任何实现，也不认识 `remote.directoryPicker` 这个名字（那两件住在各家的
+ * `dsh-ctx.ts` 镜像里）。于是本件在 Windows 桌面、远程浏览器、SSH 三种部署下是同一份代码。
+ *
+ * 装什么：本次要浏览的那一层怎么走（进子目录／回上一级／跳面包屑）、路径怎么切出「目录部分」与
+ * 「筛选词」、回执怎么认。**不装**任何 IO、不装任何持久化——`list`／`createDirectory` 由调用方执行。
+ *
+ * 与平台自带浏览器件的关系：`@deepseek-ai/dsh-client-ui-directory-picker-browse` 的 `DirectoryBrowser`
+ * 是包内私有件（只经 `ui-workspace` 的流程空位暴露），插件侧取不到，所以这里是一份独立实现，
+ * 只对齐它的**交互结果**（进/选/新建），不对齐它的 DOM。
+ */
+/** 认一认某个值是不是可用的目录取数面（软依赖守卫用：认不出就当没有，绝不把页面带下来）。 */
+export function isBrowseFace(raw) {
+    if (typeof raw !== 'object' || raw === null)
+        return false;
+    const face = raw;
+    return typeof face.list === 'function' && typeof face.createDirectory === 'function';
+}
+/** 认一认某个值有没有 `pick`（对应宿主 composition 里的 `native` 能力）。 */
+export function hasPickFn(raw) {
+    if (typeof raw !== 'object' || raw === null)
+        return false;
+    return typeof raw.pick === 'function';
+}
+/** 三态判定：先 native（有 pick），再 browse（有两格原语），都没有＝`none`。 */
+export function pickerModeOf(raw) {
+    if (hasPickFn(raw))
+        return 'native';
+    return isBrowseFace(raw) ? 'browse' : 'none';
+}
+/** 平台回执 → 三态（**永不抛**）：成功回的是信封里的 `value` 不是路径；`ok:false` 是「供不了」不是「取消」。
+ *
+ * 出处：`@deepseek-ai/dsh-api-gateway/lib/client.js` 的 `invoke()`（失败不抛、成功也不回裸值），
+ * 第一方消费方 `@deepseek-ai/dsh-client-ui-workspace/lib/client.js:99-103` 就照这个信封拆。
+ * 裸串照收（老形状兜底），认不出的形状当「供不了」报出来，不当取消吞掉（#743 的教训）。 */
+export function readPickAnswer(raw) {
+    if (typeof raw === 'string')
+        return raw.trim() === '' ? { kind: 'cancelled' } : { kind: 'picked', path: raw };
+    const answer = (typeof raw === 'object' && raw !== null ? raw : {});
+    if (answer.ok === true) {
+        const value = answer.value;
+        return typeof value === 'string' && value.trim() !== '' ? { kind: 'picked', path: value } : { kind: 'cancelled' };
+    }
+    const detail = answer.error?.message?.trim() ?? '';
+    return { kind: 'unavailable', message: '打不开系统文件夹对话框' + (detail === '' ? '' : '（' + detail + '）') + '：请直接在框里填绝对路径。' };
+}
+/** 一段路径里最后那个分隔符的位置（Windows 上 `\` 与 `/` 都算；POSIX 上 `\` 是合法文件名字符，不算）。 */
+function lastSeparator(path) {
+    const back = path.lastIndexOf('\\');
+    const slash = path.lastIndexOf('/');
+    // 只含 `\` 的路径按 Windows 规则解；两者都有时取更靠后的那个。
+    return back > slash ? back : slash;
+}
+/** 上一层：`'C:\\a\\b\\'` → `'C:\\a'`；已经是根则回自身；相对名（没有任何分隔符）也回自身。
+ *
+ * 尾分隔符先吃掉再切——否则「回上一级」会在原地打转。**盘根单独认**：`C:\` 掐掉尾分隔符会剩成
+ * `C:`，而 `C:` 是「当前盘」不是「上一层」，回它就会多跑一趟、还可能跨到别的盘上去。
+ * UNC（`\\server\share`）不特殊处理：切到头就是共享名本身，浏览停在共享根。 */
+export function parentOf(path) {
+    const trimmed = path.replace(/[\\/]+$/, '');
+    if (trimmed === '')
+        return path;
+    const sep = path.includes('\\') ? '\\' : '/';
+    if (/^[A-Za-z]:$/.test(trimmed))
+        return trimmed + sep;
+    const cut = lastSeparator(trimmed);
+    if (cut === -1)
+        return trimmed;
+    if (cut === 0)
+        return path.slice(0, 1);
+    if (cut === 2 && /^[A-Za-z]:/.test(trimmed))
+        return trimmed.slice(0, 2) + sep;
+    return trimmed.slice(0, cut);
+}
+/** 把「当前路径 ＋ 一段输入」拼成一个目标路径。 */
+export function joinPath(directory, name) {
+    const sep = directory.includes('\\') ? '\\' : '/';
+    const base = directory.replace(/[\\/]+$/, '');
+    if (base === '')
+        return sep + name;
+    return base + sep + name;
+}
+/** 一层列举里，哪些行可进：隐藏目录按开关过滤，其余照宿主给的顺序。 */
+export function visibleEntries(listing, showHidden) {
+    return showHidden ? listing.entries : listing.entries.filter((entry) => !entry.hidden);
+}
+/** 这一层有多少个被藏起来的目录（用来决定「显示隐藏目录」那个开关要不要出现在图上）。 */
+export function hiddenCount(listing) {
+    return listing.entries.filter((entry) => entry.hidden).length;
+}
+/** 拿一段文本按「最后一个分隔符」切成「目录部分 ＋ 筛选词」。
+ *
+ * 没打过任何分隔符时目录部分＝null（那段文字还不指任何目录，只当筛选词用）。
+ * Windows 上 `/` 也当分隔符（宿主那边两种都收），POSIX 上不。 */
+export function splitDraft(draft) {
+    const cut = lastSeparator(draft);
+    if (cut === -1)
+        return { directory: null, filter: draft };
+    return { directory: draft.slice(0, cut + 1), filter: draft.slice(cut + 1) };
+}
+/** 按筛选词过一层目录（大小写不敏感；空筛选词＝全留）。 */
+export function filterEntries(entries, filter) {
+    const needle = filter.trim().toLowerCase();
+    if (needle === '')
+        return entries;
+    return entries.filter((entry) => entry.name.toLowerCase().includes(needle));
+}
+/** 给界面用的一句话位置说明：优先显示相对 home 的说法，省得整条绝对路径占满一行。 */
+export function locationLabel(listing) {
+    const home = listing.home.replace(/[\\/]+$/, '');
+    if (home !== '' && listing.path !== home && listing.path.startsWith(home)) {
+        const tail = listing.path.slice(home.length).replace(/^[\\/]+/, '');
+        if (tail !== '')
+            return '~' + (listing.path.includes('\\') ? '\\' : '/') + tail;
+    }
+    return listing.path;
+}
+/** 新建文件夹的名字合不合法（单个路径段：不许分隔符、不许空、不许 `.`／`..`）。
+ *
+ * 与宿主 browse 后端的校验同口径——这里先拦一道，是为了在图上给得出人话，不是替代宿主校验。 */
+export function validateFolderName(name) {
+    const trimmed = name.trim();
+    if (trimmed === '')
+        return { ok: false, reason: '文件夹名不能为空。' };
+    if (/[\\/]/.test(trimmed))
+        return { ok: false, reason: '文件夹名里不能带路径分隔符。' };
+    if (trimmed === '.' || trimmed === '..')
+        return { ok: false, reason: '「.」与「..」不是文件夹名。' };
+    return { ok: true };
+}
+//# sourceMappingURL=directory-browser-contract.js.map

package/dist/directory-browser-contract.js.map

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

package/dist/directory-browser-state.d.ts

@@ -0,0 +1,114 @@
+/** 文件浏览器的操作半：把「进哪一层、这一层显示什么、选到了什么」算成状态，**IO 全部由调用方注入**。
+ *
+ * 分两层的原因：本件（操作）在 Node 里就能直测——喂一个假的取数面，就能把「进目录／回上一级／
+ * 跳面包屑／筛选／新建文件夹／失败出人话」全跑一遍；视图那半（`directory-browser-ui.ts`）
+ * 只负责把这份状态画成 DOM。两边都不认识宿主。
+ *
+ * 数据来源只有两格：`list(path?)` 与 `createDirectory(path, name)`（调用方注入的 `DirectoryBrowseFace`）。
+ */
+import type { BrowseFailure, DirectoryBrowseFace, DirectoryEntry, DirectoryListing } from './directory-browser-contract.js';
+/** 一层列举的三态：加载中／拿到了／这一层读不出来。 */
+export type BrowsePhase = 'idle' | 'loading' | 'ready' | 'failed';
+/** 图上的全部状态。视图只读它，不改它。 */
+export interface BrowseState {
+    readonly phase: BrowsePhase;
+    readonly listing: DirectoryListing | null;
+    /** 这一层读失败时的人话；`phase==='failed'` 时一定有。 */
+    readonly failure: BrowseFailure | null;
+    /** 当前选中的子目录（点行选中；选中后再点「打开」就是它）。 */
+    readonly selected: string | null;
+    /** 面包屑上那一层的编号，只用于画图。 */
+    readonly showHidden: boolean;
+    /** 路径框里的草稿（用户可能正在编辑）。 */
+    readonly draft: string;
+    /** 草稿指向的那一层已经列举过之后，用来按末段过滤的词。 */
+    readonly filter: string;
+    /** 正在建的文件夹名；null＝没在建。 */
+    readonly creating: string | null;
+    /** 上一次操作的失败人话（新建失败等）；看一眼就好，下一次操作清掉。 */
+    readonly notice: string | null;
+}
+/** 订阅者拿到的状态（不可变，每次变更是新对象）。 */
+export type BrowseListener = (state: BrowseState) => void;
+/** 操作面：视图与用例都只用这些方法。 */
+export interface BrowseController {
+    getState(): BrowseState;
+    subscribe(listener: BrowseListener): () => void;
+    /** 开图：初次列举（`list()` 不带路径＝宿主给的家目录）。 */
+    open(): Promise<void>;
+    /** 进某一层（绝对路径，或 `list()` 的默认家目录当入参为 null）。 */
+    enter(path: string | null): Promise<void>;
+    /** 回上一级（当前层就是根时原地不动）。 */
+    up(): Promise<void>;
+    /** 采纳当前选择（选中行，没有选中就用当前层）并回调 `onPicked`。 */
+    pick(): void;
+    /** 取消：关图，什么都不回调。 */
+    cancel(): void;
+    /** 选中一个子目录（再点一次同一条＝取消选中）。 */
+    select(path: string): void;
+    /** 切换隐藏目录。 */
+    toggleHidden(): void;
+    /** 改路径框草稿（不列举，只更新草稿与筛选词）。 */
+    setDraft(draft: string): void;
+    /** 提交路径框草稿：指到哪一层就去哪一层。 */
+    commitDraft(): Promise<void>;
+    /** 开「新建文件夹」；传 null 收起。 */
+    setCreating(name: string | null): void;
+    /** 在当前层（或选中的那一层）下建一个新文件夹，成功后进它并选中它。 */
+    createFolder(name: string): Promise<void>;
+    /** 关图（与 `cancel` 同义，供宿主侧统一收口）。 */
+    close(): void;
+}
+/** 建一个浏览器控制器。取数、回调、初值全部由调用方给。 */
+export declare function createBrowseController(deps: {
+    readonly face: DirectoryBrowseFace;
+    readonly initialPath: string;
+    readonly onPicked: (path: string) => void;
+    readonly onClose: () => void;
+    /** 失败人话的前缀，默认「浏览失败」。 */
+    readonly failureLabel?: string;
+}): BrowseController;
+/** 图上这一层要画的行（按隐藏开关与草稿末段过滤之后的）。 */
+export declare function rowsOf(state: BrowseState): readonly DirectoryEntry[];
+/** 图上这一层能不能回上一级（根目录不能）。 */
+export declare function canGoUp(state: BrowseState): boolean;
+/** 「打开」这颗按钮的目标：选中行优先，没选中就是当前层。 */
+export declare function targetOf(state: BrowseState): string | null;
+/** 新建文件夹那一行要展示的位置（"在 <这里> 下新建"）。 */
+export declare function createBaseOf(state: BrowseState): string | null;
+/** 一段路径拼成可读的一句话（给用例与调试用；图上不直接显示）。 */
+export declare function describe(state: BrowseState): string;
+/** 一行子目录的完整路径（图上点行时用）。 */
+export declare function entryPath(directory: string, entry: DirectoryEntry): string;
+/** 目录行接线的返回：**不碰 React**——`actions` 原样喂给 `directory-browser-ui` 的组件 props，
+ *  `isOpen`／`setOpen` 由调用方自己接进它的状态（宿主怎么重画是它的事，本件不管）。 */
+export interface DirectoryRowBrowser {
+    readonly actions: {
+        readonly onPick: () => void;
+        readonly onClose: () => void;
+        readonly onEnter: (path: string) => void;
+        readonly onUp: () => void;
+        readonly onSelect: (path: string) => void;
+        readonly onToggleHidden: () => void;
+        readonly onDraft: (draft: string) => void;
+        readonly onCommitDraft: () => void;
+        readonly onCreate: (name: string) => void;
+        readonly onCreatingChange: (name: string | null) => void;
+    };
+    /** 开图（初次列举家目录），并把「开着」交给调用方自己记。 */
+    open(): Promise<void>;
+    state(): BrowseState;
+    /** 一段可读的当前状态（用例与调试用）。 */
+    summary(): string;
+}
+/** 建一份「目录行接线」：给一个取数面与初值，回一组动作。
+ *
+ * 只做接线：把控制器算出来的状态与回调打包好，不取数、不画图、不认宿主。 */
+export declare function createDirectoryRowBrowser(deps: {
+    readonly face: DirectoryBrowseFace;
+    readonly initialPath: string;
+    readonly onPicked: (path: string) => void;
+    readonly onClosed?: () => void;
+    readonly failureLabel?: string;
+}): DirectoryRowBrowser;
+//# sourceMappingURL=directory-browser-state.d.ts.map

package/dist/directory-browser-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory-browser-state.d.ts","sourceRoot":"","sources":["../src/directory-browser-state.ts"],"names":[],"mappings":"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"}

package/dist/directory-browser-state.js

@@ -0,0 +1,203 @@
+/** 文件浏览器的操作半：把「进哪一层、这一层显示什么、选到了什么」算成状态，**IO 全部由调用方注入**。
+ *
+ * 分两层的原因：本件（操作）在 Node 里就能直测——喂一个假的取数面，就能把「进目录／回上一级／
+ * 跳面包屑／筛选／新建文件夹／失败出人话」全跑一遍；视图那半（`directory-browser-ui.ts`）
+ * 只负责把这份状态画成 DOM。两边都不认识宿主。
+ *
+ * 数据来源只有两格：`list(path?)` 与 `createDirectory(path, name)`（调用方注入的 `DirectoryBrowseFace`）。
+ */
+import { filterEntries, joinPath, parentOf, splitDraft, validateFolderName, visibleEntries, } from './directory-browser-contract.js';
+/** 建一个浏览器控制器。取数、回调、初值全部由调用方给。 */
+export function createBrowseController(deps) {
+    const label = deps.failureLabel ?? '浏览失败';
+    const listeners = new Set();
+    let state = {
+        phase: 'idle',
+        listing: null,
+        failure: null,
+        selected: null,
+        showHidden: false,
+        draft: deps.initialPath,
+        filter: '',
+        creating: null,
+        notice: null,
+    };
+    /** 每次列举带一个序号：晚回来的旧回执直接丢掉，不许覆盖新一层。 */
+    let generation = 0;
+    const emit = (next) => {
+        state = { ...state, ...next };
+        for (const listener of [...listeners])
+            listener(state);
+    };
+    const humanize = (cause) => {
+        const raw = (typeof cause === 'object' && cause !== null ? cause : {});
+        const message = typeof raw.message === 'string' && raw.message.trim() !== '' ? raw.message.trim() : String(cause);
+        const code = typeof raw.code === 'string' && raw.code !== '' ? raw.code : 'browse-failed';
+        return { code, message: `${label}：${message}` };
+    };
+    const load = async (path) => {
+        const mine = ++generation;
+        emit({ phase: 'loading', failure: null, notice: null });
+        try {
+            const listing = path === null ? await deps.face.list() : await deps.face.list(path);
+            if (mine !== generation)
+                return;
+            emit({
+                phase: 'ready',
+                listing,
+                failure: null,
+                selected: null,
+                draft: listing.path,
+                filter: '',
+            });
+        }
+        catch (cause) {
+            if (mine !== generation)
+                return;
+            emit({ phase: 'failed', listing: null, failure: humanize(cause), selected: null });
+        }
+    };
+    /** 草稿指到的那一层已经列举过时，按末段筛当前这一层的行；否则不过滤。
+     *
+     * 两边都先掐掉尾分隔符再比：草稿那边切开后天然带尾分隔符（`C:\a\` ＋ `b`），
+     * 而这一层的 `path` 由宿主给、不带尾分隔符。 */
+    const applyDraft = (draft) => {
+        const { directory, filter } = splitDraft(draft);
+        const listing = state.listing;
+        const sameLevel = listing !== null && directory !== null && normalize(directory) === normalize(listing.path);
+        emit({ draft, filter: sameLevel ? filter : '' });
+    };
+    const normalize = (path) => path.replace(/[\\/]+$/, '');
+    return {
+        getState: () => state,
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => listeners.delete(listener);
+        },
+        open: () => load(null),
+        enter: (path) => load(path),
+        async up() {
+            const listing = state.listing;
+            if (listing === null)
+                return;
+            const parent = parentOf(listing.path);
+            if (parent === listing.path)
+                return;
+            await load(parent);
+        },
+        pick() {
+            const target = state.selected ?? state.listing?.path ?? null;
+            if (target === null)
+                return;
+            deps.onPicked(target);
+        },
+        cancel() {
+            deps.onClose();
+        },
+        close() {
+            deps.onClose();
+        },
+        select(path) {
+            emit({ selected: state.selected === path ? null : path, notice: null });
+        },
+        toggleHidden() {
+            emit({ showHidden: !state.showHidden });
+        },
+        setDraft(draft) {
+            applyDraft(draft);
+        },
+        async commitDraft() {
+            const trimmed = state.draft.trim();
+            if (trimmed === '')
+                return;
+            await load(trimmed);
+        },
+        setCreating(name) {
+            emit({ creating: name, notice: null });
+        },
+        async createFolder(name) {
+            const checked = validateFolderName(name);
+            if (!checked.ok) {
+                emit({ notice: checked.reason });
+                return;
+            }
+            const base = state.selected ?? state.listing?.path ?? null;
+            if (base === null) {
+                emit({ notice: '还没有打开任何目录，无法新建文件夹。' });
+                return;
+            }
+            try {
+                const created = await deps.face.createDirectory(base, name.trim());
+                emit({ creating: null, notice: null });
+                await load(created);
+                emit({ selected: created });
+            }
+            catch (cause) {
+                const failure = humanize(cause);
+                emit({ notice: failure.message, creating: null });
+            }
+        },
+    };
+}
+/** 图上这一层要画的行（按隐藏开关与草稿末段过滤之后的）。 */
+export function rowsOf(state) {
+    if (state.listing === null)
+        return [];
+    return filterEntries(visibleEntries(state.listing, state.showHidden), state.filter);
+}
+/** 图上这一层能不能回上一级（根目录不能）。 */
+export function canGoUp(state) {
+    if (state.listing === null)
+        return false;
+    return parentOf(state.listing.path) !== state.listing.path;
+}
+/** 「打开」这颗按钮的目标：选中行优先，没选中就是当前层。 */
+export function targetOf(state) {
+    return state.selected ?? state.listing?.path ?? null;
+}
+/** 新建文件夹那一行要展示的位置（"在 <这里> 下新建"）。 */
+export function createBaseOf(state) {
+    return state.selected ?? state.listing?.path ?? null;
+}
+/** 一段路径拼成可读的一句话（给用例与调试用；图上不直接显示）。 */
+export function describe(state) {
+    if (state.phase === 'failed')
+        return `${state.failure?.code ?? 'browse-failed'} @ ${state.draft}`;
+    if (state.listing === null)
+        return `${state.phase}`;
+    return `${state.listing.path}（${rowsOf(state).length} 行）`;
+}
+/** 一行子目录的完整路径（图上点行时用）。 */
+export function entryPath(directory, entry) {
+    return entry.path === '' ? joinPath(directory, entry.name) : entry.path;
+}
+/** 建一份「目录行接线」：给一个取数面与初值，回一组动作。
+ *
+ * 只做接线：把控制器算出来的状态与回调打包好，不取数、不画图、不认宿主。 */
+export function createDirectoryRowBrowser(deps) {
+    const controller = createBrowseController({
+        face: deps.face,
+        initialPath: deps.initialPath,
+        onPicked: deps.onPicked,
+        onClose: () => deps.onClosed?.(),
+        ...(deps.failureLabel === undefined ? {} : { failureLabel: deps.failureLabel }),
+    });
+    return {
+        open: () => controller.open(),
+        state: () => controller.getState(),
+        summary: () => describe(controller.getState()),
+        actions: {
+            onPick: () => controller.pick(),
+            onClose: () => controller.cancel(),
+            onEnter: (path) => void controller.enter(path),
+            onUp: () => void controller.up(),
+            onSelect: (path) => controller.select(path),
+            onToggleHidden: () => controller.toggleHidden(),
+            onDraft: (draft) => controller.setDraft(draft),
+            onCommitDraft: () => void controller.commitDraft(),
+            onCreate: (name) => void controller.createFolder(name),
+            onCreatingChange: (name) => controller.setCreating(name),
+        },
+    };
+}
+//# sourceMappingURL=directory-browser-state.js.map