@nokecy/qc-ui 1.0.70 → 1.0.72

package/dist/cjs/ag-grid-plus/ag-gridPlus.js

@@ -1,6 +1,5 @@
 "use strict";
 
-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); }
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
@@ -25,11 +24,19 @@ var _processColumnGroups = _interopRequireDefault(require("./_utils/processColum
 var _processFormColumnState = _interopRequireDefault(require("./_utils/processFormColumnState"));
 var _antdV = require("@formily/antd-v5");
 var _locale = require("./locale");
-var _excluded = ["style", "loading", "params", "request", "dataSource", "treeKeyName", "treeParentName", "rowData", "gridRef", "headerTitle", "toolBarRender", "search", "hideTool", "onGridReady", "gridKey", "children", "defaultSearchExpand", "overlayNoRowsTemplateText", "queryDefaultRows", "onSelectedRowsChange"];
+var _gridContext = require("./context/gridContext");
+var _querySchemes = require("./querySchemes");
+var _schemes = require("./schemes");
+var _globalSyncManager = require("./storage/globalSyncManager");
+var _sanitize = require("./utils/sanitize");
+var _errors = require("./errors");
+var _logger = require("./utils/logger");
+var _excluded = ["style", "loading", "params", "request", "dataSource", "treeKeyName", "treeParentName", "rowData", "gridRef", "headerTitle", "toolBarRender", "search", "hideTool", "onGridReady", "gridKey", "children", "defaultSearchExpand", "overlayNoRowsTemplateText", "queryDefaultRows", "onSelectedRowsChange", "enableQuerySchemes", "querySchemeStorageAdapter", "querySchemeManager", "enableColumnSchemes", "columnSchemeStorageAdapter", "columnSchemeManager"];
 function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(e) { return e ? t : r; })(e); }
 function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != _typeof(e) && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 function _extends() { _extends = Object.assign ? Object.assign.bind() : function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
+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); }
 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; }
@@ -43,12 +50,12 @@ function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" !=
 function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
 function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
-var Paragraph = _antd.Typography.Paragraph,
-  Text = _antd.Typography.Text;
+var Text = _antd.Typography.Text;
 var getSort = function getSort(columnState) {
   return columnState ? "".concat(columnState.colId, " ").concat(columnState.sort) : "";
 };
 function AgGridPlus(props) {
+  var _querySchemeManager$c;
   var style = props.style,
     loadingProps = props.loading,
     gridParams = props.params,
@@ -69,6 +76,14 @@ function AgGridPlus(props) {
     overlayNoRowsTemplateText = props.overlayNoRowsTemplateText,
     queryDefaultRows = props.queryDefaultRows,
     onSelectedRowsChange = props.onSelectedRowsChange,
+    _props$enableQuerySch = props.enableQuerySchemes,
+    enableQuerySchemes = _props$enableQuerySch === void 0 ? true : _props$enableQuerySch,
+    querySchemeStorageAdapter = props.querySchemeStorageAdapter,
+    propsQuerySchemeManager = props.querySchemeManager,
+    _props$enableColumnSc = props.enableColumnSchemes,
+    enableColumnSchemes = _props$enableColumnSc === void 0 ? true : _props$enableColumnSc,
+    columnSchemeStorageAdapter = props.columnSchemeStorageAdapter,
+    propsColumnSchemeManager = props.columnSchemeManager,
     rest = _objectWithoutProperties(props, _excluded);
   var _useGridPlusColumnSta = (0, _.useGridPlusColumnState)(),
     onSaveColumnState = _useGridPlusColumnSta.onSaveColumnState,
@@ -120,6 +135,51 @@ function AgGridPlus(props) {
     _useState18 = _slicedToArray(_useState17, 2),
     pagination = _useState18[0],
     setPagination = _useState18[1];
+
+  // ============ 查询方案管理 ============
+  var _useState19 = (0, _react.useState)([]),
+    _useState20 = _slicedToArray(_useState19, 2),
+    queryItemsOrder = _useState20[0],
+    setQueryItemsOrder = _useState20[1];
+
+  // 尝试获取全局适配器（如果已初始化）
+  var globalQueryAdapter = (0, _globalSyncManager.isGlobalSyncInitialized)() ? (0, _globalSyncManager.useGlobalQueryAdapter)() : undefined;
+  var globalColumnAdapter = (0, _globalSyncManager.isGlobalSyncInitialized)() ? (0, _globalSyncManager.useGlobalColumnAdapter)() : undefined;
+
+  // 自动创建查询方案管理器（如果未通过 props 提供）
+  var autoQuerySchemeManager = enableQuerySchemes && gridKey && !propsQuerySchemeManager ? (0, _querySchemes.useQuerySchemes)({
+    gridId: gridKey,
+    // 优先使用全局适配器，否则使用 props 传入的适配器
+    storageAdapter: globalQueryAdapter || querySchemeStorageAdapter,
+    onSchemeChange: function onSchemeChange(scheme) {
+      if (scheme) {
+        setQueryItemsOrder(scheme.itemsOrder);
+      }
+    }
+  }) : undefined;
+
+  // 优先使用 props 提供的管理器，否则使用自动创建的
+  var querySchemeManager = propsQuerySchemeManager || autoQuerySchemeManager;
+
+  // ============ 列配置方案管理 ============
+  // 自动创建列配置方案管理器（如果未通过 props 提供）
+  var autoColumnSchemeManager = enableColumnSchemes && gridKey && !propsColumnSchemeManager ? (0, _schemes.useColumnSchemes)({
+    gridId: gridKey,
+    // 优先使用全局适配器，否则使用 props 传入的适配器
+    storageAdapter: globalColumnAdapter || columnSchemeStorageAdapter,
+    enableAutoSave: true,
+    onSchemeChange: function onSchemeChange(scheme) {
+      if (scheme && apiRef.current) {
+        apiRef.current.applyColumnState({
+          state: scheme.columnState,
+          applyOrder: true
+        });
+      }
+    }
+  }) : undefined;
+
+  // 优先使用 props 提供的管理器，否则使用自动创建的
+  var columnSchemeManager = propsColumnSchemeManager || autoColumnSchemeManager;
   (0, _react.useImperativeHandle)(propsGridRef, function () {
     return gridRef.current;
   });
@@ -174,27 +234,42 @@ function AgGridPlus(props) {
     };
   }, []);
 
-  //请求数据
-  (0, _react.useEffect)(function () {
-    if (ready && request) {
-      onRequest(queryFilter);
-    }
-  }, [ready, JSON.stringify(gridParams), JSON.stringify(sortColumn), pagination.pageSize, pagination.current]);
   // 测试列数据
   // const restData = [{"id":"47","field":"code","headerName":"编码","width":110,"hide":false,"cellClass":"custom-cell-left","suppressHeaderFilterButton":true,"colId":"code","pinned":null,"sort":null,"sortIndex":null,"aggFunc":null,"rowGroup":false,"rowGroupIndex":null,"pivot":false,"pivotIndex":null,"flex":null},{"id":"48","field":"name","headerName":"名称","width":110,"hide":false,"cellClass":"custom-cell-left","suppressHeaderFilterButton":true,"colId":"name","pinned":null,"sort":null,"sortIndex":null,"aggFunc":null,"rowGroup":false,"rowGroupIndex":null,"pivot":false,"pivotIndex":null,"flex":null},{"id":"49","field":"abbName","headerName":"简称","width":110,"hide":false,"cellClass":"custom-cell-left","suppressHeaderFilterButton":true,"colId":"abbName","pinned":null,"sort":null,"sortIndex":null,"aggFunc":null,"rowGroup":false,"rowGroupIndex":null,"pivot":false,"pivotIndex":null,"flex":null},{"id":"50","field":"address","headerName":"地址","width":662,"hide":false,"cellClass":"custom-cell-left","suppressHeaderFilterButton":true,"colId":"address","pinned":null,"sort":null,"sortIndex":null,"aggFunc":null,"rowGroup":false,"rowGroupIndex":null,"pivot":false,"pivotIndex":null,"flex":1},{"id":"51","field":"creator","headerName":"创建人","width":90,"hide":false,"cellClass":"custom-cell-left","suppressHeaderFilterButton":true,"colId":"creator","pinned":null,"sort":null,"sortIndex":null,"aggFunc":null,"rowGroup":false,"rowGroupIndex":null,"pivot":false,"pivotIndex":null,"flex":null},{"id":"52","field":"creationTime","headerName":"创建时间","width":160,"hide":false,"cellClass":"custom-cell-left","suppressHeaderFilterButton":true,"colId":"creationTime","pinned":null,"sort":null,"sortIndex":null,"aggFunc":null,"rowGroup":false,"rowGroupIndex":null,"pivot":false,"pivotIndex":null,"flex":null},{"id":"53","field":"lastModifier","headerName":"最后修改人","width":90,"hide":false,"cellClass":"custom-cell-left","suppressHeaderFilterButton":true,"colId":"lastModifier","pinned":null,"sort":null,"sortIndex":null,"aggFunc":null,"rowGroup":false,"rowGroupIndex":null,"pivot":false,"pivotIndex":null,"flex":null},{"id":"54","field":"lastModificationTime","headerName":"最后修改时间","width":160,"hide":false,"cellClass":"custom-cell-left","suppressHeaderFilterButton":true,"colId":"lastModificationTime","pinned":null,"sort":null,"sortIndex":null,"aggFunc":null,"rowGroup":false,"rowGroupIndex":null,"pivot":false,"pivotIndex":null,"flex":null},{"id":"55","field":"","headerName":"操作","width":160,"hide":false,"cellClass":"custom-cell-left","suppressHeaderFilterButton":true,"colId":"0","pinned":"right","sort":null,"sortIndex":null,"aggFunc":null,"rowGroup":false,"rowGroupIndex":null,"pivot":false,"pivotIndex":null,"flex":null}]
 
   // 加载列方案
   (0, _react.useEffect)(function () {
-    if (gridPlusColumnState && gridKey && gridPlusColumnState[gridKey] && apiRef.current) {
-      setColumnCellClass(handelgridPlusColumnState(gridPlusColumnState[gridKey]));
-      setTimeout(function () {
-        apiRef.current.applyColumnState({
-          state: gridPlusColumnState[gridKey],
-          applyOrder: true
-        });
-      }, 10);
-    }
-  }, [gridPlusColumnState, apiRef.current]);
+    if (!gridPlusColumnState || !gridKey || !apiRef.current) return;
+    var currentState = gridPlusColumnState[gridKey];
+    if (!currentState) return;
+    setColumnCellClass(handelgridPlusColumnState(currentState));
+    var timer = setTimeout(function () {
+      var _apiRef$current;
+      (_apiRef$current = apiRef.current) === null || _apiRef$current === void 0 || _apiRef$current.applyColumnState({
+        state: currentState,
+        applyOrder: true
+      });
+    }, 10);
+    return function () {
+      return clearTimeout(timer);
+    };
+  }, [gridPlusColumnState, gridKey]);
+
+  // 当 gridApi 就绪且有当前方案时，应用列方案
+  (0, _react.useEffect)(function () {
+    var currentScheme = columnSchemeManager === null || columnSchemeManager === void 0 ? void 0 : columnSchemeManager.currentScheme;
+    if (!apiRef.current || !currentScheme) return;
+    var timer = setTimeout(function () {
+      var _apiRef$current2;
+      (_apiRef$current2 = apiRef.current) === null || _apiRef$current2 === void 0 || _apiRef$current2.applyColumnState({
+        state: currentScheme.columnState,
+        applyOrder: true
+      });
+    }, 10);
+    return function () {
+      return clearTimeout(timer);
+    };
+  }, [columnSchemeManager === null || columnSchemeManager === void 0 ? void 0 : columnSchemeManager.currentScheme]);
   (0, _react.useEffect)(function () {
     setRowData(dataSource || propRowData || []);
   }, [dataSource, propRowData]);
@@ -203,49 +278,252 @@ function AgGridPlus(props) {
   (0, _react.useEffect)(function () {
     loadingProps !== undefined && setLoading(loadingProps);
   }, [loadingProps]);
+
+  // 辅助函数: 获取数据类型
+  var getDataType = function getDataType(data, colName, valueEnum) {
+    if (typeof data[colName] === 'number') {
+      // 如果有枚举值，说明是分类数据，不进行计算;否则默认求和
+      var shouldCalculate = !valueEnum || valueEnum.length === 0;
+      return {
+        type: "number",
+        calculateType: shouldCalculate ? "sum" : false
+      };
+    }
+    return undefined;
+  };
+
+  // 辅助函数: 自定义单元格渲染器
+  var cellRenderer = function cellRenderer(params) {
+    var value = params.value,
+      node = params.node,
+      colDef = params.colDef;
+    //@ts-ignore
+    if (node.isRowPinned() || !colDef.customCellRenderer) {
+      return value;
+    }
+    //@ts-ignore
+    return colDef.customCellRenderer(params);
+  };
+
+  // 获取表格列定义
+  var getTableColumns = function getTableColumns(rowDataList) {
+    var data = rowDataList.length > 0 ? rowDataList[0] : {};
+    var columnProps = _react.default.Children.map(children, function (child, index) {
+      return _objectSpread({}, child.props);
+    });
+    var columnDefs = !columnProps ? props.columnDefs ? props.columnDefs : [] : columnProps;
+    columnDefs = columnDefs.map(function (col) {
+      var dataType = getDataType(data, col.field || '', col.valueEnum);
+      if (col.valueEnum && Array.isArray(col.valueEnum)) {
+        var _defaultItems$0$value, _defaultItems$;
+        // 统计默认值
+        var valueEnum = col.valueEnum; // 保存引用以便TypeScript理解
+        var defaultItems = valueEnum.filter(function (item) {
+          return item.default;
+        });
+        var isMultiple = defaultItems.length > 1;
+        var defaultValue = isMultiple ? defaultItems.map(function (item) {
+          return item.value;
+        }) : (_defaultItems$0$value = (_defaultItems$ = defaultItems[0]) === null || _defaultItems$ === void 0 ? void 0 : _defaultItems$.value) !== null && _defaultItems$0$value !== void 0 ? _defaultItems$0$value : undefined;
+        var valueFormatter = function valueFormatter(params) {
+          var match = valueEnum.find(function (item) {
+            return item.value == params.value;
+          });
+          return match ? match.label : params.value;
+        };
+        return _objectSpread(_objectSpread(_objectSpread({}, dataType), col), {}, {
+          cellRenderer: function cellRenderer(params) {
+            var match = valueEnum.find(function (item) {
+              return item.value == params.value;
+            });
+            if (match) {
+              var color = match.color || '#ffffff';
+              return /*#__PURE__*/_react.default.createElement("span", {
+                style: {
+                  color: color,
+                  backgroundColor: 'transparent',
+                  fontWeight: 500
+                }
+              }, match.label);
+            }
+            return params.value;
+          },
+          filterParams: _objectSpread(_objectSpread({}, col.filterParams || {}), {}, {
+            valueFormatter: valueFormatter
+          }),
+          searchComponent: _antdV.Select,
+          searchComponentProps: {
+            options: col.valueEnum.map(function (item) {
+              return {
+                label: item.label,
+                value: item.value
+              };
+            }),
+            mode: isMultiple ? "multiple" : undefined,
+            defaultValue: defaultValue
+          }
+        });
+      }
+      if (col.type || typeof col.cellRenderer == "string") {
+        return _objectSpread({}, col);
+      }
+      //@ts-ignore
+      if (col !== null && col !== void 0 && col.ellipsis) {
+        return _objectSpread(_objectSpread({}, col), {}, {
+          cellRenderer: function cellRenderer(_ref) {
+            var value = _ref.value;
+            return /*#__PURE__*/_react.default.createElement(Text, {
+              ellipsis: {
+                tooltip: value
+              },
+              style: {
+                display: 'flex',
+                justifyContent: 'center',
+                alignItems: 'center'
+              }
+            }, value);
+          }
+        });
+      }
+      if (col.cellRenderer) {
+        return _objectSpread(_objectSpread({}, col), {}, {
+          customCellRenderer: col.cellRenderer,
+          cellRenderer: cellRenderer
+        });
+      }
+      return _objectSpread(_objectSpread(_objectSpread({}, dataType), col), {}, {
+        customCellRenderer: col.cellRenderer,
+        cellRenderer: cellRenderer
+      });
+    });
+    extensibleColumns && gridKey && extensibleColumns[gridKey] && extensibleColumns[gridKey].map(function (column) {
+      columnDefs.push({
+        field: column.name,
+        headerName: column.displayName,
+        type: column.propertyType,
+        width: column.width,
+        customCellRenderer: column.cellRenderer,
+        cellRenderer: cellRenderer
+      });
+    });
+    return columnDefs;
+  };
+
+  // 计算所有列定义(包括隐藏的列)
+  var allColDefs = (0, _react.useMemo)(function () {
+    return getTableColumns(rowData);
+  }, [_react.default.Children.count(children), props.columnDefs, extensibleColumns, rowData, gridKey]);
+
+  // 稳定化 gridParams 和 sortColumn 的引用
+  var stableGridParams = (0, _react.useMemo)(function () {
+    return gridParams;
+  }, [JSON.stringify(gridParams)]);
+  var stableSortColumn = (0, _react.useMemo)(function () {
+    return sortColumn;
+  }, [JSON.stringify(sortColumn)]);
   var onGridReady = (0, _react.useCallback)(function (params) {
-    var _apiRef$current;
+    var _apiRef$current3;
     apiRef.current = params.api;
     onReady && onReady(params);
     ///@ts-ignore
     dataSource && setRowData(dataSource);
-    setColumnState((_apiRef$current = apiRef.current) === null || _apiRef$current === void 0 ? void 0 : _apiRef$current.getColumnState());
+    setColumnState((_apiRef$current3 = apiRef.current) === null || _apiRef$current3 === void 0 ? void 0 : _apiRef$current3.getColumnState());
     sortChanged(params.api);
     setReady(true);
   }, [dataSource]);
-  var onRequest = function onRequest(queryFilter) {
+  var onRequest = (0, _react.useCallback)(function (queryFilter) {
+    if (!request) return;
     setLoading(true);
-    var filter = (0, _utils.convertFilterModel)(queryFilter, allColDefs);
-    var params = _objectSpread(_objectSpread({
-      filter: filter
-    }, gridParams), {}, {
-      current: pagination.current,
-      skipCount: pagination.current == 1 ? 0 : (pagination.current - 1) * pagination.pageSize,
-      maxResultCount: pagination.pageSize,
-      sorter: getSort(sortColumn)
+    _logger.logger.debug('开始请求数据', {
+      queryFilter: queryFilter,
+      pagination: pagination
     });
-    request && request(params, undefined, queryFilter).then(function (response) {
-      var _apiRef$current2;
-      var rowData = response.data;
-      var rowCount = response.total;
-      setRowData(rowData);
-      // 刷新所有单元格
-      (_apiRef$current2 = apiRef.current) === null || _apiRef$current2 === void 0 || _apiRef$current2.refreshCells({
-        force: true
+    try {
+      var filter = (0, _utils.convertFilterModel)(queryFilter, allColDefs);
+      var params = _objectSpread(_objectSpread({
+        filter: filter
+      }, stableGridParams), {}, {
+        current: pagination.current,
+        skipCount: pagination.current == 1 ? 0 : (pagination.current - 1) * pagination.pageSize,
+        maxResultCount: pagination.pageSize,
+        sorter: getSort(stableSortColumn)
       });
-      setPagination(_objectSpread(_objectSpread({}, pagination), {}, {
-        total: rowCount
-      }));
-      setLoading(false);
-    }).catch(function () {
+      request(params, undefined, queryFilter).then(function (response) {
+        var _apiRef$current4;
+        // 验证响应数据格式
+        if (!response || _typeof(response) !== 'object') {
+          throw new _errors.GridPlusError('服务器返回数据格式错误', _errors.ErrorType.DATA_FORMAT_ERROR, _errors.ErrorSeverity.HIGH, {
+            response: response
+          });
+        }
+        if (!Array.isArray(response.data)) {
+          throw new _errors.GridPlusError('返回的数据列表格式错误', _errors.ErrorType.DATA_FORMAT_ERROR, _errors.ErrorSeverity.HIGH, {
+            responseData: response.data
+          });
+        }
+        var rowData = response.data;
+        var rowCount = response.total;
+        setRowData(rowData);
+        // 刷新所有单元格
+        (_apiRef$current4 = apiRef.current) === null || _apiRef$current4 === void 0 || _apiRef$current4.refreshCells({
+          force: true
+        });
+        setPagination(function (prev) {
+          return _objectSpread(_objectSpread({}, prev), {}, {
+            total: rowCount
+          });
+        });
+        setLoading(false);
+        _logger.logger.info('数据请求成功', {
+          rowCount: rowCount
+        });
+      }).catch(function (error) {
+        setLoading(false);
+
+        // 包装错误为 GridPlusError
+        var gridError = error instanceof _errors.GridPlusError ? error : new _errors.GridPlusError(error.message || '数据加载失败', error.name === 'NetworkError' || error.code === 'ECONNABORTED' ? _errors.ErrorType.NETWORK_ERROR : _errors.ErrorType.SERVER_ERROR, _errors.ErrorSeverity.MEDIUM, {
+          params: params,
+          originalError: error
+        }, error);
+
+        // 记录错误
+        _logger.logger.error('数据请求失败', gridError.getDetails());
+
+        // 显示用户友好的错误提示
+        _antd.message.error(gridError.getUserMessage());
+
+        // 如果用户提供了错误处理回调,调用它
+        if (props.onError) {
+          props.onError(gridError);
+        }
+      });
+    } catch (error) {
       setLoading(false);
-    });
-  };
+
+      // 处理同步错误(如 convertFilterModel 抛出的错误)
+      var gridError = new _errors.GridPlusError(error instanceof Error ? error.message : '数据处理失败', _errors.ErrorType.DATA_FORMAT_ERROR, _errors.ErrorSeverity.HIGH, {
+        queryFilter: queryFilter,
+        allColDefs: allColDefs
+      }, error instanceof Error ? error : undefined);
+      _logger.logger.error('数据请求处理失败', gridError.getDetails());
+      _antd.message.error(gridError.getUserMessage());
+      if (props.onError) {
+        props.onError(gridError);
+      }
+    }
+  }, [request, stableGridParams, stableSortColumn, pagination.pageSize, pagination.current, allColDefs, props.onError]);
+
+  // 请求数据 - 当 ready 状态变化或 request 函数变化时触发
+  (0, _react.useEffect)(function () {
+    if (ready && request) {
+      onRequest(queryFilter);
+    }
+  }, [ready, request, queryFilter, onRequest]);
   var handelgridPlusColumnState = function handelgridPlusColumnState(columnState) {
     var cellMap = {};
     if ((0, _isArray2.default)(columnState)) {
-      columnState.map(function (item) {
-        if (item.cellClass || item.suppressHeaderFilterButton !== undefined) {
+      columnState.forEach(function (item) {
+        if (item.field && (item.cellClass || item.suppressHeaderFilterButton !== undefined || item.groupName)) {
           // 使用对象存储多个字段的值
           cellMap[item.field] = {
             cellClass: item.cellClass,
@@ -265,19 +543,21 @@ function AgGridPlus(props) {
     });
     setSortColumn(sortedColumn);
   };
-  var onRefresh = function onRefresh() {
-    request && onRequest(queryFilter);
-  };
+  var onRefresh = (0, _react.useCallback)(function () {
+    if (request) {
+      onRequest(queryFilter);
+    }
+  }, [request, onRequest, queryFilter]);
   (0, _react.useEffect)(function () {
     gridRef.current = {
-      onRefresh: function onRefresh() {
-        request && onRequest(queryFilter);
-      }
+      onRefresh: onRefresh
     };
-  }, [queryFilter, JSON.stringify(gridParams), JSON.stringify(sortColumn), pagination]);
+  }, [onRefresh]);
   var onRowChanged = (0, _react.useCallback)(function (e) {
-    props.onSelectionChanged && props.onSelectionChanged(e);
-  }, []);
+    if (props.onSelectionChanged) {
+      props.onSelectionChanged(e);
+    }
+  }, [props.onSelectionChanged]);
   var onRowSelected = (0, _react.useCallback)(function (e) {
     setSelectRow(e.data);
 
@@ -318,8 +598,10 @@ function AgGridPlus(props) {
       });
       onSelectedRowsChange(visibleSelectedRows);
     }
-    props.onRowSelected && props.onRowSelected(e);
-  }, [onSelectedRowsChange, props.getRowId]);
+    if (props.onRowSelected) {
+      props.onRowSelected(e);
+    }
+  }, [onSelectedRowsChange, props.getRowId, props.onRowSelected]);
   var onColumnStateChanged = function onColumnStateChanged(columnState) {
     if (gridKey) {
       onSaveColumnState && onSaveColumnState(gridKey, columnState);
@@ -371,24 +653,27 @@ function AgGridPlus(props) {
       maximumFractionDigits: 2
     });
   };
-
   // sum 求和  avg 平均值  standardDeviation 标准差
   var calculatefun = function calculatefun(calcColFields, displayedData) {
     var calculateArrCopy = [];
     var calculateData = {
       id: (0, _uniqueId2.default)()
     };
-    calcColFields.map(function (i) {
+    calcColFields.forEach(function (i) {
       if (!i.cellRenderer) {
         switch (i.calculateType) {
           case "sum":
-            calculateData[i.field] = i.formatWithCommas ? handelNumber(sumFun(i.field, displayedData).toFixed(i.transactionAmount)) : Number(sumFun(i.field, displayedData).toFixed(i.transactionAmount));
+            var sumPrecision = typeof i.transactionAmount === 'number' ? i.transactionAmount : 2;
+            var sumValue = Number(sumFun(i.field, displayedData).toFixed(sumPrecision));
+            calculateData[i.field] = i.formatWithCommas ? handelNumber(sumValue) : sumValue;
             break;
           case "avg":
-            calculateData[i.field] = Number(avgFun(i.field, displayedData).toFixed(i.transactionAmount));
+            var avgPrecision = typeof i.transactionAmount === 'number' ? i.transactionAmount : 2;
+            calculateData[i.field] = Number(avgFun(i.field, displayedData).toFixed(avgPrecision));
             break;
           case "standardDeviation":
-            calculateData[i.field] = Number(standardDeviationFun(i.field, displayedData).toFixed(i.transactionAmount));
+            var stdPrecision = typeof i.transactionAmount === 'number' ? i.transactionAmount : 2;
+            calculateData[i.field] = Number(standardDeviationFun(i.field, displayedData).toFixed(stdPrecision));
             break;
           default:
             break;
@@ -400,131 +685,7 @@ function AgGridPlus(props) {
     }
     return calculateArrCopy;
   };
-  var getDataType = function getDataType(data, colName, valueEnum) {
-    if (typeof data[colName] === 'number') {
-      // 如果有枚举值，说明是分类数据，不进行计算；否则默认求和
-      var shouldCalculate = !valueEnum || valueEnum.length === 0;
-      return {
-        type: "number",
-        calculateType: shouldCalculate ? "sum" : false
-        // cellStyle: { 'text-align': 'right' } 
-      };
-    }
-    return undefined;
-  };
-  var cellRenderer = function cellRenderer(params) {
-    var value = params.value,
-      node = params.node,
-      colDef = params.colDef;
-    //@ts-ignore
-    if (node.isRowPinned() || !colDef.customCellRenderer) {
-      return value;
-    }
-    //@ts-ignore
-    return colDef.customCellRenderer(params);
-  };
-  var getTableColumns = function getTableColumns(rowDataList) {
-    var data = rowDataList.length > 0 ? rowDataList[0] : {};
-    var columnProps = _react.default.Children.map(children, function (child, index) {
-      return _objectSpread({}, child.props);
-    });
-    var columnDefs = !columnProps ? props.columnDefs ? props.columnDefs : [] : columnProps;
-    columnDefs = columnDefs.map(function (col) {
-      var dataType = getDataType(data, col.field, col.valueEnum);
-      if (col.valueEnum && Array.isArray(col.valueEnum)) {
-        var _defaultItems$0$value, _defaultItems$;
-        // 统计默认值
-        var defaultItems = col.valueEnum.filter(function (item) {
-          return item.default;
-        });
-        var isMultiple = defaultItems.length > 1;
-        var defaultValue = isMultiple ? defaultItems.map(function (item) {
-          return item.value;
-        }) : (_defaultItems$0$value = (_defaultItems$ = defaultItems[0]) === null || _defaultItems$ === void 0 ? void 0 : _defaultItems$.value) !== null && _defaultItems$0$value !== void 0 ? _defaultItems$0$value : undefined;
-        var valueFormatter = function valueFormatter(params) {
-          var match = col.valueEnum.find(function (item) {
-            return item.value == params.value;
-          });
-          return match ? match.label : params.value;
-        };
-        return _objectSpread(_objectSpread(_objectSpread({}, dataType), col), {}, {
-          cellRenderer: function cellRenderer(params) {
-            var match = col.valueEnum.find(function (item) {
-              return item.value == params.value;
-            });
-            if (match) {
-              var color = match.color || '#ffffff';
-              return /*#__PURE__*/_react.default.createElement("span", {
-                style: {
-                  color: color,
-                  backgroundColor: 'transparent',
-                  fontWeight: 500
-                }
-              }, match.label);
-            }
-            return params.value;
-          },
-          filterParams: _objectSpread(_objectSpread({}, col.filterParams || {}), {}, {
-            valueFormatter: valueFormatter
-          }),
-          searchComponent: _antdV.Select,
-          searchComponentProps: {
-            options: col.valueEnum.map(function (item) {
-              return {
-                label: item.label,
-                value: item.value
-              };
-            }),
-            mode: isMultiple ? "multiple" : undefined,
-            defaultValue: defaultValue
-          }
-        });
-      }
-      if (col.type || typeof col.cellRenderer == "string") {
-        return _objectSpread({}, col);
-      }
-      //@ts-ignore
-      if (col !== null && col !== void 0 && col.ellipsis) {
-        return _objectSpread(_objectSpread({}, col), {}, {
-          cellRenderer: function cellRenderer(_ref) {
-            var value = _ref.value;
-            return /*#__PURE__*/_react.default.createElement(Text, {
-              ellipsis: {
-                tooltip: value
-              },
-              style: {
-                display: 'flex',
-                justifyContent: 'center',
-                alignItems: 'center'
-              }
-            }, value);
-          }
-        });
-      }
-      if (col.cellRenderer) {
-        return _objectSpread(_objectSpread({}, col), {}, {
-          customCellRenderer: col.cellRenderer,
-          cellRenderer: cellRenderer
-        });
-      }
-      return _objectSpread(_objectSpread(_objectSpread({}, dataType), col), {}, {
-        customCellRenderer: col.cellRenderer,
-        cellRenderer: cellRenderer
-      });
-    });
-    extensibleColumns && gridKey && extensibleColumns[gridKey] && extensibleColumns[gridKey].map(function (column) {
-      columnDefs.push({
-        field: column.name,
-        headerName: column.displayName,
-        type: column.propertyType,
-        width: column.width,
-        customCellRenderer: column.cellRenderer,
-        cellRenderer: cellRenderer
-      });
-    });
-    return columnDefs;
-  };
-  var calculateSum = function calculateSum() {
+  var calculateSum = (0, _react.useCallback)(function () {
     var displayedData = [];
     if (apiRef.current) {
       apiRef.current.forEachNodeAfterFilter(function (node) {
@@ -532,8 +693,8 @@ function AgGridPlus(props) {
       });
     }
     if (!allColDefs || displayedData.length === 0) {
-      var _apiRef$current3;
-      (_apiRef$current3 = apiRef.current) === null || _apiRef$current3 === void 0 || _apiRef$current3.setGridOption('pinnedBottomRowData', undefined);
+      var _apiRef$current5;
+      (_apiRef$current5 = apiRef.current) === null || _apiRef$current5 === void 0 || _apiRef$current5.setGridOption('pinnedBottomRowData', undefined);
       return;
     }
     var calcColFields = allColDefs.filter(function (col) {
@@ -547,11 +708,11 @@ function AgGridPlus(props) {
       };
     });
     if (calcColFields.length > 0) {
-      var _apiRef$current4;
+      var _apiRef$current6;
       var calculatedValues = calculatefun(calcColFields, displayedData);
-      (_apiRef$current4 = apiRef.current) === null || _apiRef$current4 === void 0 || _apiRef$current4.setGridOption('pinnedBottomRowData', calculatedValues);
+      (_apiRef$current6 = apiRef.current) === null || _apiRef$current6 === void 0 || _apiRef$current6.setGridOption('pinnedBottomRowData', calculatedValues);
     }
-  };
+  }, [allColDefs, calculatefun]);
   var onFilterChanged = function onFilterChanged(event) {
     calculateSum();
   };
@@ -576,16 +737,38 @@ function AgGridPlus(props) {
     });
     var processedColumns = (0, _processColumnGroups.default)(columnDefs);
     return processedColumns;
-  }, [children === null || children === void 0 ? void 0 : children.length, props.columnDefs, extensibleColumns, columnCellClass]);
-  var allColDefs = (0, _react.useMemo)(function () {
-    return getTableColumns(rowData);
-  }, [children === null || children === void 0 ? void 0 : children.length, props.columnDefs, extensibleColumns]);
+  }, [_react.default.Children.count(children), props.columnDefs, extensibleColumns, columnCellClass, rowData]);
+
+  // 构建查询表单项（带 order 属性）
+  var queryFormItems = (0, _react.useMemo)(function () {
+    var _allColDefs$filter;
+    var items = (allColDefs === null || allColDefs === void 0 || (_allColDefs$filter = allColDefs.filter(function (col) {
+      return col.filter !== false && !col.hideInSearch;
+    })) === null || _allColDefs$filter === void 0 ? void 0 : _allColDefs$filter.map(function (col) {
+      var _col$queryField, _col$searchSort;
+      return _objectSpread({
+        field: (_col$queryField = col.queryField) !== null && _col$queryField !== void 0 ? _col$queryField : col.field,
+        headerName: col.headerName,
+        order: (_col$searchSort = col.searchSort) !== null && _col$searchSort !== void 0 ? _col$searchSort : 999
+      }, col);
+    })) || [];
+    console.log('[AgGridPlus] queryFormItems构建:', {
+      allColDefsLength: allColDefs === null || allColDefs === void 0 ? void 0 : allColDefs.length,
+      queryFormItemsLength: items.length,
+      queryFormItems: items
+    });
+    return items;
+  }, [allColDefs]);
+
+  // 使用顺序管理器处理排序
+  var _useQueryOrderManager = (0, _querySchemes.useQueryOrderManager)(queryFormItems, (querySchemeManager === null || querySchemeManager === void 0 || (_querySchemeManager$c = querySchemeManager.currentScheme) === null || _querySchemeManager$c === void 0 ? void 0 : _querySchemeManager$c.itemsOrder) || queryItemsOrder),
+    orderedFormItems = _useQueryOrderManager.orderedFormItems;
   (0, _react.useEffect)(function () {
     calculateSum();
-  }, [allColDefs, rowData]);
+  }, [calculateSum]);
   var rowDataMemo = (0, _react.useMemo)(function () {
     return props.treeData ? (0, _utils.flatten)((0, _utils.toTree)(rowData, treeKeyName !== null && treeKeyName !== void 0 ? treeKeyName : "id", treeParentName !== null && treeParentName !== void 0 ? treeParentName : "parentId"), treeKeyName !== null && treeKeyName !== void 0 ? treeKeyName : "id") : rowData;
-  }, [rowData, props.treeData]);
+  }, [rowData, props.treeData, treeKeyName, treeParentName]);
   var actionDom = toolBarRender && toolBarRender(apiRef.current, (0, _utils.convertFilterModel)(queryFilter, allColDefs), queryFilter, {
     current: pagination.current,
     skipCount: pagination.current == 1 ? 0 : (pagination.current - 1) * pagination.pageSize,
@@ -597,7 +780,27 @@ function AgGridPlus(props) {
       cellRenderer: _customGroupCellRenderer.default
     });
   }, [props.autoGroupColumnDef]);
-  return /*#__PURE__*/_react.default.createElement(_antd.Spin, {
+
+  // 准备 GridPlusContext 的值
+  var gridPlusContextValue = (0, _react.useMemo)(function () {
+    var _querySchemeManager$c2;
+    return {
+      extensibleColumns: extensibleColumns,
+      columnState: gridPlusColumnState,
+      onSaveColumnState: onSaveColumnState,
+      applyToGlobal: applyToGlobal,
+      resetCurrent: resetCurrent,
+      resetAll: resetAll,
+      schemeManager: columnSchemeManager,
+      querySchemeManager: querySchemeManager,
+      currentQueryOrder: (querySchemeManager === null || querySchemeManager === void 0 || (_querySchemeManager$c2 = querySchemeManager.currentScheme) === null || _querySchemeManager$c2 === void 0 ? void 0 : _querySchemeManager$c2.itemsOrder) || queryItemsOrder,
+      updateQueryOrder: setQueryItemsOrder,
+      queryFormItems: queryFormItems
+    };
+  }, [extensibleColumns, gridPlusColumnState, onSaveColumnState, applyToGlobal, resetCurrent, resetAll, columnSchemeManager, querySchemeManager, queryItemsOrder, queryFormItems]);
+  return /*#__PURE__*/_react.default.createElement(_gridContext.GridPlusContext.Provider, {
+    value: gridPlusContextValue
+  }, /*#__PURE__*/_react.default.createElement(_antd.Spin, {
     spinning: loading,
     wrapperClassName: "grid-spin"
   }, /*#__PURE__*/_react.default.createElement("div", {
@@ -609,7 +812,7 @@ function AgGridPlus(props) {
       height: "100%"
     }
   }, search == false ? null : /*#__PURE__*/_react.default.createElement(_queryForm.default, {
-    colDefs: (0, _processFormColumnState.default)(allColDefs),
+    colDefs: (0, _processFormColumnState.default)(orderedFormItems),
     defaultRows: queryDefaultRows,
     columnStates: columnState || [],
     defaultExpand: defaultSearchExpand,
@@ -671,7 +874,7 @@ function AgGridPlus(props) {
       enableCellTextSelection: true,
       ensureDomOrder: true
     },
-    overlayNoRowsTemplate: "<span style=\"\n                                        display: flex; \n                                        justify-content: center; \n                                        align-items: center; \n                                        height: 100%; \n                                        font-size: 14px; \n                                        color: #aaa; \n                                        line-height: 1.5;\n                                        text-align: center;\">\n                                        ".concat(overlayNoRowsTemplateText || '没有找到数据，试试调整筛选条件吧！', "\n                                        </span>"),
+    overlayNoRowsTemplate: (0, _sanitize.createSafeHtmlTemplate)(overlayNoRowsTemplateText || '没有找到数据，试试调整筛选条件吧！'),
     enableRangeSelection: true,
     suppressCopyRowsToClipboard: true,
     autoGroupColumnDef: autoGroupColumnDef
@@ -693,8 +896,8 @@ function AgGridPlus(props) {
     onRowSelected: onRowSelected,
     onDragStopped: function onDragStopped(e) {
       if (apiRef.current) {
-        var _apiRef$current5;
-        var _columnState = (_apiRef$current5 = apiRef.current) === null || _apiRef$current5 === void 0 ? void 0 : _apiRef$current5.getColumnState();
+        var _apiRef$current7;
+        var _columnState = (_apiRef$current7 = apiRef.current) === null || _apiRef$current7 === void 0 ? void 0 : _apiRef$current7.getColumnState();
         setColumnState(_columnState);
 
         // onColumnStateChanged && onColumnStateChanged(columnState)
@@ -741,6 +944,6 @@ function AgGridPlus(props) {
     pageSizeOptions: props.pageSizeOptions || [10, 20, 50, 100, 200, 500, 1000, 10000],
     hideOnSinglePage: false,
     showQuickJumper: false
-  })))));
+  }))))));
 }
 var _default = exports.default = AgGridPlus;