@genesislcap/grid-pro 15.63.0 → 15.64.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (44) hide show
  1. package/.cursor/rules/ag-embedded-components.mdc +1 -0
  2. package/dist/custom-elements.json +12848 -12340
  3. package/dist/dts/column-selection/column-selection.styles.d.ts.map +1 -1
  4. package/dist/dts/datasource/base.datasource.d.ts +2 -1
  5. package/dist/dts/datasource/base.datasource.d.ts.map +1 -1
  6. package/dist/dts/grid-components.d.ts +9 -0
  7. package/dist/dts/grid-components.d.ts.map +1 -1
  8. package/dist/dts/grid-pro.d.ts +58 -11
  9. package/dist/dts/grid-pro.d.ts.map +1 -1
  10. package/dist/dts/grid-pro.template.d.ts.map +1 -1
  11. package/dist/dts/grid-pro.types.d.ts +4 -7
  12. package/dist/dts/grid-pro.types.d.ts.map +1 -1
  13. package/dist/dts/index.d.ts +1 -0
  14. package/dist/dts/index.d.ts.map +1 -1
  15. package/dist/dts/react.d.ts +68 -58
  16. package/dist/dts/status-bar/index.d.ts +5 -0
  17. package/dist/dts/status-bar/index.d.ts.map +1 -0
  18. package/dist/dts/status-bar/resolve-status-bar-panels.d.ts +43 -0
  19. package/dist/dts/status-bar/resolve-status-bar-panels.d.ts.map +1 -0
  20. package/dist/dts/status-bar/status-bar.d.ts +439 -0
  21. package/dist/dts/status-bar/status-bar.d.ts.map +1 -0
  22. package/dist/dts/status-bar/status-bar.styles.d.ts +6 -0
  23. package/dist/dts/status-bar/status-bar.styles.d.ts.map +1 -0
  24. package/dist/dts/status-bar/status-bar.template.d.ts +12 -0
  25. package/dist/dts/status-bar/status-bar.template.d.ts.map +1 -0
  26. package/dist/esm/column-selection/column-selection.styles.js +26 -5
  27. package/dist/esm/datasource/base.datasource.js +3 -3
  28. package/dist/esm/grid-components.js +2 -0
  29. package/dist/esm/grid-pro.js +144 -113
  30. package/dist/esm/grid-pro.styles.js +1 -1
  31. package/dist/esm/grid-pro.template.js +23 -12
  32. package/dist/esm/grid-pro.types.js +2 -3
  33. package/dist/esm/index.js +1 -0
  34. package/dist/esm/status-bar/index.js +4 -0
  35. package/dist/esm/status-bar/resolve-status-bar-panels.js +67 -0
  36. package/dist/esm/status-bar/status-bar.js +171 -0
  37. package/dist/esm/status-bar/status-bar.styles.js +49 -0
  38. package/dist/esm/status-bar/status-bar.template.js +16 -0
  39. package/dist/esm/status-bar-components/row-count.status-bar.js +2 -1
  40. package/dist/grid-pro.api.json +1672 -488
  41. package/dist/grid-pro.d.ts +569 -18
  42. package/dist/react.cjs +46 -39
  43. package/dist/react.mjs +38 -32
  44. package/package.json +12 -12
@@ -2261,6 +2261,15 @@ export declare const foundationGridComponents: {
2261
2261
  template: ViewTemplate<ColumnSelection, any>;
2262
2262
  styles: ElementStyles;
2263
2263
  }, ColumnSelection>;
2264
+ foundationGridProStatusBar: (overrideDefinition?: OverrideFoundationElementDefinition< {
2265
+ baseName: string;
2266
+ template: ViewTemplate<GridProStatusBar, any>;
2267
+ styles: ElementStyles;
2268
+ }>) => FoundationElementRegistry< {
2269
+ baseName: string;
2270
+ template: ViewTemplate<GridProStatusBar, any>;
2271
+ styles: ElementStyles;
2272
+ }, GridProStatusBar>;
2264
2273
  register(container?: Container, ...rest: any[]): void;
2265
2274
  };
2266
2275
 
@@ -2343,6 +2352,23 @@ template: ViewTemplate<any, any>;
2343
2352
  */
2344
2353
  export declare const foundationGridProShadowOptions: ShadowRootInit;
2345
2354
 
2355
+ /**
2356
+ * Foundation Grid Pro Status Bar registration.
2357
+ *
2358
+ * @public
2359
+ * @remarks
2360
+ * HTML Element: \<foundation-grid-pro-status-bar\>
2361
+ */
2362
+ export declare const foundationGridProStatusBar: (overrideDefinition?: OverrideFoundationElementDefinition< {
2363
+ baseName: string;
2364
+ template: ViewTemplate<GridProStatusBar, any>;
2365
+ styles: ElementStyles;
2366
+ }>) => FoundationElementRegistry< {
2367
+ baseName: string;
2368
+ template: ViewTemplate<GridProStatusBar, any>;
2369
+ styles: ElementStyles;
2370
+ }, typeof GridProStatusBar>;
2371
+
2346
2372
  /**
2347
2373
  * The Grid Pro styles.
2348
2374
  * @public
@@ -3510,6 +3536,12 @@ export declare const getSelectEditorTemplate: (designSystem?: string) => ViewTem
3510
3536
  */
3511
3537
  export declare const getSelectRendererTemplate: (designSystem?: string) => ViewTemplate<any, any>;
3512
3538
 
3539
+ /**
3540
+ * Community status-bar layout: left-aligned info panels, right-aligned actions.
3541
+ * @public
3542
+ */
3543
+ export declare const getStatusBarTemplate: () => ViewTemplate<GridProStatusBar, any>;
3544
+
3513
3545
  /**
3514
3546
  * Get a Design System prefixed Status Pill template.
3515
3547
  * @param designSystem - The design system prefix to use. Defaults to 'rapid'.
@@ -3671,19 +3703,45 @@ export declare class GridPro extends GridPro_base {
3671
3703
  /**
3672
3704
  * Configuration for the grid status bar components.
3673
3705
  * @remarks
3674
- * This requires AG Grid Enterprise module to be enabled.
3675
- * The status bar will only be displayed if the Enterprise module is available.
3676
- * @see https://www.ag-grid.com/javascript-data-grid/component-status-bar/
3706
+ * Rendered by the status-bar host. `aggregation` is ignored until a panel exists for it.
3677
3707
  */
3678
3708
  statusBarConfig: GridProStatusBarConfig;
3679
3709
  /**
3680
- * Enables or disables the grid status bar.
3710
+ * Enables or disables the status bar under the grid.
3681
3711
  * @remarks
3682
3712
  * Default is false.
3683
3713
  * When disabled, no status bar will be displayed regardless of statusBarConfig.
3684
- * This requires AG Grid Enterprise module to be available for the status bar to be displayed when enabled.
3685
3714
  */
3686
3715
  withStatusBar: boolean;
3716
+ withStatusBarChanged(): void;
3717
+ /**
3718
+ * Which status bar the grid uses, decided once the grid api exists: `ag` when AG Grid's
3719
+ * enterprise `StatusBarModule` is registered, `community` otherwise. `pending` renders neither.
3720
+ * @internal
3721
+ */
3722
+ statusBarMode: 'pending' | 'ag' | 'community';
3723
+ /**
3724
+ * AG's enterprise status bar is in use, configured from `statusBarConfig` as before.
3725
+ * @internal
3726
+ */
3727
+ get usesAgStatusBar(): boolean;
3728
+ /**
3729
+ * Grid Pro renders its own status-bar host.
3730
+ * @internal
3731
+ */
3732
+ get usesCommunityStatusBar(): boolean;
3733
+ /** @internal */
3734
+ statusBarRef: GridProStatusBar;
3735
+ /** Params pushed to status panels, replayed when the community bar mounts or rebuilds one. */
3736
+ private statusPanelState;
3737
+ private userStatusBar;
3738
+ private warnedUnregisteredStatusBar;
3739
+ private warnedGridOptionsStatusBar;
3740
+ /**
3741
+ * The status-bar host, once its element is registered with the design system.
3742
+ * @internal
3743
+ */
3744
+ get statusBar(): GridProStatusBar | undefined;
3687
3745
  /**
3688
3746
  * Shows a Columns side panel on the trailing edge of the grid.
3689
3747
  * @public
@@ -3759,6 +3817,13 @@ export declare class GridPro extends GridPro_base {
3759
3817
  connectedCallback(): void;
3760
3818
  disconnectedCallback(): void;
3761
3819
  private syncColumnSelectionHostLayout;
3820
+ private syncStatusBarHostLayout;
3821
+ /**
3822
+ * Chooses between AG's enterprise status bar and the community bar once the grid api exists,
3823
+ * and hands AG its `statusBar` option when the enterprise one is used.
3824
+ */
3825
+ private applyStatusBarMode;
3826
+ private buildAgStatusBar;
3762
3827
  private performDisconnectCleanup;
3763
3828
  private destroyGridInstance;
3764
3829
  /**
@@ -3842,6 +3907,12 @@ export declare class GridPro extends GridPro_base {
3842
3907
  * @internal
3843
3908
  */
3844
3909
  private handleMoreDataAvailable;
3910
+ private updateStatusPanel;
3911
+ /**
3912
+ * Params pushed to a status panel so far, for the community bar to mount it with.
3913
+ * @internal
3914
+ */
3915
+ getStatusPanelState(key: string): Record<string, unknown> | undefined;
3845
3916
  /**
3846
3917
  * Handles datasource errors
3847
3918
  * @internal
@@ -3909,6 +3980,14 @@ export declare class GridPro extends GridPro_base {
3909
3980
  * @returns True if rows are selected, false otherwise
3910
3981
  */
3911
3982
  hasSelectedRows(): boolean;
3983
+ /**
3984
+ * Returns a mounted status-bar panel by type.
3985
+ * @public
3986
+ * @param key - Panel type, one of {@link GridProStatusBarTypes}.
3987
+ * @remarks
3988
+ * Works for both the community status bar and AG Grid's enterprise one.
3989
+ */
3990
+ getStatusPanel(key: string): IStatusPanelComp | undefined;
3912
3991
  /**
3913
3992
  * Updates the label-value status bar component with new label and value
3914
3993
  * @public
@@ -4163,11 +4242,10 @@ export declare class GridPro extends GridPro_base {
4163
4242
  context?: any;
4164
4243
  suppressHeaderContextMenu?: boolean;
4165
4244
  })[]>;
4166
- private panelExists;
4167
- private addRowCountPanel;
4168
- private addMaxRowsPanel;
4169
- private addAggregationPanel;
4170
- private addDatasourcePanels;
4245
+ /**
4246
+ * Refreshes the status bar from the current config and datasource: AG's enterprise bar when the
4247
+ * previous grid had its module, otherwise the status-bar host.
4248
+ */
4171
4249
  protected setupStatusBar(gridOptions: GridOptions_2): void;
4172
4250
  get observedAttributes(): string[];
4173
4251
  agAttributeChangedCallback(attName: any, oldValue: any, newValue: any): void;
@@ -4665,9 +4743,10 @@ export declare class GridProBaseDatasource extends GenesisGridDatasourceElement
4665
4743
  /**
4666
4744
  * Gets datasource-specific status bar component configurations.
4667
4745
  * This method should be called by the grid to get status bar panels specific to this datasource.
4746
+ * @param suppressLoadMore - Leaves out the Load More panel, for row models that fetch on scroll.
4668
4747
  * @public
4669
4748
  */
4670
- getDatasourceStatusBarPanels(isServerSide: boolean, statusBarConfig: any): any[];
4749
+ getDatasourceStatusBarPanels(suppressLoadMore: boolean, statusBarConfig: any): any[];
4671
4750
  }
4672
4751
 
4673
4752
  /**
@@ -7753,13 +7832,430 @@ declare const GridProServerSideDatasource_base: (new (...args: any[]) => {
7753
7832
  focus(options?: FocusOptions): void;
7754
7833
  }) & typeof GridProBaseDatasource;
7755
7834
 
7835
+ /**
7836
+ * Status bar under the grid. Mounts the existing `IStatusPanelComp` panels.
7837
+ *
7838
+ * @public
7839
+ * @remarks
7840
+ * HTML Element: \<%%prefix%%-grid-pro-status-bar\>
7841
+ *
7842
+ * @tagname %%prefix%%-grid-pro-status-bar
7843
+ */
7844
+ export declare class GridProStatusBar extends GridProStatusBar_base {
7845
+ /** Grid Pro host that owns the api, datasource, and `statusBarConfig`. */
7846
+ gridHost: StatusBarPanelHost | null;
7847
+ /** Optional explicit AG grid API (v36). Falls back to `gridHost.gridApi` when present. */
7848
+ gridApi: GridApi | null;
7849
+ /**
7850
+ * Panel config. Grid Pro binds its own `statusBarConfig` here.
7851
+ * When unset, `gridHost.statusBarConfig` is used.
7852
+ */
7853
+ statusBarConfig: GridProStatusBarConfig | null;
7854
+ /** @internal */
7855
+ leftEl: HTMLElement;
7856
+ /** @internal */
7857
+ rightEl: HTMLElement;
7858
+ private readonly panels;
7859
+ private readonly warnedPanelTypes;
7860
+ gridHostChanged(): void;
7861
+ gridApiChanged(): void;
7862
+ statusBarConfigChanged(): void;
7863
+ leftElChanged(): void;
7864
+ rightElChanged(): void;
7865
+ /**
7866
+ * Rebuilds the mounted panels from the current host / api / config.
7867
+ * @public
7868
+ */
7869
+ syncPanels(): void;
7870
+ /**
7871
+ * Returns a mounted panel by type.
7872
+ * @public
7873
+ */
7874
+ getStatusPanel(key: string): IStatusPanelComp | undefined;
7875
+ /**
7876
+ * Destroys the mounted panels. Call before the grid api is destroyed.
7877
+ * @internal
7878
+ */
7879
+ releasePanels(): void;
7880
+ connectedCallback(): void;
7881
+ disconnectedCallback(): void;
7882
+ private resolveApi;
7883
+ private mountPanel;
7884
+ }
7885
+
7886
+ declare const GridProStatusBar_base: (new (...args: any[]) => {
7887
+ #_container: FoundationLayoutContainer | LayoutCacheContainer | DOMContainer;
7888
+ #_latestTokenCode: string;
7889
+ #_hasFirstLoaded: boolean;
7890
+ #_cleanupTimeout: NodeJS.Timeout;
7891
+ #_shouldForceLifecycle: boolean;
7892
+ #_blockedDisconnectSurvivedGracePeriod: boolean;
7893
+ cloneNode(deep?: boolean): Node;
7894
+ deepClone(): Node;
7895
+ get shouldRunDisconnect(): boolean;
7896
+ get shouldRunConnect(): boolean;
7897
+ #_blockLifecycleDueToTokenChange(lifecycleType: "connect" | "disconnect" | "reconnect"): boolean;
7898
+ #_tryFindContainingLayout(e: Element): FoundationLayoutContainer | LayoutCacheContainer | DOMContainer;
7899
+ connectedCallback(): void;
7900
+ readonly $fastController: Controller;
7901
+ $emit(type: string, detail?: any, options?: Omit<CustomEventInit, "detail">): boolean | void;
7902
+ disconnectedCallback(): void;
7903
+ attributeChangedCallback(name: string, oldValue: string, newValue: string): void;
7904
+ accessKey: string;
7905
+ readonly accessKeyLabel: string;
7906
+ autocapitalize: string;
7907
+ autocorrect: boolean;
7908
+ dir: string;
7909
+ draggable: boolean;
7910
+ hidden: boolean;
7911
+ inert: boolean;
7912
+ innerText: string;
7913
+ lang: string;
7914
+ readonly offsetHeight: number;
7915
+ readonly offsetLeft: number;
7916
+ readonly offsetParent: Element | null;
7917
+ readonly offsetTop: number;
7918
+ readonly offsetWidth: number;
7919
+ outerText: string;
7920
+ popover: string | null;
7921
+ spellcheck: boolean;
7922
+ title: string;
7923
+ translate: boolean;
7924
+ writingSuggestions: string;
7925
+ attachInternals(): ElementInternals;
7926
+ click(): void;
7927
+ hidePopover(): void;
7928
+ showPopover(): void;
7929
+ togglePopover(options?: boolean): boolean;
7930
+ addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
7931
+ addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
7932
+ removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
7933
+ removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
7934
+ readonly attributes: NamedNodeMap;
7935
+ get classList(): DOMTokenList;
7936
+ set classList(value: string): any;
7937
+ className: string;
7938
+ readonly clientHeight: number;
7939
+ readonly clientLeft: number;
7940
+ readonly clientTop: number;
7941
+ readonly clientWidth: number;
7942
+ readonly currentCSSZoom: number;
7943
+ id: string;
7944
+ innerHTML: string;
7945
+ readonly localName: string;
7946
+ readonly namespaceURI: string | null;
7947
+ onfullscreenchange: (this: Element, ev: Event) => any;
7948
+ onfullscreenerror: (this: Element, ev: Event) => any;
7949
+ outerHTML: string;
7950
+ readonly ownerDocument: Document;
7951
+ get part(): DOMTokenList;
7952
+ set part(value: string): any;
7953
+ readonly prefix: string | null;
7954
+ readonly scrollHeight: number;
7955
+ scrollLeft: number;
7956
+ scrollTop: number;
7957
+ readonly scrollWidth: number;
7958
+ readonly shadowRoot: ShadowRoot | null;
7959
+ slot: string;
7960
+ readonly tagName: string;
7961
+ attachShadow(init: ShadowRootInit): ShadowRoot;
7962
+ checkVisibility(options?: CheckVisibilityOptions): boolean;
7963
+ closest<K extends keyof HTMLElementTagNameMap>(selector: K): HTMLElementTagNameMap[K];
7964
+ closest<K extends keyof SVGElementTagNameMap>(selector: K): SVGElementTagNameMap[K];
7965
+ closest<K extends keyof MathMLElementTagNameMap>(selector: K): MathMLElementTagNameMap[K];
7966
+ closest<E extends Element = Element>(selectors: string): E;
7967
+ computedStyleMap(): StylePropertyMapReadOnly;
7968
+ getAttribute(qualifiedName: string): string | null;
7969
+ getAttributeNS(namespace: string | null, localName: string): string | null;
7970
+ getAttributeNames(): string[];
7971
+ getAttributeNode(qualifiedName: string): Attr | null;
7972
+ getAttributeNodeNS(namespace: string | null, localName: string): Attr | null;
7973
+ getBoundingClientRect(): DOMRect;
7974
+ getClientRects(): DOMRectList;
7975
+ getElementsByClassName(classNames: string): HTMLCollectionOf<Element>;
7976
+ getElementsByTagName<K extends keyof HTMLElementTagNameMap>(qualifiedName: K): HTMLCollectionOf<HTMLElementTagNameMap[K]>;
7977
+ getElementsByTagName<K extends keyof SVGElementTagNameMap>(qualifiedName: K): HTMLCollectionOf<SVGElementTagNameMap[K]>;
7978
+ getElementsByTagName<K extends keyof MathMLElementTagNameMap>(qualifiedName: K): HTMLCollectionOf<MathMLElementTagNameMap[K]>;
7979
+ getElementsByTagName<K extends keyof HTMLElementDeprecatedTagNameMap>(qualifiedName: K): HTMLCollectionOf<HTMLElementDeprecatedTagNameMap[K]>;
7980
+ getElementsByTagName(qualifiedName: string): HTMLCollectionOf<Element>;
7981
+ getElementsByTagNameNS(namespaceURI: "http://www.w3.org/1999/xhtml", localName: string): HTMLCollectionOf<HTMLElement>;
7982
+ getElementsByTagNameNS(namespaceURI: "http://www.w3.org/2000/svg", localName: string): HTMLCollectionOf<SVGElement>;
7983
+ getElementsByTagNameNS(namespaceURI: "http://www.w3.org/1998/Math/MathML", localName: string): HTMLCollectionOf<MathMLElement>;
7984
+ getElementsByTagNameNS(namespace: string | null, localName: string): HTMLCollectionOf<Element>;
7985
+ getHTML(options?: GetHTMLOptions): string;
7986
+ hasAttribute(qualifiedName: string): boolean;
7987
+ hasAttributeNS(namespace: string | null, localName: string): boolean;
7988
+ hasAttributes(): boolean;
7989
+ hasPointerCapture(pointerId: number): boolean;
7990
+ insertAdjacentElement(where: InsertPosition, element: Element): Element | null;
7991
+ insertAdjacentHTML(position: InsertPosition, string: string): void;
7992
+ insertAdjacentText(where: InsertPosition, data: string): void;
7993
+ matches(selectors: string): boolean;
7994
+ releasePointerCapture(pointerId: number): void;
7995
+ removeAttribute(qualifiedName: string): void;
7996
+ removeAttributeNS(namespace: string | null, localName: string): void;
7997
+ removeAttributeNode(attr: Attr): Attr;
7998
+ requestFullscreen(options?: FullscreenOptions): Promise<void>;
7999
+ requestPointerLock(options?: PointerLockOptions): Promise<void>;
8000
+ scroll(options?: ScrollToOptions): void;
8001
+ scroll(x: number, y: number): void;
8002
+ scrollBy(options?: ScrollToOptions): void;
8003
+ scrollBy(x: number, y: number): void;
8004
+ scrollIntoView(arg?: boolean | ScrollIntoViewOptions): void;
8005
+ scrollTo(options?: ScrollToOptions): void;
8006
+ scrollTo(x: number, y: number): void;
8007
+ setAttribute(qualifiedName: string, value: string): void;
8008
+ setAttributeNS(namespace: string | null, qualifiedName: string, value: string): void;
8009
+ setAttributeNode(attr: Attr): Attr | null;
8010
+ setAttributeNodeNS(attr: Attr): Attr | null;
8011
+ setHTMLUnsafe(html: string): void;
8012
+ setPointerCapture(pointerId: number): void;
8013
+ toggleAttribute(qualifiedName: string, force?: boolean): boolean;
8014
+ webkitMatchesSelector(selectors: string): boolean;
8015
+ textContent: string;
8016
+ readonly baseURI: string;
8017
+ readonly childNodes: NodeListOf<ChildNode>;
8018
+ readonly firstChild: ChildNode | null;
8019
+ readonly isConnected: boolean;
8020
+ readonly lastChild: ChildNode | null;
8021
+ readonly nextSibling: ChildNode | null;
8022
+ readonly nodeName: string;
8023
+ readonly nodeType: number;
8024
+ nodeValue: string | null;
8025
+ readonly parentElement: HTMLElement | null;
8026
+ readonly parentNode: ParentNode | null;
8027
+ readonly previousSibling: ChildNode | null;
8028
+ appendChild<T_1 extends Node>(node: T_1): T_1;
8029
+ compareDocumentPosition(other: Node): number;
8030
+ contains(other: Node | null): boolean;
8031
+ getRootNode(options?: GetRootNodeOptions): Node;
8032
+ hasChildNodes(): boolean;
8033
+ insertBefore<T_1 extends Node>(node: T_1, child: Node | null): T_1;
8034
+ isDefaultNamespace(namespace: string | null): boolean;
8035
+ isEqualNode(otherNode: Node | null): boolean;
8036
+ isSameNode(otherNode: Node | null): boolean;
8037
+ lookupNamespaceURI(prefix: string | null): string | null;
8038
+ lookupPrefix(namespace: string | null): string | null;
8039
+ normalize(): void;
8040
+ removeChild<T_1 extends Node>(child: T_1): T_1;
8041
+ replaceChild<T_1 extends Node>(node: Node, child: T_1): T_1;
8042
+ readonly ELEMENT_NODE: 1;
8043
+ readonly ATTRIBUTE_NODE: 2;
8044
+ readonly TEXT_NODE: 3;
8045
+ readonly CDATA_SECTION_NODE: 4;
8046
+ readonly ENTITY_REFERENCE_NODE: 5;
8047
+ readonly ENTITY_NODE: 6;
8048
+ readonly PROCESSING_INSTRUCTION_NODE: 7;
8049
+ readonly COMMENT_NODE: 8;
8050
+ readonly DOCUMENT_NODE: 9;
8051
+ readonly DOCUMENT_TYPE_NODE: 10;
8052
+ readonly DOCUMENT_FRAGMENT_NODE: 11;
8053
+ readonly NOTATION_NODE: 12;
8054
+ readonly DOCUMENT_POSITION_DISCONNECTED: 1;
8055
+ readonly DOCUMENT_POSITION_PRECEDING: 2;
8056
+ readonly DOCUMENT_POSITION_FOLLOWING: 4;
8057
+ readonly DOCUMENT_POSITION_CONTAINS: 8;
8058
+ readonly DOCUMENT_POSITION_CONTAINED_BY: 16;
8059
+ readonly DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC: 32;
8060
+ dispatchEvent(event: Event): boolean;
8061
+ ariaActiveDescendantElement: Element | null;
8062
+ ariaAtomic: string | null;
8063
+ ariaAutoComplete: string | null;
8064
+ ariaBrailleLabel: string | null;
8065
+ ariaBrailleRoleDescription: string | null;
8066
+ ariaBusy: string | null;
8067
+ ariaChecked: string | null;
8068
+ ariaColCount: string | null;
8069
+ ariaColIndex: string | null;
8070
+ ariaColIndexText: string | null;
8071
+ ariaColSpan: string | null;
8072
+ ariaControlsElements: ReadonlyArray<Element> | null;
8073
+ ariaCurrent: string | null;
8074
+ ariaDescribedByElements: ReadonlyArray<Element> | null;
8075
+ ariaDescription: string | null;
8076
+ ariaDetailsElements: ReadonlyArray<Element> | null;
8077
+ ariaDisabled: string | null;
8078
+ ariaErrorMessageElements: ReadonlyArray<Element> | null;
8079
+ ariaExpanded: string | null;
8080
+ ariaFlowToElements: ReadonlyArray<Element> | null;
8081
+ ariaHasPopup: string | null;
8082
+ ariaHidden: string | null;
8083
+ ariaInvalid: string | null;
8084
+ ariaKeyShortcuts: string | null;
8085
+ ariaLabel: string | null;
8086
+ ariaLabelledByElements: ReadonlyArray<Element> | null;
8087
+ ariaLevel: string | null;
8088
+ ariaLive: string | null;
8089
+ ariaModal: string | null;
8090
+ ariaMultiLine: string | null;
8091
+ ariaMultiSelectable: string | null;
8092
+ ariaOrientation: string | null;
8093
+ ariaOwnsElements: ReadonlyArray<Element> | null;
8094
+ ariaPlaceholder: string | null;
8095
+ ariaPosInSet: string | null;
8096
+ ariaPressed: string | null;
8097
+ ariaReadOnly: string | null;
8098
+ ariaRelevant: string | null;
8099
+ ariaRequired: string | null;
8100
+ ariaRoleDescription: string | null;
8101
+ ariaRowCount: string | null;
8102
+ ariaRowIndex: string | null;
8103
+ ariaRowIndexText: string | null;
8104
+ ariaRowSpan: string | null;
8105
+ ariaSelected: string | null;
8106
+ ariaSetSize: string | null;
8107
+ ariaSort: string | null;
8108
+ ariaValueMax: string | null;
8109
+ ariaValueMin: string | null;
8110
+ ariaValueNow: string | null;
8111
+ ariaValueText: string | null;
8112
+ role: string | null;
8113
+ animate(keyframes: Keyframe[] | PropertyIndexedKeyframes | null, options?: number | KeyframeAnimationOptions): Animation;
8114
+ getAnimations(options?: GetAnimationsOptions): Animation[];
8115
+ after(...nodes: (Node | string)[]): void;
8116
+ before(...nodes: (Node | string)[]): void;
8117
+ remove(): void;
8118
+ replaceWith(...nodes: (Node | string)[]): void;
8119
+ readonly nextElementSibling: Element | null;
8120
+ readonly previousElementSibling: Element | null;
8121
+ readonly childElementCount: number;
8122
+ readonly children: HTMLCollection;
8123
+ readonly firstElementChild: Element | null;
8124
+ readonly lastElementChild: Element | null;
8125
+ append(...nodes: (Node | string)[]): void;
8126
+ prepend(...nodes: (Node | string)[]): void;
8127
+ querySelector<K extends keyof HTMLElementTagNameMap>(selectors: K): HTMLElementTagNameMap[K] | null;
8128
+ querySelector<K extends keyof SVGElementTagNameMap>(selectors: K): SVGElementTagNameMap[K] | null;
8129
+ querySelector<K extends keyof MathMLElementTagNameMap>(selectors: K): MathMLElementTagNameMap[K] | null;
8130
+ querySelector<K extends keyof HTMLElementDeprecatedTagNameMap>(selectors: K): HTMLElementDeprecatedTagNameMap[K] | null;
8131
+ querySelector<E extends Element = Element>(selectors: string): E | null;
8132
+ querySelectorAll<K extends keyof HTMLElementTagNameMap>(selectors: K): NodeListOf<HTMLElementTagNameMap[K]>;
8133
+ querySelectorAll<K extends keyof SVGElementTagNameMap>(selectors: K): NodeListOf<SVGElementTagNameMap[K]>;
8134
+ querySelectorAll<K extends keyof MathMLElementTagNameMap>(selectors: K): NodeListOf<MathMLElementTagNameMap[K]>;
8135
+ querySelectorAll<K extends keyof HTMLElementDeprecatedTagNameMap>(selectors: K): NodeListOf<HTMLElementDeprecatedTagNameMap[K]>;
8136
+ querySelectorAll<E extends Element = Element>(selectors: string): NodeListOf<E>;
8137
+ replaceChildren(...nodes: (Node | string)[]): void;
8138
+ readonly assignedSlot: HTMLSlotElement | null;
8139
+ readonly attributeStyleMap: StylePropertyMap;
8140
+ get style(): CSSStyleDeclaration;
8141
+ set style(cssText: string): any;
8142
+ contentEditable: string;
8143
+ enterKeyHint: string;
8144
+ inputMode: string;
8145
+ readonly isContentEditable: boolean;
8146
+ onabort: ((this: GlobalEventHandlers, ev: UIEvent) => any) | null;
8147
+ onanimationcancel: ((this: GlobalEventHandlers, ev: AnimationEvent) => any) | null;
8148
+ onanimationend: ((this: GlobalEventHandlers, ev: AnimationEvent) => any) | null;
8149
+ onanimationiteration: ((this: GlobalEventHandlers, ev: AnimationEvent) => any) | null;
8150
+ onanimationstart: ((this: GlobalEventHandlers, ev: AnimationEvent) => any) | null;
8151
+ onauxclick: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
8152
+ onbeforeinput: ((this: GlobalEventHandlers, ev: InputEvent) => any) | null;
8153
+ onbeforematch: ((this: GlobalEventHandlers, ev: Event) => any) | null;
8154
+ onbeforetoggle: ((this: GlobalEventHandlers, ev: ToggleEvent) => any) | null;
8155
+ onblur: ((this: GlobalEventHandlers, ev: FocusEvent) => any) | null;
8156
+ oncancel: ((this: GlobalEventHandlers, ev: Event) => any) | null;
8157
+ oncanplay: ((this: GlobalEventHandlers, ev: Event) => any) | null;
8158
+ oncanplaythrough: ((this: GlobalEventHandlers, ev: Event) => any) | null;
8159
+ onchange: ((this: GlobalEventHandlers, ev: Event) => any) | null;
8160
+ onclick: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
8161
+ onclose: ((this: GlobalEventHandlers, ev: Event) => any) | null;
8162
+ oncontextlost: ((this: GlobalEventHandlers, ev: Event) => any) | null;
8163
+ oncontextmenu: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
8164
+ oncontextrestored: ((this: GlobalEventHandlers, ev: Event) => any) | null;
8165
+ oncopy: ((this: GlobalEventHandlers, ev: ClipboardEvent) => any) | null;
8166
+ oncuechange: ((this: GlobalEventHandlers, ev: Event) => any) | null;
8167
+ oncut: ((this: GlobalEventHandlers, ev: ClipboardEvent) => any) | null;
8168
+ ondblclick: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
8169
+ ondrag: ((this: GlobalEventHandlers, ev: DragEvent) => any) | null;
8170
+ ondragend: ((this: GlobalEventHandlers, ev: DragEvent) => any) | null;
8171
+ ondragenter: ((this: GlobalEventHandlers, ev: DragEvent) => any) | null;
8172
+ ondragleave: ((this: GlobalEventHandlers, ev: DragEvent) => any) | null;
8173
+ ondragover: ((this: GlobalEventHandlers, ev: DragEvent) => any) | null;
8174
+ ondragstart: ((this: GlobalEventHandlers, ev: DragEvent) => any) | null;
8175
+ ondrop: ((this: GlobalEventHandlers, ev: DragEvent) => any) | null;
8176
+ ondurationchange: ((this: GlobalEventHandlers, ev: Event) => any) | null;
8177
+ onemptied: ((this: GlobalEventHandlers, ev: Event) => any) | null;
8178
+ onended: ((this: GlobalEventHandlers, ev: Event) => any) | null;
8179
+ onerror: OnErrorEventHandler;
8180
+ onfocus: ((this: GlobalEventHandlers, ev: FocusEvent) => any) | null;
8181
+ onformdata: ((this: GlobalEventHandlers, ev: FormDataEvent) => any) | null;
8182
+ ongotpointercapture: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
8183
+ oninput: ((this: GlobalEventHandlers, ev: Event) => any) | null;
8184
+ oninvalid: ((this: GlobalEventHandlers, ev: Event) => any) | null;
8185
+ onkeydown: ((this: GlobalEventHandlers, ev: KeyboardEvent) => any) | null;
8186
+ onkeypress: ((this: GlobalEventHandlers, ev: KeyboardEvent) => any) | null;
8187
+ onkeyup: ((this: GlobalEventHandlers, ev: KeyboardEvent) => any) | null;
8188
+ onload: ((this: GlobalEventHandlers, ev: Event) => any) | null;
8189
+ onloadeddata: ((this: GlobalEventHandlers, ev: Event) => any) | null;
8190
+ onloadedmetadata: ((this: GlobalEventHandlers, ev: Event) => any) | null;
8191
+ onloadstart: ((this: GlobalEventHandlers, ev: Event) => any) | null;
8192
+ onlostpointercapture: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
8193
+ onmousedown: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
8194
+ onmouseenter: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
8195
+ onmouseleave: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
8196
+ onmousemove: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
8197
+ onmouseout: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
8198
+ onmouseover: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
8199
+ onmouseup: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
8200
+ onpaste: ((this: GlobalEventHandlers, ev: ClipboardEvent) => any) | null;
8201
+ onpause: ((this: GlobalEventHandlers, ev: Event) => any) | null;
8202
+ onplay: ((this: GlobalEventHandlers, ev: Event) => any) | null;
8203
+ onplaying: ((this: GlobalEventHandlers, ev: Event) => any) | null;
8204
+ onpointercancel: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
8205
+ onpointerdown: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
8206
+ onpointerenter: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
8207
+ onpointerleave: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
8208
+ onpointermove: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
8209
+ onpointerout: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
8210
+ onpointerover: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
8211
+ onpointerrawupdate: ((this: GlobalEventHandlers, ev: Event) => any) | null;
8212
+ onpointerup: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
8213
+ onprogress: ((this: GlobalEventHandlers, ev: ProgressEvent) => any) | null;
8214
+ onratechange: ((this: GlobalEventHandlers, ev: Event) => any) | null;
8215
+ onreset: ((this: GlobalEventHandlers, ev: Event) => any) | null;
8216
+ onresize: ((this: GlobalEventHandlers, ev: UIEvent) => any) | null;
8217
+ onscroll: ((this: GlobalEventHandlers, ev: Event) => any) | null;
8218
+ onscrollend: ((this: GlobalEventHandlers, ev: Event) => any) | null;
8219
+ onsecuritypolicyviolation: ((this: GlobalEventHandlers, ev: SecurityPolicyViolationEvent) => any) | null;
8220
+ onseeked: ((this: GlobalEventHandlers, ev: Event) => any) | null;
8221
+ onseeking: ((this: GlobalEventHandlers, ev: Event) => any) | null;
8222
+ onselect: ((this: GlobalEventHandlers, ev: Event) => any) | null;
8223
+ onselectionchange: ((this: GlobalEventHandlers, ev: Event) => any) | null;
8224
+ onselectstart: ((this: GlobalEventHandlers, ev: Event) => any) | null;
8225
+ onslotchange: ((this: GlobalEventHandlers, ev: Event) => any) | null;
8226
+ onstalled: ((this: GlobalEventHandlers, ev: Event) => any) | null;
8227
+ onsubmit: ((this: GlobalEventHandlers, ev: SubmitEvent) => any) | null;
8228
+ onsuspend: ((this: GlobalEventHandlers, ev: Event) => any) | null;
8229
+ ontimeupdate: ((this: GlobalEventHandlers, ev: Event) => any) | null;
8230
+ ontoggle: ((this: GlobalEventHandlers, ev: ToggleEvent) => any) | null;
8231
+ ontouchcancel?: ((this: GlobalEventHandlers, ev: TouchEvent) => any) | null | undefined;
8232
+ ontouchend?: ((this: GlobalEventHandlers, ev: TouchEvent) => any) | null | undefined;
8233
+ ontouchmove?: ((this: GlobalEventHandlers, ev: TouchEvent) => any) | null | undefined;
8234
+ ontouchstart?: ((this: GlobalEventHandlers, ev: TouchEvent) => any) | null | undefined;
8235
+ ontransitioncancel: ((this: GlobalEventHandlers, ev: TransitionEvent) => any) | null;
8236
+ ontransitionend: ((this: GlobalEventHandlers, ev: TransitionEvent) => any) | null;
8237
+ ontransitionrun: ((this: GlobalEventHandlers, ev: TransitionEvent) => any) | null;
8238
+ ontransitionstart: ((this: GlobalEventHandlers, ev: TransitionEvent) => any) | null;
8239
+ onvolumechange: ((this: GlobalEventHandlers, ev: Event) => any) | null;
8240
+ onwaiting: ((this: GlobalEventHandlers, ev: Event) => any) | null;
8241
+ onwebkitanimationend: ((this: GlobalEventHandlers, ev: Event) => any) | null;
8242
+ onwebkitanimationiteration: ((this: GlobalEventHandlers, ev: Event) => any) | null;
8243
+ onwebkitanimationstart: ((this: GlobalEventHandlers, ev: Event) => any) | null;
8244
+ onwebkittransitionend: ((this: GlobalEventHandlers, ev: Event) => any) | null;
8245
+ onwheel: ((this: GlobalEventHandlers, ev: WheelEvent) => any) | null;
8246
+ autofocus: boolean;
8247
+ readonly dataset: DOMStringMap;
8248
+ nonce?: string;
8249
+ tabIndex: number;
8250
+ blur(): void;
8251
+ focus(options?: FocusOptions): void;
8252
+ }) & typeof FoundationElement;
8253
+
7756
8254
  /**
7757
8255
  * Configuration options for the grid status bar components
7758
8256
  * @public
7759
8257
  * @remarks
7760
- * This requires AG Grid Enterprise module to be enabled.
7761
- * Status bar components will only be displayed if the Enterprise module is available.
7762
- * @see https://www.ag-grid.com/javascript-data-grid/component-status-bar/
8258
+ * On {@link GridPro} these panels mount in the status-bar host.
7763
8259
  */
7764
8260
  export declare interface GridProStatusBarConfig {
7765
8261
  /**
@@ -7784,7 +8280,7 @@ export declare interface GridProStatusBarConfig {
7784
8280
  reload?: boolean | GridProStatusBarReloadConfig;
7785
8281
  /**
7786
8282
  * Enable aggregation status bar component.
7787
- * @remarks Default is true. Shows aggregation values for selected columns.
8283
+ * @remarks Default is true. Ignored until a panel exists for it.
7788
8284
  */
7789
8285
  aggregation?: boolean;
7790
8286
  }
@@ -7857,9 +8353,8 @@ export declare interface GridProStatusBarReloadConfig {
7857
8353
  * The available Grid Pro Status Bar Types
7858
8354
  * @public
7859
8355
  * @remarks
7860
- * These status bar components require AG Grid Enterprise module to be enabled.
7861
- * Status bar components will only be displayed if the Enterprise module is available.
7862
- * @see https://www.ag-grid.com/javascript-data-grid/component-status-bar/
8356
+ * Mounted by the status-bar host on {@link GridPro}.
8357
+ * `aggregation` is ignored until a panel exists for it.
7863
8358
  */
7864
8359
  export declare enum GridProStatusBarTypes {
7865
8360
  labelValue = "labelValue",
@@ -8791,6 +9286,14 @@ export declare type ReloadStatusBarParams = {
8791
9286
  /** @public */
8792
9287
  export declare function reorderVisibleIds(allVisibleIds: string[], shownIds: string[], fromId: string, toId: string): string[] | null;
8793
9288
 
9289
+ /**
9290
+ * Builds the panel list for AG Grid's enterprise status bar, used when its `StatusBarModule` is
9291
+ * registered. Client-side grids get AG's filtered / total row count, and `aggregation` maps to
9292
+ * AG's aggregation panel. Panels from `gridOptions.statusBar` come first and are kept.
9293
+ * @internal
9294
+ */
9295
+ export declare function resolveAgStatusBarPanels(host: StatusBarPanelHost, userPanels?: StatusBarPanelDef[]): StatusBarPanelDef[];
9296
+
8794
9297
  /** @public */
8795
9298
  export declare function resolveColumnDragBridge(context: unknown): GridProColumnDragBridge | null;
8796
9299
 
@@ -8812,6 +9315,13 @@ export declare function resolveColumnPickerSort(sort?: ColumnPickerSort | null):
8812
9315
  */
8813
9316
  export declare function resolveColumnsPickerApi(gridHost?: ColumnSelectionHost | null, gridApi?: GridApi | null): GridApi | null;
8814
9317
 
9318
+ /**
9319
+ * Builds the status-bar panel list from `withStatusBar` + `statusBarConfig`.
9320
+ * `aggregation` is ignored until a panel exists for it.
9321
+ * @internal
9322
+ */
9323
+ export declare function resolveStatusBarPanels(host: StatusBarPanelHost): StatusBarPanelDef[];
9324
+
8815
9325
  /**
8816
9326
  * Resolves the field names of the currently visible columns.
8817
9327
  * @remarks Prefers the grid's displayed columns (`getAllDisplayedColumns()` — already excludes
@@ -9316,6 +9826,47 @@ export declare interface StatePersistence {
9316
9826
  */
9317
9827
  export declare const StatePersistence: InterfaceSymbol<StatePersistence>;
9318
9828
 
9829
+ /**
9830
+ * A panel to mount in the status-bar host.
9831
+ * `statusPanel` is one of {@link GridProStatusBarTypes}.
9832
+ * @public
9833
+ */
9834
+ export declare interface StatusBarPanelDef {
9835
+ statusPanel: string;
9836
+ statusPanelParams?: Record<string, unknown>;
9837
+ align?: 'left' | 'right';
9838
+ }
9839
+
9840
+ /**
9841
+ * Grid / datasource fields the resolver reads. Matches {@link GridPro} without importing the class.
9842
+ * @public
9843
+ */
9844
+ export declare interface StatusBarPanelHost {
9845
+ withStatusBar: boolean;
9846
+ statusBarConfig: GridProStatusBarConfig | null | undefined;
9847
+ isServerSide: boolean;
9848
+ isInfiniteRowModel: boolean;
9849
+ gridApi?: GridApi | null;
9850
+ /** Params already pushed to a panel, applied when it is mounted. */
9851
+ getStatusPanelState?: (key: string) => Record<string, unknown> | undefined;
9852
+ gridProDatasource?: {
9853
+ maxRows?: number;
9854
+ getDatasourceStatusBarPanels?: (suppressLoadMore: boolean, statusBarConfig: GridProStatusBarConfig) => StatusBarPanelDef[];
9855
+ } | null;
9856
+ }
9857
+
9858
+ /**
9859
+ * Status-bar host styles. Tokens follow the grid so the bar matches.
9860
+ * @public
9861
+ */
9862
+ export declare const statusBarStyles: ElementStyles;
9863
+
9864
+ /**
9865
+ * Default status bar template.
9866
+ * @public
9867
+ */
9868
+ export declare const statusBarTemplate: ViewTemplate<GridProStatusBar, any>;
9869
+
9319
9870
  /**
9320
9871
  * The AG Status Pill Renderer element.
9321
9872
  * @public