@pactor-app/chat 1.44.0 → 1.46.0

package/dist/components/index.d.cts

@@ -0,0 +1,793 @@
+import { DslNode, Registry } from '@pactor-app/core';
+import * as react from 'react';
+import { CSSProperties, ReactNode } from 'react';
+import { C as ChatPageArtifact, A as ArtifactViewers } from '../download-DnP2uArc.cjs';
+export { a as ArtifactPanel, b as ArtifactPanelProps, c as ArtifactTreeNode, d as ArtifactViewer, e as buildArtifactBlob, f as buildArtifactTree, g as downloadArtifact, r as resolveArtifactFilename, s as saveBlob } from '../download-DnP2uArc.cjs';
+
+/** 智能体状态 */
+type AgentStatusType = 'running' | 'waiting' | 'done' | 'error';
+interface AgentStatusProps {
+    /** 状态，默认 running */
+    status?: AgentStatusType;
+    /** 状态文本 */
+    text?: string;
+    /** 耗时（秒，展示为「已用时 Xs」） */
+    elapsed?: number;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * AgentStatus 适配器（shadcn kit）：智能体运行 / 等待状态行——
+ * 状态图标（running 旋转）+ 文本 + 可选耗时。
+ * 与通用分类 Status 的差异：面向智能体执行过程（含耗时语义）。
+ */
+declare function AgentStatus({ status, text, elapsed, className, style }: AgentStatusProps): react.JSX.Element;
+
+/** 会话附件项 */
+interface AttachmentItemData {
+    /** 唯一标识（onRemove / onRetry 传出；缺省传出数组下标） */
+    id?: string;
+    name: string;
+    /** 大小（字节） */
+    fileSize?: number;
+    /** MIME 或扩展名（类别图标推断） */
+    fileType?: string;
+    /** 状态，默认 done */
+    status?: 'uploading' | 'done' | 'error';
+    /** 上传进度（0-100，status=uploading 时展示） */
+    progress?: number;
+}
+interface AttachmentProps {
+    /** 附件列表（可含表达式解析后的数组） */
+    items?: AttachmentItemData[];
+    /** 移除事件，传出 id（无 id 传下标）；提供时展示移除按钮 */
+    onRemove?: (id: string | number) => void;
+    /** 重试事件（status=error 时展示重试按钮），传出 id / 下标 */
+    onRetry?: (id: string | number) => void;
+    /** 卡片点击事件（预览等由调用方实现），传出该附件项 */
+    onClick?: (item: AttachmentItemData) => void;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * Attachment 适配器（shadcn kit）：会话附件 chip 组——
+ * 类别图标（复用 FilePreview 的推断）+ 名称 + 大小 + 状态
+ * （uploading 进度条 / error 重试）+ 可移除。
+ * 上传与存储由调用方负责，本组件只做呈现与事件上报。
+ */
+declare function Attachment({ items, onRemove, onRetry, onClick, className, style }: AttachmentProps): react.JSX.Element;
+
+/** DSL Bubble 变体（对齐 vendored bubble 七态） */
+type BubbleVariant = 'default' | 'secondary' | 'muted' | 'tinted' | 'outline' | 'ghost' | 'destructive';
+interface BubbleProps {
+    /** 对齐：start 居左（助手）、end 居右（用户），默认 start */
+    align?: 'start' | 'end';
+    /** 变体，默认 muted */
+    variant?: BubbleVariant;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+    children?: ReactNode;
+}
+/**
+ * Bubble 适配器（shadcn kit）：基础对话气泡容器——变体决定气泡底色，
+ * align 决定左右停靠；内容经 Renderer children 机制渲染 DSL 子树。
+ */
+declare function Bubble({ align, variant, className, style, children }: BubbleProps): react.JSX.Element;
+
+/** 消息正文段（与 @pactor-app/chat 的 ChatPart 结构对齐的子集；dsl / artifact 段由 chat 产品层承接） */
+type ChatMessagePart = {
+    type: 'text';
+    content: string;
+} | {
+    type: 'markdown';
+    content: string;
+} | {
+    type: 'thinking';
+    content: string;
+    status?: 'thinking' | 'done';
+} | {
+    type: 'tool-call';
+    name?: string;
+    params?: unknown;
+    status?: 'running' | 'done' | 'error';
+    result?: string;
+} | {
+    type: 'tool-result';
+    content: string;
+} | {
+    type: 'status';
+    text: string;
+}
+/** 产物计数段：展示「已生成 n 个产物」，提供 onOpenArtifacts 时可点击（打开产物栏） */
+ | {
+    type: 'artifacts';
+    count: number;
+} | {
+    type: 'error';
+    message: string;
+};
+/** 消息状态（对齐 chat 消息状态机） */
+type ChatMessageStatus = 'pending' | 'streaming' | 'completed' | 'error' | 'cancelled';
+/** 助手身份 */
+interface ChatMessageAgent {
+    name: string;
+    /** 头像图标名（Icon 白名单） */
+    icon?: string;
+}
+/** 消息操作项（onAction 传出 name） */
+interface ChatMessageActionItem {
+    name: string;
+    label?: string;
+    icon?: string;
+}
+interface ChatMessageProps {
+    /** 角色，默认 assistant */
+    role?: 'user' | 'assistant' | 'system';
+    /** 有序正文段 */
+    parts?: ChatMessagePart[];
+    /** 状态，默认 completed；streaming 在末尾渲染光标 */
+    status?: ChatMessageStatus;
+    /** 助手身份（assistant 消息顶部展示） */
+    agent?: ChatMessageAgent;
+    /** 时间文本 */
+    time?: string;
+    /** 是否展示发送方行，默认 false（消息列表不展示 Sender） */
+    showSender?: boolean;
+    /** 操作列表（completed / error 时展示；有图标时仅图标 + Tooltip 呈现） */
+    actions?: ChatMessageActionItem[];
+    /** 操作事件，传出 action name（Renderer 绑定 events.onAction） */
+    onAction?: (name: string) => void;
+    /** artifacts 段（「已生成 n 个产物」）点击事件；提供时该段才可点击 */
+    onOpenArtifacts?: () => void;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * ChatMessage 适配器（shadcn kit）：会话消息组合件——
+ * user 右侧气泡；assistant 左侧通栏（Sender + 有序 parts）；system
+ * 居中弱提示（无气泡、12px 浅色文字，参考 @pactor-app/chat
+ * MessageBubble 的 system 约定）。parts 渲染（text / markdown /
+ * thinking / tool-call / tool-result / status / error）+ streaming 光标 +
+ * 操作行（onAction 传出 name）。props 驱动，不感知会话 store；
+ * dsl / artifact 段与完整会话能力由 @pactor-app/chat 产品层承接。
+ */
+declare function ChatMessage({ role, parts, status, agent, time, showSender, actions, onAction, onOpenArtifacts, className, style, }: ChatMessageProps): react.JSX.Element;
+
+/** 模型选项（模型选择 chip 的候选） */
+interface ComposerModelOption {
+    value: string;
+    label: string;
+}
+/** 上下文条目（提及候选与行内提及块共用） */
+interface ComposerContextItem {
+    id: string;
+    label: string;
+    /** 来源触发符，缺省继承 source */
+    trigger?: string;
+    /** 图标名（Icon 白名单；缺省按 source.icon 或触发符兜底） */
+    icon?: string;
+    /** 原始数据（随选中结果透传给调用方） */
+    data?: unknown;
+}
+/**
+ * 上下文数据源：trigger 为声明的触发字符（如 '@' / '+'）——
+ * 输入该字符（词边界）时在光标位置弹出候选菜单（行内提及）；
+ * trigger 为 '+' 时工具栏左端同时渲染 + 按钮弹层（选中在光标处插入行内块）
+ */
+interface ComposerContextSource {
+    trigger: string;
+    label: string;
+    items: ComposerContextItem[];
+    /** 菜单项与提及块的缺省图标（Icon 白名单） */
+    icon?: string;
+}
+interface ComposerProps {
+    /** 受控值（提供即受控） */
+    value?: string;
+    /** 占位提示 */
+    placeholder?: string;
+    /** 禁用输入与发送 */
+    disabled?: boolean;
+    /** 发送中（禁用发送钮，由调用方在完成后复位） */
+    loading?: boolean;
+    /** 流式生成中：发送钮切换为停止钮（不禁用、不阻断输入），点击经 onStop 传出 */
+    streaming?: boolean;
+    /** 停止当前生成（streaming 时点击停止钮） */
+    onStop?: () => void;
+    /** 最小行数，缺省 3 */
+    rows?: number;
+    /** 附件列表（展示在输入区上方） */
+    attachments?: AttachmentItemData[];
+    /** 附件移除事件，传出 id / 下标 */
+    onRemoveAttachment?: (id: string | number) => void;
+    /** 附件重试事件，传出 id / 下标 */
+    onRetryAttachment?: (id: string | number) => void;
+    /** 附件卡片点击事件（预览等由调用方实现），传出该附件项 */
+    onAttachmentClick?: (attachment: AttachmentItemData) => void;
+    /**
+     * 附件选择入口（提供时工具栏左端渲染附件钮，并启用粘贴 / 拖拽文件）；
+     * 上传与存储由调用方负责
+     */
+    onAttachFiles?: (files: File[]) => void;
+    /** 输入事件，传出 string 值（行内提及块序列化为 trigger+label） */
+    onChange?: (value: string) => void;
+    /** 发送事件（点击发送钮或 Enter），传出当前文本 */
+    onSubmit?: (value: string) => void;
+    /** 模型选项（非空时工具栏右端渲染模型选择 chip，位于发送钮之前） */
+    models?: ComposerModelOption[];
+    /** 当前选中模型 value（未命中时展示 models[0]） */
+    model?: string;
+    /** 弹层中选中模型时触发，传出 value */
+    onModelChange?: (value: string) => void;
+    /**
+     * 上下文数据源（行内提及）：配置后输入区切换为 contenteditable——
+     * 输入触发符在光标位置弹出候选菜单（输入过滤 / ↑↓ 选择 / 回车选中），
+     * 选中把触发符与已输入文字替换为行内提及块（图标 + 文字、浅色背景、
+     * 圆角，退格整体删除）
+     */
+    contexts?: ComposerContextSource[];
+    /** 行内提及块列表（受控，与输入区保持同步） */
+    contextItems?: ComposerContextItem[];
+    /** 提及块变更事件（插入 / 退格删除），传出输入区当前块列表；发送后的清空由调用方在 onSubmit 闭环里处理 */
+    onContextItemsChange?: (items: ComposerContextItem[]) => void;
+    /**
+     * 调用方接管 '@' 提及触发（优先于内建行内提及）：提供时 contexts 中
+     * trigger 为 '@' 的源不再启用内建菜单；输入区回退纯 textarea（无其他
+     * 源时），词边界 '@' 输入经本回调传出 query（'@' 后文本）与锚点 rect
+     */
+    onMentionTrigger?: (query: string, anchorRect: DOMRect) => void;
+    /**
+     * 调用方接管 '+' 按钮弹层（优先于内建弹层）：提供时工具栏左端始终
+     * 渲染 '+' 钮，点击经本回调传出锚点 rect，不再打开内建候选弹层
+     */
+    onPlusMenu?: (anchorRect: DOMRect) => void;
+    /** 工具栏左端槽（渲染在内建 '+' / 附件钮之前；DslNode 或 React 元素） */
+    toolbarStart?: DslNode | ReactNode;
+    /** 工具栏右端槽（渲染在模型选择 chip 之后、发送钮之前；DslNode 或 React 元素） */
+    toolbarEnd?: DslNode | ReactNode;
+    /**
+     * 隐藏工具栏行（缺省 false）：true 时工具栏行整体不渲染——内建
+     * '+' / 附件钮、模型 chip、发送 / 停止钮与 toolbarStart / toolbarEnd
+     * 槽一并抑制（footer 槽不受影响）；Enter 发送保留
+     */
+    hideToolbar?: boolean;
+    /** footer 槽（渲染在输入框内工具栏下方，以分隔线相隔；DslNode 或 React 元素） */
+    footer?: DslNode | ReactNode;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * Composer 适配器（shadcn kit）：会话输入组合件——
+ * 附件区（Attachment）+ 输入区（ChatInput）。
+ *
+ * - 附件：受控 attachments 展示；提供 onAttachFiles 时工具栏左端渲染
+ *   附件钮，并启用粘贴 / 拖拽文件入口（上传由调用方负责）
+ * - 模型选择：models 非空时工具栏右端渲染模型 chip（发送钮之前），
+ *   弹层选中经 onModelChange 传出
+ * - 行内提及（MentionInput）：contexts 非空时输入区切换为
+ *   contenteditable——输入触发符（'@' 等）在光标位置弹出候选菜单
+ *   （输入过滤 / ↑↓ / 回车选中 / 点击选中），选中把触发符与已输入
+ *   文字替换为行内提及块（图标 + 文字、浅色背景、圆角），退格整体
+ *   删除；'+' 触发源额外在工具栏左端渲染 + 按钮弹层（选中在光标处
+ *   插入行内块）；块列表受控（contextItems + onContextItemsChange）。
+ *   注入 onMentionTrigger / onPlusMenu 时对应内建 '@' 提及 / '+' 弹层
+ *   让位给调用方（回调优先，锚点 rect 随回调传出）
+ * - 运行态：streaming 时发送钮切换为停止钮，点击经 onStop 传出
+ * - 扩展槽：toolbarStart / toolbarEnd（工具栏左 / 右端，DslNode 或
+ *   React 元素）；hideToolbar 时工具栏行（含发送 / 停止钮）整体不渲染，
+ *   Enter 发送保留
+ * - footer 槽渲染在输入框内工具栏下方（分隔线相隔）
+ *
+ * 上传 / transport 由调用方负责，本组件只做呈现与事件上报。
+ */
+declare function Composer({ value, placeholder, disabled, loading, streaming, onStop, rows, attachments, onRemoveAttachment, onRetryAttachment, onAttachmentClick, onAttachFiles, onChange, onSubmit, models, model, onModelChange, contexts, contextItems, onContextItemsChange, onMentionTrigger, onPlusMenu, toolbarStart, toolbarEnd, hideToolbar, footer, className, style, }: ComposerProps): react.JSX.Element;
+
+/** 会话条目 */
+interface ConversationItemData {
+    id: string;
+    title: string;
+    /** 补充说明（最近一条消息摘要等） */
+    description?: string;
+    /** 时间文本（已格式化） */
+    time?: string;
+}
+interface ConversationListProps {
+    /** 会话列表（可含表达式解析后的数组） */
+    items?: ConversationItemData[];
+    /** 受控：当前会话 id；提供时切换仅经 onSelect 上报 */
+    activeId?: string;
+    /** 是否展示搜索框（按 title / description 过滤），默认 false */
+    searchable?: boolean;
+    /** 选择事件，传出会话 id（Renderer 绑定 events.onSelect） */
+    onSelect?: (id: string) => void;
+    /** 删除事件，传出会话 id；提供时行悬浮展示删除按钮 */
+    onDelete?: (id: string) => void;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * ConversationList 适配器（shadcn kit）：历史会话列表——
+ * 可选搜索过滤、激活态（受控 / 非受控）、悬浮删除；
+ * 会话的存储与加载由调用方负责。
+ */
+declare function ConversationList({ items, activeId, searchable, onSelect, onDelete, className, style }: ConversationListProps): react.JSX.Element;
+
+/** 消息条目（ChatMessage props + 可选 id，onAction 随事件传出） */
+interface MessageListItem extends ChatMessageProps {
+    id?: string;
+}
+interface MessageListProps {
+    /** 消息列表（可含表达式解析后的数组） */
+    messages?: MessageListItem[];
+    /** 消息变化后自动滚动到底部，默认 true */
+    autoScroll?: boolean;
+    /** 消息操作事件，传出 { id, action }（Renderer 绑定 events.onAction） */
+    onAction?: (event: {
+        id?: string;
+        action: string;
+    }) => void;
+    /** artifacts 段（「已生成 n 个产物」）点击事件，传出 { id } */
+    onOpenArtifacts?: (event: {
+        id?: string;
+    }) => void;
+    /** 通用：根节点 class（与内置样式合并；高度由外层或 style 约束） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * MessageList 适配器（shadcn kit）：连续消息流容器——
+ * 逐条渲染 ChatMessage，消息变化自动滚到底部（autoScroll 可关）；
+ * 高度由外层容器约束（组件本身只提供滚动语义）。
+ */
+declare function MessageList({ messages, autoScroll, onAction, onOpenArtifacts, className, style }: MessageListProps): react.JSX.Element;
+
+/** 起始任务项（value 缺省取 title） */
+interface WelcomePromptItem {
+    title: string;
+    description?: string;
+    icon?: string;
+    value?: string;
+}
+interface WelcomeProps {
+    /** 主标题，默认「有什么可以帮你？」 */
+    title?: string;
+    /** 副标题（能力说明） */
+    description?: string;
+    /** 主图标名（Icon 白名单），缺省 chat；传 null 不渲染图标 */
+    icon?: string | null;
+    /** 起始任务卡片列表 */
+    prompts?: WelcomePromptItem[];
+    /** 起始任务选择事件，传出 value（Renderer 绑定 events.onSelect） */
+    onSelect?: (value: string) => void;
+    /** 主标题节点 class（与内置样式合并） */
+    titleClassName?: string;
+    /** 副标题节点 class（与内置样式合并） */
+    descriptionClassName?: string;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * Welcome 适配器（shadcn kit）：会话空状态——居中的图标 + 主副标题 +
+ * 起始任务卡片栅格（复用 Prompt）；点击卡片经 onSelect 传出 value。
+ */
+declare function Welcome({ title, description, icon, prompts, onSelect, titleClassName, descriptionClassName, className, style, }: WelcomeProps): react.JSX.Element;
+
+/** 图标栏 / 展开菜单共用的导航项 */
+interface ChatPageMenuItem {
+    key: string;
+    label: string;
+    /** 图标名（Icon 白名单） */
+    icon?: string;
+}
+/** 对话图标栏项：点击 toggle 展示当前对话的附加内容（产物 / 执行步骤等） */
+interface ConversationRailItem {
+    key: string;
+    /** 提示文案（hover tooltip） */
+    label?: string;
+    /** 图标名（Icon 白名单） */
+    icon?: string;
+    /** 呈现形态：popover（图标栏旁悬浮弹框，缺省）/ panel（产物栏式右侧固定宽栏） */
+    display?: 'panel' | 'popover';
+    /** 附加内容（React 元素或 DslNode；缺省时点击仅触发状态事件，不渲染内容层） */
+    content?: DslNode | ReactNode;
+    /** 隐藏该项（如按当前会话有无对应内容动态显隐）；隐藏时激活态一并失效 */
+    hidden?: boolean;
+}
+/** 品牌区（展开菜单区标题 / 版本） */
+interface ChatPageBrand {
+    title: string;
+    version?: string;
+}
+interface ChatPageProps {
+    brand?: ChatPageBrand;
+    /** 主导航项：展开菜单区为图标 + 文字 */
+    menuItems?: ChatPageMenuItem[];
+    /** 受控选中导航 key（可绑 `${state.x}`） */
+    activeMenuKey?: string;
+    /**
+     * 图标栏导航项（仅图标，hover 右侧 Tooltip 展示 label），与展开菜单
+     * 独立定义；railItems 与 railFooterItems 均为空时整个图标栏隐藏
+     */
+    railItems?: ChatPageMenuItem[];
+    /** 图标栏底部附加项（如设置 / 个人中心） */
+    railFooterItems?: ChatPageMenuItem[];
+    /** 展开菜单区右上角操作（如「发现应用」）；提供才渲染 */
+    menuAction?: {
+        label: string;
+        icon?: string;
+    };
+    /** 导航选中事件（图标栏 / 展开菜单 / 底部分组共用），传出 item key */
+    onMenuSelect?: (key: string) => void;
+    /** menuAction 点击事件 */
+    onMenuAction?: () => void;
+    /** 会话区标题（如「任务」，自动拼接数量）；点击标题折叠 / 展开列表 */
+    conversationSectionTitle?: string;
+    /** 会话区受控折叠（提供即受控，配合 onConversationSectionToggle 闭环） */
+    conversationSectionCollapsed?: boolean;
+    /** 会话区非受控初始折叠，缺省 false */
+    defaultConversationSectionCollapsed?: boolean;
+    /** 会话区折叠变化事件，传出 boolean */
+    onConversationSectionToggle?: (collapsed: boolean) => void;
+    conversations?: ConversationItemData[];
+    activeConversationId?: string;
+    onSelectConversation?: (id: string) => void;
+    onDeleteConversation?: (id: string) => void;
+    /** 「查看更多」入口文案；提供才渲染（随会话区折叠隐藏） */
+    moreLabel?: string;
+    onMore?: () => void;
+    /** 菜单区底部附加分组标题（如「空间 (14)」）；提供才渲染，点击折叠 / 展开 */
+    footerSectionTitle?: string;
+    /** 底部分组列表项（图标 + 文字，点击经 onMenuSelect 传出） */
+    footerItems?: ChatPageMenuItem[];
+    /** 底部分组受控折叠（提供即受控，配合 onFooterSectionToggle 闭环） */
+    footerSectionCollapsed?: boolean;
+    /** 底部分组非受控初始折叠，缺省 false */
+    defaultFooterSectionCollapsed?: boolean;
+    /** 底部分组折叠变化事件，传出 boolean */
+    onFooterSectionToggle?: (collapsed: boolean) => void;
+    /** 对话区头部标题（通常为当前会话标题） */
+    conversationTitle?: string;
+    /**
+     * 对话区头部右侧自定义操作（图标 + 提示）；提供才渲染（未配置时
+     * header 不渲染任何按钮），点击经 onConversationHeaderAction 传出
+     */
+    conversationHeaderAction?: {
+        icon?: string;
+        label?: string;
+        tooltip?: string;
+    };
+    /** 对话区头部右侧自定义操作点击事件 */
+    onConversationHeaderAction?: () => void;
+    /**
+     * 对话图标栏附加项（header 下方、对话区右缘纵向排列，产物内置项
+     * 之后按序展示）；点击 toggle 展示对应附加内容
+     */
+    conversationRailItems?: ConversationRailItem[];
+    /** 隐藏图标栏内置产物入口（缺省 false：产物开关为图标栏首项） */
+    hideArtifactRailItem?: boolean;
+    /** 图标栏激活项 key（提供即受控，配合 onConversationRailChange 闭环；null 为全部收起） */
+    activeConversationRailKey?: string | null;
+    /** 图标栏激活项变化事件，传出 key 或 null */
+    onConversationRailChange?: (key: string | null) => void;
+    messages?: MessageListItem[];
+    /** 发送中（禁用 Composer 发送钮，由调用方完成后复位） */
+    sending?: boolean;
+    composerPlaceholder?: string;
+    /** 空会话欢迎区（messages 为空时展示；prompts 选择即发送） */
+    welcome?: {
+        title?: string;
+        description?: string;
+        prompts?: WelcomePromptItem[];
+    };
+    /** 发送事件（Composer 提交 / Welcome prompts 选择），传出文本 */
+    onSend?: (text: string) => void;
+    /** 消息操作事件，传出 { id, action } */
+    onMessageAction?: (event: {
+        id?: string;
+        action: string;
+    }) => void;
+    /** 模型选项（非空时 Composer 工具栏右端渲染模型选择 chip） */
+    models?: ComposerModelOption[];
+    /** 当前选中模型 value（可绑 `${state.x}` 受控闭环） */
+    model?: string;
+    /** 模型切换事件，传出 value */
+    onModelChange?: (value: string) => void;
+    /** 上下文数据源（行内提及：输入触发符在光标处弹菜单，选中替换为行内提及块；'+' 源另有工具栏按钮弹层） */
+    contexts?: ComposerContextSource[];
+    /** 行内提及块列表（受控，与输入区同步，可绑 `${state.x}`） */
+    contextItems?: ComposerContextItem[];
+    /** chips 变更事件（选中追加 / 移除），传出新数组；发送后的清空由调用方在 onSend 闭环里处理 */
+    onContextItemsChange?: (items: ComposerContextItem[]) => void;
+    /** 附件列表（受控，展示在输入区上方） */
+    attachments?: AttachmentItemData[];
+    /** 附件选择入口（提供时启用附件钮与粘贴 / 拖拽文件），传出原始 File[] */
+    onAttachFiles?: (files: File[]) => void;
+    /** 附件移除事件，传出 id */
+    onRemoveAttachment?: (id: string | number) => void;
+    /** 附件重试事件，传出 id */
+    onRetryAttachment?: (id: string | number) => void;
+    /** Composer footer 槽（渲染在输入框内工具栏下方，以分隔线相隔） */
+    composerFooter?: DslNode | ReactNode;
+    /** Composer 下方自定义内容槽（渲染在输入框之外正下方，如免责声明弱提示行） */
+    composerBottom?: DslNode | ReactNode;
+    /** 产物区标题，缺省「产物」 */
+    artifactTitle?: string;
+    /**
+     * 产物列表（富模型：id / kind / title / content，面板内建预览——
+     * markdown / code / text / dsl 活预览 / 图片，含目录树与下载）
+     */
+    artifacts?: ChatPageArtifact[];
+    activeArtifactId?: string;
+    onSelectArtifact?: (id: string) => void;
+    artifactEmptyText?: string;
+    /** dsl 产物活预览的 Safe Registry（缺省时 dsl 内容渲染降级块） */
+    safeRegistry?: Registry<unknown>;
+    /** 注入 dsl 预览作用域 user */
+    user?: Record<string, unknown>;
+    /** 自定义产物查看器（扩展名 / kind → 预览），优先于内建渲染器 */
+    artifactViewers?: ArtifactViewers;
+    /** 产物下载事件；缺省面板内部走浏览器下载 */
+    onDownloadArtifact?: (artifact: ChatPageArtifact) => void;
+    /** 产物区受控开关（提供即受控，配合 onArtifactOpenChange 闭环） */
+    artifactOpen?: boolean;
+    /** 非受控初始开关，缺省 false（产物栏不默认展示） */
+    defaultArtifactOpen?: boolean;
+    /** 产物区开关变化事件，传出 boolean */
+    onArtifactOpenChange?: (open: boolean) => void;
+    /**
+     * 主体内容槽（React 元素或 DslNode）：提供时整体替换右侧主区域——
+     * 对话 header、Welcome / MessageList、Composer、对话图标栏与右侧
+     * 产物 / 附加分栏均不渲染，由调用方自带完整主体（含 header）；
+     * 最左图标栏与展开菜单区不受影响
+     */
+    content?: DslNode | ReactNode;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * ChatPage 对话工作页（shadcn kit）：四区整页布局——
+ * 最左图标栏（railItems 独立定义，仅图标，hover 右侧 Tooltip 展示
+ * 菜单名；不传则整栏隐藏）、展开菜单区（品牌 + 图标文字导航固定于顶部，
+ * 可折叠的会话列表与底部分组各占独立滚动区，内容短时下方留空）、中间对话区（头部 / Welcome /
+ * MessageList / Composer——Composer 支持模型选择 chip（models/model）、
+ * 行内提及（contexts：输入触发符在光标处弹菜单，选中替换为行内提及块，
+ * 退格整体删除；受控 contextItems）、附件
+ * 入口（onAttachFiles + 受控 attachments）与 composerFooter /
+ * composerBottom 槽位）、对话图标栏（header 下方、对话区右缘纵向
+ * 图标列：内置产物入口 + conversationRailItems 附加项，点击 toggle
+ * 展示附加内容——popover 悬浮弹框或 panel 右侧分栏，与产物区互斥）、
+ * 最右产物区（ArtifactPanel：内建产物预览、
+ * 目录树与下载，可显隐；展示时经 Resizable 拖拽调节与对话区的宽度）。
+ * content 槽（React 元素或 DslNode）提供时整体替换右侧主区域（含对话
+ * header），由调用方自带完整主体内容；左侧图标栏与展开菜单区保留。
+ * 数据与行为全部经 props / events 进出，
+ * 本组件不持有业务状态（产物区开关、图标栏激活项与分区折叠缺省非受控，
+ * 均可经受控 prop + change 事件闭环）。
+ */
+declare function ChatPage({ brand, menuItems, activeMenuKey, railItems, railFooterItems, menuAction, onMenuSelect, onMenuAction, conversationSectionTitle, conversationSectionCollapsed, defaultConversationSectionCollapsed, onConversationSectionToggle, conversations, activeConversationId, onSelectConversation, onDeleteConversation, moreLabel, onMore, footerSectionTitle, footerItems, footerSectionCollapsed, defaultFooterSectionCollapsed, onFooterSectionToggle, conversationTitle, conversationHeaderAction, onConversationHeaderAction, conversationRailItems, hideArtifactRailItem, activeConversationRailKey, onConversationRailChange, messages, sending, composerPlaceholder, welcome, onSend, onMessageAction, models, model, onModelChange, contexts, contextItems, onContextItemsChange, attachments, onAttachFiles, onRemoveAttachment, onRetryAttachment, composerFooter, composerBottom, artifactTitle, artifacts, activeArtifactId, onSelectArtifact, artifactEmptyText, safeRegistry, user, artifactViewers, onDownloadArtifact, artifactOpen, defaultArtifactOpen, onArtifactOpenChange, content, className, style, }: ChatPageProps): react.JSX.Element;
+
+/** 引用来源项 */
+interface CitationItem {
+    /** 来源标题 */
+    title: string;
+    /** 来源链接 */
+    url?: string;
+    /** 引用片段 */
+    snippet?: string;
+}
+interface CitationProps {
+    /** 来源列表（可含表达式解析后的数组）；编号从 start 起 */
+    items?: CitationItem[];
+    /** 起始编号，默认 1 */
+    start?: number;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * Citation 适配器（shadcn kit）：来源引用标记——行内 [n] 编号组，
+ * 悬浮展开来源卡（标题 / 片段 / 链接，经 vendored HoverCard）。
+ */
+declare function Citation({ items, start, className, style }: CitationProps): react.JSX.Element;
+
+interface PromptProps {
+    /** 提示词标题 */
+    title?: string;
+    /** 补充描述 */
+    description?: string;
+    /** 前缀图标名（Icon 白名单） */
+    icon?: string;
+    /** 点击传出值（缺省取 title） */
+    value?: string;
+    /** 禁用 */
+    disabled?: boolean;
+    /** 选择事件（Renderer 绑定 events.onSelect） */
+    onSelect?: (value: string) => void;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * Prompt 适配器（shadcn kit）：可复用提示词 / 任务入口卡片——
+ * 图标 + 标题 + 描述，点击经 onSelect 传出 value（缺省取 title）。
+ */
+declare function Prompt({ title, description, icon, value, disabled, onSelect, className, style }: PromptProps): react.JSX.Element;
+
+interface SenderProps {
+    /** 发送方名称 */
+    name?: string;
+    /** 头像图片地址 */
+    avatar?: string;
+    /** 头像占位文本（缺省取 name 首字符） */
+    avatarText?: string;
+    /** 头像位图标（Icon 白名单；提供时头像位渲染图标，优先于 avatarText 兜底） */
+    icon?: string;
+    /** 隐藏头像位（缺省 false；无头像 / 图标 / 占位诉求的场景） */
+    hideAvatar?: boolean;
+    /** 角色说明（如「AI 助手」「我」），展示在名称后 */
+    role?: string;
+    /** 时间文本（已格式化，如「10:24」） */
+    time?: string;
+    /** 对齐：start 居左、end 居右，默认 start */
+    align?: 'start' | 'end';
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/** Sender 适配器（shadcn kit）：消息发送方行——头像 + 名称 + 角色 + 时间 */
+declare function Sender({ name, avatar, avatarText, icon, hideAvatar, role, time, align, className, style }: SenderProps): react.JSX.Element;
+
+interface StepsPanelItemData {
+    title: string;
+    description?: string;
+    /** done 已完成 / running 进行中 / pending 待执行（缺省 pending） */
+    status?: 'done' | 'running' | 'pending';
+    duration?: string;
+}
+interface StepsPanelProps {
+    /** 面板标题（缺省「执行步骤」） */
+    title?: string;
+    /** 步骤列表（DSL 绑定 ${data.steps}） */
+    steps?: StepsPanelItemData[];
+    /** 空态文案（steps 为空时展示） */
+    emptyText?: string;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * StepsPanel 执行步骤面板（chat 目录）：纵向时间线展示任务执行步骤，
+ * 状态图标区分已完成 / 进行中 / 待执行。典型用法是作为 ChatPage
+ * 对话图标栏 popover 项的 content（`type: "StepsPanel"`），
+ * 样式全走语义令牌（深浅色/换肤自适应）。
+ */
+declare function StepsPanel({ title, steps, emptyText, className, style, }: StepsPanelProps): react.JSX.Element;
+
+interface StreamingTextProps {
+    /** 文本内容（流式场景由数据源持续追加） */
+    content?: string;
+    /** 生成中：尾部渲染闪烁光标，默认 false */
+    streaming?: boolean;
+    /** 打字机模式：自身按 speed 渐进揭示 content（内容一次性给全的演示 / 回放场景），默认 false */
+    typing?: boolean;
+    /** 打字机速度（每 24ms 揭示的字符数），默认 2 */
+    speed?: number;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * StreamingText 适配器（shadcn kit）：渐进展示生成中的文本——
+ * 两种模式：数据源推送（content 增长 + streaming 光标）与打字机
+ * （typing 自揭示完整 content）。光标 motion-reduce 时静止。
+ */
+declare function StreamingText({ content, streaming, typing, speed, className, style }: StreamingTextProps): react.JSX.Element;
+
+/** 建议项：字符串或 { label, value?, icon? }（value 缺省取 label） */
+type SuggestionItem = string | {
+    label: string;
+    value?: string;
+    icon?: string;
+};
+interface SuggestionProps {
+    /** 建议列表（可含表达式解析后的数组） */
+    items?: SuggestionItem[];
+    /** 水平对齐，默认 start */
+    justify?: 'start' | 'center';
+    /** 选择事件，传出选中项 value（Renderer 绑定 events.onSelect） */
+    onSelect?: (value: string) => void;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * Suggestion 适配器（shadcn kit）：追问 / 下一步建议 chips——
+ * 圆角描边小按钮横向排列（可换行），点击经 onSelect 传出 value。
+ */
+declare function Suggestion({ items, justify, onSelect, className, style }: SuggestionProps): react.JSX.Element;
+
+/** 思考状态：thinking 进行中（图标脉冲动画）、done 已完成 */
+type ThinkingStatus = 'thinking' | 'done';
+interface ThinkingProps {
+    /** 推理内容 */
+    content?: string;
+    /** 状态，默认 thinking */
+    status?: ThinkingStatus;
+    /** 标题，缺省按状态：思考中… / 思考完成 */
+    title?: string;
+    /** 受控：是否展开内容；提供时折叠切换仅经 onToggle 上报 */
+    expanded?: boolean;
+    /** 非受控初始展开（缺省：thinking 展开、done 折叠） */
+    defaultExpanded?: boolean;
+    /** 折叠切换事件，传出目标展开态（Renderer 绑定 events.onToggle） */
+    onToggle?: (expanded: boolean) => void;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * Thinking 适配器（shadcn kit）：推理 / 处理中状态——
+ * 无边框无底色：头部（brain 图标 + 标题 + chevron 紧随其后）可折叠，
+ * 进行中图标脉冲；展开后内容仅以浅色文字呈现。
+ * 展开态非受控（defaultExpanded）或受控（expanded + onToggle）。
+ */
+declare function Thinking({ content, status, title, expanded, defaultExpanded, onToggle, className, style, }: ThinkingProps): react.JSX.Element;
+
+/** 工具调用状态 */
+type ToolCallStatus = 'running' | 'done' | 'error';
+interface ToolCallProps {
+    /** 工具名称 */
+    name?: string;
+    /** 调用参数（对象按 JSON 缩进展示，字符串原样展示） */
+    params?: unknown;
+    /** 状态，默认 done */
+    status?: ToolCallStatus;
+    /** 调用结果文本 */
+    result?: string;
+    /** 耗时（毫秒，展示为秒） */
+    durationMs?: number;
+    /** 非受控初始展开（缺省：running 展开、其余折叠） */
+    defaultExpanded?: boolean;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * ToolCall 适配器（shadcn kit）：工具调用——无边框无底色：头部
+ * （terminal 图标 + 名称 + 状态 + 耗时 + chevron 紧随其后）可折叠，
+ * 展开后参数 / 结果仅以浅色文字呈现；缺省 running 展开、done / error 折叠。
+ */
+declare function ToolCall({ name, params, status, result, durationMs, defaultExpanded, className, style }: ToolCallProps): react.JSX.Element;
+
+/**
+ * 注册 chat 展示组件族的 18 个 DSL 类型名（与迁移前 ui
+ * builtinComponents 的注册集合一致）；已存在同名类型时不覆盖。
+ */
+declare function registerChatComponents(registry: Registry<unknown>): void;
+
+export { AgentStatus, type AgentStatusProps, type AgentStatusType, ArtifactViewers, Attachment, type AttachmentItemData, type AttachmentProps, Bubble, type BubbleProps, type BubbleVariant, ChatMessage, type ChatMessageActionItem, type ChatMessageAgent, type ChatMessagePart, type ChatMessageProps, type ChatMessageStatus, ChatPage, ChatPageArtifact, type ChatPageBrand, type ChatPageMenuItem, type ChatPageProps, Citation, type CitationItem, type CitationProps, Composer, type ComposerContextItem, type ComposerContextSource, type ComposerModelOption, type ComposerProps, type ConversationItemData, ConversationList, type ConversationListProps, type ConversationRailItem, MessageList, type MessageListItem, type MessageListProps, Prompt, type PromptProps, Sender, type SenderProps, StepsPanel, type StepsPanelItemData, type StepsPanelProps, StreamingText, type StreamingTextProps, Suggestion, type SuggestionItem, type SuggestionProps, Thinking, type ThinkingProps, type ThinkingStatus, ToolCall, type ToolCallProps, type ToolCallStatus, Welcome, type WelcomePromptItem, type WelcomeProps, registerChatComponents };