/**
 * @copyright Sister Software
 * @license AGPL-3.0
 * @author Teffen Ellis, et al.
 *
 *   `usgov-nad`: US DOT National Address Database — ~97M structured address-point records.
 *
 *   The single largest US address source available — federal aggregation of state + local 911-grade
 *   address points (every addressable location). Compared to TIGER ADDRFEAT (~20M segment-level, no
 *   city/locality) and NPPES (~7M provider-centric venues), NAD covers the entire residential +
 *   commercial address space with full structured components.
 *
 *   The adapter consumes NDJSON shards produced by `fetch-nad.ts`'s featureserver mode (operator
 *   pre-downloads via `mailwoman corpus fetch nad`). Each shard is per-OID-range
 *   `oids_<start>-<end>.ndjson` with a sibling `.manifest.json`. Adapter iterates every `.ndjson`
 *   in the input directory, skipping the `quarantined-bash-bug/` subdir (legacy of the bash-
 *   fetcher's silent-page-failure bug).
 *
 *   Field mapping (NAD v9 → CanonicalRow components):
 *
 *   - House_number: `AddNo_Full` (pre-composed); falls back to AddNum_Pre + Add_Number + AddNum_Suf
 *   - Street: `StNam_Full` (pre-composed); falls back to St_PreDir + St_PreTyp + St_Name + St_PosTyp
 *
 *       - St_PosDir + St_PosMod composition
 *   - Locality: `Post_City` > `Inc_Muni` > `Census_Plc` > `Uninc_Comm` (first non-empty)
 *   - Region: `State` (2-char USPS code, including territories: PR, GU, VI, AS, MP)
 *   - Postcode: `Zip_Code` + `Plus_4` (joined as `XXXXX-NNNN` when both present)
 *   - Venue: `LandmkName` (typically a park, school, hospital, named facility — when present)
 *
 *   License: stamped `"Public Domain"` per 17 U.S.C. § 105 (US federal works).
 */
import type { CorpusAdapter } from "@mailwoman/corpus/types";
/**
 * Registry id for this adapter. Stamped into every row it emits, so a corpus record can be traced back to the dataset
 * it came from.
 */
export declare const USGOV_NAD_ADAPTER_ID = "usgov-nad";
/**
 * License carried by this source (Public Domain), attached to each row so downstream consumers inherit the terms rather
 * than having to look them up.
 */
export declare const USGOV_NAD_DEFAULT_LICENSE = "Public Domain";
export declare function createUsgovNADAdapter(): CorpusAdapter;
/**
 * The configured adapter instance registered with the corpus builder.
 */
export declare const usgovNADAdapter: CorpusAdapter;
//# sourceMappingURL=adapter.d.ts.map