import { CallbackDataParams } from 'echarts/types/dist/shared';
import { EchartsEventHandler } from './echart-ui';
export type SelectionKey = string | number;
export interface UseChartSelectionOptions<K extends SelectionKey> {
    /** Controlled selection. `undefined` is treated the same as `[]`. */
    selection?: readonly K[];
    /** Receives the next selection. When omitted the wiring is a no-op. */
    onSelectionChange?: (next: readonly K[]) => void;
    /**
     * Pull a selection key out of an ECharts `click` event. Return `null` to
     * skip (e.g. a click on empty plot area). For Bar/Pie/Timeseries this is
     * usually `(p) => p.name`; for Histogram/Scatterplot it's the dataIndex.
     */
    keyFromClick: (params: CallbackDataParams) => K | null;
    /**
     * Map a `brushSelected` payload's `selected[*]` entries (each carrying a
     * `seriesIndex` + `dataIndex[]`) into the full set of selection keys for
     * the brushed area. Called once per brush event.
     */
    keysFromBrush: (selected: readonly {
        seriesIndex: number;
        dataIndex: number[];
    }[]) => K[];
}
export interface ChartSelectionWiring<K extends SelectionKey> {
    /**
     * Pass straight to `<Widget.Echart onEvents={…}>`. Wires `click` and
     * `brushSelected` so the user's interactions reach `onSelectionChange`.
     */
    onEvents: Record<string, EchartsEventHandler>;
    /**
     * The current selection — `null` when the consumer didn't pass one or it's
     * empty. Mergers should treat `null` as "no dimming" and a non-null array
     * as "render only these as fully opaque, dim the rest".
     */
    selection: readonly K[] | null;
}
/**
 * Translate ECharts' click + brush events into a consumer-owned selection
 * with the expected dashboard semantics:
 *
 *   - **Click toggles** — clicking an item adds it to the selection if
 *     absent, removes it if present.
 *   - **Brush replaces** — finishing a brush stroke overwrites the selection
 *     with whatever the brush covered (drag-to-empty clears).
 *
 * Wire the returned `onEvents` into `<Widget.Echart>` and feed
 * `wiring.selection` to the widget's option factory so the merger can dim
 * non-selected rows at fusion time.
 */
export declare function useChartSelection<K extends SelectionKey>({ selection, onSelectionChange, keyFromClick, keysFromBrush, }: UseChartSelectionOptions<K>): ChartSelectionWiring<K>;