ag-grid-community 35.2.0 → 35.3.0

package/dist/types/src/edit/strategy/singleCellEditStrategy.d.ts

@@ -5,7 +5,7 @@ import type { CellCtrl } from '../../rendering/cell/cellCtrl';
 import type { EditValidationAction, EditValidationResult } from './baseEditStrategy';
 import { BaseEditStrategy } from './baseEditStrategy';
 export declare class SingleCellEditStrategy extends BaseEditStrategy {
-    beanName: "ariaAnnounce" | "dragSvc" | "dragAndDrop" | "environment" | "eventSvc" | "iconSvc" | "localeSvc" | "popupSvc" | "gos" | "registry" | "context" | "frameworkOverrides" | "eRootDiv" | "agChartsExports" | "rangeSvc" | "advFilterExpSvc" | "advSettingsMenuFactory" | "chartCrossFilterSvc" | "chartMenuItemMapper" | "chartMenuListFactory" | "chartMenuSvc" | "chartTranslation" | "colChooserFactory" | "colMenuFactory" | "colToolPanelFactory" | "enterpriseChartProxyFactory" | "lazyBlockLoadingSvc" | "menuItemMapper" | "menuUtils" | "ssrmBlockUtils" | "ssrmExpandListener" | "ssrmFilterListener" | "ssrmListenerUtils" | "ssrmNodeManager" | "ssrmSortSvc" | "ssrmStoreFactory" | "ssrmStoreUtils" | "statusBarSvc" | "testIdSvc" | "formula" | "sideBar" | "valueCache" | "pagination" | "groupFilter" | "advancedFilter" | "rowModel" | "gridOptions" | "pageBoundsListener" | "rowRenderer" | "valueSvc" | "colModel" | "colViewport" | "colNames" | "visibleCols" | "colMoves" | "colFlex" | "colResize" | "headerNavigation" | "navigation" | "colAnimation" | "focusSvc" | "cellStyles" | "colHover" | "userCompFactory" | "animationFrameSvc" | "sortSvc" | "colFilter" | "filterManager" | "rowContainerHeight" | "selectionSvc" | "rowStyleSvc" | "ctrlsSvc" | "syncSvc" | "validation" | "gridApi" | "eGridDiv" | "withinStudio" | "pivotResultCols" | "autoColSvc" | "selectionColSvc" | "rowNumbersSvc" | "colDefFactory" | "colAutosize" | "rowGroupColsSvc" | "valueColsSvc" | "pivotColsSvc" | "quickFilter" | "showRowGroupCols" | "showRowGroupColValueSvc" | "dataTypeSvc" | "globalListener" | "globalSyncListener" | "stateSvc" | "overlays" | "pinnedRowModel" | "menuSvc" | "apiEventSvc" | "undoRedo" | "rowNodeBlockLoader" | "csvCreator" | "excelCreator" | "clipboardSvc" | "cellNavigation" | "scrollVisibleSvc" | "pinnedCols" | "expressionSvc" | "autoWidthCalc" | "agCompUtils" | "frameworkCompWrapper" | "horizontalResizeSvc" | "filterMenuFactory" | "enterpriseMenuFactory" | "contextMenuSvc" | "editSvc" | "editModelSvc" | "alignedGridsSvc" | "paginationAutoPageSizeSvc" | "pageBounds" | "apiFunctionSvc" | "gridDestroySvc" | "expansionSvc" | "ssrmTxnManager" | "aggFuncSvc" | "filterStage" | "sortStage" | "flattenStage" | "groupStage" | "aggStage" | "aggChildrenSvc" | "pivotStage" | "filterAggStage" | "rowNodeSorter" | "pivotColDefSvc" | "chartSvc" | "aggColNameSvc" | "renderStatus" | "rowDropHighlightSvc" | "rowDragSvc" | "groupEditSvc" | "rowGroupingEditValueSvc" | "stickyRowSvc" | "filterValueSvc" | "cellFlashSvc" | "masterDetailSvc" | "tooltipSvc" | "colGroupSvc" | "rowAutoHeight" | "rowChildrenSvc" | "footerSvc" | "touchSvc" | "rowSpanSvc" | "spannedRowRenderer" | "findSvc" | "multiFilter" | "filterPanelSvc" | "selectableFilter" | "colDelayRenderSvc" | "gridSerializer" | "licenseManager" | "changedPathFactory" | "changeDetectionSvc" | "groupHierarchyColSvc" | "formulaDataSvc" | "formulaInputManager" | "columnStateUpdateStrategy" | undefined;
+    beanName: "ariaAnnounce" | "dragSvc" | "dragAndDrop" | "environment" | "eventSvc" | "iconSvc" | "localeSvc" | "popupSvc" | "gos" | "registry" | "context" | "frameworkOverrides" | "eRootDiv" | "agChartsExports" | "toolbar" | "rangeSvc" | "sideBar" | "valueCache" | "pagination" | "advFilterExpSvc" | "advSettingsMenuFactory" | "chartCrossFilterSvc" | "chartMenuItemMapper" | "chartMenuListFactory" | "chartMenuSvc" | "chartTranslation" | "colChooserFactory" | "colMenuFactory" | "colToolPanelFactory" | "enterpriseChartProxyFactory" | "lazyBlockLoadingSvc" | "menuItemMapper" | "menuUtils" | "ssrmBlockUtils" | "ssrmExpandListener" | "ssrmFilterListener" | "ssrmListenerUtils" | "ssrmNodeManager" | "ssrmSortSvc" | "ssrmStoreFactory" | "ssrmStoreUtils" | "statusBarSvc" | "testIdSvc" | "toolbarMenuBuilder" | "formula" | "groupFilter" | "advancedFilter" | "rowModel" | "sortSvc" | "pinnedCols" | "colFlex" | "gridOptions" | "pageBoundsListener" | "rowRenderer" | "valueSvc" | "colModel" | "colViewport" | "colNames" | "visibleCols" | "colMoves" | "colResize" | "headerNavigation" | "navigation" | "colAnimation" | "focusSvc" | "cellStyles" | "colHover" | "userCompFactory" | "animationFrameSvc" | "colFilter" | "filterManager" | "rowContainerHeight" | "selectionSvc" | "rowStyleSvc" | "ctrlsSvc" | "syncSvc" | "validation" | "gridApi" | "eGridDiv" | "withinStudio" | "pivotResultCols" | "autoColSvc" | "selectionColSvc" | "rowNumbersSvc" | "colDefFactory" | "colAutosize" | "rowGroupColsSvc" | "valueColsSvc" | "pivotColsSvc" | "quickFilter" | "showRowGroupCols" | "showRowGroupColValueSvc" | "dataTypeSvc" | "globalListener" | "globalSyncListener" | "stateSvc" | "overlays" | "pinnedRowModel" | "menuSvc" | "apiEventSvc" | "undoRedo" | "rowNodeBlockLoader" | "csvCreator" | "excelCreator" | "clipboardSvc" | "cellNavigation" | "scrollVisibleSvc" | "expressionSvc" | "autoWidthCalc" | "agCompUtils" | "frameworkCompWrapper" | "horizontalResizeSvc" | "filterMenuFactory" | "enterpriseMenuFactory" | "contextMenuSvc" | "editSvc" | "editModelSvc" | "alignedGridsSvc" | "paginationAutoPageSizeSvc" | "pageBounds" | "apiFunctionSvc" | "gridDestroySvc" | "expansionSvc" | "ssrmTxnManager" | "aggFuncSvc" | "filterStage" | "sortStage" | "groupFilterStage" | "groupSortStage" | "flattenStage" | "groupStage" | "aggStage" | "aggChildrenSvc" | "pivotStage" | "filterAggStage" | "rowNodeSorter" | "pivotColDefSvc" | "chartSvc" | "aggColNameSvc" | "renderStatus" | "rowDropHighlightSvc" | "rowDragSvc" | "groupEditSvc" | "rowGroupingEditValueSvc" | "stickyRowSvc" | "filterValueSvc" | "cellFlashSvc" | "masterDetailSvc" | "tooltipSvc" | "colGroupSvc" | "rowAutoHeight" | "rowChildrenSvc" | "footerSvc" | "touchSvc" | "rowSpanSvc" | "spannedRowRenderer" | "findSvc" | "rowGroupPanelBuilder" | "multiFilter" | "filterPanelSvc" | "selectableFilter" | "colDelayRenderSvc" | "gridSerializer" | "licenseManager" | "changedPathFactory" | "changeDetectionSvc" | "groupHierarchyColSvc" | "formulaDataSvc" | "formulaInputManager" | "notesDataSvc" | "notesSvc" | "columnStateUpdateStrategy" | undefined;
     private rowNode?;
     private column?;
     shouldStop(position?: EditPosition, event?: KeyboardEvent | MouseEvent | null | undefined, source?: 'api' | 'ui'): boolean | null;

package/dist/types/src/entities/agColumn.d.ts

@@ -15,7 +15,7 @@ export declare class AgColumn<TValue = any> extends BeanStub<ColumnEventName> im
     colDef: ColDef<any, TValue>;
     userProvidedColDef: ColDef<any, TValue> | null;
     readonly colId: string;
-    private readonly primary;
+    readonly primary: boolean;
     readonly isColumn: true;
     private frameworkEventListenerService?;
     private readonly instanceId;
@@ -29,7 +29,6 @@ export declare class AgColumn<TValue = any> extends BeanStub<ColumnEventName> im
     private oldLeft;
     aggFunc: string | IAggFunc | null | undefined;
     private sortDef;
-    private _wasSortExplicitlyRemoved;
     sortIndex: number | null | undefined;
     moving: boolean;
     resizing: boolean;
@@ -42,7 +41,7 @@ export declare class AgColumn<TValue = any> extends BeanStub<ColumnEventName> im
     private maxWidth;
     filterActive: boolean;
     private readonly colEventSvc;
-    private fieldContainsDots;
+    fieldContainsDots: boolean;
     private tooltipFieldContainsDots;
     tooltipEnabled: boolean;
     rowGroupActive: boolean;
@@ -109,8 +108,7 @@ export declare class AgColumn<TValue = any> extends BeanStub<ColumnEventName> im
     private getColDefAllowedSortTypes;
     getSortingOrder(): SortDef[];
     getAvailableSortTypes(): Set<string>;
-    get wasSortExplicitlyRemoved(): boolean;
-    setSortDef(sortDef: SortDef, initial?: boolean): void;
+    setSortDef(sortDef: SortDef): void;
     isSortable(): boolean;
     /** @deprecated v32 use col.getSort() === 'asc */
     isSortAscending(): boolean;

package/dist/types/src/entities/colDef.d.ts

@@ -139,22 +139,23 @@ export type IAggFuncs<TData = any, TValue = any, TContext = any> = {
     [key: string]: IAggFunc<TData, TValue, TContext>;
 };
 /**
- * Wrapper object returned by built-in aggregation functions `avg` and `count` on group rows.
+ * Wrapper returned by the built-in `avg` and `count` aggregation functions, and the recommended
+ * shape for custom agg functions that expose a scalar value alongside metadata (e.g. a count, used
+ * when re-aggregating across nested groups).
  *
- * - `avg` returns `{ value: number | bigint | null, count: number, toString(), toNumber() }`
- * - `count` returns `{ value: number, toString(), toNumber() }`
+ * - `avg` returns `{ value, count, toString(), toNumber() }`
+ * - `count` returns `{ value, toString(), toNumber() }`
  *
- * Other built-in agg functions (`sum`, `min`, `max`, `first`, `last`) return plain scalar values.
- * Custom aggregation functions may return any value.
+ * Other built-ins (`sum`, `min`, `max`, `first`, `last`) return plain scalars.
  */
 export interface IAggFuncResult<TAggValue = number | bigint | null> {
-    /** The aggregated scalar value */
+    /** The aggregated scalar value. */
     value?: TAggValue;
     /** The count of aggregated values. Present on `avg` results. */
     count?: number;
-    /** Returns a string representation of the aggregated value */
+    /** Returns a string representation of the aggregated value. Used also for sorting. */
     toString(): string;
-    /** Returns the numeric representation of the aggregated value */
+    /** Returns the numeric representation of the aggregated value. Used also for sorting. */
     toNumber?(): TAggValue;
 }
 export interface IAggFuncParams<TData = any, TValue = any, TContext = any> extends AgGridCommon<TData, TContext> {
@@ -310,6 +311,14 @@ export interface ColDef<TData = any, TValue = any> extends AbstractColDef<TData,
      * @default false
      */
     suppressNavigable?: boolean | SuppressNavigableCallback<TData, TValue>;
+    /**
+     * Set to `true` to suppress built-in note actions for this column.
+     * Existing notes remain viewable on hover and through `getNote()`.
+     * Can also be a callback function to suppress notes for specific rows.
+     * @default false
+     * @agModule `NotesModule`
+     */
+    suppressNoteActions?: boolean | SuppressNoteActionsCallback<TData, TValue>;
     /**
      * Allows the user to suppress certain keyboard events in the grid cell.
      * @default false
@@ -893,6 +902,9 @@ export type SuppressPasteCallback<TData = any, TValue = any, TContext = any> = (
 export interface SuppressNavigableCallbackParams<TData = any, TValue = any, TContext = any> extends ColumnFunctionCallbackParams<TData, TValue, TContext> {
 }
 export type SuppressNavigableCallback<TData = any, TValue = any, TContext = any> = (params: SuppressNavigableCallbackParams<TData, TValue, TContext>) => boolean;
+export interface SuppressNoteActionsCallbackParams<TData = any, TValue = any, TContext = any> extends ColumnFunctionCallbackParams<TData, TValue, TContext> {
+}
+export type SuppressNoteActionsCallback<TData = any, TValue = any, TContext = any> = (params: SuppressNoteActionsCallbackParams<TData, TValue, TContext>) => boolean;
 export interface HeaderCheckboxSelectionCallbackParams<TData = any, TValue = any, TContext = any> extends AgGridCommon<TData, TContext> {
     column: Column<TValue>;
     colDef: ColDef<TData, TValue>;

package/dist/types/src/entities/gridOptions.d.ts

@@ -29,14 +29,21 @@ import type { IRowNode, RowPinnedType } from '../interfaces/iRowNode';
 import type { IServerSideDatasource } from '../interfaces/iServerSideDatasource';
 import type { SideBarDef } from '../interfaces/iSideBar';
 import type { StatusBar } from '../interfaces/iStatusPanel';
+import type { Toolbar } from '../interfaces/iToolbar';
 import type { IViewportDatasource } from '../interfaces/iViewportDatasource';
 import type { DefaultMenuItem, MenuItemDef } from '../interfaces/menuItem';
+import type { FullWidthNotesDataSource, NotesDataSource } from '../interfaces/notes';
 import type { RowNumbersOptions } from '../interfaces/rowNumbers';
 import type { OverlaySelectorFunc, OverlayType } from '../rendering/overlays/overlayComponent';
 import type { Icons } from '../utils/icon';
 import type { CheckboxSelectionCallback, ColDef, ColGroupDef, ColTypeDefs, GroupHierarchyConfig, IAggFuncs, SortDirection } from './colDef';
 import type { DataTypeDefinitions } from './dataType';
 export interface GridOptions<TData = any> {
+    /**
+     * Specifies the toolbar items to use in the toolbar.
+     * @agModule `ToolbarModule`
+     */
+    toolbar?: Toolbar;
     /**
      * Specifies the status bar components to use in the status bar.
      * @agModule `StatusBarModule`
@@ -857,7 +864,6 @@ export interface GridOptions<TData = any> {
      * Set to `true` to show the page size selector with the default page sizes `[20, 50, 100]`.
      * Set to `false` to hide the page size selector.
      * @default true
-     * @initial
      * @agModule `PaginationModule`
      */
     paginationPageSizeSelector?: number[] | boolean;
@@ -882,6 +888,15 @@ export interface GridOptions<TData = any> {
      * @agModule `PaginationModule`
      */
     suppressPaginationPanel?: boolean;
+    /**
+     * Controls which built-in components appear in the pagination panel and in what order.
+     * Accepts an array of names: `'pageSize'`, `'rowSummary'`, `'pageSummary'`.
+     * Components render in the order they appear in the array. Omitted components are hidden.
+     * An empty array hides the pagination panel entirely.
+     * When not set, all three components render in the default order: [`pageSize`, `rowSummary`, `pageSummary`].
+     * @agModule `PaginationModule`
+     */
+    paginationPanels?: PaginationPanel[];
     /**
      * Set to `true` to enable pivot mode.
      * @default false
@@ -912,12 +927,12 @@ export interface GridOptions<TData = any> {
      * When set and the grid is in pivot mode, automatically calculated totals will appear within the Pivot Column Groups, in the position specified.
      * @agModule `PivotModule`
      */
-    pivotColumnGroupTotals?: 'before' | 'after';
+    pivotColumnGroupTotals?: PivotColumnGroupTotals;
     /**
      * When set and the grid is in pivot mode, automatically calculated totals will appear for each value column in the position specified.
      * @agModule `PivotModule`
      */
-    pivotRowTotals?: 'before' | 'after';
+    pivotRowTotals?: PivotRowTotals;
     /**
      * If `true`, the grid will not swap in the grouping column when pivoting. Useful if pivoting using Server Side Row Model or Viewport Row Model and you want full control of all columns including the group column.
      * @default false
@@ -951,6 +966,33 @@ export interface GridOptions<TData = any> {
      * @agModule `FormulaModule`
      */
     formulaDataSource?: FormulaDataSource;
+    /**
+     * Provide a data source to control where notes are stored and retrieved.
+     * Can be updated to enable, disable, or replace Notes at runtime.
+     * @agModule `NotesModule`
+     */
+    notesDataSource?: NotesDataSource | FullWidthNotesDataSource;
+    /**
+     * Changes how existing notes are opened.
+     *  - `'hover'` - Existing notes open when hovering a noted cell or full width row.
+     *  - `'click'` - Existing notes open when clicking a noted cell or full width row.
+     * @default 'hover'
+     * @agModule `NotesModule`
+     */
+    noteTrigger?: 'hover' | 'click';
+    /**
+     * The delay in milliseconds before a note is shown when hovering a noted cell.
+     * Only applies when `noteTrigger = 'hover'`.
+     * @default 180
+     * @agModule `NotesModule`
+     */
+    noteShowDelay?: number;
+    /**
+     * The delay in milliseconds before a note is hidden after the pointer leaves a noted cell or note popup.
+     * @default 220
+     * @agModule `NotesModule`
+     */
+    noteHideDelay?: number;
     /**
      * A map of 'function name' to 'function' for custom functions that are used for formulas.
      * @initial
@@ -1157,8 +1199,18 @@ export interface GridOptions<TData = any> {
      */
     autoGroupColumnDef?: AutoGroupColumnDef<TData>;
     /**
-     * When `true`, preserves the current group order when sorting on non-group columns.
-     * If a user explicitly resets the current group sort direction, then the current group column order is not preserved.
+     * When `true`, sorting on non-group columns does not reorder groups; only the rows within
+     * each group are sorted. Group order remains the structural order set at grouping time
+     * (data-insertion order, or `initialGroupOrderComparator` if configured) and is preserved
+     * across filter changes and transactions. If a group column was sorted via `colDef.sort`
+     * and the user later explicitly clears that sort, the structural order is restored.
+     *
+     * With multi-level row grouping, the order is maintained per level: a sort on a group
+     * column at one level only re-orders that level's groups; sibling levels keep their
+     * structural order.
+     *
+     * Applies to row grouping only. Has no effect on tree data, where row order is determined
+     * by the tree structure.
      * @default false
      * @agModule `RowGroupingModule`
      */
@@ -1701,6 +1753,12 @@ export interface GridOptions<TData = any> {
      * @initial
      */
     suppressRowTransform?: boolean;
+    /**
+     * Set to `true` to suppress `content-visibility: auto` on the grid wrapper element. This degrades performance by causing the browser to render grids even when they are off screen, but may be necessary if your application depends on receiving resize events from hidden grids.
+     * @default false
+     * @initial
+     */
+    suppressContentVisibilityAuto?: boolean;
     /**
      * Set to `true` to highlight columns by adding the `ag-column-hover` CSS class.
      * @default false
@@ -1714,6 +1772,8 @@ export interface GridOptions<TData = any> {
     gridId?: string;
     /**
      * When enabled, sorts only the rows added/updated by a transaction.
+     *
+     * Ignored when `postSortRows` is configured (falls back to full sort).
      * @default false
      */
     deltaSort?: boolean;
@@ -2030,6 +2090,8 @@ export interface GridOptions<TData = any> {
     fillOperation?: FillOperation<TData>;
     /**
      * Callback to perform additional sorting after the grid has sorted the rows.
+     *
+     * When configured, `deltaSort` is ignored.
      */
     postSortRows?: PostSortRows<TData>;
     /**
@@ -2768,4 +2830,7 @@ export type MasterSelectionMode = NonNullable<CommonRowSelectionOptions['masterS
 export type AgPublicEventHandlerType = `on${Capitalize<AgPublicEventType>}` & keyof GridOptions;
 export type ProcessPivotResultColDef<TData = any, TValue = any> = (colDef: ColDef<TData, TValue>) => void;
 export type ProcessPivotResultColGroupDef<TData = any> = (colDef: ColGroupDef<TData>) => void;
+export type PaginationPanel = 'pageSize' | 'rowSummary' | 'pageSummary';
+export type PivotColumnGroupTotals = 'before' | 'after';
+export type PivotRowTotals = 'before' | 'after';
 export {};

package/dist/types/src/entities/rowNode.d.ts

@@ -228,6 +228,13 @@ export declare class RowNode<TData = any> implements IEventEmitter<RowNodeEventT
      * Updates the data on the `rowNode`. When this method is called, the grid refreshes the entire rendered row if it is displayed.
      */
     updateData(data: TData): void;
+    /**
+     * Like {@link updateData}, but does NOT mirror the data onto `this.sibling`. Used for
+     * row nodes whose sibling must not share data — e.g. the SSRM grand total node, whose
+     * sibling is the root.
+     * @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time.
+     */
+    _updateDataNoSibling(data: TData): void;
     private setDataCommon;
     private updateDataOnDetailNode;
     private createDataChangedEvent;
@@ -333,6 +340,14 @@ export declare class RowNode<TData = any> implements IEventEmitter<RowNodeEventT
     setAllChildrenCount(allChildrenCount: number | null): void;
     setUiLevel(uiLevel: number): void;
     getFirstChild(): RowNode<TData> | null;
-    /** Called internally to destroy this node */
-    _destroy(fadeOut: boolean): boolean;
+    /**
+     * Called internally to destroy this node.
+     * @param fadeOut
+     *   - `true`: fade-out animation; preserves slide-in via `oldRowTop`.
+     *   - `false`: instant removal; dispatches position events.
+     *   - `null`: silent. Wholesale tree replacement only — the rowRenderer is about to
+     *     tear down every RowCtrl, so position events would just trigger wasted work in
+     *     `cellCtrl.onRowIndexChanged()` on rows that are about to vanish.
+     */
+    _destroy(fadeOut: boolean | null): boolean;
 }

package/dist/types/src/filter/filterManager.d.ts

@@ -45,15 +45,11 @@ export declare class FilterManager extends BeanStub implements NamedBean {
     isAggregateQuickFilterPresent(): boolean;
     private isNonAggregateQuickFilterPresent;
     private shouldApplyQuickFilterAfterAgg;
-    doesRowPassOtherFilters(colIdToSkip: string, rowNode: RowNode): boolean;
     doesRowPassAggregateFilters(params: {
         rowNode: RowNode;
         colIdToSkip?: string;
     }): boolean;
-    doesRowPassFilter(params: {
-        rowNode: RowNode;
-        colIdToSkip?: string;
-    }): boolean;
+    doesRowPassFilter(rowNode: RowNode, colIdToSkip?: string): boolean;
     isFilterAllowed(column: AgColumn): boolean;
     getAdvFilterModel(): AdvancedFilterModel | null;
     setAdvFilterModel(expression: AdvancedFilterModel | null | undefined, source?: FilterChangedEventSourceType): void;

package/dist/types/src/filter/filterValueService.d.ts

@@ -7,6 +7,5 @@ import type { IRowNode } from '../interfaces/iRowNode';
 /** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
 export declare class FilterValueService extends BeanStub implements NamedBean {
     beanName: BeanName;
-    getValue(column: AgColumn, rowNode?: IRowNode | null, filterValueGetterOverride?: string | ValueGetterFunc): any;
-    private executeFilterValueGetter;
+    getValue(column: AgColumn, rowNode: IRowNode, filterValueGetterOverride?: string | ValueGetterFunc): any;
 }

package/dist/types/src/filter/provided/date/dateFilterHandler.d.ts

@@ -43,6 +43,7 @@ type RelativeRangeFn = (from: Date, to: Date) => [Date, Date];
  * Last 6 months           last6Months         [startOfToday − 6 months, startOfTomorrow)
  * Last 12 months          last12Months        [startOfToday − 12 months, startOfTomorrow)
  * Last 24 months          last24Months        [startOfToday − 24 months, startOfTomorrow)
+ * @knipIgnore Used in tests
  */
 export declare const presetDateFilterTypeRelativeFromToMap: Record<ISimpleFilterModelPresetType | 'setStartOfDay' | 'setStartOfWeek' | 'setStartOfNextDay' | 'setStartOfNextWeek' | 'setStartOfMonth' | 'setStartOfNextMonth' | 'setStartOfQuarter' | 'setStartOfNextQuarter' | 'setStartOfYear' | 'setStartOfNextYear' | 'setPreviousDay' | 'setPreviousWeek' | 'setPreviousMonth' | 'setPreviousQuarter', RelativeRangeFn | RelativeDateFn>;
 export {};

package/dist/types/src/gridBodyComp/rowContainer/rowContainerEventsFeature.d.ts

@@ -16,6 +16,8 @@ export declare class RowContainerEventsFeature extends BeanStub {
     private processKeyboardEvent;
     private processCellKeyboardEvent;
     private processFullWidthRowKeyboardEvent;
+    private processFullWidthRowKeyDown;
+    private processFullWidthRowNoteShortcut;
     private doGridOperations;
     private onCtrlAndA;
     private onCtrlAndC;

package/dist/types/src/gridComp/gridComp.d.ts

@@ -2,6 +2,7 @@ import type { FocusableContainer } from '../interfaces/iFocusableContainer';
 import { TabGuardComp } from '../widgets/tabGuardComp';
 export declare class GridComp extends TabGuardComp {
     private readonly gridBody;
+    private readonly toolbar;
     private readonly gridHeaderDropZones;
     private readonly sideBar;
     private readonly statusBar;

package/dist/types/src/gridComp/gridCtrl.d.ts

@@ -17,6 +17,7 @@ export interface OptionalGridComponents {
     gridHeaderDropZonesSelector?: ComponentSelector<Component>;
     sideBarSelector?: ComponentSelector<Component>;
     statusBarSelector?: ComponentSelector<Component>;
+    toolbarSelector?: ComponentSelector<Component & FocusableContainer>;
     watermarkSelector?: ComponentSelector<Component>;
 }
 /** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */

package/dist/types/src/gridOptionsDefault.d.ts

@@ -9,6 +9,9 @@ export declare const GRID_OPTION_DEFAULTS: {
     readonly tooltipShowDelay: 2000;
     readonly tooltipSwitchShowDelay: 200;
     readonly tooltipHideDelay: 10000;
+    readonly noteTrigger: "hover";
+    readonly noteShowDelay: 180;
+    readonly noteHideDelay: 220;
     readonly tooltipMouseTrack: false;
     readonly tooltipShowMode: "standard";
     readonly tooltipInteraction: false;

package/dist/types/src/gridOptionsInitial.d.ts

@@ -38,7 +38,6 @@ export declare const INITIAL_GRID_OPTION_KEYS: {
     loadingOverlayComponent: boolean;
     suppressLoadingOverlay: boolean;
     noRowsOverlayComponent: boolean;
-    paginationPageSizeSelector: boolean;
     paginateChildRows: boolean;
     pivotPanelShow: boolean;
     pivotSuppressAutoColumn: boolean;
@@ -70,6 +69,7 @@ export declare const INITIAL_GRID_OPTION_KEYS: {
     scrollbarWidth: boolean;
     icons: boolean;
     suppressRowTransform: boolean;
+    suppressContentVisibilityAuto: boolean;
     gridId: boolean;
     enableGroupEdit: boolean;
     initialState: boolean;

package/dist/types/src/gridOptionsService.d.ts

@@ -84,6 +84,7 @@ export declare class GridOptionsService extends BeanStub implements NamedBean, I
         gridId: string;
         rowModelType: RowModelType;
         isUmd: boolean;
+        usesAgGridProvider: boolean;
     };
     isModuleRegistered(moduleName: ModuleName): boolean;
     setInstanceDomData(element: HTMLElement): void;

package/dist/types/src/gridOptionsUtils.d.ts

@@ -11,9 +11,9 @@ import type { IRowModel } from './interfaces/iRowModel';
 import type { IRowNode } from './interfaces/iRowNode';
 import type { IServerSideRowModel } from './interfaces/iServerSideRowModel';
 /** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
-export declare function _isClientSideRowModel(gos: GridOptionsService, rowModel?: IRowModel): rowModel is IClientSideRowModel;
+export declare function _isClientSideRowModel(gos: GridOptionsService, _rowModel?: IRowModel): _rowModel is IClientSideRowModel;
 /** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
-export declare function _isServerSideRowModel(gos: GridOptionsService, rowModel?: IRowModel): rowModel is IServerSideRowModel;
+export declare function _isServerSideRowModel(gos: GridOptionsService, _rowModel?: IRowModel): _rowModel is IServerSideRowModel;
 /** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
 export declare function _isDomLayout(gos: GridOptionsService, domLayout: DomLayoutType): boolean;
 /** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
@@ -42,6 +42,12 @@ export declare function _isColumnsSortingCoupledToGroup(gos: GridOptionsService)
 export declare function _getGroupAggFiltering(gos: GridOptionsService): ((params: WithoutGridCommon<GetGroupAggFilteringParams>) => boolean) | undefined;
 /** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
 export declare function _getGrandTotalRow(gos: GridOptionsService): GridOptions['grandTotalRow'];
+/**
+ * Maps a `grandTotalRow` option to the floating side the grand total should be pinned to,
+ * or `null` when it should render inline (or is disabled).
+ * @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time.
+ */
+export declare function _getGrandTotalPinnedFloat(grandTotalRow: GridOptions['grandTotalRow']): 'top' | 'bottom' | null;
 /** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
 export declare function _getGroupTotalRowCallback(gos: GridOptionsService): (params: WithoutGridCommon<GetGroupIncludeFooterParams>) => 'top' | 'bottom' | undefined;
 /** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */

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

@@ -54,7 +54,7 @@ export declare class HeaderRowCtrl extends BeanStub {
      * Recycles the header cell ctrls and creates new ones for the columns in the viewport
      * @returns The updated header cell ctrls
      */
-    getUpdatedHeaderCtrls(): AbstractHeaderCellCtrl<import("../../main-umd-noStyles").IAbstractHeaderCellComp, AgColumn<any> | AgColumnGroup<any>, import("../cells/abstractCell/abstractHeaderCellCtrl").IHeaderResizeFeature>[];
+    getUpdatedHeaderCtrls(): AbstractHeaderCellCtrl<import("../../main-umd-noStyles").IAbstractHeaderCellComp, AgColumnGroup<any> | AgColumn<any>, import("../cells/abstractCell/abstractHeaderCellCtrl").IHeaderResizeFeature>[];
     /** Get the current header cell ctrls */
     getHeaderCellCtrls(): AbstractHeaderCellCtrl[];
     private recycleAndCreateHeaderCtrls;

package/dist/types/src/interfaces/exportParams.d.ts

@@ -146,10 +146,18 @@ export interface ShouldRowBeSkippedParams<TData = any, TContext = any> extends A
 export type ProcessCellForClipboard<TData = any, TContext = any> = (params: ProcessCellForExportParams<TData, TContext>) => any;
 export type ProcessCellFromClipboard<TData = any, TContext = any> = (params: ProcessCellForExportParams<TData, TContext>) => any;
 export interface ProcessCellForExportParams<TData = any, TContext = any> extends AgGridCommon<TData, TContext> {
+    /** The raw cell value before any formatting or processing. */
     value: any;
+    /**
+     * The zero-based row index in the exported output, including any prepended content rows.
+     * Only populated for file export flows (`'excel'`, `'csv'`); omitted for clipboard flows.
+     */
     accumulatedRowIndex?: number;
+    /** The row node for the cell. May be `null` or `undefined` for clipboard flows when no row is associated. */
     node?: IRowNode<TData> | null;
+    /** The column for the cell. */
     column: Column;
+    /** The operation that triggered the callback */
     type: string;
     /** Utility function to parse a value using the column's `colDef.valueParser` */
     parseValue: (value: string) => any;
@@ -158,13 +166,17 @@ export interface ProcessCellForExportParams<TData = any, TContext = any> extends
 }
 export type ProcessHeaderForClipboard<TData = any, TContext = any> = (params: ProcessHeaderForExportParams<TData, TContext>) => any;
 export interface ProcessHeaderForExportParams<TData = any, TContext = any> extends AgGridCommon<TData, TContext> {
+    /** The grid column */
     column: Column;
 }
 export type ProcessGroupHeaderForClipboard<TData = any, TContext = any> = (params: ProcessGroupHeaderForExportParams<TData, TContext>) => any;
 export interface ProcessGroupHeaderForExportParams<TData = any, TContext = any> extends AgGridCommon<TData, TContext> {
+    /** The grid column group */
     columnGroup: ColumnGroup;
 }
 export interface ProcessRowGroupForExportParams<TData = any, TContext = any> extends AgGridCommon<TData, TContext> {
+    /** Row node. */
     node: IRowNode<TData>;
+    /** The grid column */
     column?: Column;
 }

package/dist/types/src/interfaces/formulas.d.ts

@@ -1,3 +1,4 @@
+import type { ChangedRowNodes } from '../clientSideRowModel/changedRowNodes';
 import type { ColumnCollections } from '../columns/columnModel';
 import type { Bean } from '../context/bean';
 import type { AgColumn } from '../entities/agColumn';
@@ -65,9 +66,11 @@ export interface IFormulaDataService extends Bean {
 }
 export interface IFormulaService extends Bean {
     active: boolean;
+    hasCachedRows(): boolean;
     isFormula(value: unknown): value is `=${string}`;
     setFormulasActive(cols: ColumnCollections): void;
     resolveValue(col: AgColumn, row: RowNode): unknown;
+    getDataSourceFormula(row: RowNode, col: AgColumn): string | undefined;
     getFormulaError(col: AgColumn, row: RowNode): Error | null;
     normaliseFormula(value: string, shorthand: boolean): string | null;
     getColByRef(ref: string): AgColumn | null;
@@ -79,6 +82,18 @@ export interface IFormulaService extends Bean {
         useRefFormat?: boolean;
     }): string;
     refreshFormulas(refreshRows: boolean): void;
+    /**
+     * Drop a row's formula cache (including pinned / group-footer siblings) and repaint.
+     * Accepts a `RowNode` directly, or a row id string — in which case the main row model,
+     * pinned-top and pinned-bottom row models are all consulted and every matching chain is
+     * invalidated. Returns `true` when at least one entry was dropped.
+     */
+    refreshRow(row: RowNode | string): boolean;
+    /**
+     * Called by CSRM after every model refresh so the service can evict cache entries for destroyed
+     * rows and, if the row order or set changed, drop stale computed values while keeping parsed ASTs.
+     */
+    onRowsChanged(changedRowNodes: ChangedRowNodes | undefined, newData: boolean | undefined): void;
     getFunction(name: string): ((params: FormulaFunctionParams) => unknown) | undefined;
     getFunctionNames(): string[];
 }

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

@@ -7,6 +7,7 @@ import type { FocusableContainerName } from './iFocusableContainer';
 import type { HeaderPosition } from './iHeaderPosition';
 import type { IRowNode, RowPinnedType } from './iRowNode';
 import type { DefaultMenuItem } from './menuItem';
+import type { GetNoteParams } from './notes';
 import type { ServerSideTransaction } from './serverSideTransaction';
 export interface GetContextMenuItemsParams<TData = any, TContext = any> extends AgGridCommon<TData, TContext> {
     /** Names of the items that would be provided by default. */
@@ -295,5 +296,7 @@ export interface IMenuActionParams<TData = any, TContext = any> extends AgGridCo
     node: IRowNode<TData> | null;
     /** The value, if a cell was clicked, otherwise null.  */
     value: any;
+    /** The note params for the cell or full width row that was clicked, if notes are enabled. */
+    noteParams?: GetNoteParams;
 }
 export type GetBusinessKeyForNode<TData = any> = (node: IRowNode<TData>) => string;

package/dist/types/src/interfaces/iCellRangeFeature.d.ts

@@ -3,7 +3,7 @@ import type { ICellComp } from '../rendering/cell/cellCtrl';
 export interface ICellRangeFeature {
     setComp(cellComp: ICellComp): void;
     unsetComp(): void;
-    refreshRangeStyleAndHandle(): void;
+    scheduleRefreshRangeStyleAndHandle(): void;
     updateRangeBordersIfRangeCount(): void;
     onCellSelectionChanged(): void;
     destroy(): void;

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

@@ -1,8 +1,9 @@
 import type { Column } from '../interfaces/iColumn';
-import type { ExportFileNameGetter, ExportParams } from './exportParams';
+import type { ExportFileNameGetter, ExportParams, ProcessCellForExportParams } from './exportParams';
 import type { AgGridCommon } from './iCommon';
 import type { IRowNode } from './iRowNode';
 import type { XmlElement } from './iXmlFactory';
+import type { Note } from './notes';
 export interface ExcelStyle {
     /** The id of the Excel Style, this should match a CSS cell class. */
     id: string;
@@ -262,6 +263,12 @@ export interface ExcelRow {
     /** An array of ExcelCells. */
     cells: ExcelCell[];
 }
+export interface ExcelNote {
+    /** The body text to export in the Excel note/comment. */
+    text: string;
+    /** Optional author name shown in Excel. */
+    author?: string;
+}
 export interface ExcelCell {
     /** The data that will be added to the cell. */
     data?: ExcelData;
@@ -276,6 +283,8 @@ export interface ExcelCell {
      * @default 0
      */
     mergeAcross?: number;
+    /** Optional note/comment to export for this cell. */
+    note?: ExcelNote;
 }
 export interface ExcelImagePosition {
     /** The row containing this image. This property is set automatically, don't change it unless you know what you are doing. */
@@ -494,6 +503,29 @@ export interface ExcelWorksheetConfigParams {
         image: ExcelImage;
         value?: string;
     } | undefined;
+    /**
+     * Set to `true` to suppress exporting cell notes from the grid `notesDataSource`.
+     * Callback-based note injection via `processNoteCallback` still works when this is set.
+     * @default false
+     */
+    suppressGridNotesExport?: boolean;
+    /**
+     * Allows customising, suppressing, or injecting Excel notes/comments for exported cells.
+     *
+     * Return `undefined` to keep the default behaviour, `null` to suppress the note for the current cell,
+     * or an `ExcelNote` to export a custom note.
+     */
+    processNoteCallback?: (params: ProcessNoteForExportParams) => ExcelNote | null | undefined;
+}
+export interface ProcessNoteForExportParams<TData = any, TContext = any> extends ProcessCellForExportParams<TData, TContext> {
+    /**
+     * The grid note resolved for the current cell, when the Notes feature is available.
+     */
+    gridNote?: Note;
+    /**
+     * The Excel note/comment value derived from `gridNote` when automatic note export is enabled.
+     */
+    excelNote?: ExcelNote;
 }
 export type ExcelCustomMetadataValue = string | number | boolean;
 export type ExcelCustomMetadata = Record<string, ExcelCustomMetadataValue>;
@@ -508,6 +540,13 @@ interface ExcelFileParams {
      * @default "AG Grid"
      * */
     author?: string;
+    /**
+     * Set to `true` to suppress prepending the author name as bold text in the
+     * exported Excel note body. The note author is still stored in the
+     * exported Excel note metadata regardless of this setting.
+     * @default false
+     */
+    suppressPrependAuthorToNotes?: boolean;
     /**
      * The default value for the font size of the Excel document.
      * @default 11

package/dist/types/src/interfaces/iFilter.d.ts

@@ -76,7 +76,7 @@ export type FilterHandlers<TData = any, TValue = any, TContext = any, TModel = a
 export interface ColumnFilter<TData = any, TValue = any, TContext = any, TModel = any, TCustomParams = any> {
     /**
      * Filter component to use for this column.
-     * - Set to the name of a provided filter: `agNumberColumnFilter`, `agBigIntColumnFilter`, `agTextColumnFilter`, `agDateColumnFilter`, `agMultiColumnFilter`, `agSetColumnFilter`.
+     * - Set to the name of a provided filter: `agNumberColumnFilter`, `agBigIntColumnFilter`, `agTextColumnFilter`, `agDateColumnFilter`.
      * - Set to a custom filter `FilterDisplay`
      */
     component: any;

package/dist/types/src/interfaces/iFocusableContainer.d.ts

@@ -1,4 +1,4 @@
-export type FocusableContainerName = 'dialog' | 'gridBody' | 'pagination' | 'pivotToolbar' | 'rowGroupToolbar' | 'sideBar' | 'statusBar';
+export type FocusableContainerName = 'dialog' | 'gridBody' | 'pagination' | 'pivotToolbar' | 'rowGroupToolbar' | 'sideBar' | 'statusBar' | 'toolbar';
 /** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
 export interface FocusableContainer {
     getGui(): HTMLElement;