@openviking/react 0.1.5 → 0.1.7

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

@@ -1,9 +1,11 @@
 import type { Locale } from '../../shared/locale.js';
 import type { AgentConnectProps } from '../../components/agent-connect/index.js';
 import type { FileBrowserEntriesLabels } from '../../components/file-browser-entries/index.js';
+import type { FileBrowserDashboard } from './dashboard-model.js';
 import type { FilePreviewLabels, FilePreviewTab } from '../../components/file-preview/index.js';
 import type { FileTreeEntryRow, FileTreeLabels, FileTreeRow } from '../../components/file-tree/index.js';
 import type { OvRequestOptions } from '../../client/index.js';
+import type { FileBrowserAclLabels, FileBrowserAclOptions } from './acl-types.js';
 import type { ComponentPropsWithRef, HTMLAttributes, ReactElement, ReactNode } from 'react';
 /**
  * 文件浏览模块的可替换文案。入口、树与预览的文案分别透传，模块外壳只提供
@@ -13,7 +15,19 @@ import type { ComponentPropsWithRef, HTMLAttributes, ReactElement, ReactNode } f
  * passed through as-is; the module shell only carries the strings
  * it renders itself.
  */
+export interface FileBrowserDashboardLabels {
+    experienceTitle?: string;
+    wikiTitle?: string;
+    openExperience?: string;
+    openWiki?: string;
+    wikiConflicts?: string;
+    failed?: string;
+}
 export interface FileBrowserLabels {
+    accessDenied?: string;
+    traverseOnly?: string;
+    /** 权限管理文案。Permission management copy. */
+    acl?: FileBrowserAclLabels;
     /** 预览底部字符数。Character count in the preview footer. */
     formatCharacterCount?: (count: number) => string;
     /** 未选中资源时的提示。Message shown when no resource is selected. */
@@ -24,8 +38,14 @@ export interface FileBrowserLabels {
     retry?: string;
     /** 刷新按钮的无障碍名称。Accessible name of the refresh control. */
     refresh?: string;
-    /** 搜索框占位文案。Search placeholder. */
+    /** 搜索入口的占位文案。Placeholder of the search trigger. */
     searchPlaceholder?: string;
+    /** 内置搜索弹窗标题。Title of the built-in search dialog. */
+    searchTitle?: string;
+    /** 搜索提交按钮。Search submit button. */
+    searchAction?: string;
+    /** 尚未提交查询时的提示。Hint before a query is submitted. */
+    searchHint?: string;
     /** 搜索无结果提示。Message shown when a search returns nothing. */
     searchEmpty?: string;
     /** 搜索请求失败的结论，原因由服务端返回。Conclusion when the search request fails; the reason comes from the server. */
@@ -69,6 +89,7 @@ export interface FileBrowserLabels {
     entries?: FileBrowserEntriesLabels;
     /** 目录树文案。Copy of the file tree. */
     tree?: FileTreeLabels;
+    dashboard?: FileBrowserDashboardLabels;
     /** 预览文案。Copy of the file preview. */
     preview?: FilePreviewLabels;
 }
@@ -77,7 +98,7 @@ export interface FileBrowserLabels {
  *
  * 模块自己通过 Hook 取数，props 里没有数据字段：宿主给配置、受控的当前资源、
  * 接入配置、导入交互、文案与请求配置。入口条、目录、搜索、预览页签与行级
- * 状态都在模块内维护。
+ * 状态都在模块内维护，包含基础搜索弹窗与接口调用。
  *
  * 模块包含文件树、文件预览与顶部入口。命令面板属于 `console`。
  *
@@ -86,12 +107,17 @@ export interface FileBrowserLabels {
  * The module loads its own data through a Hook, so no prop carries data: the
  * host supplies configuration, the controlled current resource, import interactions,
  * copy and request configuration. The entry row, directory, search, preview tabs
- * and per-row state all live inside the module.
+ * and per-row state all live inside the module, including basic search UI and requests.
  *
  * The module includes the file tree, file preview and top entries. The command panel
  * belongs to `console`.
  */
 export interface FileBrowserProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onSelect' | 'children'> {
+    /**
+     * 共享资源 ACL；默认关闭。开启后显示有效权限并通过 Modal 管理授权。
+     * Shared-resource ACL, off by default. Shows effective permissions and manages grants in a Modal.
+     */
+    acl?: boolean | FileBrowserAclOptions;
     /** 可选文案语言；继承上层，最终默认英文。Optional locale; inherits or defaults to en-US. */
     locale?: Locale;
     /**
@@ -135,6 +161,8 @@ export interface FileBrowserProps extends Omit<HTMLAttributes<HTMLDivElement>, '
      * Configuration of the built-in connection drawer; enables its entry when provided.
      */
     agentConnect?: AgentConnectProps;
+    /** Host capability filter. Omitted enables both; an empty array disables discovery. */
+    dashboardKinds?: readonly FileBrowserDashboard['kind'][];
     /**
      * 当前资源变化后触发，参数为新的 URI。
      *
@@ -149,6 +177,8 @@ export interface FileBrowserProps extends Omit<HTMLAttributes<HTMLDivElement>, '
      * pane.
      */
     onUriChange?: (uri: string | null) => void;
+    /** Host gateway/view override; nullish values retain the native dashboard. */
+    renderDashboard?: (dashboard: FileBrowserDashboard) => ReactNode;
     /**
      * 默认导入按钮的点击回调，单独传入即可显示导入入口。
      * Click handler of the default import button; enables its entry on its own.
@@ -183,18 +213,14 @@ export interface FileBrowserProps extends Omit<HTMLAttributes<HTMLDivElement>, '
  * own view from these without the composite one.
  */
 export interface FileBrowserApi {
+    dashboards: ReadonlyMap<string, FileBrowserDashboard>;
+    dashboardError: Error | null;
     /** 按渲染顺序排列的可见行。Visible rows in render order. */
     rows: readonly FileTreeRow[];
     /** 当前选中的行 id。Selected row id. */
     selectedId: string | null;
     /** 当前资源 URI。Current resource URI. */
     currentUri: string | null;
-    /** 当前查询词。The current query. */
-    query: string;
-    /** 是否正在展示搜索结果。Whether search results are showing. */
-    searching: boolean;
-    /** 搜索是否进行中。Whether a search is running. */
-    searchLoading: boolean;
     /** 刷新是否进行中。Whether a refresh is running. */
     refreshing: boolean;
     /** 预览底部元信息，例如字符数与更新时间；没有时为 `undefined`。 */
@@ -212,15 +238,6 @@ export interface FileBrowserApi {
      * instead of showing a 403 as "no files".
      */
     treeError: Error | null;
-    /**
-     * 搜索请求本身的失败原因。与「搜索成功但没有结果」不同：前者要显示原因与重试，
-     * 后者才是空态文案。
-     *
-     * Why the search request failed. It differs from "the search succeeded but matched
-     * nothing": the former needs the reason and a retry, only the latter is the empty
-     * copy.
-     */
-    searchError: Error | null;
     /**
      * 当前资源预览的失败原因。选中了资源但读不出来时用它区分「读失败」与「什么
      * 都没选」。
@@ -238,6 +255,7 @@ export interface FileBrowserApi {
 }
 /** 模块 Hook 暴露的操作。Operations the module Hook exposes. */
 export interface FileBrowserActions {
+    openDashboard: (uri: string) => void;
     /** 选中条目。Selects an entry. */
     select: (row: FileTreeEntryRow) => Promise<void>;
     /** 展开或折叠目录。Expands or collapses a directory. */
@@ -250,6 +268,50 @@ export interface FileBrowserActions {
     refresh: () => Promise<void>;
     /** 切换预览页签。Switches the preview tab. */
     setPreviewKey: (key: string) => void;
-    /** 更新查询词；空串回到目录树。Updates the query; an empty string returns to the tree. */
-    setQuery: (query: string) => void;
+}
+/** Internal options for the composed FileBrowser loader. */
+export interface UseFileBrowserOptions {
+    rootUri: string;
+    accessLabels?: Pick<FileBrowserLabels, 'accessDenied' | 'traverseOnly'>;
+    /** Built-in copy; inherits the Provider locale, otherwise en-US. */
+    locale?: Locale;
+    dashboardLabels?: FileBrowserDashboardLabels;
+    dashboardKinds?: readonly FileBrowserDashboard['kind'][];
+    renderDashboard?: (dashboard: FileBrowserDashboard) => ReactNode;
+    /**
+     * 宿主是否受控地持有当前资源。受控时 `currentUri` 就是唯一事实；非受控时
+     * `currentUri` 只是初始值，之后的选中由模块自己记在 `pendingUri` 里。
+     *
+     * 两者的区别只在「谁拥有选中」：非受控模块在初始没有选中时 `currentUri` 也是
+     * `null`，因此不能靠值来区分，必须显式声明。
+     *
+     * Whether the host owns the current resource. While controlled, `currentUri` is the
+     * single source of truth; while uncontrolled it is only the initial value and later
+     * selections live in the module's own `pendingUri`.
+     *
+     * The distinction is only about who owns the selection: an uncontrolled module also
+     * has a `null` `currentUri` when nothing is selected initially, so the value itself
+     * cannot tell the two apart and the mode has to be declared.
+     */
+    controlled?: boolean;
+    /**
+     * 目录两级摘要的标题与失败兜底文案。两级摘要各自可能请求失败，失败且服务端没给
+     * 消息时用 `failure` 显示——它必须可替换，否则宿主无法本地化。
+     *
+     * Titles of the two summary levels and the fallback copy for a failure. Either level
+     * can fail; when it fails without a server message, `failure` is shown — it has to be
+     * replaceable, or a host cannot localise it.
+     */
+    summaryLabels?: {
+        l0: string;
+        l1: string;
+        failure: string;
+    };
+    /** 字符数文案；省略时跟随语言。Character count copy; follows the resolved locale. */
+    formatCharacterCount?: (count: number) => string;
+    /** 首次加载后自动展开到的路径。Path to expand to after the first load. */
+    defaultExpandedUri?: string;
+    currentUri: string | null;
+    requestOptions?: OvRequestOptions;
+    onUriChange: (uri: string | null) => void;
 }

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

@@ -0,0 +1,31 @@
+import type { FileBrowserDashboardLabels } from './types.js';
+import { type ReactNode } from 'react';
+import type { OvRequestOptions } from '../../client/types.js';
+import type { FileTreeRow } from '../../components/file-tree/index.js';
+import { type FileBrowserDashboard } from './dashboard-model.js';
+export declare function useBrowserDashboards({ rows, metadataRows, uri, rootUri, generation, locale, requestOptions, onOpenUri, dashboardKinds, renderDashboard, dashboardLabels, }: {
+    rows: readonly FileTreeRow[];
+    metadataRows: readonly FileTreeRow[];
+    uri: string | null;
+    rootUri: string;
+    generation: number;
+    dashboardLabels?: FileBrowserDashboardLabels;
+    dashboardKinds?: readonly FileBrowserDashboard['kind'][];
+    renderDashboard?: (dashboard: FileBrowserDashboard) => ReactNode;
+    locale?: 'en-US' | 'zh-CN';
+    requestOptions?: OvRequestOptions;
+    onOpenUri: (uri: string) => Promise<void>;
+}): {
+    dashboards: Map<string, {
+        kind: 'experience' | 'wiki';
+        pendingConflicts?: boolean;
+        isRoot?: boolean;
+        uri: string;
+    }>;
+    tab: import("../../components/file-preview/types.js").FilePreviewContentTab | undefined;
+    isOpen: boolean;
+    open: (target: string) => void;
+    close: () => void;
+    error: Error | null;
+    retry: () => void;
+};

package/dist/modules/file-browser/use-dashboard-query.d.ts

@@ -0,0 +1,9 @@
+import type { OvClient, OvRequestOptions } from '../../client/types.js';
+export interface DashboardQuery<T> {
+    data?: T;
+    loading: boolean;
+    error: Error | null;
+    retry: () => void;
+}
+/** Instance-local, cancellable queries. A changed identity never exposes old data. */
+export declare function useDashboardQuery<T>(load: (client: OvClient, options: OvRequestOptions) => Promise<T>, requestOptions?: OvRequestOptions, enabled?: boolean, refreshGeneration?: number): DashboardQuery<T>;

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

@@ -0,0 +1,27 @@
+import type { OvRequestOptions } from '../../client/types.js';
+import type { ExperienceTrajectoryPage } from './experience-data.js';
+export declare function useExperienceDashboard({ uri, requestOptions, enabled, refreshGeneration, }: {
+    uri: string;
+    requestOptions?: OvRequestOptions;
+    enabled?: boolean;
+    refreshGeneration?: number;
+}): {
+    list: import("./use-dashboard-query.js").DashboardQuery<{
+        items: (import("../../components/experience-dashboard/types.js").ExperienceItem & {
+            isDir?: boolean;
+        })[];
+        hasMore: boolean;
+    }>;
+    sources: import("./use-dashboard-query.js").DashboardQuery<import("../../components/experience-dashboard/types.js").ExperienceTrajectory[]>;
+    trajectories: import("./use-dashboard-query.js").DashboardQuery<ExperienceTrajectoryPage>;
+    outcomes: import("./use-dashboard-query.js").DashboardQuery<{
+        outcome: import("../../components/experience-dashboard/types.js").ExperienceOutcome;
+        count: number;
+    }[]>;
+    page: number;
+    setPage: (value: number) => void;
+    days: number;
+    setDays: (value: number) => void;
+    tab: "impact" | "source" | "test";
+    setTab: (value: 'impact' | 'source' | 'test') => void;
+};

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

@@ -0,0 +1,15 @@
+import type { OvRequestOptions } from '../../client/types.js';
+import type { Locale } from '../../shared/locale.js';
+import type { FileBrowserAclLabels, FileBrowserAclOptions } from './acl-types.js';
+export declare function useFileBrowserAcl({ uri, acl, locale, labels, requestOptions, refresh, }: {
+    uri: string | null;
+    acl?: boolean | FileBrowserAclOptions;
+    locale: Locale;
+    labels?: FileBrowserAclLabels;
+    requestOptions?: OvRequestOptions;
+    refresh: () => Promise<void>;
+}): {
+    titleExtra: import("react").JSX.Element | null;
+    actions: import("react").JSX.Element | null;
+    drawer: import("react").JSX.Element | null;
+};

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

@@ -1,54 +1,9 @@
-import type { Locale } from '../../shared/locale.js';
-import type { OvRequestOptions } from '../../client/types.js';
-import type { FileBrowserApi } from './types.js';
-export interface UseFileBrowserOptions {
-    rootUri: string;
-    /** Built-in copy; inherits the Provider locale, otherwise en-US. */
-    locale?: Locale;
-    /**
-     * 宿主是否受控地持有当前资源。受控时 `currentUri` 就是唯一事实；非受控时
-     * `currentUri` 只是初始值，之后的选中由模块自己记在 `pendingUri` 里。
-     *
-     * 两者的区别只在「谁拥有选中」：非受控模块在初始没有选中时 `currentUri` 也是
-     * `null`，因此不能靠值来区分，必须显式声明。
-     *
-     * Whether the host owns the current resource. While controlled, `currentUri` is the
-     * single source of truth; while uncontrolled it is only the initial value and later
-     * selections live in the module's own `pendingUri`.
-     *
-     * The distinction is only about who owns the selection: an uncontrolled module also
-     * has a `null` `currentUri` when nothing is selected initially, so the value itself
-     * cannot tell the two apart and the mode has to be declared.
-     */
-    controlled?: boolean;
-    /**
-     * 目录两级摘要的标题与失败兜底文案。两级摘要各自可能请求失败，失败且服务端没给
-     * 消息时用 `failure` 显示——它必须可替换，否则宿主无法本地化。
-     *
-     * Titles of the two summary levels and the fallback copy for a failure. Either level
-     * can fail; when it fails without a server message, `failure` is shown — it has to be
-     * replaceable, or a host cannot localise it.
-     */
-    summaryLabels?: {
-        l0: string;
-        l1: string;
-        failure: string;
-    };
-    /** 字符数文案；省略时跟随语言。Character count copy; follows the resolved locale. */
-    formatCharacterCount?: (count: number) => string;
-    /** 首次加载后自动展开到的路径。Path to expand to after the first load. */
-    defaultExpandedUri?: string;
-    currentUri: string | null;
-    requestOptions?: OvRequestOptions;
-    onUriChange: (uri: string | null) => void;
-}
+import type { FileBrowserApi, UseFileBrowserOptions } from './types.js';
 /**
- * 文件浏览模块的取数与联动：把目录树、搜索与预览组合成一份视图数据。三者各自
- * 取数，这里只负责把它们接起来——目录行展开树，文件行与搜索结果打开预览。
+ * 文件浏览模块的目录与预览联动：目录行展开树，文件行打开预览。
+ * 占位搜索弹窗独立管理查询，不改变目录树。
  *
- * Data loading and coordination of the file browser module: the tree, the search
- * and the preview each load their own data, and this only wires them together —
- * a directory row expands the tree, while a file row or a search result opens
- * the preview.
+ * Coordinates directory loading and preview selection. The placeholder search
+ * dialog owns its query separately and leaves the tree unchanged.
  */
-export declare function useFileBrowser({ rootUri, locale: localeProp, controlled, summaryLabels, formatCharacterCount, defaultExpandedUri, currentUri, requestOptions, onUriChange, }: UseFileBrowserOptions): FileBrowserApi;
+export declare function useFileBrowser({ rootUri, locale: localeProp, dashboardKinds, renderDashboard, dashboardLabels, controlled, summaryLabels, accessLabels, formatCharacterCount, defaultExpandedUri, currentUri, requestOptions, onUriChange, }: UseFileBrowserOptions): FileBrowserApi;

package/dist/modules/file-browser/use-fs-tree.d.ts

@@ -2,6 +2,7 @@ import type { FileTreeEntryRow, FileTreeRow } from '../../components/file-tree/i
 import type { OvClient, OvRequestOptions } from '../../client/types.js';
 export interface FsTreeState {
     rows: readonly FileTreeRow[];
+    metadataRows: readonly FileTreeRow[];
     isReady: boolean;
     error: Error | null;
     /**
@@ -15,8 +16,10 @@ export interface FsTreeState {
      * {@link directoryUris} means the type is unknown.
      */
     isKnownFile: (uri: string) => boolean;
+    accessOf: (uri: string | null) => 'denied' | 'container' | undefined;
     toggleExpand: (row: FileTreeEntryRow) => Promise<void>;
     open: (uri: string) => Promise<void>;
+    openPath: (uri: string) => Promise<void>;
     loadMore: (parentId: string) => Promise<void>;
     retry: (parentId: string) => Promise<void>;
     refresh: () => Promise<void>;

package/dist/modules/file-browser/use-wiki-dashboard.d.ts

@@ -0,0 +1,17 @@
+import type { OvClient, OvRequestOptions } from '../../client/types.js';
+import type { WikiDirectoryData, WikiFileData } from '../../components/wiki-dashboard/types.js';
+type WikiDashboardResult = {
+    kind: 'directory';
+    data: WikiDirectoryData;
+} | {
+    kind: 'file';
+    data: WikiFileData;
+};
+export declare function readWikiDashboard(client: OvClient, uri: string, options: OvRequestOptions): Promise<WikiDashboardResult>;
+export declare function useWikiDashboard({ uri, requestOptions, enabled, refreshGeneration, }: {
+    uri: string;
+    requestOptions?: OvRequestOptions;
+    enabled?: boolean;
+    refreshGeneration?: number;
+}): import("./use-dashboard-query.js").DashboardQuery<WikiDashboardResult>;
+export {};

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

@@ -0,0 +1,12 @@
+/** Native CONFLICTS_CONTENT protocol. These IDs exist only in the view model. */
+import type { WikiConflict as WikiFileConflictRecord } from '../../components/wiki-dashboard/types.js';
+export type WikiFileConflicts = {
+    status: 'available';
+    document: string;
+    records: WikiFileConflictRecord[];
+} | {
+    status: 'missing' | 'invalid';
+};
+/** Keep source offsets while excluding metadata and comments from conflict anchors. */
+export declare const locateWikiConflict: (document: string, matchText: string) => WikiFileConflictRecord['location'];
+export declare const parseWikiFileConflicts: (content: string) => WikiFileConflicts;

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

@@ -0,0 +1,14 @@
+import { type WikiDashboardProps, type WikiConflict } from '../../components/wiki-dashboard/index.js';
+import type { OvRequestOptions } from '../../client/types.js';
+type Props = Pick<WikiDashboardProps, 'locale' | 'labels' | 'className' | 'style'> & {
+    uri: string;
+    kind: 'directory' | 'file';
+    onOpenUri?: (uri: string) => void;
+    onOpenDashboard?: (uri: string) => void;
+    onEdit?: (uri: string, conflict?: WikiConflict) => void;
+    onDiscuss?: (uri: string, conflict: WikiConflict) => void;
+    requestOptions?: OvRequestOptions;
+    refreshGeneration?: number;
+};
+export declare function WikiDashboardPane({ uri, kind, requestOptions, refreshGeneration, onOpenUri, onOpenDashboard, onEdit, onDiscuss, ...props }: Props): import("react").JSX.Element;
+export {};

package/dist/modules/file-browser.js

@@ -1 +1 @@
-export { FileBrowser, useFileBrowser } from "../l~0.js";
+export { FileBrowser } from "../l~0.js";

package/dist/modules/scope-cascade/controller.d.ts

@@ -1,6 +1,6 @@
-import type { ScopeCascadeApi, ScopeCascadeController } from './types.js';
+import type { ScopeCascadeApi, ScopeCascadeController, ScopeCascadeSelection } from './types.js';
 /** Instance-owned channels. Creating a controller does not start requests. */
-export declare function createScopeController(): {
+export declare function createScopeController(onChange?: (selection: ScopeCascadeSelection | null) => void): {
     controller: ScopeCascadeController;
     start(nextApi: ScopeCascadeApi): () => void;
 };

package/dist/modules/scope-cascade/index.d.ts

@@ -1,3 +1,2 @@
 export { ScopeCascade } from './scope-cascade.js';
-export { useScopeCascade, useScopeCascadeLevel } from './use-scope-cascade.js';
-export type { ScopeCascadeApi, ScopeCascadeController, ScopeCascadeIndex, ScopeCascadeLevel, ScopeCascadeProps, ScopeCascadeSnapshot, } from './types.js';
+export type { ScopeCascadeApi, ScopeCascadeProps, ScopeCascadeSelection, } from './types.js';

package/dist/modules/scope-cascade/scope-cascade.d.ts

@@ -1,3 +1,3 @@
 import type { ScopeCascadeProps } from './types.js';
 /** Only leaf selectors subscribe to request state; this wrapper resolves language. */
-export declare function ScopeCascade({ controller, locale: localeProp, labels, levelNames: names, retryLabel, ...props }: ScopeCascadeProps): import("react").JSX.Element;
+export declare function ScopeCascade({ locale: localeProp, loadLibraries, loadSpaces, loadUsers, onChange, labels, levelNames: names, retryLabel, ...props }: ScopeCascadeProps): import("react").JSX.Element;