/**
 * @copyright Sister Software
 * @license AGPL-3.0
 * @author Teffen Ellis, et al.
 * @file Deterministic canonical-row emission shared by WOF GeoJSON adapters.
 */
import type { ComponentTag } from "@mailwoman/codex/component";
import type { AdapterOptions, CanonicalRow } from "#types";
import { type WOFRecord } from "#utils";
/**
 * Display name for the country, keyed by ISO 3166-1 alpha-2.
 *
 * Must be the **OpenCage-canonical** surface form: the `address-formatter` library expands some country names en route
 * to its output (e.g. `"United States"` → `"United States of America"`). If `components.country` and the formatted
 * `raw` disagree, alignment will fail downstream. Keying off the canonical form keeps the two in lockstep.
 *
 * Phase 1 US + FR only; extend as new locales come online. Missing countries fall back to the country row's `wof:name`,
 * accepting the alignment risk for non-canonicalized names.
 */
export declare const COUNTRY_DISPLAY_NAME: Record<string, string>;
/**
 * BCP-47 locale defaulting for the corpus row's `locale` field. Defaulted by country.
 */
export declare const LOCALE_BY_COUNTRY: Record<string, string>;
export interface WOFVariantSpec {
    suffix: string;
    components: Partial<Record<ComponentTag, string>>;
    /**
     * Render this variant as an ADMIN HIERARCHY rather than as a postal address.
     *
     * A hierarchy variant is a query — `Paris`, then `Paris, Île-de-France`, then `Paris, Île-de-France, France` — and
     * several of its steps are not addresses at all. France's postal layout carries no region, so rendering `{ locality,
     * region }` through it prints `Paris` and the whole variant collapses into the one below it.
     *
     * So the hierarchy is joined in its own order: smallest unit first, or largest first for the systems that write that
     * way, with the country's own separator.
     */
    hierarchy?: boolean;
}
export interface NameSlotOptions {
    /**
     * Canonical surface for the record's own `"default"` slot. Default `rec.name` verbatim; the admin adapter substitutes
     * the OpenCage-canonical {@link COUNTRY_DISPLAY_NAME} for country records.
     */
    canonicalName?: (rec: WOFRecord) => string;
}
/**
 * Build the per-record name-slot list: the canonical `"default"` slot, then every `name:*` variant deduplicated against
 * it so a redundant `"default"`-equivalent row is not emitted under a localized key.
 */
export declare function nameSlotsFor(rec: WOFRecord, options?: NameSlotOptions): Array<{
    key: string;
    value: string;
}>;
interface EmitWOFJSONRowsOptions {
    records: ReadonlyMap<number, WOFRecord>;
    ancestry: ReadonlyMap<number, WOFRecord[]>;
    adapterOptions: AdapterOptions;
    adapterID: string;
    localeByCountry: Readonly<Record<string, string>>;
    shouldEmit?: (record: WOFRecord) => boolean;
    nameSlotsFor: (record: WOFRecord) => Array<{
        key: string;
        value: string;
    }>;
    variantsFor: (record: WOFRecord, ancestry: WOFRecord[], selfName: string) => WOFVariantSpec[];
}
/**
 * Emit aligned rows in WOF-id order, enforcing the adapter limit across all name and hierarchy variants.
 */
export declare function emitWOFJSONRows(options: EmitWOFJSONRowsOptions): Generator<CanonicalRow>;
export {};
//# sourceMappingURL=json-rows.d.ts.map