@ant-design/agentic-ui 2.14.1 → 2.16.1

package/dist/Plugins/chart/components/ChartFilter/ChartFilter.js

@@ -1,36 +1,228 @@
+function _array_like_to_array(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 _array_with_holes(arr) {
+    if (Array.isArray(arr)) return arr;
+}
+function _iterable_to_array_limit(arr, i) {
+    var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"];
+    if (_i == null) return;
+    var _arr = [];
+    var _n = true;
+    var _d = false;
+    var _s, _e;
+    try {
+        for(_i = _i.call(arr); !(_n = (_s = _i.next()).done); _n = true){
+            _arr.push(_s.value);
+            if (i && _arr.length === i) break;
+        }
+    } catch (err) {
+        _d = true;
+        _e = err;
+    } finally{
+        try {
+            if (!_n && _i["return"] != null) _i["return"]();
+        } finally{
+            if (_d) throw _e;
+        }
+    }
+    return _arr;
+}
+function _non_iterable_rest() {
+    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 _sliced_to_array(arr, i) {
+    return _array_with_holes(arr) || _iterable_to_array_limit(arr, i) || _unsupported_iterable_to_array(arr, i) || _non_iterable_rest();
+}
+function _unsupported_iterable_to_array(o, minLen) {
+    if (!o) return;
+    if (typeof o === "string") return _array_like_to_array(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(n);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array(o, minLen);
+}
 import { ChevronDown } from "@sofa-design/icons";
 import { Button, ConfigProvider, Dropdown, Segmented } from "antd";
 import classNames from "classnames";
-import React, { useContext } from "react";
+import React, { useContext, useEffect, useMemo, useRef, useState } from "react";
 import { I18nContext } from "../../../../I18n";
+import { debounce } from "../../utils";
 import { useStyle } from "./style";
-var ChartFilter = function(param) {
+/**
+ * 比较两个数组是否相等（浅比较）
+ */ var areArraysEqual = function(a, b) {
+    if (a === b) return true;
+    if (!a || !b) return false;
+    if (a.length !== b.length) return false;
+    return a.every(function(item, index) {
+        var other = b[index];
+        if (!other) return false;
+        // 比较所有属性
+        return Object.keys(item).every(function(key) {
+            return item[key] === other[key];
+        });
+    });
+};
+/**
+ * ChartFilter 组件的 props 比较函数
+ * 用于 React.memo 优化，只在真正需要时重新渲染
+ *
+ * 注意：由于组件内部使用 ref 保存上一次有效的 filterOptions，
+ * 即使 filterOptions 暂时为空也不会导致组件消失。
+ * 因此比较时，如果当前值为空但之前有值，我们仍然认为它们"相等"（使用稳定值）。
+ */ var arePropsEqual = function(prevProps, nextProps) {
+    // 比较基本属性
+    if (prevProps.selectedFilter !== nextProps.selectedFilter || prevProps.selectedCustomSelection !== nextProps.selectedCustomSelection || prevProps.className !== nextProps.className || prevProps.theme !== nextProps.theme || prevProps.variant !== nextProps.variant) {
+        return false;
+    }
+    // 比较数组属性（filterOptions 和 customOptions）
+    // 如果两个都是空或都有效，比较内容
+    // 如果一个为空一个有效，认为不相等（需要更新稳定值）
+    var prevFilterValid = prevProps.filterOptions && prevProps.filterOptions.length > 1;
+    var nextFilterValid = nextProps.filterOptions && nextProps.filterOptions.length > 1;
+    // 如果两个都有效，比较内容
+    if (prevFilterValid && nextFilterValid) {
+        if (!areArraysEqual(prevProps.filterOptions, nextProps.filterOptions)) {
+            return false;
+        }
+    } else if (prevFilterValid !== nextFilterValid) {
+        return false;
+    }
+    // 如果两个都无效，认为相等（使用上一次的稳定值）
+    var prevCustomValid = prevProps.customOptions && prevProps.customOptions.length > 1;
+    var nextCustomValid = nextProps.customOptions && nextProps.customOptions.length > 1;
+    if (prevCustomValid && nextCustomValid) {
+        if (!areArraysEqual(prevProps.customOptions, nextProps.customOptions)) {
+            return false;
+        }
+    } else if (prevCustomValid !== nextCustomValid) {
+        return false;
+    }
+    // 回调函数比较
+    // 由于我们已经用 ref 处理回调，即使引用变化也不会影响防抖逻辑
+    // 为了 memo 优化，我们只检查回调是否存在，不比较引用
+    var prevHasFilterChange = prevProps.onFilterChange !== undefined;
+    var nextHasFilterChange = nextProps.onFilterChange !== undefined;
+    if (prevHasFilterChange !== nextHasFilterChange) {
+        return false;
+    }
+    var prevHasSelectionChange = prevProps.onSelectionChange !== undefined;
+    var nextHasSelectionChange = nextProps.onSelectionChange !== undefined;
+    if (prevHasSelectionChange !== nextHasSelectionChange) {
+        return false;
+    }
+    // 所有关键属性都相同，可以跳过重新渲染
+    return true;
+};
+var ChartFilterComponent = function(param) {
     var filterOptions = param.filterOptions, selectedFilter = param.selectedFilter, onFilterChange = param.onFilterChange, customOptions = param.customOptions, selectedCustomSelection = param.selectedCustomSelection, onSelectionChange = param.onSelectionChange, _param_className = param.className, className = _param_className === void 0 ? '' : _param_className, _param_theme = param.theme, theme = _param_theme === void 0 ? 'light' : _param_theme, _param_variant = param.variant, variant = _param_variant === void 0 ? 'default' : _param_variant;
-    var _customOptions_find, _i18n_locale;
+    var _stableCustomOptions_find, _i18n_locale;
     var getPrefixCls = useContext(ConfigProvider.ConfigContext).getPrefixCls;
     var i18n = useContext(I18nContext);
     var prefixCls = getPrefixCls('chart-filter');
     var _useStyle = useStyle(prefixCls), wrapSSR = _useStyle.wrapSSR, hashId = _useStyle.hashId;
-    var handleRegionChange = function(region) {
-        if (onSelectionChange) {
-            onSelectionChange(region);
+    // 使用 useRef 保存最新的回调函数，避免防抖函数闭包问题
+    var onFilterChangeRef = useRef(onFilterChange);
+    var onSelectionChangeRef = useRef(onSelectionChange);
+    // 更新 ref，确保总是使用最新的回调
+    React.useEffect(function() {
+        onFilterChangeRef.current = onFilterChange;
+        onSelectionChangeRef.current = onSelectionChange;
+    }, [
+        onFilterChange,
+        onSelectionChange
+    ]);
+    // 创建防抖的回调函数，1秒更新一次
+    var debouncedFilterChange = useMemo(function() {
+        return debounce(function(value) {
+            if (onFilterChangeRef.current) {
+                onFilterChangeRef.current(value);
+            }
+        }, 1000);
+    }, []);
+    var debouncedSelectionChange = useMemo(function() {
+        return debounce(function(region) {
+            if (onSelectionChangeRef.current) {
+                onSelectionChangeRef.current(region);
+            }
+        }, 1000);
+    }, []);
+    // 组件卸载时清理防抖函数
+    React.useEffect(function() {
+        return function() {
+            var _debouncedFilterChange_cancel, _debouncedSelectionChange_cancel;
+            debouncedFilterChange === null || debouncedFilterChange === void 0 ? void 0 : (_debouncedFilterChange_cancel = debouncedFilterChange.cancel) === null || _debouncedFilterChange_cancel === void 0 ? void 0 : _debouncedFilterChange_cancel.call(debouncedFilterChange);
+            debouncedSelectionChange === null || debouncedSelectionChange === void 0 ? void 0 : (_debouncedSelectionChange_cancel = debouncedSelectionChange.cancel) === null || _debouncedSelectionChange_cancel === void 0 ? void 0 : _debouncedSelectionChange_cancel.call(debouncedSelectionChange);
+        };
+    }, [
+        debouncedFilterChange,
+        debouncedSelectionChange
+    ]);
+    // 稳定化 filterOptions 和 customOptions，避免在流式更新时频繁变化导致组件跳动
+    // 使用 useState 保存稳定的值，只在内容真正变化时才更新
+    var _useState = _sliced_to_array(useState(function() {
+        return filterOptions && filterOptions.length > 1 ? filterOptions : undefined;
+    }), 2), stableFilterOptions = _useState[0], setStableFilterOptions = _useState[1];
+    var _useState1 = _sliced_to_array(useState(function() {
+        return customOptions && customOptions.length > 1 ? customOptions : undefined;
+    }), 2), stableCustomOptions = _useState1[0], setStableCustomOptions = _useState1[1];
+    // 使用 useRef 保存上一次的值用于内容比较
+    var prevFilterOptionsRef = useRef(filterOptions);
+    var prevCustomOptionsRef = useRef(customOptions);
+    // 当 filterOptions 变化时，只在内容真正变化时才更新
+    useEffect(function() {
+        if (filterOptions && filterOptions.length > 1) {
+            // 比较内容是否真的变化
+            var contentChanged = !areArraysEqual(prevFilterOptionsRef.current, filterOptions);
+            if (contentChanged) {
+                // 内容变化，更新稳定值
+                setStableFilterOptions(filterOptions);
+                prevFilterOptionsRef.current = filterOptions;
+            }
+        // 如果内容相同，不更新，避免不必要的重新渲染
+        } else if (filterOptions && filterOptions.length <= 1) {
+        // 如果新值无效（长度 <= 1），但之前有有效值，保持上一次的值（不更新）
+        // 这样 filter 不会消失
+        }
+    // 注意：如果 filterOptions 变为 undefined 或 null，我们不更新稳定值，保持上一次的值
+    }, [
+        filterOptions
+    ]);
+    useEffect(function() {
+        if (customOptions && customOptions.length > 1) {
+            var contentChanged = !areArraysEqual(prevCustomOptionsRef.current, customOptions);
+            if (contentChanged) {
+                setStableCustomOptions(customOptions);
+                prevCustomOptionsRef.current = customOptions;
+            }
         }
+    }, [
+        customOptions
+    ]);
+    var handleRegionChange = function(region) {
+        debouncedSelectionChange(region);
+    };
+    var handleFilterChange = function(value) {
+        debouncedFilterChange(value);
     };
-    var hasMain = Array.isArray(filterOptions) && filterOptions.length > 1;
-    var hasSecondary = Array.isArray(customOptions) && customOptions.length > 1;
+    var hasMain = Array.isArray(stableFilterOptions) && stableFilterOptions.length > 1;
+    var hasSecondary = Array.isArray(stableCustomOptions) && stableCustomOptions.length > 1;
     if (!hasMain && !hasSecondary) {
         return null;
     }
-    if (!filterOptions || filterOptions.length < 2) {
+    if (!stableFilterOptions || stableFilterOptions.length < 2) {
         return null;
     }
     return wrapSSR(/*#__PURE__*/ React.createElement("div", {
         className: classNames(prefixCls, "".concat(prefixCls, "-").concat(theme), "".concat(prefixCls, "-").concat(variant), hashId, className)
-    }, customOptions && customOptions.length > 1 && /*#__PURE__*/ React.createElement("div", {
+    }, stableCustomOptions && stableCustomOptions.length > 1 && /*#__PURE__*/ React.createElement("div", {
         className: classNames("".concat(prefixCls, "-region-filter"), hashId)
     }, /*#__PURE__*/ React.createElement(Dropdown, {
         menu: {
-            items: customOptions.map(function(item) {
+            items: stableCustomOptions.map(function(item) {
                 return {
                     key: item.key,
                     label: item.label,
@@ -52,18 +244,20 @@ var ChartFilter = function(param) {
         type: "default",
         size: "small",
         className: classNames("".concat(prefixCls, "-region-dropdown-btn"), hashId)
-    }, /*#__PURE__*/ React.createElement("span", null, ((_customOptions_find = customOptions.find(function(r) {
+    }, /*#__PURE__*/ React.createElement("span", null, ((_stableCustomOptions_find = stableCustomOptions.find(function(r) {
         return r.key === selectedCustomSelection;
-    })) === null || _customOptions_find === void 0 ? void 0 : _customOptions_find.label) || (i18n === null || i18n === void 0 ? void 0 : (_i18n_locale = i18n.locale) === null || _i18n_locale === void 0 ? void 0 : _i18n_locale.all) || '全部'), /*#__PURE__*/ React.createElement(ChevronDown, {
+    })) === null || _stableCustomOptions_find === void 0 ? void 0 : _stableCustomOptions_find.label) || (i18n === null || i18n === void 0 ? void 0 : (_i18n_locale = i18n.locale) === null || _i18n_locale === void 0 ? void 0 : _i18n_locale.all) || '全部'), /*#__PURE__*/ React.createElement(ChevronDown, {
         className: classNames("".concat(prefixCls, "-dropdown-icon"), hashId)
-    })))), filterOptions && filterOptions.length > 1 && /*#__PURE__*/ React.createElement(Segmented, {
-        options: filterOptions || [],
+    })))), stableFilterOptions && stableFilterOptions.length > 1 && /*#__PURE__*/ React.createElement(Segmented, {
+        options: stableFilterOptions || [],
         value: selectedFilter,
         size: "small",
         className: classNames("".concat(prefixCls, "-segmented-filter"), 'custom-segmented', hashId),
         onChange: function(value) {
-            return onFilterChange === null || onFilterChange === void 0 ? void 0 : onFilterChange(value);
+            return handleFilterChange(value);
         }
     })));
 };
+// 使用 React.memo 包装组件，确保内容稳定，只在 props 真正变化时重新渲染
+var ChartFilter = /*#__PURE__*/ React.memo(ChartFilterComponent, arePropsEqual);
 export default ChartFilter;

package/dist/Plugins/chart/components/ChartToolBar/ChartToolBar.d.ts

@@ -42,6 +42,8 @@ export interface ChartToolBarProps {
     extra?: React.ReactNode;
     /** 过滤器内容 */
     filter?: React.ReactNode;
+    /** 是否显示加载状态（当图表未闭合时显示） */
+    loading?: boolean;
 }
 /**
  * 图表工具栏组件

package/dist/Plugins/chart/components/ChartToolBar/ChartToolBar.js

@@ -2,6 +2,7 @@ import { DownloadOutlined } from "@ant-design/icons";
 import { ConfigProvider, Tooltip } from "antd";
 import classNames from "classnames";
 import React, { useContext } from "react";
+import { Loading } from "../../../../Components/Loading";
 import { I18nContext } from "../../../../I18n";
 import TimeIcon from "../icons/TimeIcon";
 import { useStyle } from "./style";
@@ -28,7 +29,7 @@ import { useStyle } from "./style";
  *
  * @since 1.0.0
  */ var ChartToolBar = function(param) {
-    var title = param.title, dataTime = param.dataTime, _param_className = param.className, className = _param_className === void 0 ? '' : _param_className, _param_theme = param.theme, theme = _param_theme === void 0 ? 'light' : _param_theme, onDownload = param.onDownload, extra = param.extra, filter = param.filter;
+    var title = param.title, dataTime = param.dataTime, _param_className = param.className, className = _param_className === void 0 ? '' : _param_className, _param_theme = param.theme, theme = _param_theme === void 0 ? 'light' : _param_theme, onDownload = param.onDownload, extra = param.extra, filter = param.filter, _param_loading = param.loading, loading = _param_loading === void 0 ? false : _param_loading;
     var _i18n_locale, _i18n_locale1;
     var getPrefixCls = useContext(ConfigProvider.ConfigContext).getPrefixCls;
     var i18n = useContext(I18nContext);
@@ -46,7 +47,13 @@ import { useStyle } from "./style";
         className: classNames(prefixCls, "".concat(prefixCls, "-").concat(theme), hashId, className)
     }, /*#__PURE__*/ React.createElement("div", {
         className: classNames("".concat(prefixCls, "-header-title"), hashId)
-    }, title), /*#__PURE__*/ React.createElement("div", {
+    }, title, loading && /*#__PURE__*/ React.createElement(Loading, {
+        style: {
+            fontSize: '14px',
+            marginLeft: '8px',
+            flexShrink: 0
+        }
+    })), /*#__PURE__*/ React.createElement("div", {
         className: classNames("".concat(prefixCls, "-header-actions"), hashId)
     }, dataTime ? /*#__PURE__*/ React.createElement(React.Fragment, null, /*#__PURE__*/ React.createElement(TimeIcon, {
         className: classNames("".concat(prefixCls, "-time-icon"), hashId)

package/dist/Plugins/chart/components/ChartToolBar/style.js

@@ -71,7 +71,9 @@ var genStyle = function(token) {
         textOverflow: 'ellipsis',
         whiteSpace: 'nowrap',
         marginRight: '16px',
-        minWidth: 0
+        minWidth: 0,
+        display: 'flex',
+        alignItems: 'center'
     }), _define_property(_obj3, "".concat(token.componentCls, "-header-actions"), (_obj = {
         display: 'flex',
         alignItems: 'center',

package/dist/Plugins/chart/hooks/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview 图表插件 Hooks 统一导出文件
+ * 提供图表组件相关的 React Hooks
+ * @author Chart Plugin Team
+ */
+export type { ChartStatisticConfig, StatisticConfigType } from './useChartStatistic';
+export { useChartDataFilter } from './useChartDataFilter';
+export { useChartStatistics } from './useChartStatistics';
+export { useChartTheme } from './useChartTheme';
+export { useResponsiveSize } from './useResponsiveSize';

package/dist/Plugins/chart/hooks/index.js

@@ -0,0 +1,8 @@
+/**
+ * @fileoverview 图表插件 Hooks 统一导出文件
+ * 提供图表组件相关的 React Hooks
+ * @author Chart Plugin Team
+ */ export { useChartDataFilter } from "./useChartDataFilter";
+export { useChartStatistics } from "./useChartStatistics";
+export { useChartTheme } from "./useChartTheme";
+export { useResponsiveSize } from "./useResponsiveSize";

package/dist/Plugins/chart/hooks/useChartDataFilter.d.ts

@@ -0,0 +1,46 @@
+/// <reference types="react" />
+import { ChartDataItem } from '../utils';
+/**
+ * 图表数据筛选 Hook
+ *
+ * 用于管理图表数据的筛选逻辑，包括分类筛选和 filterLabel 筛选。
+ * 自动处理数据变化时的筛选状态重置。
+ *
+ * @param {ChartDataItem[]} data - 原始数据数组
+ * @returns {object} 包含筛选后的数据、筛选选项和筛选状态的对象
+ *
+ * @example
+ * ```typescript
+ * const {
+ *   filteredData,
+ *   categories,
+ *   filterOptions,
+ *   filterLabels,
+ *   selectedFilter,
+ *   setSelectedFilter,
+ *   selectedFilterLabel,
+ *   setSelectedFilterLabel,
+ *   filteredDataByFilterLabel,
+ * } = useChartDataFilter(data);
+ * ```
+ *
+ * @since 1.0.0
+ */
+export declare const useChartDataFilter: (data: ChartDataItem[]) => {
+    filteredData: ChartDataItem[];
+    categories: (string | undefined)[];
+    filterOptions: {
+        label: string;
+        value: string;
+    }[];
+    filterLabels: string[] | undefined;
+    selectedFilter: string;
+    setSelectedFilter: import("react").Dispatch<import("react").SetStateAction<string>>;
+    selectedFilterLabel: string | undefined;
+    setSelectedFilterLabel: import("react").Dispatch<import("react").SetStateAction<string | undefined>>;
+    filteredDataByFilterLabel: {
+        key: string;
+        label: string;
+    }[] | undefined;
+    safeData: ChartDataItem[];
+};

package/dist/Plugins/chart/hooks/useChartDataFilter.js

@@ -0,0 +1,182 @@
+function _array_like_to_array(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 _array_with_holes(arr) {
+    if (Array.isArray(arr)) return arr;
+}
+function _array_without_holes(arr) {
+    if (Array.isArray(arr)) return _array_like_to_array(arr);
+}
+function _iterable_to_array(iter) {
+    if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter);
+}
+function _iterable_to_array_limit(arr, i) {
+    var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"];
+    if (_i == null) return;
+    var _arr = [];
+    var _n = true;
+    var _d = false;
+    var _s, _e;
+    try {
+        for(_i = _i.call(arr); !(_n = (_s = _i.next()).done); _n = true){
+            _arr.push(_s.value);
+            if (i && _arr.length === i) break;
+        }
+    } catch (err) {
+        _d = true;
+        _e = err;
+    } finally{
+        try {
+            if (!_n && _i["return"] != null) _i["return"]();
+        } finally{
+            if (_d) throw _e;
+        }
+    }
+    return _arr;
+}
+function _non_iterable_rest() {
+    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 _non_iterable_spread() {
+    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 _sliced_to_array(arr, i) {
+    return _array_with_holes(arr) || _iterable_to_array_limit(arr, i) || _unsupported_iterable_to_array(arr, i) || _non_iterable_rest();
+}
+function _to_consumable_array(arr) {
+    return _array_without_holes(arr) || _iterable_to_array(arr) || _unsupported_iterable_to_array(arr) || _non_iterable_spread();
+}
+function _unsupported_iterable_to_array(o, minLen) {
+    if (!o) return;
+    if (typeof o === "string") return _array_like_to_array(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(n);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array(o, minLen);
+}
+import { useEffect, useMemo, useState } from "react";
+import { getDataHash } from "../utils";
+/**
+ * 图表数据筛选 Hook
+ *
+ * 用于管理图表数据的筛选逻辑，包括分类筛选和 filterLabel 筛选。
+ * 自动处理数据变化时的筛选状态重置。
+ *
+ * @param {ChartDataItem[]} data - 原始数据数组
+ * @returns {object} 包含筛选后的数据、筛选选项和筛选状态的对象
+ *
+ * @example
+ * ```typescript
+ * const {
+ *   filteredData,
+ *   categories,
+ *   filterOptions,
+ *   filterLabels,
+ *   selectedFilter,
+ *   setSelectedFilter,
+ *   selectedFilterLabel,
+ *   setSelectedFilterLabel,
+ *   filteredDataByFilterLabel,
+ * } = useChartDataFilter(data);
+ * ```
+ *
+ * @since 1.0.0
+ */ export var useChartDataFilter = function(data) {
+    var safeData = Array.isArray(data) ? data : [];
+    // 使用数据哈希来优化依赖项比较
+    var dataHash = useMemo(function() {
+        return getDataHash(safeData);
+    }, [
+        safeData
+    ]);
+    // 从数据中提取唯一的类别作为筛选选项
+    var categories = useMemo(function() {
+        var uniqueCategories = _to_consumable_array(new Set(safeData.map(function(item) {
+            return item.category;
+        }))).filter(Boolean);
+        return uniqueCategories;
+    }, [
+        dataHash
+    ]);
+    // 从数据中提取 filterLabel，过滤掉 undefined 值
+    var validFilterLabels = useMemo(function() {
+        return safeData.map(function(item) {
+            return item.filterLabel;
+        }).filter(function(filterLabel) {
+            return filterLabel !== undefined;
+        });
+    }, [
+        dataHash
+    ]);
+    var filterLabels = useMemo(function() {
+        return validFilterLabels.length > 0 ? _to_consumable_array(new Set(validFilterLabels)) : undefined;
+    }, [
+        validFilterLabels
+    ]);
+    // 状态管理
+    var _useState = _sliced_to_array(useState(categories.find(Boolean) || ''), 2), selectedFilter = _useState[0], setSelectedFilter = _useState[1];
+    var _useState1 = _sliced_to_array(useState(filterLabels && filterLabels.length > 0 ? filterLabels[0] : undefined), 2), selectedFilterLabel = _useState1[0], setSelectedFilterLabel = _useState1[1];
+    // 当数据变化导致当前选中分类失效时，自动回退到首个有效分类或空（显示全部）
+    useEffect(function() {
+        if (selectedFilter && !categories.includes(selectedFilter)) {
+            setSelectedFilter(categories.find(Boolean) || '');
+        }
+    }, [
+        categories,
+        selectedFilter
+    ]);
+    // 筛选数据
+    var filteredData = useMemo(function() {
+        var base = selectedFilter ? safeData.filter(function(item) {
+            return item.category === selectedFilter;
+        }) : safeData;
+        var withFilterLabel = !filterLabels || !selectedFilterLabel ? base : base.filter(function(item) {
+            return item.filterLabel === selectedFilterLabel;
+        });
+        // 统一过滤掉 x 为空（null/undefined）的数据，避免后续 toString 报错
+        return withFilterLabel.filter(function(item) {
+            return item.x !== null && item.x !== undefined;
+        });
+    }, [
+        dataHash,
+        selectedFilter,
+        filterLabels,
+        selectedFilterLabel
+    ]);
+    // 筛选器选项
+    var filterOptions = useMemo(function() {
+        return categories.map(function(category) {
+            return {
+                label: category || '默认',
+                value: category || '默认'
+            };
+        });
+    }, [
+        categories
+    ]);
+    // 根据 filterLabel 筛选数据 - 只有当 filterLabels 存在时才生成
+    var filteredDataByFilterLabel = useMemo(function() {
+        return filterLabels === null || filterLabels === void 0 ? void 0 : filterLabels.map(function(item) {
+            return {
+                key: item,
+                label: item
+            };
+        });
+    }, [
+        filterLabels
+    ]);
+    return {
+        filteredData: filteredData,
+        categories: categories,
+        filterOptions: filterOptions,
+        filterLabels: filterLabels,
+        selectedFilter: selectedFilter,
+        setSelectedFilter: setSelectedFilter,
+        selectedFilterLabel: selectedFilterLabel,
+        setSelectedFilterLabel: setSelectedFilterLabel,
+        filteredDataByFilterLabel: filteredDataByFilterLabel,
+        safeData: safeData
+    };
+};

package/dist/Plugins/chart/hooks/useChartStatistics.d.ts

@@ -0,0 +1,17 @@
+import { StatisticConfigType } from './useChartStatistic';
+/**
+ * 图表统计信息 Hook
+ *
+ * 用于处理 ChartStatistic 组件的配置，支持单个配置对象或配置数组。
+ *
+ * @param {StatisticConfigType} statisticConfig - 统计配置，可以是单个配置对象或配置数组
+ * @returns {ChartStatisticConfig[] | null} 处理后的统计配置数组，如果未提供配置则返回 null
+ *
+ * @example
+ * ```typescript
+ * const statistics = useChartStatistics(statisticConfig);
+ * ```
+ *
+ * @since 1.0.0
+ */
+export declare const useChartStatistics: (statisticConfig?: StatisticConfigType) => import("./useChartStatistic").ChartStatisticConfig[] | null;

package/dist/Plugins/chart/hooks/useChartStatistics.js

@@ -0,0 +1,25 @@
+import { useMemo } from "react";
+/**
+ * 图表统计信息 Hook
+ *
+ * 用于处理 ChartStatistic 组件的配置，支持单个配置对象或配置数组。
+ *
+ * @param {StatisticConfigType} statisticConfig - 统计配置，可以是单个配置对象或配置数组
+ * @returns {ChartStatisticConfig[] | null} 处理后的统计配置数组，如果未提供配置则返回 null
+ *
+ * @example
+ * ```typescript
+ * const statistics = useChartStatistics(statisticConfig);
+ * ```
+ *
+ * @since 1.0.0
+ */ export var useChartStatistics = function(statisticConfig) {
+    return useMemo(function() {
+        if (!statisticConfig) return null;
+        return Array.isArray(statisticConfig) ? statisticConfig : [
+            statisticConfig
+        ];
+    }, [
+        statisticConfig
+    ]);
+};

package/dist/Plugins/chart/hooks/useChartTheme.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 图表主题 Hook
+ *
+ * 用于计算图表在不同主题下的颜色配置，包括坐标轴文字颜色和网格颜色。
+ *
+ * @param {'light' | 'dark'} theme - 图表主题
+ * @returns {object} 包含主题相关颜色的对象
+ *
+ * @example
+ * ```typescript
+ * const { axisTextColor, gridColor, isLight } = useChartTheme('light');
+ * ```
+ *
+ * @since 1.0.0
+ */
+export declare const useChartTheme: (theme?: 'light' | 'dark') => {
+    isLight: boolean;
+    axisTextColor: string;
+    gridColor: string;
+};

package/dist/Plugins/chart/hooks/useChartTheme.js

@@ -0,0 +1,30 @@
+import { useMemo } from "react";
+/**
+ * 图表主题 Hook
+ *
+ * 用于计算图表在不同主题下的颜色配置，包括坐标轴文字颜色和网格颜色。
+ *
+ * @param {'light' | 'dark'} theme - 图表主题
+ * @returns {object} 包含主题相关颜色的对象
+ *
+ * @example
+ * ```typescript
+ * const { axisTextColor, gridColor, isLight } = useChartTheme('light');
+ * ```
+ *
+ * @since 1.0.0
+ */ export var useChartTheme = function() {
+    var theme = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : 'light';
+    return useMemo(function() {
+        var isLight = theme === 'light';
+        var axisTextColor = isLight ? 'rgba(0, 25, 61, 0.3255)' : 'rgba(255, 255, 255, 0.8)';
+        var gridColor = isLight ? 'rgba(0,0,0,0.08)' : 'rgba(255,255,255,0.2)';
+        return {
+            isLight: isLight,
+            axisTextColor: axisTextColor,
+            gridColor: gridColor
+        };
+    }, [
+        theme
+    ]);
+};