/** * USPS street-suffix variant expansion + compound split/join. * * Canonical implementation hoisted from zillow-mcp's `resolver.ts` * (which already lived through suffix_expansion → search_fallback * laddering) and redfin-mcp's `suffix.ts` (which has the cleanest * dedupe + remainder-preservation handling). Compass / homes / onehome * do not currently expand suffixes at the resolver layer — they will * once they migrate to this module. * * Drift this resolves: * * - zillow had `Rd ↔ Road, Ln ↔ Lane, Dr ↔ Drive` only. * - redfin added `Pkwy, Pl, Trl, Ter, Xing, Aly, Pt, Mtn, Vw, Vly`. * - Round-3 #75 needs `Hts ↔ Heights` and `Mtn ↔ Mountain` for the * Lake Lure / Banner Elk cohort, plus compound split (`Bluebird` ↔ * `Blue Bird`) for the Sleeping-Bear-ish mountain names. */ export declare const SUFFIX_PAIRS: ReadonlyArray; /** * Generate suffix variants of the input. Each variant swaps the * trailing street-suffix between its abbreviated and full form. * Returns ONLY the alternates — the caller is expected to also try * the original. Empty when no recognised suffix. */ export declare function expandSuffix(address: string): string[]; /** * Generate "Bluebird" ↔ "Blue Bird"-style variants. For each token in * the street portion of length >= 6, emit splits at every position * that yields two >=3-char alphabetic halves. The right half is * title-cased so casing stays plausible across both branches. For * multi-token streets, also emit a join variant for each adjacent * alphabetic pair, preserving the left token's casing on the join. * * Deliberately greedy (returns every viable split) — the address-match * scorer at the consumer end is cheap and the resolver tries variants * in order. False positives cost one extra resolver call; missing a * variant costs a wrong/missed result. */ export declare function compoundSplits(address: string): string[]; /** * Combined dedupe of original + suffix variants + compound variants. * The original is always first. The caller iterates in order, stopping * on the first that resolves. */ export declare function buildVariants(address: string): string[];