@taocompany/magic-grid 0.12.8 → 0.13.1

package/dist/token-catalog.json

@@ -1,6 +1,6 @@
 {
-  "schemaVersion": "0.12.8",
-  "generatedAt": "2026-10-27T05:42:23.679Z",
+  "schemaVersion": "0.13.1",
+  "generatedAt": "2026-10-28T01:31:31.625Z",
   "entries": [
     {
       "token": "--mg-color-bg",

package/dist/types/core.d.ts

@@ -1699,6 +1699,7 @@ export declare interface GridApi extends RowMutationGridApi {
      *
      * - `update` / `remove` 项可通过 `data[rowKey]` 或字符串 rowId 定位行。
      * - 与 `addRows` / `updateRows` / `removeRows` 共用同一刷新管线；大量连续操作建议包在 `beginUpdate` / `endUpdate` 中。
+     * - `newData?: true` — 纯 update flush 时对更新行使用 `refreshRows({ newData: true })`（与 {@link UpdateRowsOptions.newData} 同义）。
      * - 配置 `asyncRowMutation` 时 await 对应钩子成功后再写入本地。
      *
      * @returns 本次事务影响的 RowNode 快照
@@ -3468,6 +3469,11 @@ export declare interface RefreshCellsParams {
     colIds?: string[];
     /** 忽略单元格值缓存，强制重绘 */
     force?: boolean;
+    /**
+     * 行数据对象/身份替换语义（对齐 AG `newData` → forceNewCellRendererInstance）。
+     * 与 CompIdentityKey 变并列触发 inline / renderer remount；单独 `force` 不会。
+     */
+    newData?: boolean;
 }
 
 export declare type RefreshCellStylesParams = CellStyleScopeParams;
@@ -4280,6 +4286,11 @@ export declare interface RowTransaction {
     add?: RowTransactionAddItem[];
     remove?: RowData[] | string[];
     update?: RowTransactionUpdateItem[];
+    /**
+     * 纯 update flush 时对更新行使用 `refreshRows({ newData: true })`（对齐 AG 行替换语义）。
+     * 与 {@link UpdateRowsOptions.newData} 等价；add/remove 或与 sort/filter 同批时忽略。
+     */
+    newData?: boolean;
 }
 
 export declare type RowTransactionAddItem = RowData | AddRowPayload;
@@ -4762,6 +4773,11 @@ export declare interface UpdateRowPayload {
 
 export declare interface UpdateRowsOptions {
     rows: UpdateRowItem[];
+    /**
+     * 对齐 AG 行数据替换语义：刷新更新行时使用 `refreshCells({ newData: true })`。
+     * 默认 false（仅 patch / refresh 链）。
+     */
+    newData?: boolean;
 }
 
 export declare interface ValidateCellsOptions {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taocompany/magic-grid",
-  "version": "0.12.8",
+  "version": "0.13.1",
   "description": "A high-performance virtual table component library for Vue 3",
   "type": "module",
   "license": "MIT",