@openviking/react 0.1.5 → 0.1.6

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

@@ -1,6 +1,7 @@
 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';
@@ -13,6 +14,14 @@ 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 {
     /** 预览底部字符数。Character count in the preview footer. */
     formatCharacterCount?: (count: number) => string;
@@ -69,6 +78,7 @@ export interface FileBrowserLabels {
     entries?: FileBrowserEntriesLabels;
     /** 目录树文案。Copy of the file tree. */
     tree?: FileTreeLabels;
+    dashboard?: FileBrowserDashboardLabels;
     /** 预览文案。Copy of the file preview. */
     preview?: FilePreviewLabels;
 }
@@ -135,6 +145,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 +161,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,6 +197,8 @@ 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. */
@@ -238,6 +254,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. */
@@ -253,3 +270,48 @@ export interface FileBrowserActions {
     /** 更新查询词；空串回到目录树。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;
+    /** 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.d.ts

@@ -1,47 +1,4 @@
-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';
 /**
  * 文件浏览模块的取数与联动：把目录树、搜索与预览组合成一份视图数据。三者各自
  * 取数，这里只负责把它们接起来——目录行展开树，文件行与搜索结果打开预览。
@@ -51,4 +8,4 @@ export interface UseFileBrowserOptions {
  * a directory row expands the tree, while a file row or a search result opens
  * the preview.
  */
-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, 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;
     /**
@@ -17,6 +18,7 @@ export interface FsTreeState {
     isKnownFile: (uri: string) => boolean;
     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;

package/dist/modules/scope-cascade/style.css

@@ -1,4 +1,4 @@
-.ov-directory-tour, .ov-agent-connect, .ov-console, .ov-divider, .ov-file-browser-entries, .ov-drawer, .ov-file-browser, .ov-file-preview, .ov-file-tree, .ov-module-placeholder, .ov-popover, .ov-scope-switcher, .ov-tooltip, .ov-tui, .ov-viking-bot, .ov-viking-bot__popover, .ov-viking-bot__reference-picker--mention, .ov-viking-bot__interaction {
+.ov-directory-tour, .ov-wiki-dashboard, .ov-experience-dashboard, .ov-agent-connect, .ov-console, .ov-divider, .ov-file-browser-entries, .ov-drawer, .ov-file-browser, .ov-file-preview, .ov-file-tree, .ov-module-placeholder, .ov-popover, .ov-scope-switcher, .ov-tooltip, .ov-tui, .ov-viking-bot, .ov-viking-bot__popover, .ov-viking-bot__reference-picker--mention, .ov-viking-bot__interaction {
   --ov-ui-tour-shadow-default: 0 15px 35px #0000000d, 0 5px 15px #0000000d;
   --ov-ui-tour-highlight-default: #5252ff14;
   --ov-ui-primary-default: #5252ff;
@@ -35,9 +35,29 @@
   --ov-ui-overlay-default: #0006;
   --ov-ui-tooltip-bg-default: #1f2329;
   --ov-ui-tooltip-text-default: #fff;
-}
-
-.dark .ov-directory-tour, .dark .ov-agent-connect, .dark .ov-console, .dark .ov-divider, .dark .ov-file-browser-entries, .dark .ov-drawer, .dark .ov-file-browser, .dark .ov-file-preview, .dark .ov-file-tree, .dark .ov-module-placeholder, .dark .ov-popover, .dark .ov-scope-switcher, .dark .ov-tooltip, .dark .ov-tui, .dark .ov-viking-bot, .dark .ov-viking-bot__popover, .dark .ov-viking-bot__reference-picker--mention, .dark .ov-viking-bot__interaction {
+  --ov-ui-library-swatch-1-default: linear-gradient(145deg,
+    #ffd8ec 8%,
+    #ffabc8 46%,
+    #d8cbff 100%);
+  --ov-ui-library-swatch-2-default: linear-gradient(145deg,
+    #d9e8ff 8%,
+    #b8a6ff 52%,
+    #f3d6ff 100%);
+  --ov-ui-library-swatch-3-default: linear-gradient(145deg,
+    #ffe6bc 8%,
+    #ffaf96 48%,
+    #ff8bc5 100%);
+  --ov-ui-library-swatch-4-default: linear-gradient(145deg,
+    #eaf7ba 8%,
+    #b5efb8 52%,
+    #73d9c6 100%);
+  --ov-ui-library-swatch-5-default: linear-gradient(145deg,
+    #fff1ba 8%,
+    #ffc776 52%,
+    #bd9cff 100%);
+}
+
+.dark .ov-directory-tour, html.dark .ov-wiki-dashboard, html.dark .ov-experience-dashboard, .dark .ov-agent-connect, .dark .ov-console, .dark .ov-divider, .dark .ov-file-browser-entries, .dark .ov-drawer, .dark .ov-file-browser, .dark .ov-file-preview, .dark .ov-file-tree, .dark .ov-module-placeholder, .dark .ov-popover, .dark .ov-scope-switcher, .dark .ov-tooltip, .dark .ov-tui, .dark .ov-viking-bot, .dark .ov-viking-bot__popover, .dark .ov-viking-bot__reference-picker--mention, .dark .ov-viking-bot__interaction {
   --ov-ui-primary-default: #5f5fff;
   --ov-ui-primary-hover-default: #7075ff;
   --ov-ui-primary-active-default: #4242ba;
@@ -91,6 +111,30 @@
   --ov-ui-connect-notice-default: var(--ov-ui-text-2-default);
 }
 
+.ov-wiki-dashboard, .ov-experience-dashboard, .ov-file-browser {
+  --ov-ui-dashboard-surface-default: #f8f8f8;
+  --ov-ui-dashboard-card-default: #fafafa;
+  --ov-ui-dashboard-muted-default: #787c91;
+  --ov-ui-dashboard-border-default: #edeef2;
+  --ov-ui-dashboard-warning-default: #eb7d00;
+  --ov-ui-dashboard-warning-light-default: #fff0e5;
+  --ov-ui-dashboard-danger-default: #d92d54;
+  --ov-ui-dashboard-danger-light-default: #ffecee;
+  --ov-ui-dashboard-success-default: #4f9c70;
+}
+
+html.dark .ov-wiki-dashboard, html.dark .ov-experience-dashboard, html.dark .ov-file-browser {
+  --ov-ui-dashboard-surface-default: var(--ov-ui-bg-3-default);
+  --ov-ui-dashboard-card-default: var(--ov-ui-bg-3-default);
+  --ov-ui-dashboard-muted-default: var(--ov-ui-text-3-default);
+  --ov-ui-dashboard-border-default: var(--ov-ui-border-1-default);
+  --ov-ui-dashboard-warning-default: var(--ov-ui-warning-default);
+  --ov-ui-dashboard-warning-light-default: var(--ov-ui-warning-light-default);
+  --ov-ui-dashboard-danger-default: var(--ov-ui-status-error-default);
+  --ov-ui-dashboard-danger-light-default: var(--ov-ui-bg-5-default);
+  --ov-ui-dashboard-success-default: var(--ov-ui-status-success-default);
+}
+
 .ov-scope-switcher {
   --ov-ui-scope-switcher-divider: var(--ov-ui-color-text-disabled, var(--ov-ui-text-disabled-default, #a5a7bb));
   --ov-ui-scope-switcher-icon: var(--ov-ui-color-text-2, var(--ov-ui-text-2-default, #3f3f51));

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

@@ -31,12 +31,17 @@ export interface ScopeCascadeController {
         ScopeCascadeLevel
     ];
 }
-export interface ScopeCascadeProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children'> {
-    controller: ScopeCascadeController;
-    /** 可选文案语言；继承上层，最终默认英文。Optional locale; inherits or defaults to en-US. */
+export interface ScopeCascadeProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children' | 'onChange'>, ScopeCascadeApi {
+    /** Optional locale; inherits the nearest module or Provider. */
     locale?: Locale;
     /** Accessible names and placeholders, in library / space / user order. */
     levelNames?: readonly [string, string, string];
     retryLabel?: string;
+    onChange?: (selection: ScopeCascadeSelection | null) => void;
     labels?: ScopeSwitcherLabels;
 }
+export interface ScopeCascadeSelection {
+    libraryId: string;
+    spaceId: string;
+    userId: string;
+}

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

@@ -1,5 +1,5 @@
-import type { ScopeCascadeApi, ScopeCascadeLevel } from './types.js';
+import type { ScopeCascadeApi, ScopeCascadeLevel, ScopeCascadeProps } from './types.js';
 /** Creates a stable coordinator without subscribing the caller to its data. */
-export declare function useScopeCascade({ loadLibraries, loadSpaces, loadUsers, }: ScopeCascadeApi): import("./types.js").ScopeCascadeController;
+export declare function useScopeCascade({ loadLibraries, loadSpaces, loadUsers }: ScopeCascadeApi, onChange?: ScopeCascadeProps['onChange']): import("./types.js").ScopeCascadeController;
 /** Call in a leaf, never aggregate all three subscriptions in the root. */
 export declare function useScopeCascadeLevel(level: ScopeCascadeLevel): import("./types.js").ScopeCascadeSnapshot;

package/dist/modules/scope-cascade.js

@@ -1 +1 @@
-export { ScopeCascade, useScopeCascade, useScopeCascadeLevel } from "../lk~0.js";
+export { ScopeCascade } from "../lk~0.js";