import type { AddressLevel, Region, RegionProvider } from './types.js'; /** * Replaces the provider for a country. From `bootstrap.ts` only: throws after * `lockAddressRegistry()`. A provider that replaces a list wholesale must * carry the old keys as retired entries (append-only rule). */ export declare function registerRegionProvider(country: string, provider: RegionProvider): void; export declare function getRegionProvider(country: string): RegionProvider; /** The levels a country enumerates, outermost first. Empty = all free text. */ export declare function getRegionLevels(country: string): AddressLevel[]; /** * Active regions under `parentPath` (keys of the outer levels; `[]` is the top * level). Retired entries are filtered out: this is what forms and admin * pickers offer. Returns copies, so callers may annotate them freely. */ export declare function getRegions(country: string, parentPath: string[], locale?: string): Promise; /** The name to show a reader in `locale` for a region already in hand (see `displayName`). */ export declare function regionDisplayName(region: Region, country: string, locale?: string): string; /** * Display name for a stored key. Retired entries are included (a legacy order * must still name its province); falls back to the key itself when the level * is free text, the parents are missing for a deeper level, or nothing * matches. `locale` (default: the runtime's) picks `name` or `latinName`, * see `displayName`. */ export declare function resolveRegionName(country: string, level: AddressLevel, key: string, locale?: string, parentPath?: string[]): Promise; /** True when `key` is an active (not retired) entry at `level` for the parents. */ export declare function isActiveRegionKey(country: string, level: AddressLevel, key: string, parentPath?: string[]): Promise; export declare function __resetRegionProvidersForTests(): void;