arthub-table 0.2.0-beta.9 → 0.2.1

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

@@ -121,6 +121,12 @@ export interface DataGridInitOptions {
      * 使宿主应用可以覆盖默认的 fontFamilyPrimary / fontFamilySystem 等 Token。
      */
     customTokens?: Record<string, any>;
+    /**
+     * 是否隐藏表头业务图标（TAPD / IOMC / fieldHint / link）。
+     * 对齐 DOM 表格的 "显示表头图标" 开关（tableHeaderIconConfigStorage.hideIcon）。
+     * 默认 false（显示图标）。
+     */
+    hideHeaderIcons?: boolean;
 }
 /**
  * DataGrid 事件回调配置
@@ -276,6 +282,9 @@ export interface DataGridCallbacks {
         colId: string;
         colIndex: number;
         colTitle: string;
+        colKey: string;
+        colType?: string;
+        parentKey?: string;
         clientX: number;
         clientY: number;
     }) => void;
@@ -284,8 +293,17 @@ export interface DataGridCallbacks {
         colId: string;
         colIndex: number;
         colTitle: string;
+        colKey: string;
+        colType?: string;
+        parentKey?: string;
         clientX: number;
         clientY: number;
+        headerBounds: {
+            left: number;
+            top: number;
+            width: number;
+            height: number;
+        };
     }) => void;
     /** 嵌套列设置图标点击 */
     onNestedSettingsClick?: (info: {
@@ -397,6 +415,25 @@ export interface DataGridCallbacks {
             nestedGridData: any[];
         }>;
     }) => void;
+    /** 嵌套子表内子行拖动排序回调（Alt + 拖拽触发，不跨外层行） */
+    onNestedRowDragReorder?: (params: {
+        parentRowData: any;
+        parentColKey: string;
+        parentRowIndex: number;
+        parentColIndex: number;
+        /** 被拖拽的子行索引（相对 nestedGridData） */
+        fromRowIndex: number;
+        /** 目标插入位置索引（相对 nestedGridData） */
+        toRowIndex: number;
+        /** 插入位置：front 插到目标行之前，tail 插到目标行之后 */
+        position: 'front' | 'tail';
+        /** 被拖拽子行数据 */
+        fromRowData: any;
+        /** 目标参考子行数据 */
+        toRowData: any;
+        /** NestedGrid 实际渲染的数据数组 */
+        nestedGridData: any[];
+    }) => void;
     /** 滚动回调 */
     onScroll?: (scrollX: number, scrollY: number) => void;
     /** 滚动开始回调 */
@@ -509,6 +546,20 @@ export interface DataGridCallbacks {
             height: number;
         };
     }) => void;
+    /** 表头 fieldHint info icon hover 回调：鼠标悬停/离开字段提示图标时触发 */
+    onHeaderFieldHintIconHover?: (info: {
+        show: boolean;
+        colKey: string;
+        colIndex: number;
+        colTitle: string;
+        fieldHint: string;
+        position: {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        };
+    }) => void;
     /** 表体 Link icon 点击回调：点击引用字段单元格的 link icon 时触发 */
     onLinkIconClick?: (info: {
         rowData: Record<string, any>;

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

@@ -32,6 +32,7 @@ export interface ITableHeader {
     id?: string;
     isTapdRelated?: boolean;
     isIomc?: boolean;
+    fieldHint?: string;
     showUserWorkingHours?: boolean;
     statisticType?: string;
     loading?: boolean;
@@ -44,6 +45,12 @@ export interface ITableHeader {
     headerOriginIndex?: number;
     perspectiveColChildren?: any[];
     isDisplayThumbnail?: boolean;
+    isAcceptanceRemind?: boolean;
+    showAcceptanceRemind?: boolean;
+    /** 是否显示筛选图标（hover 时）。显式 false 时不绘制筛选 icon（排序相关图标保留）。默认等同 true */
+    showFilterIcon?: boolean;
+    /** 筛选命中该列时为 true：筛选图标常驻显示且显示激活色 */
+    filterIconActive?: boolean;
 }
 /**
  * AssetMatrix ViewerNames 到 DataGrid ColumnType 的映射表

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

@@ -34,6 +34,10 @@ export interface PreprocessedRow {
     _originalPathId?: string | number;
     _tableTreeLevel?: number;
     _proxyedDataRef?: Record<string, any>;
+    /** 组头行是否被搜索命中（仅 isGroup 行有效），供 GroupRow 渲染查询 */
+    _groupHeaderSearchMatched?: boolean;
+    /** 组头行是否是当前高亮项（需要绘制 2px 橙色 inset 边框），仅 isGroup 行有效 */
+    _groupHeaderSearchCurrentHighlight?: boolean;
 }
 /**
  * Expand proxy row (parentHasLink or isUsePathId)
@@ -72,11 +76,15 @@ export declare function calculatePermissions(row: Record<string, any>, headers:
 export declare function collectErrors(row: Record<string, any>, headers: ITableHeader[]): Record<string, string>;
 /**
  * Calculate search match state for the row
+ *
+ * Note: `isGroupHeader` is an opaque field used by GroupRow rendering only.
+ * It is transparently ignored here (data row match semantics remain unchanged).
  */
 export declare function calculateSearchMatch(row: Record<string, any>, searchMatchList: Array<{
     id: string | number;
     key: string;
     highlight?: boolean;
+    isGroupHeader?: boolean;
 }>): SearchMatchResult;
 /**
  * Calculate background color for a cell based on highlighted properties
@@ -100,6 +108,7 @@ export interface PrecomputedContext {
     searchMatchMap?: Map<string | number, Array<{
         key: string;
         highlight?: boolean;
+        isGroupHeader?: boolean;
     }>>;
     /**
      * Pre-filtered headers that actually need transformCellValues processing.
@@ -194,3 +203,17 @@ export declare function preprocessSingleRow(rawRow: Record<string, any>, allHead
     controllerProps: Record<string, any>;
     tableIndex?: number;
 }): PreprocessedRow;
+/**
+ * Rebuild _nestedData for specific nested columns on given preprocessed rows.
+ *
+ * This extracts the nested data construction logic from convertToDataGridRows,
+ * allowing incremental rebuild of _nestedData when a child column's data changes
+ * (e.g. file/image upload in a nested sub-table) without a full data refresh.
+ *
+ * @param rows - Preprocessed row array (same as body.data / _dataGridData)
+ * @param rawRows - Raw row data array (same as tableDataList)
+ * @param nestedParentKeys - Keys of the nested parent columns to rebuild
+ * @param allHeaders - All column headers (including nested columns with children)
+ * @param props - Controller props (pipelineViewKey, displayTaskNum, iconUrlPrefix, etc.)
+ */
+export declare function rebuildNestedColumnData(rows: PreprocessedRow[], rawRows: Record<string, any>[], nestedParentKeys: string[], allHeaders: ITableHeader[], props: Record<string, any>): void;

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

@@ -21,6 +21,13 @@ declare class ColumnHeader extends Context {
     color?: string;
     isTapdRelated: boolean;
     isIomc: boolean;
+    fieldHint: string;
+    fieldHintIconBounds: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | null;
     isLink: boolean;
     linkKey?: string;
     linkTask?: string;
@@ -32,9 +39,28 @@ declare class ColumnHeader extends Context {
     } | null;
     convertMeta: string;
     sortDisabled: boolean;
+    showFilterIcon: boolean | undefined;
+    filterIconActive: boolean | undefined;
     constructor(grid: DataGrid, index: number, x: number, y: number, width: number, height: number, column: Column);
     isVisibleOnScreen(): boolean;
     draw(): void;
+    /**
+     * Invalidate fieldHintIconBounds / linkIconBounds hit-boxes if the icon is visually
+     * covered by the given mask rectangle (which covers the sort/filter icon area) by >= 50%.
+     *
+     * Background: when the column width is narrow, the sort/filter icon mask paints over
+     * the fieldHint info icon and/or link icon (both drawn earlier in the same draw pass).
+     * The icon is no longer visible to the user, so hover interaction must not trigger the
+     * associated popper/tooltip. By zeroing the bounds here, the hover hit-testing in
+     * Events.ts naturally short-circuits (`if (... && xxxIconBounds)`).
+     *
+     * Threshold: 50% area coverage. Partial occlusion below 50% keeps the bounds active,
+     * matching user expectation that a mostly-visible icon remains interactive.
+     *
+     * Mask rectangle spans full header height (this.y, this.height), so only horizontal
+     * overlap matters in practice, but we compute 2D overlap for correctness.
+     */
+    private _invalidateBoundsIfMasked;
     /**
      * Check if this nested-child column is the last child of its parent nested column.
      * Compares right edge of this child with right edge of the parent header.