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

package/dist/o-spreadsheet-engine.iife.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
  */
 
 (function (exports) {
@@ -180,13 +180,13 @@
       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++;
           }
       }
@@ -194,7 +194,7 @@
       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;
@@ -222,9 +222,9 @@
    * 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
@@ -237,39 +237,39 @@
    *
    * 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) {
@@ -288,30 +288,31 @@
   }
   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++;
                   }
               }
@@ -319,7 +320,7 @@
               continue;
           }
           // End case: it's a required argument
-          valueIndexToArgPosition[countValueSupplied] = i;
+          valueIndexToArgPosition[countValueSupplied] = { index: i };
           countValueSupplied++;
       }
       return (argPosition) => {
@@ -331,7 +332,7 @@
   //------------------------------------------------------------------------------
   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;
@@ -615,6 +616,7 @@
   ];
   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;
@@ -2857,7 +2859,7 @@
           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) {
@@ -2871,7 +2873,7 @@
           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.
@@ -3139,8 +3141,7 @@
       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);
@@ -3169,8 +3170,7 @@
       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);
@@ -3220,10 +3220,7 @@
   // -----------------------------------------------------------------------------
   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))];
       },
@@ -3281,10 +3278,7 @@
   // -----------------------------------------------------------------------------
   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 = [];
@@ -3370,8 +3364,7 @@
   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)) {
@@ -3557,10 +3550,7 @@
   // -----------------------------------------------------------------------------
   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);
@@ -6155,6 +6145,7 @@
       "COPY",
       "RESIZE_SHEETVIEW",
       "SET_VIEWPORT_OFFSET",
+      "SET_ZOOM",
       "EVALUATE_CELLS",
       "EVALUATE_CHARTS",
       "SET_FORMULA_VISIBILITY",
@@ -6870,8 +6861,7 @@
   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) => {
@@ -6913,10 +6903,8 @@
   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;
@@ -6932,10 +6920,7 @@
   // -----------------------------------------------------------------------------
   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);
       },
@@ -6947,10 +6932,8 @@
       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();
@@ -7306,8 +7289,7 @@
   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;
@@ -7639,8 +7621,7 @@
               ...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);
@@ -7684,10 +7665,7 @@
   // -----------------------------------------------------------------------------
   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 {
@@ -7729,10 +7707,8 @@
       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;
@@ -8199,8 +8175,7 @@
   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;
@@ -8222,8 +8197,7 @@
   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 {
@@ -8241,10 +8215,8 @@
   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;
@@ -8300,8 +8272,7 @@
   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;
@@ -8354,10 +8325,8 @@
       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);
@@ -8383,8 +8352,7 @@
   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);
@@ -8396,10 +8364,7 @@
   // -----------------------------------------------------------------------------
   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);
       },
@@ -8632,8 +8597,7 @@
   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);
@@ -8646,8 +8610,7 @@
   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) => {
@@ -8664,10 +8627,8 @@
       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;
@@ -8687,8 +8648,7 @@
   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 = [];
@@ -8708,8 +8668,7 @@
   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);
@@ -8722,8 +8681,7 @@
   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) => {
@@ -8740,10 +8698,8 @@
       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;
@@ -9084,8 +9040,7 @@
   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));
@@ -9098,8 +9053,7 @@
   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));
@@ -9112,8 +9066,7 @@
   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));
@@ -9126,8 +9079,7 @@
   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));
@@ -9140,8 +9092,7 @@
   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));
@@ -9154,8 +9105,7 @@
   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));
@@ -9205,8 +9155,7 @@
   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);
@@ -9219,8 +9168,7 @@
   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);
@@ -9233,8 +9181,7 @@
   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);
@@ -9247,8 +9194,7 @@
   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);
@@ -9261,8 +9207,7 @@
   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);
@@ -9275,8 +9220,7 @@
   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);
@@ -11079,8 +11023,7 @@
       // 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);
@@ -11120,8 +11063,8 @@
       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") },
           ]),
@@ -11141,8 +11084,8 @@
           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") },
           ]),
@@ -12410,8 +12353,7 @@
       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) {
@@ -13766,8 +13708,7 @@
   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);
@@ -13850,10 +13791,8 @@
   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) {
@@ -13892,8 +13831,7 @@
   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);
@@ -13911,10 +13849,8 @@
       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) {
@@ -13949,8 +13885,7 @@
   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;
@@ -15425,8 +15360,8 @@
       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);
@@ -15461,8 +15396,8 @@
       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);
@@ -16333,10 +16268,7 @@
   // -----------------------------------------------------------------------------
   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), "");
       },
@@ -16391,8 +16323,7 @@
       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);
@@ -16683,13 +16614,12 @@
   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);
@@ -17562,7 +17492,7 @@
               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
@@ -17741,12 +17671,15 @@
       }
       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,
               }));
           }
@@ -40495,6 +40428,7 @@
       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"];
@@ -40513,7 +40447,7 @@
           "isSpillPivotFormula",
       ];
       pivots = {};
-      unusedPivots;
+      unusedPivotsInFormulas;
       custom;
       constructor(config) {
           super(config);
@@ -40553,12 +40487,12 @@
               }
               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;
@@ -40717,7 +40651,9 @@
           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);
@@ -40753,9 +40689,9 @@
               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()) {
@@ -40765,14 +40701,14 @@
                   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;
       }
   }
 
@@ -46178,6 +46114,7 @@
           "getVisibleFigures",
           "getVisibleRect",
           "getVisibleRectWithoutHeaders",
+          "getVisibleRectWithZoom",
           "getVisibleCellPositions",
           "getColRowOffsetInViewport",
           "getMainViewportCoordinates",
@@ -46193,6 +46130,8 @@
           "getFigureUI",
           "getPositionAnchorOffset",
           "getGridOffset",
+          "getViewportZoomLevel",
+          "getScrollBarWidth",
       ];
       viewports = {};
       /**
@@ -46205,6 +46144,7 @@
       sheetViewHeight = getDefaultSheetViewSize();
       gridOffsetX = 0;
       gridOffsetY = 0;
+      zoomLevel = 1;
       sheetsWithDirtyViewports = new Set();
       shouldAdjustViewports = false;
       // ---------------------------------------------------------------------------
@@ -46271,6 +46211,9 @@
               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);
@@ -46474,7 +46417,7 @@
           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.
@@ -46482,6 +46425,9 @@
       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;
@@ -46560,6 +46506,18 @@
           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
        */
@@ -46641,6 +46599,9 @@
               };
           });
       }
+      getViewportZoomLevel() {
+          return this.zoomLevel;
+      }
       // ---------------------------------------------------------------------------
       // Private
       // ---------------------------------------------------------------------------
@@ -50960,8 +50921,8 @@
 
 
   __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";
 
 
 })(this.o_spreadsheet_engine = this.o_spreadsheet_engine || {});