@openviking/react 0.1.3 → 0.1.4

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

@@ -1,16 +1,21 @@
+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 { 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 { HTMLAttributes, ReactNode } from 'react';
+import type { ComponentPropsWithRef, HTMLAttributes, ReactElement, ReactNode } from 'react';
 /**
- * 文件浏览模块的可替换文案。树与预览各有自己的一套，分别透传，模块外壳只提供
+ * 文件浏览模块的可替换文案。入口、树与预览的文案分别透传，模块外壳只提供
  * 自己渲染的那几条。
  *
- * Replaceable copy of the file browser module. The tree and the preview each keep
- * their own set, passed through as-is; the module shell only carries the strings
+ * Replaceable copy of the file browser module. Entry, tree and preview copy is
+ * passed through as-is; the module shell only carries the strings
  * it renders itself.
  */
 export interface FileBrowserLabels {
+    /** 预览底部字符数。Character count in the preview footer. */
+    formatCharacterCount?: (count: number) => string;
     /** 未选中资源时的提示。Message shown when no resource is selected. */
     empty?: string;
     /** 加载失败提示。Load failure message. */
@@ -60,6 +65,8 @@ export interface FileBrowserLabels {
      * generated yet", and the two call for different actions.
      */
     summaryFailed?: string;
+    /** 入口条与接入抽屉文案。Copy of the entry row and connection drawer. */
+    entries?: FileBrowserEntriesLabels;
     /** 目录树文案。Copy of the file tree. */
     tree?: FileTreeLabels;
     /** 预览文案。Copy of the file preview. */
@@ -69,21 +76,24 @@ export interface FileBrowserLabels {
  * 文件浏览模块的属性。
  *
  * 模块自己通过 Hook 取数，props 里没有数据字段：宿主给配置、受控的当前资源、
- * 工具栏入口、文案与请求配置。目录、搜索、预览页签与行级状态都在模块内维护。
+ * 接入配置、导入交互、文案与请求配置。入口条、目录、搜索、预览页签与行级
+ * 状态都在模块内维护。
  *
- * 模块只覆盖文件树与文件预览两块。命令面板属于 `console`。
+ * 模块包含文件树、文件预览与顶部入口。命令面板属于 `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
+ * 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.
  *
- * The module covers only the file tree and the file preview. The command panel
+ * 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'> {
+    /** 内置中英文文案的语言。Language of the built-in interface copy. */
+    locale: Locale;
     /**
      * 受控的当前资源 URI。传入时由宿主决定当前资源，模块只上报切换意图。
      *
@@ -121,25 +131,10 @@ export interface FileBrowserProps extends Omit<HTMLAttributes<HTMLDivElement>, '
      */
     defaultExpandedUri?: string;
     /**
-     * 透传给预览底座的文案语言。组件自身文案仍由 `labels` 控制。
-     * Language of the preview base's built-in copy. The module's own copy stays
-     * with `labels`.
+     * 内置接入抽屉的配置；传入后显示连接入口，省略时隐藏。
+     * Configuration of the built-in connection drawer; enables its entry when provided.
      */
-    locale?: 'en-US' | 'zh-CN';
-    /**
-     * 工具栏上方的宿主入口，例如连接 Agent、导入资源。
-     *
-     * 两个固定入口由 `FileBrowserEntries` 提供，外观、图标、分隔线与等分排布都
-     * 在那边，宿主只决定显示哪几个与点击后做什么。搜索与刷新由模块自己渲染。
-     *
-     * Host entries above the toolbar, for example connecting an agent or importing
-     * resources.
-     *
-     * The two fixed entries come from `FileBrowserEntries`, which owns their look,
-     * icons, divider and equal-width layout; the host only decides which appear and
-     * what a click does. Search and refresh are rendered by the module itself.
-     */
-    toolbarActions?: ReactNode;
+    agentConnect?: AgentConnectProps;
     /**
      * 当前资源变化后触发，参数为新的 URI。
      *
@@ -155,8 +150,22 @@ export interface FileBrowserProps extends Omit<HTMLAttributes<HTMLDivElement>, '
      */
     onUriChange?: (uri: string | null) => void;
     /**
-     * 可替换文案，缺省为英文。
-     * Replaceable copy; English by default.
+     * 默认导入按钮的点击回调，单独传入即可显示导入入口。
+     * Click handler of the default import button; enables its entry on its own.
+     */
+    onImportResources?: () => void;
+    /**
+     * 自定义导入入口，参数是带图标与文案的默认原生按钮。
+     * 宿主可用自己的浮层包装按钮，保留点击回调。省略时使用默认按钮；返回 null
+     * 隐藏导入入口。同时省略点击回调和插槽时不显示导入入口。
+     * Renders the import entry using its default native button, including icon and
+     * label and click handler. Omit to use the default button, or return null to hide
+     * the entry. Omitting both the click handler and renderer hides the entry.
+     */
+    renderImportResources?: (trigger: ReactElement<ComponentPropsWithRef<'button'>>) => ReactNode;
+    /**
+     * 可替换文案，未提供的项使用当前 locale 的内置文案。
+     * Replaceable copy; omitted fields follow locale.
      */
     labels?: FileBrowserLabels;
     /**

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

@@ -1,7 +1,10 @@
+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 for standalone use; defaults to en-US. */
+    locale?: Locale;
     /**
      * 宿主是否受控地持有当前资源。受控时 `currentUri` 就是唯一事实；非受控时
      * `currentUri` 只是初始值，之后的选中由模块自己记在 `pendingUri` 里。
@@ -31,6 +34,8 @@ export interface UseFileBrowserOptions {
         l1: string;
         failure: string;
     };
+    /** 字符数文案；独立 Hook 默认英文。Character count copy; standalone Hooks default to English. */
+    formatCharacterCount?: (count: number) => string;
     /** 首次加载后自动展开到的路径。Path to expand to after the first load. */
     defaultExpandedUri?: string;
     currentUri: string | null;
@@ -46,4 +51,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, controlled, summaryLabels, defaultExpandedUri, currentUri, requestOptions, onUriChange, }: UseFileBrowserOptions): FileBrowserApi;
+export declare function useFileBrowser({ rootUri, locale, controlled, summaryLabels, formatCharacterCount, defaultExpandedUri, currentUri, requestOptions, onUriChange, }: UseFileBrowserOptions): FileBrowserApi;

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

@@ -32,6 +32,8 @@ export interface UseFsPreviewOptions {
         l1: string;
         failure: string;
     };
+    /** 字符数文案；独立 Hook 默认英文。Character count copy; standalone Hooks default to English. */
+    formatCharacterCount?: (count: number) => string;
     /**
      * 打开路径上的某一级祖先。面包屑与目录页签共用它。
      * Opens one ancestor level; the breadcrumb and a directory tab share it.
@@ -48,4 +50,16 @@ export interface UseFsPreviewOptions {
     generation?: number;
     requestOptions?: OvRequestOptions;
 }
-export declare function useFsPreview({ client, uri, resourceType, labels, openParent, generation, requestOptions, }: UseFsPreviewOptions): PreviewState;
+/**
+ * 当前资源的预览页签。切换资源时旧请求被取消，已产出的页签不会覆盖新资源。
+ *
+ * 文件读正文，目录读概览（为空时回落到摘要）——两者都是 Markdown，交给同一个
+ * 预览组件渲染。
+ *
+ * Preview tabs of the current resource. A stale request is cancelled when the
+ * resource changes, so its tabs never overwrite the new one.
+ *
+ * A file reads its content and a directory reads its overview, falling back to the
+ * abstract; both are Markdown and go through the same preview component.
+ */
+export declare function useFsPreview({ client, uri, resourceType, labels, formatCharacterCount, openParent, generation, requestOptions, }: UseFsPreviewOptions): PreviewState;

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

@@ -0,0 +1,6 @@
+import { type Locale } from '../../shared/locale.js';
+export declare function resolveScopeCascadeLabels(locale: Locale): {
+    levelNames: [string, string, string];
+    error: string;
+    retry: string;
+};

package/dist/modules/scope-cascade/locales/en-US.d.ts

@@ -0,0 +1,6 @@
+declare const messages: {
+    levelNames: [string, string, string];
+    error: string;
+    retry: string;
+};
+export default messages;

package/dist/modules/scope-cascade/locales/zh-CN.d.ts

@@ -0,0 +1,3 @@
+import type enUS from './en-US.js';
+declare const messages: typeof enUS;
+export default messages;

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

@@ -1,3 +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;
+export declare function ScopeCascade({ controller, locale, labels, levelNames, retryLabel, ...props }: ScopeCascadeProps): import("react").JSX.Element;

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

@@ -1,7 +1,11 @@
-.ov-agent-connect, .ov-divider, .ov-file-browser, .ov-file-browser-entries, .ov-file-preview, .ov-file-tree, .ov-module-placeholder, .ov-popover, .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-divider, .dark .ov-file-browser, .dark .ov-file-browser-entries, .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__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/modules/scope-cascade/types.d.ts

@@ -1,3 +1,4 @@
+import type { Locale } from '../../shared/locale.js';
 import type { HTMLAttributes } from 'react';
 import type { ScopeSwitcherLabels, ScopeSwitcherOption } from '../../components/scope-switcher/index.js';
 export interface ScopeCascadeApi {
@@ -32,6 +33,8 @@ export interface ScopeCascadeController {
 }
 export interface ScopeCascadeProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children'> {
     controller: ScopeCascadeController;
+    /** 内置中英文文案的语言。Language of the built-in interface copy. */
+    locale: Locale;
     /** Accessible names and placeholders, in library / space / user order. */
     levelNames?: readonly [string, string, string];
     retryLabel?: string;