@openviking/react 0.1.3 → 0.1.5

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

@@ -1,101 +1,80 @@
-import type { OvRequestOptions } from '../../client/index.js';
+import type { Locale } from '../../shared/locale.js';
 import type { HTMLAttributes, ReactNode } from 'react';
-/**
- * 面板模式。对话与命令共用同一面板，切换时各自保留状态。
- * Panel mode. Conversation and commands share one panel, each keeping its own
- * state when the mode switches.
- */
+import type { OvRequestOptions } from '../../client/types.js';
+import type { TuiCommandDefinition, TuiLabels, TuiRecord } from '../../components/tui/index.js';
+import type { VikingBotLabels, VikingBotProps } from '../../components/viking-bot/index.js';
 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.".
-     */
+    /** Conversation welcome description. */
     description?: string;
-    /** 对话模式名称。Conversation mode label. */
     conversation?: string;
-    /** 命令模式名称。Command mode label. */
     command?: string;
-    /** 会话加载失败提示。Session load failure message. */
-    error?: string;
-    /** 重试按钮文案。Retry button label. */
-    retry?: string;
+    clear?: string;
+    history?: string;
+    emptyHistory?: string;
+    /** 终端空态标题，转交 Tui 的 `emptyTitle`。Terminal empty-state heading, mapped to Tui `emptyTitle`. */
+    commandTitle?: string;
+    /** 终端空态说明，转交 Tui 的 `emptyDescription`。Terminal empty-state description, mapped to Tui `emptyDescription`. */
+    commandDescription?: string;
+    /** 快捷命令引导文案，转交 Tui 的 `quickStart`。Quick-command label, mapped to Tui `quickStart`. */
+    quickStart?: string;
+    mode?: string;
+    tui?: TuiLabels;
+    vikingBot?: VikingBotLabels;
 }
-/**
- * 交互面板模块的属性。
- *
- * 模块自己通过 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.
-     */
+/** Options shared by Console and useConsole. */
+export interface ConsoleOptions {
+    locale?: Locale;
     mode?: ConsoleMode;
-    /**
-     * 非受控时的初始模式，缺省为 `conversation`。
-     * Initial mode when uncontrolled; defaults to `conversation`.
-     */
+    /** Initial uncontrolled mode. Defaults to VikingBot ('conversation'). */
     defaultMode?: ConsoleMode;
-    /**
-     * 模式变化后触发。
-     * Called after the mode changes.
-     */
+    /** Change with the identity when using dynamic credential/identity functions. */
+    scopeKey?: string;
     onModeChange?: (mode: ConsoleMode) => void;
+    requestOptions?: OvRequestOptions;
+}
+export interface ConsoleProps extends ConsoleOptions, Omit<HTMLAttributes<HTMLDivElement>, 'onSelect' | 'children'> {
+    /** 可选文案语言；继承上层，最终默认英文。Optional locale; inherits or defaults to en-US. */
+    locale?: Locale;
     /**
-     * 资源成功打开后触发，参数为资源 URI；失败时不触发。
-     * Called after a resource opens successfully, with its URI; not called on
-     * failure.
+     * 终端空态展示的快捷命令名称，按数组顺序取自命令目录，未命中的名称跳过，
+     * 重复名称只保留首次出现。
+     * 省略时使用默认集合；传空数组不展示内置空态。
+     * Quick command names shown in the terminal empty state, resolved from the
+     * command catalogue in array order with unknown names skipped. Omitted uses
+     * the default set; an empty array shows no built-in empty state.
      */
+    quickCommands?: readonly string[];
+    /** Host-owned conversation state/capabilities. Omit draft callbacks to use Console's local draft. */
+    conversation?: Partial<VikingBotProps>;
+    /** Reports navigation intent; the host opens the resource. */
     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;
+}
+/** Local state. Records and drafts are never persisted by the module. */
+export interface ConsoleState {
+    records: readonly TuiRecord[];
+    command: string;
+    conversationDraft: string;
+    isExecuting: boolean;
+    error?: unknown;
+    failedCommand?: string;
+}
+/** Data and operations available independently of Console's view. */
+export interface ConsoleResult extends ConsoleState {
+    mode: ConsoleMode;
+    commands: readonly TuiCommandDefinition[];
+    setMode: (mode: ConsoleMode) => void;
+    setCommand: (command: string) => void;
+    setConversationDraft: (draft: string) => void;
+    execute: (command?: string) => Promise<void>;
+    retry: () => Promise<void>;
+    cancel: () => void;
+    clear: () => void;
 }

package/dist/modules/console/use-console.d.ts

@@ -0,0 +1,3 @@
+import type { ConsoleOptions, ConsoleResult } from './types.js';
+/** Native command execution and draft orchestration, with or without Console. */
+export declare function useConsole({ mode: controlledMode, defaultMode, locale: localeProp, scopeKey, onModeChange, requestOptions, }?: ConsoleOptions): ConsoleResult;

package/dist/modules/console.js

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

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

@@ -1,3 +1,4 @@
+import type { Locale } from '../../shared/locale.js';
 import { type FilePreviewTab } from '../../components/file-preview/index.js';
 import type { FileBrowserLabels } from './types.js';
 /**
@@ -16,7 +17,7 @@ import type { FileBrowserLabels } from './types.js';
 export interface FileBrowserDetailProps {
     tabs: readonly FilePreviewTab[];
     activeKey: string | null;
-    locale?: 'en-US' | 'zh-CN';
+    locale: Locale;
     labels?: FileBrowserLabels['preview'];
     footer?: string;
     /** 分段器与图标按钮的文案。Copy for the segmented control and icon buttons. */

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

@@ -1,28 +1,27 @@
+import { type Locale } from '../../shared/locale.js';
 import type { FilePreviewLabels } from '../../components/file-preview/index.js';
 import type { FileTreeLabels } from '../../components/file-tree/index.js';
 import type { FileBrowserLabels } from './types.js';
 /** 模块外壳自己渲染的文案，其余透传给树与预览。 */
-type ShellLabels = Omit<FileBrowserLabels, 'tree' | 'preview'>;
+export type ShellLabels = Omit<FileBrowserLabels, 'tree' | 'preview' | 'entries'>;
 /**
  * 模块外壳的内置文案。树与预览的默认值留在各自组件里，模块不重复一份。
  * Built-in copy of the module shell. The tree and the preview keep their own
  * defaults, so the module does not duplicate them.
  */
-export declare const DEFAULT_LABELS: Required<ShellLabels>;
 /** 解析后的外壳文案，外加透传给两个组件的文案。 */
 export interface ResolvedLabels extends Required<ShellLabels> {
     tree: FileTreeLabels | undefined;
     previewLabels: FileBrowserLabels['preview'];
 }
 /** 逐项合并默认文案；树与预览的文案原样透传，缺省由组件自己兜底。 */
-export declare function resolveLabels(labels: FileBrowserLabels | undefined): ResolvedLabels;
-/**
- * 预览组件的文案：模块自己的那几项叠在宿主透传的之上。组件那份英文默认值只在
- * 宿主完全不传时才会用到，模块不能让它在中文界面里漏出来。
- *
- * The preview component's copy: the module's own fields layered over what the host
- * passed through. The component's English defaults only apply when a host passes
- * nothing, and must not leak into a Chinese interface.
- */
+export declare function resolveLabels(labels: FileBrowserLabels | undefined, locale: Locale): ResolvedLabels;
+/** Shared shell labels followed by explicit preview overrides. */
 export declare function resolvePreviewLabels(text: ResolvedLabels): FilePreviewLabels;
-export {};
+export declare const DEFAULT_LABELS: Required<ShellLabels>;
+/** Summary titles are derived from the module resource, including host overrides. */
+export declare function resolveSummaryLabels(locale: Locale, labels?: FileBrowserLabels): {
+    l0: string;
+    l1: string;
+    failure: string;
+};

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

@@ -1,9 +1,8 @@
 /**
- * 搜索行：搜索框与刷新按钮。两者都是模块自己的，宿主入口在上一行的
- * `toolbarActions` 里。
+ * 搜索行：搜索框与刷新按钮。内置的连接与导入入口位于上一行。
  *
- * The search row: the search box and the refresh button. Both belong to the module;
- * host entries live in `toolbarActions` on the row above.
+ * The search row: the search box and refresh button. Built-in connection and import
+ * entries occupy the row above.
  */
 export interface FileBrowserToolbarProps {
     searchId: string;

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

@@ -1,20 +1,22 @@
-import type { ReactNode } from 'react';
+import type { Locale } from '../../shared/locale.js';
+import type { FileBrowserEntriesProps } from '../../components/file-browser-entries/index.js';
 import type { FileTreeLabels } from '../../components/file-tree/index.js';
 import type { FileBrowserApi } from './types.js';
 /**
- * 左栏：宿主入口条、搜索行与目录树。
+ * 左栏：内置入口条、搜索行与目录树。
  *
  * 宽度由外层的可拖拽分隔条决定，因此这里只铺满自己的盒子，不设宽度；树内容
  * 比栏宽时横向滚动，而不是把名称截成省略号。
  *
- * The left column: the host's entries, the search row and the tree.
+ * The left column: the built-in entries, the search row and the tree.
  *
  * The width comes from the draggable divider outside, so this only fills its own
  * box. When the tree is wider than the column it scrolls sideways rather than
  * truncating names into ellipses.
  */
 export interface FileBrowserTreePaneProps {
-    toolbarActions?: ReactNode;
+    entries: Pick<FileBrowserEntriesProps, 'agentConnect' | 'onImportResources' | 'renderImportResources' | 'labels'>;
+    locale: Locale;
     searchId: string;
     browser: FileBrowserApi;
     treeLabels: FileTreeLabels | undefined;
@@ -27,4 +29,4 @@ export interface FileBrowserTreePaneProps {
     /** 失败态里的重试按钮。Retry button of the failure state. */
     retryLabel: string;
 }
-export declare function FileBrowserTreePane({ toolbarActions, searchId, browser, treeLabels, searchPlaceholder, refreshLabel, searchLoading, searchEmpty, searchErrorLabel, retryLabel, }: FileBrowserTreePaneProps): import("react").JSX.Element;
+export declare function FileBrowserTreePane({ entries, locale, searchId, browser, treeLabels, searchPlaceholder, refreshLabel, searchLoading, searchEmpty, searchErrorLabel, retryLabel, }: FileBrowserTreePaneProps): import("react").JSX.Element;

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

@@ -12,4 +12,4 @@ export type { FileBrowserActions, FileBrowserApi, FileBrowserLabels, FileBrowser
  * tree; loading and coordination live in {@link useFileBrowser}, and this only
  * assembles the view.
  */
-export declare function FileBrowser({ uri, defaultUri, rootUri, defaultExpandedUri, locale, toolbarActions, onUriChange, labels, requestOptions, className, style, ...rest }: FileBrowserProps): import("react").JSX.Element;
+export declare function FileBrowser({ uri, defaultUri, rootUri, defaultExpandedUri, locale: localeProp, agentConnect, onUriChange, onImportResources, renderImportResources, labels, requestOptions, className, style, ...rest }: FileBrowserProps): import("react").JSX.Element;

package/dist/modules/file-browser/fs-read-directory.d.ts

@@ -1,5 +1,5 @@
 import type { OvClient, OvRequestOptions } from '../../client/types.js';
-import type { FilePreviewDirectoryTab } from '../../components/file-preview/index.js';
+import { type DirectorySummary } from './fs-model.js';
 /**
  * 读目录的两级摘要，各自成一个页签：L0 是摘要，L1 是总览。
  *
@@ -13,8 +13,4 @@ import type { FilePreviewDirectoryTab } from '../../components/file-preview/inde
  * other; when both are empty the tabs still appear, so the user sees that the
  * directory exists but has no generated content instead of blank space.
  */
-export declare function readDirectory(client: OvClient, uri: string, options: OvRequestOptions, labels: {
-    l0: string;
-    l1: string;
-    failure: string;
-}, openParent?: (uri: string) => Promise<void>): Promise<FilePreviewDirectoryTab>;
+export declare function readDirectory(client: OvClient, uri: string, options: OvRequestOptions): Promise<DirectorySummary>;

package/dist/modules/file-browser/locales/en-US.d.ts

@@ -0,0 +1,25 @@
+declare const messages: {
+    formatCharacterCount: (count: number) => string;
+    empty: string;
+    error: string;
+    retry: string;
+    refresh: string;
+    searchPlaceholder: string;
+    searchEmpty: string;
+    searchFailed: string;
+    loading: string;
+    searchLoading: string;
+    previewMode: string;
+    sourceMode: string;
+    copyPath: string;
+    copyContent: string;
+    download: string;
+    history: string;
+    viewSwitch: string;
+    resizeTree: string;
+    l0Summary: string;
+    l1Overview: string;
+    summaryEmpty: string;
+    summaryFailed: string;
+};
+export default messages;

package/dist/modules/file-browser/locales/zh-CN.d.ts

@@ -0,0 +1,25 @@
+declare const messages: {
+    formatCharacterCount: (count: number) => string;
+    empty: string;
+    error: string;
+    retry: string;
+    refresh: string;
+    searchPlaceholder: string;
+    searchEmpty: string;
+    searchFailed: string;
+    loading: string;
+    searchLoading: string;
+    previewMode: string;
+    sourceMode: string;
+    copyPath: string;
+    copyContent: string;
+    download: string;
+    history: string;
+    viewSwitch: string;
+    resizeTree: string;
+    l0Summary: string;
+    l1Overview: string;
+    summaryEmpty: string;
+    summaryFailed: string;
+};
+export default messages;