@nokecy/qc-ui-components 0.0.0-stage → 2.0.0-beta.1

package/dist/esm/RuleBuilder/utils/validation.js

@@ -0,0 +1,274 @@
+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; }
+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 _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+/**
+ * 规则验证逻辑
+ */
+
+import { operatorRequiresValue, operatorRequiresValue2, operatorRequiresMultiValue, operatorSupportsValueField, getOperatorsByDataType } from "../constants/operators";
+
+/**
+ * 验证规则组
+ * @param group 规则组
+ * @param fields 字段定义列表
+ * @returns 验证结果
+ */
+export function validateRuleGroup(group, fields) {
+  var errors = [];
+  var warnings = [];
+
+  // 1. 检查规则组不为空
+  if (group.rules.length === 0 && group.groups.length === 0) {
+    warnings.push({
+      path: [],
+      message: '规则组为空，请至少添加一条规则或子规则组'
+    });
+  }
+
+  // 2. 验证每条规则
+  group.rules.forEach(function (rule, index) {
+    var ruleErrors = validateRule(rule, fields);
+    errors.push.apply(errors, _toConsumableArray(ruleErrors.map(function (err) {
+      return _objectSpread(_objectSpread({}, err), {}, {
+        path: [index]
+      });
+    })));
+  });
+
+  // 3. 递归验证嵌套规则组
+  group.groups.forEach(function (nestedGroup, index) {
+    var groupResult = validateRuleGroup(nestedGroup, fields);
+    errors.push.apply(errors, _toConsumableArray(groupResult.errors.map(function (err) {
+      return _objectSpread(_objectSpread({}, err), {}, {
+        path: [index].concat(_toConsumableArray(err.path))
+      });
+    })));
+    warnings.push.apply(warnings, _toConsumableArray(groupResult.warnings.map(function (warn) {
+      return _objectSpread(_objectSpread({}, warn), {}, {
+        path: [index].concat(_toConsumableArray(warn.path))
+      });
+    })));
+  });
+  return {
+    isValid: errors.length === 0,
+    errors: errors,
+    warnings: warnings
+  };
+}
+
+/**
+ * 验证单条规则
+ * @param rule 规则
+ * @param fields 字段定义列表
+ * @returns 错误列表
+ */
+export function validateRule(rule, fields) {
+  var errors = [];
+
+  // 1. 检查字段名是否为空
+  if (!rule.fieldName) {
+    errors.push({
+      path: [],
+      message: '请选择字段',
+      field: rule.fieldName
+    });
+    return errors; // 字段都没选，后续验证无意义
+  }
+
+  // 2. 检查字段是否存在
+  var field = fields.find(function (f) {
+    return f.name === rule.fieldName;
+  });
+  if (!field) {
+    errors.push({
+      path: [],
+      message: "\u5B57\u6BB5 \"".concat(rule.fieldName, "\" \u4E0D\u5B58\u5728"),
+      field: rule.fieldName
+    });
+    return errors;
+  }
+
+  // 3. 检查操作符是否有效
+  var allowedOperators = field.allowedOperators || getOperatorsByDataType(field.dataType);
+  if (!allowedOperators.includes(rule.operator)) {
+    errors.push({
+      path: [],
+      message: "\u5B57\u6BB5 \"".concat(field.displayName, "\" \u4E0D\u652F\u6301\u5F53\u524D\u64CD\u4F5C\u7B26"),
+      field: rule.fieldName
+    });
+  }
+
+  // 比较字段模式：值来自另一个字段，不再校验固定值。@author nokecy
+  if (rule.valueField !== undefined) {
+    errors.push.apply(errors, _toConsumableArray(validateValueField(rule, fields)));
+    return errors;
+  }
+
+  // 4. 检查值是否为空（对于需要值的操作符）
+  if (operatorRequiresValue(rule.operator)) {
+    if (rule.value === undefined || rule.value === null || rule.value === '') {
+      errors.push({
+        path: [],
+        message: '请输入值',
+        field: rule.fieldName
+      });
+    } else {
+      // 验证值的类型
+      var valueTypeError = validateValueType(rule.value, field.dataType);
+      if (valueTypeError) {
+        errors.push({
+          path: [],
+          message: valueTypeError,
+          field: rule.fieldName
+        });
+      }
+    }
+  }
+
+  // 5. 检查第二个值（Between 操作符）
+  if (operatorRequiresValue2(rule.operator)) {
+    if (rule.value2 === undefined || rule.value2 === null || rule.value2 === '') {
+      errors.push({
+        path: [],
+        message: '请输入最大值',
+        field: rule.fieldName
+      });
+    } else {
+      // 验证值的类型
+      var value2TypeError = validateValueType(rule.value2, field.dataType);
+      if (value2TypeError) {
+        errors.push({
+          path: [],
+          message: "\u6700\u5927\u503C: ".concat(value2TypeError),
+          field: rule.fieldName
+        });
+      }
+
+      // 检查范围的合理性
+      if (rule.value !== undefined && rule.value2 !== undefined) {
+        if (field.dataType === 'number' || field.dataType === 'date') {
+          var val1 = field.dataType === 'date' ? new Date(rule.value).getTime() : Number(rule.value);
+          var val2 = field.dataType === 'date' ? new Date(rule.value2).getTime() : Number(rule.value2);
+          if (val1 >= val2) {
+            errors.push({
+              path: [],
+              message: '最小值必须小于最大值',
+              field: rule.fieldName
+            });
+          }
+        }
+      }
+    }
+  }
+
+  // 6. 检查多值（In/NotIn 操作符）
+  if (operatorRequiresMultiValue(rule.operator)) {
+    if (!Array.isArray(rule.value) || rule.value.length === 0) {
+      errors.push({
+        path: [],
+        message: '请至少输入一个值',
+        field: rule.fieldName
+      });
+    } else {
+      // 验证数组中每个值的类型
+      rule.value.forEach(function (val, idx) {
+        var valueTypeError = validateValueType(val, field.dataType);
+        if (valueTypeError) {
+          errors.push({
+            path: [],
+            message: "\u503C ".concat(idx + 1, ": ").concat(valueTypeError),
+            field: rule.fieldName
+          });
+        }
+      });
+    }
+  }
+  return errors;
+}
+
+/**
+ * 验证比较字段模式的规则
+ * @param rule 规则（valueField 已设置）
+ * @param fields 字段定义列表
+ * @returns 错误列表
+ * @author nokecy
+ */
+function validateValueField(rule, fields) {
+  var errors = [];
+  var addError = function addError(message) {
+    return errors.push({
+      path: [],
+      message: message,
+      field: rule.fieldName
+    });
+  };
+  if (!operatorSupportsValueField(rule.operator)) {
+    addError('当前操作符不支持比较字段');
+  }
+  if (rule.value !== undefined && rule.value !== null && rule.value !== '') {
+    addError('固定值和比较字段只能设置一个');
+  }
+  if (!rule.valueField) {
+    addError('请选择比较字段');
+  } else if (!fields.some(function (f) {
+    return f.name === rule.valueField;
+  })) {
+    addError("\u6BD4\u8F83\u5B57\u6BB5 \"".concat(rule.valueField, "\" \u4E0D\u5B58\u5728"));
+  }
+  return errors;
+}
+
+/**
+ * 验证值的类型是否匹配
+ * @param value 值
+ * @param dataType 数据类型
+ * @returns 错误信息，如果有效则返回 undefined
+ */
+function validateValueType(value, dataType) {
+  if (value === null || value === undefined) {
+    return undefined; // null/undefined 在这里不算错误，由其他逻辑处理
+  }
+  switch (dataType) {
+    case 'number':
+      if (typeof value !== 'number' && isNaN(Number(value))) {
+        return '值必须是数字';
+      }
+      break;
+    case 'boolean':
+      if (typeof value !== 'boolean') {
+        return '值必须是布尔值';
+      }
+      break;
+    case 'date':
+      if (!(value instanceof Date) && isNaN(Date.parse(String(value)))) {
+        return '值必须是有效的日期';
+      }
+      break;
+    case 'string':
+      // 字符串类型接受任何值（可以转换为字符串）
+      break;
+    default:
+      break;
+  }
+  return undefined;
+}
+
+/**
+ * 简化的验证（只检查是否有致命错误）
+ * @param group 规则组
+ * @param fields 字段定义列表
+ * @returns 是否有效
+ */
+export function isRuleGroupValid(group, fields) {
+  var result = validateRuleGroup(group, fields);
+  return result.isValid;
+}

package/dist/esm/adapters/index.d.ts

@@ -0,0 +1,2 @@
+/** Backend-neutral pagination contracts. */
+export type { GenericPagedQuery, PagedApiAdapter } from './pagedApiAdapter';

package/dist/esm/adapters/index.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/adapters/pagedApiAdapter.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 分页 API 适配器接口:把库内部的通用分页查询/响应,在"通用形状"与"具体后端形状"
+ * 之间转换。此处只定义通用契约；业务包的 abpPagedApiAdapter 包装保留默认 ABP 行为，其他后端显式注入适配器。
+ * @author nokecy
+ */
+/** 通用分页查询参数(后端无关)。 */
+export interface GenericPagedQuery {
+    /** 跳过条数(偏移量)。 */
+    skipCount?: number;
+    /** 取回条数(页大小)。 */
+    maxResultCount?: number;
+    /** 过滤表达式(已序列化为字符串)。 */
+    filter?: string;
+    /** 排序表达式,如 "name asc"。 */
+    sorter?: string;
+    /** 表格请求的原始筛选对象（请求函数的第三个参数）；需要把它放进后端请求体的适配器才读取。 */
+    record?: any;
+}
+/** 分页 API 适配器。 */
+export interface PagedApiAdapter {
+    /** 通用查询 → 后端请求对象(透传给业务方的 list/request 函数)。 */
+    toRequest(query: GenericPagedQuery): Record<string, any>;
+    /** 后端响应 → 数据项数组。 */
+    getItems<T = any>(response: any): T[];
+    /** 后端响应 → 总条数。 */
+    getTotal(response: any): number;
+}

package/dist/esm/adapters/pagedApiAdapter.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/ag-grid-plus/_utils/boolSelect.d.ts

@@ -0,0 +1,4 @@
+import type { SelectProps } from "antd";
+import React from "react";
+declare const _default: React.ForwardRefExoticComponent<SelectProps<any, import("@rc-component/select").DefaultOptionType> & React.RefAttributes<unknown>>;
+export default _default;

package/dist/esm/ag-grid-plus/_utils/boolSelect.js

@@ -0,0 +1,49 @@
+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; }
+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 _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+import { useControllableValue } from 'ahooks';
+import { Select } from "antd";
+import React from "react";
+
+/**
+ * bool类型的下拉框
+ * @param props 
+ * @param ref 
+ * @returns 
+ */
+import { jsx as _jsx } from "react/jsx-runtime";
+import { jsxs as _jsxs } from "react/jsx-runtime";
+var BoolSelect = function BoolSelect(props, ref) {
+  var _useControllableValue = useControllableValue(props),
+    _useControllableValue2 = _slicedToArray(_useControllableValue, 2),
+    state = _useControllableValue2[0],
+    setState = _useControllableValue2[1];
+  return /*#__PURE__*/_jsx("span", {
+    ref: ref,
+    children: /*#__PURE__*/_jsxs(Select, _objectSpread(_objectSpread({}, props), {}, {
+      value: state,
+      onChange: function onChange(value, option) {
+        var _props$onChange;
+        setState(value);
+        props === null || props === void 0 || (_props$onChange = props.onChange) === null || _props$onChange === void 0 || _props$onChange.call(props, value, option);
+      },
+      children: [/*#__PURE__*/_jsx(Select.Option, {
+        value: true,
+        children: "\u662F"
+      }), /*#__PURE__*/_jsx(Select.Option, {
+        value: false,
+        children: "\u5426"
+      })]
+    }))
+  });
+};
+export default /*#__PURE__*/React.forwardRef(BoolSelect);

package/dist/esm/ag-grid-plus/_utils/customGroupCellRenderer.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+import { CustomCellRendererProps } from 'ag-grid-react';
+declare const CustomGroupCellRenderer: (props: CustomCellRendererProps) => React.JSX.Element;
+export default CustomGroupCellRenderer;

package/dist/esm/ag-grid-plus/_utils/customGroupCellRenderer.js

@@ -0,0 +1,79 @@
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+import React, { useCallback, useEffect, useState } from 'react';
+import { MinusOutlined, PlusOutlined } from '@ant-design/icons';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { jsxs as _jsxs } from "react/jsx-runtime";
+var CustomGroupCellRenderer = function CustomGroupCellRenderer(props) {
+  //@ts-ignore
+  var node = props.node,
+    value = props.value,
+    innerRenderer = props.innerRenderer;
+  var _useState = useState(node.expanded),
+    _useState2 = _slicedToArray(_useState, 2),
+    expanded = _useState2[0],
+    setExpanded = _useState2[1];
+  useEffect(function () {
+    var expandListener = function expandListener(event) {
+      return setExpanded(event.node.expanded);
+    };
+    node.addEventListener('expandedChanged', expandListener);
+    return function () {
+      node.removeEventListener('expandedChanged', expandListener);
+    };
+  }, []);
+  var onClick = useCallback(function () {
+    return node.setExpanded(!node.expanded);
+  }, [node]);
+  return /*#__PURE__*/_jsxs("div", {
+    style: {
+      paddingLeft: "".concat(node.level * 15, "px")
+    },
+    children: [node.group && (expanded ? /*#__PURE__*/_jsx("div", {
+      className: "jf-anticon",
+      onClick: onClick,
+      style: {
+        display: 'inline-flex',
+        borderRadius: '4px',
+        border: '1px solid #00b96b',
+        padding: '2px',
+        transition: 'transform 0.3s ease',
+        transform: 'rotate(0deg)'
+      },
+      children: /*#__PURE__*/_jsx(MinusOutlined, {
+        style: {
+          fontSize: '10px',
+          color: '#00b96b'
+        }
+      })
+    }) : /*#__PURE__*/_jsx("div", {
+      className: "jf-anticon",
+      onClick: onClick,
+      style: {
+        display: 'inline-flex',
+        borderRadius: '4px',
+        border: '1px solid #00b96b',
+        padding: '2px',
+        transition: 'transform 0.3s ease',
+        transform: 'rotate(180deg)'
+      },
+      children: /*#__PURE__*/_jsx(PlusOutlined, {
+        style: {
+          fontSize: '10px',
+          color: '#00b96b'
+        }
+      })
+    })), "\xA0", /*#__PURE__*/_jsx("span", {
+      style: {
+        display: 'inline-block',
+        height: 2,
+        width: "".concat(node.level * 14, "px")
+      }
+    }), innerRenderer ? innerRenderer(props) : value]
+  });
+};
+export default CustomGroupCellRenderer;

package/dist/esm/ag-grid-plus/_utils/processColumnGroups.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 处理列分组配置
+ * 兼容新旧两种数据格式：
+ * 1. 新格式：FlatColumnItem[] (带有 type, parentId, level)
+ * 2. 旧格式：{ groupName: string } (简单的分组名称)
+ *
+ * @param columns 列配置数组
+ * @param originalColumnDefs 原始列定义数组（可选），用于保留自定义属性
+ * @returns AG-Grid 列定义
+ */
+declare const processColumnGroups: (columns: any[], originalColumnDefs?: any[]) => any;
+export default processColumnGroups;

package/dist/esm/ag-grid-plus/_utils/processColumnGroups.js

@@ -0,0 +1,108 @@
+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 _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+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; }
+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); }
+import { flatConfigToGridState, isOldSchemeData, migrateOldScheme } from "../setting/columnGroupUtils";
+
+/**
+ * 处理列分组配置
+ * 兼容新旧两种数据格式：
+ * 1. 新格式：FlatColumnItem[] (带有 type, parentId, level)
+ * 2. 旧格式：{ groupName: string } (简单的分组名称)
+ *
+ * @param columns 列配置数组
+ * @param originalColumnDefs 原始列定义数组（可选），用于保留自定义属性
+ * @returns AG-Grid 列定义
+ */
+var processColumnGroups = function processColumnGroups(columns, originalColumnDefs) {
+  // 如果是空数组，直接返回
+  if (!columns || columns.length === 0) {
+    return [];
+  }
+
+  // 检查是否已经是标准 AG-Grid 格式（带 children 的分组）
+  // 如果列定义中有 children 属性，说明已经是 AG-Grid 标准格式，直接返回
+  var hasStandardGroups = columns.some(function (col) {
+    return col.children && Array.isArray(col.children);
+  });
+  if (hasStandardGroups) {
+    // 标准格式：直接返回，不做任何处理
+    return columns;
+  }
+
+  // 检查是否是新格式（FlatColumnItem）
+  // 注意：不能用 col.type 判断，因为 AG-Grid 列定义也有 type 字段（如 type: 'dateTimeColumn'）
+  // FlatColumnItem 的特征是：有 id, parentId, level, order 等字段，且 type 的值是 'group' 或 'column'
+  var isNewFormat = columns.some(function (col) {
+    return col.id !== undefined && col.level !== undefined && col.order !== undefined && (col.type === 'group' || col.type === 'column');
+  });
+  if (isNewFormat) {
+    // 新格式：使用 flatConfigToGridState 转换，传入原始列定义以保留自定义属性
+    return flatConfigToGridState(columns, originalColumnDefs);
+  }
+
+  // 旧格式：使用旧的处理逻辑
+  // 检查是否需要迁移
+  if (isOldSchemeData(columns)) {
+    // 先迁移到新格式，再转换，传入原始列定义
+    var migrated = migrateOldScheme(columns);
+    return flatConfigToGridState(migrated, originalColumnDefs);
+  }
+
+  // 兼容最原始的格式（groupName）
+  var groupMap = new Map();
+  var result = [];
+  var ungrouped = [];
+  columns.forEach(function (col) {
+    var headerName = col.headerName;
+    if (col.children) {
+      if (!groupMap.has(headerName)) {
+        groupMap.set(headerName, {
+          headerName: headerName,
+          field: "".concat(headerName, "header"),
+          children: []
+        });
+      }
+      // 合并并去重 children
+      var group = groupMap.get(headerName);
+      col.children.forEach(function (child) {
+        if (!group.children.some(function (c) {
+          return c.field === child.field;
+        })) {
+          group.children.push(child);
+        }
+      });
+    } else if (col.groupName) {
+      if (!groupMap.has(col.groupName)) {
+        groupMap.set(col.groupName, {
+          headerName: col.groupName,
+          field: "".concat(col.groupName, "header"),
+          children: []
+        });
+      }
+      var groupCol = _objectSpread({}, col);
+      delete groupCol.groupName;
+      var _group = groupMap.get(col.groupName);
+      if (!_group.children.some(function (c) {
+        return c.field === groupCol.field;
+      })) {
+        _group.children.push(groupCol);
+      }
+    } else {
+      ungrouped.push(col);
+    }
+  });
+
+  // 直接从 groupMap 和 ungrouped 生成结果
+  result.push.apply(result, _toConsumableArray(Array.from(groupMap.values())).concat(ungrouped));
+  return result;
+};
+export default processColumnGroups;

package/dist/esm/ag-grid-plus/_utils/processFormColumnState.d.ts

@@ -0,0 +1,2 @@
+declare const flattenColumnState: (columnState: any[]) => any[];
+export default flattenColumnState;

package/dist/esm/ag-grid-plus/_utils/processFormColumnState.js

@@ -0,0 +1,22 @@
+var flattenColumnState = function flattenColumnState(columnState) {
+  var result = [];
+  var processColumn = function processColumn(column) {
+    // 如果有children属性且不为空，递归处理
+    if (column.children && column.children.length > 0) {
+      // 处理子列
+      column.children.forEach(function (child) {
+        processColumn(child);
+      });
+    } else {
+      // 没有children的列直接添加到结果中
+      result.push(column);
+    }
+  };
+
+  // 处理每一列
+  columnState.forEach(function (column) {
+    processColumn(column);
+  });
+  return result;
+};
+export default flattenColumnState;