/**
 * Custom country code mappings for ISO 3166-1 standard
 * Replaces i18n-iso-countries dependency with self-contained implementation
 */
/**
 * Convert ISO 3166-1 alpha-2 country code to alpha-3 format
 *
 * @param alpha2 - Two-letter country code (e.g., 'US', 'GB', 'AU')
 * @returns Three-letter country code (e.g., 'USA', 'GBR', 'AUS') or undefined if not found
 *
 * @example
 * alpha2ToAlpha3('US') // 'USA'
 * alpha2ToAlpha3('GB') // 'GBR'
 * alpha2ToAlpha3('XX') // undefined
 */
export declare function alpha2ToAlpha3(alpha2: string): string | undefined;
/**
 * Convert ISO 3166-1 alpha-3 country code to alpha-2 format
 *
 * @param alpha3 - Three-letter country code (e.g., 'USA', 'GBR', 'AUS')
 * @returns Two-letter country code (e.g., 'US', 'GB', 'AU') or undefined if not found
 *
 * @example
 * alpha3ToAlpha2('USA') // 'US'
 * alpha3ToAlpha2('GBR') // 'GB'
 * alpha3ToAlpha2('XXX') // undefined
 */
export declare function alpha3ToAlpha2(alpha3: string): string | undefined;
/**
 * Get the official country name for a given alpha-2 code
 *
 * @param alpha2 - Two-letter country code (e.g., 'US', 'GB', 'AU')
 * @returns Country name or undefined if not found
 *
 * @example
 * getCountryName('US') // 'United States of America'
 * getCountryName('GB') // 'United Kingdom'
 * getCountryName('XX') // undefined
 */
export declare function getCountryName(alpha2: string): string | undefined;
/**
 * Check if a country code is valid (alpha-2 format)
 *
 * @param code - Country code to validate
 * @returns true if the code is a valid alpha-2 country code
 *
 * @example
 * isValidCountryCode('US') // true
 * isValidCountryCode('XX') // false
 */
export declare function isValidCountryCode(code: string): boolean;
/**
 * Get all country names mapped by alpha-2 code
 * Compatible with i18n-iso-countries getNames() API
 *
 * @returns Object mapping alpha-2 codes to country names
 *
 * @example
 * const names = getNames();
 * names['US'] // 'United States of America'
 * names['GB'] // 'United Kingdom'
 */
export declare function getNames(): Record<string, string>;
/**
 * Get all country codes (alpha-2)
 *
 * @returns Array of all supported alpha-2 country codes
 */
export declare function getAllCountryCodes(): string[];