@univerjs/engine-formula 1.0.0-alpha.3 → 1.0.0-alpha.5

package/lib/es/index.js

@@ -1,6 +1,6 @@
-import { AbsoluteRefType, AsyncLock, BooleanNumber, BuildTextUtils, CellValueType, CommandType, DataStreamTreeTokenType, Disposable, DisposableCollection, ICommandService, IConfigService, IUniverInstanceService, Inject, Injector, LRUMap, LifecycleService, LocaleService, LocaleType, MAX_COLUMN_COUNT, MAX_ROW_COUNT, ObjectMatrix, Optional, Plugin, RANGE_TYPE, RTree, Rectangle, RichTextBuilder, Styles, Tools, UniverInstanceType, cellToRange, columnLabelToNumber, createIdentifier, generateRandomId, getNumfmtParseValueFilter, hashAlgorithm, isFormulaId, isFormulaString, isNullCell, isRealNum, isTextFormat, isValidRange, merge, moveRangeByOffset, numfmt, regexp, requestImmediateMacroTask, sortRules, toDisposable, touchDependencies } from "@univerjs/core";
+import { AbsoluteRefType, AsyncLock, BooleanNumber, BuildTextUtils, CellValueType, CommandType, DataStreamTreeTokenType, Disposable, DisposableCollection, ICommandService, IConfigService, IUniverInstanceService, Inject, Injector, LRUMap, LifecycleService, LifecycleStages, LocaleService, LocaleType, MAX_COLUMN_COUNT, MAX_ROW_COUNT, ObjectMatrix, Optional, Plugin, RANGE_TYPE, RTree, Rectangle, RichTextBuilder, Styles, Tools, UniverInstanceType, cellToRange, columnLabelToNumber, createIdentifier, generateRandomId, getNumfmtParseValueFilter, hashAlgorithm, isFormulaId, isFormulaString, isNodeEnv, isNullCell, isRealNum, isTextFormat, isValidRange, merge, moveRangeByOffset, numfmt, regexp, requestImmediateMacroTask, sortRules, toDisposable, touchDependencies } from "@univerjs/core";
 import IntervalTree from "@flatten-js/interval-tree";
-import { BehaviorSubject, Observable, Subject, bufferWhen, combineLatest, distinctUntilChanged, filter, map, shareReplay, skip } from "rxjs";
+import { BehaviorSubject, Observable, Subject, bufferWhen, combineLatest, distinctUntilChanged, filter, map, shareReplay, skip, take } from "rxjs";
 import Decimal from "decimal.js";
 import { DataSyncPrimaryController } from "@univerjs/rpc";
 
@@ -1453,10 +1453,11 @@ const TABLE_NAME_REGEX = "((?![~!@#$%^&*()_+<>?:,./;’，。、‘：“《》
 const TABLE_TITLE_REGEX = "\\[#.+\\]\\s*?,\\s*?";
 const TABLE_CONTENT_REGEX = "\\[((?<!#)[\\s\\S])*\\]";
 const TABLE_MULTIPLE_COLUMN_REGEX = `${TABLE_CONTENT_REGEX}${RANGE_SYMBOL}${TABLE_CONTENT_REGEX}`;
-const REFERENCE_TABLE_ALL_COLUMN_REGEX = `^(${UNIT_NAME_REGEX})?${TABLE_NAME_REGEX}$`;
-const REFERENCE_TABLE_SINGLE_COLUMN_REGEX = `^(${UNIT_NAME_REGEX})?${TABLE_NAME_REGEX}(${TABLE_CONTENT_REGEX}|\\[${TABLE_TITLE_REGEX}${TABLE_CONTENT_REGEX}\\])+$`;
-const REFERENCE_TABLE_MULTIPLE_COLUMN_REGEX = `^(${UNIT_NAME_REGEX})?${TABLE_NAME_REGEX}(\\[${TABLE_MULTIPLE_COLUMN_REGEX}\\])?$|^${TABLE_NAME_REGEX}(\\[${TABLE_TITLE_REGEX}${TABLE_MULTIPLE_COLUMN_REGEX}\\])?$`;
-const REFERENCE_TABLE_TITLE_ONLY_ANY_HASH_REGEX = `^(${UNIT_NAME_REGEX})?${TABLE_NAME_REGEX}\\[\\s*#([^\\]]+)\\s*\\]$`;
+const TABLE_UNIT_QUALIFIER_REGEX = `(?:(?:${UNIT_NAME_REGEX}|'(?:[^']|'')+'|[^\\s!\\[\\]]+)!)?(?:${UNIT_NAME_REGEX})?`;
+const REFERENCE_TABLE_ALL_COLUMN_REGEX = `^${TABLE_UNIT_QUALIFIER_REGEX}${TABLE_NAME_REGEX}$`;
+const REFERENCE_TABLE_SINGLE_COLUMN_REGEX = `^${TABLE_UNIT_QUALIFIER_REGEX}${TABLE_NAME_REGEX}(${TABLE_CONTENT_REGEX}|\\[${TABLE_TITLE_REGEX}${TABLE_CONTENT_REGEX}\\])+$`;
+const REFERENCE_TABLE_MULTIPLE_COLUMN_REGEX = `^${TABLE_UNIT_QUALIFIER_REGEX}${TABLE_NAME_REGEX}(\\[${TABLE_MULTIPLE_COLUMN_REGEX}\\])?$|^${TABLE_UNIT_QUALIFIER_REGEX}${TABLE_NAME_REGEX}(\\[${TABLE_TITLE_REGEX}${TABLE_MULTIPLE_COLUMN_REGEX}\\])?$`;
+const REFERENCE_TABLE_TITLE_ONLY_ANY_HASH_REGEX = `^${TABLE_UNIT_QUALIFIER_REGEX}${TABLE_NAME_REGEX}\\[\\s*#([^\\]]+)\\s*\\]$`;
 const REFERENCE_TABLE_ALL_COLUMN_REGEX_PRECOMPILING = new RegExp(REFERENCE_TABLE_ALL_COLUMN_REGEX);
 const REFERENCE_TABLE_SINGLE_COLUMN_REGEX_PRECOMPILING = new RegExp(REFERENCE_TABLE_SINGLE_COLUMN_REGEX);
 const REFERENCE_TABLE_MULTIPLE_COLUMN_REGEX_PRECOMPILING = new RegExp(REFERENCE_TABLE_MULTIPLE_COLUMN_REGEX);
@@ -1707,10 +1708,10 @@ function singleReferenceToGrid(refBody) {
 }
 function handleRefStringInfo(refString) {
 	const unitIdMatch = UNIT_NAME_REGEX_PRECOMPILING.exec(refString);
-	let unitId = "";
+	let unitQualifier = "";
 	if (unitIdMatch != null) {
-		unitId = unitIdMatch[0].trim();
-		unitId = unquoteSheetName(unitId.slice(1, unitId.length - 1));
+		unitQualifier = unitIdMatch[0].trim();
+		unitQualifier = unquoteSheetName(unitQualifier.slice(1, unitQualifier.length - 1));
 		refString = refString.replace(UNIT_NAME_REGEX_PRECOMPILING, "");
 	}
 	const sheetNameIndex = refString.indexOf("!");
@@ -1725,11 +1726,13 @@ function handleRefStringInfo(refString) {
 	return {
 		refBody,
 		sheetName,
-		unitId
+		unitQualifier,
+		/** @deprecated Use unitQualifier. Kept for reference-grid compatibility. */
+		unitId: unitQualifier
 	};
 }
 function deserializeRangeWithSheet(refString) {
-	const { refBody, sheetName, unitId } = handleRefStringInfo(refString);
+	const { refBody, sheetName, unitQualifier } = handleRefStringInfo(refString);
 	const colonIndex = refBody.indexOf(":");
 	if (colonIndex === -1) {
 		const grid = singleReferenceToGrid(refBody);
@@ -1737,7 +1740,7 @@ function deserializeRangeWithSheet(refString) {
 		const column = grid.column;
 		const absoluteRefType = grid.absoluteRefType;
 		return {
-			unitId,
+			unitId: unitQualifier,
 			sheetName,
 			range: {
 				startRow: row,
@@ -1761,7 +1764,7 @@ function deserializeRangeWithSheet(refString) {
 	if (Number.isNaN(startRow) && Number.isNaN(endRow)) rangeType = RANGE_TYPE.COLUMN;
 	else if (Number.isNaN(startColumn) && Number.isNaN(endColumn)) rangeType = RANGE_TYPE.ROW;
 	return {
-		unitId,
+		unitId: unitQualifier,
 		sheetName,
 		range: {
 			startRow,
@@ -1895,14 +1898,49 @@ function startsWithNonAlphabetic(name) {
 	return !/^\p{Letter}/u.test(name.charAt(0));
 }
 function splitTableStructuredRef(ref) {
-	const idx = ref.indexOf("[");
+	let unitQualifier = "";
+	let tableRef = ref.trim();
+	let quoteOpen = false;
+	let bracketDepth = 0;
+	let qualifierEnd = -1;
+	for (let i = 0; i < tableRef.length; i++) {
+		const char = tableRef[i];
+		if (char === "'") {
+			if (quoteOpen && tableRef[i + 1] === "'") {
+				i++;
+				continue;
+			}
+			quoteOpen = !quoteOpen;
+		} else if (!quoteOpen && char === "[") bracketDepth++;
+		else if (!quoteOpen && char === "]") bracketDepth--;
+		else if (!quoteOpen && bracketDepth === 0 && char === "!") {
+			qualifierEnd = i;
+			break;
+		}
+	}
+	if (qualifierEnd >= 0) {
+		unitQualifier = tableRef.slice(0, qualifierEnd).trim();
+		tableRef = tableRef.slice(qualifierEnd + 1);
+		if (unitQualifier.startsWith("'") && unitQualifier.endsWith("'")) unitQualifier = unitQualifier.slice(1, -1);
+		if (unitQualifier.startsWith("[") && unitQualifier.endsWith("]")) unitQualifier = unitQualifier.slice(1, -1);
+		unitQualifier = unquoteSheetName(unitQualifier);
+	} else if (tableRef.startsWith("[")) {
+		const legacyQualifierEnd = tableRef.indexOf("]");
+		if (legacyQualifierEnd > 0) {
+			unitQualifier = unquoteSheetName(tableRef.slice(1, legacyQualifierEnd));
+			tableRef = tableRef.slice(legacyQualifierEnd + 1);
+		}
+	}
+	const idx = tableRef.indexOf("[");
 	if (idx === -1) return {
-		tableName: ref,
-		struct: ""
+		unitQualifier,
+		tableName: tableRef,
+		columnStruct: ""
 	};
 	return {
-		tableName: ref.slice(0, idx),
-		columnStruct: ref.slice(idx)
+		unitQualifier,
+		tableName: tableRef.slice(0, idx),
+		columnStruct: tableRef.slice(idx)
 	};
 }
 
@@ -5130,8 +5168,13 @@ let FormulaDataModel = class FormulaDataModel extends Disposable {
 		const allUnitData = {};
 		const unitStylesData = {};
 		const unitSheetNameMap = {};
+		const unitNameMap = {};
 		for (const workbook of unitAllSheet) {
 			const unitId = workbook.getUnitId();
+			unitNameMap[unitId] = {
+				name: workbook.name,
+				unitType: UniverInstanceType.UNIVER_SHEET
+			};
 			const sheets = workbook.getSheets();
 			const sheetData = {};
 			const sheetNameMap = {};
@@ -5157,6 +5200,10 @@ let FormulaDataModel = class FormulaDataModel extends Disposable {
 		for (const base of unitAllBases) {
 			const snapshot = base.getSnapshot();
 			const unitId = base.getUnitId();
+			unitNameMap[unitId] = {
+				name: snapshot.name,
+				unitType: UniverInstanceType.UNIVER_BASE
+			};
 			const baseData = {};
 			const tableNameMap = {};
 			for (const table of Object.values(snapshot.tables)) {
@@ -5177,7 +5224,8 @@ let FormulaDataModel = class FormulaDataModel extends Disposable {
 		return {
 			allUnitData,
 			unitStylesData,
-			unitSheetNameMap
+			unitSheetNameMap,
+			unitNameMap
 		};
 	}
 	/**
@@ -5205,18 +5253,51 @@ let FormulaDataModel = class FormulaDataModel extends Disposable {
 		return rowData;
 	}
 	updateFormulaData(unitId, sheetId, cellValue) {
+		var _this$_univerInstance, _formulaData$unitId$s, _formulaData$unitId;
 		const cellMatrix = new ObjectMatrix(cellValue);
-		const formulaIdMap = this._getSheetFormulaIdMap(unitId, sheetId);
-		const deleteFormulaIdMap = /* @__PURE__ */ new Map();
-		const formulaData = this.getFormulaData();
-		if (formulaData[unitId] == null) formulaData[unitId] = {};
-		const workbookFormulaData = formulaData[unitId];
-		if (workbookFormulaData[sheetId] == null) workbookFormulaData[sheetId] = {};
-		const sheetFormulaDataMatrix = new ObjectMatrix(workbookFormulaData[sheetId] || {});
 		const newSheetFormulaDataMatrix = new ObjectMatrix();
+		const worksheetCellMatrix = (_this$_univerInstance = this._univerInstanceService.getUnit(unitId)) === null || _this$_univerInstance === void 0 || (_this$_univerInstance = _this$_univerInstance.getSheetBySheetId(sheetId)) === null || _this$_univerInstance === void 0 ? void 0 : _this$_univerInstance.getCellMatrix();
+		const affectedFormulaIds = /* @__PURE__ */ new Set();
 		cellMatrix.forValue((r, c, cell) => {
+			const currentCell = worksheetCellMatrix === null || worksheetCellMatrix === void 0 ? void 0 : worksheetCellMatrix.getValue(r, c);
+			const currentFormulaId = currentCell === null || currentCell === void 0 ? void 0 : currentCell.si;
+			const formulaId = cell === null || cell === void 0 ? void 0 : cell.si;
+			const hasCurrentFormulaId = isFormulaId(currentFormulaId);
+			const hasFormulaId = isFormulaId(formulaId);
+			const formulaString = cell === null || cell === void 0 ? void 0 : cell.f;
+			if (hasCurrentFormulaId) affectedFormulaIds.add(String(currentFormulaId));
+			if (hasFormulaId) affectedFormulaIds.add(String(formulaId));
+			if (!hasCurrentFormulaId && !hasFormulaId) {
+				if (typeof formulaString === "string" && isFormulaString(formulaString)) newSheetFormulaDataMatrix.setValue(r, c, { f: formulaString });
+				else if (isFormulaString(currentCell === null || currentCell === void 0 ? void 0 : currentCell.f)) newSheetFormulaDataMatrix.setValue(r, c, null);
+			}
+		});
+		if (affectedFormulaIds.size === 0) return newSheetFormulaDataMatrix.getMatrix();
+		const formulaIdMap = {};
+		const sharedFormulaCellMatrix = new ObjectMatrix();
+		worksheetCellMatrix === null || worksheetCellMatrix === void 0 || worksheetCellMatrix.forValue((r, c, cell) => {
+			const formulaId = cell === null || cell === void 0 ? void 0 : cell.si;
+			if (!isFormulaId(formulaId) || !affectedFormulaIds.has(String(formulaId))) return;
+			sharedFormulaCellMatrix.setValue(r, c, cell);
+			if (typeof (cell === null || cell === void 0 ? void 0 : cell.f) === "string" && isFormulaString(cell.f)) formulaIdMap[String(formulaId)] = {
+				f: cell.f,
+				r,
+				c
+			};
+		});
+		const formulaData = {};
+		initSheetFormulaData(formulaData, unitId, sheetId, sharedFormulaCellMatrix);
+		const deleteFormulaIdMap = /* @__PURE__ */ new Map();
+		const sheetFormulaDataMatrix = new ObjectMatrix((_formulaData$unitId$s = (_formulaData$unitId = formulaData[unitId]) === null || _formulaData$unitId === void 0 ? void 0 : _formulaData$unitId[sheetId]) !== null && _formulaData$unitId$s !== void 0 ? _formulaData$unitId$s : {});
+		cellMatrix.forValue((r, c, cell) => {
+			var _worksheetCellMatrix$;
+			if (!isFormulaId(worksheetCellMatrix === null || worksheetCellMatrix === void 0 || (_worksheetCellMatrix$ = worksheetCellMatrix.getValue(r, c)) === null || _worksheetCellMatrix$ === void 0 ? void 0 : _worksheetCellMatrix$.si) && !isFormulaId(cell === null || cell === void 0 ? void 0 : cell.si)) return;
 			updateFormulaDataByCellValue(sheetFormulaDataMatrix, newSheetFormulaDataMatrix, formulaIdMap, deleteFormulaIdMap, r, c, cell);
 		});
+		this._rebindSharedFormulaData(sheetFormulaDataMatrix, newSheetFormulaDataMatrix, formulaIdMap, deleteFormulaIdMap);
+		return newSheetFormulaDataMatrix.getMatrix();
+	}
+	_rebindSharedFormulaData(sheetFormulaDataMatrix, newSheetFormulaDataMatrix, formulaIdMap, deleteFormulaIdMap) {
 		sheetFormulaDataMatrix.forValue((r, c, cell) => {
 			const formulaString = (cell === null || cell === void 0 ? void 0 : cell.f) || "";
 			const formulaId = (cell === null || cell === void 0 ? void 0 : cell.si) || "";
@@ -5274,7 +5355,6 @@ let FormulaDataModel = class FormulaDataModel extends Disposable {
 				}
 			}
 		});
-		return newSheetFormulaDataMatrix.getMatrix();
 	}
 	updateArrayFormulaRange(unitId, sheetId, cellValue) {
 		var _this$_arrayFormulaRa5;
@@ -5396,23 +5476,6 @@ let FormulaDataModel = class FormulaDataModel extends Disposable {
 		}
 		return dirtyRanges;
 	}
-	_getSheetFormulaIdMap(unitId, sheetId) {
-		const formulaIdMap = {};
-		const workbook = this._univerInstanceService.getUnit(unitId);
-		if (workbook == null) return formulaIdMap;
-		const worksheet = workbook.getSheetBySheetId(sheetId);
-		if (worksheet == null) return formulaIdMap;
-		worksheet.getCellMatrix().forValue((r, c, cell) => {
-			if (cell == null) return true;
-			const { f, si } = cell;
-			if (isFormulaString(f) && isFormulaId(si)) formulaIdMap[si] = {
-				f,
-				r,
-				c
-			};
-		});
-		return formulaIdMap;
-	}
 	_initSheetArrayFormulaData(unitId, sheetId, cellMatrix) {
 		let arrayFormulaRangeMatrix;
 		let arrayFormulaCellDataMatrix;
@@ -5498,12 +5561,13 @@ function initSheetFormulaData(formulaData, unitId, sheetId, cellMatrix) {
 const BASE_LEGACY_FIELD_REF_PATTERN = /\{([^}]+)\}/g;
 const BASE_TABLE_FIELD_REF_PATTERN = /\b([A-Z_]\w*)\[([^\]]+)\]/gi;
 const BASE_BRACKET_FIELD_REF_PATTERN = /(^|[^A-Za-z0-9_\]\[])\[([^\]]+)\]/g;
+const BASE_EXTERNAL_A1_REF_PATTERN = /(?:'\[[^\]]+\](?:[^']|'')+'|\[[^\]]+\][^\s'!]+)!\$?[A-Z]{1,3}\$?\d+(?::\$?[A-Z]{1,3}\$?\d+)?/gi;
 function normalizeBaseFormulaForEngine(formula, currentTable, snapshot) {
 	const refs = [];
 	const hold = (ref) => {
 		return `__BASE_FORMULA_REF_${refs.push(ref) - 1}__`;
 	};
-	return formula.replace(BASE_LEGACY_FIELD_REF_PATTERN, (_match, fieldName) => hold(createEngineThisRowRef(currentTable, fieldName, snapshot))).replace(BASE_TABLE_FIELD_REF_PATTERN, (_match, sourceTableName, fieldName) => {
+	return formula.replace(BASE_EXTERNAL_A1_REF_PATTERN, (reference) => hold(reference)).replace(BASE_LEGACY_FIELD_REF_PATTERN, (_match, fieldName) => hold(createEngineThisRowRef(currentTable, fieldName, snapshot))).replace(BASE_TABLE_FIELD_REF_PATTERN, (_match, sourceTableName, fieldName) => {
 		const targetTable = resolveBaseFormulaTable(sourceTableName, currentTable, snapshot);
 		return targetTable ? hold(createEngineThisRowRef(targetTable, fieldName, snapshot)) : `${sourceTableName}[${fieldName}]`;
 	}).replace(BASE_BRACKET_FIELD_REF_PATTERN, (_match, prefix, fieldName) => `${prefix}${hold(createEngineThisRowRef(currentTable, fieldName, snapshot))}`).replace(/__BASE_FORMULA_REF_(\d+)__/g, (_match, index) => {
@@ -5669,6 +5733,7 @@ let FormulaCurrentConfigService = class FormulaCurrentConfigService extends Disp
 		_defineProperty(this, "_arrayFormulaRange", {});
 		_defineProperty(this, "_formulaData", {});
 		_defineProperty(this, "_sheetNameMap", {});
+		_defineProperty(this, "_unitNameMap", {});
 		_defineProperty(this, "_forceCalculate", false);
 		_defineProperty(this, "_clearDependencyTreeCache", {});
 		_defineProperty(this, "_dirtyRanges", []);
@@ -5690,6 +5755,7 @@ let FormulaCurrentConfigService = class FormulaCurrentConfigService extends Disp
 		this._arrayFormulaRange = {};
 		this._formulaData = {};
 		this._sheetNameMap = {};
+		this._unitNameMap = {};
 		this._clearDependencyTreeCache = {};
 		this._dirtyRanges = [];
 		this._dirtyNameMap = {};
@@ -5733,6 +5799,9 @@ let FormulaCurrentConfigService = class FormulaCurrentConfigService extends Disp
 	getSheetNameMap() {
 		return this._sheetNameMap;
 	}
+	getUnitNameMap() {
+		return this._unitNameMap;
+	}
 	isForceCalculate() {
 		return this._forceCalculate;
 	}
@@ -5798,11 +5867,13 @@ let FormulaCurrentConfigService = class FormulaCurrentConfigService extends Disp
 			this._unitData = config.allUnitData;
 			this._unitStylesData = config.unitStylesData;
 			this._sheetNameMap = config.unitSheetNameMap;
+			this._unitNameMap = config.unitNameMap || {};
 		} else {
-			const { allUnitData, unitSheetNameMap, unitStylesData } = this._loadSheetData();
+			const { allUnitData, unitNameMap, unitSheetNameMap, unitStylesData } = this._loadSheetData();
 			this._unitData = allUnitData;
 			this._unitStylesData = unitStylesData;
 			this._sheetNameMap = unitSheetNameMap;
+			this._unitNameMap = unitNameMap;
 		}
 		if (config.rowData) this._applyUnitRowData(config.rowData);
 		this._formulaData = config.formulaData;
@@ -5820,10 +5891,11 @@ let FormulaCurrentConfigService = class FormulaCurrentConfigService extends Disp
 		this._mergeNameMap(this._sheetNameMap, this._dirtyNameMap);
 	}
 	loadDataLite(rowData) {
-		const { allUnitData, unitSheetNameMap, unitStylesData } = this._loadSheetData();
+		const { allUnitData, unitNameMap, unitSheetNameMap, unitStylesData } = this._loadSheetData();
 		this._unitData = allUnitData;
 		this._unitStylesData = unitStylesData;
 		this._sheetNameMap = unitSheetNameMap;
+		this._unitNameMap = unitNameMap;
 		this._formulaData = this._formulaDataModel.getFormulaData();
 		this._arrayFormulaCellData = convertUnitDataToRuntime(this._formulaDataModel.getArrayFormulaCellData());
 		this._arrayFormulaRange = this._formulaDataModel.getArrayFormulaRange();
@@ -5858,6 +5930,9 @@ let FormulaCurrentConfigService = class FormulaCurrentConfigService extends Disp
 	registerSheetNameMap(sheetNameMap) {
 		this._sheetNameMap = sheetNameMap;
 	}
+	registerUnitNameMap(unitNameMap) {
+		this._unitNameMap = unitNameMap;
+	}
 	_mergeNameMap(unitSheetNameMap, dirtyNameMap) {
 		Object.keys(dirtyNameMap).forEach((unitId) => {
 			if (dirtyNameMap[unitId]) Object.keys(dirtyNameMap[unitId]).forEach((sheetId) => {
@@ -8476,6 +8551,7 @@ var BaseReferenceObject = class extends ObjectClassType {
 		_defineProperty(this, "_filteredOutRows", []);
 		_defineProperty(this, "_defaultUnitId", "");
 		_defineProperty(this, "_forcedUnitId", "");
+		_defineProperty(this, "_unitQualifier", "");
 		_defineProperty(this, "_runtimeData", {});
 		_defineProperty(this, "_arrayFormulaCellData", {});
 		_defineProperty(this, "_arrayFormulaRange", {});
@@ -8582,6 +8658,12 @@ var BaseReferenceObject = class extends ObjectClassType {
 	setForcedUnitIdDirect(unitId) {
 		if (unitId.length > 0) this._forcedUnitId = unitId;
 	}
+	setUnitQualifier(unitQualifier) {
+		this._unitQualifier = unitQualifier;
+	}
+	getUnitQualifier() {
+		return this._unitQualifier;
+	}
 	getForcedUnitId() {
 		return this._forcedUnitId;
 	}
@@ -8969,6 +9051,7 @@ var CellReferenceObject = class extends BaseReferenceObject {
 	constructor(token) {
 		super(token);
 		const grid = deserializeRangeWithSheetWithCache(token);
+		this.setUnitQualifier(grid.unitId);
 		this.setForcedUnitIdDirect(grid.unitId);
 		this.setForcedSheetName(grid.sheetName);
 		this.setRangeData(grid.range);
@@ -9044,6 +9127,7 @@ var ColumnReferenceObject = class extends BaseReferenceObject {
 	constructor(token) {
 		super(token);
 		const grid = deserializeRangeWithSheetWithCache(token);
+		this.setUnitQualifier(grid.unitId);
 		this.setForcedUnitIdDirect(grid.unitId);
 		this.setForcedSheetName(grid.sheetName);
 		const range = {
@@ -9086,6 +9170,7 @@ var RowReferenceObject = class extends BaseReferenceObject {
 	constructor(token) {
 		super(token);
 		const grid = deserializeRangeWithSheetWithCache(token);
+		this.setUnitQualifier(grid.unitId);
 		this.setForcedUnitIdDirect(grid.unitId);
 		this.setForcedSheetName(grid.sheetName);
 		const range = {
@@ -10461,6 +10546,49 @@ var FunctionService = class extends Disposable {
 	}
 };
 
+//#endregion
+//#region src/services/unit-reference-resolver.service.ts
+const IFormulaUnitReferenceResolver = createIdentifier("univer.formula.unit-reference-resolver");
+const EXCEL_WORKBOOK_EXTENSION = /\.(?:xlsx|xlsm|xlsb|xltx|xltm|xls)$/i;
+function normalizeFormulaUnitName(name) {
+	return name.replace(EXCEL_WORKBOOK_EXTENSION, "").toLowerCase();
+}
+let FormulaUnitReferenceResolver = class FormulaUnitReferenceResolver {
+	constructor(_currentConfigService) {
+		this._currentConfigService = _currentConfigService;
+	}
+	resolve({ hostUnitId, qualifier, referenceKind }) {
+		const unitNameMap = this._currentConfigService.getUnitNameMap();
+		const unitData = this._currentConfigService.getUnitData();
+		const address = qualifier || hostUnitId;
+		const direct = unitNameMap[address];
+		if (direct || unitData[address]) return this._validateReferenceKind(hostUnitId, referenceKind, {
+			unitId: address,
+			unitType: direct === null || direct === void 0 ? void 0 : direct.unitType
+		}, unitNameMap);
+		if (!qualifier) return "#REF!";
+		const namedUnits = Object.entries(unitNameMap).filter(([, item]) => item.name.length > 0);
+		const normalizedQualifier = qualifier.toLowerCase();
+		const exactMatches = namedUnits.filter(([, item]) => item.name.toLowerCase() === normalizedQualifier);
+		const matches = exactMatches.length > 0 ? exactMatches : namedUnits.filter(([, item]) => normalizeFormulaUnitName(item.name) === normalizeFormulaUnitName(qualifier));
+		if (matches.length !== 1) return "#REF!";
+		const [unitId, item] = matches[0];
+		return this._validateReferenceKind(hostUnitId, referenceKind, {
+			unitId,
+			unitType: item.unitType
+		}, unitNameMap);
+	}
+	_validateReferenceKind(hostUnitId, referenceKind, resolution, unitNameMap) {
+		var _unitNameMap$hostUnit;
+		if (referenceKind !== "a1" || resolution.unitId === hostUnitId) return resolution;
+		const hostType = (_unitNameMap$hostUnit = unitNameMap[hostUnitId]) === null || _unitNameMap$hostUnit === void 0 ? void 0 : _unitNameMap$hostUnit.unitType;
+		if (resolution.unitType === UniverInstanceType.UNIVER_BASE) return "#REF!";
+		if (hostType === UniverInstanceType.UNIVER_BASE && resolution.unitType !== UniverInstanceType.UNIVER_SHEET) return "#REF!";
+		return resolution;
+	}
+};
+FormulaUnitReferenceResolver = __decorate([__decorateParam(0, IFormulaCurrentConfigService)], FormulaUnitReferenceResolver);
+
 //#endregion
 //#region src/engine/ast-node/prefix-node.ts
 var PrefixNode = class extends BaseAstNode {
@@ -10577,18 +10705,20 @@ function prefixHandler(tokenTrimParam, functionService, runtimeService) {
 //#endregion
 //#region src/engine/ast-node/function-node.ts
 var FunctionNode = class extends BaseAstNode {
-	constructor(token, _functionExecutor, _currentConfigService, _runtimeService, _definedNamesService, _formulaDataModel) {
+	constructor(token, _functionExecutor, _currentConfigService, _runtimeService, _definedNamesService, _formulaDataModel, _unitReferenceResolver) {
 		super(token);
 		this._functionExecutor = _functionExecutor;
 		this._currentConfigService = _currentConfigService;
 		this._runtimeService = _runtimeService;
 		this._definedNamesService = _definedNamesService;
 		this._formulaDataModel = _formulaDataModel;
+		this._unitReferenceResolver = _unitReferenceResolver;
 		if (this._functionExecutor.isAsync()) this.setAsync();
 		if (this._functionExecutor.isAddress()) this.setAddress();
 		if (this._functionExecutor.needsLocale) this._setLocale();
 		if (this._functionExecutor.needsSheetsInfo) this._setSheetsInfo();
 		if (this._functionExecutor.needsFormulaDataModel) this._functionExecutor.setFormulaDataModel(this._formulaDataModel);
+		if (this._functionExecutor.needsUnitReferenceResolver) this._functionExecutor.setUnitReferenceResolver(this._unitReferenceResolver);
 	}
 	get nodeType() {
 		return 4;
@@ -10816,7 +10946,7 @@ var ErrorFunctionNode = class extends BaseAstNode {
 	}
 };
 let FunctionNodeFactory = class FunctionNodeFactory extends BaseAstNodeFactory {
-	constructor(_functionService, _currentConfigService, _runtimeService, _definedNamesService, _injector, _formulaDataModel) {
+	constructor(_functionService, _currentConfigService, _runtimeService, _definedNamesService, _injector, _formulaDataModel, _unitReferenceResolver) {
 		super();
 		this._functionService = _functionService;
 		this._currentConfigService = _currentConfigService;
@@ -10824,6 +10954,7 @@ let FunctionNodeFactory = class FunctionNodeFactory extends BaseAstNodeFactory {
 		this._definedNamesService = _definedNamesService;
 		this._injector = _injector;
 		this._formulaDataModel = _formulaDataModel;
+		this._unitReferenceResolver = _unitReferenceResolver;
 	}
 	get zIndex() {
 		return NODE_ORDER_MAP.get(4) || 100;
@@ -10834,7 +10965,7 @@ let FunctionNodeFactory = class FunctionNodeFactory extends BaseAstNodeFactory {
 			console.error(`No function ${token}`);
 			return ErrorNode.create("#NAME?");
 		}
-		return new FunctionNode(token, functionExecutor, this._currentConfigService, this._runtimeService, this._definedNamesService, this._formulaDataModel);
+		return new FunctionNode(token, functionExecutor, this._currentConfigService, this._runtimeService, this._definedNamesService, this._formulaDataModel, this._unitReferenceResolver);
 	}
 	checkAndCreateNodeType(param) {
 		if (typeof param === "string") return;
@@ -10861,7 +10992,8 @@ FunctionNodeFactory = __decorate([
 	__decorateParam(2, IFormulaRuntimeService),
 	__decorateParam(3, IDefinedNamesService),
 	__decorateParam(4, Inject(Injector)),
-	__decorateParam(5, Inject(FormulaDataModel))
+	__decorateParam(5, Inject(FormulaDataModel)),
+	__decorateParam(6, IFormulaUnitReferenceResolver)
 ], FunctionNodeFactory);
 function normalizeFunctionToken(token) {
 	if (token === "REGEXTEST" || token === "_XLFN.REGEXTEST") return "REGEXMATCH";
@@ -11565,6 +11697,7 @@ var TableReferenceObject = class extends BaseReferenceObject {
 		const { startColumn, endColumn, type } = this._parseStructuredRef(this._columnDataString, titleMap);
 		const tableStartRow = range.startRow;
 		const tableEndRow = range.endRow;
+		const dataStartRow = tableStartRow + (this._tableData.showHeader === false ? 0 : 1);
 		let startRow = -1;
 		let endRow = -1;
 		switch (type) {
@@ -11573,10 +11706,15 @@ var TableReferenceObject = class extends BaseReferenceObject {
 				endRow = tableEndRow;
 				break;
 			case "#Data":
-				startRow = tableStartRow + 1;
+				startRow = dataStartRow;
 				endRow = tableEndRow;
 				break;
 			case "#Headers":
+				if (this._tableData.showHeader === false) {
+					startRow = -1;
+					endRow = -1;
+					break;
+				}
 				startRow = tableStartRow;
 				endRow = tableStartRow;
 				break;
@@ -11591,7 +11729,7 @@ var TableReferenceObject = class extends BaseReferenceObject {
 				break;
 			}
 			default:
-				startRow = tableStartRow + 1;
+				startRow = dataStartRow;
 				endRow = tableEndRow;
 				break;
 		}
@@ -11616,6 +11754,13 @@ var TableReferenceObject = class extends BaseReferenceObject {
 		}
 		return rangeData;
 	}
+	getCellData(row, column) {
+		if (this._isCurrentRowForRange) {
+			const { startRow, endRow } = this._tableData.range;
+			if (row < startRow || row > endRow) return { v: "#N/A" };
+		}
+		return super.getCellData(row, column);
+	}
 	getRefOffset() {
 		return {
 			x: 0,
@@ -11812,13 +11957,15 @@ var TableReferenceObject = class extends BaseReferenceObject {
 //#endregion
 //#region src/engine/ast-node/reference-node.ts
 var ReferenceNode = class extends BaseAstNode {
-	constructor(_currentConfigService, _runtimeService, operatorString, _referenceObjectType, _isPrepareMerge = false, _tableReferenceObject) {
+	constructor(_currentConfigService, _runtimeService, operatorString, _referenceObjectType, _unitReferenceResolver, _superTableService, _isPrepareMerge = false, _tableReference) {
 		super(operatorString);
 		this._currentConfigService = _currentConfigService;
 		this._runtimeService = _runtimeService;
 		this._referenceObjectType = _referenceObjectType;
+		this._unitReferenceResolver = _unitReferenceResolver;
+		this._superTableService = _superTableService;
 		this._isPrepareMerge = _isPrepareMerge;
-		this._tableReferenceObject = _tableReferenceObject;
+		this._tableReference = _tableReference;
 		_defineProperty(this, "_refOffsetX", 0);
 		_defineProperty(this, "_refOffsetY", 0);
 	}
@@ -11828,7 +11975,49 @@ var ReferenceNode = class extends BaseAstNode {
 	execute() {
 		const currentConfigService = this._currentConfigService;
 		const runtimeService = this._runtimeService;
-		const referenceObject = this._tableReferenceObject || getReferenceObjectFromCache(this.getToken(), this._referenceObjectType);
+		let referenceObject;
+		if (this._tableReference) {
+			var _Array$from$find;
+			const { unitQualifier, tableName, columnStruct } = this._tableReference;
+			const resolution = this._unitReferenceResolver.resolve({
+				hostUnitId: runtimeService.currentUnitId,
+				qualifier: unitQualifier,
+				referenceKind: "table"
+			});
+			if (typeof resolution === "string") {
+				this.setValue(ErrorValueObject.create(resolution));
+				return;
+			}
+			const tableMap = this._superTableService.getTableMap(resolution.unitId);
+			const tableData = (_Array$from$find = Array.from((tableMap === null || tableMap === void 0 ? void 0 : tableMap.entries()) || []).find(([name]) => name.toLocaleLowerCase() === tableName.toLocaleLowerCase())) === null || _Array$from$find === void 0 ? void 0 : _Array$from$find[1];
+			if (!tableData) {
+				this.setValue(ErrorValueObject.create("#REF!"));
+				return;
+			}
+			referenceObject = new TableReferenceObject(this.getToken(), tableData, columnStruct, this._superTableService.getTableOptionMap());
+			referenceObject.setUnitQualifier(unitQualifier);
+			referenceObject.setForcedUnitIdDirect(resolution.unitId);
+		} else {
+			referenceObject = getReferenceObjectFromCache(this.getToken(), this._referenceObjectType);
+			const unitQualifier = referenceObject.getUnitQualifier();
+			if (unitQualifier) {
+				const resolution = this._unitReferenceResolver.resolve({
+					hostUnitId: runtimeService.currentUnitId,
+					qualifier: unitQualifier,
+					referenceKind: "a1"
+				});
+				if (typeof resolution === "string") {
+					this.setValue(ErrorValueObject.create(resolution));
+					return;
+				}
+				referenceObject.setForcedUnitIdDirect(resolution.unitId);
+			}
+		}
+		this._configureReferenceObject(referenceObject, currentConfigService, runtimeService);
+		if (!this._isPrepareMerge && referenceObject.isExceedRange()) this.setValue(ErrorValueObject.create("#NAME?"));
+		else this.setValue(referenceObject);
+	}
+	_configureReferenceObject(referenceObject, currentConfigService, runtimeService) {
 		referenceObject.setDefaultUnitId(runtimeService.currentUnitId);
 		referenceObject.setDefaultSheetId(runtimeService.currentSubUnitId);
 		referenceObject.setForcedSheetId(currentConfigService.getSheetNameMap());
@@ -11840,13 +12029,9 @@ var ReferenceNode = class extends BaseAstNode {
 		referenceObject.setRuntimeArrayFormulaCellData(runtimeService.getRuntimeArrayFormulaCellData());
 		referenceObject.setRuntimeArrayFormulaRange(runtimeService.getUnitArrayFormula());
 		referenceObject.setRuntimeFeatureCellData(runtimeService.getRuntimeFeatureCellData());
-		const currentRow = runtimeService.currentRow;
-		const currentCol = runtimeService.currentColumn;
-		referenceObject.setCurrentRowAndColumn(currentRow, currentCol);
+		referenceObject.setCurrentRowAndColumn(runtimeService.currentRow, runtimeService.currentColumn);
 		const { x, y } = this.getRefOffset();
 		referenceObject.setRefOffset(x, y);
-		if (!this._isPrepareMerge && referenceObject.isExceedRange()) this.setValue(ErrorValueObject.create("#NAME?"));
-		else this.setValue(referenceObject);
 	}
 	setRefOffset(x = 0, y = 0) {
 		this._refOffsetX = x;
@@ -11860,12 +12045,13 @@ var ReferenceNode = class extends BaseAstNode {
 	}
 };
 let ReferenceNodeFactory = class ReferenceNodeFactory extends BaseAstNodeFactory {
-	constructor(_currentConfigService, _formulaRuntimeService, _functionService, _superTableService) {
+	constructor(_currentConfigService, _formulaRuntimeService, _functionService, _superTableService, _unitReferenceResolver) {
 		super();
 		this._currentConfigService = _currentConfigService;
 		this._formulaRuntimeService = _formulaRuntimeService;
 		this._functionService = _functionService;
 		this._superTableService = _superTableService;
+		this._unitReferenceResolver = _unitReferenceResolver;
 	}
 	get zIndex() {
 		return NODE_ORDER_MAP.get(1) || 100;
@@ -11902,25 +12088,25 @@ let ReferenceNodeFactory = class ReferenceNodeFactory extends BaseAstNodeFactory
 		var _tableMap$has;
 		const currentConfigService = this._currentConfigService;
 		const runtimeService = this._formulaRuntimeService;
-		const makeRef = (type) => new ReferenceNode(currentConfigService, runtimeService, tokenTrim, type, isPrepareMerge);
+		const makeRef = (type) => new ReferenceNode(currentConfigService, runtimeService, tokenTrim, type, this._unitReferenceResolver, this._superTableService, isPrepareMerge);
 		const tableMap = this._getTableMap();
-		if ((_tableMap$has = tableMap === null || tableMap === void 0 ? void 0 : tableMap.has(tokenTrim)) !== null && _tableMap$has !== void 0 ? _tableMap$has : false) return this._getTableReferenceNode(tokenTrim, isLexerNode, isPrepareMerge, true);
+		if ((_tableMap$has = tableMap === null || tableMap === void 0 ? void 0 : tableMap.has(tokenTrim)) !== null && _tableMap$has !== void 0 ? _tableMap$has : false) return this._getTableReferenceNode(tokenTrim, isPrepareMerge, true);
 		if (regexTestSingeRange(tokenTrim)) return makeRef(0);
 		const parentIsUnion = isLexerNode && this._checkParentIsUnionOperator(param);
 		if (parentIsUnion && regexTestSingleRow(tokenTrim)) return makeRef(2);
 		if (parentIsUnion && regexTestSingleColumn(tokenTrim)) return makeRef(1);
-		return this._getTableReferenceNode(tokenTrim, isLexerNode, isPrepareMerge, false);
+		return this._getTableReferenceNode(tokenTrim, isPrepareMerge, false);
 	}
-	_getTableReferenceNode(tokenTrim, isLexerNode, isPrepareMerge, isSuperTableDirectly = false) {
+	_getTableReferenceNode(tokenTrim, isPrepareMerge, isSuperTableDirectly = false) {
 		if (!this._checkTokenIsTableReference(tokenTrim) && !isSuperTableDirectly) return;
-		const { tableName, columnStruct } = splitTableStructuredRef(tokenTrim);
+		const { unitQualifier, tableName, columnStruct } = splitTableStructuredRef(tokenTrim);
 		const tableMap = this._getTableMap();
-		if (!isLexerNode && (tableMap === null || tableMap === void 0 ? void 0 : tableMap.has(tableName))) {
-			const columnDataString = columnStruct;
-			const tableData = tableMap.get(tableName);
-			const tableOption = this._superTableService.getTableOptionMap();
-			return new ReferenceNode(this._currentConfigService, this._formulaRuntimeService, tokenTrim, 1, isPrepareMerge, new TableReferenceObject(tokenTrim, tableData, columnDataString, tableOption));
-		}
+		const hasLocalTable = Array.from((tableMap === null || tableMap === void 0 ? void 0 : tableMap.keys()) || []).some((name) => name.toLocaleLowerCase() === tableName.toLocaleLowerCase());
+		if (unitQualifier || hasLocalTable) return new ReferenceNode(this._currentConfigService, this._formulaRuntimeService, tokenTrim, 1, this._unitReferenceResolver, this._superTableService, isPrepareMerge, {
+			unitQualifier,
+			tableName,
+			columnStruct
+		});
 	}
 	_checkTokenIsTableReference(token) {
 		return regexTestReferenceTableAllColumn(token) || regexTestReferenceTableSingleColumn(token) || regexTestReferenceTableMultipleColumn(token) || regexTestReferenceTableTitleOnlyAnyHash(token);
@@ -11934,7 +12120,8 @@ ReferenceNodeFactory = __decorate([
 	__decorateParam(0, IFormulaCurrentConfigService),
 	__decorateParam(1, IFormulaRuntimeService),
 	__decorateParam(2, IFunctionService),
-	__decorateParam(3, ISuperTableService)
+	__decorateParam(3, ISuperTableService),
+	__decorateParam(4, IFormulaUnitReferenceResolver)
 ], ReferenceNodeFactory);
 
 //#endregion
@@ -14226,9 +14413,10 @@ let CalculateFormulaService = class CalculateFormulaService extends Disposable {
 		this._executeLock.acquire("FORMULA_EXECUTION_LOCK", async () => {
 			for (let i = 0; i < cycleReferenceCount; i++) {
 				this._runtimeService.setFormulaCycleIndex(i);
-				await this._executeStep();
+				const executed = await this._executeStep();
 				FORMULA_REF_TO_ARRAY_CACHE.clear();
-				if (!this._runtimeService.isCycleDependency()) break;
+				const isCycleDependency = this._runtimeService.isCycleDependency();
+				if (!executed || !isCycleDependency) break;
 			}
 			this._runtimeService.setFormulaExecuteStage(8);
 			this._executionInProgressListener$.next(this._runtimeService.getRuntimeState());
@@ -14339,7 +14527,6 @@ let CalculateFormulaService = class CalculateFormulaService extends Disposable {
 				if (this._runtimeService.isStopExecution() || nodeData == null && getDirtyData == null) {
 					this._runtimeService.setFormulaExecuteStage(0);
 					this._runtimeService.markedAsStopFunctionsExecuted();
-					this._executionCompleteListener$.next(this._runtimeService.getAllRuntimeData());
 					return;
 				}
 			}
@@ -14724,7 +14911,7 @@ function singleReference(refBody, currentRow = 0, currentColumn = 0) {
 	};
 }
 function deserializeRangeForR1C1(refString, currentRow = 0, currentColumn = 0) {
-	const { refBody, sheetName, unitId } = handleRefStringInfo(refString);
+	const { refBody, sheetName, unitQualifier } = handleRefStringInfo(refString);
 	const colonIndex = refBody.indexOf(":");
 	if (colonIndex === -1) {
 		const grid = singleReference(refBody, currentRow, currentColumn);
@@ -14732,7 +14919,7 @@ function deserializeRangeForR1C1(refString, currentRow = 0, currentColumn = 0) {
 		const column = grid.column;
 		const absoluteRefType = grid.absoluteRefType;
 		return {
-			unitId,
+			unitId: unitQualifier,
 			sheetName,
 			range: {
 				startRow: row,
@@ -14749,7 +14936,7 @@ function deserializeRangeForR1C1(refString, currentRow = 0, currentColumn = 0) {
 	const startGrid = singleReference(refStartString, currentRow, currentColumn);
 	const endGrid = singleReference(refEndString, currentRow, currentColumn);
 	return {
-		unitId,
+		unitId: unitQualifier,
 		sheetName,
 		range: {
 			startRow: startGrid.row,
@@ -14779,6 +14966,91 @@ function getR1C1Ref(index, absoluteRefType = AbsoluteRefType.ALL, isRow) {
 	}
 }
 
+//#endregion
+//#region src/engine/utils/unit-qualifier.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.
+*/
+const A1_UNIT_QUALIFIER = /('?)\[([^\]]+)\]((?:[^']|'')+)\1!(?=\$?[A-Z]{1,3}\$?\d+)/gi;
+const TABLE_UNIT_QUALIFIER = /(^|[^\w.])(?:'((?:[^']|'')+)'|\[([^\]]+)\]|([A-Za-z0-9_.-]+))!(?=[^\s!\[\]]+\[)/g;
+const INDIRECT_LITERAL = /\bINDIRECT\s*\(\s*"((?:[^"]|"")*)"/gi;
+function equalsQualifier(actual, expected) {
+	return actual.replace(/''/g, "'").toLocaleLowerCase() === expected.toLocaleLowerCase();
+}
+function quoteQualifier(name) {
+	return /^[A-Za-z0-9_.-]+$/.test(name) ? name : `'${name.replace(/'/g, "''")}'`;
+}
+function refactorReferenceSegment(segment, oldName, newName) {
+	return segment.replace(A1_UNIT_QUALIFIER, (token, quote, qualifier, sheetName) => {
+		if (!equalsQualifier(qualifier, oldName)) return token;
+		const escapedName = newName.replace(/'/g, "''");
+		return quote ? `'[${escapedName}]${sheetName}'!` : `[${newName}]${sheetName}!`;
+	}).replace(TABLE_UNIT_QUALIFIER, (token, boundary, quoted, bracketed, plain) => {
+		var _ref, _ref2;
+		if (!equalsQualifier((_ref = (_ref2 = quoted !== null && quoted !== void 0 ? quoted : bracketed) !== null && _ref2 !== void 0 ? _ref2 : plain) !== null && _ref !== void 0 ? _ref : "", oldName)) return token;
+		if (quoted != null) return `${boundary}'${newName.replace(/'/g, "''")}'!`;
+		if (bracketed != null) return `${boundary}[${newName}]!`;
+		return `${boundary}${quoteQualifier(newName)}!`;
+	});
+}
+function refactorOutsideStrings(formula, oldName, newName) {
+	let result = "";
+	let chunk = "";
+	let inString = false;
+	for (let index = 0; index < formula.length; index++) {
+		const character = formula[index];
+		if (character !== "\"") {
+			chunk += character;
+			continue;
+		}
+		if (inString && formula[index + 1] === "\"") {
+			chunk += "\"\"";
+			index++;
+			continue;
+		}
+		result += inString ? chunk : refactorReferenceSegment(chunk, oldName, newName);
+		result += "\"";
+		chunk = "";
+		inString = !inString;
+	}
+	return result + (inString ? chunk : refactorReferenceSegment(chunk, oldName, newName));
+}
+/** Refactors only parsed reference qualifiers and INDIRECT literal references, never arbitrary text. */
+function refactorFormulaUnitQualifier(formula, oldName, newName) {
+	if (!oldName || oldName === newName) return formula;
+	return refactorOutsideStrings(formula.replace(INDIRECT_LITERAL, (token, literal) => {
+		const next = refactorReferenceSegment(literal.replace(/""/g, "\""), oldName, newName).replace(/"/g, "\"\"");
+		return token.replace(literal, next);
+	}), oldName, newName);
+}
+/**
+* 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.
+*/
+
 //#endregion
 //#region src/engine/utils/check-variant-error.ts
 function checkVariantErrorIsArray(variant) {
@@ -14883,6 +15155,7 @@ var BaseFunction = class {
 		_defineProperty(this, "_sheetOrder", void 0);
 		_defineProperty(this, "_sheetNameMap", void 0);
 		_defineProperty(this, "_formulaDataModel", void 0);
+		_defineProperty(this, "_unitReferenceResolver", void 0);
 		_defineProperty(this, "_rowCount", -1);
 		_defineProperty(this, "_columnCount", -1);
 		_defineProperty(
@@ -14925,6 +15198,12 @@ var BaseFunction = class {
 			"needsFormulaDataModel",
 			false
 		);
+		_defineProperty(
+			this,
+			/** Whether the function resolves external Unit qualifiers. */
+			"needsUnitReferenceResolver",
+			false
+		);
 		_defineProperty(
 			this,
 			/**
@@ -15033,6 +15312,9 @@ var BaseFunction = class {
 	setFormulaDataModel(_formulaDataModel) {
 		this._formulaDataModel = _formulaDataModel;
 	}
+	setUnitReferenceResolver(unitReferenceResolver) {
+		this._unitReferenceResolver = unitReferenceResolver;
+	}
 	setSheetRowColumnCount(rowCount, columnCount) {
 		this._rowCount = rowCount;
 		this._columnCount = columnCount;
@@ -30194,6 +30476,7 @@ var Indirect = class extends BaseFunction {
 		super(..._args);
 		_defineProperty(this, "minParams", 1);
 		_defineProperty(this, "maxParams", 2);
+		_defineProperty(this, "needsUnitReferenceResolver", true);
 	}
 	isAddress() {
 		return true;
@@ -30223,6 +30506,7 @@ var Indirect = class extends BaseFunction {
 		if (a1Value === 0) {
 			const { range, sheetName, unitId } = deserializeRangeForR1C1(refTextV);
 			const rangeReferenceObject = new RangeReferenceObject(range);
+			rangeReferenceObject.setUnitQualifier(unitId);
 			rangeReferenceObject.setForcedUnitIdDirect(unitId);
 			rangeReferenceObject.setForcedSheetName(sheetName);
 			return this._setDefault(rangeReferenceObject);
@@ -30233,12 +30517,23 @@ var Indirect = class extends BaseFunction {
 		const { range, sheetName, unitId } = deserializeRangeWithSheetWithCache(refTextV);
 		if (Number.isNaN(range.startRow) || range.endRow + 1 > MAX_ROW_COUNT || Number.isNaN(range.startColumn) || range.endColumn + 1 > MAX_COLUMN_COUNT) return ErrorValueObject.create("#REF!");
 		const rangeReferenceObject = new RangeReferenceObject(range);
+		rangeReferenceObject.setUnitQualifier(unitId);
 		rangeReferenceObject.setForcedUnitIdDirect(unitId);
 		rangeReferenceObject.setForcedSheetName(sheetName);
 		return this._setDefault(rangeReferenceObject);
 	}
 	_setDefault(object) {
 		if (this.unitId == null || this.subUnitId == null) return ErrorValueObject.create("#REF!");
+		const unitQualifier = object.getUnitQualifier();
+		if (unitQualifier && this._unitReferenceResolver) {
+			const resolution = this._unitReferenceResolver.resolve({
+				hostUnitId: this.unitId,
+				qualifier: unitQualifier,
+				referenceKind: "a1"
+			});
+			if (typeof resolution === "string") return ErrorValueObject.create(resolution);
+			object.setForcedUnitIdDirect(resolution.unitId);
+		}
 		object.setDefaultUnitId(this.unitId);
 		object.setDefaultSheetId(this.subUnitId);
 		return object;
@@ -41780,7 +42075,7 @@ function getObjectValue(result, isUseStrip = false) {
 //#endregion
 //#region package.json
 var name = "@univerjs/engine-formula";
-var version = "1.0.0-alpha.3";
+var version = "1.0.0-alpha.5";
 
 //#endregion
 //#region src/services/global-computing-status.service.ts
@@ -41849,6 +42144,242 @@ let ComputingStatusReporterController = class ComputingStatusReporterController
 };
 ComputingStatusReporterController = __decorate([__decorateParam(0, ICommandService), __decorateParam(1, Inject(GlobalComputingStatusService))], ComputingStatusReporterController);
 
+//#endregion
+//#region src/services/formula-calculation-trigger.service.ts
+const LOCAL_ONLY = { onlyLocal: true };
+const CALCULATION_DEBOUNCE_TIME = 10;
+let FormulaCalculationTriggerService = class FormulaCalculationTriggerService extends Disposable {
+	constructor(_commandService, _activeDirtyManagerService) {
+		super();
+		this._commandService = _commandService;
+		this._activeDirtyManagerService = _activeDirtyManagerService;
+		_defineProperty(this, "_waitingCommandQueue", []);
+		_defineProperty(this, "_pendingDirtyData", createEmptyDirtyData());
+		_defineProperty(this, "_runningDirtyData", createEmptyDirtyData());
+		_defineProperty(this, "_timer", void 0);
+		_defineProperty(this, "_started", false);
+		_defineProperty(this, "_executionInProgress", false);
+		_defineProperty(this, "_hasPendingCalculation", false);
+		_defineProperty(this, "_stopRequested", false);
+		this._initialize();
+	}
+	start() {
+		if (this._started) return;
+		this._started = true;
+		this._scheduleFlush();
+	}
+	dispose() {
+		clearTimeout(this._timer);
+		this._waitingCommandQueue = [];
+		this._pendingDirtyData = createEmptyDirtyData();
+		this._runningDirtyData = createEmptyDirtyData();
+		super.dispose();
+	}
+	_initialize() {
+		this.disposeWithMe(this._commandService.onCommandExecuted((command, options) => {
+			var _conversion$shouldTri;
+			if (command.id === SetFormulaCalculationStartMutation.id) {
+				this._executionInProgress = true;
+				return;
+			}
+			if (command.id === SetFormulaCalculationNotificationMutation.id) {
+				this._handleCalculationNotification(command.params);
+				return;
+			}
+			const conversion = this._activeDirtyManagerService.get(command.id);
+			if (!conversion) 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();
+		}));
+	}
+	_scheduleFlush() {
+		if (!this._started || this._waitingCommandQueue.length === 0 && !this._hasPendingCalculation) return;
+		clearTimeout(this._timer);
+		this._timer = setTimeout(() => this._flush(), CALCULATION_DEBOUNCE_TIME);
+	}
+	_flush() {
+		const commands = this._waitingCommandQueue;
+		const dirtyData = this._generateDirty(commands);
+		this._waitingCommandQueue = [];
+		this._timer = void 0;
+		if (hasDirtyData(dirtyData) || commands.some(({ id }) => id === SetTriggerFormulaCalculationStartMutation.id)) {
+			this._pendingDirtyData = mergeDirtyData(this._pendingDirtyData, dirtyData);
+			this._hasPendingCalculation = true;
+		}
+		if (!this._hasPendingCalculation) return;
+		if (this._executionInProgress) {
+			if (!this._stopRequested && dirtyDataIntersects(this._runningDirtyData, this._pendingDirtyData)) {
+				this._stopRequested = true;
+				this._commandService.executeCommand(SetFormulaCalculationStopMutation.id, {}, LOCAL_ONLY);
+			}
+			return;
+		}
+		this._startCalculation();
+	}
+	_startCalculation() {
+		this._runningDirtyData = this._pendingDirtyData;
+		this._pendingDirtyData = createEmptyDirtyData();
+		this._hasPendingCalculation = false;
+		this._executionInProgress = true;
+		this._stopRequested = false;
+		this._commandService.executeCommand(SetFormulaCalculationStartMutation.id, { ...this._runningDirtyData }, LOCAL_ONLY);
+	}
+	_handleCalculationNotification(params) {
+		if (params.stageInfo != null) {
+			this._executionInProgress = true;
+			return;
+		}
+		const state = params.functionsExecutedState;
+		if (state == null) return;
+		if (!(state === 1 || state === 3 || state === 2) || !this._executionInProgress) return;
+		this._executionInProgress = false;
+		this._stopRequested = false;
+		if (state === 1) this._pendingDirtyData = mergeDirtyData(this._runningDirtyData, this._pendingDirtyData);
+		this._runningDirtyData = createEmptyDirtyData();
+		if (this._hasPendingCalculation || this._waitingCommandQueue.length > 0) this._scheduleFlush();
+	}
+	_generateDirty(commands) {
+		return commands.reduce((result, command) => {
+			const conversion = this._activeDirtyManagerService.get(command.id);
+			return conversion ? mergeDirtyData(result, conversion.getDirtyData(command)) : result;
+		}, createEmptyDirtyData());
+	}
+};
+FormulaCalculationTriggerService = __decorate([__decorateParam(0, ICommandService), __decorateParam(1, IActiveDirtyManagerService)], FormulaCalculationTriggerService);
+function createEmptyDirtyData() {
+	return {
+		forceCalculation: false,
+		dirtyRanges: [],
+		dirtyNameMap: {},
+		dirtyDefinedNameMap: {},
+		dirtySuperTableMap: {},
+		dirtyUnitFeatureMap: {},
+		dirtyUnitOtherFormulaMap: {},
+		clearDependencyTreeCache: {}
+	};
+}
+function mergeDirtyData(left, right) {
+	var _right$dirtyRanges, _left$dirtySuperTable;
+	const dirtyRanges = [...left.dirtyRanges];
+	mergeDirtyRanges(dirtyRanges, (_right$dirtyRanges = right.dirtyRanges) !== null && _right$dirtyRanges !== void 0 ? _right$dirtyRanges : []);
+	return {
+		dirtyRanges,
+		dirtyNameMap: mergeDirtyUnitStringMap(left.dirtyNameMap, right.dirtyNameMap),
+		dirtyDefinedNameMap: mergeDirtyUnitStringMap(left.dirtyDefinedNameMap, right.dirtyDefinedNameMap),
+		dirtySuperTableMap: mergeDirtyUnitStringMap((_left$dirtySuperTable = left.dirtySuperTableMap) !== null && _left$dirtySuperTable !== void 0 ? _left$dirtySuperTable : {}, right.dirtySuperTableMap),
+		dirtyUnitFeatureMap: mergeDirtyUnitNestedMap(left.dirtyUnitFeatureMap, right.dirtyUnitFeatureMap),
+		dirtyUnitOtherFormulaMap: mergeDirtyUnitNestedMap(left.dirtyUnitOtherFormulaMap, right.dirtyUnitOtherFormulaMap),
+		clearDependencyTreeCache: mergeDirtyUnitStringMap(left.clearDependencyTreeCache, right.clearDependencyTreeCache),
+		forceCalculation: left.forceCalculation || Boolean(right.forceCalculation)
+	};
+}
+function mergeDirtyRanges(target, source) {
+	const keys = new Set(target.map(getDirtyRangeKey));
+	source.forEach((range) => {
+		const key = getDirtyRangeKey(range);
+		if (!keys.has(key)) {
+			keys.add(key);
+			target.push(range);
+		}
+	});
+}
+function getDirtyRangeKey({ unitId, sheetId, range }) {
+	return JSON.stringify([
+		unitId,
+		sheetId,
+		range.startRow,
+		range.startColumn,
+		range.endRow,
+		range.endColumn,
+		range.rangeType
+	]);
+}
+function mergeDirtyUnitStringMap(left, right) {
+	const result = { ...left };
+	Object.entries(right !== null && right !== void 0 ? right : {}).forEach(([unitId, values]) => {
+		result[unitId] = {
+			...result[unitId],
+			...values
+		};
+	});
+	return result;
+}
+function mergeDirtyUnitNestedMap(left, right) {
+	const result = { ...left };
+	Object.entries(right !== null && right !== void 0 ? right : {}).forEach(([unitId, sheets]) => {
+		const unitResult = { ...result[unitId] };
+		Object.entries(sheets !== null && sheets !== void 0 ? sheets : {}).forEach(([sheetId, values]) => {
+			unitResult[sheetId] = {
+				...unitResult[sheetId],
+				...values
+			};
+		});
+		result[unitId] = unitResult;
+	});
+	return result;
+}
+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);
+}
+function hasNestedValue(value) {
+	if (value == null) return false;
+	if (typeof value !== "object") return true;
+	return Object.values(value).some(hasNestedValue);
+}
+function dirtyDataIntersects(left, right) {
+	if (left.forceCalculation || right.forceCalculation) return true;
+	if (left.dirtyRanges.some((leftRange) => right.dirtyRanges.some((rightRange) => leftRange.unitId === rightRange.unitId && leftRange.sheetId === rightRange.sheetId && Rectangle.intersects(leftRange.range, rightRange.range))) || clearedSheetIntersects(left, right) || clearedSheetIntersects(right, left)) return true;
+	return [
+		[left.dirtyNameMap, right.dirtyNameMap],
+		[left.dirtyDefinedNameMap, right.dirtyDefinedNameMap],
+		[left.dirtySuperTableMap, right.dirtySuperTableMap],
+		[left.dirtyUnitFeatureMap, right.dirtyUnitFeatureMap],
+		[left.dirtyUnitOtherFormulaMap, right.dirtyUnitOtherFormulaMap],
+		[left.clearDependencyTreeCache, right.clearDependencyTreeCache]
+	].some(([leftMap, rightMap]) => hasSameNestedKey(leftMap, rightMap));
+}
+function clearedSheetIntersects(cleared, dirty) {
+	return Object.entries(cleared.clearDependencyTreeCache).some(([unitId, sheets]) => Object.keys(sheets !== null && sheets !== void 0 ? sheets : {}).some((sheetId) => {
+		var _dirty$dirtyNameMap$u, _dirty$dirtyUnitFeatu, _dirty$dirtyUnitOther;
+		return dirty.dirtyRanges.some((range) => range.unitId === unitId && range.sheetId === sheetId) || ((_dirty$dirtyNameMap$u = dirty.dirtyNameMap[unitId]) === null || _dirty$dirtyNameMap$u === void 0 ? void 0 : _dirty$dirtyNameMap$u[sheetId]) != null || ((_dirty$dirtyUnitFeatu = dirty.dirtyUnitFeatureMap[unitId]) === null || _dirty$dirtyUnitFeatu === void 0 ? void 0 : _dirty$dirtyUnitFeatu[sheetId]) != null || ((_dirty$dirtyUnitOther = dirty.dirtyUnitOtherFormulaMap[unitId]) === null || _dirty$dirtyUnitOther === void 0 ? void 0 : _dirty$dirtyUnitOther[sheetId]) != null;
+	}));
+}
+function hasSameNestedKey(left, right) {
+	if (left == null || right == null || typeof left !== "object" || typeof right !== "object") return left != null && right != null;
+	const rightRecord = right;
+	return Object.entries(left).some(([key, value]) => Object.prototype.hasOwnProperty.call(rightRecord, key) && hasSameNestedKey(value, rightRecord[key]));
+}
+
+//#endregion
+//#region src/controllers/formula-calculation-trigger.controller.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.
+*/
+let FormulaCalculationTriggerController = class FormulaCalculationTriggerController extends Disposable {
+	constructor(formulaCalculationTriggerService, lifecycleService) {
+		super();
+		if (isNodeEnv()) {
+			formulaCalculationTriggerService.start();
+			return;
+		}
+		this.disposeWithMe(lifecycleService.lifecycle$.pipe(filter((stage) => stage >= LifecycleStages.Rendered), take(1)).subscribe(() => formulaCalculationTriggerService.start()));
+	}
+};
+FormulaCalculationTriggerController = __decorate([__decorateParam(0, Inject(FormulaCalculationTriggerService)), __decorateParam(1, Inject(LifecycleService))], FormulaCalculationTriggerController);
+
 //#endregion
 //#region src/controllers/formula.controller.ts
 let FormulaController = class FormulaController extends Disposable {
@@ -42070,153 +42601,6 @@ SetOtherFormulaController = __decorate([
 	__decorateParam(2, IDependencyManagerService)
 ], SetOtherFormulaController);
 
-//#endregion
-//#region src/services/formula-calculation-trigger.service.ts
-const LOCAL_ONLY = { onlyLocal: true };
-const CALCULATION_DEBOUNCE_TIME = 100;
-let FormulaCalculationTriggerService = class FormulaCalculationTriggerService extends Disposable {
-	constructor(_commandService, _activeDirtyManagerService) {
-		super();
-		this._commandService = _commandService;
-		this._activeDirtyManagerService = _activeDirtyManagerService;
-		_defineProperty(this, "_waitingCommandQueue", []);
-		_defineProperty(this, "_executingDirtyData", createEmptyDirtyData());
-		_defineProperty(this, "_timer", void 0);
-		_defineProperty(this, "_executionInProgress", false);
-		_defineProperty(this, "_restartCalculation", false);
-		this._initialize();
-	}
-	dispose() {
-		clearTimeout(this._timer);
-		this._waitingCommandQueue = [];
-		this._executingDirtyData = createEmptyDirtyData();
-		super.dispose();
-	}
-	_initialize() {
-		this.disposeWithMe(this._commandService.onCommandExecuted((command, options) => {
-			var _conversion$shouldTri;
-			if (command.id === SetFormulaCalculationStartMutation.id) {
-				this._executionInProgress = true;
-				return;
-			}
-			if (command.id === SetFormulaCalculationNotificationMutation.id) {
-				this._handleCalculationNotification(command.params);
-				return;
-			}
-			const conversion = this._activeDirtyManagerService.get(command.id);
-			if (!conversion) 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);
-			clearTimeout(this._timer);
-			this._timer = setTimeout(() => this._flush(), CALCULATION_DEBOUNCE_TIME);
-		}));
-	}
-	_flush() {
-		const dirtyData = this._generateDirty(this._waitingCommandQueue);
-		this._waitingCommandQueue = [];
-		this._timer = void 0;
-		if (!hasDirtyData(dirtyData)) return;
-		this._executingDirtyData = mergeDirtyData(this._executingDirtyData, dirtyData);
-		if (this._executionInProgress) {
-			this._restartCalculation = true;
-			this._commandService.executeCommand(SetFormulaCalculationStopMutation.id, {}, LOCAL_ONLY);
-			return;
-		}
-		this._startCalculation();
-	}
-	_startCalculation() {
-		this._executionInProgress = true;
-		this._commandService.executeCommand(SetFormulaCalculationStartMutation.id, { ...this._executingDirtyData }, LOCAL_ONLY);
-	}
-	_handleCalculationNotification(params) {
-		if (params.stageInfo != null) {
-			this._executionInProgress = true;
-			return;
-		}
-		const state = params.functionsExecutedState;
-		if (state == null) return;
-		this._executionInProgress = false;
-		if (state === 1 && this._restartCalculation) {
-			this._restartCalculation = false;
-			this._startCalculation();
-			return;
-		}
-		this._restartCalculation = false;
-		this._executingDirtyData = createEmptyDirtyData();
-	}
-	_generateDirty(commands) {
-		return commands.reduce((result, command) => {
-			const conversion = this._activeDirtyManagerService.get(command.id);
-			return conversion ? mergeDirtyData(result, conversion.getDirtyData(command)) : result;
-		}, createEmptyDirtyData());
-	}
-};
-FormulaCalculationTriggerService = __decorate([__decorateParam(0, ICommandService), __decorateParam(1, IActiveDirtyManagerService)], FormulaCalculationTriggerService);
-function createEmptyDirtyData() {
-	return {
-		forceCalculation: false,
-		dirtyRanges: [],
-		dirtyNameMap: {},
-		dirtyDefinedNameMap: {},
-		dirtySuperTableMap: {},
-		dirtyUnitFeatureMap: {},
-		dirtyUnitOtherFormulaMap: {},
-		clearDependencyTreeCache: {}
-	};
-}
-function mergeDirtyData(left, right) {
-	var _right$dirtyRanges, _left$dirtySuperTable;
-	const dirtyRanges = [...left.dirtyRanges];
-	mergeDirtyRanges(dirtyRanges, (_right$dirtyRanges = right.dirtyRanges) !== null && _right$dirtyRanges !== void 0 ? _right$dirtyRanges : []);
-	return {
-		dirtyRanges,
-		dirtyNameMap: mergeDirtyUnitStringMap(left.dirtyNameMap, right.dirtyNameMap),
-		dirtyDefinedNameMap: mergeDirtyUnitStringMap(left.dirtyDefinedNameMap, right.dirtyDefinedNameMap),
-		dirtySuperTableMap: mergeDirtyUnitStringMap((_left$dirtySuperTable = left.dirtySuperTableMap) !== null && _left$dirtySuperTable !== void 0 ? _left$dirtySuperTable : {}, right.dirtySuperTableMap),
-		dirtyUnitFeatureMap: mergeDirtyUnitNestedMap(left.dirtyUnitFeatureMap, right.dirtyUnitFeatureMap),
-		dirtyUnitOtherFormulaMap: mergeDirtyUnitNestedMap(left.dirtyUnitOtherFormulaMap, right.dirtyUnitOtherFormulaMap),
-		clearDependencyTreeCache: mergeDirtyUnitStringMap(left.clearDependencyTreeCache, right.clearDependencyTreeCache),
-		forceCalculation: left.forceCalculation || Boolean(right.forceCalculation)
-	};
-}
-function mergeDirtyRanges(target, source) {
-	source.forEach((range) => {
-		if (!target.some((item) => item.unitId === range.unitId && item.sheetId === range.sheetId && item.range.startRow === range.range.startRow && item.range.startColumn === range.range.startColumn && item.range.endRow === range.range.endRow && item.range.endColumn === range.range.endColumn)) target.push(range);
-	});
-}
-function mergeDirtyUnitStringMap(left, right) {
-	const result = { ...left };
-	Object.entries(right !== null && right !== void 0 ? right : {}).forEach(([unitId, values]) => {
-		result[unitId] = {
-			...result[unitId],
-			...values
-		};
-	});
-	return result;
-}
-function mergeDirtyUnitNestedMap(left, right) {
-	const result = { ...left };
-	Object.entries(right !== null && right !== void 0 ? right : {}).forEach(([unitId, sheets]) => {
-		const unitResult = { ...result[unitId] };
-		Object.entries(sheets !== null && sheets !== void 0 ? sheets : {}).forEach(([sheetId, values]) => {
-			unitResult[sheetId] = {
-				...unitResult[sheetId],
-				...values
-			};
-		});
-		result[unitId] = unitResult;
-	});
-	return result;
-}
-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);
-}
-function hasNestedValue(value) {
-	if (value == null) return false;
-	if (typeof value !== "object") return true;
-	return Object.values(value).some(hasNestedValue);
-}
-
 //#endregion
 //#region src/services/formula-common.ts
 let FormulaResultStatus = /* @__PURE__ */ function(FormulaResultStatus) {
@@ -42417,7 +42801,11 @@ let UniverFormulaEnginePlugin = class UniverFormulaEnginePlugin extends Plugin {
 	}
 	onReady() {
 		var _this$_config;
-		touchDependencies(this._injector, [[FormulaController], [SuperTableActiveDirtyController]]);
+		touchDependencies(this._injector, [
+			[FormulaController],
+			[FormulaCalculationTriggerController],
+			[SuperTableActiveDirtyController]
+		]);
 		if (!((_this$_config = this._config) === null || _this$_config === void 0 ? void 0 : _this$_config.notExecuteFormula)) touchDependencies(this._injector, [
 			[SetOtherFormulaController],
 			[SetFeatureCalculationController],
@@ -42443,6 +42831,7 @@ let UniverFormulaEnginePlugin = class UniverFormulaEnginePlugin extends Plugin {
 			[GlobalComputingStatusService],
 			[FormulaDataModel],
 			[FormulaController],
+			[FormulaCalculationTriggerController],
 			[SuperTableActiveDirtyController],
 			[ComputingStatusReporterController]
 		];
@@ -42455,7 +42844,8 @@ let UniverFormulaEnginePlugin = class UniverFormulaEnginePlugin extends Plugin {
 		if (!((_this$_config3 = this._config) === null || _this$_config3 === void 0 ? void 0 : _this$_config3.notExecuteFormula)) [
 			[ICalculateFormulaService, { useClass: CalculateFormulaService }],
 			[IDependencyManagerService, { useClass: DependencyManagerService }],
-			[IFormulaDependencyGenerator, { useClass: FormulaDependencyGenerator }]
+			[IFormulaDependencyGenerator, { useClass: FormulaDependencyGenerator }],
+			[IFormulaUnitReferenceResolver, { useClass: FormulaUnitReferenceResolver }]
 		].forEach((dependency) => this._injector.add(dependency));
 	}
 };
@@ -42465,4 +42855,4 @@ _defineProperty(UniverFormulaEnginePlugin, "version", version);
 UniverFormulaEnginePlugin = __decorate([__decorateParam(1, Inject(Injector)), __decorateParam(2, IConfigService)], UniverFormulaEnginePlugin);
 
 //#endregion
-export { ALL_IMPLEMENTED_FUNCTIONS, ALL_IMPLEMENTED_FUNCTIONS_SET, ActiveDirtyManagerService, ArrayValueObject, AstRootNodeFactory, AstTreeBuilder, AsyncArrayObject, AsyncCustomFunction, AsyncObject, BaseFunction, BaseReferenceObject, BaseValueObject, BooleanValue, BooleanValueObject, CELL_INVERTED_INDEX_CACHE, CalculateController, CalculateFormulaService, CustomFunction, DEFAULT_CYCLE_REFERENCE_COUNT, DEFAULT_INTERVAL_COUNT, DEFAULT_TOKEN_LAMBDA_FUNCTION_NAME, DEFAULT_TOKEN_LET_FUNCTION_NAME, DEFAULT_TOKEN_TYPE_LAMBDA_PARAMETER, DEFAULT_TOKEN_TYPE_PARAMETER, DEFAULT_TOKEN_TYPE_ROOT, DefinedNamesService, DependencyManagerBaseService, DependencyManagerService, ENGINE_FORMULA_CYCLE_REFERENCE_COUNT, ENGINE_FORMULA_PLUGIN_CONFIG_KEY, ENGINE_FORMULA_RETURN_DEPENDENCY_TREE, ERROR_TYPE_SET, ErrorType, ErrorValueObject, FORMULA_REF_TO_ARRAY_CACHE, FUNCTION_NAMES_ARRAY, FUNCTION_NAMES_COMPATIBILITY, FUNCTION_NAMES_CUBE, FUNCTION_NAMES_DATABASE, FUNCTION_NAMES_DATE, FUNCTION_NAMES_ENGINEERING, FUNCTION_NAMES_FINANCIAL, FUNCTION_NAMES_INFORMATION, FUNCTION_NAMES_LOGICAL, FUNCTION_NAMES_LOOKUP, FUNCTION_NAMES_MATH, FUNCTION_NAMES_STATISTICAL, FUNCTION_NAMES_TEXT, FUNCTION_NAMES_UNIVER, FUNCTION_NAMES_WEB, FeatureCalculationManagerService, FormulaCalculationTriggerService, FormulaCurrentConfigService, FormulaDataModel, FormulaDependencyGenerator, FormulaDependencyTree, FormulaDependencyTreeModel, FormulaDependencyTreeType, FormulaDependencyTreeVirtual, FormulaExecuteStageType, FormulaExecutedStateType, FormulaResultStatus, FormulaRuntimeService, FunctionNodeFactory, FunctionService, FunctionType, GlobalComputingStatusService, HyperlinkEngineFormulaService, IActiveDirtyManagerService, ICalculateFormulaService, IDefinedNamesService, IDependencyManagerService, IFeatureCalculationManagerService, IFormulaCurrentConfigService, IFormulaDependencyGenerator, IFormulaRuntimeService, IFunctionService, IHyperlinkEngineFormulaService, IOtherFormulaManagerService, ISheetRowFilteredService, ISuperTableService, Interpreter, LambdaNodeFactory, LambdaParameterNodeFactory, LambdaValueObjectObject, Lexer, LexerNode, LexerTreeBuilder, NEW_EXCEL_FUNCTIONS, NullValueObject, NumberValueObject, OPERATOR_TOKEN_SET, OperatorNodeFactory, OtherFormulaBizType, OtherFormulaManagerService, OtherFormulaMarkDirty, PrefixNodeFactory, RangeReferenceObject, ReferenceNodeFactory, RegisterFunctionMutation, RegisterOtherFormulaService, RemoveDefinedNameMutation, RemoveFeatureCalculationMutation, RemoveOtherFormulaMutation, RemoveSuperTableMutation, SUFFIX_TOKEN_SET, SetArrayFormulaDataMutation, SetCellFormulaDependencyCalculationMutation, SetCellFormulaDependencyCalculationResultMutation, SetDefinedNameMutation, SetDefinedNameMutationFactory, SetFeatureCalculationMutation, SetFormulaCalculationNotificationMutation, SetFormulaCalculationResultMutation, SetFormulaCalculationStartMutation, SetFormulaCalculationStopMutation, SetFormulaDataMutation, SetFormulaDependencyCalculationMutation, SetFormulaDependencyCalculationResultMutation, SetFormulaStringBatchCalculationMutation, SetFormulaStringBatchCalculationResultMutation, SetImageFormulaDataMutation, SetOtherFormulaMutation, SetQueryFormulaDependencyAllMutation, SetQueryFormulaDependencyAllResultMutation, SetQueryFormulaDependencyMutation, SetQueryFormulaDependencyResultMutation, SetSuperTableMutation, SetSuperTableOptionMutation, SetTriggerFormulaCalculationStartMutation, SheetRowFilteredService, StringValueObject, SuffixNodeFactory, SuperTableActiveDirtyController, SuperTableService, UnionNodeFactory, UniverFormulaEnginePlugin, ValueNodeFactory, ValueObjectFactory, compareToken, convertUnitDataToRuntime, deserializeRangeForR1C1, deserializeRangeWithSheet, deserializeRangeWithSheetWithCache, excelDateSerial, extractFormulaError, functionArray, functionCompatibility, functionCube, functionDatabase, functionDate, functionEngineering, functionFinancial, functionInformation, functionLogical, functionLookup, functionMath, functionMeta, functionStatistical, functionText, functionUniver, functionWeb, generateAstNode, generateExecuteAstNodeData, generateRandomDependencyTreeId, generateStringWithSequence, getAbsoluteRefTypeWitString, getAbsoluteRefTypeWithSingleString, getObjectValue, getRangeWithRefsString, handleNumfmtInCell, handleRefStringInfo, includeFormulaLexerToken, initSheetFormulaData, isFormulaLexerToken, isInDirtyRange, isReferenceString, isReferenceStringWithEffectiveColumn, isReferenceStrings, matchRefDrawToken, matchToken, needsQuoting, normalizeSheetName, operatorToken, prefixToken, quoteSheetName, sequenceNodeType, serializeRange, serializeRangeToRefString, serializeRangeWithSheet, serializeRangeWithSpreadsheet, singleReferenceToGrid, splitTableStructuredRef, strip, stripErrorMargin, unquoteSheetName };
+export { ALL_IMPLEMENTED_FUNCTIONS, ALL_IMPLEMENTED_FUNCTIONS_SET, ActiveDirtyManagerService, ArrayValueObject, AstRootNodeFactory, AstTreeBuilder, AsyncArrayObject, AsyncCustomFunction, AsyncObject, BaseFunction, BaseReferenceObject, BaseValueObject, BooleanValue, BooleanValueObject, CELL_INVERTED_INDEX_CACHE, CalculateController, CalculateFormulaService, CustomFunction, DEFAULT_CYCLE_REFERENCE_COUNT, DEFAULT_INTERVAL_COUNT, DEFAULT_TOKEN_LAMBDA_FUNCTION_NAME, DEFAULT_TOKEN_LET_FUNCTION_NAME, DEFAULT_TOKEN_TYPE_LAMBDA_PARAMETER, DEFAULT_TOKEN_TYPE_PARAMETER, DEFAULT_TOKEN_TYPE_ROOT, DefinedNamesService, DependencyManagerBaseService, DependencyManagerService, ENGINE_FORMULA_CYCLE_REFERENCE_COUNT, ENGINE_FORMULA_PLUGIN_CONFIG_KEY, ENGINE_FORMULA_RETURN_DEPENDENCY_TREE, ERROR_TYPE_SET, ErrorType, ErrorValueObject, FORMULA_REF_TO_ARRAY_CACHE, FUNCTION_NAMES_ARRAY, FUNCTION_NAMES_COMPATIBILITY, FUNCTION_NAMES_CUBE, FUNCTION_NAMES_DATABASE, FUNCTION_NAMES_DATE, FUNCTION_NAMES_ENGINEERING, FUNCTION_NAMES_FINANCIAL, FUNCTION_NAMES_INFORMATION, FUNCTION_NAMES_LOGICAL, FUNCTION_NAMES_LOOKUP, FUNCTION_NAMES_MATH, FUNCTION_NAMES_STATISTICAL, FUNCTION_NAMES_TEXT, FUNCTION_NAMES_UNIVER, FUNCTION_NAMES_WEB, FeatureCalculationManagerService, FormulaCalculationTriggerService, FormulaCurrentConfigService, FormulaDataModel, FormulaDependencyGenerator, FormulaDependencyTree, FormulaDependencyTreeModel, FormulaDependencyTreeType, FormulaDependencyTreeVirtual, FormulaExecuteStageType, FormulaExecutedStateType, FormulaResultStatus, FormulaRuntimeService, FormulaUnitReferenceResolver, FunctionNodeFactory, FunctionService, FunctionType, GlobalComputingStatusService, HyperlinkEngineFormulaService, IActiveDirtyManagerService, ICalculateFormulaService, IDefinedNamesService, IDependencyManagerService, IFeatureCalculationManagerService, IFormulaCurrentConfigService, IFormulaDependencyGenerator, IFormulaRuntimeService, IFormulaUnitReferenceResolver, IFunctionService, IHyperlinkEngineFormulaService, IOtherFormulaManagerService, ISheetRowFilteredService, ISuperTableService, Interpreter, LambdaNodeFactory, LambdaParameterNodeFactory, LambdaValueObjectObject, Lexer, LexerNode, LexerTreeBuilder, NEW_EXCEL_FUNCTIONS, NullValueObject, NumberValueObject, OPERATOR_TOKEN_SET, OperatorNodeFactory, OtherFormulaBizType, OtherFormulaManagerService, OtherFormulaMarkDirty, PrefixNodeFactory, RangeReferenceObject, ReferenceNodeFactory, RegisterFunctionMutation, RegisterOtherFormulaService, RemoveDefinedNameMutation, RemoveFeatureCalculationMutation, RemoveOtherFormulaMutation, RemoveSuperTableMutation, SUFFIX_TOKEN_SET, SetArrayFormulaDataMutation, SetCellFormulaDependencyCalculationMutation, SetCellFormulaDependencyCalculationResultMutation, SetDefinedNameMutation, SetDefinedNameMutationFactory, SetFeatureCalculationMutation, SetFormulaCalculationNotificationMutation, SetFormulaCalculationResultMutation, SetFormulaCalculationStartMutation, SetFormulaCalculationStopMutation, SetFormulaDataMutation, SetFormulaDependencyCalculationMutation, SetFormulaDependencyCalculationResultMutation, SetFormulaStringBatchCalculationMutation, SetFormulaStringBatchCalculationResultMutation, SetImageFormulaDataMutation, SetOtherFormulaMutation, SetQueryFormulaDependencyAllMutation, SetQueryFormulaDependencyAllResultMutation, SetQueryFormulaDependencyMutation, SetQueryFormulaDependencyResultMutation, SetSuperTableMutation, SetSuperTableOptionMutation, SetTriggerFormulaCalculationStartMutation, SheetRowFilteredService, StringValueObject, SuffixNodeFactory, SuperTableActiveDirtyController, SuperTableService, UnionNodeFactory, UniverFormulaEnginePlugin, ValueNodeFactory, ValueObjectFactory, compareToken, convertUnitDataToRuntime, deserializeRangeForR1C1, deserializeRangeWithSheet, deserializeRangeWithSheetWithCache, excelDateSerial, extractFormulaError, functionArray, functionCompatibility, functionCube, functionDatabase, functionDate, functionEngineering, functionFinancial, functionInformation, functionLogical, functionLookup, functionMath, functionMeta, functionStatistical, functionText, functionUniver, functionWeb, generateAstNode, generateExecuteAstNodeData, generateRandomDependencyTreeId, generateStringWithSequence, getAbsoluteRefTypeWitString, getAbsoluteRefTypeWithSingleString, getObjectValue, getRangeWithRefsString, handleNumfmtInCell, handleRefStringInfo, includeFormulaLexerToken, initSheetFormulaData, isFormulaLexerToken, isInDirtyRange, isReferenceString, isReferenceStringWithEffectiveColumn, isReferenceStrings, matchRefDrawToken, matchToken, needsQuoting, normalizeFormulaUnitName, normalizeSheetName, operatorToken, prefixToken, quoteSheetName, refactorFormulaUnitQualifier, sequenceNodeType, serializeRange, serializeRangeToRefString, serializeRangeWithSheet, serializeRangeWithSpreadsheet, singleReferenceToGrid, splitTableStructuredRef, strip, stripErrorMargin, unquoteSheetName };