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

package/dist/o-spreadsheet.d.ts

@@ -17,6 +17,7 @@ declare const functionCache: {
     [key: string]: Omit<CompiledFormula, "dependencies" | "tokens">;
 };
 declare function compile(formula: string): CompiledFormula;
+declare function compileTokens(tokens: Token[]): CompiledFormula;
 
 interface FunctionContext {
     parent: string;
@@ -93,6 +94,7 @@ type AST = ASTOperation | ASTUnaryOperation | ASTFuncall | ASTNumber | ASTBoolea
  * Parse an expression (as a string) into an AST.
  */
 declare function parse(str: string): AST;
+declare function parseTokens(tokens: Token[]): AST;
 /**
  * Allows to visit all nodes of an AST and apply a mapping function
  * to nodes of a specific type.
@@ -1428,80 +1430,6 @@ declare class UIPlugin<State = any> extends BasePlugin<State, Command> {
     drawGrid(ctx: GridRenderingContext, layer: LAYERS): void;
 }
 
-interface SearchOptions {
-    matchCase: boolean;
-    exactMatch: boolean;
-    searchFormulas: boolean;
-}
-interface SearchMatch {
-    selected: boolean;
-    col: HeaderIndex;
-    row: HeaderIndex;
-}
-/**
- * Find and Replace Plugin
- *
- * This plugin is used in combination with the find_and_replace sidePanel
- * It is used to 'highlight' cells that match an input string according to
- * the given searchOptions. The second part of this plugin makes it possible
- * (again with the find_and_replace sidePanel), to replace the values that match
- * the search with a new value.
- */
-declare class FindAndReplacePlugin extends UIPlugin {
-    static layers: LAYERS[];
-    static getters: readonly ["getSearchMatches", "getCurrentSelectedMatchIndex"];
-    private searchMatches;
-    private selectedMatchIndex;
-    private currentSearchRegex;
-    private searchOptions;
-    private toSearch;
-    private isSearchDirty;
-    handle(cmd: Command): void;
-    finalize(): void;
-    getSearchMatches(): SearchMatch[];
-    getCurrentSelectedMatchIndex(): number | null;
-    /**
-     * Will update the current searchOptions and accordingly update the regex.
-     * It will then search for matches using the regex and store them.
-     */
-    private updateSearch;
-    /**
-     * refresh the matches according to the current search options
-     */
-    private refreshSearch;
-    /**
-     * Updates the regex based on the current searchOptions and
-     * the value toSearch
-     */
-    private updateRegex;
-    /**
-     * Find matches using the current regex
-     */
-    private findMatches;
-    private sortByRowThenColumn;
-    /**
-     * Changes the selected search cell. Given a direction it will
-     * Change the selection to the previous, current or nextCell,
-     * if it exists otherwise it will set the selectedMatchIndex to null.
-     * It will also reset the index to 0 if the search has changed.
-     * It is also used to keep coherence between the selected searchMatch
-     * and selectedMatchIndex.
-     */
-    private selectNextCell;
-    private clearSearch;
-    private replaceMatch;
-    /**
-     * Replace the value of the currently selected match
-     */
-    private replace;
-    /**
-     * Apply the replace function to all the matches one time.
-     */
-    private replaceAll;
-    private getSearchableString;
-    drawGrid(renderingContext: GridRenderingContext): void;
-}
-
 type EditionMode = "editing" | "selecting" | "inactive";
 interface ComposerSelection {
     start: number;
@@ -1689,6 +1617,14 @@ type ClipboardContent = {
 };
 type ClipboardPasteOptions = "onlyFormat" | "onlyValue";
 
+interface SearchOptions {
+    matchCase: boolean;
+    exactMatch: boolean;
+    searchFormulas: boolean;
+    searchScope: "allSheets" | "activeSheet" | "specificRange";
+    specificRange?: RangeData;
+}
+
 /**
  * There are two kinds of commands: CoreCommands and LocalCommands
  *
@@ -2497,7 +2433,8 @@ declare const enum CommandResult {
     InvalidDataValidationCriterionValue = "InvalidDataValidationCriterionValue",
     InvalidNumberOfCriterionValues = "InvalidNumberOfCriterionValues",
     BlockingValidationRule = "BlockingValidationRule",
-    InvalidCopyPasteSelection = "InvalidCopyPasteSelection"
+    InvalidCopyPasteSelection = "InvalidCopyPasteSelection",
+    NoChanges = "NoChanges"
 }
 interface CommandHandler<T> {
     allowDispatch(command: T): CommandResult | CommandResult[];
@@ -2652,6 +2589,9 @@ interface CompiledFormula {
     tokens: Token[];
     dependencies: string[];
 }
+interface RangeCompiledFormula extends Omit<CompiledFormula, "dependencies"> {
+    dependencies: Range[];
+}
 type Matrix<T = unknown> = T[][];
 type ValueAndFormat = {
     value: CellValue;
@@ -2803,8 +2743,7 @@ interface LiteralCell extends CellAttributes {
 }
 interface FormulaCell extends CellAttributes {
     readonly isFormula: true;
-    readonly compiledFormula: CompiledFormula;
-    readonly dependencies: Range[];
+    readonly compiledFormula: RangeCompiledFormula;
 }
 type Cell = LiteralCell | FormulaCell;
 interface EvaluatedCellProperties {
@@ -3074,50 +3013,6 @@ interface SpreadsheetChildEnv extends SpreadsheetEnv {
     loadLocales: () => Promise<Locale[]>;
 }
 
-type ArgType = "ANY" | "BOOLEAN" | "NUMBER" | "STRING" | "DATE" | "RANGE" | "RANGE<BOOLEAN>" | "RANGE<NUMBER>" | "RANGE<DATE>" | "RANGE<STRING>" | "RANGE<ANY>" | "META";
-interface ArgDefinition {
-    repeating?: boolean;
-    optional?: boolean;
-    lazy?: boolean;
-    description: string;
-    name: string;
-    type: ArgType[];
-    default?: boolean;
-    defaultValue?: any;
-}
-type ComputeFunctionArg<T> = T | (() => T);
-type ComputeFunction<T, R> = (this: EvalContext, ...args: ComputeFunctionArg<T>[]) => R;
-interface AddFunctionDescriptionBase {
-    description: string;
-    category?: string;
-    args: ArgDefinition[];
-    returns: [ArgType];
-    isExported?: boolean;
-    hidden?: boolean;
-}
-interface ComputeValue {
-    compute: ComputeFunction<ArgValue, CellValue | Matrix<CellValue>>;
-}
-interface ComputeFormat {
-    computeFormat: ComputeFunction<Arg, Format | undefined | Matrix<Format | undefined>>;
-}
-interface ComputeValueAndFormat {
-    computeValueAndFormat: ComputeFunction<Arg, Matrix<ValueAndFormat> | ValueAndFormat>;
-}
-type AddFunctionDescription = (AddFunctionDescriptionBase & ComputeValue & Partial<ComputeFormat>) | (AddFunctionDescriptionBase & ComputeValueAndFormat);
-type FunctionDescription = AddFunctionDescription & {
-    minArgRequired: number;
-    maxArgPossible: number;
-    nbrArgRepeating: number;
-    getArgToFocus: (argPosition: number) => number;
-};
-type EvalContext = {
-    __lastFnCalled?: string;
-    __originCellXC?: () => string;
-    locale: Locale;
-    [key: string]: any;
-};
-
 declare class RangeAdapter implements CommandHandler<CoreCommand> {
     private getters;
     private providers;
@@ -3227,7 +3122,8 @@ interface BordersPluginState {
 declare class BordersPlugin extends CorePlugin<BordersPluginState> implements BordersPluginState {
     static getters: readonly ["getCellBorder", "getBordersColors"];
     readonly borders: BordersPluginState["borders"];
-    handle(cmd: Command): void;
+    allowDispatch(cmd: CoreCommand): CommandResult.Success | CommandResult.NoChanges;
+    handle(cmd: CoreCommand): void;
     /**
      * Move borders according to the inserted columns.
      * Ensure borders continuity.
@@ -3325,6 +3221,7 @@ declare class BordersPlugin extends CorePlugin<BordersPluginState> implements Bo
      * Compute the borders to add to the given zone merged.
      */
     private addBordersToMerge;
+    private checkBordersUnchanged;
     import(data: WorkbookData): void;
     export(data: WorkbookData): void;
     exportForExcel(data: ExcelWorkbookData): void;
@@ -3341,7 +3238,7 @@ interface CoreState {
  * cell and sheet content.
  */
 declare class CellPlugin extends CorePlugin<CoreState> implements CoreState {
-    static getters: readonly ["zoneToXC", "getCells", "getFormulaCellContent", "getTranslatedCellFormula", "getCellStyle", "getCellById"];
+    static getters: readonly ["zoneToXC", "getCells", "getTranslatedCellFormula", "getCellStyle", "getCellById"];
     readonly nextId = 1;
     readonly cells: {
         [sheetId: string]: {
@@ -3349,7 +3246,7 @@ declare class CellPlugin extends CorePlugin<CoreState> implements CoreState {
         };
     };
     adaptRanges(applyChange: ApplyRangeChange, sheetId?: UID): void;
-    allowDispatch(cmd: CoreCommand): CommandResult;
+    allowDispatch(cmd: CoreCommand): CommandResult | CommandResult[];
     handle(cmd: CoreCommand): void;
     /**
      * Set a format to all the cells in a zone
@@ -3378,8 +3275,8 @@ declare class CellPlugin extends CorePlugin<CoreState> implements CoreState {
      * starting an async evaluation even if it has been moved or re-allocated
      */
     getCellById(cellId: UID): Cell | undefined;
-    getFormulaCellContent(sheetId: UID, cell: Pick<FormulaCell, "dependencies" | "compiledFormula">, dependencies?: Range[]): string;
-    getTranslatedCellFormula(sheetId: UID, offsetX: number, offsetY: number, compiledFormula: CompiledFormula, dependencies: Range[]): string;
+    private getFormulaCellContent;
+    getTranslatedCellFormula(sheetId: UID, offsetX: number, offsetY: number, compiledFormula: RangeCompiledFormula): string;
     getCellStyle(position: CellPosition): Style;
     /**
      * Converts a zone to a XC coordinate system
@@ -3423,6 +3320,7 @@ declare class CellPlugin extends CorePlugin<CoreState> implements CoreState {
     private createFormulaCellWithDependencies;
     private createErrorFormula;
     private checkCellOutOfSheet;
+    private checkUselessClearCell;
 }
 
 /**
@@ -4053,15 +3951,6 @@ declare class SheetPlugin extends CorePlugin<SheetState> implements SheetState {
      */
     private moveCellOnRowsDeletion;
     private updateRowsStructureOnDeletion;
-    /**
-     * Update the rows of the sheet after an addition:
-     * - Rename the rows
-     *
-     * @param sheet Sheet on which the deletion occurs
-     * @param addedRow Index of the added row
-     * @param rowsToAdd Number of the rows to add
-     */
-    private updateRowsStructureOnAddition;
     /**
      * Add empty rows at the end of the rows
      *
@@ -4083,11 +3972,9 @@ declare class SheetPlugin extends CorePlugin<SheetState> implements SheetState {
 }
 
 declare class EvaluationPlugin extends UIPlugin {
-    private config;
-    static getters: readonly ["evaluateFormula", "getCorrespondingFormulaCell", "getRangeFormattedValues", "getRangeValues", "getRangeFormats", "getEvaluatedCell", "getEvaluatedCells", "getEvaluatedCellsInZone"];
+    static getters: readonly ["evaluateFormula", "getCorrespondingFormulaCell", "getRangeFormattedValues", "getRangeValues", "getRangeFormats", "getEvaluatedCell", "getEvaluatedCells", "getEvaluatedCellsInZone", "getSpreadPositionsOf", "getArrayFormulaSpreadingOn"];
     private shouldRebuildDependenciesGraph;
     private evaluator;
-    private compilationParams;
     private positionsToUpdate;
     constructor(config: UIPluginConfig);
     beforeHandle(cmd: Command): void;
@@ -4109,6 +3996,8 @@ declare class EvaluationPlugin extends UIPlugin {
     getEvaluatedCell(position: CellPosition): EvaluatedCell;
     getEvaluatedCells(sheetId: UID): Record<UID, EvaluatedCell>;
     getEvaluatedCellsInZone(sheetId: UID, zone: Zone): EvaluatedCell[];
+    getSpreadPositionsOf(position: CellPosition): CellPosition[];
+    getArrayFormulaSpreadingOn(position: CellPosition): CellPosition | undefined;
     exportForExcel(data: ExcelWorkbookData): void;
     /**
      * Returns the corresponding formula cell of a given cell
@@ -4116,7 +4005,6 @@ declare class EvaluationPlugin extends UIPlugin {
      * formula of the array formula that spreads to the cell
      */
     getCorrespondingFormulaCell(position: CellPosition): FormulaCell | undefined;
-    private getCompilationParameters;
 }
 
 interface CustomColorState {
@@ -4142,11 +4030,11 @@ declare class CustomColorsPlugin extends UIPlugin<CustomColorState> {
 }
 
 interface EvaluationChartState {
-    readonly charts: Immutable<Record<UID, ChartRuntime | undefined>>;
+    charts: Record<UID, ChartRuntime | undefined>;
 }
 declare class EvaluationChartPlugin extends UIPlugin<EvaluationChartState> {
     static getters: readonly ["getChartRuntime", "getBackgroundOfSingleCellChart"];
-    readonly charts: Immutable<Record<UID, ChartRuntime | undefined>>;
+    charts: Record<UID, ChartRuntime | undefined>;
     private createRuntimeChart;
     handle(cmd: CoreViewCommand): void;
     getChartRuntime(figureId: UID): ChartRuntime;
@@ -4453,6 +4341,78 @@ declare class CollaborativePlugin extends UIPlugin {
     drawGrid(renderingContext: GridRenderingContext): void;
 }
 
+/**
+ * Find and Replace Plugin
+ *
+ * This plugin is used in combination with the find_and_replace sidePanel
+ * It is used to 'highlight' cells that match an input string according to
+ * the given searchOptions. The second part of this plugin makes it possible
+ * (again with the find_and_replace sidePanel), to replace the values that match
+ * the search with a new value.
+ */
+declare class FindAndReplacePlugin extends UIPlugin {
+    static layers: LAYERS[];
+    static getters: readonly ["getSearchMatches", "getCurrentSelectedMatchIndex", "getSearchOptions", "getAllSheetMatchesCount", "getActiveSheetMatchesCount", "getSpecificRangeMatchesCount"];
+    private allSheetsMatches;
+    private activeSheetMatches;
+    private specificRangeMatches;
+    private selectedMatchIndex;
+    private currentSearchRegex;
+    private searchOptions;
+    private toSearch;
+    private isSearchDirty;
+    get searchMatches(): CellPosition[];
+    handle(cmd: Command): void;
+    finalize(): void;
+    getSearchMatches(): CellPosition[];
+    getCurrentSelectedMatchIndex(): number | null;
+    getSearchOptions(): SearchOptions;
+    getAllSheetMatchesCount(): number;
+    getActiveSheetMatchesCount(): number;
+    getSpecificRangeMatchesCount(): number;
+    /**
+     * Will update the current searchOptions and accordingly update the regex.
+     * It will then search for matches using the regex and store them.
+     */
+    private updateSearch;
+    /**
+     * refresh the matches according to the current search options
+     */
+    private refreshSearch;
+    /**
+     * Updates the regex based on the current searchOptions and
+     * the value toSearch
+     */
+    private updateRegex;
+    private getSheetsInSearchOrder;
+    /**
+     * Find matches using the current regex
+     */
+    private findMatches;
+    private findMatchesInSheet;
+    /**
+     * Changes the selected search cell. Given a direction it will
+     * Change the selection to the previous, current or nextCell,
+     * if it exists otherwise it will set the selectedMatchIndex to null.
+     * It will also reset the index to 0 if the search has changed.
+     * It is also used to keep coherence between the selected searchMatch
+     * and selectedMatchIndex.
+     */
+    private selectNextCell;
+    private clearSearch;
+    private replaceMatch;
+    /**
+     * Replace the value of the currently selected match
+     */
+    private replace;
+    /**
+     * Apply the replace function to all the matches one time.
+     */
+    private replaceAll;
+    private getSearchableString;
+    drawGrid(renderingContext: GridRenderingContext): void;
+}
+
 declare class HeaderVisibilityUIPlugin extends UIPlugin {
     static getters: readonly ["getNextVisibleCellPosition", "findVisibleHeader", "findLastVisibleColRowIndex", "findFirstVisibleColRowIndex", "isRowHidden", "isColHidden", "isHeaderHidden"];
     isRowHidden(sheetId: UID, index: number): boolean;
@@ -4659,56 +4619,10 @@ declare class SelectionInputsManagerPlugin extends UIPlugin {
 }
 
 declare class SortPlugin extends UIPlugin {
-    static getters: readonly ["getContiguousZone"];
     allowDispatch(cmd: LocalCommand): CommandResult | CommandResult[];
     handle(cmd: Command): void;
     private checkMerge;
     private checkMergeSizes;
-    /**
-     * safe-version of expandZone to make sure we don't get out of the grid
-     */
-    private expand;
-    /**
-     * verifies the presence of at least one non-empty cell in the given zone
-     */
-    private checkExpandedValues;
-    /**
-     * This function will expand the provided zone in directions (top, bottom, left, right) for which there
-     * are non-null cells on the external boundary of the zone in the given direction.
-     *
-     * Example:
-     *          A     B     C     D     E
-     *         ___   ___   ___   ___   ___
-     *    1  |     |  D  |     |     |     |
-     *         ___   ___   ___   ___   ___
-     *    2  |  5  |     |  1  |  D  |     |
-     *         ___   ___   ___   ___   ___
-     *    3  |     |     |  A  |  X  |     |
-     *         ___   ___   ___   ___   ___
-     *    4  |     |     |     |     |     |
-     *         ___   ___   ___   ___   ___
-     *
-     *  Let's consider a provided zone corresponding to (C2:D3) - (left:2, right: 3, top:1, bottom:2)
-     *  - the top external boundary is (B1:E1)
-     *    Since we have B1='D' != "", we expand to the top: => (C1:D3)
-     *    The top boundary having reached the top of the grid, we cannot expand in that direction anymore
-     *
-     *  - the left boundary is (B1:B4)
-     *    since we have B1 again, we expand to the left  => (B1:D3)
-     *
-     *  - the right and bottom boundaries are a dead end for now as (E1:E4) and (A4:E4) are empty.
-     *
-     *  - the left boundary is now (A1:A4)
-     *    Since we have A2=5 != "", we can therefore expand to the left => (A1:D3)
-     *
-     *  This will be the final zone as left and top have reached the boundaries of the grid and
-     *  the other boundaries (E1:E4) and (A4:E4) are empty.
-     *
-     * @param sheetId UID of concerned sheet
-     * @param zone Zone
-     *
-     */
-    getContiguousZone(sheetId: UID, zone: Zone): Zone;
     /**
      * This function evaluates if the top row of a provided zone can be considered as a `header`
      * by checking the following criteria:
@@ -4760,7 +4674,7 @@ declare class UIOptionsPlugin extends UIPlugin {
 }
 
 declare class SheetUIPlugin extends UIPlugin {
-    static getters: readonly ["doesCellHaveGridIcon", "getCellWidth", "getTextWidth", "getCellText", "getCellMultiLineText"];
+    static getters: readonly ["doesCellHaveGridIcon", "getCellWidth", "getTextWidth", "getCellText", "getCellMultiLineText", "getContiguousZone", "isCellEmpty"];
     private ctx;
     allowDispatch(cmd: LocalCommand): CommandResult | CommandResult[];
     handle(cmd: Command): void;
@@ -4773,6 +4687,15 @@ declare class SheetUIPlugin extends UIPlugin {
      */
     getCellMultiLineText(position: CellPosition, width: number | undefined): string[];
     doesCellHaveGridIcon(position: CellPosition): boolean;
+    /**
+     * Expands the given zone until bordered by empty cells or reached the sheet boundaries.
+     */
+    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.
+     */
+    isCellEmpty(position: CellPosition): boolean;
     private getColMaxWidth;
     /**
      * Check that any "sheetId" in the command matches an existing
@@ -5248,6 +5171,52 @@ type Getters = {
     isDashboard: () => boolean;
 } & CoreGetters & PluginGetters<typeof AutofillPlugin> & PluginGetters<typeof AutomaticSumPlugin> & PluginGetters<typeof HistoryPlugin> & PluginGetters<typeof ClipboardPlugin> & PluginGetters<typeof EditionPlugin> & PluginGetters<typeof EvaluationPlugin> & PluginGetters<typeof EvaluationChartPlugin> & PluginGetters<typeof EvaluationConditionalFormatPlugin> & PluginGetters<typeof FindAndReplacePlugin> & PluginGetters<typeof HeaderVisibilityUIPlugin> & PluginGetters<typeof HighlightPlugin> & PluginGetters<typeof CustomColorsPlugin> & PluginGetters<typeof AutomaticSumPlugin> & PluginGetters<typeof RendererPlugin> & PluginGetters<typeof GridSelectionPlugin> & PluginGetters<typeof SelectionInputsManagerPlugin> & PluginGetters<typeof CollaborativePlugin> & PluginGetters<typeof SortPlugin> & PluginGetters<typeof UIOptionsPlugin> & PluginGetters<typeof SheetUIPlugin> & PluginGetters<typeof SheetViewPlugin> & PluginGetters<typeof CellPopoverPlugin> & PluginGetters<typeof FilterEvaluationPlugin> & PluginGetters<typeof SplitToColumnsPlugin> & PluginGetters<typeof HeaderSizeUIPlugin> & PluginGetters<typeof EvaluationDataValidationPlugin> & PluginGetters<typeof HeaderPositionsUIPlugin>;
 
+type ArgType = "ANY" | "BOOLEAN" | "NUMBER" | "STRING" | "DATE" | "RANGE" | "RANGE<BOOLEAN>" | "RANGE<NUMBER>" | "RANGE<DATE>" | "RANGE<STRING>" | "RANGE<ANY>" | "META";
+interface ArgDefinition {
+    repeating?: boolean;
+    optional?: boolean;
+    lazy?: boolean;
+    description: string;
+    name: string;
+    type: ArgType[];
+    default?: boolean;
+    defaultValue?: any;
+}
+type ComputeFunctionArg<T> = T | (() => T);
+type ComputeFunction<T, R> = (this: EvalContext, ...args: ComputeFunctionArg<T>[]) => R;
+interface AddFunctionDescriptionBase {
+    description: string;
+    category?: string;
+    args: ArgDefinition[];
+    returns: [ArgType];
+    isExported?: boolean;
+    hidden?: boolean;
+}
+interface ComputeValue {
+    compute: ComputeFunction<ArgValue, CellValue | Matrix<CellValue>>;
+}
+interface ComputeFormat {
+    computeFormat: ComputeFunction<Arg, Format | undefined | Matrix<Format | undefined>>;
+}
+interface ComputeValueAndFormat {
+    computeValueAndFormat: ComputeFunction<Arg, Matrix<ValueAndFormat> | ValueAndFormat>;
+}
+type AddFunctionDescription = (AddFunctionDescriptionBase & ComputeValue & Partial<ComputeFormat>) | (AddFunctionDescriptionBase & ComputeValueAndFormat);
+type FunctionDescription = AddFunctionDescription & {
+    minArgRequired: number;
+    maxArgPossible: number;
+    nbrArgRepeating: number;
+    getArgToFocus: (argPosition: number) => number;
+};
+type EvalContext = {
+    __lastFnCalled?: string;
+    __originSheetId: UID;
+    __originCellXC: () => string | undefined;
+    locale: Locale;
+    getters: Getters;
+    [key: string]: any;
+};
+
 interface HistoryChange {
     path: [any, ...(number | string)[]];
     before: any;
@@ -5806,6 +5775,10 @@ interface ActionSpec {
      * Can be defined to display an icon
      */
     icon?: string | ((env: SpreadsheetChildEnv) => string);
+    /**
+     * Can be defined to display another icon on the right of the item.
+     */
+    secondaryIcon?: string | ((env: SpreadsheetChildEnv) => string);
     /**
      * is the action allowed when running spreadsheet in readonly mode
      */
@@ -5836,6 +5809,7 @@ interface Action {
     isEnabled: (env: SpreadsheetChildEnv) => boolean;
     isActive?: (env: SpreadsheetChildEnv) => boolean;
     icon: (env: SpreadsheetChildEnv) => string;
+    secondaryIcon: (env: SpreadsheetChildEnv) => string;
     isReadonlyAllowed: boolean;
     execute?: (env: SpreadsheetChildEnv) => unknown;
     children: (env: SpreadsheetChildEnv) => Action[];
@@ -7374,6 +7348,9 @@ declare class Spreadsheet extends Component<SpreadsheetProps, SpreadsheetChildEn
     };
     sidePanel: SidePanelState;
     composer: ComposerState;
+    spreadsheetRef: {
+        el: HTMLElement | null;
+    };
     private _focusGrid?;
     private keyDownMapping;
     private isViewportTooSmall;
@@ -7506,7 +7483,7 @@ declare class ColResizer extends AbstractResizer {
     _getActiveElements(): Set<HeaderIndex>;
     _getPreviousVisibleElement(index: HeaderIndex): HeaderIndex;
     unhide(hiddenElements: HeaderIndex[]): void;
-    unhideStyleValue(hiddenIndex: HeaderIndex): Pixel;
+    getUnhideButtonStyle(hiddenIndex: HeaderIndex): string;
 }
 declare class RowResizer extends AbstractResizer {
     static template: string;
@@ -7531,7 +7508,7 @@ declare class RowResizer extends AbstractResizer {
     _getActiveElements(): Set<HeaderIndex>;
     _getPreviousVisibleElement(index: HeaderIndex): HeaderIndex;
     unhide(hiddenElements: HeaderIndex[]): void;
-    unhideStyleValue(hiddenIndex: HeaderIndex): Pixel;
+    getUnhideButtonStyle(hiddenIndex: HeaderIndex): string;
 }
 declare class HeadersOverlay extends Component<any, SpreadsheetChildEnv> {
     static template: string;
@@ -7898,6 +7875,7 @@ declare const components: {
     FigureComponent: typeof FigureComponent;
     Menu: typeof Menu;
     SelectionInput: typeof SelectionInput;
+    ValidationMessages: typeof ValidationMessages;
 };
 declare const hooks: {
     useDragAndDropListItems: typeof useDragAndDropListItems;
@@ -7909,4 +7887,4 @@ declare const constants: {
     DEFAULT_LOCALE: Locale;
 };
 
-export { AbstractChart, CancelledReason, Client, ClientJoinedMessage, ClientLeftMessage, ClientMovedMessage, CollaborationMessage, CommandResult, CorePlugin, DispatchResult, EvaluationError, Model, Registry, RemoteRevisionMessage, Revision, RevisionRedoneMessage, RevisionUndoneMessage, SPREADSHEET_DIMENSIONS, Spreadsheet, TransportService, UIPlugin, __info__, addFunction, astToFormula, compile, components, constants, convertAstNodes, coreTypes, findCellInNewZone, functionCache, helpers, hooks, invalidateCFEvaluationCommands, invalidateDependenciesCommands, invalidateEvaluationCommands, iterateAstNodes, links, load, parse, readonlyAllowedCommands, registries, setDefaultSheetViewSize, setTranslationMethod, tokenize };
+export { AbstractChart, CancelledReason, Client, ClientJoinedMessage, ClientLeftMessage, ClientMovedMessage, CollaborationMessage, CommandResult, CorePlugin, DispatchResult, EvaluationError, Model, Registry, RemoteRevisionMessage, Revision, RevisionRedoneMessage, RevisionUndoneMessage, SPREADSHEET_DIMENSIONS, Spreadsheet, TransportService, UIPlugin, __info__, addFunction, astToFormula, compile, compileTokens, components, constants, convertAstNodes, coreTypes, findCellInNewZone, functionCache, helpers, hooks, invalidateCFEvaluationCommands, invalidateDependenciesCommands, invalidateEvaluationCommands, iterateAstNodes, links, load, parse, parseTokens, readonlyAllowedCommands, registries, setDefaultSheetViewSize, setTranslationMethod, tokenize };