arthub-table 0.1.0-beta.2 → 0.1.0-beta.21

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

@@ -40,6 +40,10 @@ export interface DataGridInitOptions {
     headerHeight?: number;
     /** 是否显示底部统计行 */
     showFooter?: boolean;
+    /** 列总宽小于表格可视区域宽度时，是否将剩余空间均分到每列（默认 false） */
+    autoFillTableWidth?: boolean;
+    /** 底部统计行高度，默认 36 */
+    footerHeight?: number;
     /** 是否显示斑马纹 */
     striped?: boolean;
     /** 是否是透视子表 */
@@ -48,6 +52,8 @@ export interface DataGridInitOptions {
     showCheckbox?: boolean;
     /** 是否显示索引列 */
     showTableIndex?: boolean;
+    /** 是否在表头左上角显示全选 checkbox，默认 false */
+    showHeaderCheckbox?: boolean;
     /**
      * 索引列模式：
      * - 'auto'：自动模式，行号 = rowIndex + 1（默认）
@@ -58,6 +64,12 @@ export interface DataGridInitOptions {
     debug?: boolean;
     /** 是否启用内置键盘快捷键监听，默认 false */
     enableKeyboardShortcuts?: boolean;
+    /**
+     * Whether to disable DataGrid's built-in "click outside to close editing" behavior.
+     * When true, the host application is responsible for managing click-outside logic.
+     * Default: false.
+     */
+    disableClickOutside?: boolean;
     /** 主题 */
     theme?: string | Record<string, any>;
     /** WfState Viewer 显示样式：'icon'=图标+文字（默认），'tag'=色块标签 */
@@ -73,6 +85,15 @@ export interface DataGridInitOptions {
      * 默认 'controlled'
      */
     groupToggleMode?: 'controlled' | 'uncontrolled';
+    /**
+     * 分组维度数（由外部传入，优先级高于行数据遍历推断）。
+     * - 0 = 无分组
+     * - 1 = 一维分组
+     * - 2 = 二维分组
+     * - 3 = 三维分组
+     * 未传入时退化为遍历行数据推断（旧逻辑）。
+     */
+    groupDimension?: number;
     /** 业务 props (用于行数据预处理) */
     controllerProps?: Record<string, any>;
     /**
@@ -80,6 +101,18 @@ export interface DataGridInitOptions {
      * 当为 true 时，行数据中 tapd_sync_state 处于同步状态的任务名称列将显示 TAPD 蓝色
      */
     tapdInSyncTaskNameHighlight?: boolean;
+    /**
+     * 嵌套子表数据比对 key 列表（性能优化）。
+     * loadData 时比较新旧嵌套数据中这些 key 的值，未变化则复用旧 NestedGrid 实例。
+     * 默认 ['id']。
+     */
+    nestedDataCompareKeys?: string[];
+    /**
+     * 嵌套子表强制刷新 key 列表（性能优化）。
+     * 新嵌套数据中任意一行包含这些 key 且有值时，强制重建 NestedGrid。
+     * 默认 []。
+     */
+    nestedForceRefreshKeys?: string[];
     /** DataGrid 事件回调 */
     callbacks?: DataGridCallbacks;
 }
@@ -164,6 +197,7 @@ export interface DataGridCallbacks {
             endRow: number;
             endCol: number;
         };
+        nestedGridData: any[];
     }) => void;
     /** 粘贴完成 */
     afterPaste?: (data: any) => void;
@@ -207,6 +241,10 @@ export interface DataGridCallbacks {
     onFooterCellClick?: (info: any) => void;
     /** 组头单元格点击 */
     onGroupHeaderCellClick?: (info: any) => void;
+    /** Footer 嵌套列统计刷新 */
+    onFooterStatRefresh?: (info: any) => void;
+    /** 组头嵌套列统计刷新 */
+    onGroupHeaderStatRefresh?: (info: any) => void;
     /** 表头排序图标点击 */
     onHeaderSortClick?: (info: {
         colId: string;
@@ -277,6 +315,47 @@ export interface DataGridCallbacks {
             height: number;
         };
     }) => void;
+    /** 嵌套子表框选变化回调：选区跨子表或单子表变化时触发 */
+    onNestedSelectionChange?: (params: {
+        parentColKey: string;
+        selections: Array<{
+            parentRowData: any;
+            parentRowIndex: number;
+            parentColIndex: number;
+            selectionRange: {
+                startRow: number;
+                startCol: number;
+                endRow: number;
+                endCol: number;
+            };
+        }>;
+    }) => void;
+    /** 嵌套子表跨子表 autofill 结束回调 */
+    onNestedCrossAutofillEnd?: (params: {
+        parentColKey: string;
+        sourceSelections: Array<{
+            parentRowData: any;
+            parentRowIndex: number;
+            selectionRange: {
+                startRow: number;
+                startCol: number;
+                endRow: number;
+                endCol: number;
+            };
+        }>;
+        targetSelections: Array<{
+            parentRowData: any;
+            parentRowIndex: number;
+            autofillRange: {
+                startRow: number;
+                startCol: number;
+                endRow: number;
+                endCol: number;
+            };
+            /** NestedGrid 实际渲染的数据数组（行索引与 autofillRange 完全一致） */
+            nestedGridData: any[];
+        }>;
+    }) => void;
     /** 滚动回调 */
     onScroll?: (scrollX: number, scrollY: number) => void;
     /** 滚动开始回调 */
@@ -314,6 +393,24 @@ export interface DataGridCallbacks {
         isNestedChild: boolean;
         nestedChildOffset: number;
     }) => void;
+    /** Cell hover 变化回调：当 hover 的单元格变化时通知外部（用于时间型字段 tooltip / 历史变更等） */
+    onCellHoverChange?: (info: {
+        show: boolean;
+        rowIndex: number;
+        colIndex: number;
+        colKey: string;
+        rowData: Record<string, any>;
+        position: {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        };
+        canvasElement: HTMLCanvasElement;
+        displayText: string;
+        mouseX: number;
+        mouseY: number;
+    }) => void;
     /** Error icon hover 回调：鼠标悬停在单元格 warning icon 上时触发（用于外部 AlarmPopper） */
     onErrorIconHover?: (info: {
         show: boolean;
@@ -378,6 +475,28 @@ export interface DataGridCallbacks {
     onBeforeRowRender?: (rowIndex: number, rowData: Record<string, any>) => void;
     /** 嵌套表格渲染前回调：每个嵌套表格格子绘制前触发，用于分组表格管线列渐进式加载 */
     onBeforeNestedGridRender?: (rowIndex: number, rowData: Record<string, any>, colKey: string) => void;
+    /** 普通行 checkbox 变更回调（受控模式）：checkbox 点击时通知外部更新 tableSelectedList */
+    onRowCheckChange?: (info: {
+        rowId: string;
+        checked: boolean;
+        rowData: any;
+        selectedRowIds: string[];
+        event?: MouseEvent;
+    }) => void;
+    /** 组头 checkbox 变更回调（受控模式）：组头 checkbox 点击时通知外部批量更新 tableSelectedList */
+    onGroupCheckboxChange?: (info: {
+        groupId: string | number;
+        checked: boolean;
+        data: any;
+        selectedRowIds: string[];
+    }) => void;
+    /**
+     * Cell value transformer callback.
+     * Called by Cell.drawWithViewer() before passing data to viewer.draw().
+     * Transforms raw cell values to display values at render time.
+     * Return undefined to keep the original value.
+     */
+    cellValueTransformer?: import('../core/viewers/types').CellValueTransformer;
 }
 /**
  * DataGrid 初始化结果
@@ -494,6 +613,15 @@ export declare function refreshDataGridColumns(tableHeadListFixLeft: ITableHeade
  * @param controllerProps - 业务 props（包含 resolver 函数等）
  */
 export declare function refreshDataGridColumnByKeys(dataGrid: any, preprocessedData: PreprocessedRow[], rawDataList: Record<string, any>[], colKeys: string[], allHeaders: ITableHeader[], controllerProps: Record<string, any>): void;
+/**
+ * [Optimization B] Async time-sliced version of refreshDataGridColumnByKeys.
+ * Processes rows in batches via refreshColumnCellValuesAsync, yielding to the
+ * main thread between batches to prevent long tasks from blocking scrolling.
+ * After all batches are processed, triggers a single DataGrid repaint.
+ *
+ * @param batchSize - Number of rows per batch (default 200)
+ */
+export declare function refreshDataGridColumnByKeysAsync(dataGrid: any, preprocessedData: PreprocessedRow[], rawDataList: Record<string, any>[], colKeys: string[], allHeaders: ITableHeader[], controllerProps: Record<string, any>, batchSize?: number, isStale?: () => boolean): Promise<void>;
 /**
  * Incrementally update a single row in the DataGrid.
  *

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

@@ -3,7 +3,7 @@
  * 桥接 AssetMatrix ProgressTableFillerController 与 DataGrid 组件
  */
 export { ITableHeader, VIEWER_TYPE_MAP, mapHeaderToColumn, convertToDataGridColumns, getDataGridViewerType, mapViewerToNestedType, } from './columnAdapter';
-export { PreprocessedRow, SearchMatchResult, expandProxyRow, calculatePermissions, collectErrors, calculateSearchMatch, calculateRowBgColor, preprocessRow, preprocessSingleRow, convertToDataGridRows, computeStageFlags, } from './rowDataAdapter';
+export { PreprocessedRow, SearchMatchResult, expandProxyRow, calculatePermissions, collectErrors, calculateSearchMatch, calculateRowBgColor, preprocessRow, preprocessSingleRow, convertToDataGridRows, refreshColumnCellValues, refreshColumnCellValuesAsync, computeStageFlags, isPerfLogEnabled, } from './rowDataAdapter';
 export { RowStyleResult, preprocessRowStyles, getRowClassName, getCellClassName, calculateFirstLeftColor, } from './styleAdapter';
 export { DataGridEventAdapter, EventCategory, EventContext, extractEventContext, mapDomEventToDataGridEvent, } from './DataGridEventAdapter';
-export { DataGridInitOptions, DataGridCallbacks, DataGridInitResult, buildDataGridInitParams, refreshDataGridRows, refreshDataGridColumns, refreshDataGridColumnByKeys, refreshDataGridRowByIndex, } from './DataGridIntegration';
+export { DataGridInitOptions, DataGridCallbacks, DataGridInitResult, buildDataGridInitParams, refreshDataGridRows, refreshDataGridColumns, refreshDataGridColumnByKeys, refreshDataGridColumnByKeysAsync, refreshDataGridRowByIndex, } from './DataGridIntegration';

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

@@ -3,6 +3,11 @@
  * 将 AssetMatrix 的逐格 getCellData 逻辑前移为整行预处理
  */
 import type { ITableHeader } from './columnAdapter';
+/**
+ * Check if performance logging is enabled.
+ * Toggle in DevTools console: `window.__PERF_LOG__ = true` to enable.
+ */
+export declare function isPerfLogEnabled(): boolean;
 /**
  * Search match result for a row
  */
@@ -21,9 +26,9 @@ export interface PreprocessedRow {
     _searchMatch: SearchMatchResult;
     _cellBgColors: Record<string, string>;
     _bgColor?: string;
+    _isTopLevelEntity?: boolean;
     _isEmpty?: boolean;
     _isGroup?: boolean;
-    _rowReadonly?: boolean;
     _parentHasLink?: boolean;
     _pathId?: string;
     _originalPathId?: string | number;
@@ -42,7 +47,23 @@ export interface PreprocessedRow {
  */
 export declare function expandProxyRow(row: Record<string, any>, headerKeys?: string[]): Record<string, any>;
 /**
- * Calculate write/read permissions for each column
+ * Calculate per-cell canEdit permissions for each column.
+ *
+ * This is the SINGLE source of truth for whether a cell is editable.
+ * Cell.readonly in arthub-table is simply `!_permissions[key]`.
+ *
+ * Rules (in priority order):
+ * 1. Special rows (isSeparateRow, isEmpty, isGroup, isAddTask) → all false
+ * 2. When writePermissionInfo exists:
+ *    - header.canEdit=false → false
+ *    - parentHasLink → false
+ *    - deliverable_review column → false
+ *    - writePermissionInfo[key]=false or filterMatched=false → false
+ *    - isLink columns → false
+ *    - otherwise → !!writePermissionInfo[key]
+ * 3. When writePermissionInfo does NOT exist → default true (editable)
+ *    - header.canEdit=false → false
+ *    - isLink columns → false
  */
 export declare function calculatePermissions(row: Record<string, any>, headers: ITableHeader[]): Record<string, boolean>;
 /**
@@ -61,66 +82,78 @@ export declare function calculateSearchMatch(row: Record<string, any>, searchMat
  * Calculate background color for a cell based on highlighted properties
  */
 export declare function calculateRowBgColor(row: Record<string, any>, key: string, highlightedProperties: Record<string, string>): string | undefined;
+export declare function resetPerfAccum(): void;
+export declare function dumpPerfAccum(): void;
 /**
  * Preprocess a single row for DataGrid consumption
  */
-export declare function preprocessRow(rawRow: Record<string, any>, headers: ITableHeader[], props: Record<string, any>): PreprocessedRow;
 /**
- * Preprocess a single row with full style and index computation.
+ * Pre-computed context for batch processing.
+ * Created once in convertToDataGridRows and reused for every row.
+ */
+export interface PrecomputedContext {
+    headerKeys: string[];
+}
+export declare function preprocessRow(rawRow: Record<string, any>, headers: ITableHeader[], props: Record<string, any>, precomputed?: PrecomputedContext): PreprocessedRow;
+/**
+ * 批量将原始行数据转换为 DataGrid 预处理后的行数据
  *
- * Combines preprocessRow + preprocessRowStyles + _tableIndex assignment into a
- * single convenience function for incremental (single-row) updates.
+ * 对每一行调用 preprocessRow 进行展开代理、权限计算、错误收集、
+ * 搜索匹配、单元格值转换等预处理操作。
  *
- * @param rawRow - The raw row data object (may be a Proxy)
- * @param headers - Column header definitions
- * @param props - Controller props (searchMatchList, highlightedProperties, etc.)
- * @param options.rowIndex - The zero-based row index (used for row class name)
- * @param options.columnsLength - Total number of columns (used by preprocessRowStyles)
- * @param options.controllerProps - Additional controller props for style computation
- * @param options.tableIndex - Optional explicit _tableIndex to set (avoids recounting)
- * @returns A fully preprocessed row ready for DataGrid consumption
- */
-export declare function preprocessSingleRow(rawRow: Record<string, any>, headers: ITableHeader[], props: Record<string, any>, options: {
-    rowIndex: number;
-    columnsLength: number;
-    controllerProps: Record<string, any>;
-    tableIndex?: number;
-}): PreprocessedRow;
+ * @param tableDataList - 原始行数据列表
+ * @param allHeaders - 所有列头配置
+ * @param props - 业务 props（含 resolver、搜索列表等）
+ * @returns 预处理后的行数据数组
+ */
+export declare function convertToDataGridRows(tableDataList: Record<string, any>[], allHeaders: ITableHeader[], props: Record<string, any>): PreprocessedRow[];
+/**
+ * 对指定列重新执行 transformCellValues，更新已预处理行数据中的值
+ *
+ * 用于增量列刷新场景：当某些列的数据或配置变化时，只需重新转换这些列的值，
+ * 而不必对所有行做全量 preprocessRow。
+ *
+ * @param preprocessedData - 已预处理的行数据数组（会被就地修改）
+ * @param rawDataList - 原始行数据列表（用于读取最新的原始值）
+ * @param colKeys - 需要刷新的列 key 列表
+ * @param allHeaders - 所有列头配置
+ * @param props - 业务 props
+ */
+export declare function refreshColumnCellValues(preprocessedData: PreprocessedRow[], rawDataList: Record<string, any>[], colKeys: string[], allHeaders: ITableHeader[], props: Record<string, any>): void;
 /**
- * Convert AssetMatrix tableDataList to DataGrid rows
+ * [Optimization B] Async time-sliced version of refreshColumnCellValues.
+ * Processes rows in batches, yielding to the main thread between batches
+ * to prevent long tasks from blocking UI interactions (scrolling, input).
  *
- * @param tableDataList - Raw row data from AssetMatrix
- * @param headers - Column headers for context
- * @param props - Controller props (searchMatchList, highlightedProperties, etc.)
- * @returns Preprocessed rows ready for DataGrid
+ * @param batchSize - Number of rows to process per batch (default 200)
+ * @returns Promise that resolves when all rows have been processed
  */
-export declare function convertToDataGridRows(tableDataList: Record<string, any>[], headers: ITableHeader[], props: Record<string, any>): PreprocessedRow[];
+export declare function refreshColumnCellValuesAsync(preprocessedData: PreprocessedRow[], rawDataList: Record<string, any>[], colKeys: string[], allHeaders: ITableHeader[], props: Record<string, any>, batchSize?: number): Promise<void>;
 /**
- * 为预处理后的行数据计算 Stage 分组标志位
+ * 计算 Stage 分组标志位
  *
- * 复刻 DOM 表格 FillerCellRenderController.setTableStageShowMode 的判断逻辑：
- * - `_isChildStage`: 该行是某个顶层 Stage 的子环节
- * - `_isFirstChildStage`: 该行是子环节分组的第一行
- * - `_isLastChildStage`: 该行是子环节分组的最后一行
+ * 遍历所有行，对 Stage 类型的行计算 isChildStage、isFisrtChildStage、
+ * isLastChildStage 标志位，用于 Canvas 表格的父子区分显示。
  *
- * @param data - convertToDataGridRows 返回的预处理行数据数组
- * @param getTopParentStageByPath - 业务层提供的回调，沿 path 向上回溯查找最顶层 Stage 祖先
+ * @param data - 预处理后的行数据数组（会被就地修改）
+ * @param getTopParentStageByPath - 根据 path 获取顶层父 Stage 的函数
  */
 export declare function computeStageFlags(data: PreprocessedRow[], getTopParentStageByPath: (path: any[]) => any): void;
 /**
- * 增量刷新已预处理行数据中指定列的值
- *
- * 仅对 colKeys 对应的列重新执行 transformCellValues 逻辑，
- * 不重新展开 Proxy 行、不重算权限/错误/搜索匹配/背景色，
- * 性能开销 O(rows × colKeys.length)，远低于全量 preprocessRow。
+ * 单行预处理（含样式计算）
  *
- * 使用场景：异步数据（如 upstreamField、thumbnail、files 等）回填后，
- * 只需更新目标列的显示值，不影响其他列。
+ * 与 preprocessRow 类似，但额外执行样式预处理和序号分配，
+ * 用于增量更新单行场景。
  *
- * @param preprocessedData - 已预处理的行数据（由 convertToDataGridRows 生成的，DataGrid 正在使用的数据）
- * @param rawDataList - 原始行数据（AssetMatrix 的 tableTaskList / tableDataList）
- * @param colKeys - 需要刷新的列 key 数组（如 ['upstream_reminder_state']）
- * @param headers - 列头配置（需要用来查找 viewer 类型）
- * @param props - 业务 props（包含 resolver 函数等）
+ * @param rawRow - 原始行数据
+ * @param allHeaders - 所有列头配置
+ * @param props - 业务 props
+ * @param options - 额外选项（行索引、列数、序号等）
+ * @returns 预处理后的行数据
  */
-export declare function refreshColumnCellValues(preprocessedData: PreprocessedRow[], rawDataList: Record<string, any>[], colKeys: string[], headers: ITableHeader[], props: Record<string, any>): void;
+export declare function preprocessSingleRow(rawRow: Record<string, any>, allHeaders: ITableHeader[], props: Record<string, any>, options: {
+    rowIndex: number;
+    columnsLength: number;
+    controllerProps: Record<string, any>;
+    tableIndex?: number;
+}): PreprocessedRow;

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

@@ -12,6 +12,8 @@ export interface RowStyleResult {
     _tapdBgColor?: string;
     _isFirstLeft?: boolean;
     _firstLeftColor?: string;
+    _demandChangeType?: 'add' | 'cancel';
+    _isTopLevelEntity?: boolean;
 }
 /**
  * Get row-level CSS class name based on row type and index

package/dist/types/assets/icon/defaultAvatar.d.ts

@@ -2,4 +2,4 @@
  * 默认头像 - base64 编码的 PNG 图片
  * 对齐 AssetMatrix 中 StaticImageUrl，用于人员头像加载失败时的兜底显示
  */
-export declare const DEFAULT_AVATAR_URL = "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAGQAAABkCAYAAABw4pVUAAAABGdBTUEAALGPC/xhBQAABVVJREFUeAHtnNtvVFUUxtdMZ6adaYehtEIKBbk1LUjVKgWDgCGhISQghECCL5KY+OSb/D/CG6kmJsYYJQGRcJFULiIYUlFQbhoDHUpnqL1Mx7OalGSaZnPO2btrrZ2s/TLt7Mv69vc741z22W3io6P3q6BFjANJMUpUyLQDCkTYgaBAFIgwB4TJ0QxRIMIcECZHM0SBCHNAmBzNEAUizAFhcjRDFIgwB4TJ0QxRIMIcECZHM0SBCHNAmBzNEAUizAFhcjRDFIgwB4TJ0QxRIMIcECZHM0SBCHNAmBzNEGFAUsL0hJbTtiQF77yVg/UdDbC4NQV1waH1pFiBew/H4fqt/+DazVGoVEIPJ6ahd0Ay6QTs37UA+rY3QTKZqDGyvS0J7W1p2LKxER4PTUL/18Nw9cZoTRvpvyR82tu7fGkaPjnSAq+0hD+Ovvx2GL45PSKdwwt93lxDWprr4NOPWyPBwFke2F2At1/Pvpiw9B+8AfLhwWZYkK+L5efh9wuQitc1VjybTl4AWdmehg2dDbHnuWhhCtaurI/dn7KjF0B6uu1POV1rFYizA2vZkrT1WKtWZKzHoBjAiwxJOlA56w6ZwttYMRxMNVbcSJ3Kz6citZ+rccnBGHON6/o7L4AUh+0fuYtP7cdwbf5c43kBZMiBmU8cjDGXga6/Ew8kEayObHozZz3v3jey0+td1gPN8wDigSwOlkk619jfsnasqp9ehJxnP62HFw8EM8RZcTmWM1G1A4kHUirb32HNTNnlWDNjuv6UDyS4XZ2YsP9nExOTVRgpuYPrGsTMeOKBoNDBO2MzemN/Dv5hP0bs4BE6egHk+OdFuHz9eYRp1Tb9Keh7rH+o9kuhv3kBBB8ML12LD2Tg51F4+kz+6QqPES+AoNDf/xyHajX6tQT73L7rx+nKKyB4Qb51O7qx2MeHiznCwOJNhqDYk2ejvxv/7ofofTAWV/EKyM3BMfjxavhrycXLZfj1t+hZxQUD43oFBAWfuVDCj1Dl7KVyqHaSGnkHJMrLKqfLLkTUvAMSxeTZG+mIPLUK4x2QKCZHgWflosPOXgHB01Xn6vBL8d1dDYBbT30qXmwlzWQSsLU3B7vey0ProvDbSBHESLkC318ow5mLJS+eR0QDwe2jO7Y0wfbNjdCYs0tmXO0dCJZfTgd3aX89mBCbNOKApIME6F6Xnc4IPOVEuWaEdfnuvXE4N1CGK8HOeGnvSEQAWddRDz2vZeHVYMvoimUZsvP+1FQV/v53MlgnG4Mrv4yKeIhkBYLvyj/YV4DlS2XsKrz/aBxOfDUMnO9OWIDgXzsd2luAnVubICHs3hRXh0+dL8EXwR/7VBhW7O2ulGFP2rPaHTnUDH3b8uJgoEw8QFAbauQo5EB278jDu72NHHONFBM1olbqQgqkuVAHe/voJxnXVNSKmikLKZA9O/NQnyENaeUlakXNlIXMHVzC2NxjvyWU0hyMhZopl1/IgGwIHvKyDWThnHFDzaidqpA51OVgfy6VKbPjUGonA4JP4b4WSu1kQHAXu6+FUjsZkJzlai0nTErtZEAe/SN3yftlsB8SaicD8ll/EXDxLs7uw5cZNl/1qBU1Hwu0UxWWxUWqyfkYhyxDfDSHQ7MC4XDdEFOBGMzhqFIgHK4bYioQgzkcVQqEw3VDTAViMIejSoFwuG6IqUAM5nBUKRAO1w0xFYjBHI4qBcLhuiGmAjGYw1GlQDhcN8RUIAZzOKoUCIfrhpgKxGAOR5UC4XDdEFOBGMzhqFIgHK4bYioQgzkcVQqEw3VDTAViMIejSoFwuG6IqUAM5nBUKRAO1w0x/wfkhw8Kl6ANEgAAAABJRU5ErkJggg==";
+export declare const DEFAULT_AVATAR_URL = "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAGQAAABkCAYAAABw4pVUAAAABGdBTUEAALGPC/xhBQAABVVJREFUeAHtnNtvVFUUxtdMZ6adaYehtEIKBbk1LUjVKgWDgCGhISQghECCL5KY+OSb/D/CG6kmJsYYJQGRcJFULiIYUlFQbhoDHUpnqL1Mx7OalGSaZnPO2btrrZ2s/TLt7Mv69vc761z22W3io6P3q6BFjANJMUpUyLQDCkTYgaBAFIgwB4TJ0QxRIMIcECZHM0SBCHNAmBzNEAUizAFhcjRDFIgwB4TJ0QxRIMIcECZHM0SBCHNAmBzNEAUizAFhcjRDFIgwB4TJ0QxRIMIcECZHM0SBCHNAmBzNEGFAUsL0hJbTtiQF77yVg/UdDbC4NQV1waH1pFiBew/H4fqt/+DazVGoVEIPJ6ahd0Ay6QTs37UA+rY3QTKZqDGyvS0J7W1p2LKxER4PTUL/18Nw9cZoTRvpvyR82tu7fGkaPjnSAq+0hD+Ovvx2GL45PSKdwwt93lxDWprr4NOPWyPBwFke2F2At1/Pvpiw9B+8AfLhwWZYkK+L5efh9wuQitc1VjybTl4AWdmehg2dDbHnuWhhCtaurI/dn7KjF0B6uu1POV1rFYizA2vZkrT1WKtWZKzHoBjAiwxJOlA56w6ZwttYMRxMNVbcSJ3Kz6citZ+rccnBGHON6/o7L4AUh+0fuYtP7cdwbf5c43kBZMiBmU8cjDGXga6/Ew8kEayObHozZz3v3jey0+td1gPN8wDigSwOlkk619jfsnasqp9ehJxnP62HFw8EM8RZcTmWM1G1A4kHUirb32HNTNnlWDNjuv6UDyS4XZ2YsP9nExOTVRgpuYPrGsTMeOKBoNDBO2MzemN/Dv5hP0bs4BE6egHk+OdFuHz9eYRp1Tb9Keh7rH+o9kuhv3kBBB8ML12LD2Tg51F4+kz+6QqPES+AoNDf/xyHajX6tQT73L7rx+nKKyB4Qb51O7qx2MeHiznCwOJNhqDYk2ejvxv/7ofofTAWV/EKyM3BMfjxavhrycXLZfj1t+hZxQUD43oFBAWfuVDCj1Dl7KVyqHaSGnkHJMrLKqfLLkTUvAMSxeTZG+mIPLUK4x2QKCZHgWflosPOXgHB01Xn6vBL8d1dDYBbT30qXmwlzWQSsLU3B7vey0ProvDbSBHESLkC318ow5mLJS+eR0QDwe2jO7Y0wfbNjdCYs0tmXO0dCJZfTgd3aX89mBCbNOKApIME6F6Xnc4IPOVEuWaEdfnuvXE4N1CGK8HOeGnvSEQAWddRDz2vZeHVYMvoimUZsvP+1FQV/v53MlgnG4Mrv4yKeIhkBYLvyj/YV4DlS2XsKrz/aBxOfDUMnO9OWIDgXzsd2luAnVubICHs3hRXh0+dL8EXwR/7VBhW7O2ulGFP2rPaHTnUDH3b8uJgoEw8QFAbauQo5EB278jDu72NHHONFBM1olbqQgqkuVAHe/voJxnXVNSKmikLKZA9O/NQnyENaeUlakXNlIXMHVzC2NxjvyWU0hyMhZopl1/IgGwIHvKyDWThnHFDzaidqpA51OVgfy6VKbPjUGonA4JP4b4WSu1kQHAXu6+FUjsZkJzlai0nTErtZEAe/SN3yftlsB8SaicD8ll/EXDxLs7uw5cZNl/1qBU1Hwu0UxWWxUWqyfkYhyxDfDSHQ7MC4XDdEFOBGMzhqFIgHK4bYioQgzkcVQqEw3VDTAViMIejSoFwuG6IqUAM5nBUKRAO1w0xFYjBHI4qBcLhuiGmAjGYw1GlQDhcN8RUIAZzOKoUCIfrhpgKxGAOR5UC4XDdEFOBGMzhqFIgHK4bYioQgzkcVQqEw3VDTAViMIejSoFwuG6IqUAM5nBUKRAO1w0x/wfkhw8Kl6ANEgAAAABJRU5ErkJggg==";

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

@@ -33,6 +33,12 @@ declare class Body {
     private rowAccessTime;
     private maxCacheSize;
     constructor(grid: DataGrid, data: RowData[]);
+    /**
+     * Clear all row caches (Row objects + LRU access times).
+     * Called when group dimension changes to force re-creation of all rows
+     * with updated styles (background colors, color bars, borders, etc.)
+     */
+    clearRowCache(): void;
     paint(data: RowData[]): void;
     /**
      * CTRL+V 粘贴
@@ -51,7 +57,7 @@ declare class Body {
     handleCheckHeader(): void;
     mouseMove(x: number, y: number): void;
     mouseDown(x: number, y: number, shiftKey?: boolean): void;
-    click(x: number, y: number, clientX?: number, clientY?: number): void;
+    click(x: number, y: number, clientX?: number, clientY?: number, event?: MouseEvent): void;
     dbClick(x: number, y: number): void;
     /**
      * Check if double click hits a viewer with onDblClick handler

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

@@ -37,9 +37,12 @@ declare class Cell extends Context {
     fillColor?: string;
     borderWidth?: number;
     nestedGrid?: NestedGrid;
-    private hasNestedData;
-    private nestedConfig?;
-    private nestedColumns?;
+    /** @internal 是否有嵌套数据待创建（Body.tryAdoptNestedGrids 需要访问） */
+    hasNestedData: boolean;
+    /** @internal 嵌套配置（Body.tryAdoptNestedGrids 需要访问） */
+    nestedConfig?: any;
+    /** @internal 嵌套列配置（Body.updateRowByIndex 需要访问） */
+    nestedColumns?: any[];
     viewerType?: string;
     viewerData?: CellViewerData;
     useViewer?: boolean;
@@ -56,6 +59,16 @@ declare class Cell extends Context {
      * 仅在首次绘制时创建，避免构造函数中的大量对象创建
      */
     private createNestedGridLazy;
+    /**
+     * 性能优化：从旧 Cell 迁移已有的 NestedGrid 实例（避免重建）。
+     *
+     * 当 Body.paint() 重建 Row/Cell 时，如果嵌套数据未变化，
+     * 可以通过此方法直接复用旧 Cell 的 NestedGrid 实例，跳过重建。
+     *
+     * @param oldNestedGrid 旧 Cell 上的 NestedGrid 实例
+     * @param dataChanged 嵌套数据是否发生了变化（如果变化了，需要 updateData）
+     */
+    adoptNestedGrid(oldNestedGrid: NestedGrid, dataChanged: boolean): void;
     /**
      * Build viewer data from cell properties
      */

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

@@ -30,8 +30,24 @@ declare class ColumnHeader extends Context {
         width: number;
         height: number;
     } | null;
+    convertMeta: string;
     constructor(grid: DataGrid, index: number, x: number, y: number, width: number, height: number, column: Column);
     isVisibleOnScreen(): boolean;
     draw(): void;
+    /**
+     * 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.
+     */
+    private _isLastNestedChild;
+    /**
+     * Check if this column header's right edge is shared with another nested column's left edge.
+     * Used to split the shared border into two 1px lines with different colors.
+     */
+    private _isRightEdgeSharedWithNestedColumn;
+    /**
+     * Check if this column header's left edge is shared with another nested column's right edge.
+     * Used to split the shared border into two 1px lines with different colors.
+     */
+    private _isLeftEdgeSharedWithNestedColumn;
 }
 export default ColumnHeader;