@univerjs/engine-formula 0.4.0 → 0.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,21 @@
1
- import { Disposable } from '@univerjs/core';
2
- export declare class ObjectClassType extends Disposable {
1
+ /**
2
+ * Copyright 2023-present DreamNum Inc.
3
+ *
4
+ * Licensed under the Apache License, Version 2.0 (the "License");
5
+ * you may not use this file except in compliance with the License.
6
+ * You may obtain a copy of the License at
7
+ *
8
+ * http://www.apache.org/licenses/LICENSE-2.0
9
+ *
10
+ * Unless required by applicable law or agreed to in writing, software
11
+ * distributed under the License is distributed on an "AS IS" BASIS,
12
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
+ * See the License for the specific language governing permissions and
14
+ * limitations under the License.
15
+ */
16
+ export declare class ObjectClassType {
3
17
  pattern: string;
18
+ dispose(): void;
4
19
  getPattern(): string;
5
20
  /**
6
21
  * Only used in NumberValueObject
@@ -14,20 +14,37 @@
14
14
  * limitations under the License.
15
15
  */
16
16
  export declare const UNIT_NAME_REGEX = "\\[([^\\[\\]\\/?:\"<>|*\\\\]+)\\]";
17
+ export declare const UNIT_NAME_REGEX_PRECOMPILING: RegExp;
17
18
  export declare const SHEET_NAME_REGEX = "((?![\\[\\]\\/?*\\\\]).)*!";
18
19
  export declare const ABSOLUTE_SYMBOL = "$";
19
20
  export declare const RANGE_SYMBOL = "\\s*?:\\s*?";
20
21
  export declare const UNIT_NAME_SHEET_NAME_REGEX = "'?(\\[([^\\[\\]\\/?:\"<>|*\\\\]+)\\])?(((?![\\[\\]\\/?*\\\\]).)*!)?'?";
21
22
  export declare const SIMPLE_SINGLE_RANGE_REGEX = "\\$?[A-Za-z]+\\$?[1-9][0-9]*";
22
23
  export declare const REFERENCE_MULTIPLE_RANGE_REGEX = "^(@)?'?(\\[([^\\[\\]\\/?:\"<>|*\\\\]+)\\])?(((?![\\[\\]\\/?*\\\\]).)*!)?'?\\$?[A-Za-z]+\\$?[1-9][0-9]*\\s*?:\\s*?\\$?[A-Za-z]+\\$?[1-9][0-9]*$";
24
+ export declare const REFERENCE_MULTIPLE_RANGE_REGEX_PRECOMPILING: RegExp;
23
25
  export declare const REFERENCE_SINGLE_RANGE_REGEX = "^'?(\\[([^\\[\\]\\/?:\"<>|*\\\\]+)\\])?(((?![\\[\\]\\/?*\\\\]).)*!)?'?\\s*?\\$?[A-Za-z]+\\$?[1-9][0-9]*(#)?$";
26
+ export declare const REFERENCE_SINGLE_RANGE_REGEX_PRECOMPILING: RegExp;
24
27
  export declare const REFERENCE_REGEX_ROW = "^'?(\\[([^\\[\\]\\/?:\"<>|*\\\\]+)\\])?(((?![\\[\\]\\/?*\\\\]).)*!)?'?\\$?[1-9][0-9]*\\s*?:\\s*?\\$?[1-9][0-9]*$";
28
+ export declare const REFERENCE_REGEX_ROW_PRECOMPILING: RegExp;
25
29
  export declare const REFERENCE_REGEX_COLUMN = "^'?(\\[([^\\[\\]\\/?:\"<>|*\\\\]+)\\])?(((?![\\[\\]\\/?*\\\\]).)*!)?'?\\$?[A-Za-z]+\\s*?:\\s*?\\$?[A-Za-z]+$";
30
+ export declare const REFERENCE_REGEX_COLUMN_PRECOMPILING: RegExp;
26
31
  export declare const REFERENCE_REGEX_SINGLE_ROW = "^'?(\\[([^\\[\\]\\/?:\"<>|*\\\\]+)\\])?(((?![\\[\\]\\/?*\\\\]).)*!)?'?\\s*?\\$?[1-9][0-9]*$";
32
+ export declare const REFERENCE_REGEX_SINGLE_ROW_PRECOMPILING: RegExp;
27
33
  export declare const REFERENCE_REGEX_SINGLE_COLUMN = "^'?(\\[([^\\[\\]\\/?:\"<>|*\\\\]+)\\])?(((?![\\[\\]\\/?*\\\\]).)*!)?'?\\s*?\\$?[A-Za-z]+$";
34
+ export declare const REFERENCE_REGEX_SINGLE_COLUMN_PRECOMPILING: RegExp;
28
35
  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\\[\\]\\/\\\\]).)+$";
29
36
  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*?\\[((?<!#).)*\\]\\])+$";
30
37
  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*?\\[((?<!#).)*\\]\\])?$|^((?![~!@#$%^&*()_+<>?:,./;\u2019\uFF0C\u3002\u3001\u2018\uFF1A\u201C\u300A\u300B\uFF1F~\uFF01@#\uFFE5%\u2026\u2026\uFF08\uFF09\u3010\u3011\\[\\]\\/\\\\]).)+(\\[\\[#.+\\]\\s*?,\\s*?\\[((?<!#).)*\\]\\s*?:\\s*?\\[((?<!#).)*\\]\\])?$";
31
- export declare const $SUPER_TABLE_COLUMN_REGEX = "[.*?]";
32
- export declare const $ARRAY_VALUE_REGEX = "{.*?}";
38
+ export declare const SUPER_TABLE_COLUMN_REGEX = "[.*?]";
39
+ export declare const SUPER_TABLE_COLUMN_REGEX_PRECOMPILING: RegExp;
40
+ export declare const ARRAY_VALUE_REGEX = "{.*?}";
41
+ export declare const ARRAY_VALUE_REGEX_PRECOMPILING: RegExp;
42
+ export declare function regexTestSingeRange(token: string): boolean;
43
+ export declare function regexTestMultipleRange(token: string): boolean;
44
+ export declare function regexTestRow(token: string): boolean;
45
+ export declare function regexTestColumn(token: string): boolean;
46
+ export declare function regexTestSingleRow(token: string): boolean;
47
+ export declare function regexTestSingleColumn(token: string): boolean;
48
+ export declare function regexTestSuperTableColumn(token: string): boolean;
49
+ export declare function regexTestArrayValue(token: string): boolean;
33
50
  export declare function isReferenceString(refString: string): boolean;
@@ -29,11 +29,10 @@ export declare class AstTreeBuilder extends Disposable {
29
29
  private _refOffsetY;
30
30
  constructor(_runtimeService: IFormulaRuntimeService, _astRootNodeFactory: AstRootNodeFactory, _functionNodeFactory: FunctionNodeFactory, _lambdaNodeFactory: LambdaNodeFactory, _lambdaParameterNodeFactory: LambdaParameterNodeFactory, _operatorNodeFactory: OperatorNodeFactory, _prefixNodeFactory: PrefixNodeFactory, _referenceNodeFactory: ReferenceNodeFactory, _suffixNodeFactory: SuffixNodeFactory, _unionNodeFactory: UnionNodeFactory, _valueNodeFactory: ValueNodeFactory);
31
31
  dispose(): void;
32
- parse(lexerNode: LexerNode, refOffsetX?: number, refOffsetY?: number): Nullable<BaseAstNode>;
32
+ parse(lexerNode: LexerNode): Nullable<BaseAstNode>;
33
33
  private _lambdaParameterHandler;
34
34
  private _changeLetToLambda;
35
35
  private _parse;
36
- private _setPrefixRefOffset;
37
36
  private _checkAstNode;
38
37
  private _initializeAstNode;
39
38
  }
@@ -1,9 +1,10 @@
1
- import { Nullable, Disposable } from '@univerjs/core';
1
+ import { Nullable } from '@univerjs/core';
2
2
  import { LexerNode } from '../analysis/lexer-node';
3
3
  import { BaseAstNode } from './base-ast-node';
4
4
  export declare const DEFAULT_AST_NODE_FACTORY_Z_INDEX = 100;
5
- export declare abstract class BaseAstNodeFactory extends Disposable {
5
+ export declare abstract class BaseAstNodeFactory {
6
6
  get zIndex(): number;
7
+ dispose(): void;
7
8
  create(param: LexerNode | string, currentRow?: number, currentColumn?: number): BaseAstNode;
8
9
  abstract checkAndCreateNodeType(param: LexerNode | string): Nullable<BaseAstNode>;
9
10
  }
@@ -1,4 +1,4 @@
1
- import { Nullable, Disposable } from '@univerjs/core';
1
+ import { Nullable } from '@univerjs/core';
2
2
  import { ErrorType } from '../../basics/error-type';
3
3
  import { FunctionVariantType } from '../reference-object/base-reference-object';
4
4
  import { AstNodePromiseType } from '../../basics/common';
@@ -10,7 +10,7 @@ interface IAstNodeNodeJson {
10
10
  nodeType: string;
11
11
  }
12
12
  export type LambdaPrivacyVarType = Map<string, Nullable<BaseAstNode>>;
13
- export declare class BaseAstNode extends Disposable {
13
+ export declare class BaseAstNode {
14
14
  private _token;
15
15
  private _children;
16
16
  private _definedNames;
@@ -19,8 +19,6 @@ export declare class BaseAstNode extends Disposable {
19
19
  private _calculateState;
20
20
  private _async;
21
21
  private _address;
22
- private _refOffsetX;
23
- private _refOffsetY;
24
22
  private _isForcedCalculateFunction;
25
23
  constructor(_token: string);
26
24
  dispose(): void;
@@ -42,11 +40,6 @@ export declare class BaseAstNode extends Disposable {
42
40
  setCalculated(): void;
43
41
  execute(): void;
44
42
  setNotEmpty(state?: boolean): void;
45
- setRefOffset(x?: number, y?: number): void;
46
- getRefOffset(): {
47
- x: number;
48
- y: number;
49
- };
50
43
  executeAsync(): Promise<AstNodePromiseType>;
51
44
  serialize(): IAstNodeNodeJson;
52
45
  hasDefinedName(definedName: string): boolean;
@@ -1,9 +1,9 @@
1
1
  import { IAccessor, Injector } from '@univerjs/core';
2
+ import { BaseReferenceObject } from '../reference-object/base-reference-object';
3
+ import { IFunctionService } from '../../services/function.service';
2
4
  import { IFormulaRuntimeService } from '../../services/runtime.service';
3
5
  import { ISuperTableService } from '../../services/super-table.service';
4
6
  import { LexerNode } from '../analysis/lexer-node';
5
- import { BaseReferenceObject } from '../reference-object/base-reference-object';
6
- import { IFunctionService } from '../../services/function.service';
7
7
  import { BaseAstNode } from './base-ast-node';
8
8
  import { BaseAstNodeFactory } from './base-ast-node-factory';
9
9
  import { NodeType } from './node-type';
@@ -12,9 +12,16 @@ export declare class ReferenceNode extends BaseAstNode {
12
12
  private _operatorString;
13
13
  private _referenceObject;
14
14
  private _isPrepareMerge;
15
+ private _refOffsetX;
16
+ private _refOffsetY;
15
17
  constructor(_accessor: IAccessor, _operatorString: string, _referenceObject: BaseReferenceObject, _isPrepareMerge?: boolean);
16
18
  get nodeType(): NodeType;
17
19
  execute(): void;
20
+ setRefOffset(x?: number, y?: number): void;
21
+ getRefOffset(): {
22
+ x: number;
23
+ y: number;
24
+ };
18
25
  }
19
26
  export declare class ReferenceNodeFactory extends BaseAstNodeFactory {
20
27
  private readonly _superTableService;
@@ -1,8 +1,8 @@
1
- import { IRange, IRTreeItem, IUnitRange, Nullable, Disposable } from '@univerjs/core';
1
+ import { IRange, IRTreeItem, IUnitRange, Nullable } from '@univerjs/core';
2
2
  import { IDirtyUnitSheetNameMap, IFeatureDirtyRangeType, IRuntimeUnitDataType, IUnitExcludedCell } from '../../basics/common';
3
3
  import { IFormulaDirtyData } from '../../services/current-data.service';
4
4
  import { IAllRuntimeData } from '../../services/runtime.service';
5
- import { BaseAstNode } from '../ast-node/base-ast-node';
5
+ import { IExecuteAstNodeData } from '../utils/ast-node-tool';
6
6
  export declare enum FDtreeStateType {
7
7
  DEFAULT = 0,
8
8
  ADDED = 1,
@@ -12,9 +12,9 @@ export declare enum FDtreeStateType {
12
12
  * A dependency tree, capable of calculating mutual dependencies,
13
13
  * is used to determine the order of formula calculations.
14
14
  */
15
- export declare class FormulaDependencyTree extends Disposable {
15
+ export declare class FormulaDependencyTree {
16
16
  treeId: string;
17
- node: Nullable<BaseAstNode>;
17
+ nodeData: Nullable<IExecuteAstNodeData>;
18
18
  children: Set<FormulaDependencyTree>;
19
19
  parents: Set<FormulaDependencyTree>;
20
20
  formula: string;
@@ -29,6 +29,7 @@ export declare class FormulaDependencyGenerator extends Disposable {
29
29
  * @param formulaData
30
30
  */
31
31
  private _generateTreeList;
32
+ private _moveRangeList;
32
33
  private _registerFeatureFormulas;
33
34
  private _getFeatureFormulaTree;
34
35
  private _registerOtherFormulas;
@@ -1,13 +1,14 @@
1
1
  import { BaseAstNode } from '../ast-node/base-ast-node';
2
2
  import { FunctionVariantType } from '../reference-object/base-reference-object';
3
+ import { IExecuteAstNodeData } from '../utils/ast-node-tool';
3
4
  import { PreCalculateNodeType } from '../utils/node-type';
4
5
  import { Disposable } from '@univerjs/core';
5
6
  import { IFormulaRuntimeService } from '../../services/runtime.service';
6
7
  export declare class Interpreter extends Disposable {
7
8
  private readonly _runtimeService;
8
9
  constructor(_runtimeService: IFormulaRuntimeService);
9
- executeAsync(node: BaseAstNode): Promise<FunctionVariantType>;
10
- execute(node: BaseAstNode): FunctionVariantType;
10
+ executeAsync(nodeData: IExecuteAstNodeData): Promise<FunctionVariantType>;
11
+ execute(nodeData: IExecuteAstNodeData): FunctionVariantType;
11
12
  executePreCalculateNode(node: PreCalculateNodeType): import('@univerjs/core').Nullable<FunctionVariantType>;
12
13
  checkAsyncNode(node: BaseAstNode): boolean;
13
14
  private _checkAsyncNode;
@@ -1,3 +1,13 @@
1
1
  import { Nullable } from '@univerjs/core';
2
2
  import { BaseAstNode } from '../ast-node/base-ast-node';
3
+ export interface IExecuteAstNodeData {
4
+ node: BaseAstNode;
5
+ refOffsetX: number;
6
+ refOffsetY: number;
7
+ }
3
8
  export declare function getAstNodeTopParent(node: BaseAstNode): Nullable<BaseAstNode>;
9
+ export declare function generateExecuteAstNodeData(node: BaseAstNode, refOffsetX?: number, refOffsetY?: number): {
10
+ node: BaseAstNode;
11
+ refOffsetX: number;
12
+ refOffsetY: number;
13
+ };
@@ -39,6 +39,7 @@ export declare function handleNumfmtInCell(oldCell: Nullable<ICellData>, cell: N
39
39
  * @returns
40
40
  */
41
41
  export declare function compareNumfmtPriority(oldPattern: string, pattern: string): string;
42
+ export declare function clearNumberFormatTypeCache(): void;
42
43
  /**
43
44
  * The number format of the formula inherits the number format of the referenced cell, usually taking the format of the cell at the front position, but some formats have higher priority, there are some special cases.
44
45
  *
@@ -43,6 +43,8 @@ export declare function handleRefStringInfo(refString: string): {
43
43
  unitId: string;
44
44
  };
45
45
  export declare function deserializeRangeWithSheet(refString: string): IUnitRangeName;
46
+ export declare function deserializeRangeWithSheetWithCache(refString: string): IUnitRangeName;
47
+ export declare function clearReferenceToRangeCache(): void;
46
48
  export declare function isReferenceStringWithEffectiveColumn(refString: string): boolean;
47
49
  export declare function replaceRefPrefixString(token: string): string;
48
50
  /**
@@ -1,7 +1,7 @@
1
- import { AsyncObject, FunctionVariantType } from '../reference-object/base-reference-object';
2
- import { BaseValueObject } from './base-value-object';
3
1
  import { BaseAstNode } from '../ast-node/base-ast-node';
4
2
  import { Interpreter } from '../interpreter/interpreter';
3
+ import { FunctionVariantType, AsyncObject } from '../reference-object/base-reference-object';
4
+ import { BaseValueObject } from './base-value-object';
5
5
  export declare class LambdaValueObjectObject extends BaseValueObject {
6
6
  private _lambdaNode;
7
7
  private _interpreter;
@@ -1,12 +1,12 @@
1
- import { Disposable, IRange, Nullable } from '@univerjs/core';
2
- import { ArrayOrderSearchType, ArrayBinarySearchType } from '../engine/utils/compare';
3
- import { BaseValueObject, ErrorValueObject } from '../engine/value-object/base-value-object';
4
- import { PrimitiveValueType } from '../engine/value-object/primitive-object';
1
+ import { IRange, Nullable } from '@univerjs/core';
5
2
  import { IFunctionNames } from '../basics/function';
6
3
  import { BaseReferenceObject, FunctionVariantType, NodeValueType } from '../engine/reference-object/base-reference-object';
4
+ import { ArrayBinarySearchType, ArrayOrderSearchType } from '../engine/utils/compare';
7
5
  import { ArrayValueObject } from '../engine/value-object/array-value-object';
8
6
  import { IDefinedNameMapItem } from '../services/defined-names.service';
9
- export declare class BaseFunction extends Disposable {
7
+ import { BaseValueObject, ErrorValueObject } from '../engine/value-object/base-value-object';
8
+ import { PrimitiveValueType } from '../engine/value-object/primitive-object';
9
+ export declare class BaseFunction {
10
10
  private _name;
11
11
  private _unitId;
12
12
  private _subUnitId;
@@ -35,6 +35,7 @@ export declare class BaseFunction extends Disposable {
35
35
  get subUnitId(): Nullable<string>;
36
36
  get row(): number;
37
37
  get column(): number;
38
+ dispose(): void;
38
39
  /**
39
40
  * In Excel, to inject a defined name into a function that has positioning capabilities,
40
41
  * such as using the INDIRECT function to reference a named range,
@@ -38,7 +38,7 @@ export interface IDependencyManagerService {
38
38
  clearFormulaDependency(unitId: string, sheetId?: string): void;
39
39
  addDependencyRTreeCache(tree: FormulaDependencyTree): void;
40
40
  searchDependency(search: IUnitRange[]): Map<string, IRTreeItem>;
41
- hasTreeIdInCache(treeId: string): boolean;
41
+ getLastTreeId(): number;
42
42
  clearDependencyAll(): void;
43
43
  clearOtherFormulaDependency(unitId: string, sheetId?: string): void;
44
44
  clearFeatureFormulaDependency(unitId: string, sheetId?: string): void;
@@ -54,7 +54,7 @@ export declare class DependencyManagerService extends Disposable implements IDep
54
54
  private _featureFormulaData;
55
55
  private _formulaData;
56
56
  private _dependencyRTreeCache;
57
- private _dependencyTreeIdsCache;
57
+ private _dependencyTreeIdLast;
58
58
  dispose(): void;
59
59
  /**
60
60
  * Get all FormulaDependencyTree from _otherFormulaData, _featureFormulaData, _formulaData
@@ -97,10 +97,8 @@ export declare class DependencyManagerService extends Disposable implements IDep
97
97
  clearDependencyAll(): void;
98
98
  getFormulaDependency(unitId: string, sheetId: string, row: number, column: number): Nullable<Nullable<FormulaDependencyTree>>;
99
99
  addDependencyRTreeCache(tree: FormulaDependencyTree): void;
100
- private _addTreeIdToCache;
101
- private _removeTreeIdFromCache;
102
- private _clearTreeIdCache;
103
- hasTreeIdInCache(treeId: string): boolean;
100
+ private _restDependencyTreeId;
101
+ getLastTreeId(): number;
104
102
  private _removeDependencyRTreeCacheById;
105
103
  private _removeDependencyRTreeCache;
106
104
  removeFormulaDependencyByDefinedName(unitId: string, definedName: string): void;
@@ -96,6 +96,7 @@ export interface IFormulaRuntimeService {
96
96
  };
97
97
  setRuntimeFeatureCellData(featureId: string, featureData: IRuntimeUnitDataType): void;
98
98
  setRuntimeFeatureRange(featureId: string, featureRange: IFeatureDirtyRangeType): void;
99
+ clearReferenceAndNumberformatCache(): void;
99
100
  }
100
101
  export declare class FormulaRuntimeService extends Disposable implements IFormulaRuntimeService {
101
102
  private readonly _currentConfigService;
@@ -152,6 +153,7 @@ export declare class FormulaRuntimeService extends Disposable implements IFormul
152
153
  setFormulaExecuteStage(type: FormulaExecuteStageType): void;
153
154
  getFormulaExecuteStage(): FormulaExecuteStageType;
154
155
  reset(): void;
156
+ clearReferenceAndNumberformatCache(): void;
155
157
  setCurrent(row: number, column: number, rowCount: number, columnCount: number, sheetId: string, unitId: string): void;
156
158
  clearFunctionDefinitionPrivacyVar(): void;
157
159
  registerFunctionDefinitionPrivacyVar(lambdaId: string, lambdaVar: Map<string, Nullable<BaseAstNode>>): void;