@openviking/react 0.1.0 → 0.1.2

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

@@ -0,0 +1,101 @@
+import type { OvRequestOptions } from '../../client/index.js';
+import type { HTMLAttributes, ReactNode } from 'react';
+/** 文件浏览模块的可替换文案。Replaceable copy of the file browser module. */
+export interface FileBrowserLabels {
+    /**
+     * 占位说明。缺省为 `Placeholder. Functionality is not available yet.`。
+     * Placeholder description. Defaults to "Placeholder. Functionality is not
+     * available yet.".
+     */
+    description?: string;
+    /** 区域标题。Area title. */
+    title?: string;
+    /** 搜索框占位文案。Search placeholder. */
+    searchPlaceholder?: string;
+    /** 搜索无结果提示。Message shown when a search returns nothing. */
+    searchEmpty?: string;
+    /** 刷新按钮的无障碍名称。Accessible name of the refresh control. */
+    refresh?: string;
+    /** 未选中资源时的提示。Message shown when no resource is selected. */
+    empty?: string;
+    /** 加载失败提示。Load failure message. */
+    error?: string;
+    /** 重试按钮文案。Retry button label. */
+    retry?: string;
+}
+/**
+ * 工具栏按钮的属性。宿主在 `toolbarActions` 里用它组合自己的入口。
+ * Props of a toolbar button. The host composes its own entries with it inside
+ * `toolbarActions`.
+ */
+export interface FileBrowserToolbarButtonProps extends Omit<HTMLAttributes<HTMLButtonElement>, 'children' | 'onClick'> {
+    /** 按钮图标。Button icon. */
+    icon: ReactNode;
+    /** 按钮文案。Button label. */
+    children: ReactNode;
+    /** 是否禁用，缺省为 `false`。Whether the button is disabled; defaults to `false`. */
+    disabled?: boolean;
+    /** 点击后触发。Called on click. */
+    onClick?: () => void;
+}
+/**
+ * 文件浏览模块的属性。
+ *
+ * 模块自己通过 Hook 取数，props 里没有数据字段：宿主给配置、受控的当前资源、
+ * 工具栏入口、文案与请求配置。目录、搜索、预览页签与行级状态都在模块内维护，
+ * 宿主不需要重复组装。
+ *
+ * 模块只覆盖文件树与文件预览两块。命令面板属于 `console`。
+ *
+ * Props of the file browser module.
+ *
+ * The module loads its own data through a Hook, so no prop carries data: the
+ * host supplies configuration, the controlled current resource, the toolbar
+ * entries, copy and request configuration. The directory, search, preview tabs
+ * and per-row state all live inside the module, so the host does not assemble
+ * them again.
+ *
+ * The module covers only the file tree and the file preview. The command panel
+ * belongs to `console`.
+ */
+export interface FileBrowserProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onSelect' | 'children'> {
+    /**
+     * 受控的当前资源 URI。传入时由宿主决定当前资源，模块只上报切换意图。
+     * The controlled current resource URI. When given, the host owns the current
+     * resource and the module only reports switch intent.
+     */
+    uri?: string;
+    /**
+     * 非受控时的初始资源 URI。省略时不选中任何资源。
+     * Initial resource URI when uncontrolled. Nothing is selected when omitted.
+     */
+    defaultUri?: string;
+    /**
+     * 工具栏左侧的宿主入口，例如连接 Agent、导入资源。用
+     * {@link FileBrowserToolbarButton} 组合，保证与模块内置按钮外观一致。
+     * 搜索与刷新由模块渲染，入口之间的分隔线也由模块处理。
+     *
+     * Host entries on the left of the toolbar, for example connecting an agent or
+     * importing resources. Compose them with {@link FileBrowserToolbarButton} so
+     * they match the module's own buttons. Search and refresh are rendered by the
+     * module, and so are the dividers between entries.
+     */
+    toolbarActions?: ReactNode;
+    /**
+     * 当前资源变化后触发，参数为新的 URI；清除选中时传入 `null`。
+     * Called after the current resource changes, with the new URI; `null` when
+     * the selection is cleared.
+     */
+    onUriChange?: (uri: string | null) => void;
+    /**
+     * 可替换文案，缺省为英文。
+     * Replaceable copy; English by default.
+     */
+    labels?: FileBrowserLabels;
+    /**
+     * 请求配置覆盖，逐字段覆盖最近的 Provider。
+     * Request configuration override, applied field by field over the nearest
+     * Provider.
+     */
+    requestOptions?: OvRequestOptions;
+}

package/dist/modules/file-browser.js

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

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

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

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

@@ -0,0 +1,3 @@
+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';

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

@@ -0,0 +1,3 @@
+import type { ScopeCascadeProps } from './types.js';
+/** Only leaf selectors subscribe. This wrapper stays outside the update path. */
+export declare function ScopeCascade({ controller, labels, levelNames, retryLabel, ...props }: ScopeCascadeProps): import("react").JSX.Element;

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

@@ -0,0 +1,456 @@
+.ov-agent-connect, .ov-file-browser, .ov-file-preview, .ov-file-tree, .ov-module-placeholder, .ov-scope-switcher, .ov-tooltip, .ov-tui, .ov-viking-bot, .ov-viking-bot__interaction {
+  --ov-ui-primary-default: #5252ff;
+  --ov-ui-primary-hover-default: #7075ff;
+  --ov-ui-primary-active-default: #3833d2;
+  --ov-ui-primary-light-default: #f5f7ff;
+  --ov-ui-connect-glow-warm-default: #ff952b0a;
+  --ov-ui-connect-glow-pink-default: #fb4fbc0f;
+  --ov-ui-connect-glow-pink-soft-default: #fb4fbc0a;
+  --ov-ui-on-primary-default: #fff;
+  --ov-ui-text-1-default: #0b0b0f;
+  --ov-ui-text-2-default: #3f3f51;
+  --ov-ui-text-3-default: #6e718c;
+  --ov-ui-text-description-default: #0006;
+  --ov-ui-text-disabled-default: #a5a7bb;
+  --ov-ui-border-1-default: #f0f2fa;
+  --ov-ui-border-2-default: #e1e4f2;
+  --ov-ui-border-3-default: #d7daea;
+  --ov-ui-bg-1-default: #fff;
+  --ov-ui-bg-3-default: #f7f8fd;
+  --ov-ui-bg-4-default: #f6f7fa;
+  --ov-ui-bg-5-default: #f1f2f9;
+  --ov-ui-status-success-default: #1f9d55;
+  --ov-ui-shadow-default: #0f172a;
+  --ov-ui-focus-default: #5252ff;
+  --ov-ui-fill-hover-default: #f1f2f9;
+  --ov-ui-status-error-default: #c43838;
+  --ov-ui-warning-default: #b26a00;
+  --ov-ui-warning-light-default: #fff0b3;
+  --ov-ui-tooltip-bg-default: #1f2329;
+  --ov-ui-tooltip-text-default: #fff;
+}
+
+.dark .ov-agent-connect, .dark .ov-file-browser, .dark .ov-file-preview, .dark .ov-file-tree, .dark .ov-module-placeholder, .dark .ov-scope-switcher, .dark .ov-tooltip, .dark .ov-tui, .dark .ov-viking-bot, .dark .ov-viking-bot__interaction {
+  --ov-ui-primary-default: #5f5fff;
+  --ov-ui-primary-hover-default: #7075ff;
+  --ov-ui-primary-active-default: #4242ba;
+  --ov-ui-primary-light-default: #1a1632;
+  --ov-ui-connect-glow-warm-default: #ff952b05;
+  --ov-ui-connect-glow-pink-default: #fb4fbc08;
+  --ov-ui-connect-glow-pink-soft-default: #fb4fbc05;
+  --ov-ui-text-1-default: #c7ccd6;
+  --ov-ui-text-2-default: #9da3af;
+  --ov-ui-text-3-default: #737a87;
+  --ov-ui-text-description-default: #fff6;
+  --ov-ui-text-disabled-default: #42464e;
+  --ov-ui-border-1-default: #23252a;
+  --ov-ui-border-2-default: #2e3138;
+  --ov-ui-border-3-default: #3a3d45;
+  --ov-ui-bg-1-default: #131416;
+  --ov-ui-bg-3-default: #1b1d21;
+  --ov-ui-bg-4-default: #202227;
+  --ov-ui-bg-5-default: #23252a;
+  --ov-ui-focus-default: #5f5fff;
+  --ov-ui-fill-hover-default: #23252a;
+  --ov-ui-status-error-default: #ff9595;
+  --ov-ui-warning-default: #e0a04a;
+  --ov-ui-warning-light-default: #3a2f14;
+  --ov-ui-tooltip-bg-default: #2a2d33;
+  --ov-ui-tooltip-text-default: #f0f1f3;
+}
+
+.ov-agent-connect {
+  --ov-ui-connect-card-default: #fbfbfc;
+  --ov-ui-connect-tabs-default: #f7f7f9;
+  --ov-ui-connect-selected-default: #f3f4f7;
+  --ov-ui-connect-border-default: #edeef2;
+  --ov-ui-connect-outline-default: #e1e3ea;
+  --ov-ui-connect-muted-default: #787c91;
+  --ov-ui-connect-notice-default: #2e2984;
+}
+
+.dark .ov-agent-connect {
+  --ov-ui-connect-card-default: var(--ov-ui-bg-3-default);
+  --ov-ui-connect-tabs-default: var(--ov-ui-bg-3-default);
+  --ov-ui-connect-selected-default: var(--ov-ui-bg-4-default);
+  --ov-ui-connect-border-default: var(--ov-ui-border-1-default);
+  --ov-ui-connect-outline-default: var(--ov-ui-border-2-default);
+  --ov-ui-connect-muted-default: var(--ov-ui-text-3-default);
+  --ov-ui-connect-notice-default: var(--ov-ui-text-2-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));
+  --ov-ui-scope-switcher-option-icon: var(--ov-ui-scope-switcher-icon);
+  --ov-ui-scope-switcher-row-hover: var(--ov-ui-color-fill-hover, var(--ov-ui-fill-hover-default, #f1f2f9));
+  --ov-ui-scope-switcher-tag-background: var(--ov-ui-color-bg-5, var(--ov-ui-bg-5-default, #f1f2f9));
+  --ov-ui-scope-switcher-tag-text: var(--ov-ui-color-text-2, var(--ov-ui-text-2-default, #3f3f51));
+  --ov-ui-scope-switcher-panel-width: 272px;
+  --ov-ui-scope-switcher-option-height: 44px;
+  --ov-ui-scope-switcher-option-gap: 2px;
+  --ov-ui-scope-switcher-list-max-height: 288px;
+  --ov-ui-scope-switcher-panel-max-height: calc(var(--ov-ui-scope-switcher-list-max-height) + 54px);
+  --ov-ui-scope-switcher-option-icon-size: 24px;
+  --ov-ui-scope-switcher-option-icon-radius: 12px;
+  box-sizing: border-box;
+  max-width: 100%;
+  height: 32px;
+  color: var(--ov-ui-color-text-1, var(--ov-ui-text-1-default, #0b0b0f));
+  font-family: var(--ov-ui-font-family, "PingFang SC",
+    -apple-system,
+    BlinkMacSystemFont,
+    "Segoe UI",
+    sans-serif);
+  letter-spacing: .039px;
+  flex-wrap: nowrap;
+  align-items: center;
+  gap: 4px;
+  font-size: 13px;
+  line-height: 22px;
+  display: inline-flex;
+}
+
+.ov-scope-switcher *, .ov-scope-switcher :before, .ov-scope-switcher :after {
+  box-sizing: border-box;
+}
+
+.ov-scope-switcher__level {
+  flex-shrink: 1;
+  align-items: center;
+  gap: 4px;
+  min-width: 0;
+  max-width: 100%;
+  display: inline-flex;
+  position: relative;
+}
+
+.ov-scope-switcher__level + .ov-scope-switcher__level:before {
+  content: "/";
+  color: var(--ov-ui-color-text-disabled, var(--ov-ui-text-disabled-default, #a5a7bb));
+  letter-spacing: .039px;
+  margin-right: 4px;
+  font-size: 13px;
+  font-weight: 500;
+  line-height: 22px;
+}
+
+.ov-scope-switcher__trigger {
+  min-width: 0;
+  max-width: min(260px, 100%);
+  height: 32px;
+  color: inherit;
+  font: inherit;
+  vertical-align: middle;
+  background: none;
+  border: 1px solid #0000;
+  border-radius: 16px;
+  align-items: center;
+  gap: 8px;
+  padding: 0 8px;
+  font-weight: 500;
+  display: inline-flex;
+}
+
+button.ov-scope-switcher__trigger {
+  cursor: pointer;
+}
+
+button.ov-scope-switcher__trigger:hover:not(:disabled), button.ov-scope-switcher__trigger:focus-visible, button.ov-scope-switcher__trigger[aria-expanded="true"] {
+  border-color: var(--ov-ui-color-primary, var(--ov-ui-primary-default, #5252ff));
+}
+
+.ov-scope-switcher__label {
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  min-width: 0;
+  overflow: hidden;
+}
+
+.ov-scope-switcher__icon {
+  width: 14px;
+  height: 14px;
+  color: var(--ov-ui-scope-switcher-icon);
+  flex: 0 0 14px;
+  justify-content: center;
+  align-items: center;
+  display: inline-flex;
+}
+
+.ov-scope-switcher__icon > svg, .ov-scope-switcher__icon > img {
+  width: 14px;
+  height: 14px;
+  display: block;
+}
+
+.ov-scope-switcher__tag {
+  border: 1px solid
+    var(--ov-ui-color-border-2, var(--ov-ui-border-2-default, #e1e4f2));
+  background: var(--ov-ui-scope-switcher-tag-background);
+  color: var(--ov-ui-scope-switcher-tag-text);
+  border-radius: 4px;
+  flex-shrink: 0;
+  padding: 1px 6px;
+  font-size: 10px;
+  font-weight: 500;
+  line-height: 16px;
+}
+
+.ov-scope-switcher__arrow {
+  width: 14px;
+  height: 14px;
+  color: var(--ov-ui-scope-switcher-icon);
+  flex: 0 0 14px;
+  justify-content: center;
+  align-items: center;
+  transition: transform .16s;
+  display: inline-flex;
+}
+
+.ov-scope-switcher__trigger[aria-expanded="true"] .ov-scope-switcher__arrow {
+  transform: rotate(180deg);
+}
+
+.ov-scope-switcher__trigger:disabled .ov-scope-switcher__arrow {
+  opacity: .55;
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .ov-scope-switcher__arrow {
+    transition: none;
+  }
+}
+
+.ov-scope-switcher__panel {
+  z-index: 30;
+  width: min(var(--ov-ui-scope-switcher-panel-width), calc(100vw - 32px));
+  max-height: min(var(--ov-ui-scope-switcher-panel-max-height),
+    calc(100vh - 128px));
+  border: 1px solid
+    var(--ov-ui-color-border-1, var(--ov-ui-border-1-default, #f0f2fa));
+  background: var(--ov-ui-color-bg-1, var(--ov-ui-bg-1-default, #fff));
+  color: var(--ov-ui-color-text-1, var(--ov-ui-text-1-default, #0b0b0f));
+  letter-spacing: .039px;
+  border-radius: 12px;
+  flex-direction: column;
+  padding: 8px;
+  font-size: 13px;
+  line-height: 22px;
+  display: flex;
+  position: absolute;
+  top: calc(100% + 4px);
+  left: 0;
+  overflow: hidden;
+  box-shadow: 0 15px 35px -2px #0000000d, 0 5px 15px #0000000d;
+}
+
+.ov-scope-switcher__panel--custom {
+  min-height: 0;
+  overflow-y: auto;
+}
+
+.ov-scope-switcher__level:last-child:not(:first-child) .ov-scope-switcher__panel {
+  left: auto;
+  right: 0;
+}
+
+.ov-scope-switcher__panel-inner {
+  flex-direction: column;
+  flex: auto;
+  min-height: 0;
+  display: flex;
+}
+
+.ov-scope-switcher__panel-body {
+  flex-direction: column;
+  flex: auto;
+  gap: 8px;
+  min-height: 0;
+  display: flex;
+}
+
+.ov-scope-switcher__search-field {
+  border: 1px solid
+    var(--ov-ui-color-border-3, var(--ov-ui-border-3-default, #d7daea));
+  background: var(--ov-ui-color-bg-1, var(--ov-ui-bg-1-default, #fff));
+  border-radius: 6px;
+  flex-shrink: 0;
+  align-items: center;
+  gap: 4px;
+  height: 28px;
+  padding: 3px 8px;
+  display: flex;
+}
+
+.ov-scope-switcher__search-field:focus-within {
+  border-color: var(--ov-ui-color-primary, var(--ov-ui-primary-default, #5252ff));
+}
+
+.ov-scope-switcher__search-icon {
+  width: 16px;
+  height: 16px;
+  color: var(--ov-ui-scope-switcher-icon);
+  flex: 0 0 16px;
+}
+
+.ov-scope-switcher__search {
+  min-width: 0;
+  height: 100%;
+  color: inherit;
+  font: inherit;
+  background: none;
+  border: 0;
+  outline: none;
+  flex: 1;
+  padding: 0;
+  font-size: 12px;
+  line-height: 22px;
+}
+
+.ov-scope-switcher__search::placeholder {
+  color: var(--ov-ui-color-text-3, var(--ov-ui-text-3-default, #6e718c));
+}
+
+.ov-scope-switcher__list {
+  gap: var(--ov-ui-scope-switcher-option-gap);
+  min-height: 0;
+  max-height: var(--ov-ui-scope-switcher-list-max-height);
+  overscroll-behavior: contain;
+  flex-direction: column;
+  display: flex;
+  overflow-y: auto;
+}
+
+.ov-scope-switcher__option {
+  width: 100%;
+  min-height: var(--ov-ui-scope-switcher-option-height);
+  color: inherit;
+  font: inherit;
+  text-align: start;
+  cursor: pointer;
+  background: none;
+  border: 0;
+  border-radius: 6px;
+  flex-shrink: 0;
+  align-items: center;
+  gap: 8px;
+  padding: 2px 8px;
+  display: flex;
+}
+
+.ov-scope-switcher__option:hover:not([aria-disabled="true"]):not([aria-selected="true"]), .ov-scope-switcher__option:focus-visible:not([aria-disabled="true"]):not([aria-selected="true"]) {
+  background: var(--ov-ui-scope-switcher-row-hover);
+}
+
+.ov-scope-switcher__option[aria-selected="true"] {
+  background: var(--ov-ui-color-primary-light, var(--ov-ui-primary-light-default, #f5f7ff));
+}
+
+.ov-scope-switcher__option .ov-scope-switcher__icon {
+  flex: 0 0 var(--ov-ui-scope-switcher-option-icon-size);
+  width: var(--ov-ui-scope-switcher-option-icon-size);
+  height: var(--ov-ui-scope-switcher-option-icon-size);
+  border: .5px solid
+    var(--ov-ui-color-border-1, var(--ov-ui-border-1-default, #f0f2fa));
+  border-radius: var(--ov-ui-scope-switcher-option-icon-radius);
+  background: var(--ov-ui-color-bg-1, var(--ov-ui-bg-1-default, #fff));
+  color: var(--ov-ui-scope-switcher-option-icon);
+}
+
+.ov-scope-switcher__option .ov-scope-switcher__icon > svg, .ov-scope-switcher__option .ov-scope-switcher__icon > img {
+  width: 14px;
+  height: 14px;
+}
+
+.ov-scope-switcher__option-text {
+  flex-direction: column;
+  flex: 1;
+  min-width: 0;
+  display: flex;
+  overflow: hidden;
+}
+
+.ov-scope-switcher__option-text > span {
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  overflow: hidden;
+}
+
+.ov-scope-switcher__option-text small {
+  color: var(--ov-ui-color-text-3, var(--ov-ui-text-3-default, #6e718c));
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  font-size: 12px;
+  line-height: 20px;
+  overflow: hidden;
+}
+
+.ov-scope-switcher__option[aria-selected="true"] .ov-scope-switcher__option-text > span {
+  font-weight: 500;
+}
+
+.ov-scope-switcher__option mark {
+  color: var(--ov-ui-color-primary, var(--ov-ui-primary-default, #5252ff));
+  background: none;
+  padding: 0;
+}
+
+.ov-scope-switcher__check {
+  width: 16px;
+  height: 16px;
+  color: var(--ov-ui-color-primary, var(--ov-ui-primary-default, #5252ff));
+  flex: 0 0 16px;
+  justify-content: center;
+  align-items: center;
+  display: inline-flex;
+}
+
+.ov-scope-switcher__state {
+  min-height: 88px;
+  color: var(--ov-ui-color-text-3, var(--ov-ui-text-3-default, #6e718c));
+  text-align: center;
+  flex: 1;
+  justify-content: center;
+  align-items: center;
+  padding: 12px;
+  font-size: 13px;
+  line-height: 22px;
+  display: flex;
+}
+
+.ov-scope-switcher button:disabled {
+  cursor: default;
+}
+
+.ov-scope-switcher__option[aria-disabled="true"] {
+  opacity: .5;
+  cursor: not-allowed;
+}
+
+.ov-scope-switcher :focus-visible {
+  outline: 2px solid
+    var(--ov-ui-color-primary, var(--ov-ui-primary-default, #5252ff));
+  outline-offset: 2px;
+}
+
+.ov-scope-switcher__trigger:focus-visible, .ov-scope-switcher__search:focus-visible {
+  outline: none;
+}
+
+.ov-scope-switcher__option:focus-visible {
+  outline-offset: -2px;
+}
+
+@media (width <= 600px) {
+  .ov-scope-switcher__panel, .ov-scope-switcher__level:last-child:not(:first-child) .ov-scope-switcher__panel {
+    width: auto;
+    max-height: 60dvh;
+    position: fixed;
+    inset: auto 16px 16px;
+  }
+}
+
+
+
+
+

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

@@ -0,0 +1,39 @@
+import type { HTMLAttributes } from 'react';
+import type { ScopeSwitcherLabels, ScopeSwitcherOption } from '../../components/scope-switcher/index.js';
+export interface ScopeCascadeApi {
+    loadLibraries: (signal: AbortSignal) => Promise<readonly ScopeSwitcherOption[]>;
+    loadSpaces: (libraryId: string, signal: AbortSignal) => Promise<readonly ScopeSwitcherOption[]>;
+    loadUsers: (libraryId: string, spaceId: string, signal: AbortSignal) => Promise<readonly ScopeSwitcherOption[]>;
+}
+export type ScopeCascadeIndex = 0 | 1 | 2;
+export interface ScopeCascadeSnapshot {
+    readonly options: readonly ScopeSwitcherOption[];
+    readonly selected?: ScopeSwitcherOption;
+    readonly enabled: boolean;
+    readonly loading: boolean;
+    readonly error: Error | null;
+    /** Changes only when ancestor identities change. */
+    readonly scopeKey: string;
+    /** Ancestor IDs in library / space order, available to downstream consumers. */
+    readonly parentIds: readonly string[];
+}
+export interface ScopeCascadeLevel {
+    getSnapshot: () => ScopeCascadeSnapshot;
+    subscribe: (listener: () => void) => () => void;
+    select: (option: ScopeSwitcherOption) => void;
+    refresh: () => void;
+}
+export interface ScopeCascadeController {
+    readonly levels: readonly [
+        ScopeCascadeLevel,
+        ScopeCascadeLevel,
+        ScopeCascadeLevel
+    ];
+}
+export interface ScopeCascadeProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children'> {
+    controller: ScopeCascadeController;
+    /** Accessible names and placeholders, in library / space / user order. */
+    levelNames?: readonly [string, string, string];
+    retryLabel?: string;
+    labels?: ScopeSwitcherLabels;
+}

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

@@ -0,0 +1,5 @@
+import type { ScopeCascadeApi, ScopeCascadeLevel } 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;
+/** 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

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