@genesislcap/grid-pro 15.25.1 → 15.26.0

package/dist/grid-pro.d.ts

@@ -26,8 +26,8 @@ import { ColDef as ColDef_2 } from 'ag-grid-community';
 import { ColGroupDef } from '@ag-grid-community/core';
 import { ColSpanFunc } from 'ag-grid-community';
 import { ColSpanParams } from '@ag-grid-community/core';
-import { Column } from '@ag-grid-community/core';
-import { Column as Column_2 } from 'ag-grid-community';
+import { Column } from 'ag-grid-community';
+import { Column as Column_2 } from '@ag-grid-community/core';
 import type { ColumnApi } from '@ag-grid-community/core';
 import { ColumnChooserParams } from 'ag-grid-community';
 import { ColumnMenuTab } from '@ag-grid-community/core';
@@ -68,10 +68,12 @@ import { GetMainMenuItems } from 'ag-grid-community';
 import { GetQuickFilterText } from 'ag-grid-community';
 import { GetQuickFilterTextParams } from '@ag-grid-community/core';
 import { Grid } from '@ag-grid-community/core';
-import type { GridApi } from '@ag-grid-community/core';
-import type { GridApi as GridApi_2 } from 'ag-grid-community';
+import { GridApi } from 'ag-grid-community';
+import type { GridApi as GridApi_2 } from '@ag-grid-community/core';
+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 { GridReadyEvent } from 'ag-grid-community';
@@ -118,6 +120,7 @@ import { LayoutCacheContainer } from '@genesislcap/foundation-utils';
 import { Logger } from '@genesislcap/foundation-logger';
 import { MenuItemDef } from 'ag-grid-community';
 import { MetadataDetail } from '@genesislcap/foundation-comms';
+import { Module } from 'ag-grid-community';
 import { NewValueParams } from '@ag-grid-community/core';
 import { NewValueParams as NewValueParams_2 } from 'ag-grid-community';
 import { OverrideFoundationElementDefinition } from '@microsoft/fast-foundation';
@@ -578,6 +581,12 @@ export declare const agThemeTokenMapClassname: (themeName: string) => string;
  */
 export declare const agThemeTokenMapCSS: (themeName: string, tokenMap: CSSVarTokenMap<any>) => ElementStyles;
 
+/** @public */
+export declare function applyVisibleOrder<T extends {
+    colId?: string;
+    hide?: boolean | null;
+}>(columnState: T[], visibleOrder: string[]): T[];
+
 /**
  * The background color swatch.
  * @internal
@@ -601,55 +610,651 @@ export declare type BaseDatasourceErrorEventDetail = {
 };
 
 /**
- * Base datasource error event names.
+ * Base datasource error event names.
+ * @public
+ */
+export declare const baseDatasourceEventNames: {
+    readonly error: "base-datasource-error";
+    readonly connected: "base-datasource-connected";
+};
+
+/**
+ * Registers an AG Grid `ToolPanel` drag source on a picker row handle so drops on
+ * the grid header use AG column-move (visibility + exact index).
+ *
+ * @public
+ */
+export declare function bindAgColumnPickerDrag(bridge: GridProColumnDragBridge, api: GridApi, handle: HTMLElement, colId: string, dragItemName: string): ColumnPickerAgDragBinding | null;
+
+/**
+ * The AG Boolean Renderer element.
+ * @public
+ * @tagname %%prefix%%-boolean-renderer
+ */
+export declare class BooleanRenderer extends FoundationElement implements ICellRendererComp {
+    params: ICellRendererParams & BooleanRendererParams;
+    selected: boolean;
+    isDisabled(data: any): boolean;
+    init(params: ICellRendererParams): void;
+    /** @internal */
+    userInputHandler(e: Event): void;
+    getGui(): HTMLElement;
+    destroy(): void;
+    refresh(params: ICellRendererParams): boolean;
+    getValue(): boolean;
+    isCancelBeforeStart(): boolean;
+    /** @internal */
+    getDataTestId(): string | null;
+}
+
+/**
+ * Parameters for the {@link @genesislcap/grid-pro#GridPro} boolean renderer.
+ * @public
+ */
+export declare type BooleanRendererParams = {
+    /**
+     * Function to determine whether the boolean renderer should be disabled for a specific row.
+     * @param rowData - The data associated with the row.
+     * @returns A boolean indicating whether the button should be disabled.
+     */
+    isDisabled?: (rowData: any) => boolean;
+    onChange?: <T>(rowData: T) => void;
+    dataTestId?: (<T>(rowData: T) => string) | string;
+};
+
+declare type BridgeInitBeans = {
+    dragAndDrop?: GridProColumnDragBridge['dragAndDrop'];
+    gos?: GridOptionsService;
+    gridOptions?: {
+        context?: GridProColumnDragBridgeContext;
+    };
+};
+
+/**
+ * The Grid Pro Cell Template.
+ * @public
+ */
+export declare const CellTemplate: ViewTemplate<GridProCell, any>;
+
+/** @public */
+export declare const COLUMN_PICKER_SORT_DEFAULT: ColumnPickerSort;
+
+/**
+ * Active AG drag registration for a picker handle.
+ * @public
+ */
+export declare type ColumnPickerAgDragBinding = {
+    source: GridDragSource;
+    remove: () => void;
+};
+
+/**
+ * Row model for the column selection picker list.
+ * @public
+ */
+export declare interface ColumnPickerItem {
+    colId: string;
+    headerName: string;
+    visible: boolean;
+    lockVisible: boolean;
+}
+
+/**
+ * Column list ordering for the column selection picker.
+ * @public
+ */
+export declare type ColumnPickerSort = 'selected-first' | 'ag-grid';
+
+/**
+ * Button + popover column picker for Grid Pro (Community).
+ *
+ * @public
+ * @remarks
+ * HTML Element: \<%%prefix%%-column-selection\>
+ *
+ * Provide either `:gridApi` (AG v36) or `:gridHost` (Grid Pro element with `gridApi` / `columnApi`).
+ *
+ * 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`).
+ *
+ * Layout: select-all + search → column list. Ordering via `sort`
+ * (`selected-first` default, or `ag-grid`). Checkboxes toggle visibility via
+ * `api.setColumnsVisible`; drag handles on hidden rows use AG native DnD onto the grid
+ * (`allowDragFromColumnsToolPanel`); visible rows reorder inside the picker via HTML5 drag.
+ *
+ * @tagname %%prefix%%-column-selection
+ */
+export declare class ColumnSelection extends ColumnSelection_base {
+    /** Button label. */
+    label: string;
+    /**
+     * Column list ordering.
+     * - `selected-first` (default): visible first (grid display order), then hidden A–Z.
+     * - `ag-grid`: `api.getColumnState()` order (visible/hidden interleaved).
+     */
+    sort: ColumnPickerSort;
+    /** Whether the popover is open. */
+    open: boolean;
+    /** Optional explicit AG grid API (v36). */
+    gridApi: GridApi | null;
+    /** Grid Pro host element; column API is bridged when needed. */
+    gridHost: ColumnSelectionHost | null;
+    /** @internal */
+    root: HTMLElement;
+    /** @internal */
+    buttonEl: HTMLElement;
+    /** @internal */
+    panelEl: HTMLElement;
+    search: string;
+    selectedItems: ColumnPickerItem[];
+    unselectedItems: ColumnPickerItem[];
+    /** Master checkbox checked when every toggleable column is visible. */
+    selectAllChecked: boolean;
+    /** Master checkbox mixed when some (but not all) toggleable columns are visible. */
+    selectAllIndeterminate: boolean;
+    /** Resolved sort; kept in sync with `@attr sort`. */
+    private resolvedSort;
+    /** Source colId while a visible-row drag is in progress. */
+    private dragColId;
+    /** Row currently showing drag-over highlight (avoid observable updates mid-drag). */
+    private dragOverElement;
+    /** Cancels row drag listeners when the selected list re-renders. */
+    private dragBindingAbort;
+    /** AG ToolPanel drag sources registered on hidden-row handles (grid drop). */
+    private agDragBindings;
+    /** Shared DnD bridge from Grid Pro. */
+    private columnDragBridge;
+    /** Retries `bindRowDrag` until the DnD bridge is populated. */
+    private dragBridgeRetryId;
+    /** Optimistic visibility while the grid applies setColumnsVisible. */
+    private pendingVisibility;
+    /** Stable listener refs so close/disconnect can remove the same functions. */
+    private readonly boundRefresh;
+    private get pickerApi();
+    private set pickerApi(value);
+    /** Query root for picker DOM (shadow panel). */
+    private get pickerRoot();
+    /** Drag reorder / grid drop disabled while search filter is active. */
+    get canDrag(): boolean;
+    /** Handle is draggable onto the grid (hidden columns, or all when using ag-grid sort). */
+    canDragToGrid(item: ColumnPickerItem): boolean;
+    /** Columns in the current (search-filtered) picker lists that can be toggled. */
+    private get toggleableItems();
+    openChanged(oldValue?: boolean): void;
+    sortChanged(): void;
+    gridApiChanged(): void;
+    gridHostChanged(): void;
+    panelElChanged(): void;
+    /**
+     * Subscribe to grid column events and rebuild picker lists.
+     * Called automatically when the popover opens; exposed for tests/hosts that need an early bind.
+     * @internal
+     */
+    connectPicker(): void;
+    /**
+     * Opens or closes the popover.
+     * @public
+     */
+    toggle(): void;
+    /**
+     * Closes the popover.
+     * @public
+     */
+    close(): void;
+    /**
+     * Rebuilds picker lists from current grid column state.
+     */
+    refresh(): void;
+    disconnectedCallback(): void;
+    private readonly handleClickOutside;
+    private showPanel;
+    private hidePanel;
+    private subscribePicker;
+    private resubscribePicker;
+    private unsubscribePicker;
+    private syncSelectAllState;
+    private applyPendingVisibility;
+    private resolveDragBridge;
+    /**
+     * Visible rows: HTML5 reorder inside the picker.
+     * Hidden rows (or all rows when `sort=ag-grid`): AG ToolPanel drag onto the grid header.
+     */
+    private bindRowDrag;
+    private scheduleDragBridgeRetry;
+    /**
+     * @internal
+     */
+    onSearchInput(value: string): void;
+    /**
+     * @internal
+     */
+    onSelectAllClick(event: MouseEvent): void;
+    /**
+     * @internal
+     */
+    onCheckboxClick(item: ColumnPickerItem, event: MouseEvent): void;
+    /**
+     * @internal
+     */
+    onVisibilityChange(item: ColumnPickerItem, visible: boolean): void;
+    /**
+     * @internal
+     */
+    onDragStart(event: DragEvent, colId: string, row?: HTMLElement): void;
+    /**
+     * @internal
+     */
+    onDragEnd(): void;
+    /**
+     * @internal
+     */
+    onDragOver(event: DragEvent, row: HTMLElement): void;
+    /**
+     * @internal
+     */
+    onDragLeave(event: DragEvent, row: HTMLElement): void;
+    /**
+     * @internal
+     */
+    onDrop(event: DragEvent, colId: string): void;
+    private clearDragOverHighlight;
+    /**
+     * Applies a new visible-column order via `applyColumnState({ applyOrder: true })`.
+     * Hidden columns keep their relative positions; only the visible slice is permuted.
+     */
+    private reorderSelected;
+}
+
+declare const ColumnSelection_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;
+
+/**
+ * Grid host shape shared by classic (v29) and beta (v36) Grid Pro elements.
  * @public
  */
-export declare const baseDatasourceEventNames: {
-    readonly error: "base-datasource-error";
-    readonly connected: "base-datasource-connected";
+export declare type ColumnSelectionHost = {
+    gridApi?: Record<string, unknown>;
+    columnApi?: Record<string, unknown>;
+    getColumnDragBridge?: () => GridProColumnDragBridge;
 };
 
 /**
- * The AG Boolean Renderer element.
- * @public
- * @tagname %%prefix%%-boolean-renderer
- */
-export declare class BooleanRenderer extends FoundationElement implements ICellRendererComp {
-    params: ICellRendererParams & BooleanRendererParams;
-    selected: boolean;
-    isDisabled(data: any): boolean;
-    init(params: ICellRendererParams): void;
-    /** @internal */
-    userInputHandler(e: Event): void;
-    getGui(): HTMLElement;
-    destroy(): void;
-    refresh(params: ICellRendererParams): boolean;
-    getValue(): boolean;
-    isCancelBeforeStart(): boolean;
-    /** @internal */
-    getDataTestId(): string | null;
-}
-
-/**
- * Parameters for the {@link @genesislcap/grid-pro#GridPro} boolean renderer.
+ * Styles for {@link ColumnSelection}.
  * @public
  */
-export declare type BooleanRendererParams = {
-    /**
-     * Function to determine whether the boolean renderer should be disabled for a specific row.
-     * @param rowData - The data associated with the row.
-     * @returns A boolean indicating whether the button should be disabled.
-     */
-    isDisabled?: (rowData: any) => boolean;
-    onChange?: <T>(rowData: T) => void;
-    dataTestId?: (<T>(rowData: T) => string) | string;
-};
+export declare const columnSelectionStyles: ElementStyles;
 
 /**
- * The Grid Pro Cell Template.
+ * Default column selection template (`foundation-*` components).
  * @public
  */
-export declare const CellTemplate: ViewTemplate<GridProCell, any>;
+export declare const columnSelectionTemplate: ViewTemplate<ColumnSelection, any>;
 
 /**
  * The Grid Pro Column Template.
@@ -1445,6 +2050,23 @@ styles: ElementStyles;
 template: ViewTemplate<AgTextFieldRenderer, any>;
 }, typeof AgTextRenderer>;
 
+/**
+ * Foundation Column Selection registration.
+ *
+ * @public
+ * @remarks
+ * HTML Element: \<foundation-column-selection\>
+ */
+export declare const foundationColumnSelection: (overrideDefinition?: OverrideFoundationElementDefinition<    {
+baseName: string;
+template: ViewTemplate<ColumnSelection, any>;
+styles: ElementStyles;
+}>) => FoundationElementRegistry<    {
+baseName: string;
+template: ViewTemplate<ColumnSelection, any>;
+styles: ElementStyles;
+}, typeof ColumnSelection>;
+
 /**
  *
  * @public
@@ -2613,6 +3235,13 @@ export declare function getAvailableIndexes(data: Map<string, string[]>): string
  */
 export declare function getAvailableIndexFields(data: Map<string, string[]>): string[];
 
+/**
+ * Column Selection button + popover with embedded picker UI.
+ * @param prefix - Design-system prefix for button/icon/checkbox/text-field.
+ * @public
+ */
+export declare const getColumnSelectionTemplate: (prefix?: string) => ViewTemplate<ColumnSelection, any>;
+
 /**
  * Return a column type base on each field's metadata from the selected resource.
  * @param metadataType - The type of the field/column
@@ -2679,6 +3308,9 @@ export declare const getMultiselectEditorTemplate: (designSystem?: string) => Vi
  */
 export declare const getNumberEditorTemplate: (designSystem?: string) => ViewTemplate<NumberEditor, any>;
 
+/** @public */
+export declare function getPickerItems(columns: Column[]): ColumnPickerItem[];
+
 /**
  * Get a Design System prefixed Select template.
  * @param designSystem - The design system prefix to use. Defaults to 'foundation'.
@@ -2725,6 +3357,11 @@ export declare const getTextFieldRendererTemplate: (designSystem?: string) => Vi
  */
 export declare const getTextRendererTemplate: (designSystem?: string) => ViewTemplate<AgTextFieldRenderer, any>;
 
+/** Context key on `gridOptions.context` for AG column drag integration.
+ * @public
+ */
+export declare const GRID_PRO_COLUMN_DRAG_BRIDGE_CONTEXT_KEY: "gridProColumnDragBridge";
+
 /**
  * Event fired when grid is ready
  * @public
@@ -2774,7 +3411,7 @@ export declare const GridOptionsConfig: InterfaceSymbol<GridOptionsConfig>;
  */
 export declare class GridPro extends GridPro_base {
     columnApi: ColumnApi;
-    gridApi: GridApi;
+    gridApi: GridApi_2;
     private cachedTotalColumnWidth;
     private columnCount;
     gridErrorItems: GridProErrorItem<GridProErrorEvent['detail']>[];
@@ -3686,7 +4323,7 @@ export declare class GridProBaseDatasource extends GenesisGridDatasourceElement
  * @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 GridProBeta extends GridProBeta_base {
-    gridApi: GridApi_2;
+    gridApi: GridApi;
     gridErrorItems: GridProErrorItem<GridProErrorEvent['detail']>[];
     statePersistence: StatePersistence;
     /**
@@ -3715,6 +4352,10 @@ export declare class GridProBeta extends GridProBeta_base {
      * 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.
      */
@@ -3741,7 +4382,7 @@ export declare class GridProBeta extends GridProBeta_base {
     headerHeight: number;
     rowHeight: number;
     classNames: string;
-    agGrid: GridApi_2;
+    agGrid: GridApi;
     gridSlot: HTMLSlotElement;
     /**
      * The slot ref binds asynchronously, and the queued `initGrid` skips any run that beats it. FAST
@@ -3773,6 +4414,12 @@ export declare class GridProBeta extends GridProBeta_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
@@ -3841,6 +4488,7 @@ export declare class GridProBeta extends GridProBeta_base {
     private readonly luminanceObserver;
     connectedCallback(): void;
     disconnectedCallback(): void;
+    private syncColumnSelectionHostLayout;
     private performDisconnectCleanup;
     private destroyGridInstance;
     /**
@@ -4175,7 +4823,7 @@ export declare class GridProBeta extends GridProBeta_base {
         resizable?: boolean;
         suppressSizeToFit?: boolean;
         suppressAutoSize?: boolean;
-        pivotValueColumn?: Column | Column_2<any>;
+        pivotValueColumn?: Column_2 | Column<any>;
         pivotTotalColumnIds?: string[];
         spanHeaderHeight?: boolean;
         headerName?: string;
@@ -5054,6 +5702,31 @@ declare const GridProColumn_base: (new (...args: any[]) => {
     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
  *
@@ -5063,6 +5736,18 @@ declare const GridProColumn_base: (new (...args: any[]) => {
  */
 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
@@ -7685,6 +8370,26 @@ export declare enum OperationType {
 /** The CSS class to use for the options element's class in the dropdown */
 export declare const optionsClass = "options";
 
+/**
+ * Column order for the picker list.
+ *
+ * - `selected-first` (default): displayed columns first, then non-displayed.
+ * - `ag-grid`: column-state order (visible/hidden interleaved).
+ * @public
+ */
+export declare function orderColumnsForPicker(displayed: Column[], all: Column[], sort?: ColumnPickerSort, columnState?: ReadonlyArray<{
+    colId?: string | null;
+}>): Column[];
+
+/**
+ * Splits / filters picker items for the template sections.
+ * @public
+ */
+export declare function partitionPickerItems(items: ColumnPickerItem[], search: string, sort?: ColumnPickerSort): {
+    selected: ColumnPickerItem[];
+    unselected: ColumnPickerItem[];
+};
+
 /**
  * Event detail for requesting an infinite row model refresh.
  * @remarks Mirrors {@link RefreshServerSideEventDetail}: `purge` drops the grid's block cache
@@ -7738,6 +8443,30 @@ export declare type ReloadStatusBarParams = {
     tooltip?: string;
 };
 
+/** @public */
+export declare function reorderVisibleIds(allVisibleIds: string[], shownIds: string[], fromId: string, toId: string): string[] | null;
+
+/** @public */
+export declare function resolveColumnDragBridge(context: unknown): GridProColumnDragBridge | null;
+
+/** @public */
+export declare function resolveColumnDragBridgeDirect(bridge?: GridProColumnDragBridge | null): GridProColumnDragBridge | null;
+
+/** @public */
+export declare function resolveColumnDragBridgeFromApi(api: {
+    getGridOption?: (key: string) => unknown;
+} | null | undefined): GridProColumnDragBridge | null;
+
+/** @public */
+export declare function resolveColumnPickerSort(sort?: ColumnPickerSort | null): ColumnPickerSort;
+
+/**
+ * Resolves an AG `gridApi` suitable for {@link ColumnSelection}.
+ * Classic Grid Pro (v29) exposes column helpers on `columnApi` — bridge when needed.
+ * @public
+ */
+export declare function resolveColumnsPickerApi(gridHost?: ColumnSelectionHost | null, gridApi?: GridApi | null): GridApi | null;
+
 /**
  * Resolves the field names of the currently visible columns.
  * @remarks Prefers the grid's displayed columns (`getAllDisplayedColumns()` — already excludes
@@ -8298,6 +9027,9 @@ export declare interface StringEditorParams extends ICellEditorParams {
     placeholder: string;
 }
 
+/** @internal Writes DnD beans onto the shared bridge object in grid context. */
+export declare function syncColumnDragBridge(beans: BridgeInitBeans | null | undefined): boolean;
+
 /**
  * The AG Text Field Renderer Styles.
  * @public
@@ -8310,6 +9042,9 @@ export declare const textFieldRendererStyles: ElementStyles;
  */
 export declare const textRendererStyles: ElementStyles;
 
+/** @public */
+export declare function toPickerItem(col: Column): ColumnPickerItem | null;
+
 /**
  * @public
  */