@mailwoman/codex 4.4.0 → 4.5.0

package/out/address-system-conventions.d.ts

@@ -25,8 +25,8 @@ export interface AddressSystemConventions {
      */
     readonly forbiddenTags?: readonly string[];
     /**
-     * The system's canonical postcode shape. A decoded postcode span that is a strict sub-match of
-     * a pattern-valid string in the raw text is shape-INVALID for this system and eligible for the
+     * The system's canonical postcode shape. A decoded postcode span that is a strict sub-match of a
+     * pattern-valid string in the raw text is shape-INVALID for this system and eligible for the
      * snap-only repair (extend/clip to the valid match — never invent a span).
      */
     readonly postcodePattern?: RegExp;

package/out/address-system-conventions.js

@@ -23,10 +23,10 @@ export const ADDRESS_SYSTEM_CONVENTIONS = {
      * France (La Poste / AFNOR NF Z 10-011): street types are LEADING particles of the street name
      * ("Rue de Rivoli", "Avenue des Champs-Élysées") — the libpostal French dictionaries carry no
      * trailing street-suffix class, and the USPS Pub-28 prefix/suffix decomposition has no French
-     * counterpart. `street_prefix`/`street_suffix` therefore cannot occur in a French parse; any
-     * such emission is US-convention leakage (measured: the 2026-06-10 v1.1.0 gate, where USPS
-     * suffix logic fired on "Rue" — RUE is genuinely a Pub-28 suffix variant — and digit-splits
-     * corrupted leading postcodes). Postcode: exactly five digits (NF Z 10-011; see fr/code-postal).
+     * counterpart. `street_prefix`/`street_suffix` therefore cannot occur in a French parse; any such
+     * emission is US-convention leakage (measured: the 2026-06-10 v1.1.0 gate, where USPS suffix
+     * logic fired on "Rue" — RUE is genuinely a Pub-28 suffix variant — and digit-splits corrupted
+     * leading postcodes). Postcode: exactly five digits (NF Z 10-011; see fr/code-postal).
      */
     fr: {
         forbiddenTags: ["street_prefix", "street_suffix"],

package/out/au/delivery-service.d.ts

@@ -0,0 +1,165 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Australia Post delivery-service designators (Postal Delivery Types) — the Commonwealth po_box
+ *   vocabulary the US-only `us/po-box.ts` cannot see: `GPO Box 2890`, `Locked Bag 1797`, `Private
+ *   Bag 7`, plus the rural/community legacy tail (`RMB 4600`, `RSD`, `CMB`).
+ *
+ *   Sourcing (accessed 2026-06-11; the underlying urban/rural addressing standard is AS/NZS 4819,
+ *   which governs street addressing — the delivery-service designators below are Australia Post's
+ *   own, from its addressing guidance):
+ *
+ *   - The complete Postal Delivery Type table comes verbatim from Australia Post's barcode addressing
+ *       booklet ("Hints and tips to get a higher address match rate", SAP 8838883): CARE OF POST
+ *       OFFICE→CARE PO, COMMUNITY MAIL AGENT→CMA, COMMUNITY MAIL BAG→CMB, GENERAL POST OFFICE
+ *       BOX→GPO BOX, LOCKED MAIL BAG SERVICE→LOCKED BAG, MAIL SERVICE→MS, POST OFFICE BOX→PO BOX,
+ *       POSTE RESTANTE→CARE PO, PRIVATE MAIL BAG SERVICE→PRIVATE BAG, ROADSIDE DELIVERY→RSD,
+ *       ROADSIDE MAIL BAG→RMB, ROADSIDE MAIL BOX→RMB, ROADSIDE MAIL SERVICE→RMS, COMMUNITY POSTAL
+ *       AGENT→CPA. The same booklet states: "With the exception of Care of Post Office, Community
+ *       Mail Agent, Community Postal Agent, and Community Mail Bag, all Postal Delivery Types must
+ *       have an associated number for a match to occur. e.g. PO Box 112", and "'PRIVATE BOX' is not
+ *       a valid type" (so PRIVATE BOX is deliberately NOT in this table).
+ *   - Which designators are CURRENT retail products (vs. AMAS-recognized legacy forms) comes from the
+ *       live auspost.com.au pages: the addressing guidelines ("Line 2 should contain the street
+ *       number and name, or PO Box or Locked Bag number"), the Correct Addressing brochure (SAP
+ *       8833878, Nov 2022 — `GPO Box 123 / SYDNEY NSW 2000` example), the personal "PO Boxes and
+ *       Private Bags" page (Private Bag: "If you live in a rural or remote area of Australia, you
+ *       can manage your mail securely with a Private Bag"), and the business "PO Boxes and Locked
+ *       Bags" page (GPO Box: "Lease a single GPO Box, or the same box number in each capital city
+ *       with our Common Box service"; Common Box numbers run 9800–9999). PO Box, GPO Box, Locked
+ *       Bag, and Private Bag appear on those current pages; the rural/community types (RSD, RMB,
+ *       RMS, MS, CMB, CMA, CPA, Care PO) appear ONLY in the AMAS table and are flagged `legacy` —
+ *       the parser must still recognize them on older addresses.
+ *
+ * @see {@link https://auspost.com.au/content/dam/auspost_corp/media/documents/Barcode_hints_tips.pdf Australia Post barcode addressing booklet (Postal Delivery Type table)}
+ * @see {@link https://auspost.com.au/sending/guidelines/addressing-guidelines Australia Post addressing guidelines}
+ * @see {@link https://auspost.com.au/content/dam/auspost_corp/media/documents/correct-addressing.pdf Australia Post Correct Addressing brochure (Nov 2022)}
+ * @see {@link https://auspost.com.au/receiving/manage-your-mail/po-boxes-and-private-bags Australia Post — PO Boxes and Private Bags}
+ * @see {@link https://auspost.com.au/business/business-admin/po-boxes-and-locked-bags Australia Post — business PO Boxes, GPO Boxes and Locked Bags}
+ */
+/** One Postal Delivery Type row from the Australia Post AMAS abbreviation table. */
+export interface AuDeliveryServiceDesignator {
+    /** The full Postal Delivery Type name, verbatim from the table (uppercase as published). */
+    name: string;
+    /** The standard abbreviation — the surface form written on mail ("GPO BOX", "LOCKED BAG"). */
+    abbreviation: string;
+    /**
+     * Whether the designator "must have an associated number for a match to occur" (AMAS rule;
+     * exceptions are Care of Post Office, Community Mail Agent, Community Postal Agent, and Community
+     * Mail Bag).
+     */
+    requiresNumber: boolean;
+    /**
+     * True when the designator is recognized by the AMAS Postal Delivery Type table but absent from
+     * every current auspost.com.au addressing/product page (accessed 2026-06-11) — the rural and
+     * community forms superseded by rural street addressing under AS/NZS 4819. The parser must still
+     * RECOGNIZE these on old addresses; synthesis should weight them low.
+     */
+    legacy: boolean;
+}
+/**
+ * The verbatim Postal Delivery Type table (see the module header for the per-row provenance).
+ * Multiple names can share an abbreviation (ROADSIDE MAIL BAG and ROADSIDE MAIL BOX are both RMB;
+ * POSTE RESTANTE is addressed as CARE PO).
+ */
+export declare const AU_DELIVERY_SERVICE_DESIGNATORS: readonly [{
+    readonly name: "GENERAL POST OFFICE BOX";
+    readonly abbreviation: "GPO BOX";
+    readonly requiresNumber: true;
+    readonly legacy: false;
+}, {
+    readonly name: "POST OFFICE BOX";
+    readonly abbreviation: "PO BOX";
+    readonly requiresNumber: true;
+    readonly legacy: false;
+}, {
+    readonly name: "LOCKED MAIL BAG SERVICE";
+    readonly abbreviation: "LOCKED BAG";
+    readonly requiresNumber: true;
+    readonly legacy: false;
+}, {
+    readonly name: "PRIVATE MAIL BAG SERVICE";
+    readonly abbreviation: "PRIVATE BAG";
+    readonly requiresNumber: true;
+    readonly legacy: false;
+}, {
+    readonly name: "COMMUNITY MAIL BAG";
+    readonly abbreviation: "CMB";
+    readonly requiresNumber: false;
+    readonly legacy: true;
+}, {
+    readonly name: "COMMUNITY MAIL AGENT";
+    readonly abbreviation: "CMA";
+    readonly requiresNumber: false;
+    readonly legacy: true;
+}, {
+    readonly name: "COMMUNITY POSTAL AGENT";
+    readonly abbreviation: "CPA";
+    readonly requiresNumber: false;
+    readonly legacy: true;
+}, {
+    readonly name: "CARE OF POST OFFICE";
+    readonly abbreviation: "CARE PO";
+    readonly requiresNumber: false;
+    readonly legacy: true;
+}, {
+    readonly name: "POSTE RESTANTE";
+    readonly abbreviation: "CARE PO";
+    readonly requiresNumber: false;
+    readonly legacy: true;
+}, {
+    readonly name: "MAIL SERVICE";
+    readonly abbreviation: "MS";
+    readonly requiresNumber: true;
+    readonly legacy: true;
+}, {
+    readonly name: "ROADSIDE DELIVERY";
+    readonly abbreviation: "RSD";
+    readonly requiresNumber: true;
+    readonly legacy: true;
+}, {
+    readonly name: "ROADSIDE MAIL BAG";
+    readonly abbreviation: "RMB";
+    readonly requiresNumber: true;
+    readonly legacy: true;
+}, {
+    readonly name: "ROADSIDE MAIL BOX";
+    readonly abbreviation: "RMB";
+    readonly requiresNumber: true;
+    readonly legacy: true;
+}, {
+    readonly name: "ROADSIDE MAIL SERVICE";
+    readonly abbreviation: "RMS";
+    readonly requiresNumber: true;
+    readonly legacy: true;
+}];
+/** A canonical Australia Post Postal Delivery Type abbreviation. */
+export type AuDeliveryServiceAbbreviation = (typeof AU_DELIVERY_SERVICE_DESIGNATORS)[number]["abbreviation"];
+/** Result of an AU delivery-service parse. */
+export interface AuDeliveryServiceMatch {
+    /** The designator phrase as it appeared ("G.P.O. Box", "Locked Bag"). */
+    matched: string;
+    /** The canonical Postal Delivery Type abbreviation ("GPO BOX", "LOCKED BAG"). */
+    designator: AuDeliveryServiceAbbreviation;
+    /** The delivery-service number when present ("9999", "4600"). */
+    id?: string;
+    /** True when the designator is an AMAS-only legacy form (see the table). */
+    legacy: boolean;
+}
+/**
+ * If `input` is a standalone Australia Post delivery-service phrase ("GPO Box 2890", "Locked Bag
+ * 1797", "RMB 4600", bare "CMB"), return the canonical designator, the id, and the legacy flag.
+ * Null otherwise — including for "Private Box", which Australia Post explicitly calls out as not a
+ * valid type.
+ */
+export declare function matchAuDeliveryService(input: unknown): AuDeliveryServiceMatch | null;
+/** Type-predicate: does the input look like a standalone AU delivery-service address line? */
+export declare function isAuDeliveryService(input: unknown): boolean;
+/**
+ * Normalize a recognized delivery-service phrase to the canonical AMAS form (`"g.p.o. box 123"` →
+ * `"GPO BOX 123"`). Returns the input unchanged if it isn't one.
+ */
+export declare function normalizeAuDeliveryService(input: string): string;
+//# sourceMappingURL=delivery-service.d.ts.map

package/out/au/delivery-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery-service.d.ts","sourceRoot":"","sources":["../../au/delivery-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,oFAAoF;AACpF,MAAM,WAAW,2BAA2B;IAC3C,4FAA4F;IAC5F,IAAI,EAAE,MAAM,CAAA;IACZ,8FAA8F;IAC9F,YAAY,EAAE,MAAM,CAAA;IACpB;;;;OAIG;IACH,cAAc,EAAE,OAAO,CAAA;IACvB;;;;;OAKG;IACH,MAAM,EAAE,OAAO,CAAA;CACf;AAED;;;;GAIG;AACH,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAee,CAAA;AAE3D,oEAAoE;AACpE,MAAM,MAAM,6BAA6B,GAAG,CAAC,OAAO,+BAA+B,CAAC,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,CAAA;AAyC5G,8CAA8C;AAC9C,MAAM,WAAW,sBAAsB;IACtC,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAA;IACf,iFAAiF;IACjF,UAAU,EAAE,6BAA6B,CAAA;IACzC,iEAAiE;IACjE,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,4EAA4E;IAC5E,MAAM,EAAE,OAAO,CAAA;CACf;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,GAAG,IAAI,CAcpF;AAED,8FAA8F;AAC9F,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE3D;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIhE"}

package/out/au/delivery-service.js

@@ -0,0 +1,132 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Australia Post delivery-service designators (Postal Delivery Types) — the Commonwealth po_box
+ *   vocabulary the US-only `us/po-box.ts` cannot see: `GPO Box 2890`, `Locked Bag 1797`, `Private
+ *   Bag 7`, plus the rural/community legacy tail (`RMB 4600`, `RSD`, `CMB`).
+ *
+ *   Sourcing (accessed 2026-06-11; the underlying urban/rural addressing standard is AS/NZS 4819,
+ *   which governs street addressing — the delivery-service designators below are Australia Post's
+ *   own, from its addressing guidance):
+ *
+ *   - The complete Postal Delivery Type table comes verbatim from Australia Post's barcode addressing
+ *       booklet ("Hints and tips to get a higher address match rate", SAP 8838883): CARE OF POST
+ *       OFFICE→CARE PO, COMMUNITY MAIL AGENT→CMA, COMMUNITY MAIL BAG→CMB, GENERAL POST OFFICE
+ *       BOX→GPO BOX, LOCKED MAIL BAG SERVICE→LOCKED BAG, MAIL SERVICE→MS, POST OFFICE BOX→PO BOX,
+ *       POSTE RESTANTE→CARE PO, PRIVATE MAIL BAG SERVICE→PRIVATE BAG, ROADSIDE DELIVERY→RSD,
+ *       ROADSIDE MAIL BAG→RMB, ROADSIDE MAIL BOX→RMB, ROADSIDE MAIL SERVICE→RMS, COMMUNITY POSTAL
+ *       AGENT→CPA. The same booklet states: "With the exception of Care of Post Office, Community
+ *       Mail Agent, Community Postal Agent, and Community Mail Bag, all Postal Delivery Types must
+ *       have an associated number for a match to occur. e.g. PO Box 112", and "'PRIVATE BOX' is not
+ *       a valid type" (so PRIVATE BOX is deliberately NOT in this table).
+ *   - Which designators are CURRENT retail products (vs. AMAS-recognized legacy forms) comes from the
+ *       live auspost.com.au pages: the addressing guidelines ("Line 2 should contain the street
+ *       number and name, or PO Box or Locked Bag number"), the Correct Addressing brochure (SAP
+ *       8833878, Nov 2022 — `GPO Box 123 / SYDNEY NSW 2000` example), the personal "PO Boxes and
+ *       Private Bags" page (Private Bag: "If you live in a rural or remote area of Australia, you
+ *       can manage your mail securely with a Private Bag"), and the business "PO Boxes and Locked
+ *       Bags" page (GPO Box: "Lease a single GPO Box, or the same box number in each capital city
+ *       with our Common Box service"; Common Box numbers run 9800–9999). PO Box, GPO Box, Locked
+ *       Bag, and Private Bag appear on those current pages; the rural/community types (RSD, RMB,
+ *       RMS, MS, CMB, CMA, CPA, Care PO) appear ONLY in the AMAS table and are flagged `legacy` —
+ *       the parser must still recognize them on older addresses.
+ *
+ * @see {@link https://auspost.com.au/content/dam/auspost_corp/media/documents/Barcode_hints_tips.pdf Australia Post barcode addressing booklet (Postal Delivery Type table)}
+ * @see {@link https://auspost.com.au/sending/guidelines/addressing-guidelines Australia Post addressing guidelines}
+ * @see {@link https://auspost.com.au/content/dam/auspost_corp/media/documents/correct-addressing.pdf Australia Post Correct Addressing brochure (Nov 2022)}
+ * @see {@link https://auspost.com.au/receiving/manage-your-mail/po-boxes-and-private-bags Australia Post — PO Boxes and Private Bags}
+ * @see {@link https://auspost.com.au/business/business-admin/po-boxes-and-locked-bags Australia Post — business PO Boxes, GPO Boxes and Locked Bags}
+ */
+/**
+ * The verbatim Postal Delivery Type table (see the module header for the per-row provenance).
+ * Multiple names can share an abbreviation (ROADSIDE MAIL BAG and ROADSIDE MAIL BOX are both RMB;
+ * POSTE RESTANTE is addressed as CARE PO).
+ */
+export const AU_DELIVERY_SERVICE_DESIGNATORS = [
+    { name: "GENERAL POST OFFICE BOX", abbreviation: "GPO BOX", requiresNumber: true, legacy: false },
+    { name: "POST OFFICE BOX", abbreviation: "PO BOX", requiresNumber: true, legacy: false },
+    { name: "LOCKED MAIL BAG SERVICE", abbreviation: "LOCKED BAG", requiresNumber: true, legacy: false },
+    { name: "PRIVATE MAIL BAG SERVICE", abbreviation: "PRIVATE BAG", requiresNumber: true, legacy: false },
+    { name: "COMMUNITY MAIL BAG", abbreviation: "CMB", requiresNumber: false, legacy: true },
+    { name: "COMMUNITY MAIL AGENT", abbreviation: "CMA", requiresNumber: false, legacy: true },
+    { name: "COMMUNITY POSTAL AGENT", abbreviation: "CPA", requiresNumber: false, legacy: true },
+    { name: "CARE OF POST OFFICE", abbreviation: "CARE PO", requiresNumber: false, legacy: true },
+    { name: "POSTE RESTANTE", abbreviation: "CARE PO", requiresNumber: false, legacy: true },
+    { name: "MAIL SERVICE", abbreviation: "MS", requiresNumber: true, legacy: true },
+    { name: "ROADSIDE DELIVERY", abbreviation: "RSD", requiresNumber: true, legacy: true },
+    { name: "ROADSIDE MAIL BAG", abbreviation: "RMB", requiresNumber: true, legacy: true },
+    { name: "ROADSIDE MAIL BOX", abbreviation: "RMB", requiresNumber: true, legacy: true },
+    { name: "ROADSIDE MAIL SERVICE", abbreviation: "RMS", requiresNumber: true, legacy: true },
+];
+/**
+ * Per-designator surface patterns (designator phrase only, no anchor, no id). Ordered longest /
+ * most-specific first so the matcher prefers "GPO Box" over "PO Box" and "RMS" over "MS". Each
+ * pattern tolerates the punctuation AMAS tells mailers to strip ("the full stops and commas in
+ * R.M.B and P.O.") — recognition must accept what deliverable mail actually carries.
+ *
+ * MS is special-cased in {@link matchAuDeliveryService}: its identifier must start with a digit so
+ * the bare two-letter designator cannot swallow an honorific ("Ms Smith").
+ */
+const DESIGNATOR_PATTERNS = [
+    ["GPO BOX", String.raw `general\s+post\s+office\s+box|g\.?\s*p\.?\s*o\.?\s*box`],
+    ["PO BOX", String.raw `post\s+office\s+box|p\.?\s*o\.?\s*box`],
+    ["LOCKED BAG", String.raw `locked\s+(?:mail\s+)?bag(?:\s+service)?`],
+    ["PRIVATE BAG", String.raw `private\s+(?:mail\s+)?bag(?:\s+service)?`],
+    ["CARE PO", String.raw `care\s+of\s+post\s+office|poste\s+restante|care\s+po`],
+    ["CMB", String.raw `community\s+mail\s+bag|cmb`],
+    ["CMA", String.raw `community\s+mail\s+agent|cma`],
+    ["CPA", String.raw `community\s+postal\s+agent|cpa`],
+    ["RSD", String.raw `roadside\s+delivery|r\.?\s*s\.?\s*d\.?`],
+    ["RMB", String.raw `roadside\s+mail\s+(?:bag|box)|r\.?\s*m\.?\s*b\.?`],
+    ["RMS", String.raw `roadside\s+mail\s+service|rms`],
+    ["MS", String.raw `mail\s+service|ms`],
+];
+const DESIGNATOR_INFO = new Map(AU_DELIVERY_SERVICE_DESIGNATORS.map((d) => [d.abbreviation, { requiresNumber: d.requiresNumber, legacy: d.legacy }]));
+// One anchored regex per designator: phrase + (required|optional) identifier. The id shape matches
+// the US slice ([\dA-Za-z][\dA-Za-z-]*); MS additionally requires a digit-leading id (see above).
+const MATCHERS = DESIGNATOR_PATTERNS.map(([abbreviation, src]) => {
+    const { requiresNumber } = DESIGNATOR_INFO.get(abbreviation);
+    const id = abbreviation === "MS" ? String.raw `(\d[\dA-Za-z-]*)` : String.raw `([\dA-Za-z][\dA-Za-z-]*)`;
+    const tail = requiresNumber ? String.raw `\s*#?\s*${id}` : String.raw `(?:\s*#?\s*${id})?`;
+    return { abbreviation, re: new RegExp(String.raw `^\s*(${src})${tail}\s*$`, "i") };
+});
+/**
+ * If `input` is a standalone Australia Post delivery-service phrase ("GPO Box 2890", "Locked Bag
+ * 1797", "RMB 4600", bare "CMB"), return the canonical designator, the id, and the legacy flag.
+ * Null otherwise — including for "Private Box", which Australia Post explicitly calls out as not a
+ * valid type.
+ */
+export function matchAuDeliveryService(input) {
+    if (typeof input !== "string")
+        return null;
+    for (const { abbreviation, re } of MATCHERS) {
+        const m = re.exec(input);
+        if (!m)
+            continue;
+        const info = DESIGNATOR_INFO.get(abbreviation);
+        return {
+            matched: m[1].trim(),
+            designator: abbreviation,
+            ...(m[2] ? { id: m[2] } : {}),
+            legacy: info.legacy,
+        };
+    }
+    return null;
+}
+/** Type-predicate: does the input look like a standalone AU delivery-service address line? */
+export function isAuDeliveryService(input) {
+    return matchAuDeliveryService(input) !== null;
+}
+/**
+ * Normalize a recognized delivery-service phrase to the canonical AMAS form (`"g.p.o. box 123"` →
+ * `"GPO BOX 123"`). Returns the input unchanged if it isn't one.
+ */
+export function normalizeAuDeliveryService(input) {
+    const m = matchAuDeliveryService(input);
+    if (!m)
+        return input;
+    return m.id ? `${m.designator} ${m.id.toUpperCase()}` : m.designator;
+}
+//# sourceMappingURL=delivery-service.js.map

package/out/au/delivery-service.js.map

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

package/out/au/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   The Australian address system (Australia Post / ISO 3166-2:AU; street addressing per AS/NZS
+ *   4819): delivery-service designators (GPO Box, Locked Bag, Private Bag, the rural legacy tail),
+ *   AMAS / AS 4590.1 floor/level designators (Level 3, Ground Floor, Mezzanine), states and
+ *   territories, and the 4-digit postcode.
+ */
+export * from "./delivery-service.js";
+export * from "./level-designator.js";
+export * from "./postcode.js";
+export * from "./state.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../au/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,uBAAuB,CAAA;AACrC,cAAc,uBAAuB,CAAA;AACrC,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA"}

package/out/au/index.js

@@ -0,0 +1,15 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   The Australian address system (Australia Post / ISO 3166-2:AU; street addressing per AS/NZS
+ *   4819): delivery-service designators (GPO Box, Locked Bag, Private Bag, the rural legacy tail),
+ *   AMAS / AS 4590.1 floor/level designators (Level 3, Ground Floor, Mezzanine), states and
+ *   territories, and the 4-digit postcode.
+ */
+export * from "./delivery-service.js";
+export * from "./level-designator.js";
+export * from "./postcode.js";
+export * from "./state.js";
+//# sourceMappingURL=index.js.map

package/out/au/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../au/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,uBAAuB,CAAA;AACrC,cAAc,uBAAuB,CAAA;AACrC,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA"}

package/out/au/level-designator.d.ts

@@ -0,0 +1,150 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Australia Post AMAS floor/level designators — the sub-premise vocabulary that names a FLOOR of a
+ *   building rather than a numbered unit on that floor: `Level 3`, `L 12`, `Ground Floor`,
+ *   `Mezzanine`.
+ *
+ *   Sourcing (accessed 2026-06-12):
+ *
+ *   - **Australia Post AMAS** (Address Matching Approval System) defines the Level Designator type and
+ *       its approved abbreviation. The verbatim AMAS description: "LEVEL" is the full word; "L" is
+ *       the approved abbreviation. The standard phrase format is `LEVEL <number>`, e.g. "LEVEL 3"
+ *       or "L 3" (abbreviation always uppercase in AMAS output). Australia Post's own barcode
+ *       addressing booklet (SAP 8838883) lists "LEVEL" and "L" as the level type; the Correct
+ *       Addressing brochure (SAP 8833878, Nov 2022) gives the example `LEVEL 3 / 60 MARGARET ST /
+ *       SYDNEY NSW 2000`. The AMAS Data Extract Format document (v4.2) confirms "LEVEL" → "L" as
+ *       the sole level abbreviation pair.
+ *   - **Ground floor** is treated by AMAS as `LEVEL G` (with the identifier "G"). Australia Post's
+ *       addressing guidelines state that ground floor should be written as "LEVEL G"; the full word
+ *       "GROUND" is a recognized alias for the identifier, not a separate designator type.
+ *   - **Mezzanine**, **Lower Ground**, and **Upper Ground** appear in AS 4590.1-2017 (the Australian
+ *       Standard for interchange of client information) as recognized level-type values alongside
+ *       LEVEL and GROUND. AS 4590.1-2017 Table 3 "Level type": B (Basement), G (Ground), MEZZANINE
+ *       (M), LG (Lower Ground), UG (Upper Ground), L (Level), OD (Observation Deck), P (Parking /
+ *       Podium), RT (Rooftop). These are the values a Geocoded National Address File (GNAF) record
+ *       may carry in the LEVEL_TYPE_CODE column, which mirrors the AP AMAS level-type vocabulary.
+ *   - "LVL" and "LG" appear as widely-recognized surface variants in real AU addresses (Open Addresses
+ *       AU export, accessed via OpenAddresses) though AS 4590.1-2017 and AMAS canonicalize to "L"
+ *       and "LG" respectively; the variants are included in {@link AU_LEVEL_DESIGNATOR_VARIANTS} so
+ *       the parser can RECOGNIZE them without synthesizing them.
+ *
+ * @see {@link https://auspost.com.au/sending/guidelines/addressing-guidelines Australia Post addressing guidelines}
+ * @see {@link https://auspost.com.au/content/dam/auspost_corp/media/documents/correct-addressing.pdf Australia Post Correct Addressing brochure (Nov 2022)}
+ * @see {@link https://auspost.com.au/content/dam/auspost_corp/media/documents/Barcode_hints_tips.pdf Australia Post barcode addressing booklet}
+ * @see {@link https://www.iso.org/standard/67840.html AS 4590.1-2017 — Interchange of client information}
+ */
+/**
+ * One AMAS / AS 4590.1 level-type row.
+ *
+ * The `type` is the AS 4590.1 LEVEL_TYPE_CODE value (what GNAF and AMAS use internally); the
+ * `abbreviation` is the approved surface form used in formatted mail; the `requiresNumber` flag
+ * distinguishes designators that take a floor identifier from standalone ones.
+ */
+export interface AuLevelDesignator {
+    /** AS 4590.1 LEVEL_TYPE_CODE (the GNAF / AMAS internal code). */
+    code: string;
+    /** Full descriptive name (AMAS table label). */
+    name: string;
+    /** The approved AMAS surface abbreviation written on mail ("L", "B", "M"). */
+    abbreviation: string;
+    /**
+     * True when the designator takes a numeric or alphanumeric floor identifier after it (`LEVEL 3`,
+     * `BASEMENT 2`). False for standalone types (`GROUND`, `MEZZANINE`, `ROOFTOP`) that name a
+     * specific well-known floor by vocabulary alone.
+     */
+    requiresNumber: boolean;
+}
+/**
+ * AMAS / AS 4590.1-2017 level-type table (Table 3). Verbatim codes; see the module header for
+ * provenance. Ordered with the most-common forms first for match priority.
+ */
+export declare const AU_LEVEL_DESIGNATORS: readonly [{
+    readonly code: "L";
+    readonly name: "LEVEL";
+    readonly abbreviation: "L";
+    readonly requiresNumber: true;
+}, {
+    readonly code: "G";
+    readonly name: "GROUND";
+    readonly abbreviation: "G";
+    readonly requiresNumber: false;
+}, {
+    readonly code: "B";
+    readonly name: "BASEMENT";
+    readonly abbreviation: "B";
+    readonly requiresNumber: true;
+}, {
+    readonly code: "M";
+    readonly name: "MEZZANINE";
+    readonly abbreviation: "M";
+    readonly requiresNumber: false;
+}, {
+    readonly code: "LG";
+    readonly name: "LOWER GROUND";
+    readonly abbreviation: "LG";
+    readonly requiresNumber: false;
+}, {
+    readonly code: "UG";
+    readonly name: "UPPER GROUND";
+    readonly abbreviation: "UG";
+    readonly requiresNumber: false;
+}, {
+    readonly code: "OD";
+    readonly name: "OBSERVATION DECK";
+    readonly abbreviation: "OD";
+    readonly requiresNumber: false;
+}, {
+    readonly code: "P";
+    readonly name: "PARKING";
+    readonly abbreviation: "P";
+    readonly requiresNumber: true;
+}, {
+    readonly code: "RT";
+    readonly name: "ROOFTOP";
+    readonly abbreviation: "RT";
+    readonly requiresNumber: false;
+}];
+/** A canonical AS 4590.1 LEVEL_TYPE_CODE. */
+export type AuLevelCode = (typeof AU_LEVEL_DESIGNATORS)[number]["code"];
+/**
+ * Recognized surface variants for each AMAS level code — the canonical code/abbreviation pair PLUS
+ * additional forms found in real AU addresses (Open Addresses export) that the parser must
+ * RECOGNIZE but the synthesis layer should not favor over the canonical form.
+ *
+ * Synthesis uses only the first element (the AMAS canonical surface). Recognition accepts all.
+ */
+export declare const AU_LEVEL_DESIGNATOR_VARIANTS: Readonly<Record<AuLevelCode, readonly string[]>>;
+/**
+ * Inverse lookup: every variant (abbreviation or surface form) → the canonical AMAS code.
+ * Lowercase-keyed for case-insensitive matching (`"level"` → `"L"`, `"bsmt"` → `"B"`).
+ */
+export declare const AU_LEVEL_DESIGNATOR_LOOKUP: ReadonlyMap<string, AuLevelCode>;
+/** Result of an AU level designator parse. */
+export interface AuLevelDesignatorMatch {
+    /** The code as it appeared in the input ("Level", "L", "lvl"). */
+    matched: string;
+    /** The canonical AS 4590.1 LEVEL_TYPE_CODE ("L", "B", "M"). */
+    code: AuLevelCode;
+    /** The floor identifier when present ("3", "G", "B2"). */
+    identifier?: string;
+}
+/**
+ * If `input` is a standalone AU level designator phrase ("Level 3", "L 12", "Ground Floor",
+ * "Mezzanine", "B 2"), return the canonical code and identifier. Null otherwise. Malformed entries
+ * (a requires-number designator with no identifier, e.g. bare "Level") return null — the builder
+ * throws loudly when a row in a table violates this constraint.
+ */
+export declare function matchAuLevelDesignator(input: unknown): AuLevelDesignatorMatch | null;
+/** Type-predicate: does the input look like a standalone AU level designator phrase? */
+export declare function isAuLevelDesignator(input: unknown): boolean;
+/**
+ * Normalize a recognized level phrase to the AMAS canonical form (`"level 3"` → `"L 3"`, `"ground
+ * floor"` → `"G"`). Returns the input unchanged if it isn't a level designator phrase. Throws if a
+ * row in {@link AU_LEVEL_DESIGNATORS} is malformed (requires-number entry with no abbreviation or
+ * empty name) — the builder must surface structural defects loudly.
+ */
+export declare function normalizeAuLevelDesignator(input: string): string;
+//# sourceMappingURL=level-designator.d.ts.map

package/out/au/level-designator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"level-designator.d.ts","sourceRoot":"","sources":["../../au/level-designator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IACjC,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAA;IACZ,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAA;IACZ,8EAA8E;IAC9E,YAAY,EAAE,MAAM,CAAA;IACpB;;;;OAIG;IACH,cAAc,EAAE,OAAO,CAAA;CACvB;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUgB,CAAA;AAEjD,6CAA6C;AAC7C,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAA;AAEvE;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC,CAUzF,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,0BAA0B,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAyBpE,CAAA;AAEJ,8CAA8C;AAC9C,MAAM,WAAW,sBAAsB;IACtC,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAA;IACf,+DAA+D;IAC/D,IAAI,EAAE,WAAW,CAAA;IACjB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAA;CACnB;AAoBD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,GAAG,IAAI,CAYpF;AAED,wFAAwF;AACxF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE3D;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKhE"}