@pactor-app/ui 1.42.0 → 1.44.0

package/dist/components/index.d.cts

@@ -7,7 +7,6 @@ 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';
@@ -286,7 +285,7 @@ declare function ButtonGroup({ className, style, children }: ButtonGroupProps):
 
 /**
  * 表单控件统一尺寸令牌：small / middle / large，默认 middle（= 现行 h-9 尺寸）。
- * 所有盒式表单控件（Input / Select / DatePicker / SearchableSelect / 业务组件
+ * 所有盒式表单控件（Input / Select / DatePicker / 业务组件
  * 内嵌控件等）共用同一映射，保证同一 size 下高度、内边距、字号一致。
  *
  * 使用方式：把控件尺寸类合并到控件 className 末位（cn/tailwind-merge 会覆盖
@@ -3963,6 +3962,13 @@ interface ChatPageProps {
     defaultArtifactOpen?: boolean;
     /** 产物区开关变化事件，传出 boolean */
     onArtifactOpenChange?: (open: boolean) => void;
+    /**
+     * 主体内容槽（React 元素或 DslNode）：提供时整体替换右侧主区域——
+     * 对话 header、Welcome / MessageList、Composer、对话图标栏与右侧
+     * 产物 / 附加分栏均不渲染，由调用方自带完整主体（含 header）；
+     * 最左图标栏与展开菜单区不受影响
+     */
+    content?: DslNode | ReactNode;
     /** 通用：根节点 class（与内置样式合并） */
     className?: string;
     /** 通用：根节点内联样式 */
@@ -3982,11 +3988,13 @@ interface ChatPageProps {
  * 展示附加内容——popover 悬浮弹框或 panel 右侧分栏，与产物区互斥）、
  * 最右产物区（ArtifactPanel：内建产物预览、
  * 目录树与下载，可显隐；展示时经 Resizable 拖拽调节与对话区的宽度）。
+ * content 槽（React 元素或 DslNode）提供时整体替换右侧主区域（含对话
+ * header），由调用方自带完整主体内容；左侧图标栏与展开菜单区保留。
  * 数据与行为全部经 props / events 进出，
  * 本组件不持有业务状态（产物区开关、图标栏激活项与分区折叠缺省非受控，
  * 均可经受控 prop + change 事件闭环）。
  */
-declare function ChatPage({ brand, menuItems, activeMenuKey, railItems, railFooterItems, menuAction, onMenuSelect, onMenuAction, conversationSectionTitle, conversationSectionCollapsed, defaultConversationSectionCollapsed, onConversationSectionToggle, conversations, activeConversationId, onSelectConversation, onDeleteConversation, moreLabel, onMore, footerSectionTitle, footerItems, footerSectionCollapsed, defaultFooterSectionCollapsed, onFooterSectionToggle, conversationTitle, conversationHeaderAction, onConversationHeaderAction, conversationRailItems, hideArtifactRailItem, activeConversationRailKey, onConversationRailChange, messages, sending, composerPlaceholder, welcome, onSend, onMessageAction, models, model, onModelChange, contexts, contextItems, onContextItemsChange, attachments, onAttachFiles, onRemoveAttachment, onRetryAttachment, composerFooter, composerBottom, artifactTitle, artifacts, activeArtifactId, onSelectArtifact, artifactEmptyText, safeRegistry, user, artifactViewers, onDownloadArtifact, artifactOpen, defaultArtifactOpen, onArtifactOpenChange, className, style, }: ChatPageProps): React.JSX.Element;
+declare function ChatPage({ brand, menuItems, activeMenuKey, railItems, railFooterItems, menuAction, onMenuSelect, onMenuAction, conversationSectionTitle, conversationSectionCollapsed, defaultConversationSectionCollapsed, onConversationSectionToggle, conversations, activeConversationId, onSelectConversation, onDeleteConversation, moreLabel, onMore, footerSectionTitle, footerItems, footerSectionCollapsed, defaultFooterSectionCollapsed, onFooterSectionToggle, conversationTitle, conversationHeaderAction, onConversationHeaderAction, conversationRailItems, hideArtifactRailItem, activeConversationRailKey, onConversationRailChange, messages, sending, composerPlaceholder, welcome, onSend, onMessageAction, models, model, onModelChange, contexts, contextItems, onContextItemsChange, attachments, onAttachFiles, onRemoveAttachment, onRetryAttachment, composerFooter, composerBottom, artifactTitle, artifacts, activeArtifactId, onSelectArtifact, artifactEmptyText, safeRegistry, user, artifactViewers, onDownloadArtifact, artifactOpen, defaultArtifactOpen, onArtifactOpenChange, content, className, style, }: ChatPageProps): React.JSX.Element;
 
 /** 引用来源项 */
 interface CitationItem {
@@ -4185,1029 +4193,6 @@ interface ToolCallProps {
  */
 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;
-
-/** 上层右侧状态/分类标签 */
-interface EntityCardTag {
-    text: string;
-    /** 语义色，默认 default */
-    color?: TagColor;
-}
-/** 下层操作按钮；key 缺省取 text */
-interface EntityCardAction {
-    text: string;
-    key?: string;
-    variant?: ButtonVariant;
-    danger?: boolean;
-}
-interface EntityCardProps {
-    /** 图标名（Icon 白名单）；与 logo 二选一，logo 优先 */
-    icon?: string;
-    /** Logo 图片地址 */
-    logo?: string;
-    /** 主标题 */
-    title?: string;
-    /** 标题下方辅助短文案（版本号、编码等） */
-    subtitle?: string;
-    /** 上层右侧标签组 */
-    tags?: EntityCardTag[];
-    /** 中层描述说明，固定两行高度、超出截断 */
-    description?: string;
-    /** 中层右侧维护信息（与描述平铺，如「平台组 · 更新于 2026-09-28」） */
-    meta?: string;
-    /** 下层操作按钮组（居右）；不配置则不渲染下层 */
-    actions?: EntityCardAction[];
-    /** 下层是否带浅底栏背景，默认 true */
-    footerBackground?: boolean;
-    /** 整卡可点：手型 + hover 边框/背景高亮，常配 events.onClick */
-    hoverable?: boolean;
-    /** 通用：根节点 class（与内置样式合并） */
-    className?: string;
-    /** 通用：内容区 class */
-    contentClassName?: string;
-    /** 通用：根节点内联样式 */
-    style?: CSSProperties;
-    /** 整卡点击（actions 区域不触发） */
-    onClick?: () => void;
-    /** 操作按钮点击，参数 { key, text, index } */
-    onAction?: (event: {
-        key: string;
-        text: string;
-        index: number;
-    }) => void;
-}
-/**
- * EntityCard 实体摘要卡（business 目录）：上（图标+标题+副文案 / 标签组）、
- * 中（描述 / 维护信息）、下（浅底栏操作按钮组）三层结构；按钮点击独立于
- * 整卡点击（stopPropagation）。组件不内置请求，交互由 DSL events 编排。
- */
-declare function EntityCard({ icon, logo, title, subtitle, tags, description, meta, actions, footerBackground, hoverable, className, contentClassName, style, onClick, onAction, }: EntityCardProps): React.JSX.Element;
-
-/** 卡片数据项：字段与 EntityCard props 同形，可携带额外业务字段（事件参数原样回传） */
-interface CardListItem {
-    icon?: string;
-    logo?: string;
-    title?: string;
-    subtitle?: string;
-    tags?: EntityCardTag[];
-    description?: string;
-    meta?: string;
-    actions?: EntityCardAction[];
-    [key: string]: unknown;
-}
-interface CardListProps {
-    /** 卡片数据 */
-    items?: CardListItem[];
-    /** 网格列数，默认 3 */
-    columns?: number;
-    /** 卡片间距（px），默认 16 */
-    gap?: number;
-    /** 配置后首格展示虚线新建占位卡（文案如「新建插件」） */
-    createText?: string;
-    /** 新建占位卡图标，默认 plus */
-    createIcon?: string;
-    /** 卡片是否整卡可点（透传 EntityCard hoverable），默认 false */
-    hoverable?: boolean;
-    /** 底部是否展示「共 N 个」计数，默认 false */
-    showCount?: boolean;
-    /** 空数据文案（默认 i18n pactor.table.empty） */
-    emptyText?: string;
-    /** 通用：根节点 class（与内置样式合并） */
-    className?: string;
-    /** 通用：根节点内联样式 */
-    style?: CSSProperties;
-    /** 整卡点击，参数 { item, index } */
-    onItemClick?: (event: {
-        item: CardListItem;
-        index: number;
-    }) => void;
-    /** 卡内操作按钮点击，参数 { key, text, item, index } */
-    onItemAction?: (event: {
-        key: string;
-        text: string;
-        item: CardListItem;
-        index: number;
-    }) => void;
-    /** 新建占位卡点击 */
-    onCreateClick?: () => void;
-}
-/**
- * CardList 卡片列表（business 目录）：响应式网格渲染实体摘要卡，
- * 支持首格新建占位卡、空状态与结果计数；交互经 events 编排
- * （onItemClick / onItemAction / onCreateClick，参数经 ${event} 读取）。
- */
-declare function CardList({ items, columns, gap, createText, createIcon, hoverable, showCount, emptyText, className, style, onItemClick, onItemAction, onCreateClick, }: CardListProps): React.JSX.Element;
-
-/**
- * valueMapping 条目：描述模板中一个 ${key} / {{key}} 占位符的取值方式，
- * 结构与表单项（FormFieldDefinition）一致。
- */
-interface ExpressionMappingItem {
-    name?: string | null;
-    label?: string | null;
-    /**
-     * 控件类型："select" 下拉框、"number" 数值输入、"fieldCondition" 条件组编辑器，
-     * 其他值（input、nodeType、edgeType 等）回退为文本输入框
-     */
-    type?: string | null;
-    required?: boolean | null;
-    placeholder?: string | null;
-    /** select 的内联候选 */
-    options?: Array<{
-        label: string;
-        value: string;
-    }> | null;
-    /**
-     * select 的候选来源：匹配页面 optionSource 中的同名条目，
-     * 支持静态 { options }；远程 { request, valueField, labelField } 条目
-     * 在本移植版中不支持（无 fetchApi 通道），按空候选处理。
-     */
-    optionSource?: string | null;
-    /** 默认值 */
-    default?: any;
-    multiple?: boolean | null;
-    /**
-     * 校验规则（与 type 同级）：pattern 为正则字符串，message 为失败提示；
-     * 与外层表单字段的 validation 同构，编辑态逐项校验，不通过则阻断提交
-     */
-    validation?: {
-        pattern?: string | null;
-        message?: string | null;
-    } | null;
-}
-interface ExpressionEditorProps {
-    id?: string;
-    value?: string;
-    onChange?: (value: string) => void;
-    /**
-     * 表单值模板，如 "return ft.period(${a}, ${b})"。
-     * 占位符支持 ${key} 与 {{key}} 两种写法；DSL props 内联书写时须用 {{key}}，
-     * 因为 ${ 会被 DSL 表达式引擎提前求值（后端数据 / state 透传的模板不受此限）。
-     */
-    valueTemplate: string;
-    /** 模板占位符到控件的映射，key 与模板中 ${key} / {{key}} 对应 */
-    valueMapping?: Record<string, ExpressionMappingItem>;
-    /**
-     * 页面级 optionSource 集合，供 mapping 条目的 optionSource 匹配。
-     * 仅静态 { options } 条目生效；远程 { request } 条目被忽略（按空候选渲染）。
-     */
-    optionSources?: Record<string, any>;
-    /** 字段标签：渲染在头部左侧，右侧为「编辑」按钮 */
-    label?: string | null;
-    /** 必填标记（label 后显示 *） */
-    required?: boolean;
-    readonly?: boolean;
-    /** 控件尺寸（默认 middle；编辑态子控件与表达式文本框统一按尺寸令牌渲染） */
-    size?: ControlSize;
-    /**
-     * 只读展示模式：以「表单控件」形态展示（控件禁用、隐藏编辑/确定/取消按钮），
-     * 供详情页等"只看不改"的场景复用同一套组件。
-     */
-    viewOnly?: boolean;
-    className?: string;
-    /**
-     * 校验状态上报：编辑态存在未通过校验的草稿时为 true。
-     * 模板子字段的校验无法由外层表单 rules 感知，外层需据此在提交前阻断。
-     */
-    onValidityChange?: (invalid: boolean) => void;
-}
-declare function ExpressionEditor({ id, value, onChange, valueTemplate, valueMapping, optionSources, label, required, readonly, viewOnly, size, className, onValidityChange, }: ExpressionEditorProps): React.JSX.Element | null;
-
-/** 候选字段（datasource.json 结构） */
-interface ConditionFieldOption {
-    featureCode: string;
-    featureName: string;
-    /** DATE | STRING | NUMBER | BOOLEAN */
-    fieldType: string;
-    recommended?: boolean;
-}
-interface FieldConditionItem {
-    field: {
-        value?: string;
-        label?: string;
-        dataType?: string;
-    };
-    term: {
-        value?: string;
-        label?: string;
-    };
-    value?: any;
-}
-interface FieldConditionGroup {
-    relation: 'AND' | 'OR';
-    children: FieldConditionItem[];
-}
-interface FieldConditionValue {
-    relation: 'AND' | 'OR';
-    children: FieldConditionGroup[];
-}
-interface FieldConditionProps {
-    value?: FieldConditionValue;
-    onChange?: (value: FieldConditionValue) => void;
-    /** 候选字段（datasource.json 结构） */
-    fields?: ConditionFieldOption[];
-    disabled?: boolean;
-    /** 控件尺寸（默认 middle；行内字段/操作符/值控件统一按尺寸令牌渲染） */
-    size?: ControlSize;
-}
-declare function FieldCondition({ value, onChange, fields, disabled, size, }: FieldConditionProps): React.JSX.Element;
-
-/**
- * 结构模式（对应《登录页产品结构设计》的容器关系）：
- * - `split`（默认，01–04、12）左右分栏：比例、方向、认证区容器均可配置
- * - `centered`（05/07）居中认证区
- * - `brand-card`（06）品牌区为独立卡片 + 右侧裸表单
- * - `overlap`（08）品牌卡片与登录卡片局部叠加
- * - `backdrop`（11）整页渐变品牌背景 + 悬浮认证卡片
- * （10 扫码登录不在组件范围内）
- */
-type LoginVariant = "split" | "centered" | "brand-card" | "overlap" | "backdrop";
-interface LoginBrandInfo {
-    /** Logo 图片地址 */
-    logo?: string;
-    /** 品牌/产品名称 */
-    name?: string;
-    /** 品牌主标题 / Slogan */
-    title?: string;
-    /** 品牌副标题 / 说明 */
-    description?: string;
-    /** 品牌展示插画地址（窄屏不展示）；缺省展示内置默认插画，传空字符串可隐藏 */
-    illustration?: string;
-}
-interface LoginLink {
-    text: string;
-    /** 配置后渲染为链接直接跳转；缺省时点击触发对应 DSL 事件 */
-    href?: string;
-}
-interface LoginProps {
-    /** 结构模式，默认 split */
-    layout?: LoginVariant;
-    /**
-     * 品牌区方向（split / brand-card / overlap / backdrop 生效；centered 无分栏不适用），
-     * 默认 left；right 即文档 12「左表单 + 右概念展示」的镜像结构
-     * （窄屏均为认证区在前，品牌区隐藏或后置）
-     */
-    brandSide?: "left" | "right";
-    /** 品牌区分栏占比 0–1（仅 split），默认 0.5；0.6 即文档 04 的品牌大区 */
-    brandRatio?: number;
-    /**
-     * 认证区容器（split / centered 生效）：
-     * `plain` 裸表单（320–380px）；`card` 常规卡片（默认，400px）；
-     * `float` 大尺寸悬浮卡片（440px + 大留白 + 强阴影，即文档 03）
-     */
-    authVariant?: "plain" | "card" | "float";
-    /** split 品牌面板是否带渐变背景，默认 true */
-    brandPanelBackground?: boolean;
-    /** 是否渲染默认背景装饰（圆斑/圆环/点阵/流线），默认 true */
-    decor?: boolean;
-    /** 品牌区配置；居中布局下仅展示 logo+name（配置了才渲染） */
-    brand?: LoginBrandInfo;
-    /** 认证区标题 */
-    title?: string;
-    /** 认证区说明 */
-    subtitle?: string;
-    usernameLabel?: string;
-    usernamePlaceholder?: string;
-    passwordLabel?: string;
-    passwordPlaceholder?: string;
-    /** 提交按钮文案 */
-    submitText?: string;
-    /** 注册入口（未配置不渲染） */
-    registerLink?: LoginLink;
-    /** 找回密码入口（未配置不渲染） */
-    forgotLink?: LoginLink;
-    /** 页脚文案（版权/协议行，未配置不渲染） */
-    footer?: string;
-    /**
-     * 认证区内容插槽（DSL children 或 ReactNode）：提供时替换内置账号密码表单，
-     * 标题/副标题与辅助入口（registerLink / forgotLink）保留。
-     * 可内嵌 Tabs 切换多种登录方式（手机验证码 / 账号密码等）；
-     * 插槽内的表单字段、校验与提交事件由使用方自行编排，Login 的 onSubmit 不再生效
-     */
-    children?: ReactNode;
-    /** 通用：根节点 class（与内置样式合并） */
-    className?: string;
-    /** 通用：根节点内联样式 */
-    style?: CSSProperties;
-    /** 校验通过后触发，参数为 { username, password }；登录请求与跳转由 DSL 编排 */
-    onSubmit?: (values: Record<string, unknown>) => void;
-    onRegisterClick?: () => void;
-    onForgotClick?: () => void;
-}
-/**
- * Login 登录业务组件（business 目录）：
- * 品牌区 + 认证区 + 辅助入口 + 页脚的整页组合，内部复用 Form/Input/Button。
- * 结构模式（layout）与修饰配置（方向/比例/卡片样式/背景/装饰）正交组合；
- * 认证区内容支持 children 插槽替换内置表单（可内嵌 Tabs 切换多种登录方式）；
- * 样式全部走语义令牌（深浅色/换肤自适应）；文案缺省走 i18n（pactor.login.*），
- * 同名 props 优先。组件不内置登录请求。
- */
-declare function Login({ layout, brandSide, brandRatio, authVariant, brandPanelBackground, decor, brand, title, subtitle, usernameLabel, usernamePlaceholder, passwordLabel, passwordPlaceholder, submitText, registerLink, forgotLink, footer, children, className, style, onSubmit, onRegisterClick, onForgotClick, }: LoginProps): React.JSX.Element;
-
-type ConditionOpt = 'GREATER' | 'GREATER_EQUAL' | 'LESS_EQUAL' | 'LESS' | 'EQUAL' | 'IN' | 'NOT_IN' | 'UNEQUAL' | 'LIKE' | 'NULL' | 'HASVAL' | 'NOTNULL' | 'BETWEEN';
-interface Condition {
-    key: number;
-    opt: ConditionOpt;
-    value?: string | number | (string | number)[];
-    score?: number;
-}
-interface RuleConfigValue {
-    score?: number;
-    ruleConditions: Condition[];
-}
-interface RuleConfigProps {
-    value?: RuleConfigValue;
-    onChange?: (value: RuleConfigValue) => void;
-    disabled?: boolean;
-    /** 控件尺寸（默认 middle；权重/取值/评分输入与操作符下拉统一按尺寸令牌渲染） */
-    size?: ControlSize;
-}
-declare function RuleConfig({ value, onChange, disabled, size }: RuleConfigProps): React.JSX.Element;
-
-interface RuleExpressionOption {
-    label: string;
-    value: string;
-}
-/** 组件值：expression 为表达式串（其中字段使用选项的 value），expressionLabel 为 label 组成的串，sourceField 为所有选中特征字段的 value 数组 */
-interface RuleExpressionValue {
-    expression: string;
-    expressionLabel: string;
-    sourceField: string[];
-}
-interface RuleExpressionProps {
-    /** 特征字段候选（label 用于匹配与展示，value 写入 sourceField） */
-    options?: RuleExpressionOption[];
-    value?: RuleExpressionValue | string | null;
-    onChange?: (value: RuleExpressionValue) => void;
-    placeholder?: string;
-    disabled?: boolean;
-    /** 控件尺寸（默认 middle；影响编辑区内边距与字号，高度仍随内容增长） */
-    size?: ControlSize;
-    id?: string;
-    className?: string;
-}
-/**
- * 规则表达式编辑器：contentEditable 富文本输入框，高度随内容增长。
- * 选中的字段渲染为 contentEditable=false 的整体 chip，
- * 光标可用鼠标点击或 ←/→ 在任意位置自由定位（chip 作为原子单位越过）；
- * 输入时按光标前的尾部词匹配特征字段 label 候选，↑/↓ 选择、回车选中；
- * chip 旁的退格/Delete 整体删除 chip；未匹配的输入保留为字符串。
- */
-declare function RuleExpression({ options, value, onChange, placeholder, disabled, size, id, className, }: RuleExpressionProps): React.JSX.Element;
-
-interface ScriptFunctionParameter {
-    name: string;
-    type?: string;
-    description?: string;
-}
-/** 自定义函数定义：联想时以 snippet 形式补全（如 SUM(${1:field})） */
-interface ScriptFunctionDef {
-    name: string;
-    description?: string;
-    parameters?: ScriptFunctionParameter[];
-}
-/** 自定义变量定义：联想时直接补全变量名 */
-interface ScriptVariableDef {
-    name: string;
-    type?: string;
-    description?: string;
-}
-interface ScriptEditorProps {
-    id?: string;
-    value?: string;
-    onChange?: (value: string) => void;
-    placeholder?: string;
-    /** 语法模式，默认 python；未知值回退为纯文本 */
-    language?: string;
-    functions?: ScriptFunctionDef[];
-    variables?: ScriptVariableDef[];
-    readonly?: boolean;
-    /** 编辑器高度（px），默认 160 */
-    height?: number;
-    className?: string;
-}
-declare function ScriptEditor({ id, value, onChange, placeholder, language, functions, variables, readonly, height, className, }: ScriptEditorProps): React.JSX.Element;
-
-interface SearchableSelectProps {
-    value?: string | string[];
-    /** 单选清除时回传 ""（不用 undefined：RHF 会移除 undefined 并回退到 defaultValue） */
-    onChange?: (value: string | string[] | undefined) => void;
-    options: Array<{
-        label: string;
-        value: string;
-    }>;
-    /** 未选值时的占位文案，缺省「请选择」 */
-    placeholder?: string;
-    /** 搜索框占位文案，缺省「搜索…」 */
-    searchPlaceholder?: string;
-    /** 过滤无匹配的空态文案，缺省「无匹配结果」 */
-    emptyText?: string;
-    disabled?: boolean;
-    /** hover 清除（缺省开启，传 false 关闭；仅单选）：有选中值时悬停触发器，上下箭头替换为 ×，点击清空（回传 ""） */
-    allowClear?: boolean;
-    /** 控件尺寸（默认 middle，即现行 min-h-9 尺寸；与基础表单控件同一尺寸令牌） */
-    size?: ControlSize;
-    className?: string;
-    id?: string;
-    /** Whether to show the search input. When undefined, auto-show if options.length > 8. */
-    showSearch?: boolean;
-    /** Whether to allow multiple selection. */
-    multiple?: boolean;
-    /** 下拉选项完整显示：不截断字符，弹层宽度自适应内容 */
-    fullOptionText?: boolean;
-    /** 自定义下拉列表（CommandList）样式，如覆盖 max-h 限制 */
-    listClassName?: string;
-}
-declare function SearchableSelect({ value, onChange, options, placeholder, searchPlaceholder, emptyText, disabled, allowClear, size, className, id, showSearch, multiple, fullOptionText, listClassName, }: SearchableSelectProps): React.JSX.Element;
-
-/** 页脚链接：有 href 渲染 Link（SPA 语义），无 href 渲染 button 并触发 onLinkClick */
-interface SiteFooterLink {
-    /** 链接文案 */
-    text: string;
-    /** 链接地址；配置后渲染为 <a>（站内 SPA 跳转 / 站外新窗口由 Link 语义处理） */
-    href?: string;
-}
-/** 链接列组：标题 + 组内链接列表 */
-interface SiteFooterLinkGroup {
-    /** 组标题（如「产品」「资源」） */
-    title: string;
-    /** 组内链接 */
-    links: SiteFooterLink[];
-}
-/** 品牌区配置（左列：logo / 名称 / 描述） */
-interface SiteFooterBrand {
-    /** Logo 图片地址 */
-    logo?: string;
-    /** 品牌名称 */
-    name?: string;
-    /** 品牌描述 / 副文案 */
-    description?: string;
-}
-interface SiteFooterProps {
-    /** 品牌区配置；未配置不渲染品牌列 */
-    brand?: SiteFooterBrand;
-    /** 链接列组；未配置不渲染链接区 */
-    groups?: SiteFooterLinkGroup[];
-    /** 底部栏版权文案（如「© 2026 Pactor」） */
-    copyright?: string;
-    /** 底部栏辅助链接（备案号 / 隐私协议 / 服务条款等） */
-    bottomLinks?: SiteFooterLink[];
-    /** 链接点击（仅无 href 的链接），回传 { key, text }（key 缺省取 text，对齐 EntityCardAction 约定） */
-    onLinkClick?: (event: {
-        key: string;
-        text: string;
-    }) => void;
-    /** 通用：根节点 class（与内置样式合并） */
-    className?: string;
-    /** 通用：根节点内联样式 */
-    style?: CSSProperties;
-}
-/**
- * SiteFooter 站点页脚（business 级组合组件）：
- * 上层左侧品牌区（logo / 名称 / 描述）+ 右侧链接列组（标题 + 链接），
- * 底部版权栏（copyright 左、辅助链接右，border 分隔）；
- * 与 Layout 子区域 Footer 区分（后者为页面骨架槽位，本组件为独立站点页脚资产）。
- * 布局响应式：窄屏上下堆叠（主区 flex-col、底部栏居中堆叠），宽屏左右分栏。
- */
-declare function SiteFooter({ brand, groups, copyright, bottomLinks, onLinkClick, className, style, }: SiteFooterProps): React.JSX.Element | null;
-
 /**
  * 内置组件表：DSL 类型名 → 组件适配器。
  * 类型名集合即 spec: builtin-components 的内置组件清单；
@@ -5355,33 +4340,6 @@ declare const builtinComponents: {
     readonly Composer: typeof Composer;
     readonly ConversationList: typeof ConversationList;
     readonly StepsPanel: typeof StepsPanel;
-    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;
-    readonly Login: typeof Login;
-    readonly EntityCard: typeof EntityCard;
-    readonly CardList: typeof CardList;
-    readonly SiteFooter: typeof SiteFooter;
-    readonly SearchableSelect: typeof SearchableSelect;
-    readonly FieldCondition: typeof FieldCondition;
-    readonly ExpressionEditor: typeof ExpressionEditor;
-    readonly RuleConfig: typeof RuleConfig;
-    readonly RuleExpression: typeof RuleExpression;
-    readonly ScriptEditor: typeof ScriptEditor;
 };
 /** 把全部 V1 内置组件按 DSL 类型名注册到给定 ComponentRegistry */
 declare function registerBuiltinComponents(registry: ComponentRegistry): void;
@@ -5428,4 +4386,13 @@ interface FormContextValue {
 /** 在字段组件内探测 Form 上下文；不在 Form 内时返回 null */
 declare function useFormContext(): FormContextValue | null;
 
-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, CONTROL_SIZE_AREA, CONTROL_SIZE_BOX, CONTROL_SIZE_BOX_GROW, CONTROL_SIZE_SELECT_ATTR, CONTROL_SIZE_TRIGGER_TEXT, Calendar, type CalendarProps, Card, CardList, type CardListItem, type CardListProps, 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, ChipFilter, type ChipFilterItem, type ChipFilterProps, ChipNode, type ChipNodeProps, Citation, type CitationItem, type CitationProps, CodeBlock, type CodeBlockProps, Col, type ColBreakpoint, type ColProps, type ColResponsiveValue, 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, type Condition, type ConditionFieldOption, type ConditionOpt, Container, type ContainerProps, type ContainerSize, Content, type ContentProps, ContextMenu, type ContextMenuItemData, type ContextMenuProps, type ControlSize, type ConversationItemData, ConversationList, type ConversationListProps, type ConversationRailItem, 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, EntityCard, type EntityCardAction, type EntityCardProps, type EntityCardTag, ExpressionEditor, type ExpressionEditorProps, type ExpressionMappingItem, Field, FieldCondition, type FieldConditionGroup, type FieldConditionItem, type FieldConditionProps, type FieldConditionValue, type FieldProps, type FieldRule, FilePreview, type FilePreviewKind, type FilePreviewProps, Flex, type FlexProps, Footer, type FooterProps, For, type ForProps, 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, Login, type LoginBrandInfo, type LoginLink, type LoginProps, type LoginVariant, 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, Row, type RowAlign, type RowJustify, type RowProps, RuleConfig, type RuleConfigProps, type RuleConfigValue, RuleExpression, type RuleExpressionOption, type RuleExpressionProps, type RuleExpressionValue, SankeyChart, type SankeyChartProps, ScatterChart, type ScatterChartProps, ScriptEditor, type ScriptEditorProps, type ScriptFunctionDef, type ScriptFunctionParameter, type ScriptVariableDef, ScrollArea, type ScrollAreaProps, SearchableSelect, type SearchableSelectProps, 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, SiteFooter, type SiteFooterBrand, type SiteFooterLink, type SiteFooterLinkGroup, type SiteFooterProps, 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, StepsPanel, type StepsPanelItemData, type StepsPanelProps, 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 };
+interface ClearHoverButtonProps {
+    /** aria-label（缺省「清除」语义，调用方传 i18n 文案或既有测试标签） */
+    label: string;
+    onClear: () => void;
+    /** 额外 class（如 Input 的绝对定位 right-2） */
+    className?: string;
+}
+declare function ClearHoverButton({ label, onClear, className }: ClearHoverButtonProps): React.JSX.Element;
+
+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, 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, Breadcrumb, type BreadcrumbItemData, type BreadcrumbProps, Bubble, type BubbleProps, type BubbleVariant, Button, ButtonGroup, type ButtonGroupProps, type ButtonProps, type ButtonSize, type ButtonVariant, CONTROL_SIZE_AREA, CONTROL_SIZE_BOX, CONTROL_SIZE_BOX_GROW, CONTROL_SIZE_SELECT_ATTR, CONTROL_SIZE_TRIGGER_TEXT, Calendar, type CalendarProps, Card, type CardProps, Carousel, type CarouselImage, type CarouselItemData, type CarouselProps, Cascader, type CascaderOption, type CascaderProps, 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, ChipFilter, type ChipFilterItem, type ChipFilterProps, ChipNode, type ChipNodeProps, Citation, type CitationItem, type CitationProps, ClearHoverButton, type ClearHoverButtonProps, CodeBlock, type CodeBlockProps, Col, type ColBreakpoint, type ColProps, type ColResponsiveValue, Collapsible, type CollapsibleProps, ColorPicker, type ColorPickerProps, Combobox, type ComboboxOption, type ComboboxProps, Command, type CommandGroupData, type CommandItemData, type CommandProps, Composer, type ComposerContextItem, type ComposerContextSource, type ComposerModelOption, type ComposerProps, Container, type ContainerProps, type ContainerSize, Content, type ContentProps, ContextMenu, type ContextMenuItemData, type ContextMenuProps, type ControlSize, type ConversationItemData, ConversationList, type ConversationListProps, type ConversationRailItem, 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, Drawer, type DrawerPlacement, type DrawerProps, DropdownMenu, type DropdownMenuItemData, type DropdownMenuProps, Empty, type EmptyProps, Field, type FieldProps, type FieldRule, FilePreview, type FilePreviewKind, type FilePreviewProps, Flex, type FlexProps, Footer, type FooterProps, For, type ForProps, Form, type FormContextValue, type FormProps, Gallery, type GalleryItemData, type GalleryProps, 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, 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, Link, type LinkProps, List, type ListItemData, type ListProps, LoadingOverlay, type LoadingOverlayProps, 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, NavigationMenu, type NavigationMenuChildItem, type NavigationMenuItemData, type NavigationMenuProps, Notification, type NotificationProps, NumberInput, type NumberInputProps, Page, type PageProps, Pagination, type PaginationProps, Popconfirm, type PopconfirmProps, Popover, type PopoverProps, Progress, type ProgressProps, Prompt, type PromptProps, QRCode, type QRCodeProps, RadioGroup, type RadioGroupOption, type RadioGroupProps, RailTooltip, Rate, type RateProps, Resizable, type ResizablePanelData, type ResizableProps, Result, type ResultProps, type ResultStatus, RichText, type RichTextProps, Row, type RowAlign, type RowJustify, type RowProps, 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, StepsPanel, type StepsPanelItemData, type StepsPanelProps, 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, 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 };