import { type GeolocationContextValue } from "@trackunit/react-core-contexts-api";
type UseGeolocationOptions = Readonly<{
    requestOnMount?: boolean;
}>;
/**
 * Hook providing geolocation capabilities.
 *
 * In the host, geolocation is resolved directly via the browser API.
 * In Iris Apps, requests are proxied to the host via the iframe bridge,
 * so permission is only requested once at the host level.
 *
 * @example
 * ```ts
 * const { position, getPosition } = useGeolocation();
 *
 * // User-initiated request (e.g. "My Location" button)
 * onClick: () => {
 *   void getPosition().then(pos => { if (pos) fitBounds(pos); });
 * }
 * ```
 */
export declare const useGeolocation: (options?: UseGeolocationOptions) => GeolocationContextValue;
export {};