ag-grid-community 35.3.0 → 36.0.0

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

@@ -1,60 +1,132 @@
-import type { IAgEventEmitter } from '../agStack/interfaces/iEventEmitter';
+import type { IAgEventEmitter } from 'ag-stack';
 import type { ColumnState } from '../columns/columnStateUtils';
 import { BeanStub } from '../context/beanStub';
 import type { BeanCollection } from '../context/context';
 import type { ColumnEvent, ColumnEventType } from '../events';
+import type { GridOptionsService } from '../gridOptionsService';
 import type { Column, ColumnEventName, ColumnGroup, ColumnGroupShowType, ColumnHighlightPosition, ColumnInstanceId, ColumnPinnedType, HeaderColumnId, ProvidedColumnGroup } from '../interfaces/iColumn';
 import type { IRowNode } from '../interfaces/iRowNode';
+import type { SortDef, SortDirection, SortType } from '../interfaces/iSort';
 import type { AgColumnGroup } from './agColumnGroup';
 import type { AgProvidedColumnGroup } from './agProvidedColumnGroup';
-import type { AbstractColDef, ColDef, ColumnFunctionCallbackParams, IAggFunc, SortDef, SortDirection, SortType } from './colDef';
+import type { AbstractColDef, ColAggFunc, ColDef, ColDefField, ColSpanFunc, ColumnFunctionCallbackParams, HeaderLocation, RefData, RowSpanFunc, ValueFormatterFunc, ValueGetterFunc } from './colDef';
+import type { AgShowValuesAsResolved, ShowValuesAsDefResolved, ShowValuesAsResolved, ShowValuesAsResult } from './colDef-showValuesAs';
 export declare function getNextColInstanceId(): ColumnInstanceId;
-export declare function isColumn(col: Column | ColumnGroup | ProvidedColumnGroup): col is AgColumn;
+export declare const isColumn: (col: Column | ColumnGroup | ProvidedColumnGroup) => col is AgColumn;
+/**
+ * Redirects a pivot result column to its underlying value column for non-group, non-pinned (leaf) rows,
+ * so value get/set reads the real source value. Pinned rows are excluded — their data is keyed by pivot
+ * column ID. Only the deliberate consumers (pivot edit, API reads, pivot aggregation) need this; the hot
+ * read path (`getValueFromData`) does not.
+ * @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time.
+ */
+export declare const _resolvePivotColumnForRow: (column: AgColumn, rowNode: IRowNode) => AgColumn;
+/** Origin of an `AgColumn`. `user` = application-supplied ColDef; others = grid-generated.
+ *  @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
+export type ColKind = 'user' | 'auto-group' | 'selection' | 'row-number' | 'hierarchy';
 /** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
 export declare class AgColumn<TValue = any> extends BeanStub<ColumnEventName> implements Column, IAgEventEmitter<ColumnEventName> {
     colDef: ColDef<any, TValue>;
     userProvidedColDef: ColDef<any, TValue> | null;
     readonly colId: string;
     readonly primary: boolean;
+    readonly colKind: ColKind;
     readonly isColumn: true;
-    private frameworkEventListenerService?;
-    private readonly instanceId;
+    readonly instanceId: ColumnInstanceId;
     /** Sanitised version of the column id */
     readonly colIdSanitised: string;
-    private actualWidth;
-    private autoHeaderHeight;
-    private visible;
+    aggFunc: ColAggFunc;
+    isCalculatedCol: boolean;
+    field: ColDefField<any, TValue> | undefined;
+    /** Cached split of a dotted `field` (`field.split('.')`); `null` when not dotted / dot-notation suppressed.
+     *  Non-null doubles as the "field contains dots" indicator. Read per cell via `_getValueUsingDotPath`. */
+    fieldPath: string[] | null;
+    valueGetter: string | ValueGetterFunc<any, TValue> | undefined;
+    allowFormula: boolean;
+    showRowGroup: string | boolean | undefined;
+    pivotValueColumn: AgColumn | null | undefined;
+    valueFormatter: string | ValueFormatterFunc<any, TValue> | undefined;
+    refData: RefData | undefined;
+    enableCellChangeFlash: boolean | undefined;
+    /** Read per cell when the colSpan/rowSpan feature is used (`getColSpan`/`getRowSpan`). */
+    colSpan: ColSpanFunc<any, TValue> | undefined;
+    rowSpan: RowSpanFunc<any, TValue> | undefined;
+    /** Read per cell on calculated columns (`formulaService.ensureCellFormula`/`fetchRawValue`). */
+    calculatedExpression: string | undefined;
+    /** Current rendered width in px. Writes must go through `setActualWidth` for min/max clamping and the `widthChanged` event. */
+    actualWidth: number;
+    minWidth: number;
+    private maxWidth;
+    flex: number | null;
     pinned: ColumnPinnedType;
-    private left;
-    private oldLeft;
-    aggFunc: string | IAggFunc | null | undefined;
-    private sortDef;
+    left: number | null;
+    oldLeft: number | null;
+    /** User intent: should this column be shown if display rules allow it. */
+    visible: boolean;
+    /** Whether this column is in the displayed (rendered) columns — kept in lockstep with `allColsIndex >= 0` */
+    displayed: boolean;
+    filterActive: boolean;
+    sortDef: SortDef;
     sortIndex: number | null | undefined;
+    autoHeaderHeight: number | null;
+    tooltipEnabled: boolean;
+    tooltipFieldContainsDots: boolean;
+    private frameworkEventListenerService;
+    private colEventSvc;
+    /** Most recent build token that claimed this col — used to detect "already used in this refresh". */
+    buildToken: number;
+    /** 0-based index in `VisibleColsService.allCols` (displayed, visual order — RTL reversed), stamped each refresh. `-1` = not displayed. */
+    allColsIndex: number;
+    /** `true` while in `ColumnModel.colsList` (live cols, hidden included); `false` when only in
+     *  `colsById` — a pivot **primary** parked while a pivot result shows. Set by `refreshCols`. */
+    inColsList: boolean;
+    /** 1-based `aria-colindex`: position in `colsList` reordered `[left, center, right]` (hidden included). `0` = not in `colsList`. */
+    ariaColIndex: number;
+    /** 0-based index in `ColumnModel.colsList` (stamped lazily by `ensureColsListIndex` for O(1) ordered reads);
+     *  `-1` until first stamped / when not in colsList. In pivot, parked primaries keep their pre-pivot index. */
+    colsListIndex: number;
     moving: boolean;
     resizing: boolean;
     menuVisible: boolean;
     highlighted: ColumnHighlightPosition | null;
     formulaRef: string | null;
+    /** The column's "Show Values As" config resolved once on colDef change (built-in modes merged with user config).
+     *  Tri-state: the config object when configured, `null` when explicitly disabled (`colDef.showValuesAsDef: null`),
+     *  `undefined` when unconfigured. The active mode is a lookup into it. */
+    showValuesAsDef: ShowValuesAsDefResolved | null | undefined;
+    /** Resolved active "Show Values As" mode for this column (precomputed by the enterprise service), or `null`
+     *  when none. `showValuesAs.type` is the active mode; the active mode is owned by column state. */
+    showValuesAs: AgShowValuesAsResolved | null;
+    /** colId this column sits immediately after in display order. Order restoration seats new cols after
+     *  this anchor — handles anchors absent from the tree (e.g. auto-group col) and stacks same-anchor adds
+     *  newest-first. `undefined` = not anchored. Column-kind agnostic (currently set by the calc-column contributor). */
+    anchoredToColId: string | undefined;
     private lastLeftPinned;
     private firstRightPinned;
-    minWidth: number;
-    private maxWidth;
-    filterActive: boolean;
-    private readonly colEventSvc;
-    fieldContainsDots: boolean;
-    private tooltipFieldContainsDots;
-    tooltipEnabled: boolean;
     rowGroupActive: boolean;
+    /** Position in `rowGroupColsSvc.columns` when {@link rowGroupActive}; else stale — always pair the read with a `rowGroupActive` check. */
+    rowGroupActiveIndex: number;
     pivotActive: boolean;
+    /** Position in `pivotColsSvc.columns` when {@link pivotActive}; else stale — always pair the read with a `pivotActive` check. */
+    pivotActiveIndex: number;
     aggregationActive: boolean;
-    flex: number | null;
+    /** Position in `valueColsSvc.columns` when {@link aggregationActive}; else stale — always pair the read with an `aggregationActive` check. */
+    aggregationActiveIndex: number;
+    /** The display group col that shows this (source) column; set by `showRowGroupCols` on refresh */
+    showRowGroupCol: AgColumn | null;
     parent: AgColumnGroup | null;
     originalParent: AgProvidedColumnGroup | null;
-    constructor(colDef: ColDef<any, TValue>, userProvidedColDef: ColDef<any, TValue> | null, colId: string, primary: boolean);
+    /** Public so the free `getAvailableSortTypes` sort helper can cache on the column; nulled in {@link setColDef}. */
+    cachedSortTypes: Set<SortType> | null;
+    constructor(colDef: ColDef<any, TValue>, userProvidedColDef: ColDef<any, TValue> | null, colId: string, primary: boolean, colKind: ColKind);
     destroy(): void;
     getInstanceId(): ColumnInstanceId;
     private initState;
-    setColDef(colDef: ColDef<any, TValue>, userProvidedColDef: ColDef<any, TValue> | null, source: ColumnEventType): void;
+    /** Called when user provides an alternative colDef. Returns whether the merged colDef differed (false = nothing changed). */
+    setColDef(colDef: ColDef<any, TValue>, userProvidedColDef: ColDef<any, TValue> | null, source: ColumnEventType): boolean;
+    /** Re-apply `def` to a reused column. Stateful attrs are only (re)applied when the user authored the
+     *  definitions (`newColDefs`); an internal rebuild (e.g. calc-col add) must leave live state intact. */
+    reapplyColDef(def: ColDef, source: ColumnEventType, newColDefs: boolean): void;
     getUserProvidedColDef(): ColDef<any, TValue> | null;
     getParent(): AgColumnGroup | null;
     getOriginalParent(): AgProvidedColumnGroup | null;
@@ -62,11 +134,9 @@ export declare class AgColumn<TValue = any> extends BeanStub<ColumnEventName> im
     private initDotNotation;
     private initMinAndMaxWidths;
     private initTooltip;
-    private initRowSpan;
-    private addPivotListener;
     resetActualWidth(source: ColumnEventType): void;
     private calculateColInitialWidth;
-    isEmptyGroup(): boolean;
+    isEmptyGroup(): false;
     isRowGroupDisplayed(colId: string): boolean;
     isPrimary(): boolean;
     isFilterAllowed(): boolean;
@@ -74,6 +144,7 @@ export declare class AgColumn<TValue = any> extends BeanStub<ColumnEventName> im
     isTooltipEnabled(): boolean;
     isTooltipFieldContainsDots(): boolean;
     getHighlighted(): ColumnHighlightPosition | null;
+    private getColEventSvc;
     __addEventListener<T extends ColumnEventName>(eventType: T, listener: (params: ColumnEvent<T>) => void): void;
     __removeEventListener<T extends ColumnEventName>(eventType: T, listener: (params: ColumnEvent<T>) => void): void;
     /**
@@ -94,20 +165,16 @@ export declare class AgColumn<TValue = any> extends BeanStub<ColumnEventName> im
     isDndSource(rowNode: IRowNode): boolean;
     isCellCheckboxSelection(rowNode: IRowNode): boolean;
     isSuppressPaste(rowNode: IRowNode): boolean;
+    /** Mirror the hot-path colDef fields onto the column so per-cell reads avoid a megamorphic colDef load.
+     *  `field`/`fieldPath` are set by {@link initDotNotation} (they depend on `suppressFieldDotNotation`). */
+    private initColDefHotFields;
+    private initCalculatedColumnState;
     isResizable(): boolean;
-    /** Get value from ColDef or default if it exists. */
-    private getColDefValue;
     isColumnFunc(rowNode: IRowNode, value?: boolean | ((params: ColumnFunctionCallbackParams) => boolean) | null): boolean;
-    private createColumnEvent;
     isMoving(): boolean;
     getSort(): SortDirection;
-    /**
-     * Returns null if no sort direction applied
-     */
+    /** Returns null if no sort direction applied */
     getSortDef(): SortDef | null;
-    private getColDefAllowedSortTypes;
-    getSortingOrder(): SortDef[];
-    getAvailableSortTypes(): Set<string>;
     setSortDef(sortDef: SortDef): void;
     isSortable(): boolean;
     /** @deprecated v32 use col.getSort() === 'asc */
@@ -120,7 +187,9 @@ export declare class AgColumn<TValue = any> extends BeanStub<ColumnEventName> im
     isSorting(): boolean;
     getSortIndex(): number | null | undefined;
     isMenuVisible(): boolean;
-    getAggFunc(): string | IAggFunc | null | undefined;
+    getAggFunc(): ColAggFunc;
+    getShowValuesAs<TOut extends ShowValuesAsResult = any>(): ShowValuesAsResolved<any, TValue, TOut> | null;
+    getShowValuesAsDef(): ShowValuesAsDefResolved<any, TValue> | null;
     getLeft(): number | null;
     getOldLeft(): number | null;
     getRight(): number;
@@ -139,9 +208,7 @@ export declare class AgColumn<TValue = any> extends BeanStub<ColumnEventName> im
     setVisible(visible: boolean, source: ColumnEventType): void;
     isVisible(): boolean;
     isSpanHeaderHeight(): boolean;
-    /**
-     * Returns the first parent that is not a padding group.
-     */
+    /** Returns the first parent that is not a padding group. */
     getFirstRealParent(): AgProvidedColumnGroup | null;
     getColumnGroupPaddingInfo(): {
         numberOfParents: number;
@@ -151,13 +218,13 @@ export declare class AgColumn<TValue = any> extends BeanStub<ColumnEventName> im
     getDefinition(): AbstractColDef<any, TValue>;
     getColumnGroupShow(): ColumnGroupShowType | undefined;
     getColId(): string;
+    getDisplayName(location?: HeaderLocation): string;
     getId(): string;
     getUniqueId(): HeaderColumnId;
     getActualWidth(): number;
     getAutoHeaderHeight(): number | null;
     /** Returns true if the header height has changed */
     setAutoHeaderHeight(height: number): boolean;
-    private createBaseColDefParams;
     getColSpan(rowNode: IRowNode): number;
     getRowSpan(rowNode: IRowNode): number;
     setActualWidth(actualWidth: number, source: ColumnEventType, silent?: boolean): void;
@@ -178,27 +245,18 @@ export declare class AgColumn<TValue = any> extends BeanStub<ColumnEventName> im
     dispatchColEvent(type: ColumnEventName, source: ColumnEventType, additionalEventAttributes?: any): void;
     dispatchStateUpdatedEvent(key: keyof ColumnState): void;
 }
-/**
- * Helper to convert input into SortDef, does normalisation of direction and type.
- *
- * If input is already a valid SortDef, we pluck the direction and type from it.
- * Otherwise, we normalise the direction and type from input.
- * @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time.
- */
-export declare function _getSortDefFromInput(input?: unknown): SortDef;
-/** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
-export declare function _isSortDirectionValid(maybeSortDir: unknown): maybeSortDir is SortDirection;
-/** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
-export declare function _isSortTypeValid(maybeSortType: unknown): maybeSortType is SortType;
-export declare function _isSortDefValid(maybeSortDef: unknown): maybeSortDef is SortDef;
-/** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
-export declare function _areSortDefsEqual(sortDef1: SortDef | null | undefined, sortDef2: SortDef | null | undefined): boolean;
-/** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
-export declare function _normalizeSortDirection(sortDirectionLike?: unknown): SortDirection;
+/** Convert input into a SortDef: a valid SortDef passes through, otherwise direction and type are normalised. */
+export declare const getSortDefFromInput: (input?: unknown) => SortDef;
+export declare const getSortingOrder: (gos: GridOptionsService, column: AgColumn) => SortDef[];
+export declare const isSortDirectionValid: (maybeSortDir: unknown) => maybeSortDir is SortDirection;
+export declare const isSortTypeValid: (maybeSortType: unknown) => maybeSortType is SortType;
+export declare const _isSortDefValid: (maybeSortDef: unknown) => maybeSortDef is SortDef;
+export declare const normalizeSortDirection: (sortDirectionLike?: unknown) => SortDirection;
 /** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
-export declare function _normalizeSortType(sortTypeLike?: unknown): SortType;
+export declare const _normalizeSortType: (sortTypeLike?: unknown) => SortType;
+type SortDefOverride = () => SortDef | null | undefined;
 /** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
-export declare function _getDisplaySortForColumn(column: AgColumn, beans: BeanCollection, getSortDefOverride?: () => SortDef | null | undefined): {
+export declare const _getDisplaySortForColumn: (column: AgColumn, beans: BeanCollection, override?: SortDefOverride) => {
     isDefaultSortAllowed: boolean;
     isAbsoluteSortAllowed: boolean;
     isAbsoluteSort: boolean;
@@ -207,3 +265,4 @@ export declare function _getDisplaySortForColumn(column: AgColumn, beans: BeanCo
     isDescending: boolean;
     direction: SortDirection;
 };
+export {};

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

@@ -2,29 +2,31 @@ import { BeanStub } from '../context/beanStub';
 import type { AgColumnGroupEvent, Column, ColumnGroup, ColumnGroupShowType, ColumnPinnedType, HeaderColumnId } from '../interfaces/iColumn';
 import type { AgColumn } from './agColumn';
 import type { AgProvidedColumnGroup } from './agProvidedColumnGroup';
-import type { AbstractColDef, ColGroupDef } from './colDef';
-export declare function createUniqueColumnGroupId(groupId: string, instanceId: number): HeaderColumnId;
-export declare function isColumnGroup(col: Column | ColumnGroup | string): col is AgColumnGroup;
+import type { AbstractColDef, ColGroupDef, HeaderLocation } from './colDef';
+export declare const isColumnGroup: (col: Column | ColumnGroup | string) => col is AgColumnGroup;
 /** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
 export declare class AgColumnGroup<TValue = any> extends BeanStub<AgColumnGroupEvent> implements ColumnGroup<TValue> {
-    private readonly providedColumnGroup;
-    private readonly groupId;
-    private readonly partId;
-    private readonly pinned;
+    readonly providedColumnGroup: AgProvidedColumnGroup;
+    readonly groupId: string;
+    readonly partId: number;
+    pinned: ColumnPinnedType;
     readonly isColumn: false;
+    readonly uniqueId: HeaderColumnId;
     /** Sanitised version of the column id */
     readonly colIdSanitised: string;
-    private children;
-    private displayedChildren;
-    private autoHeaderHeight;
-    private left;
-    private oldLeft;
+    children: (AgColumn | AgColumnGroup)[] | null;
+    displayedChildren: (AgColumn | AgColumnGroup)[] | null;
+    autoHeaderHeight: number | null;
+    left: number | null;
+    oldLeft: number | null;
     parent: AgColumnGroup | null;
+    /** Most recent build token that claimed this instance — sweeps use it to spot orphans. */
+    buildToken: number;
     constructor(providedColumnGroup: AgProvidedColumnGroup, groupId: string, partId: number, pinned: ColumnPinnedType);
-    reset(): void;
     getParent(): AgColumnGroup | null;
     getUniqueId(): HeaderColumnId;
     isEmptyGroup(): boolean;
+    /** Returns true only when every leaf column in this group is currently moving. */
     isMoving(): boolean;
     checkLeft(): void;
     getLeft(): number | null;
@@ -32,20 +34,21 @@ export declare class AgColumnGroup<TValue = any> extends BeanStub<AgColumnGroupE
     setLeft(left: number | null): void;
     getPinned(): ColumnPinnedType;
     getGroupId(): string;
+    getDisplayName(location?: HeaderLocation): string;
     getPartId(): number;
     getActualWidth(): number;
     isResizable(): boolean;
     getMinWidth(): number;
-    addChild(child: AgColumn | AgColumnGroup): void;
     getDisplayedChildren(): (AgColumn | AgColumnGroup)[] | null;
     getLeafColumns(): AgColumn[];
     getDisplayedLeafColumns(): AgColumn[];
+    /** 1-based aria column index for this group's header cell: first leaf column's index */
+    get ariaColIndex(): number;
     getDefinition(): AbstractColDef | null;
     getColGroupDef(): ColGroupDef | null;
     isPadding(): boolean;
     isExpandable(): boolean;
     isExpanded(): boolean;
-    setExpanded(expanded: boolean): void;
     isAutoHeaderHeight(): boolean;
     getAutoHeaderHeight(): number | null;
     /** Returns true if the header height has changed */
@@ -56,5 +59,10 @@ export declare class AgColumnGroup<TValue = any> extends BeanStub<AgColumnGroupE
     getColumnGroupShow(): ColumnGroupShowType | undefined;
     getProvidedColumnGroup(): AgProvidedColumnGroup;
     getPaddingLevel(): number;
-    calculateDisplayedColumns(): void;
 }
+/** First/last (`last`) leaf under `group`, walking `children` or `displayedChildren` (`displayed`) — the
+ *  `get(Displayed)LeafColumns()` edge without allocating the array; `null` if empty.
+ *  @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
+export declare const edgeLeafColumn: (group: AgColumnGroup, displayed: boolean, last: boolean) => AgColumn | null;
+/** Walk up `column`'s parent chain to the group sitting at header-row `level`. */
+export declare const getColGroupAtLevel: (column: AgColumn, level: number) => AgColumnGroup | null;

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

@@ -1,44 +1,45 @@
 import { BeanStub } from '../context/beanStub';
 import type { Column, ColumnGroupShowType, ColumnInstanceId, ProvidedColumnGroup } from '../interfaces/iColumn';
 import type { AgColumn } from './agColumn';
+import type { AgColumnGroup } from './agColumnGroup';
 import type { ColGroupDef } from './colDef';
-export declare function isProvidedColumnGroup(col: Column | ProvidedColumnGroup | string | null): col is AgProvidedColumnGroup;
+export declare function isProvidedColumnGroup(col: Column | ProvidedColumnGroup | string | null | undefined): col is AgProvidedColumnGroup;
 export type AgProvidedColumnGroupEvent = 'expandedChanged' | 'expandableChanged';
 /** @internal AG_GRID_INTERNAL - Not for public use. Can change / be removed at any time. */
 export declare class AgProvidedColumnGroup extends BeanStub<AgProvidedColumnGroupEvent> implements ProvidedColumnGroup {
-    private colGroupDef;
-    private readonly groupId;
-    private readonly padding;
-    private level;
+    colGroupDef: ColGroupDef | null;
+    readonly groupId: string;
+    readonly padding: boolean;
+    level: number;
     readonly isColumn: false;
     originalParent: AgProvidedColumnGroup | null;
-    private children;
-    private expandable;
-    private expanded;
-    private readonly instanceId;
-    private expandableListenerRemoveCallback;
+    children: (AgColumn | AgProvidedColumnGroup)[];
+    expandable: boolean;
+    expanded: boolean;
+    /** Most recent build token that claimed this group — detects "already used in this refresh". */
+    buildToken: number;
+    /** Packed `AgColumnGroup` display instances by dense per-refresh `partId` (`displayInstances[0]` is primary), lazily allocated and pruned by `columnGroupService`. */
+    displayInstances: AgColumnGroup[] | null;
+    /** Cache previous `setExpandable` visibility so `AgColumn.setVisible` ancestor walk can stop when unchanged. */
+    private lastVisible;
+    readonly instanceId: ColumnInstanceId;
     constructor(colGroupDef: ColGroupDef | null, groupId: string, padding: boolean, level: number);
-    destroy(): void;
-    private reset;
     getInstanceId(): ColumnInstanceId;
     getOriginalParent(): AgProvidedColumnGroup | null;
     getLevel(): number;
+    /** Visible iff at least one child is visible. */
     isVisible(): boolean;
     isPadding(): boolean;
-    setExpanded(expanded: boolean | undefined): void;
+    setExpanded(expanded: boolean | undefined): boolean;
     isExpandable(): boolean;
     isExpanded(): boolean;
     getGroupId(): string;
     getId(): string;
-    setChildren(children: (AgColumn | AgProvidedColumnGroup)[]): void;
     getChildren(): (AgColumn | AgProvidedColumnGroup)[];
     getColGroupDef(): ColGroupDef | null;
     getLeafColumns(): AgColumn[];
-    forEachLeafColumn(callback: (column: AgColumn) => void): void;
     private addLeafColumns;
     getColumnGroupShow(): ColumnGroupShowType | undefined;
-    setupExpandable(): void;
-    setExpandable(): void;
-    private findChildrenRemovingPadding;
-    private onColumnVisibilityChanged;
+    /** Recompute child-driven expandability and return whether `AgColumn.setVisible` should continue ancestor walking. */
+    setExpandable(): boolean;
 }