ag-grid-community 32.0.2 → 32.2.0

package/dist/types/core/headerRendering/cells/columnGroup/headerGroupCellCtrl.d.ts

@@ -1,5 +1,6 @@
 import type { UserCompDetails } from '../../../components/framework/userComponentFactory';
 import { HorizontalDirection } from '../../../constants/direction';
+import type { BeanStub } from '../../../context/beanStub';
 import type { BeanCollection } from '../../../context/context';
 import type { DragItem } from '../../../dragAndDrop/dragAndDropService';
 import type { AgColumnGroup } from '../../../entities/agColumnGroup';
@@ -22,7 +23,10 @@ export declare class HeaderGroupCellCtrl extends AbstractHeaderCellCtrl<IHeaderG
     private displayName;
     private tooltipFeature;
     constructor(columnGroup: AgColumnGroup, beans: BeanCollection, parentRowCtrl: HeaderRowCtrl);
-    setComp(comp: IHeaderGroupCellComp, eGui: HTMLElement, eResize: HTMLElement): void;
+    setComp(comp: IHeaderGroupCellComp, eGui: HTMLElement, eResize: HTMLElement, eHeaderCompWrapper: HTMLElement, compBean: BeanStub<any> | undefined): void;
+    private addHighlightListeners;
+    private onLeafColumnHighlightChanged;
+    getColumn(): AgColumnGroup;
     protected resizeHeader(delta: number, shiftKey: boolean): void;
     protected moveHeader(hDirection: HorizontalDirection): void;
     private restoreFocus;
@@ -43,4 +47,5 @@ export declare class HeaderGroupCellCtrl extends AbstractHeaderCellCtrl<IHeaderG
     setDragSource(eHeaderGroup: HTMLElement): void;
     getDragItemForGroup(columnGroup: AgColumnGroup): DragItem;
     private isSuppressMoving;
+    destroy(): void;
 }

package/dist/types/core/headerRendering/cells/floatingFilter/headerFilterCellCtrl.d.ts

@@ -1,3 +1,4 @@
+import type { BeanStub } from '../../../context/beanStub';
 import type { BeanCollection } from '../../../context/context';
 import type { AgColumn } from '../../../entities/agColumn';
 import type { HeaderRowCtrl } from '../../row/headerRowCtrl';
@@ -14,7 +15,7 @@ export declare class HeaderFilterCellCtrl extends AbstractHeaderCellCtrl<IHeader
     private destroySyncListener;
     private destroyFilterChangedListener;
     constructor(column: AgColumn, beans: BeanCollection, parentRowCtrl: HeaderRowCtrl);
-    setComp(comp: IHeaderFilterCellComp, eGui: HTMLElement, eButtonShowMainFilter: HTMLElement, eFloatingFilterBody: HTMLElement): void;
+    setComp(comp: IHeaderFilterCellComp, eGui: HTMLElement, eButtonShowMainFilter: HTMLElement, eFloatingFilterBody: HTMLElement, compBean: BeanStub | undefined): void;
     protected resizeHeader(): void;
     protected moveHeader(): void;
     private setupActive;

package/dist/types/core/headerRendering/columnDrag/bodyDropPivotTarget.d.ts

@@ -21,4 +21,5 @@ export declare class BodyDropPivotTarget extends BeanStub implements DropListene
     onDragging(draggingEvent: DraggingEvent): void;
     /** Callback for when drag stops */
     onDragStop(draggingEvent: DraggingEvent): void;
+    onDragCancel(): void;
 }

package/dist/types/core/headerRendering/columnDrag/bodyDropTarget.d.ts

@@ -9,6 +9,7 @@ export interface DropListener {
     onDragLeave(params: DraggingEvent): void;
     onDragging(params: DraggingEvent): void;
     onDragStop(params: DraggingEvent): void;
+    onDragCancel(): void;
 }
 export declare class BodyDropTarget extends BeanStub implements DropTarget {
     private dragAndDropService;
@@ -32,4 +33,5 @@ export declare class BodyDropTarget extends BeanStub implements DropTarget {
     onDragLeave(params: DraggingEvent): void;
     onDragging(params: DraggingEvent): void;
     onDragStop(params: DraggingEvent): void;
+    onDragCancel(): void;
 }

package/dist/types/core/headerRendering/columnDrag/moveColumnFeature.d.ts

@@ -20,20 +20,37 @@ export declare class MoveColumnFeature extends BeanStub implements DropListener
     private pinned;
     private isCenterContainer;
     private lastDraggingEvent;
+    private lastHighlightedColumn;
     private lastMovedInfo;
     private failedMoveAttempts;
     constructor(pinned: ColumnPinnedType);
     postConstruct(): void;
     getIconName(): DragAndDropIcon;
     onDragEnter(draggingEvent: DraggingEvent): void;
+    onDragging(draggingEvent?: DraggingEvent | null, fromEnter?: boolean, fakeEvent?: boolean, finished?: boolean): void;
     onDragLeave(): void;
-    setColumnsVisible(columns: AgColumn[] | null | undefined, visible: boolean, source: ColumnEventType): void;
-    setColumnsPinned(columns: AgColumn[] | null | undefined, pinned: ColumnPinnedType, source: ColumnEventType): void;
     onDragStop(): void;
-    private checkCenterForScrolling;
-    onDragging(draggingEvent?: DraggingEvent, fromEnter?: boolean, fakeEvent?: boolean, finished?: boolean): void;
+    onDragCancel(): void;
+    setColumnsVisible(columns: AgColumn[] | null | undefined, visible: boolean, source: ColumnEventType): void;
+    private finishColumnMoving;
+    private handleColumnDragWhileSuppressingMovement;
+    private handleColumnDragWhileAllowingMovement;
+    private getAllMovingColumns;
+    private getMoveColumnParams;
+    private findFirstAndLastMovingColumns;
+    private highlightHoveredColumn;
+    private getNormalisedXPositionInfo;
+    private getColumnMoveAndTargetInfo;
     private normaliseDirection;
+    private getNormalisedColumnLeft;
+    private isAttemptingToPin;
+    private moveColumnsAfterHighlight;
+    private clearHighlighted;
+    private checkCenterForScrolling;
     private ensureIntervalStarted;
     private ensureIntervalCleared;
     private moveInterval;
+    private getPinDirection;
+    private attemptToPinColumns;
+    destroy(): void;
 }

package/dist/types/core/headerRendering/columnMoveHelper.d.ts

@@ -1,16 +1,14 @@
 import type { ColumnModel } from '../columns/columnModel';
 import type { ColumnMoveService } from '../columns/columnMoveService';
 import type { VisibleColsService } from '../columns/visibleColsService';
-import { HorizontalDirection } from '../constants/direction';
 import type { CtrlsService } from '../ctrlsService';
 import type { AgColumn } from '../entities/agColumn';
-import type { ColumnEventType } from '../events';
 import type { GridOptionsService } from '../gridOptionsService';
 import type { ColumnPinnedType } from '../interfaces/iColumn';
-export declare function attemptMoveColumns(params: {
+export interface ColumnMoveParams {
     allMovingColumns: AgColumn[];
     isFromHeader: boolean;
-    hDirection?: HorizontalDirection;
+    fromLeft: boolean;
     xPosition: number;
     fromEnter: boolean;
     fakeEvent: boolean;
@@ -18,13 +16,25 @@ export declare function attemptMoveColumns(params: {
     gos: GridOptionsService;
     columnModel: ColumnModel;
     columnMoveService: ColumnMoveService;
-    presentedColsService: VisibleColsService;
-}): {
+    visibleColsService: VisibleColsService;
+}
+export declare function getBestColumnMoveIndexFromXPosition(params: ColumnMoveParams): {
     columns: AgColumn[];
     toIndex: number;
-} | null | undefined;
-export declare function moveColumns(columns: AgColumn[], toIndex: number, source: ColumnEventType, finished: boolean, columnMoveService: ColumnMoveService): {
+} | undefined;
+export declare function attemptMoveColumns(params: ColumnMoveParams & {
+    finished: boolean;
+}): {
     columns: AgColumn[];
     toIndex: number;
-} | null;
-export declare function normaliseX(x: number, pinned: ColumnPinnedType, fromKeyboard: boolean, gos: GridOptionsService, ctrlsService: CtrlsService): number;
+} | null | undefined;
+export declare function normaliseX(params: {
+    x: number;
+    pinned?: ColumnPinnedType;
+    fromKeyboard?: boolean;
+    useHeaderRow?: boolean;
+    skipScrollPadding?: boolean;
+    gos: GridOptionsService;
+    ctrlsService: CtrlsService;
+}): number;
+export declare function setColumnsMoving(columns: AgColumn[], isMoving: boolean): void;

package/dist/types/core/headerRendering/gridHeaderCtrl.d.ts

@@ -5,6 +5,7 @@ export interface IGridHeaderComp {
     setHeightAndMinHeight(height: string): void;
 }
 export declare class GridHeaderCtrl extends BeanStub {
+    private animationFrameService;
     private headerNavigationService;
     private focusService;
     private columnModel;

package/dist/types/core/headerRendering/row/headerRowCtrl.d.ts

@@ -5,8 +5,6 @@ import type { AgColumnGroup } from '../../entities/agColumnGroup';
 import type { BrandedType } from '../../interfaces/brandedType';
 import type { ColumnPinnedType } from '../../interfaces/iColumn';
 import type { AbstractHeaderCellCtrl } from '../cells/abstractCell/abstractHeaderCellCtrl';
-import { HeaderCellCtrl } from '../cells/column/headerCellCtrl';
-import { HeaderGroupCellCtrl } from '../cells/columnGroup/headerGroupCellCtrl';
 import { HeaderRowType } from './headerRowComp';
 export interface IHeaderRowComp {
     setTop(top: string): void;
@@ -18,18 +16,17 @@ export type HeaderRowCtrlInstanceId = BrandedType<number, 'HeaderRowCtrlInstance
 export declare class HeaderRowCtrl extends BeanStub {
     private beans;
     wireBeans(beans: BeanCollection): void;
+    readonly instanceId: HeaderRowCtrlInstanceId;
     private comp;
     private rowIndex;
     private pinned;
     private type;
     private headerRowClass;
-    private instanceId;
     private headerCellCtrls;
     private isPrintLayout;
     private isEnsureDomOrder;
     constructor(rowIndex: number, pinned: ColumnPinnedType, type: HeaderRowType);
     postConstruct(): void;
-    getInstanceId(): HeaderRowCtrlInstanceId;
     /** Checks that every header cell that is currently visible has been rendered.
      * Can only be false under some circumstances when using React
      */
@@ -39,12 +36,11 @@ export declare class HeaderRowCtrl extends BeanStub {
      * @param comp Proxy to the actual component
      * @param initCompState Should the component be initialised with the current state of the controller. Default: true
      */
-    setComp(comp: IHeaderRowComp, initCompState?: boolean): void;
+    setComp(comp: IHeaderRowComp, compBean: BeanStub | undefined, initCompState?: boolean): void;
     getHeaderRowClass(): string;
     getAriaRowIndex(): number;
     private addEventListeners;
-    getHeaderCellCtrl(column: AgColumnGroup): HeaderGroupCellCtrl | undefined;
-    getHeaderCellCtrl(column: AgColumn): HeaderCellCtrl | undefined;
+    getHeaderCellCtrl(column: AgColumn | AgColumnGroup): any;
     private onDisplayedColumnsChanged;
     getType(): HeaderRowType;
     private onColumnResized;
@@ -65,7 +61,7 @@ export declare class HeaderRowCtrl extends BeanStub {
     private getColumnsInViewportPrintLayout;
     private getActualDepth;
     private getColumnsInViewportNormalLayout;
-    findHeaderCellCtrl(column: AgColumn | AgColumnGroup): AbstractHeaderCellCtrl | undefined;
+    findHeaderCellCtrl(column: AgColumn | AgColumnGroup | ((cellCtrl: AbstractHeaderCellCtrl) => boolean)): AbstractHeaderCellCtrl | undefined;
     focusHeader(column: AgColumn | AgColumnGroup, event?: KeyboardEvent): boolean;
     destroy(): void;
 }

package/dist/types/core/headerRendering/rowContainer/headerRowContainerCtrl.d.ts

@@ -2,9 +2,8 @@ import { BeanStub } from '../../context/beanStub';
 import type { BeanCollection } from '../../context/context';
 import type { AgColumn } from '../../entities/agColumn';
 import type { AgColumnGroup } from '../../entities/agColumnGroup';
+import type { ScrollPartner } from '../../gridBodyComp/gridBodyScrollFeature';
 import type { ColumnPinnedType } from '../../interfaces/iColumn';
-import type { HeaderCellCtrl } from '../cells/column/headerCellCtrl';
-import type { HeaderGroupCellCtrl } from '../cells/columnGroup/headerGroupCellCtrl';
 import { HeaderRowType } from '../row/headerRowComp';
 import { HeaderRowCtrl } from '../row/headerRowCtrl';
 export interface IHeaderRowContainerComp {
@@ -14,7 +13,7 @@ export interface IHeaderRowContainerComp {
     setDisplayed(displayed: boolean): void;
     setCtrls(ctrls: HeaderRowCtrl[]): void;
 }
-export declare class HeaderRowContainerCtrl extends BeanStub {
+export declare class HeaderRowContainerCtrl extends BeanStub implements ScrollPartner {
     private ctrlsService;
     private scrollVisibleService;
     private pinnedWidthService;
@@ -34,15 +33,16 @@ export declare class HeaderRowContainerCtrl extends BeanStub {
     setComp(comp: IHeaderRowContainerComp, eGui: HTMLElement): void;
     getAllCtrls(): HeaderRowCtrl[];
     refresh(keepColumns?: boolean): void;
-    getHeaderCtrlForColumn(column: AgColumn): HeaderCellCtrl | undefined;
-    getHeaderCtrlForColumn(column: AgColumnGroup): HeaderGroupCellCtrl | undefined;
-    getHtmlElementForColumnHeader(column: AgColumnGroup): HTMLElement | null;
-    getHtmlElementForColumnHeader(column: AgColumn): HTMLElement | null;
+    getHeaderCtrlForColumn(column: AgColumn | AgColumnGroup): any;
+    getHtmlElementForColumnHeader(column: AgColumn | AgColumnGroup): HTMLElement | null;
     getRowType(rowIndex: number): HeaderRowType | undefined;
     focusHeader(rowIndex: number, column: AgColumn | AgColumnGroup, event?: KeyboardEvent): boolean;
-    getViewport(): HTMLElement;
+    getViewportElement(): HTMLElement;
+    getGroupRowCount(): number;
+    getGroupRowCtrlAtIndex(index: number): HeaderRowCtrl;
     getRowCount(): number;
     setHorizontalScroll(offset: number): void;
+    onScrollCallback(fn: () => void): void;
     destroy(): void;
     private setupDragAndDrop;
     private restoreFocusOnHeader;

package/dist/types/core/interfaces/IRangeService.d.ts

@@ -48,6 +48,7 @@ export declare enum CellRangeType {
     VALUE = 0,
     DIMENSION = 1
 }
+/** Describes a single range of cells */
 export interface CellRange {
     id?: string;
     type?: CellRangeType;
@@ -81,8 +82,8 @@ export interface ClearCellRangeParams {
     cellRanges?: CellRange[];
     /** Source passed to `cellValueChanged` event */
     cellEventSource?: string;
-    /** `true` to dispatch `rangeDeleteStart` and `rangeDeleteEnd` events */
+    /** `true` to dispatch `cellSelectionDeleteStart` and `cellSelectionDeleteEnd` events */
     dispatchWrapperEvents?: boolean;
-    /** Source passed to `rangeDeleteStart` and `rangeDeleteEnd` events */
+    /** Source passed to `cellSelectionDeleteStart` and `cellSelectionDeleteEnd` events */
     wrapperEventSource?: 'deleteKey';
 }

package/dist/types/core/interfaces/IServerSideStore.d.ts

@@ -9,7 +9,7 @@ export interface IServerSideStore extends Bean {
     isDisplayIndexInStore(displayIndex: number): boolean;
     setDisplayIndexes(displayIndexSeq: NumberSequence, nextRowTop: {
         value: number;
-    }): void;
+    }, uiLevel: number): void;
     forEachStoreDeep(callback: (rowNode: IServerSideStore, index: number) => void, sequence?: NumberSequence): void;
     forEachNodeDeep(callback: (rowNode: IRowNode, index: number) => void, sequence?: NumberSequence): void;
     forEachNodeDeepAfterFilterAndSort(callback: (rowNode: IRowNode, index: number) => void, sequence?: NumberSequence, includeFooterNodes?: boolean): void;

package/dist/types/core/interfaces/gridState.d.ts

@@ -8,7 +8,7 @@ export interface FilterState {
     filterModel?: FilterModel;
     advancedFilterModel?: AdvancedFilterModel;
 }
-export interface RangeSelectionCellState {
+export interface CellSelectionCellState {
     id?: string;
     type?: CellRangeType;
     /** The start row of the range */
@@ -20,6 +20,13 @@ export interface RangeSelectionCellState {
     /** The start column for the range */
     startColId: string;
 }
+/** @deprecated v32.2 Use `CellSelectionCellState` instead. */
+export interface RangeSelectionCellState extends CellSelectionCellState {
+}
+export interface CellSelectionState {
+    cellRanges: CellSelectionCellState[];
+}
+/** @deprecated v32.2 Use `CellSelectionState` instead. */
 export interface RangeSelectionState {
     cellRanges: RangeSelectionCellState[];
 }
@@ -100,17 +107,19 @@ export interface RowGroupExpansionState {
     expandedRowGroupIds: string[];
 }
 export interface GridState {
-    /** Includes aggregation functions */
+    /** Grid version number */
+    version?: string;
+    /** Includes aggregation functions (column state) */
     aggregation?: AggregationState;
     /** Includes opened groups */
     columnGroup?: ColumnGroupState;
-    /** Includes column ordering */
+    /** Includes column ordering (column state) */
     columnOrder?: ColumnOrderState;
-    /** Includes left/right pinned columns */
+    /** Includes left/right pinned columns (column state) */
     columnPinning?: ColumnPinningState;
-    /** Includes column width/flex */
+    /** Includes column width/flex (column state) */
     columnSizing?: ColumnSizingState;
-    /** Includes hidden columns */
+    /** Includes hidden columns (column state) */
     columnVisibility?: ColumnVisibilityState;
     /** Includes Column Filters and Advanced Filter */
     filter?: FilterState;
@@ -118,11 +127,16 @@ export interface GridState {
     focusedCell?: FocusedCellState;
     /** Includes current page */
     pagination?: PaginationState;
-    /** Includes current pivot mode and pivot columns */
+    /** Includes current pivot mode and pivot columns (column state) */
     pivot?: PivotState;
     /** Includes currently selected cell ranges */
+    cellSelection?: CellSelectionState;
+    /**
+     * Includes currently selected cell ranges
+     * @deprecated v32.2 Use `cellSelection` instead.
+     */
     rangeSelection?: RangeSelectionState;
-    /** Includes current row group columns */
+    /** Includes current row group columns (column state) */
     rowGroup?: RowGroupState;
     /** Includes currently expanded group rows */
     rowGroupExpansion?: RowGroupExpansionState;
@@ -136,6 +150,11 @@ export interface GridState {
     scroll?: ScrollState;
     /** Includes current Side Bar positioning and opened tool panel */
     sideBar?: SideBarState;
-    /** Includes current sort columns and direction */
+    /** Includes current sort columns and direction (column state) */
     sort?: SortState;
+    /**
+     * When providing a partial `initialState` with some but not all column state properties, set this to `true`.
+     * Not required if passing the whole state object retrieved from the grid.
+     */
+    partialColumnState?: boolean;
 }

package/dist/types/core/interfaces/iAdvancedFilterCtrl.d.ts

@@ -2,5 +2,9 @@ export interface IAdvancedFilterCtrl {
     setupHeaderComp(eCompToInsertBefore: HTMLElement): void;
     focusHeaderComp(): boolean;
     getHeaderHeight(): number;
-    toggleFilterBuilder(source: 'api' | 'ui', force?: boolean): void;
+    toggleFilterBuilder(params: {
+        source: 'api' | 'ui';
+        force?: boolean;
+        eventSource?: HTMLElement;
+    }): void;
 }

package/dist/types/core/interfaces/iCallbackParams.d.ts

@@ -36,8 +36,11 @@ export interface PostProcessPopupParams<TData = any, TContext = any> extends AgG
     rowNode?: IRowNode<TData> | null;
     /** The popup we are showing */
     ePopup: HTMLElement;
-    /** The different types are:
-     *  'contextMenu', 'columnMenu', 'aggFuncSelect', 'popupCellEditor' */
+    /**
+     * The different types are:
+     * 'contextMenu', 'columnMenu', 'aggFuncSelect', 'popupCellEditor', 'chart',
+     * 'advancedFilterBuilder', 'colorPicker', 'columnChooser', 'subMenu'
+     */
     type: string;
     /** If the popup is as a result of a button click (eg menu button),
      *  this is the component that the user clicked */

package/dist/types/core/interfaces/iCellEditor.d.ts

@@ -88,3 +88,7 @@ export interface ICellEditorParams<TData = any, TValue = any, TContext = any> ex
 }
 export interface ICellEditorComp<TData = any, TValue = any, TContext = any> extends ICellEditor<TValue>, IPopupComponent<ICellEditorParams<TData, TValue, TContext>> {
 }
+/** This is only used internally within the grid */
+export interface DefaultProvidedCellEditorParams {
+    suppressPreventDefault?: boolean;
+}

package/dist/types/core/interfaces/iClientSideRowModel.d.ts

@@ -17,9 +17,7 @@ export declare enum ClientSideRowModelSteps {
 }
 export interface IClientSideRowModel<TData = any> extends IRowModel {
     onRowGroupOpened(): void;
-    updateRowData(rowDataTran: RowDataTransaction<TData>, rowNodeOrder?: {
-        [id: string]: number;
-    } | null): RowNodeTransaction<TData> | null;
+    updateRowData(rowDataTran: RowDataTransaction<TData>): RowNodeTransaction<TData> | null;
     setRowData(rowData: any[]): void;
     refreshModel(paramsOrStep: RefreshModelParams | ClientSideRowModelStep | undefined): void;
     expandOrCollapseAll(expand: boolean): void;
@@ -47,9 +45,7 @@ export interface RefreshModelParams<TData = any> {
     animate?: boolean;
     keepEditingRows?: boolean;
     rowNodeTransactions?: RowNodeTransaction<TData>[];
-    rowNodeOrder?: {
-        [id: string]: number;
-    };
+    rowNodesOrderChanged?: boolean;
     newData?: boolean;
     afterColumnsChanged?: boolean;
     keepUndoRedoStack?: boolean;

package/dist/types/core/interfaces/iColumn.d.ts

@@ -47,8 +47,12 @@ interface IProvidedColumn {
     getId(): string;
 }
 export type ColumnPinnedType = 'left' | 'right' | boolean | null | undefined;
-export type ColumnEventName = 'movingChanged' | 'leftChanged' | 'widthChanged' | 'lastLeftPinnedChanged' | 'firstRightPinnedChanged' | 'visibleChanged' | 'filterChanged' | 'filterActiveChanged' | 'sortChanged' | 'colDefChanged' | 'menuVisibleChanged' | 'columnRowGroupChanged' | 'columnPivotChanged' | 'columnValueChanged' | 'columnStateUpdated';
+export type ColumnEventName = 'movingChanged' | 'leftChanged' | 'widthChanged' | 'lastLeftPinnedChanged' | 'firstRightPinnedChanged' | 'visibleChanged' | 'filterChanged' | 'filterActiveChanged' | 'headerHighlightChanged' | 'sortChanged' | 'colDefChanged' | 'menuVisibleChanged' | 'columnRowGroupChanged' | 'columnPivotChanged' | 'columnValueChanged' | 'columnStateUpdated';
 export type ColumnInstanceId = BrandedType<number, 'ColumnInstanceId'>;
+export declare enum ColumnHighlightPosition {
+    Before = 0,
+    After = 1
+}
 export interface Column<TValue = any> extends IHeaderColumn<TValue, ColumnEventName>, IProvidedColumn, IEventEmitter<ColumnEventName> {
     /**
      * Returns the column definition provided by the application.

package/dist/types/core/interfaces/iExcelCreator.d.ts

@@ -1,6 +1,7 @@
 import type { Column } from '../interfaces/iColumn';
 import type { ExportFileNameGetter, ExportParams } from './exportParams';
 import type { AgGridCommon } from './iCommon';
+import type { IRowNode } from './iRowNode';
 import type { XmlElement } from './iXmlFactory';
 export interface ExcelStyle {
     /** The id of the Excel Style, this should match a CSS cell class. */
@@ -327,6 +328,15 @@ export declare enum ExcelFactoryMode {
 export interface ExcelSheetNameGetterParams<TData = any, TContext = any> extends AgGridCommon<TData, TContext> {
 }
 export type ExcelSheetNameGetter = (params?: ExcelSheetNameGetterParams) => string;
+export interface ExcelFreezeRowsGetterParams<TData = any, TContext = any> extends AgGridCommon<TData, TContext> {
+    /** Row node. */
+    node?: IRowNode<TData>;
+}
+export interface ExcelFreezeColumnsGetterParams<TData = any, TContext = any> extends AgGridCommon<TData, TContext> {
+    column: Column;
+}
+export type ExcelFreezeRowsGetter = (params: ExcelFreezeRowsGetterParams) => boolean;
+export type ExcelFreezeColumnsGetter = (params: ExcelFreezeColumnsGetterParams) => boolean;
 export interface ColumnWidthCallbackParams {
     column: Column | null;
     index: number;
@@ -334,12 +344,7 @@ export interface ColumnWidthCallbackParams {
 export interface RowHeightCallbackParams {
     rowIndex: number;
 }
-export interface ExcelExportParams extends ExportParams<ExcelRow[]> {
-    /**
-     * The author of the exported file.
-     * @default "AG Grid"
-     * */
-    author?: string;
+export interface ExcelWorksheetConfigParams {
     /**
      * If set to `true`, this will try to convert any cell that starts with `=` to a formula, instead of setting the cell value as regular string that starts with `=`.
      * @default false
@@ -349,11 +354,6 @@ export interface ExcelExportParams extends ExportParams<ExcelRow[]> {
      * Defines the default column width. If no value is present, each column will have value currently set in the application with a min value of 75px. This property can also be supplied a callback function that returns a number.
      */
     columnWidth?: number | ((params: ColumnWidthCallbackParams) => number);
-    /**
-     * The default value for the font size of the Excel document.
-     * @default 11
-     */
-    fontSize?: number;
     /**
      * The height in pixels of header rows. Defaults to Excel default value. This property can also be supplied a callback function that returns a number.
      */
@@ -369,9 +369,17 @@ export interface ExcelExportParams extends ExportParams<ExcelRow[]> {
      * @default 'ag-grid'
      */
     sheetName?: string | ExcelSheetNameGetter;
-    /** The Excel document page margins. Relevant for printing. */
+    /**
+     * The configuration for header and footers.
+     */
+    headerFooterConfig?: ExcelHeaderFooterConfig;
+    /**
+     * The Excel document page margins. Relevant for printing.
+     */
     margins?: ExcelSheetMargin;
-    /** Allows you to setup the page orientation and size. */
+    /**
+     * Allows you to setup the page orientation and size.
+     */
     pageSetup?: ExcelSheetPageSetup;
     /**
      * Used to add an Excel table to the spreadsheet.
@@ -380,8 +388,14 @@ export interface ExcelExportParams extends ExportParams<ExcelRow[]> {
      * @default false
      **/
     exportAsExcelTable?: boolean | ExcelTableConfig;
-    /** The configuration for header and footers. */
-    headerFooterConfig?: ExcelHeaderFooterConfig;
+    /**
+     * The expand/collapse state of each row group in the Excel Document.
+     *  - expanded: All row groups will be expanded by default.
+     *  - collapsed: All row groups will be collapsed by default.
+     *  - match: The row groups will match their current state in the Grid.
+     * @default 'expanded'
+     */
+    rowGroupExpandState?: 'expanded' | 'collapsed' | 'match';
     /**
      * If `true`, the outline (controls to expand and collapse) for Row Groups will not be added automatically to the Excel Document.
      * @default false.
@@ -393,40 +407,45 @@ export interface ExcelExportParams extends ExportParams<ExcelRow[]> {
      */
     suppressColumnOutline?: boolean;
     /**
-     * The expand/collapse state of each row group in the Excel Document.
-     *  - expanded: All row groups will be expanded by default.
-     *  - collapsed: All row groups will be collapsed by default.
-     *  - match: The row groups will match their current state in the Grid.
-     * @default 'expanded'
+     * Use this property to select to freeze rows at the top of the exported sheet.
+     * - `headers`  - Freeze all grid headers at the top.
+     * - `headersAndPinnedRows` - Freeze all headers and pinned top rows.
+     * - A callback function that will freeze rows until a value other than `true` is returned, after that, this callback will no longer be executed. Note that using a callback will automatically freeze all header rows.
      */
-    rowGroupExpandState?: 'expanded' | 'collapsed' | 'match';
+    freezeRows?: 'headers' | 'headersAndPinnedRows' | ExcelFreezeRowsGetter;
     /**
-     * The mimeType of the Excel file.
-     * @default 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'
+     * Use this property to select to freeze columns at the start of the grid (this will be the columns at the right for RTL).
+     * - `pinned`  - Freeze all pinned left (right for RTL grids) columns.
+     * - A callback function that will freeze columns until a value other than `true` is returned. After that, this callback will no longer be executed.
+     */
+    freezeColumns?: 'pinned' | ExcelFreezeColumnsGetter;
+    /**
+     * Use to set the direction for the worksheet.
+     * - `true`: Sets the direction to right-to-left (RTL).
+     * - `false`:  Sets the direction to left-to-right (LTR).
+     * - `undefined`: Exports the worksheet according to the current direction of the grid as set by `gridOptions.enableRtl`.
+     * @default undefined
+     */
+    rightToLeft?: boolean;
+    /**
+     * Use to export an image for the gridCell in question.
      */
-    mimeType?: string;
-    /** Use to export an image for the gridCell in question. */
     addImageToCell?: (rowIndex: number, column: Column, value: string) => {
         image: ExcelImage;
         value?: string;
     } | undefined;
 }
-export interface ExcelExportMultipleSheetParams {
-    /**
-     * The author of the exported file.
-     * @default 'AG Grid'
-     */
-    author?: string;
-    /**
-     * Array of strings containing the raw data for Excel workbook sheets.
-     * This property is only used when exporting to multiple sheets using `api.exportMultipleSheetsAsExcel()` and the data for each sheet is obtained by calling `api.getSheetDataForExcel()`.
-     */
-    data: string[];
+interface ExcelFileParams {
     /**
      * String to use as the file name or a function that returns a string.
      * @default 'export.xlsx'
      */
     fileName?: string | ExportFileNameGetter;
+    /**
+     * The author of the exported file.
+     * @default "AG Grid"
+     * */
+    author?: string;
     /**
      * The default value for the font size of the Excel document.
      * @default 11
@@ -438,6 +457,20 @@ export interface ExcelExportMultipleSheetParams {
      */
     mimeType?: string;
 }
+export interface ExcelExportParams extends ExcelFileParams, ExcelWorksheetConfigParams, ExportParams<ExcelRow[]> {
+}
+export interface ExcelExportMultipleSheetParams extends ExcelFileParams {
+    /**
+     * Array of strings containing the raw data for Excel workbook sheets.
+     * This property is only used when exporting to multiple sheets using `api.exportMultipleSheetsAsExcel()` and the data for each sheet is obtained by calling `api.getSheetDataForExcel()`.
+     */
+    data: string[];
+    /**
+     * The index of the sheet to be marked as active by default.
+     * @default 0
+     */
+    activeSheetIndex?: number;
+}
 export interface ExcelHeaderFooterConfig {
     /** The configuration for header and footer on every page. */
     all?: ExcelHeaderFooter;

package/dist/types/core/interfaces/iFrameworkOverrides.d.ts

@@ -37,10 +37,12 @@ export interface IFrameworkOverrides {
      * @param path Optional path to append to the base url. i.e 'aligned-grids' Does not need the leading `/`
      */
     getDocLink(path?: string): string;
-    /** Used by `RowRenderer` when getting lock. Allows React 17- async refreshes to work. */
+    /** Used by `RowRenderer` when getting lock. Allows React async refreshes to work. */
     getLockOnRefresh?(): void;
-    /** Used by `RowRenderer` when releasing lock. Allows React 17- async refreshes to work. */
+    /** Used by `RowRenderer` when releasing lock. Allows React async refreshes to work. */
     releaseLockOnRefresh?(): void;
-    /** Used by `RowRenderer` when a refresh happens whilst another refresh is ongoing. */
-    getLockOnRefreshError?(): string;
+    /** Used by the CtrlsService to decide whether to trigger the whenReady callbacks asynchronously.
+     * Required for React to work with StrictMode from v19 with the current implementation of the CtrlsService.
+     */
+    runWhenReadyAsync?(): boolean;
 }

package/dist/types/core/interfaces/iMenuFactory.d.ts

@@ -1,9 +1,10 @@
 import type { AgColumn } from '../entities/agColumn';
+import type { AgProvidedColumnGroup } from '../entities/agProvidedColumnGroup';
 import type { ContainerType } from './iAfterGuiAttachedParams';
 export interface IMenuFactory {
     showMenuAfterButtonClick(column: AgColumn | undefined, eventSource: HTMLElement, containerType: ContainerType, filtersOnly?: boolean): void;
     showMenuAfterMouseEvent(column: AgColumn | undefined, mouseEvent: MouseEvent | Touch, containerType: ContainerType, filtersOnly?: boolean): void;
-    showMenuAfterContextMenuEvent(column: AgColumn | undefined, mouseEvent?: MouseEvent | null, touchEvent?: TouchEvent | null): void;
+    showMenuAfterContextMenuEvent(column: AgColumn | AgProvidedColumnGroup | undefined, mouseEvent?: MouseEvent | null, touchEvent?: TouchEvent | null): void;
     isMenuEnabled(column: AgColumn): boolean;
     hideActiveMenu(): void;
 }