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

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

@@ -613,6 +613,22 @@ 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;
+/**
+ * Fast-path column refresh: skips adapter-layer full-row processing entirely.
+ *
+ * Only syncs raw values from rawDataList → preprocessedData for the specified
+ * columns, then tells DataGrid to refresh cached Cells. No permission
+ * recalculation, no transformCellValues.
+ *
+ * Prerequisites:
+ * - Target columns must be "simple" (cellValueTransformer handles display conversion
+ *   at render time; transformCellValues would `continue` / skip them).
+ * - Business layer has already mutated rawDataList[i][key] with the new values.
+ *
+ * Performance: O(totalRows × colKeys) simple assignments + O(cachedRows × colKeys)
+ * Cell sync ≈ <5ms for 10000 rows (vs ~500ms+ for the full path).
+ */
+export declare function refreshDataGridColumnByKeysFast(dataGrid: any, preprocessedData: PreprocessedRow[], rawDataList: Record<string, any>[], colKeys: string[]): void;
 /**
  * [Optimization B] Async time-sliced version of refreshDataGridColumnByKeys.
  * Processes rows in batches via refreshColumnCellValuesAsync, yielding to the

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

@@ -6,4 +6,4 @@ export { ITableHeader, VIEWER_TYPE_MAP, mapHeaderToColumn, convertToDataGridColu
 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, refreshDataGridColumnByKeysAsync, refreshDataGridRowByIndex, } from './DataGridIntegration';
+export { DataGridInitOptions, DataGridCallbacks, DataGridInitResult, buildDataGridInitParams, refreshDataGridRows, refreshDataGridColumns, refreshDataGridColumnByKeys, refreshDataGridColumnByKeysAsync, refreshDataGridColumnByKeysFast, refreshDataGridRowByIndex, } from './DataGridIntegration';

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

@@ -120,6 +120,25 @@ export declare function convertToDataGridRows(tableDataList: Record<string, any>
  * @param props - 业务 props
  */
 export declare function refreshColumnCellValues(preprocessedData: PreprocessedRow[], rawDataList: Record<string, any>[], colKeys: string[], allHeaders: ITableHeader[], props: Record<string, any>): void;
+/**
+ * Fast-path column value sync: only copies raw values from rawDataList to
+ * preprocessedData for the specified columns. Skips permission recalculation
+ * and transformCellValues entirely.
+ *
+ * Prerequisites:
+ * - The target columns must be "simple" columns whose values are used as-is
+ *   by the viewer (i.e., transformCellValues would `continue` / skip them).
+ * - Value-to-display conversion is handled at render time by cellValueTransformer.
+ *
+ * Performance: O(totalRows) but only does a single property assignment per row
+ * per column key (~0.001ms/row), compared to the full refreshSingleRowColumns
+ * path which does sync + permissions + transform (~0.08ms/row).
+ *
+ * @param preprocessedData - The preprocessed row array (DataGrid's data source)
+ * @param rawDataList - The raw row array (business layer's tableTaskList)
+ * @param colKeys - Column keys to sync
+ */
+export declare function fastSyncColumnValues(preprocessedData: PreprocessedRow[], rawDataList: Record<string, any>[], colKeys: string[]): void;
 /**
  * [Optimization B] Async time-sliced version of refreshColumnCellValues.
  * Processes rows in batches, yielding to the main thread between batches

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

@@ -1770,7 +1770,7 @@ declare class DataGrid {
     setFooterCellData(columnKey: string, data: FooterCellData): void;
     /** 一次性设置指定分组组头各列的统计数据 */
     setGroupHeaderStatData(groupId: string | number, data: FooterData): void;
-    /** 设置指定分组指定列的组头统计数据 */
+    /** 设置指定分组指定列的组头统计数据（不立即重绘，使用 markDirty 批量合并） */
     setGroupHeaderStatCellData(groupId: string | number, columnKey: string, cellData: FooterCellData): void;
     /**
      * 设置所有组头行中指定列的 loading 状态

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

@@ -13,7 +13,7 @@ declare class Footer {
     get y(): number;
     /** 一次性设置所有列的统计数据 */
     setFooterData(data: FooterData): void;
-    /** 设置单列的统计数据 */
+    /** 设置单列的统计数据（不立即重绘，使用 markDirty 批量合并） */
     setFooterCellData(columnKey: string, data: FooterCellData): void;
     /** 当列结构变化时，清理已不存在列的 footer 数据 */
     cleanupFooterData(existingKeys: Set<string>): void;

package/dist/types/index.d.ts

@@ -47,5 +47,5 @@ export { preprocessRowStyles, } from './adapters/styleAdapter';
 export type { RowStyleResult, } from './adapters/styleAdapter';
 export { DataGridEventAdapter, EventCategory, extractEventContext, mapDomEventToDataGridEvent, } from './adapters/DataGridEventAdapter';
 export type { EventContext, } from './adapters/DataGridEventAdapter';
-export { buildDataGridInitParams, refreshDataGridRows, refreshDataGridColumns, refreshDataGridColumnByKeys, refreshDataGridColumnByKeysAsync, refreshDataGridRowByIndex, } from './adapters/DataGridIntegration';
+export { buildDataGridInitParams, refreshDataGridRows, refreshDataGridColumns, refreshDataGridColumnByKeys, refreshDataGridColumnByKeysAsync, refreshDataGridColumnByKeysFast, refreshDataGridRowByIndex, } from './adapters/DataGridIntegration';
 export type { DataGridInitOptions, DataGridCallbacks, DataGridInitResult, } from './adapters/DataGridIntegration';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arthub-table",
-  "version": "0.1.0-beta.21",
+  "version": "0.1.0-beta.23",
   "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",