import React from 'react';
import { type DeviceLocationReading, type DeviceLocationStatus } from '../map/use-device-location';
import type { MapOverlayPosition } from '../map/map.types';
export interface MapLocateControlProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onError'> {
    onLocate: (position: DeviceLocationReading['position'], meta: DeviceLocationReading) => void;
    /** Called on every failure, with the reason already classified. */
    onError?: (status: DeviceLocationStatus, message: string | null) => void;
    /** @default "Use my location" */
    label?: string;
    /** @default "Location permission denied" */
    deniedLabel?: string;
    /** @default 'overlay' */
    variant?: 'overlay' | 'inline';
    /** @default 'bottom-right' */
    position?: MapOverlayPosition;
    enableHighAccuracy?: boolean;
}
/**
 * Centres the map on the device's position.
 *
 * @description
 * Reports the reading plus its accuracy so the caller can draw the precision
 * halo, and classifies failures instead of swallowing them — a denied
 * permission is a different message from a timeout, and only one of them is
 * worth a retry button.
 *
 * @ai-rules
 * 1. Feed the result into `<Map deviceLocation>` so the accuracy halo is drawn.
 * 2. Handle `onError` — a silent failure leaves the user tapping a dead button.
 * 3. Never treat `mocked === false` as proof the coordinate is genuine.
 */
export declare const MapLocateControl: React.ForwardRefExoticComponent<MapLocateControlProps & React.RefAttributes<HTMLDivElement>>;