import type { ColumnConfiguration } from 'apex-grid';
import type { ColumnMenuProvider, GridFeatureModule, GridHost } from 'apex-grid/internal';
import type { ReactiveController } from 'lit';
export declare const CONTEXT_MENU_MODULE_ID = "context-menu";
/** Fired on the grid before a context menu opens; cancellable, with a mutable `items` array. */
export declare const CONTEXT_MENU_OPENING_EVENT = "apex-context-menu-opening";
/** Declarative config for the context menu (alternative to the boolean toggle). */
export interface ContextMenuConfig<T extends object = any> {
    /** Replace the default items: a static array or a per-target callback. */
    items?: ContextMenuItem<T>[] | ((target: ContextMenuTarget<T>) => ContextMenuItem<T>[]);
}
/** Detail of {@link CONTEXT_MENU_OPENING_EVENT}: mutate `items` (or `preventDefault()`) to customize. */
export interface ContextMenuOpeningDetail<T extends object = any> {
    readonly target: ContextMenuTarget<T>;
    items: ContextMenuItem<T>[];
}
/** What was right-clicked: a body cell (with its row) or a column header. */
export interface ContextMenuTarget<T extends object> {
    readonly kind: 'cell' | 'header';
    readonly column: ColumnConfiguration<T>;
    /** The row record (cell targets only). */
    readonly row?: T;
    /** Row index within `pageItems` (cell targets only). */
    readonly rowIndex?: number;
}
/** A single context-menu entry. Provide `submenu` for a nested menu, or `run` for a leaf. */
export interface ContextMenuItem<T extends object = any> {
    id: string;
    label: string;
    run?: (target: ContextMenuTarget<T>) => void;
    disabled?: boolean;
    submenu?: ContextMenuItem<T>[];
    /** Render a divider before this item. */
    separatorBefore?: boolean;
}
/**
 * Enterprise feature: a right-click **context menu** on cells and headers. Listens for `contextmenu`
 * (and Shift+F10 / the Menu key) on the grid host, resolves the target column/row from the event's
 * `composedPath()`, and shows a keyboard-navigable menu portaled to `document.body`.
 *
 * Default items: sort asc/desc/clear, pin start/end/unpin, hide column, and copy (cells). Override
 * via {@link items}. Opt in with `ApexGridEnterprise.use(contextMenuModule)` (the `/define` entry
 * includes it).
 */
export declare class ContextMenuController<T extends object> implements ReactiveController, ColumnMenuProvider {
    #private;
    private host;
    /** When `false`, the feature is inert. */
    enabled: boolean;
    /** Replace the default items: a static array or a per-target callback. `null` = defaults. */
    items: ContextMenuItem<T>[] | ((target: ContextMenuTarget<T>) => ContextMenuItem<T>[]) | null;
    constructor(host: GridHost<T>);
    hostConnected(): void;
    hostDisconnected(): void;
    /**
     * {@link ColumnMenuProvider}: tell the core header to show its kebab button
     * (on every column, not just sortable / resizable ones) whenever the context
     * menu is enabled, since the kebab opens this shared menu.
     */
    providesColumnMenu(): boolean;
    /** The built-in items for a target. Exposed so a custom `items` callback can extend them. */
    defaultItems(target: ContextMenuTarget<T>): ContextMenuItem<T>[];
}
/** Feature module registered on the enterprise grid. */
export declare const contextMenuModule: GridFeatureModule;