@taocompany/magic-grid 0.1.0

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

@@ -0,0 +1,537 @@
+/** 用户行数据：保持普通对象，禁止 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';
+/** 圆角：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 {
+    /** 列唯一标识，缺省等于 prop */
+    key?: string;
+    /** 数据字段 */
+    prop?: string;
+    /** 表头文案 */
+    label?: string;
+    /** 尺寸 */
+    width?: number;
+    minWidth?: number;
+    maxWidth?: number;
+    flex?: number;
+    /** 行为（后续里程碑逐步实现） */
+    sortable?: boolean;
+    /**
+     * 自定义排序比较器；入参为两行的单元格原始值（经 getter）。
+     * 须返回 asc 语义比较结果；desc 由 SortStage 统一取反。
+     */
+    comparator?: import('../core/types/columnSort').ColumnComparatorFn;
+    filterable?: boolean;
+    /** 列筛选数据类型；默认 text */
+    filterType?: import('../core/types/columnFilter').ColumnDataFilterType;
+    /** 列级 filter 参数（如 caseSensitive） */
+    filterParams?: import('../core/types/pipeline').FilterParams;
+    /** 筛选用取值；缺省同 getter / prop */
+    filterValueGetter?: (row: RowData) => unknown;
+    editable?: boolean | ((row: RowData) => boolean);
+    /** 是否允许拖拽调整列宽；缺省继承 Grid `resizable`（默认 true） */
+    resizable?: boolean;
+    /** 禁止 resize 把柄 dblclick / API auto-size；对标 AG Grid suppressAutoSize */
+    suppressAutoSize?: boolean;
+    /** 禁止参与 sizeColumnsToFit；对标 AG Grid suppressSizeToFit */
+    suppressSizeToFit?: boolean;
+    fixed?: 'left' | 'right' | null;
+    /** 是否允许表头拖拽重排；默认继承 grid.columnMovable */
+    movable?: boolean;
+    /** 该列单元格作为行拖拽起点；默认 false（Phase 15） */
+    rowDrag?: boolean;
+    /**
+     * Phase 17 · 在该列渲染 expand/collapse 控件；需 Grid `masterDetail: true`。
+     * 与 `showExpandColumn` 可并存（列级优先展示位置由列序决定）。
+     */
+    rowExpand?: boolean;
+    /**
+     * Phase 18 · 该列参与行分组；需 Grid `rowGrouping: true`。
+     * 与 `rowGroupIndex` 控制多级顺序。
+     */
+    rowGroup?: boolean;
+    /** Phase 18 · 多级分组顺序（小者优先）；缺省按列定义顺序 */
+    rowGroupIndex?: number;
+    /** Phase 18 · 分组 footer 行的聚合；缺省不在该列展示 group 汇总 */
+    groupAgg?: SummaryAgg;
+    /**
+     * Phase 18 · 在该用户列渲染 groupHeader 单元格（chevron / 缩进 / 键值）。
+     * 与系统 auto group 列二选一；不可用于系统列。
+     */
+    showGroupHeaderCell?: boolean;
+    /**
+     * Phase 18 · 在该用户列渲染 groupFooter 标签（如「小计」）。
+     * 聚合数值仍由 `groupAgg` 列展示。
+     */
+    showGroupFooterCell?: boolean;
+    /** Phase 18 · 覆盖 Grid `groupFooterLabel` 的本列小计文案 */
+    groupFooterLabel?: string;
+    /** 该列内容撑开行高（与其他 autoHeight 列取 max）；默认 false（Phase 15） */
+    autoHeight?: boolean;
+    /**
+     * Phase 16 · 横向合并列数（≥1）；表体与表尾共用，用 `params.isSummaryRow` 分支。
+     * 需 Grid `enableCellSpan: true`。系统列忽略。
+     */
+    colSpan?: import('../core/types/cellSpan').ColSpanFn;
+    /**
+     * Phase 16 · 纵向合并行数（≥1）；仅表体。与 `spanRows` 互斥（本字段优先）。
+     * 需 Grid `enableCellSpan: true`。系统列忽略。
+     */
+    rowSpan?: import('../core/types/cellSpan').RowSpanFn;
+    /**
+     * Phase 16 · 相邻等值自动纵向合并；`true` 或自定义比较函数。
+     * 需 Grid `enableCellSpan: true`。同列若同时配 `rowSpan` 则本字段不生效。
+     */
+    spanRows?: boolean | import('../core/types/cellSpan').SpanRowsFunc;
+    getter?: (row: RowData, value: unknown) => unknown;
+    formatter?: (row: RowData, value: unknown) => string;
+    /** 自定义单元格渲染器（函数；Vue 组件通过 MagicGrid 槽位注册） */
+    cellRenderer?: import('../core/types/cellRenderer').CellRendererFn;
+    /** 自定义单元格编辑器（函数、内置 text / number / checkbox、或命名引用） */
+    cellEditor?: import('../core/types/cellEditor').CellEditorDef;
+    /** 编辑器呈现：overlay 进编辑态；inline 常驻格内。默认 overlay */
+    cellEditorMode?: import('../core/types/cellEditorMode').CellEditorMode;
+    /** 提交前解析编辑值 */
+    valueParser?: (value: unknown, params: import('../core/types/cellEditor').CellEditorParams) => unknown;
+    /** 自定义写回逻辑，返回 false 拒绝提交；可 async（块 5） */
+    valueSetter?: (params: import('../core/types/cellEditor').CellEditorParams & {
+        newValue: unknown;
+        signal: AbortSignal;
+    }) => boolean | Promise<boolean>;
+    /** 编辑触发策略，缺省继承 grid 级配置 */
+    editType?: import('../core/types/cellEditor').CellEditType;
+    /** 手写校验（优先级高于 validationRules） */
+    cellValidator?: import('../core/types/validation').CellValidator;
+    /** Phase 24 块 12 · 禁止粘贴；可函数按行判断 */
+    suppressPaste?: boolean | import('../core/types/cellClipboard').SuppressPasteFn;
+    /** Phase 24 块 12 · 粘贴是否走 valueParser；默认 true */
+    useParserForClipboard?: boolean;
+    /** Phase 24 块 13 · 复制是否走 formatter；默认 true */
+    useFormatterForClipboard?: boolean;
+    /** async-validator 规则；通过 magic-grid/validation enrichColumnsWithValidation 编译 */
+    validationRules?: import('../core/types/validation').ValidationRules;
+    /** 必填列标记（缺省由 validationRules.required 推导） */
+    validationRequired?: boolean;
+    /** 是否参与表尾汇总；缺省时：有 summaryAgg 则为 true，否则 false */
+    summary?: boolean;
+    /** 表尾汇总聚合：内置 sum / avg / min / max / count 或自定义函数 */
+    summaryAgg?: SummaryAgg;
+    /** 汇总格专用 formatter；缺省复用 formatter */
+    summaryFormatter?: (value: unknown) => string;
+    /** 表头水平对齐；默认 center */
+    headerAlign?: MagicGridHorizontalAlign;
+    /** 表头垂直对齐；默认 center */
+    headerValign?: MagicGridVerticalAlign;
+    /** 表体水平对齐；默认 center */
+    align?: MagicGridHorizontalAlign;
+    /** 表体垂直对齐；默认 center */
+    valign?: MagicGridVerticalAlign;
+    /** 表尾汇总水平对齐；默认 center */
+    footerAlign?: MagicGridHorizontalAlign;
+    /** 表尾汇总垂直对齐；默认 center */
+    footerValign?: MagicGridVerticalAlign;
+    /**
+     * Phase 20 · 抑制该列（或特定行）的批注新建/编辑/删除。
+     * 已有批注仍可查看。
+     */
+    suppressCellComments?: boolean | import('../core/types/cellComment').SuppressCellCommentFn;
+    /** Phase 21 · 列级禁用：true 时该列全部数据行 disabled */
+    disabled?: boolean;
+    /** Phase 21 · 格级禁用：按行判定；与 disabled / isRowDisabled 叠加 */
+    cellDisabled?: boolean | import('../core/types/cellDisable').CellDisabledFn;
+    /**
+     * Phase 26 · 列级静态背景 或 格级 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 */
+    headerTooltip?: string;
+    headerTooltipValueGetter?: import('../core/types/overflowTooltip').HeaderTooltipValueGetter;
+    /** Phase 23 · 抑制该列溢出 tooltip */
+    suppressTooltip?: boolean;
+    tooltipComponent?: import('../core/types/overflowTooltip').TooltipComponentType;
+    tooltipComponentParams?: Record<string, unknown>;
+}
+export interface MagicGridProps {
+    /** 列定义 */
+    columns: ColumnDef[];
+    /** 行数据 */
+    data: RowData[];
+    /** Grid 实例级命名编辑器（colId 引用 cellEditor: 'name' 时解析；优先于全局注册表） */
+    cellEditorRegistry?: Record<string, import('../core/types/cellEditor').CellEditorFn>;
+    /** 行数据主键字段名（PK），用于行池复用与增量更新 */
+    rowKey?: string;
+    /** 斑马纹 */
+    stripe?: boolean;
+    /**
+     * 边框样式（默认 `border`）
+     * - border：表头 / 表体单元格全网格线（1px）
+     * - none：无单元格线；表头与表体保留底部分隔线
+     * - linear：表头 / 表体单元格仅底部分隔线
+     */
+    border?: MagicGridBorder;
+    /**
+     * 主题 preset；默认 `light`（亮色）。
+     * `dark` 切换暗色语义 token（`--mg-color-*`）。
+     */
+    theme?: MagicGridTheme;
+    /**
+     * 尺寸 preset；默认 `default`。
+     * rowHeight / headerHeight 未显式传入时，由 size 推导。
+     */
+    size?: MagicGridSize;
+    /**
+     * 容器圆角（px）；默认 `false`（无圆角）
+     * - `false` / `0`：圆角为 0
+     * - `true`：使用当前 size preset 的圆角
+     * - `number`：自定义圆角像素值
+     */
+    rounded?: MagicGridRounded;
+    /** 固定行高（px）；显式传入时覆盖 size preset */
+    rowHeight?: number;
+    /** 表头高度（px）；显式传入时覆盖 size preset */
+    headerHeight?: number;
+    /** 是否显示最左侧索引列；默认 false */
+    showIndexColumn?: boolean;
+    /** 索引列配置；showIndexColumn=true 时生效 */
+    indexColumn?: IndexColumnOptions;
+    /** 是否展示表尾汇总行；默认 false */
+    showSummary?: boolean;
+    /**
+     * 汇总计算范围；默认 `displayed`（rowsToDisplay，尊重 filter / sort）
+     * - displayed：当前可见行集
+     * - all：sourceRows 全量（忽略 filter）
+     */
+    summaryScope?: SummaryScope;
+    /** 汇总行高度（px）；未传时跟随 rowHeight / size preset */
+    summaryRowHeight?: number;
+    /**
+     * 全局汇总方法（优先级高于列级 summaryAgg）
+     * 返回 colId → 展示值；首列缺省可显示「合计」
+     */
+    summaryMethod?: SummaryMethod;
+    /** 表头水平对齐（全局默认）；默认 center */
+    headerAlign?: MagicGridHorizontalAlign;
+    /** 表头垂直对齐（全局默认）；默认 center */
+    headerValign?: MagicGridVerticalAlign;
+    /** 表体水平对齐（全局默认）；默认 center */
+    align?: MagicGridHorizontalAlign;
+    /** 表体垂直对齐（全局默认）；默认 center */
+    valign?: MagicGridVerticalAlign;
+    /** 表尾汇总水平对齐（全局默认）；默认 center */
+    footerAlign?: MagicGridHorizontalAlign;
+    /** 表尾汇总垂直对齐（全局默认）；默认 center */
+    footerValign?: MagicGridVerticalAlign;
+    /** 是否允许键盘/鼠标将焦点导航到表头；默认 false */
+    navigateHeader?: boolean;
+    /** 是否允许键盘/鼠标将焦点导航到表尾汇总行；默认 false（需 showSummary: true） */
+    navigateFooter?: boolean;
+    /** 行虚拟化缓冲行数 */
+    rowBuffer?: number;
+    /** 行选择模式，false 禁用；对象形式支持 groupSelectsChildren（Phase 19） */
+    rowSelection?: import('../core/types/rowSelectionOptions').RowSelectionInput;
+    /** 行选择列配置；rowSelection !== false 时生效 */
+    selectionColumn?: SelectionColumnOptions;
+    /**
+     * 行选择列：行 checkbox 是否可勾选；函数入参含 `data` / `rowId` / `rowIndex`。
+     * 省略时全部可选。
+     */
+    selectable?: SelectableFn;
+    /** 行选择列：数据刷新后是否保留选中行；默认 false */
+    reserveSelection?: boolean;
+    /** Phase 12 · Grid 级 quick filter 文本 */
+    quickFilterText?: string;
+    /** Phase 12 · 值选择搜索时的勾选投影模式；默认 `current` */
+    filterSetValueMode?: import('../core/types/filterGridOptions').FilterSetValueMode;
+    /** Phase 12 · 日期列值选择展示方式；默认 `tree` */
+    filterSetDateLayoutMode?: import('../core/types/filterGridOptions').FilterSetDateLayoutMode;
+    /** 编辑范围：cell 单格 / row 整行 */
+    editMode?: import('../core/types/cellEditor').EditMode;
+    /** 进入编辑态的触发方式，默认 singleClick */
+    editType?: import('../core/types/cellEditor').CellEditType;
+    /** 校验失败后：block 保持编辑 / revert 退出并恢复旧值 */
+    invalidEditValueMode?: import('../core/types/validation').InvalidEditValueMode;
+    /** 行编辑跨字段校验 */
+    rowValidator?: import('../core/types/validation').RowValidator;
+    /** Phase 6 · 异步行 CRUD 持久化钩子 */
+    asyncRowMutation?: import('../core/types/rowMutationAsync').AsyncRowMutationHandlers;
+    /** 容器高度 */
+    height?: string | number;
+    /** 容器宽度 */
+    width?: string | number;
+    /**
+     * 初始排序（Grid 挂载 / initGrid 时应用一次）；v1 仅使用首项
+     */
+    defaultSort?: SortModelItem[];
+    /** 是否允许用户列表头拖拽重排；默认 true（对齐 AG Grid；`:column-movable="false"` 关闭） */
+    columnMovable?: boolean;
+    /**
+     * 是否允许用户拖拽调整列宽；默认 `true`（对齐 AG Grid `defaultColDef.resizable`）。
+     * 列级 `columns[].resizable` **优先于**本配置；系统列（索引 / 行选择）恒为 false。
+     */
+    resizable?: boolean;
+    /**
+     * Phase 14 块 8 · 默认 Shift 模式：拖拽列宽时相邻列反向补偿，总宽不变。
+     * 对标 AG Grid `colResizeDefault: 'shift'`。
+     */
+    colResizeDefault?: 'shift';
+    /** 双击 resize 把柄 auto-size 时跳过表头宽度；对标 AG Grid skipHeaderOnAutoSize */
+    skipHeaderOnAutoSize?: boolean;
+    /** 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 行为）。
+     */
+    suppressMoveWhenColumnDragging?: boolean;
+    /** Phase 11.1 · 默认 false；true 关闭列移动 transition */
+    suppressColumnMoveAnimation?: boolean;
+    /**
+     * Phase 11.1 · 默认 false。
+     * true → 允许 drag / API 跨 fixed lane 并更新列 `fixed`。
+     */
+    allowCrossLaneColumnMove?: boolean;
+    /** Phase 11.2 · 默认 false；true → 未排序 sortable 列 hover 显示 faint 双三角 */
+    showUnsortedSortHintOnHover?: boolean;
+    /** 是否显示底部状态栏；默认 true */
+    showStatusBar?: boolean;
+    /** Phase 24.1 · 框选时在状态栏展示平均值/计数/求和；cellSelection 开时默认 true */
+    showStatusBarRangeAggregation?: boolean;
+    /**
+     * Phase 24.1 · 平均值 / 求和展示小数位数。
+     * 传 number 时同时作用于两者；默认 2。
+     */
+    statusBarRangeAggregationPrecision?: import('./statusBar').StatusBarRangeAggregationPrecisionInput;
+    /**
+     * Phase 15 · 启用 managed 行拖拽：拖拽过程中实时改 source 顺序；默认 true。
+     * 设为 false 时仅 emit `rowDragEnd`，由业务自行改序。
+     * 对标 AG Grid `rowDragManaged`。
+     */
+    rowDragManaged?: boolean;
+    /**
+     * Phase 15+ · managed 模式 commit 策略：`sync`（默认 live move）| `deferred`（mouseup 后 await onRowDragCommit）。
+     */
+    rowDragCommitMode?: import('../core/types/rowDrag').RowDragCommitMode;
+    /**
+     * deferred 模式：mouseup 后、apply 前调用；返回 false 则不写 source。
+     * MagicGrid 亦支持 `:on-row-drag-commit` prop（与 Grid option 等价）。
+     */
+    onRowDragCommit?: import('../core/types/rowDrag').RowDragCommitHandler;
+    /**
+     * Phase 15 · 行级动态高度（无 DOM）；优先于默认 rowHeight，低于手动 setRowHeight。
+     * 对标 AG Grid `getRowHeight`。
+     */
+    getRowHeight?: import('../core/types/rowHeight').GetRowHeightFn;
+    /** Phase 15 · 行高下限（px）；未传时跟随 size preset / rowHeight */
+    rowHeightMin?: number;
+    /** Phase 15 · 行高上限（px）；未传时无上限 */
+    rowHeightMax?: number;
+    /**
+     * Phase 16 · 启用单元格合并。默认 `false`。
+     * `true` 时解析列级 `colSpan` / `rowSpan` / `spanRows`，且行定位改用 `style.top`。
+     * 对标 AG Grid `enableCellSpan`。
+     */
+    enableCellSpan?: boolean;
+    /**
+     * Phase 17 · 启用主从展开行。默认 `false`。
+     * 对标 AG Grid `masterDetail`。
+     */
+    masterDetail?: boolean;
+    /** Phase 17 · 是否为主行（可展示 expand 控件）；缺省全部 data 行可展开 */
+    isRowMaster?: import('../core/types/rowExpansion').IsRowMasterFn;
+    /** Phase 17 · 默认展开层级：0 = 无；1 = 第一层；-1 = 全部 */
+    masterDefaultExpanded?: number;
+    /** Phase 17 · 详情行固定高度（px）；与 detailRowAutoHeight 并存时本字段优先 */
+    detailRowHeight?: number | import('../core/types/rowExpansion').DetailRowHeightFn;
+    /** Phase 17 · 详情行按内容自动撑高 */
+    detailRowAutoHeight?: boolean;
+    /**
+     * Phase 17 · false（默认）：详情 overlay 不随 center 横滚。
+     * true：详情嵌入 center lane。
+     */
+    embedFullWidthRows?: boolean;
+    /** Phase 17 · 最左展示专用展开列（fixed=left） */
+    showExpandColumn?: boolean;
+    /** Phase 17 · 异步提供详情区数据 */
+    getDetailRowData?: import('../core/types/rowExpansion').GetDetailRowDataFn;
+    /** Phase 17 · 自定义详情行渲染器（与 `#detail-row` 插槽二选一） */
+    detailCellRenderer?: import('../core/types/rowExpansion').DetailCellRendererFn;
+    /**
+     * Phase 18 · 启用行分组。默认 `false`。
+     * `true` 且存在 ≥1 个分组字段时生效。
+     */
+    rowGrouping?: boolean;
+    /** Phase 18 · 默认展开分组层级：0 = 全折叠；1 = 第一层；-1 = 全部展开。默认 `-1` */
+    groupDefaultExpanded?: number;
+    /** Phase 18 · 是否展示 groupHeader 分组标题行。默认 `false` */
+    showGroupHeader?: boolean;
+    /** Phase 18 · 是否为每个已展开的分组展示 footer 汇总行。默认 `false` */
+    showGroupFooter?: boolean;
+    /**
+     * Phase 18 · 分组展示模式。v1 仅实现 `singleColumn`。
+     * 默认 `singleColumn`。
+     */
+    groupDisplayType?: import('../core/types/rowGrouping').GroupDisplayType;
+    /** Phase 18 · 是否展示 auto group 系统列；默认 false */
+    showGroupColumn?: boolean;
+    /** Phase 18 · 覆盖 auto group 列的 colDef */
+    autoGroupColumnDef?: Partial<ColumnDef>;
+    /** Phase 18 · 分组键归一化（可选） */
+    groupKeyCreator?: import('../core/types/rowGrouping').GroupKeyCreatorFn;
+    /**
+     * Phase 18 · 同级 group 节点排序。缺省按 groupKey 升序（blank 置末）。
+     * 自定义时全权负责（含 blank）；不改变展示键。
+     */
+    groupComparator?: import('../core/types/rowGrouping').GroupComparatorFn;
+    /** Phase 18 · groupFooter 首列展示标签 */
+    groupFooterLabel?: string;
+    /** Phase 18 · 自定义分组单元格渲染器 */
+    groupCellRenderer?: import('../core/types/rowGrouping').GroupCellRendererFn;
+    /**
+     * Phase 19 · 启用树形表格。默认 `false`。
+     * 与 `rowGrouping` 互斥。
+     */
+    tree?: boolean;
+    /** Phase 19 · 树形路径回调；`tree: true` 时必填 */
+    getDataPath?: import('../core/types/treeTable').GetDataPathFn;
+    /**
+     * Phase 19 · 树形 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` */
+    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） */
+    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 */
+    suppressCellComments?: boolean;
+    /** Phase 20 · 查看已有批注的触发方式；默认 click（点角标 toggle） */
+    cellCommentTrigger?: import('../core/types/cellComment').CellCommentTrigger;
+    /** Phase 20 · hover 模式展示延迟 ms；默认 180 */
+    cellCommentShowDelay?: number;
+    /** Phase 20 · 离开 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 23 · 是否启用溢出 tooltip；默认 true */
+    enableTooltips?: boolean;
+    /** Phase 23 · 溢出 tooltip 显示策略；默认 whenTruncated */
+    tooltipShowMode?: import('../core/types/overflowTooltip').TooltipShowMode;
+    tooltipShowDelay?: number;
+    tooltipSwitchShowDelay?: number;
+    tooltipHideDelay?: number;
+    tooltipInteraction?: boolean;
+    tooltipMouseTrack?: boolean;
+    /** Phase 25 · 是否显示 loading overlay；undefined 为挂载后首次 setData 前自动 loading */
+    loading?: boolean;
+    /** Phase 25 · 逐项抑制内置 overlay */
+    suppressOverlays?: import('../core/types/emptyState').OverlayType[];
+    suppressLoadingOverlay?: boolean;
+    suppressNoRowsOverlay?: boolean;
+    suppressNoMatchingRowsOverlay?: boolean;
+    overlayLoadingTemplate?: string;
+    overlayNoRowsTemplate?: string;
+    overlayNoMatchingRowsTemplate?: string;
+    loadingOverlayComponent?: import('../core/types/emptyState').OverlayComponentType;
+    loadingOverlayComponentParams?: Record<string, unknown>;
+    noRowsOverlayComponent?: import('../core/types/emptyState').OverlayComponentType;
+    noRowsOverlayComponentParams?: Record<string, unknown>;
+    noMatchingRowsOverlayComponent?: import('../core/types/emptyState').OverlayComponentType;
+    noMatchingRowsOverlayComponentParams?: Record<string, unknown>;
+    overlayComponent?: import('../core/types/emptyState').OverlayComponentType;
+    overlayComponentParams?: Record<string, unknown>;
+    /** Phase 25 · overlay 内容是否可交互（默认可穿透） */
+    overlayInteraction?: boolean;
+    /**
+     * Phase 21 · 行级禁用：true 时该行全部数据列 disabled。
+     * 不影响 index / selection / expand / tree / group 系统列。
+     */
+    isRowDisabled?: boolean | import('../core/types/cellDisable').IsRowDisabledFn;
+    /**
+     * Phase 26 · 行级样式：对象 = 全表同色；函数 = 按行。
+     * 作用于表体用户数据列与行选择列；表头/表尾/索引列不参与。
+     */
+    rowStyle?: import('../core/types/cellColor').RowStyle;
+}
+/** `#loading` / `#no-rows` / `#no-matching-rows` 插槽 props（Phase 25） */
+export interface OverlaySlotParams {
+    overlayType: import('../core/types/emptyState').OverlayType;
+    api: import('../core/api/gridApi').GridApi;
+    overlayText?: string;
+}
+/** `#detail-row` 插槽 props（Phase 17） */
+export interface DetailRowSlotParams {
+    row: RowData;
+    rowId: string;
+    masterRowId: string;
+    detailRowData: unknown;
+    loading: boolean;
+    loadFailed: boolean;
+    loadError?: unknown;
+}
+//# sourceMappingURL=magic-grid.d.ts.map

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

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

package/dist/types/statusBar.d.ts

@@ -0,0 +1,37 @@
+import { GridApi } from '../core/api/gridApi';
+import { GridMetrics } from '../core/grid/gridMetrics';
+import { CellSelectionAggregation } from '../core/types/cellSelectionAggregation';
+export declare const DEFAULT_STATUS_BAR_RANGE_AGGREGATION_PRECISION = 2;
+/** 简写 number 同时作用于平均值 / 求和；对象可分别指定 */
+export type StatusBarRangeAggregationPrecisionInput = number | {
+    average?: number;
+    sum?: number;
+};
+export interface ResolvedStatusBarRangeAggregationPrecision {
+    average: number;
+    sum: number;
+}
+/** 传给 #status-bar 等插槽的 scoped context */
+export interface StatusBarContext {
+    /** GridApi 实例（与 expose 一致） */
+    api: GridApi | undefined;
+    /** 源数据总行数（过滤前） */
+    totalRowCount: number;
+    /** 当前展示行数（rowsToDisplay · 同 getMetrics().rowCount） */
+    displayedRowCount: number;
+    /** 是否处于过滤态 */
+    isFiltered: boolean;
+    /** 当前选中行数；rowSelection=false 时为 0 */
+    selectedRowCount: number;
+    /** 是否启用行选择 */
+    rowSelectionEnabled: boolean;
+    /** cellSelection 是否启用 */
+    cellSelectionEnabled: boolean;
+    /** 当前选区聚合；无选区或未启用时为 null */
+    cellSelectionAggregation: CellSelectionAggregation | null;
+    /** 平均值 / 求和展示小数位数（已归一） */
+    statusBarRangeAggregationPrecision: ResolvedStatusBarRangeAggregationPrecision;
+    /** 最近一次 metrics（Playground / 高级自定义用） */
+    metrics: GridMetrics | undefined;
+}
+//# sourceMappingURL=statusBar.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"statusBar.d.ts","sourceRoot":"","sources":["../../src/types/statusBar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACzD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAA;AAEpF,eAAO,MAAM,8CAA8C,IAAI,CAAA;AAE/D,sCAAsC;AACtC,MAAM,MAAM,uCAAuC,GAC/C,MAAM,GACN;IACE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,GAAG,CAAC,EAAE,MAAM,CAAA;CACb,CAAA;AAEL,MAAM,WAAW,0CAA0C;IACzD,OAAO,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,yCAAyC;AACzC,MAAM,WAAW,gBAAgB;IAC/B,8BAA8B;IAC9B,GAAG,EAAE,OAAO,GAAG,SAAS,CAAA;IACxB,kBAAkB;IAClB,aAAa,EAAE,MAAM,CAAA;IACrB,sDAAsD;IACtD,iBAAiB,EAAE,MAAM,CAAA;IACzB,cAAc;IACd,UAAU,EAAE,OAAO,CAAA;IACnB,qCAAqC;IACrC,gBAAgB,EAAE,MAAM,CAAA;IACxB,cAAc;IACd,mBAAmB,EAAE,OAAO,CAAA;IAC5B,yBAAyB;IACzB,oBAAoB,EAAE,OAAO,CAAA;IAC7B,4BAA4B;IAC5B,wBAAwB,EAAE,wBAAwB,GAAG,IAAI,CAAA;IACzD,0BAA0B;IAC1B,kCAAkC,EAAE,0CAA0C,CAAA;IAC9E,wCAAwC;IACxC,OAAO,EAAE,WAAW,GAAG,SAAS,CAAA;CACjC"}

package/dist/validation/asyncValidatorAdapter.d.ts

@@ -0,0 +1,15 @@
+import { default as Schema, Rule, Rules, ValidateError, ValidateFieldsError } from 'async-validator';
+import { CellValidator, RowValidator, ValidationSchema } from '../core/types/validation';
+import { ColumnDef } from '../types';
+export { Schema };
+export type { Rule, Rules, ValidateError, ValidateFieldsError };
+export declare function validateWithSchema(schema: Rules, source: Record<string, unknown>, options?: {
+    signal?: AbortSignal;
+}): Promise<string[] | null>;
+export declare function createCellValidator(field: string, rules: Rule | Rule[]): CellValidator;
+export declare function createRowValidator(schema: ValidationSchema): RowValidator;
+/** 判断 validationRules 是否包含 required 规则 */
+export declare function isValidationRequired(rules?: import('../core/types/validation').ValidationRules): boolean;
+/** 将 ColumnDef.validationRules 编译为 cellValidator（不覆盖已有 cellValidator） */
+export declare function enrichColumnsWithValidation(columns: ColumnDef[]): ColumnDef[];
+//# sourceMappingURL=asyncValidatorAdapter.d.ts.map

package/dist/validation/asyncValidatorAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asyncValidatorAdapter.d.ts","sourceRoot":"","sources":["../../src/validation/asyncValidatorAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,EAAE,EACb,KAAK,IAAI,EACT,KAAK,KAAK,EACV,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACzB,MAAM,iBAAiB,CAAA;AAGxB,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAC3F,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AAEvC,OAAO,EAAE,MAAM,EAAE,CAAA;AACjB,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,CAAA;AAqE/D,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,KAAK,EACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,GACjC,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAsB1B;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,GAAG,IAAI,EAAE,GAAG,aAAa,CAStF;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,GAAG,YAAY,CASzE;AAED,0CAA0C;AAC1C,wBAAgB,oBAAoB,CAAC,KAAK,CAAC,EAAE,OAAO,wBAAwB,EAAE,eAAe,GAAG,OAAO,CAUtG;AAED,yEAAyE;AACzE,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE,CAkB7E"}

package/dist/validation/index.d.ts

@@ -0,0 +1,3 @@
+export { Schema, createCellValidator, createRowValidator, enrichColumnsWithValidation, isValidationRequired, validateWithSchema, } from './asyncValidatorAdapter';
+export type { Rule, Rules, ValidateError, ValidateFieldsError } from './asyncValidatorAdapter';
+//# sourceMappingURL=index.d.ts.map

package/dist/validation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,mBAAmB,EACnB,kBAAkB,EAClB,2BAA2B,EAC3B,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,yBAAyB,CAAA;AAEhC,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAA"}

package/dist/validation-CD6lt5wS.cjs

@@ -0,0 +1,2 @@
+var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},s=(n,r,s)=>(s=n==null?{}:e(i(n)),o(r||!n||!n.__esModule||!a.call(n,`default`)?t(s,`default`,{value:n,enumerable:!0}):s,n));let c=require("async-validator");c=s(c,1);var l=class extends Error{name=`EditCommitAbortedError`;constructor(e=`Edit commit aborted`){super(e)}};function u(e){return e instanceof l}function d(e,t){t?.abort();let n=new AbortController;return{context:{signal:n.signal,commitId:e},abort:()=>{n.signal.aborted||n.abort(new l)}}}function f(e){if(e.aborted)throw new l}function p(e){return e.map(e=>e.message??String(e.field))}function m(e,t){return t?t.aborted?Promise.reject(t.reason):new Promise((n,r)=>{let i=()=>{t.removeEventListener(`abort`,i),r(t.reason)};t.addEventListener(`abort`,i),e.then(e=>{t.removeEventListener(`abort`,i),n(e)},e=>{t.removeEventListener(`abort`,i),r(e)})}):e}function h(e){return e.constructor.name===`AsyncFunction`}function g(e){let t=e,n=t.validator;if(typeof n==`function`&&t.asyncValidator==null&&h(n)){let{validator:e,...n}=t;return{...n,asyncValidator:e}}return e}function _(e){return(Array.isArray(e)?e:[e]).map(g)}function v(e){let t={};for(let[n,r]of Object.entries(e))t[n]=_(r);return t}async function y(e,t,n){let r=new c.default(v(e));try{return await m(r.validate(t),n?.signal),null}catch(e){if(u(e))throw e;return e&&typeof e==`object`&&`errors`in e?p(e.errors??[]):e instanceof Error?[e.message]:[`Validation failed`]}}function b(e,t){let n={[e]:t};return async t=>{let r={[e]:t.parsedValue};return y(n,r,{signal:t.signal})}}function x(e){return async t=>{let n={...t.data};for(let[e,r]of t.draftValues)n[e]=r;return y(e,n,{signal:t.signal})}}function S(e){return e?(Array.isArray(e)?e:[e]).some(e=>e.required===!0):!1}function C(e){return e.map(e=>{let t=e.validationRequired??S(e.validationRules);if(e.cellValidator||!e.validationRules||!e.prop)return t===e.validationRequired?e:{...e,validationRequired:t};let n=e.prop;return{...e,validationRequired:t,cellValidator:b(n,e.validationRules)}})}Object.defineProperty(exports,"a",{enumerable:!0,get:function(){return y}}),Object.defineProperty(exports,"c",{enumerable:!0,get:function(){return u}}),Object.defineProperty(exports,"i",{enumerable:!0,get:function(){return S}}),Object.defineProperty(exports,"l",{enumerable:!0,get:function(){return f}}),Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return x}}),Object.defineProperty(exports,"o",{enumerable:!0,get:function(){return l}}),Object.defineProperty(exports,"r",{enumerable:!0,get:function(){return C}}),Object.defineProperty(exports,"s",{enumerable:!0,get:function(){return d}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return b}});
+//# sourceMappingURL=validation-CD6lt5wS.cjs.map