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

package/es/history/formula.js

@@ -0,0 +1,103 @@
+export function makeCellKey(sheetKey, row, col) {
+    return `${sheetKey}:${row}:${col}`;
+}
+
+export 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
+    };
+}
+
+export 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);
+}
+
+export 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;
+}
+
+export 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);
+}
+
+export 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)));
+    }
+}
+//# sourceMappingURL=formula.js.map

package/es/history/formula.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/history/formula.ts"],"names":[],"mappings":"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","file":"formula.js","sourcesContent":["import type { ListTable } from '@visactor/vtable';\n\nexport function makeCellKey(sheetKey: string, row: number, col: number): string {\n  return `${sheetKey}:${row}:${col}`;\n}\n\n// 将 A1 单元格引用（如 \"B5\"）解析成 0-based 行列索引。\nexport function parseA1Notation(a1: string): { row: number; col: number } | null {\n  const match = a1.match(/^([A-Z]+)([0-9]+)$/i);\n  if (!match) {\n    return null;\n  }\n  const letters = match[1].toUpperCase();\n  const rowNumber = parseInt(match[2], 10);\n  if (!rowNumber || rowNumber < 1) {\n    return null;\n  }\n  let col = 0;\n  for (let i = 0; i < letters.length; i++) {\n    col = col * 26 + (letters.charCodeAt(i) - 64);\n  }\n  return { row: rowNumber - 1, col: col - 1 };\n}\n\nexport function captureCellPreChangeContent(args: {\n  sheetKey: string | undefined;\n  row: number;\n  col: number;\n  currentValue: any;\n  formulaManager: any;\n  store: Map<string, any>;\n}): void {\n  const { sheetKey, row, col, currentValue, formulaManager, store } = args;\n  if (!sheetKey) {\n    return;\n  }\n  const cellKey = makeCellKey(sheetKey, row, col);\n\n  // 对公式单元格优先记录公式字符串（而不是显示值），确保撤销能恢复“公式关系”。\n  if (formulaManager?.getCellFormula) {\n    try {\n      const oldFormula = formulaManager.getCellFormula({ sheet: sheetKey, row, col });\n      if (oldFormula) {\n        const normalized =\n          typeof oldFormula === 'string' && !oldFormula.startsWith('=') ? `=${oldFormula}` : oldFormula;\n        store.set(cellKey, normalized);\n        return;\n      }\n    } catch {\n      // ignore\n    }\n  }\n\n  store.set(cellKey, currentValue == null ? '' : currentValue);\n}\n\nexport function popCellPreChangeContent(args: {\n  sheetKey: string | undefined;\n  row: number;\n  col: number;\n  fallbackOldContent: any;\n  store: Map<string, any>;\n}): any {\n  const { sheetKey, row, col, fallbackOldContent, store } = args;\n  if (!sheetKey) {\n    return fallbackOldContent;\n  }\n  const cellKey = makeCellKey(sheetKey, row, col);\n  const oldContent = store.get(cellKey);\n  store.delete(cellKey);\n  return typeof oldContent !== 'undefined' ? oldContent : fallbackOldContent;\n}\n\nexport function applyCellContent(args: {\n  table: ListTable;\n  sheetKey: string | undefined;\n  row: number;\n  col: number;\n  content: any;\n  formulaManager: any;\n}): void {\n  const { table, sheetKey, row, col, content, formulaManager } = args;\n\n  if (sheetKey && formulaManager?.setCellContent && formulaManager?.getCellValue) {\n    // 优先写入 formula engine：写入公式后再把显示值同步回 table。\n    try {\n      formulaManager.setCellContent({ sheet: sheetKey, row, col }, content);\n    } catch {\n      table.changeCellValue(col, row, content, false, false, true);\n      return;\n    }\n\n    const isFormula = typeof content === 'string' && content.startsWith('=');\n    if (isFormula) {\n      const result = formulaManager.getCellValue({ sheet: sheetKey, row, col });\n      const display = result?.error ? '#ERROR!' : result?.value;\n      table.changeCellValue(col, row, display, false, false, true);\n      refreshDependentDisplays({ table, sheetKey, startCell: { sheet: sheetKey, row, col }, formulaManager });\n      return;\n    }\n\n    table.changeCellValue(col, row, content, false, false, true);\n    refreshDependentDisplays({ table, sheetKey, startCell: { sheet: sheetKey, row, col }, formulaManager });\n    return;\n  }\n\n  table.changeCellValue(col, row, content, false, false, true);\n}\n\nexport function refreshDependentDisplays(args: {\n  table: ListTable;\n  sheetKey: string;\n  startCell: { sheet: string; row: number; col: number };\n  formulaManager: any;\n  maxCells?: number;\n}): void {\n  const { table, sheetKey, startCell, formulaManager } = args;\n  const maxCells = args.maxCells ?? 5000;\n\n  if (!formulaManager?.getCellDependents || !formulaManager?.getCellValue) {\n    return;\n  }\n\n  const visited = new Set<string>();\n  const queue = [...(formulaManager.getCellDependents(startCell) || [])];\n  let processed = 0;\n\n  while (queue.length) {\n    const cell = queue.shift();\n    if (!cell || cell.sheet !== sheetKey) {\n      continue;\n    }\n    const key = makeCellKey(cell.sheet, cell.row, cell.col);\n    if (visited.has(key)) {\n      continue;\n    }\n    visited.add(key);\n    processed++;\n    if (processed > maxCells) {\n      break;\n    }\n\n    const result = formulaManager.getCellValue(cell);\n    const display = result?.error ? '#ERROR!' : result?.value;\n    table.changeCellValue(cell.col, cell.row, display, false, false, true);\n\n    const deps = formulaManager.getCellDependents(cell) || [];\n    deps.forEach((d: any) => queue.push(d));\n  }\n}\n"]}

package/es/history/history-plugin.d.ts

@@ -0,0 +1,88 @@
+import type { BaseTableAPI, pluginsDefinition } from '@visactor/vtable';
+import type { TableEventHandlersEventArgumentMap } from '@visactor/vtable/es/ts-types/events';
+import type { HistoryCommand, HistoryPluginOptions } from './types';
+export declare class HistoryPlugin implements pluginsDefinition.IVTablePlugin {
+    id: string;
+    name: string;
+    runTime: any[];
+    private table;
+    private vtableSheet;
+    private resolvedSheetKey;
+    private undoStack;
+    private redoStack;
+    private currentTransaction;
+    private isReplaying;
+    private maxHistory;
+    private enableCompression;
+    private onTransactionPushed?;
+    private prevColumnsSnapshot;
+    private prevMergeSnapshot;
+    private prevRecordsSnapshot;
+    private prevFormulasSnapshot;
+    private prevResizedRowHeightsSnapshot;
+    private prevResizedColWidthsSnapshot;
+    private lastKnownSortState;
+    private sortStartSnapshot;
+    private sortPending;
+    private sortEventBound;
+    private sortChangeOrderListenerId;
+    private cellPreChangeContent;
+    private formulaCache;
+    private formulaEventBound;
+    private formulaEventManager;
+    private onFormulaAddedHandler;
+    private resizeRowStartHeight;
+    private resizeColStartWidth;
+    private filterEventBound;
+    private filterUnsubscribe;
+    private filterSnapshotCache;
+    private filterPluginId;
+    private filterPluginRef;
+    private filterApplySnapshotOriginal;
+    private filterApplyingSnapshot;
+    constructor(options?: HistoryPluginOptions);
+    run(...args: [TableEventHandlersEventArgumentMap[keyof TableEventHandlersEventArgumentMap], any, BaseTableAPI]): void;
+    startTransaction(): void;
+    endTransaction(): void;
+    undo(): void;
+    redo(): void;
+    clear(): void;
+    updateOptions(options: Partial<HistoryPluginOptions>): void;
+    release(): void;
+    private ensureFilterEventBindings;
+    private unbindFilterEvents;
+    private getSheetKey;
+    private getSnapshotState;
+    private setSnapshotState;
+    private pushTransaction;
+    private trimHistory;
+    private pushCommand;
+    recordExternalCommand(cmd: HistoryCommand): void;
+    private tryCompressCellChange;
+    private handleBeforeKeydown;
+    private handleChangeCellValue;
+    private handleChangeCellValues;
+    private ensureFormulaEventBindings;
+    private ensureSortEventBindings;
+    private unbindSortEvents;
+    private unbindFormulaEvents;
+    private cloneMergeConfig;
+    private isSameMergeConfig;
+    private handleMergeCells;
+    private handleUnmergeCells;
+    private handleMergeConfigChanged;
+    private handleAddRecord;
+    private handleDeleteRecord;
+    private handleUpdateRecord;
+    private handleAddColumn;
+    private handleDeleteColumn;
+    private handleChangeHeaderPosition;
+    private normalizeSortState;
+    private handleSortClick;
+    private handleResizeRow;
+    private handleResizeRowEnd;
+    private handleResizeColumn;
+    private handleResizeColumnEnd;
+    private applyCommand;
+    private deleteRecordsByReference;
+}