@openviking/react 0.1.5 → 0.1.7

package/dist/modules/console.js

@@ -1 +1 @@
-export { Console, useConsole } from "../a~0.js";
+export { Console } from "../a~0.js";

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-data.d.ts

@@ -0,0 +1,9 @@
+import type { OvClient, OvRequestOptions } from '../../client/types.js';
+interface CompileTarget {
+    to: string;
+    conflicts_num?: number;
+    compile_type?: string;
+    initialized?: boolean;
+}
+export declare function readCompileTargets(client: OvClient, rootUri: string, options: OvRequestOptions): Promise<CompileTarget[]>;
+export {};

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

@@ -0,0 +1,8 @@
+import type { FileBrowserDashboardLabels } from './types.js';
+import type { FileBrowserDashboard } from './dashboard-model.js';
+export declare function DashboardIndicator({ dashboard, locale, labels, onOpen, }: {
+    dashboard: FileBrowserDashboard;
+    locale?: 'en-US' | 'zh-CN';
+    labels?: FileBrowserDashboardLabels;
+    onOpen: (uri: string) => void;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,9 @@
+import type { FileBrowserDashboardLabels } from './types.js';
+export declare const dashboardLabels: (locale?: string, labels?: FileBrowserDashboardLabels) => {
+    experienceTitle: string;
+    wikiTitle: string;
+    openExperience: string;
+    openWiki: string;
+    wikiConflicts: string;
+    failed: string;
+};

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

@@ -0,0 +1,17 @@
+import type { FilePreviewTab } from '../../components/file-preview/index.js';
+import type { FileTreeRow } from '../../components/file-tree/index.js';
+export interface FileBrowserDashboard {
+    kind: 'experience' | 'wiki';
+    uri: string;
+    pendingConflicts?: boolean;
+    isRoot?: boolean;
+}
+export declare const dashboardKey: (uri: string) => string;
+export declare const within: (uri: string, root: string) => boolean;
+/** Metadata from the resource wins over a missing/stale configuration registry. */
+export declare function resolveDashboard(uri: string, rows: readonly FileTreeRow[], targets: readonly {
+    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/dashboard-resource.d.ts

@@ -0,0 +1,12 @@
+import type { OvClient, OvRequestOptions } from '../../client/types.js';
+/** Native stat resolves the home alias in the authenticated request scope. */
+export declare function readDashboardStat(client: OvClient, uri: string, options: OvRequestOptions): Promise<{
+    uri: string;
+    isDir: boolean;
+}>;
+export declare function resolveDashboardUri(client: OvClient, uri: string, options: OvRequestOptions): Promise<string>;
+/** Keep native identity and tags together in the query's authenticated scope. */
+export declare function readDashboardHint(client: OvClient, uri: string, options: OvRequestOptions): Promise<{
+    uri: string;
+    tags: string[];
+}>;

package/dist/modules/file-browser/experience-dashboard-pane.d.ts

@@ -0,0 +1,8 @@
+import { type ExperienceDashboardProps } from '../../components/experience-dashboard/index.js';
+import type { OvRequestOptions } from '../../client/types.js';
+type Props = Pick<ExperienceDashboardProps, 'uri' | 'locale' | 'onOpenUri'> & {
+    requestOptions?: OvRequestOptions;
+    refreshGeneration?: number;
+};
+export declare function ExperienceDashboardPane({ uri, locale, requestOptions, refreshGeneration, onOpenUri, }: Props): import("react").JSX.Element;
+export {};

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

@@ -0,0 +1,31 @@
+import type { OvClient, OvRequestOptions } from '../../client/types.js';
+import type { ExperienceTrajectory, ExperienceOutcome, ExperienceItem } from '../../components/experience-dashboard/types.js';
+export declare const EXPERIENCE_PAGE_SIZE = 20;
+export declare const isExperienceDirectory: (uri: string) => boolean;
+export declare const isExperienceFile: (uri: string) => boolean;
+/** Native API date bounds are UTC and inclusive. */
+export declare function experienceDateRange(days: number, now?: Date): {
+    start_date?: undefined;
+    end_date?: undefined;
+} | {
+    start_date: string;
+    end_date: string;
+};
+export declare function readExperiences(client: OvClient, uri: string, page: number, options: OvRequestOptions): Promise<{
+    items: (ExperienceItem & {
+        isDir?: boolean;
+    })[];
+    hasMore: boolean;
+}>;
+export declare function readExperienceSources(client: OvClient, uri: string, options: OvRequestOptions): Promise<ExperienceTrajectory[]>;
+export interface ExperienceTrajectoryPage {
+    items: ExperienceTrajectory[];
+    total: number;
+    has_more: boolean;
+}
+export interface ExperienceOutcomeResult {
+    outcome_distribution: {
+        outcome: ExperienceOutcome;
+        count: number;
+    }[];
+}

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

@@ -1,5 +1,6 @@
 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';
 /**
  * 详情区：页签行与正文。分段器（预览 / 源码）与右侧图标按钮由这里渲染，通过
@@ -20,6 +21,8 @@ export interface FileBrowserDetailProps {
     locale: Locale;
     labels?: FileBrowserLabels['preview'];
     footer?: string;
+    titleExtra?: ReactNode;
+    extraActions?: ReactNode;
     /** 分段器与图标按钮的文案。Copy for the segmented control and icon buttons. */
     viewLabels: {
         preview: string;
@@ -31,4 +34,4 @@ export interface FileBrowserDetailProps {
     };
     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, viewLabels, 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'>;
+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

@@ -1,7 +1,7 @@
 import type { Locale } from '../../shared/locale.js';
 import type { FileBrowserEntriesProps } from '../../components/file-browser-entries/index.js';
 import type { FileTreeLabels } from '../../components/file-tree/index.js';
-import type { FileBrowserApi } from './types.js';
+import type { FileBrowserApi, FileBrowserDashboardLabels } from './types.js';
 /**
  * 左栏：内置入口条、搜索行与目录树。
  *
@@ -17,16 +17,13 @@ import type { FileBrowserApi } from './types.js';
 export interface FileBrowserTreePaneProps {
     entries: Pick<FileBrowserEntriesProps, 'agentConnect' | 'onImportResources' | 'renderImportResources' | 'labels'>;
     locale: Locale;
-    searchId: string;
+    dashboardLabels?: FileBrowserDashboardLabels;
+    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, 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, 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, onUriChange, onImportResources, renderImportResources, labels, requestOptions, className, style, ...rest }: FileBrowserProps): import("react").JSX.Element;

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

@@ -31,3 +31,12 @@ export declare function knownFiles(dirs: Record<string, DirState>): ReadonlySet<
  * set, so it stays stable for one load result and can be used as a dependency.
  */
 export declare function useKnownFile(dirs: Record<string, DirState>): (uri: string) => boolean;
+/** Loaded resource metadata survives collapsed ancestors, unlike the visible rows. */
+export declare function useTreeMetadata(rootUri: string, dirs: Record<string, DirState>): {
+    directoryUris: ReadonlySet<string>;
+    isKnownFile: (uri: string) => boolean;
+    metadataRows: (import("../../components/file-tree/types.js").FileTreeEntryRow & {
+        tags?: readonly string[];
+    })[];
+    accessOf: (uri: string | null) => "container" | "denied" | undefined;
+};