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

package/esm/index.d.ts

@@ -1,7 +1,7 @@
 import { AllowedComponentProps } from 'vue';
 import { BaseTooltip } from '@antv/s2';
 import { Canvas } from '@antv/g';
-import { CellScrollPosition } from '@antv/s2';
+import type { CellScrollPosition } from '@antv/s2';
 import { ComponentCustomProps } from 'vue';
 import { ComponentOptionsMixin } from 'vue';
 import { ComputedRef } from 'vue';
@@ -18,6 +18,7 @@ import { GEvent } from '@antv/s2';
 import { Group } from '@antv/g';
 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';
@@ -41,6 +42,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';
@@ -54,6 +56,8 @@ import { ViewMeta } from '@antv/s2';
 import { ViewMetaData } from '@antv/s2';
 import { VNodeProps } from 'vue';
 
+declare type ActionIconName = string | FullyIconName;
+
 declare type Adaptive = boolean | {
     width?: boolean;
     height?: boolean;
@@ -82,6 +86,7 @@ declare interface Background {
     color?: string;
 }
 
+/** 柱状图样式配置 */
 declare interface BarTheme {
     intervalPadding?: number;
     fill?: string;
@@ -111,7 +116,7 @@ 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[];
@@ -122,21 +127,12 @@ declare abstract class BaseCell<T extends SimpleBBox> extends Group {
     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;
-        };
-    };
+    getIconStyle(): DeepRequired<IconTheme>;
     getActualText(): string;
     getFieldValue(): string;
     /**
@@ -147,7 +143,7 @@ declare abstract class BaseCell<T extends SimpleBBox> extends Group {
     /**
      * Return the type of the cell
      */
-    abstract get cellType(): CellTypes;
+    abstract get cellType(): CellType;
     /**
      * Determine how to render this cell area
      */
@@ -161,13 +157,14 @@ 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;
     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<ViewMeta_2>) => boolean) | undefined;
     getBBoxByType(type?: CellClipBox): SimpleBBox;
     drawBorders(): void;
     /**
@@ -177,18 +174,17 @@ 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;
     protected drawLinkFieldShape(showLinkFieldShape: boolean, linkFillColor: string): void;
+    protected getLinkFieldStyle(): string;
+    protected drawLinkField(meta: Node_2_2 | ViewMeta_2): void;
     updateByState(stateName: InteractionStateName, cell: S2CellType_2): void;
     protected getInteractiveBorderShapeStyle<T>(borderSize: T & number): {
         x: number;
@@ -207,7 +203,38 @@ declare abstract class BaseCell<T extends SimpleBBox> extends Group {
     resetTextAndConditionIconShapes(): void;
     get cellConditions(): Conditions;
     drawConditionIconShapes(): void;
-    getTextConditionFill(textStyle: TextTheme): string | undefined;
+    getTextConditionMappingResult(): ConditionMappingResult<unknown> | 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;
+        fontFamily?: string | undefined;
+        fontSize?: number | undefined;
+        fontWeight?: number | "bold" | "normal" | "bolder" | "lighter" | undefined;
+        linkTextFill?: string | undefined;
+        opacity?: number | undefined;
+        textAlign?: TextAlign | undefined;
+        textBaseline?: TextBaseline | undefined;
+    };
+    /**
+     * 获取默认字体颜色：根据字段标记背景颜色，设置字体颜色
+     * @param textStyle
+     * @private
+     */
+    protected getDefaultTextFill(textFill: string): string;
+    getBackgroundConditionFill(): {
+        backgroundColor: string | undefined;
+        intelligentReverseTextColor: boolean;
+    } | {
+        intelligentReverseTextColor: boolean;
+        backgroundColor?: undefined;
+    };
+    getIconConditionResult(): FullyIconName | undefined;
+    protected getActionAndConditionIconWidth(position?: IconPosition): number;
 }
 
 declare interface BaseCellStyle {
@@ -309,6 +336,7 @@ declare abstract class BaseDataSet_2 {
      */
     getFieldDescription(field: CustomHeaderField): string | undefined;
     setDataCfg(dataCfg: S2DataConfig_2): void;
+    processMeta(meta: Meta[] | undefined, defaultExtraFieldText: string): Meta[];
     getDisplayDataSet(): RawData_2[];
     getValueRangeByField(field: string): ValueRange;
     /** ******************NEED IMPLEMENT BY USER CASE************************ */
@@ -393,7 +421,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 +440,14 @@ 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_2 | null;
     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;
@@ -453,8 +487,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 +518,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 +550,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;
@@ -586,7 +611,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 +633,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_2>[];
+    /**
+     * 根据单元格 id 获取指定单元格 (不含可视区域)
+     * @example facet.getCellById('root[&]浙江省[&]宁波市')
+     */
+    getCellById(cellId: string): S2CellType_2<ViewMeta_2> | undefined;
+    /**
+     * 根据单元格 field 获取指定单元格 (不含可视区域)
+     * @example facet.getCellByField('city')
+     */
+    getCellsByField(cellField: string): S2CellType_2<ViewMeta_2>[];
+    /**
+     * 获取所有单元格 (角头,行头,列头,数值) (不含可视区域)
+     * @example 获取全部: facet.getCells()
+     * @example 获取一组 facet.getCells(['root[&]浙江省[&]宁波市', 'root[&]浙江省[&]杭州市'])
+     */
+    getCells(cellIds?: string[]): S2CellType_2<ViewMeta_2>[];
+    getInitColLeafNodes(): Node_2_2[];
+    clearInitColLeafNodes(): void;
 }
 
 declare interface BaseFields {
+    /** 行头字段 */
     rows?: CustomHeaderFields;
+    /** 列头字段 */
     columns?: CustomHeaderFields;
+    /** 数值字段 */
     values?: string[];
+    /** 数值是否置于列头 (透视表有效) */
     valueInCols?: boolean;
 }
 
@@ -641,10 +847,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;
+    onRowScrollX(rowHeaderScrollX: number, type: string): void;
     protected abstract layout(): void;
     protected abstract offset(): void;
     protected abstract clip(): void;
@@ -770,7 +976,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;
@@ -859,7 +1065,7 @@ linkFieldJump: (data: {
 field: string;
 record: RawData;
 }) => void;
-scroll: (position: CellScrollPosition) => void;
+scroll: (position: Required<ScrollOffset>) => void;
 layoutAfterRealDataCellRender: (options: {
 add: [number, number][];
 remove: [number, number][];
@@ -905,7 +1111,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;
@@ -994,7 +1200,7 @@ onLinkFieldJump?: (data: {
 field: string;
 record: RawData;
 }) => any;
-onScroll?: (position: CellScrollPosition) => any;
+onScroll?: (position: Required<ScrollOffset>) => any;
 onLayoutAfterRealDataCellRender?: (options: {
 add: [number, number][];
 remove: [number, number][];
@@ -1152,7 +1358,7 @@ declare class BaseTooltip_2 {
     options: TooltipShowOptions;
     position: TooltipPosition;
     constructor(spreadsheet: SpreadSheet_2);
-    show<T = Element | string>(showOptions: TooltipShowOptions<T>): void;
+    show<T = Element | string>(options: TooltipShowOptions<T>): void;
     hide(): void;
     destroy(): void;
     renderContent<T = TooltipContentType_2>(content: T): void;
@@ -1163,14 +1369,47 @@ declare class BaseTooltip_2 {
 }
 
 declare interface BaseTooltipConfig<T = TooltipContentType_2, Icon = Element | string, Text = string> {
-    showTooltip?: boolean;
+    /**
+     * 是否开启 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'];
+    /**
+     * 自定义操作项
+     * @see https://s2.antv.antgroup.com/manual/basic/tooltip#%E8%87%AA%E5%AE%9A%E4%B9%89
+     */
     operation?: TooltipOperation<Icon, Text>;
+    /**
+     * 显示边界, 当 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;
+    /**
+     * 自定义坐标
+     */
     adjustPosition?: (positionInfo: TooltipPositionInfo) => TooltipPosition;
+    /**
+     * 自定义挂载容器, 默认 body
+     */
     getContainer?: () => HTMLElement;
+    /**
+     * 容器类名
+     */
     className?: string | string[];
+    /**
+     * 容器样式
+     */
     style?: CSS_2.Properties;
 }
 
@@ -1186,24 +1425,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,7 +1470,9 @@ declare interface BulletValue {
 }
 
 declare interface CalcTotals {
+    /** 聚合方式 */
     aggregation?: Aggregation;
+    /** 自定义计算 */
     calcFunc?: (query: Query, arr: CellData[]) => number;
 }
 
@@ -1287,13 +1535,13 @@ declare interface CellDataParams {
     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 +1554,55 @@ 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;
+    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;
     /**
@@ -1429,13 +1681,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[];
@@ -1470,7 +1740,7 @@ declare class CornerCell extends HeaderCell {
     cornerType: CornerNodeType;
     protected headerConfig: CornerHeaderConfig;
     protected isBolderText(): boolean;
-    get cellType(): CellTypes;
+    get cellType(): CellType;
     protected getBorderPositions(): CellBorderPosition[];
     update(): void;
     protected initCell(): void;
@@ -1483,7 +1753,6 @@ 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;
@@ -1554,7 +1823,13 @@ declare interface CustomInteraction {
 }
 
 declare interface CustomSVGIcon {
+    /** icon 名称 */
     name: string;
+    /**
+     * 1、base 64
+     * 2、svg本地文件（兼容老方式，可以改颜色）
+     * 3、线上支持的图片地址
+     */
     svg: string;
 }
 
@@ -1611,7 +1886,8 @@ declare type Data = (RawData_2 & ExtraData) | undefined | null;
  * 3、left rect area is interval(in left) and text(in right)
  */
 declare class DataCell_2 extends BaseCell<ViewMeta_2> {
-    get cellType(): CellTypes;
+    iconPosition: PointLike;
+    get cellType(): CellType;
     protected getBorderPositions(): CellBorderPosition[];
     get valueRangeByField(): ValueRange;
     protected handleByStateName(cells: CellMeta[], stateName: InteractionStateName): void;
@@ -1620,27 +1896,19 @@ declare class DataCell_2 extends BaseCell<ViewMeta_2> {
     protected handleHover(cells: CellMeta[]): void;
     update(): void;
     setMeta(viewMeta: ViewMeta_2): void;
+    protected drawTextShape(): 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,7 +1925,7 @@ 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;
@@ -1666,14 +1934,30 @@ declare class DataCell_2 extends BaseCell<ViewMeta_2> {
 declare type DataCellCallback = (viewMeta: ViewMeta_2) => 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 +1966,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 +2084,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 +2119,7 @@ declare class EventController {
     private onKeyboardCopy;
     private onKeyboardEsc;
     private resetSheetStyle;
+    private isMouseEvent;
     private isMouseOnTheCanvasContainer;
     private getContainerRect;
     private isMouseOnTheTooltip;
@@ -1877,6 +2174,9 @@ declare type ExtraData = {
 };
 
 declare interface Fields extends BaseFields {
+    /**
+     * 自定义指标维度在行列头中的层级顺序 （即 `values` 的 顺序，从 `0` 开始
+     */
     customValueOrder?: number;
 }
 
@@ -1932,7 +2232,12 @@ declare interface FrameConfig {
 declare class FrozenGroup extends GridGroup {
 }
 
-declare type GetCellMeta = (rowIndex: number, colIndex: number) => ViewMeta_2 | null;
+declare type FullyIconName = {
+    name: string;
+    position: IconPosition;
+    fill?: string;
+    isConditionIcon?: boolean;
+};
 
 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 +2248,9 @@ declare type GetOptionalKeys<T> = keyof {
 };
 
 declare interface GridAnalysisCellTheme {
+    /** 次级文本，如副指标 */
     minorText?: TextTheme;
+    /** 衍生指标 */
     derivedMeasureText?: {
         mainUp: string;
         mainDown: string;
@@ -1971,6 +2278,10 @@ declare interface GridInfo {
     rows: number[];
 }
 
+declare type GroupedIcons = {
+    [key in IconPosition]: FullyIconName[];
+};
+
 /**
  * 使用 iconfont 上的 svg 来创建 Icon
  */
@@ -1979,7 +2290,7 @@ declare class GuiIcon extends Group {
     iconImageShape: CustomImage;
     private cfg;
     constructor(cfg: GuiIconCfg);
-    private getImage;
+    getImage(name: string, cacheKey: string, fill?: string): Promise<HTMLImageElement>;
     /**
      * 1. https://xxx.svg
      * 2. http://xxx.svg
@@ -1987,6 +2298,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'> {
@@ -2017,11 +2332,19 @@ declare class HdAdapter {
 }
 
 declare interface HeaderActionIcon {
-    iconNames: string[];
-    belongsCell: Omit<CellTypes, 'dataCell'>;
+    /**
+     * 已注册的 icon 类型或自定义的 icon 类型名
+     * 如果是 string[], 则默认 icon 位置为右侧
+     */
+    icons: ActionIconName[];
+    belongsCell: Omit<CellType, 'dataCell'>;
+    /** 是否默认隐藏， true 为 hover后显示, false 为一直显示 */
     defaultHide?: boolean | ((meta: Node_2_2, iconName: string) => boolean);
+    /** 是否展示当前 iconNames 配置的 icon */
     displayCondition?: (mete: Node_2_2, iconName: string) => boolean;
+    /** 点击回调函数 */
     onClick?: (headerIconClickParams: HeaderIconClickParams) => void;
+    /** 悬停回调函数 */
     onHover?: (headerIconHoverParams: HeaderIconHoverParams) => void;
 }
 
@@ -2031,30 +2354,37 @@ declare interface HeaderActionIconOptions {
     y: number;
     onClick?: (headerIconClickParams: HeaderIconClickParams) => void;
     onHover?: (headerIconHoverParams: HeaderIconHoverParams) => void;
+    isSortIcon?: boolean;
     defaultHide?: boolean;
 }
 
 declare abstract class HeaderCell extends BaseCell<Node_2_2> {
     protected headerConfig: BaseHeaderConfig;
+    protected actionIconConfig: InternalFullyHeaderActionIcon | undefined;
     protected treeIcon: GuiIcon | undefined;
     protected treeLeafNodeAlignDot: DisplayObject | undefined;
     protected actionIcons: GuiIcon[];
     protected hasDefaultHiddenIcon: boolean;
+    protected conditionIconMappingResult: FullyIconName | undefined;
+    /** left icon 绘制起始坐标 */
+    protected leftIconPosition: PointLike;
+    /** left icon 绘制起始坐标 */
+    protected rightIconPosition: PointLike;
     protected abstract isBolderText(): boolean;
     protected handleRestOptions(...[headerConfig]: [BaseHeaderConfig]): 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(): {
+        width: number;
+        height: number;
+        fill: string;
+    };
     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,15 +2392,19 @@ 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;
 }
@@ -2086,7 +2420,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 +2458,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 +2470,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 {
+    /**
+     * 链接跳转
+     * @see https://s2.antv.antgroup.com/manual/advanced/interaction/link-jump
+     */
     linkFields?: string[] | ((meta: Node_2_2 | ViewMeta_2) => 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 +2600,29 @@ declare type InteractionState = {
 };
 
 declare interface InteractionStateInfo {
+    /**
+     * 交互状态名
+     */
     stateName?: InteractionStateName;
+    /**
+     * 单元格元数据 (包含不在可视范围内的)
+     */
     cells?: CellMeta[];
+    /**
+     * 交互状态发生改变的单元格实例
+     */
     interactedCells?: S2CellType_2[];
+    /**
+     * 选中的单元格节点
+     */
     nodes?: Node_2_2[];
+    /**
+     * 如果单元格为空, 是否强制更新 (适用于反选等场景)
+     */
     force?: boolean;
-    /** 交互行为改变后，会被更新和重绘的单元格回调 */
+    /**
+     * 交互行为改变后，会被更新和重绘的单元格回调
+     */
     onUpdateCells?: OnUpdateCells;
 }
 
@@ -2207,12 +2638,19 @@ declare enum InteractionStateName {
 }
 
 declare interface InteractionStateTheme {
+    /** 背景透明度 */
     backgroundOpacity?: number;
+    /** 背景填充色 */
     backgroundColor?: string;
+    /** 文本透明度 */
     textOpacity?: number;
+    /** 边线颜色 */
     borderColor?: string;
+    /** 边线宽度 */
     borderWidth?: number;
+    /** 边线透明度 */
     borderOpacity?: number;
+    /** 透明度 */
     opacity?: number;
 }
 
@@ -2221,13 +2659,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 {
+    icons: FullyIconName[];
+    isSortIcon?: boolean;
+}
+
+declare type InternalFullyTheme = DeepRequired<S2Theme>;
+
+/** 条件格式柱图样式配置 */
 declare interface IntervalTheme {
     height: number;
     fill: string;
@@ -2243,14 +2691,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_2) => ViewMeta_2 | 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 +2720,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 +2767,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,25 +2783,11 @@ 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
@@ -2335,7 +2796,7 @@ declare class MergedCell extends DataCell_2 {
     cells: S2CellType_2[];
     constructor(spreadsheet: SpreadSheet_2, cells: S2CellType_2[], meta?: ViewMeta_2);
     handleRestOptions(...[cells]: [S2CellType_2[]]): void;
-    get cellType(): CellTypes;
+    get cellType(): CellType;
     update(): void;
     protected initCell(): void;
     /**
@@ -2348,9 +2809,8 @@ declare class MergedCell extends DataCell_2 {
     drawTextShape(): void;
 }
 
-/**
- * the index of rows or columns.
- */
+declare type MergedCellCallback = (spreadsheet: SpreadSheet_2, cells: S2CellType_2[], meta?: ViewMeta_2) => MergedCell;
+
 declare interface MergedCellInfo {
     colIndex?: number;
     rowIndex?: number;
@@ -2370,11 +2830,17 @@ declare interface Meta {
      * 字段描述
      */
     description?: string;
+    /**
+     * 格式化
+     * 数值字段：一般用于格式化数字单位
+     * 文本字段：一般用于做字段枚举值的别名
+     */
     formatter?: Formatter;
 }
 
 declare type MiniChartData = BaseChartData | BulletValue;
 
+/** 迷你图样式 */
 declare interface MiniChartTheme {
     line?: LineTheme;
     bar?: BarTheme;
@@ -2392,19 +2858,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;
 }
@@ -2507,6 +2978,10 @@ declare class Node_2_2 {
 }
 
 declare interface OffsetConfig {
+    rowHeaderOffsetX?: {
+        value: number | undefined;
+        animate?: boolean;
+    };
     offsetX?: {
         value: number | undefined;
         animate?: boolean;
@@ -2527,8 +3002,11 @@ declare interface Padding {
 }
 
 declare interface Pagination_2 {
+    /** 每页数量 */
     pageSize: number;
+    /** 当前页 (从 1 开始) */
     current: number;
+    /** 数据总条数 */
     total?: number;
 }
 
@@ -2536,6 +3014,13 @@ declare interface Palette extends PaletteMeta {
     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 +3032,14 @@ declare interface PaletteMeta {
         basicColorIndex: number;
         standardColorIndex: number;
     }>;
+    /** 语义色值 */
     semanticColors: {
         red: string;
         green: string;
         yellow: string;
         [key: string]: string;
     };
+    /** 补充色值 */
     others?: {
         results: string;
         highlight: string;
@@ -2575,6 +3062,7 @@ 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;
@@ -2643,7 +3131,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;
@@ -2732,7 +3220,7 @@ linkFieldJump: (data: {
 field: string;
 record: RawData;
 }) => void;
-scroll: (position: CellScrollPosition) => void;
+scroll: (position: Required<ScrollOffset>) => void;
 layoutAfterRealDataCellRender: (options: {
 add: [number, number][];
 remove: [number, number][];
@@ -2778,7 +3266,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;
@@ -2867,7 +3355,7 @@ onLinkFieldJump?: (data: {
 field: string;
 record: RawData;
 }) => any;
-onScroll?: (position: CellScrollPosition) => any;
+onScroll?: (position: Required<ScrollOffset>) => any;
 onLayoutAfterRealDataCellRender?: (options: {
 add: [number, number][];
 remove: [number, number][];
@@ -2909,9 +3397,13 @@ declare interface PropOption<T = any> {
 
 declare type Query = Record<string, any>;
 
+/** 子弹图状态颜色 */
 declare interface RangeColors {
+    /** 满意 */
     good: string;
+    /** 良好 */
     satisfactory: string;
+    /** 不符合预期 */
     bad: string;
 }
 
@@ -2923,12 +3415,19 @@ declare interface RequiredPropOption<T = any> {
 }
 
 declare interface ResizeArea {
+    /** 热区尺寸 */
     size?: number;
+    /** 热区背景色 */
     background?: string;
+    /** 参考线颜色 */
     guideLineColor?: string;
+    /** 参考线不可用颜色 */
     guideLineDisableColor?: string;
+    /** 参考线间隔 */
     guideLineDash?: number[];
+    /** 热区背景色透明度 */
     backgroundOpacity?: number;
+    /** 交互态 */
     interactionState?: InteractionState;
 }
 
@@ -2985,7 +3484,9 @@ declare interface ResizeInteractionOptions {
     rowResizeType?: ResizeType;
     /** 列高调整时，影响当前列还是全部列 */
     colResizeType?: ResizeType;
+    /** 是否允许调整, 返回 false 时拖拽的宽高无效 */
     disable?: (resizeInfo: ResizeInfo_2) => boolean;
+    /** 是否显示热区 */
     visible?: (cell: S2CellType_2) => boolean;
 }
 
@@ -3024,17 +3525,11 @@ 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;
@@ -3055,14 +3550,12 @@ 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;
+    get cellType(): CellType;
     protected getBorderPositions(): CellBorderPosition[];
     protected initCell(): void;
     protected showTreeIcon(): boolean;
@@ -3074,12 +3567,10 @@ declare class RowCell extends HeaderCell {
     protected drawTreeLeafNodeAlignDot(): void;
     protected isBolderText(): boolean;
     protected drawTextShape(): void;
-    protected drawLinkFieldShape(): void;
     protected drawResizeAreaInLeaf(): void;
     protected getContentIndent(): number;
     protected getTextIndent(): number;
     protected isTreeLevel(): any;
-    protected getIconPosition(): PointLike;
     protected getMaxTextWidth(): number;
     protected getTextArea(): {
         x: number;
@@ -3147,14 +3638,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;
     /**
      * 交互配置
+     * @see https://s2.antv.antgroup.com/manual/advanced/interaction/basic
      */
     interaction?: InteractionOptions;
     /**
@@ -3175,18 +3669,22 @@ 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[];
     /**
      * 自定义 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;
     /**
@@ -3208,49 +3706,64 @@ declare interface S2BasicOptions<T = TooltipContentType_2, P = Pagination_2, Ico
     /** *********** 自定义单元格 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 +3773,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_2> = DataCell_2 | HeaderCell | ColCell | CornerCell | RowCell | SeriesNumberCell | MergedCell | TableCornerCell | TableSeriesNumberCell | BaseCell<T>;
 
 declare interface S2DataConfig_2 {
     /**
@@ -3392,6 +3909,9 @@ 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 {
+    /**
+     * 行列冻结
+     */
     frozen?: S2PivotSheetFrozenOptions & S2TableSheetFrozenOptions;
 }
 
@@ -3411,10 +3931,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 +4003,15 @@ declare interface S2TableSheetFrozenOptions {
 }
 
 declare interface S2Theme extends CellThemes {
+    /** 列宽行高调整热区 */
     resizeArea?: ResizeArea;
+    /** 滚动条样式 */
     scrollBar?: ScrollBarTheme;
+    /** 分割线样式 */
     splitLine?: SplitLine;
+    /** 刷选遮罩 */
     prepareSelectMask?: InteractionStateTheme;
+    /** 画布背景底色 */
     background?: Background;
 }
 
@@ -3565,21 +4092,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 {
@@ -3597,12 +4131,13 @@ declare interface SelectHeaderCellInfo {
 declare class SeriesNumberCell extends BaseCell<Node_2_2> {
     protected headerConfig: BaseHeaderConfig;
     protected handleRestOptions(...[headerConfig]: [BaseHeaderConfig]): void;
-    get cellType(): CellTypes;
+    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,7 +4145,8 @@ 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> {
@@ -3628,6 +4164,7 @@ declare class SeriesNumberHeader extends BaseHeader<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">, {
@@ -3674,7 +4211,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;
@@ -3763,7 +4300,7 @@ 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][];
@@ -3809,7 +4346,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;
@@ -3898,7 +4435,7 @@ 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][];
@@ -3933,7 +4470,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;
@@ -4022,7 +4559,7 @@ 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 +4578,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;
@@ -4130,7 +4667,7 @@ 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][];
@@ -4152,7 +4689,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;
@@ -4241,7 +4778,7 @@ 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 +4797,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;
@@ -4349,7 +4886,7 @@ 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][];
@@ -4405,29 +4942,40 @@ 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;
+    theme: InternalFullyTheme;
     store: Store;
     dataCfg: S2DataConfig_2;
     options: S2Options_2;
@@ -4442,6 +4990,10 @@ declare abstract class SpreadSheet_2 extends EE {
     hdAdapter: HdAdapter;
     private untypedOn;
     private untypedEmit;
+    /**
+     * 表格是否已销毁
+     */
+    private destroyed;
     on: <K extends keyof EmitterType>(event: K, listener: EmitterType[K]) => this;
     emit: <K extends keyof EmitterType>(event: K, ...args: Parameters<EmitterType[K]>) => boolean;
     constructor(dom: S2MountContainer_2, dataCfg: S2DataConfig_2, options: S2Options_2 | null);
@@ -4487,7 +5039,7 @@ declare abstract class SpreadSheet_2 extends EE {
     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;
+    showTooltipWithInfo(event: FederatedPointerEvent | MouseEvent, cellInfos: TooltipData[], options?: TooltipOptions): void;
     hideTooltip(): void;
     destroyTooltip(): void;
     registerIcons(): void;
@@ -4500,7 +5052,13 @@ 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;
     setThemeCfg(themeCfg?: ThemeCfg_2): void;
     setTheme(theme: S2Theme): void;
@@ -4524,14 +5082,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,7 +5091,7 @@ 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
@@ -4558,8 +5108,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;
     /**
@@ -4608,34 +5156,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;
+    /**
+     * 初始化时的边界滚动配置
+     */
     initOverscrollBehavior: InteractionOptions['overscrollBehavior'];
+    /**
+     * 排序方式
+     */
     sortMethodMap: Record<string, SortMethod> | null;
     [key: string]: unknown;
 }
@@ -4652,7 +5257,7 @@ declare class TableColCell extends ColCell {
     protected getColResizeArea(): Group | 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,15 +5269,14 @@ 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;
 }
 
@@ -4690,7 +5294,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;
@@ -4779,7 +5383,7 @@ 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 +5402,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;
@@ -4887,7 +5491,7 @@ 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][];
@@ -4913,22 +5517,35 @@ declare interface TextAlignStyle {
 
 declare type TextBaseline = 'top' | 'middle' | 'bottom';
 
+declare interface TextCondition extends Condition<TextTheme> {
+    position?: IconPosition;
+}
+
 declare interface TextTheme extends TextAlignStyle {
+    /** 字体 */
     fontFamily?: string;
+    /** 字体大小 */
     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> {
     /**
@@ -5007,11 +5624,17 @@ declare type TooltipOperatorClickHandler = (params: {
 }) => void;
 
 declare interface TooltipOperatorMenu<Icon = Element | string, Text = string> {
+    /** 唯一标识 */
     key: string;
+    /** 自定义 icon */
     icon?: Icon;
+    /** 名称 */
     text?: Text;
+    /** 点击回调 */
     onClick?: (cell: S2CellType_2) => void;
+    /** 是否显示 */
     visible?: boolean | ((cell: S2CellType_2) => boolean);
+    /** 子菜单 */
     children?: TooltipOperatorMenu<Icon, Text>[];
 }
 
@@ -5022,14 +5645,54 @@ declare interface TooltipOperatorOptions<Icon = Element | string, Text = string>
 }
 
 declare interface TooltipOptions<Icon = Element | string, Text = string> {
+    /**
+     * 是否隐藏汇总项
+     * @example "数量(总和) 999"
+     */
     hideSummary?: boolean;
+    /**
+     * 顶部操作项
+     */
     operator?: TooltipOperatorOptions<Icon, Text>;
-    enterable?: boolean;
+    /**
+     * 是否是小计/总计
+     */
     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;
@@ -5098,6 +5761,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$$";