@damoqiongqiu/ice-chart 0.17.0

package/dist/types/a11y.d.mts

@@ -0,0 +1,85 @@
+import type { ChartLayout, NormalizedOption } from './internal.mjs';
+import type { SeriesType } from './types.mjs';
+/** 可访问数据表：屏幕阅读器可以直接读的一张表。 */
+export interface DataTable {
+    caption: string;
+    columns: string[];
+    rows: string[][];
+}
+/** 虚拟数据节点：把「一个数据点」暴露成可聚焦节点所需的全部信息。 */
+export interface A11yDataNode {
+    id: string;
+    role: 'graphic';
+    label: string;
+    seriesId: string;
+    seriesName: string;
+    dataIndex: number;
+    value: number | null;
+    /** 屏幕坐标盒（CSS 像素），应用层可直接做 DOM 镜像定位。 */
+    box: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    focusable: boolean;
+}
+/** a11y 构建只依赖图表的这几项能力（避免与 ICEChart 循环依赖）。 */
+export interface A11yChartLike {
+    ice: any;
+    norm: NormalizedOption;
+    layout: ChartLayout;
+    controller: any;
+    formatAxisValue(axis: 'x' | 'y', value: any): string;
+}
+export interface A11yTreeOptions {
+    /** 每个系列最多展开多少个数据节点，默认 200（避免把几万个点塞进无障碍树）。 */
+    maxDataNodesPerSeries?: number;
+}
+/** 图表标题（无障碍名也用它）。 */
+export declare function chartTitle(norm: NormalizedOption): string;
+/**
+ * 生成数据表。
+ *
+ * - 直角坐标：每行一个 x 位置，每列一个系列；
+ * - 饼图：每行一个扇区（名称 / 数值 / 占比）；
+ * - 雷达图：每行一个指标，每列一个系列。
+ *
+ * 只统计**可见**系列与扇区，与画面严格一致 —— 图例隐藏的系列不该被读出来。
+ */
+export declare function buildDataTable(chart: A11yChartLike): DataTable;
+/**
+ * 生成虚拟数据节点：让应用层可以做「逐数据点」的 DOM 镜像与焦点环。
+ *
+ * 默认每个系列最多 200 个节点（整体数据表已经能表达全部数据，逐点节点是为了
+ * 键盘在数据点之间移动），可用 maxDataNodesPerSeries 调整。
+ */
+export declare function buildDataNodes(chart: A11yChartLike, options?: A11yTreeOptions): A11yDataNode[];
+/** 视觉隐藏但可被屏幕阅读器读取的样式。 */
+export declare const VISUALLY_HIDDEN_STYLE: string;
+/**
+ * 无障碍镜像：在 canvas 旁挂一张视觉隐藏的数据表 + 一个 aria-live 播报区。
+ *
+ * 为什么必须做：canvas 内容对屏幕阅读器完全不可见（引擎的 a11y 原语也只产出快照，
+ * 由应用层决定 DOM 结构）。ice-chart 选择把「数据表 + 当前悬停点播报」这一层直接做掉，
+ * 因为它对图表是通用语义；更细的交互镜像仍可由应用层基于 getA11yTree() 自行构建。
+ */
+export declare class A11yMirror {
+    private chart;
+    private wrapper;
+    private live;
+    private tableEl;
+    private hoverHandler;
+    private static seq;
+    constructor(chart: any);
+    get attached(): boolean;
+    get element(): any;
+    attach(): boolean;
+    detach(): void;
+    /** 用当前数据重建表格（数据或图例变化后调用）。 */
+    refresh(): void;
+    /** 播报一段文本（悬停 / 键盘导航时用）。 */
+    announce(text: string): void;
+}
+/** 系列类型 → 无障碍角色建议（供应用层构建镜像时参考）。 */
+export declare const SERIES_ROLE_HINT: Record<SeriesType, string>;

package/dist/types/a11y.d.ts

@@ -0,0 +1,85 @@
+import type { ChartLayout, NormalizedOption } from './internal';
+import type { SeriesType } from './types';
+/** 可访问数据表：屏幕阅读器可以直接读的一张表。 */
+export interface DataTable {
+    caption: string;
+    columns: string[];
+    rows: string[][];
+}
+/** 虚拟数据节点：把「一个数据点」暴露成可聚焦节点所需的全部信息。 */
+export interface A11yDataNode {
+    id: string;
+    role: 'graphic';
+    label: string;
+    seriesId: string;
+    seriesName: string;
+    dataIndex: number;
+    value: number | null;
+    /** 屏幕坐标盒（CSS 像素），应用层可直接做 DOM 镜像定位。 */
+    box: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    focusable: boolean;
+}
+/** a11y 构建只依赖图表的这几项能力（避免与 ICEChart 循环依赖）。 */
+export interface A11yChartLike {
+    ice: any;
+    norm: NormalizedOption;
+    layout: ChartLayout;
+    controller: any;
+    formatAxisValue(axis: 'x' | 'y', value: any): string;
+}
+export interface A11yTreeOptions {
+    /** 每个系列最多展开多少个数据节点，默认 200（避免把几万个点塞进无障碍树）。 */
+    maxDataNodesPerSeries?: number;
+}
+/** 图表标题（无障碍名也用它）。 */
+export declare function chartTitle(norm: NormalizedOption): string;
+/**
+ * 生成数据表。
+ *
+ * - 直角坐标：每行一个 x 位置，每列一个系列；
+ * - 饼图：每行一个扇区（名称 / 数值 / 占比）；
+ * - 雷达图：每行一个指标，每列一个系列。
+ *
+ * 只统计**可见**系列与扇区，与画面严格一致 —— 图例隐藏的系列不该被读出来。
+ */
+export declare function buildDataTable(chart: A11yChartLike): DataTable;
+/**
+ * 生成虚拟数据节点：让应用层可以做「逐数据点」的 DOM 镜像与焦点环。
+ *
+ * 默认每个系列最多 200 个节点（整体数据表已经能表达全部数据，逐点节点是为了
+ * 键盘在数据点之间移动），可用 maxDataNodesPerSeries 调整。
+ */
+export declare function buildDataNodes(chart: A11yChartLike, options?: A11yTreeOptions): A11yDataNode[];
+/** 视觉隐藏但可被屏幕阅读器读取的样式。 */
+export declare const VISUALLY_HIDDEN_STYLE: string;
+/**
+ * 无障碍镜像：在 canvas 旁挂一张视觉隐藏的数据表 + 一个 aria-live 播报区。
+ *
+ * 为什么必须做：canvas 内容对屏幕阅读器完全不可见（引擎的 a11y 原语也只产出快照，
+ * 由应用层决定 DOM 结构）。ice-chart 选择把「数据表 + 当前悬停点播报」这一层直接做掉，
+ * 因为它对图表是通用语义；更细的交互镜像仍可由应用层基于 getA11yTree() 自行构建。
+ */
+export declare class A11yMirror {
+    private chart;
+    private wrapper;
+    private live;
+    private tableEl;
+    private hoverHandler;
+    private static seq;
+    constructor(chart: any);
+    get attached(): boolean;
+    get element(): any;
+    attach(): boolean;
+    detach(): void;
+    /** 用当前数据重建表格（数据或图例变化后调用）。 */
+    refresh(): void;
+    /** 播报一段文本（悬停 / 键盘导航时用）。 */
+    announce(text: string): void;
+}
+/** 系列类型 → 无障碍角色建议（供应用层构建镜像时参考）。 */
+export declare const SERIES_ROLE_HINT: Record<SeriesType, string>;

package/dist/types/animation/motion.d.mts

@@ -0,0 +1,11 @@
+/**
+ * 全局动效偏好。
+ *
+ * 放在独立模块里（而不是 ICEChart）是为了让**组件**也能读到它 ——
+ * 悬停反馈这类动画由组件自己启动，如果组件反向 import ICEChart 就会形成循环依赖。
+ */
+export type MotionPreference = 'auto' | 'instant' | 'full';
+export declare function setMotionPreference(preference: MotionPreference): void;
+export declare function getMotionPreference(): MotionPreference;
+/** 当前是否应该播放动画（无障碍：尊重系统的「减少动态效果」）。 */
+export declare function shouldAnimate(): boolean;

package/dist/types/animation/motion.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 全局动效偏好。
+ *
+ * 放在独立模块里（而不是 ICEChart）是为了让**组件**也能读到它 ——
+ * 悬停反馈这类动画由组件自己启动，如果组件反向 import ICEChart 就会形成循环依赖。
+ */
+export type MotionPreference = 'auto' | 'instant' | 'full';
+export declare function setMotionPreference(preference: MotionPreference): void;
+export declare function getMotionPreference(): MotionPreference;
+/** 当前是否应该播放动画（无障碍：尊重系统的「减少动态效果」）。 */
+export declare function shouldAnimate(): boolean;

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

@@ -0,0 +1,60 @@
+import { ChartComponent } from './ChartComponent.mjs';
+import type { ChartTheme } from '../types.mjs';
+import type { ChartLayout, InternalAxis } from '../internal.mjs';
+/** 刻度平滑过渡时长：缩放 / 平移 / 数据更新时，标签滑动到新位置而不是瞬间跳。 */
+export declare const AXIS_MORPH_DURATION = 240;
+/**
+ * 坐标轴（x / y 共用一套绘制逻辑）。
+ *
+ * 轴组件拥有整块画布作为盒，绘制时直接用图表坐标系（左上角原点），
+ * 因此刻度标签、轴名称可以自然画到绘图区之外，不需要扩展包围盒。
+ *
+ * 多 y 轴支持：`axisIndex` 决定读哪个轴的刻度，`position` + `layout.offset`
+ * 决定轴线画在绘图区左侧还是右侧、以及同侧多轴时向外偏移多少。
+ */
+export declare class Axis extends ChartComponent {
+    orientation: 'x' | 'y';
+    /** y 轴下标（对应 norm.yAxes）；x 轴恒为 0。 */
+    axisIndex: number;
+    position: 'left' | 'right';
+    axis: InternalAxis | null;
+    layout: ChartLayout | null;
+    theme: ChartTheme | null;
+    /** 上一次同步的刻度（含像素位置），用于检测变化并作为过渡起点。 */
+    private lastTicks;
+    private morphFrom;
+    constructor(props: {
+        orientation: 'x' | 'y';
+        width: number;
+        height: number;
+        zIndex?: number;
+        axisIndex?: number;
+        position?: 'left' | 'right';
+    });
+    /** y 轴轴线的 x 坐标（含同侧多层偏移）。 */
+    private edgeX;
+    private axisLayoutOf;
+    /** 当前刻度 + 目标位置 + 标签（抽稀规则与绘制时完全一致，两边共用这一份）。 */
+    private tickEntries;
+    /** 过渡进度（0~1）；没有动画时恒为 1。 */
+    private morphProgress;
+    /** 每个刻度「此刻画在哪」：过渡中会取中间位置。 */
+    private renderedPositions;
+    /**
+     * 同步刻度并（在必要时）启动一次平滑过渡。
+     *
+     * 由 ICEChart 在 `layout` / `axis` 赋值之后调用。判断完全基于「刻度集合有没有变」，
+     * 所以缩放、平移、数据更新、图例切换、resize 都能自动覆盖，不需要调用方传意图。
+     *
+     * 过渡中的再次变化从**当前渲染位置**接着走（等价于指数平滑），
+     * 连续滚轮缩放时不会出现「每次事件都从旧位置重新跳」的抖动。
+     */
+    syncTicks(): void;
+    /** 某个刻度当前的渲染位置（过渡中间态）。测试 / 审计用。 */
+    renderedTickPos(value: any): number | null;
+    /** 位置是否还在过渡中（测试 / 审计用）。 */
+    morphing(): boolean;
+    private drawTick;
+    private drawTickLabel;
+    protected doRender(): void;
+}

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

@@ -0,0 +1,60 @@
+import { ChartComponent } from './ChartComponent';
+import type { ChartTheme } from '../types';
+import type { ChartLayout, InternalAxis } from '../internal';
+/** 刻度平滑过渡时长：缩放 / 平移 / 数据更新时，标签滑动到新位置而不是瞬间跳。 */
+export declare const AXIS_MORPH_DURATION = 240;
+/**
+ * 坐标轴（x / y 共用一套绘制逻辑）。
+ *
+ * 轴组件拥有整块画布作为盒，绘制时直接用图表坐标系（左上角原点），
+ * 因此刻度标签、轴名称可以自然画到绘图区之外，不需要扩展包围盒。
+ *
+ * 多 y 轴支持：`axisIndex` 决定读哪个轴的刻度，`position` + `layout.offset`
+ * 决定轴线画在绘图区左侧还是右侧、以及同侧多轴时向外偏移多少。
+ */
+export declare class Axis extends ChartComponent {
+    orientation: 'x' | 'y';
+    /** y 轴下标（对应 norm.yAxes）；x 轴恒为 0。 */
+    axisIndex: number;
+    position: 'left' | 'right';
+    axis: InternalAxis | null;
+    layout: ChartLayout | null;
+    theme: ChartTheme | null;
+    /** 上一次同步的刻度（含像素位置），用于检测变化并作为过渡起点。 */
+    private lastTicks;
+    private morphFrom;
+    constructor(props: {
+        orientation: 'x' | 'y';
+        width: number;
+        height: number;
+        zIndex?: number;
+        axisIndex?: number;
+        position?: 'left' | 'right';
+    });
+    /** y 轴轴线的 x 坐标（含同侧多层偏移）。 */
+    private edgeX;
+    private axisLayoutOf;
+    /** 当前刻度 + 目标位置 + 标签（抽稀规则与绘制时完全一致，两边共用这一份）。 */
+    private tickEntries;
+    /** 过渡进度（0~1）；没有动画时恒为 1。 */
+    private morphProgress;
+    /** 每个刻度「此刻画在哪」：过渡中会取中间位置。 */
+    private renderedPositions;
+    /**
+     * 同步刻度并（在必要时）启动一次平滑过渡。
+     *
+     * 由 ICEChart 在 `layout` / `axis` 赋值之后调用。判断完全基于「刻度集合有没有变」，
+     * 所以缩放、平移、数据更新、图例切换、resize 都能自动覆盖，不需要调用方传意图。
+     *
+     * 过渡中的再次变化从**当前渲染位置**接着走（等价于指数平滑），
+     * 连续滚轮缩放时不会出现「每次事件都从旧位置重新跳」的抖动。
+     */
+    syncTicks(): void;
+    /** 某个刻度当前的渲染位置（过渡中间态）。测试 / 审计用。 */
+    renderedTickPos(value: any): number | null;
+    /** 位置是否还在过渡中（测试 / 审计用）。 */
+    morphing(): boolean;
+    private drawTick;
+    private drawTickLabel;
+    protected doRender(): void;
+}

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

@@ -0,0 +1,19 @@
+import { ChartComponent } from './ChartComponent.mjs';
+import type { ChartTheme } from '../types.mjs';
+import type { Rect } from '../internal.mjs';
+/** 刷选框。拖拽期间由交互层每帧更新 rect（图表坐标系）。 */
+export declare class Brush extends ChartComponent {
+    theme: ChartTheme | null;
+    rect: Rect | null;
+    color: {
+        fill: string;
+        stroke: string;
+    } | null;
+    constructor(props: {
+        width: number;
+        height: number;
+        zIndex?: number;
+    });
+    setRect(rect: Rect | null): this;
+    protected doRender(): void;
+}

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

@@ -0,0 +1,19 @@
+import { ChartComponent } from './ChartComponent';
+import type { ChartTheme } from '../types';
+import type { Rect } from '../internal';
+/** 刷选框。拖拽期间由交互层每帧更新 rect（图表坐标系）。 */
+export declare class Brush extends ChartComponent {
+    theme: ChartTheme | null;
+    rect: Rect | null;
+    color: {
+        fill: string;
+        stroke: string;
+    } | null;
+    constructor(props: {
+        width: number;
+        height: number;
+        zIndex?: number;
+    });
+    setRect(rect: Rect | null): this;
+    protected doRender(): void;
+}

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

@@ -0,0 +1,48 @@
+import { ICEComponent } from 'ice-render';
+export interface ChartComponentProps {
+    left?: number;
+    top?: number;
+    width?: number;
+    height?: number;
+    zIndex?: number;
+    interactive?: boolean;
+    [key: string]: any;
+}
+/**
+ * ice-chart 所有组件的基类。
+ *
+ * 与引擎默认组件有三处差异：
+ * 1. origin 用 'top-left'，图表内部统一按「左上角为原点」的笛卡尔直觉坐标绘制与命中；
+ * 2. draggable / transformable / linkable 一律关闭 —— 图表图元不是编辑器图元；
+ * 3. keyboardEvtHandler 覆写为空 —— 引擎默认用方向键移动组件，这对图表是灾难
+ *    （按一下方向键整条折线平移 2px）。键盘导航由交互层统一接管。
+ */
+export declare class ChartComponent extends ICEComponent {
+    private loopRegistered;
+    constructor(props?: ChartComponentProps);
+    /** 图表组件不响应引擎默认的键盘移动。 */
+    protected keyboardEvtHandler(): void;
+    /** 左上角原点的盒式命中判定。 */
+    protected containsLocalPoint(localX: number, localY: number): boolean;
+    /**
+     * 一个「设备像素」在当前 ctx 变换下对应的本地长度。
+     * 用于把 1px 轴线 / 边框画清晰（视口缩放与 HiDPI 下都不发虚）。
+     */
+    protected unit(): number;
+    /** 把坐标对齐到设备像素中心，保证 1px 线不发虚。 */
+    protected snap(value: number): number;
+    /** 标记自身需要重绘，并唤醒渲染器。 */
+    markDirty(): this;
+    /**
+     * 让组件「持续重绘」：给引擎挂一个 100ms 循环动画。
+     *
+     * 这正是引擎蚂蚁线（lineDashFlow）的做法 —— 动画值本身没意义，
+     * 作用是每帧 setState → 标脏 → 重绘；真正的动效（如虚线相位）用 Date.now() 算。
+     * 注意：持续重绘会让脏矩形局部重绘失去意义，只在确实需要「一直动」时用，且要能停。
+     */
+    protected keepAnimating(): void;
+    /** 停止持续重绘。 */
+    protected stopAnimating(): void;
+    /** 统一的字体设置。 */
+    protected setFont(fontSize: number, fontFamily: string, weight?: string | number): void;
+}

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

@@ -0,0 +1,48 @@
+import { ICEComponent } from 'ice-render';
+export interface ChartComponentProps {
+    left?: number;
+    top?: number;
+    width?: number;
+    height?: number;
+    zIndex?: number;
+    interactive?: boolean;
+    [key: string]: any;
+}
+/**
+ * ice-chart 所有组件的基类。
+ *
+ * 与引擎默认组件有三处差异：
+ * 1. origin 用 'top-left'，图表内部统一按「左上角为原点」的笛卡尔直觉坐标绘制与命中；
+ * 2. draggable / transformable / linkable 一律关闭 —— 图表图元不是编辑器图元；
+ * 3. keyboardEvtHandler 覆写为空 —— 引擎默认用方向键移动组件，这对图表是灾难
+ *    （按一下方向键整条折线平移 2px）。键盘导航由交互层统一接管。
+ */
+export declare class ChartComponent extends ICEComponent {
+    private loopRegistered;
+    constructor(props?: ChartComponentProps);
+    /** 图表组件不响应引擎默认的键盘移动。 */
+    protected keyboardEvtHandler(): void;
+    /** 左上角原点的盒式命中判定。 */
+    protected containsLocalPoint(localX: number, localY: number): boolean;
+    /**
+     * 一个「设备像素」在当前 ctx 变换下对应的本地长度。
+     * 用于把 1px 轴线 / 边框画清晰（视口缩放与 HiDPI 下都不发虚）。
+     */
+    protected unit(): number;
+    /** 把坐标对齐到设备像素中心，保证 1px 线不发虚。 */
+    protected snap(value: number): number;
+    /** 标记自身需要重绘，并唤醒渲染器。 */
+    markDirty(): this;
+    /**
+     * 让组件「持续重绘」：给引擎挂一个 100ms 循环动画。
+     *
+     * 这正是引擎蚂蚁线（lineDashFlow）的做法 —— 动画值本身没意义，
+     * 作用是每帧 setState → 标脏 → 重绘；真正的动效（如虚线相位）用 Date.now() 算。
+     * 注意：持续重绘会让脏矩形局部重绘失去意义，只在确实需要「一直动」时用，且要能停。
+     */
+    protected keepAnimating(): void;
+    /** 停止持续重绘。 */
+    protected stopAnimating(): void;
+    /** 统一的字体设置。 */
+    protected setFont(fontSize: number, fontFamily: string, weight?: string | number): void;
+}

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

@@ -0,0 +1,40 @@
+import { ChartComponent } from './ChartComponent.mjs';
+import type { ChartTheme, CrosshairOption } from '../types.mjs';
+import type { ChartLayout } from '../internal.mjs';
+/** 十字准星：跟随活动数据列的辅助线 + 坐标轴数值标签。 */
+export declare class Crosshair extends ChartComponent {
+    layout: ChartLayout | null;
+    theme: ChartTheme | null;
+    option: CrosshairOption;
+    pixelX: number | null;
+    pixelY: number | null;
+    xLabel: string;
+    yLabel: string;
+    /** 最近一次绘制的轴数值标签矩形（图表坐标系），供外观审计 / 测试断言使用。 */
+    lastChipRects: Array<{
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }>;
+    /** 换列时的跟随时长（毫秒）：由图表按 `animation.update.duration` 下发。 */
+    followDuration: number;
+    constructor(props: {
+        width: number;
+        height: number;
+        zIndex?: number;
+    });
+    show(pixelX: number | null, pixelY: number | null, xLabel: string, yLabel: string): this;
+    /** 绘制位置（可能是动画中的中间值）；`pixelX/pixelY` 始终是目标值。 */
+    private drawnX;
+    private drawnY;
+    /**
+     * 准星平滑：每次悬停换列时从**当前位置**补间到新位置（而不是硬切）。
+     * 快速划过时会有轻微跟随感，这正是十字准星该有的手感。
+     */
+    private animateAxis;
+    hide(): this;
+    private stopAxisAnimation;
+    protected doRender(): void;
+    private drawChip;
+}

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

@@ -0,0 +1,40 @@
+import { ChartComponent } from './ChartComponent';
+import type { ChartTheme, CrosshairOption } from '../types';
+import type { ChartLayout } from '../internal';
+/** 十字准星：跟随活动数据列的辅助线 + 坐标轴数值标签。 */
+export declare class Crosshair extends ChartComponent {
+    layout: ChartLayout | null;
+    theme: ChartTheme | null;
+    option: CrosshairOption;
+    pixelX: number | null;
+    pixelY: number | null;
+    xLabel: string;
+    yLabel: string;
+    /** 最近一次绘制的轴数值标签矩形（图表坐标系），供外观审计 / 测试断言使用。 */
+    lastChipRects: Array<{
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }>;
+    /** 换列时的跟随时长（毫秒）：由图表按 `animation.update.duration` 下发。 */
+    followDuration: number;
+    constructor(props: {
+        width: number;
+        height: number;
+        zIndex?: number;
+    });
+    show(pixelX: number | null, pixelY: number | null, xLabel: string, yLabel: string): this;
+    /** 绘制位置（可能是动画中的中间值）；`pixelX/pixelY` 始终是目标值。 */
+    private drawnX;
+    private drawnY;
+    /**
+     * 准星平滑：每次悬停换列时从**当前位置**补间到新位置（而不是硬切）。
+     * 快速划过时会有轻微跟随感，这正是十字准星该有的手感。
+     */
+    private animateAxis;
+    hide(): this;
+    private stopAxisAnimation;
+    protected doRender(): void;
+    private drawChip;
+}

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

@@ -0,0 +1,30 @@
+import { ChartComponent } from './ChartComponent.mjs';
+import type { ChartTheme } from '../types.mjs';
+export type SliderPart = 'start' | 'end' | 'window' | 'track';
+/**
+ * dataZoom 滑块。
+ *
+ * 组件只关心「0~1 的窗口比例」：把比例换算成数据域是图表层的职责
+ * （类目轴按索引窗口、数值/时间轴按线性插值），因此这个组件对坐标系一无所知。
+ */
+export declare class DataZoomSlider extends ChartComponent {
+    theme: ChartTheme | null;
+    /** 窗口比例（0~1）。 */
+    start: number;
+    end: number;
+    activePart: SliderPart | null;
+    private handleWidth;
+    constructor(props: {
+        left?: number;
+        top?: number;
+        width: number;
+        height: number;
+        zIndex?: number;
+    });
+    setWindow(start: number, end: number): this;
+    setActive(part: SliderPart | null): this;
+    /** 指针落在滑块的哪一部分。 */
+    hitPart(localX: number, localY: number): SliderPart | null;
+    fractionAt(localX: number): number;
+    protected doRender(): void;
+}

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

@@ -0,0 +1,30 @@
+import { ChartComponent } from './ChartComponent';
+import type { ChartTheme } from '../types';
+export type SliderPart = 'start' | 'end' | 'window' | 'track';
+/**
+ * dataZoom 滑块。
+ *
+ * 组件只关心「0~1 的窗口比例」：把比例换算成数据域是图表层的职责
+ * （类目轴按索引窗口、数值/时间轴按线性插值），因此这个组件对坐标系一无所知。
+ */
+export declare class DataZoomSlider extends ChartComponent {
+    theme: ChartTheme | null;
+    /** 窗口比例（0~1）。 */
+    start: number;
+    end: number;
+    activePart: SliderPart | null;
+    private handleWidth;
+    constructor(props: {
+        left?: number;
+        top?: number;
+        width: number;
+        height: number;
+        zIndex?: number;
+    });
+    setWindow(start: number, end: number): this;
+    setActive(part: SliderPart | null): this;
+    /** 指针落在滑块的哪一部分。 */
+    hitPart(localX: number, localY: number): SliderPart | null;
+    fractionAt(localX: number): number;
+    protected doRender(): void;
+}

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

@@ -0,0 +1,37 @@
+import { ChartComponent } from './ChartComponent.mjs';
+import type { ChartTheme, GridOption } from '../types.mjs';
+import type { Rect } from '../internal.mjs';
+import type { Scale } from '../scale.mjs';
+/** 网格线。绘制在 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;
+}