arthub-table 0.2.76 → 0.2.77-next.0

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

@@ -16,6 +16,28 @@ export interface SearchMatchResult {
     highlightKeys: string[];
     currentHighlightKey?: string;
 }
+/**
+ * 待定迁移态（pending relocation）行信息
+ * 由业务侧（AssetMatrix）通过 controllerProps.pendingRelocateInfo 传入，
+ * preprocessRow 按 rowKey 匹配命中行后打标 result._pendingRelocate。
+ * props 驱动的优势：行对象被业务侧重建（单行刷新换新行对象）后标记不丢失。
+ *
+ * 兼容两种形态：单对象（单行待定）或数组（多行待定，共享标题）。
+ */
+export interface PendingRelocateInfo {
+    /** 待定行的 id（按 rowKey 匹配，字符串化比较，不假设类型） */
+    rowId: string | number;
+    /** 提示条文案（如「此记录将按照分组规则调整至其他分组」） */
+    bannerText: string;
+    /** 匹配用的行 key，默认 'id'（业务侧 grid.rowKey 可配） */
+    rowKey?: string;
+    /**
+     * 多行待定模式下：该行是否为「连续待定块」的首行。
+     * 仅块首行绘制共享标题 banner（行高 +24）；块内其余行只染黄底（行高不变）。
+     * 单对象（单行模式）缺省视为 true。
+     */
+    isBlockStart?: boolean;
+}
 /**
  * Preprocessed row data with computed metadata
  */
@@ -30,6 +52,11 @@ export interface PreprocessedRow {
     _cpHighLight?: boolean;
     /** CP 高亮行中需要使用高亮文字色的列 key */
     _cpHighLightFields?: string[];
+    /** 待定迁移态标记：命中 props.pendingRelocateInfo 的行由 preprocessRow 写入 */
+    _pendingRelocate?: {
+        bannerText: string;
+        isBlockStart?: boolean;
+    };
     _isTopLevelEntity?: boolean;
     _isEmpty?: boolean;
     _isGroup?: boolean;

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

@@ -15,6 +15,14 @@ declare class Row extends Context {
     cells: Cell[];
     rowHeader: RowHeader;
     constructor(grid: DataGrid, rowIndex: number, x: number, y: number, height: number, data: RowData);
+    /**
+     * 待定迁移态提示贴片高度：本行为待定行且是「连续待定块」的首行时返回
+     * PENDING_RELOCATE_BANNER_HEIGHT，否则 0。
+     * 贴片悬浮绘制在行顶部（不占行高，cells 几何不受影响）。
+     * 多行待定（共享标题）模式下，仅块首行绘制贴片，块内其余行只染黄底；
+     * 单行模式（单对象打标，无 isBlockStart）恒为块首，行为与旧版一致。
+     */
+    get pendingRelocateBannerHeight(): number;
     isInVerticalAutofill(mouseX: number, mouseY: number): boolean;
     handleCheck(checked?: boolean, event?: MouseEvent, silent?: boolean): void;
     mouseDown(x: number, y: number, _clientX?: number, _clientY?: number): void;
@@ -27,5 +35,15 @@ declare class Row extends Context {
     resizeRow(rowIndex: number, height: number): void;
     rePaint(): void;
     draw(): void;
+    /**
+     * 绘制待迁移态提示贴片（对齐腾讯文档/智能表格交互）。
+     * - 悬浮在任务行外的左上方：底边贴行顶边线（bannerY = rowTop - height），
+     *   不占行高也不遮挡本行任何 cell 内容；clamp 到表头下缘（表头 z-order 在
+     *   body 之上，越界部分会被表头盖住）；
+     * - 横向冻结：锚定可视数据区开头（fixedLeftWidth），不随横向滚动移动；
+     * - 宽度自适应：仅包裹 图标+文案（padding + icon + gap + textWidth + padding），
+     *   超出可视区宽度时截断到可视宽度（clip 防溢出）。
+     */
+    private drawPendingRelocateBanner;
 }
 export default Row;

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

@@ -177,6 +177,12 @@ export interface ThemeTokens {
     bgCpHighlight: string;
     /** CP 高亮行文字色 */
     textCpHighlight: string;
+    /** 待定迁移态行背景色（编辑分组/筛选/搜索字段后等待迁移的行） */
+    bgPendingRelocate: string;
+    /** 待定迁移态行顶部提示条背景色（业务色，对齐智能表格 #f1c40f） */
+    bgPendingRelocateBanner: string;
+    /** 待定迁移态行顶部提示条文字色（业务色，亮黄条上的深色文字） */
+    textPendingRelocateBanner: string;
     /** 需求变更-新增需求背景色 */
     bgDemandChangeAdd: string;
     /** 需求变更-新增需求 hover 背景色 */

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

@@ -6,6 +6,8 @@ export declare const CHECK_BOX_WIDTH = 36;
 export declare const CELL_HEIGHT = 36;
 export declare const MIN_CELL_WIDTH = 50;
 export declare const MIN_CELL_HEIGHT = 36;
+/** 待定迁移态（pending relocation）悬浮提示贴片高度：贴片悬浮盖在行顶部，不占行高 */
+export declare const PENDING_RELOCATE_BANNER_HEIGHT = 24;
 export declare const SCROLLER_TRACK_SIZE = 16;
 export declare const SCROLLER_SIZE = 8;
 /** @deprecated 请使用 styleManager.getToken('scrollerColor') */

package/dist/types/index.d.ts

@@ -43,7 +43,7 @@ export { getFieldStatisticTypes } from './core/footer/utils';
 export { convertToDataGridColumns, } from './adapters/columnAdapter';
 export type { ITableHeader, } from './adapters/columnAdapter';
 export { convertToDataGridRows, isPerfLogEnabled, rebuildNestedColumnData, invalidatePreprocessRowCache, } from './adapters/rowDataAdapter';
-export type { PreprocessedRow, } from './adapters/rowDataAdapter';
+export type { PreprocessedRow, PendingRelocateInfo, } from './adapters/rowDataAdapter';
 export { preprocessRowStyles, } from './adapters/styleAdapter';
 export type { RowStyleResult, } from './adapters/styleAdapter';
 export { DataGridEventAdapter, EventCategory, extractEventContext, mapDomEventToDataGridEvent, } from './adapters/DataGridEventAdapter';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arthub-table",
-  "version": "0.2.76",
+  "version": "0.2.77-next.0",
   "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",