@mailwoman/codex 4.3.0 → 4.5.0

package/out/au/level-designator.js

@@ -0,0 +1,156 @@
+/**
+ * @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}
+ */
+/**
+ * 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 const AU_LEVEL_DESIGNATORS = [
+    { code: "L", name: "LEVEL", abbreviation: "L", requiresNumber: true },
+    { code: "G", name: "GROUND", abbreviation: "G", requiresNumber: false },
+    { code: "B", name: "BASEMENT", abbreviation: "B", requiresNumber: true },
+    { code: "M", name: "MEZZANINE", abbreviation: "M", requiresNumber: false },
+    { code: "LG", name: "LOWER GROUND", abbreviation: "LG", requiresNumber: false },
+    { code: "UG", name: "UPPER GROUND", abbreviation: "UG", requiresNumber: false },
+    { code: "OD", name: "OBSERVATION DECK", abbreviation: "OD", requiresNumber: false },
+    { code: "P", name: "PARKING", abbreviation: "P", requiresNumber: true },
+    { code: "RT", name: "ROOFTOP", abbreviation: "RT", requiresNumber: false },
+];
+/**
+ * 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 const AU_LEVEL_DESIGNATOR_VARIANTS = {
+    L: ["L", "LEVEL", "LVL", "LEVL", "LEV"],
+    G: ["G", "GROUND", "GRD", "GF", "GROUND FLOOR"],
+    B: ["B", "BASEMENT", "BSMT", "LOWER LEVEL"],
+    M: ["M", "MEZZANINE", "MEZZ", "MEZZANINE LEVEL"],
+    LG: ["LG", "LOWER GROUND", "LOWER GROUND FLOOR"],
+    UG: ["UG", "UPPER GROUND", "UPPER GROUND FLOOR"],
+    OD: ["OD", "OBSERVATION DECK"],
+    P: ["P", "PARKING", "PODIUM"],
+    RT: ["RT", "ROOFTOP", "ROOF"],
+};
+/**
+ * Inverse lookup: every variant (abbreviation or surface form) → the canonical AMAS code.
+ * Lowercase-keyed for case-insensitive matching (`"level"` → `"L"`, `"bsmt"` → `"B"`).
+ */
+export const AU_LEVEL_DESIGNATOR_LOOKUP = (() => {
+    // Structural integrity check: every code must have at least one non-empty variant. Throw at
+    // module load time so a malformed table entry fails loud rather than silently producing an empty
+    // lexicon (the "builder must round-trip loud" rule from the task contract).
+    for (const { code } of AU_LEVEL_DESIGNATORS) {
+        const variants = AU_LEVEL_DESIGNATOR_VARIANTS[code];
+        if (!variants || variants.length === 0) {
+            throw new Error(`[codex/au/level-designator] code "${code}" has no variants in AU_LEVEL_DESIGNATOR_VARIANTS`);
+        }
+        for (const v of variants) {
+            if (!v || !v.trim()) {
+                throw new Error(`[codex/au/level-designator] code "${code}" has an empty or blank variant in AU_LEVEL_DESIGNATOR_VARIANTS`);
+            }
+        }
+    }
+    const out = new Map();
+    for (const { code } of AU_LEVEL_DESIGNATORS) {
+        for (const variant of AU_LEVEL_DESIGNATOR_VARIANTS[code]) {
+            const key = variant.toLowerCase();
+            if (!out.has(key))
+                out.set(key, code);
+        }
+    }
+    return out;
+})();
+// One regex per level code. Multi-word variants ("LOWER GROUND", "GROUND FLOOR") are matched
+// before their shorter constituents by ordering the variant list longest-first within each code.
+const LEVEL_MATCHERS = (() => {
+    const rows = [];
+    for (const { code, requiresNumber } of AU_LEVEL_DESIGNATORS) {
+        const variants = [...AU_LEVEL_DESIGNATOR_VARIANTS[code]]
+            .sort((a, b) => b.length - a.length)
+            .map((v) => v.replace(/[.*+?^${}()|[\]\\]/g, "\\$&").replace(/\s+/g, String.raw `\s+`));
+        const alts = variants.join("|");
+        // Identifier: optional alphanumeric (B2, 12, G). requiresNumber=true → identifier required.
+        const tail = requiresNumber
+            ? String.raw `\s+([A-Za-z]?\d[\dA-Za-z-]*|\d[\dA-Za-z-]*)`
+            : String.raw `(?:\s+([A-Za-z]?\d[\dA-Za-z-]*|\d[\dA-Za-z-]*))?`;
+        rows.push({ code, requiresNumber, re: new RegExp(String.raw `^\s*(${alts})${tail}\s*$`, "i") });
+    }
+    return rows;
+})();
+/**
+ * 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 function matchAuLevelDesignator(input) {
+    if (typeof input !== "string")
+        return null;
+    for (const { code, re } of LEVEL_MATCHERS) {
+        const m = re.exec(input);
+        if (!m)
+            continue;
+        return {
+            matched: m[1].trim(),
+            code,
+            ...(m[2] ? { identifier: m[2] } : {}),
+        };
+    }
+    return null;
+}
+/** Type-predicate: does the input look like a standalone AU level designator phrase? */
+export function isAuLevelDesignator(input) {
+    return matchAuLevelDesignator(input) !== null;
+}
+/**
+ * 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 function normalizeAuLevelDesignator(input) {
+    const m = matchAuLevelDesignator(input);
+    if (!m)
+        return input;
+    const row = AU_LEVEL_DESIGNATORS.find((r) => r.code === m.code);
+    return m.identifier ? `${row.abbreviation} ${m.identifier.toUpperCase()}` : row.abbreviation;
+}
+//# sourceMappingURL=level-designator.js.map

package/out/au/level-designator.js.map

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

package/out/au/postcode.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Australian postcodes: four digits, written at the end of the last address line after the locality
+ *   and state (`SYDNEY NSW 2000`). Sourcing (accessed 2026-06-11):
+ *
+ *   - Australia Post's Correct Addressing brochure (SAP 8833878, Nov 2022) — every example carries a
+ *       4-digit postcode and the brochure references envelopes "with preprinted four postcode
+ *       squares".
+ *   - The barcode addressing booklet documents the coarse first-digit → state prior: "if the Postcode
+ *       falls in the range 3000-3999 the State abbreviation will be VIC; 4000-4999 will be QLD,
+ *       etc. … Exceptions to this include ACT Postcodes and Postcodes located on State borders."
+ *       Because the booklet only enumerates VIC and QLD and flags exceptions, this module
+ *       deliberately does NOT ship a full first-digit → state table — the shape is the contract,
+ *       the geographic prior is the gazetteer's job.
+ *
+ *   Note the shape collides with New Zealand's (also 4 digits) — `candidateSystemsForPostcode`
+ *   returns both, and that ambiguity is by design (shape test, not membership test).
+ * @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}
+ */
+import type { Tagged } from "type-fest";
+/**
+ * An Australian postcode: four digits.
+ *
+ * @category Postal
+ * @type string
+ * @title Australian postcode
+ * @pattern ^\d{4}$
+ */
+export type AuPostcode = Tagged<string, "AuPostcode">;
+/** The AU postcode shape: exactly four digits. */
+export declare const AU_POSTCODE_PATTERN: RegExp;
+/** Normalize a postcode surface form (trim only — AU has no country-prefix courtesy form). */
+export declare function normalizeAuPostcode(raw: unknown): AuPostcode | null;
+/** Type-predicate for a (normalized) Australian postcode. */
+export declare function isAuPostcode(input: unknown): input is AuPostcode;
+//# sourceMappingURL=postcode.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"postcode.d.ts","sourceRoot":"","sources":["../../au/postcode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAEvC;;;;;;;GAOG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;AAErD,kDAAkD;AAClD,eAAO,MAAM,mBAAmB,QAAY,CAAA;AAE5C,8FAA8F;AAC9F,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,GAAG,IAAI,CAInE;AAED,6DAA6D;AAC7D,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAEhE"}

package/out/au/postcode.js

@@ -0,0 +1,37 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Australian postcodes: four digits, written at the end of the last address line after the locality
+ *   and state (`SYDNEY NSW 2000`). Sourcing (accessed 2026-06-11):
+ *
+ *   - Australia Post's Correct Addressing brochure (SAP 8833878, Nov 2022) — every example carries a
+ *       4-digit postcode and the brochure references envelopes "with preprinted four postcode
+ *       squares".
+ *   - The barcode addressing booklet documents the coarse first-digit → state prior: "if the Postcode
+ *       falls in the range 3000-3999 the State abbreviation will be VIC; 4000-4999 will be QLD,
+ *       etc. … Exceptions to this include ACT Postcodes and Postcodes located on State borders."
+ *       Because the booklet only enumerates VIC and QLD and flags exceptions, this module
+ *       deliberately does NOT ship a full first-digit → state table — the shape is the contract,
+ *       the geographic prior is the gazetteer's job.
+ *
+ *   Note the shape collides with New Zealand's (also 4 digits) — `candidateSystemsForPostcode`
+ *   returns both, and that ambiguity is by design (shape test, not membership test).
+ * @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}
+ */
+/** The AU postcode shape: exactly four digits. */
+export const AU_POSTCODE_PATTERN = /^\d{4}$/;
+/** Normalize a postcode surface form (trim only — AU has no country-prefix courtesy form). */
+export function normalizeAuPostcode(raw) {
+    if (typeof raw !== "string")
+        return null;
+    const s = raw.trim();
+    return AU_POSTCODE_PATTERN.test(s) ? s : null;
+}
+/** Type-predicate for a (normalized) Australian postcode. */
+export function isAuPostcode(input) {
+    return typeof input === "string" && AU_POSTCODE_PATTERN.test(input);
+}
+//# sourceMappingURL=postcode.js.map

package/out/au/postcode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postcode.js","sourceRoot":"","sources":["../../au/postcode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAcH,kDAAkD;AAClD,MAAM,CAAC,MAAM,mBAAmB,GAAG,SAAS,CAAA;AAE5C,8FAA8F;AAC9F,MAAM,UAAU,mBAAmB,CAAC,GAAY;IAC/C,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAA;IACxC,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAA;IACpB,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,CAAgB,CAAC,CAAC,CAAC,IAAI,CAAA;AAC9D,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,YAAY,CAAC,KAAc;IAC1C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;AACpE,CAAC"}

package/out/au/state.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Australian states and territories (ISO 3166-2:AU). Australia Post's addressing guidelines put the
+ *   state abbreviation on the last line between the locality and the 4-digit postcode ("Line 3
+ *   should contain the locality or suburb, state and postcode and be written in capital letters" —
+ *   addressing guidelines, accessed 2026-06-11), e.g. `SYDNEY NSW 2000`, `BUNBURY WA 6230`, `EUROA
+ *   VIC 3664`. The abbreviation set is the ISO 3166-2:AU subdivision codes, which are the same
+ *   codes Australia Post's own examples use (NSW, VIC, WA, QLD, ACT appear across the addressing
+ *   guidelines and the barcode booklet).
+ * @see {@link https://auspost.com.au/sending/guidelines/addressing-guidelines Australia Post addressing guidelines}
+ * @see {@link https://www.iso.org/obp/ui/#iso:code:3166:AU ISO 3166-2:AU}
+ */
+/** State/territory abbreviation → full name (ISO 3166-2:AU subdivision set). */
+export declare const AU_STATE_ABBREVIATIONS: {
+    readonly ACT: "Australian Capital Territory";
+    readonly NSW: "New South Wales";
+    readonly NT: "Northern Territory";
+    readonly QLD: "Queensland";
+    readonly SA: "South Australia";
+    readonly TAS: "Tasmania";
+    readonly VIC: "Victoria";
+    readonly WA: "Western Australia";
+};
+/** An Australian state/territory abbreviation as written on the last address line. */
+export type AuStateAbbreviation = keyof typeof AU_STATE_ABBREVIATIONS;
+/** Type-predicate for an AU state/territory abbreviation (case-insensitive). */
+export declare function isAuStateAbbreviation(input: unknown): input is AuStateAbbreviation;
+//# sourceMappingURL=state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../au/state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,gFAAgF;AAChF,eAAO,MAAM,sBAAsB;;;;;;;;;CASQ,CAAA;AAE3C,sFAAsF;AACtF,MAAM,MAAM,mBAAmB,GAAG,MAAM,OAAO,sBAAsB,CAAA;AAErE,gFAAgF;AAChF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,mBAAmB,CAElF"}

package/out/au/state.js

@@ -0,0 +1,31 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Australian states and territories (ISO 3166-2:AU). Australia Post's addressing guidelines put the
+ *   state abbreviation on the last line between the locality and the 4-digit postcode ("Line 3
+ *   should contain the locality or suburb, state and postcode and be written in capital letters" —
+ *   addressing guidelines, accessed 2026-06-11), e.g. `SYDNEY NSW 2000`, `BUNBURY WA 6230`, `EUROA
+ *   VIC 3664`. The abbreviation set is the ISO 3166-2:AU subdivision codes, which are the same
+ *   codes Australia Post's own examples use (NSW, VIC, WA, QLD, ACT appear across the addressing
+ *   guidelines and the barcode booklet).
+ * @see {@link https://auspost.com.au/sending/guidelines/addressing-guidelines Australia Post addressing guidelines}
+ * @see {@link https://www.iso.org/obp/ui/#iso:code:3166:AU ISO 3166-2:AU}
+ */
+/** State/territory abbreviation → full name (ISO 3166-2:AU subdivision set). */
+export const AU_STATE_ABBREVIATIONS = {
+    ACT: "Australian Capital Territory",
+    NSW: "New South Wales",
+    NT: "Northern Territory",
+    QLD: "Queensland",
+    SA: "South Australia",
+    TAS: "Tasmania",
+    VIC: "Victoria",
+    WA: "Western Australia",
+};
+/** Type-predicate for an AU state/territory abbreviation (case-insensitive). */
+export function isAuStateAbbreviation(input) {
+    return typeof input === "string" && Object.hasOwn(AU_STATE_ABBREVIATIONS, input.toUpperCase());
+}
+//# sourceMappingURL=state.js.map

package/out/au/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../au/state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,gFAAgF;AAChF,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACrC,GAAG,EAAE,8BAA8B;IACnC,GAAG,EAAE,iBAAiB;IACtB,EAAE,EAAE,oBAAoB;IACxB,GAAG,EAAE,YAAY;IACjB,EAAE,EAAE,iBAAiB;IACrB,GAAG,EAAE,UAAU;IACf,GAAG,EAAE,UAAU;IACf,EAAE,EAAE,mBAAmB;CACmB,CAAA;AAK3C,gFAAgF;AAChF,MAAM,UAAU,qBAAqB,CAAC,KAAc;IACnD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,sBAAsB,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAA;AAC/F,CAAC"}

package/out/country/country.d.ts

@@ -4,19 +4,19 @@
  * @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).
+ *   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, type CountryISO3 } from "./codes.js";
 import { type CountryName } 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.
+ * 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 declare const COUNTRY_SURFACE_FORMS: {
     readonly US: readonly ["United States", "USA", "US", "U.S.A.", "U.S.", "United States of America", "America"];
@@ -36,11 +36,11 @@ export declare const COUNTRY_SURFACE_FORMS: {
     readonly JP: readonly ["Japan", "日本", "Nippon", "JP", "JPN"];
 };
 export type CountrySurfaceIso2 = keyof typeof COUNTRY_SURFACE_FORMS;
-/** alpha-2 → canonical English name (inverted from the salvaged CountryISO2 enum). */
+/** Alpha-2 → canonical English name (inverted from the salvaged CountryISO2 enum). */
 export declare const ISO2_TO_NAME: ReadonlyMap<string, CountryName>;
 /**
- * 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
+ * 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 declare const COUNTRY_LOOKUP: ReadonlyMap<string, string>;
@@ -51,15 +51,16 @@ export interface CountryMatch {
     matched: string;
 }
 /**
- * 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.
+ * 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 declare function matchCountry(token: string | null | undefined): CountryMatch | null;
 /** Case-insensitive check: is the token any recognized country form? */
 export declare function isCountryToken(token: unknown): boolean;
-/** The preferred render forms for an alpha-2 (canonical first), for synth shards. Empty if none curated. */
+/** The preferred render forms for an alpha-2 (canonical first), for synth shards. Empty if none
+curated. */
 export declare function countrySurfaceForms(iso2: string): readonly string[];
-export type { CountryName, CountryISO3 };
-export { CountryISO2, Alpha3ToCountryRecord };
+export { Alpha3ToCountryRecord, CountryISO2 };
+export type { CountryISO3, CountryName };
 //# sourceMappingURL=country.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"country.d.ts","sourceRoot":"","sources":["../../country/country.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAA;AACjF,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;CAgB6B,CAAA;AAE/D,MAAM,MAAM,kBAAkB,GAAG,MAAM,OAAO,qBAAqB,CAAA;AAEnE,sFAAsF;AACtF,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAEzD,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAkBnD,CAAA;AAEJ,wGAAwG;AACxG,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,WAAW,GAAG,SAAS,CAAA;IAClC,OAAO,EAAE,MAAM,CAAA;CACf;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,YAAY,GAAG,IAAI,CAKlF;AAED,wEAAwE;AACxE,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEtD;AAED,4GAA4G;AAC5G,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAEnE;AAED,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,CAAA;AACxC,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,CAAA"}
+{"version":3,"file":"country.d.ts","sourceRoot":"","sources":["../../country/country.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAA;AACjF,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;CAgB6B,CAAA;AAE/D,MAAM,MAAM,kBAAkB,GAAG,MAAM,OAAO,qBAAqB,CAAA;AAEnE,sFAAsF;AACtF,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAEzD,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAkBnD,CAAA;AAEJ,wGAAwG;AACxG,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,WAAW,GAAG,SAAS,CAAA;IAClC,OAAO,EAAE,MAAM,CAAA;CACf;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,YAAY,GAAG,IAAI,CAKlF;AAED,wEAAwE;AACxE,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEtD;AAED;WACW;AACX,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAEnE;AAED,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,CAAA;AAC7C,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,CAAA"}

package/out/country/country.js

@@ -4,19 +4,19 @@
  * @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).
+ *   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.
+ * 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"],
@@ -35,11 +35,11 @@ export const COUNTRY_SURFACE_FORMS = {
     MX: ["Mexico", "México", "MX", "MEX"],
     JP: ["Japan", "日本", "Nippon", "JP", "JPN"],
 };
-/** alpha-2 → canonical English name (inverted from the salvaged CountryISO2 enum). */
+/** 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
+ * 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 = (() => {
@@ -67,9 +67,9 @@ export const COUNTRY_LOOKUP = (() => {
     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.
+ * 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")
@@ -83,9 +83,10 @@ export function matchCountry(token) {
 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. */
+/** 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 };
+export { Alpha3ToCountryRecord, CountryISO2 };
 //# sourceMappingURL=country.js.map

package/out/country/country.js.map

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

package/out/country/index.d.ts

@@ -5,7 +5,7 @@
  *
  *   ISO 3166-1 country reference + surface-form recognition (the `country` parity lever).
  */
-export * from "./names.js";
 export * from "./codes.js";
 export * from "./country.js";
+export * from "./names.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../country/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA"}

package/out/country/index.js

@@ -5,7 +5,7 @@
  *
  *   ISO 3166-1 country reference + surface-form recognition (the `country` parity lever).
  */
-export * from "./names.js";
 export * from "./codes.js";
 export * from "./country.js";
+export * from "./names.js";
 //# sourceMappingURL=index.js.map

package/out/country/index.js.map

@@ -1 +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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../country/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA"}

package/out/country/names.d.ts

@@ -7,8 +7,8 @@
  * List of all countries in the world.
  *
  * @category Geographic
- * @internal
  * @see https://en.wikipedia.org/wiki/List_of_countries
+ * @internal
  */
 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"];
 /**

package/out/country/names.js

@@ -7,8 +7,8 @@
  * List of all countries in the world.
  *
  * @category Geographic
- * @internal
  * @see https://en.wikipedia.org/wiki/List_of_countries
+ * @internal
  */
 export const CountryNames = [
     "Afghanistan",

package/out/fr/cedex.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   CEDEX — Courrier d'Entreprise à Distribution EXceptionnelle (La Poste business routing, NF Z
+ *   10-011 §3.4). A CEDEX line replaces the ordinary delivery line for high-volume business
+ *   recipients: `75008 PARIS CEDEX 08` — the word CEDEX after the distribution office name,
+ *   optionally followed by a 1–2 digit office number. The component is the `CEDEX [NN]` phrase
+ *   itself (the schema's `cedex` tag); the preceding postcode/locality keep their own tags.
+ *
+ *   This slice closes the gap PR #516 documented: the shard builder sourced the shape from SCHEMA.mdx
+ *   prose because codex had no cedex home. Now it does — the builder and any future consumer import
+ *   from here (the no-load-bearing-trivia discipline: one provenanced source).
+ */
+/** Matches a CEDEX phrase: the keyword plus an optional 1–2 digit office number. */
+export declare const CEDEX_PATTERN: RegExp;
+/** A matched CEDEX phrase with its char range and optional office number. */
+export interface CedexMatch {
+    /** The full matched phrase as it appears ("CEDEX 08", "Cedex"). */
+    matched: string;
+    start: number;
+    end: number;
+    /** The office number when present ("08"), undefined for bare CEDEX. */
+    office?: string;
+}
+/**
+ * Find the CEDEX phrase in a line, if any. Returns the LAST match — a CEDEX line places the phrase
+ * terminally (NF Z 10-011), and any earlier occurrence in pathological input is more likely a venue
+ * name fragment.
+ */
+export declare function matchCedex(text: string): CedexMatch | null;
+/** True when the string is exactly a CEDEX phrase (the component-value validator). */
+export declare function isCedex(input: unknown): boolean;
+//# sourceMappingURL=cedex.d.ts.map

package/out/fr/cedex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cedex.d.ts","sourceRoot":"","sources":["../../fr/cedex.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,oFAAoF;AACpF,eAAO,MAAM,aAAa,QAAgC,CAAA;AAE1D,6EAA6E;AAC7E,MAAM,WAAW,UAAU;IAC1B,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAY1D;AAED,sFAAsF;AACtF,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAI/C"}