ag-grid-community 35.3.0 → 36.0.0

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

@@ -1,23 +1,13 @@
+import type { ColumnTreeBuild } from '../columns/buildColumnTree';
 import type { AgColumn } from '../entities/agColumn';
-import type { IColumnCollectionService } from './iColumnCollectionService';
 /** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
-export interface IGroupHierarchyColService extends IColumnCollectionService {
-    /**
-     * Mutates the `target` parameter, adding any virtual columns associated with the given source column, as well as the source column itself (last in the array)
-     */
-    expandColumnInto(target: AgColumn[], col: AgColumn): void;
-    /**
-     * Mutates the `columns` parameter, adding any virtual columns associated with the given source column, _not_ including the source column itself.
-     * Returns the virtual columns added.
-     */
-    insertVirtualColumnsForCol(columns: AgColumn[], col: AgColumn): AgColumn[];
-    /**
-     * If both arguments are virtural columns with the same source column, we use the same
-     * order in which they are added.
-     *
-     * If one column is a virtual column and the other its source column, the virtual column is sorted first.
-     *
-     * Otherwise, we defer sorting to the caller.
-     */
+export interface IGroupHierarchyColService {
+    /** Generated hierarchy columns flat-array. Empty when no hierarchy is in use. */
+    columns: AgColumn[];
+    /** Recompute hierarchy cols and prepend them to the tree via the builder. No-op when none active. */
+    contributeTo(build: ColumnTreeBuild): void;
+    /** This source col's generated virtuals, in order (seated before it); undefined if none. */
+    getVirtualCols(sourceCol: AgColumn): AgColumn[] | undefined;
+    /** Sibling virtuals rank by insertion order; a virtual sorts before its own source; else null (caller decides). */
     compareVirtualColumns(colA: AgColumn, colB: AgColumn): number | null;
 }

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

@@ -1,5 +1,5 @@
-import type { IComponent } from '../agStack/interfaces/iComponent';
-import type { SortDef, SortDirection } from '../entities/colDef';
+import type { IComponent } from 'ag-stack';
+import type { SortDef, SortDirection } from '../interfaces/iSort';
 import type { Column } from './iColumn';
 import type { AgGridCommon } from './iCommon';
 export interface IHeaderParams<TData = any, TContext = any> extends AgGridCommon<TData, TContext> {

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

@@ -1,4 +1,4 @@
-import type { IComponent } from '../agStack/interfaces/iComponent';
+import type { IComponent } from 'ag-stack';
 import type { ICellRendererParams } from '../rendering/cellRenderers/iCellRenderer';
 export interface ILoadingCellRendererParams<TData = any, TValue = any, TContext = any> extends ICellRendererParams<TData, TValue, TContext> {
     /**

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

@@ -1,5 +1,4 @@
-import type { ClassImp } from '../agStack/interfaces/iContext';
-import type { IconValue } from '../agStack/interfaces/iIcon';
+import type { ClassImp, IconValue } from 'ag-stack';
 import type { GridApi } from '../api/gridApi';
 import type { ApiFunction, ApiFunctionName } from '../api/iApiFunction';
 import type { ComponentMeta, DynamicBeanName, SingletonBean, UserComponentName } from '../context/context';
@@ -68,10 +67,10 @@ export type _ModuleWithLicenseManager = {
     setLicenseKey: (licenseKey: string) => void;
 };
 type InternalModuleName = 'Aggregation' | 'AnimationFrame' | 'Aria' | 'AutoWidth' | 'CellRendererFunction' | 'ChangedPath' | 'ChangeDetection' | 'CheckboxCellRenderer' | 'CsrmFilter' | 'CsrmHierarchy' | 'CsrmGroupStages' | 'ColumnDelayRender' | 'ColumnFilter' | 'ColumnFlex' | 'ColumnGroupHeaderComp' | 'ColumnGroup' | 'ColumnHeaderComp' | 'ColumnMove' | 'ColumnResize' | 'CommunityCore' | 'CsrmSsrmSharedApi' | 'RowModelSharedApi' | 'DataType' | 'Drag' | 'EditCore' | 'EnterpriseCore' | 'Expression' | 'FilterCore' | 'FilterValue' | 'FindCore' | 'GroupEdit' | 'GroupCellRenderer' | 'GroupColumn' | 'GroupHierarchy' | 'HorizontalResize' | 'InfiniteRowModelCore' | 'KeyboardNavigation' | 'LoadingCellRenderer' | 'MenuCore' | 'MenuItem' | 'Overlay' | 'PinnedColumn' | 'Popup' | 'QuickFilterCore' | 'SharedAggregation' | 'SharedColumnStateUpdateStrategy' | 'SharedDragAndDrop' | 'SharedExport' | 'SharedMasterDetail' | 'SharedMenu' | 'SharedPivot' | 'SharedRowGrouping' | 'SharedRowSelection' | 'SharedTreeData' | 'SideBarShared' | 'SkeletonCellRenderer' | 'Sort' | 'SsrmInfiniteSharedApi' | 'StickyRow' | 'Touch' | 'Testing';
-export type CommunityModuleName = 'AlignedGrids' | 'AllCommunity' | 'CellApi' | 'CellStyle' | 'CheckboxEditor' | 'ClientSideRowModelApi' | 'ClientSideRowModel' | 'ColumnApi' | 'ColumnAutoSize' | 'ColumnHover' | 'CsvExport' | 'CustomEditor' | 'CustomFilter' | 'DateEditor' | 'DateFilter' | 'DragAndDrop' | 'EventApi' | 'ExternalFilter' | 'GridState' | 'HighlightChanges' | 'InfiniteRowModel' | 'LargeTextEditor' | 'Locale' | 'NumberEditor' | 'NumberFilter' | 'BigIntFilter' | 'Pagination' | 'PinnedRow' | 'QuickFilter' | 'RenderApi' | 'RowApi' | 'RowAutoHeight' | 'RowDrag' | 'RowSelection' | 'RowStyle' | 'ScrollApi' | 'SelectEditor' | 'TextEditor' | 'TextFilter' | 'Tooltip' | 'UndoRedoEdit' | 'Validation' | 'ValueCache' | 'CellSpan';
-export type EnterpriseModuleName = 'AdvancedFilter' | 'AiToolkit' | 'AllEnterprise' | 'BatchEdit' | 'CellSelection' | 'Clipboard' | 'ColumnMenu' | 'ColumnsToolPanel' | 'ContextMenu' | 'ExcelExport' | 'FiltersToolPanel' | 'Find' | 'GridCharts' | 'IntegratedCharts' | 'GroupFilter' | 'MasterDetail' | 'Menu' | 'MultiFilter' | 'NewFiltersToolPanel' | 'Pivot' | 'RangeSelection' | 'RichSelect' | 'RowNumbers' | 'RowGrouping' | 'RowGroupingPanel' | 'ServerSideRowModelApi' | 'ServerSideRowModel' | 'SetFilter' | 'SideBar' | 'Sparklines' | 'StatusBar' | 'Toolbar' | 'TreeData' | 'ViewportRowModel' | 'Formula' | 'Notes' | 'RowGroupingEdit';
+export type CommunityModuleName = 'AlignedGrids' | 'AllCommunity' | 'AutoGenerateColumns' | 'CellApi' | 'CellStyle' | 'CheckboxEditor' | 'ClientSideRowModelApi' | 'ClientSideRowModel' | 'ColumnApi' | 'ColumnAutoSize' | 'ColumnHover' | 'CsvExport' | 'CustomEditor' | 'CustomFilter' | 'DateEditor' | 'DateFilter' | 'DragAndDrop' | 'EventApi' | 'ExternalFilter' | 'FileInputOverlay' | 'GridState' | 'HighlightChanges' | 'InfiniteRowModel' | 'LargeTextEditor' | 'Locale' | 'NumberEditor' | 'NumberFilter' | 'BigIntFilter' | 'Pagination' | 'PinnedRow' | 'QuickFilter' | 'RenderApi' | 'RowApi' | 'RowAutoHeight' | 'RowDrag' | 'RowSelection' | 'RowStyle' | 'ScrollApi' | 'SelectEditor' | 'TextEditor' | 'TextFilter' | 'Tooltip' | 'UndoRedoEdit' | 'Validation' | 'ValueCache' | 'CellSpan';
+export type EnterpriseModuleName = 'AdvancedFilter' | 'AiToolkit' | 'AllEnterprise' | 'BatchEdit' | 'CalculatedColumns' | 'CellSelection' | 'Clipboard' | 'ColumnMenu' | 'ColumnsToolPanel' | 'ContextMenu' | 'ExcelExport' | 'FiltersToolPanel' | 'Find' | 'GridCharts' | 'IntegratedCharts' | 'GroupFilter' | 'MasterDetail' | 'Menu' | 'MultiFilter' | 'NewFiltersToolPanel' | 'Pivot' | 'RangeSelection' | 'RichSelect' | 'RowNumbers' | 'RowGrouping' | 'RowGroupingPanel' | 'ServerSideRowModelApi' | 'ServerSideRowModel' | 'SetFilter' | 'ShowValuesAs' | 'SideBar' | 'Sparklines' | 'StatusBar' | 'Toolbar' | 'TreeData' | 'ViewportRowModel' | 'Formula' | 'Notes' | 'RowGroupingEdit';
 /** The names of all publicly available AG Grid modules */
-export type AgModuleName = 'AiToolkitModule' | 'AlignedGridsModule' | 'AllCommunityModule' | 'CellApiModule' | 'CellStyleModule' | 'CheckboxEditorModule' | 'ClientSideRowModelApiModule' | 'ClientSideRowModelModule' | 'ColumnApiModule' | 'ColumnAutoSizeModule' | 'ColumnHoverModule' | 'CsvExportModule' | 'CustomEditorModule' | 'CustomFilterModule' | 'DateEditorModule' | 'DateFilterModule' | 'DragAndDropModule' | 'EventApiModule' | 'ExternalFilterModule' | 'GridStateModule' | 'RowGroupingEditModule' | 'HighlightChangesModule' | 'InfiniteRowModelModule' | 'LargeTextEditorModule' | 'LocaleModule' | 'NumberEditorModule' | 'NumberFilterModule' | 'BigIntFilterModule' | 'PaginationModule' | 'PinnedRowModule' | 'QuickFilterModule' | 'RenderApiModule' | 'RowApiModule' | 'RowAutoHeightModule' | 'RowDragModule' | 'RowSelectionModule' | 'RowStyleModule' | 'ScrollApiModule' | 'SelectEditorModule' | 'TextEditorModule' | 'TextFilterModule' | 'TooltipModule' | 'UndoRedoEditModule' | 'ValidationModule' | 'ValueCacheModule' | 'CellSpanModule' | 'AdvancedFilterModule' | 'AllEnterpriseModule' | 'BatchEditModule' | 'CellSelectionModule' | 'ClipboardModule' | 'ColumnMenuModule' | 'ColumnsToolPanelModule' | 'ContextMenuModule' | 'ExcelExportModule' | 'FiltersToolPanelModule' | 'FindModule' | 'GridChartsModule' | 'IntegratedChartsModule' | 'GroupFilterModule' | 'MasterDetailModule' | 'MenuModule' | 'MultiFilterModule' | 'NewFiltersToolPanelModule' | 'PivotModule' | 'RangeSelectionModule' | 'RichSelectModule' | 'RowNumbersModule' | 'RowGroupingModule' | 'RowGroupingPanelModule' | 'ServerSideRowModelApiModule' | 'ServerSideRowModelModule' | 'SetFilterModule' | 'SideBarModule' | 'SparklinesModule' | 'StatusBarModule' | 'ToolbarModule' | 'TreeDataModule' | 'ViewportRowModelModule' | 'FormulaModule' | 'NotesModule';
+export type AgModuleName = 'AiToolkitModule' | 'AlignedGridsModule' | 'AllCommunityModule' | 'AutoGenerateColumnsModule' | 'CellApiModule' | 'CellStyleModule' | 'CheckboxEditorModule' | 'ClientSideRowModelApiModule' | 'ClientSideRowModelModule' | 'ColumnApiModule' | 'ColumnAutoSizeModule' | 'ColumnHoverModule' | 'CsvExportModule' | 'CustomEditorModule' | 'CustomFilterModule' | 'DateEditorModule' | 'DateFilterModule' | 'DragAndDropModule' | 'EventApiModule' | 'ExternalFilterModule' | 'FileInputOverlayModule' | 'GridStateModule' | 'RowGroupingEditModule' | 'HighlightChangesModule' | 'InfiniteRowModelModule' | 'LargeTextEditorModule' | 'LocaleModule' | 'NumberEditorModule' | 'NumberFilterModule' | 'BigIntFilterModule' | 'PaginationModule' | 'PinnedRowModule' | 'QuickFilterModule' | 'RenderApiModule' | 'RowApiModule' | 'RowAutoHeightModule' | 'RowDragModule' | 'RowSelectionModule' | 'RowStyleModule' | 'ScrollApiModule' | 'SelectEditorModule' | 'TextEditorModule' | 'TextFilterModule' | 'TooltipModule' | 'UndoRedoEditModule' | 'ValidationModule' | 'ValueCacheModule' | 'CellSpanModule' | 'AdvancedFilterModule' | 'AllEnterpriseModule' | 'BatchEditModule' | 'CalculatedColumnsModule' | 'CellSelectionModule' | 'ClipboardModule' | 'ColumnMenuModule' | 'ColumnsToolPanelModule' | 'ContextMenuModule' | 'ExcelExportModule' | 'FiltersToolPanelModule' | 'FindModule' | 'GridChartsModule' | 'IntegratedChartsModule' | 'GroupFilterModule' | 'MasterDetailModule' | 'MenuModule' | 'MultiFilterModule' | 'NewFiltersToolPanelModule' | 'PivotModule' | 'RangeSelectionModule' | 'RichSelectModule' | 'RowNumbersModule' | 'RowGroupingModule' | 'RowGroupingPanelModule' | 'ServerSideRowModelApiModule' | 'ServerSideRowModelModule' | 'SetFilterModule' | 'ShowValuesAsModule' | 'SideBarModule' | 'SparklinesModule' | 'StatusBarModule' | 'ToolbarModule' | 'TreeDataModule' | 'ViewportRowModelModule' | 'FormulaModule' | 'NotesModule';
 /**
  * INTERNAL: All public and internal module names
  * @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time.

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

@@ -1,4 +1,4 @@
-import type { AgPromise } from '../agStack/utils/promise';
+import type { AgPromise } from 'ag-stack';
 import type { ValueGetterFunc } from '../entities/colDef';
 import type { IProvidedFilter, ProvidedFilterModel } from '../filter/provided/iProvidedFilter';
 import type { ColumnFilter, IFilter, IFilterComp, IFilterDef, IFilterParams, IFilterType, IFloatingFilterType } from './iFilter';

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

@@ -1,7 +1,7 @@
-import type { IEventEmitter } from '../agStack/interfaces/iEventEmitter';
+import type { IEventEmitter } from 'ag-stack';
 import type { AgColumn } from '../entities/agColumn';
 import type { ValueGetterFunc } from '../entities/colDef';
-import type { NewFiltersToolPanelState } from './gridState';
+import type { NewFiltersToolPanelState, SelectableFilterState } from './gridState';
 import type { IAfterGuiAttachedParams } from './iAfterGuiAttachedParams';
 import type { FilterAction, FilterWrapperParams, IFilterDef } from './iFilter';
 import type { IToolPanel, IToolPanelNewFiltersCompParams } from './iToolPanel';
@@ -95,11 +95,7 @@ export interface ISelectableFilterService extends IEventEmitter<'selectedFilterC
     } | undefined;
     setActive(colId: string, filterDefs: SelectableFilterDef[], activeFilterDef: SelectableFilterDef): void;
     clearActive(colId: string): void;
-    getState(): {
-        [colId: string]: number;
-    };
-    setState(state: {
-        [colId: string]: number;
-    }): void;
+    getState(): SelectableFilterState | undefined;
+    setState(state: SelectableFilterState | undefined): void;
 }
 export {};

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

@@ -0,0 +1,5 @@
+/** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
+export interface IPinnedSectionCompHost {
+    mountComp(eGui: HTMLElement): void;
+    unmountComp(eGui: HTMLElement): void;
+}

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

@@ -1,15 +1,35 @@
-import type { ColumnCollections } from '../columns/columnModel';
 import type { AgColumn } from '../entities/agColumn';
+import type { AgProvidedColumnGroup } from '../entities/agProvidedColumnGroup';
 import type { ColDef, ColGroupDef, ColKey } from '../entities/colDef';
 import type { ColumnEventType } from '../events';
-/** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
+/** Owns pivot result column lifecycle (create/retain/teardown).
+ *  @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
 export interface IPivotResultColsService {
-    isPivotResultColsPresent(): boolean;
+    /** Generated pivot result leaf columns. Null when not pivoting. */
+    readonly pivotCols: AgColumn[] | null;
+    /** Balanced-tree wrappers around `pivotCols`. Empty when not pivoting. */
+    readonly pivotTree: (AgColumn | AgProvidedColumnGroup)[];
+    /** Tree depth of `pivotTree` (max group nesting). */
+    readonly pivotTreeDepth: number;
+    /** True iff any `pivotTree` group has `marryChildren`.
+     *  Feeds `ColumnModel.hasMarryChildren` while pivoting. */
+    readonly pivotHasMarryChildren: boolean;
+    /** Non-padding `pivotTree` groups keyed by `groupId`.
+     *  Feeds `ColumnModel.colsGroupsById` while pivoting. */
+    readonly pivotGroupsById: Map<string, AgProvidedColumnGroup>;
+    /** Flat list of all `pivotTree` groups (padding and non-padding).
+     *  Feeds `ColumnModel.colsAllGroups` while pivoting. */
+    readonly pivotAllGroups: AgProvidedColumnGroup[];
+    /** Build pivoting column-state order as parked primaries (`colsById` not `colsList`) first.
+     *  Then append displayed cols; return `colsList` directly when none are parked. */
+    buildColsInStateOrder(): AgColumn[];
+    buildAllCols(): AgColumn[];
     lookupPivotResultCol(pivotKeys: string[], valueColKey: ColKey): AgColumn | null;
-    getPivotResultCols(): ColumnCollections | null;
-    getPivotResultCol(key: ColKey): AgColumn | null;
     setPivotResultCols(colDefs: (ColDef | ColGroupDef)[] | null, source: ColumnEventType): void;
-    /** Returns pivot result columns ordered for aggregation: regular columns first, total columns after.
-     * Cached — only recomputed when pivot result columns change. */
+    /** Return aggregation order for pivot result cols (regular first, totals after).
+     *  Cache until pivot result cols change. */
     getAggregationOrderedList(): AgColumn[] | null;
+    /** Rebuild `colDef`s for pivot result cols whose `pivotValueColumn` is `sourceCol` via reverse-map lookup.
+     *  No-op when not pivoting. */
+    recreateColDefsForSource(sourceCol: AgColumn, source: ColumnEventType): void;
 }

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

@@ -1,4 +1,4 @@
-import type { AgPickerFieldParams } from '../agStack/widgets/agPickerFieldParams';
+import type { AgPickerFieldParams } from '../agWidgets/agPickerFieldParams';
 import type { AgComponentSelectorType } from '../widgets/component';
 import type { ICellEditorParamsShared } from './iCellEditor';
 import type { ICellEditorRendererParams } from './iCellEditorRenderer';

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

@@ -1,9 +1,9 @@
-import type { AgEvent } from '../agStack/interfaces/agEvent';
+import type { AgEvent } from 'ag-stack';
 import type { ColKey, IAggFuncResult } from '../entities/colDef';
 import type { BuildEventTypeMap } from '../eventTypes';
 import type { SelectionEventSourceType } from '../events';
 import type { Column } from '../interfaces/iColumn';
-import type { CellValueResolveFrom } from '../interfaces/iEditService';
+import type { CellValueResolveFrom } from './iEditService';
 /**
  * Specifies how to resolve the value returned by `rowNode.getDataValue()`.
  *
@@ -13,8 +13,11 @@ import type { CellValueResolveFrom } from '../interfaces/iEditService';
  * - `'value'` — Same as `'data'`, but aggregation wrappers are resolved to their scalar value.
  * - `'edit'` — Live editor value if a cell is being edited, then pending batch value, then committed data.
  * - `'batch'` — Pending batch value (excludes live editor typing), then committed data.
+ * - `'transformed'` — The `showValuesAs` transformed value (e.g. a percentage of a total). This is the only
+ *   mode that reflects `showValuesAs`: every other mode returns the raw value and type unchanged, whether or
+ *   not the column has a `showValuesAs` mode. Falls back to the raw value when the column has no such mode.
  */
-export type DataValueFrom = 'data' | 'data-raw' | 'value' | CellValueResolveFrom;
+export type DataValueFrom = 'data-raw' | 'value' | 'transformed' | CellValueResolveFrom;
 export type RowNodeEventType = 'rowSelected' | 'rowPinned' | 'selectableChanged' | 'displayedChanged' | 'dataChanged' | 'cellChanged' | 'masterChanged' | 'heightChanged' | 'topChanged' | 'groupChanged' | 'allChildrenCountChanged' | 'firstChildChanged' | 'lastChildChanged' | 'childIndexChanged' | 'rowIndexChanged' | 'expandedChanged' | 'hasChildrenChanged' | 'uiLevelChanged' | 'rowHighlightChanged' | 'mouseEnter' | 'mouseLeave' | 'draggingChanged';
 type RowNodeEventTypeMap<TData = any> = BuildEventTypeMap<RowNodeEventType, {
     rowSelected: RowNodeSelectedEvent<TData>;

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

@@ -24,6 +24,9 @@ export interface IRowNodePivotStage<TData = any> extends IRowNodeStage<TData> {
 /** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
 export interface IRowNodeAggregationStage<TData = any> extends IRowNodeStage<TData> {
     execute(changedPath: ChangedPath | undefined): void;
+    /** Re-aggregates only the root node, leaving group aggregates untouched — for when a feature needs the root
+     *  total switched on without the cost of a full re-aggregation (the groups are already correct). */
+    aggregateRootOnly(): void;
 }
 /** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
 export interface IRowNodeFilterAggregateStage<TData = any> extends IRowNodeStage<TData> {
@@ -39,6 +42,10 @@ export type NestedDataGetter<TData = any> = (data: TData) => TData[] | null | un
 export interface IRowNodeGroupStage<TData = any> extends IRowNodeStage<TData> {
     readonly treeData: boolean;
     readonly grouping: boolean;
+    /** Whether the TreeData / RowGrouping module is registered — lets callers distinguish "not available"
+     *  (undefined) from "available but inactive" (false). */
+    readonly hasTreeData: boolean;
+    readonly hasRowGrouping: boolean;
     execute(params: RefreshModelParams<TData>): boolean | undefined;
     getNestedDataGetter(): NestedDataGetter<TData> | null | undefined;
     onPropChange(changedProps: ReadonlySet<keyof GridOptions<any>>): boolean;

package/dist/types/src/interfaces/iRowStyleFeature.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';
 export interface IRowStyleFeature extends AgBaseBean<BeanCollection> {
     applyRowStyles(): void;

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

@@ -3,7 +3,7 @@ import type { AgColumn } from '../entities/agColumn';
 import type { GridOptions, SelectAllMode } from '../entities/gridOptions';
 import type { RowNode } from '../entities/rowNode';
 import type { SelectionEventSourceType } from '../events';
-import type { RowCtrl, RowGui } from '../rendering/row/rowCtrl';
+import type { RowCtrl } from '../rendering/row/rowCtrl';
 import type { CheckboxSelectionComponent } from '../selection/checkboxSelectionComponent';
 import type { SelectAllFeature } from '../selection/selectAllFeature';
 import type { ChangedPath } from '../utils/changedPath';
@@ -19,7 +19,7 @@ export interface ISelectionService {
     setNodesSelected(params: ISetNodesSelectedParams): number;
     filterFromSelection?(predicate: (node: RowNode) => boolean): void;
     /** Should only be called if groupSelects = 'descendants' or 'filteredDescendants' in CSRM */
-    updateGroupsFromChildrenSelections?(source: SelectionEventSourceType, changedPath?: ChangedPath): boolean;
+    updateGroupsFromChildrenSelections?(source: SelectionEventSourceType, changedPath?: ChangedPath, event?: Event): boolean;
     syncInRowNode(rowNode: RowNode, oldNode?: RowNode): void;
     reset(source: SelectionEventSourceType): void;
     getBestCostNodeSelection(): RowNode[] | undefined;
@@ -40,7 +40,7 @@ export interface ISelectionService {
     }): void;
     createCheckboxSelectionComponent(): CheckboxSelectionComponent;
     createSelectAllFeature(column: AgColumn): SelectAllFeature | undefined;
-    onRowCtrlSelected(rowCtrl: RowCtrl, hasFocusFunc: (gui: RowGui) => void, gui?: RowGui): void;
+    onRowCtrlSelected(rowCtrl: RowCtrl, hasFocusFunc: () => void): void;
     announceAriaRowSelection(rowNode: RowNode): void;
     /** Called after grouping / treeData */
     updateSelectableAfterGrouping(changedPath: ChangedPath | undefined): void;

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

@@ -1,4 +1,4 @@
-import type { AgPromise } from '../agStack/utils/promise';
+import type { AgPromise } from 'ag-stack';
 import type { ColDef, KeyCreatorParams, ValueFormatterParams } from '../entities/colDef';
 import type { FilterUiChangedEvent } from '../events';
 import type { IProvidedFilter, IProvidedFilterParams, ProvidedFilterModel } from '../filter/provided/iProvidedFilter';

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

@@ -1,9 +1,12 @@
 import type { AgColumn } from '../entities/agColumn';
+import type { SortDirection } from './iSort';
 /** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
 export interface IShowRowGroupColsService {
     readonly columns: AgColumn[];
     refresh(): void;
-    getShowRowGroupCol(id: string): AgColumn | undefined;
     getSourceColumnsForGroupColumn(groupCol: AgColumn): AgColumn[] | null;
     isRowGroupDisplayed(column: AgColumn, colId: string): boolean;
+    interleaveSortedColumns(sorted: AgColumn[]): AgColumn[];
+    fillCoupledSortIndexMap(sortedCols: AgColumn[], map: Map<AgColumn, number>): number;
+    isGroupSortMixed(column: AgColumn, direction: SortDirection): boolean;
 }

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

@@ -0,0 +1,48 @@
+import type { LocaleTextFunc } from 'ag-stack';
+import type { ColumnState, ColumnStateParams } from '../columns/columnStateUtils';
+import type { AgColumn } from '../entities/agColumn';
+import type { ColDef } from '../entities/colDef';
+import type { ShowValuesAs, ShowValuesAsResult, ShowValuesAsStateValue, ShowValuesAsType } from '../entities/colDef-showValuesAs';
+import type { RowNode } from '../entities/rowNode';
+import type { ColumnEventType } from '../events';
+import type { ChangedPath } from '../utils/changedPath';
+import type { IRowNode } from './iRowNode';
+import type { MenuItemDef } from './menuItem';
+/** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
+export interface IShowValuesAsService {
+    /** Pre-computes `column.showValuesAs` from the colDef (called on column create / colDef change). `applyInitial`
+     *  is true only at creation — `initialShowValuesAs` is create-only and must not be re-imposed on later changes. */
+    resolveColumn(column: AgColumn, applyInitial: boolean): void;
+    /** The colDef-declared selection (mode name or object form) for column state; `null` when disabled or none. */
+    colDefSelection(colDef: ColDef): ShowValuesAsStateValue;
+    /** Serialises a column's active mode for column state (mode name, or `{ type, params, precision }` when those
+     *  must be preserved); `null` when there is no mode. */
+    toColState(column: AgColumn): ShowValuesAsStateValue;
+    /** Whether the column's mode is currently applying (not dormant in the current view). */
+    isApplying(column: AgColumn): boolean;
+    /** Refresh the aggregate-dependent (Show Values As) cells across all rendered rows — for a general view refresh. */
+    refreshRenderedCells(): void;
+    /** Refresh the aggregate-dependent (Show Values As) cells in rendered rows the caller did not already refresh
+     *  (identified by `nodes`/`path`) — for the post-edit re-aggregation top-up. */
+    refreshRenderedCellsExcept(nodes: Set<RowNode> | null, path: ChangedPath | null): void;
+    /** Transforms a column's raw value at a node into the value to display, or `null` for a blank cell. Call only when {@link isApplying} is true. */
+    transform(column: AgColumn, rowNode: IRowNode, rawValue: any): ShowValuesAsResult | null;
+    /** Formats a transformed value with the mode's formatter. `notApplicable` (the mode is selected but dormant in
+     *  the current view) is passed through so built-in formatters can return `#N/A`. */
+    formatValue(column: AgColumn, rowNode: IRowNode | null, transformedValue: any, rawValue: any, notApplicable: boolean): string | null;
+    /** Applies the `showValuesAs` column state (used by `applyColumnState`). */
+    syncColState(column: AgColumn, stateItem: ColumnState | null, defaultState: ColumnStateParams | undefined, source: ColumnEventType): void;
+    /** The active mode's localised label while it is applying (for the header indicator / screen-reader aria); `null` when none or dormant. */
+    getActiveModeLabel(column: AgColumn): string | null;
+    /** Tooltip (`"<label>: <description>"`) for the active mode — shared by the column menu and header indicator; `null` when none. */
+    getActiveModeTooltip(column: AgColumn): string | null;
+    /** Whether to offer the "Show Values As" column-menu submenu. Off by default; `enableShowValuesAs: true` enables
+     *  it (on `defaultColDef` it still requires the column to be a value or numeric column; set directly on a column it
+     *  forces any type). `false` hides it. The transform / header indicator are independent of this gate. */
+    isMenuEligible(column: AgColumn): boolean;
+    /** Builds the column-menu "Show Values As" submenu items (None + selectable modes, active one checked). */
+    getMenuItems(column: AgColumn, localeTextFunc: LocaleTextFunc): MenuItemDef[];
+    /** Sets the active mode at runtime (column menu). A redraw only, unless the mode needs an aggregated total
+     *  on a not-yet-aggregated column, in which case the column is promoted to a value column (re-aggregates once). */
+    setColumnShowValuesAs(column: AgColumn, selection: ShowValuesAsType | ShowValuesAs | null): void;
+}

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

@@ -0,0 +1,10 @@
+export type DisplaySortDef = SortDef | {
+    direction: 'mixed';
+    type: SortType;
+};
+export type SortDirection = 'asc' | 'desc' | null;
+export type SortType = 'absolute' | 'default';
+export type SortDef = {
+    type: SortType;
+    direction: SortDirection;
+};

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

@@ -1,4 +1,4 @@
-import type { SortDirection, SortType } from '../entities/colDef';
+import type { SortDirection, SortType } from '../interfaces/iSort';
 export interface SortModelItem {
     /** Column Id to apply the sort to. */
     colId: string;

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

@@ -1,8 +1,17 @@
-import type { SortDirection, SortType } from '../entities/colDef';
+import type { SortComparatorFn } from '../entities/colDef';
 import type { Column } from './iColumn';
+import type { SortDirection, SortType } from './iSort';
 /** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
 export interface SortOption {
     sort: NonNullable<SortDirection>;
     type: SortType;
     column: Column;
+    /** Column's own comparator — applies to every row. Filled by `_resolveSortOptions` (`undefined` until then). */
+    colComparator: SortComparatorFn | undefined;
+    /** Fallback comparator for leaf rows of a row-group display col (the primary column's comparator). */
+    leafComparator: SortComparatorFn | undefined;
+    /** `sort === 'desc'`, precomputed to avoid a per-comparison string compare. Filled by `_resolveSortOptions`. */
+    descending: boolean;
+    /** `type === 'absolute'`, precomputed to avoid a per-comparison string compare. Filled by `_resolveSortOptions`. */
+    absolute: boolean;
 }

package/dist/types/src/interfaces/iStatusPanel.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 type StatusBar = {
     statusPanels: StatusPanelDef[];

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

@@ -1,4 +1,4 @@
-import type { IComponent } from '../agStack/interfaces/iComponent';
+import type { IComponent } from 'ag-stack';
 import type { AgGridCommon } from './iCommon';
 import type { FilterAction } from './iFilter';
 export type ColumnToolPanelAction = 'apply' | 'cancel';

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

@@ -1,4 +1,4 @@
-import type { IComponent } from '../agStack/interfaces/iComponent';
+import type { IComponent } from 'ag-stack';
 import type { ToolbarItemComponentName } from '../context/context';
 import type { IconName } from '../utils/icon';
 import type { AgGridCommon } from './iCommon';

package/dist/types/src/interfaces/iUserCompDetails.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';
 /** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
 export interface UserCompDetails<TComp extends IComponent<any> = any> {
     componentClass: any;

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

@@ -1,4 +1,4 @@
-import type { IComponent } from '../agStack/interfaces/iComponent';
+import type { IComponent } from 'ag-stack';
 import type { IMenuActionParams } from './iCallbackParams';
 import type { AgGridCommon } from './iCommon';
 export interface MenuItemLeafDef<TData = any, TContext = any> {
@@ -139,4 +139,4 @@ export interface IMenuItem extends BaseMenuItem {
 }
 export interface IMenuItemComp<TData = any, TContext = any> extends IComponent<IMenuItemParams<TData, TContext>>, IMenuItem {
 }
-export type DefaultMenuItem = 'pinSubMenu' | 'pinLeft' | 'pinRight' | 'pinRowSubMenu' | 'pinTop' | 'pinBottom' | 'unpinRow' | 'clearPinned' | 'valueAggSubMenu' | 'autoSizeThis' | 'autoSizeAll' | 'rowGroup' | 'rowUnGroup' | 'resetColumns' | 'expandAll' | 'contractAll' | 'copy' | 'copyWithHeaders' | 'copyWithGroupHeaders' | 'cut' | 'paste' | 'note' | 'export' | 'csvExport' | 'excelExport' | 'separator' | 'pivotChart' | 'chartRange' | 'columnFilter' | 'columnChooser' | 'sortAscending' | 'sortDescending' | 'sortAbsoluteAscending' | 'sortAbsoluteDescending' | 'sortUnSort';
+export type DefaultMenuItem = 'pinSubMenu' | 'pinLeft' | 'pinRight' | 'pinRowSubMenu' | 'pinTop' | 'pinBottom' | 'unpinRow' | 'clearPinned' | 'valueAggSubMenu' | 'showValuesAsSubMenu' | 'autoSizeThis' | 'autoSizeAll' | 'rowGroup' | 'rowUnGroup' | 'resetColumns' | 'expandAll' | 'contractAll' | 'copy' | 'copyWithHeaders' | 'copyWithGroupHeaders' | 'cut' | 'paste' | 'note' | 'export' | 'csvExport' | 'excelExport' | 'separator' | 'pivotChart' | 'chartRange' | 'columnFilter' | 'columnChooser' | 'calculatedColumn' | 'editCalculatedColumn' | 'removeCalculatedColumn' | 'sortAscending' | 'sortDescending' | 'sortAbsoluteAscending' | 'sortAbsoluteDescending' | 'sortUnSort';

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

@@ -1,8 +1,8 @@
+import type { AgColumn } from '../entities/agColumn';
 import type { ColDef } from '../entities/colDef';
-import type { HeaderComp } from '../headerRendering/cells/column/headerComp';
+import type { AgColumnHeader } from '../headerRendering/cells/column/agColumnHeader';
 import type { CellCtrl } from '../rendering/cell/cellCtrl';
 import type { CellPosition } from './iCellPosition';
-import type { IColumnCollectionService } from './iColumnCollectionService';
 export interface RowNumbersOptions extends Pick<ColDef, 'contextMenuItems' | 'context' | 'onCellClicked' | 'onCellContextMenu' | 'onCellDoubleClicked' | 'headerTooltip' | 'headerStyle' | 'headerComponent' | 'headerComponentParams' | 'suppressHeaderKeyboardEvent' | 'suppressNavigable' | 'tooltipField' | 'tooltipValueGetter' | 'tooltipComponent' | 'tooltipComponentParams' | 'tooltipComponentSelector' | 'valueGetter' | 'valueFormatter' | 'maxWidth' | 'cellRenderer' | 'cellRendererSelector' | 'cellRendererParams'> {
     /**
      * Set to `true` to prevent selecting all the currently visible cells in the row when clicking a Row Number.
@@ -30,8 +30,10 @@ export interface RowNumbersOptions extends Pick<ColDef, 'contextMenuItems' | 'co
     resizable?: boolean;
 }
 /** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
-export interface IRowNumbersService extends IColumnCollectionService {
-    setupForHeader(comp: HeaderComp): void;
+export interface IRowNumbersService {
+    column: AgColumn | null;
+    refreshCols(): AgColumn<any> | null;
+    setupForHeader(comp: AgColumnHeader): void;
     handleMouseDownOnCell(cell: CellPosition, mouseEvent: MouseEvent): boolean;
     handleKeyDownOnCell(cell: CellPosition, event: KeyboardEvent): boolean;
     createRowNumbersRowResizerFeature(ctrl: CellCtrl): IRowNumbersRowResizeFeature | undefined;