@pactor-app/ui 1.20.0 → 1.22.0

package/dist/components/index.d.cts

@@ -1,10 +1,14 @@
 import { ComponentRegistry } from '@pactor-app/runtime';
 import * as React from 'react';
 import { CSSProperties, ReactNode, ReactElement } from 'react';
-import { DslNode, DslChildren } from '@pactor-app/core';
-import { i as CardRounded, t as toggleVariants, h as typographyVariants } from '../typography-BYDh5oku.cjs';
+import { DslNode, DslChildren, Registry } from '@pactor-app/core';
+import { n as CardRounded, g as ToastVariant, t as toggleVariants, m as typographyVariants } from '../typography-BYdZkkP5.cjs';
 import { LucideIcon } from 'lucide-react';
+import { MarkdownDslComponent } from '@pactor-app/markdown';
+export { MarkdownDslComponent as Markdown, MarkdownDslComponentProps as MarkdownProps } from '@pactor-app/markdown';
 import { VariantProps } from 'class-variance-authority';
+import { EChartsCoreOption } from 'echarts/core';
+import '@base-ui/react';
 import 'class-variance-authority/types';
 import '@base-ui/react/toggle';
 
@@ -32,6 +36,23 @@ interface AccordionProps {
  */
 declare function Accordion({ items, multiple, className, style, }: AccordionProps): React.JSX.Element;
 
+interface AffixProps {
+    /** 距离视口顶部偏移（像素），默认 0；与 offsetBottom 互斥 */
+    offsetTop?: number;
+    /** 距离视口底部偏移（像素）；提供时按底部吸附 */
+    offsetBottom?: number;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式（与偏移合并） */
+    style?: CSSProperties;
+    children?: ReactNode;
+}
+/**
+ * Affix 适配器（shadcn kit）：基于 position: sticky 的滚动吸附容器；
+ * offsetBottom 优先于 offsetTop（二者同 antd 互斥语义）。
+ */
+declare function Affix({ offsetTop, offsetBottom, className, style, children }: AffixProps): React.JSX.Element;
+
 /** DSL Alert 变体 */
 type AlertVariant = 'success' | 'info' | 'warning' | 'error';
 interface AlertProps {
@@ -86,6 +107,36 @@ interface AlertDialogProps {
  */
 declare function AlertDialog({ title, description, confirmText, cancelText, open, onConfirm, onCancel, trigger, className, style, }: AlertDialogProps): React.JSX.Element;
 
+interface AnchorItemData {
+    /** 目标锚点，形如 `#section-id` */
+    href: string;
+    /** 链接文案 */
+    title: string;
+    /** 嵌套子链接 */
+    children?: AnchorItemData[];
+}
+interface AnchorProps {
+    /** 锚点链接列表（可含表达式解析后的数组） */
+    items?: AnchorItemData[];
+    /** 受控：当前激活链接 href；提供时点击 / scroll-spy 仅经 onChange 上报，激活态完全由外部驱动 */
+    activeKey?: string;
+    /** 激活项变化事件（点击或滚动定位），传出 href（Renderer 绑定 events.onChange） */
+    onChange?: (href: string) => void;
+    /** 滚动定位时距离视口顶部的偏移（如有固定头部），默认 0 */
+    offsetTop?: number;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * Anchor 适配器（shadcn kit）：长页面章节点定位；点击平滑滚动到目标，
+ * 监听 window 滚动做 scroll-spy（取最后一个顶部越过 offsetTop 的章节）。
+ * 非受控（未传 activeKey）时内部维护激活态；受控时激活态完全由
+ * activeKey 驱动，变化仅经 onChange 上报（去重：与当前激活项相同不重复触发）。
+ */
+declare function Anchor({ items, activeKey, onChange, offsetTop, className, style }: AnchorProps): React.JSX.Element;
+
 interface AspectRatioProps {
     /** 宽高比（如 16/9，数字或 `'16/9'` 字符串），默认 1 */
     ratio?: number | string;
@@ -99,6 +150,25 @@ interface AspectRatioProps {
 /** AspectRatio 适配器（shadcn kit）：ratio → CSS aspect-ratio 容器 */
 declare function AspectRatio({ ratio, children, className, style }: AspectRatioProps): React.JSX.Element;
 
+interface AudioProps {
+    /** 音频地址 */
+    src?: string;
+    /** 是否显示原生控制条，默认 true */
+    controls?: boolean;
+    /** 自动播放（浏览器策略要求同时 muted 才生效） */
+    autoplay?: boolean;
+    /** 循环播放 */
+    loop?: boolean;
+    /** 静音 */
+    muted?: boolean;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/** Audio 适配器（shadcn kit）：原生 audio 包装，默认全宽 + 控制条 */
+declare function Audio({ src, controls, autoplay, loop, muted, className, style, }: AudioProps): React.JSX.Element;
+
 interface AvatarProps {
     /** 图片地址 */
     src?: string;
@@ -114,6 +184,22 @@ interface AvatarProps {
 /** Avatar 适配器（shadcn kit）：src / alt / fallback → vendored Avatar */
 declare function Avatar({ src, alt, fallback, className, style }: AvatarProps): React.JSX.Element;
 
+interface BackTopProps {
+    /** 滚动超过该高度后显示按钮（像素），默认 400 */
+    visibilityHeight?: number;
+    /** 自定义按钮内容（DSL 子树）；缺省为向上箭头圆形按钮 */
+    children?: ReactNode;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * BackTop 适配器（shadcn kit）：监听 window 滚动，超过 visibilityHeight
+ * 后右下角浮出按钮，点击平滑回到页面顶部。
+ */
+declare function BackTop({ visibilityHeight, children, className, style }: BackTopProps): React.JSX.Element | null;
+
 /** DSL Badge 变体 */
 type BadgeVariant = 'default' | 'secondary' | 'destructive' | 'outline';
 interface BadgeProps {
@@ -306,6 +392,40 @@ interface CarouselProps {
  */
 declare function Carousel({ items, loop, autoplay, className, style, }: CarouselProps): React.JSX.Element;
 
+/** Cascader 选项节点（嵌套，含 children 的节点点开下一列，叶子完成选择） */
+interface CascaderOption {
+    label: string;
+    value: string | number;
+    children?: CascaderOption[];
+}
+interface CascaderProps {
+    /** 字段名；在 Form 内声明 name 即自动成为表单项 */
+    name?: string;
+    /** 表单项标签 */
+    label?: string;
+    /** 校验规则 */
+    rules?: FieldRule[];
+    /** 嵌套选项 */
+    options?: CascaderOption[];
+    /** 受控值（路径 value 数组）；Form 内作为字段初始值 */
+    value?: Array<string | number>;
+    placeholder?: string;
+    disabled?: boolean;
+    /** 选中叶子事件，传出路径 value 数组 */
+    onChange?: (value: Array<string | number>) => void;
+    /** 通用：根节点 class（Form 内为 form-item 容器，独立渲染时为触发器） */
+    className?: string;
+    /** 通用：根节点内联样式（同 className 的挂载规则） */
+    style?: CSSProperties;
+}
+/**
+ * Cascader 适配器（shadcn kit）：触发器 + 受控 Popover 多列逐级下钻
+ * （点含 children 的节点开下一列，点叶子完成选择）；触发器文本用
+ * ` / ` 连接路径 label。onChange 传出路径 value 数组（DSL 语义值）；
+ * Form 内声明 `name` 自动成为表单项。
+ */
+declare function Cascader({ name, label, rules, options, value, placeholder, disabled, onChange, className, style, }: CascaderProps): React.JSX.Element;
+
 interface CheckboxProps {
     /** 字段名；在 Form 内声明 name 即自动成为表单项 */
     name?: string;
@@ -329,6 +449,24 @@ interface CheckboxProps {
  */
 declare function Checkbox({ name, label, rules, value, disabled, onChange, className, style, }: CheckboxProps): React.JSX.Element;
 
+interface CodeBlockProps {
+    /** 代码内容 */
+    code?: string;
+    /** 语言（Prism 已注册表：bash/css/js/jsx/ts/tsx/json/md/python/yaml 等；未注册语言降级为纯文本） */
+    language?: string;
+    /** 是否显示复制按钮，默认 true */
+    copyable?: boolean;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * CodeBlock 适配器（shadcn kit）：语法高亮代码块（复用
+ * @pactor-app/markdown 的 Prism Light 高亮器）+ 可选复制按钮。
+ */
+declare function CodeBlock({ code, language, copyable, className, style }: CodeBlockProps): React.JSX.Element;
+
 interface CollapsibleProps {
     /** 触发区标题 */
     title?: string;
@@ -347,6 +485,34 @@ interface CollapsibleProps {
  */
 declare function Collapsible({ title, open, children, className, style, }: CollapsibleProps): React.JSX.Element;
 
+interface ColorPickerProps {
+    /** 字段名；在 Form 内声明 name 即自动成为表单项 */
+    name?: string;
+    /** 表单项标签 */
+    label?: string;
+    /** 校验规则 */
+    rules?: FieldRule[];
+    /** 受控值（hex 颜色，支持 3/4/6/8 位，如 1677ff、1677ffcc）；Form 内作为字段初始值 */
+    value?: string;
+    /** 预设色板（hex 数组） */
+    presets?: string[];
+    placeholder?: string;
+    disabled?: boolean;
+    /** 颜色变化事件，传出 hex 字符串（透明度小于 1 时为 8 位 hex） */
+    onChange?: (value: string) => void;
+    /** 通用：根节点 class（Form 内为 form-item 容器，独立渲染时为触发器） */
+    className?: string;
+    /** 通用：根节点内联样式（同 className 的挂载规则） */
+    style?: CSSProperties;
+}
+/**
+ * ColorPicker 适配器（shadcn kit）：react-color Sketch 风格取色面板——
+ * 饱和度/明度二维面板 + 色相/透明度滑杆 + 当前色预览 + hex 与 RGBA
+ * 通道输入 + 预设色板；拖拽过程实时提交（onChange 传出 6/8 位 hex，
+ * DSL 语义值）。Form 内声明 `name` 自动成为表单项。
+ */
+declare function ColorPicker({ name, label, rules, value, presets, placeholder, disabled, onChange, className, style, }: ColorPickerProps): React.JSX.Element;
+
 /** Combobox 选项（支持表达式解析后的数组） */
 interface ComboboxOption {
     label: string;
@@ -416,32 +582,6 @@ interface CommandProps {
  */
 declare function Command({ groups, placeholder, emptyText, onSelect, className, style, }: CommandProps): React.JSX.Element;
 
-/** 图表类型 */
-type ChartType = 'line' | 'bar' | 'area' | 'pie';
-interface ChartProps {
-    /** 图表类型：line / bar / area / pie */
-    chartType: ChartType;
-    /** 数据数组（通常为 `${data.xxx}` 表达式解析结果） */
-    data?: Record<string, unknown>[];
-    /** 类目/名称字段（pie 时为切片 name 字段） */
-    xKey?: string;
-    /** 数值字段（多系列传多个；pie 取第一个作为 value 字段） */
-    yKeys?: string[];
-    /** 系列颜色（按序循环），缺省使用 chart-1..5 语义令牌 */
-    colors?: string[];
-    /** 通用：根节点 class（与内置样式合并） */
-    className?: string;
-    /** 通用：根节点内联样式 */
-    style?: CSSProperties;
-}
-/**
- * Chart 适配器（shadcn kit，recharts 薄封装）：以受限框架级 props
- * （chartType / data / xKey / yKeys / colors）渲染 line/bar/area/pie
- * 图表，不透传 recharts 自由组合 API；缺省配色取 chart-1..5 令牌；
- * 多系列（yKeys > 1）或 pie 时渲染 Legend。
- */
-declare function Chart({ chartType, data, xKey, yKeys, colors, className, style, }: ChartProps): React.JSX.Element;
-
 interface ChatInputProps {
     /** 受控值（提供即受控：变更只经 onChange 传出，显示值取自 props） */
     value?: string;
@@ -454,14 +594,21 @@ interface ChatInputProps {
      * hideSend 且左右槽均未提供时工具栏行整体零渲染
      */
     hideSend?: boolean;
-    /** 工具栏左端槽（DslNode 子树，经 Renderer children 机制渲染） */
-    toolbarStart?: DslNode;
+    /** 工具栏左端槽（DslNode 子树经 Renderer 渲染；React 宿主可直接传元素） */
+    toolbarStart?: DslNode | ReactNode;
     /** 工具栏右端槽（发送钮之前） */
-    toolbarEnd?: DslNode;
+    toolbarEnd?: DslNode | ReactNode;
     /** 顶部区槽（提供时渲染在 textarea 上方，与 footer 对称；附件卡片、上下文 chips 等输入上下文展示） */
-    header?: DslNode;
+    header?: DslNode | ReactNode;
     /** 底部区槽（提供时渲染，与工具栏以分隔线相隔） */
-    footer?: DslNode;
+    footer?: DslNode | ReactNode;
+    /**
+     * 自定义输入区（提供时替换内建 textarea）：调用方自持编辑面
+     * （如 contenteditable 行内提及输入区）；此时文本仍经受控
+     * value 驱动（canSubmit / 发送钮禁用逻辑），Enter 发送由自定义
+     * 输入区自行处理（内建 textarea 的键盘语义不生效）
+     */
+    field?: ReactNode;
     /** 输入事件，传出 string 值 */
     onChange?: (value: string) => void;
     /** 发送事件（点击发送钮或 Enter），传出当前文本 */
@@ -485,7 +632,26 @@ interface ChatInputProps {
  * 定位为通用结构构件：transport / 附件 / 提及等对话领域能力请使用
  * @pactor-app/chat 的 Composer。
  */
-declare function ChatInput({ value, placeholder, disabled, rows, hideSend, toolbarStart, toolbarEnd, header, footer, onChange, onSubmit, className, style, }: ChatInputProps): React.JSX.Element;
+declare function ChatInput({ value, placeholder, disabled, rows, hideSend, toolbarStart, toolbarEnd, header, footer, field, onChange, onSubmit, className, style, }: ChatInputProps): React.JSX.Element;
+
+/** DSL Container 宽度档位（对齐 Tailwind 断点） */
+type ContainerSize = 'sm' | 'md' | 'lg' | 'xl' | 'full';
+interface ContainerProps {
+    /** 最大宽度档位，默认 lg；full 不限制宽度 */
+    size?: ContainerSize;
+    /** 是否水平居中，默认 true */
+    centered?: boolean;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+    children?: ReactNode;
+}
+/**
+ * Container 布局（shadcn kit）：限制内容最大宽度并建立页面两侧留白；
+ * 默认水平居中，左右各留 px-4 内边距。
+ */
+declare function Container({ size, centered, className, style, children, }: ContainerProps): React.JSX.Element;
 
 interface ContentProps {
     /** 通用：根节点 class（与内置样式合并） */
@@ -653,6 +819,28 @@ type DatePickerProps = DatePickerSingleProps | DatePickerRangeProps;
  */
 declare function DatePicker(props: DatePickerProps): React.JSX.Element;
 
+/** 描述项：标签—值对 */
+interface DescriptionsItemData {
+    label: string;
+    value: string | number;
+}
+interface DescriptionsProps {
+    /** 标题 */
+    title?: string;
+    /** 描述项列表（可含表达式解析后的数组） */
+    items?: DescriptionsItemData[];
+    /** 每行列数，缺省 3 */
+    column?: number;
+    /** 带边框样式 */
+    bordered?: boolean;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/** Descriptions 适配器（shadcn kit）：标签—值栅格；bordered 时以边框栅格呈现 */
+declare function Descriptions({ title, items, column, bordered, className, style, }: DescriptionsProps): React.JSX.Element;
+
 interface DialogProps {
     /** 对话框标题 */
     title?: string;
@@ -678,6 +866,57 @@ interface DialogProps {
  */
 declare function Dialog({ title, description, open, onClose, trigger, children, className, style, }: DialogProps): React.JSX.Element;
 
+interface DiffViewerProps {
+    /** 旧文本（按行比较） */
+    oldText?: string;
+    /** 新文本（按行比较） */
+    newText?: string;
+    /** 左右分栏视图，默认 false（统一视图） */
+    split?: boolean;
+    /** 分栏视图的左右栏标题 */
+    oldTitle?: string;
+    newTitle?: string;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+type DiffOpType = 'same' | 'add' | 'del';
+interface DiffOp {
+    type: DiffOpType;
+    text: string;
+}
+/** LCS 行级 diff：返回按序操作流（same / del / add） */
+declare function diffLines(oldText: string, newText: string): DiffOp[];
+/**
+ * DiffViewer 适配器（shadcn kit）：文本 / 代码行级差异对比（LCS 算法）；
+ * 统一视图（+/- 行）与左右分栏视图（split）。
+ */
+declare function DiffViewer({ oldText, newText, split, oldTitle, newTitle, className, style }: DiffViewerProps): React.JSX.Element;
+
+/** 文档页：src 渲染图片页，content 渲染文本页（二者择一，src 优先） */
+interface DocumentPageData {
+    src?: string;
+    content?: string;
+}
+interface DocumentPreviewProps {
+    /** 分页内容（可含表达式解析后的数组）；不解析 PDF 等二进制格式 */
+    pages?: DocumentPageData[];
+    /** 受控：当前页码（从 1 起）；提供时翻页仅经 onChange 上报 */
+    currentPage?: number;
+    /** 翻页事件，传出目标页码（Renderer 绑定 events.onChange） */
+    onChange?: (page: number) => void;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * DocumentPreview 适配器（shadcn kit）：分页文档阅读器——
+ * 图片页 / 文本页 + 翻页（受控可选）+ 缩放工具条 + 页码指示。
+ */
+declare function DocumentPreview({ pages, currentPage, onChange, className, style }: DocumentPreviewProps): React.JSX.Element;
+
 type DrawerPlacement = 'left' | 'right' | 'top' | 'bottom';
 interface DrawerProps {
     /** 抽屉标题 */
@@ -782,6 +1021,35 @@ interface FieldProps {
  */
 declare function Field({ label, required, description, error, children, className, style, labelClassName, labelStyle, controlClassName, controlStyle, descriptionClassName, descriptionStyle, errorClassName, errorStyle, }: FieldProps): React.JSX.Element;
 
+/** 文件类别（缺省按 fileType / name 扩展名推断） */
+type FilePreviewKind = 'image' | 'text' | 'video' | 'audio' | 'other';
+interface FilePreviewProps {
+    /** 文件名（含扩展名，用于类型推断与展示） */
+    name?: string;
+    /** 文件大小（字节，展示前格式化为 KB/MB） */
+    fileSize?: number;
+    /** MIME 或扩展名（如 image/png、.md），用于类型推断 */
+    fileType?: string;
+    /** 文件地址：图片 / 视频 / 音频的内嵌预览与下载链接均使用 */
+    src?: string;
+    /** 文本文件内容（kind=text 时内嵌展示） */
+    content?: string;
+    /** 显式指定类别（覆盖推断） */
+    kind?: FilePreviewKind;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/** 按 MIME / 扩展名推断类别 */
+declare function inferKind(name?: string, fileType?: string): FilePreviewKind;
+/**
+ * FilePreview 适配器（shadcn kit）：常见文件内嵌预览 + 元信息卡片。
+ * image / video / audio 经 src 内嵌渲染，text 展示 content 文本，
+ * 其余类型展示图标 + 元信息；提供 src 时渲染下载链接。
+ */
+declare function FilePreview({ name, fileSize, fileType, src, content, kind, className, style, }: FilePreviewProps): React.JSX.Element;
+
 interface FlexProps {
     /** 主轴方向，默认 horizontal */
     direction?: 'horizontal' | 'vertical';
@@ -817,6 +1085,32 @@ interface FooterProps {
  */
 declare function Footer({ className, style, children }: FooterProps): React.JSX.Element;
 
+interface GalleryItemData {
+    /** 图片地址 */
+    src: string;
+    /** 替代文本 */
+    alt?: string;
+    /** 图片说明（缩略图底部一行） */
+    caption?: string;
+}
+interface GalleryProps {
+    /** 图片列表（可含表达式解析后的数组） */
+    items?: GalleryItemData[];
+    /** 缩略图列数，默认 3 */
+    columns?: 2 | 3 | 4;
+    /** 灯箱关闭事件（Renderer 绑定 events.onClose） */
+    onClose?: () => void;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * Gallery 适配器（shadcn kit）：多图浏览——缩略图栅格 +
+ * 点击打开灯箱（与 ImageViewer 共享 ImageLightbox，含前后切换与序号）。
+ */
+declare function Gallery({ items, columns, onClose, className, style }: GalleryProps): React.JSX.Element;
+
 interface FormProps {
     /** 表单名（缺省 'default'）：`form.setValues` 联动动作按名寻址 */
     name?: string;
@@ -1001,6 +1295,67 @@ declare function normalizeIconName(name: string): string;
  */
 declare function Icon({ name, size, color, strokeWidth, className, style, }: IconProps): React.JSX.Element;
 
+interface ImageProps {
+    /** 图片地址 */
+    src?: string;
+    /** 替代文本 */
+    alt?: string;
+    /** 宽度（px 或 CSS 长度） */
+    width?: number | string;
+    /** 高度（px 或 CSS 长度） */
+    height?: number | string;
+    /** 加载失败时显示的内容；缺省为图标 + 灰色占位块 */
+    fallback?: ReactNode;
+    /** 点击经 Dialog 弹层放大预览，缺省 true */
+    preview?: boolean;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * Image 适配器（shadcn kit）：加载失败渲染 fallback（缺省灰色占位块）；
+ * preview 开启时点击经 vendored Dialog 弹层放大查看（居中大图，可关闭）。
+ */
+declare function Image({ src, alt, width, height, fallback, preview, className, style, }: ImageProps): React.JSX.Element;
+
+interface ImageViewerProps {
+    /** 图片地址 */
+    src?: string;
+    /** 替代文本 */
+    alt?: string;
+    /** 是否允许点击放大查看（灯箱：缩放 / 旋转 / 复位），默认 true */
+    preview?: boolean;
+    /** 灯箱关闭事件（Renderer 绑定 events.onClose） */
+    onClose?: () => void;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+interface ImageLightboxProps {
+    src?: string;
+    alt?: string;
+    /** 当前序号（从 1 起）与总数；提供 count > 1 时显示序号与前后切换 */
+    index?: number;
+    count?: number;
+    onPrev?: () => void;
+    onNext?: () => void;
+    onClose: () => void;
+}
+/**
+ * 图片灯箱（ImageViewer / Gallery 共享，不注册为 DSL 组件）：
+ * 覆盖层 + 居中图片（scale / rotate 变换）+ 工具条（放大 / 缩小 / 旋转 /
+ * 复位 / 关闭）+ 可选前后切换与序号；Esc 或点击遮罩关闭。
+ */
+declare function ImageLightbox({ src, alt, index, count, onPrev, onNext, onClose }: ImageLightboxProps): React.JSX.Element;
+/**
+ * ImageViewer 适配器（shadcn kit）：单图查看器——行内图片 +
+ * 点击打开灯箱（缩放 / 旋转 / 复位 / Esc 与遮罩关闭）。
+ * 与数据展示分类 Image 的差异：本组件面向「查看」，Image 面向「展示」。
+ */
+declare function ImageViewer({ src, alt, preview, onClose, className, style }: ImageViewerProps): React.JSX.Element;
+
 interface InputGroupProps {
     /** 通用：根节点 class（与内置样式合并） */
     className?: string;
@@ -1065,6 +1420,25 @@ interface ItemProps {
  */
 declare function Item({ title, description, media, actions, className, style, }: ItemProps): React.JSX.Element;
 
+interface JSONViewerProps {
+    /** 结构化数据（可含表达式解析后的对象 / 数组） */
+    data?: unknown;
+    /** 默认展开深度（0 全部折叠，1 展开根节点），默认 1 */
+    expandedDepth?: number;
+    /** 是否在根部显示复制按钮（复制格式化 JSON），默认 true */
+    copyable?: boolean;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * JSONViewer 适配器（shadcn kit）：结构化数据的折叠检查与复制——
+ * 对象 / 数组节点可折叠（带条目摘要），叶子值按类型着色
+ * （string → success / number → info / boolean → warning / null → muted）。
+ */
+declare function JSONViewer({ data, expandedDepth, copyable, className, style }: JSONViewerProps): React.JSX.Element;
+
 interface KbdProps {
     /** 按键文本（如 ⌘K） */
     text?: string;
@@ -1131,6 +1505,87 @@ interface LinkProps {
  */
 declare function Link({ href, text, target, className, style, children }: LinkProps): React.JSX.Element;
 
+/** 列表项：左 avatar（图片 src 或占位文本）、中 title+description、右 extra */
+interface ListItemData {
+    key?: string;
+    title: string;
+    description?: string;
+    /** 头像：图片地址（http(s):/data:/路径）或占位文本 */
+    avatar?: string;
+    /** 行尾附加内容（字符串） */
+    extra?: string;
+}
+interface ListProps {
+    /** 列表数据（可含表达式解析后的数组）；为空时渲染空态 */
+    items?: ListItemData[];
+    /** 行间分隔线，缺省 true */
+    split?: boolean;
+    /** 外边框 */
+    bordered?: boolean;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/** List 适配器（shadcn kit）：纵向行式列表；items 为空时复用 Empty 原语渲染空态 */
+declare function List({ items, split, bordered, className, style, }: ListProps): React.JSX.Element;
+
+interface LoadingOverlayProps {
+    /** 是否处于加载态（显示覆盖层） */
+    loading?: boolean;
+    /** 加载提示文案 */
+    text?: string;
+    /** 被覆盖区块（DSL 子树，经 Renderer children 机制渲染） */
+    children?: ReactNode;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * LoadingOverlay 适配器（shadcn kit）：局部加载遮罩——容器相对定位包
+ * children，loading 时覆盖半透明绝对定位层（居中 Spinner + 可选文案）；
+ * loading=false 时只渲染 children。无 children 时退化为独立 Spinner。
+ */
+declare function LoadingOverlay({ loading, text, children, className, style, }: LoadingOverlayProps): React.JSX.Element | null;
+
+/** Mentions 候选项 */
+interface MentionOption {
+    label: string;
+    value: string;
+}
+interface MentionsProps {
+    /** 字段名；在 Form 内声明 name 即自动成为表单项 */
+    name?: string;
+    /** 表单项标签 */
+    label?: string;
+    /** 校验规则 */
+    rules?: FieldRule[];
+    /** 候选列表 */
+    options?: MentionOption[];
+    /** 触发字符，缺省 '@' */
+    trigger?: string;
+    /** 文本域行数 */
+    rows?: number;
+    placeholder?: string;
+    /** 受控值（完整字符串）；Form 内作为字段初始值 */
+    value?: string;
+    disabled?: boolean;
+    /** 输入变化事件，传出完整字符串 */
+    onChange?: (value: string) => void;
+    /** 通用：根节点 class（Form 内为 form-item 容器，独立渲染时为控件包裹节点） */
+    className?: string;
+    /** 通用：根节点内联样式（同 className 的挂载规则） */
+    style?: CSSProperties;
+}
+/**
+ * Mentions 适配器（shadcn kit）：textarea 输入 trigger 字符后弹候选浮层
+ * （按 trigger 后的查询串过滤 label / value），点击或 Enter 选中后在
+ * 光标处插入 `trigger + value + 空格`；↑/↓ 移动高亮，Esc 关闭。
+ * onChange 传出完整字符串（DSL 语义值）；Form 内声明 `name` 自动成为表单项。
+ */
+declare function Mentions({ name, label, rules, options, trigger, rows, placeholder, value, disabled, onChange, className, style, }: MentionsProps): React.JSX.Element;
+
 /** 菜单项；`children` 为子菜单（inline 模式下缩进展示） */
 interface MenuItem {
     key: string;
@@ -1208,6 +1663,25 @@ interface MenubarProps {
  */
 declare function Menubar({ menus, onSelect, className, style }: MenubarProps): React.JSX.Element;
 
+interface MessageProps {
+    /** 反馈文案：变为非空字符串时（含首次挂载）发一条全局短 toast */
+    content?: string;
+    /** 语义类型，缺省 info */
+    variant?: ToastVariant;
+    /** 自动关闭时长（ms） */
+    duration?: number;
+    /** 通用：标记节点 class */
+    className?: string;
+    /** 通用：标记节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * Message 适配器（shadcn kit）：声明式全局短反馈触发器。
+ * content 引用变化且非空时经 vendored toast 原语发一条全局短 toast；
+ * 自身只渲染 hidden 标记节点（不强制 display:none，通用 props 正常挂载）。
+ */
+declare function Message({ content, variant, duration, className, style }: MessageProps): React.JSX.Element;
+
 /** 子链接项 */
 interface NavigationMenuChildItem {
     label: string;
@@ -1239,8 +1713,29 @@ interface NavigationMenuProps {
  */
 declare function NavigationMenu({ items, className, style }: NavigationMenuProps): React.JSX.Element;
 
-interface NumberInputProps {
-    /** 字段名；在 Form 内声明 name 即自动成为表单项 */
+interface NotificationProps {
+    /** 通知标题：变为非空字符串时（含首次挂载）发一条富通知 toast */
+    title?: string;
+    /** 通知正文（toast description） */
+    description?: string;
+    /** 语义类型，缺省 info */
+    variant?: ToastVariant;
+    /** 自动关闭时长（ms） */
+    duration?: number;
+    /** 通用：标记节点 class */
+    className?: string;
+    /** 通用：标记节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * Notification 适配器（shadcn kit）：声明式全局富通知触发器。
+ * title 引用变化且非空时经 vendored toast 原语发一条 title+description
+ * 的富通知 toast；自身只渲染 hidden 标记节点。
+ */
+declare function Notification({ title, description, variant, duration, className, style, }: NotificationProps): React.JSX.Element;
+
+interface NumberInputProps {
+    /** 字段名；在 Form 内声明 name 即自动成为表单项 */
     name?: string;
     /** 表单项标签 */
     label?: string;
@@ -1310,6 +1805,35 @@ interface PaginationProps {
  */
 declare function Pagination({ total, pageSize, page, onChange, className, style, }: PaginationProps): React.JSX.Element;
 
+interface PopconfirmProps {
+    /** 确认框标题 */
+    title?: string;
+    /** 辅助说明文案 */
+    description?: string;
+    /** 确认按钮文案（缺省取 i18n `pactor.alertDialog.confirm`，即「确定」） */
+    confirmText?: string;
+    /** 取消按钮文案（缺省取 i18n `pactor.alertDialog.cancel`，即「取消」） */
+    cancelText?: string;
+    /** 确认按钮使用危险色 */
+    danger?: boolean;
+    /** 确认事件：点击确认按钮触发，且浮层关闭 */
+    onConfirm?: () => void;
+    /** 取消事件：点击取消按钮触发，且浮层关闭 */
+    onCancel?: () => void;
+    /** 触发元素（DSL 子树，经 Renderer children 机制渲染） */
+    children?: ReactNode;
+    /** 通用：浮层内容根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：内联样式（同 className 挂载规则） */
+    style?: CSSProperties;
+}
+/**
+ * Popconfirm 适配器（shadcn kit）：基于 vendored Popover 的轻量确认框——
+ * 点击触发元素弹出卡片（标题/说明 + 取消/确定按钮组），确认或取消后
+ * 浮层关闭并触发对应事件。
+ */
+declare function Popconfirm({ title, description, confirmText, cancelText, danger, onConfirm, onCancel, children, className, style, }: PopconfirmProps): React.JSX.Element;
+
 interface PopoverProps {
     /** 浮层内容：DSL 子树（对象，原样保留至渲染层求值）或纯文本 */
     content?: DslNode | string;
@@ -1337,6 +1861,29 @@ interface ProgressProps {
 /** Progress 适配器（shadcn kit）：value（0-100）→ vendored Progress（Base UI） */
 declare function Progress({ value, className, style }: ProgressProps): React.JSX.Element;
 
+interface QRCodeProps {
+    /** 编码内容；为空时渲染占位块 */
+    value?: string;
+    /** 尺寸（px），缺省 128 */
+    size?: number;
+    /** 码体颜色（# 开头 hex，支持 3/4/6/8 位，8 位含透明度），非法值回退为生成库内建黑色 */
+    color?: string;
+    /** 背景色（同 color 格式），非法值回退为生成库内建白色 */
+    bgColor?: string;
+    /** 带边框与内边距 */
+    bordered?: boolean;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * QRCode 适配器（shadcn kit）：以 qrcode 包生成内联 SVG
+ * （toString(value, { type: 'svg' })，自生成可信内容经 dangerouslySetInnerHTML 渲染）；
+ * value 为空时渲染占位块。
+ */
+declare function QRCode({ value, size, color, bgColor, bordered, className, style, }: QRCodeProps): React.JSX.Element;
+
 /** RadioGroup 选项 */
 interface RadioGroupOption {
     label: string;
@@ -1373,6 +1920,34 @@ interface RadioGroupProps {
  */
 declare function RadioGroup({ name, label, rules, options, direction, value, disabled, onChange, className, style, }: RadioGroupProps): React.JSX.Element;
 
+interface RateProps {
+    /** 字段名；在 Form 内声明 name 即自动成为表单项 */
+    name?: string;
+    /** 表单项标签 */
+    label?: string;
+    /** 校验规则 */
+    rules?: FieldRule[];
+    /** 受控值（独立渲染时生效）；Form 内作为字段初始值（优先于 Form initialValues） */
+    value?: number;
+    /** 星总数，缺省 5 */
+    count?: number;
+    /** 允许半星（点击星左半得 x.5，右半得整数） */
+    allowHalf?: boolean;
+    disabled?: boolean;
+    /** 评分变化事件，传出 number */
+    onChange?: (value: number) => void;
+    /** 通用：根节点 class（Form 内为 form-item 容器，独立渲染时为控件本身） */
+    className?: string;
+    /** 通用：根节点内联样式（同 className 的挂载规则） */
+    style?: CSSProperties;
+}
+/**
+ * Rate 适配器（shadcn kit）：lucide Star 星形评分，支持半星
+ * （每星左/右两个点击区）；onChange 传出 number（DSL 语义值）；
+ * Form 内声明 `name` 自动成为表单项。
+ */
+declare function Rate({ name, label, rules, value, count, allowHalf, disabled, onChange, className, style, }: RateProps): React.JSX.Element;
+
 /** 可拖拽面板；`children` 为 DSL 子树，经 renderChildren 渲染 */
 interface ResizablePanelData {
     children?: DslNode[];
@@ -1403,6 +1978,44 @@ interface ResizableProps {
  */
 declare function Resizable({ panels, direction, className, style, }: ResizableProps): React.JSX.Element;
 
+/** Result 状态：四态语义 + HTTP 错误页 */
+type ResultStatus = 'success' | 'error' | 'info' | 'warning' | '404' | '403' | '500';
+interface ResultProps {
+    /** 状态，缺省 info */
+    status?: ResultStatus;
+    /** 标题 */
+    title?: string;
+    /** 副标题 */
+    subTitle?: string;
+    /** 操作区（DSL 子树，经 Renderer children 机制渲染） */
+    children?: ReactNode;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * Result 适配器（shadcn kit）：结果页——居中大图标（404/403/500 渲染
+ * 状态码大字）+ 标题 + 副标题 + 操作区。
+ */
+declare function Result({ status, title, subTitle, children, className, style, }: ResultProps): React.JSX.Element;
+
+interface RichTextProps {
+    /** 富文本 HTML（渲染前经 DOMPurify 白名单消毒） */
+    html?: string;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * RichText 适配器（shadcn kit）：渲染富文本 HTML。
+ * 安全边界：所有内容先经 DOMPurify 消毒（剔除 script / 内联事件 /
+ * javascript: URL 等），再以 dangerouslySetInnerHTML 挂载；
+ * 与 Markdown 组件（AST 渲染、不碰原始 HTML）形成互补。
+ */
+declare function RichText({ html, className, style }: RichTextProps): React.JSX.Element;
+
 interface ScrollAreaProps {
     /** 最大高度（px 或 CSS 长度），超出后出现自定义滚动条 */
     maxHeight?: number | string;
@@ -1420,6 +2033,40 @@ interface ScrollAreaProps {
  */
 declare function ScrollArea({ maxHeight, maxWidth, className, style, children, }: ScrollAreaProps): React.JSX.Element;
 
+/** 分段选项；`icon` 为 Icon 白名单图标名（kebab-case 或 PascalCase） */
+interface SegmentedOption {
+    label: string;
+    value: string | number;
+    icon?: string;
+    disabled?: boolean;
+}
+interface SegmentedProps {
+    /** 字段名；在 Form 内声明 name 即自动成为表单项 */
+    name?: string;
+    /** 表单项标签 */
+    label?: string;
+    /** 校验规则 */
+    rules?: FieldRule[];
+    /** 选项列表（可含表达式解析后的数组） */
+    options?: SegmentedOption[];
+    /** 受控值（独立渲染时生效）；Form 内作为字段初始值（优先于 Form initialValues） */
+    value?: string | number;
+    /** 整体禁用 */
+    disabled?: boolean;
+    /** 选中变化事件，传出选中项的 value */
+    onChange?: (value: string | number) => void;
+    /** 通用：根节点 class（Form 内为 form-item 容器，独立渲染时为控件本身） */
+    className?: string;
+    /** 通用：根节点内联样式（同 className 的挂载规则） */
+    style?: CSSProperties;
+}
+/**
+ * Segmented 适配器（shadcn kit）：药丸式分段选择器，选中项由滑动
+ * 指示块（absolute pill，left/width 过渡）承载高亮；onChange 传出
+ * 选中项 value（DSL 语义值）；Form 集成同 Slider 模式。
+ */
+declare function Segmented({ name, label, rules, options, value, disabled, onChange, className, style, }: SegmentedProps): React.JSX.Element;
+
 /** Select 选项（支持表达式解析后的数组） */
 interface SelectOption {
     label: string;
@@ -1650,6 +2297,27 @@ interface SonnerProps {
  */
 declare function Sonner({ className, style }: SonnerProps): React.JSX.Element;
 
+interface SpaceProps {
+    /** 排列方向，默认 horizontal */
+    direction?: 'horizontal' | 'vertical';
+    /** 间距档位（antd small=8 / middle=16 / large=24）或具体像素值，默认 small */
+    size?: 'small' | 'middle' | 'large' | number;
+    /** 交叉轴对齐 */
+    align?: 'start' | 'center' | 'end' | 'baseline';
+    /** 超出时是否换行，默认 false */
+    wrap?: boolean;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式（与数字 size 合并） */
+    style?: CSSProperties;
+    children?: ReactNode;
+}
+/**
+ * Space 布局（shadcn kit）：为一组相邻子节点提供一致间距；
+ * 与 Flex 的差异是语义更窄——只做等间距排列（含换行），不做主轴分布。
+ */
+declare function Space({ direction, size, align, wrap, className, style, children, }: SpaceProps): React.JSX.Element;
+
 /** DSL Spinner 尺寸 */
 type SpinnerSize = 'sm' | 'default' | 'lg';
 interface SpinnerProps {
@@ -1680,6 +2348,54 @@ interface StatisticProps {
 /** Statistic 适配器（shadcn kit）：标题 + 数值（precision 精度 / suffix 后缀） */
 declare function Statistic({ title, value, precision, suffix, className, style }: StatisticProps): React.JSX.Element;
 
+/** DSL Status 状态（对齐 antd Badge status 五态） */
+type StatusType = 'success' | 'processing' | 'error' | 'warning' | 'default';
+interface StatusProps {
+    /** 状态，默认 default */
+    status?: StatusType;
+    /** 状态文本 */
+    text?: string;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * Status 适配器（shadcn kit）：状态点 + 文本；processing 态叠加
+ * animate-ping 扩散动画表示进行中。
+ */
+declare function Status({ status, text, className, style }: StatusProps): React.JSX.Element;
+
+/** 步骤状态；缺省按 current 推导（小于 current 为 finish，等于为 process，大于为 wait） */
+type StepStatus = 'wait' | 'process' | 'finish' | 'error';
+interface StepItemData {
+    /** 步骤标题 */
+    title: string;
+    /** 步骤描述 */
+    description?: string;
+    /** 显式指定状态（覆盖按 current 的推导） */
+    status?: StepStatus;
+    /** 自定义图标名（Icon 白名单）；提供时替代序号 / 状态图标 */
+    icon?: string;
+}
+interface StepsProps {
+    /** 步骤列表（可含表达式解析后的数组） */
+    items?: StepItemData[];
+    /** 当前步骤下标（从 0 开始），默认 0 */
+    current?: number;
+    /** 方向，默认 horizontal */
+    direction?: 'horizontal' | 'vertical';
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * Steps 适配器（shadcn kit）：流程步骤条；状态按 current 推导、可被
+ * item.status 覆盖，图标优先级 item.icon > 状态图标（√/×）> 序号。
+ */
+declare function Steps({ items, current, direction, className, style }: StepsProps): React.JSX.Element;
+
 interface SwitchProps {
     /** 字段名；在 Form 内声明 name 即自动成为表单项 */
     name?: string;
@@ -1782,6 +2498,33 @@ interface TabsProps {
  */
 declare function Tabs({ items, activeKey, variant, onChange, contentClassName, contentStyle, className, style, }: TabsProps): React.JSX.Element;
 
+/** DSL Tag 语义色 */
+type TagColor = 'default' | 'success' | 'warning' | 'error' | 'info';
+interface TagProps {
+    /** 标签文本 */
+    text?: string;
+    /** 语义色，默认 default */
+    color?: TagColor;
+    /** 是否描边，默认 true（antd bordered） */
+    bordered?: boolean;
+    /** 是否可关闭；点击关闭按钮触发 onClose 并隐藏自身 */
+    closable?: boolean;
+    /** 关闭事件（Renderer 绑定 events.onClose） */
+    onClose?: () => void;
+    /** 前缀图标名（Icon 白名单，kebab-case / PascalCase 均可） */
+    icon?: string;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * Tag 适配器（shadcn kit）：语义色小标签；closable 时尾部渲染关闭按钮，
+ * 点击触发 onClose 并在非受控场景隐藏自身（DSL 侧可通过 events.onClose
+ * 同步更新数据源实现受控移除）。
+ */
+declare function Tag({ text, color, bordered, closable, onClose, icon, className, style, }: TagProps): React.JSX.Element | null;
+
 /** DSL Text 语义类型 */
 type TextType = 'default' | 'secondary' | 'success' | 'warning' | 'danger';
 /** DSL Text 字号（middle 缺省继承上下文字号） */
@@ -1836,6 +2579,55 @@ interface TextareaProps {
  */
 declare function Textarea({ name, label, rules, value, placeholder, rows, disabled, onChange, className, style, }: TextareaProps): React.JSX.Element;
 
+interface TimePickerProps {
+    /** 字段名；在 Form 内声明 name 即自动成为表单项 */
+    name?: string;
+    /** 表单项标签 */
+    label?: string;
+    /** 校验规则 */
+    rules?: FieldRule[];
+    /** 受控值（时间字符串，如 "13:45:00"）；Form 内作为字段初始值 */
+    value?: string;
+    /** 输出格式：'HH:mm:ss'（缺省，含秒列）或 'HH:mm'（无秒列、值无秒） */
+    format?: 'HH:mm:ss' | 'HH:mm';
+    placeholder?: string;
+    disabled?: boolean;
+    /** 时间变化事件，传出按 format 格式化的时间字符串 */
+    onChange?: (value: string) => void;
+    /** 通用：根节点 class（Form 内为 form-item 容器，独立渲染时为触发器） */
+    className?: string;
+    /** 通用：根节点内联样式（同 className 的挂载规则） */
+    style?: CSSProperties;
+}
+/**
+ * TimePicker 适配器（shadcn kit）：input 风格触发器 + 受控 Popover，
+ * 弹层内为时/分（/秒）列滚动列表，点选更新待选值，「确定」提交、
+ * 「此刻」取当前时间。`format: 'HH:mm'` 时无秒列、值无秒。
+ * onChange 传出时间字符串（DSL 语义值）；Form 内声明 `name` 自动成为表单项。
+ */
+declare function TimePicker({ name, label, rules, value, format, placeholder, disabled, onChange, className, style, }: TimePickerProps): React.JSX.Element;
+
+/** 时间轴节点；`icon` 为 Icon 白名单图标名（kebab-case 或 PascalCase） */
+interface TimelineItemData {
+    content: string;
+    time?: string;
+    /** 节点圆点颜色（CSS 颜色值） */
+    color?: string;
+    icon?: string;
+}
+interface TimelineProps {
+    /** 节点列表（可含表达式解析后的数组） */
+    items?: TimelineItemData[];
+    /** 末尾追加「进行中」节点：true 用默认文案，字符串为自定义文案 */
+    pending?: boolean | string;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/** Timeline 适配器（shadcn kit）：竖向时间轴；节点圆点（color 覆盖）+ content + 可选 time */
+declare function Timeline({ items, pending, className, style }: TimelineProps): React.JSX.Element;
+
 interface ToggleProps {
     /** 按钮文本 */
     text?: string;
@@ -1890,6 +2682,8 @@ declare function ToggleGroup({ options, value, multiple, disabled, onChange, cla
 interface TooltipProps {
     /** 提示文案 */
     content?: string;
+    /** 浮层朝向（缺省 top；空间不足时自动翻转） */
+    side?: 'top' | 'right' | 'bottom' | 'left';
     /** 触发元素（DSL 子树，经 Renderer children 机制渲染） */
     children?: ReactNode;
     /** 通用：根节点 class（挂在提示浮层根节点，与内置样式合并） */
@@ -1899,9 +2693,154 @@ interface TooltipProps {
 }
 /**
  * Tooltip 适配器（shadcn kit）：children 为触发元素（span 包装接入
- * Base UI Trigger），悬浮显示 content 提示浮层。
+ * Base UI Trigger），悬浮显示 content 提示浮层；side 控制浮层朝向
+ * （如图标栏 hover 时 right）。
+ */
+declare function Tooltip({ content, side, children, className, style }: TooltipProps): React.JSX.Element;
+
+/** Tour 步骤定义：target 为 CSS selector（无匹配时卡片居中兜底） */
+interface TourStep {
+    target?: string;
+    title?: string;
+    content?: string;
+}
+interface TourProps {
+    /** 是否开启引导 */
+    open?: boolean;
+    /** 步骤列表 */
+    steps?: TourStep[];
+    /** 受控步骤序号（缺省内部从 0 开始） */
+    current?: number;
+    /** 步骤切换事件：下一步/上一步触发，参数为目标序号 */
+    onChange?: (index: number) => void;
+    /** 完成（末步）与关闭事件 */
+    onClose?: () => void;
+    /** 通用：步骤卡片 class（与内置样式合并） */
+    className?: string;
+    /** 通用：步骤卡片内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * Tour 适配器（shadcn kit）：分步引导——open 时渲染半透明遮罩
+ * （fixed inset-0）+ 当前步骤卡片（按 target 元素 getBoundingClientRect
+ * 定位在元素附近；选择器无匹配时居中兜底不抛错）。下一步触发 onChange，
+ * 完成与关闭触发 onClose。
+ */
+declare function Tour({ open, steps, current, onChange, onClose, className, style, }: TourProps): React.ReactPortal | null;
+
+/** Transfer 选项 */
+interface TransferOption {
+    label: string;
+    value: string | number;
+    disabled?: boolean;
+}
+interface TransferProps {
+    /** 字段名；在 Form 内声明 name 即自动成为表单项 */
+    name?: string;
+    /** 表单项标签 */
+    label?: string;
+    /** 校验规则 */
+    rules?: FieldRule[];
+    /** 全部选项（左列 = 未进目标侧的项，右列 = 目标侧的项） */
+    options?: TransferOption[];
+    /** 受控值（目标侧 value 数组）；Form 内作为字段初始值 */
+    value?: Array<string | number>;
+    /** 左右两列标题，缺省 ['列表 1', '列表 2'] */
+    titles?: [string, string];
+    disabled?: boolean;
+    /** 移动变化事件，传出目标侧 value 数组 */
+    onChange?: (value: Array<string | number>) => void;
+    /** 通用：根节点 class（Form 内为 form-item 容器，独立渲染时为控件根节点） */
+    className?: string;
+    /** 通用：根节点内联样式（同 className 的挂载规则） */
+    style?: CSSProperties;
+}
+/**
+ * Transfer 适配器（shadcn kit）：左右两列 checkbox 列表 + 中间左右
+ * 移动按钮；列头 checkbox 全选该列可用项。字段值与 onChange 均为
+ * 目标侧 value 数组（DSL 语义值）；Form 内声明 `name` 自动成为表单项。
+ */
+declare function Transfer({ name, label, rules, options, value, titles, disabled, onChange, className, style, }: TransferProps): React.JSX.Element;
+
+/** 树节点；`children` 为子节点数组 */
+interface TreeNodeData {
+    key: string;
+    title: string;
+    children?: TreeNodeData[];
+    disabled?: boolean;
+}
+interface TreeProps {
+    /** 树数据（可含表达式解析后的数组） */
+    treeData?: TreeNodeData[];
+    /** 非受控初始展开 keys */
+    defaultExpandedKeys?: string[];
+    /** 受控展开 keys */
+    expandedKeys?: string[];
+    /** 受控选中 keys */
+    selectedKeys?: string[];
+    /** 非受控初始选中 keys */
+    defaultSelectedKeys?: string[];
+    /** 节点前显示勾选框 */
+    checkable?: boolean;
+    /** 受控勾选 keys */
+    checkedKeys?: string[];
+    /** 非受控初始勾选 keys */
+    defaultCheckedKeys?: string[];
+    /** 整树禁用 */
+    disabled?: boolean;
+    /** 选中事件，传出选中 keys 数组 */
+    onSelect?: (keys: string[]) => void;
+    /** 展开事件，传出展开 keys 数组 */
+    onExpand?: (keys: string[]) => void;
+    /** 勾选事件，传出勾选 keys 数组 */
+    onCheck?: (keys: string[]) => void;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * Tree 适配器（shadcn kit）：自实现树（chevron 展开 + 缩进 + 可选勾选框）；
+ * expanded / selected / checked 均支持受控（对应 props 传入即受控）与非受控
+ * （default\*Keys 初始化内部状态）；勾选为独立勾选，父节点按子孙勾选状态显示半选。
+ */
+declare function Tree({ treeData, defaultExpandedKeys, expandedKeys, selectedKeys, defaultSelectedKeys, checkable, checkedKeys, defaultCheckedKeys, disabled, onSelect, onExpand, onCheck, className, style, }: TreeProps): React.JSX.Element;
+
+/** TreeSelect 树节点（嵌套） */
+interface TreeSelectOption {
+    label: string;
+    value: string | number;
+    children?: TreeSelectOption[];
+}
+interface TreeSelectProps {
+    /** 字段名；在 Form 内声明 name 即自动成为表单项 */
+    name?: string;
+    /** 表单项标签 */
+    label?: string;
+    /** 校验规则 */
+    rules?: FieldRule[];
+    /** 嵌套选项树 */
+    options?: TreeSelectOption[];
+    /** 受控值（选中节点 value）；Form 内作为字段初始值 */
+    value?: string | number;
+    placeholder?: string;
+    /** 弹层顶部显示过滤输入（按 label 过滤，命中节点的祖先保留展开） */
+    searchable?: boolean;
+    disabled?: boolean;
+    /** 选中变化事件，传出选中节点 value */
+    onChange?: (value: string | number) => void;
+    /** 通用：根节点 class（Form 内为 form-item 容器，独立渲染时为触发器） */
+    className?: string;
+    /** 通用：根节点内联样式（同 className 的挂载规则） */
+    style?: CSSProperties;
+}
+/**
+ * TreeSelect 适配器（shadcn kit）：触发器 + 受控 Popover 内联树
+ * （自实现，可展开/收起）；searchable 时顶部过滤输入按 label 过滤，
+ * 命中节点的祖先保留展开。单选，onChange 传出选中节点 value
+ * （DSL 语义值）；Form 内声明 `name` 自动成为表单项。
  */
-declare function Tooltip({ content, children, className, style }: TooltipProps): React.JSX.Element;
+declare function TreeSelect({ name, label, rules, options, value, placeholder, searchable, disabled, onChange, className, style, }: TreeSelectProps): React.JSX.Element;
 
 /** Typography 排版变体 */
 type TypographyVariant = NonNullable<VariantProps<typeof typographyVariants>['variant']>;
@@ -1918,6 +2857,1392 @@ interface TypographyProps {
 /** Typography 适配器（shadcn kit）：按 variant 渲染排版样式文本 */
 declare function Typography({ variant, text, className, style, }: TypographyProps): React.JSX.Element;
 
+/** 文件元数据（可序列化，DSL 语义值；不携带 File 对象本体） */
+interface UploadFileMeta {
+    name: string;
+    size: number;
+    type: string;
+}
+interface UploadProps {
+    /** 字段名；在 Form 内声明 name 即自动成为表单项 */
+    name?: string;
+    /** 表单项标签 */
+    label?: string;
+    /** 校验规则 */
+    rules?: FieldRule[];
+    /** 受控值（文件元数据数组）；Form 内作为字段初始值 */
+    value?: UploadFileMeta[];
+    /** 允许多选 */
+    multiple?: boolean;
+    /** 接受的文件类型（同原生 input accept：扩展名 / MIME / image\/* 等，逗号分隔） */
+    accept?: string;
+    /** 单文件大小上限（字节），超出不进列表 */
+    maxSize?: number;
+    /** 文件总数上限，超出不进列表 */
+    maxCount?: number;
+    /** 拖拽区形态（点击或拖入文件选择） */
+    drag?: boolean;
+    /** 选择区下方的辅助说明文案 */
+    tip?: string;
+    disabled?: boolean;
+    /** 文件列表变化事件，传出可序列化元数据数组 Array<{ name, size, type }> */
+    onChange?: (value: UploadFileMeta[]) => void;
+    /** 通用：根节点 class（Form 内为 form-item 容器，独立渲染时为控件根节点） */
+    className?: string;
+    /** 通用：根节点内联样式（同 className 的挂载规则） */
+    style?: CSSProperties;
+}
+/**
+ * Upload 适配器（shadcn kit）：纯 UI 组件，不发起任何网络请求。
+ * hidden file input + 文件列表（名称/大小/移除）；选择时按
+ * accept / maxSize / maxCount 校验，不合规文件不进列表。
+ * 字段值与 onChange 均为可序列化元数据数组 `Array<{ name, size, type }>`；
+ * Form 内声明 `name` 自动成为表单项。
+ */
+declare function Upload({ name, label, rules, value, multiple, accept, maxSize, maxCount, drag, tip, disabled, onChange, className, style, }: UploadProps): React.JSX.Element;
+
+interface VideoProps {
+    /** 视频地址 */
+    src?: string;
+    /** 封面图地址 */
+    poster?: string;
+    /** 是否显示原生控制条，默认 true */
+    controls?: boolean;
+    /** 自动播放（浏览器策略要求同时 muted 才生效） */
+    autoplay?: boolean;
+    /** 循环播放 */
+    loop?: boolean;
+    /** 静音 */
+    muted?: boolean;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/** Video 适配器（shadcn kit）：原生 video 包装，默认全宽圆角 + 控制条 */
+declare function Video({ src, poster, controls, autoplay, loop, muted, className, style, }: VideoProps): React.JSX.Element;
+
+interface WatermarkProps {
+    /** 水印文本：字符串或字符串数组（多行纵向排列） */
+    content?: string | string[];
+    /** 旋转角度，缺省 -22 */
+    rotate?: number;
+    /** 平铺间距 [水平, 垂直]（px），缺省 [100, 100] */
+    gap?: [number, number];
+    /** 文本透明度（0~1），缺省 0.15 */
+    opacity?: number;
+    /** 被覆盖内容（DSL 子树，经 Renderer children 机制渲染） */
+    children?: ReactNode;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * Watermark 适配器（shadcn kit）：容器相对定位包 children，水印为绝对
+ * 定位 inset-0、pointer-events-none 的 SVG data-uri 平铺背景层；
+ * 多行 content 纵向排列。
+ */
+declare function Watermark({ content, rotate, gap, opacity, children, className, style, }: WatermarkProps): React.JSX.Element;
+
+/** 智能体状态 */
+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;
+
+/**
+ * ArtifactPanel 产物模型与纯函数助手（自 @pactor-app/chat 的 artifact 模型
+ * 移植面板所需子集）：零 React，可纯 Node 测试。
+ */
+/** 产物：dsl kind 的 content 为 DslNode 普通对象，其余 kind 为字符串 */
+interface ChatPageArtifact {
+    id: string;
+    kind: 'markdown' | 'code' | 'text' | 'dsl';
+    title: string;
+    content: string | DslNode;
+    /** code kind 的语言标记（角标 / CodeBlock 高亮） */
+    language?: string;
+    /**
+     * 文件类型（扩展名，大小写 / 带点均可，如 'png' / '.MD'）：
+     * 图片类扩展名走内建图片预览（content 为 URL / data URL，
+     * svg 另支持原始标记）；自定义查看器（artifactViewers）按此键匹配。
+     * 缺省从 title 的扩展名推导
+     */
+    fileType?: string;
+    meta?: Record<string, unknown>;
+}
+/** 产物目录树节点（buildArtifactTree 产出） */
+interface ArtifactTreeNode {
+    /** 段名（目录名或产物标题） */
+    name: string;
+    /** 完整路径（目录为 id 前缀，文件为产物 id） */
+    path: string;
+    artifact?: ChatPageArtifact;
+    children: ArtifactTreeNode[];
+}
+/**
+ * 产物目录树（纯函数）：按 id 的 '/' 分段建目录层级——
+ * id 形如 `reports/q3/月报` 时产出 reports → q3 两级目录；
+ * 无 '/' 分段的产物平铺在根层。目录先于文件、各自按名称排序。
+ */
+declare function buildArtifactTree(artifacts: ChatPageArtifact[]): ArtifactTreeNode[];
+
+/**
+ * 自定义产物查看器：键为扩展名（小写不带点，如 'png' / 'md'）或 kind
+ * （'markdown' / 'code' / 'text' / 'dsl'）；扩展名键优先于 kind 键，
+ * 均优先于内建渲染器。查看器抛错不经守卫——宿主代码自负。
+ */
+type ArtifactViewer = (artifact: ChatPageArtifact) => ReactNode;
+type ArtifactViewers = Record<string, ArtifactViewer>;
+interface ArtifactPanelProps {
+    /** 当前产物；空时内容区展示 emptyText 空态 */
+    artifact?: ChatPageArtifact | null;
+    /** 会话内全部产物：提供后 header 左端展示目录列表切换钮，标题处展示产物切换下拉 */
+    artifacts?: ChatPageArtifact[];
+    /** 当前激活产物 id（下拉高亮；缺省取 artifact.id） */
+    activeArtifactId?: string;
+    /** 下拉 / 目录列表点击切换事件，传出产物 id（受控切换，面板不自改外部状态） */
+    onSelectArtifact?: (id: string) => void;
+    /** 标题兜底（无当前产物时展示，如「产物」） */
+    title?: string;
+    /** 无产物空态文案 */
+    emptyText?: string;
+    /** 关闭按钮事件 */
+    onClose?: () => void;
+    /** 下载事件；缺省内部走浏览器下载（downloadArtifact） */
+    onDownload?: (artifact: ChatPageArtifact) => void;
+    /** dsl 产物活预览的 Safe Registry；缺省时 dsl 内容渲染降级块 */
+    safeRegistry?: Registry<unknown>;
+    /** 注入 dsl 预览作用域 user */
+    user?: Record<string, unknown>;
+    /** 自定义产物查看器（扩展名 / kind → 预览），优先于内建渲染器 */
+    artifactViewers?: ArtifactViewers;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * ArtifactPanel 产物预览面板（shadcn kit；功能移植自 @pactor-app/chat
+ * 的 ArtifactPanel）：标题栏（目录列表切换钮 + 标题 / 产物切换下拉 +
+ * kind 角标 + 下载钮 + 关闭钮）+ 内容区。
+ *
+ * 内容按 artifact.kind 分发内建渲染器：markdown 安全渲染；code 经
+ * CodeBlock；text 预格式文本；dsl 经白名单守卫 + 活预览，被拦截 /
+ * 渲染失败一律降级为受控占位块，MUST NOT 抛错。图片类产物（扩展名
+ * 识别）走内建 <img> 预览。数据与行为全部经 props / events 进出，
+ * 面板不持有业务状态（列表 / 内容视图与目录折叠为内部展示状态）。
+ */
+declare function ArtifactPanel({ artifact, artifacts, activeArtifactId, onSelectArtifact, title, emptyText, onClose, onDownload, safeRegistry, user, artifactViewers, className, style, }: ArtifactPanelProps): 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;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * Attachment 适配器（shadcn kit）：会话附件 chip 组——
+ * 类别图标（复用 FilePreview 的推断）+ 名称 + 大小 + 状态
+ * （uploading 进度条 / error 重试）+ 可移除。
+ * 上传与存储由调用方负责，本组件只做呈现与事件上报。
+ */
+declare function Attachment({ items, onRemove, onRetry, 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;
+    /** 最小行数，缺省 3 */
+    rows?: number;
+    /** 附件列表（展示在输入区上方） */
+    attachments?: AttachmentItemData[];
+    /** 附件移除事件，传出 id / 下标 */
+    onRemoveAttachment?: (id: string | number) => void;
+    /** 附件重试事件，传出 id / 下标 */
+    onRetryAttachment?: (id: string | number) => 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;
+    /** 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）
+ * - footer 槽渲染在输入框内工具栏下方（分隔线相隔）
+ *
+ * 上传 / transport 由调用方负责，本组件只做呈现与事件上报。
+ */
+declare function Composer({ value, placeholder, disabled, loading, rows, attachments, onRemoveAttachment, onRetryAttachment, onAttachFiles, onChange, onSubmit, models, model, onModelChange, contexts, contextItems, onContextItemsChange, 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 */
+    icon?: string;
+    /** 起始任务卡片列表 */
+    prompts?: WelcomePromptItem[];
+    /** 起始任务选择事件，传出 value（Renderer 绑定 events.onSelect） */
+    onSelect?: (value: string) => void;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * Welcome 适配器（shadcn kit）：会话空状态——居中的图标 + 主副标题 +
+ * 起始任务卡片栅格（复用 Prompt）；点击卡片经 onSelect 传出 value。
+ */
+declare function Welcome({ title, description, icon, prompts, onSelect, className, style, }: WelcomeProps): React.JSX.Element;
+
+/** 图标栏 / 展开菜单共用的导航项 */
+interface ChatPageMenuItem {
+    key: string;
+    label: string;
+    /** 图标名（Icon 白名单） */
+    icon?: string;
+}
+/** 品牌区（展开菜单区标题 / 版本） */
+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;
+    /**
+     * 对话区头部右侧自定义操作（图标 + 提示）；提供时替换缺省的产物区
+     * 开关钮，点击经 onConversationHeaderAction 传出（产物区开关可经
+     * 受控 artifactOpen + onArtifactOpenChange 自行接线）
+     */
+    conversationHeaderAction?: {
+        icon?: string;
+        label?: string;
+        tooltip?: string;
+    };
+    /** 对话区头部右侧自定义操作点击事件 */
+    onConversationHeaderAction?: () => 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;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+/**
+ * ChatPage 对话工作页（shadcn kit）：四区整页布局——
+ * 最左图标栏（railItems 独立定义，仅图标，hover 右侧 Tooltip 展示
+ * 菜单名；不传则整栏隐藏）、展开菜单区（品牌 + 图标文字导航固定于顶部，
+ * 可折叠的会话列表与底部分组各占独立滚动区，内容短时下方留空）、中间对话区（头部 / Welcome /
+ * MessageList / Composer——Composer 支持模型选择 chip（models/model）、
+ * 行内提及（contexts：输入触发符在光标处弹菜单，选中替换为行内提及块，
+ * 退格整体删除；受控 contextItems）、附件
+ * 入口（onAttachFiles + 受控 attachments）与 composerFooter /
+ * composerBottom 槽位）、最右产物区（ArtifactPanel：内建产物预览、
+ * 目录树与下载，可显隐；展示时经 Resizable 拖拽调节与对话区的宽度）。
+ * 数据与行为全部经 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, 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, 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;
+    /** 角色说明（如「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, role, time, align, className, style }: SenderProps): 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;
+
+/** 图表点击事件的规范化载荷（DSL 事件 `${event}` 值） */
+interface ChartSelectPayload {
+    name?: unknown;
+    value?: unknown;
+    seriesName?: string;
+    dataIndex?: number;
+}
+interface EChartBaseProps {
+    /** echarts option（由 option-builders 纯函数生成） */
+    option: EChartsCoreOption;
+    /** 容器高度：数字按 px，缺省 256 */
+    height?: number | string;
+    /** 点击图表元素（柱子 / 折线点 / 扇区等）触发，映射 echarts click */
+    onSelect?: (payload: ChartSelectPayload) => void;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+    /** 根节点 data-slot 标识（组件名 kebab） */
+    slot: string;
+}
+/**
+ * 图表渲染基础件（chart/ 组件集共享，不注册为 DSL 组件）：
+ * 懒初始化 echarts 实例、notMerge 全量更新 option、
+ * ResizeObserver 自适应、卸载销毁；初始化失败（如无 canvas 环境）
+ * 降级为占位提示。SSR 下仅渲染空容器，effect 不执行。
+ */
+declare function EChartBase({ option, height, onSelect, className, style, slot, }: EChartBaseProps): React.JSX.Element;
+
+/**
+ * AreaChart 适配器（chart/ 组件集，echarts）：面积图，
+ * 强调趋势与累计规模，支持多系列 / 堆叠 / 填充不透明度。
+ */
+interface AreaChartProps {
+    /** 数据行数组 */
+    data?: Record<string, unknown>[];
+    /** 类目字段 */
+    xKey?: string;
+    /** 数值字段（多系列传多个） */
+    yKeys?: string[];
+    /** 堆叠面积 */
+    stacked?: boolean;
+    /** 填充不透明度（0-1），缺省 0.25 */
+    fillOpacity?: number;
+    /** 系列颜色覆盖（按序循环） */
+    colors?: string[];
+    /** 图表标题 */
+    title?: string;
+    /** 容器高度（px 或 CSS 长度），缺省 256 */
+    height?: number | string;
+    /** 点击数据点触发（DSL：events.onSelect → `${event}`） */
+    onSelect?: (payload: ChartSelectPayload) => void;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+declare function AreaChart({ data, xKey, yKeys, stacked, fillOpacity, colors, title, height, onSelect, className, style, }: AreaChartProps): React.JSX.Element;
+
+/**
+ * BarChart 适配器（chart/ 组件集，echarts）：横向条形图，
+ * 适用于长分类名称的横向比较（yKey 类目 + xKeys 数值）。
+ */
+interface BarChartProps {
+    /** 数据行数组 */
+    data?: Record<string, unknown>[];
+    /** 类目字段（纵轴） */
+    yKey?: string;
+    /** 数值字段（横轴，多系列传多个） */
+    xKeys?: string[];
+    /** 堆叠条 */
+    stacked?: boolean;
+    /** 系列颜色覆盖（按序循环） */
+    colors?: string[];
+    /** 图表标题 */
+    title?: string;
+    /** 容器高度（px 或 CSS 长度），缺省 256 */
+    height?: number | string;
+    /** 点击条块触发（DSL：events.onSelect → `${event}`） */
+    onSelect?: (payload: ChartSelectPayload) => void;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+declare function BarChart({ data, yKey, xKeys, stacked, colors, title, height, onSelect, className, style, }: BarChartProps): React.JSX.Element;
+
+/**
+ * BubbleChart 适配器（chart/ 组件集，echarts）：气泡图，
+ * 在两变量关系上叠加第三变量（sizeKey）映射气泡大小。
+ */
+interface BubbleChartProps {
+    /** 数据行数组 */
+    data?: Record<string, unknown>[];
+    /** X 数值字段，默认 x */
+    xKey?: string;
+    /** Y 数值字段，默认 y */
+    yKey?: string;
+    /** 气泡大小字段（第三变量），默认 size */
+    sizeKey?: string;
+    /** 分组字段（按值拆系列） */
+    seriesKey?: string;
+    /** 系列颜色覆盖（按序循环） */
+    colors?: string[];
+    /** 图表标题 */
+    title?: string;
+    /** 容器高度（px 或 CSS 长度），缺省 256 */
+    height?: number | string;
+    /** 点击气泡触发（DSL：events.onSelect → `${event}`） */
+    onSelect?: (payload: ChartSelectPayload) => void;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+declare function BubbleChart({ data, xKey, yKey, sizeKey, seriesKey, colors, title, height, onSelect, className, style, }: BubbleChartProps): React.JSX.Element;
+
+/**
+ * ColumnChart 适配器（chart/ 组件集，echarts）：垂直柱状图，
+ * 支持多系列 / 堆叠，适用于离散类目比较。
+ */
+interface ColumnChartProps {
+    /** 数据行数组 */
+    data?: Record<string, unknown>[];
+    /** 类目字段 */
+    xKey?: string;
+    /** 数值字段（多系列传多个） */
+    yKeys?: string[];
+    /** 堆叠柱 */
+    stacked?: boolean;
+    /** 系列颜色覆盖（按序循环） */
+    colors?: string[];
+    /** 图表标题 */
+    title?: string;
+    /** 容器高度（px 或 CSS 长度），缺省 256 */
+    height?: number | string;
+    /** 点击柱子触发（DSL：events.onSelect → `${event}`） */
+    onSelect?: (payload: ChartSelectPayload) => void;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+declare function ColumnChart({ data, xKey, yKeys, stacked, colors, title, height, onSelect, className, style, }: ColumnChartProps): React.JSX.Element;
+
+/**
+ * echarts option 构建纯函数：每个图表组件把受限 props 翻译为 option，
+ * 纯函数便于单测（jsdom 无 canvas，不断言 echarts 实例行为）。
+ * 颜色一律来自 ChartTheme 令牌解析结果或用户显式覆盖。
+ */
+
+interface ComposedSeriesItem {
+    /** 图型：折线 / 柱 / 面积 */
+    type: 'line' | 'bar' | 'area';
+    /** 数据字段 */
+    dataKey: string;
+    /** 0 主数值轴 / 1 副数值轴（双轴） */
+    yAxisIndex?: 0 | 1;
+    /** 系列显示名，缺省取 dataKey */
+    name?: string;
+}
+
+/**
+ * ComposedChart 适配器（chart/ 组件集，echarts）：组合图，
+ * 声明式 series 描述混合折线/柱/面积，支持双数值轴。
+ */
+interface ComposedChartProps {
+    /** 数据行数组 */
+    data?: Record<string, unknown>[];
+    /** 类目字段 */
+    xKey?: string;
+    /** 系列描述数组（图型 + 数据字段，可指定副轴） */
+    series?: ComposedSeriesItem[];
+    /** 系列颜色覆盖（按序循环） */
+    colors?: string[];
+    /** 图表标题 */
+    title?: string;
+    /** 容器高度（px 或 CSS 长度），缺省 256 */
+    height?: number | string;
+    /** 点击图元触发（DSL：events.onSelect → `${event}`） */
+    onSelect?: (payload: ChartSelectPayload) => void;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+declare function ComposedChart({ data, xKey, series, colors, title, height, onSelect, className, style, }: ComposedChartProps): React.JSX.Element;
+
+/**
+ * DonutChart 适配器（chart/ 组件集，echarts）：环形图，
+ * 中心可展示关键指标（centerLabel / centerValue）。
+ */
+interface DonutChartProps {
+    /** 切片数据行数组 */
+    data?: Record<string, unknown>[];
+    /** 切片名称字段，默认 name */
+    nameKey?: string;
+    /** 切片数值字段，默认 value */
+    valueKey?: string;
+    /** 内半径（px 或百分比串），默认 '48%' */
+    innerRadius?: number | string;
+    /** 外半径，默认 '72%' */
+    outerRadius?: number | string;
+    /** 中心指标名（如 "总计"） */
+    centerLabel?: string;
+    /** 中心指标值 */
+    centerValue?: number | string;
+    /** 是否显示切片标签 */
+    showLabel?: boolean;
+    /** 系列颜色覆盖（按序循环） */
+    colors?: string[];
+    /** 图表标题 */
+    title?: string;
+    /** 容器高度（px 或 CSS 长度），缺省 256 */
+    height?: number | string;
+    /** 点击切片触发（DSL：events.onSelect → `${event}`） */
+    onSelect?: (payload: ChartSelectPayload) => void;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+declare function DonutChart({ data, nameKey, valueKey, innerRadius, outerRadius, centerLabel, centerValue, showLabel, colors, title, height, onSelect, className, style, }: DonutChartProps): React.JSX.Element;
+
+/**
+ * FunnelChart 适配器（chart/ 组件集，echarts）：漏斗图，
+ * 展示流程阶段转化，支持降序 / 升序 / 输入顺序排列。
+ */
+interface FunnelChartProps {
+    /** 阶段数据行数组 */
+    data?: Record<string, unknown>[];
+    /** 阶段名字段，默认 name */
+    nameKey?: string;
+    /** 阶段数值字段，默认 value */
+    valueKey?: string;
+    /** 排序方式：降序（大在上，缺省）/ 升序 / 输入顺序 */
+    sort?: 'descending' | 'ascending' | 'none';
+    /** 系列颜色覆盖（按序循环） */
+    colors?: string[];
+    /** 图表标题 */
+    title?: string;
+    /** 容器高度（px 或 CSS 长度），缺省 256 */
+    height?: number | string;
+    /** 点击阶段触发（DSL：events.onSelect → `${event}`） */
+    onSelect?: (payload: ChartSelectPayload) => void;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+declare function FunnelChart({ data, nameKey, valueKey, sort, colors, title, height, onSelect, className, style, }: FunnelChartProps): React.JSX.Element;
+
+/**
+ * GaugeChart 适配器（chart/ 组件集，echarts）：仪表盘，
+ * 单指标区间状态展示，阈值分段配色（语义色令牌）。
+ */
+interface GaugeChartProps {
+    /** 当前值 */
+    value?: number;
+    /** 量程下限，默认 0 */
+    min?: number;
+    /** 量程上限，默认 100 */
+    max?: number;
+    /** 阈值区间：按 value 上限分段配色（颜色缺省取主题色板首色），末段兜底到 max */
+    thresholds?: {
+        value: number;
+        color?: string;
+    }[];
+    /** 数值单位后缀（如 %） */
+    unit?: string;
+    /** 图表标题 */
+    title?: string;
+    /** 容器高度（px 或 CSS 长度），缺省 256 */
+    height?: number | string;
+    /** 点击触发（DSL：events.onSelect → `${event}`） */
+    onSelect?: (payload: ChartSelectPayload) => void;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+declare function GaugeChart({ value, min, max, thresholds, unit, title, height, onSelect, className, style, }: GaugeChartProps): React.JSX.Element;
+
+/**
+ * Heatmap 适配器（chart/ 组件集，echarts）：热力图，
+ * x/y 二维类目密度展示，visualMap 色阶取主题令牌。
+ */
+interface HeatmapProps {
+    /** 数据行数组（每行 x / y / value） */
+    data?: Record<string, unknown>[];
+    /** 横轴类目字段，默认 x */
+    xKey?: string;
+    /** 纵轴类目字段，默认 y */
+    yKey?: string;
+    /** 数值字段，默认 value */
+    valueKey?: string;
+    /** 图表标题 */
+    title?: string;
+    /** 容器高度（px 或 CSS 长度），缺省 256 */
+    height?: number | string;
+    /** 点击单元格触发（DSL：events.onSelect → `${event}`） */
+    onSelect?: (payload: ChartSelectPayload) => void;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+declare function Heatmap({ data, xKey, yKey, valueKey, title, height, onSelect, className, style, }: HeatmapProps): React.JSX.Element;
+
+/**
+ * LineChart 适配器（chart/ 组件集，echarts）：连续趋势折线，
+ * 支持多系列 / 平滑 / 面积填充 / 堆叠。
+ */
+interface LineChartProps {
+    /** 数据行数组（通常为 `${data.xxx}` 表达式解析结果） */
+    data?: Record<string, unknown>[];
+    /** 类目字段 */
+    xKey?: string;
+    /** 数值字段（多系列传多个） */
+    yKeys?: string[];
+    /** 平滑曲线 */
+    smooth?: boolean;
+    /** 折线下方面积填充 */
+    showArea?: boolean;
+    /** 堆叠面积/折线 */
+    stacked?: boolean;
+    /** 系列颜色覆盖（按序循环） */
+    colors?: string[];
+    /** 图表标题 */
+    title?: string;
+    /** 容器高度（px 或 CSS 长度），缺省 256 */
+    height?: number | string;
+    /** 点击数据点触发（DSL：events.onSelect → `${event}`） */
+    onSelect?: (payload: ChartSelectPayload) => void;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+declare function LineChart({ data, xKey, yKeys, smooth, showArea, stacked, colors, title, height, onSelect, className, style, }: LineChartProps): React.JSX.Element;
+
+/**
+ * MapChart 适配器（chart/ 组件集，echarts）：地图，
+ * 展示地理分布与区域比较（世界地图 / 国家地图 / 其他区域地图）。
+ * 地图数据三种供给方式（优先级从高到低）：
+ * - `geoJson`：内联 GeoJSON 对象，渲染期同步注册（幂等，StrictMode 安全）；
+ * - `geoJsonUrl`：GeoJSON 资源地址，组件 fetch 后注册（按 mapName 缓存，
+ *   同一地图多处复用只请求一次）；
+ * - 两者都不传时要求 `mapName` 已注册（如应用启动时统一 registerMap）。
+ * 未注册渲染 Empty 占位并 console.warn，不抛错。
+ */
+interface MapChartProps {
+    /** echarts 地图名 */
+    mapName?: string;
+    /** 区域数据行数组（区域名 + 数值） */
+    data?: Record<string, unknown>[];
+    /** 区域名字段，默认 name */
+    nameKey?: string;
+    /** 区域数值字段，默认 value */
+    valueKey?: string;
+    /** GeoJSON 地图数据（传入即注册到 echarts，优先于 geoJsonUrl） */
+    geoJson?: Record<string, unknown>;
+    /** GeoJSON 资源地址（组件 fetch 后注册到 echarts） */
+    geoJsonUrl?: string;
+    /** 图表标题 */
+    title?: string;
+    /** 容器高度（px 或 CSS 长度），缺省 256 */
+    height?: number | string;
+    /** 点击区域触发（DSL：events.onSelect → `${event}`） */
+    onSelect?: (payload: ChartSelectPayload) => void;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+declare function MapChart({ mapName, data, nameKey, valueKey, geoJson, geoJsonUrl, title, height, onSelect, className, style, }: MapChartProps): React.JSX.Element;
+
+/**
+ * MetricCard 适配器（chart/ 组件集）：单指标卡——标题 + 大数值 +
+ * 趋势箭头（语义色令牌）。数据可视化看板的顶层概览单元。
+ */
+interface MetricCardProps {
+    /** 指标标题 */
+    title?: string;
+    /** 指标数值（通常为表达式解析后的数字） */
+    value?: number | string;
+    /** 前缀（如 ¥） */
+    prefix?: string;
+    /** 后缀（如单位） */
+    suffix?: string;
+    /** 趋势百分比：正数升（success），负数降（destructive），0 / 缺省不展示 */
+    trend?: number;
+    /** 趋势对比说明（如 "较上月"） */
+    trendLabel?: string;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+declare function MetricCard({ title, value, prefix, suffix, trend, trendLabel, className, style, }: MetricCardProps): React.JSX.Element;
+
+/**
+ * PieChart 适配器（chart/ 组件集，echarts）：饼图，
+ * 适用于少量类别的构成展示。
+ */
+interface PieChartProps {
+    /** 切片数据行数组 */
+    data?: Record<string, unknown>[];
+    /** 切片名称字段，默认 name */
+    nameKey?: string;
+    /** 切片数值字段，默认 value */
+    valueKey?: string;
+    /** 是否显示切片标签 */
+    showLabel?: boolean;
+    /** 系列颜色覆盖（按序循环） */
+    colors?: string[];
+    /** 图表标题 */
+    title?: string;
+    /** 容器高度（px 或 CSS 长度），缺省 256 */
+    height?: number | string;
+    /** 点击切片触发（DSL：events.onSelect → `${event}`） */
+    onSelect?: (payload: ChartSelectPayload) => void;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+declare function PieChart({ data, nameKey, valueKey, showLabel, colors, title, height, onSelect, className, style, }: PieChartProps): React.JSX.Element;
+
+/**
+ * RadarChart 适配器（chart/ 组件集，echarts）：雷达图，
+ * 每行一个维度（indicatorKey），每列一个对比系列（yKeys）。
+ */
+interface RadarChartProps {
+    /** 数据行数组（每行一个雷达维度） */
+    data?: Record<string, unknown>[];
+    /** 维度名字段，默认 indicator */
+    indicatorKey?: string;
+    /** 系列字段（多列多维对比），默认 ['value'] */
+    yKeys?: string[];
+    /** 系列颜色覆盖（按序循环） */
+    colors?: string[];
+    /** 图表标题 */
+    title?: string;
+    /** 容器高度（px 或 CSS 长度），缺省 256 */
+    height?: number | string;
+    /** 点击触发（DSL：events.onSelect → `${event}`） */
+    onSelect?: (payload: ChartSelectPayload) => void;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+declare function RadarChart({ data, indicatorKey, yKeys, colors, title, height, onSelect, className, style, }: RadarChartProps): React.JSX.Element;
+
+/**
+ * SankeyChart 适配器（chart/ 组件集，echarts）：桑基图，
+ * 展示节点之间的流向与规模。
+ */
+interface SankeyChartProps {
+    /** 节点数组 */
+    nodes?: {
+        name: string;
+    }[];
+    /** 流向边：source → target 及数值 */
+    links?: {
+        source: string;
+        target: string;
+        value: number;
+    }[];
+    /** 图表标题 */
+    title?: string;
+    /** 容器高度（px 或 CSS 长度），缺省 256 */
+    height?: number | string;
+    /** 点击节点或边触发（DSL：events.onSelect → `${event}`） */
+    onSelect?: (payload: ChartSelectPayload) => void;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+declare function SankeyChart({ nodes, links, title, height, onSelect, className, style, }: SankeyChartProps): React.JSX.Element;
+
+/**
+ * ScatterChart 适配器（chart/ 组件集，echarts）：散点图，
+ * 展示两变量关系与分布，seriesKey 可按值拆分子系列。
+ */
+interface ScatterChartProps {
+    /** 数据行数组 */
+    data?: Record<string, unknown>[];
+    /** X 数值字段，默认 x */
+    xKey?: string;
+    /** Y 数值字段，默认 y */
+    yKey?: string;
+    /** 分组字段（按值拆系列，配图例） */
+    seriesKey?: string;
+    /** 系列颜色覆盖（按序循环） */
+    colors?: string[];
+    /** 图表标题 */
+    title?: string;
+    /** 容器高度（px 或 CSS 长度），缺省 256 */
+    height?: number | string;
+    /** 点击数据点触发（DSL：events.onSelect → `${event}`） */
+    onSelect?: (payload: ChartSelectPayload) => void;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+declare function ScatterChart({ data, xKey, yKey, seriesKey, colors, title, height, onSelect, className, style, }: ScatterChartProps): React.JSX.Element;
+
+/**
+ * TreeChart 适配器（chart/ 组件集，echarts）：树图，
+ * 节点-连线层级树（对齐 echarts 2.2.4 tree 系列形态）：
+ * 根节点定位布局，曲线/折线连边，叶子节点着色，支持展开方向与
+ * 初始展开深度配置。
+ */
+interface TreeChartProps {
+    /** 层级数据：通常为单根 [{ name, children: [...] }] */
+    data?: Record<string, unknown>[];
+    /** 图表标题 */
+    title?: string;
+    /** 展开方向：vertical 根在上向下（缺省）/ horizontal 根在左向右 */
+    orient?: 'vertical' | 'horizontal';
+    /** 连线形状：曲线（缺省）/ 折线 */
+    edgeShape?: 'curve' | 'polyline';
+    /** 初始展开的层级深度，缺省 2；-1 表示全部展开 */
+    initialTreeDepth?: number;
+    /** 容器高度（px 或 CSS 长度），缺省 256 */
+    height?: number | string;
+    /** 点击节点触发（DSL：events.onSelect → `${event}`） */
+    onSelect?: (payload: ChartSelectPayload) => void;
+    /** 通用：根节点 class（与内置样式合并） */
+    className?: string;
+    /** 通用：根节点内联样式 */
+    style?: CSSProperties;
+}
+declare function TreeChart({ data, title, orient, edgeShape, initialTreeDepth, height, onSelect, className, style, }: TreeChartProps): React.JSX.Element;
+
 /**
  * 内置组件表：DSL 类型名 → 组件适配器。
  * 类型名集合即 spec: builtin-components 的内置组件清单；
@@ -1997,8 +4322,82 @@ declare const builtinComponents: {
     readonly Typography: typeof Typography;
     readonly Sidebar: typeof Sidebar;
     readonly DataTable: typeof DataTable;
-    readonly Chart: typeof Chart;
     readonly Icon: typeof Icon;
+    readonly Rate: typeof Rate;
+    readonly TimePicker: typeof TimePicker;
+    readonly ColorPicker: typeof ColorPicker;
+    readonly Upload: typeof Upload;
+    readonly TreeSelect: typeof TreeSelect;
+    readonly Cascader: typeof Cascader;
+    readonly Transfer: typeof Transfer;
+    readonly Mentions: typeof Mentions;
+    readonly List: typeof List;
+    readonly Tree: typeof Tree;
+    readonly Descriptions: typeof Descriptions;
+    readonly Timeline: typeof Timeline;
+    readonly Image: typeof Image;
+    readonly QRCode: typeof QRCode;
+    readonly Segmented: typeof Segmented;
+    readonly Message: typeof Message;
+    readonly Notification: typeof Notification;
+    readonly Popconfirm: typeof Popconfirm;
+    readonly Result: typeof Result;
+    readonly LoadingOverlay: typeof LoadingOverlay;
+    readonly Watermark: typeof Watermark;
+    readonly Tour: typeof Tour;
+    readonly Tag: typeof Tag;
+    readonly Status: typeof Status;
+    readonly Space: typeof Space;
+    readonly Container: typeof Container;
+    readonly Steps: typeof Steps;
+    readonly Anchor: typeof Anchor;
+    readonly BackTop: typeof BackTop;
+    readonly Affix: typeof Affix;
+    readonly ImageViewer: typeof ImageViewer;
+    readonly Gallery: typeof Gallery;
+    readonly Video: typeof Video;
+    readonly Audio: typeof Audio;
+    readonly FilePreview: typeof FilePreview;
+    readonly DocumentPreview: typeof DocumentPreview;
+    readonly RichText: typeof RichText;
+    readonly Markdown: typeof MarkdownDslComponent;
+    readonly CodeBlock: typeof CodeBlock;
+    readonly DiffViewer: typeof DiffViewer;
+    readonly JSONViewer: typeof JSONViewer;
+    readonly Bubble: typeof Bubble;
+    readonly Sender: typeof Sender;
+    readonly Thinking: typeof Thinking;
+    readonly AgentStatus: typeof AgentStatus;
+    readonly StreamingText: typeof StreamingText;
+    readonly Suggestion: typeof Suggestion;
+    readonly Prompt: typeof Prompt;
+    readonly Welcome: typeof Welcome;
+    readonly Citation: typeof Citation;
+    readonly Attachment: typeof Attachment;
+    readonly ToolCall: typeof ToolCall;
+    readonly ChatMessage: typeof ChatMessage;
+    readonly ChatPage: typeof ChatPage;
+    readonly ArtifactPanel: typeof ArtifactPanel;
+    readonly MessageList: typeof MessageList;
+    readonly Composer: typeof Composer;
+    readonly ConversationList: typeof ConversationList;
+    readonly MetricCard: typeof MetricCard;
+    readonly LineChart: typeof LineChart;
+    readonly ColumnChart: typeof ColumnChart;
+    readonly BarChart: typeof BarChart;
+    readonly AreaChart: typeof AreaChart;
+    readonly PieChart: typeof PieChart;
+    readonly DonutChart: typeof DonutChart;
+    readonly ScatterChart: typeof ScatterChart;
+    readonly BubbleChart: typeof BubbleChart;
+    readonly RadarChart: typeof RadarChart;
+    readonly FunnelChart: typeof FunnelChart;
+    readonly GaugeChart: typeof GaugeChart;
+    readonly Heatmap: typeof Heatmap;
+    readonly TreeChart: typeof TreeChart;
+    readonly SankeyChart: typeof SankeyChart;
+    readonly MapChart: typeof MapChart;
+    readonly ComposedChart: typeof ComposedChart;
 };
 /** 把全部 V1 内置组件按 DSL 类型名注册到给定 ComponentRegistry */
 declare function registerBuiltinComponents(registry: ComponentRegistry): void;
@@ -2045,4 +4444,4 @@ interface FormContextValue {
 /** 在字段组件内探测 Form 上下文；不在 Form 内时返回 null */
 declare function useFormContext(): FormContextValue | null;
 
-export { Accordion, type AccordionItemData, type AccordionProps, Alert, AlertDialog, type AlertDialogProps, type AlertProps, type AlertVariant, AspectRatio, type AspectRatioProps, Avatar, type AvatarProps, Badge, type BadgeProps, type BadgeVariant, Breadcrumb, type BreadcrumbItemData, type BreadcrumbProps, Button, ButtonGroup, type ButtonGroupProps, type ButtonProps, type ButtonSize, type ButtonVariant, Calendar, type CalendarProps, Card, type CardProps, Carousel, type CarouselImage, type CarouselItemData, type CarouselProps, Chart, type ChartProps, type ChartType, ChatInput, type ChatInputProps, Checkbox, type CheckboxProps, Collapsible, type CollapsibleProps, Combobox, type ComboboxOption, type ComboboxProps, Command, type CommandGroupData, type CommandItemData, type CommandProps, Content, type ContentProps, ContextMenu, type ContextMenuItemData, type ContextMenuProps, DataTable, type DataTableColumn, type DataTablePagination, type DataTableProps, type DataTableSort, type DataTableSortOrder, DatePicker, type DatePickerPreset, type DatePickerPresetKey, type DatePickerProps, type DatePickerRangeProps, type DatePickerSingleProps, type DateRangeValue, Dialog, type DialogProps, Drawer, type DrawerPlacement, type DrawerProps, DropdownMenu, type DropdownMenuItemData, type DropdownMenuProps, Empty, type EmptyProps, Field, type FieldProps, type FieldRule, Flex, type FlexProps, Footer, type FooterProps, Form, type FormContextValue, type FormProps, Grid, type GridProps, Header, type HeaderBrandPosition, type HeaderDropdown, type HeaderDropdownItem, type HeaderLocale, type HeaderMenuItem, type HeaderProps, type HeaderTheme, type HeaderUser, type HeaderUserItem, HoverCard, type HoverCardProps, ICONS, Icon, type IconProps, type IconSize, Input, InputGroup, type InputGroupProps, InputOTP, type InputOTPProps, type InputProps, Item, type ItemProps, Kbd, type KbdProps, Label, type LabelProps, Layout, type LayoutProps, Link, type LinkProps, Menu, type MenuItem, type MenuProps, Menubar, type MenubarLeafItem, type MenubarMenuData, type MenubarProps, NavigationMenu, type NavigationMenuChildItem, type NavigationMenuItemData, type NavigationMenuProps, NumberInput, type NumberInputProps, Page, type PageProps, Pagination, type PaginationProps, Popover, type PopoverProps, Progress, type ProgressProps, RadioGroup, type RadioGroupOption, type RadioGroupProps, RailTooltip, Resizable, type ResizablePanelData, type ResizableProps, ScrollArea, type ScrollAreaProps, Select, type SelectOption, type SelectProps, Separator, type SeparatorProps, Sheet, type SheetProps, type SheetSide, Sidebar, type SidebarBrand, type SidebarNavItem, type SidebarProps, Sider, type SiderProps, Skeleton, type SkeletonProps, type SkeletonShape, Slider, type SliderProps, Sonner, type SonnerProps, Spinner, type SpinnerProps, type SpinnerSize, Statistic, type StatisticProps, Switch, type SwitchProps, type TabItem, Table, type TableColumn, type TablePagination, type TablePaginationInfo, type TableProps, Tabs, type TabsProps, Text, type TextProps, type TextType, Textarea, type TextareaProps, Toggle, ToggleGroup, type ToggleGroupOption, type ToggleGroupProps, type ToggleProps, Tooltip, type TooltipProps, Typography, type TypographyProps, type TypographyVariant, builtinComponents, createComponentRegistry, normalizeIconName, registerBuiltinComponents, useFormContext, useSidebarDrawer };
+export { Accordion, type AccordionItemData, type AccordionProps, Affix, type AffixProps, AgentStatus, type AgentStatusProps, type AgentStatusType, Alert, AlertDialog, type AlertDialogProps, type AlertProps, type AlertVariant, Anchor, type AnchorItemData, type AnchorProps, AreaChart, type AreaChartProps, ArtifactPanel, type ArtifactPanelProps, type ArtifactTreeNode, type ArtifactViewer, type ArtifactViewers, AspectRatio, type AspectRatioProps, Attachment, type AttachmentItemData, type AttachmentProps, Audio, type AudioProps, Avatar, type AvatarProps, BackTop, type BackTopProps, Badge, type BadgeProps, type BadgeVariant, BarChart, type BarChartProps, Breadcrumb, type BreadcrumbItemData, type BreadcrumbProps, Bubble, BubbleChart, type BubbleChartProps, type BubbleProps, type BubbleVariant, Button, ButtonGroup, type ButtonGroupProps, type ButtonProps, type ButtonSize, type ButtonVariant, Calendar, type CalendarProps, Card, type CardProps, Carousel, type CarouselImage, type CarouselItemData, type CarouselProps, Cascader, type CascaderOption, type CascaderProps, type ChartSelectPayload, ChatInput, type ChatInputProps, ChatMessage, type ChatMessageActionItem, type ChatMessageAgent, type ChatMessagePart, type ChatMessageProps, type ChatMessageStatus, ChatPage, type ChatPageArtifact, type ChatPageBrand, type ChatPageMenuItem, type ChatPageProps, Checkbox, type CheckboxProps, Citation, type CitationItem, type CitationProps, CodeBlock, type CodeBlockProps, Collapsible, type CollapsibleProps, ColorPicker, type ColorPickerProps, ColumnChart, type ColumnChartProps, Combobox, type ComboboxOption, type ComboboxProps, Command, type CommandGroupData, type CommandItemData, type CommandProps, ComposedChart, type ComposedChartProps, type ComposedSeriesItem, Composer, type ComposerContextItem, type ComposerContextSource, type ComposerModelOption, type ComposerProps, Container, type ContainerProps, type ContainerSize, Content, type ContentProps, ContextMenu, type ContextMenuItemData, type ContextMenuProps, type ConversationItemData, ConversationList, type ConversationListProps, DataTable, type DataTableColumn, type DataTablePagination, type DataTableProps, type DataTableSort, type DataTableSortOrder, DatePicker, type DatePickerPreset, type DatePickerPresetKey, type DatePickerProps, type DatePickerRangeProps, type DatePickerSingleProps, type DateRangeValue, Descriptions, type DescriptionsItemData, type DescriptionsProps, Dialog, type DialogProps, DiffViewer, type DiffViewerProps, type DocumentPageData, DocumentPreview, type DocumentPreviewProps, DonutChart, type DonutChartProps, Drawer, type DrawerPlacement, type DrawerProps, DropdownMenu, type DropdownMenuItemData, type DropdownMenuProps, EChartBase, type EChartBaseProps, Empty, type EmptyProps, Field, type FieldProps, type FieldRule, FilePreview, type FilePreviewKind, type FilePreviewProps, Flex, type FlexProps, Footer, type FooterProps, Form, type FormContextValue, type FormProps, FunnelChart, type FunnelChartProps, Gallery, type GalleryItemData, type GalleryProps, GaugeChart, type GaugeChartProps, Grid, type GridProps, Header, type HeaderBrandPosition, type HeaderDropdown, type HeaderDropdownItem, type HeaderLocale, type HeaderMenuItem, type HeaderProps, type HeaderTheme, type HeaderUser, type HeaderUserItem, Heatmap, type HeatmapProps, HoverCard, type HoverCardProps, ICONS, Icon, type IconProps, type IconSize, Image, ImageLightbox, type ImageLightboxProps, type ImageProps, ImageViewer, type ImageViewerProps, Input, InputGroup, type InputGroupProps, InputOTP, type InputOTPProps, type InputProps, Item, type ItemProps, JSONViewer, type JSONViewerProps, Kbd, type KbdProps, Label, type LabelProps, Layout, type LayoutProps, LineChart, type LineChartProps, Link, type LinkProps, List, type ListItemData, type ListProps, LoadingOverlay, type LoadingOverlayProps, MapChart, type MapChartProps, type MentionOption, Mentions, type MentionsProps, Menu, type MenuItem, type MenuProps, Menubar, type MenubarLeafItem, type MenubarMenuData, type MenubarProps, Message, MessageList, type MessageListItem, type MessageListProps, type MessageProps, MetricCard, type MetricCardProps, NavigationMenu, type NavigationMenuChildItem, type NavigationMenuItemData, type NavigationMenuProps, Notification, type NotificationProps, NumberInput, type NumberInputProps, Page, type PageProps, Pagination, type PaginationProps, PieChart, type PieChartProps, Popconfirm, type PopconfirmProps, Popover, type PopoverProps, Progress, type ProgressProps, Prompt, type PromptProps, QRCode, type QRCodeProps, RadarChart, type RadarChartProps, RadioGroup, type RadioGroupOption, type RadioGroupProps, RailTooltip, Rate, type RateProps, Resizable, type ResizablePanelData, type ResizableProps, Result, type ResultProps, type ResultStatus, RichText, type RichTextProps, SankeyChart, type SankeyChartProps, ScatterChart, type ScatterChartProps, ScrollArea, type ScrollAreaProps, Segmented, type SegmentedOption, type SegmentedProps, Select, type SelectOption, type SelectProps, Sender, type SenderProps, Separator, type SeparatorProps, Sheet, type SheetProps, type SheetSide, Sidebar, type SidebarBrand, type SidebarNavItem, type SidebarProps, Sider, type SiderProps, Skeleton, type SkeletonProps, type SkeletonShape, Slider, type SliderProps, Sonner, type SonnerProps, Space, type SpaceProps, Spinner, type SpinnerProps, type SpinnerSize, Statistic, type StatisticProps, Status, type StatusProps, type StatusType, type StepItemData, type StepStatus, Steps, type StepsProps, StreamingText, type StreamingTextProps, Suggestion, type SuggestionItem, type SuggestionProps, Switch, type SwitchProps, type TabItem, Table, type TableColumn, type TablePagination, type TablePaginationInfo, type TableProps, Tabs, type TabsProps, Tag, type TagColor, type TagProps, Text, type TextProps, type TextType, Textarea, type TextareaProps, Thinking, type ThinkingProps, type ThinkingStatus, TimePicker, type TimePickerProps, Timeline, type TimelineItemData, type TimelineProps, Toggle, ToggleGroup, type ToggleGroupOption, type ToggleGroupProps, type ToggleProps, ToolCall, type ToolCallProps, type ToolCallStatus, Tooltip, type TooltipProps, Tour, type TourProps, type TourStep, Transfer, type TransferOption, type TransferProps, Tree, TreeChart, type TreeChartProps, type TreeNodeData, type TreeProps, TreeSelect, type TreeSelectOption, type TreeSelectProps, Typography, type TypographyProps, type TypographyVariant, Upload, type UploadFileMeta, type UploadProps, Video, type VideoProps, Watermark, type WatermarkProps, Welcome, type WelcomePromptItem, type WelcomeProps, buildArtifactTree, builtinComponents, createComponentRegistry, diffLines, inferKind, normalizeIconName, registerBuiltinComponents, useFormContext, useSidebarDrawer };