@univerjs/engine-formula 0.1.2 → 0.1.4

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

@@ -48,6 +48,11 @@ export interface IRuntimeUnitDataType {
         [sheetId: string]: ObjectMatrix<Nullable<ICellData>>;
     }>;
 }
+export interface IRuntimeUnitDataPrimitiveType {
+    [unitId: string]: Nullable<{
+        [sheetId: string]: IObjectMatrixPrimitiveType<Nullable<ICellData>>;
+    }>;
+}
 export interface IRuntimeOtherUnitDataType {
     [unitId: string]: Nullable<{
         [sheetId: string]: Nullable<{
@@ -60,6 +65,11 @@ export interface IUnitSheetNameMap {
         [sheetName: string]: string;
     }>;
 }
+export interface IUnitSheetIdToNameMap {
+    [unitId: string]: Nullable<{
+        [sheetId: string]: string;
+    }>;
+}
 export interface IDirtyUnitSheetNameMap {
     [unitId: string]: Nullable<{
         [sheetId: string]: string;
@@ -82,10 +92,7 @@ export interface IFeatureDirtyRangeType {
         [sheetId: string]: IRange[];
     }>;
 }
-export interface IArrayFormulaUnitCellType {
-    [unitId: string]: Nullable<{
-        [sheetId: string]: IObjectMatrixPrimitiveType<Nullable<ICellData>>;
-    }>;
+export interface IArrayFormulaUnitCellType extends IRuntimeUnitDataPrimitiveType {
 }
 export interface IFormulaData {
     [unitId: string]: Nullable<{

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

@@ -13,7 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-export declare const DEFFAULT_DATE_FORMAT = "yyyy-mm-dd;@";
+export declare const DEFAULT_DATE_FORMAT = "yyyy/mm/dd;@";
 /**
  * Excel stores dates as sequential serial numbers so they can be used in calculations. By default, January 1, 1900 is serial number 1, and January 1, 2008 is serial number 39448 because it is 39,447 days after January 1, 1900.
  *

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

@@ -0,0 +1,24 @@
+/**
+ * Copyright 2023-present DreamNum Inc.
+ *
+ * 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.
+ */
+/**
+ * covert number to preview string by pattern
+ * @TODODushusir: Internationalization, reuse with numfmt
+ *
+ * @param pattern
+ * @param value
+ * @returns
+ */
+export declare const getFormatPreview: (pattern: string, value: number) => any;

package/lib/types/basics/inverted-index-cache.d.ts

@@ -29,8 +29,8 @@ export declare class InvertedIndexCache {
     private _cache;
     private _continueBuildingCache;
     set(unitId: string, sheetId: string, column: number, value: string | number | boolean | null, row: number): void;
-    getCellValuePositions(unitId: string, sheetId: string, column: number): Map<string | number | boolean | null, number[]> | undefined;
-    getCellPositions(unitId: string, sheetId: string, column: number, value: string | number | boolean): number[] | undefined;
+    getCellValuePositions(unitId: string, sheetId: string, column: number): Map<string | number | boolean | null, Set<number>> | undefined;
+    getCellPositions(unitId: string, sheetId: string, column: number, value: string | number | boolean): Set<number> | undefined;
     getCellPosition(unitId: string, sheetId: string, column: number, value: string | number | boolean, startRow: number, endRow: number): number | undefined;
     setContinueBuildingCache(unitId: string, sheetId: string, column: number, startRow: number, endRow: number): void;
     shouldContinueBuildingCache(unitId: string, sheetId: string, column: number, row: number): boolean;

package/lib/types/basics/match-token.d.ts

@@ -18,3 +18,8 @@ export declare const FORMULA_LEXER_TOKENS: (operatorToken | suffixToken | compar
 export declare function isFormulaLexerToken(str: string): boolean;
 export declare function includeFormulaLexerToken(str: string): boolean;
 export declare function normalizeSheetName(sheetName: string): string;
+/**
+ * Determine whether the character is a token keyword for the formula engine.
+ * @param char
+ */
+export declare function matchRefDrawToken(char: string): boolean;

package/lib/types/basics/object-class-type.d.ts

@@ -17,6 +17,10 @@ import { Disposable } from '@univerjs/core';
 export declare class ObjectClassType extends Disposable {
     pattern: string;
     getPattern(): string;
+    /**
+     * Only used in NumberValueObject
+     * @param pattern
+     */
     setPattern(pattern: string): void;
     isError(): boolean;
     isAsyncObject(): boolean;

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

@@ -13,5 +13,6 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import type { IArrayFormulaUnitCellType, IRuntimeUnitDataType } from './common';
+import type { IArrayFormulaUnitCellType, IRuntimeUnitDataPrimitiveType, IRuntimeUnitDataType } from './common';
 export declare function convertUnitDataToRuntime(unitData: IArrayFormulaUnitCellType): IRuntimeUnitDataType;
+export declare function convertRuntimeToUnitData(unitData: IRuntimeUnitDataType): IRuntimeUnitDataPrimitiveType;

package/lib/types/basics/token-type.d.ts

@@ -20,3 +20,4 @@ export declare const DEFAULT_TOKEN_TYPE_LAMBDA_RUNTIME_PARAMETER = "LR_1";
 export declare const DEFAULT_TOKEN_TYPE_LAMBDA_OMIT_PARAMETER = "LO_1";
 export declare const DEFAULT_TOKEN_LET_FUNCTION_NAME = "LET";
 export declare const DEFAULT_TOKEN_LAMBDA_FUNCTION_NAME = "LAMBDA";
+export declare const DEFAULT_TOKEN_CUBE_FUNCTION_NAME = "CUBE";

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

@@ -59,3 +59,4 @@ export declare enum prefixToken {
     AT = "@",
     MINUS = "-"
 }
+export declare const SPACE_TOKEN = " ";

package/lib/types/commands/mutations/set-formula-calculation.mutation.d.ts

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 import type { IExecutionOptions, IMutation, IUnitRange, Nullable } from '@univerjs/core';
-import type { IDirtyUnitFeatureMap, IDirtyUnitSheetNameMap, INumfmtItemMap, IRuntimeOtherUnitDataType, IRuntimeUnitDataType } from '../../basics/common';
+import type { IDirtyUnitFeatureMap, IDirtyUnitSheetNameMap, INumfmtItemMap, IRuntimeOtherUnitDataType, IRuntimeUnitDataPrimitiveType } from '../../basics/common';
 import type { FormulaExecutedStateType, IExecutionInProgressParams } from '../../services/runtime.service';
 export interface ISetFormulaCalculationStartMutation {
     dirtyRanges: IUnitRange[];
@@ -38,7 +38,7 @@ export interface ISetFormulaCalculationNotificationMutation {
 }
 export declare const SetFormulaCalculationNotificationMutation: IMutation<ISetFormulaCalculationNotificationMutation>;
 export interface ISetFormulaCalculationResultMutation {
-    unitData: IRuntimeUnitDataType;
+    unitData: IRuntimeUnitDataPrimitiveType;
     unitOtherData: IRuntimeOtherUnitDataType;
 }
 export declare const SetFormulaCalculationResultMutation: IMutation<ISetFormulaCalculationResultMutation>;

package/lib/types/engine/analysis/lexer-tree-builder.d.ts

@@ -52,7 +52,6 @@ export declare class LexerTreeBuilder extends Disposable {
     /**
      * Estimate the number of right brackets that need to be automatically added to the end of the formula.
      * @param formulaString
-     * @returns
      */
     checkIfAddBracket(formulaString: string): number;
     sequenceNodesBuilder(formulaString: string): (string | ISequenceNode)[] | undefined;
@@ -72,6 +71,10 @@ export declare class LexerTreeBuilder extends Disposable {
         hasDefinedName: boolean;
     }): ErrorType.VALUE | LexerNode | (string | LexerNode)[] | undefined;
     private _suffixExpressionHandler;
+    private _checkCloseBracket;
+    private _checkOpenBracket;
+    private _checkOperator;
+    private _deletePlusForPreNode;
     private _resetCurrentLexerNode;
     private _resetSegment;
     private _openBracket;
@@ -79,6 +82,7 @@ export declare class LexerTreeBuilder extends Disposable {
     private _openSquareBracket;
     private _closeSquareBracket;
     private _getCurrentBracket;
+    private _changeCurrentBracket;
     private _openBraces;
     private _closeBraces;
     private _openSingleQuotation;

package/lib/types/engine/analysis/parser.d.ts

@@ -48,7 +48,6 @@ export declare class AstTreeBuilder extends Disposable {
     parse(lexerNode: LexerNode, refOffsetX?: number, refOffsetY?: number): Nullable<BaseAstNode>;
     private _lambdaParameterHandler;
     private _changeLetToLambda;
-    private _getTopParent;
     private _parse;
     private _checkAstNode;
     private _initializeAstNode;

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

@@ -18,9 +18,9 @@ import { Injector } from '@wendellhu/redi';
 import { IDefinedNamesService } from '../../services/defined-names.service';
 import { IFormulaRuntimeService } from '../../services/runtime.service';
 import { ISuperTableService } from '../../services/super-table.service';
-import { Lexer } from '../analysis/lexer';
 import { LexerNode } from '../analysis/lexer-node';
 import type { BaseReferenceObject } from '../reference-object/base-reference-object';
+import { IFunctionService } from '../../services/function.service';
 import { BaseAstNode } from './base-ast-node';
 import { BaseAstNodeFactory } from './base-ast-node-factory';
 import { NodeType } from './node-type';
@@ -37,9 +37,9 @@ export declare class ReferenceNodeFactory extends BaseAstNodeFactory {
     private readonly _definedNamesService;
     private readonly _superTableService;
     private readonly _formulaRuntimeService;
-    private readonly _lexer;
+    private readonly _functionService;
     private readonly _injector;
-    constructor(_definedNamesService: IDefinedNamesService, _superTableService: ISuperTableService, _formulaRuntimeService: IFormulaRuntimeService, _lexer: Lexer, _injector: Injector);
+    constructor(_definedNamesService: IDefinedNamesService, _superTableService: ISuperTableService, _formulaRuntimeService: IFormulaRuntimeService, _functionService: IFunctionService, _injector: Injector);
     get zIndex(): number;
     checkAndCreateNodeType(param: LexerNode | string): ReferenceNode | undefined;
 }

package/lib/types/engine/dependency/dependency-tree.d.ts

@@ -22,6 +22,10 @@ export declare enum FDtreeStateType {
     ADDED = 1,
     SKIP = 2
 }
+export interface IUnitRangeWithToken {
+    gridRange: IUnitRange;
+    token: string;
+}
 /**
  * A dependency tree, capable of calculating mutual dependencies,
  * is used to determine the order of formula calculations.
@@ -37,7 +41,7 @@ export declare class FormulaDependencyTree extends Disposable {
     columnCount: number;
     subUnitId: string;
     unitId: string;
-    rangeList: IUnitRange[];
+    rangeList: IUnitRangeWithToken[];
     formulaId: Nullable<string>;
     featureId: Nullable<string>;
     getDirtyData: Nullable<(tree: FormulaDependencyTree) => {
@@ -55,7 +59,6 @@ export declare class FormulaDependencyTree extends Disposable {
      * "Determine whether all ranges of the current node exist within the dirty area.
      *  If they are within the dirty area, return true, indicating that this node needs to be calculated.
      * @param dependencyRangeList
-     * @returns
      */
     dependencyRange(dependencyRangeList: Map<string, Map<string, IRange[]>>, dirtyUnitSheetNameMap: IDirtyUnitSheetNameMap, unitExcludedCell: Nullable<IUnitExcludedCell>): boolean;
     pushChildren(tree: FormulaDependencyTree): void;
@@ -63,12 +66,25 @@ export declare class FormulaDependencyTree extends Disposable {
      * Add the range corresponding to the current ast node.
      * @param range
      */
-    pushRangeList(range: IUnitRange): void;
+    pushRangeList(range: IUnitRangeWithToken): void;
     /**
      * Determine whether it is dependent on other trees.
      * @param dependenceTree
-     * @returns
      */
     dependency(dependenceTree: FormulaDependencyTree): boolean;
     private _pushParent;
 }
+export declare class FormulaDependencyTreeCache extends Disposable {
+    private _cacheItems;
+    dispose(): void;
+    size(): number;
+    add(unitRangeWithToken: IUnitRangeWithToken, tree: FormulaDependencyTree): void;
+    clear(): void;
+    remove(token: string, tree: FormulaDependencyTree): void;
+    delete(token: string): void;
+    /**
+     * Determine whether range is dependent on other trees.
+     * @param dependenceTree
+     */
+    dependency(dependenceTree: FormulaDependencyTree): void;
+}

package/lib/types/engine/dependency/formula-dependency.d.ts

@@ -43,12 +43,10 @@ export declare class FormulaDependencyGenerator extends Disposable {
     /**
      * Generate nodes for the dependency tree, where each node contains all the reference data ranges included in each formula.
      * @param formulaData
-     * @returns
      */
     private _generateTreeList;
     /**
      * Break down the dirty areas into ranges for subsequent matching.
-     * @returns
      */
     private _updateRangeFlatten;
     private _generateAstNode;
@@ -61,26 +59,22 @@ export declare class FormulaDependencyGenerator extends Disposable {
      * Calculate the range required for collection in advance,
      * including references and location functions (such as OFFSET, INDIRECT, INDEX, etc.).
      * @param node
-     * @returns
      */
     private _getRangeListByNode;
     /**
      * Build a formula dependency tree based on the dependency relationships.
      * @param treeList
-     * @returns
      */
     private _getUpdateTreeListAndMakeDependency;
     /**
      * Determine whether all ranges of the current node exist within the dirty area.
      * If they are within the dirty area, return true, indicating that this node needs to be calculated.
      * @param tree
-     * @returns
      */
     private _includeTree;
     /**
      * Generate the final formula calculation order array by traversing the dependency tree established via depth-first search.
      * @param treeList
-     * @returns
      */
     private _calculateRunList;
 }

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

@@ -19,7 +19,7 @@ import type { INumfmtItemMap, IRuntimeUnitDataType, IUnitData, IUnitSheetNameMap
 import { ObjectClassType } from '../../basics/object-class-type';
 import { ArrayValueObject } from '../value-object/array-value-object';
 import { type BaseValueObject, ErrorValueObject } from '../value-object/base-value-object';
-import { BooleanValueObject, NullValueObject, NumberValueObject, StringValueObject } from '../value-object/primitive-object';
+import { NullValueObject, NumberValueObject } from '../value-object/primitive-object';
 export type NodeValueType = BaseValueObject | BaseReferenceObject | AsyncObject | AsyncArrayObject;
 export type FunctionVariantType = BaseValueObject | BaseReferenceObject;
 export declare const FORMULA_REF_TO_ARRAY_CACHE: FormulaAstLRU<ArrayValueObject>;
@@ -41,6 +41,8 @@ export declare class BaseReferenceObject extends ObjectClassType {
     private _refOffsetY;
     constructor(_token: string);
     dispose(): void;
+    getToken(): string;
+    setToken(token: string): void;
     isExceedRange(): boolean;
     setRefOffset(x?: number, y?: number): void;
     getRefOffset(): {
@@ -55,7 +57,7 @@ export declare class BaseReferenceObject extends ObjectClassType {
     };
     isReferenceObject(): boolean;
     iterator(callback: (valueObject: Nullable<BaseValueObject>, rowIndex: number, columnIndex: number) => Nullable<boolean>): Nullable<boolean>;
-    getFirstCell(): ErrorValueObject | NullValueObject | NumberValueObject | StringValueObject | BooleanValueObject | ArrayValueObject;
+    getFirstCell(): ErrorValueObject | NullValueObject | NumberValueObject | import("../value-object/primitive-object").BooleanValueObject | import("../value-object/primitive-object").StringValueObject | ArrayValueObject;
     getRangeData(): IRange;
     setRangeData(range: IRange): void;
     getUnitId(): string;
@@ -98,16 +100,16 @@ export declare class BaseReferenceObject extends ObjectClassType {
     isTable(): boolean;
     unionBy(referenceObject: BaseReferenceObject): NodeValueType;
     unionRange(rangeData1: IRange, rangeData2: IRange): IRange;
-    getCellValueObject(cell: ICellData): ErrorValueObject | NullValueObject | NumberValueObject | StringValueObject | BooleanValueObject | ArrayValueObject;
-    getCellByRow(row: number): ErrorValueObject | NullValueObject | NumberValueObject | StringValueObject | BooleanValueObject | ArrayValueObject;
-    getCellByColumn(column: number): ErrorValueObject | NullValueObject | NumberValueObject | StringValueObject | BooleanValueObject | ArrayValueObject;
+    getCellValueObject(cell: ICellData): ErrorValueObject | NullValueObject | NumberValueObject | import("../value-object/primitive-object").BooleanValueObject | import("../value-object/primitive-object").StringValueObject | ArrayValueObject;
+    getCellByRow(row: number): ErrorValueObject | NullValueObject | NumberValueObject | import("../value-object/primitive-object").BooleanValueObject | import("../value-object/primitive-object").StringValueObject | ArrayValueObject;
+    getCellByColumn(column: number): ErrorValueObject | NullValueObject | NumberValueObject | import("../value-object/primitive-object").BooleanValueObject | import("../value-object/primitive-object").StringValueObject | ArrayValueObject;
     getCurrentActiveSheetData(): import("../../basics/common").ISheetItem;
     getCurrentRuntimeSheetData(): import("@univerjs/core").ObjectMatrix<Nullable<ICellData>> | undefined;
     getCurrentActiveArrayFormulaCellData(): import("@univerjs/core").ObjectMatrix<Nullable<ICellData>> | undefined;
     getCurrentRuntimeActiveArrayFormulaCellData(): import("@univerjs/core").ObjectMatrix<Nullable<ICellData>> | undefined;
     getCellData(row: number, column: number): ICellData;
     getRuntimeFeatureCellValue(row: number, column: number): ICellData | undefined;
-    getCellByPosition(row?: number, column?: number): ErrorValueObject | NullValueObject | NumberValueObject | StringValueObject | BooleanValueObject | ArrayValueObject;
+    getCellByPosition(row?: number, column?: number): ErrorValueObject | NullValueObject | NumberValueObject | import("../value-object/primitive-object").BooleanValueObject | import("../value-object/primitive-object").StringValueObject | ArrayValueObject;
     toArrayValueObject(useCache?: boolean): ArrayValueObject;
     toUnitRange(): {
         range: {

package/lib/types/engine/utils/ast-node-tool.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Copyright 2023-present DreamNum Inc.
+ *
+ * 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 { Nullable } from '@univerjs/core';
+import type { BaseAstNode } from '../ast-node/base-ast-node';
+export declare function getAstNodeTopParent(node: BaseAstNode): Nullable<BaseAstNode>;

package/lib/types/engine/utils/char-kit.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Copyright 2023-present DreamNum Inc.
+ *
+ * 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.
+ */
+/**
+ * Korean in Excel does not count as two characters. Here we calculate all Chinese, Japanese and Korean characters as two characters.
+ *
+ * ā -> 1
+ * ー -> 2
+ *
+ * @param str
+ * @returns
+ */
+export declare function charLenByte(str: string): number;

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

@@ -28,3 +28,4 @@ export declare function isWildcard(str: string): boolean;
 export declare function isMatchWildcard(currentValue: string, value: string): boolean;
 export declare function replaceWildcard(value: string): string;
 export declare function compareWithWildcard(currentValue: string, value: string, operator: compareToken): boolean;
+export declare function escapeRegExp(str: string): string;

package/lib/types/engine/utils/object-compare.d.ts

@@ -27,6 +27,5 @@ export declare function valueObjectCompare(range: BaseValueObject, criteria: Bas
  * Find the Boolean intersection of two ArrayValueObjects
  * @param valueObject1
  * @param valueObject2
- * @returns
  */
 export declare function booleanObjectIntersection(valueObject1: BaseValueObject, valueObject2: BaseValueObject): BaseValueObject;

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

@@ -0,0 +1,24 @@
+/**
+ * Copyright 2023-present DreamNum Inc.
+ *
+ * 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 { Injector } from '@wendellhu/redi';
+import type { Nullable } from '@univerjs/core';
+import type { IFunctionService } from '../../services/function.service';
+import { PrefixNode } from '../ast-node/prefix-node';
+export declare function prefixHandler(tokenTrim: string, functionService: IFunctionService, injector: Injector): {
+    tokenTrim: string;
+    minusPrefixNode: Nullable<PrefixNode>;
+    atPrefixNode: Nullable<PrefixNode>;
+};

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

@@ -13,7 +13,6 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { type IRange } from '@univerjs/core';
-import type { IGridRangeName } from './reference';
-export declare function deserializeRangeForR1C1(refString: string, currentRow?: number, currentColumn?: number): IGridRangeName;
+import type { IRange, IUnitRangeName } from '@univerjs/core';
+export declare function deserializeRangeForR1C1(refString: string, currentRow?: number, currentColumn?: number): IUnitRangeName;
 export declare function serializeRangeToR1C1(range: IRange): string;

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

@@ -13,13 +13,8 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import type { IRange } from '@univerjs/core';
+import type { IRange, IUnitRangeName } from '@univerjs/core';
 import { AbsoluteRefType } from '@univerjs/core';
-export interface IGridRangeName {
-    unitId: string;
-    sheetName: string;
-    range: IRange;
-}
 export interface IAbsoluteRefTypeForRange {
     startAbsoluteRefType: AbsoluteRefType;
     endAbsoluteRefType?: AbsoluteRefType;
@@ -52,18 +47,18 @@ export declare function serializeRangeWithSheet(sheetName: string, range: IRange
  * @param range
  */
 export declare function serializeRangeWithSpreadsheet(unit: string, sheetName: string, range: IRange): string;
-export declare function serializeRangeToRefString(gridRangeName: IGridRangeName): string;
+export declare function serializeRangeToRefString(gridRangeName: IUnitRangeName): string;
 export declare function handleRefStringInfo(refString: string): {
     refBody: string;
     sheetName: string;
     unitId: string;
 };
-export declare function deserializeRangeWithSheet(refString: string): IGridRangeName;
+export declare function deserializeRangeWithSheet(refString: string): IUnitRangeName;
 /**
  * Determine whether the sheet name needs to be wrapped in quotes
  * Excel will quote the worksheet name if any of the following is true:
  *  - It contains any space or punctuation characters, such as  ()$,;-{}"'（）【】“”‘’%… and many more
- *  - It is a valid cell reference in A1 notation, e.g. B1048576 is quoted, B1048577 is not
+ *  - It is a valid cell reference in A1 notation, e.g. B1048576 is quoted
  *  - It is a valid cell reference in R1C1 notation, e.g. RC, RC2, R5C, R-4C, RC-8, R, C
  *  - It starts with a non-letter, e.g. 99, 1.5, 12a, 💩a
  *  - Excel will not quote worksheet names if they only contain non-punctuation, non-letter characters in non-initial positions. For example, a💩 remains unquoted.*

package/lib/types/engine/value-object/__tests__/array-value-divided.spec.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Copyright 2023-present DreamNum Inc.
+ *
+ * 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.
+ */
+export {};

package/lib/types/engine/value-object/__tests__/array-value-minus.spec.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Copyright 2023-present DreamNum Inc.
+ *
+ * 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.
+ */
+export {};

package/lib/types/engine/value-object/__tests__/array-value-multiply.spec.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Copyright 2023-present DreamNum Inc.
+ *
+ * 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.
+ */
+export {};

package/lib/types/engine/value-object/__tests__/array-value-plus.spec.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Copyright 2023-present DreamNum Inc.
+ *
+ * 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.
+ */
+export {};

package/lib/types/engine/value-object/array-value-object.d.ts

@@ -16,13 +16,14 @@
 import type { Nullable } from '@univerjs/core';
 import { compareToken } from '../../basics/token';
 import { ArrayBinarySearchType, ArrayOrderSearchType } from '../utils/compare';
-import type { callbackMapFnType, callbackProductFnType, IArrayValueObject } from './base-value-object';
+import type { callbackMapFnType, IArrayValueObject } from './base-value-object';
 import { BaseValueObject, ErrorValueObject } from './base-value-object';
 import { BooleanValueObject, NullValueObject, NumberValueObject, StringValueObject } from './primitive-object';
 export declare function fromObjectToString(array: IArrayValueObject): string;
 export declare function transformToValueObject(array?: Array<Array<number | string | boolean | null>>): BaseValueObject[][];
-export declare function transformToValue(array?: BaseValueObject[][]): (string | number | boolean | null)[][];
+export declare function transformToValue(array?: Nullable<BaseValueObject>[][]): (string | number | boolean | null)[][];
 export declare class ArrayValueObject extends BaseValueObject {
+    static create(rawValue: string | IArrayValueObject): ArrayValueObject;
     private _values;
     private _rowCount;
     private _columnCount;
@@ -47,12 +48,12 @@ export declare class ArrayValueObject extends BaseValueObject {
     getSheetId(): string;
     getCurrentRow(): number;
     getCurrentColumn(): number;
-    getArrayValue(): BaseValueObject[][];
+    getArrayValue(): Nullable<BaseValueObject>[][];
     setArrayValue(value: BaseValueObject[][]): void;
     isArray(): boolean;
-    get(row: number, column: number): BaseValueObject;
+    get(row: number, column: number): BaseValueObject | null;
     getRealValue(row: number, column: number): BaseValueObject | null;
-    set(row: number, column: number, value: BaseValueObject): void;
+    set(row: number, column: number, value: Nullable<BaseValueObject>): void;
     getRangePosition(): {
         startRow: number;
         endRow: number;
@@ -133,7 +134,6 @@ export declare class ArrayValueObject extends BaseValueObject {
     compare(valueObject: BaseValueObject, operator: compareToken): BaseValueObject;
     concatenateFront(valueObject: BaseValueObject): BaseValueObject;
     concatenateBack(valueObject: BaseValueObject): BaseValueObject;
-    product(valueObject: BaseValueObject, callbackFn: callbackProductFnType): BaseValueObject;
     map(callbackFn: callbackMapFnType): BaseValueObject;
     mapValue(callbackFn: callbackMapFnType): BaseValueObject;
     pow(valueObject: BaseValueObject): BaseValueObject;
@@ -210,5 +210,5 @@ export declare class ArrayValueObject extends BaseValueObject {
     private _createNewArray;
 }
 export declare class ValueObjectFactory {
-    static create(rawValue: string | number | boolean | null): ErrorValueObject | NullValueObject | NumberValueObject | StringValueObject | BooleanValueObject | ArrayValueObject;
+    static create(rawValue: string | number | boolean | null): ErrorValueObject | NullValueObject | NumberValueObject | BooleanValueObject | StringValueObject | ArrayValueObject;
 }