@antv/s2-vue 2.0.0-next.6 → 2.0.0-next.8

package/esm/index.d.ts

@@ -1,11 +1,14 @@
 import { AllowedComponentProps } from 'vue';
 import { BaseTooltip } from '@antv/s2';
+import { BaseTooltipOperatorMenuOptions } from '@antv/s2';
 import { Canvas } from '@antv/g';
-import { CellScrollPosition } from '@antv/s2';
+import type { CanvasConfig } from '@antv/g';
+import type { CellScrollPosition } from '@antv/s2';
 import { ComponentCustomProps } from 'vue';
 import { ComponentOptionsMixin } from 'vue';
 import { ComputedRef } from 'vue';
 import type * as CSS_2 from 'csstype';
+import { CSSGlobalKeywords } from '@antv/g-lite/dist/css';
 import { DataCell } from '@antv/s2';
 import { DebouncedFunc } from 'lodash';
 import { DefineComponent } from 'vue';
@@ -16,8 +19,11 @@ import { ExtractPropTypes } from 'vue';
 import { FederatedPointerEvent } from '@antv/g';
 import { GEvent } from '@antv/s2';
 import { Group } from '@antv/g';
+import { Group as Group_2 } from '@antv/g-lite';
+import type { HeaderActionIcon } from '@antv/s2';
 import { HiddenColumnsInfo } from '@antv/s2';
 import { ICanvas } from '@antv/g';
+import type { IEventTarget } from '@antv/g';
 import { Image as Image_2 } from '@antv/g';
 import { ImageStyleProps } from '@antv/g';
 import { LayoutResult } from '@antv/s2';
@@ -32,6 +38,7 @@ import { Polygon } from '@antv/g';
 import { PropType } from 'vue';
 import { RawData } from '@antv/s2';
 import { Rect } from '@antv/g';
+import { Rectangle } from '@antv/g';
 import { Ref } from 'vue';
 import { ResizeInfo } from '@antv/s2';
 import { ResizeParams } from '@antv/s2';
@@ -41,6 +48,7 @@ import { S2DataConfig } from '@antv/s2';
 import { S2MountContainer } from '@antv/s2';
 import { S2Options } from '@antv/s2';
 import { S2RenderOptions } from '@antv/s2';
+import { ScrollOffset } from '@antv/s2';
 import { ShallowRef } from 'vue';
 import { SortParams } from '@antv/s2';
 import { SpreadSheet } from '@antv/s2';
@@ -50,7 +58,6 @@ import { TextStyleProps } from '@antv/g';
 import { ThemeCfg } from '@antv/s2';
 import { Timer } from 'd3-timer';
 import { TooltipContentType } from '@antv/s2';
-import { ViewMeta } from '@antv/s2';
 import { ViewMetaData } from '@antv/s2';
 import { VNodeProps } from 'vue';
 
@@ -82,6 +89,7 @@ declare interface Background {
     color?: string;
 }
 
+/** 柱状图样式配置 */
 declare interface BarTheme {
     intervalPadding?: number;
     fill?: string;
@@ -111,43 +119,23 @@ declare abstract class BaseBBox implements BBox {
 declare abstract class BaseCell<T extends SimpleBBox> extends Group {
     protected meta: T;
     protected spreadsheet: SpreadSheet_2;
-    protected theme: S2Theme;
+    protected theme: InternalFullyTheme;
     protected backgroundShape: Rect | Polygon;
     protected textShape: CustomText;
     protected textShapes: CustomText[];
     protected linkFieldShape: Line;
     protected actualText: string;
-    protected actualTextWidth: number;
+    protected originalText: string;
     protected conditions: Conditions;
     protected conditionIntervalShape: Rect | undefined;
     protected conditionIconShape: GuiIcon;
     protected conditionIconShapes: GuiIcon[];
+    protected groupedIcons: GroupedIcons;
     protected stateShapes: Map<StateShapeLayer, DisplayObject<any, any>>;
-    constructor(meta: T, spreadsheet: SpreadSheet_2, ...restOptions: unknown[]);
-    getMeta(): T;
-    setMeta(viewMeta: T): void;
-    getIconStyle(): IconTheme | undefined;
-    getTextIconPosition(iconCount?: number): {
-        text: {
-            x: number;
-            y: number;
-        };
-        icon: {
-            x: number;
-            y: number;
-        };
-    };
-    getActualText(): string;
-    getFieldValue(): string;
-    /**
-     * in case there are more params to be handled
-     * @param options any type's rest params
-     */
-    protected handleRestOptions(...options: unknown[]): void;
     /**
      * Return the type of the cell
      */
-    abstract get cellType(): CellTypes;
+    abstract get cellType(): CellType;
     /**
      * Determine how to render this cell area
      */
@@ -161,13 +149,67 @@ declare abstract class BaseCell<T extends SimpleBBox> extends Group {
     protected abstract getFormattedFieldValue(): FormatResult;
     protected abstract getMaxTextWidth(): number;
     protected abstract getTextPosition(): PointLike;
+    protected abstract getIconPosition(): PointLike;
     protected abstract findFieldCondition(conditions: Condition[] | undefined): Condition | undefined;
-    protected abstract mappingValue(condition: Condition): MappingResult | undefined | null;
+    protected abstract mappingValue(condition: Condition): ConditionMappingResult | undefined | null;
+    constructor(meta: T, spreadsheet: SpreadSheet_2, ...restOptions: unknown[]);
+    /**
+     * in case there are more params to be handled
+     * @param options any type's rest params
+     */
+    protected handleRestOptions(...options: unknown[]): void;
+    getMeta(): T;
+    setMeta(viewMeta: T): void;
+    getIconStyle(): DeepRequired<IconTheme>;
+    /**
+     * 获取实际渲染的文本 (含省略号)
+     */
+    getActualText(): string;
+    /**
+     * 实际渲染的文本宽度, 如果是多行文本, 取最大的一行宽度
+     */
+    getActualTextWidth(): number;
+    /**
+     * 实际渲染的文本宽度, 如果是多行文本, 取每一行文本高度的总和)
+     * @alias getMultiLineActualTextHeight
+     */
+    getActualTextHeight(): number;
+    /**
+     * 获取实际渲染的多行文本 (含省略号)
+     */
+    getMultiLineActualTexts(): string[];
+    /**
+     * 实际渲染的多行文本宽度 (每一行文本宽度的总和)
+     */
+    getMultiLineActualTextWidth(): number;
+    /**
+     * 实际渲染的多行文本高度 (每一行文本高度的总和)
+     * @alias getActualTextHeight
+     */
+    getMultiLineActualTextHeight(): number;
+    /**
+     * 获取原始的文本 (不含省略号)
+     */
+    getOriginalText(): string;
+    /**
+     * 文本是否溢出 (有省略号)
+     */
+    isTextOverflowing(): boolean;
+    /**
+     * 是否是多行文本
+     */
+    isMultiLineText(): boolean;
+    getEmptyPlaceholder(): string | undefined;
+    /**
+     * 获取文本包围盒
+     */
+    getTextLineBoundingRects(): Rectangle[];
+    getFieldValue(): string;
     protected shouldInit(): boolean;
-    getStyle<K extends keyof S2Theme = keyof CellThemes>(name?: K): DefaultCellTheme | S2Theme[K];
+    getStyle<K extends keyof InternalFullyTheme = CellType>(name?: K): InternalFullyTheme[K] | InternalFullyCellTheme;
     getLinkFieldShape(): Line;
     protected getResizeAreaStyle(): ResizeArea;
-    protected shouldDrawResizeAreaByType(type: keyof ResizeInteractionOptions, cell: S2CellType_2): boolean | ((cell: S2CellType_2<ViewMeta_2>) => boolean) | ResizeType | ((resizeInfo: ResizeInfo_2) => boolean) | undefined;
+    protected shouldDrawResizeAreaByType(type: keyof ResizeInteractionOptions, cell: S2CellType_2): boolean | ResizeType | ((resizeInfo: ResizeInfo_2) => boolean) | ((cell: S2CellType_2) => boolean) | undefined;
     getBBoxByType(type?: CellClipBox): SimpleBBox;
     drawBorders(): void;
     /**
@@ -177,18 +219,19 @@ declare abstract class BaseCell<T extends SimpleBBox> extends Group {
     protected abstract getBackgroundColor(): {
         backgroundColor: string | undefined;
         backgroundColorOpacity: number | undefined;
+        intelligentReverseTextColor: boolean;
     };
     protected drawBackgroundShape(): void;
     /**
      * 交互使用的背景色
      */
     protected drawInteractiveBgShape(): void;
-    protected getIconPosition(iconCount?: number): {
-        x: number;
-        y: number;
-    };
-    protected drawTextShape(): void;
+    renderTextShape(style: TextStyleProps, options?: RenderTextShapeOptions): CustomText;
+    updateTextPosition(position?: PointLike): void;
+    drawTextShape(options?: RenderTextShapeOptions): void;
     protected drawLinkFieldShape(showLinkFieldShape: boolean, linkFillColor: string): void;
+    protected getLinkFieldStyle(): string;
+    protected drawLinkField(meta: Node_2_2 | ViewMeta): void;
     updateByState(stateName: InteractionStateName, cell: S2CellType_2): void;
     protected getInteractiveBorderShapeStyle<T>(borderSize: T & number): {
         x: number;
@@ -207,7 +250,44 @@ declare abstract class BaseCell<T extends SimpleBBox> extends Group {
     resetTextAndConditionIconShapes(): void;
     get cellConditions(): Conditions;
     drawConditionIconShapes(): void;
-    getTextConditionFill(textStyle: TextTheme): string | undefined;
+    getTextConditionMappingResult(): ConditionMappingResult | null | undefined;
+    getContainConditionMappingResultTextStyle(style: TextTheme | undefined): {
+        fill: string;
+        minValue?: number | undefined;
+        maxValue?: number | undefined;
+        icon?: string | undefined;
+        isCompare?: boolean | undefined;
+        intelligentReverseTextColor?: boolean | undefined;
+        fieldValue?: number | undefined;
+        fontSize?: number | undefined;
+        linkTextFill?: string | undefined;
+        textAlign?: TextAlign | undefined;
+        textBaseline?: TextBaseline | undefined;
+        opacity?: string | number | undefined;
+        fontFamily?: string | undefined;
+        fontWeight?: number | "bold" | CSSGlobalKeywords | "normal" | "bolder" | "lighter" | undefined;
+        wordWrap?: boolean | undefined;
+        maxLines?: number | undefined;
+        lineHeight?: string | number | undefined;
+        textOverflow?: string | undefined;
+        fontStyle?: CSSGlobalKeywords | "normal" | "italic" | "oblique" | undefined;
+        fontVariant?: string | undefined;
+    };
+    /**
+     * 获取默认字体颜色：根据字段标记背景颜色，设置字体颜色
+     * @param textStyle
+     * @private
+     */
+    protected getDefaultTextFill(textFill: string): string;
+    getBackgroundConditionFill(): {
+        backgroundColor: string | undefined;
+        intelligentReverseTextColor: boolean;
+    } | {
+        intelligentReverseTextColor: boolean;
+        backgroundColor?: undefined;
+    };
+    getIconConditionResult(): HeaderActionNameOptions | undefined;
+    protected getActionAndConditionIconWidth(position?: IconPosition): number;
 }
 
 declare interface BaseCellStyle {
@@ -269,15 +349,36 @@ declare interface BaseDataSet {
 }
 
 declare abstract class BaseDataSet_2 {
+    /**
+     * 字段信息
+     */
     fields: Fields;
+    /**
+     * 字段元信息，包含有字段名、格式化、描述等
+     */
     meta: Meta[];
+    /**
+     * 原始数据
+     */
     originData: RawData_2[];
+    /**
+     * 二维索引数据
+     */
     indexesData: RawData_2[][] | RawData_2[];
+    /**
+     * 高级排序, 组内排序
+     */
     sortParams: SortParams_2 | undefined;
+    /**
+     * 筛选配置
+     */
     filterParams: FilterParam[] | undefined;
+    /**
+     * 表格实例
+     */
     protected spreadsheet: SpreadSheet_2;
-    constructor(spreadsheet: SpreadSheet_2);
     protected displayData: RawData_2[];
+    constructor(spreadsheet: SpreadSheet_2);
     private getField;
     /**
      * 获取字段信息
@@ -292,12 +393,12 @@ declare abstract class BaseDataSet_2 {
      * 获取自定义单元格字段名称
      * @param cell
      */
-    getCustomRowFieldName(cell: S2CellType_2<ViewMeta_2 | Node_2_2>): string | undefined;
+    getCustomRowFieldName(cell: S2CellType_2<ViewMeta | Node_2_2>): string | undefined;
     /**
      * 获取自定义单元格字段描述
      * @param cell
      */
-    getCustomFieldDescription: (cell: S2CellType_2<ViewMeta_2 | Node_2_2>) => string | undefined;
+    getCustomFieldDescription: (cell: S2CellType_2<ViewMeta | Node_2_2>) => string | undefined;
     /**
      * 获得字段格式方法
      * @param field
@@ -308,7 +409,15 @@ declare abstract class BaseDataSet_2 {
      * @param field
      */
     getFieldDescription(field: CustomHeaderField): string | undefined;
+    /**
+     * 设置数据配置
+     * @param dataCfg
+     */
     setDataCfg(dataCfg: S2DataConfig_2): void;
+    /**
+     * 添加 (角头/数值虚拟字段) 格式化信息
+     */
+    getFieldMetaWithExtraField(meta: Meta[] | undefined, defaultExtraFieldText: string): Meta[];
     getDisplayDataSet(): RawData_2[];
     getValueRangeByField(field: string): ValueRange;
     /** ******************NEED IMPLEMENT BY USER CASE************************ */
@@ -318,6 +427,7 @@ declare abstract class BaseDataSet_2 {
      */
     abstract processDataCfg(dataCfg: S2DataConfig_2): S2DataConfig_2;
     /**
+     * 获取指定字段下的维值
      * 1、query !== null
      * province  city => field
      *   辽宁省
@@ -331,30 +441,28 @@ declare abstract class BaseDataSet_2 {
      *  query param is not necessary, when just
      *  get some field's all dimension values
      *
-     * @param field current dimensions
-     * @param query dimension value query
+     * @param field
+     * @param query
      */
     abstract getDimensionValues(field: string, query?: Query): string[];
     /**
-     * In most cases, this function to get the specific
-     * cross data cell data
-     * @param params
+     * 获取单个的单元格数据
      */
-    abstract getCellData(params: CellDataParams): ViewMetaData_2 | undefined;
+    abstract getCellData(params: GetCellDataParams): ViewMetaData_2 | undefined;
     /**
-     * To get a row or column cells data;
-     * if query is empty, return all data
-     * @param query
-     * @param totals @TotalSelectionsOfMultiData
-     * @param drillDownFields
+     * 获取批量的单元格数据
+     * 如果 query 为空, 则返回全量数据
+     */
+    abstract getCellMultiData(params: GetCellMultiDataParams): ViewMetaData_2[];
+    /**
+     * 是否超过 1 个数值
      */
-    abstract getMultiData(query: Query, totals?: TotalSelectionsOfMultiData, drillDownFields?: string[]): Data[] | CellData[];
     moreThanOneValue(): boolean;
     /**
      * get a row cells data including cell
-     * @param cells
+     * @param cellMeta
      */
-    abstract getRowData(cells: CellMeta): RowData;
+    abstract getRowData(cellMeta: CellMeta): RowData;
 }
 
 declare interface BaseDrillDownComponentProps<DataSet = BaseDataSet> {
@@ -393,7 +501,11 @@ declare abstract class BaseFacet {
     frozenTopGroup: FrozenGroup;
     frozenBottomGroup: FrozenGroup;
     foregroundGroup: Group;
-    layoutResult: LayoutResult_2;
+    /**
+     * 当前布局节点信息
+     * @description 内部消费, 外部调用请使用 facet.getLayoutResult()
+     */
+    private layoutResult;
     viewCellWidths: number[];
     viewCellHeights: ViewCellHeights;
     protected mobileWheel: WheelEvent_2;
@@ -408,12 +520,15 @@ declare abstract class BaseFacet {
     centerFrame: Frame;
     gridInfo: GridInfo;
     protected abstract doLayout(): LayoutResult_2;
-    abstract getViewCellHeights(layoutResult: LayoutResult_2): ViewCellHeights;
+    abstract getViewCellHeights(): ViewCellHeights;
+    abstract getCellMeta(rowIndex: number, colIndex: number): ViewMeta | null;
+    protected abstract getColNodeHeight(colNode: Node_2_2, colsHierarchy: Hierarchy): number;
     protected scrollFrameId: ReturnType<typeof requestAnimationFrame> | null;
-    get scrollBarTheme(): ScrollBarTheme | undefined;
+    get scrollBarTheme(): DeepRequired<ScrollBarTheme>;
     get scrollBarSize(): number;
     protected preCellIndexes: PanelIndexes | null;
     constructor(spreadsheet: SpreadSheet_2);
+    getLayoutResult: () => LayoutResult_2;
     protected initGroups(): void;
     protected initPanelGroups(): void;
     protected getCellCustomSize(node: Node_2_2 | null, size: CellCustomSize): number | null | undefined;
@@ -422,7 +537,12 @@ declare abstract class BaseFacet {
     protected getRowCellHeight(node: Node_2_2): number;
     protected getColCellDraggedWidth(node: Node_2_2): number | undefined;
     protected getColCellDraggedHeight(node: Node_2_2): number | undefined;
-    protected getDefaultColNodeHeight(colNode: Node_2_2): number;
+    protected getDefaultColNodeHeight(colNode: Node_2_2, colsHierarchy: Hierarchy): number;
+    protected getCellAdaptiveHeight(cell: HeaderCell, defaultHeight: number): number;
+    /**
+     * 将每一层级的采样节点更新为高度最大的节点 (未隐藏, 非汇总节点)
+     */
+    protected updateColsHierarchySampleMaxHeightNodes(colsHierarchy: Hierarchy): void;
     hideScrollBar: () => void;
     delayHideScrollBar: DebouncedFunc<() => void>;
     delayHideScrollbarOnMobile: () => void;
@@ -453,8 +573,8 @@ declare abstract class BaseFacet {
     updateScrollOffset(offsetConfig: OffsetConfig): void;
     getPaginationScrollY(): number;
     destroy(): void;
-    setScrollOffset: (scrollOffset: ScrollOffset) => void;
-    getScrollOffset: () => Required<ScrollOffset>;
+    setScrollOffset: (scrollOffset: ScrollOffset_2) => void;
+    getScrollOffset: () => Required<ScrollOffset_2>;
     resetScrollX: () => void;
     resetRowScrollX: () => void;
     resetScrollY: () => void;
@@ -484,12 +604,12 @@ declare abstract class BaseFacet {
     scrollImmediately: (offsetConfig?: OffsetConfig) => void;
     /**
      *
-     * @param skipScrollEvent 如为true则不触发S2Event.GLOBAL_SCROLL
+     * @param skipScrollEvent 不触发 S2Event.GLOBAL_SCROLL
      */
     startScroll: (skipScrollEvent?: boolean) => void;
-    getRendererHeight: () => number;
+    private getRendererHeight;
     private getAdjustedScrollOffset;
-    renderRowScrollBar: (rowScrollX: number) => void;
+    private renderRowScrollBar;
     getValidScrollBarOffset: (offset: number, maxOffset: number) => number;
     renderHScrollBar: (width: number, realWidth: number, scrollX: number) => void;
     private getScrollbarPosition;
@@ -516,21 +636,12 @@ declare abstract class BaseFacet {
     cancelScrollFrame: () => boolean;
     clearScrollFrameIdOnMobile: () => void;
     /**
-     *<<<<<<< HEAD
-     *https://developer.mozilla.org/zh-CN/docs/Web/CSS/overscroll-behavior
-     *阻止外部容器滚动: 表格是虚拟滚动, 这里按照标准模拟浏览器的 [overscroll-behavior] 实现
-     *1. auto => 只有在滚动到表格顶部或底部时才触发外部容器滚动
-     *1. contain => 默认的滚动边界行为不变（“触底”效果或者刷新），但是临近的滚动区域不会被滚动链影响到
-     *2. none => 临近滚动区域不受到滚动链影响，而且默认的滚动到边界的表现也被阻止
-     *所以只要不为 `auto`, 或者表格内, 都需要阻止外部容器滚动
-     *=======
-     *https://developer.mozilla.org/zh-CN/docs/Web/CSS/overscroll-behavior
-     *阻止外部容器滚动: 表格是虚拟滚动, 这里按照标准模拟浏览器的 [overscroll-behavior] 实现
-     *1. auto => 只有在滚动到表格顶部或底部时才触发外部容器滚动
-     *1. contain => 默认的滚动边界行为不变（“触底”效果或者刷新），但是临近的滚动区域不会被滚动链影响到
-     *2. none => 临近滚动区域不受到滚动链影响，而且默认的滚动到边界的表现也被阻止
-     *所以只要不为 `auto`, 或者表格内, 都需要阻止外部容器滚动
-     *>>>>>>> next
+     * https://developer.mozilla.org/zh-CN/docs/Web/CSS/overscroll-behavior
+     * 阻止外部容器滚动: 表格是虚拟滚动, 这里按照标准模拟浏览器的 [overscroll-behavior] 实现
+     * 1. auto => 只有在滚动到表格顶部或底部时才触发外部容器滚动
+     * 1. contain => 默认的滚动边界行为不变（“触底”效果或者刷新），但是临近的滚动区域不会被滚动链影响到
+     * 2. none => 临近滚动区域不受到滚动链影响，而且默认的滚动到边界的表现也被阻止
+     * 所以只要不为 `auto`, 或者表格内, 都需要阻止外部容器滚动
      */
     private stopScrollChainingIfNeeded;
     private stopScrollChaining;
@@ -544,7 +655,7 @@ declare abstract class BaseFacet {
      * @protected
      */
     protected translateRelatedGroups(scrollX: number, scrollY: number, hRowScroll: number): void;
-    addCell: (cell: S2CellType_2<ViewMeta_2>) => void;
+    addCell: (cell: S2CellType_2<ViewMeta>) => void;
     realCellRender: (scrollX: number, scrollY: number) => void;
     protected init(): void;
     protected renderBackground(): void;
@@ -586,7 +697,7 @@ declare abstract class BaseFacet {
     protected onAfterScroll: DebouncedFunc<() => void>;
     protected saveInitColumnLeafNodes(columnNodes?: Node_2_2[]): void;
     getHiddenColumnsInfo(columnNode: Node_2_2): HiddenColumnsInfo_2 | undefined;
-    getCornerNodes(): Node_2_2[];
+    updateCustomFieldsSampleNodes(colsHierarchy: Hierarchy): void;
     /**
      * @description 自定义行头时, 叶子节点层级不定, 需要自动对齐其宽度, 填充空白
      * -------------------------------------------------
@@ -608,12 +719,193 @@ declare abstract class BaseFacet {
      */
     adjustColLeafNodesHeight(params: AdjustLeafNodesParams): void;
     adjustLeafNodesSize(type: 'width' | 'height'): ({ leafNodes, hierarchy }: AdjustLeafNodesParams) => void;
+    /**
+     * 获取表头节点 (角头,序号, 行头,列头) (含可视区域)
+     * @example 获取全部: facet.getHeaderNodes()
+     * @example 获取一组 facet.getHeaderNodes(['root[&]浙江省[&]宁波市', 'root[&]浙江省[&]杭州市'])
+     */
+    getHeaderNodes(nodeIds?: string[]): Node_2_2[];
+    /**
+     * 获取角头节点
+     */
+    getCornerNodes(): Node_2_2[];
+    /**
+     * 获取序号节点
+     */
+    getSeriesNumberNodes(): Node_2_2[];
+    /**
+     * 获取列头节点 (含非可视区域)
+     * @description 获取列头单元格 (可视区域内) facet.getColCells()
+     * @example 获取全部: facet.getColNodes()
+     * @example 指定层级: facet.getColNodes(level)
+     */
+    getColNodes(level?: number): Node_2_2[];
+    /**
+     * 根据 id 获取指定列头节点
+     * @example facet.getColNodeById('root[&]节点1[&]数值')
+     */
+    getColNodeById(nodeId: string): Node_2_2 | undefined;
+    /**
+     * 根据列头索引获取指定列头节点
+     * @example facet.getColNodeByIndex(colIndex)
+     */
+    getColNodeByIndex(colIndex: number): Node_2_2 | undefined;
+    /**
+     * 根据列头索引获取指定列头叶子节点
+     * @example facet.getColLeafNodes(colIndex)
+     */
+    getColLeafNodeByIndex(colIndex: number): Node_2_2 | undefined;
+    /**
+     * 根据 field 获取指定列头节点
+     * @example facet.getColCellNodeByField('number')
+     */
+    getColNodesByField(nodeField: string): Node_2_2[];
+    /**
+     * 获取列头叶子节点节点 (含非可视区域)
+     */
+    getColLeafNodes(): Node_2_2[];
+    /**
+     * 获取列头小计/总计节点 (含非可视区域)
+     * @example 获取全部: facet.getColTotalsNodes()
+     * @example 指定层级: facet.getColTotalsNodes(level)
+     */
+    getColTotalsNodes(level?: number): Node_2_2[];
+    /**
+     * 获取列头小计节点 (含非可视区域)
+     * @example 获取全部: facet.getColSubTotalsNodes()
+     * @example 指定层级: facet.getColSubTotalsNodes(level)
+     */
+    getColSubTotalsNodes(level?: number): Node_2_2[];
+    /**
+     * 获取列头总计节点 (含非可视区域)
+     * @example 获取全部: facet.getColGrandTotalsNodes()
+     * @example 指定层级: facet.getColGrandTotalsNodes(level)
+     */
+    getColGrandTotalsNodes(level?: number): Node_2_2[];
+    /**
+     * 获取行头节点 (含非可视区域)
+     * @description 获取行头单元格 (可视区域内) facet.getRowCells()
+     * @example 获取全部: facet.getRowNodes()
+     * @example 指定层级: facet.getRowNodes(level)
+     */
+    getRowNodes(level?: number): Node_2_2[];
+    /**
+     * 根据 id 获取单个行头节点
+     * @example facet.getRowNodeById('root[&]节点1[&]数值')
+     */
+    getRowNodeById(nodeId: string): Node_2_2 | undefined;
+    /**
+     * 根据行头索引获取指定列头节点
+     * @example facet.getRowNodeByIndex(rowIndex)
+     */
+    getRowNodeByIndex(rowIndex: number): Node_2_2 | undefined;
+    /**
+     * 根据行头索引获取指定列头叶子节点
+     * @example facet.getRowLeafNodeByIndex(rowIndex)
+     */
+    getRowLeafNodeByIndex(rowIndex: number): Node_2_2 | undefined;
+    /**
+     * 根据 field 获取行头节点
+     * @example facet.getRowNodeByField('number')
+     */
+    getRowNodesByField(nodeField: string): Node_2_2[];
+    /**
+     * 获取行头叶子节点节点 (含非可视区域)
+     */
+    getRowLeafNodes(): Node_2_2[];
+    /**
+     * 获取行头小计/总计节点 (含非可视区域)
+     * @example 获取全部: facet.getRowTotalsNodes()
+     * @example 指定层级: facet.getRowTotalsNodes(level)
+     */
+    getRowTotalsNodes(level?: number): Node_2_2[];
+    /**
+     * 获取行头小计节点 (含非可视区域)
+     * @example 获取全部: facet.getRowSubTotalsNodes()
+     * @example 指定层级: facet.getRowSubTotalsNodes(level)
+     */
+    getRowSubTotalsNodes(level?: number): Node_2_2[];
+    /**
+     * 获取行头总计节点 (含非可视区域)
+     * @example 获取全部: facet.getRowGrandTotalsNodes()
+     * @example 指定层级: facet.getRowGrandTotalsNodes(level)
+     */
+    getRowGrandTotalsNodes(level?: number): Node_2_2[];
+    /**
+     * 获取单元格的所有子节点 (含非可视区域)
+     * @example
+     * const rowCell = facet.getRowCells()[0]
+     * facet.getCellChildrenNodes(rowCell)
+     */
+    getCellChildrenNodes: (cell: S2CellType_2) => Node_2_2[];
+    /**
+     * 获取数值单元格 (不含可视区域)
+     * @description 由于虚拟滚动, 按需加载的特性, 非可视区域的单元格未被实例化
+     * @example 获取非可视区域的数值节点 facet.getCellMeta(rowIndex, colIndex)
+     */
+    getDataCells(): DataCell_2[];
+    /**
+     * 获取行头单元格 (不含可视区域)
+     */
+    getRowCells(): RowCell[];
+    /**
+     * 获取行头叶子节点单元格 (不含可视区域)
+     */
+    getRowLeafCells(): RowCell[];
+    /**
+     * 获取列头单元格 (不含可视区域)
+     */
+    getColCells(): ColCell[];
+    /**
+     * 获取列头叶子节点单元格 (不含可视区域)
+     */
+    getColLeafCells(): ColCell[];
+    /**
+     * 获取合并单元格 (不含可视区域)
+     */
+    getMergedCells(): MergedCell[];
+    /**
+     * 获取角头单元格
+     */
+    getCornerCells(): CornerCell[];
+    /**
+     * 获取序号单元格
+     */
+    abstract getSeriesNumberCells(): SeriesNumberCell[] | TableSeriesNumberCell[];
+    /**
+     * 获取表头单元格 (角头,行头,列头) (不含可视区域)
+     * @example 获取全部: facet.getHeaderCells()
+     * @example 获取一组 facet.getHeaderCells(['root[&]浙江省[&]宁波市', 'root[&]浙江省[&]杭州市'])
+     */
+    getHeaderCells(cellIds?: string[]): S2CellType_2<ViewMeta>[];
+    /**
+     * 根据单元格 id 获取指定单元格 (不含可视区域)
+     * @example facet.getCellById('root[&]浙江省[&]宁波市')
+     */
+    getCellById(cellId: string): S2CellType_2<ViewMeta> | undefined;
+    /**
+     * 根据单元格 field 获取指定单元格 (不含可视区域)
+     * @example facet.getCellByField('city')
+     */
+    getCellsByField(cellField: string): S2CellType_2<ViewMeta>[];
+    /**
+     * 获取所有单元格 (角头,行头,列头,数值) (不含可视区域)
+     * @example 获取全部: facet.getCells()
+     * @example 获取一组 facet.getCells(['root[&]浙江省[&]宁波市', 'root[&]浙江省[&]杭州市'])
+     */
+    getCells(cellIds?: string[]): S2CellType_2<ViewMeta>[];
+    getInitColLeafNodes(): Node_2_2[];
+    clearInitColLeafNodes(): void;
 }
 
 declare interface BaseFields {
+    /** 行头字段 */
     rows?: CustomHeaderFields;
+    /** 列头字段 */
     columns?: CustomHeaderFields;
+    /** 数值字段 */
     values?: string[];
+    /** 数值是否置于列头 (透视表有效) */
     valueInCols?: boolean;
 }
 
@@ -623,8 +915,12 @@ declare interface BaseFields {
  * use {@see headerConfig} instead
  */
 declare abstract class BaseHeader<T extends BaseHeaderConfig> extends Group {
+    protected abstract layout(): void;
+    protected abstract offset(): void;
+    protected abstract clip(): void;
+    protected abstract getCellInstance(node: Node_2_2): S2CellType_2;
     protected headerConfig: T;
-    protected constructor(cfg: T);
+    protected constructor(config: T);
     getHeaderConfig(): T;
     /**
      * 清空热区，为重绘做准备，防止热区重复渲染
@@ -641,13 +937,10 @@ declare abstract class BaseHeader<T extends BaseHeaderConfig> extends Group {
     onScrollXY(scrollX: number, scrollY: number, type: string): void;
     /**
      * Only call when hRowScrollBar scrolls
-     * @param rowScrollX  hRowScrollbar horizontal offset
+     * @param rowHeaderScrollX  hRowScrollbar horizontal offset
      * @param type
      */
-    onRowScrollX(rowScrollX: number, type: string): void;
-    protected abstract layout(): void;
-    protected abstract offset(): void;
-    protected abstract clip(): void;
+    onRowScrollX(rowHeaderScrollX: number, type: string): void;
     clear(): void;
     /**
      * Check whether header cell in viewPort
@@ -733,14 +1026,14 @@ loading: BooleanConstructor;
 partDrillDown: ObjectConstructor;
 header: ObjectConstructor;
 options: {
-type: PropType<S2Options<TooltipContentType, Pagination, string | Element, string>>;
-default: S2Options<TooltipContentType, Pagination, string | Element, string>;
+type: PropType<S2Options<TooltipContentType, Pagination, BaseTooltipOperatorMenuOptions>>;
+default: S2Options<TooltipContentType, Pagination, BaseTooltipOperatorMenuOptions>;
 };
 adaptive: {
 type: PropType<Adaptive>;
 default: Adaptive;
 };
-onSpreadsheet: PropType<(container: S2MountContainer, dataCfg: S2DataConfig, options: S2Options<TooltipContentType, Pagination, string | Element, string>) => SpreadSheet>;
+onSpreadsheet: PropType<(container: S2MountContainer, dataCfg: S2DataConfig, options: S2Options<TooltipContentType, Pagination, BaseTooltipOperatorMenuOptions>) => SpreadSheet>;
 onMounted: PropType<(spreadsheet: SpreadSheet) => void>;
 }, {
 S2_PREFIX_CLS: string;
@@ -759,7 +1052,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, string | Element, string>) => SpreadSheet;
+spreadsheet: (container: S2MountContainer, dataCfg: S2DataConfig, options: S2Options<TooltipContentType, Pagination, BaseTooltipOperatorMenuOptions>) => SpreadSheet;
 sheetUpdate: SheetUpdateCallback;
 rowCellHover: (data: TargetCellInfo) => void;
 rowCellClick: (data: TargetCellInfo) => void;
@@ -770,7 +1063,7 @@ rowCellMouseUp: (data: TargetCellInfo) => void;
 rowCellMouseMove: (data: TargetCellInfo) => void;
 rowCellCollapsed: (params: RowCellCollapsedParams) => void;
 rowCellAllCollapsed: (isCollapsed: boolean) => void;
-rowCellScroll: (position: CellScrollPosition) => void;
+rowCellScroll: (position: Required<ScrollOffset>) => void;
 colCellHover: (data: TargetCellInfo) => void;
 colCellClick: (data: TargetCellInfo) => void;
 colCellDoubleClick: (data: TargetCellInfo) => void;
@@ -791,7 +1084,7 @@ dataCellMouseDown: (data: TargetCellInfo) => void;
 dataCellMouseUp: (data: TargetCellInfo) => void;
 dataCellMouseMove: (data: TargetCellInfo) => void;
 dataCellBrushSelection: (brushRangeDataCells: DataCell[]) => void;
-dataCellSelectMove: (metas: ViewMetaData[]) => void;
+dataCellSelectMove: (metaList: ViewMetaData[]) => void;
 cornerCellHover: (data: TargetCellInfo) => void;
 cornerCellClick: (data: TargetCellInfo) => void;
 cornerCellDoubleClick: (data: TargetCellInfo) => void;
@@ -815,7 +1108,7 @@ filteredValues: string[];
 rangeFiltered: (data: ViewMetaData[]) => void;
 layoutAfterHeaderLayout: (layoutResult: LayoutResult) => void;
 layoutPagination: (data: LayoutPaginationParams) => void;
-layoutCellMounted: (cell: S2CellType<ViewMeta>) => void;
+layoutCellMounted: (cell: S2CellType) => void;
 beforeRender: () => void;
 afterRender: () => void;
 mounted: (spreadsheet: SpreadSheet) => void;
@@ -853,13 +1146,13 @@ mouseHover: (event: GEvent) => void;
 mouseUp: (event: MouseEvent) => void;
 mouseDown: (event: MouseEvent) => void;
 mouseMove: (event: MouseEvent) => void;
-selected: (cells: S2CellType<ViewMeta>[]) => void;
+selected: (cells: S2CellType[]) => void;
 reset: (event: KeyboardEvent) => void;
 linkFieldJump: (data: {
 field: string;
 record: RawData;
 }) => void;
-scroll: (position: CellScrollPosition) => void;
+scroll: (position: Required<ScrollOffset>) => void;
 layoutAfterRealDataCellRender: (options: {
 add: [number, number][];
 remove: [number, number][];
@@ -885,14 +1178,14 @@ loading: BooleanConstructor;
 partDrillDown: ObjectConstructor;
 header: ObjectConstructor;
 options: {
-type: PropType<S2Options<TooltipContentType, Pagination, string | Element, string>>;
-default: S2Options<TooltipContentType, Pagination, string | Element, string>;
+type: PropType<S2Options<TooltipContentType, Pagination, BaseTooltipOperatorMenuOptions>>;
+default: S2Options<TooltipContentType, Pagination, BaseTooltipOperatorMenuOptions>;
 };
 adaptive: {
 type: PropType<Adaptive>;
 default: Adaptive;
 };
-onSpreadsheet: PropType<(container: S2MountContainer, dataCfg: S2DataConfig, options: S2Options<TooltipContentType, Pagination, string | Element, string>) => SpreadSheet>;
+onSpreadsheet: PropType<(container: S2MountContainer, dataCfg: S2DataConfig, options: S2Options<TooltipContentType, Pagination, BaseTooltipOperatorMenuOptions>) => SpreadSheet>;
 onMounted: PropType<(spreadsheet: SpreadSheet) => void>;
 }>> & {
 onSheetUpdate?: (params: S2RenderOptions) => any;
@@ -905,7 +1198,7 @@ onRowCellMouseUp?: (data: TargetCellInfo) => any;
 onRowCellMouseMove?: (data: TargetCellInfo) => any;
 onRowCellCollapsed?: (params: RowCellCollapsedParams) => any;
 onRowCellAllCollapsed?: (isCollapsed: boolean) => any;
-onRowCellScroll?: (position: CellScrollPosition) => any;
+onRowCellScroll?: (position: Required<ScrollOffset>) => any;
 onColCellHover?: (data: TargetCellInfo) => any;
 onColCellClick?: (data: TargetCellInfo) => any;
 onColCellDoubleClick?: (data: TargetCellInfo) => any;
@@ -926,7 +1219,7 @@ onDataCellMouseDown?: (data: TargetCellInfo) => any;
 onDataCellMouseUp?: (data: TargetCellInfo) => any;
 onDataCellMouseMove?: (data: TargetCellInfo) => any;
 onDataCellBrushSelection?: (brushRangeDataCells: DataCell[]) => any;
-onDataCellSelectMove?: (metas: ViewMetaData[]) => any;
+onDataCellSelectMove?: (metaList: ViewMetaData[]) => any;
 onCornerCellHover?: (data: TargetCellInfo) => any;
 onCornerCellClick?: (data: TargetCellInfo) => any;
 onCornerCellDoubleClick?: (data: TargetCellInfo) => any;
@@ -950,7 +1243,7 @@ filteredValues: string[];
 onRangeFiltered?: (data: ViewMetaData[]) => any;
 onLayoutAfterHeaderLayout?: (layoutResult: LayoutResult) => any;
 onLayoutPagination?: (data: LayoutPaginationParams) => any;
-onLayoutCellMounted?: (cell: S2CellType<ViewMeta>) => any;
+onLayoutCellMounted?: (cell: S2CellType) => any;
 onBeforeRender?: () => any;
 onAfterRender?: () => any;
 onMounted?: (spreadsheet: SpreadSheet) => any;
@@ -988,13 +1281,13 @@ onMouseHover?: (event: GEvent) => any;
 onMouseUp?: (event: MouseEvent) => any;
 onMouseDown?: (event: MouseEvent) => any;
 onMouseMove?: (event: MouseEvent) => any;
-onSelected?: (cells: S2CellType<ViewMeta>[]) => any;
+onSelected?: (cells: S2CellType[]) => any;
 onReset?: (event: KeyboardEvent) => any;
 onLinkFieldJump?: (data: {
 field: string;
 record: RawData;
 }) => any;
-onScroll?: (position: CellScrollPosition) => any;
+onScroll?: (position: Required<ScrollOffset>) => any;
 onLayoutAfterRealDataCellRender?: (options: {
 add: [number, number][];
 remove: [number, number][];
@@ -1002,9 +1295,9 @@ spreadsheet: SpreadSheet;
 }) => any;
 onRowCellBrushSelection?: (event: GEvent) => any;
 onColCellBrushSelection?: (event: GEvent) => any;
-onSpreadsheet?: (container: S2MountContainer, dataCfg: S2DataConfig, options: S2Options<TooltipContentType, Pagination, string | Element, string>) => any;
+onSpreadsheet?: (container: S2MountContainer, dataCfg: S2DataConfig, options: S2Options<TooltipContentType, Pagination, BaseTooltipOperatorMenuOptions>) => any;
 }, {
-options: S2Options<TooltipContentType, Pagination, string | Element, string>;
+options: S2Options<TooltipContentType, Pagination, BaseTooltipOperatorMenuOptions>;
 loading: boolean;
 adaptive: boolean | {
 width?: boolean;
@@ -1015,7 +1308,7 @@ showPagination: boolean | {
 onShowSizeChange?: (pageSize: number) => void;
 onChange?: (current: number) => void;
 };
-}>;
+}, {}>;
 
 declare interface BaseSheetComponentProps<RenderHandler = unknown, PartialDrillDown = PartDrillDown, Header = unknown, Options = S2Options<TooltipContentType, Pagination>> {
     sheetType?: SheetType;
@@ -1064,7 +1357,7 @@ declare interface BaseSheetComponentProps<RenderHandler = unknown, PartialDrillD
     onDataCellMouseUp?: (data: TargetCellInfo) => void;
     onDataCellMouseMove?: (data: TargetCellInfo) => void;
     onDataCellBrushSelection?: (brushRangeDataCells: DataCell[]) => void;
-    onDataCellSelectMove?: (metas: ViewMetaData[]) => void;
+    onDataCellSelectMove?: (metaList: ViewMetaData[]) => void;
     onCornerCellHover?: (data: TargetCellInfo) => void;
     onCornerCellClick?: (data: TargetCellInfo) => void;
     onCornerCellDoubleClick?: (data: TargetCellInfo) => void;
@@ -1143,16 +1436,24 @@ declare interface BaseSheetComponentProps<RenderHandler = unknown, PartialDrillD
 }
 
 /**
- * Base tooltips component
+ * Tooltip 基类
+ * @see https://s2.antv.antgroup.com/manual/basic/tooltip#%E8%87%AA%E5%AE%9A%E4%B9%89
+ * @example
+ * import CustomTooltip extends BaseTooltip {
+ renderContent() {}
+ show() {}
+ hide() {}
+ destroy() {}
+ }
  */
-declare class BaseTooltip_2 {
+declare class BaseTooltip_2<Content = TooltipContentType_2, Menu = BaseTooltipOperatorMenuOptions_2> {
     visible: boolean;
     spreadsheet: SpreadSheet_2;
     container: HTMLElement | null;
-    options: TooltipShowOptions;
+    options: TooltipShowOptions<Content, Menu>;
     position: TooltipPosition;
     constructor(spreadsheet: SpreadSheet_2);
-    show<T = Element | string>(showOptions: TooltipShowOptions<T>): void;
+    show<T = Content, M = Menu>(options: TooltipShowOptions<T, M>): void;
     hide(): void;
     destroy(): void;
     renderContent<T = TooltipContentType_2>(content: T): void;
@@ -1162,18 +1463,53 @@ declare class BaseTooltip_2 {
     private getContainer;
 }
 
-declare interface BaseTooltipConfig<T = TooltipContentType_2, Icon = Element | string, Text = string> {
-    showTooltip?: boolean;
+declare interface BaseTooltipConfig<T = TooltipContentType_2, Menu = BaseTooltipOperatorMenuOptions_2> {
+    /**
+     * 是否开启 tooltip, 在点击/悬停/停留/刷选/多选等场景会显示
+     * @description @antv/s2 中只保留了 tooltip 的核心显隐逻辑，提供相应数据，不渲染内容
+     * React 版本 和 Vue3 版本中通过 自定义 Tooltip 类 的方式渲染 tooltip 的内容，包括 排序下拉菜单, 单元格选中信息汇总, 列头隐藏按钮 等。
+     * @see https://s2.antv.antgroup.com/manual/basic/tooltip
+     */
+    enable?: boolean;
+    /**
+     * 自定义内容
+     * @see https://s2.antv.antgroup.com/manual/basic/tooltip#%E8%87%AA%E5%AE%9A%E4%B9%89
+     */
     content?: TooltipShowOptions<T>['content'];
-    operation?: TooltipOperation<Icon, Text>;
+    /**
+     * 自定义操作项
+     * @see https://s2.antv.antgroup.com/manual/basic/tooltip#%E8%87%AA%E5%AE%9A%E4%B9%89
+     */
+    operation?: TooltipOperation<Menu>;
+    /**
+     * 显示边界, 当 tooltip 超过边界时自动调整显示位置，container: 图表区域，body: 整个浏览器窗口，设置为 `null` 可关闭此功能
+     */
     autoAdjustBoundary?: TooltipAutoAdjustBoundary;
-    renderTooltip?: (spreadsheet: SpreadSheet_2) => BaseTooltip_2;
+    /**
+     * 自定义 Tooltip 类
+     * @see https://s2.antv.antgroup.com/zh/examples/react-component/tooltip/#custom-tooltip
+     */
+    render?: (spreadsheet: SpreadSheet_2) => BaseTooltip_2<T, Menu>;
+    /**
+     * 自定义坐标
+     */
     adjustPosition?: (positionInfo: TooltipPositionInfo) => TooltipPosition;
-    getContainer?: () => HTMLElement;
+    /**
+     * 自定义挂载容器, 默认 body
+     */
+    getContainer?: () => HTMLElement | null;
+    /**
+     * 容器类名
+     */
     className?: string | string[];
+    /**
+     * 容器样式
+     */
     style?: CSS_2.Properties;
 }
 
+declare type BaseTooltipOperatorMenuOptions_2 = TooltipOperatorMenuOptions<Element | string, string>;
+
 declare interface BBox {
     x: number;
     y: number;
@@ -1186,24 +1522,31 @@ declare interface BBox {
 }
 
 declare interface BrushSelection {
-    data?: boolean;
-    row?: boolean;
-    col?: boolean;
+    dataCell?: boolean;
+    rowCell?: boolean;
+    colCell?: boolean;
 }
 
+/** 子弹图样式配置 */
 declare interface BulletTheme {
+    /** 进度条 */
     progressBar: {
+        /** 子弹图宽度相对单元格 content 占比，小数 */
         widthPercent: number;
         height: number;
+        /** 内高度 */
         innerHeight: number;
     };
+    /** 测量标记线 */
     comparativeMeasure: {
         width: number;
         height: number;
         fill?: string;
         opacity?: number;
     };
+    /** 子弹图状态颜色 */
     rangeColors: RangeColors;
+    /** 子弹图背景色 */
     backgroundColor: string;
 }
 
@@ -1224,8 +1567,13 @@ declare interface BulletValue {
 }
 
 declare interface CalcTotals {
+    /** 聚合方式 */
     aggregation?: Aggregation;
-    calcFunc?: (query: Query, arr: CellData[]) => number;
+    /**
+     * 自定义计算汇总
+     * @see https://s2.antv.antgroup.com/examples/analysis/totals/#custom
+     */
+    calcFunc?: (query: Query, data: CellData[]) => number;
 }
 
 declare type CanvasEventHandler = (event: FederatedPointerEvent) => void;
@@ -1280,20 +1628,13 @@ declare class CellData {
     get [VALUE_FIELD](): DataItem;
 }
 
-declare interface CellDataParams {
-    query: Query;
-    isTotals?: boolean;
-    rowNode?: Node_2_2;
-    isRow?: boolean;
-}
-
-declare type CellEventTarget = FederatedPointerEvent['target'] | null | undefined;
+declare type CellEventTarget = FederatedPointerEvent['target'] | null | undefined | EventTarget | IEventTarget;
 
 declare interface CellMeta {
     id: string;
     colIndex: number;
     rowIndex: number;
-    type: CellTypes;
+    type: CellType;
     rowQuery?: Record<string, any>;
     [key: string]: unknown;
 }
@@ -1306,51 +1647,54 @@ declare interface CellScrollOffset {
     offsetY: number;
 }
 
-declare interface CellScrollPosition_2 {
-    scrollX: number;
-    scrollY: number;
-}
+declare type CellScrollPosition_2 = Required<ScrollOffset_2>;
 
 declare interface CellTheme {
+    /** 奇数行单元格背景色 */
     crossBackgroundColor?: string;
+    /** 单元格背景色 */
     backgroundColor?: string;
+    /** 单元格背景色透明度 */
     backgroundColorOpacity?: number;
+    /** 单元格水平边线颜色 */
     horizontalBorderColor?: string;
+    /** 单元格水平边线颜色透明度 */
     horizontalBorderColorOpacity?: number;
+    /** 单元格垂直边线颜色 */
     verticalBorderColor?: string;
+    /** 单元格垂直边线颜色透明度 */
     verticalBorderColorOpacity?: number;
+    /** 单元格水平边线宽度 */
     horizontalBorderWidth?: number;
+    /** 单元格垂直边线宽度 */
     verticalBorderWidth?: number;
+    /** 单元格内边距 */
     padding?: Padding;
+    /** 交互态 */
     interactionState?: InteractionState;
 }
 
 declare type CellThemes = {
-    [K in CellTypes]?: DefaultCellTheme;
+    [K in CellType]?: DefaultCellTheme;
 };
 
-declare enum CellTypes {
+declare enum CellType {
     DATA_CELL = "dataCell",
-    HEADER_CELL = "headerCell",
     ROW_CELL = "rowCell",
     COL_CELL = "colCell",
+    SERIES_NUMBER_CELL = "seriesNumberCell",
     CORNER_CELL = "cornerCell",
     MERGED_CELL = "mergedCell"
 }
 
-declare class ColCell extends HeaderCell {
-    protected headerConfig: ColHeaderConfig;
-    /** icon 绘制起始坐标 */
-    protected iconPosition: PointLike;
-    get cellType(): CellTypes;
+declare class ColCell extends HeaderCell<ColHeaderConfig> {
+    get cellType(): CellType;
     protected getBorderPositions(): CellBorderPosition[];
     protected initCell(): void;
     protected getFormattedFieldValue(): FormatResult;
     protected getMaxTextWidth(): number;
     protected isBolderText(): boolean;
     protected getTextPosition(): PointLike;
-    protected getIconPosition(): PointLike;
-    protected getActionIconsWidth(): number;
     protected getColResizeArea(): Group | undefined;
     protected getHorizontalResizeAreaName(): string;
     /**
@@ -1404,7 +1748,8 @@ declare interface ColCellStyle extends BaseCellStyle {
 declare class ColHeader extends BaseHeader<ColHeaderConfig> {
     protected scrollGroup: Group;
     protected background: DisplayObject;
-    constructor(cfg: ColHeaderConfig);
+    constructor(config: ColHeaderConfig);
+    protected getCellInstance(node: Node_2_2): S2CellType_2;
     private initScrollGroup;
     /**
      * Make colHeader scroll with hScrollBar
@@ -1415,7 +1760,6 @@ declare class ColHeader extends BaseHeader<ColHeaderConfig> {
     onColScroll(scrollX: number, type: string): void;
     protected clip(): void;
     clear(): void;
-    protected getCellInstance(node: Node_2_2, spreadsheet: SpreadSheet_2, headerConfig: ColHeaderConfig): S2CellType_2;
     protected getCellGroup(node: Node_2_2): Group;
     protected isColCellInRect(node: Node_2_2): boolean;
     protected layout(): void;
@@ -1429,13 +1773,31 @@ declare interface ColHeaderConfig extends BaseHeaderConfig {
 /**
  * One field can hold a condition
  */
-declare interface Condition {
+declare interface Condition<T = unknown> {
     field?: string | RegExp;
-    mapping: MappingFunction;
+    mapping: ConditionMapping<T>;
 }
 
+declare type ConditionMapping<T = unknown> = (fieldValue: number | string, data: RawData_2, cell?: DataCell_2 | HeaderCell) => ConditionMappingResult<T> | undefined | null;
+
+declare type ConditionMappingResult<T = unknown> = ValueRange & T & {
+    icon?: string;
+    fill?: string;
+    isCompare?: boolean;
+    /**
+     * @description only used in background condition, when the background color is too light, the font color will be white
+     * @version 1.34.0
+     */
+    intelligentReverseTextColor?: boolean;
+    /**
+     * @description custom the interval condition's width
+     * @version 1.38.0
+     */
+    fieldValue?: number;
+};
+
 declare interface Conditions {
-    text?: Condition[];
+    text?: TextCondition[];
     background?: Condition[];
     interval?: Condition[];
     icon?: IconCondition[];
@@ -1466,15 +1828,13 @@ declare class CornerBBox extends BaseBBox {
     private adjustCornerBBoxWidth;
 }
 
-declare class CornerCell extends HeaderCell {
-    cornerType: CornerNodeType;
-    protected headerConfig: CornerHeaderConfig;
+declare class CornerCell extends HeaderCell<CornerHeaderConfig> {
+    get cellType(): CellType;
     protected isBolderText(): boolean;
-    get cellType(): CellTypes;
     protected getBorderPositions(): CellBorderPosition[];
     update(): void;
     protected initCell(): void;
-    protected drawTextShape(): void;
+    drawTextShape(options?: RenderTextShapeOptions): void;
     /**
      * 绘制折叠展开的icon
      */
@@ -1483,19 +1843,19 @@ declare class CornerCell extends HeaderCell {
     protected getResizeAreaEffect(): ResizeAreaEffect.Field | ResizeAreaEffect.Tree | ResizeAreaEffect.Series;
     protected drawResizeArea(): void;
     protected showTreeIcon(): boolean;
-    protected getIconPosition(): PointLike;
     protected getTreeIconWidth(): number;
     protected getTextStyle(): TextTheme;
     protected getMaxTextWidth(): number;
     protected getTextPosition(): PointLike;
     protected getFormattedFieldValue(): FormatResult;
-    protected getCornerText(): string;
 }
 
 /**
  * Corner Header for SpreadSheet
  */
 declare class CornerHeader extends BaseHeader<CornerHeaderConfig> {
+    constructor(config: CornerHeaderConfig);
+    protected getCellInstance(node: Node_2_2): S2CellType_2;
     /**
      * Get corner Header by config
      */
@@ -1509,7 +1869,6 @@ declare class CornerHeader extends BaseHeader<CornerHeaderConfig> {
         width: number;
         height: number;
     }): Node_2_2[];
-    constructor(cfg: CornerHeaderConfig);
     /**
      *  Make cornerHeader scroll with hScrollBar
      * @param scrollX
@@ -1554,7 +1913,23 @@ declare interface CustomInteraction {
 }
 
 declare interface CustomSVGIcon {
+    /**
+     * icon 名称
+     */
     name: string;
+    /**
+     * @example 1、base64
+     * @example 2. svg本地文件 (兼容老方式, 可以改颜色)
+
+     import Icon from 'path/to/xxx.svg'
+
+     => { name: 'iconA', svg: Icon }
+     => { name: 'iconB', svg: '<svg>...</svg>' }
+
+     * @example 3. 线上支持的图片地址
+     带后缀: https://gw.alipayobjects.com/zos/antfincdn/gu1Fsz3fw0/filter%26sort_filter.svg
+     无后缀: https://mdn.alipayobjects.com/huamei_qa8qxu/afts/img/A*5nsESLuvc_EAAAAAAAAAAAAADmJ7AQ/original
+     */
     svg: string;
 }
 
@@ -1610,8 +1985,9 @@ declare type Data = (RawData_2 & ExtraData) | undefined | null;
  * 2、icon align in right with size {@link ICON_SIZE}
  * 3、left rect area is interval(in left) and text(in right)
  */
-declare class DataCell_2 extends BaseCell<ViewMeta_2> {
-    get cellType(): CellTypes;
+declare class DataCell_2 extends BaseCell<ViewMeta> {
+    iconPosition: PointLike;
+    get cellType(): CellType;
     protected getBorderPositions(): CellBorderPosition[];
     get valueRangeByField(): ValueRange;
     protected handleByStateName(cells: CellMeta[], stateName: InteractionStateName): void;
@@ -1619,28 +1995,20 @@ declare class DataCell_2 extends BaseCell<ViewMeta_2> {
     protected handleSelect(cells: CellMeta[]): void;
     protected handleHover(cells: CellMeta[]): void;
     update(): void;
-    setMeta(viewMeta: ViewMeta_2): void;
+    setMeta(viewMeta: ViewMeta): void;
+    drawTextShape(options?: RenderTextShapeOptions): void;
     protected initCell(): void;
-    /**
-     * 获取默认字体颜色：根据字段标记背景颜色，设置字体颜色
-     * @param textStyle
-     * @private
-     */
-    private getDefaultTextFill;
+    protected generateIconConfig(): void;
     protected getTextStyle(): TextTheme;
-    getIconStyle(): IconStyle | undefined;
     protected drawConditionIntervalShape(): void;
     protected shouldHideRowSubtotalData(): boolean;
     protected getFormattedFieldValue(): FormatResult;
     protected getMaxTextWidth(): number;
     protected getTextPosition(): PointLike;
+    protected getIconPosition(): PointLike;
     getBackgroundColor(): {
-        backgroundColor: string | undefined;
-        backgroundColorOpacity: number | undefined;
-        intelligentReverseTextColor?: undefined;
-    } | {
-        backgroundColor: string | undefined;
-        backgroundColorOpacity: number | undefined;
+        backgroundColor: string;
+        backgroundColorOpacity: number;
         intelligentReverseTextColor: boolean;
     };
     protected changeRowColSelectState(indexType: ViewMetaIndexType): void;
@@ -1657,23 +2025,39 @@ declare class DataCell_2 extends BaseCell<ViewMeta_2> {
      * Mapping value to get condition related attrs
      * @param condition
      */
-    mappingValue(condition: Condition): MappingResult | undefined | null;
+    mappingValue(condition: Condition): ConditionMappingResult | undefined | null;
     updateByState(stateName: InteractionStateName): void;
     clearUnselectedState(): void;
     private toggleConditionIntervalShapeOpacity;
 }
 
-declare type DataCellCallback = (viewMeta: ViewMeta_2) => S2CellType_2;
+declare type DataCellCallback = (viewMeta: ViewMeta) => S2CellType_2;
 
 declare interface DataCellStyle {
+    /**
+     * 宽度
+     */
     width?: number;
+    /**
+     * 高度
+     */
     height?: number;
     /**
      * 多列数值配置
      */
     valuesCfg?: {
+        /**
+         * 原始值字段
+         */
         originalValueField?: string;
+        /**
+         * 每一列数值占单元格宽度百分比
+         * @example [0.1, 0.3, 0.6]
+         */
         widthPercent?: number[];
+        /**
+         * 是否显示原始值 (tooltip 中显示)
+         */
         showOriginalValue?: boolean;
     };
 }
@@ -1682,14 +2066,26 @@ declare type DataItem = SimpleData | MultiData | Record<string, unknown> | undef
 
 declare type DataPath = (number | string)[];
 
+declare type DeepRequired<T extends Record<string, any>> = {
+    [K in keyof T]-?: NonNullable<T[K]> extends Record<string, any> ? DeepRequired<NonNullable<T[K]>> : NonNullable<T[K]>;
+};
+
 declare interface DefaultCellTheme extends GridAnalysisCellTheme {
+    /** 粗体文本样式 */
     bolderText?: TextTheme;
+    /** 文本样式 */
     text?: TextTheme;
+    /** 序号样式 */
     seriesText?: TextTheme;
+    /** 度量值文本样式 */
     measureText?: TextTheme;
+    /** 单元格样式 */
     cell?: CellTheme;
+    /** 图标样式 */
     icon?: IconTheme;
+    /** mini 图样式配置 */
     miniChart?: MiniChartTheme;
+    /** 序号列宽 */
     seriesNumberWidth?: number;
 }
 
@@ -1788,7 +2184,7 @@ declare interface EmitterType {
         total: number;
         current: number;
     }) => void;
-    [S2Event.LAYOUT_AFTER_HEADER_LAYOUT]: (data: LayoutResult_2) => void;
+    [S2Event.LAYOUT_AFTER_HEADER_LAYOUT]: (layoutResult: LayoutResult_2) => void;
     [S2Event.LAYOUT_AFTER_REAL_DATA_CELL_RENDER]: (options: {
         add: [number, number][];
         remove: [number, number][];
@@ -1823,6 +2219,7 @@ declare class EventController {
     private onKeyboardCopy;
     private onKeyboardEsc;
     private resetSheetStyle;
+    private isMouseEvent;
     private isMouseOnTheCanvasContainer;
     private getContainerRect;
     private isMouseOnTheTooltip;
@@ -1877,6 +2274,9 @@ declare type ExtraData = {
 };
 
 declare interface Fields extends BaseFields {
+    /**
+     * 自定义指标维度在行列头中的层级顺序 （即 `values` 的 顺序，从 `0` 开始
+     */
     customValueOrder?: number;
 }
 
@@ -1891,7 +2291,13 @@ declare interface FormatResult {
     value: DataItem;
 }
 
-declare type Formatter = (v: unknown, data?: ViewMetaData_2 | ViewMetaData_2[], meta?: Node_2_2 | ViewMeta_2) => string;
+/**
+ * 第二个参数在以下情况会传入：
+ * 1. data cell 格式化
+ * 2. copy/export
+ * 3. tooltip, 且仅在选择多个单元格时，data 类型为数组
+ */
+declare type Formatter = (v: unknown, data?: ViewMetaData_2 | ViewMetaData_2[], meta?: Node_2_2 | ViewMeta) => string;
 
 declare class Frame extends Group {
     cfg: FrameConfig;
@@ -1932,7 +2338,39 @@ declare interface FrameConfig {
 declare class FrozenGroup extends GridGroup {
 }
 
-declare type GetCellMeta = (rowIndex: number, colIndex: number) => ViewMeta_2 | null;
+declare interface GetCellDataParams {
+    /**
+     * 查询条件
+     */
+    query: Query;
+    /**
+     * 是否是汇总节点
+     */
+    isTotals?: boolean;
+    /**
+     * 行头节点, 用于下钻场景
+     */
+    rowNode?: Node_2_2;
+    /**
+     * 是否是行头
+     */
+    isRow?: boolean;
+}
+
+declare interface GetCellMultiDataParams {
+    /**
+     * 查询条件
+     */
+    query: Query;
+    /**
+     * 汇总
+     */
+    totals?: TotalSelectionsOfMultiData;
+    /**
+     * 下钻
+     */
+    drillDownFields?: string[];
+}
 
 declare type GetInitProps<T, OptionalKeys = GetOptionalKeys<T>> = {
     [K in keyof T as IsEmitKey<T[K]> extends true ? never : K]-?: K extends OptionalKeys ? PropOption<NonNullable<T[K]>> : RequiredPropOption<NonNullable<T[K]>>;
@@ -1943,7 +2381,9 @@ declare type GetOptionalKeys<T> = keyof {
 };
 
 declare interface GridAnalysisCellTheme {
+    /** 次级文本，如副指标 */
     minorText?: TextTheme;
+    /** 衍生指标 */
     derivedMeasureText?: {
         mainUp: string;
         mainDown: string;
@@ -1971,6 +2411,10 @@ declare interface GridInfo {
     rows: number[];
 }
 
+declare type GroupedIcons = {
+    [key in IconPosition]: HeaderActionNameOptions[];
+};
+
 /**
  * 使用 iconfont 上的 svg 来创建 Icon
  */
@@ -1979,7 +2423,8 @@ declare class GuiIcon extends Group {
     iconImageShape: CustomImage;
     private cfg;
     constructor(cfg: GuiIconCfg);
-    private getImage;
+    getCfg(): GuiIconCfg;
+    getImage(name: string, cacheKey: string, fill?: string): Promise<HTMLImageElement>;
     /**
      * 1. https://xxx.svg
      * 2. http://xxx.svg
@@ -1987,6 +2432,10 @@ declare class GuiIcon extends Group {
      */
     isOnlineLink: (src: string) => boolean;
     private render;
+    setImageAttrs(attrs: Partial<{
+        name: string;
+        fill: string;
+    }>): void;
 }
 
 declare interface GuiIconCfg extends Omit<ImageStyleProps, 'fill'> {
@@ -2016,45 +2465,98 @@ declare class HdAdapter {
     private renderByZoomScale;
 }
 
-declare interface HeaderActionIcon {
-    iconNames: string[];
-    belongsCell: Omit<CellTypes, 'dataCell'>;
+declare interface HeaderActionIcon_2 extends HeaderActionIconBaseOptions {
+    /**
+     * 内置 icon 或通过 @customSVGIcons 自定义的 icon 名称
+     * 如果是 string[], 则默认 icon 位置为右侧
+     * @see https://s2.antv.antgroup.com/manual/advanced/custom/custom-icon
+     * @example icons: ['iconNameA', 'iconNameB']
+     * @example icons: [{ name: 'iconNameA', position: "left", fill: "red" }]
+     */
+    icons: HeaderActionName[];
+    /**
+     * 所属的 cell 类型, 即当前 icon 展示在哪种类型单元格中
+     * @example belongsCell: 'rowCell'
+     */
+    belongsCell: Omit<CellType, 'dataCell' | 'mergedCell' | 'seriesNumberCell'>;
+}
+
+declare interface HeaderActionIconBaseOptions {
+    /**
+     * 是否默认隐藏， 开启后 hover 后才显示,  关闭后则始终显示, 可根据当前单元格信息动态判断
+     * @example defaultHide: (meta, iconName) => meta.id === 'xxx'
+     * @default false
+     */
     defaultHide?: boolean | ((meta: Node_2_2, iconName: string) => boolean);
+    /**
+     * 是否展示, 可根据当前单元格信息动态判断
+     * @example displayCondition: (meta, iconName) => !meta.isTotals
+     */
     displayCondition?: (mete: Node_2_2, iconName: string) => boolean;
+    /**
+     * 点击回调函数
+     */
     onClick?: (headerIconClickParams: HeaderIconClickParams) => void;
+    /**
+     * 悬停回调函数
+     */
     onHover?: (headerIconHoverParams: HeaderIconHoverParams) => void;
 }
 
-declare interface HeaderActionIconOptions {
-    iconName: string;
+declare interface HeaderActionIconOptions extends HeaderActionIconBaseOptions {
+    fill?: string;
+    name: string;
     x: number;
     y: number;
-    onClick?: (headerIconClickParams: HeaderIconClickParams) => void;
-    onHover?: (headerIconHoverParams: HeaderIconHoverParams) => void;
-    defaultHide?: boolean;
+    isSortIcon?: boolean;
 }
 
-declare abstract class HeaderCell extends BaseCell<Node_2_2> {
-    protected headerConfig: BaseHeaderConfig;
+declare type HeaderActionName = string | Omit<HeaderActionNameOptions, 'isConditionIcon'>;
+
+declare type HeaderActionNameOptions = HeaderActionIconBaseOptions & {
+    /**
+     * icon 颜色配置
+     * @description 优先级: 单个 icon > 主题 icon 配置 > 文本颜色
+     */
+    fill?: string;
+    /**
+     * icon 名称
+     */
+    name: string;
+    /**
+     * icon 相对文本的位置
+     * 可选: 'left' | 'right'
+     */
+    position?: IconPosition;
+    /**
+     * 是否是条件格式的 icon
+     */
+    isConditionIcon?: boolean;
+};
+
+declare abstract class HeaderCell<T extends BaseHeaderConfig = BaseHeaderConfig> extends BaseCell<Node_2_2> {
+    protected headerConfig: T;
+    protected actionIconConfig: InternalFullyHeaderActionIcon | undefined;
     protected treeIcon: GuiIcon | undefined;
     protected treeLeafNodeAlignDot: DisplayObject | undefined;
     protected actionIcons: GuiIcon[];
     protected hasDefaultHiddenIcon: boolean;
+    protected conditionIconMappingResult: HeaderActionNameOptions | undefined;
+    /** left icon 绘制起始坐标 */
+    protected leftIconPosition: PointLike;
+    /** right icon 绘制起始坐标 */
+    protected rightIconPosition: PointLike;
     protected abstract isBolderText(): boolean;
-    protected handleRestOptions(...[headerConfig]: [BaseHeaderConfig]): void;
+    getHeaderConfig(): T;
+    protected handleRestOptions(...[headerConfig]: [T]): void;
     protected initCell(): void;
+    protected generateIconConfig(): void;
     protected getFormattedFieldValue(): FormatResult;
-    /**
-     * 获取操作 icons
-     */
-    protected getActionIconCfg(): HeaderActionIcon | undefined;
     protected showSortIcon(): boolean | "" | undefined;
-    protected getActionIconsCount(): number;
-    protected getActionIconsWidth(): number;
-    protected drawSortIcons(): void;
+    protected getActionIconStyle(options: Partial<HeaderActionIconOptions>): Partial<GuiIconCfg>;
     protected hasDefaultHideActionIcon(): boolean;
     protected addActionIcon(options: HeaderActionIconOptions): void;
-    protected drawActionIcons(): void;
+    protected drawActionAndConditionIcons(): void;
     protected isSortCell(): boolean;
     protected handleByStateName(cells: CellMeta[], stateName: InteractionStateName): void;
     protected handleSearchResult(cells: CellMeta[]): void;
@@ -2062,21 +2564,26 @@ declare abstract class HeaderCell extends BaseCell<Node_2_2> {
     protected handleSelect(cells: CellMeta[], nodes?: Node_2_2[]): void;
     protected getTextStyle(): TextTheme;
     getBackgroundColor(): {
+        backgroundColor: string;
+        backgroundColorOpacity: number;
+    } & {
         backgroundColor: string | undefined;
-        backgroundColorOpacity: number | undefined;
+        intelligentReverseTextColor: boolean;
     };
     toggleActionIcon(id: string): void;
+    protected getIconPosition(): PointLike;
     update(): void;
     updateByState(stateName: InteractionStateName): void;
     hideInteractionShape(): void;
     isMeasureField(): boolean;
-    mappingValue(condition: Condition): MappingResult;
+    mappingValue(condition: Condition): ConditionMappingResult;
     findFieldCondition(conditions: Condition[]): Condition | undefined;
     getTreeIcon(): GuiIcon | undefined;
+    getActionIcons(): GuiIcon[];
 }
 
 declare interface HeaderIconClickParams {
-    iconName: string;
+    name: string;
     meta: Node_2_2;
     event?: FederatedPointerEvent;
 }
@@ -2086,7 +2593,13 @@ declare interface HeaderIconHoverParams extends HeaderIconClickParams {
 }
 
 declare interface HiddenColumnsInfo_2 {
+    /**
+     * 当前显示的兄弟节点之前所隐藏的节点
+     */
     hideColumnNodes: Node_2_2[];
+    /**
+     * 当前隐藏列所对应展示展开按钮的兄弟节点
+     */
     displaySiblingNode: {
         prev: Node_2_2 | null;
         next: Node_2_2 | null;
@@ -2118,11 +2631,11 @@ declare class Hierarchy {
     getNodesLessThanLevel(lessThanLevel: number): Node_2_2[];
     /**
      * Add new node
-     * @param value
+     * @param node
      * @param insetIndex
      */
-    pushNode(value: Node_2_2, insetIndex?: number): void;
-    pushIndexNode(value: Node_2_2): void;
+    pushNode(node: Node_2_2, insetIndex?: number): void;
+    pushIndexNode(node: Node_2_2): void;
     getIndexNodes(): Node_2_2[];
 }
 
@@ -2130,54 +2643,128 @@ declare interface HoverFocusOptions {
     duration?: number;
 }
 
-declare interface IconCondition extends Condition {
+declare interface IconCondition extends Condition<IconTheme> {
     position?: IconPosition;
 }
 
 declare type IconPosition = 'left' | 'right';
 
-declare type IconStyle = Pick<IconTheme, 'size' | 'margin'> & Pick<IconCondition, 'position'>;
-
 declare interface IconTheme {
+    /** icon 填充色 */
     fill?: string;
-    downIconColor?: string;
-    upIconColor?: string;
+    /** icon  大小 */
     size?: number;
+    /** icon 外边距 */
     margin?: Margin;
 }
 
 declare type Indexes = [number, number, number, number];
 
-declare interface InteractionCellSelectedHighlightType {
+declare interface InteractionCellSelectedHighlightOptions {
+    /** 高亮行头 */
     rowHeader?: boolean;
+    /** 高亮列头 */
     colHeader?: boolean;
+    /** 高亮选中单元格所在行 */
     currentRow?: boolean;
+    /** 高亮选中单元格所在列 */
     currentCol?: boolean;
 }
 
 declare type InteractionConstructor = new (spreadsheet: SpreadSheet_2) => BaseEvent;
 
 declare interface InteractionOptions {
-    linkFields?: string[] | ((meta: Node_2_2 | ViewMeta_2) => boolean);
+    /**
+     * 链接跳转
+     * @see https://s2.antv.antgroup.com/manual/advanced/interaction/link-jump
+     */
+    linkFields?: string[] | ((meta: Node_2_2 | ViewMeta) => boolean);
+    /**
+     * 选中单元格高亮聚焦
+     */
     selectedCellsSpotlight?: boolean;
+    /**
+     * 十字器高亮效果
+     */
     hoverHighlight?: boolean;
+    /**
+     * 悬停聚焦, 800ms 后会显示其对应 tooltip, 可以自定义 duration
+     */
     hoverFocus?: HoverFocusOptions | boolean;
+    /**
+     * 开启复制 Command/Ctrl + C
+     */
     enableCopy?: boolean;
+    /**
+     * 复制带格式的数据
+     */
     copyWithFormat?: boolean;
+    /**
+     * 复制包含其对应行列头的数据
+     */
     copyWithHeader?: boolean;
+    /**
+     * 复制时支持自定义(transformer)数据导出格式化方法
+     */
+    customTransformer?: (transformer: Transformer_2) => Partial<Transformer_2>;
+    /**
+     * 自动重置表格样式 (按下 ESC 键, 点击空白区域时, 关闭 tooltip/交互状态)
+     */
     autoResetSheetStyle?: boolean;
+    /**
+     * 隐藏列头配置, 支持维度 (S2DataConfig.fields) 和具体维值 (id)
+     * @example hiddenColumnFields: ['type', 'subType'];
+     * @example hiddenColumnFields: ['root[&]家具[&]桌子[&]number']
+     */
     hiddenColumnFields?: string[];
+    /**
+     * 自定义滚动速率, 默认 1
+     * @see https://s2.antv.antgroup.com/manual/advanced/interaction/scroll
+     */
     scrollSpeedRatio?: ScrollSpeedRatio;
+    /**
+     * 宽高调整
+     */
     resize?: ResizeInteractionOptions | boolean;
+    /**
+     * 刷选
+     */
     brushSelection?: BrushSelection | boolean;
+    /**
+     * 多选 Command/Ctrl + click
+     */
     multiSelection?: boolean;
+    /**
+     * 区间快捷多选 Shift + click
+     */
     rangeSelection?: boolean;
+    /**
+     * 键盘方向键移动选中单元格
+     */
     selectedCellMove?: boolean;
+    /**
+     * 滚动条位置 (可用于表格内容未撑满 Canvas 的场景)
+     */
     scrollbarPosition?: ScrollbarPositionType;
+    /**
+     * 透传 listener 属性的可选参数对象
+     * @see https://developer.mozilla.org/zh-CN/docs/Web/API/EventTarget/addEventListener
+     */
     eventListenerOptions?: boolean | AddEventListenerOptions;
-    selectedCellHighlight?: boolean | InteractionCellSelectedHighlightType;
+    /**
+     * 选中单元格高亮联动 (高亮所对应行头/列头, 高亮当前行/当前列)
+     */
+    selectedCellHighlight?: boolean | InteractionCellSelectedHighlightOptions;
+    /**
+     * 滚动到边界的行为
+     * @see https://s2.antv.antgroup.com/manual/advanced/interaction/scroll
+     * @see https://developer.mozilla.org/en-US/docs/Web/CSS/overscroll-behavior
+     */
     overscrollBehavior?: 'auto' | 'none' | 'contain' | null;
-    /** ***********CUSTOM INTERACTION HOOKS**************** */
+    /**
+     * 自定义交互
+     * @see https://s2.antv.antgroup.com/manual/advanced/interaction/custom
+     */
     customInteractions?: CustomInteraction[];
 }
 
@@ -2186,12 +2773,29 @@ declare type InteractionState = {
 };
 
 declare interface InteractionStateInfo {
+    /**
+     * 交互状态名
+     */
     stateName?: InteractionStateName;
+    /**
+     * 单元格元数据 (包含不在可视范围内的)
+     */
     cells?: CellMeta[];
+    /**
+     * 交互状态发生改变的单元格实例
+     */
     interactedCells?: S2CellType_2[];
+    /**
+     * 选中的单元格节点
+     */
     nodes?: Node_2_2[];
+    /**
+     * 如果单元格为空, 是否强制更新 (适用于反选等场景)
+     */
     force?: boolean;
-    /** 交互行为改变后，会被更新和重绘的单元格回调 */
+    /**
+     * 交互行为改变后，会被更新和重绘的单元格回调
+     */
     onUpdateCells?: OnUpdateCells;
 }
 
@@ -2207,12 +2811,19 @@ declare enum InteractionStateName {
 }
 
 declare interface InteractionStateTheme {
+    /** 背景透明度 */
     backgroundOpacity?: number;
+    /** 背景填充色 */
     backgroundColor?: string;
+    /** 文本透明度 */
     textOpacity?: number;
+    /** 边线颜色 */
     borderColor?: string;
+    /** 边线宽度 */
     borderWidth?: number;
+    /** 边线透明度 */
     borderOpacity?: number;
+    /** 透明度 */
     opacity?: number;
 }
 
@@ -2221,13 +2832,23 @@ declare type Intercept = InterceptType[keyof InterceptType];
 declare enum InterceptType {
     HOVER = "hover",
     CLICK = "click",
-    BRUSH_SELECTION = "brushSelection",
-    ROW_BRUSH_SELECTION = "rowBrushSelection",
-    COL_BRUSH_SELECTION = "colBrushSelection",
+    DATA_CELL_BRUSH_SELECTION = "dataCellBrushSelection",
+    ROW_CELL_BRUSH_SELECTION = "rowCellBrushSelection",
+    COL_CELL_BRUSH_SELECTION = "colCellBrushSelection",
     MULTI_SELECTION = "multiSelection",
     RESIZE = "resize"
 }
 
+declare type InternalFullyCellTheme = DeepRequired<DefaultCellTheme>;
+
+declare interface InternalFullyHeaderActionIcon extends HeaderActionIcon_2 {
+    icons: HeaderActionNameOptions[];
+    isSortIcon?: boolean;
+}
+
+declare type InternalFullyTheme = DeepRequired<S2Theme>;
+
+/** 条件格式柱图样式配置 */
 declare interface IntervalTheme {
     height: number;
     fill: string;
@@ -2243,14 +2864,14 @@ declare type KeyboardEventHandler = (event: KeyboardEvent) => void;
 declare type LayoutArrange = (spreadsheet: SpreadSheet_2, parent: Node_2_2, field: string, fieldValues: string[]) => string[];
 
 /**
- * determine the location(x,y,width,height eg..) of every node
+ * determine the data of cells in Cartesian coordinates
  */
-declare type LayoutCoordinate = (spreadsheet: SpreadSheet_2, rowNode: Node_2_2 | null, colNode: Node_2_2 | null) => void;
+declare type LayoutCellMeta = (viewMeta: ViewMeta) => ViewMeta | null;
 
 /**
- * determine the data of cells in Cartesian coordinates
+ * determine the location(x,y,width,height eg..) of every node
  */
-declare type LayoutDataPosition = (spreadsheet: SpreadSheet_2, getCellData: GetCellMeta) => GetCellMeta;
+declare type LayoutCoordinate = (spreadsheet: SpreadSheet_2, rowNode: Node_2_2 | null, colNode: Node_2_2 | null) => void;
 
 /**
  * determine what does row/column hierarchy look like
@@ -2272,14 +2893,38 @@ declare type LayoutPaginationParams = {
 };
 
 declare interface LayoutResult_2 {
+    /**
+     * 列头节点, 对应 ColCell (含可视范围外)
+     */
     colNodes: Node_2_2[];
+    /**
+     * 列头叶子节点, 对应 ColCell (含可视范围外)
+     */
+    colLeafNodes: Node_2_2[];
+    /**
+     * 列头节点层级结构 (含可视范围外)
+     */
     colsHierarchy: Hierarchy;
+    /**
+     * 行头节点, 对应 RowCell (含可视范围外)
+     */
     rowNodes: Node_2_2[];
+    /**
+     * 行头节点层级结构 (含可视范围外)
+     */
     rowsHierarchy: Hierarchy;
+    /**
+     * 行头叶子节点, 对应 RowCell (含可视范围外)
+     */
     rowLeafNodes: Node_2_2[];
-    colLeafNodes: Node_2_2[];
-    getCellMeta: GetCellMeta;
-    spreadsheet: SpreadSheet_2;
+    /**
+     * 序号节点, 对应 SeriesNumberCell (含可视范围外)
+     */
+    seriesNumberNodes?: Node_2_2[];
+    /**
+     * 角头节点, 对应 CornerCell (含可视范围外)
+     */
+    cornerNodes?: Node_2_2[];
 }
 
 /**
@@ -2295,12 +2940,15 @@ declare type LayoutSeriesNumberNodes = (rowsHierarchy: Hierarchy, seriesNumberWi
  */
 declare type LayoutWidthType = 'adaptive' | 'colAdaptive' | 'compact';
 
+/** 折线图样式配置 */
 declare interface LineTheme {
+    /** 点 */
     point?: {
         size: number;
         fill?: string;
         opacity?: number;
     };
+    /** 线 */
     linkLine?: {
         size: number;
         fill?: string;
@@ -2308,49 +2956,31 @@ declare interface LineTheme {
     };
 }
 
-declare type MappingFunction = (fieldValue: number | string, data: RawData_2) => MappingResult | undefined | null;
+declare type Margin = Padding;
 
-declare interface MappingResult extends ValueRange {
-    icon?: string;
-    fill: string;
-    isCompare?: boolean;
-    /**
-     * @description only used in background condition, when the background color is too light, the font color will be white
-     * @version 1.34.0
-     */
-    intelligentReverseTextColor?: boolean;
-    /**
-     * @description custom the interval condition's width
-     * @version 1.38.0
-     */
-    fieldValue?: number;
-}
+declare type MatrixHTMLTransformer = (data: DataItem[][]) => CopyableHTML;
 
-declare type Margin = Padding;
+declare type MatrixPlainTransformer = (data: DataItem[][], separator?: string) => CopyablePlain;
 
 /**
  * Cell for panelGroup area
  */
 declare class MergedCell extends DataCell_2 {
     cells: S2CellType_2[];
-    constructor(spreadsheet: SpreadSheet_2, cells: S2CellType_2[], meta?: ViewMeta_2);
+    get cellType(): CellType;
+    constructor(spreadsheet: SpreadSheet_2, cells: S2CellType_2[], meta?: ViewMeta);
     handleRestOptions(...[cells]: [S2CellType_2[]]): void;
-    get cellType(): CellTypes;
     update(): void;
     protected initCell(): void;
     /**
      * Draw merged cells background
      */
     protected drawBackgroundShape(): void;
-    /**
-     * Render data text
-     */
-    drawTextShape(): void;
+    drawTextShape(options?: RenderTextShapeOptions): void;
 }
 
-/**
- * the index of rows or columns.
- */
+declare type MergedCellCallback = (spreadsheet: SpreadSheet_2, cells: S2CellType_2[], meta?: ViewMeta) => MergedCell;
+
 declare interface MergedCellInfo {
     colIndex?: number;
     rowIndex?: number;
@@ -2370,11 +3000,17 @@ declare interface Meta {
      * 字段描述
      */
     description?: string;
+    /**
+     * 格式化
+     * 数值字段：一般用于格式化数字单位
+     * 文本字段：一般用于做字段枚举值的别名
+     */
     formatter?: Formatter;
 }
 
 declare type MiniChartData = BaseChartData | BulletValue;
 
+/** 迷你图样式 */
 declare interface MiniChartTheme {
     line?: LineTheme;
     bar?: BarTheme;
@@ -2392,19 +3028,24 @@ declare enum MiniChartTypes {
 declare type MouseEventHandler = (event: MouseEvent) => void;
 
 /**
- * use for gridAnalysisSheet
- *  eg. { label: '余额女',
- *      values: [
- *        ['最近7天登端天数', 1, 3423423, 323],
- *        ['自然月新登用户数', 1, 3423423, 323],
- *        ['最近7天登端天数', 1, 3423423, 323],
- *        ['自然月新登用户数', 1, 3423423, 323],
- *      ],
- *    }
+ * 单个单元格, 显示一组数据
+ * 适用于 (网格分析表, 趋势分析表) 和其他自定义场景
+ {
+ label: '余额女',
+ values: [
+ ['最近7天登端天数', 1, 3423423, 323],
+ ['自然月新登用户数', 1, 3423423, 323],
+ ['最近7天登端天数', 1, 3423423, 323],
+ ['自然月新登用户数', 1, 3423423, 323],
+ ],
+ }
  */
 declare interface MultiData<T = SimpleData[][] | MiniChartData> {
+    /** 数值 */
     values: T;
+    /** 原始值 */
     originalValues?: T;
+    /** 单元格标题 */
     label?: string;
     [key: string]: unknown;
 }
@@ -2435,7 +3076,7 @@ declare class Node_2_2 {
     isPivotMode: boolean;
     seriesNumberWidth: number;
     spreadsheet: SpreadSheet_2;
-    query?: Record<string, any>;
+    query?: Query;
     belongsCell?: S2CellType_2 | null | undefined;
     inCollapseNode?: boolean;
     cornerType?: CornerNodeType;
@@ -2507,6 +3148,10 @@ declare class Node_2_2 {
 }
 
 declare interface OffsetConfig {
+    rowHeaderOffsetX?: {
+        value: number | undefined;
+        animate?: boolean;
+    };
     offsetX?: {
         value: number | undefined;
         animate?: boolean;
@@ -2527,15 +3172,44 @@ declare interface Padding {
 }
 
 declare interface Pagination_2 {
+    /** 每页数量 */
     pageSize: number;
+    /** 当前页 (从 1 开始) */
     current: number;
+    /** 数据总条数 */
     total?: number;
 }
 
 declare interface Palette extends PaletteMeta {
+    /**
+     * 基础色值（共15个）
+     *
+     * 1. 角头字体、列头字体
+     * 2. 行头背景、数据格背景(斑马纹)
+     * 3. 行头&数据格交互(hover、选中、十字)
+     * 4. 角头背景、列头背景
+     * 5. 列头交互(hover、选中)
+     * 6. 刷选遮罩
+     * 7. 行头 link
+     * 8. mini bar、resize 交互(参考线等)
+     * 9. 数据格背景(非斑马纹)、整体表底色(建议白色)
+     * 10. 行头边框、数据格边框
+     * 11. 角头边框、列头边框
+     * 12. 竖向大分割线
+     * 13. 横向大分割线
+     * 14. 数据格字体
+     * 15. 行头字体、数据格交互色(hover)
+     */
     basicColors: string[];
 }
 
+declare const PALETTE_MAP: {
+    readonly default: Palette;
+    readonly colorful: Palette;
+    readonly gray: Palette;
+    readonly dark: Palette;
+};
+
 declare interface PaletteMeta {
     /** 主题色 */
     brandColor: string;
@@ -2547,12 +3221,14 @@ declare interface PaletteMeta {
         basicColorIndex: number;
         standardColorIndex: number;
     }>;
+    /** 语义色值 */
     semanticColors: {
         red: string;
         green: string;
         yellow: string;
         [key: string]: string;
     };
+    /** 补充色值 */
     others?: {
         results: string;
         highlight: string;
@@ -2575,20 +3251,20 @@ declare type PanelIndexes = {
 declare class PanelScrollGroup extends GridGroup {
     protected mergedCellsGroup: Group;
     constructor(cfg: GridGroupConstructorParameters);
+    getMergedCellsGroup(): Group;
     protected initMergedCellsGroup(): void;
     updateMergedCells(): void;
     addMergeCell(mergeCell: MergedCell): void;
     update(gridInfo: GridInfo): void;
 }
 
-declare interface PartDrillDown<T = BaseDrillDownComponentProps> {
+declare interface PartDrillDown<T = BaseDrillDownComponentProps> extends Pick<HeaderActionIcon, 'displayCondition'> {
     drillConfig: T;
     drillItemsNum?: number;
     fetchData: (meta: Node_2, drillFields: string[]) => Promise<PartDrillDownInfo>;
     clearDrillDown?: {
         rowId: string;
     };
-    displayCondition?: (meta: Node_2) => boolean;
 }
 
 declare interface PartDrillDownFieldInLevel {
@@ -2619,20 +3295,20 @@ loading: BooleanConstructor;
 partDrillDown: ObjectConstructor;
 header: ObjectConstructor;
 options: {
-type: PropType<S2Options<TooltipContentType, Pagination, string | Element, string>>;
-default: S2Options<TooltipContentType, Pagination, string | Element, string>;
+type: PropType<S2Options<TooltipContentType, Pagination, BaseTooltipOperatorMenuOptions>>;
+default: S2Options<TooltipContentType, Pagination, BaseTooltipOperatorMenuOptions>;
 };
 adaptive: {
 type: PropType<Adaptive>;
 default: Adaptive;
 };
-onSpreadsheet: PropType<(container: S2MountContainer, dataCfg: S2DataConfig, options: S2Options<TooltipContentType, Pagination, string | Element, string>) => SpreadSheet>;
+onSpreadsheet: PropType<(container: S2MountContainer, dataCfg: S2DataConfig, options: S2Options<TooltipContentType, Pagination, BaseTooltipOperatorMenuOptions>) => SpreadSheet>;
 onMounted: PropType<(spreadsheet: SpreadSheet) => void>;
 }, {
 s2Ref: ShallowRef<SheetExpose>;
-options: S2Options<TooltipContentType, Pagination, string | Element, string>;
+options: S2Options<TooltipContentType, Pagination, BaseTooltipOperatorMenuOptions>;
 }, unknown, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
-spreadsheet: (container: S2MountContainer, dataCfg: S2DataConfig, options: S2Options<TooltipContentType, Pagination, string | Element, string>) => SpreadSheet;
+spreadsheet: (container: S2MountContainer, dataCfg: S2DataConfig, options: S2Options<TooltipContentType, Pagination, BaseTooltipOperatorMenuOptions>) => SpreadSheet;
 sheetUpdate: SheetUpdateCallback;
 rowCellHover: (data: TargetCellInfo) => void;
 rowCellClick: (data: TargetCellInfo) => void;
@@ -2643,7 +3319,7 @@ rowCellMouseUp: (data: TargetCellInfo) => void;
 rowCellMouseMove: (data: TargetCellInfo) => void;
 rowCellCollapsed: (params: RowCellCollapsedParams) => void;
 rowCellAllCollapsed: (isCollapsed: boolean) => void;
-rowCellScroll: (position: CellScrollPosition) => void;
+rowCellScroll: (position: Required<ScrollOffset>) => void;
 colCellHover: (data: TargetCellInfo) => void;
 colCellClick: (data: TargetCellInfo) => void;
 colCellDoubleClick: (data: TargetCellInfo) => void;
@@ -2664,7 +3340,7 @@ dataCellMouseDown: (data: TargetCellInfo) => void;
 dataCellMouseUp: (data: TargetCellInfo) => void;
 dataCellMouseMove: (data: TargetCellInfo) => void;
 dataCellBrushSelection: (brushRangeDataCells: DataCell[]) => void;
-dataCellSelectMove: (metas: ViewMetaData[]) => void;
+dataCellSelectMove: (metaList: ViewMetaData[]) => void;
 cornerCellHover: (data: TargetCellInfo) => void;
 cornerCellClick: (data: TargetCellInfo) => void;
 cornerCellDoubleClick: (data: TargetCellInfo) => void;
@@ -2688,7 +3364,7 @@ filteredValues: string[];
 rangeFiltered: (data: ViewMetaData[]) => void;
 layoutAfterHeaderLayout: (layoutResult: LayoutResult) => void;
 layoutPagination: (data: LayoutPaginationParams) => void;
-layoutCellMounted: (cell: S2CellType<ViewMeta>) => void;
+layoutCellMounted: (cell: S2CellType) => void;
 beforeRender: () => void;
 afterRender: () => void;
 mounted: (spreadsheet: SpreadSheet) => void;
@@ -2726,13 +3402,13 @@ mouseHover: (event: GEvent) => void;
 mouseUp: (event: MouseEvent) => void;
 mouseDown: (event: MouseEvent) => void;
 mouseMove: (event: MouseEvent) => void;
-selected: (cells: S2CellType<ViewMeta>[]) => void;
+selected: (cells: S2CellType[]) => void;
 reset: (event: KeyboardEvent) => void;
 linkFieldJump: (data: {
 field: string;
 record: RawData;
 }) => void;
-scroll: (position: CellScrollPosition) => void;
+scroll: (position: Required<ScrollOffset>) => void;
 layoutAfterRealDataCellRender: (options: {
 add: [number, number][];
 remove: [number, number][];
@@ -2758,14 +3434,14 @@ loading: BooleanConstructor;
 partDrillDown: ObjectConstructor;
 header: ObjectConstructor;
 options: {
-type: PropType<S2Options<TooltipContentType, Pagination, string | Element, string>>;
-default: S2Options<TooltipContentType, Pagination, string | Element, string>;
+type: PropType<S2Options<TooltipContentType, Pagination, BaseTooltipOperatorMenuOptions>>;
+default: S2Options<TooltipContentType, Pagination, BaseTooltipOperatorMenuOptions>;
 };
 adaptive: {
 type: PropType<Adaptive>;
 default: Adaptive;
 };
-onSpreadsheet: PropType<(container: S2MountContainer, dataCfg: S2DataConfig, options: S2Options<TooltipContentType, Pagination, string | Element, string>) => SpreadSheet>;
+onSpreadsheet: PropType<(container: S2MountContainer, dataCfg: S2DataConfig, options: S2Options<TooltipContentType, Pagination, BaseTooltipOperatorMenuOptions>) => SpreadSheet>;
 onMounted: PropType<(spreadsheet: SpreadSheet) => void>;
 }>> & {
 onSheetUpdate?: (params: S2RenderOptions) => any;
@@ -2778,7 +3454,7 @@ onRowCellMouseUp?: (data: TargetCellInfo) => any;
 onRowCellMouseMove?: (data: TargetCellInfo) => any;
 onRowCellCollapsed?: (params: RowCellCollapsedParams) => any;
 onRowCellAllCollapsed?: (isCollapsed: boolean) => any;
-onRowCellScroll?: (position: CellScrollPosition) => any;
+onRowCellScroll?: (position: Required<ScrollOffset>) => any;
 onColCellHover?: (data: TargetCellInfo) => any;
 onColCellClick?: (data: TargetCellInfo) => any;
 onColCellDoubleClick?: (data: TargetCellInfo) => any;
@@ -2799,7 +3475,7 @@ onDataCellMouseDown?: (data: TargetCellInfo) => any;
 onDataCellMouseUp?: (data: TargetCellInfo) => any;
 onDataCellMouseMove?: (data: TargetCellInfo) => any;
 onDataCellBrushSelection?: (brushRangeDataCells: DataCell[]) => any;
-onDataCellSelectMove?: (metas: ViewMetaData[]) => any;
+onDataCellSelectMove?: (metaList: ViewMetaData[]) => any;
 onCornerCellHover?: (data: TargetCellInfo) => any;
 onCornerCellClick?: (data: TargetCellInfo) => any;
 onCornerCellDoubleClick?: (data: TargetCellInfo) => any;
@@ -2823,7 +3499,7 @@ filteredValues: string[];
 onRangeFiltered?: (data: ViewMetaData[]) => any;
 onLayoutAfterHeaderLayout?: (layoutResult: LayoutResult) => any;
 onLayoutPagination?: (data: LayoutPaginationParams) => any;
-onLayoutCellMounted?: (cell: S2CellType<ViewMeta>) => any;
+onLayoutCellMounted?: (cell: S2CellType) => any;
 onBeforeRender?: () => any;
 onAfterRender?: () => any;
 onMounted?: (spreadsheet: SpreadSheet) => any;
@@ -2861,13 +3537,13 @@ onMouseHover?: (event: GEvent) => any;
 onMouseUp?: (event: MouseEvent) => any;
 onMouseDown?: (event: MouseEvent) => any;
 onMouseMove?: (event: MouseEvent) => any;
-onSelected?: (cells: S2CellType<ViewMeta>[]) => any;
+onSelected?: (cells: S2CellType[]) => any;
 onReset?: (event: KeyboardEvent) => any;
 onLinkFieldJump?: (data: {
 field: string;
 record: RawData;
 }) => any;
-onScroll?: (position: CellScrollPosition) => any;
+onScroll?: (position: Required<ScrollOffset>) => any;
 onLayoutAfterRealDataCellRender?: (options: {
 add: [number, number][];
 remove: [number, number][];
@@ -2875,9 +3551,9 @@ spreadsheet: SpreadSheet;
 }) => any;
 onRowCellBrushSelection?: (event: GEvent) => any;
 onColCellBrushSelection?: (event: GEvent) => any;
-onSpreadsheet?: (container: S2MountContainer, dataCfg: S2DataConfig, options: S2Options<TooltipContentType, Pagination, string | Element, string>) => any;
+onSpreadsheet?: (container: S2MountContainer, dataCfg: S2DataConfig, options: S2Options<TooltipContentType, Pagination, BaseTooltipOperatorMenuOptions>) => any;
 }, {
-options: S2Options<TooltipContentType, Pagination, string | Element, string>;
+options: S2Options<TooltipContentType, Pagination, BaseTooltipOperatorMenuOptions>;
 loading: boolean;
 adaptive: boolean | {
 width?: boolean;
@@ -2888,7 +3564,7 @@ showPagination: boolean | {
 onShowSizeChange?: (pageSize: number) => void;
 onChange?: (current: number) => void;
 };
-}>;
+}, {}>;
 
 declare interface Point {
     x: number;
@@ -2909,27 +3585,49 @@ declare interface PropOption<T = any> {
 
 declare type Query = Record<string, any>;
 
+/** 子弹图状态颜色 */
 declare interface RangeColors {
+    /** 满意 */
     good: string;
+    /** 良好 */
     satisfactory: string;
+    /** 不符合预期 */
     bad: string;
 }
 
 declare type RawData_2 = Record<string, DataItem>;
 
+declare interface RenderTextShapeOptions {
+    /**
+     * 只渲染文本, 不记录 textShape 信息
+     */
+    shallowRender: boolean;
+}
+
 declare interface RequiredPropOption<T = any> {
     type?: PropType<T>;
     required: true;
 }
 
 declare interface ResizeArea {
+    /** 热区尺寸 */
     size?: number;
+    /** 热区背景色 */
     background?: string;
+    /** 参考线颜色 */
     guideLineColor?: string;
+    /** 参考线不可用颜色 */
     guideLineDisableColor?: string;
+    /** 参考线间隔 */
     guideLineDash?: number[];
+    /** 热区背景色透明度 */
     backgroundOpacity?: number;
+    /** 交互态 */
     interactionState?: InteractionState;
+    /** 单元格可拖拽最小宽度 */
+    minCellWidth?: number;
+    /** 单元格可拖拽最小高度 */
+    minCellHeight?: number;
 }
 
 declare enum ResizeAreaEffect {
@@ -2965,7 +3663,7 @@ declare interface ResizeInfo_2 {
     isResizeArea?: boolean;
     isResizeMask?: boolean;
     /** 当前拖拽热区对应的节点信息 */
-    meta: Node_2_2 | ViewMeta_2;
+    meta: Node_2_2 | ViewMeta;
     /** 拖拽后的宽度 */
     resizedWidth?: number;
     /** 拖拽后的高度 */
@@ -2985,7 +3683,9 @@ declare interface ResizeInteractionOptions {
     rowResizeType?: ResizeType;
     /** 列高调整时，影响当前列还是全部列 */
     colResizeType?: ResizeType;
+    /** 是否允许调整, 返回 false 时拖拽的宽高无效 */
     disable?: (resizeInfo: ResizeInfo_2) => boolean;
+    /** 是否显示热区 */
     visible?: (cell: S2CellType_2) => boolean;
 }
 
@@ -3013,7 +3713,7 @@ declare class RootInteraction {
     setState(interactionStateInfo: InteractionStateInfo): void;
     getState(): InteractionStateInfo;
     setInteractedCells(cell: S2CellType_2): void;
-    getInteractedCells(): S2CellType_2<ViewMeta_2>[];
+    getInteractedCells(): S2CellType_2<ViewMeta>[];
     resetState(): void;
     getCurrentStateName(): InteractionStateName | undefined;
     isEqualStateName(stateName: InteractionStateName): boolean;
@@ -3024,22 +3724,16 @@ declare class RootInteraction {
     isHoverState(): boolean;
     isActiveCell(cell: S2CellType_2): boolean;
     isSelectedCell(cell: S2CellType_2): boolean;
-    getCells(cellType?: CellTypes[]): CellMeta[];
+    getCells(cellType?: CellType[]): CellMeta[];
     getActiveCells(): S2CellType_2[];
     clearStyleIndependent(): void;
-    getPanelGroupAllUnSelectedDataCells(): DataCell_2[];
-    getPanelGroupAllDataCells(): DataCell_2[];
-    getAllRowHeaderCells(): RowCell[];
-    getAllColHeaderCells(): ColCell[];
-    getRowColActiveCells(ids: string[]): S2CellType_2<ViewMeta_2>[];
-    getAllCells(): S2CellType_2<ViewMeta_2>[];
+    getUnSelectedDataCells(): DataCell_2[];
     selectAll: () => void;
-    getCellChildrenNodes: (cell: S2CellType_2) => Node_2_2[];
     selectHeaderCell: (selectHeaderCellInfo?: SelectHeaderCellInfo) => true | undefined;
     highlightNodes: (nodes?: Node_2_2[]) => void;
     mergeCells: (cellsInfo?: MergedCellInfo[], hideData?: boolean) => void;
     unmergeCell: (removedCells: MergedCell) => void;
-    hideColumns(hiddenColumnFields?: string[], forceRender?: boolean): void;
+    hideColumns(hiddenColumnFields?: string[], forceRender?: boolean): Promise<void>;
     private getBrushSelectionInfo;
     private getDefaultInteractions;
     private registerInteractions;
@@ -3055,14 +3749,11 @@ declare class RootInteraction {
     clearHoverTimer(): void;
     setHoverTimer(timer: number): void;
     getHoverTimer(): number | null;
-    getSelectedCellHighlight(): InteractionCellSelectedHighlightType;
+    getSelectedCellHighlight(): InteractionCellSelectedHighlightOptions;
 }
 
-declare class RowCell extends HeaderCell {
-    protected headerConfig: RowHeaderConfig;
-    /** icon 绘制起始坐标 */
-    protected iconPosition: PointLike;
-    get cellType(): CellTypes;
+declare class RowCell extends HeaderCell<RowHeaderConfig> {
+    get cellType(): CellType;
     protected getBorderPositions(): CellBorderPosition[];
     protected initCell(): void;
     protected showTreeIcon(): boolean;
@@ -3073,13 +3764,11 @@ declare class RowCell extends HeaderCell {
     protected drawTreeIcon(): void;
     protected drawTreeLeafNodeAlignDot(): void;
     protected isBolderText(): boolean;
-    protected drawTextShape(): void;
-    protected drawLinkFieldShape(): void;
+    drawTextShape(options?: RenderTextShapeOptions): void;
     protected drawResizeAreaInLeaf(): void;
     protected getContentIndent(): number;
     protected getTextIndent(): number;
     protected isTreeLevel(): any;
-    protected getIconPosition(): PointLike;
     protected getMaxTextWidth(): number;
     protected getTextArea(): {
         x: number;
@@ -3124,7 +3813,8 @@ declare type RowData = Data | CellData[];
  * Row Header for SpreadSheet
  */
 declare class RowHeader extends BaseHeader<RowHeaderConfig> {
-    constructor(cfg: RowHeaderConfig);
+    constructor(config: RowHeaderConfig);
+    protected getCellInstance(node: Node_2_2): S2CellType_2;
     protected layout(): void;
     protected offset(): void;
     protected clip(): void;
@@ -3132,7 +3822,7 @@ declare class RowHeader extends BaseHeader<RowHeaderConfig> {
 
 declare type RowHeaderConfig = BaseHeaderConfig;
 
-declare interface S2BasicOptions<T = TooltipContentType_2, P = Pagination_2, Icon = Element | string, Text = string> {
+declare interface S2BasicOptions<T = TooltipContentType_2, P = Pagination_2, Menu = BaseTooltipOperatorMenuOptions_2> {
     /**
      * 表格宽度
      */
@@ -3147,14 +3837,17 @@ declare interface S2BasicOptions<T = TooltipContentType_2, P = Pagination_2, Ico
     debug?: boolean;
     /**
      * 字段标记
+     * @see https://s2.antv.antgroup.com/manual/basic/conditions
      */
     conditions?: Conditions | null;
     /**
      * 提示信息
+     * @see https://s2.antv.antgroup.com/manual/basic/tooltip
      */
-    tooltip?: Tooltip<T, Icon, Text> | null;
+    tooltip?: Tooltip<T, Menu> | null;
     /**
      * 交互配置
+     * @see https://s2.antv.antgroup.com/manual/advanced/interaction/basic
      */
     interaction?: InteractionOptions;
     /**
@@ -3175,82 +3868,110 @@ declare interface S2BasicOptions<T = TooltipContentType_2, P = Pagination_2, Ico
     showDefaultHeaderActionIcon?: boolean;
     /**
      * 自定义表头图标配置
+     * @see https://s2.antv.antgroup.com/manual/advanced/custom/custom-icon
      */
-    headerActionIcons?: HeaderActionIcon[];
+    headerActionIcons?: HeaderActionIcon_2[];
     /**
      * 自定义 SVG 图标
+     * @see https://s2.antv.antgroup.com/manual/advanced/custom/custom-icon
      */
     customSVGIcons?: CustomSVGIcon[];
     /**
      * 表格单元格宽高配置
+     * @see https://s2.antv.antgroup.com/manual/advanced/custom/cell-size
      */
     style?: S2Style;
     /**
      * 是否开启高清适配
+     * @see https://s2.antv.antgroup.com/manual/advanced/hd-adapter
      */
     hdAdapter?: boolean;
     /**
      * 空值单元格占位符
      */
     placeholder?: ((meta: Record<string, any>) => string) | string;
-    /**
-     * 是否支持 CSS 的 transform 属性
-     */
-    supportCSSTransform?: boolean;
-    /**
-     * 自定义 DPR, 默认 "window.devicePixelRatio"
-     */
-    devicePixelRatio?: number;
     /**
      * 设备类型: pc / mobile
      */
     device?: DeviceType;
+    /**
+     * 自定义 AntV/G 渲染引擎配置参数 & 插件注册
+     * @see https://g.antv.antgroup.com/plugins/intro
+     * @see https://g.antv.antgroup.com/api/canvas/options
+     * @example
+     import { Plugin as PluginA11y } from '@antv/g-plugin-a11y';
+
+     transformCanvasConfig(renderer) {
+     console.log('当前已注册插件：', renderer.getPlugins(), renderer.getConfig());
+     renderer.registerPlugin(new PluginA11y({ enableExtractingText: true }));
+
+     return {
+     supportsCSSTransform: true,
+     };
+     },
+     */
+    transformCanvasConfig?: (renderer: CanvasConfig['renderer'], spreadsheet: SpreadSheet_2) => (Partial<CanvasConfig> | null | undefined) | void;
     /** *********** 自定义单元格 hooks **************** */
     /**
      * 自定义数值单元格
+     * @see https://s2.antv.antgroup.com/examples/custom/custom-cell#data-cell
      */
     dataCell?: DataCellCallback;
     /**
      * 自定义角头单元格
+     * @see https://s2.antv.antgroup.com/examples/custom/custom-cell#corner-cell
      */
     cornerCell?: CellCallback<CornerHeaderConfig>;
     /**
      * 自定义序号单元格
+     * @see https://s2.antv.antgroup.com/examples/custom/custom-cell#series-number-cell
      */
     seriesNumberCell?: CellCallback<BaseHeaderConfig>;
     /**
      * 自定义行头单元格
+     * @see https://s2.antv.antgroup.com/examples/custom/custom-cell#row-cell
      */
     rowCell?: CellCallback<RowHeaderConfig>;
     /**
      * 自定义列头单元格
+     * @see https://s2.antv.antgroup.com/examples/custom/custom-cell#col-cell
      */
     colCell?: CellCallback<ColHeaderConfig>;
+    /**
+     * 自定义合并单元格
+     */
+    mergedCell?: MergedCellCallback;
     /**
      * 自定义表格框架/边框
+     * @see https://s2.antv.antgroup.com/examples/case/comparison#measure-comparison
      */
     frame?: FrameCallback;
     /**
      * 自定义角头
+     * @see https://s2.antv.antgroup.com/zh/examples/custom/custom-cell/#corner-header
      */
     cornerHeader?: CornerHeaderCallback;
     /** *********** 自定义布局 hooks **************** */
     /**
      * 自定义单元格层级, 动态增加/删除单元格
+     * @see https://s2.antv.antgroup.com/examples/custom/custom-layout#custom-layout-hierarchy
      */
     layoutHierarchy?: LayoutHierarchy;
     /**
      * 自定义节点排列顺序 (树状模式有效)
+     * @see https://s2.antv.antgroup.com/examples/custom/custom-layout#custom-layout-arrange
      */
     layoutArrange?: LayoutArrange;
     /**
      * 自定义单元格对应节点坐标/宽高
+     * @see https://s2.antv.antgroup.com/examples/custom/custom-layout#custom-layout-coordinate
      */
     layoutCoordinate?: LayoutCoordinate;
     /**
-     * 自定义数据坐标, 动态修改单元格数值
+     * 自定义单元格对应元数据
+     * @see https://s2.antv.antgroup.com/zh/examples/custom/custom-layout/#custom-data-position
      */
-    layoutDataPosition?: LayoutDataPosition;
+    layoutCellMeta?: LayoutCellMeta;
     /**
      * 自定义序号节点
      */
@@ -3260,9 +3981,13 @@ declare interface S2BasicOptions<T = TooltipContentType_2, P = Pagination_2, Ico
      * 自定义数据集
      */
     dataSet?: (spreadsheet: SpreadSheet_2) => BaseDataSet_2;
+    /**
+     * 自定义分面
+     */
+    facet?: (spreadsheet: SpreadSheet_2) => BaseFacet;
 }
 
-declare type S2CellType_2<T extends SimpleBBox = ViewMeta_2> = DataCell_2 | HeaderCell | ColCell | CornerCell | RowCell | SeriesNumberCell | MergedCell | TableCornerCell | TableSeriesCell | BaseCell<T>;
+declare type S2CellType_2<T extends SimpleBBox = ViewMeta> = DataCell_2 | HeaderCell | ColCell | CornerCell | RowCell | SeriesNumberCell | MergedCell | TableCornerCell | TableSeriesNumberCell | BaseCell<T>;
 
 declare interface S2DataConfig_2 {
     /**
@@ -3391,7 +4116,10 @@ declare interface S2EventHandler {
 
 declare type S2MountContainer_2 = string | Element;
 
-declare interface S2Options_2<T = TooltipContentType_2, P = Pagination_2, Icon = Element | string, Text = string> extends S2BasicOptions<T, P, Icon, Text>, S2PivotSheetOptions {
+declare interface S2Options_2<T = TooltipContentType_2, P = Pagination_2, Menu = BaseTooltipOperatorMenuOptions_2> extends S2BasicOptions<T, P, Menu>, S2PivotSheetOptions {
+    /**
+     * 行列冻结
+     */
     frozen?: S2PivotSheetFrozenOptions & S2TableSheetFrozenOptions;
 }
 
@@ -3411,10 +4139,12 @@ declare interface S2PivotSheetOptions {
     hierarchyType?: 'grid' | 'tree';
     /**
      * 小计/总计配置
+     * @see https://s2.antv.antgroup.com/manual/basic/totals
      */
     totals?: Totals | null;
     /**
      * 合并单元格配置
+     * @see https://s2.antv.antgroup.com/manual/advanced/interaction/merge-cell
      */
     mergedCellsInfo?: MergedCellInfo[][];
     /**
@@ -3481,10 +4211,15 @@ declare interface S2TableSheetFrozenOptions {
 }
 
 declare interface S2Theme extends CellThemes {
+    /** 列宽行高调整热区 */
     resizeArea?: ResizeArea;
+    /** 滚动条样式 */
     scrollBar?: ScrollBarTheme;
+    /** 分割线样式 */
     splitLine?: SplitLine;
+    /** 刷选遮罩 */
     prepareSelectMask?: InteractionStateTheme;
+    /** 画布背景底色 */
     background?: Background;
 }
 
@@ -3565,21 +4300,28 @@ declare enum ScrollbarPositionType {
 }
 
 declare interface ScrollBarTheme {
+    /** 滚动条轨道颜色 */
     trackColor?: string;
+    /** 滚动条 hover 态颜色 */
     thumbHoverColor?: string;
+    /** 滚动条颜色 */
     thumbColor?: string;
+    /** 滚动条水平最小尺寸 */
     thumbHorizontalMinSize?: number;
+    /** 滚动条垂直最小尺寸 */
     thumbVerticalMinSize?: number;
+    /** 滚动条尺寸 */
     size?: number;
+    /** 滚动条 hover 态尺寸 */
     hoverSize?: number;
     /** 指定如何绘制每一条线段末端，lineCap?: 'butt' | 'round' | 'square'; */
     lineCap?: LineStyleProps['lineCap'];
 }
 
-declare interface ScrollOffset {
+declare interface ScrollOffset_2 {
     scrollX?: number;
     scrollY?: number;
-    hRowScrollX?: number;
+    rowHeaderScrollX?: number;
 }
 
 declare interface ScrollSpeedRatio {
@@ -3590,19 +4332,21 @@ declare interface ScrollSpeedRatio {
 declare type SelectedHandler = (cells: S2CellType_2[]) => void;
 
 declare interface SelectHeaderCellInfo {
-    cell: S2CellType_2<ViewMeta_2>;
+    cell: S2CellType_2<ViewMeta>;
     isMultiSelection?: boolean;
 }
 
 declare class SeriesNumberCell extends BaseCell<Node_2_2> {
     protected headerConfig: BaseHeaderConfig;
     protected handleRestOptions(...[headerConfig]: [BaseHeaderConfig]): void;
-    get cellType(): CellTypes;
+    getHeaderConfig(): BaseHeaderConfig;
+    get cellType(): CellType;
     protected getBorderPositions(): CellBorderPosition[];
     protected initCell(): void;
     protected getBackgroundColor(): {
-        backgroundColor: string | undefined;
-        backgroundColorOpacity: number | undefined;
+        backgroundColor: string;
+        backgroundColorOpacity: number;
+        intelligentReverseTextColor: boolean;
     };
     update(): void;
     protected getTextStyle(): TextTheme;
@@ -3610,10 +4354,13 @@ declare class SeriesNumberCell extends BaseCell<Node_2_2> {
     protected getMaxTextWidth(): number;
     protected getTextPosition(): PointLike;
     protected findFieldCondition(): Condition | undefined;
-    protected mappingValue(): MappingResult | undefined;
+    protected mappingValue(): ConditionMappingResult | undefined;
+    protected getIconPosition(): PointLike;
 }
 
 declare class SeriesNumberHeader extends BaseHeader<BaseHeaderConfig> {
+    constructor(config: BaseHeaderConfig);
+    protected getCellInstance(node: Node_2_2): S2CellType_2;
     /**
      * Get seriesNumber header by config
      */
@@ -3624,10 +4371,10 @@ declare class SeriesNumberHeader extends BaseHeader<BaseHeaderConfig> {
         spreadsheet: SpreadSheet_2;
         cornerWidth: number;
     }): SeriesNumberHeader;
-    constructor(cfg: BaseHeaderConfig);
     clip(): void;
     layout(): void;
     protected offset(): void;
+    getNodes(): Node_2_2[];
 }
 
 export declare const SheetComponent: DefineComponent<GetInitProps<SheetComponentProps, "sheetType" | "spreadsheet" | "options" | "loading" | "partDrillDown" | "renderConfig" | "adaptive" | "showPagination" | "themeCfg" | "header" | "onSheetUpdate" | "onRowCellHover" | "onRowCellClick" | "onRowCellDoubleClick" | "onRowCellContextMenu" | "onRowCellMouseDown" | "onRowCellMouseUp" | "onRowCellMouseMove" | "onRowCellCollapsed" | "onRowCellAllCollapsed" | "onRowCellScroll" | "onColCellHover" | "onColCellClick" | "onColCellDoubleClick" | "onColCellContextMenu" | "onColCellMouseDown" | "onColCellMouseUp" | "onColCellMouseMove" | "onColCellExpanded" | "onColCellHidden" | "onDataCellHover" | "onDataCellClick" | "onDataCellDoubleClick" | "onDataCellContextMenu" | "onDataCellMouseDown" | "onDataCellMouseUp" | "onDataCellMouseMove" | "onDataCellBrushSelection" | "onDataCellSelectMove" | "onCornerCellHover" | "onCornerCellClick" | "onCornerCellDoubleClick" | "onCornerCellContextMenu" | "onCornerCellMouseDown" | "onCornerCellMouseUp" | "onCornerCellMouseMove" | "onMergedCellsHover" | "onMergedCellsClick" | "onMergedCellsDoubleClick" | "onMergedCellsContextMenu" | "onMergedCellsMouseDown" | "onMergedCellsMouseUp" | "onMergedCellsMouseMove" | "onRangeSort" | "onRangeSorted" | "onRangeFilter" | "onRangeFiltered" | "onLayoutAfterHeaderLayout" | "onLayoutPagination" | "onLayoutCellMounted" | "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" | "onLayoutAfterRealDataCellRender" | "onRowCellBrushSelection" | "onColCellBrushSelection">, {
@@ -3650,20 +4397,20 @@ loading: BooleanConstructor;
 partDrillDown: ObjectConstructor;
 header: ObjectConstructor;
 options: {
-type: PropType<S2Options_2<TooltipContentType_2, Pagination_2, string | Element, string>>;
-default: S2Options_2<TooltipContentType_2, Pagination_2, string | Element, string>;
+type: PropType<S2Options_2<TooltipContentType_2, Pagination_2, BaseTooltipOperatorMenuOptions_2>>;
+default: S2Options_2<TooltipContentType_2, Pagination_2, BaseTooltipOperatorMenuOptions_2>;
 };
 adaptive: {
 type: PropType<Adaptive>;
 default: Adaptive;
 };
-onSpreadsheet: PropType<(container: S2MountContainer_2, dataCfg: S2DataConfig_2, options: S2Options_2<TooltipContentType_2, Pagination_2, string | Element, string>) => SpreadSheet_2>;
+onSpreadsheet: PropType<(container: S2MountContainer_2, dataCfg: S2DataConfig_2, options: S2Options_2<TooltipContentType_2, Pagination_2, BaseTooltipOperatorMenuOptions_2>) => SpreadSheet_2>;
 onMounted: PropType<(spreadsheet: SpreadSheet_2) => void>;
 }, {
 s2Ref: ShallowRef<SheetExpose>;
-options: S2Options_2<TooltipContentType_2, Pagination_2, string | Element, string>;
+options: S2Options_2<TooltipContentType_2, Pagination_2, BaseTooltipOperatorMenuOptions_2>;
 }, unknown, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
-spreadsheet: (container: S2MountContainer_2, dataCfg: S2DataConfig_2, options: S2Options_2<TooltipContentType_2, Pagination_2, string | Element, string>) => SpreadSheet_2;
+spreadsheet: (container: S2MountContainer_2, dataCfg: S2DataConfig_2, options: S2Options_2<TooltipContentType_2, Pagination_2, BaseTooltipOperatorMenuOptions_2>) => SpreadSheet_2;
 sheetUpdate: SheetUpdateCallback;
 rowCellHover: (data: TargetCellInfo_2) => void;
 rowCellClick: (data: TargetCellInfo_2) => void;
@@ -3674,7 +4421,7 @@ rowCellMouseUp: (data: TargetCellInfo_2) => void;
 rowCellMouseMove: (data: TargetCellInfo_2) => void;
 rowCellCollapsed: (params: RowCellCollapsedParams_2) => void;
 rowCellAllCollapsed: (isCollapsed: boolean) => void;
-rowCellScroll: (position: CellScrollPosition_2) => void;
+rowCellScroll: (position: Required<ScrollOffset_2>) => void;
 colCellHover: (data: TargetCellInfo_2) => void;
 colCellClick: (data: TargetCellInfo_2) => void;
 colCellDoubleClick: (data: TargetCellInfo_2) => void;
@@ -3695,7 +4442,7 @@ dataCellMouseDown: (data: TargetCellInfo_2) => void;
 dataCellMouseUp: (data: TargetCellInfo_2) => void;
 dataCellMouseMove: (data: TargetCellInfo_2) => void;
 dataCellBrushSelection: (brushRangeDataCells: DataCell_2[]) => void;
-dataCellSelectMove: (metas: ViewMetaData_2[]) => void;
+dataCellSelectMove: (metaList: ViewMetaData_2[]) => void;
 cornerCellHover: (data: TargetCellInfo_2) => void;
 cornerCellClick: (data: TargetCellInfo_2) => void;
 cornerCellDoubleClick: (data: TargetCellInfo_2) => void;
@@ -3719,7 +4466,7 @@ filteredValues: string[];
 rangeFiltered: (data: ViewMetaData_2[]) => void;
 layoutAfterHeaderLayout: (layoutResult: LayoutResult_2) => void;
 layoutPagination: (data: LayoutPaginationParams) => void;
-layoutCellMounted: (cell: S2CellType_2<ViewMeta_2>) => void;
+layoutCellMounted: (cell: S2CellType_2) => void;
 beforeRender: () => void;
 afterRender: () => void;
 mounted: (spreadsheet: SpreadSheet_2) => void;
@@ -3757,13 +4504,13 @@ mouseHover: (event: FederatedPointerEvent) => void;
 mouseUp: (event: MouseEvent) => void;
 mouseDown: (event: MouseEvent) => void;
 mouseMove: (event: MouseEvent) => void;
-selected: (cells: S2CellType_2<ViewMeta_2>[]) => void;
+selected: (cells: S2CellType_2[]) => void;
 reset: (event: KeyboardEvent) => void;
 linkFieldJump: (data: {
 field: string;
 record: RawData_2;
 }) => void;
-scroll: (position: CellScrollPosition_2) => void;
+scroll: (position: Required<ScrollOffset_2>) => void;
 layoutAfterRealDataCellRender: (options: {
 add: [number, number][];
 remove: [number, number][];
@@ -3789,14 +4536,14 @@ loading: BooleanConstructor;
 partDrillDown: ObjectConstructor;
 header: ObjectConstructor;
 options: {
-type: PropType<S2Options_2<TooltipContentType_2, Pagination_2, string | Element, string>>;
-default: S2Options_2<TooltipContentType_2, Pagination_2, string | Element, string>;
+type: PropType<S2Options_2<TooltipContentType_2, Pagination_2, BaseTooltipOperatorMenuOptions_2>>;
+default: S2Options_2<TooltipContentType_2, Pagination_2, BaseTooltipOperatorMenuOptions_2>;
 };
 adaptive: {
 type: PropType<Adaptive>;
 default: Adaptive;
 };
-onSpreadsheet: PropType<(container: S2MountContainer_2, dataCfg: S2DataConfig_2, options: S2Options_2<TooltipContentType_2, Pagination_2, string | Element, string>) => SpreadSheet_2>;
+onSpreadsheet: PropType<(container: S2MountContainer_2, dataCfg: S2DataConfig_2, options: S2Options_2<TooltipContentType_2, Pagination_2, BaseTooltipOperatorMenuOptions_2>) => SpreadSheet_2>;
 onMounted: PropType<(spreadsheet: SpreadSheet_2) => void>;
 }>> & {
 onSheetUpdate?: (params: S2RenderOptions_2) => any;
@@ -3809,7 +4556,7 @@ onRowCellMouseUp?: (data: TargetCellInfo_2) => any;
 onRowCellMouseMove?: (data: TargetCellInfo_2) => any;
 onRowCellCollapsed?: (params: RowCellCollapsedParams_2) => any;
 onRowCellAllCollapsed?: (isCollapsed: boolean) => any;
-onRowCellScroll?: (position: CellScrollPosition_2) => any;
+onRowCellScroll?: (position: Required<ScrollOffset_2>) => any;
 onColCellHover?: (data: TargetCellInfo_2) => any;
 onColCellClick?: (data: TargetCellInfo_2) => any;
 onColCellDoubleClick?: (data: TargetCellInfo_2) => any;
@@ -3830,7 +4577,7 @@ onDataCellMouseDown?: (data: TargetCellInfo_2) => any;
 onDataCellMouseUp?: (data: TargetCellInfo_2) => any;
 onDataCellMouseMove?: (data: TargetCellInfo_2) => any;
 onDataCellBrushSelection?: (brushRangeDataCells: DataCell_2[]) => any;
-onDataCellSelectMove?: (metas: ViewMetaData_2[]) => any;
+onDataCellSelectMove?: (metaList: ViewMetaData_2[]) => any;
 onCornerCellHover?: (data: TargetCellInfo_2) => any;
 onCornerCellClick?: (data: TargetCellInfo_2) => any;
 onCornerCellDoubleClick?: (data: TargetCellInfo_2) => any;
@@ -3854,7 +4601,7 @@ filteredValues: string[];
 onRangeFiltered?: (data: ViewMetaData_2[]) => any;
 onLayoutAfterHeaderLayout?: (layoutResult: LayoutResult_2) => any;
 onLayoutPagination?: (data: LayoutPaginationParams) => any;
-onLayoutCellMounted?: (cell: S2CellType_2<ViewMeta_2>) => any;
+onLayoutCellMounted?: (cell: S2CellType_2) => any;
 onBeforeRender?: () => any;
 onAfterRender?: () => any;
 onMounted?: (spreadsheet: SpreadSheet_2) => any;
@@ -3892,13 +4639,13 @@ onMouseHover?: (event: FederatedPointerEvent) => any;
 onMouseUp?: (event: MouseEvent) => any;
 onMouseDown?: (event: MouseEvent) => any;
 onMouseMove?: (event: MouseEvent) => any;
-onSelected?: (cells: S2CellType_2<ViewMeta_2>[]) => any;
+onSelected?: (cells: S2CellType_2[]) => any;
 onReset?: (event: KeyboardEvent) => any;
 onLinkFieldJump?: (data: {
 field: string;
 record: RawData_2;
 }) => any;
-onScroll?: (position: CellScrollPosition_2) => any;
+onScroll?: (position: Required<ScrollOffset_2>) => any;
 onLayoutAfterRealDataCellRender?: (options: {
 add: [number, number][];
 remove: [number, number][];
@@ -3906,9 +4653,9 @@ spreadsheet: SpreadSheet_2;
 }) => any;
 onRowCellBrushSelection?: (event: FederatedPointerEvent) => any;
 onColCellBrushSelection?: (event: FederatedPointerEvent) => any;
-onSpreadsheet?: (container: S2MountContainer_2, dataCfg: S2DataConfig_2, options: S2Options_2<TooltipContentType_2, Pagination_2, string | Element, string>) => any;
+onSpreadsheet?: (container: S2MountContainer_2, dataCfg: S2DataConfig_2, options: S2Options_2<TooltipContentType_2, Pagination_2, BaseTooltipOperatorMenuOptions_2>) => any;
 }, {
-options: S2Options_2<TooltipContentType_2, Pagination_2, string | Element, string>;
+options: S2Options_2<TooltipContentType_2, Pagination_2, BaseTooltipOperatorMenuOptions_2>;
 loading: boolean;
 adaptive: boolean | {
 width?: boolean;
@@ -3919,10 +4666,10 @@ showPagination: boolean | {
 onShowSizeChange?: (pageSize: number) => void;
 onChange?: (current: number) => void;
 };
-}> | DefineComponent<GetInitProps<SheetComponentProps, "sheetType" | "spreadsheet" | "options" | "loading" | "partDrillDown" | "renderConfig" | "adaptive" | "showPagination" | "themeCfg" | "header" | "onSheetUpdate" | "onRowCellHover" | "onRowCellClick" | "onRowCellDoubleClick" | "onRowCellContextMenu" | "onRowCellMouseDown" | "onRowCellMouseUp" | "onRowCellMouseMove" | "onRowCellCollapsed" | "onRowCellAllCollapsed" | "onRowCellScroll" | "onColCellHover" | "onColCellClick" | "onColCellDoubleClick" | "onColCellContextMenu" | "onColCellMouseDown" | "onColCellMouseUp" | "onColCellMouseMove" | "onColCellExpanded" | "onColCellHidden" | "onDataCellHover" | "onDataCellClick" | "onDataCellDoubleClick" | "onDataCellContextMenu" | "onDataCellMouseDown" | "onDataCellMouseUp" | "onDataCellMouseMove" | "onDataCellBrushSelection" | "onDataCellSelectMove" | "onCornerCellHover" | "onCornerCellClick" | "onCornerCellDoubleClick" | "onCornerCellContextMenu" | "onCornerCellMouseDown" | "onCornerCellMouseUp" | "onCornerCellMouseMove" | "onMergedCellsHover" | "onMergedCellsClick" | "onMergedCellsDoubleClick" | "onMergedCellsContextMenu" | "onMergedCellsMouseDown" | "onMergedCellsMouseUp" | "onMergedCellsMouseMove" | "onRangeSort" | "onRangeSorted" | "onRangeFilter" | "onRangeFiltered" | "onLayoutAfterHeaderLayout" | "onLayoutPagination" | "onLayoutCellMounted" | "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" | "onLayoutAfterRealDataCellRender" | "onRowCellBrushSelection" | "onColCellBrushSelection">, {
+}, {}> | DefineComponent<GetInitProps<SheetComponentProps, "sheetType" | "spreadsheet" | "options" | "loading" | "partDrillDown" | "renderConfig" | "adaptive" | "showPagination" | "themeCfg" | "header" | "onSheetUpdate" | "onRowCellHover" | "onRowCellClick" | "onRowCellDoubleClick" | "onRowCellContextMenu" | "onRowCellMouseDown" | "onRowCellMouseUp" | "onRowCellMouseMove" | "onRowCellCollapsed" | "onRowCellAllCollapsed" | "onRowCellScroll" | "onColCellHover" | "onColCellClick" | "onColCellDoubleClick" | "onColCellContextMenu" | "onColCellMouseDown" | "onColCellMouseUp" | "onColCellMouseMove" | "onColCellExpanded" | "onColCellHidden" | "onDataCellHover" | "onDataCellClick" | "onDataCellDoubleClick" | "onDataCellContextMenu" | "onDataCellMouseDown" | "onDataCellMouseUp" | "onDataCellMouseMove" | "onDataCellBrushSelection" | "onDataCellSelectMove" | "onCornerCellHover" | "onCornerCellClick" | "onCornerCellDoubleClick" | "onCornerCellContextMenu" | "onCornerCellMouseDown" | "onCornerCellMouseUp" | "onCornerCellMouseMove" | "onMergedCellsHover" | "onMergedCellsClick" | "onMergedCellsDoubleClick" | "onMergedCellsContextMenu" | "onMergedCellsMouseDown" | "onMergedCellsMouseUp" | "onMergedCellsMouseMove" | "onRangeSort" | "onRangeSorted" | "onRangeFilter" | "onRangeFiltered" | "onLayoutAfterHeaderLayout" | "onLayoutPagination" | "onLayoutCellMounted" | "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" | "onLayoutAfterRealDataCellRender" | "onRowCellBrushSelection" | "onColCellBrushSelection">, {
 s2Ref: ShallowRef<SheetExpose>;
 }, unknown, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
-spreadsheet: (container: S2MountContainer_2, dataCfg: S2DataConfig_2, options: S2Options_2<TooltipContentType_2, Pagination_2, string | Element, string>) => SpreadSheet_2;
+spreadsheet: (container: S2MountContainer_2, dataCfg: S2DataConfig_2, options: S2Options_2<TooltipContentType_2, Pagination_2, BaseTooltipOperatorMenuOptions_2>) => SpreadSheet_2;
 sheetUpdate: SheetUpdateCallback;
 rowCellHover: (data: TargetCellInfo_2) => void;
 rowCellClick: (data: TargetCellInfo_2) => void;
@@ -3933,7 +4680,7 @@ rowCellMouseUp: (data: TargetCellInfo_2) => void;
 rowCellMouseMove: (data: TargetCellInfo_2) => void;
 rowCellCollapsed: (params: RowCellCollapsedParams_2) => void;
 rowCellAllCollapsed: (isCollapsed: boolean) => void;
-rowCellScroll: (position: CellScrollPosition_2) => void;
+rowCellScroll: (position: Required<ScrollOffset_2>) => void;
 colCellHover: (data: TargetCellInfo_2) => void;
 colCellClick: (data: TargetCellInfo_2) => void;
 colCellDoubleClick: (data: TargetCellInfo_2) => void;
@@ -3954,7 +4701,7 @@ dataCellMouseDown: (data: TargetCellInfo_2) => void;
 dataCellMouseUp: (data: TargetCellInfo_2) => void;
 dataCellMouseMove: (data: TargetCellInfo_2) => void;
 dataCellBrushSelection: (brushRangeDataCells: DataCell_2[]) => void;
-dataCellSelectMove: (metas: ViewMetaData_2[]) => void;
+dataCellSelectMove: (metaList: ViewMetaData_2[]) => void;
 cornerCellHover: (data: TargetCellInfo_2) => void;
 cornerCellClick: (data: TargetCellInfo_2) => void;
 cornerCellDoubleClick: (data: TargetCellInfo_2) => void;
@@ -3978,7 +4725,7 @@ filteredValues: string[];
 rangeFiltered: (data: ViewMetaData_2[]) => void;
 layoutAfterHeaderLayout: (layoutResult: LayoutResult_2) => void;
 layoutPagination: (data: LayoutPaginationParams) => void;
-layoutCellMounted: (cell: S2CellType_2<ViewMeta_2>) => void;
+layoutCellMounted: (cell: S2CellType_2) => void;
 beforeRender: () => void;
 afterRender: () => void;
 mounted: (spreadsheet: SpreadSheet_2) => void;
@@ -4016,13 +4763,13 @@ mouseHover: (event: FederatedPointerEvent) => void;
 mouseUp: (event: MouseEvent) => void;
 mouseDown: (event: MouseEvent) => void;
 mouseMove: (event: MouseEvent) => void;
-selected: (cells: S2CellType_2<ViewMeta_2>[]) => void;
+selected: (cells: S2CellType_2[]) => void;
 reset: (event: KeyboardEvent) => void;
 linkFieldJump: (data: {
 field: string;
 record: RawData_2;
 }) => void;
-scroll: (position: CellScrollPosition_2) => void;
+scroll: (position: Required<ScrollOffset_2>) => void;
 layoutAfterRealDataCellRender: (options: {
 add: [number, number][];
 remove: [number, number][];
@@ -4041,7 +4788,7 @@ onRowCellMouseUp?: (data: TargetCellInfo_2) => any;
 onRowCellMouseMove?: (data: TargetCellInfo_2) => any;
 onRowCellCollapsed?: (params: RowCellCollapsedParams_2) => any;
 onRowCellAllCollapsed?: (isCollapsed: boolean) => any;
-onRowCellScroll?: (position: CellScrollPosition_2) => any;
+onRowCellScroll?: (position: Required<ScrollOffset_2>) => any;
 onColCellHover?: (data: TargetCellInfo_2) => any;
 onColCellClick?: (data: TargetCellInfo_2) => any;
 onColCellDoubleClick?: (data: TargetCellInfo_2) => any;
@@ -4062,7 +4809,7 @@ onDataCellMouseDown?: (data: TargetCellInfo_2) => any;
 onDataCellMouseUp?: (data: TargetCellInfo_2) => any;
 onDataCellMouseMove?: (data: TargetCellInfo_2) => any;
 onDataCellBrushSelection?: (brushRangeDataCells: DataCell_2[]) => any;
-onDataCellSelectMove?: (metas: ViewMetaData_2[]) => any;
+onDataCellSelectMove?: (metaList: ViewMetaData_2[]) => any;
 onCornerCellHover?: (data: TargetCellInfo_2) => any;
 onCornerCellClick?: (data: TargetCellInfo_2) => any;
 onCornerCellDoubleClick?: (data: TargetCellInfo_2) => any;
@@ -4086,7 +4833,7 @@ filteredValues: string[];
 onRangeFiltered?: (data: ViewMetaData_2[]) => any;
 onLayoutAfterHeaderLayout?: (layoutResult: LayoutResult_2) => any;
 onLayoutPagination?: (data: LayoutPaginationParams) => any;
-onLayoutCellMounted?: (cell: S2CellType_2<ViewMeta_2>) => any;
+onLayoutCellMounted?: (cell: S2CellType_2) => any;
 onBeforeRender?: () => any;
 onAfterRender?: () => any;
 onMounted?: (spreadsheet: SpreadSheet_2) => any;
@@ -4124,13 +4871,13 @@ onMouseHover?: (event: FederatedPointerEvent) => any;
 onMouseUp?: (event: MouseEvent) => any;
 onMouseDown?: (event: MouseEvent) => any;
 onMouseMove?: (event: MouseEvent) => any;
-onSelected?: (cells: S2CellType_2<ViewMeta_2>[]) => any;
+onSelected?: (cells: S2CellType_2[]) => any;
 onReset?: (event: KeyboardEvent) => any;
 onLinkFieldJump?: (data: {
 field: string;
 record: RawData_2;
 }) => any;
-onScroll?: (position: CellScrollPosition_2) => any;
+onScroll?: (position: Required<ScrollOffset_2>) => any;
 onLayoutAfterRealDataCellRender?: (options: {
 add: [number, number][];
 remove: [number, number][];
@@ -4138,10 +4885,10 @@ spreadsheet: SpreadSheet_2;
 }) => any;
 onRowCellBrushSelection?: (event: FederatedPointerEvent) => any;
 onColCellBrushSelection?: (event: FederatedPointerEvent) => any;
-onSpreadsheet?: (container: S2MountContainer_2, dataCfg: S2DataConfig_2, options: S2Options_2<TooltipContentType_2, Pagination_2, string | Element, string>) => any;
-}, {}>>;
+onSpreadsheet?: (container: S2MountContainer_2, dataCfg: S2DataConfig_2, options: S2Options_2<TooltipContentType_2, Pagination_2, BaseTooltipOperatorMenuOptions_2>) => any;
+}, {}, {}>>;
 }, unknown, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
-spreadsheet: (container: S2MountContainer_2, dataCfg: S2DataConfig_2, options: S2Options_2<TooltipContentType_2, Pagination_2, string | Element, string>) => SpreadSheet_2;
+spreadsheet: (container: S2MountContainer_2, dataCfg: S2DataConfig_2, options: S2Options_2<TooltipContentType_2, Pagination_2, BaseTooltipOperatorMenuOptions_2>) => SpreadSheet_2;
 sheetUpdate: SheetUpdateCallback;
 rowCellHover: (data: TargetCellInfo_2) => void;
 rowCellClick: (data: TargetCellInfo_2) => void;
@@ -4152,7 +4899,7 @@ rowCellMouseUp: (data: TargetCellInfo_2) => void;
 rowCellMouseMove: (data: TargetCellInfo_2) => void;
 rowCellCollapsed: (params: RowCellCollapsedParams_2) => void;
 rowCellAllCollapsed: (isCollapsed: boolean) => void;
-rowCellScroll: (position: CellScrollPosition_2) => void;
+rowCellScroll: (position: Required<ScrollOffset_2>) => void;
 colCellHover: (data: TargetCellInfo_2) => void;
 colCellClick: (data: TargetCellInfo_2) => void;
 colCellDoubleClick: (data: TargetCellInfo_2) => void;
@@ -4173,7 +4920,7 @@ dataCellMouseDown: (data: TargetCellInfo_2) => void;
 dataCellMouseUp: (data: TargetCellInfo_2) => void;
 dataCellMouseMove: (data: TargetCellInfo_2) => void;
 dataCellBrushSelection: (brushRangeDataCells: DataCell_2[]) => void;
-dataCellSelectMove: (metas: ViewMetaData_2[]) => void;
+dataCellSelectMove: (metaList: ViewMetaData_2[]) => void;
 cornerCellHover: (data: TargetCellInfo_2) => void;
 cornerCellClick: (data: TargetCellInfo_2) => void;
 cornerCellDoubleClick: (data: TargetCellInfo_2) => void;
@@ -4197,7 +4944,7 @@ filteredValues: string[];
 rangeFiltered: (data: ViewMetaData_2[]) => void;
 layoutAfterHeaderLayout: (layoutResult: LayoutResult_2) => void;
 layoutPagination: (data: LayoutPaginationParams) => void;
-layoutCellMounted: (cell: S2CellType_2<ViewMeta_2>) => void;
+layoutCellMounted: (cell: S2CellType_2) => void;
 beforeRender: () => void;
 afterRender: () => void;
 mounted: (spreadsheet: SpreadSheet_2) => void;
@@ -4235,13 +4982,13 @@ mouseHover: (event: FederatedPointerEvent) => void;
 mouseUp: (event: MouseEvent) => void;
 mouseDown: (event: MouseEvent) => void;
 mouseMove: (event: MouseEvent) => void;
-selected: (cells: S2CellType_2<ViewMeta_2>[]) => void;
+selected: (cells: S2CellType_2[]) => void;
 reset: (event: KeyboardEvent) => void;
 linkFieldJump: (data: {
 field: string;
 record: RawData_2;
 }) => void;
-scroll: (position: CellScrollPosition_2) => void;
+scroll: (position: Required<ScrollOffset_2>) => void;
 layoutAfterRealDataCellRender: (options: {
 add: [number, number][];
 remove: [number, number][];
@@ -4260,7 +5007,7 @@ onRowCellMouseUp?: (data: TargetCellInfo_2) => any;
 onRowCellMouseMove?: (data: TargetCellInfo_2) => any;
 onRowCellCollapsed?: (params: RowCellCollapsedParams_2) => any;
 onRowCellAllCollapsed?: (isCollapsed: boolean) => any;
-onRowCellScroll?: (position: CellScrollPosition_2) => any;
+onRowCellScroll?: (position: Required<ScrollOffset_2>) => any;
 onColCellHover?: (data: TargetCellInfo_2) => any;
 onColCellClick?: (data: TargetCellInfo_2) => any;
 onColCellDoubleClick?: (data: TargetCellInfo_2) => any;
@@ -4281,7 +5028,7 @@ onDataCellMouseDown?: (data: TargetCellInfo_2) => any;
 onDataCellMouseUp?: (data: TargetCellInfo_2) => any;
 onDataCellMouseMove?: (data: TargetCellInfo_2) => any;
 onDataCellBrushSelection?: (brushRangeDataCells: DataCell_2[]) => any;
-onDataCellSelectMove?: (metas: ViewMetaData_2[]) => any;
+onDataCellSelectMove?: (metaList: ViewMetaData_2[]) => any;
 onCornerCellHover?: (data: TargetCellInfo_2) => any;
 onCornerCellClick?: (data: TargetCellInfo_2) => any;
 onCornerCellDoubleClick?: (data: TargetCellInfo_2) => any;
@@ -4305,7 +5052,7 @@ filteredValues: string[];
 onRangeFiltered?: (data: ViewMetaData_2[]) => any;
 onLayoutAfterHeaderLayout?: (layoutResult: LayoutResult_2) => any;
 onLayoutPagination?: (data: LayoutPaginationParams) => any;
-onLayoutCellMounted?: (cell: S2CellType_2<ViewMeta_2>) => any;
+onLayoutCellMounted?: (cell: S2CellType_2) => any;
 onBeforeRender?: () => any;
 onAfterRender?: () => any;
 onMounted?: (spreadsheet: SpreadSheet_2) => any;
@@ -4343,13 +5090,13 @@ onMouseHover?: (event: FederatedPointerEvent) => any;
 onMouseUp?: (event: MouseEvent) => any;
 onMouseDown?: (event: MouseEvent) => any;
 onMouseMove?: (event: MouseEvent) => any;
-onSelected?: (cells: S2CellType_2<ViewMeta_2>[]) => any;
+onSelected?: (cells: S2CellType_2[]) => any;
 onReset?: (event: KeyboardEvent) => any;
 onLinkFieldJump?: (data: {
 field: string;
 record: RawData_2;
 }) => any;
-onScroll?: (position: CellScrollPosition_2) => any;
+onScroll?: (position: Required<ScrollOffset_2>) => any;
 onLayoutAfterRealDataCellRender?: (options: {
 add: [number, number][];
 remove: [number, number][];
@@ -4357,8 +5104,8 @@ spreadsheet: SpreadSheet_2;
 }) => any;
 onRowCellBrushSelection?: (event: FederatedPointerEvent) => any;
 onColCellBrushSelection?: (event: FederatedPointerEvent) => any;
-onSpreadsheet?: (container: S2MountContainer_2, dataCfg: S2DataConfig_2, options: S2Options_2<TooltipContentType_2, Pagination_2, string | Element, string>) => any;
-}, {}>;
+onSpreadsheet?: (container: S2MountContainer_2, dataCfg: S2DataConfig_2, options: S2Options_2<TooltipContentType_2, Pagination_2, BaseTooltipOperatorMenuOptions_2>) => any;
+}, {}, {}>;
 
 declare type SheetComponentOptions = S2Options<TooltipContentType, Pagination & PaginationProps>;
 
@@ -4383,8 +5130,9 @@ declare interface SimpleBBox {
 declare type SimpleData = string | number | null;
 
 declare interface Sort {
-    /** 字段id，业务中一般是displayId */
+    /** 字段id */
     sortFieldId: string;
+    /** 排序方式 */
     sortMethod?: SortMethod;
     /** 自定义排序 */
     sortBy?: string[];
@@ -4405,45 +5153,70 @@ declare interface SortFuncParam extends Sort {
 declare type SortMethod = 'ASC' | 'DESC' | 'asc' | 'desc';
 
 declare interface SortParam extends Sort {
-    /** 自定义func */
+    /** 自定义排序 */
     sortFunc?: (param: SortFuncParam) => Array<string | Record<string, any>>;
 }
 
 declare type SortParams_2 = SortParam[];
 
 declare interface SplitLine {
+    /** 水平分割线颜色 */
     horizontalBorderColor?: string;
+    /** 水平分割线颜色透明度 */
     horizontalBorderColorOpacity?: number;
+    /** 水平分割线宽度 */
     horizontalBorderWidth?: number;
+    /** 垂直分割线颜色 */
     verticalBorderColor?: string;
+    /** 垂直分割线颜色透明度 */
     verticalBorderColorOpacity?: number;
+    /** 垂直分割线宽度 */
     verticalBorderWidth?: number;
+    /** 分割线是否显示外阴影 */
     showShadow?: boolean;
+    /** 阴影宽度 */
     shadowWidth?: number;
+    /** 阴影线性渐变色 */
     shadowColors?: {
+        /** 线性变化左侧颜色 */
         left: string;
+        /** 线性变化右侧颜色 */
         right: string;
     };
 }
 
 declare abstract class SpreadSheet_2 extends EE {
-    theme: S2Theme;
+    themeName: ThemeName;
+    theme: InternalFullyTheme;
     store: Store;
     dataCfg: S2DataConfig_2;
     options: S2Options_2;
     dataSet: BaseDataSet_2;
-    /**
-     * Facet: determine how to render headers/cell
-     */
     facet: BaseFacet;
     tooltip: BaseTooltip_2;
     container: Canvas;
     interaction: RootInteraction;
     hdAdapter: HdAdapter;
+    /**
+     * 表格是否已销毁
+     */
+    private destroyed;
     private untypedOn;
     private untypedEmit;
     on: <K extends keyof EmitterType>(event: K, listener: EmitterType[K]) => this;
     emit: <K extends keyof EmitterType>(event: K, ...args: Parameters<EmitterType[K]>) => boolean;
+    protected abstract bindEvents(): void;
+    abstract getDataSet(): BaseDataSet_2;
+    abstract enableFrozenHeaders(): boolean;
+    abstract isPivotMode(): boolean;
+    abstract isCustomRowFields(): boolean;
+    abstract isHierarchyTreeType(): boolean;
+    abstract isFrozenRowHeader(): boolean;
+    abstract isTableMode(): boolean;
+    abstract isValueInCols(): boolean;
+    protected abstract buildFacet(): void;
+    abstract clearDrillDownData(rowNodeId?: string, preventRender?: boolean): void;
+    abstract groupSortByMethod(sortMethod: SortMethod, meta: Node_2_2): void;
     constructor(dom: S2MountContainer_2, dataCfg: S2DataConfig_2, options: S2Options_2 | null);
     isCustomHeaderFields(fieldType?: keyof Pick<Fields, 'columns' | 'rows'>): boolean;
     isCustomColumnFields(): boolean;
@@ -4456,38 +5229,8 @@ declare abstract class SpreadSheet_2 extends EE {
     private initInteraction;
     private initTooltip;
     private renderTooltip;
-    protected abstract bindEvents(): void;
-    abstract getDataSet(): BaseDataSet_2;
-    /**
-     * 是否开启冻结行列头效果
-     */
-    abstract enableFrozenHeaders(): boolean;
-    /**
-     * Check if is pivot mode
-     */
-    abstract isPivotMode(): boolean;
-    abstract isCustomRowFields(): boolean;
-    /**
-     * tree type must be in strategy mode
-     */
-    abstract isHierarchyTreeType(): boolean;
-    /**
-     * Scroll Freeze Row Header
-     */
-    abstract isFrozenRowHeader(): boolean;
-    /**
-     * Check if is pivot mode
-     */
-    abstract isTableMode(): boolean;
-    /**
-     * Check if the value is in the columns
-     */
-    abstract isValueInCols(): boolean;
-    protected abstract buildFacet(): void;
-    abstract clearDrillDownData(rowNodeId?: string, preventRender?: boolean): void;
-    abstract handleGroupSort(event: FederatedPointerEvent, meta: Node_2_2): void;
-    showTooltip<T = TooltipContentType_2>(showOptions: TooltipShowOptions<T>): void;
-    showTooltipWithInfo(event: FederatedPointerEvent | MouseEvent, data: TooltipData[], options?: TooltipOptions): void;
+    showTooltip<T = TooltipContentType_2, Menu = BaseTooltipOperatorMenuOptions_2>(showOptions: TooltipShowOptions<T, Menu>): Promise<void>;
+    showTooltipWithInfo(event: FederatedPointerEvent | MouseEvent, cellInfos: TooltipData[], options?: TooltipOptions): Promise<void> | void;
     hideTooltip(): void;
     destroyTooltip(): void;
     registerIcons(): void;
@@ -4500,10 +5243,19 @@ declare abstract class SpreadSheet_2 extends EE {
      */
     setDataCfg(dataCfg: S2DataConfig_2, reset?: boolean): void;
     setOptions(options: Partial<S2Options_2>, reset?: boolean): void;
-    render(reloadData?: boolean, options?: S2RenderOptions_2): void;
+    private doRender;
+    /**
+     * 同步渲染
+     * @deprecated 适配 g5.0 异步渲染过程中暂时保留
+     */
+    UNSAFE_render(reloadData?: boolean, options?: S2RenderOptions_2): void;
+    render(reloadData?: boolean, options?: S2RenderOptions_2): Promise<void>;
     destroy(): void;
+    private setThemeName;
     setThemeCfg(themeCfg?: ThemeCfg_2): void;
     setTheme(theme: S2Theme): void;
+    getTheme(): InternalFullyTheme;
+    getThemeName(): "default" | "colorful" | "gray" | "dark";
     /**
      * Update pagination config which store in {@see options}
      * @param pagination
@@ -4524,14 +5276,6 @@ declare abstract class SpreadSheet_2 extends EE {
      */
     getCanvasElement(): HTMLCanvasElement;
     getLayoutWidthType(): LayoutWidthType;
-    getRowNodes(level?: number): Node_2_2[];
-    getRowLeafNodes(): Node_2_2[];
-    /**
-     * get columnNode in levels,
-     * @param level -1 = get all
-     */
-    getColumnNodes(level?: number): Node_2_2[];
-    getColumnLeafNodes(): Node_2_2[];
     /**
      * Update scroll's offset, the value can be undefined,
      * indicate not update current value
@@ -4541,12 +5285,11 @@ declare abstract class SpreadSheet_2 extends EE {
      */
     updateScrollOffset(offsetConfig: OffsetConfig): void;
     getCell<T extends S2CellType_2 = S2CellType_2>(target: CellEventTarget): T | null;
-    getCellType(target: CellEventTarget): CellTypes | undefined;
+    getCellType(target: CellEventTarget): CellType | undefined;
     /**
-     * get total's config by dimension id
-     * @param dimension unique dimension id
+     * 获取当前维度对应的汇总配置
      */
-    getTotalsConfig(dimension: string): Partial<Totals['row']>;
+    getTotalsConfig(dimension: string): Total;
     /**
      * Create all related groups, contains:
      * 1. container -- base canvas group
@@ -4558,8 +5301,6 @@ declare abstract class SpreadSheet_2 extends EE {
      */
     protected initContainer(dom: S2MountContainer_2): void;
     protected updateContainerStyle(): void;
-    getInitColumnLeafNodes(): Node_2_2[];
-    clearColumnLeafNodes(): void;
     private initHiddenColumnsDetail;
     private clearCanvasEvent;
     /**
@@ -4592,6 +5333,7 @@ declare abstract class SpreadSheet_2 extends EE {
     measureTextWidthRoughly: (text: any, font?: any) => number;
     updateSortMethodMap(nodeId: string, sortMethod: SortMethod, replace?: boolean): void;
     getMenuDefaultSelectedKeys(nodeId: string): string[];
+    handleGroupSort(event: FederatedPointerEvent, meta: Node_2_2): void;
 }
 
 declare type StateShapeLayer = 'interactiveBgShape' | 'interactiveBorderShape';
@@ -4608,34 +5350,91 @@ declare class Store {
     size(): number;
 }
 
-/**
- * All stored keys need type define here
- */
 declare interface StoreKey {
+    /**
+     * 水平滚动偏移
+     */
     scrollX: number;
+    /**
+     * 垂直滚动偏移
+     */
     scrollY: number;
-    hRowScrollX: number;
+    /**
+     * 行头水平滚动偏移
+     */
+    rowHeaderScrollX: number;
+    /**
+     * 列头点击排序配置
+     */
     sortParam: SortParam;
+    /**
+     * 下钻节点id和对应生成的 path 寻址路径
+     */
     drillDownIdPathMap: Map<string, DataPath[]>;
+    /**
+     * 当前下钻节点
+     */
     drillDownNode: Node_2_2;
+    /**
+     * 下钻数据的个数控制
+     */
     drillItemsNum: number;
+    /**
+     * 下钻节点层级信息
+     */
     drillDownFieldInLevel: PartDrillDownFieldInLevel[];
+    /**
+     * 当前交互状态信息
+     */
     interactionStateInfo: InteractionStateInfo;
+    /**
+     * 原始数据配置
+     */
     originalDataCfg: S2DataConfig_2;
+    /**
+     * 可视区域包裹盒模型
+     */
     panelBBox: BBox;
+    /**
+     * 当前调整大小区域 group
+     */
     activeResizeArea: Group;
+    /**
+     * 条件格式值区间
+     */
     valueRanges: ValueRanges;
-    initColumnLeafNodes: Node_2_2[] | undefined;
+    /**
+     * 初次渲染时的列头叶子节点
+     */
+    initColLeafNodes: Node_2_2[] | undefined;
     /**
      * 隐藏列详情
      *  | a, b, [c,d 隐藏] [icon e ] , [f 隐藏], [icon g]   |
      */
     hiddenColumnsDetail: HiddenColumnsInfo_2[];
+    /**
+     * 上一次渲染的列头
+     */
     lastRenderedColumnFields: string[];
+    /**
+     * 是否手动调整过宽高
+     */
     resized: boolean;
+    /**
+     * hover 显示的 icon 缓存
+     */
     visibleActionIcons: GuiIcon[];
-    lastClickedCell: S2CellType_2<ViewMeta_2> | null;
+    /**
+     * 上一次点击的单元格
+     */
+    lastClickedCell: S2CellType_2<ViewMeta> | null;
+    /**
+     * 初始化时的边界滚动配置
+     */
     initOverscrollBehavior: InteractionOptions['overscrollBehavior'];
+    /**
+     * 排序方式
+     */
     sortMethodMap: Record<string, SortMethod> | null;
     [key: string]: unknown;
 }
@@ -4649,10 +5448,10 @@ declare class TableColCell extends ColCell {
         x: number;
         y: number;
     };
-    protected getColResizeArea(): Group | undefined;
+    protected getColResizeArea(): Group_2 | undefined;
     protected isSortCell(): boolean;
     protected showSortIcon(): boolean | undefined;
-    protected getTextStyle(): TextTheme;
+    protected getTextStyle(): DeepRequired<TextTheme>;
     protected getHorizontalResizeAreaName(): string;
     protected drawBackgroundShape(): void;
     protected handleViewport(viewport: AreaRange): AreaRange;
@@ -4664,22 +5463,21 @@ declare class TableCornerCell extends TableColCell {
 }
 
 declare class TableDataCell extends DataCell_2 {
-    protected drawTextShape(): void;
-    protected drawLinkFieldShape(): void;
+    protected getLinkFieldStyle(): string;
     drawBorders(): void;
     protected shouldDrawResizeArea(): boolean;
     drawResizeArea(): void;
 }
 
-declare class TableSeriesCell extends TableDataCell {
-    get cellType(): CellTypes;
+declare class TableSeriesNumberCell extends TableDataCell {
+    get cellType(): CellType;
     protected getTextStyle(): TextTheme;
 }
 
 export declare const TableSheet: DefineComponent<GetInitProps<SheetComponentProps, "sheetType" | "spreadsheet" | "options" | "loading" | "partDrillDown" | "renderConfig" | "adaptive" | "showPagination" | "themeCfg" | "header" | "onSheetUpdate" | "onRowCellHover" | "onRowCellClick" | "onRowCellDoubleClick" | "onRowCellContextMenu" | "onRowCellMouseDown" | "onRowCellMouseUp" | "onRowCellMouseMove" | "onRowCellCollapsed" | "onRowCellAllCollapsed" | "onRowCellScroll" | "onColCellHover" | "onColCellClick" | "onColCellDoubleClick" | "onColCellContextMenu" | "onColCellMouseDown" | "onColCellMouseUp" | "onColCellMouseMove" | "onColCellExpanded" | "onColCellHidden" | "onDataCellHover" | "onDataCellClick" | "onDataCellDoubleClick" | "onDataCellContextMenu" | "onDataCellMouseDown" | "onDataCellMouseUp" | "onDataCellMouseMove" | "onDataCellBrushSelection" | "onDataCellSelectMove" | "onCornerCellHover" | "onCornerCellClick" | "onCornerCellDoubleClick" | "onCornerCellContextMenu" | "onCornerCellMouseDown" | "onCornerCellMouseUp" | "onCornerCellMouseMove" | "onMergedCellsHover" | "onMergedCellsClick" | "onMergedCellsDoubleClick" | "onMergedCellsContextMenu" | "onMergedCellsMouseDown" | "onMergedCellsMouseUp" | "onMergedCellsMouseMove" | "onRangeSort" | "onRangeSorted" | "onRangeFilter" | "onRangeFiltered" | "onLayoutAfterHeaderLayout" | "onLayoutPagination" | "onLayoutCellMounted" | "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" | "onLayoutAfterRealDataCellRender" | "onRowCellBrushSelection" | "onColCellBrushSelection">, {
 s2Ref: ShallowRef<SheetExpose>;
 }, unknown, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
-spreadsheet: (container: S2MountContainer_2, dataCfg: S2DataConfig_2, options: S2Options_2<TooltipContentType_2, Pagination_2, string | Element, string>) => SpreadSheet_2;
+spreadsheet: (container: S2MountContainer_2, dataCfg: S2DataConfig_2, options: S2Options_2<TooltipContentType_2, Pagination_2, BaseTooltipOperatorMenuOptions_2>) => SpreadSheet_2;
 sheetUpdate: SheetUpdateCallback;
 rowCellHover: (data: TargetCellInfo_2) => void;
 rowCellClick: (data: TargetCellInfo_2) => void;
@@ -4690,7 +5488,7 @@ rowCellMouseUp: (data: TargetCellInfo_2) => void;
 rowCellMouseMove: (data: TargetCellInfo_2) => void;
 rowCellCollapsed: (params: RowCellCollapsedParams_2) => void;
 rowCellAllCollapsed: (isCollapsed: boolean) => void;
-rowCellScroll: (position: CellScrollPosition_2) => void;
+rowCellScroll: (position: Required<ScrollOffset_2>) => void;
 colCellHover: (data: TargetCellInfo_2) => void;
 colCellClick: (data: TargetCellInfo_2) => void;
 colCellDoubleClick: (data: TargetCellInfo_2) => void;
@@ -4711,7 +5509,7 @@ dataCellMouseDown: (data: TargetCellInfo_2) => void;
 dataCellMouseUp: (data: TargetCellInfo_2) => void;
 dataCellMouseMove: (data: TargetCellInfo_2) => void;
 dataCellBrushSelection: (brushRangeDataCells: DataCell_2[]) => void;
-dataCellSelectMove: (metas: ViewMetaData_2[]) => void;
+dataCellSelectMove: (metaList: ViewMetaData_2[]) => void;
 cornerCellHover: (data: TargetCellInfo_2) => void;
 cornerCellClick: (data: TargetCellInfo_2) => void;
 cornerCellDoubleClick: (data: TargetCellInfo_2) => void;
@@ -4735,7 +5533,7 @@ filteredValues: string[];
 rangeFiltered: (data: ViewMetaData_2[]) => void;
 layoutAfterHeaderLayout: (layoutResult: LayoutResult_2) => void;
 layoutPagination: (data: LayoutPaginationParams) => void;
-layoutCellMounted: (cell: S2CellType_2<ViewMeta_2>) => void;
+layoutCellMounted: (cell: S2CellType_2) => void;
 beforeRender: () => void;
 afterRender: () => void;
 mounted: (spreadsheet: SpreadSheet_2) => void;
@@ -4773,13 +5571,13 @@ mouseHover: (event: FederatedPointerEvent) => void;
 mouseUp: (event: MouseEvent) => void;
 mouseDown: (event: MouseEvent) => void;
 mouseMove: (event: MouseEvent) => void;
-selected: (cells: S2CellType_2<ViewMeta_2>[]) => void;
+selected: (cells: S2CellType_2[]) => void;
 reset: (event: KeyboardEvent) => void;
 linkFieldJump: (data: {
 field: string;
 record: RawData_2;
 }) => void;
-scroll: (position: CellScrollPosition_2) => void;
+scroll: (position: Required<ScrollOffset_2>) => void;
 layoutAfterRealDataCellRender: (options: {
 add: [number, number][];
 remove: [number, number][];
@@ -4798,7 +5596,7 @@ onRowCellMouseUp?: (data: TargetCellInfo_2) => any;
 onRowCellMouseMove?: (data: TargetCellInfo_2) => any;
 onRowCellCollapsed?: (params: RowCellCollapsedParams_2) => any;
 onRowCellAllCollapsed?: (isCollapsed: boolean) => any;
-onRowCellScroll?: (position: CellScrollPosition_2) => any;
+onRowCellScroll?: (position: Required<ScrollOffset_2>) => any;
 onColCellHover?: (data: TargetCellInfo_2) => any;
 onColCellClick?: (data: TargetCellInfo_2) => any;
 onColCellDoubleClick?: (data: TargetCellInfo_2) => any;
@@ -4819,7 +5617,7 @@ onDataCellMouseDown?: (data: TargetCellInfo_2) => any;
 onDataCellMouseUp?: (data: TargetCellInfo_2) => any;
 onDataCellMouseMove?: (data: TargetCellInfo_2) => any;
 onDataCellBrushSelection?: (brushRangeDataCells: DataCell_2[]) => any;
-onDataCellSelectMove?: (metas: ViewMetaData_2[]) => any;
+onDataCellSelectMove?: (metaList: ViewMetaData_2[]) => any;
 onCornerCellHover?: (data: TargetCellInfo_2) => any;
 onCornerCellClick?: (data: TargetCellInfo_2) => any;
 onCornerCellDoubleClick?: (data: TargetCellInfo_2) => any;
@@ -4843,7 +5641,7 @@ filteredValues: string[];
 onRangeFiltered?: (data: ViewMetaData_2[]) => any;
 onLayoutAfterHeaderLayout?: (layoutResult: LayoutResult_2) => any;
 onLayoutPagination?: (data: LayoutPaginationParams) => any;
-onLayoutCellMounted?: (cell: S2CellType_2<ViewMeta_2>) => any;
+onLayoutCellMounted?: (cell: S2CellType_2) => any;
 onBeforeRender?: () => any;
 onAfterRender?: () => any;
 onMounted?: (spreadsheet: SpreadSheet_2) => any;
@@ -4881,13 +5679,13 @@ onMouseHover?: (event: FederatedPointerEvent) => any;
 onMouseUp?: (event: MouseEvent) => any;
 onMouseDown?: (event: MouseEvent) => any;
 onMouseMove?: (event: MouseEvent) => any;
-onSelected?: (cells: S2CellType_2<ViewMeta_2>[]) => any;
+onSelected?: (cells: S2CellType_2[]) => any;
 onReset?: (event: KeyboardEvent) => any;
 onLinkFieldJump?: (data: {
 field: string;
 record: RawData_2;
 }) => any;
-onScroll?: (position: CellScrollPosition_2) => any;
+onScroll?: (position: Required<ScrollOffset_2>) => any;
 onLayoutAfterRealDataCellRender?: (options: {
 add: [number, number][];
 remove: [number, number][];
@@ -4895,8 +5693,8 @@ spreadsheet: SpreadSheet_2;
 }) => any;
 onRowCellBrushSelection?: (event: FederatedPointerEvent) => any;
 onColCellBrushSelection?: (event: FederatedPointerEvent) => any;
-onSpreadsheet?: (container: S2MountContainer_2, dataCfg: S2DataConfig_2, options: S2Options_2<TooltipContentType_2, Pagination_2, string | Element, string>) => any;
-}, {}>;
+onSpreadsheet?: (container: S2MountContainer_2, dataCfg: S2DataConfig_2, options: S2Options_2<TooltipContentType_2, Pagination_2, BaseTooltipOperatorMenuOptions_2>) => any;
+}, {}, {}>;
 
 declare interface TargetCellInfo_2 {
     target: S2CellType_2;
@@ -4913,40 +5711,47 @@ declare interface TextAlignStyle {
 
 declare type TextBaseline = 'top' | 'middle' | 'bottom';
 
-declare interface TextTheme extends TextAlignStyle {
-    fontFamily?: string;
+declare interface TextCondition extends Condition<TextTheme> {
+    position?: IconPosition;
+}
+
+declare interface TextTheme extends TextAlignStyle, Pick<TextStyleProps, 'fontFamily' | 'fontSize' | 'fontWeight' | 'fill' | 'opacity' | 'wordWrap' | 'maxLines' | 'lineHeight' | 'textOverflow' | 'fontStyle' | 'fontVariant'> {
+    /** 字体大小 */
     fontSize?: number;
-    fontWeight?: number | 'normal' | 'bold' | 'bolder' | 'lighter';
+    /** 字体颜色 */
     fill?: string;
+    /** 链接文本颜色 */
     linkTextFill?: string;
-    opacity?: number;
 }
 
 declare interface ThemeCfg_2 {
+    /** 主题 */
     theme?: S2Theme;
+    /** 色板 */
     palette?: Pick<Palette, 'basicColors' | 'semanticColors' | 'others'>;
+    /** 主题名 */
     name?: ThemeName;
 }
 
-declare type ThemeName = 'default' | 'colorful' | 'gray';
+declare type ThemeName = keyof typeof PALETTE_MAP;
 
-declare interface Tooltip<T = TooltipContentType_2, Icon = Element | string, Text = string> extends BaseTooltipConfig<T, Icon, Text> {
+declare interface Tooltip<T = TooltipContentType_2, Menu = BaseTooltipOperatorMenuOptions_2> extends BaseTooltipConfig<T, Menu> {
     /**
      * Tooltip 行头单元格配置
      */
-    rowCell?: BaseTooltipConfig<T, Icon, Text>;
+    rowCell?: BaseTooltipConfig<T, Menu>;
     /**
      * Tooltip 列头单元格配置
      */
-    colCell?: BaseTooltipConfig<T, Icon, Text>;
+    colCell?: BaseTooltipConfig<T, Menu>;
     /**
      * Tooltip 角头单元格配置
      */
-    cornerCell?: BaseTooltipConfig<T, Icon, Text>;
+    cornerCell?: BaseTooltipConfig<T, Menu>;
     /**
      * Tooltip 数值单元格配置
      */
-    dataCell?: BaseTooltipConfig<T, Icon, Text>;
+    dataCell?: BaseTooltipConfig<T, Menu>;
 }
 
 declare type TooltipAutoAdjustBoundary = 'body' | 'container' | null | undefined;
@@ -4979,14 +5784,14 @@ declare type TooltipHeadInfo = {
     cols: TooltipDetailListItem[];
 };
 
-declare type TooltipInterpretationOptions = {
+declare type TooltipInterpretationOptions<T = TooltipContentType_2, Icon = Element | string, Text = string> = {
     name: string;
-    icon?: Element | string;
-    text?: string;
-    render?: Element | string;
+    icon?: Icon;
+    text?: Text;
+    content?: T;
 };
 
-declare interface TooltipOperation<Icon = Element | string, Text = string> extends TooltipOperatorOptions<Icon, Text> {
+declare interface TooltipOperation<Menu = BaseTooltipOperatorMenuOptions_2> extends TooltipOperatorOptions<Menu> {
     /**
      * 隐藏列 (叶子节点有效)
      */
@@ -5001,35 +5806,99 @@ declare interface TooltipOperation<Icon = Element | string, Text = string> exten
     tableSort?: boolean;
 }
 
-declare type TooltipOperatorClickHandler = (params: {
-    key: SortMethod;
+declare type TooltipOperatorClickHandler = (info: TooltipOperatorMenuInfo, cell: S2CellType_2 | undefined | null) => void;
+
+declare interface TooltipOperatorMenuInfo {
+    key: string;
     [key: string]: unknown;
-}) => void;
+}
 
-declare interface TooltipOperatorMenu<Icon = Element | string, Text = string> {
+declare interface TooltipOperatorMenuItem<Icon, Text> {
+    /** 唯一标识 */
     key: string;
+    /** 自定义 icon */
     icon?: Icon;
-    text?: Text;
-    onClick?: (cell: S2CellType_2) => void;
+    /** 名称 */
+    label?: Text;
+    /** 点击回调 */
+    onClick?: TooltipOperatorClickHandler;
+    /** 是否显示 */
     visible?: boolean | ((cell: S2CellType_2) => boolean);
-    children?: TooltipOperatorMenu<Icon, Text>[];
+    /** 子菜单 */
+    children?: TooltipOperatorMenuItem<Icon, Text>[];
 }
 
-declare interface TooltipOperatorOptions<Icon = Element | string, Text = string> {
+declare interface TooltipOperatorMenuOptions<Icon, Text> {
+    /**
+     * 菜单内容
+     */
+    items?: TooltipOperatorMenuItem<Icon, Text>[];
+    /**
+     * 菜单项点击
+     */
     onClick?: TooltipOperatorClickHandler;
-    menus?: TooltipOperatorMenu<Icon, Text>[];
+    /**
+     * 默认选中的菜单项 key
+     */
     defaultSelectedKeys?: string[];
 }
 
-declare interface TooltipOptions<Icon = Element | string, Text = string> {
+declare interface TooltipOperatorOptions<Menu = BaseTooltipOperatorMenuOptions_2> {
+    /**
+     * 菜单项配置
+     */
+    menu?: Menu;
+}
+
+declare interface TooltipOptions<Menu = BaseTooltipOperatorMenuOptions_2> {
+    /**
+     * 是否隐藏汇总项
+     * @example "数量(总和) 999"
+     */
     hideSummary?: boolean;
-    operator?: TooltipOperatorOptions<Icon, Text>;
-    enterable?: boolean;
+    /**
+     * 顶部操作项
+     */
+    operator?: TooltipOperatorOptions<Menu>;
+    /**
+     * 是否是小计/总计
+     */
     isTotals?: boolean;
-    showSingleTips?: boolean;
-    onlyMenu?: boolean;
+    /**
+     * 只展示当前单元格文本 (不含汇总/行列头信息), 如果存在省略, 显示完整文本
+     * 1. 用于单元格省略后 hover 显示完整文本
+     * 2. 明细表 hover/click 显示当前单元格文本
+     * 3. 自定义交互 hover/click 场景
+     * @example
+     s2.showTooltip({
+     ...
+     options: { onlyShowCellText: true }
+     })
+     */
+    onlyShowCellText?: boolean;
+    /**
+     * 只展示顶部操作项菜单 (不含汇总/行列头/单元格信息)
+     * 1. 用于排序场景
+     * 2. 自定义交互
+     * @example
+     s2.showTooltip({
+     ...
+     options: { onlyShowOperator: true }
+     })
+     */
+    onlyShowOperator?: boolean;
+    /**
+     * 是否格式化数据
+     */
     enableFormat?: boolean;
+    /**
+     * 是否强制清空 dom
+     */
     forceRender?: boolean;
+    /**
+     * 自定义数据
+     */
+    data?: TooltipData;
 }
 
 declare type TooltipPosition = Point;
@@ -5039,13 +5908,14 @@ declare interface TooltipPositionInfo {
     event: FederatedPointerEvent | MouseEvent;
 }
 
-declare type TooltipShowOptions<T = TooltipContentType_2, Icon = Element | string, Text = string> = {
+declare type TooltipShowOptions<T = TooltipContentType_2, Menu = BaseTooltipOperatorMenuOptions_2> = {
     position: TooltipPosition;
     data?: TooltipData;
     cellInfos?: TooltipDataItem[];
-    options?: TooltipOptions<Icon, Text>;
-    content?: ((cell: S2CellType_2, defaultTooltipShowOptions: TooltipShowOptions<T, Icon, Text>) => T) | T;
+    options?: TooltipOptions<Menu>;
+    content?: ((cell: S2CellType_2, defaultTooltipShowOptions: TooltipShowOptions<T, Menu>) => T) | T;
     event?: FederatedPointerEvent | MouseEvent;
+    onMounted?: () => void;
 };
 
 declare interface TooltipSummaryOptions {
@@ -5058,33 +5928,53 @@ declare interface TooltipSummaryOptions {
 declare type TooltipSummaryOptionsValue = number | string | undefined | null;
 
 declare interface Total {
-    /** 是否显示总计 */
-    showGrandTotals: boolean;
-    /** 是否显示小计 */
-    showSubTotals: boolean | {
+    /**
+     * 是否显示总计
+     */
+    showGrandTotals?: boolean;
+    /**
+     *是否显示小计
+     */
+    showSubTotals?: boolean | {
         /** 当子维度个数 <=1 时，仍然展示小计：默认 true */
         always: boolean;
     };
-    calcTotals?: CalcTotals;
+    /**
+     * 自定义计算总计
+     */
+    calcGrandTotals?: CalcTotals;
+    /**
+     * 自定义计算小计
+     */
     calcSubTotals?: CalcTotals;
-    /** 小计的汇总维度 */
-    subTotalsDimensions: string[];
-    /** 总计布局位置，默认是下或右 */
-    reverseLayout: boolean;
-    /** 小计布局位置，默认下或者右 */
-    reverseSubLayout: boolean;
-    label?: string;
-    subLabel?: string;
+    /**
+     * 小计的汇总维度
+     * @example subTotalsDimensions: ['province']
+     */
+    subTotalsDimensions?: string[];
+    /**
+     * 总计布局位置，默认是下或右
+     */
+    reverseGrandTotalsLayout?: boolean;
+    /**
+     * 小计布局位置，默认是下或右
+     */
+    reverseSubTotalsLayout?: boolean;
+    /**
+     * 总计展示名
+     * @default "总计"
+     */
+    grandTotalsLabel?: string;
+    /**
+     * 小计展示名
+     * @default "小计"
+     */
+    subTotalsLabel?: string;
 }
 
-/**
- * tableau的英文是这个，这里有个绕的概念
- * 如，某行维度需要展示小计，实际上是将对应的一列数据进行聚合，所以文案上显示的应该是“展示列小计”
- * 但是内部配置我倾向于仍然按照字段所属维度区，即配置的row，代表的是行维度而不是行小计
- */
 declare interface Totals {
-    row?: Partial<Total>;
-    col?: Partial<Total>;
+    row?: Total;
+    col?: Total;
 }
 
 declare type TotalSelection = {
@@ -5098,6 +5988,11 @@ declare type TotalSelectionsOfMultiData = {
     column?: TotalSelection;
 };
 
+declare interface Transformer_2 {
+    [CopyMIMEType.PLAIN]: MatrixPlainTransformer;
+    [CopyMIMEType.HTML]: MatrixHTMLTransformer;
+}
+
 export declare const useExpose: (expose: (exposed?: Record<string, any>) => void) => ShallowRef<SheetExpose>;
 
 declare const VALUE_FIELD = "$$value$$";
@@ -5119,7 +6014,7 @@ declare interface ViewCellHeights {
     };
 }
 
-declare interface ViewMeta_2 {
+declare interface ViewMeta {
     spreadsheet: SpreadSheet_2;
     id: string;
     x: number;
@@ -5147,7 +6042,7 @@ declare interface ViewMeta_2 {
 
 declare type ViewMetaData_2 = Data | CellData;
 
-declare type ViewMetaIndexType = keyof Pick<ViewMeta_2, 'colIndex' | 'rowIndex'>;
+declare type ViewMetaIndexType = keyof Pick<ViewMeta, 'colIndex' | 'rowIndex'>;
 
 /**
  * 移动端滚动事件