arthub-table 0.2.55 → 0.2.56-next.1

package/dist/types/adapters/DataGridIntegration.d.ts

@@ -15,7 +15,7 @@
  * }
  * ```
  */
-import type { ColumnConfig } from '../core/types';
+import type { ColumnConfig, GroupHeaderCellHoverInfo } from '../core/types';
 import type { ITableHeader } from './columnAdapter';
 import { type PreprocessedRow } from './rowDataAdapter';
 import { DataGridEventAdapter } from './DataGridEventAdapter';
@@ -265,6 +265,8 @@ export interface DataGridCallbacks {
     onFooterCellClick?: (info: any) => void;
     /** 组头单元格点击 */
     onGroupHeaderCellClick?: (info: any) => void;
+    /** 组头单元格 hover（当 hoverColIndex 变化时触发，info 为 null 表示离开单元格） */
+    onGroupHeaderCellHover?: (info: GroupHeaderCellHoverInfo | null) => void;
     /** 人员工时图标点击 */
     onUserWorkingHoursClick?: (info: {
         groupId: string;

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

@@ -12,7 +12,7 @@ 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, type GroupHeaderCellClickInfo, type FooterStatRefreshInfo, type GroupHeaderStatRefreshInfo } from "./types";
+import { type FooterCellClickInfo, type FooterData, type FooterCellData, type GroupHeaderCellClickInfo, type GroupHeaderCellHoverInfo, type FooterStatRefreshInfo, type GroupHeaderStatRefreshInfo } from "./types";
 import { type PerformanceMonitor } from "./PerformanceMonitor";
 interface Column extends HeaderConfig {
     children?: Column[];
@@ -489,6 +489,8 @@ export interface DataGridOptions {
     onFooterCellClick?: (info: FooterCellClickInfo) => void;
     /** 组头单元格点击回调 */
     onGroupHeaderCellClick?: (info: GroupHeaderCellClickInfo) => void;
+    /** 组头单元格 hover 回调（当 hoverColIndex 变化时触发，info 为 null 表示离开单元格） */
+    onGroupHeaderCellHover?: (info: GroupHeaderCellHoverInfo | null) => void;
     /** 人员工时图标点击回调 */
     onUserWorkingHoursClick?: (info: {
         groupId: string;
@@ -987,6 +989,7 @@ declare class DataGrid {
     _footerHeight: number;
     onFooterCellClick?: (info: FooterCellClickInfo) => void;
     onGroupHeaderCellClick?: (info: GroupHeaderCellClickInfo) => void;
+    onGroupHeaderCellHover?: (info: GroupHeaderCellHoverInfo | null) => void;
     onUserWorkingHoursClick?: (info: {
         groupId: string;
         clientX: number;

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

@@ -481,6 +481,36 @@ export interface GroupHeaderCellClickInfo {
         height: number;
     };
 }
+/**
+ * 组头单元格 hover 回调信息
+ */
+export interface GroupHeaderCellHoverInfo {
+    /** 列标识（nested 子列时为子列 key，如 workflow_state；普通列时为列 key） */
+    columnKey: string;
+    /** 列 editor 类型 */
+    editor: string;
+    /** 当前 hover 单元格对应的统计类型（如 count_workflow_state/1/2,3），与 onGroupHeaderCellClick 一致 */
+    statisticType?: string;
+    /** 嵌套父列 key（仅 nested 子列有值） */
+    moduleColKey?: string;
+    /** 分组唯一标识 */
+    groupId: string | number;
+    /** 多级分组值数组 */
+    multiValue: any[];
+    /** 鼠标在 canvas 上的 x 坐标 */
+    x: number;
+    /** 鼠标在 canvas 上的 y 坐标 */
+    y: number;
+    /** 单元格在视口中的边界（用于 tooltip/弹窗定位） */
+    cellBounds: {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    };
+    /** 嵌套子列 key（仅 nested 子列有值） */
+    nestedChildKey?: string;
+}
 /**
  * Footer 嵌套列统计刷新回调信息
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arthub-table",
-  "version": "0.2.55",
+  "version": "0.2.56-next.1",
   "description": "High-performance canvas-based table/grid component for Vue 3 with TypeScript support, featuring virtual scrolling, cell viewers, grouped rows, and nested grids.",
   "main": "dist/arthub-table.common.js",
   "module": "dist/arthub-table.umd.min.js",