@hsu-react/ui 0.0.8 → 0.0.9

package/es/components/Chart/Bar/index.d.ts

@@ -1,7 +1,7 @@
 import * as echarts from "echarts";
 import { ChartCommonProps, SeriesDataType } from "..";
 import React from "react";
-import { ChartScrollConfig } from "../_utils/cartesian";
+import { ChartScrollConfig, DataZoomIndexWindow } from "../_utils/cartesian";
 export interface ChartBarProps extends ChartCommonProps {
     chartTitle?: string;
     xAxisData?: Array<string>;
@@ -9,6 +9,10 @@ export interface ChartBarProps extends ChartCommonProps {
     legendData?: string[];
     scrollConfig?: ChartScrollConfig;
     onClick?: (event: echarts.ECElementEvent) => void;
+    /** 图例点选变化回调，参数为当前各系列选中状态（配合 legend.selected 可实现坐标轴重算） */
+    onLegendSelectChanged?: (selected: Record<string, boolean>) => void;
+    /** dataZoom 可见窗口变化回调（滑块/滚轮/自动滚动/初始同步均触发），参数为当前可见的 x 轴索引区间（配合 useDataZoomWindow 可按展示部分重算坐标轴） */
+    onDataZoomWindowChanged?: (window: DataZoomIndexWindow) => void;
     /** 是否启用图例自动滚动，默认 false */
     enableLegendAutoScroll?: boolean;
     /** 图例每页可见数量，默认 8 */

package/es/components/Chart/Bar/index.js

@@ -1,5 +1,5 @@
 function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
-var _excluded = ["className", "style", "chartTitle", "xAxisData", "seriesData", "legendData", "legend", "grid", "tooltip", "xAxis", "yAxis", "series", "title", "scrollConfig", "dataZoom", "insideDataZoom", "sliderDataZoom", "onClick", "enableLegendAutoScroll", "legendVisibleCount", "legendScrollInterval"];
+var _excluded = ["className", "style", "chartTitle", "xAxisData", "seriesData", "legendData", "legend", "grid", "tooltip", "xAxis", "yAxis", "series", "title", "scrollConfig", "dataZoom", "insideDataZoom", "sliderDataZoom", "onClick", "onLegendSelectChanged", "onDataZoomWindowChanged", "enableLegendAutoScroll", "legendVisibleCount", "legendScrollInterval"];
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
@@ -12,7 +12,7 @@ import React, { useCallback, useEffect, useMemo, useRef } from "react";
 import styles from "../index.module.scss";
 import { autoScrollLegend } from "../_utils/autoScrollLegend";
 import { autoScrollByItem } from "../_utils/autoSmooth";
-import { buildCartesianSeriesOptions, createDefaultCategoryXAxis, createDefaultValueYAxis, getSliderShow, resolveScrollConfig } from "../_utils/cartesian";
+import { buildCartesianSeriesOptions, createDefaultCategoryXAxis, createDefaultValueYAxis, getSliderShow, percentWindowToIndexWindow, resolveScrollConfig } from "../_utils/cartesian";
 import { jsx as _jsx } from "react/jsx-runtime";
 var ChartBar = function ChartBar(props) {
   var className = props.className,
@@ -33,6 +33,8 @@ var ChartBar = function ChartBar(props) {
     insideDataZoom = props.insideDataZoom,
     sliderDataZoom = props.sliderDataZoom,
     onClick = props.onClick,
+    onLegendSelectChanged = props.onLegendSelectChanged,
+    onDataZoomWindowChanged = props.onDataZoomWindowChanged,
     _props$enableLegendAu = props.enableLegendAutoScroll,
     enableLegendAutoScroll = _props$enableLegendAu === void 0 ? false : _props$enableLegendAu,
     _props$legendVisibleC = props.legendVisibleCount,
@@ -43,6 +45,7 @@ var ChartBar = function ChartBar(props) {
   var chartRef = useRef(null);
   var chartInstanceRef = useRef(null);
   var resizeObserverRef = useRef(null);
+  var prevXAxisKeyRef = useRef(null);
   var legendScrollRef = useRef(null);
   var normalizedScroll = useMemo(function () {
     return resolveScrollConfig(scrollConfig);
@@ -182,7 +185,7 @@ var ChartBar = function ChartBar(props) {
 
   // 初始化图表
   useEffect(function () {
-    var _opt$legend$, _opt$legend, _ref3;
+    var _xAxisData$join, _chart$getOption, _opt$legend$, _opt$legend, _ref3;
     if (!chartRef.current) return;
 
     // 初始化或获取已存在的实例
@@ -192,8 +195,40 @@ var ChartBar = function ChartBar(props) {
       chartInstanceRef.current = chart;
     }
 
-    // 设置配置
+    // 设置配置：notMerge 会把 dataZoom 窗口重置回初始位置，
+    // x 轴数据未变化时（如坐标轴重算/图例点选触发的重渲染）先记录当前窗口，设置后恢复
+    var xAxisKey = (_xAxisData$join = xAxisData === null || xAxisData === void 0 ? void 0 : xAxisData.join("\x01")) !== null && _xAxisData$join !== void 0 ? _xAxisData$join : "";
+    var prevZoomRanges = prevXAxisKeyRef.current === xAxisKey ? (_chart$getOption = chart.getOption()) === null || _chart$getOption === void 0 ? void 0 : _chart$getOption.dataZoom : undefined;
+    prevXAxisKeyRef.current = xAxisKey;
     chart.setOption(chartOption, true);
+    var nextZooms = chartOption.dataZoom;
+    if (prevZoomRanges !== null && prevZoomRanges !== void 0 && prevZoomRanges.length && Array.isArray(nextZooms) && nextZooms.length === prevZoomRanges.length) {
+      chart.setOption({
+        dataZoom: prevZoomRanges.map(function (z) {
+          return {
+            start: z.start,
+            end: z.end
+          };
+        })
+      });
+    }
+
+    // 向调用方同步当前可见窗口（初始渲染与恢复后），用于按展示部分重算坐标轴
+    if (onDataZoomWindowChanged) {
+      var _chart$getOption2, _xAxisData$length2;
+      var zooms = (_chart$getOption2 = chart.getOption()) === null || _chart$getOption2 === void 0 ? void 0 : _chart$getOption2.dataZoom;
+      var zoom = zooms === null || zooms === void 0 ? void 0 : zooms[0];
+      var totalLen = (_xAxisData$length2 = xAxisData === null || xAxisData === void 0 ? void 0 : xAxisData.length) !== null && _xAxisData$length2 !== void 0 ? _xAxisData$length2 : 0;
+      if (typeof (zoom === null || zoom === void 0 ? void 0 : zoom.start) === "number" && typeof (zoom === null || zoom === void 0 ? void 0 : zoom.end) === "number") {
+        onDataZoomWindowChanged(percentWindowToIndexWindow(zoom.start, zoom.end, totalLen));
+      } else {
+        // 无 dataZoom（如数据量不足未启用滚动）时窗口即全量，同步一次避免残留旧窗口
+        onDataZoomWindowChanged({
+          startIndex: 0,
+          endIndex: Math.max(0, totalLen - 1)
+        });
+      }
+    }
 
     // 添加 resize 监听
     window.addEventListener("resize", handleResize);
@@ -210,6 +245,35 @@ var ChartBar = function ChartBar(props) {
       (_chartInstanceRef$cur2 = chartInstanceRef.current) === null || _chartInstanceRef$cur2 === void 0 || _chartInstanceRef$cur2.on("click", onClick);
     }
 
+    // 图例点选事件
+    var handleLegendSelectChanged = function handleLegendSelectChanged(params) {
+      onLegendSelectChanged === null || onLegendSelectChanged === void 0 || onLegendSelectChanged(params.selected);
+    };
+    if (onLegendSelectChanged) {
+      var _chartInstanceRef$cur3;
+      (_chartInstanceRef$cur3 = chartInstanceRef.current) === null || _chartInstanceRef$cur3 === void 0 || _chartInstanceRef$cur3.on("legendselectchanged", handleLegendSelectChanged);
+    }
+
+    // dataZoom 原生交互（slider 拖动 / inside 缩放）→ 同步可见窗口
+    var handleDataZoom = function handleDataZoom(params) {
+      var _raw$batch$, _raw$batch;
+      var raw = params;
+      var info = (_raw$batch$ = raw === null || raw === void 0 || (_raw$batch = raw.batch) === null || _raw$batch === void 0 ? void 0 : _raw$batch[0]) !== null && _raw$batch$ !== void 0 ? _raw$batch$ : raw;
+      if (typeof (info === null || info === void 0 ? void 0 : info.startValue) === "number" && typeof (info === null || info === void 0 ? void 0 : info.endValue) === "number") {
+        onDataZoomWindowChanged === null || onDataZoomWindowChanged === void 0 || onDataZoomWindowChanged({
+          startIndex: Math.max(0, Math.round(info.startValue)),
+          endIndex: Math.max(0, Math.round(info.endValue))
+        });
+      } else if (typeof (info === null || info === void 0 ? void 0 : info.start) === "number" && typeof (info === null || info === void 0 ? void 0 : info.end) === "number") {
+        var _xAxisData$length3;
+        onDataZoomWindowChanged === null || onDataZoomWindowChanged === void 0 || onDataZoomWindowChanged(percentWindowToIndexWindow(info.start, info.end, (_xAxisData$length3 = xAxisData === null || xAxisData === void 0 ? void 0 : xAxisData.length) !== null && _xAxisData$length3 !== void 0 ? _xAxisData$length3 : 0));
+      }
+    };
+    if (onDataZoomWindowChanged) {
+      var _chartInstanceRef$cur4;
+      (_chartInstanceRef$cur4 = chartInstanceRef.current) === null || _chartInstanceRef$cur4 === void 0 || _chartInstanceRef$cur4.on("datazoom", handleDataZoom);
+    }
+
     // 图例自动滚动（参考 Pie 组件）
     var opt = chartOption;
     var legendDataLen = Array.isArray(opt.legend) ? (_opt$legend$ = opt.legend[0]) === null || _opt$legend$ === void 0 || (_opt$legend$ = _opt$legend$.data) === null || _opt$legend$ === void 0 ? void 0 : _opt$legend$.length : (_opt$legend = opt.legend) === null || _opt$legend === void 0 || (_opt$legend = _opt$legend.data) === null || _opt$legend === void 0 ? void 0 : _opt$legend.length;
@@ -232,15 +296,23 @@ var ChartBar = function ChartBar(props) {
     return function () {
       window.removeEventListener("resize", handleResize);
       if (onClick) {
-        var _chartInstanceRef$cur3;
-        (_chartInstanceRef$cur3 = chartInstanceRef.current) === null || _chartInstanceRef$cur3 === void 0 || _chartInstanceRef$cur3.off("click", onClick);
+        var _chartInstanceRef$cur5;
+        (_chartInstanceRef$cur5 = chartInstanceRef.current) === null || _chartInstanceRef$cur5 === void 0 || _chartInstanceRef$cur5.off("click", onClick);
+      }
+      if (onLegendSelectChanged) {
+        var _chartInstanceRef$cur6;
+        (_chartInstanceRef$cur6 = chartInstanceRef.current) === null || _chartInstanceRef$cur6 === void 0 || _chartInstanceRef$cur6.off("legendselectchanged", handleLegendSelectChanged);
+      }
+      if (onDataZoomWindowChanged) {
+        var _chartInstanceRef$cur7;
+        (_chartInstanceRef$cur7 = chartInstanceRef.current) === null || _chartInstanceRef$cur7 === void 0 || _chartInstanceRef$cur7.off("datazoom", handleDataZoom);
       }
       if (legendScrollRef.current) {
         legendScrollRef.current.dispose();
         legendScrollRef.current = null;
       }
     };
-  }, [chartOption, handleResize, onClick, enableLegendAutoScroll, legendVisibleCount, legendScrollInterval]);
+  }, [chartOption, handleResize, onClick, onLegendSelectChanged, onDataZoomWindowChanged, xAxisData, enableLegendAutoScroll, legendVisibleCount, legendScrollInterval]);
 
   // 处理自动播放
   useEffect(function () {
@@ -257,11 +329,14 @@ var ChartBar = function ChartBar(props) {
         interval: normalizedScroll.interval,
         startIndex: normalizedScroll.startIndex,
         autoPlay: normalizedScroll.autoScroll,
-        enableWheelScroll: enableWheelScroll
+        enableWheelScroll: enableWheelScroll,
+        onWindowChange: onDataZoomWindowChanged ? function (startPercent, endPercent) {
+          return onDataZoomWindowChanged(percentWindowToIndexWindow(startPercent, endPercent, xAxisData.length));
+        } : undefined
       }),
       dispose = _autoScrollByItem.dispose;
     return dispose;
-  }, [dataZoom, normalizedScroll, sliderDataZoom, xAxisData]);
+  }, [dataZoom, normalizedScroll, sliderDataZoom, xAxisData, onDataZoomWindowChanged]);
 
   // 组件卸载时清理资源
   useEffect(function () {

package/es/components/Chart/Line/index.d.ts

@@ -1,7 +1,7 @@
 import * as echarts from "echarts";
 import { ChartCommonProps, SeriesDataType } from "..";
 import React from "react";
-import { ChartScrollConfig } from "../_utils/cartesian";
+import { ChartScrollConfig, DataZoomIndexWindow } from "../_utils/cartesian";
 export interface ChartLineProps extends ChartCommonProps {
     chartTitle?: string;
     xAxisData?: Array<string>;
@@ -10,6 +10,10 @@ export interface ChartLineProps extends ChartCommonProps {
     scrollConfig?: ChartScrollConfig;
     yAxisNameOffsets?: number[];
     onClick?: (event: echarts.ECElementEvent) => void;
+    /** 图例点选变化回调，参数为当前各系列选中状态（配合 legend.selected 可实现坐标轴重算） */
+    onLegendSelectChanged?: (selected: Record<string, boolean>) => void;
+    /** dataZoom 可见窗口变化回调（滑块/滚轮/自动滚动/初始同步均触发），参数为当前可见的 x 轴索引区间（配合 useDataZoomWindow 可按展示部分重算坐标轴） */
+    onDataZoomWindowChanged?: (window: DataZoomIndexWindow) => void;
     /** 是否启用图例自动滚动，默认 false */
     enableLegendAutoScroll?: boolean;
     /** 图例每页可见数量，默认 8 */

package/es/components/Chart/Line/index.js

@@ -1,5 +1,5 @@
 function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
-var _excluded = ["className", "style", "chartTitle", "xAxisData", "seriesData", "legendData", "grid", "tooltip", "xAxis", "yAxis", "series", "title", "legend", "scrollConfig", "dataZoom", "insideDataZoom", "sliderDataZoom", "onClick", "enableLegendAutoScroll", "legendVisibleCount", "legendScrollInterval"];
+var _excluded = ["className", "style", "chartTitle", "xAxisData", "seriesData", "legendData", "grid", "tooltip", "xAxis", "yAxis", "series", "title", "legend", "scrollConfig", "dataZoom", "insideDataZoom", "sliderDataZoom", "onClick", "onLegendSelectChanged", "onDataZoomWindowChanged", "enableLegendAutoScroll", "legendVisibleCount", "legendScrollInterval"];
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
@@ -12,7 +12,7 @@ import React, { useCallback, useEffect, useMemo, useRef } from "react";
 import styles from "../index.module.scss";
 import { autoScrollLegend } from "../_utils/autoScrollLegend";
 import { autoScrollByItem } from "../_utils/autoSmooth";
-import { buildCartesianSeriesOptions, createDefaultCategoryXAxis, createDefaultValueYAxis, getSliderShow, resolveScrollConfig } from "../_utils/cartesian";
+import { buildCartesianSeriesOptions, createDefaultCategoryXAxis, createDefaultValueYAxis, getSliderShow, percentWindowToIndexWindow, resolveScrollConfig } from "../_utils/cartesian";
 import { jsx as _jsx } from "react/jsx-runtime";
 var ChartLine = function ChartLine(props) {
   var className = props.className,
@@ -33,6 +33,8 @@ var ChartLine = function ChartLine(props) {
     insideDataZoom = props.insideDataZoom,
     sliderDataZoom = props.sliderDataZoom,
     onClick = props.onClick,
+    onLegendSelectChanged = props.onLegendSelectChanged,
+    onDataZoomWindowChanged = props.onDataZoomWindowChanged,
     _props$enableLegendAu = props.enableLegendAutoScroll,
     enableLegendAutoScroll = _props$enableLegendAu === void 0 ? false : _props$enableLegendAu,
     _props$legendVisibleC = props.legendVisibleCount,
@@ -43,6 +45,7 @@ var ChartLine = function ChartLine(props) {
   var chartRef = useRef(null);
   var chartInstanceRef = useRef(null);
   var resizeObserverRef = useRef(null);
+  var prevXAxisKeyRef = useRef(null);
   var legendScrollRef = useRef(null);
   var normalizedScroll = useMemo(function () {
     return resolveScrollConfig(scrollConfig);
@@ -178,7 +181,7 @@ var ChartLine = function ChartLine(props) {
 
   // 初始化图表
   useEffect(function () {
-    var _opt$legend$, _opt$legend, _ref3;
+    var _xAxisData$join, _chart$getOption, _opt$legend$, _opt$legend, _ref3;
     if (!chartRef.current) return;
 
     // 初始化或获取已存在的实例
@@ -188,8 +191,40 @@ var ChartLine = function ChartLine(props) {
       chartInstanceRef.current = chart;
     }
 
-    // 设置配置
+    // 设置配置：notMerge 会把 dataZoom 窗口重置回初始位置，
+    // x 轴数据未变化时（如坐标轴重算/图例点选触发的重渲染）先记录当前窗口，设置后恢复
+    var xAxisKey = (_xAxisData$join = xAxisData === null || xAxisData === void 0 ? void 0 : xAxisData.join("\x01")) !== null && _xAxisData$join !== void 0 ? _xAxisData$join : "";
+    var prevZoomRanges = prevXAxisKeyRef.current === xAxisKey ? (_chart$getOption = chart.getOption()) === null || _chart$getOption === void 0 ? void 0 : _chart$getOption.dataZoom : undefined;
+    prevXAxisKeyRef.current = xAxisKey;
     chart.setOption(chartOption, true);
+    var nextZooms = chartOption.dataZoom;
+    if (prevZoomRanges !== null && prevZoomRanges !== void 0 && prevZoomRanges.length && Array.isArray(nextZooms) && nextZooms.length === prevZoomRanges.length) {
+      chart.setOption({
+        dataZoom: prevZoomRanges.map(function (z) {
+          return {
+            start: z.start,
+            end: z.end
+          };
+        })
+      });
+    }
+
+    // 向调用方同步当前可见窗口（初始渲染与恢复后），用于按展示部分重算坐标轴
+    if (onDataZoomWindowChanged) {
+      var _chart$getOption2, _xAxisData$length2;
+      var zooms = (_chart$getOption2 = chart.getOption()) === null || _chart$getOption2 === void 0 ? void 0 : _chart$getOption2.dataZoom;
+      var zoom = zooms === null || zooms === void 0 ? void 0 : zooms[0];
+      var totalLen = (_xAxisData$length2 = xAxisData === null || xAxisData === void 0 ? void 0 : xAxisData.length) !== null && _xAxisData$length2 !== void 0 ? _xAxisData$length2 : 0;
+      if (typeof (zoom === null || zoom === void 0 ? void 0 : zoom.start) === "number" && typeof (zoom === null || zoom === void 0 ? void 0 : zoom.end) === "number") {
+        onDataZoomWindowChanged(percentWindowToIndexWindow(zoom.start, zoom.end, totalLen));
+      } else {
+        // 无 dataZoom（如数据量不足未启用滚动）时窗口即全量，同步一次避免残留旧窗口
+        onDataZoomWindowChanged({
+          startIndex: 0,
+          endIndex: Math.max(0, totalLen - 1)
+        });
+      }
+    }
 
     // 添加 resize 监听
     window.addEventListener("resize", handleResize);
@@ -206,6 +241,35 @@ var ChartLine = function ChartLine(props) {
       (_chartInstanceRef$cur2 = chartInstanceRef.current) === null || _chartInstanceRef$cur2 === void 0 || _chartInstanceRef$cur2.on("click", onClick);
     }
 
+    // 图例点选事件
+    var handleLegendSelectChanged = function handleLegendSelectChanged(params) {
+      onLegendSelectChanged === null || onLegendSelectChanged === void 0 || onLegendSelectChanged(params.selected);
+    };
+    if (onLegendSelectChanged) {
+      var _chartInstanceRef$cur3;
+      (_chartInstanceRef$cur3 = chartInstanceRef.current) === null || _chartInstanceRef$cur3 === void 0 || _chartInstanceRef$cur3.on("legendselectchanged", handleLegendSelectChanged);
+    }
+
+    // dataZoom 原生交互（slider 拖动 / inside 缩放）→ 同步可见窗口
+    var handleDataZoom = function handleDataZoom(params) {
+      var _raw$batch$, _raw$batch;
+      var raw = params;
+      var info = (_raw$batch$ = raw === null || raw === void 0 || (_raw$batch = raw.batch) === null || _raw$batch === void 0 ? void 0 : _raw$batch[0]) !== null && _raw$batch$ !== void 0 ? _raw$batch$ : raw;
+      if (typeof (info === null || info === void 0 ? void 0 : info.startValue) === "number" && typeof (info === null || info === void 0 ? void 0 : info.endValue) === "number") {
+        onDataZoomWindowChanged === null || onDataZoomWindowChanged === void 0 || onDataZoomWindowChanged({
+          startIndex: Math.max(0, Math.round(info.startValue)),
+          endIndex: Math.max(0, Math.round(info.endValue))
+        });
+      } else if (typeof (info === null || info === void 0 ? void 0 : info.start) === "number" && typeof (info === null || info === void 0 ? void 0 : info.end) === "number") {
+        var _xAxisData$length3;
+        onDataZoomWindowChanged === null || onDataZoomWindowChanged === void 0 || onDataZoomWindowChanged(percentWindowToIndexWindow(info.start, info.end, (_xAxisData$length3 = xAxisData === null || xAxisData === void 0 ? void 0 : xAxisData.length) !== null && _xAxisData$length3 !== void 0 ? _xAxisData$length3 : 0));
+      }
+    };
+    if (onDataZoomWindowChanged) {
+      var _chartInstanceRef$cur4;
+      (_chartInstanceRef$cur4 = chartInstanceRef.current) === null || _chartInstanceRef$cur4 === void 0 || _chartInstanceRef$cur4.on("datazoom", handleDataZoom);
+    }
+
     // 图例自动滚动（与 Pie/Bar 一致）
     var opt = chartOption;
     var legendDataLen = Array.isArray(opt.legend) ? (_opt$legend$ = opt.legend[0]) === null || _opt$legend$ === void 0 || (_opt$legend$ = _opt$legend$.data) === null || _opt$legend$ === void 0 ? void 0 : _opt$legend$.length : (_opt$legend = opt.legend) === null || _opt$legend === void 0 || (_opt$legend = _opt$legend.data) === null || _opt$legend === void 0 ? void 0 : _opt$legend.length;
@@ -228,15 +292,23 @@ var ChartLine = function ChartLine(props) {
     return function () {
       window.removeEventListener("resize", handleResize);
       if (onClick) {
-        var _chartInstanceRef$cur3;
-        (_chartInstanceRef$cur3 = chartInstanceRef.current) === null || _chartInstanceRef$cur3 === void 0 || _chartInstanceRef$cur3.off("click", onClick);
+        var _chartInstanceRef$cur5;
+        (_chartInstanceRef$cur5 = chartInstanceRef.current) === null || _chartInstanceRef$cur5 === void 0 || _chartInstanceRef$cur5.off("click", onClick);
+      }
+      if (onLegendSelectChanged) {
+        var _chartInstanceRef$cur6;
+        (_chartInstanceRef$cur6 = chartInstanceRef.current) === null || _chartInstanceRef$cur6 === void 0 || _chartInstanceRef$cur6.off("legendselectchanged", handleLegendSelectChanged);
+      }
+      if (onDataZoomWindowChanged) {
+        var _chartInstanceRef$cur7;
+        (_chartInstanceRef$cur7 = chartInstanceRef.current) === null || _chartInstanceRef$cur7 === void 0 || _chartInstanceRef$cur7.off("datazoom", handleDataZoom);
       }
       if (legendScrollRef.current) {
         legendScrollRef.current.dispose();
         legendScrollRef.current = null;
       }
     };
-  }, [chartOption, handleResize, onClick, enableLegendAutoScroll, legendVisibleCount, legendScrollInterval]);
+  }, [chartOption, handleResize, onClick, onLegendSelectChanged, onDataZoomWindowChanged, xAxisData, enableLegendAutoScroll, legendVisibleCount, legendScrollInterval]);
 
   // 处理自动播放
   useEffect(function () {
@@ -253,11 +325,14 @@ var ChartLine = function ChartLine(props) {
         interval: normalizedScroll.interval,
         startIndex: normalizedScroll.startIndex,
         autoPlay: normalizedScroll.autoScroll,
-        enableWheelScroll: enableWheelScroll
+        enableWheelScroll: enableWheelScroll,
+        onWindowChange: onDataZoomWindowChanged ? function (startPercent, endPercent) {
+          return onDataZoomWindowChanged(percentWindowToIndexWindow(startPercent, endPercent, xAxisData.length));
+        } : undefined
       }),
       dispose = _autoScrollByItem.dispose;
     return dispose;
-  }, [dataZoom, normalizedScroll, sliderDataZoom, xAxisData]);
+  }, [dataZoom, normalizedScroll, sliderDataZoom, xAxisData, onDataZoomWindowChanged]);
 
   // 组件卸载时清理资源
   useEffect(function () {

package/es/components/Chart/_utils/autoSmooth.d.ts

@@ -7,6 +7,8 @@ export interface AutoScrollByItemProps {
     startIndex?: number;
     autoPlay?: boolean;
     enableWheelScroll?: boolean;
+    /** 窗口变化回调（创建同步、自动滚动、滚轮、resize 均触发），参数为当前窗口 start/end 百分比 */
+    onWindowChange?: (startPercent: number, endPercent: number) => void;
 }
 export declare function autoScrollByItem(props: AutoScrollByItemProps): {
     pause: () => void;

package/es/components/Chart/_utils/autoSmooth.js

@@ -5,7 +5,7 @@ function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key i
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
 function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 export function autoScrollByItem(props) {
-  var _xAxisData$length;
+  var _xAxisData$length, _chart$getOption;
   var chart = props.chart,
     xAxisData = props.xAxisData,
     _props$windowSize = props.windowSize,
@@ -17,7 +17,8 @@ export function autoScrollByItem(props) {
     _props$autoPlay = props.autoPlay,
     autoPlay = _props$autoPlay === void 0 ? true : _props$autoPlay,
     _props$enableWheelScr = props.enableWheelScroll,
-    enableWheelScroll = _props$enableWheelScr === void 0 ? true : _props$enableWheelScr;
+    enableWheelScroll = _props$enableWheelScr === void 0 ? true : _props$enableWheelScr,
+    onWindowChange = props.onWindowChange;
   var total = (_xAxisData$length = xAxisData === null || xAxisData === void 0 ? void 0 : xAxisData.length) !== null && _xAxisData$length !== void 0 ? _xAxisData$length : 0;
   if (total <= 0) {
     return {
@@ -32,6 +33,14 @@ export function autoScrollByItem(props) {
   var initialStartPercent = total > 0 ? initialStartIndex / total * 100 : 0;
   var start = initialStartPercent;
   var end = Math.min(initialStartPercent + windowSizePercent, 100);
+
+  // 图表已有 dataZoom 窗口时（组件重渲染重建滚动器）从当前位置继续，
+  // 避免图例点选、坐标轴重算等触发的重渲染把已滚动位置重置回初始窗口
+  var currentZoom = (_chart$getOption = chart.getOption()) === null || _chart$getOption === void 0 || (_chart$getOption = _chart$getOption.dataZoom) === null || _chart$getOption === void 0 ? void 0 : _chart$getOption[0];
+  if (typeof (currentZoom === null || currentZoom === void 0 ? void 0 : currentZoom.start) === "number" && typeof (currentZoom === null || currentZoom === void 0 ? void 0 : currentZoom.end) === "number") {
+    start = currentZoom.start;
+    end = currentZoom.end;
+  }
   var syncDataZoomRange = function syncDataZoomRange() {
     var option = chart.getOption();
     var currentDataZoom = option === null || option === void 0 ? void 0 : option.dataZoom;
@@ -44,6 +53,7 @@ export function autoScrollByItem(props) {
         });
       })
     });
+    onWindowChange === null || onWindowChange === void 0 || onWindowChange(start, end);
   };
   syncDataZoomRange();
   var timer = null;

package/es/components/Chart/_utils/cartesian.d.ts

@@ -18,6 +18,17 @@ export interface NormalizedScrollConfig {
     sliderVisible?: boolean;
     wheelModeWhenSliderHidden: "scroll" | "none";
 }
+/** dataZoom 当前可见窗口对应的 x 轴索引区间（闭区间） */
+export interface DataZoomIndexWindow {
+    startIndex: number;
+    endIndex: number;
+}
+/**
+ * 把 dataZoom 的 start/end 百分比换算为 x 轴索引窗口。
+ * 与本组件族写入 dataZoom 的百分比约定一致（index / total * 100），
+ * 对 echarts 原生交互产生的百分比做外扩取整，边界最多多含一项，不影响坐标轴量级。
+ */
+export declare const percentWindowToIndexWindow: (startPercent: number, endPercent: number, total: number) => DataZoomIndexWindow;
 export declare const createDefaultCategoryXAxis: (xAxisData?: Array<string>) => ChartOptionType;
 export declare const createDefaultValueYAxis: (mode?: "bar" | "line") => ChartOptionType;
 export declare const buildCartesianSeriesOptions: (mode: "bar" | "line", seriesData?: SeriesDataType, series?: echarts.SeriesOption | echarts.SeriesOption[]) => echarts.SeriesOption[];

package/es/components/Chart/_utils/cartesian.js

@@ -4,6 +4,25 @@ function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key i
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
 function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+/** dataZoom 当前可见窗口对应的 x 轴索引区间（闭区间） */
+
+/**
+ * 把 dataZoom 的 start/end 百分比换算为 x 轴索引窗口。
+ * 与本组件族写入 dataZoom 的百分比约定一致（index / total * 100），
+ * 对 echarts 原生交互产生的百分比做外扩取整，边界最多多含一项，不影响坐标轴量级。
+ */
+export var percentWindowToIndexWindow = function percentWindowToIndexWindow(startPercent, endPercent, total) {
+  if (total <= 0) return {
+    startIndex: 0,
+    endIndex: 0
+  };
+  var startIndex = Math.max(0, Math.min(total - 1, Math.floor(startPercent / 100 * total)));
+  var endIndex = Math.max(startIndex, Math.min(total - 1, Math.ceil(endPercent / 100 * total) - 1));
+  return {
+    startIndex: startIndex,
+    endIndex: endIndex
+  };
+};
 export var createDefaultCategoryXAxis = function createDefaultCategoryXAxis(xAxisData) {
   return {
     type: "category",

package/es/components/Chart/chartUtils/chartTooltipFormatter.d.ts

@@ -18,6 +18,8 @@ export interface ChartTooltipFormatterProps {
     hideMarker?: boolean;
     textStyle?: Record<string, unknown>;
     unit?: string;
+    /** 多系列时按数值从大到小排序展示（大的在上） */
+    sortDescending?: boolean;
 }
 declare const chartTooltipFormatter: (props: ChartTooltipFormatterProps) => string;
 export default chartTooltipFormatter;

package/es/components/Chart/chartUtils/chartTooltipFormatter.js

@@ -1,3 +1,9 @@
+function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
 var chartTooltipFormatter = function chartTooltipFormatter(props) {
   var _params$;
   var params = props.params,
@@ -9,7 +15,8 @@ var chartTooltipFormatter = function chartTooltipFormatter(props) {
       color: "#666",
       fontWeight: 400
     } : _props$textStyle,
-    unit = props.unit;
+    unit = props.unit,
+    sortDescending = props.sortDescending;
   if (!Array.isArray(params)) {
     return "\n      <div style=\"margin: 0;line-height:1;\">\n        <div style=\"margin: 0;line-height:1;\">\n          ".concat(hideMarker ? "" : "".concat(params === null || params === void 0 ? void 0 : params.marker), "\n          <span style=\"font-size:").concat(textStyle === null || textStyle === void 0 ? void 0 : textStyle.fontSize, "px;color:").concat(textStyle === null || textStyle === void 0 ? void 0 : textStyle.color, ";font-weight:").concat(textStyle === null || textStyle === void 0 ? void 0 : textStyle.fontWeight, ";margin-left:2px\">").concat(params === null || params === void 0 ? void 0 : params.name, "</span>\n          <span style=\"float:right;margin-left:20px;font-size:").concat(textStyle === null || textStyle === void 0 ? void 0 : textStyle.fontSize, "px;color:").concat(textStyle === null || textStyle === void 0 ? void 0 : textStyle.color, ";font-weight:").concat(textStyle === null || textStyle === void 0 ? void 0 : textStyle.fontWeight, "\">").concat(params === null || params === void 0 ? void 0 : params.value).concat(unit ? " " + unit : "", "</span>\n          <div style=\"clear:both\"></div>\n        </div>\n        <div style=\"clear:both\"></div>\n      </div>\n    ");
   }
@@ -17,10 +24,13 @@ var chartTooltipFormatter = function chartTooltipFormatter(props) {
     var item = params[0];
     return "\n      <div style=\"margin: 0;line-height:1;\">\n        <div style=\"margin: 0;line-height:1;\">\n          ".concat(hideMarker ? "" : "".concat(item === null || item === void 0 ? void 0 : item.marker), "\n          <span style=\"font-size:").concat(textStyle === null || textStyle === void 0 ? void 0 : textStyle.fontSize, "px;color:").concat(textStyle === null || textStyle === void 0 ? void 0 : textStyle.color, ";font-weight:").concat(textStyle === null || textStyle === void 0 ? void 0 : textStyle.fontWeight, ";margin-left:2px\">").concat(item === null || item === void 0 ? void 0 : item.name, "</span>\n          <span style=\"float:right;margin-left:20px;font-size:").concat(textStyle === null || textStyle === void 0 ? void 0 : textStyle.fontSize, "px;color:").concat(textStyle === null || textStyle === void 0 ? void 0 : textStyle.color, ";font-weight:").concat(textStyle === null || textStyle === void 0 ? void 0 : textStyle.fontWeight, "\">").concat(item === null || item === void 0 ? void 0 : item.value).concat(unit ? " ".concat(unit) : "", "</span>\n          <div style=\"clear:both\"></div>\n        </div>\n        <div style=\"clear:both\"></div>\n      </div>\n    ");
   }
-  var items = params === null || params === void 0 ? void 0 : params.map(function (item, idx) {
+  var sortedParams = sortDescending ? _toConsumableArray(params).sort(function (a, b) {
+    return (Number(b.value) || 0) - (Number(a.value) || 0);
+  }) : params;
+  var items = sortedParams === null || sortedParams === void 0 ? void 0 : sortedParams.map(function (item, idx) {
     var _item$value;
     var value = (_item$value = item.value) !== null && _item$value !== void 0 ? _item$value : "";
-    return "\n      <div style=\"margin: 0 0 ".concat(idx === params.length - 1 ? "0" : "10px", " 0;line-height:1;\">\n        <div style=\"margin: 0px 0 0;line-height:1;\">\n          ").concat(hideMarker ? "" : "".concat(item === null || item === void 0 ? void 0 : item.marker), "\n          <span style=\"font-size:").concat(textStyle === null || textStyle === void 0 ? void 0 : textStyle.fontSize, "px;color:").concat(textStyle === null || textStyle === void 0 ? void 0 : textStyle.color, ";font-weight:").concat(textStyle === null || textStyle === void 0 ? void 0 : textStyle.fontWeight, ";margin-left:2px\">").concat(item === null || item === void 0 ? void 0 : item.seriesName, "</span>\n          <span style=\"float:right;margin-left:20px;font-size:").concat(textStyle === null || textStyle === void 0 ? void 0 : textStyle.fontSize, "px;color:").concat(textStyle === null || textStyle === void 0 ? void 0 : textStyle.color, ";font-weight:").concat(textStyle === null || textStyle === void 0 ? void 0 : textStyle.fontWeight, "\">").concat(value).concat(unit ? " ".concat(unit) : "", "</span>\n          <div style=\"clear:both\"></div>\n        </div>\n        <div style=\"clear:both\"></div>\n      </div>\n    ");
+    return "\n      <div style=\"margin: 0 0 ".concat(idx === sortedParams.length - 1 ? "0" : "10px", " 0;line-height:1;\">\n        <div style=\"margin: 0px 0 0;line-height:1;\">\n          ").concat(hideMarker ? "" : "".concat(item === null || item === void 0 ? void 0 : item.marker), "\n          <span style=\"font-size:").concat(textStyle === null || textStyle === void 0 ? void 0 : textStyle.fontSize, "px;color:").concat(textStyle === null || textStyle === void 0 ? void 0 : textStyle.color, ";font-weight:").concat(textStyle === null || textStyle === void 0 ? void 0 : textStyle.fontWeight, ";margin-left:2px\">").concat(item === null || item === void 0 ? void 0 : item.seriesName, "</span>\n          <span style=\"float:right;margin-left:20px;font-size:").concat(textStyle === null || textStyle === void 0 ? void 0 : textStyle.fontSize, "px;color:").concat(textStyle === null || textStyle === void 0 ? void 0 : textStyle.color, ";font-weight:").concat(textStyle === null || textStyle === void 0 ? void 0 : textStyle.fontWeight, "\">").concat(value).concat(unit ? " ".concat(unit) : "", "</span>\n          <div style=\"clear:both\"></div>\n        </div>\n        <div style=\"clear:both\"></div>\n      </div>\n    ");
   }).join("");
   return "\n    <div style=\"margin: 0px 0 0;line-height:1;\">\n      <div style=\"margin: 0px 0 0;line-height:1;\">\n        ".concat(hideName ? "" : "<div style=\"margin-bottom: 10px;font-size:".concat(textStyle === null || textStyle === void 0 ? void 0 : textStyle.fontSize, "px;color:").concat(textStyle === null || textStyle === void 0 ? void 0 : textStyle.color, ";font-weight:").concat(textStyle === null || textStyle === void 0 ? void 0 : textStyle.fontWeight, ";line-height:1;\">").concat(((_params$ = params[0]) === null || _params$ === void 0 ? void 0 : _params$.name) || "", "</div>"), "\n        ").concat(items, "\n        <div style=\"clear:both\"></div>\n      </div>\n      <div style=\"clear:both\"></div>\n    </div>\n  ");
 };

package/es/components/Chart/chartUtils/index.d.ts

@@ -2,6 +2,9 @@ import chartTooltipFormatter from "./chartTooltipFormatter";
 import { TooltipParams, ChartTooltipFormatterProps } from "./chartTooltipFormatter";
 import { autoScrollLegend, AutoScrollLegendProps } from "../_utils/autoScrollLegend";
 import { calculateAxisConfig } from "./calculateAxisConfig";
+import { useLegendSelection, LegendSelectionResult } from "./useLegendSelection";
+import { useDataZoomWindow, DataZoomWindowOptions, DataZoomWindowResult } from "./useDataZoomWindow";
+import { DataZoomIndexWindow } from "../_utils/cartesian";
 import { MB_PER_GB, MB_PER_TB, trimAxisNumber, chineseMagnitudeDivisor, formatChineseMagnitudeTick, mbDisplayTier, formatMbAxisTick } from "./yAxisDisplayUnit";
-export { chartTooltipFormatter, autoScrollLegend, calculateAxisConfig, MB_PER_GB, MB_PER_TB, trimAxisNumber, chineseMagnitudeDivisor, formatChineseMagnitudeTick, mbDisplayTier, formatMbAxisTick, };
-export type { TooltipParams, ChartTooltipFormatterProps, AutoScrollLegendProps, };
+export { chartTooltipFormatter, autoScrollLegend, calculateAxisConfig, useLegendSelection, useDataZoomWindow, MB_PER_GB, MB_PER_TB, trimAxisNumber, chineseMagnitudeDivisor, formatChineseMagnitudeTick, mbDisplayTier, formatMbAxisTick, };
+export type { TooltipParams, ChartTooltipFormatterProps, AutoScrollLegendProps, LegendSelectionResult, DataZoomWindowOptions, DataZoomWindowResult, DataZoomIndexWindow, };

package/es/components/Chart/chartUtils/index.js

@@ -1,5 +1,7 @@
 import chartTooltipFormatter from "./chartTooltipFormatter";
 import { autoScrollLegend } from "../_utils/autoScrollLegend";
 import { calculateAxisConfig } from "./calculateAxisConfig";
+import { useLegendSelection } from "./useLegendSelection";
+import { useDataZoomWindow } from "./useDataZoomWindow";
 import { MB_PER_GB, MB_PER_TB, trimAxisNumber, chineseMagnitudeDivisor, formatChineseMagnitudeTick, mbDisplayTier, formatMbAxisTick } from "./yAxisDisplayUnit";
-export { chartTooltipFormatter, autoScrollLegend, calculateAxisConfig, MB_PER_GB, MB_PER_TB, trimAxisNumber, chineseMagnitudeDivisor, formatChineseMagnitudeTick, mbDisplayTier, formatMbAxisTick };
+export { chartTooltipFormatter, autoScrollLegend, calculateAxisConfig, useLegendSelection, useDataZoomWindow, MB_PER_GB, MB_PER_TB, trimAxisNumber, chineseMagnitudeDivisor, formatChineseMagnitudeTick, mbDisplayTier, formatMbAxisTick };

package/es/components/Chart/chartUtils/useDataZoomWindow.d.ts

@@ -0,0 +1,19 @@
+import { DataZoomIndexWindow } from "../_utils/cartesian";
+export interface DataZoomWindowOptions {
+    /** 开关：是否按 dataZoom 当前可见窗口重算坐标轴，默认开启 */
+    enabled?: boolean;
+}
+export interface DataZoomWindowResult {
+    /** 当前可见窗口；开关关闭或尚未收到回调时为 null（表示全量） */
+    zoomWindow: DataZoomIndexWindow | null;
+    /** 传给 Chart.Bar / Chart.Line 的 onDataZoomWindowChanged；开关关闭时为 undefined（不绑定事件） */
+    onDataZoomWindowChanged?: (window: DataZoomIndexWindow) => void;
+    /** 按当前可见窗口裁剪系列数据，配合 calculateAxisConfig 只对展示部分重算坐标轴 */
+    sliceByZoomWindow: <T>(values?: T[] | null) => T[];
+}
+/**
+ * dataZoom 可见窗口管理：配合 Chart.Bar / Chart.Line 的 onDataZoomWindowChanged，
+ * 在调用方按"当前可见窗口"裁剪数据后重算 Y 轴 min/max/interval（calculateAxisConfig），
+ * 实现滑块拖动/滚轮/自动滚动时坐标轴跟随展示部分动态重算；可与 useLegendSelection 叠加。
+ */
+export declare function useDataZoomWindow(options?: DataZoomWindowOptions): DataZoomWindowResult;

package/es/components/Chart/chartUtils/useDataZoomWindow.js

@@ -0,0 +1,37 @@
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+import { useCallback, useState } from "react";
+/**
+ * dataZoom 可见窗口管理：配合 Chart.Bar / Chart.Line 的 onDataZoomWindowChanged，
+ * 在调用方按"当前可见窗口"裁剪数据后重算 Y 轴 min/max/interval（calculateAxisConfig），
+ * 实现滑块拖动/滚轮/自动滚动时坐标轴跟随展示部分动态重算；可与 useLegendSelection 叠加。
+ */
+export function useDataZoomWindow(options) {
+  var _options$enabled;
+  var enabled = (_options$enabled = options === null || options === void 0 ? void 0 : options.enabled) !== null && _options$enabled !== void 0 ? _options$enabled : true;
+  var _useState = useState(null),
+    _useState2 = _slicedToArray(_useState, 2),
+    zoomWindow = _useState2[0],
+    setZoomWindow = _useState2[1];
+  var onDataZoomWindowChanged = useCallback(function (next) {
+    // 窗口未变化时保持原引用，避免重渲染 → 同步回调 → 再重渲染的循环
+    setZoomWindow(function (prev) {
+      return prev && prev.startIndex === next.startIndex && prev.endIndex === next.endIndex ? prev : next;
+    });
+  }, []);
+  var effectiveWindow = enabled ? zoomWindow : null;
+  var sliceByZoomWindow = useCallback(function (values) {
+    if (!values) return [];
+    if (!effectiveWindow) return values;
+    return values.slice(effectiveWindow.startIndex, effectiveWindow.endIndex + 1);
+  }, [effectiveWindow]);
+  return {
+    zoomWindow: effectiveWindow,
+    onDataZoomWindowChanged: enabled ? onDataZoomWindowChanged : undefined,
+    sliceByZoomWindow: sliceByZoomWindow
+  };
+}

package/es/components/Chart/chartUtils/useLegendSelection.d.ts

@@ -0,0 +1,14 @@
+export interface LegendSelectionResult {
+    /** 传给图表 legend.selected，保证重渲染(setOption notMerge)后隐藏状态不丢 */
+    legendSelected: Record<string, boolean>;
+    /** 传给图表 onLegendSelectChanged */
+    onLegendSelectChanged: (selected: Record<string, boolean>) => void;
+    /** 判断某系列当前是否可见（未点过的系列默认可见） */
+    isSeriesVisible: (name?: string | null) => boolean;
+}
+/**
+ * 图例选中状态管理：配合 Chart.Bar / Chart.Line 的 onLegendSelectChanged，
+ * 在调用方按"当前可见系列"重算 Y 轴 min/max/interval（calculateAxisConfig），
+ * 实现图例隐藏某一项后坐标轴自动重算。
+ */
+export declare function useLegendSelection(): LegendSelectionResult;