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

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

@@ -0,0 +1,271 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+    value: !0
+}), exports.CrossSheetFormulaValidator = void 0;
+
+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();
+    }
+}
+
+exports.CrossSheetFormulaValidator = CrossSheetFormulaValidator;
+//# sourceMappingURL=cross-sheet-formula-validator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/formula/cross-sheet-formula-validator.ts"],"names":[],"mappings":";;;AA8BA,MAAa,0BAA0B;IAerC,YACE,aAA4B,EAC5B,iBAA2C,EAC3C,YAAsF;QAbhF,oBAAe,GAAkC,IAAI,GAAG,EAAE,CAAC;QAClD,cAAS,GAAG,IAAI,CAAC;QAE1B,mBAAc,GAAsB;YAC1C,uBAAuB,EAAE,IAAI;YAC7B,sBAAsB,EAAE,IAAI;YAC5B,eAAe,EAAE,IAAI;YACrB,iBAAiB,EAAE,GAAG;SACvB,CAAC;QAOA,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;QAC3C,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;IAKD,aAAa,CAAC,KAAa,EAAE,OAAoC;QAC/D,MAAM,iBAAiB,mCAAQ,IAAI,CAAC,cAAc,GAAK,OAAO,CAAE,CAAC;QACjE,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC;QAG5D,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAClD,IAAI,MAAM,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,SAAS,EAAE;YAC5E,OAAO,MAAM,CAAC;SACf;QAED,MAAM,MAAM,GAAsB,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAa,EAAE,CAAC;QAE9B,IAAI;YAEF,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;YAG1D,KAAK,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;gBACzD,MAAM,IAAI,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;gBAC3C,MAAM,aAAa,GAAgB,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC;gBAE3E,MAAM,aAAa,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,aAAa,EAAE,iBAAiB,CAAC,CAAC;gBACtF,MAAM,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,CAAC;aAC/B;YAGD,IAAI,iBAAiB,CAAC,uBAAuB,EAAE;gBAC7C,MAAM,cAAc,GAAG,IAAI,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC;gBAC3D,MAAM,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,CAAC;aAChC;YAGD,IAAI,iBAAiB,CAAC,sBAAsB,EAAE;gBAC5C,MAAM,aAAa,GAAG,IAAI,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC;gBACzD,MAAM,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,CAAC;aAC/B;SACF;QAAC,OAAO,KAAK,EAAE;YACd,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,mBAAmB;gBACzB,OAAO,EAAE,sBAAsB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE;gBACzF,KAAK;gBACL,IAAI,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE;aAChC,CAAC,CAAC;SACJ;QAED,MAAM,MAAM,GAAqB;YAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;YAC1B,MAAM;YACN,QAAQ;SACT,CAAC;QAGF,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAE3C,OAAO,MAAM,CAAC;IAChB,CAAC;IAKO,eAAe,CAAC,OAAe,EAAE,IAAiB,EAAE,OAA0B;QACpF,MAAM,MAAM,GAAsB,EAAE,CAAC;QAErC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE;YAC5B,OAAO,MAAM,CAAC;SACf;QAED,IAAI;YAEF,MAAM,cAAc,GAAG,IAAI,CAAC,2BAA2B,CAAC,OAAO,CAAC,CAAC;YAEjE,KAAK,MAAM,GAAG,IAAI,cAAc,EAAE;gBAEhC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE;oBACvC,MAAM,CAAC,IAAI,CAAC;wBACV,IAAI,EAAE,eAAe;wBACrB,OAAO,EAAE,4BAA4B,GAAG,CAAC,WAAW,EAAE;wBACtD,KAAK,EAAE,IAAI,CAAC,KAAK;wBACjB,IAAI;wBACJ,MAAM,EAAE,GAAG,CAAC,WAAW;qBACxB,CAAC,CAAC;oBACH,SAAS;iBACV;gBAGD,IAAI,OAAO,CAAC,eAAe,EAAE;oBAC3B,MAAM,UAAU,GAAG,IAAI,CAAC,sBAAsB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;oBAC1D,MAAM,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC;iBAC5B;aACF;SACF;QAAC,OAAO,KAAK,EAAE;YACd,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,mBAAmB;gBACzB,OAAO,EAAE,8BAA8B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE;gBACjG,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,IAAI;aACL,CAAC,CAAC;SACJ;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAKO,2BAA2B,CAAC,OAAe;QAIjD,MAAM,UAAU,GAGX,EAAE,CAAC;QAQR,MAAM,eAAe,GAAG,kFAAkF,CAAC;QAC3G,IAAI,KAA6B,CAAC;QAElC,OAAO,CAAC,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE;YACvD,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YAC7B,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YAC1B,MAAM,aAAa,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YAC/B,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YAExB,MAAM,WAAW,GAAkB,EAAE,CAAC;YAEtC,IAAI,MAAM,EAAE;gBAGV,IAAI,aAAa,IAAI,aAAa,CAAC,WAAW,EAAE,KAAK,WAAW,CAAC,WAAW,EAAE,EAAE;oBAE9E,SAAS;iBACV;gBACD,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;gBACjD,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;gBAE7C,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,WAAW,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;qBACpD;iBACF;aACF;iBAAM;gBAEL,MAAM,IAAI,GAAG,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;gBAC5C,WAAW,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;aACxE;YAED,UAAU,CAAC,IAAI,CAAC;gBACd,WAAW;gBACX,WAAW;aACZ,CAAC,CAAC;SACJ;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;IAKO,sBAAsB,CAC5B,GAGC,EACD,UAAuB;QAEvB,MAAM,MAAM,GAAsB,EAAE,CAAC;QAErC,KAAK,MAAM,UAAU,IAAI,GAAG,CAAC,WAAW,EAAE;YACxC,IAAI;gBAEF,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;gBAE9D,IAAI,SAAS,CAAC,KAAK,EAAE;oBACnB,MAAM,SAAS,GAAG,GAAG,GAAG,CAAC,WAAW,IAAI,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,GAAG,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC7F,MAAM,CAAC,IAAI,CAAC;wBACV,IAAI,EAAE,cAAc;wBACpB,OAAO,EAAE,2BAA2B,SAAS,MAAM,SAAS,CAAC,KAAK,EAAE;wBACpE,KAAK,EAAE,UAAU,CAAC,KAAK;wBACvB,IAAI,EAAE,UAAU;wBAChB,MAAM,EAAE,SAAS;qBAClB,CAAC,CAAC;iBACJ;aACF;YAAC,OAAO,KAAK,EAAE;gBACd,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,cAAc;oBACpB,OAAO,EAAE,2BAA2B,GAAG,CAAC,WAAW,IAAI,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,GAAG,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE;oBAC3G,KAAK,EAAE,UAAU,CAAC,KAAK;oBACvB,IAAI,EAAE,UAAU;oBAChB,MAAM,EAAE,GAAG,GAAG,CAAC,WAAW,IAAI,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,GAAG,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE;iBACnF,CAAC,CAAC;aACJ;SACF;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAKO,uBAAuB,CAAC,KAAa;QAC3C,MAAM,MAAM,GAAsB,EAAE,CAAC;QACrC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAClC,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;QAEzC,MAAM,GAAG,GAAG,CAAC,YAAoB,EAAE,IAAc,EAAW,EAAE;YAC5D,MAAM,GAAG,GAAG,YAAY,CAAC;YAEzB,IAAI,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;gBAE3B,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;gBAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;gBAE5D,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,oBAAoB;oBAC1B,OAAO,EAAE,gCAAgC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE;oBAC7D,KAAK,EAAE,YAAY;oBACnB,IAAI,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE;iBAC9C,CAAC,CAAC;gBAEH,OAAO,IAAI,CAAC;aACb;YAED,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;gBACpB,OAAO,KAAK,CAAC;aACd;YAED,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACjB,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAExB,MAAM,YAAY,GAAG,IAAI,CAAC,iBAAiB,CAAC,yBAAyB,CAAC,YAAY,CAAC,CAAC;YAEpF,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE;gBAC9B,IAAI,GAAG,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC,GAAG,IAAI,EAAE,YAAY,CAAC,CAAC,EAAE;oBACpD,OAAO,IAAI,CAAC;iBACb;aACF;YAED,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC3B,OAAO,KAAK,CAAC;QACf,CAAC,CAAC;QAEF,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACf,OAAO,MAAM,CAAC;IAChB,CAAC;IAKO,sBAAsB,CAAC,KAAa;QAC1C,MAAM,MAAM,GAAsB,EAAE,CAAC;QACrC,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,CAAC,YAAY,EAAE,CAAC;QACpD,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAE1D,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,IAAI,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;YAC3C,MAAM,aAAa,GAAgB,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC;YAE3E,MAAM,cAAc,GAAG,IAAI,CAAC,2BAA2B,CAAC,OAAO,CAAC,CAAC;YAEjE,KAAK,MAAM,GAAG,IAAI,cAAc,EAAE;gBAChC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE;oBACxC,MAAM,CAAC,IAAI,CAAC;wBACV,IAAI,EAAE,mBAAmB;wBACzB,OAAO,EAAE,4BAA4B,GAAG,CAAC,WAAW,EAAE;wBACtD,KAAK;wBACL,IAAI,EAAE,aAAa;wBACnB,MAAM,EAAE,GAAG,CAAC,WAAW;qBACxB,CAAC,CAAC;iBACJ;aACF;SACF;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAKD,iBAAiB,CAAC,OAAoC;QACpD,MAAM,OAAO,GAAG,IAAI,GAAG,EAA4B,CAAC;QACpD,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,CAAC,YAAY,EAAE,CAAC;QAEpD,KAAK,MAAM,SAAS,IAAI,SAAS,EAAE;YACjC,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YAC1D,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;SACpC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAKD,qBAAqB,CAAC,OAAe;QACnC,IAAI;YACF,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE;gBAC5B,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;aACxB;YAED,MAAM,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAG/C,IAAI,CAAC,2BAA2B,CAAC,UAAU,CAAC,CAAC;YAG7C,MAAM,iBAAiB,GAAG,yDAAyD,CAAC;YACpF,IAAI,KAAK,CAAC;YAEV,OAAO,CAAC,KAAK,GAAG,iBAAiB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,KAAK,IAAI,EAAE;gBAC5D,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBAC3B,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBAGzB,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,EAAE;oBACrC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,uBAAuB,SAAS,EAAE,EAAE,CAAC;iBACpE;gBAGD,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,EAAE;oBACjC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,uBAAuB,SAAS,EAAE,EAAE,CAAC;iBACpE;gBAGD,IAAI,CAAC,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,EAAE;oBACvC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,2BAA2B,OAAO,EAAE,EAAE,CAAC;iBACtE;aACF;YAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;SACxB;QAAC,OAAO,KAAK,EAAE;YACd,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,0BAA0B;aAC3E,CAAC;SACH;IACH,CAAC;IAKO,2BAA2B,CAAC,UAAkB;QAEpD,MAAM,cAAc,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;QAC9D,MAAM,eAAe,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;QAE/D,IAAI,cAAc,KAAK,eAAe,EAAE;YACtC,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;SAC1C;QAGD,MAAM,gBAAgB,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;QAC/D,IAAI,gBAAgB,GAAG,CAAC,KAAK,CAAC,EAAE;YAC9B,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;SACrC;IACH,CAAC;IAKO,gBAAgB,CAAC,SAAiB;QAExC,MAAM,YAAY,GAAG,gCAAgC,CAAC;QACtD,OAAO,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACtC,CAAC;IAKO,oBAAoB,CAAC,OAAe;QAE1C,MAAM,iBAAiB,GAAG,gBAAgB,CAAC;QAC3C,MAAM,YAAY,GAAG,6BAA6B,CAAC;QAEnD,OAAO,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvE,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;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,KAAa,EAAE,OAA0B;QAC3D,OAAO,GAAG,KAAK,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;IAC/C,CAAC;IAKO,iBAAiB,CAAC,SAAiB;QAEzC,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC;IACpB,CAAC;IAKD,UAAU;QACR,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;IAC/B,CAAC;IAKD,OAAO;QACL,IAAI,CAAC,UAAU,EAAE,CAAC;IACpB,CAAC;CACF;AA5eD,gEA4eC","file":"cross-sheet-formula-validator.js","sourcesContent":["/**\n * 跨sheet公式验证器\n * 验证跨sheet引用的有效性和完整性\n */\n\nimport type { FormulaCell } from '../ts-types/formula';\nimport type { FormulaEngine } from './formula-engine';\nimport type { CrossSheetFormulaManager } from './cross-sheet-formula-manager';\n\nexport interface ValidationError {\n  type: 'INVALID_SHEET' | 'INVALID_CELL' | 'CIRCULAR_REFERENCE' | 'MISSING_REFERENCE';\n  message: string;\n  sheet: string;\n  cell: FormulaCell;\n  target?: string;\n}\n\nexport interface ValidationResult {\n  valid: boolean;\n  errors: ValidationError[];\n  warnings: string[];\n}\n\nexport interface ValidationOptions {\n  checkCircularReferences: boolean;\n  checkMissingReferences: boolean;\n  checkCellBounds: boolean;\n  maxRecursionDepth: number;\n}\n\nexport class CrossSheetFormulaValidator {\n  private formulaEngine: FormulaEngine;\n  private crossSheetManager: CrossSheetFormulaManager;\n  private sheetManager: { getAllSheets: () => Array<{ sheetKey: string; sheetTitle: string }> } | undefined; // SheetManager reference\n\n  private validationCache: Map<string, ValidationResult> = new Map();\n  private readonly CACHE_TTL = 5000; // 5秒缓存\n\n  private defaultOptions: ValidationOptions = {\n    checkCircularReferences: true,\n    checkMissingReferences: true,\n    checkCellBounds: true,\n    maxRecursionDepth: 100\n  };\n\n  constructor(\n    formulaEngine: FormulaEngine,\n    crossSheetManager: CrossSheetFormulaManager,\n    sheetManager?: { getAllSheets: () => Array<{ sheetKey: string; sheetTitle: string }> }\n  ) {\n    this.formulaEngine = formulaEngine;\n    this.crossSheetManager = crossSheetManager;\n    this.sheetManager = sheetManager;\n  }\n\n  /**\n   * 验证指定sheet的所有跨sheet公式\n   */\n  validateSheet(sheet: string, options?: Partial<ValidationOptions>): ValidationResult {\n    const validationOptions = { ...this.defaultOptions, ...options };\n    const cacheKey = this.getCacheKey(sheet, validationOptions);\n\n    // 检查缓存\n    const cached = this.validationCache.get(cacheKey);\n    if (cached && Date.now() - this.getCacheTimestamp(cacheKey) < this.CACHE_TTL) {\n      return cached;\n    }\n\n    const errors: ValidationError[] = [];\n    const warnings: string[] = [];\n\n    try {\n      // 获取sheet的所有公式\n      const formulas = this.formulaEngine.exportFormulas(sheet);\n\n      // 验证每个公式\n      for (const [cellRef, formula] of Object.entries(formulas)) {\n        const cell = this.parseA1Notation(cellRef);\n        const cellWithSheet: FormulaCell = { sheet, row: cell.row, col: cell.col };\n\n        const formulaErrors = this.validateFormula(formula, cellWithSheet, validationOptions);\n        errors.push(...formulaErrors);\n      }\n\n      // 检查循环依赖\n      if (validationOptions.checkCircularReferences) {\n        const circularErrors = this.checkCircularReferences(sheet);\n        errors.push(...circularErrors);\n      }\n\n      // 检查缺失的引用\n      if (validationOptions.checkMissingReferences) {\n        const missingErrors = this.checkMissingReferences(sheet);\n        errors.push(...missingErrors);\n      }\n    } catch (error) {\n      errors.push({\n        type: 'MISSING_REFERENCE',\n        message: `Validation failed: ${error instanceof Error ? error.message : 'Unknown error'}`,\n        sheet,\n        cell: { sheet, row: 0, col: 0 }\n      });\n    }\n\n    const result: ValidationResult = {\n      valid: errors.length === 0,\n      errors,\n      warnings\n    };\n\n    // 缓存结果\n    this.validationCache.set(cacheKey, result);\n\n    return result;\n  }\n\n  /**\n   * 验证单个公式\n   */\n  private validateFormula(formula: string, cell: FormulaCell, options: ValidationOptions): ValidationError[] {\n    const errors: ValidationError[] = [];\n\n    if (!formula.startsWith('=')) {\n      return errors;\n    }\n\n    try {\n      // 提取跨sheet引用\n      const crossSheetRefs = this.extractCrossSheetReferences(formula);\n\n      for (const ref of crossSheetRefs) {\n        // 验证sheet是否存在\n        if (!this.isValidSheet(ref.targetSheet)) {\n          errors.push({\n            type: 'INVALID_SHEET',\n            message: `Invalid sheet reference: ${ref.targetSheet}`,\n            sheet: cell.sheet,\n            cell,\n            target: ref.targetSheet\n          });\n          continue;\n        }\n\n        // 验证单元格是否存在\n        if (options.checkCellBounds) {\n          const cellErrors = this.validateCellReferences(ref, cell);\n          errors.push(...cellErrors);\n        }\n      }\n    } catch (error) {\n      errors.push({\n        type: 'MISSING_REFERENCE',\n        message: `Formula validation failed: ${error instanceof Error ? error.message : 'Unknown error'}`,\n        sheet: cell.sheet,\n        cell\n      });\n    }\n\n    return errors;\n  }\n\n  /**\n   * 提取跨sheet引用\n   */\n  private extractCrossSheetReferences(formula: string): Array<{\n    targetSheet: string;\n    targetCells: FormulaCell[];\n  }> {\n    const references: Array<{\n      targetSheet: string;\n      targetCells: FormulaCell[];\n    }> = [];\n\n    // 匹配带sheet前缀的引用，如：\n    // - Sheet1!A1\n    // - Sheet1!A1:B2\n    // - Sheet1!A1:Sheet1!B2\n    // - Sheet1！A1:Sheet1！B2\n    // - 'My Sheet'!A1:'My Sheet'!B2\n    const sheetRefPattern = /'?([^'!！]+)'?[!！]([A-Z]+[0-9]+)(?:\\s*:\\s*(?:'?([^'!！]+)'?[!！])?([A-Z]+[0-9]+))?/g;\n    let match: RegExpExecArray | null;\n\n    while ((match = sheetRefPattern.exec(formula)) !== null) {\n      const targetSheet = match[1];\n      const startRef = match[2];\n      const endSheetMaybe = match[3];\n      const endRef = match[4];\n\n      const targetCells: FormulaCell[] = [];\n\n      if (endRef) {\n        // 范围引用\n        // 若右侧带了sheet前缀，仅支持与左侧相同（否则为 3D 引用，当前不展开）\n        if (endSheetMaybe && endSheetMaybe.toLowerCase() !== targetSheet.toLowerCase()) {\n          // 3D 引用：Sheet1!A1:Sheet2!B2（当前不支持）\n          continue;\n        }\n        const startCell = this.parseA1Notation(startRef);\n        const endCell = this.parseA1Notation(endRef);\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            targetCells.push({ sheet: targetSheet, row, col });\n          }\n        }\n      } else {\n        // 单个单元格引用，如 A1\n        const cell = this.parseA1Notation(startRef);\n        targetCells.push({ sheet: targetSheet, row: cell.row, col: cell.col });\n      }\n\n      references.push({\n        targetSheet,\n        targetCells\n      });\n    }\n\n    return references;\n  }\n\n  /**\n   * 验证单元格引用\n   */\n  private validateCellReferences(\n    ref: {\n      targetSheet: string;\n      targetCells: FormulaCell[];\n    },\n    sourceCell: FormulaCell\n  ): ValidationError[] {\n    const errors: ValidationError[] = [];\n\n    for (const targetCell of ref.targetCells) {\n      try {\n        // 检查单元格是否有效\n        const cellValue = this.formulaEngine.getCellValue(targetCell);\n\n        if (cellValue.error) {\n          const targetRef = `${ref.targetSheet}!${this.getA1Notation(targetCell.row, targetCell.col)}`;\n          errors.push({\n            type: 'INVALID_CELL',\n            message: `Invalid cell reference: ${targetRef} - ${cellValue.error}`,\n            sheet: sourceCell.sheet,\n            cell: sourceCell,\n            target: targetRef\n          });\n        }\n      } catch (error) {\n        errors.push({\n          type: 'INVALID_CELL',\n          message: `Cell validation failed: ${ref.targetSheet}!${this.getA1Notation(targetCell.row, targetCell.col)}`,\n          sheet: sourceCell.sheet,\n          cell: sourceCell,\n          target: `${ref.targetSheet}!${this.getA1Notation(targetCell.row, targetCell.col)}`\n        });\n      }\n    }\n\n    return errors;\n  }\n\n  /**\n   * 检查循环依赖\n   */\n  private checkCircularReferences(sheet: string): ValidationError[] {\n    const errors: ValidationError[] = [];\n    const visited = new Set<string>();\n    const recursionStack = new Set<string>();\n\n    const dfs = (currentSheet: string, path: string[]): boolean => {\n      const key = currentSheet;\n\n      if (recursionStack.has(key)) {\n        // 发现循环依赖\n        const cycleStart = path.indexOf(currentSheet);\n        const cycle = path.slice(cycleStart).concat([currentSheet]);\n\n        errors.push({\n          type: 'CIRCULAR_REFERENCE',\n          message: `Circular reference detected: ${cycle.join(' -> ')}`,\n          sheet: currentSheet,\n          cell: { sheet: currentSheet, row: 0, col: 0 }\n        });\n\n        return true;\n      }\n\n      if (visited.has(key)) {\n        return false;\n      }\n\n      visited.add(key);\n      recursionStack.add(key);\n\n      const dependencies = this.crossSheetManager.getCrossSheetDependencies(currentSheet);\n\n      for (const dep of dependencies) {\n        if (dfs(dep.precedentSheet, [...path, currentSheet])) {\n          return true;\n        }\n      }\n\n      recursionStack.delete(key);\n      return false;\n    };\n\n    dfs(sheet, []);\n    return errors;\n  }\n\n  /**\n   * 检查缺失的引用\n   */\n  private checkMissingReferences(sheet: string): ValidationError[] {\n    const errors: ValidationError[] = [];\n    const allSheets = this.formulaEngine.getAllSheets();\n    const existingSheets = new Set(allSheets.map(s => s.key));\n\n    const formulas = this.formulaEngine.exportFormulas(sheet);\n\n    for (const [cellRef, formula] of Object.entries(formulas)) {\n      const cell = this.parseA1Notation(cellRef);\n      const cellWithSheet: FormulaCell = { sheet, row: cell.row, col: cell.col };\n\n      const crossSheetRefs = this.extractCrossSheetReferences(formula);\n\n      for (const ref of crossSheetRefs) {\n        if (!existingSheets.has(ref.targetSheet)) {\n          errors.push({\n            type: 'MISSING_REFERENCE',\n            message: `Missing sheet reference: ${ref.targetSheet}`,\n            sheet,\n            cell: cellWithSheet,\n            target: ref.targetSheet\n          });\n        }\n      }\n    }\n\n    return errors;\n  }\n\n  /**\n   * 验证所有sheet的跨sheet公式\n   */\n  validateAllSheets(options?: Partial<ValidationOptions>): Map<string, ValidationResult> {\n    const results = new Map<string, ValidationResult>();\n    const allSheets = this.formulaEngine.getAllSheets();\n\n    for (const sheetInfo of allSheets) {\n      const result = this.validateSheet(sheetInfo.key, options);\n      results.set(sheetInfo.key, result);\n    }\n\n    return results;\n  }\n\n  /**\n   * 验证公式语法（不执行计算）\n   */\n  validateFormulaSyntax(formula: string): { valid: boolean; error?: string } {\n    try {\n      if (!formula.startsWith('=')) {\n        return { valid: true };\n      }\n\n      const expression = formula.substring(1).trim();\n\n      // 基本语法检查\n      this.validateExpressionStructure(expression);\n\n      // 检查跨sheet引用格式 - 支持中英文、数字、下划线，以及中英文感叹号\n      const crossSheetPattern = /([A-Za-z0-9_一-龥]+)[！!]([A-Z]+[0-9]+(?::[A-Z]+[0-9]+)?)/g;\n      let match;\n\n      while ((match = crossSheetPattern.exec(expression)) !== null) {\n        const sheetName = match[1];\n        const cellRef = match[2];\n\n        // 验证sheet名称格式\n        if (!this.isValidSheetName(sheetName)) {\n          return { valid: false, error: `Invalid sheet name: ${sheetName}` };\n        }\n\n        // 验证sheet是否存在\n        if (!this.isValidSheet(sheetName)) {\n          return { valid: false, error: `Invalid sheet name: ${sheetName}` };\n        }\n\n        // 验证单元格引用格式\n        if (!this.isValidCellReference(cellRef)) {\n          return { valid: false, error: `Invalid cell reference: ${cellRef}` };\n        }\n      }\n\n      return { valid: true };\n    } catch (error) {\n      return {\n        valid: false,\n        error: error instanceof Error ? error.message : 'Syntax validation failed'\n      };\n    }\n  }\n\n  /**\n   * 验证表达式结构\n   */\n  private validateExpressionStructure(expression: string): void {\n    // 检查括号匹配\n    const openParenCount = (expression.match(/\\(/g) || []).length;\n    const closeParenCount = (expression.match(/\\)/g) || []).length;\n\n    if (openParenCount !== closeParenCount) {\n      throw new Error('Unmatched parentheses');\n    }\n\n    // 检查引号匹配\n    const doubleQuoteCount = (expression.match(/\"/g) || []).length;\n    if (doubleQuoteCount % 2 !== 0) {\n      throw new Error('Unmatched quotes');\n    }\n  }\n\n  /**\n   * 验证sheet名称\n   */\n  private isValidSheetName(sheetName: string): boolean {\n    // Sheet名称规则：支持中英文、数字、下划线，不能以数字开头\n    const validPattern = /^[A-Za-z_一-龥][A-Za-z0-9_一-龥]*$/;\n    return validPattern.test(sheetName);\n  }\n\n  /**\n   * 验证单元格引用格式\n   */\n  private isValidCellReference(cellRef: string): boolean {\n    // 支持单个单元格如 A1 或范围如 A1:B2\n    const singleCellPattern = /^[A-Z]+[0-9]+$/;\n    const rangePattern = /^[A-Z]+[0-9]+:[A-Z]+[0-9]+$/;\n\n    return singleCellPattern.test(cellRef) || rangePattern.test(cellRef);\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   * 工具方法：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(sheet: string, options: ValidationOptions): string {\n    return `${sheet}_${JSON.stringify(options)}`;\n  }\n\n  /**\n   * 获取缓存时间戳\n   */\n  private getCacheTimestamp(_cacheKey: string): number {\n    // 简单的实现，实际应该存储时间戳\n    return Date.now();\n  }\n\n  /**\n   * 清除验证缓存\n   */\n  clearCache(): void {\n    this.validationCache.clear();\n  }\n\n  /**\n   * 销毁验证器\n   */\n  destroy(): void {\n    this.clearCache();\n  }\n}\n"]}

package/cjs/formula/formula-engine.d.ts

@@ -14,6 +14,7 @@ export interface FormulaEngineConfig {
 export declare class FormulaEngine {
     private sheets;
     private reverseSheets;
+    private sheetTitles;
     private sheetData;
     private formulaCells;
     private dependencies;
@@ -24,6 +25,7 @@ export declare class FormulaEngine {
     setActiveSheet(sheetKey: string): void;
     getActiveSheet(): string | null;
     addSheet(sheetKey: string, data?: unknown[][]): number;
+    setSheetTitle(sheetKey: string, sheetTitle: string): void;
     updateSheetData(sheetKey: string, data: unknown[][]): void;
     private normalizeData;
     getSheetId(sheetKey: string): number;
@@ -87,10 +89,11 @@ export declare class FormulaEngine {
     private validateExpressionStructure;
     release(): void;
     exportFormulas(sheetKey: string): Record<string, string>;
+    getSheetTitle(sheetKey: string): string | undefined;
     getAllSheets(): Array<{
         key: string;
         id: number;
-        name: string;
+        title: string;
     }>;
     sortFormulasByDependency(sheetKey: string, formulas: Record<string, string>): [string, string][];
     removeSheet(sheetKey: string): void;

package/cjs/formula/formula-engine.js

@@ -8,8 +8,9 @@ const formula_helper_1 = require("./formula-helper");
 
 class FormulaEngine {
     constructor(_config = {}) {
-        this.sheets = new Map, this.reverseSheets = new Map, this.sheetData = new Map, this.formulaCells = new Map, 
-        this.dependencies = new Map, this.dependents = new Map, this.nextSheetId = 0, this.activeSheetKey = null;
+        this.sheets = new Map, this.reverseSheets = new Map, this.sheetTitles = new Map, 
+        this.sheetData = new Map, this.formulaCells = new Map, this.dependencies = new Map, 
+        this.dependents = new Map, this.nextSheetId = 0, this.activeSheetKey = null;
     }
     setActiveSheet(sheetKey) {
         this.sheets.has(sheetKey) && (this.activeSheetKey = sheetKey);
@@ -24,6 +25,9 @@ class FormulaEngine {
         const sheetData = data || [ [ "" ] ];
         return this.sheetData.set(sheetId, sheetData), sheetId;
     }
+    setSheetTitle(sheetKey, sheetTitle) {
+        this.sheets.has(sheetKey) && this.sheetTitles.set(sheetKey, sheetTitle);
+    }
     updateSheetData(sheetKey, data) {
         const sheetId = this.sheets.get(sheetKey);
         null != sheetId && this.sheetData.set(sheetId, data);
@@ -120,7 +124,11 @@ class FormulaEngine {
         };
     }
     parseCellKey(cellKey) {
-        const parts = cellKey.split("!");
+        let parts;
+        if (cellKey.includes("!")) parts = cellKey.split("!"); else {
+            if (!cellKey.includes("！")) return null;
+            parts = cellKey.split("！");
+        }
         if (2 !== parts.length) return null;
         const [sheet, a1Notation] = parts;
         try {
@@ -159,7 +167,26 @@ class FormulaEngine {
         const expression = formula.substring(1);
         let inQuotes = !1, quoteChar = "", i = 0;
         for (;i < expression.length; ) {
-            const char = expression[i];
+            const char = expression[i], quotedSheetCellMatchCN = expression.substring(i).match(/^'([A-Za-z0-9_\s一-龥]+)'\s*！\s*([A-Za-z]+[0-9]+)/);
+            if (quotedSheetCellMatchCN) {
+                const fullRef = quotedSheetCellMatchCN[0], sheetNameMatch = fullRef.match(/^'([^']+)'\s*！\s*(.+)$/);
+                if (sheetNameMatch) {
+                    const originalSheetName = sheetNameMatch[1], cellRef = sheetNameMatch[2], correctedSheetName = this.findOriginalSheetName(originalSheetName), letters = cellRef.replace(/[0-9]/g, ""), numbers = cellRef.replace(/[A-Za-z]/g, "");
+                    corrected += "'" + (correctedSheetName || originalSheetName) + "'!" + letters.toUpperCase() + numbers, 
+                    i += fullRef.length;
+                    continue;
+                }
+            }
+            const quotedSheetCellMatch = expression.substring(i).match(/^'([A-Za-z0-9_\s一-龥]+)'![A-Za-z]+[0-9]+/);
+            if (quotedSheetCellMatch) {
+                const fullRef = quotedSheetCellMatch[0], sheetNameMatch = fullRef.match(/^'([^']+)'!(.+)$/);
+                if (sheetNameMatch) {
+                    const originalSheetName = sheetNameMatch[1], cellRef = sheetNameMatch[2], correctedSheetName = this.findOriginalSheetName(originalSheetName), letters = cellRef.replace(/[0-9]/g, ""), numbers = cellRef.replace(/[A-Za-z]/g, "");
+                    corrected += "'" + (correctedSheetName || originalSheetName) + "'!" + letters.toUpperCase() + numbers, 
+                    i += fullRef.length;
+                    continue;
+                }
+            }
             if (!('"' !== char && "'" !== char || 0 !== i && "\\" === expression[i - 1])) {
                 inQuotes ? char === quoteChar && (inQuotes = !1, quoteChar = "") : (inQuotes = !0, 
                 quoteChar = char), corrected += char, i++;
@@ -175,13 +202,37 @@ class FormulaEngine {
                 for (corrected += funcName.toUpperCase() + "(", i += funcName.length + 1; i < expression.length && " " === expression[i]; ) i++;
                 continue;
             }
-            const sheetCellMatch = expression.substring(i).match(/^[A-Za-z0-9_]+![A-Za-z]+[0-9]+/);
+            const sheetCellMatchCN = expression.substring(i).match(/^[A-Za-z0-9_\s一-龥]+！([A-Za-z]+[0-9]+)/);
+            if (sheetCellMatchCN) {
+                const fullRef = sheetCellMatchCN[0], [sheetName, cellRef] = fullRef.split("！"), originalSheetName = this.findOriginalSheetName(sheetName), letters = cellRef.replace(/[0-9]/g, ""), numbers = cellRef.replace(/[A-Za-z]/g, "");
+                corrected += (originalSheetName || sheetName) + "!" + letters.toUpperCase() + numbers, 
+                i += fullRef.length;
+                continue;
+            }
+            const sheetCellMatch = expression.substring(i).match(/^[A-Za-z0-9_\s一-龥]+![A-Za-z]+[0-9]+/);
             if (sheetCellMatch) {
                 const fullRef = sheetCellMatch[0], [sheetName, cellRef] = fullRef.split("!"), originalSheetName = this.findOriginalSheetName(sheetName), letters = cellRef.replace(/[0-9]/g, ""), numbers = cellRef.replace(/[A-Za-z]/g, "");
                 corrected += (originalSheetName || sheetName) + "!" + letters.toUpperCase() + numbers, 
                 i += fullRef.length;
                 continue;
             }
+            const quotedSheetRangeMatchCN = expression.substring(i).match(/^'([A-Za-z0-9_\s一-龥]+)'！[A-Za-z]+[0-9]+:[A-Za-z]+[0-9]+/);
+            if (quotedSheetRangeMatchCN) {
+                const fullRangeRef = quotedSheetRangeMatchCN[0], sheetNameMatch = fullRangeRef.match(/^'([^']+)'！(.+)$/);
+                if (sheetNameMatch) {
+                    const originalSheetName = sheetNameMatch[1], rangePart = sheetNameMatch[2], [startCell, endCell] = rangePart.split(":"), correctedSheetName = this.findOriginalSheetName(originalSheetName), startLetters = startCell.replace(/[0-9]/g, ""), startNumbers = startCell.replace(/[A-Za-z]/g, ""), newStartCell = startLetters.toUpperCase() + startNumbers, endLetters = endCell.replace(/[0-9]/g, ""), endNumbers = endCell.replace(/[A-Za-z]/g, "");
+                    corrected += "'" + (correctedSheetName || originalSheetName) + "'!" + newStartCell + ":" + (endLetters.toUpperCase() + endNumbers), 
+                    i += fullRangeRef.length;
+                    continue;
+                }
+            }
+            const sheetRangeMatchCN = expression.substring(i).match(/^[A-Za-z0-9_\s一-龥]+！[A-Za-z]+[0-9]+:[A-Za-z]+[0-9]+/);
+            if (sheetRangeMatchCN) {
+                const fullRangeRef = sheetRangeMatchCN[0], [sheetPart, rangePart] = fullRangeRef.split("！"), [startCell, endCell] = rangePart.split(":"), originalSheetName = this.findOriginalSheetName(sheetPart), startLetters = startCell.replace(/[0-9]/g, ""), startNumbers = startCell.replace(/[A-Za-z]/g, ""), newStartCell = startLetters.toUpperCase() + startNumbers, endLetters = endCell.replace(/[0-9]/g, ""), endNumbers = endCell.replace(/[A-Za-z]/g, "");
+                corrected += (originalSheetName || sheetPart) + "!" + newStartCell + ":" + (endLetters.toUpperCase() + endNumbers), 
+                i += fullRangeRef.length;
+                continue;
+            }
             const sheetRangeMatch = expression.substring(i).match(/^[A-Za-z0-9_]+![A-Za-z]+[0-9]+:[A-Za-z]+[0-9]+/);
             if (sheetRangeMatch) {
                 const fullRangeRef = sheetRangeMatch[0], [sheetPart, rangePart] = fullRangeRef.split("!"), [startCell, endCell] = rangePart.split(":"), originalSheetName = this.findOriginalSheetName(sheetPart), startLetters = startCell.replace(/[0-9]/g, ""), startNumbers = startCell.replace(/[A-Za-z]/g, ""), newStartCell = startLetters.toUpperCase() + startNumbers, endLetters = endCell.replace(/[0-9]/g, ""), endNumbers = endCell.replace(/[A-Za-z]/g, "");
@@ -204,8 +255,10 @@ class FormulaEngine {
         return corrected;
     }
     findOriginalSheetName(sheetName) {
-        if (this.sheets.has(sheetName)) return sheetName;
+        for (const sheetTitle of this.sheetTitles.values()) if (sheetTitle === sheetName) return sheetTitle;
         const lowerSheetName = sheetName.toLowerCase();
+        for (const sheetTitle of this.sheetTitles.values()) if (sheetTitle.toLowerCase() === lowerSheetName) return sheetTitle;
+        if (this.sheets.has(sheetName)) return sheetName;
         for (const [existingSheetName] of this.sheets.entries()) if (existingSheetName.toLowerCase() === lowerSheetName) return existingSheetName;
         return null;
     }
@@ -296,7 +349,7 @@ class FormulaEngine {
                 value: expr.slice(1, -1),
                 error: void 0
             };
-            if (/^([A-Za-z0-9_]+!)?[A-Z]+[0-9]+$/.test(expr)) return {
+            if (/^([A-Za-z0-9_\s一-龥]+!)?[A-Z]+[0-9]+$/.test(expr)) return {
                 value: this.getCellValueByA1(expr),
                 error: void 0
             };
@@ -304,7 +357,7 @@ class FormulaEngine {
                 value: Number(expr),
                 error: void 0
             };
-            if (/^([A-Za-z0-9_]+!)?[A-Z]+[0-9]+:[A-Z]+[0-9]+$/.test(expr)) {
+            if (/^([A-Za-z0-9_\s一-龥]+!)?[A-Z]+[0-9]+:[A-Z]+[0-9]+$/.test(expr)) {
                 return {
                     value: this.getRangeValuesFromExpr(expr),
                     error: void 0
@@ -729,7 +782,7 @@ class FormulaEngine {
                 };
                 functionValues.push(funcResult.value), processedExpr = processedExpr.replace(funcMatch.match, `__FUNC_${functionValues.length - 1}__`);
             }
-            const cellRefs = processedExpr.match(/[A-Z]+[0-9]+/g) || [];
+            const cellRefs = processedExpr.match(/('[^']+'!)?([A-Za-z0-9_\s一-龥]+!)?[A-Z]+[0-9]+/g) || [];
             for (const cellRef of cellRefs) {
                 const value = this.getCellValueByA1(cellRef);
                 processedExpr = processedExpr.replace(cellRef, String(value));
@@ -747,11 +800,21 @@ class FormulaEngine {
         }
     }
     getCellValueByA1(a1Notation) {
+        var _a, _b;
         try {
             let sheetKey = this.activeSheetKey || this.reverseSheets.get(0) || "Sheet1", cellRef = a1Notation;
-            if (a1Notation.includes("!")) {
-                const parts = a1Notation.split("!");
-                2 === parts.length && (sheetKey = parts[0], cellRef = parts[1]);
+            if (a1Notation.includes("!") || a1Notation.includes("！")) {
+                let parts;
+                if (parts = a1Notation.includes("!") ? a1Notation.split("!") : a1Notation.split("！"), 
+                2 === parts.length) {
+                    let sheetTitle = parts[0];
+                    sheetTitle.startsWith("'") && sheetTitle.endsWith("'") && (sheetTitle = sheetTitle.slice(1, -1));
+                    let foundSheetKey = null === (_a = Array.from(this.sheetTitles.entries()).find((([_, value]) => value.toLowerCase() === sheetTitle.toLowerCase()))) || void 0 === _a ? void 0 : _a[0];
+                    foundSheetKey || (foundSheetKey = null === (_b = Array.from(this.sheets.entries()).find((([key, _]) => key.toLowerCase() === sheetTitle.toLowerCase()))) || void 0 === _b ? void 0 : _b[0]), 
+                    !foundSheetKey && this.sheets && this.sheets.has(sheetTitle) && (foundSheetKey = sheetTitle), 
+                    foundSheetKey ? (sheetKey = foundSheetKey, cellRef = parts[1]) : (sheetKey = sheetTitle, 
+                    cellRef = parts[1]);
+                }
             }
             const {row: row, col: col} = this.parseA1Notation(cellRef), cell = {
                 sheet: sheetKey,
@@ -759,19 +822,38 @@ class FormulaEngine {
                 col: col
             };
             return this.getCellValue(cell).value;
-        } catch (_a) {
+        } catch (_c) {
             return 0;
         }
     }
     getRangeValuesFromExpr(expr) {
         try {
             if (!expr.includes(":")) return [ this.getCellValueByA1(expr) ];
-            let sheetKey = this.activeSheetKey || this.reverseSheets.get(0) || "Sheet1", rangeExpr = expr;
-            if (expr.includes("!")) {
-                const parts = expr.split("!");
-                2 === parts.length && (sheetKey = parts[0], rangeExpr = parts[1]);
-            }
-            const [start, end] = rangeExpr.split(":"), startCell = this.parseA1Notation(start.trim()), endCell = this.parseA1Notation(end.trim()), values = [];
+            const defaultSheetKey = this.activeSheetKey || this.reverseSheets.get(0) || "Sheet1", parseSheetAndCell = part => {
+                var _a, _b;
+                let sheetKey = defaultSheetKey, cellRef = part.trim(), hasSheetPrefix = !1;
+                const hasEn = cellRef.includes("!"), hasCn = cellRef.includes("！");
+                if (hasEn || hasCn) {
+                    const sep = hasEn ? "!" : "！", parts = cellRef.split(sep);
+                    if (2 === parts.length) {
+                        hasSheetPrefix = !0;
+                        let sheetTitle = parts[0].trim();
+                        cellRef = parts[1].trim(), sheetTitle.startsWith("'") && sheetTitle.endsWith("'") && (sheetTitle = sheetTitle.slice(1, -1));
+                        const foundSheetKeyFromTitles = null === (_a = Array.from(this.sheetTitles.entries()).find((([_, value]) => value.toLowerCase() === sheetTitle.toLowerCase()))) || void 0 === _a ? void 0 : _a[0], foundSheetKeyFromKeys = null === (_b = Array.from(this.sheets.entries()).find((([sheetKey]) => sheetKey.toLowerCase() === sheetTitle.toLowerCase()))) || void 0 === _b ? void 0 : _b[0];
+                        let foundSheetKey = foundSheetKeyFromTitles || foundSheetKeyFromKeys;
+                        !foundSheetKey && this.sheets && this.sheets.has(sheetTitle) && (foundSheetKey = sheetTitle), 
+                        sheetKey = foundSheetKey || sheetTitle;
+                    }
+                }
+                return {
+                    sheetKey: sheetKey,
+                    cellRef: cellRef,
+                    hasSheetPrefix: hasSheetPrefix
+                };
+            }, [startRaw, endRaw] = expr.split(":"), startParsed = parseSheetAndCell(startRaw), endParsed = parseSheetAndCell(endRaw);
+            if (startParsed.hasSheetPrefix && !endParsed.hasSheetPrefix ? endParsed.sheetKey = startParsed.sheetKey : !startParsed.hasSheetPrefix && endParsed.hasSheetPrefix && (startParsed.sheetKey = endParsed.sheetKey), 
+            startParsed.sheetKey.toLowerCase() !== endParsed.sheetKey.toLowerCase()) return [];
+            const sheetKey = startParsed.sheetKey, startCell = this.parseA1Notation(startParsed.cellRef), endCell = this.parseA1Notation(endParsed.cellRef), values = [];
             for (let row = startCell.row; row <= endCell.row; row++) for (let col = startCell.col; col <= endCell.col; col++) {
                 const cell = {
                     sheet: sheetKey,
@@ -787,6 +869,10 @@ class FormulaEngine {
     }
     getCellValue(cell) {
         try {
+            if (!this.sheets) return {
+                value: null,
+                error: "FormulaEngine not properly initialized: sheets Map is undefined"
+            };
             const sheetId = this.sheets.get(cell.sheet);
             if (void 0 === sheetId) return {
                 value: "",
@@ -897,14 +983,17 @@ class FormulaEngine {
         }
         return result;
     }
+    getSheetTitle(sheetKey) {
+        return this.sheetTitles.get(sheetKey);
+    }
     getAllSheets() {
         const result = [];
         for (const entry of Array.from(this.sheets.entries())) {
-            const [sheetKey, sheetId] = entry;
+            const [sheetKey, sheetId] = entry, sheetTitle = this.sheetTitles.get(sheetKey) || sheetKey;
             result.push({
                 key: sheetKey,
                 id: sheetId,
-                name: sheetKey
+                title: sheetTitle
             });
         }
         return result;
@@ -925,7 +1014,7 @@ class FormulaEngine {
                 if (tempVisited.has(cellKey)) return;
                 tempVisited.add(cellKey);
                 const deps = tempDependencies.get(cellKey) || new Set;
-                for (const dep of deps) tempDependencies.has(dep) && visit(dep);
+                for (const dep of deps) tempDependencies && tempDependencies.has(dep) && visit(dep);
                 tempVisited.delete(cellKey), visited.add(cellKey);
                 const cellRef = cellKey.substring(sheetKey.length + 1), formula = formulas[cellRef];
                 formula && result.push([ cellRef, formula ]);
@@ -1003,6 +1092,8 @@ class FormulaEngine {
     }
     updateDependencies(cellKey, formula) {
         var _a;
+        if (!this.dependencies) return;
+        if (!this.dependents) return;
         const oldDeps = this.dependencies.get(cellKey) || new Set;
         for (const dep of oldDeps) {
             const depDependents = this.dependents.get(dep) || new Set;
@@ -1024,10 +1115,27 @@ class FormulaEngine {
         return [ ...new Set(references) ];
     }
     extractReferencesFromExpression(expr, references, currentSheet = "Sheet1") {
+        const repeatedSheetRangePattern = new RegExp("([A-Za-z0-9_\\s一-龥]+)[！!]([A-Z]+[0-9]+)\\s*:\\s*([A-Za-z0-9_\\s一-龥]+)[！!]([A-Z]+[0-9]+)", "g");
+        let repeatedMatch;
+        for (;null !== (repeatedMatch = repeatedSheetRangePattern.exec(expr)); ) {
+            const sheet1 = repeatedMatch[1], startCell = repeatedMatch[2], sheet2 = repeatedMatch[3], endCell = repeatedMatch[4];
+            if (sheet1.toLowerCase() === sheet2.toLowerCase()) {
+                const expandedRefs = this.expandRangeToCells(sheet1, startCell, endCell);
+                references.push(...expandedRefs);
+            }
+        }
+        const chineseExclamationPattern = /([A-Za-z0-9_\s一-龥]+)！([A-Z]+[0-9]+)(?::([A-Z]+[0-9]+))?/g;
+        let match;
+        for (;null !== (match = chineseExclamationPattern.exec(expr)); ) {
+            const sheetName = match[1], startCell = match[2], endCell = match[3];
+            if (endCell) {
+                const expandedRefs = this.expandRangeToCells(sheetName, startCell, endCell);
+                references.push(...expandedRefs);
+            } else references.push(`${sheetName}!${startCell}`);
+        }
         let cleanExpr = expr.replace(/"[^"]*"/g, "");
         cleanExpr = cleanExpr.replace(/'[^']*'/g, "");
         const cellRefPattern = /(?:([A-Za-z0-9_]+)!)?([A-Z]+[0-9]+)(?::([A-Z]+[0-9]+))?/g;
-        let match;
         for (;null !== (match = cellRefPattern.exec(cleanExpr)); ) {
             const sheetName = match[1] || currentSheet, startCell = match[2], endCell = match[3];
             if (endCell) {
@@ -1483,5 +1591,4 @@ class FormulaError {
     constructor(message, type = "VALUE") {
         this.message = message, this.type = type;
     }
-}
-//# sourceMappingURL=formula-engine.js.map
+}