import type { Ref } from '@stacksjs/stx';
/**
 * Reactive geolocation.
 * Tracks the user's geographic position using the Geolocation API.
 *
 * @param options - PositionOptions plus an immediate flag (default: true)
 * @returns Reactive coords, location timestamp, error, support status, and pause/resume controls
 */
export declare function useGeolocation(options?: PositionOptions & { immediate?: boolean }): UseGeolocationReturn;
export declare interface UseGeolocationCoords {
  latitude: Ref<number | null>
  longitude: Ref<number | null>
  accuracy: Ref<number | null>
  altitude: Ref<number | null>
  altitudeAccuracy: Ref<number | null>
  heading: Ref<number | null>
  speed: Ref<number | null>
}
export declare interface UseGeolocationReturn {
  coords: UseGeolocationCoords
  locatedAt: Ref<number | null>
  error: Ref<GeolocationPositionError | null>
  isSupported: Ref<boolean>
  pause: () => void
  resume: () => void
}