@openviking/react 0.1.0 → 0.1.2

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

@@ -0,0 +1,140 @@
+import type { HTMLAttributes, ReactNode, RefObject } from 'react';
+import type { VikingBotInteractionProps } from './interaction/types.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[];
+    /** 附加到根元素的类名。Class name applied to the root element. */
+    className?: string;
+    /** 助手仍在生成时追加的片段。Parts appended while the assistant is still streaming. */
+    streaming?: VikingBotStreamingState;
+    /** 渲染在最后一条消息之后，例如记忆提交提示条。Rendered after the last message. */
+    footer?: ReactNode;
+    /** 当前身份作用域的标识；值变化时重置展示状态。Identity scope; changes reset display state. */
+    listKey?: string;
+    /** 打开消息中引用的资源。Opens a resource referenced by a message. */
+    onOpenUri?: (uri: string) => void;
+    /** 复制由宿主执行，列表只上报意图。The host copies; the list reports intent. */
+    onCopy?: (text: string) => void;
+    /** 触发一条消息声明的动作，例如提交记忆。Fires a message action. */
+    onMessageAction?: (messageId: string, actionKey: string) => void;
+    /** 消息正文的替换渲染，用于宿主自带 Markdown 渲染器。Replaces message bodies. */
+    renderMessage?: (message: VikingBotMessage) => ReactNode;
+    /** 可替换文案，缺省为英文。Replaceable copy; English by default. */
+    labels?: VikingBotLabels;
+}
+/** 输入区的命令式入口。Imperative handle of the composer. */
+export interface VikingBotComposerRef {
+    /** 替换输入文本。Replaces the input text. */
+    setText: (text: string) => void;
+    /** 追加文本，保留已编辑的草稿。Appends text, keeping the current draft. */
+    appendText: (text: string) => void;
+    /** 添加在输入区外拖入的文件。Adds files dropped outside the input area. */
+    addFiles: (files: readonly File[]) => void;
+    /** 是否已达到附件数量上限。Whether the attachment limit has been reached. */
+    isAttachmentLimitReached: () => boolean;
+    /** 清空输入框与待发送附件。Clears the input and pending attachments. */
+    clear: () => void;
+    /** 聚焦输入框。Focuses the input. */
+    focus: () => void;
+}
+/** 输入区的公开接口。Public interface of the composer. */
+export interface VikingBotComposerProps {
+    /** 受控的草稿文本。Controlled draft text. */
+    value: string;
+    /** 附加到根元素的类名。Class name applied to the root element. */
+    className?: string;
+    /** 宿主已选中的附件。Attachments already selected by the host. */
+    attachments?: readonly VikingBotAttachment[];
+    /** 是否禁用发送；原因与提示由宿主决定。Disables sending; the host owns the reason. */
+    disabled?: boolean;
+    /** 禁用时展示的说明。Reason shown while the composer is disabled. */
+    disabledReason?: string;
+    /** 是否正在回复；回复中停止动作替代发送。Whether a reply is streaming. */
+    isSending?: boolean;
+    /** 输入区布局形态。Layout of the input area. */
+    variant?: 'default' | 'compact';
+    /** 宿主接受的 MIME 类型。MIME types the host accepts. */
+    accept?: string;
+    /** 宿主允许的最大附件数。Maximum number of attachments the host allows. */
+    maxAttachments?: number;
+    /** 发送按钮旁的额外控件。Extra controls rendered next to the send button. */
+    actions?: ReactNode;
+    /** 输入值变化时触发。省略时输入框只读。Invoked when the input changes. */
+    onValueChange?: (value: string) => void;
+    /** 上报用户选择或拖入的文件；由宿主上传。Reports files the user picked or dropped. */
+    onFilesAdded?: (files: readonly File[]) => void;
+    /** 移除一个附件。Removes an attachment. */
+    onAttachmentRemove?: (attachment: VikingBotAttachment) => void;
+    /** 上报发送意图；由宿主发送并清空草稿。省略时不能发送。Reports the send intent. */
+    onSend?: (draft: VikingBotDraft) => void;
+    /** 停止正在进行的回复。省略时不展示停止动作。Stops the streaming reply. */
+    onCancel?: () => void;
+    /** 可替换文案，缺省为英文。Replaceable copy; English by default. */
+    labels?: VikingBotLabels;
+}
+/** 完整对话区的公开接口。Public interface of the whole conversation view. */
+export interface VikingBotProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onCopy' | 'onSubmit'> {
+    /** 当前会话的消息。Messages in the current session. */
+    messages: readonly VikingBotMessage[];
+    /** 附加到根元素的类名。Class name applied to the root element. */
+    className?: string;
+    /** 助手仍在生成时追加的片段。Parts appended while the assistant is still streaming. */
+    streaming?: VikingBotStreamingState;
+    /** 受控的草稿文本；不传则不展示输入区。Controlled draft text; omit to hide the composer. */
+    draft?: string;
+    /** 宿主已选中的附件。Attachments already selected by the host. */
+    attachments?: readonly VikingBotAttachment[];
+    /** 是否正在回复。Whether a reply is streaming. */
+    isSending?: boolean;
+    /** 是否可接受输入。Whether the bot can accept input. */
+    isAvailable?: boolean;
+    /** 不可用时的说明。Message shown while the bot is unavailable. */
+    unavailableMessage?: string;
+    /** 首条消息之前替代消息列表显示的内容。Shown instead of the list before the first message. */
+    emptyState?: ReactNode;
+    /** 头部插槽，例如会话标题或历史按钮。Header slot. */
+    header?: ReactNode;
+    /** 渲染在输入区上方，例如记忆提交提示条。Rendered above the composer. */
+    footer?: ReactNode;
+    /** 替换整个主体，用于宿主自定义组合。Replaces the whole body. */
+    children?: ReactNode;
+    /** 替换消息列表，用于宿主自带渲染底座。Replaces the message list. */
+    messageList?: ReactNode;
+    /** 替换输入区，用于宿主自带输入组件。Replaces the composer. */
+    composer?: ReactNode;
+    /**
+     * 待确认交互的配置；存在时替代输入区。
+     * Configuration of a pending interaction; replaces the composer.
+     */
+    interaction?: VikingBotInteractionProps;
+    /**
+     * 整块替换交互区；传值时忽略 `interaction` 的内置渲染，宿主自行渲染。
+     * Replaces the whole interaction area; when set, the built-in rendering of
+     * `interaction` is skipped and the host renders its own.
+     */
+    interactionSlot?: ReactNode;
+    /** 当前身份作用域的标识；值变化时重置展示状态。Identity scope; changes reset display state. */
+    listKey?: string;
+    /** 输入区的命令式入口。Imperative handle of the composer. */
+    composerRef?: RefObject<VikingBotComposerRef | null>;
+    /** 草稿变化时触发。Invoked when the draft changes. */
+    onDraftChange?: (value: string) => void;
+    /** 上报用户选择或拖入的文件；由宿主上传。Reports files the user picked or dropped. */
+    onFilesAdded?: (files: readonly File[]) => void;
+    /** 移除一个附件。Removes an attachment. */
+    onAttachmentRemove?: (attachment: VikingBotAttachment) => void;
+    /** 上报发送意图。Reports the send intent. */
+    onSend?: (draft: VikingBotDraft) => void;
+    /** 停止正在进行的回复。Stops the streaming reply. */
+    onCancel?: () => void;
+    /** 打开消息中引用的资源。Opens a resource referenced by a message. */
+    onOpenUri?: (uri: string) => void;
+    /** 复制由宿主执行，组件只上报意图。The host copies; the component reports intent. */
+    onCopy?: (text: string) => void;
+    /** 触发一条消息声明的动作。Fires a message action. */
+    onMessageAction?: (messageId: string, actionKey: string) => void;
+    /** 可替换文案，缺省为英文。Replaceable copy; English by default. */
+    labels?: VikingBotLabels;
+}

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

@@ -0,0 +1,6 @@
+import type { VikingBotComposerProps, VikingBotComposerRef } from './types.js';
+/**
+ * 输入区。发送与停止都由宿主决定，组件只上报意图。
+ * The composer. The host owns sending and stopping; the component reports intent.
+ */
+export declare const VikingBotComposerView: import("react").ForwardRefExoticComponent<VikingBotComposerProps & import("react").RefAttributes<VikingBotComposerRef>>;

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

@@ -0,0 +1,3 @@
+import type { VikingBotMessageListProps } from './types.js';
+/** 消息列表。The message list. */
+export declare function VikingBotMessageList(props: VikingBotMessageListProps): import("react").JSX.Element;

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

@@ -1 +1,16 @@
-export {};
+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;

package/dist/components/viking-bot.js

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

package/dist/c~0.js

@@ -0,0 +1,201 @@
+import { jsx, jsxs } from "react/jsx-runtime";
+import { Suspense, forwardRef, lazy } from "react";
+import { VikingBotInteraction } from "./w~0.js";
+const DEFAULT_LABELS = {
+    placeholder: 'Ask VikingBot anything',
+    send: 'Send',
+    stop: 'Stop',
+    attach: 'Attach files',
+    removeAttachment: 'Remove attachment',
+    copy: 'Copy',
+    copied: 'Copied',
+    reasoning: 'Reasoning',
+    thinking: 'Thinking',
+    tool: 'Tool call',
+    toolPending: 'Queued',
+    toolRunning: 'Running',
+    toolCompleted: 'Done',
+    toolError: 'Failed',
+    context: 'Context',
+    empty: 'Start a conversation',
+    newSession: 'New chat',
+    retry: 'Retry',
+    scrollToLatest: 'Scroll to latest',
+    unavailable: 'VikingBot is unavailable'
+};
+const View = /*#__PURE__*/ lazy(async ()=>{
+    const { VikingBotComposerView } = await import("./viking-bot-composer~0.js");
+    return {
+        default: VikingBotComposerView
+    };
+});
+const lazy_composer_VikingBotComposer = /*#__PURE__*/ forwardRef(function(props, ref) {
+    return /*#__PURE__*/ jsx(Suspense, {
+        fallback: /*#__PURE__*/ jsx("div", {
+            className: "ov-viking-bot__composer ov-viking-bot__composer--loading"
+        }),
+        children: /*#__PURE__*/ jsx(View, {
+            ...props,
+            ref: ref
+        })
+    });
+});
+const toStatus = (status)=>'pending' === status ? 'queued' : 'running' === status ? 'running' : 'completed' === status ? 'success' : 'failed';
+const toReasoningItem = (part, index)=>({
+        id: `${part.groupId ?? 'reasoning'}:${index}`,
+        type: 'reasoning',
+        status: part.running ? 'running' : 'success',
+        summary: part.text ? [
+            part.text
+        ] : [],
+        visibility: 'contentAllowed',
+        durationMs: part.durationMs
+    });
+const toToolItem = (part)=>({
+        id: part.id,
+        type: 'mcpToolCall',
+        status: toStatus(part.status),
+        server: part.server ?? '',
+        tool: part.name,
+        arguments: part.input,
+        resultPreview: part.output,
+        durationMs: part.durationMs
+    });
+const isActivityPart = (part)=>'reasoning' === part.type || 'tool' === part.type;
+function groupActivityParts(parts) {
+    const groups = new Map();
+    const order = [];
+    parts.forEach((part, index)=>{
+        if (!isActivityPart(part)) return;
+        const key = 'groupId' in part && part.groupId || `loose:${index}`;
+        const group = groups.get(key) ?? {
+            id: key,
+            items: []
+        };
+        if (!groups.has(key)) {
+            groups.set(key, group);
+            order.push(key);
+        }
+        group.items.push('reasoning' === part.type ? toReasoningItem(part, index) : toToolItem(part));
+    });
+    return {
+        groups,
+        order
+    };
+}
+function toRenderItems(messages, streaming, group = (list)=>[
+        ...list
+    ]) {
+    const insertIndex = streaming ? Math.min(Math.max(streaming.insertIndex ?? messages.length, 0), messages.length) : messages.length;
+    const before = group(messages.slice(0, insertIndex));
+    const after = streaming ? group(messages.slice(insertIndex)) : [];
+    const items = before.map((message)=>({
+            id: message.id,
+            message
+        }));
+    if (streaming) items.push({
+        id: '__streaming__',
+        streaming
+    });
+    for (const message of after)items.push({
+        id: message.id,
+        message
+    });
+    return items;
+}
+const List = /*#__PURE__*/ lazy(async ()=>{
+    const { VikingBotMessageListView } = await import("./ark-message-list-view~0.js");
+    return {
+        default: VikingBotMessageListView
+    };
+});
+function ListSkeleton() {
+    return /*#__PURE__*/ jsx("div", {
+        className: "ov-viking-bot__list ov-viking-bot__list--loading"
+    });
+}
+function VikingBotMessageList(props) {
+    const labels = {
+        ...DEFAULT_LABELS,
+        ...props.labels
+    };
+    const items = toRenderItems(props.messages, props.streaming);
+    if (0 === items.length) return /*#__PURE__*/ jsx("div", {
+        className: "ov-viking-bot__empty",
+        children: labels.empty
+    });
+    return /*#__PURE__*/ jsx(Suspense, {
+        fallback: /*#__PURE__*/ jsx(ListSkeleton, {}),
+        children: /*#__PURE__*/ jsx(List, {
+            ...props
+        })
+    });
+}
+function VikingBot({ messages, className, streaming, draft, attachments, isSending, isAvailable = true, unavailableMessage, emptyState, header, footer, children, messageList, composer, interaction, interactionSlot, listKey, composerRef, onDraftChange, onFilesAdded, onAttachmentRemove, onSend, onCancel, onOpenUri, onCopy, onMessageAction, labels: overrides, ...rest }) {
+    const labels = {
+        ...DEFAULT_LABELS,
+        ...overrides
+    };
+    const hasMessages = messages.length > 0;
+    if (children) return /*#__PURE__*/ jsx("div", {
+        className: [
+            'ov-viking-bot',
+            className
+        ].filter(Boolean).join(' '),
+        ...rest,
+        children: children
+    });
+    return /*#__PURE__*/ jsxs("div", {
+        className: [
+            'ov-viking-bot',
+            className
+        ].filter(Boolean).join(' '),
+        ...rest,
+        children: [
+            header ? /*#__PURE__*/ jsx("div", {
+                className: "ov-viking-bot__header",
+                children: header
+            }) : null,
+            isAvailable ? null : /*#__PURE__*/ jsx("p", {
+                className: "ov-viking-bot__unavailable",
+                role: "status",
+                children: unavailableMessage ?? labels.unavailable
+            }),
+            /*#__PURE__*/ jsx("div", {
+                className: "ov-viking-bot__body",
+                children: !hasMessages && emptyState ? /*#__PURE__*/ jsx("div", {
+                    className: "ov-viking-bot__empty",
+                    children: emptyState
+                }) : messageList ?? /*#__PURE__*/ jsx(VikingBotMessageList, {
+                    messages: messages,
+                    streaming: streaming,
+                    listKey: listKey,
+                    onOpenUri: onOpenUri,
+                    onCopy: onCopy,
+                    onMessageAction: onMessageAction,
+                    labels: overrides
+                })
+            }),
+            footer ? /*#__PURE__*/ jsx("div", {
+                className: "ov-viking-bot__footer",
+                children: footer
+            }) : null,
+            interaction ? interactionSlot ?? /*#__PURE__*/ jsx(VikingBotInteraction, {
+                ...interaction
+            }) : composer ?? (void 0 !== draft ? /*#__PURE__*/ jsx(lazy_composer_VikingBotComposer, {
+                ref: composerRef,
+                value: draft,
+                attachments: attachments,
+                disabled: !isAvailable,
+                isSending: isSending,
+                onValueChange: onDraftChange,
+                onFilesAdded: onFilesAdded,
+                onAttachmentRemove: onAttachmentRemove,
+                onSend: onSend,
+                onCancel: onCancel,
+                labels: overrides
+            }) : null)
+        ]
+    });
+}
+export { DEFAULT_LABELS, VikingBot, VikingBotMessageList, groupActivityParts, lazy_composer_VikingBotComposer as VikingBotComposer, toRenderItems };

package/dist/file-preview-viewer~0.js

@@ -0,0 +1,191 @@
+import { Fragment, jsx } from "react/jsx-runtime";
+import { FileViewerCore } from "@ark-design/ui/file-viewer/core";
+import { useCallback, useMemo, useRef } from "react";
+import { code } from "@ark-design/ui/file-viewer/adapters/code";
+import { diff } from "@ark-design/ui/file-viewer/adapters/diff";
+import { html } from "@ark-design/ui/file-viewer/adapters/html";
+import { image as image_image } from "@ark-design/ui/file-viewer/adapters/image";
+import { json } from "@ark-design/ui/file-viewer/adapters/json";
+import { markdown } from "@ark-design/ui/file-viewer/adapters/markdown";
+import { media } from "@ark-design/ui/file-viewer/adapters/media";
+import { pdf } from "@ark-design/ui/file-viewer/adapters/pdf";
+import { powerpoint } from "@ark-design/ui/file-viewer/adapters/powerpoint";
+import { table } from "@ark-design/ui/file-viewer/adapters/table";
+import { text as text_text } from "@ark-design/ui/file-viewer/adapters/text";
+import { word } from "@ark-design/ui/file-viewer/adapters/word";
+import { toFileSource, LoadFailedState, LoadingState, UnsupportedState } from "./g~0.js";
+function createFilePreviewAdapterList({ onLinkClick } = {}) {
+    return [
+        code({
+            showLineNumbers: true
+        }),
+        text_text({
+            showLineNumbers: true
+        }),
+        json({
+            defaultExpandDepth: 4
+        }),
+        markdown({
+            onLinkClick
+        }),
+        html(),
+        table(),
+        pdf({
+            initialFit: 'fit-width'
+        }),
+        word({
+            initialFit: 'fit-width'
+        }),
+        powerpoint({
+            initialFit: 'fit-width'
+        }),
+        image_image(),
+        media(),
+        diff()
+    ];
+}
+function createFilePreviewAdapters({ onHandleChange, onViewModesChange, onLinkClick }) {
+    return createFilePreviewAdapterList({
+        onLinkClick
+    }).map((adapter)=>{
+        const wrap = (context)=>{
+            const descriptor = adapter(context);
+            return {
+                ...descriptor,
+                load: async (loadContext)=>{
+                    const { Component } = await descriptor.load(loadContext);
+                    onViewModesChange(descriptor.supportedViewModes ?? []);
+                    function HandleCapture(props) {
+                        const latest = useRef(props.registerHandle);
+                        latest.current = props.registerHandle;
+                        const proxy = useCallback((handle)=>{
+                            onHandleChange(handle);
+                            latest.current?.(handle);
+                        }, []);
+                        return /*#__PURE__*/ jsx(Component, {
+                            ...props,
+                            registerHandle: proxy
+                        });
+                    }
+                    HandleCapture.displayName = 'FilePreviewHandleCapture';
+                    return {
+                        Component: HandleCapture
+                    };
+                }
+            };
+        };
+        return wrap;
+    });
+}
+function sourceDeps(source) {
+    return [
+        source.content,
+        source.file,
+        source.url,
+        source.fileName,
+        source.fileType,
+        source.path
+    ];
+}
+function FilePreviewViewer({ tab, text, locale, viewMode, onViewModeChange, onDownload, onHandleChange, onViewModesChange, onLinkClick }) {
+    const source = useMemo(()=>toFileSource(tab.source), sourceDeps(tab.source));
+    const adapters = useMemo(()=>createFilePreviewAdapters({
+            onHandleChange,
+            onViewModesChange,
+            onLinkClick
+        }), [
+        onHandleChange,
+        onViewModesChange,
+        onLinkClick
+    ]);
+    const canDownload = Boolean(tab.operations?.download);
+    const latest = useRef({
+        text,
+        onDownload,
+        tabSlots: tab.slots,
+        canDownload
+    });
+    latest.current = {
+        text,
+        onDownload,
+        tabSlots: tab.slots,
+        canDownload
+    };
+    const slotPresence = [
+        Boolean(tab.slots?.confirmFallback),
+        Boolean(tab.slots?.downloadFallback),
+        Boolean(tab.slots?.unsupportedFallback)
+    ].join();
+    const slots = useMemo(()=>{
+        const loadingSlot = ()=>{
+            const own = latest.current.tabSlots?.loadingFallback;
+            return own ? /*#__PURE__*/ jsx(Fragment, {
+                children: own
+            }) : /*#__PURE__*/ jsx(LoadingState, {
+                text: latest.current.text
+            });
+        };
+        const errorSlot = ({ retry })=>{
+            const own = latest.current.tabSlots?.errorFallback;
+            return own ? /*#__PURE__*/ jsx(Fragment, {
+                children: own
+            }) : /*#__PURE__*/ jsx(LoadFailedState, {
+                text: latest.current.text,
+                onRetry: retry
+            });
+        };
+        const own = tab.slots;
+        const hasConfirm = Boolean(own?.confirmFallback);
+        const hasHostDownload = Boolean(own?.downloadFallback);
+        const hasUnsupported = Boolean(own?.unsupportedFallback);
+        const confirmSlot = (props)=>{
+            const Host = latest.current.tabSlots?.confirmFallback;
+            return Host ? /*#__PURE__*/ jsx(Host, {
+                ...props
+            }) : null;
+        };
+        const downloadSlot = (props)=>{
+            const tabSlots = latest.current.tabSlots;
+            const Host = tabSlots?.downloadFallback;
+            if (Host) return /*#__PURE__*/ jsx(Host, {
+                ...props
+            });
+            return /*#__PURE__*/ jsx(UnsupportedState, {
+                text: latest.current.text,
+                onDownload: latest.current.canDownload ? latest.current.onDownload : void 0
+            });
+        };
+        return {
+            loading: loadingSlot,
+            error: errorSlot,
+            ...hasConfirm ? {
+                confirm: confirmSlot
+            } : {},
+            ...hasHostDownload || !hasUnsupported ? {
+                downloadFallback: downloadSlot
+            } : {}
+        };
+    }, [
+        tab.key,
+        slotPresence
+    ]);
+    if (!source) return tab.slots?.unsupportedFallback ?? /*#__PURE__*/ jsx(UnsupportedState, {
+        text: text,
+        onDownload: canDownload ? onDownload : void 0
+    });
+    return /*#__PURE__*/ jsx(FileViewerCore, {
+        adapters: adapters,
+        className: "ov-file-preview__viewer",
+        locale: locale,
+        resources: tab.resources,
+        slots: slots,
+        source: source,
+        toolbar: false,
+        unsupportedFallback: tab.slots?.unsupportedFallback,
+        viewMode: viewMode,
+        onViewModeChange: (mode)=>{
+            if ('preview' === mode || 'source' === mode) onViewModeChange(mode);
+        }
+    }, tab.key);
+}
+export { FilePreviewViewer };