import type { SeriesChart } from "./series";
import { type SeriesChartRecord } from "./series-build";
/**
 * Unified accessor for the currently hovered glyph. Returns either the
 * real {@link SeriesChartRecord} from `_bars` (bar / stacked-area hits) or the
 * synthetic one stored in `_hoveredSample` (line / scatter / non-stacked
 * area hits), or `null`.
 */
export declare function getHoveredBar(chart: SeriesChart): SeriesChartRecord | null;
/**
 * Handle mouse-move across all glyph types. Tests (in reverse paint order
 * so top glyphs win): scatter points → line points → bars → areas.
 * Updates `_hoveredBarIdx` or `_hoveredSample` and re-renders on change.
 */
export declare function handleBarHover(chart: SeriesChart, mx: number, my: number): void;
/**
 * Handle a click on the legend area. Returns true when the click hit a
 * legend entry (the caller should then treat the event as consumed).
 */
export declare function handleBarLegendClick(chart: SeriesChart, mx: number, my: number): boolean;
/**
 * Build the per-bar tooltip content lines.
 */
export declare function buildBarTooltipLines(chart: SeriesChart, b: SeriesChartRecord): string[];
/**
 * Format the hierarchical path label for a given category index. Used by
 * the tooltip — the axis uses per-level text directly instead.
 */
export declare function formatBarCategoryPath(chart: SeriesChart, catIdx: number): string;
export declare function showBarPinnedTooltip(chart: SeriesChart, barIdx: number): void;
/**
 * Pin a tooltip against a synthetic BarRecord (scatter/line/area hit).
 */
export declare function showBarPinnedTooltipForSample(chart: SeriesChart, bar: SeriesChartRecord): void;
export declare function dismissBarPinnedTooltip(chart: SeriesChart): void;