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

package/lib/types/functions/logical/iferror/index.d.ts

@@ -13,11 +13,14 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+import type { FunctionVariantType } from '../../../engine/reference-object/base-reference-object';
 import type { ArrayValueObject } from '../../../engine/value-object/array-value-object';
 import type { BaseValueObject } from '../../../engine/value-object/base-value-object';
 import { BaseFunction } from '../../base-function';
 export declare class Iferror extends BaseFunction {
     minParams: number;
     maxParams: number;
-    calculate(value: BaseValueObject, valueIfError: BaseValueObject): BaseValueObject | ArrayValueObject;
+    needsReferenceObject: boolean;
+    calculate(value: FunctionVariantType, valueIfError: FunctionVariantType): BaseValueObject | ArrayValueObject;
+    private _toValueObject;
 }

package/lib/types/functions/logical/percentof/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 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 { ErrorValueObject } from '../../../engine/value-object/base-value-object';
+import { BaseFunction } from '../../base-function';
+/**
+ * PERCENTOF is an Excel GROUPBY aggregator token. It is evaluated by GROUPBY's
+ * AST path, not as a standalone scalar function.
+ */
+export declare class Percentof extends BaseFunction {
+    minParams: number;
+    maxParams: number;
+    calculate(..._variants: BaseValueObject[]): ErrorValueObject;
+}

package/lib/types/functions/lookup/anchorarray/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 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 { FunctionVariantType } from '../../../engine/reference-object/base-reference-object';
+import { BaseFunction } from '../../base-function';
+export declare class Anchorarray extends BaseFunction {
+    minParams: number;
+    maxParams: number;
+    needsReferenceObject: boolean;
+    calculate(reference: FunctionVariantType): FunctionVariantType;
+}

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

@@ -15,6 +15,7 @@
  */
 export declare enum FUNCTION_NAMES_LOOKUP {
     ADDRESS = "ADDRESS",
+    ANCHORARRAY = "ANCHORARRAY",
     AREAS = "AREAS",
     CHOOSE = "CHOOSE",
     CHOOSECOLS = "CHOOSECOLS",

package/lib/types/functions/lookup/getpivotdata/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 Getpivotdata extends NotImplementedFunction {
+    minParams: number;
+    maxParams: number;
+}

package/lib/types/functions/lookup/hlookup/index.d.ts

@@ -20,4 +20,5 @@ export declare class Hlookup extends BaseFunction {
     maxParams: number;
     calculate(lookupValue: BaseValueObject, tableArray: BaseValueObject, rowIndexNum: BaseValueObject, rangeLookup?: BaseValueObject): BaseValueObject;
     private _handleSingleObject;
+    private _blankResultAsZero;
 }

package/lib/types/functions/lookup/indirect/index.d.ts

@@ -30,4 +30,5 @@ export declare class Indirect extends BaseFunction {
      * =INDIRECT("DefinedName1")
      */
     private _convertToDefinedName;
+    private _matchErrorLiteral;
 }

package/lib/types/functions/lookup/rtd/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 Rtd extends NotImplementedFunction {
+    minParams: number;
+    maxParams: number;
+}

package/lib/types/functions/lookup/vlookup/index.d.ts

@@ -24,4 +24,6 @@ export declare class Vlookup extends BaseFunction {
     private _handleNonArrayColIndexNum;
     private _handleTableArray;
     private _handleSingleObject;
+    private _equalSearchBlankLookupValue;
+    private _blankResultAsZero;
 }

package/lib/types/functions/lookup/xlookup/index.d.ts

@@ -20,8 +20,10 @@ export declare class Xlookup extends BaseFunction {
     maxParams: number;
     calculate(lookupValue: BaseValueObject, lookupArray: BaseValueObject, returnArray: BaseValueObject, ifNotFound?: BaseValueObject, matchMode?: BaseValueObject, searchMode?: BaseValueObject): BaseValueObject;
     private _getResult;
+    private _legacyImplicitLookupValue;
     private _handleExpandObject;
     private _handleSingleObject;
+    private _blankResultAsZero;
     /**
      * Wildcard matching and binary search cannot appear at the same time
      * @param matchModeValue

package/lib/types/functions/math/iso-ceiling/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 IsoCeiling extends NotImplementedFunction {
+    minParams: number;
+    maxParams: number;
+}

package/lib/types/functions/math/sum/index.d.ts

@@ -19,4 +19,5 @@ export declare class Sum extends BaseFunction {
     minParams: number;
     maxParams: number;
     calculate(...variants: BaseValueObject[]): BaseValueObject;
+    private _legacyImplicitDerivedArray;
 }

package/lib/types/functions/meta/compare/index.d.ts

@@ -22,4 +22,5 @@ export declare class Compare extends BaseFunction {
     private _compareType;
     setCompareType(token: compareToken): void;
     calculate(variant1: BaseValueObject, variant2: BaseValueObject): BaseValueObject;
+    private _coerceErrorLiteral;
 }

package/lib/types/functions/not-implemented-function.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 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';
+/**
+ * Shared behavior for registered functions whose runtime integration is not implemented yet.
+ */
+export declare abstract class NotImplementedFunction extends BaseFunction {
+    calculate(..._variants: BaseValueObject[]): BaseValueObject;
+}

package/lib/types/functions/statistical/average/index.d.ts

@@ -19,4 +19,5 @@ export declare class Average extends BaseFunction {
     minParams: number;
     maxParams: number;
     calculate(...variants: BaseValueObject[]): BaseValueObject;
+    private _legacyImplicitDerivedArray;
 }

package/lib/types/functions/statistical/countifs/index.d.ts

@@ -21,4 +21,5 @@ export declare class Countifs extends BaseFunction {
     maxParams: number;
     needsReferenceObject: boolean;
     calculate(...variants: FunctionVariantType[]): BaseValueObject;
+    private _legacyImplicitDerivedCriteria;
 }

package/lib/types/functions/statistical/forecast-ets/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 ForecastEts extends NotImplementedFunction {
+    minParams: number;
+    maxParams: number;
+}

package/lib/types/functions/statistical/forecast-ets-confint/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 ForecastEtsConfint extends NotImplementedFunction {
+    minParams: number;
+    maxParams: number;
+}

package/lib/types/functions/statistical/forecast-ets-seasonality/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 ForecastEtsSeasonality extends NotImplementedFunction {
+    minParams: number;
+    maxParams: number;
+}

package/lib/types/functions/statistical/forecast-ets-stat/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 ForecastEtsStat extends NotImplementedFunction {
+    minParams: number;
+    maxParams: number;
+}

package/lib/types/functions/statistical/linest/index.d.ts

@@ -18,6 +18,7 @@ import { BaseFunction } from '../../base-function';
 export declare class Linest extends BaseFunction {
     minParams: number;
     maxParams: number;
+    returnsLegacyArrayAsScalar: boolean;
     calculate(knownYs: BaseValueObject, knownXs?: BaseValueObject, constb?: BaseValueObject, stats?: BaseValueObject): BaseValueObject;
     private _getResult;
     private _getResultByMultipleVariables;

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

@@ -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';
@@ -147,6 +148,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';

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

@@ -64,5 +64,6 @@ export declare class FormulaDataModel extends Disposable {
      */
     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/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,38 @@
+/**
+ * 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 _executingDirtyData;
+    private _timer;
+    private _executionInProgress;
+    private _restartCalculation;
+    constructor(_commandService: ICommandService, _activeDirtyManagerService: IActiveDirtyManagerService);
+    dispose(): void;
+    private _initialize;
+    private _flush;
+    private _startCalculation;
+    private _handleCalculationNotification;
+    private _generateDirty;
+}