@visactor/vtable-sheet 1.22.7 → 1.22.8-alpha.13

package/cjs/formula/cross-sheet-formula-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/formula/cross-sheet-formula-handler.ts"],"names":[],"mappings":"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","file":"cross-sheet-formula-handler.js","sourcesContent":["/**\n * 跨sheet公式处理器\n * 处理跨sheet公式的计算、更新和同步\n */\n\nimport type { FormulaCell } from '../ts-types/formula';\nimport type { FormulaEngine } from './formula-engine';\nimport { CrossSheetFormulaManager } from './cross-sheet-formula-manager';\nimport { CrossSheetDataSynchronizer } from './cross-sheet-data-synchronizer';\nimport { CrossSheetFormulaValidator, type ValidationResult } from './cross-sheet-formula-validator';\n\nexport interface CrossSheetFormulaOptions {\n  enableCaching: boolean;\n  enableValidation: boolean;\n  syncTimeout: number;\n  maxRecursionDepth: number;\n}\n\nexport interface FormulaCalculationResult {\n  value: any;\n  error?: string;\n  dependencies: FormulaCell[];\n  calculationTime: number;\n}\n\nexport class CrossSheetFormulaHandler {\n  private formulaEngine: FormulaEngine;\n  private crossSheetManager: CrossSheetFormulaManager;\n  private dataSynchronizer: CrossSheetDataSynchronizer;\n  private validator: CrossSheetFormulaValidator;\n  private formulaManager?: any; // FormulaManager reference for proper sheet registration\n\n  private options: CrossSheetFormulaOptions = {\n    enableCaching: true,\n    enableValidation: true,\n    syncTimeout: 50,\n    maxRecursionDepth: 100\n  };\n\n  // 计算状态\n  private isCalculating = false;\n  private calculationQueue: FormulaCell[] = [];\n  private calculationResults: Map<string, FormulaCalculationResult> = new Map();\n\n  constructor(\n    formulaEngine: FormulaEngine,\n    sheetManager?: { getAllSheets: () => Array<{ sheetKey: string; sheetTitle: string }> },\n    formulaManager?: any\n  ) {\n    this.formulaEngine = formulaEngine;\n    this.formulaManager = formulaManager;\n    this.crossSheetManager = new CrossSheetFormulaManager(formulaEngine, sheetManager);\n    this.dataSynchronizer = new CrossSheetDataSynchronizer(formulaEngine, this.crossSheetManager);\n    this.validator = new CrossSheetFormulaValidator(formulaEngine, this.crossSheetManager, sheetManager);\n  }\n\n  /**\n   * 设置跨sheet公式\n   */\n  async setCrossSheetFormula(cell: FormulaCell, formula: string): Promise<FormulaCalculationResult> {\n    const startTime = performance.now();\n\n    try {\n      // 验证公式（如果启用）\n      if (this.options.enableValidation) {\n        const validation = this.validator.validateFormulaSyntax(formula);\n        if (!validation.valid) {\n          return {\n            value: null,\n            error: validation.error,\n            dependencies: [],\n            calculationTime: performance.now() - startTime\n          };\n        }\n      }\n\n      // 注册跨sheet引用\n      this.crossSheetManager.registerCrossSheetReference(formula, cell);\n\n      // 设置公式到引擎\n      this.formulaEngine.setCellContent(cell, formula);\n\n      // 计算结果\n      let result: { value: any; error?: string };\n      if (this.formulaManager) {\n        // 使用FormulaManager获取单元格值（支持未激活的sheet）\n        result = this.formulaManager.getCellValue(cell);\n      } else {\n        // 回退到直接使用FormulaEngine\n        result = this.formulaEngine.getCellValue(cell);\n      }\n\n      // 获取依赖关系\n      const dependencies = this.formulaEngine.getCellPrecedents(cell);\n\n      const calculationResult: FormulaCalculationResult = {\n        value: result.value,\n        error: result.error,\n        dependencies,\n        calculationTime: performance.now() - startTime\n      };\n\n      // 缓存结果\n      if (this.options.enableCaching) {\n        this.cacheCalculationResult(cell, calculationResult);\n      }\n\n      return calculationResult;\n    } catch (error) {\n      return {\n        value: null,\n        error: error instanceof Error ? error.message : 'Unknown error',\n        dependencies: [],\n        calculationTime: performance.now() - startTime\n      };\n    }\n  }\n\n  /**\n   * 获取跨sheet公式的值\n   */\n  async getCrossSheetValue(cell: FormulaCell): Promise<FormulaCalculationResult> {\n    const startTime = performance.now();\n\n    try {\n      // 检查缓存\n      if (this.options.enableCaching) {\n        const cached = this.getCachedResult(cell);\n        if (cached) {\n          return {\n            ...cached,\n            calculationTime: performance.now() - startTime\n          };\n        }\n      }\n\n      // 获取公式\n      const formula = this.formulaEngine.getCellFormula(cell);\n      if (!formula) {\n        return {\n          value: null,\n          error: 'No formula found',\n          dependencies: [],\n          calculationTime: performance.now() - startTime\n        };\n      }\n\n      // 计算结果\n      let result: { value: any; error?: string };\n      if (this.formulaManager) {\n        // 使用FormulaManager获取单元格值（支持未激活的sheet）\n        result = this.formulaManager.getCellValue(cell);\n      } else {\n        // 回退到直接使用FormulaEngine\n        result = this.formulaEngine.getCellValue(cell);\n      }\n      const dependencies = this.formulaEngine.getCellPrecedents(cell);\n\n      const calculationResult: FormulaCalculationResult = {\n        value: result.value,\n        error: result.error,\n        dependencies,\n        calculationTime: performance.now() - startTime\n      };\n\n      // 缓存结果\n      if (this.options.enableCaching) {\n        this.cacheCalculationResult(cell, calculationResult);\n      }\n\n      return calculationResult;\n    } catch (error) {\n      return {\n        value: null,\n        error: error instanceof Error ? error.message : 'Unknown error',\n        dependencies: [],\n        calculationTime: performance.now() - startTime\n      };\n    }\n  }\n\n  /**\n   * 更新跨sheet引用\n   */\n  async updateCrossSheetReferences(targetSheet: string, changedCells: FormulaCell[]): Promise<void> {\n    await this.crossSheetManager.updateCrossSheetReferences(targetSheet, changedCells);\n  }\n\n  /**\n   * 验证跨sheet公式\n   */\n  validateCrossSheetFormula(cell: FormulaCell): ValidationResult {\n    const formula = this.formulaEngine.getCellFormula(cell);\n    if (!formula) {\n      return {\n        valid: false,\n        errors: [\n          {\n            type: 'MISSING_REFERENCE',\n            message: 'No formula found',\n            sheet: cell.sheet,\n            cell\n          }\n        ],\n        warnings: []\n      };\n    }\n\n    const syntaxValidation = this.validator.validateFormulaSyntax(formula);\n    return {\n      valid: syntaxValidation.valid,\n      errors: syntaxValidation.error\n        ? [\n            {\n              type: 'MISSING_REFERENCE',\n              message: syntaxValidation.error,\n              sheet: cell.sheet,\n              cell\n            }\n          ]\n        : [],\n      warnings: []\n    };\n  }\n\n  /**\n   * 验证所有跨sheet公式\n   */\n  validateAllCrossSheetFormulas(): Map<string, ValidationResult> {\n    return this.validator.validateAllSheets();\n  }\n\n  /**\n   * 获取跨sheet依赖关系\n   */\n  getCrossSheetDependencies(): Map<string, string[]> {\n    return this.dataSynchronizer.getCrossSheetDependencies();\n  }\n\n  /**\n   * 强制重新计算所有跨sheet公式\n   */\n  async recalculateAllCrossSheetFormulas(): Promise<void> {\n    const allSheets = this.formulaEngine.getAllSheets();\n\n    for (const sheetInfo of allSheets) {\n      const formulas = this.formulaEngine.exportFormulas(sheetInfo.key);\n\n      for (const [cellRef, formula] of Object.entries(formulas)) {\n        if (this.hasCrossSheetReference(formula)) {\n          const cell = this.parseA1Notation(cellRef);\n          const cellWithSheet: FormulaCell = { sheet: sheetInfo.key, row: cell.row, col: cell.col };\n\n          await this.recalculateFormula(cellWithSheet);\n        }\n      }\n    }\n  }\n\n  /**\n   * 重新计算公式\n   */\n  async recalculateFormula(cell: FormulaCell): Promise<FormulaCalculationResult> {\n    return await this.getCrossSheetValue(cell);\n  }\n\n  /**\n   * 检查公式是否包含跨sheet引用\n   */\n  private hasCrossSheetReference(formula: string): boolean {\n    return formula.includes('!');\n  }\n\n  /**\n   * 缓存计算结果\n   */\n  private cacheCalculationResult(cell: FormulaCell, result: FormulaCalculationResult): void {\n    const cacheKey = this.getCacheKey(cell);\n    this.calculationResults.set(cacheKey, result);\n  }\n\n  /**\n   * 获取缓存的计算结果\n   */\n  private getCachedResult(cell: FormulaCell): FormulaCalculationResult | null {\n    const cacheKey = this.getCacheKey(cell);\n    return this.calculationResults.get(cacheKey) || null;\n  }\n\n  /**\n   * 获取缓存键\n   */\n  private getCacheKey(cell: FormulaCell): string {\n    return `${cell.sheet}!${this.getA1Notation(cell.row, cell.col)}`;\n  }\n\n  /**\n   * A1表示法解析\n   */\n  private parseA1Notation(a1Notation: string): { row: number; col: number } {\n    const match = a1Notation.match(/^([A-Z]+)([0-9]+)$/);\n    if (!match) {\n      throw new Error(`Invalid cell reference: ${a1Notation}`);\n    }\n\n    const colLetters = match[1];\n    const rowNumber = parseInt(match[2], 10);\n\n    let col = 0;\n    for (let i = 0; i < colLetters.length; i++) {\n      col = col * 26 + (colLetters.charCodeAt(i) - 65);\n    }\n\n    return { row: rowNumber - 1, col };\n  }\n\n  /**\n   * A1表示法生成\n   */\n  private getA1Notation(row: number, col: number): string {\n    let colStr = '';\n    let tempCol = col;\n\n    do {\n      colStr = String.fromCharCode(65 + (tempCol % 26)) + colStr;\n      tempCol = Math.floor(tempCol / 26) - 1;\n    } while (tempCol >= 0);\n\n    return `${colStr}${row + 1}`;\n  }\n\n  /**\n   * 更新处理选项\n   */\n  updateOptions(options: Partial<CrossSheetFormulaOptions>): void {\n    this.options = { ...this.options, ...options };\n\n    // 更新依赖组件的选项\n    this.dataSynchronizer.updateSyncOptions({\n      immediate: this.options.enableCaching,\n      timeout: this.options.syncTimeout\n    });\n  }\n\n  /**\n   * 获取处理状态\n   */\n  getHandlerStatus(): {\n    isCalculating: boolean;\n    pendingCalculations: number;\n    cacheSize: number;\n    options: CrossSheetFormulaOptions;\n  } {\n    return {\n      isCalculating: this.isCalculating,\n      pendingCalculations: this.calculationQueue.length,\n      cacheSize: this.calculationResults.size,\n      options: { ...this.options }\n    };\n  }\n\n  /**\n   * 清除缓存\n   */\n  clearCache(): void {\n    this.calculationResults.clear();\n    this.crossSheetManager.clearCache();\n    this.validator.clearCache();\n  }\n\n  /**\n   * 添加数据变更监听器\n   */\n  addDataChangeListener(sheet: string, listener: (event: any) => void): void {\n    this.dataSynchronizer.addDataChangeListener(sheet, listener);\n  }\n\n  /**\n   * 移除数据变更监听器\n   */\n  removeDataChangeListener(sheet: string, listener: (event: any) => void): void {\n    this.dataSynchronizer.removeDataChangeListener(sheet, listener);\n  }\n\n  /**\n   * 强制同步\n   */\n  async forceSync(): Promise<void> {\n    await this.dataSynchronizer.forceSync();\n  }\n\n  /**\n   * 销毁处理器\n   */\n  destroy(): void {\n    this.clearCache();\n    this.calculationResults.clear();\n    this.calculationQueue = [];\n    this.crossSheetManager.destroy();\n    this.dataSynchronizer.destroy();\n    this.validator.destroy();\n  }\n}\n"]}

package/cjs/formula/cross-sheet-formula-manager.d.ts

@@ -0,0 +1,52 @@
+import type { FormulaCell } from '../ts-types/formula';
+import type { FormulaEngine } from './formula-engine';
+export interface CrossSheetReference {
+    sourceSheet: string;
+    targetSheet: string;
+    sourceCell: FormulaCell;
+    targetCells: FormulaCell[];
+    formula: string;
+}
+export interface CrossSheetDependency {
+    dependentSheet: string;
+    precedentSheet: string;
+    dependentCells: FormulaCell[];
+    precedentCells: FormulaCell[];
+}
+export declare class CrossSheetFormulaManager {
+    private formulaEngine;
+    private sheetManager;
+    private crossSheetDependencies;
+    private reverseCrossSheetDependencies;
+    private calculationCache;
+    private readonly CACHE_TTL;
+    constructor(formulaEngine: FormulaEngine, sheetManager?: {
+        getAllSheets: () => Array<{
+            sheetKey: string;
+            sheetTitle: string;
+        }>;
+    });
+    registerCrossSheetReference(formula: string, sourceCell: FormulaCell): CrossSheetReference[];
+    private isValidSheet;
+    private extractTargetSheets;
+    private extractTargetCells;
+    private updateCrossSheetDependency;
+    getCrossSheetDependencies(sheet: string): CrossSheetDependency[];
+    private getDependentCells;
+    private getPrecedentCells;
+    updateCrossSheetReferences(targetSheet: string, changedCells: FormulaCell[]): Promise<void>;
+    private formulaReferencesCells;
+    private recalculateFormula;
+    private recalculateDependents;
+    validateCrossSheetReferences(sheet: string): {
+        valid: boolean;
+        errors: string[];
+    };
+    getCachedValue(cell: FormulaCell): any;
+    clearCache(): void;
+    clearSheetDependencies(sheet: string): void;
+    private parseA1Notation;
+    private getA1Notation;
+    private getCacheKey;
+    destroy(): void;
+}

package/cjs/formula/cross-sheet-formula-manager.js

@@ -0,0 +1,235 @@
+"use strict";
+
+var __awaiter = this && this.__awaiter || function(thisArg, _arguments, P, generator) {
+    return new (P || (P = Promise))((function(resolve, reject) {
+        function fulfilled(value) {
+            try {
+                step(generator.next(value));
+            } catch (e) {
+                reject(e);
+            }
+        }
+        function rejected(value) {
+            try {
+                step(generator.throw(value));
+            } catch (e) {
+                reject(e);
+            }
+        }
+        function step(result) {
+            var value;
+            result.done ? resolve(result.value) : (value = result.value, value instanceof P ? value : new P((function(resolve) {
+                resolve(value);
+            }))).then(fulfilled, rejected);
+        }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    }));
+};
+
+Object.defineProperty(exports, "__esModule", {
+    value: !0
+}), exports.CrossSheetFormulaManager = void 0;
+
+class CrossSheetFormulaManager {
+    constructor(formulaEngine, sheetManager) {
+        this.crossSheetDependencies = new Map, this.reverseCrossSheetDependencies = new Map, 
+        this.calculationCache = new Map, this.CACHE_TTL = 1e3, this.formulaEngine = formulaEngine, 
+        this.sheetManager = sheetManager;
+    }
+    registerCrossSheetReference(formula, sourceCell) {
+        const references = [], targetSheets = this.extractTargetSheets(formula);
+        for (const targetSheet of targetSheets) {
+            const targetCells = this.extractTargetCells(formula, targetSheet);
+            targetCells.length > 0 && (references.push({
+                sourceSheet: sourceCell.sheet,
+                targetSheet: targetSheet,
+                sourceCell: sourceCell,
+                targetCells: targetCells,
+                formula: formula
+            }), this.updateCrossSheetDependency(sourceCell.sheet, targetSheet, sourceCell, targetCells));
+        }
+        return references;
+    }
+    isValidSheet(sheetName) {
+        if (this.sheetManager) {
+            return this.sheetManager.getAllSheets().some((sheet => sheet.sheetTitle.toLowerCase() === sheetName.toLowerCase()));
+        }
+        return this.formulaEngine.getAllSheets().some((sheet => sheet.title.toLowerCase() === sheetName.toLowerCase()));
+    }
+    extractTargetSheets(formula) {
+        const sheets = new Set, quotedSheetPattern = /'([^']+)'[!！]/g, unquotedSheetPattern = /([A-Za-z0-9_\s一-龥]+)[!！]/g;
+        let match;
+        for (;null !== (match = quotedSheetPattern.exec(formula)); ) {
+            const sheetName = match[1];
+            sheetName && this.isValidSheet(sheetName) && sheets.add(sheetName);
+        }
+        for (;null !== (match = unquotedSheetPattern.exec(formula)); ) {
+            const sheetName = match[1];
+            sheetName && this.isValidSheet(sheetName) && sheets.add(sheetName);
+        }
+        return Array.from(sheets);
+    }
+    extractTargetCells(formula, targetSheet) {
+        const cells = [], escapedSheetName = targetSheet.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"), cellPattern = new RegExp(`'?${escapedSheetName}'?[!！]([A-Z]+[0-9]+)(?:\\s*:\\s*(?:'?${escapedSheetName}'?[!！])?([A-Z]+[0-9]+))?`, "g");
+        let match;
+        for (;null !== (match = cellPattern.exec(formula)); ) if (match[2]) {
+            const startCell = this.parseA1Notation(match[1]), endCell = this.parseA1Notation(match[2]);
+            for (let row = Math.min(startCell.row, endCell.row); row <= Math.max(startCell.row, endCell.row); row++) for (let col = Math.min(startCell.col, endCell.col); col <= Math.max(startCell.col, endCell.col); col++) cells.push({
+                sheet: targetSheet,
+                row: row,
+                col: col
+            });
+        } else {
+            const cell = this.parseA1Notation(match[1]);
+            cells.push({
+                sheet: targetSheet,
+                row: cell.row,
+                col: cell.col
+            });
+        }
+        return cells;
+    }
+    updateCrossSheetDependency(sourceSheet, targetSheet, _sourceCell, _targetCells) {
+        this.crossSheetDependencies.has(sourceSheet) || this.crossSheetDependencies.set(sourceSheet, new Set);
+        const sourceDeps = this.crossSheetDependencies.get(sourceSheet);
+        sourceDeps && sourceDeps.add(targetSheet), this.reverseCrossSheetDependencies.has(targetSheet) || this.reverseCrossSheetDependencies.set(targetSheet, new Set);
+        const targetDeps = this.reverseCrossSheetDependencies.get(targetSheet);
+        targetDeps && targetDeps.add(sourceSheet);
+    }
+    getCrossSheetDependencies(sheet) {
+        const dependencies = [], targetSheets = this.crossSheetDependencies.get(sheet);
+        if (targetSheets) for (const targetSheet of targetSheets) {
+            const dependentCells = this.getDependentCells(sheet, targetSheet), precedentCells = this.getPrecedentCells(targetSheet, sheet);
+            dependencies.push({
+                dependentSheet: sheet,
+                precedentSheet: targetSheet,
+                dependentCells: dependentCells,
+                precedentCells: precedentCells
+            });
+        }
+        return dependencies;
+    }
+    getDependentCells(dependentSheet, precedentSheet) {
+        const cells = [], allSheets = this.formulaEngine.getAllSheets();
+        for (const sheetInfo of allSheets) if (sheetInfo.key === dependentSheet) {
+            const formulas = this.formulaEngine.exportFormulas(sheetInfo.key);
+            for (const [cellRef, formula] of Object.entries(formulas)) if (formula.includes(`${precedentSheet}!`)) {
+                const cell = this.parseA1Notation(cellRef);
+                cells.push({
+                    sheet: dependentSheet,
+                    row: cell.row,
+                    col: cell.col
+                });
+            }
+        }
+        return cells;
+    }
+    getPrecedentCells(precedentSheet, dependentSheet) {
+        const cells = [], formulas = this.formulaEngine.exportFormulas(dependentSheet);
+        for (const formula of Object.values(formulas)) if (formula.includes(`${precedentSheet}!`)) {
+            const targetCells = this.extractTargetCells(formula, precedentSheet);
+            cells.push(...targetCells);
+        }
+        return cells;
+    }
+    updateCrossSheetReferences(targetSheet, changedCells) {
+        return __awaiter(this, void 0, void 0, (function*() {
+            const dependentSheets = this.reverseCrossSheetDependencies.get(targetSheet);
+            if (!dependentSheets || 0 === dependentSheets.size) return;
+            const cellsToRecalculate = [];
+            for (const dependentSheet of dependentSheets) {
+                const formulas = this.formulaEngine.exportFormulas(dependentSheet);
+                for (const [cellRef, formula] of Object.entries(formulas)) if (this.formulaReferencesCells(formula, targetSheet, changedCells)) {
+                    const cell = this.parseA1Notation(cellRef);
+                    cellsToRecalculate.push({
+                        sheet: dependentSheet,
+                        row: cell.row,
+                        col: cell.col
+                    });
+                }
+            }
+            for (const cell of cellsToRecalculate) yield this.recalculateFormula(cell);
+        }));
+    }
+    formulaReferencesCells(formula, targetSheet, targetCells) {
+        return this.extractTargetCells(formula, targetSheet).some((refCell => targetCells.some((targetCell => refCell.sheet === targetCell.sheet && refCell.row === targetCell.row && refCell.col === targetCell.col))));
+    }
+    recalculateFormula(cell) {
+        return __awaiter(this, void 0, void 0, (function*() {
+            try {
+                const formula = this.formulaEngine.getCellFormula(cell);
+                if (formula) {
+                    const result = this.formulaEngine.calculateFormula(formula), cacheKey = this.getCacheKey(cell);
+                    this.calculationCache.set(cacheKey, {
+                        value: result.value,
+                        timestamp: Date.now()
+                    }), this.recalculateDependents(cell);
+                }
+            } catch (error) {}
+        }));
+    }
+    recalculateDependents(cell) {
+        const dependents = this.formulaEngine.getCellDependents(cell);
+        for (const dependent of dependents) this.recalculateFormula(dependent);
+    }
+    validateCrossSheetReferences(sheet) {
+        const errors = [], formulas = this.formulaEngine.exportFormulas(sheet);
+        for (const [cellRef, formula] of Object.entries(formulas)) {
+            const targetSheets = this.extractTargetSheets(formula);
+            for (const targetSheet of targetSheets) {
+                if (!this.formulaEngine.getAllSheets().some((s => s.key === targetSheet))) {
+                    errors.push(`Invalid sheet reference in ${cellRef}: ${targetSheet}`);
+                    continue;
+                }
+                const targetCells = this.extractTargetCells(formula, targetSheet);
+                for (const targetCell of targetCells) {
+                    this.formulaEngine.getCellValue(targetCell).error && errors.push(`Invalid cell reference in ${cellRef}: ${targetSheet}!${this.getA1Notation(targetCell.row, targetCell.col)}`);
+                }
+            }
+        }
+        return {
+            valid: 0 === errors.length,
+            errors: errors
+        };
+    }
+    getCachedValue(cell) {
+        const cacheKey = this.getCacheKey(cell), cached = this.calculationCache.get(cacheKey);
+        return cached && Date.now() - cached.timestamp < this.CACHE_TTL ? cached.value : null;
+    }
+    clearCache() {
+        this.calculationCache.clear();
+    }
+    clearSheetDependencies(sheet) {
+        this.crossSheetDependencies.delete(sheet);
+        for (const [targetSheet, sourceSheets] of this.reverseCrossSheetDependencies.entries()) sourceSheets.delete(sheet), 
+        0 === sourceSheets.size && this.reverseCrossSheetDependencies.delete(targetSheet);
+        for (const [cacheKey] of this.calculationCache.entries()) cacheKey.startsWith(`${sheet}!`) && this.calculationCache.delete(cacheKey);
+    }
+    parseA1Notation(a1Notation) {
+        const match = a1Notation.match(/^([A-Z]+)([0-9]+)$/);
+        if (!match) throw new Error(`Invalid cell reference: ${a1Notation}`);
+        const colLetters = match[1], rowNumber = parseInt(match[2], 10);
+        let col = 0;
+        for (let i = 0; i < colLetters.length; i++) col = 26 * col + (colLetters.charCodeAt(i) - 65);
+        return {
+            row: rowNumber - 1,
+            col: col
+        };
+    }
+    getA1Notation(row, col) {
+        let colStr = "", tempCol = col;
+        do {
+            colStr = String.fromCharCode(65 + tempCol % 26) + colStr, tempCol = Math.floor(tempCol / 26) - 1;
+        } while (tempCol >= 0);
+        return `${colStr}${row + 1}`;
+    }
+    getCacheKey(cell) {
+        return `${cell.sheet}!${this.getA1Notation(cell.row, cell.col)}`;
+    }
+    destroy() {
+        this.clearCache(), this.crossSheetDependencies.clear(), this.reverseCrossSheetDependencies.clear();
+    }
+}
+
+exports.CrossSheetFormulaManager = CrossSheetFormulaManager;
+//# sourceMappingURL=cross-sheet-formula-manager.js.map

package/cjs/formula/cross-sheet-formula-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/formula/cross-sheet-formula-manager.ts"],"names":[],"mappings":"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","file":"cross-sheet-formula-manager.js","sourcesContent":["/**\n * 跨sheet公式管理器\n * 专门处理跨sheet tab的公式引用和计算\n */\n\nimport type { FormulaCell } from '../ts-types/formula';\nimport type { FormulaEngine } from './formula-engine';\n\nexport interface CrossSheetReference {\n  sourceSheet: string;\n  targetSheet: string;\n  sourceCell: FormulaCell;\n  targetCells: FormulaCell[];\n  formula: string;\n}\n\nexport interface CrossSheetDependency {\n  dependentSheet: string;\n  precedentSheet: string;\n  dependentCells: FormulaCell[];\n  precedentCells: FormulaCell[];\n}\n\nexport class CrossSheetFormulaManager {\n  private formulaEngine: FormulaEngine;\n  private sheetManager: { getAllSheets: () => Array<{ sheetKey: string; sheetTitle: string }> } | undefined;\n\n  // 跨sheet依赖关系映射\n  private crossSheetDependencies: Map<string, Set<string>> = new Map();\n\n  // 反向依赖映射（用于快速查找）\n  private reverseCrossSheetDependencies: Map<string, Set<string>> = new Map();\n\n  // 缓存机制\n  private calculationCache: Map<string, { value: any; timestamp: number }> = new Map();\n  private readonly CACHE_TTL = 1000; // 1秒缓存\n\n  constructor(\n    formulaEngine: FormulaEngine,\n    sheetManager?: { getAllSheets: () => Array<{ sheetKey: string; sheetTitle: string }> }\n  ) {\n    this.formulaEngine = formulaEngine;\n    this.sheetManager = sheetManager;\n  }\n\n  /**\n   * 注册跨sheet公式引用\n   */\n  registerCrossSheetReference(formula: string, sourceCell: FormulaCell): CrossSheetReference[] {\n    const references: CrossSheetReference[] = [];\n    const targetSheets = this.extractTargetSheets(formula);\n\n    for (const targetSheet of targetSheets) {\n      const targetCells = this.extractTargetCells(formula, targetSheet);\n      if (targetCells.length > 0) {\n        references.push({\n          sourceSheet: sourceCell.sheet,\n          targetSheet,\n          sourceCell,\n          targetCells,\n          formula\n        });\n\n        // 更新依赖关系\n        this.updateCrossSheetDependency(sourceCell.sheet, targetSheet, sourceCell, targetCells);\n      }\n    }\n\n    return references;\n  }\n\n  /**\n   * 验证sheet是否存在（使用sheetTitle而不是sheetKey）\n   * 检查所有存在的sheet，包括未激活的sheet\n   */\n  private isValidSheet(sheetName: string): boolean {\n    // 优先使用sheetManager检查所有存在的sheet（包括未激活的）\n    if (this.sheetManager) {\n      const allSheets = this.sheetManager.getAllSheets();\n      return allSheets.some(sheet => sheet.sheetTitle.toLowerCase() === sheetName.toLowerCase());\n    }\n\n    // 回退到formulaEngine中已注册的sheet\n    const allSheets = this.formulaEngine.getAllSheets();\n    return allSheets.some(sheet => sheet.title.toLowerCase() === sheetName.toLowerCase());\n  }\n\n  /**\n   * 提取公式中引用的目标sheet\n   * 检查所有存在的sheet，包括未激活的sheet\n   */\n  private extractTargetSheets(formula: string): string[] {\n    const sheets = new Set<string>();\n    // 支持：\n    // - Sheet1!A1\n    // - Sheet1！A1\n    // - 'My Sheet'!A1\n    // - 'My Sheet'！A1\n    const quotedSheetPattern = /'([^']+)'[!！]/g;\n    const unquotedSheetPattern = /([A-Za-z0-9_\\s一-龥]+)[!！]/g;\n\n    let match: RegExpExecArray | null;\n    while ((match = quotedSheetPattern.exec(formula)) !== null) {\n      const sheetName = match[1];\n      if (sheetName && this.isValidSheet(sheetName)) {\n        sheets.add(sheetName);\n      }\n    }\n    while ((match = unquotedSheetPattern.exec(formula)) !== null) {\n      const sheetName = match[1];\n      if (sheetName && this.isValidSheet(sheetName)) {\n        sheets.add(sheetName);\n      }\n    }\n\n    return Array.from(sheets);\n  }\n\n  /**\n   * 提取公式中引用的目标单元格\n   */\n  private extractTargetCells(formula: string, targetSheet: string): FormulaCell[] {\n    const cells: FormulaCell[] = [];\n\n    // 匹配带sheet前缀的单元格引用，如 Sheet1!A1 或 Sheet1!A1:B2 - 支持中英文sheet名称\n    const escapedSheetName = targetSheet.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n    const sepPattern = '[!！]';\n    // 支持：\n    // - Sheet1!A1\n    // - Sheet1!A1:B2\n    // - Sheet1!A1:Sheet1!B2\n    // - 'My Sheet'!A1:'My Sheet'!B2\n    const cellPattern = new RegExp(\n      `'?${escapedSheetName}'?${sepPattern}([A-Z]+[0-9]+)` +\n        `(?:\\\\s*:\\\\s*(?:'?${escapedSheetName}'?${sepPattern})?([A-Z]+[0-9]+))?`,\n      'g'\n    );\n    let match;\n\n    while ((match = cellPattern.exec(formula)) !== null) {\n      if (match[2]) {\n        // 范围引用，如 A1:B2\n        const startCell = this.parseA1Notation(match[1]);\n        const endCell = this.parseA1Notation(match[2]);\n\n        // 展开范围到所有单元格\n        for (let row = Math.min(startCell.row, endCell.row); row <= Math.max(startCell.row, endCell.row); row++) {\n          for (let col = Math.min(startCell.col, endCell.col); col <= Math.max(startCell.col, endCell.col); col++) {\n            cells.push({ sheet: targetSheet, row, col });\n          }\n        }\n      } else {\n        // 单个单元格引用，如 A1\n        const cell = this.parseA1Notation(match[1]);\n        cells.push({ sheet: targetSheet, row: cell.row, col: cell.col });\n      }\n    }\n\n    return cells;\n  }\n\n  /**\n   * 更新跨sheet依赖关系\n   */\n  private updateCrossSheetDependency(\n    sourceSheet: string,\n    targetSheet: string,\n    _sourceCell: FormulaCell,\n    _targetCells: FormulaCell[]\n  ): void {\n    // 正向依赖\n    if (!this.crossSheetDependencies.has(sourceSheet)) {\n      this.crossSheetDependencies.set(sourceSheet, new Set());\n    }\n    const sourceDeps = this.crossSheetDependencies.get(sourceSheet);\n    if (sourceDeps) {\n      sourceDeps.add(targetSheet);\n    }\n\n    // 反向依赖\n    if (!this.reverseCrossSheetDependencies.has(targetSheet)) {\n      this.reverseCrossSheetDependencies.set(targetSheet, new Set());\n    }\n    const targetDeps = this.reverseCrossSheetDependencies.get(targetSheet);\n    if (targetDeps) {\n      targetDeps.add(sourceSheet);\n    }\n  }\n\n  /**\n   * 获取跨sheet依赖关系\n   */\n  getCrossSheetDependencies(sheet: string): CrossSheetDependency[] {\n    const dependencies: CrossSheetDependency[] = [];\n    const targetSheets = this.crossSheetDependencies.get(sheet);\n\n    if (targetSheets) {\n      for (const targetSheet of targetSheets) {\n        const dependentCells = this.getDependentCells(sheet, targetSheet);\n        const precedentCells = this.getPrecedentCells(targetSheet, sheet);\n\n        dependencies.push({\n          dependentSheet: sheet,\n          precedentSheet: targetSheet,\n          dependentCells,\n          precedentCells\n        });\n      }\n    }\n\n    return dependencies;\n  }\n\n  /**\n   * 获取依赖于指定sheet的单元格\n   */\n  private getDependentCells(dependentSheet: string, precedentSheet: string): FormulaCell[] {\n    const cells: FormulaCell[] = [];\n\n    // 遍历所有公式，找到引用precedentSheet的单元格\n    const allSheets = this.formulaEngine.getAllSheets();\n    for (const sheetInfo of allSheets) {\n      if (sheetInfo.key === dependentSheet) {\n        const formulas = this.formulaEngine.exportFormulas(sheetInfo.key);\n\n        for (const [cellRef, formula] of Object.entries(formulas)) {\n          if (formula.includes(`${precedentSheet}!`)) {\n            const cell = this.parseA1Notation(cellRef);\n            cells.push({ sheet: dependentSheet, row: cell.row, col: cell.col });\n          }\n        }\n      }\n    }\n\n    return cells;\n  }\n\n  /**\n   * 获取被指定sheet依赖的单元格\n   */\n  private getPrecedentCells(precedentSheet: string, dependentSheet: string): FormulaCell[] {\n    const cells: FormulaCell[] = [];\n\n    // 从dependentSheet的公式中提取引用precedentSheet的单元格\n    const formulas = this.formulaEngine.exportFormulas(dependentSheet);\n\n    for (const formula of Object.values(formulas)) {\n      if (formula.includes(`${precedentSheet}!`)) {\n        const targetCells = this.extractTargetCells(formula, precedentSheet);\n        cells.push(...targetCells);\n      }\n    }\n\n    return cells;\n  }\n\n  /**\n   * 当目标sheet数据变化时，更新依赖的公式\n   */\n  async updateCrossSheetReferences(targetSheet: string, changedCells: FormulaCell[]): Promise<void> {\n    const dependentSheets = this.reverseCrossSheetDependencies.get(targetSheet);\n\n    if (!dependentSheets || dependentSheets.size === 0) {\n      return;\n    }\n\n    // 收集所有需要重新计算的公式单元格\n    const cellsToRecalculate: FormulaCell[] = [];\n\n    for (const dependentSheet of dependentSheets) {\n      const formulas = this.formulaEngine.exportFormulas(dependentSheet);\n\n      for (const [cellRef, formula] of Object.entries(formulas)) {\n        // 检查公式是否引用了任何变化的单元格\n        if (this.formulaReferencesCells(formula, targetSheet, changedCells)) {\n          const cell = this.parseA1Notation(cellRef);\n          cellsToRecalculate.push({ sheet: dependentSheet, row: cell.row, col: cell.col });\n        }\n      }\n    }\n\n    // 重新计算所有受影响的公式\n    for (const cell of cellsToRecalculate) {\n      await this.recalculateFormula(cell);\n    }\n  }\n\n  /**\n   * 检查公式是否引用了指定的单元格\n   */\n  private formulaReferencesCells(formula: string, targetSheet: string, targetCells: FormulaCell[]): boolean {\n    const referencedCells = this.extractTargetCells(formula, targetSheet);\n\n    return referencedCells.some(refCell =>\n      targetCells.some(\n        targetCell =>\n          refCell.sheet === targetCell.sheet && refCell.row === targetCell.row && refCell.col === targetCell.col\n      )\n    );\n  }\n\n  /**\n   * 重新计算公式单元格\n   */\n  private async recalculateFormula(cell: FormulaCell): Promise<void> {\n    try {\n      const formula = this.formulaEngine.getCellFormula(cell);\n      if (formula) {\n        const result = this.formulaEngine.calculateFormula(formula);\n\n        // 更新缓存\n        const cacheKey = this.getCacheKey(cell);\n        this.calculationCache.set(cacheKey, {\n          value: result.value,\n          timestamp: Date.now()\n        });\n\n        // 触发重新计算依赖\n        this.recalculateDependents(cell);\n      }\n    } catch (error) {\n      console.error(`Failed to recalculate formula at ${cell.sheet}!${this.getA1Notation(cell.row, cell.col)}:`, error);\n    }\n  }\n\n  /**\n   * 重新计算依赖的公式\n   */\n  private recalculateDependents(cell: FormulaCell): void {\n    const dependents = this.formulaEngine.getCellDependents(cell);\n\n    for (const dependent of dependents) {\n      // 递归重新计算\n      this.recalculateFormula(dependent);\n    }\n  }\n\n  /**\n   * 验证跨sheet引用的有效性\n   */\n  validateCrossSheetReferences(sheet: string): { valid: boolean; errors: string[] } {\n    const errors: string[] = [];\n    const formulas = this.formulaEngine.exportFormulas(sheet);\n\n    for (const [cellRef, formula] of Object.entries(formulas)) {\n      const targetSheets = this.extractTargetSheets(formula);\n\n      for (const targetSheet of targetSheets) {\n        if (!this.formulaEngine.getAllSheets().some(s => s.key === targetSheet)) {\n          errors.push(`Invalid sheet reference in ${cellRef}: ${targetSheet}`);\n          continue;\n        }\n\n        const targetCells = this.extractTargetCells(formula, targetSheet);\n        for (const targetCell of targetCells) {\n          const cellValue = this.formulaEngine.getCellValue(targetCell);\n          if (cellValue.error) {\n            errors.push(\n              `Invalid cell reference in ${cellRef}: ${targetSheet}!${this.getA1Notation(\n                targetCell.row,\n                targetCell.col\n              )}`\n            );\n          }\n        }\n      }\n    }\n\n    return {\n      valid: errors.length === 0,\n      errors\n    };\n  }\n\n  /**\n   * 获取缓存的计算结果\n   */\n  getCachedValue(cell: FormulaCell): any {\n    const cacheKey = this.getCacheKey(cell);\n    const cached = this.calculationCache.get(cacheKey);\n\n    if (cached && Date.now() - cached.timestamp < this.CACHE_TTL) {\n      return cached.value;\n    }\n\n    return null;\n  }\n\n  /**\n   * 清除缓存\n   */\n  clearCache(): void {\n    this.calculationCache.clear();\n  }\n\n  /**\n   * 清除指定sheet的依赖关系\n   */\n  clearSheetDependencies(sheet: string): void {\n    // 清除正向依赖\n    this.crossSheetDependencies.delete(sheet);\n\n    // 清除反向依赖\n    for (const [targetSheet, sourceSheets] of this.reverseCrossSheetDependencies.entries()) {\n      sourceSheets.delete(sheet);\n      if (sourceSheets.size === 0) {\n        this.reverseCrossSheetDependencies.delete(targetSheet);\n      }\n    }\n\n    // 清除相关缓存\n    for (const [cacheKey] of this.calculationCache.entries()) {\n      if (cacheKey.startsWith(`${sheet}!`)) {\n        this.calculationCache.delete(cacheKey);\n      }\n    }\n  }\n\n  /**\n   * 工具方法：A1表示法解析\n   */\n  private parseA1Notation(a1Notation: string): { row: number; col: number } {\n    const match = a1Notation.match(/^([A-Z]+)([0-9]+)$/);\n    if (!match) {\n      throw new Error(`Invalid cell reference: ${a1Notation}`);\n    }\n\n    const colLetters = match[1];\n    const rowNumber = parseInt(match[2], 10);\n\n    let col = 0;\n    for (let i = 0; i < colLetters.length; i++) {\n      col = col * 26 + (colLetters.charCodeAt(i) - 65);\n    }\n\n    return { row: rowNumber - 1, col };\n  }\n\n  /**\n   * 工具方法：A1表示法生成\n   */\n  private getA1Notation(row: number, col: number): string {\n    let colStr = '';\n    let tempCol = col;\n\n    do {\n      colStr = String.fromCharCode(65 + (tempCol % 26)) + colStr;\n      tempCol = Math.floor(tempCol / 26) - 1;\n    } while (tempCol >= 0);\n\n    return `${colStr}${row + 1}`;\n  }\n\n  /**\n   * 工具方法：缓存键生成\n   */\n  private getCacheKey(cell: FormulaCell): string {\n    return `${cell.sheet}!${this.getA1Notation(cell.row, cell.col)}`;\n  }\n\n  /**\n   * 销毁管理器\n   */\n  destroy(): void {\n    this.clearCache();\n    this.crossSheetDependencies.clear();\n    this.reverseCrossSheetDependencies.clear();\n  }\n}\n"]}

package/cjs/formula/cross-sheet-formula-validator.d.ts

@@ -0,0 +1,56 @@
+import type { FormulaCell } from '../ts-types/formula';
+import type { FormulaEngine } from './formula-engine';
+import type { CrossSheetFormulaManager } from './cross-sheet-formula-manager';
+export interface ValidationError {
+    type: 'INVALID_SHEET' | 'INVALID_CELL' | 'CIRCULAR_REFERENCE' | 'MISSING_REFERENCE';
+    message: string;
+    sheet: string;
+    cell: FormulaCell;
+    target?: string;
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+    warnings: string[];
+}
+export interface ValidationOptions {
+    checkCircularReferences: boolean;
+    checkMissingReferences: boolean;
+    checkCellBounds: boolean;
+    maxRecursionDepth: number;
+}
+export declare class CrossSheetFormulaValidator {
+    private formulaEngine;
+    private crossSheetManager;
+    private sheetManager;
+    private validationCache;
+    private readonly CACHE_TTL;
+    private defaultOptions;
+    constructor(formulaEngine: FormulaEngine, crossSheetManager: CrossSheetFormulaManager, sheetManager?: {
+        getAllSheets: () => Array<{
+            sheetKey: string;
+            sheetTitle: string;
+        }>;
+    });
+    validateSheet(sheet: string, options?: Partial<ValidationOptions>): ValidationResult;
+    private validateFormula;
+    private extractCrossSheetReferences;
+    private validateCellReferences;
+    private checkCircularReferences;
+    private checkMissingReferences;
+    validateAllSheets(options?: Partial<ValidationOptions>): Map<string, ValidationResult>;
+    validateFormulaSyntax(formula: string): {
+        valid: boolean;
+        error?: string;
+    };
+    private validateExpressionStructure;
+    private isValidSheetName;
+    private isValidCellReference;
+    private isValidSheet;
+    private parseA1Notation;
+    private getA1Notation;
+    private getCacheKey;
+    private getCacheTimestamp;
+    clearCache(): void;
+    destroy(): void;
+}