@antv/s2-vue 2.0.0-alpha.1 → 2.0.0-next.2

package/esm/index.d.ts

@@ -64,6 +64,11 @@ declare enum Aggregation {
     AVG = "AVG"
 }
 
+declare interface AreaRange {
+    start: number;
+    width: number;
+}
+
 declare interface Background {
     opacity?: number;
     color?: string;
@@ -101,12 +106,14 @@ declare abstract class BaseCell<T extends SimpleBBox> extends Group {
     protected theme: S2Theme;
     protected backgroundShape: DisplayObject;
     protected textShape: DisplayObject;
+    protected textShapes: DisplayObject[];
     protected linkFieldShape: DisplayObject;
     protected actualText: string;
     protected actualTextWidth: number;
     protected conditions: Conditions;
     protected conditionIntervalShape: DisplayObject | undefined;
     protected conditionIconShape: GuiIcon;
+    protected conditionIconShapes: GuiIcon[];
     protected stateShapes: Map<StateShapeLayer, DisplayObject<any, any>>;
     constructor(meta: T, spreadsheet: SpreadSheet_2, ...restOptions: unknown[]);
     getMeta(): T;
@@ -147,7 +154,7 @@ declare abstract class BaseCell<T extends SimpleBBox> extends Group {
     protected abstract getMaxTextWidth(): number;
     protected abstract getTextPosition(): PointLike;
     protected abstract findFieldCondition(conditions: Condition[] | undefined): Condition | undefined;
-    protected abstract mappingValue(condition: Condition): MappingResult | undefined;
+    protected abstract mappingValue(condition: Condition): MappingResult | undefined | null;
     getStyle<K extends keyof S2Theme = keyof CellThemes>(name?: K): DefaultCellTheme | S2Theme[K];
     protected getResizeAreaStyle(): ResizeArea;
     protected shouldDrawResizeAreaByType(type: keyof ResizeInteractionOptions, cell: S2CellType_2): boolean | ((cell: S2CellType_2<ViewMeta_2>) => boolean) | ResizeType | ((resizeInfo: ResizeInfo_2) => boolean) | undefined;
@@ -181,7 +188,13 @@ declare abstract class BaseCell<T extends SimpleBBox> extends Group {
     };
     hideInteractionShape(): void;
     clearUnselectedState(): void;
-    getTextShape(): DisplayObject<any, any>;
+    getTextShape(): DisplayObject;
+    getTextShapes(): DisplayObject[];
+    addTextShape(textShape: DisplayObject): void;
+    getConditionIconShape(): GuiIcon;
+    getConditionIconShapes(): GuiIcon[];
+    addConditionIconShape(iconShape: GuiIcon): void;
+    resetTextAndConditionIconShapes(): void;
     get cellConditions(): Conditions;
     drawConditionIconShapes(): void;
     getTextConditionFill(textStyle: TextTheme): string | undefined;
@@ -334,7 +347,7 @@ declare abstract class BaseFacet {
     layoutResult: LayoutResult_2;
     viewCellWidths: number[];
     viewCellHeights: ViewCellHeights;
-    protected mobileWheel: Wheel;
+    protected mobileWheel: WheelEvent_2;
     protected timer: Timer;
     hScrollBar: ScrollBar;
     hRowScrollBar: ScrollBar;
@@ -342,7 +355,7 @@ declare abstract class BaseFacet {
     rowHeader: RowHeader | null;
     columnHeader: ColHeader;
     cornerHeader: CornerHeader;
-    rowIndexHeader: SeriesNumberHeader | null;
+    seriesNumberHeader: SeriesNumberHeader | null;
     centerFrame: Frame;
     gridInfo: GridInfo;
     protected abstract doLayout(): LayoutResult_2;
@@ -506,6 +519,7 @@ declare abstract class BaseFacet {
     private emitScrollEvent;
     protected onAfterScroll: DebouncedFunc<() => void>;
     protected saveInitColumnLeafNodes(columnNodes?: Node_2_2[]): void;
+    getHiddenColumnsInfo(columnNode: Node_2_2): HiddenColumnsInfo_2 | undefined;
 }
 
 declare interface BaseFields {
@@ -626,14 +640,14 @@ loading: BooleanConstructor;
 partDrillDown: ObjectConstructor;
 header: ObjectConstructor;
 options: {
-type: PropType<S2Options<TooltipContentType, Pagination>>;
-default: S2Options<TooltipContentType, Pagination>;
+type: PropType<S2Options<TooltipContentType, Pagination, string | Element, string>>;
+default: S2Options<TooltipContentType, Pagination, string | Element, string>;
 };
 adaptive: {
 type: PropType<Adaptive>;
 default: Adaptive;
 };
-onSpreadsheet: PropType<(container: S2MountContainer, dataCfg: S2DataConfig, options: S2Options<TooltipContentType, Pagination>) => SpreadSheet>;
+onSpreadsheet: PropType<(container: S2MountContainer, dataCfg: S2DataConfig, options: S2Options<TooltipContentType, Pagination, string | Element, string>) => SpreadSheet>;
 onGetSpreadSheet: PropType<(spreadsheet: SpreadSheet) => void>;
 onMounted: PropType<(spreadsheet: SpreadSheet) => void>;
 }, {
@@ -653,7 +667,7 @@ showSizeChange: (nextPageSize: number) => void;
 handlePageChange: (nextCurrent: number) => void;
 handlePageSizeChange: (nextSize: number) => void;
 }, unknown, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
-spreadsheet: (container: S2MountContainer, dataCfg: S2DataConfig, options: S2Options<TooltipContentType, Pagination>) => SpreadSheet;
+spreadsheet: (container: S2MountContainer, dataCfg: S2DataConfig, options: S2Options<TooltipContentType, Pagination, string | Element, string>) => SpreadSheet;
 getSpreadSheet: (spreadsheet: SpreadSheet) => void;
 sheetUpdate: SheetUpdateCallback;
 rowCellHover: (data: TargetCellInfo) => void;
@@ -783,14 +797,14 @@ loading: BooleanConstructor;
 partDrillDown: ObjectConstructor;
 header: ObjectConstructor;
 options: {
-type: PropType<S2Options<TooltipContentType, Pagination>>;
-default: S2Options<TooltipContentType, Pagination>;
+type: PropType<S2Options<TooltipContentType, Pagination, string | Element, string>>;
+default: S2Options<TooltipContentType, Pagination, string | Element, string>;
 };
 adaptive: {
 type: PropType<Adaptive>;
 default: Adaptive;
 };
-onSpreadsheet: PropType<(container: S2MountContainer, dataCfg: S2DataConfig, options: S2Options<TooltipContentType, Pagination>) => SpreadSheet>;
+onSpreadsheet: PropType<(container: S2MountContainer, dataCfg: S2DataConfig, options: S2Options<TooltipContentType, Pagination, string | Element, string>) => SpreadSheet>;
 onGetSpreadSheet: PropType<(spreadsheet: SpreadSheet) => void>;
 onMounted: PropType<(spreadsheet: SpreadSheet) => void>;
 }>> & {
@@ -904,10 +918,10 @@ record: RawData;
 onScroll?: (position: CellScrollPosition) => any;
 onRowCellBrushSelection?: (event: GEvent) => any;
 onColCellBrushSelection?: (event: GEvent) => any;
-onSpreadsheet?: (container: S2MountContainer, dataCfg: S2DataConfig, options: S2Options<TooltipContentType, Pagination>) => any;
+onSpreadsheet?: (container: S2MountContainer, dataCfg: S2DataConfig, options: S2Options<TooltipContentType, Pagination, string | Element, string>) => any;
 onGetSpreadSheet?: (spreadsheet: SpreadSheet) => any;
 }, {
-options: S2Options<TooltipContentType, Pagination>;
+options: S2Options<TooltipContentType, Pagination, string | Element, string>;
 loading: boolean;
 adaptive: boolean | {
 width?: boolean;
@@ -1071,10 +1085,10 @@ declare class BaseTooltip_2 {
     private getContainer;
 }
 
-declare interface BaseTooltipConfig<T = TooltipContentType_2> {
+declare interface BaseTooltipConfig<T = TooltipContentType_2, Icon = Element | string, Text = string> {
     showTooltip?: boolean;
     content?: TooltipShowOptions<T>['content'];
-    operation?: TooltipOperation;
+    operation?: TooltipOperation<Icon, Text>;
     autoAdjustBoundary?: TooltipAutoAdjustBoundary;
     renderTooltip?: (spreadsheet: SpreadSheet_2) => BaseTooltip_2;
     adjustPosition?: (positionInfo: TooltipPositionInfo) => TooltipPosition;
@@ -1285,6 +1299,12 @@ declare class ColCell extends HeaderCell {
         height: number;
     };
     protected isLastColumn(): boolean;
+    /**
+     * 计算文本位置时候需要，留给后代根据情况（固定列）覆盖
+     * @param viewport
+     * @returns viewport
+     */
+    protected handleViewport(viewport: AreaRange): AreaRange;
 }
 
 declare interface ColCfg {
@@ -1355,7 +1375,6 @@ declare class CornerBBox extends BaseBBox {
 declare class CornerCell extends HeaderCell {
     cornerType: CornerNodeType;
     protected headerConfig: CornerHeaderConfig;
-    protected textShapes: DisplayObject[];
     protected isBolderText(): boolean;
     get cellType(): CellTypes;
     protected getBorderPositions(): CellBorderPosition[];
@@ -1429,7 +1448,7 @@ declare enum CornerNodeType {
     Series = "series"
 }
 
-declare type CustomHeaderField = string | CustomTreeNode;
+declare type CustomHeaderField = CustomTreeNode | string;
 
 declare type CustomHeaderFields = CustomHeaderField[];
 
@@ -1460,13 +1479,13 @@ export declare class CustomTooltip extends BaseTooltip {
 
 declare interface CustomTreeNode {
     key: string;
-    title: string;
+    title?: string;
     collapsed?: boolean;
     description?: string;
     children?: CustomTreeNode[];
 }
 
-declare type Data = (RawData_2 & ExtraData) | undefined;
+declare type Data = (RawData_2 & ExtraData) | undefined | null;
 
 /**
  * DataCell for panelGroup area
@@ -1527,9 +1546,10 @@ declare class DataCell_2 extends BaseCell<ViewMeta_2> {
      * Mapping value to get condition related attrs
      * @param condition
      */
-    mappingValue(condition: Condition): MappingResult;
+    mappingValue(condition: Condition): MappingResult | undefined | null;
     updateByState(stateName: InteractionStateName): void;
     clearUnselectedState(): void;
+    private toggleConditionIntervalShapeOpacity;
 }
 
 declare type DataCellCallback = (viewMeta: ViewMeta_2) => S2CellType_2;
@@ -1733,8 +1753,6 @@ declare interface Fields extends BaseFields {
     customValueOrder?: number;
 }
 
-declare type FilterDataItemCallback = (valueField: string, data: DataItem) => DataItem;
-
 declare interface FilterParam {
     filterKey: string;
     filteredValues?: unknown[];
@@ -2127,6 +2145,11 @@ declare interface LayoutResult_2 {
     spreadsheet: SpreadSheet_2;
 }
 
+/**
+ * determine the series number cell coordinates
+ */
+declare type LayoutSeriesNumberNodes = (rowsHierarchy: Hierarchy, seriesNumberWidth: number, spreadsheet: SpreadSheet_2) => Node_2_2[];
+
 /**
  * 布局类型：
  * adaptive: 行列等宽，均分整个 canvas 画布宽度
@@ -2148,9 +2171,7 @@ declare interface LineTheme {
     };
 }
 
-declare type MappingDataItemCallback = (valueField: string, data: DataItem) => Record<string, string | number> | DataItem;
-
-declare type MappingFunction = (fieldValue: number | string, data: Record<string, any>) => MappingResult | undefined;
+declare type MappingFunction = (fieldValue: number | string, data: RawData_2) => MappingResult | undefined | null;
 
 declare interface MappingResult extends ValueRange {
     icon?: string;
@@ -2323,6 +2344,10 @@ declare class Node_2_2 {
     static rootNode(): Node_2_2;
     toJSON(): Omit_2<this, "config" | "parent" | "hierarchy" | "spreadsheet">;
     getHeadLeafChild(): Node_2_2 | undefined;
+    /**
+     * 获取树状模式下，当前节点以及其所有子节点的高度总和
+     * */
+    getTotalHeightForTreeHierarchy(): number;
 }
 
 declare interface OffsetConfig {
@@ -2436,21 +2461,21 @@ loading: BooleanConstructor;
 partDrillDown: ObjectConstructor;
 header: ObjectConstructor;
 options: {
-type: PropType<S2Options<TooltipContentType, Pagination>>;
-default: S2Options<TooltipContentType, Pagination>;
+type: PropType<S2Options<TooltipContentType, Pagination, string | Element, string>>;
+default: S2Options<TooltipContentType, Pagination, string | Element, string>;
 };
 adaptive: {
 type: PropType<Adaptive>;
 default: Adaptive;
 };
-onSpreadsheet: PropType<(container: S2MountContainer, dataCfg: S2DataConfig, options: S2Options<TooltipContentType, Pagination>) => SpreadSheet>;
+onSpreadsheet: PropType<(container: S2MountContainer, dataCfg: S2DataConfig, options: S2Options<TooltipContentType, Pagination, string | Element, string>) => SpreadSheet>;
 onGetSpreadSheet: PropType<(spreadsheet: SpreadSheet) => void>;
 onMounted: PropType<(spreadsheet: SpreadSheet) => void>;
 }, {
 s2Ref: ShallowRef<SheetExpose>;
-options: S2Options<TooltipContentType, Pagination>;
+options: S2Options<TooltipContentType, Pagination, string | Element, string>;
 }, unknown, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
-spreadsheet: (container: S2MountContainer, dataCfg: S2DataConfig, options: S2Options<TooltipContentType, Pagination>) => SpreadSheet;
+spreadsheet: (container: S2MountContainer, dataCfg: S2DataConfig, options: S2Options<TooltipContentType, Pagination, string | Element, string>) => SpreadSheet;
 getSpreadSheet: (spreadsheet: SpreadSheet) => void;
 sheetUpdate: SheetUpdateCallback;
 rowCellHover: (data: TargetCellInfo) => void;
@@ -2580,14 +2605,14 @@ loading: BooleanConstructor;
 partDrillDown: ObjectConstructor;
 header: ObjectConstructor;
 options: {
-type: PropType<S2Options<TooltipContentType, Pagination>>;
-default: S2Options<TooltipContentType, Pagination>;
+type: PropType<S2Options<TooltipContentType, Pagination, string | Element, string>>;
+default: S2Options<TooltipContentType, Pagination, string | Element, string>;
 };
 adaptive: {
 type: PropType<Adaptive>;
 default: Adaptive;
 };
-onSpreadsheet: PropType<(container: S2MountContainer, dataCfg: S2DataConfig, options: S2Options<TooltipContentType, Pagination>) => SpreadSheet>;
+onSpreadsheet: PropType<(container: S2MountContainer, dataCfg: S2DataConfig, options: S2Options<TooltipContentType, Pagination, string | Element, string>) => SpreadSheet>;
 onGetSpreadSheet: PropType<(spreadsheet: SpreadSheet) => void>;
 onMounted: PropType<(spreadsheet: SpreadSheet) => void>;
 }>> & {
@@ -2701,10 +2726,10 @@ record: RawData;
 onScroll?: (position: CellScrollPosition) => any;
 onRowCellBrushSelection?: (event: GEvent) => any;
 onColCellBrushSelection?: (event: GEvent) => any;
-onSpreadsheet?: (container: S2MountContainer, dataCfg: S2DataConfig, options: S2Options<TooltipContentType, Pagination>) => any;
+onSpreadsheet?: (container: S2MountContainer, dataCfg: S2DataConfig, options: S2Options<TooltipContentType, Pagination, string | Element, string>) => any;
 onGetSpreadSheet?: (spreadsheet: SpreadSheet) => any;
 }, {
-options: S2Options<TooltipContentType, Pagination>;
+options: S2Options<TooltipContentType, Pagination, string | Element, string>;
 loading: boolean;
 adaptive: boolean | {
 width?: boolean;
@@ -2717,6 +2742,11 @@ onChange?: (current: number) => void;
 };
 }>;
 
+declare interface Point {
+    x: number;
+    y: number;
+}
+
 declare interface PointObject {
     x: number;
     y: number;
@@ -2931,17 +2961,16 @@ declare class RowHeader extends BaseHeader<RowHeaderConfig> {
 declare interface RowHeaderConfig extends BaseHeaderConfig {
     hierarchyType: S2Options_2['hierarchyType'];
     linkFields: string[];
-    seriesNumberWidth: number;
 }
 
-declare interface S2BasicOptions<T = TooltipContentType_2, P = Pagination_2> {
+declare interface S2BasicOptions<T = TooltipContentType_2, P = Pagination_2, Icon = Element | string, Text = string> {
     width?: number;
     height?: number;
     debug?: boolean;
     hierarchyType?: 'grid' | 'tree';
     conditions?: Conditions;
     totals?: Totals | null;
-    tooltip?: Tooltip<T>;
+    tooltip?: Tooltip<T, Icon, Text>;
     interaction?: InteractionOptions;
     pagination?: P;
     frozenRowHeader?: boolean;
@@ -2963,6 +2992,7 @@ declare interface S2BasicOptions<T = TooltipContentType_2, P = Pagination_2> {
     /** ***********CUSTOM CELL/HEADER HOOKS**************** */
     dataCell?: DataCellCallback;
     cornerCell?: CellCallback<CornerHeaderConfig>;
+    seriesNumberCell?: CellCallback<BaseHeaderConfig>;
     rowCell?: CellCallback<RowHeaderConfig>;
     colCell?: CellCallback<ColHeaderConfig>;
     frame?: FrameCallback;
@@ -2972,12 +3002,10 @@ declare interface S2BasicOptions<T = TooltipContentType_2, P = Pagination_2> {
     layoutArrange?: LayoutArrange;
     layoutCoordinate?: LayoutCoordinate;
     layoutDataPosition?: LayoutDataPosition;
-    /** ***********CUSTOM DATA CELL RENDER HOOKS**************** */
-    filterDisplayDataItem?: FilterDataItemCallback;
-    mappingDisplayDataItem?: MappingDataItemCallback;
+    layoutSeriesNumberNodes?: LayoutSeriesNumberNodes;
 }
 
-declare type S2CellType_2<T extends SimpleBBox = ViewMeta_2> = DataCell_2 | HeaderCell | ColCell | CornerCell | RowCell | MergedCell | TableCornerCell | TableSeriesCell | BaseCell<T>;
+declare type S2CellType_2<T extends SimpleBBox = ViewMeta_2> = DataCell_2 | HeaderCell | ColCell | CornerCell | RowCell | SeriesNumberCell | MergedCell | TableCornerCell | TableSeriesCell | BaseCell<T>;
 
 declare interface S2DataConfig_2 {
     data: RawData_2[];
@@ -3093,7 +3121,7 @@ declare interface S2EventHandler {
 
 declare type S2MountContainer_2 = string | Element;
 
-declare interface S2Options_2<T = TooltipContentType_2, P = Pagination_2> extends S2BasicOptions<T, P>, S2TableSheetOptions, S2PivotSheetOptions {
+declare interface S2Options_2<T = TooltipContentType_2, P = Pagination_2, Icon = Element | string, Text = string> extends S2BasicOptions<T, P, Icon, Text>, S2TableSheetOptions, S2PivotSheetOptions {
     dataSet?: (spreadsheet: SpreadSheet_2) => BaseDataSet_2;
 }
 
@@ -3114,9 +3142,9 @@ declare interface S2Style {
     rowExpandDepth?: number | null;
     collapsedRows?: Record<string, boolean> | null;
     collapsedCols?: Record<string, boolean>;
-    cellCfg?: CellCfg;
-    colCfg?: ColCfg;
-    rowCfg?: RowCfg;
+    cellCfg?: CellCfg | null | undefined;
+    colCfg?: ColCfg | null | undefined;
+    rowCfg?: RowCfg | null | undefined;
     /**
      * @deprecated use options.deviceType instead
      */
@@ -3143,7 +3171,6 @@ declare class ScrollBar extends Group {
     trackLen: number;
     thumbLen: number;
     position: PointObject;
-    minThumbLen: number;
     thumbOffset: number;
     scrollTargetMaxOffset: number;
     theme: ScrollBarTheme;
@@ -3158,8 +3185,10 @@ declare class ScrollBar extends Group {
     constructor(scrollBarCfg: ScrollBarCfg);
     private getCoordinatesName;
     /**
-     * Antv/g 4.x 版本计算 bbox 有bug, 实际渲染的宽度会比给定的宽度大, 需要对其做修正
-     * 详情: https://github.com/antvis/S2/pull/1566/files#diff-3f08348041906ddf1e4f094bfe2ac32b35ff668918d3fbb952e9227ae462cc08R52
+     * Antv/g 5.0 环境下坐标修正
+     *
+     * 当 lineCap 设置为非 'butt' 后，实际绘制左右两端会多两个头，且不计入 getBBox 的计算
+     * 如长100，strokeWidth=10，实际渲染110长度的线，getBBox 仍返回100
      */
     private getCoordinatesWithBBoxExtraPadding;
     /**
@@ -3204,10 +3233,9 @@ declare interface ScrollBarCfg {
     readonly trackLen: number;
     readonly thumbLen: number;
     readonly position: PointObject;
-    readonly minThumbLen?: number;
     readonly thumbOffset?: number;
     readonly scrollTargetMaxOffset: number;
-    readonly theme?: ScrollBarTheme;
+    readonly theme?: ScrollBarTheme | undefined;
 }
 
 declare enum ScrollbarPositionType {
@@ -3219,6 +3247,8 @@ declare interface ScrollBarTheme {
     trackColor?: string;
     thumbHoverColor?: string;
     thumbColor?: string;
+    thumbHorizontalMinSize?: number;
+    thumbVerticalMinSize?: number;
     size?: number;
     hoverSize?: number;
     /** 指定如何绘制每一条线段末端，lineCap?: 'butt' | 'round' | 'square'; */
@@ -3243,16 +3273,33 @@ declare interface SelectHeaderCellInfo {
     isMultiSelection?: boolean;
 }
 
+declare class SeriesNumberCell extends BaseCell<Node_2_2> {
+    protected headerConfig: BaseHeaderConfig;
+    protected handleRestOptions(...[headerConfig]: [BaseHeaderConfig]): void;
+    get cellType(): CellTypes;
+    protected getBorderPositions(): CellBorderPosition[];
+    protected initCell(): void;
+    protected getBackgroundColor(): {
+        backgroundColor: string | undefined;
+        backgroundColorOpacity: number | undefined;
+    };
+    update(): void;
+    protected getTextStyle(): TextTheme;
+    protected getFormattedFieldValue(): FormatResult;
+    protected getMaxTextWidth(): number;
+    protected getTextPosition(): PointLike;
+    protected findFieldCondition(): Condition | undefined;
+    protected mappingValue(): MappingResult | undefined;
+}
+
 declare class SeriesNumberHeader extends BaseHeader<BaseHeaderConfig> {
-    private backgroundShape;
-    private leftBorderShape;
     /**
      * Get seriesNumber header by config
      */
     static getSeriesNumberHeader(options: {
         panelBBox: PanelBBox;
         seriesNumberWidth: number;
-        leafNodes: Node_2_2[];
+        rowsHierarchy: Hierarchy;
         spreadsheet: SpreadSheet_2;
         cornerWidth: number;
     }): SeriesNumberHeader;
@@ -3260,11 +3307,6 @@ declare class SeriesNumberHeader extends BaseHeader<BaseHeaderConfig> {
     clip(): void;
     layout(): void;
     protected offset(): void;
-    private addBackGround;
-    private addBorder;
-    private getStyle;
-    private addText;
-    private getTextPadding;
 }
 
 export declare const SheetComponent: DefineComponent<GetInitProps<SheetComponentProps, "sheetType" | "spreadsheet" | "options" | "loading" | "partDrillDown" | "renderConfig" | "adaptive" | "showPagination" | "themeCfg" | "header" | "getSpreadSheet" | "onSheetUpdate" | "onRowCellHover" | "onRowCellClick" | "onRowCellDoubleClick" | "onRowCellContextMenu" | "onRowCellMouseDown" | "onRowCellMouseUp" | "onRowCellMouseMove" | "onRowCellCollapseTreeRows" | "onRowCellScroll" | "onColCellHover" | "onColCellClick" | "onColCellDoubleClick" | "onColCellContextMenu" | "onColCellMouseDown" | "onColCellMouseUp" | "onColCellMouseMove" | "onDataCellHover" | "onDataCellClick" | "onDataCellDoubleClick" | "onDataCellContextMenu" | "onDataCellMouseDown" | "onDataCellMouseUp" | "onDataCellMouseMove" | "onDataCellTrendIconClick" | "onDataCellBrushSelection" | "onDataCellSelectMove" | "onCornerCellHover" | "onCornerCellClick" | "onCornerCellDoubleClick" | "onCornerCellContextMenu" | "onCornerCellMouseDown" | "onCornerCellMouseUp" | "onCornerCellMouseMove" | "onMergedCellsHover" | "onMergedCellsClick" | "onMergedCellsDoubleClick" | "onMergedCellsContextMenu" | "onMergedCellsMouseDown" | "onMergedCellsMouseUp" | "onMergedCellsMouseMove" | "onRangeSort" | "onRangeSorted" | "onRangeFilter" | "onRangeFiltered" | "onLayoutAfterHeaderLayout" | "onLayoutPagination" | "onLayoutCellScroll" | "onLayoutCellMounted" | "onLayoutCollapseRows" | "onLayoutAfterCollapseRows" | "onCollapseRowsAll" | "onLayoutColsExpanded" | "onLayoutColsHidden" | "onBeforeRender" | "onAfterRender" | "onMounted" | "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" | "onRowCellBrushSelection" | "onColCellBrushSelection">, {
@@ -3287,21 +3329,21 @@ loading: BooleanConstructor;
 partDrillDown: ObjectConstructor;
 header: ObjectConstructor;
 options: {
-type: PropType<S2Options_2<TooltipContentType_2, Pagination_2>>;
-default: S2Options_2<TooltipContentType_2, Pagination_2>;
+type: PropType<S2Options_2<TooltipContentType_2, Pagination_2, string | Element, string>>;
+default: S2Options_2<TooltipContentType_2, Pagination_2, string | Element, string>;
 };
 adaptive: {
 type: PropType<Adaptive>;
 default: Adaptive;
 };
-onSpreadsheet: PropType<(container: S2MountContainer_2, dataCfg: S2DataConfig_2, options: S2Options_2<TooltipContentType_2, Pagination_2>) => SpreadSheet_2>;
+onSpreadsheet: PropType<(container: S2MountContainer_2, dataCfg: S2DataConfig_2, options: S2Options_2<TooltipContentType_2, Pagination_2, string | Element, string>) => SpreadSheet_2>;
 onGetSpreadSheet: PropType<(spreadsheet: SpreadSheet_2) => void>;
 onMounted: PropType<(spreadsheet: SpreadSheet_2) => void>;
 }, {
 s2Ref: ShallowRef<SheetExpose>;
-options: S2Options_2<TooltipContentType_2, Pagination_2>;
+options: S2Options_2<TooltipContentType_2, Pagination_2, string | Element, string>;
 }, unknown, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
-spreadsheet: (container: S2MountContainer_2, dataCfg: S2DataConfig_2, options: S2Options_2<TooltipContentType_2, Pagination_2>) => SpreadSheet_2;
+spreadsheet: (container: S2MountContainer_2, dataCfg: S2DataConfig_2, options: S2Options_2<TooltipContentType_2, Pagination_2, string | Element, string>) => SpreadSheet_2;
 getSpreadSheet: (spreadsheet: SpreadSheet_2) => void;
 sheetUpdate: SheetUpdateCallback;
 rowCellHover: (data: TargetCellInfo_2) => void;
@@ -3431,14 +3473,14 @@ loading: BooleanConstructor;
 partDrillDown: ObjectConstructor;
 header: ObjectConstructor;
 options: {
-type: PropType<S2Options_2<TooltipContentType_2, Pagination_2>>;
-default: S2Options_2<TooltipContentType_2, Pagination_2>;
+type: PropType<S2Options_2<TooltipContentType_2, Pagination_2, string | Element, string>>;
+default: S2Options_2<TooltipContentType_2, Pagination_2, string | Element, string>;
 };
 adaptive: {
 type: PropType<Adaptive>;
 default: Adaptive;
 };
-onSpreadsheet: PropType<(container: S2MountContainer_2, dataCfg: S2DataConfig_2, options: S2Options_2<TooltipContentType_2, Pagination_2>) => SpreadSheet_2>;
+onSpreadsheet: PropType<(container: S2MountContainer_2, dataCfg: S2DataConfig_2, options: S2Options_2<TooltipContentType_2, Pagination_2, string | Element, string>) => SpreadSheet_2>;
 onGetSpreadSheet: PropType<(spreadsheet: SpreadSheet_2) => void>;
 onMounted: PropType<(spreadsheet: SpreadSheet_2) => void>;
 }>> & {
@@ -3552,10 +3594,10 @@ record: RawData_2;
 onScroll?: (position: CellScrollPosition_2) => any;
 onRowCellBrushSelection?: (event: FederatedPointerEvent_2) => any;
 onColCellBrushSelection?: (event: FederatedPointerEvent_2) => any;
-onSpreadsheet?: (container: S2MountContainer_2, dataCfg: S2DataConfig_2, options: S2Options_2<TooltipContentType_2, Pagination_2>) => any;
+onSpreadsheet?: (container: S2MountContainer_2, dataCfg: S2DataConfig_2, options: S2Options_2<TooltipContentType_2, Pagination_2, string | Element, string>) => any;
 onGetSpreadSheet?: (spreadsheet: SpreadSheet_2) => any;
 }, {
-options: S2Options_2<TooltipContentType_2, Pagination_2>;
+options: S2Options_2<TooltipContentType_2, Pagination_2, string | Element, string>;
 loading: boolean;
 adaptive: boolean | {
 width?: boolean;
@@ -3569,7 +3611,7 @@ onChange?: (current: number) => void;
 }> | DefineComponent<GetInitProps<SheetComponentProps, "sheetType" | "spreadsheet" | "options" | "loading" | "partDrillDown" | "renderConfig" | "adaptive" | "showPagination" | "themeCfg" | "header" | "getSpreadSheet" | "onSheetUpdate" | "onRowCellHover" | "onRowCellClick" | "onRowCellDoubleClick" | "onRowCellContextMenu" | "onRowCellMouseDown" | "onRowCellMouseUp" | "onRowCellMouseMove" | "onRowCellCollapseTreeRows" | "onRowCellScroll" | "onColCellHover" | "onColCellClick" | "onColCellDoubleClick" | "onColCellContextMenu" | "onColCellMouseDown" | "onColCellMouseUp" | "onColCellMouseMove" | "onDataCellHover" | "onDataCellClick" | "onDataCellDoubleClick" | "onDataCellContextMenu" | "onDataCellMouseDown" | "onDataCellMouseUp" | "onDataCellMouseMove" | "onDataCellTrendIconClick" | "onDataCellBrushSelection" | "onDataCellSelectMove" | "onCornerCellHover" | "onCornerCellClick" | "onCornerCellDoubleClick" | "onCornerCellContextMenu" | "onCornerCellMouseDown" | "onCornerCellMouseUp" | "onCornerCellMouseMove" | "onMergedCellsHover" | "onMergedCellsClick" | "onMergedCellsDoubleClick" | "onMergedCellsContextMenu" | "onMergedCellsMouseDown" | "onMergedCellsMouseUp" | "onMergedCellsMouseMove" | "onRangeSort" | "onRangeSorted" | "onRangeFilter" | "onRangeFiltered" | "onLayoutAfterHeaderLayout" | "onLayoutPagination" | "onLayoutCellScroll" | "onLayoutCellMounted" | "onLayoutCollapseRows" | "onLayoutAfterCollapseRows" | "onCollapseRowsAll" | "onLayoutColsExpanded" | "onLayoutColsHidden" | "onBeforeRender" | "onAfterRender" | "onMounted" | "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" | "onRowCellBrushSelection" | "onColCellBrushSelection">, {
 s2Ref: ShallowRef<SheetExpose>;
 }, unknown, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
-spreadsheet: (container: S2MountContainer_2, dataCfg: S2DataConfig_2, options: S2Options_2<TooltipContentType_2, Pagination_2>) => SpreadSheet_2;
+spreadsheet: (container: S2MountContainer_2, dataCfg: S2DataConfig_2, options: S2Options_2<TooltipContentType_2, Pagination_2, string | Element, string>) => SpreadSheet_2;
 getSpreadSheet: (spreadsheet: SpreadSheet_2) => void;
 sheetUpdate: SheetUpdateCallback;
 rowCellHover: (data: TargetCellInfo_2) => void;
@@ -3792,11 +3834,11 @@ record: RawData_2;
 onScroll?: (position: CellScrollPosition_2) => any;
 onRowCellBrushSelection?: (event: FederatedPointerEvent_2) => any;
 onColCellBrushSelection?: (event: FederatedPointerEvent_2) => any;
-onSpreadsheet?: (container: S2MountContainer_2, dataCfg: S2DataConfig_2, options: S2Options_2<TooltipContentType_2, Pagination_2>) => any;
+onSpreadsheet?: (container: S2MountContainer_2, dataCfg: S2DataConfig_2, options: S2Options_2<TooltipContentType_2, Pagination_2, string | Element, string>) => any;
 onGetSpreadSheet?: (spreadsheet: SpreadSheet_2) => any;
 }, {}>>;
 }, unknown, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
-spreadsheet: (container: S2MountContainer_2, dataCfg: S2DataConfig_2, options: S2Options_2<TooltipContentType_2, Pagination_2>) => SpreadSheet_2;
+spreadsheet: (container: S2MountContainer_2, dataCfg: S2DataConfig_2, options: S2Options_2<TooltipContentType_2, Pagination_2, string | Element, string>) => SpreadSheet_2;
 getSpreadSheet: (spreadsheet: SpreadSheet_2) => void;
 sheetUpdate: SheetUpdateCallback;
 rowCellHover: (data: TargetCellInfo_2) => void;
@@ -4019,7 +4061,7 @@ record: RawData_2;
 onScroll?: (position: CellScrollPosition_2) => any;
 onRowCellBrushSelection?: (event: FederatedPointerEvent_2) => any;
 onColCellBrushSelection?: (event: FederatedPointerEvent_2) => any;
-onSpreadsheet?: (container: S2MountContainer_2, dataCfg: S2DataConfig_2, options: S2Options_2<TooltipContentType_2, Pagination_2>) => any;
+onSpreadsheet?: (container: S2MountContainer_2, dataCfg: S2DataConfig_2, options: S2Options_2<TooltipContentType_2, Pagination_2, string | Element, string>) => any;
 onGetSpreadSheet?: (spreadsheet: SpreadSheet_2) => any;
 }, {}>;
 
@@ -4219,7 +4261,6 @@ declare abstract class SpreadSheet_2 extends EE {
      * but offsetY(vertical scroll don't need animation)
      */
     updateScrollOffset(offsetConfig: OffsetConfig): void;
-    getTooltipDataItemMappingCallback(): MappingDataItemCallback | undefined;
     getCell<T extends S2CellType_2 = S2CellType_2>(target: CellEventTarget): T | null;
     getCellType(target: CellEventTarget): CellTypes | undefined;
     /**
@@ -4341,6 +4382,7 @@ declare class TableColCell extends ColCell {
     protected getTextStyle(): TextTheme;
     protected getHorizontalResizeAreaName(): string;
     protected drawBackgroundShape(): void;
+    protected handleViewport(viewport: AreaRange): AreaRange;
 }
 
 declare class TableCornerCell extends TableColCell {
@@ -4364,7 +4406,7 @@ declare class TableSeriesCell extends TableDataCell {
 export declare const TableSheet: DefineComponent<GetInitProps<SheetComponentProps, "sheetType" | "spreadsheet" | "options" | "loading" | "partDrillDown" | "renderConfig" | "adaptive" | "showPagination" | "themeCfg" | "header" | "getSpreadSheet" | "onSheetUpdate" | "onRowCellHover" | "onRowCellClick" | "onRowCellDoubleClick" | "onRowCellContextMenu" | "onRowCellMouseDown" | "onRowCellMouseUp" | "onRowCellMouseMove" | "onRowCellCollapseTreeRows" | "onRowCellScroll" | "onColCellHover" | "onColCellClick" | "onColCellDoubleClick" | "onColCellContextMenu" | "onColCellMouseDown" | "onColCellMouseUp" | "onColCellMouseMove" | "onDataCellHover" | "onDataCellClick" | "onDataCellDoubleClick" | "onDataCellContextMenu" | "onDataCellMouseDown" | "onDataCellMouseUp" | "onDataCellMouseMove" | "onDataCellTrendIconClick" | "onDataCellBrushSelection" | "onDataCellSelectMove" | "onCornerCellHover" | "onCornerCellClick" | "onCornerCellDoubleClick" | "onCornerCellContextMenu" | "onCornerCellMouseDown" | "onCornerCellMouseUp" | "onCornerCellMouseMove" | "onMergedCellsHover" | "onMergedCellsClick" | "onMergedCellsDoubleClick" | "onMergedCellsContextMenu" | "onMergedCellsMouseDown" | "onMergedCellsMouseUp" | "onMergedCellsMouseMove" | "onRangeSort" | "onRangeSorted" | "onRangeFilter" | "onRangeFiltered" | "onLayoutAfterHeaderLayout" | "onLayoutPagination" | "onLayoutCellScroll" | "onLayoutCellMounted" | "onLayoutCollapseRows" | "onLayoutAfterCollapseRows" | "onCollapseRowsAll" | "onLayoutColsExpanded" | "onLayoutColsHidden" | "onBeforeRender" | "onAfterRender" | "onMounted" | "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" | "onRowCellBrushSelection" | "onColCellBrushSelection">, {
 s2Ref: ShallowRef<SheetExpose>;
 }, unknown, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
-spreadsheet: (container: S2MountContainer_2, dataCfg: S2DataConfig_2, options: S2Options_2<TooltipContentType_2, Pagination_2>) => SpreadSheet_2;
+spreadsheet: (container: S2MountContainer_2, dataCfg: S2DataConfig_2, options: S2Options_2<TooltipContentType_2, Pagination_2, string | Element, string>) => SpreadSheet_2;
 getSpreadSheet: (spreadsheet: SpreadSheet_2) => void;
 sheetUpdate: SheetUpdateCallback;
 rowCellHover: (data: TargetCellInfo_2) => void;
@@ -4587,7 +4629,7 @@ record: RawData_2;
 onScroll?: (position: CellScrollPosition_2) => any;
 onRowCellBrushSelection?: (event: FederatedPointerEvent_2) => any;
 onColCellBrushSelection?: (event: FederatedPointerEvent_2) => any;
-onSpreadsheet?: (container: S2MountContainer_2, dataCfg: S2DataConfig_2, options: S2Options_2<TooltipContentType_2, Pagination_2>) => any;
+onSpreadsheet?: (container: S2MountContainer_2, dataCfg: S2DataConfig_2, options: S2Options_2<TooltipContentType_2, Pagination_2, string | Element, string>) => any;
 onGetSpreadSheet?: (spreadsheet: SpreadSheet_2) => any;
 }, {}>;
 
@@ -4623,11 +4665,11 @@ declare interface ThemeCfg_2 {
 
 declare type ThemeName = 'default' | 'colorful' | 'gray';
 
-declare interface Tooltip<T = TooltipContentType_2> extends BaseTooltipConfig<T> {
-    row?: BaseTooltipConfig<T>;
-    col?: BaseTooltipConfig<T>;
-    corner?: BaseTooltipConfig<T>;
-    data?: BaseTooltipConfig<T>;
+declare interface Tooltip<T = TooltipContentType_2, Icon = Element | string, Text = string> extends BaseTooltipConfig<T, Icon, Text> {
+    row?: BaseTooltipConfig<T, Icon, Text>;
+    col?: BaseTooltipConfig<T, Icon, Text>;
+    corner?: BaseTooltipConfig<T, Icon, Text>;
+    data?: BaseTooltipConfig<T, Icon, Text>;
 }
 
 declare type TooltipAutoAdjustBoundary = 'body' | 'container' | null | undefined;
@@ -4667,7 +4709,7 @@ declare type TooltipInterpretationOptions = {
     render?: Element | string;
 };
 
-declare interface TooltipOperation extends TooltipOperatorOptions {
+declare interface TooltipOperation<Icon = Element | string, Text = string> extends TooltipOperatorOptions<Icon, Text> {
     hiddenColumns?: boolean;
     trend?: boolean;
     sort?: boolean;
@@ -4679,24 +4721,24 @@ declare type TooltipOperatorClickHandler = (params: {
     [key: string]: unknown;
 }) => void;
 
-declare interface TooltipOperatorMenu {
+declare interface TooltipOperatorMenu<Icon = Element | string, Text = string> {
     key: string;
-    icon?: Element | string;
-    text?: string;
+    icon?: Icon;
+    text?: Text;
     onClick?: (cell: S2CellType_2) => void;
     visible?: boolean | ((cell: S2CellType_2) => boolean);
-    children?: TooltipOperatorMenu[];
+    children?: TooltipOperatorMenu<Icon, Text>[];
 }
 
-declare interface TooltipOperatorOptions {
+declare interface TooltipOperatorOptions<Icon = Element | string, Text = string> {
     onClick?: TooltipOperatorClickHandler;
-    menus?: TooltipOperatorMenu[];
+    menus?: TooltipOperatorMenu<Icon, Text>[];
     defaultSelectedKeys?: string[];
 }
 
-declare interface TooltipOptions {
+declare interface TooltipOptions<Icon = Element | string, Text = string> {
     hideSummary?: boolean;
-    operator?: TooltipOperatorOptions;
+    operator?: TooltipOperatorOptions<Icon, Text>;
     enterable?: boolean;
     isTotals?: boolean;
     showSingleTips?: boolean;
@@ -4705,22 +4747,19 @@ declare interface TooltipOptions {
     forceRender?: boolean;
 }
 
-declare interface TooltipPosition {
-    x: number;
-    y: number;
-}
+declare type TooltipPosition = Point;
 
 declare interface TooltipPositionInfo {
     position: TooltipPosition;
     event: FederatedPointerEvent | MouseEvent;
 }
 
-declare type TooltipShowOptions<T = TooltipContentType_2> = {
+declare type TooltipShowOptions<T = TooltipContentType_2, Icon = Element | string, Text = string> = {
     position: TooltipPosition;
     data?: TooltipData;
     cellInfos?: TooltipDataItem[];
-    options?: TooltipOptions;
-    content?: ((cell: S2CellType_2, defaultTooltipShowOptions: TooltipShowOptions<T>) => T) | T;
+    options?: TooltipOptions<Icon, Text>;
+    content?: ((cell: S2CellType_2, defaultTooltipShowOptions: TooltipShowOptions<T, Icon, Text>) => T) | T;
     event?: FederatedPointerEvent | MouseEvent;
 };
 
@@ -4825,7 +4864,7 @@ declare type ViewMetaIndexType = keyof Pick<ViewMeta_2, 'colIndex' | 'rowIndex'>
  * 移动端滚动事件
  * @see https://github.com/antvis/g-gesture/blob/master/src/event/wheel.ts
  */
-declare class Wheel extends EE {
+declare class WheelEvent_2 extends EE {
     private canvas;
     private panning;
     private preX;