@openviking/react 0.1.1 → 0.1.3

package/dist/components/file-preview/use-directory-level.d.ts

@@ -0,0 +1,30 @@
+import type { FilePreviewDirectoryTab, FilePreviewSource } from './types.js';
+/**
+ * 目录页签当前看的是哪一级摘要。
+ *
+ * 它必须由预览外壳持有，而不是留在正文组件内部：复制正文取的是「用户正在看的
+ * 那一份」，标题行的路径也来自同一级，两处都在外壳这一层取值；留在正文里，复制
+ * 到的永远是第一级。
+ *
+ * 宿主给了 `activeLevelKey` 时以宿主的为准，这里只记非受控页签自己的选择。
+ *
+ * Which summary level of a directory tab is on screen.
+ *
+ * It belongs to the preview shell rather than inside the body component: copy-content
+ * takes "what the user is looking at" and the header path comes from the same level,
+ * both read at this layer — kept in the body, a copy would always take the first
+ * level.
+ *
+ * A host-supplied `activeLevelKey` wins; this only records the choice of an
+ * uncontrolled tab.
+ */
+export interface DirectoryLevelState {
+    /** 实际渲染的那一级。The level actually rendered. */
+    activeLevel?: FilePreviewDirectoryTab['levels'][number];
+    /** 把当前层级固定下来的目录页签，交给正文组件。 */
+    /** The directory tab with the level pinned, handed to the body. */
+    directoryTab?: FilePreviewDirectoryTab;
+    /** 复制路径与复制正文共用的来源。The source shared by copy-path and copy-content. */
+    source?: FilePreviewSource;
+}
+export declare function useDirectoryLevel(tab: FilePreviewDirectoryTab | undefined): DirectoryLevelState;

package/dist/components/file-preview/use-file-preview-actions-context.d.ts

@@ -0,0 +1,27 @@
+import type { useFilePreviewActions } from './use-file-preview-actions.js';
+import type { useFilePreviewEditing } from './use-file-preview-editing.js';
+import type { FilePreviewActions, FilePreviewFileTab, FilePreviewSource, FilePreviewTab, FilePreviewViewMode } from './types.js';
+type Operations = ReturnType<typeof useFilePreviewActions>;
+type Editing = ReturnType<typeof useFilePreviewEditing>;
+/**
+ * 组装交给宿主的动作上下文：把组件内部的视图、编辑与操作状态，连同改变它们
+ * 的方法收成一个对象，供 `slots.actions` 渲染按钮时使用。
+ *
+ * Assembles the action context handed to the host: the component's view, editing
+ * and operation state together with the methods that change them, so a
+ * `slots.actions` renderer can build its own buttons.
+ */
+export declare function useFilePreviewActionsContext({ activeTab, fileTab, currentPath, currentSource, viewMode, canSwitchView, setViewMode, editing, operations, }: {
+    activeTab: FilePreviewTab;
+    fileTab?: FilePreviewFileTab;
+    /** 当前页签的路径；目录页签也有。The current tab's path; a directory has one too. */
+    currentPath?: string;
+    /** 当前页签的正文来源；目录页签取当前那一级。The body source; a directory uses its active level. */
+    currentSource?: FilePreviewSource;
+    viewMode: FilePreviewViewMode;
+    canSwitchView: boolean;
+    setViewMode: (mode: FilePreviewViewMode) => void;
+    editing: Editing;
+    operations: Operations;
+}): FilePreviewActions;
+export {};

package/dist/components/file-preview/use-file-preview-actions.d.ts

@@ -0,0 +1,19 @@
+import type { FilePreviewFileTab, FilePreviewTab } from './types.js';
+/**
+ * 文件页签的操作执行与成功通知。
+ *
+ * 沿用文件树的约定：`operations` 里的异步方法成功后才触发对应的 `on…`
+ * 回调，失败静默；同一操作在飞时忽略重复调用。
+ *
+ * Executes file-tab operations and reports success. Follows the file-tree
+ * convention: the matching `on…` callback fires only after the async operation
+ * resolves, failures stay silent, and repeated calls are ignored while one is
+ * still in flight.
+ */
+export declare function useFilePreviewActions(): {
+    openParent: (tab: FilePreviewTab, uri: string) => Promise<void>;
+    download: (tab: FilePreviewFileTab) => Promise<void>;
+    openUri: (tab: FilePreviewFileTab, uri: string) => Promise<void>;
+    copyPath: (tab: FilePreviewTab, path: string) => Promise<boolean>;
+    copyContent: (tab: FilePreviewTab, text: string) => Promise<boolean>;
+};

package/dist/components/file-preview/use-file-preview-editing.d.ts

@@ -1,5 +1,24 @@
 import type { FilePreviewFileTab, FilePreviewTab } from './types.js';
-export declare function useFilePreviewEditing(): {
+/**
+ * 文件页签的编辑态：进入编辑时向宿主取完整文本，保存成功才退出编辑。
+ *
+ * 进入编辑前用请求号作废旧请求，避免快速切换页签时迟到的结果写进新草稿；
+ * 保存期间拦住重复提交与页签切换，失败时保留草稿。
+ *
+ * 受控模式下宿主可以直接改 `activeKey`，不经过 `switchTab`；因此这里比对页签
+ * key，变化时在渲染期间就把草稿丢掉，否则会拿上一个页签的草稿去保存新页签。
+ *
+ * Editing state of a file tab. The full text is requested when editing starts,
+ * and the draft only leaves editing after a successful save. A request id
+ * invalidates stale loads when the tab changes quickly; duplicate saves and tab
+ * switches are blocked while saving, and a failed save keeps the draft.
+ *
+ * Under a controlled `activeKey` the host can switch tabs without going through
+ * `switchTab`, so the hook compares the active key and drops the draft during
+ * render when it changes — otherwise the previous tab's draft would be saved to
+ * the new one.
+ */
+export declare function useFilePreviewEditing(activeTabKey: string): {
     editing: boolean;
     loadingEdit: boolean;
     editFailed: boolean;
@@ -8,6 +27,6 @@ export declare function useFilePreviewEditing(): {
     draft: string;
     discard: (tab: FilePreviewTab) => void;
     start: (tab: FilePreviewFileTab) => Promise<void>;
-    save: (tab: FilePreviewFileTab) => Promise<void>;
+    save: (tab: FilePreviewFileTab) => Promise<boolean>;
     updateDraft: (value: string) => void;
 };

package/dist/components/file-preview/use-file-preview-ids.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 页签与面板的 DOM id 生成器，带实例前缀。
+ *
+ * 只用宿主给的 `tab.key` 拼 id，两个预览同时挂载时会产生重复 id，`aria-controls`
+ * 与 `aria-labelledby` 因此可能指向另一个实例的元素。`useId` 给出每个实例唯一
+ * 的前缀，页签行与面板两侧共用同一份。
+ *
+ * DOM id generators for tabs and panels, prefixed per instance.
+ *
+ * Building ids from the host's `tab.key` alone collides when two previews are
+ * mounted at once, so `aria-controls` and `aria-labelledby` could point at the
+ * other instance's elements. `useId` supplies a unique prefix per instance, shared
+ * by the tab row and the panels.
+ */
+export declare function useFilePreviewIds(activeKey: string): {
+    tabId: (key: string) => string;
+    panelId: (key: string) => string;
+    /** 面板的公共属性：id、role 与 aria 关联，随当前页签变化。 */
+    panelProps: {
+        id: string;
+        role: 'tabpanel';
+        'aria-labelledby': string;
+    };
+};

package/dist/components/file-preview.js

@@ -1,442 +1 @@
-import { Fragment, jsx, jsxs } from "react/jsx-runtime";
-import { forwardRef, useId, useImperativeHandle, useRef, useState } from "react";
-function FilePreviewBody({ fileTab, contentTab, text, editing, loadingEdit, editFailed, saving, saveFailed, draft, onDraftChange }) {
-    const errorId = useId();
-    if (contentTab) return contentTab.content;
-    if (!fileTab) return null;
-    const { source } = fileTab;
-    if (loadingEdit) return /*#__PURE__*/ jsx("div", {
-        className: "ov-file-preview__state",
-        children: /*#__PURE__*/ jsx("span", {
-            className: "ov-file-preview__muted",
-            children: text.loading
-        })
-    });
-    if (editFailed) return /*#__PURE__*/ jsx("div", {
-        className: "ov-file-preview__state",
-        "data-tone": "error",
-        children: /*#__PURE__*/ jsx("span", {
-            className: "ov-file-preview__muted",
-            children: text.loadFailed
-        })
-    });
-    if (editing && fileTab.editing) return /*#__PURE__*/ jsxs("div", {
-        className: "ov-file-preview__editor",
-        "aria-busy": saving || void 0,
-        children: [
-            saveFailed ? /*#__PURE__*/ jsx("div", {
-                id: errorId,
-                role: "alert",
-                className: "ov-file-preview__save-error",
-                children: text.saveFailed
-            }) : null,
-            /*#__PURE__*/ jsx("textarea", {
-                className: "ov-file-preview__textarea",
-                "aria-label": text.edit,
-                "aria-describedby": saveFailed ? errorId : void 0,
-                readOnly: saving,
-                value: draft,
-                onChange: (event)=>onDraftChange(event.target.value)
-            })
-        ]
-    });
-    if ('string' != typeof source.content) return /*#__PURE__*/ jsx("div", {
-        className: "ov-file-preview__state",
-        children: fileTab.slots?.unsupportedFallback ?? /*#__PURE__*/ jsx("span", {
-            className: "ov-file-preview__muted",
-            children: source.file || source.url ? text.binaryUnsupported : text.unsupported
-        })
-    });
-    return /*#__PURE__*/ jsx("div", {
-        className: "ov-file-preview__text-body",
-        children: /*#__PURE__*/ jsx("pre", {
-            className: "ov-file-preview__pre",
-            children: source.content
-        })
-    });
-}
-function FileIcon() {
-    return /*#__PURE__*/ jsxs("svg", {
-        "aria-hidden": "true",
-        className: "ov-file-preview__icon",
-        viewBox: "0 0 16 16",
-        width: "14",
-        height: "14",
-        children: [
-            /*#__PURE__*/ jsx("path", {
-                d: "M4 1.5h5L12.5 5v9.5h-8.5V1.5Z",
-                fill: "none",
-                stroke: "currentColor",
-                strokeLinejoin: "round",
-                strokeWidth: "1.2"
-            }),
-            /*#__PURE__*/ jsx("path", {
-                d: "M9 1.5V5h3.5",
-                fill: "none",
-                stroke: "currentColor",
-                strokeWidth: "1.2"
-            })
-        ]
-    });
-}
-function CopyIcon() {
-    return /*#__PURE__*/ jsxs("svg", {
-        "aria-hidden": "true",
-        className: "ov-file-preview__action-icon",
-        viewBox: "0 0 16 16",
-        width: "12",
-        height: "12",
-        children: [
-            /*#__PURE__*/ jsx("rect", {
-                x: "5.5",
-                y: "5.5",
-                width: "8",
-                height: "9",
-                rx: "1.2",
-                fill: "none",
-                stroke: "currentColor",
-                strokeWidth: "1.2"
-            }),
-            /*#__PURE__*/ jsx("path", {
-                d: "M10.5 5.5v-2a1 1 0 0 0-1-1h-7a1 1 0 0 0-1 1v8a1 1 0 0 0 1 1h2",
-                fill: "none",
-                stroke: "currentColor",
-                strokeWidth: "1.2"
-            })
-        ]
-    });
-}
-const DEFAULT_LABELS = {
-    copyContent: 'Copy content',
-    copyContentSuccess: 'Content copied',
-    copyContentEmpty: 'Nothing to copy',
-    copyPath: 'Copy path',
-    copyPathSuccess: 'Path copied',
-    openParent: 'Open parent directory',
-    edit: 'Edit',
-    save: 'Save',
-    cancel: 'Cancel',
-    preview: 'Preview',
-    source: 'Source',
-    retry: 'Retry',
-    loadFailed: 'Failed to load the file',
-    saveFailed: 'Failed to save',
-    unsupported: 'Preview is not supported for this format',
-    loading: 'Loading…',
-    download: 'Download',
-    binaryUnsupported: 'Binary preview requires FileViewer'
-};
-function readCopyableText(tab) {
-    const { content } = tab.source;
-    return 'string' == typeof content && content.length > 0 ? content : void 0;
-}
-async function performPreviewOperation(execute, notify) {
-    if (!execute) return;
-    try {
-        await execute();
-    } catch  {
-        return;
-    }
-    notify?.();
-}
-async function copyText(value, onCopied) {
-    try {
-        await navigator.clipboard.writeText(value);
-    } catch  {
-        return;
-    }
-    onCopied?.(value);
-}
-function FilePreviewHeader({ activeTab, fileTab, text, viewMode, editing, loadingEdit, saving, onViewModeChange, onEditStart, onEditCancel, onEditSave }) {
-    const titleExtra = activeTab.slots?.titleExtra;
-    const headerActions = activeTab.slots?.actions;
-    const path = fileTab?.source.path;
-    return /*#__PURE__*/ jsxs("div", {
-        className: "ov-file-preview__header",
-        children: [
-            /*#__PURE__*/ jsxs("div", {
-                className: "ov-file-preview__path-row",
-                children: [
-                    path ? /*#__PURE__*/ jsx("button", {
-                        type: "button",
-                        className: "ov-file-preview__breadcrumb",
-                        onClick: (event)=>{
-                            event.stopPropagation();
-                            performPreviewOperation(fileTab.operations?.openParent ? ()=>fileTab.operations.openParent(path) : void 0, ()=>fileTab.onOpenParent?.(path));
-                        },
-                        disabled: !fileTab.operations?.openParent || saving,
-                        title: path,
-                        children: path
-                    }) : /*#__PURE__*/ jsx("span", {
-                        className: "ov-file-preview__breadcrumb",
-                        children: activeTab.key
-                    }),
-                    path ? /*#__PURE__*/ jsx("button", {
-                        type: "button",
-                        className: "ov-file-preview__action",
-                        "aria-label": text.copyPath,
-                        title: text.copyPath,
-                        onClick: ()=>void copyText(path, fileTab.onCopyPath),
-                        children: /*#__PURE__*/ jsx(CopyIcon, {})
-                    }) : null,
-                    titleExtra ? /*#__PURE__*/ jsx("span", {
-                        className: "ov-file-preview__title-extra",
-                        children: titleExtra
-                    }) : null
-                ]
-            }),
-            /*#__PURE__*/ jsxs("div", {
-                className: "ov-file-preview__header-actions",
-                children: [
-                    fileTab && false !== fileTab.showViewModeSwitch ? /*#__PURE__*/ jsxs("span", {
-                        className: "ov-file-preview__switch",
-                        children: [
-                            /*#__PURE__*/ jsx("button", {
-                                type: "button",
-                                className: "ov-file-preview__switch-item",
-                                "data-active": 'preview' === viewMode || void 0,
-                                onClick: ()=>onViewModeChange('preview'),
-                                children: text.preview
-                            }),
-                            /*#__PURE__*/ jsx("button", {
-                                type: "button",
-                                className: "ov-file-preview__switch-item",
-                                "data-active": 'source' === viewMode || void 0,
-                                onClick: ()=>onViewModeChange('source'),
-                                children: text.source
-                            })
-                        ]
-                    }) : null,
-                    fileTab ? /*#__PURE__*/ jsx("button", {
-                        type: "button",
-                        className: "ov-file-preview__action",
-                        "aria-label": text.copyContent,
-                        title: readCopyableText(fileTab) ? text.copyContent : text.copyContentEmpty,
-                        disabled: !readCopyableText(fileTab),
-                        onClick: ()=>{
-                            const value = readCopyableText(fileTab);
-                            if (value) copyText(value, fileTab.onCopyContent);
-                        },
-                        children: /*#__PURE__*/ jsx(CopyIcon, {})
-                    }) : null,
-                    fileTab?.editing && !editing ? /*#__PURE__*/ jsx("button", {
-                        type: "button",
-                        className: "ov-file-preview__button",
-                        disabled: loadingEdit || !fileTab.editing.loadContent && void 0 === fileTab.source.content && !fileTab.source.file,
-                        onClick: onEditStart,
-                        children: text.edit
-                    }) : null,
-                    fileTab?.editing && editing ? /*#__PURE__*/ jsxs(Fragment, {
-                        children: [
-                            /*#__PURE__*/ jsx("button", {
-                                type: "button",
-                                className: "ov-file-preview__button",
-                                onClick: onEditCancel,
-                                disabled: saving,
-                                children: text.cancel
-                            }),
-                            /*#__PURE__*/ jsx("button", {
-                                type: "button",
-                                className: "ov-file-preview__button--primary",
-                                onClick: onEditSave,
-                                disabled: saving,
-                                children: text.save
-                            })
-                        ]
-                    }) : null,
-                    fileTab?.operations?.download ? /*#__PURE__*/ jsx("button", {
-                        type: "button",
-                        className: "ov-file-preview__button",
-                        onClick: ()=>{
-                            performPreviewOperation(fileTab.operations?.download, fileTab.onDownload);
-                        },
-                        children: text.download
-                    }) : null,
-                    headerActions ? /*#__PURE__*/ jsx("span", {
-                        className: "ov-file-preview__extra-actions",
-                        children: headerActions
-                    }) : null
-                ]
-            })
-        ]
-    });
-}
-function useFilePreviewEditing() {
-    const [editing, setEditing] = useState(false);
-    const [loadingEdit, setLoadingEdit] = useState(false);
-    const [editFailed, setEditFailed] = useState(false);
-    const [saving, setSaving] = useState(false);
-    const [saveFailed, setSaveFailed] = useState(false);
-    const [draft, setDraft] = useState('');
-    const requestId = useRef(0);
-    const loading = useRef(false);
-    const pendingSave = useRef(false);
-    function discard(tab) {
-        requestId.current += 1;
-        loading.current = false;
-        setEditing(false);
-        setLoadingEdit(false);
-        setEditFailed(false);
-        setSaveFailed(false);
-        setDraft('');
-        if (editing && 'file' === tab.kind) tab.editing?.onCancel?.(draft);
-    }
-    async function start(tab) {
-        if (loading.current || pendingSave.current) return;
-        const id = ++requestId.current;
-        loading.current = true;
-        setLoadingEdit(true);
-        setEditFailed(false);
-        setSaveFailed(false);
-        let content;
-        try {
-            content = tab.editing?.loadContent ? await tab.editing.loadContent(tab.source) : tab.source.content ?? await tab.source.file?.text();
-        } catch  {
-            if (id === requestId.current) setEditFailed(true);
-        }
-        if (id !== requestId.current) return;
-        loading.current = false;
-        setLoadingEdit(false);
-        if (void 0 !== content) {
-            setDraft(content);
-            setEditing(true);
-        }
-    }
-    async function save(tab) {
-        if (!editing || !tab.editing || pendingSave.current) return;
-        pendingSave.current = true;
-        setSaving(true);
-        setSaveFailed(false);
-        const value = draft;
-        try {
-            await tab.editing.save(value);
-        } catch  {
-            setSaveFailed(true);
-            return;
-        } finally{
-            pendingSave.current = false;
-            setSaving(false);
-        }
-        setEditing(false);
-        setDraft('');
-        tab.editing.onSave?.(value);
-    }
-    return {
-        editing,
-        loadingEdit,
-        editFailed,
-        saving,
-        saveFailed,
-        draft,
-        discard,
-        start,
-        save,
-        updateDraft: (value)=>{
-            setDraft(value);
-            setSaveFailed(false);
-        }
-    };
-}
-function isFileTab(tab) {
-    return 'file' === tab.kind;
-}
-const file_preview_FilePreview = /*#__PURE__*/ forwardRef(function({ tabs, labels, className, ...rest }, ref) {
-    const text = {
-        ...DEFAULT_LABELS,
-        ...labels
-    };
-    const [activeKey, setActiveKey] = useState(()=>tabs[0].key);
-    const [viewMode, setViewMode] = useState('preview');
-    const editor = useFilePreviewEditing();
-    const activeTab = tabs.find((tab)=>tab.key === activeKey) ?? tabs[0];
-    const tabText = {
-        ...text,
-        ...activeTab.labels
-    };
-    const fileTab = isFileTab(activeTab) ? activeTab : void 0;
-    const contentTab = isFileTab(activeTab) ? void 0 : activeTab;
-    const switchTab = (key)=>{
-        if (key === activeKey) return true;
-        if (editor.saving) return false;
-        setActiveKey(key);
-        setViewMode('preview');
-        editor.discard(activeTab);
-        return true;
-    };
-    useImperativeHandle(ref, ()=>({
-            setActiveTab: (key)=>{
-                const target = tabs.find((tab)=>tab.key === key);
-                if (!target || target.disabled) return false;
-                return switchTab(key);
-            },
-            getActiveTab: ()=>activeKey
-        }));
-    const handleTabClick = (tab)=>{
-        if (tab.disabled) return;
-        switchTab(tab.key);
-    };
-    return /*#__PURE__*/ jsxs("div", {
-        ...rest,
-        className: [
-            'ov-file-preview',
-            className
-        ].filter(Boolean).join(' '),
-        children: [
-            /*#__PURE__*/ jsx("div", {
-                role: "tablist",
-                className: "ov-file-preview__tab-row",
-                children: tabs.map((tab)=>/*#__PURE__*/ jsxs("button", {
-                        type: "button",
-                        role: "tab",
-                        "aria-selected": tab.key === activeTab.key,
-                        disabled: tab.disabled || editor.saving,
-                        className: "ov-file-preview__tab",
-                        onClick: ()=>handleTabClick(tab),
-                        children: [
-                            /*#__PURE__*/ jsx("span", {
-                                className: "ov-file-preview__icon-slot",
-                                children: tab.icon ?? /*#__PURE__*/ jsx(FileIcon, {})
-                            }),
-                            /*#__PURE__*/ jsx("span", {
-                                className: "ov-file-preview__tab-title",
-                                children: tab.title ?? (isFileTab(tab) ? tab.source.fileName : tab.key)
-                            })
-                        ]
-                    }, tab.key))
-            }),
-            /*#__PURE__*/ jsx(FilePreviewHeader, {
-                activeTab: activeTab,
-                fileTab: fileTab,
-                text: tabText,
-                viewMode: viewMode,
-                editing: editor.editing,
-                loadingEdit: editor.loadingEdit,
-                saving: editor.saving,
-                onViewModeChange: setViewMode,
-                onEditStart: ()=>{
-                    if (fileTab) editor.start(fileTab);
-                },
-                onEditCancel: ()=>editor.discard(activeTab),
-                onEditSave: ()=>{
-                    if (fileTab) editor.save(fileTab);
-                }
-            }),
-            /*#__PURE__*/ jsx("div", {
-                className: "ov-file-preview__body",
-                children: /*#__PURE__*/ jsx(FilePreviewBody, {
-                    fileTab: fileTab,
-                    contentTab: contentTab,
-                    text: tabText,
-                    editing: editor.editing,
-                    loadingEdit: editor.loadingEdit,
-                    editFailed: editor.editFailed,
-                    saving: editor.saving,
-                    saveFailed: editor.saveFailed,
-                    draft: editor.draft,
-                    onDraftChange: editor.updateDraft
-                })
-            })
-        ]
-    });
-});
-export { file_preview_FilePreview as FilePreview };
+export { FilePreview, LoadingState } from "../30~0.js";

package/dist/components/file-tree/file-tree-body.d.ts

@@ -1,14 +1,18 @@
 import type { ReactNode } from 'react';
-import type { FileTreeRowContext } from './file-tree-row-context.js';
-import type { FileTreeLabels, FileTreeRow } from './types.js';
+import type { FileTreeRowContext, ResolvedLabels } from './file-tree-row-context.js';
+import type { FileTreeRow } from './types.js';
 export interface FileTreeBodyProps {
     rows: readonly FileTreeRow[];
     isReady: boolean;
-    text: Required<FileTreeLabels>;
+    text: ResolvedLabels;
     loadingFallback?: ReactNode;
     errorFallback?: ReactNode;
     emptyFallback?: ReactNode;
     ctx: FileTreeRowContext;
 }
-/** 树内容区：加载中、整树失败、空态与正常行列表。 */
+/**
+ * 树内容区：首次加载、整树失败、空态与正常行列表。
+ *
+ * The tree body: first load, whole-tree failure, empty state, and the row list.
+ */
 export declare function FileTreeBody({ rows, isReady, text, loadingFallback, errorFallback, emptyFallback, ctx, }: FileTreeBodyProps): import("react").JSX.Element;

package/dist/components/file-tree/file-tree-entry-row.d.ts

@@ -1,6 +1,12 @@
-import { type FileTreeRowContext } from './file-tree-row-context.js';
-import { type FileTreeEntryRow } from './types.js';
-export declare function FileTreeEntryRowView({ row, ctx, }: {
+import type { FileTreeRowContext } from './file-tree-row-context.js';
+import type { FileTreeEntryRow } from './types.js';
+/**
+ * 一条条目行：展开箭头、图标、名称、行内说明、行尾指示器与悬停浮层。
+ *
+ * One entry row: chevron, icon, name, inline description, the row-end indicator
+ * and the hover tooltip.
+ */
+export declare function FileTreeRowView({ row, ctx, }: {
     row: FileTreeEntryRow;
     ctx: FileTreeRowContext;
 }): import("react").JSX.Element;

package/dist/components/file-tree/file-tree-icons.d.ts

@@ -1,8 +1,15 @@
-export declare function Chevron({ expanded }: {
-    expanded: boolean;
+/**
+ * 文件夹图标。展开态与收起态叠放在一起交叉淡入，和宿主一致。
+ *
+ * The folder icon. The open and collapsed states sit stacked and cross-fade,
+ * matching the host tree.
+ */
+export declare function FileTreeFolderIcon({ open }: {
+    open: boolean;
 }): import("react").JSX.Element;
-export declare function FolderIcon({ open }: {
+/** 宿主没有提供 `renderRowIcon` 时的文件图标。Fallback file icon. */
+export declare function FileTreeFileIcon(): import("react").JSX.Element;
+/** 展开箭头，展开时旋转 90°。The expand chevron, rotated when open. */
+export declare function FileTreeChevron({ open }: {
     open: boolean;
 }): import("react").JSX.Element;
-export declare function FileIcon(): import("react").JSX.Element;
-export declare function Spinner(): import("react").JSX.Element;

package/dist/components/file-tree/file-tree-info-labels.d.ts

@@ -0,0 +1,21 @@
+import type { FileTreeInfoKey, FileTreeInfoLabels } from './types.js';
+/**
+ * 内置英文文案。`FileTreeLabels.info` 未提供的键沿用这里的值。
+ *
+ * Built-in English copy. Keys missing from `FileTreeLabels.info` fall back here.
+ */
+export declare const DEFAULT_INFO_LABELS: FileTreeInfoLabels;
+/**
+ * 按宿主的覆盖合并内置文案，键为单位。宿主的空字符串表示该键不显示，因此
+ * 合并时保留空串，由渲染方判断。
+ *
+ * Merges host overrides over the built-in copy, key by key. An empty host string
+ * means "hide this key", so it is kept and the renderer decides.
+ *
+ * Returns the copy of one key, or `undefined` when the key is hidden or has no
+ * copy.
+ */
+export declare function resolveInfoCopy(key: FileTreeInfoKey, hostLabels: FileTreeInfoLabels | undefined): {
+    description?: string;
+    triggerBehavior?: string;
+};