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

package/dist/o-spreadsheet.d.ts

@@ -1,5 +1,5 @@
 import * as _odoo_owl from '@odoo/owl';
-import { ComponentConstructor, EventBus as EventBus$1, Component } from '@odoo/owl';
+import { ComponentConstructor, Component } from '@odoo/owl';
 import { ChartConfiguration, ChartData, ChartDataSets, ChartOptions } from 'chart.js';
 
 declare enum CellErrorLevel {
@@ -160,195 +160,129 @@ interface Subscription {
     callback: Callback;
 }
 
-/**
- * RGBA to HEX representation (#RRGGBBAA).
- *
- * https://css-tricks.com/converting-color-spaces-in-javascript/
- */
-declare function rgbaToHex(rgba: RGBA): Color;
-/**
- * Color string to RGBA representation
- */
-declare function colorToRGBA(color: Color): RGBA;
-
-/**
- * Convert a (col) number to the corresponding letter.
- *
- * Examples:
- *     0 => 'A'
- *     25 => 'Z'
- *     26 => 'AA'
- *     27 => 'AB'
- */
-declare function numberToLetters(n: number): string;
-/**
- * Convert a "XC" coordinate to cartesian coordinates.
- *
- * Examples:
- *   A1 => [0,0]
- *   B3 => [1,2]
- *
- * Note: it also accepts lowercase coordinates, but not fixed references
- */
-declare function toCartesian(xc: string): Position$1;
-/**
- * Convert from cartesian coordinate to the "XC" coordinate system.
- *
- * Examples:
- *   - 0,0 => A1
- *   - 1,2 => B3
- *   - 0,0, {colFixed: false, rowFixed: true} => A$1
- *   - 1,2, {colFixed: true, rowFixed: false} => $B3
- */
-declare function toXC(col: HeaderIndex, row: HeaderIndex, rangePart?: RangePart): string;
-
-/**
- * Formats a cell value with its format.
- */
-declare function formatValue(value: CellValue, format?: Format): FormattedValue;
-
-declare function computeTextWidth(context: CanvasRenderingContext2D, text: string, style: Style): number;
-declare function isMarkdownLink(str: string): boolean;
-/**
- * Build a markdown link from a label and an url
- */
-declare function markdownLink(label: string, url: string): string;
-declare function parseMarkdownLink(str: string): {
-    url: string;
-    label: string;
-};
-/**
- * This helper function can be used as a type guard when filtering arrays.
- * const foo: number[] = [1, 2, undefined, 4].filter(isDefined)
- */
-declare function isDefined<T>(argument: T | undefined): argument is T;
-/**
- * Lazy value computed by the provided function.
- */
-declare function lazy<T>(fn: (() => T) | T): Lazy<T>;
-
-interface ConstructorArgs {
-    readonly zone: Readonly<Zone | UnboundedZone>;
-    readonly parts: readonly RangePart[];
-    readonly invalidXc?: string;
-    /** true if the user provided the range with the sheet name */
-    readonly prefixSheet: boolean;
-    /** the name of any sheet that is invalid */
-    readonly invalidSheetName?: string;
-    /** the sheet on which the range is defined */
-    readonly sheetId: UID;
-}
-declare class RangeImpl implements Range {
-    private getSheetSize;
-    private readonly _zone;
-    readonly parts: Range["parts"];
-    readonly invalidXc?: string;
-    readonly prefixSheet: boolean;
-    readonly sheetId: UID;
-    readonly invalidSheetName?: string;
-    constructor(args: ConstructorArgs, getSheetSize: (sheetId: UID) => ZoneDimension);
-    static fromRange(range: Range, getters: CoreGetters): RangeImpl;
-    get unboundedZone(): UnboundedZone;
-    get zone(): Zone;
-    static getRangeParts(xc: string, zone: UnboundedZone): RangePart[];
-    get isFullCol(): boolean;
-    get isFullRow(): boolean;
-    get rangeData(): RangeData;
+declare class SelectiveHistory<T = unknown> {
+    private applyOperation;
+    private revertOperation;
+    private buildEmpty;
+    private readonly buildTransformation;
+    private HEAD_BRANCH;
+    private HEAD_OPERATION;
+    private tree;
     /**
-     * Check that a zone is valid regarding the order of top-bottom and left-right.
-     * Left should be smaller than right, top should be smaller than bottom.
-     * If it's not the case, simply invert them, and invert the linked parts
+     * The selective history is a data structure used to register changes/updates of a state.
+     * Each change/update is called an "operation".
+     * The data structure allows to easily cancel (and redo) any operation individually.
+     * An operation can be represented by any data structure. It can be a "command", a "diff", etc.
+     * However it must have the following properties:
+     * - it can be applied to modify the state
+     * - it can be reverted on the state such that it was never executed.
+     * - it can be transformed given other operation (Operational Transformation)
+     *
+     * Since this data structure doesn't know anything about the state nor the structure of
+     * operations, the actual work must be performed by external functions given as parameters.
+     * @param initialOperationId
+     * @param applyOperation a function which can apply an operation to the state
+     * @param revertOperation  a function which can revert an operation from the state
+     * @param buildEmpty  a function returning an "empty" operation.
+     *                    i.e an operation that leaves the state unmodified once applied or reverted
+     *                    (used for internal implementation)
+     * @param buildTransformation Factory used to build transformations
      */
-    orderZone(): RangeImpl;
+    constructor(initialOperationId: UID, applyOperation: (data: T) => void, revertOperation: (data: T) => void, buildEmpty: (id: UID) => T, buildTransformation: TransformationFactory<T>);
     /**
-     *
-     * @param rangeParams optional, values to put in the cloned range instead of the current values of the range
+     * Return the operation identified by its id.
      */
-    clone(rangeParams?: Partial<ConstructorArgs>): RangeImpl;
+    get(operationId: UID): T;
+    /**
+     * Append a new operation as the last one
+     */
+    append(operationId: UID, data: T): void;
+    /**
+     * Insert a new operation after a specific operation (may not be the last operation).
+     * Following operations will be transformed according
+     * to the new operation.
+     */
+    insert(operationId: UID, data: T, insertAfter: UID): void;
+    /**
+     * @param operationId operation to undo
+     * @param undoId the id of the "undo operation"
+     * @param insertAfter the id of the operation after which to insert the undo
+     */
+    undo(operationId: UID, undoId: UID, insertAfter: UID): void;
+    /**
+     * @param operationId operation to redo
+     * @param redoId the if of the "redo operation"
+     * @param insertAfter the id of the operation after which to insert the redo
+     */
+    redo(operationId: UID, redoId: UID, insertAfter: UID): void;
+    drop(operationId: UID): void;
+    getRevertedExecution(): T[];
+    /**
+     * Revert the state as it was *before* the given operation was executed.
+     */
+    private revertBefore;
+    /**
+     * Revert the state as it was *after* the given operation was executed.
+     */
+    private revertTo;
+    /**
+     * Revert an execution
+     */
+    private revert;
+    /**
+     * Replay the operations between the current HEAD_BRANCH and the end of the tree
+     */
+    private fastForward;
 }
 
-declare class UuidGenerator {
-    private isFastIdStrategy;
-    private fastIdStart;
-    setIsFastStrategy(isFast: boolean): void;
-    uuidv4(): string;
+declare type ClientId = string;
+interface Client {
+    id: ClientId;
+    name: string;
+    position?: ClientPosition;
 }
-
-/**
- * Convert from a cartesian reference to a Zone.
- * Will return throw an error if given a unbounded zone (eg : A:A).
- *
- * Examples:
- *    "A1" ==> Top 0, Bottom 0, Left: 0, Right: 0
- *    "B1:B3" ==> Top 0, Bottom 3, Left: 1, Right: 1
- *    "Sheet1!A1" ==> Top 0, Bottom 0, Left: 0, Right: 0
- *    "Sheet1!B1:B3" ==> Top 0, Bottom 3, Left: 1, Right: 1
- *
- * @param xc the string reference to convert
- *
- */
-declare function toZone(xc: string): Zone;
-/**
- * This function will compare the modifications of selection to determine
- * a cell that is part of the new zone and not the previous one.
- */
-declare function findCellInNewZone(oldZone: Zone, currentZone: Zone): Position$1;
-declare function positionToZone(position: Position$1): {
-    left: HeaderIndex;
-    right: HeaderIndex;
-    top: HeaderIndex;
-    bottom: HeaderIndex;
-};
-
-interface SelectionEventPayload {
-    anchor: AnchorZone;
-    previousAnchor: AnchorZone;
-    mode: "newAnchor" | "overrideSelection" | "updateAnchor";
+interface ClientPosition {
+    sheetId: UID;
+    col: HeaderIndex;
+    row: HeaderIndex;
 }
-interface ZonesSelected extends SelectionEventPayload {
-    type: "ZonesSelected";
+interface RemoteRevisionReceivedEvent {
+    type: "remote-revision-received";
+    commands: readonly CoreCommand[];
 }
-interface HeadersSelected extends SelectionEventPayload {
-    type: "HeadersSelected";
+interface RevisionAcknowledgedEvent {
+    type: "revision-acknowledged";
+    revisionId: UID;
 }
-interface AlterZone extends SelectionEventPayload {
-    type: "AlterZone";
+interface RevisionUndone {
+    type: "revision-undone";
+    revisionId: UID;
+    commands: readonly CoreCommand[];
 }
-declare type SelectionEvent = Readonly<ZonesSelected | HeadersSelected | AlterZone>;
-
-interface StreamCallbacks<Event> {
-    handleEvent: (event: Event) => void;
-    /** this callback will only be called when another consumer captures the stream,
-     * not when the current consumer decides to release itself */
-    release?: () => void;
+interface RevisionRedone {
+    type: "revision-redone";
+    revisionId: UID;
+    commands: readonly CoreCommand[];
 }
-
-declare type StatefulStream<Event, State> = {
-    capture(owner: unknown, state: State, callbacks: StreamCallbacks<Event>): void;
-    registerAsDefault: (owner: unknown, state: State, callbacks: StreamCallbacks<Event>) => void;
-    resetDefaultAnchor: (owner: unknown, state: State) => void;
-    resetAnchor: (owner: unknown, state: State) => void;
-    observe: (owner: unknown, callbacks: StreamCallbacks<Event>) => void;
-    release: (owner: unknown) => void;
-    getBackToDefault(): void;
-};
-/**
- * Allows to select cells in the grid and update the selection
- */
-interface SelectionProcessor {
-    selectZone(anchor: AnchorZone): DispatchResult;
-    selectCell(col: number, row: number): DispatchResult;
-    moveAnchorCell(direction: SelectionDirection, step: SelectionStep): DispatchResult;
-    setAnchorCorner(col: number, row: number): DispatchResult;
-    addCellToSelection(col: number, row: number): DispatchResult;
-    resizeAnchorZone(direction: SelectionDirection, step: SelectionStep): DispatchResult;
-    selectColumn(index: number, mode: SelectionEvent["mode"]): DispatchResult;
-    selectRow(index: number, mode: SelectionEvent["mode"]): DispatchResult;
-    selectAll(): DispatchResult;
-    loopSelection(): DispatchResult;
-    selectTableAroundSelection(): DispatchResult;
+interface CollaborativeEventReceived {
+    type: "collaborative-event-received";
 }
-declare type SelectionStreamProcessor = SelectionProcessor & StatefulStream<SelectionEvent, AnchorZone>;
+interface UnexpectedRevisionIdEvent {
+    type: "unexpected-revision-id";
+    revisionId: UID;
+}
+interface NewLocalStateUpdateEvent {
+    type: "new-local-state-update";
+    id: UID;
+}
+interface RevisionsDroppedEvent {
+    type: "pending-revisions-dropped";
+    revisionIds: UID[];
+}
+interface SnapshotEvent {
+    type: "snapshot";
+}
+declare type CollaborativeEvent = NewLocalStateUpdateEvent | UnexpectedRevisionIdEvent | RemoteRevisionReceivedEvent | RevisionAcknowledgedEvent | RevisionUndone | RevisionRedone | RevisionsDroppedEvent | SnapshotEvent | CollaborativeEventReceived;
 
 declare type XLSXExportFile = XLSXExportImageFile | XLSXExportXMLFile;
 interface XLSXExportXMLFile {
@@ -725,140 +659,392 @@ interface ExcelFilterData {
     filteredValues: string[];
 }
 
-declare type ClientId = string;
-interface Client {
-    id: ClientId;
-    name: string;
-    position?: ClientPosition;
-}
-interface ClientPosition {
-    sheetId: UID;
-    col: HeaderIndex;
-    row: HeaderIndex;
+interface AbstractMessage {
+    version: number;
 }
-interface RemoteRevisionReceivedEvent {
-    type: "remote-revision-received";
+interface RemoteRevisionMessage extends AbstractMessage {
+    type: "REMOTE_REVISION";
+    clientId: ClientId;
     commands: readonly CoreCommand[];
+    nextRevisionId: UID;
+    serverRevisionId: UID;
 }
-interface RevisionAcknowledgedEvent {
-    type: "revision-acknowledged";
-    revisionId: UID;
+interface RevisionUndoneMessage extends AbstractMessage {
+    type: "REVISION_UNDONE";
+    undoneRevisionId: UID;
+    nextRevisionId: UID;
+    serverRevisionId: UID;
 }
-interface RevisionUndone {
-    type: "revision-undone";
-    revisionId: UID;
-    commands: readonly CoreCommand[];
+interface RevisionRedoneMessage extends AbstractMessage {
+    type: "REVISION_REDONE";
+    redoneRevisionId: UID;
+    nextRevisionId: UID;
+    serverRevisionId: UID;
 }
-interface RevisionRedone {
-    type: "revision-redone";
-    revisionId: UID;
-    commands: readonly CoreCommand[];
+interface ClientJoinedMessage extends AbstractMessage {
+    type: "CLIENT_JOINED";
+    client: Required<Client>;
 }
-interface CollaborativeEventReceived {
-    type: "collaborative-event-received";
+interface ClientLeftMessage extends AbstractMessage {
+    type: "CLIENT_LEFT";
+    clientId: ClientId;
 }
-interface UnexpectedRevisionIdEvent {
-    type: "unexpected-revision-id";
-    revisionId: UID;
+interface ClientMovedMessage extends AbstractMessage {
+    type: "CLIENT_MOVED";
+    client: Required<Client>;
 }
-interface NewLocalStateUpdateEvent {
-    type: "new-local-state-update";
-    id: UID;
+/**
+ * Send a snapshot of the spreadsheet to the collaborative server
+ */
+interface SnapshotMessage extends AbstractMessage {
+    type: "SNAPSHOT";
+    data: WorkbookData;
+    serverRevisionId: UID;
+    nextRevisionId: UID;
 }
-interface RevisionsDroppedEvent {
-    type: "pending-revisions-dropped";
-    revisionIds: UID[];
+/**
+ * Notify all clients that the server has a new snapshot of the
+ * spreadsheet and that the previous history may be lost.
+ */
+interface SnapshotCreatedMessage extends AbstractMessage {
+    type: "SNAPSHOT_CREATED";
+    serverRevisionId: UID;
+    nextRevisionId: UID;
 }
-interface SnapshotEvent {
-    type: "snapshot";
+declare type CollaborationMessage = RevisionUndoneMessage | RevisionRedoneMessage | RemoteRevisionMessage | SnapshotMessage | SnapshotCreatedMessage | ClientMovedMessage | ClientJoinedMessage | ClientLeftMessage;
+declare type StateUpdateMessage = Extract<CollaborationMessage, {
+    nextRevisionId: UID;
+}>;
+declare type NewMessageCallback<T = any> = (message: T) => void;
+/**
+ * The transport service allows to communicate between multiple clients.
+ * A client can send any message to others.
+ * The service will handle all networking details internally.
+ */
+interface TransportService<T = any> {
+    /**
+     * Send a message to all clients
+     */
+    sendMessage: (message: T) => void;
+    /**
+     * Register a callback function which will be called each time
+     * a new message is received.
+     * The new message is given to the callback.
+     *
+     * ```js
+     * transportService.onNewMessage(id, (message) => {
+     *   // ... handle the new message
+     * })
+     * ```
+     * The `id` is used to unregister this callback when the session is closed.
+     */
+    onNewMessage: (id: UID, callback: NewMessageCallback<T>) => void;
+    /**
+     * Unregister a callback linked to the given id
+     */
+    leave: (id: UID) => void;
+}
+
+declare class Revision implements RevisionData {
+    readonly rootCommand?: "SNAPSHOT" | Command | "REMOTE" | undefined;
+    readonly id: UID;
+    readonly clientId: ClientId;
+    private _commands;
+    private _changes;
+    /**
+     * A revision represents a whole client action (Create a sheet, merge a Zone, Undo, ...).
+     * A revision contains the following information:
+     *  - id: ID of the revision
+     *  - commands: CoreCommands that are linked to the action, and should be
+     *              dispatched in other clients
+     *  - clientId: Client who initiated the action
+     *  - changes: List of changes applied on the state.
+     */
+    constructor(id: UID, clientId: ClientId, commands: readonly CoreCommand[], rootCommand?: "SNAPSHOT" | Command | "REMOTE" | undefined, changes?: readonly HistoryChange[]);
+    setChanges(changes: readonly HistoryChange[]): void;
+    get commands(): readonly CoreCommand[];
+    get changes(): readonly HistoryChange[];
+}
+
+declare class Session extends EventBus<CollaborativeEvent> {
+    private revisions;
+    private transportService;
+    private serverRevisionId;
+    /**
+     * Positions of the others client.
+     */
+    private clients;
+    private clientId;
+    /**
+     * Id of the server revision
+     */
+    private debouncedMove;
+    private pendingMessages;
+    private waitingAck;
+    /**
+     * Flag used to block all commands when an undo or redo is triggered, until
+     * it is accepted on the server
+     */
+    private waitingUndoRedoAck;
+    private isReplayingInitialRevisions;
+    private processedRevisions;
+    private uuidGenerator;
+    /**
+     * Manages the collaboration between multiple users on the same spreadsheet.
+     * It can forward local state changes to other users to ensure they all eventually
+     * reach the same state.
+     * It also manages the positions of each clients in the spreadsheet to provide
+     * a visual indication of what other users are doing in the spreadsheet.
+     *
+     * @param revisions
+     * @param transportService communication channel used to send and receive messages
+     * between all connected clients
+     * @param client the client connected locally
+     * @param serverRevisionId
+     */
+    constructor(revisions: SelectiveHistory<Revision>, transportService: TransportService<CollaborationMessage>, serverRevisionId?: UID);
+    canApplyOptimisticUpdate(): boolean;
+    /**
+     * Add a new revision to the collaborative session.
+     * It will be transmitted to all other connected clients.
+     */
+    save(rootCommand: Command, commands: CoreCommand[], changes: HistoryChange[]): void;
+    undo(revisionId: UID): void;
+    redo(revisionId: UID): void;
+    /**
+     * Notify that the position of the client has changed
+     */
+    move(position: ClientPosition): void;
+    join(client?: Client): void;
+    loadInitialMessages(messages: StateUpdateMessage[]): void;
+    /**
+     * Notify the server that the user client left the collaborative session
+     */
+    leave(): void;
+    /**
+     * Send a snapshot of the spreadsheet to the collaboration server
+     */
+    snapshot(data: WorkbookData): void;
+    getClient(): Client;
+    getConnectedClients(): Set<Client>;
+    getRevisionId(): UID;
+    isFullySynchronized(): boolean;
+    /**
+     * Get the last local revision whose root command isn't in the given list of ignored commands
+     * */
+    getLastLocalNonEmptyRevision(ignoredRootCommands: CommandTypes[]): Revision | undefined;
+    private _move;
+    /**
+     * Handles messages received from other clients in the collaborative
+     * session.
+     */
+    private onMessageReceived;
+    private onClientMoved;
+    /**
+     * Register the new client and send your
+     * own position back.
+     */
+    private onClientJoined;
+    private onClientLeft;
+    private sendUpdateMessage;
+    /**
+     * Send the next pending message
+     */
+    private sendPendingMessage;
+    private acknowledge;
+    private isAlreadyProcessed;
+    private dropPendingHistoryMessages;
 }
-declare type CollaborativeEvent = NewLocalStateUpdateEvent | UnexpectedRevisionIdEvent | RemoteRevisionReceivedEvent | RevisionAcknowledgedEvent | RevisionUndone | RevisionRedone | RevisionsDroppedEvent | SnapshotEvent | CollaborativeEventReceived;
 
-interface AbstractMessage {
-    version: number;
-}
-interface RemoteRevisionMessage extends AbstractMessage {
-    type: "REMOTE_REVISION";
-    clientId: ClientId;
-    commands: readonly CoreCommand[];
-    nextRevisionId: UID;
-    serverRevisionId: UID;
-}
-interface RevisionUndoneMessage extends AbstractMessage {
-    type: "REVISION_UNDONE";
-    undoneRevisionId: UID;
-    nextRevisionId: UID;
-    serverRevisionId: UID;
-}
-interface RevisionRedoneMessage extends AbstractMessage {
-    type: "REVISION_REDONE";
-    redoneRevisionId: UID;
-    nextRevisionId: UID;
-    serverRevisionId: UID;
-}
-interface ClientJoinedMessage extends AbstractMessage {
-    type: "CLIENT_JOINED";
-    client: Required<Client>;
-}
-interface ClientLeftMessage extends AbstractMessage {
-    type: "CLIENT_LEFT";
-    clientId: ClientId;
-}
-interface ClientMovedMessage extends AbstractMessage {
-    type: "CLIENT_MOVED";
-    client: Required<Client>;
-}
 /**
- * Send a snapshot of the spreadsheet to the collaborative server
+ * RGBA to HEX representation (#RRGGBBAA).
+ *
+ * https://css-tricks.com/converting-color-spaces-in-javascript/
  */
-interface SnapshotMessage extends AbstractMessage {
-    type: "SNAPSHOT";
-    data: WorkbookData;
-    serverRevisionId: UID;
-    nextRevisionId: UID;
-}
+declare function rgbaToHex(rgba: RGBA): Color;
 /**
- * Notify all clients that the server has a new snapshot of the
- * spreadsheet and that the previous history may be lost.
+ * Color string to RGBA representation
  */
-interface SnapshotCreatedMessage extends AbstractMessage {
-    type: "SNAPSHOT_CREATED";
-    serverRevisionId: UID;
-    nextRevisionId: UID;
-}
-declare type CollaborationMessage = RevisionUndoneMessage | RevisionRedoneMessage | RemoteRevisionMessage | SnapshotMessage | SnapshotCreatedMessage | ClientMovedMessage | ClientJoinedMessage | ClientLeftMessage;
-declare type StateUpdateMessage = Extract<CollaborationMessage, {
-    nextRevisionId: UID;
-}>;
-declare type NewMessageCallback<T = any> = (message: T) => void;
+declare function colorToRGBA(color: Color): RGBA;
+
 /**
- * The transport service allows to communicate between multiple clients.
- * A client can send any message to others.
- * The service will handle all networking details internally.
+ * Convert a (col) number to the corresponding letter.
+ *
+ * Examples:
+ *     0 => 'A'
+ *     25 => 'Z'
+ *     26 => 'AA'
+ *     27 => 'AB'
  */
-interface TransportService<T = any> {
+declare function numberToLetters(n: number): string;
+/**
+ * Convert a "XC" coordinate to cartesian coordinates.
+ *
+ * Examples:
+ *   A1 => [0,0]
+ *   B3 => [1,2]
+ *
+ * Note: it also accepts lowercase coordinates, but not fixed references
+ */
+declare function toCartesian(xc: string): Position$1;
+/**
+ * Convert from cartesian coordinate to the "XC" coordinate system.
+ *
+ * Examples:
+ *   - 0,0 => A1
+ *   - 1,2 => B3
+ *   - 0,0, {colFixed: false, rowFixed: true} => A$1
+ *   - 1,2, {colFixed: true, rowFixed: false} => $B3
+ */
+declare function toXC(col: HeaderIndex, row: HeaderIndex, rangePart?: RangePart): string;
+
+/**
+ * Formats a cell value with its format.
+ */
+declare function formatValue(value: CellValue, format?: Format): FormattedValue;
+
+declare function computeTextWidth(context: CanvasRenderingContext2D, text: string, style: Style): number;
+declare function isMarkdownLink(str: string): boolean;
+/**
+ * Build a markdown link from a label and an url
+ */
+declare function markdownLink(label: string, url: string): string;
+declare function parseMarkdownLink(str: string): {
+    url: string;
+    label: string;
+};
+/**
+ * This helper function can be used as a type guard when filtering arrays.
+ * const foo: number[] = [1, 2, undefined, 4].filter(isDefined)
+ */
+declare function isDefined<T>(argument: T | undefined): argument is T;
+/**
+ * Lazy value computed by the provided function.
+ */
+declare function lazy<T>(fn: (() => T) | T): Lazy<T>;
+
+interface ConstructorArgs {
+    readonly zone: Readonly<Zone | UnboundedZone>;
+    readonly parts: readonly RangePart[];
+    readonly invalidXc?: string;
+    /** true if the user provided the range with the sheet name */
+    readonly prefixSheet: boolean;
+    /** the name of any sheet that is invalid */
+    readonly invalidSheetName?: string;
+    /** the sheet on which the range is defined */
+    readonly sheetId: UID;
+}
+declare class RangeImpl implements Range {
+    private getSheetSize;
+    private readonly _zone;
+    readonly parts: Range["parts"];
+    readonly invalidXc?: string;
+    readonly prefixSheet: boolean;
+    readonly sheetId: UID;
+    readonly invalidSheetName?: string;
+    constructor(args: ConstructorArgs, getSheetSize: (sheetId: UID) => ZoneDimension);
+    static fromRange(range: Range, getters: CoreGetters): RangeImpl;
+    get unboundedZone(): UnboundedZone;
+    get zone(): Zone;
+    static getRangeParts(xc: string, zone: UnboundedZone): RangePart[];
+    get isFullCol(): boolean;
+    get isFullRow(): boolean;
+    get rangeData(): RangeData;
     /**
-     * Send a message to all clients
+     * Check that a zone is valid regarding the order of top-bottom and left-right.
+     * Left should be smaller than right, top should be smaller than bottom.
+     * If it's not the case, simply invert them, and invert the linked parts
      */
-    sendMessage: (message: T) => void;
+    orderZone(): RangeImpl;
     /**
-     * Register a callback function which will be called each time
-     * a new message is received.
-     * The new message is given to the callback.
      *
-     * ```js
-     * transportService.onNewMessage(id, (message) => {
-     *   // ... handle the new message
-     * })
-     * ```
-     * The `id` is used to unregister this callback when the session is closed.
-     */
-    onNewMessage: (id: UID, callback: NewMessageCallback<T>) => void;
-    /**
-     * Unregister a callback linked to the given id
+     * @param rangeParams optional, values to put in the cloned range instead of the current values of the range
      */
-    leave: (id: UID) => void;
+    clone(rangeParams?: Partial<ConstructorArgs>): RangeImpl;
+}
+
+declare class UuidGenerator {
+    private isFastIdStrategy;
+    private fastIdStart;
+    setIsFastStrategy(isFast: boolean): void;
+    uuidv4(): string;
+}
+
+/**
+ * Convert from a cartesian reference to a Zone.
+ * Will return throw an error if given a unbounded zone (eg : A:A).
+ *
+ * Examples:
+ *    "A1" ==> Top 0, Bottom 0, Left: 0, Right: 0
+ *    "B1:B3" ==> Top 0, Bottom 3, Left: 1, Right: 1
+ *    "Sheet1!A1" ==> Top 0, Bottom 0, Left: 0, Right: 0
+ *    "Sheet1!B1:B3" ==> Top 0, Bottom 3, Left: 1, Right: 1
+ *
+ * @param xc the string reference to convert
+ *
+ */
+declare function toZone(xc: string): Zone;
+/**
+ * This function will compare the modifications of selection to determine
+ * a cell that is part of the new zone and not the previous one.
+ */
+declare function findCellInNewZone(oldZone: Zone, currentZone: Zone): Position$1;
+declare function positionToZone(position: Position$1): {
+    left: HeaderIndex;
+    right: HeaderIndex;
+    top: HeaderIndex;
+    bottom: HeaderIndex;
+};
+
+interface SelectionEventPayload {
+    anchor: AnchorZone;
+    previousAnchor: AnchorZone;
+    mode: "newAnchor" | "overrideSelection" | "updateAnchor";
+}
+interface ZonesSelected extends SelectionEventPayload {
+    type: "ZonesSelected";
+}
+interface HeadersSelected extends SelectionEventPayload {
+    type: "HeadersSelected";
+}
+interface AlterZone extends SelectionEventPayload {
+    type: "AlterZone";
+}
+declare type SelectionEvent = Readonly<ZonesSelected | HeadersSelected | AlterZone>;
+
+interface StreamCallbacks<Event> {
+    handleEvent: (event: Event) => void;
+    /** this callback will only be called when another consumer captures the stream,
+     * not when the current consumer decides to release itself */
+    release?: () => void;
+}
+
+declare type StatefulStream<Event, State> = {
+    capture(owner: unknown, state: State, callbacks: StreamCallbacks<Event>): void;
+    registerAsDefault: (owner: unknown, state: State, callbacks: StreamCallbacks<Event>) => void;
+    resetDefaultAnchor: (owner: unknown, state: State) => void;
+    resetAnchor: (owner: unknown, state: State) => void;
+    observe: (owner: unknown, callbacks: StreamCallbacks<Event>) => void;
+    release: (owner: unknown) => void;
+    getBackToDefault(): void;
+};
+/**
+ * Allows to select cells in the grid and update the selection
+ */
+interface SelectionProcessor {
+    selectZone(anchor: AnchorZone): DispatchResult;
+    selectCell(col: number, row: number): DispatchResult;
+    moveAnchorCell(direction: SelectionDirection, step: SelectionStep): DispatchResult;
+    setAnchorCorner(col: number, row: number): DispatchResult;
+    addCellToSelection(col: number, row: number): DispatchResult;
+    resizeAnchorZone(direction: SelectionDirection, step: SelectionStep): DispatchResult;
+    selectColumn(index: number, mode: SelectionEvent["mode"]): DispatchResult;
+    selectRow(index: number, mode: SelectionEvent["mode"]): DispatchResult;
+    selectAll(): DispatchResult;
+    loopSelection(): DispatchResult;
+    selectTableAroundSelection(): DispatchResult;
 }
+declare type SelectionStreamProcessor = SelectionProcessor & StatefulStream<SelectionEvent, AnchorZone>;
 
 declare type FilePath = string;
 /**
@@ -944,7 +1130,6 @@ declare class Model extends EventBus<any> implements CommandDispatcher {
     private featurePlugins;
     private statefulUIPlugins;
     private coreViewsPlugins;
-    private history;
     private range;
     private session;
     /**
@@ -984,10 +1169,9 @@ declare class Model extends EventBus<any> implements CommandDispatcher {
      */
     private coreGetters;
     uuidGenerator: UuidGenerator;
+    private readonly handlers;
+    private readonly coreHandlers;
     constructor(data?: any, config?: Partial<ModelConfig>, stateUpdateMessages?: StateUpdateMessage[], uuidGenerator?: UuidGenerator, verboseImport?: boolean);
-    get handlers(): CommandHandler<Command>[];
-    get coreHandlers(): CommandHandler<Command>[];
-    get allUIPlugins(): UIPlugin[];
     joinSession(): void;
     leaveSession(): void;
     private setupUiPlugin;
@@ -1172,6 +1356,7 @@ interface UIPluginConfig {
     readonly uiActions: UIActions;
     readonly custom: ModelConfig["custom"];
     readonly lazyEvaluation: boolean;
+    readonly session: Session;
 }
 interface UIPluginConstructor {
     new (config: UIPluginConfig): UIPlugin;
@@ -1476,8 +1661,8 @@ interface PositionDependentCommand {
     col: number;
     row: number;
 }
-declare const invalidateEvaluationCommands: Set<"UPDATE_CELL" | "UPDATE_CELL_POSITION" | "CLEAR_CELL" | "DELETE_CONTENT" | "ADD_COLUMNS_ROWS" | "REMOVE_COLUMNS_ROWS" | "RESIZE_COLUMNS_ROWS" | "HIDE_COLUMNS_ROWS" | "UNHIDE_COLUMNS_ROWS" | "SET_GRID_LINES_VISIBILITY" | "FREEZE_COLUMNS" | "FREEZE_ROWS" | "UNFREEZE_COLUMNS_ROWS" | "UNFREEZE_COLUMNS" | "UNFREEZE_ROWS" | "ADD_MERGE" | "REMOVE_MERGE" | "CREATE_SHEET" | "DELETE_SHEET" | "DUPLICATE_SHEET" | "MOVE_SHEET" | "RENAME_SHEET" | "HIDE_SHEET" | "SHOW_SHEET" | "MOVE_RANGES" | "ADD_CONDITIONAL_FORMAT" | "REMOVE_CONDITIONAL_FORMAT" | "MOVE_CONDITIONAL_FORMAT" | "CREATE_FIGURE" | "DELETE_FIGURE" | "UPDATE_FIGURE" | "SET_FORMATTING" | "CLEAR_FORMATTING" | "SET_BORDER" | "CREATE_CHART" | "UPDATE_CHART" | "CREATE_IMAGE" | "CREATE_FILTER_TABLE" | "REMOVE_FILTER_TABLE" | "REQUEST_UNDO" | "REQUEST_REDO" | "UNDO" | "REDO" | "ENABLE_NEW_SELECTION_INPUT" | "DISABLE_SELECTION_INPUT" | "UNFOCUS_SELECTION_INPUT" | "FOCUS_RANGE" | "ADD_EMPTY_RANGE" | "REMOVE_RANGE" | "CHANGE_RANGE" | "COPY" | "CUT" | "PASTE" | "CLEAN_CLIPBOARD_HIGHLIGHT" | "AUTOFILL_CELL" | "PASTE_FROM_OS_CLIPBOARD" | "ACTIVATE_PAINT_FORMAT" | "PASTE_CONDITIONAL_FORMAT" | "AUTORESIZE_COLUMNS" | "AUTORESIZE_ROWS" | "MOVE_COLUMNS_ROWS" | "ACTIVATE_SHEET" | "PREPARE_SELECTION_INPUT_EXPANSION" | "STOP_SELECTION_INPUT" | "EVALUATE_CELLS" | "CHANGE_HIGHLIGHT" | "START_CHANGE_HIGHLIGHT" | "SET_HIGHLIGHT_COLOR" | "STOP_COMPOSER_RANGE_SELECTION" | "START_EDITION" | "STOP_EDITION" | "SET_CURRENT_CONTENT" | "CHANGE_COMPOSER_CURSOR_SELECTION" | "REPLACE_COMPOSER_CURSOR_SELECTION" | "CYCLE_EDITION_REFERENCES" | "START" | "AUTOFILL" | "AUTOFILL_SELECT" | "SET_FORMULA_VISIBILITY" | "AUTOFILL_AUTO" | "SELECT_FIGURE" | "UPDATE_SEARCH" | "REFRESH_SEARCH" | "CLEAR_SEARCH" | "SELECT_SEARCH_PREVIOUS_MATCH" | "SELECT_SEARCH_NEXT_MATCH" | "REPLACE_SEARCH" | "REPLACE_ALL_SEARCH" | "SORT_CELLS" | "SET_DECIMAL" | "RESIZE_SHEETVIEW" | "SUM_SELECTION" | "DELETE_CELL" | "INSERT_CELL" | "SET_VIEWPORT_OFFSET" | "SHIFT_VIEWPORT_DOWN" | "SHIFT_VIEWPORT_UP" | "OPEN_CELL_POPOVER" | "CLOSE_CELL_POPOVER" | "ACTIVATE_NEXT_SHEET" | "ACTIVATE_PREVIOUS_SHEET" | "UPDATE_FILTER">;
-declare const readonlyAllowedCommands: Set<"UPDATE_CELL" | "UPDATE_CELL_POSITION" | "CLEAR_CELL" | "DELETE_CONTENT" | "ADD_COLUMNS_ROWS" | "REMOVE_COLUMNS_ROWS" | "RESIZE_COLUMNS_ROWS" | "HIDE_COLUMNS_ROWS" | "UNHIDE_COLUMNS_ROWS" | "SET_GRID_LINES_VISIBILITY" | "FREEZE_COLUMNS" | "FREEZE_ROWS" | "UNFREEZE_COLUMNS_ROWS" | "UNFREEZE_COLUMNS" | "UNFREEZE_ROWS" | "ADD_MERGE" | "REMOVE_MERGE" | "CREATE_SHEET" | "DELETE_SHEET" | "DUPLICATE_SHEET" | "MOVE_SHEET" | "RENAME_SHEET" | "HIDE_SHEET" | "SHOW_SHEET" | "MOVE_RANGES" | "ADD_CONDITIONAL_FORMAT" | "REMOVE_CONDITIONAL_FORMAT" | "MOVE_CONDITIONAL_FORMAT" | "CREATE_FIGURE" | "DELETE_FIGURE" | "UPDATE_FIGURE" | "SET_FORMATTING" | "CLEAR_FORMATTING" | "SET_BORDER" | "CREATE_CHART" | "UPDATE_CHART" | "CREATE_IMAGE" | "CREATE_FILTER_TABLE" | "REMOVE_FILTER_TABLE" | "REQUEST_UNDO" | "REQUEST_REDO" | "UNDO" | "REDO" | "ENABLE_NEW_SELECTION_INPUT" | "DISABLE_SELECTION_INPUT" | "UNFOCUS_SELECTION_INPUT" | "FOCUS_RANGE" | "ADD_EMPTY_RANGE" | "REMOVE_RANGE" | "CHANGE_RANGE" | "COPY" | "CUT" | "PASTE" | "CLEAN_CLIPBOARD_HIGHLIGHT" | "AUTOFILL_CELL" | "PASTE_FROM_OS_CLIPBOARD" | "ACTIVATE_PAINT_FORMAT" | "PASTE_CONDITIONAL_FORMAT" | "AUTORESIZE_COLUMNS" | "AUTORESIZE_ROWS" | "MOVE_COLUMNS_ROWS" | "ACTIVATE_SHEET" | "PREPARE_SELECTION_INPUT_EXPANSION" | "STOP_SELECTION_INPUT" | "EVALUATE_CELLS" | "CHANGE_HIGHLIGHT" | "START_CHANGE_HIGHLIGHT" | "SET_HIGHLIGHT_COLOR" | "STOP_COMPOSER_RANGE_SELECTION" | "START_EDITION" | "STOP_EDITION" | "SET_CURRENT_CONTENT" | "CHANGE_COMPOSER_CURSOR_SELECTION" | "REPLACE_COMPOSER_CURSOR_SELECTION" | "CYCLE_EDITION_REFERENCES" | "START" | "AUTOFILL" | "AUTOFILL_SELECT" | "SET_FORMULA_VISIBILITY" | "AUTOFILL_AUTO" | "SELECT_FIGURE" | "UPDATE_SEARCH" | "REFRESH_SEARCH" | "CLEAR_SEARCH" | "SELECT_SEARCH_PREVIOUS_MATCH" | "SELECT_SEARCH_NEXT_MATCH" | "REPLACE_SEARCH" | "REPLACE_ALL_SEARCH" | "SORT_CELLS" | "SET_DECIMAL" | "RESIZE_SHEETVIEW" | "SUM_SELECTION" | "DELETE_CELL" | "INSERT_CELL" | "SET_VIEWPORT_OFFSET" | "SHIFT_VIEWPORT_DOWN" | "SHIFT_VIEWPORT_UP" | "OPEN_CELL_POPOVER" | "CLOSE_CELL_POPOVER" | "ACTIVATE_NEXT_SHEET" | "ACTIVATE_PREVIOUS_SHEET" | "UPDATE_FILTER">;
+declare const invalidateEvaluationCommands: Set<"UPDATE_CELL" | "UPDATE_CELL_POSITION" | "CLEAR_CELL" | "DELETE_CONTENT" | "ADD_COLUMNS_ROWS" | "REMOVE_COLUMNS_ROWS" | "RESIZE_COLUMNS_ROWS" | "HIDE_COLUMNS_ROWS" | "UNHIDE_COLUMNS_ROWS" | "SET_GRID_LINES_VISIBILITY" | "FREEZE_COLUMNS" | "FREEZE_ROWS" | "UNFREEZE_COLUMNS_ROWS" | "UNFREEZE_COLUMNS" | "UNFREEZE_ROWS" | "ADD_MERGE" | "REMOVE_MERGE" | "CREATE_SHEET" | "DELETE_SHEET" | "DUPLICATE_SHEET" | "MOVE_SHEET" | "RENAME_SHEET" | "HIDE_SHEET" | "SHOW_SHEET" | "MOVE_RANGES" | "ADD_CONDITIONAL_FORMAT" | "REMOVE_CONDITIONAL_FORMAT" | "MOVE_CONDITIONAL_FORMAT" | "CREATE_FIGURE" | "DELETE_FIGURE" | "UPDATE_FIGURE" | "SET_FORMATTING" | "CLEAR_FORMATTING" | "SET_BORDER" | "CREATE_CHART" | "UPDATE_CHART" | "CREATE_IMAGE" | "CREATE_FILTER_TABLE" | "REMOVE_FILTER_TABLE" | "SORT_CELLS" | "SET_DECIMAL" | "REQUEST_UNDO" | "REQUEST_REDO" | "UNDO" | "REDO" | "ENABLE_NEW_SELECTION_INPUT" | "DISABLE_SELECTION_INPUT" | "UNFOCUS_SELECTION_INPUT" | "FOCUS_RANGE" | "ADD_EMPTY_RANGE" | "REMOVE_RANGE" | "CHANGE_RANGE" | "COPY" | "CUT" | "PASTE" | "REPEAT_PASTE" | "CLEAN_CLIPBOARD_HIGHLIGHT" | "AUTOFILL_CELL" | "PASTE_FROM_OS_CLIPBOARD" | "ACTIVATE_PAINT_FORMAT" | "PASTE_CONDITIONAL_FORMAT" | "AUTORESIZE_COLUMNS" | "AUTORESIZE_ROWS" | "MOVE_COLUMNS_ROWS" | "ACTIVATE_SHEET" | "PREPARE_SELECTION_INPUT_EXPANSION" | "STOP_SELECTION_INPUT" | "EVALUATE_CELLS" | "CHANGE_HIGHLIGHT" | "START_CHANGE_HIGHLIGHT" | "SET_HIGHLIGHT_COLOR" | "STOP_COMPOSER_RANGE_SELECTION" | "START_EDITION" | "STOP_EDITION" | "SET_CURRENT_CONTENT" | "CHANGE_COMPOSER_CURSOR_SELECTION" | "REPLACE_COMPOSER_CURSOR_SELECTION" | "CYCLE_EDITION_REFERENCES" | "START" | "AUTOFILL" | "AUTOFILL_SELECT" | "SET_FORMULA_VISIBILITY" | "AUTOFILL_AUTO" | "SELECT_FIGURE" | "UPDATE_SEARCH" | "REFRESH_SEARCH" | "CLEAR_SEARCH" | "SELECT_SEARCH_PREVIOUS_MATCH" | "SELECT_SEARCH_NEXT_MATCH" | "REPLACE_SEARCH" | "REPLACE_ALL_SEARCH" | "RESIZE_SHEETVIEW" | "SUM_SELECTION" | "DELETE_CELL" | "INSERT_CELL" | "SET_VIEWPORT_OFFSET" | "SHIFT_VIEWPORT_DOWN" | "SHIFT_VIEWPORT_UP" | "OPEN_CELL_POPOVER" | "CLOSE_CELL_POPOVER" | "ACTIVATE_NEXT_SHEET" | "ACTIVATE_PREVIOUS_SHEET" | "UPDATE_FILTER">;
+declare const readonlyAllowedCommands: Set<"UPDATE_CELL" | "UPDATE_CELL_POSITION" | "CLEAR_CELL" | "DELETE_CONTENT" | "ADD_COLUMNS_ROWS" | "REMOVE_COLUMNS_ROWS" | "RESIZE_COLUMNS_ROWS" | "HIDE_COLUMNS_ROWS" | "UNHIDE_COLUMNS_ROWS" | "SET_GRID_LINES_VISIBILITY" | "FREEZE_COLUMNS" | "FREEZE_ROWS" | "UNFREEZE_COLUMNS_ROWS" | "UNFREEZE_COLUMNS" | "UNFREEZE_ROWS" | "ADD_MERGE" | "REMOVE_MERGE" | "CREATE_SHEET" | "DELETE_SHEET" | "DUPLICATE_SHEET" | "MOVE_SHEET" | "RENAME_SHEET" | "HIDE_SHEET" | "SHOW_SHEET" | "MOVE_RANGES" | "ADD_CONDITIONAL_FORMAT" | "REMOVE_CONDITIONAL_FORMAT" | "MOVE_CONDITIONAL_FORMAT" | "CREATE_FIGURE" | "DELETE_FIGURE" | "UPDATE_FIGURE" | "SET_FORMATTING" | "CLEAR_FORMATTING" | "SET_BORDER" | "CREATE_CHART" | "UPDATE_CHART" | "CREATE_IMAGE" | "CREATE_FILTER_TABLE" | "REMOVE_FILTER_TABLE" | "SORT_CELLS" | "SET_DECIMAL" | "REQUEST_UNDO" | "REQUEST_REDO" | "UNDO" | "REDO" | "ENABLE_NEW_SELECTION_INPUT" | "DISABLE_SELECTION_INPUT" | "UNFOCUS_SELECTION_INPUT" | "FOCUS_RANGE" | "ADD_EMPTY_RANGE" | "REMOVE_RANGE" | "CHANGE_RANGE" | "COPY" | "CUT" | "PASTE" | "REPEAT_PASTE" | "CLEAN_CLIPBOARD_HIGHLIGHT" | "AUTOFILL_CELL" | "PASTE_FROM_OS_CLIPBOARD" | "ACTIVATE_PAINT_FORMAT" | "PASTE_CONDITIONAL_FORMAT" | "AUTORESIZE_COLUMNS" | "AUTORESIZE_ROWS" | "MOVE_COLUMNS_ROWS" | "ACTIVATE_SHEET" | "PREPARE_SELECTION_INPUT_EXPANSION" | "STOP_SELECTION_INPUT" | "EVALUATE_CELLS" | "CHANGE_HIGHLIGHT" | "START_CHANGE_HIGHLIGHT" | "SET_HIGHLIGHT_COLOR" | "STOP_COMPOSER_RANGE_SELECTION" | "START_EDITION" | "STOP_EDITION" | "SET_CURRENT_CONTENT" | "CHANGE_COMPOSER_CURSOR_SELECTION" | "REPLACE_COMPOSER_CURSOR_SELECTION" | "CYCLE_EDITION_REFERENCES" | "START" | "AUTOFILL" | "AUTOFILL_SELECT" | "SET_FORMULA_VISIBILITY" | "AUTOFILL_AUTO" | "SELECT_FIGURE" | "UPDATE_SEARCH" | "REFRESH_SEARCH" | "CLEAR_SEARCH" | "SELECT_SEARCH_PREVIOUS_MATCH" | "SELECT_SEARCH_NEXT_MATCH" | "REPLACE_SEARCH" | "REPLACE_ALL_SEARCH" | "RESIZE_SHEETVIEW" | "SUM_SELECTION" | "DELETE_CELL" | "INSERT_CELL" | "SET_VIEWPORT_OFFSET" | "SHIFT_VIEWPORT_DOWN" | "SHIFT_VIEWPORT_UP" | "OPEN_CELL_POPOVER" | "CLOSE_CELL_POPOVER" | "ACTIVATE_NEXT_SHEET" | "ACTIVATE_PREVIOUS_SHEET" | "UPDATE_FILTER">;
 declare const coreTypes: Set<"UPDATE_CELL" | "UPDATE_CELL_POSITION" | "CLEAR_CELL" | "DELETE_CONTENT" | "ADD_COLUMNS_ROWS" | "REMOVE_COLUMNS_ROWS" | "RESIZE_COLUMNS_ROWS" | "HIDE_COLUMNS_ROWS" | "UNHIDE_COLUMNS_ROWS" | "SET_GRID_LINES_VISIBILITY" | "FREEZE_COLUMNS" | "FREEZE_ROWS" | "UNFREEZE_COLUMNS_ROWS" | "UNFREEZE_COLUMNS" | "UNFREEZE_ROWS" | "ADD_MERGE" | "REMOVE_MERGE" | "CREATE_SHEET" | "DELETE_SHEET" | "DUPLICATE_SHEET" | "MOVE_SHEET" | "RENAME_SHEET" | "HIDE_SHEET" | "SHOW_SHEET" | "MOVE_RANGES" | "ADD_CONDITIONAL_FORMAT" | "REMOVE_CONDITIONAL_FORMAT" | "MOVE_CONDITIONAL_FORMAT" | "CREATE_FIGURE" | "DELETE_FIGURE" | "UPDATE_FIGURE" | "SET_FORMATTING" | "CLEAR_FORMATTING" | "SET_BORDER" | "CREATE_CHART" | "UPDATE_CHART" | "CREATE_IMAGE" | "CREATE_FILTER_TABLE" | "REMOVE_FILTER_TABLE">;
 interface UpdateCellCommand extends PositionDependentCommand {
     type: "UPDATE_CELL";
@@ -1690,6 +1875,11 @@ interface PasteCommand {
     target: Zone[];
     pasteOption?: ClipboardPasteOptions;
 }
+interface RepeatPasteCommand {
+    type: "REPEAT_PASTE";
+    target: Zone[];
+    pasteOption?: ClipboardPasteOptions;
+}
 interface CleanClipBoardHighlightCommand {
     type: "CLEAN_CLIPBOARD_HIGHLIGHT";
 }
@@ -1800,11 +1990,8 @@ interface DeleteContentCommand {
     sheetId: UID;
     target: Zone[];
 }
-interface ClearCellCommand {
+interface ClearCellCommand extends PositionDependentCommand {
     type: "CLEAR_CELL";
-    sheetId: UID;
-    col: HeaderIndex;
-    row: HeaderIndex;
 }
 interface UndoCommand {
     type: "UNDO";
@@ -2034,7 +2221,7 @@ UpdateCellCommand | UpdateCellPositionCommand | ClearCellCommand | DeleteContent
  | CreateImageOverCommand
 /** FILTERS */
  | CreateFilterTableCommand | RemoveFilterTableCommand;
-declare type LocalCommand = RequestUndoCommand | RequestRedoCommand | UndoCommand | RedoCommand | NewInputCommand | RemoveInputCommand | UnfocusInputCommand | FocusInputCommand | AddEmptyRangeCommand | RemoveRangeCommand | ChangeRangeCommand | CopyCommand | CutCommand | PasteCommand | CleanClipBoardHighlightCommand | AutoFillCellCommand | PasteFromOSClipboardCommand | ActivatePaintFormatCommand | PasteCFCommand | AutoresizeColumnsCommand | AutoresizeRowsCommand | MoveColumnsRowsCommand | ActivateSheetCommand | PrepareExpansionCommand | StopSelectionCommand | EvaluateCellsCommand | ChangeHighlightCommand | StartChangeHighlightCommand | SetColorCommand | StopComposerSelectionCommand | StartEditionCommand | StopEditionCommand | SetCurrentContentCommand | ChangeComposerSelectionCommand | ReplaceComposerSelectionCommand | CycleEditionReferencesCommand | StartCommand | AutofillCommand | AutofillSelectCommand | ShowFormulaCommand | AutofillAutoCommand | SelectFigureCommand | UpdateSearchCommand | RefreshSearchCommand | ClearSearchCommand | SelectSearchPreviousCommand | SelectSearchNextCommand | ReplaceSearchCommand | ReplaceAllSearchCommand | SortCommand | SetDecimalCommand | ResizeViewportCommand | SumSelectionCommand | DeleteCellCommand | InsertCellCommand | SetViewportOffsetCommand | MoveViewportDownCommand | MoveViewportUpCommand | OpenCellPopoverCommand | CloseCellPopoverCommand | ActivateNextSheetCommand | ActivatePreviousSheetCommand | UpdateFilterCommand;
+declare type LocalCommand = RequestUndoCommand | RequestRedoCommand | UndoCommand | RedoCommand | NewInputCommand | RemoveInputCommand | UnfocusInputCommand | FocusInputCommand | AddEmptyRangeCommand | RemoveRangeCommand | ChangeRangeCommand | CopyCommand | CutCommand | PasteCommand | RepeatPasteCommand | CleanClipBoardHighlightCommand | AutoFillCellCommand | PasteFromOSClipboardCommand | ActivatePaintFormatCommand | PasteCFCommand | AutoresizeColumnsCommand | AutoresizeRowsCommand | MoveColumnsRowsCommand | ActivateSheetCommand | PrepareExpansionCommand | StopSelectionCommand | EvaluateCellsCommand | ChangeHighlightCommand | StartChangeHighlightCommand | SetColorCommand | StopComposerSelectionCommand | StartEditionCommand | StopEditionCommand | SetCurrentContentCommand | ChangeComposerSelectionCommand | ReplaceComposerSelectionCommand | CycleEditionReferencesCommand | StartCommand | AutofillCommand | AutofillSelectCommand | ShowFormulaCommand | AutofillAutoCommand | SelectFigureCommand | UpdateSearchCommand | RefreshSearchCommand | ClearSearchCommand | SelectSearchPreviousCommand | SelectSearchNextCommand | ReplaceSearchCommand | ReplaceAllSearchCommand | SortCommand | SetDecimalCommand | ResizeViewportCommand | SumSelectionCommand | DeleteCellCommand | InsertCellCommand | SetViewportOffsetCommand | MoveViewportDownCommand | MoveViewportUpCommand | OpenCellPopoverCommand | CloseCellPopoverCommand | ActivateNextSheetCommand | ActivatePreviousSheetCommand | UpdateFilterCommand;
 declare type Command = CoreCommand | LocalCommand;
 /**
  * Holds the result of a command dispatch.
@@ -2619,218 +2806,6 @@ declare type EvalContext = {
     [key: string]: any;
 };
 
-declare class SelectiveHistory<T = unknown> {
-    private applyOperation;
-    private revertOperation;
-    private buildEmpty;
-    private readonly buildTransformation;
-    private HEAD_BRANCH;
-    private HEAD_OPERATION;
-    private tree;
-    /**
-     * The selective history is a data structure used to register changes/updates of a state.
-     * Each change/update is called an "operation".
-     * The data structure allows to easily cancel (and redo) any operation individually.
-     * An operation can be represented by any data structure. It can be a "command", a "diff", etc.
-     * However it must have the following properties:
-     * - it can be applied to modify the state
-     * - it can be reverted on the state such that it was never executed.
-     * - it can be transformed given other operation (Operational Transformation)
-     *
-     * Since this data structure doesn't know anything about the state nor the structure of
-     * operations, the actual work must be performed by external functions given as parameters.
-     * @param initialOperationId
-     * @param applyOperation a function which can apply an operation to the state
-     * @param revertOperation  a function which can revert an operation from the state
-     * @param buildEmpty  a function returning an "empty" operation.
-     *                    i.e an operation that leaves the state unmodified once applied or reverted
-     *                    (used for internal implementation)
-     * @param buildTransformation Factory used to build transformations
-     */
-    constructor(initialOperationId: UID, applyOperation: (data: T) => void, revertOperation: (data: T) => void, buildEmpty: (id: UID) => T, buildTransformation: TransformationFactory<T>);
-    /**
-     * Return the operation identified by its id.
-     */
-    get(operationId: UID): T;
-    /**
-     * Append a new operation as the last one
-     */
-    append(operationId: UID, data: T): void;
-    /**
-     * Insert a new operation after a specific operation (may not be the last operation).
-     * Following operations will be transformed according
-     * to the new operation.
-     */
-    insert(operationId: UID, data: T, insertAfter: UID): void;
-    /**
-     * @param operationId operation to undo
-     * @param undoId the id of the "undo operation"
-     * @param insertAfter the id of the operation after which to insert the undo
-     */
-    undo(operationId: UID, undoId: UID, insertAfter: UID): void;
-    /**
-     * @param operationId operation to redo
-     * @param redoId the if of the "redo operation"
-     * @param insertAfter the id of the operation after which to insert the redo
-     */
-    redo(operationId: UID, redoId: UID, insertAfter: UID): void;
-    drop(operationId: UID): void;
-    /**
-     * Revert the state as it was *before* the given operation was executed.
-     */
-    private revertBefore;
-    /**
-     * Revert the state as it was *after* the given operation was executed.
-     */
-    private revertTo;
-    /**
-     * Revert an execution
-     */
-    private revert;
-    /**
-     * Replay the operations between the current HEAD_BRANCH and the end of the tree
-     */
-    private fastForward;
-}
-
-declare class Revision implements RevisionData {
-    readonly id: UID;
-    readonly clientId: ClientId;
-    private _commands;
-    private _changes;
-    /**
-     * A revision represents a whole client action (Create a sheet, merge a Zone, Undo, ...).
-     * A revision contains the following information:
-     *  - id: ID of the revision
-     *  - commands: CoreCommands that are linked to the action, and should be
-     *              dispatched in other clients
-     *  - clientId: Client who initiated the action
-     *  - changes: List of changes applied on the state.
-     */
-    constructor(id: UID, clientId: ClientId, commands: readonly CoreCommand[], changes?: readonly HistoryChange[]);
-    setChanges(changes: readonly HistoryChange[]): void;
-    get commands(): readonly CoreCommand[];
-    get changes(): readonly HistoryChange[];
-}
-
-declare class Session extends EventBus<CollaborativeEvent> {
-    private revisions;
-    private transportService;
-    private serverRevisionId;
-    /**
-     * Positions of the others client.
-     */
-    private clients;
-    private clientId;
-    /**
-     * Id of the server revision
-     */
-    private debouncedMove;
-    private pendingMessages;
-    private waitingAck;
-    /**
-     * Flag used to block all commands when an undo or redo is triggered, until
-     * it is accepted on the server
-     */
-    private waitingUndoRedoAck;
-    private isReplayingInitialRevisions;
-    private processedRevisions;
-    private uuidGenerator;
-    /**
-     * Manages the collaboration between multiple users on the same spreadsheet.
-     * It can forward local state changes to other users to ensure they all eventually
-     * reach the same state.
-     * It also manages the positions of each clients in the spreadsheet to provide
-     * a visual indication of what other users are doing in the spreadsheet.
-     *
-     * @param revisions
-     * @param transportService communication channel used to send and receive messages
-     * between all connected clients
-     * @param client the client connected locally
-     * @param serverRevisionId
-     */
-    constructor(revisions: SelectiveHistory<Revision>, transportService: TransportService<CollaborationMessage>, serverRevisionId?: UID);
-    canApplyOptimisticUpdate(): boolean;
-    /**
-     * Add a new revision to the collaborative session.
-     * It will be transmitted to all other connected clients.
-     */
-    save(commands: CoreCommand[], changes: HistoryChange[]): void;
-    undo(revisionId: UID): void;
-    redo(revisionId: UID): void;
-    /**
-     * Notify that the position of the client has changed
-     */
-    move(position: ClientPosition): void;
-    join(client?: Client): void;
-    loadInitialMessages(messages: StateUpdateMessage[]): void;
-    /**
-     * Notify the server that the user client left the collaborative session
-     */
-    leave(): void;
-    /**
-     * Send a snapshot of the spreadsheet to the collaboration server
-     */
-    snapshot(data: WorkbookData): void;
-    getClient(): Client;
-    getConnectedClients(): Set<Client>;
-    getRevisionId(): UID;
-    isFullySynchronized(): boolean;
-    private _move;
-    /**
-     * Handles messages received from other clients in the collaborative
-     * session.
-     */
-    private onMessageReceived;
-    private onClientMoved;
-    /**
-     * Register the new client and send your
-     * own position back.
-     */
-    private onClientJoined;
-    private onClientLeft;
-    private sendUpdateMessage;
-    /**
-     * Send the next pending message
-     */
-    private sendPendingMessage;
-    private acknowledge;
-    private isAlreadyProcessed;
-    private dropPendingHistoryMessages;
-}
-
-/**
- * Local History
- *
- * The local history is responsible of tracking the locally state updates
- * It maintains the local undo and redo stack to allow to undo/redo only local
- * changes
- */
-declare class LocalHistory extends EventBus$1 implements CommandHandler<Command> {
-    protected dispatch: CommandDispatcher["dispatch"];
-    private session;
-    /**
-     * Ids of the revisions which can be undone
-     */
-    private undoStack;
-    /**
-     * Ids of the revisions which can be redone
-     */
-    private redoStack;
-    constructor(dispatch: CommandDispatcher["dispatch"], session: Session);
-    allowDispatch(cmd: Command): CommandResult;
-    beforeHandle(cmd: Command): void;
-    handle(cmd: Command): void;
-    finalize(): void;
-    private requestHistoryChange;
-    canUndo(): boolean;
-    canRedo(): boolean;
-    private drop;
-    private onNewLocalStateUpdate;
-    private selectiveUndo;
-    private selectiveRedo;
-}
-
 declare class RangeAdapter implements CommandHandler<CoreCommand> {
     private getters;
     private providers;
@@ -4220,7 +4195,12 @@ declare class HeaderVisibilityUIPlugin extends UIPlugin {
     isColHidden(sheetId: UID, index: number): boolean;
     isHeaderHidden(sheetId: UID, dimension: Dimension, index: number): boolean;
     getNextVisibleCellPosition({ sheetId, col, row }: CellPosition): CellPosition;
-    findVisibleHeader(sheetId: UID, dimension: Dimension, indexes: number[]): number | undefined;
+    /**
+     * Find the first visible header in the range [`from` => `to`].
+     *
+     * Both `from` and `to` are inclusive.
+     */
+    findVisibleHeader(sheetId: UID, dimension: Dimension, from: number, to: number): number | undefined;
     findLastVisibleColRowIndex(sheetId: UID, dimension: Dimension, { last, first }: {
         first: HeaderIndex;
         last: HeaderIndex;
@@ -4240,6 +4220,42 @@ declare class HighlightPlugin extends UIPlugin {
     drawGrid(renderingContext: GridRenderingContext): void;
 }
 
+/**
+ * Local History
+ *
+ * The local history is responsible of tracking the locally state updates
+ * It maintains the local undo and redo stack to allow to undo/redo only local
+ * changes
+ */
+declare class HistoryPlugin extends UIPlugin {
+    static getters: readonly ["canUndo", "canRedo"];
+    /**
+     * Ids of the revisions which can be undone
+     */
+    private undoStack;
+    /**
+     * Ids of the revisions which can be redone
+     */
+    private redoStack;
+    private session;
+    constructor(config: UIPluginConfig);
+    allowDispatch(cmd: Command): CommandResult;
+    handle(cmd: Command): void;
+    finalize(): void;
+    private requestHistoryChange;
+    canUndo(): boolean;
+    canRedo(): boolean;
+    private drop;
+    private onNewLocalStateUpdate;
+    /**
+     * Fetch the last revision which is not empty and not a repeated command
+     *
+     * Ignore repeated commands (REQUEST_REDO command as root command)
+     * Ignore standard undo/redo revisions (that are empty)
+     */
+    private getPossibleRevisionToRepeat;
+}
+
 declare class RendererPlugin extends UIPlugin {
     static layers: LAYERS[];
     static getters: readonly ["getColDimensionsInViewport", "getRowDimensionsInViewport"];
@@ -4523,6 +4539,7 @@ declare class ClipboardPlugin extends UIPlugin {
     static getters: readonly ["getClipboardContent", "getClipboardTextContent", "isCutOperation", "isPaintingFormat"];
     private status;
     private state?;
+    private lastPasteState?;
     private _isPaintingFormat;
     allowDispatch(cmd: LocalCommand): CommandResult;
     handle(cmd: Command): void;
@@ -4663,10 +4680,7 @@ declare type ImageGetters = Pick<ImagePlugin, GetterNames<typeof ImagePlugin>>;
 declare type FigureGetters = Pick<FigurePlugin, GetterNames<typeof FigurePlugin>>;
 declare type RangeAdapterGetters = Pick<RangeAdapter, GetterNames<typeof RangeAdapter>>;
 declare type ConditionalFormatGetters = Pick<ConditionalFormatPlugin, GetterNames<typeof ConditionalFormatPlugin>>;
-declare type LocalHistoryGetters = {
-    canUndo: LocalHistory["canUndo"];
-    canRedo: LocalHistory["canRedo"];
-};
+declare type LocalHistoryGetters = Pick<HistoryPlugin, GetterNames<typeof HistoryPlugin>>;
 declare type FiltersGetters = Pick<FiltersPlugin, GetterNames<typeof FiltersPlugin>>;
 declare type CoreGetters = SheetGetters & HeaderSizeGetters & HeaderVisibilityGetters & CellGetters & MergeGetters & BordersGetters & ChartGetters & ImageGetters & ConditionalFormatGetters & FigureGetters & RangeAdapterGetters & FiltersGetters;
 declare type AutofillGetters = Pick<AutofillPlugin, GetterNames<typeof AutofillPlugin>>;
@@ -5702,6 +5716,7 @@ declare class FilterIconsOverlay extends Component<Props$k, SpreadsheetChildEnv>
     };
     getVisibleFilterHeaders(): Position$1[];
     getFilterHeaderPosition(position: Position$1): DOMCoordinates;
+    private getIconVerticalPosition;
     isFilterActive(position: Position$1): boolean;
     toggleFilterMenu(position: Position$1): void;
     private isPositionVisible;
@@ -6918,6 +6933,8 @@ declare function createEmptySheet(sheetId: UID, name: string): SheetData;
 declare function createEmptyWorkbookData(sheetName?: string): WorkbookData;
 declare function createEmptyExcelSheet(sheetId: UID, name: string): ExcelSheetData;
 
+declare function genericRepeat<T extends Command>(getters: Getters, command: T): T;
+
 /**
  * We export here all entities that needs to be accessed publicly by Odoo.
  *
@@ -6989,6 +7006,8 @@ declare const registries: {
     urlRegistry: Registry<LinkSpec>;
     cellPopoverRegistry: Registry<PopoverBuilders>;
     numberFormatMenuRegistry: MenuItemRegistry;
+    repeatLocalCommandTransformRegistry: Registry<(getters: Getters, cmd: LocalCommand, childCommands: readonly CoreCommand[]) => LocalCommand | CoreCommand[] | undefined>;
+    repeatCommandTransformRegistry: Registry<(getters: Getters, cmd: CoreCommand) => CoreCommand | undefined>;
 };
 declare const helpers: {
     arg: typeof arg;
@@ -7017,6 +7036,7 @@ declare const helpers: {
     positionToZone: typeof positionToZone;
     isDefined: typeof isDefined;
     lazy: typeof lazy;
+    genericRepeat: typeof genericRepeat;
 };
 declare const links: {
     isMarkdownLink: typeof isMarkdownLink;