arthub-table 0.2.76-next.2 → 0.2.77-next.0

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

@@ -21,6 +21,8 @@ export interface SearchMatchResult {
  * 由业务侧（AssetMatrix）通过 controllerProps.pendingRelocateInfo 传入，
  * preprocessRow 按 rowKey 匹配命中行后打标 result._pendingRelocate。
  * props 驱动的优势：行对象被业务侧重建（单行刷新换新行对象）后标记不丢失。
+ *
+ * 兼容两种形态：单对象（单行待定）或数组（多行待定，共享标题）。
  */
 export interface PendingRelocateInfo {
     /** 待定行的 id（按 rowKey 匹配，字符串化比较，不假设类型） */
@@ -29,6 +31,12 @@ export interface PendingRelocateInfo {
     bannerText: string;
     /** 匹配用的行 key，默认 'id'（业务侧 grid.rowKey 可配） */
     rowKey?: string;
+    /**
+     * 多行待定模式下：该行是否为「连续待定块」的首行。
+     * 仅块首行绘制共享标题 banner（行高 +24）；块内其余行只染黄底（行高不变）。
+     * 单对象（单行模式）缺省视为 true。
+     */
+    isBlockStart?: boolean;
 }
 /**
  * Preprocessed row data with computed metadata
@@ -47,6 +55,7 @@ export interface PreprocessedRow {
     /** 待定迁移态标记：命中 props.pendingRelocateInfo 的行由 preprocessRow 写入 */
     _pendingRelocate?: {
         bannerText: string;
+        isBlockStart?: boolean;
     };
     _isTopLevelEntity?: boolean;
     _isEmpty?: boolean;

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

@@ -16,8 +16,11 @@ declare class Row extends Context {
     rowHeader: RowHeader;
     constructor(grid: DataGrid, rowIndex: number, x: number, y: number, height: number, data: RowData);
     /**
-     * 待定迁移态提示贴片高度：本行为待定行时返回 PENDING_RELOCATE_BANNER_HEIGHT，否则 0。
+     * 待定迁移态提示贴片高度：本行为待定行且是「连续待定块」的首行时返回
+     * PENDING_RELOCATE_BANNER_HEIGHT，否则 0。
      * 贴片悬浮绘制在行顶部（不占行高，cells 几何不受影响）。
+     * 多行待定（共享标题）模式下，仅块首行绘制贴片，块内其余行只染黄底；
+     * 单行模式（单对象打标，无 isBlockStart）恒为块首，行为与旧版一致。
      */
     get pendingRelocateBannerHeight(): number;
     isInVerticalAutofill(mouseX: number, mouseY: number): boolean;

package/package.json

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