@taocompany/magic-grid 0.12.6 → 0.13.0

package/dist/token-catalog.json

@@ -1,6 +1,6 @@
 {
-  "schemaVersion": "0.12.6",
-  "generatedAt": "2026-10-26T00:10:47.005Z",
+  "schemaVersion": "0.13.0",
+  "generatedAt": "2026-10-27T17:15:56.127Z",
   "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 快照
@@ -2239,6 +2240,16 @@ export declare interface GridApi extends RowMutationGridApi {
     collapseRow(rowId: RowId): boolean;
     /** 主行是否已展开。 */
     isRowExpanded(rowId: RowId): boolean;
+    /**
+     * 主动写入主行详情数据（等价于 `getDetailRowData` 的 `successCallback` 结果缓存）。
+     * 已展开时刷新详情区；未展开时可预填，后续 `expandRow` 在有缓存时不再调用 `getDetailRowData`。
+     */
+    setDetailRowData(rowId: RowId, detailRowData: unknown): boolean;
+    /**
+     * 清除主行详情 cache 并重新调用 `getDetailRowData`（已展开时保持展开并显示 loading）。
+     * 未配置 `getDetailRowData` 时返回 `false`。
+     */
+    reloadDetailRowData(rowId: RowId): boolean;
     /** 展开当前 display 中全部可展开 master 行。 */
     expandAll(): void;
     /** 折叠全部已展开主行 / 分组（取决于启用的能力）。 */
@@ -3458,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;
@@ -3754,6 +3770,8 @@ export declare interface RowHeightChangedEvent {
 export declare interface RowHeightChangeItem {
     rowId: string;
     rowHeight: number;
+    /** setRowHeights 写入前的高度（detail autoHeight 补偿 scroll 用） */
+    previousRowHeight?: number;
 }
 
 export declare type RowHeightChangeSource = 'api' | 'uiRowResized' | 'autoHeight' | 'dimensions';
@@ -4119,6 +4137,8 @@ export declare interface RowNode {
     __detailLoading?: boolean;
     /** Phase 17 · master 行：详情加载失败原因 */
     __detailLoadError?: unknown;
+    /** Phase 17 · master 行：详情加载代次（reload 时递增，忽略过期回调） */
+    __detailLoadId?: number;
     /** 用户/API 手动锁定行高后，autoHeight 不再覆盖（Phase 15） */
     rowHeightPinned?: boolean;
     /** autoHeight 各列实测高度缓存（Phase 15 · 内核字段） */
@@ -4266,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;
@@ -4748,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.6",
+  "version": "0.13.0",
   "description": "A high-performance virtual table component library for Vue 3",
   "type": "module",
   "license": "MIT",