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

package/dist/{o_spreadsheet.d.ts → o-spreadsheet.d.ts}

@@ -350,11 +350,16 @@ interface SelectionProcessor {
 }
 declare type SelectionStreamProcessor = SelectionProcessor & StatefulStream<SelectionEvent, AnchorZone>;
 
-interface XLSXExportFile {
+declare type XLSXExportFile = XLSXExportImageFile | XLSXExportXMLFile;
+interface XLSXExportXMLFile {
     path: string;
     content: string;
     contentType?: string;
 }
+interface XLSXExportImageFile {
+    path: string;
+    imagePath: string;
+}
 interface XLSXExport {
     name: string;
     files: XLSXExportFile[];
@@ -613,6 +618,25 @@ interface IconSetRule {
 declare type ConditionalFormattingOperatorValues = "BeginsWith" | "Between" | "ContainsText" | "IsEmpty" | "IsNotEmpty" | "EndsWith" | "Equal" | "GreaterThan" | "GreaterThanOrEqual" | "LessThan" | "LessThanOrEqual" | "NotBetween" | "NotContains" | "NotEqual";
 declare type UpDown = "up" | "down";
 
+interface Figure {
+    id: UID;
+    x: Pixel;
+    y: Pixel;
+    width: Pixel;
+    height: Pixel;
+    tag: string;
+}
+interface FigureSize {
+    width: Pixel;
+    height: Pixel;
+}
+declare type ResizeDirection = -1 | 0 | 1;
+
+interface Image {
+    path: string;
+    size: FigureSize;
+}
+
 interface CellData {
     content?: string;
     style?: number;
@@ -672,6 +696,7 @@ interface WorkbookData {
         };
     };
     revisionId: UID;
+    uniqueFigureIds: boolean;
 }
 interface ExcelWorkbookData extends WorkbookData {
     sheets: ExcelSheetData[];
@@ -685,6 +710,7 @@ interface ExcelSheetData extends Omit<SheetData, "figureTables"> {
         [key: string]: ExcelCellData | undefined;
     };
     charts: FigureData<ExcelChartDefinition>[];
+    images: FigureData<Image>[];
     filterTables: ExcelFilterTableData[];
 }
 interface FilterTableData {
@@ -834,25 +860,6 @@ interface TransportService<T = any> {
     leave: (id: UID) => void;
 }
 
-interface Figure {
-    id: UID;
-    x: Pixel;
-    y: Pixel;
-    width: Pixel;
-    height: Pixel;
-    tag: string;
-}
-interface FigureSize {
-    width: Pixel;
-    height: Pixel;
-}
-declare type ResizeDirection = -1 | 0 | 1;
-
-interface Image {
-    path: string;
-    size: FigureSize;
-}
-
 declare type FilePath = string;
 /**
  * FileStore manage the transfer of file with the server.
@@ -1350,12 +1357,6 @@ declare class EditionPlugin extends UIPlugin {
     private getTokensInSelection;
 }
 
-declare type Rect = {
-    x: Pixel;
-    y: Pixel;
-    width: Pixel;
-    height: Pixel;
-};
 /**
  * Coordinate in pixels
  */
@@ -1367,6 +1368,7 @@ interface DOMDimension {
     width: Pixel;
     height: Pixel;
 }
+declare type Rect = DOMCoordinates & DOMDimension;
 /**
  * The viewport is the visible area of a sheet.
  * Column and row headers are not included in the viewport.
@@ -1865,7 +1867,7 @@ interface FocusInputCommand {
     /**
      * Range to focus
      */
-    rangeId: string;
+    rangeId: number;
 }
 /**
  * Add an empty range at the end of a SelectionComponent state
@@ -1884,7 +1886,7 @@ interface RemoveRangeCommand {
     /** SelectionComponent id */
     id: string;
     /** The range to be removed */
-    rangeId: string;
+    rangeId: number;
 }
 /**
  * Set a new value for a given range of a SelectionComponent state.
@@ -1894,7 +1896,7 @@ interface ChangeRangeCommand {
     /** SelectionComponent id */
     id: string;
     /** The range to be changed */
-    rangeId: string;
+    rangeId: number;
     /**
      * Range to set in the input. Invalid ranges are also accepted.
      * e.g. "B2:B3" or the invalid "A5:"
@@ -2076,7 +2078,7 @@ declare const enum CommandResult {
     InvalidRange = 25,
     InvalidZones = 26,
     InvalidSheetId = 27,
-    DuplicatedImageId = 28,
+    InvalidFigureId = 28,
     InputAlreadyFocused = 29,
     MaximumRangesReached = 30,
     InvalidChartDefinition = 31,
@@ -2132,7 +2134,8 @@ declare const enum CommandResult {
     NonContinuousTargets = 81,
     DuplicatedFigureId = 82,
     InvalidSelectionStep = 83,
-    DuplicatedChartId = 84
+    DuplicatedChartId = 84,
+    ChartDoesNotExist = 85
 }
 interface CommandHandler<T> {
     allowDispatch(command: T): CommandResult | CommandResult[];
@@ -2214,8 +2217,8 @@ interface UnboundedZone {
     hasHeader?: boolean;
 }
 interface ZoneDimension {
-    height: HeaderIndex;
-    width: HeaderIndex;
+    numberOfRows: HeaderIndex;
+    numberOfCols: HeaderIndex;
 }
 declare type Align = "left" | "right" | "center" | undefined;
 declare type VerticalAlign = "top" | "middle" | "bottom" | undefined;
@@ -3179,24 +3182,22 @@ declare abstract class AbstractChart {
  * This plugin manages charts
  * */
 interface ChartState {
-    readonly charts: {
-        [sheetId: UID]: Record<UID, AbstractChart | undefined> | undefined;
-    };
+    readonly charts: Record<UID, AbstractChart | undefined>;
 }
 declare class ChartPlugin extends CorePlugin<ChartState> implements ChartState {
     static getters: readonly ["isChartDefined", "getChartDefinition", "getChartType", "getChartIds", "getChart", "getContextCreationChart"];
-    readonly charts: ChartState["charts"];
+    readonly charts: Record<UID, AbstractChart | undefined>;
     private createChart;
     private validateChartDefinition;
     adaptRanges(applyChange: ApplyRangeChange): void;
     allowDispatch(cmd: Command): CommandResult | CommandResult[];
     handle(cmd: CoreCommand): void;
-    getContextCreationChart(sheetId: UID, figureId: UID): ChartCreationContext | undefined;
-    getChart(sheetId: UID, figureId: UID): AbstractChart | undefined;
-    getChartType(sheetId: UID, figureId: UID): ChartType;
-    isChartDefined(sheetId: UID, figureId: UID): boolean;
+    getContextCreationChart(figureId: UID): ChartCreationContext | undefined;
+    getChart(figureId: UID): AbstractChart | undefined;
+    getChartType(figureId: UID): ChartType;
+    isChartDefined(figureId: UID): boolean;
     getChartIds(sheetId: UID): string[];
-    getChartDefinition(sheetId: UID, figureId: UID): ChartDefinition;
+    getChartDefinition(figureId: UID): ChartDefinition;
     import(data: WorkbookData): void;
     export(data: WorkbookData): void;
     exportForExcel(data: ExcelWorkbookData): void;
@@ -3210,6 +3211,7 @@ declare class ChartPlugin extends CorePlugin<ChartState> implements ChartState {
      */
     private addChart;
     private checkChartDuplicate;
+    private checkChartExists;
 }
 
 interface ConditionalFormatState {
@@ -3260,12 +3262,14 @@ declare class ConditionalFormatPlugin extends CorePlugin<ConditionalFormatState>
 
 interface FigureState {
     readonly figures: {
-        [sheet: UID]: Record<UID, Figure | undefined> | undefined;
+        [sheet: string]: Record<UID, Figure | undefined> | undefined;
     };
 }
 declare class FigurePlugin extends CorePlugin<FigureState> implements FigureState {
-    static getters: readonly ["getFigures", "getFigure"];
-    readonly figures: FigureState["figures"];
+    static getters: readonly ["getFigures", "getFigure", "getFigureSheetId"];
+    readonly figures: {
+        [sheet: string]: Record<UID, Figure | undefined> | undefined;
+    };
     allowDispatch(cmd: CoreCommand): CommandResult;
     handle(cmd: CoreCommand): void;
     private updateFigure;
@@ -3276,6 +3280,7 @@ declare class FigurePlugin extends CorePlugin<FigureState> implements FigureStat
     private checkFigureDuplicate;
     getFigures(sheetId: UID): Figure[];
     getFigure(sheetId: string, figureId: string): Figure | undefined;
+    getFigureSheetId(figureId: string): UID | undefined;
     import(data: WorkbookData): void;
     export(data: WorkbookData): void;
     exportForExcel(data: ExcelWorkbookData): void;
@@ -3396,7 +3401,7 @@ interface ImageState {
     readonly images: Record<UID, Record<UID, Image | undefined> | undefined>;
 }
 declare class ImagePlugin extends CorePlugin<ImageState> implements ImageState {
-    static getters: readonly ["getImage"];
+    static getters: readonly ["getImage", "getImagePath", "getImageSize"];
     readonly fileStore?: FileStore;
     readonly images: Record<UID, Record<UID, Image | undefined> | undefined>;
     /**
@@ -3404,16 +3409,19 @@ declare class ImagePlugin extends CorePlugin<ImageState> implements ImageState {
      */
     readonly syncedImages: Set<Image["path"]>;
     constructor(config: CorePluginConfig);
-    allowDispatch(cmd: CoreCommand): CommandResult.Success | CommandResult.DuplicatedImageId;
+    allowDispatch(cmd: CoreCommand): CommandResult.Success | CommandResult.InvalidFigureId;
     handle(cmd: CoreCommand): void;
     /**
      * Delete unused images from the file store
      */
     garbageCollectExternalResources(): void;
-    getImage(sheetId: UID, figureId: UID): Image;
+    getImage(figureId: UID): Image;
+    getImagePath(figureId: UID): string;
+    getImageSize(figureId: UID): FigureSize;
     private addFigure;
     import(data: WorkbookData): void;
     export(data: WorkbookData): void;
+    exportForExcel(data: ExcelWorkbookData): void;
     private getAllImages;
 }
 
@@ -3705,12 +3713,10 @@ declare class EvaluationPlugin extends UIPlugin {
 
 declare class EvaluationChartPlugin extends UIPlugin {
     static getters: readonly ["getChartRuntime", "getBackgroundOfSingleCellChart"];
-    readonly charts: {
-        [sheetId: UID]: Record<UID, ChartRuntime | undefined> | undefined;
-    };
+    readonly charts: Record<UID, ChartRuntime | undefined>;
     private createRuntimeChart;
     handle(cmd: Command): void;
-    getChartRuntime(sheetId: UID, figureId: UID): ChartRuntime;
+    getChartRuntime(figureId: UID): ChartRuntime;
     /**
      * Get the background color of a chart based on the color of the first cell of the main range
      * of the chart. In order of priority, it will return :
@@ -3814,7 +3820,7 @@ declare class InternalViewport {
         x: Pixel;
         y: Pixel;
     });
-    getMaxSize(): ZoneDimension;
+    getMaxSize(): DOMDimension;
     /**
      * Return the index of a column given an offset x, based on the pane left
      * visible cell.
@@ -3942,8 +3948,8 @@ declare class SheetViewPlugin extends UIPlugin {
      * It returns -1 if no row is found.
      */
     getRowIndex(y: Pixel): HeaderIndex;
-    getSheetViewDimensionWithHeaders(): ZoneDimension;
-    getSheetViewDimension(): ZoneDimension;
+    getSheetViewDimensionWithHeaders(): DOMDimension;
+    getSheetViewDimension(): DOMDimension;
     /** type as pane, not viewport but basically pane extends viewport */
     getActiveMainViewport(): Viewport;
     /**
@@ -4252,7 +4258,7 @@ declare class RendererPlugin extends UIPlugin {
 }
 
 interface RangeInputValue {
-    id: UID;
+    id: number;
     xc: string;
     color: string;
 }
@@ -4315,7 +4321,7 @@ declare class SelectionInputPlugin extends UIPlugin implements StreamCallbacks<S
      * Return the index of a range given its id
      * or `null` if the range is not found.
      */
-    getIndex(rangeId: string | null): number | null;
+    getIndex(rangeId: number | null): number | null;
 }
 
 /**
@@ -4889,15 +4895,14 @@ declare class SelectionInput extends Component<Props$B, SpreadsheetChildEnv> {
     getColor(range: SelectionRange): string;
     private triggerChange;
     onKeydown(ev: KeyboardEvent): void;
-    focus(rangeId: string): void;
+    focus(rangeId: number): void;
     addEmptyInput(): void;
-    removeInput(rangeId: string): void;
-    onInputChanged(rangeId: string, ev: InputEvent): void;
-    disable(): void;
+    removeInput(rangeId: number): void;
+    onInputChanged(rangeId: number, ev: InputEvent): void;
+    confirm(): void;
 }
 
 interface Props$A {
-    sheetId: UID;
     figureId: UID;
     definition: LineChartDefinition | BarChartDefinition | PieChartDefinition;
     updateChart: (definition: Partial<LineChartDefinition | BarChartDefinition | PieChartDefinition>) => DispatchResult;
@@ -4936,9 +4941,42 @@ declare class BarConfigPanel extends LineBarPieConfigPanel {
     onUpdateAggregated(ev: any): void;
 }
 
+interface PopoverProps {
+    /**
+     * Rectangle around which the popover is displayed.
+     * Coordinates are expressed as absolute DOM position.
+     */
+    anchorRect: Rect;
+    /** The popover can be positioned below the anchor Rectangle, or to the right of the rectangle */
+    positioning: PopoverPropsPosition;
+    maxWidth?: Pixel;
+    maxHeight?: Pixel;
+    /** Offset to apply to the vertical position of the popover.*/
+    verticalOffset: number;
+    onMouseWheel?: () => void;
+    onPopoverMoved?: () => void;
+    onPopoverHidden?: () => void;
+}
+declare class Popover extends Component<PopoverProps, SpreadsheetChildEnv> {
+    static template: string;
+    static defaultProps: {
+        positioning: string;
+        verticalOffset: number;
+        onMouseWheel: () => void;
+        onPopoverMoved: () => void;
+        onPopoverHidden: () => void;
+    };
+    private popoverRef;
+    private currentPosition;
+    private currentDisplayValue;
+    private spreadsheetRect;
+    private containerRect;
+    setup(): void;
+}
+
 interface ColorPickerProps {
+    anchorRect: Rect;
     maxHeight?: Pixel;
-    dropdownDirection?: "left" | "right" | "center";
     onColorPicked: (color: Color) => void;
     currentColor: Color;
 }
@@ -4947,9 +4985,13 @@ declare class ColorPicker extends Component<ColorPickerProps, SpreadsheetChildEn
     static defaultProps: {
         currentColor: string;
     };
+    static components: {
+        Popover: typeof Popover;
+    };
     COLORS: string[];
     private state;
     get colorPickerStyle(): string;
+    get popoverProps(): PopoverProps;
     onColorClick(color: Color): void;
     getCheckMarkColor(): Color;
     resetColor(): void;
@@ -4968,7 +5010,6 @@ interface Props$z {
     showColorPicker: boolean;
     onColorPicked: (color: string) => void;
     icon: string;
-    dropdownDirection?: "left" | "right" | "center";
     title?: string;
     disabled?: boolean;
     dropdownMaxHeight?: Pixel;
@@ -4979,7 +5020,11 @@ declare class ColorPickerWidget extends Component<Props$z, SpreadsheetChildEnv>
     static components: {
         ColorPicker: typeof ColorPicker;
     };
+    colorPickerButtonRef: {
+        el: HTMLElement | null;
+    };
     get iconStyle(): string;
+    get colorPickerAnchorRect(): Rect;
 }
 
 interface Props$y {
@@ -5002,7 +5047,6 @@ declare class LineBarPieDesignPanel extends Component<Props$y, SpreadsheetChildE
 }
 
 interface Props$x {
-    sheetId: UID;
     figureId: UID;
     definition: GaugeChartDefinition;
     updateChart: (definition: Partial<GaugeChartDefinition>) => DispatchResult;
@@ -5059,7 +5103,6 @@ declare class LineConfigPanel extends LineBarPieConfigPanel {
 }
 
 interface Props$v {
-    sheetId: UID;
     figureId: UID;
     definition: ScorecardChartDefinition;
     updateChart: (definition: Partial<ScorecardChartDefinition>) => DispatchResult;
@@ -5107,26 +5150,6 @@ interface ChartSidePanel {
     design: new (...args: any) => Component;
 }
 
-/**
- * This registry is intended to map a type of figure (tag) to a class of
- * component, that will be used in the UI to represent the figure.
- *
- * The most important type of figure will be the Chart
- */
-interface FigureContent {
-    Component: any;
-    SidePanelComponent?: string;
-    keepRatio?: boolean;
-    minFigSize?: number;
-    borderWidth?: number;
-}
-
-interface SidePanelContent {
-    title: string | ((env: SpreadsheetChildEnv) => string);
-    Body: any;
-    Footer?: any;
-}
-
 /**
  * An ActionMenuItem represent a menu item for the menus of the topbar.
  * and the context menu in the grid.
@@ -5194,6 +5217,27 @@ declare class MenuItemRegistry extends Registry<MenuItemSpec> {
     getMenuItems(): MenuItem[];
 }
 
+/**
+ * This registry is intended to map a type of figure (tag) to a class of
+ * component, that will be used in the UI to represent the figure.
+ *
+ * The most important type of figure will be the Chart
+ */
+interface FigureContent {
+    Component: any;
+    menuBuilder: (figureId: UID, onFigureDeleted: () => void, env: SpreadsheetChildEnv) => MenuItem[];
+    SidePanelComponent?: string;
+    keepRatio?: boolean;
+    minFigSize?: number;
+    borderWidth?: number;
+}
+
+interface SidePanelContent {
+    title: string | ((env: SpreadsheetChildEnv) => string);
+    Body: any;
+    Footer?: any;
+}
+
 /**
  * An AutofillRule is used to generate what to do when we need to autofill
  * a cell. (In a AutofillGenerator, see plugins/autofill.ts)
@@ -5214,7 +5258,7 @@ declare class ChartJsComponent extends Component<Props$t, SpreadsheetChildEnv> {
     static template: string;
     private canvas;
     private chart?;
-    get background(): Color;
+    get background(): string;
     get canvasStyle(): string;
     get chartRuntime(): ChartJSRuntime;
     setup(): void;
@@ -5236,7 +5280,7 @@ declare class ScorecardChart extends Component<Props$s, SpreadsheetChildEnv> {
     get baselineArrowDirection(): BaselineArrowDirection;
     get backgroundColor(): string;
     get primaryFontColor(): string;
-    get secondaryFontColor(): "#757575" | "#bbbbbb";
+    get secondaryFontColor(): "#525252" | "#C8C8C8";
     get figure(): Figure;
     get chartStyle(): string;
     get chartContentStyle(): string;
@@ -5256,120 +5300,18 @@ declare class ScorecardChart extends Component<Props$s, SpreadsheetChildEnv> {
     private getWidestElement;
 }
 
-interface PopoverProps {
-    /**
-     * Rectangle around which the popover is displayed.
-     * Coordinates are expressed as absolute DOM position.
-     */
-    anchorRect: Rect;
-    /** The popover can be positioned below the anchor Rectangle, or to the right of the rectangle */
-    positioning: PopoverPropsPosition;
-    maxWidth?: Pixel;
-    maxHeight?: Pixel;
-    /** Offset to apply to the vertical position of the popover.*/
-    verticalOffset: number;
-    onMouseWheel?: () => void;
-    onPopoverMoved?: () => void;
-    onPopoverHidden?: () => void;
-}
-declare class Popover extends Component<PopoverProps, SpreadsheetChildEnv> {
-    static template: string;
-    static defaultProps: {
-        positioning: string;
-        verticalOffset: number;
-        onMouseWheel: () => void;
-        onPopoverMoved: () => void;
-        onPopoverHidden: () => void;
-    };
-    private popoverRef;
-    private currentPosition;
-    private currentDisplayValue;
-    private spreadsheetRect;
-    private containerRect;
-    setup(): void;
-}
-
 interface Props$r {
-    position: DOMCoordinates;
-    menuItems: MenuItem[];
-    depth: number;
-    maxHeight?: Pixel;
-    onClose: () => void;
-    onMenuClicked?: (ev: CustomEvent) => void;
-    menuId?: UID;
-}
-interface MenuState {
-    isOpen: boolean;
-    parentMenu?: MenuItem;
-    position: null | DOMCoordinates;
-    scrollOffset?: Pixel;
-    menuItems: MenuItem[];
-}
-declare class Menu extends Component<Props$r, SpreadsheetChildEnv> {
-    static template: string;
-    static components: {
-        Menu: typeof Menu;
-        Popover: typeof Popover;
-    };
-    static defaultProps: {
-        depth: number;
-    };
-    private subMenu;
-    private menuRef;
-    private position;
-    setup(): void;
-    get visibleMenuItems(): MenuItem[];
-    get subMenuPosition(): DOMCoordinates;
-    get menuHeight(): Pixel;
-    get popoverProps(): PopoverProps;
-    getColor(menu: MenuItem): string | undefined;
-    activateMenu(menu: MenuItem): Promise<void>;
-    private close;
-    /**
-     * Return the number of pixels between the top of the menu
-     * and the menu item at a given index.
-     */
-    private subMenuVerticalPosition;
-    private onExternalClick;
-    private getMenuItemsHeight;
-    getName(menu: MenuItem): string;
-    isRoot(menu: MenuItem): boolean;
-    isEnabled(menu: MenuItem): boolean;
-    onScroll(ev: any): void;
-    /**
-     * If the given menu is not disabled, open it's submenu at the
-     * correct position according to available surrounding space.
-     */
-    openSubMenu(menu: MenuItem, menuIndex: number): void;
-    isParentMenu(subMenu: MenuState, menuItem: MenuItem): boolean;
-    closeSubMenu(): void;
-    onClickMenu(menu: MenuItem, menuIndex: number): void;
-    onMouseOver(menu: MenuItem, position: Pixel): void;
-}
-
-interface Props$q {
     figure: Figure;
     onFigureDeleted: () => void;
 }
-declare class ChartFigure extends Component<Props$q, SpreadsheetChildEnv> {
+declare class ChartFigure extends Component<Props$r, SpreadsheetChildEnv> {
     static template: string;
-    static components: {
-        Menu: typeof Menu;
-    };
-    private menuState;
-    private chartContainerRef;
-    private menuButtonRef;
-    private menuButtonRect;
-    private position;
-    private getMenuItemRegistry;
+    static components: {};
     get chartType(): ChartType;
-    onContextMenu(ev: MouseEvent): void;
-    showMenu(): void;
-    private openContextMenu;
     get chartComponent(): new (...args: any) => Component;
 }
 
-interface Props$p {
+interface Props$q {
     isVisible: boolean;
     position: Position;
 }
@@ -5381,7 +5323,7 @@ interface State$3 {
     position: Position;
     handler: boolean;
 }
-declare class Autofill extends Component<Props$p, SpreadsheetChildEnv> {
+declare class Autofill extends Component<Props$q, SpreadsheetChildEnv> {
     static template: string;
     state: State$3;
     get style(): string;
@@ -5455,13 +5397,13 @@ declare class Ripple extends Component<RippleProps, SpreadsheetChildEnv> {
     getRippleEffectProps(id: number): RippleEffectProps;
 }
 
-interface Props$o {
+interface Props$p {
     sheetId: string;
     openContextMenu: (registry: MenuItemRegistry, ev: MouseEvent) => void;
     style?: string;
     onMouseDown: (ev: MouseEvent) => void;
 }
-declare class BottomBarSheet extends Component<Props$o, SpreadsheetChildEnv> {
+declare class BottomBarSheet extends Component<Props$p, SpreadsheetChildEnv> {
     static template: string;
     static components: {
         Ripple: typeof Ripple;
@@ -5495,11 +5437,11 @@ declare class BottomBarSheet extends Component<Props$o, SpreadsheetChildEnv> {
     get sheetName(): string;
 }
 
-interface Props$n {
+interface Props$o {
     openContextMenu: (x: number, y: number, registry: MenuItemRegistry) => void;
     closeContextMenu: () => void;
 }
-declare class BottomBarStatistic extends Component<Props$n, SpreadsheetChildEnv> {
+declare class BottomBarStatistic extends Component<Props$o, SpreadsheetChildEnv> {
     static template: string;
     static components: {
         Ripple: typeof Ripple;
@@ -5512,6 +5454,64 @@ declare class BottomBarStatistic extends Component<Props$n, SpreadsheetChildEnv>
     private getComposedFnName;
 }
 
+interface Props$n {
+    position: DOMCoordinates;
+    menuItems: MenuItem[];
+    depth: number;
+    maxHeight?: Pixel;
+    onClose: () => void;
+    onMenuClicked?: (ev: CustomEvent) => void;
+    menuId?: UID;
+}
+interface MenuState {
+    isOpen: boolean;
+    parentMenu?: MenuItem;
+    position: null | DOMCoordinates;
+    scrollOffset?: Pixel;
+    menuItems: MenuItem[];
+}
+declare class Menu extends Component<Props$n, SpreadsheetChildEnv> {
+    static template: string;
+    static components: {
+        Menu: typeof Menu;
+        Popover: typeof Popover;
+    };
+    static defaultProps: {
+        depth: number;
+    };
+    private subMenu;
+    private menuRef;
+    private position;
+    setup(): void;
+    get visibleMenuItems(): MenuItem[];
+    get subMenuPosition(): DOMCoordinates;
+    get menuHeight(): Pixel;
+    get popoverProps(): PopoverProps;
+    getColor(menu: MenuItem): string | undefined;
+    activateMenu(menu: MenuItem): Promise<void>;
+    private close;
+    /**
+     * Return the number of pixels between the top of the menu
+     * and the menu item at a given index.
+     */
+    private subMenuVerticalPosition;
+    private onExternalClick;
+    private getMenuItemsHeight;
+    getName(menu: MenuItem): string;
+    isRoot(menu: MenuItem): boolean;
+    isEnabled(menu: MenuItem): boolean;
+    onScroll(ev: any): void;
+    /**
+     * If the given menu is not disabled, open it's submenu at the
+     * correct position according to available surrounding space.
+     */
+    openSubMenu(menu: MenuItem, menuIndex: number): void;
+    isParentMenu(subMenu: MenuState, menuItem: MenuItem): boolean;
+    closeSubMenu(): void;
+    onClickMenu(menu: MenuItem, menuIndex: number): void;
+    onMouseOver(menu: MenuItem, position: Pixel): void;
+}
+
 interface BottomBarSheetItem {
     id: UID;
     name: string;
@@ -5580,14 +5580,19 @@ interface Props$l {
 }
 declare class FigureComponent extends Component<Props$l, SpreadsheetChildEnv> {
     static template: string;
-    static components: {};
+    static components: {
+        Menu: typeof Menu;
+    };
     static defaultProps: {
         onFigureDeleted: () => void;
         onMouseDown: () => void;
         onClickAnchor: () => void;
     };
-    private borderWidth;
+    private menuState;
     private figureRef;
+    private menuButtonRef;
+    private menuButtonRect;
+    private borderWidth;
     get isSelected(): boolean;
     get figureRegistry(): Registry<FigureContent>;
     private getBorderWidth;
@@ -5598,6 +5603,9 @@ declare class FigureComponent extends Component<Props$l, SpreadsheetChildEnv> {
     clickAnchor(dirX: ResizeDirection, dirY: ResizeDirection, ev: MouseEvent): void;
     onMouseDown(ev: MouseEvent): void;
     onKeyDown(ev: KeyboardEvent): void;
+    onContextMenu(ev: MouseEvent): void;
+    showMenu(): void;
+    private openContextMenu;
 }
 
 declare type ContainerType = "topLeft" | "topRight" | "bottomLeft" | "bottomRight" | "dnd";
@@ -6242,7 +6250,7 @@ interface Props$5 {
     focus: ComposerFocusType;
     onComposerUnmounted: () => void;
     onComposerContentFocused: (selection: ComposerSelection) => void;
-    gridDims: ZoneDimension;
+    gridDims: DOMDimension;
 }
 /**
  * This component is a composer which positions itself on the grid at the anchor cell.