/** Options for {@link formatDuration}. */
export interface DurationFormat {
    /** Fractional-second digits to show (0, 1, or 2). Defaults to 0. */
    decimals?: 0 | 1 | 2;
    /** Force an `h:mm:ss` layout even under an hour. Defaults to auto (hours shown only when present). */
    hours?: boolean;
}
/** Left-pad a non-negative integer to `width` digits with leading zeros. */
export declare function padNumber(value: number, width: number): string;
/**
 * Format a duration in seconds as a clock string (`m:ss`, `m:ss.ff`, or `h:mm:ss`), the shape every timer and racing HUD needs.
 *
 * @capability clock-format render seconds as m:ss / m:ss.ff / h:mm:ss for timers and race HUDs
 */
export declare function formatDuration(seconds: number, options?: DurationFormat): string;
/**
 * Format a signed time gap as `+m:ss.ff` / `-m:ss.ff`, for race deltas and split times.
 *
 * @capability clock-format format a signed time gap like a race split (+/- m:ss.ff)
 */
export declare function formatDelta(seconds: number, decimals?: 0 | 1 | 2): string;
/**
 * English ordinal for a placement number: 1 → "1st", 2 → "2nd", 3 → "3rd", 11 → "11th".
 *
 * @capability ordinal-format format a placement number as 1st/2nd/3rd for HUD ranks
 */
export declare function formatOrdinal(value: number): string;