@odoo/o-spreadsheet 19.2.0-alpha.2 → 19.2.0-alpha.4

package/dist/o-spreadsheet-engine.d.ts

@@ -44,7 +44,7 @@ type Format = string & Alias;
 type FormattedValue = string & Alias;
 
 interface CellAttributes {
-    readonly id: UID;
+    readonly id: number;
     /**
      * Raw cell content
      */
@@ -179,6 +179,7 @@ interface Table {
     readonly range: Range;
     readonly filters: Filter[];
     readonly config: TableConfig;
+    readonly isPivotTable?: boolean;
 }
 interface StaticTable extends Table {
     readonly type: "static" | "forceStatic";
@@ -213,9 +214,13 @@ interface TableElementStyle {
     style?: Style;
     size?: number;
 }
-interface TableBorder extends Border {
-    horizontal?: BorderDescr;
-    vertical?: BorderDescr;
+interface TableBorder {
+    top?: BorderDescr | null;
+    bottom?: BorderDescr | null;
+    left?: BorderDescr | null;
+    right?: BorderDescr | null;
+    horizontal?: BorderDescr | null;
+    vertical?: BorderDescr | null;
 }
 interface TableStyle {
     category: string;
@@ -231,8 +236,12 @@ interface TableStyle {
     lastColumn?: TableElementStyle;
     headerRow?: TableElementStyle;
     totalRow?: TableElementStyle;
+    measureHeader?: TableElementStyle;
+    mainSubHeaderRow?: TableElementStyle;
+    firstAlternatingSubHeaderRow?: TableElementStyle;
+    secondAlternatingSubHeaderRow?: TableElementStyle;
 }
-type TableStyleTemplateName = "none" | "lightColoredText" | "lightAllBorders" | "mediumAllBorders" | "lightWithHeader" | "mediumBandedBorders" | "mediumMinimalBorders" | "darkNoBorders" | "mediumWhiteBorders" | "dark";
+type TableStyleTemplateName = string;
 declare const filterCriterions: GenericCriterionType[];
 type FilterCriterionType = (typeof filterCriterions)[number];
 interface ValuesFilter {
@@ -413,7 +422,7 @@ declare class CarouselPlugin extends CorePlugin<CarouselState> implements Carous
 }
 
 interface CoreState$1 {
-    cells: Record<UID, Record<UID, Cell | undefined> | undefined>;
+    cells: Record<UID, Record<number, Cell | undefined> | undefined>;
     nextId: number;
 }
 /**
@@ -430,7 +439,7 @@ declare class CellPlugin extends CorePlugin<CoreState$1> implements CoreState$1
             [id: string]: Cell;
         };
     };
-    adaptRanges(applyChange: ApplyRangeChange, sheetId: UID, sheetName: AdaptSheetName): void;
+    adaptRanges({ applyChange }: RangeAdapterFunctions, sheetId: UID, sheetName: AdaptSheetName): void;
     allowDispatch(cmd: CoreCommand): CommandResult | CommandResult[];
     handle(cmd: CoreCommand): void;
     private clearZones;
@@ -454,12 +463,12 @@ declare class CellPlugin extends CorePlugin<CoreState$1> implements CoreState$1
     export(data: WorkbookData): void;
     importCell(sheetId: UID, content?: string, format?: Format): Cell;
     exportForExcel(data: ExcelWorkbookData): void;
-    getCells(sheetId: UID): Record<UID, Cell>;
+    getCells(sheetId: UID): Cell[];
     /**
      * get a cell by ID. Used in evaluation when evaluating an async cell, we need to be able to find it back after
      * starting an async evaluation even if it has been moved or re-allocated
      */
-    getCellById(cellId: UID): Cell | undefined;
+    getCellById(cellId: number): Cell | undefined;
     getFormulaString(sheetId: UID, tokens: Token[], dependencies: Range[], useBoundedReference?: boolean): string;
     getTranslatedCellFormula(sheetId: UID, offsetX: number, offsetY: number, tokens: Token[]): string;
     getFormulaMovedInSheet(originSheetId: UID, targetSheetId: UID, tokens: Token[]): string;
@@ -492,7 +501,7 @@ declare class CellPlugin extends CorePlugin<CoreState$1> implements CoreState$1
      * gets the currently used style and format of a cell based on it's coordinates
      */
     private getFormat;
-    private getNextUid;
+    private getNextCellId;
     private updateCell;
     private createCell;
     private createLiteralCell;
@@ -560,7 +569,7 @@ declare abstract class AbstractChart {
      * This function should be used to update all the ranges of the chart after
      * a grid change (add/remove col/row, rename sheet, ...)
      */
-    abstract updateRanges(applyChange: ApplyRangeChange, sheetId: UID, adaptSheetName: AdaptSheetName): AbstractChart;
+    abstract updateRanges(rangeAdapters: RangeAdapterFunctions): AbstractChart;
     /**
      * Duplicate the chart when a sheet is duplicated.
      * The ranges that are in the same sheet as the chart are adapted to the new sheetId.
@@ -593,7 +602,7 @@ declare class ChartPlugin extends CorePlugin<ChartState> implements ChartState {
     readonly charts: Record<UID, FigureChart | undefined>;
     private createChart;
     private validateChartDefinition;
-    adaptRanges(applyChange: ApplyRangeChange, sheetId: UID, adaptSheetName: AdaptSheetName): void;
+    adaptRanges(rangeAdapters: RangeAdapterFunctions): void;
     allowDispatch(cmd: Command): CommandResult | CommandResult[];
     handle(cmd: CoreCommand): void;
     getContextCreationChart(chartId: UID): ChartCreationContext | undefined;
@@ -702,9 +711,9 @@ declare class ConditionalFormatPlugin extends CorePlugin<ConditionalFormatState>
     readonly cfRules: {
         [sheet: string]: ConditionalFormatInternal[];
     };
-    adaptCFFormulas(applyChange: ApplyRangeChange): void;
-    adaptCFRanges(sheetId: UID, applyChange: ApplyRangeChange): void;
-    adaptRanges(applyChange: ApplyRangeChange, sheetId: UID): void;
+    adaptCFFormulas({ applyChange, adaptFormulaString }: RangeAdapterFunctions): void;
+    adaptCFRanges(sheetId: UID, { applyChange }: RangeAdapterFunctions): void;
+    adaptRanges(rangeAdapters: RangeAdapterFunctions, sheetId: UID): void;
     allowDispatch(cmd: Command): CommandResult | CommandResult[];
     handle(cmd: CoreCommand): void;
     import(data: WorkbookData): void;
@@ -873,7 +882,7 @@ declare class DataValidationPlugin extends CorePlugin<DataValidationState> imple
     readonly rules: {
         [sheet: string]: DataValidationRule[];
     };
-    adaptRanges(applyChange: ApplyRangeChange, sheetId: UID): void;
+    adaptRanges(rangeAdapters: RangeAdapterFunctions, sheetId: UID): void;
     private adaptDVFormulas;
     private adaptDVRanges;
     allowDispatch(cmd: Command): CommandResult | CommandResult[];
@@ -908,7 +917,7 @@ declare class FigurePlugin extends CorePlugin<FigureState> implements FigureStat
         [sheet: string]: Record<UID, Figure | undefined> | undefined;
     };
     readonly insertionOrders: UID[];
-    adaptRanges(applyChange: ApplyRangeChange, sheetId: UID): void;
+    adaptRanges({ applyChange }: RangeAdapterFunctions, sheetId: UID): void;
     allowDispatch(cmd: CoreCommand): CommandResult | CommandResult[];
     beforeHandle(cmd: CoreCommand): void;
     handle(cmd: CoreCommand): void;
@@ -1119,20 +1128,16 @@ interface MergeState {
     readonly mergeCellMap: Record<UID, SheetMergeCellMap | undefined>;
 }
 declare class MergePlugin extends CorePlugin<MergeState> implements MergeState {
-    static getters: readonly ["isInMerge", "isInSameMerge", "isMergeHidden", "getMainCellPosition", "expandZone", "doesIntersectMerge", "doesColumnsHaveCommonMerges", "doesRowsHaveCommonMerges", "getMerges", "getMerge", "getMergesInZone", "isSingleCellOrMerge", "getSelectionRangeString", "isMainCellPosition"];
+    static getters: readonly ["isInMerge", "isInSameMerge", "isMergeHidden", "getMainCellPosition", "expandZone", "doesIntersectMerge", "doesColumnsHaveCommonMerges", "doesRowsHaveCommonMerges", "getMerges", "getMerge", "getMergesInZone", "isSingleCellOrMerge", "isMainCellPosition"];
     private nextId;
     readonly merges: Record<UID, Record<number, Range | undefined> | undefined>;
     readonly mergeCellMap: Record<UID, SheetMergeCellMap | undefined>;
     allowDispatch(cmd: CoreCommand): CommandResult | CommandResult[];
     handle(cmd: CoreCommand): void;
-    adaptRanges(applyChange: ApplyRangeChange, sheetId: UID): void;
+    adaptRanges(rangeAdapters: RangeAdapterFunctions, sheetId: UID): void;
     getMerges(sheetId: UID): Merge[];
     getMerge({ sheetId, col, row }: CellPosition): Merge | undefined;
     getMergesInZone(sheetId: UID, zone: Zone): Merge[];
-    /**
-     * Same as `getRangeString` but add all necessary merge to the range to make it a valid selection
-     */
-    getSelectionRangeString(range: Range, forSheetId: UID): string;
     /**
      * Return true if the zone intersects an existing merge:
      * if they have at least a common cell
@@ -1348,20 +1353,28 @@ interface PivotStyle {
     displayTotals?: boolean;
     displayColumnHeaders?: boolean;
     displayMeasuresRow?: boolean;
+    tableStyleId?: string;
+    bandedRows?: boolean;
+    bandedColumns?: boolean;
+    hasFilters?: boolean;
 }
 
 interface Pivot$1 {
     definition: PivotCoreDefinition;
     formulaId: string;
 }
+interface MeasureState {
+    formula: RangeCompiledFormula;
+    dependencies: Range[];
+}
 interface CoreState {
     nextFormulaId: number;
     pivots: Record<UID, Pivot$1 | undefined>;
     formulaIds: Record<UID, string | undefined>;
-    compiledMeasureFormulas: Record<UID, Record<string, RangeCompiledFormula | undefined>>;
+    compiledMeasureFormulas: Record<UID, Record<string, MeasureState | undefined>>;
 }
 declare class PivotCorePlugin extends CorePlugin<CoreState> implements CoreState {
-    static getters: readonly ["getPivotCoreDefinition", "getPivotDisplayName", "getPivotId", "getPivotFormulaId", "getPivotIds", "getMeasureCompiledFormula", "getPivotName", "isExistingPivot"];
+    static getters: readonly ["getPivotCoreDefinition", "getPivotDisplayName", "getPivotId", "getPivotFormulaId", "getPivotIds", "getMeasureCompiledFormula", "getPivotName", "isExistingPivot", "getMeasureFullDependencies"];
     readonly nextFormulaId: number;
     readonly pivots: {
         [pivotId: UID]: Pivot$1 | undefined;
@@ -1369,10 +1382,10 @@ declare class PivotCorePlugin extends CorePlugin<CoreState> implements CoreState
     readonly formulaIds: {
         [formulaId: UID]: UID | undefined;
     };
-    readonly compiledMeasureFormulas: Record<UID, Record<string, RangeCompiledFormula>>;
+    readonly compiledMeasureFormulas: Record<UID, Record<string, MeasureState>>;
     allowDispatch(cmd: CoreCommand): CommandResult | CommandResult[];
     handle(cmd: CoreCommand): void;
-    adaptRanges(applyChange: ApplyRangeChange): void;
+    adaptRanges({ applyChange, adaptFormulaString }: RangeAdapterFunctions): void;
     getPivotDisplayName(pivotId: UID): string;
     getPivotName(pivotId: UID): string;
     /**
@@ -1388,9 +1401,11 @@ declare class PivotCorePlugin extends CorePlugin<CoreState> implements CoreState
     getPivotFormulaId(pivotId: UID): string;
     getPivotIds(): UID[];
     isExistingPivot(pivotId: UID): boolean;
-    getMeasureCompiledFormula(measure: PivotCoreMeasure): RangeCompiledFormula;
+    getMeasureCompiledFormula(pivotId: UID, measure: PivotCoreMeasure): RangeCompiledFormula;
+    getMeasureFullDependencies(pivotId: UID, measure: PivotCoreMeasure): Range[];
     private addPivot;
     private compileCalculatedMeasures;
+    private computeMeasureFullDependencies;
     private insertPivot;
     private resizeSheet;
     private getPivotCore;
@@ -1409,12 +1424,12 @@ declare class PivotCorePlugin extends CorePlugin<CoreState> implements CoreState
     export(data: WorkbookData): void;
 }
 
-declare class RangeAdapter$1 implements CommandHandler<CoreCommand> {
+declare class RangeAdapterPlugin implements CommandHandler<CoreCommand> {
     private getters;
     private providers;
     private isAdaptingRanges;
     constructor(getters: CoreGetters);
-    static getters: readonly ["adaptFormulaStringDependencies", "copyFormulaStringForSheet", "extendRange", "getRangeString", "getRangeFromSheetXC", "createAdaptedRanges", "getRangeData", "getRangeDataFromXc", "getRangeDataFromZone", "getRangeFromRangeData", "getRangeFromZone", "getRangesUnion", "recomputeRanges", "isRangeValid", "removeRangesSheetPrefix"];
+    static getters: readonly ["copyFormulaStringForSheet", "extendRange", "getRangeString", "getRangeFromSheetXC", "createAdaptedRanges", "getRangeData", "getRangeDataFromXc", "getRangeDataFromZone", "getRangeFromRangeData", "getRangeFromZone", "getRangesUnion", "recomputeRanges", "isRangeValid", "removeRangesSheetPrefix"];
     allowDispatch(cmd: CoreCommand): CommandResult;
     beforeHandle(command: Command): void;
     handle(cmd: CoreCommand): void;
@@ -1471,7 +1486,6 @@ declare class RangeAdapter$1 implements CommandHandler<CoreCommand> {
     getRangeFromRangeData(data: RangeData): Range;
     isRangeValid(rangeStr: string): boolean;
     getRangesUnion(ranges: Range[]): Range;
-    adaptFormulaStringDependencies(sheetId: UID, formula: string, applyChange: ApplyRangeChange): string;
     /**
      * Copy a formula string to another sheet.
      *
@@ -1497,14 +1511,14 @@ interface SheetState {
     readonly sheets: Record<UID, Sheet | undefined>;
     readonly orderedSheetIds: UID[];
     readonly sheetIdsMapName: Record<string, UID | undefined>;
-    readonly cellPosition: Record<UID, CellPosition | undefined>;
+    readonly cellPosition: Record<number, CellPosition | undefined>;
 }
 declare class SheetPlugin extends CorePlugin<SheetState> implements SheetState {
-    static getters: readonly ["getSheetName", "tryGetSheetName", "getSheet", "tryGetSheet", "getSheetIdByName", "getSheetIds", "getVisibleSheetIds", "isSheetVisible", "doesHeaderExist", "doesHeadersExist", "getCell", "getCellPosition", "getColsZone", "getRowCells", "getRowsZone", "getNumberCols", "getNumberRows", "getNumberHeaders", "getGridLinesVisibility", "getNextSheetName", "getSheetSize", "getSheetZone", "getPaneDivisions", "checkZonesExistInSheet", "getCommandZones", "getUnboundedZone", "checkElementsIncludeAllNonFrozenHeaders", "getDuplicateSheetName"];
+    static getters: readonly ["getSheetName", "tryGetSheetName", "getSheet", "tryGetSheet", "getSheetIdByName", "getSheetIds", "getVisibleSheetIds", "isSheetVisible", "doesHeaderExist", "doesHeadersExist", "getCell", "getCellPosition", "getColsZone", "getRowCellIds", "getRowsZone", "getNumberCols", "getNumberRows", "getNumberHeaders", "getGridLinesVisibility", "getNextSheetName", "getSheetSize", "getSheetZone", "getPaneDivisions", "checkZonesExistInSheet", "getCommandZones", "getUnboundedZone", "checkElementsIncludeAllNonFrozenHeaders", "getDuplicateSheetName", "tryGetCellPosition"];
     readonly sheetIdsMapName: Record<string, UID | undefined>;
     readonly orderedSheetIds: UID[];
     readonly sheets: Record<UID, Sheet | undefined>;
-    readonly cellPosition: Record<UID, CellPosition | undefined>;
+    readonly cellPosition: Record<number, CellPosition | undefined>;
     allowDispatch(cmd: CoreCommand): CommandResult | CommandResult[];
     beforeHandle(cmd: CoreCommand): void;
     handle(cmd: CoreCommand): void;
@@ -1531,9 +1545,10 @@ declare class SheetPlugin extends CorePlugin<SheetState> implements SheetState {
     doesHeadersExist(sheetId: UID, dimension: Dimension, headerIndexes: HeaderIndex[]): boolean;
     getCell({ sheetId, col, row }: CellPosition): Cell | undefined;
     getColsZone(sheetId: UID, start: HeaderIndex, end: HeaderIndex): Zone;
-    getRowCells(sheetId: UID, row: HeaderIndex): UID[];
+    getRowCellIds(sheetId: UID, row: HeaderIndex): number[];
     getRowsZone(sheetId: UID, start: HeaderIndex, end: HeaderIndex): Zone;
-    getCellPosition(cellId: UID): CellPosition;
+    getCellPosition(cellId: number): CellPosition;
+    tryGetCellPosition(cellId: number): CellPosition | undefined;
     getNumberCols(sheetId: UID): number;
     getNumberRows(sheetId: UID): number;
     getNumberHeaders(sheetId: UID, dimension: Dimension): HeaderIndex;
@@ -1652,7 +1667,7 @@ declare class StylePlugin extends CorePlugin<StylePluginState> implements StyleP
     readonly styles: Record<UID, ZoneStyle[] | undefined>;
     allowDispatch(cmd: CoreCommand): CommandResult | CommandResult[];
     handle(cmd: CoreCommand): void;
-    adaptRanges(applyChange: ApplyRangeChange, sheetId: UID): void;
+    adaptRanges({ applyChange }: RangeAdapterFunctions, sheetId: UID): void;
     private handleAddColumnn;
     private handleAddRows;
     private styleIsDefault;
@@ -1679,7 +1694,7 @@ declare class TablePlugin extends CorePlugin<TableState> implements TableState {
     static getters: readonly ["getCoreTable", "getCoreTables", "getCoreTableMatchingTopLeft"];
     readonly tables: Record<UID, Record<TableId, CoreTable | undefined>>;
     readonly nextTableId: number;
-    adaptRanges(applyChange: ApplyRangeChange, sheetId: UID): void;
+    adaptRanges({ applyChange }: RangeAdapterFunctions, sheetId: UID): void;
     allowDispatch(cmd: CoreCommand): CommandResult | CommandResult[];
     handle(cmd: CoreCommand): void;
     getCoreTables(sheetId: UID): CoreTable[];
@@ -1779,7 +1794,7 @@ type PluginGetters<Plugin extends {
     new (...args: unknown[]): any;
     getters: readonly string[];
 }> = Pick<InstanceType<Plugin>, GetterNames<Plugin>>;
-type RangeAdapterGetters = Pick<RangeAdapter$1, GetterNames<typeof RangeAdapter$1>>;
+type RangeAdapterGetters = Pick<RangeAdapterPlugin, GetterNames<typeof RangeAdapterPlugin>>;
 type CoreGetters = PluginGetters<typeof SheetPlugin> & PluginGetters<typeof HeaderSizePlugin> & PluginGetters<typeof HeaderVisibilityPlugin> & PluginGetters<typeof CellPlugin> & PluginGetters<typeof StylePlugin> & PluginGetters<typeof MergePlugin> & PluginGetters<typeof BordersPlugin> & PluginGetters<typeof ChartPlugin> & PluginGetters<typeof ImagePlugin> & PluginGetters<typeof CarouselPlugin> & PluginGetters<typeof FigurePlugin> & RangeAdapterGetters & PluginGetters<typeof ConditionalFormatPlugin> & PluginGetters<typeof TablePlugin> & PluginGetters<typeof SettingsPlugin> & PluginGetters<typeof HeaderGroupingPlugin> & PluginGetters<typeof DataValidationPlugin> & PluginGetters<typeof PivotCorePlugin>;
 
 type VerticalAxisPosition = "left" | "right";
@@ -2068,7 +2083,7 @@ declare class BasePlugin<State = any, C = any> implements CommandHandler<C>, Val
 interface CorePluginConfig {
     readonly getters: CoreGetters;
     readonly stateObserver: StateObserver;
-    readonly range: RangeAdapter$1;
+    readonly range: RangeAdapterPlugin;
     readonly dispatch: CoreCommandDispatcher["dispatch"];
     readonly canDispatch: CoreCommandDispatcher["dispatch"];
     readonly custom: ModelConfig["custom"];
@@ -2098,7 +2113,7 @@ declare class CorePlugin<State = any> extends BasePlugin<State, CoreCommand> imp
      * @param sheetId an sheetId to adapt either range of that sheet specifically, or ranges pointing to that sheet
      * @param sheetName couple of old and new sheet names to adapt ranges pointing to that sheet
      */
-    adaptRanges(applyChange: ApplyRangeChange, sheetId: UID, sheetName: AdaptSheetName): void;
+    adaptRanges(rangeAdapterFunctions: RangeAdapterFunctions, sheetId: UID, sheetName: AdaptSheetName): void;
 }
 
 type ZoneBorderData = {
@@ -2122,7 +2137,7 @@ declare class BordersPlugin extends CorePlugin<BordersPluginState> implements Bo
     allowDispatch(cmd: CoreCommand): CommandResult | CommandResult[];
     handle(cmd: CoreCommand): void;
     beforeHandle(cmd: CoreCommand): void;
-    adaptRanges(applyChange: ApplyRangeChange, sheetId: UID): void;
+    adaptRanges({ applyChange }: RangeAdapterFunctions, sheetId: UID): void;
     private onRowRemove;
     private onColRemove;
     getCellBorder(position: CellPosition): Border;
@@ -2665,6 +2680,9 @@ declare class DynamicTablesPlugin extends CoreViewPlugin {
     handle(cmd: Command): void;
     finalize(): void;
     private computeTables;
+    private getDynamicTables;
+    private getTablesFromPivots;
+    private getTableConfigFromPivotStyle;
     getFilters(sheetId: UID): Filter[];
     getTables(sheetId: UID): Table[];
     getFilter(position: CellPosition): Filter | undefined;
@@ -2790,6 +2808,13 @@ declare class EvaluationDataValidationPlugin extends CoreViewPlugin {
     private getEvaluatedCriterionValues;
 }
 
+declare class FormulaTrackerPlugin extends CoreViewPlugin {
+    static getters: readonly ["getCellsWithTrackedFormula"];
+    private trackedCells;
+    handle(cmd: Command): void;
+    getCellsWithTrackedFormula(formula: string): number[];
+}
+
 type Canvas2DContext = CanvasRenderingContext2D | OffscreenCanvasRenderingContext2D;
 
 interface HeaderSizeState {
@@ -2938,6 +2963,12 @@ declare class SpreadsheetPivotTable {
         field: string;
         value: CellValue;
     }[][];
+    getPivotTableDimensions(pivotStyle: Required<PivotStyle>): {
+        numberOfCols: number;
+        numberOfRows: number;
+        numberOfHeaderRows: number;
+    };
+    getNumberOfRowGroupBys(): number;
 }
 
 interface InitPivotParams {
@@ -2970,7 +3001,7 @@ interface Pivot<T = PivotRuntimeDefinition> {
 }
 
 declare class PivotUIPlugin extends CoreViewPlugin {
-    static getters: readonly ["getPivot", "getFirstPivotFunction", "getPivotCellSortDirection", "getPivotIdFromPosition", "getPivotCellFromPosition", "generateNewCalculatedMeasureName", "isPivotUnused", "isSpillPivotFormula"];
+    static getters: readonly ["getPivot", "getFirstPivotFunction", "getPivotCellSortDirection", "getPivotIdFromPosition", "getPivotCellFromPosition", "generateNewCalculatedMeasureName", "isPivotUnused", "isSpillPivotFormula", "getAllPivotArrayFormulas", "getPivotStyleAtPosition"];
     private pivots;
     private unusedPivotsInFormulas?;
     private custom;
@@ -3013,6 +3044,16 @@ declare class PivotUIPlugin extends CoreViewPlugin {
         recreate: boolean;
     }): void;
     private _getUnusedPivotsInFormulas;
+    getAllPivotArrayFormulas(): {
+        position: CellPosition;
+        pivotStyle: Required<PivotStyle>;
+        pivotId: UID;
+    }[];
+    getPivotStyleAtPosition(position: CellPosition): {
+        pivotStyle: Required<PivotStyle>;
+        pivotId: UID;
+    } | undefined;
+    private isMainFunctionPivotSpreadFunction;
 }
 
 /**
@@ -3452,7 +3493,6 @@ declare class SplitToColumnsPlugin extends UIPlugin {
 }
 
 declare class SubtotalEvaluationPlugin extends UIPlugin {
-    private subtotalCells;
     handle(cmd: Command): void;
 }
 
@@ -3466,6 +3506,7 @@ declare class TableComputedStylePlugin extends UIPlugin {
     getCellTableBorder(position: CellPosition): Border | undefined;
     getCellTableBorderZone(sheetId: UID, zone: Zone): PositionMap<Border>;
     private computeTableStyle;
+    private getTableMetaData;
     /**
      * Get the actual table config that will be used to compute the table style. It is different from
      * the config of the table because of hidden rows and columns in the sheet. For example remove the
@@ -3605,6 +3646,9 @@ declare class ClipboardPlugin extends UIPlugin {
     constructor(config: UIPluginConfig);
     allowDispatch(cmd: LocalCommand): CommandResult;
     handle(cmd: Command): void;
+    private getCopiedDataAbove;
+    private getCopiedDataOnLeft;
+    private getCopiedDataAboveOnLeft;
     private convertTextToClipboardData;
     private selectClipboardHandlers;
     private isCutAllowedOn;
@@ -3700,7 +3744,7 @@ declare class HeaderPositionsUIPlugin extends UIPlugin {
  */
 declare class GridSelectionPlugin extends UIPlugin {
     static layers: readonly ["Selection"];
-    static getters: readonly ["getActiveSheet", "getActiveSheetId", "getActiveSheetName", "getActiveCell", "getActiveCols", "getActiveRows", "getCurrentStyle", "getSelectedZones", "getSelectedZone", "getSelectedCells", "getSelectedFigureId", "getSelection", "getActivePosition", "getSheetPosition", "isSingleColSelected", "getElementsFromSelection", "tryGetActiveSheetId", "isGridSelectionActive", "getSelectecUnboundedZone"];
+    static getters: readonly ["getActiveSheet", "getActiveSheetId", "getActiveSheetName", "getActiveCell", "getActiveCols", "getActiveRows", "getCurrentStyle", "getSelectedZones", "getSelectedZone", "getSelectedCells", "getSelectedFigureId", "getSelection", "getActivePosition", "getSheetPosition", "isSingleColSelected", "getElementsFromSelection", "tryGetActiveSheetId", "isGridSelectionActive", "getSelectecUnboundedZone", "getSelectionRangeString"];
     private gridSelection;
     private selectedFigureId;
     private sheetsData;
@@ -3741,6 +3785,12 @@ declare class GridSelectionPlugin extends UIPlugin {
      * if dimension === "ROW" => [2,3,4,5]
      */
     getElementsFromSelection(dimension: Dimension): number[];
+    /**
+     * Same as `getRangeString` but add:
+     * - all necessary merge to the range to make it a valid selection
+     * - the "#" suffix if the range is a spilled reference
+     */
+    getSelectionRangeString(range: Range, forSheetId: UID): string;
     private activateSheet;
     /**
      * Ensure selections are not outside sheet boundaries.
@@ -4057,7 +4107,7 @@ declare class SheetViewPlugin extends UIPlugin {
 type Getters = {
     isReadonly: () => boolean;
     isDashboard: () => boolean;
-} & CoreGetters & PluginGetters<typeof AutofillPlugin> & PluginGetters<typeof AutomaticSumPlugin> & PluginGetters<typeof HistoryPlugin> & PluginGetters<typeof ClipboardPlugin> & PluginGetters<typeof EvaluationPlugin> & PluginGetters<typeof EvaluationChartPlugin> & PluginGetters<typeof EvaluationConditionalFormatPlugin> & PluginGetters<typeof HeaderVisibilityUIPlugin> & PluginGetters<typeof CustomColorsPlugin> & PluginGetters<typeof AutomaticSumPlugin> & PluginGetters<typeof GridSelectionPlugin> & PluginGetters<typeof CollaborativePlugin> & PluginGetters<typeof SortPlugin> & PluginGetters<typeof UIOptionsPlugin> & PluginGetters<typeof SheetUIPlugin> & PluginGetters<typeof SheetViewPlugin> & PluginGetters<typeof FilterEvaluationPlugin> & PluginGetters<typeof SplitToColumnsPlugin> & PluginGetters<typeof SubtotalEvaluationPlugin> & PluginGetters<typeof HeaderSizeUIPlugin> & PluginGetters<typeof EvaluationDataValidationPlugin> & PluginGetters<typeof HeaderPositionsUIPlugin> & PluginGetters<typeof TableStylePlugin> & PluginGetters<typeof CellComputedStylePlugin> & PluginGetters<typeof DynamicTablesPlugin> & PluginGetters<typeof PivotUIPlugin> & PluginGetters<typeof TableComputedStylePlugin> & PluginGetters<typeof GeoFeaturePlugin> & PluginGetters<typeof PivotPresencePlugin> & PluginGetters<typeof TableComputedStylePlugin> & PluginGetters<typeof CheckboxTogglePlugin> & PluginGetters<typeof CellIconPlugin> & PluginGetters<typeof DynamicTranslate> & PluginGetters<typeof CarouselUIPlugin>;
+} & CoreGetters & PluginGetters<typeof AutofillPlugin> & PluginGetters<typeof AutomaticSumPlugin> & PluginGetters<typeof HistoryPlugin> & PluginGetters<typeof ClipboardPlugin> & PluginGetters<typeof EvaluationPlugin> & PluginGetters<typeof EvaluationChartPlugin> & PluginGetters<typeof EvaluationConditionalFormatPlugin> & PluginGetters<typeof HeaderVisibilityUIPlugin> & PluginGetters<typeof CustomColorsPlugin> & PluginGetters<typeof AutomaticSumPlugin> & PluginGetters<typeof GridSelectionPlugin> & PluginGetters<typeof CollaborativePlugin> & PluginGetters<typeof SortPlugin> & PluginGetters<typeof UIOptionsPlugin> & PluginGetters<typeof SheetUIPlugin> & PluginGetters<typeof SheetViewPlugin> & PluginGetters<typeof FilterEvaluationPlugin> & PluginGetters<typeof SplitToColumnsPlugin> & PluginGetters<typeof SubtotalEvaluationPlugin> & PluginGetters<typeof HeaderSizeUIPlugin> & PluginGetters<typeof EvaluationDataValidationPlugin> & PluginGetters<typeof HeaderPositionsUIPlugin> & PluginGetters<typeof TableStylePlugin> & PluginGetters<typeof CellComputedStylePlugin> & PluginGetters<typeof DynamicTablesPlugin> & PluginGetters<typeof PivotUIPlugin> & PluginGetters<typeof TableComputedStylePlugin> & PluginGetters<typeof GeoFeaturePlugin> & PluginGetters<typeof PivotPresencePlugin> & PluginGetters<typeof TableComputedStylePlugin> & PluginGetters<typeof CheckboxTogglePlugin> & PluginGetters<typeof CellIconPlugin> & PluginGetters<typeof DynamicTranslate> & PluginGetters<typeof FormulaTrackerPlugin> & PluginGetters<typeof CarouselUIPlugin>;
 
 interface SearchOptions {
     matchCase: boolean;
@@ -4282,6 +4332,7 @@ declare function getUniqueText(text: string, texts: string[], options?: {
 }): string;
 declare function isFormula(content: string): boolean;
 declare function chartStyleToCellStyle(style: ChartStyle): Style;
+declare function doesCellContainFunction(cell: Cell, formula: string): boolean;
 
 /**
  * This function returns a regexp that is supposed to be as close as possible as the numberRegexp,
@@ -4657,7 +4708,6 @@ interface RenderingBox {
         center?: RenderingGridIcon;
     };
     textOpacity?: number;
-    skipCellGridLines?: boolean;
     disabledAnimation?: boolean;
 }
 type Box = RenderingBox & Rect;
@@ -5212,6 +5262,7 @@ interface ExcelChartDefinition {
         useRightAxis?: boolean;
     };
     readonly axesDesign?: AxesDesign;
+    readonly showValues?: boolean;
     readonly horizontal?: boolean;
     readonly isDoughnut?: boolean;
     readonly pieHolePercentage?: number;
@@ -5314,7 +5365,7 @@ interface UpdateCellCommand extends PositionDependentCommand {
  */
 interface UpdateCellPositionCommand extends PositionDependentCommand {
     type: "UPDATE_CELL_POSITION";
-    cellId?: UID;
+    cellId?: number;
 }
 interface AddColumnsRowsCommand extends SheetDependentCommand, SheetEditingCommand {
     type: "ADD_COLUMNS_ROWS";
@@ -5702,6 +5753,9 @@ interface CopyPasteCellsAboveCommand {
 interface CopyPasteCellsOnLeftCommand {
     type: "COPY_PASTE_CELLS_ON_LEFT";
 }
+interface CopyPasteCellsOnZoneCommand {
+    type: "COPY_PASTE_CELLS_ON_ZONE";
+}
 interface RepeatPasteCommand {
     type: "REPEAT_PASTE";
     target: Zone[];
@@ -5744,7 +5798,7 @@ interface ActivateSheetCommand {
 }
 interface EvaluateCellsCommand {
     type: "EVALUATE_CELLS";
-    cellIds?: UID[];
+    cellIds?: number[];
 }
 interface EvaluateChartsCommand {
     type: "EVALUATE_CHARTS";
@@ -5950,7 +6004,7 @@ UpdateCellCommand | UpdateCellPositionCommand | ClearCellCommand | ClearCellsCom
  | UpdateLocaleCommand
 /** PIVOT */
  | AddPivotCommand | UpdatePivotCommand | InsertPivotCommand | RenamePivotCommand | RemovePivotCommand | DuplicatePivotCommand;
-type LocalCommand = RequestUndoCommand | RequestRedoCommand | UndoCommand | RedoCommand | CopyCommand | CutCommand | PasteCommand | CopyPasteCellsAboveCommand | CopyPasteCellsOnLeftCommand | RepeatPasteCommand | CleanClipBoardHighlightCommand | AutoFillCellCommand | PasteFromOSClipboardCommand | AutoresizeColumnsCommand | AutoresizeRowsCommand | MoveColumnsRowsCommand | ActivateSheetCommand | EvaluateCellsCommand | EvaluateChartsCommand | StartChangeHighlightCommand | StartCommand | AutofillCommand | AutofillSelectCommand | AutofillTableCommand | ShowFormulaCommand | AutofillAutoCommand | SelectFigureCommand | ReplaceSearchCommand | SortCommand | SetDecimalCommand | SetContextualFormatCommand | ResizeViewportCommand | SetZoomCommand | SumSelectionCommand | DeleteCellCommand | InsertCellCommand | SetViewportOffsetCommand | MoveViewportDownCommand | MoveViewportUpCommand | MoveViewportToCellCommand | ActivateNextSheetCommand | ActivatePreviousSheetCommand | UpdateFilterCommand | SplitTextIntoColumnsCommand | RemoveDuplicatesCommand | TrimWhitespaceCommand | ResizeTableCommand | RefreshPivotCommand | InsertNewPivotCommand | DuplicatePivotInNewSheetCommand | InsertPivotWithTableCommand | SplitPivotFormulaCommand | PaintFormat | DeleteUnfilteredContentCommand | PivotStartPresenceTracking | PivotStopPresenceTracking | ToggleCheckboxCommand | AddNewChartToCarouselCommand | AddFigureChartToCarouselCommand | DuplicateCarouselChartCommand | UpdateCarouselActiveItemCommand | PopOutChartFromCarouselCommand;
+type LocalCommand = RequestUndoCommand | RequestRedoCommand | UndoCommand | RedoCommand | CopyCommand | CutCommand | PasteCommand | CopyPasteCellsAboveCommand | CopyPasteCellsOnLeftCommand | CopyPasteCellsOnZoneCommand | RepeatPasteCommand | CleanClipBoardHighlightCommand | AutoFillCellCommand | PasteFromOSClipboardCommand | AutoresizeColumnsCommand | AutoresizeRowsCommand | MoveColumnsRowsCommand | ActivateSheetCommand | EvaluateCellsCommand | EvaluateChartsCommand | StartChangeHighlightCommand | StartCommand | AutofillCommand | AutofillSelectCommand | AutofillTableCommand | ShowFormulaCommand | AutofillAutoCommand | SelectFigureCommand | ReplaceSearchCommand | SortCommand | SetDecimalCommand | SetContextualFormatCommand | ResizeViewportCommand | SetZoomCommand | SumSelectionCommand | DeleteCellCommand | InsertCellCommand | SetViewportOffsetCommand | MoveViewportDownCommand | MoveViewportUpCommand | MoveViewportToCellCommand | ActivateNextSheetCommand | ActivatePreviousSheetCommand | UpdateFilterCommand | SplitTextIntoColumnsCommand | RemoveDuplicatesCommand | TrimWhitespaceCommand | ResizeTableCommand | RefreshPivotCommand | InsertNewPivotCommand | DuplicatePivotInNewSheetCommand | InsertPivotWithTableCommand | SplitPivotFormulaCommand | PaintFormat | DeleteUnfilteredContentCommand | PivotStartPresenceTracking | PivotStopPresenceTracking | ToggleCheckboxCommand | AddNewChartToCarouselCommand | AddFigureChartToCarouselCommand | DuplicateCarouselChartCommand | UpdateCarouselActiveItemCommand | PopOutChartFromCarouselCommand;
 type Command = CoreCommand | LocalCommand;
 /**
  * Holds the result of a command dispatch.
@@ -6219,6 +6273,7 @@ interface Style {
     textColor?: Color;
     fontSize?: number;
     rotation?: number;
+    hideGridLines?: boolean;
 }
 interface DataBarFill {
     color: Color;
@@ -6308,7 +6363,7 @@ interface HeaderDimensions {
     end: Pixel;
 }
 interface Row {
-    cells: Record<number, UID | undefined>;
+    cells: Record<number, number | undefined>;
 }
 interface Position {
     col: HeaderIndex;
@@ -6346,13 +6401,15 @@ declare const enum DIRECTION {
     RIGHT = "right"
 }
 type ChangeType = "REMOVE" | "RESIZE" | "MOVE" | "CHANGE" | "NONE";
-type ApplyRangeChangeResult = {
-    changeType: Exclude<ChangeType, "NONE">;
-    range: Range;
-} | {
-    changeType: "NONE";
+type ApplyRangeChangeResult<T> = {
+    changeType: ChangeType;
+    range: T;
 };
-type ApplyRangeChange = (range: Range) => ApplyRangeChangeResult;
+type ApplyFormulaRangeChangeResult = {
+    changeType: ChangeType;
+    formula: string;
+};
+type ApplyRangeChange = (range: Range) => ApplyRangeChangeResult<Range>;
 type AdaptSheetName = {
     old: string;
     current: string;
@@ -6362,10 +6419,15 @@ type RangeAdapter = {
     sheetName: AdaptSheetName;
     applyChange: ApplyRangeChange;
 };
+type RangeAdapterFunctions = {
+    applyChange: ApplyRangeChange;
+    adaptRangeString: (defaultSheetId: UID, sheetXC: string) => ApplyRangeChangeResult<string>;
+    adaptFormulaString: (defaultSheetId: UID, formula: string) => string;
+};
 type Dimension = "COL" | "ROW";
 type ConsecutiveIndexes = HeaderIndex[];
 interface RangeProvider {
-    adaptRanges: (applyChange: ApplyRangeChange, sheetId: UID, sheetName: AdaptSheetName) => void;
+    adaptRanges: (adapterFunctions: RangeAdapterFunctions, sheetId: UID, sheetName: AdaptSheetName) => void;
 }
 type Validation<T> = (toValidate: T) => CommandResult | CommandResult[];
 type Increment = 1 | -1 | 0;
@@ -6441,6 +6503,7 @@ type SortDirection = "asc" | "desc";
 interface ValueAndLabel<T = string> {
     value: T;
     label: string;
+    separator?: boolean;
 }
 
 declare const OPERATOR_MAP: {
@@ -6461,6 +6524,7 @@ declare const UNARY_OPERATOR_MAP: {
     "-": string;
     "+": string;
     "%": string;
+    "#": string;
 };
 declare const functionCache: {
     [key: string]: FormulaToExecute;
@@ -6520,6 +6584,7 @@ interface ASTEmpty extends ASTBase {
 }
 type AST = ASTOperation | ASTUnaryOperation | ASTFuncall | ASTSymbol | ASTArray | ASTNumber | ASTBoolean | ASTString | ASTReference | ASTEmpty;
 declare const OP_PRIORITY: {
+    "#": number;
     "%": number;
     "^": number;
     "*": number;
@@ -6720,4 +6785,4 @@ declare class NumberTooLargeError extends EvaluationError {
 
 declare const __info__: {};
 
-export { AST, ASTFuncall, ASTOperation, ASTString, ASTSymbol, ASTUnaryOperation, AdaptSheetName, AdjacentEdge, Alias, Align, AnchorZone, ApplyRangeChange, ApplyRangeChangeResult, Arg, BadExpressionError, BasePlugin, Border, BorderData, BorderDescr, BorderDescrWithOpacity, BorderPosition, BorderStyle, Box, BoxTextContent, CSSProperties, CellErrorType, CellPosition, CellValue, ChangeType, CircularDependencyError, ClipboardCell, Cloneable, Color, CompiledFormula, ComposerFocusType, ConsecutiveIndexes, CoreGetters, CreateRevisionOptions, DEFAULT_LOCALE, DEFAULT_LOCALES, DIRECTION, DOMCoordinates, DOMDimension, DataBarFill, DebouncedFunction, Dimension, Direction, DivisionByZeroError, EdgeScrollInfo, EditionMode, EnsureRange, ErrorValue, EvaluationError, FilterId, Format, FormulaToExecute, FunctionCode, FunctionCodeBuilder, FunctionRegistry, FunctionResultNumber, FunctionResultObject, GetSymbolValue, GlobalChart, GridClickModifiers, GridRenderingContext, HSLA, HeaderDimensions, HeaderGroup, HeaderIndex, Highlight, HistoryChange, Image, Immutable, Increment, InvalidReferenceError, LayerName, Lazy, Link, Locale, LocaleCode, Matrix, Maybe, MenuMouseEvent, Merge, Model, NotAvailableError, NumberTooLargeError, OPERATOR_MAP, OP_PRIORITY, Offset, OperationSequenceNode, OrderedLayers, POSTFIX_UNARY_OPERATORS, PaneDivision, Pixel, PixelPosition, PluginGetters, Position, RGBA, RangeAdapter, RangeCompiledFormula, RangeProvider, Rect, Ref, ReferenceDenormalizer, Registry, RenderingBorder, RenderingBox, RenderingGridIcon, Row, Scope, ScrollDirection, Selection, SelectionStep, SetDecimalStep, Sheet, SheetDOMScrollInfo, SortDirection, SortOptions, SplillBlockedError, SpreadsheetClipboardData, StateObserver, Style, TableId, Token, TokenizingChars, Transformation, TransformationFactory, TranslationFunction, UID, UNARY_OPERATOR_MAP, UnboundedZone, UnknownFunctionError, UpdateCellData, UuidGenerator, Validation, Validator, ValueAndLabel, VerticalAlign, Viewport, WorkbookHistory, Wrapping, Zone, ZoneDimension, __info__, _t, addRenderingLayer, batched, borderStyles, buildSheetLink, categories, cellReference, chartStyleToCellStyle, clip, compile, compileTokens, concat, convertAstNodes, createEmptyStructure, debounce, deepCopy, deepEquals, deepEqualsArray, errorTypes, escapeRegExp, findNextDefinedValue, functionCache, getAddHeaderStartIndex, getCanonicalSymbolName, getFormulaNumberRegex, getFullReference, getSearchRegex, getUniqueText, getUnquotedSheetName, groupConsecutive, includesAll, insertItemsAtIndex, isBoolean, isColHeader, isColReference, isConsecutive, isDefined, isFormula, isMarkdownLink, isMatrix, isNotNull, isNumber, isNumberBetween, isObjectEmptyRecursive, isRowHeader, isRowReference, isSheetUrl, isSingleCellReference, isWebLink, iterateAstNodes, largeMax, largeMin, lazy, linkNext, loopThroughReferenceType, mapAst, markdownLink, memoize, parse, parseMarkdownLink, parseNumber, parseSheetUrl, parseTokens, percentile, range, rangeReference, rangeTokenize, removeDuplicates, removeFalsyAttributes, removeIndexesFromArray, replaceItemAtIndex, replaceNewLines, sanitizeSheetName, setDefaultTranslationMethod, setTranslationMethod, setXcToFixedReferenceType, specialWhiteSpaceRegexp, splitReference, tokenize, transpose2dPOJO, trimContent, unquote, whiteSpaceCharacters };
+export { AST, ASTFuncall, ASTOperation, ASTString, ASTSymbol, ASTUnaryOperation, AdaptSheetName, AdjacentEdge, Alias, Align, AnchorZone, ApplyFormulaRangeChangeResult, ApplyRangeChange, ApplyRangeChangeResult, Arg, BadExpressionError, BasePlugin, Border, BorderData, BorderDescr, BorderDescrWithOpacity, BorderPosition, BorderStyle, Box, BoxTextContent, CSSProperties, CellErrorType, CellPosition, CellValue, ChangeType, CircularDependencyError, ClipboardCell, Cloneable, Color, CompiledFormula, ComposerFocusType, ConsecutiveIndexes, CoreGetters, CreateRevisionOptions, DEFAULT_LOCALE, DEFAULT_LOCALES, DIRECTION, DOMCoordinates, DOMDimension, DataBarFill, DebouncedFunction, Dimension, Direction, DivisionByZeroError, EdgeScrollInfo, EditionMode, EnsureRange, ErrorValue, EvaluationError, FilterId, Format, FormulaToExecute, FunctionCode, FunctionCodeBuilder, FunctionRegistry, FunctionResultNumber, FunctionResultObject, GetSymbolValue, GlobalChart, GridClickModifiers, GridRenderingContext, HSLA, HeaderDimensions, HeaderGroup, HeaderIndex, Highlight, HistoryChange, Image, Immutable, Increment, InvalidReferenceError, LayerName, Lazy, Link, Locale, LocaleCode, Matrix, Maybe, MenuMouseEvent, Merge, Model, NotAvailableError, NumberTooLargeError, OPERATOR_MAP, OP_PRIORITY, Offset, OperationSequenceNode, OrderedLayers, POSTFIX_UNARY_OPERATORS, PaneDivision, Pixel, PixelPosition, PluginGetters, Position, RGBA, RangeAdapter, RangeAdapterFunctions, RangeCompiledFormula, RangeProvider, Rect, Ref, ReferenceDenormalizer, Registry, RenderingBorder, RenderingBox, RenderingGridIcon, Row, Scope, ScrollDirection, Selection, SelectionStep, SetDecimalStep, Sheet, SheetDOMScrollInfo, SortDirection, SortOptions, SplillBlockedError, SpreadsheetClipboardData, StateObserver, Style, TableId, Token, TokenizingChars, Transformation, TransformationFactory, TranslationFunction, UID, UNARY_OPERATOR_MAP, UnboundedZone, UnknownFunctionError, UpdateCellData, UuidGenerator, Validation, Validator, ValueAndLabel, VerticalAlign, Viewport, WorkbookHistory, Wrapping, Zone, ZoneDimension, __info__, _t, addRenderingLayer, batched, borderStyles, buildSheetLink, categories, cellReference, chartStyleToCellStyle, clip, compile, compileTokens, concat, convertAstNodes, createEmptyStructure, debounce, deepCopy, deepEquals, deepEqualsArray, doesCellContainFunction, errorTypes, escapeRegExp, findNextDefinedValue, functionCache, getAddHeaderStartIndex, getCanonicalSymbolName, getFormulaNumberRegex, getFullReference, getSearchRegex, getUniqueText, getUnquotedSheetName, groupConsecutive, includesAll, insertItemsAtIndex, isBoolean, isColHeader, isColReference, isConsecutive, isDefined, isFormula, isMarkdownLink, isMatrix, isNotNull, isNumber, isNumberBetween, isObjectEmptyRecursive, isRowHeader, isRowReference, isSheetUrl, isSingleCellReference, isWebLink, iterateAstNodes, largeMax, largeMin, lazy, linkNext, loopThroughReferenceType, mapAst, markdownLink, memoize, parse, parseMarkdownLink, parseNumber, parseSheetUrl, parseTokens, percentile, range, rangeReference, rangeTokenize, removeDuplicates, removeFalsyAttributes, removeIndexesFromArray, replaceItemAtIndex, replaceNewLines, sanitizeSheetName, setDefaultTranslationMethod, setTranslationMethod, setXcToFixedReferenceType, specialWhiteSpaceRegexp, splitReference, tokenize, transpose2dPOJO, trimContent, unquote, whiteSpaceCharacters };