@taocompany/magic-grid 0.13.9 → 0.14.0

package/dist/api-manifest.json

@@ -0,0 +1,2862 @@
+{
+  "manifestVersion": 1,
+  "libraryVersion": "0.14.0",
+  "generatedAt": "2026-11-03T07:33:37.560Z",
+  "props": [
+    {
+      "name": "columns",
+      "type": "ColumnDef<TData>[]",
+      "required": true,
+      "notes": "列定义"
+    },
+    {
+      "name": "data",
+      "type": "TData[]",
+      "default": "() => []",
+      "required": true,
+      "notes": "行数据"
+    },
+    {
+      "name": "rowModelType",
+      "type": "RowModelType",
+      "default": "'clientSide'",
+      "required": false,
+      "notes": "行模型：clientSide（默认）| infinite"
+    },
+    {
+      "name": "infiniteDatasource",
+      "type": "InfiniteRowDatasource",
+      "default": "undefined",
+      "required": false,
+      "notes": "infinite 模式必填：块数据源"
+    },
+    {
+      "name": "blockSize",
+      "type": "number",
+      "default": "undefined",
+      "required": false,
+      "notes": "infinite：每块行数，默认 100"
+    },
+    {
+      "name": "maxBlocksInCache",
+      "type": "number",
+      "default": "undefined",
+      "required": false,
+      "notes": "infinite：LRU 最多保留块数，默认 10"
+    },
+    {
+      "name": "infiniteInitialRowCount",
+      "type": "number",
+      "default": "undefined",
+      "required": false,
+      "notes": "infinite：未知 lastRow 时初始虚拟行数，默认 blockSize × 2"
+    },
+    {
+      "name": "infiniteMaxRetries",
+      "type": "number",
+      "default": "undefined",
+      "required": false,
+      "notes": "infinite：块加载失败自动重试次数，默认 0"
+    },
+    {
+      "name": "infiniteLoadingRowVisible",
+      "type": "boolean",
+      "default": "undefined",
+      "required": false,
+      "notes": "infinite：stub 行是否展示 loading 样式，默认 true"
+    },
+    {
+      "name": "cellEditorRegistry",
+      "type": "Record<string, CellEditorFn>",
+      "default": "undefined",
+      "required": false,
+      "notes": "Grid 实例级命名编辑器（colId 引用 cellEditor: 'name' 时解析；优先于全局注册表）"
+    },
+    {
+      "name": "rowKey",
+      "type": "string",
+      "default": "'id'",
+      "required": false,
+      "notes": "行数据主键字段名（PK），用于行池复用与增量更新"
+    },
+    {
+      "name": "stripe",
+      "type": "boolean",
+      "default": "false",
+      "required": false,
+      "notes": "斑马纹"
+    },
+    {
+      "name": "cellColor",
+      "type": "CellStyle",
+      "default": "undefined",
+      "required": false,
+      "notes": "表体默认单元格颜色（Grid 级 · 与 CellStyle 同形）。"
+    },
+    {
+      "name": "border",
+      "type": "GridBorder",
+      "default": "'border'",
+      "required": false,
+      "notes": "边框样式（默认 `border`）"
+    },
+    {
+      "name": "theme",
+      "type": "GridTheme",
+      "default": "'light'",
+      "required": false,
+      "notes": "主题 preset；默认 `light`（亮色）。"
+    },
+    {
+      "name": "size",
+      "type": "GridSize",
+      "default": "'default'",
+      "required": false,
+      "notes": "尺寸 preset；默认 `default`。"
+    },
+    {
+      "name": "rounded",
+      "type": "GridRounded",
+      "default": "false",
+      "required": false,
+      "notes": "容器圆角（px）；默认 `false`（无圆角）"
+    },
+    {
+      "name": "rowHeight",
+      "type": "number",
+      "default": "undefined",
+      "required": false,
+      "notes": "固定行高（px）；显式传入时覆盖 size preset"
+    },
+    {
+      "name": "headerHeight",
+      "type": "number",
+      "default": "undefined",
+      "required": false,
+      "notes": "表头高度（px）；显式传入时覆盖 size preset"
+    },
+    {
+      "name": "showIndexColumn",
+      "type": "boolean",
+      "default": "false",
+      "required": false,
+      "notes": "是否显示最左侧索引列；默认 false"
+    },
+    {
+      "name": "indexColumn",
+      "type": "IndexColumnOptions",
+      "default": "undefined",
+      "required": false,
+      "notes": "索引列配置；showIndexColumn=true 时生效；MagicGrid 层 syncToSelectionColumn 默认 true"
+    },
+    {
+      "name": "selectionColumn",
+      "type": "SelectionColumnOptions",
+      "default": "undefined",
+      "required": false,
+      "notes": "行选择列配置；rowSelection !== false 时生效"
+    },
+    {
+      "name": "showSummary",
+      "type": "boolean",
+      "default": "false",
+      "required": false,
+      "notes": "是否展示表尾汇总行；默认 false"
+    },
+    {
+      "name": "navigateHeader",
+      "type": "boolean",
+      "default": "false",
+      "required": false,
+      "notes": "是否允许键盘/鼠标将焦点导航到表头；默认 false"
+    },
+    {
+      "name": "navigateFooter",
+      "type": "boolean",
+      "default": "false",
+      "required": false,
+      "notes": "是否允许键盘/鼠标将焦点导航到表尾汇总行；默认 false（需 showSummary: true）"
+    },
+    {
+      "name": "summaryScope",
+      "type": "SummaryScope",
+      "default": "'displayed'",
+      "required": false,
+      "notes": "汇总计算范围；默认 `displayed`（rowsToDisplay，尊重 filter / sort）"
+    },
+    {
+      "name": "summaryRowHeight",
+      "type": "number",
+      "default": "undefined",
+      "required": false,
+      "notes": "汇总行高度（px）；未传时跟随 rowHeight / size preset"
+    },
+    {
+      "name": "summaryMethod",
+      "type": "SummaryMethod",
+      "default": "undefined",
+      "required": false,
+      "notes": "全局汇总方法（优先级高于列级 summaryAgg）"
+    },
+    {
+      "name": "headerAlign",
+      "type": "GridHorizontalAlign",
+      "default": "undefined",
+      "required": false,
+      "notes": "表头水平对齐（全局默认）；默认 center"
+    },
+    {
+      "name": "headerValign",
+      "type": "GridVerticalAlign",
+      "default": "undefined",
+      "required": false,
+      "notes": "表头垂直对齐（全局默认）；默认 center"
+    },
+    {
+      "name": "align",
+      "type": "GridHorizontalAlign",
+      "default": "undefined",
+      "required": false,
+      "notes": "表体水平对齐（全局默认）；默认 center"
+    },
+    {
+      "name": "valign",
+      "type": "GridVerticalAlign",
+      "default": "undefined",
+      "required": false,
+      "notes": "表体垂直对齐（全局默认）；默认 center"
+    },
+    {
+      "name": "footerAlign",
+      "type": "GridHorizontalAlign",
+      "default": "undefined",
+      "required": false,
+      "notes": "表尾汇总水平对齐（全局默认）；默认 center"
+    },
+    {
+      "name": "footerValign",
+      "type": "GridVerticalAlign",
+      "default": "undefined",
+      "required": false,
+      "notes": "表尾汇总垂直对齐（全局默认）；默认 center"
+    },
+    {
+      "name": "rowBuffer",
+      "type": "number",
+      "default": "10",
+      "required": false,
+      "notes": "行虚拟化缓冲行数"
+    },
+    {
+      "name": "scrollEndFlushMs",
+      "type": "number",
+      "default": "0",
+      "required": false,
+      "notes": "滚动停止后 flush RAF 队列（ms）；0 = 关闭"
+    },
+    {
+      "name": "frameBudgetMs",
+      "type": "number",
+      "default": "undefined",
+      "required": false,
+      "notes": "活跃滚动帧预算（ms），默认 60"
+    },
+    {
+      "name": "scrollEndFrameBudgetMs",
+      "type": "number",
+      "default": "undefined",
+      "required": false,
+      "notes": "scroll idle flush 帧预算；-1 = 一次跑完"
+    },
+    {
+      "name": "cellRendererDefer",
+      "type": "CellRendererDeferMode",
+      "default": "'always'",
+      "required": false,
+      "notes": "cellRenderer 调度：always | never | sync-only"
+    },
+    {
+      "name": "deferRowDestroyOnScroll",
+      "type": "boolean",
+      "default": "false",
+      "required": false,
+      "notes": "滚动 active 期间延迟行 destroy"
+    },
+    {
+      "name": "rendererFrameBudgetMs",
+      "type": "number",
+      "default": "undefined",
+      "required": false,
+      "notes": "滚动 active 时 f1 每帧保底预算（ms）；0 = 与 p1/p2 共享总预算，默认 20"
+    },
+    {
+      "name": "cellRendererPresentation",
+      "type": "CellRendererPresentation",
+      "default": "'deferred'",
+      "required": false,
+      "notes": "Vue renderer 呈现：immediate | deferred | placeholder-then-vue"
+    },
+    {
+      "name": "rowSelection",
+      "type": "RowSelectionInput",
+      "default": "'single'",
+      "required": false,
+      "notes": "行选择模式，false 禁用；对象形式支持 groupSelectsChildren"
+    },
+    {
+      "name": "selectable",
+      "type": "SelectableFn",
+      "default": "undefined",
+      "required": false,
+      "notes": "行选择列：行 checkbox 是否可勾选；函数入参含 `data` / `rowId` / `rowIndex`。"
+    },
+    {
+      "name": "isRowDisabled",
+      "type": "boolean | IsRowDisabledFn<TData>",
+      "default": "undefined",
+      "required": false,
+      "notes": "行级禁用：true 时该行全部数据列 disabled。"
+    },
+    {
+      "name": "rowStyle",
+      "type": "RowStyle<TData>",
+      "default": "undefined",
+      "required": false,
+      "notes": "行级样式：对象 = 全表同色；函数 = 按行。"
+    },
+    {
+      "name": "editableCellStyle",
+      "type": "CellStyle",
+      "default": "undefined",
+      "required": false,
+      "notes": "可编辑单元格样式（Grid 级 · 可选）。"
+    },
+    {
+      "name": "showEditableCellIcon",
+      "type": "boolean",
+      "default": "false",
+      "required": false,
+      "notes": "可编辑格左侧 pencil-line；默认 false，与 editableCellStyle 独立；inline 列不显示"
+    },
+    {
+      "name": "disabledCellStyle",
+      "type": "CellStyle",
+      "default": "undefined",
+      "required": false,
+      "notes": "禁用单元格样式（Grid 级 · 可选）。"
+    },
+    {
+      "name": "showDisabledCellIcon",
+      "type": "boolean",
+      "default": "false",
+      "required": false,
+      "notes": "disabled 格左侧 pencil-off；默认 false，与 disabledCellStyle 独立；inline 列不显示"
+    },
+    {
+      "name": "reserveSelection",
+      "type": "boolean",
+      "default": "false",
+      "required": false,
+      "notes": "行选择列：数据刷新后是否保留选中行；默认 false"
+    },
+    {
+      "name": "preserveScrollOnSetData",
+      "type": "boolean",
+      "default": "true",
+      "required": false,
+      "notes": "setData / :data 全量替换后是否保留滚动位置；默认 true"
+    },
+    {
+      "name": "defaultSelectedRows",
+      "type": "DefaultSelectedRowsInput",
+      "default": "undefined",
+      "required": false,
+      "notes": "preset 默认选中：id 数组或解析函数（`targets` / internalRowId）。"
+    },
+    {
+      "name": "editBehavior",
+      "type": "CellEditBehavior",
+      "default": "'cell'",
+      "required": false,
+      "notes": "编辑范围：cell 单格 / row 整行"
+    },
+    {
+      "name": "editType",
+      "type": "CellEditType",
+      "default": "'singleClick'",
+      "required": false,
+      "notes": "进入编辑态的触发方式，默认 singleClick"
+    },
+    {
+      "name": "editorOptions",
+      "type": "EditorOptions",
+      "default": "undefined",
+      "required": false,
+      "notes": "Grid 级编辑器外观（`:editor-options`）。"
+    },
+    {
+      "name": "invalidEditValueMode",
+      "type": "InvalidEditValueMode",
+      "default": "'block'",
+      "required": false,
+      "notes": "校验失败后：block 保持编辑 / revert 退出并恢复旧值"
+    },
+    {
+      "name": "rowValidator",
+      "type": "RowValidator",
+      "default": "undefined",
+      "required": false,
+      "notes": "行编辑跨字段校验"
+    },
+    {
+      "name": "asyncRowMutation",
+      "type": "AsyncRowMutationHandlers",
+      "default": "undefined",
+      "required": false,
+      "notes": "异步行 CRUD / 行序持久化钩子。"
+    },
+    {
+      "name": "height",
+      "type": "string | number",
+      "default": "'100%'",
+      "required": false,
+      "notes": "容器高度；number 或纯数字字符串自动补 `px`，亦支持 `100%` / `vh` 等 CSS 长度"
+    },
+    {
+      "name": "width",
+      "type": "string | number",
+      "default": "'100%'",
+      "required": false,
+      "notes": "容器宽度；number 或纯数字字符串自动补 `px`"
+    },
+    {
+      "name": "defaultSort",
+      "type": "SortModelItem[]",
+      "default": "undefined",
+      "required": false,
+      "notes": "初始排序（Grid 挂载 / initGrid 时应用一次）；当前仅使用首项"
+    },
+    {
+      "name": "sortable",
+      "type": "boolean",
+      "default": "false",
+      "required": false,
+      "notes": "列是否参与排序（sort 管线 / 表头 sort 指示器）；默认 `false`。"
+    },
+    {
+      "name": "enableHeaderSortClick",
+      "type": "boolean",
+      "default": "true",
+      "required": false,
+      "notes": "是否允许用户点击表头 / 键盘 Enter 切换排序；默认 `true`。"
+    },
+    {
+      "name": "columnMovable",
+      "type": "boolean",
+      "default": "true",
+      "required": false,
+      "notes": "是否允许用户列表头拖拽重排；默认 true（对齐 AG Grid；`:column-movable=\"false\"` 关闭）"
+    },
+    {
+      "name": "resizable",
+      "type": "boolean",
+      "default": "true",
+      "required": false,
+      "notes": "是否允许用户拖拽调整列宽；默认 `true`（对齐 AG Grid `defaultColDef.resizable`）。"
+    },
+    {
+      "name": "colResizeDefault",
+      "type": "'shift'",
+      "default": "undefined",
+      "required": false,
+      "notes": "默认 Shift 模式：拖拽列宽时相邻列反向补偿，总宽不变。"
+    },
+    {
+      "name": "skipHeaderOnAutoSize",
+      "type": "boolean",
+      "default": "false",
+      "required": false,
+      "notes": "双击 resize 把柄 auto-size 时跳过表头宽度；对标 AG Grid skipHeaderOnAutoSize"
+    },
+    {
+      "name": "autoSizePadding",
+      "type": "number",
+      "default": "undefined",
+      "required": false,
+      "notes": "auto-size 内容测量额外 padding（px）；对标 AG Grid autoSizePadding"
+    },
+    {
+      "name": "autoSizeStrategy",
+      "type": "AutoSizeStrategy",
+      "default": "undefined",
+      "required": false,
+      "notes": "挂载 / 首屏 auto-size 策略；对标 AG Grid autoSizeStrategy"
+    },
+    {
+      "name": "suppressMoveWhenColumnDragging",
+      "type": "boolean",
+      "default": "false",
+      "required": false,
+      "notes": "默认 false（drag 过程中 live move，对齐 AG Grid）。"
+    },
+    {
+      "name": "suppressColumnMoveAnimation",
+      "type": "boolean",
+      "default": "false",
+      "required": false,
+      "notes": "默认 false；true 关闭列移动 transition"
+    },
+    {
+      "name": "allowCrossLaneColumnMove",
+      "type": "boolean",
+      "default": "false",
+      "required": false,
+      "notes": "默认 false。"
+    },
+    {
+      "name": "showUnsortedSortHintOnHover",
+      "type": "boolean",
+      "default": "false",
+      "required": false,
+      "notes": "默认 false；true → 未排序 sortable 列 hover 显示 faint 双三角"
+    },
+    {
+      "name": "quickFilterText",
+      "type": "string",
+      "default": "''",
+      "required": false,
+      "notes": "Grid 级 quick filter 文本"
+    },
+    {
+      "name": "filterable",
+      "type": "boolean",
+      "default": "false",
+      "required": false,
+      "notes": "是否允许列筛选；默认 `false`。"
+    },
+    {
+      "name": "floatingFilter",
+      "type": "boolean",
+      "default": "false",
+      "required": false,
+      "notes": "表头下方 Floating Filter 行；默认 `false`"
+    },
+    {
+      "name": "filterSetValueMode",
+      "type": "FilterSetValueMode",
+      "default": "'current'",
+      "required": false,
+      "notes": "值选择搜索时的勾选投影模式；默认 `current`"
+    },
+    {
+      "name": "filterSetDateLayoutMode",
+      "type": "FilterSetDateLayoutMode",
+      "default": "'tree'",
+      "required": false,
+      "notes": "日期列值选择展示方式；默认 `tree`"
+    },
+    {
+      "name": "showStatusBar",
+      "type": "boolean",
+      "default": "true",
+      "required": false,
+      "notes": "是否显示底部状态栏；默认 true"
+    },
+    {
+      "name": "showDefaultStatusBarPanels",
+      "type": "boolean",
+      "default": "true",
+      "required": false,
+      "notes": "显示默认状态栏左侧面板（行数 / 筛选态 / 选中数）；默认 true"
+    },
+    {
+      "name": "statusBarHeight",
+      "type": "StatusBarHeightInput",
+      "default": "'auto'",
+      "required": false,
+      "notes": "状态栏高度：`'auto'` 跟随 size preset（默认）；number 为自定义 px。"
+    },
+    {
+      "name": "showStatusBarRangeAggregation",
+      "type": "boolean",
+      "default": "true",
+      "required": false,
+      "notes": "框选时在状态栏展示平均值/计数/求和；cellSelection 开时默认 true"
+    },
+    {
+      "name": "statusBarRangeAggregationPosition",
+      "type": "StatusBarRangeAggregationPosition",
+      "default": "'right'",
+      "required": false,
+      "notes": "框选聚合 panel 位置；默认 `right`（右栏内侧）"
+    },
+    {
+      "name": "statusBarRangeAggregationPrecision",
+      "type": "StatusBarRangeAggregationPrecisionInput",
+      "default": "undefined",
+      "required": false,
+      "notes": "平均值 / 求和展示小数位数。"
+    },
+    {
+      "name": "rowDragManaged",
+      "type": "boolean",
+      "default": "true",
+      "required": false,
+      "notes": "启用 managed 行拖拽：拖拽过程中实时改 source 顺序；默认 true。"
+    },
+    {
+      "name": "getRowHeight",
+      "type": "GetRowHeightFn",
+      "default": "undefined",
+      "required": false,
+      "notes": "行级动态高度（无 DOM）；优先于默认 rowHeight，低于手动 setRowHeight。"
+    },
+    {
+      "name": "rowHeightMin",
+      "type": "number",
+      "default": "undefined",
+      "required": false,
+      "notes": "行高下限（px）；未传时跟随 size preset / rowHeight"
+    },
+    {
+      "name": "rowHeightMax",
+      "type": "number",
+      "default": "undefined",
+      "required": false,
+      "notes": "行高上限（px）；未传时无上限"
+    },
+    {
+      "name": "enableCellSpan",
+      "type": "boolean",
+      "default": "false",
+      "required": false,
+      "notes": "启用单元格合并。默认 `false`。"
+    },
+    {
+      "name": "enableCellEditorCache",
+      "type": "boolean",
+      "default": "false",
+      "required": false,
+      "notes": "为所有 overlay 列注入 cell editor cache API（get/set/clear）。"
+    },
+    {
+      "name": "cellEditorCacheMaxEntries",
+      "type": "number",
+      "default": "undefined",
+      "required": false,
+      "notes": "会话缓存最大条目数；超出时 LRU 淘汰。默认不限。"
+    },
+    {
+      "name": "masterDetail",
+      "type": "boolean",
+      "default": "false",
+      "required": false,
+      "notes": "启用主从展开行。默认 `false`。"
+    },
+    {
+      "name": "isRowMaster",
+      "type": "IsRowMasterFn",
+      "default": "undefined",
+      "required": false,
+      "notes": "是否为主行（可展示 expand 控件）；缺省全部 data 行可展开"
+    },
+    {
+      "name": "masterDefaultExpanded",
+      "type": "number",
+      "default": "undefined",
+      "required": false,
+      "notes": "默认展开层级：0 = 无；1 = 第一层；-1 = 全部"
+    },
+    {
+      "name": "detailRowHeight",
+      "type": "number | DetailRowHeightFn",
+      "default": "undefined",
+      "required": false,
+      "notes": "详情行固定高度（px）；与 detailRowAutoHeight 并存时本字段优先"
+    },
+    {
+      "name": "detailRowAutoHeight",
+      "type": "boolean",
+      "default": "undefined",
+      "required": false,
+      "notes": "详情行按内容自动撑高"
+    },
+    {
+      "name": "embedFullWidthRows",
+      "type": "boolean",
+      "default": "undefined",
+      "required": false,
+      "notes": "false（默认）：详情 overlay 不随 center 横滚。"
+    },
+    {
+      "name": "showExpandColumn",
+      "type": "boolean",
+      "default": "undefined",
+      "required": false,
+      "notes": "最左展示专用展开列（fixed=left）"
+    },
+    {
+      "name": "getDetailRowData",
+      "type": "GetDetailRowDataFn",
+      "default": "undefined",
+      "required": false,
+      "notes": "异步提供详情区数据"
+    },
+    {
+      "name": "detailCellRenderer",
+      "type": "DetailCellRendererFn",
+      "default": "undefined",
+      "required": false,
+      "notes": "自定义详情行渲染器（与 `#detail-row` 插槽二选一）"
+    },
+    {
+      "name": "loadMoreRow",
+      "type": "{",
+      "required": false,
+      "notes": "CSRM · display 末尾加载更多行（enabled / height / loading / hasMore / labels）"
+    },
+    {
+      "name": "loadMoreRowRenderer",
+      "type": "LoadMoreRowRendererFn",
+      "default": "undefined",
+      "required": false,
+      "notes": "自定义 load-more 行渲染（与 `#load-more-row` 插槽二选一）"
+    },
+    {
+      "name": "rowGrouping",
+      "type": "boolean",
+      "default": "false",
+      "required": false,
+      "notes": "启用行分组。默认 `false`。"
+    },
+    {
+      "name": "groupDefaultExpanded",
+      "type": "number",
+      "default": "undefined",
+      "required": false,
+      "notes": "默认展开分组层级：0 = 全折叠；1 = 第一层；-1 = 全部展开。默认 `-1`"
+    },
+    {
+      "name": "showGroupHeader",
+      "type": "boolean",
+      "default": "false",
+      "required": false,
+      "notes": "是否展示 groupHeader 分组标题行。默认 `false`"
+    },
+    {
+      "name": "showGroupFooter",
+      "type": "boolean",
+      "default": "false",
+      "required": false,
+      "notes": "是否为每个已展开的分组展示 footer 汇总行。默认 `false`"
+    },
+    {
+      "name": "groupDisplayType",
+      "type": "GroupDisplayType",
+      "default": "undefined",
+      "required": false,
+      "notes": "分组展示模式。当前仅支持 `singleColumn`。"
+    },
+    {
+      "name": "showGroupColumn",
+      "type": "boolean",
+      "default": "false",
+      "required": false,
+      "notes": "是否展示 auto group 系统列；默认 false"
+    },
+    {
+      "name": "autoGroupColumnDef",
+      "type": "Partial<ColumnDef<TData>>",
+      "default": "undefined",
+      "required": false,
+      "notes": "覆盖 auto group 列的 colDef"
+    },
+    {
+      "name": "groupKeyCreator",
+      "type": "GroupKeyCreatorFn",
+      "default": "undefined",
+      "required": false,
+      "notes": "分组键归一化（可选）"
+    },
+    {
+      "name": "groupComparator",
+      "type": "GroupComparatorFn",
+      "default": "undefined",
+      "required": false,
+      "notes": "同级 group 节点排序。缺省按 groupKey 升序（blank 置末）。"
+    },
+    {
+      "name": "groupSortKey",
+      "type": "string",
+      "default": "undefined",
+      "required": false,
+      "notes": "组内 leaf 排序字段（如 sortNumber）；未配置则不处理"
+    },
+    {
+      "name": "groupFooterLabel",
+      "type": "string",
+      "default": "undefined",
+      "required": false,
+      "notes": "groupFooter 首列展示标签"
+    },
+    {
+      "name": "groupCellRenderer",
+      "type": "GroupCellRendererFn",
+      "default": "undefined",
+      "required": false,
+      "notes": "自定义分组单元格渲染器"
+    },
+    {
+      "name": "tree",
+      "type": "boolean",
+      "default": "false",
+      "required": false,
+      "notes": "启用树形表格。默认 `false`。"
+    },
+    {
+      "name": "getDataPath",
+      "type": "GetDataPathFn",
+      "default": "undefined",
+      "required": false,
+      "notes": "树形路径回调；`tree: true` 时必填"
+    },
+    {
+      "name": "showTreeColumn",
+      "type": "boolean",
+      "default": "undefined",
+      "required": false,
+      "notes": "是否展示 tree 系统列。默认 `true`"
+    },
+    {
+      "name": "autoTreeColumnDef",
+      "type": "Partial<ColumnDef<TData>>",
+      "default": "undefined",
+      "required": false,
+      "notes": "覆盖 tree 系统列 colDef"
+    },
+    {
+      "name": "treeValueGetter",
+      "type": "TreeValueGetterFn",
+      "default": "undefined",
+      "required": false,
+      "notes": "自定义 tree 列展示值"
+    },
+    {
+      "name": "treeDisplayType",
+      "type": "TreeDisplayType",
+      "default": "undefined",
+      "required": false,
+      "notes": "树节点展示列模式。当前仅支持 `singleColumn`"
+    },
+    {
+      "name": "treeDragScope",
+      "type": "TreeDragScope",
+      "default": "undefined",
+      "required": false,
+      "notes": "树形 managed 行拖拽范围。默认 `siblings`（仅同 parent 兄弟换序）；"
+    },
+    {
+      "name": "treeHierarchyActions",
+      "type": "boolean",
+      "default": "undefined",
+      "required": false,
+      "notes": "hierarchy 模式下在 tree 列展示 settings 层级菜单（上移一级 / 下移一级）。"
+    },
+    {
+      "name": "setDataPath",
+      "type": "SetDataPathFn",
+      "default": "undefined",
+      "required": false,
+      "notes": "hierarchy 模式下写回 dataPath；缺省时若 data.pathSegments 为数组则自动更新"
+    },
+    {
+      "name": "treeLazyLoad",
+      "type": "boolean",
+      "default": "false",
+      "required": false,
+      "notes": "启用树形懒加载"
+    },
+    {
+      "name": "hasTreeChildren",
+      "type": "HasTreeChildrenFn",
+      "default": "undefined",
+      "required": false,
+      "notes": "lazy 模式：节点是否可能有未加载子行"
+    },
+    {
+      "name": "loadTreeChildren",
+      "type": "LoadTreeChildrenFn",
+      "default": "undefined",
+      "required": false,
+      "notes": "lazy 模式：首次展开时拉取子数据"
+    },
+    {
+      "name": "cellCommentsDataSource",
+      "type": "CellCommentsDataSource",
+      "default": "undefined",
+      "required": false,
+      "notes": "单元格批注数据源；提供即启用"
+    },
+    {
+      "name": "suppressCellComments",
+      "type": "boolean",
+      "default": "false",
+      "required": false,
+      "notes": "全局抑制批注交互；API 仍可 bypass"
+    },
+    {
+      "name": "cellCommentTrigger",
+      "type": "CellCommentTrigger",
+      "default": "'click'",
+      "required": false,
+      "notes": "查看已有批注的触发方式；默认 click（点角标 toggle）"
+    },
+    {
+      "name": "cellCommentShowDelay",
+      "type": "number",
+      "default": "undefined",
+      "required": false,
+      "notes": "hover 模式展示延迟 ms；默认 180"
+    },
+    {
+      "name": "cellCommentHideDelay",
+      "type": "number",
+      "default": "undefined",
+      "required": false,
+      "notes": "离开 cell/popup 后隐藏延迟 ms；默认 220"
+    },
+    {
+      "name": "cellSelection",
+      "type": "boolean | CellSelectionOptions",
+      "default": "true",
+      "required": false,
+      "notes": "单元格框选；MagicGrid 默认 true（含 enableColumnSelection，handleMode 默认 off），Grid API 未传时为 false"
+    },
+    {
+      "name": "enableCellCopy",
+      "type": "boolean",
+      "default": "undefined",
+      "required": false,
+      "notes": "框选复制；cellSelection 开启时默认 true"
+    },
+    {
+      "name": "enableCellPaste",
+      "type": "boolean",
+      "default": "undefined",
+      "required": false,
+      "notes": "框选粘贴；cellSelection 开启时默认 false"
+    },
+    {
+      "name": "enableHeaderHighlight",
+      "type": "boolean",
+      "default": "true",
+      "required": false,
+      "notes": "选区涉及列的表头底色；默认 true"
+    },
+    {
+      "name": "enableIndexColumnHighlight",
+      "type": "boolean",
+      "default": "true",
+      "required": false,
+      "notes": "选区行跨度内索引列高亮；默认 true"
+    },
+    {
+      "name": "processCellForClipboard",
+      "type": "ProcessCellForClipboardFn",
+      "default": "undefined",
+      "required": false,
+      "notes": "复制单格时自定义导出值（最高优先级）"
+    },
+    {
+      "name": "processCellFromClipboard",
+      "type": "ProcessCellFromClipboardFn",
+      "default": "undefined",
+      "required": false,
+      "notes": "粘贴单格时预处理 clipboard 字符串"
+    },
+    {
+      "name": "processDataFromClipboard",
+      "type": "ProcessDataFromClipboardFn",
+      "default": "undefined",
+      "required": false,
+      "notes": "整表粘贴前处理 TSV 矩阵；return null 取消粘贴"
+    },
+    {
+      "name": "enableTooltips",
+      "type": "boolean",
+      "default": "undefined",
+      "required": false,
+      "notes": "是否启用溢出 tooltip；默认 true"
+    },
+    {
+      "name": "tooltipShowMode",
+      "type": "TooltipShowMode",
+      "default": "undefined",
+      "required": false,
+      "notes": "溢出 tooltip 显示策略；默认 whenTruncated"
+    },
+    {
+      "name": "tooltipShowDelay",
+      "type": "number",
+      "default": "undefined",
+      "required": false,
+      "notes": "首次 hover 展示延迟 ms；默认 500"
+    },
+    {
+      "name": "tooltipSwitchShowDelay",
+      "type": "number",
+      "default": "undefined",
+      "required": false,
+      "notes": "格间切换展示延迟 ms；默认 200"
+    },
+    {
+      "name": "tooltipHideDelay",
+      "type": "number",
+      "default": "undefined",
+      "required": false,
+      "notes": "离开后隐藏延迟 ms；默认 3000"
+    },
+    {
+      "name": "tooltipInteraction",
+      "type": "boolean",
+      "default": "undefined",
+      "required": false,
+      "notes": "tooltip 内容是否可交互；默认 false"
+    },
+    {
+      "name": "tooltipMouseTrack",
+      "type": "boolean",
+      "default": "undefined",
+      "required": false,
+      "notes": "tooltip 是否跟随鼠标；默认 false"
+    },
+    {
+      "name": "tooltipComponent",
+      "type": "TooltipComponentType",
+      "default": "undefined",
+      "required": false,
+      "notes": "全局自定义 tooltip 组件（与 `#tooltip` 插槽二选一）"
+    },
+    {
+      "name": "tooltipComponentParams",
+      "type": "Record<string, unknown>",
+      "default": "undefined",
+      "required": false,
+      "notes": "全局 tooltip 组件额外参数"
+    },
+    {
+      "name": "loading",
+      "type": "boolean",
+      "default": "undefined",
+      "required": false,
+      "notes": "是否显示 loading overlay；undefined 为挂载后首次 setData 前自动 loading"
+    },
+    {
+      "name": "suppressOverlays",
+      "type": "OverlayType[]",
+      "default": "undefined",
+      "required": false,
+      "notes": "逐项抑制内置 overlay"
+    },
+    {
+      "name": "suppressLoadingOverlay",
+      "type": "boolean",
+      "default": "undefined",
+      "required": false,
+      "notes": "抑制 loading overlay"
+    },
+    {
+      "name": "suppressNoRowsOverlay",
+      "type": "boolean",
+      "default": "undefined",
+      "required": false,
+      "notes": "抑制无数据 overlay"
+    },
+    {
+      "name": "suppressNoMatchingRowsOverlay",
+      "type": "boolean",
+      "default": "undefined",
+      "required": false,
+      "notes": "抑制无匹配行 overlay（filter 后为空）"
+    },
+    {
+      "name": "overlayLoadingTemplate",
+      "type": "string",
+      "default": "undefined",
+      "required": false,
+      "notes": "loading overlay 内置 HTML 模板"
+    },
+    {
+      "name": "overlayNoRowsTemplate",
+      "type": "string",
+      "default": "undefined",
+      "required": false,
+      "notes": "无数据 overlay 内置 HTML 模板"
+    },
+    {
+      "name": "overlayNoMatchingRowsTemplate",
+      "type": "string",
+      "default": "undefined",
+      "required": false,
+      "notes": "无匹配行 overlay 内置 HTML 模板"
+    },
+    {
+      "name": "overlayInteraction",
+      "type": "boolean",
+      "default": "undefined",
+      "required": false,
+      "notes": "overlay 内容是否可交互（默认可穿透）"
+    },
+    {
+      "name": "loadingOverlayComponent",
+      "type": "OverlayComponentType",
+      "default": "undefined",
+      "required": false,
+      "notes": "自定义 loading overlay 组件"
+    },
+    {
+      "name": "loadingOverlayComponentParams",
+      "type": "Record<string, unknown>",
+      "default": "undefined",
+      "required": false,
+      "notes": "loading overlay 组件额外参数"
+    },
+    {
+      "name": "noRowsOverlayComponent",
+      "type": "OverlayComponentType",
+      "default": "undefined",
+      "required": false,
+      "notes": "自定义无数据 overlay 组件"
+    },
+    {
+      "name": "noRowsOverlayComponentParams",
+      "type": "Record<string, unknown>",
+      "default": "undefined",
+      "required": false,
+      "notes": "无数据 overlay 组件额外参数"
+    },
+    {
+      "name": "noMatchingRowsOverlayComponent",
+      "type": "OverlayComponentType",
+      "default": "undefined",
+      "required": false,
+      "notes": "自定义无匹配行 overlay 组件"
+    },
+    {
+      "name": "noMatchingRowsOverlayComponentParams",
+      "type": "Record<string, unknown>",
+      "default": "undefined",
+      "required": false,
+      "notes": "无匹配行 overlay 组件额外参数"
+    },
+    {
+      "name": "overlayComponent",
+      "type": "OverlayComponentType",
+      "default": "undefined",
+      "required": false,
+      "notes": "通用 overlay 组件（按类型分发）"
+    },
+    {
+      "name": "overlayComponentParams",
+      "type": "Record<string, unknown>",
+      "default": "undefined",
+      "required": false,
+      "notes": "通用 overlay 组件额外参数"
+    }
+  ],
+  "emits": [
+    {
+      "name": "scroll",
+      "payloadType": "event: ScrollEvent"
+    },
+    {
+      "name": "scroll-start",
+      "payloadType": "event: ScrollStartEvent"
+    },
+    {
+      "name": "scroll-end",
+      "payloadType": "event: ScrollEndEvent"
+    },
+    {
+      "name": "scroll-top",
+      "payloadType": "event: ScrollTopEvent"
+    },
+    {
+      "name": "scroll-bottom",
+      "payloadType": "event: ScrollBottomEvent"
+    },
+    {
+      "name": "load-more",
+      "payloadType": "event: LoadMoreEvent"
+    },
+    {
+      "name": "data-rendered",
+      "payloadType": "metrics: GridMetrics"
+    },
+    {
+      "name": "grid-ready",
+      "payloadType": "event: GridReadyEvent"
+    },
+    {
+      "name": "grid-destroyed",
+      "payloadType": "event: GridDestroyedEvent"
+    },
+    {
+      "name": "first-rendered",
+      "payloadType": "event: FirstRenderedEvent"
+    },
+    {
+      "name": "cell-clicked",
+      "payloadType": "event: CellClickedEvent"
+    },
+    {
+      "name": "row-click",
+      "payloadType": "event: RowClickedEvent"
+    },
+    {
+      "name": "row-dblclick",
+      "payloadType": "event: RowDoubleClickedEvent"
+    },
+    {
+      "name": "selection-changed",
+      "payloadType": "event: SelectionChangedEvent"
+    },
+    {
+      "name": "index-focus-changed",
+      "payloadType": "event: IndexFocusChangedEvent"
+    },
+    {
+      "name": "cell-value-changed",
+      "payloadType": "event: CellValueChangedEvent"
+    },
+    {
+      "name": "row-data-changed",
+      "payloadType": "event: RowDataChangedEvent"
+    },
+    {
+      "name": "rows-data-changed",
+      "payloadType": "event: RowsDataChangedEvent"
+    },
+    {
+      "name": "cell-editing-started",
+      "payloadType": "event: CellEditingStartedEvent"
+    },
+    {
+      "name": "cell-editing-stopped",
+      "payloadType": "event: CellEditingStoppedEvent"
+    },
+    {
+      "name": "cell-commit-started",
+      "payloadType": "event: CellCommitStartedEvent"
+    },
+    {
+      "name": "cell-commit-finished",
+      "payloadType": "event: CellCommitFinishedEvent"
+    },
+    {
+      "name": "edit-commit-aborted",
+      "payloadType": "event: EditCommitAbortedEvent"
+    },
+    {
+      "name": "row-commit-started",
+      "payloadType": "event: RowCommitStartedEvent"
+    },
+    {
+      "name": "row-commit-finished",
+      "payloadType": "event: RowCommitFinishedEvent"
+    },
+    {
+      "name": "row-editing-started",
+      "payloadType": "event: RowEditingStartedEvent"
+    },
+    {
+      "name": "row-editing-stopped",
+      "payloadType": "event: RowEditingStoppedEvent"
+    },
+    {
+      "name": "row-value-changed",
+      "payloadType": "event: RowValueChangedEvent"
+    },
+    {
+      "name": "cell-validation-failed",
+      "payloadType": "event: CellValidationFailedEvent"
+    },
+    {
+      "name": "row-validation-failed",
+      "payloadType": "event: RowValidationFailedEvent"
+    },
+    {
+      "name": "sort-changed",
+      "payloadType": "model: SortModelItem["
+    },
+    {
+      "name": "column-moved",
+      "payloadType": "event: ColumnMovedEvent"
+    },
+    {
+      "name": "column-resized",
+      "payloadType": "event: ColumnResizedEvent"
+    },
+    {
+      "name": "column-pinned",
+      "payloadType": "event: ColumnPinnedEvent"
+    },
+    {
+      "name": "column-hidden-changed",
+      "payloadType": "event: ColumnHiddenChangedEvent"
+    },
+    {
+      "name": "filter-changed",
+      "payloadType": "model: FilterModel"
+    },
+    {
+      "name": "rows-added",
+      "payloadType": "event: RowsAddedEvent"
+    },
+    {
+      "name": "rows-removed",
+      "payloadType": "event: RowsRemovedEvent"
+    },
+    {
+      "name": "row-id-promoted",
+      "payloadType": "event: RowIdPromotedEvent"
+    },
+    {
+      "name": "row-moved",
+      "payloadType": "event: RowMovedEvent"
+    },
+    {
+      "name": "row-drag-end",
+      "payloadType": "event: RowDragEndEvent"
+    },
+    {
+      "name": "row-drag-commit-started",
+      "payloadType": "event: RowDragCommitStartedEvent"
+    },
+    {
+      "name": "row-drag-commit-finished",
+      "payloadType": "event: RowDragCommitFinishedEvent"
+    },
+    {
+      "name": "row-height-changed",
+      "payloadType": "event: RowHeightChangedEvent"
+    },
+    {
+      "name": "row-expanded",
+      "payloadType": "event: RowExpansionChangedEvent"
+    },
+    {
+      "name": "row-collapsed",
+      "payloadType": "event: RowExpansionChangedEvent"
+    },
+    {
+      "name": "row-group-opened",
+      "payloadType": "event: RowGroupOpenedEvent"
+    },
+    {
+      "name": "row-group-changed",
+      "payloadType": "event: RowGroupChangedEvent"
+    },
+    {
+      "name": "tree-node-opened",
+      "payloadType": "event: TreeNodeOpenedEvent"
+    },
+    {
+      "name": "tree-children-loading",
+      "payloadType": "event: TreeChildrenLoadingEvent"
+    },
+    {
+      "name": "tree-children-loaded",
+      "payloadType": "event: TreeChildrenLoadedEvent"
+    },
+    {
+      "name": "tree-children-load-failed",
+      "payloadType": "event: TreeChildrenLoadFailedEvent"
+    },
+    {
+      "name": "cell-comment-changed",
+      "payloadType": "event: CellCommentChangedEvent"
+    },
+    {
+      "name": "cell-selection-changed",
+      "payloadType": "event: CellSelectionChangedEvent"
+    },
+    {
+      "name": "cell-selection-delete-start",
+      "payloadType": "event: CellSelectionDeleteStartEvent"
+    },
+    {
+      "name": "cell-selection-delete-end",
+      "payloadType": "event: CellSelectionDeleteEndEvent"
+    },
+    {
+      "name": "overlay-shown",
+      "payloadType": "event: OverlayShownEvent"
+    },
+    {
+      "name": "overlay-hidden",
+      "payloadType": "event: OverlayHiddenEvent"
+    },
+    {
+      "name": "infinite-block-loading",
+      "payloadType": "event: InfiniteBlockLoadingEvent"
+    },
+    {
+      "name": "infinite-block-loaded",
+      "payloadType": "event: InfiniteBlockLoadedEvent"
+    },
+    {
+      "name": "infinite-block-load-failed",
+      "payloadType": "event: InfiniteBlockLoadFailedEvent"
+    },
+    {
+      "name": "infinite-cache-purged",
+      "payloadType": "event: InfiniteCachePurgedEvent"
+    }
+  ],
+  "slots": [
+    {
+      "name": "#toolbar",
+      "kind": "static",
+      "description": "表格顶部工具栏"
+    },
+    {
+      "name": "#status-bar",
+      "kind": "static",
+      "description": "完全自定义底部状态栏（提供时替换默认布局）"
+    },
+    {
+      "name": "#status-bar-left",
+      "kind": "static",
+      "description": "默认状态栏左侧区域"
+    },
+    {
+      "name": "#status-bar-right",
+      "kind": "static",
+      "description": "默认状态栏右侧区域"
+    },
+    {
+      "name": "#cell-{colId}",
+      "kind": "dynamic",
+      "description": "自定义单元格渲染"
+    },
+    {
+      "name": "#cell-editor-{colId}",
+      "kind": "dynamic",
+      "description": "自定义单元格编辑器"
+    },
+    {
+      "name": "#detail-row",
+      "kind": "static",
+      "description": "主从展开行详情区"
+    },
+    {
+      "name": "#tooltip",
+      "kind": "static",
+      "description": "全局自定义 tooltip"
+    },
+    {
+      "name": "#loading",
+      "kind": "static",
+      "description": "loading overlay 内容"
+    },
+    {
+      "name": "#no-rows",
+      "kind": "static",
+      "description": "无数据 overlay 内容"
+    },
+    {
+      "name": "#no-matching-rows",
+      "kind": "static",
+      "description": "筛选无匹配 overlay 内容"
+    }
+  ],
+  "expose": [
+    {
+      "name": "api",
+      "type": "GridApi | undefined",
+      "notes": "GridApi 实例；挂载后可用"
+    },
+    {
+      "name": "getMetrics",
+      "type": "() => GridMetrics | undefined",
+      "notes": "读取 Grid 运行时性能指标"
+    },
+    {
+      "name": "scrollTo",
+      "type": "(scrollTop: number, scrollLeft?: number) => void",
+      "notes": "滚动到指定 scrollTop / scrollLeft（px）"
+    },
+    {
+      "name": "setSortModel",
+      "type": "(model: SortModelItem[]) => void",
+      "notes": "设置排序模型并重算 rowsToDisplay"
+    },
+    {
+      "name": "getSortModel",
+      "type": "() => SortModelItem[]",
+      "notes": "读取当前排序模型"
+    },
+    {
+      "name": "setFilterModel",
+      "type": "(model: FilterModel) => void",
+      "notes": "设置筛选模型并重算 rowsToDisplay"
+    },
+    {
+      "name": "getData",
+      "type": "(options?: GetDataOptions) => RowData[]",
+      "notes": "导出当前表格业务数据；等价于 `api.getData()`"
+    },
+    {
+      "name": "applyTransaction",
+      "type": "(transaction: RowTransaction) => Promise<RowNodeTransaction | undefined>",
+      "notes": "批量增删改行；返回本次事务影响的 RowNode 快照"
+    },
+    {
+      "name": "beginUpdate",
+      "type": "() => void",
+      "notes": "开启批量更新（合并多次 DOM 刷新）"
+    },
+    {
+      "name": "endUpdate",
+      "type": "() => void",
+      "notes": "结束批量更新并刷新"
+    },
+    {
+      "name": "ensureIndexVisible",
+      "type": "(index: number, position?: 'top' | 'bottom' | 'middle') => void",
+      "notes": "滚动使指定 display 行可见"
+    },
+    {
+      "name": "flushFrames",
+      "type": "() => void",
+      "notes": "立即刷新待处理的动画帧任务"
+    },
+    {
+      "name": "getPendingFrameTaskCount",
+      "type": "() => number",
+      "notes": "RAF 队列待处理任务总数"
+    },
+    {
+      "name": "getPendingRendererTaskCount",
+      "type": "() => number",
+      "notes": "f1 队列待处理 cellRenderer 任务数"
+    },
+    {
+      "name": "setDefaultSelectedRows",
+      "type": "GridApi['setDefaultSelectedRows']",
+      "notes": "preset 行选区；见 GridApi.setDefaultSelectedRows"
+    }
+  ],
+  "gridApi": [
+    {
+      "name": "addCellRange",
+      "signature": "addCellRange(params: CellRange) => void",
+      "notes": "追加一个 cell range（非法参数忽略）。"
+    },
+    {
+      "name": "addGroupRows",
+      "signature": "addGroupRows(options: AddGroupRowsOptions) => Promise<RowNodeTransaction>",
+      "notes": "向指定分组内插入一行或多行（组内 leaf 坐标系）。"
+    },
+    {
+      "name": "addGroupRowsByArray",
+      "signature": "addGroupRowsByArray(items: readonly AddGroupRowByArrayItem[], options?: AddGroupRowsByArrayOptions) => Promise<RowNodeTransaction>",
+      "notes": "向指定分组内批量插入，每项可指定独立 target 与组内 index。"
+    },
+    {
+      "name": "addRows",
+      "signature": "addRows(options: AddRowsOptions) => Promise<RowNodeTransaction>",
+      "notes": "在指定位置插入一行或多行。"
+    },
+    {
+      "name": "addRowsByArray",
+      "signature": "addRowsByArray(items: readonly AddRowByArrayItem[], options?: AddRowsByArrayOptions) => Promise<RowNodeTransaction>",
+      "notes": "按数组批量插入行，每项可指定独立插入下标。"
+    },
+    {
+      "name": "applyTransaction",
+      "signature": "applyTransaction(tx: RowTransaction) => Promise<RowNodeTransaction>",
+      "notes": "增量事务：add / update / remove。"
+    },
+    {
+      "name": "autoSizeColumn",
+      "signature": "autoSizeColumn(colId: string, skipHeader?: boolean) => void",
+      "notes": "按当前可见单元格内容自动调整列宽（Phase 14+ · 对标 autoSizeColumn）"
+    },
+    {
+      "name": "autoSizeColumns",
+      "signature": "autoSizeColumns(colIds: readonly string[], skipHeader?: boolean) => void",
+      "notes": "批量 auto-size（Phase 14+ · 对标 autoSizeColumns）"
+    },
+    {
+      "name": "awaitCommitIdle",
+      "signature": "awaitCommitIdle() => Promise<void>",
+      "notes": "等待当前编辑 commit 管线结束（无编辑态且非 committing）。"
+    },
+    {
+      "name": "beginUpdate",
+      "signature": "beginUpdate() => void",
+      "notes": "开启批量更新：多次 `applyTransaction` / `addRows` 合并为一次重绘。"
+    },
+    {
+      "name": "cancelCommit",
+      "signature": "cancelCommit() => void",
+      "notes": "中断进行中的异步提交，保持编辑态与编辑器焦点。"
+    },
+    {
+      "name": "clearAllCellEditorCache",
+      "signature": "clearAllCellEditorCache() => void",
+      "notes": "清除当前 Grid 实例全部 cell editor cache（等价于 reinit / destroy 前全清）。"
+    },
+    {
+      "name": "clearAllFilters",
+      "signature": "clearAllFilters() => void",
+      "notes": "清除全部筛选：列 filterModel + quickFilterText。"
+    },
+    {
+      "name": "clearCellEditorCache",
+      "signature": "clearCellEditorCache(rowId?: RowId, colId?: string, key?: string) => void",
+      "notes": "按范围清除 cell editor cache。"
+    },
+    {
+      "name": "clearCellSelection",
+      "signature": "clearCellSelection() => void",
+      "notes": "清除全部 cell range。"
+    },
+    {
+      "name": "clearCellStyles",
+      "signature": "clearCellStyles(params?: ClearCellStylesParams) => void",
+      "notes": "清除 API 临时高亮；省略 params 时清除全部 override。"
+    },
+    {
+      "name": "clearCellValidation",
+      "signature": "clearCellValidation(options: ClearCellValidationOptions) => void",
+      "notes": "清除指定单元格的校验视觉反馈。"
+    },
+    {
+      "name": "clearPendingDefaultSelectedRows",
+      "signature": "clearPendingDefaultSelectedRows() => void",
+      "notes": "清除待满足的 preset（如移除 `default-selected-rows` prop 时）"
+    },
+    {
+      "name": "clearRowSelection",
+      "signature": "clearRowSelection(options?: ClearRowSelectionOptions) => void",
+      "notes": "清空行 checkbox 选中。"
+    },
+    {
+      "name": "clearRowValidation",
+      "signature": "clearRowValidation(options: ClearRowValidationOptions) => void",
+      "notes": "清除指定行的校验视觉反馈。"
+    },
+    {
+      "name": "clearValidation",
+      "signature": "clearValidation(options?: ClearValidationOptions) => void",
+      "notes": "清除全表或指定行的校验视觉反馈。"
+    },
+    {
+      "name": "collapseAll",
+      "signature": "collapseAll() => void",
+      "notes": "折叠全部已展开主行 / 分组（取决于启用的能力）。"
+    },
+    {
+      "name": "collapseGroup",
+      "signature": "collapseGroup(groupId: string) => boolean",
+      "notes": "折叠分组节点。"
+    },
+    {
+      "name": "collapseNode",
+      "signature": "collapseNode(rowId: RowId) => boolean",
+      "notes": "折叠 tree 节点。"
+    },
+    {
+      "name": "collapseRow",
+      "signature": "collapseRow(rowId: RowId) => boolean",
+      "notes": "折叠主行；未展开或未启用时返回 `false`。"
+    },
+    {
+      "name": "commit",
+      "signature": "commit(cancel?: boolean) => Promise<boolean>",
+      "notes": "提交或撤销当前编辑内容。"
+    },
+    {
+      "name": "copySelectedRangeToClipboard",
+      "signature": "copySelectedRangeToClipboard() => void",
+      "notes": "复制当前选区到系统剪贴板（TSV）。"
+    },
+    {
+      "name": "destroy",
+      "signature": "destroy() => void",
+      "notes": "销毁 Grid 实例：解绑监听、取消编辑、清理 DOM。"
+    },
+    {
+      "name": "endUpdate",
+      "signature": "endUpdate() => void",
+      "notes": "结束批量更新并 flush 累积的事务。"
+    },
+    {
+      "name": "ensureIndexVisible",
+      "signature": "ensureIndexVisible(index: number, position?: EnsureIndexVisiblePosition) => void",
+      "notes": "滚动使指定**行下标**（`rowsToDisplay` 中的 index）进入视口。"
+    },
+    {
+      "name": "expandAll",
+      "signature": "expandAll() => void",
+      "notes": "展开当前 display 中全部可展开 master 行。"
+    },
+    {
+      "name": "expandGroup",
+      "signature": "expandGroup(groupId: string) => boolean",
+      "notes": "展开分组节点；未启用 rowGrouping 或 groupId 无效时返回 `false`。"
+    },
+    {
+      "name": "expandNode",
+      "signature": "expandNode(rowId: RowId) => boolean",
+      "notes": "展开 tree 节点；未启用 tree 时返回 `false`。"
+    },
+    {
+      "name": "expandRow",
+      "signature": "expandRow(rowId: RowId) => boolean",
+      "notes": "展开主行；非 master 或未启用 `masterDetail` 时返回 `false`。"
+    },
+    {
+      "name": "getCellComment",
+      "signature": "getCellComment(rowId: RowId, colId: string) => CellComment | undefined",
+      "notes": "读取批注；无则 `undefined`。"
+    },
+    {
+      "name": "getCellEditorCache",
+      "signature": "getCellEditorCache<T = unknown>(rowId: RowId, colId: string, key?: string) => T | undefined",
+      "notes": "读取指定单元格会话 cache（Grid 内存 KV，不进 row.data）。"
+    },
+    {
+      "name": "getCellRanges",
+      "signature": "getCellRanges() => CellRange[]",
+      "notes": "读取当前 cell range 列表（0..n）。"
+    },
+    {
+      "name": "getCellSelectionAggregation",
+      "signature": "getCellSelectionAggregation() => CellSelectionAggregation | null",
+      "notes": "Phase 24.1 · 当前框选聚合统计；无选区或未开框选时返回 null。"
+    },
+    {
+      "name": "getCellSpan",
+      "signature": "getCellSpan(rowId: RowId, colId: string) => CellSpanInfo | null",
+      "notes": "Phase 16 · 只读查询 `(rowId, colId)` 所属 span。"
+    },
+    {
+      "name": "getCellStyle",
+      "signature": "getCellStyle(rowId: RowId, colId: string) => CellStyle",
+      "notes": "读取合并后的最终 cellStyle。"
+    },
+    {
+      "name": "getCellStyleOverride",
+      "signature": "getCellStyleOverride(rowId: RowId, colId: string) => CellStyle | undefined",
+      "notes": "仅读取 API override 层；无 override 时 `undefined`。"
+    },
+    {
+      "name": "getColumnDistinctFilterValues",
+      "signature": "getColumnDistinctFilterValues(colId: string) => readonly ColumnFilterValueOption[]",
+      "notes": "Phase 12 · 列 distinct 值（set filter 勾选列表）"
+    },
+    {
+      "name": "getColumnFilter",
+      "signature": "getColumnFilter(colId: string) => FilterCondition | null",
+      "notes": "读取单列筛选条件；未设置时 `null`。"
+    },
+    {
+      "name": "getColumns",
+      "signature": "getColumns() => readonly Column[]",
+      "notes": "Phase 27 · 全量列（含 hidden · 含系统列）"
+    },
+    {
+      "name": "getColumnWidth",
+      "signature": "getColumnWidth(colId: string) => number",
+      "notes": "读取列当前像素宽度（Phase 14）"
+    },
+    {
+      "name": "getData",
+      "signature": "getData(options?: GetDataOptions) => RowData[]",
+      "notes": "导出当前表格数据为业务层 `RowData[]`。"
+    },
+    {
+      "name": "getDataPath",
+      "signature": "getDataPath(rowId: RowId) => string[] | undefined",
+      "notes": "查询行的 dataPath；未启用 tree 时返回 `undefined`。"
+    },
+    {
+      "name": "getDisplayedColumnIds",
+      "signature": "getDisplayedColumnIds() => readonly string[]",
+      "notes": "Phase 22 · 当前 UI 展示的列 id（左→右）"
+    },
+    {
+      "name": "getDisplayedColumns",
+      "signature": "getDisplayedColumns() => readonly Column[]",
+      "notes": "Phase 27 · 当前 UI 展示的列（不含 hidden）"
+    },
+    {
+      "name": "getEditingCell",
+      "signature": "getEditingCell() => {",
+      "notes": "当前主编辑单元格；无编辑时 `null`。rowId 为业务类型（与 data[rowKey] 一致，临时行为 null）。"
+    },
+    {
+      "name": "getEditingCells",
+      "signature": "getEditingCells() => EditingCellPosition[]",
+      "notes": "行编辑模式下所有正在编辑的单元格位置列表。"
+    },
+    {
+      "name": "getEditSessionPhase",
+      "signature": "getEditSessionPhase() => EditSessionPhase",
+      "notes": "当前编辑会话阶段。"
+    },
+    {
+      "name": "getFilterModel",
+      "signature": "getFilterModel() => FilterModel",
+      "notes": "读取当前筛选模型。"
+    },
+    {
+      "name": "getIndexFocusedRowIds",
+      "signature": "getIndexFocusedRowIds(options?: RowListOptions) => RowId[]",
+      "notes": "读取索引列 focus 行 id，可直接传给 `moveRows({ rowIds })`。"
+    },
+    {
+      "name": "getIndexFocusedRows",
+      "signature": "getIndexFocusedRows(options?: RowListOptions) => RowSnapshot[]",
+      "notes": "读取索引列 focus 行快照（结构同 getSelectedRows）。"
+    },
+    {
+      "name": "getInfiniteRowCount",
+      "signature": "getInfiniteRowCount() => number",
+      "notes": "Infinite Row Model · 虚拟总行数（已知 lastRow 时精确，否则为当前占位长度）。"
+    },
+    {
+      "name": "getLoadedRowData",
+      "signature": "getLoadedRowData() => RowData[]",
+      "notes": "Infinite Row Model · 已加载行数据（非全量）。"
+    },
+    {
+      "name": "getMetrics",
+      "signature": "getMetrics() => GridMetrics",
+      "notes": "读取当前渲染与滚动指标（验收 / 调试用途）。"
+    },
+    {
+      "name": "getOverlayType",
+      "signature": "getOverlayType() => OverlayType | null",
+      "notes": "当前 overlay 类型；无 overlay 时返回 `null`。"
+    },
+    {
+      "name": "getPendingFrameTaskCount",
+      "signature": "getPendingFrameTaskCount() => number",
+      "notes": "Phase 41 · RAF 队列待处理任务总数（p1 + p2 + f1 + destroy）"
+    },
+    {
+      "name": "getPendingRendererTaskCount",
+      "signature": "getPendingRendererTaskCount() => number",
+      "notes": "Phase 41 · f1 队列待处理 cellRenderer 任务数"
+    },
+    {
+      "name": "getQuickFilterText",
+      "signature": "getQuickFilterText() => string",
+      "notes": "读取当前 quick filter 文本。"
+    },
+    {
+      "name": "getRowByIndex",
+      "signature": "getRowByIndex(index: number) => RowSnapshot | null",
+      "notes": "display 下标 → 快照；与 `getRowIndex(id, { type: 'display' })` 互逆。越界 → `null`"
+    },
+    {
+      "name": "getRowGroupColumns",
+      "signature": "getRowGroupColumns() => readonly string[]",
+      "notes": "当前分组列 colId 列表。"
+    },
+    {
+      "name": "getRowHeight",
+      "signature": "getRowHeight(rowId: RowId) => number | null",
+      "notes": "读取行当前有效高度（px）；行不存在时 `null`"
+    },
+    {
+      "name": "getRowIds",
+      "signature": "getRowIds(predicate?: RowSnapshotPredicate) => RowId[]",
+      "notes": "getRowSnapshots 的 id 投影（display 顺序、谓词语义相同）。"
+    },
+    {
+      "name": "getRowIndex",
+      "signature": "getRowIndex(rowId: RowId, options?: GetRowIndexOptions) => number | null",
+      "notes": "按 rowId 查下标。完整说明（source vs display、与快照字段对齐）见 `src/core/row/getRowIndex.ts`。"
+    },
+    {
+      "name": "getRowIndexes",
+      "signature": "getRowIndexes(rowIds: readonly RowId[], options?: GetRowIndexOptions) => RowIndexMap",
+      "notes": "批量 getRowIndex；返回 `RowIndexMap`（id 原样作 key）"
+    },
+    {
+      "name": "getRowKind",
+      "signature": "getRowKind(rowId: RowId) => RowKind | null",
+      "notes": "解析行的展示种类（RowKind）。"
+    },
+    {
+      "name": "getRowNode",
+      "signature": "getRowNode(id: RowId) => RowNode | undefined",
+      "notes": "按 rowId 获取行节点快照。"
+    },
+    {
+      "name": "getRowsByIndexes",
+      "signature": "getRowsByIndexes(indexes: readonly number[]) => RowSnapshot[]",
+      "notes": "批量 getRowByIndex；跳过无效下标"
+    },
+    {
+      "name": "getRowSnapshots",
+      "signature": "getRowSnapshots(predicate?: RowSnapshotPredicate) => RowSnapshot[]",
+      "notes": "遍历 **rowsToDisplay** 返回行快照（display 顺序，与 getRowByIndex 同坐标系）。"
+    },
+    {
+      "name": "getSelectedRowIds",
+      "signature": "getSelectedRowIds() => BusinessRowId[]",
+      "notes": "读取当前 checkbox 选中的业务 id（与 `data[rowKey]` 一致；临时行均为 `null`）"
+    },
+    {
+      "name": "getSelectedRows",
+      "signature": "getSelectedRows() => RowSnapshot[]",
+      "notes": "读取当前 checkbox 选中的完整快照。"
+    },
+    {
+      "name": "getSiblingRowByIterator",
+      "signature": "getSiblingRowByIterator(rowId: RowId, options: GetSiblingRowByIteratorOptions) => RowSnapshot | null",
+      "notes": "沿 `direction` 遍历相邻行，返回 **`next(false)` 终止时** 的 `currentRow` 快照。"
+    },
+    {
+      "name": "getSiblingRowsByRowId",
+      "signature": "getSiblingRowsByRowId(rowId: RowId, options: GetSiblingRowsByRowIdOptions) => RowSnapshot[]",
+      "notes": "按行 id 获取相邻可见行快照（`rowsToDisplay` 顺序；**不含锚点**）。"
+    },
+    {
+      "name": "getSortModel",
+      "signature": "getSortModel() => SortModelItem[]",
+      "notes": "读取当前排序模型（v1 至多 1 项）"
+    },
+    {
+      "name": "hideOverlay",
+      "signature": "hideOverlay() => void",
+      "notes": "隐藏当前 overlay。"
+    },
+    {
+      "name": "isAnyFilterActive",
+      "signature": "isAnyFilterActive() => boolean",
+      "notes": "任一列 filter 或 quick filter 是否 active。"
+    },
+    {
+      "name": "isColumnFilterActive",
+      "signature": "isColumnFilterActive(colId: string) => boolean",
+      "notes": "单列是否有有效筛选条件（含 blank/notBlank · custom predicate）。"
+    },
+    {
+      "name": "isColumnHidden",
+      "signature": "isColumnHidden(colId: string) => boolean | undefined",
+      "notes": "Phase 22 · 列是否 hidden；未知 colId 返回 `undefined`"
+    },
+    {
+      "name": "isCommitting",
+      "signature": "isCommitting() => boolean",
+      "notes": "是否正在异步提交（commit 管线进行中）。提交期间 Tab 导航等行为受限。"
+    },
+    {
+      "name": "isEditing",
+      "signature": "isEditing() => boolean",
+      "notes": "是否存在任意单元格 / 行处于编辑态。"
+    },
+    {
+      "name": "isGroupExpanded",
+      "signature": "isGroupExpanded(groupId: string) => boolean",
+      "notes": "分组是否已展开。"
+    },
+    {
+      "name": "isNodeExpanded",
+      "signature": "isNodeExpanded(rowId: RowId) => boolean",
+      "notes": "tree 节点是否已展开。"
+    },
+    {
+      "name": "isOverlayShowing",
+      "signature": "isOverlayShowing() => boolean",
+      "notes": "是否有 overlay 正在显示。"
+    },
+    {
+      "name": "isRowExpanded",
+      "signature": "isRowExpanded(rowId: RowId) => boolean",
+      "notes": "主行是否已展开。"
+    },
+    {
+      "name": "moveColumn",
+      "signature": "moveColumn(colId: string, toIndex: number) => void",
+      "notes": "编程式移动列；`toIndex` 为全局 columns 下标（含系统列占位）。"
+    },
+    {
+      "name": "moveDown",
+      "signature": "moveDown(rowId: RowId) => Promise< RowSnapshot | null>",
+      "notes": "在存储顺序中将行下移一位（语义同 moveUp）。"
+    },
+    {
+      "name": "moveDowns",
+      "signature": "moveDowns(rowIds: readonly RowId[]) => Promise< RowSnapshot[]>",
+      "notes": "批量步进下移（语义同 moveUps）。"
+    },
+    {
+      "name": "moveRow",
+      "signature": "moveRow(rowId: RowId, toIndex: number, indexMode?: RowIndexMode) => Promise<RowMoveResult>",
+      "notes": "编程式移动行。始终改写 **source** 存储顺序；`indexMode` 仅解释 `toIndex` 入参。"
+    },
+    {
+      "name": "moveRows",
+      "signature": "moveRows(options: MoveRowsGridApiOptions) => Promise<RowMoveResult>",
+      "notes": "编程式批量移动行（保持 source 内相对顺序）。"
+    },
+    {
+      "name": "moveUp",
+      "signature": "moveUp(rowId: RowId) => Promise< RowSnapshot | null>",
+      "notes": "在存储顺序中将行上移一位。"
+    },
+    {
+      "name": "moveUps",
+      "signature": "moveUps(rowIds: readonly RowId[]) => Promise< RowSnapshot[]>",
+      "notes": "批量步进上移（保持块内相对顺序）。"
+    },
+    {
+      "name": "on",
+      "signature": "on<T extends GridEventType>(type: T, handler: GridEventHandler<T>) => () => void",
+      "notes": "订阅 Grid 事件。"
+    },
+    {
+      "name": "pasteFromClipboard",
+      "signature": "pasteFromClipboard() => Promise<void>",
+      "notes": "从系统剪贴板粘贴到选区起点。"
+    },
+    {
+      "name": "patchRow",
+      "signature": "patchRow(options: PatchRowOptions) => Promise<RowNodeTransaction>",
+      "notes": "从 RowSnapshot 增量合并字段（cellCommitted 联动推荐入口）。"
+    },
+    {
+      "name": "promoteRowId",
+      "signature": "promoteRowId(options: PromoteRowIdOptions) => PromoteRowIdResult",
+      "notes": "将临时行的内部 id 提升为正式业务主键。"
+    },
+    {
+      "name": "reconcileDefaultSelectedRows",
+      "signature": "reconcileDefaultSelectedRows() => void",
+      "notes": "按当前 pending 再 reconcile（不修改 pending）。"
+    },
+    {
+      "name": "refreshCellComments",
+      "signature": "refreshCellComments(params?: RefreshCellCommentsParams) => void",
+      "notes": "刷新可见 cell 批注角标；popup 不强制重建。"
+    },
+    {
+      "name": "refreshCells",
+      "signature": "refreshCells(params?: RefreshCellsParams) => number",
+      "notes": "刷新指定行或列的单元格 DOM（不重跑全表 setData）。"
+    },
+    {
+      "name": "refreshCellSpans",
+      "signature": "refreshCellSpans() => void",
+      "notes": "Phase 16 · 强制重建单元格合并 cache 并刷新可见行 / 表尾。"
+    },
+    {
+      "name": "refreshCellStyles",
+      "signature": "refreshCellStyles(params?: RefreshCellStylesParams) => void",
+      "notes": "重算可见单元格 backgroundColor / color 投影。"
+    },
+    {
+      "name": "refreshDisabledState",
+      "signature": "refreshDisabledState(params?: RefreshDisabledStateParams) => void",
+      "notes": "Phase 21 · 重算可见单元格 disabled 投影（class · inline 控件 · aria）"
+    },
+    {
+      "name": "refreshInfiniteCache",
+      "signature": "refreshInfiniteCache() => void",
+      "notes": "Infinite Row Model · 清空块缓存并重新加载视口。"
+    },
+    {
+      "name": "registerCellEditor",
+      "signature": "registerCellEditor(name: string, editor: CellEditorFn) => void",
+      "notes": "向当前 Grid 实例注册命名单元格编辑器。"
+    },
+    {
+      "name": "reloadDetailRowData",
+      "signature": "reloadDetailRowData(rowId: RowId) => boolean",
+      "notes": "清除主行详情 cache 并重新调用 `getDetailRowData`（已展开时保持展开并显示 loading）。"
+    },
+    {
+      "name": "removeRows",
+      "signature": "removeRows(options: RemoveRowsOptions) => Promise<RowNodeTransaction>",
+      "notes": "按 rowId 和/或行下标删除行。"
+    },
+    {
+      "name": "removeSelectedRows",
+      "signature": "removeSelectedRows(options?: ClearRowSelectionOptions) => Promise<RowNodeTransaction>",
+      "notes": "删除当前 checkbox 选中的行。"
+    },
+    {
+      "name": "resetColumnOrder",
+      "signature": "resetColumnOrder() => boolean",
+      "notes": "Phase 27 · 各 lane 内用户列恢复 defOrder；无变化时为 no-op"
+    },
+    {
+      "name": "resetColumnWidths",
+      "signature": "resetColumnWidths() => boolean",
+      "notes": "Phase 27 · 用户列恢复 defWidth / defFlex；无变化时为 no-op"
+    },
+    {
+      "name": "resetRowHeights",
+      "signature": "resetRowHeights(rowIds?: readonly RowId[]) => void",
+      "notes": "清除 pinned 并重算行高（getRowHeight / autoHeight / 默认行高）。"
+    },
+    {
+      "name": "retryInfiniteBlock",
+      "signature": "retryInfiniteBlock(blockIndex: number) => void",
+      "notes": "Infinite Row Model · 重试指定块。"
+    },
+    {
+      "name": "scrollTo",
+      "signature": "scrollTo(scrollTop: number, scrollLeft?: number) => void",
+      "notes": "编程式滚动视口。"
+    },
+    {
+      "name": "setCellComment",
+      "signature": "setCellComment(rowId: RowId, colId: string, comment: CellComment | null | undefined) => Promise<void>",
+      "notes": "设置或删除批注（`comment=null/undefined`）；`source` 记为 `api`。"
+    },
+    {
+      "name": "setCellEditorCache",
+      "signature": "setCellEditorCache(rowId: RowId, colId: string, value: unknown, key?: string) => void",
+      "notes": "编排层写入 cell editor cache（如 `cellEditingStopped` 回调）。"
+    },
+    {
+      "name": "setCellStyle",
+      "signature": "setCellStyle(rowId: RowId, colId: string, style: CellStyle | null) => void",
+      "notes": "API 临时高亮单格；`style=null` 清除 override 并回退声明式规则。"
+    },
+    {
+      "name": "setColumnFilter",
+      "signature": "setColumnFilter(colId: string, condition: FilterCondition | null) => void",
+      "notes": "设置或清除单列筛选条件；`condition === null` 移除该 colId。"
+    },
+    {
+      "name": "setColumnFixed",
+      "signature": "setColumnFixed(colId: string, fixed: 'left' | 'right' | null) => boolean",
+      "notes": "运行时改列 fixed（left / right / null）。"
+    },
+    {
+      "name": "setColumnsHidden",
+      "signature": "setColumnsHidden(colIds: readonly string[], hidden: boolean) => boolean",
+      "notes": "Phase 22 · 批量设置列 hidden；触发 `columnHiddenChanged`"
+    },
+    {
+      "name": "setColumnWidth",
+      "signature": "setColumnWidth(colId: string, width: number, finished?: boolean, source?: ColumnResizeSource) => void",
+      "notes": "设置单列宽度（Phase 14）"
+    },
+    {
+      "name": "setColumnWidths",
+      "signature": "setColumnWidths(payloads: readonly { colId: string; width: number; }[], finished?: boolean, source?: ColumnResizeSource) => void",
+      "notes": "批量设置列宽（Phase 14）。"
+    },
+    {
+      "name": "setData",
+      "signature": "setData(rows: RowData[]) => void",
+      "notes": "全量替换表格数据（等价于清空后重新加载）。"
+    },
+    {
+      "name": "setDefaultSelectedRows",
+      "signature": "setDefaultSelectedRows(input: DefaultSelectedRowsInput, options?: ApplyDefaultSelectedRowsOptions) => void",
+      "notes": "**preset** 写入行 checkbox 选区。"
+    },
+    {
+      "name": "setDetailRowData",
+      "signature": "setDetailRowData(rowId: RowId, detailRowData: unknown) => boolean",
+      "notes": "主动写入主行详情数据（等价于 `getDetailRowData` 的 `successCallback` 结果缓存）。"
+    },
+    {
+      "name": "setDisabledCellStyle",
+      "signature": "setDisabledCellStyle(style: CellStyle | undefined) => void",
+      "notes": "Grid 级 disabled 单元格样式；等价于更新 `disabled-cell-style` prop。"
+    },
+    {
+      "name": "setEditableCellStyle",
+      "signature": "setEditableCellStyle(style: CellStyle | undefined) => void",
+      "notes": "Grid 级可编辑单元格样式；等价于更新 `editable-cell-style` prop。"
+    },
+    {
+      "name": "setFilterModel",
+      "signature": "setFilterModel(model: FilterModel) => void",
+      "notes": "设置筛选模型并重算 `rowsToDisplay`。触发 `filterChanged`。"
+    },
+    {
+      "name": "setIndexFocus",
+      "signature": "setIndexFocus(rowIds: RowIdInput, options?: SetIndexFocusOptions) => void",
+      "notes": "设置索引列辅助定位（`IndexFocusService`），不触发鼠标拖拉。"
+    },
+    {
+      "name": "setInfiniteDatasource",
+      "signature": "setInfiniteDatasource(datasource: InfiniteRowDatasource) => void",
+      "notes": "Infinite Row Model · 绑定 / 更换 datasource（purge + 从顶加载）。"
+    },
+    {
+      "name": "setQuickFilterText",
+      "signature": "setQuickFilterText(text: string) => void",
+      "notes": "设置 Grid 级 quick filter 文本；触发 `filterChanged`（块 5 接入过滤语义）。"
+    },
+    {
+      "name": "setRowGroupColumns",
+      "signature": "setRowGroupColumns(colIds: readonly string[]) => void",
+      "notes": "设置分组列顺序；需 `rowGrouping: true`。触发 `rowGroupChanged`。"
+    },
+    {
+      "name": "setRowHeight",
+      "signature": "setRowHeight(rowId: RowId, height: number, finished?: boolean) => void",
+      "notes": "设置单行高度并 pinned（Phase 15）。"
+    },
+    {
+      "name": "setRowHeights",
+      "signature": "setRowHeights(changes: readonly { rowId: RowId; height: number; }[], finished?: boolean) => void",
+      "notes": "批量设置行高（Phase 15）；语义同 setRowHeight"
+    },
+    {
+      "name": "setRowStyle",
+      "signature": "setRowStyle(rowStyle: RowStyle | undefined) => void",
+      "notes": "Grid 级行样式；等价于更新 `row-style` prop。"
+    },
+    {
+      "name": "setShowDisabledCellIcon",
+      "signature": "setShowDisabledCellIcon(show: boolean) => void",
+      "notes": "overlay disabled 格 pencil-off 图标开关；inline 列不显示；等价于 `show-disabled-cell-icon` prop。"
+    },
+    {
+      "name": "setShowEditableCellIcon",
+      "signature": "setShowEditableCellIcon(show: boolean) => void",
+      "notes": "overlay 可编辑格 pencil-line 图标开关；inline 列不显示；等价于 `show-editable-cell-icon` prop。"
+    },
+    {
+      "name": "setSortModel",
+      "signature": "setSortModel(model: SortModelItem[]) => void",
+      "notes": "设置排序模型并重算 `rowsToDisplay`。触发 `sortChanged`。"
+    },
+    {
+      "name": "showLoadingOverlay",
+      "signature": "showLoadingOverlay() => void",
+      "notes": "等价 `setGridOption('loading', true)`。"
+    },
+    {
+      "name": "showNoRowsOverlay",
+      "signature": "showNoRowsOverlay() => void",
+      "notes": "强制显示 noRows overlay，直至 `hideOverlay()`。"
+    },
+    {
+      "name": "sizeColumnsToFit",
+      "signature": "sizeColumnsToFit(params?: SizeColumnsToFitParams) => void",
+      "notes": "将列宽按比例分配至视口（或指定宽度）；对标 sizeColumnsToFit"
+    },
+    {
+      "name": "startEditingCell",
+      "signature": "startEditingCell(params: { rowIndex: number; colKey: string; }) => void",
+      "notes": "编程式进入单元格编辑。"
+    },
+    {
+      "name": "stopEditing",
+      "signature": "stopEditing(cancel?: boolean) => Promise<void>",
+      "notes": "结束当前编辑会话。"
+    },
+    {
+      "name": "toggleAllSelection",
+      "signature": "toggleAllSelection(selected?: boolean) => void",
+      "notes": "表头全选 checkbox 操作（`rowSelection: 'multiple'` 时有效）。"
+    },
+    {
+      "name": "toggleRowSelection",
+      "signature": "toggleRowSelection(rowIds: RowIdInput, selected?: boolean, force?: boolean) => void",
+      "notes": "切换或设置行的 checkbox 选中状态（行选择列 / `SelectionService`）。"
+    },
+    {
+      "name": "unregisterCellEditor",
+      "signature": "unregisterCellEditor(name: string) => boolean",
+      "notes": "注销实例级编辑器；成功返回 `true`。"
+    },
+    {
+      "name": "updateDimensions",
+      "signature": "updateDimensions(params: UpdateRowDimensionsParams) => void",
+      "notes": "热更新默认行高与 clamp 边界（Phase 15 · MagicGrid `rowHeight` prop）。"
+    },
+    {
+      "name": "updateRows",
+      "signature": "updateRows(options: UpdateRowsOptions) => Promise<RowNodeTransaction>",
+      "notes": "按 rowKey 或 rowId 批量更新行字段（浅合并）。"
+    },
+    {
+      "name": "validate",
+      "signature": "validate(options?: ValidateGridOptions) => Promise<GridValidationResult>",
+      "notes": "校验全表或指定行的持久化数据。"
+    },
+    {
+      "name": "validateCells",
+      "signature": "validateCells(options: ValidateCellsOptions) => Promise<GridValidationResult>",
+      "notes": "校验指定单元格列表（不跑 rowValidator）。"
+    },
+    {
+      "name": "validateRows",
+      "signature": "validateRows(options: ValidateRowsOptions) => Promise<GridValidationResult>",
+      "notes": "校验指定行列表（语义同 validate 的 `rowIds` 分支）。"
+    }
+  ],
+  "columnDef": [
+    {
+      "name": "key",
+      "type": "string",
+      "notes": "列唯一标识，缺省等于 prop"
+    },
+    {
+      "name": "prop",
+      "type": "Extract<keyof TData, string>",
+      "notes": "数据字段"
+    },
+    {
+      "name": "label",
+      "type": "string",
+      "notes": "表头文案"
+    },
+    {
+      "name": "available",
+      "type": "boolean",
+      "notes": "列是否有效；默认 true。"
+    },
+    {
+      "name": "hidden",
+      "type": "boolean",
+      "notes": "是否隐藏该列（不渲染 header/body/footer · 不参与布局）。"
+    },
+    {
+      "name": "width",
+      "type": "number",
+      "notes": "尺寸"
+    },
+    {
+      "name": "minWidth",
+      "type": "number",
+      "notes": "列最小宽度（px）"
+    },
+    {
+      "name": "maxWidth",
+      "type": "number",
+      "notes": "列最大宽度（px）"
+    },
+    {
+      "name": "flex",
+      "type": "number",
+      "notes": "flex 布局权重；与 width 互斥时 flex 参与剩余空间分配"
+    },
+    {
+      "name": "sortable",
+      "type": "boolean",
+      "notes": "列是否参与排序；缺省继承 Grid `sortable`（默认 false）"
+    },
+    {
+      "name": "comparator",
+      "type": "ColumnComparatorFn",
+      "notes": "自定义排序比较器；入参为两行的单元格原始值（经 valueGetter）。"
+    },
+    {
+      "name": "filterable",
+      "type": "boolean",
+      "notes": "是否允许列筛选；缺省继承 Grid `filterable`（默认 false）"
+    },
+    {
+      "name": "filterType",
+      "type": "ColumnDataFilterType",
+      "notes": "列筛选数据类型；默认 text"
+    },
+    {
+      "name": "filterParams",
+      "type": "FilterParams",
+      "notes": "列级 filter 参数（如 caseSensitive）"
+    },
+    {
+      "name": "filterFormatter",
+      "type": "(row: TData) => unknown",
+      "notes": "筛选用取值；缺省 formatter → valueGetter → prop */"
+    },
+    {
+      "name": "editable",
+      "type": "boolean | ((row: TData) => boolean)",
+      "notes": "是否可编辑；可函数按行判断"
+    },
+    {
+      "name": "resizable",
+      "type": "boolean",
+      "notes": "是否允许拖拽调整列宽；缺省继承 Grid `resizable`（默认 true）"
+    },
+    {
+      "name": "suppressAutoSize",
+      "type": "boolean",
+      "notes": "禁止 resize 把柄 dblclick / API auto-size；对标 AG Grid suppressAutoSize"
+    },
+    {
+      "name": "suppressSizeToFit",
+      "type": "boolean",
+      "notes": "禁止参与 sizeColumnsToFit；对标 AG Grid suppressSizeToFit"
+    },
+    {
+      "name": "fixed",
+      "type": "'left' | 'right' | null",
+      "notes": "列固定：left / right；null 或不传为不固定"
+    },
+    {
+      "name": "movable",
+      "type": "boolean",
+      "notes": "是否允许表头拖拽重排；默认继承 grid.columnMovable"
+    },
+    {
+      "name": "rowDrag",
+      "type": "boolean",
+      "notes": "该列单元格作为行拖拽起点；默认 false"
+    },
+    {
+      "name": "rowExpand",
+      "type": "boolean",
+      "notes": "在该列渲染 expand/collapse 控件；需 Grid `masterDetail: true`。"
+    },
+    {
+      "name": "rowGroup",
+      "type": "boolean",
+      "notes": "该列参与行分组；需 Grid `rowGrouping: true`。"
+    },
+    {
+      "name": "rowGroupIndex",
+      "type": "number",
+      "notes": "多级分组顺序（小者优先）；缺省按列定义顺序"
+    },
+    {
+      "name": "groupAgg",
+      "type": "SummaryAgg",
+      "notes": "分组 footer 行的聚合；缺省不在该列展示 group 汇总"
+    },
+    {
+      "name": "showGroupHeaderCell",
+      "type": "boolean",
+      "notes": "在该用户列渲染 groupHeader 单元格（chevron / 缩进 / 键值）。"
+    },
+    {
+      "name": "showGroupFooterCell",
+      "type": "boolean",
+      "notes": "在该用户列渲染 groupFooter 标签（如「小计」）。"
+    },
+    {
+      "name": "groupFooterLabel",
+      "type": "string",
+      "notes": "覆盖 Grid `groupFooterLabel` 的本列小计文案"
+    },
+    {
+      "name": "autoHeight",
+      "type": "boolean",
+      "notes": "该列内容撑开行高（与其他 autoHeight 列取 max）；默认 false"
+    },
+    {
+      "name": "colSpan",
+      "type": "ColSpanFn",
+      "notes": "横向合并列数（≥1）；表体与表尾共用，用 `params.isSummaryRow` 分支。"
+    },
+    {
+      "name": "rowSpan",
+      "type": "RowSpanFn",
+      "notes": "纵向合并行数（≥1）；仅表体。与 `spanRows` 互斥（本字段优先）。"
+    },
+    {
+      "name": "spanRows",
+      "type": "boolean | SpanRowsFunc",
+      "notes": "相邻等值自动纵向合并；`true` 或自定义比较函数。"
+    },
+    {
+      "name": "valueGetter",
+      "type": "(row: TData, value: unknown) => unknown",
+      "notes": "读取单元格展示值（优先于 prop 直读）"
+    },
+    {
+      "name": "formatter",
+      "type": "(row: TData, value: unknown) => string",
+      "notes": "格式化展示文案（不影响原始值）"
+    },
+    {
+      "name": "cellRenderer",
+      "type": "CellRendererFn",
+      "notes": "自定义单元格渲染器（函数；Vue 组件通过 MagicGrid 槽位注册）"
+    },
+    {
+      "name": "cellRendererMount",
+      "type": "CellRendererMountKind",
+      "notes": "renderer 挂载类型：`vue` 强制异步队列；`sync` 在 `cellRendererDefer=\"sync-only\"` 下同步挂载。"
+    },
+    {
+      "name": "cellEditor",
+      "type": "CellEditorDef",
+      "notes": "自定义单元格编辑器（函数、内置 text / number / checkbox / switch、或命名引用）"
+    },
+    {
+      "name": "cellEditorMode",
+      "type": "CellEditorMode",
+      "notes": "编辑器呈现：overlay 进编辑态；inline 常驻格内。默认 overlay"
+    },
+    {
+      "name": "cellEditorParams",
+      "type": "CellEditorParamsInput",
+      "notes": "列级编辑器配置（内置 checkbox / switch / 自定义编辑器统一入口）。"
+    },
+    {
+      "name": "cellEditorCache",
+      "type": "CellEditorCacheColumnFlag",
+      "notes": "为本列启用 cell editor cache API（overlay 列；inline 列忽略）。"
+    },
+    {
+      "name": "valueParser",
+      "type": "(value: unknown, params: CellEditorParams) => unknown",
+      "notes": "提交前解析编辑值"
+    },
+    {
+      "name": "valueSetter",
+      "type": "ValueSetterFn",
+      "notes": "自定义写回逻辑，返回 false 拒绝提交；可 async"
+    },
+    {
+      "name": "editType",
+      "type": "CellEditType",
+      "notes": "编辑触发策略，缺省继承 grid 级配置"
+    },
+    {
+      "name": "cellValidator",
+      "type": "CellValidator",
+      "notes": "手写校验（优先级高于 validationRules）"
+    },
+    {
+      "name": "cellCommitted",
+      "type": "CellCommittedHandler<TData>",
+      "notes": "值成功写回后的列级副作用钩子（编辑 / 粘贴 / 填充 / Delete）"
+    },
+    {
+      "name": "suppressPaste",
+      "type": "boolean | ((row: TData) => boolean)",
+      "notes": "禁止粘贴；可函数按行判断"
+    },
+    {
+      "name": "useParserForClipboard",
+      "type": "boolean",
+      "notes": "粘贴是否走 valueParser；默认 true"
+    },
+    {
+      "name": "useFormatterForClipboard",
+      "type": "boolean",
+      "notes": "复制是否走 formatter；默认 true"
+    },
+    {
+      "name": "validationRules",
+      "type": "ValidationRules",
+      "notes": "async-validator 规则；通过 magic-grid/validation enrichColumnsWithValidation 编译"
+    },
+    {
+      "name": "validationRequired",
+      "type": "boolean",
+      "notes": "必填列；表头文字前显示红色 *（缺省由 validationRules.required 推导）"
+    },
+    {
+      "name": "summary",
+      "type": "boolean",
+      "notes": "是否参与表尾汇总；缺省时：有 summaryAgg 则为 true，否则 false"
+    },
+    {
+      "name": "summaryAgg",
+      "type": "SummaryAgg",
+      "notes": "表尾汇总聚合：内置 sum / avg / min / max / count 或自定义函数"
+    },
+    {
+      "name": "summaryFormatter",
+      "type": "(value: unknown) => string",
+      "notes": "汇总格专用 formatter；缺省复用 formatter"
+    },
+    {
+      "name": "headerAlign",
+      "type": "GridHorizontalAlign",
+      "notes": "表头水平对齐；默认 center"
+    },
+    {
+      "name": "headerValign",
+      "type": "GridVerticalAlign",
+      "notes": "表头垂直对齐；默认 center"
+    },
+    {
+      "name": "align",
+      "type": "GridHorizontalAlign",
+      "notes": "表体水平对齐；默认 center"
+    },
+    {
+      "name": "valign",
+      "type": "GridVerticalAlign",
+      "notes": "表体垂直对齐；默认 center"
+    },
+    {
+      "name": "footerAlign",
+      "type": "GridHorizontalAlign",
+      "notes": "表尾汇总水平对齐；默认 center"
+    },
+    {
+      "name": "footerValign",
+      "type": "GridVerticalAlign",
+      "notes": "表尾汇总垂直对齐；默认 center"
+    },
+    {
+      "name": "suppressCellComments",
+      "type": "boolean | SuppressCellCommentFn<TData>",
+      "notes": "抑制该列（或特定行）的批注新建/编辑/删除。"
+    },
+    {
+      "name": "disabled",
+      "type": "boolean",
+      "notes": "列级禁用：true 时该列全部数据行 disabled"
+    },
+    {
+      "name": "cellDisabled",
+      "type": "boolean | CellDisabledFn<TData>",
+      "notes": "格级禁用：按行判定；与 disabled / isRowDisabled 叠加"
+    },
+    {
+      "name": "cellStyle",
+      "type": "CellStyle | CellStyleFn<TData>",
+      "notes": "列级静态背景 或 格级 cellStyle 回调（二选一 · 同 AG Grid cellStyle）。"
+    },
+    {
+      "name": "tooltipField",
+      "type": "Extract<keyof TData, string>",
+      "notes": "读 row.data[field] 作为 tooltip"
+    },
+    {
+      "name": "tooltipValueGetter",
+      "type": "TooltipValueGetter<TData>",
+      "notes": "自定义 tooltip 文案"
+    },
+    {
+      "name": "headerTooltip",
+      "type": "string",
+      "notes": "表头静态 tooltip"
+    },
+    {
+      "name": "headerTooltipValueGetter",
+      "type": "HeaderTooltipValueGetter",
+      "notes": "表头动态 tooltip 文案"
+    },
+    {
+      "name": "suppressTooltip",
+      "type": "boolean",
+      "notes": "抑制该列溢出 tooltip"
+    },
+    {
+      "name": "tooltipComponent",
+      "type": "TooltipComponentType",
+      "notes": "自定义 tooltip 组件"
+    },
+    {
+      "name": "tooltipComponentParams",
+      "type": "Record<string, unknown>",
+      "notes": "自定义 tooltip 组件额外参数"
+    }
+  ],
+  "rules": [
+    {
+      "id": "unknown-prop",
+      "severity": "error",
+      "autoFix": false,
+      "detectable": "static"
+    },
+    {
+      "id": "unknown-emit",
+      "severity": "error",
+      "autoFix": false,
+      "detectable": "static"
+    },
+    {
+      "id": "wrong-field-name",
+      "severity": "error",
+      "autoFix": true,
+      "detectable": "static"
+    },
+    {
+      "id": "prop-type-literal",
+      "severity": "error",
+      "autoFix": true,
+      "detectable": "literal-only"
+    },
+    {
+      "id": "tree-requires-getdatapath",
+      "severity": "error",
+      "autoFix": false,
+      "detectable": "literal-only"
+    },
+    {
+      "id": "tree-vs-rowgrouping",
+      "severity": "error",
+      "autoFix": false,
+      "detectable": "literal-only"
+    },
+    {
+      "id": "tree-lazy-requires-loader",
+      "severity": "error",
+      "autoFix": false,
+      "detectable": "literal-only"
+    },
+    {
+      "id": "move-under-sort-filter",
+      "severity": "warning",
+      "autoFix": false,
+      "detectable": "heuristic"
+    },
+    {
+      "id": "columndef-unknown-field",
+      "severity": "error",
+      "autoFix": false,
+      "detectable": "literal-only"
+    },
+    {
+      "id": "columndef-missing-key",
+      "severity": "error",
+      "autoFix": false,
+      "detectable": "literal-only"
+    },
+    {
+      "id": "columndef-duplicate-key",
+      "severity": "error",
+      "autoFix": false,
+      "detectable": "literal-only"
+    },
+    {
+      "id": "columndef-reserved-colid",
+      "severity": "error",
+      "autoFix": false,
+      "detectable": "literal-only"
+    },
+    {
+      "id": "missing-tokens-css",
+      "severity": "error",
+      "autoFix": true,
+      "detectable": "static"
+    },
+    {
+      "id": "css-order",
+      "severity": "error",
+      "autoFix": true,
+      "detectable": "static"
+    },
+    {
+      "id": "wrong-subpath",
+      "severity": "error",
+      "autoFix": true,
+      "detectable": "static"
+    },
+    {
+      "id": "reactive-data",
+      "severity": "warning",
+      "autoFix": false,
+      "detectable": "literal-only"
+    }
+  ],
+  "commonMistakes": [
+    {
+      "wrong": "columnDefs",
+      "right": "columns",
+      "kind": "prop"
+    },
+    {
+      "wrong": "rowData",
+      "right": "data",
+      "kind": "prop"
+    },
+    {
+      "wrong": "show-overflow-tooltip",
+      "right": "enableTooltips",
+      "kind": "prop"
+    },
+    {
+      "wrong": "field",
+      "right": "prop",
+      "kind": "columnDef"
+    },
+    {
+      "wrong": "headerName",
+      "right": "label",
+      "kind": "columnDef"
+    },
+    {
+      "wrong": "colId",
+      "right": "key",
+      "kind": "columnDef"
+    },
+    {
+      "wrong": "valueFormatter",
+      "right": "formatter",
+      "kind": "columnDef"
+    }
+  ],
+  "recipes": [
+    {
+      "id": "basic",
+      "intent": "基础只读表格：columns / data / rowKey 与样式引入 -->",
+      "code": "<!-- @intent 基础只读表格：columns / data / rowKey 与样式引入 -->\r\n<script setup lang=\"ts\">\r\nimport { ref } from 'vue'\r\nimport MagicGrid from '@taocompany/magic-grid'\r\nimport type { ColumnDef } from '@taocompany/magic-grid/types/core'\r\nimport '@taocompany/magic-grid/tokens.css'\r\nimport '@taocompany/magic-grid/style.css'\r\n\r\ninterface Row { id: number; name: string }\r\n\r\nconst columns = ref<ColumnDef<Row>[]>([\r\n  { prop: 'id', label: 'ID', width: 80 },\r\n  { prop: 'name', label: '名称' },\r\n])\r\nconst data = ref<Row[]>([\r\n  { id: 1, name: 'Alpha' },\r\n  { id: 2, name: 'Beta' },\r\n])\r\n</script>\r\n\r\n<template>\r\n  <MagicGrid :columns=\"columns\" :data=\"data\" row-key=\"id\" height=\"360\" />\r\n</template>\r\n"
+    },
+    {
+      "id": "edit-validation",
+      "intent": "单击编辑与列级 cellValidator -->",
+      "code": "<!-- @intent 单击编辑与列级 cellValidator -->\r\n<script setup lang=\"ts\">\r\nimport { ref } from 'vue'\r\nimport MagicGrid from '@taocompany/magic-grid'\r\nimport type { ColumnDef } from '@taocompany/magic-grid/types/core'\r\nimport '@taocompany/magic-grid/tokens.css'\r\nimport '@taocompany/magic-grid/style.css'\r\n\r\ninterface Row { id: number; qty: number }\r\n\r\nconst columns = ref<ColumnDef<Row>[]>([\r\n  { prop: 'id', label: 'ID', width: 80, editable: false },\r\n  {\r\n    prop: 'qty',\r\n    label: '数量',\r\n    editable: true,\r\n    cellValidator: (p) =>\r\n      Number(p.parsedValue) >= 0 ? undefined : ['须 ≥ 0'],\r\n  },\r\n])\r\nconst data = ref<Row[]>([{ id: 1, qty: 10 }])\r\n</script>\r\n\r\n<template>\r\n  <MagicGrid\r\n    :columns=\"columns\"\r\n    :data=\"data\"\r\n    row-key=\"id\"\r\n    edit-type=\"singleClick\"\r\n    invalid-edit-value-mode=\"block\"\r\n    height=\"360\"\r\n  />\r\n</template>\r\n"
+    },
+    {
+      "id": "pinned-summary",
+      "intent": "固定列与表尾汇总 -->",
+      "code": "<!-- @intent 固定列与表尾汇总 -->\r\n<script setup lang=\"ts\">\r\nimport { ref } from 'vue'\r\nimport MagicGrid from '@taocompany/magic-grid'\r\nimport type { ColumnDef } from '@taocompany/magic-grid/types/core'\r\nimport '@taocompany/magic-grid/tokens.css'\r\nimport '@taocompany/magic-grid/style.css'\r\n\r\ninterface Row { id: number; region: string; amount: number }\r\n\r\nconst columns = ref<ColumnDef<Row>[]>([\r\n  { prop: 'id', label: 'ID', width: 70, fixed: 'left' },\r\n  { prop: 'region', label: '区域' },\r\n  { prop: 'amount', label: '金额', summaryAgg: 'sum' },\r\n])\r\nconst data = ref<Row[]>([\r\n  { id: 1, region: '华东', amount: 100 },\r\n  { id: 2, region: '华北', amount: 200 },\r\n])\r\n</script>\r\n\r\n<template>\r\n  <MagicGrid\r\n    :columns=\"columns\"\r\n    :data=\"data\"\r\n    row-key=\"id\"\r\n    show-summary\r\n    summary-scope=\"displayed\"\r\n    height=\"360\"\r\n  />\r\n</template>\r\n"
+    },
+    {
+      "id": "filter-quick",
+      "intent": "列筛选与 quickFilterText -->",
+      "code": "<!-- @intent 列筛选与 quickFilterText -->\r\n<script setup lang=\"ts\">\r\nimport { ref } from 'vue'\r\nimport MagicGrid from '@taocompany/magic-grid'\r\nimport type { ColumnDef } from '@taocompany/magic-grid/types/core'\r\nimport '@taocompany/magic-grid/tokens.css'\r\nimport '@taocompany/magic-grid/style.css'\r\n\r\ninterface Row { id: number; sku: string }\r\n\r\nconst quickFilterText = ref('')\r\nconst columns = ref<ColumnDef<Row>[]>([\r\n  { prop: 'id', label: 'ID', width: 80 },\r\n  { prop: 'sku', label: 'SKU', filterable: true },\r\n])\r\nconst data = ref<Row[]>([\r\n  { id: 1, sku: 'A-001' },\r\n  { id: 2, sku: 'B-002' },\r\n])\r\n</script>\r\n\r\n<template>\r\n  <MagicGrid\r\n    :quick-filter-text=\"quickFilterText\"\r\n    :columns=\"columns\"\r\n    :data=\"data\"\r\n    row-key=\"id\"\r\n    filterable\r\n    height=\"360\"\r\n  />\r\n</template>\r\n"
+    },
+    {
+      "id": "selection-index",
+      "intent": "行选择与索引列 -->",
+      "code": "<!-- @intent 行选择与索引列 -->\r\n<script setup lang=\"ts\">\r\nimport { ref } from 'vue'\r\nimport MagicGrid from '@taocompany/magic-grid'\r\nimport type { ColumnDef } from '@taocompany/magic-grid/types/core'\r\nimport '@taocompany/magic-grid/tokens.css'\r\nimport '@taocompany/magic-grid/style.css'\r\n\r\ninterface Row { id: number; name: string }\r\n\r\nconst columns = ref<ColumnDef<Row>[]>([{ prop: 'name', label: '名称' }])\r\nconst data = ref<Row[]>([\r\n  { id: 1, name: 'One' },\r\n  { id: 2, name: 'Two' },\r\n])\r\n</script>\r\n\r\n<template>\r\n  <MagicGrid\r\n    :columns=\"columns\"\r\n    :data=\"data\"\r\n    row-key=\"id\"\r\n    row-selection=\"multiple\"\r\n    show-index-column\r\n    height=\"360\"\r\n  />\r\n</template>\r\n"
+    },
+    {
+      "id": "row-grouping",
+      "intent": "行分组 rowGrouping -->",
+      "code": "<!-- @intent 行分组 rowGrouping -->\r\n<script setup lang=\"ts\">\r\nimport { ref } from 'vue'\r\nimport MagicGrid from '@taocompany/magic-grid'\r\nimport type { ColumnDef } from '@taocompany/magic-grid/types/core'\r\nimport '@taocompany/magic-grid/tokens.css'\r\nimport '@taocompany/magic-grid/style.css'\r\n\r\ninterface Row { id: number; country: string; city: string }\r\n\r\nconst columns = ref<ColumnDef<Row>[]>([\r\n  { prop: 'country', label: '国家', rowGroup: true },\r\n  { prop: 'city', label: '城市' },\r\n])\r\nconst data = ref<Row[]>([\r\n  { id: 1, country: 'CN', city: '上海' },\r\n  { id: 2, country: 'CN', city: '北京' },\r\n])\r\n</script>\r\n\r\n<template>\r\n  <MagicGrid\r\n    :columns=\"columns\"\r\n    :data=\"data\"\r\n    row-key=\"id\"\r\n    row-grouping\r\n    :group-default-expanded=\"1\"\r\n    height=\"360\"\r\n  />\r\n</template>\r\n"
+    },
+    {
+      "id": "tree",
+      "intent": "树形表格 tree + 必填 getDataPath -->",
+      "code": "<!-- @intent 树形表格 tree + 必填 getDataPath -->\r\n<script setup lang=\"ts\">\r\nimport { ref } from 'vue'\r\nimport MagicGrid from '@taocompany/magic-grid'\r\nimport type { ColumnDef } from '@taocompany/magic-grid/types/core'\r\nimport '@taocompany/magic-grid/tokens.css'\r\nimport '@taocompany/magic-grid/style.css'\r\n\r\ninterface Row { id: string; name: string; pathSegments: string[] }\r\n\r\nconst columns = ref<ColumnDef<Row>[]>([{ prop: 'name', label: '节点' }])\r\nconst data = ref<Row[]>([\r\n  { id: '1', name: '根', pathSegments: ['根'] },\r\n  { id: '1-1', name: '子', pathSegments: ['根', '子'] },\r\n])\r\n\r\nfunction getDataPath(row: Row) {\r\n  return row.pathSegments\r\n}\r\n</script>\r\n\r\n<template>\r\n  <MagicGrid\r\n    :columns=\"columns\"\r\n    :data=\"data\"\r\n    row-key=\"id\"\r\n    tree\r\n    :get-data-path=\"getDataPath\"\r\n    height=\"360\"\r\n  />\r\n</template>\r\n"
+    },
+    {
+      "id": "tree-lazy",
+      "intent": "树形懒加载 loadTreeChildren -->",
+      "code": "<!-- @intent 树形懒加载 loadTreeChildren -->\r\n<script setup lang=\"ts\">\r\nimport { ref } from 'vue'\r\nimport MagicGrid from '@taocompany/magic-grid'\r\nimport type { ColumnDef } from '@taocompany/magic-grid/types/core'\r\nimport '@taocompany/magic-grid/tokens.css'\r\nimport '@taocompany/magic-grid/style.css'\r\n\r\ninterface Row { id: string; name: string; pathSegments: string[] }\r\n\r\nconst columns = ref<ColumnDef<Row>[]>([{ prop: 'name', label: '节点' }])\r\nconst data = ref<Row[]>([{ id: 'r', name: '根', pathSegments: ['根'] }])\r\n\r\nfunction getDataPath(row: Row) {\r\n  return row.pathSegments\r\n}\r\n\r\nasync function loadTreeChildren(parent: Row) {\r\n  return [{ id: `${parent.id}-1`, name: '懒加载子节点', pathSegments: [...parent.pathSegments, '子'] }]\r\n}\r\n\r\nfunction hasTreeChildren(row: Row) {\r\n  return row.pathSegments.length < 2\r\n}\r\n</script>\r\n\r\n<template>\r\n  <MagicGrid\r\n    :columns=\"columns\"\r\n    :data=\"data\"\r\n    row-key=\"id\"\r\n    tree\r\n    tree-lazy-load\r\n    :get-data-path=\"getDataPath\"\r\n    :load-tree-children=\"loadTreeChildren\"\r\n    :has-tree-children=\"hasTreeChildren\"\r\n    height=\"360\"\r\n  />\r\n</template>\r\n"
+    },
+    {
+      "id": "master-detail",
+      "intent": "主从展开 masterDetail + getDetailRowData -->",
+      "code": "<!-- @intent 主从展开 masterDetail + getDetailRowData -->\r\n<script setup lang=\"ts\">\r\nimport { ref } from 'vue'\r\nimport MagicGrid from '@taocompany/magic-grid'\r\nimport type { ColumnDef } from '@taocompany/magic-grid/types/core'\r\nimport '@taocompany/magic-grid/tokens.css'\r\nimport '@taocompany/magic-grid/style.css'\r\n\r\ninterface Row { id: number; orderNo: string }\r\n\r\nconst columns = ref<ColumnDef<Row>[]>([{ prop: 'orderNo', label: '订单号' }])\r\nconst data = ref<Row[]>([{ id: 1, orderNo: 'SO-1001' }])\r\n\r\nasync function getDetailRowData(_row: Row) {\r\n  return { lines: [{ sku: 'X', qty: 1 }] }\r\n}\r\n</script>\r\n\r\n<template>\r\n  <MagicGrid\r\n    :columns=\"columns\"\r\n    :data=\"data\"\r\n    row-key=\"id\"\r\n    master-detail\r\n    :get-detail-row-data=\"getDetailRowData\"\r\n    height=\"360\"\r\n  >\r\n    <template #detail-row=\"{ detailRowData }\">\r\n      <pre>{{ detailRowData }}</pre>\r\n    </template>\r\n  </MagicGrid>\r\n</template>\r\n"
+    },
+    {
+      "id": "cell-selection",
+      "intent": "框选与粘贴 cellSelection -->",
+      "code": "<!-- @intent 框选与粘贴 cellSelection -->\r\n<script setup lang=\"ts\">\r\nimport { ref } from 'vue'\r\nimport MagicGrid from '@taocompany/magic-grid'\r\nimport type { ColumnDef } from '@taocompany/magic-grid/types/core'\r\nimport '@taocompany/magic-grid/tokens.css'\r\nimport '@taocompany/magic-grid/style.css'\r\n\r\ninterface Row { id: number; a: number; b: number }\r\n\r\nconst columns = ref<ColumnDef<Row>[]>([\r\n  { prop: 'a', label: 'A' },\r\n  { prop: 'b', label: 'B' },\r\n])\r\nconst data = ref<Row[]>([\r\n  { id: 1, a: 1, b: 2 },\r\n  { id: 2, a: 3, b: 4 },\r\n])\r\n</script>\r\n\r\n<template>\r\n  <MagicGrid\r\n    :columns=\"columns\"\r\n    :data=\"data\"\r\n    row-key=\"id\"\r\n    :cell-selection=\"{ handleMode: 'range' }\"\r\n    enable-cell-paste\r\n    height=\"360\"\r\n  />\r\n</template>\r\n"
+    },
+    {
+      "id": "row-move",
+      "intent": "编程式行移动 GridApi.moveRow + indexMode -->",
+      "code": "<!-- @intent 编程式行移动 GridApi.moveRow + indexMode -->\r\n<script setup lang=\"ts\">\r\nimport { ref } from 'vue'\r\nimport { MagicGrid, type MagicGridComponent } from '@taocompany/magic-grid'\r\nimport type {\r\n  ColumnDef,\r\n  MagicGridExpose,\r\n  RowIndexMode,\r\n} from '@taocompany/magic-grid/types/core'\r\nimport '@taocompany/magic-grid/tokens.css'\r\nimport '@taocompany/magic-grid/style.css'\r\n\r\ninterface Row { id: number; name: string }\r\n\r\ntype MagicGridInstance = InstanceType<MagicGridComponent> & MagicGridExpose\r\n\r\nconst gridRef = ref<MagicGridInstance>()\r\nconst columns = ref<ColumnDef[]>([{ prop: 'name', label: '名称' }])\r\nconst data = ref<Row[]>([\r\n  { id: 1, name: 'First' },\r\n  { id: 2, name: 'Second' },\r\n])\r\n\r\nconst indexMode: RowIndexMode = 'source'\r\n\r\nfunction moveUp() {\r\n  void gridRef.value?.api?.moveRow(2, 0, indexMode)\r\n}\r\n</script>\r\n\r\n<template>\r\n  <button type=\"button\" @click=\"moveUp\">上移第二行</button>\r\n  <MagicGrid ref=\"gridRef\" :columns=\"columns\" :data=\"data\" row-key=\"id\" show-index-column height=\"360\" />\r\n</template>\r\n"
+    },
+    {
+      "id": "performance",
+      "intent": "虚拟滚动与渲染性能调参 -->",
+      "code": "<!-- @intent 虚拟滚动与渲染性能调参 -->\r\n<script setup lang=\"ts\">\r\nimport { ref } from 'vue'\r\nimport MagicGrid from '@taocompany/magic-grid'\r\nimport type { ColumnDef } from '@taocompany/magic-grid/types/core'\r\nimport '@taocompany/magic-grid/tokens.css'\r\nimport '@taocompany/magic-grid/style.css'\r\n\r\ninterface Row { id: number; value: string }\r\n\r\nconst columns = ref<ColumnDef<Row>[]>([\r\n  { prop: 'id', label: 'ID', width: 90 },\r\n  { prop: 'value', label: '值' },\r\n])\r\nconst data = ref<Row[]>(\r\n  Array.from({ length: 5000 }, (_, i) => ({ id: i + 1, value: `row-${i + 1}` })),\r\n)\r\n</script>\r\n\r\n<template>\r\n  <MagicGrid\r\n    :columns=\"columns\"\r\n    :data=\"data\"\r\n    row-key=\"id\"\r\n    :row-buffer=\"20\"\r\n    :scroll-end-flush-ms=\"16\"\r\n    cell-renderer-presentation=\"deferred\"\r\n    height=\"480\"\r\n  />\r\n</template>\r\n"
+    }
+  ]
+}