/**
 * U.S. state and territory lookups.
 *
 * APIs disagree on how a state is written: USPS codes ("MD"), full names
 * ("Maryland"), or FIPS codes ("24"). These helpers accept any of the three
 * so tools can normalize input before calling an API.
 */
/** A U.S. state, the District of Columbia, or a territory. */
export interface UsState {
    /** Two-letter USPS code, e.g. "MD". */
    usps: string;
    /** Two-digit FIPS code, e.g. "24". */
    fips: string;
    /** Full name, e.g. "Maryland". */
    name: string;
}
/** States, DC, and territories (FIPS per ANSI INCITS 38). */
export declare const US_STATES: readonly UsState[];
/** Find a state by USPS code, full name, or FIPS code (case-insensitive). */
export declare function findState(input: string | number | undefined | null): UsState | undefined;
/**
 * Resolve a state or throw an error the model can act on.
 * @param param - parameter name used in the error message
 */
export declare function resolveState(input: string | number, param?: string): UsState;
/**
 * A state in the form an API expects, from a name, USPS code or FIPS code.
 * Values that aren't a state (e.g. "United States", which some datasets
 * use for national rows) pass through trimmed but otherwise unchanged.
 */
export declare function stateAs(input: string | number, form: keyof UsState): string;
//# sourceMappingURL=geo.d.ts.map