@damoqiongqiu/ice-chart 0.17.0

package/dist/types/components/GridLines.d.ts

@@ -0,0 +1,37 @@
+import { ChartComponent } from './ChartComponent';
+import type { ChartTheme, GridOption } from '../types';
+import type { Rect } from '../internal';
+import type { Scale } from '../scale';
+/** 网格线。绘制在 series 之下，不参与命中测试。 */
+export declare class GridLines extends ChartComponent {
+    xScale: Scale | null;
+    yScale: Scale | null;
+    /** 水平网格线：每个 y 轴一组（默认只有主轴画网格线）。 */
+    horizontal: Array<{
+        scale: Scale;
+        ticks: any[];
+        index?: number;
+    }>;
+    plot: Rect;
+    grid: GridOption;
+    theme: ChartTheme | null;
+    /** 坐标轴组件：网格线的位置**全部问坐标轴要**，保证过渡期间两者不脱节。 */
+    axisX: any;
+    axisYList: any[];
+    constructor(props: {
+        width: number;
+        height: number;
+        zIndex?: number;
+    });
+    /**
+     * 由 ICEChart 在坐标轴同步之后调用。
+     *
+     * 网格线不自己算位置（位置全部读坐标轴的 `renderedTickPos`），但必须**每帧重绘**，
+     * 所以借一条与刻度同长的补间当「脏驱动」——否则标签在滑动、网格线却停在旧位置。
+     */
+    syncTicks(): void;
+    /** 某个 y 轴刻度的当前渲染位置（过渡中取中间值）。 */
+    private yTickPos;
+    private xTickPos;
+    protected doRender(): void;
+}

package/dist/types/components/Highlight.d.mts

@@ -0,0 +1,34 @@
+import { ChartComponent } from './ChartComponent.mjs';
+import type { ChartTheme } from '../types.mjs';
+export interface HighlightItem {
+    /** 标记中心：圆环是圆心，柱形是矩形中心。 */
+    x: number;
+    y: number;
+    color: string;
+    /** 圆点标记的直径（shape 为 circle 时使用）。 */
+    size: number;
+    /** 标记形状：数据点用圆环，柱形用矩形描边（更贴合图形语义）。 */
+    shape?: 'circle' | 'rect';
+    /** shape 为 rect 时的尺寸（以 x/y 为中心的宽高）。 */
+    width?: number;
+    height?: number;
+}
+/**
+ * 高亮层：悬停标记环 + 选中标记环。
+ *
+ * 它是一块独立的小组件，而不是让 series 重绘自己 —— 鼠标在数据点上移动时，
+ * 只有这一个组件变脏，脏矩形就是标记环那一小块像素，series 的折线/柱子完全不动。
+ */
+export declare class Highlight extends ChartComponent {
+    theme: ChartTheme | null;
+    hoverItems: HighlightItem[];
+    selectionItems: HighlightItem[];
+    constructor(props: {
+        width: number;
+        height: number;
+        zIndex?: number;
+    });
+    setHover(items: HighlightItem[]): this;
+    setSelection(items: HighlightItem[]): this;
+    protected doRender(): void;
+}

package/dist/types/components/Highlight.d.ts

@@ -0,0 +1,34 @@
+import { ChartComponent } from './ChartComponent';
+import type { ChartTheme } from '../types';
+export interface HighlightItem {
+    /** 标记中心：圆环是圆心，柱形是矩形中心。 */
+    x: number;
+    y: number;
+    color: string;
+    /** 圆点标记的直径（shape 为 circle 时使用）。 */
+    size: number;
+    /** 标记形状：数据点用圆环，柱形用矩形描边（更贴合图形语义）。 */
+    shape?: 'circle' | 'rect';
+    /** shape 为 rect 时的尺寸（以 x/y 为中心的宽高）。 */
+    width?: number;
+    height?: number;
+}
+/**
+ * 高亮层：悬停标记环 + 选中标记环。
+ *
+ * 它是一块独立的小组件，而不是让 series 重绘自己 —— 鼠标在数据点上移动时，
+ * 只有这一个组件变脏，脏矩形就是标记环那一小块像素，series 的折线/柱子完全不动。
+ */
+export declare class Highlight extends ChartComponent {
+    theme: ChartTheme | null;
+    hoverItems: HighlightItem[];
+    selectionItems: HighlightItem[];
+    constructor(props: {
+        width: number;
+        height: number;
+        zIndex?: number;
+    });
+    setHover(items: HighlightItem[]): this;
+    setSelection(items: HighlightItem[]): this;
+    protected doRender(): void;
+}

package/dist/types/components/Legend.d.mts

@@ -0,0 +1,26 @@
+import { ChartComponent } from './ChartComponent.mjs';
+import type { ChartTheme } from '../types.mjs';
+import type { ChartLayout, LegendItemLayout } from '../internal.mjs';
+/**
+ * 图例。每个图例项都是命中目标：containsLocalPoint 只在自己项的矩形内返回 true，
+ * 因此引擎的命中测试会把点击精确交给图例本身，而不是整块画布。
+ */
+export declare class Legend extends ChartComponent {
+    layout: ChartLayout | null;
+    theme: ChartTheme | null;
+    selectable: boolean;
+    /** 当前悬停的图例项下标；-1 表示无。 */
+    hoverIndex: number;
+    constructor(props: {
+        width: number;
+        height: number;
+        zIndex?: number;
+    });
+    get items(): LegendItemLayout[];
+    /** 命中项下标；-1 表示没命中。 */
+    hitItem(localX: number, localY: number): number;
+    protected containsLocalPoint(localX: number, localY: number): boolean;
+    protected doRender(): void;
+}
+/** 圆角矩形路径（不依赖 roundRect API，兼容小程序基础库）。 */
+export declare function roundRect(ctx: any, x: number, y: number, w: number, h: number, r: number): void;

package/dist/types/components/Legend.d.ts

@@ -0,0 +1,26 @@
+import { ChartComponent } from './ChartComponent';
+import type { ChartTheme } from '../types';
+import type { ChartLayout, LegendItemLayout } from '../internal';
+/**
+ * 图例。每个图例项都是命中目标：containsLocalPoint 只在自己项的矩形内返回 true，
+ * 因此引擎的命中测试会把点击精确交给图例本身，而不是整块画布。
+ */
+export declare class Legend extends ChartComponent {
+    layout: ChartLayout | null;
+    theme: ChartTheme | null;
+    selectable: boolean;
+    /** 当前悬停的图例项下标；-1 表示无。 */
+    hoverIndex: number;
+    constructor(props: {
+        width: number;
+        height: number;
+        zIndex?: number;
+    });
+    get items(): LegendItemLayout[];
+    /** 命中项下标；-1 表示没命中。 */
+    hitItem(localX: number, localY: number): number;
+    protected containsLocalPoint(localX: number, localY: number): boolean;
+    protected doRender(): void;
+}
+/** 圆角矩形路径（不依赖 roundRect API，兼容小程序基础库）。 */
+export declare function roundRect(ctx: any, x: number, y: number, w: number, h: number, r: number): void;

package/dist/types/components/PlotArea.d.mts

@@ -0,0 +1,21 @@
+import { ChartComponent } from './ChartComponent.mjs';
+/**
+ * 绘图区背景 + 空白处交互面。
+ *
+ * 它存在的意义不只是背景色：当指针落在绘图区但**没有命中任何数据标记**时
+ * （系列组件的 containsLocalPoint 返回 false），引擎的命中测试会落到这个组件上，
+ * 于是「拖拽平移 / 框选 / 点击空白取消选中」才有明确的宿主。
+ */
+export declare class PlotArea extends ChartComponent {
+    background: string | null;
+    borderColor: string | null;
+    constructor(props: {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+        zIndex?: number;
+    });
+    setBackground(color: string | null): this;
+    protected doRender(): void;
+}

package/dist/types/components/PlotArea.d.ts

@@ -0,0 +1,21 @@
+import { ChartComponent } from './ChartComponent';
+/**
+ * 绘图区背景 + 空白处交互面。
+ *
+ * 它存在的意义不只是背景色：当指针落在绘图区但**没有命中任何数据标记**时
+ * （系列组件的 containsLocalPoint 返回 false），引擎的命中测试会落到这个组件上，
+ * 于是「拖拽平移 / 框选 / 点击空白取消选中」才有明确的宿主。
+ */
+export declare class PlotArea extends ChartComponent {
+    background: string | null;
+    borderColor: string | null;
+    constructor(props: {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+        zIndex?: number;
+    });
+    setBackground(color: string | null): this;
+    protected doRender(): void;
+}

package/dist/types/components/PolarGrid.d.mts

@@ -0,0 +1,34 @@
+import { ChartComponent } from './ChartComponent.mjs';
+import type { ChartTheme, PolarGridOption } from '../types.mjs';
+import type { ChartLayout, Rect } from '../internal.mjs';
+import type { Scale } from '../scale.mjs';
+export interface PolarGridCoord {
+    plot: Rect;
+    /** 直角坐标的比例尺：极坐标网格画在直角坐标场景里（配合 aspect: 'equal'）。 */
+    xScale: Scale;
+    yScale: Scale;
+    options: PolarGridOption;
+}
+/**
+ * 极坐标网格：同心圆 + 角度辐条 + 角度刻度（MATLAB `polarplot` 的那套底图）。
+ *
+ * 为什么画在直角坐标场景里：`r(θ)` 曲线本身就是 `(r·cosθ, r·sinθ)` 的参数曲线，
+ * 只要坐标轴等比（`aspect: 'equal'`），几何就是圆的；网格跟着同一套比例尺走即可，
+ * 不需要再造一个极坐标场景（雷达图那套有指标轴，语义不同）。
+ *
+ * 圆心取 **比例尺映射后的原点**（不是绘图区中心）—— 数据域不对称时原点并不在中心。
+ * 半径取「原点到最近一条绘图区边界的距离」，保证同心圆始终完整落在绘图区内。
+ */
+export declare class PolarGrid extends ChartComponent {
+    coord: PolarGridCoord | null;
+    theme: ChartTheme | null;
+    layout: ChartLayout | null;
+    constructor(props: {
+        width: number;
+        height: number;
+        zIndex?: number;
+    });
+    /** 网格半径（数据单位）与圆心像素：半径 = 原点到最近边界。 */
+    private geometry;
+    protected doRender(): void;
+}

package/dist/types/components/PolarGrid.d.ts

@@ -0,0 +1,34 @@
+import { ChartComponent } from './ChartComponent';
+import type { ChartTheme, PolarGridOption } from '../types';
+import type { ChartLayout, Rect } from '../internal';
+import type { Scale } from '../scale';
+export interface PolarGridCoord {
+    plot: Rect;
+    /** 直角坐标的比例尺：极坐标网格画在直角坐标场景里（配合 aspect: 'equal'）。 */
+    xScale: Scale;
+    yScale: Scale;
+    options: PolarGridOption;
+}
+/**
+ * 极坐标网格：同心圆 + 角度辐条 + 角度刻度（MATLAB `polarplot` 的那套底图）。
+ *
+ * 为什么画在直角坐标场景里：`r(θ)` 曲线本身就是 `(r·cosθ, r·sinθ)` 的参数曲线，
+ * 只要坐标轴等比（`aspect: 'equal'`），几何就是圆的；网格跟着同一套比例尺走即可，
+ * 不需要再造一个极坐标场景（雷达图那套有指标轴，语义不同）。
+ *
+ * 圆心取 **比例尺映射后的原点**（不是绘图区中心）—— 数据域不对称时原点并不在中心。
+ * 半径取「原点到最近一条绘图区边界的距离」，保证同心圆始终完整落在绘图区内。
+ */
+export declare class PolarGrid extends ChartComponent {
+    coord: PolarGridCoord | null;
+    theme: ChartTheme | null;
+    layout: ChartLayout | null;
+    constructor(props: {
+        width: number;
+        height: number;
+        zIndex?: number;
+    });
+    /** 网格半径（数据单位）与圆心像素：半径 = 原点到最近边界。 */
+    private geometry;
+    protected doRender(): void;
+}

package/dist/types/components/RadarGrid.d.mts

@@ -0,0 +1,25 @@
+import { ChartComponent } from './ChartComponent.mjs';
+import type { ChartTheme } from '../types.mjs';
+import type { ChartLayout, PolarLayout, Rect } from '../internal.mjs';
+export interface RadarGridCoord {
+    polar: PolarLayout;
+    plot: Rect;
+    indicators: Array<{
+        name: string;
+        max: number;
+    }>;
+    shape: 'polygon' | 'circle';
+    splitNumber: number;
+}
+/** 雷达图的网格：同心环 + 指标轴 + 指标名。 */
+export declare class RadarGrid extends ChartComponent {
+    coord: RadarGridCoord | null;
+    theme: ChartTheme | null;
+    layout: ChartLayout | null;
+    constructor(props: {
+        width: number;
+        height: number;
+        zIndex?: number;
+    });
+    protected doRender(): void;
+}

package/dist/types/components/RadarGrid.d.ts

@@ -0,0 +1,25 @@
+import { ChartComponent } from './ChartComponent';
+import type { ChartTheme } from '../types';
+import type { ChartLayout, PolarLayout, Rect } from '../internal';
+export interface RadarGridCoord {
+    polar: PolarLayout;
+    plot: Rect;
+    indicators: Array<{
+        name: string;
+        max: number;
+    }>;
+    shape: 'polygon' | 'circle';
+    splitNumber: number;
+}
+/** 雷达图的网格：同心环 + 指标轴 + 指标名。 */
+export declare class RadarGrid extends ChartComponent {
+    coord: RadarGridCoord | null;
+    theme: ChartTheme | null;
+    layout: ChartLayout | null;
+    constructor(props: {
+        width: number;
+        height: number;
+        zIndex?: number;
+    });
+    protected doRender(): void;
+}

package/dist/types/components/Title.d.mts

@@ -0,0 +1,14 @@
+import { ChartComponent } from './ChartComponent.mjs';
+import type { ChartTheme } from '../types.mjs';
+import type { ChartLayout } from '../internal.mjs';
+/** 标题 / 副标题。 */
+export declare class Title extends ChartComponent {
+    layout: ChartLayout | null;
+    theme: ChartTheme | null;
+    constructor(props: {
+        width: number;
+        height: number;
+        zIndex?: number;
+    });
+    protected doRender(): void;
+}

package/dist/types/components/Title.d.ts

@@ -0,0 +1,14 @@
+import { ChartComponent } from './ChartComponent';
+import type { ChartTheme } from '../types';
+import type { ChartLayout } from '../internal';
+/** 标题 / 副标题。 */
+export declare class Title extends ChartComponent {
+    layout: ChartLayout | null;
+    theme: ChartTheme | null;
+    constructor(props: {
+        width: number;
+        height: number;
+        zIndex?: number;
+    });
+    protected doRender(): void;
+}

package/dist/types/components/Tooltip.d.mts

@@ -0,0 +1,48 @@
+import { ChartComponent } from './ChartComponent.mjs';
+import type { ChartTheme, TooltipOption } from '../types.mjs';
+import type { ChartLayout } from '../internal.mjs';
+export interface TooltipRow {
+    name: string;
+    value: string;
+    color: string;
+}
+export interface TooltipContent {
+    title: string;
+    rows: TooltipRow[];
+}
+/**
+ * 提示框。画在画布内（不使用 HTML 浮层），因此小程序等无 DOM 运行时同样可用，
+ * 也能被引擎的离屏缓存 / 脏矩形机制正确擦除。
+ */
+export declare class Tooltip extends ChartComponent {
+    theme: ChartTheme | null;
+    option: TooltipOption;
+    layout: ChartLayout | null;
+    content: TooltipContent | null;
+    anchor: [number, number];
+    /** 是否让提示框跟随指针（axis 触发器常关掉，让它固定在数据列上方）。 */
+    follow: boolean;
+    /** 最近一次实际绘制的面板矩形（图表坐标系），供外观审计 / 测试断言使用。 */
+    lastRect: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | null;
+    /** 淡出中：等透明度到 0 再清内容（避免「淡入很柔、消失很硬」）。 */
+    private pendingClear;
+    constructor(props: {
+        width: number;
+        height: number;
+        zIndex?: number;
+    });
+    show(content: TooltipContent, anchor: [number, number]): this;
+    hide(): this;
+    /** 绘制用的透明度：没有动画状态时按「完全不透明」处理（向后兼容）。 */
+    panelOpacity(): number;
+    /** 动画起点用的当前透明度：还没有任何状态时是 0（面板尚未出现）。 */
+    private currentOpacity;
+    /** 面板出现/消失：淡入 + 轻微上移（消失只淡出，不做位移，避免「飘走」的错觉）。 */
+    private playFade;
+    protected doRender(): void;
+}

package/dist/types/components/Tooltip.d.ts

@@ -0,0 +1,48 @@
+import { ChartComponent } from './ChartComponent';
+import type { ChartTheme, TooltipOption } from '../types';
+import type { ChartLayout } from '../internal';
+export interface TooltipRow {
+    name: string;
+    value: string;
+    color: string;
+}
+export interface TooltipContent {
+    title: string;
+    rows: TooltipRow[];
+}
+/**
+ * 提示框。画在画布内（不使用 HTML 浮层），因此小程序等无 DOM 运行时同样可用，
+ * 也能被引擎的离屏缓存 / 脏矩形机制正确擦除。
+ */
+export declare class Tooltip extends ChartComponent {
+    theme: ChartTheme | null;
+    option: TooltipOption;
+    layout: ChartLayout | null;
+    content: TooltipContent | null;
+    anchor: [number, number];
+    /** 是否让提示框跟随指针（axis 触发器常关掉，让它固定在数据列上方）。 */
+    follow: boolean;
+    /** 最近一次实际绘制的面板矩形（图表坐标系），供外观审计 / 测试断言使用。 */
+    lastRect: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | null;
+    /** 淡出中：等透明度到 0 再清内容（避免「淡入很柔、消失很硬」）。 */
+    private pendingClear;
+    constructor(props: {
+        width: number;
+        height: number;
+        zIndex?: number;
+    });
+    show(content: TooltipContent, anchor: [number, number]): this;
+    hide(): this;
+    /** 绘制用的透明度：没有动画状态时按「完全不透明」处理（向后兼容）。 */
+    panelOpacity(): number;
+    /** 动画起点用的当前透明度：还没有任何状态时是 0（面板尚未出现）。 */
+    private currentOpacity;
+    /** 面板出现/消失：淡入 + 轻微上移（消失只淡出，不做位移，避免「飘走」的错觉）。 */
+    private playFade;
+    protected doRender(): void;
+}

package/dist/types/components/series/AreaSeries.d.mts

@@ -0,0 +1,14 @@
+import { LineSeries } from './LineSeries.mjs';
+import type { SeriesType } from '../../types.mjs';
+import type { InternalSeries } from '../../internal.mjs';
+/** 面积图：折线 + 到基线的填充（堆叠时基线为前序堆叠值）。 */
+export declare class AreaSeries extends LineSeries {
+    seriesType: SeriesType;
+    constructor(series: InternalSeries, props: {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+        zIndex?: number;
+    });
+}

package/dist/types/components/series/AreaSeries.d.ts

@@ -0,0 +1,14 @@
+import { LineSeries } from './LineSeries';
+import type { SeriesType } from '../../types';
+import type { InternalSeries } from '../../internal';
+/** 面积图：折线 + 到基线的填充（堆叠时基线为前序堆叠值）。 */
+export declare class AreaSeries extends LineSeries {
+    seriesType: SeriesType;
+    constructor(series: InternalSeries, props: {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+        zIndex?: number;
+    });
+}

package/dist/types/components/series/BarSeries.d.mts

@@ -0,0 +1,39 @@
+import { SeriesBase } from './SeriesBase.mjs';
+import type { SeriesType } from '../../types.mjs';
+import type { Rect } from '../../internal.mjs';
+/** 柱状图（支持分组与堆叠）。 */
+export declare class BarSeries extends SeriesBase {
+    seriesType: SeriesType;
+    protected clipToBox: boolean;
+    private barCacheKey;
+    /** 横向柱状图：类目在 y 轴上（排行榜最常见的形式）。 */
+    private isHorizontal;
+    /**
+     * 像素缓存 = 每根柱子的中心。
+     * 基类按「xValue → x 比例尺」映射，横向图上 xValue 是类目、x 轴是数值，映射不出坐标；
+     * 柱子本来就是矩形，用矩形中心作为「数据点的位置」才是对的（高亮、提示框锚点都受益）。
+     */
+    protected rebuildPixels(): void;
+    /** 单根柱子的像素矩形（组件本地坐标）。 */
+    barRectAt(index: number): Rect | null;
+    private resolveBarWidth;
+    /**
+     * 单根柱子的颜色（瀑布图按增/减/合计覆写）。
+     *
+     * 支持**逐项配色**：数据项写成 `{ value, color }` 就按项取色 ——
+     * 「红涨绿跌」「告警分级」「正负值分色」这类大屏常见需求都靠它，
+     * 以前只有系列级颜色，只能靠拆成多个系列去凑（还会把柱子排成一组一组的）。
+     */
+    protected barColorAt(index: number): string;
+    /**
+     * 悬停时实际绘制的矩形：沿柱子的「值方向」外扩一点点，锚点始终在基线，
+     * 所以柱子只会变长，不会整体平移（水平柱同理，往值增大的方向伸长）。
+     * 越出绘图区的部分由引擎裁剪，不会盖到坐标轴。
+     *
+     * `t` 用来取「动画到某个进度时」的矩形：高亮描边层用 `t = 1` 取终态，
+     * 这样描边始终贴着柱子的最终轮廓，不会出现「描边画在柱子中间」的接缝。
+     */
+    barDrawRectAt(index: number, t?: number): Rect | null;
+    protected doRender(): void;
+    hitTestIndex(localX: number, localY: number): number;
+}

package/dist/types/components/series/BarSeries.d.ts

@@ -0,0 +1,39 @@
+import { SeriesBase } from './SeriesBase';
+import type { SeriesType } from '../../types';
+import type { Rect } from '../../internal';
+/** 柱状图（支持分组与堆叠）。 */
+export declare class BarSeries extends SeriesBase {
+    seriesType: SeriesType;
+    protected clipToBox: boolean;
+    private barCacheKey;
+    /** 横向柱状图：类目在 y 轴上（排行榜最常见的形式）。 */
+    private isHorizontal;
+    /**
+     * 像素缓存 = 每根柱子的中心。
+     * 基类按「xValue → x 比例尺」映射，横向图上 xValue 是类目、x 轴是数值，映射不出坐标；
+     * 柱子本来就是矩形，用矩形中心作为「数据点的位置」才是对的（高亮、提示框锚点都受益）。
+     */
+    protected rebuildPixels(): void;
+    /** 单根柱子的像素矩形（组件本地坐标）。 */
+    barRectAt(index: number): Rect | null;
+    private resolveBarWidth;
+    /**
+     * 单根柱子的颜色（瀑布图按增/减/合计覆写）。
+     *
+     * 支持**逐项配色**：数据项写成 `{ value, color }` 就按项取色 ——
+     * 「红涨绿跌」「告警分级」「正负值分色」这类大屏常见需求都靠它，
+     * 以前只有系列级颜色，只能靠拆成多个系列去凑（还会把柱子排成一组一组的）。
+     */
+    protected barColorAt(index: number): string;
+    /**
+     * 悬停时实际绘制的矩形：沿柱子的「值方向」外扩一点点，锚点始终在基线，
+     * 所以柱子只会变长，不会整体平移（水平柱同理，往值增大的方向伸长）。
+     * 越出绘图区的部分由引擎裁剪，不会盖到坐标轴。
+     *
+     * `t` 用来取「动画到某个进度时」的矩形：高亮描边层用 `t = 1` 取终态，
+     * 这样描边始终贴着柱子的最终轮廓，不会出现「描边画在柱子中间」的接缝。
+     */
+    barDrawRectAt(index: number, t?: number): Rect | null;
+    protected doRender(): void;
+    hitTestIndex(localX: number, localY: number): number;
+}

package/dist/types/components/series/BoxplotSeries.d.mts

@@ -0,0 +1,16 @@
+import { SeriesBase } from './SeriesBase.mjs';
+import type { SeriesType } from '../../types.mjs';
+import type { Rect } from '../../internal.mjs';
+/** 箱线图：每个数据项是 [min, Q1, median, Q3, max]。 */
+export declare class BoxplotSeries extends SeriesBase {
+    seriesType: SeriesType;
+    protected clipToBox: boolean;
+    private boxCacheKey;
+    private boxWidthAt;
+    /** 每个箱线图的像素几何（本地坐标）。 */
+    boxRectAt(index: number): Rect | null;
+    /** 像素缓存 = 箱体中心（高亮与提示框锚点）。 */
+    protected rebuildPixels(): void;
+    hitTestIndex(localX: number, localY: number): number;
+    protected doRender(): void;
+}

package/dist/types/components/series/BoxplotSeries.d.ts

@@ -0,0 +1,16 @@
+import { SeriesBase } from './SeriesBase';
+import type { SeriesType } from '../../types';
+import type { Rect } from '../../internal';
+/** 箱线图：每个数据项是 [min, Q1, median, Q3, max]。 */
+export declare class BoxplotSeries extends SeriesBase {
+    seriesType: SeriesType;
+    protected clipToBox: boolean;
+    private boxCacheKey;
+    private boxWidthAt;
+    /** 每个箱线图的像素几何（本地坐标）。 */
+    boxRectAt(index: number): Rect | null;
+    /** 像素缓存 = 箱体中心（高亮与提示框锚点）。 */
+    protected rebuildPixels(): void;
+    hitTestIndex(localX: number, localY: number): number;
+    protected doRender(): void;
+}

package/dist/types/components/series/CandlestickSeries.d.mts

@@ -0,0 +1,13 @@
+import { SeriesBase } from './SeriesBase.mjs';
+import type { SeriesType } from '../../types.mjs';
+/** K 线（蜡烛图）：每个数据项是 [open, close, low, high]。 */
+export declare class CandlestickSeries extends SeriesBase {
+    seriesType: SeriesType;
+    protected supportsSampling: boolean;
+    protected clipToBox: boolean;
+    hitTestIndex(localX: number, localY: number): number;
+    /** 每根蜡烛的外接矩形（影线 + 实体），本地坐标。 */
+    private candleRects;
+    private resolveBodyWidth;
+    protected doRender(): void;
+}

package/dist/types/components/series/CandlestickSeries.d.ts

@@ -0,0 +1,13 @@
+import { SeriesBase } from './SeriesBase';
+import type { SeriesType } from '../../types';
+/** K 线（蜡烛图）：每个数据项是 [open, close, low, high]。 */
+export declare class CandlestickSeries extends SeriesBase {
+    seriesType: SeriesType;
+    protected supportsSampling: boolean;
+    protected clipToBox: boolean;
+    hitTestIndex(localX: number, localY: number): number;
+    /** 每根蜡烛的外接矩形（影线 + 实体），本地坐标。 */
+    private candleRects;
+    private resolveBodyWidth;
+    protected doRender(): void;
+}