@nokecy/qc-ui 1.1.37 → 1.1.39

package/dist/cjs/ag-grid-plus/setting/NameColumnRenderer.js

@@ -8,14 +8,14 @@ var _react = _interopRequireDefault(require("react"));
 var _antd = require("antd");
 var _icons = require("@ant-design/icons");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
-/**
- * 名称列渲染组件
- * 用于在 ArrayTable 中展示带缩进的树形结构
+/**
+ * 名称列渲染组件
+ * 用于在 ArrayTable 中展示带缩进的树形结构
  */
 
-/**
- * 名称列渲染组件
- * 显示节点类型图标、层级缩进和可编辑的名称
+/**
+ * 名称列渲染组件
+ * 显示节点类型图标、层级缩进和可编辑的名称
  */
 var NameColumnRenderer = function NameColumnRenderer(_ref) {
   var value = _ref.value,

package/dist/cjs/ag-grid-plus/setting/QuerySchemeManager.js

@@ -43,16 +43,16 @@ function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o =
 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; }
-/**
- * 查询项数据结构
+/**
+ * 查询项数据结构
  */
 
-/**
- * 方案行数据结构
+/**
+ * 方案行数据结构
  */
 
-/**
- * 查询方案管理组件
+/**
+ * 查询方案管理组件
  */
 var QuerySchemeManager = function QuerySchemeManager(_ref) {
   var gridKey = _ref.gridKey,
@@ -141,8 +141,8 @@ var QuerySchemeManager = function QuerySchemeManager(_ref) {
     }
   }, [visible, currentQueryOrder, queryFormItems, currentScheme, fieldLabelMap]);
 
-  /**
-   * 处理查询项拖拽结束
+  /**
+   * 处理查询项拖拽结束
    */
   var handleQueryRowDragEnd = (0, _react.useCallback)(function (event) {
     var node = event.node,
@@ -176,8 +176,8 @@ var QuerySchemeManager = function QuerySchemeManager(_ref) {
     _antd.message.success('已调整顺序');
   }, [queryItemsData]);
 
-  /**
-   * 隐藏/显示开关渲染器
+  /**
+   * 隐藏/显示开关渲染器
    */
   var HiddenSwitchRenderer = (0, _react.useCallback)(function (props) {
     var item = props.data;
@@ -195,8 +195,8 @@ var QuerySchemeManager = function QuerySchemeManager(_ref) {
     });
   }, []);
 
-  /**
-   * 应用当前顺序和隐藏设置
+  /**
+   * 应用当前顺序和隐藏设置
    */
   var handleApplyOrder = (0, _react.useCallback)( /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee() {
     var editingOrder, hiddenFields, queryConfig, createdAt, updatedAt, schemeWithoutTimestamps, newScheme;
@@ -262,8 +262,8 @@ var QuerySchemeManager = function QuerySchemeManager(_ref) {
     }, _callee, null, [[0, 21]]);
   })), [queryItemsData, currentScheme, saveQueryScheme, gridKey, updateQueryOrder, onClose, setCurrentQueryScheme]);
 
-  /**
-   * 保存为新方案
+  /**
+   * 保存为新方案
    */
   var handleSaveAsNew = (0, _react.useCallback)( /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee2() {
     var editingOrder, hiddenFields, queryConfig, newScheme;
@@ -314,8 +314,8 @@ var QuerySchemeManager = function QuerySchemeManager(_ref) {
     }, _callee2, null, [[3, 14]]);
   })), [schemeName, queryItemsData, saveQueryScheme, gridKey]);
 
-  /**
-   * 开始编辑方案
+  /**
+   * 开始编辑方案
    */
   var handleEdit = (0, _react.useCallback)(function (scheme) {
     setEditingId(scheme.id);
@@ -323,8 +323,8 @@ var QuerySchemeManager = function QuerySchemeManager(_ref) {
     setEditingDescription(scheme.description || '');
   }, []);
 
-  /**
-   * 保存编辑
+  /**
+   * 保存编辑
    */
   var handleSaveEdit = (0, _react.useCallback)( /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee3() {
     var scheme, createdAt, updatedAt, schemeWithoutTimestamps;
@@ -370,8 +370,8 @@ var QuerySchemeManager = function QuerySchemeManager(_ref) {
     }, _callee3, null, [[2, 13]]);
   })), [editingId, editingName, editingDescription, schemes, saveQueryScheme, gridKey]);
 
-  /**
-   * 取消编辑
+  /**
+   * 取消编辑
    */
   var handleCancelEdit = (0, _react.useCallback)(function () {
     setEditingId(null);
@@ -379,8 +379,8 @@ var QuerySchemeManager = function QuerySchemeManager(_ref) {
     setEditingDescription('');
   }, []);
 
-  /**
-   * 删除方案
+  /**
+   * 删除方案
    */
   var handleDelete = (0, _react.useCallback)( /*#__PURE__*/function () {
     var _ref5 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee4(schemeId, schemeName) {
@@ -409,8 +409,8 @@ var QuerySchemeManager = function QuerySchemeManager(_ref) {
     };
   }(), [deleteQueryScheme, gridKey]);
 
-  /**
-   * 设置为默认方案
+  /**
+   * 设置为默认方案
    */
   var handleSetDefault = (0, _react.useCallback)( /*#__PURE__*/function () {
     var _ref6 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee5(schemeId, schemeName) {
@@ -488,8 +488,8 @@ var QuerySchemeManager = function QuerySchemeManager(_ref) {
     };
   }(), [schemes, saveQueryScheme, gridKey]);
 
-  /**
-   * 应用方案
+  /**
+   * 应用方案
    */
   var handleApply = (0, _react.useCallback)( /*#__PURE__*/function () {
     var _ref7 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee6(schemeId) {
@@ -529,8 +529,8 @@ var QuerySchemeManager = function QuerySchemeManager(_ref) {
     };
   }(), [setCurrentQueryScheme, gridKey, schemes, updateQueryOrder]);
 
-  /**
-   * 查询项表格列定义
+  /**
+   * 查询项表格列定义
    */
   var queryColumnDefs = (0, _react.useMemo)(function () {
     return [{
@@ -558,8 +558,8 @@ var QuerySchemeManager = function QuerySchemeManager(_ref) {
     }];
   }, [HiddenSwitchRenderer]);
 
-  /**
-   * 方案名称渲染器
+  /**
+   * 方案名称渲染器
    */
   var SchemeNameRenderer = (0, _react.useCallback)(function (props) {
     var scheme = props.data;
@@ -615,8 +615,8 @@ var QuerySchemeManager = function QuerySchemeManager(_ref) {
     }, "\u7CFB\u7EDF"));
   }, [editingId, editingName, editingDescription, currentScheme, handleSaveEdit, handleCancelEdit]);
 
-  /**
-   * 方案操作渲染器
+  /**
+   * 方案操作渲染器
    */
   var SchemeActionsRenderer = (0, _react.useCallback)(function (props) {
     var scheme = props.data;
@@ -667,8 +667,8 @@ var QuerySchemeManager = function QuerySchemeManager(_ref) {
     })));
   }, [currentScheme, handleApply, handleSetDefault, handleEdit, handleDelete]);
 
-  /**
-   * 方案表格列定义
+  /**
+   * 方案表格列定义
    */
   var schemeColumnDefs = (0, _react.useMemo)(function () {
     return [{

package/dist/cjs/ag-grid-plus/setting/columnGroupUtils.js

@@ -14,6 +14,7 @@ exports.isOldSchemeData = isOldSchemeData;
 exports.migrateOldScheme = migrateOldScheme;
 exports.reorderItems = reorderItems;
 var _uniqueId2 = _interopRequireDefault(require("lodash/uniqueId"));
+var _logger = require("../utils/logger");
 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; }
@@ -26,33 +27,31 @@ function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symb
 function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
 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; }
-/**
- * 表头分组配置工具函数
- * 负责 Grid State 与扁平化配置之间的转换
+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; } /**
+ * 表头分组配置工具函数
+ * 负责 Grid State 与扁平化配置之间的转换
  */
-
-/**
- * 生成唯一 ID
+/**
+ * 生成唯一 ID
  */
 var generateId = exports.generateId = function generateId() {
   return (0, _uniqueId2.default)('col_');
 };
 
-/**
- * Grid State → 扁平化配置
- * 将 AG-Grid 的树形结构转换为扁平化数组，用于 UI 展示和编辑
- *
- * @param columnDefs AG-Grid 列定义数组
- * @param originalColumnDefs 原始列定义数组(可选),用于获取 originalHeaderName
- * @returns 扁平化配置数组
+/**
+ * Grid State → 扁平化配置
+ * 将 AG-Grid 的树形结构转换为扁平化数组，用于 UI 展示和编辑
+ *
+ * @param columnDefs AG-Grid 列定义数组
+ * @param originalColumnDefs 原始列定义数组(可选),用于获取 originalHeaderName
+ * @returns 扁平化配置数组
  */
 function gridStateToFlatConfig(columnDefs, originalColumnDefs) {
   var result = [];
   var order = 0;
 
-  /**
-   * 从原始列定义中查找指定字段的原始 headerName
+  /**
+   * 从原始列定义中查找指定字段的原始 headerName
    */
   function findOriginalHeaderName(field, defs) {
     if (!defs || !field) return undefined;
@@ -82,8 +81,8 @@ function gridStateToFlatConfig(columnDefs, originalColumnDefs) {
     return undefined;
   }
 
-  /**
-   * 递归遍历列定义树
+  /**
+   * 递归遍历列定义树
    */
   function traverse(items, level, parentId) {
     items.forEach(function (item) {
@@ -134,22 +133,22 @@ function gridStateToFlatConfig(columnDefs, originalColumnDefs) {
   return result;
 }
 
-/**
- * 扁平化配置 → Grid State
- * 将扁平化数组重建为 AG-Grid 的树形结构
- *
- * 【重要】如果提供了 originalColumnDefs，会合并原始列定义中的所有属性
- * 这样可以保留 cellRenderer、valueFormatter、valueEnum 等自定义渲染属性
- *
- * 【重要】会自动检测并追加代码中新增的列（在 originalColumnDefs 中存在但 flatConfig 中不存在的列）
- *
- * @param flatConfig 扁平化配置数组
- * @param originalColumnDefs 原始列定义数组（可选），用于保留自定义属性和检测新增列
- * @returns AG-Grid 列定义数组
+/**
+ * 扁平化配置 → Grid State
+ * 将扁平化数组重建为 AG-Grid 的树形结构
+ *
+ * 【重要】如果提供了 originalColumnDefs，会合并原始列定义中的所有属性
+ * 这样可以保留 cellRenderer、valueFormatter、valueEnum 等自定义渲染属性
+ *
+ * 【重要】会自动检测并追加代码中新增的列（在 originalColumnDefs 中存在但 flatConfig 中不存在的列）
+ *
+ * @param flatConfig 扁平化配置数组
+ * @param originalColumnDefs 原始列定义数组（可选），用于保留自定义属性和检测新增列
+ * @returns AG-Grid 列定义数组
  */
 function flatConfigToGridState(flatConfig, originalColumnDefs) {
-  /**
-   * 从原始列定义中查找指定字段的列定义（支持递归查找分组内的列）
+  /**
+   * 从原始列定义中查找指定字段的列定义（支持递归查找分组内的列）
    */
   function findOriginalColDef(field, defs) {
     if (!defs) return undefined;
@@ -179,8 +178,8 @@ function flatConfigToGridState(flatConfig, originalColumnDefs) {
     return undefined;
   }
 
-  /**
-   * 递归收集所有列定义（包括分组内的列）
+  /**
+   * 递归收集所有列定义（包括分组内的列）
    */
   function collectAllColumns(defs) {
     var columns = [];
@@ -203,8 +202,8 @@ function flatConfigToGridState(flatConfig, originalColumnDefs) {
     return columns;
   }
 
-  /**
-   * 递归构建树形结构
+  /**
+   * 递归构建树形结构
    */
   function buildTree(parentId) {
     var children = flatConfig.filter(function (item) {
@@ -283,6 +282,12 @@ function flatConfigToGridState(flatConfig, originalColumnDefs) {
       }
     });
     if (newColumnsWithIndex.length > 0) {
+      _logger.logger.debug('[flatConfigToGridState] 检测到新增列，将插入到原始位置:', {
+        newColumnFields: newColumnsWithIndex.map(function (item) {
+          return item.col.field;
+        })
+      });
+
       // 将新增列插入到正确位置（基于其在原始定义中的相对位置）
       var _iterator4 = _createForOfIteratorHelper(newColumnsWithIndex),
         _step4;
@@ -327,12 +332,12 @@ function flatConfigToGridState(flatConfig, originalColumnDefs) {
   return result;
 }
 
-/**
- * 旧版本数据迁移
- * 将旧的 { groupName } 结构迁移为新的树形结构
- *
- * @param oldState 旧版本列配置数组
- * @returns 扁平化配置数组
+/**
+ * 旧版本数据迁移
+ * 将旧的 { groupName } 结构迁移为新的树形结构
+ *
+ * @param oldState 旧版本列配置数组
+ * @returns 扁平化配置数组
  */
 function migrateOldScheme(oldState) {
   var groups = new Map();
@@ -377,13 +382,13 @@ function migrateOldScheme(oldState) {
   return result;
 }
 
-/**
- * 查找节点的所有后代节点的最后一个索引
- * 用于在正确位置插入新子节点
- *
- * @param items 扁平化配置数组
- * @param parentId 父节点 ID
- * @returns 最后一个后代节点的索引，如果没有后代则返回父节点索引
+/**
+ * 查找节点的所有后代节点的最后一个索引
+ * 用于在正确位置插入新子节点
+ *
+ * @param items 扁平化配置数组
+ * @param parentId 父节点 ID
+ * @returns 最后一个后代节点的索引，如果没有后代则返回父节点索引
  */
 function findLastDescendantIndex(items, parentId) {
   var parentIndex = items.findIndex(function (item) {
@@ -405,13 +410,13 @@ function findLastDescendantIndex(items, parentId) {
   return lastIndex;
 }
 
-/**
- * 检查节点是否是其父节点的最后一个子节点
- * 用于渲染缩进符号（├─ 或 └─）
- *
- * @param items 扁平化配置数组
- * @param item 当前节点
- * @returns 是否是最后一个子节点
+/**
+ * 检查节点是否是其父节点的最后一个子节点
+ * 用于渲染缩进符号（├─ 或 └─）
+ *
+ * @param items 扁平化配置数组
+ * @param item 当前节点
+ * @returns 是否是最后一个子节点
  */
 function checkIsLastChild(items, item) {
   if (!item.parentId) return false;
@@ -423,11 +428,11 @@ function checkIsLastChild(items, item) {
   return lastSibling.id === item.id;
 }
 
-/**
- * 重新计算所有节点的 order
- * 确保 order 连续且与数组索引一致
- *
- * @param items 扁平化配置数组
+/**
+ * 重新计算所有节点的 order
+ * 确保 order 连续且与数组索引一致
+ *
+ * @param items 扁平化配置数组
  */
 function reorderItems(items) {
   items.forEach(function (item, index) {
@@ -435,12 +440,12 @@ function reorderItems(items) {
   });
 }
 
-/**
- * 检查是否包含旧版本的 groupName 字段
- * 用于判断是否需要数据迁移
- *
- * @param data 列配置数据
- * @returns 是否是旧版本数据
+/**
+ * 检查是否包含旧版本的 groupName 字段
+ * 用于判断是否需要数据迁移
+ *
+ * @param data 列配置数据
+ * @returns 是否是旧版本数据
  */
 function isOldSchemeData(data) {
   return data.some(function (item) {
@@ -448,19 +453,19 @@ function isOldSchemeData(data) {
   });
 }
 
-/**
- * 扁平化配置 → AG-Grid Column State
- * 将扁平化数组转换为 AG-Grid 的 columnState 格式，用于控制列的顺序和属性
- *
- * 【重要】会自动检测并追加代码中新增的列（在 originalColumnDefs 中存在但 flatConfig 中不存在的列）
- *
- * @param flatConfig 扁平化配置数组
- * @param originalColumnDefs 原始列定义数组（可选），用于检测新增列
- * @returns AG-Grid columnState 数组
+/**
+ * 扁平化配置 → AG-Grid Column State
+ * 将扁平化数组转换为 AG-Grid 的 columnState 格式，用于控制列的顺序和属性
+ *
+ * 【重要】会自动检测并追加代码中新增的列（在 originalColumnDefs 中存在但 flatConfig 中不存在的列）
+ *
+ * @param flatConfig 扁平化配置数组
+ * @param originalColumnDefs 原始列定义数组（可选），用于检测新增列
+ * @returns AG-Grid columnState 数组
  */
 function flatConfigToColumnState(flatConfig, originalColumnDefs) {
-  /**
-   * 递归收集所有列定义（包括分组内的列）
+  /**
+   * 递归收集所有列定义（包括分组内的列）
    */
   function collectAllColumns(defs) {
     var columns = [];
@@ -531,6 +536,12 @@ function flatConfigToColumnState(flatConfig, originalColumnDefs) {
       }
     });
     if (newColumnsWithIndex.length > 0) {
+      _logger.logger.debug('[flatConfigToColumnState] 检测到新增列，将插入到原始位置:', {
+        newColumnFields: newColumnsWithIndex.map(function (item) {
+          return item.col.field;
+        })
+      });
+
       // 将新增列插入到正确位置（基于其在原始定义中的相对位置）
       var _iterator6 = _createForOfIteratorHelper(newColumnsWithIndex),
         _step6;

package/dist/cjs/ag-grid-plus/setting/performanceMonitor.js

@@ -6,9 +6,9 @@ Object.defineProperty(exports, "__esModule", {
 exports.useRenderCounter = exports.measureRenderTime = void 0;
 var _react = _interopRequireDefault(require("react"));
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
-/**
- * 性能监控工具
- * 用于开发和生产环境的渲染性能监控
+/**
+ * 性能监控工具
+ * 用于开发和生产环境的渲染性能监控
  */
 
 var measureRenderTime = exports.measureRenderTime = function measureRenderTime(componentName) {
@@ -35,8 +35,8 @@ var measureRenderTime = exports.measureRenderTime = function measureRenderTime(c
   };
 };
 
-/**
- * 计数组件渲染次数
+/**
+ * 计数组件渲染次数
  */
 var useRenderCounter = exports.useRenderCounter = function useRenderCounter(componentName) {
   var renderCount = _react.default.useRef(0);

package/dist/cjs/ag-grid-plus/shared/storage/backendApiAdapter.js

@@ -17,37 +17,37 @@ function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _d
 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); }
-/**
- * 后端 API 适配器配置
+/**
+ * 后端 API 适配器配置
  */
-/**
- * 内部配置类型(所有字段必填)
+/**
+ * 内部配置类型(所有字段必填)
  */
-/**
- * 后端 API 响应格式 - 基础响应
+/**
+ * 后端 API 响应格式 - 基础响应
  */
-/**
- * 保存方案结果
+/**
+ * 保存方案结果
  */
-/**
- * 删除方案结果
+/**
+ * 删除方案结果
  */
-/**
- * 设置当前方案结果
+/**
+ * 设置当前方案结果
  */
-/**
- * 后端 API 方案存储适配器
- *
- * 特点:
- * - 调用后端细粒度 REST API
- * - 每个操作立即发送请求
- * - 支持错误重试
- * - 自动处理认证
- *
- * 数据格式:
- * - 使用扩展的列配置格式 (columnConfig: FlatColumnItem[])
- * - 包含列分组层级结构
- * - 后端需要存储和返回完整的 columnConfig 数据
+/**
+ * 后端 API 方案存储适配器
+ *
+ * 特点:
+ * - 调用后端细粒度 REST API
+ * - 每个操作立即发送请求
+ * - 支持错误重试
+ * - 自动处理认证
+ *
+ * 数据格式:
+ * - 使用扩展的列配置格式 (columnConfig: FlatColumnItem[])
+ * - 包含列分组层级结构
+ * - 后端需要存储和返回完整的 columnConfig 数据
  */
 var BackendApiSchemeAdapter = exports.BackendApiSchemeAdapter = /*#__PURE__*/function () {
   function BackendApiSchemeAdapter(config) {
@@ -69,8 +69,8 @@ var BackendApiSchemeAdapter = exports.BackendApiSchemeAdapter = /*#__PURE__*/fun
     };
   }
 
-  /**
-   * 日志输出
+  /**
+   * 日志输出
    */
   _createClass(BackendApiSchemeAdapter, [{
     key: "log",
@@ -82,14 +82,14 @@ var BackendApiSchemeAdapter = exports.BackendApiSchemeAdapter = /*#__PURE__*/fun
       }
     }
 
-    /**
-     * 【修复】将 JavaScript 时间戳转换为 ISO 字符串
-     *
-     * JavaScript Date.now() 返回毫秒时间戳（如 1699344567890）
-     * .NET DateTimeOffset 需要 ISO 8601 格式字符串（如 "2023-11-07T08:36:07.890Z"）
-     *
-     * @param timestamp 毫秒时间戳
-     * @returns ISO 8601 格式字符串
+    /**
+     * 【修复】将 JavaScript 时间戳转换为 ISO 字符串
+     *
+     * JavaScript Date.now() 返回毫秒时间戳（如 1699344567890）
+     * .NET DateTimeOffset 需要 ISO 8601 格式字符串（如 "2023-11-07T08:36:07.890Z"）
+     *
+     * @param timestamp 毫秒时间戳
+     * @returns ISO 8601 格式字符串
      */
   }, {
     key: "toIsoString",
@@ -100,11 +100,11 @@ var BackendApiSchemeAdapter = exports.BackendApiSchemeAdapter = /*#__PURE__*/fun
       return new Date(timestamp).toISOString();
     }
 
-    /**
-     * 【修复】将 ISO 字符串转换为 JavaScript 时间戳
-     *
-     * @param isoString ISO 8601 格式字符串
-     * @returns 毫秒时间戳
+    /**
+     * 【修复】将 ISO 字符串转换为 JavaScript 时间戳
+     *
+     * @param isoString ISO 8601 格式字符串
+     * @returns 毫秒时间戳
      */
   }, {
     key: "fromIsoString",
@@ -115,8 +115,8 @@ var BackendApiSchemeAdapter = exports.BackendApiSchemeAdapter = /*#__PURE__*/fun
       return new Date(isoString).getTime();
     }
 
-    /**
-     * 生成请求头
+    /**
+     * 生成请求头
      */
   }, {
     key: "getHeaders",
@@ -131,8 +131,8 @@ var BackendApiSchemeAdapter = exports.BackendApiSchemeAdapter = /*#__PURE__*/fun
       return headers;
     }
 
-    /**
-     * 延迟函数
+    /**
+     * 延迟函数
      */
   }, {
     key: "delay",
@@ -142,8 +142,8 @@ var BackendApiSchemeAdapter = exports.BackendApiSchemeAdapter = /*#__PURE__*/fun
       });
     }
 
-    /**
-     * 发送 HTTP 请求(带重试机制)
+    /**
+     * 发送 HTTP 请求(带重试机制)
      */
   }, {
     key: "request",