import type { MapApi } from "../core/types";
import type { MapAnnotationDescriptor } from "./mapAnnotations";
/**
 * Registers a map annotation to be rendered in the Controls overlay.
 *
 * Pass a descriptor to register, or `null` to unregister.
 * Automatically cleans up on unmount.
 *
 * Same-id rerenders are stable: passing an inline descriptor with identical
 * content (id, label, priority, etc.) will not cause unregister/register churn,
 * avoiding reordering and enter/exit animation retriggers.
 *
 * @param api - The map API object from `useMap`
 * @param descriptor - Annotation descriptor to register, or `null` to unregister
 */
export declare const useMapAnnotation: (api: MapApi, descriptor: MapAnnotationDescriptor | null) => void;