@sia.soul/sia-react-ui 0.1.20 → 0.1.21

package/dist/chart.d.cts

@@ -1,9 +1,22 @@
 import * as react from 'react';
 import { ReactNode, CSSProperties, HTMLAttributes, SVGAttributes, PointerEvent } from 'react';
 
+/** 图表旋转加载的属性配置。 */
 interface ChartWhirlingLoadingProps {
+    /**
+     * 宽度；数值按像素处理，字符串可使用 CSS 尺寸。
+     * @defaultValue 720
+     */
     width?: number;
+    /**
+     * 高度；数值按像素处理，字符串可使用 CSS 尺寸。
+     * @defaultValue 360
+     */
     height?: number;
+    /**
+     * 显示文本。
+     * @defaultValue '数据获取中'
+     */
     text?: string;
     /** Measured text width in viewBox units; omitted uses a CJK-aware estimate. */
     textWidth?: number;
@@ -13,209 +26,470 @@ interface ChartWhirlingLoadingProps {
 /** A native SVG chart loading layer: ring, rotating droplet and fixed inner dot. */
 declare function ChartWhirlingLoading({ width, height, text, textWidth, frame }: ChartWhirlingLoadingProps): react.JSX.Element;
 
+/** SVG 地图使用的二维坐标点。 */
 type Point = readonly [number, number];
+/** SVG地图的属性配置。 */
 interface SvgMapPlotProps {
+    /** 触发来源，用于区分不同入口的操作。 */
     source: string;
+    /** 名称或字段标识。 */
     name: string;
+    /** 用于渲染的数据集合。 */
     data: readonly {
+        /** 名称或字段标识。 */
         name: string;
+        /** 当前值；作为受控属性时，需要在变更回调中同步更新。 */
         value?: number;
+        /** 是否启用鼠标悬停反馈。 */
         hoverable?: boolean;
+        /** 是否显示标签文本。 */
         showLabel?: boolean;
     }[];
+    /** 横向位置或 X 轴数据值。 */
     x: number;
+    /** 纵向位置或 Y 轴数据值。 */
     y: number;
+    /** 宽度；数值按像素处理，字符串可使用 CSS 尺寸。 */
     width: number;
+    /** 高度；数值按像素处理，字符串可使用 CSS 尺寸。 */
     height: number;
+    /** 坐标轴的数据取值范围。 */
     domain: readonly [number, number];
+    /**
+     * 是否启用范围选择，或指定选择范围。
+     * @defaultValue domain
+     */
     range?: readonly [number, number];
+    /** 可选颜色或颜色序列。 */
     colors: readonly string[];
+    /** 标签相对于默认位置的偏移集合。 */
     labelOffsets?: Readonly<Record<string, readonly number[]>>;
+    /** 当前悬停所关联的数据范围。 */
     hoverRange?: readonly [number, number];
+    /** 悬停的数据值变化时调用。 */
     onHoverValue?: (value: number | undefined) => void;
+    /**
+     * 地图或图表的平移、缩放配置。
+     * @defaultValue true
+     */
     roam?: boolean;
+    /**
+     * 该值变化时重置内部交互状态。
+     * @defaultValue 0
+     */
     resetKey?: number;
+    /** 子内容；组件嵌套内容或当前节点的子项。 */
     children?: ReactNode;
+    /**
+     * 线条动画配置。
+     * @defaultValue false
+     */
     lineAnimation?: boolean;
+    /**
+     * 提示框是否仅显示名称。
+     * @defaultValue false
+     */
     tooltipNameOnly?: boolean;
+    /**
+     * 是否显示数据标签。
+     * @defaultValue true
+     */
     showLabels?: boolean;
+    /**
+     * 数据点动画配置。
+     * @defaultValue false
+     */
     pointAnimation?: boolean;
+    /**
+     * 数据点首次出现时的入场效果。
+     * @defaultValue false
+     */
     pointEntrance?: boolean;
+    /**
+     * 数据点动画的缓动方式。
+     * @defaultValue 'linear'
+     */
     pointAnimationEasing?: 'linear' | 'exponential-out';
+    /**
+     * 标记点配置集合。
+     * @defaultValue []
+     */
     markPoints?: readonly {
+        /** 唯一标识，用于关联实例或插件。 */
         id?: string;
+        /** 名称或字段标识。 */
         name: string;
+        /** 当前值；作为受控属性时，需要在变更回调中同步更新。 */
         value?: number | string;
+        /** 图表坐标位置或坐标转换配置。 */
         coordinate: Point;
+        /** 展示给用户的名称，可传入文本或 React 节点。 */
         label?: string;
+        /** 标签文字颜色。 */
         labelColor?: string;
+        /** 文字大小，单位为像素。 */
         fontSize?: number;
+        /** 边框线宽。 */
         borderWidth?: number;
+        /** 组件尺寸；用于调整控件高度、字号和间距。 */
         size?: number;
+        /** 动态效果的颜色。 */
         effectColor?: string;
+        /** 滚动或淡入效果 */
         effect?: boolean;
+        /** 显示颜色，可使用 CSS 颜色值。 */
         color?: string;
+        /** 数据点或节点使用的图形符号。 */
         symbol?: 'pin' | 'circle' | 'emptyCircle';
     }[];
+    /**
+     * 标记线配置集合。
+     * @defaultValue []
+     */
     markLines?: readonly {
+        /** 唯一标识，用于关联实例或插件。 */
         id?: string;
+        /** 名称或字段标识。 */
         name: string;
+        /** 当前值；作为受控属性时，需要在变更回调中同步更新。 */
         value?: number;
+        /** 触发来源，用于区分不同入口的操作。 */
         source: Point;
+        /** 关联的目标元素或获取目标元素的函数。 */
         target: Point;
+        /** 周期动画的周期时长。 */
         period?: number;
+        /** 动态效果的颜色。 */
         effectColor?: string;
+        /** 阴影模糊半径。 */
         shadowBlur?: number;
+        /** 显示颜色，可使用 CSS 颜色值。 */
         color?: string;
+        /** 特效覆盖的半径。 */
         effectRadius?: number;
+        /** 连线起点和终点使用的图形符号。 */
         endpointSymbols?: readonly string[];
     }[];
 }
 /** SVG-native map geometry, without geographic projection or source markup insertion. */
 declare function SvgMapPlot({ source, name, data, x, y, width, height, domain, range, colors, labelOffsets, hoverRange, onHoverValue, roam, resetKey, children, markPoints, markLines, lineAnimation, tooltipNameOnly, showLabels, pointAnimation, pointEntrance, pointAnimationEasing }: SvgMapPlotProps): react.JSX.Element;
 
+/** 图表漫游控制器的属性配置。 */
 interface ChartRoamControllerProps {
+    /**
+     * 横向位置或 X 轴数据值。
+     * @defaultValue 800
+     */
     x?: number;
+    /**
+     * 纵向位置或 Y 轴数据值。
+     * @defaultValue 5
+     */
     y?: number;
+    /** 视图平移时调用。 */
     onPan: (x: number, y: number) => void;
+    /** 视图缩放时调用。 */
     onZoom: (factor: number) => void;
 }
 /** Independent SVG controls; deliberately separate from direct map gestures. */
 declare function ChartRoamController({ x, y, onPan, onZoom }: ChartRoamControllerProps): react.JSX.Element;
 
+/** ChartBrush的属性配置。 */
 interface ChartBrushProps {
+    /**
+     * 框选区域的形状。
+     * @defaultValue 'band'
+     */
     selectionShape?: 'band' | 'rectangle';
+    /** 框选区域的样式。 */
     selectionStyle?: CSSProperties;
     /** Minimum accepted width and height in SVG coordinates. Omitted preserves the 4px horizontal gesture threshold. */
     minSelectionSize?: readonly [number, number];
+    /** 布局边界。 */
     bounds: {
+        /** 横向位置或 X 轴数据值。 */
         x: number;
+        /** 纵向位置或 Y 轴数据值。 */
         y: number;
+        /** 宽度；数值按像素处理，字符串可使用 CSS 尺寸。 */
         width: number;
+        /** 高度；数值按像素处理，字符串可使用 CSS 尺寸。 */
         height: number;
     };
+    /** 选中项目时调用，参数包含选中项目及关联状态。 */
     onSelect: (range: readonly [number, number]) => void;
+    /** 用户取消或通过关闭入口退出时调用。 */
     onCancel?: () => void;
 }
 
+/** 生成扇形或环形扇区的 SVG 路径。 */
 declare function svgArcPath(cx: number, cy: number, outerRadius: number, startAngle: number, endAngle: number, innerRadius?: number, clockwise?: boolean): string;
 
+/** 图表 SVG 内部坐标系的默认宽度。 */
 declare const CHART_VIEWBOX_WIDTH = 720;
+/** 图表 SVG 内部坐标系的默认高度。 */
 declare const CHART_VIEWBOX_HEIGHT = 360;
+/** 图表默认调色板。 */
 declare const DEFAULT_CHART_PALETTE: readonly ["#1677ff", "#36cfc9", "#52c41a", "#faad14", "#ff7a45", "#722ed1", "#eb2f96", "#13c2c2", "#2f54eb", "#a0d911"];
+/** 图例的项目定义。 */
 interface ChartLegendItem {
+    /** 图片资源配置。 */
     image?: string;
+    /** 文字样式。 */
     textStyle?: CSSProperties;
     /** Optional measured label width in SVG coordinates. */
     textWidth?: number;
     /** Override the group's symbol for mixed-series legends. */
     symbol?: 'rect' | 'line' | 'sector';
+    /** 图形填充渐变配置。 */
     fillGradient?: {
+        /** 范围起点。 */
         start: readonly [number, number];
+        /** 范围终点。 */
         end: readonly [number, number];
+        /** 渐变颜色停靠点集合。 */
         stops: readonly {
+            /** 相对于默认位置的偏移。 */
             offset: number;
+            /** 显示颜色，可使用 CSS 颜色值。 */
             color: string;
         }[];
     };
+    /** 边框颜色。 */
     borderColor?: string;
+    /** 名称或字段标识。 */
     name: string;
+    /** 显示颜色，可使用 CSS 颜色值。 */
     color: string;
+    /** 是否禁用交互。 */
     disabled?: boolean;
 }
+/** ChartData的点击事件上下文。 */
 interface ChartDataClickInfo<T = unknown> {
+    /** 名称或字段标识。 */
     name: string;
+    /** 该项目对应的数据值，用于标识、选择或计算。 */
     value: number | readonly number[];
+    /** 数据系列名称。 */
     seriesName?: string;
+    /** 用于渲染的数据集合。 */
     data: T;
+    /** 触发本次操作的原生事件。 */
     nativeEvent: PointerEvent<SVGGElement>;
 }
+/** 图表容器的实例引用接口。 */
 interface SiaChartRef {
+    /** 读取组件底层 DOM 元素。 */
     getElement: () => SVGSVGElement | null;
+    /** 将焦点移入控件。 */
     focus: () => void;
+    /** 导出当前图表的 SVG 源码。 */
     toSvgString: () => string | null;
+    /** 将图表导出为图片 Data URL。 */
     toDataUrl: () => string | null;
 }
+/** 图表容器的属性配置。 */
 interface SiaChartProps extends Omit<HTMLAttributes<HTMLDivElement>, "children" | "title"> {
+    /**
+     * 标题的水平对齐方式。
+     * @defaultValue "left"
+     */
     titleAlign?: "left" | "center" | "right";
+    /**
+     * 标题的垂直对齐方式。
+     * @defaultValue "top"
+     */
     titleVerticalAlign?: "top" | "bottom";
+    /**
+     * SVG 内部视图坐标系的尺寸。
+     * @defaultValue [CHART_VIEWBOX_WIDTH, CHART_VIEWBOX_HEIGHT]
+     */
     viewBoxSize?: readonly [number, number];
+    /** 子内容；组件嵌套内容或当前节点的子项。 */
     children?: ReactNode;
     /** Additional SVG content above chart series and below interaction overlays. */
     svgOverlay?: ReactNode;
+    /**
+     * 宽度；数值按像素处理，字符串可使用 CSS 尺寸。
+     * @defaultValue "100%"
+     */
     width?: number | string;
+    /**
+     * 高度；数值按像素处理，字符串可使用 CSS 尺寸。
+     * @defaultValue 320
+     */
     height?: number | string;
+    /** 标题内容，可传入文本或 React 节点。 */
     title?: ReactNode;
+    /** 补充说明内容。 */
     description?: ReactNode;
+    /**
+     控件的无障碍名称，供屏幕阅读器识别。
+     * @defaultValue typeof title === "string" ? title : "数据图表"
+     */
     ariaLabel?: string;
+    /**
+     * 系列颜色；默认使用 Sia 数据可视化色板
+     * @defaultValue DEFAULT_CHART_PALETTE
+     */
     palette?: readonly string[];
+    /**
+     * 是否处于加载状态。
+     * @defaultValue false
+     */
     loading?: boolean;
+    /**
+     * 无数据时的展示内容或空状态配置。
+     * @defaultValue false
+     */
     empty?: boolean;
+    /**
+     * 没有数据时的显示内容。
+     * @defaultValue "暂无图表数据"
+     */
     emptyContent?: ReactNode;
+    /**
+     * 是否启用图形动画或自定义动画配置。
+     * @defaultValue true
+     */
     animation?: boolean;
+    /**
+     * 图形初次渲染动画的持续时间。
+     * @defaultValue 700
+     */
     animationDuration?: number;
+    /**
+     * 标线、数据视图、形态切换、还原与 SVG 图片保存
+     * @defaultValue false
+     */
     toolbox?: boolean | ChartToolboxOptions;
+    /** 时间轴配置。 */
     timeline?: ChartTimelineProps;
+    /** 框选交互配置。 */
     brush?: ChartBrushProps;
+    /** 提示框的附加属性。 */
     tooltipProps?: Omit<ChartTooltipProps, "open" | "left" | "top" | "children">;
     /** undefined uses local marks; null hides; a value synchronizes an external tooltip. */
     controlledTooltip?: {
+        /** 需要显示的内容，支持文本或 React 节点。 */
         content: ReactNode;
+        /** 当前数据点或屏幕坐标点。 */
         point: readonly [number, number];
     } | null;
+    /** 传给原生 SVG 根节点的属性 */
     svgProps?: Omit<SVGAttributes<SVGSVGElement>, "children" | "width" | "height">;
 }
+/** 组合图表中的一个图层，包含系列类型、数据和布局配置。 */
 interface ChartCompositeLayer {
+    /** 唯一标识；同一集合内应保持唯一且稳定，用于定位、渲染和状态关联。 */
     key?: string;
+    /** 需要显示的内容，支持文本或 React 节点。 */
     content: ReactNode;
+    /** 距左侧的位置或间距。 */
     left?: number | string;
+    /** 距顶部的位置或间距。 */
     top?: number | string;
+    /** 宽度；数值按像素处理，字符串可使用 CSS 尺寸。 */
     width?: number | string;
+    /** 高度；数值按像素处理，字符串可使用 CSS 尺寸。 */
     height?: number | string;
+    /** 组件或浮层的堆叠层级。 */
     zIndex?: number;
+    /** SVG 或 DOM 元素的指针事件响应方式。 */
     pointerEvents?: CSSProperties["pointerEvents"];
 }
+/** 组合图表的实例引用接口。 */
 interface ChartCompositeRef {
+    /** 导出当前图表的 SVG 源码。 */
     toSvgString: () => string | null;
+    /** 将当前图表保存为图片。 */
     saveAsImage: (filename?: string) => Promise<void>;
 }
+/** 组合图表的属性配置。 */
 interface ChartCompositeProps extends Omit<HTMLAttributes<HTMLDivElement>, "children"> {
+    /** 组合图中的图层配置，按顺序绘制。 */
     layers: readonly ChartCompositeLayer[];
+    /**
+     * 宽度；数值按像素处理，字符串可使用 CSS 尺寸。
+     * @defaultValue "100%"
+     */
     width?: number | string;
+    /**
+     * 高度；数值按像素处理，字符串可使用 CSS 尺寸。
+     * @defaultValue 320
+     */
     height?: number | string;
+    /**
+     控件的无障碍名称，供屏幕阅读器识别。
+     * @defaultValue "组合图表"
+     */
     ariaLabel?: string;
 }
+/** 图表工具箱可以启用的功能名称。 */
 type ChartToolboxFeature = "dataZoom" | "mark" | "dataView" | "restore" | "saveAsImage";
+/** 图表工具箱的配置选项。 */
 interface ChartToolboxOptions {
+    /** 垂直对齐方式。 */
     verticalAlign?: 'top' | 'bottom';
+    /** 触发图片导出时调用。 */
     onSaveAsImage?: () => void;
+    /** 是否显示该功能。 */
     show?: boolean;
+    /** 组件的水平或垂直排列方向。 */
     orientation?: "horizontal" | "vertical";
+    /** 工具箱中启用的功能项。 */
     features?: readonly ChartToolboxFeature[];
+    /** 允许切换的图表类型。 */
     magicTypes?: readonly string[];
+    /** 当前切换后的图表类型。 */
     activeMagicType?: string;
     /** Selected options across independent mode groups; takes precedence for button display. */
     activeMagicTypes?: readonly string[];
+    /** 文件名。 */
     filename?: string;
+    /** 是否显示或如何配置数据视图。 */
     dataView?: ReactNode;
+    /** 数据视图是否只读。 */
     dataViewReadOnly?: boolean;
+    /** 视图缩放时调用。 */
     onZoom?: () => void;
+    /** 返回上一次缩放范围时调用。 */
     onZoomBack?: () => void;
+    /** 是否禁用缩放回退。 */
     zoomBackDisabled?: boolean;
+    /** 是否处于缩放选择模式。 */
     zoomActive?: boolean;
+    /** 进入或切换辅助标线模式时调用。 */
     onMark?: () => void;
+    /** 切换图表类型时调用。 */
     onMagicTypeChange?: (type: string) => void;
+    /** 还原初始图表状态时调用。 */
     onRestore?: () => void;
 }
+/** 图表工具箱的属性配置。 */
 interface ChartToolboxProps extends ChartToolboxOptions {
+    /**
+     * 是否处于标线绘制模式。
+     * @defaultValue false
+     */
     markActive?: boolean;
+    /**
+     * 已绘制标线数量。
+     * @defaultValue 0
+     */
     markCount?: number;
+    /** 撤销最近标线时调用。 */
     onMarkUndo?: () => void;
+    /** 清空所有标线时调用。 */
     onMarkClear?: () => void;
+    /** 打开数据视图时调用。 */
     onDataView: () => void;
+    /** 触发图片导出时调用。 */
     onSaveAsImage: () => void;
 }
+/** 组合图表组件。 */
 declare const ChartComposite: react.ForwardRefExoticComponent<ChartCompositeProps & react.RefAttributes<ChartCompositeRef>>;
+/** 图表提示框的属性配置。 */
 interface ChartTooltipProps extends Omit<HTMLAttributes<HTMLDivElement>, "children"> {
     /** Axis placement follows category x / pointer y and applies measured edge corrections. */
     placement?: 'above' | 'axis';
@@ -223,206 +497,502 @@ interface ChartTooltipProps extends Omit<HTMLAttributes<HTMLDivElement>, "childr
     inheritTextStyle?: boolean;
     /** Keep item details available for pointer and keyboard interaction. */
     enterable?: boolean;
+    /** 是否打开；传入后由外部控制显示状态。 */
     open: boolean;
+    /** 距左侧的位置或间距。 */
     left: number;
+    /** 距顶部的位置或间距。 */
     top: number;
+    /** 子内容；组件嵌套内容或当前节点的子项。 */
     children: ReactNode;
 }
+/** 图表提示框组件。 */
 declare function ChartTooltip({ open, left, top, children, enterable, inheritTextStyle, placement, className, style, ...props }: ChartTooltipProps): react.JSX.Element | null;
+/** 图表工具箱组件。 */
 declare function ChartToolbox({ show, orientation, verticalAlign, features, magicTypes, activeMagicType, activeMagicTypes, markActive, markCount, onMarkUndo, onMarkClear, onMark, onZoom, onZoomBack, zoomBackDisabled, zoomActive, onMagicTypeChange, onRestore, onDataView, onSaveAsImage, }: ChartToolboxProps): react.JSX.Element | null;
+/** 图表容器组件。 */
 declare const SiaChart: react.ForwardRefExoticComponent<SiaChartProps & react.RefAttributes<SiaChartRef>>;
+/** 图表标记的属性配置。 */
 interface ChartMarkProps extends SVGAttributes<SVGGElement> {
+    /** 提示内容或提示框配置。 */
     tooltip?: ReactNode;
+    /** 提示框对应的数据点位置。 */
     tooltipPoint?: readonly [number, number];
+    /** 展示给用户的名称，可传入文本或 React 节点。 */
     label: string;
 }
+/** 图表标记组件。 */
 declare function ChartMark({ tooltip, tooltipPoint, label, onPointerMove, onPointerLeave, onFocus, onBlur, ...props }: ChartMarkProps): react.JSX.Element;
+/** 图例的属性配置。 */
 interface ChartLegendProps {
+    /** 图标宽度。 */
     iconWidth?: number;
+    /**
+     * 图标高度。
+     * @defaultValue 14
+     */
     iconHeight?: number;
+    /**
+     * 文字与相邻图形的间距。
+     * @defaultValue 5
+     */
     textGap?: number;
+    /** 文字样式。 */
     textStyle?: CSSProperties;
+    /** 未激活状态的颜色。 */
     inactiveColor?: string;
+    /** 背景颜色或填充配置。 */
     background?: {
+        /** 图形填充颜色。 */
         fill?: string;
+        /** 图形描边颜色。 */
         stroke?: string;
+        /** 描边或进度轨道粗细。 */
         strokeWidth?: number;
+        /** 内容内边距。 */
         padding?: number;
     };
+    /** 允许的最大宽度。 */
     maxWidth?: number;
+    /**
+     * 相邻行的间距。
+     * @defaultValue 24
+     */
     rowGap?: number;
+    /**
+     * 数据点或节点使用的图形符号。
+     * @defaultValue "rect"
+     */
     symbol?: "rect" | "line" | "sector";
+    /** 按展示顺序排列的项目配置。 */
     items: readonly ChartLegendItem[];
+    /**
+     * 横向位置或 X 轴数据值。
+     * @defaultValue CHART_VIEWBOX_WIDTH / 2
+     */
     x?: number;
+    /**
+     * 纵向位置或 Y 轴数据值。
+     * @defaultValue 20
+     */
     y?: number;
+    /**
+     * 交叉轴对齐
+     * @defaultValue "center"
+     */
     align?: "start" | "center" | "end";
+    /**
+     * 相邻项目的间距。
+     * @defaultValue 18
+     */
     itemGap?: number;
+    /**
+     组件的水平或垂直排列方向。
+     * @defaultValue "horizontal"
+     */
     orientation?: "horizontal" | "vertical";
+    /** 是否处于选中状态。 */
     selected?: Readonly<Record<string, boolean>>;
+    /** 点击项目时调用。 */
     onItemClick?: (name: string) => void;
 }
+/** 图例组件。 */
 declare function ChartLegend({ items, symbol, x, y, align, itemGap, orientation, selected, onItemClick, maxWidth, rowGap, iconWidth, iconHeight, textGap, textStyle, inactiveColor, background }: ChartLegendProps): react.JSX.Element;
+/** 图表坐标轴的属性配置。 */
 interface ChartAxisProps {
     /** Split axis strokes from bands/ticks/labels when a chart needs explicit layer ordering. */
     layer?: 'all' | 'base' | 'line';
+    /** 坐标轴分隔区域的填充颜色。 */
     splitAreaColors?: readonly string[];
     /** Normalized band boundaries; defaults to evenly spaced intervals. */
     splitAreaPositions?: readonly number[];
+    /** 线条样式。 */
     lineStyle?: CSSProperties;
+    /** 刻度线样式。 */
     tickStyle?: CSSProperties;
+    /** 网格线样式。 */
     gridStyle?: CSSProperties;
+    /** 标签文字样式。 */
     labelStyle?: CSSProperties;
+    /** 按标签配置的样式集合。 */
     labelStyles?: readonly (CSSProperties | undefined)[];
     /** Distance from the axis line to the label (independent of tick length). */
     labelMargin?: number;
+    /** SVG 标签的水平锚点。 */
     labelAnchor?: 'start' | 'middle' | 'end';
+    /** SVG 标签的文字基线。 */
     labelBaseline?: 'top' | 'middle' | 'bottom';
+    /** 轴端是否保留间隔，或两端间隔的配置。 */
     boundaryGap?: boolean;
+    /** 组件的水平或垂直排列方向。 */
     orientation: "top" | "bottom" | "left" | "right";
+    /** 横向位置或 X 轴数据值。 */
     x: number;
+    /** 纵向位置或 Y 轴数据值。 */
     y: number;
+    /** 长度。 */
     length: number;
+    /** 各操作入口的显示或无障碍文案。 */
     labels: readonly string[];
     /** Normalized positions for nonuniform numeric/calendar ticks. */
     positions?: readonly number[];
+    /** 刻度在轴上的位置集合。 */
     tickPositions?: readonly number[];
+    /** 网格线在轴上的位置集合。 */
     gridPositions?: readonly number[];
     /** Snap line centers to whole/half pixels according to their stroke width. Labels and bands are unaffected. */
     pixelAlign?: boolean;
     /** Outward distance of the axis stroke and tick origin from the logical axis. */
     lineOffset?: number;
+    /**
+     * 刻度相对于默认位置的偏移。
+     * @defaultValue 0
+     */
     tickOffset?: number;
+    /**
+     * 刻度线尺寸。
+     * @defaultValue 5
+     */
     tickSize?: number;
+    /**
+     * 网格线延伸长度。
+     * @defaultValue 0
+     */
     gridLength?: number;
+    /** 将原始值转换为展示文本的函数。 */
     formatter?: (label: string, index: number) => string;
+    /**
+     * 是否反转坐标轴方向。
+     * @defaultValue false
+     */
     inverse?: boolean;
+    /**
+     * 刻度之间的间隔。
+     * @defaultValue 1
+     */
     tickInterval?: number;
+    /**
+     * 标签旋转角度。
+     * @defaultValue 0
+     */
     labelRotate?: number;
+    /**
+     * 是否显示连接线。
+     * @defaultValue true
+     */
     showLine?: boolean;
+    /**
+     * 是否显示刻度线。
+     * @defaultValue true
+     */
     showTicks?: boolean;
+    /**
+     * 是否显示数据标签。
+     * @defaultValue true
+     */
     showLabels?: boolean;
+    /**
+     * 是否显示网格线。
+     * @defaultValue true
+     */
     showGrid?: boolean;
+    /** 名称或字段标识。 */
     name?: string;
+    /** 坐标轴线颜色。 */
     axisColor?: string;
+    /** 网格线颜色。 */
     gridColor?: string;
+    /**
+     * 是否使用虚线网格。
+     * @defaultValue false
+     */
     dashedGrid?: boolean;
 }
+/** 图表坐标轴组件。 */
 declare function ChartAxis({ layer, orientation, x, y, length, labels, positions, tickPositions, gridPositions, pixelAlign, lineOffset, tickOffset, boundaryGap, tickSize, gridLength, formatter, inverse, tickInterval, labelRotate, showLine, showTicks, showLabels, showGrid, name, axisColor, gridColor, dashedGrid, lineStyle, tickStyle, gridStyle, labelStyle, labelStyles, labelMargin, labelAnchor, labelBaseline, splitAreaColors, splitAreaPositions }: ChartAxisProps): react.JSX.Element;
+/** 图表视觉映射的属性配置。 */
 interface ChartVisualMapProps {
+    /**
+     * 拖动过程中是否实时通知值变化。
+     * @defaultValue true
+     */
     realtime?: boolean;
+    /** 鼠标悬停范围变化时调用。 */
     onHoverRange?: (range: readonly [number, number] | undefined) => void;
+    /** 指示器当前对应的值。 */
     indicatorValue?: number;
+    /**
+     * 是否使用 SVG 绘制交互手柄。
+     * @defaultValue false
+     */
     svgHandles?: boolean;
+    /** 范围两端显示的标签。 */
     endLabels?: readonly [string, string];
+    /** 允许的最小值。 */
     min: number;
+    /** 允许的最大值。 */
     max: number;
+    /**
+     * 可选颜色或颜色序列。
+     * @defaultValue ["#e6f4ff", "#1677ff"]
+     */
     colors?: readonly string[];
+    /**
+     * 横向位置或 X 轴数据值。
+     * @defaultValue 16
+     */
     x?: number;
+    /**
+     * 纵向位置或 Y 轴数据值。
+     * @defaultValue 284
+     */
     y?: number;
+    /**
+     * 宽度；数值按像素处理，字符串可使用 CSS 尺寸。
+     * @defaultValue 110
+     */
     width?: number;
+    /**
+     * 高度；数值按像素处理，字符串可使用 CSS 尺寸。
+     * @defaultValue 9
+     */
     height?: number;
+    /** 展示给用户的名称，可传入文本或 React 节点。 */
     label?: string;
+    /**
+     组件的水平或垂直排列方向。
+     * @defaultValue "horizontal"
+     */
     orientation?: "horizontal" | "vertical";
+    /**
+     * 是否允许通过拖拽图形修改数据。
+     * @defaultValue false
+     */
     calculable?: boolean;
+    /**
+     * 当前值；作为受控属性时，需要在变更回调中同步更新。
+     * @defaultValue max
+     */
     value?: number;
+    /** 值发生变化时调用；参数为新值及类型声明中列出的关联信息。 */
     onChange?: (value: number) => void;
+    /** 是否启用范围选择，或指定选择范围。 */
     range?: readonly [number, number];
+    /** 选择范围变化时调用。 */
     onRangeChange?: (range: [number, number]) => void;
+    /** 分段视觉映射的区间配置。 */
     pieces?: readonly {
+        /** 允许的最小值。 */
         min?: number;
+        /** 允许的最大值。 */
         max?: number;
+        /** 展示给用户的名称，可传入文本或 React 节点。 */
         label?: string;
+        /** 显示颜色，可使用 CSS 颜色值。 */
         color: string;
     }[];
+    /** 当前选中的视觉映射分段。 */
     selectedPieces?: readonly boolean[];
+    /** 切换分段选中状态时调用。 */
     onPieceToggle?: (index: number) => void;
 }
+/** 图表视觉映射组件。 */
 declare function ChartVisualMap({ min, max, colors, x, y, width, height, label, endLabels, indicatorValue, onHoverRange, realtime, svgHandles, orientation, calculable, value, onChange, range, onRangeChange, pieces, selectedPieces, onPieceToggle }: ChartVisualMapProps): react.JSX.Element;
+/** 图表数据缩放的属性配置。 */
 interface ChartDataZoomProps {
+    /** 缩放手柄的显示标签。 */
     handleLabels?: readonly [ReactNode, ReactNode];
+    /** 数据阴影绘制范围。 */
     shadowBounds?: {
+        /** 宽度；数值按像素处理，字符串可使用 CSS 尺寸。 */
         width: number;
+        /** 高度；数值按像素处理，字符串可使用 CSS 尺寸。 */
         height: number;
     };
+    /**
+     * 是否允许平移当前可视范围。
+     * @defaultValue false
+     */
     panEnabled?: boolean;
+    /** 当前值；作为受控属性时，需要在变更回调中同步更新。 */
     value: readonly [number, number];
+    /**
+     * 允许的最小值。
+     * @defaultValue 0
+     */
     min?: number;
+    /**
+     * 允许的最大值。
+     * @defaultValue 100
+     */
     max?: number;
+    /**
+     控件的无障碍名称，供屏幕阅读器识别。
+     * @defaultValue "图表可见范围"
+     */
     ariaLabel?: string;
+    /**
+     组件的水平或垂直排列方向。
+     * @defaultValue "horizontal"
+     */
     orientation?: "horizontal" | "vertical";
+    /**
+     * 缩放控件内的数据概览阴影。
+     * @defaultValue []
+     */
     dataShadow?: readonly number[];
+    /**
+     * 是否显示详细数值。
+     * @defaultValue false
+     */
     showDetail?: boolean;
+    /**
+     * 允许的最小区间跨度。
+     * @defaultValue 1
+     */
     minSpan?: number;
+    /** 将原始值转换为展示文本的函数。 */
     formatter?: (value: number) => ReactNode;
+    /** 值发生变化时调用；参数为新值及类型声明中列出的关联信息。 */
     onChange: (value: [number, number]) => void;
 }
+/** 图表数据缩放组件。 */
 declare function ChartDataZoom({ value, min, max, ariaLabel, orientation, dataShadow, showDetail, minSpan, formatter, onChange, panEnabled, shadowBounds, handleLabels }: ChartDataZoomProps): react.JSX.Element;
+/** 图表时间轴的属性配置。 */
 interface ChartTimelineProps extends Omit<HTMLAttributes<HTMLDivElement>, "onChange"> {
+    /** 绘制或内容渲染器。 */
     renderer?: 'html' | 'nodes';
+    /** 时间轴日期序列。 */
     dates?: readonly string[];
+    /** 横向位置或 X 轴数据值。 */
     x?: number;
+    /** 纵向位置或 Y 轴数据值。 */
     y?: number;
+    /** 宽度；数值按像素处理，字符串可使用 CSS 尺寸。 */
     width?: number;
+    /** 各操作入口的显示或无障碍文案。 */
     labels: readonly string[];
+    /** 当前值；作为受控属性时，需要在变更回调中同步更新。 */
     value: number;
+    /** 值发生变化时调用；参数为新值及类型声明中列出的关联信息。 */
     onChange: (index: number) => void;
+    /**
+     * 是否自动播放时间轴。
+     * @defaultValue false
+     */
     autoPlay?: boolean;
+    /**
+     * 自动播放切换的时间间隔。
+     * @defaultValue 2000
+     */
     playInterval?: number;
+    /**
+     * 是否循环播放。
+     * @defaultValue true
+     */
     loop?: boolean;
 }
+/** 图表时间轴组件。 */
 declare function ChartTimeline({ labels, value, onChange, autoPlay, playInterval, loop, className, ...props }: ChartTimelineProps): react.JSX.Element;
+/** 按数据索引循环读取调色板颜色。 */
 declare function chartColor(index: number, palette?: readonly string[]): string;
+/** 将图表数字转换为适合标签展示的简洁文本。 */
 declare function formatChartNumber(value: number): string;
+/** 根据数据计算包含整齐刻度的数据范围，可配置是否包含零和分段数量。 */
 declare function niceChartDomain(values: readonly number[], includeZero?: boolean, splitNumber?: number, preferredSteps?: readonly number[]): [number, number, number];
+/** 根据数据范围生成坐标轴刻度值。 */
 declare function chartTicks(domain: readonly [number, number, number]): number[];
+/** 将数据值从输入范围线性映射到输出范围。 */
 declare function linearScale(value: number, domain: readonly [number, number], range: readonly [number, number]): number;
 
+/** 根据坐标点集合生成平滑 SVG 路径。 */
 declare function smoothSvgPath(points: readonly (readonly [number, number])[]): string;
 
+/** 分时图的属性配置。 */
 interface LineShareChartProps extends Omit<SiaChartProps, 'children'> {
+    /** 用于渲染的数据集合。 */
     data: readonly {
+        /** 名称或字段标识。 */
         name: string;
+        /** 当前值；作为受控属性时，需要在变更回调中同步更新。 */
         value: number;
     }[];
+    /**
+     * 线条颜色。
+     * @defaultValue '#2ec7c9'
+     */
     lineColor?: string;
+    /**
+     * 分时图或共享数据区域的颜色。
+     * @defaultValue '#b6a2de'
+     */
     shareColor?: string;
 }
 /** A shifted area line and a masked share ring retain distinct displayed/raw values. */
 declare const LineShareChart: react.ForwardRefExoticComponent<LineShareChartProps & react.RefAttributes<SiaChartRef>>;
 
+/** 图表中可转移数据值的定位信息。 */
 interface ChartValueAddress {
+    /** 关联的图表实例或配置。 */
     chart: string;
+    /** 图表数据系列。 */
     series: number;
+    /** 项目在当前集合中的索引，从 0 开始。 */
     index: number;
 }
+/** 图表之间转移数据值的处理函数。 */
 type ChartValueTransferHandler = (source: ChartValueAddress, target: ChartValueAddress) => boolean;
+/** 组合图表参与数据转移的通信通道。 */
 interface ChartValueChannel {
+    /** 唯一标识，用于关联实例或插件。 */
     id: string;
+    /** 图表数据系列。 */
     series: readonly {
+        /** 名称或字段标识。 */
         name: string;
+        /** 用于渲染的数据集合。 */
         data: readonly (number | null)[];
     }[];
+    /** 是否将数据值限制为非负数。 */
     nonNegative?: boolean;
 }
 /** Validate and calculate both sides before publishing either chart's new state. */
 declare function transferCompositeValue(channels: readonly ChartValueChannel[], source: ChartValueAddress, target: ChartValueAddress): {
     series: (Omit<{
+        /** 名称或字段标识。 */
         name: string;
+        /** 用于渲染的数据集合。 */
         data: readonly (number | null)[];
     }, "data"> & {
         data: (number | null)[];
     })[];
+    /** 唯一标识，用于关联实例或插件。 */
     id: string;
+    /** 是否将数据值限制为非负数。 */
     nonNegative?: boolean;
 }[];
 
+/** 图表数据值暂存区的属性配置。 */
 interface ChartValueIslandProps {
+    /** 名称或字段标识。 */
     name: string;
+    /** 当前值；作为受控属性时，需要在变更回调中同步更新。 */
     value: number;
+    /** 横向位置或 X 轴数据值。 */
     x: number;
+    /** 纵向位置或 Y 轴数据值。 */
     y: number;
+    /**
+     * 显示颜色，可使用 CSS 颜色值。
+     * @defaultValue '#2ec7c9'
+     */
     color?: string;
+    /** 拖放完成时调用，提供拖拽源和目标位置。 */
     onDrop: (target: ChartValueAddress | null, point: readonly [number, number]) => void;
+    /**
+     * 根据当前上下文解析目标图表或数据位置。
+     * @defaultValue findCompositeValueTarget
+     */
     resolveTarget?: (element: SVGGElement, x: number, y: number) => ChartValueAddress | null;
 }
 /** SVG island representing a value already removed from its source series. */
@@ -430,112 +1000,208 @@ declare function ChartValueIsland({ name, value, x, y, color, onDrop, resolveTar
 
 /** Stacked chart panels retain their actual document positions and inter-panel gaps. */
 declare function serializeChartStack(host: HTMLElement): string | null;
+/** 将组合图表的 SVG 内容转换并下载为图片。 */
 declare function saveCompositeImage(source: string | null, filename?: string): Promise<void>;
 
 /** Finite data extent plus proportional padding, before nice-tick rounding. */
 declare function paddedValueExtent(values: readonly number[], padding?: number): readonly [number, number];
 
+/** 图表数据编辑器的属性配置。 */
 interface ChartDataEditorProps<T extends number | null = number> {
+    /** 图表数据系列。 */
     series: readonly {
+        /** 名称或字段标识。 */
         name: string;
+        /** 用于渲染的数据集合。 */
         data: readonly T[];
     }[];
+    /** 用户应用修改时调用。 */
     onApply: (values: T[][]) => void;
+    /**
+     * 是否允许空值。
+     * @defaultValue false
+     */
     allowNull?: boolean;
+    /**
+     * 是否只读，禁止编辑数据。
+     * @defaultValue false
+     */
     readOnly?: boolean;
 }
 /** Numeric data editor. JSON is parsed as data, never evaluated as JavaScript. */
 declare function ChartDataEditor<T extends number | null = number>({ series, onApply, readOnly, allowNull }: ChartDataEditorProps<T>): react.JSX.Element;
 
+/** 二维坐标图中的一个数据点。 */
 type XYPoint = readonly [number, number, number?];
+/** XY的数据系列。 */
 interface XYSeries {
+    /** 名称或字段标识。 */
     name: string;
+    /** 用于渲染的数据集合。 */
     data: readonly XYPoint[];
+    /** 连接数据点的曲线类型。 */
     curve?: "smooth" | "straight";
+    /** 数据点符号的半径。 */
     symbolRadius?: number | ((point: XYPoint) => number);
+    /** 显示颜色，可使用 CSS 颜色值。 */
     color?: string;
+    /** 图形几何形状及布局参数。 */
     geometry?: "line" | "bar";
+    /** 柱状图的排列方向。 */
     barOrientation?: "vertical" | "horizontal";
+    /** 柱形的尺寸。 */
     barSize?: number;
+    /** 统计信息或统计标记配置。 */
     statistics?: boolean;
 }
+/** 二维坐标图的属性配置。 */
 interface XYChartProps extends Omit<SiaChartProps, "children"> {
+    /** 图表数据系列。 */
     series: readonly XYSeries[];
+    /** X 轴的数据范围。 */
     xDomain?: readonly [number, number, number];
+    /** Y 轴的数据范围。 */
     yDomain?: readonly [number, number, number];
+    /** 动画当前进度，通常为 0 到 1。 */
     animationProgress?: number;
+    /**
+     * 是否允许通过拖拽图形修改数据。
+     * @defaultValue false
+     */
     calculable?: boolean;
+    /**
+     * X 轴类型。
+     * @defaultValue "value"
+     */
     xAxisType?: "value" | "time";
+    /** X 轴数值的格式化函数。 */
     xFormatter?: (value: number) => string;
+    /** 提示框内容的格式化函数。 */
     tooltipFormatter?: (point: XYPoint, series: XYSeries) => ReactNode;
+    /**
+     * 数据区域缩放配置。
+     * @defaultValue false
+     */
     dataZoom?: boolean;
+    /**
+     * 初始缩放范围或缩放级别。
+     * @defaultValue [0,100]
+     */
     defaultZoom?: readonly [number, number];
+    /** 缩放范围变化时调用。 */
     onZoomChange?: (value: readonly [number, number]) => void;
+    /** 数据被交互修改后调用。 */
     onDataChange?: (series: readonly XYSeries[]) => void;
 }
 /** Two genuinely numeric axes; bar direction belongs to the series, not the chart. */
 declare const XYChart: react.ForwardRefExoticComponent<XYChartProps & react.RefAttributes<SiaChartRef>>;
 
+/** 地图宿主支持订阅的视图事件名称。 */
 type MapOverlayEvent = 'moving' | 'moveend' | 'zoomend' | 'resize';
+/** 地图宿主当前的尺寸、中心和缩放状态快照。 */
 interface MapOverlaySnapshot {
+    /** 宽度；数值按像素处理，字符串可使用 CSS 尺寸。 */
     width: number;
+    /** 高度；数值按像素处理，字符串可使用 CSS 尺寸。 */
     height: number;
+    /** 将数据或地理坐标投影为绘图坐标。 */
     project: (coordinate: readonly [number, number]) => readonly [number, number];
+    /** 相对于默认位置的偏移。 */
     offset?: readonly [number, number];
 }
 /** A host adapter owns only the map instance it creates, never a shared map. */
 interface MapOverlayHost {
+    /** 读取地图宿主的当前视图快照。 */
     snapshot: () => MapOverlaySnapshot;
+    /** 订阅状态变化；返回的函数用于取消订阅。 */
     subscribe: (event: MapOverlayEvent, listener: () => void) => () => void;
+    /** 销毁地图宿主并释放事件监听及相关资源。 */
     destroy: () => void;
 }
 
+/** 地图叠加图层的属性配置。 */
 interface ChartMapOverlayProps {
     /** Keep this factory stable. It must return an adapter for a newly owned host instance. */
     createHost: (element: HTMLDivElement) => MapOverlayHost;
+    /** 叠加图层渲染函数，接收地图宿主和视图上下文。 */
     children: (snapshot: MapOverlaySnapshot) => ReactNode;
+    /** 附加到组件根节点的 CSS 类名。 */
     className?: string;
+    /** 组件根节点的内联样式。 */
     style?: CSSProperties;
+    /**
+     控件的无障碍名称，供屏幕阅读器识别。
+     * @defaultValue '地图叠加图表'
+     */
     ariaLabel?: string;
+    /** 操作发生错误时调用，可用于显示业务错误提示。 */
     onError?: (error: unknown) => void;
 }
 /** Mounts the external base map separately from the Sia chart's transparent overlay. */
 declare function ChartMapOverlay({ createHost, children, className, style, ariaLabel, onError }: ChartMapOverlayProps): react.JSX.Element;
 
+/** 百度地图经纬度坐标点。 */
 interface BaiduMapPoint {
+    /** 地理经度。 */
     lng: number;
+    /** 地理纬度。 */
     lat: number;
 }
+/** 地图宿主需要的百度地图实例能力，用于视图同步和坐标投影。 */
 interface BaiduMapInstance {
+    /** 设置地图中心和缩放级别。 */
     centerAndZoom: (point: BaiduMapPoint, zoom: number) => void;
+    /** 启用鼠标滚轮缩放。 */
     enableScrollWheelZoom: () => void;
+    /** 禁用鼠标滚轮缩放。 */
     disableScrollWheelZoom: () => void;
+    /** 禁用地图拖拽。 */
     disableDragging: () => void;
+    /** 禁用地图自动尺寸调整。 */
     disableAutoResize: () => void;
+    /** 清除地图覆盖物。 */
     clearOverlays: () => void;
+    /** 读取容器或地图尺寸。 */
     getSize: () => {
+        /** 宽度；数值按像素处理，字符串可使用 CSS 尺寸。 */
         width: number;
+        /** 高度；数值按像素处理，字符串可使用 CSS 尺寸。 */
         height: number;
     };
+    /** 将地理坐标转换为屏幕像素坐标。 */
     pointToPixel: (point: BaiduMapPoint) => {
+        /** 横向位置或 X 轴数据值。 */
         x: number;
+        /** 纵向位置或 Y 轴数据值。 */
         y: number;
     };
+    /** 设置地图主题样式。 */
     setMapStyle: (style: {
+        /** 地图 SDK 使用的 JSON 样式规则。 */
         styleJson: readonly unknown[];
     }) => void;
+    /** 注册指定事件的监听函数。 */
     addEventListener: (event: string, listener: () => void) => void;
+    /** 移除指定事件的监听函数。 */
     removeEventListener: (event: string, listener: () => void) => void;
 }
+/** 百度地图 SDK 的构造函数入口集合。 */
 interface BaiduMapNamespace {
+    /** 地图构造函数，由接入的地图 SDK 提供。 */
     Map: new (element: HTMLElement, options: {
+        /** 是否启用地图点击交互。 */
         enableMapClick: boolean;
     }) => BaiduMapInstance;
+    /** 地理坐标点构造函数。 */
     Point: new (longitude: number, latitude: number) => BaiduMapPoint;
 }
+/** BaiduMapHost的配置选项。 */
 interface BaiduMapHostOptions {
+    /** 中心位置。 */
     center: readonly [number, number];
+    /** 缩放级别或缩放范围。 */
     zoom: number;
+    /** 地图 SDK 使用的 JSON 样式规则。 */
     styleJson?: readonly unknown[];
     /** Optional SDK-version-specific cleanup. v2 has no documented Map.destroy API. */
     releaseMap?: (map: BaiduMapInstance) => void;
@@ -543,17 +1209,42 @@ interface BaiduMapHostOptions {
 /** Uses a caller-provided SDK; never loads scripts, keys or a chart runtime. */
 declare function createBaiduMapHost(element: HTMLElement, sdk: BaiduMapNamespace, options: BaiduMapHostOptions): MapOverlayHost;
 
+/** ChartPulseRing的属性配置。 */
 interface ChartPulseRingProps {
+    /** 中心位置。 */
     center: readonly [number, number];
+    /** 图形半径或圆角配置。 */
     radius: number;
+    /**
+     * 缩放后的尺寸比例。
+     * @defaultValue 2
+     */
     scaleSize?: number;
+    /**
+     * 显示颜色，可使用 CSS 颜色值。
+     * @defaultValue 'gold'
+     */
     color?: string;
+    /**
+     * 阴影模糊半径。
+     * @defaultValue 10
+     */
     shadowBlur?: number;
+    /**
+     * 周期动画的周期时长。
+     * @defaultValue 15
+     */
     period?: number;
+    /** 当前进度。 */
     progress?: number;
+    /**
+     * 是否启用该功能。
+     * @defaultValue true
+     */
     enabled?: boolean;
 }
 
+/** 混合图中柱形与柱组的间隔配置。 */
 interface MixedBarSpacing {
     /** Fraction of each category band reserved between category groups. */
     categoryGap: number;
@@ -563,8 +1254,11 @@ interface MixedBarSpacing {
     pixelAlign?: boolean;
 }
 
+/** MixedValueDomain的配置选项。 */
 interface MixedValueDomainOptions {
+    /** 轴端是否保留间隔，或两端间隔的配置。 */
     boundaryGap?: readonly [number, number];
+    /** 坐标轴或仪表盘的分段数量。 */
     splitNumber?: number;
     /** Select a readable step near this count without forcing exactly that many sections. */
     targetSplitNumber?: number;
@@ -572,133 +1266,232 @@ interface MixedValueDomainOptions {
     preferredSteps?: readonly number[];
 }
 
+/** 使用 Canvas 批量绘制的地图点分组。 */
 interface LargeMapPointCanvasGroup {
+    /** 名称或字段标识。 */
     name: string;
+    /** 显示颜色，可使用 CSS 颜色值。 */
     color: string;
+    /** 组件尺寸；用于调整控件高度、字号和间距。 */
     size: number;
+    /** 数据点或节点使用的图形符号。 */
     symbol: 'rect' | 'diamond';
+    /** 数据点集合。 */
     points: readonly (readonly [number, number])[];
 }
 
+/** 矩阵弦图节点、弦带和刻度的外观配置。 */
 interface MatrixChordAppearance {
+    /** 边框颜色。 */
     borderColor?: string;
+    /** 边框线宽。 */
     borderWidth?: number;
+    /** 悬停状态的边框颜色。 */
     hoverBorderColor?: string;
+    /** 悬停状态的边框宽度。 */
     hoverBorderWidth?: number;
+    /** 标签与关联图形的间距。 */
     labelDistance?: number;
+    /** 在指定文本范围显示错误、警告或信息波浪线 */
     markers?: readonly {
+        /** 名称或字段标识。 */
         name: string;
+        /** 该项目对应的数据值，用于标识、选择或计算。 */
         value: number;
+        /** 横向位置或 X 轴数据值。 */
         x: number;
+        /** 纵向位置或 Y 轴数据值。 */
         y: number;
+        /** 组件尺寸；用于调整控件高度、字号和间距。 */
         size: number;
+        /** 显示颜色，可使用 CSS 颜色值。 */
         color?: string;
     }[];
 }
 
 /** Parameters of the native solver, not a promise of ECharts physics equivalence. */
 interface ForceLayoutOptions {
+    /** 每帧执行的布局迭代次数。 */
     stepsPerFrame?: number;
+    /** 布局模型或数据模型。 */
     model?: 'native' | 'legacy';
+    /** 宽度；数值按像素处理，字符串可使用 CSS 尺寸。 */
     width?: number;
+    /** 高度；数值按像素处理，字符串可使用 CSS 尺寸。 */
     height?: number;
+    /** 力导向布局的冷却系数。 */
     coolDown?: number;
+    /** 允许的最小半径。 */
     minRadius?: number;
+    /** 允许的最大半径。 */
     maxRadius?: number;
+    /** 随机布局的种子，用于复现相同布局。 */
     seed?: number;
+    /** 中心位置。 */
     center?: {
+        /** 横向位置或 X 轴数据值。 */
         x: number;
+        /** 纵向位置或 Y 轴数据值。 */
         y: number;
     };
+    /** 布局引力强度。 */
     gravity?: number;
+    /** 布局缩放系数。 */
     scaling?: number;
+    /** 布局中的目标连线距离。 */
     linkDistance?: number;
+    /** 布局迭代次数。 */
     iterations?: number;
+    /** 是否根据连线权重调整布局。 */
     weightedLinks?: boolean;
+    /** 参与布局或渲染的最大节点数。 */
     maxNodes?: number;
 }
 
+/** 热力渐变中的一个颜色停靠点。 */
 interface HeatGradientStop {
+    /** 相对于默认位置的偏移。 */
     offset: number;
+    /** 显示颜色，可使用 CSS 颜色值。 */
     color: readonly [number, number, number];
 }
+/** HeatRaster的配置选项。 */
 interface HeatRasterOptions {
+    /** 图形半径或圆角配置。 */
     radius?: number;
+    /** 模糊半径。 */
     blur?: number;
+    /** 最小透明度。 */
     minAlpha?: number;
+    /** 将数据值映射到显示尺寸的比例尺。 */
     valueScale?: number;
+    /** 透明度，0 为完全透明，1 为完全不透明。 */
     opacity?: number;
+    /** 渐变填充配置。 */
     gradient?: readonly HeatGradientStop[];
 }
 
+/** 词云布局使用的可放置区域边界。 */
 interface CloudBounds {
+    /** 横向位置或 X 轴数据值。 */
     x: number;
+    /** 纵向位置或 Y 轴数据值。 */
     y: number;
+    /** 宽度；数值按像素处理，字符串可使用 CSS 尺寸。 */
     width: number;
+    /** 高度；数值按像素处理，字符串可使用 CSS 尺寸。 */
     height: number;
 }
 
+/** 树图节点及连线的显示样式。 */
 interface TreeItemStyle {
+    /** 显示颜色，可使用 CSS 颜色值。 */
     color?: string;
+    /** 边框颜色。 */
     borderColor?: string;
+    /** 边框线宽。 */
     borderWidth?: number;
+    /** 框选工具的选择形状或方式。 */
     brushType?: 'fill' | 'stroke' | 'both';
+    /** 展示给用户的名称，可传入文本或 React 节点。 */
     label?: {
+        /** 是否显示该功能。 */
         show?: boolean;
+        /** 显示位置或定位配置。 */
         position?: 'inside' | 'right' | 'left' | 'top' | 'bottom';
+        /** 将原始值转换为展示文本的函数。 */
         formatter?: string;
+        /** 显示颜色，可使用 CSS 颜色值。 */
         color?: string;
+        /** 文字大小，单位为像素。 */
         fontSize?: number;
+        /** 文字粗细，可使用数字或 CSS 字重名称。 */
         fontWeight?: string | number;
     };
 }
 
 /** Per-region overrides are resolved independently for normal and emphasized states. */
 interface MapRegionAppearance {
+    /** 地图区域样式。 */
     regionStyle?: CSSProperties;
+    /** 地图区域高亮样式。 */
     emphasisRegionStyle?: CSSProperties;
+    /** 标签文字样式。 */
     labelStyle?: CSSProperties;
+    /** 高亮状态的标签样式。 */
     emphasisLabelStyle?: CSSProperties;
+    /** 是否显示数据标签。 */
     showLabels?: boolean;
+    /** 高亮时是否显示标签集合。 */
     showEmphasisLabels?: boolean;
 }
 
+/** 路径捆绑算法使用的二维坐标点。 */
 type BundlePoint = readonly [number, number];
+/** 参与路径捆绑的连线定义。 */
 interface BundleEdge {
+    /** 触发来源，用于区分不同入口的操作。 */
     source: BundlePoint;
+    /** 关联的目标元素或获取目标元素的函数。 */
     target: BundlePoint;
 }
 
+/** 地图捆绑路径数据及其视觉和动画配置。 */
 interface BundledMapLines {
+    /** 节点之间的边集合。 */
     edges: readonly BundleEdge[];
+    /** 数据点集合。 */
     points?: readonly BundlePoint[];
+    /** 曲线平滑程度。 */
     smoothness?: number;
+    /** 显示颜色，可使用 CSS 颜色值。 */
     color?: string;
+    /** 透明度，0 为完全透明，1 为完全不透明。 */
     opacity?: number;
+    /** 线条粗细。 */
     lineWidth?: number;
+    /** 数据点颜色。 */
     pointColor?: string;
+    /** 数据点半径。 */
     pointRadius?: number;
+    /** 滚动或淡入效果 */
     effect?: {
+        /** 周期动画的周期时长。 */
         period?: number;
+        /** 显示颜色，可使用 CSS 颜色值。 */
         color?: string;
+        /** 图形半径或圆角配置。 */
         radius?: number;
+        /** 阴影模糊半径。 */
         shadowBlur?: number;
+        /** 阴影颜色。 */
         shadowColor?: string;
+        /** 透明度或布局迭代的衰减参数。 */
         alpha?: number;
     };
 }
 
+/** 特殊地理区域的独立位置和缩放配置。 */
 type MapSpecialArea = {
+    /** 距左侧的位置或间距。 */
     left: number;
+    /** 距顶部的位置或间距。 */
     top: number;
+    /** 宽度；数值按像素处理，字符串可使用 CSS 尺寸。 */
     width: number;
+    /** 高度；数值按像素处理，字符串可使用 CSS 尺寸。 */
     height: number;
 };
 
+/** 矩形树图布局计算得到的矩形边界。 */
 interface TreemapLayoutBox {
+    /** 横向位置或 X 轴数据值。 */
     x: number;
+    /** 纵向位置或 Y 轴数据值。 */
     y: number;
+    /** 宽度；数值按像素处理，字符串可使用 CSS 尺寸。 */
     width: number;
+    /** 高度；数值按像素处理，字符串可使用 CSS 尺寸。 */
     height: number;
 }
 
@@ -739,1321 +1532,3026 @@ declare function useBarValueTransfer(series: readonly BarSeries[], initial: read
     reset: () => void;
 };
 
+/** Chart的数据系列。 */
 interface ChartSeries {
+    /** 名称或字段标识。 */
     name: string;
+    /** 用于渲染的数据集合。 */
     data: readonly number[];
+    /** 显示颜色，可使用 CSS 颜色值。 */
     color?: string;
 }
+/** CartesianChart的属性配置。 */
 interface CartesianChartProps extends Omit<SiaChartProps, "children" | "empty"> {
+    /** 类目或数据分组集合。 */
     categories: readonly string[];
+    /** 图表数据系列。 */
     series: readonly ChartSeries[];
+    /** 是否显示图例。 */
     showLegend?: boolean;
+    /** 是否允许通过图例切换系列显示。 */
     legendInteractive?: boolean;
+    /** 图例项目的选中状态。 */
     legendSelected?: Readonly<Record<string, boolean>>;
+    /** 图例选中状态变化时调用。 */
     onLegendSelectionChange?: (selected: Record<string, boolean>) => void;
+    /** 将数值格式化为显示文本的函数。 */
     valueFormatter?: (value: number) => ReactNode;
+    /** 点击图表数据项时调用。 */
     onDataClick?: (info: ChartDataClickInfo<number>) => void;
 }
+/** 折线图上的一个数据点。 */
 type LinePoint = readonly [number | string | Date, number];
+/** Line的数据系列。 */
 interface LineSeries extends Omit<ChartSeries, "data"> {
+    /** 标签文字样式。 */
     labelStyle?: CSSProperties;
+    /** 高亮状态的标签样式。 */
     emphasisLabelStyle?: CSSProperties;
+    /** 高亮时是否显示标签集合。 */
     showEmphasisLabels?: boolean;
+    /** 标签文本格式化函数。 */
     labelFormatter?: (value: number, category: string, index: number) => ReactNode;
+    /** 高亮标签格式化函数。 */
     emphasisLabelFormatter?: (value: number, category: string, index: number) => ReactNode;
+    /** 按数据点设置的样式集合。 */
     pointStyles?: readonly {
+        /** 显示颜色，可使用 CSS 颜色值。 */
         color?: string;
+        /** 高亮状态的颜色。 */
         emphasisColor?: string;
+        /** 数据符号尺寸。 */
         symbolSize?: number;
+        /** 数据点或节点使用的图形符号。 */
         symbol?: LineSeries['symbol'];
+        /** 数据符号使用的图片。 */
         symbolImage?: string;
+        /** 数据符号旋转角度。 */
         symbolRotate?: number;
+        /** 标签显示位置。 */
         labelPosition?: 'inside' | 'top';
+        /** 高亮状态的标签位置。 */
         emphasisLabelPosition?: 'inside' | 'top';
+        /** 是否显示标签文本。 */
         showLabel?: boolean;
+        /** 高亮时是否显示标签。 */
         showEmphasisLabel?: boolean;
+        /** 标签文字样式。 */
         labelStyle?: CSSProperties;
+        /** 高亮状态的标签样式。 */
         emphasisLabelStyle?: CSSProperties;
     }[];
+    /** 高亮状态的颜色。 */
     emphasisColor?: string;
+    /** 图形填充渐变配置。 */
     fillGradient?: BarLinearGradient;
+    /** 面积区域的填充渐变。 */
     areaGradient?: BarLinearGradient;
+    /** 线条阴影配置。 */
     lineShadow?: {
+        /** 显示颜色，可使用 CSS 颜色值。 */
         color: string;
+        /** 模糊半径。 */
         blur: number;
+        /** 水平方向的偏移量。 */
         offsetX?: number;
+        /** 垂直方向的偏移量。 */
         offsetY?: number;
     };
+    /** 统计标线配置。 */
     statisticLines?: readonly ('average' | 'min' | 'max')[];
+    /** 用于渲染的数据集合。 */
     data: readonly (number | LinePoint)[];
+    /** 堆叠分组标识；同标识的数据系列参与同组堆叠。 */
     stack?: string;
+    /** 连接数据点的曲线类型。 */
     curve?: "straight" | "smooth" | "step";
+    /** 面积区域填充配置。 */
     area?: boolean;
+    /** 是否显示数据点。 */
     showPoints?: boolean;
+    /** 是否显示平均值标记。 */
     markAverage?: boolean;
+    /** 是否显示最小值标记。 */
     markMin?: boolean;
+    /** 是否显示最大值标记。 */
     markMax?: boolean;
+    /** 是否显示数据标签。 */
     showLabels?: boolean;
+    /** 线条样式。 */
     lineStyle?: "solid" | "dashed" | "dotted";
+    /** 线条粗细。 */
     lineWidth?: number;
+    /** 数据点或节点使用的图形符号。 */
     symbol?: "circle" | "square" | "diamond" | "none" | "star" | "star6" | "heart" | "emptyHeart" | "droplet" | "pin" | "emptyPin" | "arrow" | "emptyCircle" | "image";
+    /** 数据符号使用的图片。 */
     symbolImage?: string;
+    /** 数据符号旋转角度。 */
     symbolRotate?: number;
+    /** 数据符号尺寸。 */
     symbolSize?: number;
+    /** 数据点是否使用空心符号。 */
     hollowSymbol?: boolean;
+    /** 标记点配置集合。 */
     markPoints?: readonly {
+        /** 名称或字段标识。 */
         name: string;
+        /** 项目在当前集合中的索引，从 0 开始。 */
         index: number;
+        /** 该项目对应的数据值，用于标识、选择或计算。 */
         value: number;
+        /** 展示给用户的名称，可传入文本或 React 节点。 */
         label?: string;
     }[];
 }
+/** 折线图的属性配置。 */
 interface LineChartProps extends Omit<CartesianChartProps, "series"> {
+    /**
+     * 数据拖拽计算的处理模式。
+     * @defaultValue 'resize'
+     */
     calculableMode?: 'resize' | 'transfer';
+    /** 图表间数据转移失败时调用。 */
     onTransferError?: (message: string) => void;
+    /** 绘图区的边距和布局配置。 */
     grid?: {
+        /** 距左侧的位置或间距。 */
         left?: number;
+        /** 距顶部的位置或间距。 */
         top?: number;
+        /** 距右侧的位置或间距。 */
         right?: number;
+        /** 距底部的位置或间距。 */
         bottom?: number;
     };
     /** Shared value-transfer controller for composed chart mode switches. */
     valueTransfer?: ReturnType<typeof useBarValueTransfer>;
+    /**
+     * 类目标签显示间隔。
+     * @defaultValue 0
+     */
     categoryLabelInterval?: number | 'auto';
+    /**
+     * 轴端是否保留间隔，或两端间隔的配置。
+     * @defaultValue false
+     */
     boundaryGap?: boolean;
+    /**
+     * 是否显示类目轴分隔线。
+     * @defaultValue true
+     */
     showCategorySplitLine?: boolean;
+    /** 类目轴名称。 */
     categoryAxisName?: string;
+    /** 数值轴名称。 */
     valueAxisName?: string;
+    /** 图例布局配置。 */
     legendLayout?: {
+        /** 横向位置或 X 轴数据值。 */
         x?: number;
+        /** 纵向位置或 Y 轴数据值。 */
         y?: number;
+        /** 交叉轴对齐 */
         align?: "start" | "center" | "end";
     };
+    /**
+     * 对数轴使用的底数。
+     * @defaultValue 10
+     */
     logBase?: number;
+    /**
+     * 对数刻度的指数步长。
+     * @defaultValue 1
+     */
     logExponentStep?: number;
+    /**
+     * 图形外观配置。
+     * @defaultValue "sia"
+     */
     appearance?: "sia" | "macarons";
+    /** 动画当前进度，通常为 0 到 1。 */
     animationProgress?: number;
+    /**
+     * 数据更新动画的持续时间。
+     * @defaultValue 500
+     */
     animationDurationUpdate?: number;
+    /** 数值轴的数据范围。 */
     valueDomain?: readonly [number, number, number];
+    /** 坐标轴标签格式化函数。 */
     axisLabelFormatter?: (value: number) => string;
+    /** 图表数据系列。 */
     series: readonly LineSeries[];
+    /**
+     * 是否堆叠展示数据系列。
+     * @defaultValue false
+     */
     stacked?: boolean;
+    /**
+     组件的水平或垂直排列方向。
+     * @defaultValue "vertical"
+     */
     orientation?: "vertical" | "horizontal";
+    /**
+     * X 轴类型。
+     * @defaultValue "category"
+     */
     xAxisType?: "category" | "value" | "time";
+    /**
+     * 数值轴类型。
+     * @defaultValue "value"
+     */
     valueAxisType?: "value" | "log";
+    /**
+     * 是否反转数值轴。
+     * @defaultValue false
+     */
     valueAxisInverse?: boolean;
+    /**
+     * 提示框按数据项还是坐标轴触发。
+     * @defaultValue "item"
+     */
     tooltipTrigger?: "item" | "axis";
+    /**
+     * 数据区域缩放配置。
+     * @defaultValue false
+     */
     dataZoom?: boolean;
     /** Percentage windows can address array slices rather than point-to-point distances. */
     zoomIndexMode?: 'points' | 'slice';
+    /**
+     * 缩放控件的位置。
+     * @defaultValue 'bottom'
+     */
     zoomPosition?: 'top' | 'bottom';
+    /** 缩放控件的布局边界。 */
     zoomControlBounds?: {
+        /** 横向位置或 X 轴数据值。 */
         x: number;
+        /** 纵向位置或 Y 轴数据值。 */
         y: number;
+        /** 宽度；数值按像素处理，字符串可使用 CSS 尺寸。 */
         width: number;
+        /** 高度；数值按像素处理，字符串可使用 CSS 尺寸。 */
         height: number;
     };
+    /**
+     * 是否允许拖动缩放范围进行平移。
+     * @defaultValue false
+     */
     zoomPan?: boolean;
+    /**
+     * 缩放框选区域的形状。
+     * @defaultValue 'band'
+     */
     zoomSelectionShape?: 'band' | 'rectangle';
+    /** 缩放框选区域的样式。 */
     zoomSelectionStyle?: CSSProperties;
+    /** 可接受的最小框选尺寸。 */
     zoomMinSelectionSize?: readonly [number, number];
+    /**
+     * 是否允许通过拖拽图形修改数据。
+     * @defaultValue false
+     */
     calculable?: boolean;
+    /** 缩放级别或缩放范围。 */
     zoom?: readonly [number, number];
+    /** 初始缩放范围或缩放级别。 */
     defaultZoom?: readonly [number, number];
+    /** 缩放范围变化时调用。 */
     onZoomChange?: (value: [number, number]) => void;
+    /** 数据被交互修改后调用。 */
     onDataChange?: (series: readonly LineSeries[]) => void;
 }
+/** 折线图组件。 */
 declare const LineChart: react.ForwardRefExoticComponent<LineChartProps & react.RefAttributes<SiaChartRef>>;
+/** 柱形线性渐变的方向及颜色停靠点配置。 */
 interface BarLinearGradient {
+    /** 范围起点。 */
     start: readonly [number, number];
+    /** 范围终点。 */
     end: readonly [number, number];
+    /** 渐变颜色停靠点集合。 */
     stops: readonly {
+        /** 相对于默认位置的偏移。 */
         offset: number;
+        /** 显示颜色，可使用 CSS 颜色值。 */
         color: string;
     }[];
 }
+/** Bar的单条数据。 */
 interface BarDatum {
     /** Radius used by the corresponding point after switching to a line chart. */
     symbolSize?: number;
+    /** 是否显示标签文本。 */
     showLabel?: boolean;
+    /** 高亮时是否显示标签。 */
     showEmphasisLabel?: boolean;
+    /** 标签文字样式。 */
     labelStyle?: CSSProperties;
+    /** 高亮状态的标签样式。 */
     emphasisLabelStyle?: CSSProperties;
+    /** 高亮状态的标签位置。 */
     emphasisLabelPosition?: BarDatum['labelPosition'];
+    /** 图形填充渐变配置。 */
     fillGradient?: BarLinearGradient;
+    /** 高亮状态的填充渐变。 */
     emphasisFillGradient?: BarLinearGradient;
+    /** 高亮状态的颜色。 */
     emphasisColor?: string;
+    /** 高亮状态的边框颜色。 */
     emphasisBorderColor?: string;
+    /** 高亮状态的边框宽度。 */
     emphasisBorderWidth?: number;
+    /** 该项目对应的数据值，用于标识、选择或计算。 */
     value: number;
+    /** 范围起点。 */
     start?: number;
+    /** 显示颜色，可使用 CSS 颜色值。 */
     color?: string;
+    /** 透明度，0 为完全透明，1 为完全不透明。 */
     opacity?: number;
+    /** 展示给用户的名称，可传入文本或 React 节点。 */
     label?: ReactNode;
+    /** 是否隐藏此项。 */
     hidden?: boolean;
+    /** 边框颜色。 */
     borderColor?: string;
+    /** 边框线宽。 */
     borderWidth?: number;
+    /** 标签显示位置。 */
     labelPosition?: "top" | "bottom" | "left" | "right" | "inside" | "insideTop" | "insideRight" | "insideLeft";
 }
+/** Bar的数据系列。 */
 interface BarSeries extends Omit<ChartSeries, "data"> {
+    /** 统计标线配置。 */
     statisticLines?: readonly ('average' | 'min' | 'max')[];
+    /** 高亮时是否显示标签集合。 */
     showEmphasisLabels?: boolean;
+    /** 标签文字样式。 */
     labelStyle?: CSSProperties;
+    /** 高亮状态的标签样式。 */
     emphasisLabelStyle?: CSSProperties;
+    /** 高亮状态的标签位置。 */
     emphasisLabelPosition?: BarDatum['labelPosition'];
+    /** 高亮标签格式化函数。 */
     emphasisLabelFormatter?: (value: number, category: string, index: number) => ReactNode;
+    /** 图形填充渐变配置。 */
     fillGradient?: BarLinearGradient;
+    /** 高亮状态的填充渐变。 */
     emphasisFillGradient?: BarLinearGradient;
+    /** 高亮状态的颜色。 */
     emphasisColor?: string;
+    /** 高亮状态的边框颜色。 */
     emphasisBorderColor?: string;
+    /** 高亮状态的边框宽度。 */
     emphasisBorderWidth?: number;
     /** Share a category slot without stacking values (overlapping comparison bars). */
     overlayGroup?: string;
+    /** 用于渲染的数据集合。 */
     data: readonly (number | BarDatum)[];
+    /** 图形半径或圆角配置。 */
     radius?: number;
+    /** 堆叠分组标识；同标识的数据系列参与同组堆叠。 */
     stack?: string;
+    /** 是否显示数据标签。 */
     showLabels?: boolean;
+    /** 透明度，0 为完全透明，1 为完全不透明。 */
     opacity?: number;
+    /** 柱形宽度。 */
     barWidth?: number;
+    /** 是否显示平均值标记。 */
     markAverage?: boolean;
+    /** 是否显示最小值标记。 */
     markMin?: boolean;
+    /** 是否显示最大值标记。 */
     markMax?: boolean;
+    /** 是否将该系列显示在图例中。 */
     showInLegend?: boolean;
+    /** 边框颜色。 */
     borderColor?: string;
+    /** 边框线宽。 */
     borderWidth?: number;
+    /** 标签文字颜色。 */
     labelColor?: string;
+    /** 标签文本格式化函数。 */
     labelFormatter?: (value: number, category: string, index: number) => ReactNode;
+    /** 标签显示位置。 */
     labelPosition?: BarDatum["labelPosition"];
+    /** 需要标记的数据范围。 */
     markRange?: boolean;
+    /** 标记点配置集合。 */
     markPoints?: readonly {
+        /** 项目在当前集合中的索引，从 0 开始。 */
         index: number;
+        /** 该项目对应的数据值，用于标识、选择或计算。 */
         value: number;
+        /** 展示给用户的名称，可传入文本或 React 节点。 */
         label?: string;
     }[];
 }
+/** 柱状图的属性配置。 */
 interface BarChartProps extends Omit<CartesianChartProps, "series"> {
     /** Shared data/island owner when composed as another Cartesian chart's mode. */
     valueTransfer?: ReturnType<typeof useBarValueTransfer>;
+    /**
+     * 数据拖拽计算的处理模式。
+     * @defaultValue 'resize'
+     */
     calculableMode?: 'resize' | 'transfer';
+    /** 图表间数据转移失败时调用。 */
     onTransferError?: (message: string) => void;
+    /** 图例的排列顺序。 */
     legendOrder?: readonly string[];
+    /** 图例布局配置。 */
     legendLayout?: {
+        /** 横向位置或 X 轴数据值。 */
         x?: number;
+        /** 纵向位置或 Y 轴数据值。 */
         y?: number;
+        /** 相邻项目的间距。 */
         itemGap?: number;
+        /** 默认可见行数 */
         rows?: number;
     };
+    /**
+     * 不同类目柱组之间的间距。
+     * @defaultValue .2
+     */
     barCategoryGap?: number;
+    /**
+     * 数值轴两端增加的留白。
+     * @defaultValue 0
+     */
     valuePadding?: number;
+    /** 绘图区的边距和布局配置。 */
     grid?: {
+        /** 距左侧的位置或间距。 */
         left?: number;
+        /** 距顶部的位置或间距。 */
         top?: number;
+        /** 距右侧的位置或间距。 */
         right?: number;
+        /** 距底部的位置或间距。 */
         bottom?: number;
     };
+    /**
+     * 数值轴所在位置。
+     * @defaultValue "bottom"
+     */
     valueAxisPosition?: "top" | "bottom";
+    /**
+     * 图形外观配置。
+     * @defaultValue "sia"
+     */
     appearance?: "sia" | "macarons";
+    /** 动画当前进度，通常为 0 到 1。 */
     animationProgress?: number;
+    /**
+     * 数据更新动画的持续时间。
+     * @defaultValue 500
+     */
     animationDurationUpdate?: number;
+    /** 数值轴的数据范围。 */
     valueDomain?: readonly [number, number, number];
+    /** 坐标轴标签格式化函数。 */
     axisLabelFormatter?: (value: number) => string;
+    /**
+     * 是否显示数值轴。
+     * @defaultValue true
+     */
     showValueAxis?: boolean;
+    /**
+     * 是否显示类目轴。
+     * @defaultValue true
+     */
     showCategoryAxis?: boolean;
+    /**
+     * 是否显示类目轴分隔线。
+     * @defaultValue false
+     */
     showCategorySplitLine?: boolean;
+    /**
+     * 提示框按数据项还是坐标轴触发。
+     * @defaultValue "item"
+     */
     tooltipTrigger?: "item" | "axis";
+    /** 提示框内容的格式化函数。 */
     tooltipFormatter?: (name: string, values: readonly {
+        /** 名称或字段标识。 */
         name: string;
+        /** 当前值；作为受控属性时，需要在变更回调中同步更新。 */
         value: number;
+        /** 显示颜色，可使用 CSS 颜色值。 */
         color: string;
     }[]) => ReactNode;
+    /** 图表数据系列。 */
     series: readonly BarSeries[];
+    /**
+     * 是否堆叠展示数据系列。
+     * @defaultValue false
+     */
     stacked?: boolean;
+    /**
+     组件的水平或垂直排列方向。
+     * @defaultValue "vertical"
+     */
     orientation?: "vertical" | "horizontal";
+    /**
+     * 柱形允许的最小尺寸。
+     * @defaultValue 1
+     */
     minBarSize?: number;
+    /**
+     * 是否允许通过拖拽图形修改数据。
+     * @defaultValue false
+     */
     calculable?: boolean;
+    /** 数据被交互修改后调用。 */
     onDataChange?: (series: readonly BarSeries[]) => void;
 }
+/** 柱状图组件。 */
 declare const BarChart: react.ForwardRefExoticComponent<BarChartProps & react.RefAttributes<SiaChartRef>>;
+/** Scatter的单条数据。 */
 interface ScatterDatum {
+    /** 高亮状态的颜色。 */
     emphasisColor?: string;
+    /** 高亮状态的边框宽度。 */
     emphasisBorderWidth?: number;
+    /** 符号填充颜色。 */
     symbolFill?: string;
+    /** 是否显示标签文本。 */
     showLabel?: boolean;
+    /** 高亮时是否显示标签。 */
     showEmphasisLabel?: boolean;
+    /** 展示给用户的名称，可传入文本或 React 节点。 */
     label?: ReactNode;
+    /** 标签文本格式化函数。 */
     labelFormatter?: (item: ScatterDatum) => ReactNode;
+    /** 标签文字样式。 */
     labelStyle?: CSSProperties;
+    /** 数据符号使用的图片。 */
     symbolImage?: string;
+    /** 数据符号旋转角度。 */
     symbolRotate?: number;
+    /** 边框线宽。 */
     borderWidth?: number;
     /** Optional third data dimension, independent of the rendered symbol radius. */
     value?: number;
+    /** 名称或字段标识。 */
     name?: string;
+    /** 横向位置或 X 轴数据值。 */
     x: number;
+    /** 纵向位置或 Y 轴数据值。 */
     y: number;
+    /** 组件尺寸；用于调整控件高度、字号和间距。 */
     size?: number;
+    /** 显示颜色，可使用 CSS 颜色值。 */
     color?: string;
+    /** 所属类目或分组。 */
     category?: string;
+    /** 数据点或节点使用的图形符号。 */
     symbol?: "circle" | "square" | "diamond" | "emptyCircle" | "emptyTriangle" | "image";
 }
+/** 散点数值到颜色和尺寸的视觉映射配置。 */
 interface ScatterVisualMap {
+    /** 是否允许通过拖拽图形修改数据。 */
     calculable?: boolean;
+    /** 组件的水平或垂直排列方向。 */
     orientation?: 'horizontal' | 'vertical';
+    /** 是否允许选中项目。 */
     selectable?: boolean;
+    /** 参与统计或映射的数据维度。 */
     dimension: "x" | "y" | "size" | "value";
+    /** 分段视觉映射的区间配置。 */
     pieces?: readonly {
+        /** 允许的最小值。 */
         min: number;
+        /** 允许的最大值。 */
         max: number;
+        /** 显示颜色，可使用 CSS 颜色值。 */
         color: string;
+        /** 展示给用户的名称，可传入文本或 React 节点。 */
         label?: string;
     }[];
+    /** 横向位置或 X 轴数据值。 */
     x?: number;
+    /** 纵向位置或 Y 轴数据值。 */
     y?: number;
+    /** 宽度；数值按像素处理，字符串可使用 CSS 尺寸。 */
     width?: number;
+    /** 允许的最小值。 */
     min?: number;
+    /** 允许的最大值。 */
     max?: number;
+    /** 可选颜色或颜色序列。 */
     colors?: readonly [string, string];
+    /** 展示给用户的名称，可传入文本或 React 节点。 */
     label?: string;
 }
+/** 散点图的属性配置。 */
 interface ScatterChartProps extends Omit<SiaChartProps, "children" | "empty"> {
+    /**
+     * 数据符号动画配置。
+     * @defaultValue false
+     */
     symbolAnimation?: boolean;
+    /** 动画当前进度，通常为 0 到 1。 */
     animationProgress?: number;
+    /**
+     * 数据更新动画的持续时间。
+     * @defaultValue 500
+     */
     animationDurationUpdate?: number;
+    /**
+     * 统计点标记配置。
+     * @defaultValue []
+     */
     statisticPoints?: readonly {
+        /** 名称或字段标识。 */
         name: string;
+        /** 参与统计或映射的数据维度。 */
         dimension: 'x' | 'y';
+        /** 补全项或节点的类别。 */
         kind: 'min' | 'max';
+        /** 所属类目或分组。 */
         category?: string;
+        /** 数据点或节点使用的图形符号。 */
         symbol?: 'pin' | 'arrow';
+        /** 显示颜色，可使用 CSS 颜色值。 */
         color?: string;
+        /** 边框颜色。 */
         borderColor?: string;
+        /** 组件尺寸；用于调整控件高度、字号和间距。 */
         size?: number;
     }[];
+    /**
+     * 统计标线配置。
+     * @defaultValue []
+     */
     statisticLines?: readonly {
+        /** 名称或字段标识。 */
         name: string;
+        /** 参与统计或映射的数据维度。 */
         dimension: 'x' | 'y';
+        /** 所属类目或分组。 */
         category?: string;
+        /** 显示颜色，可使用 CSS 颜色值。 */
         color?: string;
     }[];
     /** Fixed coordinate annotations, separate from editable scatter values. */
     annotations?: readonly {
+        /** 名称或字段标识。 */
         name: string;
+        /** 横向位置或 X 轴数据值。 */
         x: number;
+        /** 纵向位置或 Y 轴数据值。 */
         y: number;
+        /** 当前值；作为受控属性时，需要在变更回调中同步更新。 */
         value: number;
+        /** 所属类目或分组。 */
         category?: string;
+        /** 图形半径或圆角配置。 */
         radius?: number;
+        /** 显示颜色，可使用 CSS 颜色值。 */
         color?: string;
     }[];
+    /**
+     * 是否显示 X 轴。
+     * @defaultValue true
+     */
     showXAxis?: boolean;
+    /**
+     * 是否显示 X 轴分隔线。
+     * @defaultValue true
+     */
     showXSplitLine?: boolean;
+    /**
+     * 是否显示 Y 轴分隔线。
+     * @defaultValue true
+     */
     showYSplitLine?: boolean;
+    /** 提示框内容的格式化函数。 */
     tooltipFormatter?: (item: ScatterDatum) => ReactNode;
+    /** 标记颜色。 */
     markColor?: string;
+    /** X 轴的数据范围。 */
     xDomain?: readonly [number, number, number];
+    /** Y 轴的数据范围。 */
     yDomain?: readonly [number, number, number];
+    /**
+     * 是否显示数据点标签。
+     * @defaultValue false
+     */
     showPointLabels?: boolean;
+    /**
+     * Y 轴所在位置。
+     * @defaultValue 'left'
+     */
     yAxisPosition?: 'left' | 'right';
+    /** X 轴类目集合。 */
     xCategories?: readonly number[];
+    /** X 轴数值的格式化函数。 */
     xFormatter?: (value: number) => string;
+    /**
+     * 十字辅助线配置。
+     * @defaultValue false
+     */
     crosshair?: boolean;
     /** Pin extrema and value-only mean labels used by legacy reference charts. */
     markAppearance?: 'label' | 'pin';
+    /**
+     * X 轴分段数量。
+     * @defaultValue 5
+     */
     xSplitNumber?: number;
+    /**
+     * Y 轴分段数量。
+     * @defaultValue 5
+     */
     ySplitNumber?: number;
+    /** 按数据点计算显示尺寸的函数。 */
     symbolSize?: (item: ScatterDatum) => number;
+    /**
+     * 是否按类目绘制统计标记。
+     * @defaultValue false
+     */
     markByCategory?: boolean;
+    /**
+     * X 轴数值单位。
+     * @defaultValue ''
+     */
     xUnit?: string;
+    /**
+     * Y 轴数值单位。
+     * @defaultValue ''
+     */
     yUnit?: string;
+    /**
+     * 符号最小半径。
+     * @defaultValue 5
+     */
     minSymbolRadius?: number;
+    /** 绘图区边界。 */
     plotBounds?: {
+        /** 横向位置或 X 轴数据值。 */
         x: number;
+        /** 纵向位置或 Y 轴数据值。 */
         y: number;
+        /** 宽度；数值按像素处理，字符串可使用 CSS 尺寸。 */
         width: number;
+        /** 高度；数值按像素处理，字符串可使用 CSS 尺寸。 */
         height: number;
     };
+    /** 用于渲染的数据集合。 */
     data: readonly ScatterDatum[];
+    /** X 轴标题。 */
     xLabel?: string;
+    /** Y 轴标题。 */
     yLabel?: string;
+    /**
+     * X 轴类型。
+     * @defaultValue "value"
+     */
     xAxisType?: "value" | "time";
+    /**
+     * 是否显示图例。
+     * @defaultValue true
+     */
     showLegend?: boolean;
+    /**
+     * 是否允许通过图例切换系列显示。
+     * @defaultValue true
+     */
     legendInteractive?: boolean;
+    /** 图例项目的选中状态。 */
     legendSelected?: Readonly<Record<string, boolean>>;
+    /** 图例选中状态变化时调用。 */
     onLegendSelectionChange?: (selected: Record<string, boolean>) => void;
+    /**
+     * 数据区域缩放配置。
+     * @defaultValue false
+     */
     dataZoom?: boolean;
+    /** 缩放级别或缩放范围。 */
     zoom?: readonly [number, number];
+    /** 初始缩放范围或缩放级别。 */
     defaultZoom?: readonly [number, number];
+    /** 缩放范围变化时调用。 */
     onZoomChange?: (value: [number, number]) => void;
+    /** 数据到颜色、大小等视觉通道的映射配置。 */
     visualMap?: ScatterVisualMap;
+    /** 是否显示平均值标记。 */
     markAverage?: "x" | "y" | "both";
+    /**
+     * 是否标记极值数据。
+     * @defaultValue false
+     */
     markExtremes?: boolean;
+    /**
+     * 启用大数据量渲染优化的阈值。
+     * @defaultValue 1200
+     */
     largeThreshold?: number;
+    /** 点击图表数据项时调用。 */
     onDataClick?: (info: ChartDataClickInfo<ScatterDatum>) => void;
 }
+/** 散点图组件。 */
 declare const ScatterChart: react.ForwardRefExoticComponent<ScatterChartProps & react.RefAttributes<SiaChartRef>>;
+/** Candlestick的单条数据。 */
 interface CandlestickDatum {
+    /** 名称或字段标识。 */
     name: string;
+    /** 是否打开；传入后由外部控制显示状态。 */
     open: number;
+    /** 关闭当前界面或实例。 */
     close: number;
+    /** 最低值。 */
     low: number;
+    /** 最高值。 */
     high: number;
+    /** 成交量。 */
     volume?: number;
+    /** 显示颜色，可使用 CSS 颜色值。 */
     color?: string;
+    /** 边框颜色。 */
     borderColor?: string;
+    /** 边框线宽。 */
     borderWidth?: number;
+    /** 高亮状态的颜色。 */
     emphasisColor?: string;
 }
+/** 蜡烛图的属性配置。 */
 interface CandlestickChartProps extends Omit<SiaChartProps, "children" | "empty"> {
     /** Hide axes when sharing a plot with another chart layer. */
     showAxes?: boolean;
+    /** 数值轴的数据范围。 */
     valueDomain?: readonly [number, number, number];
+    /** 坐标轴标签格式化函数。 */
     axisLabelFormatter?: (value: number) => string;
     /** Index into the full input data; null explicitly clears a controlled highlight. */
     activeIndex?: number | null;
+    /** 当前激活数据索引变化时调用。 */
     onActiveIndexChange?: (index: number | null) => void;
+    /** 各数据系列的可见状态。 */
     seriesVisible?: boolean;
+    /** 系列可见性变化时调用。 */
     onSeriesVisibilityChange?: (visible: boolean) => void;
+    /**
+     * 是否显示图例。
+     * @defaultValue true
+     */
     showLegend?: boolean;
+    /**
+     * 是否显示类目标签。
+     * @defaultValue true
+     */
     showCategoryLabels?: boolean;
+    /** 绘图区边界。 */
     plotBounds?: {
+        /** 横向位置或 X 轴数据值。 */
         x: number;
+        /** 纵向位置或 Y 轴数据值。 */
         y: number;
+        /** 宽度；数值按像素处理，字符串可使用 CSS 尺寸。 */
         width: number;
+        /** 高度；数值按像素处理，字符串可使用 CSS 尺寸。 */
         height: number;
     };
+    /** 标记点配置集合。 */
     markPoints?: readonly {
+        /** 名称或字段标识。 */
         name: string;
+        /** 关联的日期或时间。 */
         date: string;
+        /** 当前值；作为受控属性时，需要在变更回调中同步更新。 */
         value: number;
+        /** 纵向位置或 Y 轴数据值。 */
         y: number;
+        /** 显示颜色，可使用 CSS 颜色值。 */
         color?: string;
     }[];
+    /** 数据系列名称。 */
     seriesName?: string;
+    /** 上涨蜡烛图的边框颜色。 */
     risingBorderColor?: string;
+    /** 下跌蜡烛图的边框颜色。 */
     fallingBorderColor?: string;
+    /**
+     * 边框线宽。
+     * @defaultValue 2
+     */
     borderWidth?: number;
+    /** 上涨数据高亮时的颜色。 */
     risingEmphasisColor?: string;
+    /** 下跌数据高亮时的颜色。 */
     fallingEmphasisColor?: string;
+    /**
+     * 柱形允许的最大宽度。
+     * @defaultValue 34
+     */
     maxBarWidth?: number;
+    /**
+     * 图形外观配置。
+     * @defaultValue 'sia'
+     */
     appearance?: 'sia' | 'macarons';
+    /** 用于渲染的数据集合。 */
     data: readonly CandlestickDatum[];
+    /**
+     * 上涨数据的颜色。
+     * @defaultValue "#f5222d"
+     */
     risingColor?: string;
+    /**
+     * 下跌数据的颜色。
+     * @defaultValue "#52c41a"
+     */
     fallingColor?: string;
+    /**
+     * 上涨蜡烛图是否使用空心样式。
+     * @defaultValue false
+     */
     hollowRising?: boolean;
+    /**
+     * 数据区域缩放配置。
+     * @defaultValue false
+     */
     dataZoom?: boolean;
+    /** 缩放级别或缩放范围。 */
     zoom?: readonly [number, number];
+    /** 初始缩放范围或缩放级别。 */
     defaultZoom?: readonly [number, number];
+    /** 缩放范围变化时调用。 */
     onZoomChange?: (value: [number, number]) => void;
+    /**
+     * 是否标记极值数据。
+     * @defaultValue false
+     */
     markExtremes?: boolean;
+    /** 点击图表数据项时调用。 */
     onDataClick?: (info: ChartDataClickInfo<CandlestickDatum>) => void;
 }
+/** 蜡烛图组件。 */
 declare const CandlestickChart: react.ForwardRefExoticComponent<CandlestickChartProps & react.RefAttributes<SiaChartRef>>;
+/** 饼图径向渐变配置。 */
 interface PieRadialGradient {
+    /** 中心位置。 */
     center: readonly [number, number];
+    /** 环形图形的内半径。 */
     innerRadius?: number;
+    /** 环形图形的外半径。 */
     outerRadius: number;
+    /** 渐变颜色停靠点集合。 */
     stops: readonly {
+        /** 相对于默认位置的偏移。 */
         offset: number;
+        /** 显示颜色，可使用 CSS 颜色值。 */
         color: string;
     }[];
 }
+/** PieLabel的配置选项。 */
 interface PieLabelOptions {
+    /** 标签文本格式化函数。 */
     labelFormatter?: (item: PieDatum, percent: number) => string;
+    /** 高亮标签格式化函数。 */
     emphasisLabelFormatter?: (item: PieDatum, percent: number) => string;
+    /** 标签文字样式。 */
     labelStyle?: CSSProperties;
+    /** 高亮状态的标签样式。 */
     emphasisLabelStyle?: CSSProperties;
+    /** 高亮时是否显示标签。 */
     showEmphasisLabel?: boolean;
+    /** 标签引导线配置。 */
     labelLine?: {
+        /** 是否显示该功能。 */
         show?: boolean;
+        /** 长度。 */
         length?: number;
+        /** 组件根节点的内联样式。 */
         style?: CSSProperties;
     };
+    /** 高亮状态的标签引导线配置。 */
     emphasisLabelLine?: {
+        /** 是否显示该功能。 */
         show?: boolean;
+        /** 长度。 */
         length?: number;
+        /** 组件根节点的内联样式。 */
         style?: CSSProperties;
     };
 }
+/** Pie的单条数据。 */
 interface PieDatum extends PieLabelOptions {
     /** Missing source slot after a calculable transfer; not a zero-valued slice. */
     missing?: boolean;
+    /** 是否显示标签文本。 */
     showLabel?: boolean;
+    /** 渐变填充配置。 */
     gradient?: PieRadialGradient;
+    /** 高亮状态的渐变填充。 */
     emphasisGradient?: PieRadialGradient;
+    /** 高亮状态的颜色。 */
     emphasisColor?: string;
+    /** 名称或字段标识。 */
     name: string;
+    /** 该项目对应的数据值，用于标识、选择或计算。 */
     value: number;
+    /** 显示颜色，可使用 CSS 颜色值。 */
     color?: string;
+    /** 是否处于选中状态。 */
     selected?: boolean;
+    /** 是否将该系列显示在图例中。 */
     showInLegend?: boolean;
+    /** 是否启用交互。 */
     interactive?: boolean;
 }
+/** Pie的数据系列。 */
 interface PieSeries extends PieLabelOptions {
+    /** 高亮状态的渐变填充。 */
     emphasisGradient?: PieRadialGradient;
     /** SVG degrees; overrides the chart angle for this ring only. */
     startAngle?: number;
+    /** 中心区域显示的标签。 */
     centerLabel?: ReactNode;
+    /** 名称或字段标识。 */
     name?: string;
+    /** 用于渲染的数据集合。 */
     data: readonly PieDatum[];
+    /** 环形图形的内半径。 */
     innerRadius?: number;
+    /** 环形图形的外半径。 */
     outerRadius?: number;
+    /** 是否启用南丁格尔玫瑰图模式。 */
     rose?: boolean | "radius" | "area";
+    /** 是否显示数据标签。 */
     showLabels?: boolean;
+    /** 中心位置。 */
     center?: readonly [number, number];
+    /** 标签显示位置。 */
     labelPosition?: "outside" | "inside";
+    /** 高亮状态的标签配置。 */
     emphasisLabel?: "center" | "outside";
+    /** 图形的选中模式。 */
     selectedMode?: false | "single" | "multiple";
+    /** 是否按顺时针方向绘制。 */
     clockwise?: boolean;
 }
+/** 饼图的属性配置。 */
 interface PieChartProps extends Omit<SiaChartProps, "children" | "empty"> {
+    /** 数据点脉冲环效果配置。 */
     pulseRing?: ChartPulseRingProps;
+    /**
+     * 是否允许通过拖拽图形修改数据。
+     * @defaultValue false
+     */
     calculable?: boolean;
     /** Fixed-position star annotations; percentage coordinates use the SVG viewport. */
     markPoints?: readonly {
+        /** 名称或字段标识。 */
         name: string;
+        /** 当前值；作为受控属性时，需要在变更回调中同步更新。 */
         value: number;
+        /** 横向位置或 X 轴数据值。 */
         x: number | `${number}%`;
+        /** 纵向位置或 Y 轴数据值。 */
         y: number | `${number}%`;
+        /** 图形半径或圆角配置。 */
         radius?: number;
+        /** 显示颜色，可使用 CSS 颜色值。 */
         color?: string;
     }[];
+    /** 将数据值拖出当前绘图区时调用。 */
     onValueDragOut?: (seriesIndex: number, dataIndex: number, point: readonly [number, number]) => void;
+    /** 外侧标签的布局规则。 */
     outsideLabelLayout?: {
+        /** 距顶部的位置或间距。 */
         top: number;
+        /** 距底部的位置或间距。 */
         bottom: number;
+        /** 预设或自定义间距 */
         gap?: number;
+        /** 距左侧的位置或间距。 */
         left?: number;
+        /** 距右侧的位置或间距。 */
         right?: number;
     };
     /** Controlled data transfer between charts in the same ChartComposite. */
     transferId?: string;
+    /** 图表间转移数据值时调用。 */
     onValueTransfer?: ChartValueTransferHandler;
+    /** 图表间数据转移失败时调用。 */
     onTransferError?: (message: string) => void;
+    /**
+     * 是否显示辅助参考环。
+     * @defaultValue false
+     */
     showGuideRings?: boolean;
+    /**
+     * 图形外观配置。
+     * @defaultValue "sia"
+     */
     appearance?: "sia" | "macarons";
+    /** 动画当前进度，通常为 0 到 1。 */
     animationProgress?: number;
+    /**
+     * 数据更新动画的持续时间。
+     * @defaultValue 500
+     */
     animationDurationUpdate?: number;
+    /** 图例布局配置。 */
     legendLayout?: {
+        /** 横向位置或 X 轴数据值。 */
         x?: number;
+        /** 纵向位置或 Y 轴数据值。 */
         y?: number;
+        /** 组件的水平或垂直排列方向。 */
         orientation?: "horizontal" | "vertical";
+        /** 交叉轴对齐 */
         align?: "start" | "center" | "end";
+        /** 相邻项目的间距。 */
         itemGap?: number;
     };
+    /** 数据被交互修改后调用。 */
     onDataChange?: (series: readonly PieSeries[]) => void;
+    /**
+     用于渲染的数据集合。
+     * @defaultValue EMPTY_PIE_DATA
+     */
     data?: readonly PieDatum[];
+    /** 图表数据系列。 */
     series?: readonly PieSeries[];
+    /**
+     * 环形图形的内半径。
+     * @defaultValue 62
+     */
     innerRadius?: number;
+    /**
+     * 环形图形的外半径。
+     * @defaultValue 124
+     */
     outerRadius?: number;
+    /**
+     * 是否启用南丁格尔玫瑰图模式。
+     * @defaultValue false
+     */
     rose?: boolean | "radius" | "area";
+    /**
+     * 中心位置。
+     * @defaultValue [360,173]
+     */
     center?: readonly [number, number];
+    /**
+     * 绘制起始角度。
+     * @defaultValue -90
+     */
     startAngle?: number;
+    /**
+     * 是否按顺时针方向绘制。
+     * @defaultValue true
+     */
     clockwise?: boolean;
+    /**
+     * 相邻扇区之间的间隔角度。
+     * @defaultValue 0
+     */
     padAngle?: number;
+    /**
+     * 是否显示图例。
+     * @defaultValue true
+     */
     showLegend?: boolean;
+    /**
+     * 是否允许通过图例切换系列显示。
+     * @defaultValue true
+     */
     legendInteractive?: boolean;
+    /** 图例项目的选中状态。 */
     legendSelected?: Readonly<Record<string, boolean>>;
+    /** 图例选中状态变化时调用。 */
     onLegendSelectionChange?: (selected: Record<string, boolean>) => void;
+    /**
+     * 是否显示数据标签。
+     * @defaultValue true
+     */
     showLabels?: boolean;
+    /**
+     * 是否显示标签引导线。
+     * @defaultValue true
+     */
     showLabelLines?: boolean;
+    /** 中心区域显示的标签。 */
     centerLabel?: ReactNode;
+    /**
+     * 图形的选中模式。
+     * @defaultValue false
+     */
     selectedMode?: false | "single" | "multiple";
+    /** 是否处于选中状态。 */
     selected?: readonly string[];
+    /** 初始化时选中的图形或状态。 */
     defaultSelected?: readonly string[];
+    /**
+     * 选中扇区向外偏移的距离。
+     * @defaultValue 9
+     */
     selectedOffset?: number;
+    /** 编辑器选区变化时调用。 */
     onSelectionChange?: (names: string[]) => void;
+    /** 点击图表数据项时调用。 */
     onDataClick?: (info: ChartDataClickInfo<PieDatum>) => void;
 }
+/** 饼图组件。 */
 declare const PieChart: react.ForwardRefExoticComponent<PieChartProps & react.RefAttributes<SiaChartRef>>;
+/** 雷达图的一项指标，定义名称、范围及标签显示。 */
 interface RadarIndicator {
+    /** 名称或字段标识。 */
     name: string;
+    /** 允许的最大值。 */
     max?: number;
+    /** 允许的最小值。 */
     min?: number;
 }
+/** Radar的数据系列。 */
 interface RadarSeries extends ChartSeries {
+    /** 面积区域的填充渐变。 */
     areaGradient?: {
+        /** 中心位置。 */
         center: readonly [number, number];
+        /** 图形半径或圆角配置。 */
         radius: number;
+        /** 将焦点移入控件。 */
         focus?: readonly [number, number];
+        /** 渐变颜色停靠点集合。 */
         stops: readonly {
+            /** 相对于默认位置的偏移。 */
             offset: number;
+            /** 显示颜色，可使用 CSS 颜色值。 */
             color: string;
         }[];
     };
+    /** 数据点图形符号。 */
     pointSymbol?: 'circle' | 'star';
+    /** 数据点半径。 */
     pointRadius?: number;
+    /** 按数据点及索引计算颜色的函数。 */
     pointColor?: (value: number, index: number) => string | undefined;
+    /** 是否显示数值标签。 */
     showValueLabels?: boolean;
+    /** 数值标签格式化函数。 */
     valueLabelFormatter?: (value: number, index: number) => string;
+    /** 高亮线条宽度。 */
     emphasisLineWidth?: number;
+    /** 高亮面积区域颜色。 */
     emphasisAreaColor?: string;
+    /** 用于渲染的数据集合。 */
     data: readonly number[];
+    /** 面积填充透明度。 */
     areaOpacity?: number;
+    /** 线条样式。 */
     lineStyle?: "solid" | "dashed" | "dotted";
+    /** 线条粗细。 */
     lineWidth?: number;
+    /** 是否显示数据点。 */
     showPoints?: boolean;
 }
+/** 雷达图的坐标系面板配置。 */
 interface RadarPanel {
+    /** 是否根据数据自动计算缩放范围。 */
     autoScale?: boolean;
+    /** 缩放比例或比例尺配置。 */
     scale?: boolean;
+    /** 轴端是否保留间隔，或两端间隔的配置。 */
     boundaryGap?: readonly [number, number];
+    /** 坐标轴线颜色。 */
     axisColor?: string;
+    /** 轴线粗细。 */
     axisWidth?: number;
+    /** 分隔线颜色。 */
     splitLineColor?: string;
+    /** 分隔线粗细。 */
     splitLineWidth?: number;
+    /** 坐标轴分隔区域的填充颜色。 */
     splitAreaColors?: readonly string[];
+    /** 指标文字或指示器颜色。 */
     indicatorColor?: string;
+    /** 指标文字格式化函数。 */
     indicatorFormatter?: (name: string) => string;
+    /** 是否显示轴标签。 */
     showAxisLabels?: boolean;
+    /** 坐标轴标签颜色。 */
     axisLabelColor?: string;
+    /** 雷达图各指标的定义。 */
     indicators: readonly RadarIndicator[];
+    /** 图表数据系列。 */
     series: readonly RadarSeries[];
+    /** 中心位置。 */
     center?: readonly [number, number];
+    /** 图形半径或圆角配置。 */
     radius?: number;
+    /** 分层布局或雷达网格的层级配置。 */
     levels?: number;
+    /** 外观形状。 */
     shape?: "polygon" | "circle";
+    /** 绘制起始角度。 */
     startAngle?: number;
 }
+/** 雷达图的属性配置。 */
 interface RadarChartProps extends Omit<SiaChartProps, "children" | "empty"> {
+    /**
+     * 是否允许通过拖拽图形修改数据。
+     * @defaultValue false
+     */
     calculable?: boolean;
+    /** 图表间数据转移失败时调用。 */
     onTransferError?: (message: string) => void;
+    /** 在指定文本范围显示错误、警告或信息波浪线 */
     markers?: readonly {
+        /** 名称或字段标识。 */
         name: string;
+        /** 当前值；作为受控属性时，需要在变更回调中同步更新。 */
         value: number;
+        /** 横向位置或 X 轴数据值。 */
         x: number;
+        /** 纵向位置或 Y 轴数据值。 */
         y: number;
+        /** 组件尺寸；用于调整控件高度、字号和间距。 */
         size?: number;
+        /** 显示颜色，可使用 CSS 颜色值。 */
         color?: string;
+        /** 是否使用空心样式。 */
         hollow?: boolean;
     }[];
+    /**
+     * 图形外观配置。
+     * @defaultValue "sia"
+     */
     appearance?: "sia" | "macarons";
+    /** 动画当前进度，通常为 0 到 1。 */
     animationProgress?: number;
+    /** 图例的排列顺序。 */
     legendOrder?: readonly string[];
+    /** 图例布局配置。 */
     legendLayout?: {
+        /** 横向位置或 X 轴数据值。 */
         x?: number;
+        /** 纵向位置或 Y 轴数据值。 */
         y?: number;
+        /** 组件的水平或垂直排列方向。 */
         orientation?: "horizontal" | "vertical";
+        /** 交叉轴对齐 */
         align?: "start" | "center" | "end";
     };
+    /** 数据被交互修改后调用。 */
     onDataChange?: (panels: readonly RadarPanel[]) => void;
+    /**
+     * 雷达图各指标的定义。
+     * @defaultValue EMPTY_RADAR_INDICATORS
+     */
     indicators?: readonly RadarIndicator[];
+    /**
+     * 图表数据系列。
+     * @defaultValue EMPTY_RADAR_SERIES
+     */
     series?: readonly RadarSeries[];
+    /** 雷达坐标系集合。 */
     radars?: readonly RadarPanel[];
+    /**
+     * 分层布局或雷达网格的层级配置。
+     * @defaultValue 5
+     */
     levels?: number;
+    /**
+     * 是否显示图例。
+     * @defaultValue true
+     */
     showLegend?: boolean;
+    /**
+     * 是否允许通过图例切换系列显示。
+     * @defaultValue true
+     */
     legendInteractive?: boolean;
+    /** 图例项目的选中状态。 */
     legendSelected?: Readonly<Record<string, boolean>>;
+    /** 图例选中状态变化时调用。 */
     onLegendSelectionChange?: (selected: Record<string, boolean>) => void;
+    /** 点击图表数据项时调用。 */
     onDataClick?: (info: ChartDataClickInfo<RadarSeries>) => void;
 }
+/** 雷达图组件。 */
 declare const RadarChart: react.ForwardRefExoticComponent<RadarChartProps & react.RefAttributes<SiaChartRef>>;
+/** 弦图中的节点定义。 */
 interface ChordNode {
+    /** 节点图形符号。 */
     nodeSymbol?: 'circle' | 'star';
+    /** 唯一标识，用于关联实例或插件。 */
     id: string;
+    /** 名称或字段标识。 */
     name: string;
+    /** 该项目对应的数据值，用于标识、选择或计算。 */
     value?: number;
+    /** 显示颜色，可使用 CSS 颜色值。 */
     color?: string;
 }
+/** 弦图节点间的关系和权重。 */
 interface ChordLink {
+    /** 展示给用户的名称，可传入文本或 React 节点。 */
     label?: string;
+    /** 触发来源，用于区分不同入口的操作。 */
     source: string;
+    /** 关联的目标元素或获取目标元素的函数。 */
     target: string;
+    /** 该项目对应的数据值，用于标识、选择或计算。 */
     value: number;
+    /** 显示颜色，可使用 CSS 颜色值。 */
     color?: string;
 }
+/** 弦图的属性配置。 */
 interface ChordChartProps extends Omit<SiaChartProps, "children" | "empty"> {
+    /** 矩阵弦图的外观配置。 */
     matrixAppearance?: MatrixChordAppearance;
+    /** 节点几何形状配置。 */
     nodeGeometry?: {
+        /** 中心位置。 */
         center: readonly [number, number];
+        /** 节点环绕轨道的半径。 */
         orbitRadius: number;
+        /** 允许的最小半径。 */
         minRadius: number;
+        /** 允许的最大半径。 */
         maxRadius: number;
+        /** 绘制起始角度。 */
         startAngle?: number;
     };
+    /** 矩阵图的数据系列。 */
     matrixSeries?: readonly {
+        /** 名称或字段标识。 */
         name: string;
+        /** 显示颜色，可使用 CSS 颜色值。 */
         color: string;
+        /** 关系权重矩阵。 */
         matrix: readonly (readonly number[])[];
     }[];
+    /**
+     * 是否显示节点名称。
+     * @defaultValue false
+     */
     showNodeLabels?: boolean;
+    /**
+     * 是否沿节点方向旋转标签。
+     * @defaultValue false
+     */
     rotateNodeLabels?: boolean;
+    /** 矩阵连线的标签配置。 */
     matrixLinkLabel?: (source: number, target: number) => string;
+    /** 矩阵图几何布局配置。 */
     matrixGeometry?: {
+        /** 中心位置。 */
         center: readonly [number, number];
+        /** 环形图形的内半径。 */
         innerRadius: number;
+        /** 环形图形的外半径。 */
         outerRadius: number;
+        /** 绘制起始角度。 */
         startAngle?: number;
     };
+    /**
+     * 是否启用兼容模式的子分组排序。
+     * @defaultValue false
+     */
     legacySubSort?: boolean;
+    /**
+     * 是否显示刻度。
+     * @defaultValue false
+     */
     showScale?: boolean;
+    /** 关系权重矩阵。 */
     matrix?: readonly (readonly number[])[];
+    /**
+     * 子分组排序方式。
+     * @defaultValue 'none'
+     */
     sortSub?: 'none' | 'ascending' | 'descending';
+    /** 图中节点的数据集合。 */
     nodes: readonly ChordNode[];
+    /** 节点之间的连线集合。 */
     links: readonly ChordLink[];
+    /**
+     * 相邻扇区之间的间隔角度。
+     * @defaultValue 0.035
+     */
     padAngle?: number;
+    /**
+     * 弦带的外观与绘制配置。
+     * @defaultValue true
+     */
     ribbon?: boolean;
+    /**
+     * 是否按顺时针方向绘制。
+     * @defaultValue true
+     */
     clockwise?: boolean;
+    /**
+     * 数据或图形排序规则。
+     * @defaultValue "none"
+     */
     sort?: "ascending" | "descending" | "none";
+    /** 节点点击回调 */
     onNodeClick?: (info: ChartDataClickInfo<ChordNode>) => void;
+    /** 点击节点连线时调用。 */
     onLinkClick?: (info: ChartDataClickInfo<ChordLink>) => void;
 }
+/** 弦图组件。 */
 declare const ChordChart: react.ForwardRefExoticComponent<ChordChartProps & react.RefAttributes<SiaChartRef>>;
+/** 关系图中的节点数据及外观设置。 */
 interface GraphNode {
+    /** 节点图片来源。 */
     imageSource?: string;
+    /** 图片显示尺寸。 */
     imageSize?: readonly [number, number];
+    /** 标签显示位置。 */
     labelPosition?: 'inside' | 'left' | 'right' | 'top' | 'bottom';
+    /** 是否允许拖拽。 */
     draggable?: boolean;
+    /** 是否固定节点的 X 轴位置。 */
     fixX?: boolean;
+    /** 是否固定节点的 Y 轴位置。 */
     fixY?: boolean;
+    /** 标签文字颜色。 */
     labelColor?: string;
+    /** 边框颜色。 */
     borderColor?: string;
+    /** 边框线宽。 */
     borderWidth?: number;
+    /** 图形半径或圆角配置。 */
     radius?: number;
+    /** 展示给用户的名称，可传入文本或 React 节点。 */
     label?: string;
+    /** 唯一标识，用于关联实例或插件。 */
     id: string;
+    /** 名称或字段标识。 */
     name: string;
+    /** 该项目对应的数据值，用于标识、选择或计算。 */
     value?: number;
+    /** 所属类目或分组。 */
     category?: string;
+    /** 显示颜色，可使用 CSS 颜色值。 */
     color?: string;
+    /** 横向位置或 X 轴数据值。 */
     x?: number;
+    /** 纵向位置或 Y 轴数据值。 */
     y?: number;
+    /** 列固定位置，left 固定左侧，right 固定右侧。 */
     fixed?: boolean;
+    /** 数据点或节点使用的图形符号。 */
     symbol?: "circle" | "square" | "diamond" | "star";
 }
+/** 关系图中的连线数据及外观设置。 */
 interface GraphLink {
+    /** 显示箭头及是否指向触发器中心 */
     arrow?: boolean;
+    /** 连线箭头尺寸。 */
     arrowSize?: readonly [number, number];
+    /** 相对于默认位置的偏移。 */
     offset?: number;
+    /** 曲线弯曲程度。 */
     curvature?: number;
+    /** 触发来源，用于区分不同入口的操作。 */
     source: string;
+    /** 关联的目标元素或获取目标元素的函数。 */
     target: string;
+    /** 该项目对应的数据值，用于标识、选择或计算。 */
     value?: number;
+    /** 展示给用户的名称，可传入文本或 React 节点。 */
     label?: string;
+    /** 显示颜色，可使用 CSS 颜色值。 */
     color?: string;
+    /** 宽度；数值按像素处理，字符串可使用 CSS 尺寸。 */
     width?: number;
+    /** 是否使用虚线。 */
     dashed?: boolean;
 }
+/** 关系图的属性配置。 */
 interface GraphChartProps extends Omit<SiaChartProps, "children" | "empty"> {
+    /**
+     * 是否逐帧计算力导向布局。
+     * @defaultValue false
+     */
     progressiveForce?: boolean;
+    /** 弦图布局参数。 */
     chordOptions?: Pick<ChordChartProps, 'ribbon' | 'nodeGeometry' | 'rotateNodeLabels'>;
+    /**
+     * 地图或图表的平移、缩放配置。
+     * @defaultValue false
+     */
     roam?: boolean | 'move';
+    /** 力导向布局参数。 */
     forceOptions?: ForceLayoutOptions;
+    /** 图中节点的数据集合。 */
     nodes: readonly GraphNode[];
+    /** 节点之间的连线集合。 */
     links: readonly GraphLink[];
+    /**
+     * 布局方式。
+     * @defaultValue "circular"
+     */
     layout?: "force" | "circular";
+    /**
+     * 是否显示数据标签。
+     * @defaultValue true
+     */
     showLabels?: boolean;
+    /**
+     * 是否允许拖拽。
+     * @defaultValue true
+     */
     draggable?: boolean;
+    /**
+     * 是否允许通过图例切换系列显示。
+     * @defaultValue true
+     */
     legendInteractive?: boolean;
+    /** 图例项目的选中状态。 */
     legendSelected?: Readonly<Record<string, boolean>>;
+    /** 图例选中状态变化时调用。 */
     onLegendSelectionChange?: (selected: Record<string, boolean>) => void;
+    /** 节点点击回调 */
     onNodeClick?: (info: ChartDataClickInfo<GraphNode>) => void;
 }
+/** 关系图组件。 */
 declare const GraphChart: react.ForwardRefExoticComponent<GraphChartProps & react.RefAttributes<SiaChartRef>>;
+/** 力导向关系图组件。 */
 declare const ForceGraphChart: react.ForwardRefExoticComponent<Omit<GraphChartProps, "layout"> & react.RefAttributes<SiaChartRef>>;
+/** 力导向图组件。 */
 declare const ForceChart: react.ForwardRefExoticComponent<Omit<GraphChartProps, "layout"> & react.RefAttributes<SiaChartRef>>;
+/** GeoJSON 单多边形几何数据。 */
 interface GeoJsonPolygonGeometry {
+    /** 类型标识，用于选择对应的表现形式。 */
     type: "Polygon";
+    /** 坐标序列。 */
     coordinates: readonly (readonly (readonly [number, number])[])[];
 }
+/** GeoJSON 多多边形几何数据。 */
 interface GeoJsonMultiPolygonGeometry {
+    /** 类型标识，用于选择对应的表现形式。 */
     type: "MultiPolygon";
+    /** 坐标序列。 */
     coordinates: readonly (readonly (readonly (readonly [number, number])[])[])[];
 }
+/** 带业务属性的 GeoJSON 地理要素。 */
 interface GeoJsonFeature {
+    /** 类型标识，用于选择对应的表现形式。 */
     type: "Feature";
+    /** 附加属性，例如 GeoJSON 要素的业务字段。 */
     properties: Readonly<Record<string, unknown>> & {
+        /** 名称或字段标识。 */
         name?: string;
     };
+    /** 图形几何形状及布局参数。 */
     geometry: GeoJsonPolygonGeometry | GeoJsonMultiPolygonGeometry;
 }
+/** GeoJSON 地理要素集合。 */
 interface GeoJsonFeatureCollection {
+    /** 类型标识，用于选择对应的表现形式。 */
     type: "FeatureCollection";
+    /** 工具箱中启用的功能项。 */
     features: readonly GeoJsonFeature[];
 }
+/** Map的单条数据。 */
 interface MapDatum extends MapRegionAppearance {
+    /** 图例使用的符号集合。 */
     legendSymbols?: readonly {
+        /** 名称或字段标识。 */
         name: string;
+        /** 显示颜色，可使用 CSS 颜色值。 */
         color: string;
     }[];
+    /** 名称或字段标识。 */
     name: string;
+    /** 该项目对应的数据值，用于标识、选择或计算。 */
     value: number;
+    /** 显示颜色，可使用 CSS 颜色值。 */
     color?: string;
+    /** 是否处于选中状态。 */
     selected?: boolean;
 }
+/** 地图上标记点的坐标、内容和外观配置。 */
 interface MapMarkPoint {
+    /** 入场动画配置。 */
     entrance?: boolean;
+    /** 定位标记的形状。 */
     pinShape?: 'curved' | 'arc';
     /** SVG coordinates bypass geographic projection (and still follow the map group transform). */
     coordinateSpace?: 'geographic' | 'svg';
+    /** 图片资源地址。 */
     imageSrc?: string;
+    /** 展示给用户的名称，可传入文本或 React 节点。 */
     label?: ReactNode;
+    /** 标签文字样式。 */
     labelStyle?: CSSProperties;
+    /** 高亮时是否显示标签。 */
     showEmphasisLabel?: boolean;
+    /** 缩放动画效果。 */
     scaleEffect?: {
+        /** 显示或动画持续时间，单位以所在组件约定为准。 */
         duration: number;
+        /** 缩放后的尺寸比例。 */
         scaleSize?: number;
     };
+    /** 数据到颜色、大小等视觉通道的映射配置。 */
     visualMap?: boolean;
+    /** 数据点或节点使用的图形符号。 */
     symbol?: 'circle' | 'emptyCircle' | 'pin';
+    /** 数据系列名称。 */
     seriesName?: string;
+    /** 组件根节点的内联样式。 */
     style?: CSSProperties;
+    /** 高亮状态样式。 */
     emphasisStyle?: CSSProperties;
+    /** 名称或字段标识。 */
     name: string;
+    /** 图表坐标位置或坐标转换配置。 */
     coordinate: readonly [number, number];
+    /** 该项目对应的数据值，用于标识、选择或计算。 */
     value?: number;
+    /** 显示颜色，可使用 CSS 颜色值。 */
     color?: string;
+    /** 组件尺寸；用于调整控件高度、字号和间距。 */
     size?: number;
+    /** 滚动或淡入效果 */
     effect?: boolean;
 }
+/** 地图上标记连线的端点、样式和动态效果配置。 */
 interface MapMarkLine {
+    /** 图形逐步显示的动画配置。 */
     reveal?: {
+        /** 首次显示动画的持续时间。 */
         initialDuration?: number;
+        /** 更新动画的持续时间。 */
         updateDuration?: number;
     };
+    /** 线条样式。 */
     lineStyle?: CSSProperties;
+    /** 阴影模糊半径。 */
     shadowBlur?: number;
+    /** 连线端点样式。 */
     endpointStyle?: CSSProperties;
+    /** 连线起点和终点使用的图形符号。 */
     endpointSymbols?: readonly ['none' | 'circle', 'circle' | 'arrow'];
+    /** 数据到颜色、大小等视觉通道的映射配置。 */
     visualMap?: boolean;
+    /** 曲线的绘制模式。 */
     curveMode?: 'directional';
+    /** 沿路径移动的动态效果配置。 */
     movingEffect?: {
+        /** 周期动画的周期时长。 */
         period?: number;
+        /** 显示颜色，可使用 CSS 颜色值。 */
         color?: string;
+        /** 图形半径或圆角配置。 */
         radius?: number;
+        /** 阴影模糊半径。 */
         shadowBlur?: number;
+        /** 阴影颜色。 */
         shadowColor?: string;
+        /** 轨迹残影的透明度。 */
         trailAlpha?: number;
     };
+    /** 数据系列名称。 */
     seriesName?: string;
+    /** 是否使用虚线。 */
     dashed?: boolean;
+    /** 连线两端的符号尺寸。 */
     endpointSizes?: readonly [number, number];
+    /** 提示内容或提示框配置。 */
     tooltip?: ReactNode;
+    /** 名称或字段标识。 */
     name?: string;
+    /** 触发来源，用于区分不同入口的操作。 */
     source: readonly [number, number];
+    /** 关联的目标元素或获取目标元素的函数。 */
     target: readonly [number, number];
+    /** 该项目对应的数据值，用于标识、选择或计算。 */
     value?: number;
+    /** 显示颜色，可使用 CSS 颜色值。 */
     color?: string;
+    /** 宽度；数值按像素处理，字符串可使用 CSS 尺寸。 */
     width?: number;
+    /** 连线曲率。 */
     curveness?: number;
+    /** 滚动或淡入效果 */
     effect?: boolean;
 }
+/** 地图的属性配置。 */
 interface MapChartProps extends Omit<SiaChartProps, "children" | "empty"> {
     /** Host map projection into overlay pixels. Re-render when the host viewport changes. */
     overlayProjection?: {
+        /** 将数据或地理坐标投影为绘图坐标。 */
         project: (coordinate: readonly [number, number]) => readonly [number, number];
+        /** 相对于默认位置的偏移。 */
         offset?: readonly [number, number];
     };
+    /** 捆绑连线配置。 */
     bundledLines?: BundledMapLines;
+    /**
+     * 标记线动态效果使用的渲染器。
+     * @defaultValue 'svg'
+     */
     markLineEffectRenderer?: 'svg' | 'canvas';
     /** Batched point groups; points are geographic longitude/latitude pairs. */
     largeMarkPoints?: readonly LargeMapPointCanvasGroup[];
+    /** 地图嵌入区域的样式。 */
     insetStyle?: CSSProperties;
+    /** 地图嵌入区域的标签样式。 */
     insetLabelStyle?: CSSProperties;
+    /**
+     * 地图区域是否响应悬停。
+     * @defaultValue true
+     */
     regionHoverable?: boolean;
+    /** 标记点提示框格式化函数。 */
     markPointTooltipFormatter?: (point: MapMarkPoint) => ReactNode;
+    /**
+     * 是否将视觉映射值限制在配置范围内。
+     * @defaultValue false
+     */
     clampVisualValues?: boolean;
+    /** 滚轮缩放的倍率配置。 */
     wheelZoomFactors?: readonly [number, number];
     /** Hide the map series while retaining title and value-range controls. */
     showMap?: boolean;
+    /** 超出视觉映射范围时的颜色。 */
     outOfRangeColor?: string;
+    /**
+     * 地图漫游控制器配置。
+     * @defaultValue false
+     */
     roamController?: boolean;
+    /** 视觉映射控件的布局配置。 */
     visualMapLayout?: {
+        /** 拖动过程中是否实时通知值变化。 */
         realtime?: boolean;
+        /** 是否使用 SVG 绘制交互手柄。 */
         svgHandles?: boolean;
+        /** 横向位置或 X 轴数据值。 */
         x?: number;
+        /** 纵向位置或 Y 轴数据值。 */
         y?: number;
+        /** 宽度；数值按像素处理，字符串可使用 CSS 尺寸。 */
         width?: number;
+        /** 高度；数值按像素处理，字符串可使用 CSS 尺寸。 */
         height?: number;
+        /** 组件的水平或垂直排列方向。 */
         orientation?: 'horizontal' | 'vertical';
+        /** 展示给用户的名称，可传入文本或 React 节点。 */
         label?: string;
+        /** 范围两端显示的标签。 */
         endLabels?: readonly [string, string];
     };
+    /** 标签文字样式。 */
     labelStyle?: CSSProperties;
+    /** 高亮状态的标签样式。 */
     emphasisLabelStyle?: CSSProperties;
+    /** 地图区域样式。 */
     regionStyle?: CSSProperties;
+    /** 地图区域高亮样式。 */
     emphasisRegionStyle?: CSSProperties;
     /** Omit for .65–5; null removes limits; an object sets optional bounds. */
     scaleLimit?: {
+        /** 允许的最小值。 */
         min?: number;
+        /** 允许的最大值。 */
         max?: number;
     } | null;
+    /** 提示框内容的格式化函数。 */
     tooltipFormatter?: (name: string, datum: MapDatum | undefined) => ReactNode;
+    /**
+     * 高亮时是否显示标签集合。
+     * @defaultValue false
+     */
     showEmphasisLabels?: boolean;
+    /** 经度方向投影的比例系数。 */
     longitudeRatio?: number;
+    /**
+     * 地理区域嵌入配置。
+     * @defaultValue []
+     */
     geographicInsets?: readonly {
+        /** 名称或字段标识。 */
         name: string;
+        /** 图表坐标位置或坐标转换配置。 */
         coordinate: readonly [number, number];
+        /** 多边形集合。 */
         polygons: readonly (readonly (readonly [number, number])[])[];
+        /** 展示给用户的名称，可传入文本或 React 节点。 */
         label: readonly [number, number];
+        /** 每单位经度对应的绘图单位数。 */
         unitsPerLongitude: number;
     }[];
+    /** 绘图区边界。 */
     plotBounds?: {
+        /** 横向位置或 X 轴数据值。 */
         x: number;
+        /** 纵向位置或 Y 轴数据值。 */
         y: number;
+        /** 宽度；数值按像素处理，字符串可使用 CSS 尺寸。 */
         width: number;
+        /** 高度；数值按像素处理，字符串可使用 CSS 尺寸。 */
         height: number;
     };
+    /** 数值轴的数据范围。 */
     valueDomain?: readonly [number, number];
+    /**
+     * 是否显示视觉映射控件。
+     * @defaultValue true
+     */
     showVisualMap?: boolean;
+    /** 数据系列名称。 */
     seriesName?: string;
+    /** 地图标识或地图数据。 */
     map?: string;
+    /** 用于绘制地图的 GeoJSON 数据。 */
     geoJson?: GeoJsonFeatureCollection;
+    /** 用于渲染的数据集合。 */
     data: readonly MapDatum[];
+    /**
+     * 可选颜色或颜色序列。
+     * @defaultValue ["#e6f4ff", "#1677ff"]
+     */
     colors?: readonly string[];
+    /**
+     * 从地理要素属性中读取名称的字段名。
+     * @defaultValue "name"
+     */
     nameProperty?: string;
+    /** 原始名称到显示名称的映射。 */
     nameMap?: Readonly<Record<string, string>>;
+    /** 地图标签的自定义坐标。 */
     labelCoordinates?: Readonly<Record<string, readonly [number, number]>>;
+    /** 标签相对于默认位置的偏移集合。 */
     labelOffsets?: Readonly<Record<string, readonly [number, number]>>;
+    /** 需要单独放置的特殊地理区域。 */
     specialAreas?: Readonly<Record<string, MapSpecialArea>>;
     /** Normalize coordinates before calculating bounds and projecting; source GeoJSON is unchanged. */
     coordinateTransform?: (point: readonly [number, number]) => readonly [number, number];
+    /** 参与高亮的数据值范围。 */
     emphasisValueRange?: readonly [number, number];
+    /** 鼠标悬停地图区域时调用。 */
     onRegionHover?: (datum: MapDatum | undefined) => void;
+    /**
+     * 是否显示数据标签。
+     * @defaultValue true
+     */
     showLabels?: boolean;
+    /**
+     * 地图或图表的平移、缩放配置。
+     * @defaultValue false
+     */
     roam?: boolean | "move" | "scale";
+    /**
+     * 图形的选中模式。
+     * @defaultValue false
+     */
     selectedMode?: false | "single" | "multiple";
+    /** 是否处于选中状态。 */
     selected?: readonly string[];
+    /** 初始化时选中的图形或状态。 */
     defaultSelected?: readonly string[];
+    /** 编辑器选区变化时调用。 */
     onSelectionChange?: (names: string[]) => void;
+    /**
+     * 是否允许拖动视觉映射范围。
+     * @defaultValue false
+     */
     calculableVisualMap?: boolean;
+    /** 受控的视觉映射数值范围。 */
     visualRange?: readonly [number, number];
+    /** 初始视觉映射范围。 */
     defaultVisualRange?: readonly [number, number];
+    /** 视觉映射范围变化时调用。 */
     onVisualRangeChange?: (range: [number, number]) => void;
+    /**
+     * 标记点配置集合。
+     * @defaultValue []
+     */
     markPoints?: readonly MapMarkPoint[];
+    /**
+     * 标记线配置集合。
+     * @defaultValue []
+     */
     markLines?: readonly MapMarkLine[];
+    /** 点击地图区域时调用。 */
     onRegionClick?: (info: ChartDataClickInfo<MapDatum | GeoJsonFeature>) => void;
 }
+/** 注册可供 MapChart 按名称使用的 GeoJSON 地图数据。 */
 declare function registerChartMap(name: string, geoJson: GeoJsonFeatureCollection): void;
+/** 按名称读取已注册的地图数据。 */
 declare function getChartMap(name: string): GeoJsonFeatureCollection | undefined;
+/** 地图组件。 */
 declare const MapChart: react.ForwardRefExoticComponent<MapChartProps & react.RefAttributes<SiaChartRef>>;
+/** Gauge的单条数据。 */
 interface GaugeDatum {
+    /** 组件或浮层的堆叠层级。 */
     zIndex?: number;
+    /** 标签文字粗细。 */
     labelFontWeight?: string | number;
+    /** 名称文字粗细。 */
     nameFontWeight?: string | number;
+    /** 详细数值文字粗细。 */
     detailFontWeight?: string | number;
+    /** 名称文字样式。 */
     nameFontStyle?: string;
+    /** 详细数值的容器样式。 */
     detailBox?: {
+        /** 宽度；数值按像素处理，字符串可使用 CSS 尺寸。 */
         width: number;
+        /** 高度；数值按像素处理，字符串可使用 CSS 尺寸。 */
         height: number;
+        /** 背景颜色或填充配置。 */
         background?: string;
+        /** 边框颜色。 */
         borderColor?: string;
+        /** 边框线宽。 */
         borderWidth?: number;
     };
+    /** 轴线粗细。 */
     axisWidth?: number;
+    /** 坐标轴或仪表盘的分段数量。 */
     splitNumber?: number;
+    /** 刻度数量。 */
     tickCount?: number;
+    /** 刻度线长度。 */
     tickLength?: number;
+    /** 刻度线颜色。 */
     tickColor?: string;
+    /** 是否显示刻度线。 */
     showTicks?: boolean;
+    /** 分隔线长度。 */
     splitLength?: number;
+    /** 分隔线颜色。 */
     splitColor?: string;
+    /** 分隔线宽度。 */
     splitWidth?: number;
+    /** 标签文字颜色。 */
     labelColor?: string;
+    /** 标签字体大小。 */
     labelFontSize?: number;
+    /** 标签文本格式化函数。 */
     labelFormatter?: (value: number) => ReactNode;
+    /** 名称相对于默认位置的偏移。 */
     nameOffset?: readonly [number, number];
+    /** 详细数值的显示位置。 */
     detailPosition?: readonly [number, number];
+    /** 是否显示名称。 */
     showName?: boolean;
+    /** 是否显示详细数值。 */
     showDetail?: boolean;
+    /** 名称文字大小。 */
     nameFontSize?: number;
+    /** 详细数值文字大小。 */
     detailFontSize?: number;
+    /** 名称文字颜色。 */
     nameColor?: string;
+    /** 详细数值文字颜色。 */
     detailColor?: string;
+    /** 指针颜色。 */
     pointerColor?: string;
+    /** 发光效果配置。 */
     glow?: boolean;
+    /** 名称或字段标识。 */
     name: string;
+    /** 该项目对应的数据值，用于标识、选择或计算。 */
     value: number;
+    /** 显示颜色，可使用 CSS 颜色值。 */
     color?: string;
+    /** 允许的最小值。 */
     min?: number;
+    /** 允许的最大值。 */
     max?: number;
+    /** 绘制起始角度。 */
     startAngle?: number;
+    /** 绘制结束角度。 */
     endAngle?: number;
+    /** 中心位置。 */
     center?: readonly [number, number];
+    /** 图形半径或圆角配置。 */
     radius?: number;
+    /** 分段配置。 */
     segments?: readonly {
+        /** 该段有效范围的结束值。 */
         until: number;
+        /** 显示颜色，可使用 CSS 颜色值。 */
         color: string;
     }[];
+    /** 指针宽度。 */
     pointerWidth?: number;
+    /** 指针长度。 */
     pointerLength?: number;
+    /** 数值显示单位。 */
     unit?: string;
 }
+/** 仪表盘的属性配置。 */
 interface GaugeChartProps extends Omit<SiaChartProps, "children" | "empty"> {
+    /** 提示框内容的格式化函数。 */
     tooltipFormatter?: (item: GaugeDatum) => ReactNode;
+    /**
+     * 图形外观配置。
+     * @defaultValue "sia"
+     */
     appearance?: "sia" | "macarons";
+    /** 动画当前进度，通常为 0 到 1。 */
     animationProgress?: number;
+    /** 用于渲染的数据集合。 */
     data: readonly GaugeDatum[];
+    /**
+     * 允许的最小值。
+     * @defaultValue 0
+     */
     min?: number;
+    /**
+     * 允许的最大值。
+     * @defaultValue 100
+     */
     max?: number;
+    /**
+     * 绘制起始角度。
+     * @defaultValue 210
+     */
     startAngle?: number;
+    /**
+     * 绘制结束角度。
+     * @defaultValue -30
+     */
     endAngle?: number;
+    /** 分段配置。 */
     segments?: readonly {
+        /** 该段有效范围的结束值。 */
         until: number;
+        /** 显示颜色，可使用 CSS 颜色值。 */
         color: string;
     }[];
+    /**
+     * 坐标轴或仪表盘的分段数量。
+     * @defaultValue 10
+     */
     splitNumber?: number;
+    /**
+     * 是否显示轴标签。
+     * @defaultValue true
+     */
     showAxisLabels?: boolean;
+    /**
+     * 是否显示进度部分。
+     * @defaultValue true
+     */
     showProgress?: boolean;
+    /**
+     * 详细数值相对于默认位置的偏移。
+     * @defaultValue 84
+     */
     detailOffset?: number;
+    /** 将数值格式化为显示文本的函数。 */
     valueFormatter?: (value: number) => ReactNode;
+    /** 点击图表数据项时调用。 */
     onDataClick?: (info: ChartDataClickInfo<GaugeDatum>) => void;
 }
+/** 仪表盘组件。 */
 declare const GaugeChart: react.ForwardRefExoticComponent<GaugeChartProps & react.RefAttributes<SiaChartRef>>;
+/** Funnel的单条数据。 */
 interface FunnelDatum extends PieDatum {
 }
+/** Funnel的数据系列。 */
 interface FunnelSeries {
+    /** 提示框内容的格式化函数。 */
     tooltipFormatter?: (item: FunnelDatum) => ReactNode;
+    /** 高亮状态的标签位置。 */
     emphasisLabelPosition?: "inside" | "left" | "right";
+    /** 高亮标签格式化函数。 */
     emphasisLabelFormatter?: (item: FunnelDatum) => ReactNode;
+    /** 允许的最小值。 */
     min?: number;
+    /** 允许的最大值。 */
     max?: number;
+    /** 允许的最小尺寸。 */
     minSize?: number;
+    /** 允许的最大尺寸。 */
     maxSize?: number;
+    /** 标签显示位置。 */
     labelPosition?: "inside" | "left" | "right";
+    /** 标签文本格式化函数。 */
     labelFormatter?: (item: FunnelDatum) => ReactNode;
+    /** 是否显示标签引导线。 */
     showLabelLines?: boolean;
+    /** 边框颜色。 */
     borderColor?: string;
+    /** 边框线宽。 */
     borderWidth?: number;
+    /** 饼图中心位置。 */
     pieCenter?: [number, number];
+    /** 名称或字段标识。 */
     name?: string;
+    /** 用于渲染的数据集合。 */
     data: readonly FunnelDatum[];
+    /** 距左侧的位置或间距。 */
     left?: number;
+    /** 距顶部的位置或间距。 */
     top?: number;
+    /** 宽度；数值按像素处理，字符串可使用 CSS 尺寸。 */
     width?: number;
+    /** 高度；数值按像素处理，字符串可使用 CSS 尺寸。 */
     height?: number;
+    /** 数据或图形排序规则。 */
     sort?: "descending" | "ascending" | "none";
+    /** 预设或自定义间距 */
     gap?: number;
+    /** 交叉轴对齐 */
     align?: "center" | "left" | "right";
+    /** 组件的水平或垂直排列方向。 */
     orientation?: "vertical" | "horizontal";
 }
+/** 漏斗图的属性配置。 */
 interface FunnelChartProps extends Omit<SiaChartProps, "children" | "empty"> {
+    /**
+     * 图形外观配置。
+     * @defaultValue "sia"
+     */
     appearance?: "sia" | "macarons";
+    /** 动画当前进度，通常为 0 到 1。 */
     animationProgress?: number;
+    /** 图例的排列顺序。 */
     legendOrder?: readonly string[];
+    /** 图例布局配置。 */
     legendLayout?: {
+        /** 横向位置或 X 轴数据值。 */
         x?: number;
+        /** 纵向位置或 Y 轴数据值。 */
         y?: number;
+        /**
+         组件的水平或垂直排列方向。
+         * @defaultValue "vertical"
+         */
         orientation?: "horizontal" | "vertical";
     };
+    /** 数据被交互修改后调用。 */
     onDataChange?: (series: readonly FunnelSeries[]) => void;
+    /**
+     用于渲染的数据集合。
+     * @defaultValue EMPTY_PIE_DATA
+     */
     data?: readonly FunnelDatum[];
+    /** 图表数据系列。 */
     series?: readonly FunnelSeries[];
+    /**
+     * 数据或图形排序规则。
+     * @defaultValue "descending"
+     */
     sort?: "descending" | "ascending" | "none";
+    /**
+     * 预设或自定义间距
+     * @defaultValue 4
+     */
     gap?: number;
+    /**
+     * 交叉轴对齐
+     * @defaultValue "center"
+     */
     align?: "center" | "left" | "right";
+    /**
+     组件的水平或垂直排列方向。
+     * @defaultValue "vertical"
+     */
     orientation?: "vertical" | "horizontal";
+    /**
+     * 是否显示图例。
+     * @defaultValue true
+     */
     showLegend?: boolean;
+    /**
+     * 是否允许通过图例切换系列显示。
+     * @defaultValue true
+     */
     legendInteractive?: boolean;
+    /** 图例项目的选中状态。 */
     legendSelected?: Readonly<Record<string, boolean>>;
+    /** 图例选中状态变化时调用。 */
     onLegendSelectionChange?: (selected: Record<string, boolean>) => void;
+    /** 点击图表数据项时调用。 */
     onDataClick?: (info: ChartDataClickInfo<FunnelDatum>) => void;
 }
+/** 漏斗图组件。 */
 declare const FunnelChart: react.ForwardRefExoticComponent<FunnelChartProps & react.RefAttributes<SiaChartRef>>;
+/** 热力图数据点，包含坐标及热度值。 */
 interface HeatmapPoint {
+    /** 横向位置或 X 轴数据值。 */
     x: number;
+    /** 纵向位置或 Y 轴数据值。 */
     y: number;
+    /** 该项目对应的数据值，用于标识、选择或计算。 */
     value: number;
+    /** 名称或字段标识。 */
     name?: string;
 }
+/** 热力图的属性配置。 */
 interface HeatmapChartProps extends Omit<SiaChartProps, "children" | "empty"> {
     /** Native pixel-coordinate density mode (no automatic coordinate normalization). */
     raster?: HeatRasterOptions & {
+        /** 宽度；数值按像素处理，字符串可使用 CSS 尺寸。 */
         width: number;
+        /** 高度；数值按像素处理，字符串可使用 CSS 尺寸。 */
         height: number;
+        /** 背景图片配置。 */
         backgroundImage?: string;
     };
+    /**
+     * X 轴标签集合。
+     * @defaultValue []
+     */
     xLabels?: readonly string[];
+    /**
+     * Y 轴标签集合。
+     * @defaultValue []
+     */
     yLabels?: readonly string[];
+    /**
+     用于渲染的数据集合。
+     * @defaultValue []
+     */
     data?: readonly (readonly number[])[];
+    /**
+     * 数据点集合。
+     * @defaultValue []
+     */
     points?: readonly HeatmapPoint[];
+    /**
+     * 可选颜色或颜色序列。
+     * @defaultValue ["#e6f4ff", "#1677ff"]
+     */
     colors?: readonly [string, string];
+    /**
+     * 是否显示数据值。
+     * @defaultValue false
+     */
     showValues?: boolean;
+    /**
+     * 数据点半径。
+     * @defaultValue 30
+     */
     pointRadius?: number;
+    /**
+     * 模糊半径。
+     * @defaultValue 16
+     */
     blur?: number;
+    /**
+     * 最小透明度。
+     * @defaultValue .12
+     */
     minAlpha?: number;
+    /**
+     * 最大透明度。
+     * @defaultValue .82
+     */
     maxAlpha?: number;
+    /** 将数值格式化为显示文本的函数。 */
     valueFormatter?: (value: number) => ReactNode;
+    /** 点击图表数据项时调用。 */
     onDataClick?: (info: ChartDataClickInfo<number | HeatmapPoint>) => void;
 }
+/** 热力图组件。 */
 declare const HeatmapChart: react.ForwardRefExoticComponent<HeatmapChartProps & react.RefAttributes<SiaChartRef>>;
+/** ThemeRiver的数据系列。 */
 interface ThemeRiverSeries extends ChartSeries {
 }
+/** 主题河流图的属性配置。 */
 interface ThemeRiverChartProps extends Omit<SiaChartProps, "children" | "empty"> {
+    /** 类目或数据分组集合。 */
     categories: readonly string[];
+    /** 图表数据系列。 */
     series: readonly ThemeRiverSeries[];
+    /**
+     * 是否允许通过图例切换系列显示。
+     * @defaultValue true
+     */
     legendInteractive?: boolean;
+    /** 图例项目的选中状态。 */
     legendSelected?: Readonly<Record<string, boolean>>;
+    /** 图例选中状态变化时调用。 */
     onLegendSelectionChange?: (selected: Record<string, boolean>) => void;
+    /** 点击图表数据项时调用。 */
     onDataClick?: (info: ChartDataClickInfo<number>) => void;
 }
+/** 主题河流图组件。 */
 declare const ThemeRiverChart: react.ForwardRefExoticComponent<ThemeRiverChartProps & react.RefAttributes<SiaChartRef>>;
+/** 事件随时间变化的一个阶段。 */
 interface EventRiverEvolution {
+    /** 关联的时间值。 */
     time: string | number | Date;
+    /** 该项目对应的数据值，用于标识、选择或计算。 */
     value: number;
+    /** 简短的补充说明。 */
     detail?: ReactNode;
 }
+/** 事件河流图中的事件及其演变序列。 */
 interface EventRiverEvent {
+    /** 名称或字段标识。 */
     name: string;
+    /** 唯一标识，用于关联实例或插件。 */
     id?: string;
+    /** 布局或数据计算使用的权重。 */
     weight?: number;
+    /** 事件随时间演变的数据序列。 */
     evolution: readonly EventRiverEvolution[];
 }
+/** EventRiver的数据系列。 */
 interface EventRiverSeries {
+    /** 名称或字段标识。 */
     name: string;
+    /** 布局或数据计算使用的权重。 */
     weight?: number;
+    /** 用于渲染的数据集合。 */
     data: readonly EventRiverEvent[];
+    /** 显示颜色，可使用 CSS 颜色值。 */
     color?: string;
 }
+/** 事件河流图的属性配置。 */
 interface EventRiverChartProps extends Omit<SiaChartProps, "children" | "empty"> {
+    /** 图表数据系列。 */
     series: readonly EventRiverSeries[];
+    /**
+     * 是否显示数据标签。
+     * @defaultValue true
+     */
     showLabels?: boolean;
+    /**
+     * 是否允许拖拽。
+     * @defaultValue true
+     */
     draggable?: boolean;
+    /**
+     * 图形外观配置。
+     * @defaultValue 'sia'
+     */
     appearance?: 'sia' | 'macarons';
+    /**
+     * 绘图区或图形绘制配置。
+     * @defaultValue PLOT
+     */
     plot?: {
+        /** 横向位置或 X 轴数据值。 */
         x: number;
+        /** 纵向位置或 Y 轴数据值。 */
         y: number;
+        /** 宽度；数值按像素处理，字符串可使用 CSS 尺寸。 */
         width: number;
+        /** 高度；数值按像素处理，字符串可使用 CSS 尺寸。 */
         height: number;
     };
+    /** 动画当前进度，通常为 0 到 1。 */
     animationProgress?: number;
     /** Time-axis fractional padding before and after the observed data. */
     boundaryGap?: readonly [number, number];
+    /**
+     * 是否允许通过图例切换系列显示。
+     * @defaultValue true
+     */
     legendInteractive?: boolean;
+    /** 图例项目的选中状态。 */
     legendSelected?: Readonly<Record<string, boolean>>;
+    /** 图例选中状态变化时调用。 */
     onLegendSelectionChange?: (selected: Record<string, boolean>) => void;
+    /** 点击图表数据项时调用。 */
     onDataClick?: (info: ChartDataClickInfo<EventRiverEvent>) => void;
 }
+/** 事件河流图组件。 */
 declare const EventRiverChart: react.ForwardRefExoticComponent<EventRiverChartProps & react.RefAttributes<SiaChartRef>>;
+/** 韦恩图中的集合定义。 */
 interface VennSet {
+    /** 名称或字段标识。 */
     name: string;
+    /** 该项目对应的数据值，用于标识、选择或计算。 */
     value: number;
+    /** 显示颜色，可使用 CSS 颜色值。 */
     color?: string;
 }
+/** 韦恩图集合交集的值及展示配置。 */
 interface VennIntersection {
+    /** 该项目对应的数据值，用于标识、选择或计算。 */
     value: number;
+    /** 名称或字段标识。 */
     name?: string;
+    /** 显示颜色，可使用 CSS 颜色值。 */
     color?: string;
 }
+/** 韦恩图的属性配置。 */
 interface VennChartProps extends Omit<SiaChartProps, "children" | "empty"> {
+    /**
+     * 图形外观配置。
+     * @defaultValue "sia"
+     */
     appearance?: "sia" | "macarons";
+    /** 高亮状态的颜色。 */
     emphasisColor?: string;
+    /** 高亮状态的边框颜色。 */
     emphasisBorderColor?: string;
+    /** 高亮状态的边框宽度。 */
     emphasisBorderWidth?: number;
+    /** 集合定义。 */
     sets: readonly [VennSet, VennSet];
+    /** 集合交集数据。 */
     intersection: VennIntersection;
+    /** 点击图表数据项时调用。 */
     onDataClick?: (info: ChartDataClickInfo<VennSet | VennIntersection>) => void;
 }
+/** 韦恩图组件。 */
 declare const VennChart: react.ForwardRefExoticComponent<VennChartProps & react.RefAttributes<SiaChartRef>>;
+/** 矩形树图数据项的填充、边框和标签样式。 */
 interface TreemapItemStyle {
+    /** 显示颜色，可使用 CSS 颜色值。 */
     color?: string;
+    /** 边框颜色。 */
     borderColor?: string;
+    /** 边框线宽。 */
     borderWidth?: number;
+    /** 展示给用户的名称，可传入文本或 React 节点。 */
     label?: {
+        /** 是否显示该功能。 */
         show?: boolean;
+        /** 将原始值转换为展示文本的函数。 */
         formatter?: string;
+        /** 横向位置或 X 轴数据值。 */
         x?: number;
+        /** 纵向位置或 Y 轴数据值。 */
         y?: number;
+        /** 显示颜色，可使用 CSS 颜色值。 */
         color?: string;
+        /** 文字大小，单位为像素。 */
         fontSize?: number;
+        /** 字体族名称。 */
         fontFamily?: string;
+        /** 字体样式，例如 normal 或 italic。 */
         fontStyle?: "normal" | "italic";
+        /** 文字粗细，可使用数字或 CSS 字重名称。 */
         fontWeight?: string | number;
     };
 }
+/** 矩形树图的单条数据。 */
 interface TreemapDatum {
+    /** 名称或字段标识。 */
     name: string;
+    /** 该项目对应的数据值，用于标识、选择或计算。 */
     value?: number;
+    /** 显示颜色，可使用 CSS 颜色值。 */
     color?: string;
+    /** 子内容；组件嵌套内容或当前节点的子项。 */
     children?: readonly TreemapDatum[];
+    /** 组件根节点的内联样式。 */
     style?: TreemapItemStyle;
+    /** 高亮状态配置。 */
     emphasis?: TreemapItemStyle;
 }
+/** 矩形树图的属性配置。 */
 interface TreemapChartProps extends Omit<SiaChartProps, "children" | "empty"> {
+    /** 用于渲染的数据集合。 */
     data: readonly TreemapDatum[];
+    /**
+     * 预设或自定义间距
+     * @defaultValue 4
+     */
     gap?: number;
+    /**
+     * 允许展示的最大层级深度。
+     * @defaultValue 2
+     */
     maxDepth?: number;
+    /**
+     * 是否支持点击节点下钻。
+     * @defaultValue false
+     */
     drilldown?: boolean;
+    /**
+     * 是否显示下钻路径面包屑。
+     * @defaultValue true
+     */
     showBreadcrumb?: boolean;
+    /** 布局边界。 */
     bounds?: TreemapLayoutBox;
+    /** 数据项样式。 */
     itemStyle?: TreemapItemStyle;
+    /** 高亮状态配置。 */
     emphasis?: TreemapItemStyle;
+    /**
+     * 图形圆角半径。
+     * @defaultValue 5
+     */
     cornerRadius?: number;
+    /**
+     * 是否显示子节点边界。
+     * @defaultValue false
+     */
     showChildBoundaries?: boolean;
+    /**
+     * 面包屑显示位置。
+     * @defaultValue "top"
+     */
     breadcrumbPosition?: "top" | "bottom";
+    /**
+     * 面包屑根节点名称。
+     * @defaultValue "全部"
+     */
     breadcrumbRootName?: string;
+    /** 将数值格式化为显示文本的函数。 */
     valueFormatter?: (value: number) => ReactNode;
+    /** 点击图表数据项时调用。 */
     onDataClick?: (info: ChartDataClickInfo<TreemapDatum>) => void;
 }
+/** 矩形树图组件。 */
 declare const TreemapChart: react.ForwardRefExoticComponent<TreemapChartProps & react.RefAttributes<SiaChartRef>>;
+/** 树的单条数据。 */
 interface TreeDatum {
+    /** 名称或字段标识。 */
     name: string;
+    /** 该项目对应的数据值，用于标识、选择或计算。 */
     value?: number;
+    /** 显示颜色，可使用 CSS 颜色值。 */
     color?: string;
+    /** 子内容；组件嵌套内容或当前节点的子项。 */
     children?: readonly TreeDatum[];
+    /** 是否收起；传入后由外部控制。 */
     collapsed?: boolean;
+    /** 数据点或节点使用的图形符号。 */
     symbol?: "circle" | "square" | "diamond" | `image://${string}`;
+    /** 数据项样式。 */
     itemStyle?: TreeItemStyle;
+    /** 高亮状态配置。 */
     emphasis?: TreeItemStyle;
+    /** 数据符号尺寸。 */
     symbolSize?: number | readonly [number, number];
 }
+/** 树图的属性配置。 */
 interface TreeChartProps extends Omit<SiaChartProps, "children" | "empty"> {
+    /** 数据项样式。 */
     itemStyle?: TreeItemStyle;
+    /** 高亮状态配置。 */
     emphasis?: TreeItemStyle;
+    /** 用于渲染的数据集合。 */
     data: TreeDatum;
+    /**
+     组件的水平或垂直排列方向。
+     * @defaultValue "horizontal"
+     */
     orientation?: "horizontal" | "vertical";
+    /**
+     * 是否使用径向布局。
+     * @defaultValue false
+     */
     radial?: boolean;
+    /**
+     * 节点尺寸。
+     * @defaultValue 8
+     */
     nodeSize?: number;
+    /** 根节点的布局位置。 */
     rootPosition?: readonly [number, number];
+    /** 相邻节点的间距。 */
     nodePadding?: number;
+    /** 相邻层级的间距。 */
     layerPadding?: number;
+    /**
+     * 是否显示数据标签。
+     * @defaultValue true
+     */
     showLabels?: boolean;
+    /**
+     * 高亮时是否显示节点标签。
+     * @defaultValue true
+     */
     emphasisShowLabels?: boolean;
+    /** 节点颜色。 */
     nodeColor?: string;
+    /** 边的颜色。 */
     edgeColor?: string;
+    /** 边的线宽。 */
     edgeWidth?: number;
+    /** 边的阴影配置。 */
     edgeShadow?: {
+        /** 显示颜色，可使用 CSS 颜色值。 */
         color: string;
+        /** 模糊半径。 */
         blur: number;
+        /** 水平方向的偏移量。 */
         offsetX: number;
+        /** 垂直方向的偏移量。 */
         offsetY: number;
     };
+    /**
+     * 地图或图表的平移、缩放配置。
+     * @defaultValue false
+     */
     roam?: boolean;
+    /**
+     * 是否启用鼠标悬停反馈。
+     * @defaultValue true
+     */
     hoverable?: boolean;
+    /** 标签字体大小。 */
     labelFontSize?: number;
+    /** 标签文字颜色。 */
     labelColor?: string;
+    /**
+     * 节点连线样式。
+     * @defaultValue "curve"
+     */
     linkStyle?: "curve" | "broken" | "straight";
+    /**
+     * 允许收起内容区域
+     * @defaultValue false
+     */
     collapsible?: boolean;
+    /** 节点或交互状态切换时调用。 */
     onToggle?: (node: TreeDatum, collapsed: boolean) => void;
+    /** 点击图表数据项时调用。 */
     onDataClick?: (info: ChartDataClickInfo<TreeDatum>) => void;
 }
+/** 树图组件。 */
 declare const TreeChart: react.ForwardRefExoticComponent<TreeChartProps & react.RefAttributes<SiaChartRef>>;
+/** WordCloud的单条数据。 */
 interface WordCloudDatum {
+    /** 名称或字段标识。 */
     name: string;
+    /** 该项目对应的数据值，用于标识、选择或计算。 */
     value: number;
+    /** 显示颜色，可使用 CSS 颜色值。 */
     color?: string;
+    /** 旋转角度。 */
     rotation?: number;
+    /** 文字大小，单位为像素。 */
     fontSize?: number;
+    /** 字体族名称。 */
     fontFamily?: string;
+    /** 文字粗细，可使用数字或 CSS 字重名称。 */
     fontWeight?: number | string;
 }
+/** 词云的属性配置。 */
 interface WordCloudChartProps extends Omit<SiaChartProps, "children" | "empty"> {
+    /**
+     * 图形面积的计算方式。
+     * @defaultValue false
+     */
     areaSizing?: boolean;
+    /** 布局边界。 */
     bounds?: CloudBounds;
+    /**
+     * 是否自动适配可用绘图空间。
+     * @defaultValue false
+     */
     autoFit?: boolean;
+    /** 布局计算完成时调用。 */
     onLayout?: (result: {
+        /** 成功放置的词条集合。 */
         placed: number;
+        /** 未能放入布局的词条集合。 */
         unplaced: readonly string[];
     }) => void;
+    /** 用于渲染的数据集合。 */
     data: readonly WordCloudDatum[];
+    /**
+     * 允许的最小文字大小。
+     * @defaultValue 14
+     */
     minFontSize?: number;
+    /**
+     * 允许的最大文字大小。
+     * @defaultValue 52
+     */
     maxFontSize?: number;
+    /**
+     * 允许的文字旋转角度集合。
+     * @defaultValue [0, 0, -28, 28, 0]
+     */
     rotations?: readonly number[];
+    /**
+     * 词云布局螺旋搜索的步长。
+     * @defaultValue 9
+     */
     spiralStep?: number;
+    /**
+     * 外观形状。
+     * @defaultValue "ellipse"
+     */
     shape?: "ellipse" | "circle" | "square" | "diamond";
+    /**
+     * 内容内边距。
+     * @defaultValue 4
+     */
     padding?: number;
+    /** 字体族名称。 */
     fontFamily?: string;
+    /**
+     * 文字粗细，可使用数字或 CSS 字重名称。
+     * @defaultValue 650
+     */
     fontWeight?: number | string;
+    /** 点击图表数据项时调用。 */
     onDataClick?: (info: ChartDataClickInfo<WordCloudDatum>) => void;
 }
+/** 词云组件。 */
 declare const WordCloudChart: react.ForwardRefExoticComponent<WordCloudChartProps & react.RefAttributes<SiaChartRef>>;
+/** Mixed的数据系列。 */
 interface MixedSeries extends Omit<ChartSeries, 'data'> {
     /** Distinct co-located category axes own separate bar groups and stacking totals. */
     categoryAxisIndex?: number;
     /** Diameter in chart coordinates; defaults to the existing 9px marker. */
     symbolSize?: number;
+    /** 数据点是否使用空心符号。 */
     hollowSymbol?: boolean;
+    /** 面积填充透明度。 */
     areaOpacity?: number;
+    /** 数据采样方式，用于减少绘制点数。 */
     sampling?: 'pixel';
+    /** 标记使用的图形符号。 */
     markSymbol?: 'arrow' | 'none';
+    /** 是否显示标记标签。 */
     showMarkLabel?: boolean;
+    /** 提示框按数据项还是坐标轴触发。 */
     tooltipTrigger?: 'item' | 'axis';
+    /** 用于渲染的数据集合。 */
     data: readonly (number | null)[];
+    /** 堆叠分组标识；同标识的数据系列参与同组堆叠。 */
     stack?: string;
+    /** 柱形宽度。 */
     barWidth?: number;
+    /** 柱形圆角。 */
     barRadius?: number;
+    /** 各数据点的颜色。 */
     pointColors?: readonly (string | undefined)[];
+    /** 是否显示数据点。 */
     showPoints?: boolean;
+    /** 线条样式。 */
     lineStyle?: 'solid' | 'dashed' | 'dotted';
+    /** 线条粗细。 */
     lineWidth?: number;
+    /** 是否显示平均值标记。 */
     markAverage?: boolean;
+    /** 标记颜色。 */
     markColor?: string;
+    /** 标记文本格式化函数。 */
     markFormatter?: (value: number) => ReactNode;
     /** Index into valueAxes; distinct units must never share an inferred range. */
     valueAxisIndex?: number;
+    /** 类型标识，用于选择对应的表现形式。 */
     type: "line" | "bar";
+    /** 连接数据点的曲线类型。 */
     curve?: LineSeries["curve"];
+    /** 面积区域填充配置。 */
     area?: boolean;
 }
+/** 混合图的属性配置。 */
 interface MixedChartProps extends Omit<CartesianChartProps, "series"> {
+    /** 坐标轴指示线配置。 */
     axisPointer?: boolean | {
+        /** 显示颜色，可使用 CSS 颜色值。 */
         color?: string;
+        /** 宽度；数值按像素处理，字符串可使用 CSS 尺寸。 */
         width?: number;
+        /** 线条样式。 */
         lineStyle?: 'solid' | 'dashed' | 'dotted';
+        /** 是否对齐到像素网格。 */
         pixelAlign?: boolean;
+        /** 是否联动高亮关联数据。 */
         linkedEmphasis?: boolean;
     };
     /** Labels for co-located category axes, used by axis-specific tooltips and accessible marks. */
     categoryAxisLabels?: readonly (readonly string[])[];
+    /** 柱形之间的间距配置。 */
     barSpacing?: MixedBarSpacing;
     /** With overlay enabled, renderAxes is called for base content and then foreground strokes. */
     axisLayering?: 'inline' | 'overlay';
+    /** 是否绘制坐标轴或自定义轴渲染函数。 */
     renderAxes?: (context: {
+        /** 当前图层标识或图层配置。 */
         layer: 'all' | 'base' | 'line';
+        /** 绘图区或图形绘制配置。 */
         plot: {
+            /** 横向位置或 X 轴数据值。 */
             x: number;
+            /** 纵向位置或 Y 轴数据值。 */
             y: number;
+            /** 宽度；数值按像素处理，字符串可使用 CSS 尺寸。 */
             width: number;
+            /** 高度；数值按像素处理，字符串可使用 CSS 尺寸。 */
             height: number;
         };
+        /** 各类目在绘图区中的位置。 */
         categoryPositions: readonly number[];
+        /** 各数值轴的数据范围。 */
         valueDomains: readonly (readonly [number, number, number])[];
     }) => ReactNode;
+    /**
+     * 坐标位置变化时的动画配置。
+     * @defaultValue false
+     */
     coordinateAnimation?: boolean;
+    /** 动画当前进度，通常为 0 到 1。 */
     animationProgress?: number;
+    /**
+     * 数据更新动画的持续时间。
+     * @defaultValue 500
+     */
     animationDurationUpdate?: number;
     /** Leave half a category slot at either end; bars always require category slots. */
     boundaryGap?: boolean;
     /** Clip series geometry and hit targets to the plot (fixed domains). */
     clipPlot?: boolean;
+    /** 当前激活的数据索引。 */
     activeIndex?: number | null;
+    /** 当前激活数据索引变化时调用。 */
     onActiveIndexChange?: (index: number | null) => void;
+    /**
+     * 是否显示类目标签。
+     * @defaultValue true
+     */
     showCategoryLabels?: boolean;
+    /**
+     * 类目标签显示间隔。
+     * @defaultValue 0
+     */
     categoryLabelInterval?: number | "auto";
+    /** 数据转移的关联标识。 */
     transferId?: string;
+    /** 图表间转移数据值时调用。 */
     onValueTransfer?: ChartValueTransferHandler;
+    /**
+     * 是否允许通过拖拽图形修改数据。
+     * @defaultValue false
+     */
     calculable?: boolean;
+    /** 图表间数据转移失败时调用。 */
     onTransferError?: (message: string) => void;
+    /**
+     * 提示框按数据项还是坐标轴触发。
+     * @defaultValue 'item'
+     */
     tooltipTrigger?: 'item' | 'axis';
+    /** 图例名称集合。 */
     legendNames?: readonly string[];
+    /** 坐标轴提示内容格式化函数。 */
     axisTooltipFormatter?: (index: number, series: readonly MixedSeries[], categoryAxisIndex?: number) => ReactNode;
+    /** 图例布局配置。 */
     legendLayout?: {
+        /** 横向位置或 X 轴数据值。 */
         x?: number;
+        /** 纵向位置或 Y 轴数据值。 */
         y?: number;
+        /** 允许的最大宽度。 */
         maxWidth?: number;
+        /** 数据点或节点使用的图形符号。 */
         symbol?: 'rect' | 'line' | 'sector' | 'auto';
     };
+    /** 绘图区边界。 */
     plotBounds?: {
+        /** 横向位置或 X 轴数据值。 */
         x: number;
+        /** 纵向位置或 Y 轴数据值。 */
         y: number;
+        /** 宽度；数值按像素处理，字符串可使用 CSS 尺寸。 */
         width: number;
+        /** 高度；数值按像素处理，字符串可使用 CSS 尺寸。 */
         height: number;
     };
+    /** 数据被交互修改后调用。 */
     onDataChange?: (series: readonly MixedSeries[]) => void;
+    /**
+     * 是否堆叠展示数据系列。
+     * @defaultValue false
+     */
     stacked?: boolean;
+    /** 多数值轴配置集合。 */
     valueAxes?: readonly {
+        /** 是否根据数据自动计算轴范围。 */
         autoDomain?: MixedValueDomainOptions;
+        /** 名称或字段标识。 */
         name?: string;
+        /** 坐标轴的数据取值范围。 */
         domain?: readonly [number, number, number];
+        /** 显示位置或定位配置。 */
         position?: 'left' | 'right';
+        /** 将原始值转换为展示文本的函数。 */
         formatter?: (value: number) => string;
+        /** 坐标轴线颜色。 */
         axisColor?: string;
+        /** 网格线颜色。 */
         gridColor?: string;
+        /** 是否显示刻度线。 */
         showTicks?: boolean;
+        /** 名称的文字样式。 */
         nameStyle?: CSSProperties;
     }[];
+    /** 图表数据系列。 */
     series: readonly MixedSeries[];
+    /** 点击图表数据项时调用。 */
     onDataClick?: (info: ChartDataClickInfo<number>) => void;
 }
+/** 混合图组件。 */
 declare const MixedChart: react.ForwardRefExoticComponent<MixedChartProps & react.RefAttributes<SiaChartRef>>;
 /** ECharts 2 文档中的 KLine 命名兼容别名。 */
 declare const KLineChart: react.ForwardRefExoticComponent<CandlestickChartProps & react.RefAttributes<SiaChartRef>>;