import type { ChartSeriesType } from "../models/seriesType/config.js";
import type { SeriesId } from "../models/seriesType/common.js";
import type { FocusedItemIdentifier } from "../models/seriesType/index.js";
/**
 * Registers a handler fired when the keyboard-focused item is activated with <kbd>Enter</kbd> or
 * <kbd>Space</kbd>. It is a no-op when the `keyboardActivation` experimental feature is off.
 *
 * Scope the registration as tightly as the caller knows: when several plots handle the same item,
 * the most specific scope wins, `priority` breaks ties, `canActivate` can decline an item, and the
 * handler runs once.
 *
 * The handler receives the `KeyboardEvent`, typed as `any` because the click callbacks it forwards
 * to only describe the pointer event unless the user augments `keyboardActivationOverride`.
 *
 * @param scope The items covered by the handler. Omit `seriesId` to cover a whole series type.
 * @param handler The handler to call on activation, or `undefined` to register nothing.
 */
export declare function useRegisterItemActivation<SeriesType extends ChartSeriesType = ChartSeriesType>(scope: {
  type?: SeriesType;
  seriesId?: SeriesId;
  priority?: number;
  canActivate?: (item: FocusedItemIdentifier<SeriesType>) => boolean;
}, handler: ((event: any, item: FocusedItemIdentifier<SeriesType>) => void) | undefined): void;