arthub-table 0.2.0-beta.8 → 0.2.1

package/dist/types/testing/TestHooks.d.ts

@@ -213,6 +213,29 @@ export interface TestHooksAPI {
      * @returns Row data object or null if not found
      */
     getRowData: (rowId: string | number) => Record<string, any> | null;
+    /**
+     * 获取组头行搜索命中高亮状态。
+     *
+     * 返回值说明：
+     * - `matched`：组头行是否被搜索命中（searchMatchList 中存在 isGroupHeader: true 且 id 匹配的条目）
+     * - `currentHighlight`：是否是"当前高亮"项（命中条目中存在 highlight: true 的 field），为 true 时 GroupRow 会绘制 2px 橙色 inset 边框
+     *
+     * @param rowId - 组头行 id（分组模式下通常是 string）
+     * @returns 命中状态或 null（行不存在 / 非组头行）
+     */
+    getGroupHeaderSearchMatchState: (rowId: string | number) => {
+        matched: boolean;
+        currentHighlight: boolean;
+    } | null;
+    /**
+     * 获取组头行搜索命中高亮的"首列左边框" x 坐标（canvas 相对坐标）。
+     *
+     * 用于验证多层分组（1D/2D/3D）下左边框贴合分组名称块左缘的正确性。
+     *
+     * @param rowId - 组头行 id
+     * @returns x 坐标或 null（行不存在 / 非组头行）
+     */
+    getSearchHighlightFirstLeftBorderX: (rowId: string | number) => number | null;
     /**
      * Get the current scroll position.
      * @returns ScrollPosition object
@@ -296,37 +319,29 @@ export interface TestHooksAPI {
         canvasY: number;
     } | null;
     /**
-     * Get current selection range. (Phase 2)
+     * Get all interactive (clickable) areas within a specific cell.
+     * Returns canvas-relative coordinates for edit icon, link icon, error icon, etc.
+     * Used by Playwright to simulate clicks on specific cell regions.
      */
-    getSelectionRange?: () => {
-        startRow: number;
-        startCol: number;
-        endRow: number;
-        endCol: number;
-    } | null;
+    getCellInteractiveAreas: (rowId: string | number, columnKey: string) => CellInteractiveAreas | null;
     /**
-     * Get edit state for a specific cell. (Phase 2)
+     * Get interactive areas within a column header.
+     * Returns sort/filter icon, resize handle, and settings icon bounds.
      */
-    getCellEditState?: (rowId: string | number, columnKey: string) => {
-        isEditing: boolean;
-        value: any;
-    } | null;
+    getHeaderInteractiveAreas: (colIndex: number) => HeaderInteractiveAreas | null;
     /**
-     * Get current drag operation state. (Phase 2)
+     * Get interactive areas within a group row header.
+     * Returns expand arrow and checkbox bounds.
      */
-    getDragState?: () => {
-        isDragging: boolean;
-        type: 'row' | 'column' | 'selection' | null;
-        sourceIds: string[];
-        targetId: string | null;
-    } | null;
+    getGroupRowAreas: (rowId: string) => GroupRowAreas | null;
     /**
-     * Get cells that are currently in loading state. (Phase 2)
+     * Get all visible group rows with their expand/collapse state.
      */
-    getLoadingCells?: () => Array<{
-        rowId: string | number;
-        columnKey: string;
-    }>;
+    getVisibleGroupRows: () => VisibleGroupRowInfo[];
+    /**
+     * Get current selection, editing, and checked-row state.
+     */
+    getSelectionState: () => SelectionState;
 }
 /**
  * Test info for a single nested grid instance
@@ -382,11 +397,159 @@ export interface NestedGridTestInfo {
     /** Row height */
     rowHeight: number;
 }
+/**
+ * Bounding box in canvas coordinates (can be converted to viewport coords)
+ */
+export interface AreaBounds {
+    /** Canvas-relative X coordinate */
+    canvasX: number;
+    /** Canvas-relative Y coordinate */
+    canvasY: number;
+    /** Width in pixels */
+    width: number;
+    /** Height in pixels */
+    height: number;
+}
+/**
+ * A viewer-specific interactive area within a cell
+ */
+export interface ViewerArea {
+    /** Area type identifier */
+    type: string;
+    /** Area bounds */
+    bounds: AreaBounds;
+    /** Current value (e.g. boolean true/false, progress 0.75) */
+    value?: any;
+}
+/**
+ * All interactive areas within a single cell.
+ * Used by Playwright to know WHERE to click for specific interactions.
+ */
+export interface CellInteractiveAreas {
+    /** Entire cell area */
+    cell: AreaBounds;
+    /** Edit icon (hover-triggered, top-right) — null if readonly/hideEditIcon/nestedGrid */
+    editIcon: AreaBounds | null;
+    /** Link icon — null if not a link column */
+    linkIcon: AreaBounds | null;
+    /** Error/warning icon — null if no error */
+    errorIcon: AreaBounds | null;
+    /** Reminder triangle (top-right corner) — null if no reminder */
+    reminderTriangle: AreaBounds | null;
+    /** Viewer-specific interactive areas */
+    viewerAreas: ViewerArea[];
+    /** Cell metadata */
+    meta: {
+        viewerType: string;
+        readonly: boolean;
+        isLink: boolean;
+        hasError: boolean;
+        hasReminder: boolean;
+        hasNestedGrid: boolean;
+    };
+}
+/**
+ * Interactive areas within a column header
+ */
+export interface HeaderInteractiveAreas {
+    /** Entire header cell area */
+    header: AreaBounds;
+    /** Sort icon area (shown on hover, left of filter icon) — null for compound headers */
+    sortIcon: AreaBounds | null;
+    /** Filter icon area (shown on hover, rightmost) — null for compound headers */
+    filterIcon: AreaBounds | null;
+    /** Column resize handle (right edge ±6px) — null for compound headers */
+    resizeHandle: AreaBounds;
+    /** Settings icon (nested parent header only) */
+    settingsIcon: AreaBounds | null;
+    /** Metadata */
+    meta: {
+        colId: string;
+        columnKey: string;
+        colType: string;
+        index: number;
+        sortDisabled: boolean;
+        canDrag: boolean;
+        isNested: boolean;
+    };
+}
+/**
+ * Interactive areas within a group row header
+ */
+export interface GroupRowAreas {
+    /** Expand/collapse arrow */
+    expandArrow: AreaBounds;
+    /** Checkbox area — null if not a leaf group or no checkbox */
+    checkbox: AreaBounds | null;
+    /** Entire row area */
+    row: AreaBounds;
+    /** Metadata */
+    meta: {
+        expanded: boolean;
+        groupLevel: number;
+        groupName: string;
+        isLeafGroup: boolean;
+        rowId: string;
+    };
+}
+/**
+ * Current selection/editing state of the table
+ */
+export interface SelectionState {
+    /** Selection range (null if nothing selected) */
+    range: {
+        startRow: number;
+        startCol: number;
+        endRow: number;
+        endCol: number;
+    } | null;
+    /** Active (focused) cell */
+    activeCell: {
+        rowIndex: number;
+        colIndex: number;
+    } | null;
+    /** IDs of checked (checkbox-selected) rows */
+    checkedRowIds: (string | number)[];
+    /** Editor state — null if editor is closed */
+    editor: {
+        show: boolean;
+        rowIndex: number;
+        colIndex: number;
+    } | null;
+}
+/**
+ * Visible group row info (for listing group rows in tests)
+ */
+export interface VisibleGroupRowInfo {
+    rowId: string;
+    rowIndex: number;
+    expanded: boolean;
+    groupName: string;
+    groupLevel: number;
+    isLeafGroup: boolean;
+}
+/**
+ * Registry for multiple DataGrid test hook instances.
+ * Supports one page having multiple DataGrid components.
+ */
+export interface TestHooksRegistry {
+    /** Register a grid's hooks (called by installTestHooks) */
+    register(canvasId: string, hooks: TestHooksAPI): void;
+    /** Unregister a grid's hooks (called on component destroy) */
+    unregister(canvasId: string): void;
+    /** Get hooks for a specific grid */
+    get(canvasId: string): TestHooksAPI | undefined;
+    /** Get the first registered grid's hooks (backward compat) */
+    getFirst(): TestHooksAPI | undefined;
+    /** List all registered canvas IDs */
+    list(): string[];
+}
 /**
  * Global window augmentation for test hooks
  */
 declare global {
     interface Window {
         __CANVAS_TABLE_TEST_HOOKS__?: TestHooksAPI;
+        __CANVAS_TABLE_TEST_HOOKS_REGISTRY__?: TestHooksRegistry;
     }
 }

package/dist/types/testing/index.d.ts

@@ -1,3 +1,3 @@
-export type { CellLayout, VisibleCell, TestColumnConfig, ScrollPosition, TableDimensions, SnapshotDifference, SnapshotCompareResult, TableSnapshot, TestHooksAPI, } from './TestHooks';
+export type { CellLayout, VisibleCell, TestColumnConfig, ScrollPosition, TableDimensions, SnapshotDifference, SnapshotCompareResult, TableSnapshot, TestHooksAPI, AreaBounds, ViewerArea, CellInteractiveAreas, HeaderInteractiveAreas, GroupRowAreas, SelectionState, VisibleGroupRowInfo, TestHooksRegistry, } from './TestHooks';
 export { installTestHooks, removeTestHooks } from './installTestHooks';
 export { SnapshotManager } from './SnapshotManager';

package/dist/types/testing/installTestHooks.d.ts

@@ -1,6 +1,6 @@
 import type DataGrid from '../core/DataGrid';
 /**
- * Install test hooks on window.__CANVAS_TABLE_TEST_HOOKS__
+ * Install test hooks on window.__CANVAS_TABLE_TEST_HOOKS__ and the registry.
  * This should be called after DataGrid is fully initialized.
  *
  * In production builds, this function is a no-op and can be
@@ -10,7 +10,7 @@ import type DataGrid from '../core/DataGrid';
  */
 export declare function installTestHooks(grid: DataGrid): void;
 /**
- * Remove test hooks from the global window object.
- * Called when the DataGrid is destroyed.
+ * Remove test hooks for a specific grid instance from the registry.
+ * @param canvasId - The canvas element ID to unregister
  */
-export declare function removeTestHooks(): void;
+export declare function removeTestHooks(canvasId?: string): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arthub-table",
-  "version": "0.2.0-beta.8",
+  "version": "0.2.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",
@@ -61,6 +61,7 @@
     "test:e2e:headed": "playwright test --headed",
     "test:e2e:report": "playwright show-report test-results/html-report",
     "setup-husky": "node scripts/setup-husky.js",
+    "typecheck": "tsc -p tsconfig.typecheck.json",
     "lint": "vue-cli-service lint",
     "predeploy": "npm run build:demo",
     "deploy": "gh-pages -d dist",
@@ -119,6 +120,9 @@
     "*.{js,jsx,vue,ts,tsx}": [
       "npm run test:unit -- --passWithNoTests --findRelatedTests",
       "vue-cli-service lint --fix"
+    ],
+    "*.{ts,tsx}": [
+      "bash -c 'npm run typecheck'"
     ]
   }
 }