@mailwoman/codex 4.1.0 → 4.2.0

package/out/country/country.js

@@ -0,0 +1,91 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Country recognition for the `country` parity lever. The ISO 3166-1 base (names + alpha-2/alpha-3)
+ *   is salvaged from isp-nexus `spatial/countries` ({@link ./names.ts}, {@link ./codes.ts}); this adds
+ *   the layer ISO doesn't carry — the **surface forms** addresses actually use (endonyms + common
+ *   abbreviations: "USA"/"United States"/"U.S."; "Deutschland"/"Germany"; "España"/"Spain") — plus a
+ *   {@link matchCountry} resolver the corpus country-shard + parsing reuse. Same shape as the other
+ *   codex matchers (street-suffix, directional, po-box).
+ */
+import { Alpha3ToCountryRecord, CountryISO2 } from "./codes.js";
+import {} from "./names.js";
+/**
+ * Common real-address surface forms per ISO 3166-1 alpha-2, **canonical English name first** then
+ * endonym + abbreviations. Curated for the corpus locales + frequent countries (NOT a full 249-entry
+ * variant table — the ISO base below catches the canonical name/code for everything else). Forms are
+ * matched case-insensitively; the first entry is the preferred render form.
+ */
+export const COUNTRY_SURFACE_FORMS = {
+    US: ["United States", "USA", "US", "U.S.A.", "U.S.", "United States of America", "America"],
+    DE: ["Germany", "Deutschland", "DE", "GER", "Federal Republic of Germany"],
+    FR: ["France", "FR", "FRA", "French Republic"],
+    GB: ["United Kingdom", "UK", "Great Britain", "Britain", "England", "GB", "U.K."],
+    ES: ["Spain", "España", "Espana", "ES", "ESP"],
+    IT: ["Italy", "Italia", "IT", "ITA"],
+    NL: ["Netherlands", "Nederland", "The Netherlands", "Holland", "NL", "NLD"],
+    CA: ["Canada", "CA", "CAN"],
+    AU: ["Australia", "AU", "AUS"],
+    CH: ["Switzerland", "Schweiz", "Suisse", "Svizzera", "CH"],
+    AT: ["Austria", "Österreich", "Osterreich", "AT"],
+    BE: ["Belgium", "België", "Belgique", "BE"],
+    IE: ["Ireland", "Éire", "IE", "IRL"],
+    MX: ["Mexico", "México", "MX", "MEX"],
+    JP: ["Japan", "日本", "Nippon", "JP", "JPN"],
+};
+/** alpha-2 → canonical English name (inverted from the salvaged CountryISO2 enum). */
+export const ISO2_TO_NAME = new Map(Object.entries(CountryISO2).map(([name, code]) => [code, name]));
+/**
+ * Any recognized country surface form / canonical name / alpha-2 / alpha-3 → alpha-2 code. Built once
+ * at module load, lowercase-keyed. Canonical names + codes from the ISO base, plus the curated
+ * surface forms (surface forms win on collision — they're the address-facing spellings).
+ */
+export const COUNTRY_LOOKUP = (() => {
+    const out = new Map();
+    const put = (k, iso2) => {
+        const key = k.trim().toLowerCase();
+        if (key && !out.has(key))
+            out.set(key, iso2);
+    };
+    // ISO base: canonical name + alpha-2 + alpha-3.
+    for (const [name, code] of Object.entries(CountryISO2))
+        put(name, code);
+    for (const [code] of Object.entries(CountryISO2))
+        put(code, code); // "US" -> US
+    for (const [alpha3, name] of Object.entries(Alpha3ToCountryRecord)) {
+        const iso2 = CountryISO2[name];
+        if (iso2)
+            put(alpha3, iso2); // "USA" -> US, "DEU" -> DE
+    }
+    // Curated surface forms (override — address spellings beat the ISO base on collision).
+    for (const [iso2, forms] of Object.entries(COUNTRY_SURFACE_FORMS)) {
+        for (const f of forms)
+            out.set(f.trim().toLowerCase(), iso2);
+    }
+    return out;
+})();
+/**
+ * Resolve a token (surface form, canonical name, alpha-2, or alpha-3) to a country. Case-insensitive.
+ * Returns null if unrecognized. Multi-word names ("United States", "Great Britain") must be passed as
+ * the whole phrase — the caller decides the span; this matches it.
+ */
+export function matchCountry(token) {
+    if (!token || typeof token !== "string")
+        return null;
+    const iso2 = COUNTRY_LOOKUP.get(token.trim().toLowerCase());
+    if (!iso2)
+        return null;
+    return { iso2, canonical: ISO2_TO_NAME.get(iso2), matched: token.trim() };
+}
+/** Case-insensitive check: is the token any recognized country form? */
+export function isCountryToken(token) {
+    return typeof token === "string" && COUNTRY_LOOKUP.has(token.trim().toLowerCase());
+}
+/** The preferred render forms for an alpha-2 (canonical first), for synth shards. Empty if none curated. */
+export function countrySurfaceForms(iso2) {
+    return COUNTRY_SURFACE_FORMS[iso2.toUpperCase()] ?? [];
+}
+export { CountryISO2, Alpha3ToCountryRecord };
+//# sourceMappingURL=country.js.map

package/out/country/country.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"country.js","sourceRoot":"","sources":["../../country/country.ts"],"names":[],"mappings":"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"}

package/out/country/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   ISO 3166-1 country reference + surface-form recognition (the `country` parity lever).
+ */
+export * from "./names.js";
+export * from "./codes.js";
+export * from "./country.js";
+//# sourceMappingURL=index.d.ts.map

package/out/country/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../country/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA"}

package/out/country/index.js

@@ -0,0 +1,11 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   ISO 3166-1 country reference + surface-form recognition (the `country` parity lever).
+ */
+export * from "./names.js";
+export * from "./codes.js";
+export * from "./country.js";
+//# sourceMappingURL=index.js.map

package/out/country/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../country/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA"}

package/out/country/names.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @copyright Sister Software (ISO 3166-1 data salvaged from isp-nexus)
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+/**
+ * List of all countries in the world.
+ *
+ * @category Geographic
+ * @internal
+ * @see https://en.wikipedia.org/wiki/List_of_countries
+ */
+export declare const CountryNames: readonly ["Afghanistan", "Albania", "Algeria", "American Samoa", "Andorra", "Angola", "Anguilla", "Antarctica", "Antigua and Barbuda", "Argentina", "Armenia", "Aruba", "Australia", "Austria", "Azerbaijan", "Bahamas", "Bahrain", "Bangladesh", "Barbados", "Belarus", "Belgium", "Belize", "Benin", "Bermuda", "Bhutan", "Bolivia", "Bonaire, Sint Eustatius and Saba", "Bosnia and Herzegovina", "Botswana", "Bouvet Island", "Brazil", "British Indian Ocean Territory", "Brunei Darussalam", "Bulgaria", "Burkina Faso", "Burundi", "Cambodia", "Cameroon", "Canada", "Cape Verde", "Cayman Islands", "Central African Republic", "Chad", "Chile", "China", "Christmas Island", "Cocos (Keeling) Islands", "Colombia", "Comoros", "Congo", "Congo, the Democratic Republic of the", "Cook Islands", "Costa Rica", "Cote DIvoire", "Croatia", "Cuba", "Curaçao", "Cyprus", "Czech Republic", "Denmark", "Djibouti", "Dominica", "Dominican Republic", "Ecuador", "Egypt", "El Salvador", "Equatorial Guinea", "Eritrea", "Estonia", "Ethiopia", "Falkland Islands (Malvinas)", "Faroe Islands", "Fiji", "Finland", "France", "French Guiana", "French Polynesia", "French Southern Territories", "Gabon", "Gambia", "Georgia", "Germany", "Ghana", "Gibraltar", "Greece", "Greenland", "Grenada", "Guadeloupe", "Guam", "Guatemala", "Guernsey", "Guinea", "Guinea-Bissau", "Guyana", "Haiti", "Heard Island and Mcdonald Islands", "Holy See (Vatican City State)", "Honduras", "Hong Kong", "Hungary", "Iceland", "India", "Indonesia", "Iran, Islamic Republic of", "Iraq", "Ireland", "Isle of Man", "Israel", "Italy", "Jamaica", "Japan", "Jersey", "Jordan", "Kazakhstan", "Kenya", "Kiribati", "Korea, Democratic People's Republic of", "Korea, Republic of", "Kuwait", "Kyrgyzstan", "Lao People's Democratic Republic", "Latvia", "Lebanon", "Lesotho", "Liberia", "Libya", "Liechtenstein", "Lithuania", "Luxembourg", "Macao", "Macedonia, the Former Yugoslav Republic of", "Madagascar", "Malawi", "Malaysia", "Maldives", "Mali", "Malta", "Marshall Islands", "Martinique", "Mauritania", "Mauritius", "Mayotte", "Mexico", "Micronesia, Federated States of", "Moldova, Republic of", "Monaco", "Mongolia", "Montenegro", "Montserrat", "Morocco", "Mozambique", "Myanmar", "Namibia", "Nauru", "Nepal", "Netherlands", "New Caledonia", "New Zealand", "Nicaragua", "Niger", "Nigeria", "Niue", "Norfolk Island", "Northern Mariana Islands", "Norway", "Oman", "Pakistan", "Palau", "Palestine, State of", "Panama", "Papua New Guinea", "Paraguay", "Peru", "Philippines", "Pitcairn", "Poland", "Portugal", "Puerto Rico", "Qatar", "Reunion", "Romania", "Russian Federation", "Rwanda", "Saint Barthélemy", "Saint Helena, Ascension and Tristan da Cunha", "Saint Kitts and Nevis", "Saint Lucia", "Saint Martin (French part)", "Saint Pierre and Miquelon", "Saint Vincent and the Grenadines", "Samoa", "San Marino", "Sao Tome and Principe", "Saudi Arabia", "Senegal", "Serbia", "Seychelles", "Sierra Leone", "Singapore", "Sint Maarten (Dutch part)", "Slovakia", "Slovenia", "Solomon Islands", "Somalia", "South Africa", "South Georgia and the South Sandwich Islands", "South Sudan", "Spain", "Sri Lanka", "Sudan", "Suriname", "Svalbard and Jan Mayen", "Swaziland", "Sweden", "Switzerland", "Syrian Arab Republic", "Taiwan (Province of China)", "Tajikistan", "Tanzania, United Republic of", "Thailand", "Timor-Leste", "Togo", "Tokelau", "Tonga", "Trinidad and Tobago", "Tunisia", "Turkey", "Turkmenistan", "Turks and Caicos Islands", "Tuvalu", "Uganda", "Ukraine", "United Arab Emirates", "United Kingdom", "United States", "United States Minor Outlying Islands", "Uruguay", "Uzbekistan", "Vanuatu", "Venezuela", "Viet Nam", "Virgin Islands (British)", "Virgin Islands (U.S.)", "Wallis and Futuna", "Western Sahara", "Yemen", "Zambia", "Zimbabwe", "Åland Islands"];
+/**
+ * Name of a country in the world.
+ *
+ * @category Geographic
+ * @category Country
+ * @title Country Name
+ * @public
+ */
+export type CountryName = (typeof CountryNames)[number];
+//# sourceMappingURL=names.d.ts.map

package/out/country/names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"names.d.ts","sourceRoot":"","sources":["../../country/names.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,4sHA0Pa,CAAA;AAEtC;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA"}

package/out/country/names.js

@@ -0,0 +1,264 @@
+/**
+ * @copyright Sister Software (ISO 3166-1 data salvaged from isp-nexus)
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+/**
+ * List of all countries in the world.
+ *
+ * @category Geographic
+ * @internal
+ * @see https://en.wikipedia.org/wiki/List_of_countries
+ */
+export const CountryNames = [
+    "Afghanistan",
+    "Albania",
+    "Algeria",
+    "American Samoa",
+    "Andorra",
+    "Angola",
+    "Anguilla",
+    "Antarctica",
+    "Antigua and Barbuda",
+    "Argentina",
+    "Armenia",
+    "Aruba",
+    "Australia",
+    "Austria",
+    "Azerbaijan",
+    "Bahamas",
+    "Bahrain",
+    "Bangladesh",
+    "Barbados",
+    "Belarus",
+    "Belgium",
+    "Belize",
+    "Benin",
+    "Bermuda",
+    "Bhutan",
+    "Bolivia",
+    "Bonaire, Sint Eustatius and Saba",
+    "Bosnia and Herzegovina",
+    "Botswana",
+    "Bouvet Island",
+    "Brazil",
+    "British Indian Ocean Territory",
+    "Brunei Darussalam",
+    "Bulgaria",
+    "Burkina Faso",
+    "Burundi",
+    "Cambodia",
+    "Cameroon",
+    "Canada",
+    "Cape Verde",
+    "Cayman Islands",
+    "Central African Republic",
+    "Chad",
+    "Chile",
+    "China",
+    "Christmas Island",
+    "Cocos (Keeling) Islands",
+    "Colombia",
+    "Comoros",
+    "Congo",
+    "Congo, the Democratic Republic of the",
+    "Cook Islands",
+    "Costa Rica",
+    "Cote DIvoire",
+    "Croatia",
+    "Cuba",
+    "Curaçao",
+    "Cyprus",
+    "Czech Republic",
+    "Denmark",
+    "Djibouti",
+    "Dominica",
+    "Dominican Republic",
+    "Ecuador",
+    "Egypt",
+    "El Salvador",
+    "Equatorial Guinea",
+    "Eritrea",
+    "Estonia",
+    "Ethiopia",
+    "Falkland Islands (Malvinas)",
+    "Faroe Islands",
+    "Fiji",
+    "Finland",
+    "France",
+    "French Guiana",
+    "French Polynesia",
+    "French Southern Territories",
+    "Gabon",
+    "Gambia",
+    "Georgia",
+    "Germany",
+    "Ghana",
+    "Gibraltar",
+    "Greece",
+    "Greenland",
+    "Grenada",
+    "Guadeloupe",
+    "Guam",
+    "Guatemala",
+    "Guernsey",
+    "Guinea",
+    "Guinea-Bissau",
+    "Guyana",
+    "Haiti",
+    "Heard Island and Mcdonald Islands",
+    "Holy See (Vatican City State)",
+    "Honduras",
+    "Hong Kong",
+    "Hungary",
+    "Iceland",
+    "India",
+    "Indonesia",
+    "Iran, Islamic Republic of",
+    "Iraq",
+    "Ireland",
+    "Isle of Man",
+    "Israel",
+    "Italy",
+    "Jamaica",
+    "Japan",
+    "Jersey",
+    "Jordan",
+    "Kazakhstan",
+    "Kenya",
+    "Kiribati",
+    "Korea, Democratic People's Republic of",
+    "Korea, Republic of",
+    "Kuwait",
+    "Kyrgyzstan",
+    "Lao People's Democratic Republic",
+    "Latvia",
+    "Lebanon",
+    "Lesotho",
+    "Liberia",
+    "Libya",
+    "Liechtenstein",
+    "Lithuania",
+    "Luxembourg",
+    "Macao",
+    "Macedonia, the Former Yugoslav Republic of",
+    "Madagascar",
+    "Malawi",
+    "Malaysia",
+    "Maldives",
+    "Mali",
+    "Malta",
+    "Marshall Islands",
+    "Martinique",
+    "Mauritania",
+    "Mauritius",
+    "Mayotte",
+    "Mexico",
+    "Micronesia, Federated States of",
+    "Moldova, Republic of",
+    "Monaco",
+    "Mongolia",
+    "Montenegro",
+    "Montserrat",
+    "Morocco",
+    "Mozambique",
+    "Myanmar",
+    "Namibia",
+    "Nauru",
+    "Nepal",
+    "Netherlands",
+    "New Caledonia",
+    "New Zealand",
+    "Nicaragua",
+    "Niger",
+    "Nigeria",
+    "Niue",
+    "Norfolk Island",
+    "Northern Mariana Islands",
+    "Norway",
+    "Oman",
+    "Pakistan",
+    "Palau",
+    "Palestine, State of",
+    "Panama",
+    "Papua New Guinea",
+    "Paraguay",
+    "Peru",
+    "Philippines",
+    "Pitcairn",
+    "Poland",
+    "Portugal",
+    "Puerto Rico",
+    "Qatar",
+    "Reunion",
+    "Romania",
+    "Russian Federation",
+    "Rwanda",
+    "Saint Barthélemy",
+    "Saint Helena, Ascension and Tristan da Cunha",
+    "Saint Kitts and Nevis",
+    "Saint Lucia",
+    "Saint Martin (French part)",
+    "Saint Pierre and Miquelon",
+    "Saint Vincent and the Grenadines",
+    "Samoa",
+    "San Marino",
+    "Sao Tome and Principe",
+    "Saudi Arabia",
+    "Senegal",
+    "Serbia",
+    "Seychelles",
+    "Sierra Leone",
+    "Singapore",
+    "Sint Maarten (Dutch part)",
+    "Slovakia",
+    "Slovenia",
+    "Solomon Islands",
+    "Somalia",
+    "South Africa",
+    "South Georgia and the South Sandwich Islands",
+    "South Sudan",
+    "Spain",
+    "Sri Lanka",
+    "Sudan",
+    "Suriname",
+    "Svalbard and Jan Mayen",
+    "Swaziland",
+    "Sweden",
+    "Switzerland",
+    "Syrian Arab Republic",
+    "Taiwan (Province of China)",
+    "Tajikistan",
+    "Tanzania, United Republic of",
+    "Thailand",
+    "Timor-Leste",
+    "Togo",
+    "Tokelau",
+    "Tonga",
+    "Trinidad and Tobago",
+    "Tunisia",
+    "Turkey",
+    "Turkmenistan",
+    "Turks and Caicos Islands",
+    "Tuvalu",
+    "Uganda",
+    "Ukraine",
+    "United Arab Emirates",
+    "United Kingdom",
+    "United States",
+    "United States Minor Outlying Islands",
+    "Uruguay",
+    "Uzbekistan",
+    "Vanuatu",
+    "Venezuela",
+    "Viet Nam",
+    "Virgin Islands (British)",
+    "Virgin Islands (U.S.)",
+    "Wallis and Futuna",
+    "Western Sahara",
+    "Yemen",
+    "Zambia",
+    "Zimbabwe",
+    "Åland Islands",
+];
+//# sourceMappingURL=names.js.map

package/out/country/names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"names.js","sourceRoot":"","sources":["../../country/names.ts"],"names":[],"mappings":"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"}

package/out/us/index.d.ts

@@ -6,7 +6,9 @@
  *   The United States address system (USPS): street suffixes, secondary unit designators, ZIP codes,
  *   and the state abbreviations they hang off of.
  */
+export * from "./po-box.js";
 export * from "./state.js";
+export * from "./street-directional.js";
 export * from "./street-suffix.js";
 export * from "./unit-designator.js";
 export * from "./zipcode.js";

package/out/us/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../us/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,YAAY,CAAA;AAC1B,cAAc,oBAAoB,CAAA;AAClC,cAAc,sBAAsB,CAAA;AACpC,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../us/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,yBAAyB,CAAA;AACvC,cAAc,oBAAoB,CAAA;AAClC,cAAc,sBAAsB,CAAA;AACpC,cAAc,cAAc,CAAA"}

package/out/us/index.js

@@ -6,7 +6,9 @@
  *   The United States address system (USPS): street suffixes, secondary unit designators, ZIP codes,
  *   and the state abbreviations they hang off of.
  */
+export * from "./po-box.js";
 export * from "./state.js";
+export * from "./street-directional.js";
 export * from "./street-suffix.js";
 export * from "./unit-designator.js";
 export * from "./zipcode.js";

package/out/us/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../us/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,YAAY,CAAA;AAC1B,cAAc,oBAAoB,CAAA;AAClC,cAAc,sBAAsB,CAAA;AACpC,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../us/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,yBAAyB,CAAA;AACvC,cAAc,oBAAoB,CAAA;AAClC,cAAc,sBAAsB,CAAA;AACpC,cAAc,cAAc,CAAA"}

package/out/us/po-box.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   USPS PO Box recognition + normalization to the surface forms that actually occur
+ *   (case-insensitive, punctuated "P.O. Box", spelled-out "Post Office Box", bare "Box"). A PO box
+ *   isn't a closed vocabulary like street suffixes — it's a designator phrase + a box id — so the
+ *   API is a detector ({@link isPOBox}), a normalizer ({@link normalizePOBox}), and an extractor
+ *   ({@link matchPOBox}) the corpus po_box synth/parsing can reuse instead of re-deriving the
+ *   regex.
+ * @see {@link https://pe.usps.com/text/pub28/28c2_012.htm USPS Pub 28 §29 (PO Box / Caller service)}
+ */
+/**
+ * USPS designator phrases that introduce a post-office-box identifier, longest-first so the matcher
+ * prefers the most specific phrase ("Post Office Box" before "Box"). Each is matched
+ * case-insensitively with flexible internal punctuation/spacing.
+ */
+export declare const US_PO_BOX_DESIGNATORS: readonly ["POST OFFICE BOX", "PO BOX", "P O BOX", "FIRM CALLER", "CALLER", "DRAWER", "LOCKBOX", "BOX"];
+export type UsPoBoxDesignator = (typeof US_PO_BOX_DESIGNATORS)[number];
+/**
+ * Type-predicate: does the input look like a standalone PO Box address? Case-insensitive and
+ * tolerant of "P.O. Box", "Post Office Box", "Box 12", "PMB"-style ids. (Widens the original
+ * isp-nexus `/^PO BOX [\d-]+$/`, which only matched all-caps "PO BOX 123".)
+ */
+export declare function isPOBox(input: unknown): boolean;
+/** Result of a PO-box parse: the matched designator phrase and the box identifier. */
+export interface PoBoxMatch {
+    /** The designator phrase as it appeared, e.g. "P.O. Box", "Post Office Box". */
+    matched: string;
+    /** The box identifier, e.g. "123", "12-A". */
+    id: string;
+}
+/**
+ * If `input` is a PO-box phrase ("PO Box 123", "P.O. Box 12-A", "Post Office Box 7"), return the
+ * designator phrase and the id. Null otherwise. Useful for the corpus po_box shard (split the
+ * designator from the number) and for resolver/parsing reuse.
+ */
+export declare function matchPOBox(input: unknown): PoBoxMatch | null;
+/**
+ * Normalize any recognized PO-box phrase to the canonical USPS "PO BOX <id>" form. Returns the
+ * input unchanged if it isn't a PO box. (Widens the original isp-nexus normalizer, which only
+ * collapsed the "P.O. BOX" spelling and left the id/casing alone.)
+ */
+export declare function normalizePOBox(input: string): string;
+//# sourceMappingURL=po-box.d.ts.map

package/out/us/po-box.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"po-box.d.ts","sourceRoot":"","sources":["../../us/po-box.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,wGASI,CAAA;AAEtC,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAA;AAOtE;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE/C;AAED,sFAAsF;AACtF,MAAM,WAAW,UAAU;IAC1B,gFAAgF;IAChF,OAAO,EAAE,MAAM,CAAA;IACf,8CAA8C;IAC9C,EAAE,EAAE,MAAM,CAAA;CACV;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,GAAG,IAAI,CAO5D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIpD"}

package/out/us/po-box.js

@@ -0,0 +1,66 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   USPS PO Box recognition + normalization to the surface forms that actually occur
+ *   (case-insensitive, punctuated "P.O. Box", spelled-out "Post Office Box", bare "Box"). A PO box
+ *   isn't a closed vocabulary like street suffixes — it's a designator phrase + a box id — so the
+ *   API is a detector ({@link isPOBox}), a normalizer ({@link normalizePOBox}), and an extractor
+ *   ({@link matchPOBox}) the corpus po_box synth/parsing can reuse instead of re-deriving the
+ *   regex.
+ * @see {@link https://pe.usps.com/text/pub28/28c2_012.htm USPS Pub 28 §29 (PO Box / Caller service)}
+ */
+/**
+ * USPS designator phrases that introduce a post-office-box identifier, longest-first so the matcher
+ * prefers the most specific phrase ("Post Office Box" before "Box"). Each is matched
+ * case-insensitively with flexible internal punctuation/spacing.
+ */
+export const US_PO_BOX_DESIGNATORS = [
+    "POST OFFICE BOX",
+    "PO BOX",
+    "P O BOX",
+    "FIRM CALLER",
+    "CALLER",
+    "DRAWER",
+    "LOCKBOX",
+    "BOX",
+];
+// Matches a leading PO-box designator + its identifier. Allows "P.O. Box", "PO BOX", "Post Office
+// Box", "Box 12-A", etc. The id is alphanumeric with optional dashes (USPS caller/firm ids exist).
+const PO_BOX_RE = /^\s*(?:(p\.?\s*o\.?\s*box)|(post\s+office\s+box)|(firm\s+caller)|(caller)|(drawer)|(lockbox)|(box))\s*#?\s*([\dA-Za-z][\dA-Za-z-]*)\s*$/i;
+/**
+ * Type-predicate: does the input look like a standalone PO Box address? Case-insensitive and
+ * tolerant of "P.O. Box", "Post Office Box", "Box 12", "PMB"-style ids. (Widens the original
+ * isp-nexus `/^PO BOX [\d-]+$/`, which only matched all-caps "PO BOX 123".)
+ */
+export function isPOBox(input) {
+    return typeof input === "string" && PO_BOX_RE.test(input);
+}
+/**
+ * If `input` is a PO-box phrase ("PO Box 123", "P.O. Box 12-A", "Post Office Box 7"), return the
+ * designator phrase and the id. Null otherwise. Useful for the corpus po_box shard (split the
+ * designator from the number) and for resolver/parsing reuse.
+ */
+export function matchPOBox(input) {
+    if (typeof input !== "string")
+        return null;
+    const m = PO_BOX_RE.exec(input);
+    if (!m)
+        return null;
+    const matched = (m[1] ?? m[2] ?? m[3] ?? m[4] ?? m[5] ?? m[6] ?? m[7] ?? "").trim();
+    const id = m[8];
+    return { matched, id };
+}
+/**
+ * Normalize any recognized PO-box phrase to the canonical USPS "PO BOX <id>" form. Returns the
+ * input unchanged if it isn't a PO box. (Widens the original isp-nexus normalizer, which only
+ * collapsed the "P.O. BOX" spelling and left the id/casing alone.)
+ */
+export function normalizePOBox(input) {
+    const m = matchPOBox(input);
+    if (!m)
+        return input;
+    return `PO BOX ${m.id.toUpperCase()}`;
+}
+//# sourceMappingURL=po-box.js.map

package/out/us/po-box.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"po-box.js","sourceRoot":"","sources":["../../us/po-box.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACpC,iBAAiB;IACjB,QAAQ;IACR,SAAS;IACT,aAAa;IACb,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,KAAK;CACgC,CAAA;AAItC,kGAAkG;AAClG,mGAAmG;AACnG,MAAM,SAAS,GACd,0IAA0I,CAAA;AAE3I;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;AAC1D,CAAC;AAUD;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,KAAc;IACxC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAA;IAC1C,MAAM,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC/B,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAA;IACnB,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;IACnF,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAA;IAChB,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAA;AACvB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa;IAC3C,MAAM,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,CAAA;IAC3B,IAAI,CAAC,CAAC;QAAE,OAAO,KAAK,CAAA;IACpB,OAAO,UAAU,CAAC,CAAC,EAAE,CAAC,WAAW,EAAE,EAAE,CAAA;AACtC,CAAC"}