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

package/es/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/es/formula/cross-sheet-formula-manager.js

@@ -0,0 +1,227 @@
+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());
+    }));
+};
+
+export 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();
+    }
+}
+//# sourceMappingURL=cross-sheet-formula-manager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/formula/cross-sheet-formula-manager.ts"],"names":[],"mappings":";;;;;;;;;AAuBA,MAAM,OAAO,wBAAwB;IAcnC,YACE,aAA4B,EAC5B,YAAsF;QAXhF,2BAAsB,GAA6B,IAAI,GAAG,EAAE,CAAC;QAG7D,kCAA6B,GAA6B,IAAI,GAAG,EAAE,CAAC;QAGpE,qBAAgB,GAAmD,IAAI,GAAG,EAAE,CAAC;QACpE,cAAS,GAAG,IAAI,CAAC;QAMhC,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;IAKD,2BAA2B,CAAC,OAAe,EAAE,UAAuB;QAClE,MAAM,UAAU,GAA0B,EAAE,CAAC;QAC7C,MAAM,YAAY,GAAG,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAEvD,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE;YACtC,MAAM,WAAW,GAAG,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;YAClE,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE;gBAC1B,UAAU,CAAC,IAAI,CAAC;oBACd,WAAW,EAAE,UAAU,CAAC,KAAK;oBAC7B,WAAW;oBACX,UAAU;oBACV,WAAW;oBACX,OAAO;iBACR,CAAC,CAAC;gBAGH,IAAI,CAAC,0BAA0B,CAAC,UAAU,CAAC,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;aACzF;SACF;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;IAMO,YAAY,CAAC,SAAiB;QAEpC,IAAI,IAAI,CAAC,YAAY,EAAE;YACrB,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,YAAY,EAAE,CAAC;YACnD,OAAO,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,WAAW,EAAE,KAAK,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC;SAC5F;QAGD,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,CAAC,YAAY,EAAE,CAAC;QACpD,OAAO,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC;IACxF,CAAC;IAMO,mBAAmB,CAAC,OAAe;QACzC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;QAMjC,MAAM,kBAAkB,GAAG,gBAAgB,CAAC;QAC5C,MAAM,oBAAoB,GAAG,2BAA2B,CAAC;QAEzD,IAAI,KAA6B,CAAC;QAClC,OAAO,CAAC,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE;YAC1D,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YAC3B,IAAI,SAAS,IAAI,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,EAAE;gBAC7C,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;aACvB;SACF;QACD,OAAO,CAAC,KAAK,GAAG,oBAAoB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE;YAC5D,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YAC3B,IAAI,SAAS,IAAI,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,EAAE;gBAC7C,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;aACvB;SACF;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAKO,kBAAkB,CAAC,OAAe,EAAE,WAAmB;QAC7D,MAAM,KAAK,GAAkB,EAAE,CAAC;QAGhC,MAAM,gBAAgB,GAAG,WAAW,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;QAC5E,MAAM,UAAU,GAAG,MAAM,CAAC;QAM1B,MAAM,WAAW,GAAG,IAAI,MAAM,CAC5B,KAAK,gBAAgB,KAAK,UAAU,gBAAgB;YAClD,oBAAoB,gBAAgB,KAAK,UAAU,oBAAoB,EACzE,GAAG,CACJ,CAAC;QACF,IAAI,KAAK,CAAC;QAEV,OAAO,CAAC,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE;YACnD,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE;gBAEZ,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBACjD,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBAG/C,KAAK,IAAI,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,EAAE;oBACvG,KAAK,IAAI,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,EAAE;wBACvG,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;qBAC9C;iBACF;aACF;iBAAM;gBAEL,MAAM,IAAI,GAAG,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC5C,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;aAClE;SACF;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAKO,0BAA0B,CAChC,WAAmB,EACnB,WAAmB,EACnB,WAAwB,EACxB,YAA2B;QAG3B,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE;YACjD,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;SACzD;QACD,MAAM,UAAU,GAAG,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAChE,IAAI,UAAU,EAAE;YACd,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;SAC7B;QAGD,IAAI,CAAC,IAAI,CAAC,6BAA6B,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE;YACxD,IAAI,CAAC,6BAA6B,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;SAChE;QACD,MAAM,UAAU,GAAG,IAAI,CAAC,6BAA6B,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACvE,IAAI,UAAU,EAAE;YACd,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;SAC7B;IACH,CAAC;IAKD,yBAAyB,CAAC,KAAa;QACrC,MAAM,YAAY,GAA2B,EAAE,CAAC;QAChD,MAAM,YAAY,GAAG,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAE5D,IAAI,YAAY,EAAE;YAChB,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE;gBACtC,MAAM,cAAc,GAAG,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;gBAClE,MAAM,cAAc,GAAG,IAAI,CAAC,iBAAiB,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;gBAElE,YAAY,CAAC,IAAI,CAAC;oBAChB,cAAc,EAAE,KAAK;oBACrB,cAAc,EAAE,WAAW;oBAC3B,cAAc;oBACd,cAAc;iBACf,CAAC,CAAC;aACJ;SACF;QAED,OAAO,YAAY,CAAC;IACtB,CAAC;IAKO,iBAAiB,CAAC,cAAsB,EAAE,cAAsB;QACtE,MAAM,KAAK,GAAkB,EAAE,CAAC;QAGhC,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,CAAC,YAAY,EAAE,CAAC;QACpD,KAAK,MAAM,SAAS,IAAI,SAAS,EAAE;YACjC,IAAI,SAAS,CAAC,GAAG,KAAK,cAAc,EAAE;gBACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,cAAc,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;gBAElE,KAAK,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;oBACzD,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,cAAc,GAAG,CAAC,EAAE;wBAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;wBAC3C,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;qBACrE;iBACF;aACF;SACF;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAKO,iBAAiB,CAAC,cAAsB,EAAE,cAAsB;QACtE,MAAM,KAAK,GAAkB,EAAE,CAAC;QAGhC,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC;QAEnE,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE;YAC7C,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,cAAc,GAAG,CAAC,EAAE;gBAC1C,MAAM,WAAW,GAAG,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;gBACrE,KAAK,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC;aAC5B;SACF;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAKK,0BAA0B,CAAC,WAAmB,EAAE,YAA2B;;YAC/E,MAAM,eAAe,GAAG,IAAI,CAAC,6BAA6B,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YAE5E,IAAI,CAAC,eAAe,IAAI,eAAe,CAAC,IAAI,KAAK,CAAC,EAAE;gBAClD,OAAO;aACR;YAGD,MAAM,kBAAkB,GAAkB,EAAE,CAAC;YAE7C,KAAK,MAAM,cAAc,IAAI,eAAe,EAAE;gBAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC;gBAEnE,KAAK,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;oBAEzD,IAAI,IAAI,CAAC,sBAAsB,CAAC,OAAO,EAAE,WAAW,EAAE,YAAY,CAAC,EAAE;wBACnE,MAAM,IAAI,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;wBAC3C,kBAAkB,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;qBAClF;iBACF;aACF;YAGD,KAAK,MAAM,IAAI,IAAI,kBAAkB,EAAE;gBACrC,MAAM,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;aACrC;QACH,CAAC;KAAA;IAKO,sBAAsB,CAAC,OAAe,EAAE,WAAmB,EAAE,WAA0B;QAC7F,MAAM,eAAe,GAAG,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAEtE,OAAO,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CACpC,WAAW,CAAC,IAAI,CACd,UAAU,CAAC,EAAE,CACX,OAAO,CAAC,KAAK,KAAK,UAAU,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,KAAK,UAAU,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,KAAK,UAAU,CAAC,GAAG,CACzG,CACF,CAAC;IACJ,CAAC;IAKa,kBAAkB,CAAC,IAAiB;;YAChD,IAAI;gBACF,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;gBACxD,IAAI,OAAO,EAAE;oBACX,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;oBAG5D,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;oBACxC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,QAAQ,EAAE;wBAClC,KAAK,EAAE,MAAM,CAAC,KAAK;wBACnB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;qBACtB,CAAC,CAAC;oBAGH,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC;iBAClC;aACF;YAAC,OAAO,KAAK,EAAE;gBACd,OAAO,CAAC,KAAK,CAAC,oCAAoC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;aACnH;QACH,CAAC;KAAA;IAKO,qBAAqB,CAAC,IAAiB;QAC7C,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAE9D,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE;YAElC,IAAI,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;SACpC;IACH,CAAC;IAKD,4BAA4B,CAAC,KAAa;QACxC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAE1D,KAAK,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;YACzD,MAAM,YAAY,GAAG,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;YAEvD,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE;gBACtC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,WAAW,CAAC,EAAE;oBACvE,MAAM,CAAC,IAAI,CAAC,8BAA8B,OAAO,KAAK,WAAW,EAAE,CAAC,CAAC;oBACrE,SAAS;iBACV;gBAED,MAAM,WAAW,GAAG,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;gBAClE,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE;oBACpC,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;oBAC9D,IAAI,SAAS,CAAC,KAAK,EAAE;wBACnB,MAAM,CAAC,IAAI,CACT,6BAA6B,OAAO,KAAK,WAAW,IAAI,IAAI,CAAC,aAAa,CACxE,UAAU,CAAC,GAAG,EACd,UAAU,CAAC,GAAG,CACf,EAAE,CACJ,CAAC;qBACH;iBACF;aACF;SACF;QAED,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;YAC1B,MAAM;SACP,CAAC;IACJ,CAAC;IAKD,cAAc,CAAC,IAAiB;QAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAEnD,IAAI,MAAM,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE;YAC5D,OAAO,MAAM,CAAC,KAAK,CAAC;SACrB;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAKD,UAAU;QACR,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC;IAChC,CAAC;IAKD,sBAAsB,CAAC,KAAa;QAElC,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAG1C,KAAK,MAAM,CAAC,WAAW,EAAE,YAAY,CAAC,IAAI,IAAI,CAAC,6BAA6B,CAAC,OAAO,EAAE,EAAE;YACtF,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC3B,IAAI,YAAY,CAAC,IAAI,KAAK,CAAC,EAAE;gBAC3B,IAAI,CAAC,6BAA6B,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;aACxD;SACF;QAGD,KAAK,MAAM,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,EAAE;YACxD,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,KAAK,GAAG,CAAC,EAAE;gBACpC,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;aACxC;SACF;IACH,CAAC;IAKO,eAAe,CAAC,UAAkB;QACxC,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACrD,IAAI,CAAC,KAAK,EAAE;YACV,MAAM,IAAI,KAAK,CAAC,2BAA2B,UAAU,EAAE,CAAC,CAAC;SAC1D;QAED,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAC5B,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAEzC,IAAI,GAAG,GAAG,CAAC,CAAC;QACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;YAC1C,GAAG,GAAG,GAAG,GAAG,EAAE,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;SAClD;QAED,OAAO,EAAE,GAAG,EAAE,SAAS,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC;IACrC,CAAC;IAKO,aAAa,CAAC,GAAW,EAAE,GAAW;QAC5C,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,OAAO,GAAG,GAAG,CAAC;QAElB,GAAG;YACD,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,EAAE,GAAG,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC;YAC3D,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;SACxC,QAAQ,OAAO,IAAI,CAAC,EAAE;QAEvB,OAAO,GAAG,MAAM,GAAG,GAAG,GAAG,CAAC,EAAE,CAAC;IAC/B,CAAC;IAKO,WAAW,CAAC,IAAiB;QACnC,OAAO,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;IACnE,CAAC;IAKD,OAAO;QACL,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,IAAI,CAAC,sBAAsB,CAAC,KAAK,EAAE,CAAC;QACpC,IAAI,CAAC,6BAA6B,CAAC,KAAK,EAAE,CAAC;IAC7C,CAAC;CACF","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/es/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;
+}

package/es/formula/cross-sheet-formula-validator.js

@@ -0,0 +1,263 @@
+export class CrossSheetFormulaValidator {
+    constructor(formulaEngine, crossSheetManager, sheetManager) {
+        this.validationCache = new Map, this.CACHE_TTL = 5e3, this.defaultOptions = {
+            checkCircularReferences: !0,
+            checkMissingReferences: !0,
+            checkCellBounds: !0,
+            maxRecursionDepth: 100
+        }, this.formulaEngine = formulaEngine, this.crossSheetManager = crossSheetManager, 
+        this.sheetManager = sheetManager;
+    }
+    validateSheet(sheet, options) {
+        const validationOptions = Object.assign(Object.assign({}, this.defaultOptions), options), cacheKey = this.getCacheKey(sheet, validationOptions), cached = this.validationCache.get(cacheKey);
+        if (cached && Date.now() - this.getCacheTimestamp(cacheKey) < this.CACHE_TTL) return cached;
+        const errors = [];
+        try {
+            const formulas = this.formulaEngine.exportFormulas(sheet);
+            for (const [cellRef, formula] of Object.entries(formulas)) {
+                const cell = this.parseA1Notation(cellRef), cellWithSheet = {
+                    sheet: sheet,
+                    row: cell.row,
+                    col: cell.col
+                }, formulaErrors = this.validateFormula(formula, cellWithSheet, validationOptions);
+                errors.push(...formulaErrors);
+            }
+            if (validationOptions.checkCircularReferences) {
+                const circularErrors = this.checkCircularReferences(sheet);
+                errors.push(...circularErrors);
+            }
+            if (validationOptions.checkMissingReferences) {
+                const missingErrors = this.checkMissingReferences(sheet);
+                errors.push(...missingErrors);
+            }
+        } catch (error) {
+            errors.push({
+                type: "MISSING_REFERENCE",
+                message: `Validation failed: ${error instanceof Error ? error.message : "Unknown error"}`,
+                sheet: sheet,
+                cell: {
+                    sheet: sheet,
+                    row: 0,
+                    col: 0
+                }
+            });
+        }
+        const result = {
+            valid: 0 === errors.length,
+            errors: errors,
+            warnings: []
+        };
+        return this.validationCache.set(cacheKey, result), result;
+    }
+    validateFormula(formula, cell, options) {
+        const errors = [];
+        if (!formula.startsWith("=")) return errors;
+        try {
+            const crossSheetRefs = this.extractCrossSheetReferences(formula);
+            for (const ref of crossSheetRefs) if (this.isValidSheet(ref.targetSheet)) {
+                if (options.checkCellBounds) {
+                    const cellErrors = this.validateCellReferences(ref, cell);
+                    errors.push(...cellErrors);
+                }
+            } else errors.push({
+                type: "INVALID_SHEET",
+                message: `Invalid sheet reference: ${ref.targetSheet}`,
+                sheet: cell.sheet,
+                cell: cell,
+                target: ref.targetSheet
+            });
+        } catch (error) {
+            errors.push({
+                type: "MISSING_REFERENCE",
+                message: `Formula validation failed: ${error instanceof Error ? error.message : "Unknown error"}`,
+                sheet: cell.sheet,
+                cell: cell
+            });
+        }
+        return errors;
+    }
+    extractCrossSheetReferences(formula) {
+        const references = [], sheetRefPattern = /'?([^'!！]+)'?[!！]([A-Z]+[0-9]+)(?:\s*:\s*(?:'?([^'!！]+)'?[!！])?([A-Z]+[0-9]+))?/g;
+        let match;
+        for (;null !== (match = sheetRefPattern.exec(formula)); ) {
+            const targetSheet = match[1], startRef = match[2], endSheetMaybe = match[3], endRef = match[4], targetCells = [];
+            if (endRef) {
+                if (endSheetMaybe && endSheetMaybe.toLowerCase() !== targetSheet.toLowerCase()) continue;
+                const startCell = this.parseA1Notation(startRef), endCell = this.parseA1Notation(endRef);
+                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++) targetCells.push({
+                    sheet: targetSheet,
+                    row: row,
+                    col: col
+                });
+            } else {
+                const cell = this.parseA1Notation(startRef);
+                targetCells.push({
+                    sheet: targetSheet,
+                    row: cell.row,
+                    col: cell.col
+                });
+            }
+            references.push({
+                targetSheet: targetSheet,
+                targetCells: targetCells
+            });
+        }
+        return references;
+    }
+    validateCellReferences(ref, sourceCell) {
+        const errors = [];
+        for (const targetCell of ref.targetCells) try {
+            const cellValue = this.formulaEngine.getCellValue(targetCell);
+            if (cellValue.error) {
+                const targetRef = `${ref.targetSheet}!${this.getA1Notation(targetCell.row, targetCell.col)}`;
+                errors.push({
+                    type: "INVALID_CELL",
+                    message: `Invalid cell reference: ${targetRef} - ${cellValue.error}`,
+                    sheet: sourceCell.sheet,
+                    cell: sourceCell,
+                    target: targetRef
+                });
+            }
+        } catch (error) {
+            errors.push({
+                type: "INVALID_CELL",
+                message: `Cell validation failed: ${ref.targetSheet}!${this.getA1Notation(targetCell.row, targetCell.col)}`,
+                sheet: sourceCell.sheet,
+                cell: sourceCell,
+                target: `${ref.targetSheet}!${this.getA1Notation(targetCell.row, targetCell.col)}`
+            });
+        }
+        return errors;
+    }
+    checkCircularReferences(sheet) {
+        const errors = [], visited = new Set, recursionStack = new Set, dfs = (currentSheet, path) => {
+            const key = currentSheet;
+            if (recursionStack.has(key)) {
+                const cycleStart = path.indexOf(currentSheet), cycle = path.slice(cycleStart).concat([ currentSheet ]);
+                return errors.push({
+                    type: "CIRCULAR_REFERENCE",
+                    message: `Circular reference detected: ${cycle.join(" -> ")}`,
+                    sheet: currentSheet,
+                    cell: {
+                        sheet: currentSheet,
+                        row: 0,
+                        col: 0
+                    }
+                }), !0;
+            }
+            if (visited.has(key)) return !1;
+            visited.add(key), recursionStack.add(key);
+            const dependencies = this.crossSheetManager.getCrossSheetDependencies(currentSheet);
+            for (const dep of dependencies) if (dfs(dep.precedentSheet, [ ...path, currentSheet ])) return !0;
+            return recursionStack.delete(key), !1;
+        };
+        return dfs(sheet, []), errors;
+    }
+    checkMissingReferences(sheet) {
+        const errors = [], allSheets = this.formulaEngine.getAllSheets(), existingSheets = new Set(allSheets.map((s => s.key))), formulas = this.formulaEngine.exportFormulas(sheet);
+        for (const [cellRef, formula] of Object.entries(formulas)) {
+            const cell = this.parseA1Notation(cellRef), cellWithSheet = {
+                sheet: sheet,
+                row: cell.row,
+                col: cell.col
+            }, crossSheetRefs = this.extractCrossSheetReferences(formula);
+            for (const ref of crossSheetRefs) existingSheets.has(ref.targetSheet) || errors.push({
+                type: "MISSING_REFERENCE",
+                message: `Missing sheet reference: ${ref.targetSheet}`,
+                sheet: sheet,
+                cell: cellWithSheet,
+                target: ref.targetSheet
+            });
+        }
+        return errors;
+    }
+    validateAllSheets(options) {
+        const results = new Map, allSheets = this.formulaEngine.getAllSheets();
+        for (const sheetInfo of allSheets) {
+            const result = this.validateSheet(sheetInfo.key, options);
+            results.set(sheetInfo.key, result);
+        }
+        return results;
+    }
+    validateFormulaSyntax(formula) {
+        try {
+            if (!formula.startsWith("=")) return {
+                valid: !0
+            };
+            const expression = formula.substring(1).trim();
+            this.validateExpressionStructure(expression);
+            const crossSheetPattern = /([A-Za-z0-9_一-龥]+)[！!]([A-Z]+[0-9]+(?::[A-Z]+[0-9]+)?)/g;
+            let match;
+            for (;null !== (match = crossSheetPattern.exec(expression)); ) {
+                const sheetName = match[1], cellRef = match[2];
+                if (!this.isValidSheetName(sheetName)) return {
+                    valid: !1,
+                    error: `Invalid sheet name: ${sheetName}`
+                };
+                if (!this.isValidSheet(sheetName)) return {
+                    valid: !1,
+                    error: `Invalid sheet name: ${sheetName}`
+                };
+                if (!this.isValidCellReference(cellRef)) return {
+                    valid: !1,
+                    error: `Invalid cell reference: ${cellRef}`
+                };
+            }
+            return {
+                valid: !0
+            };
+        } catch (error) {
+            return {
+                valid: !1,
+                error: error instanceof Error ? error.message : "Syntax validation failed"
+            };
+        }
+    }
+    validateExpressionStructure(expression) {
+        if ((expression.match(/\(/g) || []).length !== (expression.match(/\)/g) || []).length) throw new Error("Unmatched parentheses");
+        if ((expression.match(/"/g) || []).length % 2 != 0) throw new Error("Unmatched quotes");
+    }
+    isValidSheetName(sheetName) {
+        return /^[A-Za-z_一-龥][A-Za-z0-9_一-龥]*$/.test(sheetName);
+    }
+    isValidCellReference(cellRef) {
+        return /^[A-Z]+[0-9]+$/.test(cellRef) || /^[A-Z]+[0-9]+:[A-Z]+[0-9]+$/.test(cellRef);
+    }
+    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()));
+    }
+    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(sheet, options) {
+        return `${sheet}_${JSON.stringify(options)}`;
+    }
+    getCacheTimestamp(_cacheKey) {
+        return Date.now();
+    }
+    clearCache() {
+        this.validationCache.clear();
+    }
+    destroy() {
+        this.clearCache();
+    }
+}
+//# sourceMappingURL=cross-sheet-formula-validator.js.map