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

package/dist/cjs/array-table/index.js

@@ -0,0 +1,653 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _react = _interopRequireWildcard(require("react"));
+var _agGridReact = require("ag-grid-react");
+var _formilyReact = require("@nokecy/formily-react");
+var _uniqueId = _interopRequireDefault(require("lodash/uniqueId"));
+var _locale = require("../ag-grid-plus/locale");
+var _batchRemove = require("./batchRemove");
+var _utils = require("./utils");
+var _columnGroup = require("./columnGroup");
+var _indexColumn = require("./indexColumn");
+var _gridSequence = require("../shared/gridSequence");
+var _rowIdentity = require("./rowIdentity");
+var _hooks = require("./hooks");
+var _arrayBase = _interopRequireDefault(require("./arrayBase"));
+var _arrayAddBtn = _interopRequireDefault(require("./arrayAddBtn"));
+var _preview = _interopRequireDefault(require("./preview"));
+var _antd = require("antd");
+var _index = _interopRequireDefault(require("../ag-grid-plus/setting/index"));
+var _columnGroupUtils = require("../ag-grid-plus/setting/columnGroupUtils");
+var _theme = require("./theme");
+var _fixedGuard = require("./fixedGuard");
+var _rowFeedback = require("./rowFeedback");
+var _index2 = require("../ag-grid-plus/index");
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+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 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; }
+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); } // AG-Grid v33 主题:行高、单元格居中、去聚焦/选区视觉(编辑态与阅读态共用一份,见 theme.ts)
+/** Addition 配置的 defaultValue 只接受普通对象,其余形态按空对象处理。@author nokecy */
+var additionRowDefaults = function additionRowDefaults(value) {
+  return value && _typeof(value) === 'object' && !Array.isArray(value) ? value : {};
+};
+
+//@ts-ignore
+var ArrayTableInner = (0, _formilyReact.observer)(function (props) {
+  var _props$fixedColumnsMa, _ref, _addition$props$title, _addition$props, _addition$schema, _addition$props$metho, _addition$props3, _addition$props4;
+  var height = props.height,
+    gridKey = props.gridKey;
+  var arrayTableTheme = (0, _theme.useArrayTableTheme)(true);
+
+  // 【新增】运行时验证 gridKey
+  if (!gridKey) {
+    console.error('[ArrayTable] gridKey 是必需的属性，用于方案管理和状态持久化');
+    throw new Error('[ArrayTable] gridKey 属性是必需的。请在 x-component-props 中提供 gridKey');
+  }
+  var _useState = (0, _react.useState)(false),
+    _useState2 = _slicedToArray(_useState, 2),
+    isAdd = _useState2[0],
+    setIsAdd = _useState2[1];
+  // 新增行的下标(unshift 时是 0,push 时是末行),新增后据此把表格滚到新行。@author nokecy
+  var addedIndexRef = (0, _react.useRef)(undefined);
+  var apiRef = (0, _react.useRef)(undefined);
+  // 懒挂载激活态:存放当前挂着真控件的单元格 key(`rowId:colId`),供 LazyAgField 经 context 读写:
+  // 点击/导航进来时这里写入,必填且为空的格自己写入,焦点离开且校验通过后自己删除。@author nokecy
+  var activeCellsRef = (0, _react.useRef)(new Set());
+  // 首次渲染先缓存无标识行的 rowId，effect 再补入行数据，供业务克隆时保留。@author nokecy
+  var rowIdMapRef = (0, _react.useRef)(new WeakMap());
+  var ref = (0, _react.useRef)(undefined);
+  var field = (0, _formilyReact.useField)();
+  var _useState3 = (0, _react.useState)(undefined),
+    _useState4 = _slicedToArray(_useState3, 2),
+    gridApiState = _useState4[0],
+    setGridApiState = _useState4[1];
+  var dataSource = Array.isArray(field.value) ? field.value.slice() : [];
+  var schema = (0, _formilyReact.useFieldSchema)();
+
+  // 获取 sources（每次渲染都会重新计算，返回新的数组引用）
+  var rawSources = (0, _utils.useArrayTableSources)();
+  var actions = (0, _utils.useArrayTableActions)();
+
+  // 【关键修复】使用 useMemo 基于内容稳定 sources 引用
+  // 通过 JSON.stringify 比较内容，只有内容真正变化时才返回新引用
+  var sourcesKey = (0, _react.useMemo)(function () {
+    return JSON.stringify(rawSources.map(function (s) {
+      var _s$columnProps$header, _s$columnProps, _s$columnProps2, _s$columnProps3;
+      return {
+        name: s.name,
+        display: s.display,
+        // 列标题可由 reactions 运行时改写,纳入 key 才能让 stableColumnDefs 跟着重建。
+        // 宽度/隐藏/固定由 applyColumnState(方案)管,故意不纳入,避免行编辑时列状态被重置。
+        // 可编辑性:带 x-reactions 的列在 buildArrayTableColumns 里已强制走 AgField 全树(尊重运行时 pattern),无需进 key。@author nokecy
+        headerName: (_s$columnProps$header = (_s$columnProps = s.columnProps) === null || _s$columnProps === void 0 ? void 0 : _s$columnProps.headerName) !== null && _s$columnProps$header !== void 0 ? _s$columnProps$header : (_s$columnProps2 = s.columnProps) === null || _s$columnProps2 === void 0 ? void 0 : _s$columnProps2.title,
+        // 分组名变了列组结构就变,同样要重建。@author nokecy
+        headerGroup: (_s$columnProps3 = s.columnProps) === null || _s$columnProps3 === void 0 ? void 0 : _s$columnProps3.headerGroup
+      };
+    }));
+  }, [rawSources]);
+  var sources = (0, _react.useMemo)(function () {
+    return rawSources;
+  }, [sourcesKey]);
+  //@ts-ignore
+  var onAdd = props.onAdd,
+    onCopy = props.onCopy,
+    onRemove = props.onRemove,
+    onMoveDown = props.onMoveDown,
+    onMoveUp = props.onMoveUp;
+  var addition = (0, _utils.useAddition)();
+  var batchRemove = (0, _batchRemove.useArrayTableBatchRemove)(field, sources, props, apiRef, function (row) {
+    return (0, _rowIdentity.getArrayTableRowId)(row, rowIdMapRef.current);
+  });
+
+  // 有行内错误文字的行撑高,错误文字完整显示在输入框下方(任意行,含最后一行)。
+  // 错误行集合由 Formily 事件驱动更新(不在渲染期读错误,避免订阅整张字段表);行集合变化后让 AG-Grid 重算行高。@author nokecy
+  var _useFeedbackRows = (0, _rowFeedback.useFeedbackRows)(field),
+    feedbackRowsRef = _useFeedbackRows.rowsRef,
+    feedbackSignature = _useFeedbackRows.signature;
+  var getRowHeight = (0, _react.useCallback)(function (params) {
+    return params.data && feedbackRowsRef.current.has(params.data) ? _theme.ARRAY_TABLE_ROW_HEIGHT + _rowFeedback.ROW_FEEDBACK_EXTRA_HEIGHT : _theme.ARRAY_TABLE_ROW_HEIGHT;
+  }, []);
+  (0, _react.useEffect)(function () {
+    gridApiState === null || gridApiState === void 0 || gridApiState.resetRowHeights();
+  }, [feedbackSignature, gridApiState]);
+
+  // 使用自定义 hooks
+  var _useCellFocus = (0, _hooks.useCellFocus)(),
+    focusInputInCell = _useCellFocus.focusInputInCell,
+    scheduleCellFocus = _useCellFocus.scheduleCellFocus,
+    beginFocusRequest = _useCellFocus.beginFocusRequest;
+  var _useRowDrag = (0, _hooks.useRowDrag)(field),
+    handleRowDragMove = _useRowDrag.handleRowDragMove;
+
+  // 直接使用 Context 获取方案管理状态
+  var _useGridSchemes = (0, _index2.useGridSchemes)(),
+    columnSchemes = _useGridSchemes.columnSchemes,
+    querySchemes = _useGridSchemes.querySchemes,
+    currentSchemes = _useGridSchemes.currentSchemes;
+
+  // 获取当前表格的激活方案
+  var currentScheme = (0, _react.useMemo)(function () {
+    var _currentSchemes$props;
+    if (!props.gridKey || !currentSchemes || !columnSchemes) return null;
+    var currentSchemeId = (_currentSchemes$props = currentSchemes[props.gridKey]) === null || _currentSchemes$props === void 0 ? void 0 : _currentSchemes$props.columnSchemeId;
+    if (!currentSchemeId) return null;
+    var schemes = columnSchemes[props.gridKey] || [];
+    return schemes.find(function (s) {
+      return s.id === currentSchemeId;
+    });
+  }, [props.gridKey, currentSchemes, columnSchemes]);
+
+  // 使用 ref 记录上次应用的方案状态，避免重复应用
+  var lastAppliedSchemeRef = (0, _react.useRef)({
+    id: null,
+    updatedAt: undefined
+  });
+
+  /**
+   * 【关键优化】使用 useMemo 稳定 columnDefs 引用
+   * 只在基础列定义(sources)变化时更新，避免数据变化导致列重置
+   * 列的状态(宽度、顺序、隐藏等)由方案通过 applyColumnState 控制，不需要通过 columnDefs 传递
+   */
+  var stableColumnDefs = (0, _react.useMemo)(function () {
+    var _buildArrayTableColum;
+    // 只依赖 sources，不依赖 dataSource 和 field.value
+    var cols = (_buildArrayTableColum = (0, _utils.buildArrayTableColumns)([], field, sources)) !== null && _buildArrayTableColum !== void 0 ? _buildArrayTableColum : [];
+    // 默认在业务列之前加序号列，勾选列由网格放在其左侧；schema 自带序号时不重复加。@author nokecy
+    if (cols.length > 0 && !(0, _indexColumn.hasOwnIndexColumn)(sources)) {
+      cols.unshift((0, _indexColumn.makeIndexColumn)());
+    }
+    //@ts-ignore
+    if (cols.length > 0 && props.onRowDrag) {
+      //@ts-ignore
+      cols[0].rowDrag = true;
+    }
+    return cols;
+  }, [sources, props.onRowDrag]); // 移除 field 依赖，避免数据变化时重新计算
+
+  // 懒挂载的格子不创建 Formily 字段，schema 的 default 不会自己写进值：行出现时补一次（每行只补一次）。@author nokecy
+  var lazyDefaults = (0, _react.useMemo)(function () {
+    return (0, _utils.collectLazyDefaults)(stableColumnDefs);
+  }, [stableColumnDefs]);
+  var defaultedRowsRef = (0, _react.useRef)(new WeakSet());
+  (0, _react.useEffect)(function () {
+    if (lazyDefaults.length > 0) (0, _utils.applyLazyDefaults)(field, lazyDefaults, defaultedRowsRef.current);
+  });
+
+  // 默认值先补齐，再持久化行身份；覆盖初始行及程序追加行，不在渲染/getRowId 中写表单。@author nokecy
+  (0, _react.useEffect)(function () {
+    (0, _rowIdentity.ensureArrayTableRowIds)(field, rowIdMapRef.current);
+  });
+
+  // 交给 AgGridReact 的列定义:按 x-component-props.headerGroup 把相邻同组的列合并成列组(多级表头)。
+  // stableColumnDefs 保持扁平,懒列识别、列方案还原等内部逻辑仍用它;只有喂给 AG-Grid 的这一份带分组。@author nokecy
+  var gridColumnDefs = (0, _react.useMemo)(function () {
+    return (0, _columnGroup.groupColumnDefs)(stableColumnDefs);
+  }, [stableColumnDefs]);
+
+  // 懒挂载:把激活态 Set 通过 AG-Grid context 暴露给 LazyAgField(引用稳定,原地 mutate)。@author nokecy
+  var gridContext = (0, _react.useMemo)(function () {
+    return {
+      activeCells: activeCellsRef.current
+    };
+  }, []);
+
+  // 走懒挂载渲染器的列 id 集合(供点击/键盘导航判断是否需要激活)。@author nokecy
+  var lazyColIds = (0, _react.useMemo)(function () {
+    return new Set(stableColumnDefs.filter(function (c) {
+      var _c$cellRendererParams;
+      return c === null || c === void 0 || (_c$cellRendererParams = c.cellRendererParams) === null || _c$cellRendererParams === void 0 ? void 0 : _c$cellRendererParams.lazyEditable;
+    }).map(function (c) {
+      return c.field;
+    }));
+  }, [stableColumnDefs]);
+
+  /**
+   * 激活某个懒挂载单元格:加入激活集合并强制重渲该格 -> LazyAgField 改挂 AgField 全树。
+   * 焦点离开后 LazyAgField 自己把它从集合里移除并卸回文本(见 utils.tsx)。
+   * 返回 true 表示「本次新激活」(调用方需等挂载完成再聚焦);false 表示无需激活(非懒列/已挂载着,
+   * 如必填且为空的格本就挂着)。新增行的格与存量行一视同仁:非必填的也是先文本、点了才挂。@author nokecy
+   */
+  var activateCell = (0, _react.useCallback)(function (api, node, colId) {
+    if (!api || !node || !colId) return false;
+    if (!lazyColIds.has(colId)) return false; // 非懒列(已是 AgField/纯文本)
+    var key = "".concat(node.id, ":").concat(colId);
+    if (activeCellsRef.current.has(key)) return false; // 已挂载
+    activeCellsRef.current.add(key);
+    api.refreshCells({
+      rowNodes: [node],
+      columns: [colId],
+      force: true
+    });
+    return true;
+  }, [lazyColIds]);
+
+  /**
+   * fixed 别名的宽度保护:固定列总宽超过表格宽度的 fixedColumnsMaxRatio(默认 0.5)时,取消由 fixed 推导的固定列,
+   * 表格变宽后恢复。计算见 fixedGuard.ts;这里只负责取状态、应用变更(applyColumnState)和开发环境告警。
+   * 计算结果与当前状态一致时不调用 AG-Grid API,所以应用引发的列事件不会造成循环。@author nokecy
+   */
+  var fixedMaxRatio = (_props$fixedColumnsMa = props.fixedColumnsMaxRatio) !== null && _props$fixedColumnsMa !== void 0 ? _props$fixedColumnsMa : _fixedGuard.DEFAULT_FIXED_COLUMNS_MAX_RATIO;
+  var derivedSides = (0, _react.useMemo)(function () {
+    var sides = {};
+    stableColumnDefs.forEach(function (c) {
+      var side = (0, _fixedGuard.getFixedDerivedSide)(c);
+      if (side && c.field) sides[c.field] = side;
+    });
+    return sides;
+  }, [stableColumnDefs]);
+  var releasedFixedRef = (0, _react.useRef)(new Set());
+  var warnedFixedRef = (0, _react.useRef)(false);
+  var applyFixedGuard = (0, _react.useCallback)(function (api) {
+    var _ref$current$clientWi, _ref$current, _api$isDestroyed;
+    var viewportWidth = (_ref$current$clientWi = (_ref$current = ref.current) === null || _ref$current === void 0 ? void 0 : _ref$current.clientWidth) !== null && _ref$current$clientWi !== void 0 ? _ref$current$clientWi : 0;
+    if (!api || (_api$isDestroyed = api.isDestroyed) !== null && _api$isDestroyed !== void 0 && _api$isDestroyed.call(api) || viewportWidth <= 0) return;
+    if (Object.keys(derivedSides).length === 0 && releasedFixedRef.current.size === 0) return;
+    var result = (0, _fixedGuard.reconcileFixedColumns)({
+      state: api.getColumnState(),
+      derivedSides: derivedSides,
+      released: releasedFixedRef.current,
+      viewportWidth: viewportWidth,
+      maxRatio: fixedMaxRatio
+    });
+    releasedFixedRef.current = result.released;
+    if (result.changes.length === 0) return;
+    api.applyColumnState({
+      state: result.changes
+    });
+    if (result.newlyReleased.length > 0 && !warnedFixedRef.current && process.env.NODE_ENV !== 'production') {
+      warnedFixedRef.current = true;
+      console.warn("[ArrayTable] gridKey=".concat(gridKey, ": \u56FA\u5B9A\u5217\u603B\u5BBD\u5360\u8868\u683C\u5BBD\u5EA6 ").concat((result.ratio * 100).toFixed(0), "%(\u9608\u503C ").concat((fixedMaxRatio * 100).toFixed(0), "%),") + "\u5217 ".concat(result.newlyReleased.join('、'), " \u7684 fixed \u56E0\u5BBD\u5EA6\u4FDD\u62A4\u88AB\u53D6\u6D88,\u8868\u683C\u53D8\u5BBD\u540E\u4F1A\u6062\u590D\u3002\u8BF7\u5728 schema \u91CC\u7CBE\u7B80 fixed,") + "\u6216\u7528 fixedColumnsMaxRatio(1 \u5173\u95ED\u4FDD\u62A4)\u8C03\u6574\u9608\u503C\u3002");
+    }
+  }, [derivedSides, fixedMaxRatio, gridKey]);
+  // 保护阈值/列集合变了(或表格刚就绪)也要重算一次
+  (0, _react.useEffect)(function () {
+    applyFixedGuard(gridApiState);
+  }, [applyFixedGuard, gridApiState]);
+
+  // 键盘导航 hook 需要 activateCell(导航进懒列时先挂载再聚焦),故置于其后。@author nokecy
+  var _useKeyboardNavigatio = (0, _hooks.useKeyboardNavigation)(ref, dataSource, focusInputInCell, activateCell, beginFocusRequest),
+    handleCellKeyDown = _useKeyboardNavigatio.handleCellKeyDown;
+
+  /**
+   * 方案自动加载
+   *
+   * 参考 ag-gridPlus 优化方案：
+   * 1. 使用 Promise 链确保顺序执行，避免竞态条件
+   * 2. 使用双重 RAF 确保渲染完成
+   * 3. 完整的错误处理和清理机制
+   */
+  (0, _react.useEffect)(function () {
+    // 检查必要条件
+    if (!props.gridKey || !gridApiState) return;
+    // 方案被重置或删除后即时恢复基础列，保留表单实例与未保存的行值。@author nokecy
+    if (!currentScheme) {
+      if (lastAppliedSchemeRef.current.id) {
+        gridApiState.setGridOption('columnDefs', stableColumnDefs);
+        gridApiState.resetColumnState();
+        lastAppliedSchemeRef.current = {
+          id: null,
+          updatedAt: undefined
+        };
+      }
+      return;
+    }
+    if (!currentScheme.columnConfig || currentScheme.columnConfig.length === 0) return;
+
+    // 【关键修复】检查方案是否真正变化（比对 ID 和 updatedAt）
+    // 只有当方案 ID 变化，或者同一方案但 updatedAt 变化时，才重新应用
+    var isSameScheme = currentScheme.id === lastAppliedSchemeRef.current.id;
+    var isSameVersion = currentScheme.updatedAt === lastAppliedSchemeRef.current.updatedAt;
+    if (isSameScheme && isSameVersion) {
+      return;
+    }
+
+    // 使用 Promise 链确保顺序执行，避免竞态条件
+    var cancelled = false;
+    Promise.resolve().then(function () {
+      if (cancelled || !gridApiState) return;
+
+      // 1. 检查是否包含分组配置
+      var hasGroups = currentScheme.columnConfig.some(function (item) {
+        return item.type === 'group';
+      });
+
+      // 如果包含分组，先更新 columnDefs
+      if (hasGroups) {
+        // 传入 stableColumnDefs 作为原始定义,保留 cellRenderer(AgField/LazyAgField)及其
+        // cellRendererParams——否则分组方案重建出的是裸列,单元格退化为纯文本、编辑失效。@author nokecy
+        var _gridColumnDefs = (0, _columnGroupUtils.flatConfigToGridState)(currentScheme.columnConfig, stableColumnDefs);
+        gridApiState.setGridOption('columnDefs', _gridColumnDefs);
+      }
+
+      // 2. 应用列状态（列顺序、宽度、隐藏、固定等）
+      var columnState = (0, _columnGroupUtils.flatConfigToColumnState)(currentScheme.columnConfig);
+      gridApiState.applyColumnState({
+        state: columnState,
+        applyOrder: true
+      });
+      // 在实际应用后立即记账，重置无需等后续 RAF 完成。@author nokecy
+      lastAppliedSchemeRef.current = {
+        id: currentScheme.id,
+        updatedAt: currentScheme.updatedAt
+      };
+    }).then(function () {
+      // 等待 Grid 状态稳定（使用 requestAnimationFrame 而非固定延迟）
+      return new Promise(function (resolve) {
+        if (cancelled) {
+          resolve();
+          return;
+        }
+        requestAnimationFrame(function () {
+          // 双重 RAF 确保渲染完成
+          requestAnimationFrame(function () {
+            return resolve();
+          });
+        });
+      });
+    }).then(function () {
+      if (cancelled || !gridApiState) return;
+
+      // 3. 应用过滤器（在列状态稳定后执行）
+      if (currentScheme.filterModel) {
+        gridApiState.setFilterModel(currentScheme.filterModel);
+      }
+
+      // 【关键修复】记录已应用的方案状态（ID + updatedAt）
+      lastAppliedSchemeRef.current = {
+        id: currentScheme.id,
+        updatedAt: currentScheme.updatedAt
+      };
+    }).catch(function (error) {
+      if (!cancelled) {
+        console.error('[ArrayTable] 应用方案失败:', error);
+      }
+    });
+
+    // 清理函数：取消进行中的操作
+    return function () {
+      cancelled = true;
+    };
+  }, [props.gridKey, gridApiState, currentScheme === null || currentScheme === void 0 ? void 0 : currentScheme.id, currentScheme === null || currentScheme === void 0 ? void 0 : currentScheme.updatedAt]);
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_jsxRuntime.Fragment, {
+    children: /*#__PURE__*/(0, _jsxRuntime.jsx)("div", {
+      ref: ref,
+      style: {
+        height: height ? height : 400,
+        display: 'flex',
+        flexDirection: 'column'
+      },
+      children: /*#__PURE__*/(0, _jsxRuntime.jsxs)(_arrayBase.default, {
+        onAdd: onAdd,
+        onCopy: onCopy,
+        onRemove: onRemove,
+        onMoveUp: onMoveUp,
+        onMoveDown: onMoveDown,
+        children: [/*#__PURE__*/(0, _jsxRuntime.jsxs)("div", {
+          style: {
+            width: '100%',
+            display: 'flex',
+            justifyContent: 'space-between',
+            alignItems: 'center',
+            flexShrink: 0
+          },
+          children: [/*#__PURE__*/(0, _jsxRuntime.jsxs)(_antd.Space, {
+            style: {
+              marginBottom: 5
+            },
+            children: [addition ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_arrayAddBtn.default, _objectSpread(_objectSpread({}, addition.props), {}, {
+              title: (_ref = (_addition$props$title = (_addition$props = addition.props) === null || _addition$props === void 0 ? void 0 : _addition$props.title) !== null && _addition$props$title !== void 0 ? _addition$props$title : (_addition$schema = addition.schema) === null || _addition$schema === void 0 ? void 0 : _addition$schema.title) !== null && _ref !== void 0 ? _ref : '新增'
+              // 新增行总是回到数组顺序，避免当前列排序把空白新行插到旧明细前面；
+              // 先让表格滚到新行,再调用 Addition 节点上自己写的 onAdd,两者都生效。@author nokecy
+              ,
+              onAdd: function onAdd(index) {
+                var _apiRef$current, _addition$props2;
+                addedIndexRef.current = index;
+                setIsAdd(true);
+                (_apiRef$current = apiRef.current) === null || _apiRef$current === void 0 || _apiRef$current.applyColumnState({
+                  defaultState: {
+                    sort: null,
+                    sortIndex: null
+                  }
+                });
+                if (typeof ((_addition$props2 = addition.props) === null || _addition$props2 === void 0 ? void 0 : _addition$props2.onAdd) === 'function') addition.props.onAdd(index);
+              }
+              // 框架关键属性钉在 spread 之后:不可被 addition.props 覆盖;新行默认追加到明细末尾;
+              // defaultValue 合并自定义字段但始终携带 _id/_isNew 标记。@author nokecy
+              ,
+              method: (_addition$props$metho = (_addition$props3 = addition.props) === null || _addition$props3 === void 0 ? void 0 : _addition$props3.method) !== null && _addition$props$metho !== void 0 ? _addition$props$metho : 'push',
+              arrayField: field,
+              schema: schema,
+              defaultValue: _objectSpread({
+                _id: (0, _uniqueId.default)(),
+                _isNew: true
+              }, additionRowDefaults((_addition$props4 = addition.props) === null || _addition$props4 === void 0 ? void 0 : _addition$props4.defaultValue))
+            })) : null, actions.map(function (column, key) {
+              return /*#__PURE__*/(0, _jsxRuntime.jsx)(_formilyReact.RecursionField, {
+                schema: column.schema,
+                name: key,
+                onlyRenderProperties: true
+              });
+            })]
+          }), /*#__PURE__*/(0, _jsxRuntime.jsxs)(_antd.Space, {
+            style: {
+              marginBottom: 5
+            },
+            children: [batchRemove.toolbar, /*#__PURE__*/(0, _jsxRuntime.jsx)(_index.default, {
+              gridKey: props.gridKey,
+              gridApi: apiRef.current,
+              gridApiState: gridApiState,
+              allColDefs: stableColumnDefs,
+              showQueryScheme: false
+            })]
+          })]
+        }), /*#__PURE__*/(0, _jsxRuntime.jsx)("div", {
+          style: {
+            flex: 1,
+            minHeight: 0
+          }
+          // 有出错行时挂标记类,theme.ts 里的单元格内容高度上限只在此时生效,不影响无错误时的 autoHeight 等列。@author nokecy
+          ,
+          className: feedbackSignature ? _theme.ARRAY_TABLE_FEEDBACK_CLASS : undefined,
+          children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_agGridReact.AgGridReact, {
+            theme: arrayTableTheme,
+            localeText: _locale.localeText,
+            context: gridContext,
+            onGridSizeChanged: function onGridSizeChanged(e) {
+              return applyFixedGuard(e.api);
+            },
+            onColumnResized: function onColumnResized(e) {
+              if (e.finished) applyFixedGuard(e.api);
+            },
+            onColumnVisible: function onColumnVisible(e) {
+              return applyFixedGuard(e.api);
+            },
+            onColumnPinned: function onColumnPinned(e) {
+              return applyFixedGuard(e.api);
+            },
+            onNewColumnsLoaded: function onNewColumnsLoaded(e) {
+              // 列定义被整体重设(分组方案等),AG-Grid 按 colDef 重新固定了所有 fixed 列:被取消的记录作废,重新计算
+              releasedFixedRef.current = new Set();
+              applyFixedGuard(e.api);
+            },
+            onGridReady: function onGridReady(params) {
+              var _props$onGridReady;
+              (0, _gridSequence.installDisplaySequenceOrder)(params.api);
+              params.api.hidePopupMenu();
+              apiRef.current = params.api;
+              setGridApiState(params.api);
+              (_props$onGridReady = props.onGridReady) === null || _props$onGridReady === void 0 || _props$onGridReady.call(props, params);
+            },
+            suppressColumnVirtualisation: true,
+            gridOptions: {
+              enableCellTextSelection: true,
+              ensureDomOrder: true,
+              suppressCopyRowsToClipboard: true,
+              suppressCopySingleCellRanges: true,
+              enterNavigatesVertically: true,
+              enterNavigatesVerticallyAfterEdit: true,
+              columnHoverHighlight: true,
+              // 【关键修复】保持用户设置的列顺序
+              maintainColumnOrder: true
+            },
+            onCellKeyDown: handleCellKeyDown,
+            onCellClicked: function onCellClicked(event) {
+              var _event$column$getColI, _event$column, _event$colDef, _event$event;
+              // 懒挂载:点击懒列存量格时先激活挂树,等挂载完成再聚焦进编辑;否则沿用原即时聚焦。@author nokecy
+              var node = event.node;
+              var colId = (_event$column$getColI = (_event$column = event.column) === null || _event$column === void 0 ? void 0 : _event$column.getColId()) !== null && _event$column$getColI !== void 0 ? _event$column$getColI : (_event$colDef = event.colDef) === null || _event$colDef === void 0 ? void 0 : _event$colDef.field;
+              var justActivated = activateCell(event.api, node, colId);
+              var rowIndex = node === null || node === void 0 ? void 0 : node.rowIndex;
+              var clickedCell = (_event$event = event.event) === null || _event$event === void 0 || (_event$event = _event$event.target) === null || _event$event === void 0 ? void 0 : _event$event.closest('.ag-cell');
+              var resolveCell = function resolveCell() {
+                var _ref$current2;
+                // 行虚拟化下 DOM 顺序与 rowIndex 不一致,按 row-index + col-id 属性精确定位刚渲染的格 @author nokecy
+                return justActivated && rowIndex != null ? (_ref$current2 = ref.current) === null || _ref$current2 === void 0 ? void 0 : _ref$current2.querySelector(".ag-row[row-index=\"".concat(rowIndex, "\"] .ag-cell[col-id=\"").concat(colId, "\"]")) : clickedCell;
+              };
+              // 点击、导航共用聚焦请求；旧格等待挂载期间用户已转移焦点或行已更新时，取消旧任务。@author nokecy
+              scheduleCellFocus(resolveCell, justActivated ? 80 : 10, function () {
+                var _ref$current3;
+                if (!((_ref$current3 = ref.current) !== null && _ref$current3 !== void 0 && _ref$current3.isConnected) || event.api.isDestroyed() || rowIndex == null) return false;
+                if (event.api.getDisplayedRowAtIndex(rowIndex) !== node) return false;
+                var focused = event.api.getFocusedCell();
+                return (focused === null || focused === void 0 ? void 0 : focused.rowIndex) === rowIndex && (focused === null || focused === void 0 ? void 0 : focused.column.getColId()) === colId;
+              });
+            },
+            onRowDragMove: handleRowDragMove,
+            onRowDataUpdated: function onRowDataUpdated(e) {
+              var _props$onRowDataUpdat;
+              // 增删行、拖动换行后行位置变了,未改动的行不会自己重算序号,统一刷新序号列 @author nokecy
+              if (stableColumnDefs.some(function (c) {
+                return (c === null || c === void 0 ? void 0 : c.field) === _indexColumn.ARRAY_TABLE_INDEX_FIELD;
+              })) {
+                e.api.refreshCells({
+                  columns: [_indexColumn.ARRAY_TABLE_INDEX_FIELD]
+                });
+              }
+              if (isAdd) {
+                var _addedIndexRef$curren, _apiRef$current2;
+                var addedIndex = (_addedIndexRef$curren = addedIndexRef.current) !== null && _addedIndexRef$curren !== void 0 ? _addedIndexRef$curren : dataSource.length - 1;
+                (_apiRef$current2 = apiRef.current) === null || _apiRef$current2 === void 0 || _apiRef$current2.ensureIndexVisible(addedIndex, addedIndex === 0 ? "top" : "bottom");
+                addedIndexRef.current = undefined;
+                setIsAdd(false);
+              }
+              (_props$onRowDataUpdat = props.onRowDataUpdated) === null || _props$onRowDataUpdat === void 0 || _props$onRowDataUpdat.call(props, e);
+            },
+            rowDragManaged: true,
+            rowSelection: batchRemove.rowSelection,
+            selectionColumnDef: batchRemove.selectionColumnDef,
+            onSelectionChanged: batchRemove.onSelectionChanged,
+            suppressClipboardApi: true,
+            suppressClipboardPaste: true,
+            preventDefaultOnContextMenu: true,
+            enableCellTextSelection: true,
+            defaultColDef: {
+              resizable: true,
+              // 输入框里全选、移动光标、扩选等文字编辑按键交给输入框,不让 AG-Grid 当成表格快捷键拦走
+              suppressKeyboardEvent: _hooks.suppressNativeInputKeys,
+              headerComponentParams: {
+                template: '<div class="ag-cell-label-container" role="presentation">' +
+                // '  <span data-ref="eMenu" class="ag-header-icon ag-header-cell-menu-button" aria-hidden="true"></span>' +
+                '  <div data-ref="eLabel" class="ag-header-cell-label" role="presentation">' + '    <span data-ref="eText" class="ag-header-cell-text"> </span>' +
+                // '    <span data-ref="eFilter" class="ag-header-icon ag-filter-icon"></span>' +
+                // '    <span data-ref="eSortOrder" class="ag-header-icon ag-sort-order"></span>' +
+                '    <span data-ref="eSortAsc" class="ag-header-icon ag-sort-ascending-icon"></span>' + '    <span data-ref="eSortDesc" class="ag-header-icon ag-sort-descending-icon"></span>' + '    <span data-ref="eSortNone" class="ag-header-icon ag-sort-none-icon"></span>' + "  </div>" + "</div>"
+              }
+            },
+            getRowId: function getRowId(_ref2) {
+              var data = _ref2.data;
+              return (0, _rowIdentity.getArrayTableRowId)(data, rowIdMapRef.current);
+            }
+            // rowDragEntireRow={true}
+            // onRowDragEnd={(event) => {
+            //   const { overIndex, node } = event;
+            //   field.move(node.rowIndex!, overIndex);
+            // }}
+            ,
+            onSortChanged: function onSortChanged(event) {
+              var _props$onSortChanged;
+              // 排序只调整显示顺序；表单数组及行身份保持不变，序号按新的显示位置刷新。@author nokecy
+              if (stableColumnDefs.some(function (c) {
+                return (c === null || c === void 0 ? void 0 : c.field) === _indexColumn.ARRAY_TABLE_INDEX_FIELD;
+              })) event.api.refreshCells({
+                columns: [_indexColumn.ARRAY_TABLE_INDEX_FIELD],
+                force: true
+              });
+              (_props$onSortChanged = props.onSortChanged) === null || _props$onSortChanged === void 0 || _props$onSortChanged.call(props, event);
+            },
+            rowHeight: _theme.ARRAY_TABLE_ROW_HEIGHT,
+            getRowHeight: getRowHeight,
+            pagination: false,
+            columnDefs: gridColumnDefs,
+            rowData: dataSource
+          })
+        }), sources.map(function (column, key) {
+          //专门用来承接对Column的状态管理
+          if (!(0, _utils.isColumnComponent)(column.schema)) return;
+          return /*#__PURE__*/_react.default.createElement(_formilyReact.RecursionField, {
+            name: column.name,
+            schema: column.schema,
+            onlyRenderSelf: true,
+            key: key
+          });
+        })]
+      })
+    })
+  });
+});
+ArrayTableInner.displayName = "ArrayTableInner";
+
+/**
+ * ArrayTable 组件
+ *
+ * 注意：需要在外部使用 GridPlusContext.Provider 包裹以提供方案管理功能
+ *
+ * @example
+ * ```tsx
+ * const adapter = useMemo(() => new LocalStorageSchemeAdapter({
+ *   storageKey: `array-table-schemes-${gridKey}`
+ * }), [gridKey]);
+ *
+ * const schemeManager = useSchemeManager({ adapter, autoLoad: true });
+ *
+ * const contextValue = useMemo(() => ({
+ *   extensibleColumns: [],
+ *   columnState: undefined,
+ *   onSaveColumnState: () => {},
+ *   applyToGlobal: () => {},
+ *   resetCurrent: () => {},
+ *   resetAll: () => {},
+ *   queryFormItems: [],
+ *   ...schemeManager
+ * }), [schemeManager]);
+ *
+ * <GridPlusContext.Provider value={contextValue}>
+ *   <ArrayTable gridKey="my-table" height={400} />
+ * </GridPlusContext.Provider>
+ * ```
+ */
+//@ts-ignore
+var ArrayTable = ArrayTableInner;
+ArrayTable.displayName = "ArrayTable";
+ArrayTable.Column = function () {
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_react.Fragment, {});
+};
+_arrayBase.default.mixin(ArrayTable);
+var _default = exports.default = (0, _formilyReact.connect)(ArrayTable, (0, _formilyReact.mapProps)(function (props, field) {
+  return _objectSpread({}, props);
+}), (0, _formilyReact.mapReadPretty)(_preview.default));