@genesislcap/grid-pro 15.35.1 → 16.0.0

package/dist/grid-pro.d.ts

@@ -74,8 +74,8 @@ import { GridDragSource } from 'ag-grid-community';
 import { GridOptions } from '@ag-grid-community/core';
 import { GridOptions as GridOptions_2 } from 'ag-grid-community';
 import { GridOptionsService } from 'ag-grid-community';
-import type { GridParams } from '@ag-grid-community/core';
-import type { GridParams as GridParams_2 } from 'ag-grid-community';
+import type { GridParams } from 'ag-grid-community';
+import type { GridParams as GridParams_2 } from '@ag-grid-community/core';
 import { GridReadyEvent } from 'ag-grid-community';
 import { GroupRowEditableCallback } from 'ag-grid-community';
 import { GroupRowValueSetterFunc } from 'ag-grid-community';
@@ -2231,14 +2231,23 @@ export declare const foundationGridComponents: {
     foundationGridPro: (overrideDefinition?: OverrideFoundationElementDefinition<    {
     shadowOptions: any;
     baseName: string;
-    styles: ElementStyles;
     template: ViewTemplate<any, any>;
+    styles: ElementStyles;
     }>) => FoundationElementRegistry<    {
     shadowOptions: any;
     baseName: string;
-    styles: ElementStyles;
     template: ViewTemplate<any, any>;
+    styles: ElementStyles;
     }, GridPro>;
+    foundationColumnSelection: (overrideDefinition?: OverrideFoundationElementDefinition<    {
+    baseName: string;
+    template: ViewTemplate<ColumnSelection, any>;
+    styles: ElementStyles;
+    }>) => FoundationElementRegistry<    {
+    baseName: string;
+    template: ViewTemplate<ColumnSelection, any>;
+    styles: ElementStyles;
+    }, ColumnSelection>;
     register(container?: Container, ...rest: any[]): void;
 };
 
@@ -2252,13 +2261,13 @@ export declare const foundationGridComponents: {
 export declare const foundationGridPro: (overrideDefinition?: OverrideFoundationElementDefinition<    {
 shadowOptions: any;
 baseName: string;
-styles: ElementStyles;
 template: ViewTemplate<any, any>;
+styles: ElementStyles;
 }>) => FoundationElementRegistry<    {
 shadowOptions: any;
 baseName: string;
-styles: ElementStyles;
 template: ViewTemplate<any, any>;
+styles: ElementStyles;
 }, typeof GridPro>;
 
 /**
@@ -2294,7 +2303,27 @@ template: ViewTemplate<any, any>;
 }, typeof ActionsMenuRenderer>;
 
 /**
- * GridPro shadow root options.
+ * A function that returns a Foundation Grid Pro Legacy registration for configuring the component with a DesignSystem.
+ *
+ * @public
+ * @deprecated Legacy AG Grid v29 wrapper. Use `GridPro` (AG Grid v36) instead.
+ * @remarks
+ * HTML Element: \<foundation-grid-pro\>
+ */
+export declare const foundationGridProLegacy: (overrideDefinition?: OverrideFoundationElementDefinition<    {
+shadowOptions: any;
+baseName: string;
+styles: ElementStyles;
+template: ViewTemplate<any, any>;
+}>) => FoundationElementRegistry<    {
+shadowOptions: any;
+baseName: string;
+styles: ElementStyles;
+template: ViewTemplate<any, any>;
+}, typeof GridProLegacy>;
+
+/**
+ * Grid Pro shadow root options.
  * @public
  * @remarks
  * For extensibility, this can be used to set the shadow root mode and delegatesFocus
@@ -3535,21 +3564,18 @@ export declare type GridOptionsConfig = GridOptions_2 | GridOptions;
 export declare const GridOptionsConfig: InterfaceSymbol<GridOptionsConfig>;
 
 /**
- * The Grid Pro element.
+ * The Grid Pro element (AG Grid v36 compatible).
  * @remarks Grid Pro is a Web Component wrapper around the AG Grid Community library.
  * @public
  * @tagname %%prefix%%-grid-pro
  *
- * @fires gridReady - Fired when AG Grid is ready (detail includes the grid-ready event and grid id)
- * @fires onGridReady - Deprecated alias for the grid-ready signal; prefer `gridReady`
+ * @fires gridReady - Fired when AG Grid is ready (detail includes the grid-ready event and grid id). detail: `GridReadyEventDetail`
+ * @fires onGridReady - Deprecated alias for the grid-ready signal; prefer `gridReady`. detail: `GridReadyEventDetail`
  * @fires gridready - Native `Event` from `globalEventListener` when AG Grid fires `gridReady` (`agGridDetails` holds the AG Grid event)
- * @remarks Re-emits AG Grid public API events when listeners are registered via `addEventListener` (event names match `ComponentUtil.PUBLIC_EVENTS` from `@ag-grid-community/core`). The same AG Grid events are also dispatched as native `Event`s with lowercased `type` and payload on `agGridDetails` (for example `addEventListener('columnresized', ...)`).
+ * @remarks Re-emits AG Grid public API events when listeners are registered via `addEventListener` (event names match AG Grid public event strings). The same AG Grid events are also dispatched as native `Event`s with lowercased `type` and payload on `agGridDetails` (for example `addEventListener('columnresized', ...)`).
  */
 export declare class GridPro extends GridPro_base {
-    columnApi: ColumnApi;
-    gridApi: GridApi_2;
-    private cachedTotalColumnWidth;
-    private columnCount;
+    gridApi: GridApi;
     gridErrorItems: GridProErrorItem<GridProErrorEvent['detail']>[];
     statePersistence: StatePersistence;
     /**
@@ -3569,50 +3595,19 @@ export declare class GridPro extends GridPro_base {
      * in local storage if you are using `persist-column-state-key`.
      */
     gridAutosizingEnabled: boolean;
-    /**
-     * Boolean attribute to control whether the grid automatically sizes columns to fit their content.
-     * This will call AG Grid's autoSizeColumns() method to automatically adjust column widths based on content.
-     * @public
-     */
-    sizeColumnsToContent: boolean;
-    /**
-     * Boolean attribute to adjust the size of columns to fit the available horizontal space.
-     * This will call AG Grid's sizeColumnsToFit() method.
-     * @public
-     */
-    sizeColumnsToFit: boolean;
-    /**
-     * The index to add new rows to when using `applyTransaction` or `applyTransactionAsync`
-     */
-    addIndex: number;
-    /**
-     * Whether to use the `applyTransactionAsync` function for *add* transactions
-     * @remarks Defaults to false
-     */
-    asyncAdd: boolean;
-    /**
-     * Whether to use the `applyTransactionAsync` function for *remove* transactions
-     * @remarks Defaults to false
-     */
-    asyncRemove: boolean;
-    /**
-     * Whether to use the `applyTransactionAsync` function for *update* transactions
-     * @remarks Defaults to true
-     */
-    asyncUpdate: boolean;
     /**
      * If false, will disable cell flashing for all cells by default, unless otherwise defined in custom colDef
      * @remarks Defaults to true
      */
     enableCellFlashing: boolean;
-    /**
-     * @deprecated - use `enableRowFlashing` instead.
-     */
-    enabledRowFlashing: boolean;
     /**
      * If true, will enable row flashing for all rows for `add` async transactions
      */
     enableRowFlashing: boolean;
+    /** Wired to `gridOptions.context` for columns picker → grid drag (see bridge module). */
+    private readonly columnDragBridge;
+    /** @internal Shared AG column-drag bridge for custom tool panels. */
+    getColumnDragBridge(): GridProColumnDragBridge;
     /**
      * The key to use for persisting the column state in local browser or KV storage.
      */
@@ -3621,10 +3616,6 @@ export declare class GridPro extends GridPro_base {
      * The key to use for persisting the filter model in local browser or KV storage.
      */
     persistFilterModelKey: string;
-    /**
-     * The default column config to reset to when deleteColumnState is called.
-     */
-    defaultColumnConfig: ColDef[];
     /**
      * The case type to use for the header names. If not set, the default CONSTANT_CASE will be used.
      * @remarks Can be one of the following: camelCase, capitalCase, dotCase, headerCase, noCase, paramCase, pascalCase, pathCase, sentenceCase, snakeCase.
@@ -3638,15 +3629,12 @@ export declare class GridPro extends GridPro_base {
      */
     rowData: any[];
     rowDataChanged(_: any, rowData: any): void;
-    gridFontFace: string;
     columnComponentName: string;
     eventsAndCallbacks: GridProEventsAndCallbacks;
     headerHeight: number;
     rowHeight: number;
-    theme: string;
-    themeChanged(oldValue: string, newValue: string): void;
     classNames: string;
-    agGrid: Grid;
+    agGrid: GridApi;
     gridSlot: HTMLSlotElement;
     /**
      * The slot ref binds asynchronously, and the queued `initGrid` skips any run that beats it. FAST
@@ -3678,6 +3666,12 @@ export declare class GridPro extends GridPro_base {
      * This requires AG Grid Enterprise module to be available for the status bar to be displayed when enabled.
      */
     withStatusBar: boolean;
+    /**
+     * Shows a Column Selection button above the grid.
+     * @public
+     */
+    enableColumnSelection: boolean;
+    enableColumnSelectionChanged(): void;
     /**
      * Custom error handler dialog template function.
      * @remarks
@@ -3687,23 +3681,23 @@ export declare class GridPro extends GridPro_base {
      */
     customErrorHandlerTemplate?: (prefix: string, gridErrorItems: GridProErrorItem<any>[]) => ViewTemplate;
     private columnState;
-    protected agAttributes: Record<string, string>;
+    protected agAttributes: Record<string, any>;
     protected agPropertiesMap: Record<string, string>;
-    protected agGridOptions: GridOptions;
-    /**
-     * Last grid options supplied via the public `gridOptions` setter (not datasource init).
-     * Used as the merge base in `handleInitialize` so user options survive datasource restart.
-     */
+    protected agGridOptions: GridOptions_2;
+    /** User-supplied grid options cached as merge base for datasource re-init. */
     private userProvidedGridOptions;
     private applyingDatasourceGridOptions;
     protected initialised: boolean;
     private rehydrationAttempted;
-    private eventHandlers;
+    /** A schemaUpdated that arrived before `gridApi` existed; replayed in onGridReady. */
+    private pendingSchemaUpdate?;
+    private rootEventsListeners;
+    private datasourceEventHandlers;
     private gridEventsQueue;
     private registeredGridEvents;
     private gridEventListeners;
+    private luminanceSubscription?;
     private visibilityObserverCleanup?;
-    private pendingSchemaUpdate?;
     private readonly boundGlobalEventListener;
     private _filterConfig;
     getfilterModel(): Promise<{
@@ -3727,13 +3721,8 @@ export declare class GridPro extends GridPro_base {
      * ```
      */
     gridOptionsConfig: GridOptionsConfig;
+    provider: any;
     constructor();
-    /**
-     * The Infinite Row Model is only wired into the beta grid, so an infinite datasource placed
-     * inside this element can never load data. Report it instead of ignoring the event.
-     * @internal
-     */
-    private refuseInfiniteDatasource;
     /**
      * Adds an event listener to the grid element.
      * @param eventType - The event type to listen for. Recommened to use the `Events` from AG Grid.
@@ -3747,14 +3736,18 @@ export declare class GridPro extends GridPro_base {
     private handleError;
     private handleBaseDatasourceError;
     hideDatasourceError(): void;
+    private handleLuminanceChange;
+    private readonly luminanceObserver;
     connectedCallback(): void;
     disconnectedCallback(): void;
+    private syncColumnSelectionHostLayout;
     private performDisconnectCleanup;
+    private destroyGridInstance;
     /**
-     * Tear down the AG Grid instance. Prefer {@link GridApi#destroy}; if `gridApi` is not set yet
-     * (e.g. disconnect before `grid-ready`), fall back to {@link Grid#destroy} on the vanilla wrapper.
+     * Helper method to add or remove datasource event listeners
+     * @internal
      */
-    private destroyGridInstance;
+    private toggleDatasourceEventListeners;
     /**
      * Handles datasource initialization
      * @internal
@@ -3770,6 +3763,12 @@ export declare class GridPro extends GridPro_base {
      * @internal
      */
     private handleDataChanged;
+    /**
+     * Whether the live grid runs AG Grid's client-side row model (the default when the datasource
+     * set no `rowModelType`).
+     * @internal
+     */
+    private get isClientSideRowModel();
     private flashAddedCells;
     /**
      * Handles schema updates from datasource
@@ -3777,10 +3776,24 @@ export declare class GridPro extends GridPro_base {
      */
     private handleSchemaUpdated;
     /**
-     * Builds and applies column defs from a schema/metadata payload.
+     * Builds and applies column defs from a schema payload.
      * @internal
      */
     private processSchemaUpdate;
+    /**
+     * Downgrades enterprise filters in metadata-generated colDefs when their modules are not
+     * registered — from v35 AG Grid throws on unregistered filters instead of falling back.
+     * Enum columns (recognised by their metadata-sourced set-filter values) keep those values by
+     * falling back to the community `EnumColumnFilter` instead of a plain text filter.
+     *
+     * The enum floating filter is only wired as the column's component, not enabled: AG's floating
+     * filter is a full-width header row, so enabling it for one column changes the layout of every
+     * column. Active-filter state is surfaced instead by AG's native header filter icon plus the
+     * header tooltip the enum filter maintains; consumers wanting the floating row opt in with
+     * `floatingFilter: true`.
+     * @internal
+     */
+    private applyCommunityFilterFallbacks;
     /**
      * Handles data clearing from datasource
      * @internal
@@ -3846,6 +3859,18 @@ export declare class GridPro extends GridPro_base {
      * @internal
      */
     private handleApplyServerSideTransaction;
+    /**
+     * Handles setting infinite datasource
+     * @internal
+     */
+    private handleSetInfiniteDatasource;
+    /**
+     * Handles refreshing the infinite cache.
+     * @remarks Mirrors {@link GridPro.handleRefreshServerSide}: `purge` drops the block cache
+     * and re-reads, otherwise the loaded blocks are re-read in place.
+     * @internal
+     */
+    private handleRefreshInfiniteCache;
     combineAllGridComponents(gridOptionsComponents: GridComponents): GridComponents;
     statePersistanceEnabled(): boolean;
     /**
@@ -3898,21 +3923,14 @@ export declare class GridPro extends GridPro_base {
      * @privateRemarks Not using `columnApi.get|setColumnState()` for these flows as it doesn't work setting new columnDefs vs different ordering.
      * @public
      */
-    getSavedColumnState(): Promise<ColumnState[]>;
-    /**
-     * Deletes the saved column state for the current grid
-     * @param resetToDefault - Whether to reset columns to their default configuration. Defaults to true.
-     * @remarks This removes the persisted column state from storage, allowing the grid to use default column configuration
-     * @public
-     */
-    deleteColumnState(resetToDefault?: boolean): Promise<void>;
+    getSavedColumnState(): Promise<ColumnState_2[]>;
     private restoreColumnState;
     cacheFilterConfig(): void;
     restoreCachedFilterConfig(): Promise<void>;
     /**
      * @public
      */
-    get gridOptions(): GridOptionsConfig;
+    get gridOptions(): GridOptions_2;
     /**
      * @public
      */
@@ -3927,33 +3945,25 @@ export declare class GridPro extends GridPro_base {
      * @public
      */
     get gridProDatasource(): GridProBaseDatasource;
+    /**
+     * @public
+     */
+    get isInfiniteRowModel(): boolean;
     /**
      * Reports the currently visible columns to the datasource. The datasource decides what to do with
      * them (e.g. narrowing the server request); the grid stays agnostic of that behaviour.
      * @internal
      */
     private notifyDatasourceVisibleColumns;
-    set gridOptions(options: GridOptionsConfig);
+    set gridOptions(options: GridOptions_2);
     private setLocalGridOptions;
     /**
      * Clears the local grid options, this is used to clear the grid options when the grid is restarted.
      * @public
      */
     clearLocalGridOptions(): void;
-    /**
-     * Clears all grid option state when the grid element is fully torn down.
-     * @internal
-     */
     private resetGridOptionsState;
     private initGrid;
-    /**
-     * Will merge templated column definitions with `columnDefs` plus localStorage's column state or `deferredColumnStates`.
-     * @deprecated use `applyTemplateDefinitions` instead.
-     * @param columnDefs - The column definitions to apply to the grid.
-     * @param deferredColumnDefsOrState - If true, will merge the column definitions with the saved column state or the `deferredColumnStates` property on the `grid-pro-genesis-datasource` element.
-     * @returns The merged column definitions.
-     */
-    applyTemplateDefinitions(columnDefs: ColDef[], deferredColumnDefsOrState?: boolean): Promise<(ColDef<any> | ColGroupDef<any>)[]>;
     /**
      * Will merge templated column definitions with `columnDefs` plus localStorage's column state or `deferredColumnStates`.
      * @public
@@ -3963,74 +3973,205 @@ export declare class GridPro extends GridPro_base {
      * on the `grid-pro-genesis-datasource` element. Defaults to false but `grid-pro-genesis-datasource` will set this to true.
      * @returns The merged column definitions.
      */
-    mergeAllColumnDefsAndStates(columnDefs: ColDef[], deferredColumnDefsOrState?: boolean): Promise<(ColDef<any> | ColGroupDef<any>)[]>;
-    private panelExists;
-    private addRowCountPanel;
-    private addMaxRowsPanel;
-    private addAggregationPanel;
-    private addDatasourcePanels;
-    protected setupStatusBar(gridOptions: GridOptions): void;
-    /**
-     * Handles column sizing based on sizeColumnsToContent and sizeColumnsToFit attributes
-     * @private
-     */
-    private handleColumnSizing;
-    /**
-     * Handles when both sizeColumnsToContent and sizeColumnsToFit are enabled
-     * @private
-     */
-    private handleBothSizingModes;
-    /**
-     * Handles individual sizing modes when only one is enabled
-     * @private
-     */
-    private handleIndividualSizingModes;
-    /**
-     * Calculates the total width of all columns
-     * @private
-     */
-    private calculateTotalColumnWidth;
-    /**
-     * Invalidates the cached column width calculation
-     * @private
-     * @remarks This method is called automatically when column changes occur (resize, move, pin, etc.)
-     * to ensure the cached width calculation remains accurate.
-     */
-    private invalidateColumnWidthCache;
-    /**
-     * Gets the available grid width with fallbacks
-     * @private
-     */
-    private getGridWidth;
-    get observedAttributes(): string[];
-    agAttributeChangedCallback(attName: any, oldValue: any, newValue: any): void;
-    globalEventListener(eventType: any, event: any): void;
-    private fontFaceDestroy;
-    private insertFontFace;
-    private destroyFontFace;
-}
-
-declare const GridPro_base: (new (...args: any[]) => {
-    #_container: FoundationLayoutContainer | LayoutCacheContainer | DOMContainer;
-    #_latestTokenCode: string;
-    #_hasFirstLoaded: boolean;
-    #_cleanupTimeout: NodeJS.Timeout;
-    #_shouldForceLifecycle: boolean;
-    #_blockedDisconnectSurvivedGracePeriod: boolean;
-    cloneNode(deep?: boolean): Node;
-    deepClone(): Node;
-    get shouldRunDisconnect(): boolean;
-    get shouldRunConnect(): boolean;
-    #_blockLifecycleDueToTokenChange(lifecycleType: "connect" | "disconnect" | "reconnect"): boolean;
-    #_tryFindContainingLayout(e: Element): FoundationLayoutContainer | LayoutCacheContainer | DOMContainer;
-    connectedCallback(): void;
-    readonly $fastController: Controller;
-    $emit(type: string, detail?: any, options?: Omit<CustomEventInit, "detail">): boolean | void;
-    disconnectedCallback(): void;
-    attributeChangedCallback(name: string, oldValue: string, newValue: string): void;
-    accessKey: string;
-    readonly accessKeyLabel: string;
-    autocapitalize: string;
+    mergeAllColumnDefsAndStates(columnDefs: ColDef_2[], deferredColumnDefsOrState?: boolean): Promise<(ColDef<any> | ColGroupDef<any>)[] | (ColDef_2<any, any> | {
+        colId?: string;
+        field?: string;
+        type?: string | string[];
+        valueGetter?: string | ValueGetterFunc<any> | ValueGetterFunc_2<any, any, any>;
+        valueFormatter?: string | ValueFormatterFunc<any> | ValueFormatterFunc_2<any, any, any>;
+        refData?: RefData;
+        keyCreator?: ((params: KeyCreatorParams<any, any>) => string) | KeyCreatorFunc<any, any, any>;
+        equals?: (valueA: any, valueB: any) => boolean;
+        tooltipField?: string;
+        tooltipValueGetter?: ((params: ITooltipParams<any, any, any>) => string | any) | TooltipValueGetterFunc<any, any, any>;
+        checkboxSelection?: boolean | CheckboxSelectionCallback<any> | CheckboxSelectionCallback_2<any, any, any>;
+        showDisabledCheckboxes?: boolean;
+        icons?: {
+            [key: string]: string | Function;
+        };
+        suppressNavigable?: boolean | SuppressNavigableCallback<any> | SuppressNavigableCallback_2<any, any, any>;
+        suppressKeyboardEvent?: ((params: SuppressKeyboardEventParams<any>) => boolean) | SuppressKeyboardEventFunc<any, any, any>;
+        suppressPaste?: boolean | SuppressPasteCallback<any> | SuppressPasteCallback_2<any, any, any>;
+        suppressFillHandle?: boolean;
+        hide?: boolean | null;
+        initialHide?: boolean;
+        lockVisible?: boolean;
+        lockPosition?: boolean | "left" | "right";
+        suppressMovable?: boolean;
+        editable?: boolean | EditableCallback<any> | EditableCallback_2<any, any, any>;
+        valueSetter?: string | ValueSetterFunc<any> | ValueSetterFunc_2<any, any, any>;
+        valueParser?: string | ValueParserFunc<any, any> | ValueParserFunc_2<any, any, any>;
+        cellEditor?: any;
+        cellEditorFramework?: any;
+        cellEditorParams?: any;
+        cellEditorSelector?: CellEditorSelectorFunc<any> | CellEditorSelectorFunc_2<any, any, any>;
+        singleClickEdit?: boolean;
+        cellEditorPopup?: boolean;
+        cellEditorPopupPosition?: "over" | "under";
+        onCellValueChanged?: ((event: NewValueParams<any>) => void) | ((event: NewValueParams_2<any, any, any>) => void);
+        onCellClicked?: ((event: CellClickedEvent<any, any>) => void) | ((event: CellClickedEvent_2<any, any, any>) => void);
+        onCellDoubleClicked?: ((event: CellDoubleClickedEvent<any, any>) => void) | ((event: CellDoubleClickedEvent_2<any, any, any>) => void);
+        onCellContextMenu?: ((event: CellContextMenuEvent<any, any>) => void) | ((event: CellContextMenuEvent_2<any, any, any>) => void);
+        getQuickFilterText?: ((params: GetQuickFilterTextParams<any, any>) => string) | GetQuickFilterText<any, any, any>;
+        filterValueGetter?: string | ValueGetterFunc<any> | ValueGetterFunc_2<any, any, any>;
+        floatingFilter?: boolean;
+        wrapHeaderText?: boolean;
+        autoHeaderHeight?: boolean;
+        headerComponent?: any;
+        headerComponentFramework?: any;
+        headerComponentParams?: any;
+        menuTabs?: ColumnMenuTab[];
+        columnsMenuParams?: ColumnsMenuParams;
+        suppressMenu?: boolean;
+        headerCheckboxSelection?: boolean | HeaderCheckboxSelectionCallback<any> | HeaderCheckboxSelectionCallback_2<any, any, any>;
+        headerCheckboxSelectionFilteredOnly?: boolean;
+        headerCheckboxSelectionCurrentPageOnly?: boolean;
+        chartDataType?: "category" | "series" | "time" | "excluded";
+        pinned?: boolean | "left" | "right" | null;
+        initialPinned?: boolean | "left" | "right";
+        lockPinned?: boolean;
+        pivot?: boolean | null;
+        initialPivot?: boolean;
+        pivotIndex?: number | null;
+        initialPivotIndex?: number;
+        pivotComparator?: (valueA: string, valueB: string) => number;
+        enablePivot?: boolean;
+        cellStyle?: CellStyle | CellStyleFunc<any> | CellStyleFunc_2<any, any, any>;
+        cellClass?: string | string[] | CellClassFunc<any> | CellClassFunc_2<any, any, any>;
+        cellClassRules?: CellClassRules<any> | CellClassRules_2<any, any, any>;
+        cellRenderer?: any;
+        cellRendererFramework?: any;
+        cellRendererParams?: any;
+        cellRendererSelector?: CellRendererSelectorFunc<any> | CellRendererSelectorFunc_2<any, any, any>;
+        autoHeight?: boolean;
+        wrapText?: boolean;
+        enableCellChangeFlash?: boolean;
+        suppressCellFlash?: boolean;
+        rowDrag?: boolean | RowDragCallback<any> | RowDragCallback_2<any, any, any>;
+        rowDragText?: RowDragTextFunc | ((params: IRowDragItem, dragItemCount: number) => string);
+        dndSource?: boolean | DndSourceCallback<any> | DndSourceCallback_2<any, any, any>;
+        dndSourceOnRowDrag?: ((params: DndSourceOnRowDragParams<any>) => void) | DndSourceOnRowDragFunc<any, any>;
+        rowGroup?: boolean | null;
+        initialRowGroup?: boolean;
+        rowGroupIndex?: number | null;
+        initialRowGroupIndex?: number;
+        enableRowGroup?: boolean;
+        enableValue?: boolean;
+        aggFunc?: string | IAggFunc<any, any> | IAggFunc_2<any, any, any>;
+        initialAggFunc?: string | IAggFunc<any, any> | IAggFunc_2<any, any, any>;
+        defaultAggFunc?: string;
+        allowedAggFuncs?: string[];
+        showRowGroup?: string | boolean;
+        sortable?: boolean;
+        sort?: "asc" | "desc" | SortDef;
+        initialSort?: "asc" | "desc" | SortDef;
+        sortIndex?: number | null;
+        initialSortIndex?: number;
+        sortingOrder?: (SortDirection | SortDef)[];
+        comparator?: ((valueA: any, valueB: any, nodeA: IRowNode<any>, nodeB: IRowNode<any>, isDescending: boolean) => number) | SortComparatorFn<any, any> | Partial<Record<SortType, SortComparatorFn<any, any>>>;
+        unSortIcon?: boolean;
+        colSpan?: ((params: ColSpanParams<any>) => number) | ColSpanFunc<any, any, any>;
+        rowSpan?: ((params: RowSpanParams<any>) => number) | RowSpanFunc<any, any, any>;
+        width?: number;
+        initialWidth?: number;
+        minWidth?: number;
+        maxWidth?: number;
+        flex?: number | null;
+        initialFlex?: number;
+        resizable?: boolean;
+        suppressSizeToFit?: boolean;
+        suppressAutoSize?: boolean;
+        pivotValueColumn?: Column_2 | Column<any>;
+        pivotTotalColumnIds?: string[];
+        spanHeaderHeight?: boolean;
+        headerName?: string;
+        headerValueGetter?: string | HeaderValueGetterFunc<any> | HeaderValueGetterFunc_2<any, any, any>;
+        headerTooltip?: string;
+        headerClass?: string | string[] | ((params: HeaderClassParams<any>) => string | string[] | undefined) | ((params: HeaderClassParams_2<any, any, any>) => string | string[] | undefined);
+        suppressHeaderKeyboardEvent?: ((params: SuppressHeaderKeyboardEventParams<any>) => boolean) | SuppressHeaderKeyboardEventFunc<any, any, any>;
+        columnGroupShow?: "open" | "closed";
+        toolPanelClass?: string | string[] | ((params: ToolPanelClassParams<any>) => string | string[] | undefined) | ((params: ToolPanelClassParams_2<any, any, any>) => string | string[] | undefined);
+        suppressColumnsToolPanel?: boolean;
+        suppressFiltersToolPanel?: boolean;
+        tooltipComponent?: any;
+        tooltipComponentFramework?: any;
+        tooltipComponentParams?: any;
+        pivotKeys?: string[];
+        filter?: any;
+        filterFramework?: any;
+        filterParams?: any;
+        floatingFilterComponent?: any;
+        floatingFilterComponentFramework?: any;
+        floatingFilterComponentParams?: any;
+        cellDataType?: boolean | string;
+        allowFormula?: boolean;
+        calculatedExpression?: string;
+        tooltipComponentSelector?: CellEditorSelectorFunc_2 | CellRendererSelectorFunc_2;
+        suppressNoteActions?: boolean | SuppressNoteActionsCallback<any, any, any>;
+        useValueFormatterForExport?: boolean;
+        groupRowEditable?: boolean | GroupRowEditableCallback<any, any>;
+        groupRowValueSetter?: boolean | GroupRowValueSetterFunc<any, any> | GroupRowValueSetterOptions<any, any, any>;
+        useValueParserForImport?: boolean;
+        suppressFloatingFilterButton?: boolean;
+        dateComponent?: any;
+        dateComponentParams?: any;
+        getFindText?: GetFindTextFunc<any, any, any>;
+        columnChooserParams?: ColumnChooserParams;
+        suppressHeaderMenuButton?: boolean;
+        suppressHeaderFilterButton?: boolean;
+        mainMenuItems?: (MenuItemDef<any, any> | DefaultMenuItem)[] | GetMainMenuItems<any>;
+        contextMenuItems?: (MenuItemDef<any, any> | DefaultMenuItem)[] | GetContextMenuItems<any>;
+        loadingCellRenderer?: any;
+        loadingCellRendererParams?: any;
+        loadingCellRendererSelector?: ILoadingCellRendererSelectorFunc<any, any, any>;
+        valueIndex?: number;
+        initialValueIndex?: number;
+        showValuesAs?: ShowValuesAsType | ShowValuesAs | null;
+        initialShowValuesAs?: ShowValuesAsType | ShowValuesAs;
+        showValuesAsDef?: ShowValuesAsDef<any, any>;
+        enableShowValuesAs?: boolean;
+        rowGroupingHierarchy?: (string | ColDef_2<any, any>)[];
+        groupHierarchy?: (string | ColDef_2<any, any>)[];
+        spanRows?: boolean | SpanRowsFunc<any, any, any>;
+        suppressSpanHeaderHeight?: boolean;
+        headerTooltipValueGetter?: HeaderTooltipValueGetterFunc<any, any, any>;
+        headerStyle?: HeaderStyle | HeaderStyleFunc<any, any, any>;
+        cellAriaRole?: string;
+        context?: any;
+        suppressHeaderContextMenu?: boolean;
+    })[]>;
+    private panelExists;
+    private addRowCountPanel;
+    private addMaxRowsPanel;
+    private addAggregationPanel;
+    private addDatasourcePanels;
+    protected setupStatusBar(gridOptions: GridOptions_2): void;
+    get observedAttributes(): string[];
+    agAttributeChangedCallback(attName: any, oldValue: any, newValue: any): void;
+    globalEventListener(eventType: any, event: any): void;
+}
+
+declare const GridPro_base: (new (...args: any[]) => {
+    #_container: FoundationLayoutContainer | LayoutCacheContainer | DOMContainer;
+    #_latestTokenCode: string;
+    #_hasFirstLoaded: boolean;
+    #_cleanupTimeout: NodeJS.Timeout;
+    #_shouldForceLifecycle: boolean;
+    #_blockedDisconnectSurvivedGracePeriod: boolean;
+    cloneNode(deep?: boolean): Node;
+    deepClone(): Node;
+    get shouldRunDisconnect(): boolean;
+    get shouldRunConnect(): boolean;
+    #_blockLifecycleDueToTokenChange(lifecycleType: "connect" | "disconnect" | "reconnect"): boolean;
+    #_tryFindContainingLayout(e: Element): FoundationLayoutContainer | LayoutCacheContainer | DOMContainer;
+    connectedCallback(): void;
+    readonly $fastController: Controller;
+    $emit(type: string, detail?: any, options?: Omit<CustomEventInit, "detail">): boolean | void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(name: string, oldValue: string, newValue: string): void;
+    accessKey: string;
+    readonly accessKeyLabel: string;
+    autocapitalize: string;
     autocorrect: boolean;
     dir: string;
     draggable: boolean;
@@ -4500,594 +4641,79 @@ export declare class GridProBaseDatasource extends GenesisGridDatasourceElement
 }
 
 /**
- * The Grid Pro element (AG Grid v35 compatible).
- * @remarks Grid Pro is a Web Component wrapper around the AG Grid Community library.
- * @beta
- * @tagname %%prefix%%-grid-pro
- *
- * @fires gridReady - Fired when AG Grid is ready (detail includes the grid-ready event and grid id). detail: `GridReadyEventDetail`
- * @fires onGridReady - Deprecated alias for the grid-ready signal; prefer `gridReady`. detail: `GridReadyEventDetail`
- * @fires gridready - Native `Event` from `globalEventListener` when AG Grid fires `gridReady` (`agGridDetails` holds the AG Grid event)
- * @remarks Re-emits AG Grid public API events when listeners are registered via `addEventListener` (event names match AG Grid public event strings). The same AG Grid events are also dispatched as native `Event`s with lowercased `type` and payload on `agGridDetails` (for example `addEventListener('columnresized', ...)`).
+ * The available Grid Pro header case types
+ * @public
  */
-export declare class GridProBeta extends GridProBeta_base {
-    gridApi: GridApi;
-    gridErrorItems: GridProErrorItem<GridProErrorEvent['detail']>[];
-    statePersistence: StatePersistence;
-    /**
-     * Timeout function used to debounce resize calls
-     * @internal
-     */
-    private debounced;
-    private disposed;
-    private readonly debouncedSaveColumnState;
-    private readonly debouncedSaveFilterModel;
-    private readonly debouncedNotifyDatasourceVisibleColumns;
-    autoCellRendererByType: boolean;
-    onlyTemplateColDefs: boolean;
-    /**
-     * Boolean attribute to control whether the grid autosizes the columns upon interaction.
-     * This will disable the column widths from being manually set, and doesn't save the widths
-     * in local storage if you are using `persist-column-state-key`.
-     */
-    gridAutosizingEnabled: boolean;
-    /**
-     * If false, will disable cell flashing for all cells by default, unless otherwise defined in custom colDef
-     * @remarks Defaults to true
-     */
-    enableCellFlashing: boolean;
-    /**
-     * If true, will enable row flashing for all rows for `add` async transactions
-     */
-    enableRowFlashing: boolean;
-    /** Wired to `gridOptions.context` for columns picker → grid drag (see bridge module). */
-    private readonly columnDragBridge;
-    /** @internal Shared AG column-drag bridge for custom tool panels. */
-    getColumnDragBridge(): GridProColumnDragBridge;
-    /**
-     * The key to use for persisting the column state in local browser or KV storage.
-     */
-    persistColumnStateKey: string;
-    /**
-     * The key to use for persisting the filter model in local browser or KV storage.
-     */
-    persistFilterModelKey: string;
-    /**
-     * The case type to use for the header names. If not set, the default CONSTANT_CASE will be used.
-     * @remarks Can be one of the following: camelCase, capitalCase, dotCase, headerCase, noCase, paramCase, pascalCase, pathCase, sentenceCase, snakeCase.
-     * @public
-     */
-    headerCaseType: GridProCaseType;
-    /**
-     * The row data to display in the grid.
-     * @remarks For scenarios where you want to set data manually, without relying on `<grid-pro-client-side-datasource>`.
-     * @public
-     */
-    rowData: any[];
-    rowDataChanged(_: any, rowData: any): void;
-    columnComponentName: string;
-    eventsAndCallbacks: GridProEventsAndCallbacks;
-    headerHeight: number;
-    rowHeight: number;
-    classNames: string;
-    agGrid: GridApi;
-    gridSlot: HTMLSlotElement;
-    /**
-     * The slot ref binds asynchronously, and the queued `initGrid` skips any run that beats it. FAST
-     * calls this the moment the ref lands, so a grid whose options were set BEFORE the view bound
-     * still initialises rather than staying blank — closing the one gap that skip would leave.
-     *
-     * Guarded on `agGridOptions` as well: without options there is nothing to build, and AG Grid
-     * would only log "no gridOptions provided to the grid". Those arrive via a grid-options change,
-     * which re-runs `initGrid` on its own.
-     */
-    gridSlotChanged(): void;
-    themeMode: 'light' | 'dark';
-    gridComponents: {
-        [componentName: string]: any;
-    };
-    /**
-     * Configuration for the grid status bar components.
-     * @remarks
-     * This requires AG Grid Enterprise module to be enabled.
-     * The status bar will only be displayed if the Enterprise module is available.
-     * @see https://www.ag-grid.com/javascript-data-grid/component-status-bar/
-     */
-    statusBarConfig: GridProStatusBarConfig;
-    /**
-     * Enables or disables the grid status bar.
-     * @remarks
-     * Default is false.
-     * When disabled, no status bar will be displayed regardless of statusBarConfig.
-     * This requires AG Grid Enterprise module to be available for the status bar to be displayed when enabled.
-     */
-    withStatusBar: boolean;
-    /**
-     * Shows a Column Selection button above the grid.
-     * @public
-     */
-    enableColumnSelection: boolean;
-    enableColumnSelectionChanged(): void;
-    /**
-     * Custom error handler dialog template function.
-     * @remarks
-     * When provided, this function will be used to render custom error dialogs instead of the default error handler.
-     * The function should accept a prefix string and an array of grid error items and return a ViewTemplate.
-     * If not provided, the default error handler dialog template will be used.
-     */
-    customErrorHandlerTemplate?: (prefix: string, gridErrorItems: GridProErrorItem<any>[]) => ViewTemplate;
-    private columnState;
-    protected agAttributes: Record<string, any>;
-    protected agPropertiesMap: Record<string, string>;
-    protected agGridOptions: GridOptions_2;
-    /** User-supplied grid options cached as merge base for datasource re-init. */
-    private userProvidedGridOptions;
-    private applyingDatasourceGridOptions;
-    protected initialised: boolean;
-    private rehydrationAttempted;
-    /** A schemaUpdated that arrived before `gridApi` existed; replayed in onGridReady. */
-    private pendingSchemaUpdate?;
-    private rootEventsListeners;
-    private datasourceEventHandlers;
-    private gridEventsQueue;
-    private registeredGridEvents;
-    private gridEventListeners;
-    private luminanceSubscription?;
-    private visibilityObserverCleanup?;
-    private readonly boundGlobalEventListener;
-    private _filterConfig;
-    getfilterModel(): Promise<{
-        [key: string]: any;
-    }>;
-    setFilterModel(value: {
-        [key: string]: any;
-    }): Promise<void>;
-    /**
-     * Injectable config that allows to change grid options on an app level basis
-     * To modify options, register instance of the config in DOM container that is
-     * above the grid or on the top level of the application, so it applies to all grids.
-     *
-     * @example
-     * ```
-     * DI.getOrCreateDOMContainer().register([
-     *       Registration.instance<GridOptionsConfig>(GridOptionsConfig, {
-     *         headerHeight: 50,
-     *       }),
-     *     ]);
-     * ```
-     */
-    gridOptionsConfig: GridOptionsConfig;
-    provider: any;
-    constructor();
-    /**
-     * Adds an event listener to the grid element.
-     * @param eventType - The event type to listen for. Recommened to use the `Events` from AG Grid.
-     * @param listener - The event listener to call when the event is fired.
-     * @param options - An options object that specifies characteristics about the event listener.
-     * @privateRemarks
-     * This will change once we do the AG Upgrade and `eventType` will be correctly typed.
-     */
-    addEventListener(eventType: string, listener: any, options?: boolean | AddEventListenerOptions): void;
-    private addGridEventListener;
-    private handleError;
-    private handleBaseDatasourceError;
-    hideDatasourceError(): void;
-    private handleLuminanceChange;
-    private readonly luminanceObserver;
-    connectedCallback(): void;
-    disconnectedCallback(): void;
-    private syncColumnSelectionHostLayout;
-    private performDisconnectCleanup;
-    private destroyGridInstance;
-    /**
-     * Helper method to add or remove datasource event listeners
-     * @internal
-     */
-    private toggleDatasourceEventListeners;
-    /**
-     * Handles datasource initialization
-     * @internal
-     */
-    private handleInitialize;
-    /**
-     * Handles data loading from datasource
-     * @internal
-     */
-    private handleDataLoaded;
-    /**
-     * Handles data changes from datasource
-     * @internal
-     */
-    private handleDataChanged;
-    /**
-     * Whether the live grid runs AG Grid's client-side row model (the default when the datasource
-     * set no `rowModelType`).
-     * @internal
-     */
-    private get isClientSideRowModel();
-    private flashAddedCells;
-    /**
-     * Handles schema updates from datasource
-     * @internal
-     */
-    private handleSchemaUpdated;
-    /**
-     * Builds and applies column defs from a schema payload.
-     * @internal
-     */
-    private processSchemaUpdate;
-    /**
-     * Downgrades enterprise filters in metadata-generated colDefs when their modules are not
-     * registered — from v35 AG Grid throws on unregistered filters instead of falling back.
-     * Enum columns (recognised by their metadata-sourced set-filter values) keep those values by
-     * falling back to the community `EnumColumnFilter` instead of a plain text filter.
-     *
-     * The enum floating filter is only wired as the column's component, not enabled: AG's floating
-     * filter is a full-width header row, so enabling it for one column changes the layout of every
-     * column. Active-filter state is surfaced instead by AG's native header filter icon plus the
-     * header tooltip the enum filter maintains; consumers wanting the floating row opt in with
-     * `floatingFilter: true`.
-     * @internal
-     */
-    private applyCommunityFilterFallbacks;
-    /**
-     * Handles data clearing from datasource
-     * @internal
-     */
-    private handleDataCleared;
-    /**
-     * Handles loading started from datasource
-     * @internal
-     */
-    private handleLoadingStarted;
-    /**
-     * Handles loading finished from datasource
-     * @internal
-     */
-    private handleLoadingFinished;
-    /**
-     * Handles no data available from datasource
-     * @internal
-     */
-    private handleNoDataAvailable;
-    /**
-     * Handles filter restoration from datasource
-     * @internal
-     */
-    private handleFiltersRestored;
-    /**
-     * Handles more data availability from datasource
-     * @internal
-     */
-    private handleMoreDataAvailable;
-    /**
-     * Handles datasource errors
-     * @internal
-     */
-    private handleDatasourceError;
-    /**
-     * Handles datasource destroy
-     * @internal
-     */
-    private handleDatasourceDestroy;
-    /**
-     * Handles refreshing server-side data
-     * @internal
-     */
-    private handleRefreshServerSide;
-    /**
-     * Handles setting server-side datasource
-     * @internal
-     */
-    private handleSetServerSideDatasource;
-    /**
-     * Handles adding CSS class to grid element
-     * @internal
-     */
-    private handleAddGridCssClass;
-    /**
-     * Handles removing CSS class from grid element
-     * @internal
-     */
-    private handleRemoveGridCssClass;
-    /**
-     * Handles applying server-side transactions
-     * @internal
-     */
-    private handleApplyServerSideTransaction;
-    /**
-     * Handles setting infinite datasource
-     * @internal
-     */
-    private handleSetInfiniteDatasource;
-    /**
-     * Handles refreshing the infinite cache.
-     * @remarks Mirrors {@link GridProBeta.handleRefreshServerSide}: `purge` drops the block cache
-     * and re-reads, otherwise the loaded blocks are re-read in place.
-     * @internal
-     */
-    private handleRefreshInfiniteCache;
-    combineAllGridComponents(gridOptionsComponents: GridComponents): GridComponents;
-    statePersistanceEnabled(): boolean;
-    /**
-     * Gets the currently selected rows from the grid
-     * @public
-     * @returns Array of selected row data
-     */
-    getSelectedRows(): any[];
-    /**
-     * Gets the row data from selected cell ranges
-     * @internal
-     * @returns Array containing the row data from selected cell ranges, or empty array if none
-     */
-    private getCellRangeRowData;
-    /**
-     * Checks if any rows are currently selected
-     * @public
-     * @returns True if rows are selected, false otherwise
-     */
-    hasSelectedRows(): boolean;
-    /**
-     * Updates the label-value status bar component with new label and value
-     * @public
-     * @param params - Object containing label, value, and optionally hide flag
-     * @example
-     * ```ts
-     * gridPro.updateLabelValueStatusBar({
-     *   label: 'Total Records',
-     *   value: '1,234',
-     *   hide: false
-     * });
-     * ```
-     */
-    updateLabelValueStatusBar(params: GridProStatusBarLabelConfig): void;
-    /**
-     * Because we try and resize the grid to fit using callbacks on events, this will cause
-     * a stack overflow of calls to resize, so we need to debounce it.
-     * @internal
-     */
-    private debouncedColumnAutosize;
-    /**
-     * If {@link @genesislcap/grid-pro#GridPro.gridAutosizingEnabled} is true, will remove the widths from the column states.
-     * @internal
-     */
-    private removeConfigWidthsToAutosize;
-    private saveColumnState;
-    /**
-     * Gets the saved grid ColumnState[] from storage
-     * @remarks This is used to restore the grid state when the grid is rehydrated
-     * @privateRemarks Not using `columnApi.get|setColumnState()` for these flows as it doesn't work setting new columnDefs vs different ordering.
-     * @public
-     */
-    getSavedColumnState(): Promise<ColumnState_2[]>;
-    private restoreColumnState;
-    cacheFilterConfig(): void;
-    restoreCachedFilterConfig(): Promise<void>;
-    /**
-     * @public
-     */
-    get gridOptions(): GridOptions_2;
-    /**
-     * @public
-     */
-    get isServerSide(): boolean;
-    /**
-     * @public
-     */
-    get gridParams(): GridParams_2;
-    /**
-     * Get the datasource element.
-     * @remarks This will return the first datasource element found in the light DOM, wrapping all concrete datasource implementations.
-     * @public
-     */
-    get gridProDatasource(): GridProBaseDatasource;
-    /**
-     * @public
-     */
-    get isInfiniteRowModel(): boolean;
-    /**
-     * Reports the currently visible columns to the datasource. The datasource decides what to do with
-     * them (e.g. narrowing the server request); the grid stays agnostic of that behaviour.
-     * @internal
-     */
-    private notifyDatasourceVisibleColumns;
-    set gridOptions(options: GridOptions_2);
-    private setLocalGridOptions;
-    /**
-     * Clears the local grid options, this is used to clear the grid options when the grid is restarted.
-     * @public
-     */
-    clearLocalGridOptions(): void;
-    private resetGridOptionsState;
-    private initGrid;
-    /**
-     * Will merge templated column definitions with `columnDefs` plus localStorage's column state or `deferredColumnStates`.
-     * @public
-     * @remarks This will favor the column state from the browser's local storage over the `deferredColumnStates` property on the `grid-pro-genesis-datasource` element.
-     * @param columnDefs - The column definitions to apply to the grid.
-     * @param deferredColumnDefsOrState - If true, will merge the column definitions with the saved column state or the `deferredColumnStates` property
-     * on the `grid-pro-genesis-datasource` element. Defaults to false but `grid-pro-genesis-datasource` will set this to true.
-     * @returns The merged column definitions.
-     */
-    mergeAllColumnDefsAndStates(columnDefs: ColDef_2[], deferredColumnDefsOrState?: boolean): Promise<(ColDef<any> | ColGroupDef<any>)[] | (ColDef_2<any, any> | {
-        colId?: string;
-        field?: string;
-        type?: string | string[];
-        valueGetter?: string | ValueGetterFunc<any> | ValueGetterFunc_2<any, any, any>;
-        valueFormatter?: string | ValueFormatterFunc<any> | ValueFormatterFunc_2<any, any, any>;
-        refData?: RefData;
-        keyCreator?: ((params: KeyCreatorParams<any, any>) => string) | KeyCreatorFunc<any, any, any>;
-        equals?: (valueA: any, valueB: any) => boolean;
-        tooltipField?: string;
-        tooltipValueGetter?: ((params: ITooltipParams<any, any, any>) => string | any) | TooltipValueGetterFunc<any, any, any>;
-        checkboxSelection?: boolean | CheckboxSelectionCallback<any> | CheckboxSelectionCallback_2<any, any, any>;
-        showDisabledCheckboxes?: boolean;
-        icons?: {
-            [key: string]: string | Function;
-        };
-        suppressNavigable?: boolean | SuppressNavigableCallback<any> | SuppressNavigableCallback_2<any, any, any>;
-        suppressKeyboardEvent?: ((params: SuppressKeyboardEventParams<any>) => boolean) | SuppressKeyboardEventFunc<any, any, any>;
-        suppressPaste?: boolean | SuppressPasteCallback<any> | SuppressPasteCallback_2<any, any, any>;
-        suppressFillHandle?: boolean;
-        hide?: boolean | null;
-        initialHide?: boolean;
-        lockVisible?: boolean;
-        lockPosition?: boolean | "left" | "right";
-        suppressMovable?: boolean;
-        editable?: boolean | EditableCallback<any> | EditableCallback_2<any, any, any>;
-        valueSetter?: string | ValueSetterFunc<any> | ValueSetterFunc_2<any, any, any>;
-        valueParser?: string | ValueParserFunc<any, any> | ValueParserFunc_2<any, any, any>;
-        cellEditor?: any;
-        cellEditorFramework?: any;
-        cellEditorParams?: any;
-        cellEditorSelector?: CellEditorSelectorFunc<any> | CellEditorSelectorFunc_2<any, any, any>;
-        singleClickEdit?: boolean;
-        cellEditorPopup?: boolean;
-        cellEditorPopupPosition?: "over" | "under";
-        onCellValueChanged?: ((event: NewValueParams<any>) => void) | ((event: NewValueParams_2<any, any, any>) => void);
-        onCellClicked?: ((event: CellClickedEvent<any, any>) => void) | ((event: CellClickedEvent_2<any, any, any>) => void);
-        onCellDoubleClicked?: ((event: CellDoubleClickedEvent<any, any>) => void) | ((event: CellDoubleClickedEvent_2<any, any, any>) => void);
-        onCellContextMenu?: ((event: CellContextMenuEvent<any, any>) => void) | ((event: CellContextMenuEvent_2<any, any, any>) => void);
-        getQuickFilterText?: ((params: GetQuickFilterTextParams<any, any>) => string) | GetQuickFilterText<any, any, any>;
-        filterValueGetter?: string | ValueGetterFunc<any> | ValueGetterFunc_2<any, any, any>;
-        floatingFilter?: boolean;
-        wrapHeaderText?: boolean;
-        autoHeaderHeight?: boolean;
-        headerComponent?: any;
-        headerComponentFramework?: any;
-        headerComponentParams?: any;
-        menuTabs?: ColumnMenuTab[];
-        columnsMenuParams?: ColumnsMenuParams;
-        suppressMenu?: boolean;
-        headerCheckboxSelection?: boolean | HeaderCheckboxSelectionCallback<any> | HeaderCheckboxSelectionCallback_2<any, any, any>;
-        headerCheckboxSelectionFilteredOnly?: boolean;
-        headerCheckboxSelectionCurrentPageOnly?: boolean;
-        chartDataType?: "category" | "series" | "time" | "excluded";
-        pinned?: boolean | "left" | "right" | null;
-        initialPinned?: boolean | "left" | "right";
-        lockPinned?: boolean;
-        pivot?: boolean | null;
-        initialPivot?: boolean;
-        pivotIndex?: number | null;
-        initialPivotIndex?: number;
-        pivotComparator?: (valueA: string, valueB: string) => number;
-        enablePivot?: boolean;
-        cellStyle?: CellStyle | CellStyleFunc<any> | CellStyleFunc_2<any, any, any>;
-        cellClass?: string | string[] | CellClassFunc<any> | CellClassFunc_2<any, any, any>;
-        cellClassRules?: CellClassRules<any> | CellClassRules_2<any, any, any>;
-        cellRenderer?: any;
-        cellRendererFramework?: any;
-        cellRendererParams?: any;
-        cellRendererSelector?: CellRendererSelectorFunc<any> | CellRendererSelectorFunc_2<any, any, any>;
-        autoHeight?: boolean;
-        wrapText?: boolean;
-        enableCellChangeFlash?: boolean;
-        suppressCellFlash?: boolean;
-        rowDrag?: boolean | RowDragCallback<any> | RowDragCallback_2<any, any, any>;
-        rowDragText?: RowDragTextFunc | ((params: IRowDragItem, dragItemCount: number) => string);
-        dndSource?: boolean | DndSourceCallback<any> | DndSourceCallback_2<any, any, any>;
-        dndSourceOnRowDrag?: ((params: DndSourceOnRowDragParams<any>) => void) | DndSourceOnRowDragFunc<any, any>;
-        rowGroup?: boolean | null;
-        initialRowGroup?: boolean;
-        rowGroupIndex?: number | null;
-        initialRowGroupIndex?: number;
-        enableRowGroup?: boolean;
-        enableValue?: boolean;
-        aggFunc?: string | IAggFunc<any, any> | IAggFunc_2<any, any, any>;
-        initialAggFunc?: string | IAggFunc<any, any> | IAggFunc_2<any, any, any>;
-        defaultAggFunc?: string;
-        allowedAggFuncs?: string[];
-        showRowGroup?: string | boolean;
-        sortable?: boolean;
-        sort?: "asc" | "desc" | SortDef;
-        initialSort?: "asc" | "desc" | SortDef;
-        sortIndex?: number | null;
-        initialSortIndex?: number;
-        sortingOrder?: (SortDirection | SortDef)[];
-        comparator?: ((valueA: any, valueB: any, nodeA: IRowNode<any>, nodeB: IRowNode<any>, isDescending: boolean) => number) | SortComparatorFn<any, any> | Partial<Record<SortType, SortComparatorFn<any, any>>>;
-        unSortIcon?: boolean;
-        colSpan?: ((params: ColSpanParams<any>) => number) | ColSpanFunc<any, any, any>;
-        rowSpan?: ((params: RowSpanParams<any>) => number) | RowSpanFunc<any, any, any>;
-        width?: number;
-        initialWidth?: number;
-        minWidth?: number;
-        maxWidth?: number;
-        flex?: number | null;
-        initialFlex?: number;
-        resizable?: boolean;
-        suppressSizeToFit?: boolean;
-        suppressAutoSize?: boolean;
-        pivotValueColumn?: Column_2 | Column<any>;
-        pivotTotalColumnIds?: string[];
-        spanHeaderHeight?: boolean;
-        headerName?: string;
-        headerValueGetter?: string | HeaderValueGetterFunc<any> | HeaderValueGetterFunc_2<any, any, any>;
-        headerTooltip?: string;
-        headerClass?: string | string[] | ((params: HeaderClassParams<any>) => string | string[] | undefined) | ((params: HeaderClassParams_2<any, any, any>) => string | string[] | undefined);
-        suppressHeaderKeyboardEvent?: ((params: SuppressHeaderKeyboardEventParams<any>) => boolean) | SuppressHeaderKeyboardEventFunc<any, any, any>;
-        columnGroupShow?: "open" | "closed";
-        toolPanelClass?: string | string[] | ((params: ToolPanelClassParams<any>) => string | string[] | undefined) | ((params: ToolPanelClassParams_2<any, any, any>) => string | string[] | undefined);
-        suppressColumnsToolPanel?: boolean;
-        suppressFiltersToolPanel?: boolean;
-        tooltipComponent?: any;
-        tooltipComponentFramework?: any;
-        tooltipComponentParams?: any;
-        pivotKeys?: string[];
-        filter?: any;
-        filterFramework?: any;
-        filterParams?: any;
-        floatingFilterComponent?: any;
-        floatingFilterComponentFramework?: any;
-        floatingFilterComponentParams?: any;
-        cellDataType?: boolean | string;
-        allowFormula?: boolean;
-        calculatedExpression?: string;
-        tooltipComponentSelector?: CellEditorSelectorFunc_2 | CellRendererSelectorFunc_2;
-        suppressNoteActions?: boolean | SuppressNoteActionsCallback<any, any, any>;
-        useValueFormatterForExport?: boolean;
-        groupRowEditable?: boolean | GroupRowEditableCallback<any, any>;
-        groupRowValueSetter?: boolean | GroupRowValueSetterFunc<any, any> | GroupRowValueSetterOptions<any, any, any>;
-        useValueParserForImport?: boolean;
-        suppressFloatingFilterButton?: boolean;
-        dateComponent?: any;
-        dateComponentParams?: any;
-        getFindText?: GetFindTextFunc<any, any, any>;
-        columnChooserParams?: ColumnChooserParams;
-        suppressHeaderMenuButton?: boolean;
-        suppressHeaderFilterButton?: boolean;
-        mainMenuItems?: (MenuItemDef<any, any> | DefaultMenuItem)[] | GetMainMenuItems<any>;
-        contextMenuItems?: (MenuItemDef<any, any> | DefaultMenuItem)[] | GetContextMenuItems<any>;
-        loadingCellRenderer?: any;
-        loadingCellRendererParams?: any;
-        loadingCellRendererSelector?: ILoadingCellRendererSelectorFunc<any, any, any>;
-        valueIndex?: number;
-        initialValueIndex?: number;
-        showValuesAs?: ShowValuesAsType | ShowValuesAs | null;
-        initialShowValuesAs?: ShowValuesAsType | ShowValuesAs;
-        showValuesAsDef?: ShowValuesAsDef<any, any>;
-        enableShowValuesAs?: boolean;
-        rowGroupingHierarchy?: (string | ColDef_2<any, any>)[];
-        groupHierarchy?: (string | ColDef_2<any, any>)[];
-        spanRows?: boolean | SpanRowsFunc<any, any, any>;
-        suppressSpanHeaderHeight?: boolean;
-        headerTooltipValueGetter?: HeaderTooltipValueGetterFunc<any, any, any>;
-        headerStyle?: HeaderStyle | HeaderStyleFunc<any, any, any>;
-        cellAriaRole?: string;
-        context?: any;
-        suppressHeaderContextMenu?: boolean;
-    })[]>;
-    private panelExists;
-    private addRowCountPanel;
-    private addMaxRowsPanel;
-    private addAggregationPanel;
-    private addDatasourcePanels;
-    protected setupStatusBar(gridOptions: GridOptions_2): void;
-    get observedAttributes(): string[];
-    agAttributeChangedCallback(attName: any, oldValue: any, newValue: any): void;
-    globalEventListener(eventType: any, event: any): void;
+export declare enum GridProCaseType {
+    camelCase = "camelCase",
+    capitalCase = "capitalCase",
+    dotCase = "dotCase",
+    headerCase = "headerCase",
+    noCase = "noCase",
+    paramCase = "paramCase",
+    pascalCase = "pascalCase",
+    pathCase = "pathCase",
+    sentenceCase = "sentenceCase",
+    snakeCase = "snakeCase"
+}
+
+/**
+ * The Grid Pro Cell element.
+ * @remarks Used inside the Grid Pro Column element, to define a cell renderer from the template.
+ * @public
+ */
+export declare class GridProCell extends FoundationElement implements ICellRendererComp {
+    renderer: ICellRendererFunc;
+    rendererParams: ICellRendererParams;
+    slottedRenderer: HTMLElement[];
+    connectedCallback(): void;
+    init(params: ICellRendererParams): void;
+    getGui(): HTMLElement;
+    destroy(): void;
+    refresh(params: ICellRendererParams): boolean;
+    slottedAgRendererChanged(): void;
+}
+
+/**
+ * The Genesis Datasource element, for client-side | CSRM-compatible data fetching and used exclusively by the GridPro element.
+ * @remarks Only supports Client-Side Row Model.
+ * @public
+ *
+ * @fires base-datasource-error - Fired when a datasource error is reported. detail: `BaseDatasourceErrorEventDetail`
+ * @fires datasource-error - Fired when a datasource error occurs (for grid integration). detail: `DatasourceErrorEventDetail`
+ * @fires base-datasource-connected - Fired when error state is cleared after connection succeeds
+ * @fires datasource-loading-finished - Fired when loading completes with no pending row changes
+ * @fires datasource-no-data-available - Fired when the grid has no rows after load
+ * @fires datasource-data-changed - Fired when row data changes from stream updates. detail: `DataChangedEventDetail`
+ * @fires datasource-initialize - Fired to hand off grid options and initialization flags. detail: `InitializeEventDetail`
+ * @fires datasource-destroy - Fired when the datasource is torn down
+ * @fires datasource-data-cleared - Fired when row data is cleared. detail: `DataClearedEventDetail`
+ * @fires datasource-schema-updated - Fired when column metadata or defs are updated. detail: `SchemaUpdatedEventDetail`
+ * @fires datasource-filters-restored - Fired when persisted filters are reapplied
+ * @fires datasource-data-loaded - Fired when a data payload is loaded for the grid. detail: `DataLoadedEventDetail`
+ * @fires datasource-loading-started - Fired when a load or refresh starts
+ * @fires datasource-more-data-available - Fired when more server rows can be requested. detail: `MoreDataAvailableEventDetail`
+ * @fires datasource-ready - Fired when the host grid is ready to start loading data
+ * @fires datasource-init - Fired when initial grid data is ready for the client-side model
+ * @fires more-rows-changed - Fired when MORE_ROWS availability changes. detail: `MoreRowsDetail`
+ * @fires datasource-size-changed - Fired when layout or viewport sizing affects the datasource. detail: `GrigProGenesisDatasourceSizeChangedEventDetail`
+ */
+export declare class GridProClientSideDatasource extends GridProGenesisDatasource {
+}
+
+/**
+ * The Grid Pro Column element.
+ * @remarks Used insde the Grid Pro element, to specify the column definitions (ColDef) for a given column.
+ * @public
+ */
+export declare class GridProColumn extends GridProColumn_base {
+    slottedAgCell: HTMLElement[];
+    definition: ColDef;
+    slottedAgCellChanged(): void;
+    deepClone(): Node;
 }
 
-declare const GridProBeta_base: (new (...args: any[]) => {
+declare const GridProColumn_base: (new (...args: any[]) => {
     #_container: FoundationLayoutContainer | LayoutCacheContainer | DOMContainer;
     #_latestTokenCode: string;
     #_hasFirstLoaded: boolean;
@@ -5456,41 +5082,115 @@ declare const GridProBeta_base: (new (...args: any[]) => {
 }) & typeof FoundationElement;
 
 /**
- * The available Grid Pro header case types
+ * Filled by {@link gridProColumnDragBridgeModule} after grid beans init.
+ * Read from `IToolPanelParams.context` / `api.getGridOption('context')`.
+ * @public
+ */
+export declare interface GridProColumnDragBridge {
+    dragAndDrop?: {
+        addDragSource: (source: GridDragSource, touchEnabled?: boolean) => void;
+        removeDragSource: (source: GridDragSource) => void;
+    };
+    gos?: GridOptionsService;
+}
+
+/** @public */
+export declare type GridProColumnDragBridgeContext = {
+    [GRID_PRO_COLUMN_DRAG_BRIDGE_CONTEXT_KEY]?: GridProColumnDragBridge;
+};
+
+/**
+ * Registers drag-and-drop beans on `gridOptions.context` so custom tool panels
+ * can call `dragAndDrop.addDragSource` (same contract as Enterprise Columns panel).
+ * @internal
+ */
+export declare const gridProColumnDragBridgeModule: Module;
+
+/**
+ * A directive that renders a set of grid-pro-column elements from a given input binding
+ *
+ * @param itemsBinding - The array to render
+ * @param includeRenderers - Optionally tells whether to include cell renderers, if available
  * @public
  */
-export declare enum GridProCaseType {
-    camelCase = "camelCase",
-    capitalCase = "capitalCase",
-    dotCase = "dotCase",
-    headerCase = "headerCase",
-    noCase = "noCase",
-    paramCase = "paramCase",
-    pascalCase = "pascalCase",
-    pathCase = "pathCase",
-    sentenceCase = "sentenceCase",
-    snakeCase = "snakeCase"
+export declare function gridProColumns<TSource = any>(itemsBinding: Binding<TSource, readonly ColDef[]> | readonly ColDef[], includeRenderers?: boolean): CaptureType<TSource>;
+
+/**
+ * @deprecated Use {@link ColumnSelectionHost}.
+ * @public
+ */
+export declare type GridProColumnSelectionHost = ColumnSelectionHost;
+
+/**
+ * Host layout when the Grid Pro column-selection toolbar is shown.
+ * @public
+ */
+export declare const gridProColumnSelectionHostStyles: ElementStyles;
+
+/**
+ * Grid Pro possible error events
+ * @public
+ */
+export declare type GridProErrorEvent = GridProGenesisDatasourceErrorEvent | CustomEvent<GridProErrorItem<any>>;
+
+/**
+ * Grid Pro Error Item
+ * @public
+ */
+export declare interface GridProErrorItem<GridProErrorItemDetailType> {
+    detail: GridProErrorItemDetailType;
+    type: GridProErrorTypes;
 }
 
 /**
- * The Grid Pro Cell element.
- * @remarks Used inside the Grid Pro Column element, to define a cell renderer from the template.
+ * The error names for the Grid Pro component.
  * @public
  */
-export declare class GridProCell extends FoundationElement implements ICellRendererComp {
-    renderer: ICellRendererFunc;
-    rendererParams: ICellRendererParams;
-    slottedRenderer: HTMLElement[];
-    connectedCallback(): void;
-    init(params: ICellRendererParams): void;
-    getGui(): HTMLElement;
-    destroy(): void;
-    refresh(params: ICellRendererParams): boolean;
-    slottedAgRendererChanged(): void;
+export declare const gridProErrorNames: {
+    readonly datasource: "datasource";
+    readonly unknown: "unknown";
+};
+
+/**
+ * Grid Pro Error Types
+ * @public
+ */
+export declare type GridProErrorTypes = keyof typeof gridProErrorNames;
+
+/**
+ * The event names for the Grid Pro component.
+ * @public
+ */
+export declare const gridProEventNames: {
+    datasourceErrorClose: string;
+};
+
+/**
+ * Grid Pro Events and Callbacks
+ * @remarks - This type is used to define the events and callbacks that can be passed to the grid
+ * @public
+ */
+export declare type GridProEventsAndCallbacks = OnlyFunctions<UntypeNonFunctions<GridOptions_2>>;
+
+/**
+ * Grid Pro Event Listeners
+ * @internal
+ */
+export declare type GridProEventsListeners = [string, (event: Event) => void][];
+
+/**
+ * The available Grid Pro column filter component names.
+ * @remarks Register-able via the grid `components` map; `enumFilter` is usable as a
+ * `ColDef.filter` value and `enumFloatingFilter` as a `ColDef.floatingFilterComponent`.
+ * @public
+ */
+export declare enum GridProFilterTypes {
+    enumFilter = "enumColumnFilter",
+    enumFloatingFilter = "enumColumnFloatingFilter"
 }
 
 /**
- * The Genesis Datasource element, for client-side | CSRM-compatible data fetching and used exclusively by the GridPro element.
+ * The Genesis Datasource element, for CSRM-compatible data fetching and used exclusively by the GridPro element.
  * @remarks Only supports Client-Side Row Model.
  * @public
  *
@@ -5513,22 +5213,176 @@ export declare class GridProCell extends FoundationElement implements ICellRende
  * @fires more-rows-changed - Fired when MORE_ROWS availability changes. detail: `MoreRowsDetail`
  * @fires datasource-size-changed - Fired when layout or viewport sizing affects the datasource. detail: `GrigProGenesisDatasourceSizeChangedEventDetail`
  */
-export declare class GridProClientSideDatasource extends GridProGenesisDatasource {
-}
-
-/**
- * The Grid Pro Column element.
- * @remarks Used insde the Grid Pro element, to specify the column definitions (ColDef) for a given column.
- * @public
- */
-export declare class GridProColumn extends GridProColumn_base {
-    slottedAgCell: HTMLElement[];
-    definition: ColDef;
-    slottedAgCellChanged(): void;
+export declare class GridProGenesisDatasource extends GridProGenesisDatasource_base {
+    private cachedRowArray;
+    protected transactionData: TransactionData_2;
+    criteriaChanged(oldCriteria: string, newCriteria: string): Promise<void>;
+    requestChanged(oldRequest: string, newRequest: string): void;
+    resourceNameChanged(oldValue: string, newValue: string): void;
+    keepColDefsOnClearRowData: boolean;
+    /**
+     * When enabled and column definitions are provided, the datasource requests data only for the
+     * columns that are currently visible. The visible set is seeded from the column config (columns
+     * not flagged with `hide`) and updated by the host grid via `setVisibleColumns`; the data
+     * is reloaded whenever that set changes.
+     * @remarks DATASERVER only.
+     * @default false
+     */
+    requestVisibleColumnsOnly: boolean;
+    private _visibleColumns;
+    private dataSub;
+    private updateSub;
+    private requiresFullRowDataAndColDefs;
+    private _lastMoreRows;
+    private _isMoreRowsResult;
+    private _sourceRef;
+    private _nextOffset;
+    private _loadMoreCount;
+    private readonly onDatasourceReady;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
     deepClone(): Node;
+    private colDefsDeepClone;
+    /**
+     * Initializes the datasource.
+     * @public
+     * @param columnDefinitions - Optionally set the `gridOptions` up with column definitions
+     * @param columnStates  - Optionally set the grid up with column state
+     * @remarks This method is called automatically when the element is connected to the DOM.
+     */
+    init(keepColDefsOnClearRowData?: boolean): Promise<void>;
+    private clearReadyListener;
+    /**
+     * Destroys the datasource, resetting it to its initial state.
+     * @public
+     */
+    destroy(): void;
+    /**
+     * Deinitialises the datasource, resetting it to its initial state.
+     * @deprecated Use `destroy` instead
+     * @public
+     */
+    deinit(): void;
+    /**
+     * Resets the datasource to its initial state.
+     * @public
+     * @deprecated Use `destroy` instead
+     */
+    reset(): void;
+    /**
+     * Restarts the datasource, uses `destroy` and `init` in sequence.
+     * @public
+     */
+    restart(): Promise<void>;
+    /**
+     * Force the grid to redispatch the current rows
+     */
+    refreshRows(): void;
+    /**
+     * Clears the rowData and columnDefs for the grid.
+     * @remarks This is called when `reloadResourceData` happens, on criteria and filters change or full `reset`.
+     * @param withColumnDefs - Whether to clear the columnDefs as well. Defaults to true.
+     * @internal
+     */
+    private clearRowData;
+    /**
+     * Sets the columnDefs and rowData for the grid.
+     * @remarks This should only happen once, when the grid is first initialized. Follow up updates will use transactions.
+     * @internal
+     */
+    private setRowData;
+    /**
+     * Updates the cached row array from the rowData Map
+     * @internal
+     */
+    private updateCachedRowArray;
+    /**
+     * Emits event to notify data has been loaded
+     * @internal
+     */
+    private emitDataLoaded;
+    /**
+     * Emits event to notify data has changed
+     * @internal
+     */
+    private emitDataChanged;
+    /**
+     * Resets the grid data while keeping columnDefs and sends a DATA_LOGOFF message if it's a stream.
+     * Loads resource data without full initialization (no metadata fetch).
+     * @remarks This is used when the grid is already initialized and we want to reload the data due to a criteria/filter change.
+     * @see loadResourceData
+     * @public
+     */
+    reloadResourceData(): Promise<void>;
+    /**
+     * Initializes the datasource and loads the data for the grid.
+     * Handles both snapshot and stream data (for both REQUEST_SERVER and DATASERVER resource types).
+     *
+     * @param withFullInit - if true, will call datasource.init() with requiresMetadataFetch = true, fetching fresh metadata
+     * @see reloadResourceData
+     * @internal
+     */
+    private loadResourceData;
+    private handleSnapshot;
+    private handleStreamResult;
+    /**
+     * Updates the status bar based on more rows status
+     * @param moreRows - Whether more rows are available
+     * @param sourceRef - The source reference
+     * @param rowsCount - The total number of rows
+     * @remarks
+     * This method emits an event for the grid to handle status bar updates.
+     */
+    private updateLoadMoreStatus;
+    private applyRequestServerData;
+    private applyDataserverData;
+    private getAgColumnDefs;
+    setFilter(fieldName: string, newFilter: string): void;
+    removeFilter(fieldName: string): void;
+    private handleSizeChanged;
+    handleStreamInserts(inserts?: any[]): void;
+    handleStreamUpdates(updates?: any[]): void;
+    /**
+     * Handles stream deletes by removing records from the grid.
+     * @param deletes - List of records to remove from the grid stream
+     */
+    handleStreamDeletes(deletes?: any[]): void;
+    /**
+     * Extends the base options to constrain the requested fields to the visible columns when
+     * `requestVisibleColumnsOnly` is enabled.
+     * @remarks DATASERVER only; for other resource types the derived `fields` are ignored.
+     * @internal
+     */
+    protected datasourceOptions(): DatasourceOptions;
+    /**
+     * Builds the DATASERVER `FIELDS` string (space-separated) from the visible columns, always
+     * including the `rowId` so rows can be tracked.
+     * @internal
+     */
+    private getRequestedFields;
+    /**
+     * Returns the field names of the configured columns that are not hidden, used to seed the visible
+     * set before the host grid reports runtime visibility.
+     * @internal
+     */
+    private getConfiguredVisibleColumns;
+    /**
+     * Updates the set of visible columns and reloads the data when the set changes.
+     * @remarks Called by the host grid on column visibility changes; no-ops unless
+     * `requestVisibleColumnsOnly` is enabled. DATASERVER only; no-ops for other resource types.
+     * @param visibleFields - Field names of the currently visible columns.
+     * @public
+     */
+    setVisibleColumns(visibleFields: string[]): void;
+    /**
+     * Compares two column field lists irrespective of order.
+     * @internal
+     */
+    private columnsChanged;
+    loadMore(): void;
 }
 
-declare const GridProColumn_base: (new (...args: any[]) => {
+declare const GridProGenesisDatasource_base: (new (...args: any[]) => {
     #_container: FoundationLayoutContainer | LayoutCacheContainer | DOMContainer;
     #_latestTokenCode: string;
     #_hasFirstLoaded: boolean;
@@ -5655,7 +5509,11 @@ declare const GridProColumn_base: (new (...args: any[]) => {
     setAttributeNodeNS(attr: Attr): Attr | null;
     setHTMLUnsafe(html: string): void;
     setPointerCapture(pointerId: number): void;
-    toggleAttribute(qualifiedName: string, force?: boolean): boolean;
+    toggleAttribute(qualifiedName: string, force? /**
+    * Sets the columnDefs and rowData for the grid.
+    * @remarks This should only happen once, when the grid is first initialized. Follow up updates will use transactions.
+    * @internal
+    */: boolean): boolean;
     webkitMatchesSelector(selectors: string): boolean;
     textContent: string;
     readonly baseURI: string;
@@ -5894,310 +5752,193 @@ declare const GridProColumn_base: (new (...args: any[]) => {
     tabIndex: number;
     blur(): void;
     focus(options?: FocusOptions): void;
-}) & typeof FoundationElement;
-
-/**
- * Filled by {@link gridProColumnDragBridgeModule} after grid beans init.
- * Read from `IToolPanelParams.context` / `api.getGridOption('context')`.
- * @public
- */
-export declare interface GridProColumnDragBridge {
-    dragAndDrop?: {
-        addDragSource: (source: GridDragSource, touchEnabled?: boolean) => void;
-        removeDragSource: (source: GridDragSource) => void;
-    };
-    gos?: GridOptionsService;
-}
-
-/** @public */
-export declare type GridProColumnDragBridgeContext = {
-    [GRID_PRO_COLUMN_DRAG_BRIDGE_CONTEXT_KEY]?: GridProColumnDragBridge;
-};
-
-/**
- * Registers drag-and-drop beans on `gridOptions.context` so custom tool panels
- * can call `dragAndDrop.addDragSource` (same contract as Enterprise Columns panel).
- * @internal
- */
-export declare const gridProColumnDragBridgeModule: Module;
-
-/**
- * A directive that renders a set of grid-pro-column elements from a given input binding
- *
- * @param itemsBinding - The array to render
- * @param includeRenderers - Optionally tells whether to include cell renderers, if available
- * @public
- */
-export declare function gridProColumns<TSource = any>(itemsBinding: Binding<TSource, readonly ColDef[]> | readonly ColDef[], includeRenderers?: boolean): CaptureType<TSource>;
-
-/**
- * @deprecated Use {@link ColumnSelectionHost}.
- * @public
- */
-export declare type GridProColumnSelectionHost = ColumnSelectionHost;
-
-/**
- * Host layout when the Grid Pro column-selection toolbar is shown.
- * @public
- */
-export declare const gridProColumnSelectionHostStyles: ElementStyles;
-
-/**
- * Grid Pro possible error events
- * @public
- */
-export declare type GridProErrorEvent = GridProGenesisDatasourceErrorEvent | CustomEvent<GridProErrorItem<any>>;
+}) & typeof GridProBaseDatasource;
 
 /**
- * Grid Pro Error Item
+ * The error event grid pro genesis datasource.
  * @public
  */
-export declare interface GridProErrorItem<GridProErrorItemDetailType> {
-    detail: GridProErrorItemDetailType;
-    type: GridProErrorTypes;
-}
+export declare type GridProGenesisDatasourceErrorEvent = CustomEvent<GridProGenesisDatasourceErrorEventDetail>;
 
 /**
- * The error names for the Grid Pro component.
+ * The event detail for the grid pro genesis datasource `error` event.
  * @public
  */
-export declare const gridProErrorNames: {
-    readonly datasource: "datasource";
-    readonly unknown: "unknown";
+export declare type GridProGenesisDatasourceErrorEventDetail = {
+    message: string;
 };
 
 /**
- * Grid Pro Error Types
- * @public
- */
-export declare type GridProErrorTypes = keyof typeof gridProErrorNames;
-
-/**
- * The event names for the Grid Pro component.
+ * The Genesis Datasource events names.
  * @public
  */
-export declare const gridProEventNames: {
-    datasourceErrorClose: string;
+export declare const gridProGenesisDatasourceEventNames: {
+    readonly error: "datasource-error";
+    readonly dataInit: "datasource-init";
+    readonly sizeChanged: "datasource-size-changed";
+    readonly moreRowsChanged: "more-rows-changed";
 };
 
 /**
- * Grid Pro Events and Callbacks
- * @remarks - This type is used to define the events and callbacks that can be passed to the grid
- * @public
- */
-export declare type GridProEventsAndCallbacks = OnlyFunctions<UntypeNonFunctions<GridOptions_2>>;
-
-/**
- * Grid Pro Event Listeners
- * @internal
- */
-export declare type GridProEventsListeners = [string, (event: Event) => void][];
-
-/**
- * The available Grid Pro column filter component names.
- * @remarks Register-able via the grid `components` map; `enumFilter` is usable as a
- * `ColDef.filter` value and `enumFloatingFilter` as a `ColDef.floatingFilterComponent`.
- * @public
- */
-export declare enum GridProFilterTypes {
-    enumFilter = "enumColumnFilter",
-    enumFloatingFilter = "enumColumnFloatingFilter"
-}
-
-/**
- * The Genesis Datasource element, for CSRM-compatible data fetching and used exclusively by the GridPro element.
- * @remarks Only supports Client-Side Row Model.
- * @public
+ * A Genesis Datasource element for AG Grid's Infinite Row Model.
+ * @remarks
+ * The Infinite Row Model is part of AG Grid Community (free) and provides:
+ * - Lazy loading of data as user scrolls
+ * - Server-side sorting and filtering
+ * - Simple infinite scroll without grouping/aggregation
+ * - Live updates for DATASERVER resources: the DATA_LOGON stream the grid pages over pushes
+ *   every change, so no flag or second subscription is needed
+ *
+ * REQUEST_SERVER resources are read on demand only - a change on the server shows up when the
+ * grid re-reads (scroll, filter/sort change, or an explicit refresh), not live. The exception
+ * is a write made through this session: a commit ACK for an event listed in `pollTriggerEvents`
+ * re-reads the loaded blocks, so entity-management CRUD is reflected immediately.
+ *
+ * Like the other datasources, consumer options passed as `deferredGridOptions` (including via
+ * entity-management's `gridOptions` with `datasource-type="infinite"`) are merged over this
+ * element's defaults in `init()`.
+ *
+ * Use this instead of Server-Side Row Model when you don't need Enterprise features
+ * like row grouping, aggregation, or pivoting.
+ *
+ * @see https://www.ag-grid.com/javascript-data-grid/infinite-scrolling/
+ * @beta
  *
  * @fires base-datasource-error - Fired when a datasource error is reported. detail: `BaseDatasourceErrorEventDetail`
  * @fires datasource-error - Fired when a datasource error occurs (for grid integration). detail: `DatasourceErrorEventDetail`
- * @fires base-datasource-connected - Fired when error state is cleared after connection succeeds
- * @fires datasource-loading-finished - Fired when loading completes with no pending row changes
- * @fires datasource-no-data-available - Fired when the grid has no rows after load
- * @fires datasource-data-changed - Fired when row data changes from stream updates. detail: `DataChangedEventDetail`
- * @fires datasource-initialize - Fired to hand off grid options and initialization flags. detail: `InitializeEventDetail`
- * @fires datasource-destroy - Fired when the datasource is torn down
- * @fires datasource-data-cleared - Fired when row data is cleared. detail: `DataClearedEventDetail`
- * @fires datasource-schema-updated - Fired when column metadata or defs are updated. detail: `SchemaUpdatedEventDetail`
- * @fires datasource-filters-restored - Fired when persisted filters are reapplied
- * @fires datasource-data-loaded - Fired when a data payload is loaded for the grid. detail: `DataLoadedEventDetail`
- * @fires datasource-loading-started - Fired when a load or refresh starts
- * @fires datasource-more-data-available - Fired when more server rows can be requested. detail: `MoreDataAvailableEventDetail`
- * @fires datasource-ready - Fired when the host grid is ready to start loading data
- * @fires datasource-init - Fired when initial grid data is ready for the client-side model
- * @fires more-rows-changed - Fired when MORE_ROWS availability changes. detail: `MoreRowsDetail`
- * @fires datasource-size-changed - Fired when layout or viewport sizing affects the datasource. detail: `GrigProGenesisDatasourceSizeChangedEventDetail`
- */
-export declare class GridProGenesisDatasource extends GridProGenesisDatasource_base {
-    private cachedRowArray;
-    protected transactionData: TransactionData_2;
-    criteriaChanged(oldCriteria: string, newCriteria: string): Promise<void>;
-    requestChanged(oldRequest: string, newRequest: string): void;
-    resourceNameChanged(oldValue: string, newValue: string): void;
-    keepColDefsOnClearRowData: boolean;
-    /**
-     * When enabled and column definitions are provided, the datasource requests data only for the
-     * columns that are currently visible. The visible set is seeded from the column config (columns
-     * not flagged with `hide`) and updated by the host grid via `setVisibleColumns`; the data
-     * is reloaded whenever that set changes.
-     * @remarks DATASERVER only.
-     * @default false
-     */
-    requestVisibleColumnsOnly: boolean;
-    private _visibleColumns;
-    private dataSub;
-    private updateSub;
-    private requiresFullRowDataAndColDefs;
-    private _lastMoreRows;
-    private _isMoreRowsResult;
-    private _sourceRef;
-    private _nextOffset;
-    private _loadMoreCount;
-    private readonly onDatasourceReady;
-    connectedCallback(): void;
-    disconnectedCallback(): void;
-    deepClone(): Node;
-    private colDefsDeepClone;
-    /**
-     * Initializes the datasource.
-     * @public
-     * @param columnDefinitions - Optionally set the `gridOptions` up with column definitions
-     * @param columnStates  - Optionally set the grid up with column state
-     * @remarks This method is called automatically when the element is connected to the DOM.
-     */
-    init(keepColDefsOnClearRowData?: boolean): Promise<void>;
-    private clearReadyListener;
-    /**
-     * Destroys the datasource, resetting it to its initial state.
-     * @public
-     */
-    destroy(): void;
-    /**
-     * Deinitialises the datasource, resetting it to its initial state.
-     * @deprecated Use `destroy` instead
-     * @public
-     */
-    deinit(): void;
-    /**
-     * Resets the datasource to its initial state.
-     * @public
-     * @deprecated Use `destroy` instead
-     */
-    reset(): void;
-    /**
-     * Restarts the datasource, uses `destroy` and `init` in sequence.
-     * @public
-     */
-    restart(): Promise<void>;
-    /**
-     * Force the grid to redispatch the current rows
-     */
-    refreshRows(): void;
+ * @fires base-datasource-connected - Fired when error state is cleared after connection succeeds
+ * @fires datasource-initialize - Fired to hand off infinite row model grid options. detail: `InitializeEventDetail`
+ * @fires datasource-init - Fired when the infinite grid model should initialize data
+ * @fires datasource-schema-updated - Fired when column metadata or defs are updated. detail: `SchemaUpdatedEventDetail`
+ * @fires datasource-data-changed - Fired when rows are delivered to the grid, a DATASERVER push changes them, or a re-read no longer returns them; `add` are rows the grid did not hold before, `update` are held rows whose content changed, `remove` carries the row id. detail: `DataChangedEventDetail`
+ * @fires set-infinite-datasource - Fired to attach or clear the infinite row model datasource. detail: `SetInfiniteDatasourceEventDetail`
+ * @fires refresh-infinite-cache - Fired to request an infinite row model refresh; `purge` drops the block cache and re-reads. detail: `RefreshInfiniteCacheEventDetail`
+ * @fires add-grid-css-class - Fired to add a CSS class on the grid host (hover sort indicators). detail: `GridCssClassEventDetail`
+ * @fires remove-grid-css-class - Fired to remove that CSS class from the grid host. detail: `GridCssClassEventDetail`
+ * @fires cache-filter-config - Fired to persist filter configuration for the grid
+ * @fires datasource-data-cleared - Fired when the grid drops every row it held (reload, filter or sort change, destroy); `includeSchema` says whether the columns went too. detail: `DataClearedEventDetail`
+ * @fires datasource-loading-finished - Fired when the first block comes back with rows
+ * @fires datasource-no-data-available - Fired when the first block comes back empty
+ * @fires datasource-filters-restored - Fired when persisted filters are reapplied
+ */
+export declare class GridProInfiniteDatasource extends GridProInfiniteDatasource_base {
+    connect: Connect;
+    connectEvents: ConnectEvents;
+    datasource: Datasource;
+    request: any;
+    private indexes;
+    private infiniteDatasource;
+    /** Unsubscribes the commit-response listener behind `pollTriggerEvents`. @internal */
+    private commitResponseUnsubscribe?;
+    resourceNameChanged(oldValue: string, newValue: string): void;
+    criteriaChanged(oldCriteria: string, newCriteria: string): void;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    /** Unsubscribes the `setFilter()` listener. @internal */
+    private filterSub;
     /**
-     * Clears the rowData and columnDefs for the grid.
-     * @remarks This is called when `reloadResourceData` happens, on criteria and filters change or full `reset`.
-     * @param withColumnDefs - Whether to clear the columnDefs as well. Defaults to true.
+     * Reloads when `setFilter()` or `removeFilter()` changes the criteria.
+     * @remarks The criteria a block is read with is captured when the resource is built, so a
+     * filter added later reaches nothing until the rows are re-read. The `criteria` attribute
+     * already reloads through `criteriaChanged`; this gives the programmatic API the same
+     * behaviour instead of silently doing nothing.
      * @internal
      */
-    private clearRowData;
+    private subscribeToFilterChanges;
+    /** @internal */
+    private unsubscribeFromFilterChanges;
+    deepClone(): Node;
     /**
-     * Sets the columnDefs and rowData for the grid.
-     * @remarks This should only happen once, when the grid is first initialized. Follow up updates will use transactions.
-     * @internal
+     * Resets the grid data while keeping columnDefs and reloads data.
+     * @remarks This is used when the grid is already initialized and we want to reload the data due to a criteria/filter change.
+     * @beta
      */
-    private setRowData;
+    reloadResourceData(): Promise<void>;
+    init(): Promise<void>;
+    /** @internal */
+    private clearReadyListener;
     /**
-     * Updates the cached row array from the rowData Map
+     * Whether the infinite row model can drive this resource.
+     * @remarks It pages a req/rep by sending CRITERIA_MATCH, ORDER_BY and OFFSET in DETAILS, which
+     * a request reply only accepts when it is declared `criteriaOnlyRequest`
+     * (`CRITERIA_ONLY_REQUEST` in its metadata). Without it the server expects its inputs in
+     * `REQUEST` instead and rejects every block, which on this row model surfaces as a grid that
+     * simply never fills. Report it once, up front, as the server-side model does.
+     * @returns `true` when the infinite model can be used, `false` after reporting a
+     * `resource-type` error.
      * @internal
      */
-    private updateCachedRowArray;
+    private isInfiniteSupportedForResource;
+    /** @internal */
+    private onDatasourceReady;
     /**
-     * Emits event to notify data has been loaded
+     * A pushed INSERT/DELETE changes which rows exist or their order, so the change is reported
+     * and then the rows are re-read (purge).
      * @internal
      */
-    private emitDataLoaded;
+    private handleLiveRowsInvalidated;
     /**
-     * Emits event to notify data has changed
+     * A pushed MODIFY is already patched into the paging cache, so the change is reported and the
+     * grid only needs to re-render its blocks.
      * @internal
      */
-    private emitDataChanged;
-    /**
-     * Resets the grid data while keeping columnDefs and sends a DATA_LOGOFF message if it's a stream.
-     * Loads resource data without full initialization (no metadata fetch).
-     * @remarks This is used when the grid is already initialized and we want to reload the data due to a criteria/filter change.
-     * @see loadResourceData
-     * @public
-     */
-    reloadResourceData(): Promise<void>;
+    private handleLiveRowsUpdated;
     /**
-     * Initializes the datasource and loads the data for the grid.
-     * Handles both snapshot and stream data (for both REQUEST_SERVER and DATASERVER resource types).
+     * Turns a DATASERVER push into the same transaction the client-side datasource reports:
+     * partial MODIFY rows are merged into the held row, and a remove carries just the row id.
+     * @remarks Unlike the client-side model, a pushed row need not be held here - it may sit
+     * beyond the loaded blocks, in which case the grid will never show it.
      *
-     * @param withFullInit - if true, will call datasource.init() with requiresMetadataFetch = true, fetching fresh metadata
-     * @see reloadResourceData
-     * @internal
-     */
-    private loadResourceData;
-    private handleSnapshot;
-    private handleStreamResult;
-    /**
-     * Updates the status bar based on more rows status
-     * @param moreRows - Whether more rows are available
-     * @param sourceRef - The source reference
-     * @param rowsCount - The total number of rows
-     * @remarks
-     * This method emits an event for the grid to handle status bar updates.
-     */
-    private updateLoadMoreStatus;
-    private applyRequestServerData;
-    private applyDataserverData;
-    private getAgColumnDefs;
-    setFilter(fieldName: string, newFilter: string): void;
-    removeFilter(fieldName: string): void;
-    private handleSizeChanged;
-    handleStreamInserts(inserts?: any[]): void;
-    handleStreamUpdates(updates?: any[]): void;
-    /**
-     * Handles stream deletes by removing records from the grid.
-     * @param deletes - List of records to remove from the grid stream
-     */
-    handleStreamDeletes(deletes?: any[]): void;
-    /**
-     * Extends the base options to constrain the requested fields to the visible columns when
-     * `requestVisibleColumnsOnly` is enabled.
-     * @remarks DATASERVER only; for other resource types the derived `fields` are ignored.
+     * So a pushed INSERT is deliberately not reported: nothing here says where the new row sorts,
+     * and reporting an `add` for a row that lands at position 40,000 of an unscrolled grid would
+     * contradict the event's contract and leave the row held forever, since no block re-read ever
+     * delivers (or withdraws) it. Every INSERT is followed by a purge and re-read, which reports
+     * the row as `add` if and when it actually reaches the grid.
+     *
+     * A MODIFY for a row that is not held is skipped for the same reason; a DELETE is reported by
+     * the id it carries, and one that cannot be resolved to an id is skipped with a warning rather
+     * than matched against the wrong row.
      * @internal
      */
-    protected datasourceOptions(): DatasourceOptions;
+    private reportLiveChange;
+    destroy(): Promise<void>;
+    restart(): Promise<void>;
     /**
-     * Builds the DATASERVER `FIELDS` string (space-separated) from the visible columns, always
-     * including the `rowId` so rows can be tracked.
+     * Forgets every held row and tells consumers, as the client-side datasource does: the grid is
+     * dropping its rows (a reload, a filter or sort change, or teardown). `withColumnDefs` also
+     * clears the column definitions.
      * @internal
      */
-    private getRequestedFields;
+    private clearRowData;
     /**
-     * Returns the field names of the configured columns that are not hidden, used to seed the visible
-     * set before the host grid reports runtime visibility.
+     * Honours `pollTriggerEvents` without polling: a commit ACK for one of the listed events
+     * means a write went through this session, so the loaded blocks are re-read in place - the
+     * same action as `applyTransaction`, which keeps the grid's row count and scroll position.
+     * @remarks REQUEST_SERVER only. DATASERVER already receives every change on the paging
+     * subscription, so a commit-triggered re-read there would just duplicate the live push.
      * @internal
      */
-    private getConfiguredVisibleColumns;
+    private setupCommitTriggeredRefresh;
+    /** Safe to call when the listener was never registered. @internal */
+    private teardownCommitTriggeredRefresh;
     /**
-     * Updates the set of visible columns and reloads the data when the set changes.
-     * @remarks Called by the host grid on column visibility changes; no-ops unless
-     * `requestVisibleColumnsOnly` is enabled. DATASERVER only; no-ops for other resource types.
-     * @param visibleFields - Field names of the currently visible columns.
-     * @public
+     * Creates a snapshot request to the server.
+     * @param existingParams - Optional existing parameters to include
+     * @returns The server response
      */
-    setVisibleColumns(visibleFields: string[]): void;
+    private createSnapshot;
     /**
-     * Compares two column field lists irrespective of order.
+     * Opens the paged DATASERVER subscription used to serve grid blocks.
+     * @remarks Deliberately a stream and not a snapshot: paging is a MORE_ROWS request against a
+     * live subscription, and a fresh DATA_LOGON would always come back with page 1.
      * @internal
      */
-    private columnsChanged;
+    private createDataserverStream;
+    private getAgColumnDefs;
     loadMore(): void;
 }
 
-declare const GridProGenesisDatasource_base: (new (...args: any[]) => {
+declare const GridProInfiniteDatasource_base: (new (...args: any[]) => {
     #_container: FoundationLayoutContainer | LayoutCacheContainer | DOMContainer;
     #_latestTokenCode: string;
     #_hasFirstLoaded: boolean;
@@ -6324,11 +6065,7 @@ declare const GridProGenesisDatasource_base: (new (...args: any[]) => {
     setAttributeNodeNS(attr: Attr): Attr | null;
     setHTMLUnsafe(html: string): void;
     setPointerCapture(pointerId: number): void;
-    toggleAttribute(qualifiedName: string, force? /**
-    * Sets the columnDefs and rowData for the grid.
-    * @remarks This should only happen once, when the grid is first initialized. Follow up updates will use transactions.
-    * @internal
-    */: boolean): boolean;
+    toggleAttribute(qualifiedName: string, force?: boolean): boolean;
     webkitMatchesSelector(selectors: string): boolean;
     textContent: string;
     readonly baseURI: string;
@@ -6570,190 +6307,483 @@ declare const GridProGenesisDatasource_base: (new (...args: any[]) => {
 }) & typeof GridProBaseDatasource;
 
 /**
- * The error event grid pro genesis datasource.
- * @public
- */
-export declare type GridProGenesisDatasourceErrorEvent = CustomEvent<GridProGenesisDatasourceErrorEventDetail>;
-
-/**
- * The event detail for the grid pro genesis datasource `error` event.
- * @public
- */
-export declare type GridProGenesisDatasourceErrorEventDetail = {
-    message: string;
-};
-
-/**
- * The Genesis Datasource events names.
+ * The Grid Pro Legacy element (AG Grid v29 compatible).
+ * @remarks Grid Pro Legacy is a Web Component wrapper around the AG Grid Community library.
  * @public
- */
-export declare const gridProGenesisDatasourceEventNames: {
-    readonly error: "datasource-error";
-    readonly dataInit: "datasource-init";
-    readonly sizeChanged: "datasource-size-changed";
-    readonly moreRowsChanged: "more-rows-changed";
-};
-
-/**
- * A Genesis Datasource element for AG Grid's Infinite Row Model.
- * @remarks
- * The Infinite Row Model is part of AG Grid Community (free) and provides:
- * - Lazy loading of data as user scrolls
- * - Server-side sorting and filtering
- * - Simple infinite scroll without grouping/aggregation
- * - Live updates for DATASERVER resources: the DATA_LOGON stream the grid pages over pushes
- *   every change, so no flag or second subscription is needed
- *
- * REQUEST_SERVER resources are read on demand only - a change on the server shows up when the
- * grid re-reads (scroll, filter/sort change, or an explicit refresh), not live. The exception
- * is a write made through this session: a commit ACK for an event listed in `pollTriggerEvents`
- * re-reads the loaded blocks, so entity-management CRUD is reflected immediately.
- *
- * Like the other datasources, consumer options passed as `deferredGridOptions` (including via
- * entity-management's `gridOptions` with `datasource-type="infinite"`) are merged over this
- * element's defaults in `init()`.
- *
- * Use this instead of Server-Side Row Model when you don't need Enterprise features
- * like row grouping, aggregation, or pivoting.
- *
- * @see https://www.ag-grid.com/javascript-data-grid/infinite-scrolling/
- * @beta
+ * @deprecated Legacy AG Grid v29 wrapper. Use `GridPro` (AG Grid v36) instead.
+ * @tagname %%prefix%%-grid-pro
  *
- * @fires base-datasource-error - Fired when a datasource error is reported. detail: `BaseDatasourceErrorEventDetail`
- * @fires datasource-error - Fired when a datasource error occurs (for grid integration). detail: `DatasourceErrorEventDetail`
- * @fires base-datasource-connected - Fired when error state is cleared after connection succeeds
- * @fires datasource-initialize - Fired to hand off infinite row model grid options. detail: `InitializeEventDetail`
- * @fires datasource-init - Fired when the infinite grid model should initialize data
- * @fires datasource-schema-updated - Fired when column metadata or defs are updated. detail: `SchemaUpdatedEventDetail`
- * @fires datasource-data-changed - Fired when rows are delivered to the grid, a DATASERVER push changes them, or a re-read no longer returns them; `add` are rows the grid did not hold before, `update` are held rows whose content changed, `remove` carries the row id. detail: `DataChangedEventDetail`
- * @fires set-infinite-datasource - Fired to attach or clear the infinite row model datasource. detail: `SetInfiniteDatasourceEventDetail`
- * @fires refresh-infinite-cache - Fired to request an infinite row model refresh; `purge` drops the block cache and re-reads. detail: `RefreshInfiniteCacheEventDetail`
- * @fires add-grid-css-class - Fired to add a CSS class on the grid host (hover sort indicators). detail: `GridCssClassEventDetail`
- * @fires remove-grid-css-class - Fired to remove that CSS class from the grid host. detail: `GridCssClassEventDetail`
- * @fires cache-filter-config - Fired to persist filter configuration for the grid
- * @fires datasource-data-cleared - Fired when the grid drops every row it held (reload, filter or sort change, destroy); `includeSchema` says whether the columns went too. detail: `DataClearedEventDetail`
- * @fires datasource-loading-finished - Fired when the first block comes back with rows
- * @fires datasource-no-data-available - Fired when the first block comes back empty
- * @fires datasource-filters-restored - Fired when persisted filters are reapplied
- */
-export declare class GridProInfiniteDatasource extends GridProInfiniteDatasource_base {
-    connect: Connect;
-    connectEvents: ConnectEvents;
-    datasource: Datasource;
-    request: any;
-    private indexes;
-    private infiniteDatasource;
-    /** Unsubscribes the commit-response listener behind `pollTriggerEvents`. @internal */
-    private commitResponseUnsubscribe?;
-    resourceNameChanged(oldValue: string, newValue: string): void;
-    criteriaChanged(oldCriteria: string, newCriteria: string): void;
+ * @fires gridReady - Fired when AG Grid is ready (detail includes the grid-ready event and grid id)
+ * @fires onGridReady - Deprecated alias for the grid-ready signal; prefer `gridReady`
+ * @fires gridready - Native `Event` from `globalEventListener` when AG Grid fires `gridReady` (`agGridDetails` holds the AG Grid event)
+ * @remarks Re-emits AG Grid public API events when listeners are registered via `addEventListener` (event names match `ComponentUtil.PUBLIC_EVENTS` from `@ag-grid-community/core`). The same AG Grid events are also dispatched as native `Event`s with lowercased `type` and payload on `agGridDetails` (for example `addEventListener('columnresized', ...)`).
+ */
+export declare class GridProLegacy extends GridProLegacy_base {
+    columnApi: ColumnApi;
+    gridApi: GridApi_2;
+    private cachedTotalColumnWidth;
+    private columnCount;
+    gridErrorItems: GridProErrorItem<GridProErrorEvent['detail']>[];
+    statePersistence: StatePersistence;
+    /**
+     * Timeout function used to debounce resize calls
+     * @internal
+     */
+    private debounced;
+    private disposed;
+    private readonly debouncedSaveColumnState;
+    private readonly debouncedSaveFilterModel;
+    private readonly debouncedNotifyDatasourceVisibleColumns;
+    autoCellRendererByType: boolean;
+    onlyTemplateColDefs: boolean;
+    /**
+     * Boolean attribute to control whether the grid autosizes the columns upon interaction.
+     * This will disable the column widths from being manually set, and doesn't save the widths
+     * in local storage if you are using `persist-column-state-key`.
+     */
+    gridAutosizingEnabled: boolean;
+    /**
+     * Boolean attribute to control whether the grid automatically sizes columns to fit their content.
+     * This will call AG Grid's autoSizeColumns() method to automatically adjust column widths based on content.
+     * @public
+     */
+    sizeColumnsToContent: boolean;
+    /**
+     * Boolean attribute to adjust the size of columns to fit the available horizontal space.
+     * This will call AG Grid's sizeColumnsToFit() method.
+     * @public
+     */
+    sizeColumnsToFit: boolean;
+    /**
+     * The index to add new rows to when using `applyTransaction` or `applyTransactionAsync`
+     */
+    addIndex: number;
+    /**
+     * Whether to use the `applyTransactionAsync` function for *add* transactions
+     * @remarks Defaults to false
+     */
+    asyncAdd: boolean;
+    /**
+     * Whether to use the `applyTransactionAsync` function for *remove* transactions
+     * @remarks Defaults to false
+     */
+    asyncRemove: boolean;
+    /**
+     * Whether to use the `applyTransactionAsync` function for *update* transactions
+     * @remarks Defaults to true
+     */
+    asyncUpdate: boolean;
+    /**
+     * If false, will disable cell flashing for all cells by default, unless otherwise defined in custom colDef
+     * @remarks Defaults to true
+     */
+    enableCellFlashing: boolean;
+    /**
+     * @deprecated - use `enableRowFlashing` instead.
+     */
+    enabledRowFlashing: boolean;
+    /**
+     * If true, will enable row flashing for all rows for `add` async transactions
+     */
+    enableRowFlashing: boolean;
+    /**
+     * The key to use for persisting the column state in local browser or KV storage.
+     */
+    persistColumnStateKey: string;
+    /**
+     * The key to use for persisting the filter model in local browser or KV storage.
+     */
+    persistFilterModelKey: string;
+    /**
+     * The default column config to reset to when deleteColumnState is called.
+     */
+    defaultColumnConfig: ColDef[];
+    /**
+     * The case type to use for the header names. If not set, the default CONSTANT_CASE will be used.
+     * @remarks Can be one of the following: camelCase, capitalCase, dotCase, headerCase, noCase, paramCase, pascalCase, pathCase, sentenceCase, snakeCase.
+     * @public
+     */
+    headerCaseType: GridProCaseType;
+    /**
+     * The row data to display in the grid.
+     * @remarks For scenarios where you want to set data manually, without relying on `<grid-pro-client-side-datasource>`.
+     * @public
+     */
+    rowData: any[];
+    rowDataChanged(_: any, rowData: any): void;
+    gridFontFace: string;
+    columnComponentName: string;
+    eventsAndCallbacks: GridProEventsAndCallbacks;
+    headerHeight: number;
+    rowHeight: number;
+    theme: string;
+    themeChanged(oldValue: string, newValue: string): void;
+    classNames: string;
+    agGrid: Grid;
+    gridSlot: HTMLSlotElement;
+    /**
+     * The slot ref binds asynchronously, and the queued `initGrid` skips any run that beats it. FAST
+     * calls this the moment the ref lands, so a grid whose options were set BEFORE the view bound
+     * still initialises rather than staying blank — closing the one gap that skip would leave.
+     *
+     * Guarded on `agGridOptions` as well: without options there is nothing to build, and AG Grid
+     * would only log "no gridOptions provided to the grid". Those arrive via a grid-options change,
+     * which re-runs `initGrid` on its own.
+     */
+    gridSlotChanged(): void;
+    themeMode: 'light' | 'dark';
+    gridComponents: {
+        [componentName: string]: any;
+    };
+    /**
+     * Configuration for the grid status bar components.
+     * @remarks
+     * This requires AG Grid Enterprise module to be enabled.
+     * The status bar will only be displayed if the Enterprise module is available.
+     * @see https://www.ag-grid.com/javascript-data-grid/component-status-bar/
+     */
+    statusBarConfig: GridProStatusBarConfig;
+    /**
+     * Enables or disables the grid status bar.
+     * @remarks
+     * Default is false.
+     * When disabled, no status bar will be displayed regardless of statusBarConfig.
+     * This requires AG Grid Enterprise module to be available for the status bar to be displayed when enabled.
+     */
+    withStatusBar: boolean;
+    /**
+     * Custom error handler dialog template function.
+     * @remarks
+     * When provided, this function will be used to render custom error dialogs instead of the default error handler.
+     * The function should accept a prefix string and an array of grid error items and return a ViewTemplate.
+     * If not provided, the default error handler dialog template will be used.
+     */
+    customErrorHandlerTemplate?: (prefix: string, gridErrorItems: GridProErrorItem<any>[]) => ViewTemplate;
+    private columnState;
+    protected agAttributes: Record<string, string>;
+    protected agPropertiesMap: Record<string, string>;
+    protected agGridOptions: GridOptions;
+    /**
+     * Last grid options supplied via the public `gridOptions` setter (not datasource init).
+     * Used as the merge base in `handleInitialize` so user options survive datasource restart.
+     */
+    private userProvidedGridOptions;
+    private applyingDatasourceGridOptions;
+    protected initialised: boolean;
+    private rehydrationAttempted;
+    private eventHandlers;
+    private gridEventsQueue;
+    private registeredGridEvents;
+    private gridEventListeners;
+    private visibilityObserverCleanup?;
+    private pendingSchemaUpdate?;
+    private readonly boundGlobalEventListener;
+    private _filterConfig;
+    getfilterModel(): Promise<{
+        [key: string]: any;
+    }>;
+    setFilterModel(value: {
+        [key: string]: any;
+    }): Promise<void>;
+    /**
+     * Injectable config that allows to change grid options on an app level basis
+     * To modify options, register instance of the config in DOM container that is
+     * above the grid or on the top level of the application, so it applies to all grids.
+     *
+     * @example
+     * ```
+     * DI.getOrCreateDOMContainer().register([
+     *       Registration.instance<GridOptionsConfig>(GridOptionsConfig, {
+     *         headerHeight: 50,
+     *       }),
+     *     ]);
+     * ```
+     */
+    gridOptionsConfig: GridOptionsConfig;
+    constructor();
+    /**
+     * The Infinite Row Model is only wired into `GridPro` (AG Grid v36), so an infinite datasource placed
+     * inside this element can never load data. Report it instead of ignoring the event.
+     * @internal
+     */
+    private refuseInfiniteDatasource;
+    /**
+     * Adds an event listener to the grid element.
+     * @param eventType - The event type to listen for. Recommened to use the `Events` from AG Grid.
+     * @param listener - The event listener to call when the event is fired.
+     * @param options - An options object that specifies characteristics about the event listener.
+     * @privateRemarks
+     * This will change once we do the AG Upgrade and `eventType` will be correctly typed.
+     */
+    addEventListener(eventType: string, listener: any, options?: boolean | AddEventListenerOptions): void;
+    private addGridEventListener;
+    private handleError;
+    private handleBaseDatasourceError;
+    hideDatasourceError(): void;
     connectedCallback(): void;
     disconnectedCallback(): void;
-    /** Unsubscribes the `setFilter()` listener. @internal */
-    private filterSub;
+    private performDisconnectCleanup;
+    /**
+     * Tear down the AG Grid instance. Prefer {@link GridApi#destroy}; if `gridApi` is not set yet
+     * (e.g. disconnect before `grid-ready`), fall back to {@link Grid#destroy} on the vanilla wrapper.
+     */
+    private destroyGridInstance;
+    /**
+     * Handles datasource initialization
+     * @internal
+     */
+    private handleInitialize;
+    /**
+     * Handles data loading from datasource
+     * @internal
+     */
+    private handleDataLoaded;
+    /**
+     * Handles data changes from datasource
+     * @internal
+     */
+    private handleDataChanged;
+    private flashAddedCells;
+    /**
+     * Handles schema updates from datasource
+     * @internal
+     */
+    private handleSchemaUpdated;
+    /**
+     * Builds and applies column defs from a schema/metadata payload.
+     * @internal
+     */
+    private processSchemaUpdate;
+    /**
+     * Handles data clearing from datasource
+     * @internal
+     */
+    private handleDataCleared;
+    /**
+     * Handles loading started from datasource
+     * @internal
+     */
+    private handleLoadingStarted;
+    /**
+     * Handles loading finished from datasource
+     * @internal
+     */
+    private handleLoadingFinished;
+    /**
+     * Handles no data available from datasource
+     * @internal
+     */
+    private handleNoDataAvailable;
     /**
-     * Reloads when `setFilter()` or `removeFilter()` changes the criteria.
-     * @remarks The criteria a block is read with is captured when the resource is built, so a
-     * filter added later reaches nothing until the rows are re-read. The `criteria` attribute
-     * already reloads through `criteriaChanged`; this gives the programmatic API the same
-     * behaviour instead of silently doing nothing.
+     * Handles filter restoration from datasource
      * @internal
      */
-    private subscribeToFilterChanges;
-    /** @internal */
-    private unsubscribeFromFilterChanges;
-    deepClone(): Node;
+    private handleFiltersRestored;
     /**
-     * Resets the grid data while keeping columnDefs and reloads data.
-     * @remarks This is used when the grid is already initialized and we want to reload the data due to a criteria/filter change.
-     * @beta
+     * Handles more data availability from datasource
+     * @internal
      */
-    reloadResourceData(): Promise<void>;
-    init(): Promise<void>;
-    /** @internal */
-    private clearReadyListener;
+    private handleMoreDataAvailable;
     /**
-     * Whether the infinite row model can drive this resource.
-     * @remarks It pages a req/rep by sending CRITERIA_MATCH, ORDER_BY and OFFSET in DETAILS, which
-     * a request reply only accepts when it is declared `criteriaOnlyRequest`
-     * (`CRITERIA_ONLY_REQUEST` in its metadata). Without it the server expects its inputs in
-     * `REQUEST` instead and rejects every block, which on this row model surfaces as a grid that
-     * simply never fills. Report it once, up front, as the server-side model does.
-     * @returns `true` when the infinite model can be used, `false` after reporting a
-     * `resource-type` error.
+     * Handles datasource errors
      * @internal
      */
-    private isInfiniteSupportedForResource;
-    /** @internal */
-    private onDatasourceReady;
+    private handleDatasourceError;
     /**
-     * A pushed INSERT/DELETE changes which rows exist or their order, so the change is reported
-     * and then the rows are re-read (purge).
+     * Handles datasource destroy
      * @internal
      */
-    private handleLiveRowsInvalidated;
+    private handleDatasourceDestroy;
     /**
-     * A pushed MODIFY is already patched into the paging cache, so the change is reported and the
-     * grid only needs to re-render its blocks.
+     * Handles refreshing server-side data
      * @internal
      */
-    private handleLiveRowsUpdated;
+    private handleRefreshServerSide;
     /**
-     * Turns a DATASERVER push into the same transaction the client-side datasource reports:
-     * partial MODIFY rows are merged into the held row, and a remove carries just the row id.
-     * @remarks Unlike the client-side model, a pushed row need not be held here - it may sit
-     * beyond the loaded blocks, in which case the grid will never show it.
-     *
-     * So a pushed INSERT is deliberately not reported: nothing here says where the new row sorts,
-     * and reporting an `add` for a row that lands at position 40,000 of an unscrolled grid would
-     * contradict the event's contract and leave the row held forever, since no block re-read ever
-     * delivers (or withdraws) it. Every INSERT is followed by a purge and re-read, which reports
-     * the row as `add` if and when it actually reaches the grid.
-     *
-     * A MODIFY for a row that is not held is skipped for the same reason; a DELETE is reported by
-     * the id it carries, and one that cannot be resolved to an id is skipped with a warning rather
-     * than matched against the wrong row.
+     * Handles setting server-side datasource
      * @internal
      */
-    private reportLiveChange;
-    destroy(): Promise<void>;
-    restart(): Promise<void>;
+    private handleSetServerSideDatasource;
     /**
-     * Forgets every held row and tells consumers, as the client-side datasource does: the grid is
-     * dropping its rows (a reload, a filter or sort change, or teardown). `withColumnDefs` also
-     * clears the column definitions.
+     * Handles adding CSS class to grid element
      * @internal
      */
-    private clearRowData;
+    private handleAddGridCssClass;
     /**
-     * Honours `pollTriggerEvents` without polling: a commit ACK for one of the listed events
-     * means a write went through this session, so the loaded blocks are re-read in place - the
-     * same action as `applyTransaction`, which keeps the grid's row count and scroll position.
-     * @remarks REQUEST_SERVER only. DATASERVER already receives every change on the paging
-     * subscription, so a commit-triggered re-read there would just duplicate the live push.
+     * Handles removing CSS class from grid element
      * @internal
      */
-    private setupCommitTriggeredRefresh;
-    /** Safe to call when the listener was never registered. @internal */
-    private teardownCommitTriggeredRefresh;
+    private handleRemoveGridCssClass;
     /**
-     * Creates a snapshot request to the server.
-     * @param existingParams - Optional existing parameters to include
-     * @returns The server response
+     * Handles applying server-side transactions
+     * @internal
      */
-    private createSnapshot;
+    private handleApplyServerSideTransaction;
+    combineAllGridComponents(gridOptionsComponents: GridComponents): GridComponents;
+    statePersistanceEnabled(): boolean;
     /**
-     * Opens the paged DATASERVER subscription used to serve grid blocks.
-     * @remarks Deliberately a stream and not a snapshot: paging is a MORE_ROWS request against a
-     * live subscription, and a fresh DATA_LOGON would always come back with page 1.
+     * Gets the currently selected rows from the grid
+     * @public
+     * @returns Array of selected row data
+     */
+    getSelectedRows(): any[];
+    /**
+     * Gets the row data from selected cell ranges
      * @internal
+     * @returns Array containing the row data from selected cell ranges, or empty array if none
      */
-    private createDataserverStream;
-    private getAgColumnDefs;
-    loadMore(): void;
+    private getCellRangeRowData;
+    /**
+     * Checks if any rows are currently selected
+     * @public
+     * @returns True if rows are selected, false otherwise
+     */
+    hasSelectedRows(): boolean;
+    /**
+     * Updates the label-value status bar component with new label and value
+     * @public
+     * @param params - Object containing label, value, and optionally hide flag
+     * @example
+     * ```ts
+     * gridPro.updateLabelValueStatusBar({
+     *   label: 'Total Records',
+     *   value: '1,234',
+     *   hide: false
+     * });
+     * ```
+     */
+    updateLabelValueStatusBar(params: GridProStatusBarLabelConfig): void;
+    /**
+     * Because we try and resize the grid to fit using callbacks on events, this will cause
+     * a stack overflow of calls to resize, so we need to debounce it.
+     * @internal
+     */
+    private debouncedColumnAutosize;
+    /**
+     * If {@link @genesislcap/grid-pro#GridProLegacy.gridAutosizingEnabled} is true, will remove the widths from the column states.
+     * @internal
+     */
+    private removeConfigWidthsToAutosize;
+    private saveColumnState;
+    /**
+     * Gets the saved grid ColumnState[] from storage
+     * @remarks This is used to restore the grid state when the grid is rehydrated
+     * @privateRemarks Not using `columnApi.get|setColumnState()` for these flows as it doesn't work setting new columnDefs vs different ordering.
+     * @public
+     */
+    getSavedColumnState(): Promise<ColumnState[]>;
+    /**
+     * Deletes the saved column state for the current grid
+     * @param resetToDefault - Whether to reset columns to their default configuration. Defaults to true.
+     * @remarks This removes the persisted column state from storage, allowing the grid to use default column configuration
+     * @public
+     */
+    deleteColumnState(resetToDefault?: boolean): Promise<void>;
+    private restoreColumnState;
+    cacheFilterConfig(): void;
+    restoreCachedFilterConfig(): Promise<void>;
+    /**
+     * @public
+     */
+    get gridOptions(): GridOptionsConfig;
+    /**
+     * @public
+     */
+    get isServerSide(): boolean;
+    /**
+     * @public
+     */
+    get gridParams(): GridParams_2;
+    /**
+     * Get the datasource element.
+     * @remarks This will return the first datasource element found in the light DOM, wrapping all concrete datasource implementations.
+     * @public
+     */
+    get gridProDatasource(): GridProBaseDatasource;
+    /**
+     * Reports the currently visible columns to the datasource. The datasource decides what to do with
+     * them (e.g. narrowing the server request); the grid stays agnostic of that behaviour.
+     * @internal
+     */
+    private notifyDatasourceVisibleColumns;
+    set gridOptions(options: GridOptionsConfig);
+    private setLocalGridOptions;
+    /**
+     * Clears the local grid options, this is used to clear the grid options when the grid is restarted.
+     * @public
+     */
+    clearLocalGridOptions(): void;
+    /**
+     * Clears all grid option state when the grid element is fully torn down.
+     * @internal
+     */
+    private resetGridOptionsState;
+    private initGrid;
+    /**
+     * Will merge templated column definitions with `columnDefs` plus localStorage's column state or `deferredColumnStates`.
+     * @deprecated use `applyTemplateDefinitions` instead.
+     * @param columnDefs - The column definitions to apply to the grid.
+     * @param deferredColumnDefsOrState - If true, will merge the column definitions with the saved column state or the `deferredColumnStates` property on the `grid-pro-genesis-datasource` element.
+     * @returns The merged column definitions.
+     */
+    applyTemplateDefinitions(columnDefs: ColDef[], deferredColumnDefsOrState?: boolean): Promise<(ColDef<any> | ColGroupDef<any>)[]>;
+    /**
+     * Will merge templated column definitions with `columnDefs` plus localStorage's column state or `deferredColumnStates`.
+     * @public
+     * @remarks This will favor the column state from the browser's local storage over the `deferredColumnStates` property on the `grid-pro-genesis-datasource` element.
+     * @param columnDefs - The column definitions to apply to the grid.
+     * @param deferredColumnDefsOrState - If true, will merge the column definitions with the saved column state or the `deferredColumnStates` property
+     * on the `grid-pro-genesis-datasource` element. Defaults to false but `grid-pro-genesis-datasource` will set this to true.
+     * @returns The merged column definitions.
+     */
+    mergeAllColumnDefsAndStates(columnDefs: ColDef[], deferredColumnDefsOrState?: boolean): Promise<(ColDef<any> | ColGroupDef<any>)[]>;
+    private panelExists;
+    private addRowCountPanel;
+    private addMaxRowsPanel;
+    private addAggregationPanel;
+    private addDatasourcePanels;
+    protected setupStatusBar(gridOptions: GridOptions): void;
+    /**
+     * Handles column sizing based on sizeColumnsToContent and sizeColumnsToFit attributes
+     * @private
+     */
+    private handleColumnSizing;
+    /**
+     * Handles when both sizeColumnsToContent and sizeColumnsToFit are enabled
+     * @private
+     */
+    private handleBothSizingModes;
+    /**
+     * Handles individual sizing modes when only one is enabled
+     * @private
+     */
+    private handleIndividualSizingModes;
+    /**
+     * Calculates the total width of all columns
+     * @private
+     */
+    private calculateTotalColumnWidth;
+    /**
+     * Invalidates the cached column width calculation
+     * @private
+     * @remarks This method is called automatically when column changes occur (resize, move, pin, etc.)
+     * to ensure the cached width calculation remains accurate.
+     */
+    private invalidateColumnWidthCache;
+    /**
+     * Gets the available grid width with fallbacks
+     * @private
+     */
+    private getGridWidth;
+    get observedAttributes(): string[];
+    agAttributeChangedCallback(attName: any, oldValue: any, newValue: any): void;
+    globalEventListener(eventType: any, event: any): void;
+    private fontFaceDestroy;
+    private insertFontFace;
+    private destroyFontFace;
 }
 
-declare const GridProInfiniteDatasource_base: (new (...args: any[]) => {
+declare const GridProLegacy_base: (new (...args: any[]) => {
     #_container: FoundationLayoutContainer | LayoutCacheContainer | DOMContainer;
     #_latestTokenCode: string;
     #_hasFirstLoaded: boolean;
@@ -7119,7 +7149,7 @@ declare const GridProInfiniteDatasource_base: (new (...args: any[]) => {
     tabIndex: number;
     blur(): void;
     focus(options?: FocusOptions): void;
-}) & typeof GridProBaseDatasource;
+}) & typeof FoundationElement;
 
 /**
  * The available Grid Pro Renderer Types
@@ -7797,8 +7827,8 @@ export declare const gridProTemplate: ViewTemplate;
 /**
  * Event detail for the `gridReady`/`onGridReady` signals.
  * @public
- * @remarks Only accurate for {@link @genesislcap/grid-pro#GridProBeta}, which is built on
- * `ag-grid-community` (v36). {@link @genesislcap/grid-pro#GridPro} fires the same event names
+ * @remarks Only accurate for {@link @genesislcap/grid-pro#GridPro}, which is built on
+ * `ag-grid-community` (v36). {@link @genesislcap/grid-pro#GridProLegacy} fires the same event names
  * but its `event` field is a `@ag-grid-community/core` (v29) `GridReadyEvent`.
  */
 export declare interface GridReadyEventDetail {
@@ -8118,7 +8148,7 @@ export declare class MulticolumnDropdown extends MulticolumnDropdown_base {
      */
     baseCriteria?: string;
     defaultSlottedNodes: Node[];
-    grid: GridPro;
+    grid: GridPro | GridProLegacy;
     private _value;
     get value(): string;
     set value(value: string);