@univerjs/engine-formula 1.0.0-beta.0 → 1.0.0-beta.2

package/lib/locale/ca-ES.js

@@ -3145,20 +3145,20 @@ const locale$9 = {
 		}
 	},
 	EFFECT: {
-		description: "Returns the effective annual interest rate",
-		abstract: "Returns the effective annual interest rate",
+		description: "Devuelve la tasa de interés anual efectiva",
+		abstract: "Devuelve la tasa de interés anual efectiva",
 		links: [{
-			title: "Instruction",
+			title: "Instrucciones",
 			url: "https://support.microsoft.com/ca-es/excel/functions/effect-function"
 		}],
 		functionParameter: {
 			nominalRate: {
-				name: "nominal_rate",
-				detail: "The nominal interest rate."
+				name: "tasa_nominal",
+				detail: "La tasa de interés nominal."
 			},
 			npery: {
-				name: "npery",
-				detail: "The number of compounding periods per year."
+				name: "núm_per_año",
+				detail: "El número de periodos de composición por año."
 			}
 		}
 	},
@@ -3211,66 +3211,66 @@ const locale$9 = {
 		}
 	},
 	INTRATE: {
-		description: "Returns the interest rate for a fully invested security",
-		abstract: "Returns the interest rate for a fully invested security",
+		description: "Devuelve la tasa de interés para la inversión total en un valor bursátil.",
+		abstract: "Devuelve la tasa de interés para la inversión total en un valor bursátil.",
 		links: [{
-			title: "Instruction",
+			title: "Instrucciones",
 			url: "https://support.microsoft.com/ca-es/excel/functions/intrate-function"
 		}],
 		functionParameter: {
 			settlement: {
-				name: "settlement",
-				detail: "The security's settlement date."
+				name: "liquidación",
+				detail: "Obligatorio. La fecha de liquidación del valor bursátil. La fecha de liquidación del valor bursátil es la fecha posterior a la fecha de emisión en la que el comprador adquiere el valor bursátil."
 			},
 			maturity: {
-				name: "maturity",
-				detail: "The security's maturity date."
+				name: "vencimiento",
+				detail: "Obligatorio. La fecha de vencimiento del valor bursátil. La fecha de vencimiento es aquella en la que expira el valor bursátil."
 			},
 			investment: {
-				name: "investment",
-				detail: "The amount invested in the security."
+				name: "inversión",
+				detail: "Obligatorio. Es la cantidad de dinero invertido en el valor bursátil."
 			},
 			redemption: {
-				name: "redemption",
-				detail: "The amount to be received at maturity."
+				name: "rescate",
+				detail: "Obligatorio. Es el valor que se recibirá en la fecha de vencimiento."
 			},
 			basis: {
-				name: "basis",
-				detail: "The type of day count basis to use."
+				name: "base",
+				detail: "Opcional. Determina en qué tipo de base deben contarse los días."
 			}
 		}
 	},
 	IPMT: {
-		description: "Returns the interest payment for an investment for a given period",
-		abstract: "Returns the interest payment for an investment for a given period",
+		description: "Devuelve el pago de intereses de una inversión durante un periodo determinado",
+		abstract: "Devuelve el pago de intereses de una inversión durante un periodo determinado",
 		links: [{
-			title: "Instruction",
+			title: "Instrucciones",
 			url: "https://support.microsoft.com/ca-es/excel/functions/ipmt-function"
 		}],
 		functionParameter: {
 			rate: {
-				name: "rate",
-				detail: "The interest rate per period."
+				name: "tasa",
+				detail: "La tasa de interés por periodo."
 			},
 			per: {
-				name: "per",
-				detail: "The period for which you want to find the interest and must be in the range 1 to nper."
+				name: "periodo",
+				detail: "El periodo para el cual desea buscar el interés y debe estar en el rango de 1 a núm_pagos."
 			},
 			nper: {
-				name: "nper",
-				detail: "The total number of payment periods in an annuity."
+				name: "núm_pagos",
+				detail: "El número total de periodos de pago en una anualidad."
 			},
 			pv: {
-				name: "pv",
-				detail: "The present value, or the lump-sum amount that a series of future payments is worth right now."
+				name: "va",
+				detail: "El valor actual, o la cantidad total que vale ahora una serie de pagos futuros."
 			},
 			fv: {
-				name: "fv",
-				detail: "The future value, or a cash balance you want to attain after the last payment is made."
+				name: "vf",
+				detail: "El valor futuro, o un saldo en efectivo que desea lograr después de realizar el último pago."
 			},
 			type: {
-				name: "type",
-				detail: "The number 0 or 1 and indicates when payments are due."
+				name: "tipo",
+				detail: "El número 0 o 1 e indica cuándo vencen los pagos."
 			}
 		}
 	},

package/lib/locale/fr-FR.js

@@ -3145,20 +3145,20 @@ const locale$9 = {
 		}
 	},
 	EFFECT: {
-		description: "Returns the effective annual interest rate",
-		abstract: "Returns the effective annual interest rate",
+		description: "Cette fonction renvoie le taux d’intérêt annuel effectif.",
+		abstract: "Taux d’intérêt annuel effectif.",
 		links: [{
 			title: "Instruction",
 			url: "https://support.microsoft.com/fr-fr/excel/functions/effect-function"
 		}],
 		functionParameter: {
 			nominalRate: {
-				name: "nominal_rate",
-				detail: "The nominal interest rate."
+				name: "taux_nominal",
+				detail: "Représente le taux d’intérêt nominal."
 			},
 			npery: {
-				name: "npery",
-				detail: "The number of compounding periods per year."
+				name: "nb_périodes",
+				detail: "Nombre de périodes annuelles pour le calcul des intérêts composés."
 			}
 		}
 	},
@@ -5148,20 +5148,20 @@ const locale$6 = {
 		}],
 		functionParameter: {
 			dataField: {
-				name: "dataField",
-				detail: ""
+				name: "champ_données",
+				detail: "Nom du champ du tableau croisé dynamique contenant les données à récupérer. Il doit être placé entre guillemets."
 			},
 			pivotTable: {
-				name: "pivotTable",
-				detail: ""
+				name: "tableau_croisé_dyn",
+				detail: "Référence à une cellule, une plage ou une plage nommée du tableau croisé dynamique contenant les données."
 			},
 			field1: {
-				name: "field1",
-				detail: ""
+				name: "champ1",
+				detail: "Paire facultative de noms de champ et d’élément décrivant les données à récupérer."
 			},
 			item1: {
-				name: "item1",
-				detail: ""
+				name: "élément1",
+				detail: "Paire facultative de noms de champ et d’élément décrivant les données à récupérer."
 			}
 		}
 	},

package/lib/locale/ko-KR.js

@@ -1862,20 +1862,20 @@ const locale$10 = {
 		}
 	},
 	BITAND: {
-		description: "Returns a 'Bitwise And' of two numbers",
-		abstract: "Returns a 'Bitwise And' of two numbers",
+		description: "두 숫자의 비트 단위 'AND'를 반환합니다.",
+		abstract: "두 숫자의 비트 단위 'AND'를 반환합니다.",
 		links: [{
 			title: "Instruction",
 			url: "https://support.microsoft.com/ko-kr/excel/functions/bitand-function"
 		}],
 		functionParameter: {
 			number1: {
-				name: "number1",
-				detail: "Must be in decimal form and greater than or equal to 0."
+				name: "번호1",
+				detail: "0보다 크거나 같은 10진수 형식이어야 합니다."
 			},
 			number2: {
-				name: "number2",
-				detail: "Must be in decimal form and greater than or equal to 0."
+				name: "번호2",
+				detail: "0보다 크거나 같은 10진수 형식이어야 합니다."
 			}
 		}
 	},
@@ -1982,16 +1982,16 @@ const locale$10 = {
 		}],
 		functionParameter: {
 			number: {
-				name: "number",
-				detail: "is the value in from_units to convert."
+				name: "숫자",
+				detail: "변환할 from_unit 단위의 값입니다."
 			},
 			fromUnit: {
 				name: "from_unit",
-				detail: "is the units for number."
+				detail: "숫자의 단위입니다."
 			},
 			toUnit: {
 				name: "to_unit",
-				detail: "is the units for the result."
+				detail: "결과의 단위입니다."
 			}
 		}
 	},
@@ -2308,8 +2308,8 @@ const locale$10 = {
 		} }
 	},
 	IMDIV: {
-		description: "Returns the quotient of two complex numbers",
-		abstract: "Returns the quotient of two complex numbers",
+		description: "x + yi 또는 x + yj 텍스트 형식인 두 복소수의 나눗셈 몫을 반환합니다.",
+		abstract: "두 복소수의 나눗셈 몫을 반환합니다.",
 		links: [{
 			title: "Instruction",
 			url: "https://support.microsoft.com/ko-kr/excel/functions/imdiv-function"
@@ -2317,11 +2317,11 @@ const locale$10 = {
 		functionParameter: {
 			inumber1: {
 				name: "inumber1",
-				detail: "The complex numerator or dividend."
+				detail: "분자 또는 피제수인 복소수입니다."
 			},
 			inumber2: {
 				name: "inumber2",
-				detail: "The complex denominator or divisor."
+				detail: "분모 또는 제수인 복소수입니다."
 			}
 		}
 	},
@@ -4763,7 +4763,7 @@ const locale$7 = {
 			},
 			value3: {
 				name: "lambda",
-				detail: " A LAMBDA that is called to create the array. The LAMBDA takes two parameters: row (The row index of the array), col (The column index of the array)."
+				detail: "배열을 만들기 위해 호출되는 LAMBDA입니다. LAMBDA는 행 인덱스와 열 인덱스 두 매개 변수를 사용합니다."
 			}
 		}
 	},
@@ -8314,8 +8314,8 @@ const locale$4 = {
 				detail: "MARGINOFERROR(A1:C3, 0.99)"
 			},
 			confidence: {
-				name: "confidence",
-				detail: "The desired confidence level between (0, 1)."
+				name: "신뢰도",
+				detail: "(0, 1) 범위에서 원하는 신뢰 수준입니다."
 			}
 		}
 	},

package/lib/locale/sk-SK.js

@@ -5148,20 +5148,20 @@ const locale$6 = {
 		}],
 		functionParameter: {
 			dataField: {
-				name: "dataField",
-				detail: ""
+				name: "údajové_pole",
+				detail: "Názov poľa kontingenčnej tabuľky obsahujúce údaje, ktoré chcete načítať. Musí byť v úvodzovkách."
 			},
 			pivotTable: {
-				name: "pivotTable",
-				detail: ""
+				name: "kontingenčná_tabuľka",
+				detail: "Odkaz na bunku, rozsah buniek alebo pomenovaný rozsah v kontingenčnej tabuľke obsahujúcej požadované údaje."
 			},
 			field1: {
-				name: "field1",
-				detail: ""
+				name: "pole1",
+				detail: "Voliteľná dvojica názvu poľa a položky opisujúca údaje, ktoré chcete načítať."
 			},
 			item1: {
-				name: "item1",
-				detail: ""
+				name: "položka1",
+				detail: "Voliteľná dvojica názvu poľa a položky opisujúca údaje, ktoré chcete načítať."
 			}
 		}
 	},

package/lib/locale/vi-VN.js

@@ -5821,8 +5821,8 @@ const locale$5 = {
 		}
 	},
 	ARABIC: {
-		description: "Converts a Roman number to Arabic, as a number",
-		abstract: "Converts a Roman number to Arabic, as a number",
+		description: "Chuyển đổi một chữ số La Mã sang một chữ số Ả-rập.",
+		abstract: "Chuyển đổi một chữ số La Mã sang một chữ số Ả-rập.",
 		links: [{
 			title: "Hướng dẫn",
 			url: "https://support.microsoft.com/vi-vn/excel/functions/arabic-function"

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

@@ -220,6 +220,8 @@ export interface ISuperTable {
      * Sheet tables default to true; Base virtual tables store records from row 0.
      */
     showHeader?: boolean;
+    /** Whether the projected range contains a physical totals row. */
+    showFooter?: boolean;
 }
 export declare enum TableOptionType {
     ALL = "#All",

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 = "^(?:(?:\\[([^\\[\\]\\/?:\"<>|*\\\\]+)\\]|'(?:[^']|'')+'|[^\\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*?\\[[^#]*#?\\]\\])+$";
-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!\\[\\]]+)!)?(?:\\[([^\\[\\]\\/?:\"<>|*\\\\]+)\\])?((?![~!@#$%^&*()+<>?:,./;\u2019\uFF0C\u3002\u3001\u2018\uFF1A\u201C\u300A\u300B\uFF1F~\uFF01@#\uFFE5%\u2026\u2026\uFF08\uFF09\u3010\u3011\\[\\]\\/\\\\]).)+(\\[\\[#.+\\]\\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 = "^(?:(?:\\[(?:[^\\]]|\\]\\])+\\]|'(?:[^']|'')+'|[^\\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*?\\[[^#]*#?\\]\\])+$";
+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!\\[\\]]+)!)?(?:\\[(?:[^\\]]|\\]\\])+\\])?((?![~!@#$%^&*()+<>?:,./;\u2019\uFF0C\u3002\u3001\u2018\uFF1A\u201C\u300A\u300B\uFF1F~\uFF01@#\uFFE5%\u2026\u2026\uFF08\uFF09\u3010\u3011\\[\\]\\/\\\\]).)+(\\[\\[#.+\\]\\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

@@ -15,7 +15,6 @@
  */
 import { Disposable, LifecycleService } from '@univerjs/core';
 import { FormulaCalculationTriggerService } from '../services/formula-calculation-trigger.service';
-import { RegisterOtherFormulaService } from '../services/register-other-formula.service';
 export declare class FormulaCalculationTriggerController extends Disposable {
-    constructor(formulaCalculationTriggerService: FormulaCalculationTriggerService, registerOtherFormulaService: RegisterOtherFormulaService, lifecycleService: LifecycleService);
+    constructor(formulaCalculationTriggerService: FormulaCalculationTriggerService, lifecycleService: LifecycleService);
 }

package/lib/types/controllers/formula.controller.d.ts

@@ -17,7 +17,7 @@ import { Disposable, ICommandService, IConfigService } from '@univerjs/core';
 import { DataSyncPrimaryController } from '@univerjs/rpc';
 import { IFunctionService } from '../services/function.service';
 import { RegisterOtherFormulaService } from '../services/register-other-formula.service';
-type FormulaDataSyncController = Pick<DataSyncPrimaryController, 'registerSyncingMutations' | 'syncUnitMutations'>;
+type FormulaDataSyncController = Pick<DataSyncPrimaryController, 'registerSyncingMutations' | 'syncUnitMutations' | 'waitForPendingMutations'>;
 export declare class FormulaController extends Disposable {
     private readonly _commandService;
     private readonly _functionService;

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

@@ -132,7 +132,7 @@ export declare class ArrayValueObject extends BaseValueObject {
      * the sequential matching approach is only used for special matches in XLOOKUP and XMATCH.
      * For example, when match_mode is set to 1 and -1 for an exact match. If not found, it returns the next smaller item.
      */
-    orderSearch(valueObject: BaseValueObject, searchType?: ArrayOrderSearchType, isDesc?: boolean, isFuzzyMatching?: boolean): void | {
+    orderSearch(valueObject: BaseValueObject, searchType?: ArrayOrderSearchType, isDesc?: boolean, isFuzzyMatching?: boolean, keepFirstNearest?: boolean): void | {
         row: number;
         column: number;
     } | null;

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

@@ -167,11 +167,11 @@ export declare class BaseFunction {
     private _getOneLastByRaw;
     equalSearch(value: BaseValueObject, searchArray: ArrayValueObject, resultArray: ArrayValueObject, isFirst?: boolean): BaseValueObject;
     fuzzySearch(value: BaseValueObject, searchArray: ArrayValueObject, resultArray: ArrayValueObject, isFirst?: boolean): BaseValueObject;
-    orderSearch(value: BaseValueObject, searchArray: ArrayValueObject, resultArray: ArrayValueObject, searchType?: ArrayOrderSearchType, isDesc?: boolean): BaseValueObject;
+    orderSearch(value: BaseValueObject, searchArray: ArrayValueObject, resultArray: ArrayValueObject, searchType?: ArrayOrderSearchType, isDesc?: boolean, keepFirstNearest?: boolean): BaseValueObject;
     binarySearchExpand(value: BaseValueObject, searchArray: ArrayValueObject, resultArray: ArrayValueObject, axis?: number, searchType?: ArrayBinarySearchType, matchType?: ArrayOrderSearchType): ErrorValueObject | ArrayValueObject | undefined;
     equalSearchExpand(value: BaseValueObject, searchArray: ArrayValueObject, resultArray: ArrayValueObject, isFirst?: boolean, axis?: number): ErrorValueObject | ArrayValueObject | undefined;
     fuzzySearchExpand(value: BaseValueObject, searchArray: ArrayValueObject, resultArray: ArrayValueObject, isFirst?: boolean, axis?: number): ErrorValueObject | ArrayValueObject | undefined;
-    orderSearchExpand(value: BaseValueObject, searchArray: ArrayValueObject, resultArray: ArrayValueObject, searchType?: ArrayOrderSearchType, isDesc?: boolean, axis?: number): ErrorValueObject | ArrayValueObject | undefined;
+    orderSearchExpand(value: BaseValueObject, searchArray: ArrayValueObject, resultArray: ArrayValueObject, searchType?: ArrayOrderSearchType, isDesc?: boolean, axis?: number, keepFirstNearest?: boolean): ErrorValueObject | ArrayValueObject | undefined;
     flattenArray(variants: BaseValueObject[], ignoreLogicalValuesAndText?: boolean): ArrayValueObject | BaseValueObject;
     private _includingLogicalValuesAndText;
     createReferenceObject(reference: BaseReferenceObject, range: IRange): ErrorValueObject | BaseReferenceObject;

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

@@ -14,14 +14,13 @@
  * 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';
+import { Sum } from '../../math/sum';
 /**
- * PERCENTOF is an Excel GROUPBY aggregator token. It is evaluated by GROUPBY's
- * AST path, not as a standalone scalar function.
+ * PERCENTOF is logically equivalent to SUM(dataSubset) / SUM(dataAll).
+ * GROUPBY also consumes the function name as an aggregator token through its AST path.
  */
-export declare class Percentof extends BaseFunction {
+export declare class Percentof extends Sum {
     minParams: number;
     maxParams: number;
-    calculate(..._variants: BaseValueObject[]): ErrorValueObject;
+    calculate(dataSubset: BaseValueObject, dataAll: BaseValueObject): BaseValueObject;
 }

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

@@ -23,6 +23,10 @@ export declare class Xlookup extends BaseFunction {
     private _legacyImplicitLookupValue;
     private _handleExpandObject;
     private _handleSingleObject;
+    private _exactSearch;
+    private _exactSearchExpand;
+    private _findExactPosition;
+    private _isExactMatch;
     private _blankResultAsZero;
     /**
      * Wildcard matching and binary search cannot appear at the same time

package/lib/types/index.d.ts

@@ -137,7 +137,6 @@ export { getObjectValue } from './functions/util';
 export { functionWeb } from './functions/web/function-map';
 export { FUNCTION_NAMES_WEB } from './functions/web/function-names';
 export { FormulaDataModel } from './models/formula-data.model';
-export { initSheetFormulaData } from './models/formula-data.model';
 export type { IRangeChange } from './models/formula-data.model';
 export { UniverFormulaEnginePlugin } from './plugin';
 export { ActiveDirtyManagerService, IActiveDirtyManagerService } from './services/active-dirty-manager.service';

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

@@ -24,6 +24,7 @@ export interface IRangeChange {
 export declare class FormulaDataModel extends Disposable {
     private readonly _univerInstanceService;
     private readonly _lexerTreeBuilder;
+    private _formulaIdMapData;
     private _arrayFormulaRange;
     private _arrayFormulaCellData;
     private _unitImageFormulaData;
@@ -32,6 +33,8 @@ export declare class FormulaDataModel extends Disposable {
     clearPreviousArrayFormulaCellData(clearArrayFormulaCellData: IRuntimeUnitDataType): void;
     mergeArrayFormulaCellData(unitData: IRuntimeUnitDataType): void;
     getFormulaData(): IFormulaData;
+    initSheetFormulaData(formulaData: IFormulaData, unitId: string, sheetId: string, cellMatrix: ObjectMatrix<Nullable<ICellData>>): IFormulaData;
+    clearFormulaIdMap(unitId: string, sheetId?: string): void;
     getSheetFormulaData(unitId: string, sheetId: string): Nullable<IObjectMatrixPrimitiveType<Nullable<IFormulaDataItem>>>;
     getArrayFormulaRange(): IArrayFormulaRangeType;
     setArrayFormulaRange(value: IArrayFormulaRangeType): void;
@@ -67,4 +70,3 @@ export declare class FormulaDataModel extends Disposable {
     getFormulaDirtyRanges(): IUnitRange[];
     private _initSheetArrayFormulaData;
 }
-export declare function initSheetFormulaData(formulaData: IFormulaData, unitId: string, sheetId: string, cellMatrix: ObjectMatrix<Nullable<ICellData>>): IFormulaData;

package/lib/types/services/register-other-formula.service.d.ts

@@ -13,11 +13,10 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import type { IRange, Nullable } from '@univerjs/core';
+import type { IDisposable, IRange, Nullable } from '@univerjs/core';
 import type { ISetFormulaCalculationResultMutation } from '../commands/mutations/set-formula-calculation.mutation';
 import type { IOtherFormulaResult } from './formula-common';
 import { Disposable, ICommandService, LifecycleService } from '@univerjs/core';
-import { BehaviorSubject } from 'rxjs';
 import { IActiveDirtyManagerService } from './active-dirty-manager.service';
 export declare enum OtherFormulaBizType {
     DEFAULT = "default",
@@ -33,6 +32,7 @@ export declare class RegisterOtherFormulaService extends Disposable {
     private _activeDirtyManagerService;
     private readonly _lifecycleService;
     private _formulaCacheMap;
+    private _mutationSyncHandler?;
     private _formulaChangeWithRange$;
     formulaChangeWithRange$: import("rxjs").Observable<{
         unitId: string;
@@ -45,12 +45,12 @@ export declare class RegisterOtherFormulaService extends Disposable {
     formulaResult$: import("rxjs").Observable<Record<string, Record<string, IOtherFormulaResult[]>>>;
     private _otherFormulaResultApplied$;
     otherFormulaResultApplied$: import("rxjs").Observable<ISetFormulaCalculationResultMutation>;
-    calculateStarted$: BehaviorSubject<boolean>;
     constructor(_commandService: ICommandService, _activeDirtyManagerService: IActiveDirtyManagerService, _lifecycleService: LifecycleService);
     dispose(): void;
     private _ensureCacheMap;
     private _createFormulaId;
     private _initFormulaRegister;
+    setMutationSyncHandler(handler: (unitId: string) => () => Promise<void>): IDisposable;
     private _initFormulaCalculationResultChange;
     registerFormulaWithRange(unitId: string, subUnitId: string, formulaText: string, ranges?: IRange[], extra?: Record<string, any>, bizType?: OtherFormulaBizType, bizId?: string): string;
     getFormulaDirtyMap(unitId: string): Record<string, Record<string, boolean>>;

package/lib/types/services/runtime.service.d.ts

@@ -78,6 +78,7 @@ export interface IFormulaRuntimeService {
     reset(): void;
     setCurrent(row: number, column: number, rowCount: number, columnCount: number, sheetId: string, unitId: string): void;
     setFunctionRefInfoOverride(rowCount: number, columnCount: number): () => void;
+    hasFunctionRefInfoOverride(): boolean;
     registerFunctionDefinitionPrivacyVar(lambdaId: string, lambdaVar: Map<string, Nullable<BaseAstNode>>): void;
     getFunctionDefinitionPrivacyVar(lambdaId: string): Nullable<Map<string, Nullable<BaseAstNode>>>;
     setRuntimeData(functionVariant: FunctionVariantType): void;
@@ -187,6 +188,7 @@ export declare class FormulaRuntimeService extends Disposable implements IFormul
     clearReferenceAndNumberformatCache(): void;
     setCurrent(row: number, column: number, rowCount: number, columnCount: number, sheetId: string, unitId: string): void;
     setFunctionRefInfoOverride(rowCount: number, columnCount: number): () => void;
+    hasFunctionRefInfoOverride(): boolean;
     clearFunctionDefinitionPrivacyVar(): void;
     registerFunctionDefinitionPrivacyVar(lambdaId: string, lambdaVar: Map<string, Nullable<BaseAstNode>>): void;
     getFunctionDefinitionPrivacyVar(lambdaId: string): Nullable<Map<string, Nullable<BaseAstNode>>>;