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

package/lib/types/basics/common.d.ts

@@ -13,7 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import type { ICellData, IColumnData, IObjectArrayPrimitiveType, IObjectMatrixPrimitiveType, IRange, IRowData, IUnitRange, Nullable, ObjectMatrix, Styles } from '@univerjs/core';
+import type { ICellData, IColumnData, IObjectArrayPrimitiveType, IObjectMatrixPrimitiveType, IRange, IRowData, IUnitRange, Nullable, ObjectMatrix, Styles, UniverInstanceType } from '@univerjs/core';
 import type { sequenceNodeType } from '../engine/utils/sequence';
 import type { IImageFormulaInfo } from '../engine/value-object/primitive-object';
 export declare const ERROR_VALUE_OBJECT_CLASS_TYPE = "errorValueObject";
@@ -75,6 +75,15 @@ export interface IUnitSheetNameMap {
         [sheetName: string]: string;
     }>;
 }
+export type FormulaUnitType = UniverInstanceType.UNIVER_SHEET | UniverInstanceType.UNIVER_BASE;
+export interface IFormulaUnitNameMapItem {
+    name: string;
+    unitType: FormulaUnitType;
+}
+/** Runtime Unit metadata keyed by stable unitId. */
+export interface IFormulaUnitNameMap {
+    [unitId: string]: IFormulaUnitNameMapItem;
+}
 export interface IUnitSheetIdToNameMap {
     [unitId: string]: Nullable<{
         [sheetId: string]: string;
@@ -193,6 +202,11 @@ export interface ISuperTable {
     sheetId: string;
     titleMap: Map<string, number>;
     range: IRange;
+    /**
+     * Whether the projected range contains a physical header row.
+     * Sheet tables default to true; Base virtual tables store records from row 0.
+     */
+    showHeader?: boolean;
 }
 export declare enum TableOptionType {
     ALL = "#All",
@@ -227,6 +241,7 @@ export interface IFormulaDatasetConfig {
     allUnitData?: IUnitData;
     unitStylesData?: IUnitStylesData;
     unitSheetNameMap?: IUnitSheetNameMap;
+    unitNameMap?: IFormulaUnitNameMap;
     maxIteration?: number;
     isCalculateTreeModel?: boolean;
     rowData?: IUnitRowData;

package/lib/types/basics/date.d.ts

@@ -42,8 +42,8 @@ export declare function formatDateDefault(date: Date): string;
  * TODO @Dushusir: Internationalization and more format support, can be reused when editing and saving cells, like "2020年1月1日"
  */
 export declare function isValidDateStr(dateStr: string): boolean;
-export declare function parseFormattedDate(value: string): numfmt.ParseData | null;
-export declare function parseFormattedTime(value: string): numfmt.ParseData | null;
+export declare function parseFormattedDate(value: string): numfmt.ParseData<number> | null;
+export declare function parseFormattedTime(value: string): numfmt.ParseData<number> | null;
 export declare function isDate(format: string): boolean;
 export declare function isValidWeekend(weekend: number | string): boolean;
 export declare function getWeekendArray(weekend: number | string): number[];

package/lib/types/basics/regex.d.ts

@@ -32,10 +32,10 @@ export declare const REFERENCE_REGEX_SINGLE_ROW = "^'?(\\[([^\\[\\]\\/?:\"<>|*\\
 export declare const REFERENCE_REGEX_SINGLE_ROW_PRECOMPILING: RegExp;
 export declare const REFERENCE_REGEX_SINGLE_COLUMN = "^'?(\\[([^\\[\\]\\/?:\"<>|*\\\\]+)\\])?(((?![\\[\\]\\/?*\\\\]).)*!)?'?\\s*?\\$?[A-Za-z]+$";
 export declare const REFERENCE_REGEX_SINGLE_COLUMN_PRECOMPILING: RegExp;
-export declare const REFERENCE_TABLE_ALL_COLUMN_REGEX = "^(\\[([^\\[\\]\\/?:\"<>|*\\\\]+)\\])?((?![~!@#$%^&*()_+<>?:,./;\u2019\uFF0C\u3002\u3001\u2018\uFF1A\u201C\u300A\u300B\uFF1F~\uFF01@#\uFFE5%\u2026\u2026\uFF08\uFF09\u3010\u3011\\[\\]\\/\\\\]).)+$";
-export declare const REFERENCE_TABLE_SINGLE_COLUMN_REGEX = "^(\\[([^\\[\\]\\/?:\"<>|*\\\\]+)\\])?((?![~!@#$%^&*()_+<>?:,./;\u2019\uFF0C\u3002\u3001\u2018\uFF1A\u201C\u300A\u300B\uFF1F~\uFF01@#\uFFE5%\u2026\u2026\uFF08\uFF09\u3010\u3011\\[\\]\\/\\\\]).)+(\\[((?<!#)[\\s\\S])*\\]|\\[\\[#.+\\]\\s*?,\\s*?\\[((?<!#)[\\s\\S])*\\]\\])+$";
-export declare const REFERENCE_TABLE_MULTIPLE_COLUMN_REGEX = "^(\\[([^\\[\\]\\/?:\"<>|*\\\\]+)\\])?((?![~!@#$%^&*()_+<>?:,./;\u2019\uFF0C\u3002\u3001\u2018\uFF1A\u201C\u300A\u300B\uFF1F~\uFF01@#\uFFE5%\u2026\u2026\uFF08\uFF09\u3010\u3011\\[\\]\\/\\\\]).)+(\\[\\[((?<!#)[\\s\\S])*\\]\\s*?:\\s*?\\[((?<!#)[\\s\\S])*\\]\\])?$|^((?![~!@#$%^&*()_+<>?:,./;\u2019\uFF0C\u3002\u3001\u2018\uFF1A\u201C\u300A\u300B\uFF1F~\uFF01@#\uFFE5%\u2026\u2026\uFF08\uFF09\u3010\u3011\\[\\]\\/\\\\]).)+(\\[\\[#.+\\]\\s*?,\\s*?\\[((?<!#)[\\s\\S])*\\]\\s*?:\\s*?\\[((?<!#)[\\s\\S])*\\]\\])?$";
-export declare const REFERENCE_TABLE_TITLE_ONLY_ANY_HASH_REGEX = "^(\\[([^\\[\\]\\/?:\"<>|*\\\\]+)\\])?((?![~!@#$%^&*()_+<>?:,./;\u2019\uFF0C\u3002\u3001\u2018\uFF1A\u201C\u300A\u300B\uFF1F~\uFF01@#\uFFE5%\u2026\u2026\uFF08\uFF09\u3010\u3011\\[\\]\\/\\\\]).)+\\[\\s*#([^\\]]+)\\s*\\]$";
+export declare const REFERENCE_TABLE_ALL_COLUMN_REGEX = "^(?:(?:\\[([^\\[\\]\\/?:\"<>|*\\\\]+)\\]|'(?:[^']|'')+'|[^\\s!\\[\\]]+)!)?(?:\\[([^\\[\\]\\/?:\"<>|*\\\\]+)\\])?((?![~!@#$%^&*()_+<>?:,./;\u2019\uFF0C\u3002\u3001\u2018\uFF1A\u201C\u300A\u300B\uFF1F~\uFF01@#\uFFE5%\u2026\u2026\uFF08\uFF09\u3010\u3011\\[\\]\\/\\\\]).)+$";
+export declare const REFERENCE_TABLE_SINGLE_COLUMN_REGEX = "^(?:(?:\\[([^\\[\\]\\/?:\"<>|*\\\\]+)\\]|'(?:[^']|'')+'|[^\\s!\\[\\]]+)!)?(?:\\[([^\\[\\]\\/?:\"<>|*\\\\]+)\\])?((?![~!@#$%^&*()_+<>?:,./;\u2019\uFF0C\u3002\u3001\u2018\uFF1A\u201C\u300A\u300B\uFF1F~\uFF01@#\uFFE5%\u2026\u2026\uFF08\uFF09\u3010\u3011\\[\\]\\/\\\\]).)+(\\[((?<!#)[\\s\\S])*\\]|\\[\\[#.+\\]\\s*?,\\s*?\\[((?<!#)[\\s\\S])*\\]\\])+$";
+export declare const REFERENCE_TABLE_MULTIPLE_COLUMN_REGEX = "^(?:(?:\\[([^\\[\\]\\/?:\"<>|*\\\\]+)\\]|'(?:[^']|'')+'|[^\\s!\\[\\]]+)!)?(?:\\[([^\\[\\]\\/?:\"<>|*\\\\]+)\\])?((?![~!@#$%^&*()_+<>?:,./;\u2019\uFF0C\u3002\u3001\u2018\uFF1A\u201C\u300A\u300B\uFF1F~\uFF01@#\uFFE5%\u2026\u2026\uFF08\uFF09\u3010\u3011\\[\\]\\/\\\\]).)+(\\[\\[((?<!#)[\\s\\S])*\\]\\s*?:\\s*?\\[((?<!#)[\\s\\S])*\\]\\])?$|^(?:(?:\\[([^\\[\\]\\/?:\"<>|*\\\\]+)\\]|'(?:[^']|'')+'|[^\\s!\\[\\]]+)!)?(?:\\[([^\\[\\]\\/?:\"<>|*\\\\]+)\\])?((?![~!@#$%^&*()_+<>?:,./;\u2019\uFF0C\u3002\u3001\u2018\uFF1A\u201C\u300A\u300B\uFF1F~\uFF01@#\uFFE5%\u2026\u2026\uFF08\uFF09\u3010\u3011\\[\\]\\/\\\\]).)+(\\[\\[#.+\\]\\s*?,\\s*?\\[((?<!#)[\\s\\S])*\\]\\s*?:\\s*?\\[((?<!#)[\\s\\S])*\\]\\])?$";
+export declare const REFERENCE_TABLE_TITLE_ONLY_ANY_HASH_REGEX = "^(?:(?:\\[([^\\[\\]\\/?:\"<>|*\\\\]+)\\]|'(?:[^']|'')+'|[^\\s!\\[\\]]+)!)?(?:\\[([^\\[\\]\\/?:\"<>|*\\\\]+)\\])?((?![~!@#$%^&*()_+<>?:,./;\u2019\uFF0C\u3002\u3001\u2018\uFF1A\u201C\u300A\u300B\uFF1F~\uFF01@#\uFFE5%\u2026\u2026\uFF08\uFF09\u3010\u3011\\[\\]\\/\\\\]).)+\\[\\s*#([^\\]]+)\\s*\\]$";
 export declare const REFERENCE_TABLE_ALL_COLUMN_REGEX_PRECOMPILING: RegExp;
 export declare const REFERENCE_TABLE_SINGLE_COLUMN_REGEX_PRECOMPILING: RegExp;
 export declare const REFERENCE_TABLE_MULTIPLE_COLUMN_REGEX_PRECOMPILING: RegExp;

package/lib/types/controllers/formula-calculation-trigger.controller.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 { Disposable, LifecycleService } from '@univerjs/core';
+import { FormulaCalculationTriggerService } from '../services/formula-calculation-trigger.service';
+export declare class FormulaCalculationTriggerController extends Disposable {
+    constructor(formulaCalculationTriggerService: FormulaCalculationTriggerService, lifecycleService: LifecycleService);
+}

package/lib/types/engine/analysis/lexer-node.d.ts

@@ -15,9 +15,9 @@
  */
 import type { Nullable } from '@univerjs/core';
 import type { LambdaPrivacyVarType } from '../ast-node/base-ast-node';
-interface LexerNodeJson {
+interface ILexerNodeJson {
     token: string;
-    children: Array<LexerNodeJson | string>;
+    children: Array<ILexerNodeJson | string>;
 }
 export declare class LexerNode {
     private _parent;
@@ -56,7 +56,7 @@ export declare class LexerNode {
         token: string;
         st: number;
         ed: number;
-        children: (string | LexerNodeJson)[];
+        children: (string | ILexerNodeJson)[];
     };
     private _getIndexInParent;
 }

package/lib/types/engine/ast-node/function-node.d.ts

@@ -22,6 +22,7 @@ import { IFormulaCurrentConfigService } from '../../services/current-data.servic
 import { IDefinedNamesService } from '../../services/defined-names.service';
 import { IFunctionService } from '../../services/function.service';
 import { IFormulaRuntimeService } from '../../services/runtime.service';
+import { IFormulaUnitReferenceResolver } from '../../services/unit-reference-resolver.service';
 import { BaseAstNode } from './base-ast-node';
 import { BaseAstNodeFactory } from './base-ast-node-factory';
 import { NodeType } from './node-type';
@@ -31,7 +32,8 @@ export declare class FunctionNode extends BaseAstNode {
     private _runtimeService;
     private _definedNamesService;
     private _formulaDataModel;
-    constructor(token: string, _functionExecutor: BaseFunction, _currentConfigService: IFormulaCurrentConfigService, _runtimeService: IFormulaRuntimeService, _definedNamesService: IDefinedNamesService, _formulaDataModel: FormulaDataModel);
+    private _unitReferenceResolver;
+    constructor(token: string, _functionExecutor: BaseFunction, _currentConfigService: IFormulaCurrentConfigService, _runtimeService: IFormulaRuntimeService, _definedNamesService: IDefinedNamesService, _formulaDataModel: FormulaDataModel, _unitReferenceResolver: IFormulaUnitReferenceResolver);
     get nodeType(): NodeType;
     executeAsync(): Promise<AstNodePromiseType>;
     execute(): void;
@@ -84,7 +86,8 @@ export declare class FunctionNodeFactory extends BaseAstNodeFactory {
     private readonly _definedNamesService;
     private readonly _injector;
     private readonly _formulaDataModel;
-    constructor(_functionService: IFunctionService, _currentConfigService: IFormulaCurrentConfigService, _runtimeService: IFormulaRuntimeService, _definedNamesService: IDefinedNamesService, _injector: Injector, _formulaDataModel: FormulaDataModel);
+    private readonly _unitReferenceResolver;
+    constructor(_functionService: IFunctionService, _currentConfigService: IFormulaCurrentConfigService, _runtimeService: IFormulaRuntimeService, _definedNamesService: IDefinedNamesService, _injector: Injector, _formulaDataModel: FormulaDataModel, _unitReferenceResolver: IFormulaUnitReferenceResolver);
     get zIndex(): number;
     create(token: string): BaseAstNode;
     checkAndCreateNodeType(param: LexerNode | string): BaseAstNode | undefined;

package/lib/types/engine/ast-node/reference-node.d.ts

@@ -17,23 +17,31 @@ import { IFormulaCurrentConfigService } from '../../services/current-data.servic
 import { IFunctionService } from '../../services/function.service';
 import { IFormulaRuntimeService } from '../../services/runtime.service';
 import { ISuperTableService } from '../../services/super-table.service';
+import { IFormulaUnitReferenceResolver } from '../../services/unit-reference-resolver.service';
 import { LexerNode } from '../analysis/lexer-node';
-import { TableReferenceObject } from '../reference-object/table-reference-object';
 import { ReferenceObjectType } from '../utils/value-object';
 import { BaseAstNode } from './base-ast-node';
 import { BaseAstNodeFactory } from './base-ast-node-factory';
 import { NodeType } from './node-type';
+interface ITableReferenceDescriptor {
+    unitQualifier: string;
+    tableName: string;
+    columnStruct: string | undefined;
+}
 export declare class ReferenceNode extends BaseAstNode {
     private _currentConfigService;
     private _runtimeService;
     private _referenceObjectType;
+    private _unitReferenceResolver;
+    private _superTableService;
     private _isPrepareMerge;
-    private _tableReferenceObject?;
+    private _tableReference?;
     private _refOffsetX;
     private _refOffsetY;
-    constructor(_currentConfigService: IFormulaCurrentConfigService, _runtimeService: IFormulaRuntimeService, operatorString: string, _referenceObjectType: ReferenceObjectType, _isPrepareMerge?: boolean, _tableReferenceObject?: TableReferenceObject | undefined);
+    constructor(_currentConfigService: IFormulaCurrentConfigService, _runtimeService: IFormulaRuntimeService, operatorString: string, _referenceObjectType: ReferenceObjectType, _unitReferenceResolver: IFormulaUnitReferenceResolver, _superTableService: ISuperTableService, _isPrepareMerge?: boolean, _tableReference?: ITableReferenceDescriptor | undefined);
     get nodeType(): NodeType;
     execute(): void;
+    private _configureReferenceObject;
     setRefOffset(x?: number, y?: number): void;
     getRefOffset(): {
         x: number;
@@ -45,7 +53,8 @@ export declare class ReferenceNodeFactory extends BaseAstNodeFactory {
     private readonly _formulaRuntimeService;
     private readonly _functionService;
     private readonly _superTableService;
-    constructor(_currentConfigService: IFormulaCurrentConfigService, _formulaRuntimeService: IFormulaRuntimeService, _functionService: IFunctionService, _superTableService: ISuperTableService);
+    private readonly _unitReferenceResolver;
+    constructor(_currentConfigService: IFormulaCurrentConfigService, _formulaRuntimeService: IFormulaRuntimeService, _functionService: IFunctionService, _superTableService: ISuperTableService, _unitReferenceResolver: IFormulaUnitReferenceResolver);
     get zIndex(): number;
     checkAndCreateNodeType(param: LexerNode | string): ReferenceNode | undefined;
     private _getTableMap;
@@ -54,3 +63,4 @@ export declare class ReferenceNodeFactory extends BaseAstNodeFactory {
     private _checkTokenIsTableReference;
     private _checkParentIsUnionOperator;
 }
+export {};

package/lib/types/engine/reference-object/base-reference-object.d.ts

@@ -34,6 +34,7 @@ export declare class BaseReferenceObject extends ObjectClassType {
     private _filteredOutRows;
     private _defaultUnitId;
     private _forcedUnitId;
+    private _unitQualifier;
     private _runtimeData;
     private _arrayFormulaCellData;
     private _arrayFormulaRange;
@@ -63,6 +64,8 @@ export declare class BaseReferenceObject extends ObjectClassType {
     getUnitId(): string;
     getSheetId(): string;
     setForcedUnitIdDirect(unitId: string): void;
+    setUnitQualifier(unitQualifier: string): void;
+    getUnitQualifier(): string;
     getForcedUnitId(): string;
     setForcedSheetId(sheetNameMap: IUnitSheetNameMap): void;
     setForcedSheetIdDirect(sheetId: string): void;

package/lib/types/engine/reference-object/table-reference-object.d.ts

@@ -13,6 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+import type { ICellData, Nullable } from '@univerjs/core';
 import type { ISuperTable, IUnitSheetNameMap } from '../../basics/common';
 import { TableOptionType } from '../../basics/common';
 import { BaseReferenceObject } from './base-reference-object';
@@ -55,6 +56,7 @@ export declare class TableReferenceObject extends BaseReferenceObject {
     /** Section text to enum mapping ('#All', '#Data', '#Headers', '#Totals', '#This Row') */
     _tableOptionMap: Map<string, TableOptionType>);
     getRangeData(): import("@univerjs/core").IRange;
+    getCellData(row: number, column: number): Nullable<ICellData>;
     getRefOffset(): {
         x: number;
         y: number;

package/lib/types/engine/utils/reference.d.ts

@@ -56,6 +56,8 @@ export declare function singleReferenceToGrid(refBody: string): {
 export declare function handleRefStringInfo(refString: string): {
     refBody: string;
     sheetName: string;
+    unitQualifier: string;
+    /** @deprecated Use unitQualifier. Kept for reference-grid compatibility. */
     unitId: string;
 };
 export declare function deserializeRangeWithSheet(refString: string): IUnitRangeName;
@@ -102,11 +104,7 @@ export declare function quoteSheetName(name: string): string;
  */
 export declare function unquoteSheetName(name: string): string;
 export declare function splitTableStructuredRef(ref: string): {
-    tableName: string;
-    struct: string;
-    columnStruct?: undefined;
-} | {
+    unitQualifier: string;
     tableName: string;
     columnStruct: string;
-    struct?: undefined;
 };

package/lib/types/engine/utils/unit-qualifier.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 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.
+ */
+/** Refactors only parsed reference qualifiers and INDIRECT literal references, never arbitrary text. */
+export declare function refactorFormulaUnitQualifier(formula: string, oldName: string, newName: string): string;
+/**
+ * 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.
+ */

package/lib/types/functions/base-function.d.ts

@@ -23,6 +23,7 @@ import type { BaseValueObject } from '../engine/value-object/base-value-object';
 import type { FormulaFunctionResultValueType, FormulaFunctionValueType } from '../engine/value-object/primitive-object';
 import type { FormulaDataModel } from '../models/formula-data.model';
 import type { IDefinedNameMapItem } from '../services/defined-names.service';
+import type { IFormulaUnitReferenceResolver } from '../services/unit-reference-resolver.service';
 import { ArrayOrderSearchType } from '../engine/utils/compare';
 import { ErrorValueObject } from '../engine/value-object/base-value-object';
 export declare class BaseFunction {
@@ -38,6 +39,7 @@ export declare class BaseFunction {
     private _sheetOrder;
     private _sheetNameMap;
     protected _formulaDataModel: Nullable<FormulaDataModel>;
+    protected _unitReferenceResolver: Nullable<IFormulaUnitReferenceResolver>;
     protected _rowCount: number;
     protected _columnCount: number;
     /**
@@ -60,6 +62,8 @@ export declare class BaseFunction {
      * Whether the function needs function methods in FormulaDataModel
      */
     needsFormulaDataModel: boolean;
+    /** Whether the function resolves external Unit qualifiers. */
+    needsUnitReferenceResolver: boolean;
     /**
      * Whether the function needs the number of rows and columns in the sheet
      */
@@ -117,6 +121,7 @@ export declare class BaseFunction {
         };
     }): void;
     setFormulaDataModel(_formulaDataModel: FormulaDataModel): void;
+    setUnitReferenceResolver(unitReferenceResolver: IFormulaUnitReferenceResolver): void;
     setSheetRowColumnCount(rowCount: number, columnCount: number): void;
     isAsync(): boolean;
     isAddress(): boolean;

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

@@ -19,6 +19,7 @@ import { BaseFunction } from '../../base-function';
 export declare class Indirect extends BaseFunction {
     minParams: number;
     maxParams: number;
+    needsUnitReferenceResolver: boolean;
     isAddress(): boolean;
     calculate(refText: BaseValueObject, a1?: BaseValueObject): BaseValueObject | BaseReferenceObject;
     private _handleSingleObject;

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';
@@ -91,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';
@@ -162,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,7 +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/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/formula-calculation-trigger.service.d.ts

@@ -24,13 +24,18 @@ export declare class FormulaCalculationTriggerService extends Disposable {
     private readonly _commandService;
     private readonly _activeDirtyManagerService;
     private _waitingCommandQueue;
-    private _executingDirtyData;
+    private _pendingDirtyData;
+    private _runningDirtyData;
     private _timer;
+    private _started;
     private _executionInProgress;
-    private _restartCalculation;
+    private _hasPendingCalculation;
+    private _stopRequested;
     constructor(_commandService: ICommandService, _activeDirtyManagerService: IActiveDirtyManagerService);
+    start(): void;
     dispose(): void;
     private _initialize;
+    private _scheduleFlush;
     private _flush;
     private _startCalculation;
     private _handleCalculationNotification;

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;
+}