arthub-table 0.0.3

package/dist/types/core/DataGrid.d.ts

@@ -0,0 +1,749 @@
+/// <reference types="node" />
+import Paint from "./Paint";
+import Body from "./Body";
+import Header from "./Header";
+import Footer from "./Footer";
+import Editor from "./Editor";
+import Scroller from "./Scroller";
+import Events from "./Events";
+import Tooltip from "./Tooltip";
+import Clipboard from "./Clipboard";
+import Histories from "./History";
+import { StyleManager, type TableTheme } from "./StyleManager";
+import EdgeScroller from "./EdgeScroller";
+import { type HeaderConfig } from "./util";
+import { type FooterCellClickInfo, type FooterData, type FooterCellData } from "./types";
+import { type PerformanceMonitor } from "./PerformanceMonitor";
+interface Column extends HeaderConfig {
+    children?: Column[];
+    [key: string]: any;
+}
+interface RowData {
+    [key: string]: any;
+}
+interface CellInfo {
+    colIndex: number;
+    rowIndex: number;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    value: any;
+    fixed?: 'left' | 'right' | '';
+    dataType?: string;
+    options?: any[];
+    readonly?: boolean;
+    [key: string]: any;
+}
+interface SelectorState {
+    show: boolean;
+    isSelected: boolean;
+    xArr: [number, number];
+    yArr: [number, number];
+}
+interface AutofillState {
+    enable: boolean;
+    xIndex: number;
+    yIndex: number;
+    xArr: [number, number];
+    yArr: [number, number];
+}
+interface RowDragState {
+    isDragging: boolean;
+    dragStartY: number;
+    draggedRowIndices: number[];
+    dropIndicatorType: 'line' | 'overlay' | null;
+    dropIndicatorY: number;
+    dropTargetRowIndex: number;
+    justFinishedDrag: boolean;
+    hasStartedDragSelection: boolean;
+    isCtrlPressed: boolean;
+    isShiftPressed: boolean;
+    skipNextClick: boolean;
+}
+interface ColDragState {
+    isDragging: boolean;
+    dragStartX: number;
+    draggedColIds: string[];
+    dropIndicatorType: 'line' | null;
+    dropIndicatorX: number;
+    dropTargetColId: string;
+    dropInsertBefore: boolean;
+    justFinishedDrag: boolean;
+    skipNextClick: boolean;
+}
+interface ViewerDragState {
+    isDragging: boolean;
+    cell: any | null;
+    startX: number;
+    startY: number;
+    startValue: any;
+    currentValue: any;
+}
+interface RangeState {
+    minX: number;
+    minY: number;
+    maxY: number;
+    maxX?: number;
+}
+interface ColumnContextMenuInfo {
+    colId: string;
+    colIndex: number;
+    colType?: string;
+    colTitle: string;
+    fixed: string;
+    nestedChildOffset?: number;
+    parentKey?: string;
+    clientX: number;
+    clientY: number;
+}
+export interface DataGridOptions {
+    width?: number | string;
+    height?: number | string;
+    data?: RowData[];
+    columns?: Column[];
+    color?: string;
+    borderColor?: string;
+    fillColor?: string;
+    borderWidth?: number;
+    showCheckbox?: boolean;
+    headerHeight?: number;
+    rowKey?: string;
+    striped?: boolean;
+    stripedOddColor?: string;
+    stripedEvenColor?: string;
+    rowHeight?: number;
+    theme?: string | TableTheme;
+    beforeSelectCell?: (cell: CellInfo) => void;
+    afterSelectCell?: (cell: CellInfo) => void;
+    beforeMultiSelectCell?: (cells: CellInfo[]) => void;
+    afterMultiSelectCell?: (cells: CellInfo[]) => void;
+    beforeEditCell?: (cell: CellInfo) => void;
+    afterEditCell?: (cell: RowData) => void;
+    beforeSelectRow?: (row: RowData) => void;
+    afterSelectRow?: (row: RowData) => void;
+    beforeResizeColumn?: () => void;
+    afterResizeColumn?: () => void;
+    beforeResizeRow?: () => void;
+    afterResizeRow?: () => void;
+    beforeAutofill?: () => void;
+    afterAutofill?: (rows: RowData[]) => void;
+    customAutofill?: (params: {
+        sourceData: {
+            label: string;
+            value: any;
+            dataType: string;
+        }[][];
+        targetRange: {
+            xArr: [number, number];
+            yArr: [number, number];
+        };
+        selectionRange: {
+            xArr: [number, number];
+            yArr: [number, number];
+        };
+        setCell: (rowIndex: number, colIndex: number, value: any) => void;
+        getCellDataType: (colIndex: number) => string;
+    }) => void;
+    beforeCopy?: () => void;
+    afterCopy?: () => void;
+    beforePaste?: () => void;
+    afterPaste?: (rows: RowData[]) => void;
+    afterClear?: (rows: RowData[]) => void;
+    onLoad?: () => void;
+    onRowDragReorder?: (draggedRows: RowData[], targetIndex: number) => void;
+    onRowDragMove?: (draggedRows: RowData[], targetRow: RowData) => void;
+    onGroupToggle?: (groupRow: RowData, expanded: boolean) => void;
+    onTreeExpand?: (rowData: RowData, expanded: boolean) => void;
+    onCellTextClick?: (rowData: RowData, colId: string) => void;
+    onCellTotalNumClick?: (rowData: RowData, colId: string) => void;
+    onColumnDragReorder?: (draggedColIds: string[], targetColId: string, insertBefore: boolean) => void;
+    onColumnContextMenu?: (info: ColumnContextMenuInfo) => void;
+    onModuleOverflowClick?: (modules: any[], rowData: any, rowIndex: number, colIndex: number) => void;
+    onAddRow?: (groupInfo?: any) => void;
+    /** Enable debug mode with detailed performance monitoring and console output */
+    debug?: boolean;
+    /** 是否显示底部统计行 */
+    showFooter?: boolean;
+    /** Footer 单元格点击回调 */
+    onFooterCellClick?: (info: FooterCellClickInfo) => void;
+}
+declare class DataGrid {
+    target: HTMLCanvasElement;
+    scrollY: number;
+    scrollX: number;
+    checkboxWidth: number;
+    horizontalScrollerSize: number;
+    verticalScrollerSize: number;
+    tempValue: any;
+    focusCell: any;
+    enterShift: boolean;
+    hashChange: {
+        [key: string]: boolean;
+    };
+    selector: SelectorState;
+    editor: Editor;
+    autofill: AutofillState;
+    rowDrag: RowDragState;
+    colDrag: ColDragState;
+    selectedColIds: Set<string>;
+    lastSelectedColId: string;
+    viewerDrag: ViewerDragState;
+    painter: Paint;
+    clipboard: Clipboard;
+    header: Header;
+    footer: Footer | null;
+    body: Body;
+    scroller: Scroller;
+    tooltip: Tooltip;
+    events: Events;
+    history: Histories;
+    styleManager: StyleManager;
+    edgeScroller: EdgeScroller;
+    rowIdMap: Map<string, number>;
+    selectedRowIds: Set<string>;
+    lastSelectedRowIndex: number;
+    /** Footer 行高度（showFooter 为 false 时返回 0） */
+    get footerHeight(): number;
+    data: RowData[];
+    color: string;
+    borderColor: string;
+    fillColor: string;
+    borderWidth: number;
+    showCheckbox: boolean;
+    headerHeight: number;
+    rowKey: string;
+    striped: boolean;
+    stripedOddColor: string;
+    stripedEvenColor: string;
+    rowHeight: number;
+    hoverRowIndex: number;
+    hoverColIndex: number;
+    isScrolling: boolean;
+    scrollTimer: NodeJS.Timeout | null;
+    beforeSelectCell: (cell: CellInfo) => void;
+    afterSelectCell: (cell: CellInfo) => void;
+    beforeMultiSelectCell: (cells: CellInfo[]) => void;
+    afterMultiSelectCell: (cells: CellInfo[]) => void;
+    beforeEditCell: (cell: CellInfo) => void;
+    afterEditCell: (cell: RowData) => void;
+    beforeSelectRow: (row: RowData) => void;
+    afterSelectRow: (row: RowData) => void;
+    beforeResizeColumn: () => void;
+    afterResizeColumn: () => void;
+    beforeResizeRow: () => void;
+    afterResizeRow: () => void;
+    beforeAutofill: () => void;
+    afterAutofill: (rows: RowData[]) => void;
+    customAutofill?: (params: {
+        sourceData: {
+            label: string;
+            value: any;
+            dataType: string;
+        }[][];
+        targetRange: {
+            xArr: [number, number];
+            yArr: [number, number];
+        };
+        selectionRange: {
+            xArr: [number, number];
+            yArr: [number, number];
+        };
+        setCell: (rowIndex: number, colIndex: number, value: any) => void;
+        getCellDataType: (colIndex: number) => string;
+    }) => void;
+    beforeCopy: () => void;
+    afterCopy: () => void;
+    beforePaste: () => void;
+    afterPaste: (rows: RowData[]) => void;
+    afterClear: (rows: RowData[]) => void;
+    onLoad: () => void;
+    onRowDragReorder?: (draggedRows: RowData[], targetIndex: number) => void;
+    onRowDragMove?: (draggedRows: RowData[], targetRow: RowData) => void;
+    onGroupToggle?: (groupRow: RowData, expanded: boolean) => void;
+    onTreeExpand?: (rowData: RowData, expanded: boolean) => void;
+    onCellTextClick?: (rowData: RowData, colId: string) => void;
+    onCellTotalNumClick?: (rowData: RowData, colId: string) => void;
+    onColumnDragReorder?: (draggedColIds: string[], targetColId: string, insertBefore: boolean) => void;
+    onColumnContextMenu?: (info: ColumnContextMenuInfo) => void;
+    onModuleOverflowClick?: (modules: any[], rowData: any, rowIndex: number, colIndex: number) => void;
+    onAddRow?: (groupInfo?: any) => void;
+    showFooter: boolean;
+    onFooterCellClick?: (info: FooterCellClickInfo) => void;
+    range: RangeState;
+    columns: HeaderConfig[];
+    headers: HeaderConfig[];
+    columnsLength: number;
+    originFixedWidth: number;
+    containerOriginX: number;
+    containerOriginY: number;
+    width: number;
+    height: number;
+    _configWidth?: number | string;
+    _configHeight?: number | string;
+    private _baseColumnWidths;
+    fixedLeftWidth: number;
+    fixedRightWidth: number;
+    tableWidth: number;
+    tableHeight: number;
+    tableHeaderHeight: number;
+    nestedColumnColors: Map<number, string>;
+    private isDirty;
+    private lastScrollX;
+    private lastScrollY;
+    perfMonitor: PerformanceMonitor;
+    private loadingCells;
+    private loadingRotation;
+    private loadingImage;
+    private loadingAnimationId;
+    colResizeIndicatorX: number;
+    constructor(target: HTMLCanvasElement, options: DataGridOptions);
+    /**
+     * 容器初始化相关
+     */
+    initConfig(options: DataGridOptions): void;
+    /**
+     * 获取容器可视区域宽、高，设置canvas容器样式尺寸、画布尺寸
+     */
+    setLayoutSize(options?: DataGridOptions): void;
+    /**
+     * 获取表格左、右冻结列宽，表格实际的宽、高
+     */
+    getTableSize(): void;
+    initTableSize(): void;
+    /**
+     * 列总宽小于可视区域宽度时，需要补齐
+     */
+    fillTableWidth(): void;
+    resize(): void;
+    /**
+     * Restore all column widths (leaf and nested children) to their saved base values.
+     * Since this.columns and this.headers share nestedColumns references (via shallow copy),
+     * restoring nestedColumns[j].width here also restores header config values.
+     */
+    private restoreBaseColumnWidths;
+    createContainer(): void;
+    /**
+     * 选择、编辑相关---------------------------------------------------->
+     */
+    getCell(x: number, y: number): any;
+    /**
+     * Select a range of rows by index, skipping group and separate rows.
+     * Shared by row-header drag-select and edge-scroll callback.
+     */
+    selectRowRange(startIndex: number, endIndex: number): void;
+    selectCell({ colIndex, rowIndex }: {
+        colIndex: number;
+        rowIndex: number;
+    }): void;
+    resetCellPosition(): void;
+    /**
+     * 将画布单元格中的数据传递到编辑器中
+     */
+    putCell(): void;
+    multiSelectCell(x: number, y: number, mouseX: number, mouseY: number): void;
+    endMultiSelect(): void;
+    clearMultiSelect(): void;
+    clearAllNestedGridsSelection(): void;
+    selectCols(col: any, e?: {
+        ctrlKey?: boolean;
+        metaKey?: boolean;
+        shiftKey?: boolean;
+    }): void;
+    /**
+     * 获取嵌套父列下所有子列的colId
+     */
+    getNestedChildColIds(parentIndex: number): string[];
+    /**
+     * 获取所有选中列的基础index集合（去重）
+     */
+    getSelectedColBaseIndices(): number[];
+    /**
+     * 开始列拖拽排序
+     */
+    startColDrag(colId: string, mouseX: number): void;
+    /**
+     * 更新列拖拽状态
+     */
+    updateColDrag(mouseX: number, mouseY: number): void;
+    /**
+     * 结束列拖拽
+     */
+    endColDrag(): void;
+    /**
+     * 取消列拖拽
+     */
+    cancelColDrag(): void;
+    /**
+     * 清除列选中状态
+     */
+    clearSelectedCols(): void;
+    /**
+     * 判断列是否被选中（通过colId判断，支持嵌套子列）
+     */
+    isColSelected(colId: string): boolean;
+    /**
+     * 判断嵌套父列的所有子列是否都被选中
+     */
+    isNestedParentAllChildrenSelected(parentIndex: number): boolean;
+    selectRows({ rowIndex }: {
+        rowIndex: number;
+    }): void;
+    startAutofill(): void;
+    clearAuaofill(): void;
+    startEdit(): void;
+    doneEdit(): void;
+    /**
+     * 单个写入数据
+     * @param {Number} colIndex 需要写入数据的单元格X轴坐标，表格最左上角为<0,0>
+     * @param {Number} rowIndex 需要写入数据的单元格Y轴坐标
+     * @param {*} value 需要写入的数据: 简单数据类型
+     */
+    setData(value: any, { colIndex, rowIndex }?: {
+        colIndex: number;
+        rowIndex: number;
+    }): void;
+    /**
+     * 批量写入数据
+     * @param {Number} colIndex 需要写入数据的单元格范围起始X轴坐标，表格最左上角为<0,0>
+     * @param {Number} rowIndex 需要写入数据的单元格范围起始Y轴坐标
+     * @param {Array} value 需要写入的数据: 二维数组[<Array><Array>]
+     */
+    batchSetData({ colIndex, rowIndex, value }: {
+        colIndex: number;
+        rowIndex: number;
+        value: any[][];
+    }): void;
+    /**
+     * 将用户通过编辑器输入的值存储为一个临时变量，执行doneEdit()后再去setData()
+     */
+    setTempData(value: any): void;
+    pasteData(arr: any[][]): void;
+    clearSelectedData(): void;
+    focusCellByCoord(minX: number, minY: number, maxX?: number, maxY?: number): void;
+    /**
+     * 调整列宽、行高
+     */
+    resizeColumn(colIndex: number, newWidth: number): void;
+    resizeRow(rowIndex: number, height: number): void;
+    handleCheckRow(y?: number): void;
+    handleCheckHeader(): void;
+    moveFocus(dir: "LEFT" | "TOP" | "RIGHT" | "BOTTOM"): void;
+    /**
+     * @deprecated Use edgeScroller.update() instead. Kept for backward compatibility.
+     */
+    adjustPosition(_x: number, _y: number, mouseX: number, mouseY: number): void;
+    adjustBoundaryPosition(): void;
+    /**
+     * 画布绘制相关------------------------------------------------------->
+     */
+    initPaint(): void;
+    /**
+     * 标记需要重绘
+     * 在数据变化、交互状态变化时调用
+     */
+    markDirty(): void;
+    drawContainer(): void;
+    draw(): void;
+    /**
+     * 绘制嵌套列的彩色垂直边框，贯穿整个 body 区域（包括分组行和分隔行）
+     */
+    drawNestedColumnBorders(): void;
+    /**
+     * 绘制冻结列区域的嵌套列彩色竖边框（在固定列 cells 之后调用，确保不会被穿透）
+     */
+    drawFixedNestedColumnBorders(rowY: number, rowHeight: number): void;
+    /**
+     * 绘制行拖拽指示器
+     */
+    drawColResizeIndicator(): void;
+    drawRowDragIndicator(): void;
+    /**
+     * 绘制列拖拽指示器
+     */
+    drawColDragIndicator(): void;
+    /**
+     * 事件相关------------------------------------------------------->
+     */
+    updateColumns(columns: Column[]): void;
+    loadColumns(columns: Column[]): void;
+    loadData(data: RowData[]): void;
+    getData(): RowData[];
+    getRowData(y: number): RowData;
+    getCheckedRows(): RowData[];
+    setSelectedRows(rowIds: string[]): void;
+    getSelectedRowIds(): string[];
+    getChangedRows(): RowData[];
+    validate(callback?: (valid: boolean) => void): void;
+    validateChanged(callback?: (valid: boolean) => void): void;
+    validateField(ci?: number, ri?: number): void;
+    getValidations(): any[][];
+    setValidations(errors?: any[]): void;
+    clearValidations(): void;
+    updateData(data?: any[]): void;
+    /**
+     * 暂停所有 GIF 动画
+     */
+    pauseGif(): void;
+    /**
+     * 恢复所有 GIF 动画
+     */
+    resumeGif(): void;
+    /**
+     * 切换 GIF 动画播放状态
+     * @returns 当前播放状态（true: 播放中, false: 已暂停）
+     */
+    toggleGif(): boolean;
+    /**
+     * 获取 GIF 动画播放状态
+     * @returns 当前播放状态（true: 播放中, false: 已暂停）
+     */
+    isGifEnabled(): boolean;
+    /**
+     * 设置斑马纹开关
+     * @param enabled 是否启用斑马纹
+     */
+    setStriped(enabled: boolean): void;
+    /**
+     * 获取斑马纹状态
+     * @returns 当前斑马纹状态
+     */
+    getStriped(): boolean;
+    /**
+     * 切换斑马纹状态
+     * @returns 当前斑马纹状态
+     */
+    toggleStriped(): boolean;
+    /**
+     * 设置主题
+     * @param theme 主题名称或主题对象
+     */
+    setTheme(theme: string | TableTheme): void;
+    /**
+     * 获取当前主题
+     * @returns 当前主题对象
+     */
+    getTheme(): TableTheme;
+    /**
+     * 注册自定义样式类
+     * @param className 样式类名
+     * @param style 样式对象
+     */
+    registerStyle(className: string, style: any): void;
+    /**
+     * 批量注册样式类
+     * @param styles 样式对象集合
+     */
+    registerStyles(styles: Record<string, any>): void;
+    /**
+     * 设置行高
+     * @param height 行高值（像素）
+     */
+    setRowHeight(height: number): void;
+    /**
+     * 获取当前行高
+     * @returns 当前行高值
+     */
+    getRowHeight(): number;
+    /**
+     * 设置日期显示类型（绝对时间/相对时间）
+     * @param dateDisplayType 日期显示类型值
+     */
+    setDateDisplayType(dateDisplayType: string): void;
+    /**
+     * 开始行拖拽
+     */
+    startRowDrag(rowIndex: number, mouseY: number): void;
+    /**
+     * 更新行拖拽状态
+     */
+    updateRowDrag(mouseX: number, mouseY: number): void;
+    /**
+     * 结束行拖拽
+     */
+    endRowDrag(): void;
+    /**
+     * 取消行拖拽
+     */
+    cancelRowDrag(): void;
+    /**
+     * 设置hover行索引
+     * @param rowIndex 行索引，-1表示无hover
+     */
+    setHoverRow(rowIndex: number): void;
+    /**
+     * 设置hover单元格索引
+     * @param colIndex 列索引，-1表示无hover
+     * @param rowIndex 行索引，-1表示无hover
+     */
+    setHoverCell(colIndex: number, rowIndex: number): void;
+    /**
+     * 设置滚动状态
+     * @param isScrolling 是否正在滚动
+     */
+    setScrolling(isScrolling: boolean): void;
+    /**
+     * 预加载 loading 图片
+     */
+    private preloadLoadingImage;
+    /**
+     * 显示指定单元格的 loading 状态
+     * @param rowIds 行的唯一标识数组（基于 rowKey 配置对应的行数据字段值）
+     * @param columnKeys 列的 key 字段数组
+     * @param timeout 超时时间（毫秒），默认 60000（1 分钟）
+     */
+    showLoading(rowIds: string[], columnKeys: string[], timeout?: number): void;
+    /**
+     * 手动停止指定单元格的 loading
+     * @param rowIds 行的唯一标识数组
+     * @param columnKeys 列的 key 字段数组
+     */
+    hideLoading(rowIds: string[], columnKeys: string[]): void;
+    /**
+     * 清理所有 loading 状态
+     */
+    clearAllLoading(): void;
+    /**
+     * 内部辅助：移除单个 loading 状态
+     */
+    private removeSingleLoading;
+    /**
+     * 查询指定 cellKey 是否处于 loading 状态
+     */
+    isLoadingCell(cellKey: string): boolean;
+    /**
+     * 获取当前 loading 旋转角度
+     */
+    getLoadingRotation(): number;
+    /**
+     * 获取预加载的 loading 图片
+     */
+    getLoadingImage(): HTMLImageElement | null;
+    /**
+     * 启动 loading 动画循环（轻量级：仅更新角度 + markDirty）
+     */
+    private startLoadingAnimation;
+    /**
+     * 停止 loading 动画循环
+     */
+    private stopLoadingAnimation;
+    /**
+     * Get layout information for a specific cell identified by rowId and columnKey.
+     * Returns a deep copy to prevent accidental mutation of internal state.
+     * @param rowId - Row identifier (number for normal/viewer, string for grouped)
+     * @param columnKey - Column key string
+     * @returns CellLayout object or null if cell not found
+     */
+    testGetCellLayout(rowId: string | number, columnKey: string): {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+        visible: boolean;
+        columnKey: string;
+        rowId: string | number;
+        colIndex: number;
+        rowIndex: number;
+        fixed: string;
+    } | null;
+    /**
+     * Get all cells currently visible in the viewport.
+     * Only returns cells rendered by the virtual scroll engine.
+     * @returns Array of visible cell layout objects
+     */
+    testGetAllVisibleCells(): Array<{
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+        visible: boolean;
+        columnKey: string;
+        rowId: string | number;
+        colIndex: number;
+        rowIndex: number;
+        fixed: string;
+        value: any;
+        label: string;
+    }>;
+    /**
+     * Get configuration for a specific column by its key.
+     * Supports both top-level columns and nested child columns.
+     * @param columnKey - Column key string
+     * @returns Column configuration object or null if not found
+     */
+    testGetColumnConfig(columnKey: string): {
+        key: string;
+        title: string;
+        width: number;
+        fixed: string;
+        visible: boolean;
+        index: number;
+        level: number;
+        type: string;
+        children: any[] | null;
+        colspan: number;
+        rowspan: number;
+        parentKey: string | null;
+    } | null;
+    /**
+     * Get data for a specific row identified by rowId.
+     * @param rowId - Row identifier
+     * @returns Row data object (deep copy) or null if not found
+     */
+    testGetRowData(rowId: string | number): Record<string, any> | null;
+    /**
+     * Get current scroll position and scrollbar state.
+     * @returns ScrollPosition object
+     */
+    testGetScrollPosition(): {
+        scrollX: number;
+        scrollY: number;
+        maxScrollX: number;
+        maxScrollY: number;
+        hasHorizontalScrollbar: boolean;
+        hasVerticalScrollbar: boolean;
+    };
+    /**
+     * Get overall table dimensions and metrics.
+     * @returns TableDimensions object
+     */
+    testGetTableDimensions(): {
+        containerWidth: number;
+        containerHeight: number;
+        tableWidth: number;
+        tableHeight: number;
+        headerHeight: number;
+        rowHeight: number;
+        fixedLeftWidth: number;
+        fixedRightWidth: number;
+        totalRows: number;
+        totalColumns: number;
+    };
+    /**
+     * Test hook: Compare header column widths with body cell widths.
+     * Returns per-column comparison to detect header/body width mismatches,
+     * especially for nested (multi-sub-column) columns.
+     */
+    testGetHeaderBodyWidthComparison(): Array<{
+        colIndex: number;
+        columnKey: string;
+        headerWidth: number;
+        bodyCellWidth: number;
+        isNested: boolean;
+        match: boolean;
+    }>;
+    /**
+     * Find row index by row ID, searching through body data.
+     * Supports both numeric and string row IDs.
+     * @param rowId - Row identifier to search for
+     * @returns Row index or -1 if not found
+     */
+    private findRowIndexById;
+    /** 动态切换 footer 显示状态 */
+    setShowFooter(show: boolean): void;
+    /** 一次性设置所有列的 footer 统计数据 */
+    setFooterData(data: FooterData): void;
+    /** 设置单列的 footer 统计数据 */
+    setFooterCellData(columnKey: string, data: FooterCellData): void;
+}
+export default DataGrid;