@mailwoman/codex 4.4.0 → 4.5.0

package/out/us/floor-designator.js

@@ -0,0 +1,84 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   USPS Publication 28, Appendix C2 — Floor-class Secondary Unit Designators.
+ *
+ *   The sibling of {@link ./unit-designator.ts}: where the unit table covers the full secondary-unit
+ *   vocabulary (APT, STE, RM, …), this module extracts the floor-class subset — designators that
+ *   name a FLOOR or LEVEL of the building rather than a specific addressable unit on that floor.
+ *   USPS Pub 28 Appendix C2 identifies these designators as requiring a secondary number: "FL" (the
+ *   approved abbreviation for FLOOR). The publication gives `FLOOR` as the canonical designator
+ *   with approved abbreviation `FL` and variant `FLR`; `BASEMENT` (`BSMT`), `PENTHOUSE` (`PH`), and
+ *   `LOBBY` (`LBBY`) are the standalone-or-numbered floor-adjacent types also listed in Appendix
+ *   C2.
+ *
+ *   Appendix C2 explicitly marks FLOOR, BASEMENT as requiring a secondary number (alongside APT,
+ *   BLDG, etc.) while PENTHOUSE and LOBBY may stand alone. PH and LBBY are kept here (not just in
+ *   {@link ./unit-designator.ts}) because the span proposer treats them as level-class hints —
+ *   "LOBBY" and "PH" name a specific floor-analog, not a numbered unit, and the prior map routes
+ *   `LEVEL_PHRASE` → `unit` (the schema carries no separate `level` tag).
+ *
+ *   This table drives the `levelDesignators` set in the span-proposer lexicon. The full
+ *   secondary-unit designators (APT, STE, RM, …) remain in {@link ./unit-designator.ts}.
+ *
+ *   Data is verbatim USPS Pub 28 Appendix C2.
+ * @see {@link https://pe.usps.com/text/pub28/28apc_003.htm USPS Publication 28 — Appendix C2: Secondary Unit Designators}
+ */
+/**
+ * USPS Pub 28 C2 floor-class secondary unit designators. Verbatim from the publication; see the
+ * module header for the per-row provenance. Ordered with the most-common numbered form first.
+ */
+export const US_FLOOR_DESIGNATORS = [
+    { name: "FLOOR", abbreviation: "FL", variants: ["FLR"], requiresNumber: true },
+    { name: "BASEMENT", abbreviation: "BSMT", variants: [], requiresNumber: true },
+    { name: "PENTHOUSE", abbreviation: "PH", variants: [], requiresNumber: false },
+    { name: "LOBBY", abbreviation: "LBBY", variants: [], requiresNumber: false },
+];
+/**
+ * Inverse lookup: every surface form (canonical name, approved abbreviation, or Appendix C2
+ * variant) → its canonical designator name. Lowercase-keyed for case-insensitive matching: `"fl"` →
+ * `"FLOOR"`, `"bsmt"` → `"BASEMENT"`, `"ph"` → `"PENTHOUSE"`.
+ */
+export const US_FLOOR_DESIGNATOR_LOOKUP = (() => {
+    const out = new Map();
+    for (const row of US_FLOOR_DESIGNATORS) {
+        out.set(row.name.toLowerCase(), row.name);
+        out.set(row.abbreviation.toLowerCase(), row.name);
+        for (const v of row.variants) {
+            if (!out.has(v.toLowerCase()))
+                out.set(v.toLowerCase(), row.name);
+        }
+    }
+    return out;
+})();
+/**
+ * All lowercase surface tokens for the floor-class designators — the set the span proposer
+ * populates `levelDesignators` with when wiring the US codex slice. Includes canonical names,
+ * approved abbreviations, and Appendix C2 variants.
+ */
+export const US_FLOOR_DESIGNATOR_TOKENS = new Set(US_FLOOR_DESIGNATOR_LOOKUP.keys());
+/** Approved USPS abbreviation per canonical floor designator name. */
+export const US_FLOOR_DESIGNATOR_PREFERRED_ABBR = Object.fromEntries(US_FLOOR_DESIGNATORS.map((r) => [r.name, r.abbreviation]));
+/**
+ * Look up a USPS floor-class designator (by canonical name, abbreviation, or any Appendix C2
+ * variant) and return the canonical name + approved abbreviation. Returns null if the token isn't a
+ * recognized floor-class designator.
+ */
+export function lookupFloorDesignator(input) {
+    if (!input || typeof input !== "string")
+        return null;
+    const designator = US_FLOOR_DESIGNATOR_LOOKUP.get(input.trim().toLowerCase());
+    if (!designator)
+        return null;
+    return { designator, abbreviation: US_FLOOR_DESIGNATOR_PREFERRED_ABBR[designator] };
+}
+/**
+ * True when a token is a recognized USPS floor-class secondary unit designator (case-insensitive) —
+ * `"Floor"`, `"FL"`, `"flr"`, `"bsmt"`, `"ph"`, `"lbby"`.
+ */
+export function isFloorDesignatorToken(input) {
+    return typeof input === "string" && US_FLOOR_DESIGNATOR_LOOKUP.has(input.trim().toLowerCase());
+}
+//# sourceMappingURL=floor-designator.js.map

package/out/us/floor-designator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"floor-designator.js","sourceRoot":"","sources":["../../us/floor-designator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAuBH;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IACnC,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,KAAK,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE;IAC9E,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE;IAC9E,EAAE,IAAI,EAAE,WAAW,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE;IAC9E,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE;CAC5B,CAAA;AAKjD;;;;GAIG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAA+C,CAAC,GAAG,EAAE;IAC3F,MAAM,GAAG,GAAG,IAAI,GAAG,EAAiC,CAAA;IACpD,KAAK,MAAM,GAAG,IAAI,oBAAoB,EAAE,CAAC;QACxC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,GAAG,CAAC,IAAI,CAAC,CAAA;QACzC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,WAAW,EAAE,EAAE,GAAG,CAAC,IAAI,CAAC,CAAA;QACjD,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;YAC9B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;gBAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,GAAG,CAAC,IAAI,CAAC,CAAA;QAClE,CAAC;IACF,CAAC;IACD,OAAO,GAAG,CAAA;AACX,CAAC,CAAC,EAAE,CAAA;AAEJ;;;;GAIG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAwB,IAAI,GAAG,CAAC,0BAA0B,CAAC,IAAI,EAAE,CAAC,CAAA;AAEzG,sEAAsE;AACtE,MAAM,CAAC,MAAM,kCAAkC,GAAoD,MAAM,CAAC,WAAW,CACpH,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CACN,CAAA;AAEpD;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAgC;IAIrE,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAA;IACpD,MAAM,UAAU,GAAG,0BAA0B,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAA;IAC7E,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAA;IAC5B,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,kCAAkC,CAAC,UAAU,CAAC,EAAE,CAAA;AACpF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAc;IACpD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,0BAA0B,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAA;AAC/F,CAAC"}

package/out/us/index.d.ts

@@ -3,9 +3,13 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- *   The United States address system (USPS): street suffixes, secondary unit designators, ZIP codes,
- *   and the state abbreviations they hang off of.
+ *   The United States address system (USPS): street suffixes, secondary unit designators, floor-class
+ *   designators (USPS Pub 28 C2 floor/level subset), military/diplomatic post office designators
+ *   (USPS Pub 28 Chapter 7: APO/FPO/DPO + PSC/CMR/UNIT), ZIP codes, and the state abbreviations
+ *   they hang off of.
  */
+export * from "./floor-designator.js";
+export * from "./military-address.js";
 export * from "./po-box.js";
 export * from "./state.js";
 export * from "./street-directional.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,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,yBAAyB,CAAA;AACvC,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;;;;;;;;;GASG;AAEH,cAAc,uBAAuB,CAAA;AACrC,cAAc,uBAAuB,CAAA;AACrC,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

@@ -3,9 +3,13 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- *   The United States address system (USPS): street suffixes, secondary unit designators, ZIP codes,
- *   and the state abbreviations they hang off of.
+ *   The United States address system (USPS): street suffixes, secondary unit designators, floor-class
+ *   designators (USPS Pub 28 C2 floor/level subset), military/diplomatic post office designators
+ *   (USPS Pub 28 Chapter 7: APO/FPO/DPO + PSC/CMR/UNIT), ZIP codes, and the state abbreviations
+ *   they hang off of.
  */
+export * from "./floor-designator.js";
+export * from "./military-address.js";
 export * from "./po-box.js";
 export * from "./state.js";
 export * from "./street-directional.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,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,yBAAyB,CAAA;AACvC,cAAc,oBAAoB,CAAA;AAClC,cAAc,sBAAsB,CAAA;AACpC,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../us/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,uBAAuB,CAAA;AACrC,cAAc,uBAAuB,CAAA;AACrC,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/military-address.d.ts

@@ -0,0 +1,143 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   USPS Publication 28 — Military / Diplomatic Post Office designators.
+ *
+ *   Military and diplomatic overseas addresses use a distinct addressing scheme: instead of a city
+ *   name, a standardized location-class code (APO, FPO, DPO) appears on the city line, followed by
+ *   the armed-forces "state" code (AA, AE, AP) and a 09xxx ZIP code. The unit/PSC/CMR line
+ *   appearing above the city line identifies the specific installation unit, postal service center,
+ *   or community mail room.
+ *
+ *   Sourcing (accessed 2026-06-12):
+ *
+ *   - **USPS Publication 28, Chapter 7** ("Armed Forces and Diplomatic Post Offices") defines the three
+ *       armed-forces location codes and three state-code regions, and states: "Use APO with AA
+ *       (Americas), AE (Europe/Middle East/Africa/Canada), or AP (Pacific)"; "FPO (Fleet Post
+ *       Office) for Navy ships and shore installations"; "DPO (Diplomatic Post Office) for US
+ *       embassies and missions." Full URL: https://pe.usps.com/text/pub28/28c7_001.htm
+ *   - **USPS Publication 28, Appendix B** gives the complete list of accepted unit-line formats: `UNIT
+ *       <id>`, `PSC <id> BOX <box>`, `CMR <id> BOX <box>`, and `UNIT <id> BOX <box>`. The same
+ *       appendix notes the two-digit unit ranges for PSC/CMR/UNIT assignment by theater. Full URL:
+ *       https://pe.usps.com/text/pub28/28apb_001.htm
+ *   - The **Armed Forces "state" codes** (AA, AE, AP) are defined in the same USPS appendix and are
+ *       also the official USPS abbreviations for the three Armed Forces addressing regions. See:
+ *       https://pe.usps.com/text/pub28/28apb_002.htm
+ *   - "DPO" for Diplomatic Post Offices was added as a distinct code in 2011 (USPS Customer/ Industry
+ *       Notice 61). It does NOT replace APO in diplomatic mail — both exist, with DPO used
+ *       specifically for State Department overseas posts and APO/FPO retained for DoD.
+ *
+ * @see {@link https://pe.usps.com/text/pub28/28c7_001.htm USPS Pub 28 Chapter 7 — Military Addresses}
+ * @see {@link https://pe.usps.com/text/pub28/28apb_001.htm USPS Pub 28 Appendix B — Armed Forces Addresses}
+ */
+/** USPS military / diplomatic post-office location codes (the "city" substitute on the city line). */
+export declare const US_MILITARY_POST_OFFICE_CODES: readonly [{
+    readonly code: "APO";
+    readonly name: "Army Post Office";
+    readonly armedForces: true;
+}, {
+    readonly code: "FPO";
+    readonly name: "Fleet Post Office";
+    readonly armedForces: true;
+}, {
+    readonly code: "DPO";
+    readonly name: "Diplomatic Post Office";
+    readonly armedForces: false;
+}];
+export type UsMilitaryPostOfficeCode = (typeof US_MILITARY_POST_OFFICE_CODES)[number]["code"];
+/**
+ * USPS Armed Forces "state" codes used in place of state names on military/diplomatic addresses.
+ * These appear where a US state abbreviation (NY, CA, …) would appear in a civilian address.
+ */
+export declare const US_ARMED_FORCES_REGIONS: readonly [{
+    readonly code: "AA";
+    readonly name: "Armed Forces Americas";
+    readonly description: "Americas (excluding Canada)";
+}, {
+    readonly code: "AE";
+    readonly name: "Armed Forces Europe";
+    readonly description: "Europe, Middle East, Africa, and Canada";
+}, {
+    readonly code: "AP";
+    readonly name: "Armed Forces Pacific";
+    readonly description: "Pacific";
+}];
+export type UsArmedForcesRegionCode = (typeof US_ARMED_FORCES_REGIONS)[number]["code"];
+/**
+ * USPS Pub 28 Appendix B unit-line designators for military/diplomatic overseas addresses. Each
+ * designator introduces an installation identifier and optionally a box number.
+ *
+ * Format rules per Appendix B:
+ *
+ * - `PSC <id> BOX <box>` — Postal Service Center
+ * - `CMR <id> BOX <box>` — Community Mail Room
+ * - `UNIT <id> BOX <box>` — numbered unit (battalion/company); UNIT may stand alone with just an id
+ *   and no BOX when the unit has direct mail delivery
+ *
+ * BOX is required for PSC and CMR; UNIT may omit BOX.
+ */
+export declare const US_MILITARY_UNIT_DESIGNATORS: readonly [{
+    readonly code: "PSC";
+    readonly name: "Postal Service Center";
+    readonly requiresBox: true;
+    readonly description: "Installation-level postal service center; format: PSC <id> BOX <box>";
+}, {
+    readonly code: "CMR";
+    readonly name: "Community Mail Room";
+    readonly requiresBox: true;
+    readonly description: "Sub-installation mail room; format: CMR <id> BOX <box>";
+}, {
+    readonly code: "UNIT";
+    readonly name: "Unit";
+    readonly requiresBox: false;
+    readonly description: "Numbered military unit (battalion/company); format: UNIT <id> [BOX <box>]";
+}];
+export type UsMilitaryUnitDesignatorCode = (typeof US_MILITARY_UNIT_DESIGNATORS)[number]["code"];
+/** Result of a military address line parse (the unit line: PSC/CMR/UNIT). */
+export interface UsMilitaryUnitMatch {
+    /** The designator as it appeared ("PSC", "CMR", "Unit"). */
+    matched: string;
+    /** The canonical designator code ("PSC", "CMR", "UNIT"). */
+    code: UsMilitaryUnitDesignatorCode;
+    /** The installation identifier ("1520", "453"). */
+    id: string;
+    /** The box number when present ("4620", "1234A"). */
+    box?: string;
+}
+/**
+ * If `input` is a USPS military unit-line ("PSC 1520 BOX 4620", "CMR 453 BOX 100", "UNIT 7 BOX
+ * 234A", "UNIT 7"), return the canonical designator, installation id, and optional box. Null
+ * otherwise. Throws on a PSC or CMR line without a BOX component (per Appendix B, BOX is required
+ * for PSC/CMR; a bare "PSC 1520" is malformed).
+ */
+export declare function matchMilitaryUnitLine(input: unknown): UsMilitaryUnitMatch | null;
+/** Type-predicate: does the input look like a USPS military unit line (PSC/CMR/UNIT)? */
+export declare function isMilitaryUnitLine(input: unknown): boolean;
+/** Result of a military city-line parse (APO/FPO/DPO + region code + ZIP). */
+export interface UsMilitaryCityMatch {
+    /** The post-office code as it appeared ("APO", "FPO", "DPO"). */
+    matched: string;
+    /** The canonical post-office code. */
+    code: UsMilitaryPostOfficeCode;
+    /** The Armed Forces region code ("AA", "AE", "AP"). */
+    region: UsArmedForcesRegionCode;
+    /**
+     * The 5-digit or 9-digit ZIP code. Typical ranges per Pub 28: 09xxx (AE), 34xxx (AA), 96xxx (AP)
+     * — range validation per region is caller responsibility.
+     */
+    zip: string;
+}
+/**
+ * If `input` is a USPS military city line ("APO AE 09165", "FPO AP 96602-1254", "DPO AE 09498",
+ * "APO AA 34022", "APO AP 96525"), return the canonical code, region, and ZIP. Null otherwise.
+ *
+ * ZIP ranges per Pub 28: AE (Europe/ME/Africa/Canada) → 09xxx; AP (Pacific) → 96xxx; AA (Americas)
+ * → 34xxx. Range validation per region is left to the caller; the matcher accepts any 5. or 9-digit
+ * ZIP paired with a valid region code.
+ */
+export declare function matchMilitaryCityLine(input: unknown): UsMilitaryCityMatch | null;
+/** Type-predicate: does the input look like a USPS military city line (APO/FPO/DPO + region + ZIP)? */
+export declare function isMilitaryCityLine(input: unknown): boolean;
+//# sourceMappingURL=military-address.d.ts.map

package/out/us/military-address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"military-address.d.ts","sourceRoot":"","sources":["../../us/military-address.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,sGAAsG;AACtG,eAAO,MAAM,6BAA6B;;;;;;;;;;;;EAUhC,CAAA;AAEV,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,6BAA6B,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAA;AAE7F;;;GAGG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;EAI1B,CAAA;AAEV,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAA;AAEtF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;EAmB/B,CAAA;AAEV,MAAM,MAAM,4BAA4B,GAAG,CAAC,OAAO,4BAA4B,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAA;AAEhG,6EAA6E;AAC7E,MAAM,WAAW,mBAAmB;IACnC,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAA;IACf,4DAA4D;IAC5D,IAAI,EAAE,4BAA4B,CAAA;IAClC,mDAAmD;IACnD,EAAE,EAAE,MAAM,CAAA;IACV,qDAAqD;IACrD,GAAG,CAAC,EAAE,MAAM,CAAA;CACZ;AAMD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,GAAG,IAAI,CAehF;AAED,yFAAyF;AACzF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAM1D;AAED,8EAA8E;AAC9E,MAAM,WAAW,mBAAmB;IACnC,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAA;IACf,sCAAsC;IACtC,IAAI,EAAE,wBAAwB,CAAA;IAC9B,uDAAuD;IACvD,MAAM,EAAE,uBAAuB,CAAA;IAC/B;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAA;CACX;AAYD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,GAAG,IAAI,CAUhF;AAED,uGAAuG;AACvG,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE1D"}

package/out/us/military-address.js

@@ -0,0 +1,156 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   USPS Publication 28 — Military / Diplomatic Post Office designators.
+ *
+ *   Military and diplomatic overseas addresses use a distinct addressing scheme: instead of a city
+ *   name, a standardized location-class code (APO, FPO, DPO) appears on the city line, followed by
+ *   the armed-forces "state" code (AA, AE, AP) and a 09xxx ZIP code. The unit/PSC/CMR line
+ *   appearing above the city line identifies the specific installation unit, postal service center,
+ *   or community mail room.
+ *
+ *   Sourcing (accessed 2026-06-12):
+ *
+ *   - **USPS Publication 28, Chapter 7** ("Armed Forces and Diplomatic Post Offices") defines the three
+ *       armed-forces location codes and three state-code regions, and states: "Use APO with AA
+ *       (Americas), AE (Europe/Middle East/Africa/Canada), or AP (Pacific)"; "FPO (Fleet Post
+ *       Office) for Navy ships and shore installations"; "DPO (Diplomatic Post Office) for US
+ *       embassies and missions." Full URL: https://pe.usps.com/text/pub28/28c7_001.htm
+ *   - **USPS Publication 28, Appendix B** gives the complete list of accepted unit-line formats: `UNIT
+ *       <id>`, `PSC <id> BOX <box>`, `CMR <id> BOX <box>`, and `UNIT <id> BOX <box>`. The same
+ *       appendix notes the two-digit unit ranges for PSC/CMR/UNIT assignment by theater. Full URL:
+ *       https://pe.usps.com/text/pub28/28apb_001.htm
+ *   - The **Armed Forces "state" codes** (AA, AE, AP) are defined in the same USPS appendix and are
+ *       also the official USPS abbreviations for the three Armed Forces addressing regions. See:
+ *       https://pe.usps.com/text/pub28/28apb_002.htm
+ *   - "DPO" for Diplomatic Post Offices was added as a distinct code in 2011 (USPS Customer/ Industry
+ *       Notice 61). It does NOT replace APO in diplomatic mail — both exist, with DPO used
+ *       specifically for State Department overseas posts and APO/FPO retained for DoD.
+ *
+ * @see {@link https://pe.usps.com/text/pub28/28c7_001.htm USPS Pub 28 Chapter 7 — Military Addresses}
+ * @see {@link https://pe.usps.com/text/pub28/28apb_001.htm USPS Pub 28 Appendix B — Armed Forces Addresses}
+ */
+/** USPS military / diplomatic post-office location codes (the "city" substitute on the city line). */
+export const US_MILITARY_POST_OFFICE_CODES = [
+    /**
+     * Army Post Office — domestic USPS gateway for Army and Air Force overseas mail; also used for
+     * some diplomatic addresses (DPO is preferred for State Dept posts since 2011).
+     */
+    { code: "APO", name: "Army Post Office", armedForces: true },
+    /** Fleet Post Office — Navy ships and shore installations. */
+    { code: "FPO", name: "Fleet Post Office", armedForces: true },
+    /** Diplomatic Post Office — US embassies and missions (added 2011). */
+    { code: "DPO", name: "Diplomatic Post Office", armedForces: false },
+];
+/**
+ * USPS Armed Forces "state" codes used in place of state names on military/diplomatic addresses.
+ * These appear where a US state abbreviation (NY, CA, …) would appear in a civilian address.
+ */
+export const US_ARMED_FORCES_REGIONS = [
+    { code: "AA", name: "Armed Forces Americas", description: "Americas (excluding Canada)" },
+    { code: "AE", name: "Armed Forces Europe", description: "Europe, Middle East, Africa, and Canada" },
+    { code: "AP", name: "Armed Forces Pacific", description: "Pacific" },
+];
+/**
+ * USPS Pub 28 Appendix B unit-line designators for military/diplomatic overseas addresses. Each
+ * designator introduces an installation identifier and optionally a box number.
+ *
+ * Format rules per Appendix B:
+ *
+ * - `PSC <id> BOX <box>` — Postal Service Center
+ * - `CMR <id> BOX <box>` — Community Mail Room
+ * - `UNIT <id> BOX <box>` — numbered unit (battalion/company); UNIT may stand alone with just an id
+ *   and no BOX when the unit has direct mail delivery
+ *
+ * BOX is required for PSC and CMR; UNIT may omit BOX.
+ */
+export const US_MILITARY_UNIT_DESIGNATORS = [
+    {
+        code: "PSC",
+        name: "Postal Service Center",
+        requiresBox: true,
+        description: "Installation-level postal service center; format: PSC <id> BOX <box>",
+    },
+    {
+        code: "CMR",
+        name: "Community Mail Room",
+        requiresBox: true,
+        description: "Sub-installation mail room; format: CMR <id> BOX <box>",
+    },
+    {
+        code: "UNIT",
+        name: "Unit",
+        requiresBox: false,
+        description: "Numbered military unit (battalion/company); format: UNIT <id> [BOX <box>]",
+    },
+];
+// Unit-line regex: PSC/CMR/UNIT <id> [BOX <box>]
+// Identifiers are numeric; box numbers are alphanumeric. UNIT may stand without BOX.
+const UNIT_LINE_RE = /^\s*(psc|cmr|unit)\s+(\d+)(?:\s+box\s+([\dA-Za-z]+))?\s*$/i;
+/**
+ * If `input` is a USPS military unit-line ("PSC 1520 BOX 4620", "CMR 453 BOX 100", "UNIT 7 BOX
+ * 234A", "UNIT 7"), return the canonical designator, installation id, and optional box. Null
+ * otherwise. Throws on a PSC or CMR line without a BOX component (per Appendix B, BOX is required
+ * for PSC/CMR; a bare "PSC 1520" is malformed).
+ */
+export function matchMilitaryUnitLine(input) {
+    if (typeof input !== "string")
+        return null;
+    const m = UNIT_LINE_RE.exec(input);
+    if (!m)
+        return null;
+    const code = m[1].toUpperCase();
+    const id = m[2];
+    const box = m[3];
+    const row = US_MILITARY_UNIT_DESIGNATORS.find((r) => r.code === code);
+    if (row.requiresBox && !box) {
+        throw new Error(`[codex/us/military-address] ${code} line requires a BOX component per USPS Pub 28 Appendix B; got bare "${input.trim()}"`);
+    }
+    return { matched: m[1], code, id, ...(box ? { box } : {}) };
+}
+/** Type-predicate: does the input look like a USPS military unit line (PSC/CMR/UNIT)? */
+export function isMilitaryUnitLine(input) {
+    try {
+        return matchMilitaryUnitLine(input) !== null;
+    }
+    catch {
+        return false; // PSC/CMR without BOX is structurally malformed (not a false negative)
+    }
+}
+// City-line regex: APO/FPO/DPO <region> <zip>
+// USPS military ZIP assignment per Pub 28 and the Armed Forces zip code list:
+//   - AA (Americas): 340xx range
+//   - AE (Europe/ME/Africa/Canada): 09xxx range
+//   - AP (Pacific): 962xx-966xx range
+// The regex accepts any 5-digit or 9-digit ZIP code in combination with a valid region code —
+// validating the specific numeric range for each region is left to the caller (region+ZIP
+// co-validation is operational policy, not structural syntax).
+const CITY_LINE_RE = /^\s*(apo|fpo|dpo)\s+(aa|ae|ap)\s+(\d{5}(?:-\d{4})?)\s*$/i;
+/**
+ * If `input` is a USPS military city line ("APO AE 09165", "FPO AP 96602-1254", "DPO AE 09498",
+ * "APO AA 34022", "APO AP 96525"), return the canonical code, region, and ZIP. Null otherwise.
+ *
+ * ZIP ranges per Pub 28: AE (Europe/ME/Africa/Canada) → 09xxx; AP (Pacific) → 96xxx; AA (Americas)
+ * → 34xxx. Range validation per region is left to the caller; the matcher accepts any 5. or 9-digit
+ * ZIP paired with a valid region code.
+ */
+export function matchMilitaryCityLine(input) {
+    if (typeof input !== "string")
+        return null;
+    const m = CITY_LINE_RE.exec(input);
+    if (!m)
+        return null;
+    return {
+        matched: m[1].toUpperCase(),
+        code: m[1].toUpperCase(),
+        region: m[2].toUpperCase(),
+        zip: m[3],
+    };
+}
+/** Type-predicate: does the input look like a USPS military city line (APO/FPO/DPO + region + ZIP)? */
+export function isMilitaryCityLine(input) {
+    return matchMilitaryCityLine(input) !== null;
+}
+//# sourceMappingURL=military-address.js.map

package/out/us/military-address.js.map

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

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

@@ -96,7 +96,9 @@ export declare function renderDirectional(match: {
     canonical: DirectionalName;
     abbreviation: DirectionalAbbreviation;
 }, form: "abbr" | "full", reference: string): string;
-/** Case-insensitive check: is the token any USPS directional or abbreviation (`"N"`, `"north"`,
-`"NW"`)? */
+/**
+ * Case-insensitive check: is the token any USPS directional or abbreviation (`"N"`, `"north"`,
+ * `"NW"`)?
+ */
 export declare function isStreetDirectionalToken(input: unknown): boolean;
 //# sourceMappingURL=street-directional.d.ts.map

package/out/us/street-directional.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"street-directional.d.ts","sourceRoot":"","sources":["../../us/street-directional.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH;;;GAGG;AACH,oBAAY,uBAAuB;IAClC,KAAK,MAAM;IACX,IAAI,MAAM;IACV,KAAK,MAAM;IACX,IAAI,MAAM;IACV,SAAS,OAAO;IAChB,SAAS,OAAO;IAChB,SAAS,OAAO;IAChB,SAAS,OAAO;CAChB;AAED,iGAAiG;AACjG,eAAO,MAAM,gBAAgB,qGASS,CAAA;AAEtC,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE/D,eAAO,MAAM,yBAAyB,mZA6BA,CAAA;AAEtC,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEjF,gCAAgC;AAChC,eAAO,MAAM,6BAA6B;;;;;;;;;CAS2B,CAAA;AAErE,MAAM,MAAM,6BAA6B,GAAG,OAAO,6BAA6B,CAAA;AAEhF,gDAAgD;AAChD,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;CAa6B,CAAA;AAErE,MAAM,MAAM,2BAA2B,GAAG,OAAO,2BAA2B,CAAA;AAE5E,yDAAyD;AACzD,eAAO,MAAM,yBAAyB,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAE1E,CAAA;AAED,oDAAoD;AACpD,eAAO,MAAM,4BAA4B,EAAE,WAAW,CAAC,MAAM,EAAE,uBAAuB,CAErF,CAAA;AAED,+FAA+F;AAC/F,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,GAAG,IAAI,CAG3E;AAED,0FAA0F;AAC1F,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,uBAAuB,GAAG,IAAI,CAO5F;AAED,4FAA4F;AAC5F,MAAM,WAAW,gBAAgB;IAChC,gEAAgE;IAChE,WAAW,EAAE,eAAe,CAAA;IAC5B,2DAA2D;IAC3D,YAAY,EAAE,uBAAuB,CAAA;CACrC;AAED,2FAA2F;AAC3F,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,GAAG,IAAI,CAOzE;AAID;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACtC,MAAM,EAAE,MAAM,GACZ;IAAE,SAAS,EAAE,eAAe,CAAC;IAAC,YAAY,EAAE,uBAAuB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAO/F;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAChC,KAAK,EAAE;IAAE,SAAS,EAAE,eAAe,CAAC;IAAC,YAAY,EAAE,uBAAuB,CAAA;CAAE,EAC5E,IAAI,EAAE,MAAM,GAAG,MAAM,EACrB,SAAS,EAAE,MAAM,GACf,MAAM,CAGR;AAED;WACW;AACX,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEhE"}
+{"version":3,"file":"street-directional.d.ts","sourceRoot":"","sources":["../../us/street-directional.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH;;;GAGG;AACH,oBAAY,uBAAuB;IAClC,KAAK,MAAM;IACX,IAAI,MAAM;IACV,KAAK,MAAM;IACX,IAAI,MAAM;IACV,SAAS,OAAO;IAChB,SAAS,OAAO;IAChB,SAAS,OAAO;IAChB,SAAS,OAAO;CAChB;AAED,iGAAiG;AACjG,eAAO,MAAM,gBAAgB,qGASS,CAAA;AAEtC,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE/D,eAAO,MAAM,yBAAyB,mZA6BA,CAAA;AAEtC,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEjF,gCAAgC;AAChC,eAAO,MAAM,6BAA6B;;;;;;;;;CAS2B,CAAA;AAErE,MAAM,MAAM,6BAA6B,GAAG,OAAO,6BAA6B,CAAA;AAEhF,gDAAgD;AAChD,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;CAa6B,CAAA;AAErE,MAAM,MAAM,2BAA2B,GAAG,OAAO,2BAA2B,CAAA;AAE5E,yDAAyD;AACzD,eAAO,MAAM,yBAAyB,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAE1E,CAAA;AAED,oDAAoD;AACpD,eAAO,MAAM,4BAA4B,EAAE,WAAW,CAAC,MAAM,EAAE,uBAAuB,CAErF,CAAA;AAED,+FAA+F;AAC/F,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,GAAG,IAAI,CAG3E;AAED,0FAA0F;AAC1F,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,uBAAuB,GAAG,IAAI,CAO5F;AAED,4FAA4F;AAC5F,MAAM,WAAW,gBAAgB;IAChC,gEAAgE;IAChE,WAAW,EAAE,eAAe,CAAA;IAC5B,2DAA2D;IAC3D,YAAY,EAAE,uBAAuB,CAAA;CACrC;AAED,2FAA2F;AAC3F,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,GAAG,IAAI,CAOzE;AAID;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACtC,MAAM,EAAE,MAAM,GACZ;IAAE,SAAS,EAAE,eAAe,CAAC;IAAC,YAAY,EAAE,uBAAuB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAO/F;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAChC,KAAK,EAAE;IAAE,SAAS,EAAE,eAAe,CAAC;IAAC,YAAY,EAAE,uBAAuB,CAAA;CAAE,EAC5E,IAAI,EAAE,MAAM,GAAG,MAAM,EACrB,SAAS,EAAE,MAAM,GACf,MAAM,CAGR;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEhE"}

package/out/us/street-directional.js

@@ -151,8 +151,10 @@ export function renderDirectional(match, form, reference) {
     const target = form === "abbr" ? match.abbreviation : match.canonical.replace(/\s+/g, "");
     return matchCase(target, reference);
 }
-/** Case-insensitive check: is the token any USPS directional or abbreviation (`"N"`, `"north"`,
-`"NW"`)? */
+/**
+ * Case-insensitive check: is the token any USPS directional or abbreviation (`"N"`, `"north"`,
+ * `"NW"`)?
+ */
 export function isStreetDirectionalToken(input) {
     return lookupDirectional(typeof input === "string" ? input.trim() : input) !== null;
 }

package/out/us/street-directional.js.map

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

package/out/us/zipcode.d.ts

@@ -146,7 +146,7 @@ export declare const StateAbbreviationZipCodePrefixRecord: {
 /**
  * Map of ZIP code prefixes to their corresponding US state abbreviations.
  */
-declare const ZipCodePrefixAbbreviationMap: Map<ZipCodeDigit, ("KY" | "PA" | "AL" | "AK" | "AZ" | "AR" | "CA" | "CO" | "CT" | "DE" | "DC" | "FL" | "GA" | "HI" | "ID" | "IL" | "IN" | "IA" | "KS" | "LA" | "ME" | "MD" | "MA" | "MI" | "MN" | "MS" | "MO" | "MT" | "NE" | "NV" | "NH" | "NJ" | "NM" | "NY" | "NC" | "ND" | "OH" | "OK" | "OR" | "RI" | "SC" | "SD" | "TN" | "TX" | "UT" | "VT" | "VA" | "WA" | "WV" | "WI" | "WY" | "PR" | "GU" | "VI" | "MP" | "AS")[]>;
+declare const ZipCodePrefixAbbreviationMap: Map<ZipCodeDigit, ("MS" | "WA" | "KY" | "PA" | "FL" | "AL" | "AK" | "AZ" | "AR" | "CA" | "CO" | "CT" | "DE" | "DC" | "GA" | "HI" | "ID" | "IL" | "IN" | "IA" | "KS" | "LA" | "ME" | "MD" | "MA" | "MI" | "MN" | "MO" | "MT" | "NE" | "NV" | "NH" | "NJ" | "NM" | "NY" | "NC" | "ND" | "OH" | "OK" | "OR" | "RI" | "SC" | "SD" | "TN" | "TX" | "UT" | "VT" | "VA" | "WV" | "WI" | "WY" | "PR" | "GU" | "VI" | "MP" | "AS")[]>;
 export { ZipCodePrefixAbbreviationMap };
 /**
  * Regex patterns for ZIP codes.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mailwoman/codex",
-  "version": "4.4.0",
+  "version": "4.5.0",
   "description": "Per-address-system postal reference data + branded types (USPS street suffixes, US ZIP codes). Pure, zero-runtime-dep — the shared canonical home for postal-system primitives the parser, resolver, and synthesis layers all reach for.",
   "license": "AGPL-3.0-only",
   "repository": {
@@ -18,7 +18,9 @@
     "./fr": "./out/fr/index.js",
     "./ca": "./out/ca/index.js",
     "./gb": "./out/gb/index.js",
-    "./jp": "./out/jp/index.js"
+    "./jp": "./out/jp/index.js",
+    "./au": "./out/au/index.js",
+    "./nz": "./out/nz/index.js"
   },
   "dependencies": {
     "type-fest": "^5.7.0"