@nokecy/qc-ui 1.1.21 → 1.1.23

package/dist/cjs/ag-grid-plus/queryForm/AdvancedQueryBuilder.js

@@ -0,0 +1,547 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _react = _interopRequireDefault(require("react"));
+var _antd = require("antd");
+var _icons = require("@ant-design/icons");
+var _uuid = require("uuid");
+var _dayjs = _interopRequireDefault(require("dayjs"));
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+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 _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 _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it.return != null) it.return(); } finally { if (didErr) throw err; } } }; }
+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; }
+// 字段类型枚举
+
+// 根据字段类型获取可用操作符
+var getOperatorsByFieldType = function getOperatorsByFieldType(fieldType) {
+  var common = [{
+    label: '等于',
+    value: '='
+  }, {
+    label: '不等于',
+    value: '!='
+  }, {
+    label: '为空',
+    value: 'isEmpty'
+  }, {
+    label: '不为空',
+    value: 'isNotEmpty'
+  }];
+  switch (fieldType) {
+    case 'string':
+      return [].concat(common, [{
+        label: '包含',
+        value: 'contains'
+      }, {
+        label: '开头是',
+        value: 'startsWith'
+      }, {
+        label: '结尾是',
+        value: 'endsWith'
+      }]);
+    case 'number':
+      return [].concat(common, [{
+        label: '大于',
+        value: '>'
+      }, {
+        label: '大于等于',
+        value: '>='
+      }, {
+        label: '小于',
+        value: '<'
+      }, {
+        label: '小于等于',
+        value: '<='
+      }, {
+        label: '区间',
+        value: 'between'
+      }]);
+    case 'date':
+      return [].concat(common, [{
+        label: '大于',
+        value: '>'
+      }, {
+        label: '大于等于',
+        value: '>='
+      }, {
+        label: '小于',
+        value: '<'
+      }, {
+        label: '小于等于',
+        value: '<='
+      }, {
+        label: '区间',
+        value: 'between'
+      }]);
+    case 'enum':
+    case 'boolean':
+      // 枚举和布尔只支持等于/不等于
+      return common;
+    default:
+      return common;
+  }
+};
+
+// 推断字段类型
+var inferFieldType = function inferFieldType(colDef) {
+  if (!colDef) return 'string';
+
+  // 有枚举值定义
+  if (colDef.valueEnum && colDef.valueEnum.length > 0) {
+    return 'enum';
+  }
+
+  // 根据 type 判断
+  var type = colDef.type;
+  if (type === 'numberColumn' || type === 'numericColumn') {
+    return 'number';
+  }
+  if (type === 'dateColumn' || type === 'dateTimeColumn') {
+    return 'date';
+  }
+  if (type === 'bool' || type === 'boolColumn') {
+    return 'boolean';
+  }
+
+  // 根据 filter 判断
+  if (colDef.filter === 'agNumberColumnFilter') {
+    return 'number';
+  }
+  if (colDef.filter === 'agDateColumnFilter') {
+    return 'date';
+  }
+  if (colDef.filter === 'boolFilter') {
+    return 'boolean';
+  }
+  return 'string';
+};
+var AdvancedQueryBuilder = function AdvancedQueryBuilder(_ref) {
+  var rootGroup = _ref.rootGroup,
+    onChange = _ref.onChange,
+    colDefs = _ref.colDefs;
+  var updateGroup = function updateGroup(newGroup) {
+    onChange(newGroup);
+  };
+
+  // 更加精确的增删改查
+  var modifyTree = function modifyTree(callback) {
+    var newRoot = JSON.parse(JSON.stringify(rootGroup));
+    callback(newRoot);
+    updateGroup(newRoot);
+  };
+  var findGroup = function findGroup(root, id) {
+    if (root.id === id) return root;
+    if (root.children) {
+      var _iterator = _createForOfIteratorHelper(root.children),
+        _step;
+      try {
+        for (_iterator.s(); !(_step = _iterator.n()).done;) {
+          var child = _step.value;
+          // @ts-ignore
+          if (child.logic) {
+            // @ts-ignore
+            var found = findGroup(child, id);
+            if (found) return found;
+          }
+        }
+      } catch (err) {
+        _iterator.e(err);
+      } finally {
+        _iterator.f();
+      }
+    }
+    return null;
+  };
+  var addRule = function addRule(groupId) {
+    var firstCol = colDefs.find(function (c) {
+      return !c.hide && !c.hideInSearch;
+    });
+    var fieldType = inferFieldType(firstCol);
+    var operators = getOperatorsByFieldType(fieldType);
+    modifyTree(function (root) {
+      var group = findGroup(root, groupId);
+      if (group) {
+        var _operators$;
+        group.children.push({
+          id: (0, _uuid.v4)(),
+          field: (firstCol === null || firstCol === void 0 ? void 0 : firstCol.field) || '',
+          operator: ((_operators$ = operators[0]) === null || _operators$ === void 0 ? void 0 : _operators$.value) || '=',
+          value: null
+        });
+      }
+    });
+  };
+  var addGroup = function addGroup(groupId) {
+    modifyTree(function (root) {
+      var group = findGroup(root, groupId);
+      if (group) {
+        group.children.push({
+          id: (0, _uuid.v4)(),
+          logic: 'AND',
+          children: []
+        });
+      }
+    });
+  };
+  var removeChild = function removeChild(parentId, childId) {
+    modifyTree(function (root) {
+      var group = findGroup(root, parentId);
+      if (group) {
+        group.children = group.children.filter(function (c) {
+          return c.id !== childId;
+        });
+      }
+    });
+  };
+  var updateRule = function updateRule(parentId, ruleId, updates) {
+    modifyTree(function (root) {
+      var group = findGroup(root, parentId);
+      if (group) {
+        var rule = group.children.find(function (c) {
+          return c.id === ruleId;
+        });
+        if (rule) {
+          Object.assign(rule, updates);
+        }
+      }
+    });
+  };
+  var updateGroupLogic = function updateGroupLogic(groupId, logic) {
+    modifyTree(function (root) {
+      var group = findGroup(root, groupId);
+      if (group) {
+        group.logic = logic;
+      }
+    });
+  };
+  var renderValueInput = function renderValueInput(rule, colDef, onValueChange) {
+    if (rule.operator === 'isEmpty' || rule.operator === 'isNotEmpty') {
+      return /*#__PURE__*/_react.default.createElement(_antd.Input, {
+        disabled: true,
+        placeholder: "\u65E0\u9700\u8F93\u5165\u503C",
+        style: {
+          width: '100%'
+        }
+      });
+    }
+
+    // 优先使用列定义的自定义搜索组件
+    if (colDef !== null && colDef !== void 0 && colDef.searchComponent) {
+      var CustomComponent = colDef.searchComponent;
+      // 如果 searchComponent 是 React 组件（函数或类）
+      if (typeof CustomComponent === 'function' || CustomComponent && _typeof(CustomComponent) === 'object') {
+        var componentProps = _objectSpread({
+          value: rule.value,
+          onChange: onValueChange,
+          style: {
+            width: '100%'
+          },
+          allowClear: true,
+          placeholder: colDef.headerName ? "\u8BF7\u9009\u62E9".concat(colDef.headerName) : '请选择'
+        }, colDef.searchComponentProps || {});
+
+        // 渲染自定义组件
+        try {
+          return /*#__PURE__*/_react.default.createElement(CustomComponent, componentProps);
+        } catch (e) {
+          // 如果创建失败，继续使用默认逻辑
+          console.warn('Failed to render custom search component:', e);
+        }
+      }
+    }
+    var fieldType = inferFieldType(colDef);
+
+    // 枚举类型 - 下拉选择
+    if (fieldType === 'enum' && colDef !== null && colDef !== void 0 && colDef.valueEnum) {
+      // 获取默认值
+      var defaultItems = colDef.valueEnum.filter(function (item) {
+        return item.default;
+      });
+      var isMultiple = defaultItems.length > 1;
+      return /*#__PURE__*/_react.default.createElement(_antd.Select, {
+        style: {
+          width: '100%'
+        },
+        value: rule.value,
+        onChange: onValueChange,
+        allowClear: true,
+        mode: isMultiple ? 'multiple' : undefined,
+        placeholder: "\u8BF7\u9009\u62E9"
+      }, colDef.valueEnum.map(function (item) {
+        return /*#__PURE__*/_react.default.createElement(_antd.Select.Option, {
+          key: item.value,
+          value: item.value
+        }, item.label);
+      }));
+    }
+
+    // 布尔类型
+    if (fieldType === 'boolean') {
+      return /*#__PURE__*/_react.default.createElement(_antd.Select, {
+        style: {
+          width: '100%'
+        },
+        value: rule.value,
+        onChange: onValueChange,
+        allowClear: true,
+        placeholder: "\u8BF7\u9009\u62E9"
+      }, /*#__PURE__*/_react.default.createElement(_antd.Select.Option, {
+        value: true
+      }, "\u662F"), /*#__PURE__*/_react.default.createElement(_antd.Select.Option, {
+        value: false
+      }, "\u5426"));
+    }
+
+    // 数字类型
+    if (fieldType === 'number') {
+      if (rule.operator === 'between') {
+        var rangeValue = Array.isArray(rule.value) ? rule.value : [null, null];
+        return /*#__PURE__*/_react.default.createElement(_antd.Space.Compact, {
+          style: {
+            width: '100%'
+          }
+        }, /*#__PURE__*/_react.default.createElement(_antd.InputNumber, {
+          style: {
+            width: '50%'
+          },
+          placeholder: "\u6700\u5C0F\u503C",
+          value: rangeValue[0],
+          onChange: function onChange(val) {
+            return onValueChange([val, rangeValue[1]]);
+          }
+        }), /*#__PURE__*/_react.default.createElement(_antd.InputNumber, {
+          style: {
+            width: '50%'
+          },
+          placeholder: "\u6700\u5927\u503C",
+          value: rangeValue[1],
+          onChange: function onChange(val) {
+            return onValueChange([rangeValue[0], val]);
+          }
+        }));
+      }
+      return /*#__PURE__*/_react.default.createElement(_antd.InputNumber, {
+        style: {
+          width: '100%'
+        },
+        value: rule.value,
+        onChange: onValueChange,
+        placeholder: "\u8BF7\u8F93\u5165\u6570\u5B57"
+      });
+    }
+
+    // 日期类型
+    if (fieldType === 'date') {
+      if (rule.operator === 'between') {
+        return /*#__PURE__*/_react.default.createElement(_antd.DatePicker.RangePicker, {
+          style: {
+            width: '100%'
+          },
+          value: Array.isArray(rule.value) ? [rule.value[0] ? (0, _dayjs.default)(rule.value[0]) : null, rule.value[1] ? (0, _dayjs.default)(rule.value[1]) : null] : [null, null],
+          onChange: function onChange(dates) {
+            if (dates) {
+              var _dates$, _dates$2;
+              onValueChange([(_dates$ = dates[0]) === null || _dates$ === void 0 ? void 0 : _dates$.format('YYYY-MM-DD'), (_dates$2 = dates[1]) === null || _dates$2 === void 0 ? void 0 : _dates$2.format('YYYY-MM-DD')]);
+            } else {
+              onValueChange(null);
+            }
+          }
+        });
+      }
+      return /*#__PURE__*/_react.default.createElement(_antd.DatePicker, {
+        style: {
+          width: '100%'
+        },
+        value: rule.value ? (0, _dayjs.default)(rule.value) : null,
+        onChange: function onChange(date) {
+          return onValueChange(date === null || date === void 0 ? void 0 : date.format('YYYY-MM-DD'));
+        }
+      });
+    }
+
+    // 默认：字符串输入
+    return /*#__PURE__*/_react.default.createElement(_antd.Input, {
+      style: {
+        width: '100%'
+      },
+      value: rule.value,
+      onChange: function onChange(e) {
+        return onValueChange(e.target.value);
+      },
+      allowClear: true,
+      placeholder: "\u8BF7\u8F93\u5165"
+    });
+  };
+  var renderRule = function renderRule(rule, parentGroup, index) {
+    var colDef = colDefs.find(function (c) {
+      return c.field === rule.field;
+    });
+    var fieldType = inferFieldType(colDef);
+    var operators = getOperatorsByFieldType(fieldType);
+
+    // 当切换字段时，需要重置操作符（如果当前操作符在新类型中不可用）
+    var handleFieldChange = function handleFieldChange(newField) {
+      var _newOperators$;
+      var newColDef = colDefs.find(function (c) {
+        return c.field === newField;
+      });
+      var newFieldType = inferFieldType(newColDef);
+      var newOperators = getOperatorsByFieldType(newFieldType);
+
+      // 检查当前操作符是否在新类型中可用
+      var currentOpAvailable = newOperators.some(function (op) {
+        return op.value === rule.operator;
+      });
+      updateRule(parentGroup.id, rule.id, {
+        field: newField,
+        operator: currentOpAvailable ? rule.operator : ((_newOperators$ = newOperators[0]) === null || _newOperators$ === void 0 ? void 0 : _newOperators$.value) || '=',
+        value: null // 重置值
+      });
+    };
+    return /*#__PURE__*/_react.default.createElement(_antd.Row, {
+      gutter: 8,
+      style: {
+        marginBottom: 8,
+        flexWrap: 'nowrap'
+      },
+      align: "middle",
+      wrap: false
+    }, /*#__PURE__*/_react.default.createElement(_antd.Col, {
+      flex: "200px"
+    }, /*#__PURE__*/_react.default.createElement(_antd.Select, {
+      style: {
+        width: '100%'
+      },
+      placeholder: "\u9009\u62E9\u5B57\u6BB5",
+      showSearch: true,
+      optionFilterProp: "children",
+      value: rule.field,
+      onChange: handleFieldChange
+    }, colDefs.filter(function (c) {
+      return !c.hide && !c.hideInSearch;
+    }).map(function (c) {
+      return /*#__PURE__*/_react.default.createElement(_antd.Select.Option, {
+        key: c.field,
+        value: c.field
+      }, c.headerName || c.field);
+    }))), /*#__PURE__*/_react.default.createElement(_antd.Col, {
+      flex: "120px"
+    }, /*#__PURE__*/_react.default.createElement(_antd.Select, {
+      style: {
+        width: '100%'
+      },
+      value: rule.operator,
+      onChange: function onChange(val) {
+        return updateRule(parentGroup.id, rule.id, {
+          operator: val
+        });
+      }
+    }, operators.map(function (op) {
+      return /*#__PURE__*/_react.default.createElement(_antd.Select.Option, {
+        key: op.value,
+        value: op.value
+      }, op.label);
+    }))), /*#__PURE__*/_react.default.createElement(_antd.Col, {
+      flex: "auto"
+    }, renderValueInput(rule, colDef, function (val) {
+      return updateRule(parentGroup.id, rule.id, {
+        value: val
+      });
+    })), /*#__PURE__*/_react.default.createElement(_antd.Col, {
+      flex: "32px"
+    }, /*#__PURE__*/_react.default.createElement(_antd.Button, {
+      type: "text",
+      danger: true,
+      icon: /*#__PURE__*/_react.default.createElement(_icons.DeleteOutlined, null),
+      onClick: function onClick() {
+        return removeChild(parentGroup.id, rule.id);
+      }
+    })));
+  };
+  var renderGroup = function renderGroup(group, parentGroup, indexInParent) {
+    return /*#__PURE__*/_react.default.createElement(_antd.Card, {
+      size: "small",
+      style: {
+        marginBottom: 8,
+        borderLeft: "3px solid ".concat(group.logic === 'AND' ? '#1890ff' : '#52c41a')
+      },
+      bodyStyle: {
+        padding: '8px 12px'
+      }
+    }, /*#__PURE__*/_react.default.createElement("div", {
+      style: {
+        display: 'flex',
+        alignItems: 'center',
+        marginBottom: group.children.length > 0 ? 8 : 0
+      }
+    }, /*#__PURE__*/_react.default.createElement(_antd.Space, {
+      size: "small"
+    }, /*#__PURE__*/_react.default.createElement(_antd.Select, {
+      value: group.logic,
+      onChange: function onChange(val) {
+        return updateGroupLogic(group.id, val);
+      },
+      style: {
+        width: 80
+      },
+      size: "small"
+    }, /*#__PURE__*/_react.default.createElement(_antd.Select.Option, {
+      value: "AND"
+    }, "\u4E14"), /*#__PURE__*/_react.default.createElement(_antd.Select.Option, {
+      value: "OR"
+    }, "\u6216")), /*#__PURE__*/_react.default.createElement(_antd.Button, {
+      type: "dashed",
+      size: "small",
+      icon: /*#__PURE__*/_react.default.createElement(_icons.PlusOutlined, null),
+      onClick: function onClick() {
+        return addRule(group.id);
+      }
+    }, "\u89C4\u5219"), /*#__PURE__*/_react.default.createElement(_antd.Button, {
+      type: "dashed",
+      size: "small",
+      icon: /*#__PURE__*/_react.default.createElement(_icons.PartitionOutlined, null),
+      onClick: function onClick() {
+        return addGroup(group.id);
+      }
+    }, "\u5206\u7EC4")), /*#__PURE__*/_react.default.createElement("div", {
+      style: {
+        flex: 1
+      }
+    }), parentGroup && /*#__PURE__*/_react.default.createElement(_antd.Button, {
+      type: "text",
+      danger: true,
+      size: "small",
+      icon: /*#__PURE__*/_react.default.createElement(_icons.DeleteOutlined, null),
+      onClick: function onClick() {
+        return removeChild(parentGroup.id, group.id);
+      }
+    })), group.children.length > 0 && /*#__PURE__*/_react.default.createElement("div", {
+      style: {
+        paddingLeft: 12,
+        borderLeft: '1px dashed #d9d9d9',
+        marginLeft: 8
+      }
+    }, group.children.map(function (child, idx) {
+      return /*#__PURE__*/_react.default.createElement("div", {
+        key: child.id
+      }, child.logic ? renderGroup(child, group, idx) : renderRule(child, group, idx));
+    })));
+  };
+  return /*#__PURE__*/_react.default.createElement("div", {
+    style: {
+      background: '#fafafa',
+      borderRadius: 4,
+      padding: 8
+    }
+  }, renderGroup(rootGroup, null, 0));
+};
+var _default = exports.default = AdvancedQueryBuilder;

package/dist/cjs/ag-grid-plus/queryForm/index.js

@@ -35,7 +35,7 @@ var FormRender = function FormRender(props) {
     columnStates = props.columnStates,
     onQuery = props.onQuery,
     _props$defaultRows = props.defaultRows,
-    defaultRows = _props$defaultRows === void 0 ? 1 : _props$defaultRows; // 设置默认值为1行
+    defaultRows = _props$defaultRows === void 0 ? 1 : _props$defaultRows;
   var _useState = (0, _react2.useState)({
       type: 'object',
       properties: {}
@@ -80,7 +80,6 @@ var FormRender = function FormRender(props) {
   };
   var onReset = function onReset() {
     // 使用 forceClear: true 强制清空所有字段，包括有默认值的字段
-    // 这样可以确保点击重置时，表单组件显示被完全清空
     form.reset('*', {
       forceClear: true
     });
@@ -199,11 +198,9 @@ var FormRender = function FormRender(props) {
     setSchema(new_schema);
   }, [columnStates === null || columnStates === void 0 ? void 0 : columnStates.map(function (c) {
     return c.colId;
-  }).join('|'), // 列ID变化监听
-  colDefs === null || colDefs === void 0 ? void 0 : colDefs.map(function (c) {
+  }).join('|'), colDefs === null || colDefs === void 0 ? void 0 : colDefs.map(function (c) {
     return "".concat(c.field, "|").concat(c.headerName);
-  }).join('|') // 同时监听字段名和显示名称
-  ]);
+  }).join('|')]);
   return /*#__PURE__*/_react2.default.createElement("div", {
     className: (0, _classnames.default)(className, "ag-grid-table-search ag-grid-table-search-query-filter")
   }, /*#__PURE__*/_react2.default.createElement(_antdV.Form, {

package/dist/cjs/ag-grid-plus/setting/columnGroupUtils.d.ts

@@ -24,8 +24,10 @@ export declare function gridStateToFlatConfig(columnDefs: (ColDef | ColGroupDef)
  * 【重要】如果提供了 originalColumnDefs，会合并原始列定义中的所有属性
  * 这样可以保留 cellRenderer、valueFormatter、valueEnum 等自定义渲染属性
  *
+ * 【重要】会自动检测并追加代码中新增的列（在 originalColumnDefs 中存在但 flatConfig 中不存在的列）
+ *
  * @param flatConfig 扁平化配置数组
- * @param originalColumnDefs 原始列定义数组（可选），用于保留自定义属性
+ * @param originalColumnDefs 原始列定义数组（可选），用于保留自定义属性和检测新增列
  * @returns AG-Grid 列定义数组
  */
 export declare function flatConfigToGridState(flatConfig: FlatColumnItem[], originalColumnDefs?: (ColDef | ColGroupDef)[]): (ColDef | ColGroupDef)[];
@@ -74,7 +76,10 @@ export declare function isOldSchemeData(data: any[]): boolean;
  * 扁平化配置 → AG-Grid Column State
  * 将扁平化数组转换为 AG-Grid 的 columnState 格式，用于控制列的顺序和属性
  *
+ * 【重要】会自动检测并追加代码中新增的列（在 originalColumnDefs 中存在但 flatConfig 中不存在的列）
+ *
  * @param flatConfig 扁平化配置数组
+ * @param originalColumnDefs 原始列定义数组（可选），用于检测新增列
  * @returns AG-Grid columnState 数组
  */
-export declare function flatConfigToColumnState(flatConfig: FlatColumnItem[]): any[];
+export declare function flatConfigToColumnState(flatConfig: FlatColumnItem[], originalColumnDefs?: (ColDef | ColGroupDef)[]): any[];