@hsu-react/ui 0.0.12 → 0.0.14

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

@@ -52,58 +52,58 @@ var ChartPie = function ChartPie(props) {
   var resizeObserverRef = useRef(null);
   var legendScrollRef = useRef(null);
 
-  // 根据 position 计算默认 radius（如果未指定）
+  // Compute the default radius based on position (when not specified)
   var calculatedRadius = useMemo(function () {
     if (radius) {
       return radius;
     }
 
-    // 对于半圆，需要更大的 radius 值才能占满容器
-    // 因为半圆只占 180 度，所以外半径需要更大才能覆盖整个容器的高度或宽度
+    // A semicircle needs a larger radius to fill the container,
+    // because it spans only 180 degrees, so the outer radius must be larger to cover the container's full height or width
     if (isSemiCircle) {
       return ["0%", "200%"];
     }
-    // 全圆
+    // Full circle
     return ["45%", "70%"];
   }, [radius, isSemiCircle]);
 
-  // 计算角度和中心位置
+  // Compute angles and center position
   var _useMemo = useMemo(function () {
-      // 根据 position 计算默认 center（如果未指定）
+      // Compute the default center based on position (when not specified)
       var calculatedCenter = center || ["30%", "50%"];
       var startAngle = 90;
-      var endAngle = 450; // 360 + 90，从顶部开始
+      var endAngle = 450; // 360 + 90, starting from the top
       var actualSpanAngle = isSemiCircle ? spanAngle : 360;
       if (isSemiCircle) {
-        // 根据 position 计算角度和中心位置
+        // Compute angles and center position based on position
         switch (position) {
           case "top":
-            // 上半圆
+            // Top semicircle
             startAngle = 180;
             endAngle = 0;
             calculatedCenter = center || ["center", "0%"];
             break;
           case "bottom":
-            // 下半圆
+            // Bottom semicircle
             startAngle = 0;
             endAngle = 180;
             calculatedCenter = center || ["center", "100%"];
             break;
           case "left":
-            // 左半圆
+            // Left semicircle
             startAngle = 90;
             endAngle = 270;
             calculatedCenter = center || ["0%", "center"];
             break;
           case "right":
-            // 右半圆
+            // Right semicircle
             startAngle = 270;
             endAngle = 90;
             calculatedCenter = center || ["100%", "center"];
             break;
         }
       } else {
-        // 全圆
+        // Full circle
         calculatedCenter = center || ["30%", "50%"];
       }
       return {
@@ -118,7 +118,7 @@ var ChartPie = function ChartPie(props) {
     endAngle = _useMemo.endAngle,
     actualSpanAngle = _useMemo.actualSpanAngle;
 
-  // 处理数据：如果是半圆，需要填充空白数据
+  // Process the data: a semicircle needs blank data padding
   var processedSeriesData = useMemo(function () {
     if (!seriesData || !isSemiCircle) {
       return seriesData;
@@ -127,7 +127,7 @@ var ChartPie = function ChartPie(props) {
     var repeatedMultiple = 360 / actualSpanAngle;
     var addDataLen = parseInt(String((repeatedMultiple - 1) * originDataLen));
 
-    // 填充空白数据以形成半圆
+    // Pad with blank data to form the semicircle
     var emptyData = Array.from({
       length: addDataLen
     }, function () {
@@ -144,9 +144,9 @@ var ChartPie = function ChartPie(props) {
     return [].concat(_toConsumableArray(seriesData), emptyData);
   }, [seriesData, isSemiCircle, actualSpanAngle]);
 
-  // 使用 useMemo 缓存 chart 配置
+  // Cache the chart option with useMemo
   var chartOption = useMemo(function () {
-    // 当启用自动滚动时，隐藏分页按钮并设置为滚动类型
+    // When auto-scroll is enabled, hide the paging buttons and use the scroll type
     var baseLegendConfig = _objectSpread({
       orient: "vertical",
       top: "middle",
@@ -158,9 +158,9 @@ var ChartPie = function ChartPie(props) {
       }
     }, legend);
     var legendConfig = enableLegendAutoScroll ? _objectSpread(_objectSpread({}, baseLegendConfig), {}, {
-      // 设置为滚动类型
+      // Use the scroll type
       type: "scroll",
-      // 隐藏分页按钮的配置
+      // Config to hide the paging buttons
       pageIconSize: 0,
       pageIconColor: "transparent",
       pageIconInactiveColor: "transparent",
@@ -195,46 +195,46 @@ var ChartPie = function ChartPie(props) {
     return option;
   }, [chartTitle, title, legend, tooltip, processedSeriesData, series, extendSeries, coreOption, enableLegendAutoScroll, calculatedCenter, calculatedRadius, startAngle, endAngle]);
 
-  // 处理图表 resize 的回调
+  // Callback for handling chart resize
   var handleResize = useCallback(function () {
     var _chartInstanceRef$cur;
     (_chartInstanceRef$cur = chartInstanceRef.current) === null || _chartInstanceRef$cur === void 0 || _chartInstanceRef$cur.resize();
   }, []);
 
-  // 初始化图表
+  // Initialize the chart
   useEffect(function () {
     if (!chartRef.current) return;
 
-    // 初始化或获取已存在的实例
+    // Initialize or reuse the existing instance
     var chart = chartInstanceRef.current;
     if (!chart) {
       chart = echarts.init(chartRef.current);
       chartInstanceRef.current = chart;
-      // 首次初始化时调用 onChart 回调
+      // Call the onChart callback on first initialization
       onChart === null || onChart === void 0 || onChart(chart);
     }
 
-    // 设置配置
+    // Apply the option
     chart.setOption(chartOption, true);
 
-    // 添加 resize 监听
+    // Add resize listener
     window.addEventListener("resize", handleResize);
 
-    // 添加 ResizeObserver
+    // Add ResizeObserver
     if (chartRef.current && !resizeObserverRef.current) {
       resizeObserverRef.current = new ResizeObserver(handleResize);
       resizeObserverRef.current.observe(chartRef.current);
     }
 
-    // 添加点击事件
+    // Add click event
     if (onClick) {
       var _chartInstanceRef$cur2;
       (_chartInstanceRef$cur2 = chartInstanceRef.current) === null || _chartInstanceRef$cur2 === void 0 || _chartInstanceRef$cur2.on("click", onClick);
     }
 
-    // 图例自动滚动
+    // Legend auto-scroll
     if (enableLegendAutoScroll && seriesData && seriesData.length > 0) {
-      // 清理之前的滚动实例
+      // Dispose the previous scroll instance
       if (legendScrollRef.current) {
         legendScrollRef.current.dispose();
       }
@@ -247,7 +247,7 @@ var ChartPie = function ChartPie(props) {
       });
     }
 
-    // 清理函数
+    // Cleanup function
     return function () {
       window.removeEventListener("resize", handleResize);
       if (onClick) {
@@ -255,7 +255,7 @@ var ChartPie = function ChartPie(props) {
         (_chartInstanceRef$cur3 = chartInstanceRef.current) === null || _chartInstanceRef$cur3 === void 0 || _chartInstanceRef$cur3.off("click", onClick);
       }
 
-      // 清理图例滚动
+      // Clean up legend scrolling
       if (legendScrollRef.current) {
         legendScrollRef.current.dispose();
         legendScrollRef.current = null;
@@ -263,15 +263,15 @@ var ChartPie = function ChartPie(props) {
     };
   }, [chartOption, handleResize, onChart, onClick, enableLegendAutoScroll, seriesData, legendVisibleCount, legendScrollInterval]);
 
-  // 组件卸载时清理资源
+  // Clean up resources when the component unmounts
   useEffect(function () {
     return function () {
-      // 清理 ResizeObserver
+      // Clean up ResizeObserver
       if (resizeObserverRef.current) {
         resizeObserverRef.current.disconnect();
         resizeObserverRef.current = null;
       }
-      // 销毁图表实例
+      // Dispose the chart instance
       if (chartInstanceRef.current) {
         chartInstanceRef.current.dispose();
         chartInstanceRef.current = null;

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

@@ -31,7 +31,7 @@ var Polar = function Polar(props) {
   var chartInstanceRef = useRef(null);
   var resizeObserverRef = useRef(null);
 
-  // 使用 useMemo 缓存 chart 配置
+  // Cache the chart option with useMemo
   var chartOption = useMemo(function () {
     var option = _objectSpread({
       title: [{
@@ -132,50 +132,50 @@ var Polar = function Polar(props) {
     return option;
   }, [textStyle, title1Style, title1, title2Style, title2, polar, radiusAxis, angleAxis, seriesData, color, series, coreOption]);
 
-  // 处理图表 resize 的回调
+  // Callback handling chart resize
   var handleResize = useCallback(function () {
     var _chartInstanceRef$cur;
     (_chartInstanceRef$cur = chartInstanceRef.current) === null || _chartInstanceRef$cur === void 0 || _chartInstanceRef$cur.resize();
   }, []);
 
-  // 初始化图表
+  // Initialize the chart
   useEffect(function () {
     if (!chartRef.current) return;
 
-    // 初始化或获取已存在的实例
+    // Initialize a new instance or reuse the existing one
     var chart = chartInstanceRef.current;
     if (!chart) {
       chart = echarts.init(chartRef.current);
       chartInstanceRef.current = chart;
     }
 
-    // 设置配置
+    // Apply the option
     chart.setOption(chartOption, true);
 
-    // 添加 resize 监听
+    // Add resize listener
     window.addEventListener("resize", handleResize);
 
-    // 添加 ResizeObserver
+    // Add ResizeObserver
     if (chartRef.current && !resizeObserverRef.current) {
       resizeObserverRef.current = new ResizeObserver(handleResize);
       resizeObserverRef.current.observe(chartRef.current);
     }
 
-    // 清理函数
+    // Cleanup function
     return function () {
       window.removeEventListener("resize", handleResize);
     };
   }, [chartOption, handleResize]);
 
-  // 组件卸载时清理资源
+  // Clean up resources on unmount
   useEffect(function () {
     return function () {
-      // 清理 ResizeObserver
+      // Clean up the ResizeObserver
       if (resizeObserverRef.current) {
         resizeObserverRef.current.disconnect();
         resizeObserverRef.current = null;
       }
-      // 销毁图表实例
+      // Dispose the chart instance
       if (chartInstanceRef.current) {
         chartInstanceRef.current.dispose();
         chartInstanceRef.current = null;

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

@@ -4,9 +4,9 @@ export interface RadarIndicator {
     name: string;
     max?: number;
 }
-/** 单指标 tooltip 触发方式
- * - `point`  仅悬停在数据点/线上触发（echarts 原生 item trigger）
- * - `region` 进入该指标的扇形区域即触发，并在命中扇形区内填充高亮色
+/** Single-indicator tooltip trigger mode
+ * - `point`  triggers only when hovering data points/lines (native echarts item trigger)
+ * - `region` triggers as soon as the pointer enters the indicator's sector, filling the hit sector with a highlight color
  */
 export type SingleIndicatorMode = "point" | "region";
 export interface ChartRadarProps extends ChartCommonProps {
@@ -15,14 +15,14 @@ export interface ChartRadarProps extends ChartCommonProps {
     color?: string;
     name?: string;
     /**
-     * 单指标 tooltip：
-     * - `true` 使用内置简单格式（`系列名 · 指标名：值`）
-     * - 传函数则接收当前最近指标下标与原始 echarts params，自行返回 HTML
+     * Single-indicator tooltip:
+     * - `true` uses the built-in simple format (`seriesName · indicatorName: value`)
+     * - a function receives the nearest indicator index and the raw echarts params, and returns HTML itself
      */
     singleIndicatorTooltip?: boolean | ((indicatorIndex: number, params: unknown, indicator: RadarIndicator) => string);
-    /** 单指标触发方式；**不设置则完全走 echarts 原生全指标 tooltip**，忽略 `singleIndicatorTooltip` */
+    /** Single-indicator trigger mode; **when unset, the native echarts all-indicator tooltip is used** and `singleIndicatorTooltip` is ignored */
     singleIndicatorMode?: SingleIndicatorMode;
-    /** `region` 模式下的高亮色；不传则使用 `color` 以 0.12 透明度渲染 */
+    /** Highlight color in `region` mode; defaults to `color` rendered at 0.12 opacity */
     singleIndicatorHoverFill?: string;
 }
 declare const Radar: React.FC<ChartRadarProps>;

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

@@ -17,9 +17,9 @@ import * as echarts from "echarts";
 import React, { useCallback, useEffect, useMemo, useRef } from "react";
 import styles from "../index.module.scss";
 
-/** 单指标 tooltip 触发方式
- * - `point`  仅悬停在数据点/线上触发（echarts 原生 item trigger）
- * - `region` 进入该指标的扇形区域即触发，并在命中扇形区内填充高亮色
+/** Single-indicator tooltip trigger mode
+ * - `point`  triggers only when hovering data points/lines (native echarts item trigger)
+ * - `region` triggers as soon as the pointer enters the indicator's sector, filling the hit sector with a highlight color
  */
 import { jsx as _jsx } from "react/jsx-runtime";
 var Radar = function Radar(props) {
@@ -52,7 +52,7 @@ var Radar = function Radar(props) {
     var overrideData = seriesOverride === null || seriesOverride === void 0 ? void 0 : seriesOverride.data;
     var extraData = Array.isArray(overrideData) ? overrideData : [];
 
-    // 将每个 extraData item 拆为独立 series，使图例可以分别控制显隐
+    // Split each extraData item into its own series so the legend can toggle them individually
     var extraSeries = extraData.map(function (item) {
       var _d$name;
       var d = item;
@@ -214,7 +214,7 @@ var Radar = function Radar(props) {
           return;
         }
         var axes = coord.getIndicatorAxes();
-        // echarts 雷达轴角度按数学约定（y 向上），而屏幕坐标 y 向下，需翻转 y
+        // echarts radar axis angles follow the math convention (y up) while screen coordinates have y down, so flip y
         var mouseAngle = Math.atan2(-dy, dx);
         var bestI = -1;
         var bestDA = Infinity;
@@ -228,8 +228,8 @@ var Radar = function Radar(props) {
         });
         hoveredIndicatorRef.current = bestI;
         if (hoverShape && bestI >= 0) {
-          // 以与雷达多边形一致的边界构造扇形区：
-          // 中心 → 与上一轴顶边的中点 → 当前轴顶 → 与下一轴顶边的中点
+          // Build the sector with boundaries matching the radar polygon:
+          // center → midpoint of the edge to the previous axis tip → current axis tip → midpoint of the edge to the next axis tip
           var n = axes.length;
           var tipOf = function tipOf(idx) {
             var a = axes[idx].angle;

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

@@ -25,7 +25,7 @@ var Sankey = function Sankey(props) {
   var chartInstanceRef = useRef(null);
   var resizeObserverRef = useRef(null);
 
-  // 使用 useMemo 缓存 chart 配置
+  // Cache the chart option with useMemo
   var chartOption = useMemo(function () {
     var option = {
       series: _objectSpread({
@@ -100,23 +100,23 @@ var Sankey = function Sankey(props) {
     return option;
   }, [seriesData, seriesLinks, series]);
 
-  // 处理图表 resize 的回调
+  // Callback handling chart resize
   var handleResize = useCallback(function () {
     var _chartInstanceRef$cur;
     (_chartInstanceRef$cur = chartInstanceRef.current) === null || _chartInstanceRef$cur === void 0 || _chartInstanceRef$cur.resize();
   }, []);
 
-  // 初始化图表
+  // Initialize the chart
   useEffect(function () {
     if (!chartRef.current) return;
 
-    // 初始化或获取已存在的实例
+    // Initialize a new instance or reuse the existing one
     var chart = chartInstanceRef.current;
     if (!chart) {
       chart = echarts.init(chartRef.current);
       chartInstanceRef.current = chart;
 
-      // 首次初始化时添加 finished 事件监听
+      // Attach the finished event listener on first initialization
       chart.on("finished", function () {
         getImage === null || getImage === void 0 || getImage(chart.getDataURL({
           type: "png",
@@ -126,33 +126,33 @@ var Sankey = function Sankey(props) {
       });
     }
 
-    // 设置配置
+    // Apply the option
     chart.setOption(chartOption, true);
 
-    // 添加 resize 监听
+    // Add resize listener
     window.addEventListener("resize", handleResize);
 
-    // 添加 ResizeObserver
+    // Add ResizeObserver
     if (chartRef.current && !resizeObserverRef.current) {
       resizeObserverRef.current = new ResizeObserver(handleResize);
       resizeObserverRef.current.observe(chartRef.current);
     }
 
-    // 清理函数
+    // Cleanup function
     return function () {
       window.removeEventListener("resize", handleResize);
     };
   }, [chartOption, handleResize, getImage]);
 
-  // 组件卸载时清理资源
+  // Clean up resources on unmount
   useEffect(function () {
     return function () {
-      // 清理 ResizeObserver
+      // Clean up the ResizeObserver
       if (resizeObserverRef.current) {
         resizeObserverRef.current.disconnect();
         resizeObserverRef.current = null;
       }
-      // 销毁图表实例
+      // Dispose the chart instance
       if (chartInstanceRef.current) {
         chartInstanceRef.current.off("finished");
         chartInstanceRef.current.dispose();

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

@@ -20,7 +20,7 @@ var Tree = function Tree(props) {
   var chartInstanceRef = useRef(null);
   var resizeObserverRef = useRef(null);
 
-  // 使用 useMemo 缓存 chart 配置
+  // Cache the chart option with useMemo
   var chartOption = useMemo(function () {
     var option = {
       series: _objectSpread({
@@ -35,23 +35,23 @@ var Tree = function Tree(props) {
     return option;
   }, [seriesData, series]);
 
-  // 处理图表 resize 的回调
+  // Callback handling chart resize
   var handleResize = useCallback(function () {
     var _chartInstanceRef$cur;
     (_chartInstanceRef$cur = chartInstanceRef.current) === null || _chartInstanceRef$cur === void 0 || _chartInstanceRef$cur.resize();
   }, []);
 
-  // 初始化图表
+  // Initialize the chart
   useEffect(function () {
     if (!chartRef.current) return;
 
-    // 初始化或获取已存在的实例
+    // Initialize a new instance or reuse the existing one
     var chart = chartInstanceRef.current;
     if (!chart) {
       chart = echarts.init(chartRef.current);
       chartInstanceRef.current = chart;
 
-      // 首次初始化时添加 finished 事件监听
+      // Attach the finished event listener on first initialization
       chart.on("finished", function () {
         getImage === null || getImage === void 0 || getImage(chart.getDataURL({
           type: "png",
@@ -61,33 +61,33 @@ var Tree = function Tree(props) {
       });
     }
 
-    // 设置配置
+    // Apply the option
     chart.setOption(chartOption, true);
 
-    // 添加 resize 监听
+    // Add resize listener
     window.addEventListener("resize", handleResize);
 
-    // 添加 ResizeObserver
+    // Add ResizeObserver
     if (chartRef.current && !resizeObserverRef.current) {
       resizeObserverRef.current = new ResizeObserver(handleResize);
       resizeObserverRef.current.observe(chartRef.current);
     }
 
-    // 清理函数
+    // Cleanup function
     return function () {
       window.removeEventListener("resize", handleResize);
     };
   }, [chartOption, handleResize, getImage]);
 
-  // 组件卸载时清理资源
+  // Clean up resources on unmount
   useEffect(function () {
     return function () {
-      // 清理 ResizeObserver
+      // Clean up the ResizeObserver
       if (resizeObserverRef.current) {
         resizeObserverRef.current.disconnect();
         resizeObserverRef.current = null;
       }
-      // 销毁图表实例
+      // Dispose the chart instance
       if (chartInstanceRef.current) {
         chartInstanceRef.current.off("finished");
         chartInstanceRef.current.dispose();

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

@@ -7,7 +7,7 @@ export interface AutoScrollByItemProps {
     startIndex?: number;
     autoPlay?: boolean;
     enableWheelScroll?: boolean;
-    /** 窗口变化回调（创建同步、自动滚动、滚轮、resize 均触发），参数为当前窗口 start/end 百分比 */
+    /** Window change callback (fired on creation sync, auto-scroll, wheel, and resize), receives the current window start/end percentages */
     onWindowChange?: (startPercent: number, endPercent: number) => void;
 }
 export declare function autoScrollByItem(props: AutoScrollByItemProps): {

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

@@ -34,8 +34,8 @@ export function autoScrollByItem(props) {
   var start = initialStartPercent;
   var end = Math.min(initialStartPercent + windowSizePercent, 100);
 
-  // 图表已有 dataZoom 窗口时（组件重渲染重建滚动器）从当前位置继续，
-  // 避免图例点选、坐标轴重算等触发的重渲染把已滚动位置重置回初始窗口
+  // If the chart already has a dataZoom window (scroller rebuilt on component re-render), continue from the current position
+  // to prevent re-renders triggered by legend toggling, axis recalculation, etc. from resetting the scrolled position back to the initial window
   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;

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

@@ -71,10 +71,10 @@ export function drawCircles(radiusList, maxX, maxY) {
   var MIN_GAP = Math.max(1.5, avgRadius * 0.08);
   var GOLDEN_ANGLE = Math.PI * (3 - Math.sqrt(5));
 
-  // 按容器长宽比例将同心圆扩展为同心椭圆（面积守恒：aspectX * aspectY = 1）：
-  // - 容器正方形时 aspectX = aspectY = 1（标准圆形环）
-  // - 容器越扁平，长边方向被适度拉伸、短边方向被对应压缩，
-  //   使层层外扩既贴合区域比例，又不会让边缘气泡飞离中心，保持"同心紧凑"观感。
+  // Stretch concentric circles into concentric ellipses based on the container aspect ratio (area-preserving: aspectX * aspectY = 1):
+  // - For a square container, aspectX = aspectY = 1 (standard circular rings)
+  // - The flatter the container, the more the long axis is moderately stretched and the short axis correspondingly compressed,
+  //   so the outward ring expansion follows the region's proportions without letting edge bubbles drift away from the center, keeping a "concentric and compact" look.
   var aspectRatio = maxY > 0 ? maxX / maxY : 1;
   var aspectX = Math.sqrt(aspectRatio);
   var aspectY = 1 / aspectX;
@@ -100,7 +100,7 @@ export function drawCircles(radiusList, maxX, maxY) {
       continue;
     }
 
-    // 同心椭圆的"单位环半径"上限：需同时保证在 x、y 两个方向上不越界
+    // Upper bound of the concentric ellipse "unit ring radius": must stay within bounds in both the x and y directions
     var maxRingUnitX = aspectX > 0 ? Math.min(maxInnerX - centerX, centerX - minX) / aspectX : 0;
     var maxRingUnitY = aspectY > 0 ? Math.min(maxInnerY - centerY, centerY - minY) / aspectY : 0;
     var maxSearchRadius = Math.max(0, Math.min(maxRingUnitX, maxRingUnitY));
@@ -118,9 +118,9 @@ export function drawCircles(radiusList, maxX, maxY) {
     }
 
     // 1) Deterministic concentric rings.
-    // 环间距要同时满足：
-    // - 与最大气泡（位于中心）不重叠：centerRadius + radius + gap
-    // - 标准六边形紧致堆叠：2 * avgRadius + gap
+    // Ring spacing must satisfy both:
+    // - No overlap with the largest bubble (at the center): centerRadius + radius + gap
+    // - Standard hexagonal close packing: 2 * avgRadius + gap
     var centerRadius = (_radiusList$sortedInd = radiusList[sortedIndices[0]]) !== null && _radiusList$sortedInd !== void 0 ? _radiusList$sortedInd : avgRadius;
     var ringSpacing = Math.max(centerRadius + radius + MIN_GAP, avgRadius * 2 + MIN_GAP, 8);
     for (var ring = 1; ring * ringSpacing <= maxSearchRadius && !placed; ring++) {

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

@@ -18,15 +18,15 @@ export interface NormalizedScrollConfig {
     sliderVisible?: boolean;
     wheelModeWhenSliderHidden: "scroll" | "none";
 }
-/** dataZoom 当前可见窗口对应的 x 轴索引区间（闭区间） */
+/** X-axis index range (closed interval) corresponding to the current visible dataZoom window */
 export interface DataZoomIndexWindow {
     startIndex: number;
     endIndex: number;
 }
 /**
- * 把 dataZoom 的 start/end 百分比换算为 x 轴索引窗口。
- * 与本组件族写入 dataZoom 的百分比约定一致（index / total * 100），
- * 对 echarts 原生交互产生的百分比做外扩取整，边界最多多含一项，不影响坐标轴量级。
+ * Converts dataZoom start/end percentages into an x-axis index window.
+ * Follows the same percentage convention this component family writes to dataZoom (index / total * 100);
+ * percentages produced by native echarts interactions are rounded outward, so each boundary may include at most one extra item, without affecting the axis magnitude.
  */
 export declare const percentWindowToIndexWindow: (startPercent: number, endPercent: number, total: number) => DataZoomIndexWindow;
 export declare const createDefaultCategoryXAxis: (xAxisData?: Array<string>) => ChartOptionType;

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

@@ -4,12 +4,12 @@ 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 轴索引区间（闭区间） */
+/** X-axis index range (closed interval) corresponding to the current visible dataZoom window */
 
 /**
- * 把 dataZoom 的 start/end 百分比换算为 x 轴索引窗口。
- * 与本组件族写入 dataZoom 的百分比约定一致（index / total * 100），
- * 对 echarts 原生交互产生的百分比做外扩取整，边界最多多含一项，不影响坐标轴量级。
+ * Converts dataZoom start/end percentages into an x-axis index window.
+ * Follows the same percentage convention this component family writes to dataZoom (index / total * 100);
+ * percentages produced by native echarts interactions are rounded outward, so each boundary may include at most one extra item, without affecting the axis magnitude.
  */
 export var percentWindowToIndexWindow = function percentWindowToIndexWindow(startPercent, endPercent, total) {
   if (total <= 0) return {

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

@@ -1,8 +1,8 @@
 /**
- * 计算合适的Y轴范围和间隔，确保0是刻度点，且总刻度数固定为6个
- * @param min 最小值
- * @param max 最大值
- * @returns { min, max, interval } Y轴配置
+ * Calculates a suitable Y-axis range and interval, ensuring 0 is a tick point and the total tick count is fixed at 6
+ * @param min minimum value
+ * @param max maximum value
+ * @returns { min, max, interval } Y-axis configuration
  */
 export declare function calculateAxisConfig(min: number, max: number): {
     min: number;