@openviking/react 0.0.0-stage → 0.1.1

package/dist/modules/console/style.css

@@ -0,0 +1,29 @@
+.ov-module-placeholder {
+  box-sizing: border-box;
+  border: 1px dashed var(--ov-ui-border, currentColor);
+  border-radius: var(--ov-ui-radius, 6px);
+  min-width: 0;
+  min-height: 160px;
+  color: inherit;
+  font: inherit;
+  text-align: center;
+  overflow-wrap: anywhere;
+  flex-direction: column;
+  justify-content: center;
+  align-items: center;
+  gap: 8px;
+  padding: 24px;
+  display: flex;
+}
+
+.ov-module-placeholder__title {
+  margin: 0;
+}
+
+.ov-module-placeholder__description {
+  color: var(--ov-ui-text-muted, color-mix(in srgb, currentColor 75%, transparent));
+  margin: 0;
+}
+
+
+

package/dist/modules/console/types.d.ts

@@ -0,0 +1,101 @@
+import type { OvRequestOptions } from '../../client/index.js';
+import type { HTMLAttributes, ReactNode } from 'react';
+/**
+ * 面板模式。对话与命令共用同一面板，切换时各自保留状态。
+ * Panel mode. Conversation and commands share one panel, each keeping its own
+ * state when the mode switches.
+ */
+export type ConsoleMode = 'conversation' | 'command';
+/** 交互面板模块的插槽。Slots of the console module. */
+export interface ConsoleSlots {
+    /**
+     * 面板顶部工具栏。模式切换由模块渲染，这里放宿主专属入口。
+     * Panel toolbar. The module renders the mode switch; put host-specific
+     * entries here.
+     */
+    toolbar?: ReactNode;
+    /**
+     * 对话模式下输入区上方的附加内容，例如当前资源上下文。
+     * Extra content above the composer in conversation mode, for example the
+     * current resource context.
+     */
+    conversationContext?: ReactNode;
+    /**
+     * 命令模式下的命令帮助内容。省略时由模块按宿主声明的命令生成。
+     * Command help in command mode. When omitted, the module derives it from the
+     * commands the host declares.
+     */
+    commandHelp?: ReactNode;
+}
+/** 交互面板模块的可替换文案。Replaceable copy of the console module. */
+export interface ConsoleLabels {
+    /**
+     * 占位说明。缺省为 `Placeholder. Functionality is not available yet.`。
+     * Placeholder description. Defaults to "Placeholder. Functionality is not
+     * available yet.".
+     */
+    description?: string;
+    /** 对话模式名称。Conversation mode label. */
+    conversation?: string;
+    /** 命令模式名称。Command mode label. */
+    command?: string;
+    /** 会话加载失败提示。Session load failure message. */
+    error?: string;
+    /** 重试按钮文案。Retry button label. */
+    retry?: string;
+}
+/**
+ * 交互面板模块的属性。
+ *
+ * 模块自己通过 Hook 取数，props 里没有会话与命令记录：宿主给配置、受控模式、
+ * 插槽与文案。打开资源通过回调交给宿主，与文件浏览模块的联动不依赖对方的私有
+ * 状态。
+ *
+ * Props of the console module.
+ *
+ * The module loads its own data through a Hook, so no prop carries sessions or
+ * command records: the host supplies configuration, the controlled mode, slots
+ * and copy. Opening a resource goes back to the host through a callback, and
+ * coordination with the file browser never reaches into the other module's
+ * private state.
+ */
+export interface ConsoleProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onSelect' | 'children'> {
+    /**
+     * 受控的当前模式。传入时由宿主决定模式，模块只上报切换意图。
+     * The controlled mode. When given, the host owns the mode and the module only
+     * reports switch intent.
+     */
+    mode?: ConsoleMode;
+    /**
+     * 非受控时的初始模式，缺省为 `conversation`。
+     * Initial mode when uncontrolled; defaults to `conversation`.
+     */
+    defaultMode?: ConsoleMode;
+    /**
+     * 模式变化后触发。
+     * Called after the mode changes.
+     */
+    onModeChange?: (mode: ConsoleMode) => void;
+    /**
+     * 资源成功打开后触发，参数为资源 URI；失败时不触发。
+     * Called after a resource opens successfully, with its URI; not called on
+     * failure.
+     */
+    onOpenUri?: (uri: string) => void;
+    /**
+     * 插槽，见 {@link ConsoleSlots}。
+     * Slots, see {@link ConsoleSlots}.
+     */
+    slots?: ConsoleSlots;
+    /**
+     * 可替换文案，缺省为英文。
+     * Replaceable copy; English by default.
+     */
+    labels?: ConsoleLabels;
+    /**
+     * 请求配置覆盖，逐字段覆盖最近的 Provider。
+     * Request configuration override, applied field by field over the nearest
+     * Provider.
+     */
+    requestOptions?: OvRequestOptions;
+}

package/dist/modules/console.js

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

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

@@ -0,0 +1,10 @@
+import type { FileBrowserToolbarButtonProps } from './types.js';
+/**
+ * 工具栏按钮。模块自己的搜索与刷新用它渲染，宿主在 `toolbarActions` 里也用它
+ * 组合入口，两边的外观因此保持一致。
+ *
+ * A toolbar button. The module renders its own search and refresh with it, and
+ * the host composes its entries with it inside `toolbarActions`, so both sides
+ * look the same.
+ */
+export declare function FileBrowserToolbarButton({ icon, children, onClick, disabled, className, ...rest }: FileBrowserToolbarButtonProps): import("react").JSX.Element;

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

@@ -0,0 +1,6 @@
+import { FileBrowserToolbarButton } from './file-browser-toolbar-button.js';
+import type { FileBrowserProps } from './types.js';
+export { FileBrowserToolbarButton };
+export type { FileBrowserLabels, FileBrowserProps, FileBrowserToolbarButtonProps, } from './types.js';
+/** 占位组件：渲染一个带模块名的空容器，真实实现随模块 Hook 与组合视图迁入。 */
+export declare function FileBrowser({ className, style, labels }: FileBrowserProps): import("react").JSX.Element;

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

@@ -0,0 +1 @@
+export * from './file-browser.js';

package/dist/modules/file-browser/style.css

@@ -0,0 +1,75 @@
+.ov-file-browser__toolbar-button {
+  align-items: center;
+  gap: var(--ov-ui-space-2, 8px);
+  padding: var(--ov-ui-space-2, 8px) var(--ov-ui-space-3, 12px);
+  border-radius: var(--ov-ui-radius-sm, 4px);
+  color: var(--ov-ui-color-primary, #1664ff);
+  font: inherit;
+  cursor: pointer;
+  background: none;
+  border: 0;
+  display: inline-flex;
+}
+
+.ov-file-browser__toolbar-button:hover:not(:disabled) {
+  background: var(--ov-ui-color-fill-hover, #1664ff14);
+}
+
+.ov-file-browser__toolbar-button:focus-visible {
+  outline: 2px solid var(--ov-ui-color-focus, #1664ff);
+  outline-offset: 2px;
+}
+
+.ov-file-browser__toolbar-button:disabled {
+  color: var(--ov-ui-color-text-disabled, #00000040);
+  cursor: not-allowed;
+}
+
+.ov-file-browser__toolbar-button-icon {
+  flex: none;
+  display: inline-flex;
+}
+
+.ov-file-browser__toolbar-button-label {
+  white-space: nowrap;
+}
+
+.ov-file-browser__toolbar-actions > * + :before {
+  content: "";
+  width: 1px;
+  height: 16px;
+  margin-right: var(--ov-ui-space-2, 8px);
+  background: var(--ov-ui-color-border, #0000001f);
+  vertical-align: middle;
+  display: inline-block;
+}
+
+.ov-module-placeholder {
+  box-sizing: border-box;
+  border: 1px dashed var(--ov-ui-border, currentColor);
+  border-radius: var(--ov-ui-radius, 6px);
+  min-width: 0;
+  min-height: 160px;
+  color: inherit;
+  font: inherit;
+  text-align: center;
+  overflow-wrap: anywhere;
+  flex-direction: column;
+  justify-content: center;
+  align-items: center;
+  gap: 8px;
+  padding: 24px;
+  display: flex;
+}
+
+.ov-module-placeholder__title {
+  margin: 0;
+}
+
+.ov-module-placeholder__description {
+  color: var(--ov-ui-text-muted, color-mix(in srgb, currentColor 75%, transparent));
+  margin: 0;
+}
+
+
+

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,250 @@
+.ov-scope-switcher {
+  box-sizing: border-box;
+  border: 1px solid var(--ov-ui-border, #edeef2);
+  background: var(--ov-ui-scope-background, transparent);
+  max-width: 100%;
+  min-height: 32px;
+  color: var(--ov-ui-text, #0b0b0f);
+  font-family: var(--ov-ui-font-family, "PingFang SC",
+    -apple-system,
+    BlinkMacSystemFont,
+    "Segoe UI",
+    sans-serif);
+  letter-spacing: .036px;
+  border-radius: 16px;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 4px;
+  padding: 3px 4px;
+  font-size: 12px;
+  line-height: 20px;
+  display: inline-flex;
+}
+
+.ov-scope-switcher *, .ov-scope-switcher :before, .ov-scope-switcher :after {
+  box-sizing: border-box;
+}
+
+.ov-scope-switcher__level {
+  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-text-muted, #c9cbd4);
+  margin-right: 4px;
+  font-size: 13px;
+  font-weight: 500;
+  line-height: 22px;
+}
+
+.ov-scope-switcher__trigger {
+  max-width: min(260px, 100%);
+  height: 24px;
+  color: inherit;
+  font: inherit;
+  vertical-align: middle;
+  background: none;
+  border: 0;
+  border-radius: 99px;
+  align-items: center;
+  gap: 6px;
+  padding: 2px 8px;
+  display: inline-flex;
+}
+
+button.ov-scope-switcher__trigger {
+  cursor: pointer;
+}
+
+.ov-scope-switcher__trigger:hover:not(:disabled), .ov-scope-switcher__trigger[aria-expanded="true"] {
+  background: var(--ov-ui-hover, #edeffc);
+}
+
+.ov-scope-switcher__label {
+  white-space: nowrap;
+  text-overflow: ellipsis;
+  overflow: hidden;
+}
+
+.ov-scope-switcher__icon {
+  flex: none;
+  justify-content: center;
+  align-items: center;
+  width: 14px;
+  height: 14px;
+  display: inline-flex;
+}
+
+.ov-scope-switcher__icon img {
+  display: block;
+}
+
+.ov-scope-switcher__tag {
+  color: var(--ov-ui-text-muted, #9295a5);
+  font-size: 12px;
+}
+
+.ov-scope-switcher__arrow {
+  flex: 0 0 14px;
+  width: 14px;
+  height: 14px;
+  margin-left: -2px;
+  transition: transform .16s;
+  display: inline-flex;
+}
+
+.ov-scope-switcher__trigger[aria-expanded="true"] .ov-scope-switcher__arrow {
+  transform: rotate(180deg);
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .ov-scope-switcher__arrow {
+    transition: none;
+  }
+}
+
+.ov-scope-switcher__panel {
+  z-index: 30;
+  border: 1px solid var(--ov-ui-border, #edeef2);
+  background: var(--ov-ui-surface, #fff);
+  width: min(272px, 100vw - 32px);
+  max-height: min(540px, 70vh);
+  color: var(--ov-ui-text, #0b0b0f);
+  letter-spacing: .039px;
+  border-radius: 12px;
+  padding: 7px;
+  font-size: 13px;
+  line-height: 22px;
+  position: absolute;
+  top: calc(100% + 8px);
+  left: 0;
+  overflow: auto;
+  box-shadow: 0 15px 35px -2px #0000000d, 0 5px 15px #0000000d;
+}
+
+.ov-scope-switcher__level:last-child:not(:first-child) .ov-scope-switcher__panel {
+  left: auto;
+  right: 0;
+}
+
+.ov-scope-switcher__search {
+  border: 1px solid var(--ov-ui-border, #dfe1e8);
+  width: 100%;
+  color: inherit;
+  font: inherit;
+  background: none;
+  border-radius: 8px;
+  margin-bottom: 8px;
+  padding: 8px 10px;
+}
+
+.ov-scope-switcher__list {
+  overscroll-behavior: contain;
+  flex-direction: column;
+  gap: 4px;
+  max-height: 280px;
+  display: flex;
+  overflow: auto;
+}
+
+.ov-scope-switcher__option {
+  width: 100%;
+  min-height: 44px;
+  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"]), .ov-scope-switcher__option[aria-selected="true"] {
+  background: var(--ov-ui-hover, #f5f7ff);
+}
+
+.ov-scope-switcher__option-text {
+  flex-direction: column;
+  flex: 1;
+  min-width: 0;
+  display: flex;
+  overflow: hidden;
+}
+
+.ov-scope-switcher__option-text small {
+  color: var(--ov-ui-text-muted, #737889);
+}
+
+.ov-scope-switcher__option mark {
+  background: var(--ov-ui-highlight, #fff0b3);
+  color: inherit;
+}
+
+.ov-scope-switcher__check {
+  flex: 0 0 16px;
+  width: 16px;
+  height: 16px;
+  display: inline-flex;
+}
+
+.ov-scope-switcher__state {
+  color: var(--ov-ui-text-muted, #737889);
+  padding: 20px 10px;
+}
+
+.ov-scope-switcher button:disabled, .ov-scope-switcher__option[aria-disabled="true"] {
+  opacity: .5;
+  cursor: not-allowed;
+}
+
+.ov-scope-switcher :focus-visible {
+  outline: 2px solid var(--ov-ui-primary, #6256d9);
+  outline-offset: 2px;
+}
+
+@media (width <= 600px) {
+  .ov-scope-switcher__trigger {
+    max-width: 210px;
+  }
+
+  .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;
+  }
+}
+
+.ov-scope-switcher__option[aria-selected="true"] {
+  font-weight: 500;
+}
+
+.ov-scope-switcher__option-text > span {
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  overflow: hidden;
+}
+
+.ov-scope-switcher__option .ov-scope-switcher__icon {
+  border: .5px solid var(--ov-ui-border, #edeef2);
+  background: var(--ov-ui-surface, #fff);
+  border-radius: 50%;
+  width: 24px;
+  height: 24px;
+}
+
+
+
+
+

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";