@openviking/react 0.1.6 → 0.1.8-beta.10.1.g8e5299efeb0a

package/dist/modules/file-browser/acl/acl-add-principal.d.ts

@@ -0,0 +1,12 @@
+import type { OvIdentityValue } from '../../../client/types.js';
+import type { FileBrowserAclContext, FileBrowserAclEntry, FileBrowserAclOptions } from '../acl-types.js';
+import type { AclText } from './acl-labels.js';
+export declare function AclAddPrincipal({ entries, text, disabled, context, accountId, options, onAdd, }: {
+    entries: FileBrowserAclEntry[];
+    text: AclText;
+    disabled: boolean;
+    context: FileBrowserAclContext;
+    accountId?: OvIdentityValue;
+    options?: FileBrowserAclOptions;
+    onAdd: (entries: FileBrowserAclEntry[]) => void;
+}): import("react").JSX.Element;

package/dist/modules/file-browser/acl/acl-candidate.d.ts

@@ -0,0 +1,8 @@
+import type { FileBrowserAclLevel } from '../acl-types.js';
+import type { AclText } from './acl-labels.js';
+export declare function AclCandidate({ principal, level, text, onChange, }: {
+    principal: string;
+    level?: FileBrowserAclLevel;
+    text: AclText;
+    onChange: (level?: FileBrowserAclLevel) => void;
+}): import("react").JSX.Element;

package/dist/modules/file-browser/acl/acl-client.d.ts

@@ -0,0 +1,13 @@
+import type { OvClient, OvIdentityValue, OvRequestOptions } from '../../../client/types.js';
+import type { FileBrowserAclContext, FileBrowserAclPrincipalPage, FileBrowserAclReport } from '../acl-types.js';
+export declare const readAcl: (client: OvClient, uri: string, options: OvRequestOptions) => Promise<FileBrowserAclReport>;
+export declare function readPermission(client: OvClient, uri: string, options: OvRequestOptions): Promise<import("../acl-types.js").FileBrowserAclLevel | undefined>;
+export declare function writeAcl(client: OvClient, uri: string, options: OvRequestOptions, change?: Pick<FileBrowserAclReport, 'direct_entries'> & {
+    mode: 'inherit' | 'restricted';
+}): Promise<FileBrowserAclReport>;
+export declare function identityValue(value: OvIdentityValue | undefined): Promise<string>;
+export declare function listPrincipals(query: {
+    type: 'user' | 'group';
+    keyword: string;
+    page: number;
+}, context: FileBrowserAclContext, accountId: OvIdentityValue | undefined): Promise<FileBrowserAclPrincipalPage>;

package/dist/modules/file-browser/acl/acl-confirmation.d.ts

@@ -0,0 +1,6 @@
+import type { AclText } from './acl-labels.js';
+import type { AclModel } from './use-acl-report.js';
+export declare function AclConfirmation({ model, text, }: {
+    model: AclModel;
+    text: AclText;
+}): import("react").JSX.Element;

package/dist/modules/file-browser/acl/acl-entry.d.ts

@@ -0,0 +1,13 @@
+import type { FileBrowserAclEntry, FileBrowserAclLevel } from '../acl-types.js';
+import type { AclText } from './acl-labels.js';
+export declare function AclAvatar({ principal }: {
+    principal: string;
+}): import("react").JSX.Element;
+export declare function AclEntry({ entry, source, text, disabled, onChange, onRemove, }: {
+    entry: FileBrowserAclEntry;
+    source?: string;
+    text: AclText;
+    disabled: boolean;
+    onChange: (level: FileBrowserAclLevel) => void;
+    onRemove: () => void;
+}): import("react").JSX.Element;

package/dist/modules/file-browser/acl/acl-labels.d.ts

@@ -0,0 +1,47 @@
+import { type Locale } from '../../../shared/locale.js';
+import type { FileBrowserAclLabels, FileBrowserAclLevel } from '../acl-types.js';
+export type AclText = Required<FileBrowserAclLabels>;
+export declare const aclLabels: (locale: Locale, labels?: FileBrowserAclLabels) => {
+    title: string;
+    manage: string;
+    read: string;
+    write: string;
+    manageLevel: string;
+    readDescription: string;
+    writeDescription: string;
+    manageDescription: string;
+    effectivePermission: string;
+    addPrincipal: string;
+    search: string;
+    users: string;
+    groups: string;
+    allUsers: string;
+    administrator: string;
+    administratorDescription: string;
+    direct: string;
+    inherited: string;
+    remove: string;
+    add: string;
+    cancel: string;
+    confirm: string;
+    close: string;
+    retry: string;
+    loadMore: string;
+    loading: string;
+    saving: string;
+    saved: string;
+    loadFailed: string;
+    saveFailed: string;
+    principalsFailed: string;
+    empty: string;
+    noMatches: string;
+    restricted: string;
+    restore: string;
+    stopTitle: string;
+    stopDescription: string;
+    restoreTitle: string;
+    restoreDescription: string;
+    restoreRemoved: string;
+    readOnly: string;
+};
+export declare const levelLabel: (level: FileBrowserAclLevel, text: AclText) => string;

package/dist/modules/file-browser/acl/acl-menu.d.ts

@@ -0,0 +1,10 @@
+import type { FileBrowserAclLevel } from '../acl-types.js';
+import { type AclText } from './acl-labels.js';
+export declare function AclMenu({ level, text, name, disabled, onChange, onRemove, }: {
+    level: FileBrowserAclLevel;
+    text: AclText;
+    name: string;
+    disabled?: boolean;
+    onChange: (level: FileBrowserAclLevel) => void;
+    onRemove?: () => void;
+}): import("react").JSX.Element;

package/dist/modules/file-browser/acl/acl-modal.d.ts

@@ -0,0 +1,17 @@
+import { type RefObject } from 'react';
+import type { Locale } from '../../../shared/locale.js';
+import type { OvIdentityValue } from '../../../client/types.js';
+import type { FileBrowserAclContext, FileBrowserAclOptions, FileBrowserAclReport } from '../acl-types.js';
+import { type AclText } from './acl-labels.js';
+export declare function AclModal({ uri, open, text, locale, context, triggerRef, accountId, options, onClose, onUpdated, }: {
+    uri: string;
+    open: boolean;
+    text: AclText;
+    locale: Locale;
+    context: FileBrowserAclContext;
+    triggerRef: RefObject<HTMLButtonElement | null>;
+    accountId?: OvIdentityValue;
+    options?: FileBrowserAclOptions;
+    onClose: () => void;
+    onUpdated: (report: FileBrowserAclReport) => void;
+}): import("react").JSX.Element;

package/dist/modules/file-browser/acl/acl-model.d.ts

@@ -0,0 +1,17 @@
+import type { FileBrowserAclEntry as Entry, FileBrowserAclLevel as Level, FileBrowserAclReport as Report } from '../acl-types.js';
+export declare const LEVELS: readonly Level[];
+export declare const isLevel: (value: unknown) => value is Level;
+export declare function isAclTarget(uri: string | null): uri is string;
+export declare function normalizeEntries(entries: readonly Entry[]): Entry[];
+export declare function parseReport(value: unknown, uri: string): Report;
+/** Increases preserve inheritance; reducing an inherited grant needs a restricted boundary. */
+export declare function planChange(report: Report, next: Entry[]): {
+    entries: Entry[];
+    mode: 'restricted';
+    confirmation: boolean;
+} | {
+    entries: Entry[];
+    mode: 'inherit';
+    confirmation: boolean;
+};
+export declare function restoreDiff(report: Report): Entry[];

package/dist/modules/file-browser/acl/acl-principal-tabs.d.ts

@@ -0,0 +1,6 @@
+import type { AclText } from './acl-labels.js';
+export declare function AclPrincipalTabs({ type, text, onChange, }: {
+    type: 'user' | 'group';
+    text: AclText;
+    onChange: (type: 'user' | 'group') => void;
+}): import("react").JSX.Element;

package/dist/modules/file-browser/acl/acl-tag.d.ts

@@ -0,0 +1,7 @@
+import type { FileBrowserAclLevel } from '../acl-types.js';
+import { type AclText } from './acl-labels.js';
+export declare function AclTag({ level, text, onManage, }: {
+    level: FileBrowserAclLevel;
+    text: AclText;
+    onManage: () => void;
+}): import("react").JSX.Element;

package/dist/modules/file-browser/acl/locales/en-US.d.ts

@@ -0,0 +1,44 @@
+declare const _default: {
+    title: string;
+    manage: string;
+    read: string;
+    write: string;
+    manageLevel: string;
+    readDescription: string;
+    writeDescription: string;
+    manageDescription: string;
+    effectivePermission: string;
+    addPrincipal: string;
+    search: string;
+    users: string;
+    groups: string;
+    allUsers: string;
+    administrator: string;
+    administratorDescription: string;
+    direct: string;
+    inherited: string;
+    remove: string;
+    add: string;
+    cancel: string;
+    confirm: string;
+    close: string;
+    retry: string;
+    loadMore: string;
+    loading: string;
+    saving: string;
+    saved: string;
+    loadFailed: string;
+    saveFailed: string;
+    principalsFailed: string;
+    empty: string;
+    noMatches: string;
+    restricted: string;
+    restore: string;
+    stopTitle: string;
+    stopDescription: string;
+    restoreTitle: string;
+    restoreDescription: string;
+    restoreRemoved: string;
+    readOnly: string;
+};
+export default _default;

package/dist/modules/file-browser/acl/locales/zh-CN.d.ts

@@ -0,0 +1,44 @@
+declare const _default: {
+    title: string;
+    manage: string;
+    read: string;
+    write: string;
+    manageLevel: string;
+    readDescription: string;
+    writeDescription: string;
+    manageDescription: string;
+    effectivePermission: string;
+    addPrincipal: string;
+    search: string;
+    users: string;
+    groups: string;
+    allUsers: string;
+    administrator: string;
+    administratorDescription: string;
+    direct: string;
+    inherited: string;
+    remove: string;
+    add: string;
+    cancel: string;
+    confirm: string;
+    close: string;
+    retry: string;
+    loadMore: string;
+    loading: string;
+    saving: string;
+    saved: string;
+    loadFailed: string;
+    saveFailed: string;
+    principalsFailed: string;
+    empty: string;
+    noMatches: string;
+    restricted: string;
+    restore: string;
+    stopTitle: string;
+    stopDescription: string;
+    restoreTitle: string;
+    restoreDescription: string;
+    restoreRemoved: string;
+    readOnly: string;
+};
+export default _default;

package/dist/modules/file-browser/acl/use-acl-principals.d.ts

@@ -0,0 +1,17 @@
+import type { OvIdentityValue } from '../../../client/types.js';
+import type { FileBrowserAclContext, FileBrowserAclOptions } from '../acl-types.js';
+export declare function useAclPrincipals({ open, type, keyword, context, accountId, options, }: {
+    open: boolean;
+    type: 'user' | 'group';
+    keyword: string;
+    context: FileBrowserAclContext;
+    accountId?: OvIdentityValue;
+    options?: FileBrowserAclOptions;
+}): {
+    items: string[];
+    loading: boolean;
+    error: Error | undefined;
+    hasMore: boolean;
+    more: () => void;
+    retry: () => void;
+};

package/dist/modules/file-browser/acl/use-acl-report.d.ts

@@ -0,0 +1,27 @@
+import type { FileBrowserAclContext, FileBrowserAclEntry, FileBrowserAclReport } from '../acl-types.js';
+type Confirmation = {
+    kind: 'restrict';
+    entries: FileBrowserAclEntry[];
+} | {
+    kind: 'restore';
+};
+export declare function useAclReport({ uri, context, open, readOnly, onUpdated, }: {
+    uri: string;
+    context: FileBrowserAclContext;
+    open: boolean;
+    readOnly: boolean;
+    onUpdated: (report: FileBrowserAclReport) => void;
+}): {
+    report: FileBrowserAclReport | undefined;
+    confirmation: Confirmation | undefined;
+    error: Error | undefined;
+    phase: "loading" | "ready" | "saving";
+    saved: boolean;
+    retry: () => void;
+    change: (entries: FileBrowserAclEntry[]) => void;
+    restore: () => void;
+    cancel: () => void;
+    confirm: () => void;
+};
+export type AclModel = ReturnType<typeof useAclReport>;
+export {};

package/dist/modules/file-browser/acl-types.d.ts

@@ -0,0 +1,86 @@
+import type { OvClient, OvRequestOptions } from '../../client/types.js';
+export type FileBrowserAclLevel = 'read' | 'write' | 'manage';
+export interface FileBrowserAclEntry {
+    principal: string;
+    level: FileBrowserAclLevel;
+}
+export interface FileBrowserAclReport {
+    uri: string;
+    acl_mode: 'none' | 'inherit' | 'restricted';
+    direct_entries: FileBrowserAclEntry[];
+    inherited_entries: FileBrowserAclEntry[];
+    effective_entries: FileBrowserAclEntry[];
+}
+export interface FileBrowserAclContext {
+    client: OvClient;
+    requestOptions: OvRequestOptions;
+}
+export interface FileBrowserAclPrincipalPage {
+    principals: string[];
+    hasMore: boolean;
+}
+/** Optional integration where a service has additional permission metadata. */
+export interface FileBrowserAclOptions {
+    /** 禁止授权修改，仍可查看。Prevent mutations while retaining the grant list. */
+    readOnly?: boolean;
+    /**
+     * 自身有效权限；默认先读 fs/stat.permission，缺失时仅探测管理权限。
+     * Own effective level. Defaults to fs/stat.permission, then a manage-only ACL probe.
+     * No particular user ID is assumed to be an administrator.
+     */
+    resolvePermission?: (uri: string, context: FileBrowserAclContext) => Promise<FileBrowserAclLevel | undefined>;
+    /**
+     * 可选候选目录；默认调用原生账号用户/用户组接口，不读取密钥。
+     * Optional principal directory; defaults to native account APIs without credentials.
+     */
+    listPrincipals?: (query: {
+        type: 'user' | 'group';
+        keyword: string;
+        page: number;
+    }, context: FileBrowserAclContext) => Promise<FileBrowserAclPrincipalPage>;
+    /** 保存成功后的通知；失败不触发。Notification after a successful ACL mutation. */
+    onChange?: (report: FileBrowserAclReport) => void;
+}
+export interface FileBrowserAclLabels {
+    title?: string;
+    manage?: string;
+    read?: string;
+    write?: string;
+    manageLevel?: string;
+    readDescription?: string;
+    writeDescription?: string;
+    manageDescription?: string;
+    effectivePermission?: string;
+    addPrincipal?: string;
+    search?: string;
+    users?: string;
+    groups?: string;
+    allUsers?: string;
+    administrator?: string;
+    administratorDescription?: string;
+    direct?: string;
+    inherited?: string;
+    remove?: string;
+    add?: string;
+    cancel?: string;
+    confirm?: string;
+    close?: string;
+    retry?: string;
+    loadMore?: string;
+    loading?: string;
+    saving?: string;
+    saved?: string;
+    loadFailed?: string;
+    saveFailed?: string;
+    principalsFailed?: string;
+    empty?: string;
+    noMatches?: string;
+    restricted?: string;
+    restore?: string;
+    stopTitle?: string;
+    stopDescription?: string;
+    restoreTitle?: string;
+    restoreDescription?: string;
+    restoreRemoved?: string;
+    readOnly?: string;
+}

package/dist/modules/file-browser/dashboard-model.d.ts

@@ -1,3 +1,4 @@
+import type { FilePreviewTab } from '../../components/file-preview/index.js';
 import type { FileTreeRow } from '../../components/file-tree/index.js';
 export interface FileBrowserDashboard {
     kind: 'experience' | 'wiki';
@@ -12,3 +13,5 @@ export declare function resolveDashboard(uri: string, rows: readonly FileTreeRow
     to: string;
     conflicts_num?: number;
 }[]): FileBrowserDashboard | undefined;
+/** Keep the normal tabs when no board is open, and suppress all detail tabs for blocked resources. */
+export declare function mergeDashboardTab(tabs: readonly FilePreviewTab[] | null, dashboard: FilePreviewTab | undefined, blocked: boolean): readonly FilePreviewTab[] | null;

package/dist/modules/file-browser/file-browser-detail-icons.d.ts

@@ -1,10 +1,4 @@
-/** 复制图标。Copy icon. */
-export declare function CopyIcon({ size }: {
-    size?: number;
-}): import("react").JSX.Element;
 /** 历史图标。History icon. */
 export declare function HistoryIcon(): import("react").JSX.Element;
 /** 看板图标。Dashboard icon. */
 export declare function DashboardIcon(): import("react").JSX.Element;
-/** 下载图标。Download icon. */
-export declare function DownloadIcon(): import("react").JSX.Element;

package/dist/modules/file-browser/file-browser-detail.d.ts

@@ -1,34 +1,16 @@
 import type { Locale } from '../../shared/locale.js';
 import { type FilePreviewTab } from '../../components/file-preview/index.js';
+import type { ReactNode } from 'react';
 import type { FileBrowserLabels } from './types.js';
-/**
- * 详情区：页签行与正文。分段器（预览 / 源码）与右侧图标按钮由这里渲染，通过
- * `slots.actions` 拿到预览的视图状态。
- *
- * 目录的摘要层级不在这里——它是 `directory` 页签内部的一层，由组件自己渲染。
- *
- * The detail pane: tab row and body. The segmented control (preview / source) and
- * the icon buttons on the right are rendered here, reading the view state from the
- * preview through `slots.actions`.
- *
- * A directory's summary levels are not here: they are a layer inside the
- * `directory` tab, rendered by the component itself.
- */
 export interface FileBrowserDetailProps {
     tabs: readonly FilePreviewTab[];
     activeKey: string | null;
     locale: Locale;
     labels?: FileBrowserLabels['preview'];
     footer?: string;
-    /** 分段器与图标按钮的文案。Copy for the segmented control and icon buttons. */
-    viewLabels: {
-        preview: string;
-        source: string;
-        copyPath: string;
-        copyContent: string;
-        download: string;
-        viewSwitch: string;
-    };
+    titleExtra?: ReactNode;
+    extraActions?: ReactNode;
+    readOnly?: boolean;
     onActiveKeyChange: (key: string) => void;
 }
-export declare function FileBrowserDetail({ tabs, activeKey, locale, labels, footer, viewLabels, onActiveKeyChange, }: FileBrowserDetailProps): import("react").JSX.Element;
+export declare function FileBrowserDetail({ tabs, activeKey, locale, labels, footer, titleExtra, extraActions, readOnly, onActiveKeyChange, }: FileBrowserDetailProps): import("react").JSX.Element;

package/dist/modules/file-browser/file-browser-labels.d.ts

@@ -3,7 +3,7 @@ import type { FilePreviewLabels } from '../../components/file-preview/index.js';
 import type { FileTreeLabels } from '../../components/file-tree/index.js';
 import type { FileBrowserLabels } from './types.js';
 /** 模块外壳自己渲染的文案，其余透传给树与预览。 */
-export type ShellLabels = Omit<FileBrowserLabels, 'tree' | 'preview' | 'entries' | 'dashboard'>;
+export type ShellLabels = Omit<FileBrowserLabels, 'tree' | 'preview' | 'entries' | 'dashboard' | 'acl'>;
 /**
  * 模块外壳的内置文案。树与预览的默认值留在各自组件里，模块不重复一份。
  * Built-in copy of the module shell. The tree and the preview keep their own

package/dist/modules/file-browser/file-browser-search.d.ts

@@ -0,0 +1,20 @@
+import { type RefObject } from 'react';
+import type { OvRequestOptions } from '../../client/types.js';
+import type { Locale } from '../../shared/locale.js';
+import type { ResolvedLabels } from './file-browser-labels.js';
+interface FileBrowserSearchProps {
+    open: boolean;
+    rootUri: string;
+    triggerRef: RefObject<HTMLElement | null>;
+    locale: Locale;
+    text: ResolvedLabels;
+    requestOptions?: OvRequestOptions;
+    onClose: () => void;
+}
+/**
+ * TODO: 占位搜索弹窗，目前只提交关键词并展示原生接口结果。
+ * 后续补齐筛选、分页、结果定位和快捷键；此视图仅供 FileBrowser 内部使用。
+ * Placeholder: query submission and results only; richer search interactions follow.
+ */
+export declare function FileBrowserSearch({ open, rootUri, triggerRef, locale, text, requestOptions, onClose, }: FileBrowserSearchProps): import("react").JSX.Element;
+export {};

package/dist/modules/file-browser/file-browser-toolbar.d.ts

@@ -1,17 +1,10 @@
-/**
- * 搜索行：搜索框与刷新按钮。内置的连接与导入入口位于上一行。
- *
- * The search row: the search box and refresh button. Built-in connection and import
- * entries occupy the row above.
- */
+/** Host-owned search intent and module-owned refresh share the file-tree controls. */
 export interface FileBrowserToolbarProps {
-    searchId: string;
-    query: string;
     refreshing: boolean;
     canRefresh: boolean;
     placeholder: string;
     refreshLabel: string;
-    onQueryChange: (value: string) => void;
+    onSearch?: () => void;
     onRefresh: () => void;
 }
-export declare function FileBrowserToolbar({ searchId, query, refreshing, canRefresh, placeholder, refreshLabel, onQueryChange, onRefresh, }: FileBrowserToolbarProps): import("react").JSX.Element;
+export declare function FileBrowserToolbar({ refreshing, canRefresh, placeholder, refreshLabel, onSearch, onRefresh, }: FileBrowserToolbarProps): import("react").JSX.Element;

package/dist/modules/file-browser/file-browser-tree-pane.d.ts

@@ -18,16 +18,12 @@ export interface FileBrowserTreePaneProps {
     entries: Pick<FileBrowserEntriesProps, 'agentConnect' | 'onImportResources' | 'renderImportResources' | 'labels'>;
     locale: Locale;
     dashboardLabels?: FileBrowserDashboardLabels;
-    searchId: string;
+    onSearch?: () => void;
     browser: FileBrowserApi;
     treeLabels: FileTreeLabels | undefined;
     searchPlaceholder: string;
     refreshLabel: string;
-    searchLoading: string;
-    searchEmpty: string;
-    /** 搜索失败时的结论文案。Conclusion shown when the search request fails. */
-    searchErrorLabel: string;
     /** 失败态里的重试按钮。Retry button of the failure state. */
     retryLabel: string;
 }
-export declare function FileBrowserTreePane({ entries, locale, dashboardLabels, searchId, browser, treeLabels, searchPlaceholder, refreshLabel, searchLoading, searchEmpty, searchErrorLabel, retryLabel, }: FileBrowserTreePaneProps): import("react").JSX.Element;
+export declare function FileBrowserTreePane({ entries, locale, dashboardLabels, onSearch, browser, treeLabels, searchPlaceholder, refreshLabel, retryLabel, }: FileBrowserTreePaneProps): import("react").JSX.Element;

package/dist/modules/file-browser/file-browser.d.ts

@@ -12,4 +12,4 @@ export type { FileBrowserActions, FileBrowserApi, FileBrowserLabels, FileBrowser
  * tree; loading and coordination live in {@link useFileBrowser}, and this only
  * assembles the view.
  */
-export declare function FileBrowser({ uri, defaultUri, rootUri, defaultExpandedUri, locale: localeProp, agentConnect, dashboardKinds, renderDashboard, onUriChange, onImportResources, renderImportResources, labels, requestOptions, className, style, ...rest }: FileBrowserProps): import("react").JSX.Element;
+export declare function FileBrowser({ uri, defaultUri, rootUri, defaultExpandedUri, locale: localeProp, agentConnect, dashboardKinds, renderDashboard, acl, readOnly, onUriChange, onImportResources, renderImportResources, labels, requestOptions, className, style, ...rest }: FileBrowserProps): import("react").JSX.Element;

package/dist/modules/file-browser/fs-directories.d.ts

@@ -38,4 +38,5 @@ export declare function useTreeMetadata(rootUri: string, dirs: Record<string, Di
     metadataRows: (import("../../components/file-tree/types.js").FileTreeEntryRow & {
         tags?: readonly string[];
     })[];
+    accessOf: (uri: string | null) => "container" | "denied" | undefined;
 };

package/dist/modules/file-browser/fs-file-editing.d.ts

@@ -0,0 +1,4 @@
+import type { OvClient, OvRequestOptions } from '../../client/types.js';
+import type { FilePreviewEditing } from '../../components/file-preview/index.js';
+/** Load the full file before editing; the preview can contain only its first page. */
+export declare function createFileEditing(client: OvClient, uri: string, name: string, options: OvRequestOptions, onSave?: () => void): FilePreviewEditing | undefined;

package/dist/modules/file-browser/fs-model.d.ts

@@ -13,6 +13,8 @@ export interface FsEntry {
     modTime?: string;
     abstract?: string;
     tags?: readonly string[];
+    access?: 'denied' | 'container';
+    permission?: 'read' | 'write' | 'manage';
 }
 /** 一个目录已加载的子节点与分页状态。 */
 export interface DirState {
@@ -113,4 +115,4 @@ export declare function flattenTree(uri: string, depth: number, dirs: Record<str
 /** 请求被取消时不需要写回状态。A cancelled request has no state to write. */
 export declare function isAbort(error: unknown): boolean;
 /** 把任意抛出物归一成 Error。Normalises a thrown value into an Error. */
-export declare function toError(cause: unknown): Error;
+export declare const toError: (cause: unknown) => Error;

package/dist/modules/file-browser/fs-preview-images.d.ts

@@ -0,0 +1,3 @@
+import type { OvClient, OvRequestOptions } from '../../client/types.js';
+import type { FilePreviewFileTab } from '../../components/file-preview/index.js';
+export declare function createPreviewImageResolver(client: OvClient, uri: string, directory: boolean, options: OvRequestOptions): NonNullable<FilePreviewFileTab['resolveImage']>;

package/dist/modules/file-browser/fs-read-file.d.ts

@@ -11,4 +11,4 @@ export declare const MAX_LINES = 2000;
  * through `content/download` for the raw bytes: the former returns content as
  * text, so a binary file only yields mojibake and images or PDFs never render.
  */
-export declare function readFile(client: OvClient, uri: string, options: OvRequestOptions, openParent?: (uri: string) => Promise<void>): Promise<FilePreviewFileTab>;
+export declare function readFile(client: OvClient, uri: string, options: OvRequestOptions, openParent?: (uri: string) => Promise<void>, onSave?: () => void): Promise<FilePreviewFileTab>;

package/dist/modules/file-browser/index.d.ts

@@ -1,3 +1,4 @@
 export { FileBrowser } from './file-browser.js';
 export type { FileBrowserLabels, FileBrowserDashboardLabels, FileBrowserProps, } from './types.js';
 export type { FileBrowserDashboard } from './dashboard-model.js';
+export type { FileBrowserAclLevel, FileBrowserAclEntry, FileBrowserAclReport, FileBrowserAclContext, FileBrowserAclPrincipalPage, FileBrowserAclOptions, FileBrowserAclLabels, } from './acl-types.js';

package/dist/modules/file-browser/locales/en-US.d.ts

@@ -1,10 +1,15 @@
 declare const messages: {
     formatCharacterCount: (count: number) => string;
+    accessDenied: string;
+    traverseOnly: string;
     empty: string;
     error: string;
     retry: string;
     refresh: string;
     searchPlaceholder: string;
+    searchTitle: string;
+    searchAction: string;
+    searchHint: string;
     searchEmpty: string;
     searchFailed: string;
     loading: string;

package/dist/modules/file-browser/locales/zh-CN.d.ts

@@ -1,10 +1,15 @@
 declare const messages: {
     formatCharacterCount: (count: number) => string;
+    accessDenied: string;
+    traverseOnly: string;
     empty: string;
     error: string;
     retry: string;
     refresh: string;
     searchPlaceholder: string;
+    searchTitle: string;
+    searchAction: string;
+    searchHint: string;
     searchEmpty: string;
     searchFailed: string;
     loading: string;