@mailwoman/codex 9.0.0 → 9.1.0

package/out/us/street-suffix.d.ts

@@ -5,231 +5,245 @@
  *
  *   USPS Publication 28, Appendix C — Postal Service Standard Suffix Abbreviations.
  *
- *   For each canonical suffix the value lists every recognized variant in USPS-published order; the
- *   first variant is the preferred USPS abbreviation (e.g. `AVENUE → ["AVE", "AV", "AVEN", "AVENU",
- *   "AVN", "AVNUE"]` — `AVE` is what the post office prints).
+ *   The DATA lives in `./street-suffix.json` so non-TS consumers (the Python training loader's
+ *   lexicon builder, audits) read the identical record — no hand-mirrored copies. Two keys:
  *
- *   This module is the single home for the USPS suffix table. It carries both the synthesis-layer
- *   helpers (`US_STREET_SUFFIX_PREFERRED_ABBR`, `matchCase`, `matchTrailingSuffix` — used by
- *   `@mailwoman/corpus`) and the richer branded-type lookup (`StreetSuffix`, `lookupStreetSuffix`,
- *   `isStreetSuffix`) The data is verbatim USPS Pub-28; the two APIs share one underlying record.
+ *   - `variants` — verbatim USPS Pub-28: canonical suffix → every recognized variant in
+ *     USPS-published order; the first variant is the preferred USPS abbreviation (e.g.
+ *     `AVENUE → ["AVE", ...]` — `AVE` is what the post office prints).
+ *   - `nameProneCanonicals` — OUR curation, not Pub-28: canonicals also observed as ordinary
+ *     proper-name heads in street names (PARK, HILL, CREEK…), from golden v0.1.3 + the OA street
+ *     pool. Shared by the golden relabel flags, the #1569 shard recipe, and (via the
+ *     `gazetteer affix-relabel` v2 lexicon) the Python relabel pass, so the instrument and the
+ *     training feed cannot drift onto different definitions of the ambiguous class.
+ *
+ *   This module remains the single TS home for the table: the synthesis-layer helpers
+ *   (`US_STREET_SUFFIX_PREFERRED_ABBR`, `matchCase`, `matchTrailingSuffix` — used by
+ *   `@mailwoman/corpus`) and the richer branded-type lookup (`StreetSuffix`,
+ *   `lookupStreetSuffix`, `isStreetSuffix`) share the one underlying JSON record.
  * @see {@link https://pe.usps.com/text/pub28/28apc_002.htm USPS Street Suffix Abbreviations}
  */
 /**
  * Canonical USPS street suffix → list of recognized variants. The first variant in each list is the preferred USPS
- * abbreviation. Keys + values are uppercase per the publication.
+ * abbreviation. Keys + values are uppercase per the publication. Data: `./street-suffix.json`.
  */
 export declare const US_STREET_SUFFIX_VARIANTS: {
-    readonly ALLEY: readonly ["ALY", "ALLEE", "ALLY"];
-    readonly ANEX: readonly ["ANX", "ANNEX", "ANNX"];
-    readonly ARCADE: readonly ["ARC"];
-    readonly AVENUE: readonly ["AVE", "AV", "AVEN", "AVENU", "AVN", "AVNUE"];
-    readonly BAYOU: readonly ["BYU", "BAYOO"];
-    readonly BEACH: readonly ["BCH"];
-    readonly BEND: readonly ["BND"];
-    readonly BLUFF: readonly ["BLF", "BLUF"];
-    readonly BLUFFS: readonly ["BLFS"];
-    readonly BOTTOM: readonly ["BTM", "BOT", "BOTTM"];
-    readonly BOULEVARD: readonly ["BLVD", "BOUL", "BOULV"];
-    readonly BRANCH: readonly ["BR", "BRNCH"];
-    readonly BRIDGE: readonly ["BRG", "BRDGE"];
-    readonly BROOK: readonly ["BRK"];
-    readonly BROOKS: readonly ["BRKS"];
-    readonly BURG: readonly ["BG"];
-    readonly BURGS: readonly ["BGS"];
-    readonly BYPASS: readonly ["BYP", "BYPA", "BYPAS", "BYPS"];
-    readonly CAMP: readonly ["CP", "CMP"];
-    readonly CANYON: readonly ["CYN", "CANYN", "CNYN"];
-    readonly CAPE: readonly ["CPE"];
-    readonly CAUSEWAY: readonly ["CSWY", "CAUSWA"];
-    readonly CENTER: readonly ["CTR", "CEN", "CENT", "CENTR", "CENTRE", "CNTER", "CNTR"];
-    readonly CENTERS: readonly ["CTRS"];
-    readonly CIRCLE: readonly ["CIR", "CIRC", "CIRCL", "CRCL", "CRCLE"];
-    readonly CIRCLES: readonly ["CIRS"];
-    readonly CLIFF: readonly ["CLF"];
-    readonly CLIFFS: readonly ["CLFS"];
-    readonly CLUB: readonly ["CLB"];
-    readonly COMMON: readonly ["CMN"];
-    readonly COMMONS: readonly ["CMNS"];
-    readonly CORNER: readonly ["COR"];
-    readonly CORNERS: readonly ["CORS"];
-    readonly COURSE: readonly ["CRSE"];
-    readonly COURT: readonly ["CT"];
-    readonly COURTS: readonly ["CTS"];
-    readonly COVE: readonly ["CV"];
-    readonly COVES: readonly ["CVS"];
-    readonly CREEK: readonly ["CRK"];
-    readonly CRESCENT: readonly ["CRES", "CRSENT", "CRSNT"];
-    readonly CREST: readonly ["CRST"];
-    readonly CROSSING: readonly ["XING", "CRSSNG"];
-    readonly CROSSROAD: readonly ["XRD"];
-    readonly CROSSROADS: readonly ["XRDS"];
-    readonly CURVE: readonly ["CURV"];
-    readonly DALE: readonly ["DL"];
-    readonly DAM: readonly ["DM"];
-    readonly DIVIDE: readonly ["DV", "DIV", "DVD"];
-    readonly DRIVE: readonly ["DR", "DRIV", "DRV"];
-    readonly DRIVES: readonly ["DRS"];
-    readonly ESTATE: readonly ["EST"];
-    readonly ESTATES: readonly ["ESTS"];
-    readonly EXPRESSWAY: readonly ["EXPY", "EXP", "EXPR", "EXPRESS", "EXPW"];
-    readonly EXTENSION: readonly ["EXT", "EXTN", "EXTNSN"];
-    readonly EXTENSIONS: readonly ["EXTS"];
-    readonly FALL: readonly ["FALL"];
-    readonly FALLS: readonly ["FLS"];
-    readonly FERRY: readonly ["FRY", "FRRY"];
-    readonly FIELD: readonly ["FLD"];
-    readonly FIELDS: readonly ["FLDS"];
-    readonly FLAT: readonly ["FLT"];
-    readonly FLATS: readonly ["FLTS"];
-    readonly FORD: readonly ["FRD"];
-    readonly FORDS: readonly ["FRDS"];
-    readonly FOREST: readonly ["FRST", "FORESTS"];
-    readonly FORGE: readonly ["FRG", "FORG"];
-    readonly FORGES: readonly ["FRGS"];
-    readonly FORK: readonly ["FRK"];
-    readonly FORKS: readonly ["FRKS"];
-    readonly FORT: readonly ["FT", "FRT"];
-    readonly FREEWAY: readonly ["FWY", "FREEWY", "FRWAY", "FRWY"];
-    readonly GARDEN: readonly ["GDN", "GARDN", "GRDEN", "GRDN"];
-    readonly GARDENS: readonly ["GDNS", "GRDNS"];
-    readonly GATEWAY: readonly ["GTWY", "GATEWY", "GATWAY", "GTWAY"];
-    readonly GLEN: readonly ["GLN"];
-    readonly GLENS: readonly ["GLNS"];
-    readonly GREEN: readonly ["GRN"];
-    readonly GREENS: readonly ["GRNS"];
-    readonly GROVE: readonly ["GRV", "GROV"];
-    readonly GROVES: readonly ["GRVS"];
-    readonly HARBOR: readonly ["HBR", "HARB", "HARBR", "HRBOR"];
-    readonly HARBORS: readonly ["HBRS"];
-    readonly HAVEN: readonly ["HVN"];
-    readonly HEIGHTS: readonly ["HTS", "HT"];
-    readonly HIGHWAY: readonly ["HWY", "HIGHWY", "HIWAY", "HIWY", "HWAY"];
-    readonly HILL: readonly ["HL"];
-    readonly HILLS: readonly ["HLS"];
-    readonly HOLLOW: readonly ["HOLW", "HLLW", "HOLLOWS", "HOLWS"];
-    readonly INLET: readonly ["INLT"];
-    readonly ISLAND: readonly ["IS", "ISLND"];
-    readonly ISLANDS: readonly ["ISS", "ISLNDS"];
-    readonly ISLE: readonly ["ISLE", "ISLES"];
-    readonly JUNCTION: readonly ["JCT", "JCTION", "JCTN", "JUNCTN", "JUNCTON"];
-    readonly JUNCTIONS: readonly ["JCTS", "JCTNS"];
-    readonly KEY: readonly ["KY"];
-    readonly KEYS: readonly ["KYS"];
-    readonly KNOLL: readonly ["KNL", "KNOL"];
-    readonly KNOLLS: readonly ["KNLS"];
-    readonly LAKE: readonly ["LK"];
-    readonly LAKES: readonly ["LKS"];
-    readonly LAND: readonly ["LAND"];
-    readonly LANDING: readonly ["LNDG", "LNDNG"];
-    readonly LANE: readonly ["LN"];
-    readonly LIGHT: readonly ["LGT"];
-    readonly LIGHTS: readonly ["LGTS"];
-    readonly LOAF: readonly ["LF"];
-    readonly LOCK: readonly ["LCK"];
-    readonly LOCKS: readonly ["LCKS"];
-    readonly LODGE: readonly ["LDG", "LDGE", "LODG"];
-    readonly LOOP: readonly ["LOOP", "LOOPS"];
-    readonly MALL: readonly ["MALL"];
-    readonly MANOR: readonly ["MNR"];
-    readonly MANORS: readonly ["MNRS"];
-    readonly MEADOW: readonly ["MDW"];
-    readonly MEADOWS: readonly ["MDWS", "MDW", "MEDOWS"];
-    readonly MEWS: readonly ["MEWS"];
-    readonly MILL: readonly ["ML"];
-    readonly MILLS: readonly ["MLS"];
-    readonly MISSION: readonly ["MSN", "MISSN", "MSSN"];
-    readonly MOTORWAY: readonly ["MTWY"];
-    readonly MOUNT: readonly ["MT", "MNT"];
-    readonly MOUNTAIN: readonly ["MTN", "MNTAIN", "MNTN", "MOUNTIN", "MTIN"];
-    readonly MOUNTAINS: readonly ["MTNS", "MNTNS"];
-    readonly NECK: readonly ["NCK"];
-    readonly ORCHARD: readonly ["ORCH", "ORCHRD"];
-    readonly OVAL: readonly ["OVAL", "OVL"];
-    readonly OVERPASS: readonly ["OPAS"];
-    readonly PARK: readonly ["PARK", "PRK", "PARKS"];
-    readonly PARKWAY: readonly ["PKWY", "PARKWY", "PKWAY", "PKY"];
-    readonly PARKWAYS: readonly ["PKWY", "PKWYS"];
-    readonly PASS: readonly ["PASS"];
-    readonly PASSAGE: readonly ["PSGE"];
-    readonly PATH: readonly ["PATH", "PATHS"];
-    readonly PIKE: readonly ["PIKE", "PIKES"];
-    readonly PINE: readonly ["PNE"];
-    readonly PINES: readonly ["PNES"];
-    readonly PLACE: readonly ["PL"];
-    readonly PLAIN: readonly ["PLN"];
-    readonly PLAINS: readonly ["PLNS"];
-    readonly PLAZA: readonly ["PLZ", "PLZA"];
-    readonly POINT: readonly ["PT"];
-    readonly POINTS: readonly ["PTS"];
-    readonly PORT: readonly ["PRT"];
-    readonly PORTS: readonly ["PRTS"];
-    readonly PRAIRIE: readonly ["PR", "PRR"];
-    readonly RADIAL: readonly ["RADL", "RAD", "RADIEL"];
-    readonly RAMP: readonly ["RAMP"];
-    readonly RANCH: readonly ["RNCH", "RANCHES", "RNCHS"];
-    readonly RAPID: readonly ["RPD"];
-    readonly RAPIDS: readonly ["RPDS"];
-    readonly REST: readonly ["RST"];
-    readonly RIDGE: readonly ["RDG", "RDGE"];
-    readonly RIDGES: readonly ["RDGS"];
-    readonly RIVER: readonly ["RIV", "RVR", "RIVR"];
-    readonly ROAD: readonly ["RD"];
-    readonly ROADS: readonly ["RDS"];
-    readonly ROUTE: readonly ["RTE"];
-    readonly ROW: readonly ["ROW"];
-    readonly RUE: readonly ["RUE"];
-    readonly RUN: readonly ["RUN"];
-    readonly SHOAL: readonly ["SHL"];
-    readonly SHOALS: readonly ["SHLS"];
-    readonly SHORE: readonly ["SHR", "SHOAR"];
-    readonly SHORES: readonly ["SHRS", "SHOARS"];
-    readonly SKYWAY: readonly ["SKWY"];
-    readonly SPRING: readonly ["SPG", "SPNG", "SPRNG"];
-    readonly SPRINGS: readonly ["SPGS", "SPNGS", "SPRNGS"];
-    readonly SPUR: readonly ["SPUR"];
-    readonly SPURS: readonly ["SPUR"];
-    readonly SQUARE: readonly ["SQ", "SQR", "SQRE", "SQU"];
-    readonly SQUARES: readonly ["SQS", "SQRS"];
-    readonly STATION: readonly ["STA", "STATN", "STN"];
-    readonly STRAVENUE: readonly ["STRA", "STRAV", "STRAVEN", "STRAVN", "STRVN", "STRVNUE"];
-    readonly STREAM: readonly ["STRM", "STREME"];
-    readonly STREET: readonly ["ST", "STRT", "STR"];
-    readonly STREETS: readonly ["STS"];
-    readonly SUMMIT: readonly ["SMT", "SUMIT", "SUMITT"];
-    readonly TERRACE: readonly ["TER", "TERR"];
-    readonly THROUGHWAY: readonly ["TRWY"];
-    readonly TRACE: readonly ["TRCE", "TRACES"];
-    readonly TRACK: readonly ["TRAK", "TRACKS", "TRK", "TRKS"];
-    readonly TRAFFICWAY: readonly ["TRFY"];
-    readonly TRAIL: readonly ["TRL", "TRAILS", "TRLS"];
-    readonly TRAILER: readonly ["TRLR", "TRLRS"];
-    readonly TUNNEL: readonly ["TUNL", "TUNEL", "TUNLS", "TUNNELS", "TUNNL"];
-    readonly TURNPIKE: readonly ["TPKE", "TRNPK", "TURNPK"];
-    readonly UNDERPASS: readonly ["UPAS"];
-    readonly UNION: readonly ["UN"];
-    readonly UNIONS: readonly ["UNS"];
-    readonly VALLEY: readonly ["VLY", "VALLY", "VLLY"];
-    readonly VALLEYS: readonly ["VLYS"];
-    readonly VIADUCT: readonly ["VIA", "VDCT", "VIADCT"];
-    readonly VIEW: readonly ["VW"];
-    readonly VIEWS: readonly ["VWS"];
-    readonly VILLAGE: readonly ["VLG", "VILL", "VILLAG", "VILLG", "VILLIAGE"];
-    readonly VILLAGES: readonly ["VLGS"];
-    readonly VILLE: readonly ["VL"];
-    readonly VISTA: readonly ["VIS", "VIST", "VST", "VSTA"];
-    readonly WALK: readonly ["WALK"];
-    readonly WALKS: readonly ["WALK"];
-    readonly WALL: readonly ["WALL"];
-    readonly WAY: readonly ["WAY", "WY"];
-    readonly WAYS: readonly ["WAYS"];
-    readonly WELL: readonly ["WL"];
-    readonly WELLS: readonly ["WLS"];
+    ALLEY: string[];
+    ANEX: string[];
+    ARCADE: string[];
+    AVENUE: string[];
+    BAYOU: string[];
+    BEACH: string[];
+    BEND: string[];
+    BLUFF: string[];
+    BLUFFS: string[];
+    BOTTOM: string[];
+    BOULEVARD: string[];
+    BRANCH: string[];
+    BRIDGE: string[];
+    BROOK: string[];
+    BROOKS: string[];
+    BURG: string[];
+    BURGS: string[];
+    BYPASS: string[];
+    CAMP: string[];
+    CANYON: string[];
+    CAPE: string[];
+    CAUSEWAY: string[];
+    CENTER: string[];
+    CENTERS: string[];
+    CIRCLE: string[];
+    CIRCLES: string[];
+    CLIFF: string[];
+    CLIFFS: string[];
+    CLUB: string[];
+    COMMON: string[];
+    COMMONS: string[];
+    CORNER: string[];
+    CORNERS: string[];
+    COURSE: string[];
+    COURT: string[];
+    COURTS: string[];
+    COVE: string[];
+    COVES: string[];
+    CREEK: string[];
+    CRESCENT: string[];
+    CREST: string[];
+    CROSSING: string[];
+    CROSSROAD: string[];
+    CROSSROADS: string[];
+    CURVE: string[];
+    DALE: string[];
+    DAM: string[];
+    DIVIDE: string[];
+    DRIVE: string[];
+    DRIVES: string[];
+    ESTATE: string[];
+    ESTATES: string[];
+    EXPRESSWAY: string[];
+    EXTENSION: string[];
+    EXTENSIONS: string[];
+    FALL: string[];
+    FALLS: string[];
+    FERRY: string[];
+    FIELD: string[];
+    FIELDS: string[];
+    FLAT: string[];
+    FLATS: string[];
+    FORD: string[];
+    FORDS: string[];
+    FOREST: string[];
+    FORGE: string[];
+    FORGES: string[];
+    FORK: string[];
+    FORKS: string[];
+    FORT: string[];
+    FREEWAY: string[];
+    GARDEN: string[];
+    GARDENS: string[];
+    GATEWAY: string[];
+    GLEN: string[];
+    GLENS: string[];
+    GREEN: string[];
+    GREENS: string[];
+    GROVE: string[];
+    GROVES: string[];
+    HARBOR: string[];
+    HARBORS: string[];
+    HAVEN: string[];
+    HEIGHTS: string[];
+    HIGHWAY: string[];
+    HILL: string[];
+    HILLS: string[];
+    HOLLOW: string[];
+    INLET: string[];
+    ISLAND: string[];
+    ISLANDS: string[];
+    ISLE: string[];
+    JUNCTION: string[];
+    JUNCTIONS: string[];
+    KEY: string[];
+    KEYS: string[];
+    KNOLL: string[];
+    KNOLLS: string[];
+    LAKE: string[];
+    LAKES: string[];
+    LAND: string[];
+    LANDING: string[];
+    LANE: string[];
+    LIGHT: string[];
+    LIGHTS: string[];
+    LOAF: string[];
+    LOCK: string[];
+    LOCKS: string[];
+    LODGE: string[];
+    LOOP: string[];
+    MALL: string[];
+    MANOR: string[];
+    MANORS: string[];
+    MEADOW: string[];
+    MEADOWS: string[];
+    MEWS: string[];
+    MILL: string[];
+    MILLS: string[];
+    MISSION: string[];
+    MOTORWAY: string[];
+    MOUNT: string[];
+    MOUNTAIN: string[];
+    MOUNTAINS: string[];
+    NECK: string[];
+    ORCHARD: string[];
+    OVAL: string[];
+    OVERPASS: string[];
+    PARK: string[];
+    PARKWAY: string[];
+    PARKWAYS: string[];
+    PASS: string[];
+    PASSAGE: string[];
+    PATH: string[];
+    PIKE: string[];
+    PINE: string[];
+    PINES: string[];
+    PLACE: string[];
+    PLAIN: string[];
+    PLAINS: string[];
+    PLAZA: string[];
+    POINT: string[];
+    POINTS: string[];
+    PORT: string[];
+    PORTS: string[];
+    PRAIRIE: string[];
+    RADIAL: string[];
+    RAMP: string[];
+    RANCH: string[];
+    RAPID: string[];
+    RAPIDS: string[];
+    REST: string[];
+    RIDGE: string[];
+    RIDGES: string[];
+    RIVER: string[];
+    ROAD: string[];
+    ROADS: string[];
+    ROUTE: string[];
+    ROW: string[];
+    RUE: string[];
+    RUN: string[];
+    SHOAL: string[];
+    SHOALS: string[];
+    SHORE: string[];
+    SHORES: string[];
+    SKYWAY: string[];
+    SPRING: string[];
+    SPRINGS: string[];
+    SPUR: string[];
+    SPURS: string[];
+    SQUARE: string[];
+    SQUARES: string[];
+    STATION: string[];
+    STRAVENUE: string[];
+    STREAM: string[];
+    STREET: string[];
+    STREETS: string[];
+    SUMMIT: string[];
+    TERRACE: string[];
+    THROUGHWAY: string[];
+    TRACE: string[];
+    TRACK: string[];
+    TRAFFICWAY: string[];
+    TRAIL: string[];
+    TRAILER: string[];
+    TUNNEL: string[];
+    TURNPIKE: string[];
+    UNDERPASS: string[];
+    UNION: string[];
+    UNIONS: string[];
+    VALLEY: string[];
+    VALLEYS: string[];
+    VIADUCT: string[];
+    VIEW: string[];
+    VIEWS: string[];
+    VILLAGE: string[];
+    VILLAGES: string[];
+    VILLE: string[];
+    VISTA: string[];
+    WALK: string[];
+    WALKS: string[];
+    WALL: string[];
+    WAY: string[];
+    WAYS: string[];
+    WELL: string[];
+    WELLS: string[];
 };
 /**
  * Canonical USPS suffix (full word, uppercase per the publication).
  */
 export type USStreetSuffix = keyof typeof US_STREET_SUFFIX_VARIANTS;
+/**
+ * Pub-28 canonicals that are also common head nouns in street/place names ("Menlo PARK Road", "Blue HILL Rd") — the
+ * ambiguous class behind #1569. Curated (golden v0.1.3 + OA street pool), NOT part of the USPS publication; see
+ * `nameProneCanonicals` in `./street-suffix.json`.
+ */
+export declare const NAME_PRONE_US_SUFFIXES: ReadonlySet<USStreetSuffix>;
 /**
  * Inverse lookup: every variant abbreviation OR full canonical word → its canonical key. Built once at module load,
  * lowercase-keyed for case-insensitive matching (`street` → `"STREET"`, `st` → `"STREET"`, `strt` → `"STREET"`, …).
@@ -259,211 +273,211 @@ export declare function matchTrailingSuffix(street: string): {
  * The USPS suffix record, under its original isp-nexus name. Aliases {@link US_STREET_SUFFIX_VARIANTS}.
  */
 export declare const StreetSuffixAbbreviationRecord: {
-    readonly ALLEY: readonly ["ALY", "ALLEE", "ALLY"];
-    readonly ANEX: readonly ["ANX", "ANNEX", "ANNX"];
-    readonly ARCADE: readonly ["ARC"];
-    readonly AVENUE: readonly ["AVE", "AV", "AVEN", "AVENU", "AVN", "AVNUE"];
-    readonly BAYOU: readonly ["BYU", "BAYOO"];
-    readonly BEACH: readonly ["BCH"];
-    readonly BEND: readonly ["BND"];
-    readonly BLUFF: readonly ["BLF", "BLUF"];
-    readonly BLUFFS: readonly ["BLFS"];
-    readonly BOTTOM: readonly ["BTM", "BOT", "BOTTM"];
-    readonly BOULEVARD: readonly ["BLVD", "BOUL", "BOULV"];
-    readonly BRANCH: readonly ["BR", "BRNCH"];
-    readonly BRIDGE: readonly ["BRG", "BRDGE"];
-    readonly BROOK: readonly ["BRK"];
-    readonly BROOKS: readonly ["BRKS"];
-    readonly BURG: readonly ["BG"];
-    readonly BURGS: readonly ["BGS"];
-    readonly BYPASS: readonly ["BYP", "BYPA", "BYPAS", "BYPS"];
-    readonly CAMP: readonly ["CP", "CMP"];
-    readonly CANYON: readonly ["CYN", "CANYN", "CNYN"];
-    readonly CAPE: readonly ["CPE"];
-    readonly CAUSEWAY: readonly ["CSWY", "CAUSWA"];
-    readonly CENTER: readonly ["CTR", "CEN", "CENT", "CENTR", "CENTRE", "CNTER", "CNTR"];
-    readonly CENTERS: readonly ["CTRS"];
-    readonly CIRCLE: readonly ["CIR", "CIRC", "CIRCL", "CRCL", "CRCLE"];
-    readonly CIRCLES: readonly ["CIRS"];
-    readonly CLIFF: readonly ["CLF"];
-    readonly CLIFFS: readonly ["CLFS"];
-    readonly CLUB: readonly ["CLB"];
-    readonly COMMON: readonly ["CMN"];
-    readonly COMMONS: readonly ["CMNS"];
-    readonly CORNER: readonly ["COR"];
-    readonly CORNERS: readonly ["CORS"];
-    readonly COURSE: readonly ["CRSE"];
-    readonly COURT: readonly ["CT"];
-    readonly COURTS: readonly ["CTS"];
-    readonly COVE: readonly ["CV"];
-    readonly COVES: readonly ["CVS"];
-    readonly CREEK: readonly ["CRK"];
-    readonly CRESCENT: readonly ["CRES", "CRSENT", "CRSNT"];
-    readonly CREST: readonly ["CRST"];
-    readonly CROSSING: readonly ["XING", "CRSSNG"];
-    readonly CROSSROAD: readonly ["XRD"];
-    readonly CROSSROADS: readonly ["XRDS"];
-    readonly CURVE: readonly ["CURV"];
-    readonly DALE: readonly ["DL"];
-    readonly DAM: readonly ["DM"];
-    readonly DIVIDE: readonly ["DV", "DIV", "DVD"];
-    readonly DRIVE: readonly ["DR", "DRIV", "DRV"];
-    readonly DRIVES: readonly ["DRS"];
-    readonly ESTATE: readonly ["EST"];
-    readonly ESTATES: readonly ["ESTS"];
-    readonly EXPRESSWAY: readonly ["EXPY", "EXP", "EXPR", "EXPRESS", "EXPW"];
-    readonly EXTENSION: readonly ["EXT", "EXTN", "EXTNSN"];
-    readonly EXTENSIONS: readonly ["EXTS"];
-    readonly FALL: readonly ["FALL"];
-    readonly FALLS: readonly ["FLS"];
-    readonly FERRY: readonly ["FRY", "FRRY"];
-    readonly FIELD: readonly ["FLD"];
-    readonly FIELDS: readonly ["FLDS"];
-    readonly FLAT: readonly ["FLT"];
-    readonly FLATS: readonly ["FLTS"];
-    readonly FORD: readonly ["FRD"];
-    readonly FORDS: readonly ["FRDS"];
-    readonly FOREST: readonly ["FRST", "FORESTS"];
-    readonly FORGE: readonly ["FRG", "FORG"];
-    readonly FORGES: readonly ["FRGS"];
-    readonly FORK: readonly ["FRK"];
-    readonly FORKS: readonly ["FRKS"];
-    readonly FORT: readonly ["FT", "FRT"];
-    readonly FREEWAY: readonly ["FWY", "FREEWY", "FRWAY", "FRWY"];
-    readonly GARDEN: readonly ["GDN", "GARDN", "GRDEN", "GRDN"];
-    readonly GARDENS: readonly ["GDNS", "GRDNS"];
-    readonly GATEWAY: readonly ["GTWY", "GATEWY", "GATWAY", "GTWAY"];
-    readonly GLEN: readonly ["GLN"];
-    readonly GLENS: readonly ["GLNS"];
-    readonly GREEN: readonly ["GRN"];
-    readonly GREENS: readonly ["GRNS"];
-    readonly GROVE: readonly ["GRV", "GROV"];
-    readonly GROVES: readonly ["GRVS"];
-    readonly HARBOR: readonly ["HBR", "HARB", "HARBR", "HRBOR"];
-    readonly HARBORS: readonly ["HBRS"];
-    readonly HAVEN: readonly ["HVN"];
-    readonly HEIGHTS: readonly ["HTS", "HT"];
-    readonly HIGHWAY: readonly ["HWY", "HIGHWY", "HIWAY", "HIWY", "HWAY"];
-    readonly HILL: readonly ["HL"];
-    readonly HILLS: readonly ["HLS"];
-    readonly HOLLOW: readonly ["HOLW", "HLLW", "HOLLOWS", "HOLWS"];
-    readonly INLET: readonly ["INLT"];
-    readonly ISLAND: readonly ["IS", "ISLND"];
-    readonly ISLANDS: readonly ["ISS", "ISLNDS"];
-    readonly ISLE: readonly ["ISLE", "ISLES"];
-    readonly JUNCTION: readonly ["JCT", "JCTION", "JCTN", "JUNCTN", "JUNCTON"];
-    readonly JUNCTIONS: readonly ["JCTS", "JCTNS"];
-    readonly KEY: readonly ["KY"];
-    readonly KEYS: readonly ["KYS"];
-    readonly KNOLL: readonly ["KNL", "KNOL"];
-    readonly KNOLLS: readonly ["KNLS"];
-    readonly LAKE: readonly ["LK"];
-    readonly LAKES: readonly ["LKS"];
-    readonly LAND: readonly ["LAND"];
-    readonly LANDING: readonly ["LNDG", "LNDNG"];
-    readonly LANE: readonly ["LN"];
-    readonly LIGHT: readonly ["LGT"];
-    readonly LIGHTS: readonly ["LGTS"];
-    readonly LOAF: readonly ["LF"];
-    readonly LOCK: readonly ["LCK"];
-    readonly LOCKS: readonly ["LCKS"];
-    readonly LODGE: readonly ["LDG", "LDGE", "LODG"];
-    readonly LOOP: readonly ["LOOP", "LOOPS"];
-    readonly MALL: readonly ["MALL"];
-    readonly MANOR: readonly ["MNR"];
-    readonly MANORS: readonly ["MNRS"];
-    readonly MEADOW: readonly ["MDW"];
-    readonly MEADOWS: readonly ["MDWS", "MDW", "MEDOWS"];
-    readonly MEWS: readonly ["MEWS"];
-    readonly MILL: readonly ["ML"];
-    readonly MILLS: readonly ["MLS"];
-    readonly MISSION: readonly ["MSN", "MISSN", "MSSN"];
-    readonly MOTORWAY: readonly ["MTWY"];
-    readonly MOUNT: readonly ["MT", "MNT"];
-    readonly MOUNTAIN: readonly ["MTN", "MNTAIN", "MNTN", "MOUNTIN", "MTIN"];
-    readonly MOUNTAINS: readonly ["MTNS", "MNTNS"];
-    readonly NECK: readonly ["NCK"];
-    readonly ORCHARD: readonly ["ORCH", "ORCHRD"];
-    readonly OVAL: readonly ["OVAL", "OVL"];
-    readonly OVERPASS: readonly ["OPAS"];
-    readonly PARK: readonly ["PARK", "PRK", "PARKS"];
-    readonly PARKWAY: readonly ["PKWY", "PARKWY", "PKWAY", "PKY"];
-    readonly PARKWAYS: readonly ["PKWY", "PKWYS"];
-    readonly PASS: readonly ["PASS"];
-    readonly PASSAGE: readonly ["PSGE"];
-    readonly PATH: readonly ["PATH", "PATHS"];
-    readonly PIKE: readonly ["PIKE", "PIKES"];
-    readonly PINE: readonly ["PNE"];
-    readonly PINES: readonly ["PNES"];
-    readonly PLACE: readonly ["PL"];
-    readonly PLAIN: readonly ["PLN"];
-    readonly PLAINS: readonly ["PLNS"];
-    readonly PLAZA: readonly ["PLZ", "PLZA"];
-    readonly POINT: readonly ["PT"];
-    readonly POINTS: readonly ["PTS"];
-    readonly PORT: readonly ["PRT"];
-    readonly PORTS: readonly ["PRTS"];
-    readonly PRAIRIE: readonly ["PR", "PRR"];
-    readonly RADIAL: readonly ["RADL", "RAD", "RADIEL"];
-    readonly RAMP: readonly ["RAMP"];
-    readonly RANCH: readonly ["RNCH", "RANCHES", "RNCHS"];
-    readonly RAPID: readonly ["RPD"];
-    readonly RAPIDS: readonly ["RPDS"];
-    readonly REST: readonly ["RST"];
-    readonly RIDGE: readonly ["RDG", "RDGE"];
-    readonly RIDGES: readonly ["RDGS"];
-    readonly RIVER: readonly ["RIV", "RVR", "RIVR"];
-    readonly ROAD: readonly ["RD"];
-    readonly ROADS: readonly ["RDS"];
-    readonly ROUTE: readonly ["RTE"];
-    readonly ROW: readonly ["ROW"];
-    readonly RUE: readonly ["RUE"];
-    readonly RUN: readonly ["RUN"];
-    readonly SHOAL: readonly ["SHL"];
-    readonly SHOALS: readonly ["SHLS"];
-    readonly SHORE: readonly ["SHR", "SHOAR"];
-    readonly SHORES: readonly ["SHRS", "SHOARS"];
-    readonly SKYWAY: readonly ["SKWY"];
-    readonly SPRING: readonly ["SPG", "SPNG", "SPRNG"];
-    readonly SPRINGS: readonly ["SPGS", "SPNGS", "SPRNGS"];
-    readonly SPUR: readonly ["SPUR"];
-    readonly SPURS: readonly ["SPUR"];
-    readonly SQUARE: readonly ["SQ", "SQR", "SQRE", "SQU"];
-    readonly SQUARES: readonly ["SQS", "SQRS"];
-    readonly STATION: readonly ["STA", "STATN", "STN"];
-    readonly STRAVENUE: readonly ["STRA", "STRAV", "STRAVEN", "STRAVN", "STRVN", "STRVNUE"];
-    readonly STREAM: readonly ["STRM", "STREME"];
-    readonly STREET: readonly ["ST", "STRT", "STR"];
-    readonly STREETS: readonly ["STS"];
-    readonly SUMMIT: readonly ["SMT", "SUMIT", "SUMITT"];
-    readonly TERRACE: readonly ["TER", "TERR"];
-    readonly THROUGHWAY: readonly ["TRWY"];
-    readonly TRACE: readonly ["TRCE", "TRACES"];
-    readonly TRACK: readonly ["TRAK", "TRACKS", "TRK", "TRKS"];
-    readonly TRAFFICWAY: readonly ["TRFY"];
-    readonly TRAIL: readonly ["TRL", "TRAILS", "TRLS"];
-    readonly TRAILER: readonly ["TRLR", "TRLRS"];
-    readonly TUNNEL: readonly ["TUNL", "TUNEL", "TUNLS", "TUNNELS", "TUNNL"];
-    readonly TURNPIKE: readonly ["TPKE", "TRNPK", "TURNPK"];
-    readonly UNDERPASS: readonly ["UPAS"];
-    readonly UNION: readonly ["UN"];
-    readonly UNIONS: readonly ["UNS"];
-    readonly VALLEY: readonly ["VLY", "VALLY", "VLLY"];
-    readonly VALLEYS: readonly ["VLYS"];
-    readonly VIADUCT: readonly ["VIA", "VDCT", "VIADCT"];
-    readonly VIEW: readonly ["VW"];
-    readonly VIEWS: readonly ["VWS"];
-    readonly VILLAGE: readonly ["VLG", "VILL", "VILLAG", "VILLG", "VILLIAGE"];
-    readonly VILLAGES: readonly ["VLGS"];
-    readonly VILLE: readonly ["VL"];
-    readonly VISTA: readonly ["VIS", "VIST", "VST", "VSTA"];
-    readonly WALK: readonly ["WALK"];
-    readonly WALKS: readonly ["WALK"];
-    readonly WALL: readonly ["WALL"];
-    readonly WAY: readonly ["WAY", "WY"];
-    readonly WAYS: readonly ["WAYS"];
-    readonly WELL: readonly ["WL"];
-    readonly WELLS: readonly ["WLS"];
+    ALLEY: string[];
+    ANEX: string[];
+    ARCADE: string[];
+    AVENUE: string[];
+    BAYOU: string[];
+    BEACH: string[];
+    BEND: string[];
+    BLUFF: string[];
+    BLUFFS: string[];
+    BOTTOM: string[];
+    BOULEVARD: string[];
+    BRANCH: string[];
+    BRIDGE: string[];
+    BROOK: string[];
+    BROOKS: string[];
+    BURG: string[];
+    BURGS: string[];
+    BYPASS: string[];
+    CAMP: string[];
+    CANYON: string[];
+    CAPE: string[];
+    CAUSEWAY: string[];
+    CENTER: string[];
+    CENTERS: string[];
+    CIRCLE: string[];
+    CIRCLES: string[];
+    CLIFF: string[];
+    CLIFFS: string[];
+    CLUB: string[];
+    COMMON: string[];
+    COMMONS: string[];
+    CORNER: string[];
+    CORNERS: string[];
+    COURSE: string[];
+    COURT: string[];
+    COURTS: string[];
+    COVE: string[];
+    COVES: string[];
+    CREEK: string[];
+    CRESCENT: string[];
+    CREST: string[];
+    CROSSING: string[];
+    CROSSROAD: string[];
+    CROSSROADS: string[];
+    CURVE: string[];
+    DALE: string[];
+    DAM: string[];
+    DIVIDE: string[];
+    DRIVE: string[];
+    DRIVES: string[];
+    ESTATE: string[];
+    ESTATES: string[];
+    EXPRESSWAY: string[];
+    EXTENSION: string[];
+    EXTENSIONS: string[];
+    FALL: string[];
+    FALLS: string[];
+    FERRY: string[];
+    FIELD: string[];
+    FIELDS: string[];
+    FLAT: string[];
+    FLATS: string[];
+    FORD: string[];
+    FORDS: string[];
+    FOREST: string[];
+    FORGE: string[];
+    FORGES: string[];
+    FORK: string[];
+    FORKS: string[];
+    FORT: string[];
+    FREEWAY: string[];
+    GARDEN: string[];
+    GARDENS: string[];
+    GATEWAY: string[];
+    GLEN: string[];
+    GLENS: string[];
+    GREEN: string[];
+    GREENS: string[];
+    GROVE: string[];
+    GROVES: string[];
+    HARBOR: string[];
+    HARBORS: string[];
+    HAVEN: string[];
+    HEIGHTS: string[];
+    HIGHWAY: string[];
+    HILL: string[];
+    HILLS: string[];
+    HOLLOW: string[];
+    INLET: string[];
+    ISLAND: string[];
+    ISLANDS: string[];
+    ISLE: string[];
+    JUNCTION: string[];
+    JUNCTIONS: string[];
+    KEY: string[];
+    KEYS: string[];
+    KNOLL: string[];
+    KNOLLS: string[];
+    LAKE: string[];
+    LAKES: string[];
+    LAND: string[];
+    LANDING: string[];
+    LANE: string[];
+    LIGHT: string[];
+    LIGHTS: string[];
+    LOAF: string[];
+    LOCK: string[];
+    LOCKS: string[];
+    LODGE: string[];
+    LOOP: string[];
+    MALL: string[];
+    MANOR: string[];
+    MANORS: string[];
+    MEADOW: string[];
+    MEADOWS: string[];
+    MEWS: string[];
+    MILL: string[];
+    MILLS: string[];
+    MISSION: string[];
+    MOTORWAY: string[];
+    MOUNT: string[];
+    MOUNTAIN: string[];
+    MOUNTAINS: string[];
+    NECK: string[];
+    ORCHARD: string[];
+    OVAL: string[];
+    OVERPASS: string[];
+    PARK: string[];
+    PARKWAY: string[];
+    PARKWAYS: string[];
+    PASS: string[];
+    PASSAGE: string[];
+    PATH: string[];
+    PIKE: string[];
+    PINE: string[];
+    PINES: string[];
+    PLACE: string[];
+    PLAIN: string[];
+    PLAINS: string[];
+    PLAZA: string[];
+    POINT: string[];
+    POINTS: string[];
+    PORT: string[];
+    PORTS: string[];
+    PRAIRIE: string[];
+    RADIAL: string[];
+    RAMP: string[];
+    RANCH: string[];
+    RAPID: string[];
+    RAPIDS: string[];
+    REST: string[];
+    RIDGE: string[];
+    RIDGES: string[];
+    RIVER: string[];
+    ROAD: string[];
+    ROADS: string[];
+    ROUTE: string[];
+    ROW: string[];
+    RUE: string[];
+    RUN: string[];
+    SHOAL: string[];
+    SHOALS: string[];
+    SHORE: string[];
+    SHORES: string[];
+    SKYWAY: string[];
+    SPRING: string[];
+    SPRINGS: string[];
+    SPUR: string[];
+    SPURS: string[];
+    SQUARE: string[];
+    SQUARES: string[];
+    STATION: string[];
+    STRAVENUE: string[];
+    STREAM: string[];
+    STREET: string[];
+    STREETS: string[];
+    SUMMIT: string[];
+    TERRACE: string[];
+    THROUGHWAY: string[];
+    TRACE: string[];
+    TRACK: string[];
+    TRAFFICWAY: string[];
+    TRAIL: string[];
+    TRAILER: string[];
+    TUNNEL: string[];
+    TURNPIKE: string[];
+    UNDERPASS: string[];
+    UNION: string[];
+    UNIONS: string[];
+    VALLEY: string[];
+    VALLEYS: string[];
+    VIADUCT: string[];
+    VIEW: string[];
+    VIEWS: string[];
+    VILLAGE: string[];
+    VILLAGES: string[];
+    VILLE: string[];
+    VISTA: string[];
+    WALK: string[];
+    WALKS: string[];
+    WALL: string[];
+    WAY: string[];
+    WAYS: string[];
+    WELL: string[];
+    WELLS: string[];
 };
 export type StreetSuffixAbbreviationRecord = typeof US_STREET_SUFFIX_VARIANTS;
 /**