@odoo/o-spreadsheet 19.1.0-alpha.8 → 19.1.1

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

@@ -1,3 +1,4 @@
+import * as ChartJs from 'chart.js';
 import { ChartConfiguration, CoreChartOptions, Scriptable, Color as Color$1, ScriptableContext, FontSpec } from 'chart.js';
 
 /**
@@ -48,7 +49,6 @@ interface CellAttributes {
      * Raw cell content
      */
     readonly content: string;
-    readonly style?: Style;
     readonly format?: Format;
 }
 interface LiteralCell extends CellAttributes {
@@ -121,7 +121,7 @@ declare enum CellValueType {
  * formulas.
  */
 declare const POSTFIX_UNARY_OPERATORS: string[];
-type TokenType = "OPERATOR" | "NUMBER" | "STRING" | "SYMBOL" | "SPACE" | "DEBUGGER" | "ARG_SEPARATOR" | "LEFT_PAREN" | "RIGHT_PAREN" | "REFERENCE" | "INVALID_REFERENCE" | "UNKNOWN";
+type TokenType = "OPERATOR" | "NUMBER" | "STRING" | "SYMBOL" | "SPACE" | "DEBUGGER" | "ARG_SEPARATOR" | "ARRAY_ROW_SEPARATOR" | "LEFT_PAREN" | "RIGHT_PAREN" | "LEFT_BRACE" | "RIGHT_BRACE" | "REFERENCE" | "INVALID_REFERENCE" | "UNKNOWN";
 interface Token {
     readonly type: TokenType;
     readonly value: string;
@@ -135,8 +135,8 @@ interface BarChartDefinition extends CommonChartDefinition {
     readonly zoomable?: boolean;
 }
 type BarChartRuntime = {
-    chartJsConfig: ChartConfiguration;
-    masterChartConfig?: ChartConfiguration;
+    chartJsConfig: ChartConfiguration<"bar" | "line">;
+    masterChartConfig?: ChartConfiguration<"bar">;
     background: Color;
 };
 
@@ -424,7 +424,7 @@ interface CoreState$1 {
  * cell and sheet content.
  */
 declare class CellPlugin extends CorePlugin<CoreState$1> implements CoreState$1 {
-    static getters: readonly ["zoneToXC", "getCells", "getTranslatedCellFormula", "getCellStyle", "getCellById", "getFormulaString", "getFormulaMovedInSheet"];
+    static getters: readonly ["zoneToXC", "getCells", "getTranslatedCellFormula", "getCellById", "getFormulaString", "getFormulaMovedInSheet"];
     readonly nextId = 1;
     readonly cells: {
         [sheetId: string]: {
@@ -448,14 +448,13 @@ declare class CellPlugin extends CorePlugin<CoreState$1> implements CoreState$1
      */
     private clearCells;
     /**
-     * Copy the style of the reference column/row to the new columns/rows.
+     * Copy the format of the reference column/row to the new columns/rows.
      */
     private handleAddColumnsRows;
     import(data: WorkbookData): void;
     export(data: WorkbookData): void;
-    importCell(sheetId: UID, content?: string, style?: Style, format?: Format): Cell;
+    importCell(sheetId: UID, content?: string, format?: Format): Cell;
     exportForExcel(data: ExcelWorkbookData): void;
-    private removeDefaultStyleValues;
     getCells(sheetId: UID): Record<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
@@ -465,7 +464,6 @@ declare class CellPlugin extends CorePlugin<CoreState$1> implements CoreState$1
     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;
-    getCellStyle(position: CellPosition): Style;
     /**
      * Converts a zone to a XC coordinate system
      *
@@ -483,17 +481,16 @@ declare class CellPlugin extends CorePlugin<CoreState$1> implements CoreState$1
      * {top:1,left:0,right:1,bottom:3} ==> A1:A5
      */
     zoneToXC(sheetId: UID, zone: Zone, fixedParts?: RangePart[]): string;
-    private setStyle;
     /**
-     * Copy the style of one column to other columns.
+     * Copy the format of one column to other columns.
      */
-    private copyColumnStyle;
+    private copyColumnFormat;
     /**
-     * Copy the style of one row to other rows.
+     * Copy the format of one row to other rows.
      */
-    private copyRowStyle;
+    private copyRowFormat;
     /**
-     * gets the currently used style/border of a cell based on it's coordinates
+     * gets the currently used style and format of a cell based on it's coordinates
      */
     private getFormat;
     private getNextUid;
@@ -648,6 +645,7 @@ interface CellIsRule extends SingleColorRule {
     type: "CellIsRule";
     operator: ConditionalFormattingOperatorValues;
     values: string[];
+    dateValue?: DateCriterionValue;
 }
 type ThresholdType = "value" | "number" | "percentage" | "percentile" | "formula";
 type ColorScaleThreshold = {
@@ -690,7 +688,8 @@ interface IconSetRule {
     upperInflectionPoint: IconThreshold;
     lowerInflectionPoint: IconThreshold;
 }
-type ConditionalFormattingOperatorValues = "beginsWithText" | "isBetween" | "containsText" | "isEmpty" | "isNotEmpty" | "endsWithText" | "isEqual" | "isGreaterThan" | "isGreaterOrEqualTo" | "isLessThan" | "isLessOrEqualTo" | "isNotBetween" | "notContainsText" | "isNotEqual" | "customFormula";
+declare const cfOperators: readonly ["containsText", "notContainsText", "isGreaterThan", "isGreaterOrEqualTo", "isLessThan", "isLessOrEqualTo", "isBetween", "isNotBetween", "beginsWithText", "endsWithText", "isNotEmpty", "isEmpty", "isNotEqual", "isEqual", "customFormula", "dateIs", "dateIsBefore", "dateIsAfter", "dateIsOnOrBefore", "dateIsOnOrAfter"];
+type ConditionalFormattingOperatorValues = (typeof cfOperators)[number];
 
 interface ConditionalFormatState {
     readonly cfRules: {
@@ -1194,7 +1193,7 @@ declare class MergePlugin extends CorePlugin<MergeState> implements MergeState {
 }
 
 type Aggregator = "array_agg" | "count" | "count_distinct" | "bool_and" | "bool_or" | "max" | "min" | "avg" | "sum";
-type Granularity = "day" | "week" | "month" | "quarter" | "year" | "second_number" | "minute_number" | "hour_number" | "day_of_week" | "day_of_month" | "iso_week_number" | "month_number" | "quarter_number";
+type Granularity = "day" | "month" | "year" | "second_number" | "minute_number" | "hour_number" | "day_of_week" | "day_of_month" | "iso_week_number" | "month_number" | "quarter_number";
 interface PivotCoreDimension {
     fieldName: string;
     order?: SortDirection;
@@ -1412,6 +1411,7 @@ declare class PivotCorePlugin extends CorePlugin<CoreState> implements CoreState
 declare class RangeAdapter$1 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"];
     allowDispatch(cmd: CoreCommand): CommandResult;
@@ -1505,6 +1505,7 @@ declare class SheetPlugin extends CorePlugin<SheetState> implements SheetState {
     readonly sheets: Record<UID, Sheet | undefined>;
     readonly cellPosition: Record<UID, CellPosition | undefined>;
     allowDispatch(cmd: CoreCommand): CommandResult | CommandResult[];
+    beforeHandle(cmd: CoreCommand): void;
     handle(cmd: CoreCommand): void;
     import(data: WorkbookData): void;
     private exportSheets;
@@ -1638,6 +1639,37 @@ declare class SheetPlugin extends CorePlugin<SheetState> implements SheetState {
     private checkZonesAreInSheet;
 }
 
+type ZoneStyle = {
+    zone: UnboundedZone;
+    style: Style;
+};
+interface StylePluginState {
+    readonly styles: Record<UID, ZoneStyle[] | undefined>;
+}
+declare class StylePlugin extends CorePlugin<StylePluginState> implements StylePluginState {
+    static getters: readonly ["getCellStyle", "getCellStyleInZone", "getZoneStyles", "getStyleColors"];
+    readonly styles: Record<UID, ZoneStyle[] | undefined>;
+    allowDispatch(cmd: CoreCommand): CommandResult | CommandResult[];
+    handle(cmd: CoreCommand): void;
+    adaptRanges(applyChange: ApplyRangeChange, sheetId: UID): void;
+    private handleAddColumnn;
+    private handleAddRows;
+    private styleIsDefault;
+    private removeDefaultStyleValues;
+    private onMerge;
+    private setStyles;
+    private setStyle;
+    private clearStyle;
+    getCellStyle(cellPosition: CellPosition): Style | undefined;
+    getCellStyleInZone(sheetId: UID, zone: Zone): PositionMap<Style>;
+    getZoneStyles(sheetId: UID, zone: Zone): ZoneStyle[];
+    getStyleColors(sheetId: UID): Color[];
+    import(data: WorkbookData): void;
+    export(data: WorkbookData): void;
+    exportForExcel(data: ExcelWorkbookData): void;
+    private checkUselessSetFormatting;
+}
+
 interface TableState {
     tables: Record<UID, Record<TableId, CoreTable | undefined>>;
     nextTableId: number;
@@ -1747,7 +1779,7 @@ type PluginGetters<Plugin extends {
     getters: readonly string[];
 }> = Pick<InstanceType<Plugin>, GetterNames<Plugin>>;
 type RangeAdapterGetters = Pick<RangeAdapter$1, GetterNames<typeof RangeAdapter$1>>;
-type CoreGetters = PluginGetters<typeof SheetPlugin> & PluginGetters<typeof HeaderSizePlugin> & PluginGetters<typeof HeaderVisibilityPlugin> & PluginGetters<typeof CellPlugin> & 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 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";
 type LegendPosition = "top" | "bottom" | "left" | "right" | "none";
@@ -1764,29 +1796,17 @@ interface CommonChartDefinition {
     readonly humanize?: boolean;
 }
 
-interface GeoChartDefinition {
+interface GeoChartDefinition extends CommonChartDefinition {
     readonly type: "geo";
-    readonly dataSets: CustomizedDataSet[];
-    readonly dataSetsHaveTitle: boolean;
-    readonly labelRange?: string;
-    readonly title: TitleDesign;
-    readonly background?: Color;
-    readonly legendPosition: LegendPosition;
-    readonly colorScale?: GeoChartColorScale;
+    readonly colorScale?: ChartColorScale;
     readonly missingValueColor?: Color;
     readonly region?: string;
-    readonly humanize?: boolean;
+    readonly showColorBar?: boolean;
 }
 type GeoChartRuntime = {
     chartJsConfig: ChartConfiguration;
     background: Color;
 };
-interface GeoChartCustomColorScale {
-    minColor: Color;
-    midColor?: Color;
-    maxColor: Color;
-}
-type GeoChartColorScale = GeoChartCustomColorScale | "blues" | "cividis" | "greens" | "greys" | "oranges" | "purples" | "rainbow" | "reds" | "viridis";
 type GeoChartProjection = "azimuthalEqualArea" | "azimuthalEquidistant" | "gnomonic" | "orthographic" | "stereographic" | "equalEarth" | "albers" | "albersUsa" | "conicConformal" | "conicEqualArea" | "conicEquidistant" | "equirectangular" | "mercator" | "transverseMercator" | "naturalEarth1";
 interface GeoChartRegion {
     id: string;
@@ -2544,7 +2564,7 @@ declare class CoreViewPlugin<State = any> extends BasePlugin<State, Command> {
 }
 
 declare class EvaluationPlugin extends CoreViewPlugin {
-    static getters: readonly ["evaluateFormula", "evaluateFormulaResult", "evaluateCompiledFormula", "getCorrespondingFormulaCell", "getRangeFormattedValues", "getRangeValues", "getRangeFormats", "getEvaluatedCell", "getEvaluatedCells", "getEvaluatedCellsInZone", "getEvaluatedCellsPositions", "getSpreadZone", "getArrayFormulaSpreadingOn", "isEmpty"];
+    static getters: readonly ["evaluateFormula", "evaluateFormulaResult", "evaluateCompiledFormula", "getCorrespondingFormulaCell", "getRangeFormattedValues", "getRangeValues", "getRangeFormats", "getEvaluatedCell", "getEvaluatedCells", "getEvaluatedCellsInZone", "getEvaluatedCellsPositionInZone", "getEvaluatedCellsPositions", "getSpreadZone", "getArrayFormulaSpreadingOn", "isArrayFormulaSpillBlocked", "isEmpty"];
     private shouldRebuildDependenciesGraph;
     private evaluator;
     private positionsToUpdate;
@@ -2571,6 +2591,7 @@ declare class EvaluationPlugin extends CoreViewPlugin {
     getEvaluatedCells(sheetId: UID): EvaluatedCell[];
     getEvaluatedCellsPositions(sheetId: UID): CellPosition[];
     getEvaluatedCellsInZone(sheetId: UID, zone: Zone): EvaluatedCell[];
+    getEvaluatedCellsPositionInZone(sheetId: UID, zone: Zone): [CellPosition, EvaluatedCell][];
     /**
      * Return the spread zone the position is part of, if any
      */
@@ -2578,6 +2599,7 @@ declare class EvaluationPlugin extends CoreViewPlugin {
         ignoreSpillError: boolean;
     }): Zone | undefined;
     getArrayFormulaSpreadingOn(position: CellPosition): CellPosition | undefined;
+    isArrayFormulaSpillBlocked(position: CellPosition): boolean;
     /**
      * Check if a zone only contains empty cells
      */
@@ -2781,6 +2803,7 @@ declare class HeaderSizeUIPlugin extends CoreViewPlugin<HeaderSizeState> impleme
     getRowSize(sheetId: UID, row: HeaderIndex): Pixel;
     getMaxAnchorOffset(sheetId: UID, height: Pixel, width: Pixel): AnchorOffset;
     getHeaderSize(sheetId: UID, dimension: Dimension, index: HeaderIndex): Pixel;
+    private updateRowSizeForZoneChange;
     private updateRowSizeForCellChange;
     private initializeSheet;
     /**
@@ -2944,7 +2967,7 @@ interface Pivot<T = PivotRuntimeDefinition> {
 declare class PivotUIPlugin extends CoreViewPlugin {
     static getters: readonly ["getPivot", "getFirstPivotFunction", "getPivotCellSortDirection", "getPivotIdFromPosition", "getPivotCellFromPosition", "generateNewCalculatedMeasureName", "isPivotUnused", "isSpillPivotFormula"];
     private pivots;
-    private unusedPivots?;
+    private unusedPivotsInFormulas?;
     private custom;
     constructor(config: CoreViewPluginConfig);
     beforeHandle(cmd: Command): void;
@@ -2984,7 +3007,7 @@ declare class PivotUIPlugin extends CoreViewPlugin {
     setupPivot(pivotId: UID, { recreate }?: {
         recreate: boolean;
     }): void;
-    _getUnusedPivots(): UID[];
+    private _getUnusedPivotsInFormulas;
 }
 
 /**
@@ -3016,7 +3039,7 @@ type SelectionEventOptions = {
 interface SelectionEvent {
     anchor: AnchorZone;
     previousAnchor: AnchorZone;
-    mode: "newAnchor" | "overrideSelection" | "updateAnchor";
+    mode: "newAnchor" | "overrideSelection" | "updateAnchor" | "commitSelection";
     options: SelectionEventOptions;
 }
 
@@ -3026,6 +3049,7 @@ type StatefulStream<Event, State> = {
     resetDefaultAnchor: (owner: unknown, state: State) => void;
     resetAnchor: (owner: unknown, state: State) => void;
     observe: (owner: unknown, callbacks: StreamCallbacks<Event>) => void;
+    unobserve: (owner: unknown) => void;
     release: (owner: unknown) => void;
     getBackToDefault(): void;
 };
@@ -3044,6 +3068,7 @@ interface SelectionProcessor {
     selectAll(): DispatchResult;
     loopSelection(): DispatchResult;
     selectTableAroundSelection(): DispatchResult;
+    commitSelection(): DispatchResult;
     isListening(owner: unknown): boolean;
 }
 type SelectionStreamProcessor = SelectionProcessor & StatefulStream<SelectionEvent, AnchorZone>;
@@ -3244,8 +3269,8 @@ declare class CellComputedStylePlugin extends UIPlugin {
     handle(cmd: Command): void;
     getCellComputedBorder(position: CellPosition, precomputeZone?: Zone): Border | null;
     private precomputeCellBorders;
-    getCellComputedStyle(position: CellPosition): Style;
-    private computeCellStyle;
+    getCellComputedStyle(position: CellPosition, precomputeZone?: Zone): Style;
+    private precomputeCellStyle;
 }
 
 declare class CheckboxTogglePlugin extends UIPlugin {
@@ -3427,11 +3452,12 @@ declare class SubtotalEvaluationPlugin extends UIPlugin {
 }
 
 declare class TableComputedStylePlugin extends UIPlugin {
-    static getters: readonly ["getCellTableStyle", "getCellTableBorder", "getCellTableBorderZone"];
+    static getters: readonly ["getCellTableStyle", "getCellTableBorder", "getCellTableBorderZone", "getCellTableStyleZone"];
     private tableStyles;
     handle(cmd: Command): void;
     finalize(): void;
     getCellTableStyle(position: CellPosition): Style | undefined;
+    getCellTableStyleZone(sheetId: UID, zone: Zone): PositionMap<Style>;
     getCellTableBorder(position: CellPosition): Border | undefined;
     getCellTableBorderZone(sheetId: UID, zone: Zone): PositionMap<Border>;
     private computeTableStyle;
@@ -3455,12 +3481,16 @@ declare class UIOptionsPlugin extends UIPlugin {
 }
 
 declare class SheetUIPlugin extends UIPlugin {
-    static getters: readonly ["getCellWidth", "getTextWidth", "getCellText", "getCellMultiLineText", "getContiguousZone", "computeTextYCoordinate"];
+    static getters: readonly ["getCellWidth", "getTextWidth", "getCellText", "getCellMultiLineText", "getMultilineTextSize", "getContiguousZone", "computeTextYCoordinate"];
     private ctx;
     allowDispatch(cmd: LocalCommand): CommandResult | CommandResult[];
     handle(cmd: Command): void;
     getCellWidth(position: CellPosition): number;
     getTextWidth(text: string, style: Style): Pixel;
+    getMultilineTextSize(text: string[], style: Style): {
+        width: number;
+        height: number;
+    };
     getCellText(position: CellPosition, args?: {
         showFormula?: boolean;
         availableWidth?: number;
@@ -3515,6 +3545,7 @@ declare class CarouselUIPlugin extends UIPlugin {
     private fixWrongCarouselState;
     private addNewChartToCarousel;
     private addFigureChartToCarousel;
+    private duplicateCarouselChart;
     private getCarouselItemId;
 }
 
@@ -3863,7 +3894,7 @@ declare class InternalViewport {
  *
  */
 declare class SheetViewPlugin extends UIPlugin {
-    static getters: readonly ["getColIndex", "getRowIndex", "getActiveMainViewport", "getSheetViewDimension", "getSheetViewDimensionWithHeaders", "getMainViewportRect", "isVisibleInViewport", "getEdgeScrollCol", "getEdgeScrollRow", "getVisibleFigures", "getVisibleRect", "getVisibleRectWithoutHeaders", "getVisibleCellPositions", "getColRowOffsetInViewport", "getMainViewportCoordinates", "getActiveSheetScrollInfo", "getSheetViewVisibleCols", "getSheetViewVisibleRows", "getFrozenSheetViewRatio", "isPixelPositionVisible", "getColDimensionsInViewport", "getRowDimensionsInViewport", "getAllActiveViewportsZonesAndRect", "getRect", "getFigureUI", "getPositionAnchorOffset", "getGridOffset"];
+    static getters: readonly ["getColIndex", "getRowIndex", "getActiveMainViewport", "getSheetViewDimension", "getSheetViewDimensionWithHeaders", "getMainViewportRect", "isVisibleInViewport", "getEdgeScrollCol", "getEdgeScrollRow", "getVisibleFigures", "getVisibleRect", "getVisibleRectWithoutHeaders", "getVisibleRectWithZoom", "getVisibleCellPositions", "getColRowOffsetInViewport", "getMainViewportCoordinates", "getActiveSheetScrollInfo", "getSheetViewVisibleCols", "getSheetViewVisibleRows", "getFrozenSheetViewRatio", "isPixelPositionVisible", "getColDimensionsInViewport", "getRowDimensionsInViewport", "getAllActiveViewportsZonesAndRect", "getRect", "getFigureUI", "getPositionAnchorOffset", "getGridOffset", "getViewportZoomLevel", "getScrollBarWidth", "getMaximumSheetOffset"];
     private viewports;
     /**
      * The viewport dimensions are usually set by one of the components
@@ -3875,6 +3906,7 @@ declare class SheetViewPlugin extends UIPlugin {
     private sheetViewHeight;
     private gridOffsetX;
     private gridOffsetY;
+    private zoomLevel;
     private sheetsWithDirtyViewports;
     private shouldAdjustViewports;
     allowDispatch(cmd: LocalCommand): CommandResult | CommandResult[];
@@ -3914,18 +3946,26 @@ declare class SheetViewPlugin extends UIPlugin {
      * Return the main viewport maximum size relative to the client size.
      */
     getMainViewportRect(): Rect;
-    private getMaximumSheetOffset;
+    getMaximumSheetOffset(): {
+        maxOffsetX: Pixel;
+        maxOffsetY: Pixel;
+    };
     getColRowOffsetInViewport(dimension: Dimension, referenceHeaderIndex: HeaderIndex, targetHeaderIndex: HeaderIndex): Pixel;
     /**
      * Check if a given position is visible in the viewport.
      */
     isVisibleInViewport({ sheetId, col, row }: CellPosition): boolean;
+    getScrollBarWidth(): Pixel;
     getEdgeScrollCol(x: number, previousX: number, startingX: number): EdgeScrollInfo;
     getEdgeScrollRow(y: number, previousY: number, startingY: number): EdgeScrollInfo;
     /**
      * Computes the coordinates and size to draw the zone on the canvas
      */
     getVisibleRect(zone: Zone): Rect;
+    /**
+     * Computes the coordinates and size to draw the zone on the canvas after it has been zoomed
+     */
+    getVisibleRectWithZoom(zone: Zone): Rect;
     /**
      * Computes the coordinates and size to draw the zone without taking the grid offset into account
      */
@@ -3960,6 +4000,7 @@ declare class SheetViewPlugin extends UIPlugin {
         zone: Zone;
         rect: Rect;
     }[];
+    getViewportZoomLevel(): number;
     private ensureMainViewportExist;
     private getSubViewports;
     private checkPositiveDimension;
@@ -4107,8 +4148,17 @@ declare function isObjectEmptyRecursive<T extends object>(argument: T | undefine
 /**
  * Returns a function, that, as long as it continues to be invoked, will not
  * be triggered. The function will be called after it stops being called for
- * N milliseconds. If `immediate` is passed, trigger the function on the
- * leading edge, instead of the trailing.
+ * N milliseconds. If `immediate` is passed,  the function is called is called
+ * immediately on the first call and the debouncing is triggered starting the second
+ * call in the defined time window.
+ *
+ * Example:
+ * debouncedFunction = debounce(() => console.log('Hello!'), 250);
+ * debouncedFunction(); debouncedFunction(); // Will log 'Hello!' after 250ms
+ *
+ * debouncedFunction = debounce(() => console.log('Hello!'), 250, true);
+ * debouncedFunction(); debouncedFunction(); // Will log 'Hello!' and relog it after 250ms
+ *
  *
  * Also decorate the argument function with two methods: stopDebounce and isDebouncePending.
  *
@@ -4445,7 +4495,7 @@ declare class Model extends EventBus<any> implements CommandDispatcher {
     drawLayer(context: GridRenderingContext, layer: LayerName): void;
     /**
      * As the name of this method strongly implies, it is useful when we need to
-     * export date out of the model.
+     * export data out of the model.
      */
     exportData(): WorkbookData;
     updateMode(mode: Mode): void;
@@ -4558,6 +4608,8 @@ type Rect = DOMCoordinates & DOMDimension;
 interface BoxTextContent {
     textLines: string[];
     width: Pixel;
+    textHeight: Pixel;
+    textWidth: Pixel;
     align: Align;
     fontSizePx: number;
     x: Pixel;
@@ -4707,6 +4759,16 @@ interface XLSXExport {
  */
 type XlsxHexColor = string & Alias;
 
+declare const CALENDAR_CHART_GRANULARITIES: ("year" | "second_number" | "minute_number" | "hour_number" | "day_of_week" | "day_of_month" | "iso_week_number" | "month_number" | "quarter_number")[];
+type CalendarChartGranularity = (typeof CALENDAR_CHART_GRANULARITIES)[number];
+interface CalendarChartDefinition extends CommonChartDefinition {
+    readonly type: "calendar";
+    readonly horizontalGroupBy: CalendarChartGranularity;
+    readonly verticalGroupBy: CalendarChartGranularity;
+    readonly colorScale?: ChartColorScale;
+    readonly missingValueColor?: Color;
+}
+
 interface ComboChartDefinition extends CommonChartDefinition {
     readonly dataSets: ComboChartDataSet[];
     readonly type: "combo";
@@ -4797,8 +4859,8 @@ interface LineChartDefinition extends CommonChartDefinition {
     readonly zoomable?: boolean;
 }
 type LineChartRuntime = {
-    chartJsConfig: ChartConfiguration;
-    masterChartConfig?: ChartConfiguration;
+    chartJsConfig: ChartConfiguration<"line">;
+    masterChartConfig?: ChartConfiguration<"line">;
     background: Color;
 };
 
@@ -4814,7 +4876,7 @@ type PieChartRuntime = {
     background: Color;
 };
 
-interface PyramidChartDefinition extends Omit<BarChartDefinition, "type"> {
+interface PyramidChartDefinition extends Omit<BarChartDefinition, "type" | "zoomable"> {
     readonly type: "pyramid";
 }
 type PyramidChartRuntime = {
@@ -5061,9 +5123,9 @@ type WaterfallChartRuntime = {
     background: Color;
 };
 
-declare const CHART_TYPES: readonly ["line", "bar", "pie", "scorecard", "gauge", "scatter", "combo", "waterfall", "pyramid", "radar", "geo", "funnel", "sunburst", "treemap"];
+declare const CHART_TYPES: readonly ["line", "bar", "pie", "scorecard", "gauge", "scatter", "combo", "waterfall", "pyramid", "radar", "geo", "funnel", "sunburst", "treemap", "calendar"];
 type ChartType = (typeof CHART_TYPES)[number];
-type ChartDefinition = LineChartDefinition | PieChartDefinition | BarChartDefinition | ScorecardChartDefinition | GaugeChartDefinition | ScatterChartDefinition | ComboChartDefinition | WaterfallChartDefinition | PyramidChartDefinition | RadarChartDefinition | GeoChartDefinition | FunnelChartDefinition | SunburstChartDefinition | TreeMapChartDefinition;
+type ChartDefinition = LineChartDefinition | PieChartDefinition | BarChartDefinition | ScorecardChartDefinition | GaugeChartDefinition | ScatterChartDefinition | ComboChartDefinition | WaterfallChartDefinition | PyramidChartDefinition | RadarChartDefinition | GeoChartDefinition | FunnelChartDefinition | SunburstChartDefinition | TreeMapChartDefinition | CalendarChartDefinition;
 type ChartJSRuntime = LineChartRuntime | PieChartRuntime | BarChartRuntime | ComboChartRuntime | ScatterChartRuntime | WaterfallChartRuntime | PyramidChartRuntime | RadarChartRuntime | GeoChartRuntime | FunnelChartRuntime | SunburstChartRuntime | TreeMapChartRuntime;
 type ChartRuntime = ChartJSRuntime | ScorecardChartRuntime | GaugeChartRuntime;
 interface DatasetDesign {
@@ -5182,6 +5244,11 @@ interface ChartCreationContext {
     readonly zoomable?: boolean;
     readonly humanize?: boolean;
 }
+interface ChartColorScale {
+    minColor: Color;
+    midColor?: Color;
+    maxColor: Color;
+}
 
 /**
  * There are two kinds of commands: CoreCommands and LocalCommands
@@ -5429,6 +5496,12 @@ interface AddFigureChartToCarouselCommand extends SheetDependentCommand {
     carouselFigureId: UID;
     chartFigureId: UID;
 }
+interface DuplicateCarouselChartCommand extends SheetDependentCommand {
+    type: "DUPLICATE_CAROUSEL_CHART";
+    carouselId: UID;
+    chartId: UID;
+    duplicatedChartId: UID;
+}
 interface UpdateCarouselActiveItemCommand extends SheetDependentCommand {
     type: "UPDATE_CAROUSEL_ACTIVE_ITEM";
     figureId: UID;
@@ -5750,6 +5823,10 @@ interface SetViewportOffsetCommand {
     offsetX: Pixel;
     offsetY: Pixel;
 }
+interface SetZoomCommand {
+    type: "SET_ZOOM";
+    zoom: number;
+}
 /**
  * Shift the viewport down by the viewport height
  */
@@ -5868,7 +5945,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 | 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 | UpdateCarouselActiveItemCommand | PopOutChartFromCarouselCommand;
+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 Command = CoreCommand | LocalCommand;
 /**
  * Holds the result of a command dispatch.
@@ -6009,6 +6086,7 @@ declare const enum CommandResult {
     SheetIsHidden = "SheetIsHidden",
     InvalidTableResize = "InvalidTableResize",
     PivotIdNotFound = "PivotIdNotFound",
+    PivotIdTaken = "PivotIdTaken",
     PivotInError = "PivotInError",
     EmptyName = "EmptyName",
     ValueCellIsInvalidFormula = "ValueCellIsInvalidFormula",
@@ -6135,6 +6213,7 @@ interface Style {
     fillColor?: Color;
     textColor?: Color;
     fontSize?: number;
+    rotation?: number;
 }
 interface DataBarFill {
     color: Color;
@@ -6426,11 +6505,15 @@ interface ASTSymbol extends ASTBase {
     type: "SYMBOL";
     value: string;
 }
+interface ASTArray extends ASTBase {
+    type: "ARRAY";
+    value: AST[][];
+}
 interface ASTEmpty extends ASTBase {
     type: "EMPTY";
     value: "";
 }
-type AST = ASTOperation | ASTUnaryOperation | ASTFuncall | ASTSymbol | ASTNumber | ASTBoolean | ASTString | ASTReference | ASTEmpty;
+type AST = ASTOperation | ASTUnaryOperation | ASTFuncall | ASTSymbol | ASTArray | ASTNumber | ASTBoolean | ASTString | ASTReference | ASTEmpty;
 declare const OP_PRIORITY: {
     "%": number;
     "^": number;
@@ -6523,7 +6606,7 @@ type FunctionDescription = AddFunctionDescription & {
     minArgRequired: number;
     maxArgPossible: number;
     nbrArgRepeating: number;
-    nbrArgOptional: number;
+    nbrOptionalNonRepeatingArgs: number;
 };
 type EvalContext = {
     __originSheetId: UID;
@@ -6581,6 +6664,11 @@ declare function setTranslationMethod(tfn: TranslationFunction, loaded?: () => b
 declare function setDefaultTranslationMethod(): void;
 declare const _t: TranslationFunction;
 
+type GlobalChart = typeof ChartJs & typeof ChartJs.Chart;
+declare global {
+    var Chart: GlobalChart | undefined;
+}
+
 declare const CellErrorType: {
     readonly NotAvailable: "#N/A";
     readonly InvalidReference: "#REF";
@@ -6588,6 +6676,7 @@ declare const CellErrorType: {
     readonly CircularDependency: "#CYCLE";
     readonly UnknownFunction: "#NAME?";
     readonly DivisionByZero: "#DIV/0!";
+    readonly InvalidNumber: "#NUM!";
     readonly SpilledBlocked: "#SPILL!";
     readonly GenericError: "#ERROR";
     readonly NullError: "#NULL!";
@@ -6620,7 +6709,10 @@ declare class SplillBlockedError extends EvaluationError {
 declare class DivisionByZeroError extends EvaluationError {
     constructor(message?: string);
 }
+declare class NumberTooLargeError extends EvaluationError {
+    constructor(message?: string);
+}
 
 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, GridClickModifiers, GridRenderingContext, HSLA, HeaderDimensions, HeaderGroup, HeaderIndex, Highlight, HistoryChange, Image, Immutable, Increment, InvalidReferenceError, LayerName, Lazy, Link, Locale, LocaleCode, Matrix, Maybe, MenuMouseEvent, Merge, Model, NotAvailableError, 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, 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 };