@odoo/o-spreadsheet 17.2.0-alpha.4 → 17.2.0-alpha.5

package/dist/o-spreadsheet.d.ts

@@ -8,6 +8,13 @@ import { ChartConfiguration, ChartData, ChartDataset, ChartOptions } from 'chart
 interface StoreConstructor<T = any, A extends unknown[] = any[]> {
     new (get: Get, ...args: A): T;
 }
+/**
+ * A store constructor for a store that implements the Disposable interface.
+ * Useful for local stores that need to be disposed when the component unmounts.
+ */
+interface LocalStoreConstructor<T extends Disposable = any, A extends unknown[] = unknown[]> {
+    new (get: Get, ...args: A): T;
+}
 interface Disposable {
     dispose(): void;
 }
@@ -75,6 +82,11 @@ declare class DependencyContainer {
  * This hook should be used at the root of your app to provide the store container.
  */
 declare function useStoreProvider(): DependencyContainer;
+/**
+ * Get the instance of a store.
+ */
+declare function useStore<T extends StoreConstructor>(Store: T): Store<InstanceType<T>>;
+declare function useLocalStore<T extends LocalStoreConstructor<any>>(Store: T, ...args: StoreParams<T>): Store<InstanceType<T>>;
 
 /**
  * This is a generic event bus based on the Owl event bus.
@@ -399,7 +411,8 @@ interface ScorecardChartRuntime {
     readonly baselineStyle?: Style;
 }
 
-type ChartType = "line" | "bar" | "pie" | "scorecard" | "gauge" | "scatter";
+declare const CHART_TYPES: readonly ["line", "bar", "pie", "scorecard", "gauge", "scatter"];
+type ChartType = (typeof CHART_TYPES)[number];
 type ChartDefinition = LineChartDefinition | PieChartDefinition | BarChartDefinition | ScorecardChartDefinition | GaugeChartDefinition | ScatterChartDefinition;
 type ChartJSRuntime = LineChartRuntime | PieChartRuntime | BarChartRuntime | GaugeChartRuntime | ScatterChartRuntime;
 type ChartRuntime = ChartJSRuntime | ScorecardChartRuntime;
@@ -2278,6 +2291,7 @@ declare class CellPlugin extends CorePlugin<CoreState> implements CoreState {
     private createErrorFormula;
     private checkCellOutOfSheet;
     private checkUselessClearCell;
+    private checkUselessUpdateCell;
 }
 
 /**
@@ -2538,10 +2552,10 @@ declare class FiltersPlugin extends CorePlugin<FiltersState> implements FiltersS
     exportForExcel(data: ExcelWorkbookData): void;
 }
 
-interface State$7 {
+interface State$6 {
     groups: Record<UID, Record<Dimension, HeaderGroup[]>>;
 }
-declare class HeaderGroupingPlugin extends CorePlugin<State$7> {
+declare class HeaderGroupingPlugin extends CorePlugin<State$6> {
     static getters: readonly ["getHeaderGroups", "getGroupsLayers", "getVisibleGroupLayers", "getHeaderGroup", "getHeaderGroupsInZone", "isGroupFolded", "isRowFolded", "isColFolded"];
     private readonly groups;
     allowDispatch(cmd: CoreCommand): CommandResult;
@@ -3371,6 +3385,7 @@ interface UIPluginConfig {
     readonly custom: ModelConfig["custom"];
     readonly session: Session;
     readonly defaultCurrencyFormat?: Format;
+    readonly customColors: Color[];
 }
 interface UIPluginConstructor {
     new (config: UIPluginConfig): UIPlugin;
@@ -3437,8 +3452,10 @@ interface CustomColorState {
  */
 declare class CustomColorsPlugin extends UIPlugin<CustomColorState> {
     private readonly customColors;
+    private readonly configCustomColors;
     private readonly shouldUpdateColors;
     static getters: readonly ["getCustomColors"];
+    constructor(config: UIPluginConfig);
     handle(cmd: CoreViewCommand): void;
     finalize(): void;
     getCustomColors(): Color[];
@@ -3873,7 +3890,7 @@ declare class UIOptionsPlugin extends UIPlugin {
 }
 
 declare class SheetUIPlugin extends UIPlugin {
-    static getters: readonly ["doesCellHaveGridIcon", "getCellWidth", "getTextWidth", "getCellText", "getCellMultiLineText", "getContiguousZone", "isCellEmpty"];
+    static getters: readonly ["doesCellHaveGridIcon", "getCellWidth", "getTextWidth", "getCellText", "getCellMultiLineText", "getContiguousZone", "isEvaluatedCellEmpty"];
     private ctx;
     allowDispatch(cmd: LocalCommand): CommandResult | CommandResult[];
     handle(cmd: Command): void;
@@ -3891,10 +3908,15 @@ declare class SheetUIPlugin extends UIPlugin {
      */
     getContiguousZone(sheetId: UID, zoneToExpand: Zone): Zone;
     /**
-     * Check if a cell is empty. If the cell is part of a merge,
-     * check if the merge containing the cell is empty.
+     * Checks if a cell evaluated value is empty. If the cell is part of a merge,
+     * the check applies to the main cell of the merge.
+     */
+    isEvaluatedCellEmpty(position: CellPosition): boolean;
+    /**
+     * Checks if a cell is empty (i.e. does not have a content or a formula does not spread over it).
+     * If the cell is part of a merge, the check applies to the main cell of the merge.
      */
-    isCellEmpty(position: CellPosition): boolean;
+    private isCellEmpty;
     private getColMaxWidth;
     /**
      * Check that any "sheetId" in the command matches an existing
@@ -4415,6 +4437,8 @@ type EvalContext = {
     locale: Locale;
     getters: Getters;
     [key: string]: any;
+    updateDependencies?: (position: CellPosition) => void;
+    addDependencies?: (position: CellPosition, ranges: Range[]) => void;
 };
 
 interface HistoryChange {
@@ -4594,6 +4618,12 @@ declare class DateTime {
 declare function formatValue(value: CellValue, { format, locale }: LocaleFormat): FormattedValue;
 declare function createCurrencyFormat(currency: Partial<Currency>): Format;
 
+/**
+ * Deep copy arrays, plain objects and primitive values.
+ * Throws an error for other types such as class instances.
+ * Sparse arrays remain sparse.
+ */
+declare function deepCopy<T>(obj: T): T;
 declare function isMarkdownLink(str: string): boolean;
 /**
  * Build a markdown link from a label and an url
@@ -4695,6 +4725,16 @@ declare function toUnboundedZone(xc: string): UnboundedZone;
  *
  */
 declare function toZone(xc: string): Zone;
+/**
+ * Expand a zone after inserting columns or rows.
+ *
+ * Don't resize the zone if a col/row was added right before/after the row but only move the zone.
+ */
+declare function expandZoneOnInsertion<Z extends UnboundedZone | Zone>(zone: Z, start: "left" | "top", base: number, position: "after" | "before", quantity: number): Z;
+/**
+ * Reduce a zone after deletion of elements
+ */
+declare function reduceZoneOnDeletion<Z extends UnboundedZone | Zone>(zone: Z, start: "left" | "top", elements: number[]): Z | undefined;
 /**
  * Compute the union of multiple zones.
  */
@@ -4703,6 +4743,7 @@ declare function union(...zones: Zone[]): Zone;
  * Return true if two zones overlap, false otherwise.
  */
 declare function overlap(z1: Zone, z2: Zone): boolean;
+declare function isInside(col: number, row: number, zone: Zone): boolean;
 /**
  * This function will compare the modifications of selection to determine
  * a cell that is part of the new zone and not the previous one.
@@ -4762,6 +4803,7 @@ interface ModelConfig {
     readonly snapshotRequested: boolean;
     readonly notifyUI: (payload: InformationNotification) => void;
     readonly raiseBlockingErrorUI: (text: string) => void;
+    readonly customColors: Color[];
 }
 interface ModelExternalConfig {
     readonly fileStore?: FileStore;
@@ -5192,7 +5234,7 @@ declare class SelectionInputStore extends SpreadsheetStore {
     getIndex(rangeId: number | null): number | null;
 }
 
-interface Props$Q {
+interface Props$P {
     ranges: string[];
     hasSingleRange?: boolean;
     required?: boolean;
@@ -5214,7 +5256,7 @@ interface SelectionRange extends Omit<RangeInputValue, "color"> {
  * onSelectionChanged is called every time the input value
  * changes.
  */
-declare class SelectionInput extends Component<Props$Q, SpreadsheetChildEnv> {
+declare class SelectionInput extends Component<Props$P, SpreadsheetChildEnv> {
     static template: string;
     static props: {
         ranges: ArrayConstructor;
@@ -5264,11 +5306,11 @@ declare class SelectionInput extends Component<Props$Q, SpreadsheetChildEnv> {
     confirm(): void;
 }
 
-interface Props$P {
+interface Props$O {
     messages: string[];
     msgType: "warning" | "error";
 }
-declare class ValidationMessages extends Component<Props$P, SpreadsheetChildEnv> {
+declare class ValidationMessages extends Component<Props$O, SpreadsheetChildEnv> {
     static template: string;
     static props: {
         messages: ArrayConstructor;
@@ -5277,14 +5319,15 @@ declare class ValidationMessages extends Component<Props$P, SpreadsheetChildEnv>
     get divClasses(): "o-validation-warning text-warning" | "o-validation-error text-danger";
 }
 
-interface Props$O {
+interface Props$N {
     label?: string;
     value: boolean;
     className?: string;
     name?: string;
+    title?: string;
     onChange: (value: boolean) => void;
 }
-declare class Checkbox extends Component<Props$O, SpreadsheetChildEnv> {
+declare class Checkbox extends Component<Props$N, SpreadsheetChildEnv> {
     static template: string;
     static props: {
         label: {
@@ -5303,6 +5346,10 @@ declare class Checkbox extends Component<Props$O, SpreadsheetChildEnv> {
             type: StringConstructor;
             optional: boolean;
         };
+        title: {
+            type: StringConstructor;
+            optional: boolean;
+        };
         onChange: FunctionConstructor;
     };
     static defaultProps: {
@@ -5311,10 +5358,10 @@ declare class Checkbox extends Component<Props$O, SpreadsheetChildEnv> {
     onChange(ev: InputEvent): void;
 }
 
-interface Props$N {
+interface Props$M {
     class?: string;
 }
-declare class Section extends Component<Props$N, SpreadsheetChildEnv> {
+declare class Section extends Component<Props$M, SpreadsheetChildEnv> {
     static template: string;
     static props: {
         class: {
@@ -5325,13 +5372,13 @@ declare class Section extends Component<Props$N, SpreadsheetChildEnv> {
     };
 }
 
-interface Props$M {
+interface Props$L {
     ranges: string[];
     hasSingleRange?: boolean;
     onSelectionChanged: (ranges: string[]) => void;
     onSelectionConfirmed: () => void;
 }
-declare class ChartDataSeries extends Component<Props$M, SpreadsheetChildEnv> {
+declare class ChartDataSeries extends Component<Props$L, SpreadsheetChildEnv> {
     static template: string;
     static components: {
         SelectionInput: typeof SelectionInput;
@@ -5349,10 +5396,10 @@ declare class ChartDataSeries extends Component<Props$M, SpreadsheetChildEnv> {
     get title(): string;
 }
 
-interface Props$L {
+interface Props$K {
     messages: string[];
 }
-declare class ChartErrorSection extends Component<Props$L, SpreadsheetChildEnv> {
+declare class ChartErrorSection extends Component<Props$K, SpreadsheetChildEnv> {
     static template: string;
     static components: {
         Section: typeof Section;
@@ -5366,7 +5413,7 @@ declare class ChartErrorSection extends Component<Props$L, SpreadsheetChildEnv>
     };
 }
 
-interface Props$K {
+interface Props$J {
     title?: string;
     range: string;
     isInvalid: boolean;
@@ -5380,7 +5427,7 @@ interface Props$K {
         onChange: (value: boolean) => void;
     }>;
 }
-declare class ChartLabelRange extends Component<Props$K, SpreadsheetChildEnv> {
+declare class ChartLabelRange extends Component<Props$J, SpreadsheetChildEnv> {
     static template: string;
     static components: {
         SelectionInput: typeof SelectionInput;
@@ -5405,16 +5452,16 @@ declare class ChartLabelRange extends Component<Props$K, SpreadsheetChildEnv> {
             optional: boolean;
         };
     };
-    static defaultProps: Partial<Props$K>;
+    static defaultProps: Partial<Props$J>;
 }
 
-interface Props$J {
+interface Props$I {
     figureId: UID;
     definition: LineChartDefinition | BarChartDefinition | PieChartDefinition;
     canUpdateChart: (figureId: UID, definition: Partial<LineChartDefinition | BarChartDefinition | PieChartDefinition>) => DispatchResult;
     updateChart: (figureId: UID, definition: Partial<LineChartDefinition | BarChartDefinition | PieChartDefinition>) => DispatchResult;
 }
-declare class LineBarPieConfigPanel extends Component<Props$J, SpreadsheetChildEnv> {
+declare class LineBarPieConfigPanel extends Component<Props$I, SpreadsheetChildEnv> {
     static template: string;
     static components: {
         SelectionInput: typeof SelectionInput;
@@ -5614,7 +5661,7 @@ declare class ColorPicker extends Component<ColorPickerProps, SpreadsheetChildEn
     isSameColor(color1: Color, color2: Color): boolean;
 }
 
-interface Props$I {
+interface Props$H {
     currentColor: string | undefined;
     toggleColorPicker: () => void;
     showColorPicker: boolean;
@@ -5625,7 +5672,7 @@ interface Props$I {
     dropdownMaxHeight?: Pixel;
     class?: string;
 }
-declare class ColorPickerWidget extends Component<Props$I, SpreadsheetChildEnv> {
+declare class ColorPickerWidget extends Component<Props$H, SpreadsheetChildEnv> {
     static template: string;
     static props: {
         currentColor: {
@@ -5663,11 +5710,11 @@ declare class ColorPickerWidget extends Component<Props$I, SpreadsheetChildEnv>
     get colorPickerAnchorRect(): Rect;
 }
 
-interface Props$H {
+interface Props$G {
     currentColor?: string;
     onColorPicked: (color: string) => void;
 }
-declare class ChartColor extends Component<Props$H, SpreadsheetChildEnv> {
+declare class ChartColor extends Component<Props$G, SpreadsheetChildEnv> {
     static template: string;
     static components: {
         ColorPickerWidget: typeof ColorPickerWidget;
@@ -5686,11 +5733,11 @@ declare class ChartColor extends Component<Props$H, SpreadsheetChildEnv> {
     togglePicker(): void;
 }
 
-interface Props$G {
+interface Props$F {
     title: string;
     update: (title: string) => void;
 }
-declare class ChartTitle extends Component<Props$G, SpreadsheetChildEnv> {
+declare class ChartTitle extends Component<Props$F, SpreadsheetChildEnv> {
     static template: string;
     static components: {
         Section: typeof Section;
@@ -5702,13 +5749,13 @@ declare class ChartTitle extends Component<Props$G, SpreadsheetChildEnv> {
     updateTitle(ev: InputEvent): void;
 }
 
-interface Props$F {
+interface Props$E {
     figureId: UID;
     definition: LineChartDefinition | BarChartDefinition | PieChartDefinition;
     canUpdateChart: (definition: Partial<LineChartDefinition | BarChartDefinition | PieChartDefinition>) => DispatchResult;
     updateChart: (figureId: UID, definition: Partial<LineChartDefinition | BarChartDefinition | PieChartDefinition>) => DispatchResult;
 }
-declare class LineBarPieDesignPanel extends Component<Props$F, SpreadsheetChildEnv> {
+declare class LineBarPieDesignPanel extends Component<Props$E, SpreadsheetChildEnv> {
     static template: string;
     static components: {
         ChartColor: typeof ChartColor;
@@ -5727,13 +5774,13 @@ declare class LineBarPieDesignPanel extends Component<Props$F, SpreadsheetChildE
     updateSelect(attr: string, ev: any): void;
 }
 
-interface Props$E {
+interface Props$D {
     figureId: UID;
     definition: GaugeChartDefinition;
     canUpdateChart: (figureId: UID, definition: Partial<GaugeChartDefinition>) => DispatchResult;
     updateChart: (figureId: UID, definition: Partial<GaugeChartDefinition>) => DispatchResult;
 }
-declare class GaugeChartConfigPanel extends Component<Props$E, SpreadsheetChildEnv> {
+declare class GaugeChartConfigPanel extends Component<Props$D, SpreadsheetChildEnv> {
     static template: string;
     static components: {
         ChartErrorSection: typeof ChartErrorSection;
@@ -5755,13 +5802,13 @@ declare class GaugeChartConfigPanel extends Component<Props$E, SpreadsheetChildE
 }
 
 type GaugeMenu = "sectionColor-lowerColor" | "sectionColor-middleColor" | "sectionColor-upperColor";
-interface Props$D {
+interface Props$C {
     figureId: UID;
     definition: GaugeChartDefinition;
     canUpdateChart: (figureId: UID, definition: Partial<GaugeChartDefinition>) => DispatchResult;
     updateChart: (figureId: UID, definition: Partial<GaugeChartDefinition>) => DispatchResult;
 }
-declare class GaugeChartDesignPanel extends Component<Props$D, SpreadsheetChildEnv> {
+declare class GaugeChartDesignPanel extends Component<Props$C, SpreadsheetChildEnv> {
     static template: string;
     static components: {
         ColorPickerWidget: typeof ColorPickerWidget;
@@ -5810,13 +5857,13 @@ declare class LineConfigPanel extends LineBarPieConfigPanel {
     onUpdateCumulative(cumulative: boolean): void;
 }
 
-interface Props$C {
+interface Props$B {
     figureId: UID;
     definition: ScorecardChartDefinition;
     canUpdateChart: (figureId: UID, definition: Partial<ScorecardChartDefinition>) => DispatchResult;
     updateChart: (figureId: UID, definition: Partial<ScorecardChartDefinition>) => DispatchResult;
 }
-declare class ScorecardChartConfigPanel extends Component<Props$C, SpreadsheetChildEnv> {
+declare class ScorecardChartConfigPanel extends Component<Props$B, SpreadsheetChildEnv> {
     static template: string;
     static components: {
         SelectionInput: typeof SelectionInput;
@@ -5845,13 +5892,13 @@ declare class ScorecardChartConfigPanel extends Component<Props$C, SpreadsheetCh
 }
 
 type ColorPickerId = undefined | "backgroundColor" | "baselineColorUp" | "baselineColorDown";
-interface Props$B {
+interface Props$A {
     figureId: UID;
     definition: ScorecardChartDefinition;
     canUpdateChart: (figureId: UID, definition: Partial<ScorecardChartDefinition>) => DispatchResult;
     updateChart: (figureId: UID, definition: Partial<ScorecardChartDefinition>) => DispatchResult;
 }
-declare class ScorecardChartDesignPanel extends Component<Props$B, SpreadsheetChildEnv> {
+declare class ScorecardChartDesignPanel extends Component<Props$A, SpreadsheetChildEnv> {
     static template: string;
     static components: {
         ColorPickerWidget: typeof ColorPickerWidget;
@@ -6163,10 +6210,10 @@ declare class ComposerFocusStore extends SpreadsheetStore {
     private setComposerContent;
 }
 
-interface Props$A {
+interface Props$z {
     figure: Figure;
 }
-declare class ChartJsComponent extends Component<Props$A, SpreadsheetChildEnv> {
+declare class ChartJsComponent extends Component<Props$z, SpreadsheetChildEnv> {
     static template: string;
     static props: {
         figure: ObjectConstructor;
@@ -6181,10 +6228,10 @@ declare class ChartJsComponent extends Component<Props$A, SpreadsheetChildEnv> {
     private updateChartJs;
 }
 
-interface Props$z {
+interface Props$y {
     figure: Figure;
 }
-declare class ScorecardChart extends Component<Props$z, SpreadsheetChildEnv> {
+declare class ScorecardChart extends Component<Props$y, SpreadsheetChildEnv> {
     static template: string;
     static props: {
         figure: ObjectConstructor;
@@ -6196,7 +6243,7 @@ declare class ScorecardChart extends Component<Props$z, SpreadsheetChildEnv> {
 }
 
 type MenuItemOrSeparator = Action | "separator";
-interface Props$y {
+interface Props$x {
     position: DOMCoordinates;
     menuItems: Action[];
     depth: number;
@@ -6212,7 +6259,7 @@ interface MenuState {
     scrollOffset?: Pixel;
     menuItems: Action[];
 }
-declare class Menu extends Component<Props$y, SpreadsheetChildEnv> {
+declare class Menu extends Component<Props$x, SpreadsheetChildEnv> {
     static template: string;
     static props: {
         position: ObjectConstructor;
@@ -6273,14 +6320,14 @@ declare class Menu extends Component<Props$y, SpreadsheetChildEnv> {
 }
 
 type ResizeAnchor = "top left" | "top" | "top right" | "right" | "bottom right" | "bottom" | "bottom left" | "left";
-interface Props$x {
+interface Props$w {
     figure: Figure;
     style: string;
     onFigureDeleted: () => void;
     onMouseDown: (ev: MouseEvent) => void;
     onClickAnchor(dirX: ResizeDirection, dirY: ResizeDirection, ev: MouseEvent): void;
 }
-declare class FigureComponent extends Component<Props$x, SpreadsheetChildEnv> {
+declare class FigureComponent extends Component<Props$w, SpreadsheetChildEnv> {
     static template: string;
     static props: {
         figure: ObjectConstructor;
@@ -6329,11 +6376,11 @@ declare class FigureComponent extends Component<Props$x, SpreadsheetChildEnv> {
     private openContextMenu;
 }
 
-interface Props$w {
+interface Props$v {
     figure: Figure;
     onFigureDeleted: () => void;
 }
-declare class ChartFigure extends Component<Props$w, SpreadsheetChildEnv> {
+declare class ChartFigure extends Component<Props$v, SpreadsheetChildEnv> {
     static template: string;
     static props: {
         figure: ObjectConstructor;
@@ -6345,7 +6392,7 @@ declare class ChartFigure extends Component<Props$w, SpreadsheetChildEnv> {
     get chartComponent(): new (...args: any) => Component;
 }
 
-interface Props$v {
+interface Props$u {
     isVisible: boolean;
     position: Position;
 }
@@ -6353,17 +6400,17 @@ interface Position {
     top: HeaderIndex;
     left: HeaderIndex;
 }
-interface State$6 {
+interface State$5 {
     position: Position;
     handler: boolean;
 }
-declare class Autofill extends Component<Props$v, SpreadsheetChildEnv> {
+declare class Autofill extends Component<Props$u, SpreadsheetChildEnv> {
     static template: string;
     static props: {
         position: ObjectConstructor;
         isVisible: BooleanConstructor;
     };
-    state: State$6;
+    state: State$5;
     get style(): string;
     get handlerStyle(): string;
     get styleNextValue(): string;
@@ -6391,14 +6438,14 @@ declare class ClientTag extends Component<ClientTagProps, SpreadsheetChildEnv> {
     get tagStyle(): string;
 }
 
-interface Props$u {
+interface Props$t {
     values: AutocompleteValue[];
     selectedIndex: number | undefined;
     getHtmlContent: (value: string) => string;
     onValueSelected: (value: string) => void;
     onValueHovered: (index: string) => void;
 }
-declare class TextValueProvider extends Component<Props$u> {
+declare class TextValueProvider extends Component<Props$t> {
     static template: string;
     static props: {
         values: ArrayConstructor;
@@ -6410,6 +6457,8 @@ declare class TextValueProvider extends Component<Props$u> {
         onValueSelected: FunctionConstructor;
         onValueHovered: FunctionConstructor;
     };
+    private autoCompleteListRef;
+    setup(): void;
 }
 
 declare class ContentEditableHelper {
@@ -6472,7 +6521,7 @@ declare class ContentEditableHelper {
     getText(): string;
 }
 
-interface Props$t {
+interface Props$s {
     functionName: string;
     functionDescription: FunctionDescription;
     argToFocus: number;
@@ -6480,7 +6529,7 @@ interface Props$t {
 interface AssistantState {
     allowCellSelectionBehind: boolean;
 }
-declare class FunctionDescriptionProvider extends Component<Props$t> {
+declare class FunctionDescriptionProvider extends Component<Props$s> {
     static template: string;
     static props: {
         functionName: StringConstructor;
@@ -6490,7 +6539,7 @@ declare class FunctionDescriptionProvider extends Component<Props$t> {
     assistantState: AssistantState;
     private timeOutId;
     setup(): void;
-    getContext(): Props$t;
+    getContext(): Props$s;
     onMouseMove(): void;
 }
 
@@ -6635,14 +6684,14 @@ declare class Composer extends Component<ComposerProps, SpreadsheetChildEnv> {
     private showDataValidationAutocomplete;
 }
 
-interface Props$s {
+interface Props$r {
     gridDims: DOMDimension;
 }
 /**
  * This component is a composer which positions itself on the grid at the anchor cell.
  * It also applies the style of the cell to the composer input.
  */
-declare class GridComposer extends Component<Props$s, SpreadsheetChildEnv> {
+declare class GridComposer extends Component<Props$r, SpreadsheetChildEnv> {
     static template: string;
     static props: {
         gridDims: ObjectConstructor;
@@ -6724,10 +6773,10 @@ declare class CellPopoverStore extends SpreadsheetStore {
     private computePopoverAnchorRect;
 }
 
-interface Props$r {
+interface Props$q {
     cellPosition: CellPosition;
 }
-declare class FilterIcon extends Component<Props$r, SpreadsheetChildEnv> {
+declare class FilterIcon extends Component<Props$q, SpreadsheetChildEnv> {
     static template: string;
     static props: {
         cellPosition: ObjectConstructor;
@@ -6738,10 +6787,10 @@ declare class FilterIcon extends Component<Props$r, SpreadsheetChildEnv> {
     get isFilterActive(): boolean;
 }
 
-interface Props$q {
+interface Props$p {
     gridPosition: DOMCoordinates;
 }
-declare class FilterIconsOverlay extends Component<Props$q, SpreadsheetChildEnv> {
+declare class FilterIconsOverlay extends Component<Props$p, SpreadsheetChildEnv> {
     static template: string;
     static props: {
         gridPosition: {
@@ -6762,10 +6811,10 @@ declare class FilterIconsOverlay extends Component<Props$q, SpreadsheetChildEnv>
     getFilterHeadersPositions(): CellPosition[];
 }
 
-interface Props$p {
+interface Props$o {
     cellPosition: CellPosition;
 }
-declare class DataValidationCheckbox extends Component<Props$p, SpreadsheetChildEnv> {
+declare class DataValidationCheckbox extends Component<Props$o, SpreadsheetChildEnv> {
     static template: string;
     static props: {
         cellPosition: ObjectConstructor;
@@ -6775,10 +6824,10 @@ declare class DataValidationCheckbox extends Component<Props$p, SpreadsheetChild
     get isDisabled(): boolean;
 }
 
-interface Props$o {
+interface Props$n {
     cellPosition: CellPosition;
 }
-declare class DataValidationListIcon extends Component<Props$o, SpreadsheetChildEnv> {
+declare class DataValidationListIcon extends Component<Props$n, SpreadsheetChildEnv> {
     static template: string;
     static props: {
         cellPosition: ObjectConstructor;
@@ -6808,7 +6857,7 @@ interface SnapLine<T extends HFigureAxisType | VFigureAxisType> {
 }
 
 type ContainerType = "topLeft" | "topRight" | "bottomLeft" | "bottomRight" | "dnd";
-interface Props$n {
+interface Props$m {
     onFigureDeleted: () => void;
 }
 interface Container {
@@ -6887,7 +6936,7 @@ interface DndState {
  * that occurred during the drag & drop, and to position the figure on the correct pane.
  *
  */
-declare class FiguresContainer extends Component<Props$n, SpreadsheetChildEnv> {
+declare class FiguresContainer extends Component<Props$m, SpreadsheetChildEnv> {
     static template: string;
     static props: {
         onFigureDeleted: FunctionConstructor;
@@ -6922,10 +6971,10 @@ declare class FiguresContainer extends Component<Props$n, SpreadsheetChildEnv> {
     private getSnapLineStyle;
 }
 
-interface Props$m {
+interface Props$l {
     focusGrid: () => void;
 }
-declare class GridAddRowsFooter extends Component<Props$m, SpreadsheetChildEnv> {
+declare class GridAddRowsFooter extends Component<Props$l, SpreadsheetChildEnv> {
     static template: string;
     static props: {
         focusGrid: FunctionConstructor;
@@ -6949,7 +6998,7 @@ declare class GridAddRowsFooter extends Component<Props$m, SpreadsheetChildEnv>
     private onExternalClick;
 }
 
-interface Props$l {
+interface Props$k {
     onCellHovered: (position: Partial<Position$1>) => void;
     onCellDoubleClicked: (col: HeaderIndex, row: HeaderIndex) => void;
     onCellClicked: (col: HeaderIndex, row: HeaderIndex, modifiers: {
@@ -6962,7 +7011,7 @@ interface Props$l {
     gridOverlayDimensions: string;
     onFigureDeleted: () => void;
 }
-declare class GridOverlay extends Component<Props$l, SpreadsheetChildEnv> {
+declare class GridOverlay extends Component<Props$k, SpreadsheetChildEnv> {
     static template: string;
     static props: {
         onCellHovered: {
@@ -7017,12 +7066,12 @@ declare class GridOverlay extends Component<Props$l, SpreadsheetChildEnv> {
     private getCartesianCoordinates;
 }
 
-interface Props$k {
+interface Props$j {
     gridRect: Rect;
     onClosePopover: () => void;
     onMouseWheel: (ev: WheelEvent) => void;
 }
-declare class GridPopover extends Component<Props$k, SpreadsheetChildEnv> {
+declare class GridPopover extends Component<Props$j, SpreadsheetChildEnv> {
     static template: string;
     static props: {
         onClosePopover: FunctionConstructor;
@@ -7165,13 +7214,13 @@ declare class HeadersOverlay extends Component<any, SpreadsheetChildEnv> {
 }
 
 type Orientation$1 = "n" | "s" | "w" | "e";
-interface Props$j {
+interface Props$i {
     zone: Zone;
     orientation: Orientation$1;
     isMoving: boolean;
     onMoveHighlight: (x: Pixel, y: Pixel) => void;
 }
-declare class Border extends Component<Props$j, SpreadsheetChildEnv> {
+declare class Border extends Component<Props$i, SpreadsheetChildEnv> {
     static template: string;
     static props: {
         zone: ObjectConstructor;
@@ -7184,14 +7233,14 @@ declare class Border extends Component<Props$j, SpreadsheetChildEnv> {
 }
 
 type Orientation = "nw" | "ne" | "sw" | "se";
-interface Props$i {
+interface Props$h {
     zone: Zone;
     color: Color;
     orientation: Orientation;
     isResizing: boolean;
     onResizeHighlight: (isLeft: boolean, isRight: boolean) => void;
 }
-declare class Corner extends Component<Props$i, SpreadsheetChildEnv> {
+declare class Corner extends Component<Props$h, SpreadsheetChildEnv> {
     static template: string;
     static props: {
         zone: ObjectConstructor;
@@ -7206,14 +7255,14 @@ declare class Corner extends Component<Props$i, SpreadsheetChildEnv> {
     onMouseDown(ev: MouseEvent): void;
 }
 
-interface Props$h {
+interface Props$g {
     zone: Zone;
     color: Color;
 }
 interface HighlightState {
     shiftingMode: "isMoving" | "isResizing" | "none";
 }
-declare class Highlight extends Component<Props$h, SpreadsheetChildEnv> {
+declare class Highlight extends Component<Props$g, SpreadsheetChildEnv> {
     static template: string;
     static props: {
         zone: ObjectConstructor;
@@ -7230,7 +7279,7 @@ declare class Highlight extends Component<Props$h, SpreadsheetChildEnv> {
 
 type ScrollDirection = "horizontal" | "vertical";
 
-interface Props$g {
+interface Props$f {
     width: Pixel;
     height: Pixel;
     direction: ScrollDirection;
@@ -7238,7 +7287,7 @@ interface Props$g {
     offset: Pixel;
     onScroll: (offset: Pixel) => void;
 }
-declare class ScrollBar extends Component<Props$g> {
+declare class ScrollBar extends Component<Props$f> {
     static props: {
         width: {
             type: NumberConstructor;
@@ -7266,10 +7315,10 @@ declare class ScrollBar extends Component<Props$g> {
     onScroll(ev: any): void;
 }
 
-interface Props$f {
+interface Props$e {
     leftOffset: number;
 }
-declare class HorizontalScrollBar extends Component<Props$f, SpreadsheetChildEnv> {
+declare class HorizontalScrollBar extends Component<Props$e, SpreadsheetChildEnv> {
     static props: {
         leftOffset: {
             type: NumberConstructor;
@@ -7295,10 +7344,10 @@ declare class HorizontalScrollBar extends Component<Props$f, SpreadsheetChildEnv
     onScroll(offset: any): void;
 }
 
-interface Props$e {
+interface Props$d {
     topOffset: number;
 }
-declare class VerticalScrollBar extends Component<Props$e, SpreadsheetChildEnv> {
+declare class VerticalScrollBar extends Component<Props$d, SpreadsheetChildEnv> {
     static props: {
         topOffset: {
             type: NumberConstructor;
@@ -7324,6 +7373,19 @@ declare class VerticalScrollBar extends Component<Props$e, SpreadsheetChildEnv>
     onScroll(offset: any): void;
 }
 
+interface SidePanelProps {
+    onCloseSidePanel?: () => void;
+    [key: string]: unknown;
+}
+declare class SidePanelStore extends SpreadsheetStore {
+    isOpen: boolean;
+    panelProps: SidePanelProps;
+    componentTag: string;
+    open(componentTag: string, panelProps?: SidePanelProps): void;
+    toggle(componentTag: string, panelProps: SidePanelProps): void;
+    close(): void;
+}
+
 declare class HoveredCellStore extends SpreadsheetStore {
     col: number | undefined;
     row: number | undefined;
@@ -7343,14 +7405,12 @@ declare class HoveredCellStore extends SpreadsheetStore {
  * - a vertical resizer (same, for rows)
  */
 type ContextMenuType = "ROW" | "COL" | "CELL" | "FILTER" | "GROUP_HEADERS" | "UNGROUP_HEADERS";
-interface Props$d {
-    sidePanelIsOpen: boolean;
+interface Props$c {
     exposeFocus: (focus: () => void) => void;
 }
-declare class Grid extends Component<Props$d, SpreadsheetChildEnv> {
+declare class Grid extends Component<Props$c, SpreadsheetChildEnv> {
     static template: string;
     static props: {
-        sidePanelIsOpen: BooleanConstructor;
         exposeFocus: FunctionConstructor;
     };
     static components: {
@@ -7379,6 +7439,7 @@ declare class Grid extends Component<Props$d, SpreadsheetChildEnv> {
     onMouseWheel: (ev: WheelEvent) => void;
     canvasPosition: DOMCoordinates;
     hoveredCell: Store<HoveredCellStore>;
+    sidePanel: Store<SidePanelStore>;
     setup(): void;
     onCellHovered({ col, row }: {
         col: any;
@@ -7439,21 +7500,21 @@ interface DndPartialArgs {
     onCancel?: () => void;
     onDragEnd?: (itemId: UID, indexAtEnd: Pixel) => void;
 }
-interface State$5 {
+interface State$4 {
     itemsStyle: Record<UID, string>;
     draggedItemId: UID | undefined;
     start: (direction: Direction, args: DndPartialArgs) => void;
     cancel: () => void;
 }
-declare function useDragAndDropListItems(): State$5;
+declare function useDragAndDropListItems(): State$4;
 
 declare function useHighlightsOnHover(ref: Ref<HTMLElement>, highlightProvider: HighlightProvider): void;
 declare function useHighlights(highlightProvider: HighlightProvider): void;
 
-interface Props$c {
+interface Props$b {
     onCloseSidePanel: () => void;
 }
-declare class ChartPanel extends Component<Props$c, SpreadsheetChildEnv> {
+declare class ChartPanel extends Component<Props$b, SpreadsheetChildEnv> {
     static template: string;
     static components: {
         Section: typeof Section;
@@ -7461,8 +7522,8 @@ declare class ChartPanel extends Component<Props$c, SpreadsheetChildEnv> {
     static props: {
         onCloseSidePanel: FunctionConstructor;
     };
-    private state;
-    get figureId(): UID;
+    private store;
+    get figureId(): UID | null;
     setup(): void;
     updateChart<T extends ChartDefinition>(figureId: UID, updateDefinition: Partial<T>): DispatchResult | undefined;
     canUpdateChart<T extends ChartDefinition>(figureId: UID, updateDefinition: Partial<T>): DispatchResult | undefined;
@@ -7470,7 +7531,6 @@ declare class ChartPanel extends Component<Props$c, SpreadsheetChildEnv> {
     get chartPanel(): ChartSidePanel;
     private getChartDefinition;
     get chartTypes(): Record<string, string>;
-    activatePanel(panel: "configuration" | "design"): void;
 }
 
 declare class FindAndReplaceStore extends SpreadsheetStore {
@@ -7721,13 +7781,13 @@ declare class Ripple extends Component<RippleProps, SpreadsheetChildEnv> {
     getRippleEffectProps(id: number): RippleEffectProps;
 }
 
-interface Props$b {
+interface Props$a {
     sheetId: string;
     openContextMenu: (registry: MenuItemRegistry, ev: MouseEvent) => void;
     style?: string;
     onMouseDown: (ev: MouseEvent) => void;
 }
-declare class BottomBarSheet extends Component<Props$b, SpreadsheetChildEnv> {
+declare class BottomBarSheet extends Component<Props$a, SpreadsheetChildEnv> {
     static template: string;
     static props: {
         sheetId: StringConstructor;
@@ -7773,11 +7833,11 @@ declare class BottomBarSheet extends Component<Props$b, SpreadsheetChildEnv> {
     get sheetName(): string;
 }
 
-interface Props$a {
+interface Props$9 {
     openContextMenu: (x: number, y: number, registry: MenuItemRegistry) => void;
     closeContextMenu: () => void;
 }
-declare class BottomBarStatistic extends Component<Props$a, SpreadsheetChildEnv> {
+declare class BottomBarStatistic extends Component<Props$9, SpreadsheetChildEnv> {
     static template: string;
     static props: {
         openContextMenu: FunctionConstructor;
@@ -7798,13 +7858,13 @@ interface BottomBarSheetItem {
     id: UID;
     name: string;
 }
-interface Props$9 {
+interface Props$8 {
     onClick: () => void;
 }
 interface BottomBarMenuState extends MenuState {
     menuId: UID | undefined;
 }
-declare class BottomBar extends Component<Props$9, SpreadsheetChildEnv> {
+declare class BottomBar extends Component<Props$8, SpreadsheetChildEnv> {
     static template: string;
     static props: {
         onClick: FunctionConstructor;
@@ -7846,7 +7906,7 @@ declare class BottomBar extends Component<Props$9, SpreadsheetChildEnv> {
     get sheetListMaxScroll(): number;
 }
 
-interface Props$8 {
+interface Props$7 {
 }
 interface ClickableCell {
     coordinates: Rect;
@@ -7854,7 +7914,7 @@ interface ClickableCell {
     action: (position: CellPosition, env: SpreadsheetChildEnv) => void;
     tKey: string;
 }
-declare class SpreadsheetDashboard extends Component<Props$8, SpreadsheetChildEnv> {
+declare class SpreadsheetDashboard extends Component<Props$7, SpreadsheetChildEnv> {
     static template: string;
     static props: {};
     static components: {
@@ -7892,7 +7952,7 @@ declare class SpreadsheetDashboard extends Component<Props$8, SpreadsheetChildEn
     private getGridRect;
 }
 
-interface Props$7 {
+interface Props$6 {
     group: HeaderGroup;
     layerOffset: number;
     openContextMenu(position: DOMCoordinates, menuItems: Action[]): void;
@@ -7902,7 +7962,7 @@ interface GroupBox {
     headerRect: Rect;
     isEndHidden: boolean;
 }
-declare abstract class AbstractHeaderGroup extends Component<Props$7, SpreadsheetChildEnv> {
+declare abstract class AbstractHeaderGroup extends Component<Props$6, SpreadsheetChildEnv> {
     static template: string;
     static props: {
         group: ObjectConstructor;
@@ -7934,11 +7994,11 @@ declare class ColGroup extends AbstractHeaderGroup {
     get groupBox(): GroupBox;
 }
 
-interface Props$6 {
+interface Props$5 {
     dimension: Dimension;
     layers: HeaderGroup[][];
 }
-declare class HeaderGroupContainer extends Component<Props$6, SpreadsheetChildEnv> {
+declare class HeaderGroupContainer extends Component<Props$5, SpreadsheetChildEnv> {
     static template: string;
     static props: {
         dimension: StringConstructor;
@@ -7961,26 +8021,13 @@ declare class HeaderGroupContainer extends Component<Props$6, SpreadsheetChildEn
     get frozenPaneContainerSize(): Pixel;
 }
 
-interface Props$5 {
-    component: string;
-    panelProps: any;
-    onCloseSidePanel: () => void;
-}
-interface State$4 {
-    panel: SidePanelContent;
-}
-declare class SidePanel extends Component<Props$5, SpreadsheetChildEnv> {
+declare class SidePanel extends Component<never, SpreadsheetChildEnv> {
     static template: string;
-    static props: {
-        component: StringConstructor;
-        panelProps: {
-            type: ObjectConstructor;
-            optional: boolean;
-        };
-        onCloseSidePanel: FunctionConstructor;
-    };
-    state: State$4;
+    static props: {};
+    sidePanelStore: Store<SidePanelStore>;
     setup(): void;
+    get panel(): SidePanelContent;
+    close(): void;
     getTitle(): string;
 }
 
@@ -8532,11 +8579,6 @@ declare class TopBar extends Component<Props, SpreadsheetChildEnv> {
 interface SpreadsheetProps {
     model: Model;
 }
-interface SidePanelState {
-    isOpen: boolean;
-    component?: string;
-    panelProps: any;
-}
 declare class Spreadsheet extends Component<SpreadsheetProps, SpreadsheetChildEnv> {
     static template: string;
     static props: {
@@ -8550,7 +8592,7 @@ declare class Spreadsheet extends Component<SpreadsheetProps, SpreadsheetChildEn
         SpreadsheetDashboard: typeof SpreadsheetDashboard;
         HeaderGroupContainer: typeof HeaderGroupContainer;
     };
-    sidePanel: SidePanelState;
+    sidePanel: Store<SidePanelStore>;
     spreadsheetRef: {
         el: HTMLElement | null;
     };
@@ -8565,9 +8607,6 @@ declare class Spreadsheet extends Component<SpreadsheetProps, SpreadsheetChildEn
     private bindModelEvents;
     private unbindModelEvents;
     private checkViewportSize;
-    openSidePanel(panel: string, panelProps: any): void;
-    closeSidePanel(): void;
-    toggleSidePanel(panel: string, panelProps: any): void;
     focusGrid(): void;
     onKeydown(ev: KeyboardEvent): void;
     get gridHeight(): Pixel;
@@ -9489,6 +9528,10 @@ declare const helpers: {
     deepEquals: typeof deepEquals;
     overlap: typeof overlap;
     union: typeof union;
+    isInside: typeof isInside;
+    deepCopy: typeof deepCopy;
+    expandZoneOnInsertion: typeof expandZoneOnInsertion;
+    reduceZoneOnDeletion: typeof reduceZoneOnDeletion;
 };
 declare const links: {
     isMarkdownLink: typeof isMarkdownLink;
@@ -9543,6 +9586,9 @@ declare const stores: {
     RendererStore: typeof RendererStore;
     SelectionInputStore: typeof SelectionInputStore;
     SpreadsheetStore: typeof SpreadsheetStore;
+    useStore: typeof useStore;
+    useLocalStore: typeof useLocalStore;
+    SidePanelStore: typeof SidePanelStore;
 };
 declare function addFunction(functionName: string, functionDescription: AddFunctionDescription): {
     addFunction: (fName: string, fDescription: AddFunctionDescription) => any;
@@ -9552,4 +9598,4 @@ declare const constants: {
     SECONDARY_COLOR: string;
 };
 
-export { AST, ASTFuncall, AbstractChart, AddFunctionDescription, Arg, CancelledReason, Cell, CellErrorType, CellPosition, Client, ClientJoinedMessage, ClientLeftMessage, ClientMovedMessage, CollaborationMessage, CommandResult, CorePlugin, DispatchResult, EnrichedToken, EvalContext, EvaluationError, FPayload, FunctionRegistry, Model, Registry, RemoteRevisionMessage, Revision, RevisionRedoneMessage, RevisionUndoneMessage, SPREADSHEET_DIMENSIONS, Spreadsheet, Token, TransportService, UIPlugin, __info__, addFunction, astToFormula, compile, compileTokens, components, constants, convertAstNodes, coreTypes, findCellInNewZone, functionCache, helpers, hooks, invalidateCFEvaluationCommands, invalidateDependenciesCommands, invalidateEvaluationCommands, iterateAstNodes, links, load, parse, parseTokens, readonlyAllowedCommands, registries, setDefaultSheetViewSize, setTranslationMethod, stores, tokenize };
+export { AST, ASTFuncall, AbstractCellClipboardHandler, AbstractChart, AbstractFigureClipboardHandler, AddFunctionDescription, Arg, CancelledReason, Cell, CellErrorType, CellPosition, Client, ClientJoinedMessage, ClientLeftMessage, ClientMovedMessage, CollaborationMessage, CommandResult, CorePlugin, DispatchResult, EnrichedToken, EvalContext, EvaluationError, FPayload, FunctionRegistry, Model, Registry, RemoteRevisionMessage, Revision, RevisionRedoneMessage, RevisionUndoneMessage, SPREADSHEET_DIMENSIONS, Spreadsheet, Token, TransportService, UIPlugin, __info__, addFunction, astToFormula, compile, compileTokens, components, constants, convertAstNodes, coreTypes, findCellInNewZone, functionCache, helpers, hooks, invalidateCFEvaluationCommands, invalidateDependenciesCommands, invalidateEvaluationCommands, iterateAstNodes, links, load, parse, parseTokens, readonlyAllowedCommands, registries, setDefaultSheetViewSize, setTranslationMethod, stores, tokenize };