@hsu-react/ui 0.0.12 → 0.0.14

package/src/components/Chart/Heatmap/index.tsx

@@ -8,32 +8,32 @@ import {
 } from "../_utils/heatmap";
 
 export interface HeatmapDataItem {
-  /** X 轴索引或名称 */
+  /** X-axis index or name */
   x: number | string;
-  /** Y 轴索引或名称 */
+  /** Y-axis index or name */
   y: number | string;
-  /** 热力值（业务实际数值，如 tooltip 应展示此字段） */
+  /** Heat value (the actual business value; e.g. the tooltip should display this field) */
   value: number;
-  /** 可选：仅用于着色与 visualMap，不传则与 value 相同 */
+  /** Optional: used only for coloring and visualMap; defaults to value when omitted */
   visualWeight?: number;
 }
 
 export interface ChartHeatmapProps extends ChartCommonProps {
-  /** 热力图数据，格式为 [[x, y, value]] 或 HeatmapDataItem[] */
+  /** Heatmap data, in [[x, y, value]] or HeatmapDataItem[] format */
   data: Array<[number, number, number]> | HeatmapDataItem[];
-  /** X 轴数据（类别名称） */
+  /** X-axis data (category names) */
   xAxisData?: string[];
-  /** Y 轴数据（类别名称） */
+  /** Y-axis data (category names) */
   yAxisData?: string[];
-  /** 图表标题 */
+  /** Chart title */
   chartTitle?: string;
-  /** visualMap 配置 */
+  /** visualMap config */
   visualMap?: echarts.VisualMapComponentOption;
-  /** 图表实例回调 */
+  /** Chart instance callback */
   onChart?: (chart: echarts.EChartsType) => void;
-  /** 点击事件 */
+  /** Click event */
   onClick?: (event: echarts.ECElementEvent) => void;
-  /** 0值颜色 */
+  /** Color for zero values */
   zeroColor?: string | false;
   /** inRangeColor */
   inRangeColor?: string[];
@@ -74,20 +74,20 @@ const Heatmap: React.FC<ChartHeatmapProps> = (props) => {
   const chartInstanceRef = useRef<echarts.ECharts | null>(null);
   const resizeObserverRef = useRef<ResizeObserver | null>(null);
 
-  // 处理数据并生成图表配置
+  // Process the data and generate the chart option
   const chartOption = useMemo(() => {
     if (!data || data.length === 0) {
       return {} as ChartsOption;
     }
 
-    // 转换数据格式为 ECharts 需要的格式 [[x, y, value]]
+    // Convert the data to the [[x, y, value]] format ECharts expects
     let processedData: Array<[number, number, number]>;
     if (Array.isArray(data) && data.length > 0) {
       if (Array.isArray(data[0])) {
-        // 已经是 [[x, y, value]] 格式
+        // Already in [[x, y, value]] format
         processedData = data as Array<[number, number, number]>;
       } else {
-        // 是 HeatmapDataItem[] 格式，需要转换
+        // HeatmapDataItem[] format, needs conversion
         processedData = (data as HeatmapDataItem[])?.map((item) => {
           const xIndex =
             typeof item.x === "number"
@@ -106,12 +106,12 @@ const Heatmap: React.FC<ChartHeatmapProps> = (props) => {
       processedData = [];
     }
 
-    // 计算值的范围用于 visualMap
+    // Compute the value range for visualMap
     const values = processedData?.map((item) => item[2]);
     const minValue = Math.min(...values);
     const maxValue = Math.max(...values);
 
-    // 默认 visualMap 配置
+    // Default visualMap config
     const defaultVisualMap: echarts.VisualMapComponentOption = {
       min: minValue,
       max: maxValue,
@@ -127,7 +127,7 @@ const Heatmap: React.FC<ChartHeatmapProps> = (props) => {
       },
     };
 
-    // 处理 xAxis 配置
+    // Process xAxis config
     const def_xAxis = createDefaultHeatmapXAxis(xAxisData);
     const processedXAxis = Array.isArray(xAxis)
       ? xAxis?.map((item) => ({
@@ -141,7 +141,7 @@ const Heatmap: React.FC<ChartHeatmapProps> = (props) => {
           ...xAxis,
         };
 
-    // 处理 yAxis 配置
+    // Process yAxis config
     const def_yAxis = createDefaultHeatmapYAxis(yAxisData);
     const processedYAxis = Array.isArray(yAxis)
       ? yAxis?.map((item) => ({
@@ -155,13 +155,13 @@ const Heatmap: React.FC<ChartHeatmapProps> = (props) => {
           ...yAxis,
         };
 
-    // 处理 visualMap 配置
+    // Process visualMap config
     const finalVisualMap = {
       ...defaultVisualMap,
       ...propVisualMap,
     };
 
-    // 计算 grid 配置
+    // Compute grid config
     const gridConfig: echarts.GridComponentOption = {
       height: "95%",
       top: "5%",
@@ -169,7 +169,7 @@ const Heatmap: React.FC<ChartHeatmapProps> = (props) => {
       containLabel: true,
     };
 
-    // 根据 visualMap 的显示状态和方向设置 grid 的 right 或 bottom
+    // Set the grid's right or bottom based on visualMap's visibility and orientation
     if (finalVisualMap.show !== false) {
       const orient = finalVisualMap.orient || defaultVisualMap.orient;
       if (orient === "vertical") {
@@ -179,7 +179,7 @@ const Heatmap: React.FC<ChartHeatmapProps> = (props) => {
       }
     }
 
-    // 合并用户传入的 grid 配置
+    // Merge the user-provided grid config
     Object.assign(gridConfig, grid);
 
     const option: ChartsOption = {
@@ -246,42 +246,42 @@ const Heatmap: React.FC<ChartHeatmapProps> = (props) => {
     zeroColor,
   ]);
 
-  // 处理图表 resize 的回调
+  // Callback for handling chart resize
   const handleResize = useCallback(() => {
     chartInstanceRef.current?.resize();
   }, []);
 
-  // 初始化图表
+  // Initialize the chart
   useEffect(() => {
     if (!chartRef.current) return;
 
-    // 初始化或获取已存在的实例
+    // Initialize or reuse the existing instance
     let chart = chartInstanceRef.current;
     if (!chart) {
       chart = echarts.init(chartRef.current);
       chartInstanceRef.current = chart;
-      // 首次初始化时调用 onChart 回调
+      // Call the onChart callback on first initialization
       onChart?.(chart);
     }
 
-    // 设置配置
+    // Apply the option
     chart.setOption(chartOption as ChartOptionType, 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) {
       chartInstanceRef.current?.on("click", onClick);
     }
 
-    // 清理函数
+    // Cleanup function
     return () => {
       window.removeEventListener("resize", handleResize);
 
@@ -291,15 +291,15 @@ const Heatmap: React.FC<ChartHeatmapProps> = (props) => {
     };
   }, [chartOption, handleResize, onChart, onClick]);
 
-  // 组件卸载时清理资源
+  // Clean up resources when the component unmounts
   useEffect(() => {
     return () => {
-      // 清理 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/src/components/Chart/Line/index.tsx

@@ -30,15 +30,15 @@ export interface ChartLineProps extends ChartCommonProps {
   scrollConfig?: ChartScrollConfig;
   yAxisNameOffsets?: number[];
   onClick?: (event: echarts.ECElementEvent) => void;
-  /** 图例点选变化回调，参数为当前各系列选中状态（配合 legend.selected 可实现坐标轴重算） */
+  /** Legend selection change callback; the argument is the current selected state of each series (combined with legend.selected, enables axis recalculation) */
   onLegendSelectChanged?: (selected: Record<string, boolean>) => void;
-  /** dataZoom 可见窗口变化回调（滑块/滚轮/自动滚动/初始同步均触发），参数为当前可见的 x 轴索引区间（配合 useDataZoomWindow 可按展示部分重算坐标轴） */
+  /** dataZoom visible-window change callback (fired by slider/wheel/auto-scroll/initial sync); the argument is the currently visible x-axis index range (combined with useDataZoomWindow, enables recalculating axes based on the displayed portion) */
   onDataZoomWindowChanged?: (window: DataZoomIndexWindow) => void;
-  /** 是否启用图例自动滚动，默认 false */
+  /** Whether to enable legend auto-scroll, default false */
   enableLegendAutoScroll?: boolean;
-  /** 图例每页可见数量，默认 8 */
+  /** Number of legend items visible per page, default 8 */
   legendVisibleCount?: number;
-  /** 图例滚动间隔时间(ms)，默认 1500 */
+  /** Legend scroll interval (ms), default 1500 */
   legendScrollInterval?: number;
 }
 
@@ -81,12 +81,12 @@ const ChartLine: React.FC<ChartLineProps> = (props) => {
     [scrollConfig],
   );
 
-  // 使用 useMemo 缓存 chart 配置
+  // Cache the chart option with useMemo
   const chartOption = useMemo(() => {
     const def_xAxis = createDefaultCategoryXAxis(xAxisData);
     const def_yAxis = createDefaultValueYAxis("line");
 
-    // 处理 xAxis 配置
+    // Process xAxis config
     const processedXAxis = Array.isArray(xAxis)
       ? xAxis?.map((item) => ({
           ...def_xAxis,
@@ -99,7 +99,7 @@ const ChartLine: React.FC<ChartLineProps> = (props) => {
           ...xAxis,
         };
 
-    // 处理 yAxis 配置
+    // Process yAxis config
     const processedYAxis = Array.isArray(yAxis)
       ? yAxis?.map((item) => ({
           ...def_yAxis,
@@ -112,7 +112,7 @@ const ChartLine: React.FC<ChartLineProps> = (props) => {
           ...yAxis,
         };
 
-    // 计算 grid 配置
+    // Compute grid config
     let gridTop: string | undefined = "5%";
 
     if ((yAxis as ChartOptionType)?.name) {
@@ -132,7 +132,7 @@ const ChartLine: React.FC<ChartLineProps> = (props) => {
       delete gridConfig.top;
     }
 
-    // 处理 dataZoom 配置
+    // Process dataZoom config
     const totalLen = xAxisData?.length ?? 1;
     const {
       zoomEnabled,
@@ -258,24 +258,24 @@ const ChartLine: React.FC<ChartLineProps> = (props) => {
     coreOption,
   ]);
 
-  // 处理图表 resize 的回调
+  // Callback for handling chart resize
   const handleResize = useCallback(() => {
     chartInstanceRef.current?.resize();
   }, []);
 
-  // 初始化图表
+  // Initialize the chart
   useEffect(() => {
     if (!chartRef.current) return;
 
-    // 初始化或获取已存在的实例
+    // Initialize or reuse the existing instance
     let chart = chartInstanceRef.current;
     if (!chart) {
       chart = echarts.init(chartRef.current);
       chartInstanceRef.current = chart;
     }
 
-    // 设置配置：notMerge 会把 dataZoom 窗口重置回初始位置，
-    // x 轴数据未变化时（如坐标轴重算/图例点选触发的重渲染）先记录当前窗口，设置后恢复
+    // Set the option: notMerge resets the dataZoom window to its initial position,
+    // so when x-axis data is unchanged (e.g. re-render triggered by axis recalculation / legend selection), record the current window first and restore it afterwards
     const xAxisKey = xAxisData?.join("\u0001") ?? "";
     const prevZoomRanges =
       prevXAxisKeyRef.current === xAxisKey
@@ -296,7 +296,7 @@ const ChartLine: React.FC<ChartLineProps> = (props) => {
       });
     }
 
-    // 向调用方同步当前可见窗口（初始渲染与恢复后），用于按展示部分重算坐标轴
+    // Sync the current visible window to the caller (on initial render and after restore), used to recalculate axes based on the displayed portion
     if (onDataZoomWindowChanged) {
       const zooms = (chart.getOption() as ChartsOption | undefined)
         ?.dataZoom as Array<{ start?: number; end?: number }> | undefined;
@@ -307,7 +307,7 @@ const ChartLine: React.FC<ChartLineProps> = (props) => {
           percentWindowToIndexWindow(zoom.start, zoom.end, totalLen),
         );
       } else {
-        // 无 dataZoom（如数据量不足未启用滚动）时窗口即全量，同步一次避免残留旧窗口
+        // Without dataZoom (e.g. scrolling not enabled due to insufficient data) the window is the full range; sync once to avoid a stale old window
         onDataZoomWindowChanged({
           startIndex: 0,
           endIndex: Math.max(0, totalLen - 1),
@@ -315,21 +315,21 @@ const ChartLine: React.FC<ChartLineProps> = (props) => {
       }
     }
 
-    // 添加 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) {
       chartInstanceRef.current?.on("click", onClick);
     }
 
-    // 图例点选事件
+    // Legend selection event
     const handleLegendSelectChanged = (params: unknown) => {
       onLegendSelectChanged?.(
         (params as { selected: Record<string, boolean> }).selected,
@@ -342,7 +342,7 @@ const ChartLine: React.FC<ChartLineProps> = (props) => {
       );
     }
 
-    // dataZoom 原生交互（slider 拖动 / inside 缩放）→ 同步可见窗口
+    // Native dataZoom interaction (slider drag / inside zoom) → sync the visible window
     const handleDataZoom = (params: unknown) => {
       const raw = params as {
         start?: number;
@@ -382,7 +382,7 @@ const ChartLine: React.FC<ChartLineProps> = (props) => {
       chartInstanceRef.current?.on("datazoom", handleDataZoom);
     }
 
-    // 图例自动滚动（与 Pie/Bar 一致）
+    // Legend auto-scroll (consistent with Pie/Bar)
     const opt = chartOption as ChartsOption;
     const legendDataLen = Array.isArray(opt.legend)
       ? opt.legend[0]?.data?.length
@@ -406,7 +406,7 @@ const ChartLine: React.FC<ChartLineProps> = (props) => {
       });
     }
 
-    // 清理函数
+    // Cleanup function
     return () => {
       window.removeEventListener("resize", handleResize);
 
@@ -442,7 +442,7 @@ const ChartLine: React.FC<ChartLineProps> = (props) => {
     legendScrollInterval,
   ]);
 
-  // 处理自动播放
+  // Handle auto play
   useEffect(() => {
     if (
       !normalizedScroll.zoomEnabled ||
@@ -490,15 +490,15 @@ const ChartLine: React.FC<ChartLineProps> = (props) => {
     onDataZoomWindowChanged,
   ]);
 
-  // 组件卸载时清理资源
+  // Clean up resources when the component unmounts
   useEffect(() => {
     return () => {
-      // 清理 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/src/components/Chart/Pie/Pie3D/_hooks/index.ts

@@ -4,7 +4,7 @@ import { ChartsOption, ChartOptionType } from "../../..";
 import { getParametricEquation } from "../_utils/parametricEquation";
 import type { SeriesItem } from "..";
 
-// 获取饼图扇区的数量（不包括标签系列）
+// Get the number of pie sectors (excluding the label series)
 const getPieSeriesCount = (series: SeriesItem[]): number => {
   return series.filter((s) => s.type === "surface").length;
 };
@@ -18,7 +18,7 @@ const getMaxPieValue = (series: SeriesItem[]): number => {
   return Math.max(1, ...values);
 };
 
-// 高亮标签
+// Highlight a label
 const highlightLabel = (
   option: ChartsOption & { series: SeriesItem[] },
   pieIndex: number
@@ -27,7 +27,7 @@ const highlightLabel = (
   const lineIndex = pieSeriesCount + pieIndex;
   const scatterIndex = pieSeriesCount * 2 + pieIndex;
 
-  // 高亮线条
+  // Highlight the leader line
   if (lineIndex < option.series.length) {
     const lineSeries = option.series[
       lineIndex
@@ -36,16 +36,16 @@ const highlightLabel = (
       _originalWidth?: number;
     };
     if (lineSeries && lineSeries.lineStyle) {
-      // 保存原始宽度（如果还没有保存）
+      // Save the original width (if not saved yet)
       if (lineSeries._originalWidth === undefined) {
         lineSeries._originalWidth = lineSeries.lineStyle.width || 1;
       }
-      // 高亮：只增加宽度，不改变颜色
+      // Highlight: only increase the width, keep the color
       lineSeries.lineStyle.width = (lineSeries._originalWidth || 1) * 2;
     }
   }
 
-  // 高亮文本
+  // Highlight the text
   if (scatterIndex < option.series.length) {
     const scatterSeries = option.series[
       scatterIndex
@@ -57,17 +57,17 @@ const highlightLabel = (
     };
     if (scatterSeries && scatterSeries.label && scatterSeries.label.textStyle) {
       const textStyle = scatterSeries.label.textStyle;
-      // 保存原始字体大小（如果还没有保存）
+      // Save the original font size (if not saved yet)
       if (scatterSeries._originalFontSize === undefined) {
         scatterSeries._originalFontSize = textStyle.fontSize || 14;
       }
-      // 高亮：只增加字体大小，不改变颜色
+      // Highlight: only increase the font size, keep the color
       textStyle.fontSize = (scatterSeries._originalFontSize || 14) * 1.2;
     }
   }
 };
 
-// 取消标签高亮
+// Remove label highlight
 const unhighlightLabel = (
   option: ChartsOption & { series: SeriesItem[] },
   pieIndex: number
@@ -76,7 +76,7 @@ const unhighlightLabel = (
   const lineIndex = pieSeriesCount + pieIndex;
   const scatterIndex = pieSeriesCount * 2 + pieIndex;
 
-  // 恢复线条样式
+  // Restore the leader line style
   if (lineIndex < option.series.length) {
     const lineSeries = option.series[
       lineIndex
@@ -93,7 +93,7 @@ const unhighlightLabel = (
     }
   }
 
-  // 恢复文本样式
+  // Restore the text style
   if (scatterIndex < option.series.length) {
     const scatterSeries = option.series[
       scatterIndex
@@ -174,7 +174,7 @@ export const useMouseOverHandler = (
         );
         option.series[idx].pieStatus.hovered = false;
 
-        // 取消之前高亮的标签
+        // Clear the previously highlighted label
         unhighlightLabel(option, idx);
 
         hoveredIndexRef.current = "";
@@ -205,7 +205,7 @@ export const useMouseOverHandler = (
         );
         option.series[seriesIndex].pieStatus.hovered = true;
 
-        // 高亮对应的标签
+        // Highlight the matching label
         highlightLabel(option, seriesIndex);
 
         hoveredIndexRef.current = seriesIndex;
@@ -279,7 +279,7 @@ export const useGlobalOutHandler = (
       );
       option.series[idx].pieStatus.hovered = false;
 
-      // 取消标签高亮
+      // Remove label highlight
       unhighlightLabel(option, idx);
 
       hoveredIndexRef.current = "";