@univerjs/engine-formula 0.10.6 → 0.10.7

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

@@ -38,3 +38,16 @@ export declare enum ErrorType {
 }
 export declare const ERROR_TYPE_SET: Set<ErrorType>;
 export declare const ERROR_TYPE_COUNT_ARRAY: number[];
+/** Interface for sheet formula errors */
+export interface ISheetFormulaError {
+    /** sheet name */
+    sheetName: string;
+    /** cell row */
+    row: number;
+    /** cell column */
+    column: number;
+    /** formula string (e.g., "=SUM(A1:B10)") */
+    formula: string;
+    /** error type, refer to ErrorType enum */
+    errorType: ErrorType;
+}

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

@@ -1,2 +1,9 @@
 import { ICellData, Nullable } from '@univerjs/core';
+import { ErrorType } from '../../basics/error-type';
 export declare function getCellValue(cell: Nullable<ICellData>): import('@univerjs/core').CellValue;
+/**
+ * Extract the formula error from the cell
+ * @param cell
+ * @returns
+ */
+export declare function extractFormulaError(cell: Nullable<ICellData>, isArrayFormulaCell?: boolean): ErrorType | null;

package/lib/types/index.d.ts

@@ -19,6 +19,7 @@ export { type IOtherFormulaData } from './basics/common';
 export { type IUnitRowData } from './basics/common';
 export { isInDirtyRange } from './basics/dirty';
 export { ERROR_TYPE_SET, ErrorType } from './basics/error-type';
+export { type ISheetFormulaError } from './basics/error-type';
 export { FunctionType, type IFunctionInfo, type IFunctionParam } from './basics/function';
 export { type IFunctionNames } from './basics/function';
 export { includeFormulaLexerToken, isFormulaLexerToken, normalizeSheetName } from './basics/match-token';
@@ -62,6 +63,7 @@ export { BaseReferenceObject, type FunctionVariantType } from './engine/referenc
 export { AsyncArrayObject, AsyncObject } from './engine/reference-object/base-reference-object';
 export { RangeReferenceObject } from './engine/reference-object/range-reference-object';
 export { generateExecuteAstNodeData } from './engine/utils/ast-node-tool';
+export { extractFormulaError } from './engine/utils/cell';
 export { generateAstNode } from './engine/utils/generate-ast-node';
 export { strip, stripErrorMargin } from './engine/utils/math-kit';
 export { handleNumfmtInCell } from './engine/utils/numfmt-kit';