@taocompany/magic-grid 0.1.0

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

@@ -0,0 +1,166 @@
+import { ColumnDef, RowData } from '../../types';
+import { RowNode } from './rowNode';
+import { BusinessRowId } from './businessRowId';
+/** 系统展开列 colId；用户 columns 不得占用 */
+export declare const EXPAND_COLUMN_ID = "__expand__";
+/** 展开列最小宽度 px */
+export declare const EXPAND_COLUMN_MIN_WIDTH = 40;
+/** 展开列默认宽度 px */
+export declare const EXPAND_COLUMN_DEFAULT_WIDTH = 40;
+/** detail 行 id 后缀：`${masterRowId}__detail` */
+export declare const DETAIL_ROW_ID_SUFFIX = "__detail";
+/** 默认详情行固定高度 px（拍板 #10） */
+export declare const DEFAULT_DETAIL_ROW_HEIGHT = 200;
+/** expand/collapse 按钮 DOM class */
+export declare const ROW_EXPAND_BUTTON_CLASS = "mg-cell__row-expand";
+/** 展开态图标 class */
+export declare const ROW_EXPAND_EXPANDED_CLASS = "mg-cell__row-expand--expanded";
+/** full width 详情行 overlay 容器 */
+export declare const FULL_WIDTH_ROWS_CONTAINER_CLASS = "mg-full-width-rows-container";
+/** 单条 full width 详情行 */
+export declare const FULL_WIDTH_ROW_CLASS = "mg-full-width-row";
+/** 详情内容 mount 点（autoHeight 测量目标） */
+export declare const FULL_WIDTH_ROW_CONTENT_CLASS = "mg-full-width-row__content";
+/** 已展开 master 行：底边由 detail 行承担 */
+export declare const EXPANDED_MASTER_ROW_CLASS = "mg-row--expanded-master";
+/** display 末行 detail overlay：底边由外框承担 */
+export declare const FULL_WIDTH_ROW_LAST_CLASS = "mg-full-width-row--last";
+export type RowKind = 'data' | 'detail' | 'groupHeader' | 'groupFooter';
+export type RowExpansionSource = 'api' | 'ui';
+/** 是否为主行（可展示 expand 控件） */
+export interface IsRowMasterParams {
+    rowId: BusinessRowId;
+    data: RowData;
+    rowIndex: number;
+}
+export type IsRowMasterFn = (params: IsRowMasterParams) => boolean;
+export interface DetailRowHeightParams {
+    rowId: BusinessRowId;
+    data: RowData;
+    masterRowId: BusinessRowId;
+}
+export type DetailRowHeightFn = (params: DetailRowHeightParams) => number;
+export interface GetDetailRowDataParams {
+    rowId: BusinessRowId;
+    data: RowData;
+    successCallback: (detailRowData: unknown) => void;
+    failCallback?: (error?: unknown) => void;
+}
+export type GetDetailRowDataFn = (params: GetDetailRowDataParams) => void | Promise<void>;
+/** 详情行渲染入参（插槽 / detailCellRenderer） */
+export interface DetailRowRendererParams {
+    /** detail 行 id */
+    rowId: BusinessRowId;
+    masterRowId: BusinessRowId;
+    data: RowData;
+    detailRowData: unknown;
+    loading: boolean;
+    /** getDetailRowData 失败时为 true */
+    loadFailed: boolean;
+    loadError?: unknown;
+}
+export interface DetailRowRendererMountContext {
+    mountEl: HTMLElement;
+    clear(): void;
+}
+export type DetailCellRendererFn = (params: DetailRowRendererParams, ctx: DetailRowRendererMountContext) => string | HTMLElement | void | null | undefined;
+/** Grid 级展开行配置（Phase 17 块 0） */
+export interface RowExpansionGridOptions {
+    /**
+     * 启用主从展开行。默认 `false`。
+     * 对标 AG Grid `masterDetail`。
+     */
+    masterDetail?: boolean;
+    /** 是否为主行；缺省全部 data 行可展开 */
+    isRowMaster?: IsRowMasterFn;
+    /** 默认展开层级：0 = 无；1 = 第一层；-1 = 全部（慎用） */
+    masterDefaultExpanded?: number;
+    /** 详情行固定高度（px）；与 detailRowAutoHeight 并存时本字段优先 */
+    detailRowHeight?: number | DetailRowHeightFn;
+    /** 详情行按内容自动撑高 */
+    detailRowAutoHeight?: boolean;
+    /**
+     * false（默认）：详情 overlay 不随 center 横滚。
+     * true：详情嵌入 center lane。
+     */
+    embedFullWidthRows?: boolean;
+    /** 最左展示专用展开列（fixed=left） */
+    showExpandColumn?: boolean;
+    /** 异步提供详情区数据 */
+    getDetailRowData?: GetDetailRowDataFn;
+    /** 自定义详情行渲染器（与 Vue `#detail-row` 插槽二选一） */
+    detailCellRenderer?: DetailCellRendererFn;
+}
+export interface ResolvedRowExpansionGridOptions {
+    masterDetail: boolean;
+    isRowMaster: IsRowMasterFn;
+    masterDefaultExpanded: number;
+    detailRowHeight: number | DetailRowHeightFn;
+    detailRowAutoHeight: boolean;
+    embedFullWidthRows: boolean;
+    showExpandColumn: boolean;
+    getDetailRowData?: GetDetailRowDataFn;
+    detailCellRenderer?: DetailCellRendererFn;
+}
+export declare function defaultIsRowMaster(_params: IsRowMasterParams): boolean;
+export declare function resolveRowExpansionGridOptions(options?: RowExpansionGridOptions): ResolvedRowExpansionGridOptions;
+export declare function isExpandColumn(colId: string): boolean;
+/** 列是否渲染 expand/collapse 控件 */
+export declare function isRowExpandColumn(column: {
+    colId: string;
+    rowExpand: boolean;
+}): boolean;
+export declare function isRowExpansionSystemColumn(colId: string): boolean;
+/**
+ * 列级 rowExpand：系统列（索引 / 行选择 / 展开列）恒 false。
+ */
+export declare function resolveColumnRowExpand(rowExpand: boolean | undefined, colId: string): boolean;
+export declare function resolveColumnDefRowExpand(column: ColumnDef, colId: string): boolean;
+/** 是否存在任意用户列启用 rowExpand */
+export declare function hasRowExpandColumn(columns: readonly ColumnDef[]): boolean;
+/** 是否应展示 expand 控件（Grid masterDetail + 列或 showExpandColumn） */
+export declare function isRowExpansionUiEnabled(masterDetail: boolean, showExpandColumn: boolean, columns: readonly ColumnDef[]): boolean;
+export declare function resolveRowKind(rowKind: RowKind | undefined): RowKind;
+export declare function buildDetailRowId(masterRowId: string): string;
+export declare function isDetailRowId(rowId: string): boolean;
+export declare function parseMasterRowIdFromDetailRowId(detailRowId: string): string | null;
+export declare function isDetailRowNode(row: Pick<RowNode, 'rowKind' | 'id'>): boolean;
+export declare function isDataRowNode(row: Pick<RowNode, 'rowKind' | 'id'>): boolean;
+export declare function resolveDetailRowHeightValue(detailRowHeight: number | DetailRowHeightFn, params: DetailRowHeightParams): number;
+/** 对标 Phase 17 rowExpanded / rowCollapsed 事件 */
+export interface RowExpansionChangedEvent {
+    rowId: BusinessRowId;
+    expanded: boolean;
+    source: RowExpansionSource;
+}
+/** 渲染层查询展开态的窄接口（Phase 17 块 5） */
+export interface RowExpansionHost {
+    active: () => boolean;
+    isRowMaster: (row: Pick<RowNode, 'id' | 'data' | 'rowIndex' | 'rowKind'>) => boolean;
+    isExpanded: (masterRowId: string) => boolean;
+}
+export declare function buildRowExpandedEvent(rowId: string, source: RowExpansionSource): RowExpansionChangedEvent;
+export declare function buildRowCollapsedEvent(rowId: string, source: RowExpansionSource): RowExpansionChangedEvent;
+/** 开发模式：用户 columns 占用系统展开列 colId 时告警 */
+export declare function warnIfUserColumnsConflictWithExpandColumn(columns: readonly ColumnDef[]): void;
+/**
+ * RowExpansionService 窄接口（块 1 实现）。
+ * 块 0 仅定义契约，供行模型 / 渲染 / API 依赖。
+ */
+export interface IRowExpansionService {
+    readonly active: boolean;
+    isExpanded(masterRowId: string): boolean;
+    expandRow(masterRowId: string, source: RowExpansionSource): void;
+    collapseRow(masterRowId: string, source: RowExpansionSource): void;
+    expandAll(source: RowExpansionSource): void;
+    collapseAll(source: RowExpansionSource): void;
+    /** 移除已从 source 删除的 master 展开态（filter 隐藏的行保留 expanded 态） */
+    pruneExpanded(existingMasterIds: ReadonlySet<string>): void;
+    /** setData 时清空展开态 */
+    clearExpanded(): void;
+    /** setData 后按 masterDefaultExpanded 初始化展开态 */
+    applyDefaultExpanded(rows: readonly RowNode[]): void;
+    injectDetailRows(rows: readonly RowNode[]): RowNode[];
+    createDetailRowNode(master: RowNode): RowNode;
+}
+//# sourceMappingURL=rowExpansion.d.ts.map

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

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

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

@@ -0,0 +1,222 @@
+import { ColumnDef, RowData } from '../../types';
+import { Column } from './column';
+import { RowNode } from './rowNode';
+import { SummaryAgg } from './summary';
+/** 系统 auto group 列 colId；用户 columns 不得占用 */
+export declare const GROUP_COLUMN_ID = "__group__";
+/** group 节点 stable id 前缀 */
+export declare const GROUP_ID_PREFIX = "group::";
+/** display 分组标题行 id 后缀：`${groupId}__header` */
+export declare const GROUP_HEADER_ID_SUFFIX = "__header";
+/** display 分组汇总行 id 后缀：`${groupId}__footer` */
+export declare const GROUP_FOOTER_ID_SUFFIX = "__footer";
+/** 空值分组键展示文案（拍板 #6） */
+export declare const GROUP_BLANK_KEY = "(Blanks)";
+/** auto group 列最小宽度 px */
+export declare const GROUP_COLUMN_MIN_WIDTH = 120;
+/** auto group 列默认宽度 px */
+export declare const GROUP_COLUMN_DEFAULT_WIDTH = 200;
+/** 分组 expand/collapse 按钮 DOM class */
+export declare const GROUP_EXPAND_BUTTON_CLASS = "mg-cell__group-expand";
+/** 分组展开态 chevron class */
+export declare const GROUP_EXPAND_EXPANDED_CLASS = "mg-cell__group-expand--expanded";
+/** 分组缩进 class 前缀：`mg-cell__group-indent-{level}` */
+export declare const GROUP_INDENT_CLASS_PREFIX = "mg-cell__group-indent-";
+/** 分组标题行 row class */
+export declare const GROUP_HEADER_ROW_CLASS = "mg-row--group-header";
+/** 分组汇总行 row class */
+export declare const GROUP_FOOTER_ROW_CLASS = "mg-row--group-footer";
+/** auto group 列 cell class */
+export declare const GROUP_AUTO_CELL_CLASS = "mg-cell--group-auto";
+/** groupFooter 首列缺省标签（拍板 #35 · 可选） */
+export declare const DEFAULT_GROUP_FOOTER_LABEL = "\u5C0F\u8BA1";
+/** 渲染层查询分组态的窄接口（Phase 18 块 6） */
+export interface RowGroupingHost {
+    active: () => boolean;
+    isExpanded: (groupId: string) => boolean;
+    getGroupFooterLabel?: () => string;
+}
+export type GroupDisplayType = 'singleColumn' | 'multipleColumns';
+export type RowGroupingSource = 'api' | 'ui';
+/** 分组键归一化入参 */
+export interface GroupKeyCreatorParams {
+    field: string;
+    colId: string;
+    value: unknown;
+    data: RowData;
+}
+export type GroupKeyCreatorFn = (params: GroupKeyCreatorParams) => string;
+/** 同级 group 节点排序入参（对标 AG initialGroupOrderComparator） */
+export interface GroupComparatorParams {
+    valueA: string;
+    valueB: string;
+    colId: string;
+    field: string;
+    level: number;
+}
+/** 同级 group 顺序比较器；缺省按 groupKey localeCompare（blank 置末） */
+export type GroupComparatorFn = (params: GroupComparatorParams) => number;
+/** 分组单元格渲染入参（auto group 列 / groupCellRenderer） */
+export interface GroupCellRendererParams {
+    rowKind: 'groupHeader' | 'groupFooter';
+    groupId: string;
+    groupField: string;
+    groupKey: string;
+    groupLevel: number;
+    groupLeafCount: number;
+    expanded: boolean;
+    aggValues?: GroupAggValuesMap;
+}
+export interface GroupCellRendererMountContext {
+    mountEl: HTMLElement;
+    clear(): void;
+}
+export type GroupCellRendererFn = (params: GroupCellRendererParams, ctx: GroupCellRendererMountContext) => string | HTMLElement | void | null | undefined;
+/** 分组 aggregate 单元格结果（与 SummaryCellResult 同形） */
+export interface GroupAggCellResult {
+    value: unknown;
+    formattedValue: string;
+}
+export type GroupAggValuesMap = Record<string, GroupAggCellResult>;
+/** Grid 级行分组配置（Phase 18 块 0） */
+export interface RowGroupingGridOptions {
+    /**
+     * 启用行分组。默认 `false`。
+     * `true` 且存在 ≥1 个分组字段时生效。
+     */
+    rowGrouping?: boolean;
+    /** 默认展开分组层级：0 = 全折叠；1 = 第一层；-1 = 全部展开。默认 `-1`（全部展开） */
+    groupDefaultExpanded?: number;
+    /** 是否展示 groupHeader 分组标题行。默认 `false` */
+    showGroupHeader?: boolean;
+    /** 是否为每个已展开的分组展示 footer 汇总行。默认 `false` */
+    showGroupFooter?: boolean;
+    /**
+     * 分组展示模式。v1 仅实现 `singleColumn`。
+     * 默认 `singleColumn`。
+     */
+    groupDisplayType?: GroupDisplayType;
+    /** 是否展示 auto group 系统列；默认 false */
+    showGroupColumn?: boolean;
+    /** 覆盖 auto group 列的 colDef（width / pinned / headerName 等） */
+    autoGroupColumnDef?: Partial<ColumnDef>;
+    /** 分组键归一化（可选） */
+    groupKeyCreator?: GroupKeyCreatorFn;
+    /**
+     * 同级 group 节点排序。缺省按 groupKey 升序（blank 置末）。
+     * 自定义时全权负责（含 blank）；不改变展示键。
+     */
+    groupComparator?: GroupComparatorFn;
+    /** groupFooter 首列展示标签；缺省 `DEFAULT_GROUP_FOOTER_LABEL` */
+    groupFooterLabel?: string;
+    /** 自定义分组单元格渲染器（与 auto group 列默认 UI 二选一） */
+    groupCellRenderer?: GroupCellRendererFn;
+}
+export interface ResolvedRowGroupingGridOptions {
+    rowGrouping: boolean;
+    groupDefaultExpanded: number;
+    showGroupHeader: boolean;
+    showGroupFooter: boolean;
+    groupDisplayType: GroupDisplayType;
+    showGroupColumn: boolean;
+    autoGroupColumnDef?: Partial<ColumnDef>;
+    groupKeyCreator?: GroupKeyCreatorFn;
+    groupComparator?: GroupComparatorFn;
+    groupFooterLabel: string;
+    groupCellRenderer?: GroupCellRendererFn;
+}
+export declare function resolveRowGroupingGridOptions(options?: RowGroupingGridOptions): ResolvedRowGroupingGridOptions;
+export declare function isGroupColumn(colId: string): boolean;
+/** 列是否为 auto group 列 */
+export declare function isRowGroupColumn(column: {
+    colId: string;
+}): boolean;
+export declare function isRowGroupingSystemColumn(colId: string): boolean;
+/**
+ * 列级 rowGroup：系统列（索引 / 行选择 / 展开 / group）恒 false。
+ */
+export declare function resolveColumnRowGroup(rowGroup: boolean | undefined, colId: string): boolean;
+export declare function resolveColumnDefRowGroup(column: ColumnDef, colId: string): boolean;
+export declare function resolveColumnDefRowGroupIndex(column: ColumnDef, colId: string): number | undefined;
+export declare function resolveColumnDefGroupAgg(column: ColumnDef, colId: string): SummaryAgg | undefined;
+export declare function resolveColumnDefShowGroupHeaderCell(column: ColumnDef, colId: string): boolean;
+export declare function resolveColumnDefShowGroupFooterCell(column: ColumnDef, colId: string): boolean;
+export declare function resolveColumnDefGroupFooterLabel(column: ColumnDef, colId: string): string | undefined;
+export declare function columnShowsGroupHeaderCell(column: Pick<Column, 'colId' | 'showGroupHeaderCell'>): boolean;
+export declare function columnShowsGroupFooterLabelCell(column: Pick<Column, 'colId' | 'showGroupFooterCell'>): boolean;
+/** 该列是否应渲染 group 头/小计标签 UI（不含 groupAgg 数值列） */
+export declare function columnRendersGroupCell(column: Pick<Column, 'colId' | 'showGroupHeaderCell' | 'showGroupFooterCell'>, rowNode: Pick<RowNode, 'rowKind' | 'id'>): boolean;
+/** 是否存在任意用户列启用 rowGroup */
+export declare function hasRowGroupColumn(columns: readonly ColumnDef[]): boolean;
+/** 从 ColumnDef 解析分组列 colId 顺序（rowGroupIndex 小者优先，否则按定义序） */
+export declare function resolveRowGroupColumnsFromDefs(columns: readonly ColumnDef[]): string[];
+/** 是否应展示 auto group 系统列（rowGrouping 总闸 + showGroupColumn，默认 false） */
+export declare function isRowGroupingUiEnabled(rowGrouping: boolean, showGroupColumn: boolean): boolean;
+/** 是否启用分组管线（总闸 + 至少一个分组字段） */
+export declare function isRowGroupingActive(rowGrouping: boolean, rowGroupColumns: readonly string[]): boolean;
+/** 将原始值归一化为分组键字符串 */
+export declare function normalizeGroupKey(value: unknown): string;
+/** 构建 stable group 节点 id */
+export declare function buildGroupId(level: number, field: string, key: string, parentGroupId?: string): string;
+/** 构建 groupPathKey（drag 守卫 · 从根到叶 group 的路径） */
+export declare function buildGroupPathKey(groupIds: readonly string[]): string;
+export declare function buildGroupHeaderRowId(groupId: string): string;
+export declare function buildGroupFooterRowId(groupId: string): string;
+export declare function isGroupHeaderRowId(rowId: string): boolean;
+export declare function isGroupFooterRowId(rowId: string): boolean;
+export declare function parseGroupIdFromDisplayRowId(displayRowId: string): string | null;
+export declare function isGroupHeaderRowNode(row: Pick<RowNode, 'rowKind' | 'id'>): boolean;
+export declare function isGroupFooterRowNode(row: Pick<RowNode, 'rowKind' | 'id'>): boolean;
+export declare function isGroupRowNode(row: Pick<RowNode, 'rowKind' | 'id' | 'group'>): boolean;
+/** 是否为参与用户数据的 leaf 行（非 group / detail / 合成 display 行） */
+export declare function isLeafDataRowNode(row: Pick<RowNode, 'rowKind' | 'id' | 'group'>): boolean;
+/** 对标 Phase 18 rowGroupOpened 事件 */
+export interface RowGroupOpenedEvent {
+    groupId: string;
+    expanded: boolean;
+    field: string;
+    key: string;
+    level: number;
+    source: RowGroupingSource;
+}
+/** 分组列变更事件 */
+export interface RowGroupChangedEvent {
+    columns: string[];
+    source: RowGroupingSource;
+}
+export declare function buildRowGroupOpenedEvent(params: {
+    groupId: string;
+    expanded: boolean;
+    field: string;
+    key: string;
+    level: number;
+    source: RowGroupingSource;
+}): RowGroupOpenedEvent;
+export declare function buildRowGroupChangedEvent(columns: string[], source: RowGroupingSource): RowGroupChangedEvent;
+/** 开发模式：用户 columns 占用系统 group 列 colId 时告警 */
+export declare function warnIfUserColumnsConflictWithGroupColumn(columns: readonly ColumnDef[]): void;
+/**
+ * RowGroupingService 窄接口（块 5 实现）。
+ * 块 0 仅定义契约，供行模型 / 渲染 / API 依赖。
+ */
+export interface IRowGroupingService {
+    readonly active: boolean;
+    getRowGroupColumns(): readonly string[];
+    setRowGroupColumns(colIds: readonly string[], source: RowGroupingSource): void;
+    isExpanded(groupId: string): boolean;
+    expandGroup(groupId: string, source: RowGroupingSource): void;
+    collapseGroup(groupId: string, source: RowGroupingSource): void;
+    expandAll(source: RowGroupingSource): void;
+    collapseAll(source: RowGroupingSource): void;
+    /** setData 时清空折叠态 */
+    clearExpanded(): void;
+    /** setData / 分组列变更后按 groupDefaultExpanded 初始化 */
+    applyDefaultExpanded(groupNodes: readonly RowNode[]): void;
+    /** leaf 行所属 group 路径键；非 leaf 返回 null */
+    getLeafGroupPathKey(row: RowNode): string | null;
+    /** 当前展开的 groupId 集合（map 阶段消费） */
+    getExpandedGroupIds(): ReadonlySet<string>;
+    /** group 树重建后移除已不存在的展开态 */
+    pruneExpanded(existingGroupIds: ReadonlySet<string>): void;
+}
+//# sourceMappingURL=rowGrouping.d.ts.map

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

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

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

@@ -0,0 +1,65 @@
+import { RowData, ColumnDef } from '../../types';
+import { BusinessRowId } from './businessRowId';
+/** 行高 resize handle DOM class（索引列底边） */
+export declare const ROW_RESIZE_HANDLE_CLASS = "mg-cell__row-resize-handle";
+/** 行高 resize 拖拽态 */
+export declare const ROW_RESIZING_CLASS = "mg-cell--row-resizing";
+/** autoHeight 单元格 */
+export declare const ROW_AUTO_HEIGHT_CELL_CLASS = "mg-cell--auto-height";
+/** 行高 resize 把柄命中高度 px（对标 Phase 14 列 resize 8px） */
+export declare const ROW_RESIZE_HANDLE_HIT_PX = 8;
+export interface GetRowHeightParams {
+    rowId: BusinessRowId;
+    data: RowData;
+    rowIndex: number;
+}
+/** 行级动态高度（无 DOM 测量）；返回 null/undefined 表示回退默认行高 */
+export type GetRowHeightFn = (params: GetRowHeightParams) => number | null | undefined;
+/** Grid 级行高配置（Phase 15 块 0） */
+export interface RowHeightGridOptions {
+    /**
+     * 行级动态高度（无 DOM）；优先于默认 rowHeight，低于手动 setRowHeight / rowHeightPinned。
+     * 对标 AG Grid `getRowHeight`。
+     */
+    getRowHeight?: GetRowHeightFn;
+    /** 行高下限（px）；未传时由 resolve 使用 defaultRowHeight */
+    rowHeightMin?: number;
+    /** 行高上限（px）；未传时表示无上限 */
+    rowHeightMax?: number;
+}
+export interface ResolvedRowHeightGridOptions {
+    getRowHeight?: GetRowHeightFn;
+    rowHeightMin: number;
+    /** null = 无上限 */
+    rowHeightMax: number | null;
+}
+export declare function resolveRowHeightGridOptions(options: RowHeightGridOptions | undefined, defaultRowHeight: number): ResolvedRowHeightGridOptions;
+/** 列级 autoHeight；系统列恒 false */
+export declare function resolveColumnAutoHeight(autoHeight: boolean | undefined, colId: string): boolean;
+export declare function resolveColumnDefAutoHeight(column: ColumnDef, colId: string): boolean;
+/** 是否存在任意用户列启用 autoHeight */
+export declare function hasAutoHeightColumn(columns: readonly ColumnDef[]): boolean;
+export declare function clampRowHeight(height: number, min: number, max: number | null): number;
+export type RowHeightChangeSource = 'api' | 'uiRowResized' | 'autoHeight' | 'dimensions';
+/** Grid 默认行高热更新参数（MagicGrid `rowHeight` prop 等） */
+export interface UpdateRowDimensionsParams {
+    rowHeight?: number;
+    rowHeightMin?: number;
+    rowHeightMax?: number;
+}
+export interface RowHeightChangeItem {
+    rowId: string;
+    rowHeight: number;
+}
+/** 对标 Phase 15 rowHeightChanged 事件 */
+export interface RowHeightChangedEvent {
+    rows: RowHeightChangeItem[];
+    finished: boolean;
+    source: RowHeightChangeSource;
+}
+export interface SetRowHeightChange {
+    rowId: string;
+    height: number;
+}
+export declare function buildRowHeightChangedEvent(rows: readonly RowHeightChangeItem[], finished: boolean, source: RowHeightChangeSource): RowHeightChangedEvent;
+//# sourceMappingURL=rowHeight.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rowHeight.d.ts","sourceRoot":"","sources":["../../../src/core/types/rowHeight.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AACrC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AAIvC,wCAAwC;AACxC,eAAO,MAAM,uBAAuB,+BAA+B,CAAA;AAEnE,oBAAoB;AACpB,eAAO,MAAM,kBAAkB,0BAA0B,CAAA;AAEzD,qBAAqB;AACrB,eAAO,MAAM,0BAA0B,yBAAyB,CAAA;AAEhE,oDAAoD;AACpD,eAAO,MAAM,wBAAwB,IAAI,CAAA;AAEzC,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,aAAa,CAAA;IACpB,IAAI,EAAE,OAAO,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,kDAAkD;AAClD,MAAM,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,kBAAkB,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;AAEtF,+BAA+B;AAC/B,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,YAAY,CAAC,EAAE,cAAc,CAAA;IAE7B,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB,wBAAwB;IACxB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,4BAA4B;IAC3C,YAAY,CAAC,EAAE,cAAc,CAAA;IAC7B,YAAY,EAAE,MAAM,CAAA;IACpB,iBAAiB;IACjB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5B;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,oBAAoB,YAAK,EAClC,gBAAgB,EAAE,MAAM,GACvB,4BAA4B,CAS9B;AAED,+BAA+B;AAC/B,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,OAAO,GAAG,SAAS,EAC/B,KAAK,EAAE,MAAM,GACZ,OAAO,CAMT;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAEpF;AAED,6BAA6B;AAC7B,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,GAAG,OAAO,CAK1E;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,GAAG,IAAI,GACjB,MAAM,CAOR;AAED,MAAM,MAAM,qBAAqB,GAAG,KAAK,GAAG,cAAc,GAAG,YAAY,GAAG,YAAY,CAAA;AAExF,mDAAmD;AACnD,MAAM,WAAW,yBAAyB;IACxC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,sCAAsC;AACtC,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,mBAAmB,EAAE,CAAA;IAC3B,QAAQ,EAAE,OAAO,CAAA;IACjB,MAAM,EAAE,qBAAqB,CAAA;CAC9B;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAED,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,SAAS,mBAAmB,EAAE,EACpC,QAAQ,EAAE,OAAO,EACjB,MAAM,EAAE,qBAAqB,GAC5B,qBAAqB,CAMvB"}

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

@@ -0,0 +1,8 @@
+/** 行主键 API 入参：与 data[rowKey] 一致，可为 number / string；内核统一规范为 string */
+export type RowId = string | number;
+/** 单个 rowId 或 rowId 数组（toggleRowSelection / setIndexFocus 等） */
+export type RowIdInput = RowId | readonly RowId[];
+export declare function normalizeRowId(rowId: RowId): string;
+export declare function normalizeRowIdInput(rowIds: RowIdInput): string[];
+export declare function normalizeRowIdList(rowIds?: readonly RowId[]): string[] | undefined;
+//# sourceMappingURL=rowId.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rowId.d.ts","sourceRoot":"","sources":["../../../src/core/types/rowId.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,MAAM,CAAA;AAEnC,gEAAgE;AAChE,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,SAAS,KAAK,EAAE,CAAA;AAEjD,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAEnD;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,EAAE,CAMhE;AAED,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,SAAS,KAAK,EAAE,GAAG,MAAM,EAAE,GAAG,SAAS,CAMlF"}

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

@@ -0,0 +1,26 @@
+import { RowNode } from './rowNode';
+export interface RowBounds {
+    rowTop: number;
+    rowHeight: number;
+}
+/** 行模型接口：渲染层唯一依赖的数据源 */
+export interface IRowModel {
+    /** O(1) 按索引取行 */
+    getRow(index: number): RowNode | undefined;
+    /** 显示行总数 */
+    getRowCount(): number;
+    /** O(log n) 像素 → 行索引 */
+    getRowIndexAtPixel(pixel: number): number;
+    /** O(1) 行边界 */
+    getRowBounds(index: number): RowBounds | null;
+    /** 内容区总高度（撑滚动条） */
+    getTotalHeight(): number;
+    /**
+     * 懒测量可见窗口内行高（可变行高阶段实现）
+     * @returns 是否有行高发生变化
+     */
+    ensureRowHeightsValid(top: number, bottom: number): boolean;
+    /** 渲染层唯一输入：扁平显示行数组 */
+    readonly rowsToDisplay: readonly RowNode[];
+}
+//# sourceMappingURL=rowModel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rowModel.d.ts","sourceRoot":"","sources":["../../../src/core/types/rowModel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAExC,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,wBAAwB;AACxB,MAAM,WAAW,SAAS;IACxB,iBAAiB;IACjB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAA;IAC1C,YAAY;IACZ,WAAW,IAAI,MAAM,CAAA;IACrB,wBAAwB;IACxB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;IACzC,eAAe;IACf,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAA;IAC7C,mBAAmB;IACnB,cAAc,IAAI,MAAM,CAAA;IACxB;;;OAGG;IACH,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAA;IAC3D,sBAAsB;IACtB,QAAQ,CAAC,aAAa,EAAE,SAAS,OAAO,EAAE,CAAA;CAC3C"}

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

@@ -0,0 +1,59 @@
+import { RowData } from '../../types';
+import { RowId } from './rowId';
+import { BusinessRowId } from './businessRowId';
+/** 行插入/删除下标基准：source = 存储顺序；display = 当前可见顺序（含 sort/filter） */
+export type RowIndexMode = 'source' | 'display';
+export interface AddRowItem {
+    /** 行数据；新增临时行时 rowKey 字段应省略或为 null */
+    data: RowData;
+}
+export interface AddRowsOptions {
+    rows: AddRowItem[];
+    /** 插入起始下标；省略 = 末尾 */
+    index?: number;
+    /** 下标基准，默认 'source' */
+    indexMode?: RowIndexMode;
+}
+export interface RemoveRowsOptions {
+    /** 内部 rowId 或业务 rowKey 值（number / string） */
+    rowIds?: RowId[];
+    /** 批量下标 */
+    indexes?: number[];
+    indexMode?: RowIndexMode;
+}
+export interface GetDataOptions {
+    /** true = source 顺序（默认）；false = 当前 display 顺序 */
+    sourceOrder?: boolean;
+}
+export interface PromoteRowIdOptions {
+    /** 当前 RowNode.id（通常为 __mg_tmp_*） */
+    rowId: RowId;
+    /** 正式业务主键，写入 data[rowKey] 并更新 RowNode.id */
+    businessId: string | number;
+}
+export type InternalPromoteRowIdResult = {
+    ok: true;
+    rowId: string;
+} | {
+    ok: false;
+    reason: string;
+};
+export type PromoteRowIdResult = {
+    ok: true;
+    rowId: BusinessRowId;
+} | {
+    ok: false;
+    reason: string;
+};
+/** 行变更事件中的行快照 */
+export interface RowMutationRowSnapshot {
+    rowId: BusinessRowId;
+    rowIndex: number;
+    data: RowData;
+    isTransient: boolean;
+}
+export interface RowMutationRemovedSnapshot {
+    rowId: BusinessRowId;
+    data: RowData;
+}
+//# sourceMappingURL=rowMutation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rowMutation.d.ts","sourceRoot":"","sources":["../../../src/core/types/rowMutation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AACrC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEpD,+DAA+D;AAC/D,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,SAAS,CAAA;AAE/C,MAAM,WAAW,UAAU;IACzB,qCAAqC;IACrC,IAAI,EAAE,OAAO,CAAA;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,UAAU,EAAE,CAAA;IAClB,qBAAqB;IACrB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,uBAAuB;IACvB,SAAS,CAAC,EAAE,YAAY,CAAA;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,6CAA6C;IAC7C,MAAM,CAAC,EAAE,KAAK,EAAE,CAAA;IAChB,WAAW;IACX,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,SAAS,CAAC,EAAE,YAAY,CAAA;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,iDAAiD;IACjD,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,oCAAoC;IACpC,KAAK,EAAE,KAAK,CAAA;IACZ,4CAA4C;IAC5C,UAAU,EAAE,MAAM,GAAG,MAAM,CAAA;CAC5B;AAED,MAAM,MAAM,0BAA0B,GAClC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC3B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAEjC,MAAM,MAAM,kBAAkB,GAC1B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,aAAa,CAAA;CAAE,GAClC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAEjC,iBAAiB;AACjB,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,aAAa,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,OAAO,CAAA;IACb,WAAW,EAAE,OAAO,CAAA;CACrB;AAED,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,aAAa,CAAA;IACpB,IAAI,EAAE,OAAO,CAAA;CACd"}

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

@@ -0,0 +1,49 @@
+import { RowData } from '../../types';
+import { RowIndexMode } from './rowMutation';
+/** 异步行变更持久化钩子（GridOptions.asyncRowMutation） */
+export interface AsyncRowMutationHandlers {
+    /** 新增：await 服务端成功后 apply 本地；reject 则不写入 */
+    add?: (params: AsyncRowMutationAddParams) => Promise<AsyncRowMutationAddResult | void>;
+    /** 更新：await 服务端成功后 apply 本地；reject 则不写入 */
+    update?: (params: AsyncRowMutationUpdateParams) => Promise<void>;
+    /** 删除：await 服务端成功后 apply 本地；reject 则不删除 */
+    remove?: (params: AsyncRowMutationRemoveParams) => Promise<void>;
+}
+export interface AsyncRowMutationAddParams {
+    rows: ReadonlyArray<{
+        data: RowData;
+    }>;
+    index?: number;
+    indexMode?: RowIndexMode;
+    signal: AbortSignal;
+}
+export interface AsyncRowMutationAddResultRow {
+    /** 写入 data[rowKey]；提供则创建持久化行（非 transient） */
+    businessId?: string | number;
+    /** 合并进 data（如服务端 enrich 字段） */
+    data?: RowData;
+}
+export interface AsyncRowMutationAddResult {
+    rows?: ReadonlyArray<AsyncRowMutationAddResultRow | void>;
+}
+export interface AsyncRowMutationUpdateParams {
+    rows: ReadonlyArray<{
+        rowId: string;
+        data: RowData;
+    }>;
+    signal: AbortSignal;
+}
+export interface AsyncRowMutationRemoveParams {
+    rowIds: readonly string[];
+    rows: ReadonlyArray<{
+        rowId: string;
+        data: RowData;
+    }>;
+    signal: AbortSignal;
+}
+/** 异步持久化失败时 reject 的错误类型 */
+export declare class RowMutationPersistError extends Error {
+    readonly cause?: unknown | undefined;
+    constructor(message: string, cause?: unknown | undefined);
+}
+//# sourceMappingURL=rowMutationAsync.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rowMutationAsync.d.ts","sourceRoot":"","sources":["../../../src/core/types/rowMutationAsync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AACrC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAEjD,+CAA+C;AAC/C,MAAM,WAAW,wBAAwB;IACvC,2CAA2C;IAC3C,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,yBAAyB,KAAK,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC,CAAA;IACtF,2CAA2C;IAC3C,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,4BAA4B,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAChE,2CAA2C;IAC3C,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,4BAA4B,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACjE;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;IACtC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,YAAY,CAAA;IACxB,MAAM,EAAE,WAAW,CAAA;CACpB;AAED,MAAM,WAAW,4BAA4B;IAC3C,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC5B,+BAA+B;IAC/B,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,CAAC,EAAE,aAAa,CAAC,4BAA4B,GAAG,IAAI,CAAC,CAAA;CAC1D;AAED,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,aAAa,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;IACrD,MAAM,EAAE,WAAW,CAAA;CACpB;AAED,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;IACzB,IAAI,EAAE,aAAa,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;IACrD,MAAM,EAAE,WAAW,CAAA;CACpB;AAED,4BAA4B;AAC5B,qBAAa,uBAAwB,SAAQ,KAAK;IAG9C,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO;gBADxB,OAAO,EAAE,MAAM,EACN,KAAK,CAAC,EAAE,OAAO,YAAA;CAK3B"}