@odoo/o-spreadsheet 17.0.2 → 17.0.3

package/dist/o-spreadsheet.cjs.js

@@ -2,9 +2,9 @@
 /**
  * This file is generated by o-spreadsheet build tools. Do not edit it.
  * @see https://github.com/odoo/o-spreadsheet
- * @version 17.0.2
- * @date 2023-11-03T12:22:44.945Z
- * @hash 3184728
+ * @version 17.0.3
+ * @date 2023-11-16T11:59:49.524Z
+ * @hash 8bd0fb2
  */
 
 'use strict';
@@ -4542,14 +4542,14 @@ function drawDecoratedText(context, text, position, underline = false, strikethr
     switch (context.textBaseline) {
         case "top":
             underlineY += boxHeight - 2 * strokeWidth;
-            strikeY += boxHeight - textHeight;
+            strikeY += boxHeight / 2 - strokeWidth;
             break;
         case "middle":
             underlineY += boxHeight / 2 - strokeWidth;
             break;
         case "alphabetic":
             underlineY += 2 * strokeWidth;
-            strikeY -= textHeight / 2 - strokeWidth / 2;
+            strikeY -= 3 * strokeWidth;
             break;
         case "bottom":
             underlineY = y;
@@ -5968,7 +5968,7 @@ autofillModifiersRegistry
             return { cellData: {} };
         }
         const sheetId = data.sheetId;
-        const content = getters.getTranslatedCellFormula(sheetId, x, y, cell.compiledFormula, cell.dependencies);
+        const content = getters.getTranslatedCellFormula(sheetId, x, y, cell.compiledFormula);
         return {
             cellData: {
                 border: data.border,
@@ -10695,6 +10695,17 @@ const SELECTION_CONTAINS_FILTER = (env) => {
 const IS_ONLY_ONE_RANGE = (env) => {
     return env.model.getters.getSelectedZones().length === 1;
 };
+const CAN_INSERT_HEADER = (env, dimension) => {
+    if (!IS_ONLY_ONE_RANGE(env)) {
+        return false;
+    }
+    const activeHeaders = dimension === "COL" ? env.model.getters.getActiveCols() : env.model.getters.getActiveRows();
+    const ortogonalActiveHeaders = dimension === "COL" ? env.model.getters.getActiveRows() : env.model.getters.getActiveCols();
+    const sheetId = env.model.getters.getActiveSheetId();
+    const zone = env.model.getters.getSelectedZone();
+    const allSheetSelected = isEqual(zone, env.model.getters.getSheetZone(sheetId));
+    return isConsecutive(activeHeaders) && (ortogonalActiveHeaders.size === 0 || allSheetSelected);
+};
 
 const undo = {
     name: _t("Undo"),
@@ -19372,9 +19383,7 @@ const insertRow = {
         const number = getRowsNumber(env);
         return number === 1 ? _t("Insert row") : _t("Insert %s rows", number.toString());
     },
-    isVisible: (env) => isConsecutive(env.model.getters.getActiveRows()) &&
-        IS_ONLY_ONE_RANGE(env) &&
-        env.model.getters.getActiveCols().size === 0,
+    isVisible: (env) => CAN_INSERT_HEADER(env, "ROW"),
     icon: "o-spreadsheet-Icon.INSERT_ROW",
 };
 const rowInsertRowBefore = {
@@ -19383,9 +19392,7 @@ const rowInsertRowBefore = {
         return number === 1 ? _t("Insert row above") : _t("Insert %s rows above", number.toString());
     },
     execute: INSERT_ROWS_BEFORE_ACTION,
-    isVisible: (env) => isConsecutive(env.model.getters.getActiveRows()) &&
-        IS_ONLY_ONE_RANGE(env) &&
-        env.model.getters.getActiveCols().size === 0,
+    isVisible: (env) => CAN_INSERT_HEADER(env, "ROW"),
     icon: "o-spreadsheet-Icon.INSERT_ROW_BEFORE",
 };
 const topBarInsertRowsBefore = {
@@ -19416,9 +19423,7 @@ const rowInsertRowsAfter = {
         const number = getRowsNumber(env);
         return number === 1 ? _t("Insert row below") : _t("Insert %s rows below", number.toString());
     },
-    isVisible: (env) => isConsecutive(env.model.getters.getActiveRows()) &&
-        IS_ONLY_ONE_RANGE(env) &&
-        env.model.getters.getActiveCols().size === 0,
+    isVisible: (env) => CAN_INSERT_HEADER(env, "ROW"),
     icon: "o-spreadsheet-Icon.INSERT_ROW_AFTER",
 };
 const topBarInsertRowsAfter = {
@@ -19436,9 +19441,7 @@ const insertCol = {
         const number = getColumnsNumber(env);
         return number === 1 ? _t("Insert column") : _t("Insert %s columns", number.toString());
     },
-    isVisible: (env) => isConsecutive(env.model.getters.getActiveCols()) &&
-        IS_ONLY_ONE_RANGE(env) &&
-        env.model.getters.getActiveRows().size === 0,
+    isVisible: (env) => CAN_INSERT_HEADER(env, "COL"),
     icon: "o-spreadsheet-Icon.INSERT_COL",
 };
 const colInsertColsBefore = {
@@ -19449,9 +19452,7 @@ const colInsertColsBefore = {
             : _t("Insert %s columns left", number.toString());
     },
     execute: INSERT_COLUMNS_BEFORE_ACTION,
-    isVisible: (env) => isConsecutive(env.model.getters.getActiveCols()) &&
-        IS_ONLY_ONE_RANGE(env) &&
-        env.model.getters.getActiveRows().size === 0,
+    isVisible: (env) => CAN_INSERT_HEADER(env, "COL"),
     icon: "o-spreadsheet-Icon.INSERT_COL_BEFORE",
 };
 const topBarInsertColsBefore = {
@@ -19484,9 +19485,7 @@ const colInsertColsAfter = {
             : _t("Insert %s columns right", number.toString());
     },
     execute: INSERT_COLUMNS_AFTER_ACTION,
-    isVisible: (env) => isConsecutive(env.model.getters.getActiveCols()) &&
-        IS_ONLY_ONE_RANGE(env) &&
-        env.model.getters.getActiveRows().size === 0,
+    isVisible: (env) => CAN_INSERT_HEADER(env, "COL"),
     icon: "o-spreadsheet-Icon.INSERT_COL_AFTER",
 };
 const topBarInsertColsAfter = {
@@ -23827,7 +23826,7 @@ css /* scss */ `
       }
       .o-input-count {
         width: fit-content;
-        padding: 4 0 4 4;
+        padding: 4px 0 4px 4px;
       }
     }
   }
@@ -34948,6 +34947,9 @@ const functionCache = {};
 // -----------------------------------------------------------------------------
 function compile(formula) {
     const tokens = rangeTokenize(formula);
+    return compileTokens(tokens);
+}
+function compileTokens(tokens) {
     const { dependencies, constantValues } = formulaArguments(tokens);
     const cacheKey = compilationCacheKey(tokens, dependencies, constantValues);
     if (!functionCache[cacheKey]) {
@@ -35314,11 +35316,11 @@ class CellPlugin extends CorePlugin {
         for (const sheet of Object.keys(this.cells)) {
             for (const cell of Object.values(this.cells[sheet] || {})) {
                 if (cell.isFormula) {
-                    for (const range of cell.dependencies) {
+                    for (const range of cell.compiledFormula.dependencies) {
                         if (!sheetId || range.sheetId === sheetId) {
                             const change = applyChange(range);
                             if (change.changeType !== "NONE") {
-                                this.history.update("cells", sheet, cell.id, "dependencies", cell.dependencies.indexOf(range), change.range);
+                                this.history.update("cells", sheet, cell.id, "compiledFormula", "dependencies", cell.compiledFormula.dependencies.indexOf(range), change.range);
                             }
                         }
                     }
@@ -35514,10 +35516,10 @@ class CellPlugin extends CorePlugin {
     /*
      * Reconstructs the original formula string based on a normalized form and its dependencies
      */
-    getFormulaCellContent(sheetId, cell, dependencies) {
-        const ranges = dependencies || cell.dependencies;
+    getFormulaCellContent(sheetId, compiledFormula, dependencies) {
+        const ranges = dependencies || compiledFormula.dependencies;
         let rangeIndex = 0;
-        return concat(cell.compiledFormula.tokens.map((token) => {
+        return concat(compiledFormula.tokens.map((token) => {
             if (token.type === "REFERENCE") {
                 const range = ranges[rangeIndex++];
                 return this.getters.getRangeString(range, sheetId);
@@ -35528,12 +35530,9 @@ class CellPlugin extends CorePlugin {
     /*
      * Constructs a formula string based on an initial formula and a translation vector
      */
-    getTranslatedCellFormula(sheetId, offsetX, offsetY, compiledFormula, dependencies) {
-        const adaptedDependencies = this.getters.createAdaptedRanges(dependencies, offsetX, offsetY, sheetId);
-        return this.getFormulaCellContent(sheetId, {
-            compiledFormula,
-            dependencies: adaptedDependencies,
-        });
+    getTranslatedCellFormula(sheetId, offsetX, offsetY, compiledFormula) {
+        const adaptedDependencies = this.getters.createAdaptedRanges(compiledFormula.dependencies, offsetX, offsetY, sheetId);
+        return this.getFormulaCellContent(sheetId, compiledFormula, adaptedDependencies);
     }
     getCellStyle(position) {
         return this.getters.getCell(position)?.style || {};
@@ -35713,8 +35712,10 @@ class CellPlugin extends CorePlugin {
             style,
             format,
             isFormula: true,
-            compiledFormula,
-            dependencies: [],
+            compiledFormula: {
+                ...compiledFormula,
+                dependencies: [],
+            },
         };
     }
     /**
@@ -35723,7 +35724,7 @@ class CellPlugin extends CorePlugin {
      */
     createFormulaCellWithDependencies(id, compiledFormula, format, style, sheetId) {
         const dependencies = compiledFormula.dependencies.map((xc) => this.getters.getRangeFromSheetXC(sheetId, xc));
-        return new FormulaCellWithDependencies(id, compiledFormula, format, style, dependencies, sheetId, this.getFormulaCellContent.bind(this));
+        return new FormulaCellWithDependencies(id, compiledFormula, format, style, dependencies, sheetId, this.getters.getRangeString.bind(this));
     }
     createErrorFormula(id, content, format, style, error) {
         return {
@@ -35733,13 +35734,12 @@ class CellPlugin extends CorePlugin {
             format,
             isFormula: true,
             compiledFormula: {
-                dependencies: [],
                 tokens: tokenize(content),
+                dependencies: [],
                 execute: function () {
                     throw error;
                 },
             },
-            dependencies: [],
         };
     }
     checkCellOutOfSheet(sheetId, col, row) {
@@ -35752,27 +35752,44 @@ class CellPlugin extends CorePlugin {
 }
 class FormulaCellWithDependencies {
     id;
-    compiledFormula;
     format;
     style;
-    dependencies;
     sheetId;
-    getFormulaCellContent;
+    getRangeString;
     isFormula = true;
-    constructor(id, compiledFormula, format, style, dependencies, sheetId, getFormulaCellContent) {
+    compiledFormula;
+    constructor(id, compiledFormula, format, style, dependencies, sheetId, getRangeString) {
         this.id = id;
-        this.compiledFormula = compiledFormula;
         this.format = format;
         this.style = style;
-        this.dependencies = dependencies;
         this.sheetId = sheetId;
-        this.getFormulaCellContent = getFormulaCellContent;
+        this.getRangeString = getRangeString;
+        let rangeIndex = 0;
+        const tokens = compiledFormula.tokens.map((token) => {
+            if (token.type === "REFERENCE") {
+                const index = rangeIndex++;
+                return new RangeReferenceToken(() => this.getRangeString(dependencies[index], this.sheetId));
+            }
+            return token;
+        });
+        this.compiledFormula = {
+            ...compiledFormula,
+            dependencies,
+            tokens,
+        };
     }
     get content() {
-        return this.getFormulaCellContent(this.sheetId, {
-            dependencies: this.dependencies,
-            compiledFormula: this.compiledFormula,
-        });
+        return concat(this.compiledFormula.tokens.map((token) => token.value));
+    }
+}
+class RangeReferenceToken {
+    getValue;
+    type = "REFERENCE";
+    constructor(getValue) {
+        this.getValue = getValue;
+    }
+    get value() {
+        return this.getValue();
     }
 }
 
@@ -36917,6 +36934,13 @@ class FiltersPlugin extends CorePlugin {
     }
     onDeleteColumnsRows(cmd) {
         for (const table of this.getFilterTables(cmd.sheetId)) {
+            // Remove the filter tables whose data filter headers are in the removed rows.
+            if (cmd.dimension === "ROW" && cmd.elements.includes(table.zone.top)) {
+                const tables = { ...this.tables[cmd.sheetId] };
+                delete tables[table.id];
+                this.history.update("tables", cmd.sheetId, tables);
+                continue;
+            }
             const zone = reduceZoneOnDeletion(table.zone, cmd.dimension === "COL" ? "left" : "top", cmd.elements);
             if (!zone) {
                 const tables = { ...this.tables[cmd.sheetId] };
@@ -39965,6 +39989,13 @@ class Evaluator {
         return (this.evaluatedCells.get(this.encodePosition(position)) ||
             createEvaluatedCell("", { locale: this.getters.getLocale() }));
     }
+    getSpreadPositionsOf(position) {
+        const positionId = this.encodePosition(position);
+        if (!this.spreadingRelations.isArrayFormula(positionId)) {
+            return [];
+        }
+        return Array.from(this.spreadingRelations.getArrayResultPositionIds(positionId)).map(this.decodePosition.bind(this));
+    }
     getArrayFormulaSpreadingOn(position) {
         const positionId = this.encodePosition(position);
         const formulaPosition = this.getArrayFormulaSpreadingOnId(positionId);
@@ -40123,7 +40154,7 @@ class Evaluator {
             const position = this.compilationParams[2].getters.getCellPosition(cellId);
             return toXC(position.col, position.row);
         };
-        const formulaReturn = cellData.compiledFormula.execute(cellData.dependencies, ...this.compilationParams);
+        const formulaReturn = cellData.compiledFormula.execute(cellData.compiledFormula.dependencies, ...this.compilationParams);
         if (!isMatrix(formulaReturn)) {
             return createEvaluatedCell(formulaReturn.value, {
                 format: cellData.format || formulaReturn.format,
@@ -40223,7 +40254,7 @@ class Evaluator {
             return [];
         }
         const dependencies = [];
-        for (const range of cell.dependencies) {
+        for (const range of cell.compiledFormula.dependencies) {
             if (range.invalidSheetName || range.invalidXc) {
                 continue;
             }
@@ -40429,6 +40460,7 @@ class EvaluationPlugin extends UIPlugin {
         "getEvaluatedCell",
         "getEvaluatedCells",
         "getEvaluatedCellsInZone",
+        "getSpreadPositionsOf",
     ];
     shouldRebuildDependenciesGraph = true;
     evaluator;
@@ -40538,6 +40570,9 @@ class EvaluationPlugin extends UIPlugin {
     getEvaluatedCellsInZone(sheetId, zone) {
         return positions(zone).map(({ col, row }) => this.getters.getEvaluatedCell({ sheetId, col, row }));
     }
+    getSpreadPositionsOf(position) {
+        return this.evaluator.getSpreadPositionsOf(position);
+    }
     // ---------------------------------------------------------------------------
     // Export
     // ---------------------------------------------------------------------------
@@ -40575,10 +40610,10 @@ class EvaluationPlugin extends UIPlugin {
      */
     getCorrespondingFormulaCell(position) {
         const cell = this.getters.getCell(position);
-        if (cell && cell.content) {
-            if (cell.isFormula && !isBadExpression(cell.content)) {
-                return cell;
-            }
+        if (cell && cell.isFormula) {
+            return isBadExpression(cell.compiledFormula.tokens) ? undefined : cell;
+        }
+        else if (cell && cell.content) {
             return undefined;
         }
         const spreadingFormulaPosition = this.evaluator.getArrayFormulaSpreadingOn(position);
@@ -40595,9 +40630,9 @@ class EvaluationPlugin extends UIPlugin {
         return buildCompilationParameters(this.config.custom, this.getters, (position) => this.evaluator.getEvaluatedCell(position));
     }
 }
-function isBadExpression(formula) {
+function isBadExpression(tokens) {
     try {
-        compile(formula);
+        compileTokens(tokens);
         return false;
     }
     catch (error) {
@@ -40766,22 +40801,20 @@ class EvaluationChartPlugin extends UIPlugin {
             invalidateCFEvaluationCommands.has(cmd.type) ||
             cmd.type === "EVALUATE_CELLS" ||
             cmd.type === "UPDATE_CELL") {
-            if (cmd.type !== "UNDO" && cmd.type !== "REDO") {
-                for (const chartId in this.charts) {
-                    this.history.update("charts", chartId, undefined);
-                }
+            for (const chartId in this.charts) {
+                this.charts[chartId] = undefined;
             }
         }
         switch (cmd.type) {
             case "UPDATE_CHART":
             case "CREATE_CHART":
             case "DELETE_FIGURE":
-                this.history.update("charts", cmd.id, undefined);
+                this.charts[cmd.id] = undefined;
                 break;
             case "DELETE_SHEET":
                 for (let chartId in this.charts) {
                     if (!this.getters.isChartDefined(chartId)) {
-                        this.history.update("charts", chartId, undefined);
+                        this.charts[chartId] = undefined;
                     }
                 }
                 break;
@@ -40793,8 +40826,7 @@ class EvaluationChartPlugin extends UIPlugin {
             if (!chart) {
                 throw new Error(`No chart for the given id: ${figureId}`);
             }
-            const runtime = this.createRuntimeChart(chart);
-            this.history.update("charts", figureId, runtime);
+            this.charts[figureId] = this.createRuntimeChart(chart);
         }
         return this.charts[figureId];
     }
@@ -40946,7 +40978,10 @@ class EvaluationConditionalFormatPlugin extends UIPlugin {
                                     const values = cf.rule.values.map((value, i) => {
                                         const compiledFormula = formulas[i];
                                         if (compiledFormula) {
-                                            return this.getters.getTranslatedCellFormula(sheetId, col - zone.left, row - zone.top, compiledFormula, compiledFormula.dependencies.map((d) => this.getters.getRangeFromSheetXC(sheetId, d)));
+                                            return this.getters.getTranslatedCellFormula(sheetId, col - zone.left, row - zone.top, {
+                                                ...compiledFormula,
+                                                dependencies: compiledFormula.dependencies.map((d) => this.getters.getRangeFromSheetXC(sheetId, d)),
+                                            });
                                         }
                                         return value;
                                     });
@@ -41318,7 +41353,10 @@ class EvaluationDataValidationPlugin extends UIPlugin {
             }
             try {
                 const formula = compile(value);
-                const translatedFormula = this.getters.getTranslatedCellFormula(sheetId, offset.col, offset.row, formula, formula.dependencies.map((d) => this.getters.getRangeFromSheetXC(sheetId, d)));
+                const translatedFormula = this.getters.getTranslatedCellFormula(sheetId, offset.col, offset.row, {
+                    ...formula,
+                    dependencies: formula.dependencies.map((d) => this.getters.getRangeFromSheetXC(sheetId, d)),
+                });
                 const evaluated = this.getters.evaluateFormula(sheetId, translatedFormula);
                 return evaluated && !isMatrix(evaluated) ? evaluated.toString() : "";
             }
@@ -43570,7 +43608,7 @@ class ClipboardCellsState extends ClipboardCellsAbstractState {
             }
             let content = origin.cell.content;
             if (origin.cell.isFormula && operation === "COPY") {
-                content = this.getters.getTranslatedCellFormula(sheetId, col - origin.position.col, row - origin.position.row, origin.cell.compiledFormula, origin.cell.dependencies);
+                content = this.getters.getTranslatedCellFormula(sheetId, col - origin.position.col, row - origin.position.row, origin.cell.compiledFormula);
             }
             this.dispatch("UPDATE_CELL", {
                 ...target,
@@ -44102,20 +44140,29 @@ class FindAndReplacePlugin extends UIPlugin {
         const sheetId = this.getters.getActiveSheetId();
         const cells = this.getters.getCells(sheetId);
         const matches = [];
-        if (this.toSearch) {
+        if (this.toSearch && this.currentSearchRegex) {
             for (const cell of Object.values(cells)) {
                 const { col, row } = this.getters.getCellPosition(cell.id);
+                const cellPosition = { sheetId, col, row };
                 const isColHidden = this.getters.isColHidden(sheetId, col);
                 const isRowHidden = this.getters.isRowHidden(sheetId, row);
                 if (isColHidden || isRowHidden) {
                     continue;
                 }
-                if (cell &&
-                    this.currentSearchRegex &&
-                    this.currentSearchRegex.test(this.getSearchableString({ sheetId, col, row }))) {
+                if (this.currentSearchRegex.test(this.getSearchableString(cellPosition))) {
                     const match = { col, row, selected: false };
                     matches.push(match);
                 }
+                for (const spreadPosition of this.getters.getSpreadPositionsOf(cellPosition)) {
+                    if (this.currentSearchRegex.test(this.getSearchableString(spreadPosition))) {
+                        const match = {
+                            col: spreadPosition.col,
+                            row: spreadPosition.row,
+                            selected: false,
+                        };
+                        matches.push(match);
+                    }
+                }
             }
         }
         return matches.sort(this.sortByRowThenColumn);
@@ -44174,16 +44221,19 @@ class FindAndReplacePlugin extends UIPlugin {
             return;
         }
         const sheetId = this.getters.getActiveSheetId();
-        const cell = this.getters.getCell({ sheetId, ...selectedMatch });
-        const { col, row } = selectedMatch;
+        const position = { sheetId, ...selectedMatch };
+        const cell = this.getters.getCell(position);
+        if (!cell?.content) {
+            return;
+        }
         if (cell?.isFormula && !this.searchOptions.searchFormulas) {
             return;
         }
         const replaceRegex = new RegExp(this.currentSearchRegex.source, this.currentSearchRegex.flags + "g");
-        const toReplace = this.getSearchableString({ sheetId, col, row });
+        const toReplace = this.getSearchableString(position);
         const content = toReplace.replace(replaceRegex, replaceWith);
         const canonicalContent = canonicalizeNumberContent(content, this.getters.getLocale());
-        this.dispatch("UPDATE_CELL", { sheetId, col, row, content: canonicalContent });
+        this.dispatch("UPDATE_CELL", { ...position, content: canonicalContent });
     }
     /**
      * Replace the value of the currently selected match
@@ -45758,7 +45808,7 @@ class SortPlugin extends UIPlugin {
                     if (cell.isFormula) {
                         const position = this.getters.getCellPosition(cell.id);
                         // we only have a vertical offset
-                        content = this.getters.getTranslatedCellFormula(sheetId, 0, newRow - position.row, cell.compiledFormula, cell.dependencies);
+                        content = this.getters.getTranslatedCellFormula(sheetId, 0, newRow - position.row, cell.compiledFormula);
                     }
                     newCellValues.style = cell.style;
                     newCellValues.content = content;
@@ -47821,6 +47871,8 @@ class FilterEvaluationPlugin extends UIPlugin {
             case "EVALUATE_CELLS":
             case "ACTIVATE_SHEET":
             case "REMOVE_FILTER_TABLE":
+            case "ADD_COLUMNS_ROWS":
+            case "REMOVE_COLUMNS_ROWS":
                 this.isEvaluationDirty = true;
                 break;
             case "START":
@@ -55844,6 +55896,7 @@ exports.__info__ = __info__;
 exports.addFunction = addFunction;
 exports.astToFormula = astToFormula;
 exports.compile = compile;
+exports.compileTokens = compileTokens;
 exports.components = components;
 exports.constants = constants;
 exports.convertAstNodes = convertAstNodes;
@@ -55859,6 +55912,7 @@ exports.iterateAstNodes = iterateAstNodes;
 exports.links = links;
 exports.load = load;
 exports.parse = parse;
+exports.parseTokens = parseTokens;
 exports.readonlyAllowedCommands = readonlyAllowedCommands;
 exports.registries = registries;
 exports.setDefaultSheetViewSize = setDefaultSheetViewSize;
@@ -55866,6 +55920,6 @@ exports.setTranslationMethod = setTranslationMethod;
 exports.tokenize = tokenize;
 
 
-__info__.version = "17.0.2";
-__info__.date = "2023-11-03T12:22:44.945Z";
-__info__.hash = "3184728";
+__info__.version = "17.0.3";
+__info__.date = "2023-11-16T11:59:49.524Z";
+__info__.hash = "8bd0fb2";

package/dist/o-spreadsheet.d.ts

@@ -17,6 +17,7 @@ declare const functionCache: {
     [key: string]: Omit<CompiledFormula, "dependencies" | "tokens">;
 };
 declare function compile(formula: string): CompiledFormula;
+declare function compileTokens(tokens: Token[]): CompiledFormula;
 
 interface FunctionContext {
     parent: string;
@@ -93,6 +94,7 @@ type AST = ASTOperation | ASTUnaryOperation | ASTFuncall | ASTNumber | ASTBoolea
  * Parse an expression (as a string) into an AST.
  */
 declare function parse(str: string): AST;
+declare function parseTokens(tokens: Token[]): AST;
 /**
  * Allows to visit all nodes of an AST and apply a mapping function
  * to nodes of a specific type.
@@ -2652,6 +2654,9 @@ interface CompiledFormula {
     tokens: Token[];
     dependencies: string[];
 }
+interface RangeCompiledFormula extends Omit<CompiledFormula, "dependencies"> {
+    dependencies: Range[];
+}
 type Matrix<T = unknown> = T[][];
 type ValueAndFormat = {
     value: CellValue;
@@ -2803,8 +2808,7 @@ interface LiteralCell extends CellAttributes {
 }
 interface FormulaCell extends CellAttributes {
     readonly isFormula: true;
-    readonly compiledFormula: CompiledFormula;
-    readonly dependencies: Range[];
+    readonly compiledFormula: RangeCompiledFormula;
 }
 type Cell = LiteralCell | FormulaCell;
 interface EvaluatedCellProperties {
@@ -3378,8 +3382,8 @@ declare class CellPlugin extends CorePlugin<CoreState> implements CoreState {
      * starting an async evaluation even if it has been moved or re-allocated
      */
     getCellById(cellId: UID): Cell | undefined;
-    getFormulaCellContent(sheetId: UID, cell: Pick<FormulaCell, "dependencies" | "compiledFormula">, dependencies?: Range[]): string;
-    getTranslatedCellFormula(sheetId: UID, offsetX: number, offsetY: number, compiledFormula: CompiledFormula, dependencies: Range[]): string;
+    getFormulaCellContent(sheetId: UID, compiledFormula: RangeCompiledFormula, dependencies?: Range[]): string;
+    getTranslatedCellFormula(sheetId: UID, offsetX: number, offsetY: number, compiledFormula: RangeCompiledFormula): string;
     getCellStyle(position: CellPosition): Style;
     /**
      * Converts a zone to a XC coordinate system
@@ -4084,7 +4088,7 @@ declare class SheetPlugin extends CorePlugin<SheetState> implements SheetState {
 
 declare class EvaluationPlugin extends UIPlugin {
     private config;
-    static getters: readonly ["evaluateFormula", "getCorrespondingFormulaCell", "getRangeFormattedValues", "getRangeValues", "getRangeFormats", "getEvaluatedCell", "getEvaluatedCells", "getEvaluatedCellsInZone"];
+    static getters: readonly ["evaluateFormula", "getCorrespondingFormulaCell", "getRangeFormattedValues", "getRangeValues", "getRangeFormats", "getEvaluatedCell", "getEvaluatedCells", "getEvaluatedCellsInZone", "getSpreadPositionsOf"];
     private shouldRebuildDependenciesGraph;
     private evaluator;
     private compilationParams;
@@ -4109,6 +4113,7 @@ declare class EvaluationPlugin extends UIPlugin {
     getEvaluatedCell(position: CellPosition): EvaluatedCell;
     getEvaluatedCells(sheetId: UID): Record<UID, EvaluatedCell>;
     getEvaluatedCellsInZone(sheetId: UID, zone: Zone): EvaluatedCell[];
+    getSpreadPositionsOf(position: CellPosition): CellPosition[];
     exportForExcel(data: ExcelWorkbookData): void;
     /**
      * Returns the corresponding formula cell of a given cell
@@ -4142,11 +4147,11 @@ declare class CustomColorsPlugin extends UIPlugin<CustomColorState> {
 }
 
 interface EvaluationChartState {
-    readonly charts: Immutable<Record<UID, ChartRuntime | undefined>>;
+    charts: Record<UID, ChartRuntime | undefined>;
 }
 declare class EvaluationChartPlugin extends UIPlugin<EvaluationChartState> {
     static getters: readonly ["getChartRuntime", "getBackgroundOfSingleCellChart"];
-    readonly charts: Immutable<Record<UID, ChartRuntime | undefined>>;
+    charts: Record<UID, ChartRuntime | undefined>;
     private createRuntimeChart;
     handle(cmd: CoreViewCommand): void;
     getChartRuntime(figureId: UID): ChartRuntime;
@@ -7908,4 +7913,4 @@ declare const constants: {
     DEFAULT_LOCALE: Locale;
 };
 
-export { AbstractChart, CancelledReason, Client, ClientJoinedMessage, ClientLeftMessage, ClientMovedMessage, CollaborationMessage, CommandResult, CorePlugin, DispatchResult, EvaluationError, Model, Registry, RemoteRevisionMessage, Revision, RevisionRedoneMessage, RevisionUndoneMessage, SPREADSHEET_DIMENSIONS, Spreadsheet, TransportService, UIPlugin, __info__, addFunction, astToFormula, compile, components, constants, convertAstNodes, coreTypes, findCellInNewZone, functionCache, helpers, hooks, invalidateCFEvaluationCommands, invalidateDependenciesCommands, invalidateEvaluationCommands, iterateAstNodes, links, load, parse, readonlyAllowedCommands, registries, setDefaultSheetViewSize, setTranslationMethod, tokenize };
+export { AbstractChart, CancelledReason, Client, ClientJoinedMessage, ClientLeftMessage, ClientMovedMessage, CollaborationMessage, CommandResult, CorePlugin, DispatchResult, EvaluationError, Model, Registry, RemoteRevisionMessage, Revision, RevisionRedoneMessage, RevisionUndoneMessage, SPREADSHEET_DIMENSIONS, Spreadsheet, TransportService, UIPlugin, __info__, addFunction, astToFormula, compile, compileTokens, components, constants, convertAstNodes, coreTypes, findCellInNewZone, functionCache, helpers, hooks, invalidateCFEvaluationCommands, invalidateDependenciesCommands, invalidateEvaluationCommands, iterateAstNodes, links, load, parse, parseTokens, readonlyAllowedCommands, registries, setDefaultSheetViewSize, setTranslationMethod, tokenize };