@openviking/react 0.1.0 → 0.1.2

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

@@ -0,0 +1,527 @@
+import type { HTMLAttributes, ReactNode } from 'react';
+import type { TuiCommandDefinition, TuiCommandGroup } from './command-catalog.js';
+/**
+ * 一条执行记录的状态。
+ * Status of one execution record.
+ */
+export type TuiRecordStatus = 
+/**
+ * 执行中。
+ * Still running.
+ */
+'pending'
+/**
+ * 执行成功。
+ * Finished successfully.
+ */
+ | 'success'
+/**
+ * 执行失败。
+ * Finished with an error.
+ */
+ | 'error';
+/** 检索结果卡片中的一行。One row of a search result card. */
+export interface TuiSearchResultItem {
+    /**
+     * 行唯一标识。
+     * Unique row key.
+     */
+    id: string;
+    /**
+     * 主标题。
+     * Primary title.
+     */
+    title: string;
+    /**
+     * 次要标签，例如路径或文件类型。
+     * Secondary label, for example a path or file type.
+     */
+    metaLabel?: string;
+    /**
+     * 标题旁的内容层级标签。
+     * Content level label next to the title.
+     */
+    levelLabel?: string;
+    /**
+     * 分数旁的结果类型标签。
+     * Result type label next to the score.
+     */
+    typeLabel?: string;
+    /**
+     * 宿主计算出的分数，显示在右侧。
+     * Score rendered on the right when the host computes one.
+     */
+    scoreLabel?: string;
+    /**
+     * 悬停或键盘聚焦分数时展示的详情；仅在提供 `scoreLabel` 时显示。
+     * Details shown on score hover or keyboard focus; requires `scoreLabel`.
+     */
+    scoreDetails?: ReactNode;
+    /**
+     * 标题下方的摘录。
+     * Short excerpt shown under the title.
+     */
+    preview?: string;
+    /**
+     * 该结果对应的资源 URI，可用于打开。
+     * URI of the result, which can be opened.
+     */
+    uri?: string;
+}
+/** 资源树行内的一条键值明细。One key/value detail row inside a resource tree item. */
+export interface TuiResourceTreeDetailRow {
+    /**
+     * 明细标签。
+     * Detail label.
+     */
+    label: string;
+    /**
+     * 明细值。
+     * Detail value.
+     */
+    value: string;
+}
+/** 资源树结果卡片中的一行。One row of a resource tree card. */
+export interface TuiResourceTreeItem {
+    /**
+     * 行唯一标识。
+     * Unique row key.
+     */
+    id: string;
+    /**
+     * 主标题。
+     * Primary title.
+     */
+    title: string;
+    /**
+     * 次要标签。
+     * Secondary label.
+     */
+    metaLabel?: string;
+    /**
+     * 行内展示的键值明细。
+     * Key/value rows shown inside the item.
+     */
+    detailRows?: readonly TuiResourceTreeDetailRow[];
+    /**
+     * 该资源对应的 URI，可用于打开。
+     * URI of the resource, which can be opened.
+     */
+    uri?: string;
+}
+/** 状态卡片中的一行键值。One key/value row of a status card. */
+export interface TuiStatusRow {
+    /**
+     * 行标签。
+     * Row label.
+     */
+    label: string;
+    /**
+     * 行内容，由宿主渲染。
+     * Row content, rendered by the host.
+     */
+    value: ReactNode;
+    /**
+     * 展示形态：单行、长文本或多行等宽文本。
+     * Display form: inline, long text or preformatted text.
+     */
+    variant?: 
+    /**
+     * 单行展示。
+     * Rendered on a single line.
+     */
+    'inline'
+    /**
+     * 长文本，自动换行。
+     * Long text that wraps.
+     */
+     | 'long-text'
+    /**
+     * 多行等宽文本。
+     * Multi-line preformatted text.
+     */
+     | 'pre';
+}
+/** 通用文本结果。A general text result. */
+export interface TuiTextContent {
+    /**
+     * 变体标记，固定为 `text`。
+     * Variant discriminator, always `text`.
+     */
+    variant: 'text';
+    /**
+     * 文本正文。
+     * Text body.
+     */
+    text: string;
+    /**
+     * 文本格式，缺省为 `plain`。
+     * Text format; defaults to `plain`.
+     */
+    format?: 'plain' | 'markdown';
+}
+/** 检索结果列表。A list of search results. */
+export interface TuiSearchListContent {
+    /**
+     * 变体标记，固定为 `search-list`。
+     * Variant discriminator, always `search-list`.
+     */
+    variant: 'search-list';
+    /**
+     * 结果行。
+     * Result rows.
+     */
+    items: readonly TuiSearchResultItem[];
+    /**
+     * 列表上方的汇总信息，由宿主渲染。
+     * Summary above the list, rendered by the host.
+     */
+    summary?: ReactNode;
+}
+/**
+ * 单个资源的预览结果，例如读取一个文件。
+ *
+ * A preview of one resource, for example reading a file.
+ */
+export interface TuiResourcePreviewContent {
+    /**
+     * 变体标记，固定为 `resource-preview`。
+     * Variant discriminator, always `resource-preview`.
+     */
+    variant: 'resource-preview';
+    /**
+     * 资源标题。
+     * Resource title.
+     */
+    title: string;
+    /**
+     * 正文，通常是文件内容。
+     * Body, usually the file content.
+     */
+    content: string;
+    /**
+     * 标题下方的元信息，例如类型与大小，按顺序以分隔符连接展示。
+     * Metadata under the title, for example type and size, joined in order.
+     */
+    meta?: readonly string[];
+    /**
+     * 没有 `meta` 时使用的单行说明。
+     * Single-line description used when `meta` is absent.
+     */
+    description?: string;
+    /**
+     * 资源自身的 URI，显示为可点击入口。
+     * The resource's own URI, rendered as an openable entry.
+     */
+    uri?: string;
+    /**
+     * 点击 URI 时跳转到的位置；省略时使用 `uri`。
+     * Where clicking the URI navigates to; `uri` is used when omitted.
+     */
+    navigationUri?: string;
+}
+/** 资源树结果。A resource tree result. */
+export interface TuiResourceTreeContent {
+    /**
+     * 变体标记，固定为 `resource-tree`。
+     * Variant discriminator, always `resource-tree`.
+     */
+    variant: 'resource-tree';
+    /**
+     * 资源行。
+     * Resource rows.
+     */
+    items: readonly TuiResourceTreeItem[];
+    /**
+     * 卡片标题。
+     * Card title.
+     */
+    title?: string;
+}
+/** 状态卡片。A status card. */
+export interface TuiStatusContent {
+    /**
+     * 变体标记，固定为 `status`。
+     * Variant discriminator, always `status`.
+     */
+    variant: 'status';
+    /**
+     * 键值行。
+     * Key/value rows.
+     */
+    rows: readonly TuiStatusRow[];
+    /**
+     * 卡片标题。
+     * Card title.
+     */
+    title?: string;
+}
+/** 写入结果。A write result. */
+export interface TuiWriteResultContent {
+    /**
+     * 变体标记，固定为 `write-result`。
+     * Variant discriminator, always `write-result`.
+     */
+    variant: 'write-result';
+    /**
+     * 结果行，由宿主渲染。
+     * Result lines, rendered by the host.
+     */
+    lines: readonly ReactNode[];
+    /**
+     * 卡片标题。
+     * Card title.
+     */
+    title?: string;
+}
+/**
+ * 命令帮助结果：按分组列出可用命令。
+ *
+ * A command-help result: available commands listed in groups.
+ */
+export interface TuiCommandHelpContent {
+    /**
+     * 变体标记，固定为 `command-help`。
+     * Variant discriminator, always `command-help`.
+     */
+    variant: 'command-help';
+    /**
+     * 命令分组。
+     * Command groups.
+     */
+    sections: readonly TuiCommandHelpSection[];
+}
+/** 命令帮助中的一组命令。One group of commands in the help result. */
+export interface TuiCommandHelpSection {
+    /**
+     * 分组唯一标识。
+     * Unique section key.
+     */
+    key: string;
+    /**
+     * 分组标题。
+     * Section title.
+     */
+    label: string;
+    /**
+     * 该组下的命令。
+     * Commands in this group.
+     */
+    items: readonly TuiCommandHelpItem[];
+}
+/** 命令帮助中的一条命令。One command in the help result. */
+export interface TuiCommandHelpItem {
+    /**
+     * 命令唯一标识。
+     * Unique command key.
+     */
+    key: string;
+    /**
+     * 用于显示和填入的命令文本。
+     * Command text used for display and insertion.
+     */
+    name: string;
+    /**
+     * 命令说明。
+     * Command description.
+     */
+    description?: string;
+}
+/** 命令结果内容。Command result content. */
+export type TuiRecordContent = TuiTextContent | TuiSearchListContent | TuiResourcePreviewContent | TuiResourceTreeContent | TuiStatusContent | TuiWriteResultContent | TuiCommandHelpContent;
+/** 一条执行记录。One execution record. */
+export interface TuiRecord {
+    /**
+     * 记录唯一标识。
+     * Unique record key.
+     */
+    id: string;
+    /**
+     * 提交的命令文本，显示在结果上方。
+     * The submitted command text, echoed above the result.
+     */
+    command: string;
+    /**
+     * 当前记录的执行状态；不控制其他命令的提交。
+     * Execution status of this record; does not control other submissions.
+     */
+    status: TuiRecordStatus;
+    /**
+     * 执行结果，进行中时省略。
+     * Execution result, omitted while pending.
+     */
+    content?: TuiRecordContent;
+    /**
+     * 未提供有效 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;
+}
+/**
+ * 可替换的界面文案，默认英文。
+ * Replaceable interface copy, defaulting to English.
+ */
+export interface TuiLabels {
+    /**
+     * 输入框占位文本。
+     * Input placeholder.
+     */
+    placeholder?: string;
+    /**
+     * `disabled` 为 `true` 时展示的不可用提示；文案本身不控制禁用状态。
+     * Unavailable message shown when `disabled` is `true`; copy does not control
+     * the disabled state.
+     */
+    unavailableMessage?: string;
+    /**
+     * 底部发送快捷键的说明文案。
+     * 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.
+     */
+    suggestions?: string;
+    /**
+     * 无匹配建议时的提示。
+     * Message shown when no suggestion matches.
+     */
+    noSuggestions?: string;
+    /**
+     * 等待中的状态文本。
+     * Text for the pending state.
+     */
+    pending?: string;
+    /**
+     * 执行成功状态文本。
+     * Text for the success status.
+     */
+    success?: string;
+    /**
+     * 执行失败状态文本。
+     * Text for the error status.
+     */
+    error?: string;
+    /**
+     * 复制按钮文案。
+     * Copy button label.
+     */
+    copy?: string;
+    /**
+     * 复制成功提示。
+     * Message shown after a successful copy.
+     */
+    copied?: string;
+    /**
+     * 无记录时的提示。
+     * 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;
+}
+/**
+ * 当前命令记录、结果与输入区的公开接口；会话、历史面板和外层工具栏由宿主组合。
+ * 提供命令补全、参数提示与帮助。
+ * Public interface for current command records, results and input. The host
+ * composes session controls, history panels and surrounding toolbars separately.
+ * Provides command completion, parameter hints and help.
+ */
+export interface TuiProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onCopy' | 'onSubmit'> {
+    /**
+     * 当前展示的执行记录，按提交顺序排列；会话与历史切换后由宿主更新。
+     * Currently displayed execution records in submission order, updated by the
+     * host when switching sessions or historical results.
+     */
+    records: readonly TuiRecord[];
+    /**
+     * 受控的输入值。
+     * Controlled input value.
+     */
+    value: string;
+    /**
+     * 是否禁用命令输入与提交，缺省为 `false`。
+     * 禁用时的提示文案由 `labels.unavailableMessage` 提供。
+     * Whether command input and submission are disabled; defaults to `false`.
+     * Disabled copy comes from `labels.unavailableMessage`.
+     */
+    disabled?: boolean;
+    /**
+     * 无记录时展示的完整空态节点，可包含标题、说明与快捷入口。
+     * 省略时展示 `labels.empty`，传 `null` 时隐藏空态内容。
+     * Complete empty-state node when there are no records; may include a
+     * heading, description and shortcuts. Omission shows `labels.empty`;
+     * passing `null` hides empty-state content.
+     */
+    emptyState?: ReactNode;
+    /** 内置界面文案的语言，默认英文；命令文案由宿主提供。 */
+    locale?: 'en' | 'zh';
+    /** 宿主提供的命令目录；省略时无候选和参数帮助，仍可提交文本。 */
+    commands?: readonly TuiCommandDefinition[];
+    /** 宿主提供的分组名称与顺序；未声明的组按目录顺序追加。 */
+    commandGroups?: readonly TuiCommandGroup[];
+    /**
+     * 输入值变化时触发，包括接受命令或示例；行内占位不改变值，也不提交。省略时输入框
+     * 只读，用于展示历史记录。
+     * 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;
+    /**
+     * 用户显式提交时上报命令意图，宿主负责请求、权限和执行，并通过 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 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;
+    /**
+     * 复制成功后触发，参数为已复制的文本；复制失败时不触发。
+     * Called after copying succeeds, with the copied text; not called on failure.
+     */
+    onCopy?: (text: string) => void;
+    /**
+     * 统一的界面文案与引导提示；仅替换展示内容，不改变可用性。
+     * Interface copy and guidance; replaces display content without changing
+     * availability.
+     */
+    labels?: TuiLabels;
+}

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/tui.js

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

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;