@mailwoman/codex 4.2.0 → 4.3.0

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

@@ -0,0 +1,37 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Per-address-system parsing conventions (#478's rules-as-constraints slice, started as the #511
+ *   Tier A corrective). The model's locale head detects WHICH address system a string belongs to;
+ *   this table says what is and isn't grammatical in that system, so the decoder can obey the
+ *   detection instead of merely being nudged by it.
+ *
+ *   Every row is a provenance-carrying claim about a national addressing convention — the same
+ *   no-load-bearing-trivia discipline as the rest of the codex. Add rows with a source, not from
+ *   vibes; an absent row means "no constraints known", never "no constraints exist".
+ *
+ *   First consumer: `@mailwoman/neural`'s decoder applies `forbiddenTags` as a hard emission mask
+ *   before Viterbi and treats `postcodePattern` as the system's canonical shape for the snap-only
+ *   postcode repair pass. Both triggered only when the system is detected confidently (or supplied
+ *   by the caller) — an undetected system parses exactly as before.
+ */
+import type { SystemCode } from "./postcode-systems.js";
+export interface AddressSystemConventions {
+    /**
+     * Component tags that are NOT grammatical in this address system (names from the core
+     * `ComponentTag` union; codex stays dependency-free so they are plain strings here).
+     */
+    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
+     * snap-only repair (extend/clip to the valid match — never invent a span).
+     */
+    readonly postcodePattern?: RegExp;
+}
+export declare const ADDRESS_SYSTEM_CONVENTIONS: Partial<Record<SystemCode, AddressSystemConventions>>;
+/** Look up conventions for a system. Absent row = no constraints KNOWN (parse unconstrained). */
+export declare function conventionsForSystem(system: SystemCode | null | undefined): AddressSystemConventions | null;
+//# sourceMappingURL=address-system-conventions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"address-system-conventions.d.ts","sourceRoot":"","sources":["../address-system-conventions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAEvD,MAAM,WAAW,wBAAwB;IACxC;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC1C;;;;OAIG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CACjC;AAED,eAAO,MAAM,0BAA0B,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,wBAAwB,CAAC,CAc5F,CAAA;AAED,iGAAiG;AACjG,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,GAAG,wBAAwB,GAAG,IAAI,CAG3G"}

package/out/address-system-conventions.js

@@ -0,0 +1,42 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Per-address-system parsing conventions (#478's rules-as-constraints slice, started as the #511
+ *   Tier A corrective). The model's locale head detects WHICH address system a string belongs to;
+ *   this table says what is and isn't grammatical in that system, so the decoder can obey the
+ *   detection instead of merely being nudged by it.
+ *
+ *   Every row is a provenance-carrying claim about a national addressing convention — the same
+ *   no-load-bearing-trivia discipline as the rest of the codex. Add rows with a source, not from
+ *   vibes; an absent row means "no constraints known", never "no constraints exist".
+ *
+ *   First consumer: `@mailwoman/neural`'s decoder applies `forbiddenTags` as a hard emission mask
+ *   before Viterbi and treats `postcodePattern` as the system's canonical shape for the snap-only
+ *   postcode repair pass. Both triggered only when the system is detected confidently (or supplied
+ *   by the caller) — an undetected system parses exactly as before.
+ */
+import { CODE_POSTAL_PATTERN } from "./fr/code-postal.js";
+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).
+     */
+    fr: {
+        forbiddenTags: ["street_prefix", "street_suffix"],
+        postcodePattern: CODE_POSTAL_PATTERN,
+    },
+};
+/** Look up conventions for a system. Absent row = no constraints KNOWN (parse unconstrained). */
+export function conventionsForSystem(system) {
+    if (!system)
+        return null;
+    return ADDRESS_SYSTEM_CONVENTIONS[system] ?? null;
+}
+//# sourceMappingURL=address-system-conventions.js.map

package/out/address-system-conventions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"address-system-conventions.js","sourceRoot":"","sources":["../address-system-conventions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAiBzD,MAAM,CAAC,MAAM,0BAA0B,GAA0D;IAChG;;;;;;;;OAQG;IACH,EAAE,EAAE;QACH,aAAa,EAAE,CAAC,eAAe,EAAE,eAAe,CAAC;QACjD,eAAe,EAAE,mBAAmB;KACpC;CACD,CAAA;AAED,iGAAiG;AACjG,MAAM,UAAU,oBAAoB,CAAC,MAAqC;IACzE,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAA;IACxB,OAAO,0BAA0B,CAAC,MAAM,CAAC,IAAI,IAAI,CAAA;AAClD,CAAC"}

package/out/index.d.ts

@@ -17,6 +17,7 @@
  *   `candidateSystemsForPostcode` (the inverse of the per-slice postcode patterns) is a top-level
  *   export.
  */
+export { ADDRESS_SYSTEM_CONVENTIONS, type AddressSystemConventions, conventionsForSystem, } from "./address-system-conventions.js";
 export * as ca from "./ca/index.js";
 export * as de from "./de/index.js";
 export * as fr from "./fr/index.js";

package/out/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,MAAM,eAAe,CAAA;AACnC,OAAO,KAAK,EAAE,MAAM,eAAe,CAAA;AACnC,OAAO,KAAK,EAAE,MAAM,eAAe,CAAA;AACnC,OAAO,KAAK,EAAE,MAAM,eAAe,CAAA;AACnC,OAAO,KAAK,EAAE,MAAM,eAAe,CAAA;AACnC,OAAO,EAAE,2BAA2B,EAAE,KAAK,UAAU,EAAE,MAAM,uBAAuB,CAAA;AACpF,OAAO,KAAK,EAAE,MAAM,eAAe,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EACN,0BAA0B,EAC1B,KAAK,wBAAwB,EAC7B,oBAAoB,GACpB,MAAM,iCAAiC,CAAA;AACxC,OAAO,KAAK,EAAE,MAAM,eAAe,CAAA;AACnC,OAAO,KAAK,EAAE,MAAM,eAAe,CAAA;AACnC,OAAO,KAAK,EAAE,MAAM,eAAe,CAAA;AACnC,OAAO,KAAK,EAAE,MAAM,eAAe,CAAA;AACnC,OAAO,KAAK,EAAE,MAAM,eAAe,CAAA;AACnC,OAAO,EAAE,2BAA2B,EAAE,KAAK,UAAU,EAAE,MAAM,uBAAuB,CAAA;AACpF,OAAO,KAAK,EAAE,MAAM,eAAe,CAAA"}

package/out/index.js

@@ -17,6 +17,7 @@
  *   `candidateSystemsForPostcode` (the inverse of the per-slice postcode patterns) is a top-level
  *   export.
  */
+export { ADDRESS_SYSTEM_CONVENTIONS, conventionsForSystem, } from "./address-system-conventions.js";
 export * as ca from "./ca/index.js";
 export * as de from "./de/index.js";
 export * as fr from "./fr/index.js";

package/out/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,MAAM,eAAe,CAAA;AACnC,OAAO,KAAK,EAAE,MAAM,eAAe,CAAA;AACnC,OAAO,KAAK,EAAE,MAAM,eAAe,CAAA;AACnC,OAAO,KAAK,EAAE,MAAM,eAAe,CAAA;AACnC,OAAO,KAAK,EAAE,MAAM,eAAe,CAAA;AACnC,OAAO,EAAE,2BAA2B,EAAmB,MAAM,uBAAuB,CAAA;AACpF,OAAO,KAAK,EAAE,MAAM,eAAe,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EACN,0BAA0B,EAE1B,oBAAoB,GACpB,MAAM,iCAAiC,CAAA;AACxC,OAAO,KAAK,EAAE,MAAM,eAAe,CAAA;AACnC,OAAO,KAAK,EAAE,MAAM,eAAe,CAAA;AACnC,OAAO,KAAK,EAAE,MAAM,eAAe,CAAA;AACnC,OAAO,KAAK,EAAE,MAAM,eAAe,CAAA;AACnC,OAAO,KAAK,EAAE,MAAM,eAAe,CAAA;AACnC,OAAO,EAAE,2BAA2B,EAAmB,MAAM,uBAAuB,CAAA;AACpF,OAAO,KAAK,EAAE,MAAM,eAAe,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mailwoman/codex",
-  "version": "4.2.0",
+  "version": "4.3.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": {