@damoqiongqiu/ice-chart 0.17.0

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

@@ -0,0 +1,58 @@
+import { SeriesBase } from './SeriesBase.mjs';
+import type { Rect } from '../../internal.mjs';
+/**
+ * 「函数曲线」类系列的公共基座（`function` / `parametric`）。
+ *
+ * 与普通折线的根本区别：**几何不是从数据点来的，而是从表达式算出来的**。
+ * 于是有三件事必须由组件自己负责：
+ *
+ * 1. **采样**：按当前可视区间重新采样（缩放后要看到更多细节），
+ *    并在曲率大的地方自适应加点（见 `src/expr/sample.ts`）；
+ * 2. **参数扫动**：某个参数随时间变化时每帧重算 —— 曲线因此是「连续变形」，
+ *    这正是引擎持续重绘能力最自然的用法（`keepAnimating`）；
+ * 3. **断点**：极点（tan / 1x）不能连成竖直假线，采样阶段就写成 NaN，
+ *    渲染时按 NaN 分段。
+ *
+ * 锚点（`series.points`）仍然保留：提示框、高亮环、键盘导航都按锚点索引工作，
+ * 而锚点的像素位置同样是**用表达式现场算出来的**，所以「看到的曲线」与
+ * 「点得到的点」始终一致。
+ */
+export declare abstract class CurveSeriesBase extends SeriesBase {
+    /** 折线采样点（图表坐标系，[x,y] 交替），NaN 表示断点。 */
+    protected curve: number[];
+    protected curveKey: string;
+    /** 曲线必须裁剪：缩放后窗口外的部分不能画到坐标轴上。 */
+    protected clipToBox: boolean;
+    /** 不需要 LTTB：采样点数本来就可控，而且抽稀会破坏曲线形状。 */
+    protected supportsSampling: boolean;
+    /** 参数曲线的 x 不单调，二分查找会失效。 */
+    protected monotonicX: boolean;
+    /** 取值范围内的采样点（参数空间 → 数据空间 [x, y]）。 */
+    protected abstract evaluateAt(parameter: number, params: Record<string, number>): [number, number];
+    /** 采样的参数区间（function 是可视 x 区间，parametric 是 t 区间）。 */
+    protected abstract parameterRange(rect: Rect): [number, number];
+    /** 基础采样点数（自适应细分在此之上加点）。 */
+    protected abstract baseSampleCount(): number;
+    /** 采样整条曲线（数据空间）。 */
+    protected abstract sampleCurve(params: Record<string, number>, rect: Rect): Array<[number, number]>;
+    /** 当前参数值：配置里的 params + 扫动动画的实时值。 */
+    resolvedParams(): Record<string, number>;
+    /** 扫动相位 0~1：用真实时间算，掉帧也不会走样。 */
+    sweepPhase(): number;
+    /** 扫动参数当前值（测试 / 调试用）。 */
+    paramValue(name: string): number | null;
+    /** 有扫动配置时就持续重绘（每帧重算曲线），没有就停掉，别白占帧循环。 */
+    protected syncSweep(): void;
+    protected rebuildPixels(): void;
+    /** 参数指纹：扫动时每帧都不同，缓存必须失效（否则曲线会冻在第一帧）。 */
+    private paramKey;
+    /** 采样点数（测试 / 调试用）。 */
+    sampleCount(): number;
+    /** 命中：曲线上离指针最近的锚点（锚点密度 = 采样密度，缩放后依然密）。 */
+    hitTestIndex(localX: number, localY: number): number;
+    /** 悬停时线宽略粗一点：函数曲线是一条线，用粗细表达「选中了这条」。 */
+    protected hoverLineScale(): number;
+    protected doRender(): void;
+    /** 曲线的当前绘制点（测试用：验证「画出来的」与「算出来的」一致）。 */
+    curvePoints(): number[];
+}

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

@@ -0,0 +1,58 @@
+import { SeriesBase } from './SeriesBase';
+import type { Rect } from '../../internal';
+/**
+ * 「函数曲线」类系列的公共基座（`function` / `parametric`）。
+ *
+ * 与普通折线的根本区别：**几何不是从数据点来的，而是从表达式算出来的**。
+ * 于是有三件事必须由组件自己负责：
+ *
+ * 1. **采样**：按当前可视区间重新采样（缩放后要看到更多细节），
+ *    并在曲率大的地方自适应加点（见 `src/expr/sample.ts`）；
+ * 2. **参数扫动**：某个参数随时间变化时每帧重算 —— 曲线因此是「连续变形」，
+ *    这正是引擎持续重绘能力最自然的用法（`keepAnimating`）；
+ * 3. **断点**：极点（tan / 1x）不能连成竖直假线，采样阶段就写成 NaN，
+ *    渲染时按 NaN 分段。
+ *
+ * 锚点（`series.points`）仍然保留：提示框、高亮环、键盘导航都按锚点索引工作，
+ * 而锚点的像素位置同样是**用表达式现场算出来的**，所以「看到的曲线」与
+ * 「点得到的点」始终一致。
+ */
+export declare abstract class CurveSeriesBase extends SeriesBase {
+    /** 折线采样点（图表坐标系，[x,y] 交替），NaN 表示断点。 */
+    protected curve: number[];
+    protected curveKey: string;
+    /** 曲线必须裁剪：缩放后窗口外的部分不能画到坐标轴上。 */
+    protected clipToBox: boolean;
+    /** 不需要 LTTB：采样点数本来就可控，而且抽稀会破坏曲线形状。 */
+    protected supportsSampling: boolean;
+    /** 参数曲线的 x 不单调，二分查找会失效。 */
+    protected monotonicX: boolean;
+    /** 取值范围内的采样点（参数空间 → 数据空间 [x, y]）。 */
+    protected abstract evaluateAt(parameter: number, params: Record<string, number>): [number, number];
+    /** 采样的参数区间（function 是可视 x 区间，parametric 是 t 区间）。 */
+    protected abstract parameterRange(rect: Rect): [number, number];
+    /** 基础采样点数（自适应细分在此之上加点）。 */
+    protected abstract baseSampleCount(): number;
+    /** 采样整条曲线（数据空间）。 */
+    protected abstract sampleCurve(params: Record<string, number>, rect: Rect): Array<[number, number]>;
+    /** 当前参数值：配置里的 params + 扫动动画的实时值。 */
+    resolvedParams(): Record<string, number>;
+    /** 扫动相位 0~1：用真实时间算，掉帧也不会走样。 */
+    sweepPhase(): number;
+    /** 扫动参数当前值（测试 / 调试用）。 */
+    paramValue(name: string): number | null;
+    /** 有扫动配置时就持续重绘（每帧重算曲线），没有就停掉，别白占帧循环。 */
+    protected syncSweep(): void;
+    protected rebuildPixels(): void;
+    /** 参数指纹：扫动时每帧都不同，缓存必须失效（否则曲线会冻在第一帧）。 */
+    private paramKey;
+    /** 采样点数（测试 / 调试用）。 */
+    sampleCount(): number;
+    /** 命中：曲线上离指针最近的锚点（锚点密度 = 采样密度，缩放后依然密）。 */
+    hitTestIndex(localX: number, localY: number): number;
+    /** 悬停时线宽略粗一点：函数曲线是一条线，用粗细表达「选中了这条」。 */
+    protected hoverLineScale(): number;
+    protected doRender(): void;
+    /** 曲线的当前绘制点（测试用：验证「画出来的」与「算出来的」一致）。 */
+    curvePoints(): number[];
+}

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

@@ -0,0 +1,22 @@
+import { CurveSeriesBase } from './CurveSeriesBase.mjs';
+import type { SeriesType } from '../../types.mjs';
+import type { Rect } from '../../internal.mjs';
+/**
+ * 函数绘图：`y = f(x)`（迷你 MATLAB 的主力图类型）。
+ *
+ * - x 轴范围来自 `series.option.domain`（默认 [-10, 10]），缩放后按**可视区间**重新采样；
+ * - y 轴数据域由**可视区间内的采样值**决定（自适应 + 稳健分位数），
+ *   所以放大到某个局部时 y 轴会自动贴到那条曲线附近（像 fplot 一样）；
+ * - 表达式见 `src/expr/expr.ts`：`sin(x)/x`、`x^2*exp(-x)`、`2x+1`、`sin(a*x)` 都行。
+ */
+export declare class FunctionSeries extends CurveSeriesBase {
+    seriesType: SeriesType;
+    /** 表达式编译结果按「表达式 + 参数集合」缓存，参数扫动时不会每帧重新解析。 */
+    private cachedSource;
+    private sampler;
+    private samplerFor;
+    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/FunctionSeries.d.ts

@@ -0,0 +1,22 @@
+import { CurveSeriesBase } from './CurveSeriesBase';
+import type { SeriesType } from '../../types';
+import type { Rect } from '../../internal';
+/**
+ * 函数绘图：`y = f(x)`（迷你 MATLAB 的主力图类型）。
+ *
+ * - x 轴范围来自 `series.option.domain`（默认 [-10, 10]），缩放后按**可视区间**重新采样；
+ * - y 轴数据域由**可视区间内的采样值**决定（自适应 + 稳健分位数），
+ *   所以放大到某个局部时 y 轴会自动贴到那条曲线附近（像 fplot 一样）；
+ * - 表达式见 `src/expr/expr.ts`：`sin(x)/x`、`x^2*exp(-x)`、`2x+1`、`sin(a*x)` 都行。
+ */
+export declare class FunctionSeries extends CurveSeriesBase {
+    seriesType: SeriesType;
+    /** 表达式编译结果按「表达式 + 参数集合」缓存，参数扫动时不会每帧重新解析。 */
+    private cachedSource;
+    private sampler;
+    private samplerFor;
+    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/FunnelSeries.d.mts

@@ -0,0 +1,38 @@
+import { SeriesBase } from './SeriesBase.mjs';
+import type { FunnelOption, SeriesType } from '../../types.mjs';
+import type { Rect } from '../../internal.mjs';
+export interface FunnelSeriesCoord {
+    plot: Rect;
+    canvas: Rect;
+    options: FunnelOption;
+}
+/**
+ * 漏斗图：从上到下逐级收窄，每级宽度按数值映射。
+ *
+ * 相邻两级之间画梯形（本级宽度 → 下一级宽度），这是转化漏斗最常见的形态；
+ * `trapezoid: false` 时退化成每一级独立的矩形。
+ */
+export declare class FunnelSeries extends SeriesBase {
+    seriesType: SeriesType;
+    funnel: FunnelSeriesCoord | null;
+    protected clipToBox: boolean;
+    /** 每个数据下标对应的梯形几何（本地坐标）。 */
+    private stageGeom;
+    private stageRects;
+    private funnelKey;
+    /** 阶段显隐切换时的起点几何（按数据下标对齐）：其余阶段「挪过去」而不是跳过去。 */
+    private stageFrom;
+    setHiddenSlices(indexes: number[]): this;
+    setCoord(coord: any): this;
+    protected paintPad(): number;
+    highlightRectAt(index: number): Rect | null;
+    private widthAt;
+    protected rebuildPixels(): void;
+    /**
+     * 阶段显隐切换的过渡：从旧几何插值到新几何，阶段的高度与宽度一起变化。
+     * 被隐藏的阶段直接不再绘制（它已经从 `visible` 里移除）。
+     */
+    private blendStageMorph;
+    hitTestIndex(localX: number, localY: number): number;
+    protected doRender(): void;
+}

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

@@ -0,0 +1,38 @@
+import { SeriesBase } from './SeriesBase';
+import type { FunnelOption, SeriesType } from '../../types';
+import type { Rect } from '../../internal';
+export interface FunnelSeriesCoord {
+    plot: Rect;
+    canvas: Rect;
+    options: FunnelOption;
+}
+/**
+ * 漏斗图：从上到下逐级收窄，每级宽度按数值映射。
+ *
+ * 相邻两级之间画梯形（本级宽度 → 下一级宽度），这是转化漏斗最常见的形态；
+ * `trapezoid: false` 时退化成每一级独立的矩形。
+ */
+export declare class FunnelSeries extends SeriesBase {
+    seriesType: SeriesType;
+    funnel: FunnelSeriesCoord | null;
+    protected clipToBox: boolean;
+    /** 每个数据下标对应的梯形几何（本地坐标）。 */
+    private stageGeom;
+    private stageRects;
+    private funnelKey;
+    /** 阶段显隐切换时的起点几何（按数据下标对齐）：其余阶段「挪过去」而不是跳过去。 */
+    private stageFrom;
+    setHiddenSlices(indexes: number[]): this;
+    setCoord(coord: any): this;
+    protected paintPad(): number;
+    highlightRectAt(index: number): Rect | null;
+    private widthAt;
+    protected rebuildPixels(): void;
+    /**
+     * 阶段显隐切换的过渡：从旧几何插值到新几何，阶段的高度与宽度一起变化。
+     * 被隐藏的阶段直接不再绘制（它已经从 `visible` 里移除）。
+     */
+    private blendStageMorph;
+    hitTestIndex(localX: number, localY: number): number;
+    protected doRender(): void;
+}

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

@@ -0,0 +1,45 @@
+import { SeriesBase } from './SeriesBase.mjs';
+import type { GaugeOption, SeriesType } from '../../types.mjs';
+import type { PolarLayout, Rect } from '../../internal.mjs';
+export interface GaugeSeriesCoord {
+    polar: PolarLayout;
+    plot: Rect;
+    canvas: Rect;
+    options: GaugeOption;
+}
+/**
+ * 仪表盘。
+ *
+ * 角度约定：配置里的角度沿用 ECharts 习惯（0° = 3 点方向、逆时针为正、90° = 12 点方向），
+ * 内部换算成 canvas 角度时取负号（canvas 的 y 轴向下，角度顺时针为正）。
+ * 默认 225° → -45°，即从左下扫到右下、经过正上方，共 270°。
+ */
+export declare class GaugeSeries extends SeriesBase {
+    seriesType: SeriesType;
+    gauge: GaugeSeriesCoord | null;
+    private gaugeKey;
+    /** 更新动画的起点数值（占「当前渲染值」，不是最小值 —— 高频 setData 才不会每次从头扫）。 */
+    private fromValue;
+    setCoord(coord: any): this;
+    protected paintPad(): number;
+    /**
+     * 数据更新时把「此刻指针指向的数值」记为动画起点（理由同 LiquidSeries）。
+     *
+     * 刻意**不看** `preserveAnimation`：那个参数是给「值插值」（fromEffective）用的，
+     * 域过渡期间每帧的同步会带 `animate=false`，真正的数据更新（animate 为真）必须捕获起点，
+     * 否则高频 setData 下指针每次都从最小值重扫（实测 CPU 79.9% 指针停在 27%）。
+     */
+    updateSeries(series: any, animate: boolean, preserveAnimation?: boolean): this;
+    /** 当前**渲染**的数值（不是源数据）：测试与外观审计断言用。 */
+    renderedValue(): number;
+    private angles;
+    private range;
+    /** 数值 → canvas 角度。 */
+    private angleFor;
+    private localCenter;
+    /** 锚点放在指针尖端，提示框与高亮都跟指针走。 */
+    protected rebuildPixels(): void;
+    /** 整个表盘都是命中区（只有一个数值，点哪里都命中它）。 */
+    hitTestIndex(localX: number, localY: number): number;
+    protected doRender(): void;
+}

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

@@ -0,0 +1,45 @@
+import { SeriesBase } from './SeriesBase';
+import type { GaugeOption, SeriesType } from '../../types';
+import type { PolarLayout, Rect } from '../../internal';
+export interface GaugeSeriesCoord {
+    polar: PolarLayout;
+    plot: Rect;
+    canvas: Rect;
+    options: GaugeOption;
+}
+/**
+ * 仪表盘。
+ *
+ * 角度约定：配置里的角度沿用 ECharts 习惯（0° = 3 点方向、逆时针为正、90° = 12 点方向），
+ * 内部换算成 canvas 角度时取负号（canvas 的 y 轴向下，角度顺时针为正）。
+ * 默认 225° → -45°，即从左下扫到右下、经过正上方，共 270°。
+ */
+export declare class GaugeSeries extends SeriesBase {
+    seriesType: SeriesType;
+    gauge: GaugeSeriesCoord | null;
+    private gaugeKey;
+    /** 更新动画的起点数值（占「当前渲染值」，不是最小值 —— 高频 setData 才不会每次从头扫）。 */
+    private fromValue;
+    setCoord(coord: any): this;
+    protected paintPad(): number;
+    /**
+     * 数据更新时把「此刻指针指向的数值」记为动画起点（理由同 LiquidSeries）。
+     *
+     * 刻意**不看** `preserveAnimation`：那个参数是给「值插值」（fromEffective）用的，
+     * 域过渡期间每帧的同步会带 `animate=false`，真正的数据更新（animate 为真）必须捕获起点，
+     * 否则高频 setData 下指针每次都从最小值重扫（实测 CPU 79.9% 指针停在 27%）。
+     */
+    updateSeries(series: any, animate: boolean, preserveAnimation?: boolean): this;
+    /** 当前**渲染**的数值（不是源数据）：测试与外观审计断言用。 */
+    renderedValue(): number;
+    private angles;
+    private range;
+    /** 数值 → canvas 角度。 */
+    private angleFor;
+    private localCenter;
+    /** 锚点放在指针尖端，提示框与高亮都跟指针走。 */
+    protected rebuildPixels(): void;
+    /** 整个表盘都是命中区（只有一个数值，点哪里都命中它）。 */
+    hitTestIndex(localX: number, localY: number): number;
+    protected doRender(): void;
+}

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

@@ -0,0 +1,39 @@
+import { SeriesBase } from './SeriesBase.mjs';
+import type { GraphOption, SeriesType } from '../../types.mjs';
+import type { Rect } from '../../internal.mjs';
+import { type ForceLayoutResult } from '../../layout/force.mjs';
+export interface GraphSeriesCoord {
+    plot: Rect;
+    canvas: Rect;
+    layout: ForceLayoutResult;
+    options: GraphOption;
+}
+/**
+ * 力导向关系图：节点 + 连线。
+ *
+ * - 布局是纯函数（`forceLayout`），组件只负责绘制与命中；
+ * - 命中返回节点下标（0..n-1）或 `节点数 + 连线下标`，与桑基图约定一致；
+ * - 节点可拖拽：拖动时直接改坐标并重绘，松手后跑少量迭代让邻居跟随（`settle()`）。
+ */
+export declare class GraphSeries extends SeriesBase {
+    seriesType: SeriesType;
+    graph: GraphSeriesCoord | null;
+    protected clipToBox: boolean;
+    private graphKey;
+    setCoord(coord: any): this;
+    protected paintPad(): number;
+    get nodeCount(): number;
+    /** 拖动节点：入参是组件本地坐标。 */
+    moveNode(index: number, localX: number, localY: number): boolean;
+    /**
+     * 松手后让邻居跟随：以当前坐标为起点跑少量迭代（被拖的节点保持固定）。
+     * 迭代次数刻意小（默认 40），保证松手是「即时」的。
+     */
+    settle(iterations?: number): void;
+    /** 像素缓存：节点中心 + 连线中点（与 sankey 相同的约定）。 */
+    protected rebuildPixels(): void;
+    hitTestIndex(localX: number, localY: number): number;
+    protected doRender(): void;
+    /** 高亮节点时用圆环（基类的默认形态），这里给出节点直径。 */
+    nodeSizeAt(index: number): number;
+}

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

@@ -0,0 +1,39 @@
+import { SeriesBase } from './SeriesBase';
+import type { GraphOption, SeriesType } from '../../types';
+import type { Rect } from '../../internal';
+import { type ForceLayoutResult } from '../../layout/force';
+export interface GraphSeriesCoord {
+    plot: Rect;
+    canvas: Rect;
+    layout: ForceLayoutResult;
+    options: GraphOption;
+}
+/**
+ * 力导向关系图：节点 + 连线。
+ *
+ * - 布局是纯函数（`forceLayout`），组件只负责绘制与命中；
+ * - 命中返回节点下标（0..n-1）或 `节点数 + 连线下标`，与桑基图约定一致；
+ * - 节点可拖拽：拖动时直接改坐标并重绘，松手后跑少量迭代让邻居跟随（`settle()`）。
+ */
+export declare class GraphSeries extends SeriesBase {
+    seriesType: SeriesType;
+    graph: GraphSeriesCoord | null;
+    protected clipToBox: boolean;
+    private graphKey;
+    setCoord(coord: any): this;
+    protected paintPad(): number;
+    get nodeCount(): number;
+    /** 拖动节点：入参是组件本地坐标。 */
+    moveNode(index: number, localX: number, localY: number): boolean;
+    /**
+     * 松手后让邻居跟随：以当前坐标为起点跑少量迭代（被拖的节点保持固定）。
+     * 迭代次数刻意小（默认 40），保证松手是「即时」的。
+     */
+    settle(iterations?: number): void;
+    /** 像素缓存：节点中心 + 连线中点（与 sankey 相同的约定）。 */
+    protected rebuildPixels(): void;
+    hitTestIndex(localX: number, localY: number): number;
+    protected doRender(): void;
+    /** 高亮节点时用圆环（基类的默认形态），这里给出节点直径。 */
+    nodeSizeAt(index: number): number;
+}

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

@@ -0,0 +1,21 @@
+import { SeriesBase } from './SeriesBase.mjs';
+import type { SeriesType } from '../../types.mjs';
+/** 热力图：数据项是 [x类目, y类目, 数值]，x/y 都是类目轴。 */
+export declare class HeatmapSeries extends SeriesBase {
+    seriesType: SeriesType;
+    protected supportsSampling: boolean;
+    protected clipToBox: boolean;
+    private heatCacheKey;
+    /**
+     * 覆盖基类的像素缓存：热力图每个点的「位置」是单元格中心，
+     * 而不是「x 比例尺 + y 比例尺」直接映射出来的坐标（y 轴是类目带）。
+     */
+    protected rebuildPixels(): void;
+    private valueRange;
+    private cellRectAt;
+    protected doRender(): void;
+    hitTestIndex(localX: number, localY: number): number;
+    protected paintPad(): number;
+}
+/** 两个十六进制颜色之间做线性插值。 */
+export declare function mixColors(from: string, to: string, ratio: number): string;

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

@@ -0,0 +1,21 @@
+import { SeriesBase } from './SeriesBase';
+import type { SeriesType } from '../../types';
+/** 热力图：数据项是 [x类目, y类目, 数值]，x/y 都是类目轴。 */
+export declare class HeatmapSeries extends SeriesBase {
+    seriesType: SeriesType;
+    protected supportsSampling: boolean;
+    protected clipToBox: boolean;
+    private heatCacheKey;
+    /**
+     * 覆盖基类的像素缓存：热力图每个点的「位置」是单元格中心，
+     * 而不是「x 比例尺 + y 比例尺」直接映射出来的坐标（y 轴是类目带）。
+     */
+    protected rebuildPixels(): void;
+    private valueRange;
+    private cellRectAt;
+    protected doRender(): void;
+    hitTestIndex(localX: number, localY: number): number;
+    protected paintPad(): number;
+}
+/** 两个十六进制颜色之间做线性插值。 */
+export declare function mixColors(from: string, to: string, ratio: number): string;

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

@@ -0,0 +1,31 @@
+import { SeriesBase } from './SeriesBase.mjs';
+import type { SeriesType } from '../../types.mjs';
+/** 折线 / 面积图。fillArea 为 true 时在折线下方填充到基线（堆叠时基线为前序堆叠值）。 */
+export declare class LineSeries extends SeriesBase {
+    seriesType: SeriesType;
+    /** 折线/面积必须裁剪到绘图区：缩放后窗口外的点会被映射到画布之外 */
+    protected clipToBox: boolean;
+    /** 面积填充（面积系列恒为 true）。 */
+    fillArea: boolean;
+    protected doRender(): void;
+    /**
+     * 取本次要绘制的点。
+     *
+     * 降采样后点集可能少于原始数据（LTTB 保留下标），绘制与「折线在哪」始终一致；
+     * 命中判定则走全量像素缓存，因此不会因为抽稀而点不到某个数据点。
+     */
+    protected renderPoints(): Array<[number, number]>;
+    /** 当前实际绘制的点数（测试与调试用：入场动画会随时间从左到右增加）。 */
+    revealedPointCount(): number;
+    private drawStraightLine;
+    /** 基数样条：以相邻四点的差分构造贝塞尔控制点，smooth ∈ (0,1]。 */
+    private drawSmoothLine;
+    /** 面积填充：折线 → 基线 → 闭合。堆叠时基线为 base 的像素位置。 */
+    private drawArea;
+    private baselineYFor;
+    hitTestIndex(localX: number, localY: number): number;
+}
+/** 点到线段距离。 */
+export declare function distanceToSegment(px: number, py: number, x0: number, y0: number, x1: number, y1: number): number;
+/** #RRGGBB / rgb() 颜色 → rgba 字符串。 */
+export declare function hexToRgba(color: string, alpha: number): string;

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

@@ -0,0 +1,31 @@
+import { SeriesBase } from './SeriesBase';
+import type { SeriesType } from '../../types';
+/** 折线 / 面积图。fillArea 为 true 时在折线下方填充到基线（堆叠时基线为前序堆叠值）。 */
+export declare class LineSeries extends SeriesBase {
+    seriesType: SeriesType;
+    /** 折线/面积必须裁剪到绘图区：缩放后窗口外的点会被映射到画布之外 */
+    protected clipToBox: boolean;
+    /** 面积填充（面积系列恒为 true）。 */
+    fillArea: boolean;
+    protected doRender(): void;
+    /**
+     * 取本次要绘制的点。
+     *
+     * 降采样后点集可能少于原始数据（LTTB 保留下标），绘制与「折线在哪」始终一致；
+     * 命中判定则走全量像素缓存，因此不会因为抽稀而点不到某个数据点。
+     */
+    protected renderPoints(): Array<[number, number]>;
+    /** 当前实际绘制的点数（测试与调试用：入场动画会随时间从左到右增加）。 */
+    revealedPointCount(): number;
+    private drawStraightLine;
+    /** 基数样条：以相邻四点的差分构造贝塞尔控制点，smooth ∈ (0,1]。 */
+    private drawSmoothLine;
+    /** 面积填充：折线 → 基线 → 闭合。堆叠时基线为 base 的像素位置。 */
+    private drawArea;
+    private baselineYFor;
+    hitTestIndex(localX: number, localY: number): number;
+}
+/** 点到线段距离。 */
+export declare function distanceToSegment(px: number, py: number, x0: number, y0: number, x1: number, y1: number): number;
+/** #RRGGBB / rgb() 颜色 → rgba 字符串。 */
+export declare function hexToRgba(color: string, alpha: number): string;

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

@@ -0,0 +1,55 @@
+import { SeriesBase } from './SeriesBase.mjs';
+import type { LiquidOption, SeriesType } from '../../types.mjs';
+import type { PolarLayout, Rect } from '../../internal.mjs';
+export interface LiquidSeriesCoord {
+    polar: PolarLayout;
+    plot: Rect;
+    canvas: Rect;
+    options: LiquidOption;
+}
+/**
+ * 水位图（液位球）：一个圆里装水，水位随数值升降，水面是持续起伏的波浪。
+ *
+ * 这是数据大屏里最有辨识度的一张图，
+ * 引擎这边两个能力刚好都用上：
+ * - **补间**：水位随 `progress()` 升降（入场从 0 涨上来、更新时涨落到位）；
+ * - **持续重绘**：波相位用 `Date.now()` 算（`keepAnimating`），和蚂蚁线同一套路。
+ *
+ * 动效偏好为 `instant`（无障碍 / 截图）时相位固定为 0 —— 画面确定、可做像素比对。
+ */
+export declare class LiquidSeries extends SeriesBase {
+    seriesType: SeriesType;
+    liquid: LiquidSeriesCoord | null;
+    private liquidKey;
+    /** 更新动画的起点水位（占「当前渲染值」，不是 0 —— 高频 setData 才不会每次从空涨起）。 */
+    private fromRatio;
+    setCoord(coord: any): this;
+    protected paintPad(): number;
+    private localCenter;
+    private range;
+    /** 目标值 → 水位比例（0~1）。 */
+    private targetRatio;
+    /** 当前水位比例：入场从 0 涨上来，更新时从旧值涨落（和 gauge 的指针同一个套路）。 */
+    private currentRatio;
+    /** 当前**渲染**的水位比例（0~1）：测试与外观审计断言用，不是源数据。 */
+    levelRatio(): number;
+    /**
+     * 数据更新时把「此刻正在渲染的水位」记为动画起点。
+     *
+     * 仪表盘 / 水位图这类**只由 progress 和目标值推导几何**的图，如果起点恒为 0，
+     * 高频 setData（监控大屏每 130ms 一次）会让动画永远跑不完 —— 实测 CPU 已经 79.9%，
+     * 水面还停在 27%。从当前渲染值接着走，看到的才是「水位跟着数据涨落」。
+     */
+    updateSeries(series: any, animate: boolean, preserveAnimation?: boolean): this;
+    /** 波相位：用真实时间算，掉帧也不会走样；静止模式固定 0。 */
+    private phase;
+    /** 水位在动（0 < 比例 < 1）时持续重绘；满/空/静止模式就停掉，别白占帧循环。 */
+    private syncWave;
+    /** 锚点放在圆心：提示框与高亮都落在球心。 */
+    protected rebuildPixels(): void;
+    /** 整个液位球都是命中区（只有一个数值，点哪里都命中它）。 */
+    hitTestIndex(localX: number, localY: number): number;
+    /** 一条波浪的路径（从左到右的波面）。 */
+    private wavePath;
+    protected doRender(): void;
+}

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

@@ -0,0 +1,55 @@
+import { SeriesBase } from './SeriesBase';
+import type { LiquidOption, SeriesType } from '../../types';
+import type { PolarLayout, Rect } from '../../internal';
+export interface LiquidSeriesCoord {
+    polar: PolarLayout;
+    plot: Rect;
+    canvas: Rect;
+    options: LiquidOption;
+}
+/**
+ * 水位图（液位球）：一个圆里装水，水位随数值升降，水面是持续起伏的波浪。
+ *
+ * 这是数据大屏里最有辨识度的一张图，
+ * 引擎这边两个能力刚好都用上：
+ * - **补间**：水位随 `progress()` 升降（入场从 0 涨上来、更新时涨落到位）；
+ * - **持续重绘**：波相位用 `Date.now()` 算（`keepAnimating`），和蚂蚁线同一套路。
+ *
+ * 动效偏好为 `instant`（无障碍 / 截图）时相位固定为 0 —— 画面确定、可做像素比对。
+ */
+export declare class LiquidSeries extends SeriesBase {
+    seriesType: SeriesType;
+    liquid: LiquidSeriesCoord | null;
+    private liquidKey;
+    /** 更新动画的起点水位（占「当前渲染值」，不是 0 —— 高频 setData 才不会每次从空涨起）。 */
+    private fromRatio;
+    setCoord(coord: any): this;
+    protected paintPad(): number;
+    private localCenter;
+    private range;
+    /** 目标值 → 水位比例（0~1）。 */
+    private targetRatio;
+    /** 当前水位比例：入场从 0 涨上来，更新时从旧值涨落（和 gauge 的指针同一个套路）。 */
+    private currentRatio;
+    /** 当前**渲染**的水位比例（0~1）：测试与外观审计断言用，不是源数据。 */
+    levelRatio(): number;
+    /**
+     * 数据更新时把「此刻正在渲染的水位」记为动画起点。
+     *
+     * 仪表盘 / 水位图这类**只由 progress 和目标值推导几何**的图，如果起点恒为 0，
+     * 高频 setData（监控大屏每 130ms 一次）会让动画永远跑不完 —— 实测 CPU 已经 79.9%，
+     * 水面还停在 27%。从当前渲染值接着走，看到的才是「水位跟着数据涨落」。
+     */
+    updateSeries(series: any, animate: boolean, preserveAnimation?: boolean): this;
+    /** 波相位：用真实时间算，掉帧也不会走样；静止模式固定 0。 */
+    private phase;
+    /** 水位在动（0 < 比例 < 1）时持续重绘；满/空/静止模式就停掉，别白占帧循环。 */
+    private syncWave;
+    /** 锚点放在圆心：提示框与高亮都落在球心。 */
+    protected rebuildPixels(): void;
+    /** 整个液位球都是命中区（只有一个数值，点哪里都命中它）。 */
+    hitTestIndex(localX: number, localY: number): number;
+    /** 一条波浪的路径（从左到右的波面）。 */
+    private wavePath;
+    protected doRender(): void;
+}