@taocompany/magic-grid 0.7.6 → 0.8.0

package/README.md

@@ -11,6 +11,7 @@
   - [核心概念：source 与 display](#核心概念source-与-display)
   - [前置配置](#行移动前置配置)
   - [平铺表：UI 拖拽与 API](#平铺表ui-拖拽与-api)
+  - [步进换序 moveUp / moveDown](#步进换序-moveup--movedown)
   - [分组表：组内换序](#分组表组内换序)
   - [indexMode 说明](#indexmode-说明)
   - [约束与常见失败原因](#约束与常见失败原因)
@@ -208,11 +209,13 @@ MagicGrid 支持**编程式 API**与**索引列 UI 拖拽**两种方式调整行
 
 | 概念 | 含义 | 消费端如何观察 |
 |------|------|----------------|
-| **source 顺序** | 业务数据在内存中的存储顺序 | `gridRef.getData()` 或 `api.getData()` 返回的数组下标 |
-| **display 顺序** | 经过分组/树形/sort/filter 后，屏幕上看到的行顺序 | 肉眼所见；`indexMode: 'display'` 的 `toIndex` 指此顺序 |
-| **rowsToDisplay** | 内核内部的可见行列表（含 groupHeader、tree 节点等） | 不直接暴露；`toIndex` 在分组表中含 **groupHeader / groupFooter** 行 |
+| **source 顺序** | 业务数据在内存中的存储顺序 | `getData()` 下标 · `RowNode.sourceIndex` · `snapshot.sourceIndex` · `getRowIndex(id)` 默认 |
+| **display 顺序** | sort/filter/分组后屏幕可见顺序 | `RowNode.rowIndex` · `snapshot.rowIndex` · `getRowIndex(id, { type: 'display' })` |
+| **rowsToDisplay** | 内核可见行列表（含 groupHeader 等） | 不直接暴露；分组表 `indexMode:'display'` 的 `toIndex` 含 header/footer |
 
-**重要**：分组表下 source 可以交错（如研发部行 1、5、7 在 source 中不相邻），界面仍按 `department` 聚合展示。组内换序只改变 source 中同组 leaf 的相对位置，**不会**把行移到另一组。
+**分组表 source 序**：开启 `rowGrouping` 后，`setData` / 事务 / 分组键配置变更触发的全量 refresh 前，source 会按分组键 **collation 归一化**（组间 `groupComparator`，组内稳定相对顺序）。因此稳态下 `getData()` 已是「组块 + 组内序」，**不是**长期交错的 raw 数组。展开/折叠（map-only refresh）**不会**重排 source。
+
+组内换序只改变 source 中同组 leaf 的相对位置，**不会**把行移到另一组（跨组须改分组字段值）。
 
 ### 行移动前置配置
 
@@ -255,10 +258,33 @@ if (rowIds.length > 0) {
 ```
 
 `moveRows` **不读取** checkbox 选区（`rowSelection`）。若需按 checkbox 选中移动，请 `generateSelectedRowIds(getSelectedRows())`。
-**勿**将 `indexFocusChanged` 事件的 `focusedRowIds`（临时行为 `null`）直接传给 `moveRows`。
+**勿**将 `indexFocusChanged` 的 `focusedRowIds`（临时行为 `null`）直接传给 `moveRows`；请用 `getIndexFocusedRowIds()` 或 `generateFocusedRowIds(focusedRows)`。
 
 返回值 `RowMoveResult`：`{ moved: true, fromIndex, toIndex, moves? }` 或 `{ moved: false, reason }`。失败时 **不修改** source，不 emit `row-moved`。
 
+### 步进换序 moveUp / moveDown
+
+一行代码在相邻行之间步进换序，返回移动后的 `RowSnapshot`；边界或行不存在时 `null`。
+
+| 表形态 | 步进范围 | 内部坐标 |
+|--------|----------|----------|
+| 平铺表 | 全局 source 邻居 | `indexMode: 'source'` |
+| 分组表 | 同 `leafGroupPathKey` 组内 leaf | `indexMode: 'source'`（collation 后的 source 子序列） |
+| 树形表 | 同父兄弟 | `indexMode: 'display'`（可见兄弟邻居） |
+
+```ts
+import { generateRowId } from '@taocompany/magic-grid'
+
+const row = api.getIndexFocusedRows()[0]
+if (!row) return
+
+const snapshot = api.moveUp(generateRowId(row))   // 上移一位
+// api.moveDown(generateRowId(row))              // 下移一位
+// snapshot?.sourceIndex · snapshot?.rowIndex    // 移动后的下标
+```
+
+Playground：`/docs/row-move-step`（平铺）· `/docs/row-move-step-grouped`（分组）。
+
 ### 分组表：组内换序
 
 开启 `rowGrouping` 后，行移动**限定在同一分组下的数据行（leaf）**内，不可跨组、不能通过 drag/API 改分组字段。
@@ -277,45 +303,49 @@ if (rowIds.length > 0) {
 />
 ```
 
-**组内上移一步**（`indexMode: 'display'`）：
+**推荐**：组内步进用上一节的 `moveUp` / `moveDown`（无需手算邻居下标）。
+
+**高级**：`moveRow` / `moveRows` + `indexMode: 'display'`（与 UI drag 同语义）：
 
 ```ts
 const rowIds = api.getIndexFocusedRowIds()
 if (rowIds.length === 0) return
 
-// rowIds 须同属一组 leaf；toIndex 为 leader 行移动后的可见下标（含 groupHeader）
-api.moveRows({
-  rowIds,
-  leaderRowId: rowIds[0],
-  toIndex: leaderDisplayIndex - 1, // leader 移动后的可见下标；须自行解析，见下文说明
-  indexMode: 'display',
-})
+const rowId = rowIds[0]!
+const department = api.getData().find((r) => String(r.id) === String(rowId))?.department
+const groupLeaves = api.getData().filter((r) => r.department === department)
+const pos = groupLeaves.findIndex((r) => String(r.id) === String(rowId))
+const neighbor = groupLeaves[pos - 1] // 上移时
+if (!neighbor) return
+
+const toIndex = api.getRowIndex(neighbor.id, { type: 'display' })
+if (toIndex == null) return
+
+api.moveRow(rowId, toIndex, 'display')
 ```
 
 跨组时返回 `{ moved: false, reason: 'cannot move rows across groups' }`。
 
-**解析 display 下标**：Grid API 暂不暴露「按 rowId 查可见行下标」。实现上移/下移按钮时，可读取表格 mount 区域内 `.mg-row[data-row-id]` 的 DOM 顺序作为 display 下标（含 `mg-row--group-header` 行）；或自行维护 rowId → displayIndex 映射。
+完整示例：Playground `/docs/row-move-grouped`。
 
 ### indexMode 说明
 
 | 值 | `toIndex` 含义 | 适用场景 |
 |----|----------------|----------|
-| `'source'`（默认） | source 数组下标 | 平铺表、sort 激活时仍可用 |
-| `'display'` | 当前可见行下标（含 groupHeader 等） | 平铺表按肉眼顺序移动；**分组表组内换序推荐** |
+| `'source'`（默认） | source 数组下标（分组表 = collation 归一化后的序） | 平铺表、分组表组内换序 |
+| `'display'` | 当前可见行下标（含 groupHeader 等） | 按肉眼可见顺序移动；分组表 `moveRow` 高级用法 |
 
-sort 激活时 **`display` 模式会被拒绝**（返回 `reason` 含 `sort`）；此时请用 `source` 模式或先 `setSortModel([])`。
+**sort 或 filter 激活时**：`moveRow` / `moveRows` / `moveUp` / `moveDown` 与 managed **拖拽 handle 全部不可用**；须先 `clearAllFilters()` / `setSortModel([])`。
 
 ### 约束与常见失败原因
 
 | 场景 | 行为 |
 |------|------|
-| **sort 激活** | `indexMode: 'display'` 拒绝；`source` 仍可用 |
-| **filter 激活** | 无「只改 display 不改 source」；display 模式映射后仍写 source |
+| **sort 或 filter 激活** | managed 拖拽 handle 隐藏；`moveRow` / `moveRows` / `moveUp` / `moveDown` 全部拒绝 |
 | **行分组** | 须同一组 leaf；不可跨组 |
 | **树形** | 须同一父节点下兄弟；跨父 reorder 仅 UI hierarchy drag + deferred commit |
-| **rowDragManaged + sort（平铺）** | drag handle 隐藏；**API 仍可用**（`source` 模式） |
 
-常见 `reason`：`no rows to move` · `display index mode is not allowed while sort is active` · `selected rows must belong to the same group` · `cannot move rows across groups` · `selected rows must belong to the same tree parent`
+常见 `reason`：`row move is not allowed while sort or filter is active` · `no rows to move` · `selected rows must belong to the same group` · `cannot move rows across groups` · `selected rows must belong to the same tree parent`
 
 ### 事件
 
@@ -2237,7 +2267,7 @@ payload 为 `SelectionChangedEvent`：
 | 字段 | 类型 | 说明 |
 |------|------|------|
 | `selectedRowIds` | `BusinessRowId[]` | 业务 id 列表；**临时行均为 `null`**，不可用于删除 |
-| `selectedRows` | `SelectedRowSnapshot[]` | 完整快照（含 `internalRowId`）；**删除临时行请用此字段** |
+| `selectedRows` | `RowSnapshot[]` | 完整快照（含 `internalRowId`）；**删除临时行请用此字段** |
 
 也可通过 `api.getSelectedRows()` / `api.getSelectedRowIds()` 同步读取。
 
@@ -2247,14 +2277,15 @@ payload 为 `SelectionChangedEvent`：
 
 | 同步读取 | 用途 |
 |----------|------|
-| `api.getIndexFocusedRows()` | 展示（含 `data`、`internalRowId`） |
-| `api.getIndexFocusedRowIds()` | 传给 `moveRows`（含临时行） |
+| `index-focus-changed` → `focusedRows` | 展示、配合 `generateFocusedRowIds` 移动 |
+| `api.getIndexFocusedRowIds()` | 直接传给 `moveRows` |
 
 payload `IndexFocusChangedEvent`：
 
 | 字段 | 类型 | 说明 |
 |------|------|------|
-| `focusedRowIds` | `BusinessRowId[]` | 业务投影；**临时行 `null`**，不可直接传 `moveRows` |
+| `focusedRowIds` | `BusinessRowId[]` | 业务投影；临时行 `null` |
+| `focusedRows` | `RowSnapshot[]` | 完整快照（含 `internalRowId`）；**推荐** |
 
 #### `cell-focused`
 
@@ -2738,6 +2769,7 @@ async function addRow() {
 | `promoteRowId(options)` | `{ rowId, businessId }` | `PromoteRowIdResult` | 临时 id 提升为正式主键 |
 | `moveRow(rowId, toIndex, indexMode?)` | rowId / 目标下标 / `'source'\|'display'` | `RowMoveResult` | 编程式移动单行；见 [行移动](#行移动) |
 | `moveRows(options)` | `MoveRowsGridApiOptions` | `RowMoveResult` | 编程式批量移动行块；见 [行移动](#行移动) |
+| `moveUp(rowId)` / `moveDown(rowId)` | `RowId` | `RowSnapshot \| null` | 步进上移/下移；见 [步进换序](#步进换序-moveup--movedown) |
 
 #### 排序 / 筛选
 
@@ -2791,6 +2823,13 @@ async function addRow() {
 | `getCellSpan(rowId, colId)` | — | `CellSpanInfo \| null` | 查询 span 信息 |
 | `ensureIndexVisible(index, position?)` | position 默认 `'middle'` | `void` | 滚动使行下标进入视口 |
 | `getRowNode(id)` | rowId | `RowNode \| undefined` | 按 id 获取行节点 |
+| `getRowIndex(rowId, options?)` | rowId · `type?` | `number \| null` | 默认 source；`type: 'display'` 为可见下标 |
+| `getRowIndexes(rowIds, options?)` | rowId[] · `type?` | `RowIndexMap` | 批量版 |
+| `getRowByIndex(index)` | display 下标 | `RowSnapshot \| null` | display 下标 → 快照 |
+| `getRowsByIndexes(indexes)` | display 下标[] | `RowSnapshot[]` | 批量版；跳过无效下标 |
+| `getRowKind(rowId)` | rowId | `RowKind \| null` | 行种类：`BUSINESS` / `GROUP_HEADER` / `GROUP_FOOTER` / `DETAIL`；快照无此字段，需 `generateRowId(row)` 后查询 |
+| `getSiblingRowsByRowId(rowId, options)` | direction · length · iterator · includeStop | `RowSnapshot[]` | 相邻可见行（不含锚点）；iterator 每步须 next |
+| `getSiblingRowByIterator(rowId, options)` | direction · iterator | `RowSnapshot \| null` | next(false) 时返回边界行 |
 | `getMetrics()` | — | `GridMetrics` | 读取渲染与滚动指标 |
 | `getPendingFrameTaskCount()` | — | `number` | RAF 队列待处理任务总数 |
 | `getPendingRendererTaskCount()` | — | `number` | f1 队列待处理 cellRenderer 任务数 |
@@ -2831,11 +2870,11 @@ async function addRow() {
 | `toggleAllSelection(selected?)` | 仅 multiple 模式 | `void` | 表头全选操作；`false` 仅取消可见可选行，保留 disabled 已选行 |
 | `clearRowSelection(options?)` | `ClearRowSelectionOptions` | `void` | 清空行 checkbox 选中；变更时 emit `selectionChanged` |
 | `getSelectedRowIds()` | — | `BusinessRowId[]` | 业务 id；临时行为 `null` |
-| `getSelectedRows()` | — | `SelectedRowSnapshot[]` | 含 `internalRowId`；删除临时行推荐 |
+| `getSelectedRows()` | — | `RowSnapshot[]` | 含 `internalRowId`；删除临时行推荐 |
 | `removeSelectedRows(options?)` | `{ scope? }` | `Promise<RowNodeTransaction>` | 删除 checkbox 选中行（含临时行） |
 | `setIndexFocus(rowIds, options?)` | `SetIndexFocusOptions` | `void` | 编程式设置索引列辅助定位，不进入鼠标拖拉；变更时 emit `indexFocusChanged` |
 | `getIndexFocusedRowIds(options?)` | `RowListOptions` | `RowId[]` | focus 行 id；默认 `mode: 'all'`，可传 `moveRows` |
-| `getIndexFocusedRows(options?)` | `RowListOptions` | `SelectedRowSnapshot[]` | focus 行快照（含 `data`） |
+| `getIndexFocusedRows(options?)` | `RowListOptions` | `RowSnapshot[]` | focus 行快照（含 `data`） |
 
 **`clearRowSelection`**
 
@@ -4012,7 +4051,9 @@ import type { ColumnSettingsMenuIconName } from '@taocompany/magic-grid/types/co
 
 - `toggleHeaderSort`
 - `toBusinessRowId`、`toBusinessRowIdFromInternal`、`toBusinessRowIdsFromInternal`、`isSyntheticRow`
-- `generateSelectedRowIds`（将 `SelectedRowSnapshot[]` 转为 `removeRows` 可用的 id 列表）
+- `generateSelectedRowIds`（多行快照 → mutation API id）
+- `generateRowId`（单行快照 → mutation API id；规则同上）
+- `generateFocusedRowIds`（索引 focus 多行快照 → `moveRows` 可用 id）
 - `evaluateGridAcceptance`、`getGridAcceptanceThresholds`、`getGridSetDataLimit`（性能验收）
 - `RowMutationPersistError`
 

package/dist/components/MagicGrid/MagicGrid.vue.d.ts

@@ -701,7 +701,7 @@ declare const __VLS_base: DefineComponent<ExtractPropTypes<{
     "row-click": (event: RowClickedEvent<RowData>) => any;
     "row-dblclick": (event: RowDoubleClickedEvent<RowData>) => any;
     "selection-changed": (event: SelectionChangedEvent<RowData>) => any;
-    "index-focus-changed": (event: IndexFocusChangedEvent) => any;
+    "index-focus-changed": (event: IndexFocusChangedEvent<RowData>) => any;
     "cell-value-changed": (event: CellValueChangedEvent<RowData, unknown>) => any;
     "cell-editing-started": (event: CellEditingStartedEvent<RowData, unknown>) => any;
     "cell-editing-stopped": (event: CellEditingStoppedEvent<RowData, unknown>) => any;
@@ -1360,7 +1360,7 @@ declare const __VLS_base: DefineComponent<ExtractPropTypes<{
     "onRow-click"?: ((event: RowClickedEvent<RowData>) => any) | undefined;
     "onRow-dblclick"?: ((event: RowDoubleClickedEvent<RowData>) => any) | undefined;
     "onSelection-changed"?: ((event: SelectionChangedEvent<RowData>) => any) | undefined;
-    "onIndex-focus-changed"?: ((event: IndexFocusChangedEvent) => any) | undefined;
+    "onIndex-focus-changed"?: ((event: IndexFocusChangedEvent<RowData>) => any) | undefined;
     "onCell-value-changed"?: ((event: CellValueChangedEvent<RowData, unknown>) => any) | undefined;
     "onCell-editing-started"?: ((event: CellEditingStartedEvent<RowData, unknown>) => any) | undefined;
     "onCell-editing-stopped"?: ((event: CellEditingStoppedEvent<RowData, unknown>) => any) | undefined;

package/dist/core/api/gridApi.d.ts

@@ -13,12 +13,16 @@ import { CellSpanInfo } from '../types/cellSpan';
 import { RowData } from '../../types/core.ts';
 import { Grid } from '../grid/grid';
 import { MoveRowsGridApiOptions } from '../types/rowDrag';
+import { RowSnapshot, RowListOptions } from '../types/selectedRowSnapshot';
 import { Column } from '../types/column';
 import { ColumnFilterValueOption } from '../filter/filterSetValue';
 import { ColumnResizeSource } from '../types/columnResize';
 import { SizeColumnsToFitParams } from '../types/columnAutosize';
 import { UpdateRowDimensionsParams } from '../types/rowHeight';
-import { SelectedRowSnapshot, RowListOptions } from '../types/selectedRowSnapshot';
+import { GetSiblingRowsByRowIdOptions, GetSiblingRowByIteratorOptions } from '../row/getSiblingRowsByRowId';
+import { RowKind } from '../types/rowExpansion';
+import { GetRowIndexOptions } from '../row/getRowIndex';
+import { RowIndexMap } from '../row/getRowIndexes';
 import { CellComment, RefreshCellCommentsParams } from '../types/cellComment';
 import { CellRange } from '../types/cellRangeSelection';
 import { CellSelectionAggregation } from '../types/cellSelectionAggregation';
@@ -47,8 +51,11 @@ export interface RowMutationGridApi {
      * - 省略 `data[rowKey]` 或值为 `null` 时生成**临时行**（`RowNode.id = __MG_TMP__::*`）；
      *   `getData()` 导出时对应字段为 `null`。
      * - 带有效 `rowKey` 的新增行视为持久化行，须保证主键唯一。
+     * - `index` / `indexMode` 语义同 {@link getRowIndex}（默认 source）；最终写入 source 存储。
      * - 配置 `asyncRowMutation.add` 时 await 服务端成功后再写入本地。
      *
+     * @see {@link getRowIndex} 下标主文档（source / display · `sourceIndex` / `rowIndex`）
+     *
      * @returns 本次变更涉及的 RowNode 快照（add / remove / update）
      */
     addRows(options: AddRowsOptions): Promise<RowNodeTransaction>;
@@ -56,7 +63,7 @@ export interface RowMutationGridApi {
      * 按 rowId 和/或行下标删除行。
      *
      * - `rowIds`：内核 id 或业务主键值（number / string 均可）。
-     * - `indexes`：配合 `indexMode` 使用 `'source'`（存储顺序）或 `'display'`（排序/filter 后可见顺序）。
+     * - `indexes`：配合 `indexMode`（默认 `'source'`）；语义同 {@link getRowIndex}。
      * - 删除正在编辑的行会先取消编辑；选区 / 索引定位 / 校验反馈会同步清理。
      * - 配置 `asyncRowMutation.remove` 时 await 服务端成功后再删除本地。
      *
@@ -92,23 +99,59 @@ export interface RowMutationGridApi {
      */
     promoteRowId(options: PromoteRowIdOptions): PromoteRowIdResult;
     /**
-     * 编程式移动行（Phase 15）。
+     * 编程式移动行。始终改写 **source** 存储顺序；`indexMode` 仅解释 `toIndex` 入参。
+     *
+     * **sort 或 filter（含 quick filter）激活时**：与 {@link moveRows}、{@link moveUp}、managed 拖拽一样 **全部拒绝**。
      *
-     * - `indexMode: 'source'`（默认）按 source 存储顺序移动。
-     * - `indexMode: 'display'` 按当前 display 顺序移动；sort 激活时拒绝。
-     * - managed UI drag 成功时 emit `rowMoved`（`source: 'uiRowDrag'`）；API 调用为 `'api'`。
+     * @see docs/43-move-rows-api.md
+     * @see src/core/row/getRowIndex.ts — source / display 下标说明
      */
     moveRow(rowId: RowId, toIndex: number, indexMode?: RowIndexMode): RowMoveResult;
     /**
      * 编程式批量移动行（保持 source 内相对顺序）。
      *
+     * **sort 或 filter 激活时**全部拒绝（见 {@link moveRow}）。
+     *
      * - `rowIds.length === 1` 时等价于 {@link moveRow}。
      * - `leaderRowId` 省略时取 `rowIds` 在 source 中最早出现的行。
-     * - 成功时为块内每一行 emit `rowMoved`（`source: 'api'`）。
      *
      * @see docs/43-move-rows-api.md
      */
     moveRows(options: MoveRowsGridApiOptions): RowMoveResult;
+    /**
+     * 在存储顺序中将行上移一位。
+     *
+     * | 表形态 | 步进范围 | 内部坐标 |
+     * |--------|----------|----------|
+     * | 平铺表 | 全局 source 邻居 | `indexMode: 'source'` |
+     * | 分组表 | 同 `leafGroupPathKey` 组内 leaf | `indexMode: 'source'`（collation 归一化后的子序列） |
+     * | 树形表 | 同父兄弟 | `indexMode: 'display'`（可见兄弟邻居） |
+     *
+     * **rowId**：业务 id 或内核 id（含 `__MG_TMP__::*` 临时行）。
+     *
+     * sort 或 filter 激活时与 {@link moveRow} 相同，全部拒绝。
+     *
+     * @returns 移动后的行快照；行不存在、已在边界或 sort/filter 激活时 `null`
+     */
+    moveUp(rowId: RowId): RowSnapshot | null;
+    /**
+     * 在存储顺序中将行下移一位（语义同 {@link moveUp}）。
+     */
+    moveDown(rowId: RowId): RowSnapshot | null;
+    /**
+     * 批量步进上移（保持块内相对顺序）。
+     *
+     * - `rowIds` 接受业务 id 或内核 id（含 `__MG_TMP__::*` 临时行）。
+     * - `rowIds.length === 1` 时语义同 {@link moveUp}，返回单元素数组或 `[]`。
+     * - sort 或 filter 激活时与 {@link moveUp} 相同，全部拒绝并返回 `[]`。
+     *
+     * @returns 移动后的行快照（source 序）；行不存在、已在边界或 sort/filter 激活时 `[]`
+     */
+    moveUps(rowIds: readonly RowId[]): RowSnapshot[];
+    /**
+     * 批量步进下移（语义同 {@link moveUps}）。
+     */
+    moveDowns(rowIds: readonly RowId[]): RowSnapshot[];
 }
 /**
  * Magic Grid 完整命令式 API（对照 AG Grid GridApi 子集）。
@@ -271,6 +314,106 @@ export interface GridApi extends RowMutationGridApi {
      * @param id 业务主键或内核 id（number / string）；不存在时返回 `undefined`
      */
     getRowNode(id: RowId): RowNode | undefined;
+    /**
+     * 按行 id 获取相邻可见行快照（`rowsToDisplay` 顺序；**不含锚点**）。
+     *
+     * 快照结构同 `getSelectedRows` / `focusedRows`。rowId 规则同 {@link getRowIndex}。
+     *
+     * | 选项 | 说明 |
+     * |------|------|
+     * | `direction` | `'prev'` 上一行 · `'next'` 下一行 |
+     * | `length` | 默认 `1`；`-1` 取该方向全部（iterator 可提前终止） |
+     * | `iterator` | `({ currentRow, row, next })`；每步须 `next()` 或 `next(false)`，未调用视为终止 |
+     * | `includeStop` | 默认 `false`；`next(false)` 时是否纳入终止行 |
+     *
+     * 锚点不可见时返回 `[]`。
+     *
+     * @example
+     * ```ts
+     * const [nextRow] = api.getSiblingRowsByRowId(2, { direction: 'next' })
+     *
+     * // 向上收集同部门行（含首个不同部门行）
+     * api.getSiblingRowsByRowId(anchorId, {
+     *   direction: 'prev',
+     *   length: -1,
+     *   includeStop: true,
+     *   iterator: ({ currentRow, row, next }) => {
+     *     if (String(currentRow.data.dept) !== String(row.data.dept)) {
+     *       next(false)
+     *       return
+     *     }
+     *     next()
+     *   },
+     * })
+     * ```
+     */
+    getSiblingRowsByRowId(rowId: RowId, options: GetSiblingRowsByRowIdOptions): RowSnapshot[];
+    /**
+     * 沿 `direction` 遍历相邻行，返回 **`next(false)` 终止时** 的 `currentRow` 快照。
+     *
+     * 与 {@link getSiblingRowsByRowId} 共用 iterator 签名；差异在于终止时**返回**该行而非收集数组。
+     * 每个候选行须调用 `next()` 或 `next(false)`，未调用视为终止。
+     *
+     * | 场景 | 返回值 |
+     * |------|--------|
+     * | 某候选行上 `next(false)` | 该行 `RowSnapshot` |
+     * | 遍历结束仍未终止 | `null` |
+     * | 锚点不可见 | `null` |
+     *
+     * @example
+     * ```ts
+     * const boundary = api.getSiblingRowByIterator(anchorId, {
+     *   direction: 'next',
+     *   iterator: ({ currentRow, row, next }) => {
+     *     if (String(currentRow.data.dept) !== String(row.data.dept)) {
+     *       next(false)
+     *       return
+     *     }
+     *     next()
+     *   },
+     * })
+     * ```
+     */
+    getSiblingRowByIterator(rowId: RowId, options: GetSiblingRowByIteratorOptions): RowSnapshot | null;
+    /**
+     * 解析行的展示种类（{@link RowKind}）。
+     *
+     * | 返回值 | 含义 |
+     * |--------|------|
+     * | `'BUSINESS'` | 用户业务数据行（含 `__MG_TMP__::*` 临时行） |
+     * | `'GROUP_HEADER'` / `'GROUP_FOOTER'` | 分组合成行 |
+     * | `'DETAIL'` | 主从详情 overlay |
+     * | `null` | 行不存在或当前不可见 |
+     *
+     * **rowId**：业务 id 或内核 id；从 {@link RowSnapshot} 取 id 时用 `generateRowId(row)`。
+     * 快照本身**不含** `rowKind`，需调用本 API。
+     *
+     * @example
+     * ```ts
+     * import { generateRowId, type RowKind } from '@taocompany/magic-grid'
+     *
+     * api.on('indexFocusChanged', (event) => {
+     *   const row = event.focusedRows[0]
+     *   if (!row) return
+     *   const kind: RowKind | null = api.getRowKind(generateRowId(row))
+     *   if (kind !== 'BUSINESS') return
+     *   // 仅对业务数据行执行业务逻辑
+     * })
+     * ```
+     */
+    getRowKind(rowId: RowId): RowKind | null;
+    /**
+     * 按 rowId 查下标。完整说明（source vs display、与快照字段对齐）见 `src/core/row/getRowIndex.ts`。
+     *
+     * @see getRowIndexes — 批量版
+     */
+    getRowIndex(rowId: RowId, options?: GetRowIndexOptions): number | null;
+    /** 批量 {@link getRowIndex}；返回 `RowIndexMap`（id 原样作 key） */
+    getRowIndexes(rowIds: readonly RowId[], options?: GetRowIndexOptions): RowIndexMap;
+    /** display 下标 → 快照；与 `getRowIndex(id, { type: 'display' })` 互逆。越界 → `null` */
+    getRowByIndex(index: number): RowSnapshot | null;
+    /** 批量 {@link getRowByIndex}；跳过无效下标 */
+    getRowsByIndexes(indexes: readonly number[]): RowSnapshot[];
     /**
      * 读取当前渲染与滚动指标（验收 / 调试用途）。
      *
@@ -422,10 +565,13 @@ export interface GridApi extends RowMutationGridApi {
     /**
      * 读取当前 checkbox 选中的完整快照。
      *
-     * 含 `internalRowId`（临时行 `__MG_TMP__::*`），删除临时行、展示选中项时推荐使用。
+     * 含 `internalRowId`（临时行 `__MG_TMP__::*`）、`sourceIndex`（source 下标）、
+     * `rowIndex`（display 下标），删除临时行、展示选中项时推荐使用。
      * 配合 {@link generateSelectedRowIds} 可转为 `removeRows({ rowIds })` 入参。
+     *
+     * @see {@link getRowIndex} 下标主文档
      */
-    getSelectedRows(): SelectedRowSnapshot[];
+    getSelectedRows(): RowSnapshot[];
     /**
      * 读取索引列 focus 行 id，可直接传给 `moveRows({ rowIds })`。
      *
@@ -438,14 +584,14 @@ export interface GridApi extends RowMutationGridApi {
      * | `'business'` | 仅持久化行业务 id |
      * | `'temp'` | 仅临时行 internalRowId |
      *
-     * > 勿用 `indexFocusChanged.focusedRowIds`（临时行 `null`）代替本方法。
+     * > 也可在 `indexFocusChanged` 回调中用 `generateFocusedRowIds(focusedRows)`。
      */
     getIndexFocusedRowIds(options?: RowListOptions): RowId[];
     /**
      * 读取索引列 focus 行快照（结构同 {@link getSelectedRows}）。
      *
      * `options.mode` 与 {@link getIndexFocusedRowIds} 相同。每项含
-     * `rowId`、`internalRowId`、`isTransient`、`rowIndex`、`data`。
+     * `rowId`、`internalRowId`、`isTransient`、`sourceIndex`（source 下标）、`rowIndex`（display 下标）、`data`。
      *
      * @example
      * ```ts
@@ -456,7 +602,7 @@ export interface GridApi extends RowMutationGridApi {
      * api.moveRows({ rowIds: api.getIndexFocusedRowIds(), toIndex: 0 })
      * ```
      */
-    getIndexFocusedRows(options?: RowListOptions): SelectedRowSnapshot[];
+    getIndexFocusedRows(options?: RowListOptions): RowSnapshot[];
     /**
      * 设置索引列辅助定位（`IndexFocusService`），不触发鼠标拖拉。
      *

package/dist/core/api/gridApi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gridApi.d.ts","sourceRoot":"","sources":["../../../src/core/api/gridApi.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"gridApi.d.ts","sourceRoot":"","sources":["../../../src/core/api/gridApi.ts"],"names":[],"mappings":"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"}

package/dist/core/event/projectGridEvent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"projectGridEvent.d.ts","sourceRoot":"","sources":["../../../src/core/event/projectGridEvent.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,oBAAoB,EAC1B,MAAM,2BAA2B,CAAA;AAKlC,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AA8BrE,gDAAgD;AAChD,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,aAAa,EACtD,IAAI,EAAE,CAAC,EACP,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,oBAAoB,GACxB,YAAY,CAAC,CAAC,CAAC,CAwUjB"}
+{"version":3,"file":"projectGridEvent.d.ts","sourceRoot":"","sources":["../../../src/core/event/projectGridEvent.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,oBAAoB,EAC1B,MAAM,2BAA2B,CAAA;AAKlC,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AA8BrE,gDAAgD;AAChD,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,aAAa,EACtD,IAAI,EAAE,CAAC,EACP,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,oBAAoB,GACxB,YAAY,CAAC,CAAC,CAAC,CAyUjB"}

package/dist/core/grid/grid.d.ts

@@ -31,13 +31,17 @@ import { CellEditorFn } from '../types/cellEditor';
 import { RowId, RowIdInput } from '../types/rowId';
 import { MoveRowsGridApiOptions } from '../types/rowDrag';
 import { BusinessRowId } from '../types/businessRowId';
-import { RowListOptions, SelectedRowSnapshot } from '../types/selectedRowSnapshot';
+import { RowListOptions, RowSnapshot } from '../types/selectedRowSnapshot';
 import { ClearCellValidationOptions, ClearRowValidationOptions, ClearValidationOptions, ValidateCellsOptions, ValidateGridOptions, ValidateRowsOptions } from '../types/validation';
 import { AddRowsOptions, GetDataOptions, PromoteRowIdOptions, PromoteRowIdResult, RemoveRowsOptions, RowIndexMode } from '../types/rowMutation';
 import { RowData, ColumnFilterValueOption, GridValidationResult } from '../../types/core.ts';
 import { GridMetrics } from './gridMetrics';
 import { GridInitOptions } from './gridOptions';
 import { ColumnAutosizeGridOptions, SizeColumnsToFitParams } from '../types/columnAutosize';
+import { GetSiblingRowsByRowIdOptions, GetSiblingRowByIteratorOptions } from '../row/getSiblingRowsByRowId';
+import { RowKind } from '../types/rowExpansion';
+import { GetRowIndexOptions } from '../row/getRowIndex';
+import { RowIndexMap } from '../row/getRowIndexes';
 import { ColumnPinSource } from '../types/columnPin';
 export type { GridMetrics, GridAcceptanceThresholds } from './gridMetrics';
 export { evaluateGridAcceptance, getGridAcceptanceThresholds, getGridSetDataLimit, } from './gridMetrics';
@@ -185,12 +189,12 @@ export declare class Grid {
     toggleAllSelection(selected?: boolean): void;
     clearRowSelection(options?: ClearRowSelectionOptions): void;
     getSelectedRowIds(): BusinessRowId[];
-    getSelectedRows(): SelectedRowSnapshot[];
+    getSelectedRows(): RowSnapshot[];
     removeSelectedRows(options?: ClearRowSelectionOptions): Promise< RowNodeTransaction>;
     /** @see GridApi.getIndexFocusedRowIds */
     getIndexFocusedRowIds(options?: RowListOptions): RowId[];
     /** @see GridApi.getIndexFocusedRows */
-    getIndexFocusedRows(options?: RowListOptions): SelectedRowSnapshot[];
+    getIndexFocusedRows(options?: RowListOptions): RowSnapshot[];
     isRowNodeSelectable(rowNode: RowNode): boolean;
     getSelectableRowIdAt(index: number): string | undefined;
     getSummaryOptions(): Readonly<SummaryOptions & {
@@ -201,6 +205,24 @@ export declare class Grid {
     on<T extends GridEventType>(type: T, handler: GridEventHandler<T>): () => void;
     emitGridLifecycleEvent<T extends GridLifecycleEventType>(type: T, event: GridEventMap[T]): void;
     getRowNode(id: RowId): RowNode | undefined;
+    /** @see GridApi.getSiblingRowsByRowId */
+    getSiblingRowsByRowId(rowId: RowId, options: GetSiblingRowsByRowIdOptions): RowSnapshot[];
+    /** @see GridApi.getSiblingRowByIterator */
+    getSiblingRowByIterator(rowId: RowId, options: GetSiblingRowByIteratorOptions): RowSnapshot | null;
+    /** @see GridApi.getRowKind */
+    getRowKind(rowId: RowId): RowKind | null;
+    /** @see GridApi.getRowIndex */
+    getRowIndex(rowId: RowId, options?: GetRowIndexOptions): number | null;
+    /** @see GridApi.getRowIndexes */
+    getRowIndexes(rowIds: readonly RowId[], options?: GetRowIndexOptions): RowIndexMap;
+    /** @see GridApi.getRowByIndex */
+    getRowByIndex(index: number): RowSnapshot | null;
+    /** @see GridApi.getRowsByIndexes */
+    getRowsByIndexes(indexes: readonly number[]): RowSnapshot[];
+    /** display 行查询 API 共用上下文 */
+    private getResolveDisplayRowContext;
+    /** getRowIndex / getRowIndexes 共用上下文（含 sourceRows） */
+    private getResolveRowIndexContext;
     ensureIndexVisible(index: number, position?: EnsureIndexVisiblePosition): void;
     ensureColumnVisible(colIndex: number): void;
     setData(data: readonly RowData[]): void;
@@ -246,6 +268,16 @@ export declare class Grid {
     moveRow(rowId: RowId, toIndex: number, indexMode?: RowIndexMode): RowMoveResult;
     /** Phase 15 · 批量改 source / display 行序（保持块内相对顺序） */
     moveRows(options: MoveRowsGridApiOptions): RowMoveResult;
+    /** 步进上移一行；详见 {@link GridApi.moveUp} 表形态说明 */
+    moveUp(rowId: RowId): RowSnapshot | null;
+    /** 步进下移一行；sort/filter 激活时返回 null */
+    moveDown(rowId: RowId): RowSnapshot | null;
+    /** 批量步进上移；保持块内 source 相对顺序，详见 {@link GridApi.moveUps} */
+    moveUps(rowIds: readonly RowId[]): RowSnapshot[];
+    /** 批量步进下移；语义同 {@link moveUps} */
+    moveDowns(rowIds: readonly RowId[]): RowSnapshot[];
+    private moveRowsByStep;
+    private moveRowByStep;
     /** Phase 15 · 设单行高并 pinned */
     setRowHeight(rowId: RowId, height: number, finished?: boolean): void;
     /** Phase 15 · 批量设行高 */
@@ -365,6 +397,7 @@ export declare class Grid {
         rowHeightMax?: number;
     }): void;
     private isRowDragHandleEnabled;
+    private isSortOrFilterActive;
     getData(options?: GetDataOptions): RowData[];
     promoteRowId(options: PromoteRowIdOptions): PromoteRowIdResult;
     beginUpdate(): void;