ag-grid-community 35.3.0 → 36.0.0

package/dist/types/src/headerRendering/headerUtils.d.ts

@@ -1,9 +1,13 @@
 import type { ColumnModel } from '../columns/columnModel';
+import type { VisibleColsService } from '../columns/visibleColsService';
 import type { BeanCollection } from '../context/context';
+import type { ColumnPinnedType } from '../interfaces/iColumn';
 import type { HeaderPosition } from '../interfaces/iHeaderPosition';
 /** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
 export declare function getHeaderRowCount(colModel: ColumnModel): number;
 export declare function getFocusHeaderRowCount(beans: BeanCollection): number;
+/** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
+export declare function getAriaHeaderRowCount(beans: BeanCollection): number;
 export declare function getGroupRowsHeight(beans: BeanCollection): number[];
 export declare function getColumnHeaderRowHeight(beans: BeanCollection): number;
 export declare function getHeaderHeight(beans: BeanCollection): number;
@@ -11,3 +15,33 @@ export declare function getHeaderHeight(beans: BeanCollection): number;
 export declare function getFloatingFiltersHeight(beans: BeanCollection): number;
 export declare function isHeaderPositionEqual(headerPosA: HeaderPosition, headerPosB: HeaderPosition): boolean;
 export declare function isHeaderPosition(position: unknown): position is HeaderPosition;
+/** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
+export interface PinnedSectionWidths {
+    leftWidth: number;
+    centerWidth: number;
+    rightWidth: number;
+}
+/** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
+export declare function getPinnedSectionWidths(visibleCols: VisibleColsService, isPrint: boolean): PinnedSectionWidths;
+/** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
+export interface PinnedSectionElements {
+    ePinnedLeft: HTMLElement;
+    eScrolling: HTMLElement;
+    ePinnedRight: HTMLElement;
+}
+/** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
+export interface PinnedSectionWidthsCache {
+    pinnedLeftWidth: number | undefined;
+    centerWidth: number | undefined;
+    pinnedRightWidth: number | undefined;
+}
+/** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
+export declare function updatePinnedSectionWidths(visibleCols: VisibleColsService, isPrint: boolean, elements: PinnedSectionElements, cache: PinnedSectionWidthsCache): void;
+/** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
+export interface PinnedSections<T> {
+    left: T[];
+    center: T[];
+    right: T[];
+}
+/** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
+export declare function partitionByPinned<T>(items: T[], getPinned: (item: T) => ColumnPinnedType): PinnedSections<T>;

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

@@ -4,9 +4,18 @@ export type HeaderRowType = 'group' | 'column' | 'filter';
 export declare class HeaderRowComp extends Component {
     private readonly ctrl;
     private headerComps;
+    private readonly ePinnedLeftCells;
+    private readonly ePinnedLeftWrapper;
+    private readonly eScrollingCells;
+    private readonly ePinnedRightCells;
+    private readonly ePinnedRightWrapper;
+    private readonly pinnedWidthsCache;
     constructor(ctrl: HeaderRowCtrl);
     postConstruct(): void;
     destroy(): void;
     private setHeaderCtrls;
+    private getHeaderCellGroup;
+    private updatePinnedCellGroupWidths;
+    private setRowIndex;
     private createHeaderComp;
 }

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

@@ -2,7 +2,6 @@ import { BeanStub } from '../../context/beanStub';
 import type { AgColumn } from '../../entities/agColumn';
 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 type { HeaderRowType } from './headerRowComp';
 /** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
@@ -10,6 +9,7 @@ export interface IHeaderRowComp {
     setTop(top: string): void;
     setHeight(height: string): void;
     setHeaderCtrls(ctrls: AbstractHeaderCellCtrl[], forceOrder: boolean, afterScroll: boolean): void;
+    refreshPinnedCellGroupWidths(): void;
     setWidth(width: string): void;
     setRowIndex(rowIndex: number): void;
 }
@@ -17,7 +17,6 @@ export type HeaderRowCtrlInstanceId = BrandedType<number, 'HeaderRowCtrlInstance
 /** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
 export declare class HeaderRowCtrl extends BeanStub {
     rowIndex: number;
-    readonly pinned: ColumnPinnedType;
     readonly type: HeaderRowType;
     readonly instanceId: HeaderRowCtrlInstanceId;
     private comp;
@@ -26,7 +25,7 @@ export declare class HeaderRowCtrl extends BeanStub {
     private allCtrls;
     private isPrintLayout;
     private isEnsureDomOrder;
-    constructor(rowIndex: number, pinned: ColumnPinnedType, type: HeaderRowType);
+    constructor(rowIndex: number, type: HeaderRowType);
     setRowIndex(rowIndex: number): void;
     postConstruct(): void;
     /** Checks that every header cell that is currently visible has been rendered.
@@ -43,6 +42,7 @@ export declare class HeaderRowCtrl extends BeanStub {
     private addEventListeners;
     private onDisplayedColumnsChanged;
     private setWidth;
+    private refreshPinnedCellGroupWidths;
     private getWidthForRow;
     private onRowHeightChanged;
     getTopAndHeight(): {
@@ -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, AgColumnGroup<any> | AgColumn<any>, import("../cells/abstractCell/abstractHeaderCellCtrl").IHeaderResizeFeature>[];
+    getUpdatedHeaderCtrls(): AbstractHeaderCellCtrl<import("../../main-umd-noStyles").IAbstractHeaderCellComp, AgColumn<any> | AgColumnGroup<any>, import("../cells/abstractCell/abstractHeaderCellCtrl").IHeaderResizeFeature>[];
     /** Get the current header cell ctrls */
     getHeaderCellCtrls(): AbstractHeaderCellCtrl[];
     private recycleAndCreateHeaderCtrls;

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

@@ -2,30 +2,23 @@ import { BeanStub } from '../../context/beanStub';
 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 { AbstractHeaderCellCtrl } from '../cells/abstractCell/abstractHeaderCellCtrl';
 import type { HeaderRowType } from '../row/headerRowComp';
 import { HeaderRowCtrl } from '../row/headerRowCtrl';
 /** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
-export interface IHeaderRowContainerComp {
-    setCenterWidth(width: string): void;
+export interface IHeaderRowsComp {
     setViewportScrollLeft(left: number): void;
-    setPinnedContainerWidth(width: string): void;
-    setDisplayed(displayed: boolean): void;
     setCtrls(ctrls: HeaderRowCtrl[]): void;
 }
 /** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
 export declare class HeaderRowContainerCtrl extends BeanStub implements ScrollPartner {
-    readonly pinned: ColumnPinnedType;
-    comp: IHeaderRowContainerComp;
-    hidden: boolean;
+    comp: IHeaderRowsComp;
     private includeFloatingFilter;
     private filtersRowCtrl;
     private columnsRowCtrl;
     private groupsRowCtrls;
     eViewport: HTMLElement;
-    constructor(pinned: ColumnPinnedType);
-    setComp(comp: IHeaderRowContainerComp, eGui: HTMLElement): void;
+    setComp(comp: IHeaderRowsComp, eGui: HTMLElement, eScrollViewport?: HTMLElement): void;
     getAllCtrls(): HeaderRowCtrl[];
     refresh(keepColumns?: boolean): void;
     getHeaderCtrlForColumn(column: AgColumn | AgColumnGroup): AbstractHeaderCellCtrl | undefined;
@@ -40,5 +33,4 @@ export declare class HeaderRowContainerCtrl extends BeanStub implements ScrollPa
     destroy(): void;
     private setupDragAndDrop;
     private restoreFocusOnHeader;
-    private setupCenterWidth;
 }

package/dist/types/src/headerRendering/rowContainer/headerRowsComp.d.ts

@@ -0,0 +1,12 @@
+import { BeanStub } from '../../context/beanStub';
+export declare class HeaderRowsComp extends BeanStub {
+    private readonly eHeaderWrapper;
+    private readonly eGridViewport;
+    private readonly setHeaderRowFocusableElements;
+    private headerRowComps;
+    constructor(eHeaderWrapper: HTMLElement, eGridViewport: HTMLElement, setHeaderRowFocusableElements: (elements: HTMLElement[]) => void);
+    postConstruct(): void;
+    destroy(): void;
+    private destroyRowComp;
+    private setCtrls;
+}

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

@@ -1,4 +1,4 @@
-import type { AutoScrollService } from '../agStack/rendering/autoScrollService';
+import type { AutoScrollService } from 'ag-stack';
 import type { BeanStub } from '../context/beanStub';
 import type { AgColumn } from '../entities/agColumn';
 import type { AgColumnGroup } from '../entities/agColumnGroup';

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

@@ -1,4 +1,4 @@
-import type { IComponent } from '../agStack/interfaces/iComponent';
+import type { IComponent } from 'ag-stack';
 import type { DateFilterParams } from '../filter/provided/date/iDateFilter';
 import type { IAfterGuiAttachedParams } from '../interfaces/iAfterGuiAttachedParams';
 import type { AgGridCommon } from '../interfaces/iCommon';

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

@@ -64,13 +64,19 @@ export interface BaseExportParams {
      */
     skipPinnedBottom?: boolean;
     /**
-     * The source to use for getting cell values: 'data', 'batch', or 'edit'.
-     * - `'data'`: Returns values from the underlying row data
-     * - `'batch'`: Returns pending batch edit values (falls back to data if not in batch mode)
-     * - `'edit'`: Returns current editor values including live typing
+     * The base source to use for getting cell values.
+     * - `'data'`: values from the underlying row data
+     * - `'batch'`: pending batch edit values (falls back to data if not in batch mode)
+     * - `'edit'`: current editor values including live typing
      * @default 'data'
      */
     valueFrom?: CellValueResolveFrom;
+    /**
+     * Apply the Show Values As transform (e.g. a percentage of a total) on top of the `valueFrom` base, so the
+     * export carries the displayed value for columns with an active mode. Columns without one export the base value.
+     * @default true
+     */
+    transformValues?: boolean;
     /**
      * A callback function that will be invoked once per row in the grid. Return true to omit the row from the export.
      */
@@ -105,7 +111,7 @@ export interface ExportParams<T> extends BaseExportParams {
     /** A callback function to return content to be inserted below a row in the export. */
     getCustomContentBelowRow?: (params: ProcessRowGroupForExportParams) => T | undefined;
     /**
-     * Set to `true` to allow the contents of the Header Row Column to be exported.
+     * Set to `true` to allow the contents of the Row Numbers column to be exported.
      */
     exportRowNumbers?: boolean;
 }

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

@@ -1,5 +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';
 import type { RowNode } from '../entities/rowNode';
@@ -67,12 +66,14 @@ export interface IFormulaDataService extends Bean {
 export interface IFormulaService extends Bean {
     active: boolean;
     hasCachedRows(): boolean;
+    isEvaluationActive(): boolean;
     isFormula(value: unknown): value is `=${string}`;
-    setFormulasActive(cols: ColumnCollections): void;
+    setFormulasActive(columns: AgColumn[]): 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;
+    validateExpression(expression: string): Error | null;
     getColByRef(ref: string): AgColumn | null;
     getColRef(col: AgColumn): string | null;
     updateFormulaByOffset(params: {

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

@@ -5,6 +5,12 @@ import type { ColumnFilterState, FilterModel } from './iFilter';
 import type { RowPosition } from './iRowPosition';
 import type { SortModelItem } from './iSortModelItem';
 import type { ServerSideRowGroupSelectionState, ServerSideRowSelectionState } from './selectionState';
+/**
+ * Currently selected filters when using the new filter tool panel with `agSelectableColumnFilter`, keyed by column id.
+ */
+export interface SelectableFilterState {
+    [colId: string]: number;
+}
 export interface FilterState {
     /**
      * Filter model for Column Filters
@@ -21,9 +27,7 @@ export interface FilterState {
     /**
      * Currently selected filter when using new filter tool panel with `agSelectableColumnFilter`
      */
-    selectableFilters?: {
-        [colId: string]: number;
-    };
+    selectableFilters?: SelectableFilterState;
 }
 export interface CellSelectionCellState {
     id?: string;

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

@@ -1,6 +1,7 @@
+import type { IPinnedSectionCompHost } from './iPinnedSectionCompHost';
 /** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
 export interface IAdvancedFilterCtrl {
-    setupHeaderComp(eCompToInsertBefore: HTMLElement): void;
+    mountTopSectionComp(host: IPinnedSectionCompHost): void;
     focusHeaderComp(): boolean;
     getHeaderHeight(): number;
     toggleFilterBuilder(params: {

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

@@ -0,0 +1,12 @@
+import type { AgColumn } from '../entities/agColumn';
+import type { GridOptions } from '../entities/gridOptions';
+import type { ColumnEventType } from '../events';
+import type { PropertyChangedEvent, PropertyValueChangedEvent } from '../gridOptionsService';
+/** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
+export interface IAutoColService {
+    /** Generated auto-group columns. Flat-array — empty when no auto-cols are active. */
+    columns: AgColumn[];
+    /** Sync internal cols against current row-group state. */
+    refreshCols(source: ColumnEventType): AgColumn[] | null;
+    updateColumns(event: PropertyChangedEvent | PropertyValueChangedEvent<keyof GridOptions>): void;
+}

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

@@ -0,0 +1,61 @@
+import type { ColumnTreeBuild } from '../columns/buildColumnTree';
+import type { ColumnState } from '../columns/columnStateUtils';
+import type { Bean } from '../context/bean';
+import type { AgColumn } from '../entities/agColumn';
+import type { ColDef } from '../entities/colDef';
+import type { ColumnEventType } from '../events';
+import type { HeaderPosition } from './iHeaderPosition';
+export type CalculatedColumnExpressionPicker = 'columns' | 'functions' | 'operators';
+export type CalculatedColumnApplyMode = 'live' | 'deferred';
+export interface CalculatedColumnsOptions {
+    /**
+     * Cell data types shown in the Calculated Column dialog type selector.
+     * Values must be built-in cell data types or custom types defined in `dataTypeDefinitions`.
+     * @default ['text', 'number', 'date', 'boolean']
+     */
+    dataTypes?: string[];
+    /**
+     * Expression pickers shown in the Calculated Column dialog expression editor.
+     * @default ['columns', 'functions', 'operators']
+     */
+    expressionPickers?: CalculatedColumnExpressionPicker[] | null;
+    /**
+     * Suppress highlighting the calculated column currently being edited by the dialog.
+     * @default false
+     */
+    suppressColumnHighlighting?: boolean;
+    /**
+     * When Calculated Column dialog edits are applied: `'live'` applies every change immediately;
+     * `'deferred'` validates the expression and applies changes via Apply and Cancel buttons.
+     * @default 'live'
+     */
+    applyMode?: CalculatedColumnApplyMode;
+}
+export type CalculatedColumnsGridOption = boolean | CalculatedColumnsOptions;
+export type CalculatedColumnDef<TData = any, TValue = any> = ColDef<TData, TValue> & {
+    calculatedExpression: string;
+};
+export type CalculatedColumnUpdate<TData = any, TValue = any> = Partial<ColDef<TData, TValue>> & {
+    colId?: never;
+    calculatedExpression?: string;
+};
+export interface ICalculatedColumnsService extends Bean {
+    removeCalculatedColumn(column: AgColumn | null | undefined): void;
+    openCalculatedColumnDialog(column: AgColumn | null | undefined, mode: 'add' | 'edit', focusDialog?: boolean, restoreFocusParams?: {
+        eventSource?: HTMLElement;
+        headerPosition: HeaderPosition | null;
+    }): void;
+    /** Build hook for static (user-declared) calc cols: `null` if removed (never build), the replacement
+     *  `ColDef` if updated, `undefined` if unchanged. Applied during the build, so removed cols are never materialised. */
+    overrideFor(colDef: ColDef): ColDef | null | undefined;
+    /** Build-time dynamic calc-col hook: keep owned AgColumns alive and splice them at anchors (`overrideFor` handles static cols). */
+    contributeTo(build: ColumnTreeBuild): void;
+    /** Clear dynamic calc-col state; with `preserveCreatedColumns`, park added cols for `restoreDynamicColumnDefs`, and return whether caller must rebuild. */
+    resetDynamicColumnDefs(preserveCreatedColumns?: boolean): boolean;
+    /** Re-add parked dynamic cols referenced by `state` and return whether any were restored (caller rebuilds). */
+    restoreDynamicColumnDefs(state: ColumnState[]): boolean;
+    /** Run a suppressed rebuild after calc-col mutation so column-state ops avoid spurious calc lifecycle events. */
+    refreshDynamicColumns(source: ColumnEventType): void;
+    isEnabled(): boolean;
+    isHighlightedColumn(column: AgColumn | null): boolean;
+}

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

@@ -1,4 +1,4 @@
-import type { IPopupComponent } from '../agStack/interfaces/iPopupComponent';
+import type { IPopupComponent } from 'ag-stack';
 import type { ColDef } from '../entities/colDef';
 import type { Column } from '../interfaces/iColumn';
 import type { GetCellsParams } from './iCellsParams';

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

@@ -1,4 +1,4 @@
-import type { IComponent } from '../agStack/interfaces/iComponent';
+import type { IComponent } from 'ag-stack';
 import type { AgGridCommon } from './iCommon';
 export interface ICellEditorRendererParams<TValue = any, TData = any, TContext = any> extends AgGridCommon<TData, TContext> {
     /** The value to be rendered by the renderer */

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

@@ -1,4 +1,4 @@
-import type { AgBaseBean } from '../agStack/interfaces/agBaseBean';
+import type { AgBaseBean } from 'ag-stack';
 import type { BeanCollection } from '../context/context';
 import type { ICellComp } from '../rendering/cell/cellCtrl';
 export interface ICellStyleFeature extends AgBaseBean<BeanCollection> {

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

@@ -1,51 +1,45 @@
-import type { ColumnChangedEventType } from '../columns/columnApi';
-import type { Maybe } from '../columns/columnModel';
 import type { ColumnState, ColumnStateParams } from '../columns/columnStateUtils';
 import type { AgColumn } from '../entities/agColumn';
-import type { ColDef, ColKey, IAggFunc } from '../entities/colDef';
+import type { ColAggFunc, ColKey } from '../entities/colDef';
 import type { ColumnEventType } from '../events';
-type ColumnProcessorKeys = 'add' | 'remove' | 'set';
-export type ColumnProcessor = (column: AgColumn, added: boolean, source: ColumnEventType) => void;
-export type ColumnProcessors = Record<ColumnProcessorKeys, ColumnProcessor>;
-export type ColumnOrdering = {
-    enableProp: 'rowGroup' | 'pivot';
-    initialEnableProp: 'initialRowGroup' | 'initialPivot';
-    indexProp: 'rowGroupIndex' | 'pivotIndex';
-    initialIndexProp: 'initialRowGroupIndex' | 'initialPivotIndex';
-};
-export type ColumnExtractors = {
-    setFlagFunc: (col: AgColumn, flag: boolean, source: ColumnEventType) => void;
-    getIndexFunc: (colDef: ColDef) => number | null | undefined;
-    getInitialIndexFunc: (colDef: ColDef) => number | null | undefined;
-    getValueFunc: (colDef: ColDef) => boolean | null | undefined;
-    getInitialValueFunc: (colDef: ColDef) => boolean | undefined;
-};
-/** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
+/** `columnChanged`-family event dispatched by a cols service. @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
+export type ColumnChangedEventType = 'columnValueChanged' | 'columnPivotChanged' | 'columnRowGroupChanged';
+/** Shared base for all three cols services; service-specific ops live on sub-interfaces. @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
 export interface IColsService {
     columns: AgColumn[];
-    eventName: ColumnChangedEventType;
-    columnProcessors?: ColumnProcessors;
-    columnOrdering?: ColumnOrdering;
-    columnExtractors?: ColumnExtractors;
+    /** Cols staged since the last flush; non-null = awaiting dispatch. {@link ColumnModel.flushColChanges} */
+    readonly pendingChanged: Set<AgColumn> | null;
+    /** Dispatch this service's staged change (if any); called by {@link ColumnModel.flushColChanges}. */
+    dispatchColChange(source: ColumnEventType): void;
     setColumns(colKeys: ColKey[] | undefined, source: ColumnEventType): void;
-    addColumns(keys: Maybe<ColKey>[] | undefined, source: ColumnEventType): void;
-    removeColumns(keys: Maybe<ColKey>[] | undefined, source: ColumnEventType): void;
-    getColumnIndex(colId: string): number | undefined;
-    extractCols(source: ColumnEventType, oldProvidedCols: AgColumn[] | undefined): void;
-    syncColumnWithState(column: AgColumn, source: ColumnEventType, getValue: <U extends keyof ColumnStateParams, S extends keyof ColumnStateParams>(key1: U, key2?: S) => {
-        value1: ColumnStateParams[U] | undefined;
-        value2: ColumnStateParams[S] | undefined;
-    }, rowIndex?: {
-        [key: string]: number;
-    } | null): void;
-    sortColumns(compareFn?: (a: AgColumn, b: AgColumn) => number): void;
-    restoreColumnOrder(columnStateAccumulator: {
-        [colId: string]: ColumnState;
-    }, incomingColumnState: {
+    addColumns(keys: (ColKey | null | undefined)[] | undefined, source: ColumnEventType): void;
+    removeColumns(keys: (ColKey | null | undefined)[] | undefined, source: ColumnEventType): void;
+    /** Recompute active cols with a shared scan: call {@link extractCol} per primary col, then finalise via {@link commitExtract}. */
+    extractCol(col: AgColumn, colIsNew: boolean): void;
+    commitExtract(source: ColumnEventType): void;
+    syncColState(column: AgColumn, stateItem: ColumnState | null, defaultState: ColumnStateParams | undefined, source: ColumnEventType): void;
+}
+/** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time.  */
+export interface IOrderedColsService extends IColsService {
+    /** Assigns synthetic indexes to `incoming` and adds new entries to `accumulator`; both mutated. */
+    restoreColumnOrder(incoming: {
         [colId: string]: ColumnState;
-    }): {
+    }, accumulator: {
         [colId: string]: ColumnState;
-    };
-    setColumnAggFunc?(key: ColKey | undefined, aggFunc: string | IAggFunc | null | undefined, source: ColumnEventType): void;
+    }): void;
+    sortByPendingState(): void;
+}
+/** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time.  */
+export interface IRowGroupColsService extends IOrderedColsService {
+    moveColumn(fromIndex: number, toIndex: number, source: ColumnEventType): void;
+}
+/** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time.  */
+export interface IPivotColsService extends IOrderedColsService {
+    isStrictColumnOrder(): boolean;
+}
+/** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time.  */
+export interface IValueColsService extends IColsService {
+    setColumnAggFunc(key: ColKey | undefined, aggFunc: ColAggFunc, source: ColumnEventType): void;
+    /** Re-order active value cols by the `valueIndex` recorded during the last `syncColState` pass. */
+    sortByPendingState(): void;
 }
-export {};

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

@@ -1,8 +1,10 @@
-import type { IEventEmitter } from '../agStack/interfaces/iEventEmitter';
+import type { IEventEmitter } from 'ag-stack';
 import type { AgProvidedColumnGroupEvent } from '../entities/agProvidedColumnGroup';
-import type { AbstractColDef, ColDef, ColGroupDef, IAggFunc, SortDef, SortDirection } from '../entities/colDef';
+import type { AbstractColDef, ColAggFunc, ColDef, ColGroupDef, HeaderLocation } from '../entities/colDef';
+import type { ShowValuesAsDefResolved, ShowValuesAsResolved, ShowValuesAsResult } from '../entities/colDef-showValuesAs';
 import type { ColumnEvent } from '../events';
 import type { BrandedType } from '../interfaces/brandedType';
+import type { SortDef, SortDirection } from '../interfaces/iSort';
 import type { IRowNode } from './iRowNode';
 export type HeaderColumnId = BrandedType<string, 'HeaderColumnId'>;
 interface IHeaderColumn<TValue, TEventType extends string> extends IEventEmitter<TEventType> {
@@ -119,7 +121,14 @@ export interface Column<TValue = any> extends IHeaderColumn<TValue, ColumnEventN
     /** Returns the sort index for this column. */
     getSortIndex(): number | null | undefined;
     /** If aggregation is set for the column, returns the aggregation function. */
-    getAggFunc(): string | IAggFunc | null | undefined;
+    getAggFunc(): ColAggFunc;
+    /** The active "Show Values As" mode for the column (`.type` is the mode name), or `null` if none.
+     *  `TOut` is the transformed output type. The available modes are on {@link getShowValuesAsDef}. */
+    getShowValuesAs<TOut extends ShowValuesAsResult = any>(): ShowValuesAsResolved<any, TValue, TOut> | null;
+    /** The column's resolved "Show Values As" config — every available mode plus the default precision — or
+     *  `null` if the column has none. Not parameterised by output type: each mode has its own. The active mode
+     *  is {@link getShowValuesAs}. */
+    getShowValuesAsDef(): ShowValuesAsDefResolved<any, TValue> | null;
     /** @deprecated v32 Use col.getLeft() + col.getActualWidth() instead. */
     getRight(): number;
     /** Returns `true` if filter is active on the column. */
@@ -154,6 +163,9 @@ export interface Column<TValue = any> extends IHeaderColumn<TValue, ColumnEventN
      *
      * Equivalent: `getId`, `getUniqueId` */
     getColId(): string;
+    /** Returns this column's resolved display name — the header text after any `headerValueGetter` / locale
+     *  resolution for `location` (default `'columnDrop'`), falling back to the colDef `headerName`, then the colId. */
+    getDisplayName(location?: HeaderLocation): string;
     /** Returns the auto header height. */
     getAutoHeaderHeight(): number | null;
     /** Returns the column span for this column and row node. */
@@ -192,6 +204,9 @@ export type AgColumnGroupEvent = 'leftChanged' | 'displayedChildrenChanged';
 export interface ColumnGroup<TValue = any> extends IHeaderColumn<TValue, AgColumnGroupEvent> {
     /** Returns the group column id. */
     getGroupId(): string;
+    /** Returns this group's resolved display name for `location` (default `'columnDrop'`), falling back to the
+     *  colGroupDef `headerName`, then the group id. */
+    getDisplayName(location?: HeaderLocation): string;
     /** @deprecated v32 Internal method no longer to be exposed on Column interface. */
     getPartId(): number;
     /** Returns `true` if this group is resizable. */

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

@@ -1,7 +1,8 @@
 import type { ColumnState } from '../columns/columnStateUtils';
 import type { AgColumn } from '../entities/agColumn';
-import type { IAggFunc, SortDef } from '../entities/colDef';
+import type { ColAggFunc } from '../entities/colDef';
 import type { ColumnEventType } from '../events';
+import type { SortDef } from '../interfaces/iSort';
 /** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
 export interface IColumnStateUpdateStrategy {
     applyColumnState(deferMode: boolean, state: ColumnState[], eventType: ColumnEventType): void;
@@ -17,8 +18,8 @@ export interface IColumnStateUpdateStrategy {
     hasDeferredColumnOrder(deferMode: boolean): boolean;
     setValueColumns(deferMode: boolean, columns: AgColumn[], eventType: ColumnEventType): void;
     getValueColumns(deferMode: boolean): AgColumn[];
-    setColumnAggFunc(deferMode: boolean, column: AgColumn, aggFunc: string | IAggFunc | null | undefined, eventType: ColumnEventType): void;
-    getColumnAggFunc(deferMode: boolean, column: AgColumn): string | IAggFunc | null | undefined;
+    setColumnAggFunc(deferMode: boolean, column: AgColumn, aggFunc: ColAggFunc, eventType: ColumnEventType): void;
+    getColumnAggFunc(deferMode: boolean, column: AgColumn): ColAggFunc;
     setPivotColumns(deferMode: boolean, columns: AgColumn[], eventType: ColumnEventType): void;
     getPivotColumns(deferMode: boolean): AgColumn[];
     setPivotMode(deferMode: boolean, pivotMode: boolean, eventType: ColumnEventType): void;

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

@@ -13,7 +13,7 @@ export interface IContextMenuService {
     showContextMenu(params: EventShowContextMenuParams & {
         anchorToElement?: HTMLElement;
     }): void;
-    handleContextMenuMouseEvent(mouseEvent: MouseEvent | undefined, touchEvent: TouchEvent | undefined, rowComp: RowCtrl | null, cellCtrl: CellCtrl): void;
+    handleContextMenuMouseEvent(mouseEvent: MouseEvent | undefined, touchEvent: TouchEvent | undefined, rowComp: RowCtrl | null, cellCtrl: CellCtrl | null): void;
 }
 export interface ShowContextMenuParams {
     /** The row node associated with the Context Menu */

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

@@ -4,10 +4,10 @@ export type EditInputEvents = KeyboardEvent | MouseEvent | null | undefined;
 export type EditNavOnValidationResult = 'block-stop' | 'revert-continue' | 'continue';
 export type EditSource = 'api' | 'ui' | 'paste' | 'rangeSvc' | 'fillHandle' | 'cellClear' | 'edit' | 'bulk';
 /**
- * Specifies how to resolve the cell value when edits are pending.
- * - `'edit'`: Returns the current editing value, including live editor typing and pending batch values. This is the default value.
- * - `'batch'`: Returns pending batch values but excludes live editor typing (useful for dependent calculations in valueGetters)
- * - `'data'`: Returns the actual stored data value, ignoring all edit state
+ * How to resolve a cell's raw value when edits are pending.
+ * - `'edit'`: the current editing value, including live editor typing and pending batch values (the default).
+ * - `'batch'`: pending batch values but excluding live editor typing (useful for dependent valueGetters).
+ * - `'data'`: the stored data value, ignoring all edit state.
  */
 export type CellValueResolveFrom = 'edit' | 'batch' | 'data';
 export interface StartEditWithPositionParams extends StartEditParams {

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

@@ -1,4 +1,4 @@
-import type { AgEventService } from '../agStack/interfaces/iEvent';
+import type { AgEventService } from 'ag-stack';
 import type { AgEventTypeParams } from '../events';
 import type { AgGridCommon } from './iCommon';
 /** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */

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

@@ -0,0 +1,9 @@
+import type { AgGridCommon } from './iCommon';
+export interface ProcessFileInputParams<TData = any, TContext = any> extends AgGridCommon<TData, TContext> {
+    /** The files received via drag-and-drop or file browser on the File Input Overlay. */
+    files: File[];
+    /** Call with parsed row data to load it into the grid. */
+    success(rowData: TData[]): void;
+    /** Call to show the error state in the overlay. Optionally provide a custom `errorMessage` to be displayed in the File Input Overlay. */
+    fail(errorMessage?: string): void;
+}

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

@@ -1,5 +1,4 @@
-import type { IComponent } from '../agStack/interfaces/iComponent';
-import type { AgPromise } from '../agStack/utils/promise';
+import type { AgPromise, IComponent } from 'ag-stack';
 import type { ColDef, ColKey } from '../entities/colDef';
 import type { IFloatingFilterComp } from '../filter/floating/floatingFilter';
 import type { Column } from '../interfaces/iColumn';

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

@@ -1,9 +1,10 @@
 import type { RowNode } from '../entities/rowNode';
 import type { Column } from './iColumn';
+import type { VerticalSection } from './iGridSection';
 import type { IRowNode } from './iRowNode';
 /** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
 export interface IFooterService {
-    addTotalRows(startIndex: number, node: RowNode, callback: (node: RowNode, index: number) => void, includeFooterNodes: boolean, isRootNode: boolean, position: 'top' | 'bottom'): number;
+    addTotalRows(startIndex: number, node: RowNode, callback: (node: RowNode, index: number) => void, includeFooterNodes: boolean, isRootNode: boolean, position: VerticalSection): number;
     getTopDisplayIndex(rowsToDisplay: RowNode[], topLevelIndex: number, childrenAfterSort: RowNode[], getDefaultIndex: (adjustedIndex: number) => number): number;
     getTotalValue(value: any): string;
     doesCellShowTotalPrefix(node: IRowNode, col?: Column): boolean;

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

@@ -1,5 +1,4 @@
-import type { LocalEventService } from '../agStack/events/localEventService';
-import type { AgFrameworkOverrides } from '../agStack/interfaces/agFrameworkOverrides';
+import type { AgFrameworkOverrides, LocalEventService } from 'ag-stack';
 import type { IFrameworkEventListenerService } from './iFrameworkEventListenerService';
 /** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
 export interface IFrameworkOverrides extends AgFrameworkOverrides {

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

@@ -0,0 +1,8 @@
+/** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
+export type HorizontalSection = 'left' | 'center' | 'right';
+/** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
+export type HorizontalSectionMap<T> = Record<HorizontalSection, T>;
+/** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
+export type VerticalSection = 'top' | 'bottom';
+/** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
+export type VerticalSectionMap<T> = Record<VerticalSection, T>;