@damoqiongqiu/ice-chart 0.17.0

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

@@ -0,0 +1,30 @@
+import { CurveSeriesBase } from './CurveSeriesBase.mjs';
+import type { SeriesType } from '../../types.mjs';
+import type { Rect } from '../../internal.mjs';
+/**
+ * 参数曲线：`x = x(t), y = y(t)`。
+ *
+ * 李萨如曲线 `(sin(3t), cos(2t))`、螺线 `(t*cos(t), t*sin(t))`、心形线这类
+ * 「不是函数图像」的曲线都靠它。x 不单调，因此二分查找与「按 x 取最近点」都不适用，
+ * 命中一律走「离指针最近的锚点」。
+ *
+ * **极坐标简写**：写 `polarExpression: '1 + cos(3*t)'` 就是 `r = r(θ)`，
+ * 组件内部按 `x = r·cosθ, y = r·sinθ` 展开成同一条参数曲线 ——
+ * 玫瑰线 / 心形线 / 螺线这些经典极坐标图直接可用（配合 `aspect: 'equal'` 与 `polarGrid`）。
+ *
+ * y 轴数据域由 t 区间内的采样值决定；x 轴同理 —— 缩放会改变可视窗口，
+ * 但曲线本身固定（参数区间不变），这与函数绘图不同，符合直觉。
+ */
+export declare class ParametricSeries extends CurveSeriesBase {
+    seriesType: SeriesType;
+    private cachedSources;
+    private samplerX;
+    private samplerY;
+    private samplerR;
+    constructor(...args: ConstructorParameters<typeof CurveSeriesBase>);
+    private samplersFor;
+    protected evaluateAt(parameter: number, params: Record<string, number>): [number, number];
+    protected parameterRange(_rect: Rect): [number, number];
+    protected baseSampleCount(): number;
+    protected sampleCurve(params: Record<string, number>, rect: Rect): Array<[number, number]>;
+}

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

@@ -0,0 +1,30 @@
+import { CurveSeriesBase } from './CurveSeriesBase';
+import type { SeriesType } from '../../types';
+import type { Rect } from '../../internal';
+/**
+ * 参数曲线：`x = x(t), y = y(t)`。
+ *
+ * 李萨如曲线 `(sin(3t), cos(2t))`、螺线 `(t*cos(t), t*sin(t))`、心形线这类
+ * 「不是函数图像」的曲线都靠它。x 不单调，因此二分查找与「按 x 取最近点」都不适用，
+ * 命中一律走「离指针最近的锚点」。
+ *
+ * **极坐标简写**：写 `polarExpression: '1 + cos(3*t)'` 就是 `r = r(θ)`，
+ * 组件内部按 `x = r·cosθ, y = r·sinθ` 展开成同一条参数曲线 ——
+ * 玫瑰线 / 心形线 / 螺线这些经典极坐标图直接可用（配合 `aspect: 'equal'` 与 `polarGrid`）。
+ *
+ * y 轴数据域由 t 区间内的采样值决定；x 轴同理 —— 缩放会改变可视窗口，
+ * 但曲线本身固定（参数区间不变），这与函数绘图不同，符合直觉。
+ */
+export declare class ParametricSeries extends CurveSeriesBase {
+    seriesType: SeriesType;
+    private cachedSources;
+    private samplerX;
+    private samplerY;
+    private samplerR;
+    constructor(...args: ConstructorParameters<typeof CurveSeriesBase>);
+    private samplersFor;
+    protected evaluateAt(parameter: number, params: Record<string, number>): [number, number];
+    protected parameterRange(_rect: Rect): [number, number];
+    protected baseSampleCount(): number;
+    protected sampleCurve(params: Record<string, number>, rect: Rect): Array<[number, number]>;
+}

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

@@ -0,0 +1,44 @@
+import { SeriesBase } from './SeriesBase.mjs';
+import type { SeriesType } from '../../types.mjs';
+import type { PolarLayout, Rect } from '../../internal.mjs';
+export interface PolarSeriesCoord {
+    polar: PolarLayout;
+    /** 组件盒（极坐标外接正方形，图表坐标系）。 */
+    plot: Rect;
+    canvas: Rect;
+}
+/**
+ * 饼图 / 玫瑰图。
+ *
+ * 命中判定与渲染共用同一份扇形几何（`slices`：每个扇区的起止角与内外半径），
+ * 因此「画出来的扇形」与「点得到的扇形」必然一致 —— 与折线/柱形遵循同一条约定。
+ */
+export declare class PieSeries extends SeriesBase {
+    seriesType: SeriesType;
+    polar: PolarSeriesCoord | null;
+    /** 每个扇区 [a0, a1, r0, r1]，本地坐标空间。 */
+    private slices;
+    private pieCacheKey;
+    /** 图例切换扇区显隐时的起点几何（按下标对齐）：隐藏一个扇区，其余扇区「挪过去」而不是跳过去。 */
+    private sliceFrom;
+    setCoord(coord: any): this;
+    setHiddenSlices(indexes: number[]): this;
+    /** 标签可能画到圆外，脏矩形要留出余量。 */
+    protected paintPad(): number;
+    private localCenter;
+    /** 扇区几何 + 质心像素（质心供高亮与提示框锚点使用）。 */
+    protected rebuildPixels(): void;
+    /**
+     * 显隐切换的过渡：从 `sliceFrom` 插值到新几何。
+     *
+     * 角度按**最短方向**走（跨 2π 的扇区不会绕一整圈），半径线性。
+     * 被隐藏的扇区因此是「收拢到 0 再消失」，其余扇区平滑挪到新位置。
+     */
+    private blendSliceMorph;
+    /** 扇形质心写进像素缓存（命中与高亮锚点共用的那一份几何）。 */
+    private writeCentroid;
+    hitTestIndex(localX: number, localY: number): number;
+    protected doRender(): void;
+    private fontSize;
+    private fontFamily;
+}

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

@@ -0,0 +1,44 @@
+import { SeriesBase } from './SeriesBase';
+import type { SeriesType } from '../../types';
+import type { PolarLayout, Rect } from '../../internal';
+export interface PolarSeriesCoord {
+    polar: PolarLayout;
+    /** 组件盒（极坐标外接正方形，图表坐标系）。 */
+    plot: Rect;
+    canvas: Rect;
+}
+/**
+ * 饼图 / 玫瑰图。
+ *
+ * 命中判定与渲染共用同一份扇形几何（`slices`：每个扇区的起止角与内外半径），
+ * 因此「画出来的扇形」与「点得到的扇形」必然一致 —— 与折线/柱形遵循同一条约定。
+ */
+export declare class PieSeries extends SeriesBase {
+    seriesType: SeriesType;
+    polar: PolarSeriesCoord | null;
+    /** 每个扇区 [a0, a1, r0, r1]，本地坐标空间。 */
+    private slices;
+    private pieCacheKey;
+    /** 图例切换扇区显隐时的起点几何（按下标对齐）：隐藏一个扇区，其余扇区「挪过去」而不是跳过去。 */
+    private sliceFrom;
+    setCoord(coord: any): this;
+    setHiddenSlices(indexes: number[]): this;
+    /** 标签可能画到圆外，脏矩形要留出余量。 */
+    protected paintPad(): number;
+    private localCenter;
+    /** 扇区几何 + 质心像素（质心供高亮与提示框锚点使用）。 */
+    protected rebuildPixels(): void;
+    /**
+     * 显隐切换的过渡：从 `sliceFrom` 插值到新几何。
+     *
+     * 角度按**最短方向**走（跨 2π 的扇区不会绕一整圈），半径线性。
+     * 被隐藏的扇区因此是「收拢到 0 再消失」，其余扇区平滑挪到新位置。
+     */
+    private blendSliceMorph;
+    /** 扇形质心写进像素缓存（命中与高亮锚点共用的那一份几何）。 */
+    private writeCentroid;
+    hitTestIndex(localX: number, localY: number): number;
+    protected doRender(): void;
+    private fontSize;
+    private fontFamily;
+}

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

@@ -0,0 +1,30 @@
+import { SeriesBase } from './SeriesBase.mjs';
+import type { SeriesType } from '../../types.mjs';
+import type { PolarLayout, Rect } from '../../internal.mjs';
+export interface RadarSeriesCoord {
+    polar: PolarLayout;
+    plot: Rect;
+    canvas: Rect;
+    /** 每个指标轴的数据上限（用于把数值映射到半径）。 */
+    domains: Array<[number, number]>;
+}
+/**
+ * 雷达图：一个系列 = 一个多边形。
+ *
+ * 数据按指标顺序排列（`data: [80, 90, 70, 60, 85]` 对应 `radar.indicators` 的顺序）。
+ * 顶点几何同时用于绘制与命中判定：指针靠近某个顶点即命中该指标，
+ * 落在多边形内部时按角度取最近的指标。
+ */
+export declare class RadarSeries extends SeriesBase {
+    seriesType: SeriesType;
+    radar: RadarSeriesCoord | null;
+    private radarCacheKey;
+    setCoord(coord: any): this;
+    protected paintPad(): number;
+    private localCenter;
+    /** 顶点像素（本地坐标）。 */
+    protected rebuildPixels(): void;
+    protected doRender(): void;
+    hitTestIndex(localX: number, localY: number): number;
+    private containsPointInPolygon;
+}

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

@@ -0,0 +1,30 @@
+import { SeriesBase } from './SeriesBase';
+import type { SeriesType } from '../../types';
+import type { PolarLayout, Rect } from '../../internal';
+export interface RadarSeriesCoord {
+    polar: PolarLayout;
+    plot: Rect;
+    canvas: Rect;
+    /** 每个指标轴的数据上限（用于把数值映射到半径）。 */
+    domains: Array<[number, number]>;
+}
+/**
+ * 雷达图：一个系列 = 一个多边形。
+ *
+ * 数据按指标顺序排列（`data: [80, 90, 70, 60, 85]` 对应 `radar.indicators` 的顺序）。
+ * 顶点几何同时用于绘制与命中判定：指针靠近某个顶点即命中该指标，
+ * 落在多边形内部时按角度取最近的指标。
+ */
+export declare class RadarSeries extends SeriesBase {
+    seriesType: SeriesType;
+    radar: RadarSeriesCoord | null;
+    private radarCacheKey;
+    setCoord(coord: any): this;
+    protected paintPad(): number;
+    private localCenter;
+    /** 顶点像素（本地坐标）。 */
+    protected rebuildPixels(): void;
+    protected doRender(): void;
+    hitTestIndex(localX: number, localY: number): number;
+    private containsPointInPolygon;
+}

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

@@ -0,0 +1,34 @@
+import { SeriesBase } from './SeriesBase.mjs';
+import type { SeriesType } from '../../types.mjs';
+import type { Rect } from '../../internal.mjs';
+import { layoutSankey, type SankeyLayoutResult } from '../../layout/sankey.mjs';
+import type { SankeyOption } from '../../types.mjs';
+export interface SankeySeriesCoord {
+    plot: Rect;
+    canvas: Rect;
+    /** 图表坐标系下的布局结果。 */
+    layout: SankeyLayoutResult;
+    options: SankeyOption;
+}
+/**
+ * 桑基图：节点 + 连线（按流量定宽）。
+ *
+ * 布局由纯函数 `layoutSankey` 产出，本组件只负责绘制与命中：
+ * - 命中节点 → 节点下标；
+ * - 命中连线 → 节点数 + 连线下标（与 `series.points` 的排列一致）。
+ */
+export declare class SankeySeries extends SeriesBase {
+    seriesType: SeriesType;
+    sankey: SankeySeriesCoord | null;
+    protected supportsSampling: boolean;
+    private sankeyCacheKey;
+    setCoord(coord: any): this;
+    protected paintPad(): number;
+    /** 节点中心 / 连线中点的像素（组件本地坐标）。 */
+    protected rebuildPixels(): void;
+    protected doRender(): void;
+    /** 带白色描边的文字：保证节点名压在连线上时依然清晰。 */
+    private fillLabelWithHalo;
+    hitTestIndex(localX: number, localY: number): number;
+}
+export { layoutSankey };

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

@@ -0,0 +1,34 @@
+import { SeriesBase } from './SeriesBase';
+import type { SeriesType } from '../../types';
+import type { Rect } from '../../internal';
+import { layoutSankey, type SankeyLayoutResult } from '../../layout/sankey';
+import type { SankeyOption } from '../../types';
+export interface SankeySeriesCoord {
+    plot: Rect;
+    canvas: Rect;
+    /** 图表坐标系下的布局结果。 */
+    layout: SankeyLayoutResult;
+    options: SankeyOption;
+}
+/**
+ * 桑基图：节点 + 连线（按流量定宽）。
+ *
+ * 布局由纯函数 `layoutSankey` 产出，本组件只负责绘制与命中：
+ * - 命中节点 → 节点下标；
+ * - 命中连线 → 节点数 + 连线下标（与 `series.points` 的排列一致）。
+ */
+export declare class SankeySeries extends SeriesBase {
+    seriesType: SeriesType;
+    sankey: SankeySeriesCoord | null;
+    protected supportsSampling: boolean;
+    private sankeyCacheKey;
+    setCoord(coord: any): this;
+    protected paintPad(): number;
+    /** 节点中心 / 连线中点的像素（组件本地坐标）。 */
+    protected rebuildPixels(): void;
+    protected doRender(): void;
+    /** 带白色描边的文字：保证节点名压在连线上时依然清晰。 */
+    private fillLabelWithHalo;
+    hitTestIndex(localX: number, localY: number): number;
+}
+export { layoutSankey };

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

@@ -0,0 +1,11 @@
+import { SeriesBase } from './SeriesBase.mjs';
+import type { SeriesType } from '../../types.mjs';
+/** 散点图：只画数据标记。 */
+export declare class ScatterSeries extends SeriesBase {
+    seriesType: SeriesType;
+    /** 散点图的每个点都是图形本身，不参与降采样。 */
+    protected supportsSampling: boolean;
+    protected clipToBox: boolean;
+    protected doRender(): void;
+    hitTestIndex(localX: number, localY: number): number;
+}

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

@@ -0,0 +1,11 @@
+import { SeriesBase } from './SeriesBase';
+import type { SeriesType } from '../../types';
+/** 散点图：只画数据标记。 */
+export declare class ScatterSeries extends SeriesBase {
+    seriesType: SeriesType;
+    /** 散点图的每个点都是图形本身，不参与降采样。 */
+    protected supportsSampling: boolean;
+    protected clipToBox: boolean;
+    protected doRender(): void;
+    hitTestIndex(localX: number, localY: number): number;
+}

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

@@ -0,0 +1,214 @@
+import { ChartComponent } from '../ChartComponent.mjs';
+import type { ChartTheme, SeriesType } from '../../types.mjs';
+import type { DataPoint, InternalSeries, Rect } from '../../internal.mjs';
+import type { Scale } from '../../scale.mjs';
+export interface SeriesCoord {
+    plot: Rect;
+    canvas: Rect;
+    xScale: Scale;
+    yScale: Scale;
+    /** 该系列绑定的 y 轴下标。 */
+    yAxisIndex?: number;
+    theme: ChartTheme;
+}
+export interface BarSlot {
+    index: number;
+    count: number;
+}
+/**
+ * 系列基类：数据 → 像素的缓存、动画插值、命中判定都收敛在这里。
+ *
+ * 三件事值得注意：
+ *
+ * 1. **像素缓存**：数据点的像素坐标只在数据 / 比例尺 / 尺寸变化时重算一次，
+ *    render 与命中判定共用同一份缓存 —— 保证「画出来的样子」和「点得到的位置」必然一致。
+ *
+ * 2. **命中判定进引擎**：`containsLocalPoint` 由子类实现为「按数据语义判定」，
+ *    于是 `ice.hitTest()` / 引擎事件派发天然就能分辨「点在折线上」还是「点在空白处」，
+ *    不需要在图表外面再写一套坐标反查。
+ *
+ * 3. **动画走引擎的 AnimationManager**：`state.progress` 由引擎逐帧写入，
+ *    本组件按 progress 在「上一份数据的有效值」与「新数据」之间插值。
+ */
+export declare abstract class SeriesBase extends ChartComponent {
+    abstract seriesType: SeriesType;
+    series: InternalSeries;
+    /** 图表主题（由 Chart 注入，供绘制标签 / 文本使用）。 */
+    chartTheme: ChartTheme | null;
+    /** 被隐藏的数据项下标（饼图扇区 / 漏斗阶段）。 */
+    hiddenSlices: number[];
+    coord: SeriesCoord | null;
+    /** 分组柱形的位置（由 Chart 计算）。 */
+    barSlot: BarSlot;
+    /** 每个点的像素坐标，2n 长度，[x0,y0,x1,y1,...]；缺失点为 NaN。 */
+    protected pixels: Float64Array;
+    /** 每个点的有效数据值 [base, top]，用于动画插值与柱形绘制。 */
+    protected effective: Float64Array;
+    /** 上一帧的有效值，作为动画起点。 */
+    protected fromEffective: Float64Array | null;
+    /** 实际参与绘制的点下标（降采样后可能少于总点数）；null 表示全部点。 */
+    protected renderIndices: number[] | null;
+    /** 像素 x 是否单调递增（降采样与二分查找的前提）。 */
+    protected xMonotonic: boolean;
+    /** 第三维（气泡尺寸）的取值范围，映射到 symbolSizeRange。 */
+    protected sizeExtent: [number, number];
+    /** 每个数据项各自的动画进度（错峰入场用），0~1。 */
+    protected itemProgress: Float64Array;
+    /** 错峰比例：0 = 所有项同时动画。 */
+    protected stagger: number;
+    /** 当前动画阶段：enter 可以「画出来」，update 只能「动起来」。 */
+    protected animationKind: 'enter' | 'update';
+    /** 当前悬停的数据项（0 表示没有）。 */
+    hoverIndex: number | null;
+    private cacheKey;
+    /** 散点等「每个点都必须画」的系列不参与降采样。 */
+    protected supportsSampling: boolean;
+    /**
+     * 是否把绘制裁剪到组件盒（= 本场景的绘图区）。
+     *
+     * 直角坐标系列必须开：缩放后落在窗口外的数据点会被映射到很远的位置，
+     * 不裁剪就会一路画到 y 轴标签、图例甚至画布外面去（用户实测反馈的问题）。
+     * 折线要的是「被绘图区边缘裁掉」，而不是「在边界处断开」，所以只能靠 clip，不能靠过滤点。
+     */
+    protected clipToBox: boolean;
+    private localBoxScratch;
+    constructor(series: InternalSeries, props: {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+        zIndex?: number;
+    });
+    /** 组件本地盒向四周外扩，容纳线宽、标记与阴影。 */
+    protected __localBox(): number[];
+    protected paintPad(): number;
+    /**
+     * 数据点尺寸：三种来源按优先级解析。
+     * 1. `symbolSize` 是函数 → 交给调用方决定；
+     * 2. 数据项带第三维（气泡图的 `[x, y, size]`）→ 按 series 内的取值范围映射到 `symbolSizeRange`；
+     * 3. 固定数值 `symbolSize`。
+     */
+    symbolSizeAt(index: number): number;
+    /** 本系列的最大标记尺寸（脏矩形留白与命中容差要用）。 */
+    protected maxSymbolSize(): number;
+    setCoord(coord: SeriesCoord): this;
+    /** 设置被隐藏的数据项（图表层在每次同步时写入）。 */
+    setHiddenSlices(indexes: number[]): this;
+    /** 图表层在每次播放动画前注入该阶段的配置（错峰比例会存下来供逐项计算）。 */
+    setAnimationStage(stage: {
+        stagger?: number;
+        kind?: 'enter' | 'update';
+    } | null | undefined): this;
+    /** 是否正在播「入场」动画（用于「画出来」这类只在入场成立的动效）。 */
+    protected isEntering(): boolean;
+    /** 单个数据项的动画进度：把整体进度按「波浪」拆到每一项。 */
+    protected progressFor(index: number, total: number): number;
+    /** 每项进度的缓存（数据量变化时重建）。 */
+    protected computeItemProgress(): void;
+    /** 当前动画状态（测试与调试用；不参与序列化）。 */
+    getAnimationState(): {
+        progress: number;
+        kind: 'enter' | 'update';
+        stagger: number;
+        itemProgress: number[];
+    };
+    /**
+     * 设置/清除悬停项，并用引擎动画把 `highlightT` 从 0 推到 1（或反向）。
+     *
+     * 反馈动画由组件自己启动：它持有 `ice.animationManager`，不需要图表层代劳，
+     * 这样「悬停哪个图元」这件事就完全收敛在系列内部。
+     */
+    setHoverIndex(index: number | null): void;
+    /** 悬停反馈的进度（0~1）。 */
+    highlightT(): number;
+    /** 某个数据项当前的高亮强度：只有被悬停的那一项 > 0。 */
+    protected hoverBoost(index: number, amount?: number, t?: number): number;
+    /** 悬停叠加层的强度（0~1）：只有被悬停的那一项 > 0。 */
+    protected hoverAlpha(index: number): number;
+    /**
+     * 在被悬停的矩形上叠一层「提亮 + 描边」。
+     *
+     * 刻意**只叠加、不改几何**：像热力图 / 树图 / K 线这种相邻图元紧挨着的类型，
+     * 改宽高会让命中区域与渲染区域分叉（指针停在边缘会来回抖），
+     * 叠加描边既能表达强调，又完全不动命中判定。
+     */
+    protected drawHoverOverlay(index: number, rect: Rect, options?: {
+        radius?: number;
+        fill?: string;
+        stroke?: string;
+        lineWidth?: number;
+    }): void;
+    /**
+     * 派生几何的缓存键。
+     *
+     * **必须**把参与动画的 state 字段一起放进来（progress / 阶段 / 错峰），
+     * 否则动画期间键不变、缓存命中，几何会冻结在动画开始的那一帧。
+     * 子类覆写 `rebuildPixels` 时用自己的几何参数组键，请一律走这个方法。
+     */
+    protected buildSeriesKey(parts: Array<any>): string;
+    /**
+     * 坐标系指纹：绘图区矩形 + 各比例尺的数据域。
+     *
+     * 子类自己拼键时最容易漏的就是数据域 —— 表面看不出来，实际后果是
+     * **像素缓存不失效**：缩放 / 平移 / 数据域过渡之后 `pixels` 还是旧位置，
+     * 「看得见的点」与「点得到的点」就此分叉（悬停高亮画在别处、命中判空）。
+     * 只在键里放域的**端点 + 长度**，因为这个函数动画期间每帧都会被调用，不能全量 join。
+     */
+    private coordKey;
+    /**
+     * 替换数据。`animate` 为真时，把当前有效值记为动画起点（首次进入时从 0 开始），
+     * 由 Chart 触发引擎动画把 state.progress 从 0 推到 1。
+     */
+    updateSeries(series: InternalSeries, animate: boolean, preserveAnimation?: boolean): this;
+    /** 与当前绘制一致的像素位置；缺失点返回 null。 */
+    pixelAt(index: number): [number, number] | null;
+    /** 数据点的像素矩形（柱形用）。 */
+    barRectAt(_index: number): Rect | null;
+    /** 命中判定：返回数据下标，-1 表示未命中。入参是组件本地像素坐标。 */
+    abstract hitTestIndex(localX: number, localY: number): number;
+    protected containsLocalPoint(localX: number, localY: number): boolean;
+    protected progress(): number;
+    /** 计算每个点的有效数据值（含动画插值）。 */
+    protected computeEffective(): void;
+    /** 数据 → 像素（带缓存）。 */
+    protected rebuildPixels(force?: boolean): void;
+    /**
+     * 计算实际绘制的点下标。
+     *
+     * 默认策略：点数超过「绘图区宽度 × 3」时用 LTTB 抽稀 —— 一个像素宽度画 3 个点已经过剩，
+     * 继续画只是白白光栅化。首尾点与极值点一定保留，所以看起来仍然「像原曲线」。
+     * 命中判定不受影响，它始终读全量像素缓存。
+     */
+    protected buildRenderIndices(n: number, plotWidth: number): number[] | null;
+    /** 实际参与绘制的点数。 */
+    protected renderCount(): number;
+    /** 第 k 个参与绘制的点对应的原始下标。 */
+    protected renderIndexAt(k: number): number;
+    /**
+     * 按 x 像素找最近的数据下标。
+     *
+     * 单调数据用二分查找（大点数下每次 mousemove 都是 O(n) 会直接掉帧），
+     * 非单调数据退化为线性扫描。
+     */
+    nearestIndexAtX(localX: number): number;
+    private buildCacheKey;
+    /** 遍历像素点，跳过缺失点形成的断点。 */
+    protected eachSegment(fn: (x0: number, y0: number, x1: number, y1: number, i: number) => void): void;
+    protected pointColor(_index: number): string;
+    protected lineWidthDevice(): number;
+    protected opacity(): number;
+    protected beginDraw(): void;
+    protected endDraw(): void;
+    protected drawSymbol(x: number, y: number, shape: string, size: number, fill: string, stroke: string): void;
+    protected pointByIndex(index: number): DataPoint | null;
+}
+/**
+ * LTTB（Largest Triangle Three Buckets）抽稀。
+ *
+ * 输入是渲染用的像素点集（x/y 交错，含 NaN 断点），返回保留下来的下标数组。
+ * 首点与末点一定保留；每个桶内取「与前后桶均值构成三角形面积最大」的点，
+ * 因此尖峰不会被抹平 —— 这正是它比等间隔抽样更适合行情/监控曲线的原因。
+ */
+export declare function lttbIndices(pixels: Float64Array, n: number, threshold: number): number[];
+/** 数据点第三维的取值范围（气泡尺寸映射用）。 */
+export declare function computeSizeExtent(points: DataPoint[]): [number, number];