import React from 'react';
import type { MapOverlayPosition } from '../map/map.types';
export interface MapOverlayProps extends React.HTMLAttributes<HTMLDivElement> {
    /** @default 'top-right' */
    position?: MapOverlayPosition;
    /** Raises this overlay above the others. Defaults to the shared chrome layer. */
    zIndex?: number;
    children: React.ReactNode;
}
/**
 * Anchors React content over the map surface.
 *
 * @description
 * Nine anchors on one consistent stacking layer. Every surveyed application
 * recreated this positioning by hand and settled its `z-index` by guesswork,
 * which is how a legend ends up underneath a notice on one screen and above it
 * on the next.
 *
 * `<Map>` accepts `children`, so overlays are declared inside it and inherit its
 * positioned container automatically — no wrapper needed.
 *
 * @ai-rules
 * 1. Place these as children of `<Map>`; that is what makes the anchoring work.
 * 2. One overlay per anchor. Two at the same position will sit on top of each other.
 * 3. Keep overlays small — they cover the map they annotate.
 */
export declare const MapOverlay: React.ForwardRefExoticComponent<MapOverlayProps & React.RefAttributes<HTMLDivElement>>;