/** Target unit for {@link formatDistance}: meters, kilometers, or `"auto"` (km past 1000m). */
export type DistanceUnit = "m" | "km" | "auto";
/** Options for {@link formatDistance}. */
export interface DistanceFormat {
    /** Target unit. `"auto"` switches to km at 1000m and above. Defaults to `"m"`. */
    unit?: DistanceUnit;
    /** Fractional digits to show. Defaults to 0 for meters, 1 for kilometers. */
    decimals?: 0 | 1 | 2;
    /** Append the unit label. Defaults to true; set false to compose custom unit styling. */
    showUnit?: boolean;
}
/**
 * Format a distance given in meters as a HUD-ready string, switching to km automatically past 1000m when `unit: "auto"`.
 *
 * @capability distance-format render meters as m or km for HUD stats, telemetry, and range readouts
 */
export declare function formatDistance(meters: number, options?: DistanceFormat): string;