import type { MapApi } from "../core/types";
import type { MapAnnotationDescriptor } from "./mapAnnotations";
/**
 * Registers a list of map annotations to be rendered in the Controls overlay.
 *
 * Syncs the reactive `descriptors` list to the annotation store: newly added
 * descriptors are registered, removed ones are unregistered on each render.
 * Automatically cleans up all registrations on unmount.
 *
 * Stable on re-render with identical content: passing a new array reference
 * with descriptors whose id/label/priority/color fields are unchanged does not
 * cause unregister/register churn.
 *
 * @param api - The map API object from `useMap`
 * @param descriptors - Array of annotation descriptors to sync
 */
export declare const useMapAnnotations: (api: MapApi, descriptors: ReadonlyArray<MapAnnotationDescriptor>) => void;