@antv/s2-vue 2.0.0-next.15 → 2.0.0-next.16

package/esm/index.d.ts

@@ -3,13 +3,15 @@ import { BaseTooltipOperatorMenuOptions } from '@antv/s2';
 import { Canvas } from '@antv/g';
 import { CanvasConfig } from '@antv/g';
 import type { CellScrollPosition } from '@antv/s2';
+import { CellSelectedDetail } from '@antv/s2';
+import { CellSelectedHandler } from '@antv/s2';
 import { ColCell } from '@antv/s2';
 import { ComponentOptionsMixin } from 'vue';
 import { ComputedRef } from 'vue';
 import { CopyableList } from '@antv/s2';
 import { CornerCell } from '@antv/s2';
 import type * as CSS_2 from 'csstype';
-import { CSSGlobalKeywords } from '@antv/g-lite/dist/css';
+import { CSSGlobalKeywords } from '@antv/g-lite/types/css';
 import { DataCell } from '@antv/s2';
 import { DebouncedFunc } from 'lodash';
 import { DefineComponent } from 'vue';
@@ -43,8 +45,10 @@ import { RawData } from '@antv/s2';
 import { Rect } from '@antv/g';
 import { Rectangle } from '@antv/g';
 import { Ref } from 'vue';
+import type { Renderer } from '@antv/g-canvas';
 import { ResizeInfo } from '@antv/s2';
 import { ResizeParams } from '@antv/s2';
+import { RowCell } from '@antv/s2';
 import { RowCellCollapsedParams } from '@antv/s2';
 import { S2CellType } from '@antv/s2';
 import { S2DataConfig } from '@antv/s2';
@@ -141,7 +145,7 @@ declare abstract class BaseCell<T extends SimpleBBox> extends Group {
     protected textShapes: CustomText[];
     protected linkFieldShape: Line;
     protected actualText: string;
-    protected originalText: string;
+    protected originalText: SimpleData;
     protected conditions: Conditions;
     protected conditionIntervalShape: Rect | undefined;
     protected conditionIconShape: GuiIcon;
@@ -213,7 +217,7 @@ declare abstract class BaseCell<T extends SimpleBBox> extends Group {
     /**
      * 获取原始的文本 (不含省略号)
      */
-    getOriginalText(): string;
+    getOriginalText(): SimpleData;
     /**
      * 文本是否溢出 (有省略号)
      */
@@ -222,25 +226,25 @@ declare abstract class BaseCell<T extends SimpleBBox> extends Group {
      * 是否是多行文本
      */
     isMultiLineText(): boolean;
-    /**
-     * 获取单元格空值占位符
-     */
-    getEmptyPlaceholder(): string | null | undefined;
     /**
      * 获取文本包围盒
      */
     getTextLineBoundingRects(): Rectangle[];
+    /**
+     * 获取单元格空值占位符
+     */
+    getEmptyPlaceholder(): string | null | undefined;
     /**
      * 获取单元格展示的数值
      */
-    getFieldValue(): string;
+    getFieldValue(): SimpleData;
     protected shouldInit(): boolean;
     getStyle<K extends keyof InternalFullyTheme = CellType>(name?: K): InternalFullyTheme[K] | InternalFullyCellTheme;
     getLinkFieldShape(): Line;
     getBackgroundShape(): Image_2 | Rect | Polygon;
     getStateShapes(): Map<StateShapeLayer, DisplayObject<any, any>>;
     protected getResizeAreaStyle(): ResizeArea;
-    protected shouldDrawResizeAreaByType(type: keyof ResizeInteractionOptions, cell: S2CellType_2): number | boolean | "selected" | "all" | "current" | ((cell: S2CellType_2) => boolean) | ((resizeInfo: ResizeInfo_2) => boolean) | undefined;
+    protected shouldDrawResizeAreaByType(type: keyof ResizeInteractionOptions, cell: S2CellType_2): number | boolean | "selected" | "all" | ((cell: S2CellType_2) => boolean) | "current" | ((resizeInfo: ResizeInfo_2) => boolean) | undefined;
     getBBoxByType(type?: CellClipBox): SimpleBBox;
     drawBorders(): void;
     /**
@@ -257,8 +261,8 @@ declare abstract class BaseCell<T extends SimpleBBox> extends Group {
     drawTextShape(): void;
     protected drawLinkFieldShape(showLinkFieldShape: boolean, linkFillColor: string): void;
     protected getLinkFieldStyle(): string;
-    protected drawLinkField(meta: Node_2_2 | ViewMeta_2): void;
-    updateByState(stateName: InteractionStateName, cell: S2CellType_2): void;
+    protected drawLinkField(meta: T): void;
+    updateByState(stateName: `${InteractionStateName}`, cell: S2CellType_2): void;
     protected getInteractiveBorderShapeStyle<T>(borderSize: T & number): {
         x: number;
         y: number;
@@ -434,7 +438,7 @@ declare abstract class BaseDataSet_2 {
      */
     getCustomFieldDescription: (cell: S2CellType_2<ViewMeta_2 | Node_2_2>) => string | undefined;
     /**
-     * 获得字段格式方法
+     * 获得字段格式化方法
      * @param field
      */
     getFieldFormatter(field: CustomHeaderField): Formatter;
@@ -480,7 +484,7 @@ declare abstract class BaseDataSet_2 {
      * @param field
      * @param query
      */
-    abstract getDimensionValues(field: string, query?: Query): string[];
+    abstract getDimensionValues(field: string, query?: Query): SimpleData[];
     /**
      * 获取单个的单元格数据
      */
@@ -534,7 +538,7 @@ declare abstract class BaseFacet {
     foregroundGroup: Group;
     /**
      * 当前布局节点信息
-     * @description 内部消费, 外部调用请使用 facet.getLayoutResult()
+     * @private 内部消费, 外部调用请使用 facet.getLayoutResult()
      */
     protected layoutResult: LayoutResult_2;
     viewCellWidths: number[];
@@ -551,9 +555,9 @@ declare abstract class BaseFacet {
     centerFrame: Frame;
     gridInfo: GridInfo;
     protected textWrapNodeHeightCache: Map<string, number>;
-    protected textWrapTempRowCell: RowCell | DataCell_2;
+    protected textWrapTempRowCell: RowCell_2 | DataCell_2;
     protected textWrapTempColCell: ColCell_2 | TableColCell;
-    protected abstract getRowCellInstance(node: Node_2_2 | ViewMeta_2, spreadsheet: SpreadSheet_2, config: Partial<BaseHeaderConfig>): RowCell | DataCell_2;
+    protected abstract getRowCellInstance(node: Node_2_2 | ViewMeta_2, spreadsheet: SpreadSheet_2, config: Partial<BaseHeaderConfig>): RowCell_2 | DataCell_2;
     protected abstract getColCellInstance(node: Node_2_2, spreadsheet: SpreadSheet_2, config: Partial<BaseHeaderConfig>): ColCell_2;
     protected abstract doLayout(): LayoutResult_2;
     protected abstract clip(scrollX: number, scrollY: number): void;
@@ -562,6 +566,8 @@ declare abstract class BaseFacet {
     abstract getViewCellHeights(): ViewCellHeights;
     abstract addDataCell(cell: DataCell_2): void;
     abstract getCellMeta(rowIndex: number, colIndex: number): ViewMeta_2 | null;
+    abstract getContentWidth(): number;
+    abstract getContentHeight(): number;
     protected scrollFrameId: ReturnType<typeof requestAnimationFrame> | null;
     protected scrollDirection: ScrollDirection;
     get scrollBarTheme(): DeepRequired<ScrollBarTheme>;
@@ -617,8 +623,10 @@ declare abstract class BaseFacet {
         width: number;
         height: number;
     };
-    getContentHeight(): number;
-    updateScrollOffset(offsetConfig: OffsetConfig): void;
+    /**
+     * @alias s2.interaction.scrollTo(offsetConfig)
+     */
+    updateScrollOffset(offsetConfig: ScrollOffsetConfig): void;
     getPaginationScrollY(): number;
     destroy(): void;
     setScrollOffset: (scrollOffset: ScrollOffset_2) => void;
@@ -644,10 +652,9 @@ declare abstract class BaseFacet {
     };
     getRealHeight: () => number;
     clearAllGroup(): void;
-    scrollWithAnimation: (offsetConfig?: OffsetConfig, duration?: number, cb?: () => void) => void;
-    scrollImmediately: (offsetConfig?: OffsetConfig) => void;
+    scrollWithAnimation: (offsetConfig?: ScrollOffsetConfig, duration?: number, cb?: () => void) => void;
+    scrollImmediately: (offsetConfig?: ScrollOffsetConfig) => void;
     /**
-     *
      * @param skipScrollEvent 不触发 S2Event.GLOBAL_SCROLL
      */
     startScroll: (skipScrollEvent?: boolean) => void;
@@ -735,10 +742,7 @@ declare abstract class BaseFacet {
     };
     updatePanelScrollGroup(): void;
     /**
-     *
-     * @param skipScrollEvent: 如true则不触发GLOBAL_SCROLL事件
-     * During scroll behavior, first call to this method fires immediately and then on interval.
-     * @protected
+     * @param skipScrollEvent: 不触发 GLOBAL_SCROLL 事件
      */
     protected dynamicRenderCell(skipScrollEvent?: boolean): void;
     private emitScrollEvent;
@@ -907,11 +911,11 @@ declare abstract class BaseFacet {
     /**
      * 获取行头单元格 (不含可视区域)
      */
-    getRowCells(): RowCell[];
+    getRowCells(): RowCell_2[];
     /**
      * 获取行头叶子节点单元格 (不含可视区域)
      */
-    getRowLeafCells(): RowCell[];
+    getRowLeafCells(): RowCell_2[];
     /**
      * 获取列头单元格 (不含可视区域)
      */
@@ -956,6 +960,12 @@ declare abstract class BaseFacet {
     getCells(cellIds?: string[]): S2CellType_2<ViewMeta_2>[];
     getInitColLeafNodes(): Node_2_2[];
     clearInitColLeafNodes(): void;
+    /**
+     * @tip 和 this.spreadsheet.measureTextWidth() 的区别在于:
+     * 1. 额外添加一像素余量，防止 maxLabel 有多个同样长度情况下，一些 label 不能展示完全, 出现省略号
+     * 2. 测量时, 文本宽度向上取整, 避免子像素的不一致性
+     */
+    protected measureTextWidth(text: SimpleData, font: unknown): number;
 }
 
 declare interface BaseFields {
@@ -1190,7 +1200,8 @@ rowCellMouseMove: (data: TargetCellInfo) => void;
 rowCellCollapsed: (params: RowCellCollapsedParams) => void;
 rowCellAllCollapsed: (isCollapsed: boolean) => void;
 rowCellScroll: (position: Required<ScrollOffset>) => void;
-rowCellRender: (cell: ColCell) => void;
+rowCellRender: (cell: RowCell) => void;
+rowCellSelected: CellSelectedHandler;
 colCellHover: (data: TargetCellInfo) => void;
 colCellClick: (data: TargetCellInfo) => void;
 colCellDoubleClick: (data: TargetCellInfo) => void;
@@ -1204,6 +1215,7 @@ currentHiddenColumnsInfo: HiddenColumnsInfo;
 hiddenColumnsDetail: HiddenColumnsInfo[];
 }) => void;
 colCellRender: (cell: ColCell) => void;
+colCellSelected: CellSelectedHandler;
 dataCellHover: (data: TargetCellInfo) => void;
 dataCellClick: (data: TargetCellInfo) => void;
 dataCellDoubleClick: (data: TargetCellInfo) => void;
@@ -1216,6 +1228,7 @@ dataCellSelectMove: (metaList: ViewMetaData[]) => void;
 dataCellRender: (cell: DataCell) => void;
 dataCellEditStart: (meta: ViewMeta, cell: TableDataCell) => void;
 dataCellEditEnd: (meta: ViewMeta, cell: TableDataCell) => void;
+dataCellSelected: CellSelectedHandler;
 cornerCellHover: (data: TargetCellInfo) => void;
 cornerCellClick: (data: TargetCellInfo) => void;
 cornerCellDoubleClick: (data: TargetCellInfo) => void;
@@ -1224,6 +1237,7 @@ cornerCellMouseDown: (data: TargetCellInfo) => void;
 cornerCellMouseUp: (data: TargetCellInfo) => void;
 cornerCellMouseMove: (data: TargetCellInfo) => void;
 cornerCellRender: (cell: CornerCell) => void;
+cornerCellSelected: CellSelectedHandler;
 mergedCellsHover: (data: TargetCellInfo) => void;
 mergedCellsClick: (data: TargetCellInfo) => void;
 mergedCellsDoubleClick: (data: TargetCellInfo) => void;
@@ -1282,7 +1296,7 @@ mouseHover: (event: GEvent) => void;
 mouseUp: (event: MouseEvent) => void;
 mouseDown: (event: MouseEvent) => void;
 mouseMove: (event: MouseEvent) => void;
-selected: (cells: S2CellType[]) => void;
+selected: CellSelectedHandler;
 reset: (event: KeyboardEvent) => void;
 linkFieldJump: (data: {
 field: string;
@@ -1336,7 +1350,8 @@ onRowCellMouseMove?: (data: TargetCellInfo) => any;
 onRowCellCollapsed?: (params: RowCellCollapsedParams) => any;
 onRowCellAllCollapsed?: (isCollapsed: boolean) => any;
 onRowCellScroll?: (position: Required<ScrollOffset>) => any;
-onRowCellRender?: (cell: ColCell) => any;
+onRowCellRender?: (cell: RowCell) => any;
+onRowCellSelected?: (cells: S2CellType<ViewMeta>[], detail: CellSelectedDetail) => any;
 onColCellHover?: (data: TargetCellInfo) => any;
 onColCellClick?: (data: TargetCellInfo) => any;
 onColCellDoubleClick?: (data: TargetCellInfo) => any;
@@ -1350,6 +1365,7 @@ currentHiddenColumnsInfo: HiddenColumnsInfo;
 hiddenColumnsDetail: HiddenColumnsInfo[];
 }) => any;
 onColCellRender?: (cell: ColCell) => any;
+onColCellSelected?: (cells: S2CellType<ViewMeta>[], detail: CellSelectedDetail) => any;
 onDataCellHover?: (data: TargetCellInfo) => any;
 onDataCellClick?: (data: TargetCellInfo) => any;
 onDataCellDoubleClick?: (data: TargetCellInfo) => any;
@@ -1362,6 +1378,7 @@ onDataCellSelectMove?: (metaList: ViewMetaData[]) => any;
 onDataCellRender?: (cell: DataCell) => any;
 onDataCellEditStart?: (meta: ViewMeta, cell: TableDataCell) => any;
 onDataCellEditEnd?: (meta: ViewMeta, cell: TableDataCell) => any;
+onDataCellSelected?: (cells: S2CellType<ViewMeta>[], detail: CellSelectedDetail) => any;
 onCornerCellHover?: (data: TargetCellInfo) => any;
 onCornerCellClick?: (data: TargetCellInfo) => any;
 onCornerCellDoubleClick?: (data: TargetCellInfo) => any;
@@ -1370,6 +1387,7 @@ onCornerCellMouseDown?: (data: TargetCellInfo) => any;
 onCornerCellMouseUp?: (data: TargetCellInfo) => any;
 onCornerCellMouseMove?: (data: TargetCellInfo) => any;
 onCornerCellRender?: (cell: CornerCell) => any;
+onCornerCellSelected?: (cells: S2CellType<ViewMeta>[], detail: CellSelectedDetail) => any;
 onMergedCellsHover?: (data: TargetCellInfo) => any;
 onMergedCellsClick?: (data: TargetCellInfo) => any;
 onMergedCellsDoubleClick?: (data: TargetCellInfo) => any;
@@ -1428,7 +1446,7 @@ onMouseHover?: (event: GEvent) => any;
 onMouseUp?: (event: MouseEvent) => any;
 onMouseDown?: (event: MouseEvent) => any;
 onMouseMove?: (event: MouseEvent) => any;
-onSelected?: (cells: S2CellType[]) => any;
+onSelected?: (cells: S2CellType<ViewMeta>[], detail: CellSelectedDetail) => any;
 onReset?: (event: KeyboardEvent) => any;
 onLinkFieldJump?: (data: {
 field: string;
@@ -1478,7 +1496,8 @@ declare interface BaseSheetComponentProps<PartialDrillDown = PartDrillDown, Head
     onRowCellCollapsed?: (params: RowCellCollapsedParams) => void;
     onRowCellAllCollapsed?: (isCollapsed: boolean) => void;
     onRowCellScroll?: (position: CellScrollPosition) => void;
-    onRowCellRender?: (cell: ColCell) => void;
+    onRowCellRender?: (cell: RowCell) => void;
+    onRowCellSelected?: CellSelectedHandler;
     onColCellHover?: (data: TargetCellInfo) => void;
     onColCellClick?: (data: TargetCellInfo) => void;
     onColCellDoubleClick?: (data: TargetCellInfo) => void;
@@ -1492,6 +1511,7 @@ declare interface BaseSheetComponentProps<PartialDrillDown = PartDrillDown, Head
         hiddenColumnsDetail: HiddenColumnsInfo[];
     }) => void;
     onColCellRender?: (cell: ColCell) => void;
+    onColCellSelected?: CellSelectedHandler;
     onDataCellHover?: (data: TargetCellInfo) => void;
     onDataCellClick?: (data: TargetCellInfo) => void;
     onDataCellDoubleClick?: (data: TargetCellInfo) => void;
@@ -1504,6 +1524,7 @@ declare interface BaseSheetComponentProps<PartialDrillDown = PartDrillDown, Head
     onDataCellRender?: (cell: DataCell) => void;
     onDataCellEditStart?: (meta: ViewMeta, cell: TableDataCell) => void;
     onDataCellEditEnd?: (meta: ViewMeta, cell: TableDataCell) => void;
+    onDataCellSelected?: CellSelectedHandler;
     onCornerCellHover?: (data: TargetCellInfo) => void;
     onCornerCellClick?: (data: TargetCellInfo) => void;
     onCornerCellDoubleClick?: (data: TargetCellInfo) => void;
@@ -1512,6 +1533,7 @@ declare interface BaseSheetComponentProps<PartialDrillDown = PartDrillDown, Head
     onCornerCellMouseUp?: (data: TargetCellInfo) => void;
     onCornerCellMouseMove?: (data: TargetCellInfo) => void;
     onCornerCellRender?: (cell: CornerCell) => void;
+    onCornerCellSelected?: CellSelectedHandler;
     onMergedCellsHover?: (data: TargetCellInfo) => void;
     onMergedCellsClick?: (data: TargetCellInfo) => void;
     onMergedCellsDoubleClick?: (data: TargetCellInfo) => void;
@@ -1571,7 +1593,7 @@ declare interface BaseSheetComponentProps<PartialDrillDown = PartDrillDown, Head
     onMouseUp?: (event: MouseEvent) => void;
     onMouseDown?: (event: MouseEvent) => void;
     onMouseMove?: (event: MouseEvent) => void;
-    onSelected?: (cells: S2CellType[]) => void;
+    onSelected?: CellSelectedHandler;
     onReset?: (event: KeyboardEvent) => void;
     onLinkFieldJump?: (data: {
         field: string;
@@ -1719,20 +1741,22 @@ declare interface BulletValue {
 }
 
 declare interface CalcTotals {
-    /** 聚合方式 */
+    /**
+     * 聚合方式
+     */
     aggregation?: `${Aggregation}`;
     /**
      * 自定义计算汇总
      * @see https://s2.antv.antgroup.com/examples/analysis/totals/#custom
      */
-    calcFunc?: (query: Query, data: CellData[]) => number;
+    calcFunc?: (query: Query, data: CellData[], spreadsheet: SpreadSheet_2) => number;
 }
 
 declare type CanvasEventHandler = (event: FederatedPointerEvent) => void;
 
-declare interface CellAppendInfo<T = Node_2_2> extends Partial<ResizeInfo_2> {
+declare interface CellAppendInfo<T = Node_2_2> extends Partial<Omit<ResizeInfo_2, 'meta'>> {
     isLinkFieldText?: boolean;
-    cellData?: T;
+    meta?: T;
 }
 
 declare enum CellBorderPosition {
@@ -1770,8 +1794,8 @@ declare enum CellClipBox {
 declare type CellCustomSize = null | undefined | number | ((node: Node_2_2 | null) => number | null);
 
 declare class CellData {
-    private raw;
-    private extraField;
+    readonly raw: RawData_2;
+    readonly extraField: string;
     constructor(raw: RawData_2, extraField: string);
     static getCellData(raw: RawData_2, extraField: string): CellData;
     static getCellDataList(raw: RawData_2, extraFields: string[]): CellData[];
@@ -1805,6 +1829,30 @@ declare interface CellScrollOffset {
 
 declare type CellScrollPosition_2 = Required<ScrollOffset_2>;
 
+declare interface CellScrollToOptions {
+    /**
+     * 是否展示滚动动画
+     */
+    animate?: boolean;
+    /**
+     * 是否触发滚动事件
+     */
+    skipScrollEvent?: boolean;
+}
+
+declare interface CellSelectedDetail_2 {
+    /**
+     * 触发选中的交互名
+     */
+    interactionName?: `${InteractionName}`;
+    /**
+     * 触发选中的单元格
+     */
+    targetCell?: S2CellType_2 | null;
+}
+
+declare type CellSelectedHandler_2 = (cells: S2CellType_2[], detail: CellSelectedDetail_2) => void;
+
 declare interface CellTextWordWrapStyle extends Pick<TextStyleProps, 'wordWrap' | 'maxLines' | 'textOverflow'> {
 }
 
@@ -1848,6 +1896,30 @@ declare enum CellType {
     MERGED_CELL = "mergedCell"
 }
 
+declare interface ChangeCellOptions extends CellScrollToOptions {
+    /**
+     * 目标单元格
+     */
+    cell: S2CellType_2<ViewMeta_2>;
+    /**
+     * 是否是多选
+     */
+    isMultiSelection?: boolean;
+    /**
+     * 状态名 (默认 `selected`)
+     */
+    stateName?: `${InteractionStateName}`;
+    /**
+     * 交互名
+     */
+    interactionName?: `${InteractionName}`;
+    /**
+     * 如果单元格不在可视范围, 是否自动滚动
+     * @default true
+     */
+    scrollIntoView?: boolean;
+}
+
 declare class ColCell_2 extends HeaderCell<ColHeaderConfig> {
     get cellType(): CellType;
     protected getBorderPositions(): CellBorderPosition[];
@@ -1938,7 +2010,7 @@ declare interface Condition<T = unknown> {
     mapping: ConditionMapping<T>;
 }
 
-declare type ConditionMapping<T = unknown> = (fieldValue: number | string, data: RawData_2, cell?: DataCell_2 | HeaderCell) => ConditionMappingResult<T>;
+declare type ConditionMapping<T = unknown> = (fieldValue: number | string, data: RawData_2, cell: S2CellType_2) => ConditionMappingResult<T>;
 
 declare type ConditionMappingResult<T = unknown> = T | undefined | null;
 
@@ -2102,6 +2174,7 @@ declare interface CustomTreeNode {
     title?: string;
     /**
      * 是否收起（默认都展开）
+     * @description 优先级 `collapseFields` > `expandDepth` > `collapseAll` > `collapsed`
      */
     collapsed?: boolean;
     /**
@@ -2157,8 +2230,8 @@ declare class DataCell_2 extends BaseCell<ViewMeta_2> {
         };
     };
     protected getBorderPositions(): CellBorderPosition[];
-    get valueRangeByField(): ValueRange;
-    protected handleByStateName(cells: CellMeta[], stateName: InteractionStateName): void;
+    getValueRange(): ValueRange;
+    protected handleByStateName(cells: CellMeta[], stateName: `${InteractionStateName}`): void;
     protected handleSearchResult(cells: CellMeta[]): void;
     protected handleSelect(cells: CellMeta[]): void;
     protected isDisableHover(cellMeta: CellMeta): boolean;
@@ -2186,13 +2259,13 @@ declare class DataCell_2 extends BaseCell<ViewMeta_2> {
      * Find current field related condition
      * @param conditions
      */
-    findFieldCondition<Con extends Condition>(conditions?: Con[]): Con | undefined;
+    findFieldCondition<T extends Condition>(conditions?: T[]): T | undefined;
     /**
      * Mapping value to get condition related attrs
      * @param condition
      */
     mappingValue<Result>(condition: Condition<Result>): ConditionMappingResult<Result>;
-    updateByState(stateName: InteractionStateName): void;
+    updateByState(stateName: `${InteractionStateName}`): void;
     clearUnselectedState(): void;
     private toggleConditionIntervalShapeOpacity;
 }
@@ -2228,7 +2301,7 @@ declare interface DataCellStyle extends CellTextWordWrapStyle {
     };
 }
 
-declare type DataItem = SimpleData | MultiData | Record<string, unknown> | undefined | null;
+declare type DataItem = SimpleData | MultiData | Record<string, unknown>;
 
 declare type DataPath = (number | string | undefined)[];
 
@@ -2284,7 +2357,7 @@ declare interface EmitterType {
     [S2Event.GLOBAL_DOUBLE_CLICK]: CanvasEventHandler;
     [S2Event.GLOBAL_RESET]: EventHandler_2;
     [S2Event.GLOBAL_HOVER]: CanvasEventHandler;
-    [S2Event.GLOBAL_SELECTED]: SelectedHandler;
+    [S2Event.GLOBAL_SELECTED]: CellSelectedHandler_2;
     [S2Event.GLOBAL_SCROLL]: (position: CellScrollPosition_2) => void;
     /** ================ Sort ================  */
     [S2Event.RANGE_SORT]: (info: SortParams_2) => void;
@@ -2294,7 +2367,7 @@ declare interface EmitterType {
     [S2Event.RANGE_FILTERED]: (data: RawData_2[]) => any;
     /** ================ Cell ================  */
     [S2Event.GLOBAL_LINK_FIELD_JUMP]: (data: {
-        cellData: Node_2_2;
+        meta: Node_2_2 | ViewMeta_2;
         field: string;
         record: Data;
     }) => void;
@@ -2309,6 +2382,7 @@ declare interface EmitterType {
     [S2Event.DATA_CELL_BRUSH_SELECTION]: (cells: (DataCell_2 | CellMeta)[]) => void;
     [S2Event.DATA_CELL_SELECT_MOVE]: (metas: CellMeta[]) => void;
     [S2Event.DATA_CELL_RENDER]: (cell: DataCell_2) => void;
+    [S2Event.DATA_CELL_SELECTED]: CellSelectedHandler_2;
     /** ================ Row Cell ================  */
     [S2Event.ROW_CELL_MOUSE_DOWN]: CanvasEventHandler;
     [S2Event.ROW_CELL_MOUSE_MOVE]: CanvasEventHandler;
@@ -2318,12 +2392,13 @@ declare interface EmitterType {
     [S2Event.ROW_CELL_CONTEXT_MENU]: CanvasEventHandler;
     [S2Event.ROW_CELL_MOUSE_UP]: CanvasEventHandler;
     [S2Event.ROW_CELL_SCROLL]: (position: CellScrollPosition_2) => void;
-    [S2Event.ROW_CELL_BRUSH_SELECTION]: (cells: RowCell[]) => void;
+    [S2Event.ROW_CELL_BRUSH_SELECTION]: (cells: RowCell_2[]) => void;
     [S2Event.ROW_CELL_COLLAPSED]: (data: RowCellCollapsedParams_2) => void;
     [S2Event.ROW_CELL_COLLAPSED__PRIVATE]: (data: RowCellCollapsedParams_2) => void;
     [S2Event.ROW_CELL_ALL_COLLAPSED]: (isCollapsed: boolean) => void;
     [S2Event.ROW_CELL_ALL_COLLAPSED__PRIVATE]: (isCollapsed: boolean) => void;
-    [S2Event.ROW_CELL_RENDER]: (cell: RowCell) => void;
+    [S2Event.ROW_CELL_RENDER]: (cell: RowCell_2) => void;
+    [S2Event.ROW_CELL_SELECTED]: CellSelectedHandler_2;
     /** ================ Col Cell ================  */
     [S2Event.COL_CELL_MOUSE_DOWN]: CanvasEventHandler;
     [S2Event.COL_CELL_MOUSE_MOVE]: CanvasEventHandler;
@@ -2336,6 +2411,7 @@ declare interface EmitterType {
     [S2Event.COL_CELL_EXPANDED]: (expandedNode: Node_2_2) => void;
     [S2Event.COL_CELL_HIDDEN]: (currentHiddenColumnsInfo: HiddenColumnsInfo_2, hiddenColumnsDetail: HiddenColumnsInfo_2[]) => void;
     [S2Event.COL_CELL_RENDER]: (cell: ColCell_2) => void;
+    [S2Event.COL_CELL_SELECTED]: CellSelectedHandler_2;
     /** ================ Corner Cell ================  */
     [S2Event.CORNER_CELL_MOUSE_MOVE]: CanvasEventHandler;
     [S2Event.CORNER_CELL_MOUSE_DOWN]: CanvasEventHandler;
@@ -2345,6 +2421,7 @@ declare interface EmitterType {
     [S2Event.CORNER_CELL_CONTEXT_MENU]: CanvasEventHandler;
     [S2Event.CORNER_CELL_MOUSE_UP]: CanvasEventHandler;
     [S2Event.CORNER_CELL_RENDER]: (cell: CornerCell_2) => void;
+    [S2Event.CORNER_CELL_SELECTED]: CellSelectedHandler_2;
     /** ================ Merged Cells ================  */
     [S2Event.MERGED_CELLS_MOUSE_DOWN]: CanvasEventHandler;
     [S2Event.MERGED_CELLS_MOUSE_MOVE]: CanvasEventHandler;
@@ -2403,7 +2480,7 @@ declare class EventController {
     canvasMousemoveEvent: FederatedPointerEvent;
     constructor(spreadsheet: SpreadSheet_2);
     get canvasContainer(): Canvas;
-    get isAutoResetSheetStyle(): boolean | undefined;
+    isAutoResetSheetStyle(event: Event | FederatedPointerEvent): boolean | undefined;
     bindEvents(): void;
     private isGuiIconShape;
     private isConditionIconShape;
@@ -2474,6 +2551,8 @@ declare interface Fields extends BaseFields {
     customValueOrder?: number;
 }
 
+declare type FieldValue = string | TotalClass | TotalMeasure;
+
 declare interface FilterParam {
     filterKey: string;
     filteredValues?: unknown[];
@@ -2481,7 +2560,7 @@ declare interface FilterParam {
 }
 
 declare interface FormatResult {
-    formattedValue: string;
+    formattedValue: SimpleData;
     value: DataItem;
 }
 
@@ -2491,10 +2570,12 @@ declare interface FormatResult {
  * 2. copy/export
  * 3. tooltip, 且仅在选择多个单元格时，data 类型为数组
  */
-declare type Formatter = (v: unknown, data?: SimpleData | ViewMetaData_2 | ViewMetaData_2[], meta?: Node_2_2 | ViewMeta_2) => string;
+declare type Formatter = (value: DataItem, data?: DataItem | ViewMetaData_2 | ViewMetaData_2[], meta?: Node_2_2 | ViewMeta_2 | null | undefined) => SimpleData;
 
 declare class Frame extends Group {
     cfg: FrameConfig;
+    cornerRightBorder: Line;
+    cornerBottomBorder: Line;
     constructor(cfg: FrameConfig);
     layout(): void;
     /**
@@ -2651,11 +2732,18 @@ declare interface GuiIconCfg extends Omit<ImageStyleProps, 'fill'> {
     readonly fill?: string | null;
 }
 
+/**
+ * 基于 Canvas 的高清适配方案
+ * 1. 双屏切换, devicePixelRatio 变化时
+ * 2. Mac 触控板缩放
+ * 3. 浏览器窗口缩放
+ */
 declare class HdAdapter {
     private viewport;
     private devicePixelRatioMedia;
     private spreadsheet;
     private isDevicePixelRatioChange;
+    private zoomOffsetLeft;
     constructor(spreadsheet: SpreadSheet_2);
     init: () => void;
     destroy: () => void;
@@ -2668,6 +2756,9 @@ declare class HdAdapter {
      * @see https://github.com/antvis/S2/issues/2072
      */
     private renderByZoomScaleWithoutResizeEffect;
+    /**
+     * 如果是浏览器窗口的放大缩小 (command +/-), 也会触发
+     */
     private renderByDevicePixelRatioChanged;
     private renderByDevicePixelRatio;
     private renderByZoomScale;
@@ -2768,7 +2859,7 @@ declare abstract class HeaderCell<T extends BaseHeaderConfig = BaseHeaderConfig>
     protected addActionIcon(options: HeaderActionIconOptions): void;
     protected drawActionAndConditionIcons(): void;
     protected isSortCell(): boolean;
-    protected handleByStateName(cells: CellMeta[], stateName: InteractionStateName): void;
+    protected handleByStateName(cells: CellMeta[], stateName: `${InteractionStateName}`): void;
     protected handleSearchResult(cells: CellMeta[]): void;
     protected handleHover(cells: CellMeta[]): void;
     protected handleSelect(cells: CellMeta[], nodes?: Node_2_2[]): void;
@@ -2784,11 +2875,11 @@ declare abstract class HeaderCell<T extends BaseHeaderConfig = BaseHeaderConfig>
     toggleActionIcon(id: string): void;
     protected getIconPosition(): PointLike;
     update(): void;
-    updateByState(stateName: InteractionStateName): void;
+    updateByState(stateName: `${InteractionStateName}`): void;
     hideInteractionShape(): void;
     isMeasureField(): boolean;
     mappingValue<Result>(condition: Condition<Result>): ConditionMappingResult<Result>;
-    findFieldCondition<Con extends Condition>(conditions?: Con[]): Con | undefined;
+    findFieldCondition<T extends Condition>(conditions?: T[]): T | undefined;
     getTreeIcon(): GuiIcon | undefined;
     getActionIcons(): GuiIcon[];
 }
@@ -2879,18 +2970,47 @@ declare interface IconTheme {
 declare type Indexes = [number, number, number, number];
 
 declare interface InteractionCellHighlightOptions {
-    /** 高亮行头 */
+    /**
+     * 高亮行头
+     */
     rowHeader?: boolean;
-    /** 高亮列头 */
+    /**
+     * 高亮列头
+     */
     colHeader?: boolean;
-    /** 高亮选中单元格所在行 */
+    /**
+     * 高亮选中单元格所在行
+     */
     currentRow?: boolean;
-    /** 高亮选中单元格所在列 */
+    /**
+     * 高亮选中单元格所在列
+     */
     currentCol?: boolean;
 }
 
 declare type InteractionConstructor = new (spreadsheet: SpreadSheet_2) => BaseEvent;
 
+declare enum InteractionName {
+    CORNER_CELL_CLICK = "cornerCellClick",
+    DATA_CELL_CLICK = "dataCellClick",
+    ROW_CELL_CLICK = "rowCellClick",
+    COL_CELL_CLICK = "colCellClick",
+    MERGED_CELLS_CLICK = "mergedCellsClick",
+    ROW_COLUMN_CLICK = "rowColumnClick",
+    HEADER_CELL_LINK_CLICK = "headerCellLinkClick",
+    HOVER = "hover",
+    DATA_CELL_BRUSH_SELECTION = "dataCellBrushSelection",
+    ROW_CELL_BRUSH_SELECTION = "rowCellBrushSelection",
+    COL_CELL_BRUSH_SELECTION = "colCellBrushSelection",
+    COL_ROW_RESIZE = "rowColResize",
+    DATA_CELL_MULTI_SELECTION = "dataCellMultiSelection",
+    ROW_CELL_MULTI_SELECTION = "rowCellMultiSelection",
+    COL_CELL_MULTI_SELECTION = "colCellMultiSelection",
+    RANGE_SELECTION = "rangeSelection",
+    SELECTED_CELL_MOVE = "selectedCellMove",
+    GLOBAL_RESET = "globalReset"
+}
+
 declare interface InteractionOptions {
     /**
      * 链接跳转
@@ -2934,10 +3054,11 @@ declare interface InteractionOptions {
         customTransformer?: (transformer: Transformer_2) => Partial<Transformer_2>;
     };
     /**
-     * 自动重置表格样式 (按下 ESC 键, 点击空白区域时, 关闭 tooltip/交互状态)
+     * 自动重置表格样式 (按下 ESC 键, 点击空白区域时, 关闭 tooltip/交互状态), 支持根据 event 动态判断
      * @see https://s2.antv.antgroup.com/examples/interaction/basic/#auto-reset-sheet-style
+     * @example autoResetSheetStyle: (event, spreadsheet) => event.target instanceof HTMLDivElement
      */
-    autoResetSheetStyle?: boolean;
+    autoResetSheetStyle?: boolean | ((event: Event | FederatedPointerEvent, spreadsheet: SpreadSheet_2) => boolean);
     /**
      * 隐藏列头配置, 支持维度 (S2DataConfig.fields) 和具体维值 (id)
      * @example hiddenColumnFields: ['type', 'subType'];
@@ -3018,7 +3139,7 @@ declare interface InteractionStateInfo {
     /**
      * 交互状态名
      */
-    stateName?: InteractionStateName;
+    stateName?: `${InteractionStateName}`;
     /**
      * 单元格元数据 (包含不在可视范围内的)
      */
@@ -3118,7 +3239,7 @@ declare type KeyboardEventHandler = (event: KeyboardEvent) => void;
 /**
  * determine the order of every row/column tree branch
  */
-declare type LayoutArrange = (spreadsheet: SpreadSheet_2, parent: Node_2_2, field: string, fieldValues: string[]) => string[];
+declare type LayoutArrange = (spreadsheet: SpreadSheet_2, parent: Node_2_2, field: string, fieldValues: FieldValue[]) => string[];
 
 /**
  * determine the data of cells in Cartesian coordinates
@@ -3254,9 +3375,13 @@ declare interface MergedCellStyle extends CellTextWordWrapStyle {
 
 declare interface Meta {
     /**
-     * 字段 id
+     * 字段名
+     * @example
+     1. 'city'
+     2. ['city', 'type']
+     3. /^city/
      */
-    field?: string;
+    field?: string | string[] | RegExp;
     /**
      * 字段名称
      */
@@ -3269,6 +3394,7 @@ declare interface Meta {
      * 格式化
      * 数值字段：一般用于格式化数字单位
      * 文本字段：一般用于做字段枚举值的别名
+     * @see https://s2.antv.antgroup.com/manual/basic/formatter
      */
     formatter?: Formatter;
 }
@@ -3420,21 +3546,6 @@ declare class Node_2_2 {
     get isFrozen(): boolean | undefined;
 }
 
-declare interface OffsetConfig {
-    rowHeaderOffsetX?: {
-        value: number | undefined;
-        animate?: boolean;
-    };
-    offsetX?: {
-        value: number | undefined;
-        animate?: boolean;
-    };
-    offsetY?: {
-        value: number | undefined;
-        animate?: boolean;
-    };
-}
-
 declare type OnUpdateCells = (root: RootInteraction, defaultOnUpdateCells: () => void) => void;
 
 declare const ORIGIN_FIELD = "$$origin$$";
@@ -3592,7 +3703,8 @@ rowCellMouseMove: (data: TargetCellInfo) => void;
 rowCellCollapsed: (params: RowCellCollapsedParams) => void;
 rowCellAllCollapsed: (isCollapsed: boolean) => void;
 rowCellScroll: (position: Required<ScrollOffset>) => void;
-rowCellRender: (cell: ColCell) => void;
+rowCellRender: (cell: RowCell) => void;
+rowCellSelected: CellSelectedHandler;
 colCellHover: (data: TargetCellInfo) => void;
 colCellClick: (data: TargetCellInfo) => void;
 colCellDoubleClick: (data: TargetCellInfo) => void;
@@ -3606,6 +3718,7 @@ currentHiddenColumnsInfo: HiddenColumnsInfo;
 hiddenColumnsDetail: HiddenColumnsInfo[];
 }) => void;
 colCellRender: (cell: ColCell) => void;
+colCellSelected: CellSelectedHandler;
 dataCellHover: (data: TargetCellInfo) => void;
 dataCellClick: (data: TargetCellInfo) => void;
 dataCellDoubleClick: (data: TargetCellInfo) => void;
@@ -3618,6 +3731,7 @@ dataCellSelectMove: (metaList: ViewMetaData[]) => void;
 dataCellRender: (cell: DataCell) => void;
 dataCellEditStart: (meta: ViewMeta, cell: TableDataCell) => void;
 dataCellEditEnd: (meta: ViewMeta, cell: TableDataCell) => void;
+dataCellSelected: CellSelectedHandler;
 cornerCellHover: (data: TargetCellInfo) => void;
 cornerCellClick: (data: TargetCellInfo) => void;
 cornerCellDoubleClick: (data: TargetCellInfo) => void;
@@ -3626,6 +3740,7 @@ cornerCellMouseDown: (data: TargetCellInfo) => void;
 cornerCellMouseUp: (data: TargetCellInfo) => void;
 cornerCellMouseMove: (data: TargetCellInfo) => void;
 cornerCellRender: (cell: CornerCell) => void;
+cornerCellSelected: CellSelectedHandler;
 mergedCellsHover: (data: TargetCellInfo) => void;
 mergedCellsClick: (data: TargetCellInfo) => void;
 mergedCellsDoubleClick: (data: TargetCellInfo) => void;
@@ -3684,7 +3799,7 @@ mouseHover: (event: GEvent) => void;
 mouseUp: (event: MouseEvent) => void;
 mouseDown: (event: MouseEvent) => void;
 mouseMove: (event: MouseEvent) => void;
-selected: (cells: S2CellType[]) => void;
+selected: CellSelectedHandler;
 reset: (event: KeyboardEvent) => void;
 linkFieldJump: (data: {
 field: string;
@@ -3738,7 +3853,8 @@ onRowCellMouseMove?: (data: TargetCellInfo) => any;
 onRowCellCollapsed?: (params: RowCellCollapsedParams) => any;
 onRowCellAllCollapsed?: (isCollapsed: boolean) => any;
 onRowCellScroll?: (position: Required<ScrollOffset>) => any;
-onRowCellRender?: (cell: ColCell) => any;
+onRowCellRender?: (cell: RowCell) => any;
+onRowCellSelected?: (cells: S2CellType<ViewMeta>[], detail: CellSelectedDetail) => any;
 onColCellHover?: (data: TargetCellInfo) => any;
 onColCellClick?: (data: TargetCellInfo) => any;
 onColCellDoubleClick?: (data: TargetCellInfo) => any;
@@ -3752,6 +3868,7 @@ currentHiddenColumnsInfo: HiddenColumnsInfo;
 hiddenColumnsDetail: HiddenColumnsInfo[];
 }) => any;
 onColCellRender?: (cell: ColCell) => any;
+onColCellSelected?: (cells: S2CellType<ViewMeta>[], detail: CellSelectedDetail) => any;
 onDataCellHover?: (data: TargetCellInfo) => any;
 onDataCellClick?: (data: TargetCellInfo) => any;
 onDataCellDoubleClick?: (data: TargetCellInfo) => any;
@@ -3764,6 +3881,7 @@ onDataCellSelectMove?: (metaList: ViewMetaData[]) => any;
 onDataCellRender?: (cell: DataCell) => any;
 onDataCellEditStart?: (meta: ViewMeta, cell: TableDataCell) => any;
 onDataCellEditEnd?: (meta: ViewMeta, cell: TableDataCell) => any;
+onDataCellSelected?: (cells: S2CellType<ViewMeta>[], detail: CellSelectedDetail) => any;
 onCornerCellHover?: (data: TargetCellInfo) => any;
 onCornerCellClick?: (data: TargetCellInfo) => any;
 onCornerCellDoubleClick?: (data: TargetCellInfo) => any;
@@ -3772,6 +3890,7 @@ onCornerCellMouseDown?: (data: TargetCellInfo) => any;
 onCornerCellMouseUp?: (data: TargetCellInfo) => any;
 onCornerCellMouseMove?: (data: TargetCellInfo) => any;
 onCornerCellRender?: (cell: CornerCell) => any;
+onCornerCellSelected?: (cells: S2CellType<ViewMeta>[], detail: CellSelectedDetail) => any;
 onMergedCellsHover?: (data: TargetCellInfo) => any;
 onMergedCellsClick?: (data: TargetCellInfo) => any;
 onMergedCellsDoubleClick?: (data: TargetCellInfo) => any;
@@ -3830,7 +3949,7 @@ onMouseHover?: (event: GEvent) => any;
 onMouseUp?: (event: MouseEvent) => any;
 onMouseDown?: (event: MouseEvent) => any;
 onMouseMove?: (event: MouseEvent) => any;
-onSelected?: (cells: S2CellType[]) => any;
+onSelected?: (cells: S2CellType<ViewMeta>[], detail: CellSelectedDetail) => any;
 onReset?: (event: KeyboardEvent) => any;
 onLinkFieldJump?: (data: {
 field: string;
@@ -4010,39 +4129,221 @@ declare class RootInteraction {
     spreadsheet: SpreadSheet_2;
     interactions: Map<string, BaseEvent>;
     intercepts: Set<Intercept>;
+    /**
+     * hover有 keep-hover 态，是个计时器，hover后 800毫秒还在当前 cell 的情况下，该 cell 进入 keep-hover 状态
+     * 在任何触发点击，或者点击空白区域时，说明已经不是 hover了，因此需要取消这个计时器。
+     */
     private hoverTimer;
     eventController: EventController;
     private defaultState;
     constructor(spreadsheet: SpreadSheet_2);
+    /**
+     * 销毁交互
+     * @example s2.interaction.destroy()
+     */
     destroy(): void;
+    /**
+     * 重置交互
+     * @example s2.interaction.reset()
+     */
     reset(): void;
     private onTriggerInteractionsResetEffect;
+    /**
+     * 设置交互状态
+     * @example
+     s2.interaction.setState({
+     stateName: InteractionStateName.SELECTED,
+     cells: [{
+     "id": "root[&]浙江省[&]舟山市",
+     "colIndex": -1,
+     "rowIndex": 3,
+     "type": "rowCell"
+     }]
+     })
+     */
     setState(interactionStateInfo: InteractionStateInfo): void;
+    /**
+     * 获取交互状态
+     * @example s2.interaction.getState()
+     */
     getState(): InteractionStateInfo;
+    /**
+     * 设置通过交互触发过更新的单元格
+     * @example s2.interaction.setInteractedCells(dataCell)
+     */
     setInteractedCells(cell: S2CellType_2): void;
+    /**
+     * 获取通过交互触发过更新的单元格
+     * @example s2.interaction.getInteractedCells()
+     */
     getInteractedCells(): S2CellType_2<ViewMeta_2>[];
+    /**
+     * 重置交互状态
+     * @example s2.interaction.resetState()
+     */
     resetState(): void;
-    getCurrentStateName(): InteractionStateName | undefined;
-    isEqualStateName(stateName: InteractionStateName): boolean;
+    /**
+     * 获取当前交互状态名
+     * @example s2.interaction.getCurrentStateName()
+     */
+    getCurrentStateName(): "selected" | "hover" | "allSelected" | "rowCellBrushSelected" | "colCellBrushSelected" | "dataCellBrushSelected" | "unselected" | "hoverFocus" | "highlight" | "searchResult" | "prepareSelect" | undefined;
+    /**
+     * 是否和当前状态名相同
+     * @example s2.interaction.isEqualStateName(InteractionStateName.SELECTED)
+     */
+    isEqualStateName(stateName: `${InteractionStateName}`): boolean;
     private isStateOf;
+    /**
+     * 是否是选中状态 (含单选,多选,圈选,全选)
+     * @example s2.interaction.isSelectedState()
+     */
     isSelectedState(): boolean;
+    /**
+     * 是否是刷选状态
+     * @example s2.interaction.isBrushSelectedState()
+     */
+    isBrushSelectedState(): boolean;
+    /**
+     * 是否是全选状态
+     * @example s2.interaction.isAllSelectedState()
+     */
     isAllSelectedState(): boolean;
+    /**
+     * 是否是悬停聚焦状态
+     * @example s2.interaction.isHoverFocusState()
+     */
     isHoverFocusState(): boolean;
+    /**
+     * 是否是悬停状态
+     * @example s2.interaction.isHoverState()
+     */
     isHoverState(): boolean;
+    /**
+     * 是否是激活的单元格
+     * @example s2.interaction.isActiveCell(cell)
+     */
     isActiveCell(cell: S2CellType_2): boolean;
+    /**
+     * 是否是选中的单元格
+     * @example s2.interaction.isSelectedCell(cell)
+     */
     isSelectedCell(cell: S2CellType_2): boolean;
+    /**
+     * 获取当前 interaction 记录的 Cells 元信息列表，包括不在可视区域内的格子
+     * @example s2.interaction.getCells(CellType.DATA_CELL)
+     */
     getCells(cellType?: CellType[]): CellMeta[];
+    /**
+     * 获取已激活单元格 (不含非可视区域)
+     * @example s2.interaction.getActiveCells()
+     */
     getActiveCells(): S2CellType_2[];
     getActiveDataCells(): S2CellType_2[];
     getActiveRowCells(): S2CellType_2[];
     getActiveColCells(): S2CellType_2[];
+    /**
+     * 清除单元格交互样式
+     * @example s2.interaction.clearStyleIndependent()
+     */
     clearStyleIndependent(): void;
+    /**
+     * 获取未选中的单元格 (不含非可视区域)
+     * @example s2.interaction.getUnSelectedDataCells()
+     */
     getUnSelectedDataCells(): DataCell_2[];
-    selectAll: () => void;
-    selectHeaderCell: (selectHeaderCellInfo?: SelectHeaderCellInfo) => true | undefined;
+    private scrollToCellByMeta;
+    /**
+     * 滚动至指定位置
+     * @example
+     s2.interaction.scrollTo({
+     skipScrollEvent: false,
+     offsetX: { value: 100, animate: true },
+     offsetY: { value: 100, animate: true },
+     })
+     */
+    scrollTo(offsetConfig: ScrollOffsetConfig): void;
+    /**
+     * 滚动至指定单元格节点
+     * @example s2.interaction.scrollToNode(rowNode, { animate: true, skipScrollEvent: true })
+     */
+    scrollToNode(meta: ViewMeta_2 | Node_2_2, options?: CellScrollToOptions): void;
+    /**
+     * 滚动至指定单元格
+     * @example s2.interaction.scrollToNode(rowCell, { animate: true, skipScrollEvent: true })
+     */
+    scrollToCell(cell: S2CellType_2, options?: CellScrollToOptions): void;
+    /**
+     * 滚动至指定单元格 id 对应的位置
+     * @example s2.interaction.scrollToCellById('root[&]四川省[&]成都市', { animate: true, skipScrollEvent: true })
+     */
+    scrollToCellById(id: string, options?: CellScrollToOptions): void;
+    /**
+     * 滚动至顶部
+     * @example s2.interaction.scrollToTop({ animate: true, skipScrollEvent: true })
+     */
+    scrollToTop(options?: CellScrollToOptions): void;
+    /**
+     * 滚动至右边
+     * @example s2.interaction.scrollToRight({ animate: true, skipScrollEvent: true })
+     */
+    scrollToRight(options?: CellScrollToOptions): void;
+    /**
+     * 滚动至底部
+     * @example s2.interaction.scrollToBottom({ animate: true, skipScrollEvent: true })
+     */
+    scrollToBottom(options?: CellScrollToOptions): void;
+    /**
+     * 滚动至左边
+     * @example s2.interaction.scrollToLeft({ animate: true, skipScrollEvent: true })
+     */
+    scrollToLeft(options?: CellScrollToOptions): void;
+    /**
+     * 全选
+     * @example s2.interaction.selectAll()
+     */
+    selectAll(): void;
+    /**
+     * 高亮指定单元格 (可视范围内)
+     * @example s2.interaction.highlightCell(dataCell, options)
+     */
+    highlightCell(cell: S2CellType_2, options?: CellScrollToOptions): void;
+    /**
+     * 选中指定单元格 (可视范围内)
+     * @example s2.interaction.selectCell(dataCell, options)
+     */
+    selectCell(cell: S2CellType_2, options?: CellScrollToOptions): void;
+    /**
+     * 改变指定单元格状态 (如: 选中/高亮/多选等) (可视范围内)
+     * @example
+     s2.interaction.changeCell({
+     cell: rowCell,
+     stateName: InteractionStateName.SELECTED,
+     isMultiSelection: false,
+     scrollIntoView: false,
+     animate: true,
+     skipScrollEvent: true,
+     })
+     */
+    changeCell(options?: ChangeCellOptions): true | undefined;
+    /**
+     * 高亮节点对应的单元格
+     * @example s2.interaction.highlightNodes([node])
+     */
     highlightNodes: (nodes?: Node_2_2[]) => void;
+    /**
+     * 合并单元格
+     * @example s2.interaction.mergeCells()
+     */
     mergeCells: (cellsInfo?: MergedCellInfo[], hideData?: boolean) => void;
-    unmergeCell: (removedCells: MergedCell_2) => void;
+    /**
+     * 取消合并单元格
+     * @example s2.interaction.unmergeCell(mergedCell)
+     */
+    unmergeCell: (removedCell: MergedCell_2) => void;
+    /**
+     * 隐藏列头
+     * @example s2.interaction.hideColumns(['city'])
+     */
     hideColumns(hiddenColumnFields?: string[], forceRender?: boolean): Promise<void>;
     private getBrushSelectionInfo;
     private getDefaultInteractions;
@@ -4050,12 +4351,41 @@ declare class RootInteraction {
     private registerEventController;
     draw(): void;
     clearState(): void;
+    /**
+     * 改变单元格交互状态后，进行更新和重新绘制
+     * @example
+     s2.interaction.changeState({
+     cells: [{ id: 'city', colIndex: 1, rowIndex : 2, type: 'rowCell' }],
+     stateName: InteractionStateName.SELECTED,
+     force: false
+     })
+     */
     changeState(interactionStateInfo: InteractionStateInfo): void;
-    updatePanelGroupAllDataCells(): void;
+    /**
+     * 更新所有数值单元格
+     * @example s2.interaction.updateAllDataCells()
+     */
+    updateAllDataCells(): void;
+    /**
+     * 更新指定单元格
+     * @example s2.interaction.updateCells([rowCell, dataCell])
+     */
     updateCells(cells?: S2CellType_2[]): void;
-    addIntercepts(interceptTypes?: InterceptType[]): void;
-    hasIntercepts(interceptTypes?: InterceptType[]): boolean;
-    removeIntercepts(interceptTypes?: InterceptType[]): void;
+    /**
+     * 添加交互拦截
+     * @example s2.interaction.addIntercepts([InterceptType.HOVER])
+     */
+    addIntercepts(interceptTypes?: `${InterceptType}`[]): void;
+    /**
+     * 是否有指定交互拦截
+     * @example s2.interaction.hasIntercepts([InterceptType.HOVER])
+     */
+    hasIntercepts(interceptTypes?: `${InterceptType}`[]): boolean;
+    /**
+     * 移除交互拦截
+     * @example s2.interaction.removeIntercepts([InterceptType.HOVER])
+     */
+    removeIntercepts(interceptTypes?: `${InterceptType}`[]): void;
     clearHoverTimer(): void;
     setHoverTimer(timer: number): void;
     getHoverTimer(): number | null;
@@ -4066,9 +4396,12 @@ declare class RootInteraction {
     updateDataCellRelevantHeaderCells(stateName: InteractionStateName, meta: ViewMeta_2): void;
     updateDataCellRelevantRowCells(stateName: InteractionStateName, meta: ViewMeta_2): void;
     updateDataCellRelevantColCells(stateName: InteractionStateName, meta: ViewMeta_2): void;
+    emitSelectEvent(options: CellSelectedDetail_2 & {
+        cells?: S2CellType_2[];
+    }): void;
 }
 
-declare class RowCell extends HeaderCell<RowHeaderConfig> {
+declare class RowCell_2 extends HeaderCell<RowHeaderConfig> {
     get cellType(): CellType;
     protected getBorderPositions(): CellBorderPosition[];
     protected initCell(): void;
@@ -4088,7 +4421,6 @@ declare class RowCell extends HeaderCell<RowHeaderConfig> {
     protected drawTreeIcon(): void;
     protected drawTreeLeafNodeAlignDot(): void;
     protected isBolderText(): boolean;
-    drawTextShape(): void;
     protected drawResizeAreaInLeaf(): void;
     protected getHorizontalResizeAreaOffset(): {
         offsetX: number;
@@ -4121,17 +4453,19 @@ declare interface RowCellStyle extends BaseCellStyle, CellTextWordWrapStyle {
     showTreeLeafNodeAlignDot?: boolean;
     /**
      * 收起所有 (对应角头收起展开按钮)
+     * @description 优先级 `collapseFields` > `expandDepth` > `collapseAll`
      */
     collapseAll?: boolean | null;
     /**
      * 折叠节点
-     * 优先级大于 collapseAll 和 expandDepth
      * id 级别: { ['root[&]浙江省']: true, ['root[&]河南省']: false } 即 只有 浙江省 对应的节点才会被折叠
      * field 级别: { city: true, type: false } : 即 所有 city 对应的维值都会被折叠
+     * @description 优先级 `collapseFields` > `expandDepth` > `collapseAll`
      */
     collapseFields?: Record<string, boolean> | null;
     /**
-     * 行头默认展开到第几层 (从 0 开始)
+     * 行头节点默认展开到第几层 (从 0 开始)
+     * @description 优先级 `collapseFields` > `expandDepth` > `collapseAll`
      */
     expandDepth?: number | null;
 }
@@ -4141,11 +4475,11 @@ declare interface RowCellStyle extends BaseCellStyle, CellTextWordWrapStyle {
  */
 declare class RowHeader extends BaseHeader<RowHeaderConfig> {
     protected initGroups(): void;
-    getCellInstance(node: Node_2_2): RowCell | SeriesNumberCell_2;
+    getCellInstance(node: Node_2_2): RowCell_2 | SeriesNumberCell_2;
     protected isCellInRect(node: Node_2_2): boolean;
     protected getCellGroup(item: Node_2_2): Group;
     protected layout(): void;
-    protected emitRenderEvent(cell: RowCell | SeriesNumberCell_2): void;
+    protected emitRenderEvent(cell: RowCell_2 | SeriesNumberCell_2): void;
     protected offset(): void;
     protected clip(): void;
 }
@@ -4273,7 +4607,7 @@ declare interface S2BasicOptions<T = TooltipContentType_2, P = Pagination_2, Men
     /**
      * 设备类型: pc / mobile
      */
-    device?: DeviceType;
+    device?: `${DeviceType}`;
     /**
      * 自定义 AntV/G 渲染引擎配置参数 & 插件注册
      * @see https://g.antv.antgroup.com/plugins/intro
@@ -4291,7 +4625,7 @@ declare interface S2BasicOptions<T = TooltipContentType_2, P = Pagination_2, Men
      };
      },
      */
-    transformCanvasConfig?: (renderer: CanvasConfig['renderer'], spreadsheet: SpreadSheet_2) => (Partial<CanvasConfig> | null | undefined) | void;
+    transformCanvasConfig?: (renderer: Renderer, spreadsheet: SpreadSheet_2) => (Partial<CanvasConfig> | null | undefined) | void;
     /** *********** 自定义单元格 hooks **************** */
     /**
      * 自定义数值单元格
@@ -4312,7 +4646,7 @@ declare interface S2BasicOptions<T = TooltipContentType_2, P = Pagination_2, Men
      * 自定义行头单元格
      * @see https://s2.antv.antgroup.com/examples/custom/custom-cell#row-cell
      */
-    rowCell?: CellCallback<RowHeaderConfig, RowCell>;
+    rowCell?: CellCallback<RowHeaderConfig, RowCell_2>;
     /**
      * 自定义列头单元格
      * @see https://s2.antv.antgroup.com/examples/custom/custom-cell#col-cell
@@ -4372,11 +4706,12 @@ declare interface S2BasicOptions<T = TooltipContentType_2, P = Pagination_2, Men
     facet?: (spreadsheet: SpreadSheet_2) => BaseFacet;
 }
 
-declare type S2CellType_2<T extends SimpleBBox = ViewMeta_2> = DataCell_2 | HeaderCell | ColCell_2 | CornerCell_2 | RowCell | SeriesNumberCell_2 | MergedCell_2 | TableDataCell_2 | TableCornerCell | TableSeriesNumberCell | BaseCell<T>;
+declare type S2CellType_2<T extends SimpleBBox = ViewMeta_2> = DataCell_2 | HeaderCell | ColCell_2 | CornerCell_2 | RowCell_2 | SeriesNumberCell_2 | MergedCell_2 | TableDataCell_2 | TableCornerCell | TableSeriesNumberCell | BaseCell<T>;
 
 declare interface S2DataConfig_2 {
     /**
      * 原始明细数据
+     * @see https://assets.antv.antgroup.com/s2/basic.json
      */
     data: RawData_2[];
     /**
@@ -4385,14 +4720,18 @@ declare interface S2DataConfig_2 {
     fields: Fields;
     /**
      * 字段元数据
+     * @see https://s2.antv.antgroup.com/manual/basic/formatter
      */
     meta?: Meta[];
     /**
      * 排序配置
+     * @see https://s2.antv.antgroup.com/manual/basic/sort/basic
      */
     sortParams?: SortParams_2;
     /**
      * 筛选配置
+     * @see https://s2.antv.antgroup.com/api/general/s2-data-config#filterparam
+     * @example https://s2.antv.antgroup.com/examples/case/data-preview/#index
      */
     filterParams?: FilterParam[];
     [key: string]: unknown;
@@ -4412,6 +4751,7 @@ declare enum S2Event {
     ROW_CELL_COLLAPSED = "row-cell:collapsed",
     ROW_CELL_ALL_COLLAPSED = "row-cell:all-collapsed",
     ROW_CELL_RENDER = "row-cell:render",
+    ROW_CELL_SELECTED = "row-cell:selected",
     ROW_CELL_COLLAPSED__PRIVATE = "row-cell:collapsed__private",
     ROW_CELL_ALL_COLLAPSED__PRIVATE = "row-cell:all-collapsed__private",
     /** ================ Col Cell ================  */
@@ -4426,6 +4766,7 @@ declare enum S2Event {
     COL_CELL_EXPANDED = "col-cell:expanded",
     COL_CELL_HIDDEN = "col-cell:hidden",
     COL_CELL_RENDER = "col-cell:render",
+    COL_CELL_SELECTED = "col-cell:selected",
     /** ================ Data Cell ================  */
     DATA_CELL_HOVER = "data-cell:hover",
     DATA_CELL_CLICK = "data-cell:click",
@@ -4437,6 +4778,7 @@ declare enum S2Event {
     DATA_CELL_BRUSH_SELECTION = "data-cell:brush-selection",
     DATA_CELL_SELECT_MOVE = "data-cell:select-move",
     DATA_CELL_RENDER = "data-cell:render",
+    DATA_CELL_SELECTED = "data-cell:selected",
     /** ================ Corner Cell ================  */
     CORNER_CELL_HOVER = "corner-cell:hover",
     CORNER_CELL_CLICK = "corner-cell:click",
@@ -4446,6 +4788,7 @@ declare enum S2Event {
     CORNER_CELL_MOUSE_UP = "corner-cell:mouse-up",
     CORNER_CELL_MOUSE_MOVE = "corner-cell:mouse-move",
     CORNER_CELL_RENDER = "corner-cell:render",
+    CORNER_CELL_SELECTED = "corner-cell:selected",
     /** ================ Merged Cells ================  */
     MERGED_CELLS_HOVER = "merged-cells:hover",
     MERGED_CELLS_CLICK = "merged-cells:click",
@@ -4724,19 +5067,36 @@ declare interface ScrollOffset_2 {
     rowHeaderScrollX?: number;
 }
 
+declare interface ScrollOffsetConfig extends Pick<CellScrollToOptions, 'skipScrollEvent'> {
+    /**
+     * 行头水平偏移量
+     */
+    rowHeaderOffsetX?: {
+        value: number | undefined;
+        animate?: boolean;
+    };
+    /**
+     * 水平偏移量
+     */
+    offsetX?: {
+        value: number | undefined;
+        animate?: boolean;
+    };
+    /**
+     * 垂直偏移量
+     */
+    offsetY?: {
+        value: number | undefined;
+        animate?: boolean;
+    };
+}
+
 declare interface ScrollSpeedRatio {
     horizontal?: number;
     vertical?: number;
 }
 
-declare type SelectedHandler = (cells: S2CellType_2[]) => void;
-
-declare interface SelectHeaderCellInfo {
-    cell: S2CellType_2<ViewMeta_2>;
-    isMultiSelection?: boolean;
-}
-
-declare class SeriesNumberCell_2 extends RowCell {
+declare class SeriesNumberCell_2 extends RowCell_2 {
     get cellType(): CellType;
     protected getBorderPositions(): CellBorderPosition[];
     protected initCell(): void;
@@ -4788,7 +5148,7 @@ declare class SeriesNumberHeader extends RowHeader {
     protected emitRenderEvent(cell: SeriesNumberCell_2): void;
 }
 
-export declare const SheetComponent: DefineComponent<GetInitProps<SheetComponentProps, "sheetType" | "spreadsheet" | "options" | "loading" | "partDrillDown" | "adaptive" | "showPagination" | "themeCfg" | "header" | "onRowCellHover" | "onRowCellClick" | "onRowCellDoubleClick" | "onRowCellContextMenu" | "onRowCellMouseDown" | "onRowCellMouseUp" | "onRowCellMouseMove" | "onRowCellCollapsed" | "onRowCellAllCollapsed" | "onRowCellScroll" | "onRowCellRender" | "onColCellHover" | "onColCellClick" | "onColCellDoubleClick" | "onColCellContextMenu" | "onColCellMouseDown" | "onColCellMouseUp" | "onColCellMouseMove" | "onColCellExpanded" | "onColCellHidden" | "onColCellRender" | "onDataCellHover" | "onDataCellClick" | "onDataCellDoubleClick" | "onDataCellContextMenu" | "onDataCellMouseDown" | "onDataCellMouseUp" | "onDataCellMouseMove" | "onDataCellBrushSelection" | "onDataCellSelectMove" | "onDataCellRender" | "onDataCellEditStart" | "onDataCellEditEnd" | "onCornerCellHover" | "onCornerCellClick" | "onCornerCellDoubleClick" | "onCornerCellContextMenu" | "onCornerCellMouseDown" | "onCornerCellMouseUp" | "onCornerCellMouseMove" | "onCornerCellRender" | "onMergedCellsHover" | "onMergedCellsClick" | "onMergedCellsDoubleClick" | "onMergedCellsContextMenu" | "onMergedCellsMouseDown" | "onMergedCellsMouseUp" | "onMergedCellsMouseMove" | "onMergedCellsRender" | "onSeriesNumberCellRender" | "onRangeSort" | "onRangeSorted" | "onRangeFilter" | "onRangeFiltered" | "onLayoutAfterHeaderLayout" | "onLayoutPagination" | "onLayoutCellRender" | "onBeforeRender" | "onAfterRender" | "onMounted" | "onUpdate" | "onUpdateAfterRender" | "onDestroy" | "onLayoutResize" | "onLayoutResizeSeriesWidth" | "onLayoutResizeRowWidth" | "onLayoutResizeRowHeight" | "onLayoutResizeColWidth" | "onLayoutResizeColHeight" | "onLayoutResizeTreeWidth" | "onLayoutResizeMouseDown" | "onLayoutResizeMouseUp" | "onLayoutResizeMouseMove" | "onKeyBoardDown" | "onKeyBoardUp" | "onCopied" | "onActionIconHover" | "onActionIconHoverOff" | "onActionIconClick" | "onContextMenu" | "onClick" | "onHover" | "onDoubleClick" | "onMouseHover" | "onMouseUp" | "onMouseDown" | "onMouseMove" | "onSelected" | "onReset" | "onLinkFieldJump" | "onScroll" | "onLayoutAfterRealDataCellRender" | "onRowCellBrushSelection" | "onColCellBrushSelection">, {
+export declare const SheetComponent: DefineComponent<GetInitProps<SheetComponentProps, "sheetType" | "spreadsheet" | "options" | "loading" | "partDrillDown" | "adaptive" | "showPagination" | "themeCfg" | "header" | "onRowCellHover" | "onRowCellClick" | "onRowCellDoubleClick" | "onRowCellContextMenu" | "onRowCellMouseDown" | "onRowCellMouseUp" | "onRowCellMouseMove" | "onRowCellCollapsed" | "onRowCellAllCollapsed" | "onRowCellScroll" | "onRowCellRender" | "onRowCellSelected" | "onColCellHover" | "onColCellClick" | "onColCellDoubleClick" | "onColCellContextMenu" | "onColCellMouseDown" | "onColCellMouseUp" | "onColCellMouseMove" | "onColCellExpanded" | "onColCellHidden" | "onColCellRender" | "onColCellSelected" | "onDataCellHover" | "onDataCellClick" | "onDataCellDoubleClick" | "onDataCellContextMenu" | "onDataCellMouseDown" | "onDataCellMouseUp" | "onDataCellMouseMove" | "onDataCellBrushSelection" | "onDataCellSelectMove" | "onDataCellRender" | "onDataCellEditStart" | "onDataCellEditEnd" | "onDataCellSelected" | "onCornerCellHover" | "onCornerCellClick" | "onCornerCellDoubleClick" | "onCornerCellContextMenu" | "onCornerCellMouseDown" | "onCornerCellMouseUp" | "onCornerCellMouseMove" | "onCornerCellRender" | "onCornerCellSelected" | "onMergedCellsHover" | "onMergedCellsClick" | "onMergedCellsDoubleClick" | "onMergedCellsContextMenu" | "onMergedCellsMouseDown" | "onMergedCellsMouseUp" | "onMergedCellsMouseMove" | "onMergedCellsRender" | "onSeriesNumberCellRender" | "onRangeSort" | "onRangeSorted" | "onRangeFilter" | "onRangeFiltered" | "onLayoutAfterHeaderLayout" | "onLayoutPagination" | "onLayoutCellRender" | "onBeforeRender" | "onAfterRender" | "onMounted" | "onUpdate" | "onUpdateAfterRender" | "onDestroy" | "onLayoutResize" | "onLayoutResizeSeriesWidth" | "onLayoutResizeRowWidth" | "onLayoutResizeRowHeight" | "onLayoutResizeColWidth" | "onLayoutResizeColHeight" | "onLayoutResizeTreeWidth" | "onLayoutResizeMouseDown" | "onLayoutResizeMouseUp" | "onLayoutResizeMouseMove" | "onKeyBoardDown" | "onKeyBoardUp" | "onCopied" | "onActionIconHover" | "onActionIconHoverOff" | "onActionIconClick" | "onContextMenu" | "onClick" | "onHover" | "onDoubleClick" | "onMouseHover" | "onMouseUp" | "onMouseDown" | "onMouseMove" | "onSelected" | "onReset" | "onLinkFieldJump" | "onScroll" | "onLayoutAfterRealDataCellRender" | "onRowCellBrushSelection" | "onColCellBrushSelection">, {
 s2Ref: ShallowRef<SheetExpose>;
 sheetType: ComputedRef<DefineComponent<    {
 sheetType: PropType<SheetType>;
@@ -4834,7 +5194,8 @@ rowCellMouseMove: (data: TargetCellInfo_2) => void;
 rowCellCollapsed: (params: RowCellCollapsedParams_2) => void;
 rowCellAllCollapsed: (isCollapsed: boolean) => void;
 rowCellScroll: (position: Required<ScrollOffset_2>) => void;
-rowCellRender: (cell: ColCell_2) => void;
+rowCellRender: (cell: RowCell_2) => void;
+rowCellSelected: CellSelectedHandler_2;
 colCellHover: (data: TargetCellInfo_2) => void;
 colCellClick: (data: TargetCellInfo_2) => void;
 colCellDoubleClick: (data: TargetCellInfo_2) => void;
@@ -4848,6 +5209,7 @@ currentHiddenColumnsInfo: HiddenColumnsInfo_2;
 hiddenColumnsDetail: HiddenColumnsInfo_2[];
 }) => void;
 colCellRender: (cell: ColCell_2) => void;
+colCellSelected: CellSelectedHandler_2;
 dataCellHover: (data: TargetCellInfo_2) => void;
 dataCellClick: (data: TargetCellInfo_2) => void;
 dataCellDoubleClick: (data: TargetCellInfo_2) => void;
@@ -4860,6 +5222,7 @@ dataCellSelectMove: (metaList: ViewMetaData_2[]) => void;
 dataCellRender: (cell: DataCell_2) => void;
 dataCellEditStart: (meta: ViewMeta_2, cell: TableDataCell_2) => void;
 dataCellEditEnd: (meta: ViewMeta_2, cell: TableDataCell_2) => void;
+dataCellSelected: CellSelectedHandler_2;
 cornerCellHover: (data: TargetCellInfo_2) => void;
 cornerCellClick: (data: TargetCellInfo_2) => void;
 cornerCellDoubleClick: (data: TargetCellInfo_2) => void;
@@ -4868,6 +5231,7 @@ cornerCellMouseDown: (data: TargetCellInfo_2) => void;
 cornerCellMouseUp: (data: TargetCellInfo_2) => void;
 cornerCellMouseMove: (data: TargetCellInfo_2) => void;
 cornerCellRender: (cell: CornerCell_2) => void;
+cornerCellSelected: CellSelectedHandler_2;
 mergedCellsHover: (data: TargetCellInfo_2) => void;
 mergedCellsClick: (data: TargetCellInfo_2) => void;
 mergedCellsDoubleClick: (data: TargetCellInfo_2) => void;
@@ -4926,7 +5290,7 @@ mouseHover: (event: FederatedPointerEvent) => void;
 mouseUp: (event: MouseEvent) => void;
 mouseDown: (event: MouseEvent) => void;
 mouseMove: (event: MouseEvent) => void;
-selected: (cells: S2CellType_2[]) => void;
+selected: CellSelectedHandler_2;
 reset: (event: KeyboardEvent) => void;
 linkFieldJump: (data: {
 field: string;
@@ -4980,7 +5344,8 @@ onRowCellMouseMove?: (data: TargetCellInfo_2) => any;
 onRowCellCollapsed?: (params: RowCellCollapsedParams_2) => any;
 onRowCellAllCollapsed?: (isCollapsed: boolean) => any;
 onRowCellScroll?: (position: Required<ScrollOffset_2>) => any;
-onRowCellRender?: (cell: ColCell_2) => any;
+onRowCellRender?: (cell: RowCell_2) => any;
+onRowCellSelected?: (cells: S2CellType_2<ViewMeta_2>[], detail: CellSelectedDetail_2) => any;
 onColCellHover?: (data: TargetCellInfo_2) => any;
 onColCellClick?: (data: TargetCellInfo_2) => any;
 onColCellDoubleClick?: (data: TargetCellInfo_2) => any;
@@ -4994,6 +5359,7 @@ currentHiddenColumnsInfo: HiddenColumnsInfo_2;
 hiddenColumnsDetail: HiddenColumnsInfo_2[];
 }) => any;
 onColCellRender?: (cell: ColCell_2) => any;
+onColCellSelected?: (cells: S2CellType_2<ViewMeta_2>[], detail: CellSelectedDetail_2) => any;
 onDataCellHover?: (data: TargetCellInfo_2) => any;
 onDataCellClick?: (data: TargetCellInfo_2) => any;
 onDataCellDoubleClick?: (data: TargetCellInfo_2) => any;
@@ -5006,6 +5372,7 @@ onDataCellSelectMove?: (metaList: ViewMetaData_2[]) => any;
 onDataCellRender?: (cell: DataCell_2) => any;
 onDataCellEditStart?: (meta: ViewMeta_2, cell: TableDataCell_2) => any;
 onDataCellEditEnd?: (meta: ViewMeta_2, cell: TableDataCell_2) => any;
+onDataCellSelected?: (cells: S2CellType_2<ViewMeta_2>[], detail: CellSelectedDetail_2) => any;
 onCornerCellHover?: (data: TargetCellInfo_2) => any;
 onCornerCellClick?: (data: TargetCellInfo_2) => any;
 onCornerCellDoubleClick?: (data: TargetCellInfo_2) => any;
@@ -5014,6 +5381,7 @@ onCornerCellMouseDown?: (data: TargetCellInfo_2) => any;
 onCornerCellMouseUp?: (data: TargetCellInfo_2) => any;
 onCornerCellMouseMove?: (data: TargetCellInfo_2) => any;
 onCornerCellRender?: (cell: CornerCell_2) => any;
+onCornerCellSelected?: (cells: S2CellType_2<ViewMeta_2>[], detail: CellSelectedDetail_2) => any;
 onMergedCellsHover?: (data: TargetCellInfo_2) => any;
 onMergedCellsClick?: (data: TargetCellInfo_2) => any;
 onMergedCellsDoubleClick?: (data: TargetCellInfo_2) => any;
@@ -5072,7 +5440,7 @@ onMouseHover?: (event: FederatedPointerEvent) => any;
 onMouseUp?: (event: MouseEvent) => any;
 onMouseDown?: (event: MouseEvent) => any;
 onMouseMove?: (event: MouseEvent) => any;
-onSelected?: (cells: S2CellType_2[]) => any;
+onSelected?: (cells: S2CellType_2<ViewMeta_2>[], detail: CellSelectedDetail_2) => any;
 onReset?: (event: KeyboardEvent) => any;
 onLinkFieldJump?: (data: {
 field: string;
@@ -5099,7 +5467,7 @@ showPagination: boolean | {
 onShowSizeChange?: (pageSize: number) => void;
 onChange?: (current: number) => void;
 };
-}, {}> | DefineComponent<GetInitProps<SheetComponentProps, "sheetType" | "spreadsheet" | "options" | "loading" | "partDrillDown" | "adaptive" | "showPagination" | "themeCfg" | "header" | "onRowCellHover" | "onRowCellClick" | "onRowCellDoubleClick" | "onRowCellContextMenu" | "onRowCellMouseDown" | "onRowCellMouseUp" | "onRowCellMouseMove" | "onRowCellCollapsed" | "onRowCellAllCollapsed" | "onRowCellScroll" | "onRowCellRender" | "onColCellHover" | "onColCellClick" | "onColCellDoubleClick" | "onColCellContextMenu" | "onColCellMouseDown" | "onColCellMouseUp" | "onColCellMouseMove" | "onColCellExpanded" | "onColCellHidden" | "onColCellRender" | "onDataCellHover" | "onDataCellClick" | "onDataCellDoubleClick" | "onDataCellContextMenu" | "onDataCellMouseDown" | "onDataCellMouseUp" | "onDataCellMouseMove" | "onDataCellBrushSelection" | "onDataCellSelectMove" | "onDataCellRender" | "onDataCellEditStart" | "onDataCellEditEnd" | "onCornerCellHover" | "onCornerCellClick" | "onCornerCellDoubleClick" | "onCornerCellContextMenu" | "onCornerCellMouseDown" | "onCornerCellMouseUp" | "onCornerCellMouseMove" | "onCornerCellRender" | "onMergedCellsHover" | "onMergedCellsClick" | "onMergedCellsDoubleClick" | "onMergedCellsContextMenu" | "onMergedCellsMouseDown" | "onMergedCellsMouseUp" | "onMergedCellsMouseMove" | "onMergedCellsRender" | "onSeriesNumberCellRender" | "onRangeSort" | "onRangeSorted" | "onRangeFilter" | "onRangeFiltered" | "onLayoutAfterHeaderLayout" | "onLayoutPagination" | "onLayoutCellRender" | "onBeforeRender" | "onAfterRender" | "onMounted" | "onUpdate" | "onUpdateAfterRender" | "onDestroy" | "onLayoutResize" | "onLayoutResizeSeriesWidth" | "onLayoutResizeRowWidth" | "onLayoutResizeRowHeight" | "onLayoutResizeColWidth" | "onLayoutResizeColHeight" | "onLayoutResizeTreeWidth" | "onLayoutResizeMouseDown" | "onLayoutResizeMouseUp" | "onLayoutResizeMouseMove" | "onKeyBoardDown" | "onKeyBoardUp" | "onCopied" | "onActionIconHover" | "onActionIconHoverOff" | "onActionIconClick" | "onContextMenu" | "onClick" | "onHover" | "onDoubleClick" | "onMouseHover" | "onMouseUp" | "onMouseDown" | "onMouseMove" | "onSelected" | "onReset" | "onLinkFieldJump" | "onScroll" | "onLayoutAfterRealDataCellRender" | "onRowCellBrushSelection" | "onColCellBrushSelection">, {
+}, {}> | DefineComponent<GetInitProps<SheetComponentProps, "sheetType" | "spreadsheet" | "options" | "loading" | "partDrillDown" | "adaptive" | "showPagination" | "themeCfg" | "header" | "onRowCellHover" | "onRowCellClick" | "onRowCellDoubleClick" | "onRowCellContextMenu" | "onRowCellMouseDown" | "onRowCellMouseUp" | "onRowCellMouseMove" | "onRowCellCollapsed" | "onRowCellAllCollapsed" | "onRowCellScroll" | "onRowCellRender" | "onRowCellSelected" | "onColCellHover" | "onColCellClick" | "onColCellDoubleClick" | "onColCellContextMenu" | "onColCellMouseDown" | "onColCellMouseUp" | "onColCellMouseMove" | "onColCellExpanded" | "onColCellHidden" | "onColCellRender" | "onColCellSelected" | "onDataCellHover" | "onDataCellClick" | "onDataCellDoubleClick" | "onDataCellContextMenu" | "onDataCellMouseDown" | "onDataCellMouseUp" | "onDataCellMouseMove" | "onDataCellBrushSelection" | "onDataCellSelectMove" | "onDataCellRender" | "onDataCellEditStart" | "onDataCellEditEnd" | "onDataCellSelected" | "onCornerCellHover" | "onCornerCellClick" | "onCornerCellDoubleClick" | "onCornerCellContextMenu" | "onCornerCellMouseDown" | "onCornerCellMouseUp" | "onCornerCellMouseMove" | "onCornerCellRender" | "onCornerCellSelected" | "onMergedCellsHover" | "onMergedCellsClick" | "onMergedCellsDoubleClick" | "onMergedCellsContextMenu" | "onMergedCellsMouseDown" | "onMergedCellsMouseUp" | "onMergedCellsMouseMove" | "onMergedCellsRender" | "onSeriesNumberCellRender" | "onRangeSort" | "onRangeSorted" | "onRangeFilter" | "onRangeFiltered" | "onLayoutAfterHeaderLayout" | "onLayoutPagination" | "onLayoutCellRender" | "onBeforeRender" | "onAfterRender" | "onMounted" | "onUpdate" | "onUpdateAfterRender" | "onDestroy" | "onLayoutResize" | "onLayoutResizeSeriesWidth" | "onLayoutResizeRowWidth" | "onLayoutResizeRowHeight" | "onLayoutResizeColWidth" | "onLayoutResizeColHeight" | "onLayoutResizeTreeWidth" | "onLayoutResizeMouseDown" | "onLayoutResizeMouseUp" | "onLayoutResizeMouseMove" | "onKeyBoardDown" | "onKeyBoardUp" | "onCopied" | "onActionIconHover" | "onActionIconHoverOff" | "onActionIconClick" | "onContextMenu" | "onClick" | "onHover" | "onDoubleClick" | "onMouseHover" | "onMouseUp" | "onMouseDown" | "onMouseMove" | "onSelected" | "onReset" | "onLinkFieldJump" | "onScroll" | "onLayoutAfterRealDataCellRender" | "onRowCellBrushSelection" | "onColCellBrushSelection">, {
 s2Ref: ShallowRef<SheetExpose>;
 }, unknown, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
 spreadsheet: (container: S2MountContainer_2, dataCfg: S2DataConfig_2, options: S2Options_2<TooltipContentType_2, Pagination_2, BaseTooltipOperatorMenuOptions_2>) => SpreadSheet_2;
@@ -5113,7 +5481,8 @@ rowCellMouseMove: (data: TargetCellInfo_2) => void;
 rowCellCollapsed: (params: RowCellCollapsedParams_2) => void;
 rowCellAllCollapsed: (isCollapsed: boolean) => void;
 rowCellScroll: (position: Required<ScrollOffset_2>) => void;
-rowCellRender: (cell: ColCell_2) => void;
+rowCellRender: (cell: RowCell_2) => void;
+rowCellSelected: CellSelectedHandler_2;
 colCellHover: (data: TargetCellInfo_2) => void;
 colCellClick: (data: TargetCellInfo_2) => void;
 colCellDoubleClick: (data: TargetCellInfo_2) => void;
@@ -5127,6 +5496,7 @@ currentHiddenColumnsInfo: HiddenColumnsInfo_2;
 hiddenColumnsDetail: HiddenColumnsInfo_2[];
 }) => void;
 colCellRender: (cell: ColCell_2) => void;
+colCellSelected: CellSelectedHandler_2;
 dataCellHover: (data: TargetCellInfo_2) => void;
 dataCellClick: (data: TargetCellInfo_2) => void;
 dataCellDoubleClick: (data: TargetCellInfo_2) => void;
@@ -5139,6 +5509,7 @@ dataCellSelectMove: (metaList: ViewMetaData_2[]) => void;
 dataCellRender: (cell: DataCell_2) => void;
 dataCellEditStart: (meta: ViewMeta_2, cell: TableDataCell_2) => void;
 dataCellEditEnd: (meta: ViewMeta_2, cell: TableDataCell_2) => void;
+dataCellSelected: CellSelectedHandler_2;
 cornerCellHover: (data: TargetCellInfo_2) => void;
 cornerCellClick: (data: TargetCellInfo_2) => void;
 cornerCellDoubleClick: (data: TargetCellInfo_2) => void;
@@ -5147,6 +5518,7 @@ cornerCellMouseDown: (data: TargetCellInfo_2) => void;
 cornerCellMouseUp: (data: TargetCellInfo_2) => void;
 cornerCellMouseMove: (data: TargetCellInfo_2) => void;
 cornerCellRender: (cell: CornerCell_2) => void;
+cornerCellSelected: CellSelectedHandler_2;
 mergedCellsHover: (data: TargetCellInfo_2) => void;
 mergedCellsClick: (data: TargetCellInfo_2) => void;
 mergedCellsDoubleClick: (data: TargetCellInfo_2) => void;
@@ -5205,7 +5577,7 @@ mouseHover: (event: FederatedPointerEvent) => void;
 mouseUp: (event: MouseEvent) => void;
 mouseDown: (event: MouseEvent) => void;
 mouseMove: (event: MouseEvent) => void;
-selected: (cells: S2CellType_2[]) => void;
+selected: CellSelectedHandler_2;
 reset: (event: KeyboardEvent) => void;
 linkFieldJump: (data: {
 field: string;
@@ -5219,7 +5591,7 @@ spreadsheet: SpreadSheet_2;
 }) => void;
 rowCellBrushSelection: (event: FederatedPointerEvent) => void;
 colCellBrushSelection: (event: FederatedPointerEvent) => void;
-}, string, PublicProps, Readonly<ExtractPropTypes<GetInitProps<SheetComponentProps, "sheetType" | "spreadsheet" | "options" | "loading" | "partDrillDown" | "adaptive" | "showPagination" | "themeCfg" | "header" | "onRowCellHover" | "onRowCellClick" | "onRowCellDoubleClick" | "onRowCellContextMenu" | "onRowCellMouseDown" | "onRowCellMouseUp" | "onRowCellMouseMove" | "onRowCellCollapsed" | "onRowCellAllCollapsed" | "onRowCellScroll" | "onRowCellRender" | "onColCellHover" | "onColCellClick" | "onColCellDoubleClick" | "onColCellContextMenu" | "onColCellMouseDown" | "onColCellMouseUp" | "onColCellMouseMove" | "onColCellExpanded" | "onColCellHidden" | "onColCellRender" | "onDataCellHover" | "onDataCellClick" | "onDataCellDoubleClick" | "onDataCellContextMenu" | "onDataCellMouseDown" | "onDataCellMouseUp" | "onDataCellMouseMove" | "onDataCellBrushSelection" | "onDataCellSelectMove" | "onDataCellRender" | "onDataCellEditStart" | "onDataCellEditEnd" | "onCornerCellHover" | "onCornerCellClick" | "onCornerCellDoubleClick" | "onCornerCellContextMenu" | "onCornerCellMouseDown" | "onCornerCellMouseUp" | "onCornerCellMouseMove" | "onCornerCellRender" | "onMergedCellsHover" | "onMergedCellsClick" | "onMergedCellsDoubleClick" | "onMergedCellsContextMenu" | "onMergedCellsMouseDown" | "onMergedCellsMouseUp" | "onMergedCellsMouseMove" | "onMergedCellsRender" | "onSeriesNumberCellRender" | "onRangeSort" | "onRangeSorted" | "onRangeFilter" | "onRangeFiltered" | "onLayoutAfterHeaderLayout" | "onLayoutPagination" | "onLayoutCellRender" | "onBeforeRender" | "onAfterRender" | "onMounted" | "onUpdate" | "onUpdateAfterRender" | "onDestroy" | "onLayoutResize" | "onLayoutResizeSeriesWidth" | "onLayoutResizeRowWidth" | "onLayoutResizeRowHeight" | "onLayoutResizeColWidth" | "onLayoutResizeColHeight" | "onLayoutResizeTreeWidth" | "onLayoutResizeMouseDown" | "onLayoutResizeMouseUp" | "onLayoutResizeMouseMove" | "onKeyBoardDown" | "onKeyBoardUp" | "onCopied" | "onActionIconHover" | "onActionIconHoverOff" | "onActionIconClick" | "onContextMenu" | "onClick" | "onHover" | "onDoubleClick" | "onMouseHover" | "onMouseUp" | "onMouseDown" | "onMouseMove" | "onSelected" | "onReset" | "onLinkFieldJump" | "onScroll" | "onLayoutAfterRealDataCellRender" | "onRowCellBrushSelection" | "onColCellBrushSelection">>> & {
+}, string, PublicProps, Readonly<ExtractPropTypes<GetInitProps<SheetComponentProps, "sheetType" | "spreadsheet" | "options" | "loading" | "partDrillDown" | "adaptive" | "showPagination" | "themeCfg" | "header" | "onRowCellHover" | "onRowCellClick" | "onRowCellDoubleClick" | "onRowCellContextMenu" | "onRowCellMouseDown" | "onRowCellMouseUp" | "onRowCellMouseMove" | "onRowCellCollapsed" | "onRowCellAllCollapsed" | "onRowCellScroll" | "onRowCellRender" | "onRowCellSelected" | "onColCellHover" | "onColCellClick" | "onColCellDoubleClick" | "onColCellContextMenu" | "onColCellMouseDown" | "onColCellMouseUp" | "onColCellMouseMove" | "onColCellExpanded" | "onColCellHidden" | "onColCellRender" | "onColCellSelected" | "onDataCellHover" | "onDataCellClick" | "onDataCellDoubleClick" | "onDataCellContextMenu" | "onDataCellMouseDown" | "onDataCellMouseUp" | "onDataCellMouseMove" | "onDataCellBrushSelection" | "onDataCellSelectMove" | "onDataCellRender" | "onDataCellEditStart" | "onDataCellEditEnd" | "onDataCellSelected" | "onCornerCellHover" | "onCornerCellClick" | "onCornerCellDoubleClick" | "onCornerCellContextMenu" | "onCornerCellMouseDown" | "onCornerCellMouseUp" | "onCornerCellMouseMove" | "onCornerCellRender" | "onCornerCellSelected" | "onMergedCellsHover" | "onMergedCellsClick" | "onMergedCellsDoubleClick" | "onMergedCellsContextMenu" | "onMergedCellsMouseDown" | "onMergedCellsMouseUp" | "onMergedCellsMouseMove" | "onMergedCellsRender" | "onSeriesNumberCellRender" | "onRangeSort" | "onRangeSorted" | "onRangeFilter" | "onRangeFiltered" | "onLayoutAfterHeaderLayout" | "onLayoutPagination" | "onLayoutCellRender" | "onBeforeRender" | "onAfterRender" | "onMounted" | "onUpdate" | "onUpdateAfterRender" | "onDestroy" | "onLayoutResize" | "onLayoutResizeSeriesWidth" | "onLayoutResizeRowWidth" | "onLayoutResizeRowHeight" | "onLayoutResizeColWidth" | "onLayoutResizeColHeight" | "onLayoutResizeTreeWidth" | "onLayoutResizeMouseDown" | "onLayoutResizeMouseUp" | "onLayoutResizeMouseMove" | "onKeyBoardDown" | "onKeyBoardUp" | "onCopied" | "onActionIconHover" | "onActionIconHoverOff" | "onActionIconClick" | "onContextMenu" | "onClick" | "onHover" | "onDoubleClick" | "onMouseHover" | "onMouseUp" | "onMouseDown" | "onMouseMove" | "onSelected" | "onReset" | "onLinkFieldJump" | "onScroll" | "onLayoutAfterRealDataCellRender" | "onRowCellBrushSelection" | "onColCellBrushSelection">>> & {
 onRowCellHover?: (data: TargetCellInfo_2) => any;
 onRowCellClick?: (data: TargetCellInfo_2) => any;
 onRowCellDoubleClick?: (data: TargetCellInfo_2) => any;
@@ -5230,7 +5602,8 @@ onRowCellMouseMove?: (data: TargetCellInfo_2) => any;
 onRowCellCollapsed?: (params: RowCellCollapsedParams_2) => any;
 onRowCellAllCollapsed?: (isCollapsed: boolean) => any;
 onRowCellScroll?: (position: Required<ScrollOffset_2>) => any;
-onRowCellRender?: (cell: ColCell_2) => any;
+onRowCellRender?: (cell: RowCell_2) => any;
+onRowCellSelected?: (cells: S2CellType_2<ViewMeta_2>[], detail: CellSelectedDetail_2) => any;
 onColCellHover?: (data: TargetCellInfo_2) => any;
 onColCellClick?: (data: TargetCellInfo_2) => any;
 onColCellDoubleClick?: (data: TargetCellInfo_2) => any;
@@ -5244,6 +5617,7 @@ currentHiddenColumnsInfo: HiddenColumnsInfo_2;
 hiddenColumnsDetail: HiddenColumnsInfo_2[];
 }) => any;
 onColCellRender?: (cell: ColCell_2) => any;
+onColCellSelected?: (cells: S2CellType_2<ViewMeta_2>[], detail: CellSelectedDetail_2) => any;
 onDataCellHover?: (data: TargetCellInfo_2) => any;
 onDataCellClick?: (data: TargetCellInfo_2) => any;
 onDataCellDoubleClick?: (data: TargetCellInfo_2) => any;
@@ -5256,6 +5630,7 @@ onDataCellSelectMove?: (metaList: ViewMetaData_2[]) => any;
 onDataCellRender?: (cell: DataCell_2) => any;
 onDataCellEditStart?: (meta: ViewMeta_2, cell: TableDataCell_2) => any;
 onDataCellEditEnd?: (meta: ViewMeta_2, cell: TableDataCell_2) => any;
+onDataCellSelected?: (cells: S2CellType_2<ViewMeta_2>[], detail: CellSelectedDetail_2) => any;
 onCornerCellHover?: (data: TargetCellInfo_2) => any;
 onCornerCellClick?: (data: TargetCellInfo_2) => any;
 onCornerCellDoubleClick?: (data: TargetCellInfo_2) => any;
@@ -5264,6 +5639,7 @@ onCornerCellMouseDown?: (data: TargetCellInfo_2) => any;
 onCornerCellMouseUp?: (data: TargetCellInfo_2) => any;
 onCornerCellMouseMove?: (data: TargetCellInfo_2) => any;
 onCornerCellRender?: (cell: CornerCell_2) => any;
+onCornerCellSelected?: (cells: S2CellType_2<ViewMeta_2>[], detail: CellSelectedDetail_2) => any;
 onMergedCellsHover?: (data: TargetCellInfo_2) => any;
 onMergedCellsClick?: (data: TargetCellInfo_2) => any;
 onMergedCellsDoubleClick?: (data: TargetCellInfo_2) => any;
@@ -5322,7 +5698,7 @@ onMouseHover?: (event: FederatedPointerEvent) => any;
 onMouseUp?: (event: MouseEvent) => any;
 onMouseDown?: (event: MouseEvent) => any;
 onMouseMove?: (event: MouseEvent) => any;
-onSelected?: (cells: S2CellType_2[]) => any;
+onSelected?: (cells: S2CellType_2<ViewMeta_2>[], detail: CellSelectedDetail_2) => any;
 onReset?: (event: KeyboardEvent) => any;
 onLinkFieldJump?: (data: {
 field: string;
@@ -5350,7 +5726,8 @@ rowCellMouseMove: (data: TargetCellInfo_2) => void;
 rowCellCollapsed: (params: RowCellCollapsedParams_2) => void;
 rowCellAllCollapsed: (isCollapsed: boolean) => void;
 rowCellScroll: (position: Required<ScrollOffset_2>) => void;
-rowCellRender: (cell: ColCell_2) => void;
+rowCellRender: (cell: RowCell_2) => void;
+rowCellSelected: CellSelectedHandler_2;
 colCellHover: (data: TargetCellInfo_2) => void;
 colCellClick: (data: TargetCellInfo_2) => void;
 colCellDoubleClick: (data: TargetCellInfo_2) => void;
@@ -5364,6 +5741,7 @@ currentHiddenColumnsInfo: HiddenColumnsInfo_2;
 hiddenColumnsDetail: HiddenColumnsInfo_2[];
 }) => void;
 colCellRender: (cell: ColCell_2) => void;
+colCellSelected: CellSelectedHandler_2;
 dataCellHover: (data: TargetCellInfo_2) => void;
 dataCellClick: (data: TargetCellInfo_2) => void;
 dataCellDoubleClick: (data: TargetCellInfo_2) => void;
@@ -5376,6 +5754,7 @@ dataCellSelectMove: (metaList: ViewMetaData_2[]) => void;
 dataCellRender: (cell: DataCell_2) => void;
 dataCellEditStart: (meta: ViewMeta_2, cell: TableDataCell_2) => void;
 dataCellEditEnd: (meta: ViewMeta_2, cell: TableDataCell_2) => void;
+dataCellSelected: CellSelectedHandler_2;
 cornerCellHover: (data: TargetCellInfo_2) => void;
 cornerCellClick: (data: TargetCellInfo_2) => void;
 cornerCellDoubleClick: (data: TargetCellInfo_2) => void;
@@ -5384,6 +5763,7 @@ cornerCellMouseDown: (data: TargetCellInfo_2) => void;
 cornerCellMouseUp: (data: TargetCellInfo_2) => void;
 cornerCellMouseMove: (data: TargetCellInfo_2) => void;
 cornerCellRender: (cell: CornerCell_2) => void;
+cornerCellSelected: CellSelectedHandler_2;
 mergedCellsHover: (data: TargetCellInfo_2) => void;
 mergedCellsClick: (data: TargetCellInfo_2) => void;
 mergedCellsDoubleClick: (data: TargetCellInfo_2) => void;
@@ -5442,7 +5822,7 @@ mouseHover: (event: FederatedPointerEvent) => void;
 mouseUp: (event: MouseEvent) => void;
 mouseDown: (event: MouseEvent) => void;
 mouseMove: (event: MouseEvent) => void;
-selected: (cells: S2CellType_2[]) => void;
+selected: CellSelectedHandler_2;
 reset: (event: KeyboardEvent) => void;
 linkFieldJump: (data: {
 field: string;
@@ -5456,7 +5836,7 @@ spreadsheet: SpreadSheet_2;
 }) => void;
 rowCellBrushSelection: (event: FederatedPointerEvent) => void;
 colCellBrushSelection: (event: FederatedPointerEvent) => void;
-}, string, PublicProps, Readonly<ExtractPropTypes<GetInitProps<SheetComponentProps, "sheetType" | "spreadsheet" | "options" | "loading" | "partDrillDown" | "adaptive" | "showPagination" | "themeCfg" | "header" | "onRowCellHover" | "onRowCellClick" | "onRowCellDoubleClick" | "onRowCellContextMenu" | "onRowCellMouseDown" | "onRowCellMouseUp" | "onRowCellMouseMove" | "onRowCellCollapsed" | "onRowCellAllCollapsed" | "onRowCellScroll" | "onRowCellRender" | "onColCellHover" | "onColCellClick" | "onColCellDoubleClick" | "onColCellContextMenu" | "onColCellMouseDown" | "onColCellMouseUp" | "onColCellMouseMove" | "onColCellExpanded" | "onColCellHidden" | "onColCellRender" | "onDataCellHover" | "onDataCellClick" | "onDataCellDoubleClick" | "onDataCellContextMenu" | "onDataCellMouseDown" | "onDataCellMouseUp" | "onDataCellMouseMove" | "onDataCellBrushSelection" | "onDataCellSelectMove" | "onDataCellRender" | "onDataCellEditStart" | "onDataCellEditEnd" | "onCornerCellHover" | "onCornerCellClick" | "onCornerCellDoubleClick" | "onCornerCellContextMenu" | "onCornerCellMouseDown" | "onCornerCellMouseUp" | "onCornerCellMouseMove" | "onCornerCellRender" | "onMergedCellsHover" | "onMergedCellsClick" | "onMergedCellsDoubleClick" | "onMergedCellsContextMenu" | "onMergedCellsMouseDown" | "onMergedCellsMouseUp" | "onMergedCellsMouseMove" | "onMergedCellsRender" | "onSeriesNumberCellRender" | "onRangeSort" | "onRangeSorted" | "onRangeFilter" | "onRangeFiltered" | "onLayoutAfterHeaderLayout" | "onLayoutPagination" | "onLayoutCellRender" | "onBeforeRender" | "onAfterRender" | "onMounted" | "onUpdate" | "onUpdateAfterRender" | "onDestroy" | "onLayoutResize" | "onLayoutResizeSeriesWidth" | "onLayoutResizeRowWidth" | "onLayoutResizeRowHeight" | "onLayoutResizeColWidth" | "onLayoutResizeColHeight" | "onLayoutResizeTreeWidth" | "onLayoutResizeMouseDown" | "onLayoutResizeMouseUp" | "onLayoutResizeMouseMove" | "onKeyBoardDown" | "onKeyBoardUp" | "onCopied" | "onActionIconHover" | "onActionIconHoverOff" | "onActionIconClick" | "onContextMenu" | "onClick" | "onHover" | "onDoubleClick" | "onMouseHover" | "onMouseUp" | "onMouseDown" | "onMouseMove" | "onSelected" | "onReset" | "onLinkFieldJump" | "onScroll" | "onLayoutAfterRealDataCellRender" | "onRowCellBrushSelection" | "onColCellBrushSelection">>> & {
+}, string, PublicProps, Readonly<ExtractPropTypes<GetInitProps<SheetComponentProps, "sheetType" | "spreadsheet" | "options" | "loading" | "partDrillDown" | "adaptive" | "showPagination" | "themeCfg" | "header" | "onRowCellHover" | "onRowCellClick" | "onRowCellDoubleClick" | "onRowCellContextMenu" | "onRowCellMouseDown" | "onRowCellMouseUp" | "onRowCellMouseMove" | "onRowCellCollapsed" | "onRowCellAllCollapsed" | "onRowCellScroll" | "onRowCellRender" | "onRowCellSelected" | "onColCellHover" | "onColCellClick" | "onColCellDoubleClick" | "onColCellContextMenu" | "onColCellMouseDown" | "onColCellMouseUp" | "onColCellMouseMove" | "onColCellExpanded" | "onColCellHidden" | "onColCellRender" | "onColCellSelected" | "onDataCellHover" | "onDataCellClick" | "onDataCellDoubleClick" | "onDataCellContextMenu" | "onDataCellMouseDown" | "onDataCellMouseUp" | "onDataCellMouseMove" | "onDataCellBrushSelection" | "onDataCellSelectMove" | "onDataCellRender" | "onDataCellEditStart" | "onDataCellEditEnd" | "onDataCellSelected" | "onCornerCellHover" | "onCornerCellClick" | "onCornerCellDoubleClick" | "onCornerCellContextMenu" | "onCornerCellMouseDown" | "onCornerCellMouseUp" | "onCornerCellMouseMove" | "onCornerCellRender" | "onCornerCellSelected" | "onMergedCellsHover" | "onMergedCellsClick" | "onMergedCellsDoubleClick" | "onMergedCellsContextMenu" | "onMergedCellsMouseDown" | "onMergedCellsMouseUp" | "onMergedCellsMouseMove" | "onMergedCellsRender" | "onSeriesNumberCellRender" | "onRangeSort" | "onRangeSorted" | "onRangeFilter" | "onRangeFiltered" | "onLayoutAfterHeaderLayout" | "onLayoutPagination" | "onLayoutCellRender" | "onBeforeRender" | "onAfterRender" | "onMounted" | "onUpdate" | "onUpdateAfterRender" | "onDestroy" | "onLayoutResize" | "onLayoutResizeSeriesWidth" | "onLayoutResizeRowWidth" | "onLayoutResizeRowHeight" | "onLayoutResizeColWidth" | "onLayoutResizeColHeight" | "onLayoutResizeTreeWidth" | "onLayoutResizeMouseDown" | "onLayoutResizeMouseUp" | "onLayoutResizeMouseMove" | "onKeyBoardDown" | "onKeyBoardUp" | "onCopied" | "onActionIconHover" | "onActionIconHoverOff" | "onActionIconClick" | "onContextMenu" | "onClick" | "onHover" | "onDoubleClick" | "onMouseHover" | "onMouseUp" | "onMouseDown" | "onMouseMove" | "onSelected" | "onReset" | "onLinkFieldJump" | "onScroll" | "onLayoutAfterRealDataCellRender" | "onRowCellBrushSelection" | "onColCellBrushSelection">>> & {
 onRowCellHover?: (data: TargetCellInfo_2) => any;
 onRowCellClick?: (data: TargetCellInfo_2) => any;
 onRowCellDoubleClick?: (data: TargetCellInfo_2) => any;
@@ -5467,7 +5847,8 @@ onRowCellMouseMove?: (data: TargetCellInfo_2) => any;
 onRowCellCollapsed?: (params: RowCellCollapsedParams_2) => any;
 onRowCellAllCollapsed?: (isCollapsed: boolean) => any;
 onRowCellScroll?: (position: Required<ScrollOffset_2>) => any;
-onRowCellRender?: (cell: ColCell_2) => any;
+onRowCellRender?: (cell: RowCell_2) => any;
+onRowCellSelected?: (cells: S2CellType_2<ViewMeta_2>[], detail: CellSelectedDetail_2) => any;
 onColCellHover?: (data: TargetCellInfo_2) => any;
 onColCellClick?: (data: TargetCellInfo_2) => any;
 onColCellDoubleClick?: (data: TargetCellInfo_2) => any;
@@ -5481,6 +5862,7 @@ currentHiddenColumnsInfo: HiddenColumnsInfo_2;
 hiddenColumnsDetail: HiddenColumnsInfo_2[];
 }) => any;
 onColCellRender?: (cell: ColCell_2) => any;
+onColCellSelected?: (cells: S2CellType_2<ViewMeta_2>[], detail: CellSelectedDetail_2) => any;
 onDataCellHover?: (data: TargetCellInfo_2) => any;
 onDataCellClick?: (data: TargetCellInfo_2) => any;
 onDataCellDoubleClick?: (data: TargetCellInfo_2) => any;
@@ -5493,6 +5875,7 @@ onDataCellSelectMove?: (metaList: ViewMetaData_2[]) => any;
 onDataCellRender?: (cell: DataCell_2) => any;
 onDataCellEditStart?: (meta: ViewMeta_2, cell: TableDataCell_2) => any;
 onDataCellEditEnd?: (meta: ViewMeta_2, cell: TableDataCell_2) => any;
+onDataCellSelected?: (cells: S2CellType_2<ViewMeta_2>[], detail: CellSelectedDetail_2) => any;
 onCornerCellHover?: (data: TargetCellInfo_2) => any;
 onCornerCellClick?: (data: TargetCellInfo_2) => any;
 onCornerCellDoubleClick?: (data: TargetCellInfo_2) => any;
@@ -5501,6 +5884,7 @@ onCornerCellMouseDown?: (data: TargetCellInfo_2) => any;
 onCornerCellMouseUp?: (data: TargetCellInfo_2) => any;
 onCornerCellMouseMove?: (data: TargetCellInfo_2) => any;
 onCornerCellRender?: (cell: CornerCell_2) => any;
+onCornerCellSelected?: (cells: S2CellType_2<ViewMeta_2>[], detail: CellSelectedDetail_2) => any;
 onMergedCellsHover?: (data: TargetCellInfo_2) => any;
 onMergedCellsClick?: (data: TargetCellInfo_2) => any;
 onMergedCellsDoubleClick?: (data: TargetCellInfo_2) => any;
@@ -5559,7 +5943,7 @@ onMouseHover?: (event: FederatedPointerEvent) => any;
 onMouseUp?: (event: MouseEvent) => any;
 onMouseDown?: (event: MouseEvent) => any;
 onMouseMove?: (event: MouseEvent) => any;
-onSelected?: (cells: S2CellType_2[]) => any;
+onSelected?: (cells: S2CellType_2<ViewMeta_2>[], detail: CellSelectedDetail_2) => any;
 onReset?: (event: KeyboardEvent) => any;
 onLinkFieldJump?: (data: {
 field: string;
@@ -5605,7 +5989,7 @@ declare interface SimpleBBox {
     height: number;
 }
 
-declare type SimpleData = string | number | null;
+declare type SimpleData = string | number | null | undefined;
 
 declare interface Sort {
     /** 字段 id */
@@ -5778,14 +6162,9 @@ declare abstract class SpreadSheet_2 extends EE {
     getTheme(): InternalFullyTheme;
     getThemeName(): "default" | "colorful" | "gray" | "dark";
     /**
-     * Update pagination config which store in {@see options}
-     * @param pagination
+     * 更新分页配置
      */
     updatePagination(pagination: Pagination_2): void;
-    /**
-     * 获取当前表格实际内容高度
-     */
-    getContentHeight(): number;
     /**
      * 修改表格画布大小，不用重新加载数据
      * @param width
@@ -5811,14 +6190,6 @@ declare abstract class SpreadSheet_2 extends EE {
         __s2_instance__: SpreadSheet_2;
     };
     getLayoutWidthType(): "adaptive" | "colAdaptive" | "compact";
-    /**
-     * Update scroll's offset, the value can be undefined,
-     * indicate not update current value
-     * @param offsetConfig
-     * default offsetX(horizontal scroll need animation)
-     * but offsetY(vertical scroll don't need animation)
-     */
-    updateScrollOffset(offsetConfig: OffsetConfig): void;
     protected isCellType(cell?: CellEventTarget): boolean;
     getCell<T extends S2CellType_2 = S2CellType_2>(target: CellEventTarget): T | null;
     getCellType(target: CellEventTarget): CellType | undefined;
@@ -5836,7 +6207,7 @@ declare abstract class SpreadSheet_2 extends EE {
      * @private
      */
     protected initContainer(dom: S2MountContainer_2): void;
-    protected updateContainerStyle(): void;
+    protected setupContainerStyle(): void;
     private initHiddenColumnsDetail;
     private clearCanvasEvent;
     /**
@@ -5845,21 +6216,21 @@ declare abstract class SpreadSheet_2 extends EE {
      * @param font 文本 css 样式
      * @returns 文本测量信息 TextMetrics
      */
-    measureText: ((text: string | number | undefined, font: unknown) => TextMetrics | null) & MemoizedFunction;
+    measureText: ((text: SimpleData, font: unknown) => TextMetrics | null) & MemoizedFunction;
     /**
      * 计算文本在画布中的宽度
      * @param text 待计算的文本
      * @param font 文本 css 样式
      * @returns 文本宽度
      */
-    measureTextWidth: (text: string | number | undefined, font: unknown) => number;
+    measureTextWidth: (text: SimpleData, font: unknown) => number;
     /**
      * 计算文本在画布中的宽度 https://developer.mozilla.org/zh-CN/docs/Web/API/TextMetrics
      * @param text 待计算的文本
      * @param font 文本 css 样式
      * @returns 文本高度
      */
-    measureTextHeight: (text: string | number | undefined, font: unknown) => number;
+    measureTextHeight: (text: SimpleData, font: unknown) => number;
     /**
      * 粗略计算文本在画布中的宽度
      * @param text 待计算的文本
@@ -6030,7 +6401,7 @@ declare class TableSeriesNumberCell extends TableDataCell_2 {
     protected getTextStyle(): TextTheme;
 }
 
-export declare const TableSheet: DefineComponent<GetInitProps<SheetComponentProps, "sheetType" | "spreadsheet" | "options" | "loading" | "partDrillDown" | "adaptive" | "showPagination" | "themeCfg" | "header" | "onRowCellHover" | "onRowCellClick" | "onRowCellDoubleClick" | "onRowCellContextMenu" | "onRowCellMouseDown" | "onRowCellMouseUp" | "onRowCellMouseMove" | "onRowCellCollapsed" | "onRowCellAllCollapsed" | "onRowCellScroll" | "onRowCellRender" | "onColCellHover" | "onColCellClick" | "onColCellDoubleClick" | "onColCellContextMenu" | "onColCellMouseDown" | "onColCellMouseUp" | "onColCellMouseMove" | "onColCellExpanded" | "onColCellHidden" | "onColCellRender" | "onDataCellHover" | "onDataCellClick" | "onDataCellDoubleClick" | "onDataCellContextMenu" | "onDataCellMouseDown" | "onDataCellMouseUp" | "onDataCellMouseMove" | "onDataCellBrushSelection" | "onDataCellSelectMove" | "onDataCellRender" | "onDataCellEditStart" | "onDataCellEditEnd" | "onCornerCellHover" | "onCornerCellClick" | "onCornerCellDoubleClick" | "onCornerCellContextMenu" | "onCornerCellMouseDown" | "onCornerCellMouseUp" | "onCornerCellMouseMove" | "onCornerCellRender" | "onMergedCellsHover" | "onMergedCellsClick" | "onMergedCellsDoubleClick" | "onMergedCellsContextMenu" | "onMergedCellsMouseDown" | "onMergedCellsMouseUp" | "onMergedCellsMouseMove" | "onMergedCellsRender" | "onSeriesNumberCellRender" | "onRangeSort" | "onRangeSorted" | "onRangeFilter" | "onRangeFiltered" | "onLayoutAfterHeaderLayout" | "onLayoutPagination" | "onLayoutCellRender" | "onBeforeRender" | "onAfterRender" | "onMounted" | "onUpdate" | "onUpdateAfterRender" | "onDestroy" | "onLayoutResize" | "onLayoutResizeSeriesWidth" | "onLayoutResizeRowWidth" | "onLayoutResizeRowHeight" | "onLayoutResizeColWidth" | "onLayoutResizeColHeight" | "onLayoutResizeTreeWidth" | "onLayoutResizeMouseDown" | "onLayoutResizeMouseUp" | "onLayoutResizeMouseMove" | "onKeyBoardDown" | "onKeyBoardUp" | "onCopied" | "onActionIconHover" | "onActionIconHoverOff" | "onActionIconClick" | "onContextMenu" | "onClick" | "onHover" | "onDoubleClick" | "onMouseHover" | "onMouseUp" | "onMouseDown" | "onMouseMove" | "onSelected" | "onReset" | "onLinkFieldJump" | "onScroll" | "onLayoutAfterRealDataCellRender" | "onRowCellBrushSelection" | "onColCellBrushSelection">, {
+export declare const TableSheet: DefineComponent<GetInitProps<SheetComponentProps, "sheetType" | "spreadsheet" | "options" | "loading" | "partDrillDown" | "adaptive" | "showPagination" | "themeCfg" | "header" | "onRowCellHover" | "onRowCellClick" | "onRowCellDoubleClick" | "onRowCellContextMenu" | "onRowCellMouseDown" | "onRowCellMouseUp" | "onRowCellMouseMove" | "onRowCellCollapsed" | "onRowCellAllCollapsed" | "onRowCellScroll" | "onRowCellRender" | "onRowCellSelected" | "onColCellHover" | "onColCellClick" | "onColCellDoubleClick" | "onColCellContextMenu" | "onColCellMouseDown" | "onColCellMouseUp" | "onColCellMouseMove" | "onColCellExpanded" | "onColCellHidden" | "onColCellRender" | "onColCellSelected" | "onDataCellHover" | "onDataCellClick" | "onDataCellDoubleClick" | "onDataCellContextMenu" | "onDataCellMouseDown" | "onDataCellMouseUp" | "onDataCellMouseMove" | "onDataCellBrushSelection" | "onDataCellSelectMove" | "onDataCellRender" | "onDataCellEditStart" | "onDataCellEditEnd" | "onDataCellSelected" | "onCornerCellHover" | "onCornerCellClick" | "onCornerCellDoubleClick" | "onCornerCellContextMenu" | "onCornerCellMouseDown" | "onCornerCellMouseUp" | "onCornerCellMouseMove" | "onCornerCellRender" | "onCornerCellSelected" | "onMergedCellsHover" | "onMergedCellsClick" | "onMergedCellsDoubleClick" | "onMergedCellsContextMenu" | "onMergedCellsMouseDown" | "onMergedCellsMouseUp" | "onMergedCellsMouseMove" | "onMergedCellsRender" | "onSeriesNumberCellRender" | "onRangeSort" | "onRangeSorted" | "onRangeFilter" | "onRangeFiltered" | "onLayoutAfterHeaderLayout" | "onLayoutPagination" | "onLayoutCellRender" | "onBeforeRender" | "onAfterRender" | "onMounted" | "onUpdate" | "onUpdateAfterRender" | "onDestroy" | "onLayoutResize" | "onLayoutResizeSeriesWidth" | "onLayoutResizeRowWidth" | "onLayoutResizeRowHeight" | "onLayoutResizeColWidth" | "onLayoutResizeColHeight" | "onLayoutResizeTreeWidth" | "onLayoutResizeMouseDown" | "onLayoutResizeMouseUp" | "onLayoutResizeMouseMove" | "onKeyBoardDown" | "onKeyBoardUp" | "onCopied" | "onActionIconHover" | "onActionIconHoverOff" | "onActionIconClick" | "onContextMenu" | "onClick" | "onHover" | "onDoubleClick" | "onMouseHover" | "onMouseUp" | "onMouseDown" | "onMouseMove" | "onSelected" | "onReset" | "onLinkFieldJump" | "onScroll" | "onLayoutAfterRealDataCellRender" | "onRowCellBrushSelection" | "onColCellBrushSelection">, {
 s2Ref: ShallowRef<SheetExpose>;
 }, unknown, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
 spreadsheet: (container: S2MountContainer_2, dataCfg: S2DataConfig_2, options: S2Options_2<TooltipContentType_2, Pagination_2, BaseTooltipOperatorMenuOptions_2>) => SpreadSheet_2;
@@ -6044,7 +6415,8 @@ rowCellMouseMove: (data: TargetCellInfo_2) => void;
 rowCellCollapsed: (params: RowCellCollapsedParams_2) => void;
 rowCellAllCollapsed: (isCollapsed: boolean) => void;
 rowCellScroll: (position: Required<ScrollOffset_2>) => void;
-rowCellRender: (cell: ColCell_2) => void;
+rowCellRender: (cell: RowCell_2) => void;
+rowCellSelected: CellSelectedHandler_2;
 colCellHover: (data: TargetCellInfo_2) => void;
 colCellClick: (data: TargetCellInfo_2) => void;
 colCellDoubleClick: (data: TargetCellInfo_2) => void;
@@ -6058,6 +6430,7 @@ currentHiddenColumnsInfo: HiddenColumnsInfo_2;
 hiddenColumnsDetail: HiddenColumnsInfo_2[];
 }) => void;
 colCellRender: (cell: ColCell_2) => void;
+colCellSelected: CellSelectedHandler_2;
 dataCellHover: (data: TargetCellInfo_2) => void;
 dataCellClick: (data: TargetCellInfo_2) => void;
 dataCellDoubleClick: (data: TargetCellInfo_2) => void;
@@ -6070,6 +6443,7 @@ dataCellSelectMove: (metaList: ViewMetaData_2[]) => void;
 dataCellRender: (cell: DataCell_2) => void;
 dataCellEditStart: (meta: ViewMeta_2, cell: TableDataCell_2) => void;
 dataCellEditEnd: (meta: ViewMeta_2, cell: TableDataCell_2) => void;
+dataCellSelected: CellSelectedHandler_2;
 cornerCellHover: (data: TargetCellInfo_2) => void;
 cornerCellClick: (data: TargetCellInfo_2) => void;
 cornerCellDoubleClick: (data: TargetCellInfo_2) => void;
@@ -6078,6 +6452,7 @@ cornerCellMouseDown: (data: TargetCellInfo_2) => void;
 cornerCellMouseUp: (data: TargetCellInfo_2) => void;
 cornerCellMouseMove: (data: TargetCellInfo_2) => void;
 cornerCellRender: (cell: CornerCell_2) => void;
+cornerCellSelected: CellSelectedHandler_2;
 mergedCellsHover: (data: TargetCellInfo_2) => void;
 mergedCellsClick: (data: TargetCellInfo_2) => void;
 mergedCellsDoubleClick: (data: TargetCellInfo_2) => void;
@@ -6136,7 +6511,7 @@ mouseHover: (event: FederatedPointerEvent) => void;
 mouseUp: (event: MouseEvent) => void;
 mouseDown: (event: MouseEvent) => void;
 mouseMove: (event: MouseEvent) => void;
-selected: (cells: S2CellType_2[]) => void;
+selected: CellSelectedHandler_2;
 reset: (event: KeyboardEvent) => void;
 linkFieldJump: (data: {
 field: string;
@@ -6150,7 +6525,7 @@ spreadsheet: SpreadSheet_2;
 }) => void;
 rowCellBrushSelection: (event: FederatedPointerEvent) => void;
 colCellBrushSelection: (event: FederatedPointerEvent) => void;
-}, string, PublicProps, Readonly<ExtractPropTypes<GetInitProps<SheetComponentProps, "sheetType" | "spreadsheet" | "options" | "loading" | "partDrillDown" | "adaptive" | "showPagination" | "themeCfg" | "header" | "onRowCellHover" | "onRowCellClick" | "onRowCellDoubleClick" | "onRowCellContextMenu" | "onRowCellMouseDown" | "onRowCellMouseUp" | "onRowCellMouseMove" | "onRowCellCollapsed" | "onRowCellAllCollapsed" | "onRowCellScroll" | "onRowCellRender" | "onColCellHover" | "onColCellClick" | "onColCellDoubleClick" | "onColCellContextMenu" | "onColCellMouseDown" | "onColCellMouseUp" | "onColCellMouseMove" | "onColCellExpanded" | "onColCellHidden" | "onColCellRender" | "onDataCellHover" | "onDataCellClick" | "onDataCellDoubleClick" | "onDataCellContextMenu" | "onDataCellMouseDown" | "onDataCellMouseUp" | "onDataCellMouseMove" | "onDataCellBrushSelection" | "onDataCellSelectMove" | "onDataCellRender" | "onDataCellEditStart" | "onDataCellEditEnd" | "onCornerCellHover" | "onCornerCellClick" | "onCornerCellDoubleClick" | "onCornerCellContextMenu" | "onCornerCellMouseDown" | "onCornerCellMouseUp" | "onCornerCellMouseMove" | "onCornerCellRender" | "onMergedCellsHover" | "onMergedCellsClick" | "onMergedCellsDoubleClick" | "onMergedCellsContextMenu" | "onMergedCellsMouseDown" | "onMergedCellsMouseUp" | "onMergedCellsMouseMove" | "onMergedCellsRender" | "onSeriesNumberCellRender" | "onRangeSort" | "onRangeSorted" | "onRangeFilter" | "onRangeFiltered" | "onLayoutAfterHeaderLayout" | "onLayoutPagination" | "onLayoutCellRender" | "onBeforeRender" | "onAfterRender" | "onMounted" | "onUpdate" | "onUpdateAfterRender" | "onDestroy" | "onLayoutResize" | "onLayoutResizeSeriesWidth" | "onLayoutResizeRowWidth" | "onLayoutResizeRowHeight" | "onLayoutResizeColWidth" | "onLayoutResizeColHeight" | "onLayoutResizeTreeWidth" | "onLayoutResizeMouseDown" | "onLayoutResizeMouseUp" | "onLayoutResizeMouseMove" | "onKeyBoardDown" | "onKeyBoardUp" | "onCopied" | "onActionIconHover" | "onActionIconHoverOff" | "onActionIconClick" | "onContextMenu" | "onClick" | "onHover" | "onDoubleClick" | "onMouseHover" | "onMouseUp" | "onMouseDown" | "onMouseMove" | "onSelected" | "onReset" | "onLinkFieldJump" | "onScroll" | "onLayoutAfterRealDataCellRender" | "onRowCellBrushSelection" | "onColCellBrushSelection">>> & {
+}, string, PublicProps, Readonly<ExtractPropTypes<GetInitProps<SheetComponentProps, "sheetType" | "spreadsheet" | "options" | "loading" | "partDrillDown" | "adaptive" | "showPagination" | "themeCfg" | "header" | "onRowCellHover" | "onRowCellClick" | "onRowCellDoubleClick" | "onRowCellContextMenu" | "onRowCellMouseDown" | "onRowCellMouseUp" | "onRowCellMouseMove" | "onRowCellCollapsed" | "onRowCellAllCollapsed" | "onRowCellScroll" | "onRowCellRender" | "onRowCellSelected" | "onColCellHover" | "onColCellClick" | "onColCellDoubleClick" | "onColCellContextMenu" | "onColCellMouseDown" | "onColCellMouseUp" | "onColCellMouseMove" | "onColCellExpanded" | "onColCellHidden" | "onColCellRender" | "onColCellSelected" | "onDataCellHover" | "onDataCellClick" | "onDataCellDoubleClick" | "onDataCellContextMenu" | "onDataCellMouseDown" | "onDataCellMouseUp" | "onDataCellMouseMove" | "onDataCellBrushSelection" | "onDataCellSelectMove" | "onDataCellRender" | "onDataCellEditStart" | "onDataCellEditEnd" | "onDataCellSelected" | "onCornerCellHover" | "onCornerCellClick" | "onCornerCellDoubleClick" | "onCornerCellContextMenu" | "onCornerCellMouseDown" | "onCornerCellMouseUp" | "onCornerCellMouseMove" | "onCornerCellRender" | "onCornerCellSelected" | "onMergedCellsHover" | "onMergedCellsClick" | "onMergedCellsDoubleClick" | "onMergedCellsContextMenu" | "onMergedCellsMouseDown" | "onMergedCellsMouseUp" | "onMergedCellsMouseMove" | "onMergedCellsRender" | "onSeriesNumberCellRender" | "onRangeSort" | "onRangeSorted" | "onRangeFilter" | "onRangeFiltered" | "onLayoutAfterHeaderLayout" | "onLayoutPagination" | "onLayoutCellRender" | "onBeforeRender" | "onAfterRender" | "onMounted" | "onUpdate" | "onUpdateAfterRender" | "onDestroy" | "onLayoutResize" | "onLayoutResizeSeriesWidth" | "onLayoutResizeRowWidth" | "onLayoutResizeRowHeight" | "onLayoutResizeColWidth" | "onLayoutResizeColHeight" | "onLayoutResizeTreeWidth" | "onLayoutResizeMouseDown" | "onLayoutResizeMouseUp" | "onLayoutResizeMouseMove" | "onKeyBoardDown" | "onKeyBoardUp" | "onCopied" | "onActionIconHover" | "onActionIconHoverOff" | "onActionIconClick" | "onContextMenu" | "onClick" | "onHover" | "onDoubleClick" | "onMouseHover" | "onMouseUp" | "onMouseDown" | "onMouseMove" | "onSelected" | "onReset" | "onLinkFieldJump" | "onScroll" | "onLayoutAfterRealDataCellRender" | "onRowCellBrushSelection" | "onColCellBrushSelection">>> & {
 onRowCellHover?: (data: TargetCellInfo_2) => any;
 onRowCellClick?: (data: TargetCellInfo_2) => any;
 onRowCellDoubleClick?: (data: TargetCellInfo_2) => any;
@@ -6161,7 +6536,8 @@ onRowCellMouseMove?: (data: TargetCellInfo_2) => any;
 onRowCellCollapsed?: (params: RowCellCollapsedParams_2) => any;
 onRowCellAllCollapsed?: (isCollapsed: boolean) => any;
 onRowCellScroll?: (position: Required<ScrollOffset_2>) => any;
-onRowCellRender?: (cell: ColCell_2) => any;
+onRowCellRender?: (cell: RowCell_2) => any;
+onRowCellSelected?: (cells: S2CellType_2<ViewMeta_2>[], detail: CellSelectedDetail_2) => any;
 onColCellHover?: (data: TargetCellInfo_2) => any;
 onColCellClick?: (data: TargetCellInfo_2) => any;
 onColCellDoubleClick?: (data: TargetCellInfo_2) => any;
@@ -6175,6 +6551,7 @@ currentHiddenColumnsInfo: HiddenColumnsInfo_2;
 hiddenColumnsDetail: HiddenColumnsInfo_2[];
 }) => any;
 onColCellRender?: (cell: ColCell_2) => any;
+onColCellSelected?: (cells: S2CellType_2<ViewMeta_2>[], detail: CellSelectedDetail_2) => any;
 onDataCellHover?: (data: TargetCellInfo_2) => any;
 onDataCellClick?: (data: TargetCellInfo_2) => any;
 onDataCellDoubleClick?: (data: TargetCellInfo_2) => any;
@@ -6187,6 +6564,7 @@ onDataCellSelectMove?: (metaList: ViewMetaData_2[]) => any;
 onDataCellRender?: (cell: DataCell_2) => any;
 onDataCellEditStart?: (meta: ViewMeta_2, cell: TableDataCell_2) => any;
 onDataCellEditEnd?: (meta: ViewMeta_2, cell: TableDataCell_2) => any;
+onDataCellSelected?: (cells: S2CellType_2<ViewMeta_2>[], detail: CellSelectedDetail_2) => any;
 onCornerCellHover?: (data: TargetCellInfo_2) => any;
 onCornerCellClick?: (data: TargetCellInfo_2) => any;
 onCornerCellDoubleClick?: (data: TargetCellInfo_2) => any;
@@ -6195,6 +6573,7 @@ onCornerCellMouseDown?: (data: TargetCellInfo_2) => any;
 onCornerCellMouseUp?: (data: TargetCellInfo_2) => any;
 onCornerCellMouseMove?: (data: TargetCellInfo_2) => any;
 onCornerCellRender?: (cell: CornerCell_2) => any;
+onCornerCellSelected?: (cells: S2CellType_2<ViewMeta_2>[], detail: CellSelectedDetail_2) => any;
 onMergedCellsHover?: (data: TargetCellInfo_2) => any;
 onMergedCellsClick?: (data: TargetCellInfo_2) => any;
 onMergedCellsDoubleClick?: (data: TargetCellInfo_2) => any;
@@ -6253,7 +6632,7 @@ onMouseHover?: (event: FederatedPointerEvent) => any;
 onMouseUp?: (event: MouseEvent) => any;
 onMouseDown?: (event: MouseEvent) => any;
 onMouseMove?: (event: MouseEvent) => any;
-onSelected?: (cells: S2CellType_2[]) => any;
+onSelected?: (cells: S2CellType_2<ViewMeta_2>[], detail: CellSelectedDetail_2) => any;
 onReset?: (event: KeyboardEvent) => any;
 onLinkFieldJump?: (data: {
 field: string;
@@ -6273,7 +6652,7 @@ onSpreadsheet?: (container: S2MountContainer_2, dataCfg: S2DataConfig_2, options
 declare interface TargetCellInfo_2 {
     target: S2CellType_2;
     event: FederatedPointerEvent;
-    viewMeta: Node_2_2;
+    viewMeta: ViewMeta_2 | Node_2_2;
 }
 
 declare type TextAlign = 'left' | 'center' | 'right';
@@ -6349,7 +6728,7 @@ declare type TooltipDataItem = ViewMetaData_2;
 
 declare type TooltipDetailListItem = {
     name: string;
-    value: string | number;
+    value: SimpleData;
     icon?: Element | string;
 };
 
@@ -6556,6 +6935,29 @@ declare interface Total {
     subTotalsLabel?: string;
 }
 
+declare class TotalClass {
+    label: string;
+    isSubTotals: boolean;
+    isGrandTotals: boolean;
+    isTotalRoot: boolean;
+    constructor(params: TotalClassConfig);
+}
+
+/**
+ * Class to mark '小计' & '总计'
+ */
+declare interface TotalClassConfig {
+    label: string;
+    isSubTotals: boolean;
+    isGrandTotals: boolean;
+    isTotalRoot?: boolean;
+}
+
+declare class TotalMeasure {
+    label: string;
+    constructor(label: string);
+}
+
 declare interface Totals {
     row?: Total;
     col?: Total;
@@ -6584,7 +6986,7 @@ declare interface ValueRange {
 
 declare type ValueRanges = Record<string, ValueRange>;
 
-export declare const version = "@antv/s2-vue-v2.0.0-next.15";
+export declare const version = "@antv/s2-vue-v2.0.0-next.16";
 
 declare interface ViewCellHeights {
     getCellOffsetY: (index: number) => number;
@@ -6597,29 +6999,45 @@ declare interface ViewCellHeights {
 }
 
 declare interface ViewMeta_2 {
+    /** 表格实例 */
     spreadsheet: SpreadSheet_2;
+    /** 数据唯一标识 */
     id: string;
+    /** x 坐标 */
     x: number;
+    /** y 坐标 */
     y: number;
+    /** 单元格宽度 */
     width: number;
+    /** 单元格高度 */
     height: number;
-    data: ViewMetaData_2 | SimpleData | undefined;
+    /** 单元格数据 */
+    data: ViewMetaData_2 | undefined;
+    /** 行索引 */
     rowIndex: number;
+    /** 列索引 */
     colIndex: number;
+    /** 数值字段, 对应 s2DataConfig.fields */
     valueField: string;
+    /** 数值 */
     fieldValue: DataItem;
+    /** 是否是汇总字段 */
     isTotals?: boolean;
+    /** 行查询条件 */
     rowQuery?: Query;
+    /** 列查询条件 */
     colQuery?: Query;
+    /** 行 id */
     rowId?: string;
+    /** 列 id */
     colId?: string;
-    field?: string;
-    isFrozenCorner?: boolean;
-    label?: string;
-    value?: string | number;
+    /** 查询条件 */
     query?: Query;
+    /** 叶子节点 */
     isLeaf?: boolean;
+    /** 是否是浅渲染 */
     shallowRender?: boolean;
+    /** 其他字段 */
     [key: string]: unknown;
 }