@openviking/react 0.1.2 → 0.1.4

package/dist/components/file-tree/types.d.ts

@@ -1,3 +1,4 @@
+import type { Locale } from '../../shared/locale.js';
 import type { ForwardRefExoticComponent, HTMLAttributes, PropsWithoutRef, ReactNode, RefAttributes } from 'react';
 /**
  * 所有行的公共字段。行是按宿主展平后的顺序渲染的，因此 `id` 与 `depth` 每行都要有。
@@ -300,6 +301,26 @@ export type FileTreeInfoKey =
  * Agent capability root, `viking://agent`.
  */
  | 'agentRoot'
+/**
+ * Agent 的通信端点配置，`viking://agent/endpoints`。
+ * Agent communication endpoint configuration, `viking://agent/endpoints`.
+ */
+ | 'agentEndpoints'
+/**
+ * Agent 的支付能力配置，`viking://agent/payments`。
+ * Agent payment capability configuration, `viking://agent/payments`.
+ */
+ | 'agentPayments'
+/**
+ * Agent 的技能注册表，`viking://agent/skills`。
+ * Agent skill registry, `viking://agent/skills`.
+ */
+ | 'agentSkills'
+/**
+ * Agent 的工具配置，`viking://agent/tools`。
+ * Agent tool configuration, `viking://agent/tools`.
+ */
+ | 'agentTools'
 /**
  * 记忆根目录，`viking://memory`。
  * Memory root, `viking://memory`.
@@ -360,10 +381,14 @@ export interface FileTreeInfoLabels {
     };
 }
 /**
- * 可替换文案，组件内置英文默认值。
- * Replaceable copy; the component ships English defaults.
+ * 可替换文案，组件内置中英文文案。
+ * Replaceable copy with built-in Chinese and English defaults.
  */
 export interface FileTreeLabels {
+    /** 搜索入口文案。Search trigger label. */
+    search?: string;
+    /** 刷新按钮的无障碍名称。Accessible refresh button label. */
+    refresh?: string;
     /**
      * 空树提示。
      * Empty tree message.
@@ -408,9 +433,8 @@ export interface FileTreeLabels {
     info?: FileTreeInfoLabels;
 }
 /**
- * 树的插槽。目前只有工具栏，页面层可自行决定内容与交互。
- * Slots of the tree. Only the toolbar for now; the page layer owns its content
- * and interaction.
+ * 树的插槽。宿主可追加工具栏内容或替换加载指示器。
+ * Tree slots for additional toolbar content and a custom loading indicator.
  */
 export interface FileTreeSlots {
     /**
@@ -455,6 +479,10 @@ export interface FileTreeHandle {
 }
 /** 文件树操作的执行能力。File-tree operation capabilities. */
 export interface FileTreeOperations {
+    /** 打开宿主搜索界面。Opens the host's search interface. */
+    search?: () => Promise<void>;
+    /** 刷新目录；等待期间自动显示加载态。Refreshes the tree with a pending state. */
+    refresh?: () => Promise<void>;
     /** 选中条目。Selects an entry. */
     select?: (row: FileTreeEntryRow) => Promise<void>;
     /** 展开或折叠目录。Expands or collapses a directory. */
@@ -482,6 +510,8 @@ export interface FileTreeProps extends Omit<HTMLAttributes<HTMLDivElement>, 'chi
      * Visible rows in render order.
      */
     rows: readonly FileTreeRow[];
+    /** 内置中英文文案的语言。Language of the built-in interface copy. */
+    locale: Locale;
     /**
      * 操作的执行能力；省略对应方法时禁用该操作。
      * Operation capabilities; omitting a method disables its operation.
@@ -492,6 +522,21 @@ export interface FileTreeProps extends Omit<HTMLAttributes<HTMLDivElement>, 'chi
      * Selected row id, owned by the host.
      */
     selectedId?: string | null;
+    /**
+     * 显示内置搜索入口；默认隐藏，未提供 operations.search 时禁用。
+     * Shows the built-in search trigger. Hidden by default; disabled without operations.search.
+     */
+    search?: boolean | {
+        disabled?: boolean;
+    };
+    /**
+     * 显示内置刷新按钮；默认隐藏。loading 可表达宿主额外的刷新状态。
+     * Shows the refresh button. Hidden by default; loading adds a host-controlled pending state.
+     */
+    refresh?: boolean | {
+        disabled?: boolean;
+        loading?: boolean;
+    };
     /**
      * 首次加载是否已完成。
      * Whether the tree has finished its first load.
@@ -570,15 +615,18 @@ export interface FileTreeProps extends Omit<HTMLAttributes<HTMLDivElement>, 'chi
      * Called after retention settings open successfully, with the URI; not called on failure.
      */
     onOpenRetentionSettings?: (uri: string) => void;
+    /** 搜索界面成功打开后触发。Called after search opens successfully. */
+    onSearch?: () => void;
+    /** 刷新成功后触发，失败时不触发。Called after a successful refresh only. */
+    onRefresh?: () => void;
     /**
-     * 树的插槽。工具栏由页面层实现，可以是搜索、导入来源、刷新等任意组合。
-     * Slots of the tree. The toolbar is implemented by the page layer and can
-     * hold search, import sources, refresh or any other combination.
+     * 自定义工具栏位于内置搜索与刷新上方，可放导入等宿主操作。
+     * A custom toolbar above built-in controls, for host actions such as import.
      */
     slots?: FileTreeSlots;
     /**
-     * 可替换文案，缺省为英文。
-     * Replaceable copy; English by default.
+     * 可替换文案，未提供的项使用当前 locale 的内置文案。
+     * Replaceable copy; omitted fields follow locale.
      */
     labels?: FileTreeLabels;
 }

package/dist/components/file-tree/use-file-tree-actions.d.ts

@@ -1,5 +1,5 @@
 import type { FileTreeEntryRow, FileTreeErrorRow, FileTreeLoadMoreRow, FileTreeProps } from './types.js';
-type ActionProps = Pick<FileTreeProps, 'operations' | 'onSelect' | 'onToggleExpand' | 'onLoadMore' | 'onRetry' | 'onOpenRetentionSettings'>;
+type ActionProps = Pick<FileTreeProps, 'operations' | 'onSelect' | 'onToggleExpand' | 'onLoadMore' | 'onRetry' | 'onOpenRetentionSettings' | 'onSearch' | 'onRefresh'>;
 /**
  * 把 `operations` 包成带成功通知的回调：同一操作未完成时忽略重复触发，
  * 失败时不触发通知。
@@ -8,6 +8,9 @@ type ActionProps = Pick<FileTreeProps, 'operations' | 'onSelect' | 'onToggleExpa
  * pending operation is ignored, and a rejection fires no notification.
  */
 export declare function useFileTreeActions(props: ActionProps): {
+    refreshing: boolean;
+    onSearch: (() => undefined) | undefined;
+    onRefresh: (() => void) | undefined;
     onSelect: ((row: FileTreeEntryRow) => undefined) | undefined;
     onToggleExpand: ((row: FileTreeEntryRow) => undefined) | undefined;
     onLoadMore: ((row: FileTreeLoadMoreRow) => undefined) | undefined;

package/dist/components/scope-switcher/labels.d.ts

@@ -0,0 +1,3 @@
+import type { ScopeSwitcherLabels } from './types.js';
+import { type Locale } from '../../shared/locale.js';
+export declare function resolveScopeLabels(locale?: Locale, labels?: ScopeSwitcherLabels): Required<ScopeSwitcherLabels>;

package/dist/components/scope-switcher/locales/en-US.d.ts

@@ -0,0 +1,8 @@
+declare const messages: {
+    loading: string;
+    searchPlaceholder: string;
+    empty: string;
+    noMatch: string;
+    error: string;
+};
+export default messages;

package/dist/components/scope-switcher/locales/zh-CN.d.ts

@@ -0,0 +1,8 @@
+declare const messages: {
+    loading: string;
+    searchPlaceholder: string;
+    empty: string;
+    noMatch: string;
+    error: string;
+};
+export default messages;

package/dist/components/scope-switcher/scope-panel.d.ts

@@ -7,5 +7,5 @@ export declare function ScopePanel({ label, data, state, slots, actions, onSelec
     slots?: ScopeSwitcherSlots;
     actions?: ScopeSwitcherActions;
     onSelect: NonNullable<ScopeSwitcherActions['onSelect']>;
-    labels?: ScopeSwitcherLabels;
+    labels: Required<ScopeSwitcherLabels>;
 }): import("react").JSX.Element;

package/dist/components/scope-switcher/scope-switcher.d.ts

@@ -3,4 +3,4 @@ export { ScopeSelector } from './scope-selector.js';
 export { SCOPE_SWITCHER_SEARCH_THRESHOLD } from './types.js';
 export type { ScopeSelectorBaseProps, ScopeSelectorFixedProps, ScopeSelectorProps, ScopeSelectorSelectableProps, ScopeSwitcherActions, ScopeSwitcherData, ScopeSwitcherIdentity, ScopeSwitcherLabels, ScopeSwitcherOption, ScopeSwitcherPanelContent, ScopeSwitcherProps, ScopeSwitcherScrollMetrics, ScopeSwitcherSlots, ScopeSwitcherState, ScopeSwitcherTrigger, } from './types.js';
 /** No shared state, data aggregation or subscription in the layout root. */
-export declare function ScopeSwitcher({ children, className, ...props }: ScopeSwitcherProps): import("react").JSX.Element;
+export declare function ScopeSwitcher({ locale, children, className, ...props }: ScopeSwitcherProps): import("react").JSX.Element;

package/dist/components/scope-switcher/style.css

@@ -1,7 +1,11 @@
-.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-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-ui-tour-shadow-default: 0 15px 35px #0000000d, 0 5px 15px #0000000d;
+  --ov-ui-tour-highlight-default: #5252ff14;
   --ov-ui-primary-default: #5252ff;
   --ov-ui-primary-hover-default: #7075ff;
   --ov-ui-primary-active-default: #3833d2;
+  --ov-ui-primary-disabled-default: #acb4ff;
+  --ov-ui-text-on-primary-default: #fff;
   --ov-ui-primary-light-default: #f5f7ff;
   --ov-ui-connect-glow-warm-default: #ff952b0a;
   --ov-ui-connect-glow-pink-default: #fb4fbc0f;
@@ -19,18 +23,21 @@
   --ov-ui-bg-3-default: #f7f8fd;
   --ov-ui-bg-4-default: #f6f7fa;
   --ov-ui-bg-5-default: #f1f2f9;
+  --ov-ui-code-bg-default: #fbfbfc;
   --ov-ui-status-success-default: #1f9d55;
   --ov-ui-shadow-default: #0f172a;
+  --ov-ui-shadow-control-default: #0000000d;
   --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-overlay-default: #0006;
   --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 {
+.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-primary-default: #5f5fff;
   --ov-ui-primary-hover-default: #7075ff;
   --ov-ui-primary-active-default: #4242ba;
@@ -56,9 +63,14 @@
   --ov-ui-warning-default: #e0a04a;
   --ov-ui-warning-light-default: #3a2f14;
   --ov-ui-tooltip-bg-default: #2a2d33;
+  --ov-ui-overlay-default: #000000a3;
   --ov-ui-tooltip-text-default: #f0f1f3;
 }
 
+.dark .ov-viking-bot {
+  --ov-ui-code-bg-default: var(--ov-ui-bg-3-default);
+}
+
 .ov-agent-connect {
   --ov-ui-connect-card-default: #fbfbfc;
   --ov-ui-connect-tabs-default: #f7f7f9;

package/dist/components/scope-switcher/types.d.ts

@@ -1,3 +1,4 @@
+import type { Locale } from '../../shared/locale.js';
 import type { HTMLAttributes, ReactNode } from 'react';
 /**
  * 搜索框的显示阈值。已加载条数或 `total` 超过它，或关键字非空时，面板才渲染搜索框。
@@ -362,8 +363,8 @@ export interface ScopeSwitcherScrollMetrics {
     clientHeight: number;
 }
 /**
- * 可替换文案，组件内置英文默认值。
- * Replaceable copy; the component ships English defaults.
+ * 可替换文案，组件内置中英文文案。
+ * Replaceable copy with built-in Chinese and English defaults.
  */
 export interface ScopeSwitcherLabels {
     /** Loading status text / 加载提示。 */
@@ -391,13 +392,18 @@ export interface ScopeSwitcherLabels {
     error?: string;
 }
 /** Layout only: each child owns its state and data subscription. */
-export type ScopeSwitcherProps = HTMLAttributes<HTMLDivElement>;
+export interface ScopeSwitcherProps extends HTMLAttributes<HTMLDivElement> {
+    /** 内置中英文文案的语言。Language of the built-in interface copy. */
+    locale: Locale;
+}
 /**
  * 两种层级共有的入参：身份与触发器内容。
  *
  * Props shared by both level forms: identity and what the trigger shows.
  */
 export interface ScopeSelectorBaseProps {
+    /** 内置中英文文案的语言。Language of the built-in interface copy. */
+    locale: Locale;
     /**
      * 层级身份：稳定标识、无障碍名与末尾标记。
      * Level identity: stable key, accessible name and trailing marker.
@@ -413,8 +419,8 @@ export interface ScopeSelectorBaseProps {
      */
     trigger?: ScopeSwitcherTrigger;
     /**
-     * 可替换文案，缺省为英文。
-     * Replaceable copy; English by default.
+     * 可替换文案，未提供的项使用当前 locale 的内置文案。
+     * Replaceable copy; omitted fields follow locale.
      */
     labels?: ScopeSwitcherLabels;
 }