@openviking/react 0.1.1 → 0.1.2

package/dist/components/tui/tui-assist.d.ts

@@ -0,0 +1,15 @@
+import type { RefObject } from 'react';
+import type { ResolvedTuiLabels } from './tui-labels.js';
+import type { TuiCompletion } from './use-tui-completion.js';
+export interface TuiAssistProps {
+    anchorRef: RefObject<HTMLDivElement | null>;
+    assistId: string;
+    labels: ResolvedTuiLabels;
+    completion: TuiCompletion;
+    activeIndex: number;
+    onActiveIndexChange: (index: number) => void;
+    onPick: (value: string) => void;
+    onDismiss: (value: string) => void;
+}
+/** 候选浮层和联动详情；现代浏览器使用顶层 Popover，保留宿主主题继承。 */
+export declare function TuiAssist({ anchorRef, assistId, labels, completion, activeIndex, onActiveIndexChange, onPick, onDismiss, }: TuiAssistProps): import("react").JSX.Element | null;

package/dist/components/tui/tui-code-block.d.ts

@@ -0,0 +1,8 @@
+import type { ResolvedTuiLabels } from './tui-labels.js';
+/** 文本代码块共用复制与资源链接行为。 */
+export declare function TuiCodeBlock({ text, labels, onCopy, onOpenUri, }: {
+    text: string;
+    labels: ResolvedTuiLabels;
+    onCopy?: (text: string) => void;
+    onOpenUri?: (uri: string) => void;
+}): import("react").JSX.Element;

package/dist/components/tui/tui-command-help.d.ts

@@ -0,0 +1,9 @@
+import type { TuiCommandHelpContent } from './types.js';
+import type { ResolvedTuiLabels } from './tui-labels.js';
+export interface TuiCommandHelpProps {
+    content: TuiCommandHelpContent;
+    onPick?: (command: string) => void;
+    labels: ResolvedTuiLabels;
+}
+/** 命令帮助：按分组列出命令，点击填入输入框。 */
+export declare function TuiCommandHelp({ content, onPick, labels, }: TuiCommandHelpProps): import("react").JSX.Element;

package/dist/components/tui/tui-command-text.d.ts

@@ -0,0 +1,6 @@
+/** 展示宿主命令前缀与动作，保留原始大小写和空白。 */
+export declare function TuiCommandText({ text, name, namespaceOnly, }: {
+    text: string;
+    name?: string;
+    namespaceOnly?: boolean;
+}): import("react").JSX.Element;

package/dist/components/tui/tui-composer.d.ts

@@ -0,0 +1,24 @@
+import type { RefObject } from 'react';
+import type { ResolvedTuiLabels } from './tui-labels.js';
+import type { TuiCompletion } from './use-tui-completion.js';
+export interface TuiComposerProps {
+    anchorRef: RefObject<HTMLDivElement | null>;
+    assistId: string;
+    onFocus: () => void;
+    onDismiss: (value: string) => void;
+    onRequestPalette: () => void;
+    value: string;
+    history: readonly string[];
+    labels: ResolvedTuiLabels;
+    completion: TuiCompletion;
+    disabled: boolean;
+    readOnly: boolean;
+    canSubmit: boolean;
+    activeIndex: number;
+    onActiveIndexChange: (index: number | ((current: number) => number)) => void;
+    onValueChange?: (value: string) => void;
+    onSubmit?: (command: string) => void;
+    onOpenUri?: (uri: string) => void;
+}
+/** 命令输入区：受控输入、键盘补全与提交意图。 */
+export declare function TuiComposer({ anchorRef, assistId, onFocus, onDismiss, onRequestPalette, value, history, labels, completion, disabled, readOnly, canSubmit, activeIndex, onActiveIndexChange, onValueChange, onSubmit, onOpenUri, }: TuiComposerProps): import("react").JSX.Element;

package/dist/components/tui/tui-copy-button.d.ts

@@ -0,0 +1,9 @@
+export interface TuiCopyButtonProps {
+    text: string;
+    label: string;
+    copiedLabel: string;
+    onCopy?: (text: string) => void;
+    className?: string;
+}
+/** 复制按钮：成功后短暂显示已复制，并通知宿主。 */
+export declare function TuiCopyButton({ text, label, copiedLabel, onCopy, className, }: TuiCopyButtonProps): import("react").JSX.Element;

package/dist/components/tui/tui-input-mirror.d.ts

@@ -0,0 +1,14 @@
+import type { RefObject, UIEventHandler } from 'react';
+import type { TuiInlineCompletion } from './command-completion.js';
+import type { TuiCommandInputMatch } from './command-input.js';
+/** 原生 textarea 负责编辑与选区，镜像只绘制颜色和不属于输入值的参数提示。 */
+export declare function TuiInputMirror({ value, input, inline, colorInput, onOpenUri, onScroll, mirrorRef, hintId, }: {
+    value: string;
+    input: TuiCommandInputMatch | undefined;
+    inline?: TuiInlineCompletion;
+    colorInput?: boolean;
+    onOpenUri?: (uri: string) => void;
+    onScroll: UIEventHandler<HTMLSpanElement>;
+    mirrorRef: RefObject<HTMLSpanElement | null>;
+    hintId: string;
+}): import("react").JSX.Element;

package/dist/components/tui/tui-labels-zh.d.ts

@@ -0,0 +1,2 @@
+import type { ResolvedTuiLabels } from './tui-labels.js';
+export declare const ZH_TUI_LABELS: ResolvedTuiLabels;

package/dist/components/tui/tui-labels.d.ts

@@ -0,0 +1,5 @@
+import type { TuiLabels } from './types.js';
+/** 补齐当前语言的默认界面文案。 */
+export type ResolvedTuiLabels = Required<TuiLabels>;
+export declare const DEFAULT_TUI_LABELS: ResolvedTuiLabels;
+export declare function resolveTuiLabels(labels?: TuiLabels, locale?: 'en' | 'zh'): ResolvedTuiLabels;

package/dist/components/tui/tui-markdown-renderers.d.ts

@@ -0,0 +1,10 @@
+import type { Components } from 'react-markdown';
+import type { ResolvedTuiLabels } from './tui-labels.js';
+export interface TuiMarkdownOptions {
+    labels: ResolvedTuiLabels;
+    onOpenUri?: (uri: string) => void;
+    onCopy?: (text: string) => void;
+}
+export declare const TuiMarkdownContext: import("react").Context<TuiMarkdownOptions | null>;
+/** Stable component types preserve DOM identity, focus and copy feedback across input updates. */
+export declare const TUI_MARKDOWN_COMPONENTS: Components;

package/dist/components/tui/tui-markdown.d.ts

@@ -0,0 +1,6 @@
+import { type TuiMarkdownOptions } from './tui-markdown-renderers.js';
+export interface TuiMarkdownProps extends TuiMarkdownOptions {
+    text: string;
+}
+/** Markdown uses stable renderers; callbacks and labels flow through the instance context. */
+export declare function TuiMarkdown({ text, ...options }: TuiMarkdownProps): import("react").JSX.Element;

package/dist/components/tui/tui-param-hint.d.ts

@@ -0,0 +1,7 @@
+import type { TuiCommandDefinition } from './command-catalog.js';
+import type { ResolvedTuiLabels } from './tui-labels.js';
+export declare function TuiParamHint({ command, labels, onPick, }: {
+    command: TuiCommandDefinition;
+    labels: ResolvedTuiLabels;
+    onPick: (value: string) => void;
+}): import("react").JSX.Element;

package/dist/components/tui/tui-record-time.d.ts

@@ -0,0 +1,11 @@
+import type { ResolvedTuiLabels } from './tui-labels.js';
+import type { TuiRecord } from './types.js';
+type RecordTime = Pick<TuiRecord, 'createdAt' | 'createdAtMs'>;
+/** 按实际经过的毫秒计算相对时间；展示字符串不参与日期解析。 */
+export declare function formatTuiRecordTime(record: RecordTime, labels: ResolvedTuiLabels, now?: number): string | undefined;
+/** 客户端渲染时读取时钟，SSR 与 hydration 首屏使用相同的兜底文案。 */
+export declare function TuiRecordTime({ record, labels, }: {
+    record: RecordTime;
+    labels: ResolvedTuiLabels;
+}): import("react").JSX.Element | null;
+export {};

package/dist/components/tui/tui-record.d.ts

@@ -0,0 +1,13 @@
+import type { TuiCommandDefinition } from './command-catalog.js';
+import type { ResolvedTuiLabels } from './tui-labels.js';
+import type { TuiRecord } from './types.js';
+export interface TuiRecordProps {
+    record: TuiRecord;
+    command?: TuiCommandDefinition;
+    labels: ResolvedTuiLabels;
+    onOpenUri?: (uri: string) => void;
+    onCopy?: (text: string) => void;
+    onPickCommand?: (command: string) => void;
+}
+/** 一条执行记录：命令回显、状态与结果。 */
+export declare function TuiRecordItem(props: TuiRecordProps): import("react").JSX.Element;

package/dist/components/tui/tui-resource-preview.d.ts

@@ -0,0 +1,10 @@
+import type { TuiResourcePreviewContent } from './types.js';
+import type { ResolvedTuiLabels } from './tui-labels.js';
+export interface TuiResourcePreviewProps {
+    content: TuiResourcePreviewContent;
+    onOpenUri?: (uri: string) => void;
+    onCopy?: (text: string) => void;
+    labels: ResolvedTuiLabels;
+}
+/** 单个资源正文预览。A single resource body preview. */
+export declare function TuiResourcePreview({ content, onOpenUri, onCopy, labels, }: TuiResourcePreviewProps): import("react").JSX.Element;

package/dist/components/tui/tui-resource-tree.d.ts

@@ -0,0 +1,10 @@
+import type { TuiResourceTreeContent } from './types.js';
+export interface TuiResourceTreeProps {
+    content: TuiResourceTreeContent;
+    onOpenUri?: (uri: string) => void;
+    loadMoreLabel: string;
+    noResultLabel: string;
+    resourceLabel: string;
+}
+/** 资源树结果：有明细时按列对齐，否则逐行列出。 */
+export declare function TuiResourceTree({ content, onOpenUri, loadMoreLabel, noResultLabel, resourceLabel, }: TuiResourceTreeProps): import("react").JSX.Element;

package/dist/components/tui/tui-result-header.d.ts

@@ -0,0 +1,7 @@
+import type { TuiRecordStatus } from './types.js';
+/** 命令名与执行状态；图标通过名称表达状态。 */
+export declare function TuiResultHeader({ command, status, label, }: {
+    command: string;
+    status: TuiRecordStatus;
+    label: string;
+}): import("react").JSX.Element;

package/dist/components/tui/tui-result-text.d.ts

@@ -0,0 +1,5 @@
+import type { TuiCommandDefinition } from './command-catalog.js';
+/** 命令已出现在卡片头时，不重复显示同名正文标题。 */
+export declare function getVisibleTuiResultTitle(title: string | undefined, command?: TuiCommandDefinition): string | undefined;
+export declare function getTuiResultText(text: string, command?: TuiCommandDefinition): string;
+export declare function isTuiJson(text: string): boolean;

package/dist/components/tui/tui-search-list.d.ts

@@ -0,0 +1,8 @@
+import type { TuiSearchListContent } from './types.js';
+export interface TuiSearchListProps {
+    content: TuiSearchListContent;
+    onOpenUri?: (uri: string) => void;
+    noResultLabel: string;
+}
+/** 检索结果列表。Search result list. */
+export declare function TuiSearchList({ content, onOpenUri, noResultLabel, }: TuiSearchListProps): import("react").JSX.Element;

package/dist/components/tui/tui-skeleton.d.ts

@@ -0,0 +1,6 @@
+import type { TuiSkeletonKind } from './command-catalog.js';
+export interface TuiSkeletonProps {
+    kind: TuiSkeletonKind;
+}
+/** 等待中的骨架；按命令选择形态，未知命令使用通用骨架。 */
+export declare function TuiSkeleton({ kind }: TuiSkeletonProps): import("react").JSX.Element;

package/dist/components/tui/tui-status-card.d.ts

@@ -0,0 +1,7 @@
+import type { TuiStatusContent } from './types.js';
+export interface TuiStatusCardProps {
+    content: TuiStatusContent;
+    onOpenUri?: (uri: string) => void;
+}
+/** 键值状态卡片。Key/value status card. */
+export declare function TuiStatusCard({ content, onOpenUri }: TuiStatusCardProps): import("react").JSX.Element;

package/dist/components/tui/tui-text.d.ts

@@ -0,0 +1,10 @@
+/** Literal/code tokens end at whitespace or quoting delimiters, not filename punctuation. */
+export declare const TUI_URI_PATTERN: RegExp;
+/** Prose retains sentence punctuation outside automatic links. */
+export declare const TUI_PROSE_URI_PATTERN: RegExp;
+/** Resource targets permit only explicit resource or web navigation schemes. */
+export declare function getTuiSafeHref(uri: string | undefined): string | undefined;
+/** 复制文本到剪贴板；不可用时返回 `false`，不抛出。 */
+export declare function copyTuiText(text: string): Promise<boolean>;
+/** Validate JSON, then indent its original tokens without rewriting values. */
+export declare function formatTuiJson(text: string): string;

package/dist/components/tui/tui-uri-text.d.ts

@@ -0,0 +1,19 @@
+import type { ReactNode } from 'react';
+export interface TuiUriTextProps {
+    text: string;
+    onOpenUri?: (uri: string) => void;
+    /** 编辑镜像隐藏重复文字，但保留链接语义及输入框焦点。 */
+    editor?: boolean;
+    /** Every caller declares its content semantics; literal values retain filename punctuation. */
+    mode: 'prose' | 'literal';
+}
+/** A validated native link; rejected targets remain plain text. */
+export declare function TuiUriLink({ uri, children, onOpenUri, editor, className, }: {
+    uri?: string;
+    children: ReactNode;
+    onOpenUri?: (uri: string) => void;
+    editor?: boolean;
+    className?: string;
+}): import("react").JSX.Element;
+/** 把纯文本中的 URI 渲染成链接；宿主可通过回调接管打开。 */
+export declare function TuiUriText({ text, onOpenUri, editor, mode, }: TuiUriTextProps): import("react").JSX.Element;

package/dist/components/tui/tui-write-result.d.ts

@@ -0,0 +1,7 @@
+import type { TuiWriteResultContent } from './types.js';
+export interface TuiWriteResultProps {
+    content: TuiWriteResultContent;
+    onOpenUri?: (uri: string) => void;
+}
+/** 写入结果。Write result. */
+export declare function TuiWriteResult({ content, onOpenUri }: TuiWriteResultProps): import("react").JSX.Element;

package/dist/components/tui/tui.d.ts

@@ -1,3 +1,11 @@
+import type { TuiProps } from './types.js';
+export type { TuiCommandDefinition, TuiCommandExample, TuiCommandGroup, TuiCommandParam, TuiCommandOption, TuiSkeletonKind, } from './command-catalog.js';
 export type { TuiCommandHelpContent, TuiCommandHelpItem, TuiCommandHelpSection, TuiLabels, TuiProps, TuiRecord, TuiRecordContent, TuiRecordStatus, TuiResourcePreviewContent, TuiResourceTreeContent, TuiResourceTreeDetailRow, TuiResourceTreeItem, TuiSearchListContent, TuiSearchResultItem, TuiStatusContent, TuiStatusRow, TuiTextContent, TuiWriteResultContent, } from './types.js';
-/** 占位组件：仅渲染固定尺寸的空壳，真实实现按 props 契约重写。 */
-export declare function Tui(): import("react").JSX.Element;
+/**
+ * 命令记录、结果与输入区。宿主负责执行与会话，组件渲染传入的记录，
+ * 上报用户的提交意图与已完成的复制。
+ *
+ * Command records, results and input. The host owns execution and sessions; the
+ * component renders supplied records and reports submission intent and successful copies.
+ */
+export declare function Tui({ records, value, disabled, emptyState, locale, commands, commandGroups, onValueChange, onSubmit, onOpenUri, onCopy, labels, className, ...rest }: TuiProps): import("react").JSX.Element;

package/dist/components/tui/types.d.ts

@@ -1,4 +1,5 @@
 import type { HTMLAttributes, ReactNode } from 'react';
+import type { TuiCommandDefinition, TuiCommandGroup } from './command-catalog.js';
 /**
  * 一条执行记录的状态。
  * Status of one execution record.
@@ -316,8 +317,8 @@ export interface TuiCommandHelpItem {
      */
     key: string;
     /**
-     * 命令名，包含开头的斜杠。
-     * Command name including the leading slash.
+     * 用于显示和填入的命令文本。
+     * Command text used for display and insertion.
      */
     name: string;
     /**
@@ -351,10 +352,15 @@ export interface TuiRecord {
      */
     content?: TuiRecordContent;
     /**
-     * 记录头部的展示时间。
-     * Timestamp rendered in the record header.
+     * 未提供有效 createdAtMs 时使用的展示时间，不解析为日期。
+     * Display text used without a valid createdAtMs; never parsed as a date.
      */
     createdAt?: string;
+    /**
+     * 发送时的 Unix 毫秒时间戳，优先在客户端格式化为相对时间或本地日期。
+     * Unix timestamp in milliseconds; preferred for relative time or local date display on the client.
+     */
+    createdAtMs?: number;
 }
 /**
  * 可替换的界面文案，默认英文。
@@ -373,10 +379,14 @@ export interface TuiLabels {
      */
     unavailableMessage?: string;
     /**
-     * 发送按钮文案。
-     * Send button label.
+     * 底部发送快捷键的说明文案。
+     * Label for the send keyboard shortcut.
      */
     send?: string;
+    /** 全部指令快捷键说明。Label for the all-commands shortcut. */
+    allCommands?: string;
+    /** 历史指令快捷键说明。Label for recalling commands from the current records. */
+    historyCommands?: string;
     /**
      * 建议列表的无障碍名称。
      * Accessible name of the suggestion list.
@@ -417,6 +427,32 @@ export interface TuiLabels {
      * Message shown when there are no records.
      */
     empty?: string;
+    /** 无返回结果时的提示。Message for an empty command result. */
+    noResult?: string;
+    /** 刚刚发送的时间文案。Time label for a just-sent record. */
+    justNow?: string;
+    /** 命令帮助的标题与操作提示。Command-help heading and hint. */
+    availableCommands?: string;
+    helpHint?: string;
+    /** 参数帮助标题、示例与空参数提示。Parameter help headings and empty copy. */
+    parameters?: string;
+    examples?: string;
+    noParameters?: string;
+    /** 参数表列名与必填值。Parameter columns and required values. */
+    parameter?: string;
+    required?: string;
+    description?: string;
+    defaultValue?: string;
+    yes?: string;
+    no?: string;
+    /** 资源列表分页。Resource list pagination. */
+    loadMore?: string;
+    /** 资源表格的名称列。Resource identity column heading. */
+    resource?: string;
+    /** 格式化已过去的整分钟。Formats elapsed whole minutes. */
+    formatMinutesAgo?: (minutes: number) => string;
+    /** 格式化已过去的整小时。Formats elapsed whole hours. */
+    formatHoursAgo?: (hours: number) => string;
 }
 /**
  * 当前命令记录、结果与输入区的公开接口；会话、历史面板和外层工具栏由宿主组合。
@@ -452,23 +488,29 @@ export interface TuiProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onCopy'
      * passing `null` hides empty-state content.
      */
     emptyState?: ReactNode;
-    /**
-     * 输入值变化时触发，包括接受补全或参数提示；填入不提交命令。省略时输入框
+    /** 内置界面文案的语言，默认英文；命令文案由宿主提供。 */
+    locale?: 'en' | 'zh';
+    /** 宿主提供的命令目录；省略时无候选和参数帮助，仍可提交文本。 */
+    commands?: readonly TuiCommandDefinition[];
+    /** 宿主提供的分组名称与顺序；未声明的组按目录顺序追加。 */
+    commandGroups?: readonly TuiCommandGroup[];
+    /**
+     * 输入值变化时触发，包括接受命令或示例；行内占位不改变值，也不提交。省略时输入框
      * 只读，用于展示历史记录。
-     * Invoked when the input changes, including accepted completions and parameter
-     * hints; filling the input does not submit a command. Omission makes the input
+     * Invoked when the input changes, including accepted commands and examples; filling the input does not submit a command. Omission makes the input
      * read-only, for showing history.
      */
     onValueChange?: (value: string) => void;
     /**
-     * 命令发送成功后触发，失败时不触发。省略时不能提交命令。
-     * Called after a command is sent successfully; not called on failure. Omission
-     * disables submission.
+     * 用户显式提交时上报命令意图，宿主负责请求、权限和执行，并通过 records 回填状态。
+     * Reports an explicit submission intent. The host owns requests, permissions
+     * and execution, and supplies subsequent status through records. Omission disables submission.
      */
     onSubmit?: (command: string) => void;
     /**
-     * 资源成功打开后触发，参数为已打开的资源 URI；失败时不触发。
-     * Called after a resource opens successfully, with its URI; not called on failure.
+     * 点击资源 URI 时触发，由宿主接管打开；覆盖输入区、命令记录和结果中的链接。
+     * Called when a resource URI is activated in the input, command echo or results;
+     * the host owns navigation. Without a handler, text links use their native href.
      */
     onOpenUri?: (uri: string) => void;
     /**

package/dist/components/tui/use-tui-assist-position.d.ts

@@ -0,0 +1,3 @@
+import type { RefObject } from 'react';
+/** 顶层浮层保留组件的主题继承；不支持 Popover 的浏览器回退为内联面板。 */
+export declare function useTuiAssistPosition(anchorRef: RefObject<HTMLDivElement | null>, open: boolean, onDismiss: (value: string) => void): RefObject<HTMLDivElement | null>;

package/dist/components/tui/use-tui-completion.d.ts

@@ -0,0 +1,14 @@
+import type { TuiCommandDefinition, TuiCommandGroup } from './command-catalog.js';
+import type { TuiCommandInputMatch } from './command-input.js';
+import type { TuiCommandQuery } from './command-completion.js';
+import type { TuiCommandSection } from './command-definitions.js';
+export interface TuiCompletion {
+    query: TuiCommandQuery;
+    suggestions: readonly TuiCommandSection[];
+    options: readonly TuiCommandDefinition[];
+    activeInput: TuiCommandInputMatch | undefined;
+    showSuggestions: boolean;
+    enabled: boolean;
+}
+/** 由受控输入和宿主目录推导补全，无取数、执行或状态镜像。 */
+export declare function useTuiCompletion(value: string, enabled: boolean, commands: readonly TuiCommandDefinition[], groups?: readonly TuiCommandGroup[], paletteScope?: string | null): TuiCompletion;

package/dist/components/tui/use-tui-composer-keyboard.d.ts

@@ -0,0 +1,25 @@
+import type { KeyboardEvent, RefObject } from 'react';
+import type { TuiInlineCompletion } from './command-completion.js';
+import type { TuiCompletion } from './use-tui-completion.js';
+interface KeyboardOptions {
+    inputRef: RefObject<HTMLTextAreaElement | null>;
+    value: string;
+    history: readonly string[];
+    completion: TuiCompletion;
+    inline: TuiInlineCompletion | undefined;
+    disabled: boolean;
+    readOnly: boolean;
+    canSubmit: boolean;
+    activeIndex: number;
+    onActiveIndexChange: (index: number | ((current: number) => number)) => void;
+    onValueChange?: (value: string) => void;
+    onSubmit?: (command: string) => void;
+    onDismiss: (value: string) => void;
+    onRequestPalette: () => void;
+}
+/** 编辑、补全和历史互斥处理；普通 Tab 留在编辑器，Shift+Tab 可移出。 */
+export declare function useTuiComposerKeyboard({ inputRef, value, history, completion, inline, disabled, readOnly, canSubmit, activeIndex, onActiveIndexChange, onValueChange, onSubmit, onDismiss, onRequestPalette, }: KeyboardOptions): {
+    change: (next: string) => void;
+    handleKeyDown: (event: KeyboardEvent<HTMLTextAreaElement>) => void;
+};
+export {};

package/dist/components/viking-bot/ark-adapter.d.ts

@@ -0,0 +1,45 @@
+import type { ActivityTimelineItem } from '@ark-design/ui/activity-timeline';
+import type { VikingBotMessage, VikingBotMessagePart, VikingBotStreamingState } from './model.js';
+/**
+ * 把归一化片段映射成 Ark 的渲染输入。两种宿主的流事件在接入层就已经变成
+ * 这里的片段，因此映射只做形态转换，不再判断来源协议。
+ *
+ * Maps normalized parts onto Ark's render inputs. Both hosts already turn their
+ * own stream events into these parts in their integration layer, so this only
+ * converts shape and never inspects a source protocol.
+ */
+/** 消息渲染单元的标识，供 Ark 列表做 key 与测量。 */
+export interface VikingBotRenderItem {
+    /** 唯一标识。Stable key. */
+    id: string;
+    /** 来源消息；流式单元没有对应消息。Source message; the streaming unit has none. */
+    message?: VikingBotMessage;
+    /** 助手仍在生成时追加的片段。Parts appended while streaming. */
+    streaming?: VikingBotStreamingState;
+}
+/** 一轮回复的时间线条目，由推理与工具片段聚合而来。 */
+export interface VikingBotActivityGroup {
+    /** 执行块标识。Activity block key. */
+    id: string;
+    /** 条目。Items. */
+    items: ActivityTimelineItem[];
+}
+/**
+ * 把片段聚合成执行块：带 `groupId` 的相邻推理与工具片段归为一组，
+ * 其余片段原样保留，由调用方按类型分别渲染。
+ */
+export declare function groupActivityParts(parts: readonly VikingBotMessagePart[]): {
+    groups: Map<string, VikingBotActivityGroup>;
+    order: string[];
+};
+/**
+ * 把消息列表展平成 Ark 列表的渲染单元，流式片段插到 `insertIndex` 指定位置。
+ *
+ * 插入位置在原始消息序列上确定：调用方先按原始下标切分，再分别合并两侧，
+ * 避免先合并再适配导致下标含义改变、把边界两侧的助手消息并到一起。
+ *
+ * Flattens the messages into Ark render items, inserting the streaming unit at
+ * `insertIndex`. The boundary is resolved against the original sequence so
+ * merging on either side cannot shift its meaning.
+ */
+export declare function toRenderItems(messages: readonly VikingBotMessage[], streaming?: VikingBotStreamingState, group?: (messages: readonly VikingBotMessage[]) => VikingBotMessage[]): VikingBotRenderItem[];

package/dist/components/viking-bot/ark-message-body.d.ts

@@ -0,0 +1,16 @@
+import type { VikingBotMessage } from './model.js';
+import type { VikingBotMessageListProps } from './types.js';
+type Labels = NonNullable<VikingBotMessageListProps['labels']>;
+/** Markdown 或纯文本正文。A Markdown or plain-text body. */
+export declare function MessageText({ text, streaming, format, }: {
+    text: string;
+    streaming?: boolean;
+    format?: 'plain' | 'markdown';
+}): import("react").JSX.Element;
+/** 消息正文：执行块在前，其余片段按顺序渲染。 */
+export declare function MessageBody({ message, labels, onOpenUri, }: {
+    message: VikingBotMessage;
+    labels: Labels;
+    onOpenUri?: (uri: string) => void;
+}): import("react").JSX.Element;
+export {};

package/dist/components/viking-bot/ark-message-list-view.d.ts

@@ -0,0 +1,7 @@
+import type { VikingBotMessageListProps } from './types.js';
+/**
+ * Ark 渲染的消息列表。只在懒加载边界之后加载，因此可以静态引用 Ark。
+ * The Ark-rendered message list. Loaded behind the lazy boundary, so it may
+ * import Ark statically.
+ */
+export declare function VikingBotMessageListView({ messages, className, streaming, footer, listKey, onOpenUri, onCopy, onMessageAction, renderMessage, labels: overrides, }: VikingBotMessageListProps): import("react").JSX.Element;

package/dist/components/viking-bot/ark-message-row.d.ts

@@ -0,0 +1,19 @@
+import type { VikingBotMessage, VikingBotStreamingState } from './model.js';
+import type { VikingBotMessageListProps } from './types.js';
+type Labels = NonNullable<VikingBotMessageListProps['labels']>;
+/** 单条消息。One message. */
+export declare function VikingBotMessageRow({ message, labels, onOpenUri, onCopy, onMessageAction, renderMessage, }: {
+    message: VikingBotMessage;
+    labels: Labels;
+    onOpenUri?: (uri: string) => void;
+    onCopy?: (text: string) => void;
+    onMessageAction?: (messageId: string, actionKey: string) => void;
+    renderMessage?: (message: VikingBotMessage) => React.ReactNode;
+}): import("react").JSX.Element;
+/** 助手仍在生成时的单元。The in-flight assistant unit. */
+export declare function VikingBotStreamingRow({ streaming, labels, onOpenUri, }: {
+    streaming: VikingBotStreamingState;
+    labels: Labels;
+    onOpenUri?: (uri: string) => void;
+}): import("react").JSX.Element;
+export {};

package/dist/components/viking-bot/index.d.ts

@@ -0,0 +1,10 @@
+export { VikingBot } from './viking-bot.js';
+export { VikingBotComposer } from './lazy-composer.js';
+export { VikingBotMessageList } from './viking-bot-message-list.js';
+export { VikingBotInteraction, DEFAULT_INTERACTION_LABELS, } from './interaction/index.js';
+export type { InteractionLabels } from './interaction/index.js';
+export { DEFAULT_LABELS } from './labels.js';
+export { groupByActivity, groupMessages, messageText, } from './message-groups.js';
+export type { VikingBotAttachment, VikingBotAttachmentPart, VikingBotContextPart, VikingBotDraft, VikingBotImagePart, VikingBotIterationPart, VikingBotLabels, VikingBotMessage, VikingBotMessagePart, VikingBotReasoningPart, VikingBotStreamingState, VikingBotTextPart, VikingBotToolPart, VikingBotToolResultPart, } from './model.js';
+export type { VikingBotComposerProps, VikingBotComposerRef, VikingBotMessageListProps, VikingBotProps, } from './types.js';
+export type { VikingBotInteractionAnswer, VikingBotInteractionLabels, VikingBotInteractionOption, VikingBotInteractionProps, VikingBotInteractionRenderContext, VikingBotInteractionRequest, VikingBotRepairOption, VikingBotScheduleValue, } from './interaction/types.js';

package/dist/components/viking-bot/interaction/ask-human-fields.d.ts

@@ -0,0 +1,10 @@
+import type { AskHumanField, AskHumanValue } from '@ark-design/ui/ask-human';
+import type { VikingBotInteractionAnswer, VikingBotInteractionRequest } from './types.js';
+/** 把请求转成 AskHuman 的字段描述。 */
+export declare const toFields: (request: VikingBotInteractionRequest) => AskHumanField[];
+/** 把 AskHuman 的提交值转回交互答案。 */
+export declare const toAnswer: (request: VikingBotInteractionRequest, value: AskHumanValue) => VikingBotInteractionAnswer;
+/** 按 request 计算 AskHuman 的初始答案，保证预填值与提交值一致。 */
+export declare const toDefaultValue: (request: VikingBotInteractionRequest) => AskHumanValue | undefined;
+/** 选择类问题必须选中有效选项；其他类型按自身初始值即可提交。 */
+export declare const isValidAnswer: (request: VikingBotInteractionRequest, value: AskHumanValue) => boolean;

package/dist/components/viking-bot/interaction/index.d.ts

@@ -0,0 +1,4 @@
+export { VikingBotInteraction } from './lazy-interaction.js';
+export { DEFAULT_INTERACTION_LABELS } from './labels.js';
+export type { InteractionLabels } from './labels.js';
+export type { VikingBotInteractionAnswer, VikingBotInteractionLabels, VikingBotInteractionOption, VikingBotInteractionProps, VikingBotInteractionRenderContext, VikingBotInteractionRequest, VikingBotRepairOption, VikingBotScheduleValue, } from './types.js';

package/dist/components/viking-bot/interaction/labels.d.ts

@@ -0,0 +1,7 @@
+import type { VikingBotInteractionLabels } from './types.js';
+/** 内部完整文案类型，从公开类型派生，保证宿主可覆盖每一处文案。 */
+export type InteractionLabels = Required<Omit<VikingBotInteractionLabels, 'progress'>> & {
+    progress: (index: number, total: number) => string;
+};
+/** 内置交互区文案。Built-in interaction copy. */
+export declare const DEFAULT_INTERACTION_LABELS: InteractionLabels;

package/dist/components/viking-bot/interaction/lazy-interaction.d.ts

@@ -0,0 +1,3 @@
+import type { VikingBotInteractionProps } from './types.js';
+/** 待确认交互区。The pending-interaction area. */
+export declare function VikingBotInteraction(props: VikingBotInteractionProps): import("react").JSX.Element;

package/dist/components/viking-bot/interaction/schedule-input.d.ts

@@ -0,0 +1,13 @@
+import type { InteractionLabels } from './labels.js';
+import type { VikingBotInteractionRequest } from './types.js';
+type ScheduleRequest = Extract<VikingBotInteractionRequest, {
+    kind: 'schedule';
+}>;
+/** 定时输入。Schedule input. */
+export declare function ScheduleInput({ request, labels, disabled, onChange, }: {
+    request: ScheduleRequest;
+    labels: InteractionLabels;
+    disabled?: boolean;
+    onChange: (value: unknown) => void;
+}): import("react").JSX.Element;
+export {};