@taocompany/magic-grid 0.1.0

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

@@ -0,0 +1,45 @@
+import { MapStageOptions } from '../pipeline/stages/mapStage';
+import { RowNode } from '../types';
+import { IRowGroupingService, ResolvedRowGroupingGridOptions, RowGroupChangedEvent, RowGroupOpenedEvent, RowGroupingSource } from '../types/rowGrouping';
+export interface RowGroupingServiceDeps {
+    getOptions: () => ResolvedRowGroupingGridOptions;
+    /** 从 ColumnDef 解析初始分组列 */
+    getRowGroupColumnsFromDefs: () => readonly string[];
+    /**
+     * sort/aggregate 后的 group 树根（map 之前）。
+     * 用于 expandAll / findGroup / prune。
+     */
+    getGroupedTreeRoots: () => readonly RowNode[];
+    onGroupOpened?: (event: RowGroupOpenedEvent) => void;
+    onGroupChanged?: (event: RowGroupChangedEvent) => void;
+    /** expand/collapse / setRowGroupColumns 后触发 map-only 刷新 */
+    onGroupingStateChanged?: () => void;
+}
+/** Phase 18 块 5 · 分组折叠态 + API */
+export declare class RowGroupingService implements IRowGroupingService {
+    private readonly deps;
+    private readonly expandedGroupIds;
+    private rowGroupColumns;
+    constructor(deps: RowGroupingServiceDeps);
+    get active(): boolean;
+    getExpandedGroupIds(): ReadonlySet<string>;
+    getRowGroupColumns(): readonly string[];
+    /** 列定义变更后同步分组列（保留仍存在的 colId 顺序） */
+    syncRowGroupColumnsFromDefs(): void;
+    setRowGroupColumns(colIds: readonly string[], source: RowGroupingSource): void;
+    isExpanded(groupId: string): boolean;
+    expandGroup(groupId: string, source: RowGroupingSource): void;
+    collapseGroup(groupId: string, source: RowGroupingSource): void;
+    toggleGroup(groupId: string, source: RowGroupingSource): void;
+    expandAll(source: RowGroupingSource): void;
+    collapseAll(source: RowGroupingSource): void;
+    clearExpanded(): void;
+    /** filter/group 重建后移除已不存在的 group 展开态 */
+    pruneExpanded(existingGroupIds: ReadonlySet<string>): void;
+    applyDefaultExpanded(groupRoots: readonly RowNode[]): void;
+    getLeafGroupPathKey(row: RowNode): string | null;
+    getMapStageOptions(): MapStageOptions;
+    private emitGroupOpened;
+    private emitGroupChanged;
+}
+//# sourceMappingURL=rowGroupingService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rowGroupingService.d.ts","sourceRoot":"","sources":["../../../src/core/rowGrouping/rowGroupingService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AACrE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,EACV,mBAAmB,EACnB,8BAA8B,EAC9B,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,yBAAyB,CAAA;AAgBhC,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,8BAA8B,CAAA;IAChD,0BAA0B;IAC1B,0BAA0B,EAAE,MAAM,SAAS,MAAM,EAAE,CAAA;IACnD;;;OAGG;IACH,mBAAmB,EAAE,MAAM,SAAS,OAAO,EAAE,CAAA;IAC7C,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAA;IACpD,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,CAAA;IACtD,2DAA2D;IAC3D,sBAAsB,CAAC,EAAE,MAAM,IAAI,CAAA;CACpC;AAED,iCAAiC;AACjC,qBAAa,kBAAmB,YAAW,mBAAmB;IAIhD,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHjC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAoB;IACrD,OAAO,CAAC,eAAe,CAAU;gBAEJ,IAAI,EAAE,sBAAsB;IAIzD,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,mBAAmB,IAAI,WAAW,CAAC,MAAM,CAAC;IAI1C,kBAAkB,IAAI,SAAS,MAAM,EAAE;IAIvC,mCAAmC;IACnC,2BAA2B,IAAI,IAAI;IAInC,kBAAkB,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAU9E,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAIpC,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAe7D,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAe/D,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAS7D,SAAS,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAY1C,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAU5C,aAAa,IAAI,IAAI;IAIrB,wCAAwC;IACxC,aAAa,CAAC,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI;IAQ1D,oBAAoB,CAAC,UAAU,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI;IAoB1D,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI;IAQhD,kBAAkB,IAAI,eAAe;IAQrC,OAAO,CAAC,eAAe;IAiBvB,OAAO,CAAC,gBAAgB;CAGzB"}

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

@@ -0,0 +1,45 @@
+import { RowNode } from '../types';
+import { RowMoveItem } from '../types/rowDrag';
+export type GroupedMovePathResolution = string | 'mixed' | 'missing' | null;
+/** 解析待移动行的 leafGroupPathKey；null 表示未启用分组语义 */
+export declare function resolveMovingLeafGroupPathKey(sourceRows: readonly RowNode[], rowIds: readonly string[]): GroupedMovePathResolution;
+/** display 插入位 → 同组 leaf 子序列内的插入下标 */
+export declare function resolveWithinGroupInsertIndex(displayRows: readonly RowNode[], displayInsertIndex: number, groupPath: string, movingIds: ReadonlySet<string>): number;
+/** source 目标下标 → 同组 leaf 子序列内的插入下标 */
+export declare function resolveWithinGroupInsertFromSourceTarget(sourceRows: readonly RowNode[], rowIds: readonly string[], targetSourceIndex: number, groupPath: string): number;
+/** 在同组 leaf 的 source 槽位内重排（支持 source 与 display 交错） */
+export declare function applyGroupedLeafReorder(params: {
+    sourceRows: readonly RowNode[];
+    rowIds: readonly string[];
+    groupPath: string;
+    withinGroupInsertIndex: number;
+}): {
+    rows: RowNode[];
+    moves: RowMoveItem[];
+} | null;
+/** display drop 位驱动的组内 leaf 重排 */
+export declare function applyGroupedLeafReorderFromDisplayInsert(params: {
+    sourceRows: readonly RowNode[];
+    displayRows: readonly RowNode[];
+    rowIds: readonly string[];
+    displayInsertIndex: number;
+    groupPath: string;
+}): {
+    rows: RowNode[];
+    moves: RowMoveItem[];
+} | null;
+/** source 序插入点是否仍在同一 group 的 leaf 边界内 */
+export declare function validateGroupedSourceInsertIndex(sourceRows: readonly RowNode[], rowIds: readonly string[], insertIndex: number, groupPath: string): boolean;
+/** display 投影 drop 位是否落在同组 leaf 区间内 */
+export declare function validateGroupedDisplayDrop(displayRows: readonly RowNode[], getSourceRow: (rowId: string) => RowNode | undefined, rowIds: readonly string[], insertIndex: number, groupPath: string): boolean;
+export interface GroupedRowMoveValidation {
+    allowed: boolean;
+    reason?: string;
+}
+export declare function validateGroupedRowMove(params: {
+    active: boolean;
+    sourceRows: readonly RowNode[];
+    rowIds: readonly string[];
+    targetSourceIndex: number;
+}): GroupedRowMoveValidation;
+//# sourceMappingURL=validateGroupedRowMove.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validateGroupedRowMove.d.ts","sourceRoot":"","sources":["../../../src/core/rowGrouping/validateGroupedRowMove.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAGtD,MAAM,MAAM,yBAAyB,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,IAAI,CAAA;AAE3E,8CAA8C;AAC9C,wBAAgB,6BAA6B,CAC3C,UAAU,EAAE,SAAS,OAAO,EAAE,EAC9B,MAAM,EAAE,SAAS,MAAM,EAAE,GACxB,yBAAyB,CA6B3B;AAED,sCAAsC;AACtC,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,SAAS,OAAO,EAAE,EAC/B,kBAAkB,EAAE,MAAM,EAC1B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,GAC7B,MAAM,CAgBR;AAED,sCAAsC;AACtC,wBAAgB,wCAAwC,CACtD,UAAU,EAAE,SAAS,OAAO,EAAE,EAC9B,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,iBAAiB,EAAE,MAAM,EACzB,SAAS,EAAE,MAAM,GAChB,MAAM,CAoBR;AAED,sDAAsD;AACtD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC9C,UAAU,EAAE,SAAS,OAAO,EAAE,CAAA;IAC9B,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;IACzB,SAAS,EAAE,MAAM,CAAA;IACjB,sBAAsB,EAAE,MAAM,CAAA;CAC/B,GAAG;IAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAAC,KAAK,EAAE,WAAW,EAAE,CAAA;CAAE,GAAG,IAAI,CAwDnD;AAED,kCAAkC;AAClC,wBAAgB,wCAAwC,CAAC,MAAM,EAAE;IAC/D,UAAU,EAAE,SAAS,OAAO,EAAE,CAAA;IAC9B,WAAW,EAAE,SAAS,OAAO,EAAE,CAAA;IAC/B,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;IACzB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,SAAS,EAAE,MAAM,CAAA;CAClB,GAAG;IAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAAC,KAAK,EAAE,WAAW,EAAE,CAAA;CAAE,GAAG,IAAI,CA6BnD;AAED,yCAAyC;AACzC,wBAAgB,gCAAgC,CAC9C,UAAU,EAAE,SAAS,OAAO,EAAE,EAC9B,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAYT;AAED,uCAAuC;AACvC,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,SAAS,OAAO,EAAE,EAC/B,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,GAAG,SAAS,EACpD,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAsBT;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE;IAC7C,MAAM,EAAE,OAAO,CAAA;IACf,UAAU,EAAE,SAAS,OAAO,EAAE,CAAA;IAC9B,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;IACzB,iBAAiB,EAAE,MAAM,CAAA;CAC1B,GAAG,wBAAwB,CA8B3B"}

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

@@ -0,0 +1,10 @@
+import { RowNode } from '../types';
+/** DFS 访问 group 树节点（跳过 leaf） */
+export declare function walkGroupTree(roots: readonly RowNode[], visit: (node: RowNode) => void): void;
+/** 收集子树全部 groupId */
+export declare function collectGroupTreeGroupIds(roots: readonly RowNode[]): string[];
+/** 在 group 树中按 groupId 查找节点 */
+export declare function findGroupTreeNode(roots: readonly RowNode[], groupId: string): RowNode | undefined;
+/** 判定 group 节点是否应随 groupDefaultExpanded 默认展开 */
+export declare function shouldDefaultExpandGroup(groupLevel: number, groupDefaultExpanded: number): boolean;
+//# sourceMappingURL=walkGroupTree.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"walkGroupTree.d.ts","sourceRoot":"","sources":["../../../src/core/rowGrouping/walkGroupTree.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAG1C,gCAAgC;AAChC,wBAAgB,aAAa,CAC3B,KAAK,EAAE,SAAS,OAAO,EAAE,EACzB,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,GAC7B,IAAI,CASN;AAED,qBAAqB;AACrB,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,EAAE,CAU5E;AAED,+BAA+B;AAC/B,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS,OAAO,EAAE,EACzB,OAAO,EAAE,MAAM,GACd,OAAO,GAAG,SAAS,CAUrB;AAED,gDAAgD;AAChD,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,EAClB,oBAAoB,EAAE,MAAM,GAC3B,OAAO,CAUT"}

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

@@ -0,0 +1,131 @@
+import { MapStageOptions } from '../pipeline/stages/mapStage';
+import { GetDataPathFn } from '../types/treeTable';
+import { FilterStageColumnContext } from '../pipeline/stages/filterStage';
+import { RowValueGetter } from '../pipeline/createComparator';
+import { ColumnComparatorFn } from '../types/columnSort';
+import { Column, FilterModel, IRowModel, PipelineStage, RowBounds, RowNode, RowNodeTransaction, RowTransaction, SortModelItem } from '../types';
+import { GroupComparatorFn, GroupKeyCreatorFn } from '../types/rowGrouping';
+import { IRowExpansionService } from '../types/rowExpansion';
+import { InternalPromoteRowIdResult } from '../types/rowMutation';
+import { RowData } from '../../types';
+import { PositionRowsOptions } from './positionRows';
+export interface ClientSideRowModelOptions {
+    rowKey: string;
+    rowHeight?: number;
+    getCellValue?: RowValueGetter;
+    getColumnComparator?: (colId: string) => ColumnComparatorFn | undefined;
+    quickFilterText?: string;
+    filterColumnContext?: FilterStageColumnContext;
+    getQuickFilterColIds?: () => readonly string[];
+}
+/** Phase 18 · 行分组管线依赖（由 Grid 注入） */
+export interface ClientSideRowModelGroupingDeps {
+    active: () => boolean;
+    getRowGroupColumns: () => readonly string[];
+    getGroupKeyCreator: () => GroupKeyCreatorFn | undefined;
+    getGroupComparator: () => GroupComparatorFn | undefined;
+    getColumns: () => readonly Column[];
+    getColumnField: (colId: string) => string | undefined;
+    getMapStageOptions: () => MapStageOptions;
+    pruneExpanded: (existingGroupIds: ReadonlySet<string>) => void;
+    applyDefaultExpanded: (groupRoots: readonly RowNode[]) => void;
+    clearExpanded: () => void;
+}
+/** Phase 19 · 树形表格管线依赖（由 Grid 注入） */
+export interface ClientSideRowModelTreeDeps {
+    active: () => boolean;
+    getDataPath: () => GetDataPathFn;
+    getMapStageOptions: () => MapStageOptions;
+    prepareTreeTree: (treeRoots: readonly RowNode[]) => void;
+    applyDefaultExpanded: (treeRoots: readonly RowNode[]) => void;
+    clearExpanded: () => void;
+}
+export interface RefreshModelOptions {
+    applyDefaultExpanded?: boolean;
+    stages?: PipelineStage[];
+}
+/** Client-side 行模型：全量数据 + 阶段管线 → rowsToDisplay */
+export declare class ClientSideRowModel implements IRowModel {
+    private sourceRows;
+    private displayRows;
+    /** map 阶段后的 data 行（未 inject detail） */
+    private baseDisplayRows;
+    private sortModel;
+    private filterModel;
+    private quickFilterText;
+    private touchedRowIds;
+    private readonly rowKey;
+    private defaultRowHeight;
+    private readonly getCellValue;
+    private readonly getColumnComparator?;
+    private readonly filterColumnContext?;
+    private readonly getQuickFilterColIds?;
+    private readonly refreshScheduler;
+    private positionGetRowHeight?;
+    private rowExpansionService;
+    private rowGroupingDeps;
+    private treeTableDeps;
+    /** aggregate 后、map 前的分组树（map-only 快路径） */
+    private groupedTreeRoots;
+    /** sort 后、map 前的 tree 根（map-only 快路径） */
+    private treeTreeRoots;
+    constructor(options: ClientSideRowModelOptions);
+    get rowsToDisplay(): readonly RowNode[];
+    /** Phase 17 · map 后 data 行（未 inject detail） */
+    getBaseDisplayRows(): readonly RowNode[];
+    /** Phase 17 · 注入 RowExpansionService（块 2+ Grid 接线） */
+    setRowExpansionService(service: IRowExpansionService | null): void;
+    getRowExpansionService(): IRowExpansionService | null;
+    /** Phase 18 · 注入行分组管线依赖 */
+    setRowGroupingDeps(deps: ClientSideRowModelGroupingDeps | null): void;
+    /** Phase 19 · 注入树形表格管线依赖 */
+    setTreeTableDeps(deps: ClientSideRowModelTreeDeps | null): void;
+    getTreeTreeRoots(): readonly RowNode[];
+    /** sort 后的 tree 树根（map 之前） */
+    getGroupedTreeRoots(): readonly RowNode[];
+    /** Phase 15 · 注入 getRowHeight 回调，refreshModel 定位时使用可变行高 */
+    setPositionGetRowHeight(getRowHeight?: (row: RowNode) => number | null | undefined): void;
+    private resolvePositionRowsOptions;
+    setData(data: readonly RowData[]): void;
+    setSortModel(model: SortModelItem[]): void;
+    setFilterModel(model: FilterModel): void;
+    getSortModel(): SortModelItem[];
+    getFilterModel(): FilterModel;
+    getQuickFilterText(): string;
+    setQuickFilterText(text: string): void;
+    /** 标记 touched 行（块 3 事务更新时使用） */
+    markTouchedRowIds(ids: Iterable<string>): void;
+    applyTransaction(transaction: RowTransaction): RowNodeTransaction;
+    /** Phase 17 · 展开/折叠后仅重跑 detail 投影 + positionRows（不重建 sort/filter） */
+    rebuildDisplayProjection(): void;
+    /** Phase 19 · expand/collapse 后仅重跑 map + detail 投影 + positionRows */
+    rebuildTreeMapProjection(): void;
+    /** Phase 18 · expand/collapse 后仅重跑 map + detail 投影 + positionRows */
+    rebuildGroupedMapProjection(): void;
+    getRowById(id: string): RowNode | undefined;
+    /** 查找行节点（source 或 display 投影，含 detail 合成行） */
+    resolveRowById(id: string): RowNode | undefined;
+    /** Phase 17 · 在 rowsToDisplay 中查找（含 detail 行） */
+    getDisplayRowById(id: string): RowNode | undefined;
+    /** Phase 15 · 热更新默认行高（MagicGrid rowHeight prop） */
+    setDefaultRowHeight(rowHeight: number): void;
+    /** Phase 15 · 可变行高：重算 display 行 rowTop（不跑 sort/filter） */
+    repositionDisplayRows(options?: Pick<PositionRowsOptions, 'getRowHeight'>): void;
+    getRowIndexById(id: string): number;
+    refreshModel(options?: RefreshModelOptions | boolean): void;
+    private buildProjectedDisplayRows;
+    getRow(index: number): RowNode | undefined;
+    getRowCount(): number;
+    getSourceRowCount(): number;
+    getSourceRows(): readonly RowNode[];
+    getSourceRowIndexById(rowId: string): number;
+    /** Phase 15 · 替换 source 行数组并重跑 display 管线 */
+    setSourceRows(rows: RowNode[]): void;
+    getRowKey(): string;
+    promoteRowId(rowId: string, businessId: string | number): InternalPromoteRowIdResult;
+    getRowIndexAtPixel(pixel: number): number;
+    getRowBounds(index: number): RowBounds | null;
+    getTotalHeight(): number;
+    ensureRowHeightsValid(_top: number, _bottom: number): boolean;
+}
+//# sourceMappingURL=clientSideRowModel.d.ts.map

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

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

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

@@ -0,0 +1,22 @@
+import { RowNode } from '../types';
+import { RowData } from '../../types';
+export declare class RowModelError extends Error {
+    constructor(message: string);
+}
+export interface CreateRowNodesOptions {
+    /** 行数据主键字段名 */
+    rowKey: string;
+    /** 固定行高（px） */
+    rowHeight?: number;
+    /**
+     * 是否允许缺失业务 rowKey 并生成临时行。
+     * setData 默认 false；applyTransaction.add 为 true。
+     */
+    allowTransient?: boolean;
+}
+/**
+ * 将用户行数据转为 RowNode 数组。
+ * 持久化行 id 来自 rowKey；临时行 id 为 __mg_tmp_* 且不写入 data[rowKey]。
+ */
+export declare function createRowNodes(data: readonly RowData[], options: CreateRowNodesOptions): RowNode[];
+//# sourceMappingURL=createRowNodes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createRowNodes.d.ts","sourceRoot":"","sources":["../../../src/core/rowModel/createRowNodes.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AAErC,qBAAa,aAAc,SAAQ,KAAK;gBAC1B,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,WAAW,qBAAqB;IACpC,eAAe;IACf,MAAM,EAAE,MAAM,CAAA;IACd,eAAe;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,SAAS,OAAO,EAAE,EACxB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,EAAE,CAwDX"}

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

@@ -0,0 +1,4 @@
+import { RowBounds, RowNode } from '../types';
+/** O(1) 返回行边界；越界返回 null */
+export declare function getRowBounds(rows: readonly RowNode[], index: number): RowBounds | null;
+//# sourceMappingURL=getRowBounds.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getRowBounds.d.ts","sourceRoot":"","sources":["../../../src/core/rowModel/getRowBounds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAE1C,2BAA2B;AAC3B,wBAAgB,YAAY,CAC1B,IAAI,EAAE,SAAS,OAAO,EAAE,EACxB,KAAK,EAAE,MAAM,GACZ,SAAS,GAAG,IAAI,CAUlB"}

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

@@ -0,0 +1,7 @@
+import { RowNode } from '../types';
+/**
+ * O(log n) 像素 → 行索引（二分）。
+ * 空表返回 0；负数像素视为 0；超出总高返回末行索引。
+ */
+export declare function getRowIndexAtPixel(rows: readonly RowNode[], pixel: number): number;
+//# sourceMappingURL=getRowIndexAtPixel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getRowIndexAtPixel.d.ts","sourceRoot":"","sources":["../../../src/core/rowModel/getRowIndexAtPixel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAE1C;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAyBlF"}

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

@@ -0,0 +1,10 @@
+export { RowModelError, createRowNodes } from './createRowNodes';
+export type { CreateRowNodesOptions } from './createRowNodes';
+export { TRANSIENT_ROW_ID_PREFIX, createTransientRowId, isTransientRowId, isMissingBusinessRowKey, } from './transientRowId';
+export { positionRows } from './positionRows';
+export { getRowBounds } from './getRowBounds';
+export { getRowIndexAtPixel } from './getRowIndexAtPixel';
+export { exportRowData, toUserRowData } from './rowDataExport';
+export { ClientSideRowModel } from './clientSideRowModel';
+export type { ClientSideRowModelOptions } from './clientSideRowModel';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/rowModel/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAChE,YAAY,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAA;AAC7D,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AACzD,YAAY,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAA"}

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

@@ -0,0 +1,28 @@
+import { RowNode } from '../types';
+/** 从 autoHeight 缓存取行高（各列实测 max，不低于 defaultRowHeight） */
+export declare function resolveAutoHeightFromRow(row: RowNode, defaultRowHeight: number): number | null;
+export interface PositionRowsOptions {
+    defaultRowHeight: number;
+    /** 行级动态高度（无 DOM）；优先于 row.rowHeight，低于 rowHeightPinned */
+    getRowHeight?: (row: RowNode) => number | null | undefined;
+}
+export interface ResolvedPositionRowHeight {
+    height: number;
+    estimated: boolean;
+}
+/**
+ * 解析单行参与定位的行高（可变行高模式）。
+ * 优先级：rowHeightPinned > getRowHeight 回调 > autoHeight 实测（__autoHeights）> row.rowHeight > defaultRowHeight。
+ */
+export declare function resolvePositionRowHeight(row: RowNode, defaultRowHeight: number, getRowHeight?: (row: RowNode) => number | null | undefined): ResolvedPositionRowHeight;
+/**
+ * 一趟累计 rowTop / rowIndex，建立行定位不变量。
+ *
+ * - **数字重载**：固定行高，统一写入 defaultRowHeight（refreshModel 等既有通路）。
+ * - **options 重载**：可变行高，保留各行高度 / estimated 或通过 getRowHeight 解析。
+ */
+export declare function positionRows(rows: RowNode[], defaultRowHeight: number): void;
+export declare function positionRows(rows: RowNode[], options: PositionRowsOptions): void;
+/** 末行 rowTop + rowHeight；空表返回 0 */
+export declare function getTotalRowHeight(rows: readonly RowNode[]): number;
+//# sourceMappingURL=positionRows.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"positionRows.d.ts","sourceRoot":"","sources":["../../../src/core/rowModel/positionRows.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAE1C,wDAAwD;AACxD,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,OAAO,EACZ,gBAAgB,EAAE,MAAM,GACvB,MAAM,GAAG,IAAI,CAYf;AAED,MAAM,WAAW,mBAAmB;IAClC,gBAAgB,EAAE,MAAM,CAAA;IACxB,yDAAyD;IACzD,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;CAC3D;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,OAAO,CAAA;CACnB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,OAAO,EACZ,gBAAgB,EAAE,MAAM,EACxB,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,GACzD,yBAAyB,CA4B3B;AAkCD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAA;AAC7E,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAAA;AAajF,mCAAmC;AACnC,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,CAOlE"}

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

@@ -0,0 +1,7 @@
+import { RowNode } from '../types';
+import { RowData } from '../../types';
+/** 将 RowNode 转为对外导出的行数据（浅拷贝） */
+export declare function toUserRowData(rowNode: RowNode, rowKey: string): RowData;
+/** 批量导出 RowNode 数组为用户行数据 */
+export declare function exportRowData(rows: readonly RowNode[], rowKey: string): RowData[];
+//# sourceMappingURL=rowDataExport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rowDataExport.d.ts","sourceRoot":"","sources":["../../../src/core/rowModel/rowDataExport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AAErC,gCAAgC;AAChC,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAQvE;AAED,4BAA4B;AAC5B,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,EAAE,CAEjF"}

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

@@ -0,0 +1,9 @@
+/** 新增行内部临时 ID 前缀（不对用户 data[rowKey] 暴露） */
+export declare const TRANSIENT_ROW_ID_PREFIX: "__mg_tmp_";
+/** 生成表格内部使用的临时 rowId */
+export declare function createTransientRowId(): string;
+/** 判断 id 是否为内部临时 rowId */
+export declare function isTransientRowId(id: string): boolean;
+/** 业务 rowKey 是否为空（视为尚未分配持久化主键） */
+export declare function isMissingBusinessRowKey(value: unknown): boolean;
+//# sourceMappingURL=transientRowId.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transientRowId.d.ts","sourceRoot":"","sources":["../../../src/core/rowModel/transientRowId.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,eAAO,MAAM,uBAAuB,EAAG,WAAoB,CAAA;AAS3D,wBAAwB;AACxB,wBAAgB,oBAAoB,IAAI,MAAM,CAO7C;AAED,0BAA0B;AAC1B,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,kCAAkC;AAClC,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE/D"}

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

@@ -0,0 +1,12 @@
+import { RowNode, RowTransaction } from '../types';
+import { AsyncRowMutationHandlers } from '../types/rowMutationAsync';
+export interface RunAsyncRowMutationHooksContext {
+    rowKey: string;
+    handlers?: AsyncRowMutationHandlers;
+    getRowById: (rowId: string) => RowNode | undefined;
+    sourceRows?: readonly RowNode[];
+    signal?: AbortSignal;
+}
+/** 在本地 apply 前执行 asyncRowMutation 钩子；无钩子时原样返回 transaction */
+export declare function runAsyncRowMutationHooks(transaction: RowTransaction, context: RunAsyncRowMutationHooksContext): Promise<RowTransaction>;
+//# sourceMappingURL=asyncRowMutation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"asyncRowMutation.d.ts","sourceRoot":"","sources":["../../../src/core/rowMutation/asyncRowMutation.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC1D,OAAO,KAAK,EACV,wBAAwB,EAEzB,MAAM,8BAA8B,CAAA;AAIrC,MAAM,WAAW,+BAA+B;IAC9C,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,wBAAwB,CAAA;IACnC,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,GAAG,SAAS,CAAA;IAClD,UAAU,CAAC,EAAE,SAAS,OAAO,EAAE,CAAA;IAC/B,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAkFD,6DAA6D;AAC7D,wBAAsB,wBAAwB,CAC5C,WAAW,EAAE,cAAc,EAC3B,OAAO,EAAE,+BAA+B,GACvC,OAAO,CAAC,cAAc,CAAC,CA4DzB"}

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

@@ -0,0 +1,5 @@
+export { createRowIndexContext, clampRowMoveIndex, resolveInsertSourceIndex, resolveMoveTargetSourceIndex, resolveRowIdsFromIndexes, } from './resolveRowIndex';
+export type { RowIndexContext } from './resolveRowIndex';
+export { buildAddRowsTransaction, buildRemoveRowsTransaction, collectRemoveRowIds, } from './rowMutationService';
+export { buildRowIdPromotedEvent, buildRowsAddedEvent, buildRowsRemovedEvent, } from './rowMutationEvents';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/rowMutation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,wBAAwB,EACxB,4BAA4B,EAC5B,wBAAwB,GACzB,MAAM,mBAAmB,CAAA;AAC1B,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACxD,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,qBAAqB,CAAA"}

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

@@ -0,0 +1,24 @@
+import { RowNode } from '../types';
+import { RowIndexMode } from '../types/rowMutation';
+export interface RowIndexContext {
+    sourceRows: readonly RowNode[];
+    displayRows: readonly RowNode[];
+    hasSortOrFilter: boolean;
+}
+export declare function createRowIndexContext(input: {
+    sourceRows: readonly RowNode[];
+    displayRows: readonly RowNode[];
+    sortModelLength: number;
+    filterModelKeyCount: number;
+}): RowIndexContext;
+/** 解析新增行的 source 插入下标；undefined 表示追加到末尾 */
+export declare function resolveInsertSourceIndex(index: number | undefined, indexMode: RowIndexMode, context: RowIndexContext): number | undefined;
+export declare function resolveRowIdsFromIndexes(indexes: readonly number[], indexMode: RowIndexMode, context: RowIndexContext): string[];
+/** 将 move 目标下标限制在 [0, length - 1]；空表返回 0 */
+export declare function clampRowMoveIndex(index: number, length: number): number;
+/**
+ * 解析 moveRow 的目标 source 下标。
+ * sort 激活时 display 模式返回 null；filter-only 时按 display 锚点映射。
+ */
+export declare function resolveMoveTargetSourceIndex(toIndex: number, indexMode: RowIndexMode, context: RowIndexContext, hasSortModel: boolean): number | null;
+//# sourceMappingURL=resolveRowIndex.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolveRowIndex.d.ts","sourceRoot":"","sources":["../../../src/core/rowMutation/resolveRowIndex.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAE3D,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,SAAS,OAAO,EAAE,CAAA;IAC9B,WAAW,EAAE,SAAS,OAAO,EAAE,CAAA;IAC/B,eAAe,EAAE,OAAO,CAAA;CACzB;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C,UAAU,EAAE,SAAS,OAAO,EAAE,CAAA;IAC9B,WAAW,EAAE,SAAS,OAAO,EAAE,CAAA;IAC/B,eAAe,EAAE,MAAM,CAAA;IACvB,mBAAmB,EAAE,MAAM,CAAA;CAC5B,GAAG,eAAe,CAMlB;AAED,2CAA2C;AAC3C,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,SAAS,EAAE,YAAY,EACvB,OAAO,EAAE,eAAe,GACvB,MAAM,GAAG,SAAS,CAyBpB;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,SAAS,EAAE,YAAY,EACvB,OAAO,EAAE,eAAe,GACvB,MAAM,EAAE,CAqBV;AAED,4CAA4C;AAC5C,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAMvE;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,YAAY,EACvB,OAAO,EAAE,eAAe,EACxB,YAAY,EAAE,OAAO,GACpB,MAAM,GAAG,IAAI,CAqBf"}

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

@@ -0,0 +1,6 @@
+import { RowNode } from '../types';
+import { RowIdPromotedEvent, RowsAddedEvent, RowsRemovedEvent } from '../types/events';
+export declare function buildRowsAddedEvent(added: readonly RowNode[], rowKey: string, getSourceRowIndex: (rowId: string) => number): RowsAddedEvent;
+export declare function buildRowsRemovedEvent(removed: readonly RowNode[], rowKey: string): RowsRemovedEvent;
+export declare function buildRowIdPromotedEvent(oldRowId: string, rowNode: RowNode, rowKey: string): RowIdPromotedEvent;
+//# sourceMappingURL=rowMutationEvents.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rowMutationEvents.d.ts","sourceRoot":"","sources":["../../../src/core/rowMutation/rowMutationEvents.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,EACV,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EACjB,MAAM,oBAAoB,CAAA;AAG3B,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,SAAS,OAAO,EAAE,EACzB,MAAM,EAAE,MAAM,EACd,iBAAiB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAC3C,cAAc,CAWhB;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,SAAS,OAAO,EAAE,EAC3B,MAAM,EAAE,MAAM,GACb,gBAAgB,CASlB;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,GACb,kBAAkB,CAMpB"}

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

@@ -0,0 +1,7 @@
+import { RowTransaction } from '../types';
+import { AddRowsOptions, RemoveRowsOptions } from '../types/rowMutation';
+import { RowIndexContext } from './resolveRowIndex';
+export declare function buildAddRowsTransaction(options: AddRowsOptions, context: RowIndexContext): RowTransaction;
+export declare function buildRemoveRowsTransaction(options: RemoveRowsOptions, context: RowIndexContext): RowTransaction;
+export declare function collectRemoveRowIds(transaction: RowTransaction): string[];
+//# sourceMappingURL=rowMutationService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rowMutationService.d.ts","sourceRoot":"","sources":["../../../src/core/rowMutation/rowMutationService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEjD,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAChF,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,mBAAmB,CAAA;AAE1B,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,eAAe,GACvB,cAAc,CAUhB;AAED,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,eAAe,GACvB,cAAc,CAiBhB;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,cAAc,GAAG,MAAM,EAAE,CAMzE"}

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

@@ -0,0 +1,5 @@
+export { ScrollBridge } from './scrollBridge';
+export { detectOverlayScrollbars, invalidateScrollbarWidthCache, measureScrollbarWidth, OVERLAY_SCROLLBAR_VISUAL_WIDTH, } from './measureScrollbarWidth';
+export { resolveScrollbarGutter, applyScrollbarGutterVars, type ScrollbarGutterSizes } from './resolveScrollbarGutter';
+export { getVirtualScrollRange, MAX_NATIVE_SCROLL_HEIGHT, toLogicalScrollTop, toPhysicalScrollTop, type VirtualScrollRange, } from './virtualScrollMapper';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/scroll/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EACL,uBAAuB,EACvB,6BAA6B,EAC7B,qBAAqB,EACrB,8BAA8B,GAC/B,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,KAAK,oBAAoB,EAAE,MAAM,0BAA0B,CAAA;AACtH,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,EACnB,KAAK,kBAAkB,GACxB,MAAM,uBAAuB,CAAA"}

package/dist/core/scroll/measureScrollbarWidth.d.ts

@@ -0,0 +1,8 @@
+/** macOS overlay 滚动条无布局宽度时的 fake gutter 视觉宽度 */
+export declare const OVERLAY_SCROLLBAR_VISUAL_WIDTH = 8;
+/** 离屏探测原生滚动条占位宽度（结果会话内缓存） */
+export declare function measureScrollbarWidth(doc?: Document): number;
+export declare function invalidateScrollbarWidthCache(): void;
+/** overlay 滚动条不占布局宽度（macOS 默认） */
+export declare function detectOverlayScrollbars(doc?: Document): boolean;
+//# sourceMappingURL=measureScrollbarWidth.d.ts.map

package/dist/core/scroll/measureScrollbarWidth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"measureScrollbarWidth.d.ts","sourceRoot":"","sources":["../../../src/core/scroll/measureScrollbarWidth.ts"],"names":[],"mappings":"AAEA,gDAAgD;AAChD,eAAO,MAAM,8BAA8B,IAAI,CAAA;AAE/C,6BAA6B;AAC7B,wBAAgB,qBAAqB,CAAC,GAAG,GAAE,QAAmB,GAAG,MAAM,CAoBtE;AAED,wBAAgB,6BAA6B,IAAI,IAAI,CAEpD;AAED,kCAAkC;AAClC,wBAAgB,uBAAuB,CAAC,GAAG,GAAE,QAAmB,GAAG,OAAO,CAWzE"}

package/dist/core/scroll/resolveScrollbarGutter.d.ts

@@ -0,0 +1,28 @@
+export interface ScrollbarGutterSizes {
+    /** 表头/表尾 padding-right，影响列对齐 */
+    layout: number;
+    /** fake gutter ::after 宽度，仅视觉 */
+    visual: number;
+}
+export interface ResolveScrollbarGutterInput {
+    hasVScrollbar: boolean;
+    liveGutterWidth: number;
+    overlayScrollbars?: boolean;
+    measuredWidth?: number;
+}
+export interface ApplyScrollbarGutterTarget {
+    rootEl: HTMLElement;
+    headerViewportEl: HTMLElement;
+    footerViewportEl?: HTMLElement;
+    floatingFilterViewportEl?: HTMLElement;
+    magicGridEl?: HTMLElement | null;
+}
+/**
+ * 解析表头/表尾 gutter：
+ * - classic（Windows 等）：layout = visual = 实测占位
+ * - overlay（macOS 等）：layout = 0，visual = 离屏测量 / fallback
+ */
+export declare function resolveScrollbarGutter(input: ResolveScrollbarGutterInput): ScrollbarGutterSizes;
+/** 将 gutter 尺寸写入 DOM（CSS 变量 + overlay class） */
+export declare function applyScrollbarGutterVars(target: ApplyScrollbarGutterTarget, viewport: HTMLElement, overlayScrollbars: boolean): ScrollbarGutterSizes;
+//# sourceMappingURL=resolveScrollbarGutter.d.ts.map

package/dist/core/scroll/resolveScrollbarGutter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveScrollbarGutter.d.ts","sourceRoot":"","sources":["../../../src/core/scroll/resolveScrollbarGutter.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,oBAAoB;IACnC,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAA;IACd,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,2BAA2B;IAC1C,aAAa,EAAE,OAAO,CAAA;IACtB,eAAe,EAAE,MAAM,CAAA;IACvB,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,WAAW,CAAA;IACnB,gBAAgB,EAAE,WAAW,CAAA;IAC7B,gBAAgB,CAAC,EAAE,WAAW,CAAA;IAC9B,wBAAwB,CAAC,EAAE,WAAW,CAAA;IACtC,WAAW,CAAC,EAAE,WAAW,GAAG,IAAI,CAAA;CACjC;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,2BAA2B,GAAG,oBAAoB,CAc/F;AAED,gDAAgD;AAChD,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,0BAA0B,EAClC,QAAQ,EAAE,WAAW,EACrB,iBAAiB,EAAE,OAAO,GACzB,oBAAoB,CAwBtB"}

package/dist/core/scroll/scrollBridge.d.ts

@@ -0,0 +1,12 @@
+/** 滚动桥：scroll 事件零重活，仅记录 nextScrollTop */
+export declare class ScrollBridge {
+    private scrollTop;
+    private nextScrollTop;
+    notifyScroll(nextScrollTop: number): void;
+    isScrollGoingDown(): boolean;
+    scrollGridIfNeeded(onApplied: (scrollTop: number) => void): boolean;
+    syncScrollTop(scrollTop: number): void;
+    getScrollTop(): number;
+    getNextScrollTop(): number;
+}
+//# sourceMappingURL=scrollBridge.d.ts.map

package/dist/core/scroll/scrollBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scrollBridge.d.ts","sourceRoot":"","sources":["../../../src/core/scroll/scrollBridge.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAAI;IACrB,OAAO,CAAC,aAAa,CAAI;IAEzB,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI;IAIzC,iBAAiB,IAAI,OAAO;IAI5B,kBAAkB,CAAC,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO;IAUnE,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAKtC,YAAY,IAAI,MAAM;IAItB,gBAAgB,IAAI,MAAM;CAG3B"}

package/dist/core/scroll/virtualScrollMapper.d.ts

@@ -0,0 +1,20 @@
+/** 浏览器原生 scroll 高度上限（Chrome / Safari / Firefox 约 2^24 px） */
+export declare const MAX_NATIVE_SCROLL_HEIGHT = 16777216;
+export interface VirtualScrollRange {
+    totalHeight: number;
+    viewportHeight: number;
+    rowHeight: number;
+    rowCount: number;
+    compressed: boolean;
+    physicalSpacerHeight: number;
+    physicalMaxScroll: number;
+    logicalMaxScroll: number;
+}
+/**
+ * 超出浏览器 scroll 上限时，启用「1px = 1 行」的 scroll 轨道：
+ * physicalScrollTop 表示行索引偏移，logicalScrollTop = physical * rowHeight。
+ */
+export declare function getVirtualScrollRange(totalHeight: number, viewportHeight: number, rowHeight: number, rowCount: number): VirtualScrollRange;
+export declare function toLogicalScrollTop(physicalScrollTop: number, range: VirtualScrollRange): number;
+export declare function toPhysicalScrollTop(logicalScrollTop: number, range: VirtualScrollRange): number;
+//# sourceMappingURL=virtualScrollMapper.d.ts.map

package/dist/core/scroll/virtualScrollMapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtualScrollMapper.d.ts","sourceRoot":"","sources":["../../../src/core/scroll/virtualScrollMapper.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,eAAO,MAAM,wBAAwB,WAAa,CAAA;AAElD,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAA;IACnB,cAAc,EAAE,MAAM,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,OAAO,CAAA;IACnB,oBAAoB,EAAE,MAAM,CAAA;IAC5B,iBAAiB,EAAE,MAAM,CAAA;IACzB,gBAAgB,EAAE,MAAM,CAAA;CACzB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,kBAAkB,CA8BpB;AAED,wBAAgB,kBAAkB,CAChC,iBAAiB,EAAE,MAAM,EACzB,KAAK,EAAE,kBAAkB,GACxB,MAAM,CAUR;AAED,wBAAgB,mBAAmB,CACjC,gBAAgB,EAAE,MAAM,EACxB,KAAK,EAAE,kBAAkB,GACxB,MAAM,CAUR"}