@univerjs/engine-formula 1.0.0-alpha.2 → 1.0.0-alpha.4

package/lib/types/functions/text/call/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 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.
+ */
+import { NotImplementedFunction } from '../../not-implemented-function';
+export declare class Call extends NotImplementedFunction {
+    minParams: number;
+    maxParams: number;
+}

package/lib/types/functions/text/euroconvert/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 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.
+ */
+import { NotImplementedFunction } from '../../not-implemented-function';
+export declare class Euroconvert extends NotImplementedFunction {
+    minParams: number;
+    maxParams: number;
+}

package/lib/types/functions/text/function-names.d.ts

@@ -41,6 +41,7 @@ export declare enum FUNCTION_NAMES_TEXT {
     PROPER = "PROPER",
     REGEXEXTRACT = "REGEXEXTRACT",
     REGEXMATCH = "REGEXMATCH",
+    REGEXTEST = "REGEXTEST",
     REGEXREPLACE = "REGEXREPLACE",
     REPLACE = "REPLACE",
     REPLACEB = "REPLACEB",

package/lib/types/functions/text/phonetic/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 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.
+ */
+import { NotImplementedFunction } from '../../not-implemented-function';
+export declare class Phonetic extends NotImplementedFunction {
+    minParams: number;
+    maxParams: number;
+}

package/lib/types/functions/text/register-id/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 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.
+ */
+import { NotImplementedFunction } from '../../not-implemented-function';
+export declare class RegisterId extends NotImplementedFunction {
+    minParams: number;
+    maxParams: number;
+}

package/lib/types/functions/text/textsplit/index.d.ts

@@ -25,4 +25,5 @@ export declare class Textsplit extends BaseFunction {
     private _getResult;
     private _checkVariantsError;
     private _getRegExpStringValue;
+    private _isBlankScalarDelimiter;
 }

package/lib/types/functions/web/filterxml/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 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.
+ */
+import type { BaseValueObject } from '../../../engine/value-object/base-value-object';
+import { BaseFunction } from '../../base-function';
+export declare class Filterxml extends BaseFunction {
+    minParams: number;
+    maxParams: number;
+    calculate(xml: BaseValueObject, xpath: BaseValueObject): BaseValueObject;
+}

package/lib/types/functions/web/function-map.d.ts

@@ -13,6 +13,6 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { Encodeurl } from './encodeurl';
+import { Filterxml } from './filterxml';
 import { FUNCTION_NAMES_WEB } from './function-names';
-export declare const functionWeb: (FUNCTION_NAMES_WEB | typeof Encodeurl)[][];
+export declare const functionWeb: (FUNCTION_NAMES_WEB | typeof Filterxml)[][];

package/lib/types/functions/web/webservice/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 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.
+ */
+import { NotImplementedFunction } from '../../not-implemented-function';
+export declare class Webservice extends NotImplementedFunction {
+    minParams: number;
+    maxParams: number;
+}

package/lib/types/index.d.ts

@@ -13,7 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-export type { IArrayFormulaEmbeddedMap, IArrayFormulaRangeType, IArrayFormulaUnitCellType, IDirtyUnitDefinedNameMap, IDirtyUnitFeatureMap, IDirtyUnitOtherFormulaMap, IDirtyUnitSheetNameMap, IDirtyUnitSuperTableMap, IFeatureDirtyRangeType, IFormulaData, IFormulaDataItem, IFormulaDatasetConfig, IFormulaExecuteResultMap, IFormulaStringMap, IRuntimeImageFormulaDataType, IRuntimeUnitDataType, ISheetData, IUnitData, IUnitImageFormulaDataType, IUnitSheetNameMap, } from './basics/common';
+export type { FormulaUnitType, IArrayFormulaEmbeddedMap, IArrayFormulaRangeType, IArrayFormulaUnitCellType, IDirtyUnitDefinedNameMap, IDirtyUnitFeatureMap, IDirtyUnitOtherFormulaMap, IDirtyUnitSheetNameMap, IDirtyUnitSuperTableMap, IFeatureDirtyRangeType, IFormulaData, IFormulaDataItem, IFormulaDatasetConfig, IFormulaExecuteResultMap, IFormulaStringMap, IFormulaUnitNameMap, IFormulaUnitNameMapItem, IRuntimeImageFormulaDataType, IRuntimeUnitDataType, ISheetData, IUnitData, IUnitImageFormulaDataType, IUnitSheetNameMap, } from './basics/common';
 export { BooleanValue } from './basics/common';
 export { type IOtherFormulaData } from './basics/common';
 export type { IExprTreeNode, ISuperTable, IUnitRowData } from './basics/common';
@@ -48,10 +48,11 @@ export type { ISetImageFormulaDataMutationParams } from './commands/mutations/se
 export { RemoveOtherFormulaMutation, SetOtherFormulaMutation } from './commands/mutations/set-other-formula.mutation';
 export type { IRemoveOtherFormulaMutationParams, ISetOtherFormulaMutationParams, } from './commands/mutations/set-other-formula.mutation';
 export { RemoveSuperTableMutation, SetSuperTableMutation, SetSuperTableOptionMutation, } from './commands/mutations/set-super-table.mutation';
-export type { ISetSuperTableMutationParam, ISetSuperTableMutationSearchParam, } from './commands/mutations/set-super-table.mutation';
+export type { IRemoveSuperTableMutationParam, ISetSuperTableMutationParam, ISetSuperTableMutationSearchParam, } from './commands/mutations/set-super-table.mutation';
 export { DEFAULT_CYCLE_REFERENCE_COUNT, ENGINE_FORMULA_CYCLE_REFERENCE_COUNT, ENGINE_FORMULA_PLUGIN_CONFIG_KEY, ENGINE_FORMULA_RETURN_DEPENDENCY_TREE, } from './config/config';
 export type { IUniverEngineFormulaConfig } from './config/config';
 export { CalculateController } from './controllers/calculate.controller';
+export { SuperTableActiveDirtyController } from './controllers/super-table-active-dirty.controller';
 export { Lexer } from './engine/analysis/lexer';
 export { LexerNode } from './engine/analysis/lexer-node';
 export { LexerTreeBuilder } from './engine/analysis/lexer-tree-builder';
@@ -90,6 +91,7 @@ export { handleRefStringInfo } from './engine/utils/reference';
 export { deserializeRangeWithSheetWithCache } from './engine/utils/reference-cache';
 export { generateStringWithSequence, sequenceNodeType } from './engine/utils/sequence';
 export type { ISequenceNode } from './engine/utils/sequence';
+export { refactorFormulaUnitQualifier } from './engine/utils/unit-qualifier';
 export { ArrayValueObject, ValueObjectFactory } from './engine/value-object/array-value-object';
 export { BaseValueObject, ErrorValueObject } from './engine/value-object/base-value-object';
 export { LambdaValueObjectObject } from './engine/value-object/lambda-value-object';
@@ -147,6 +149,7 @@ export { DependencyManagerService } from './services/dependency-manager.service'
 export { DependencyManagerBaseService } from './services/dependency-manager.service';
 export { FeatureCalculationManagerService, IFeatureCalculationManagerService, } from './services/feature-calculation-manager.service';
 export type { IFeatureCalculationManagerParam } from './services/feature-calculation-manager.service';
+export { FormulaCalculationTriggerService } from './services/formula-calculation-trigger.service';
 export type { IFormulaInfo, IOtherFormulaResult } from './services/formula-common';
 export { FormulaResultStatus } from './services/formula-common';
 export { FunctionService } from './services/function.service';
@@ -160,3 +163,5 @@ export type { IAllRuntimeData, IExecutionInProgressParams } from './services/run
 export { ISheetRowFilteredService, SheetRowFilteredService } from './services/sheet-row-filtered.service';
 export { ISuperTableService } from './services/super-table.service';
 export { SuperTableService } from './services/super-table.service';
+export { FormulaUnitReferenceResolver, IFormulaUnitReferenceResolver, normalizeFormulaUnitName, } from './services/unit-reference-resolver.service';
+export type { FormulaUnitReferenceKind, IFormulaUnitReferenceResolution, IFormulaUnitReferenceResolveInput, } from './services/unit-reference-resolver.service';

package/lib/types/models/formula-data.model.d.ts

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 import type { ICellData, IObjectMatrixPrimitiveType, IRange, IUnitRange, Nullable } from '@univerjs/core';
-import type { IArrayFormulaRangeType, IArrayFormulaUnitCellType, IFormulaData, IFormulaDataItem, IRuntimeUnitDataType, IUnitData, IUnitImageFormulaDataType, IUnitRowData, IUnitSheetNameMap, IUnitStylesData } from '../basics/common';
+import type { IArrayFormulaRangeType, IArrayFormulaUnitCellType, IFormulaData, IFormulaDataItem, IFormulaUnitNameMap, IRuntimeUnitDataType, IUnitData, IUnitImageFormulaDataType, IUnitRowData, IUnitSheetNameMap, IUnitStylesData } from '../basics/common';
 import { Disposable, IUniverInstanceService, ObjectMatrix } from '@univerjs/core';
 import { LexerTreeBuilder } from '../engine/analysis/lexer-tree-builder';
 export interface IRangeChange {
@@ -46,6 +46,7 @@ export declare class FormulaDataModel extends Disposable {
         allUnitData: IUnitData;
         unitStylesData: IUnitStylesData;
         unitSheetNameMap: IUnitSheetNameMap;
+        unitNameMap: IFormulaUnitNameMap;
     };
     /**
      * Get the hidden rows that are filtered or manually hidden.
@@ -54,6 +55,7 @@ export declare class FormulaDataModel extends Disposable {
      */
     getHiddenRowsFiltered(): IUnitRowData;
     updateFormulaData(unitId: string, sheetId: string, cellValue: IObjectMatrixPrimitiveType<Nullable<ICellData>>): IObjectMatrixPrimitiveType<IFormulaDataItem | null>;
+    private _rebindSharedFormulaData;
     updateArrayFormulaRange(unitId: string, sheetId: string, cellValue: IObjectMatrixPrimitiveType<Nullable<ICellData>>): boolean;
     updateArrayFormulaCellData(unitId: string, sheetId: string, cellValue: IObjectMatrixPrimitiveType<Nullable<ICellData>>): boolean;
     updateImageFormulaData(unitId: string, sheetId: string, cellValue: IObjectMatrixPrimitiveType<Nullable<ICellData>>): void;
@@ -63,6 +65,6 @@ export declare class FormulaDataModel extends Disposable {
      * @returns
      */
     getFormulaDirtyRanges(): IUnitRange[];
-    private _getSheetFormulaIdMap;
+    private _initSheetArrayFormulaData;
 }
 export declare function initSheetFormulaData(formulaData: IFormulaData, unitId: string, sheetId: string, cellMatrix: ObjectMatrix<Nullable<ICellData>>): IFormulaData;

package/lib/types/services/active-dirty-manager.service.d.ts

@@ -13,11 +13,12 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import type { ICommandInfo, IUnitRange, Nullable } from '@univerjs/core';
+import type { ICommandInfo, IExecutionOptions, IUnitRange, Nullable } from '@univerjs/core';
 import type { IDirtyUnitDefinedNameMap, IDirtyUnitFeatureMap, IDirtyUnitOtherFormulaMap, IDirtyUnitSheetNameMap, IDirtyUnitSuperTableMap } from '../basics/common';
 import { Disposable } from '@univerjs/core';
 export interface IDirtyConversionManagerParams {
     commandId: string;
+    shouldTrigger?: (command: ICommandInfo, options?: IExecutionOptions) => boolean;
     getDirtyData: (command: ICommandInfo) => {
         forceCalculation?: boolean;
         dirtyRanges?: IUnitRange[];

package/lib/types/services/calculate-formula.service.d.ts

@@ -37,7 +37,7 @@ export interface ICalculateFormulaService {
     setRuntimeFeatureRange(featureId: string, featureRange: IFeatureDirtyRangeType): void;
     execute(formulaDatasetConfig: IFormulaDatasetConfig): Promise<void>;
     stopFormulaExecution(): void;
-    calculate(formulaString: string, transformSuffix?: boolean): void;
+    calculate(formulaString: string, transformSuffix?: boolean, unitId?: string): void;
     executeFormulas(formulas: IFormulaStringMap, rowData?: IUnitRowData): Promise<IFormulaExecuteResultMap>;
     getAllDependencyJson(rowData?: IUnitRowData): Promise<IFormulaDependencyTreeJson[]>;
     getCellDependencyJson(unitId: string, sheetId: string, row: number, column: number, rowData?: IUnitRowData): Promise<IFormulaDependencyTreeFullJson | undefined>;
@@ -85,7 +85,7 @@ export declare class CalculateFormulaService extends Disposable implements ICalc
     };
     protected _apply(isArrayFormulaState?: boolean): Promise<IAllRuntimeData | undefined>;
     executeFormulas(formulas: IFormulaStringMap, rowData?: IUnitRowData): Promise<IFormulaExecuteResultMap>;
-    calculate(formulaString: string): Promise<FunctionVariantType | undefined>;
+    calculate(formulaString: string, transformSuffix?: boolean, unitId?: string): Promise<FunctionVariantType | undefined>;
     getAllDependencyJson(): Promise<IFormulaDependencyTreeJson[]>;
     getCellDependencyJson(unitId: string, sheetId: string, row: number, column: number): Promise<IFormulaDependencyTreeFullJson | undefined>;
     getRangeDependents(unitRanges: IUnitRange[]): Promise<IFormulaDependencyTreeJson[]>;

package/lib/types/services/current-data.service.d.ts

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 import type { IUnitRange, LocaleType, Nullable } from '@univerjs/core';
-import type { IArrayFormulaRangeType, IDirtyUnitDefinedNameMap, IDirtyUnitFeatureMap, IDirtyUnitOtherFormulaMap, IDirtyUnitSheetNameMap, IDirtyUnitSuperTableMap, IFormulaData, IFormulaDatasetConfig, IRuntimeUnitDataType, IUnitData, IUnitExcludedCell, IUnitRowData, IUnitSheetIdToNameMap, IUnitSheetNameMap, IUnitStylesData } from '../basics/common';
+import type { IArrayFormulaRangeType, IDirtyUnitDefinedNameMap, IDirtyUnitFeatureMap, IDirtyUnitOtherFormulaMap, IDirtyUnitSheetNameMap, IDirtyUnitSuperTableMap, IFormulaData, IFormulaDatasetConfig, IFormulaUnitNameMap, IRuntimeUnitDataType, IUnitData, IUnitExcludedCell, IUnitRowData, IUnitSheetIdToNameMap, IUnitSheetNameMap, IUnitStylesData } from '../basics/common';
 import { Disposable, IUniverInstanceService, LocaleService } from '@univerjs/core';
 import { FormulaDataModel } from '../models/formula-data.model';
 import { ISheetRowFilteredService } from './sheet-row-filtered.service';
@@ -40,6 +40,7 @@ export interface IFormulaCurrentConfigService {
     getUnitStylesData(): IUnitStylesData;
     getFormulaData(): IFormulaData;
     getSheetNameMap(): IUnitSheetNameMap;
+    getUnitNameMap(): IFormulaUnitNameMap;
     isForceCalculate(): boolean;
     getDirtyRanges(): IUnitRange[];
     getDirtyNameMap(): IDirtyUnitSheetNameMap;
@@ -49,6 +50,7 @@ export interface IFormulaCurrentConfigService {
     registerUnitData(unitData: IUnitData): void;
     registerFormulaData(formulaData: IFormulaData): void;
     registerSheetNameMap(sheetNameMap: IUnitSheetNameMap): void;
+    registerUnitNameMap(unitNameMap: IFormulaUnitNameMap): void;
     getExcludedRange(): Nullable<IUnitExcludedCell>;
     loadDirtyRangesAndExcludedCell(dirtyRanges: IUnitRange[], excludedCell?: IUnitExcludedCell): void;
     getArrayFormulaCellData(): IRuntimeUnitDataType;
@@ -87,6 +89,7 @@ export declare class FormulaCurrentConfigService extends Disposable implements I
     private _arrayFormulaRange;
     private _formulaData;
     private _sheetNameMap;
+    private _unitNameMap;
     private _forceCalculate;
     private _clearDependencyTreeCache;
     private _dirtyRanges;
@@ -112,6 +115,7 @@ export declare class FormulaCurrentConfigService extends Disposable implements I
     getArrayFormulaCellData(): IRuntimeUnitDataType;
     getArrayFormulaRange(): IArrayFormulaRangeType;
     getSheetNameMap(): IUnitSheetNameMap;
+    getUnitNameMap(): IFormulaUnitNameMap;
     isForceCalculate(): boolean;
     getDirtyRanges(): IUnitRange[];
     getDirtyNameMap(): IDirtyUnitSheetNameMap;
@@ -141,6 +145,7 @@ export declare class FormulaCurrentConfigService extends Disposable implements I
     registerUnitData(unitData: IUnitData): void;
     registerFormulaData(formulaData: IFormulaData): void;
     registerSheetNameMap(sheetNameMap: IUnitSheetNameMap): void;
+    registerUnitNameMap(unitNameMap: IFormulaUnitNameMap): void;
     private _mergeNameMap;
     private _loadSheetData;
     /**

package/lib/types/services/defined-names.service.d.ts

@@ -43,7 +43,7 @@ export interface IDefinedNamesService {
     registerDefinedName(unitId: string, param: IDefinedNamesServiceParam): void;
     registerDefinedNames(unitId: string, params: IDefinedNameMapItem): void;
     getDefinedNameMap(unitId: string): Nullable<IDefinedNameMapItem>;
-    getValueByName(unitId: string, name: string): Nullable<IDefinedNamesServiceParam>;
+    getValueByName(unitId: string, name: string, sheetId?: Nullable<string>): Nullable<IDefinedNamesServiceParam>;
     getValueById(unitId: string, id: string): Nullable<IDefinedNamesServiceParam>;
     removeDefinedName(unitId: string, name: string): void;
     removeUnitDefinedName(unitId: string): void;
@@ -84,7 +84,7 @@ export declare class DefinedNamesService extends Disposable implements IDefinedN
     removeDefinedName(unitId: string, id: string): void;
     removeUnitDefinedName(unitId: string): void;
     getDefinedNameMap(unitId: string): IDefinedNameMapItem;
-    getValueByName(unitId: string, name: string): IDefinedNamesServiceParam | null;
+    getValueByName(unitId: string, name: string, sheetId?: Nullable<string>): IDefinedNamesServiceParam | null;
     getValueById(unitId: string, id: string): IDefinedNamesServiceParam;
     hasDefinedName(unitId: string): boolean;
     getAllDefinedNames(): IDefinedNameMap;

package/lib/types/services/formula-calculation-trigger.service.d.ts

@@ -0,0 +1,43 @@
+/**
+ * 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.
+ */
+import { Disposable, ICommandService } from '@univerjs/core';
+import { IActiveDirtyManagerService } from './active-dirty-manager.service';
+/**
+ * Converts commands registered in ActiveDirtyManagerService into one formula
+ * calculation stream. Product packages register dirty conversions, while this
+ * service owns batching and restart semantics for every unit type.
+ */
+export declare class FormulaCalculationTriggerService extends Disposable {
+    private readonly _commandService;
+    private readonly _activeDirtyManagerService;
+    private _waitingCommandQueue;
+    private _pendingDirtyData;
+    private _runningDirtyData;
+    private _timer;
+    private _started;
+    private _executionInProgress;
+    private _hasPendingCalculation;
+    private _stopRequested;
+    constructor(_commandService: ICommandService, _activeDirtyManagerService: IActiveDirtyManagerService);
+    start(): void;
+    dispose(): void;
+    private _initialize;
+    private _scheduleFlush;
+    private _flush;
+    private _startCalculation;
+    private _handleCalculationNotification;
+    private _generateDirty;
+}

package/lib/types/services/runtime.service.d.ts

@@ -70,11 +70,14 @@ export interface IExecutionInProgressParams {
 export interface IFormulaRuntimeService {
     currentRow: number;
     currentColumn: number;
+    currentRowCount: number;
+    currentColumnCount: number;
     currentSubUnitId: string;
     currentUnitId: string;
     dispose(): void;
     reset(): void;
     setCurrent(row: number, column: number, rowCount: number, columnCount: number, sheetId: string, unitId: string): void;
+    setFunctionRefInfoOverride(rowCount: number, columnCount: number): () => void;
     registerFunctionDefinitionPrivacyVar(lambdaId: string, lambdaVar: Map<string, Nullable<BaseAstNode>>): void;
     getFunctionDefinitionPrivacyVar(lambdaId: string): Nullable<Map<string, Nullable<BaseAstNode>>>;
     setRuntimeData(functionVariant: FunctionVariantType): void;
@@ -130,6 +133,7 @@ export declare class FormulaRuntimeService extends Disposable implements IFormul
     private _currentColumn;
     private _currentRowCount;
     private _currentColumnCount;
+    private _functionRefInfoOverrideStack;
     private _currentSubUnitId;
     private _currentUnitId;
     private _runtimeData;
@@ -182,6 +186,7 @@ export declare class FormulaRuntimeService extends Disposable implements IFormul
     reset(): void;
     clearReferenceAndNumberformatCache(): void;
     setCurrent(row: number, column: number, rowCount: number, columnCount: number, sheetId: string, unitId: string): void;
+    setFunctionRefInfoOverride(rowCount: number, columnCount: number): () => void;
     clearFunctionDefinitionPrivacyVar(): void;
     registerFunctionDefinitionPrivacyVar(lambdaId: string, lambdaVar: Map<string, Nullable<BaseAstNode>>): void;
     getFunctionDefinitionPrivacyVar(lambdaId: string): Nullable<Map<string, Nullable<BaseAstNode>>>;
@@ -223,6 +228,7 @@ export declare class FormulaRuntimeService extends Disposable implements IFormul
      * @returns
      */
     private _isInOtherArrayFormulaRange;
+    private _isCurrentSingleCellArrayFormulaRange;
     private _isInArrayFormulaRange;
     private _isSameCellValue;
     private _checkIfArrayFormulaExceeded;

package/lib/types/services/unit-reference-resolver.service.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 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.
+ */
+import type { FormulaUnitType } from '../basics/common';
+import { ErrorType } from '../basics/error-type';
+import { IFormulaCurrentConfigService } from './current-data.service';
+export type FormulaUnitReferenceKind = 'a1' | 'table';
+export interface IFormulaUnitReferenceResolveInput {
+    hostUnitId: string;
+    qualifier: string;
+    referenceKind: FormulaUnitReferenceKind;
+}
+export interface IFormulaUnitReferenceResolution {
+    unitId: string;
+    unitType?: FormulaUnitType;
+}
+export interface IFormulaUnitReferenceResolver {
+    resolve(input: IFormulaUnitReferenceResolveInput): IFormulaUnitReferenceResolution | ErrorType;
+}
+export declare const IFormulaUnitReferenceResolver: import("@wendellhu/redi").IdentifierDecorator<IFormulaUnitReferenceResolver>;
+export declare function normalizeFormulaUnitName(name: string): string;
+export declare class FormulaUnitReferenceResolver implements IFormulaUnitReferenceResolver {
+    protected readonly _currentConfigService: IFormulaCurrentConfigService;
+    constructor(_currentConfigService: IFormulaCurrentConfigService);
+    resolve({ hostUnitId, qualifier, referenceKind, }: IFormulaUnitReferenceResolveInput): IFormulaUnitReferenceResolution | ErrorType;
+    private _validateReferenceKind;
+}