@taocompany/magic-grid 0.1.6 → 0.3.0

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

@@ -1,154 +1,212 @@
+import { SummaryAgg, SummaryMethod, SummaryScope } from '../core/types/summary';
+import { GridHorizontalAlign, GridVerticalAlign } from '../core/types/align';
+import { IndexColumnOptions } from '../core/types/indexColumn';
+import { SelectionColumnOptions } from '../core/types/selectionColumn';
+import { SelectableFn } from '../core/selection/selectable';
+import { ColumnComparatorFn } from '../core/types/columnSort';
+import { SortModelItem } from '../core/types';
+import { ColumnDataFilterType } from '../core/types/columnFilter';
+import { FilterParams } from '../core/types/pipeline';
+import { ColSpanFn, RowSpanFn, SpanRowsFunc } from '../core/types/cellSpan';
+import { CellRendererFn } from '../core/types/cellRenderer';
+import { CellEditorDef, CellEditorParams, CellEditType, CellEditorFn, CellEditBehavior } from '../core/types/cellEditor';
+import { CellEditorMode } from '../core/types/cellEditorMode';
+import { CellValidator, ValidationRules, InvalidEditValueMode, RowValidator } from '../core/types/validation';
+import { SuppressCellCommentFn, CellCommentsDataSource, CellCommentTrigger } from '../core/types/cellComment';
+import { CellDisabledFn, IsRowDisabledFn } from '../core/types/cellDisable';
+import { CellStyle, CellStyleFn, RowStyle } from '../core/types/cellColor';
+import { TooltipValueGetter, HeaderTooltipValueGetter, TooltipComponentType, TooltipShowMode } from '../core/types/overflowTooltip';
+import { RowSelectionInput } from '../core/types/rowSelectionOptions';
+import { FilterSetValueMode, FilterSetDateLayoutMode } from '../core/types/filterGridOptions';
+import { AsyncRowMutationHandlers } from '../core/types/rowMutationAsync';
+import { AutoSizeStrategy } from '../core/types/columnAutosize';
+import { StatusBarHeightInput } from '../core/theme/gridSize';
+import { RowDragCommitMode, RowDragCommitHandler } from '../core/types/rowDrag';
+import { GetRowHeightFn } from '../core/types/rowHeight';
+import { IsRowMasterFn, DetailRowHeightFn, GetDetailRowDataFn, DetailCellRendererFn } from '../core/types/rowExpansion';
+import { GroupDisplayType, GroupKeyCreatorFn, GroupComparatorFn, GroupCellRendererFn } from '../core/types/rowGrouping';
+import { TreeDragScope, SetDataPathFn, GetDataPathFn, TreeValueGetterFn, TreeDisplayType, HasTreeChildrenFn, LoadTreeChildrenFn } from '../core/types/treeTable';
+import { ProcessCellForClipboardFn, ProcessCellFromClipboardFn, ProcessDataFromClipboardFn } from '../core/types/cellClipboard';
+import { CellSelectionOptions } from '../core/types/cellRangeSelection';
+import { OverlayType, OverlayComponentType } from '../core/types/emptyState';
+import { StatusBarRangeAggregationPosition, StatusBarRangeAggregationPrecisionInput } from './status-bar';
+import { GridApi } from '../core/api/gridApi';
 /** 用户行数据：保持普通对象，禁止 reactive 深代理 */
 export type RowData = Record<string, unknown>;
-export type TreeDragScope = import('../core/types/treeTable').TreeDragScope;
-export type SetDataPathParams = import('../core/types/treeTable').SetDataPathParams;
-export type SetDataPathFn = import('../core/types/treeTable').SetDataPathFn;
-export type MagicGridBorder = 'border' | 'none' | 'linear';
-export type MagicGridTheme = 'light' | 'dark';
-export type MagicGridSize = 'mini' | 'small' | 'default' | 'large';
+/**
+ * 边框样式（默认 `border`）
+ * - `border`：表头 / 表体单元格全网格线
+ * - `none`：无单元格线；表头与表体保留底部分隔线
+ * - `linear`：表头 / 表体单元格仅底部分隔线
+ */
+export type GridBorder = 'border' | 'none' | 'linear';
+/** 主题 preset：`light` 亮色（默认）；`dark` 暗色语义 token */
+export type GridTheme = 'light' | 'dark';
+/** 尺寸 preset；rowHeight / headerHeight 未显式传入时由 size 推导 */
+export type GridSize = 'mini' | 'small' | 'default' | 'large';
 /** 圆角：false/0 无圆角；true 跟随 size；number 自定义 px。默认 false */
-export type MagicGridRounded = number | boolean;
-export type SummaryScope = import('../core/types/summary').SummaryScope;
-export type SummaryAgg = import('../core/types/summary').SummaryAgg;
-export type SummaryAggBuiltin = import('../core/types/summary').SummaryAggBuiltin;
-export type SummaryAggFn = import('../core/types/summary').SummaryAggFn;
-export type SummaryMethod = import('../core/types/summary').SummaryMethod;
-export type SummaryMethodParams = import('../core/types/summary').SummaryMethodParams;
-export type MagicGridHorizontalAlign = import('../core/types/align').MagicGridHorizontalAlign;
-export type MagicGridVerticalAlign = import('../core/types/align').MagicGridVerticalAlign;
-export type IndexColumnOptions = import('../core/types/indexColumn').IndexColumnOptions;
-export type SelectionColumnOptions = import('../core/types/selectionColumn').SelectionColumnOptions;
-export type SelectableParams = import('../core/selection/selectable').SelectableParams;
-export type SelectableFn = import('../core/selection/selectable').SelectableFn;
-export type IsRowDisabledParams = import('../core/types/cellDisable').IsRowDisabledParams;
-export type IsRowDisabledFn = import('../core/types/cellDisable').IsRowDisabledFn;
-export type CellDisabledParams = import('../core/types/cellDisable').CellDisabledParams;
-export type CellDisabledFn = import('../core/types/cellDisable').CellDisabledFn;
-export type CellStyle = import('../core/types/cellColor').CellStyle;
-export type CellStyleFn = import('../core/types/cellColor').CellStyleFn;
-export type CellStyleParams = import('../core/types/cellColor').CellStyleParams;
-export type RowStyle = import('../core/types/cellColor').RowStyle;
-export type RowStyleFn = import('../core/types/cellColor').RowStyleFn;
-export type RowStyleParams = import('../core/types/cellColor').RowStyleParams;
-export type ColumnHiddenChangedEvent = import('../core/types/columnVisibility').ColumnHiddenChangedEvent;
-export type ColumnHiddenChangedSource = import('../core/types/columnVisibility').ColumnHiddenChangedSource;
-export type TooltipShowMode = import('../core/types/overflowTooltip').TooltipShowMode;
-export type TooltipValueGetter = import('../core/types/overflowTooltip').TooltipValueGetter;
-export type TooltipValueGetterParams = import('../core/types/overflowTooltip').TooltipValueGetterParams;
-export type HeaderTooltipValueGetter = import('../core/types/overflowTooltip').HeaderTooltipValueGetter;
-export type HeaderTooltipValueGetterParams = import('../core/types/overflowTooltip').HeaderTooltipValueGetterParams;
-export type ColumnComparatorFn = import('../core/types/columnSort').ColumnComparatorFn;
-export type SortModelItem = import('../core/types').SortModelItem;
-export interface ColumnDef {
+export type GridRounded = number | boolean;
+export type { TreeDragScope, SetDataPathParams, SetDataPathFn, GetDataPathFn, TreeValueGetterFn, TreeDisplayType, HasTreeChildrenFn, LoadTreeChildrenFn, } from '../core/types/treeTable';
+export type { SummaryScope, SummaryAgg, SummaryAggBuiltin, SummaryAggFn, SummaryMethod, SummaryMethodParams, } from '../core/types/summary';
+export type { GridHorizontalAlign, GridVerticalAlign } from '../core/types/align';
+export type { IndexColumnOptions } from '../core/types/indexColumn';
+export type { SelectionColumnOptions } from '../core/types/selectionColumn';
+export type { SelectableParams, SelectableFn } from '../core/selection/selectable';
+export type { IsRowDisabledParams, IsRowDisabledFn, CellDisabledParams, CellDisabledFn, } from '../core/types/cellDisable';
+export type { CellStyle, CellStyleFn, CellStyleParams, RowStyle, RowStyleFn, RowStyleParams, } from '../core/types/cellColor';
+export type { ColumnHiddenChangedEvent, ColumnHiddenChangedSource, } from '../core/types/columnVisibility';
+export type { TooltipShowMode, TooltipValueGetter, TooltipValueGetterParams, HeaderTooltipValueGetter, HeaderTooltipValueGetterParams, TooltipComponentType, } from '../core/types/overflowTooltip';
+export type { ColumnComparatorFn } from '../core/types/columnSort';
+export type { SortModelItem } from '../core/types';
+export type { ColumnDataFilterType } from '../core/types/columnFilter';
+export type { FilterParams, ColumnFilter } from '../core/types/pipeline';
+export type { ColSpanFn, RowSpanFn, SpanRowsFunc } from '../core/types/cellSpan';
+export type { CellEditorDef, CellEditorParams, CellEditType, CellEditorFn, CellEditBehavior, } from '../core/types/cellEditor';
+export type { CellEditorMode } from '../core/types/cellEditorMode';
+export type { CellValidator, ValidationRules, InvalidEditValueMode, RowValidator, } from '../core/types/validation';
+export type { SuppressCellCommentFn, CellCommentsDataSource, CellCommentTrigger, } from '../core/types/cellComment';
+export type { RowSelectionInput } from '../core/types/rowSelectionOptions';
+export type { FilterSetValueMode, FilterSetDateLayoutMode } from '../core/types/filterGridOptions';
+export type { AsyncRowMutationHandlers } from '../core/types/rowMutationAsync';
+export type { AutoSizeStrategy } from '../core/types/columnAutosize';
+export type { StatusBarHeightInput } from '../core/theme/gridSize';
+export type { RowDragCommitMode, RowDragCommitHandler } from '../core/types/rowDrag';
+export type { GetRowHeightFn } from '../core/types/rowHeight';
+export type { IsRowMasterFn, DetailRowHeightFn, GetDetailRowDataFn, DetailCellRendererFn, } from '../core/types/rowExpansion';
+export type { GroupDisplayType, GroupKeyCreatorFn, GroupComparatorFn, GroupCellRendererFn, } from '../core/types/rowGrouping';
+export type { ProcessCellForClipboardFn, ProcessCellFromClipboardFn, ProcessDataFromClipboardFn, } from '../core/types/cellClipboard';
+export type { CellSelectionOptions } from '../core/types/cellRangeSelection';
+export type { OverlayType, OverlayComponentType } from '../core/types/emptyState';
+export type { StatusBarRangeAggregationPosition, StatusBarRangeAggregationPrecisionInput, } from './status-bar';
+/** 列定义；`TData` 为行数据类型，用于 prop / 回调参数类型推导 */
+export interface ColumnDef<TData extends RowData = RowData> {
     /** 列唯一标识，缺省等于 prop */
     key?: string;
     /** 数据字段 */
-    prop?: string;
+    prop?: Extract<keyof TData, string>;
     /** 表头文案 */
     label?: string;
+    /**
+     * 列是否有效；默认 true。
+     * 为 false 时该列不存在于表格中（不参与列模型与绘制）；
+     * 与 hidden 不同——hidden 仍保留列，仅不渲染。
+     */
+    available?: boolean;
+    /**
+     * 是否隐藏该列（不渲染 header/body/footer · 不参与布局）。
+     * 默认 false（可见）。系统列忽略此配置。
+     */
+    hidden?: boolean;
     /** 尺寸 */
     width?: number;
+    /** 列最小宽度（px） */
     minWidth?: number;
+    /** 列最大宽度（px） */
     maxWidth?: number;
+    /** flex 布局权重；与 width 互斥时 flex 参与剩余空间分配 */
     flex?: number;
-    /** 行为（后续里程碑逐步实现） */
     /** 是否允许表头排序；缺省继承 Grid `sortable`（默认 false） */
     sortable?: boolean;
     /**
      * 自定义排序比较器；入参为两行的单元格原始值（经 valueGetter）。
-     * 须返回 asc 语义比较结果；desc 由 SortStage 统一取反。
+     * 须返回 asc 语义比较结果；desc 由 Grid 统一取反。
      */
-    comparator?: import('../core/types/columnSort').ColumnComparatorFn;
+    comparator?: ColumnComparatorFn;
     /** 是否允许列筛选；缺省继承 Grid `filterable`（默认 false） */
     filterable?: boolean;
     /** 列筛选数据类型；默认 text */
-    filterType?: import('../core/types/columnFilter').ColumnDataFilterType;
+    filterType?: ColumnDataFilterType;
     /** 列级 filter 参数（如 caseSensitive） */
-    filterParams?: import('../core/types/pipeline').FilterParams;
+    filterParams?: FilterParams;
+    /** 筛选用取值；缺省 formatter → valueGetter → prop */
     /** 筛选用取值；缺省 formatter → valueGetter → prop */
-    filterFormatter?: (row: RowData) => unknown;
-    editable?: boolean | ((row: RowData) => boolean);
+    filterFormatter?: (row: TData) => unknown;
+    /** 是否可编辑；可函数按行判断 */
+    editable?: boolean | ((row: TData) => boolean);
     /** 是否允许拖拽调整列宽；缺省继承 Grid `resizable`（默认 true） */
     resizable?: boolean;
     /** 禁止 resize 把柄 dblclick / API auto-size；对标 AG Grid suppressAutoSize */
     suppressAutoSize?: boolean;
     /** 禁止参与 sizeColumnsToFit；对标 AG Grid suppressSizeToFit */
     suppressSizeToFit?: boolean;
+    /** 列固定：left / right；null 或不传为不固定 */
     fixed?: 'left' | 'right' | null;
     /** 是否允许表头拖拽重排；默认继承 grid.columnMovable */
     movable?: boolean;
-    /** 该列单元格作为行拖拽起点；默认 false（Phase 15） */
+    /** 该列单元格作为行拖拽起点；默认 false */
     rowDrag?: boolean;
     /**
-     * Phase 17 · 在该列渲染 expand/collapse 控件；需 Grid `masterDetail: true`。
+     * 在该列渲染 expand/collapse 控件；需 Grid `masterDetail: true`。
      * 与 `showExpandColumn` 可并存（列级优先展示位置由列序决定）。
      */
     rowExpand?: boolean;
     /**
-     * Phase 18 · 该列参与行分组；需 Grid `rowGrouping: true`。
+     * 该列参与行分组；需 Grid `rowGrouping: true`。
      * 与 `rowGroupIndex` 控制多级顺序。
      */
     rowGroup?: boolean;
-    /** Phase 18 · 多级分组顺序（小者优先）；缺省按列定义顺序 */
+    /** 多级分组顺序（小者优先）；缺省按列定义顺序 */
     rowGroupIndex?: number;
-    /** Phase 18 · 分组 footer 行的聚合；缺省不在该列展示 group 汇总 */
+    /** 分组 footer 行的聚合；缺省不在该列展示 group 汇总 */
     groupAgg?: SummaryAgg;
     /**
-     * Phase 18 · 在该用户列渲染 groupHeader 单元格（chevron / 缩进 / 键值）。
+     * 在该用户列渲染 groupHeader 单元格（chevron / 缩进 / 键值）。
      * 与系统 auto group 列二选一；不可用于系统列。
      */
     showGroupHeaderCell?: boolean;
     /**
-     * Phase 18 · 在该用户列渲染 groupFooter 标签（如「小计」）。
+     * 在该用户列渲染 groupFooter 标签（如「小计」）。
      * 聚合数值仍由 `groupAgg` 列展示。
      */
     showGroupFooterCell?: boolean;
-    /** Phase 18 · 覆盖 Grid `groupFooterLabel` 的本列小计文案 */
+    /** 覆盖 Grid `groupFooterLabel` 的本列小计文案 */
     groupFooterLabel?: string;
-    /** 该列内容撑开行高（与其他 autoHeight 列取 max）；默认 false（Phase 15） */
+    /** 该列内容撑开行高（与其他 autoHeight 列取 max）；默认 false */
     autoHeight?: boolean;
     /**
-     * Phase 16 · 横向合并列数（≥1）；表体与表尾共用，用 `params.isSummaryRow` 分支。
+     * 横向合并列数（≥1）；表体与表尾共用，用 `params.isSummaryRow` 分支。
      * 需 Grid `enableCellSpan: true`。系统列忽略。
      */
-    colSpan?: import('../core/types/cellSpan').ColSpanFn;
+    colSpan?: ColSpanFn;
     /**
-     * Phase 16 · 纵向合并行数（≥1）；仅表体。与 `spanRows` 互斥（本字段优先）。
+     * 纵向合并行数（≥1）；仅表体。与 `spanRows` 互斥（本字段优先）。
      * 需 Grid `enableCellSpan: true`。系统列忽略。
      */
-    rowSpan?: import('../core/types/cellSpan').RowSpanFn;
+    rowSpan?: RowSpanFn;
     /**
-     * Phase 16 · 相邻等值自动纵向合并；`true` 或自定义比较函数。
+     * 相邻等值自动纵向合并；`true` 或自定义比较函数。
      * 需 Grid `enableCellSpan: true`。同列若同时配 `rowSpan` 则本字段不生效。
      */
-    spanRows?: boolean | import('../core/types/cellSpan').SpanRowsFunc;
-    valueGetter?: (row: RowData, value: unknown) => unknown;
-    formatter?: (row: RowData, value: unknown) => string;
+    spanRows?: boolean | SpanRowsFunc;
+    /** 读取单元格展示值（优先于 prop 直读） */
+    valueGetter?: (row: TData, value: unknown) => unknown;
+    /** 格式化展示文案（不影响原始值） */
+    formatter?: (row: TData, value: unknown) => string;
     /** 自定义单元格渲染器（函数；Vue 组件通过 MagicGrid 槽位注册） */
-    cellRenderer?: import('../core/types/cellRenderer').CellRendererFn;
+    cellRenderer?: CellRendererFn;
     /** 自定义单元格编辑器（函数、内置 text / number / checkbox、或命名引用） */
-    cellEditor?: import('../core/types/cellEditor').CellEditorDef;
+    cellEditor?: CellEditorDef;
     /** 编辑器呈现：overlay 进编辑态；inline 常驻格内。默认 overlay */
-    cellEditorMode?: import('../core/types/cellEditorMode').CellEditorMode;
+    cellEditorMode?: CellEditorMode;
     /** 提交前解析编辑值 */
-    valueParser?: (value: unknown, params: import('../core/types/cellEditor').CellEditorParams) => unknown;
-    /** 自定义写回逻辑，返回 false 拒绝提交；可 async（块 5） */
-    valueSetter?: (params: import('../core/types/cellEditor').CellEditorParams & {
+    valueParser?: (value: unknown, params: CellEditorParams) => unknown;
+    /** 自定义写回逻辑，返回 false 拒绝提交；可 async */
+    valueSetter?: (params: CellEditorParams & {
         newValue: unknown;
         signal: AbortSignal;
     }) => boolean | Promise<boolean>;
     /** 编辑触发策略，缺省继承 grid 级配置 */
-    editType?: import('../core/types/cellEditor').CellEditType;
+    editType?: CellEditType;
     /** 手写校验（优先级高于 validationRules） */
-    cellValidator?: import('../core/types/validation').CellValidator;
-    /** Phase 24 块 12 · 禁止粘贴；可函数按行判断 */
-    suppressPaste?: boolean | import('../core/types/cellClipboard').SuppressPasteFn;
-    /** Phase 24 块 12 · 粘贴是否走 valueParser；默认 true */
+    cellValidator?: CellValidator;
+    /** 禁止粘贴；可函数按行判断 */
+    suppressPaste?: boolean | ((row: TData) => boolean);
+    /** 粘贴是否走 valueParser；默认 true */
     useParserForClipboard?: boolean;
-    /** Phase 24 块 13 · 复制是否走 formatter；默认 true */
+    /** 复制是否走 formatter；默认 true */
     useFormatterForClipboard?: boolean;
     /** async-validator 规则；通过 magic-grid/validation enrichColumnsWithValidation 编译 */
-    validationRules?: import('../core/types/validation').ValidationRules;
+    validationRules?: ValidationRules;
     /** 必填列标记（缺省由 validationRules.required 推导） */
     validationRequired?: boolean;
     /** 是否参与表尾汇总；缺省时：有 summaryAgg 则为 true，否则 false */
@@ -158,55 +216,54 @@ export interface ColumnDef {
     /** 汇总格专用 formatter；缺省复用 formatter */
     summaryFormatter?: (value: unknown) => string;
     /** 表头水平对齐；默认 center */
-    headerAlign?: MagicGridHorizontalAlign;
+    headerAlign?: GridHorizontalAlign;
     /** 表头垂直对齐；默认 center */
-    headerValign?: MagicGridVerticalAlign;
+    headerValign?: GridVerticalAlign;
     /** 表体水平对齐；默认 center */
-    align?: MagicGridHorizontalAlign;
+    align?: GridHorizontalAlign;
     /** 表体垂直对齐；默认 center */
-    valign?: MagicGridVerticalAlign;
+    valign?: GridVerticalAlign;
     /** 表尾汇总水平对齐；默认 center */
-    footerAlign?: MagicGridHorizontalAlign;
+    footerAlign?: GridHorizontalAlign;
     /** 表尾汇总垂直对齐；默认 center */
-    footerValign?: MagicGridVerticalAlign;
+    footerValign?: GridVerticalAlign;
     /**
-     * Phase 20 · 抑制该列（或特定行）的批注新建/编辑/删除。
+     * 抑制该列（或特定行）的批注新建/编辑/删除。
      * 已有批注仍可查看。
      */
-    suppressCellComments?: boolean | import('../core/types/cellComment').SuppressCellCommentFn;
-    /** Phase 21 · 列级禁用：true 时该列全部数据行 disabled */
+    suppressCellComments?: boolean | SuppressCellCommentFn<TData>;
+    /** 列级禁用：true 时该列全部数据行 disabled */
     disabled?: boolean;
-    /** Phase 21 · 格级禁用：按行判定；与 disabled / isRowDisabled 叠加 */
-    cellDisabled?: boolean | import('../core/types/cellDisable').CellDisabledFn;
+    /** 格级禁用：按行判定；与 disabled / isRowDisabled 叠加 */
+    cellDisabled?: boolean | CellDisabledFn<TData>;
     /**
-     * Phase 26 · 列级静态背景 或 格级 cellStyle 回调（二选一 · 同 AG Grid cellStyle）。
+     * 列级静态背景 或 格级 cellStyle 回调（二选一 · 同 AG Grid cellStyle）。
      * 仅作用于表体用户数据列；表头/表尾/索引列/系统列不参与。
      */
-    cellStyle?: import('../core/types/cellColor').CellStyle | import('../core/types/cellColor').CellStyleFn;
-    /**
-     * Phase 22 · 是否隐藏该列（不渲染 header/body/footer · 不参与布局）。
-     * 默认 false（可见）。系统列忽略此配置。
-     */
-    hidden?: boolean;
-    /** Phase 23 · 读 row.data[field] 作为 tooltip */
-    tooltipField?: string;
-    /** Phase 23 · 自定义 tooltip 文案 */
-    tooltipValueGetter?: import('../core/types/overflowTooltip').TooltipValueGetter;
-    /** Phase 23 · 表头静态 tooltip */
+    cellStyle?: CellStyle | CellStyleFn<TData>;
+    /** 读 row.data[field] 作为 tooltip */
+    tooltipField?: Extract<keyof TData, string>;
+    /** 自定义 tooltip 文案 */
+    tooltipValueGetter?: TooltipValueGetter<TData>;
+    /** 表头静态 tooltip */
     headerTooltip?: string;
-    headerTooltipValueGetter?: import('../core/types/overflowTooltip').HeaderTooltipValueGetter;
-    /** Phase 23 · 抑制该列溢出 tooltip */
+    /** 表头动态 tooltip 文案 */
+    headerTooltipValueGetter?: HeaderTooltipValueGetter;
+    /** 抑制该列溢出 tooltip */
     suppressTooltip?: boolean;
-    tooltipComponent?: import('../core/types/overflowTooltip').TooltipComponentType;
+    /** 自定义 tooltip 组件 */
+    tooltipComponent?: TooltipComponentType;
+    /** 自定义 tooltip 组件额外参数 */
     tooltipComponentParams?: Record<string, unknown>;
 }
-export interface MagicGridProps {
+/** MagicGrid 组件 props；`TData` 为行数据类型，用于列定义与回调参数推导 */
+export interface MagicGridProps<TData extends RowData = RowData> {
     /** 列定义 */
-    columns: ColumnDef[];
+    columns: ColumnDef<TData>[];
     /** 行数据 */
-    data: RowData[];
+    data: TData[];
     /** Grid 实例级命名编辑器（colId 引用 cellEditor: 'name' 时解析；优先于全局注册表） */
-    cellEditorRegistry?: Record<string, import('../core/types/cellEditor').CellEditorFn>;
+    cellEditorRegistry?: Record<string, CellEditorFn>;
     /** 行数据主键字段名（PK），用于行池复用与增量更新 */
     rowKey?: string;
     /** 斑马纹 */
@@ -217,24 +274,24 @@ export interface MagicGridProps {
      * - none：无单元格线；表头与表体保留底部分隔线
      * - linear：表头 / 表体单元格仅底部分隔线
      */
-    border?: MagicGridBorder;
+    border?: GridBorder;
     /**
      * 主题 preset；默认 `light`（亮色）。
      * `dark` 切换暗色语义 token（`--mg-color-*`）。
      */
-    theme?: MagicGridTheme;
+    theme?: GridTheme;
     /**
      * 尺寸 preset；默认 `default`。
      * rowHeight / headerHeight 未显式传入时，由 size 推导。
      */
-    size?: MagicGridSize;
+    size?: GridSize;
     /**
      * 容器圆角（px）；默认 `false`（无圆角）
      * - `false` / `0`：圆角为 0
      * - `true`：使用当前 size preset 的圆角
      * - `number`：自定义圆角像素值
      */
-    rounded?: MagicGridRounded;
+    rounded?: GridRounded;
     /** 固定行高（px）；显式传入时覆盖 size preset */
     rowHeight?: number;
     /** 表头高度（px）；显式传入时覆盖 size preset */
@@ -259,25 +316,25 @@ export interface MagicGridProps {
      */
     summaryMethod?: SummaryMethod;
     /** 表头水平对齐（全局默认）；默认 center */
-    headerAlign?: MagicGridHorizontalAlign;
+    headerAlign?: GridHorizontalAlign;
     /** 表头垂直对齐（全局默认）；默认 center */
-    headerValign?: MagicGridVerticalAlign;
+    headerValign?: GridVerticalAlign;
     /** 表体水平对齐（全局默认）；默认 center */
-    align?: MagicGridHorizontalAlign;
+    align?: GridHorizontalAlign;
     /** 表体垂直对齐（全局默认）；默认 center */
-    valign?: MagicGridVerticalAlign;
+    valign?: GridVerticalAlign;
     /** 表尾汇总水平对齐（全局默认）；默认 center */
-    footerAlign?: MagicGridHorizontalAlign;
+    footerAlign?: GridHorizontalAlign;
     /** 表尾汇总垂直对齐（全局默认）；默认 center */
-    footerValign?: MagicGridVerticalAlign;
+    footerValign?: GridVerticalAlign;
     /** 是否允许键盘/鼠标将焦点导航到表头；默认 false */
     navigateHeader?: boolean;
     /** 是否允许键盘/鼠标将焦点导航到表尾汇总行；默认 false（需 showSummary: true） */
     navigateFooter?: boolean;
     /** 行虚拟化缓冲行数 */
     rowBuffer?: number;
-    /** 行选择模式，false 禁用；对象形式支持 groupSelectsChildren（Phase 19） */
-    rowSelection?: import('../core/types/rowSelectionOptions').RowSelectionInput;
+    /** 行选择模式，false 禁用；对象形式支持 groupSelectsChildren */
+    rowSelection?: RowSelectionInput;
     /** 行选择列配置；rowSelection !== false 时生效 */
     selectionColumn?: SelectionColumnOptions;
     /**
@@ -287,35 +344,35 @@ export interface MagicGridProps {
     selectable?: SelectableFn;
     /** 行选择列：数据刷新后是否保留选中行；默认 false */
     reserveSelection?: boolean;
-    /** Phase 12 · Grid 级 quick filter 文本 */
+    /** Grid 级 quick filter 文本 */
     quickFilterText?: string;
     /**
      * 是否允许列筛选；默认 `false`。
      * 列级 `columns[].filterable` **优先于**本配置；系统列（索引 / 行选择等）恒为 false。
      */
     filterable?: boolean;
-    /** Phase 12 · 表头下方 Floating Filter 行；默认 `false` */
+    /** 表头下方 Floating Filter 行；默认 `false` */
     floatingFilter?: boolean;
-    /** Phase 12 · 值选择搜索时的勾选投影模式；默认 `current` */
-    filterSetValueMode?: import('../core/types/filterGridOptions').FilterSetValueMode;
-    /** Phase 12 · 日期列值选择展示方式；默认 `tree` */
-    filterSetDateLayoutMode?: import('../core/types/filterGridOptions').FilterSetDateLayoutMode;
+    /** 值选择搜索时的勾选投影模式；默认 `current` */
+    filterSetValueMode?: FilterSetValueMode;
+    /** 日期列值选择展示方式；默认 `tree` */
+    filterSetDateLayoutMode?: FilterSetDateLayoutMode;
     /** 编辑范围：cell 单格 / row 整行 */
-    editMode?: import('../core/types/cellEditor').EditMode;
+    editBehavior?: CellEditBehavior;
     /** 进入编辑态的触发方式，默认 singleClick */
-    editType?: import('../core/types/cellEditor').CellEditType;
+    editType?: CellEditType;
     /** 校验失败后：block 保持编辑 / revert 退出并恢复旧值 */
-    invalidEditValueMode?: import('../core/types/validation').InvalidEditValueMode;
+    invalidEditValueMode?: InvalidEditValueMode;
     /** 行编辑跨字段校验 */
-    rowValidator?: import('../core/types/validation').RowValidator;
-    /** Phase 6 · 异步行 CRUD 持久化钩子 */
-    asyncRowMutation?: import('../core/types/rowMutationAsync').AsyncRowMutationHandlers;
+    rowValidator?: RowValidator;
+    /** 异步行 CRUD 持久化钩子 */
+    asyncRowMutation?: AsyncRowMutationHandlers;
     /** 容器高度 */
     height?: string | number;
     /** 容器宽度 */
     width?: string | number;
     /**
-     * 初始排序（Grid 挂载 / initGrid 时应用一次）；v1 仅使用首项
+     * 初始排序（Grid 挂载 / initGrid 时应用一次）；当前仅使用首项
      */
     defaultSort?: SortModelItem[];
     /**
@@ -331,7 +388,7 @@ export interface MagicGridProps {
      */
     resizable?: boolean;
     /**
-     * Phase 14 块 8 · 默认 Shift 模式：拖拽列宽时相邻列反向补偿，总宽不变。
+     * 默认 Shift 模式：拖拽列宽时相邻列反向补偿，总宽不变。
      * 对标 AG Grid `colResizeDefault: 'shift'`。
      */
     colResizeDefault?: 'shift';
@@ -340,227 +397,257 @@ export interface MagicGridProps {
     /** auto-size 内容测量额外 padding（px）；对标 AG Grid autoSizePadding */
     autoSizePadding?: number;
     /** 挂载 / 首屏 auto-size 策略；对标 AG Grid autoSizeStrategy */
-    autoSizeStrategy?: import('../core/types/columnAutosize').AutoSizeStrategy;
-    /** Phase 11.1 · 默认 false（drag 过程中 live move，对齐 AG Grid）。
-     * true → 仅 mouseup 提交列序（Phase 11 v1 行为）。
+    autoSizeStrategy?: AutoSizeStrategy;
+    /** 默认 false（drag 过程中 live move，对齐 AG Grid）。
+     * true → 仅 mouseup 提交列序。
      */
     suppressMoveWhenColumnDragging?: boolean;
-    /** Phase 11.1 · 默认 false；true 关闭列移动 transition */
+    /** 默认 false；true 关闭列移动 transition */
     suppressColumnMoveAnimation?: boolean;
     /**
-     * Phase 11.1 · 默认 false。
+     * 默认 false。
      * true → 允许 drag / API 跨 fixed lane 并更新列 `fixed`。
      */
     allowCrossLaneColumnMove?: boolean;
-    /** Phase 11.2 · 默认 false；true → 未排序 sortable 列 hover 显示 faint 双三角 */
+    /** 默认 false；true → 未排序 sortable 列 hover 显示 faint 双三角 */
     showUnsortedSortHintOnHover?: boolean;
     /** 是否显示底部状态栏；默认 true */
     showStatusBar?: boolean;
-    /** Phase 24.1 · 框选时在状态栏展示平均值/计数/求和；cellSelection 开时默认 true */
+    /**
+     * 状态栏高度：`'auto'` 跟随 size preset（默认）；number 为自定义 px。
+     */
+    statusBarHeight?: StatusBarHeightInput;
+    /** 框选时在状态栏展示平均值/计数/求和；cellSelection 开时默认 true */
     showStatusBarRangeAggregation?: boolean;
+    /** 框选聚合 panel 位置；默认 `right`（右栏内侧） */
+    statusBarRangeAggregationPosition?: StatusBarRangeAggregationPosition;
     /**
-     * Phase 24.1 · 平均值 / 求和展示小数位数。
+     * 平均值 / 求和展示小数位数。
      * 传 number 时同时作用于两者；默认 2。
      */
-    statusBarRangeAggregationPrecision?: import('./statusBar').StatusBarRangeAggregationPrecisionInput;
+    statusBarRangeAggregationPrecision?: StatusBarRangeAggregationPrecisionInput;
     /**
-     * Phase 15 · 启用 managed 行拖拽：拖拽过程中实时改 source 顺序；默认 true。
+     * 启用 managed 行拖拽：拖拽过程中实时改 source 顺序；默认 true。
      * 设为 false 时仅 emit `rowDragEnd`，由业务自行改序。
      * 对标 AG Grid `rowDragManaged`。
      */
     rowDragManaged?: boolean;
     /**
-     * Phase 15+ · managed 模式 commit 策略：`sync`（默认 live move）| `deferred`（mouseup 后 await onRowDragCommit）。
+     * managed 模式 commit 策略：`sync`（默认 live move）| `deferred`（mouseup 后 await onRowDragCommit）。
      */
-    rowDragCommitMode?: import('../core/types/rowDrag').RowDragCommitMode;
+    rowDragCommitMode?: RowDragCommitMode;
     /**
      * deferred 模式：mouseup 后、apply 前调用；返回 false 则不写 source。
      * MagicGrid 亦支持 `:on-row-drag-commit` prop（与 Grid option 等价）。
      */
-    onRowDragCommit?: import('../core/types/rowDrag').RowDragCommitHandler;
+    onRowDragCommit?: RowDragCommitHandler;
     /**
-     * Phase 15 · 行级动态高度（无 DOM）；优先于默认 rowHeight，低于手动 setRowHeight。
+     * 行级动态高度（无 DOM）；优先于默认 rowHeight，低于手动 setRowHeight。
      * 对标 AG Grid `getRowHeight`。
      */
-    getRowHeight?: import('../core/types/rowHeight').GetRowHeightFn;
-    /** Phase 15 · 行高下限（px）；未传时跟随 size preset / rowHeight */
+    getRowHeight?: GetRowHeightFn;
+    /** 行高下限（px）；未传时跟随 size preset / rowHeight */
     rowHeightMin?: number;
-    /** Phase 15 · 行高上限（px）；未传时无上限 */
+    /** 行高上限（px）；未传时无上限 */
     rowHeightMax?: number;
     /**
-     * Phase 16 · 启用单元格合并。默认 `false`。
+     * 启用单元格合并。默认 `false`。
      * `true` 时解析列级 `colSpan` / `rowSpan` / `spanRows`，且行定位改用 `style.top`。
      * 对标 AG Grid `enableCellSpan`。
      */
     enableCellSpan?: boolean;
     /**
-     * Phase 17 · 启用主从展开行。默认 `false`。
+     * 启用主从展开行。默认 `false`。
      * 对标 AG Grid `masterDetail`。
      */
     masterDetail?: boolean;
-    /** Phase 17 · 是否为主行（可展示 expand 控件）；缺省全部 data 行可展开 */
-    isRowMaster?: import('../core/types/rowExpansion').IsRowMasterFn;
-    /** Phase 17 · 默认展开层级：0 = 无；1 = 第一层；-1 = 全部 */
+    /** 是否为主行（可展示 expand 控件）；缺省全部 data 行可展开 */
+    isRowMaster?: IsRowMasterFn;
+    /** 默认展开层级：0 = 无；1 = 第一层；-1 = 全部 */
     masterDefaultExpanded?: number;
-    /** Phase 17 · 详情行固定高度（px）；与 detailRowAutoHeight 并存时本字段优先 */
-    detailRowHeight?: number | import('../core/types/rowExpansion').DetailRowHeightFn;
-    /** Phase 17 · 详情行按内容自动撑高 */
+    /** 详情行固定高度（px）；与 detailRowAutoHeight 并存时本字段优先 */
+    detailRowHeight?: number | DetailRowHeightFn;
+    /** 详情行按内容自动撑高 */
     detailRowAutoHeight?: boolean;
     /**
-     * Phase 17 · false（默认）：详情 overlay 不随 center 横滚。
+     * false（默认）：详情 overlay 不随 center 横滚。
      * true：详情嵌入 center lane。
      */
     embedFullWidthRows?: boolean;
-    /** Phase 17 · 最左展示专用展开列（fixed=left） */
+    /** 最左展示专用展开列（fixed=left） */
     showExpandColumn?: boolean;
-    /** Phase 17 · 异步提供详情区数据 */
-    getDetailRowData?: import('../core/types/rowExpansion').GetDetailRowDataFn;
-    /** Phase 17 · 自定义详情行渲染器（与 `#detail-row` 插槽二选一） */
-    detailCellRenderer?: import('../core/types/rowExpansion').DetailCellRendererFn;
+    /** 异步提供详情区数据 */
+    getDetailRowData?: GetDetailRowDataFn;
+    /** 自定义详情行渲染器（与 `#detail-row` 插槽二选一） */
+    detailCellRenderer?: DetailCellRendererFn;
     /**
-     * Phase 18 · 启用行分组。默认 `false`。
+     * 启用行分组。默认 `false`。
      * `true` 且存在 ≥1 个分组字段时生效。
      */
     rowGrouping?: boolean;
-    /** Phase 18 · 默认展开分组层级：0 = 全折叠；1 = 第一层；-1 = 全部展开。默认 `-1` */
+    /** 默认展开分组层级：0 = 全折叠；1 = 第一层；-1 = 全部展开。默认 `-1` */
     groupDefaultExpanded?: number;
-    /** Phase 18 · 是否展示 groupHeader 分组标题行。默认 `false` */
+    /** 是否展示 groupHeader 分组标题行。默认 `false` */
     showGroupHeader?: boolean;
-    /** Phase 18 · 是否为每个已展开的分组展示 footer 汇总行。默认 `false` */
+    /** 是否为每个已展开的分组展示 footer 汇总行。默认 `false` */
     showGroupFooter?: boolean;
     /**
-     * Phase 18 · 分组展示模式。v1 仅实现 `singleColumn`。
+     * 分组展示模式。当前仅支持 `singleColumn`。
      * 默认 `singleColumn`。
      */
-    groupDisplayType?: import('../core/types/rowGrouping').GroupDisplayType;
-    /** Phase 18 · 是否展示 auto group 系统列；默认 false */
+    groupDisplayType?: GroupDisplayType;
+    /** 是否展示 auto group 系统列；默认 false */
     showGroupColumn?: boolean;
-    /** Phase 18 · 覆盖 auto group 列的 colDef */
-    autoGroupColumnDef?: Partial<ColumnDef>;
-    /** Phase 18 · 分组键归一化（可选） */
-    groupKeyCreator?: import('../core/types/rowGrouping').GroupKeyCreatorFn;
+    /** 覆盖 auto group 列的 colDef */
+    autoGroupColumnDef?: Partial<ColumnDef<TData>>;
+    /** 分组键归一化（可选） */
+    groupKeyCreator?: GroupKeyCreatorFn;
     /**
-     * Phase 18 · 同级 group 节点排序。缺省按 groupKey 升序（blank 置末）。
+     * 同级 group 节点排序。缺省按 groupKey 升序（blank 置末）。
      * 自定义时全权负责（含 blank）；不改变展示键。
      */
-    groupComparator?: import('../core/types/rowGrouping').GroupComparatorFn;
-    /** Phase 18 · groupFooter 首列展示标签 */
+    groupComparator?: GroupComparatorFn;
+    /** groupFooter 首列展示标签 */
     groupFooterLabel?: string;
-    /** Phase 18 · 自定义分组单元格渲染器 */
-    groupCellRenderer?: import('../core/types/rowGrouping').GroupCellRendererFn;
+    /** 自定义分组单元格渲染器 */
+    groupCellRenderer?: GroupCellRendererFn;
     /**
-     * Phase 19 · 启用树形表格。默认 `false`。
+     * 启用树形表格。默认 `false`。
      * 与 `rowGrouping` 互斥。
      */
     tree?: boolean;
-    /** Phase 19 · 树形路径回调；`tree: true` 时必填 */
-    getDataPath?: import('../core/types/treeTable').GetDataPathFn;
+    /** 树形路径回调；`tree: true` 时必填 */
+    getDataPath?: GetDataPathFn;
     /**
-     * Phase 19 · 树形 managed 行拖拽范围。默认 `siblings`（仅同 parent 兄弟换序）；
+     * 树形 managed 行拖拽范围。默认 `siblings`（仅同 parent 兄弟换序）；
      * `hierarchy` 允许跨层级改父节点（需 `setDataPath` 写回路径）。
      */
-    treeDragScope?: import('../core/types/treeTable').TreeDragScope;
-    /** Phase 19 · hierarchy 模式下写回 dataPath；缺省时若 data.pathSegments 为数组则自动更新 */
-    setDataPath?: import('../core/types/treeTable').SetDataPathFn;
-    /** Phase 19 · 是否展示 tree 系统列。默认 `true` */
+    treeDragScope?: TreeDragScope;
+    /** hierarchy 模式下写回 dataPath；缺省时若 data.pathSegments 为数组则自动更新 */
+    setDataPath?: SetDataPathFn;
+    /** 是否展示 tree 系统列。默认 `true` */
     showTreeColumn?: boolean;
-    /** Phase 19 · 覆盖 tree 系统列 colDef */
-    autoTreeColumnDef?: Partial<ColumnDef>;
-    /** Phase 19 · 自定义 tree 列展示值 */
-    treeValueGetter?: import('../core/types/treeTable').TreeValueGetterFn;
-    /** Phase 19 · 树节点展示列模式。v1 仅 `singleColumn` */
-    treeDisplayType?: import('../core/types/treeTable').TreeDisplayType;
-    /** Phase 19 M25 · 启用树形懒加载（CSRM） */
+    /** 覆盖 tree 系统列 colDef */
+    autoTreeColumnDef?: Partial<ColumnDef<TData>>;
+    /** 自定义 tree 列展示值 */
+    treeValueGetter?: TreeValueGetterFn;
+    /** 树节点展示列模式。当前仅支持 `singleColumn` */
+    treeDisplayType?: TreeDisplayType;
+    /** 启用树形懒加载 */
     treeLazyLoad?: boolean;
-    /** Phase 19 M25 · lazy 模式：节点是否可能有未加载子行 */
-    hasTreeChildren?: import('../core/types/treeTable').HasTreeChildrenFn;
-    /** Phase 19 M25 · lazy 模式：首次展开时拉取子数据 */
-    loadTreeChildren?: import('../core/types/treeTable').LoadTreeChildrenFn;
-    /** Phase 20 · 单元格批注数据源；提供即启用 */
-    cellCommentsDataSource?: import('../core/types/cellComment').CellCommentsDataSource;
-    /** Phase 20 · 全局抑制批注交互；API 仍可 bypass */
+    /** lazy 模式：节点是否可能有未加载子行 */
+    hasTreeChildren?: HasTreeChildrenFn;
+    /** lazy 模式：首次展开时拉取子数据 */
+    loadTreeChildren?: LoadTreeChildrenFn;
+    /** 单元格批注数据源；提供即启用 */
+    cellCommentsDataSource?: CellCommentsDataSource;
+    /** 全局抑制批注交互；API 仍可 bypass */
     suppressCellComments?: boolean;
-    /** Phase 20 · 查看已有批注的触发方式；默认 click（点角标 toggle） */
-    cellCommentTrigger?: import('../core/types/cellComment').CellCommentTrigger;
-    /** Phase 20 · hover 模式展示延迟 ms；默认 180 */
+    /** 查看已有批注的触发方式；默认 click（点角标 toggle） */
+    cellCommentTrigger?: CellCommentTrigger;
+    /** hover 模式展示延迟 ms；默认 180 */
     cellCommentShowDelay?: number;
-    /** Phase 20 · 离开 cell/popup 后隐藏延迟 ms；默认 220 */
+    /** 离开 cell/popup 后隐藏延迟 ms；默认 220 */
     cellCommentHideDelay?: number;
-    /** Phase 24 · 复制单格时自定义导出值（最高优先级） */
-    processCellForClipboard?: import('../core/types/cellClipboard').ProcessCellForClipboardFn;
-    /** Phase 24 · 粘贴单格时预处理 clipboard 字符串 */
-    processCellFromClipboard?: import('../core/types/cellClipboard').ProcessCellFromClipboardFn;
-    /** Phase 24 · 整表粘贴前处理 TSV 矩阵；return null 取消粘贴 */
-    processDataFromClipboard?: import('../core/types/cellClipboard').ProcessDataFromClipboardFn;
-    /** Phase 24 · 单元格框选；MagicGrid 默认 true（含 enableColumnSelection，handle 默认 off），Grid API 未传时为 false */
-    cellSelection?: boolean | import('../core/types/cellRangeSelection').CellSelectionOptions;
-    /**
-     * @deprecated 使用 `enableCellCopy` / `enableCellPaste`。未单独指定时二者均继承本值。
-     * cellSelection 开启时默认 true。
-     */
-    enableCellClipboard?: boolean;
-    /** Phase 24 · 框选复制；cellSelection 开启时默认 true */
+    /** 复制单格时自定义导出值（最高优先级） */
+    processCellForClipboard?: ProcessCellForClipboardFn;
+    /** 粘贴单格时预处理 clipboard 字符串 */
+    processCellFromClipboard?: ProcessCellFromClipboardFn;
+    /** 整表粘贴前处理 TSV 矩阵；return null 取消粘贴 */
+    processDataFromClipboard?: ProcessDataFromClipboardFn;
+    /** 单元格框选；MagicGrid 默认 true（含 enableColumnSelection，handleMode 默认 off），Grid API 未传时为 false */
+    cellSelection?: boolean | CellSelectionOptions;
+    /** 框选复制；cellSelection 开启时默认 true */
     enableCellCopy?: boolean;
-    /** Phase 24 · 框选粘贴；cellSelection 开启时默认 false */
+    /** 框选粘贴；cellSelection 开启时默认 false */
     enableCellPaste?: boolean;
-    /** Phase 24 · 选区涉及列的表头底色；默认 true */
+    /** 选区涉及列的表头底色；默认 true */
     enableHeaderHighlight?: boolean;
-    /** Phase 24 · 选区行跨度内索引列高亮；默认 true */
+    /** 选区行跨度内索引列高亮；默认 true */
     enableIndexColumnHighlight?: boolean;
-    /** Phase 23 · 是否启用溢出 tooltip；默认 true */
+    /** 是否启用溢出 tooltip；默认 true */
     enableTooltips?: boolean;
-    /** Phase 23 · 溢出 tooltip 显示策略；默认 whenTruncated */
-    tooltipShowMode?: import('../core/types/overflowTooltip').TooltipShowMode;
+    /** 溢出 tooltip 显示策略；默认 whenTruncated */
+    tooltipShowMode?: TooltipShowMode;
+    /** 首次 hover 展示延迟 ms；默认 500 */
     tooltipShowDelay?: number;
+    /** 格间切换展示延迟 ms；默认 200 */
     tooltipSwitchShowDelay?: number;
+    /** 离开后隐藏延迟 ms；默认 3000 */
     tooltipHideDelay?: number;
+    /** tooltip 内容是否可交互；默认 false */
     tooltipInteraction?: boolean;
+    /** tooltip 是否跟随鼠标；默认 false */
     tooltipMouseTrack?: boolean;
-    /** Phase 25 · 是否显示 loading overlay；undefined 为挂载后首次 setData 前自动 loading */
+    /** 是否显示 loading overlay；undefined 为挂载后首次 setData 前自动 loading */
     loading?: boolean;
-    /** Phase 25 · 逐项抑制内置 overlay */
-    suppressOverlays?: import('../core/types/emptyState').OverlayType[];
+    /** 逐项抑制内置 overlay */
+    suppressOverlays?: OverlayType[];
+    /** 抑制 loading overlay */
     suppressLoadingOverlay?: boolean;
+    /** 抑制无数据 overlay */
     suppressNoRowsOverlay?: boolean;
+    /** 抑制无匹配行 overlay（filter 后为空） */
     suppressNoMatchingRowsOverlay?: boolean;
+    /** loading overlay 内置 HTML 模板 */
     overlayLoadingTemplate?: string;
+    /** 无数据 overlay 内置 HTML 模板 */
     overlayNoRowsTemplate?: string;
+    /** 无匹配行 overlay 内置 HTML 模板 */
     overlayNoMatchingRowsTemplate?: string;
-    loadingOverlayComponent?: import('../core/types/emptyState').OverlayComponentType;
+    /** 自定义 loading overlay 组件 */
+    loadingOverlayComponent?: OverlayComponentType;
+    /** loading overlay 组件额外参数 */
     loadingOverlayComponentParams?: Record<string, unknown>;
-    noRowsOverlayComponent?: import('../core/types/emptyState').OverlayComponentType;
+    /** 自定义无数据 overlay 组件 */
+    noRowsOverlayComponent?: OverlayComponentType;
+    /** 无数据 overlay 组件额外参数 */
     noRowsOverlayComponentParams?: Record<string, unknown>;
-    noMatchingRowsOverlayComponent?: import('../core/types/emptyState').OverlayComponentType;
+    /** 自定义无匹配行 overlay 组件 */
+    noMatchingRowsOverlayComponent?: OverlayComponentType;
+    /** 无匹配行 overlay 组件额外参数 */
     noMatchingRowsOverlayComponentParams?: Record<string, unknown>;
-    overlayComponent?: import('../core/types/emptyState').OverlayComponentType;
+    /** 通用 overlay 组件（按类型分发） */
+    overlayComponent?: OverlayComponentType;
+    /** 通用 overlay 组件额外参数 */
     overlayComponentParams?: Record<string, unknown>;
-    /** Phase 25 · overlay 内容是否可交互（默认可穿透） */
+    /** overlay 内容是否可交互（默认可穿透） */
     overlayInteraction?: boolean;
     /**
-     * Phase 21 · 行级禁用：true 时该行全部数据列 disabled。
+     * 行级禁用：true 时该行全部数据列 disabled。
      * 不影响 index / selection / expand / tree / group 系统列。
      */
-    isRowDisabled?: boolean | import('../core/types/cellDisable').IsRowDisabledFn;
+    isRowDisabled?: boolean | IsRowDisabledFn<TData>;
     /**
-     * Phase 26 · 行级样式：对象 = 全表同色；函数 = 按行。
+     * 行级样式：对象 = 全表同色；函数 = 按行。
      * 作用于表体用户数据列与行选择列；表头/表尾/索引列不参与。
      */
-    rowStyle?: import('../core/types/cellColor').RowStyle;
+    rowStyle?: RowStyle<TData>;
 }
-/** `#loading` / `#no-rows` / `#no-matching-rows` 插槽 props（Phase 25） */
+/** `#loading` / `#no-rows` / `#no-matching-rows` 插槽 props */
 export interface OverlaySlotParams {
-    overlayType: import('../core/types/emptyState').OverlayType;
-    api: import('../core/api/gridApi').GridApi;
+    /** 当前 overlay 类型 */
+    overlayType: OverlayType;
+    /** GridApi 实例 */
+    api: GridApi;
+    /** 内置 overlay 默认文案（自定义组件可忽略） */
     overlayText?: string;
 }
-/** `#detail-row` 插槽 props（Phase 17） */
-export interface DetailRowSlotParams {
-    row: RowData;
+/** `#detail-row` 插槽 props */
+export interface DetailRowSlotParams<TData extends RowData = RowData> {
+    /** 主行数据 */
+    row: TData;
+    /** 主行 rowId */
     rowId: string;
+    /** 与 rowId 相同（兼容别名） */
     masterRowId: string;
+    /** 详情区数据（`getDetailRowData` 返回值） */
     detailRowData: unknown;
+    /** 详情数据是否加载中 */
     loading: boolean;
+    /** 详情数据是否加载失败 */
     loadFailed: boolean;
+    /** 加载失败时的错误对象 */
     loadError?: unknown;
 }
 //# sourceMappingURL=magic-grid.d.ts.map