@visactor/vtable-sheet 1.23.3 → 1.24.0-alpha.0

package/dist/vtable-sheet.js

@@ -1080,34 +1080,29 @@
         }
         evaluateArithmeticWithFunctions(expr) {
             try {
-                const functionMatches = [];
-                const functionRegex = /[A-Z]+\([^)]*\)/g;
-                let match;
-                while ((match = functionRegex.exec(expr)) !== null) {
-                    functionMatches.push({
-                        match: match[0],
-                        start: match.index,
-                        end: match.index + match[0].length
-                    });
-                }
                 let processedExpr = expr;
-                const functionValues = [];
-                for (const funcMatch of functionMatches) {
-                    const funcResult = this.parseExpression(funcMatch.match);
+                let guard = 0;
+                while (true) {
+                    if (guard++ > 1000) {
+                        return { value: null, error: 'Basic arithmetic evaluation failed' };
+                    }
+                    const funcSpan = this.findInnermostFunctionCallSpan(processedExpr);
+                    if (!funcSpan) {
+                        break;
+                    }
+                    const funcCall = processedExpr.slice(funcSpan.start, funcSpan.end + 1);
+                    const funcResult = this.parseExpression(funcCall);
                     if (funcResult.error) {
-                        return { value: null, error: `Error in function ${funcMatch.match}: ${funcResult.error}` };
+                        return { value: null, error: `Error in function ${funcCall}: ${funcResult.error}` };
                     }
-                    functionValues.push(funcResult.value);
-                    processedExpr = processedExpr.replace(funcMatch.match, `__FUNC_${functionValues.length - 1}__`);
+                    processedExpr =
+                        processedExpr.slice(0, funcSpan.start) + String(funcResult.value) + processedExpr.slice(funcSpan.end + 1);
                 }
                 const cellRefs = processedExpr.match(/('[^']+'!)?([A-Za-z0-9_\s一-龥]+!)?[A-Z]+[0-9]+/g) || [];
                 for (const cellRef of cellRefs) {
                     const value = this.getCellValueByA1(cellRef);
                     processedExpr = processedExpr.replace(cellRef, String(value));
                 }
-                for (let i = 0; i < functionValues.length; i++) {
-                    processedExpr = processedExpr.replace(`__FUNC_${i}__`, String(functionValues[i]));
-                }
                 const result = Function('"use strict"; return (' + processedExpr + ')')();
                 return { value: result, error: undefined };
             }
@@ -1115,6 +1110,55 @@
                 return { value: null, error: 'Basic arithmetic evaluation failed' };
             }
         }
+        findInnermostFunctionCallSpan(expr) {
+            const stack = [];
+            let inQuotes = false;
+            let quoteChar = '';
+            for (let i = 0; i < expr.length; i++) {
+                const char = expr[i];
+                if ((char === '"' || char === "'") && (i === 0 || expr[i - 1] !== '\\')) {
+                    if (!inQuotes) {
+                        inQuotes = true;
+                        quoteChar = char;
+                    }
+                    else if (char === quoteChar) {
+                        inQuotes = false;
+                        quoteChar = '';
+                    }
+                    continue;
+                }
+                if (inQuotes) {
+                    continue;
+                }
+                if (char === '(') {
+                    let j = i - 1;
+                    while (j >= 0 && expr[j] === ' ') {
+                        j--;
+                    }
+                    const idEnd = j;
+                    while (j >= 0 && /[A-Za-z0-9]/.test(expr[j])) {
+                        j--;
+                    }
+                    const idStart = j + 1;
+                    let funcStart = null;
+                    if (idStart <= idEnd && /[A-Za-z]/.test(expr[idStart])) {
+                        const beforeChar = idStart > 0 ? expr[idStart - 1] : '';
+                        if (!beforeChar || !/[A-Za-z0-9_]/.test(beforeChar)) {
+                            funcStart = idStart;
+                        }
+                    }
+                    stack.push({ funcStart });
+                    continue;
+                }
+                if (char === ')') {
+                    const frame = stack.pop();
+                    if (frame?.funcStart !== null && frame?.funcStart !== undefined) {
+                        return { start: frame.funcStart, end: i };
+                    }
+                }
+            }
+            return null;
+        }
         getCellValueByA1(a1Notation) {
             try {
                 let sheetKey = this.activeSheetKey || this.reverseSheets.get(0) || 'Sheet1';
@@ -1207,8 +1251,12 @@
                 const startCell = this.parseA1Notation(startParsed.cellRef);
                 const endCell = this.parseA1Notation(endParsed.cellRef);
                 const values = [];
-                for (let row = startCell.row; row <= endCell.row; row++) {
-                    for (let col = startCell.col; col <= endCell.col; col++) {
+                const minRow = Math.min(startCell.row, endCell.row);
+                const maxRow = Math.max(startCell.row, endCell.row);
+                const minCol = Math.min(startCell.col, endCell.col);
+                const maxCol = Math.max(startCell.col, endCell.col);
+                for (let row = minRow; row <= maxRow; row++) {
+                    for (let col = minCol; col <= maxCol; col++) {
                         const cell = { sheet: sheetKey, row, col };
                         values.push(this.getCellValue(cell).value);
                     }
@@ -2601,11 +2649,6 @@
                 newValue = currentValue;
             }
             formulaInput.value = newValue;
-            this.formulaManager.setCellContent({
-                sheet: this.formulaManager.sheet.getActiveSheet().getKey(),
-                row: this.formulaManager.sheet.getActiveSheet().editingCell.row,
-                col: this.formulaManager.sheet.getActiveSheet().editingCell.col
-            }, newValue);
             const newCursorPos = isCtrlAddSelection
                 ? this.formulaManager.lastKnownCursorPosInFormulaInput + (newValue.length - currentValue.length)
                 : argPosition
@@ -4462,7 +4505,7 @@
       has = (object, key) => null != object && hasOwnProperty$a.call(object, key);
     var has$1 = has;
 
-    function cloneDeep$1(value, ignoreWhen, excludeKeys) {
+    function cloneDeep$2(value, ignoreWhen, excludeKeys) {
       let result;
       if (!isValid$2(value) || "object" != typeof value || ignoreWhen && ignoreWhen(value)) return value;
       const isArr = isArray$8(value),
@@ -4473,7 +4516,7 @@
       if (result) for (; ++index < (props || value).length;) {
         const key = props ? props[index] : index,
           subValue = value[key];
-        excludeKeys && excludeKeys.includes(key.toString()) ? result[key] = subValue : result[key] = cloneDeep$1(subValue, ignoreWhen, excludeKeys);
+        excludeKeys && excludeKeys.includes(key.toString()) ? result[key] = subValue : result[key] = cloneDeep$2(subValue, ignoreWhen, excludeKeys);
       }
       return result;
     }
@@ -25870,7 +25913,7 @@
         return this._prevInnerView;
       }
       getBoundsWithoutRender(attributes) {
-        const currentAttribute = cloneDeep$1(this.attribute);
+        const currentAttribute = cloneDeep$2(this.attribute);
         currentAttribute.scale = this.attribute.scale, this.attribute = attributes;
         const offscreenGroup = graphicCreator.group({
           x: this.attribute.x,
@@ -38946,6 +38989,8 @@
       RESIZE_COLUMN_END: "resize_column_end",
       RESIZE_ROW: "resize_row",
       RESIZE_ROW_END: "resize_row_end",
+      MERGE_CELLS: "merge_cells",
+      UNMERGE_CELLS: "unmerge_cells",
       CHANGE_HEADER_POSITION_START: "change_header_position_start",
       CHANGE_HEADER_POSITION: "change_header_position",
       CHANGING_HEADER_POSITION: "changing_header_position",
@@ -41154,7 +41199,7 @@
         if (!this.beforeChangedRecordsMap.has(rawKey)) {
           const rawRecords = Array.isArray(null === (_a = this.dataSourceObj) || void 0 === _a ? void 0 : _a.records) ? this.dataSourceObj.records : null,
             originRecord = rawRecords ? Array.isArray(recordIndex) ? getValueFromDeepArray(rawRecords, recordIndex) : rawRecords[recordIndex] : void 0;
-          this.beforeChangedRecordsMap.set(rawKey, null !== (_b = cloneDeep$1(originRecord, void 0, ["vtable_gantt_linkedFrom", "vtable_gantt_linkedTo"])) && void 0 !== _b ? _b : {});
+          this.beforeChangedRecordsMap.set(rawKey, null !== (_b = cloneDeep$2(originRecord, void 0, ["vtable_gantt_linkedFrom", "vtable_gantt_linkedTo"])) && void 0 !== _b ? _b : {});
         }
         if ("string" == typeof field || "number" == typeof field) {
           const beforeChangedValue = null === (_c = this.beforeChangedRecordsMap.get(rawKey)) || void 0 === _c ? void 0 : _c[field],
@@ -41168,7 +41213,7 @@
         var _a;
         if (!this.beforeChangedRecordsMap.has(dataIndex.toString())) {
           const originRecord = this.getOriginalRecord(dataIndex);
-          this.beforeChangedRecordsMap.set(dataIndex.toString(), null !== (_a = cloneDeep$1(originRecord, void 0, ["vtable_gantt_linkedFrom", "vtable_gantt_linkedTo"])) && void 0 !== _a ? _a : {});
+          this.beforeChangedRecordsMap.set(dataIndex.toString(), null !== (_a = cloneDeep$2(originRecord, void 0, ["vtable_gantt_linkedFrom", "vtable_gantt_linkedTo"])) && void 0 !== _a ? _a : {});
         }
       }
       setRecord(record, index) {
@@ -41439,7 +41484,7 @@
       }
       clearFilteredChildren(record) {
         var _a, _b;
-        record.filteredChildren = void 0;
+        record.filteredChildren = void 0, delete record.filteredChildren;
         for (let i = 0; i < (null !== (_b = null === (_a = record.children) || void 0 === _a ? void 0 : _a.length) && void 0 !== _b ? _b : 0); i++) this.clearFilteredChildren(record.children[i]);
       }
       filterRecord(record) {
@@ -41542,8 +41587,9 @@
       fieldPromiseCallBack(_index, _field, _value) {}
       recordPromiseCallBack(_index, _record) {}
       canChangeOrder(sourceIndex, targetIndex) {
-        var _a;
+        var _a, _b;
         if (null === (_a = this.dataSourceObj) || void 0 === _a ? void 0 : _a.canChangeOrder) return this.dataSourceObj.canChangeOrder(sourceIndex, targetIndex);
+        if (null === (_b = this.lastSortStates) || void 0 === _b ? void 0 : _b.some(state => "asc" === state.order || "desc" === state.order)) return !1;
         if (this.hasHierarchyStateExpand) {
           let sourceIndexs = this.currentPagerIndexedData[sourceIndex],
             targetIndexs = this.currentPagerIndexedData[targetIndex];
@@ -43086,7 +43132,7 @@
       cacheBeforeChangedRecord(dataIndex, table) {
         var _a;
         const originRecord = this.getOriginalRecord(dataIndex);
-        table.internalProps.groupBy && (dataIndex = this.getOriginRecordIndexForGroup(dataIndex)), this.beforeChangedRecordsMap.has(dataIndex.toString()) || this.beforeChangedRecordsMap.set(dataIndex.toString(), null !== (_a = cloneDeep$1(originRecord, void 0, ["vtable_gantt_linkedFrom", "vtable_gantt_linkedTo"])) && void 0 !== _a ? _a : {});
+        table.internalProps.groupBy && (dataIndex = this.getOriginRecordIndexForGroup(dataIndex)), this.beforeChangedRecordsMap.has(dataIndex.toString()) || this.beforeChangedRecordsMap.set(dataIndex.toString(), null !== (_a = cloneDeep$2(originRecord, void 0, ["vtable_gantt_linkedFrom", "vtable_gantt_linkedTo"])) && void 0 !== _a ? _a : {});
       }
       getGroupSeriesNumber(showIndex) {
         const recordIndex = this.dataSource.currentIndexedData[showIndex],
@@ -45546,7 +45592,7 @@
     function updateCell$1(col, row, table, addNew, isShadow, forceFastUpdate) {
       var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r;
       const oldCellGroup = table.scenegraph.highPerformanceGetCell(col, row, !0);
-      if ("cell" !== oldCellGroup.role && !addNew) return;
+      if ("cell" !== oldCellGroup.role && "shadow-cell" !== oldCellGroup.role && !addNew) return;
       const cellLocation = table.getCellLocation(col, row);
       let isMerge,
         range,
@@ -52996,7 +53042,7 @@
       }), scene.tableGroup.role = "table";
       const colHeaderGroup = createContainerGroup(0, 0, !scene.table.internalProps.enableTreeStickCell);
       colHeaderGroup.role = "col-header", scene.colHeaderGroup = colHeaderGroup;
-      const cornerHeaderGroup = createContainerGroup(0, 0, !scene.table.options.enableTreeStickCell);
+      const cornerHeaderGroup = createContainerGroup(0, 0, !scene.table.internalProps.enableTreeStickCell);
       cornerHeaderGroup.role = "corner-header", scene.cornerHeaderGroup = cornerHeaderGroup;
       const rowHeaderGroup = createContainerGroup(0, 0, !0);
       rowHeaderGroup.role = "row-header", scene.rowHeaderGroup = rowHeaderGroup;
@@ -55794,13 +55840,13 @@
       setSortState(sortState) {
         const state = this;
         const sort = (sortState = !sortState || Array.isArray(sortState) ? sortState : [sortState]) && sortState.reduce((prev, item) => {
-          var _a, _b, _c;
+          var _a, _b, _c, _d, _e;
           const column = null === (_a = function (columns) {
             const result = [];
             return function flatten(cols, parentStartIndex = 0) {
               cols.forEach(col => {
                 var _a;
-                const startIndex = col.startInTotal ? null !== (_a = col.startInTotal + state.table.internalProps.layoutMap.leftRowSeriesNumberColumnCount) && void 0 !== _a ? _a : 0 : parentStartIndex;
+                const startIndex = col.startInTotal ? col.startInTotal + (null !== (_a = state.table.internalProps.layoutMap.leftRowSeriesNumberColumnCount) && void 0 !== _a ? _a : 0) : parentStartIndex;
                 col.columns ? flatten(col.columns, startIndex) : result.push(Object.assign(Object.assign({}, col), {
                   startIndex: startIndex
                 }));
@@ -55810,12 +55856,12 @@
           return this.table.internalProps.transpose ? prev.push({
             field: item.field,
             order: item.order,
-            row: null !== (_b = (null == column ? void 0 : column.startInTotal) + this.table.internalProps.layoutMap.leftRowSeriesNumberColumnCount) && void 0 !== _b ? _b : 0,
+            row: (null !== (_b = null == column ? void 0 : column.startInTotal) && void 0 !== _b ? _b : 0) + (null !== (_c = this.table.internalProps.layoutMap.leftRowSeriesNumberColumnCount) && void 0 !== _c ? _c : 0),
             col: null == column ? void 0 : column.level
           }) : prev.push({
             field: item.field,
             order: item.order,
-            col: null !== (_c = (null == column ? void 0 : column.startInTotal) + this.table.internalProps.layoutMap.leftRowSeriesNumberColumnCount) && void 0 !== _c ? _c : 0,
+            col: (null !== (_d = null == column ? void 0 : column.startInTotal) && void 0 !== _d ? _d : 0) + (null !== (_e = this.table.internalProps.layoutMap.leftRowSeriesNumberColumnCount) && void 0 !== _e ? _e : 0),
             row: null == column ? void 0 : column.level
           }), prev;
         }, []);
@@ -56327,13 +56373,16 @@
         this.select.selectInline = selectInline;
       }
       updateSortState(sortState) {
-        var _a, _b, _c, _d, _e, _f, _g, _h;
-        sortState = Array.isArray(sortState) ? sortState : [sortState];
+        var _a, _b, _c, _d, _e, _f, _g;
+        const isSame = (sortState = Array.isArray(sortState) ? sortState : [sortState]).length === this.sort.length && sortState.every((item, index) => {
+          var _a, _b;
+          return (null == item ? void 0 : item.field) === (null === (_a = this.sort[index]) || void 0 === _a ? void 0 : _a.field) && (null == item ? void 0 : item.order) === (null === (_b = this.sort[index]) || void 0 === _b ? void 0 : _b.order);
+        });
+        if (isSame) return;
         for (let index = 0; index < sortState.length; index++) {
-          if (sortState[index].field === (null === (_a = this.sort[index]) || void 0 === _a ? void 0 : _a.field) && sortState[sortState.length - 1].order === (null === (_b = this.sort[index]) || void 0 === _b ? void 0 : _b.order)) return;
-          const oldSortCol = this.table.internalProps.multipleSort ? null : (null === (_c = this.sort[index]) || void 0 === _c ? void 0 : _c.col) || null,
-            oldSortRow = this.table.internalProps.multipleSort ? null : (null === (_d = this.sort[index]) || void 0 === _d ? void 0 : _d.row) || null;
-          "asc" === (null === (_e = this.sort[index]) || void 0 === _e ? void 0 : _e.order) || null === (_f = this.sort[index]) || void 0 === _f || _f.order;
+          const oldSortCol = this.table.internalProps.multipleSort ? null : (null === (_a = this.sort[index]) || void 0 === _a ? void 0 : _a.col) || null,
+            oldSortRow = this.table.internalProps.multipleSort ? null : (null === (_b = this.sort[index]) || void 0 === _b ? void 0 : _b.row) || null;
+          "asc" === (null === (_c = this.sort[index]) || void 0 === _c ? void 0 : _c.order) || null === (_d = this.sort[index]) || void 0 === _d || _d.order;
           this.setSortState(sortState.slice(0, index + 1));
           const cellAddress = this.table.internalProps.layoutMap.getHeaderCellAddressByField(sortState[index].field);
           this.sort[index].col = cellAddress.col, this.sort[index].row = cellAddress.row;
@@ -56346,7 +56395,7 @@
             order: this.sort[index].order,
             oldSortCol: oldSortCol,
             oldSortRow: oldSortRow,
-            oldIconMark: null === (_g = this.sort[index]) || void 0 === _g ? void 0 : _g.icon
+            oldIconMark: null === (_e = this.sort[index]) || void 0 === _e ? void 0 : _e.icon
           });
         }
         const normalHeaders = [];
@@ -56360,7 +56409,7 @@
             row: null,
             iconMark: null,
             order: null,
-            oldSortCol: null !== (_h = column.startInTotal + this.table.internalProps.layoutMap.leftRowSeriesNumberColumnCount) && void 0 !== _h ? _h : 0,
+            oldSortCol: (null !== (_f = column.startInTotal) && void 0 !== _f ? _f : 0) + (null !== (_g = this.table.internalProps.layoutMap.leftRowSeriesNumberColumnCount) && void 0 !== _g ? _g : 0),
             oldSortRow: column.level,
             oldIconMark: null
           });
@@ -59913,7 +59962,7 @@
         sourceColumns.unshift(targetSubIndex, 0), Array.prototype.splice.apply(children, sourceColumns);
       }
       getCopiedTree() {
-        const children = cloneDeep$1(this.tree.children);
+        const children = cloneDeep$2(this.tree.children);
         return clearNode(children), children;
       }
       setAllNodesState(state) {
@@ -60490,11 +60539,11 @@
       onUpdate(end, ratio, out) {
         if (this.from.x !== this.to.x) {
           const x = end ? this.to.x : this.from.x + Math.floor((this.to.x - this.from.x) * ratio);
-          this.params.table.scrollLeft = x;
+          this.params.table.scrollLeft = x, 1 === ratio && -1 !== this.to.targetCol && this.params.table.scrollToCol(this.to.targetCol, !1);
         }
         if (this.from.y !== this.to.y) {
           const y = end ? this.to.y : this.from.y + Math.floor((this.to.y - this.from.y) * ratio);
-          this.params.table.scrollTop = y;
+          this.params.table.scrollTop = y, 1 === ratio && -1 !== this.to.targetRow && this.params.table.scrollToRow(this.to.targetRow, !1);
         }
       }
     }
@@ -60526,7 +60575,9 @@
         colDecimal && (left += colDecimal * cellRect.width), rowDecimal && (top += rowDecimal * cellRect.height);
         const to = {
             x: isNumber$2(col) ? left - this.table.getFrozenColsWidth() : this.table.scrollLeft,
-            y: isNumber$2(row) ? top - this.table.getFrozenRowsHeight() : this.table.scrollTop
+            y: isNumber$2(row) ? top - this.table.getFrozenRowsHeight() : this.table.scrollTop,
+            targetRow: null != rowInt ? rowInt : -1,
+            targetCol: null != colInt ? colInt : -1
           },
           duration = isBoolean$2(animationOption) ? animationOption ? 3e3 : 0 : null !== (_a = null == animationOption ? void 0 : animationOption.duration) && void 0 !== _a ? _a : 3e3,
           easing = isBoolean$2(animationOption) ? animationOption ? "linear" : "" : null !== (_b = null == animationOption ? void 0 : animationOption.easing) && void 0 !== _b ? _b : "linear";
@@ -60541,7 +60592,7 @@
       }
     }
 
-    function getCustomMergeCellFunc(customMergeCell) {
+    function getCustomMergeCellFunc$1(customMergeCell) {
       return isFunction$4(customMergeCell) ? customMergeCell : isArray$8(customMergeCell) ? (col, row) => customMergeCell.find(item => item.range.start.col <= col && item.range.end.col >= col && item.range.start.row <= row && item.range.end.row >= row) : void 0;
     }
 
@@ -60613,7 +60664,7 @@
       }
       constructor(container, options = {}) {
         var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z;
-        if (super(), this.showFrozenIcon = !0, this._tableBorderWidth_left = 0, this._tableBorderWidth_right = 0, this._tableBorderWidth_top = 0, this._tableBorderWidth_bottom = 0, this.version = "1.23.3", this.id = `VTable${Date.now()}`, this.isReleased = !1, this._chartEventMap = {}, this.throttleInvalidate = throttle2(this.render.bind(this), 200), "node" === Env$1.mode ? (options = container, container = null) : container instanceof HTMLElement || (options = container, container = container.container ? container.container : null), !container && "node" !== options.mode && !options.canvas) throw new Error("vtable's container is undefined");
+        if (super(), this.showFrozenIcon = !0, this._scrollToRowCorrectTimer = null, this._tableBorderWidth_left = 0, this._tableBorderWidth_right = 0, this._tableBorderWidth_top = 0, this._tableBorderWidth_bottom = 0, this.version = "1.24.0-alpha.0", this.id = `VTable${Date.now()}`, this.isReleased = !1, this._chartEventMap = {}, this.throttleInvalidate = throttle2(this.render.bind(this), 200), "node" === Env$1.mode ? (options = container, container = null) : container instanceof HTMLElement || (options = container, container = container.container ? container.container : null), !container && "node" !== options.mode && !options.canvas) throw new Error("vtable's container is undefined");
         this.pluginManager = new PluginManager(this, options), this.fireListeners(TABLE_EVENT_TYPE.BEFORE_INIT, {
           options: options,
           container: container
@@ -60730,7 +60781,7 @@
         }
         this.headerStyleCache = new Map(), this.bodyStyleCache = new Map(), this.bodyMergeTitleCache = new Map(), this.bodyBottomStyleCache = new Map(), internalProps.stick = {
           changedCells: new Map()
-        }, internalProps.customMergeCell = getCustomMergeCellFunc(options.customMergeCell);
+        }, internalProps.customMergeCell = getCustomMergeCellFunc$1(options.customMergeCell);
         const CustomCellStylePlugin = Factory.getComponent("customCellStylePlugin");
         CustomCellStylePlugin && (this.customCellStylePlugin = new CustomCellStylePlugin(this, null !== (_y = options.customCellStyle) && void 0 !== _y ? _y : [], null !== (_z = options.customCellStyleArrangement) && void 0 !== _z ? _z : [])), this._adjustCanvasSizeByOption();
       }
@@ -61551,12 +61602,15 @@
       dispose() {
         this.release();
       }
+      clearCorrectTimer() {
+        this._scrollToRowCorrectTimer && (clearTimeout(this._scrollToRowCorrectTimer), this._scrollToRowCorrectTimer = null);
+      }
       release() {
         var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1;
         null === (_c = null === (_b = null === (_a = this.scenegraph) || void 0 === _a ? void 0 : _a.component) || void 0 === _b ? void 0 : _b.vScrollBar) || void 0 === _c || _c.release(), null === (_f = null === (_e = null === (_d = this.scenegraph) || void 0 === _d ? void 0 : _d.component) || void 0 === _e ? void 0 : _e.hScrollBar) || void 0 === _f || _f.release(), this.animationManager.clear(), this.animationManager.ticker.release(), null === (_j = null === (_h = null === (_g = this.scenegraph) || void 0 === _g ? void 0 : _g.stage) || void 0 === _h ? void 0 : _h.ticker) || void 0 === _j || _j.release();
         const internalProps = this.internalProps;
         if (this.isReleased) return;
-        null === (_l = null === (_k = internalProps.tooltipHandler) || void 0 === _k ? void 0 : _k.release) || void 0 === _l || _l.call(_k), null === (_o = null === (_m = internalProps.menuHandler) || void 0 === _m ? void 0 : _m.release) || void 0 === _o || _o.call(_m), null === (_p = super.release) || void 0 === _p || _p.call(this), this.pluginManager.release(), null === (_r = null === (_q = internalProps.handler) || void 0 === _q ? void 0 : _q.release) || void 0 === _r || _r.call(_q), this.eventManager.release(), null === (_t = null === (_s = internalProps.focusControl) || void 0 === _s ? void 0 : _s.release) || void 0 === _t || _t.call(_s), null === (_u = internalProps.legends) || void 0 === _u || _u.forEach(legend => {
+        this.clearCorrectTimer(), null === (_l = null === (_k = internalProps.tooltipHandler) || void 0 === _k ? void 0 : _k.release) || void 0 === _l || _l.call(_k), null === (_o = null === (_m = internalProps.menuHandler) || void 0 === _m ? void 0 : _m.release) || void 0 === _o || _o.call(_m), null === (_p = super.release) || void 0 === _p || _p.call(this), this.pluginManager.release(), null === (_r = null === (_q = internalProps.handler) || void 0 === _q ? void 0 : _q.release) || void 0 === _r || _r.call(_q), this.eventManager.release(), null === (_t = null === (_s = internalProps.focusControl) || void 0 === _s ? void 0 : _s.release) || void 0 === _t || _t.call(_s), null === (_u = internalProps.legends) || void 0 === _u || _u.forEach(legend => {
           null == legend || legend.release();
         }), null === (_v = internalProps.title) || void 0 === _v || _v.release(), internalProps.title = null, null === (_w = internalProps.emptyTip) || void 0 === _w || _w.release(), internalProps.emptyTip = null, internalProps.layoutMap.release(), internalProps.releaseList && (internalProps.releaseList.forEach(releaseObj => {
           var _a;
@@ -61669,7 +61723,7 @@
           const MenuHandler = Factory.getComponent("menuHandler");
           internalProps.menuHandler = new MenuHandler(this);
         }
-        this.clearCellStyleCache(), (null == updateConfig ? void 0 : updateConfig.clearColWidthCache) && this.clearColWidthCache(), (null == updateConfig ? void 0 : updateConfig.clearRowHeightCache) && this.clearRowHeightCache(), internalProps.customMergeCell = getCustomMergeCellFunc(options.customMergeCell), null === (_z = this.customCellStylePlugin) || void 0 === _z || _z.updateCustomCell(null !== (_0 = options.customCellStyle) && void 0 !== _0 ? _0 : [], null !== (_1 = options.customCellStyleArrangement) && void 0 !== _1 ? _1 : []), this._adjustCanvasSizeByOption();
+        this.clearCellStyleCache(), (null == updateConfig ? void 0 : updateConfig.clearColWidthCache) && this.clearColWidthCache(), (null == updateConfig ? void 0 : updateConfig.clearRowHeightCache) && this.clearRowHeightCache(), internalProps.customMergeCell = getCustomMergeCellFunc$1(options.customMergeCell), null === (_z = this.customCellStylePlugin) || void 0 === _z || _z.updateCustomCell(null !== (_0 = options.customCellStyle) && void 0 !== _0 ? _0 : [], null !== (_1 = options.customCellStyleArrangement) && void 0 !== _1 ? _1 : []), this._adjustCanvasSizeByOption();
       }
       renderWithRecreateCells() {
         this.internalProps.stick.changedCells.clear();
@@ -61861,6 +61915,30 @@
           lastSelectRange = currentSelectRanges[currentSelectRanges.length - 1];
         lastSelectRange && (lastSelectRange.end.row = rowIndex), this.stateManager.updateSelectPos(this.colCount - 1, rowIndex, !1, isCtrl, !1, makeSelectCellVisible, !0), this.stateManager.select.selecting = !1;
       }
+      changeHeaderPosition(args) {
+        var _a, _b, _c, _d, _e;
+        if (!("canMoveHeaderPosition" in this.internalProps.layoutMap) || !0 === (null === (_a = this.options.customConfig) || void 0 === _a ? void 0 : _a.notUpdateInColumnRowMove)) return !1;
+        const prevMoving = this.stateManager.columnMove.movingColumnOrRow;
+        this.stateManager.columnMove.movingColumnOrRow = args.movingColumnOrRow;
+        try {
+          if (!1 === (null === (_c = (_b = this.internalProps.layoutMap).canMoveHeaderPosition) || void 0 === _c ? void 0 : _c.call(_b, args.source, args.target))) return !1;
+          const oldSourceMergeInfo = this.getCellRange(args.source.col, args.source.row),
+            oldTargetMergeInfo = this.getCellRange(args.target.col, args.target.row),
+            moveContext = this._moveHeaderPosition(args.source, args.target);
+          if (!moveContext || moveContext.targetIndex === moveContext.sourceIndex) return !1;
+          this.internalProps.useOneRowHeightFillAll = !1, this.internalProps.layoutMap.clearCellRangeMap();
+          const sourceMergeInfo = this.getCellRange(args.source.col, args.source.row),
+            targetMergeInfo = this.getCellRange(args.target.col, args.target.row),
+            colMin = Math.min(sourceMergeInfo.start.col, targetMergeInfo.start.col, oldSourceMergeInfo.start.col, oldTargetMergeInfo.start.col),
+            colMax = Math.max(sourceMergeInfo.end.col, targetMergeInfo.end.col, oldSourceMergeInfo.end.col, oldTargetMergeInfo.end.col),
+            rowMin = Math.min(sourceMergeInfo.start.row, targetMergeInfo.start.row, oldSourceMergeInfo.start.row, oldTargetMergeInfo.start.row);
+          let rowMax = Math.max(sourceMergeInfo.end.row, targetMergeInfo.end.row, oldSourceMergeInfo.end.row, oldTargetMergeInfo.end.row);
+          if ("row" === moveContext.moveType && "tree" === this.internalProps.layoutMap.rowHierarchyType && (rowMax = moveContext.targetIndex > moveContext.sourceIndex ? rowMax + moveContext.targetSize - 1 : rowMax + moveContext.sourceSize - 1), this.transpose || !this.isSeriesNumberInBody(args.source.col, args.source.row) && "row" !== args.movingColumnOrRow || (this.changeRecordOrder(moveContext.sourceIndex, moveContext.targetIndex), this.stateManager.changeCheckboxAndRadioOrder(moveContext.sourceIndex, moveContext.targetIndex)), "column" === moveContext.moveType) for (let col = colMin; col <= colMax; col++) this._clearColRangeWidthsMap(col);else for (let row = rowMin; row <= rowMax; row++) this._clearRowRangeHeightsMap(row);
+          return this.clearCellStyleCache(), this.isSeriesNumberInBody(args.source.col, args.source.row) || "row" === args.movingColumnOrRow ? this.scenegraph.updateHeaderPosition(this.scenegraph.proxy.colStart, this.scenegraph.proxy.colEnd, this.scenegraph.proxy.rowStart, this.scenegraph.proxy.rowEnd, moveContext.moveType) : "column" === moveContext.moveType ? this.scenegraph.updateHeaderPosition(colMin, colMax, 0, -1, moveContext.moveType) : this.scenegraph.updateHeaderPosition(0, -1, rowMin, rowMax, moveContext.moveType), "adjustFrozenCount" === this.internalProps.frozenColDragHeaderMode && this.isListTable() && (this.isLeftFrozenColumn(args.target.col) && !this.isLeftFrozenColumn(args.source.col) ? this.frozenColCount += sourceMergeInfo.end.col - sourceMergeInfo.start.col + 1 : this.isLeftFrozenColumn(args.source.col) && !this.isLeftFrozenColumn(args.target.col) && (this.frozenColCount -= sourceMergeInfo.end.col - sourceMergeInfo.start.col + 1), this.isRightFrozenColumn(args.target.col) && !this.isRightFrozenColumn(args.source.col) ? this.rightFrozenColCount += sourceMergeInfo.end.col - sourceMergeInfo.start.col + 1 : this.isRightFrozenColumn(args.source.col) && !this.isRightFrozenColumn(args.target.col) && (this.rightFrozenColCount -= sourceMergeInfo.end.col - sourceMergeInfo.start.col + 1)), null === (_e = (_d = this.scenegraph).updateNextFrame) || void 0 === _e || _e.call(_d), !0;
+        } finally {
+          this.stateManager.columnMove.movingColumnOrRow = prevMoving;
+        }
+      }
       get recordsCount() {
         var _a;
         return null === (_a = this.records) || void 0 === _a ? void 0 : _a.length;
@@ -62006,7 +62084,7 @@
       getCustomMerge(col, row) {
         if (this.internalProps.customMergeCell) {
           const customMerge = this.internalProps.customMergeCell(col, row, this);
-          if (customMerge && customMerge.range && (isValid$2(customMerge.text) || customMerge.customLayout || this.customRender)) {
+          if (customMerge && customMerge.range) {
             if (customMerge.style) {
               const styleClass = this.internalProps.bodyHelper.getStyleClass("text"),
                 style = customMerge.style,
@@ -62412,7 +62490,7 @@
       }
       getSelectedCellRanges() {
         const ranges = this.stateManager.select.ranges;
-        return ranges.length ? cloneDeep$1(ranges) : [];
+        return ranges.length ? cloneDeep$2(ranges) : [];
       }
       measureText(text, font) {
         return textMeasure.measureText(text, font);
@@ -62717,12 +62795,36 @@
         this.eventManager.enableScroll();
       }
       getGroupTitleLevel(col, row) {}
+      getTargetScrollTop(row) {
+        const drawRange = this.getDrawRange(),
+          frozenHeight = this.getFrozenRowsHeight(),
+          rowsHeight = Math.ceil(this.rowHeightsMap.getSumInRange(0, row - 1)),
+          allRowsHeight = this.getAllRowsHeight();
+        return Math.max(0, Math.min(rowsHeight - frozenHeight, allRowsHeight - drawRange.height));
+      }
+      _scheduleScrollToRowCorrect(row, delay = 0) {
+        this._scrollToRowCorrectTimer = setTimeout(() => {
+          this.clearCorrectTimer();
+          const targetScrollTop = this.getTargetScrollTop(row);
+          if (targetScrollTop !== this.scrollTop) {
+            this.scrollTop = targetScrollTop;
+            const correctedTargetScrollTop = this.getTargetScrollTop(row);
+            correctedTargetScrollTop !== this.scrollTop && (this.scrollTop = correctedTargetScrollTop);
+          }
+        }, delay);
+      }
       scrollToRow(row, animationOption) {
-        animationOption ? this.animationManager.scrollTo({
-          row: row
-        }, animationOption) : this.scrollToCell({
-          row: row
-        });
+        var _a;
+        const targetRow = Math.min(Math.max(Math.floor(row), 0), this.rowCount - 1);
+        if (this.clearCorrectTimer(), !animationOption) return this.scrollToCell({
+          row: targetRow
+        }), void this._scheduleScrollToRowCorrect(targetRow);
+        const duration = isBoolean$2(animationOption) ? 3e3 : null !== (_a = null == animationOption ? void 0 : animationOption.duration) && void 0 !== _a ? _a : 3e3;
+        this.animationManager.scrollTo({
+          row: targetRow
+        }, animationOption), this._scrollToRowCorrectTimer = setTimeout(() => {
+          this.scrollToRow(targetRow, !1);
+        }, duration);
       }
       scrollToCol(col, animationOption) {
         animationOption ? this.animationManager.scrollTo({
@@ -62741,8 +62843,8 @@
         }
         if (isValid$2(cellAddr.row) && cellAddr.row >= this.frozenRowCount) {
           const frozenHeight = this.getFrozenRowsHeight(),
-            top = this.getRowsHeight(0, cellAddr.row - 1);
-          this.scrollTop = Math.min(top - frozenHeight, this.getAllRowsHeight() - drawRange.height);
+            top = this.rowHeightsMap.getSumInRange(0, cellAddr.row - 1);
+          this.scrollTop = Math.min(top - frozenHeight, this.rowHeightsMap.getSumInRange(0, this.rowCount - 1) - drawRange.height);
         }
         this.render();
       }
@@ -63042,7 +63144,7 @@
       }
       cloneParseData(data, options) {
         let clone = !1;
-        return data instanceof DataView || !0 !== (null == options ? void 0 : options.clone) || (clone = !0), clone ? cloneDeep$1(data) : data;
+        return data instanceof DataView || !0 !== (null == options ? void 0 : options.clone) || (clone = !0), clone ? cloneDeep$2(data) : data;
       }
       parseNewData(data, options) {
         this.parse(data, options || this.parseOption), this.reRunAllTransform();
@@ -63075,7 +63177,7 @@
 
     const ignoreWhen = value => isDataView(value) || isHTMLElement(value);
     function cloneDeepSpec(spec, excludeKeys = ["data"]) {
-      return cloneDeep$1(spec, ignoreWhen, excludeKeys);
+      return cloneDeep$2(spec, ignoreWhen, excludeKeys);
     }
 
     function transformLegendTitleAttributes(title) {
@@ -63390,9 +63492,24 @@
       return layout._cellRangeMap.set(`$${col}$${row}`, cellRange), cellRange;
     }
     function getTreeTitleMerge(col, row, cellRange, layout) {
+      var _a;
       if ("tree" !== layout.rowHierarchyType) return;
-      const cellRecord = layout._table.getCellRawRecord(col, row);
-      layout._table.internalProps.groupTitleCheckbox && layout._table.internalProps.rowSeriesNumber ? (null == cellRecord ? void 0 : cellRecord.vtableMerge) && col >= layout.leftRowSeriesNumberColumnCount && (cellRange.start.col = layout.rowHeaderLevelCount + layout.leftRowSeriesNumberColumnCount, cellRange.end.col = layout.colCount - 1, cellRange.start.row = cellRange.end.row = row) : (null == cellRecord ? void 0 : cellRecord.vtableMerge) && (cellRange.start.col = layout.rowHeaderLevelCount, cellRange.end.col = layout.colCount - 1, cellRange.start.row = cellRange.end.row = row);
+      const table = layout._table,
+        internalProps = table.internalProps || {},
+        isGroupMode = !!internalProps.groupBy,
+        cellRecord = table.getCellRawRecord(col, row);
+      if (!(null == cellRecord ? void 0 : cellRecord.vtableMerge)) return;
+      const treeTitleStartCol = internalProps.groupTitleCheckbox && internalProps.rowSeriesNumber ? layout.rowHeaderLevelCount + layout.leftRowSeriesNumberColumnCount : layout.rowHeaderLevelCount;
+      if (!(col < treeTitleStartCol) && (cellRange.start.col = treeTitleStartCol, cellRange.end.col = layout.colCount - 1, cellRange.start.row = cellRange.end.row = row, isGroupMode && 1 === (null === (_a = layout.columnObjects) || void 0 === _a ? void 0 : _a.length))) {
+        const onlyColumn = layout.columnObjects[0],
+          field = null == onlyColumn ? void 0 : onlyColumn.field;
+        if (null != field) {
+          let text = cellRecord.vtableMergeName;
+          const groupTitleFieldFormat = internalProps.groupTitleFieldFormat;
+          "function" == typeof groupTitleFieldFormat && (text = groupTitleFieldFormat(cellRecord, col, row, table));
+          null == cellRecord[field] && null != text && (cellRecord[field] = text);
+        }
+      }
     }
     function getCellRangeTranspose(col, row, layout) {
       var _a, _b, _c, _d;
@@ -64309,7 +64426,7 @@
         this.listenersId.push(doubleClickEventId, clickEventId, selectedChangedEventId);
       }
       startEditCell(col, row, value, editElement) {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
         if (this.editingEditor) return;
         const editor = this.table.getEditor(col, row);
         if (editor) {
@@ -64325,7 +64442,8 @@
             col: col,
             row: row
           }), this.table._makeVisibleCell(col, row), this.editingEditor = editor;
-          const dataValue = isValid$2(value) ? value : this.table.getCellOriginValue(col, row),
+          const customMergeText = null === (_j = this.table.getCustomMerge(col, row)) || void 0 === _j ? void 0 : _j.text,
+            dataValue = isValid$2(value) ? value : isValid$2(customMergeText) ? customMergeText : this.table.getCellOriginValue(col, row),
             rect = this.table.getCellRangeRelativeRect(this.table.getCellRange(col, row)),
             referencePosition = {
               rect: {
@@ -64335,9 +64453,9 @@
                 height: rect.height
               }
             };
-          col === this.table.colCount - 1 ? referencePosition.rect.width = rect.width - 1 : referencePosition.rect.width = rect.width + 1, row === this.table.rowCount - 1 ? referencePosition.rect.height = rect.height - 1 : referencePosition.rect.height = rect.height + 1, editor.beginEditing, null === (_j = editor.beginEditing) || void 0 === _j || _j.call(editor, this.table.getElement(), referencePosition, dataValue), editor.bindSuccessCallback, null === (_k = editor.bindSuccessCallback) || void 0 === _k || _k.call(editor, () => {
+          col === this.table.colCount - 1 ? referencePosition.rect.width = rect.width - 1 : referencePosition.rect.width = rect.width + 1, row === this.table.rowCount - 1 ? referencePosition.rect.height = rect.height - 1 : referencePosition.rect.height = rect.height + 1, editor.beginEditing, null === (_k = editor.beginEditing) || void 0 === _k || _k.call(editor, this.table.getElement(), referencePosition, dataValue), editor.bindSuccessCallback, null === (_l = editor.bindSuccessCallback) || void 0 === _l || _l.call(editor, () => {
             this.completeEdit();
-          }), null === (_l = editor.onStart) || void 0 === _l || _l.call(editor, {
+          }), null === (_m = editor.onStart) || void 0 === _m || _m.call(editor, {
             value: dataValue,
             endEdit: () => {
               this.completeEdit();
@@ -64351,7 +64469,7 @@
         }
       }
       completeEdit(e) {
-        var _a, _b;
+        var _a, _b, _c;
         if (!this.editingEditor) return !0;
         if (this.isValidatingValue) return !1;
         this.cacheLastSelectedCellEditor = {};
@@ -64365,9 +64483,10 @@
         if (this.editingEditor.getValue, this.editingEditor.validateValue) {
           this.isValidatingValue = !0;
           const newValue = this.editingEditor.getValue(),
-            oldValue = this.table.getCellOriginValue(this.editCell.col, this.editCell.row),
+            customMergeText = null === (_a = this.table.getCustomMerge(this.editCell.col, this.editCell.row)) || void 0 === _a ? void 0 : _a.text,
+            oldValue = isValid$2(customMergeText) ? customMergeText : this.table.getCellOriginValue(this.editCell.col, this.editCell.row),
             target = null == e ? void 0 : e.target,
-            maybePromiseOrValue = null === (_b = (_a = this.editingEditor).validateValue) || void 0 === _b ? void 0 : _b.call(_a, newValue, oldValue, this.editCell, this.table, !!this.table.getElement().contains(target));
+            maybePromiseOrValue = null === (_c = (_b = this.editingEditor).validateValue) || void 0 === _c ? void 0 : _c.call(_b, newValue, oldValue, this.editCell, this.table, !!this.table.getElement().contains(target));
           return isPromise(maybePromiseOrValue) ? (this.isValidatingValue = !0, new Promise((resolve, reject) => {
             maybePromiseOrValue.then(result => {
               dealWithValidateValue(result, this, oldValue, resolve);
@@ -64381,14 +64500,17 @@
       doExit() {
         var _a, _b, _c, _d, _e, _f, _g, _h;
         const changedValue = null === (_b = (_a = this.editingEditor).getValue) || void 0 === _b ? void 0 : _b.call(_a),
-          range = this.table.getCellRange(this.editCell.col, this.editCell.row),
-          changedValues = [];
-        for (let row = range.start.row; row <= range.end.row; row++) {
-          const rowChangedValues = [];
-          for (let col = range.start.col; col <= range.end.col; col++) rowChangedValues.push(changedValue);
-          changedValues.push(rowChangedValues);
+          range = this.table.getCellRange(this.editCell.col, this.editCell.row);
+        if (null === (_d = (_c = this.editingEditor).beforeEnd) || void 0 === _d || _d.call(_c), range.isCustom) this.table.changeCellValue(range.start.col, range.start.row, changedValue);else {
+          const changedValues = [];
+          for (let row = range.start.row; row <= range.end.row; row++) {
+            const rowChangedValues = [];
+            for (let col = range.start.col; col <= range.end.col; col++) rowChangedValues.push(changedValue);
+            changedValues.push(rowChangedValues);
+          }
+          this.table.changeCellValues(range.start.col, range.start.row, changedValues);
         }
-        null === (_d = (_c = this.editingEditor).beforeEnd) || void 0 === _d || _d.call(_c), this.table.changeCellValues(range.start.col, range.start.row, changedValues), this.editingEditor.exit, null === (_f = (_e = this.editingEditor).exit) || void 0 === _f || _f.call(_e), null === (_h = (_g = this.editingEditor).onEnd) || void 0 === _h || _h.call(_g), this.editingEditor = null, this.isValidatingValue = !1, this.beginTriggerEditCellMode = null;
+        this.editingEditor.exit, null === (_f = (_e = this.editingEditor).exit) || void 0 === _f || _f.call(_e), null === (_h = (_g = this.editingEditor).onEnd) || void 0 === _h || _h.call(_g), this.editingEditor = null, this.isValidatingValue = !1, this.beginTriggerEditCellMode = null;
       }
       cancelEdit() {
         var _a, _b, _c, _d;
@@ -64448,7 +64570,18 @@
         step((generator = generator.apply(thisArg, _arguments || [])).next());
       });
     };
+    function refreshCustomMergeCellGroups(table) {
+      var _a;
+      if (!Array.isArray(table.options.customMergeCell)) return;
+      table.internalProps.customMergeCell = getCustomMergeCellFunc$1(table.options.customMergeCell);
+      const merges = table.options.customMergeCell;
+      for (let i = 0; i < merges.length; i++) {
+        const r = null === (_a = merges[i]) || void 0 === _a ? void 0 : _a.range;
+        if (null == r ? void 0 : r.start) for (let col = r.start.col; col <= r.end.col; col++) for (let row = r.start.row; row <= r.end.row; row++) table.scenegraph.updateCellContent(col, row);
+      }
+    }
     function listTableChangeCellValue(col, row, value, workOnEditableCell, triggerEvent, table, noTriggerChangeCellValuesEvent) {
+      var _a, _b;
       if (workOnEditableCell && table.isHasEditorDefine(col, row) || !1 === workOnEditableCell) {
         const recordShowIndex = table.getRecordShowIndexByCell(col, row),
           recordIndex = recordShowIndex >= 0 ? table.dataSource.getIndexKey(recordShowIndex) : void 0,
@@ -64458,8 +64591,12 @@
           beforeChangeValue = table.getCellRawValue(col, row),
           oldValue = table.getCellOriginValue(col, row);
         table.isHeader(col, row) ? table.internalProps.layoutMap.updateColumnTitle(col, row, value) : table.dataSource.changeFieldValue(value, recordShowIndex, field, col, row, table);
-        const range = table.getCellRange(col, row),
-          aggregators = table.internalProps.layoutMap.getAggregatorsByCell(col, row);
+        const range = table.getCellRange(col, row);
+        if (range.isCustom && range.start.col === col && range.start.row === row && Array.isArray(table.options.customMergeCell) && "function" == typeof table.getCellValue) {
+          const customMerge = null === (_b = null === (_a = table.internalProps) || void 0 === _a ? void 0 : _a.customMergeCell) || void 0 === _b ? void 0 : _b.call(_a, col, row, table);
+          customMerge && (customMerge.text = value);
+        }
+        const aggregators = table.internalProps.layoutMap.getAggregatorsByCell(col, row);
         if (aggregators) {
           if (Array.isArray(aggregators)) for (let i = 0; i < (null == aggregators ? void 0 : aggregators.length); i++) aggregators[i].recalculate();else aggregators.recalculate();
           const aggregatorCells = table.internalProps.layoutMap.getAggregatorCellAddress(range.start.col, range.start.row, range.end.col, range.end.row);
@@ -64682,7 +64819,13 @@
           (void 0 === recordIndex || recordIndex > table.dataSource.sourceLength) && (recordIndex = table.dataSource.sourceLength);
           const headerCount = table.transpose ? table.rowHeaderLevelCount : table.columnHeaderLevelCount,
             syncToOriginalRecords = !!(null === (_f = table.options) || void 0 === _f ? void 0 : _f.syncRecordOperationsToSourceRecords);
-          if (table.dataSource.addRecord(record, recordIndex, syncToOriginalRecords), adjustCheckBoxStateMapWithAddRecordIndex(table, recordIndex, 1), syncToOriginalRecords) return table.refreshRowColCount(), table.internalProps.layoutMap.clearCellRangeMap(), table.scenegraph.clearCells(), table.scenegraph.createSceneGraph(), !0;
+          if (table.dataSource.addRecord(record, recordIndex, syncToOriginalRecords), adjustCheckBoxStateMapWithAddRecordIndex(table, recordIndex, 1), syncToOriginalRecords) {
+            if (!table.transpose) {
+              const insertRowIndex = recordIndex + headerCount + table.internalProps.layoutMap.hasAggregationOnTopCount;
+              table.rowHeightsMap.insert(insertRowIndex);
+            }
+            return table.refreshRowColCount(), table.internalProps.layoutMap.clearCellRangeMap(), table.scenegraph.clearCells(), table.scenegraph.createSceneGraph(!0), !0;
+          }
           const oldRowCount = table.rowCount;
           if (table.refreshRowColCount(), 0 === table.scenegraph.proxy.totalActualBodyRowCount) return table.scenegraph.clearCells(), table.scenegraph.createSceneGraph(), !0;
           const newRowCount = table.transpose ? table.colCount : table.rowCount;
@@ -64760,7 +64903,13 @@
           void 0 === recordIndex || recordIndex > table.dataSource.sourceLength ? recordIndex = table.dataSource.sourceLength : recordIndex < 0 && (recordIndex = 0);
           const headerCount = table.transpose ? table.rowHeaderLevelCount : table.columnHeaderLevelCount,
             syncToOriginalRecords = !!(null === (_f = table.options) || void 0 === _f ? void 0 : _f.syncRecordOperationsToSourceRecords);
-          if (table.dataSource.addRecords(records, recordIndex, syncToOriginalRecords), adjustCheckBoxStateMapWithAddRecordIndex(table, recordIndex, records.length), syncToOriginalRecords) return table.refreshRowColCount(), table.internalProps.layoutMap.clearCellRangeMap(), table.scenegraph.clearCells(), table.scenegraph.createSceneGraph(), !0;
+          if (table.dataSource.addRecords(records, recordIndex, syncToOriginalRecords), adjustCheckBoxStateMapWithAddRecordIndex(table, recordIndex, records.length), syncToOriginalRecords) {
+            if (!table.transpose) {
+              const insertRowIndex = recordIndex + headerCount + table.internalProps.layoutMap.hasAggregationOnTopCount;
+              for (let i = 0; i < records.length; i++) table.rowHeightsMap.insert(insertRowIndex);
+            }
+            return table.refreshRowColCount(), table.internalProps.layoutMap.clearCellRangeMap(), table.scenegraph.clearCells(), table.scenegraph.createSceneGraph(!0), !0;
+          }
           const oldRowCount = table.transpose ? table.colCount : table.rowCount;
           if (table.refreshRowColCount(), 0 === table.scenegraph.proxy.totalActualBodyRowCount) return table.scenegraph.clearCells(), table.scenegraph.createSceneGraph(), !0;
           const newRowCount = table.transpose ? table.colCount : table.rowCount;
@@ -64829,7 +64978,7 @@
       }
     }
     function listTableDeleteRecords(recordIndexs, table) {
-      var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+      var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p;
       if ((null == recordIndexs ? void 0 : recordIndexs.length) > 0) if (table.internalProps.groupBy) null === (_b = (_a = table.dataSource).deleteRecordsForGroup) || void 0 === _b || _b.call(_a, recordIndexs), table.refreshRowColCount(), table.internalProps.layoutMap.clearCellRangeMap(), table.sortState && sortRecords(table), table.scenegraph.clearCells(), table.scenegraph.createSceneGraph();else if ("tree" === table.dataSource.rowHierarchyType) {
         const deletedRecordIndexs = null === (_d = (_c = table.dataSource).deleteRecordsForTree) || void 0 === _d ? void 0 : _d.call(_c, recordIndexs);
         if (0 === deletedRecordIndexs.length) return;
@@ -64841,8 +64990,17 @@
         const syncToOriginalRecords = !!(null === (_f = table.options) || void 0 === _f ? void 0 : _f.syncRecordOperationsToSourceRecords),
           deletedRecordIndexs = table.dataSource.deleteRecords(recordIndexs, syncToOriginalRecords);
         if (0 === deletedRecordIndexs.length) return;
+        Array.isArray(table.options.customMergeCell) && (table.internalProps.customMergeCell = getCustomMergeCellFunc$1(table.options.customMergeCell));
         for (let index = 0; index < deletedRecordIndexs.length; index++) adjustCheckBoxStateMapWithDeleteRecordIndex(table, deletedRecordIndexs[index], 1);
-        if (syncToOriginalRecords) return table.refreshRowColCount(), table.internalProps.layoutMap.clearCellRangeMap(), table.scenegraph.clearCells(), void table.scenegraph.createSceneGraph();
+        if (syncToOriginalRecords) {
+          if (!table.transpose) {
+            const headerCount = table.transpose ? table.rowHeaderLevelCount : table.columnHeaderLevelCount,
+              topAggregationCount = table.internalProps.layoutMap.hasAggregationOnTopCount,
+              sorted = [...deletedRecordIndexs].sort((a, b) => b - a);
+            for (let i = 0; i < sorted.length; i++) table.rowHeightsMap.delete(sorted[i] + headerCount + topAggregationCount);
+          }
+          return table.refreshRowColCount(), table.internalProps.layoutMap.clearCellRangeMap(), table.scenegraph.clearCells(), void table.scenegraph.createSceneGraph(!0);
+        }
         const oldRowCount = table.transpose ? table.colCount : table.rowCount;
         table.refreshRowColCount();
         const newRowCount = table.transpose ? table.colCount : table.rowCount,
@@ -64880,7 +65038,7 @@
               col: 0,
               row: row
             });
-            null === (_g = table.reactCustomLayout) || void 0 === _g || _g.clearCache(), table.transpose ? table.scenegraph.updateCol(delRows, [], updateRows) : table.scenegraph.updateRow(delRows, [], updateRows), null === (_h = table.reactCustomLayout) || void 0 === _h || _h.updateAllCustomCell();
+            null === (_g = table.reactCustomLayout) || void 0 === _g || _g.clearCache(), table.transpose ? table.scenegraph.updateCol(delRows, [], updateRows) : table.scenegraph.updateRow(delRows, [], updateRows), null === (_h = table.reactCustomLayout) || void 0 === _h || _h.updateAllCustomCell(), refreshCustomMergeCellGroups(table);
           }
         } else {
           const delRows = [],
@@ -64898,6 +65056,42 @@
             });
           }
           const updateRows = [];
+          if (table.internalProps.customMergeCell) {
+            const proxy = table.scenegraph.proxy,
+              deletedIndexNums = (recordIndexsMinToMax[0], recordIndexsMinToMax.map(recordIndex => recordIndex + headerCount + topAggregationCount)),
+              minIndexNum = deletedIndexNums[0];
+            let updateMin = minIndexNum,
+              updateMax = minIndexNum;
+            if (Array.isArray(table.options.customMergeCell)) {
+              const merges = table.options.customMergeCell,
+                axis = table.transpose ? "col" : "row";
+              merges.forEach(m => {
+                const r = null == m ? void 0 : m.range;
+                if ((null == r ? void 0 : r.start) && (null == r ? void 0 : r.end)) for (let i = 0; i < deletedIndexNums.length; i++) {
+                  const deleteIndex = deletedIndexNums[i];
+                  if (r.end[axis] >= deleteIndex - 1) {
+                    updateMin = Math.min(updateMin, r.start[axis]), updateMax = Math.max(updateMax, r.end[axis]);
+                    break;
+                  }
+                }
+              });
+            }
+            if (table.transpose) {
+              const start = Math.max(updateMin, null !== (_j = null == proxy ? void 0 : proxy.colStart) && void 0 !== _j ? _j : updateMin),
+                end = Math.min(updateMax, null !== (_k = null == proxy ? void 0 : proxy.colEnd) && void 0 !== _k ? _k : updateMax);
+              for (let col = start; col <= end; col++) updateRows.push({
+                col: col,
+                row: 0
+              });
+            } else {
+              const start = Math.max(updateMin, null !== (_l = null == proxy ? void 0 : proxy.rowStart) && void 0 !== _l ? _l : updateMin),
+                end = Math.min(updateMax, null !== (_m = null == proxy ? void 0 : proxy.rowEnd) && void 0 !== _m ? _m : updateMax);
+              for (let row = start; row <= end; row++) updateRows.push({
+                col: 0,
+                row: row
+              });
+            }
+          }
           for (let row = headerCount; row < headerCount + topAggregationCount; row++) table.transpose ? updateRows.push({
             col: row,
             row: 0
@@ -64912,7 +65106,7 @@
             col: 0,
             row: row
           });
-          null === (_j = table.reactCustomLayout) || void 0 === _j || _j.clearCache(), table.transpose ? table.scenegraph.updateCol(delRows, [], updateRows) : table.scenegraph.updateRow(delRows, [], updateRows), null === (_k = table.reactCustomLayout) || void 0 === _k || _k.updateAllCustomCell();
+          null === (_o = table.reactCustomLayout) || void 0 === _o || _o.clearCache(), table.transpose ? table.scenegraph.updateCol(delRows, [], updateRows) : table.scenegraph.updateRow(delRows, [], updateRows), null === (_p = table.reactCustomLayout) || void 0 === _p || _p.updateAllCustomCell(), refreshCustomMergeCellGroups(table);
         }
       }
     }
@@ -64924,7 +65118,7 @@
         const syncToOriginalRecords = !!(null === (_f = table.options) || void 0 === _f ? void 0 : _f.syncRecordOperationsToSourceRecords),
           updateRecordIndexs = table.dataSource.updateRecords(records, recordIndexs, syncToOriginalRecords);
         if (0 === updateRecordIndexs.length) return;
-        if (syncToOriginalRecords) return table.refreshRowColCount(), table.internalProps.layoutMap.clearCellRangeMap(), table.scenegraph.clearCells(), void table.scenegraph.createSceneGraph();
+        if (syncToOriginalRecords) return table.refreshRowColCount(), table.internalProps.layoutMap.clearCellRangeMap(), table.scenegraph.clearCells(), void table.scenegraph.createSceneGraph(!0);
         const recordIndexsMinToMax = updateRecordIndexs.map(index => table.getBodyRowIndexByRecordIndex(index)).sort((a, b) => a - b);
         if (table.pagination) {
           const {
@@ -65247,10 +65441,33 @@
         this._hasAutoImageColumn = void 0, this.refreshHeader(), this.records && checkHasAggregationOnColumnDefine(this.internalProps.columns) && this.dataSource.processRecords(null !== (_b = null === (_a = this.dataSource.dataSourceObj) || void 0 === _a ? void 0 : _a.records) && void 0 !== _b ? _b : this.dataSource.dataSourceObj), this.internalProps.useOneRowHeightFillAll = !1, this.headerStyleCache = new Map(), this.bodyStyleCache = new Map(), this.bodyBottomStyleCache = new Map(), this._updateSize(), this.scenegraph.createSceneGraph(), this.stateManager.updateHoverPos(oldHoverState.col, oldHoverState.row), this.renderAsync(), this.eventManager.updateEventBinder();
       }
       addColumns(toAddColumns, colIndex, isMaintainArrayData = !0) {
-        var _a;
+        var _a, _b;
         const columns = this.options.columns;
+        if (Array.isArray(this.options.customMergeCell) && (null == toAddColumns ? void 0 : toAddColumns.length)) {
+          const axis = this.transpose ? "row" : "col";
+          let insertIndex = colIndex;
+          void 0 === insertIndex ? insertIndex = columns.length : insertIndex < 0 ? insertIndex = 0 : insertIndex > columns.length && (insertIndex = columns.length);
+          const toAddCount = toAddColumns.length,
+            merges = this.options.customMergeCell.map(m => Object.assign(Object.assign({}, m), {
+              range: {
+                start: Object.assign({}, m.range.start),
+                end: Object.assign({}, m.range.end)
+              }
+            }));
+          for (let i = 0; i < merges.length; i++) {
+            const r = null === (_a = merges[i]) || void 0 === _a ? void 0 : _a.range;
+            if (!(null == r ? void 0 : r.start) || !(null == r ? void 0 : r.end)) continue;
+            const start = r.start[axis],
+              end = r.end[axis];
+            end < insertIndex || (start > insertIndex ? (r.start[axis] = start + toAddCount, r.end[axis] = end + toAddCount) : r.end[axis] = end + toAddCount);
+          }
+          this.options.customMergeCell = merges.filter(m => {
+            const r = null == m ? void 0 : m.range;
+            return !(!(null == r ? void 0 : r.start) || !(null == r ? void 0 : r.end)) && !(r.end.row < r.start.row || r.end.col < r.start.col) && !(r.start.row === r.end.row && r.start.col === r.end.col);
+          }), this.internalProps.customMergeCell = getCustomMergeCellFunc$1(this.options.customMergeCell);
+        }
         void 0 === colIndex ? (colIndex = columns.length, columns.push(...toAddColumns)) : columns.splice(colIndex, 0, ...toAddColumns);
-        for (let i = 0; i < toAddColumns.length; i++) this.colWidthsMap.addAndReorder(colIndex + i, null !== (_a = toAddColumns[i].width) && void 0 !== _a ? _a : this.internalProps.defaultColWidth);
+        for (let i = 0; i < toAddColumns.length; i++) this.colWidthsMap.addAndReorder(colIndex + i, null !== (_b = toAddColumns[i].width) && void 0 !== _b ? _b : this.internalProps.defaultColWidth);
         this.internalProps._colRangeWidthsMap.clear();
         const resizedColIndexs = Array.from(this.internalProps._widthResizedColMap.keys());
         for (let i = 0; i < resizedColIndexs.length; i++) resizedColIndexs[i] >= colIndex && (this.internalProps._widthResizedColMap.delete(resizedColIndexs[i]), this.internalProps._widthResizedColMap.add(resizedColIndexs[i] + toAddColumns.length));
@@ -65263,15 +65480,46 @@
         }
         this.updateColumns(columns, {
           clearRowHeightCache: !1
-        }), this.fireListeners(TABLE_EVENT_TYPE.ADD_COLUMN, {
+        }), Array.isArray(this.options.customMergeCell) && (this.internalProps.customMergeCell = getCustomMergeCellFunc$1(this.options.customMergeCell), this.options.customMergeCell.forEach(m => {
+          const r = null == m ? void 0 : m.range;
+          if (null == r ? void 0 : r.start) for (let col = r.start.col; col <= r.end.col; col++) for (let row = r.start.row; row <= r.end.row; row++) this.scenegraph.updateCellContent(col, row);
+        }), this.scenegraph.updateNextFrame()), this.fireListeners(TABLE_EVENT_TYPE.ADD_COLUMN, {
           columnIndex: colIndex,
           columnCount: toAddColumns.length,
           columns: columns
         });
       }
       deleteColumns(deleteColIndexs, isMaintainArrayData = !0) {
+        var _a;
         const columns = this.options.columns;
         deleteColIndexs.sort((a, b) => b - a);
+        const deletedColumns = deleteColIndexs.map(idx => cloneDeepSpec(columns[idx], ["children"]));
+        let deletedRecordValues;
+        if (Array.isArray(this.options.customMergeCell) && (null == deleteColIndexs ? void 0 : deleteColIndexs.length)) {
+          const axis = this.transpose ? "row" : "col",
+            deleteIndexNums = deleteColIndexs.slice().sort((a, b) => a - b).map((idx, i) => idx - i),
+            merges = this.options.customMergeCell.map(m => Object.assign(Object.assign({}, m), {
+              range: {
+                start: Object.assign({}, m.range.start),
+                end: Object.assign({}, m.range.end)
+              }
+            }));
+          for (let i = 0; i < deleteIndexNums.length; i++) {
+            const deleteIndex = deleteIndexNums[i];
+            for (let j = 0; j < merges.length; j++) {
+              const r = null === (_a = merges[j]) || void 0 === _a ? void 0 : _a.range;
+              if (!(null == r ? void 0 : r.start) || !(null == r ? void 0 : r.end)) continue;
+              const start = r.start[axis],
+                end = r.end[axis];
+              end < deleteIndex || (start > deleteIndex ? (r.start[axis] = start - 1, r.end[axis] = end - 1) : r.end[axis] = end - 1);
+            }
+          }
+          this.options.customMergeCell = merges.filter(m => {
+            const r = null == m ? void 0 : m.range;
+            return !(!(null == r ? void 0 : r.start) || !(null == r ? void 0 : r.end)) && !(r.end.row < r.start.row || r.end.col < r.start.col) && !(r.start.row === r.end.row && r.start.col === r.end.col);
+          }), this.internalProps.customMergeCell = getCustomMergeCellFunc$1(this.options.customMergeCell);
+        }
+        isMaintainArrayData && Array.isArray(this.records) && this.records.length && (deletedRecordValues = this.records.map(record => Array.isArray(record) ? deleteColIndexs.map(idx => record[idx]) : []), deletedRecordValues.every(v => 0 === v.length) && (deletedRecordValues = void 0));
         for (let i = 0; i < deleteColIndexs.length; i++) if (columns.splice(deleteColIndexs[i], 1), this.colWidthsMap.delAndReorder(deleteColIndexs[i]), this.internalProps._widthResizedColMap.delete(deleteColIndexs[i]), isMaintainArrayData) for (let j = 0; j < this.records.length; j++) {
           const record = this.records[j];
           Array.isArray(record) && record.splice(deleteColIndexs[i], 1);
@@ -65287,7 +65535,9 @@
           clearRowHeightCache: !1
         }), this.fireListeners(TABLE_EVENT_TYPE.DELETE_COLUMN, {
           deleteColIndexs: deleteColIndexs,
-          columns: columns
+          columns: columns,
+          deletedColumns: deletedColumns,
+          deletedRecordValues: deletedRecordValues
         });
       }
       get columns() {
@@ -65675,9 +65925,9 @@
         }
       }
       updateSortState(sortState, executeSort = !0) {
-        var _a;
-        if (sortState) this.internalProps.sortState = sortState;else if (this.internalProps.sortState) if (Array.isArray(this.internalProps.sortState)) for (let i = 0; i < this.internalProps.sortState.length; i++) (sortState = null === (_a = this.internalProps.sortState) || void 0 === _a ? void 0 : _a[i]) && (sortState.order = "normal");else this.internalProps.sortState.order = "normal", sortState = this.internalProps.sortState;
-        (sortState = Array.isArray(sortState) ? sortState : [sortState]).some(item => item.field) && executeSort && this.internalProps.layoutMap.headerObjects.some(item => !1 !== item.define.sort) && (this.dataSource.sort(sortState.map(item => {
+        var _a, _b, _c, _d, _e;
+        const normalizedSortState = (Array.isArray(sortState) ? sortState : sortState ? [sortState] : []).filter(Boolean);
+        if (normalizedSortState.length ? this.internalProps.sortState = sortState : this.internalProps.sortState = null, executeSort) if (normalizedSortState.length) this.internalProps.layoutMap.headerObjects.some(item => !1 !== item.define.sort) && (this.dataSource.sort(normalizedSortState.map(item => {
           const sortFunc = this._getSortFuncFromHeaderOption(this.internalProps.columns, item.field);
           this.internalProps.layoutMap.headerObjects.find(col => col && col.field === item.field);
           return {
@@ -65685,13 +65935,20 @@
             order: item.order,
             orderFn: null != sortFunc ? sortFunc : defaultOrderFn
           };
-        })), this.internalProps.layoutMap.clearCellRangeMap(), this.internalProps.useOneRowHeightFillAll = !1, this.scenegraph.sortCell()), sortState.length && this.stateManager.updateSortState(sortState);
+        })), this.internalProps.layoutMap.clearCellRangeMap(), this.internalProps.useOneRowHeightFillAll = !1, this.scenegraph.sortCell());else {
+          const ds = this.dataSource,
+            sourceLength = null !== (_c = null !== (_b = null !== (_a = null == ds ? void 0 : ds.sourceLength) && void 0 !== _a ? _a : null == ds ? void 0 : ds._sourceLength) && void 0 !== _b ? _b : null == ds ? void 0 : ds.length) && void 0 !== _c ? _c : 0;
+          (null === (_d = null == ds ? void 0 : ds.sortedIndexMap) || void 0 === _d ? void 0 : _d.clear) && ds.sortedIndexMap.clear(), void 0 !== ds.currentIndexedData && (ds.currentIndexedData = Array.from({
+            length: sourceLength
+          }, (_, i) => i)), ds.lastSortStates = [], null === (_e = ds.updatePagination) || void 0 === _e || _e.call(ds, ds.pagination), this.internalProps.layoutMap.clearCellRangeMap(), this.internalProps.useOneRowHeightFillAll = !1, this.scenegraph.sortCell();
+        }
+        this.stateManager.updateSortState(normalizedSortState);
       }
       updateFilterRules(filterRules, options = {
         clearRowHeightCache: !0
       }) {
         var _a, _b, _c;
-        this.scenegraph.clearCells(), null === (_b = (_a = this.dataSource).clearForceVisibleRecords) || void 0 === _b || _b.call(_a), this.sortState ? (this.dataSource.updateFilterRulesForSorted(filterRules), sortRecords(this)) : this.dataSource.updateFilterRules(filterRules, null == options ? void 0 : options.onFilterRecordsEnd), this.refreshRowColCount(), this.stateManager.initCheckedState(this.records), this.scenegraph.createSceneGraph(!(null == options ? void 0 : options.clearRowHeightCache)), null === (_c = this.internalProps.emptyTip) || void 0 === _c || _c.resetVisible(), this.resize();
+        this.scenegraph.clearCells(), !1 !== (null == options ? void 0 : options.clearForceVisibleRecords) && (null === (_b = (_a = this.dataSource).clearForceVisibleRecords) || void 0 === _b || _b.call(_a)), this.sortState ? (this.dataSource.updateFilterRulesForSorted(filterRules), sortRecords(this)) : this.dataSource.updateFilterRules(filterRules, null == options ? void 0 : options.onFilterRecordsEnd), this.refreshRowColCount(), this.stateManager.initCheckedState(this.records), this.scenegraph.createSceneGraph(!(null == options ? void 0 : options.clearRowHeightCache)), null === (_c = this.internalProps.emptyTip) || void 0 === _c || _c.resetVisible(), this.resize();
       }
       getFilteredRecords() {
         return this.dataSource.records;
@@ -65966,30 +66223,112 @@
         traverseColumns(this.internalProps.columns), this.refreshRowColCount(), this.internalProps.layoutMap.clearCellRangeMap(), this.internalProps.useOneRowHeightFillAll = !1, this.stateManager.initCheckedState(this.records), this.scenegraph.createSceneGraph(!clearRowHeightCache), null === (_k = this.internalProps.emptyTip) || void 0 === _k || _k.resetVisible(), this.resize();
       }
       addRecord(record, recordIndex, triggerEvent = !0) {
-        var _a;
+        var _a, _b;
+        if (Array.isArray(this.options.customMergeCell) && "number" == typeof recordIndex) {
+          const axis = this.transpose ? "col" : "row",
+            headerCount = this.transpose ? this.rowHeaderLevelCount : this.columnHeaderLevelCount,
+            topAggregationCount = this.internalProps.layoutMap.hasAggregationOnTopCount;
+          let insertIndex = recordIndex;
+          void 0 === insertIndex || insertIndex > this.dataSource.sourceLength ? insertIndex = this.dataSource.sourceLength : insertIndex < 0 && (insertIndex = 0);
+          const insertIndexNum = insertIndex + headerCount + topAggregationCount,
+            merges = this.options.customMergeCell.map(m => Object.assign(Object.assign({}, m), {
+              range: {
+                start: Object.assign({}, m.range.start),
+                end: Object.assign({}, m.range.end)
+              }
+            }));
+          for (let i = 0; i < merges.length; i++) {
+            const r = null === (_a = merges[i]) || void 0 === _a ? void 0 : _a.range;
+            if (!(null == r ? void 0 : r.start) || !(null == r ? void 0 : r.end)) continue;
+            const start = r.start[axis],
+              end = r.end[axis];
+            end < insertIndexNum || (start > insertIndexNum ? (r.start[axis] = start + 1, r.end[axis] = end + 1) : r.end[axis] = end + 1);
+          }
+          this.options.customMergeCell = merges.filter(m => {
+            const r = null == m ? void 0 : m.range;
+            return !(!(null == r ? void 0 : r.start) || !(null == r ? void 0 : r.end)) && !(r.end.row < r.start.row || r.end.col < r.start.col) && !(r.start.row === r.end.row && r.start.col === r.end.col);
+          }), this.internalProps.customMergeCell = getCustomMergeCellFunc$1(this.options.customMergeCell);
+        }
         const success = listTableAddRecord(record, recordIndex, this);
-        adjustHeightResizedRowMapWithAddRecordIndex(this, recordIndex, [record]), null === (_a = this.internalProps.emptyTip) || void 0 === _a || _a.resetVisible(), triggerEvent && success && this.fireListeners(TABLE_EVENT_TYPE.ADD_RECORD, {
+        adjustHeightResizedRowMapWithAddRecordIndex(this, recordIndex, [record]), null === (_b = this.internalProps.emptyTip) || void 0 === _b || _b.resetVisible(), success && Array.isArray(this.options.customMergeCell) && (this.internalProps.customMergeCell = getCustomMergeCellFunc$1(this.options.customMergeCell), this.options.customMergeCell.forEach(m => {
+          const r = null == m ? void 0 : m.range;
+          if (null == r ? void 0 : r.start) for (let col = r.start.col; col <= r.end.col; col++) for (let row = r.start.row; row <= r.end.row; row++) this.scenegraph.updateCellContent(col, row);
+        }), this.scenegraph.updateNextFrame()), triggerEvent && success && this.fireListeners(TABLE_EVENT_TYPE.ADD_RECORD, {
           records: [record],
           recordIndex: recordIndex,
           recordCount: 1
         });
       }
       addRecords(records, recordIndex, triggerEvent = !0) {
-        var _a;
+        var _a, _b;
+        if (Array.isArray(this.options.customMergeCell) && "number" == typeof recordIndex && (null == records ? void 0 : records.length)) {
+          const axis = this.transpose ? "col" : "row",
+            headerCount = this.transpose ? this.rowHeaderLevelCount : this.columnHeaderLevelCount,
+            topAggregationCount = this.internalProps.layoutMap.hasAggregationOnTopCount;
+          let insertIndex = recordIndex;
+          void 0 === insertIndex || insertIndex > this.dataSource.sourceLength ? insertIndex = this.dataSource.sourceLength : insertIndex < 0 && (insertIndex = 0);
+          const insertIndexNum = insertIndex + headerCount + topAggregationCount,
+            toAddCount = records.length,
+            merges = this.options.customMergeCell.map(m => Object.assign(Object.assign({}, m), {
+              range: {
+                start: Object.assign({}, m.range.start),
+                end: Object.assign({}, m.range.end)
+              }
+            }));
+          for (let i = 0; i < merges.length; i++) {
+            const r = null === (_a = merges[i]) || void 0 === _a ? void 0 : _a.range;
+            if (!(null == r ? void 0 : r.start) || !(null == r ? void 0 : r.end)) continue;
+            const start = r.start[axis],
+              end = r.end[axis];
+            end < insertIndexNum || (start > insertIndexNum ? (r.start[axis] = start + toAddCount, r.end[axis] = end + toAddCount) : r.end[axis] = end + toAddCount);
+          }
+          this.options.customMergeCell = merges.filter(m => {
+            const r = null == m ? void 0 : m.range;
+            return !(!(null == r ? void 0 : r.start) || !(null == r ? void 0 : r.end)) && !(r.end.row < r.start.row || r.end.col < r.start.col) && !(r.start.row === r.end.row && r.start.col === r.end.col);
+          }), this.internalProps.customMergeCell = getCustomMergeCellFunc$1(this.options.customMergeCell);
+        }
         const success = listTableAddRecords(records, recordIndex, this);
-        "number" == typeof recordIndex && adjustHeightResizedRowMapWithAddRecordIndex(this, recordIndex, records), null === (_a = this.internalProps.emptyTip) || void 0 === _a || _a.resetVisible(), triggerEvent && success && this.fireListeners(TABLE_EVENT_TYPE.ADD_RECORD, {
+        "number" == typeof recordIndex && adjustHeightResizedRowMapWithAddRecordIndex(this, recordIndex, records), null === (_b = this.internalProps.emptyTip) || void 0 === _b || _b.resetVisible(), success && Array.isArray(this.options.customMergeCell) && (this.internalProps.customMergeCell = getCustomMergeCellFunc$1(this.options.customMergeCell), this.options.customMergeCell.forEach(m => {
+          const r = null == m ? void 0 : m.range;
+          if (null == r ? void 0 : r.start) for (let col = r.start.col; col <= r.end.col; col++) for (let row = r.start.row; row <= r.end.row; row++) this.scenegraph.updateCellContent(col, row);
+        }), this.scenegraph.updateNextFrame()), triggerEvent && success && this.fireListeners(TABLE_EVENT_TYPE.ADD_RECORD, {
           records: records,
           recordIndex: recordIndex,
           recordCount: records.length
         });
       }
       deleteRecords(recordIndexs, triggerEvent = !0) {
-        var _a;
-        const deletedRecords = [];
-        (null == recordIndexs ? void 0 : recordIndexs.length) > 0 && recordIndexs.forEach(index => {
+        var _a, _b;
+        const prevMergeRanges = Array.isArray(this.options.customMergeCell) ? this.options.customMergeCell.map(m => null == m ? void 0 : m.range).filter(Boolean).map(r => ({
+            start: Object.assign({}, r.start),
+            end: Object.assign({}, r.end)
+          })) : [],
+          deletedRecords = [];
+        if ((null == recordIndexs ? void 0 : recordIndexs.length) > 0 && recordIndexs.forEach(index => {
           let record = null;
           record = "number" == typeof index ? this.dataSource.get(index) : [], deletedRecords.push(record);
-        }), listTableDeleteRecords(recordIndexs, this), adjustHeightResizedRowMapWithDeleteRecordIndex(this, recordIndexs), null === (_a = this.internalProps.emptyTip) || void 0 === _a || _a.resetVisible();
+        }), Array.isArray(this.options.customMergeCell) && (null == recordIndexs ? void 0 : recordIndexs.length) && "number" == typeof recordIndexs[0]) {
+          const axis = this.transpose ? "col" : "row",
+            headerCount = this.transpose ? this.rowHeaderLevelCount : this.columnHeaderLevelCount,
+            topAggregationCount = this.internalProps.layoutMap.hasAggregationOnTopCount,
+            deleteIndexNums = recordIndexs.slice().sort((a, b) => a - b).map((index, i) => index + headerCount + topAggregationCount - i),
+            merges = this.options.customMergeCell;
+          for (let i = 0; i < deleteIndexNums.length; i++) {
+            const deleteIndex = deleteIndexNums[i];
+            for (let j = 0; j < merges.length; j++) {
+              const r = null === (_a = merges[j]) || void 0 === _a ? void 0 : _a.range;
+              if (!(null == r ? void 0 : r.start) || !(null == r ? void 0 : r.end)) continue;
+              const start = r.start[axis],
+                end = r.end[axis];
+              end < deleteIndex || (start > deleteIndex ? (r.start[axis] = start - 1, r.end[axis] = end - 1) : r.end[axis] = end - 1);
+            }
+          }
+          this.options.customMergeCell = merges.filter(m => {
+            const r = null == m ? void 0 : m.range;
+            return !(!(null == r ? void 0 : r.start) || !(null == r ? void 0 : r.end)) && !(r.end.row < r.start.row || r.end.col < r.start.col) && !(r.start.row === r.end.row && r.start.col === r.end.col);
+          });
+        }
+        listTableDeleteRecords(recordIndexs, this), adjustHeightResizedRowMapWithDeleteRecordIndex(this, recordIndexs), null === (_b = this.internalProps.emptyTip) || void 0 === _b || _b.resetVisible();
         const rowIndexs = [];
         for (let i = 0; i < recordIndexs.length; i++) rowIndexs.push(this.getBodyRowIndexByRecordIndex(recordIndexs[i]) + this.columnHeaderLevelCount);
         triggerEvent && this.fireListeners(TABLE_EVENT_TYPE.DELETE_RECORD, {
@@ -65997,7 +66336,16 @@
           records: deletedRecords,
           rowIndexs: rowIndexs,
           deletedCount: (Array.isArray(recordIndexs[0]), recordIndexs.length)
-        });
+        }), Array.isArray(this.options.customMergeCell) && (this.internalProps.customMergeCell = getCustomMergeCellFunc$1(this.options.customMergeCell), this.options.customMergeCell.forEach(m => {
+          const r = null == m ? void 0 : m.range;
+          if (null == r ? void 0 : r.start) for (let col = r.start.col; col <= r.end.col; col++) for (let row = r.start.row; row <= r.end.row; row++) this.scenegraph.updateCellContent(col, row);
+        }), this.scenegraph.updateNextFrame(), setTimeout(() => {
+          if (!this.internalProps || !this.options || !this.scenegraph) return;
+          Array.isArray(this.options.customMergeCell) && (this.internalProps.customMergeCell = getCustomMergeCellFunc$1(this.options.customMergeCell));
+          [...prevMergeRanges, ...(Array.isArray(this.options.customMergeCell) ? this.options.customMergeCell.map(m => null == m ? void 0 : m.range) : [])].filter(Boolean).forEach(r => {
+            if (null == r ? void 0 : r.start) for (let col = r.start.col; col <= r.end.col; col++) for (let row = r.start.row; row <= r.end.row; row++) this.scenegraph.updateCellContent(col, row);
+          }), this.scenegraph.updateNextFrame();
+        }, 0));
       }
       updateRecords(records, recordIndexs, triggerEvent = !0) {
         listTableUpdateRecords(records, recordIndexs, this), triggerEvent && this.fireListeners(TABLE_EVENT_TYPE.UPDATE_RECORD, {
@@ -66099,9 +66447,14 @@
               row: endRow
             }
           }
-        }), this.internalProps.customMergeCell = getCustomMergeCellFunc(this.options.customMergeCell);
+        }), this.internalProps.customMergeCell = getCustomMergeCellFunc$1(this.options.customMergeCell);
         for (let i = startCol; i <= endCol; i++) for (let j = startRow; j <= endRow; j++) this.scenegraph.updateCellContent(i, j);
-        this.scenegraph.updateNextFrame();
+        this.scenegraph.updateNextFrame(), this.fireListeners(TABLE_EVENT_TYPE.MERGE_CELLS, {
+          startCol: startCol,
+          startRow: startRow,
+          endCol: endCol,
+          endRow: endRow
+        });
       }
       unmergeCells(startCol, startRow, endCol, endRow) {
         this.options.customMergeCell ? "function" == typeof this.options.customMergeCell && (this.options.customMergeCell = []) : this.options.customMergeCell = [], this.options.customMergeCell = this.options.customMergeCell.filter(item => {
@@ -66110,9 +66463,14 @@
             end: end
           } = item.range;
           return !(start.col === startCol && start.row === startRow && end.col === endCol && end.row === endRow);
-        }), this.internalProps.customMergeCell = getCustomMergeCellFunc(this.options.customMergeCell);
+        }), this.internalProps.customMergeCell = getCustomMergeCellFunc$1(this.options.customMergeCell);
         for (let i = startCol; i <= endCol; i++) for (let j = startRow; j <= endRow; j++) this.scenegraph.updateCellContent(i, j);
-        this.scenegraph.updateNextFrame();
+        this.scenegraph.updateNextFrame(), this.fireListeners(TABLE_EVENT_TYPE.UNMERGE_CELLS, {
+          startCol: startCol,
+          startRow: startRow,
+          endCol: endCol,
+          endRow: endRow
+        });
       }
     }
 
@@ -66913,7 +67271,7 @@
     class DiscreteTableLegend {
       constructor(option, table) {
         var _a, _b, _c, _d;
-        this.table = table, this.option = cloneDeep$1(option), this.orient = null !== (_a = option.orient) && void 0 !== _a ? _a : "left", this.visible = null === (_b = option.visible) || void 0 === _b || _b, this.position = null !== (_c = option.position) && void 0 !== _c ? _c : "middle", this.selectedData = null !== (_d = option.defaultSelected) && void 0 !== _d ? _d : null, this.createComponent(), this.initEvent();
+        this.table = table, this.option = cloneDeep$2(option), this.orient = null !== (_a = option.orient) && void 0 !== _a ? _a : "left", this.visible = null === (_b = option.visible) || void 0 === _b || _b, this.position = null !== (_c = option.position) && void 0 !== _c ? _c : "middle", this.selectedData = null !== (_d = option.defaultSelected) && void 0 !== _d ? _d : null, this.createComponent(), this.initEvent();
       }
       createComponent() {
         const attrs = this.getLegendAttributes({
@@ -67162,7 +67520,7 @@
     class ContinueTableLegend {
       constructor(option, table) {
         var _a, _b, _c, _d;
-        this.table = table, this.option = cloneDeep$1(option), this.orient = null !== (_a = option.orient) && void 0 !== _a ? _a : "left", this.visible = null === (_b = option.visible) || void 0 === _b || _b, this.position = null !== (_c = option.position) && void 0 !== _c ? _c : "middle", this.selectedData = null !== (_d = option.defaultSelected) && void 0 !== _d ? _d : null, this.createComponent(), this.initEvent();
+        this.table = table, this.option = cloneDeep$2(option), this.orient = null !== (_a = option.orient) && void 0 !== _a ? _a : "left", this.visible = null === (_b = option.visible) || void 0 === _b || _b, this.position = null !== (_c = option.position) && void 0 !== _c ? _c : "middle", this.selectedData = null !== (_d = option.defaultSelected) && void 0 !== _d ? _d : null, this.createComponent(), this.initEvent();
       }
       createComponent() {
         const attrs = this.getLegendAttributes({
@@ -72131,7 +72489,10 @@
           }
         }), table.updateFilterRules([...this.filterFuncRule, ...this.filterValueRule], {
           clearRowHeightCache: !1,
-          onFilterRecordsEnd: null === (_a = this.pluginOptions) || void 0 === _a ? void 0 : _a.onFilterRecordsEnd
+          onFilterRecordsEnd: (null === (_a = this.pluginOptions) || void 0 === _a ? void 0 : _a.onFilterRecordsEnd) ? records => {
+            var _a, _b;
+            return null === (_b = (_a = this.pluginOptions).onFilterRecordsEnd) || void 0 === _b || _b.call(_a, records), records;
+          } : void 0
         });
       }
       createFilterFunction(filter) {
@@ -72223,6 +72584,79 @@
       getAllFilterStates() {
         return this.state;
       }
+      getSnapshot() {
+        const filters = [];
+        return this.state.filters.forEach(v => {
+          const next = Object.assign({}, v);
+          next && "byValue" === next.type && Array.isArray(next.values) && (next.values = next.values.slice().sort((a, b) => String(a).localeCompare(String(b)))), next && Array.isArray(next.condition) && next.condition.length > 2 && (next.condition = next.condition.slice()), filters.push(next);
+        }), filters.sort((a, b) => String(a.field).localeCompare(String(b.field))), {
+          filters: filters
+        };
+      }
+      applySnapshot(snapshot, actionType = FilterActionType.APPLY_FILTERS) {
+        var _a;
+        const next = new Map();
+        (null !== (_a = null == snapshot ? void 0 : snapshot.filters) && void 0 !== _a ? _a : []).forEach(cfg => {
+          if (!cfg) return;
+          const cloned = Object.assign({}, cfg);
+          cloned && "byValue" === cloned.type && Array.isArray(cloned.values) && (cloned.values = cloned.values.slice()), cloned && Array.isArray(cloned.condition) && (cloned.condition = cloned.condition.slice()), next.set(cloned.field, cloned);
+        }), this.state = Object.assign(Object.assign({}, this.state), {
+          filters: next
+        }), this.applyFilters(), this.notifyListeners({
+          type: actionType,
+          payload: {
+            fromSnapshot: !0
+          }
+        });
+      }
+      shiftFieldsOnAddColumns(columnIndex, columnCount) {
+        if (!Number.isFinite(columnIndex) || !Number.isFinite(columnCount) || columnCount <= 0) return;
+        const next = new Map();
+        this.state.filters.forEach((cfg, key) => {
+          let newKey = key;
+          const cloned = Object.assign({}, cfg);
+          "number" == typeof newKey && newKey >= columnIndex && (newKey += columnCount), "number" == typeof cloned.field && cloned.field >= columnIndex && (cloned.field = cloned.field + columnCount), cloned && "byValue" === cloned.type && Array.isArray(cloned.values) && (cloned.values = cloned.values.slice()), cloned && Array.isArray(cloned.condition) && (cloned.condition = cloned.condition.slice()), next.set(newKey, cloned);
+        }), this.state = Object.assign(Object.assign({}, this.state), {
+          filters: next
+        });
+      }
+      shiftFieldsOnDeleteColumns(deleteColIndexs) {
+        if (!Array.isArray(deleteColIndexs) || 0 === deleteColIndexs.length) return;
+        const deleteIndexNums = deleteColIndexs.slice().filter(n => Number.isFinite(n)).sort((a, b) => a - b).map((idx, i) => idx - i),
+          next = new Map();
+        this.state.filters.forEach((cfg, key) => {
+          let newKey = key;
+          const cloned = Object.assign({}, cfg);
+          let removed = !1;
+          if ("number" == typeof newKey) {
+            let k = newKey;
+            for (let i = 0; i < deleteIndexNums.length; i++) {
+              const d = deleteIndexNums[i];
+              if (k === d) {
+                removed = !0;
+                break;
+              }
+              k > d && (k -= 1);
+            }
+            newKey = k;
+          }
+          if ("number" == typeof cloned.field) {
+            let f = cloned.field;
+            for (let i = 0; i < deleteIndexNums.length; i++) {
+              const d = deleteIndexNums[i];
+              if (f === d) {
+                removed = !0;
+                break;
+              }
+              f > d && (f -= 1);
+            }
+            cloned.field = f;
+          }
+          removed || (cloned && "byValue" === cloned.type && Array.isArray(cloned.values) && (cloned.values = cloned.values.slice()), cloned && Array.isArray(cloned.condition) && (cloned.condition = cloned.condition.slice()), next.set(newKey, cloned));
+        }), this.state = Object.assign(Object.assign({}, this.state), {
+          filters: next
+        });
+      }
       reapplyCurrentFilters() {
         this.getActiveFilterFields().length > 0 && this.applyFilters();
       }
@@ -72499,7 +72933,7 @@
         }), this.candidateKeys.set(candidateField, countMap), this.toUnformattedCache.set(candidateField, toUnformatted);
       }
       toggleSelectAll(fieldId, selected) {
-        this.valueFilterOptionList.get(fieldId).forEach(option => {
+        (this.valueFilterOptionList.get(fieldId) || []).forEach(option => {
           "none" !== option.itemContainer.style.display && (option.checkbox.checked = selected);
         });
       }
@@ -72510,7 +72944,7 @@
         this.selectAllCheckbox.checked = allChecked, this.selectAllCheckbox.indeterminate = !allChecked && !noneChecked;
       }
       onSearch(fieldId, value) {
-        const items = this.valueFilterOptionList.get(fieldId),
+        const items = this.valueFilterOptionList.get(fieldId) || [],
           filterKeywords = value.toUpperCase().split(" ").filter(s => s);
         for (const item of items) {
           const txtValue = item.id.toUpperCase() || "",
@@ -72520,48 +72954,19 @@
         }
       }
       syncSingleStateFromTableData(fieldId) {
-        var _a, _b, _c;
-        const selectedValues = new Set(),
-          originalValues = new Set();
+        const originalValues = new Set();
         this.table.internalProps.records.forEach(record => {
           isValid$2(record) && originalValues.add(record[fieldId]);
         });
-        const syncFilterItemsState = null === (_b = null === (_a = this.pluginOptions) || void 0 === _a ? void 0 : _a.syncFilterItemsState) || void 0 === _b || _b,
-          hasFiltered = !arrayEqual(Array.from(originalValues), Array.from(selectedValues));
-        if (syncFilterItemsState) {
-          if (hasFiltered) {
-            this.selectedKeys.set(fieldId, selectedValues), this.filterStateManager.dispatch({
-              type: FilterActionType.UPDATE_FILTER,
-              payload: {
-                field: fieldId,
-                values: Array.from(selectedValues),
-                enable: !0
-              }
-            });
-            !arrayEqual(Array.from(originalValues), Array.from(selectedValues)) && (this.selectedKeys.set(fieldId, selectedValues), this.filterStateManager.dispatch({
-              type: FilterActionType.ADD_FILTER,
-              payload: {
-                field: fieldId,
-                type: "byValue",
-                values: Array.from(selectedValues),
-                enable: !0
-              }
-            }));
+        const current = this.filterStateManager.getFilterState(fieldId);
+        if ("byValue" === (null == current ? void 0 : current.type) && Array.isArray(current.values)) this.selectedKeys.set(fieldId, new Set(current.values));else {
+          if ("byCondition" === (null == current ? void 0 : current.type) && current.enable) {
+            const visibleValues = new Set();
+            return this.getRecords(this.table, !1).forEach(record => {
+              isValid$2(record) && visibleValues.add(record[fieldId]);
+            }), void this.selectedKeys.set(fieldId, visibleValues);
           }
-        } else {
-          const selectedRules = null === (_c = this.filterStateManager.getFilterState(fieldId)) || void 0 === _c ? void 0 : _c.values;
-          if (selectedRules) {
-            !arrayEqual(Array.from(originalValues), selectedRules) && (this.selectedKeys.set(fieldId, new Set(selectedRules)), this.filterStateManager.dispatch({
-              type: FilterActionType.ADD_FILTER,
-              payload: {
-                field: fieldId,
-                type: "byValue",
-                values: selectedRules,
-                enable: !0,
-                shouldKeepUnrelatedState: !0
-              }
-            }));
-          } else this.selectedKeys.set(fieldId, originalValues);
+          this.selectedKeys.set(fieldId, originalValues);
         }
       }
       applyFilter(fieldId = this.selectedField) {
@@ -72914,12 +73319,13 @@
 
     class FilterToolbar {
       constructor(table, filterStateManager, pluginOptions) {
+        var _a;
         this.valueFilter = null, this.conditionFilter = null, this.activeTab = "byValue", this.isVisible = !1, this.selectedField = null, this.filterModes = [], this.hide = (currentCol, currentRow) => {
           this.filterMenu.style.display = "none", this.isVisible = !1, this.table.fireListeners(TABLE_EVENT_TYPE.FILTER_MENU_HIDE, {
             col: null != currentCol ? currentCol : this.currentCol,
             row: null != currentRow ? currentRow : this.currentRow
           });
-        }, this.table = table, this.filterStateManager = filterStateManager, this.valueFilter = new ValueFilter(this.table, this.filterStateManager, pluginOptions), this.conditionFilter = new ConditionFilter(this.table, this.filterStateManager, pluginOptions, this.hide), this.pluginOptions = pluginOptions, this.filterMenuWidth = 300, this.filterStateManager.subscribe(state => {
+        }, this.table = table, this.filterStateManager = filterStateManager, this.valueFilter = new ValueFilter(this.table, this.filterStateManager, pluginOptions), this.conditionFilter = new ConditionFilter(this.table, this.filterStateManager, pluginOptions, this.hide), this.pluginOptions = pluginOptions, this.pluginId = null !== (_a = null == pluginOptions ? void 0 : pluginOptions.id) && void 0 !== _a ? _a : "filter", this.filterMenuWidth = 300, this.filterStateManager.subscribe(state => {
           this.isVisible && null !== this.selectedField && this.updateClearFilterButtonState(this.selectedField);
         });
       }
@@ -72937,6 +73343,18 @@
       clearFilter(field) {
         this.valueFilter && this.valueFilter.clearFilter(field), this.conditionFilter && this.conditionFilter.clearFilter(field), this.hide();
       }
+      recordHistory(before, after) {
+        var _a, _b, _c, _d, _e, _f, _g, _h;
+        if (JSON.stringify(before) === JSON.stringify(after)) return;
+        const pm = this.table.pluginManager,
+          history = null !== (_f = null !== (_d = null !== (_b = null === (_a = null == pm ? void 0 : pm.getPlugin) || void 0 === _a ? void 0 : _a.call(pm, "history-plugin")) && void 0 !== _b ? _b : null === (_c = null == pm ? void 0 : pm.getPluginByName) || void 0 === _c ? void 0 : _c.call(pm, "History")) && void 0 !== _d ? _d : null === (_e = null == pm ? void 0 : pm.getPlugin) || void 0 === _e ? void 0 : _e.call(pm, "history")) && void 0 !== _f ? _f : null === (_g = null == pm ? void 0 : pm.getPluginByName) || void 0 === _g ? void 0 : _g.call(pm, "history");
+        null === (_h = null == history ? void 0 : history.recordExternalCommand) || void 0 === _h || _h.call(history, {
+          type: "filter",
+          pluginId: this.pluginId,
+          oldSnapshot: before,
+          newSnapshot: after
+        });
+      }
       updateClearFilterButtonState(field) {
         const currentFilter = this.filterStateManager.getFilterState(field),
           hasActiveFilter = currentFilter && currentFilter.enable;
@@ -72963,9 +73381,16 @@
         }), this.filterTabByCondition.addEventListener("click", () => {
           this.onTabSwitch("byCondition");
         }), this.cancelFilterButton.addEventListener("click", () => this.hide()), this.clearFilterOptionLink.addEventListener("click", e => {
-          e.preventDefault(), this.clearFilter(this.selectedField);
+          e.preventDefault();
+          const before = this.filterStateManager.getSnapshot();
+          this.clearFilter(this.selectedField);
+          const after = this.filterStateManager.getSnapshot();
+          this.recordHistory(before, after);
         }), this.applyFilterButton.addEventListener("click", () => {
+          const before = this.filterStateManager.getSnapshot();
           this.applyFilter(this.selectedField);
+          const after = this.filterStateManager.getSnapshot();
+          this.recordHistory(before, after);
         }), document.addEventListener("click", () => {
           this.isVisible && this.hide();
         }), this.filterMenu.addEventListener("click", e => {
@@ -72990,7 +73415,7 @@
         const field = this.table.internalProps.layoutMap.getHeaderField(col, row);
         this.updateSelectedField(field);
         const currentFilter = this.filterStateManager.getFilterState(field);
-        currentFilter && "byCondition" === currentFilter.type ? this.onTabSwitch("byCondition") : this.onTabSwitch("byValue"), this.updateClearFilterButtonState(field), setTimeout(() => {
+        currentFilter && "byCondition" === currentFilter.type ? this.onTabSwitch("byCondition") : this.filterModes.includes("byValue") && this.onTabSwitch("byValue"), this.updateClearFilterButtonState(field), setTimeout(() => {
           this.isVisible = !0, this.table.fireListeners(TABLE_EVENT_TYPE.FILTER_MENU_SHOW, {
             col: col,
             row: row
@@ -82471,7 +82896,7 @@
     class FilterPlugin {
       constructor(pluginOptions) {
         var _a, _b, _c, _d, _e;
-        this.id = "filter", this.name = "Filter", this.runTime = [TABLE_EVENT_TYPE.BEFORE_INIT, TABLE_EVENT_TYPE.BEFORE_UPDATE_OPTION, TABLE_EVENT_TYPE.ICON_CLICK, TABLE_EVENT_TYPE.SCROLL, TABLE_EVENT_TYPE.CHANGE_CELL_VALUE, TABLE_EVENT_TYPE.UPDATE_RECORD, TABLE_EVENT_TYPE.ADD_RECORD, TABLE_EVENT_TYPE.DELETE_RECORD], this.id = null !== (_a = null == pluginOptions ? void 0 : pluginOptions.id) && void 0 !== _a ? _a : this.id, this.pluginOptions = lodashExports.cloneDeep(pluginOptions), this.pluginOptions.filterIcon = null !== (_b = pluginOptions.filterIcon) && void 0 !== _b ? _b : {
+        this.id = "filter", this.name = "Filter", this.runTime = [TABLE_EVENT_TYPE.BEFORE_INIT, TABLE_EVENT_TYPE.BEFORE_UPDATE_OPTION, TABLE_EVENT_TYPE.ICON_CLICK, TABLE_EVENT_TYPE.SCROLL, TABLE_EVENT_TYPE.CHANGE_CELL_VALUE, TABLE_EVENT_TYPE.UPDATE_RECORD, TABLE_EVENT_TYPE.ADD_RECORD, TABLE_EVENT_TYPE.DELETE_RECORD, TABLE_EVENT_TYPE.ADD_COLUMN, TABLE_EVENT_TYPE.DELETE_COLUMN], this.id = null !== (_a = null == pluginOptions ? void 0 : pluginOptions.id) && void 0 !== _a ? _a : this.id, this.pluginOptions = lodashExports.cloneDeep(pluginOptions), this.pluginOptions.filterIcon = null !== (_b = pluginOptions.filterIcon) && void 0 !== _b ? _b : {
           name: "filter-icon",
           type: "svg",
           width: 12,
@@ -82497,7 +82922,7 @@
         });
       }
       run(...args) {
-        var _a, _b, _c, _d, _e;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
         const eventArgs = args[0],
           runtime = args[1],
           table = args[2];
@@ -82505,20 +82930,43 @@
           if (3 === (null === (_c = eventArgs.event) || void 0 === _c ? void 0 : _c.which) || 2 === (null === (_d = eventArgs.event) || void 0 === _d ? void 0 : _d.button) || 2 == (2 & (null === (_e = eventArgs.event) || void 0 === _e ? void 0 : _e.buttons))) return;
           const col = eventArgs.col,
             row = eventArgs.row;
-          this.filterToolbar.isVisible ? this.filterToolbar.hide(eventArgs.col, eventArgs.row) : (this.filterToolbar.show(col, row, this.pluginOptions.filterModes), this.table.fireListeners(TABLE_EVENT_TYPE.FILTER_MENU_SHOW, {
-            col: eventArgs.col,
-            row: eventArgs.row
-          }));
+          this.filterToolbar.isVisible ? this.filterToolbar.hide(eventArgs.col, eventArgs.row) : this.filterToolbar.show(col, row, this.pluginOptions.filterModes);
         } else if (runtime === TABLE_EVENT_TYPE.SCROLL) "horizontal" === eventArgs.scrollDirection && this.filterToolbar.adjustMenuPosition();else if (runtime === TABLE_EVENT_TYPE.CHANGE_CELL_VALUE) {
           const changedField = this.table.getHeaderField(eventArgs.col, eventArgs.row);
           this.syncFilterWithTableData(changedField);
-        } else (runtime === TABLE_EVENT_TYPE.UPDATE_RECORD || runtime === TABLE_EVENT_TYPE.ADD_RECORD || runtime === TABLE_EVENT_TYPE.DELETE_RECORD) && this.syncFilterWithTableData();
+        } else if (runtime === TABLE_EVENT_TYPE.UPDATE_RECORD) this.syncFilterWithTableData();else if (runtime === TABLE_EVENT_TYPE.ADD_RECORD) {
+          if ((null === (_g = null === (_f = this.filterStateManager) || void 0 === _f ? void 0 : _f.getActiveFilterFields) || void 0 === _g ? void 0 : _g.call(_f).length) > 0 && Array.isArray(null == eventArgs ? void 0 : eventArgs.records)) {
+            const ds = this.table.dataSource;
+            eventArgs.records.forEach(r => {
+              var _a;
+              return null === (_a = null == ds ? void 0 : ds.markForceVisibleRecord) || void 0 === _a ? void 0 : _a.call(ds, r);
+            });
+          }
+          this.syncFilterWithTableData();
+        } else if (runtime === TABLE_EVENT_TYPE.DELETE_RECORD) this.syncFilterWithTableData();else if (runtime === TABLE_EVENT_TYPE.ADD_COLUMN) {
+          const columnIndex = null == eventArgs ? void 0 : eventArgs.columnIndex,
+            columnCount = null == eventArgs ? void 0 : eventArgs.columnCount;
+          "number" == typeof columnIndex && "number" == typeof columnCount && columnCount > 0 && (null === (_j = null === (_h = this.filterStateManager) || void 0 === _h ? void 0 : _h.shiftFieldsOnAddColumns) || void 0 === _j || _j.call(_h, columnIndex, columnCount)), this.reapplyActiveFilters();
+        } else if (runtime === TABLE_EVENT_TYPE.DELETE_COLUMN) {
+          const deleteColIndexs = null == eventArgs ? void 0 : eventArgs.deleteColIndexs;
+          Array.isArray(deleteColIndexs) && deleteColIndexs.length > 0 && (null === (_l = null === (_k = this.filterStateManager) || void 0 === _k ? void 0 : _k.shiftFieldsOnDeleteColumns) || void 0 === _l || _l.call(_k, deleteColIndexs)), this.reapplyActiveFilters();
+        }
       }
       updatePluginOptions(pluginOptions) {
         this.pluginOptions = lodashExports.merge(this.pluginOptions, pluginOptions), this.filterToolbar.updateStyles(this.pluginOptions.styles), this.table.updateColumns(this.columns, {
           clearRowHeightCache: !1
         });
       }
+      getFilterSnapshot() {
+        var _a, _b, _c;
+        return null !== (_c = null === (_b = null === (_a = this.filterStateManager) || void 0 === _a ? void 0 : _a.getSnapshot) || void 0 === _b ? void 0 : _b.call(_a)) && void 0 !== _c ? _c : {
+          filters: []
+        };
+      }
+      applyFilterSnapshot(snapshot) {
+        var _a, _b;
+        null === (_b = null === (_a = this.filterStateManager) || void 0 === _a ? void 0 : _a.applySnapshot) || void 0 === _b || _b.call(_a, snapshot, FilterActionType.APPLY_FILTERS);
+      }
       update() {
         this.filterStateManager && this.reapplyActiveFilters();
       }
@@ -83630,10 +84078,10 @@
      * console.log(deep[0] === objects[0]);
      * // => false
      */
-    function cloneDeep(value) {
+    function cloneDeep$1(value) {
       return baseClone(value, CLONE_DEEP_FLAG | CLONE_SYMBOLS_FLAG);
     }
-    var cloneDeep_1 = cloneDeep;
+    var cloneDeep_1 = cloneDeep$1;
     var deepClone = /*@__PURE__*/getDefaultExportFromCjs(cloneDeep_1);
 
     const chnNumChar = {
@@ -84764,6 +85212,1200 @@
       }
     }
 
+    function makeCellKey(sheetKey, row, col) {
+      return `${sheetKey}:${row}:${col}`;
+    }
+    function parseA1Notation(a1) {
+      const match = a1.match(/^([A-Z]+)([0-9]+)$/i);
+      if (!match) return null;
+      const letters = match[1].toUpperCase(),
+        rowNumber = parseInt(match[2], 10);
+      if (!rowNumber || rowNumber < 1) return null;
+      let col = 0;
+      for (let i = 0; i < letters.length; i++) col = 26 * col + (letters.charCodeAt(i) - 64);
+      return {
+        row: rowNumber - 1,
+        col: col - 1
+      };
+    }
+    function captureCellPreChangeContent(args) {
+      const {
+        sheetKey: sheetKey,
+        row: row,
+        col: col,
+        currentValue: currentValue,
+        formulaManager: formulaManager,
+        store: store
+      } = args;
+      if (!sheetKey) return;
+      const cellKey = makeCellKey(sheetKey, row, col);
+      if (null == formulaManager ? void 0 : formulaManager.getCellFormula) try {
+        const oldFormula = formulaManager.getCellFormula({
+          sheet: sheetKey,
+          row: row,
+          col: col
+        });
+        if (oldFormula) {
+          const normalized = "string" != typeof oldFormula || oldFormula.startsWith("=") ? oldFormula : `=${oldFormula}`;
+          return void store.set(cellKey, normalized);
+        }
+      } catch (_a) {}
+      store.set(cellKey, null == currentValue ? "" : currentValue);
+    }
+    function popCellPreChangeContent(args) {
+      const {
+        sheetKey: sheetKey,
+        row: row,
+        col: col,
+        fallbackOldContent: fallbackOldContent,
+        store: store
+      } = args;
+      if (!sheetKey) return fallbackOldContent;
+      const cellKey = makeCellKey(sheetKey, row, col),
+        oldContent = store.get(cellKey);
+      return store.delete(cellKey), void 0 !== oldContent ? oldContent : fallbackOldContent;
+    }
+    function applyCellContent(args) {
+      const {
+        table: table,
+        sheetKey: sheetKey,
+        row: row,
+        col: col,
+        content: content,
+        formulaManager: formulaManager
+      } = args;
+      if (sheetKey && (null == formulaManager ? void 0 : formulaManager.setCellContent) && (null == formulaManager ? void 0 : formulaManager.getCellValue)) {
+        try {
+          formulaManager.setCellContent({
+            sheet: sheetKey,
+            row: row,
+            col: col
+          }, content);
+        } catch (_a) {
+          return void table.changeCellValue(col, row, content, !1, !1, !0);
+        }
+        if ("string" == typeof content && content.startsWith("=")) {
+          const result = formulaManager.getCellValue({
+              sheet: sheetKey,
+              row: row,
+              col: col
+            }),
+            display = (null == result ? void 0 : result.error) ? "#ERROR!" : null == result ? void 0 : result.value;
+          return table.changeCellValue(col, row, display, !1, !1, !0), void refreshDependentDisplays({
+            table: table,
+            sheetKey: sheetKey,
+            startCell: {
+              sheet: sheetKey,
+              row: row,
+              col: col
+            },
+            formulaManager: formulaManager
+          });
+        }
+        return table.changeCellValue(col, row, content, !1, !1, !0), void refreshDependentDisplays({
+          table: table,
+          sheetKey: sheetKey,
+          startCell: {
+            sheet: sheetKey,
+            row: row,
+            col: col
+          },
+          formulaManager: formulaManager
+        });
+      }
+      table.changeCellValue(col, row, content, !1, !1, !0);
+    }
+    function refreshDependentDisplays(args) {
+      var _a;
+      const {
+          table: table,
+          sheetKey: sheetKey,
+          startCell: startCell,
+          formulaManager: formulaManager
+        } = args,
+        maxCells = null !== (_a = args.maxCells) && void 0 !== _a ? _a : 5e3;
+      if (!(null == formulaManager ? void 0 : formulaManager.getCellDependents) || !(null == formulaManager ? void 0 : formulaManager.getCellValue)) return;
+      const visited = new Set(),
+        queue = [...(formulaManager.getCellDependents(startCell) || [])];
+      let processed = 0;
+      for (; queue.length;) {
+        const cell = queue.shift();
+        if (!cell || cell.sheet !== sheetKey) continue;
+        const key = makeCellKey(cell.sheet, cell.row, cell.col);
+        if (visited.has(key)) continue;
+        if (visited.add(key), processed++, processed > maxCells) break;
+        const result = formulaManager.getCellValue(cell),
+          display = (null == result ? void 0 : result.error) ? "#ERROR!" : null == result ? void 0 : result.value;
+        table.changeCellValue(cell.col, cell.row, display, !1, !1, !0);
+        (formulaManager.getCellDependents(cell) || []).forEach(d => queue.push(d));
+      }
+    }
+
+    function cloneMergeConfig(input) {
+      return Array.isArray(input) ? input.map(i => Object.assign(Object.assign({}, i), {
+        range: (null == i ? void 0 : i.range) ? {
+          start: Object.assign({}, i.range.start),
+          end: Object.assign({}, i.range.end)
+        } : null == i ? void 0 : i.range
+      })) : input;
+    }
+    function getCustomMergeCellFunc(customMergeCell) {
+      return "function" == typeof customMergeCell ? customMergeCell : Array.isArray(customMergeCell) ? (col, row) => customMergeCell.find(item => item.range.start.col <= col && item.range.end.col >= col && item.range.start.row <= row && item.range.end.row >= row) : void 0;
+    }
+    function applyMergeConfig(table, customMergeCell) {
+      (null == table ? void 0 : table.options) && (null == table ? void 0 : table.internalProps) && (table.options.customMergeCell = cloneMergeConfig(customMergeCell), table.internalProps.customMergeCell = getCustomMergeCellFunc(table.options.customMergeCell));
+    }
+    function cloneSortState(input) {
+      return input ? Array.isArray(input) ? input.filter(Boolean).map(s => ({
+        field: s.field,
+        order: s.order
+      })) : {
+        field: input.field,
+        order: input.order
+      } : null;
+    }
+    function replayCommand(args) {
+      var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1, _2, _3, _4, _5, _6, _7, _8, _9, _10, _11, _12, _13, _14, _15, _16;
+      const {
+        table: table,
+        vtableSheet: vtableSheet,
+        cmd: cmd,
+        direction: direction,
+        deleteRecordsByReference: deleteRecordsByReference
+      } = args;
+      switch (cmd.type) {
+        case "cell":
+        case "cells":
+          {
+            const sheetKey = cmd.sheetKey;
+            cmd.cells.forEach(c => {
+              const content = "undo" === direction ? c.oldContent : c.newContent;
+              applyCellContent({
+                table: table,
+                sheetKey: sheetKey,
+                row: c.row,
+                col: c.col,
+                content: content,
+                formulaManager: null == vtableSheet ? void 0 : vtableSheet.formulaManager
+              });
+            });
+            break;
+          }
+        case "merge_cells":
+          {
+            const c = cmd,
+              next = "undo" === direction ? c.oldCustomMergeCell : c.newCustomMergeCell;
+            applyMergeConfig(table, next);
+            const sg = table.scenegraph;
+            if (null == sg ? void 0 : sg.updateCellContent) {
+              for (let i = c.startCol; i <= c.endCol; i++) for (let j = c.startRow; j <= c.endRow; j++) sg.updateCellContent(i, j);
+              null === (_a = sg.updateNextFrame) || void 0 === _a || _a.call(sg);
+            } else "function" == typeof table.renderWithRecreateCells && table.renderWithRecreateCells();
+            break;
+          }
+        case "filter":
+          {
+            const c = cmd,
+              pluginId = c.pluginId,
+              snapshot = "undo" === direction ? c.oldSnapshot : c.newSnapshot,
+              pm = table.pluginManager,
+              filterPlugin = null !== (_g = null !== (_e = null !== (_c = null === (_b = null == pm ? void 0 : pm.getPlugin) || void 0 === _b ? void 0 : _b.call(pm, pluginId)) && void 0 !== _c ? _c : null === (_d = null == pm ? void 0 : pm.getPluginByName) || void 0 === _d ? void 0 : _d.call(pm, "Filter")) && void 0 !== _e ? _e : null === (_f = null == pm ? void 0 : pm.getPlugin) || void 0 === _f ? void 0 : _f.call(pm, "filter")) && void 0 !== _g ? _g : null === (_h = null == pm ? void 0 : pm.getPluginByName) || void 0 === _h ? void 0 : _h.call(pm, "filter");
+            (null == filterPlugin ? void 0 : filterPlugin.applyFilterSnapshot) && filterPlugin.applyFilterSnapshot(snapshot);
+            break;
+          }
+        case "sort":
+          {
+            const c = cmd,
+              next = "undo" === direction ? c.oldSortState : c.newSortState;
+            null === (_k = (_j = table).updateSortState) || void 0 === _k || _k.call(_j, null !== (_l = cloneSortState(next)) && void 0 !== _l ? _l : null, !0);
+            break;
+          }
+        case "add_record":
+          {
+            const c = cmd;
+            if ("undo" === direction) {
+              const ds = null === (_m = null == table ? void 0 : table.internalProps) || void 0 === _m ? void 0 : _m.dataSource,
+                rawRecords = null === (_o = null == ds ? void 0 : ds.dataSourceObj) || void 0 === _o ? void 0 : _o.records;
+              let deletedByRaw = !1;
+              if (Array.isArray(rawRecords) && "number" == typeof c.rawInsertIndex && c.recordCount > 0) {
+                const idx = c.rawInsertIndex;
+                idx >= 0 && idx < rawRecords.length && (rawRecords.splice(idx, c.recordCount), deletedByRaw = !0);
+              }
+              if (Array.isArray(rawRecords) && Array.isArray(c.records) && c.records.length) for (let i = 0; i < c.records.length; i++) {
+                const rawIndex = rawRecords.indexOf(c.records[i]);
+                rawIndex >= 0 && (rawRecords.splice(rawIndex, 1), deletedByRaw = !0);
+              }
+              if (!deletedByRaw && Array.isArray(rawRecords) && "number" == typeof c.recordCount && c.recordCount > 0) {
+                const before = c.anchorBefore,
+                  after = c.anchorAfter,
+                  beforeIndex = before ? rawRecords.indexOf(before) : -1,
+                  afterIndex = after ? rawRecords.indexOf(after) : -1;
+                beforeIndex >= 0 ? (rawRecords.splice(beforeIndex + 1, c.recordCount), deletedByRaw = !0) : afterIndex >= 0 && (rawRecords.splice(Math.max(0, afterIndex - c.recordCount), c.recordCount), deletedByRaw = !0);
+              }
+              if (deletedByRaw && (null === (_q = null === (_p = null == ds ? void 0 : ds.beforeChangedRecordsMap) || void 0 === _p ? void 0 : _p.clear) || void 0 === _q || _q.call(_p), null === (_s = null === (_r = null == ds ? void 0 : ds.sortedIndexMap) || void 0 === _r ? void 0 : _r.clear) || void 0 === _s || _s.call(_r), "function" == typeof table.updateFilterRules ? table.updateFilterRules(null === (_t = null == ds ? void 0 : ds.dataConfig) || void 0 === _t ? void 0 : _t.filterRules, {
+                clearRowHeightCache: !1
+              }) : null === (_u = null == ds ? void 0 : ds.updateFilterRules) || void 0 === _u || _u.call(ds, null === (_v = null == ds ? void 0 : ds.dataConfig) || void 0 === _v ? void 0 : _v.filterRules)), !deletedByRaw) if ("number" == typeof c.recordIndex && c.recordCount > 0) {
+                const indexs = [];
+                for (let i = 0; i < c.recordCount; i++) indexs.push(c.recordIndex + i);
+                null === (_x = (_w = table).deleteRecords) || void 0 === _x || _x.call(_w, indexs);
+              } else deleteRecordsByReference(c.records);
+            } else c.records.length && (null === (_z = (_y = table).addRecords) || void 0 === _z || _z.call(_y, c.records, c.recordIndex));
+            break;
+          }
+        case "delete_record":
+          {
+            const c = cmd;
+            if ("undo" === direction) {
+              if (table.addRecord && Array.isArray(c.records) && Array.isArray(c.recordIndexs)) {
+                const pairs = [];
+                for (let i = 0; i < c.recordIndexs.length; i++) {
+                  const idx = c.recordIndexs[i];
+                  "number" == typeof idx && pairs.push({
+                    idx: idx,
+                    record: c.records[i]
+                  });
+                }
+                pairs.sort((a, b) => a.idx - b.idx);
+                for (const p of pairs) table.addRecord(p.record, p.idx);
+              }
+              if (c.deletedRowHeights && "function" == typeof table.setRowHeight) {
+                const headerCount = table.transpose ? table.rowHeaderLevelCount : table.columnHeaderLevelCount;
+                Object.keys(c.deletedRowHeights).forEach(k => {
+                  const idx = Number(k),
+                    height = c.deletedRowHeights[k];
+                  Number.isFinite(idx) && "number" == typeof height && table.setRowHeight(idx + (null != headerCount ? headerCount : 0), height);
+                });
+              }
+            } else table.deleteRecords && table.deleteRecords(c.recordIndexs);
+            if ("oldCustomMergeCell" in c || "newCustomMergeCell" in c) {
+              const target = "undo" === direction ? c.oldCustomMergeCell : c.newCustomMergeCell;
+              applyMergeConfig(table, target);
+              const sg = table.scenegraph;
+              if (null == sg ? void 0 : sg.updateCellContent) {
+                [...(Array.isArray(c.oldCustomMergeCell) ? c.oldCustomMergeCell.map(i => null == i ? void 0 : i.range).filter(Boolean) : []), ...(Array.isArray(c.newCustomMergeCell) ? c.newCustomMergeCell.map(i => null == i ? void 0 : i.range).filter(Boolean) : [])].forEach(r => {
+                  if (null == r ? void 0 : r.start) for (let col = r.start.col; col <= r.end.col; col++) for (let row = r.start.row; row <= r.end.row; row++) sg.updateCellContent(col, row);
+                }), null === (_0 = sg.updateNextFrame) || void 0 === _0 || _0.call(sg);
+              } else "function" == typeof table.renderWithRecreateCells && table.renderWithRecreateCells();
+            }
+            break;
+          }
+        case "update_record":
+          {
+            const c = cmd;
+            table.updateRecords && ("undo" === direction ? table.updateRecords(c.oldRecords, c.recordIndexs) : table.updateRecords(c.newRecords, c.recordIndexs));
+            break;
+          }
+        case "add_column":
+          {
+            const c = cmd;
+            if ("undo" === direction) {
+              const deleteIndexs = [];
+              for (let i = 0; i < c.columnCount; i++) deleteIndexs.push(c.columnIndex + i);
+              null === (_2 = (_1 = table).deleteColumns) || void 0 === _2 || _2.call(_1, deleteIndexs, !0);
+            } else null === (_4 = (_3 = table).addColumns) || void 0 === _4 || _4.call(_3, c.columns, c.columnIndex, !0);
+            break;
+          }
+        case "delete_column":
+          {
+            const c = cmd;
+            if ("undo" === direction) {
+              if (c.deleteColIndexs.map((idx, i) => ({
+                idx: idx,
+                column: c.columns[i]
+              })).sort((a, b) => a.idx - b.idx).forEach(item => {
+                var _a, _b;
+                null === (_b = (_a = table).addColumns) || void 0 === _b || _b.call(_a, [item.column], item.idx, !0);
+              }), c.deletedColWidths && "function" == typeof table.setColWidth && Object.entries(c.deletedColWidths).forEach(([k, width]) => {
+                const idx = Number(k);
+                Number.isFinite(idx) && "number" == typeof width && table.setColWidth(idx, width);
+              }), Array.isArray(c.deletedRecordValues) && c.deletedRecordValues.length) {
+                const records = table.records;
+                if (Array.isArray(records) && records.length) {
+                  const recordIndexs = [],
+                    newRecords = [];
+                  for (let i = 0; i < records.length; i++) {
+                    const rec = records[i],
+                      rowValues = c.deletedRecordValues[i];
+                    if (!Array.isArray(rec) || !Array.isArray(rowValues) || rowValues.length !== c.deleteColIndexs.length) continue;
+                    const next = rec.slice();
+                    for (let k = 0; k < c.deleteColIndexs.length; k++) next[c.deleteColIndexs[k]] = rowValues[k];
+                    recordIndexs.push(i), newRecords.push(next);
+                  }
+                  recordIndexs.length && (null === (_6 = (_5 = table).updateRecords) || void 0 === _6 || _6.call(_5, newRecords, recordIndexs, !1));
+                }
+              }
+              if (c.sheetKey) {
+                const fm = null == vtableSheet ? void 0 : vtableSheet.formulaManager,
+                  engine = null == fm ? void 0 : fm.formulaEngine;
+                if ((null == fm ? void 0 : fm.normalizeSheetData) && (null == engine ? void 0 : engine.updateSheetData)) try {
+                  const normalized = fm.normalizeSheetData(table.records || [], table);
+                  engine.updateSheetData(c.sheetKey, normalized);
+                } catch (_17) {}
+              }
+              if (c.sheetKey && c.deletedFormulas) {
+                Object.entries(c.deletedFormulas).forEach(([cellRef, formula]) => {
+                  const parsed = parseA1Notation(cellRef);
+                  parsed && applyCellContent({
+                    table: table,
+                    sheetKey: c.sheetKey,
+                    row: parsed.row,
+                    col: parsed.col,
+                    content: formula,
+                    formulaManager: null == vtableSheet ? void 0 : vtableSheet.formulaManager
+                  });
+                });
+              }
+            } else null === (_8 = (_7 = table).deleteColumns) || void 0 === _8 || _8.call(_7, c.deleteColIndexs, !0);
+            break;
+          }
+        case "change_header_position":
+          {
+            const c = cmd,
+              moving = c.moving,
+              from = "undo" === direction ? c.targetIndex : c.sourceIndex,
+              to = "undo" === direction ? c.sourceIndex : c.targetIndex;
+            "column" === moving ? null === (_10 = (_9 = table).changeHeaderPosition) || void 0 === _10 || _10.call(_9, {
+              source: {
+                col: from,
+                row: 0
+              },
+              target: {
+                col: to,
+                row: 0
+              },
+              movingColumnOrRow: "column"
+            }) : null === (_12 = (_11 = table).changeHeaderPosition) || void 0 === _12 || _12.call(_11, {
+              source: {
+                col: 0,
+                row: from
+              },
+              target: {
+                col: 0,
+                row: to
+              },
+              movingColumnOrRow: "row"
+            });
+            break;
+          }
+        case "resize_row":
+          {
+            const c = cmd,
+              height = "undo" === direction ? c.oldHeight : c.newHeight;
+            null === (_14 = (_13 = table).setRowHeight) || void 0 === _14 || _14.call(_13, c.row, height);
+            break;
+          }
+        case "resize_column":
+          {
+            const c = cmd,
+              width = "undo" === direction ? c.oldWidth : c.newWidth;
+            null === (_16 = (_15 = table).setColWidth) || void 0 === _16 || _16.call(_15, c.col, width);
+            break;
+          }
+      }
+    }
+
+    function cloneDeep(input, cache = new WeakMap()) {
+      if (null == input) return input;
+      const t = typeof input;
+      if ("function" === t || "object" !== t) return input;
+      const obj = input;
+      if (obj instanceof Date) return new Date(obj.getTime());
+      if (obj instanceof RegExp) return new RegExp(obj);
+      if (cache.has(obj)) return cache.get(obj);
+      if (Array.isArray(obj)) {
+        const arr = [];
+        cache.set(obj, arr);
+        for (let i = 0; i < obj.length; i++) arr[i] = cloneDeep(obj[i], cache);
+        return arr;
+      }
+      const out = {};
+      return cache.set(obj, out), Object.keys(obj).forEach(key => {
+        out[key] = cloneDeep(obj[key], cache);
+      }), out;
+    }
+    function captureSnapshot(table, state, options) {
+      var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+      const tableOptions = table.options || {},
+        columns = tableOptions.columns;
+      Array.isArray(columns) ? state.prevColumnsSnapshot = columns.map(c => cloneDeep(c)) : state.prevColumnsSnapshot = null;
+      const merge = tableOptions.customMergeCell;
+      Array.isArray(merge) ? state.prevMergeSnapshot = merge.map(m => Object.assign(Object.assign({}, m), {
+        range: {
+          start: Object.assign({}, m.range.start),
+          end: Object.assign({}, m.range.end)
+        }
+      })) : state.prevMergeSnapshot = merge;
+      const records = table.records || [];
+      Array.isArray(records) ? state.prevRecordsSnapshot = records.map(r => cloneRecord(r)) : state.prevRecordsSnapshot = null;
+      try {
+        const resizedRowIndexs = Array.from(null !== (_d = null === (_c = null === (_b = null === (_a = table.internalProps) || void 0 === _a ? void 0 : _a._heightResizedRowMap) || void 0 === _b ? void 0 : _b.keys) || void 0 === _c ? void 0 : _c.call(_b)) && void 0 !== _d ? _d : []);
+        if (resizedRowIndexs.length && "function" == typeof table.getRowHeight) {
+          const map = {};
+          resizedRowIndexs.forEach(rowIndex => {
+            if ("number" != typeof rowIndex) return;
+            const h = table.getRowHeight(rowIndex);
+            "number" == typeof h && (map[rowIndex] = h);
+          }), state.prevResizedRowHeightsSnapshot = map;
+        } else state.prevResizedRowHeightsSnapshot = null;
+      } catch (_k) {
+        state.prevResizedRowHeightsSnapshot = null;
+      }
+      try {
+        const resizedColIndexs = Array.from(null !== (_h = null === (_g = null === (_f = null === (_e = table.internalProps) || void 0 === _e ? void 0 : _e._widthResizedColMap) || void 0 === _f ? void 0 : _f.keys) || void 0 === _g ? void 0 : _g.call(_f)) && void 0 !== _h ? _h : []);
+        if (resizedColIndexs.length && "function" == typeof table.getColWidth) {
+          const map = {};
+          resizedColIndexs.forEach(colIndex => {
+            if ("number" != typeof colIndex) return;
+            const w = table.getColWidth(colIndex);
+            "number" == typeof w && (map[colIndex] = w);
+          }), state.prevResizedColWidthsSnapshot = map;
+        } else state.prevResizedColWidthsSnapshot = null;
+      } catch (_l) {
+        state.prevResizedColWidthsSnapshot = null;
+      }
+      if ((null === (_j = null == options ? void 0 : options.formulaManager) || void 0 === _j ? void 0 : _j.exportFormulas) && options.sheetKey) try {
+        const formulas = options.formulaManager.exportFormulas(options.sheetKey);
+        state.prevFormulasSnapshot = formulas ? Object.assign({}, formulas) : null;
+      } catch (_m) {
+        state.prevFormulasSnapshot = null;
+      } else state.prevFormulasSnapshot = null;
+    }
+    function cloneRecord(record) {
+      return Array.isArray(record) ? record.slice() : record && "object" == typeof record ? Object.assign({}, record) : record;
+    }
+
+    function resolveSheetKey(args) {
+      var _a, _b, _c;
+      const {
+        vtableSheet: vtableSheet,
+        table: table,
+        cached: cached
+      } = args;
+      if (!vtableSheet) return {
+        sheetKey: void 0,
+        cached: void 0
+      };
+      if (cached) return {
+        sheetKey: cached,
+        cached: cached
+      };
+      try {
+        const workSheetInstances = vtableSheet.workSheetInstances;
+        if (workSheetInstances && table) for (const [sheetKey, worksheet] of workSheetInstances.entries()) if ((null == worksheet ? void 0 : worksheet.tableInstance) === table) return {
+          sheetKey: sheetKey,
+          cached: sheetKey
+        };
+        const active = null === (_a = vtableSheet.getActiveSheet) || void 0 === _a ? void 0 : _a.call(vtableSheet);
+        if (null == active ? void 0 : active.getKey) {
+          const key = active.getKey();
+          return {
+            sheetKey: key,
+            cached: key
+          };
+        }
+        const activeDefine = null === (_c = null === (_b = vtableSheet.sheetManager) || void 0 === _b ? void 0 : _b.getActiveSheet) || void 0 === _c ? void 0 : _c.call(_b),
+          key = null == activeDefine ? void 0 : activeDefine.sheetKey;
+        return {
+          sheetKey: key,
+          cached: key
+        };
+      } catch (_d) {
+        return {
+          sheetKey: void 0,
+          cached: void 0
+        };
+      }
+    }
+
+    class HistoryPlugin {
+      constructor(options) {
+        var _a, _b, _c;
+        this.id = "history-plugin", this.name = "History", this.runTime = [TABLE_EVENT_TYPE.BEFORE_INIT, TABLE_EVENT_TYPE.INITIALIZED, TABLE_EVENT_TYPE.BEFORE_KEYDOWN, TABLE_EVENT_TYPE.CHANGE_CELL_VALUE, TABLE_EVENT_TYPE.CHANGE_CELL_VALUES, TABLE_EVENT_TYPE.PASTED_DATA, TABLE_EVENT_TYPE.MERGE_CELLS, TABLE_EVENT_TYPE.UNMERGE_CELLS, TABLE_EVENT_TYPE.ADD_RECORD, TABLE_EVENT_TYPE.DELETE_RECORD, TABLE_EVENT_TYPE.UPDATE_RECORD, TABLE_EVENT_TYPE.ADD_COLUMN, TABLE_EVENT_TYPE.DELETE_COLUMN, TABLE_EVENT_TYPE.CHANGE_HEADER_POSITION, TABLE_EVENT_TYPE.SORT_CLICK, TABLE_EVENT_TYPE.RESIZE_ROW, TABLE_EVENT_TYPE.RESIZE_ROW_END, TABLE_EVENT_TYPE.RESIZE_COLUMN, TABLE_EVENT_TYPE.RESIZE_COLUMN_END], this.table = null, this.undoStack = [], this.redoStack = [], this.currentTransaction = null, this.isReplaying = !1, this.prevColumnsSnapshot = null, this.prevRecordsSnapshot = null, this.prevFormulasSnapshot = null, this.prevResizedRowHeightsSnapshot = null, this.prevResizedColWidthsSnapshot = null, this.lastKnownSortState = null, this.sortStartSnapshot = null, this.sortPending = !1, this.sortEventBound = !1, this.cellPreChangeContent = new Map(), this.formulaCache = new Map(), this.formulaEventBound = !1, this.resizeRowStartHeight = new Map(), this.resizeColStartWidth = new Map(), this.filterEventBound = !1, this.filterUnsubscribe = null, this.filterApplyingSnapshot = !1, this.id = null !== (_a = null == options ? void 0 : options.id) && void 0 !== _a ? _a : this.id, this.maxHistory = null !== (_b = null == options ? void 0 : options.maxHistory) && void 0 !== _b ? _b : 100, this.enableCompression = null !== (_c = null == options ? void 0 : options.enableCompression) && void 0 !== _c && _c, this.onTransactionPushed = null == options ? void 0 : options.onTransactionPushed;
+      }
+      run(...args) {
+        var _a, _b, _c, _d, _e, _f;
+        const eventArgs = args[0],
+          runtime = args[1],
+          table = args[2];
+        if (!table) return;
+        if (this.table) this.vtableSheet || (this.vtableSheet = table.__vtableSheet);else if (this.table = table, this.vtableSheet = table.__vtableSheet, runtime !== TABLE_EVENT_TYPE.BEFORE_INIT && (null === (_a = table.internalProps) || void 0 === _a ? void 0 : _a.dataSource)) {
+          const state = this.getSnapshotState(),
+            sheetKey = this.getSheetKey();
+          captureSnapshot(table, state, {
+            formulaManager: null === (_b = this.vtableSheet) || void 0 === _b ? void 0 : _b.formulaManager,
+            sheetKey: sheetKey
+          }), this.setSnapshotState(state), this.lastKnownSortState = this.normalizeSortState(null === (_c = table.internalProps) || void 0 === _c ? void 0 : _c.sortState);
+        }
+        if (this.ensureFilterEventBindings(), runtime === TABLE_EVENT_TYPE.BEFORE_INIT) return;
+        this.ensureFormulaEventBindings(), this.ensureSortEventBindings();
+        const workbookReplaying = null === (_e = null === (_d = this.table) || void 0 === _d ? void 0 : _d.__vtableSheet) || void 0 === _e ? void 0 : _e.__workbookHistoryReplaying;
+        if (!this.isReplaying && !workbookReplaying) {
+          switch (runtime) {
+            case TABLE_EVENT_TYPE.INITIALIZED:
+              break;
+            case TABLE_EVENT_TYPE.BEFORE_KEYDOWN:
+              this.handleBeforeKeydown(eventArgs);
+              break;
+            case TABLE_EVENT_TYPE.CHANGE_CELL_VALUE:
+              this.handleChangeCellValue(eventArgs);
+              break;
+            case TABLE_EVENT_TYPE.CHANGE_CELL_VALUES:
+              this.handleChangeCellValues(eventArgs);
+              break;
+            case TABLE_EVENT_TYPE.PASTED_DATA:
+              break;
+            case TABLE_EVENT_TYPE.MERGE_CELLS:
+              this.handleMergeCells(eventArgs);
+              break;
+            case TABLE_EVENT_TYPE.UNMERGE_CELLS:
+              this.handleUnmergeCells(eventArgs);
+              break;
+            case TABLE_EVENT_TYPE.ADD_RECORD:
+              this.handleAddRecord(eventArgs);
+              break;
+            case TABLE_EVENT_TYPE.DELETE_RECORD:
+              this.handleDeleteRecord(eventArgs);
+              break;
+            case TABLE_EVENT_TYPE.UPDATE_RECORD:
+              this.handleUpdateRecord(eventArgs);
+              break;
+            case TABLE_EVENT_TYPE.ADD_COLUMN:
+              this.handleAddColumn(eventArgs);
+              break;
+            case TABLE_EVENT_TYPE.DELETE_COLUMN:
+              this.handleDeleteColumn(eventArgs);
+              break;
+            case TABLE_EVENT_TYPE.CHANGE_HEADER_POSITION:
+              this.handleChangeHeaderPosition(eventArgs);
+              break;
+            case TABLE_EVENT_TYPE.SORT_CLICK:
+              this.handleSortClick(eventArgs);
+              break;
+            case TABLE_EVENT_TYPE.RESIZE_ROW:
+              this.handleResizeRow(eventArgs);
+              break;
+            case TABLE_EVENT_TYPE.RESIZE_ROW_END:
+              this.handleResizeRowEnd(eventArgs);
+              break;
+            case TABLE_EVENT_TYPE.RESIZE_COLUMN:
+              this.handleResizeColumn(eventArgs);
+              break;
+            case TABLE_EVENT_TYPE.RESIZE_COLUMN_END:
+              this.handleResizeColumnEnd(eventArgs);
+          }
+          if (this.table) {
+            const state = this.getSnapshotState(),
+              sheetKey = this.getSheetKey();
+            captureSnapshot(this.table, state, {
+              formulaManager: null === (_f = this.vtableSheet) || void 0 === _f ? void 0 : _f.formulaManager,
+              sheetKey: sheetKey
+            }), this.setSnapshotState(state);
+          }
+        }
+      }
+      startTransaction() {
+        this.currentTransaction || (this.currentTransaction = {
+          commands: []
+        });
+      }
+      endTransaction() {
+        this.currentTransaction && 0 !== this.currentTransaction.commands.length ? (this.pushTransaction(this.currentTransaction), this.currentTransaction = null) : this.currentTransaction = null;
+      }
+      undo() {
+        var _a;
+        if (!this.table || 0 === this.undoStack.length) return;
+        const transaction = this.undoStack.pop();
+        this.isReplaying = !0;
+        try {
+          for (let i = transaction.commands.length - 1; i >= 0; i--) this.applyCommand(transaction.commands[i], "undo");
+        } finally {
+          this.isReplaying = !1;
+        }
+        if (this.redoStack.push(transaction), this.table) {
+          const state = this.getSnapshotState(),
+            sheetKey = this.getSheetKey();
+          captureSnapshot(this.table, state, {
+            formulaManager: null === (_a = this.vtableSheet) || void 0 === _a ? void 0 : _a.formulaManager,
+            sheetKey: sheetKey
+          }), this.setSnapshotState(state);
+        }
+      }
+      redo() {
+        var _a;
+        if (!this.table || 0 === this.redoStack.length) return;
+        const transaction = this.redoStack.pop();
+        this.isReplaying = !0;
+        try {
+          for (const cmd of transaction.commands) this.applyCommand(cmd, "redo");
+        } finally {
+          this.isReplaying = !1;
+        }
+        if (this.undoStack.push(transaction), this.table) {
+          const state = this.getSnapshotState(),
+            sheetKey = this.getSheetKey();
+          captureSnapshot(this.table, state, {
+            formulaManager: null === (_a = this.vtableSheet) || void 0 === _a ? void 0 : _a.formulaManager,
+            sheetKey: sheetKey
+          }), this.setSnapshotState(state);
+        }
+      }
+      clear() {
+        this.undoStack = [], this.redoStack = [], this.currentTransaction = null;
+      }
+      updateOptions(options) {
+        null != options.maxHistory && (this.maxHistory = options.maxHistory, this.trimHistory()), null != options.enableCompression && (this.enableCompression = options.enableCompression), options.onTransactionPushed && (this.onTransactionPushed = options.onTransactionPushed);
+      }
+      release() {
+        this.clear(), this.unbindFormulaEvents(), this.unbindSortEvents(), this.unbindFilterEvents(), this.table = null, this.vtableSheet = null, this.resolvedSheetKey = void 0, this.prevColumnsSnapshot = null, this.prevMergeSnapshot = void 0, this.prevRecordsSnapshot = null, this.prevFormulasSnapshot = null, this.prevResizedRowHeightsSnapshot = null, this.prevResizedColWidthsSnapshot = null, this.lastKnownSortState = null, this.sortStartSnapshot = null, this.sortPending = !1, this.sortEventBound = !1, this.sortChangeOrderListenerId = void 0, this.cellPreChangeContent.clear(), this.formulaCache.clear(), this.resizeRowStartHeight.clear(), this.resizeColStartWidth.clear(), this.filterEventBound = !1, this.filterUnsubscribe = null, this.filterSnapshotCache = void 0, this.filterPluginId = void 0;
+      }
+      ensureFilterEventBindings() {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+        if (!this.table) return;
+        const pm = this.table.pluginManager,
+          filterPlugin = null !== (_f = null !== (_d = null !== (_b = null === (_a = null == pm ? void 0 : pm.getPlugin) || void 0 === _a ? void 0 : _a.call(pm, "filter")) && void 0 !== _b ? _b : null === (_c = null == pm ? void 0 : pm.getPluginByName) || void 0 === _c ? void 0 : _c.call(pm, "Filter")) && void 0 !== _d ? _d : null === (_e = null == pm ? void 0 : pm.getPlugin) || void 0 === _e ? void 0 : _e.call(pm, "filter-plugin")) && void 0 !== _f ? _f : null === (_g = null == pm ? void 0 : pm.getPluginByName) || void 0 === _g ? void 0 : _g.call(pm, "filter-plugin");
+        if (!(null == filterPlugin ? void 0 : filterPlugin.getFilterSnapshot) || !(null == filterPlugin ? void 0 : filterPlugin.applyFilterSnapshot)) return;
+        this.filterEventBound || (this.filterEventBound = !0, this.filterPluginRef = filterPlugin, this.filterPluginId = null !== (_h = filterPlugin.id) && void 0 !== _h ? _h : "filter", this.filterSnapshotCache = cloneDeep(filterPlugin.getFilterSnapshot())), this.filterApplySnapshotOriginal || (this.filterApplySnapshotOriginal = null === (_j = filterPlugin.applyFilterSnapshot) || void 0 === _j ? void 0 : _j.bind(filterPlugin), this.filterApplySnapshotOriginal && (filterPlugin.applyFilterSnapshot = snapshot => {
+          var _a, _b;
+          if (this.isReplaying) return this.filterApplySnapshotOriginal(snapshot);
+          const oldSnapshot = null !== (_a = this.filterSnapshotCache) && void 0 !== _a ? _a : filterPlugin.getFilterSnapshot();
+          this.filterApplyingSnapshot = !0;
+          try {
+            return this.filterApplySnapshotOriginal(snapshot);
+          } finally {
+            this.filterApplyingSnapshot = !1;
+            const newSnapshot = filterPlugin.getFilterSnapshot();
+            if (JSON.stringify(oldSnapshot) !== JSON.stringify(newSnapshot)) {
+              const cmd = {
+                type: "filter",
+                sheetKey: this.getSheetKey(),
+                pluginId: null !== (_b = this.filterPluginId) && void 0 !== _b ? _b : "filter",
+                oldSnapshot: oldSnapshot,
+                newSnapshot: newSnapshot
+              };
+              this.pushCommand(cmd), this.filterSnapshotCache = cloneDeep(newSnapshot);
+            } else this.filterSnapshotCache = cloneDeep(newSnapshot);
+          }
+        }));
+        const stateManager = null == filterPlugin ? void 0 : filterPlugin.filterStateManager;
+        !this.filterUnsubscribe && (null == stateManager ? void 0 : stateManager.subscribe) && (this.filterUnsubscribe = stateManager.subscribe((_state, action) => {
+          var _a, _b;
+          if (this.isReplaying) return;
+          if (this.filterApplyingSnapshot) return void (this.filterSnapshotCache = cloneDeep(filterPlugin.getFilterSnapshot()));
+          const t = null == action ? void 0 : action.type;
+          if (t !== FilterActionType.APPLY_FILTERS && t !== FilterActionType.CLEAR_ALL_FILTERS && t !== FilterActionType.REMOVE_FILTER && t !== FilterActionType.DISABLE_FILTER) return;
+          const oldSnapshot = null !== (_a = this.filterSnapshotCache) && void 0 !== _a ? _a : filterPlugin.getFilterSnapshot(),
+            newSnapshot = filterPlugin.getFilterSnapshot();
+          if (JSON.stringify(oldSnapshot) === JSON.stringify(newSnapshot)) return;
+          const cmd = {
+            type: "filter",
+            sheetKey: this.getSheetKey(),
+            pluginId: null !== (_b = this.filterPluginId) && void 0 !== _b ? _b : "filter",
+            oldSnapshot: oldSnapshot,
+            newSnapshot: newSnapshot
+          };
+          this.pushCommand(cmd), this.filterSnapshotCache = cloneDeep(newSnapshot);
+        }));
+      }
+      unbindFilterEvents() {
+        var _a;
+        null === (_a = this.filterUnsubscribe) || void 0 === _a || _a.call(this), this.filterUnsubscribe = null, this.filterEventBound = !1, this.filterPluginRef && this.filterApplySnapshotOriginal && (this.filterPluginRef.applyFilterSnapshot = this.filterApplySnapshotOriginal), this.filterPluginRef = null, this.filterApplySnapshotOriginal = null, this.filterApplyingSnapshot = !1;
+      }
+      getSheetKey() {
+        const resolved = resolveSheetKey({
+          vtableSheet: this.vtableSheet,
+          table: this.table,
+          cached: this.resolvedSheetKey
+        });
+        return this.resolvedSheetKey = resolved.cached, resolved.sheetKey;
+      }
+      getSnapshotState() {
+        return {
+          prevColumnsSnapshot: this.prevColumnsSnapshot,
+          prevMergeSnapshot: this.prevMergeSnapshot,
+          prevRecordsSnapshot: this.prevRecordsSnapshot,
+          prevFormulasSnapshot: this.prevFormulasSnapshot,
+          prevResizedRowHeightsSnapshot: this.prevResizedRowHeightsSnapshot,
+          prevResizedColWidthsSnapshot: this.prevResizedColWidthsSnapshot
+        };
+      }
+      setSnapshotState(next) {
+        var _a, _b, _c;
+        this.prevColumnsSnapshot = next.prevColumnsSnapshot, this.prevMergeSnapshot = next.prevMergeSnapshot, this.prevRecordsSnapshot = next.prevRecordsSnapshot, this.prevFormulasSnapshot = null !== (_a = next.prevFormulasSnapshot) && void 0 !== _a ? _a : null, this.prevResizedRowHeightsSnapshot = null !== (_b = next.prevResizedRowHeightsSnapshot) && void 0 !== _b ? _b : null, this.prevResizedColWidthsSnapshot = null !== (_c = next.prevResizedColWidthsSnapshot) && void 0 !== _c ? _c : null;
+      }
+      pushTransaction(tx) {
+        var _a, _b, _c;
+        if (0 !== tx.commands.length && (this.undoStack.push(tx), this.redoStack = [], this.trimHistory(), this.onTransactionPushed && !this.isReplaying)) {
+          (null === (_b = null === (_a = this.table) || void 0 === _a ? void 0 : _a.__vtableSheet) || void 0 === _b ? void 0 : _b.__workbookHistoryReplaying) || this.onTransactionPushed({
+            tx: tx,
+            sheetKey: this.getSheetKey(),
+            table: null !== (_c = this.table) && void 0 !== _c ? _c : void 0
+          });
+        }
+      }
+      trimHistory() {
+        this.undoStack.length > this.maxHistory && this.undoStack.splice(0, this.undoStack.length - this.maxHistory);
+      }
+      pushCommand(cmd) {
+        this.currentTransaction ? this.currentTransaction.commands.push(cmd) : this.pushTransaction({
+          commands: [cmd]
+        });
+      }
+      recordExternalCommand(cmd) {
+        this.isReplaying || this.pushCommand(cmd);
+      }
+      tryCompressCellChange(change, sheetKey) {
+        if (!this.enableCompression) return !1;
+        const targetTx = this.currentTransaction || this.undoStack[this.undoStack.length - 1];
+        if (!targetTx || 0 === targetTx.commands.length) return !1;
+        const last = targetTx.commands[targetTx.commands.length - 1];
+        if (("cell" === last.type || "cells" === last.type) && last.sheetKey === sheetKey) {
+          const cells = last.cells;
+          if (1 === cells.length && cells[0].row === change.row && cells[0].col === change.col) return cells[0].newContent = change.newContent, !0;
+        }
+        return !1;
+      }
+      handleBeforeKeydown(eventArgs) {
+        var _a, _b, _c, _d, _e, _f;
+        const e = eventArgs.event;
+        if (!e || !this.table) return;
+        if (!(e.ctrlKey || e.metaKey)) return;
+        const formulaManager = null === (_a = this.vtableSheet) || void 0 === _a ? void 0 : _a.formulaManager;
+        if (null == formulaManager ? void 0 : formulaManager.formulaWorkingOnCell) return;
+        if (null === (_b = this.table.editorManager) || void 0 === _b ? void 0 : _b.editingEditor) return;
+        const key = e.key.toLowerCase();
+        if ("z" === key) {
+          const workbookHistory = null === (_d = null === (_c = this.vtableSheet) || void 0 === _c ? void 0 : _c.getWorkbookHistoryManager) || void 0 === _d ? void 0 : _d.call(_c);
+          e.shiftKey ? workbookHistory ? workbookHistory.redo() : this.redo() : workbookHistory ? workbookHistory.undo() : this.undo(), e.preventDefault(), e.stopPropagation();
+        } else if ("y" === key) {
+          const workbookHistory = null === (_f = null === (_e = this.vtableSheet) || void 0 === _e ? void 0 : _e.getWorkbookHistoryManager) || void 0 === _f ? void 0 : _f.call(_e);
+          workbookHistory ? workbookHistory.redo() : this.redo(), e.preventDefault(), e.stopPropagation();
+        }
+      }
+      handleChangeCellValue(eventArgs) {
+        var _a;
+        captureCellPreChangeContent({
+          sheetKey: this.getSheetKey(),
+          row: eventArgs.row,
+          col: eventArgs.col,
+          currentValue: eventArgs.currentValue,
+          formulaManager: null === (_a = this.vtableSheet) || void 0 === _a ? void 0 : _a.formulaManager,
+          store: this.cellPreChangeContent
+        });
+      }
+      handleChangeCellValues(eventArgs) {
+        var _a;
+        if (!this.table) return;
+        const sheetKey = this.getSheetKey(),
+          formulaManager = null === (_a = this.vtableSheet) || void 0 === _a ? void 0 : _a.formulaManager,
+          cells = eventArgs.values.map(v => {
+            const oldContent = popCellPreChangeContent({
+                sheetKey: sheetKey,
+                row: v.row,
+                col: v.col,
+                fallbackOldContent: v.currentValue,
+                store: this.cellPreChangeContent
+              }),
+              normalizedOld = null == oldContent ? "" : oldContent,
+              normalizedNew = null == v.changedValue ? "" : v.changedValue;
+            return {
+              row: v.row,
+              col: v.col,
+              oldContent: normalizedOld,
+              newContent: normalizedNew
+            };
+          }).filter(c => {
+            if (c.oldContent === c.newContent) return !1;
+            if (!sheetKey || !(null == formulaManager ? void 0 : formulaManager.getCellFormula) || !(null == formulaManager ? void 0 : formulaManager.getCellValue)) return !0;
+            if ("string" == typeof c.newContent && c.newContent.startsWith("=")) return !1;
+            if (!formulaManager.getCellFormula({
+              sheet: sheetKey,
+              row: c.row,
+              col: c.col
+            })) return !0;
+            const result = formulaManager.getCellValue({
+                sheet: sheetKey,
+                row: c.row,
+                col: c.col
+              }),
+              display = (null == result ? void 0 : result.error) ? "#ERROR!" : null == result ? void 0 : result.value;
+            return display !== c.newContent && (null == display || null == c.newContent || String(display) !== String(c.newContent));
+          });
+        if (!cells.length) return;
+        if (sheetKey && 1 === cells.length && this.tryCompressCellChange(cells[0], sheetKey)) return;
+        const cmd = {
+          type: "cells",
+          sheetKey: sheetKey,
+          cells: cells
+        };
+        this.pushCommand(cmd);
+      }
+      ensureFormulaEventBindings() {
+        var _a, _b, _c, _d, _e;
+        if (!this.table || !this.vtableSheet || this.formulaEventBound) return;
+        const sheetKey = this.getSheetKey();
+        if (!sheetKey) return;
+        const worksheet = null !== (_c = null === (_b = (_a = this.vtableSheet).getWorkSheetByKey) || void 0 === _b ? void 0 : _b.call(_a, sheetKey)) && void 0 !== _c ? _c : null === (_e = null === (_d = this.vtableSheet.workSheetInstances) || void 0 === _d ? void 0 : _d.get) || void 0 === _e ? void 0 : _e.call(_d, sheetKey),
+          eventManager = null == worksheet ? void 0 : worksheet.eventManager;
+        (null == eventManager ? void 0 : eventManager.on) && (null == eventManager ? void 0 : eventManager.off) && (this.formulaEventBound = !0, this.formulaEventManager = eventManager, this.onFormulaAddedHandler = event => {
+          if (this.isReplaying) return;
+          const cell = null == event ? void 0 : event.cell,
+            formula = null == event ? void 0 : event.formula;
+          if (!cell || "number" != typeof cell.row || "number" != typeof cell.col) return;
+          if ("string" != typeof formula || !formula.length) return;
+          const normalized = formula.startsWith("=") ? formula : `=${formula}`,
+            key = `${sheetKey}:${cell.row}:${cell.col}`,
+            prev = this.formulaCache.get(key),
+            oldContent = popCellPreChangeContent({
+              sheetKey: sheetKey,
+              row: cell.row,
+              col: cell.col,
+              fallbackOldContent: void 0 !== prev ? prev : "",
+              store: this.cellPreChangeContent
+            });
+          if (oldContent === normalized) return void this.formulaCache.set(key, normalized);
+          const cmd = {
+            type: "cells",
+            sheetKey: sheetKey,
+            cells: [{
+              row: cell.row,
+              col: cell.col,
+              oldContent: oldContent,
+              newContent: normalized
+            }]
+          };
+          this.pushCommand(cmd), this.formulaCache.set(key, normalized);
+        }, eventManager.on("formula_added", this.onFormulaAddedHandler));
+      }
+      ensureSortEventBindings() {
+        var _a;
+        if (!this.table || this.sortEventBound) return;
+        const ds = null === (_a = this.table.internalProps) || void 0 === _a ? void 0 : _a.dataSource;
+        (null == ds ? void 0 : ds.on) && (null == ds ? void 0 : ds.off) && (this.sortEventBound = !0, this.sortChangeOrderListenerId = ds.on("change_order", () => {
+          var _a;
+          if (this.isReplaying || !this.table || !this.sortPending) return;
+          const sheetKey = this.getSheetKey(),
+            oldSortState = this.sortStartSnapshot;
+          this.sortStartSnapshot = null, this.sortPending = !1;
+          const newSortState = this.normalizeSortState(null === (_a = this.table.internalProps) || void 0 === _a ? void 0 : _a.sortState);
+          if (JSON.stringify(oldSortState) === JSON.stringify(newSortState)) return void (this.lastKnownSortState = newSortState);
+          const cmd = {
+            type: "sort",
+            sheetKey: sheetKey,
+            oldSortState: oldSortState,
+            newSortState: newSortState
+          };
+          this.pushCommand(cmd), this.lastKnownSortState = newSortState;
+        }));
+      }
+      unbindSortEvents() {
+        var _a, _b;
+        if (!this.sortEventBound) return;
+        const ds = null === (_b = null === (_a = this.table) || void 0 === _a ? void 0 : _a.internalProps) || void 0 === _b ? void 0 : _b.dataSource;
+        try {
+          (null == ds ? void 0 : ds.off) && this.sortChangeOrderListenerId && ds.off(this.sortChangeOrderListenerId);
+        } catch (_c) {} finally {
+          this.sortEventBound = !1, this.sortChangeOrderListenerId = void 0, this.sortPending = !1, this.sortStartSnapshot = null;
+        }
+      }
+      unbindFormulaEvents() {
+        if (this.formulaEventBound && this.formulaEventManager) try {
+          this.onFormulaAddedHandler && this.formulaEventManager.off("formula_added", this.onFormulaAddedHandler);
+        } catch (_a) {} finally {
+          this.formulaEventBound = !1, this.formulaEventManager = void 0, this.onFormulaAddedHandler = void 0;
+        }
+      }
+      cloneMergeConfig(input) {
+        return Array.isArray(input) ? input.map(i => cloneDeep(i)) : input;
+      }
+      isSameMergeConfig(a, b) {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
+        const normalize = v => null == v ? [] : (v),
+          aa = normalize(a),
+          bb = normalize(b);
+        if (aa === bb) return !0;
+        if (Array.isArray(aa) && Array.isArray(bb)) {
+          if (aa.length !== bb.length) return !1;
+          for (let i = 0; i < aa.length; i++) {
+            const ra = null === (_a = aa[i]) || void 0 === _a ? void 0 : _a.range,
+              rb = null === (_b = bb[i]) || void 0 === _b ? void 0 : _b.range;
+            if (!ra || !rb || (null === (_c = ra.start) || void 0 === _c ? void 0 : _c.col) !== (null === (_d = rb.start) || void 0 === _d ? void 0 : _d.col) || (null === (_e = ra.start) || void 0 === _e ? void 0 : _e.row) !== (null === (_f = rb.start) || void 0 === _f ? void 0 : _f.row) || (null === (_g = ra.end) || void 0 === _g ? void 0 : _g.col) !== (null === (_h = rb.end) || void 0 === _h ? void 0 : _h.col) || (null === (_j = ra.end) || void 0 === _j ? void 0 : _j.row) !== (null === (_k = rb.end) || void 0 === _k ? void 0 : _k.row) || (null === (_l = aa[i]) || void 0 === _l ? void 0 : _l.text) !== (null === (_m = bb[i]) || void 0 === _m ? void 0 : _m.text)) return !1;
+          }
+          return !0;
+        }
+        return !1;
+      }
+      handleMergeCells(eventArgs) {
+        this.handleMergeConfigChanged(eventArgs);
+      }
+      handleUnmergeCells(eventArgs) {
+        this.handleMergeConfigChanged(eventArgs);
+      }
+      handleMergeConfigChanged(eventArgs) {
+        var _a;
+        if (!this.table) return;
+        const {
+            startCol: startCol,
+            startRow: startRow,
+            endCol: endCol,
+            endRow: endRow
+          } = eventArgs,
+          before = this.cloneMergeConfig(this.prevMergeSnapshot),
+          after = this.cloneMergeConfig(null === (_a = this.table.options) || void 0 === _a ? void 0 : _a.customMergeCell);
+        if (this.isSameMergeConfig(before, after)) return;
+        const cmd = {
+          type: "merge_cells",
+          sheetKey: this.getSheetKey(),
+          startCol: startCol,
+          startRow: startRow,
+          endCol: endCol,
+          endRow: endRow,
+          oldCustomMergeCell: before,
+          newCustomMergeCell: after
+        };
+        this.pushCommand(cmd);
+      }
+      handleAddRecord(eventArgs) {
+        var _a, _b, _c, _d;
+        const cmd = {
+          type: "add_record",
+          sheetKey: this.getSheetKey(),
+          records: Array.isArray(eventArgs.records) ? eventArgs.records.slice() : [],
+          recordIndex: eventArgs.recordIndex,
+          recordCount: null !== (_a = eventArgs.recordCount) && void 0 !== _a ? _a : Array.isArray(eventArgs.records) ? eventArgs.records.length : 0
+        };
+        if (this.table && "number" == typeof eventArgs.recordIndex) {
+          const start = eventArgs.recordIndex,
+            count = cmd.recordCount,
+            ds = null === (_c = null === (_b = this.table) || void 0 === _b ? void 0 : _b.internalProps) || void 0 === _c ? void 0 : _c.dataSource,
+            rawRecords = null === (_d = null == ds ? void 0 : ds.dataSourceObj) || void 0 === _d ? void 0 : _d.records,
+            viewRecords = this.table.records;
+          if (Array.isArray(viewRecords) && viewRecords.length && (cmd.anchorBefore = start > 0 ? viewRecords[start - 1] : void 0, cmd.anchorAfter = viewRecords[start + count]), Array.isArray(rawRecords) && Array.isArray(viewRecords)) {
+            let rawInsertIndex = rawRecords.length;
+            if (0 === viewRecords.length) rawInsertIndex = rawRecords.length;else if (start <= 0) {
+              const first = viewRecords[0],
+                idx = rawRecords.indexOf(first);
+              rawInsertIndex = idx >= 0 ? idx : 0;
+            } else if (start >= viewRecords.length) {
+              const last = viewRecords[viewRecords.length - 1],
+                idx = rawRecords.indexOf(last);
+              rawInsertIndex = idx >= 0 ? idx + 1 : rawRecords.length;
+            } else {
+              const prev = viewRecords[start - 1],
+                idx = rawRecords.indexOf(prev);
+              rawInsertIndex = idx >= 0 ? idx + 1 : rawRecords.length;
+            }
+            cmd.rawInsertIndex = rawInsertIndex;
+          }
+        }
+        this.pushCommand(cmd);
+      }
+      handleDeleteRecord(eventArgs) {
+        var _a, _b;
+        const sheetKey = this.getSheetKey(),
+          recordIndexs = Array.isArray(eventArgs.recordIndexs) ? eventArgs.recordIndexs.slice() : [eventArgs.recordIndexs];
+        let deletedRowHeights;
+        if (this.table && this.prevResizedRowHeightsSnapshot) {
+          const headerCount = this.table.transpose ? this.table.rowHeaderLevelCount : this.table.columnHeaderLevelCount;
+          recordIndexs.forEach(idx => {
+            var _a;
+            if ("number" != typeof idx) return;
+            const rowIndex = idx + (null != headerCount ? headerCount : 0),
+              height = null === (_a = this.prevResizedRowHeightsSnapshot) || void 0 === _a ? void 0 : _a[rowIndex];
+            "number" == typeof height && (deletedRowHeights || (deletedRowHeights = {}), deletedRowHeights[idx] = height);
+          });
+        }
+        const oldCustomMergeCell = this.cloneMergeConfig(this.prevMergeSnapshot),
+          newCustomMergeCell = this.cloneMergeConfig(null === (_b = null === (_a = this.table) || void 0 === _a ? void 0 : _a.options) || void 0 === _b ? void 0 : _b.customMergeCell),
+          cmd = {
+            type: "delete_record",
+            sheetKey: sheetKey,
+            records: Array.isArray(eventArgs.records) ? eventArgs.records.slice() : [],
+            recordIndexs: recordIndexs,
+            deletedRowHeights: deletedRowHeights,
+            oldCustomMergeCell: oldCustomMergeCell,
+            newCustomMergeCell: newCustomMergeCell
+          };
+        this.pushCommand(cmd);
+      }
+      handleUpdateRecord(eventArgs) {
+        if (!this.table) return;
+        const sheetKey = this.getSheetKey(),
+          recordIndexs = eventArgs.recordIndexs || [],
+          newRecords = Array.isArray(eventArgs.records) ? eventArgs.records.slice() : [];
+        if (!this.prevRecordsSnapshot || !Array.isArray(this.prevRecordsSnapshot) || !recordIndexs.length) return;
+        const oldRecords = [];
+        recordIndexs.forEach(idx => {
+          if ("number" == typeof idx) {
+            const rec = this.prevRecordsSnapshot[idx];
+            oldRecords.push(void 0 !== rec ? cloneRecord(rec) : void 0);
+          } else oldRecords.push(void 0);
+        });
+        const cmd = {
+          type: "update_record",
+          sheetKey: sheetKey,
+          oldRecords: oldRecords,
+          newRecords: newRecords,
+          recordIndexs: recordIndexs
+        };
+        this.pushCommand(cmd);
+      }
+      handleAddColumn(eventArgs) {
+        if (!this.table) return;
+        const sheetKey = this.getSheetKey(),
+          {
+            columnIndex: columnIndex,
+            columnCount: columnCount,
+            columns: columns
+          } = eventArgs,
+          cmd = {
+            type: "add_column",
+            sheetKey: sheetKey,
+            columnIndex: columnIndex,
+            columnCount: columnCount,
+            columns: columns.slice(columnIndex, columnIndex + columnCount).map(c => cloneDeep(c))
+          };
+        this.pushCommand(cmd);
+      }
+      handleDeleteColumn(eventArgs) {
+        if (!this.table) return;
+        const sheetKey = this.getSheetKey(),
+          deleteColIndexs = (eventArgs.deleteColIndexs || []).slice(),
+          deletedColumnsFromEvent = eventArgs.deletedColumns,
+          prevColumns = this.prevColumnsSnapshot || [],
+          deletedColumns = Array.isArray(deletedColumnsFromEvent) ? deletedColumnsFromEvent.map(c => cloneDeep(c)) : [];
+        deletedColumns.length || deleteColIndexs.forEach(idx => {
+          idx >= 0 && idx < prevColumns.length && deletedColumns.push(cloneDeep(prevColumns[idx]));
+        });
+        let deletedFormulas,
+          deletedColWidths,
+          deletedRecordValues = eventArgs.deletedRecordValues;
+        if (Array.isArray(deletedRecordValues) && deletedRecordValues.length || (deletedRecordValues = void 0, Array.isArray(this.prevRecordsSnapshot) && this.prevRecordsSnapshot.length && (deletedRecordValues = this.prevRecordsSnapshot.map(rec => Array.isArray(rec) ? deleteColIndexs.map(idx => rec[idx]) : []), deletedRecordValues.every(v => 0 === v.length) && (deletedRecordValues = void 0))), this.prevFormulasSnapshot && deleteColIndexs.length) {
+          Object.entries(this.prevFormulasSnapshot).forEach(([cellRef, formula]) => {
+            const parsed = parseA1Notation(cellRef);
+            parsed && deleteColIndexs.includes(parsed.col) && (deletedFormulas || (deletedFormulas = {}), deletedFormulas[cellRef] = formula);
+          });
+        }
+        this.prevResizedColWidthsSnapshot && deleteColIndexs.length && deleteColIndexs.forEach(idx => {
+          var _a;
+          const w = null === (_a = this.prevResizedColWidthsSnapshot) || void 0 === _a ? void 0 : _a[idx];
+          "number" == typeof w && (deletedColWidths || (deletedColWidths = {}), deletedColWidths[idx] = w);
+        });
+        const cmd = {
+          type: "delete_column",
+          sheetKey: sheetKey,
+          deleteColIndexs: deleteColIndexs,
+          columns: deletedColumns,
+          deletedRecordValues: deletedRecordValues,
+          deletedFormulas: deletedFormulas,
+          deletedColWidths: deletedColWidths
+        };
+        this.pushCommand(cmd);
+      }
+      handleChangeHeaderPosition(eventArgs) {
+        var _a;
+        const sheetKey = this.getSheetKey(),
+          moving = null !== (_a = eventArgs.movingColumnOrRow) && void 0 !== _a ? _a : "column",
+          cmd = {
+            type: "change_header_position",
+            sheetKey: sheetKey,
+            moving: moving,
+            sourceIndex: "column" === moving ? eventArgs.source.col : eventArgs.source.row,
+            targetIndex: "column" === moving ? eventArgs.target.col : eventArgs.target.row
+          };
+        this.pushCommand(cmd);
+      }
+      normalizeSortState(input) {
+        if (!input) return null;
+        if (Array.isArray(input)) {
+          const list = input.filter(Boolean).map(s => ({
+            field: s.field,
+            order: s.order
+          })).filter(s => void 0 !== s.field && s.order && "normal" !== s.order);
+          return list.length ? list : null;
+        }
+        const s = input;
+        return void 0 !== s.field && s.order && "normal" !== s.order ? {
+          field: s.field,
+          order: s.order
+        } : null;
+      }
+      handleSortClick(_eventArgs) {
+        this.table && (this.sortStartSnapshot = this.lastKnownSortState, this.sortPending = !0, setTimeout(() => {
+          this.sortPending && (this.sortPending = !1, this.sortStartSnapshot = null);
+        }, 0));
+      }
+      handleResizeRow(eventArgs) {
+        var _a, _b;
+        if (!this.table) return;
+        const row = eventArgs.row;
+        if (!this.resizeRowStartHeight.has(row)) {
+          const oldHeight = null === (_b = (_a = this.table).getRowHeight) || void 0 === _b ? void 0 : _b.call(_a, row);
+          "number" == typeof oldHeight && this.resizeRowStartHeight.set(row, oldHeight);
+        }
+      }
+      handleResizeRowEnd(eventArgs) {
+        var _a;
+        if (!this.table) return;
+        const sheetKey = this.getSheetKey(),
+          row = eventArgs.row,
+          newHeight = eventArgs.rowHeight,
+          oldHeight = null !== (_a = this.resizeRowStartHeight.get(row)) && void 0 !== _a ? _a : newHeight;
+        if (this.resizeRowStartHeight.delete(row), "number" == typeof oldHeight && "number" == typeof newHeight && oldHeight === newHeight) return;
+        const cmd = {
+          type: "resize_row",
+          sheetKey: sheetKey,
+          row: row,
+          oldHeight: oldHeight,
+          newHeight: newHeight
+        };
+        this.pushCommand(cmd);
+      }
+      handleResizeColumn(eventArgs) {
+        var _a, _b;
+        if (!this.table) return;
+        const col = eventArgs.col;
+        if (!this.resizeColStartWidth.has(col)) {
+          const oldWidth = null === (_b = (_a = this.table).getColWidth) || void 0 === _b ? void 0 : _b.call(_a, col);
+          "number" == typeof oldWidth && this.resizeColStartWidth.set(col, oldWidth);
+        }
+      }
+      handleResizeColumnEnd(eventArgs) {
+        var _a, _b, _c, _d;
+        if (!this.table) return;
+        const sheetKey = this.getSheetKey(),
+          col = eventArgs.col,
+          newWidth = null !== (_a = (eventArgs.colWidths || [])[col]) && void 0 !== _a ? _a : null === (_c = (_b = this.table).getColWidth) || void 0 === _c ? void 0 : _c.call(_b, col),
+          oldWidth = null !== (_d = this.resizeColStartWidth.get(col)) && void 0 !== _d ? _d : newWidth;
+        if (this.resizeColStartWidth.delete(col), "number" == typeof oldWidth && "number" == typeof newWidth && oldWidth === newWidth) return;
+        const cmd = {
+          type: "resize_column",
+          sheetKey: sheetKey,
+          col: col,
+          oldWidth: oldWidth,
+          newWidth: newWidth
+        };
+        this.pushCommand(cmd);
+      }
+      applyCommand(cmd, direction) {
+        this.table && replayCommand({
+          table: this.table,
+          vtableSheet: this.vtableSheet,
+          cmd: cmd,
+          direction: direction,
+          deleteRecordsByReference: records => this.deleteRecordsByReference(records)
+        });
+      }
+      deleteRecordsByReference(records) {
+        if (!this.table || !(null == records ? void 0 : records.length)) return;
+        const tableRecords = this.table.records || [],
+          indexs = [];
+        records.forEach(rec => {
+          const idx = tableRecords.indexOf(rec);
+          idx >= 0 && indexs.push(idx);
+        }), indexs.length && this.table.deleteRecords && this.table.deleteRecords(indexs);
+      }
+    }
+
     class FormulaAutocomplete {
         container;
         dropdown = null;
@@ -85263,12 +86905,41 @@
             if (!this.element || !this.sheet) {
                 return;
             }
-            this.element.value = '=' + item.value;
-            this.sheet.formulaUIManager.formulaInput.value = this.element.value;
-            const highlightManager = this.sheet.formulaManager.cellHighlightManager;
-            if (highlightManager && this.element.value.startsWith('=')) {
-                highlightManager.highlightFormulaCells(this.element.value);
+            const value = this.element.value;
+            const selectionStart = this.element.selectionStart ?? value.length;
+            const selectionEnd = this.element.selectionEnd ?? selectionStart;
+            let replaceStart = selectionStart;
+            let replaceEnd = selectionEnd;
+            if (selectionStart === selectionEnd) {
+                replaceStart = selectionStart;
+                while (replaceStart > 1 && /[A-Za-z0-9]/.test(value[replaceStart - 1])) {
+                    replaceStart--;
+                }
+                const hasLeftWord = replaceStart < selectionStart;
+                replaceEnd = selectionStart;
+                if (hasLeftWord) {
+                    while (replaceEnd < value.length && /[A-Za-z0-9]/.test(value[replaceEnd])) {
+                        replaceEnd++;
+                    }
+                }
             }
+            const isFunction = item?.type === 'function';
+            const itemValue = String(item?.value ?? '');
+            const nextChar = value[replaceEnd];
+            const shouldAppendParen = isFunction && nextChar !== '(';
+            const insertText = itemValue + (shouldAppendParen ? '(' : '');
+            const newValue = value.slice(0, replaceStart) + insertText + value.slice(replaceEnd);
+            this.element.value = newValue;
+            let newCursorPos = replaceStart + itemValue.length;
+            if (isFunction && newValue[newCursorPos] === '(') {
+                newCursorPos += 1;
+            }
+            this.element.setSelectionRange(newCursorPos, newCursorPos);
+            if (this.sheet.formulaUIManager.formulaInput) {
+                this.sheet.formulaUIManager.formulaInput.value = newValue;
+            }
+            const inputEvent = new Event('input', { bubbles: true });
+            this.element.dispatchEvent(inputEvent);
         }
         onStart(context) {
             const formula = this.sheet.formulaManager.getCellFormula({
@@ -85360,7 +87031,9 @@
             return `${startCol}${startRow}:${endCol}${endRow}`;
         }
     }
-    const formulaEditor = new FormulaInputEditor();
+    function createFormulaEditor() {
+        return new FormulaInputEditor();
+    }
 
     class FormulaUIManager {
         sheet;
@@ -87514,7 +89187,7 @@
             }
             return this.addSheet(sheetKey);
         }
-        setCellContent(cell, value) {
+        setCellContent(cell, value, options) {
             this.ensureInitialized();
             if (!cell || cell.sheet === undefined || cell.row === undefined || cell.col === undefined) {
                 throw new Error('Invalid cell parameter for setCellContent');
@@ -87532,16 +89205,18 @@
                 else {
                     this.formulaEngine.setCellContent(cell, value);
                 }
-                const newFormula = this.getCellFormula(cell);
-                if (newFormula && newFormula !== oldFormula) {
-                    this.emitFormulaEvent(cell, 'added', newFormula);
-                }
-                else if (!newFormula && oldFormula) {
-                    this.emitFormulaEvent(cell, 'removed', oldFormula);
+                if (options?.emitEvent !== false) {
+                    const newFormula = this.getCellFormula(cell);
+                    if (newFormula && newFormula !== oldFormula) {
+                        this.emitFormulaEvent(cell, 'added', newFormula);
+                    }
+                    else if (!newFormula && oldFormula) {
+                        this.emitFormulaEvent(cell, 'removed', oldFormula);
+                    }
                 }
             }
             catch (error) {
-                if (typeof value === 'string' && value.startsWith('=')) {
+                if (options?.emitEvent !== false && typeof value === 'string' && value.startsWith('=')) {
                     this.emitFormulaEvent(cell, 'error', value, error);
                 }
                 if (error instanceof Error) {
@@ -88791,6 +90466,7 @@
                     maintainArrayDataOrder: true
                 },
                 addRecordRule: 'Array',
+                syncRecordOperationsToSourceRecords: true,
                 defaultCursor: 'cell',
                 records: this.options.data,
                 sortState: this.options.sortState,
@@ -88946,54 +90622,6 @@
                     if (rowIndexs && rowIndexs.length > 0) {
                         const minIndex = Math.min(...rowIndexs.flat());
                         this.vtableSheet.formulaManager.removeRows(sheetKey, minIndex, deletedCount);
-                        if (Array.isArray(this.tableInstance.options.customMergeCell)) {
-                            const mergeCellsToRemove = [];
-                            const deleteEndIndex = minIndex + deletedCount - 1;
-                            const customMergeCellArray = this.tableInstance.options.customMergeCell;
-                            const cloneMergeCellArray = customMergeCellArray.map(mergeCell => ({
-                                ...mergeCell,
-                                range: {
-                                    start: { ...mergeCell.range.start },
-                                    end: { ...mergeCell.range.end }
-                                }
-                            }));
-                            customMergeCellArray.forEach((mergeCell, index) => {
-                                const startRow = mergeCell.range.start.row;
-                                const endRow = mergeCell.range.end.row;
-                                if (startRow >= minIndex && endRow <= deleteEndIndex) {
-                                    mergeCellsToRemove.push(index);
-                                    return;
-                                }
-                                if (startRow <= deleteEndIndex && endRow >= minIndex) {
-                                    if (startRow >= minIndex) {
-                                        mergeCell.range.start.row = minIndex;
-                                    }
-                                    if (endRow <= deleteEndIndex) {
-                                        mergeCell.range.end.row = minIndex - 1;
-                                    }
-                                    else {
-                                        mergeCell.range.end.row -= deletedCount;
-                                    }
-                                    if (mergeCell.range.start.row > mergeCell.range.end.row) {
-                                        mergeCellsToRemove.push(index);
-                                    }
-                                }
-                                else if (startRow > deleteEndIndex) {
-                                    mergeCell.range.start.row -= deletedCount;
-                                    mergeCell.range.end.row -= deletedCount;
-                                }
-                            });
-                            mergeCellsToRemove
-                                .sort((a, b) => b - a)
-                                .forEach(index => {
-                                customMergeCellArray.splice(index, 1);
-                            });
-                            const updateRanges = cloneMergeCellArray.map(mergeCell => ({
-                                start: { ...mergeCell.range.start },
-                                end: { ...mergeCell.range.end }
-                            }));
-                            this.tableInstance.updateCellContentRange(updateRanges);
-                        }
                     }
                 }
             }
@@ -89021,54 +90649,6 @@
                         const minIndex = Math.min(...deleteColIndexs.flat());
                         const deletedCount = deleteColIndexs.length;
                         this.vtableSheet.formulaManager.removeColumns(sheetKey, minIndex, deletedCount);
-                        if (Array.isArray(this.tableInstance.options.customMergeCell)) {
-                            const mergeCellsToRemove = [];
-                            const deleteEndIndex = minIndex + deletedCount - 1;
-                            const customMergeCellArray = this.tableInstance.options.customMergeCell;
-                            const cloneMergeCellArray = customMergeCellArray.map(mergeCell => ({
-                                ...mergeCell,
-                                range: {
-                                    start: { ...mergeCell.range.start },
-                                    end: { ...mergeCell.range.end }
-                                }
-                            }));
-                            customMergeCellArray.forEach((mergeCell, index) => {
-                                const startCol = mergeCell.range.start.col;
-                                const endCol = mergeCell.range.end.col;
-                                if (startCol >= minIndex && endCol <= deleteEndIndex) {
-                                    mergeCellsToRemove.push(index);
-                                    return;
-                                }
-                                if (startCol <= deleteEndIndex && endCol >= minIndex) {
-                                    if (startCol >= minIndex) {
-                                        mergeCell.range.start.col = minIndex;
-                                    }
-                                    if (endCol <= deleteEndIndex) {
-                                        mergeCell.range.end.col = minIndex - 1;
-                                    }
-                                    else {
-                                        mergeCell.range.end.col -= deletedCount;
-                                    }
-                                    if (mergeCell.range.start.col > mergeCell.range.end.col) {
-                                        mergeCellsToRemove.push(index);
-                                    }
-                                }
-                                else if (startCol > deleteEndIndex) {
-                                    mergeCell.range.start.col -= deletedCount;
-                                    mergeCell.range.end.col -= deletedCount;
-                                }
-                            });
-                            mergeCellsToRemove
-                                .sort((a, b) => b - a)
-                                .forEach(index => {
-                                customMergeCellArray.splice(index, 1);
-                            });
-                            const updateRanges = cloneMergeCellArray.map(mergeCell => ({
-                                start: { ...mergeCell.range.start },
-                                end: { ...mergeCell.range.end }
-                            }));
-                            this.tableInstance.updateCellContentRange(updateRanges);
-                        }
                     }
                 }
             }
@@ -89411,6 +90991,20 @@
         const plugins = [];
         const disabledPluginsUserSetted = options?.VTablePluginModules?.filter(module => module.disabled);
         let enabledPluginsUserSetted = options?.VTablePluginModules?.filter(module => !module.disabled);
+        if (vtableSheet?.getWorkbookHistoryManager &&
+            !disabledPluginsUserSetted?.some(module => module.module === HistoryPlugin) &&
+            !enabledPluginsUserSetted?.some(module => module.module === HistoryPlugin)) {
+            const workbookHistory = vtableSheet.getWorkbookHistoryManager();
+            if (typeof HistoryPlugin !== 'function') ;
+            else {
+                plugins.push(new HistoryPlugin({
+                    enableCompression: false,
+                    onTransactionPushed: (args) => {
+                        workbookHistory.recordTableTransaction({ sheetKey: args?.sheetKey, tx: args?.tx });
+                    }
+                }));
+            }
+        }
         if (!disabledPluginsUserSetted?.some(module => module.module === FilterPlugin)) {
             const userPluginOptions = enabledPluginsUserSetted?.find(module => module.module === FilterPlugin)
                 ?.moduleOptions;
@@ -89490,7 +91084,20 @@
         if (enabledPluginsUserSetted?.length) {
             enabledPluginsUserSetted.forEach((module) => {
                 if (typeof module?.module === 'function') {
-                    plugins.push(new module.module(module.moduleOptions));
+                    let moduleOptions = module.moduleOptions;
+                    if (module.module === HistoryPlugin && vtableSheet?.getWorkbookHistoryManager) {
+                        const workbookHistory = vtableSheet.getWorkbookHistoryManager();
+                        const prev = moduleOptions?.onTransactionPushed;
+                        moduleOptions = {
+                            ...(moduleOptions ?? {}),
+                            enableCompression: moduleOptions?.enableCompression ?? false,
+                            onTransactionPushed: (args) => {
+                                prev?.(args);
+                                workbookHistory.recordTableTransaction({ sheetKey: args?.sheetKey, tx: args?.tx });
+                            }
+                        };
+                    }
+                    plugins.push(new module.module(moduleOptions));
                 }
             });
         }
@@ -89975,9 +91582,7 @@
         }
         performTabReorder(sourceKey, targetKey, position) {
             try {
-                this.sheet.getSheetManager().reorderSheet(sourceKey, targetKey, position);
-                this.sheet.updateSheetTabs();
-                this.sheet.updateSheetMenu();
+                this.sheet.reorderSheet(sourceKey, targetKey, position);
             }
             catch (error) {
             }
@@ -89996,10 +91601,18 @@
     class MenuManager {
         sheet;
         menuContainer;
+        undoButton = null;
+        redoButton = null;
         clickOutsideHandler;
+        historyUnsubscribe = null;
         constructor(sheet) {
             this.sheet = sheet;
-            this.createMainMenu();
+        }
+        createUndoRedoOnly() {
+            const wrap = document.createElement('div');
+            wrap.className = 'vtable-sheet-undo-redo';
+            this.mountUndoRedoActions(wrap);
+            return wrap;
         }
         createMainMenu() {
             const menuIcon = `<svg t="1754379519717" class="icon" viewBox="0 0 1024 1024" version="1.1" xmlns="http://www.w3.org/2000/svg" p-id="1496" width="24" height="24"><path d="M510.435876 67.959811c-245.428735 0-444.382996 198.954261-444.382996 444.373787 0 245.420549 198.954261 444.373787 444.382996 444.373787 245.410316 0 444.372763-198.953238 444.372763-444.373787C954.807616 266.914072 755.846192 67.959811 510.435876 67.959811zM510.435876 901.156184c-214.743876 0-388.831796-174.08792-388.831796-388.822586 0-214.743876 174.088944-388.831796 388.831796-388.831796 214.732619 0 388.822586 174.08792 388.822586 388.831796C899.257439 727.068264 725.167472 901.156184 510.435876 901.156184zM666.028561 329.355193 337.411171 329.355193c-15.117302 0-27.384697 15.60235-27.384697 34.844599 0 19.259646 12.267395 34.861996 27.384697 34.861996l328.618413 0c15.124466 0 27.375487-15.60235 27.375487-34.861996C693.404048 344.957543 681.15405 329.355193 666.028561 329.355193zM666.028561 486.191194 337.411171 486.191194c-15.117302 0-27.384697 15.601326-27.384697 34.852786 0 19.25146 12.267395 34.853809 27.384697 34.853809l328.618413 0c15.124466 0 27.375487-15.601326 27.375487-34.853809C693.404048 501.792521 681.15405 486.191194 666.028561 486.191194zM666.028561 625.604384 337.411171 625.604384c-15.117302 0-27.384697 15.60235-27.384697 34.845623 0 19.25146 12.267395 34.861996 27.384697 34.861996l328.618413 0c15.124466 0 27.375487-15.611559 27.375487-34.861996C693.404048 641.206734 681.15405 625.604384 666.028561 625.604384z" fill="#8a8a8a" p-id="1497"></path></svg>`;
@@ -90010,6 +91623,7 @@
             menuButton.className = 'vtable-sheet-main-menu-button';
             menuButton.innerHTML = menuIcon;
             menu.appendChild(menuButton);
+            this.mountUndoRedoActions(menu);
             const menuContainer = document.createElement('div');
             menuContainer.className = 'vtable-sheet-main-menu-container';
             menu.appendChild(menuContainer);
@@ -90058,6 +91672,55 @@
             this.menuContainer = menuContainer;
             return menu;
         }
+        mountUndoRedoActions(container) {
+            const showUndoRedo = this.sheet.getOptions().undoRedo?.show ?? true;
+            if (!showUndoRedo) {
+                this.undoButton = null;
+                this.redoButton = null;
+                this.historyUnsubscribe?.();
+                this.historyUnsubscribe = null;
+                return;
+            }
+            const undoIcon = `<svg width="1em" height="1em" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg" data-icon="UndoOutlined"><path d="M8.707 2.293a1 1 0 0 1 0 1.414L5.414 7H14.5a7.5 7.5 0 0 1 0 15H11a1 1 0 1 1 0-2h3.5a5.5 5.5 0 1 0 0-11H5.414l3.293 3.293a1 1 0 1 1-1.414 1.414l-5-5a1 1 0 0 1 0-1.414l5-5a1 1 0 0 1 1.414 0Z" fill="currentColor"></path></svg>`;
+            const redoIcon = `<svg width="1em" height="1em" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg" data-icon="RedoOutlined"><path d="M15.293 2.293a1 1 0 0 0 0 1.414L18.586 7H9.5a7.5 7.5 0 0 0 0 15H13a1 1 0 1 0 0-2H9.5a5.5 5.5 0 1 1 0-11h9.086l-3.293 3.293a1 1 0 0 0 1.414 1.414l5-5a1 1 0 0 0 0-1.414l-5-5a1 1 0 0 0-1.414 0Z" fill="currentColor"></path></svg>`;
+            const actions = document.createElement('div');
+            actions.className = 'vtable-sheet-main-menu-actions';
+            container.appendChild(actions);
+            this.undoButton = document.createElement('button');
+            this.undoButton.className = 'vtable-sheet-main-menu-action';
+            this.undoButton.type = 'button';
+            this.undoButton.title = '撤销';
+            this.undoButton.innerHTML = undoIcon;
+            this.undoButton.addEventListener('click', e => {
+                e.stopPropagation();
+                this.sheet.undo();
+            });
+            actions.appendChild(this.undoButton);
+            this.redoButton = document.createElement('button');
+            this.redoButton.className = 'vtable-sheet-main-menu-action';
+            this.redoButton.type = 'button';
+            this.redoButton.title = '重做';
+            this.redoButton.innerHTML = redoIcon;
+            this.redoButton.addEventListener('click', e => {
+                e.stopPropagation();
+                this.sheet.redo();
+            });
+            actions.appendChild(this.redoButton);
+            this.historyUnsubscribe?.();
+            this.historyUnsubscribe = this.sheet.getWorkbookHistoryManager().onChange(() => {
+                this.updateUndoRedoState();
+            });
+            this.updateUndoRedoState();
+        }
+        updateUndoRedoState() {
+            const history = this.sheet.getWorkbookHistoryManager();
+            if (this.undoButton) {
+                this.undoButton.disabled = !history.canUndo();
+            }
+            if (this.redoButton) {
+                this.redoButton.disabled = !history.canRedo();
+            }
+        }
         createSubMenu(items) {
             const subMenuContainer = document.createElement('div');
             subMenuContainer.className = 'vtable-sheet-submenu-container';
@@ -90176,10 +91839,12 @@
                 document.removeEventListener('click', this.clickOutsideHandler);
                 this.clickOutsideHandler = null;
             }
+            this.historyUnsubscribe?.();
+            this.historyUnsubscribe = null;
         }
         updateMainMenu(mainMenu) {
             this.release();
-            this.createMainMenu();
+            return this.createMainMenu();
         }
     }
 
@@ -90246,11 +91911,7 @@
                 showSnackbar('工作表名称已存在，请重新输入', 1300);
                 return false;
             }
-            this.vTableSheet.getSheetManager().renameSheet(sheetKey, newTitle);
-            this.vTableSheet.workSheetInstances.get(sheetKey)?.setTitle(newTitle);
-            this.vTableSheet.getFormulaManager().updateSheetTitle(sheetKey, newTitle);
-            this.vTableSheet.updateSheetTabs();
-            this.vTableSheet.updateSheetMenu();
+            this.vTableSheet.renameSheet(sheetKey, newTitle);
             return true;
         }
         getSheetTabElementByKey(sheetKey) {
@@ -90800,7 +92461,430 @@
         }
     }
 
-    editor('formula', formulaEditor);
+    function cloneJson(input) {
+        return JSON.parse(JSON.stringify(input));
+    }
+    function cloneSafe(input) {
+        const sc = globalThis.structuredClone;
+        if (typeof sc === 'function') {
+            try {
+                return sc(input);
+            }
+            catch { }
+        }
+        return cloneJson(input);
+    }
+    class WorkbookHistoryManager {
+        sheet;
+        undoStack = [];
+        redoStack = [];
+        currentTransaction = null;
+        maxHistory;
+        enabled = true;
+        isReplaying = false;
+        changeListeners = new Set();
+        constructor(sheet, options) {
+            this.sheet = sheet;
+            this.maxHistory = options?.maxHistory ?? 100;
+        }
+        canUndo() {
+            return this.undoStack.length > 0;
+        }
+        canRedo() {
+            return this.redoStack.length > 0;
+        }
+        onChange(listener) {
+            this.changeListeners.add(listener);
+            return () => {
+                this.changeListeners.delete(listener);
+            };
+        }
+        emitChange() {
+            this.changeListeners.forEach(fn => {
+                try {
+                    fn();
+                }
+                catch { }
+            });
+        }
+        suspend() {
+            this.enabled = false;
+        }
+        resume() {
+            this.enabled = true;
+        }
+        startTransaction() {
+            if (this.currentTransaction) {
+                return;
+            }
+            this.currentTransaction = { commands: [] };
+        }
+        endTransaction() {
+            if (!this.currentTransaction || this.currentTransaction.commands.length === 0) {
+                this.currentTransaction = null;
+                return;
+            }
+            this.pushTransaction(this.currentTransaction);
+            this.currentTransaction = null;
+        }
+        clear() {
+            this.undoStack = [];
+            this.redoStack = [];
+            this.currentTransaction = null;
+            this.emitChange();
+        }
+        updateOptions(options) {
+            if (options.maxHistory != null) {
+                this.maxHistory = options.maxHistory;
+                this.trimHistory();
+                this.emitChange();
+            }
+        }
+        undo() {
+            if (this.undoStack.length === 0) {
+                return;
+            }
+            const tx = this.undoStack.pop();
+            this.isReplaying = true;
+            this.sheet.__workbookHistoryReplaying = true;
+            try {
+                for (let i = tx.commands.length - 1; i >= 0; i--) {
+                    this.applyCommand(tx.commands[i], 'undo');
+                }
+            }
+            finally {
+                this.isReplaying = false;
+                this.sheet.__workbookHistoryReplaying = false;
+            }
+            this.redoStack.push(tx);
+            this.emitChange();
+        }
+        redo() {
+            if (this.redoStack.length === 0) {
+                return;
+            }
+            const tx = this.redoStack.pop();
+            this.isReplaying = true;
+            this.sheet.__workbookHistoryReplaying = true;
+            try {
+                for (const cmd of tx.commands) {
+                    this.applyCommand(cmd, 'redo');
+                }
+            }
+            finally {
+                this.isReplaying = false;
+                this.sheet.__workbookHistoryReplaying = false;
+            }
+            this.undoStack.push(tx);
+            this.emitChange();
+        }
+        recordTableTransaction(args) {
+            if (!this.enabled || this.isReplaying) {
+                return;
+            }
+            const sheetKey = args.sheetKey ?? this.getActiveSheetKey();
+            if (!sheetKey) {
+                return;
+            }
+            const cmd = {
+                type: 'table_tx',
+                sheetKey,
+                tx: cloneSafe(args.tx)
+            };
+            this.pushCommand(cmd);
+        }
+        addSheet(args) {
+            if (!this.enabled || this.isReplaying) {
+                this.addSheetInternal(args.sheet, args.activate);
+                return;
+            }
+            const orderBefore = this.getSheetOrder();
+            const activeBefore = this.getActiveSheetKey();
+            this.startTransaction();
+            try {
+                this.addSheetInternal(args.sheet, args.activate);
+                const orderAfter = this.getSheetOrder();
+                const activeAfter = this.getActiveSheetKey();
+                const cmd = {
+                    type: 'sheet_add',
+                    sheet: cloneSafe(args.sheet),
+                    orderBefore,
+                    orderAfter,
+                    activeBefore,
+                    activeAfter
+                };
+                this.pushCommand(cmd);
+            }
+            finally {
+                this.endTransaction();
+            }
+        }
+        removeSheet(sheetKey) {
+            if (!this.enabled || this.isReplaying) {
+                this.removeSheetInternal(sheetKey);
+                return;
+            }
+            const sheetDefine = this.sheet.getSheetManager().getSheet(sheetKey);
+            if (!sheetDefine) {
+                return;
+            }
+            const orderBefore = this.getSheetOrder();
+            const activeBefore = this.getActiveSheetKey();
+            this.startTransaction();
+            try {
+                this.removeSheetInternal(sheetKey);
+                const orderAfter = this.getSheetOrder();
+                const activeAfter = this.getActiveSheetKey();
+                const cmd = {
+                    type: 'sheet_remove',
+                    sheet: cloneSafe(sheetDefine),
+                    orderBefore,
+                    orderAfter,
+                    activeBefore,
+                    activeAfter
+                };
+                this.pushCommand(cmd);
+            }
+            finally {
+                this.endTransaction();
+            }
+        }
+        renameSheet(sheetKey, newTitle) {
+            const sheetDefine = this.sheet.getSheetManager().getSheet(sheetKey);
+            if (!sheetDefine) {
+                return;
+            }
+            const oldTitle = sheetDefine.sheetTitle;
+            if (!this.enabled || this.isReplaying) {
+                this.renameSheetInternal(sheetKey, newTitle);
+                return;
+            }
+            this.startTransaction();
+            try {
+                this.renameSheetInternal(sheetKey, newTitle);
+                const cmd = { type: 'sheet_rename', sheetKey, oldTitle, newTitle };
+                this.pushCommand(cmd);
+            }
+            finally {
+                this.endTransaction();
+            }
+        }
+        reorderSheet(sourceKey, targetKey, position) {
+            if (!this.enabled || this.isReplaying) {
+                this.sheet.getSheetManager().reorderSheet(sourceKey, targetKey, position);
+                this.sheet.updateSheetTabs();
+                this.sheet.updateSheetMenu();
+                return;
+            }
+            const orderBefore = this.getSheetOrder();
+            this.startTransaction();
+            try {
+                this.sheet.getSheetManager().reorderSheet(sourceKey, targetKey, position);
+                this.sheet.updateSheetTabs();
+                this.sheet.updateSheetMenu();
+                const orderAfter = this.getSheetOrder();
+                const cmd = { type: 'sheet_reorder', orderBefore, orderAfter };
+                this.pushCommand(cmd);
+            }
+            finally {
+                this.endTransaction();
+            }
+        }
+        pushTransaction(tx) {
+            if (!tx.commands.length) {
+                return;
+            }
+            this.undoStack.push(tx);
+            this.redoStack = [];
+            this.trimHistory();
+            this.emitChange();
+        }
+        pushCommand(cmd) {
+            if (this.currentTransaction) {
+                this.currentTransaction.commands.push(cmd);
+                return;
+            }
+            this.pushTransaction({ commands: [cmd] });
+        }
+        trimHistory() {
+            if (this.undoStack.length > this.maxHistory) {
+                this.undoStack.splice(0, this.undoStack.length - this.maxHistory);
+            }
+        }
+        applyCommand(cmd, direction) {
+            switch (cmd.type) {
+                case 'sheet_add': {
+                    if (direction === 'undo') {
+                        this.removeSheetInternal(cmd.sheet.sheetKey);
+                        this.setSheetOrder(cmd.orderBefore);
+                        if (cmd.activeBefore) {
+                            this.sheet.activateSheet(cmd.activeBefore);
+                        }
+                    }
+                    else {
+                        this.addSheetInternal(cmd.sheet, false);
+                        this.setSheetOrder(cmd.orderAfter);
+                        if (cmd.activeAfter) {
+                            this.sheet.activateSheet(cmd.activeAfter);
+                        }
+                    }
+                    break;
+                }
+                case 'sheet_remove': {
+                    if (direction === 'undo') {
+                        this.addSheetInternal(cmd.sheet, false);
+                        this.setSheetOrder(cmd.orderBefore);
+                        if (!this.sheet.getWorkSheetInstance(cmd.sheet.sheetKey)) {
+                            const restored = this.sheet.createWorkSheetInstance(cmd.sheet);
+                            restored.getElement().style.display = 'none';
+                            this.sheet.setWorkSheetInstance(cmd.sheet.sheetKey, restored);
+                        }
+                        if (cmd.activeBefore) {
+                            this.sheet.activateSheet(cmd.activeBefore);
+                        }
+                    }
+                    else {
+                        this.removeSheetInternal(cmd.sheet.sheetKey);
+                        this.setSheetOrder(cmd.orderAfter);
+                        if (cmd.activeAfter) {
+                            this.sheet.activateSheet(cmd.activeAfter);
+                        }
+                    }
+                    break;
+                }
+                case 'sheet_rename': {
+                    const nextTitle = direction === 'undo' ? cmd.oldTitle : cmd.newTitle;
+                    this.renameSheetInternal(cmd.sheetKey, nextTitle);
+                    break;
+                }
+                case 'sheet_reorder': {
+                    this.setSheetOrder(direction === 'undo' ? cmd.orderBefore : cmd.orderAfter);
+                    break;
+                }
+                case 'table_tx': {
+                    this.applyTableTransaction(cmd.sheetKey, cmd.tx, direction);
+                    break;
+                }
+            }
+        }
+        addSheetInternal(sheetDefine, activate) {
+            this.sheet.getSheetManager().addSheet(sheetDefine);
+            if (activate) {
+                this.sheet.activateSheet(sheetDefine.sheetKey);
+            }
+            else {
+                this.sheet.updateSheetTabs();
+                this.sheet.updateSheetMenu();
+            }
+        }
+        removeSheetInternal(sheetKey) {
+            const instance = this.sheet.getWorkSheetInstance(sheetKey);
+            if (instance) {
+                instance.release();
+                this.sheet.deleteWorkSheetInstance(sheetKey);
+            }
+            const active = this.getActiveSheetKey();
+            const newActiveSheetKey = this.sheet.getSheetManager().removeSheet(sheetKey);
+            try {
+                this.sheet.getFormulaManager().removeSheet(sheetKey);
+            }
+            catch { }
+            if (newActiveSheetKey && newActiveSheetKey !== active) {
+                this.sheet.activateSheet(newActiveSheetKey);
+            }
+            this.sheet.updateSheetTabs();
+            this.sheet.updateSheetMenu();
+        }
+        renameSheetInternal(sheetKey, newTitle) {
+            this.sheet.getSheetManager().renameSheet(sheetKey, newTitle);
+            this.sheet.getWorkSheetInstance(sheetKey)?.setTitle(newTitle);
+            this.sheet.getFormulaManager().updateSheetTitle(sheetKey, newTitle);
+            this.sheet.updateSheetTabs();
+            this.sheet.updateSheetMenu();
+        }
+        applyTableTransaction(sheetKey, tx, direction) {
+            const ws = this.ensureWorkSheetInstance(sheetKey);
+            if (ws && this.getActiveSheetKey() !== sheetKey) {
+                this.sheet.activateSheet(sheetKey);
+            }
+            const table = ws?.tableInstance;
+            if (!table) {
+                return;
+            }
+            const vtableSheet = this.sheet;
+            const apply = (cmd, dir) => {
+                replayCommand({
+                    table,
+                    vtableSheet,
+                    cmd,
+                    direction: dir,
+                    deleteRecordsByReference: (records) => {
+                        const tableRecords = (table.records || []);
+                        const indexs = [];
+                        records.forEach(rec => {
+                            const idx = tableRecords.indexOf(rec);
+                            if (idx >= 0) {
+                                indexs.push(idx);
+                            }
+                        });
+                        if (indexs.length && table.deleteRecords) {
+                            table.deleteRecords(indexs);
+                        }
+                    }
+                });
+            };
+            if (direction === 'undo') {
+                for (let i = tx.commands.length - 1; i >= 0; i--) {
+                    apply(tx.commands[i], 'undo');
+                }
+            }
+            else {
+                for (let i = 0; i < tx.commands.length; i++) {
+                    apply(tx.commands[i], 'redo');
+                }
+            }
+        }
+        ensureWorkSheetInstance(sheetKey) {
+            const existing = this.sheet.getWorkSheetInstance(sheetKey);
+            if (existing) {
+                return existing;
+            }
+            const def = this.sheet.getSheetManager().getSheet(sheetKey);
+            if (!def) {
+                return undefined;
+            }
+            const instance = this.sheet.createWorkSheetInstance(def);
+            instance.getElement().style.display = 'none';
+            this.sheet.setWorkSheetInstance(sheetKey, instance);
+            return instance;
+        }
+        getSheetOrder() {
+            return this.sheet
+                .getSheetManager()
+                .getAllSheets()
+                .map(s => s.sheetKey);
+        }
+        setSheetOrder(order) {
+            const all = this.sheet.getSheetManager().getAllSheets();
+            const map = new Map(all.map(s => [s.sheetKey, s]));
+            const next = [];
+            order.forEach(key => {
+                const s = map.get(key);
+                if (s) {
+                    next.push(s);
+                }
+            });
+            if (next.length === all.length) {
+                this.sheet.getSheetManager().sortSheets(next);
+                this.sheet.updateSheetTabs();
+                this.sheet.updateSheetMenu();
+            }
+        }
+        getActiveSheetKey() {
+            return this.sheet.getSheetManager().getActiveSheet()?.sheetKey;
+        }
+    }
+
     class VTableSheet {
         container;
         options;
@@ -90819,9 +92903,11 @@
         formulaBarElement = null;
         sheetTabElement = null;
         mainMenuElement = null;
+        undoRedoElement = null;
         contentElement;
         dragManager;
         sheetTabEventHandler;
+        workbookHistoryManager;
         constructor(container, options) {
             this.container = container;
             this.options = this.mergeDefaultOptions(options);
@@ -90831,12 +92917,15 @@
             this.tableEventRelay = new TableEventRelay(this);
             this.eventManager = new DomEventManager(this);
             this.dragManager = new SheetTabDragManager(this);
-            this.menuManager = new MenuManager(this);
             this.formulaUIManager = new FormulaUIManager(this);
             this.sheetTabEventHandler = new SheetTabEventHandler(this);
             this.spreadsheetEventManager = new SpreadSheetEventManager(this);
+            this.workbookHistoryManager = new WorkbookHistoryManager(this);
+            this.menuManager = new MenuManager(this);
             this.initUI();
+            this.workbookHistoryManager.suspend();
             this.initSheets();
+            this.workbookHistoryManager.resume();
             this.resize();
         }
         mergeDefaultOptions(options) {
@@ -90865,10 +92954,7 @@
             const topContainer = document.createElement('div');
             topContainer.className = 'vtable-sheet-top-container';
             this.rootElement.appendChild(topContainer);
-            if (this.options.mainMenu?.show) {
-                this.mainMenuElement = this.menuManager.createMainMenu();
-                topContainer.appendChild(this.mainMenuElement);
-            }
+            this.renderTopLeftControls(topContainer);
             if (this.options.showFormulaBar) {
                 this.formulaBarElement = this.formulaUIManager.createFormulaBar();
                 topContainer.appendChild(this.formulaBarElement);
@@ -90882,6 +92968,38 @@
                 this.rootElement.appendChild(this.sheetTabElement);
             }
         }
+        renderTopLeftControls(topContainer) {
+            if (this.mainMenuElement?.parentElement) {
+                this.mainMenuElement.parentElement.removeChild(this.mainMenuElement);
+                this.mainMenuElement = null;
+            }
+            if (this.undoRedoElement?.parentElement) {
+                this.undoRedoElement.parentElement.removeChild(this.undoRedoElement);
+                this.undoRedoElement = null;
+            }
+            this.menuManager.release();
+            const showMainMenu = !!this.options.mainMenu?.show;
+            const showUndoRedo = this.options.undoRedo?.show ?? true;
+            if (showMainMenu) {
+                this.mainMenuElement = this.menuManager.createMainMenu();
+                if (topContainer.firstChild) {
+                    topContainer.insertBefore(this.mainMenuElement, topContainer.firstChild);
+                }
+                else {
+                    topContainer.appendChild(this.mainMenuElement);
+                }
+                return;
+            }
+            if (showUndoRedo) {
+                this.undoRedoElement = this.menuManager.createUndoRedoOnly();
+                if (topContainer.firstChild) {
+                    topContainer.insertBefore(this.undoRedoElement, topContainer.firstChild);
+                }
+                else {
+                    topContainer.appendChild(this.undoRedoElement);
+                }
+            }
+        }
         createSheetTab() {
             const addIcon = '<svg viewBox="0 0 24 24" width="16" height="16">' +
                 '<path fill="currentColor" d="M19 13h-6v6h-2v-6H5v-2h6V5h2v6h6z"/>' +
@@ -91047,26 +93165,14 @@
             }
         }
         addSheet(sheet) {
-            this.sheetManager.addSheet(sheet);
-            this.updateSheetTabs();
-            this.updateSheetMenu();
+            this.workbookHistoryManager.addSheet({ sheet, activate: false });
         }
         removeSheet(sheetKey) {
             if (this.sheetManager.getSheetCount() <= 1) {
                 showSnackbar('至少保留一个工作表', 1300);
                 return;
             }
-            const instance = this.workSheetInstances.get(sheetKey);
-            if (instance) {
-                instance.release();
-                this.workSheetInstances.delete(sheetKey);
-            }
-            const newActiveSheetKey = this.sheetManager.removeSheet(sheetKey);
-            if (newActiveSheetKey) {
-                this.activateSheet(newActiveSheetKey);
-            }
-            this.updateSheetTabs();
-            this.updateSheetMenu();
+            this.workbookHistoryManager.removeSheet(sheetKey);
         }
         getSheetCount() {
             return this.sheetManager.getSheetCount();
@@ -91078,10 +93184,10 @@
             return this.sheetManager.getAllSheets();
         }
         createWorkSheetInstance(sheetDefine) {
-            formulaEditor.setSheet(this);
             const contentWidth = this.contentElement.clientWidth;
             const contentHeight = this.contentElement.clientHeight;
             sheetDefine.dragOrder = sheetDefine.dragOrder ?? this.options.dragOrder;
+            const formulaEditor = createFormulaEditor();
             const sheet = new WorkSheet(this, {
                 ...sheetDefine,
                 container: this.contentElement,
@@ -91091,8 +93197,8 @@
                 defaultColWidth: this.options.defaultColWidth,
                 dragOrder: sheetDefine.dragOrder,
                 plugins: getTablePlugins(sheetDefine, this.options, this),
-                headerEditor: 'formula',
-                editor: 'formula',
+                headerEditor: formulaEditor,
+                editor: formulaEditor,
                 select: {
                     makeSelectCellVisible: false
                 },
@@ -91100,6 +93206,7 @@
                 customMergeCell: sheetDefine.cellMerge,
                 theme: sheetDefine.theme?.tableTheme || this.options.theme?.tableTheme
             });
+            formulaEditor.setSheet(this);
             try {
                 const normalizedData = sheetDefine.data
                     ? this.formulaManager.normalizeSheetData(sheetDefine.data, sheet.tableInstance)
@@ -91175,8 +93282,7 @@
                 rowCount: 100,
                 data: []
             };
-            this.sheetManager.addSheet(newSheet);
-            this.activateSheet(key);
+            this.workbookHistoryManager.addSheet({ sheet: newSheet, activate: true });
         }
         updateFormulaBar() {
             this.formulaUIManager.updateFormulaBar();
@@ -91193,9 +93299,39 @@
         getSheetManager() {
             return this.sheetManager;
         }
+        getWorkbookHistoryManager() {
+            return this.workbookHistoryManager;
+        }
         getActiveSheet() {
             return this.activeWorkSheet;
         }
+        getWorkSheetInstance(sheetKey) {
+            return this.workSheetInstances.get(sheetKey);
+        }
+        setWorkSheetInstance(sheetKey, instance) {
+            this.workSheetInstances.set(sheetKey, instance);
+        }
+        deleteWorkSheetInstance(sheetKey) {
+            this.workSheetInstances.delete(sheetKey);
+        }
+        renameSheet(sheetKey, newTitle) {
+            this.workbookHistoryManager.renameSheet(sheetKey, newTitle);
+        }
+        reorderSheet(sourceKey, targetKey, position) {
+            this.workbookHistoryManager.reorderSheet(sourceKey, targetKey, position);
+        }
+        undo() {
+            this.workbookHistoryManager.undo();
+        }
+        redo() {
+            this.workbookHistoryManager.redo();
+        }
+        startHistoryTransaction() {
+            this.workbookHistoryManager.startTransaction();
+        }
+        endHistoryTransaction() {
+            this.workbookHistoryManager.endTransaction();
+        }
         onTableEvent(type, callback) {
             this.tableEventRelay.onTableEvent(type, callback);
         }
@@ -91306,22 +93442,30 @@
         }
         updateMainMenu(mainMenu) {
             this.options.mainMenu = mainMenu;
-            this.menuManager.updateMainMenu(mainMenu);
+            const topContainer = this.rootElement.querySelector('.vtable-sheet-top-container');
+            if (!topContainer) {
+                return;
+            }
+            this.renderTopLeftControls(topContainer);
         }
         updateOption(options) {
             if (!options) {
                 return;
             }
             const hasMainMenu = typeof options.mainMenu !== 'undefined';
-            if (hasMainMenu) {
-                this.updateMainMenu(options.mainMenu);
-            }
+            const hasUndoRedo = typeof options.undoRedo !== 'undefined';
             const pluginModulesChanged = pluginIsChanged(this.options.VTablePluginModules, options.VTablePluginModules);
             const tableThemeChanged = tableThemeIsChanged(this.options.theme?.tableTheme, options.theme?.tableTheme);
             this.options = {
                 ...this.options,
                 ...options
             };
+            if (hasMainMenu || hasUndoRedo) {
+                const topContainer = this.rootElement.querySelector('.vtable-sheet-top-container');
+                if (topContainer) {
+                    this.renderTopLeftControls(topContainer);
+                }
+            }
             if (Array.isArray(options.sheets) || pluginModulesChanged || tableThemeChanged) {
                 this.updateSheets(options);
             }
@@ -91372,6 +93516,7 @@
                     this.workSheetInstances.set(next_sheetDefine.sheetKey, newInstance);
                     return;
                 }
+                const formulaEditor = createFormulaEditor();
                 const sheetOption = {
                     sheetTitle: next_sheetDefine.sheetTitle,
                     sheetKey: next_sheetDefine.sheetKey,
@@ -91387,8 +93532,8 @@
                     defaultColWidth: this.options.defaultColWidth,
                     dragOrder: next_sheetDefine.dragOrder,
                     plugins: getTablePlugins(next_sheetDefine, this.options, this),
-                    headerEditor: 'formula',
-                    editor: 'formula',
+                    headerEditor: formulaEditor,
+                    editor: formulaEditor,
                     select: {
                         makeSelectCellVisible: false
                     },
@@ -91398,6 +93543,7 @@
                     data: next_sheetDefine.data,
                     columns: next_sheetDefine.columns
                 };
+                formulaEditor.setSheet(this);
                 instance.updateSheetOption(sheetOption);
             });
             try {
@@ -92198,7 +94344,7 @@
   display: flex;
   align-items: center;
   background-color: #fff;
-  width: 50px;
+  width: auto;
   /* 内容居中 */
   justify-content: center;
   flex-shrink: 0; /* 防止菜单被压缩 */
@@ -92207,6 +94353,17 @@
   background-color: #f0f0f0;
 }
 
+.vtable-sheet-undo-redo {
+  display: flex;
+  flex-direction: row;
+  align-items: center;
+  height: 30px;
+  padding: 0;
+  border-bottom: 1px solid #e0e0e0;
+  background-color: #fff;
+  flex-shrink: 0;
+}
+
 .vtable-sheet-main-menu-button {
   display: flex;
   align-items: center;
@@ -92215,6 +94372,38 @@
   height: 30px;
 }
 
+.vtable-sheet-main-menu-actions {
+  display: flex;
+  align-items: center;
+  height: 30px;
+  gap: 4px;
+  padding-right: 6px;
+}
+
+.vtable-sheet-main-menu-action {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 28px;
+  height: 28px;
+  border: none;
+  background: transparent;
+  color: #666;
+  cursor: pointer;
+  padding: 0;
+}
+
+.vtable-sheet-main-menu-action:hover:not(:disabled) {
+  color: #333;
+  background-color: rgba(0, 0, 0, 0.04);
+  border-radius: 4px;
+}
+
+.vtable-sheet-main-menu-action:disabled {
+  opacity: 0.4;
+  cursor: not-allowed;
+}
+
 /* 菜单项容器 */
 .vtable-sheet-main-menu-container {
   position: absolute;
@@ -93003,7 +95192,7 @@
         importStyle();
     }
 
-    const version = "1.23.3";
+    const version = "1.24.0-alpha.0";
     importStyles();
 
     exports.TYPES = index;