/**
 * The countries whose first-level subdivision the SDK knows by name, and so
 * renders as a required select instead of free text. This list is the single
 * source for every place that asks the question — the Drop-in address section,
 * the Elements state field and the validation schema — so a fourth country is
 * added here and nowhere else.
 */
export type StateCountry = 'US' | 'CA' | 'AU';
export declare const STATE_COUNTRIES: ReadonlySet<string>;
/**
 * Whether a country code has a subdivision list the SDK can render.
 */
export declare const isStateCountry: (country: string | undefined) => country is StateCountry;
/**
 * Narrows a country code to one with a subdivision list. An unknown code
 * answers `US`, which keeps a caller that already decided to render a select
 * from rendering an empty one.
 */
export declare const toStateCountry: (country: string | undefined) => StateCountry;
/**
 * The translation key of the placeholder a country's select shows. Australian
 * subdivisions are states and territories, so Australia shares the American
 * key rather than the Canadian one.
 */
export declare const getStatePlaceholderKey: (country: StateCountry) => string;
/**
 * Get all region codes for a country
 */
export declare const getAllStateCodes: (country?: StateCountry) => string[];
/**
 * Get human-readable region name from code
 */
export declare const getStateName: (stateCode: string, country?: StateCountry) => string;
/**
 * Get state/province options for dropdown
 * @param country Country code ('US', 'CA' or 'AU'). Defaults to 'US'.
 * @returns Array of options with value (code) and text (name)
 */
export declare const getStateOptions: (country?: StateCountry) => Array<{
    value: string;
    text: string;
}>;
//# sourceMappingURL=stateNames.d.ts.map