@openviking/react 0.1.3 → 0.1.4

package/dist/components/viking-bot/tool-activity.d.ts

@@ -0,0 +1,9 @@
+import type { ActivityItemRenderContext, McpToolCallActivityItem } from '@ark-design/ui/activity-timeline';
+import type { VikingBotLabels, VikingBotToolResultLink } from './model.js';
+/** Keep Ark's tool row/icon; supply the reference version's input/output details. */
+export declare function ToolActivity({ context, labels, onOpenUri, results, }: {
+    context: ActivityItemRenderContext<McpToolCallActivityItem>;
+    labels: VikingBotLabels;
+    onOpenUri?: (uri: string) => void;
+    results?: readonly VikingBotToolResultLink[];
+}): import("react").JSX.Element;

package/dist/components/viking-bot/tool-result-links.d.ts

@@ -0,0 +1,6 @@
+import type { VikingBotLabels, VikingBotToolResultLink } from './model.js';
+export declare function ToolResultLinks({ results, labels, onOpenUri, }: {
+    results: readonly VikingBotToolResultLink[];
+    labels: VikingBotLabels;
+    onOpenUri?: (uri: string) => void;
+}): import("react").JSX.Element;

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

@@ -1,10 +1,14 @@
+import type { Locale } from '../../shared/locale.js';
 import type { HTMLAttributes, ReactNode, RefObject } from 'react';
 import type { VikingBotInteractionProps } from './interaction/types.js';
+import type { VikingBotInputFeatures, VikingBotSessions } from './capabilities.js';
 import type { VikingBotAttachment, VikingBotDraft, VikingBotLabels, VikingBotMessage, VikingBotStreamingState } from './model.js';
 /** 消息列表的公开接口。Public interface of the message list. */
 export interface VikingBotMessageListProps {
     /** 当前会话的消息。Messages in the current session. */
     messages: readonly VikingBotMessage[];
+    /** 内置中英文文案的语言。Language of the built-in interface copy. */
+    locale: Locale;
     /** 附加到根元素的类名。Class name applied to the root element. */
     className?: string;
     /** 助手仍在生成时追加的片段。Parts appended while the assistant is still streaming. */
@@ -21,7 +25,7 @@ export interface VikingBotMessageListProps {
     onMessageAction?: (messageId: string, actionKey: string) => void;
     /** 消息正文的替换渲染，用于宿主自带 Markdown 渲染器。Replaces message bodies. */
     renderMessage?: (message: VikingBotMessage) => ReactNode;
-    /** 可替换文案，缺省为英文。Replaceable copy; English by default. */
+    /** 可替换文案，未提供的项使用当前 locale 的内置文案。Replaceable copy; omitted fields follow locale. */
     labels?: VikingBotLabels;
 }
 /** 输入区的命令式入口。Imperative handle of the composer. */
@@ -34,15 +38,17 @@ export interface VikingBotComposerRef {
     addFiles: (files: readonly File[]) => void;
     /** 是否已达到附件数量上限。Whether the attachment limit has been reached. */
     isAttachmentLimitReached: () => boolean;
-    /** 清空输入框与待发送附件。Clears the input and pending attachments. */
+    /** 清空输入文本；附件与引用由宿主重置。Clears text; the host resets attachments and references. */
     clear: () => void;
     /** 聚焦输入框。Focuses the input. */
     focus: () => void;
 }
 /** 输入区的公开接口。Public interface of the composer. */
-export interface VikingBotComposerProps {
+export interface VikingBotComposerProps extends VikingBotInputFeatures {
     /** 受控的草稿文本。Controlled draft text. */
     value: string;
+    /** 内置中英文文案的语言。Language of the built-in interface copy. */
+    locale: Locale;
     /** 附加到根元素的类名。Class name applied to the root element. */
     className?: string;
     /** 宿主已选中的附件。Attachments already selected by the host. */
@@ -71,13 +77,19 @@ export interface VikingBotComposerProps {
     onSend?: (draft: VikingBotDraft) => void;
     /** 停止正在进行的回复。省略时不展示停止动作。Stops the streaming reply. */
     onCancel?: () => void;
-    /** 可替换文案，缺省为英文。Replaceable copy; English by default. */
+    /** 可替换文案，未提供的项使用当前 locale 的内置文案。Replaceable copy; omitted fields follow locale. */
     labels?: VikingBotLabels;
 }
 /** 完整对话区的公开接口。Public interface of the whole conversation view. */
-export interface VikingBotProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onCopy' | 'onSubmit'> {
+export interface VikingBotProps extends VikingBotInputFeatures, Omit<HTMLAttributes<HTMLDivElement>, 'onCopy' | 'onSubmit'> {
     /** 当前会话的消息。Messages in the current session. */
     messages: readonly VikingBotMessage[];
+    /** 内置中英文文案的语言。Language of the built-in interface copy. */
+    locale: Locale;
+    /** Host-owned session history and actions. */
+    sessions?: VikingBotSessions;
+    /** Optional extension controls, such as a host-provided More menu. */
+    headerActions?: ReactNode;
     /** 附加到根元素的类名。Class name applied to the root element. */
     className?: string;
     /** 助手仍在生成时追加的片段。Parts appended while the assistant is still streaming. */
@@ -92,7 +104,7 @@ export interface VikingBotProps extends Omit<HTMLAttributes<HTMLDivElement>, 'on
     isAvailable?: boolean;
     /** 不可用时的说明。Message shown while the bot is unavailable. */
     unavailableMessage?: string;
-    /** 首条消息之前替代消息列表显示的内容。Shown instead of the list before the first message. */
+    /** 首条消息前的内容；undefined 使用欢迎页，null 隐藏。Empty content: undefined uses welcome; null hides it. */
     emptyState?: ReactNode;
     /** 头部插槽，例如会话标题或历史按钮。Header slot. */
     header?: ReactNode;
@@ -100,7 +112,7 @@ export interface VikingBotProps extends Omit<HTMLAttributes<HTMLDivElement>, 'on
     footer?: ReactNode;
     /** 替换整个主体，用于宿主自定义组合。Replaces the whole body. */
     children?: ReactNode;
-    /** 替换消息列表，用于宿主自带渲染底座。Replaces the message list. */
+    /** 替换消息列表，优先于空态；null 隐藏。Replaces the list, including empty state; null hides it. */
     messageList?: ReactNode;
     /** 替换输入区，用于宿主自带输入组件。Replaces the composer. */
     composer?: ReactNode;
@@ -108,7 +120,7 @@ export interface VikingBotProps extends Omit<HTMLAttributes<HTMLDivElement>, 'on
      * 待确认交互的配置；存在时替代输入区。
      * Configuration of a pending interaction; replaces the composer.
      */
-    interaction?: VikingBotInteractionProps;
+    interaction?: Omit<VikingBotInteractionProps, 'locale'>;
     /**
      * 整块替换交互区；传值时忽略 `interaction` 的内置渲染，宿主自行渲染。
      * Replaces the whole interaction area; when set, the built-in rendering of
@@ -135,6 +147,6 @@ export interface VikingBotProps extends Omit<HTMLAttributes<HTMLDivElement>, 'on
     onCopy?: (text: string) => void;
     /** 触发一条消息声明的动作。Fires a message action. */
     onMessageAction?: (messageId: string, actionKey: string) => void;
-    /** 可替换文案，缺省为英文。Replaceable copy; English by default. */
+    /** 可替换文案，未提供的项使用当前 locale 的内置文案。Replaceable copy; omitted fields follow locale. */
     labels?: VikingBotLabels;
 }

package/dist/components/viking-bot/use-quick-input.d.ts

@@ -0,0 +1,17 @@
+import type { VikingBotQuickInput } from './capabilities.js';
+export declare const QuickInputScope: import("react").Context<{
+    snapshot: () => import("./quick-input-tracker.js").PromptSnapshot;
+    edit: (next: string, caret?: number) => void;
+    release(): void;
+    insert(value: string, prompt: string): string;
+} | null>;
+/** Track only the prompt this instance inserted, leaving custom text intact. */
+export declare function useQuickInput(value: string, onChange: (text: string) => void, onSelect?: (input: VikingBotQuickInput) => void, ownsScope?: boolean): {
+    tracker: {
+        snapshot: () => import("./quick-input-tracker.js").PromptSnapshot;
+        edit: (next: string, caret?: number) => void;
+        release(): void;
+        insert(value: string, prompt: string): string;
+    };
+    select(input: VikingBotQuickInput): void;
+};

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

@@ -1,16 +1,11 @@
 import type { VikingBotProps } from './types.js';
 /**
- * 占位组件：仅按 props 契约渲染可用视图，未经设计评审，真实实现待重写。
- *
  * 完整对话区。消息列表、输入区与待确认交互都可被宿主替换：
  * 传 `messageList`、`composer` 或 `interaction` 时使用宿主的渲染底座，
  * 不传时使用内置实现。
  *
- * Placeholder: renders a working view against the props contract only, pending
- * design review; the real implementation will be rewritten.
- *
  * The whole conversation view. The message list, the composer and the pending
  * interaction can each be replaced by the host; the built-in implementations
  * are used when they are omitted.
  */
-export declare function VikingBot({ messages, className, streaming, draft, attachments, isSending, isAvailable, unavailableMessage, emptyState, header, footer, children, messageList, composer, interaction, interactionSlot, listKey, composerRef, onDraftChange, onFilesAdded, onAttachmentRemove, onSend, onCancel, onOpenUri, onCopy, onMessageAction, labels: overrides, ...rest }: VikingBotProps): import("react").JSX.Element;
+export declare function VikingBot({ messages, className, streaming, draft, attachments, isSending, isAvailable, unavailableMessage, emptyState, header, sessions, headerActions, locale, quickInputs, onQuickInputSelect, references, footer, children, messageList, composer, interaction, interactionSlot, listKey, composerRef, onDraftChange, onFilesAdded, onAttachmentRemove, onSend, onCancel, onOpenUri, onCopy, onMessageAction, labels: overrides, ...rest }: VikingBotProps): import("react").JSX.Element;

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

@@ -0,0 +1,8 @@
+import type { VikingBotQuickInput } from './capabilities.js';
+import type { VikingBotLabels } from './model.js';
+export declare function VikingBotWelcome({ labels, quickInputs, onSelect, disabled, }: {
+    labels: Required<VikingBotLabels>;
+    quickInputs?: readonly VikingBotQuickInput[];
+    onSelect: (input: VikingBotQuickInput) => void;
+    disabled?: boolean;
+}): import("react").JSX.Element;

package/dist/components/viking-bot.js

@@ -1,4 +1,4 @@
 export { DEFAULT_INTERACTION_LABELS } from "../c7~0.js";
-export { DEFAULT_LABELS, VikingBot, VikingBotComposer, VikingBotMessageList } from "../c~0.js";
+export { DEFAULT_LABELS, VikingBot, VikingBotComposer, VikingBotMessageList, VikingBotSessionActions } from "../c~0.js";
 export { VikingBotInteraction } from "../w~0.js";
 export { groupByActivity, groupMessages, messageText } from "../h~0.js";