@taocompany/magic-grid 0.1.0

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

@@ -0,0 +1,71 @@
+import { RowData } from '../../types';
+import { RowKind } from './rowExpansion';
+import { GroupAggValuesMap } from './rowGrouping';
+/** 行节点：数据层与渲染层的统一单元 */
+export interface RowNode {
+    /** 池化复用键（必须稳定） */
+    id: string;
+    /** 用户数据（普通对象，禁止 reactive 深代理） */
+    data: RowData;
+    /** true = 尚未分配业务 rowKey；getData 导出时 rowKey 为 null */
+    isTransient?: boolean;
+    /** 由 positionRows 累计计算（不变量） */
+    rowTop: number;
+    /** 固定行高或实测行高 */
+    rowHeight: number;
+    /** 行高是否为估算值（v1 固定行高时为 false） */
+    estimated: boolean;
+    /** 在 rowsToDisplay 中的下标 */
+    rowIndex: number;
+    /** Phase 17 · 行种类；缺省 `data` */
+    rowKind?: RowKind;
+    /** Phase 17 · detail 行：指向主行 id */
+    masterRowId?: string;
+    /** Phase 17 · master 行：getDetailRowData 结果缓存（内核字段） */
+    __detailRowData?: unknown;
+    /** Phase 17 · master 行：详情加载态 */
+    __detailLoading?: boolean;
+    /** Phase 17 · master 行：详情加载失败原因 */
+    __detailLoadError?: unknown;
+    /** 用户/API 手动锁定行高后，autoHeight 不再覆盖（Phase 15） */
+    rowHeightPinned?: boolean;
+    /** autoHeight 各列实测高度缓存（Phase 15 · 内核字段） */
+    __autoHeights?: Record<string, number>;
+    /** 排序阶段产物（后续 M5 启用） */
+    childrenAfterSort?: RowNode[];
+    /** Phase 18 · 是否为分组树节点（非用户 leaf 数据） */
+    group?: boolean;
+    /** Phase 18 · 分组字段 colId */
+    groupField?: string;
+    /** Phase 18 · 分组键展示值 */
+    groupKey?: string;
+    /** Phase 18 · 分组层级 0..n-1 */
+    groupLevel?: number;
+    /** Phase 18 · 稳定分组 id */
+    groupId?: string;
+    /** Phase 18 · 从根到本 group 的路径键（drag 守卫） */
+    groupPathKey?: string;
+    /** Phase 18 · leaf 行：所属 group 路径键 */
+    leafGroupPathKey?: string;
+    /** Phase 18 · group 阶段子节点 */
+    childrenAfterGroup?: RowNode[];
+    /** Phase 18 · filter 阶段后子节点 */
+    childrenAfterFilter?: RowNode[];
+    /** Phase 18 · 本组可见 leaf 数（filter 后） */
+    groupLeafCount?: number;
+    /** Phase 18 · aggregate 阶段产物 */
+    __groupAggValues?: GroupAggValuesMap;
+    /** Phase 18 · display 合成行：指向源 group 节点 id */
+    sourceGroupId?: string;
+    /** Phase 19 · getDataPath 返回值 */
+    dataPath?: string[];
+    /** Phase 19 · 树深度：根 = 0 */
+    treeLevel?: number;
+    /** Phase 19 · 父节点 rowId；根节点 undefined */
+    parentRowId?: string;
+    /** Phase 19 · treeBuild 后子节点 */
+    childrenAfterTree?: RowNode[];
+    /** Phase 19 · 是否叶节点（无更长路径前缀的其他行） */
+    treeLeaf?: boolean;
+}
+//# sourceMappingURL=rowNode.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rowNode.d.ts","sourceRoot":"","sources":["../../../src/core/types/rowNode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AACrC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAA;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAEhE,uBAAuB;AACvB,MAAM,WAAW,OAAO;IACtB,kBAAkB;IAClB,EAAE,EAAE,MAAM,CAAA;IACV,iCAAiC;IACjC,IAAI,EAAE,OAAO,CAAA;IACb,qDAAqD;IACrD,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAA;IACd,gBAAgB;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,gCAAgC;IAChC,SAAS,EAAE,OAAO,CAAA;IAClB,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAA;IAChB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,sDAAsD;IACtD,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,gCAAgC;IAChC,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,mCAAmC;IACnC,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,+CAA+C;IAC/C,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,2CAA2C;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACtC,uBAAuB;IACvB,iBAAiB,CAAC,EAAE,OAAO,EAAE,CAAA;IAE7B,uCAAuC;IACvC,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,4BAA4B;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,6BAA6B;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,qCAAqC;IACrC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,6BAA6B;IAC7B,kBAAkB,CAAC,EAAE,OAAO,EAAE,CAAA;IAC9B,+BAA+B;IAC/B,mBAAmB,CAAC,EAAE,OAAO,EAAE,CAAA;IAC/B,uCAAuC;IACvC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,gCAAgC;IAChC,gBAAgB,CAAC,EAAE,iBAAiB,CAAA;IACpC,6CAA6C;IAC7C,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,2BAA2B;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,gCAAgC;IAChC,iBAAiB,CAAC,EAAE,OAAO,EAAE,CAAA;IAC7B,oCAAoC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB"}

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

@@ -0,0 +1,18 @@
+export type RowSelectionMode = 'single' | 'multiple';
+/** 行选择配置（Phase 19 · groupSelectsChildren） */
+export interface RowSelectionConfig {
+    mode: RowSelectionMode;
+    /**
+     * tree 模式下选中父节点是否级联选中子孙。默认 `true`。
+     * 对标 AG Grid rowSelection.groupSelectsChildren。
+     */
+    groupSelectsChildren?: boolean;
+}
+export type RowSelectionInput = RowSelectionMode | false | RowSelectionConfig;
+export interface ResolvedRowSelectionOptions {
+    mode: RowSelectionMode | false;
+    groupSelectsChildren: boolean;
+}
+export declare function normalizeRowSelectionInput(input: RowSelectionInput | undefined): ResolvedRowSelectionOptions;
+export declare function normalizeRowSelectionMode(resolved: ResolvedRowSelectionOptions): RowSelectionMode | false;
+//# sourceMappingURL=rowSelectionOptions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rowSelectionOptions.d.ts","sourceRoot":"","sources":["../../../src/core/types/rowSelectionOptions.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,UAAU,CAAA;AAEpD,6CAA6C;AAC7C,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,gBAAgB,CAAA;IACtB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAC/B;AAED,MAAM,MAAM,iBAAiB,GACzB,gBAAgB,GAChB,KAAK,GACL,kBAAkB,CAAA;AAEtB,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,gBAAgB,GAAG,KAAK,CAAA;IAC9B,oBAAoB,EAAE,OAAO,CAAA;CAC9B;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,iBAAiB,GAAG,SAAS,GACnC,2BAA2B,CAoB7B;AAED,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,2BAA2B,GACpC,gBAAgB,GAAG,KAAK,CAE1B"}

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

@@ -0,0 +1,66 @@
+import { RowSelectionMode } from '../selection/selectionService';
+import { RowSelectionInput } from './rowSelectionOptions';
+import { CellAlign, CellValign } from './align';
+import { ColumnDef } from '../../types';
+/** 系统行选择列 colId；用户 columns 不得占用 */
+export declare const SELECTION_COLUMN_ID = "__select__";
+/** 行选择列最小宽度 px */
+export declare const SELECTION_COLUMN_MIN_WIDTH = 40;
+/** 行选择列默认宽度 px */
+export declare const SELECTION_COLUMN_DEFAULT_WIDTH = 40;
+/** 表头全选 checkbox 默认 aria-label */
+export declare const DEFAULT_SELECTION_SELECT_ALL_LABEL = "\u5168\u9009";
+/** 行选择列配置 */
+export interface SelectionColumnOptions {
+    /** 列宽 px；默认 40；小于 40 时钳制为 40 */
+    width?: number;
+    /** 表头全选 checkbox 的 aria-label；默认「全选」 */
+    selectAllLabel?: string;
+    /** 行 checkbox 的 aria-label 工厂 */
+    rowLabel?: (rowIndex: number) => string;
+    /** 表头水平对齐；默认 center */
+    headerAlign?: CellAlign;
+    /** 表头垂直对齐；默认 center */
+    headerValign?: CellValign;
+    /** 表体水平对齐；默认 center */
+    align?: CellAlign;
+    /** 表体垂直对齐；默认 center */
+    valign?: CellValign;
+    /** footer 水平对齐；默认 center */
+    footerAlign?: CellAlign;
+    /** footer 垂直对齐；默认 center */
+    footerValign?: CellValign;
+}
+/** Grid 级行选择列配置（块 0 类型；块 1+ 消费） */
+export interface SelectionColumnGridOptions {
+    /** 行选择列配置；rowSelection !== false 时生效 */
+    selectionColumn?: SelectionColumnOptions;
+}
+export interface ResolvedSelectionColumnOptions {
+    width: number;
+    selectAllLabel: string;
+    rowLabel?: (rowIndex: number) => string;
+    headerAlign: CellAlign;
+    headerValign: CellValign;
+    align: CellAlign;
+    valign: CellValign;
+    footerAlign: CellAlign;
+    footerValign: CellValign;
+}
+export interface ResolvedSelectionColumnGridOptions {
+    /** rowSelection !== false */
+    enabled: boolean;
+    /** 行选模式；enabled=false 时为占位 single */
+    mode: RowSelectionMode;
+    selectionColumn: ResolvedSelectionColumnOptions;
+}
+export declare function resolveSelectionColumnWidth(width?: number): number;
+export declare function resolveSelectionColumnOptions(options?: SelectionColumnOptions): ResolvedSelectionColumnOptions;
+export declare function resolveSelectionColumnGridOptions(options?: {
+    rowSelection?: RowSelectionInput;
+    selectionColumn?: SelectionColumnOptions;
+}): ResolvedSelectionColumnGridOptions;
+export declare function isSelectionColumn(colId: string): boolean;
+/** 开发模式：用户 columns 占用系统行选择列 colId 时告警 */
+export declare function warnIfUserColumnsConflictWithSelectionColumn(columns: readonly ColumnDef[]): void;
+//# sourceMappingURL=selectionColumn.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"selectionColumn.d.ts","sourceRoot":"","sources":["../../../src/core/types/selectionColumn.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AACxE,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,iCAAiC,CAAA;AAGxC,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AAEvC,mCAAmC;AACnC,eAAO,MAAM,mBAAmB,eAAe,CAAA;AAE/C,kBAAkB;AAClB,eAAO,MAAM,0BAA0B,KAAK,CAAA;AAE5C,kBAAkB;AAClB,eAAO,MAAM,8BAA8B,KAAK,CAAA;AAEhD,kCAAkC;AAClC,eAAO,MAAM,kCAAkC,iBAAO,CAAA;AAEtD,aAAa;AACb,MAAM,WAAW,sBAAsB;IACrC,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,wCAAwC;IACxC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAA;IACvC,uBAAuB;IACvB,WAAW,CAAC,EAAE,SAAS,CAAA;IACvB,uBAAuB;IACvB,YAAY,CAAC,EAAE,UAAU,CAAA;IACzB,uBAAuB;IACvB,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,uBAAuB;IACvB,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,4BAA4B;IAC5B,WAAW,CAAC,EAAE,SAAS,CAAA;IACvB,4BAA4B;IAC5B,YAAY,CAAC,EAAE,UAAU,CAAA;CAC1B;AAED,mCAAmC;AACnC,MAAM,WAAW,0BAA0B;IACzC,wCAAwC;IACxC,eAAe,CAAC,EAAE,sBAAsB,CAAA;CACzC;AAED,MAAM,WAAW,8BAA8B;IAC7C,KAAK,EAAE,MAAM,CAAA;IACb,cAAc,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAA;IACvC,WAAW,EAAE,SAAS,CAAA;IACtB,YAAY,EAAE,UAAU,CAAA;IACxB,KAAK,EAAE,SAAS,CAAA;IAChB,MAAM,EAAE,UAAU,CAAA;IAClB,WAAW,EAAE,SAAS,CAAA;IACtB,YAAY,EAAE,UAAU,CAAA;CACzB;AAED,MAAM,WAAW,kCAAkC;IACjD,6BAA6B;IAC7B,OAAO,EAAE,OAAO,CAAA;IAChB,qCAAqC;IACrC,IAAI,EAAE,gBAAgB,CAAA;IACtB,eAAe,EAAE,8BAA8B,CAAA;CAChD;AAED,wBAAgB,2BAA2B,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAElE;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,GAAE,sBAA2B,GACnC,8BAA8B,CAYhC;AAED,wBAAgB,iCAAiC,CAC/C,OAAO,GAAE;IACP,YAAY,CAAC,EAAE,iBAAiB,CAAA;IAChC,eAAe,CAAC,EAAE,sBAAsB,CAAA;CACpC,GACL,kCAAkC,CAkBpC;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAExD;AAED,yCAAyC;AACzC,wBAAgB,4CAA4C,CAC1D,OAAO,EAAE,SAAS,SAAS,EAAE,GAC5B,IAAI,CAcN"}

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

@@ -0,0 +1,35 @@
+import { Column } from './column';
+import { RowNode } from './rowNode';
+import { RowData } from '../../types';
+/** 表尾汇总行稳定 rowId（CellRendererParams / 池化键） */
+export declare const SUMMARY_ROW_ID = "__mg_summary__";
+/** 表尾汇总行 rowIndex 占位（非 rowsToDisplay 下标） */
+export declare const SUMMARY_ROW_INDEX = -1;
+/** 汇总计算范围 */
+export type SummaryScope = 'displayed' | 'all';
+export declare const DEFAULT_SUMMARY_SCOPE: SummaryScope;
+/** 内置列级聚合函数名 */
+export type SummaryAggBuiltin = 'sum' | 'avg' | 'min' | 'max' | 'count';
+/** 列级自定义聚合 */
+export type SummaryAggFn = (rows: readonly RowNode[], column: Column) => unknown;
+export type SummaryAgg = SummaryAggBuiltin | SummaryAggFn;
+/** 全局汇总方法入参 */
+export interface SummaryMethodParams {
+    columns: readonly Column[];
+    /** 按 summaryScope 选取的 RowData 快照 */
+    data: RowData[];
+    rows: readonly RowNode[];
+}
+/** 全局汇总方法：返回 colId → 展示值（优先级高于列级 summaryAgg） */
+export type SummaryMethod = (params: SummaryMethodParams) => Record<string, string | number | null | undefined>;
+/** Grid 级汇总配置（块 0 类型；块 1+ 消费） */
+export interface SummaryOptions {
+    showSummary?: boolean;
+    summaryScope?: SummaryScope;
+    summaryRowHeight?: number;
+    summaryMethod?: SummaryMethod;
+}
+export declare function resolveSummaryOptions(options?: SummaryOptions): Required<Pick<SummaryOptions, 'showSummary' | 'summaryScope'>> & Pick<SummaryOptions, 'summaryRowHeight' | 'summaryMethod'>;
+/** 汇总行高度：显式 summaryRowHeight 优先，否则跟随 rowHeight */
+export declare function resolveSummaryRowHeight(summaryRowHeight: number | undefined, rowHeight: number): number;
+//# sourceMappingURL=summary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../../../src/core/types/summary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACtC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AAErC,8CAA8C;AAC9C,eAAO,MAAM,cAAc,mBAAmB,CAAA;AAE9C,4CAA4C;AAC5C,eAAO,MAAM,iBAAiB,KAAK,CAAA;AAEnC,aAAa;AACb,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,KAAK,CAAA;AAE9C,eAAO,MAAM,qBAAqB,EAAE,YAA0B,CAAA;AAE9D,gBAAgB;AAChB,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,OAAO,CAAA;AAEvE,cAAc;AACd,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAA;AAEhF,MAAM,MAAM,UAAU,GAAG,iBAAiB,GAAG,YAAY,CAAA;AAEzD,eAAe;AACf,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IAC1B,oCAAoC;IACpC,IAAI,EAAE,OAAO,EAAE,CAAA;IACf,IAAI,EAAE,SAAS,OAAO,EAAE,CAAA;CACzB;AAED,gDAAgD;AAChD,MAAM,MAAM,aAAa,GAAG,CAC1B,MAAM,EAAE,mBAAmB,KACxB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAA;AAEvD,iCAAiC;AACjC,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,aAAa,CAAC,EAAE,aAAa,CAAA;CAC9B;AAED,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,cAAmB,GAAG,QAAQ,CAC3E,IAAI,CAAC,cAAc,EAAE,aAAa,GAAG,cAAc,CAAC,CACrD,GACC,IAAI,CAAC,cAAc,EAAE,kBAAkB,GAAG,eAAe,CAAC,CAO3D;AAED,kDAAkD;AAClD,wBAAgB,uBAAuB,CACrC,gBAAgB,EAAE,MAAM,GAAG,SAAS,EACpC,SAAS,EAAE,MAAM,GAChB,MAAM,CAER"}

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

@@ -0,0 +1,30 @@
+import { RowData } from '../../types';
+import { RowNode } from './rowNode';
+import { RowIndexMode } from './rowMutation';
+/** 带插入位置的新增行 payload（applyTransaction / addRows 共用） */
+export interface AddRowPayload {
+    data: RowData;
+    index?: number;
+    indexMode?: RowIndexMode;
+}
+export type RowTransactionAddItem = RowData | AddRowPayload;
+/** 用户侧事务输入 */
+export interface RowTransaction {
+    add?: RowTransactionAddItem[];
+    remove?: RowData[] | string[];
+    update?: RowData[];
+}
+/** 应用事务后的节点级 diff */
+export interface RowNodeTransaction {
+    add: RowNode[];
+    remove: RowNode[];
+    update: RowNode[];
+}
+/** refreshCells 定向刷新参数 */
+export interface RefreshCellsParams {
+    rowIds?: string[];
+    colIds?: string[];
+    /** 忽略单元格值缓存，强制重绘 */
+    force?: boolean;
+}
+//# sourceMappingURL=transaction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../../../src/core/types/transaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AACrC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAEjD,uDAAuD;AACvD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,OAAO,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,YAAY,CAAA;CACzB;AAED,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,aAAa,CAAA;AAE3D,cAAc;AACd,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAE,qBAAqB,EAAE,CAAA;IAC7B,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,MAAM,EAAE,CAAA;IAC7B,MAAM,CAAC,EAAE,OAAO,EAAE,CAAA;CACnB;AAED,qBAAqB;AACrB,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,OAAO,EAAE,CAAA;IACd,MAAM,EAAE,OAAO,EAAE,CAAA;IACjB,MAAM,EAAE,OAAO,EAAE,CAAA;CAClB;AAED,0BAA0B;AAC1B,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,oBAAoB;IACpB,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB"}

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

@@ -0,0 +1,165 @@
+import { ColumnDef, RowData } from '../../types';
+import { Column } from './column';
+import { RowNode } from './rowNode';
+import { BusinessRowId } from './businessRowId';
+/** 系统 tree 列 colId；用户 columns 不得占用 */
+export declare const TREE_COLUMN_ID = "__tree__";
+/** tree expand/collapse 按钮 DOM class（复用 group token 别名） */
+export declare const TREE_EXPAND_BUTTON_CLASS = "mg-cell__tree-expand";
+/** tree 展开态 chevron class */
+export declare const TREE_EXPAND_EXPANDED_CLASS = "mg-cell__tree-expand--expanded";
+/** tree lazy 加载中 chevron class */
+export declare const TREE_EXPAND_LOADING_CLASS = "mg-cell__tree-expand--loading";
+/** tree 缩进 class 前缀：`mg-cell__tree-indent-{level}` */
+export declare const TREE_INDENT_CLASS_PREFIX = "mg-cell__tree-indent-";
+/** tree 系统列 cell class */
+export declare const TREE_AUTO_CELL_CLASS = "mg-cell--tree-auto";
+/** auto tree 列最小宽度 px */
+export declare const TREE_COLUMN_MIN_WIDTH = 120;
+/** auto tree 列默认宽度 px */
+export declare const TREE_COLUMN_DEFAULT_WIDTH = 200;
+export type TreeDisplayType = 'singleColumn';
+export type TreeTableSource = 'api' | 'ui';
+export interface GetDataPathParams {
+    data: RowData;
+}
+/** 对标 AG Grid getDataPath */
+export type GetDataPathFn = (params: GetDataPathParams) => string[];
+export interface TreeValueGetterParams {
+    data: RowData;
+    dataPath: string[];
+    treeLevel: number;
+}
+export type TreeValueGetterFn = (params: TreeValueGetterParams) => string;
+export interface HasTreeChildrenParams {
+    data: RowData;
+    dataPath: string[];
+    treeLevel: number;
+}
+export type HasTreeChildrenFn = (params: HasTreeChildrenParams) => boolean;
+export interface LoadTreeChildrenParams {
+    parentRowId: BusinessRowId;
+    parentData: RowData;
+    dataPath: string[];
+    treeLevel: number;
+    signal: AbortSignal;
+}
+export type LoadTreeChildrenFn = (params: LoadTreeChildrenParams) => Promise<RowData[] | void> | RowData[] | void;
+/** 渲染层查询树态的窄接口（Phase 19 块 5） */
+export interface TreeTableHost {
+    active: () => boolean;
+    isExpanded: (rowId: string) => boolean;
+    getTreeValue?: (rowNode: RowNode) => string;
+    isTreeNodeExpandable?: (rowNode: RowNode) => boolean;
+    isTreeNodeLoading?: (rowId: string) => boolean;
+}
+/** 树形行拖拽范围：默认仅同级；hierarchy 允许跨父级改挂 */
+export type TreeDragScope = 'siblings' | 'hierarchy';
+export interface SetDataPathParams {
+    data: RowData;
+    dataPath: string[];
+    treeLevel: number;
+    previousPath: readonly string[];
+}
+/** hierarchy 模式下 managed drag 将新路径写回 row.data */
+export type SetDataPathFn = (params: SetDataPathParams) => void;
+/** 树形表格配置（Phase 19 块 0） */
+export interface TreeTableGridOptions {
+    /** 启用树形表格。默认 `false`。对标 AG Grid treeData。 */
+    tree?: boolean;
+    /** 树形路径回调。tree: true 时 **必填**。 */
+    getDataPath?: GetDataPathFn;
+    /**
+     * 树形 managed 行拖拽范围。默认 `siblings`（仅同 parent 兄弟换序）；
+     * `hierarchy` 允许跨层级改父节点（需 `setDataPath` 写回路径）。
+     */
+    treeDragScope?: TreeDragScope;
+    /** hierarchy 模式下写回 dataPath；缺省时若 data.pathSegments 为数组则自动更新 */
+    setDataPath?: SetDataPathFn;
+    /** 是否展示 tree 系统列。默认 `true`。 */
+    showTreeColumn?: boolean;
+    /** 覆盖 tree 系统列 colDef。对标 autoGroupColumnDef。 */
+    autoTreeColumnDef?: Partial<ColumnDef>;
+    /** 自定义 tree 列展示值；缺省为 dataPath 末段 */
+    treeValueGetter?: TreeValueGetterFn;
+    /** 树节点展示列模式。v1 仅 `singleColumn`。默认 `singleColumn`。 */
+    treeDisplayType?: TreeDisplayType;
+    /**
+     * 启用树形懒加载（CSRM）。默认 `false`。
+     * `true` 时需同时提供 `loadTreeChildren`。
+     */
+    treeLazyLoad?: boolean;
+    /** lazy 模式：节点是否可能有未加载子行（控制 expand chevron） */
+    hasTreeChildren?: HasTreeChildrenFn;
+    /** lazy 模式：首次展开且无已加载子行时拉取子数据 */
+    loadTreeChildren?: LoadTreeChildrenFn;
+}
+export interface ResolvedTreeTableGridOptions {
+    tree: boolean;
+    getDataPath?: GetDataPathFn;
+    treeDragScope: TreeDragScope;
+    setDataPath?: SetDataPathFn;
+    showTreeColumn: boolean;
+    autoTreeColumnDef?: Partial<ColumnDef>;
+    treeValueGetter?: TreeValueGetterFn;
+    treeDisplayType: TreeDisplayType;
+    treeLazyLoad: boolean;
+    hasTreeChildren?: HasTreeChildrenFn;
+    loadTreeChildren?: LoadTreeChildrenFn;
+}
+export declare function resolveSetDataPathFn(setDataPath: SetDataPathFn | undefined): SetDataPathFn | undefined;
+export declare function resolveTreeTableGridOptions(options?: TreeTableGridOptions): ResolvedTreeTableGridOptions;
+export declare function isTreeColumn(colId: string): boolean;
+export declare function isTreeTableSystemColumn(colId: string): boolean;
+export declare function isTreeTableActive(tree: boolean | undefined, getDataPath: GetDataPathFn | undefined): boolean;
+export declare function isTreeTableUiEnabled(tree: boolean | undefined, showTreeColumn: boolean | undefined, getDataPath: GetDataPathFn | undefined): boolean;
+export declare function isTreeRowNode(row: RowNode): boolean;
+export declare function isTreeLeafRowNode(row: RowNode): boolean;
+export declare function hasTreeColumn(columns: readonly Column[]): boolean;
+export declare function warnIfUserColumnsConflictWithTreeColumn(columns: readonly ColumnDef[]): void;
+export interface TreeCellRendererParams {
+    rowId: BusinessRowId;
+    dataPath: string[];
+    treeLevel: number;
+    expanded: boolean;
+    treeLeaf: boolean;
+    value: unknown;
+    data: RowData;
+}
+export interface TreeNodeOpenedEvent {
+    rowId: BusinessRowId;
+    expanded: boolean;
+    level: number;
+    dataPath: string[];
+    source: TreeTableSource;
+}
+export interface TreeChildrenLoadingEvent {
+    parentRowId: BusinessRowId;
+    dataPath: string[];
+    treeLevel: number;
+    source: TreeTableSource;
+}
+export interface TreeChildrenLoadedEvent {
+    parentRowId: BusinessRowId;
+    children: RowData[];
+    childCount: number;
+    source: TreeTableSource;
+}
+export interface TreeChildrenLoadFailedEvent {
+    parentRowId: BusinessRowId;
+    reason?: string;
+    aborted?: boolean;
+}
+export declare function buildTreeNodeOpenedEvent(rowId: string, expanded: boolean, level: number, dataPath: string[], source: TreeTableSource): TreeNodeOpenedEvent;
+export interface ITreeTableService {
+    readonly active: boolean;
+    isExpanded(rowId: string): boolean;
+    expandNode(rowId: string, source: TreeTableSource): void;
+    collapseNode(rowId: string, source: TreeTableSource): void;
+    expandAll(source: TreeTableSource): void;
+    collapseAll(): void;
+    getExpandedRowIds(): ReadonlySet<string>;
+    getDataPathForRow(rowId: string): string[] | undefined;
+}
+export declare function assertTreeTableGetDataPath(tree: boolean, getDataPath: GetDataPathFn | undefined): asserts getDataPath is GetDataPathFn;
+//# sourceMappingURL=treeTable.d.ts.map

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

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

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

@@ -0,0 +1,96 @@
+import { RowData } from '../../types';
+import { RowId } from './rowId';
+import { BusinessRowId } from './businessRowId';
+import { Rule, Rules } from 'async-validator';
+import { CellEditorParams } from './cellEditor';
+/** 校验错误：null/undefined 表示通过；字符串数组表示失败 */
+export type ValidationErrors = string[] | null | undefined;
+export type InvalidEditValueMode = 'block' | 'revert' | 'keep';
+export interface CellValidationResult {
+    valid: true;
+}
+export interface CellValidationFailure {
+    valid: false;
+    errors: string[];
+}
+export type CellValidationOutcome = CellValidationResult | CellValidationFailure;
+export type CellValidator = (params: CellEditorParams & {
+    parsedValue: unknown;
+    signal: AbortSignal;
+}) => ValidationErrors | Promise<ValidationErrors>;
+export interface RowValidatorParams {
+    rowId: BusinessRowId;
+    rowIndex: number;
+    data: RowData;
+    draftValues: ReadonlyMap<string, unknown>;
+    signal: AbortSignal;
+}
+/** rowValidator 结构化返回：指定错误应标红的列 */
+export interface RowValidationResult {
+    errors: string[];
+    colIds?: string[];
+}
+export type RowValidator = (params: RowValidatorParams) => ValidationErrors | RowValidationResult | Promise<ValidationErrors | RowValidationResult>;
+/** async-validator 规则 */
+export type ValidationRule = Rule;
+/** magic-grid 扩展：validationRules.validator 可为 async */
+export interface MagicValidationRule {
+    validator?: (rule: unknown, value: unknown, callback: (error?: string | Error) => void, source: unknown, options: unknown) => void | Promise<void>;
+    message?: string;
+    required?: boolean;
+    min?: number;
+    max?: number;
+    type?: string;
+    [key: string]: unknown;
+}
+export type ValidationRules = ValidationRule | MagicValidationRule | (ValidationRule | MagicValidationRule)[];
+export type ValidationSchema = Rules;
+export interface GridValidationCellError {
+    rowId: BusinessRowId;
+    rowIndex: number;
+    colId: string;
+    errors: string[];
+}
+export interface GridValidationResult {
+    valid: boolean;
+    cellErrors: GridValidationCellError[];
+}
+export interface ValidateGridOptions {
+    /** 指定行 id；省略则校验全表 */
+    rowIds?: RowId[];
+    signal?: AbortSignal;
+    /** 是否更新 invalid 视觉反馈，默认 true */
+    showFeedback?: boolean;
+}
+export interface ClearValidationOptions {
+    /** 指定行 id；省略则清除全表校验反馈 */
+    rowIds?: RowId[];
+}
+/** 单元格位置（rowId + colId） */
+export interface GridCellPosition {
+    rowId: RowId;
+    colId: string;
+}
+export interface ValidateCellsOptions {
+    /** 待校验的单元格列表 */
+    cells: GridCellPosition[];
+    signal?: AbortSignal;
+    /** 是否更新 invalid 视觉反馈，默认 true */
+    showFeedback?: boolean;
+}
+export interface ClearCellValidationOptions {
+    /** 待清除校验反馈的单元格列表 */
+    cells: GridCellPosition[];
+}
+export interface ValidateRowsOptions {
+    /** 待校验的行 id 列表 */
+    rowIds: RowId[];
+    signal?: AbortSignal;
+    /** 是否更新 invalid 视觉反馈，默认 true */
+    showFeedback?: boolean;
+}
+export interface ClearRowValidationOptions {
+    /** 待清除校验反馈的行 id 列表 */
+    rowIds: RowId[];
+}
+//# sourceMappingURL=validation.d.ts.map

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

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

package/dist/core/value/index.d.ts

@@ -0,0 +1,2 @@
+export { ValueCache } from './valueCache';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/value/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/value/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA"}

package/dist/core/value/valueCache.d.ts

@@ -0,0 +1,8 @@
+/** 单元格展示值缓存版本号，bump 后所有 CellCtrl 强制重算 */
+export declare class ValueCache {
+    private version;
+    getVersion(): number;
+    bump(): void;
+    reset(): void;
+}
+//# sourceMappingURL=valueCache.d.ts.map

package/dist/core/value/valueCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"valueCache.d.ts","sourceRoot":"","sources":["../../../src/core/value/valueCache.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAAI;IAEnB,UAAU,IAAI,MAAM;IAIpB,IAAI,IAAI,IAAI;IAIZ,KAAK,IAAI,IAAI;CAGd"}