@genesislcap/grid-pro 15.62.0 → 15.64.0

package/dist/grid-pro.d.ts

@@ -720,7 +720,8 @@ export declare type ColumnPickerSort = 'selected-first' | 'ag-grid';
  *
  * The panel uses the Popover API (`popover="manual"`) so it paints in the top layer and is not
  * clipped by layout ancestors with `overflow: hidden`. Placement is pure CSS (anchor positioning
- * via `showPopover({ source })` + `position-area`).
+ * via `showPopover({ source })` + `position-area`). Set `docked` to keep the same picker in a
+ * side panel beside the grid instead; the tab on the trailing edge opens and closes it.
  *
  * Layout: select-all + search → column list. Ordering via `sort`
  * (`selected-first` default, or `ag-grid`). Checkboxes toggle visibility via
@@ -733,6 +734,11 @@ export declare type ColumnPickerSort = 'selected-first' | 'ag-grid';
 export declare class ColumnSelection extends ColumnSelection_base {
     /** Button label. */
     label: string;
+    /**
+     * Docks the picker beside the grid instead of opening a popover.
+     * A tab on the trailing edge opens and closes the panel, matching the enterprise side bar.
+     */
+    docked: boolean;
     /**
      * Column list ordering.
      * - `selected-first` (default): visible first (grid display order), then hidden A–Z.
@@ -791,6 +797,9 @@ export declare class ColumnSelection extends ColumnSelection_base {
     gridApiChanged(): void;
     gridHostChanged(): void;
     panelElChanged(): void;
+    dockedChanged(): void;
+    /** Overlay visibility is a host class so the grid keeps its width while the panel is open. */
+    private syncDockedOpenState;
     /**
      * Subscribe to grid column events and rebuild picker lists.
      * Called automatically when the popover opens; exposed for tests/hosts that need an early bind.
@@ -886,7 +895,7 @@ declare const ColumnSelection_base: (new (...args: any[]) => {
     #_tryFindContainingLayout(e: Element): FoundationLayoutContainer | LayoutCacheContainer | DOMContainer;
     connectedCallback(): void;
     readonly $fastController: Controller;
-    $emit(type: string, detail?: any, options?: Omit<CustomEventInit, "detail">): boolean | void;
+    $emit(type: string, detail?: any, options? /** Query root for picker DOM (shadow panel). */: Omit<CustomEventInit, "detail">): boolean | void;
     disconnectedCallback(): void;
     attributeChangedCallback(name: string, oldValue: string, newValue: string): void;
     accessKey: string;
@@ -2252,6 +2261,15 @@ export declare const foundationGridComponents: {
     template: ViewTemplate<ColumnSelection, any>;
     styles: ElementStyles;
     }, ColumnSelection>;
+    foundationGridProStatusBar: (overrideDefinition?: OverrideFoundationElementDefinition<    {
+    baseName: string;
+    template: ViewTemplate<GridProStatusBar, any>;
+    styles: ElementStyles;
+    }>) => FoundationElementRegistry<    {
+    baseName: string;
+    template: ViewTemplate<GridProStatusBar, any>;
+    styles: ElementStyles;
+    }, GridProStatusBar>;
     register(container?: Container, ...rest: any[]): void;
 };
 
@@ -2334,6 +2352,23 @@ template: ViewTemplate<any, any>;
  */
 export declare const foundationGridProShadowOptions: ShadowRootInit;
 
+/**
+ * Foundation Grid Pro Status Bar registration.
+ *
+ * @public
+ * @remarks
+ * HTML Element: \<foundation-grid-pro-status-bar\>
+ */
+export declare const foundationGridProStatusBar: (overrideDefinition?: OverrideFoundationElementDefinition<    {
+baseName: string;
+template: ViewTemplate<GridProStatusBar, any>;
+styles: ElementStyles;
+}>) => FoundationElementRegistry<    {
+baseName: string;
+template: ViewTemplate<GridProStatusBar, any>;
+styles: ElementStyles;
+}, typeof GridProStatusBar>;
+
 /**
  * The Grid Pro styles.
  * @public
@@ -3501,6 +3536,12 @@ export declare const getSelectEditorTemplate: (designSystem?: string) => ViewTem
  */
 export declare const getSelectRendererTemplate: (designSystem?: string) => ViewTemplate<any, any>;
 
+/**
+ * Community status-bar layout: left-aligned info panels, right-aligned actions.
+ * @public
+ */
+export declare const getStatusBarTemplate: () => ViewTemplate<GridProStatusBar, any>;
+
 /**
  * Get a Design System prefixed Status Pill template.
  * @param designSystem - The design system prefix to use. Defaults to 'rapid'.
@@ -3662,21 +3703,47 @@ export declare class GridPro extends GridPro_base {
     /**
      * 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/
+     * Rendered by the status-bar host. `aggregation` is ignored until a panel exists for it.
      */
     statusBarConfig: GridProStatusBarConfig;
     /**
-     * Enables or disables the grid status bar.
+     * Enables or disables the status bar under the grid.
      * @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;
+    withStatusBarChanged(): void;
+    /**
+     * Which status bar the grid uses, decided once the grid api exists: `ag` when AG Grid's
+     * enterprise `StatusBarModule` is registered, `community` otherwise. `pending` renders neither.
+     * @internal
+     */
+    statusBarMode: 'pending' | 'ag' | 'community';
+    /**
+     * AG's enterprise status bar is in use, configured from `statusBarConfig` as before.
+     * @internal
+     */
+    get usesAgStatusBar(): boolean;
+    /**
+     * Grid Pro renders its own status-bar host.
+     * @internal
+     */
+    get usesCommunityStatusBar(): boolean;
+    /** @internal */
+    statusBarRef: GridProStatusBar;
+    /** Params pushed to status panels, replayed when the community bar mounts or rebuilds one. */
+    private statusPanelState;
+    private userStatusBar;
+    private warnedUnregisteredStatusBar;
+    private warnedGridOptionsStatusBar;
     /**
-     * Shows a Column Selection button above the grid.
+     * The status-bar host, once its element is registered with the design system.
+     * @internal
+     */
+    get statusBar(): GridProStatusBar | undefined;
+    /**
+     * Shows a Columns side panel on the trailing edge of the grid.
      * @public
      */
     enableColumnSelection: boolean;
@@ -3750,6 +3817,13 @@ export declare class GridPro extends GridPro_base {
     connectedCallback(): void;
     disconnectedCallback(): void;
     private syncColumnSelectionHostLayout;
+    private syncStatusBarHostLayout;
+    /**
+     * Chooses between AG's enterprise status bar and the community bar once the grid api exists,
+     * and hands AG its `statusBar` option when the enterprise one is used.
+     */
+    private applyStatusBarMode;
+    private buildAgStatusBar;
     private performDisconnectCleanup;
     private destroyGridInstance;
     /**
@@ -3833,6 +3907,12 @@ export declare class GridPro extends GridPro_base {
      * @internal
      */
     private handleMoreDataAvailable;
+    private updateStatusPanel;
+    /**
+     * Params pushed to a status panel so far, for the community bar to mount it with.
+     * @internal
+     */
+    getStatusPanelState(key: string): Record<string, unknown> | undefined;
     /**
      * Handles datasource errors
      * @internal
@@ -3900,6 +3980,14 @@ export declare class GridPro extends GridPro_base {
      * @returns True if rows are selected, false otherwise
      */
     hasSelectedRows(): boolean;
+    /**
+     * Returns a mounted status-bar panel by type.
+     * @public
+     * @param key - Panel type, one of {@link GridProStatusBarTypes}.
+     * @remarks
+     * Works for both the community status bar and AG Grid's enterprise one.
+     */
+    getStatusPanel(key: string): IStatusPanelComp | undefined;
     /**
      * Updates the label-value status bar component with new label and value
      * @public
@@ -4154,11 +4242,10 @@ export declare class GridPro extends GridPro_base {
         context?: any;
         suppressHeaderContextMenu?: boolean;
     })[]>;
-    private panelExists;
-    private addRowCountPanel;
-    private addMaxRowsPanel;
-    private addAggregationPanel;
-    private addDatasourcePanels;
+    /**
+     * Refreshes the status bar from the current config and datasource: AG's enterprise bar when the
+     * previous grid had its module, otherwise the status-bar host.
+     */
     protected setupStatusBar(gridOptions: GridOptions_2): void;
     get observedAttributes(): string[];
     agAttributeChangedCallback(attName: any, oldValue: any, newValue: any): void;
@@ -4656,9 +4743,10 @@ export declare class GridProBaseDatasource extends GenesisGridDatasourceElement
     /**
      * Gets datasource-specific status bar component configurations.
      * This method should be called by the grid to get status bar panels specific to this datasource.
+     * @param suppressLoadMore - Leaves out the Load More panel, for row models that fetch on scroll.
      * @public
      */
-    getDatasourceStatusBarPanels(isServerSide: boolean, statusBarConfig: any): any[];
+    getDatasourceStatusBarPanels(suppressLoadMore: boolean, statusBarConfig: any): any[];
 }
 
 /**
@@ -7744,13 +7832,430 @@ declare const GridProServerSideDatasource_base: (new (...args: any[]) => {
     focus(options?: FocusOptions): void;
 }) & typeof GridProBaseDatasource;
 
+/**
+ * Status bar under the grid. Mounts the existing `IStatusPanelComp` panels.
+ *
+ * @public
+ * @remarks
+ * HTML Element: \<%%prefix%%-grid-pro-status-bar\>
+ *
+ * @tagname %%prefix%%-grid-pro-status-bar
+ */
+export declare class GridProStatusBar extends GridProStatusBar_base {
+    /** Grid Pro host that owns the api, datasource, and `statusBarConfig`. */
+    gridHost: StatusBarPanelHost | null;
+    /** Optional explicit AG grid API (v36). Falls back to `gridHost.gridApi` when present. */
+    gridApi: GridApi | null;
+    /**
+     * Panel config. Grid Pro binds its own `statusBarConfig` here.
+     * When unset, `gridHost.statusBarConfig` is used.
+     */
+    statusBarConfig: GridProStatusBarConfig | null;
+    /** @internal */
+    leftEl: HTMLElement;
+    /** @internal */
+    rightEl: HTMLElement;
+    private readonly panels;
+    private readonly warnedPanelTypes;
+    gridHostChanged(): void;
+    gridApiChanged(): void;
+    statusBarConfigChanged(): void;
+    leftElChanged(): void;
+    rightElChanged(): void;
+    /**
+     * Rebuilds the mounted panels from the current host / api / config.
+     * @public
+     */
+    syncPanels(): void;
+    /**
+     * Returns a mounted panel by type.
+     * @public
+     */
+    getStatusPanel(key: string): IStatusPanelComp | undefined;
+    /**
+     * Destroys the mounted panels. Call before the grid api is destroyed.
+     * @internal
+     */
+    releasePanels(): void;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private resolveApi;
+    private mountPanel;
+}
+
+declare const GridProStatusBar_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;
+    hidden: boolean;
+    inert: boolean;
+    innerText: string;
+    lang: string;
+    readonly offsetHeight: number;
+    readonly offsetLeft: number;
+    readonly offsetParent: Element | null;
+    readonly offsetTop: number;
+    readonly offsetWidth: number;
+    outerText: string;
+    popover: string | null;
+    spellcheck: boolean;
+    title: string;
+    translate: boolean;
+    writingSuggestions: string;
+    attachInternals(): ElementInternals;
+    click(): void;
+    hidePopover(): void;
+    showPopover(): void;
+    togglePopover(options?: boolean): boolean;
+    addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+    addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+    removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+    removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    readonly attributes: NamedNodeMap;
+    get classList(): DOMTokenList;
+    set classList(value: string): any;
+    className: string;
+    readonly clientHeight: number;
+    readonly clientLeft: number;
+    readonly clientTop: number;
+    readonly clientWidth: number;
+    readonly currentCSSZoom: number;
+    id: string;
+    innerHTML: string;
+    readonly localName: string;
+    readonly namespaceURI: string | null;
+    onfullscreenchange: (this: Element, ev: Event) => any;
+    onfullscreenerror: (this: Element, ev: Event) => any;
+    outerHTML: string;
+    readonly ownerDocument: Document;
+    get part(): DOMTokenList;
+    set part(value: string): any;
+    readonly prefix: string | null;
+    readonly scrollHeight: number;
+    scrollLeft: number;
+    scrollTop: number;
+    readonly scrollWidth: number;
+    readonly shadowRoot: ShadowRoot | null;
+    slot: string;
+    readonly tagName: string;
+    attachShadow(init: ShadowRootInit): ShadowRoot;
+    checkVisibility(options?: CheckVisibilityOptions): boolean;
+    closest<K extends keyof HTMLElementTagNameMap>(selector: K): HTMLElementTagNameMap[K];
+    closest<K extends keyof SVGElementTagNameMap>(selector: K): SVGElementTagNameMap[K];
+    closest<K extends keyof MathMLElementTagNameMap>(selector: K): MathMLElementTagNameMap[K];
+    closest<E extends Element = Element>(selectors: string): E;
+    computedStyleMap(): StylePropertyMapReadOnly;
+    getAttribute(qualifiedName: string): string | null;
+    getAttributeNS(namespace: string | null, localName: string): string | null;
+    getAttributeNames(): string[];
+    getAttributeNode(qualifiedName: string): Attr | null;
+    getAttributeNodeNS(namespace: string | null, localName: string): Attr | null;
+    getBoundingClientRect(): DOMRect;
+    getClientRects(): DOMRectList;
+    getElementsByClassName(classNames: string): HTMLCollectionOf<Element>;
+    getElementsByTagName<K extends keyof HTMLElementTagNameMap>(qualifiedName: K): HTMLCollectionOf<HTMLElementTagNameMap[K]>;
+    getElementsByTagName<K extends keyof SVGElementTagNameMap>(qualifiedName: K): HTMLCollectionOf<SVGElementTagNameMap[K]>;
+    getElementsByTagName<K extends keyof MathMLElementTagNameMap>(qualifiedName: K): HTMLCollectionOf<MathMLElementTagNameMap[K]>;
+    getElementsByTagName<K extends keyof HTMLElementDeprecatedTagNameMap>(qualifiedName: K): HTMLCollectionOf<HTMLElementDeprecatedTagNameMap[K]>;
+    getElementsByTagName(qualifiedName: string): HTMLCollectionOf<Element>;
+    getElementsByTagNameNS(namespaceURI: "http://www.w3.org/1999/xhtml", localName: string): HTMLCollectionOf<HTMLElement>;
+    getElementsByTagNameNS(namespaceURI: "http://www.w3.org/2000/svg", localName: string): HTMLCollectionOf<SVGElement>;
+    getElementsByTagNameNS(namespaceURI: "http://www.w3.org/1998/Math/MathML", localName: string): HTMLCollectionOf<MathMLElement>;
+    getElementsByTagNameNS(namespace: string | null, localName: string): HTMLCollectionOf<Element>;
+    getHTML(options?: GetHTMLOptions): string;
+    hasAttribute(qualifiedName: string): boolean;
+    hasAttributeNS(namespace: string | null, localName: string): boolean;
+    hasAttributes(): boolean;
+    hasPointerCapture(pointerId: number): boolean;
+    insertAdjacentElement(where: InsertPosition, element: Element): Element | null;
+    insertAdjacentHTML(position: InsertPosition, string: string): void;
+    insertAdjacentText(where: InsertPosition, data: string): void;
+    matches(selectors: string): boolean;
+    releasePointerCapture(pointerId: number): void;
+    removeAttribute(qualifiedName: string): void;
+    removeAttributeNS(namespace: string | null, localName: string): void;
+    removeAttributeNode(attr: Attr): Attr;
+    requestFullscreen(options?: FullscreenOptions): Promise<void>;
+    requestPointerLock(options?: PointerLockOptions): Promise<void>;
+    scroll(options?: ScrollToOptions): void;
+    scroll(x: number, y: number): void;
+    scrollBy(options?: ScrollToOptions): void;
+    scrollBy(x: number, y: number): void;
+    scrollIntoView(arg?: boolean | ScrollIntoViewOptions): void;
+    scrollTo(options?: ScrollToOptions): void;
+    scrollTo(x: number, y: number): void;
+    setAttribute(qualifiedName: string, value: string): void;
+    setAttributeNS(namespace: string | null, qualifiedName: string, value: string): void;
+    setAttributeNode(attr: Attr): Attr | null;
+    setAttributeNodeNS(attr: Attr): Attr | null;
+    setHTMLUnsafe(html: string): void;
+    setPointerCapture(pointerId: number): void;
+    toggleAttribute(qualifiedName: string, force?: boolean): boolean;
+    webkitMatchesSelector(selectors: string): boolean;
+    textContent: string;
+    readonly baseURI: string;
+    readonly childNodes: NodeListOf<ChildNode>;
+    readonly firstChild: ChildNode | null;
+    readonly isConnected: boolean;
+    readonly lastChild: ChildNode | null;
+    readonly nextSibling: ChildNode | null;
+    readonly nodeName: string;
+    readonly nodeType: number;
+    nodeValue: string | null;
+    readonly parentElement: HTMLElement | null;
+    readonly parentNode: ParentNode | null;
+    readonly previousSibling: ChildNode | null;
+    appendChild<T_1 extends Node>(node: T_1): T_1;
+    compareDocumentPosition(other: Node): number;
+    contains(other: Node | null): boolean;
+    getRootNode(options?: GetRootNodeOptions): Node;
+    hasChildNodes(): boolean;
+    insertBefore<T_1 extends Node>(node: T_1, child: Node | null): T_1;
+    isDefaultNamespace(namespace: string | null): boolean;
+    isEqualNode(otherNode: Node | null): boolean;
+    isSameNode(otherNode: Node | null): boolean;
+    lookupNamespaceURI(prefix: string | null): string | null;
+    lookupPrefix(namespace: string | null): string | null;
+    normalize(): void;
+    removeChild<T_1 extends Node>(child: T_1): T_1;
+    replaceChild<T_1 extends Node>(node: Node, child: T_1): T_1;
+    readonly ELEMENT_NODE: 1;
+    readonly ATTRIBUTE_NODE: 2;
+    readonly TEXT_NODE: 3;
+    readonly CDATA_SECTION_NODE: 4;
+    readonly ENTITY_REFERENCE_NODE: 5;
+    readonly ENTITY_NODE: 6;
+    readonly PROCESSING_INSTRUCTION_NODE: 7;
+    readonly COMMENT_NODE: 8;
+    readonly DOCUMENT_NODE: 9;
+    readonly DOCUMENT_TYPE_NODE: 10;
+    readonly DOCUMENT_FRAGMENT_NODE: 11;
+    readonly NOTATION_NODE: 12;
+    readonly DOCUMENT_POSITION_DISCONNECTED: 1;
+    readonly DOCUMENT_POSITION_PRECEDING: 2;
+    readonly DOCUMENT_POSITION_FOLLOWING: 4;
+    readonly DOCUMENT_POSITION_CONTAINS: 8;
+    readonly DOCUMENT_POSITION_CONTAINED_BY: 16;
+    readonly DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC: 32;
+    dispatchEvent(event: Event): boolean;
+    ariaActiveDescendantElement: Element | null;
+    ariaAtomic: string | null;
+    ariaAutoComplete: string | null;
+    ariaBrailleLabel: string | null;
+    ariaBrailleRoleDescription: string | null;
+    ariaBusy: string | null;
+    ariaChecked: string | null;
+    ariaColCount: string | null;
+    ariaColIndex: string | null;
+    ariaColIndexText: string | null;
+    ariaColSpan: string | null;
+    ariaControlsElements: ReadonlyArray<Element> | null;
+    ariaCurrent: string | null;
+    ariaDescribedByElements: ReadonlyArray<Element> | null;
+    ariaDescription: string | null;
+    ariaDetailsElements: ReadonlyArray<Element> | null;
+    ariaDisabled: string | null;
+    ariaErrorMessageElements: ReadonlyArray<Element> | null;
+    ariaExpanded: string | null;
+    ariaFlowToElements: ReadonlyArray<Element> | null;
+    ariaHasPopup: string | null;
+    ariaHidden: string | null;
+    ariaInvalid: string | null;
+    ariaKeyShortcuts: string | null;
+    ariaLabel: string | null;
+    ariaLabelledByElements: ReadonlyArray<Element> | null;
+    ariaLevel: string | null;
+    ariaLive: string | null;
+    ariaModal: string | null;
+    ariaMultiLine: string | null;
+    ariaMultiSelectable: string | null;
+    ariaOrientation: string | null;
+    ariaOwnsElements: ReadonlyArray<Element> | null;
+    ariaPlaceholder: string | null;
+    ariaPosInSet: string | null;
+    ariaPressed: string | null;
+    ariaReadOnly: string | null;
+    ariaRelevant: string | null;
+    ariaRequired: string | null;
+    ariaRoleDescription: string | null;
+    ariaRowCount: string | null;
+    ariaRowIndex: string | null;
+    ariaRowIndexText: string | null;
+    ariaRowSpan: string | null;
+    ariaSelected: string | null;
+    ariaSetSize: string | null;
+    ariaSort: string | null;
+    ariaValueMax: string | null;
+    ariaValueMin: string | null;
+    ariaValueNow: string | null;
+    ariaValueText: string | null;
+    role: string | null;
+    animate(keyframes: Keyframe[] | PropertyIndexedKeyframes | null, options?: number | KeyframeAnimationOptions): Animation;
+    getAnimations(options?: GetAnimationsOptions): Animation[];
+    after(...nodes: (Node | string)[]): void;
+    before(...nodes: (Node | string)[]): void;
+    remove(): void;
+    replaceWith(...nodes: (Node | string)[]): void;
+    readonly nextElementSibling: Element | null;
+    readonly previousElementSibling: Element | null;
+    readonly childElementCount: number;
+    readonly children: HTMLCollection;
+    readonly firstElementChild: Element | null;
+    readonly lastElementChild: Element | null;
+    append(...nodes: (Node | string)[]): void;
+    prepend(...nodes: (Node | string)[]): void;
+    querySelector<K extends keyof HTMLElementTagNameMap>(selectors: K): HTMLElementTagNameMap[K] | null;
+    querySelector<K extends keyof SVGElementTagNameMap>(selectors: K): SVGElementTagNameMap[K] | null;
+    querySelector<K extends keyof MathMLElementTagNameMap>(selectors: K): MathMLElementTagNameMap[K] | null;
+    querySelector<K extends keyof HTMLElementDeprecatedTagNameMap>(selectors: K): HTMLElementDeprecatedTagNameMap[K] | null;
+    querySelector<E extends Element = Element>(selectors: string): E | null;
+    querySelectorAll<K extends keyof HTMLElementTagNameMap>(selectors: K): NodeListOf<HTMLElementTagNameMap[K]>;
+    querySelectorAll<K extends keyof SVGElementTagNameMap>(selectors: K): NodeListOf<SVGElementTagNameMap[K]>;
+    querySelectorAll<K extends keyof MathMLElementTagNameMap>(selectors: K): NodeListOf<MathMLElementTagNameMap[K]>;
+    querySelectorAll<K extends keyof HTMLElementDeprecatedTagNameMap>(selectors: K): NodeListOf<HTMLElementDeprecatedTagNameMap[K]>;
+    querySelectorAll<E extends Element = Element>(selectors: string): NodeListOf<E>;
+    replaceChildren(...nodes: (Node | string)[]): void;
+    readonly assignedSlot: HTMLSlotElement | null;
+    readonly attributeStyleMap: StylePropertyMap;
+    get style(): CSSStyleDeclaration;
+    set style(cssText: string): any;
+    contentEditable: string;
+    enterKeyHint: string;
+    inputMode: string;
+    readonly isContentEditable: boolean;
+    onabort: ((this: GlobalEventHandlers, ev: UIEvent) => any) | null;
+    onanimationcancel: ((this: GlobalEventHandlers, ev: AnimationEvent) => any) | null;
+    onanimationend: ((this: GlobalEventHandlers, ev: AnimationEvent) => any) | null;
+    onanimationiteration: ((this: GlobalEventHandlers, ev: AnimationEvent) => any) | null;
+    onanimationstart: ((this: GlobalEventHandlers, ev: AnimationEvent) => any) | null;
+    onauxclick: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+    onbeforeinput: ((this: GlobalEventHandlers, ev: InputEvent) => any) | null;
+    onbeforematch: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+    onbeforetoggle: ((this: GlobalEventHandlers, ev: ToggleEvent) => any) | null;
+    onblur: ((this: GlobalEventHandlers, ev: FocusEvent) => any) | null;
+    oncancel: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+    oncanplay: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+    oncanplaythrough: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+    onchange: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+    onclick: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+    onclose: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+    oncontextlost: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+    oncontextmenu: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+    oncontextrestored: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+    oncopy: ((this: GlobalEventHandlers, ev: ClipboardEvent) => any) | null;
+    oncuechange: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+    oncut: ((this: GlobalEventHandlers, ev: ClipboardEvent) => any) | null;
+    ondblclick: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
+    ondrag: ((this: GlobalEventHandlers, ev: DragEvent) => any) | null;
+    ondragend: ((this: GlobalEventHandlers, ev: DragEvent) => any) | null;
+    ondragenter: ((this: GlobalEventHandlers, ev: DragEvent) => any) | null;
+    ondragleave: ((this: GlobalEventHandlers, ev: DragEvent) => any) | null;
+    ondragover: ((this: GlobalEventHandlers, ev: DragEvent) => any) | null;
+    ondragstart: ((this: GlobalEventHandlers, ev: DragEvent) => any) | null;
+    ondrop: ((this: GlobalEventHandlers, ev: DragEvent) => any) | null;
+    ondurationchange: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+    onemptied: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+    onended: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+    onerror: OnErrorEventHandler;
+    onfocus: ((this: GlobalEventHandlers, ev: FocusEvent) => any) | null;
+    onformdata: ((this: GlobalEventHandlers, ev: FormDataEvent) => any) | null;
+    ongotpointercapture: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+    oninput: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+    oninvalid: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+    onkeydown: ((this: GlobalEventHandlers, ev: KeyboardEvent) => any) | null;
+    onkeypress: ((this: GlobalEventHandlers, ev: KeyboardEvent) => any) | null;
+    onkeyup: ((this: GlobalEventHandlers, ev: KeyboardEvent) => any) | null;
+    onload: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+    onloadeddata: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+    onloadedmetadata: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+    onloadstart: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+    onlostpointercapture: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+    onmousedown: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
+    onmouseenter: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
+    onmouseleave: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
+    onmousemove: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
+    onmouseout: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
+    onmouseover: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
+    onmouseup: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
+    onpaste: ((this: GlobalEventHandlers, ev: ClipboardEvent) => any) | null;
+    onpause: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+    onplay: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+    onplaying: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+    onpointercancel: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+    onpointerdown: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+    onpointerenter: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+    onpointerleave: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+    onpointermove: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+    onpointerout: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+    onpointerover: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+    onpointerrawupdate: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+    onpointerup: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+    onprogress: ((this: GlobalEventHandlers, ev: ProgressEvent) => any) | null;
+    onratechange: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+    onreset: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+    onresize: ((this: GlobalEventHandlers, ev: UIEvent) => any) | null;
+    onscroll: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+    onscrollend: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+    onsecuritypolicyviolation: ((this: GlobalEventHandlers, ev: SecurityPolicyViolationEvent) => any) | null;
+    onseeked: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+    onseeking: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+    onselect: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+    onselectionchange: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+    onselectstart: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+    onslotchange: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+    onstalled: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+    onsubmit: ((this: GlobalEventHandlers, ev: SubmitEvent) => any) | null;
+    onsuspend: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+    ontimeupdate: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+    ontoggle: ((this: GlobalEventHandlers, ev: ToggleEvent) => any) | null;
+    ontouchcancel?: ((this: GlobalEventHandlers, ev: TouchEvent) => any) | null | undefined;
+    ontouchend?: ((this: GlobalEventHandlers, ev: TouchEvent) => any) | null | undefined;
+    ontouchmove?: ((this: GlobalEventHandlers, ev: TouchEvent) => any) | null | undefined;
+    ontouchstart?: ((this: GlobalEventHandlers, ev: TouchEvent) => any) | null | undefined;
+    ontransitioncancel: ((this: GlobalEventHandlers, ev: TransitionEvent) => any) | null;
+    ontransitionend: ((this: GlobalEventHandlers, ev: TransitionEvent) => any) | null;
+    ontransitionrun: ((this: GlobalEventHandlers, ev: TransitionEvent) => any) | null;
+    ontransitionstart: ((this: GlobalEventHandlers, ev: TransitionEvent) => any) | null;
+    onvolumechange: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+    onwaiting: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+    onwebkitanimationend: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+    onwebkitanimationiteration: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+    onwebkitanimationstart: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+    onwebkittransitionend: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+    onwheel: ((this: GlobalEventHandlers, ev: WheelEvent) => any) | null;
+    autofocus: boolean;
+    readonly dataset: DOMStringMap;
+    nonce?: string;
+    tabIndex: number;
+    blur(): void;
+    focus(options?: FocusOptions): void;
+}) & typeof FoundationElement;
+
 /**
  * Configuration options for the grid status bar components
  * @public
  * @remarks
- * This requires AG Grid Enterprise module to be enabled.
- * Status bar components will only be displayed if the Enterprise module is available.
- * @see https://www.ag-grid.com/javascript-data-grid/component-status-bar/
+ * On {@link GridPro} these panels mount in the status-bar host.
  */
 export declare interface GridProStatusBarConfig {
     /**
@@ -7775,7 +8280,7 @@ export declare interface GridProStatusBarConfig {
     reload?: boolean | GridProStatusBarReloadConfig;
     /**
      * Enable aggregation status bar component.
-     * @remarks Default is true. Shows aggregation values for selected columns.
+     * @remarks Default is true. Ignored until a panel exists for it.
      */
     aggregation?: boolean;
 }
@@ -7848,9 +8353,8 @@ export declare interface GridProStatusBarReloadConfig {
  * The available Grid Pro Status Bar Types
  * @public
  * @remarks
- * These status bar components require AG Grid Enterprise module to be enabled.
- * Status bar components will only be displayed if the Enterprise module is available.
- * @see https://www.ag-grid.com/javascript-data-grid/component-status-bar/
+ * Mounted by the status-bar host on {@link GridPro}.
+ * `aggregation` is ignored until a panel exists for it.
  */
 export declare enum GridProStatusBarTypes {
     labelValue = "labelValue",
@@ -8782,6 +9286,14 @@ export declare type ReloadStatusBarParams = {
 /** @public */
 export declare function reorderVisibleIds(allVisibleIds: string[], shownIds: string[], fromId: string, toId: string): string[] | null;
 
+/**
+ * Builds the panel list for AG Grid's enterprise status bar, used when its `StatusBarModule` is
+ * registered. Client-side grids get AG's filtered / total row count, and `aggregation` maps to
+ * AG's aggregation panel. Panels from `gridOptions.statusBar` come first and are kept.
+ * @internal
+ */
+export declare function resolveAgStatusBarPanels(host: StatusBarPanelHost, userPanels?: StatusBarPanelDef[]): StatusBarPanelDef[];
+
 /** @public */
 export declare function resolveColumnDragBridge(context: unknown): GridProColumnDragBridge | null;
 
@@ -8803,6 +9315,13 @@ export declare function resolveColumnPickerSort(sort?: ColumnPickerSort | null):
  */
 export declare function resolveColumnsPickerApi(gridHost?: ColumnSelectionHost | null, gridApi?: GridApi | null): GridApi | null;
 
+/**
+ * Builds the status-bar panel list from `withStatusBar` + `statusBarConfig`.
+ * `aggregation` is ignored until a panel exists for it.
+ * @internal
+ */
+export declare function resolveStatusBarPanels(host: StatusBarPanelHost): StatusBarPanelDef[];
+
 /**
  * Resolves the field names of the currently visible columns.
  * @remarks Prefers the grid's displayed columns (`getAllDisplayedColumns()` — already excludes
@@ -9307,6 +9826,47 @@ export declare interface StatePersistence {
  */
 export declare const StatePersistence: InterfaceSymbol<StatePersistence>;
 
+/**
+ * A panel to mount in the status-bar host.
+ * `statusPanel` is one of {@link GridProStatusBarTypes}.
+ * @public
+ */
+export declare interface StatusBarPanelDef {
+    statusPanel: string;
+    statusPanelParams?: Record<string, unknown>;
+    align?: 'left' | 'right';
+}
+
+/**
+ * Grid / datasource fields the resolver reads. Matches {@link GridPro} without importing the class.
+ * @public
+ */
+export declare interface StatusBarPanelHost {
+    withStatusBar: boolean;
+    statusBarConfig: GridProStatusBarConfig | null | undefined;
+    isServerSide: boolean;
+    isInfiniteRowModel: boolean;
+    gridApi?: GridApi | null;
+    /** Params already pushed to a panel, applied when it is mounted. */
+    getStatusPanelState?: (key: string) => Record<string, unknown> | undefined;
+    gridProDatasource?: {
+        maxRows?: number;
+        getDatasourceStatusBarPanels?: (suppressLoadMore: boolean, statusBarConfig: GridProStatusBarConfig) => StatusBarPanelDef[];
+    } | null;
+}
+
+/**
+ * Status-bar host styles. Tokens follow the grid so the bar matches.
+ * @public
+ */
+export declare const statusBarStyles: ElementStyles;
+
+/**
+ * Default status bar template.
+ * @public
+ */
+export declare const statusBarTemplate: ViewTemplate<GridProStatusBar, any>;
+
 /**
  * The AG Status Pill Renderer element.
  * @public