@taocompany/magic-grid 0.8.0 → 0.9.1

package/dist/types/core.d.ts

@@ -30,6 +30,7 @@ export declare interface AsyncRowMutationAddParams {
     }>;
     index?: number;
     indexMode?: RowIndexMode;
+    /** 可用于监听取消（如 Grid destroy 或新一轮 commit） */
     signal: AbortSignal;
 }
 
@@ -44,14 +45,105 @@ export declare interface AsyncRowMutationAddResultRow {
     data?: RowData;
 }
 
-/** 异步行变更持久化钩子（GridOptions.asyncRowMutation） */
+/**
+ * 异步行变更持久化钩子（GridOptions / MagicGrid `asyncRowMutation`）。
+ *
+ * ## 消费端怎么用
+ *
+ * 配置任意钩子后，对应 API **先 await 钩子成功**，再改本地 source；钩子 `throw RowMutationPersistError` 则本地不变。
+ *
+ * | 钩子 | 触发的 API / 交互 |
+ * |------|-------------------|
+ * | `add` | `addRows` |
+ * | `update` | `updateRows` / `applyTransaction({ update })` |
+ * | `remove` | `removeRows` |
+ * | `move` | `moveRow` / `moveRows` / `moveUp` / `moveDown` / `moveUps` / `moveDowns` / **索引列拖拽**（见下） |
+ *
+ * ## move 与拖拽
+ *
+ * - **编程式 move**（`source: 'api'`）：有 `move` 钩子时 await 后再改序；await 期间索引列 loading。
+ * - **索引列拖拽**：有 `move` 钩子时 mouseup 后 await；索引列白底 + 居中 spinner（与 API move 一致）。
+ * - **updateRows / removeRows**：有对应钩子时 await 期间索引列 loading。
+ * - **索引列 loading 前提**：须 `showIndexColumn: true`（建议 `indexColumn.showRowDragHandle: true` 若需拖拽演示）。
+ * - 无需额外配置 `rowDragCommitMode`（已移除）；是否 async 只看有没有 `move`。
+ *
+ * @example 平铺表 · 拖拽与 API 共用一套持久化
+ * ```ts
+ * asyncRowMutation: {
+ *   move: async ({ rowIds, moves, source, signal }) => {
+ *     await api.reorder({ rowIds, moves, fromDrag: source === 'uiRowDrag' })
+ *   },
+ * }
+ * ```
+ *
+ * @example 树形 · hierarchyChanges 持久化（`moves` 可能为空）
+ * ```ts
+ * import { getRowDragCommitHierarchy, RowMutationPersistError } from '@taocompany/magic-grid/types/core'
+ *
+ * move: async (params) => {
+ *   if (params.hierarchyChanges?.length) {
+ *     const changes = getRowDragCommitHierarchy(params, 'noLevel')
+ *     await api.saveTreeOrder({ changes })
+ *     return
+ *   }
+ *   await api.reorder({ moves: params.moves })
+ * }
+ * ```
+ */
 export declare interface AsyncRowMutationHandlers {
-    /** 新增：await 服务端成功后 apply 本地；reject 则不写入 */
+    /** 新增：成功后 apply 本地；reject 则不写入 */
     add?: (params: AsyncRowMutationAddParams) => Promise<AsyncRowMutationAddResult | void>;
-    /** 更新：await 服务端成功后 apply 本地；reject 则不写入 */
+    /** 更新：成功后 apply 本地；reject 则不写入 */
     update?: (params: AsyncRowMutationUpdateParams) => Promise<void>;
-    /** 删除：await 服务端成功后 apply 本地；reject 则不删除 */
+    /** 删除：成功后 apply 本地；reject 则不删除 */
     remove?: (params: AsyncRowMutationRemoveParams) => Promise<void>;
+    /** 行序移动：见模块顶部的 move / 拖拽说明 */
+    move?: (params: AsyncRowMutationMoveParams) => Promise<void>;
+}
+
+/**
+ * `asyncRowMutation.move` 入参。
+ *
+ * `source` 区分调用来源：
+ * - `'api'`：`moveRow` / `moveRows` / `moveUp` / `moveDown` / `moveUps` / `moveDowns`
+ * - `'uiRowDrag'`：索引列 drag handle（配置了 `move` 时 mouseup 后触发）
+ *
+ * 树形 / 分组场景请同时阅读 `moves` 与 `hierarchyChanges`（见 {@link RowHierarchyChange}）。
+ */
+export declare interface AsyncRowMutationMoveParams {
+    /** 本次移动涉及的全部 rowId（含 leader 与 cascade 子树） */
+    rowIds: readonly string[];
+    /** 拖拽 leader 或 API 指定的主行 */
+    leaderRowId: string;
+    /** leader 在 source 数组的目标下标（API 入参或从 moves 推导） */
+    toIndex: number;
+    indexMode?: RowIndexMode;
+    /**
+     * source 平铺数组下标位移；**不含**树 parent 信息。
+     * 平铺 / 分组同级换序时为主要依据；树形仅改 parent 时可能为空数组。
+     */
+    moves: readonly RowMoveItem[];
+    /** 移动行的 data 快照（持久化时可直接用，无需再 getData） */
+    rows: ReadonlyArray<{
+        rowId: string;
+        data: RowData;
+    }>;
+    source: RowMoveSource;
+    signal: AbortSignal;
+    /** 仅 uiRowDrag：指针落在 display 的插入位（与 toIndex 可能不同） */
+    displayIndex?: number;
+    /**
+     * 仅 uiRowDrag / 树形：parentRowId、siblingIndex 相对变更前发生变化的行。
+     * 持久化树序时优先用 {@link getRowDragCommitHierarchy} 过滤。
+     */
+    hierarchyChanges?: readonly RowHierarchyChange[];
+    /** 仅 uiRowDrag：leader apply 后的父节点；根层 null */
+    parentRowId?: string | null;
+    /** 仅 uiRowDrag：leader 在新父下的同级序号（0-based，≠ 业务字段 order） */
+    siblingIndex?: number;
+    treeLevel?: number;
+    /** 仅 uiRowDrag：drop 意图（子级缩进区 / Alt）；≠ apply 后的 parentRowId */
+    nestUnderRowId?: string | null;
 }
 
 export declare interface AsyncRowMutationRemoveParams {
@@ -1303,25 +1395,29 @@ export declare interface GetDetailRowDataParams {
 }
 
 /**
- * 从 deferred row drag commit 上下文中提取树形层级变更列表。
+ * 从 `asyncRowMutation.move` 的树形字段中提取待持久化的层级变更。
  *
- * - `default`：返回 `context.hierarchyChanges` 的浅拷贝（含 `treeLevel` 及仅 level 变化的项）。
- * - `noLevel`：仅保留 **parentRowId 或 siblingIndex** 相对变更前发生变化的项，
- *   排除「parent / sibling 均未变、仅 treeLevel 不同」的条目。
+ * 传入 `params` 或任意含 `hierarchyChanges` 的对象即可（通常 `move` 钩子的 `params`）。
  *
- * 对接后端 `parentId` + `order` 持久化时，通常使用 `noLevel`。
+ * - `default`：返回全部 `hierarchyChanges`（含仅 treeLevel 变化的项）。
+ * - `noLevel`：仅 parent / sibling 真正变化的行（对接后端 parentId + order 时推荐）。
  *
  * @example
  * ```ts
- * import { getRowDragCommitHierarchy } from '@taocompany/magic-grid'
+ * import { getRowDragCommitHierarchy, RowMutationPersistError } from '@taocompany/magic-grid/types/core'
  *
- * const toPersist = getRowDragCommitHierarchy(context, 'noLevel')
- * for (const item of toPersist) {
- *   await api.update({ id: item.rowId, parentId: item.parentRowId, order: item.siblingIndex })
+ * asyncRowMutation: {
+ *   move: async (params) => {
+ *     const changes = getRowDragCommitHierarchy(params, 'noLevel')
+ *     if (changes.length === 0 && params.moves.length === 0) return
+ *     await api.saveOrder({ changes, moves: params.moves })
+ *   },
  * }
  * ```
  */
-export declare function getRowDragCommitHierarchy(context: RowDragCommitContext, option?: GetRowDragCommitHierarchyOption): RowHierarchyChange[];
+export declare function getRowDragCommitHierarchy(context: {
+    hierarchyChanges?: readonly RowHierarchyChange[];
+}, option?: GetRowDragCommitHierarchyOption): RowHierarchyChange[];
 
 /** {@link getRowDragCommitHierarchy} 过滤模式 */
 export declare type GetRowDragCommitHierarchyOption = 'default' | 'noLevel';
@@ -1386,7 +1482,7 @@ export declare interface GridApi extends RowMutationGridApi {
      * 增量事务：add / update / remove。
      *
      * - `update` / `remove` 项可通过 `data[rowKey]` 或字符串 rowId 定位行。
-     * - 与 `addRows` / `removeRows` 共用同一刷新管线；大量连续操作建议包在 `beginUpdate` / `endUpdate` 中。
+     * - 与 `addRows` / `updateRows` / `removeRows` 共用同一刷新管线；大量连续操作建议包在 `beginUpdate` / `endUpdate` 中。
      * - 配置 `asyncRowMutation` 时 await 对应钩子成功后再写入本地。
      *
      * @returns 本次事务影响的 RowNode 快照
@@ -1629,6 +1725,40 @@ export declare interface GridApi extends RowMutationGridApi {
     getRowByIndex(index: number): RowSnapshot | null;
     /** 批量 {@link getRowByIndex}；跳过无效下标 */
     getRowsByIndexes(indexes: readonly number[]): RowSnapshot[];
+    /**
+     * 遍历 **rowsToDisplay** 返回行快照（display 顺序，与 {@link getRowByIndex} 同坐标系）。
+     *
+     * | 入参 | 行为 |
+     * |------|------|
+     * | 省略 | 全部可见行（含分组头/尾、临时行；不含 filter 隐藏行） |
+     * | `RowSnapshotPredicate` | 仅保留谓词返回 `true` 的行 |
+     *
+     * 仅需 mutation 可用 id 时优先用 {@link getRowIds}（同谓词，免手动 `map(generateRowId)`）。
+     * 与 {@link getSelectedRows} / {@link getIndexFocusedRows} 不同：范围为全表。
+     *
+     * @example
+     * ```ts
+     * const drafts = api.getRowSnapshots((row) => row.isTransient)
+     * drafts.forEach((row) => console.log(row.data, row.rowIndex))
+     * ```
+     */
+    getRowSnapshots(predicate?: RowSnapshotPredicate): RowSnapshot[];
+    /**
+     * {@link getRowSnapshots} 的 id 投影（display 顺序、谓词语义相同）。
+     *
+     * | 行类型 | 返回值 |
+     * |--------|--------|
+     * | 持久化行 | 业务 `rowId`（`data[rowKey]`） |
+     * | 临时行 | `internalRowId`（`__MG_TMP__::*`） |
+     *
+     * 可直接传给 {@link removeRows} / {@link moveRows}，无需 `generateSelectedRowIds`。
+     *
+     * @example
+     * ```ts
+     * await api.removeRows({ rowIds: api.getRowIds((row) => row.isTransient) })
+     * ```
+     */
+    getRowIds(predicate?: RowSnapshotPredicate): RowId[];
     /**
      * 读取当前渲染与滚动指标（验收 / 调试用途）。
      *
@@ -2445,7 +2575,16 @@ export declare interface MagicGridProps<TData = RowData> {
     invalidEditValueMode?: InvalidEditValueMode;
     /** 行编辑跨字段校验 */
     rowValidator?: RowValidator;
-    /** 异步行 CRUD 持久化钩子 */
+    /**
+     * 异步行 CRUD / 行序持久化钩子。
+     *
+     * - 有 `move`：编程式 move API 与索引列拖拽均 await 成功后再改本地；拖拽 mouseup 前仅视觉预览。
+     * - 无 `move`：拖拽 mouseup 立刻改序（sync）；编程式 move 亦 sync。
+     * - update / remove / move await 期间：受影响行**索引列**显示 loading（须 `showIndexColumn: true`）。
+     * - 失败：`throw RowMutationPersistError(message)`，本地不变。
+     *
+     * @see AsyncRowMutationHandlers · AsyncRowMutationMoveParams（types/core）
+     */
     asyncRowMutation?: AsyncRowMutationHandlers;
     /** 容器高度 */
     height?: string | number;
@@ -2512,15 +2651,6 @@ export declare interface MagicGridProps<TData = RowData> {
      * 对标 AG Grid `rowDragManaged`。
      */
     rowDragManaged?: boolean;
-    /**
-     * managed 模式 commit 策略：`sync`（默认 live move）| `deferred`（mouseup 后 await onRowDragCommit）。
-     */
-    rowDragCommitMode?: RowDragCommitMode;
-    /**
-     * deferred 模式：mouseup 后、apply 前调用；返回 false 则不写 source。
-     * MagicGrid 亦支持 `:on-row-drag-commit` prop（与 Grid option 等价）。
-     */
-    onRowDragCommit?: RowDragCommitHandler;
     /**
      * 行级动态高度（无 DOM）；优先于默认 rowHeight，低于手动 setRowHeight。
      * 对标 AG Grid `getRowHeight`。
@@ -2740,6 +2870,8 @@ export declare interface MoveRowOptions {
     indexMode?: RowIndexMode;
     /** live drag 中间态为 false；mouseup 收尾为 true（默认 true） */
     finished?: boolean;
+    /** @internal asyncRowMutation.move：plan-only，不写 source、不 emit */
+    deferCommit?: boolean;
 }
 
 /**
@@ -2951,17 +3083,18 @@ export declare interface RowDoubleClickedEvent<TData = RowData> {
 }
 
 /**
- * deferred row drag · 传给 `onRowDragCommit` / `@row-drag-commit` 的上下文。
+ * 内核组装的拖拽 commit 上下文（Grid 内部使用）。
+ *
+ * 消费端在 `asyncRowMutation.move` 中收到的是 {@link AsyncRowMutationMoveParams}，
+ * 树形字段与本文档一致。本类型仍导出，供 `getRowDragCommitHierarchy` 等工具的类型引用。
  *
  * ### 持久化怎么选字段
  *
  * | 场景 | 主用字段 |
  * |------|----------|
  * | 平铺 / 纯同级换序 | `moves` |
- * | 树形改父、上移一级、下移一级、挂到子级 | `hierarchyChanges`（可用 `getRowDragCommitHierarchy(_, 'noLevel')` 排除仅 level 变化） |
- * | leader 落点快捷读 | `parentRowId` / `siblingIndex` / `treeLevel`（与 leader 的 hierarchyChange 一致） |
- *
- * `nestUnderRowId` 为 **drop 意图**（指针落在子级缩进区 / Alt）；`parentRowId` 为 **apply 后结果**。
+ * | 树形改父、上移一级、下移一级、挂到子级 | `hierarchyChanges` |
+ * | leader 落点快捷读 | `parentRowId` / `siblingIndex` / `treeLevel` |
  */
 export declare interface RowDragCommitContext {
     signal: AbortSignal;
@@ -2995,7 +3128,7 @@ export declare interface RowDragCommitContext {
     nestUnderRowId?: string | null;
 }
 
-/** deferred row drag · commit 结束（成功时随后 emit rowMoved + rowDragEnd） */
+/** await 持久化结束；`committed: true` 时随后 emit `rowMoved` + `rowDragEnd` */
 export declare interface RowDragCommitFinishedEvent {
     commitId: number;
     rowId: BusinessRowId;
@@ -3005,17 +3138,7 @@ export declare interface RowDragCommitFinishedEvent {
     reason?: string;
 }
 
-export declare type RowDragCommitHandler = (context: RowDragCommitContext) => Promise<RowDragCommitHandlerResult> | RowDragCommitHandlerResult;
-
-export declare type RowDragCommitHandlerResult = boolean | void | {
-    ok: boolean;
-    reason?: string;
-};
-
-/** managed 行拖拽 commit 策略 */
-export declare type RowDragCommitMode = 'sync' | 'deferred';
-
-/** deferred row drag · commit 开始（公开事件会投影 rowId 为 BusinessRowId） */
+/** 配置了 asyncRowMutation.move 时，拖拽 mouseup 后开始 await 持久化（公开事件会投影 rowId 为 BusinessRowId） */
 export declare interface RowDragCommitStartedEvent {
     rowId: BusinessRowId;
     rowIds: readonly BusinessRowId[];
@@ -3133,7 +3256,7 @@ export declare type RowHeightChangeSource = 'api' | 'uiRowResized' | 'autoHeight
  * 对接后端 `parentId` + `order` 时使用；`siblingIndex` 为 Grid 内部 0-based 同级序，≠ 业务字段 `order`。
  */
 export declare interface RowHierarchyChange {
-    /** 内部 rowId（deferred handler 内为 string；公开事件会投影为 BusinessRowId） */
+    /** 内部 rowId（async move 钩子内为 string；公开事件会投影为 BusinessRowId） */
     rowId: string;
     /** 变更前父节点 rowId；根层为 null */
     previousParentRowId: string | null;
@@ -3199,6 +3322,15 @@ export declare interface RowListOptions {
     mode?: RowListMode;
 }
 
+/** async defer commit 计划（内核用）；`RowMoveResult.commitPlan` 在 GridApi 返回前通常已剥离 */
+export declare interface RowMoveCommitPlan {
+    rows: RowNode[];
+    moves: readonly RowMoveItem[];
+    source: RowMoveSource;
+    finished: boolean;
+    treeDisplayInsertIndex?: number;
+}
+
 /** rowMoved 事件 */
 export declare interface RowMovedEvent {
     rowId: BusinessRowId;
@@ -3235,6 +3367,8 @@ export declare interface RowMoveResult {
     toIndex?: number;
     reason?: string;
     moves?: readonly RowMoveItem[];
+    /** plan-only（deferCommit）时携带，供 async 持久化后 commit；GridApi 返回前通常已剥离 */
+    commitPlan?: RowMoveCommitPlan;
 }
 
 export declare type RowMoveSource = 'api' | 'uiRowDrag';
@@ -3268,10 +3402,22 @@ export declare interface RowMutationGridApi {
      * - `indexes`：配合 `indexMode`（默认 `'source'`）；语义同 {@link getRowIndex}。
      * - 删除正在编辑的行会先取消编辑；选区 / 索引定位 / 校验反馈会同步清理。
      * - 配置 `asyncRowMutation.remove` 时 await 服务端成功后再删除本地。
+     * - await 期间受影响行索引列 loading（须 `showIndexColumn: true`）。
      *
      * @returns 本次删除的 RowNode 快照
      */
     removeRows(options: RemoveRowsOptions): Promise<RowNodeTransaction>;
+    /**
+     * 按 rowKey 批量更新行字段。
+     *
+     * - 每项 `data` 须含 `rowKey` 以定位持久化行；字段与现有 `row.data` 合并（Object.assign）。
+     * - 等价于 `applyTransaction({ update })`，语义更贴近 {@link addRows} / {@link removeRows}。
+     * - 配置 `asyncRowMutation.update` 时 await 服务端成功后再写入本地。
+     * - await 期间受影响行索引列 loading（须 `showIndexColumn: true`）。
+     *
+     * @returns 本次更新的 RowNode 快照
+     */
+    updateRows(options: UpdateRowsOptions): Promise<RowNodeTransaction>;
     /**
      * 删除当前 checkbox 选中的行。
      *
@@ -3279,6 +3425,7 @@ export declare interface RowMutationGridApi {
      * - 等价于 `removeRows({ rowIds: generateSelectedRowIds(getSelectedRows()) })`，但更简洁。
      * - `scope: 'all'`（默认）含离屏选中；`'current'` 仅当前 display 可见选中。
      * - 配置 `asyncRowMutation.remove` 时 await 服务端成功后再删除本地。
+     * - await 期间受影响行索引列 loading（须 `showIndexColumn: true`）。
      */
     removeSelectedRows(options?: ClearRowSelectionOptions): Promise<RowNodeTransaction>;
     /**
@@ -3305,10 +3452,13 @@ export declare interface RowMutationGridApi {
      *
      * **sort 或 filter（含 quick filter）激活时**：与 {@link moveRows}、{@link moveUp}、managed 拖拽一样 **全部拒绝**。
      *
+     * - 配置 `asyncRowMutation.move` 时 await 服务端成功后再改本地行序。
+     * - await 期间受影响行索引列 loading（须 `showIndexColumn: true`）。
+     *
      * @see docs/43-move-rows-api.md
      * @see src/core/row/getRowIndex.ts — source / display 下标说明
      */
-    moveRow(rowId: RowId, toIndex: number, indexMode?: RowIndexMode): RowMoveResult;
+    moveRow(rowId: RowId, toIndex: number, indexMode?: RowIndexMode): Promise<RowMoveResult>;
     /**
      * 编程式批量移动行（保持 source 内相对顺序）。
      *
@@ -3316,10 +3466,12 @@ export declare interface RowMutationGridApi {
      *
      * - `rowIds.length === 1` 时等价于 {@link moveRow}。
      * - `leaderRowId` 省略时取 `rowIds` 在 source 中最早出现的行。
+     * - 配置 `asyncRowMutation.move` 时 await 服务端成功后再改本地行序。
+     * - await 期间受影响行索引列 loading（须 `showIndexColumn: true`）。
      *
      * @see docs/43-move-rows-api.md
      */
-    moveRows(options: MoveRowsGridApiOptions): RowMoveResult;
+    moveRows(options: MoveRowsGridApiOptions): Promise<RowMoveResult>;
     /**
      * 在存储顺序中将行上移一位。
      *
@@ -3333,27 +3485,42 @@ export declare interface RowMutationGridApi {
      *
      * sort 或 filter 激活时与 {@link moveRow} 相同，全部拒绝。
      *
+     * - 配置 `asyncRowMutation.move` 时 await 服务端成功后再改本地行序。
+     * - await 期间受影响行索引列 loading（须 `showIndexColumn: true`）。
+     *
      * @returns 移动后的行快照；行不存在、已在边界或 sort/filter 激活时 `null`
      */
-    moveUp(rowId: RowId): RowSnapshot | null;
+    moveUp(rowId: RowId): Promise< RowSnapshot | null>;
     /**
      * 在存储顺序中将行下移一位（语义同 {@link moveUp}）。
      */
-    moveDown(rowId: RowId): RowSnapshot | null;
+    moveDown(rowId: RowId): Promise< RowSnapshot | null>;
     /**
      * 批量步进上移（保持块内相对顺序）。
      *
      * - `rowIds` 接受业务 id 或内核 id（含 `__MG_TMP__::*` 临时行）。
      * - `rowIds.length === 1` 时语义同 {@link moveUp}，返回单元素数组或 `[]`。
      * - sort 或 filter 激活时与 {@link moveUp} 相同，全部拒绝并返回 `[]`。
+     * - 配置 `asyncRowMutation.move` 时 await 服务端成功后再改本地行序（内部走 {@link moveRows}）。
+     * - await 期间受影响行索引列 loading（须 `showIndexColumn: true`）。
      *
      * @returns 移动后的行快照（source 序）；行不存在、已在边界或 sort/filter 激活时 `[]`
      */
-    moveUps(rowIds: readonly RowId[]): RowSnapshot[];
+    moveUps(rowIds: readonly RowId[]): Promise< RowSnapshot[]>;
     /**
      * 批量步进下移（语义同 {@link moveUps}）。
+     * 配置 `asyncRowMutation.move` 时同样 await 持久化后再 apply；await 期间索引列 loading（须 `showIndexColumn: true`）。
      */
-    moveDowns(rowIds: readonly RowId[]): RowSnapshot[];
+    moveDowns(rowIds: readonly RowId[]): Promise< RowSnapshot[]>;
+}
+
+/**
+ * 异步持久化失败时在 move/add/update/remove 钩子中 throw。
+ * Grid 不会 apply 本地变更；拖拽场景还会 emit `rowDragCommitFinished(committed: false)`。
+ */
+export declare class RowMutationPersistError extends Error {
+    readonly cause?: unknown | undefined;
+    constructor(message: string, cause?: unknown | undefined);
 }
 
 export declare interface RowMutationRemovedSnapshot {
@@ -3473,8 +3640,11 @@ export declare type RowSelectionInput = RowSelectionMode | false | RowSelectionC
 export declare type RowSelectionMode = 'single' | 'multiple';
 
 /**
- * 行快照——`getSelectedRows` / `getIndexFocusedRows` /
- * `selectionChanged.selectedRows` / `indexFocusChanged.focusedRows` 共用。
+ * 行快照——下列 GridApi / 事件共用同一结构：
+ *
+ * - 选区 / focus：`getSelectedRows`、`getIndexFocusedRows`、`selectionChanged`、`indexFocusChanged`
+ * - display 查询：`getRowByIndex`、`getRowsByIndexes`、`getRowSnapshots`（`getRowIds` 为其 id 投影）
+ * - 相邻行 / 步进移动：`getSiblingRowsByRowId`、`moveUp` / `moveDown` 返回值
  */
 export declare interface RowSnapshot<TData = RowData> {
     /** 业务主键；临时行恒 `null` */
@@ -3496,6 +3666,9 @@ export declare interface RowSnapshot<TData = RowData> {
     data: TData;
 }
 
+/** `getRowSnapshots` / `getRowIds` 共用谓词；返回 `true` 的行纳入结果 */
+export declare type RowSnapshotPredicate<TData = RowData> = (snapshot: RowSnapshot<TData>) => boolean;
+
 /** 纵向合并行数（≥1）；缺省视为 1；仅表体 */
 export declare type RowSpanFn = (params: CellSpanParams) => number;
 
@@ -3949,6 +4122,18 @@ export declare interface UpdateRowDimensionsParams {
     rowHeightMax?: number;
 }
 
+export declare interface UpdateRowItem {
+    /**
+     * 要合并的字段；须含 `rowKey` 以定位持久化行。
+     * 临时行可省略 rowKey，由 apply 层按 data 引用匹配（与 applyTransaction 一致）。
+     */
+    data: RowData;
+}
+
+export declare interface UpdateRowsOptions {
+    rows: UpdateRowItem[];
+}
+
 export declare interface ValidateCellsOptions {
     /** 待校验的单元格列表 */
     cells: GridCellPosition[];

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

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/types/core.ts"],"names":[],"mappings":"AAAA,mBAAmB,cAAc,CAAA;AACjC,mBAAmB,cAAc,CAAA;AAEjC,qCAAqC;AACrC,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAE1D,wDAAwD;AACxD,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC1D,6CAA6C;AAC7C,YAAY,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAE9D,gBAAgB;AAChB,YAAY,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAC9D,kBAAkB;AAClB,YAAY,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAClE,iDAAiD;AACjD,YAAY,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAA;AAC5E,+BAA+B;AAC/B,YAAY,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAA;AAC5E,kEAAkE;AAClE,YAAY,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAA;AAE/E,gBAAgB;AAChB,YAAY,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAChE,oBAAoB;AACpB,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACzD,4CAA4C;AAC5C,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAE5D,gBAAgB;AAChB,YAAY,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAC1D,kBAAkB;AAClB,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAC9D,mCAAmC;AACnC,YAAY,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAClE,2BAA2B;AAC3B,YAAY,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAC3D,2CAA2C;AAC3C,YAAY,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAC3D,cAAc;AACd,YAAY,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC/D,0BAA0B;AAC1B,YAAY,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAC1D,wBAAwB;AACxB,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAC9D,kCAAkC;AAClC,YAAY,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAA;AAEtE,wEAAwE;AACxE,YAAY,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAA;AAC5E,qFAAqF;AACrF,YAAY,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAA;AAC7E,gFAAgF;AAChF,OAAO,EAAE,6BAA6B,EAAE,MAAM,6BAA6B,CAAA;AAE3E,2CAA2C;AAC3C,YAAY,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAEhE,YAAY,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AAEtE,YAAY,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAElE,sDAAsD;AACtD,YAAY,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAEvE,qBAAqB;AACrB,YAAY,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAClE,mCAAmC;AACnC,YAAY,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AACjE,0BAA0B;AAC1B,YAAY,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AACjE,+BAA+B;AAC/B,YAAY,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAA;AAEvE;;;GAGG;AACH,YAAY,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,8CAA8C;AAC9C,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AAE7D,wBAAwB;AACxB,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAC9C,mBAAmB;AACnB,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAChD,kBAAkB;AAClB,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,kBAAkB;AAClB,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AACrD,sBAAsB;AACtB,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AACrD,2BAA2B;AAC3B,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AACxD,yCAAyC;AACzC,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AACrD,eAAe;AACf,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,oCAAoC;AACpC,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AACxD,yCAAyC;AACzC,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAEhD,iBAAiB;AACjB,YAAY,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAC1D,iBAAiB;AACjB,YAAY,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAC1D,kBAAkB;AAClB,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AACxD,gBAAgB;AAChB,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACtD,gBAAgB;AAChB,YAAY,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AACzD,gBAAgB;AAChB,YAAY,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AACzD,iBAAiB;AACjB,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AACvD,iBAAiB;AACjB,YAAY,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AACzD,iBAAiB;AACjB,YAAY,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAC1D,qBAAqB;AACrB,YAAY,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AACzD,iBAAiB;AACjB,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AACxD,iBAAiB;AACjB,YAAY,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AACzD,gBAAgB;AAChB,YAAY,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAA;AAC5D,eAAe;AACf,YAAY,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAA;AAC3D,cAAc;AACd,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,cAAc;AACd,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AACnD,2BAA2B;AAC3B,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAErD,cAAc;AACd,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AACnD,aAAa;AACb,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AACrD,mBAAmB;AACnB,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AACpD,cAAc;AACd,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AACxD,0BAA0B;AAC1B,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,6BAA6B,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAA;AACxI,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC1F,YAAY,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAC1D,YAAY,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAC/D,YAAY,EACV,8BAA8B,EAC9B,4BAA4B,EAC5B,mBAAmB,EACnB,kBAAkB,EAClB,wBAAwB,EACxB,cAAc,GACf,MAAM,iCAAiC,CAAA;AACxC,gBAAgB;AAChB,YAAY,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AACzD,4BAA4B;AAC5B,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAChD,mCAAmC;AACnC,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAClD,2DAA2D;AAC3D,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AACpD,qCAAqC;AACrC,YAAY,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAC3E,6CAA6C;AAC7C,YAAY,EAAE,+BAA+B,EAAE,MAAM,qCAAqC,CAAA;AAC1F,yEAAyE;AACzE,OAAO,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAA;AAC/E,mCAAmC;AACnC,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AACvD,8BAA8B;AAC9B,YAAY,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAA;AAC5D,8BAA8B;AAC9B,YAAY,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAA;AAE7D,aAAa;AACb,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AACxD,qBAAqB;AACrB,YAAY,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAA;AAC3D,uBAAuB;AACvB,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AACrD,gBAAgB;AAChB,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AACvD,oBAAoB;AACpB,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAEtD,mBAAmB;AACnB,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACtD,kBAAkB;AAClB,YAAY,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAA;AAC3D,kBAAkB;AAClB,YAAY,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAC1D,kBAAkB;AAClB,YAAY,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAA;AAE9D,gBAAgB;AAChB,YAAY,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAC1D,cAAc;AACd,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAC9C,wBAAwB;AACxB,YAAY,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AACzD,kBAAkB;AAClB,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAErD,gBAAgB;AAChB,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAC5C,mCAAmC;AACnC,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,aAAa;AACb,YAAY,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAA;AAC5D,qBAAqB;AACrB,YAAY,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAA;AAC9D,qBAAqB;AACrB,YAAY,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAA;AAChE,cAAc;AACd,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AACvD,wBAAwB;AACxB,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACtD,eAAe;AACf,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACtD,aAAa;AACb,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACtD,uBAAuB;AACvB,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE/C,mBAAmB;AACnB,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AACrD,mBAAmB;AACnB,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AACpD,mDAAmD;AACnD,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAC9C,uBAAuB;AACvB,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC/C,uBAAuB;AACvB,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,uBAAuB;AACvB,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAEvD,yCAAyC;AACzC,YAAY,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAA;AAC7D,wBAAwB;AACxB,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AACpD,sBAAsB;AACtB,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AACrD,0BAA0B;AAC1B,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AACpD,6BAA6B;AAC7B,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AACxD,eAAe;AACf,YAAY,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAE1D,gBAAgB;AAChB,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,0BAA0B;AAC1B,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,mBAAmB;AACnB,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAC5C,mBAAmB;AACnB,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAC5C,qBAAqB;AACrB,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC/C,gBAAgB;AAChB,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC/C,iBAAiB;AACjB,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AACnD,iBAAiB;AACjB,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAEnD,8CAA8C;AAC9C,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC/C,aAAa;AACb,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAC7C,mBAAmB;AACnB,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,mBAAmB;AACnB,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AACpD,qBAAqB;AACrB,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,uBAAuB;AACvB,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACtD,uBAAuB;AACvB,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AACrD,iBAAiB;AACjB,YAAY,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AACzD,iBAAiB;AACjB,YAAY,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAA;AAE7D,uBAAuB;AACvB,YAAY,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAA;AAC3D,kBAAkB;AAClB,YAAY,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAA;AAC5D,mBAAmB;AACnB,YAAY,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAA;AAC5D,gBAAgB;AAChB,YAAY,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAA;AAC/D,kBAAkB;AAClB,YAAY,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAA;AAC/D,kBAAkB;AAClB,YAAY,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAA;AAE/D,oBAAoB;AACpB,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,sBAAsB;AACtB,YAAY,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AACzD,4BAA4B;AAC5B,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAChD,eAAe;AACf,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,0BAA0B;AAC1B,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AACrD,aAAa;AACb,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AACxD,cAAc;AACd,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACtD,4BAA4B;AAC5B,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAErD,gBAAgB;AAChB,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAChD,yBAAyB;AACzB,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AACxD,iBAAiB;AACjB,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC/C,mCAAmC;AACnC,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACtD,kBAAkB;AAClB,YAAY,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAC1D,kBAAkB;AAClB,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AACvD,wBAAwB;AACxB,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACtD,+BAA+B;AAC/B,YAAY,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AACzD,2BAA2B;AAC3B,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AACnD,6BAA6B;AAC7B,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AACvD,mCAAmC;AACnC,YAAY,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAA;AAC7D,4BAA4B;AAC5B,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACtD,kCAAkC;AAClC,YAAY,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAA;AAC5D,gDAAgD;AAChD,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AACvD,0CAA0C;AAC1C,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAElD,wCAAwC;AACxC,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAC7D,YAAY,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAA;AACnE,YAAY,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAA;AAC1E,YAAY,EACV,sBAAsB,EACtB,4BAA4B,EAC5B,qCAAqC,EACrC,4BAA4B,EAC5B,2BAA2B,EAC3B,+BAA+B,GAChC,MAAM,4BAA4B,CAAA;AACnC,YAAY,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAA;AACtE,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AACrD,YAAY,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAA;AACxE,YAAY,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAA;AACpF,YAAY,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AACpE,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,oBAAoB,CAAA;AAC3B,YAAY,EACV,6BAA6B,EAC7B,8BAA8B,EAC9B,8BAA8B,EAC9B,8BAA8B,EAC9B,eAAe,GAChB,MAAM,2BAA2B,CAAA;AAClC,YAAY,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAA;AAClE,YAAY,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAA;AACvD,YAAY,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAChD,YAAY,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAA;AAC3F,YAAY,EACV,iBAAiB,EACjB,oBAAoB,EACpB,iCAAiC,EACjC,yBAAyB,EACzB,iBAAiB,GAClB,MAAM,yBAAyB,CAAA;AAChC,YAAY,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAA;AACpE,YAAY,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAA;AACzE,YAAY,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAA;AACxE,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAC3E,YAAY,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AACnE,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAC5D,YAAY,EAAE,2BAA2B,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAC/F,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACzD,YAAY,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AACrE,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AACzD,YAAY,EACV,eAAe,EACf,uBAAuB,EACvB,cAAc,EACd,YAAY,GACb,MAAM,6BAA6B,CAAA;AACpC,YAAY,EACV,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,6BAA6B,EAC7B,eAAe,EACf,YAAY,EACZ,kBAAkB,GACnB,MAAM,sBAAsB,CAAA;AAC7B,YAAY,EAAE,WAAW,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAA;AAClF,YAAY,EACV,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACtB,6BAA6B,GAC9B,MAAM,0BAA0B,CAAA;AACjC,YAAY,EACV,qBAAqB,EACrB,uBAAuB,EACvB,6BAA6B,EAC7B,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,yBAAyB,CAAA;AAChC,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAA;AAC3F,YAAY,EACV,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,kCAAkC,CAAA;AACzC,YAAY,EACV,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,eAAe,GAChB,MAAM,uBAAuB,CAAA;AAC9B,YAAY,EACV,oBAAoB,EACpB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,mBAAmB,GACpB,MAAM,wBAAwB,CAAA;AAE/B,cAAc;AACd,YAAY,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAA;AAChF,eAAe;AACf,YAAY,EAAE,0BAA0B,EAAE,MAAM,sDAAsD,CAAA;AAEtG,qCAAqC;AACrC,YAAY,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACzD,gBAAgB;AAChB,YAAY,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAA"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/types/core.ts"],"names":[],"mappings":"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"}

package/dist/types/core.es.js

@@ -1,2 +1,2 @@
-import { _ as e, n as t, t as n, v as r, y as i } from "../getRowDragCommitHierarchy-B3zGw38u.js";
-export { t as DEFAULT_CELL_EDITOR_CACHE_KEY, e as generateFocusedRowIds, r as generateRowId, i as generateSelectedRowIds, n as getRowDragCommitHierarchy };
+import { b as e, l as t, n, t as r, v as i, y as a } from "../getRowDragCommitHierarchy-CyevnkCp.js";
+export { n as DEFAULT_CELL_EDITOR_CACHE_KEY, t as RowMutationPersistError, i as generateFocusedRowIds, a as generateRowId, e as generateSelectedRowIds, r as getRowDragCommitHierarchy };

package/dist/types/magic-grid.d.ts

@@ -24,7 +24,6 @@ import { RowSelectionInput } from '../core/types/rowSelectionOptions';
 import { FilterSetValueMode, FilterSetDateLayoutMode } from '../core/types/filterGridOptions';
 import { AsyncRowMutationHandlers } from '../core/types/rowMutationAsync';
 import { AutoSizeStrategy } from '../core/types/columnAutosize';
-import { RowDragCommitMode, RowDragCommitHandler } from '../core/types/rowDrag';
 import { GetRowHeightFn } from '../core/types/rowHeight';
 import { IsRowMasterFn, DetailRowHeightFn, GetDetailRowDataFn, DetailCellRendererFn } from '../core/types/rowExpansion';
 import { GroupDisplayType, GroupKeyCreatorFn, GroupComparatorFn, GroupCellRendererFn } from '../core/types/rowGrouping';
@@ -76,7 +75,6 @@ export type { FilterSetValueMode, FilterSetDateLayoutMode } from '../core/types/
 export type { AsyncRowMutationHandlers } from '../core/types/rowMutationAsync';
 export type { AutoSizeStrategy } from '../core/types/columnAutosize';
 export type { StatusBarHeightInput } from '../core/theme/gridSize';
-export type { RowDragCommitMode, RowDragCommitHandler } from '../core/types/rowDrag';
 export type { GetRowHeightFn } from '../core/types/rowHeight';
 export type { IsRowMasterFn, DetailRowHeightFn, GetDetailRowDataFn, DetailCellRendererFn, } from '../core/types/rowExpansion';
 export type { GroupDisplayType, GroupKeyCreatorFn, GroupComparatorFn, GroupCellRendererFn, } from '../core/types/rowGrouping';
@@ -402,7 +400,16 @@ export interface MagicGridProps<TData = RowData> {
     invalidEditValueMode?: InvalidEditValueMode;
     /** 行编辑跨字段校验 */
     rowValidator?: RowValidator;
-    /** 异步行 CRUD 持久化钩子 */
+    /**
+     * 异步行 CRUD / 行序持久化钩子。
+     *
+     * - 有 `move`：编程式 move API 与索引列拖拽均 await 成功后再改本地；拖拽 mouseup 前仅视觉预览。
+     * - 无 `move`：拖拽 mouseup 立刻改序（sync）；编程式 move 亦 sync。
+     * - update / remove / move await 期间：受影响行**索引列**显示 loading（须 `showIndexColumn: true`）。
+     * - 失败：`throw RowMutationPersistError(message)`，本地不变。
+     *
+     * @see AsyncRowMutationHandlers · AsyncRowMutationMoveParams（types/core）
+     */
     asyncRowMutation?: AsyncRowMutationHandlers;
     /** 容器高度 */
     height?: string | number;
@@ -469,15 +476,6 @@ export interface MagicGridProps<TData = RowData> {
      * 对标 AG Grid `rowDragManaged`。
      */
     rowDragManaged?: boolean;
-    /**
-     * managed 模式 commit 策略：`sync`（默认 live move）| `deferred`（mouseup 后 await onRowDragCommit）。
-     */
-    rowDragCommitMode?: RowDragCommitMode;
-    /**
-     * deferred 模式：mouseup 后、apply 前调用；返回 false 则不写 source。
-     * MagicGrid 亦支持 `:on-row-drag-commit` prop（与 Grid option 等价）。
-     */
-    onRowDragCommit?: RowDragCommitHandler;
     /**
      * 行级动态高度（无 DOM）；优先于默认 rowHeight，低于手动 setRowHeight。
      * 对标 AG Grid `getRowHeight`。