@univerjs/sheets-ui 0.5.4 → 0.5.5-nightly.202501201336

package/lib/types/facade/f-range.d.ts

@@ -57,6 +57,7 @@ interface IFRangeSheetsUIMixin {
     ```
         let sheet = univerAPI.getActiveWorkbook().getActiveSheet();
         let range = sheet.getRange(2, 2, 3, 3);
+        univerAPI.getActiveWorkbook().setActiveRange(range);
         let disposable = range.attachPopup({
         componentKey: 'univer.sheet.cell-alert',
         extraProps: { alert: { type: 0, title: 'This is an Info', message: 'This is an info message' } },
@@ -76,6 +77,22 @@ interface IFRangeSheetsUIMixin {
      * ```
      */
     attachAlertPopup(alert: Omit<ICellAlert, 'location'>): IDisposable;
+    /**
+     * Attach a DOM popup to the start cell of current range.
+     * @param alert The alert to attach
+     * @returns The disposable object to detach the alert.
+     * @example
+     * ```ts
+        let sheet = univerAPI.getActiveWorkbook().getActiveSheet();
+        let range = sheet.getRange(2, 2, 3, 3);
+        univerAPI.getActiveWorkbook().setActiveRange(range);
+        let disposable = range.attachRangePopup({
+        componentKey: 'univer.sheet.single-dom-popup',
+        extraProps: { alert: { type: 0, title: 'This is an Info', message: 'This is an info message' } },
+        });
+     * ```
+     */
+    attachRangePopup(popup: IFCanvasPopup): Nullable<IDisposable>;
     /**
      *  Highlight the range with the specified style and primary cell.
      * @param style - style for highlight range.
@@ -97,6 +114,7 @@ declare module '@univerjs/sheets/facade' {
  * Transform component key
  * @param {IFComponentKey} component - The component key to transform.
  * @param {ComponentManager} componentManager - The component manager to use for registration.
+ * @returns {string} The transformed component key.
  */
 export declare function transformComponentKey(component: IFComponentKey, componentManager: ComponentManager): {
     key: string;

package/lib/types/facade/f-univer.d.ts

@@ -7,7 +7,7 @@ export interface IFUniverSheetsUIMixin {
      * @param {IColumnsHeaderCfgParam} cfg The configuration of the column header.
      * @example
      * ```typescript
-     * univerAPI.customizeColumnHeader({ headerStyle: { backgroundColor: 'pink', fontSize: 9 }, columnsCfg: ['MokaII', undefined, null, { text: 'Size', textAlign: 'left' }] });
+     * univerAPI.customizeColumnHeader({ headerStyle: { fontColor: '#fff', size: 40, backgroundColor: '#4e69ee', fontSize: 9 }, columnsCfg: ['MokaII', undefined, null, { text: 'Size', textAlign: 'left' }] });
      * ```
      */
     customizeColumnHeader(cfg: IColumnsHeaderCfgParam): void;
@@ -48,6 +48,7 @@ export interface IFUniverSheetsUIMixin {
 }
 export declare class FUniverSheetsUIMixin extends FUniver implements IFUniverSheetsUIMixin {
     private _initSheetUIEvent;
+    _initObserverListener(injector: Injector): void;
     _initialize(injector: Injector): void;
     private _generateClipboardCopyParam;
     private _beforeClipboardChange;

package/lib/types/facade/f-workbook.d.ts

@@ -1,9 +1,9 @@
 import { IDisposable, Nullable } from '@univerjs/core';
 import { IMouseEvent, IPointerEvent } from '@univerjs/engine-render';
 import { ICellPosWithEvent, IDragCellPosition, IHoverRichTextInfo, IHoverRichTextPosition, IScrollState } from '@univerjs/sheets-ui';
+import { ICellEventParam } from './f-event';
 import { FWorkbook } from '@univerjs/sheets/facade';
 import { IDialogPartMethodOptions, ISidebarMethodOptions } from '@univerjs/ui';
-import { ICellEventParam, IFSheetsUIEventParamConfig } from './f-event';
 export interface IFWorkbookSheetsUIMixin {
     /**
      * Open a sidebar.
@@ -20,33 +20,32 @@ export interface IFWorkbookSheetsUIMixin {
      */
     openDialog(dialog: IDialogPartMethodOptions): IDisposable;
     /**
-     * Subscribe to cell click events
-     * @param callback - The callback function to be called when a cell is clicked
-     * @returns A disposable object that can be used to unsubscribe from the event
+     * @deprecated use `univerAPI.addEvent(univerAPI.Event.CellClick, () => {})` instead
      */
     onCellClick(callback: (cell: IHoverRichTextInfo) => void): IDisposable;
     /**
-     * Subscribe cell hover events
-     * @param callback - The callback function to be called when a cell is hovered
-     * @returns A disposable object that can be used to unsubscribe from the event
+     * @deprecated use `univerAPI.addEvent(univerAPI.Event.CellHover, () => {})` instead
      */
     onCellHover(callback: (cell: IHoverRichTextPosition) => void): IDisposable;
     /**
-     * Subscribe to pointer move events on workbook. Just like onCellHover, but with event information.
-     * @param {function(ICellPosWithEvent): any} callback The callback function accept cell location and event.
+     * @deprecated use `univerAPI.addEvent(univerAPI.Event.CellPointerMove, () => {})` instead
      */
     onCellPointerMove(callback: (cell: ICellPosWithEvent, event: IPointerEvent | IMouseEvent) => void): IDisposable;
     /**
-     * Subscribe to cell pointer down events.
-     * @param {function(ICellPosWithEvent): any} callback The callback function accept cell location and event.
+     * @deprecated use `univerAPI.addEvent(univerAPI.Event.CellPointerDown, () => {})` instead
      */
     onCellPointerDown(callback: (cell: ICellPosWithEvent) => void): IDisposable;
     /**
-     * Subscribe to cell pointer up events.
-     * @param {function(ICellPosWithEvent): any} callback The callback function accept cell location and event.
+     * @deprecated use `univerAPI.addEvent(univerAPI.Event.CellPointerUp, () => {})` instead
      */
     onCellPointerUp(callback: (cell: ICellPosWithEvent) => void): IDisposable;
+    /**
+     * @deprecated use `univerAPI.addEvent(univerAPI.Event.DragOver, () => {})` instead
+     */
     onDragOver(callback: (cell: IDragCellPosition) => void): IDisposable;
+    /**
+     * @deprecated use `univerAPI.addEvent(univerAPI.Event.Drop, () => {})` instead
+     */
     onDrop(callback: (cell: IDragCellPosition) => void): IDisposable;
     /**
      * Start the editing process
@@ -58,22 +57,18 @@ export interface IFWorkbookSheetsUIMixin {
      */
     startEditing(): boolean;
     /**
-     * Use endEditingAsync as instead
-     * @deprecated
-     * End the editing process
-     * @async
-     * @param save - Whether to save the changes
-     * @returns A promise that resolves to a boolean value
-     * @example
-     * ``` ts
-     * univerAPI.getActiveWorkbook().endEditing(true);
-     * ```
+     * @deprecated Use `endEditingAsync` as instead
      */
     endEditing(save?: boolean): Promise<boolean>;
     /**
      * @async
+     * End the editing process
      * @param {boolean} save - Whether to save the changes, default is true
      * @returns {Promise<boolean>} A promise that resolves to a boolean value
+     * @example
+     * ```ts
+     * await univerAPI.getActiveWorkbook().endEditingAsync(false);
+     * ```
      */
     endEditingAsync(save?: boolean): Promise<boolean>;
     getScrollStateBySheetId(sheetId: string): Nullable<IScrollState>;
@@ -115,7 +110,6 @@ export declare class FWorkbookSheetsUIMixin extends FWorkbook implements IFWorkb
     openSiderbar(params: ISidebarMethodOptions): IDisposable;
     openDialog(dialog: IDialogPartMethodOptions): IDisposable;
     private _logDeprecation;
-    addUIEvent(event: keyof IFSheetsUIEventParamConfig, _callback: (params: IFSheetsUIEventParamConfig[typeof event]) => void): IDisposable;
     generateCellParams(cell: IHoverRichTextPosition | ICellPosWithEvent): ICellEventParam;
     onCellClick(callback: (cell: IHoverRichTextInfo) => void): IDisposable;
     onCellHover(callback: (cell: IHoverRichTextPosition) => void): IDisposable;

package/lib/types/facade/f-worksheet.d.ts

@@ -1,4 +1,5 @@
 import { IDisposable, IRange, Nullable } from '@univerjs/core';
+import { SpreadsheetSkeleton } from '@univerjs/engine-render';
 import { IScrollState, IViewportScrollState } from '@univerjs/sheets-ui';
 import { FWorksheet } from '@univerjs/sheets/facade';
 export interface IFWorksheetSkeletonMixin {
@@ -65,14 +66,32 @@ export interface IFWorksheetSkeletonMixin {
      */
     getScrollState(): IScrollState;
     /**
-     * Invoked when scrolling the sheet.
-     * @param {function(Nullable<IViewportScrollState>): void} callback The scrolling callback function.
-     * @returns {IDisposable} The disposable object to remove the event listener.
+     * Get the skeleton service of the worksheet.
+     * @returns {Nullable<SpreadsheetSkeleton>} The skeleton of the worksheet.
      * @example
-     * ``` ts
-     * univerAPI.getActiveWorkbook().getActiveSheet().onScroll((params) => {...})
+     * ```ts
+     * const fWorkbook = univerAPI.getActiveWorkbook();
+     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const skeleton = fWorksheet.getSkeleton();
+     * console.log(skeleton);
      * ```
      */
+    getSkeleton(): Nullable<SpreadsheetSkeleton>;
+    /**
+     * Set the given column width to fix-content.
+     * @param {number} columnPosition - Column position
+     * @param {number} numColumn - Number of columns
+     * @example
+     * ```ts
+     * const fWorkbook = univerAPI.getActiveWorkbook();
+     * const fWorksheet = fWorkbook.getActiveSheet();
+     * fWorksheet.setColumnAutoWidth(0, 3);
+     * ```
+     */
+    setColumnAutoWidth(columnPosition: number, numColumn: number): FWorksheet;
+    /**
+     * @deprecated use `univerAPI.addEvent(univerAPI.Event.Scroll, () => {})` instead
+     */
     onScroll(callback: (params: Nullable<IViewportScrollState>) => void): IDisposable;
 }
 export declare class FWorksheetSkeletonMixin extends FWorksheet implements IFWorksheetSkeletonMixin {
@@ -83,6 +102,8 @@ export declare class FWorksheetSkeletonMixin extends FWorksheet implements IFWor
     scrollToCell(row: number, column: number): FWorksheet;
     getScrollState(): IScrollState;
     onScroll(callback: (params: Nullable<IViewportScrollState>) => void): IDisposable;
+    getSkeleton(): Nullable<SpreadsheetSkeleton>;
+    setColumnAutoWidth(columnPosition: number, numColumn: number): FWorksheet;
 }
 declare module '@univerjs/sheets/facade' {
     interface FWorksheet extends IFWorksheetSkeletonMixin {

package/lib/types/index.d.ts

@@ -92,6 +92,7 @@ export { FormatPainterStatus, IFormatPainterService } from './services/format-pa
 export type { IFormatPainterBeforeApplyHookParams, IFormatPainterHook } from './services/format-painter/format-painter.service';
 export { SELECTION_SHAPE_DEPTH } from './services/selection/const';
 export { type IBaseSheetBarProps } from './views/sheet-bar/sheet-bar-tabs/SheetBarItem';
+export { SetWorksheetColAutoWidthCommand } from './commands/commands/set-worksheet-auto-col-width.command';
 export { AutoClearContentCommand, AutoFillCommand } from './commands/commands/auto-fill.command';
 export { type ISheetPasteByShortKeyParams, type ISheetPasteParams, SheetCopyCommand, SheetCutCommand, SheetPasteBesidesBorderCommand, SheetPasteColWidthCommand, SheetPasteCommand, SheetPasteFormatCommand, SheetPasteShortKeyCommand, SheetPasteValueCommand, } from './commands/commands/clipboard.command';
 export { DeleteRangeMoveLeftConfirmCommand } from './commands/commands/delete-range-move-left-confirm.command';
@@ -108,7 +109,7 @@ export { ApplyFormatPainterCommand, SetInfiniteFormatPainterCommand, SetOnceForm
 export { SetColumnFrozenCommand, SetRowFrozenCommand, SetSelectionFrozenCommand } from './commands/commands/set-frozen.command';
 export { type IScrollCommandParams, type IScrollToCellCommandParams, type ISetScrollRelativeCommandParams, ResetScrollCommand, ScrollCommand, ScrollToCellCommand, SetScrollRelativeCommand, } from './commands/commands/set-scroll.command';
 export { ExpandSelectionCommand, JumpOver, MoveSelectionCommand, MoveSelectionEnterAndTabCommand, SelectAllCommand } from './commands/commands/set-selection.command';
-export { ChangeZoomRatioCommand, SetZoomRatioCommand } from './commands/commands/set-zoom-ratio.command';
+export { ChangeZoomRatioCommand, type ISetZoomRatioCommandParams, SetZoomRatioCommand } from './commands/commands/set-zoom-ratio.command';
 export { ShowMenuListCommand } from './commands/commands/unhide.command';
 export { ChangeSheetProtectionFromSheetBarCommand, DeleteWorksheetProtectionFormSheetBarCommand, } from './commands/commands/worksheet-protection.command';
 export { SetActivateCellEditOperation } from './commands/operations/activate-cell-edit.operation';

package/lib/types/services/auto-fill/tools.d.ts

@@ -106,3 +106,8 @@ export declare function getAutoFillRepeatRange(sourceRange: IRange, targetRange:
  * @returns
  */
 export declare function needsUpdateCellValue(cell: ICellData): boolean;
+/**
+ * Remove cell.custom
+ * @param cell
+ */
+export declare function removeCellCustom(cell: Nullable<ICellData>): void;

package/lib/types/services/canvas-pop-manager.service.d.ts

@@ -1,10 +1,12 @@
-import { DrawingTypeEnum, ICommandInfo, INeedCheckDisposable, Nullable, Disposable, ICommandService, IUniverInstanceService } from '@univerjs/core';
+import { DrawingTypeEnum, ICommandInfo, INeedCheckDisposable, IRange, Nullable, Disposable, ICommandService, IUniverInstanceService } from '@univerjs/core';
 import { BaseObject, IBoundRectNoAngle, Viewport, IRenderManagerService } from '@univerjs/engine-render';
-import { ISheetLocationBase, RefRangeService } from '@univerjs/sheets';
+import { ISheetLocationBase, RefRangeService, SheetsSelectionsService } from '@univerjs/sheets';
 import { IPopup, ICanvasPopupService } from '@univerjs/ui';
+import { ISheetSelectionRenderService } from './selection/base-selection-render.service';
 export interface ICanvasPopup extends Omit<IPopup, 'anchorRect' | 'anchorRect$' | 'unitId' | 'subUnitId' | 'canvasElement'> {
     mask?: boolean;
     extraProps?: Record<string, unknown>;
+    showOnSelectionMoving?: boolean;
 }
 interface IPopupMenuItem {
     label: string;
@@ -20,8 +22,12 @@ export declare class SheetCanvasPopManagerService extends Disposable {
     private readonly _univerInstanceService;
     private readonly _refRangeService;
     private readonly _commandService;
+    private readonly _refSelectionsService;
+    private readonly _selectionManagerService;
     private _popupMenuFeatureMap;
-    constructor(_globalPopupManagerService: ICanvasPopupService, _renderManagerService: IRenderManagerService, _univerInstanceService: IUniverInstanceService, _refRangeService: RefRangeService, _commandService: ICommandService);
+    constructor(_globalPopupManagerService: ICanvasPopupService, _renderManagerService: IRenderManagerService, _univerInstanceService: IUniverInstanceService, _refRangeService: RefRangeService, _commandService: ICommandService, _refSelectionsService: ISheetSelectionRenderService, _selectionManagerService: SheetsSelectionsService);
+    private _isSelectionMoving;
+    private _initMoving;
     /**
      * Register a feature menu callback for a specific drawing type.such as image, chart, etc.
      */
@@ -49,20 +55,49 @@ export declare class SheetCanvasPopManagerService extends Disposable {
     attachPopupToAbsolutePosition(bound: IBoundRectNoAngle, popup: ICanvasPopup, _unitId?: string, _subUnitId?: string): {
         dispose: () => void;
         canDispose: () => boolean;
-    } | null;
+    } | null | undefined;
     /**
-     *
+     * Bind popup to the right part of cell at(row, col).
+     * This popup would move with the cell.
      * @param row
      * @param col
      * @param popup
      * @param _unitId
      * @param _subUnitId
      * @param viewport
+     * @returns
+     */
+    attachPopupToCell(row: number, col: number, popup: ICanvasPopup, _unitId?: string, _subUnitId?: string, viewport?: Viewport): Nullable<INeedCheckDisposable>;
+    /**
+     * attach Comp to floatDOM
+     * @param range
+     * @param popup
+     * @param _unitId
+     * @param _subUnitId
+     * @param viewport
      * @param showOnSelectionMoving
      * @returns
      */
-    attachPopupToCell(row: number, col: number, popup: ICanvasPopup, _unitId?: string, _subUnitId?: string, viewport?: Viewport, showOnSelectionMoving?: boolean): Nullable<INeedCheckDisposable>;
+    attachRangePopup(range: IRange, popup: ICanvasPopup, _unitId?: string, _subUnitId?: string, viewport?: Viewport, showOnSelectionMoving?: boolean): Nullable<INeedCheckDisposable>;
+    /**
+     *
+     * @param initialRow
+     * @param initialCol
+     * @param currentRender
+     * @param skeleton
+     * @param activeViewport
+     * @returns
+     */
     private _createCellPositionObserver;
     private _calcCellPositionByCell;
+    /**
+     * Unlike _createCellPositionObserver, this accept a range not a single cell.
+     * @param initialRow
+     * @param initialCol
+     * @param currentRender
+     * @param skeleton
+     * @param activeViewport
+     */
+    private _createRangePositionObserver;
 }
 export {};

package/lib/types/services/clipboard/type.d.ts

@@ -56,20 +56,36 @@ export interface ISpecialPasteInfo {
 /**
  * `ClipboardHook` could:
  * 1. Before copy/cut/paste, decide whether to execute the command and prepare caches if necessary.
- * 1. When copying, decide what content could be written into clipboard.
- * 1. When pasting, get access to the clipboard content and append mutations to the paste command.
+ * 2. When copying, decide what content could be written into clipboard.
+ * 3. When pasting, get access to the clipboard content and append mutations to the paste command.
  */
 export interface ISheetClipboardHook {
+    /**
+     * The unique id of the hook.
+     */
     id: string;
+    /**
+     * Whether this hook is the default hook.
+     */
     isDefaultHook?: boolean;
+    /**
+     * Only special paste info should be provided, which will replace the default hook.
+     */
     specialPasteInfo?: ISpecialPasteInfo;
+    /**
+     * The priority of the hook. The higher the priority, the earlier the hook would be called.
+     */
     priority?: number;
     /**
      * The callback would be called after the clipboard service has decided what region need to be copied.
      * Features could use this hook to build copying cache or any other pre-copy jobs.
+     * @param unitId
+     * @param subUnitId
+     * @param range
      */
     onBeforeCopy?(unitId: string, subUnitId: string, range: IRange): void;
     /**
+     * Properties that would be appended to the td element.
      *
      * @param row
      * @param col
@@ -82,16 +98,21 @@ export interface ISheetClipboardHook {
      * @deprecated should be merged with `onCopyCellContent` to `onCopyCell`
      * @param row row of the the copied cell
      * @param col col of the the copied cell
+     * @param rowSpan row span of the the copied cell
+     * @param colSpan col span of the the copied cell
+     * @return content
      */
     onCopyCellStyle?(row: number, col: number, rowSpan?: number, colSpan?: number): IClipboardPropertyItem | null;
     /**
      * Properties that would be appended to the tr element.
      * @param row each row of the the copied range
+     * @return content
      */
     onCopyRow?(row: number): IClipboardPropertyItem | null;
     /**
      * Properties that would be appended to the col element.
      * @param col each col of the copied range
+     * @return content
      */
     onCopyColumn?(col: number): IClipboardPropertyItem | null;
     /**
@@ -103,30 +124,65 @@ export interface ISheetClipboardHook {
      * The callback would be called after the clipboard service has decided what region need to be pasted.
      * Features could use this hook to build copying cache or any other pre-copy jobs.
      *
+     * @param pasteTo
      * @returns if it block copying it should return false
      */
     onBeforePaste?(pasteTo: ISheetDiscreteRangeLocation): boolean;
     /**
+     * Handles pasting cells, it needs to return Undo Mutations & Redo Mutations that handle the cell contents
      *
-     * @param row
-     * @param col
+     * @param pasteFrom
+     * @param pasteTo
+     * @param data
+     * @param payload
+     * @returns undo and redo mutations
      */
     onPasteCells?(pasteFrom: ISheetDiscreteRangeLocation | null, pasteTo: ISheetDiscreteRangeLocation, data: ObjectMatrix<ICellDataWithSpanInfo>, payload: ICopyPastePayload): {
         undos: IMutationInfo[];
         redos: IMutationInfo[];
     };
+    /**
+     * Handle the pasted row properties, it needs to return the Undo Mutations & Redo Mutations that handle the row properties
+     *
+     * @param pasteTo
+     * @param rowProperties
+     * @param payload
+     * @returns undo and redo mutations
+     */
     onPasteRows?(pasteTo: ISheetDiscreteRangeLocation, rowProperties: IClipboardPropertyItem[], payload: ICopyPastePayload): {
         undos: IMutationInfo[];
         redos: IMutationInfo[];
     };
+    /**
+     * Handle the pasted column properties, it needs to return the Undo Mutations & Redo Mutations that handle the column properties
+     *
+     * @param pasteTo
+     * @param colProperties
+     * @param payload
+     * @returns undo and redo mutations
+     */
     onPasteColumns?(pasteTo: ISheetDiscreteRangeLocation, colProperties: IClipboardPropertyItem[], payload: ICopyPastePayload): {
         undos: IMutationInfo[];
         redos: IMutationInfo[];
     };
+    /**
+     * Hanle the pasted plain text, it needs to return the Undo Mutations & Redo Mutations that handle the plain text
+     *
+     * @param pasteTo
+     * @param text
+     * @param payload
+     * @returns undo and redo mutations
+     */
     onPastePlainText?(pasteTo: ISheetDiscreteRangeLocation, text: string, payload: ICopyPastePayload): {
         undos: IMutationInfo[];
         redos: IMutationInfo[];
     };
+    /**
+     * Would be called after paste content has been written into Univer.
+     * Features could do some cleaning up jobs here.
+     *
+     * @param success whether the paste operation is successful
+     */
     onAfterPaste?(success: boolean): void;
     /**
      * The callback would be called before the clipboard service decides what region need to be copied from or pasted to.

package/lib/types/services/editor/cell-editor-resize.service.d.ts

@@ -1,4 +1,4 @@
-import { Workbook, Disposable } from '@univerjs/core';
+import { Workbook, Disposable, IUniverInstanceService } from '@univerjs/core';
 import { IRenderContext, IRenderModule, IRenderManagerService } from '@univerjs/engine-render';
 import { ILayoutService } from '@univerjs/ui';
 import { IEditorBridgeService } from '../editor-bridge.service';
@@ -11,7 +11,8 @@ export declare class SheetCellEditorResizeService extends Disposable implements
     private readonly _editorBridgeService;
     private readonly _renderManagerService;
     private readonly _sheetSkeletonManagerService;
-    constructor(_context: IRenderContext<Workbook>, _layoutService: ILayoutService, _cellEditorManagerService: ICellEditorManagerService, _editorBridgeService: IEditorBridgeService, _renderManagerService: IRenderManagerService, _sheetSkeletonManagerService: SheetSkeletonManagerService);
+    private readonly _univerInstanceService;
+    constructor(_context: IRenderContext<Workbook>, _layoutService: ILayoutService, _cellEditorManagerService: ICellEditorManagerService, _editorBridgeService: IEditorBridgeService, _renderManagerService: IRenderManagerService, _sheetSkeletonManagerService: SheetSkeletonManagerService, _univerInstanceService: IUniverInstanceService);
     fitTextSize(callback?: () => void): void;
     /**
      * Mainly used to pre-calculate the width of the editor,

package/lib/types/services/editor-bridge.service.d.ts

@@ -42,6 +42,7 @@ export interface IEditorBridgeService {
     currentEditCellLayout$: Observable<Nullable<ICellEditorLayout>>;
     currentEditCell$: Observable<Nullable<IEditorBridgeServiceParam>>;
     visible$: Observable<IEditorBridgeServiceVisibleParam>;
+    forceKeepVisible$: Observable<boolean>;
     dispose(): void;
     refreshEditCellState(): void;
     refreshEditCellPosition(resetSizeOnly?: boolean): void;
@@ -68,7 +69,6 @@ export declare class EditorBridgeService extends Disposable implements IEditorBr
     private readonly _refSelectionsService;
     private readonly _contextService;
     private _editorUnitId;
-    private _isForceKeepVisible;
     private _editorIsDirty;
     private _isDisabled;
     private _visible;
@@ -99,6 +99,8 @@ export declare class EditorBridgeService extends Disposable implements IEditorBr
     readonly visible$: Observable<IEditorBridgeServiceVisibleParam>;
     private readonly _afterVisible$;
     readonly afterVisible$: Observable<IEditorBridgeServiceVisibleParam>;
+    private readonly _forceKeepVisible$;
+    readonly forceKeepVisible$: Observable<boolean>;
     constructor(_sheetInterceptorService: SheetInterceptorService, _renderManagerService: IRenderManagerService, _themeService: ThemeService, _univerInstanceService: IUniverInstanceService, _editorService: IEditorService, _refSelectionsService: SheetsSelectionsService, _contextService: IContextService);
     refreshEditCellState(): void;
     refreshEditCellPosition(resetSizeOnly?: boolean): void;

package/lib/types/services/hover-manager.service.d.ts

@@ -45,6 +45,11 @@ export interface IHoverRichTextPosition extends ISheetLocationBase {
     drawing?: Nullable<string>;
     event?: IMouseEvent | IPointerEvent;
 }
+export interface IHoverHeaderPosition {
+    unitId: string;
+    subUnitId: string;
+    index: number;
+}
 export declare function getLocationBase(location: ISheetLocation): {
     unitId: string;
     subUnitId: string;
@@ -57,9 +62,20 @@ export declare class HoverManagerService extends Disposable {
     private _currentCell$;
     private _currentRichText$;
     private _currentClickedCell$;
+    private _currentDbClickedCell$;
     private _currentCellWithEvent$;
     private _currentPointerDownCell$;
     private _currentPointerUpCell$;
+    private _currentHoveredRowHeader$;
+    private _currentHoveredColHeader$;
+    private _currentRowHeaderClick$;
+    private _currentColHeaderClick$;
+    private _currentRowHeaderDbClick$;
+    private _currentColHeaderDbClick$;
+    private _currentRowHeaderPointerDown$;
+    private _currentColHeaderPointerDown$;
+    private _currentRowHeaderPointerUp$;
+    private _currentColHeaderPointerUp$;
     currentCell$: import('rxjs').Observable<Nullable<IHoverCellPosition>>;
     currentRichText$: import('rxjs').Observable<void | IHoverRichTextPosition | null | undefined>;
     /**
@@ -68,12 +84,26 @@ export declare class HoverManagerService extends Disposable {
     currentCellPosWithEvent$: import('rxjs').Observable<void | ICellPosWithEvent | null | undefined>;
     currentPosition$: import('rxjs').Observable<Nullable<IHoverCellPosition>>;
     currentClickedCell$: import('rxjs').Observable<IHoverRichTextInfo>;
+    currentDbClickedCell$: import('rxjs').Observable<IHoverRichTextInfo>;
     currentPointerDownCell$: import('rxjs').Observable<ICellPosWithEvent>;
     currentPointerUpCell$: import('rxjs').Observable<ICellPosWithEvent>;
+    currentHoveredRowHeader$: import('rxjs').Observable<Nullable<IHoverHeaderPosition>>;
+    currentHoveredColHeader$: import('rxjs').Observable<Nullable<IHoverHeaderPosition>>;
+    currentRowHeaderClick$: import('rxjs').Observable<IHoverHeaderPosition>;
+    currentColHeaderClick$: import('rxjs').Observable<IHoverHeaderPosition>;
+    currentRowHeaderDbClick$: import('rxjs').Observable<IHoverHeaderPosition>;
+    currentColHeaderDbClick$: import('rxjs').Observable<IHoverHeaderPosition>;
+    currentRowHeaderPointerDown$: import('rxjs').Observable<IHoverHeaderPosition>;
+    currentColHeaderPointerDown$: import('rxjs').Observable<IHoverHeaderPosition>;
+    currentRowHeaderPointerUp$: import('rxjs').Observable<IHoverHeaderPosition>;
+    currentColHeaderPointerUp$: import('rxjs').Observable<IHoverHeaderPosition>;
     constructor(_univerInstanceService: IUniverInstanceService, _renderManagerService: IRenderManagerService);
     dispose(): void;
     private _initCellDisposableListener;
+    private _getCalcDeps;
     private _calcActiveCell;
+    private _calcActiveRowHeader;
+    private _calcActiveColHeader;
     triggerPointerDown(unitId: string, event: IPointerEvent | IMouseEvent): void;
     triggerPointerUp(unitId: string, event: IPointerEvent | IMouseEvent): void;
     triggerMouseMove(unitId: string, event: IPointerEvent | IMouseEvent): void;
@@ -84,5 +114,16 @@ export declare class HoverManagerService extends Disposable {
      * @param offsetY
      */
     triggerClick(unitId: string, offsetX: number, offsetY: number): void;
+    triggerDbClick(unitId: string, offsetX: number, offsetY: number): void;
     triggerScroll(): void;
+    triggerRowHeaderClick(unitId: string, offsetX: number, offsetY: number): void;
+    triggerColHeaderClick(unitId: string, offsetX: number, offsetY: number): void;
+    triggerRowHeaderDbClick(unitId: string, offsetX: number, offsetY: number): void;
+    triggerColHeaderDbClick(unitId: string, offsetX: number, offsetY: number): void;
+    triggerRowHeaderMouseMove(unitId: string, offsetX: number, offsetY: number): void;
+    triggerColHeaderMouseMove(unitId: string, offsetX: number, offsetY: number): void;
+    triggerRowHeaderPoniterDown(unitId: string, offsetX: number, offsetY: number): void;
+    triggerColHeaderPoniterDown(unitId: string, offsetX: number, offsetY: number): void;
+    triggerRowHeaderPoniterUp(unitId: string, offsetX: number, offsetY: number): void;
+    triggerColHeaderPoniterUp(unitId: string, offsetX: number, offsetY: number): void;
 }

package/lib/types/services/selection/base-selection-render.service.d.ts

@@ -39,6 +39,7 @@ export interface ISheetSelectionRenderService {
     getCellWithCoordByOffset(x: number, y: number, skeleton?: SpreadsheetSkeleton): Nullable<ICellWithCoord>;
     setSingleSelectionEnabled(enabled: boolean): void;
     refreshSelectionMoveEnd(): void;
+    resetSelectionsByModelData(selectionsWithStyleList: readonly ISelectionWithStyle[]): void;
 }
 export declare const ISheetSelectionRenderService: import('@wendellhu/redi').IdentifierDecorator<ISheetSelectionRenderService>;
 /**
@@ -57,6 +58,7 @@ export declare class BaseSelectionRenderService extends Disposable implements IS
     readonly controlFillConfig$: Observable<IControlFillConfig | null>;
     protected _selectionControls: SelectionControl[];
     protected _startRangeWhenPointerDown: IRangeWithCoord;
+    protected _activeControlIndex: number;
     /**
      * the posX of viewport when the pointer down
      */
@@ -158,6 +160,8 @@ export declare class BaseSelectionRenderService extends Disposable implements IS
      * Returns the selected range in the active sheet, or null if there is no active range. If multiple ranges are selected this method returns only the last selected range.
      */
     getActiveRange(): Nullable<IRange>;
+    setActiveSelectionIndex(index: number): void;
+    resetActiveSelectionIndex(): void;
     /**
      * get active(actually last) selection control
      * @returns T extends SelectionControl

package/lib/types/services/selection/selection-control.d.ts

@@ -1,5 +1,5 @@
 import { ICellWithCoord, IRangeWithCoord, Nullable, ThemeService, Disposable, RANGE_TYPE } from '@univerjs/core';
-import { Scene, Group, Rect } from '@univerjs/engine-render';
+import { Scene, SpreadsheetSkeleton, Group, Rect } from '@univerjs/engine-render';
 import { ISelectionStyle, ISelectionWidgetConfig, ISelectionWithCoord } from '@univerjs/sheets';
 import { ISelectionShapeExtensionOption, SelectionShapeExtension } from './selection-shape-extension';
 import { Subject } from 'rxjs';
@@ -175,7 +175,7 @@ export declare class SelectionControl extends Disposable {
      * Update range and primary range and style.
      * @param selectionWthCoord
      */
-    updateRangeBySelectionWithCoord(selectionWthCoord: ISelectionWithCoord): void;
+    updateRangeBySelectionWithCoord(selectionWthCoord: ISelectionWithCoord, sk?: SpreadsheetSkeleton): void;
     /**
      * Update selection model with new range & primary cell(aka: highlight/current), also update row/col selection size & style.
      *

package/lib/types/services/sheet-skeleton-manager.service.d.ts

@@ -1,5 +1,5 @@
 import { IRange, IRangeWithCoord, Nullable, Workbook, Disposable, Injector } from '@univerjs/core';
-import { IRenderContext, IRenderModule, SpreadsheetSkeleton } from '@univerjs/engine-render';
+import { IRender, IRenderContext, IRenderModule, SpreadsheetSkeleton } from '@univerjs/engine-render';
 export interface ISheetSkeletonManagerParam {
     unitId: string;
     sheetId: string;
@@ -58,4 +58,5 @@ export declare class SheetSkeletonManagerService extends Disposable implements I
     attachRangeWithCoord(range: IRange): Nullable<IRangeWithCoord>;
     private _getSkeleton;
     private _buildSkeleton;
+    setColumnHeaderSize(sheetId: string, render: IRender, size: number): void;
 }

package/lib/types/views/editor-container/hooks.d.ts

@@ -0,0 +1,8 @@
+import { KeyCode } from '@univerjs/ui';
+export declare function useKeyEventConfig(isRefSelecting: React.MutableRefObject<0 | 1 | 2>, unitId: string): {
+    keyCodes: {
+        keyCode: KeyCode;
+    }[];
+    handler: (keycode: KeyCode) => void;
+};
+export declare function useIsFocusing(editorId: string): boolean | undefined;