@odoo/o-spreadsheet 19.1.0-alpha.10 → 19.1.0-alpha.11

package/dist/o-spreadsheet-engine.esm.js

@@ -3,8 +3,8 @@
  * This file is generated by o-spreadsheet build tools. Do not edit it.
  * @see https://github.com/odoo/o-spreadsheet
  * @version 19.1.0-alpha.3
- * @date 2025-10-30T12:25:48.501Z
- * @hash d0b65e9
+ * @date 2025-11-03T12:33:46.742Z
+ * @hash d9230f3
  */
 
 class FunctionCodeBuilder {
@@ -177,13 +177,13 @@ function addMetaInfoFromArg(name, addDescr) {
     let optionalArg = 0;
     for (const arg of addDescr.args) {
         countArg++;
-        if (!arg.optional && !arg.repeating && !arg.default) {
+        if (!arg.optional && !arg.default) {
             minArg++;
         }
         if (arg.repeating) {
             repeatingArg++;
         }
-        if (arg.optional || arg.default) {
+        if ((arg.optional || arg.default) && !arg.repeating) {
             optionalArg++;
         }
     }
@@ -191,7 +191,7 @@ function addMetaInfoFromArg(name, addDescr) {
     descr.minArgRequired = minArg;
     descr.maxArgPossible = repeatingArg ? Infinity : countArg;
     descr.nbrArgRepeating = repeatingArg;
-    descr.nbrArgOptional = optionalArg;
+    descr.nbrOptionalNonRepeatingArgs = optionalArg;
     descr.hidden = addDescr.hidden || false;
     descr.name = name;
     return descr;
@@ -219,9 +219,9 @@ const cacheArgTargeting = {};
  * and rows representing the correspondence with the argument index.
  *
  * The tables are built based on the following conventions:
- * - `m`: Mandatory argument
- * - `o`: Optional argument
- * - `r`: Repeating argument
+ * - `m`: Mandatory argument (count as one argument)
+ * - `o`: Optional argument (count as zero or one argument)
+ * - `r`: Repeating argument (count as one or more arguments)
  *
  *
  * Configuration 1: (m, o) like the CEILING function
@@ -234,39 +234,39 @@ const cacheArgTargeting = {};
  *
  * Configuration 2: (m, m, m, r, r) like the SUMIFS function
  *
- * |   | 3 | 5 | 7    | 3 + 2n     |
- * |---|---|---|------|------------|
- * | m | 0 | 0 | 0    | 0          |
- * | m | 1 | 1 | 1    | 1          |
- * | m | 2 | 2 | 2    | 2          |
- * | r |   | 3 | 3, 5 | 3 + 2n     |
- * | r |   | 4 | 4, 6 | 3 + 2n + 1 |
+ * |   | 5 | 7    | 3 + 2n     |
+ * |---|---|------|------------|
+ * | m | 0 | 0    | 0          |
+ * | m | 1 | 1    | 1          |
+ * | m | 2 | 2    | 2          |
+ * | r | 3 | 3, 5 | 3 + 2n     |
+ * | r | 4 | 4, 6 | 3 + 2n + 1 |
  *
  *
  * Configuration 3: (m, m, m, r, r, o) like the SWITCH function
  *
- * |   | 3 | 4 | 5 | 6 | 7    | 8    | 3 + 2n     | 3 + 2n + 1     |
- * |---|---|---|---|---|------|------|------------|----------------|
- * | m | 0 | 0 | 0 | 0 | 0    | 0    | 0          | 0              |
- * | m | 1 | 1 | 1 | 1 | 1    | 1    | 1          | 1              |
- * | m | 2 | 2 | 2 | 2 | 2    | 2    | 2          | 2              |
- * | r |   |   | 3 | 3 | 3, 5 | 3, 5 | 3 + 2n     | 3 + 2n         |
- * | r |   |   | 4 | 4 | 4, 6 | 4, 6 | 3 + 2n + 1 | 3 + 2n + 1     |
- * | o |   | 3 |   | 5 |      | 7    |            | 3 + 2N + 2     |
+ * |   | 5 | 6 | 7    | 8    | 3 + 2n     | 3 + 2n + 1     |
+ * |---|---|---|------|------|------------|----------------|
+ * | m | 0 | 0 | 0    | 0    | 0          | 0              |
+ * | m | 1 | 1 | 1    | 1    | 1          | 1              |
+ * | m | 2 | 2 | 2    | 2    | 2          | 2              |
+ * | r | 3 | 3 | 3, 5 | 3, 5 | 3 + 2n     | 3 + 2n         |
+ * | r | 4 | 4 | 4, 6 | 4, 6 | 3 + 2n + 1 | 3 + 2n + 1     |
+ * | o |   | 5 |      | 7    |            | 3 + 2N + 2     |
  *
  *
  * Configuration 4: (m, o, m, o, r, r, r, m) a complex case to understand subtleties
  *
- * |   | 3 | 4 | 5 | 6 | 7 | 8 | 9    | 10   | 11   | ... |
- * |---|---|---|---|---|---|---|------|------|------|-----|
- * | m | 0 | 0 | 0 | 0 | 0 | 0 | 0    | 0    | 0    | ... |
- * | o |   | 1 | 1 |   | 1 | 1 |      | 1    | 1    | ... |
- * | m | 1 | 2 | 2 | 1 | 2 | 2 | 1    | 2    | 2    | ... |
- * | o |   |   | 3 |   |   | 3 |      |      | 3    | ... |
- * | r |   |   |   | 2 | 3 | 4 | 2, 5 | 3, 6 | 4, 7 | ... |
- * | r |   |   |   | 3 | 4 | 5 | 3, 6 | 4, 7 | 5, 8 | ... |
- * | r |   |   |   | 4 | 5 | 6 | 4, 7 | 5, 8 | 6, 9 | ... |
- * | m | 2 | 3 | 4 | 5 | 6 | 7 | 8    | 9    | 10   | ... |
+ * |   | 6 | 7 | 8 | 9    | 10   | 11   | ... |
+ * |---|---|---|---|------|------|------|-----|
+ * | m | 0 | 0 | 0 | 0    | 0    | 0    | ... |
+ * | o |   | 1 | 1 |      | 1    | 1    | ... |
+ * | m | 1 | 2 | 2 | 1    | 2    | 2    | ... |
+ * | o |   |   | 3 |      |      | 3    | ... |
+ * | r | 2 | 3 | 4 | 2, 5 | 3, 6 | 4, 7 | ... |
+ * | r | 3 | 4 | 5 | 3, 6 | 4, 7 | 5, 8 | ... |
+ * | r | 4 | 5 | 6 | 4, 7 | 5, 8 | 6, 9 | ... |
+ * | m | 5 | 6 | 7 | 8    | 9    | 10   | ... |
  *
  */
 function argTargeting(functionDescription, nbrArgSupplied) {
@@ -285,30 +285,31 @@ function argTargeting(functionDescription, nbrArgSupplied) {
 }
 function _argTargeting(functionDescription, nbrArgSupplied) {
     const valueIndexToArgPosition = {};
-    const groupsOfRepeatingValues = functionDescription.nbrArgRepeating
+    const groupsOfOptionalRepeatingValues = functionDescription.nbrArgRepeating
         ? Math.floor((nbrArgSupplied - functionDescription.minArgRequired) / functionDescription.nbrArgRepeating)
         : 0;
-    const nbrValueRepeating = functionDescription.nbrArgRepeating * groupsOfRepeatingValues;
-    const nbrValueOptional = nbrArgSupplied - functionDescription.minArgRequired - nbrValueRepeating;
+    const nbrValueOptionalRepeating = functionDescription.nbrArgRepeating * groupsOfOptionalRepeatingValues;
+    const nbrValueOptional = nbrArgSupplied - functionDescription.minArgRequired - nbrValueOptionalRepeating;
     let countValueSupplied = 0;
     let countValueOptional = 0;
     for (let i = 0; i < functionDescription.args.length; i++) {
         const arg = functionDescription.args[i];
-        if (arg.optional || arg.default) {
+        if ((arg.optional || arg.default) && !arg.repeating) {
             if (countValueOptional < nbrValueOptional) {
-                valueIndexToArgPosition[countValueSupplied] = i;
+                valueIndexToArgPosition[countValueSupplied] = { index: i };
                 countValueSupplied++;
             }
             countValueOptional++;
             continue;
         }
         if (arg.repeating) {
+            const groupOfMandatoryRepeatingValues = arg.optional ? 0 : 1;
             // As we know all repeating arguments are consecutive,
             // --> we will treat all repeating arguments in one go
             // --> the index i will be incremented by the number of repeating values at the end of the loop
-            for (let j = 0; j < groupsOfRepeatingValues; j++) {
+            for (let j = 0; j < groupsOfOptionalRepeatingValues + groupOfMandatoryRepeatingValues; j++) {
                 for (let k = 0; k < functionDescription.nbrArgRepeating; k++) {
-                    valueIndexToArgPosition[countValueSupplied] = i + k;
+                    valueIndexToArgPosition[countValueSupplied] = { index: i + k, repeatingGroupIndex: j };
                     countValueSupplied++;
                 }
             }
@@ -316,7 +317,7 @@ function _argTargeting(functionDescription, nbrArgSupplied) {
             continue;
         }
         // End case: it's a required argument
-        valueIndexToArgPosition[countValueSupplied] = i;
+        valueIndexToArgPosition[countValueSupplied] = { index: i };
         countValueSupplied++;
     }
     return (argPosition) => {
@@ -328,7 +329,7 @@ function _argTargeting(functionDescription, nbrArgSupplied) {
 //------------------------------------------------------------------------------
 const META_TYPES = ["META", "RANGE<META>"];
 function validateArguments(descr) {
-    if (descr.nbrArgRepeating && descr.nbrArgOptional >= descr.nbrArgRepeating) {
+    if (descr.nbrArgRepeating && descr.nbrOptionalNonRepeatingArgs >= descr.nbrArgRepeating) {
         throw new Error(`Function ${descr.name} has more optional arguments than repeatable ones.`);
     }
     let foundRepeating = false;
@@ -612,6 +613,7 @@ const COLOR_PICKER_DEFAULTS = [
 ];
 const DEFAULT_CELL_WIDTH = 96;
 const DEFAULT_CELL_HEIGHT = 23;
+const SCROLLBAR_WIDTH = 15;
 const MIN_CF_ICON_MARGIN = 4;
 const MIN_CELL_TEXT_MARGIN = 4;
 const PADDING_AUTORESIZE_VERTICAL = 3;
@@ -2854,7 +2856,7 @@ function createComputeFunction(descr) {
         const getArgToFocus = argTargeting(descr, args.length);
         //#region Compute vectorisation limits
         for (let i = 0; i < args.length; i++) {
-            const argIndex = getArgToFocus(i) ?? -1;
+            const argIndex = getArgToFocus(i).index ?? -1;
             const argDefinition = descr.args[argIndex];
             const arg = args[i];
             if (!isMatrix(arg) && argDefinition.acceptMatrixOnly) {
@@ -2868,7 +2870,7 @@ function createComputeFunction(descr) {
         for (let i = 0; i < args.length; i++) {
             const arg = args[i];
             const getArgToFocus = argTargeting(descr, args.length);
-            const argDefinition = descr.args[getArgToFocus(i) || i];
+            const argDefinition = descr.args[getArgToFocus(i).index ?? i];
             // Early exit if the argument is an error and the function does not accept errors
             // We only check scalar arguments, not matrix arguments for performance reasons.
             // Casting helpers are responsible for handling errors in matrix arguments.
@@ -3136,8 +3138,7 @@ const CHOOSECOLS = {
     description: _t("Creates a new array from the selected columns in the existing range."),
     args: [
         arg("array (any, range<any>)", _t("The array that contains the columns to be returned.")),
-        arg("col_num (number, range<number>)", _t("The first column index of the columns to be returned.")),
-        arg("col_num2 (number, range<number>, repeating)", _t("The columns indexes of the columns to be returned.")),
+        arg("col_num (number, range<number>, repeating)", _t("The column index of the column to be returned.")),
     ],
     compute: function (array, ...columns) {
         const _array = toMatrix(array);
@@ -3166,8 +3167,7 @@ const CHOOSEROWS = {
     description: _t("Creates a new array from the selected rows in the existing range."),
     args: [
         arg("array (any, range<any>)", _t("The array that contains the rows to be returned.")),
-        arg("row_num (number, range<number>)", _t("The first row index of the rows to be returned.")),
-        arg("row_num2 (number, range<number>, repeating)", _t("The rows indexes of the rows to be returned.")),
+        arg("row_num (number, range<number>, repeating)", _t("The row index of the row to be returned.")),
     ],
     compute: function (array, ...rows) {
         const _array = toMatrix(array);
@@ -3217,10 +3217,7 @@ const EXPAND = {
 // -----------------------------------------------------------------------------
 const FLATTEN = {
     description: _t("Flattens all the values from one or more ranges into a single column."),
-    args: [
-        arg("range (any, range<any>)", _t("The first range to flatten.")),
-        arg("range2 (any, range<any>, repeating)", _t("Additional ranges to flatten.")),
-    ],
+    args: [arg("range (any, range<any>, repeating)", _t("The range to flatten."))],
     compute: function (...ranges) {
         return [flattenRowFirst(ranges, (val) => (val === undefined ? { value: "" } : val))];
     },
@@ -3278,10 +3275,7 @@ const FREQUENCY = {
 // -----------------------------------------------------------------------------
 const HSTACK = {
     description: _t("Appends ranges horizontally and in sequence to return a larger array."),
-    args: [
-        arg("range1 (any, range<any>)", _t("The first range to be appended.")),
-        arg("range2 (any, range<any>, repeating)", _t("Additional ranges to add to range1.")),
-    ],
+    args: [arg("range (any, range<any>, repeating)", _t("The range to be appended."))],
     compute: function (...ranges) {
         const nbRows = Math.max(...ranges.map((r) => r?.[0]?.length ?? 0));
         const result = [];
@@ -3367,8 +3361,7 @@ const MMULT = {
 const SUMPRODUCT = {
     description: _t("Calculates the sum of the products of corresponding entries in equal-sized ranges."),
     args: [
-        arg("range1 (number, range<number>)", _t("The first range whose entries will be multiplied with corresponding entries in the other ranges.")),
-        arg("range2 (number, range<number>, repeating)", _t("The other range whose entries will be multiplied with corresponding entries in the other ranges.")),
+        arg("range (number, range<number>, repeating)", _t("The range whose entries will be multiplied with corresponding entries in the other range.")),
     ],
     compute: function (...args) {
         if (!areSameDimensions(...args)) {
@@ -3554,10 +3547,7 @@ const TRANSPOSE = {
 // -----------------------------------------------------------------------------
 const VSTACK = {
     description: _t("Appends ranges vertically and in sequence to return a larger array."),
-    args: [
-        arg("range1 (any, range<any>)", _t("The first range to be appended.")),
-        arg("range2 (any, range<any>, repeating)", _t("Additional ranges to add to range1.")),
-    ],
+    args: [arg("range (any, range<any>, repeating)", _t("The range to be appended."))],
     compute: function (...ranges) {
         const nbColumns = Math.max(...ranges.map((range) => toMatrix(range).length));
         const nbRows = ranges.reduce((acc, range) => acc + toMatrix(range)[0].length, 0);
@@ -6152,6 +6142,7 @@ const readonlyAllowedCommands = new Set([
     "COPY",
     "RESIZE_SHEETVIEW",
     "SET_VIEWPORT_OFFSET",
+    "SET_ZOOM",
     "EVALUATE_CELLS",
     "EVALUATE_CHARTS",
     "SET_FORMULA_VISIBILITY",
@@ -6867,8 +6858,7 @@ const COTH = {
 const COUNTBLANK = {
     description: _t("Number of empty values."),
     args: [
-        arg("value1 (any, range)", _t("The first value or range in which to count the number of blanks.")),
-        arg("value2 (any, range, repeating)", _t("Additional values or ranges in which to count the number of blanks.")),
+        arg("value (any, range, repeating)", _t("Value or range in which to count the number of blanks.")),
     ],
     compute: function (...args) {
         return reduceAny(args, (acc, a) => {
@@ -6910,10 +6900,8 @@ const COUNTIF = {
 const COUNTIFS = {
     description: _t("Count values depending on multiple criteria."),
     args: [
-        arg("criteria_range1 (range)", _t("The range to check against criterion1.")),
-        arg("criterion1 (string)", _t("The pattern or test to apply to criteria_range1.")),
-        arg("criteria_range2 (any, range, repeating)", _t("Additional ranges over which to evaluate the additional criteria. The filtered set will be the intersection of the sets produced by each criterion-range pair.")),
-        arg("criterion2 (string, repeating)", _t("Additional criteria to check.")),
+        arg("criteria_range (any, range, repeating)", _t("Range over which to evaluate criteria.")),
+        arg("criterion (string, repeating)", _t("Criteria to check.")),
     ],
     compute: function (...args) {
         let count = 0;
@@ -6929,10 +6917,7 @@ const COUNTIFS = {
 // -----------------------------------------------------------------------------
 const COUNTUNIQUE = {
     description: _t("Counts number of unique values in a range."),
-    args: [
-        arg("value1 (any, range)", _t("The first value or range to consider for uniqueness.")),
-        arg("value2 (any, range, repeating)", _t("Additional values or ranges to consider for uniqueness.")),
-    ],
+    args: [arg("value (any, range, repeating)", _t("Value or range to consider for uniqueness."))],
     compute: function (...args) {
         return countUnique(args);
     },
@@ -6944,10 +6929,8 @@ const COUNTUNIQUEIFS = {
     description: _t("Counts number of unique values in a range, filtered by a set of criteria."),
     args: [
         arg("range (range)", _t("The range of cells from which the number of unique values will be counted.")),
-        arg("criteria_range1 (range)", _t("The range of cells over which to evaluate criterion1.")),
-        arg("criterion1 (string)", _t("The pattern or test to apply to criteria_range1, such that each cell that evaluates to TRUE will be included in the filtered set.")),
-        arg("criteria_range2 (any, range, repeating)", _t("Additional ranges over which to evaluate the additional criteria. The filtered set will be the intersection of the sets produced by each criterion-range pair.")),
-        arg("criterion2 (string, repeating)", _t("The pattern or test to apply to criteria_range2.")),
+        arg("criteria_range (any, range, repeating)", _t("Range over which to evaluate criteria.")),
+        arg("criterion (string, repeating)", _t("Criteria to check.")),
     ],
     compute: function (range, ...args) {
         const uniqueValues = new Set();
@@ -7303,8 +7286,7 @@ const POWER = {
 const PRODUCT = {
     description: _t("Result of multiplying a series of numbers together."),
     args: [
-        arg("factor1 (number, range<number>)", _t("The first number or range to calculate for the product.")),
-        arg("factor2 (number, range<number>, repeating)", _t("More numbers or ranges to calculate for the product.")),
+        arg("factor (number, range<number>, repeating)", _t("Number or range to calculate for the product.")),
     ],
     compute: function (...factors) {
         let count = 0;
@@ -7636,8 +7618,7 @@ const SUBTOTAL = {
             ...subtotalFunctionOptionsIncludeHiddenRows,
             ...subtotalFunctionOptionsExcludeHiddenRows,
         ]),
-        arg("ref1 (meta, range<meta>)", _t("The range or reference for which you want the subtotal.")),
-        arg("ref2 (meta, range<meta>, repeating)", _t("Additional ranges or references for which you want the subtotal.")),
+        arg("ref (meta, range<meta>, repeating)", _t("Range or reference for which you want the subtotal.")),
     ],
     compute: function (functionCode, ...refs) {
         let code = toInteger(functionCode, this.locale);
@@ -7681,10 +7662,7 @@ const SUBTOTAL = {
 // -----------------------------------------------------------------------------
 const SUM = {
     description: _t("Sum of a series of numbers and/or cells."),
-    args: [
-        arg("value1 (number, range<number>)", _t("The first number or range to add together.")),
-        arg("value2 (number, range<number>, repeating)", _t("Additional numbers or ranges to add to value1.")),
-    ],
+    args: [arg("value (number, range<number>, repeating)", _t("Number or range to add together."))],
     compute: function (...values) {
         const v1 = values[0];
         return {
@@ -7726,10 +7704,8 @@ const SUMIFS = {
     description: _t("Sums a range depending on multiple criteria."),
     args: [
         arg("sum_range (range)", _t("The range to sum.")),
-        arg("criteria_range1 (range)", _t("The range to check against criterion1.")),
-        arg("criterion1 (string)", _t("The pattern or test to apply to criteria_range1.")),
-        arg("criteria_range2 (any, range, repeating)", _t("Additional ranges to check.")),
-        arg("criterion2 (string, repeating)", _t("Additional criteria to check.")),
+        arg("criteria_range (any, range, repeating)", _t("Range to check.")),
+        arg("criterion (string, repeating)", _t("Criteria to check.")),
     ],
     compute: function (sumRange, ...criters) {
         let sum = 0;
@@ -8196,8 +8172,7 @@ function centile(data, percent, isInclusive, locale) {
 const AVEDEV = {
     description: _t("Average magnitude of deviations from mean."),
     args: [
-        arg("value1 (number, range<number>)", _t("The first value or range of the sample.")),
-        arg("value2 (number, range<number>, repeating)", _t("Additional values or ranges to include in the sample.")),
+        arg("value (number, range<number>, repeating)", _t("Value or range to include in the sample.")),
     ],
     compute: function (...values) {
         let count = 0;
@@ -8219,8 +8194,7 @@ const AVEDEV = {
 const AVERAGE = {
     description: _t("Numerical average value in a dataset, ignoring text."),
     args: [
-        arg("value1 (number, range<number>)", _t("The first value or range to consider when calculating the average value.")),
-        arg("value2 (number, range<number>, repeating)", _t("Additional values or ranges to consider when calculating the average value.")),
+        arg("value (number, range<number>, repeating)", _t("Value or range to consider when calculating the average value.")),
     ],
     compute: function (...values) {
         return {
@@ -8238,10 +8212,8 @@ const negativeWeightError = _t("[[FUNCTION_NAME]] expects the weight to be posit
 const AVERAGE_WEIGHTED = {
     description: _t("Weighted average."),
     args: [
-        arg("values (number, range<number>)", _t("Values to average.")),
-        arg("weights (number, range<number>)", _t("Weights for each corresponding value.")),
-        arg("additional_values (number, range<number>, repeating)", _t("Additional values to average.")),
-        arg("additional_weights (number, range<number>, repeating)", _t("Additional weights.")),
+        arg("values (number, range<number>, repeating)", _t("Value to average.")),
+        arg("weights (number, range<number>, repeating)", _t("Weight for each corresponding value.")),
     ],
     compute: function (...args) {
         let sum = 0;
@@ -8297,8 +8269,7 @@ const AVERAGE_WEIGHTED = {
 const AVERAGEA = {
     description: _t("Numerical average value in a dataset."),
     args: [
-        arg("value1 (number, range<number>)", _t("The first value or range to consider when calculating the average value.")),
-        arg("value2 (number, range<number>, repeating)", _t("Additional values or ranges to consider when calculating the average value.")),
+        arg("value (number, range<number>, repeating)", _t("Value or range to consider when calculating the average value.")),
     ],
     compute: function (...args) {
         let count = 0;
@@ -8351,10 +8322,8 @@ const AVERAGEIFS = {
     description: _t("Average of values depending on multiple criteria."),
     args: [
         arg("average_range (range)", _t("The range to average.")),
-        arg("criteria_range1 (range)", _t("The range to check against criterion1.")),
-        arg("criterion1 (string)", _t("The pattern or test to apply to criteria_range1.")),
-        arg("criteria_range2 (any, range, repeating)", _t("Additional criteria_range and criterion to check.")),
-        arg("criterion2 (string, repeating)", _t("The pattern or test to apply to criteria_range2.")),
+        arg("criteria_range (any, range, repeating)", _t("Range to check.")),
+        arg("criterion (string, repeating)", _t("Criterion to check.")),
     ],
     compute: function (averageRange, ...args) {
         const _averageRange = toMatrix(averageRange);
@@ -8380,8 +8349,7 @@ const AVERAGEIFS = {
 const COUNT = {
     description: _t("The number of numeric values in dataset."),
     args: [
-        arg("value1 (number, any, range<number>)", _t("The first value or range to consider when counting.")),
-        arg("value2 (number, any, range<number>, repeating)", _t("Additional values or ranges to consider when counting.")),
+        arg("value (number, any, range<number>, repeating)", _t("Value or range to consider when counting.")),
     ],
     compute: function (...values) {
         return countNumbers(values, this.locale);
@@ -8393,10 +8361,7 @@ const COUNT = {
 // -----------------------------------------------------------------------------
 const COUNTA = {
     description: _t("The number of values in a dataset."),
-    args: [
-        arg("value1 (any, range)", _t("The first value or range to consider when counting.")),
-        arg("value2 (any, range, repeating)", _t("Additional values or ranges to consider when counting.")),
-    ],
+    args: [arg("value (any, range, repeating)", _t("Value or range to consider when counting."))],
     compute: function (...values) {
         return countAny(values);
     },
@@ -8629,8 +8594,7 @@ const MATTHEWS = {
 const MAX = {
     description: _t("Maximum value in a numeric dataset."),
     args: [
-        arg("value1 (number, range<number>)", _t("The first value or range to consider when calculating the maximum value.")),
-        arg("value2 (number, range<number>, repeating)", _t("Additional values or ranges to consider when calculating the maximum value.")),
+        arg("value (number, range<number>, repeating)", _t("Value or range to consider when calculating the maximum value.")),
     ],
     compute: function (...values) {
         return max(values, this.locale);
@@ -8643,8 +8607,7 @@ const MAX = {
 const MAXA = {
     description: _t("Maximum numeric value in a dataset."),
     args: [
-        arg("value1 (any, range)", _t("The first value or range to consider when calculating the maximum value.")),
-        arg("value2 (any, range, repeating)", _t("Additional values or ranges to consider when calculating the maximum value.")),
+        arg("value (any, range, repeating)", _t("Value or range to consider when calculating the maximum value.")),
     ],
     compute: function (...args) {
         const maxa = reduceNumbersTextAs0(args, (acc, a) => {
@@ -8661,10 +8624,8 @@ const MAXIFS = {
     description: _t("Returns the maximum value in a range of cells, filtered by a set of criteria."),
     args: [
         arg("range (range)", _t("The range of cells from which the maximum will be determined.")),
-        arg("criteria_range1 (range)", _t("The range of cells over which to evaluate criterion1.")),
-        arg("criterion1 (string)", _t("The pattern or test to apply to criteria_range1, such that each cell that evaluates to TRUE will be included in the filtered set.")),
-        arg("criteria_range2 (any, range, repeating)", _t("Additional ranges over which to evaluate the additional criteria. The filtered set will be the intersection of the sets produced by each criterion-range pair.")),
-        arg("criterion2 (string, repeating)", _t("The pattern or test to apply to criteria_range2.")),
+        arg("criteria_range (any, range, repeating)", _t("Range to evaluate criteria.")),
+        arg("criterion (string, repeating)", _t("Criteria to check.")),
     ],
     compute: function (range, ...args) {
         let result = -Infinity;
@@ -8684,8 +8645,7 @@ const MAXIFS = {
 const MEDIAN = {
     description: _t("Median value in a numeric dataset."),
     args: [
-        arg("value1 (any, range)", _t("The first value or range to consider when calculating the median value.")),
-        arg("value2 (any, range, repeating)", _t("Additional values or ranges to consider when calculating the median value.")),
+        arg("value (any, range, repeating)", _t("Value or range to consider when calculating the median value.")),
     ],
     compute: function (...values) {
         const data = [];
@@ -8705,8 +8665,7 @@ const MEDIAN = {
 const MIN = {
     description: _t("Minimum value in a numeric dataset."),
     args: [
-        arg("value1 (number, range<number>)", _t("The first value or range to consider when calculating the minimum value.")),
-        arg("value2 (number, range<number>, repeating)", _t("Additional values or ranges to consider when calculating the minimum value.")),
+        arg("value (number, range<number>, repeating)", _t("Value or range to consider when calculating the minimum value.")),
     ],
     compute: function (...values) {
         return min(values, this.locale);
@@ -8719,8 +8678,7 @@ const MIN = {
 const MINA = {
     description: _t("Minimum numeric value in a dataset."),
     args: [
-        arg("value1 (number, range<number>)", _t("The first value or range to consider when calculating the minimum value.")),
-        arg("value2 (number, range<number>, repeating)", _t("Additional values or ranges to consider when calculating the minimum value.")),
+        arg("value (number, range<number>, repeating)", _t("Value or range to consider when calculating the minimum value.")),
     ],
     compute: function (...args) {
         const mina = reduceNumbersTextAs0(args, (acc, a) => {
@@ -8737,10 +8695,8 @@ const MINIFS = {
     description: _t("Returns the minimum value in a range of cells, filtered by a set of criteria."),
     args: [
         arg("range (range)", _t("The range of cells from which the minimum will be determined.")),
-        arg("criteria_range1 (range)", _t("The range of cells over which to evaluate criterion1.")),
-        arg("criterion1 (string)", _t("The pattern or test to apply to criteria_range1, such that each cell that evaluates to TRUE will be included in the filtered set.")),
-        arg("criteria_range2 (any, range, repeating)", _t("Additional ranges over which to evaluate the additional criteria. The filtered set will be the intersection of the sets produced by each criterion-range pair.")),
-        arg("criterion2 (string, repeating)", _t("The pattern or test to apply to criteria_range2.")),
+        arg("criteria_range (any, range, repeating)", _t("Range to evaluate criteria.")),
+        arg("criterion (string, repeating)", _t("Criterion to check.")),
     ],
     compute: function (range, ...args) {
         let result = Infinity;
@@ -9081,8 +9037,7 @@ const SPEARMAN = {
 const STDEV = {
     description: _t("Standard deviation."),
     args: [
-        arg("value1 (number, range<number>)", _t("The first value or range of the sample.")),
-        arg("value2 (number, range<number>, repeating)", _t("Additional values or ranges to include in the sample.")),
+        arg("value (number, range<number>, repeating)", _t("Value or range to include in the sample.")),
     ],
     compute: function (...args) {
         return Math.sqrt(VAR.compute.bind(this)(...args));
@@ -9095,8 +9050,7 @@ const STDEV = {
 const STDEV_P = {
     description: _t("Standard deviation of entire population."),
     args: [
-        arg("value1 (number, range<number>)", _t("The first value or range of the population.")),
-        arg("value2 (number, range<number>, repeating)", _t("Additional values or ranges to include in the population.")),
+        arg("value (number, range<number>, repeating)", _t("Value or range to include in the population.")),
     ],
     compute: function (...args) {
         return Math.sqrt(VAR_P.compute.bind(this)(...args));
@@ -9109,8 +9063,7 @@ const STDEV_P = {
 const STDEV_S = {
     description: _t("Standard deviation."),
     args: [
-        arg("value1 (number, range<number>)", _t("The first value or range of the sample.")),
-        arg("value2 (number, range<number>, repeating)", _t("Additional values or ranges to include in the sample.")),
+        arg("value (number, range<number>, repeating)", _t("Value or range to include in the sample.")),
     ],
     compute: function (...args) {
         return Math.sqrt(VAR_S.compute.bind(this)(...args));
@@ -9123,8 +9076,7 @@ const STDEV_S = {
 const STDEVA = {
     description: _t("Standard deviation of sample (text as 0)."),
     args: [
-        arg("value1 (number, range<number>)", _t("The first value or range of the sample.")),
-        arg("value2 (number, range<number>, repeating)", _t("Additional values or ranges to include in the sample.")),
+        arg("value (number, range<number>, repeating)", _t("Value or range to include in the sample.")),
     ],
     compute: function (...args) {
         return Math.sqrt(VARA.compute.bind(this)(...args));
@@ -9137,8 +9089,7 @@ const STDEVA = {
 const STDEVP = {
     description: _t("Standard deviation of entire population."),
     args: [
-        arg("value1 (number, range<number>)", _t("The first value or range of the population.")),
-        arg("value2 (number, range<number>, repeating)", _t("Additional values or ranges to include in the population.")),
+        arg("value (number, range<number>, repeating)", _t("Value or range to include in the population.")),
     ],
     compute: function (...args) {
         return Math.sqrt(VARP.compute.bind(this)(...args));
@@ -9151,8 +9102,7 @@ const STDEVP = {
 const STDEVPA = {
     description: _t("Standard deviation of entire population (text as 0)."),
     args: [
-        arg("value1 (number, range<number>)", _t("The first value or range of the population.")),
-        arg("value2 (number, range<number>, repeating)", _t("Additional values or ranges to include in the population.")),
+        arg("value (number, range<number>, repeating)", _t("Value or range to include in the population.")),
     ],
     compute: function (...args) {
         return Math.sqrt(VARPA.compute.bind(this)(...args));
@@ -9202,8 +9152,7 @@ const TREND = {
 const VAR = {
     description: _t("Variance."),
     args: [
-        arg("value1 (number, range<number>)", _t("The first value or range of the sample.")),
-        arg("value2 (number, range<number>, repeating)", _t("Additional values or ranges to include in the sample.")),
+        arg("value (number, range<number>, repeating)", _t("Value or range to include in the sample.")),
     ],
     compute: function (...args) {
         return variance(args, true, false, this.locale);
@@ -9216,8 +9165,7 @@ const VAR = {
 const VAR_P = {
     description: _t("Variance of entire population."),
     args: [
-        arg("value1 (number, range<number>)", _t("The first value or range of the population.")),
-        arg("value2 (number, range<number>, repeating)", _t("Additional values or ranges to include in the population.")),
+        arg("value (number, range<number>, repeating)", _t("Value or range to include in the population.")),
     ],
     compute: function (...args) {
         return variance(args, false, false, this.locale);
@@ -9230,8 +9178,7 @@ const VAR_P = {
 const VAR_S = {
     description: _t("Variance."),
     args: [
-        arg("value1 (number, range<number>)", _t("The first value or range of the sample.")),
-        arg("value2 (number, range<number>, repeating)", _t("Additional values or ranges to include in the sample.")),
+        arg("value (number, range<number>, repeating)", _t("Value or range to include in the sample.")),
     ],
     compute: function (...args) {
         return variance(args, true, false, this.locale);
@@ -9244,8 +9191,7 @@ const VAR_S = {
 const VARA = {
     description: _t("Variance of sample (text as 0)."),
     args: [
-        arg("value1 (number, range<number>)", _t("The first value or range of the sample.")),
-        arg("value2 (number, range<number>, repeating)", _t("Additional values or ranges to include in the sample.")),
+        arg("value (number, range<number>, repeating)", _t("Value or range to include in the sample.")),
     ],
     compute: function (...args) {
         return variance(args, true, true, this.locale);
@@ -9258,8 +9204,7 @@ const VARA = {
 const VARP = {
     description: _t("Variance of entire population."),
     args: [
-        arg("value1 (number, range<number>)", _t("The first value or range of the population.")),
-        arg("value2 (number, range<number>, repeating)", _t("Additional values or ranges to include in the population.")),
+        arg("value (number, range<number>, repeating)", _t("Value or range to include in the population.")),
     ],
     compute: function (...args) {
         return variance(args, false, false, this.locale);
@@ -9272,8 +9217,7 @@ const VARP = {
 const VARPA = {
     description: _t("Variance of entire population (text as 0)."),
     args: [
-        arg("value1 (number, range<number>)", _t("The first value or range of the population.")),
-        arg("value2 (number, range<number>, repeating)", _t("Additional values or ranges to include in the population.")),
+        arg("value (number, range<number>, repeating)", _t("Value or range to include in the population.")),
     ],
     compute: function (...args) {
         return variance(args, false, true, this.locale);
@@ -11076,8 +11020,7 @@ const FILTER = {
     // TODO modify args description when vectorization on formulas is available
     args: [
         arg("range (any, range<any>)", _t("The data to be filtered.")),
-        arg("condition1 (boolean, range<boolean>)", _t("A column or row containing true or false values corresponding to the first column or row of range.")),
-        arg("condition2 (boolean, range<boolean>, repeating)", _t("Additional column or row containing true or false values.")),
+        arg("condition (boolean, range<boolean>, repeating)", _t("Column or row containing true or false values corresponding to the range.")),
     ],
     compute: function (range, ...conditions) {
         let _array = toMatrix(range);
@@ -11117,8 +11060,8 @@ const SORT = {
     description: _t("Sorts the rows of a given array or range by the values in one or more columns."),
     args: [
         arg("range (range)", _t("The data to be sorted.")),
-        arg("sort_column (any, range<number>, repeating)", _t("The index of the column in range or a range outside of range containing the values by which to sort.")),
-        arg("is_ascending (boolean, repeating)", _t("TRUE or FALSE indicating whether to sort sort_column in ascending order."), [
+        arg("sort_column (any, range<number>, repeating, optional)", _t("The index of the column in range or a range outside of range containing the value by which to sort.")),
+        arg("is_ascending (boolean, repeating, optional)", _t("TRUE or FALSE indicating whether to sort sort_column in ascending order. FALSE sorts in descending order."), [
             { value: true, label: _t("Ascending") },
             { value: false, label: _t("Descending") },
         ]),
@@ -11138,8 +11081,8 @@ const SORTN = {
         arg("range (range)", _t("The data to be sorted.")),
         arg("n (number)", _t("The number of items to return.")),
         arg("display_ties_mode (number, default=0)", _t("A number representing the way to display ties.")),
-        arg("sort_column (number, range<number>, repeating)", _t("The index of the column in range or a range outside of range containing the values by which to sort.")),
-        arg("is_ascending (boolean, repeating)", _t("TRUE or FALSE indicating whether to sort sort_column in ascending order."), [
+        arg("sort_column (number, range<number>, repeating, optional)", _t("The index of the column in range or a range outside of range containing the value by which to sort.")),
+        arg("is_ascending (boolean, repeating, optional)", _t("TRUE or FALSE indicating whether to sort sort_column in ascending order. FALSE sorts in descending order."), [
             { value: true, label: _t("Ascending") },
             { value: false, label: _t("Descending") },
         ]),
@@ -12407,8 +12350,7 @@ const NPV = {
     description: _t("The net present value of an investment based on a series of periodic cash flows and a discount rate."),
     args: [
         arg("discount (number)", _t("The discount rate of the investment over one period.")),
-        arg("cashflow1 (number, range<number>)", _t("The first future cash flow.")),
-        arg("cashflow2 (number, range<number>, repeating)", _t("Additional future cash flows.")),
+        arg("cashflow (number, range<number>, repeating)", _t("The future cash flows.")),
     ],
     // to do: replace by dollar format
     compute: function (discount, ...values) {
@@ -13763,8 +13705,7 @@ function boolOr(args) {
 const AND = {
     description: _t("Logical `and` operator."),
     args: [
-        arg("logical_expression1 (boolean, range<boolean>)", _t("An expression or reference to a cell containing an expression that represents some logical value, i.e. TRUE or FALSE, or an expression that can be coerced to a logical value.")),
-        arg("logical_expression2 (boolean, range<boolean>, repeating)", _t("More expressions that represent logical values.")),
+        arg("logical_expression (boolean, range<boolean>, repeating)", _t("Expression or reference to a cell containing a logical value (TRUE/FALSE) or an expression that can be coerced to a logical value.")),
     ],
     compute: function (...logicalExpressions) {
         const { result, foundBoolean } = boolAnd(logicalExpressions);
@@ -13847,10 +13788,8 @@ const IFNA = {
 const IFS = {
     description: _t("Returns a value depending on multiple logical expressions."),
     args: [
-        arg("condition1 (boolean, range<boolean>)", _t("The first condition to be evaluated. This can be a boolean, a number, an array, or a reference to any of those.")),
-        arg("value1 (any, range)", _t("The returned value if condition1 is TRUE.")),
-        arg("condition2 (boolean, any, range, repeating)", _t("Additional conditions to be evaluated if the previous ones are FALSE.")),
-        arg("value2 (any, range, repeating)", _t("Additional values to be returned if their corresponding conditions are TRUE.")),
+        arg("condition (any, range, repeating)", _t("The condition to be evaluated. It can be a boolean, a number, an array, or a reference to any of those.")),
+        arg("value (any, range, repeating)", _t("The value to be returned if its corresponding condition is TRUE.")),
     ],
     compute: function (...values) {
         if (values.length % 2 !== 0) {
@@ -13889,8 +13828,7 @@ const NOT = {
 const OR = {
     description: _t("Logical `or` operator."),
     args: [
-        arg("logical_expression1 (boolean, range<boolean>)", _t("An expression or reference to a cell containing an expression that represents some logical value, i.e. TRUE or FALSE, or an expression that can be coerced to a logical value.")),
-        arg("logical_expression2 (boolean, range<boolean>, repeating)", _t("More expressions that evaluate to logical values.")),
+        arg("logical_expression (boolean, range<boolean>, repeating)", _t("Expression or reference to a cell containing a logical value (TRUE/FALSE) or an expression that can be coerced to a logical value.")),
     ],
     compute: function (...logicalExpressions) {
         const { result, foundBoolean } = boolOr(logicalExpressions);
@@ -13908,10 +13846,8 @@ const SWITCH = {
     description: _t("Returns a value by comparing cases to an expression."),
     args: [
         arg("expression (number, boolean, string)", _t("The value to be checked.")),
-        arg("case1 (number, boolean, string)", _t("The first case to be checked against expression.")),
-        arg("value1 (any)", _t("The corresponding value to be returned if case1 matches expression.")),
-        arg("case2 (any, repeating)", _t("Additional cases to try if the previous ones don't match expression.")),
-        arg("value2 (any, repeating)", _t("Additional values to be returned if their corresponding cases match expression.")),
+        arg("case (any, repeating)", _t("Case to be checked against expression.")),
+        arg("value (any, repeating)", _t("Value to be returned if its corresponding case matches expression.")),
         arg(`default (any, default="empty")`, _t("An optional default value to be returned if none of the cases match expression.")),
     ],
     compute: function (expression, ...casesAndValues) {
@@ -13946,8 +13882,7 @@ const TRUE = {
 const XOR = {
     description: _t("Logical `xor` operator."),
     args: [
-        arg("logical_expression1 (boolean, range<boolean>)", _t("An expression or reference to a cell containing an expression that represents some logical value, i.e. TRUE or FALSE, or an expression that can be coerced to a logical value.")),
-        arg("logical_expression2 (boolean, range<boolean>, repeating)", _t("More expressions that evaluate to logical values.")),
+        arg("logical_expression (boolean, range<boolean>, repeating)", _t("Expression or reference to a cell containing a logical value (TRUE/FALSE) or an expression that can be coerced to a logical value.")),
     ],
     compute: function (...logicalExpressions) {
         let foundBoolean = false;
@@ -15422,8 +15357,8 @@ const PIVOT_VALUE = {
     args: [
         arg("pivot_id (number,string)", _t("ID of the pivot.")),
         arg("measure_name (string)", _t("Name of the measure.")),
-        arg("domain_field_name (string,repeating)", _t("Field name.")),
-        arg("domain_value (number,string,boolean,repeating)", _t("Value.")),
+        arg("domain_field_name (string,repeating,optional)", _t("Field name.")),
+        arg("domain_value (number,string,boolean,repeating,optional)", _t("Value.")),
     ],
     compute: function (formulaId, measureName, ...domainArgs) {
         const _pivotFormulaId = toString(formulaId);
@@ -15458,8 +15393,8 @@ const PIVOT_HEADER = {
     description: _t("Get the header of a pivot."),
     args: [
         arg("pivot_id (number,string)", _t("ID of the pivot.")),
-        arg("domain_field_name (string,repeating)", _t("Field name.")),
-        arg("domain_value (number,string,value,repeating)", _t("Value.")),
+        arg("domain_field_name (string,repeating,optional)", _t("Field name.")),
+        arg("domain_value (number,string,value,repeating,optional)", _t("Value.")),
     ],
     compute: function (pivotId, ...domainArgs) {
         const _pivotFormulaId = toString(pivotId);
@@ -16330,10 +16265,7 @@ const CLEAN = {
 // -----------------------------------------------------------------------------
 const CONCATENATE = {
     description: _t("Appends strings to one another."),
-    args: [
-        arg("string1 (string, range<string>)", _t("The initial string.")),
-        arg("string2 (string, range<string>, repeating)", _t("More strings to append in sequence.")),
-    ],
+    args: [arg("string (string, range<string>, repeating)", _t("String to append in sequence."))],
     compute: function (...datas) {
         return reduceAny(datas, (acc, a) => acc + toString(a), "");
     },
@@ -16388,8 +16320,7 @@ const JOIN = {
     description: _t("Concatenates elements of arrays with delimiter."),
     args: [
         arg("delimiter (string)", _t("The character or string to place between each concatenated value.")),
-        arg("value_or_array1 (string, range<string>)", _t("The value or values to be appended using delimiter.")),
-        arg("value_or_array2 (string, range<string>, repeating)", _t("More values to be appended using delimiter.")),
+        arg("value_or_array (string, range<string>, repeating)", _t("Value to be appended using delimiter.")),
     ],
     compute: function (delimiter, ...valuesOrArrays) {
         const _delimiter = toString(delimiter);
@@ -16680,13 +16611,12 @@ const TEXTJOIN_DEFAULT_IGNORE_EMPTY = true;
 const TEXTJOIN = {
     description: _t("Combines text from multiple strings and/or arrays."),
     args: [
-        arg("delimiter (string)", _t(" A string, possible empty, or a reference to a valid string. If empty, the text will be simply concatenated.")),
+        arg("delimiter (string)", _t("A string, possible empty, or a reference to a valid string. If empty, the text will be simply concatenated.")),
         arg("ignore_empty (boolean)", _t("A boolean; if TRUE, empty cells selected in the text arguments won't be included in the result."), [
             { value: true, label: _t("Ignore empty cells") },
             { value: false, label: _t("Include empty cells (default)") },
         ]),
-        arg("text1 (string, range<string>)", _t("Any text item. This could be a string, or an array of strings in a range.")),
-        arg("text2 (string, range<string>, repeating)", _t("Additional text item(s).")),
+        arg("texts (string, range<string>, repeating)", _t("Text item to join.")),
     ],
     compute: function (delimiter, ignoreEmpty = { value: TEXTJOIN_DEFAULT_IGNORE_EMPTY }, ...textsOrArrays) {
         const _delimiter = toString(delimiter);
@@ -17559,7 +17489,7 @@ function compileTokensOrThrow(tokens) {
             const compiledArgs = [];
             const argToFocus = argTargeting(functionDefinition, args.length);
             for (let i = 0; i < args.length; i++) {
-                const argDefinition = functionDefinition.args[argToFocus(i) ?? -1];
+                const argDefinition = functionDefinition.args[argToFocus(i).index ?? -1];
                 const currentArg = args[i];
                 const argTypes = argDefinition.type || [];
                 // detect when an argument need to be evaluated as a meta argument
@@ -17738,12 +17668,15 @@ function assertEnoughArgs(ast) {
     }
     if (nbrArgRepeating > 1) {
         const nbrValueRepeating = nbrArgRepeating * Math.floor((nbrArgSupplied - minArgRequired) / nbrArgRepeating);
-        const nbrValueRemaining = nbrArgSupplied - minArgRequired - nbrValueRepeating - functionDefinition.nbrArgOptional;
+        const nbrValueRemaining = nbrArgSupplied -
+            minArgRequired -
+            nbrValueRepeating -
+            functionDefinition.nbrOptionalNonRepeatingArgs;
         if (nbrValueRemaining > 0) {
             throw new BadExpressionError(_t("Invalid number of arguments for the %(functionName)s function. Repeatable arguments should be supplied in groups of %(nbrArgRepeating)s, with up to %(nbrArgOptional)s optional. Got %(nbrValueRemaining)s too many.", {
                 functionName,
                 nbrArgRepeating,
-                nbrArgOptional: functionDefinition.nbrArgOptional,
+                nbrArgOptional: functionDefinition.nbrOptionalNonRepeatingArgs,
                 nbrValueRemaining,
             }));
         }
@@ -40492,6 +40425,7 @@ pivotRegistry.add("SPREADSHEET", {
     isMeasureCandidate: (field) => field.type !== "boolean",
     isGroupable: () => true,
     canHaveCustomGroup: (field) => field.type === "char" && !field.isCustomField,
+    isPivotUnused: () => true,
 });
 
 const UNDO_REDO_PIVOT_COMMANDS = ["ADD_PIVOT", "UPDATE_PIVOT", "REMOVE_PIVOT"];
@@ -40510,7 +40444,7 @@ class PivotUIPlugin extends CoreViewPlugin {
         "isSpillPivotFormula",
     ];
     pivots = {};
-    unusedPivots;
+    unusedPivotsInFormulas;
     custom;
     constructor(config) {
         super(config);
@@ -40550,12 +40484,12 @@ class PivotUIPlugin extends CoreViewPlugin {
             }
             case "DELETE_SHEET":
             case "UPDATE_CELL": {
-                this.unusedPivots = undefined;
+                this.unusedPivotsInFormulas = undefined;
                 break;
             }
             case "UNDO":
             case "REDO": {
-                this.unusedPivots = undefined;
+                this.unusedPivotsInFormulas = undefined;
                 const pivotCommands = cmd.commands.filter(isPivotCommand);
                 for (const cmd of pivotCommands) {
                     const pivotId = cmd.pivotId;
@@ -40714,7 +40648,9 @@ class PivotUIPlugin extends CoreViewPlugin {
         return this.pivots[pivotId];
     }
     isPivotUnused(pivotId) {
-        return this._getUnusedPivots().includes(pivotId);
+        const { type } = this.getters.getPivot(pivotId);
+        return (this._getUnusedPivotsInFormulas().includes(pivotId) &&
+            pivotRegistry.get(type).isPivotUnused(this.getters, pivotId));
     }
     getPivotCellSortDirection(position) {
         const pivotId = this.getters.getPivotIdFromPosition(position);
@@ -40750,9 +40686,9 @@ class PivotUIPlugin extends CoreViewPlugin {
             this.pivots[pivotId].onDefinitionChange(definition);
         }
     }
-    _getUnusedPivots() {
-        if (this.unusedPivots !== undefined) {
-            return this.unusedPivots;
+    _getUnusedPivotsInFormulas() {
+        if (this.unusedPivotsInFormulas !== undefined) {
+            return this.unusedPivotsInFormulas;
         }
         const unusedPivots = new Set(this.getters.getPivotIds());
         for (const sheetId of this.getters.getSheetIds()) {
@@ -40762,14 +40698,14 @@ class PivotUIPlugin extends CoreViewPlugin {
                 if (pivotId) {
                     unusedPivots.delete(pivotId);
                     if (!unusedPivots.size) {
-                        this.unusedPivots = [];
+                        this.unusedPivotsInFormulas = [];
                         return [];
                     }
                 }
             }
         }
-        this.unusedPivots = [...unusedPivots];
-        return this.unusedPivots;
+        this.unusedPivotsInFormulas = [...unusedPivots];
+        return this.unusedPivotsInFormulas;
     }
 }
 
@@ -46175,6 +46111,7 @@ class SheetViewPlugin extends UIPlugin {
         "getVisibleFigures",
         "getVisibleRect",
         "getVisibleRectWithoutHeaders",
+        "getVisibleRectWithZoom",
         "getVisibleCellPositions",
         "getColRowOffsetInViewport",
         "getMainViewportCoordinates",
@@ -46190,6 +46127,8 @@ class SheetViewPlugin extends UIPlugin {
         "getFigureUI",
         "getPositionAnchorOffset",
         "getGridOffset",
+        "getViewportZoomLevel",
+        "getScrollBarWidth",
     ];
     viewports = {};
     /**
@@ -46202,6 +46141,7 @@ class SheetViewPlugin extends UIPlugin {
     sheetViewHeight = getDefaultSheetViewSize();
     gridOffsetX = 0;
     gridOffsetY = 0;
+    zoomLevel = 1;
     sheetsWithDirtyViewports = new Set();
     shouldAdjustViewports = false;
     // ---------------------------------------------------------------------------
@@ -46268,6 +46208,9 @@ class SheetViewPlugin extends UIPlugin {
             case "SET_VIEWPORT_OFFSET":
                 this.setSheetViewOffset(cmd.offsetX, cmd.offsetY);
                 break;
+            case "SET_ZOOM":
+                this.zoomLevel = cmd.zoom || 1;
+                break;
             case "SHIFT_VIEWPORT_DOWN":
                 const sheetId = this.getters.getActiveSheetId();
                 const { top, viewportHeight, offsetCorrectionY } = this.getMainInternalViewport(sheetId);
@@ -46471,7 +46414,7 @@ class SheetViewPlugin extends UIPlugin {
         for (const i of relevantIndexes) {
             offset += this.getters.getHeaderSize(sheetId, dimension, i);
         }
-        return offset;
+        return offset * this.zoomLevel;
     }
     /**
      * Check if a given position is visible in the viewport.
@@ -46479,6 +46422,9 @@ class SheetViewPlugin extends UIPlugin {
     isVisibleInViewport({ sheetId, col, row }) {
         return this.getSubViewports(sheetId).some((pane) => pane.isVisible(col, row));
     }
+    getScrollBarWidth() {
+        return SCROLLBAR_WIDTH / this.zoomLevel;
+    }
     // => returns the new offset
     getEdgeScrollCol(x, previousX, startingX) {
         let canEdgeScroll = false;
@@ -46557,6 +46503,18 @@ class SheetViewPlugin extends UIPlugin {
         const rect = this.getVisibleRectWithoutHeaders(zone);
         return { ...rect, x: rect.x + this.gridOffsetX, y: rect.y + this.gridOffsetY };
     }
+    /**
+     * Computes the coordinates and size to draw the zone on the canvas after it has been zoomed
+     */
+    getVisibleRectWithZoom(zone) {
+        const zoom = this.getViewportZoomLevel();
+        const rect = this.getVisibleRectWithoutHeaders(zone);
+        rect.width = rect.width * zoom;
+        rect.height = rect.height * zoom;
+        rect.x = rect.x * zoom + this.gridOffsetX * zoom;
+        rect.y = rect.y * zoom + this.gridOffsetY * zoom;
+        return rect;
+    }
     /**
      * Computes the coordinates and size to draw the zone without taking the grid offset into account
      */
@@ -46638,6 +46596,9 @@ class SheetViewPlugin extends UIPlugin {
             };
         });
     }
+    getViewportZoomLevel() {
+        return this.zoomLevel;
+    }
     // ---------------------------------------------------------------------------
     // Private
     // ---------------------------------------------------------------------------
@@ -50849,5 +50810,5 @@ export { BadExpressionError, BasePlugin, CellErrorType, CircularDependencyError,
 
 
 __info__.version = "19.1.0-alpha.3";
-__info__.date = "2025-10-30T12:25:48.501Z";
-__info__.hash = "d0b65e9";
+__info__.date = "2025-11-03T12:33:46.742Z";
+__info__.hash = "d9230f3";