@univerjs/engine-formula 1.0.4 → 1.2.0

package/lib/cjs/index.js

@@ -358,7 +358,7 @@ function getSearchModeValue(searchModeValue) {
 }
 
 //#endregion
-//#region \0@oxc-project+runtime@0.149.0/helpers/esm/typeof.js
+//#region \0@oxc-project+runtime@0.153.0/helpers/esm/typeof.js
 function _typeof(o) {
 	"@babel/helpers - typeof";
 	return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function(o) {
@@ -369,7 +369,7 @@ function _typeof(o) {
 }
 
 //#endregion
-//#region \0@oxc-project+runtime@0.149.0/helpers/esm/toPrimitive.js
+//#region \0@oxc-project+runtime@0.153.0/helpers/esm/toPrimitive.js
 function toPrimitive(t, r) {
 	if ("object" != _typeof(t) || !t) return t;
 	var e = t[Symbol.toPrimitive];
@@ -382,14 +382,14 @@ function toPrimitive(t, r) {
 }
 
 //#endregion
-//#region \0@oxc-project+runtime@0.149.0/helpers/esm/toPropertyKey.js
+//#region \0@oxc-project+runtime@0.153.0/helpers/esm/toPropertyKey.js
 function toPropertyKey(t) {
 	var i = toPrimitive(t, "string");
 	return "symbol" == _typeof(i) ? i : i + "";
 }
 
 //#endregion
-//#region \0@oxc-project+runtime@0.149.0/helpers/esm/defineProperty.js
+//#region \0@oxc-project+runtime@0.153.0/helpers/esm/defineProperty.js
 function _defineProperty(e, r, t) {
 	return (r = toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
 		value: t,
@@ -1216,7 +1216,7 @@ function splitTableStructuredRef(ref) {
 }
 
 //#endregion
-//#region \0@oxc-project+runtime@0.149.0/helpers/esm/decorateParam.js
+//#region \0@oxc-project+runtime@0.153.0/helpers/esm/decorateParam.js
 function __decorateParam(paramIndex, decorator) {
 	return function(target, key) {
 		decorator(target, key, paramIndex);
@@ -1224,7 +1224,7 @@ function __decorateParam(paramIndex, decorator) {
 }
 
 //#endregion
-//#region \0@oxc-project+runtime@0.149.0/helpers/esm/decorate.js
+//#region \0@oxc-project+runtime@0.153.0/helpers/esm/decorate.js
 function __decorate(decorators, target, key, desc) {
 	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
 	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
@@ -1702,8 +1702,6 @@ const SetSuperTableOptionMutation = {
 //#endregion
 //#region src/config/config.ts
 const ENGINE_FORMULA_PLUGIN_CONFIG_KEY = "engine-formula.config";
-const DEFAULT_CYCLE_REFERENCE_COUNT = 1;
-const ENGINE_FORMULA_CYCLE_REFERENCE_COUNT = "CYCLE_REFERENCE_COUNT";
 const ENGINE_FORMULA_RETURN_DEPENDENCY_TREE = "RETURN_DEPENDENCY_TREE";
 const configSymbol = Symbol(ENGINE_FORMULA_PLUGIN_CONFIG_KEY);
 const defaultPluginConfig = {};
@@ -3124,9 +3122,8 @@ var LexerTreeBuilder = class extends _univerjs_core.Disposable {
 		const isCacheable = !/\b(?:LET|LAMBDA)\s*\(/iu.test(formulaString);
 		const cacheKey = injectDefinedNameParam == null ? formulaString : `${injectDefinedNameParam.unitId ?? ""}\0${injectDefinedNameParam.sheetId ?? ""}\0${injectDefinedNameParam.refOffsetX}\0${injectDefinedNameParam.refOffsetY}\0${formulaString}`;
 		if (transformSuffix === true && isCacheable) {
-			var _this$_simpleCheckDef;
 			const lexerNode = FormulaLexerNodeCache.get(cacheKey);
-			const simpleCheckDefinedNameResult = injectDefinedNameParam && ((_this$_simpleCheckDef = this._simpleCheckDefinedName) === null || _this$_simpleCheckDef === void 0 ? void 0 : _this$_simpleCheckDef.call(this, formulaString, injectDefinedNameParam));
+			const simpleCheckDefinedNameResult = injectDefinedNameParam && this._simpleCheckDefinedName(formulaString, injectDefinedNameParam, lexerNode);
 			if (lexerNode && !simpleCheckDefinedNameResult) return lexerNode;
 		}
 		this._resetCurrentLexerNode();
@@ -3193,13 +3190,13 @@ var LexerTreeBuilder = class extends _univerjs_core.Disposable {
 				const definedNameToken = token.trim();
 				const definedContent = getValueByName(unitId, definedNameToken, sheetId);
 				if (definedContent) {
+					definedNames.push(definedContent.name);
 					const refOffsetX = definedContent.localSheetId === "AllDefaultWorkbook" ? param.refOffsetX - 1 : param.refOffsetX;
 					const refString = definedContent.formulaOrRefString.startsWith("=") ? definedContent.formulaOrRefString : this._moveDefinedNameRefOffset(definedContent.formulaOrRefString, refOffsetX, param.refOffsetY);
 					const nestedDefinedNameParam = this._handleNestedDefinedName(refString, param);
 					if (nestedDefinedNameParam == null || typeof nestedDefinedNameParam !== "object") {
 						sequenceString += nestedDefinedNameParam || "#NAME?";
 						hasDefinedName = true;
-						definedNames.push(definedNameToken);
 					} else if (typeof nestedDefinedNameParam === "object") {
 						const { sequenceString: nestedSequenceString, definedNames: nestedDefinedNames } = nestedDefinedNameParam;
 						sequenceString += nestedSequenceString;
@@ -3264,7 +3261,7 @@ var LexerTreeBuilder = class extends _univerjs_core.Disposable {
 		if (state === "#VALUE!" || sequenceArray.length === 0) return state;
 		return this._handleDefinedName(sequenceArray, param);
 	}
-	_simpleCheckDefinedName(formulaString, injectDefinedNameParam) {
+	_simpleCheckDefinedName(formulaString, injectDefinedNameParam, lexerNode) {
 		const { getDirtyDefinedNameMap, unitId } = injectDefinedNameParam;
 		const definedNameMap = getDirtyDefinedNameMap();
 		const executeUnitId = unitId;
@@ -3272,7 +3269,7 @@ var LexerTreeBuilder = class extends _univerjs_core.Disposable {
 			const names = Object.keys(definedNameMap[executeUnitId]);
 			for (let i = 0, len = names.length; i < len; i++) {
 				const name = names[i];
-				if (formulaString.indexOf(name) > -1) return true;
+				if (formulaString.indexOf(name) > -1 || (lexerNode === null || lexerNode === void 0 ? void 0 : lexerNode.getDefinedNames().includes(name))) return true;
 			}
 		}
 		return false;
@@ -4331,18 +4328,43 @@ let FormulaDataModel = class FormulaDataModel extends _univerjs_core.Disposable
 		super();
 		this._univerInstanceService = _univerInstanceService;
 		this._lexerTreeBuilder = _lexerTreeBuilder;
+		_defineProperty(this, "_circularReferences", /* @__PURE__ */ new Map());
 		_defineProperty(this, "_formulaIdMapData", Object.create(null));
 		_defineProperty(this, "_arrayFormulaRange", Object.create(null));
 		_defineProperty(this, "_arrayFormulaCellData", Object.create(null));
 		_defineProperty(this, "_unitImageFormulaData", Object.create(null));
+		this.disposeWithMe(this._univerInstanceService.getTypeOfUnitDisposed$(_univerjs_core.UniverInstanceType.UNIVER_SHEET).subscribe((workbook) => {
+			for (const [key, cell] of this._circularReferences) if (cell.unitId === workbook.getUnitId()) this._circularReferences.delete(key);
+		}));
 	}
 	dispose() {
 		super.dispose();
+		this._circularReferences.clear();
 		this._formulaIdMapData = Object.create(null);
 		this._arrayFormulaRange = Object.create(null);
 		this._arrayFormulaCellData = Object.create(null);
 		this._unitImageFormulaData = Object.create(null);
 	}
+	setCircularReferences(cells) {
+		this._circularReferences.clear();
+		for (const cell of cells) this._circularReferences.set(JSON.stringify([
+			cell.unitId,
+			cell.sheetId,
+			cell.row,
+			cell.column
+		]), { ...cell });
+	}
+	getCircularReferences(unitId) {
+		return Array.from(this._circularReferences.values()).filter((cell) => cell.unitId === unitId).map((cell) => ({ ...cell }));
+	}
+	isCircularReference(unitId, sheetId, row, column) {
+		return this._circularReferences.has(JSON.stringify([
+			unitId,
+			sheetId,
+			row,
+			column
+		]));
+	}
 	clearPreviousArrayFormulaCellData(clearArrayFormulaCellData) {
 		Object.keys(clearArrayFormulaCellData).forEach((unitId) => {
 			const clearSheetData = clearArrayFormulaCellData[unitId];
@@ -5181,6 +5203,7 @@ let FormulaCurrentConfigService = class FormulaCurrentConfigService extends _uni
 		this._localeService = _localeService;
 		this._formulaDataModel = _formulaDataModel;
 		this._sheetRowFilteredService = _sheetRowFilteredService;
+		_defineProperty(this, "_dirtyIterationUnits", []);
 		_defineProperty(this, "_unitData", Object.create(null));
 		_defineProperty(this, "_unitStylesData", Object.create(null));
 		_defineProperty(this, "_arrayFormulaCellData", Object.create(null));
@@ -5361,6 +5384,7 @@ let FormulaCurrentConfigService = class FormulaCurrentConfigService extends _uni
 		}
 		if (config.rowData) this._applyUnitRowData(config.rowData);
 		this._formulaData = config.formulaData;
+		this._dirtyIterationUnits = config.dirtyIterationUnits ?? [];
 		this._arrayFormulaCellData = convertUnitDataToRuntime(config.arrayFormulaCellData);
 		this._arrayFormulaRange = config.arrayFormulaRange;
 		this._forceCalculate = config.forceCalculate;
@@ -5388,6 +5412,7 @@ let FormulaCurrentConfigService = class FormulaCurrentConfigService extends _uni
 	}
 	getDirtyData() {
 		return {
+			dirtyIterationUnits: this._dirtyIterationUnits,
 			forceCalculation: this._forceCalculate,
 			dirtyRanges: this._dirtyRanges,
 			dirtyNameMap: this._dirtyNameMap,
@@ -5400,6 +5425,7 @@ let FormulaCurrentConfigService = class FormulaCurrentConfigService extends _uni
 		};
 	}
 	loadDirtyRangesAndExcludedCell(dirtyRanges, excludedCell) {
+		this._dirtyIterationUnits = [];
 		this._dirtyRanges = dirtyRanges;
 		this._excludedCell = excludedCell;
 		/**
@@ -8727,7 +8753,7 @@ var ArrayValueObject = class ArrayValueObject extends BaseValueObject {
 			const row = [];
 			for (let c = 0; c < columnArrayCount; c++) {
 				const cellRaw = columnArray[c].trim();
-				row.push(ValueObjectFactory.create(cellRaw, false, dateSystem));
+				row.push(ValueObjectFactory.createNumberLiteral(cellRaw, dateSystem) ?? ValueObjectFactory.create(cellRaw, false, dateSystem));
 			}
 			result.push(row);
 		}
@@ -8752,6 +8778,7 @@ var ArrayValueObject = class ArrayValueObject extends BaseValueObject {
 		return ArrayValueObject.create(arrayValueObjectData, this.getDateSystem());
 	}
 };
+const NUMBER_LITERAL_REGEX = /^[+-]?(?:\d+(?:\.\d*)?|\.\d+)(?:e[+-]?\d+)?$/i;
 var ValueObjectFactory = class {
 	static create(rawValue, isIgnoreNumberPattern = false, dateSystem = _univerjs_core.DateSystem.Date1900) {
 		if (rawValue == null) return NullValueObject.create();
@@ -8773,6 +8800,19 @@ var ValueObjectFactory = class {
 		if (typeof rawValue === "number") return createNumberValueObjectByRawValue(rawValue).withDateSystem(dateSystem);
 		return ErrorValueObject.create("#VALUE!");
 	}
+	/**
+	* Create a number from a number literal written in formula source, such as `12.50`, `.5`, `007` or `1E3`.
+	* Unlike cell text, where "000123456" must stay a string, a number literal in a formula is always a number.
+	*
+	* @param token The unquoted token from the formula source.
+	* @param dateSystem The workbook date system.
+	* @returns The number value object, a NUM error on overflow, or null when the token is not a number literal.
+	*/
+	static createNumberLiteral(token, dateSystem = _univerjs_core.DateSystem.Date1900) {
+		const tokenTrim = token.trim();
+		if (!NUMBER_LITERAL_REGEX.test(tokenTrim)) return null;
+		return createNumberValueObjectByRawValue(Number(tokenTrim)).withDateSystem(dateSystem);
+	}
 };
 function isStringWrappedByDoubleQuotes(input) {
 	const trimmedInput = input.trim();
@@ -9148,6 +9188,16 @@ var BaseReferenceObject = class extends ObjectClassType {
 	getRuntimeFeatureCellValue(row, column) {
 		return getRuntimeFeatureCell(row, column, this.getSheetId(), this.getUnitId(), this._runtimeFeatureCellData);
 	}
+	isCellBlank(row, column) {
+		var _this$getCurrentActiv5, _this$getCurrentRunti, _this$getCurrentActiv6, _this$getCurrentRunti2;
+		const cell = this.getCellData(row, column);
+		if (!(0, _univerjs_core.isNullCell)(cell)) return false;
+		const originalCell = (_this$getCurrentActiv5 = this.getCurrentActiveSheetData()) === null || _this$getCurrentActiv5 === void 0 ? void 0 : _this$getCurrentActiv5.cellData.getValue(row, column);
+		if ((0, _univerjs_core.isFormulaString)(originalCell === null || originalCell === void 0 ? void 0 : originalCell.f) || (0, _univerjs_core.isFormulaId)(originalCell === null || originalCell === void 0 ? void 0 : originalCell.si)) return false;
+		if (!cell) return true;
+		if (cell === ((_this$getCurrentRunti = this.getCurrentRuntimeActiveArrayFormulaCellData()) === null || _this$getCurrentRunti === void 0 ? void 0 : _this$getCurrentRunti.getValue(row, column)) || cell === ((_this$getCurrentActiv6 = this.getCurrentActiveArrayFormulaCellData()) === null || _this$getCurrentActiv6 === void 0 ? void 0 : _this$getCurrentActiv6.getValue(row, column)) || cell === this.getRuntimeFeatureCellValue(row, column)) return false;
+		return originalCell != null || cell !== ((_this$getCurrentRunti2 = this.getCurrentRuntimeSheetData()) === null || _this$getCurrentRunti2 === void 0 ? void 0 : _this$getCurrentRunti2.getValue(row, column));
+	}
 	getCellByPosition(rowRaw, columnRaw) {
 		const range = this.getRangePosition();
 		const row = rowRaw ?? range.startRow;
@@ -10059,11 +10109,14 @@ let FormulaExecutedStateType = /* @__PURE__ */ function(FormulaExecutedStateType
 	return FormulaExecutedStateType;
 }({});
 let FormulaRuntimeService = class FormulaRuntimeService extends _univerjs_core.Disposable {
-	constructor(_currentConfigService, _hyperlinkEngineFormulaService) {
+	constructor(_currentConfigService, _hyperlinkEngineFormulaService, _univerInstanceService) {
 		super();
 		this._currentConfigService = _currentConfigService;
 		this._hyperlinkEngineFormulaService = _hyperlinkEngineFormulaService;
+		this._univerInstanceService = _univerInstanceService;
 		_defineProperty(this, "_formulaExecuteStage", 0);
+		_defineProperty(this, "_circularReferences", /* @__PURE__ */ new Map());
+		_defineProperty(this, "_pendingCircularReferences", /* @__PURE__ */ new Map());
 		_defineProperty(this, "_stopState", false);
 		_defineProperty(this, "_externalReferenceUnavailable", false);
 		_defineProperty(this, "_currentRow", -1);
@@ -10093,6 +10146,9 @@ let FormulaRuntimeService = class FormulaRuntimeService extends _univerjs_core.D
 		_defineProperty(this, "_formulaCycleIndex", 0);
 		_defineProperty(this, "_isCycleDependency", false);
 		_defineProperty(this, "_dependencyTreeModelData", []);
+		this.disposeWithMe(this._univerInstanceService.getTypeOfUnitDisposed$(_univerjs_core.UniverInstanceType.UNIVER_SHEET).subscribe((workbook) => {
+			for (const references of [this._circularReferences, this._pendingCircularReferences]) for (const [key, cell] of references) if (cell.unitId === workbook.getUnitId()) references.delete(key);
+		}));
 	}
 	get currentRow() {
 		return this._currentRow;
@@ -10117,6 +10173,8 @@ let FormulaRuntimeService = class FormulaRuntimeService extends _univerjs_core.D
 	dispose() {
 		super.dispose();
 		this.reset();
+		this._circularReferences.clear();
+		this._pendingCircularReferences.clear();
 		this._runtimeFeatureCellData = Object.create(null);
 		this._runtimeFeatureRange = Object.create(null);
 		this.clearReferenceAndNumberformatCache();
@@ -10210,8 +10268,60 @@ let FormulaRuntimeService = class FormulaRuntimeService extends _univerjs_core.D
 		clearStringToNumberPatternCache();
 		clearReferenceToRangeCache();
 	}
+	beginCircularReferences() {
+		this._pendingCircularReferences = new Map(this._circularReferences);
+		const formulaData = this._currentConfigService.getFormulaData();
+		for (const [key, cell] of this._pendingCircularReferences) {
+			var _formulaData$cell$uni;
+			if (!((_formulaData$cell$uni = formulaData[cell.unitId]) === null || _formulaData$cell$uni === void 0 || (_formulaData$cell$uni = _formulaData$cell$uni[cell.sheetId]) === null || _formulaData$cell$uni === void 0 || (_formulaData$cell$uni = _formulaData$cell$uni[cell.row]) === null || _formulaData$cell$uni === void 0 ? void 0 : _formulaData$cell$uni[cell.column])) this._pendingCircularReferences.delete(key);
+		}
+	}
+	clearCircularReferenceCells(cells) {
+		if (this._pendingCircularReferences.size === 0) return;
+		for (const cell of cells) {
+			this._pendingCircularReferences.delete(JSON.stringify([
+				cell.unitId,
+				cell.subUnitId,
+				cell.row,
+				cell.column
+			]));
+			if (this._pendingCircularReferences.size === 0) return;
+		}
+	}
+	recordCircularReferences(cells) {
+		for (const cell of cells) {
+			if (cell.row < 0 || cell.column < 0) continue;
+			this._pendingCircularReferences.set(JSON.stringify([
+				cell.unitId,
+				cell.sheetId,
+				cell.row,
+				cell.column
+			]), { ...cell });
+		}
+	}
+	completeCircularReferences() {
+		if (!this.isStopExecution()) this._circularReferences = new Map(this._pendingCircularReferences);
+	}
+	preserveCurrentCellData() {
+		var _this$_currentConfigS;
+		const unitId = this.currentUnitId;
+		const sheetId = this.currentSubUnitId;
+		const cell = (_this$_currentConfigS = this._currentConfigService.getUnitData()[unitId]) === null || _this$_currentConfigS === void 0 || (_this$_currentConfigS = _this$_currentConfigS[sheetId]) === null || _this$_currentConfigS === void 0 ? void 0 : _this$_currentConfigS.cellData.getValue(this.currentRow, this.currentColumn);
+		if ((cell === null || cell === void 0 ? void 0 : cell.v) != null) return;
+		const sheets = this._runtimeData[unitId] ??= {};
+		(sheets[sheetId] ??= new _univerjs_core.ObjectMatrix()).setValue(this.currentRow, this.currentColumn, {
+			v: (cell === null || cell === void 0 ? void 0 : cell.v) ?? 0,
+			t: (cell === null || cell === void 0 ? void 0 : cell.v) == null ? _univerjs_core.CellValueType.NUMBER : cell.t
+		});
+		if (this._currentSourceFormula) {
+			const formulas = this._sourceFormulaData[unitId] ??= {};
+			const sheet = formulas[sheetId] ??= {};
+			const row = sheet[this.currentRow] ??= {};
+			row[this.currentColumn] = { ...this._currentSourceFormula };
+		}
+	}
 	setCurrent(row, column, rowCount, columnCount, sheetId, unitId) {
-		var _this$_currentConfigS, _this$_currentConfigS2;
+		var _this$_currentConfigS2, _this$_currentConfigS3;
 		this._externalReferenceUnavailable = false;
 		this._currentRow = row;
 		this._currentColumn = column;
@@ -10219,8 +10329,8 @@ let FormulaRuntimeService = class FormulaRuntimeService extends _univerjs_core.D
 		this._currentColumnCount = columnCount;
 		this._currentSubUnitId = sheetId;
 		this._currentUnitId = unitId;
-		const cell = (_this$_currentConfigS = this._currentConfigService.getUnitData()[unitId]) === null || _this$_currentConfigS === void 0 || (_this$_currentConfigS = _this$_currentConfigS[sheetId]) === null || _this$_currentConfigS === void 0 ? void 0 : _this$_currentConfigS.cellData.getValue(row, column);
-		const formula = (_this$_currentConfigS2 = this._currentConfigService.getFormulaData()[unitId]) === null || _this$_currentConfigS2 === void 0 || (_this$_currentConfigS2 = _this$_currentConfigS2[sheetId]) === null || _this$_currentConfigS2 === void 0 || (_this$_currentConfigS2 = _this$_currentConfigS2[row]) === null || _this$_currentConfigS2 === void 0 ? void 0 : _this$_currentConfigS2[column];
+		const cell = (_this$_currentConfigS2 = this._currentConfigService.getUnitData()[unitId]) === null || _this$_currentConfigS2 === void 0 || (_this$_currentConfigS2 = _this$_currentConfigS2[sheetId]) === null || _this$_currentConfigS2 === void 0 ? void 0 : _this$_currentConfigS2.cellData.getValue(row, column);
+		const formula = (_this$_currentConfigS3 = this._currentConfigService.getFormulaData()[unitId]) === null || _this$_currentConfigS3 === void 0 || (_this$_currentConfigS3 = _this$_currentConfigS3[sheetId]) === null || _this$_currentConfigS3 === void 0 || (_this$_currentConfigS3 = _this$_currentConfigS3[row]) === null || _this$_currentConfigS3 === void 0 ? void 0 : _this$_currentConfigS3[column];
 		if (formula) {
 			const isSharedFollower = (formula.x ?? 0) !== 0 || (formula.y ?? 0) !== 0;
 			this._currentSourceFormula = {
@@ -10281,9 +10391,9 @@ let FormulaRuntimeService = class FormulaRuntimeService extends _univerjs_core.D
 	}
 	setRuntimeData(functionVariant) {
 		if (this._externalReferenceUnavailable) {
-			var _this$_currentConfigS3, _this$_currentConfigS4;
-			const cell = (_this$_currentConfigS3 = this._currentConfigService.getUnitData()[this._currentUnitId]) === null || _this$_currentConfigS3 === void 0 || (_this$_currentConfigS3 = _this$_currentConfigS3[this._currentSubUnitId]) === null || _this$_currentConfigS3 === void 0 ? void 0 : _this$_currentConfigS3.cellData.getValue(this._currentRow, this._currentColumn);
-			const formula = (_this$_currentConfigS4 = this._currentConfigService.getFormulaData()[this._currentUnitId]) === null || _this$_currentConfigS4 === void 0 || (_this$_currentConfigS4 = _this$_currentConfigS4[this._currentSubUnitId]) === null || _this$_currentConfigS4 === void 0 || (_this$_currentConfigS4 = _this$_currentConfigS4[this._currentRow]) === null || _this$_currentConfigS4 === void 0 || (_this$_currentConfigS4 = _this$_currentConfigS4[this._currentColumn]) === null || _this$_currentConfigS4 === void 0 ? void 0 : _this$_currentConfigS4.f;
+			var _this$_currentConfigS4, _this$_currentConfigS5;
+			const cell = (_this$_currentConfigS4 = this._currentConfigService.getUnitData()[this._currentUnitId]) === null || _this$_currentConfigS4 === void 0 || (_this$_currentConfigS4 = _this$_currentConfigS4[this._currentSubUnitId]) === null || _this$_currentConfigS4 === void 0 ? void 0 : _this$_currentConfigS4.cellData.getValue(this._currentRow, this._currentColumn);
+			const formula = (_this$_currentConfigS5 = this._currentConfigService.getFormulaData()[this._currentUnitId]) === null || _this$_currentConfigS5 === void 0 || (_this$_currentConfigS5 = _this$_currentConfigS5[this._currentSubUnitId]) === null || _this$_currentConfigS5 === void 0 || (_this$_currentConfigS5 = _this$_currentConfigS5[this._currentRow]) === null || _this$_currentConfigS5 === void 0 || (_this$_currentConfigS5 = _this$_currentConfigS5[this._currentColumn]) === null || _this$_currentConfigS5 === void 0 ? void 0 : _this$_currentConfigS5.f;
 			if ((cell === null || cell === void 0 ? void 0 : cell.f) && cell.v != null && (formula == null || formula === cell.f)) return;
 		}
 		const row = this._currentRow;
@@ -10342,7 +10452,7 @@ let FormulaRuntimeService = class FormulaRuntimeService extends _univerjs_core.D
 			const hasDataInArrayFormulaRange = this._checkIfArrayFormulaRangeHasData(unitId, sheetId, row, column, arrayRange);
 			const isArrayFormulaExceeded = this._checkIfArrayFormulaExceeded(rowCount, columnCount, arrayRange);
 			if (hasDataInArrayFormulaRange || isArrayFormulaExceeded) {
-				var _this$_currentConfigS5;
+				var _this$_currentConfigS6;
 				const errorObject = this._getValueObjectOfRuntimeData(ErrorValueObject.create("#SPILL!"));
 				sheetData.setValue(row, column, errorObject);
 				clearArrayUnitData.setValue(row, column, errorObject);
@@ -10353,7 +10463,7 @@ let FormulaRuntimeService = class FormulaRuntimeService extends _univerjs_core.D
 				*/
 				const unitData = this._currentConfigService.getUnitData();
 				const arrayData = this._currentConfigService.getArrayFormulaCellData();
-				const previousArrayFormulaRange = (_this$_currentConfigS5 = this._currentConfigService.getArrayFormulaRange()[unitId]) === null || _this$_currentConfigS5 === void 0 || (_this$_currentConfigS5 = _this$_currentConfigS5[sheetId]) === null || _this$_currentConfigS5 === void 0 || (_this$_currentConfigS5 = _this$_currentConfigS5[row]) === null || _this$_currentConfigS5 === void 0 ? void 0 : _this$_currentConfigS5[column];
+				const previousArrayFormulaRange = (_this$_currentConfigS6 = this._currentConfigService.getArrayFormulaRange()[unitId]) === null || _this$_currentConfigS6 === void 0 || (_this$_currentConfigS6 = _this$_currentConfigS6[sheetId]) === null || _this$_currentConfigS6 === void 0 || (_this$_currentConfigS6 = _this$_currentConfigS6[row]) === null || _this$_currentConfigS6 === void 0 ? void 0 : _this$_currentConfigS6[column];
 				objectValueRefOrArray.iterator((_, rowIndex, columnIndex) => {
 					var _unitData$unitId, _arrayData$unitId;
 					const currentRow = rowIndex - startRow + row;
@@ -10470,6 +10580,7 @@ let FormulaRuntimeService = class FormulaRuntimeService extends _univerjs_core.D
 	getAllRuntimeData() {
 		return {
 			unitData: this.getUnitData(),
+			circularReferences: Array.from(this._circularReferences.values(), (cell) => ({ ...cell })),
 			sourceFormulaData: this._sourceFormulaData,
 			arrayFormulaRange: this.getUnitArrayFormula(),
 			arrayFormulaEmbedded: this.getUnitArrayFormulaEmbeddedMap(),
@@ -10490,6 +10601,7 @@ let FormulaRuntimeService = class FormulaRuntimeService extends _univerjs_core.D
 			totalArrayFormulasToCalculate: this.getTotalArrayFormulasToCalculate(),
 			completedArrayFormulasCount: this.getCompletedArrayFormulasCount(),
 			stage: this.getFormulaExecuteStage(),
+			circularReferences: Array.from(this._circularReferences.values(), (cell) => ({ ...cell })),
 			formulaCycleIndex: this.getFormulaCycleIndex()
 		};
 	}
@@ -10497,11 +10609,11 @@ let FormulaRuntimeService = class FormulaRuntimeService extends _univerjs_core.D
 		FORMULA_REF_TO_ARRAY_CACHE.clear();
 	}
 	_checkIfArrayFormulaRangeHasData(formulaUnitId, formulaSheetId, formulaRow, formulaColumn, arrayRange) {
-		var _this$_currentConfigS6;
+		var _this$_currentConfigS7;
 		const { startRow, startColumn, endRow, endColumn } = arrayRange;
 		const unitData = this._currentConfigService.getUnitData();
 		const arrayData = this._currentConfigService.getArrayFormulaCellData();
-		const previousArrayFormulaRange = (_this$_currentConfigS6 = this._currentConfigService.getArrayFormulaRange()[formulaUnitId]) === null || _this$_currentConfigS6 === void 0 || (_this$_currentConfigS6 = _this$_currentConfigS6[formulaSheetId]) === null || _this$_currentConfigS6 === void 0 || (_this$_currentConfigS6 = _this$_currentConfigS6[formulaRow]) === null || _this$_currentConfigS6 === void 0 ? void 0 : _this$_currentConfigS6[formulaColumn];
+		const previousArrayFormulaRange = (_this$_currentConfigS7 = this._currentConfigService.getArrayFormulaRange()[formulaUnitId]) === null || _this$_currentConfigS7 === void 0 || (_this$_currentConfigS7 = _this$_currentConfigS7[formulaSheetId]) === null || _this$_currentConfigS7 === void 0 || (_this$_currentConfigS7 = _this$_currentConfigS7[formulaRow]) === null || _this$_currentConfigS7 === void 0 ? void 0 : _this$_currentConfigS7[formulaColumn];
 		for (let r = startRow; r <= endRow; r++) for (let c = startColumn; c <= endColumn; c++) {
 			var _this$_runtimeData, _arrayData$formulaUni, _unitData$formulaUnit;
 			if (r === formulaRow && formulaColumn === c) continue;
@@ -10537,8 +10649,8 @@ let FormulaRuntimeService = class FormulaRuntimeService extends _univerjs_core.D
 	* @returns
 	*/
 	_isInOtherArrayFormulaRange(formulaUnitId, formulaSheetId, formulaRow, formulaColumn, r, c) {
-		var _this$_currentConfigS7;
-		const arrayFormulaRange = (_this$_currentConfigS7 = this._currentConfigService.getArrayFormulaRange()[formulaUnitId]) === null || _this$_currentConfigS7 === void 0 ? void 0 : _this$_currentConfigS7[formulaSheetId];
+		var _this$_currentConfigS8;
+		const arrayFormulaRange = (_this$_currentConfigS8 = this._currentConfigService.getArrayFormulaRange()[formulaUnitId]) === null || _this$_currentConfigS8 === void 0 ? void 0 : _this$_currentConfigS8[formulaSheetId];
 		if (arrayFormulaRange == null) return false;
 		let isCellOverlapping = false;
 		new _univerjs_core.ObjectMatrix(arrayFormulaRange).forValue((rangeRow, rangeCol, range) => {
@@ -10551,8 +10663,8 @@ let FormulaRuntimeService = class FormulaRuntimeService extends _univerjs_core.D
 		return isCellOverlapping;
 	}
 	_isCurrentSingleCellArrayFormulaRange(unitId, sheetId, row, column) {
-		var _this$_currentConfigS8;
-		const range = (_this$_currentConfigS8 = this._currentConfigService.getArrayFormulaRange()[unitId]) === null || _this$_currentConfigS8 === void 0 || (_this$_currentConfigS8 = _this$_currentConfigS8[sheetId]) === null || _this$_currentConfigS8 === void 0 || (_this$_currentConfigS8 = _this$_currentConfigS8[row]) === null || _this$_currentConfigS8 === void 0 ? void 0 : _this$_currentConfigS8[column];
+		var _this$_currentConfigS9;
+		const range = (_this$_currentConfigS9 = this._currentConfigService.getArrayFormulaRange()[unitId]) === null || _this$_currentConfigS9 === void 0 || (_this$_currentConfigS9 = _this$_currentConfigS9[sheetId]) === null || _this$_currentConfigS9 === void 0 || (_this$_currentConfigS9 = _this$_currentConfigS9[row]) === null || _this$_currentConfigS9 === void 0 ? void 0 : _this$_currentConfigS9[column];
 		return range != null && range.startRow === range.endRow && range.startColumn === range.endColumn;
 	}
 	_isInArrayFormulaRange(range, r, c) {
@@ -10576,7 +10688,11 @@ let FormulaRuntimeService = class FormulaRuntimeService extends _univerjs_core.D
 		return isInDirtyRange(dirtyRanges, unitId, sheetId, row, column);
 	}
 };
-FormulaRuntimeService = __decorate([__decorateParam(0, IFormulaCurrentConfigService), __decorateParam(1, IHyperlinkEngineFormulaService)], FormulaRuntimeService);
+FormulaRuntimeService = __decorate([
+	__decorateParam(0, IFormulaCurrentConfigService),
+	__decorateParam(1, IHyperlinkEngineFormulaService),
+	__decorateParam(2, _univerjs_core.IUniverInstanceService)
+], FormulaRuntimeService);
 const IFormulaRuntimeService = (0, _univerjs_core.createIdentifier)("univer.formula.runtime.service");
 
 //#endregion
@@ -12762,6 +12878,21 @@ UnionNodeFactory = __decorate([__decorateParam(0, IFunctionService), __decorateP
 
 //#endregion
 //#region src/engine/ast-node/value-node.ts
+/**
+* Copyright 2023-present DreamNum Co., Ltd.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*     http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
 var ValueNode = class extends BaseAstNode {
 	constructor(operatorString) {
 		super(operatorString);
@@ -12776,6 +12907,11 @@ var ValueNode = class extends BaseAstNode {
 			this.setValue(StringValueObject.create(tokenTrim.slice(1, -1).replace(/""/g, "\"")).withDateSystem(dateSystem));
 			return;
 		}
+		const numberLiteral = ValueObjectFactory.createNumberLiteral(tokenTrim, dateSystem);
+		if (numberLiteral) {
+			this.setValue(numberLiteral);
+			return;
+		}
 		const parent = this.getParent();
 		let isIgnoreNumberPattern = true;
 		if ((parent === null || parent === void 0 ? void 0 : parent.nodeType) === 4) {
@@ -13580,6 +13716,90 @@ var OtherFormulaManagerService = class extends _univerjs_core.Disposable {
 };
 const IOtherFormulaManagerService = (0, _univerjs_core.createIdentifier)("univer.formula.other-formula-manager.service");
 
+//#endregion
+//#region src/engine/dependency/dependency-groups.ts
+/**
+* Copyright 2023-present DreamNum Co., Ltd.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*     http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+/**
+* Returns strongly connected components in dependency order: precedents before their dependents.
+* Mutually dependent nodes stay together so only their group needs iterative calculation.
+* Uses iterative Kosaraju traversal to avoid overflowing the call stack on large dependency graphs.
+*/
+function getDependencyGroups(nodes, getId, getDependents) {
+	const byId = new Map(nodes.map((node) => [getId(node), node]));
+	const edges = /* @__PURE__ */ new Map();
+	const reverse = /* @__PURE__ */ new Map();
+	for (const node of nodes) {
+		const id = getId(node);
+		const dependents = Array.from(getDependents(node)).filter((dependent) => byId.has(dependent));
+		edges.set(id, dependents);
+		for (const dependent of dependents) {
+			const incoming = reverse.get(dependent) ?? [];
+			incoming.push(id);
+			reverse.set(dependent, incoming);
+		}
+	}
+	const visited = /* @__PURE__ */ new Set();
+	const order = [];
+	for (const id of byId.keys()) {
+		if (visited.has(id)) continue;
+		visited.add(id);
+		const stack = [{
+			id,
+			next: 0
+		}];
+		while (stack.length) {
+			const frame = stack[stack.length - 1];
+			const children = edges.get(frame.id);
+			if (frame.next === children.length) {
+				order.push(frame.id);
+				stack.pop();
+				continue;
+			}
+			const child = children[frame.next++];
+			if (!visited.has(child)) {
+				visited.add(child);
+				stack.push({
+					id: child,
+					next: 0
+				});
+			}
+		}
+	}
+	visited.clear();
+	const groups = [];
+	for (let i = order.length - 1; i >= 0; i--) {
+		const id = order[i];
+		if (visited.has(id)) continue;
+		const group = [];
+		const stack = [id];
+		visited.add(id);
+		while (stack.length) {
+			const current = stack.pop();
+			group.push(byId.get(current));
+			for (const parent of reverse.get(current) ?? []) if (!visited.has(parent)) {
+				visited.add(parent);
+				stack.push(parent);
+			}
+		}
+		groups.push(group);
+	}
+	return groups;
+}
+
 //#endregion
 //#region src/engine/dependency/dependency-tree.ts
 let FormulaDependencyTreeType = /* @__PURE__ */ function(FormulaDependencyTreeType) {
@@ -13592,6 +13812,7 @@ var FormulaDependencyTreeCalculator = class {
 	constructor() {
 		_defineProperty(this, "_state", 0);
 		_defineProperty(this, "type", 0);
+		_defineProperty(this, "cycleGroup", void 0);
 		_defineProperty(this, "treeId", void 0);
 		_defineProperty(this, "children", /* @__PURE__ */ new Set());
 		_defineProperty(this, "parents", /* @__PURE__ */ new Set());
@@ -14013,7 +14234,28 @@ let FormulaDependencyGenerator = class FormulaDependencyGenerator extends _unive
 		await this._generateTreeList(formulaData, otherFormulaData, unitData);
 		this._dependencyManagerService.openKdTree();
 		const updateTreeList = this._getUpdateTreeListAndMakeDependency();
-		const finalTreeList = this._calculateRunList(updateTreeList);
+		const runList = this._calculateRunList(updateTreeList);
+		const selfReferences = /* @__PURE__ */ new Set();
+		const groups = getDependencyGroups(runList, (tree) => tree.treeId, (tree) => {
+			const dependents = this._dependencyManagerService.searchDependency(tree.toRTreeItem());
+			const addressDependents = this._dependencyRTreeCacheForAddressFunction.bulkSearch(tree.toRTreeItem());
+			for (const dependent of addressDependents) dependents.add(dependent);
+			if (dependents.has(tree.treeId)) selfReferences.add(tree.treeId);
+			return dependents;
+		});
+		this._runtimeService.clearCircularReferenceCells(runList);
+		for (const group of groups) {
+			const cyclic = group.length > 1 || selfReferences.has(group[0].treeId);
+			const groupId = cyclic ? group.map((tree) => tree.treeId).sort((a, b) => a - b).join(",") : void 0;
+			for (const tree of group) {
+				tree.cycleGroup = groupId;
+				if (cyclic) {
+					var _this$_runtimeService;
+					(_this$_runtimeService = this._runtimeService.getUnitData()[tree.unitId]) === null || _this$_runtimeService === void 0 || (_this$_runtimeService = _this$_runtimeService[tree.subUnitId]) === null || _this$_runtimeService === void 0 || _this$_runtimeService.realDeleteValue(tree.row, tree.column);
+				}
+			}
+		}
+		const finalTreeList = groups.flat().reverse();
 		if (this._checkIsCycleDependency(finalTreeList)) this._runtimeService.enableCycleDependency();
 		if (isCalculateTreeModel) this._runtimeService.setDependencyTreeModelData(this._getAllDependencyJson(Array.from(this._dependencyTreeCache.values())));
 		this._dependencyTreeCache.clear();
@@ -14022,41 +14264,8 @@ let FormulaDependencyGenerator = class FormulaDependencyGenerator extends _unive
 		this._runtimeService.clearArrayObjectCache();
 		return Promise.resolve(finalTreeList);
 	}
-	_isCyclicUtilMap(treeId, colorMap) {
-		const WHITE = 0;
-		const GRAY = 1;
-		const BLACK = 2;
-		const stack = [treeId];
-		while (stack.length > 0) {
-			const currentTreeId = stack[stack.length - 1];
-			if ((colorMap.get(currentTreeId) || WHITE) === WHITE) {
-				colorMap.set(currentTreeId, GRAY);
-				const node = this._dependencyTreeCache.get(currentTreeId);
-				if (node == null) {
-					colorMap.set(currentTreeId, BLACK);
-					stack.pop();
-					continue;
-				}
-				const parents = this._dependencyManagerService.searchDependency(node.toRTreeItem());
-				for (const parentTreeId of parents) {
-					const parentColor = colorMap.get(parentTreeId) || WHITE;
-					if (parentColor === GRAY) return true;
-					else if (parentColor === WHITE) stack.push(parentTreeId);
-				}
-			} else {
-				colorMap.set(currentTreeId, BLACK);
-				stack.pop();
-			}
-		}
-		return false;
-	}
 	_checkIsCycleDependency(treeList) {
-		const colorMap = /* @__PURE__ */ new Map();
-		for (const tree of treeList) if (!colorMap.has(tree.treeId)) {
-			if (this._isCyclicUtilMap(tree.treeId, colorMap)) return true;
-		}
-		colorMap.clear();
-		return false;
+		return treeList.some((tree) => tree.cycleGroup != null);
 	}
 	_getFeatureFormulaTree(featureId, treeId, params) {
 		const { unitId, subUnitId, dependencyRanges, getDirtyData } = params;
@@ -14440,11 +14649,17 @@ let FormulaDependencyGenerator = class FormulaDependencyGenerator extends _unive
 		if (node.nodeType === 12 && node.getToken() === "#") return true;
 		return false;
 	}
+	_isStaticReference(node) {
+		return node.nodeType === 1 || node.nodeType === 10 && node.getChildren().every((child) => this._isStaticReference(child));
+	}
 	_nodeTraversalRef(node, result) {
 		const children = node.getChildren();
 		const childrenCount = children.length;
+		const token = node.getToken();
+		const readsReferenceMetadata = node.nodeType === 4 && (token === "ROW" || token === "ROWS" || token === "COLUMN" || token === "COLUMNS");
 		for (let i = 0; i < childrenCount; i++) {
 			const item = children[i];
+			if (readsReferenceMetadata && this._isStaticReference(item)) continue;
 			if (this._isPreCalculateNode(item)) {
 				result.push(item);
 				if (item.nodeType === 10) {
@@ -14688,9 +14903,10 @@ let FormulaDependencyGenerator = class FormulaDependencyGenerator extends _unive
 	* @param tree
 	*/
 	_includeTree(tree, node) {
-		var _this$_currentConfigS, _this$_currentConfigS2;
+		var _this$_currentConfigS, _this$_currentConfigS2, _this$_currentConfigS3;
 		const unitId = tree.unitId;
 		const subUnitId = tree.subUnitId;
+		if ((_this$_currentConfigS = this._currentConfigService.getDirtyData().dirtyIterationUnits) === null || _this$_currentConfigS === void 0 ? void 0 : _this$_currentConfigS.includes(unitId)) return true;
 		/**
 		* RAND, RANDBETWEEN, NOW, TODAY are volatile functions that are marked dirty and recalculated every time a calculation occurs.
 		*/
@@ -14698,13 +14914,13 @@ let FormulaDependencyGenerator = class FormulaDependencyGenerator extends _unive
 		if (this._includeTreeFeature(tree) === true) return true;
 		if (this._includeOtherFormula(tree) === true) return true;
 		if (includeDefinedName(tree, node, this._currentConfigService) === true) return true;
-		const excludedCell = (_this$_currentConfigS = this._currentConfigService.getExcludedRange()) === null || _this$_currentConfigS === void 0 || (_this$_currentConfigS = _this$_currentConfigS[unitId]) === null || _this$_currentConfigS === void 0 ? void 0 : _this$_currentConfigS[subUnitId];
+		const excludedCell = (_this$_currentConfigS2 = this._currentConfigService.getExcludedRange()) === null || _this$_currentConfigS2 === void 0 || (_this$_currentConfigS2 = _this$_currentConfigS2[unitId]) === null || _this$_currentConfigS2 === void 0 ? void 0 : _this$_currentConfigS2[subUnitId];
 		if ((excludedCell === null || excludedCell === void 0 ? void 0 : excludedCell.getValue(tree.row, tree.column)) != null) return false;
 		/**
 		* When a worksheet is inserted or deleted,
 		* the formulas within it need to be calculated.
 		*/
-		if (((_this$_currentConfigS2 = this._currentConfigService.getDirtyNameMap()[unitId]) === null || _this$_currentConfigS2 === void 0 ? void 0 : _this$_currentConfigS2[subUnitId]) != null) return true;
+		if (((_this$_currentConfigS3 = this._currentConfigService.getDirtyNameMap()[unitId]) === null || _this$_currentConfigS3 === void 0 ? void 0 : _this$_currentConfigS3[subUnitId]) != null) return true;
 		if (!this._updateRangeFlattenCache.has(unitId)) return false;
 		const sheetRangeMap = this._updateRangeFlattenCache.get(unitId);
 		if (!sheetRangeMap.has(subUnitId)) return false;
@@ -14867,6 +15083,105 @@ FormulaDependencyGenerator = __decorate([
 const DEFAULT_INTERVAL_COUNT = 500;
 const ICalculateFormulaService = (0, _univerjs_core.createIdentifier)("engine-formula.calculate-formula.service");
 let CalculateFormulaService = class CalculateFormulaService extends _univerjs_core.Disposable {
+	_loadCalculationSettings(settings) {
+		this._workbookCalculationSettings = settings ?? {};
+		this._normalizedCalculationSettings.clear();
+	}
+	_getCalculationSettings(unitId) {
+		let settings = this._normalizedCalculationSettings.get(unitId);
+		if (settings == null) {
+			settings = (0, _univerjs_core.normalizeWorkbookCalculationSettings)(this._workbookCalculationSettings[unitId]);
+			this._normalizedCalculationSettings.set(unitId, settings);
+		}
+		return settings;
+	}
+	_getIterationCell(tree) {
+		var _this$_runtimeService, _this$_currentConfigS;
+		const cell = ((_this$_runtimeService = this._runtimeService.getUnitData()[tree.unitId]) === null || _this$_runtimeService === void 0 || (_this$_runtimeService = _this$_runtimeService[tree.subUnitId]) === null || _this$_runtimeService === void 0 ? void 0 : _this$_runtimeService.getValue(tree.row, tree.column)) ?? ((_this$_currentConfigS = this._currentConfigService.getUnitData()[tree.unitId]) === null || _this$_currentConfigS === void 0 || (_this$_currentConfigS = _this$_currentConfigS[tree.subUnitId]) === null || _this$_currentConfigS === void 0 ? void 0 : _this$_currentConfigS.cellData.getValue(tree.row, tree.column)) ?? { v: 0 };
+		return cell.v == null ? {
+			v: 0,
+			t: _univerjs_core.CellValueType.NUMBER
+		} : cell;
+	}
+	async *_iterateCalculationGroup(group, groupId) {
+		const settings = group.map((item) => this._getCalculationSettings(item.unitId));
+		if (group.every((item, i) => {
+			var _this$_currentConfigS2;
+			const cell = (_this$_currentConfigS2 = this._currentConfigService.getUnitData()[item.unitId]) === null || _this$_currentConfigS2 === void 0 || (_this$_currentConfigS2 = _this$_currentConfigS2[item.subUnitId]) === null || _this$_currentConfigS2 === void 0 ? void 0 : _this$_currentConfigS2.cellData.getValue(item.row, item.column);
+			const formula = (item.formula ?? (cell === null || cell === void 0 ? void 0 : cell.f) ?? "").toUpperCase();
+			const requiresRecalculation = formula.includes(`${"INDEX"}(`) && !(formula.includes(`${"LOOKUP"}(`) && !formula.includes(`${"XLOOKUP"}(`));
+			return settings[i].iterativeCalculation && this._preserveCircularUnits.has(item.unitId) && (cell === null || cell === void 0 ? void 0 : cell.v) != null && !requiresRecalculation;
+		})) {
+			for (const tree of group) yield {
+				tree,
+				preserve: true,
+				iteration: 0
+			};
+			this._runtimeService.recordCircularReferences(group.map((item) => ({
+				unitId: item.unitId,
+				sheetId: item.subUnitId,
+				row: item.row,
+				column: item.column,
+				groupId,
+				iterations: 0
+			})));
+			return;
+		}
+		const limit = settings.reduce((limit, setting) => Math.max(limit, setting.iterativeCalculation ? setting.maxIterations : 0), 1);
+		let converged = false;
+		let iterations = 0;
+		const beforeValues = [];
+		const beforeTypes = [];
+		for (let iteration = 0; iteration < limit; iteration++) {
+			for (let i = 0; i < group.length; i++) if (settings[i].iterativeCalculation) {
+				const before = this._getIterationCell(group[i]);
+				beforeValues[i] = before.v;
+				beforeTypes[i] = before.t;
+			}
+			for (let i = 0; i < group.length; i++) if (iteration < (settings[i].iterativeCalculation ? settings[i].maxIterations : 1)) {
+				FORMULA_REF_TO_ARRAY_CACHE.clear();
+				yield {
+					tree: group[i],
+					preserve: !settings[i].iterativeCalculation,
+					iteration
+				};
+			}
+			iterations = iteration + 1;
+			converged = group.every((item, i) => {
+				if (!settings[i].iterativeCalculation) return true;
+				const after = this._getIterationCell(item);
+				const previousValue = beforeValues[i];
+				return typeof after.v === "number" && typeof previousValue === "number" && (after.t == null || after.t === _univerjs_core.CellValueType.NUMBER) && (beforeTypes[i] == null || beforeTypes[i] === _univerjs_core.CellValueType.NUMBER) ? Number.isFinite(after.v) && Math.abs(after.v - previousValue) <= settings[i].maxChange : after.t === beforeTypes[i] && after.v === previousValue;
+			});
+			if (converged) break;
+		}
+		FORMULA_REF_TO_ARRAY_CACHE.clear();
+		this._runtimeService.recordCircularReferences(group.map((item, i) => ({
+			unitId: item.unitId,
+			sheetId: item.subUnitId,
+			row: item.row,
+			column: item.column,
+			groupId,
+			iterations: settings[i].iterativeCalculation ? Math.min(iterations, settings[i].maxIterations) : 0,
+			converged: settings[i].iterativeCalculation ? converged : void 0
+		})));
+	}
+	async *_getCalculationSteps(trees) {
+		while (trees.length) {
+			const tree = trees.pop();
+			if (tree.cycleGroup == null) {
+				yield {
+					tree,
+					preserve: false,
+					iteration: 0
+				};
+				continue;
+			}
+			const group = [tree];
+			while (trees.length && trees[trees.length - 1].cycleGroup === tree.cycleGroup) group.push(trees.pop());
+			yield* this._iterateCalculationGroup(group, tree.cycleGroup);
+		}
+	}
 	constructor(_configService, _lexer, _currentConfigService, _runtimeService, _formulaDependencyGenerator, _interpreter, _astTreeBuilder) {
 		super();
 		this._configService = _configService;
@@ -14882,6 +15197,9 @@ let CalculateFormulaService = class CalculateFormulaService extends _univerjs_co
 		_defineProperty(this, "executionCompleteListener$", this._executionCompleteListener$.asObservable());
 		_defineProperty(this, "_executeLock", new _univerjs_core.AsyncLock());
 		_defineProperty(this, "_isCalculateTreeModel", false);
+		_defineProperty(this, "_workbookCalculationSettings", {});
+		_defineProperty(this, "_preserveCircularUnits", /* @__PURE__ */ new Set());
+		_defineProperty(this, "_normalizedCalculationSettings", /* @__PURE__ */ new Map());
 	}
 	dispose() {
 		super.dispose();
@@ -14917,15 +15235,12 @@ let CalculateFormulaService = class CalculateFormulaService extends _univerjs_co
 			this._executionInProgressListener$.next(this._runtimeService.getRuntimeState());
 			this._currentConfigService.load(formulaDatasetConfig);
 			this._runtimeService.reset();
-			const cycleReferenceCount = formulaDatasetConfig.maxIteration || 1;
+			this._loadCalculationSettings(formulaDatasetConfig.calculationSettings);
+			this._preserveCircularUnits = new Set(formulaDatasetConfig.preserveCircularUnits);
+			this._runtimeService.beginCircularReferences();
 			this._isCalculateTreeModel = formulaDatasetConfig.isCalculateTreeModel || false;
-			for (let i = 0; i < cycleReferenceCount; i++) {
-				this._runtimeService.setFormulaCycleIndex(i);
-				const executed = await this._executeStep();
-				FORMULA_REF_TO_ARRAY_CACHE.clear();
-				const isCycleDependency = this._runtimeService.isCycleDependency();
-				if (!executed || !isCycleDependency) break;
-			}
+			await this._executeStep();
+			this._runtimeService.completeCircularReferences();
 			this._runtimeService.setFormulaExecuteStage(8);
 			this._executionInProgressListener$.next(this._runtimeService.getRuntimeState());
 			this._executionCompleteListener$.next(this._runtimeService.getAllRuntimeData());
@@ -15006,15 +15321,9 @@ let CalculateFormulaService = class CalculateFormulaService extends _univerjs_co
 		const intervalCount = (config === null || config === void 0 ? void 0 : config.intervalCount) || 500;
 		let i = 0;
 		const treeCount = treeList.length;
-		while (treeList.length > 0) {
-			const tree = treeList.pop();
+		for await (const { tree, preserve, iteration } of this._getCalculationSteps(treeList)) {
+			this._runtimeService.setFormulaCycleIndex(iteration);
 			this._runtimeService.setCurrent(tree.row, tree.column, tree.rowCount, tree.columnCount, tree.subUnitId, tree.unitId);
-			const node = generateAstNode(tree.unitId, tree.formula, this._lexer, this._astTreeBuilder, this._currentConfigService, tree.subUnitId, tree.column, tree.row);
-			const nodeData = {
-				node,
-				refOffsetX: tree.refOffsetX,
-				refOffsetY: tree.refOffsetY
-			};
 			const getDirtyData = tree.getDirtyData;
 			if (i % intervalCount === 0) {
 				/**
@@ -15032,12 +15341,23 @@ let CalculateFormulaService = class CalculateFormulaService extends _univerjs_co
 					this._runtimeService.setCompletedFormulasCount(i + 1);
 				}
 				this._executionInProgressListener$.next(this._runtimeService.getRuntimeState());
-				if (this._runtimeService.isStopExecution() || nodeData == null && getDirtyData == null) {
+				if (this._runtimeService.isStopExecution()) {
 					this._runtimeService.setFormulaExecuteStage(0);
 					this._runtimeService.markedAsStopFunctionsExecuted();
 					return;
 				}
 			}
+			if (preserve) {
+				this._runtimeService.preserveCurrentCellData();
+				i++;
+				continue;
+			}
+			const node = generateAstNode(tree.unitId, tree.formula, this._lexer, this._astTreeBuilder, this._currentConfigService, tree.subUnitId, tree.column, tree.row);
+			const nodeData = {
+				node,
+				refOffsetX: tree.refOffsetX,
+				refOffsetY: tree.refOffsetY
+			};
 			let value;
 			if (getDirtyData != null && tree.featureId != null) {
 				/**
@@ -15213,11 +15533,12 @@ let CalculateController = class CalculateController extends _univerjs_core.Dispo
 		}));
 	}
 	async _calculate(formulaDirtyData) {
-		const { forceCalculation: forceCalculate = false, dirtyRanges = [], dirtyNameMap = {}, dirtyDefinedNameMap = {}, dirtySuperTableMap = {}, dirtyUnitFeatureMap = {}, dirtyUnitOtherFormulaMap = {}, clearDependencyTreeCache = {}, maxIteration = 1, rowData, externalReferences, isCalculateTreeModel = false } = formulaDirtyData;
+		const { dirtyIterationUnits, forceCalculation: forceCalculate = false, dirtyRanges = [], dirtyNameMap = {}, dirtyDefinedNameMap = {}, dirtySuperTableMap = {}, dirtyUnitFeatureMap = {}, dirtyUnitOtherFormulaMap = {}, clearDependencyTreeCache = {}, calculationSettings, rowData, externalReferences, isCalculateTreeModel = false } = formulaDirtyData;
 		const formulaData = this._formulaDataModel.getFormulaData();
 		const arrayFormulaCellData = this._formulaDataModel.getArrayFormulaCellData();
 		const arrayFormulaRange = this._formulaDataModel.getArrayFormulaRange();
 		this._calculateFormulaService.execute({
+			dirtyIterationUnits,
 			formulaData,
 			arrayFormulaCellData,
 			arrayFormulaRange,
@@ -15229,7 +15550,7 @@ let CalculateController = class CalculateController extends _univerjs_core.Dispo
 			dirtyUnitFeatureMap,
 			dirtyUnitOtherFormulaMap,
 			clearDependencyTreeCache,
-			maxIteration,
+			calculationSettings,
 			isCalculateTreeModel,
 			rowData,
 			externalReferences
@@ -15277,7 +15598,10 @@ let CalculateController = class CalculateController extends _univerjs_core.Dispo
 					break;
 				case 0:
 			}
-			this._commandService.executeCommand(SetFormulaCalculationNotificationMutation.id, { functionsExecutedState }, { onlyLocal: true });
+			this._commandService.executeCommand(SetFormulaCalculationNotificationMutation.id, {
+				functionsExecutedState,
+				circularReferences: data.circularReferences
+			}, { onlyLocal: true });
 		});
 		/**
 		* Assignment operation after formula calculation.
@@ -21355,13 +21679,13 @@ const weekendNumberMap = {
 	17: [6]
 };
 function isValidWeekend(weekend) {
-	if (typeof weekend === "string" && /^[0|1]{7}/.test(weekend)) return true;
+	if (typeof weekend === "string") return weekend.length === 7 && /^[01]{7}$/.test(weekend);
 	if (weekendNumberMap[Number(weekend)]) return true;
 	return false;
 }
 function getWeekendArray(weekend) {
 	if (!isValidWeekend(weekend)) return [];
-	if (typeof weekend === "string" && /^[0|1]{7}/.test(weekend)) {
+	if (typeof weekend === "string") {
 		const result = [];
 		for (let i = 1; i <= weekend.length; i++) if (`${weekend[i - 1]}` === "1") {
 			if (i === weekend.length) result.push(0);
@@ -29797,7 +30121,8 @@ var Isblank = class extends BaseFunction {
 	}
 	calculate(value) {
 		if (value instanceof BaseReferenceObject) {
-			const array = value.toArrayValueObject(false).mapValue((valueObject) => BooleanValueObject.create(valueObject.isNull()));
+			const { startRow, startColumn } = value.getRangePosition();
+			const array = value.toArrayValueObject(false).mapValue((valueObject, row, column) => BooleanValueObject.create(!valueObject.isError() && value.isCellBlank(startRow + row, startColumn + column)));
 			return array.getRowCount() === 1 && array.getColumnCount() === 1 ? array.getFirstCell() : array;
 		}
 		if (value.isNull()) return BooleanValueObject.create(true);
@@ -32736,7 +33061,7 @@ var Sort = class extends BaseFunction {
 	_getResult(array, sortIndexValue, sortOrderValue, byColValue, arrayRowCount, arrayColumnCount) {
 		if (!byColValue) {
 			if (sortIndexValue > arrayColumnCount) return ErrorValueObject.create("#VALUE!");
-			const arrayValue = array.getArrayValue();
+			const arrayValue = array.getArrayValue().slice();
 			arrayValue.sort(this._sort(sortIndexValue - 1, sortOrderValue));
 			return ArrayValueObject.create({
 				calculateValueList: arrayValue,
@@ -33364,7 +33689,7 @@ var Unique = class extends BaseFunction {
 			const valueObject = item.valueObject;
 			let value = valueObject.getValue();
 			if (valueObject.isNull()) value = null;
-			else if (valueObject.isString() && (0, _univerjs_core.isRealNum)(value)) value = +value;
+			else if (valueObject.isString()) value = (0, _univerjs_core.isRealNum)(value) ? +value : normalizeTextForComparison(value);
 			if (!valueMap.has(value)) valueMap.set(value, [r]);
 			else {
 				const valueMapItem = valueMap.get(value);
@@ -33668,30 +33993,18 @@ var Xlookup = class extends BaseFunction {
 			else resultArray = returnArray.slice(void 0, [0, 1]);
 			if (resultArray == null) return ErrorValueObject.create("#N/A");
 			return lookupValue.map((value) => {
-				const checkErrorCombination = this._checkErrorCombination(matchModeValue, searchModeValue);
-				if (checkErrorCombination) return checkErrorCombination;
-				const result = this._handleSingleObject(value, lookupArray, resultArray, matchModeValue, searchModeValue);
-				if (result.isError()) return ifNotFound;
-				return this._blankResultAsZero(result);
+				return this._getLookupResult(value, lookupArray, resultArray, ifNotFound, matchModeValue, searchModeValue);
 			});
 		}
 		const _lookupValue = lookupValue.isArray() ? lookupValue.get(0, 0) : lookupValue;
-		if (columnCountLookup === columnCountReturn && rowCountLookup === rowCountReturn) {
-			const checkErrorCombination = this._checkErrorCombination(matchModeValue, searchModeValue);
-			if (checkErrorCombination) return checkErrorCombination;
-			const result = this._handleSingleObject(_lookupValue, lookupArray, returnArray, matchModeValue, searchModeValue);
-			if (result.isError()) return ifNotFound;
-			return this._blankResultAsZero(result);
-		}
+		if (columnCountLookup === columnCountReturn && rowCountLookup === rowCountReturn) return this._getLookupResult(_lookupValue, lookupArray, returnArray, ifNotFound, matchModeValue, searchModeValue);
 		let axis = 0;
 		/**
 		* 0 for rows
 		* 1 for columns
 		*/
 		if (columnCountLookup === columnCountReturn) axis = 1;
-		const resultArray = this._handleExpandObject(_lookupValue, lookupArray, returnArray, matchModeValue, searchModeValue, axis);
-		if (resultArray == null) return ErrorValueObject.create("#N/A");
-		return resultArray;
+		return this._getLookupResult(_lookupValue, lookupArray, returnArray, ifNotFound, matchModeValue, searchModeValue, axis);
 	}
 	_legacyImplicitLookupValue(lookupValue) {
 		if (!lookupValue.isArray()) return lookupValue;
@@ -33719,35 +34032,37 @@ var Xlookup = class extends BaseFunction {
 		if (rowIndex < 0 || rowIndex >= rowCount || columnIndex < 0 || columnIndex >= columnCount) return ErrorValueObject.create("#VALUE!");
 		return array.get(rowIndex, columnIndex) || ErrorValueObject.create("#VALUE!");
 	}
-	_handleExpandObject(value, searchArray, resultArray, matchModeValue, searchModeValue, axis = 0) {
+	_getLookupResult(value, searchArray, resultArray, ifNotFound, matchModeValue, searchModeValue, axis) {
+		if (value.isError()) return value;
+		const checkErrorCombination = this._checkErrorCombination(matchModeValue, searchModeValue);
+		if (checkErrorCombination) return checkErrorCombination;
+		const position = this._findPosition(value, searchArray, matchModeValue, searchModeValue);
+		if (position == null) return ifNotFound;
+		if (axis === 0) return resultArray.slice([position.row, position.row + 1]) ?? ErrorValueObject.create("#N/A");
+		if (axis === 1) return resultArray.slice(void 0, [position.column, position.column + 1]) ?? ErrorValueObject.create("#N/A");
+		const result = resultArray.get(position.row, position.column) ?? NullValueObject.create();
+		return this._blankResultAsZero(result);
+	}
+	_findPosition(value, searchArray, matchModeValue, searchModeValue) {
 		if ((searchModeValue === 2 || searchModeValue === -2) && matchModeValue !== 2) {
 			const searchType = getSearchModeValue(searchModeValue);
 			const matchType = getMatchModeValue(matchModeValue);
-			return this.binarySearchExpand(value, searchArray, resultArray, axis, searchType, matchType);
+			const rowOrColumn = searchArray.binarySearch(value, searchType, matchType);
+			if (rowOrColumn == null) return null;
+			return searchArray.getRowCount() === 1 ? {
+				row: 0,
+				column: rowOrColumn
+			} : {
+				row: rowOrColumn,
+				column: 0
+			};
 		}
-		if (matchModeValue === 2) return this.fuzzySearchExpand(value, searchArray, resultArray, searchModeValue !== -1, axis);
-		if (matchModeValue === -1 || matchModeValue === 1) return this.orderSearchExpand(value, searchArray, resultArray, matchModeValue === 1 ? 2 : 1, searchModeValue === -1, axis, true);
-		return this._exactSearchExpand(value, searchArray, resultArray, searchModeValue !== -1, axis);
-	}
-	_handleSingleObject(value, searchArray, resultArray, matchModeValue, searchModeValue) {
-		if ((searchModeValue === 2 || searchModeValue === -2) && matchModeValue !== 2) {
-			const searchType = getSearchModeValue(searchModeValue);
-			const matchType = getMatchModeValue(matchModeValue);
-			return this.binarySearch(value, searchArray, resultArray, searchType, matchType);
+		if (matchModeValue === 2) {
+			const matches = searchArray.compare(value, "=");
+			return searchModeValue === -1 ? matches.getLastTruePosition() : matches.getFirstTruePosition();
 		}
-		if (matchModeValue === 2) return this.fuzzySearch(value, searchArray, resultArray, searchModeValue !== -1);
-		if (matchModeValue === -1 || matchModeValue === 1) return this.orderSearch(value, searchArray, resultArray, matchModeValue === 1 ? 2 : 1, searchModeValue === -1, true);
-		return this._exactSearch(value, searchArray, resultArray, searchModeValue !== -1);
-	}
-	_exactSearch(value, searchArray, resultArray, isFirst) {
-		const position = this._findExactPosition(value, searchArray, isFirst);
-		if (position == null) return ErrorValueObject.create("#N/A");
-		return resultArray.get(position.row, position.column) ?? ErrorValueObject.create("#N/A");
-	}
-	_exactSearchExpand(value, searchArray, resultArray, isFirst, axis) {
-		const position = this._findExactPosition(value, searchArray, isFirst);
-		if (position == null) return ErrorValueObject.create("#N/A");
-		return axis === 0 ? resultArray.slice([position.row, position.row + 1]) ?? ErrorValueObject.create("#N/A") : resultArray.slice(void 0, [position.column, position.column + 1]) ?? ErrorValueObject.create("#N/A");
+		if (matchModeValue === -1 || matchModeValue === 1) return searchArray.orderSearch(value, matchModeValue === 1 ? 2 : 1, searchModeValue === -1, false, true);
+		return this._findExactPosition(value, searchArray, searchModeValue !== -1);
 	}
 	_findExactPosition(value, searchArray, isFirst) {
 		let position;
@@ -37206,7 +37521,7 @@ var Average = class extends BaseFunction {
 	_legacyImplicitDerivedArray(variant) {
 		if (!variant.isArray()) return variant;
 		const array = variant;
-		if (array.usesInvertedIndexCache()) return variant;
+		if (array.usesInvertedIndexCache() || !array.usesLegacyImplicitForAggregate()) return variant;
 		const startRow = array.getCurrentRow();
 		const startColumn = array.getCurrentColumn();
 		if (startRow < 0 || startColumn < 0) return variant;
@@ -41825,7 +42140,7 @@ var Proper = class extends BaseFunction {
 	}
 	_handleSingleObject(text) {
 		if (text.isError() || text.isNull() || text.isBoolean() || text.isNumber()) return text;
-		const result = text.getValue().toLocaleString().toLocaleLowerCase().replace(/(^|\b|\W|\d|_)[a-z]/g, (txt) => txt.toLocaleUpperCase());
+		const result = text.getValue().toLocaleString().toLocaleLowerCase().replace(/(^|[^\p{L}])(\p{L})/gu, (_, before, letter) => before + letter.toLocaleUpperCase());
 		return StringValueObject.create(result);
 	}
 };
@@ -43774,7 +44089,7 @@ function getObjectValue(result, isUseStrip = false) {
 //#endregion
 //#region package.json
 var name = "@univerjs/engine-formula";
-var version = "1.0.4";
+var version = "1.2.0";
 
 //#endregion
 //#region src/services/global-computing-status.service.ts
@@ -43860,6 +44175,7 @@ let FormulaCalculationTriggerService = class FormulaCalculationTriggerService ex
 		_defineProperty(this, "_executionInProgress", false);
 		_defineProperty(this, "_hasPendingCalculation", false);
 		_defineProperty(this, "_stopRequested", false);
+		_defineProperty(this, "_suppressed", false);
 		this._registerGenericDirtyConversions();
 		this._initialize();
 	}
@@ -43868,6 +44184,16 @@ let FormulaCalculationTriggerService = class FormulaCalculationTriggerService ex
 		this._started = true;
 		this._scheduleFlush();
 	}
+	/** Snapshot reconstruction calculates these synchronous mutations in its isolated runtime. */
+	runWithoutTriggering(operation) {
+		const previous = this._suppressed;
+		this._suppressed = true;
+		try {
+			return operation();
+		} finally {
+			this._suppressed = previous;
+		}
+	}
 	dispose() {
 		clearTimeout(this._timer);
 		this._waitingCommandQueue = [];
@@ -43887,7 +44213,7 @@ let FormulaCalculationTriggerService = class FormulaCalculationTriggerService ex
 				return;
 			}
 			const conversion = this._activeDirtyManagerService.get(command.id);
-			if (!conversion) return;
+			if (!conversion || this._suppressed) return;
 			if (((_conversion$shouldTri = conversion.shouldTrigger) === null || _conversion$shouldTri === void 0 ? void 0 : _conversion$shouldTri.call(conversion, command, options)) === false) return;
 			this._waitingCommandQueue.push(command);
 			this._scheduleFlush();
@@ -43976,6 +44302,8 @@ function mergeDirtyData(left, right) {
 	return result;
 }
 function appendDirtyData(target, source, rangeKeys) {
+	var _source$dirtyIteratio;
+	if ((_source$dirtyIteratio = source.dirtyIterationUnits) === null || _source$dirtyIteratio === void 0 ? void 0 : _source$dirtyIteratio.length) target.dirtyIterationUnits = Array.from(/* @__PURE__ */ new Set([...target.dirtyIterationUnits ?? [], ...source.dirtyIterationUnits]));
 	mergeDirtyRanges(target.dirtyRanges, source.dirtyRanges ?? [], rangeKeys);
 	mergeDirtyUnitStringMap(target.dirtyNameMap, source.dirtyNameMap);
 	mergeDirtyUnitStringMap(target.dirtyDefinedNameMap, source.dirtyDefinedNameMap);
@@ -44019,7 +44347,8 @@ function mergeDirtyUnitNestedMap(target, right) {
 	});
 }
 function hasDirtyData(dirtyData) {
-	return dirtyData.forceCalculation || dirtyData.dirtyRanges.length > 0 || hasNestedValue(dirtyData.dirtyNameMap) || hasNestedValue(dirtyData.dirtyDefinedNameMap) || hasNestedValue(dirtyData.dirtySuperTableMap) || hasNestedValue(dirtyData.dirtyUnitFeatureMap) || hasNestedValue(dirtyData.dirtyUnitOtherFormulaMap) || hasNestedValue(dirtyData.clearDependencyTreeCache);
+	var _dirtyData$dirtyItera;
+	return dirtyData.forceCalculation || Boolean((_dirtyData$dirtyItera = dirtyData.dirtyIterationUnits) === null || _dirtyData$dirtyItera === void 0 ? void 0 : _dirtyData$dirtyItera.length) || dirtyData.dirtyRanges.length > 0 || hasNestedValue(dirtyData.dirtyNameMap) || hasNestedValue(dirtyData.dirtyDefinedNameMap) || hasNestedValue(dirtyData.dirtySuperTableMap) || hasNestedValue(dirtyData.dirtyUnitFeatureMap) || hasNestedValue(dirtyData.dirtyUnitOtherFormulaMap) || hasNestedValue(dirtyData.clearDependencyTreeCache);
 }
 function hasNestedValue(value) {
 	if (value == null) return false;
@@ -44027,7 +44356,8 @@ function hasNestedValue(value) {
 	return Object.values(value).some(hasNestedValue);
 }
 function dirtyDataIntersects(left, right) {
-	if (left.forceCalculation || right.forceCalculation) return true;
+	var _left$dirtyIterationU, _right$dirtyIteration;
+	if (left.forceCalculation || right.forceCalculation || ((_left$dirtyIterationU = left.dirtyIterationUnits) === null || _left$dirtyIterationU === void 0 ? void 0 : _left$dirtyIterationU.length) || ((_right$dirtyIteration = right.dirtyIterationUnits) === null || _right$dirtyIteration === void 0 ? void 0 : _right$dirtyIteration.length)) return true;
 	if (left.dirtyRanges.some((leftRange) => right.dirtyRanges.some((rightRange) => leftRange.unitId === rightRange.unitId && leftRange.sheetId === rightRange.sheetId && _univerjs_core.Rectangle.intersects(leftRange.range, rightRange.range))) || clearedSheetIntersects(left, right) || clearedSheetIntersects(right, left)) return true;
 	return [
 		[left.dirtyNameMap, right.dirtyNameMap],
@@ -57475,13 +57805,17 @@ _defineProperty(UniverFormulaEnginePlugin, "packageName", name);
 _defineProperty(UniverFormulaEnginePlugin, "version", version);
 UniverFormulaEnginePlugin = __decorate([__decorateParam(1, (0, _univerjs_core.Inject)(_univerjs_core.Injector)), __decorateParam(2, _univerjs_core.IConfigService)], UniverFormulaEnginePlugin);
 
+//#endregion
+//#region src/services/formula-changeset-calculation.service.ts
+const IFormulaChangesetCalculationService = (0, _univerjs_core.createIdentifier)("engine-formula.changeset-calculation.service");
+
 //#endregion
 exports.ALL_IMPLEMENTED_FUNCTIONS = ALL_IMPLEMENTED_FUNCTIONS;
 exports.ALL_IMPLEMENTED_FUNCTIONS_SET = ALL_IMPLEMENTED_FUNCTIONS_SET;
 exports.ActiveDirtyManagerService = ActiveDirtyManagerService;
 exports.ArrayValueObject = ArrayValueObject;
 exports.AstRootNodeFactory = AstRootNodeFactory;
-Object.defineProperty(exports, 'AstTreeBuilder', {
+Object.defineProperty(exports, "AstTreeBuilder", {
   enumerable: true,
   get: function () {
     return AstTreeBuilder;
@@ -57496,27 +57830,26 @@ exports.BaseValueObject = BaseValueObject;
 exports.BooleanValue = BooleanValue;
 exports.BooleanValueObject = BooleanValueObject;
 exports.CELL_INVERTED_INDEX_CACHE = CELL_INVERTED_INDEX_CACHE;
-Object.defineProperty(exports, 'CalculateController', {
+Object.defineProperty(exports, "CalculateController", {
   enumerable: true,
   get: function () {
     return CalculateController;
   }
 });
-Object.defineProperty(exports, 'CalculateFormulaService', {
+Object.defineProperty(exports, "CalculateFormulaService", {
   enumerable: true,
   get: function () {
     return CalculateFormulaService;
   }
 });
 exports.CustomFunction = CustomFunction;
-exports.DEFAULT_CYCLE_REFERENCE_COUNT = DEFAULT_CYCLE_REFERENCE_COUNT;
 exports.DEFAULT_INTERVAL_COUNT = DEFAULT_INTERVAL_COUNT;
 exports.DEFAULT_TOKEN_LAMBDA_FUNCTION_NAME = DEFAULT_TOKEN_LAMBDA_FUNCTION_NAME;
 exports.DEFAULT_TOKEN_LET_FUNCTION_NAME = DEFAULT_TOKEN_LET_FUNCTION_NAME;
 exports.DEFAULT_TOKEN_TYPE_LAMBDA_PARAMETER = DEFAULT_TOKEN_TYPE_LAMBDA_PARAMETER;
 exports.DEFAULT_TOKEN_TYPE_PARAMETER = DEFAULT_TOKEN_TYPE_PARAMETER;
 exports.DEFAULT_TOKEN_TYPE_ROOT = DEFAULT_TOKEN_TYPE_ROOT;
-Object.defineProperty(exports, 'DefinedNamesService', {
+Object.defineProperty(exports, "DefinedNamesService", {
   enumerable: true,
   get: function () {
     return DefinedNamesService;
@@ -57524,13 +57857,12 @@ Object.defineProperty(exports, 'DefinedNamesService', {
 });
 exports.DependencyManagerBaseService = DependencyManagerBaseService;
 exports.DependencyManagerService = DependencyManagerService;
-Object.defineProperty(exports, 'DescriptionService', {
+Object.defineProperty(exports, "DescriptionService", {
   enumerable: true,
   get: function () {
     return DescriptionService;
   }
 });
-exports.ENGINE_FORMULA_CYCLE_REFERENCE_COUNT = ENGINE_FORMULA_CYCLE_REFERENCE_COUNT;
 exports.ENGINE_FORMULA_PLUGIN_CONFIG_KEY = ENGINE_FORMULA_PLUGIN_CONFIG_KEY;
 exports.ENGINE_FORMULA_RETURN_DEPENDENCY_TREE = ENGINE_FORMULA_RETURN_DEPENDENCY_TREE;
 exports.ERROR_TYPE_SET = ERROR_TYPE_SET;
@@ -57569,32 +57901,32 @@ exports.FUNCTION_NAMES_TEXT = FUNCTION_NAMES_TEXT;
 exports.FUNCTION_NAMES_UNIVER = FUNCTION_NAMES_UNIVER;
 exports.FUNCTION_NAMES_WEB = FUNCTION_NAMES_WEB;
 exports.FeatureCalculationManagerService = FeatureCalculationManagerService;
-Object.defineProperty(exports, 'FormulaCalculationSessionController', {
+Object.defineProperty(exports, "FormulaCalculationSessionController", {
   enumerable: true,
   get: function () {
     return FormulaCalculationSessionController;
   }
 });
 exports.FormulaCalculationSessionService = FormulaCalculationSessionService;
-Object.defineProperty(exports, 'FormulaCalculationTriggerService', {
+Object.defineProperty(exports, "FormulaCalculationTriggerService", {
   enumerable: true,
   get: function () {
     return FormulaCalculationTriggerService;
   }
 });
-Object.defineProperty(exports, 'FormulaCurrentConfigService', {
+Object.defineProperty(exports, "FormulaCurrentConfigService", {
   enumerable: true,
   get: function () {
     return FormulaCurrentConfigService;
   }
 });
-Object.defineProperty(exports, 'FormulaDataModel', {
+Object.defineProperty(exports, "FormulaDataModel", {
   enumerable: true,
   get: function () {
     return FormulaDataModel;
   }
 });
-Object.defineProperty(exports, 'FormulaDependencyGenerator', {
+Object.defineProperty(exports, "FormulaDependencyGenerator", {
   enumerable: true,
   get: function () {
     return FormulaDependencyGenerator;
@@ -57608,19 +57940,19 @@ exports.FormulaExecuteStageType = FormulaExecuteStageType;
 exports.FormulaExecutedStateType = FormulaExecutedStateType;
 exports.FormulaResultApplicationType = FormulaResultApplicationType;
 exports.FormulaResultStatus = FormulaResultStatus;
-Object.defineProperty(exports, 'FormulaRuntimeService', {
+Object.defineProperty(exports, "FormulaRuntimeService", {
   enumerable: true,
   get: function () {
     return FormulaRuntimeService;
   }
 });
-Object.defineProperty(exports, 'FormulaUnitReferenceResolver', {
+Object.defineProperty(exports, "FormulaUnitReferenceResolver", {
   enumerable: true,
   get: function () {
     return FormulaUnitReferenceResolver;
   }
 });
-Object.defineProperty(exports, 'FunctionNodeFactory', {
+Object.defineProperty(exports, "FunctionNodeFactory", {
   enumerable: true,
   get: function () {
     return FunctionNodeFactory;
@@ -57629,7 +57961,7 @@ Object.defineProperty(exports, 'FunctionNodeFactory', {
 exports.FunctionService = FunctionService;
 exports.FunctionType = FunctionType;
 exports.GlobalComputingStatusService = GlobalComputingStatusService;
-Object.defineProperty(exports, 'HyperlinkEngineFormulaService', {
+Object.defineProperty(exports, "HyperlinkEngineFormulaService", {
   enumerable: true,
   get: function () {
     return HyperlinkEngineFormulaService;
@@ -57641,6 +57973,7 @@ exports.IDefinedNamesService = IDefinedNamesService;
 exports.IDependencyManagerService = IDependencyManagerService;
 exports.IDescriptionService = IDescriptionService;
 exports.IFeatureCalculationManagerService = IFeatureCalculationManagerService;
+exports.IFormulaChangesetCalculationService = IFormulaChangesetCalculationService;
 exports.IFormulaCurrentConfigService = IFormulaCurrentConfigService;
 exports.IFormulaDependencyGenerator = IFormulaDependencyGenerator;
 exports.IFormulaExternalReferenceDataLoader = IFormulaExternalReferenceDataLoader;
@@ -57652,13 +57985,13 @@ exports.IOtherFormulaManagerService = IOtherFormulaManagerService;
 exports.IRegisterFunctionService = IRegisterFunctionService;
 exports.ISheetRowFilteredService = ISheetRowFilteredService;
 exports.ISuperTableService = ISuperTableService;
-Object.defineProperty(exports, 'Interpreter', {
+Object.defineProperty(exports, "Interpreter", {
   enumerable: true,
   get: function () {
     return Interpreter;
   }
 });
-Object.defineProperty(exports, 'LambdaNodeFactory', {
+Object.defineProperty(exports, "LambdaNodeFactory", {
   enumerable: true,
   get: function () {
     return LambdaNodeFactory;
@@ -57666,7 +57999,7 @@ Object.defineProperty(exports, 'LambdaNodeFactory', {
 });
 exports.LambdaParameterNodeFactory = LambdaParameterNodeFactory;
 exports.LambdaValueObjectObject = LambdaValueObjectObject;
-Object.defineProperty(exports, 'Lexer', {
+Object.defineProperty(exports, "Lexer", {
   enumerable: true,
   get: function () {
     return Lexer;
@@ -57679,7 +58012,7 @@ exports.NoopFormulaExternalReferenceDataLoader = NoopFormulaExternalReferenceDat
 exports.NullValueObject = NullValueObject;
 exports.NumberValueObject = NumberValueObject;
 exports.OPERATOR_TOKEN_SET = OPERATOR_TOKEN_SET;
-Object.defineProperty(exports, 'OperatorNodeFactory', {
+Object.defineProperty(exports, "OperatorNodeFactory", {
   enumerable: true,
   get: function () {
     return OperatorNodeFactory;
@@ -57688,27 +58021,27 @@ Object.defineProperty(exports, 'OperatorNodeFactory', {
 exports.OtherFormulaBizType = OtherFormulaBizType;
 exports.OtherFormulaManagerService = OtherFormulaManagerService;
 exports.OtherFormulaMarkDirty = OtherFormulaMarkDirty;
-Object.defineProperty(exports, 'PrefixNodeFactory', {
+Object.defineProperty(exports, "PrefixNodeFactory", {
   enumerable: true,
   get: function () {
     return PrefixNodeFactory;
   }
 });
 exports.RangeReferenceObject = RangeReferenceObject;
-Object.defineProperty(exports, 'ReferenceNodeFactory', {
+Object.defineProperty(exports, "ReferenceNodeFactory", {
   enumerable: true,
   get: function () {
     return ReferenceNodeFactory;
   }
 });
 exports.RegisterFunctionMutation = RegisterFunctionMutation;
-Object.defineProperty(exports, 'RegisterFunctionService', {
+Object.defineProperty(exports, "RegisterFunctionService", {
   enumerable: true,
   get: function () {
     return RegisterFunctionService;
   }
 });
-Object.defineProperty(exports, 'RegisterOtherFormulaService', {
+Object.defineProperty(exports, "RegisterOtherFormulaService", {
   enumerable: true,
   get: function () {
     return RegisterOtherFormulaService;
@@ -57745,26 +58078,26 @@ exports.SetSuperTableOptionMutation = SetSuperTableOptionMutation;
 exports.SetTriggerFormulaCalculationStartMutation = SetTriggerFormulaCalculationStartMutation;
 exports.SheetRowFilteredService = SheetRowFilteredService;
 exports.StringValueObject = StringValueObject;
-Object.defineProperty(exports, 'SuffixNodeFactory', {
+Object.defineProperty(exports, "SuffixNodeFactory", {
   enumerable: true,
   get: function () {
     return SuffixNodeFactory;
   }
 });
-Object.defineProperty(exports, 'SuperTableActiveDirtyController', {
+Object.defineProperty(exports, "SuperTableActiveDirtyController", {
   enumerable: true,
   get: function () {
     return SuperTableActiveDirtyController;
   }
 });
 exports.SuperTableService = SuperTableService;
-Object.defineProperty(exports, 'UnionNodeFactory', {
+Object.defineProperty(exports, "UnionNodeFactory", {
   enumerable: true,
   get: function () {
     return UnionNodeFactory;
   }
 });
-Object.defineProperty(exports, 'UniverFormulaEnginePlugin', {
+Object.defineProperty(exports, "UniverFormulaEnginePlugin", {
   enumerable: true,
   get: function () {
     return UniverFormulaEnginePlugin;
@@ -57823,6 +58156,7 @@ exports.isReferenceStringWithEffectiveColumn = isReferenceStringWithEffectiveCol
 exports.isReferenceStrings = isReferenceStrings;
 exports.matchRefDrawToken = matchRefDrawToken;
 exports.matchToken = matchToken;
+exports.mergeDirtyData = mergeDirtyData;
 exports.needsQuoting = needsQuoting;
 exports.normalizeFormulaUnitName = normalizeFormulaUnitName;
 exports.normalizeSheetName = normalizeSheetName;