@damoqiongqiu/ice-chart 0.30.2 → 0.30.3

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

@@ -23,6 +23,23 @@ export declare class Highlight extends ChartComponent {
     theme: ChartTheme | null;
     hoverItems: HighlightItem[];
     selectionItems: HighlightItem[];
+    /**
+     * 只许画在这个矩形里（画布坐标）—— 一般就是绘图区，`null` = 不裁剪。
+     *
+     * 为什么必须有（2026-09-23，审计 `ink-over-right-axis` 的那个缺陷）：
+     * 标记环是**以数据点为中心**画的，而滑动窗口 / 缩放之后最常见的状态就是
+     * 「当前点正好落在绘图区边界上」—— 环半径那几个像素就必然画到轴带里去。
+     * 实测在 40px 宽的轴带里量到 44~58 个饱和像素，就是半颗环。
+     *
+     * 裁剪盒与 `item.x / item.y` **同一个坐标系**（都由图表按绘图区矩形给出），
+     * 所以这里直接用 `ctx.rect(clipBox)`，不需要再做任何换算。
+     */
+    clipBox: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | null;
     constructor(props: {
         width: number;
         height: number;
@@ -30,5 +47,12 @@ export declare class Highlight extends ChartComponent {
     });
     setHover(items: HighlightItem[]): this;
     setSelection(items: HighlightItem[]): this;
+    /** 设置裁剪盒；**没变就不置脏**（否则每帧重建都会把高亮层标脏，局部重绘的收益就没了）。 */
+    setClipBox(box: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | null): this;
     protected doRender(): void;
 }

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

@@ -23,6 +23,23 @@ export declare class Highlight extends ChartComponent {
     theme: ChartTheme | null;
     hoverItems: HighlightItem[];
     selectionItems: HighlightItem[];
+    /**
+     * 只许画在这个矩形里（画布坐标）—— 一般就是绘图区，`null` = 不裁剪。
+     *
+     * 为什么必须有（2026-09-23，审计 `ink-over-right-axis` 的那个缺陷）：
+     * 标记环是**以数据点为中心**画的，而滑动窗口 / 缩放之后最常见的状态就是
+     * 「当前点正好落在绘图区边界上」—— 环半径那几个像素就必然画到轴带里去。
+     * 实测在 40px 宽的轴带里量到 44~58 个饱和像素，就是半颗环。
+     *
+     * 裁剪盒与 `item.x / item.y` **同一个坐标系**（都由图表按绘图区矩形给出），
+     * 所以这里直接用 `ctx.rect(clipBox)`，不需要再做任何换算。
+     */
+    clipBox: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | null;
     constructor(props: {
         width: number;
         height: number;
@@ -30,5 +47,12 @@ export declare class Highlight extends ChartComponent {
     });
     setHover(items: HighlightItem[]): this;
     setSelection(items: HighlightItem[]): this;
+    /** 设置裁剪盒；**没变就不置脏**（否则每帧重建都会把高亮层标脏，局部重绘的收益就没了）。 */
+    setClipBox(box: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | null): this;
     protected doRender(): void;
 }

package/dist/types/internal.d.mts

@@ -424,6 +424,15 @@ export interface AxisLayout {
     formatLabel?: (index: number) => string;
     /** 布局那一趟按样本量到的最大标签宽度（惰性格式化时 `labels` 里只有样本，不能再抽样）。 */
     sampledLabelWidth?: number;
+    /**
+     * **抽稀之后仍然要画的那些刻度的原下标**（升序）。
+     *
+     * `undefined` = 没有抽稀（整张 `ticks` 都要画）。给定之后，热路径只该按这张表走：
+     * `Axis` 不再遍历整条 `ticks`（10 万类目里只有十几颗要画），`GridLines` 的竖线
+     * 也直接按它取位置。`ticks` / `labels` 的长度与下标对齐关系**保持不变** ——
+     * 它们仍然是「整条轴」的事实来源，只是没人再逐项扫一遍了。
+     */
+    visible?: number[];
     /** 该轴相对绘图区边缘外扩的像素距离（多轴时同侧的轴逐层外移）。 */
     offset: number;
     /** 刻度标签的最大宽度 / 高度（像素）。 */

package/dist/types/internal.d.ts

@@ -424,6 +424,15 @@ export interface AxisLayout {
     formatLabel?: (index: number) => string;
     /** 布局那一趟按样本量到的最大标签宽度（惰性格式化时 `labels` 里只有样本，不能再抽样）。 */
     sampledLabelWidth?: number;
+    /**
+     * **抽稀之后仍然要画的那些刻度的原下标**（升序）。
+     *
+     * `undefined` = 没有抽稀（整张 `ticks` 都要画）。给定之后，热路径只该按这张表走：
+     * `Axis` 不再遍历整条 `ticks`（10 万类目里只有十几颗要画），`GridLines` 的竖线
+     * 也直接按它取位置。`ticks` / `labels` 的长度与下标对齐关系**保持不变** ——
+     * 它们仍然是「整条轴」的事实来源，只是没人再逐项扫一遍了。
+     */
+    visible?: number[];
     /** 该轴相对绘图区边缘外扩的像素距离（多轴时同侧的轴逐层外移）。 */
     offset: number;
     /** 刻度标签的最大宽度 / 高度（像素）。 */

package/package.json

@@ -1,7 +1,7 @@
 {
   "author": "大漠穷秋",
   "name": "@damoqiongqiu/ice-chart",
-  "version": "0.30.2",
+  "version": "0.30.3",
   "license": "MIT",
   "description": "基于 ice-render Canvas 引擎的交互式图表库：命中测试与事件派发由引擎承担，图表层只做「数据 ↔ 像素 ↔ 语义事件」。",
   "keywords": [