import { type FlagUrlOptions } from './flag-urls';
import type { Country, CountryCode, CountryListOptions, CountrySearchOptions, CountrySelectOption } from './types';
/**
 * Type guard for assigned ISO 3166-1 alpha-2 codes.
 */
export declare const isValidCountryCode: (code: string) => code is CountryCode;
/**
 * Returns the ISO 3166-1 English short name for an alpha-2 code.
 */
export declare const getCountryName: (code: string) => string | undefined;
/**
 * Returns the everyday English name for an alpha-2 code.
 */
export declare const getCountryCommonName: (code: string) => string | undefined;
/**
 * Returns complete country information for an ISO 3166-1 alpha-2 code.
 */
export declare const getCountryByCode: (code: string) => Country | undefined;
/**
 * Returns complete country information for an ISO 3166-1 alpha-3 code.
 */
export declare const getCountryByAlpha3: (alpha3: string) => Country | undefined;
/**
 * Returns complete country information for an ISO 3166-1 numeric / UN M49 code.
 * Accepts `"840"`, `"084"`, or `"84"`.
 */
export declare const getCountryByNumeric: (numeric: string) => Country | undefined;
/**
 * Looks up a country by alpha-2, alpha-3, or numeric code.
 */
export declare const getCountry: (id: string) => Country | undefined;
/**
 * Returns the ITU-T E.164 country calling code (for NANP this is always `+1`).
 */
export declare const getCallingCode: (code: string) => string | undefined;
/**
 * Returns the practical international prefix for phone inputs.
 * NANP territories include the primary area code (e.g. Anguilla `+1264`).
 */
export declare const getDialCode: (code: string) => string | undefined;
/**
 * Returns the ISO 3166-1 alpha-3 code for an alpha-2 code.
 */
export declare const getAlpha3Code: (code: string) => string | undefined;
/**
 * Returns the ISO 3166-1 numeric code for an alpha-2 code.
 */
export declare const getNumericCode: (code: string) => string | undefined;
/**
 * Returns the flag emoji for an assigned ISO 3166-1 alpha-2 code.
 */
export declare const getCountryFlag: (code: string) => string | undefined;
/**
 * CDN URL for the Wikipedia/Wikimedia SVG flag (flag-icons, MIT).
 */
export declare const getFlagSvgUrl: (code: string, options?: FlagUrlOptions) => string | undefined;
/**
 * Returns assigned ISO 3166-1 countries, optionally filtered and sorted.
 */
export declare function getAllCountries(): Country[];
export declare function getAllCountries(options: CountryListOptions): Country[];
export declare const getIndependentCountries: () => Country[];
export declare const getCountryTld: (code: string) => string | null | undefined;
export declare const getCountryCapital: (code: string) => string | null | undefined;
export declare const getCountryCurrencies: (code: string) => readonly string[] | undefined;
/**
 * Looks up a country by IANA country-code TLD (`".uk"`, `"uk"`, or `".UK"`).
 * The United Kingdom is `.uk`, not `.gb`.
 */
export declare const getCountryByTld: (tld: string) => Country | undefined;
/**
 * Countries that use an ISO 4217 alphabetic currency code.
 */
export declare const getCountriesByCurrency: (currency: string) => Country[];
export declare const listCurrencies: () => string[];
/**
 * Ready-made `<select>` options: flag emoji, common name, and dial prefix.
 */
export declare const getCountrySelectOptions: (options?: CountryListOptions) => CountrySelectOption[];
/**
 * Searches countries by official name, common name, aliases, and optionally codes.
 * Results are ranked so exact code / name matches appear first.
 */
export declare const searchCountries: (query?: string | null, options?: CountrySearchOptions) => Country[];
/**
 * Validates the format of an ITU-T E.164 country calling code (`+` plus 1–3 digits).
 * This does not check whether the code is assigned; use {@link getCountriesByCallingCode}.
 */
export declare const isValidCallingCode: (callingCode: string) => boolean;
/**
 * Finds countries that use an E.164 country calling code.
 * NANP lookups accept both `+1` and a composite such as `+1264` (Anguilla).
 */
export declare const getCountriesByCallingCode: (callingCode: string) => Country[];
export declare function getCountriesByRegion(): Record<string, Country[]>;
export declare function getCountriesByRegion(region: string): Country[];
export declare function getCountriesBySubregion(subregion: string): Country[];
export declare const listRegions: () => string[];
export declare const listSubregions: () => string[];