@taocompany/magic-grid 0.1.0

package/dist/core/grid/gridViewport.d.ts

@@ -0,0 +1,123 @@
+import { AnimationFrameService } from '../frame/animationFrameService';
+import { ColumnModel } from '../column/columnModel';
+import { ColumnViewport } from '../column/columnViewport';
+import { ValidationFeedbackService } from '../editing/validationFeedback';
+import { ClientSideRowModel } from '../rowModel/clientSideRowModel';
+import { RowRenderer } from '../renderer/rowRenderer';
+import { ScrollBridge } from '../scroll/scrollBridge';
+import { EnsureIndexVisiblePosition } from '../api/gridApi';
+import { ResolvedSelectionColumnGridOptions } from '../types/selectionColumn';
+export interface GridViewportDeps {
+    rootEl: HTMLElement;
+    headerViewportEl: HTMLElement;
+    headerScrollEl: HTMLElement;
+    headerRowEl: HTMLElement;
+    headerLeftLaneEl: HTMLElement;
+    headerCenterLaneEl: HTMLElement;
+    headerRightLaneEl: HTMLElement;
+    viewportEl: HTMLElement;
+    spacerEl: HTMLElement;
+    scrollPhantomEl: HTMLElement;
+    rowsLayerEl: HTMLElement;
+    indexColumnFillHostEl: HTMLElement;
+    indexColumnFillEl: HTMLElement;
+    rowsContainerEl: HTMLElement;
+    footerViewportEl?: HTMLElement;
+    footerScrollEl?: HTMLElement;
+    footerRowEl?: HTMLElement;
+    footerLeftLaneEl?: HTMLElement;
+    footerCenterLaneEl?: HTMLElement;
+    footerRightLaneEl?: HTMLElement;
+    floatingFilterViewportEl?: HTMLElement;
+    floatingFilterScrollEl?: HTMLElement;
+    floatingFilterRowEl?: HTMLElement;
+    floatingFilterLeftLaneEl?: HTMLElement;
+    floatingFilterCenterLaneEl?: HTMLElement;
+    floatingFilterRightLaneEl?: HTMLElement;
+    refreshFooter?: () => void;
+    refreshFloatingFilter?: () => void;
+    refreshFloatingFilterActiveState?: () => void;
+    rowModel: ClientSideRowModel;
+    columnModel: ColumnModel;
+    columnViewport: ColumnViewport;
+    validationFeedback: ValidationFeedbackService;
+    rowRenderer: RowRenderer;
+    scrollBridge: ScrollBridge;
+    frameService: AnimationFrameService;
+    getPinnedRowIds: () => ReadonlySet<string>;
+    selectionColumnOptions: ResolvedSelectionColumnGridOptions;
+    showIndexColumn: boolean;
+    showUnsortedSortHintOnHover: () => boolean;
+    getDefaultRowHeight: () => number;
+    headerHeight: number;
+    isDestroyed: () => boolean;
+    onBodyScroll: (scrollTop: number, scrollLeft: number) => void;
+    onScroll?: () => void;
+    applySelectionVisuals: () => void;
+    applyFocusVisuals: () => void;
+    applyCellRangeVisuals?: () => void;
+    /** 非 compressed 模式下 scroll 时轻量同步选区 overlay（横滚即时对齐） */
+    applyCellRangeScrollVisuals?: () => void;
+    onHeaderRefresh?: () => void;
+}
+/** 视口滚动、虚拟高度与重绘 */
+export declare class GridViewport {
+    private readonly deps;
+    private lastScrollLeft;
+    private onAfterRedraw;
+    private resizeObserver;
+    private overlayScrollbars;
+    constructor(deps: GridViewportDeps);
+    setOnAfterRedraw(handler: () => void): void;
+    get viewportEl(): HTMLElement;
+    bindScrollListener(): void;
+    unbindScrollListener(): void;
+    getLogicalScrollTop(): number;
+    /** 行渲染与选区 overlay 共用的视口高度（compressed 时为 rowsLayer 高度） */
+    getRenderViewportHeight(): number;
+    scrollTo(scrollTop: number, scrollLeft?: number): void;
+    scrollByDelta(delta: number): void;
+    scrollByHorizontalDelta(delta: number): void;
+    ensureIndexVisible(index: number, position?: EnsureIndexVisiblePosition): void;
+    ensureColumnVisible(colIndex: number): void;
+    syncHorizontalLayout(): void;
+    /** Phase 14 · 列宽变更后同步各层 cell left/width（不重建 DOM） */
+    syncColumnCellLayouts(): void;
+    syncBorderClosureState(): void;
+    syncViewportHeight(): void;
+    scrollGridIfNeeded(): boolean;
+    redrawImmediately(): void;
+    resetScrollOnSetData(): void;
+    scheduleCompressedSetDataRedraw(redraw: () => void): void;
+    syncPinnedRows(): void;
+    private readonly handleScroll;
+    private redrawViewport;
+    /** 表头/表尾 layout gutter + fake visual gutter（CSS 变量驱动） */
+    private syncScrollbarGutter;
+    private getOverlayScrollbars;
+    private handleViewportResize;
+    /** 表头/表尾行宽与列总宽一致；通栏空白由 viewport 背景承担，避免拉宽行导致右固定列 sticky 错位 */
+    private syncHeaderFooterRowWidth;
+    private syncFooterHorizontalLayout;
+    /** Phase 12 · filterChanged 后仅更新 floating filter 激活态 */
+    refreshFloatingFilterActiveState(): void;
+    private syncFloatingFilterHorizontalLayout;
+    private syncFloatingFilterScrollLeft;
+    private syncFooterScrollLeft;
+    private renderHeader;
+    /** sortModel / 列定义变更后重绘表头 sort 指示器 */
+    refreshHeader(): void;
+    /** Phase 12 · filterChanged 后仅更新表头 filter 激活态，不重建表头 DOM */
+    refreshHeaderFilterActiveState(): void;
+    private getViewportHeight;
+    private getRenderViewportHeightInternal;
+    private syncCompressedLayerHeight;
+    /** 行数不足视口高度时，索引列向下补满剩余 Y 轴区域 */
+    private syncIndexColumnFill;
+    private getScrollRange;
+    /** 同步视口高度前解析逻辑 scrollTop（DOM 未变更前读取） */
+    private resolveLogicalScrollTopForSync;
+    private applyPhysicalScrollFromLogical;
+    private syncScrollMode;
+}
+//# sourceMappingURL=gridViewport.d.ts.map

package/dist/core/grid/gridViewport.d.ts.map

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

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

@@ -0,0 +1,5 @@
+export { Grid } from './grid';
+export type { GridInitOptions } from './gridOptions';
+export type { GridMetrics, GridAcceptanceThresholds } from './gridMetrics';
+export { evaluateGridAcceptance, getGridAcceptanceThresholds, getGridSetDataLimit, } from './gridMetrics';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/grid/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAC7B,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AACpD,YAAY,EAAE,WAAW,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAA;AAC1E,OAAO,EACL,sBAAsB,EACtB,2BAA2B,EAC3B,mBAAmB,GACpB,MAAM,eAAe,CAAA"}

package/dist/core/grid/indexDragSelect.d.ts

@@ -0,0 +1,11 @@
+import { ClientSideRowModel } from '../rowModel/clientSideRowModel';
+export declare const INDEX_DRAG_EDGE_ZONE_PX = 40;
+export declare const INDEX_DRAG_MAX_SCROLL_ROWS_PER_FRAME = 1.5;
+export interface IndexDragRowTarget {
+    rowId: string;
+    rowIndex: number;
+}
+export declare function computeIndexDragEdgeScrollDelta(clientY: number, viewportTop: number, viewportBottom: number, rowHeight: number): number;
+export declare function resolveIndexDragRowTarget(rowModel: ClientSideRowModel, viewportEl: HTMLElement, clientX: number, clientY: number, getLogicalScrollTop: () => number): IndexDragRowTarget | null;
+export declare function isIndexDragEdgeScrollActive(clientY: number, viewportTop: number, viewportBottom: number): boolean;
+//# sourceMappingURL=indexDragSelect.d.ts.map

package/dist/core/grid/indexDragSelect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexDragSelect.d.ts","sourceRoot":"","sources":["../../../src/core/grid/indexDragSelect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAA;AAE3E,eAAO,MAAM,uBAAuB,KAAK,CAAA;AACzC,eAAO,MAAM,oCAAoC,MAAM,CAAA;AAEvD,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,GAChB,MAAM,CAcR;AAED,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,kBAAkB,EAC5B,UAAU,EAAE,WAAW,EACvB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,mBAAmB,EAAE,MAAM,MAAM,GAChC,kBAAkB,GAAG,IAAI,CAgB3B;AA0BD,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,GACrB,OAAO,CAET"}

package/dist/core/index.d.ts

@@ -0,0 +1,20 @@
+export * from './constants';
+export * from './types';
+export * from './rowModel';
+export * from './column';
+export * from './span';
+export * from './transaction';
+export * from './cell';
+export * from './value';
+export * from './changeDetection';
+export * from './event';
+export * from './api';
+export * from './selection';
+export * from './editing';
+export * from './navigation';
+export * from './renderer';
+export * from './row';
+export * from './frame';
+export * from './scroll';
+export * from './grid';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,SAAS,CAAA;AACvB,cAAc,YAAY,CAAA;AAC1B,cAAc,UAAU,CAAA;AACxB,cAAc,QAAQ,CAAA;AACtB,cAAc,eAAe,CAAA;AAC7B,cAAc,QAAQ,CAAA;AACtB,cAAc,SAAS,CAAA;AACvB,cAAc,mBAAmB,CAAA;AACjC,cAAc,SAAS,CAAA;AACvB,cAAc,OAAO,CAAA;AACrB,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,OAAO,CAAA;AACrB,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,QAAQ,CAAA"}

package/dist/core/indexFocus/indexFocusService.d.ts

@@ -0,0 +1,7 @@
+import { SelectionService, RowSelectionMode } from '../selection/selectionService';
+export type IndexFocusMode = RowSelectionMode;
+/** 索引列辅助行定位：与 SelectionService 相同状态机，独立实例 */
+export declare class IndexFocusService extends SelectionService {
+    getFocusedRowIds(): string[];
+}
+//# sourceMappingURL=indexFocusService.d.ts.map

package/dist/core/indexFocus/indexFocusService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexFocusService.d.ts","sourceRoot":"","sources":["../../../src/core/indexFocus/indexFocusService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,KAAK,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AAE1F,MAAM,MAAM,cAAc,GAAG,gBAAgB,CAAA;AAE7C,6CAA6C;AAC7C,qBAAa,iBAAkB,SAAQ,gBAAgB;IACrD,gBAAgB,IAAI,MAAM,EAAE;CAG7B"}

package/dist/core/indexFocus/syncIndexFocusToSelection.d.ts

@@ -0,0 +1,7 @@
+import { IndexFocusMode } from './indexFocusService';
+import { RowSelectionMode } from '../selection/selectionService';
+/** 索引 focusMode 与行选择列 rowSelection 同为 single 或同为 multiple 时才允许同步 */
+export declare function isIndexFocusSyncModeCompatible(indexFocusMode: IndexFocusMode, selectionMode: RowSelectionMode): boolean;
+/** 索引定位同步到行选择列时解析应写入的 rowId 列表；模式不一致时返回空数组 */
+export declare function resolveSyncRowIdsFromIndexFocus(focusedRowIds: readonly string[], indexFocusMode: IndexFocusMode, selectionMode: RowSelectionMode): string[];
+//# sourceMappingURL=syncIndexFocusToSelection.d.ts.map

package/dist/core/indexFocus/syncIndexFocusToSelection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"syncIndexFocusToSelection.d.ts","sourceRoot":"","sources":["../../../src/core/indexFocus/syncIndexFocusToSelection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AAExE,oEAAoE;AACpE,wBAAgB,8BAA8B,CAC5C,cAAc,EAAE,cAAc,EAC9B,aAAa,EAAE,gBAAgB,GAC9B,OAAO,CAET;AAED,8CAA8C;AAC9C,wBAAgB,+BAA+B,CAC7C,aAAa,EAAE,SAAS,MAAM,EAAE,EAChC,cAAc,EAAE,cAAc,EAC9B,aAAa,EAAE,gBAAgB,GAC9B,MAAM,EAAE,CAUV"}

package/dist/core/navigation/cellFocusService.d.ts

@@ -0,0 +1,43 @@
+export interface FocusedCell {
+    rowId: string;
+    colId: string;
+    rowIndex: number;
+    colIndex: number;
+}
+export type FocusDirection = 'up' | 'down' | 'left' | 'right';
+/** 表头行在焦点模型中的 rowIndex */
+export declare const HEADER_ROW_INDEX = -1;
+/** 表头行在焦点模型中的 rowId */
+export declare const HEADER_ROW_ID = "__header__";
+/** 表尾汇总行在焦点模型中的 rowIndex */
+export declare const FOOTER_ROW_INDEX = -2;
+/** 表尾汇总行在焦点模型中的 rowId */
+export declare const FOOTER_ROW_ID = "__footer__";
+export declare function isHeaderFocusedCell(focus: FocusedCell): boolean;
+export declare function isFooterFocusedCell(focus: FocusedCell): boolean;
+export declare function isChromeFocusedCell(focus: FocusedCell): boolean;
+/** 表头/表尾焦点导航开关（由 Grid 配置注入） */
+export interface FocusChromeNavigation {
+    headerEnabled?: boolean;
+    footerEnabled?: boolean;
+}
+/** 键盘焦点：方向键移动单元格 */
+export declare class CellFocusService {
+    private focus;
+    getFocusedCell(): FocusedCell | null;
+    setFocusedCell(cell: FocusedCell | null): void;
+    clear(): void;
+    move(direction: FocusDirection, rowCount: number, navigationOrder: readonly number[], getRowIdAt: (index: number) => string | undefined, getColIdAt: (globalColIndex: number) => string | undefined, chromeNav?: FocusChromeNavigation): FocusedCell | null;
+    moveTab(backward: boolean, rowCount: number, navigationOrder: readonly number[], getRowIdAt: (index: number) => string | undefined, getColIdAt: (globalColIndex: number) => string | undefined, chromeNav?: FocusChromeNavigation): FocusedCell | null;
+    moveToEdge(direction: FocusDirection, rowCount: number, navigationOrder: readonly number[], getRowIdAt: (index: number) => string | undefined, getColIdAt: (globalColIndex: number) => string | undefined, chromeNav?: FocusChromeNavigation): FocusedCell | null;
+}
+export declare function moveFocusedCell(current: FocusedCell, direction: FocusDirection, rowCount: number, navigationOrder: readonly number[], getRowIdAt: (index: number) => string | undefined, getColIdAt: (globalColIndex: number) => string | undefined, chromeNav?: FocusChromeNavigation): FocusedCell | null;
+/** Tab 下一格；表头 ↔ 表体衔接；Shift+Tab 反向（列序：左→中→右） */
+export declare function moveTabFocusedCell(current: FocusedCell, backward: boolean, rowCount: number, navigationOrder: readonly number[], getRowIdAt: (index: number) => string | undefined, getColIdAt: (globalColIndex: number) => string | undefined, chromeNav?: FocusChromeNavigation): FocusedCell | null;
+/** Ctrl+方向键：跳转到首/末行或导航序首/末列 */
+export declare function moveToEdgeFocusedCell(current: FocusedCell, direction: FocusDirection, rowCount: number, navigationOrder: readonly number[], getRowIdAt: (index: number) => string | undefined, getColIdAt: (globalColIndex: number) => string | undefined, chromeNav?: FocusChromeNavigation): FocusedCell | null;
+/** Tab 切换到下一个可编辑单元格；找不到时返回 null */
+export declare function findNextEditableTabCell(current: FocusedCell, backward: boolean, rowCount: number, navigationOrder: readonly number[], getRowIdAt: (index: number) => string | undefined, getColIdAt: (globalColIndex: number) => string | undefined, isEditableAt: (rowIndex: number, colId: string) => boolean, chromeNav?: FocusChromeNavigation): FocusedCell | null;
+/** 行编辑 Tab：仅在同行可编辑列间循环（colIds 须按列顺序排列） */
+export declare function findNextRowEditTabCol(currentColId: string, editableColIds: readonly string[], backward: boolean): string | null;
+//# sourceMappingURL=cellFocusService.d.ts.map

package/dist/core/navigation/cellFocusService.d.ts.map

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

package/dist/core/navigation/columnNavigationOrder.d.ts

@@ -0,0 +1,8 @@
+import { IColumnModel } from '../types';
+/** 键盘导航列序：左固定 → 中心 → 右固定（全局 col index；含索引列） */
+export declare function buildColumnNavigationOrder(columnModel: IColumnModel): readonly number[];
+export declare function toNavigationColIndex(globalColIndex: number, navigationOrder: readonly number[]): number;
+export declare function toGlobalColIndex(navigationColIndex: number, navigationOrder: readonly number[]): number | undefined;
+export declare function getFirstNavigationColIndex(navigationOrder: readonly number[]): number;
+export declare function getLastNavigationColIndex(navigationOrder: readonly number[]): number;
+//# sourceMappingURL=columnNavigationOrder.d.ts.map

package/dist/core/navigation/columnNavigationOrder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"columnNavigationOrder.d.ts","sourceRoot":"","sources":["../../../src/core/navigation/columnNavigationOrder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE/C,+CAA+C;AAC/C,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,YAAY,GAAG,SAAS,MAAM,EAAE,CAMvF;AAED,wBAAgB,oBAAoB,CAClC,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,SAAS,MAAM,EAAE,GACjC,MAAM,CAGR;AAED,wBAAgB,gBAAgB,CAC9B,kBAAkB,EAAE,MAAM,EAC1B,eAAe,EAAE,SAAS,MAAM,EAAE,GACjC,MAAM,GAAG,SAAS,CAEpB;AAED,wBAAgB,0BAA0B,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAErF;AAED,wBAAgB,yBAAyB,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAEpF"}

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

@@ -0,0 +1,3 @@
+export { CellFocusService, FOOTER_ROW_ID, FOOTER_ROW_INDEX, HEADER_ROW_ID, HEADER_ROW_INDEX, isChromeFocusedCell, isFooterFocusedCell, isHeaderFocusedCell, moveFocusedCell, moveTabFocusedCell, moveToEdgeFocusedCell, type FocusedCell, type FocusDirection, type FocusChromeNavigation, } from './cellFocusService';
+export { buildColumnNavigationOrder, getFirstNavigationColIndex, getLastNavigationColIndex, toGlobalColIndex, toNavigationColIndex, } from './columnNavigationOrder';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/navigation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,qBAAqB,GAC3B,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,0BAA0B,EAC1B,0BAA0B,EAC1B,yBAAyB,EACzB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,yBAAyB,CAAA"}

package/dist/core/overlay/overlayComponentHost.d.ts

@@ -0,0 +1,10 @@
+import { IOverlayParams, OverlayComponentType } from '../types/emptyState';
+/** IOverlayComp / 工厂函数挂载宿主 */
+export declare class OverlayComponentHost {
+    private activeComp;
+    private activeMountEl;
+    mount(mountEl: HTMLElement, params: IOverlayParams, factory: OverlayComponentType): void;
+    refresh(params: IOverlayParams): boolean;
+    destroy(): void;
+}
+//# sourceMappingURL=overlayComponentHost.d.ts.map

package/dist/core/overlay/overlayComponentHost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlayComponentHost.d.ts","sourceRoot":"","sources":["../../../src/core/overlay/overlayComponentHost.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgB,cAAc,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAEhG,8BAA8B;AAC9B,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,UAAU,CAA4B;IAC9C,OAAO,CAAC,aAAa,CAA2B;IAEhD,KAAK,CACH,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,oBAAoB,GAC5B,IAAI;IAmBP,OAAO,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO;IAIxC,OAAO,IAAI,IAAI;CAMhB"}

package/dist/core/overlay/overlayLayout.d.ts

@@ -0,0 +1,17 @@
+import { OverlayType } from '../types/emptyState';
+export interface SyncOverlayLayoutOptions {
+    overlayType: OverlayType | null;
+    overlayInteraction: boolean;
+}
+export declare function resolveOverlayPointerEvents(options: SyncOverlayLayoutOptions): {
+    blockEvents: boolean;
+    masked: boolean;
+};
+/** 同步 overlay 布局与交互样式（viewport 内全屏居中 · 不随内容纵滚） */
+export declare function syncOverlayLayout(overlayEl: HTMLElement, wrapperEl: HTMLElement, options: SyncOverlayLayoutOptions): void;
+export declare function createOverlayDom(): {
+    overlayEl: HTMLElement;
+    wrapperEl: HTMLElement;
+    contentEl: HTMLElement;
+};
+//# sourceMappingURL=overlayLayout.d.ts.map

package/dist/core/overlay/overlayLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlayLayout.d.ts","sourceRoot":"","sources":["../../../src/core/overlay/overlayLayout.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,WAAW,EACjB,MAAM,wBAAwB,CAAA;AAE/B,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,WAAW,GAAG,IAAI,CAAA;IAC/B,kBAAkB,EAAE,OAAO,CAAA;CAC5B;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,wBAAwB,GAAG;IAC9E,WAAW,EAAE,OAAO,CAAA;IACpB,MAAM,EAAE,OAAO,CAAA;CAChB,CAUA;AAED,kDAAkD;AAClD,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,WAAW,EACtB,SAAS,EAAE,WAAW,EACtB,OAAO,EAAE,wBAAwB,GAChC,IAAI,CAUN;AAED,wBAAgB,gBAAgB,IAAI;IAClC,SAAS,EAAE,WAAW,CAAA;IACtB,SAAS,EAAE,WAAW,CAAA;IACtB,SAAS,EAAE,WAAW,CAAA;CACvB,CAgBA"}

package/dist/core/overlay/overlayRenderer.d.ts

@@ -0,0 +1,23 @@
+import { OverlayPresentation } from './overlayService';
+import { GridApi } from '../api/gridApi';
+import { OverlayType } from '../types/emptyState';
+export interface OverlayRendererDeps {
+    overlayEl: HTMLElement;
+    wrapperEl: HTMLElement;
+    contentEl: HTMLElement;
+    getApi: () => GridApi;
+    getOverlayInteraction: () => boolean;
+}
+export declare class OverlayRenderer {
+    private readonly deps;
+    private visibleType;
+    private readonly componentHost;
+    constructor(deps: OverlayRendererDeps);
+    sync(type: OverlayType | null, presentation: OverlayPresentation | null): void;
+    hide(): void;
+    destroy(): void;
+    getVisibleType(): OverlayType | null;
+    syncLayout(type?: OverlayType | null): void;
+    private renderContent;
+}
+//# sourceMappingURL=overlayRenderer.d.ts.map

package/dist/core/overlay/overlayRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlayRenderer.d.ts","sourceRoot":"","sources":["../../../src/core/overlay/overlayRenderer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAA;AAEvE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAIL,KAAK,WAAW,EACjB,MAAM,wBAAwB,CAAA;AAE/B,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,WAAW,CAAA;IACtB,SAAS,EAAE,WAAW,CAAA;IACtB,SAAS,EAAE,WAAW,CAAA;IACtB,MAAM,EAAE,MAAM,OAAO,CAAA;IACrB,qBAAqB,EAAE,MAAM,OAAO,CAAA;CACrC;AAED,qBAAa,eAAe;IAId,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHjC,OAAO,CAAC,WAAW,CAA2B;IAC9C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA6B;gBAE9B,IAAI,EAAE,mBAAmB;IAEtD,IAAI,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,EAAE,YAAY,EAAE,mBAAmB,GAAG,IAAI,GAAG,IAAI;IAoB9E,IAAI,IAAI,IAAI;IAUZ,OAAO,IAAI,IAAI;IAIf,cAAc,IAAI,WAAW,GAAG,IAAI;IAIpC,UAAU,CAAC,IAAI,GAAE,WAAW,GAAG,IAAuB,GAAG,IAAI;IAO7D,OAAO,CAAC,aAAa;CAoBtB"}

package/dist/core/overlay/overlayService.d.ts

@@ -0,0 +1,39 @@
+import { OverlayComponentType, OverlayType, ResolvedEmptyStateGridOptions } from '../types/emptyState';
+import { ResolveOverlayTypeInput } from './resolveOverlayType';
+import { RowNode } from '../types/rowNode';
+export interface OverlayPresentation {
+    overlayType: OverlayType;
+    component?: OverlayComponentType;
+    componentParams?: Record<string, unknown>;
+    template?: string;
+}
+export interface OverlayServiceDeps {
+    getResolvedOptions: () => ResolvedEmptyStateGridOptions;
+    getSourceRowCount: () => number;
+    getDisplayRows: () => readonly RowNode[];
+    isAnyFilterActive: () => boolean;
+    onOverlayChanged?: (next: OverlayType | null, prev: OverlayType | null) => void;
+    warn?: (message: string) => void;
+}
+export declare function resolveOverlayPresentation(type: OverlayType, options: ResolvedEmptyStateGridOptions): OverlayPresentation;
+export declare class OverlayService {
+    private readonly deps;
+    private userForcedNoRows;
+    private rowDataReady;
+    private currentType;
+    private destroyed;
+    constructor(deps: OverlayServiceDeps);
+    markRowDataReady(): void;
+    isRowDataReady(): boolean;
+    isUserForcedNoRows(): boolean;
+    getOverlayType(): OverlayType | null;
+    isOverlayShowing(): boolean;
+    getOverlayPresentation(): OverlayPresentation | null;
+    buildResolveInput(): ResolveOverlayTypeInput;
+    updateOverlay(): void;
+    showNoRowsOverlay(): void;
+    hideOverlay(): boolean;
+    destroy(): void;
+    private setCurrentType;
+}
+//# sourceMappingURL=overlayService.d.ts.map

package/dist/core/overlay/overlayService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlayService.d.ts","sourceRoot":"","sources":["../../../src/core/overlay/overlayService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,WAAW,EACX,6BAA6B,EAC9B,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAGL,KAAK,uBAAuB,EAC7B,MAAM,kCAAkC,CAAA;AACzC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAElD,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,WAAW,CAAA;IACxB,SAAS,CAAC,EAAE,oBAAoB,CAAA;IAChC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;IACvD,iBAAiB,EAAE,MAAM,MAAM,CAAA;IAC/B,cAAc,EAAE,MAAM,SAAS,OAAO,EAAE,CAAA;IACxC,iBAAiB,EAAE,MAAM,OAAO,CAAA;IAChC,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAA;IAC/E,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CACjC;AAmCD,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,6BAA6B,GACrC,mBAAmB,CAgBrB;AAED,qBAAa,cAAc;IAMb,OAAO,CAAC,QAAQ,CAAC,IAAI;IALjC,OAAO,CAAC,gBAAgB,CAAQ;IAChC,OAAO,CAAC,YAAY,CAAQ;IAC5B,OAAO,CAAC,WAAW,CAA2B;IAC9C,OAAO,CAAC,SAAS,CAAQ;gBAEI,IAAI,EAAE,kBAAkB;IAErD,gBAAgB,IAAI,IAAI;IAIxB,cAAc,IAAI,OAAO;IAIzB,kBAAkB,IAAI,OAAO;IAI7B,cAAc,IAAI,WAAW,GAAG,IAAI;IAIpC,gBAAgB,IAAI,OAAO;IAI3B,sBAAsB,IAAI,mBAAmB,GAAG,IAAI;IAQpD,iBAAiB,IAAI,uBAAuB;IAc5C,aAAa,IAAI,IAAI;IASrB,iBAAiB,IAAI,IAAI;IASzB,WAAW,IAAI,OAAO;IA6BtB,OAAO,IAAI,IAAI;IAUf,OAAO,CAAC,cAAc;CASvB"}

package/dist/core/overlay/parseOverlayTemplate.d.ts

@@ -0,0 +1,3 @@
+/** 解析 overlay HTML 模板；非白名单标签降级为纯文本 */
+export declare function parseOverlayTemplate(template: string): HTMLElement | string;
+//# sourceMappingURL=parseOverlayTemplate.d.ts.map

package/dist/core/overlay/parseOverlayTemplate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseOverlayTemplate.d.ts","sourceRoot":"","sources":["../../../src/core/overlay/parseOverlayTemplate.ts"],"names":[],"mappings":"AAWA,sCAAsC;AACtC,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,CAuB3E"}

package/dist/core/overlay/resolveOverlayType.d.ts

@@ -0,0 +1,21 @@
+import { OverlayType } from '../types/emptyState';
+import { RowNode } from '../types/rowNode';
+export interface ResolveOverlayTypeInput {
+    loading: boolean | undefined;
+    suppressOverlays: ReadonlySet<OverlayType>;
+    sourceRowCount: number;
+    displayDataRowCount: number;
+    isAnyFilterActive: boolean;
+    /** 是否已完成首次 setData（用于 loading undefined 自动态） */
+    rowDataReady: boolean;
+    /** API showNoRowsOverlay 强制 */
+    userForcedNoRows: boolean;
+}
+/** 从 rowsToDisplay 统计 data 行（排除 detail / groupHeader / groupFooter 等合成行） */
+export declare function countDisplayDataRows(rows: readonly RowNode[]): number;
+/**
+ * 根据行模型与 Grid 状态解析应展示的 overlay 类型。
+ * 纯函数 · 不读 DOM。
+ */
+export declare function resolveOverlayType(input: ResolveOverlayTypeInput): OverlayType | null;
+//# sourceMappingURL=resolveOverlayType.d.ts.map

package/dist/core/overlay/resolveOverlayType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveOverlayType.d.ts","sourceRoot":"","sources":["../../../src/core/overlay/resolveOverlayType.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAGzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAElD,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,OAAO,GAAG,SAAS,CAAA;IAC5B,gBAAgB,EAAE,WAAW,CAAC,WAAW,CAAC,CAAA;IAC1C,cAAc,EAAE,MAAM,CAAA;IACtB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,iBAAiB,EAAE,OAAO,CAAA;IAC1B,gDAAgD;IAChD,YAAY,EAAE,OAAO,CAAA;IACrB,+BAA+B;IAC/B,gBAAgB,EAAE,OAAO,CAAA;CAC1B;AAED,4EAA4E;AAC5E,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,CAErE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,GAAG,WAAW,GAAG,IAAI,CA8BrF"}

package/dist/core/overlay/standardOverlays.d.ts

@@ -0,0 +1,9 @@
+import { OverlayType } from '../types/emptyState';
+export declare function resolveStandardOverlayPanelClass(type: OverlayType): string;
+export interface CreateStandardOverlayContentOptions {
+    template?: string;
+    overlayText?: string;
+}
+/** 创建默认 overlay 内容 DOM（template 优先 · 否则内置文案/spinner） */
+export declare function createStandardOverlayContent(type: OverlayType, options?: CreateStandardOverlayContentOptions): HTMLElement;
+//# sourceMappingURL=standardOverlays.d.ts.map

package/dist/core/overlay/standardOverlays.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standardOverlays.d.ts","sourceRoot":"","sources":["../../../src/core/overlay/standardOverlays.ts"],"names":[],"mappings":"AACA,OAAO,EAOL,KAAK,WAAW,EACjB,MAAM,wBAAwB,CAAA;AAE/B,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAa1E;AAED,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,wDAAwD;AACxD,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,WAAW,EACjB,OAAO,GAAE,mCAAwC,GAChD,WAAW,CA+Bb"}

package/dist/core/pipeline/createComparator.d.ts

@@ -0,0 +1,7 @@
+import { ColumnComparatorFn } from '../types/columnSort';
+import { RowNode, SortDirection, SortModelItem } from '../types';
+export type RowValueGetter = (row: RowNode, colId: string) => unknown;
+/** 预解析排序比较器，循环内无闭包分配 */
+export declare function createRowNodeComparator(sortItem: SortModelItem, getCellValue: RowValueGetter, columnComparator?: ColumnComparatorFn): (a: RowNode, b: RowNode) => number;
+export declare function compareValues(a: unknown, b: unknown, direction: SortDirection): number;
+//# sourceMappingURL=createComparator.d.ts.map

package/dist/core/pipeline/createComparator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createComparator.d.ts","sourceRoot":"","sources":["../../../src/core/pipeline/createComparator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAChE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAE/D,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAA;AAErE,wBAAwB;AACxB,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,aAAa,EACvB,YAAY,EAAE,cAAc,EAC5B,gBAAgB,CAAC,EAAE,kBAAkB,GACpC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,KAAK,MAAM,CAwBpC;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,aAAa,GAAG,MAAM,CAgBtF"}

package/dist/core/pipeline/createFilterStageColumnContext.d.ts

@@ -0,0 +1,7 @@
+import { Column } from '../types';
+import { RowValueGetter } from './createComparator';
+import { FilterStageColumnContext } from './stages/filterStage';
+/** 从 ColumnModel + getCellValue 构建 FilterStage 列上下文 */
+export declare function createFilterStageColumnContext(getColumnById: (colId: string) => Column | undefined, getCellValue: RowValueGetter): FilterStageColumnContext;
+export declare const DEFAULT_FILTER_STAGE_COLUMN_CONTEXT: FilterStageColumnContext;
+//# sourceMappingURL=createFilterStageColumnContext.d.ts.map

package/dist/core/pipeline/createFilterStageColumnContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createFilterStageColumnContext.d.ts","sourceRoot":"","sources":["../../../src/core/pipeline/createFilterStageColumnContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAA;AAEpE,uDAAuD;AACvD,wBAAgB,8BAA8B,CAC5C,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,EACpD,YAAY,EAAE,cAAc,GAC3B,wBAAwB,CAa1B;AAED,eAAO,MAAM,mCAAmC,EAAE,wBAIjD,CAAA"}

package/dist/core/pipeline/deltaSort.d.ts

@@ -0,0 +1,6 @@
+import { RowNode } from '../types';
+/** touched 行数低于此阈值时回退全量排序 */
+export declare const MIN_DELTA_SORT_ROWS = 4;
+/** 增量排序：touched 行单独排序后与旧有序数组归并，O(t log t + n) */
+export declare function deltaSort(currentSorted: readonly RowNode[], touched: readonly RowNode[], compare: (a: RowNode, b: RowNode) => number, allRows?: readonly RowNode[]): RowNode[];
+//# sourceMappingURL=deltaSort.d.ts.map

package/dist/core/pipeline/deltaSort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deltaSort.d.ts","sourceRoot":"","sources":["../../../src/core/pipeline/deltaSort.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAE1C,6BAA6B;AAC7B,eAAO,MAAM,mBAAmB,IAAI,CAAA;AAEpC,iDAAiD;AACjD,wBAAgB,SAAS,CACvB,aAAa,EAAE,SAAS,OAAO,EAAE,EACjC,OAAO,EAAE,SAAS,OAAO,EAAE,EAC3B,OAAO,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,KAAK,MAAM,EAC3C,OAAO,CAAC,EAAE,SAAS,OAAO,EAAE,GAC3B,OAAO,EAAE,CAWX"}

package/dist/core/pipeline/filterCompare.d.ts

@@ -0,0 +1,8 @@
+import { ColumnFilter } from '../types';
+import { ColumnDataFilterType, ResolvedFilterParams } from '../types/columnFilter';
+/** blank：null · undefined · '' · 数字 NaN · 仅空白字符串 */
+export declare function isFilterValueBlank(value: unknown): boolean;
+/** 将单元格值规范为 ISO 日期文本（YYYY-MM-DD）；不可解析时返回 null */
+export declare function normalizeIsoDateFilterValue(value: unknown): string | null;
+export declare function matchesColumnFilter(value: unknown, condition: ColumnFilter, filterType: ColumnDataFilterType, params: ResolvedFilterParams): boolean;
+//# sourceMappingURL=filterCompare.d.ts.map

package/dist/core/pipeline/filterCompare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filterCompare.d.ts","sourceRoot":"","sources":["../../../src/core/pipeline/filterCompare.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,KAAK,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAA;AAe1F,oDAAoD;AACpD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAc1D;AAeD,iDAAiD;AACjD,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CA6BzE;AAuKD,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,YAAY,EACvB,UAAU,EAAE,oBAAoB,EAChC,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAkBT"}

package/dist/core/pipeline/getCellRawValue.d.ts

@@ -0,0 +1,4 @@
+import { Column, RowNode } from '../types';
+/** 读取单元格原始值（排序 / 过滤用，不含 formatter） */
+export declare function getCellRawValue(row: RowNode, column: Column): unknown;
+//# sourceMappingURL=getCellRawValue.d.ts.map

package/dist/core/pipeline/getCellRawValue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getCellRawValue.d.ts","sourceRoot":"","sources":["../../../src/core/pipeline/getCellRawValue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAE1C,sCAAsC;AACtC,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CASrE"}

package/dist/core/pipeline/groupTreePipeline.d.ts

@@ -0,0 +1,18 @@
+import { RowNode } from '../types';
+/** 根数组是否含 group 树节点（group 阶段产物） */
+export declare function hasGroupedRows(rows: readonly RowNode[]): boolean;
+/** filter 阶段输入：group 阶段 childrenAfterGroup */
+export declare function getGroupStageChildren(node: RowNode): readonly RowNode[];
+/** sort 阶段输入：filter 阶段 childrenAfterFilter（缺省回退 group） */
+export declare function getFilterStageChildren(node: RowNode): readonly RowNode[];
+/** aggregate / map 阶段输入：sort 阶段 childrenAfterSort（缺省回退 filter → group） */
+export declare function getSortStageChildren(node: RowNode): readonly RowNode[];
+/** 读取 group 节点当前最 processed 的子节点列表 */
+export declare function getGroupedNodeChildren(node: RowNode): readonly RowNode[];
+/** DFS 收集子树 leaf（aggregate / 测试用） */
+export declare function collectGroupedTreeLeaves(nodes: readonly RowNode[]): RowNode[];
+/** 无 filter 条件时，将 childrenAfterGroup 复制到 childrenAfterFilter */
+export declare function propagateGroupedFilterPassThrough(nodes: readonly RowNode[]): RowNode[];
+/** sort 阶段后同步 groupLeafCount */
+export declare function syncGroupedLeafCounts(nodes: readonly RowNode[]): void;
+//# sourceMappingURL=groupTreePipeline.d.ts.map

package/dist/core/pipeline/groupTreePipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"groupTreePipeline.d.ts","sourceRoot":"","sources":["../../../src/core/pipeline/groupTreePipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAG1C,mCAAmC;AACnC,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,CAEhE;AAED,8CAA8C;AAC9C,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,OAAO,EAAE,CAEvE;AAED,0DAA0D;AAC1D,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,OAAO,EAAE,CAExE;AAED,0EAA0E;AAC1E,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,OAAO,EAAE,CAEtE;AAED,sCAAsC;AACtC,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,OAAO,EAAE,CAExE;AAED,qCAAqC;AACrC,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,EAAE,CAa7E;AAED,gEAAgE;AAChE,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,EAAE,CAYtF;AAED,gCAAgC;AAChC,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI,CAUrE"}

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

@@ -0,0 +1,23 @@
+export { getCellRawValue } from './getCellRawValue';
+export { compareValues, createRowNodeComparator } from './createComparator';
+export type { RowValueGetter } from './createComparator';
+export { deltaSort, MIN_DELTA_SORT_ROWS } from './deltaSort';
+export { runRefreshModel, RefreshModelScheduler, resolveDefaultPipelineStages, resolveDefaultPipelineStagesForMode } from './refreshModel';
+export type { GroupingRefreshParams, RefreshModelParams, TreeRefreshParams } from './refreshModel';
+export { executeTreeBuildStage } from './stages/treeBuildStage';
+export type { TreeBuildStageParams } from './stages/treeBuildStage';
+export { collectTreeDataNodes, getTreeFilterInputChildren, getTreeSortStageChildren, getTreeStageChildren, hasTreeRows, propagateTreeFilterPassThrough, } from './treeTreePipeline';
+export { executeSortStage } from './stages/sortStage';
+export { createFilterStageColumnContext } from './createFilterStageColumnContext';
+export { isQuickFilterActive, normalizeQuickFilterText, rowMatchesQuickFilter } from '../filter/quickFilter';
+export { matchesColumnFilter, isFilterValueBlank, normalizeIsoDateFilterValue } from './filterCompare';
+export { executeFilterStage } from './stages/filterStage';
+export type { FilterStageColumnContext, FilterStageParams } from './stages/filterStage';
+export { collectGroupTreeLeaves, collectGroupTreeNodes, compareGroupKeys, countGroupTreeLeaves, executeGroupStage, resolveGroupSiblingCompare, } from './stages/groupStage';
+export type { GroupSiblingCompareMeta, GroupStageParams } from './stages/groupStage';
+export { executeAggregateStage } from './stages/aggregateStage';
+export type { AggregateStageParams } from './stages/aggregateStage';
+export { executeMapStage } from './stages/mapStage';
+export type { MapStageOptions, MapStageParams } from './stages/mapStage';
+export { collectGroupedTreeLeaves, getFilterStageChildren, getGroupStageChildren, getGroupedNodeChildren, getSortStageChildren, hasGroupedRows, propagateGroupedFilterPassThrough, syncGroupedLeafCounts, } from './groupTreePipeline';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/pipeline/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAA;AAC3E,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAC5D,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,4BAA4B,EAAE,mCAAmC,EAAE,MAAM,gBAAgB,CAAA;AAC1I,YAAY,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAClG,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AAC/D,YAAY,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AACnE,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,wBAAwB,EACxB,oBAAoB,EACpB,WAAW,EACX,8BAA8B,GAC/B,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAA;AACjF,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAC5G,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAA;AACtG,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AACzD,YAAY,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AACvF,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,0BAA0B,GAC3B,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACpF,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AAC/D,YAAY,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACxE,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,cAAc,EACd,iCAAiC,EACjC,qBAAqB,GACtB,MAAM,qBAAqB,CAAA"}