/**
 * Comprehensive country dataset based on ISO 3166-1 alpha-2.
 *
 * Sources:
 *  - Country codes & names: ISO 3166-1
 *  - Currencies: ISO 4217
 *  - Timezones: IANA Time Zone Database
 *  - Calling codes: ITU-T E.164
 *  - Regions: UN M49 geoscheme (simplified to 5 macro regions)
 */
export interface CountryData {
    /** ISO 3166-1 alpha-2 code */
    code: string;
    /** English name */
    name: string;
    /** Emoji flag */
    flag: string;
    /** Default ISO 4217 currency code */
    currency: string;
    /** Currency symbol */
    currencySymbol: string;
    /** Primary IANA timezone */
    timezone: string;
    /** International calling code */
    callingCode: string;
    /** Geographic region */
    region: 'Africa' | 'Americas' | 'Asia' | 'Europe' | 'Oceania';
}
/**
 * All ISO 3166-1 alpha-2 countries.
 *
 * The most significant countries are listed first (US, GB, IN, DE, FR, JP,
 * CN, AU, CA, BR, ...) followed by every remaining country sorted
 * alphabetically by its two-letter code.
 */
export declare const COUNTRIES: CountryData[];
/** Map of country code to CountryData for O(1) lookup */
export declare const COUNTRY_MAP: Record<string, CountryData>;
/** Get country by ISO 3166-1 alpha-2 code */
export declare function getCountryByCode(code: string): CountryData | undefined;
/** Get all countries belonging to a geographic region */
export declare function getCountriesByRegion(region: CountryData['region']): CountryData[];
/** All available regions */
export declare const REGIONS: CountryData['region'][];
/**
 * Map from common IANA timezones to ISO 3166-1 alpha-2 country codes.
 *
 * Useful for reverse geo-detection: detect the browser timezone via
 * `Intl.DateTimeFormat().resolvedOptions().timeZone` then look up the likely
 * country.
 */
export declare const TIMEZONE_TO_COUNTRY: Record<string, string>;
//# sourceMappingURL=countries.d.ts.map