@odoo/o-spreadsheet 17.1.3 → 17.1.5

package/dist/o-spreadsheet.d.ts

@@ -33,8 +33,8 @@ interface EnrichedToken extends Token {
 
 type TokenType = "OPERATOR" | "NUMBER" | "STRING" | "SYMBOL" | "SPACE" | "DEBUGGER" | "ARG_SEPARATOR" | "LEFT_PAREN" | "RIGHT_PAREN" | "REFERENCE" | "INVALID_REFERENCE" | "UNKNOWN";
 interface Token {
-    type: TokenType;
-    value: string;
+    readonly type: TokenType;
+    readonly value: string;
 }
 declare function tokenize(str: string, locale?: Locale): Token[];
 
@@ -3007,6 +3007,12 @@ interface ClipboardInterface {
     readText(): Promise<ClipboardReadResult>;
 }
 
+declare class FocusableElement {
+    private focusableElement;
+    setFocusableElement(element: HTMLElement): void;
+    focus(): void;
+}
+
 type NotificationType = "danger" | "info" | "success" | "warning";
 interface InformationNotification {
     text: string;
@@ -3028,6 +3034,7 @@ interface SpreadsheetChildEnv extends SpreadsheetEnv {
     startCellEdition: (content?: string) => void;
     loadCurrencies?: () => Promise<Currency[]>;
     loadLocales: () => Promise<Locale[]>;
+    focusableElement: FocusableElement;
 }
 
 declare class RangeAdapter implements CommandHandler<CoreCommand> {
@@ -3342,6 +3349,7 @@ declare class CellPlugin extends CorePlugin<CoreState> implements CoreState {
     private createErrorFormula;
     private checkCellOutOfSheet;
     private checkUselessClearCell;
+    private checkUselessUpdateCell;
 }
 
 /**
@@ -4692,7 +4700,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;
@@ -4710,10 +4718,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
@@ -7714,6 +7727,8 @@ declare class TextValueProvider extends Component<Props$b> {
         onValueSelected: FunctionConstructor;
         onValueHovered: FunctionConstructor;
     };
+    private autoCompleteListRef;
+    setup(): void;
 }
 
 declare class ContentEditableHelper {
@@ -7809,11 +7824,12 @@ interface AutocompleteValue {
 }
 interface ComposerProps {
     focus: ComposerFocusType;
-    onComposerContentFocused: (selection: ComposerSelection) => void;
     inputStyle?: string;
     rect?: Rect;
     delimitation?: DOMDimension;
-    onComposerUnmounted?: () => void;
+    onComposerContentFocused: () => void;
+    onComposerCellFocused?: (content: String) => void;
+    isDefaultFocus?: boolean;
 }
 interface ComposerState$1 {
     positionStart: number;
@@ -7838,7 +7854,6 @@ declare class Composer extends Component<ComposerProps, SpreadsheetChildEnv> {
         focus: {
             validate: (value: string) => boolean;
         };
-        onComposerContentFocused: FunctionConstructor;
         inputStyle: {
             type: StringConstructor;
             optional: boolean;
@@ -7851,10 +7866,15 @@ declare class Composer extends Component<ComposerProps, SpreadsheetChildEnv> {
             type: ObjectConstructor;
             optional: boolean;
         };
-        onComposerUnmounted: {
+        onComposerCellFocused: {
             type: FunctionConstructor;
             optional: boolean;
         };
+        onComposerContentFocused: FunctionConstructor;
+        isDefaultFocus: {
+            type: BooleanConstructor;
+            optional: boolean;
+        };
     };
     static components: {
         TextValueProvider: typeof TextValueProvider;
@@ -7862,6 +7882,7 @@ declare class Composer extends Component<ComposerProps, SpreadsheetChildEnv> {
     };
     static defaultProps: {
         inputStyle: string;
+        isDefaultFocus: boolean;
     };
     composerRef: {
         el: HTMLElement | null;
@@ -7884,7 +7905,6 @@ declare class Composer extends Component<ComposerProps, SpreadsheetChildEnv> {
     private processArrowKeys;
     private handleArrowKeysForAutocomplete;
     private processTabKey;
-    processSpaceKey(ev: KeyboardEvent): void;
     private processEnterKey;
     private processNewLineEvent;
     private processEscapeKey;
@@ -7893,6 +7913,7 @@ declare class Composer extends Component<ComposerProps, SpreadsheetChildEnv> {
     onCompositionStart(): void;
     onCompositionEnd(): void;
     onKeydown(ev: KeyboardEvent): void;
+    onPaste(ev: ClipboardEvent): void;
     onInput(ev: InputEvent): void;
     onKeyup(ev: KeyboardEvent): void;
     showFunctionAutocomplete(searchTerm: string): void;
@@ -8101,7 +8122,7 @@ declare class Spreadsheet extends Component<SpreadsheetProps, SpreadsheetChildEn
     focusGrid(): void;
     onKeydown(ev: KeyboardEvent): void;
     onTopBarComposerFocused(selection: ComposerSelection): void;
-    onGridComposerContentFocused(): void;
+    onGridComposerContentFocused(selection: ComposerSelection): void;
     onGridComposerCellFocused(content?: string, selection?: ComposerSelection): void;
     /**
      * Start the edition or update the content if it's already started.
@@ -8115,8 +8136,8 @@ declare class Spreadsheet extends Component<SpreadsheetProps, SpreadsheetChildEn
 
 interface Props$5 {
     focus: ComposerFocusType;
-    onComposerUnmounted: () => void;
-    onComposerContentFocused: (selection: ComposerSelection) => void;
+    onComposerContentFocused: () => void;
+    onComposerCellFocused: () => void;
     gridDims: DOMDimension;
 }
 /**
@@ -8129,24 +8150,30 @@ declare class GridComposer extends Component<Props$5, SpreadsheetChildEnv> {
         focus: {
             validate: (value: string) => boolean;
         };
-        onComposerUnmounted: FunctionConstructor;
+        onComposerCellFocused: FunctionConstructor;
         onComposerContentFocused: FunctionConstructor;
         gridDims: ObjectConstructor;
     };
     static components: {
         Composer: typeof Composer;
     };
-    private gridComposerRef;
-    private zone;
     private rect;
+    private isEditing;
     private isCellReferenceVisible;
-    private composerState;
+    get defaultRect(): {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
     setup(): void;
     get shouldDisplayCellReference(): boolean;
     get cellReference(): string;
     get cellReferenceStyle(): string;
+    get composerProps(): ComposerProps;
     get containerStyle(): string;
-    get composerStyle(): string;
+    private updateComponentPosition;
+    private updateCellReferenceVisibility;
 }
 
 interface ResizerState {
@@ -8382,7 +8409,6 @@ declare class Grid extends Component<Props$1, SpreadsheetChildEnv> {
     readonly HEADER_WIDTH = 48;
     private menuState;
     private gridRef;
-    private hiddenInput;
     onMouseWheel: (ev: WheelEvent) => void;
     canvasPosition: DOMCoordinates;
     hoveredCell: Partial<Position$1>;
@@ -8394,7 +8420,7 @@ declare class Grid extends Component<Props$1, SpreadsheetChildEnv> {
     get gridOverlayDimensions(): string;
     onClosePopover(): void;
     private keyDownMapping;
-    focus(): void;
+    focusDefaultElement(): void;
     get gridEl(): HTMLElement;
     getAutofillPosition(): {
         left: number;
@@ -8414,7 +8440,6 @@ declare class Grid extends Component<Props$1, SpreadsheetChildEnv> {
     closeOpenedPopover(): void;
     processArrows(ev: KeyboardEvent): void;
     onKeydown(ev: KeyboardEvent): void;
-    onInput(ev: InputEvent): void;
     onInputContextMenu(ev: MouseEvent): void;
     onCellRightClicked(col: HeaderIndex, row: HeaderIndex, { x, y }: DOMCoordinates): void;
     toggleContextMenu(type: ContextMenuType, x: Pixel, y: Pixel): void;