@mailwoman/codex 9.1.0 → 9.3.0

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@mailwoman/codex",
-  "version": "9.1.0",
+  "version": "9.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 OR LicenseRef-Commercial",
   "repository": {
     "type": "git",
     "url": "https://github.com/sister-software/mailwoman.git",
-    "directory": "codex"
+    "directory": "packages/codex"
   },
   "files": [
     "out/**/*.js",
@@ -21,63 +21,124 @@
     "!*.test.tsx",
     "!**/*.test.ts",
     "!**/*.test.tsx",
-    "us/street-suffix.json",
-    "out/us/street-suffix.json"
+    "lib/us/street-suffix.json",
+    "out/us/street-suffix.json",
+    "!test/**"
   ],
   "type": "module",
+  "imports": {
+    "#*": {
+      "types": "./out/*.d.ts",
+      "node": "./out/*.js",
+      "default": "./out/*.js"
+    }
+  },
   "exports": {
     "./package.json": "./package.json",
     ".": {
       "types": "./out/index.d.ts",
+      "node": "./out/index.js",
       "default": "./out/index.js"
     },
     "./country": {
       "types": "./out/country/index.d.ts",
+      "node": "./out/country/index.js",
       "default": "./out/country/index.js"
     },
     "./us": {
       "types": "./out/us/index.d.ts",
+      "node": "./out/us/index.js",
       "default": "./out/us/index.js"
     },
     "./de": {
       "types": "./out/de/index.d.ts",
+      "node": "./out/de/index.js",
       "default": "./out/de/index.js"
     },
     "./fr": {
       "types": "./out/fr/index.d.ts",
+      "node": "./out/fr/index.js",
       "default": "./out/fr/index.js"
     },
     "./ca": {
       "types": "./out/ca/index.d.ts",
+      "node": "./out/ca/index.js",
       "default": "./out/ca/index.js"
     },
     "./gb": {
       "types": "./out/gb/index.d.ts",
+      "node": "./out/gb/index.js",
       "default": "./out/gb/index.js"
     },
     "./jp": {
       "types": "./out/jp/index.d.ts",
+      "node": "./out/jp/index.js",
       "default": "./out/jp/index.js"
     },
     "./au": {
       "types": "./out/au/index.d.ts",
+      "node": "./out/au/index.js",
       "default": "./out/au/index.js"
     },
     "./nz": {
       "types": "./out/nz/index.d.ts",
+      "node": "./out/nz/index.js",
       "default": "./out/nz/index.js"
     },
     "./tools": {
       "types": "./out/tools/index.d.ts",
+      "node": "./out/tools/index.js",
       "default": "./out/tools/index.js"
     },
+    "./normalize": {
+      "types": "./out/normalize.d.ts",
+      "node": "./out/normalize.js",
+      "default": "./out/normalize.js"
+    },
     "./es": {
       "types": "./out/es/index.d.ts",
+      "node": "./out/es/index.js",
       "default": "./out/es/index.js"
     },
     "./it": {
       "types": "./out/it/index.d.ts",
+      "node": "./out/it/index.js",
       "default": "./out/it/index.js"
+    },
+    "./address-system-conventions": {
+      "types": "./out/address-system-conventions.d.ts",
+      "node": "./out/address-system-conventions.js",
+      "default": "./out/address-system-conventions.js"
+    },
+    "./level-semantics": {
+      "types": "./out/level-semantics.d.ts",
+      "node": "./out/level-semantics.js",
+      "default": "./out/level-semantics.js"
+    },
+    "./postcode-systems": {
+      "types": "./out/postcode-systems.d.ts",
+      "node": "./out/postcode-systems.js",
+      "default": "./out/postcode-systems.js"
+    },
+    "./us/floor-designator": {
+      "types": "./out/us/floor-designator.d.ts",
+      "node": "./out/us/floor-designator.js",
+      "default": "./out/us/floor-designator.js"
+    },
+    "./us/state": {
+      "types": "./out/us/state.d.ts",
+      "node": "./out/us/state.js",
+      "default": "./out/us/state.js"
+    },
+    "./us/street-suffix": {
+      "types": "./out/us/street-suffix.d.ts",
+      "node": "./out/us/street-suffix.js",
+      "default": "./out/us/street-suffix.js"
+    },
+    "./us/unit-designator": {
+      "types": "./out/us/unit-designator.d.ts",
+      "node": "./out/us/unit-designator.js",
+      "default": "./out/us/unit-designator.js"
     }
   },
   "publishConfig": {
@@ -86,62 +147,124 @@
       "./package.json": "./package.json",
       ".": {
         "types": "./out/index.d.ts",
+        "node": "./out/index.js",
         "default": "./out/index.js"
       },
       "./country": {
         "types": "./out/country/index.d.ts",
+        "node": "./out/country/index.js",
         "default": "./out/country/index.js"
       },
       "./us": {
         "types": "./out/us/index.d.ts",
+        "node": "./out/us/index.js",
         "default": "./out/us/index.js"
       },
       "./de": {
         "types": "./out/de/index.d.ts",
+        "node": "./out/de/index.js",
         "default": "./out/de/index.js"
       },
       "./fr": {
         "types": "./out/fr/index.d.ts",
+        "node": "./out/fr/index.js",
         "default": "./out/fr/index.js"
       },
       "./ca": {
         "types": "./out/ca/index.d.ts",
+        "node": "./out/ca/index.js",
         "default": "./out/ca/index.js"
       },
       "./gb": {
         "types": "./out/gb/index.d.ts",
+        "node": "./out/gb/index.js",
         "default": "./out/gb/index.js"
       },
       "./jp": {
         "types": "./out/jp/index.d.ts",
+        "node": "./out/jp/index.js",
         "default": "./out/jp/index.js"
       },
       "./au": {
         "types": "./out/au/index.d.ts",
+        "node": "./out/au/index.js",
         "default": "./out/au/index.js"
       },
       "./nz": {
         "types": "./out/nz/index.d.ts",
+        "node": "./out/nz/index.js",
         "default": "./out/nz/index.js"
       },
       "./tools": {
         "types": "./out/tools/index.d.ts",
+        "node": "./out/tools/index.js",
         "default": "./out/tools/index.js"
       },
+      "./normalize": {
+        "types": "./out/normalize.d.ts",
+        "node": "./out/normalize.js",
+        "default": "./out/normalize.js"
+      },
       "./es": {
         "types": "./out/es/index.d.ts",
+        "node": "./out/es/index.js",
         "default": "./out/es/index.js"
       },
       "./it": {
         "types": "./out/it/index.d.ts",
+        "node": "./out/it/index.js",
         "default": "./out/it/index.js"
+      },
+      "./address-system-conventions": {
+        "types": "./out/address-system-conventions.d.ts",
+        "node": "./out/address-system-conventions.js",
+        "default": "./out/address-system-conventions.js"
+      },
+      "./level-semantics": {
+        "types": "./out/level-semantics.d.ts",
+        "node": "./out/level-semantics.js",
+        "default": "./out/level-semantics.js"
+      },
+      "./postcode-systems": {
+        "types": "./out/postcode-systems.d.ts",
+        "node": "./out/postcode-systems.js",
+        "default": "./out/postcode-systems.js"
+      },
+      "./us/floor-designator": {
+        "types": "./out/us/floor-designator.d.ts",
+        "node": "./out/us/floor-designator.js",
+        "default": "./out/us/floor-designator.js"
+      },
+      "./us/state": {
+        "types": "./out/us/state.d.ts",
+        "node": "./out/us/state.js",
+        "default": "./out/us/state.js"
+      },
+      "./us/street-suffix": {
+        "types": "./out/us/street-suffix.d.ts",
+        "node": "./out/us/street-suffix.js",
+        "default": "./out/us/street-suffix.js"
+      },
+      "./us/unit-designator": {
+        "types": "./out/us/unit-designator.d.ts",
+        "node": "./out/us/unit-designator.js",
+        "default": "./out/us/unit-designator.js"
+      }
+    },
+    "imports": {
+      "#*": {
+        "types": "./out/*.d.ts",
+        "node": "./out/*.js",
+        "default": "./out/*.js"
       }
     }
   },
   "dependencies": {
-    "type-fest": "^5.8.0"
+    "type-fest": "^5.9.0"
   },
   "devDependencies": {
-    "@mailwoman/annotations": "9.1.0"
+    "@mailwoman/annotations": "9.3.0",
+    "@mailwoman/core": "9.3.0",
+    "path-ts": "^2.3.0"
   }
 }

package/country/index.ts

@@ -1,15 +0,0 @@
-/**
- * @copyright Sister Software
- * @license AGPL-3.0
- * @author Teffen Ellis, et al.
- *
- *   ISO 3166-1 country reference + surface-form recognition (the `country` parity lever).
- */
-
-export * from "./codes.ts"
-export * from "./country.ts"
-export * from "./names.ts"
-export * from "./official-languages.ts"
-export * from "./reference-data.ts"
-export * from "./reference.ts"
-export * from "./subdivision.ts"

package/postcode-systems.ts

@@ -1,70 +0,0 @@
-/**
- * @copyright Sister Software
- * @license AGPL-3.0
- * @author Teffen Ellis, et al.
- *
- *   The inverse of the per-slice postcode patterns: given a postcode string, which address SYSTEMS
- *   could it belong to? Each codex slice owns its own postcode shape (`us` accepts
- *   `\d{5}(-\d{4})?`, `ca` accepts `A1A 1A1`, `jp` accepts `NNN-NNNN`, …); this is the single place
- *   that asks all of them at once and collects the matches.
- *
- *   It is the shared source of truth for "which systems can this shape be" — consumed by the postcode
- *   anchor (to narrow which systems' street vocabularies it checks) and, in time, by the runtime
- *   pipeline's locale gate (so its format→locale scoring derives from the same patterns rather than
- *   a second, divergent copy). The point is to unify the DATA, not to couple the modules: callers
- *   depend on this pure function, never on each other.
- *
- *   Note this is a SHAPE test, not a gazetteer-membership test. A bare `68161` matches the US,
- *   German, AND French 5-digit shapes, so it returns `["us", "de", "fr"]` — the shape alone cannot
- *   split the numeric-postcode systems. The anchor uses real gazetteer membership for the finer
- *   call; this function answers the coarser, model-free "which systems is this shape even eligible
- *   for".
- */
-
-import { normalizeAuPostcode } from "./au/index.ts"
-import { normalizeCaPostalCode } from "./ca/index.ts"
-import { normalizePLZ } from "./de/index.ts"
-import { normalizeCodePostal } from "./fr/index.ts"
-import { normalizeUkPostcode } from "./gb/index.ts"
-import { normalizeJpPostalCode } from "./jp/index.ts"
-import { normalizeNZPostcode } from "./nz/index.ts"
-import { isZipCode } from "./us/index.ts"
-
-/**
- * A codex address-system code — the subpath under `@mailwoman/codex/<system>`.
- */
-export type SystemCode = "us" | "de" | "fr" | "ca" | "gb" | "jp" | "au" | "nz"
-
-/**
- * Per-system membership test: each entry returns true when the string is accepted by that system's own postcode shape
- * (after that system's normalization — so `D-68161` reaches `de`, `1012 LM` reaches nothing here since NL has no slice
- * yet, etc.). Ordered for a stable, alphabetical-ish result.
- */
-const SYSTEM_ACCEPTS: ReadonlyArray<readonly [SystemCode, (s: string) => boolean]> = [
-	["us", (s) => isZipCode(s)],
-	["de", (s) => normalizePLZ(s) !== null],
-	["fr", (s) => normalizeCodePostal(s) !== null],
-	["ca", (s) => normalizeCaPostalCode(s) !== null],
-	["gb", (s) => normalizeUkPostcode(s) !== null],
-	["jp", (s) => normalizeJpPostalCode(s) !== null],
-	["au", (s) => normalizeAuPostcode(s) !== null],
-	["nz", (s) => normalizeNZPostcode(s) !== null],
-]
-
-/**
- * Every address system whose own postcode shape accepts `postcode`. Empty when no system recognizes the shape (e.g. a
- * bare `27`, or a 7-digit run). O(number of systems) — a handful of cheap regex tests, run only on the few
- * postcode-shaped spans an address contains.
- */
-export function candidateSystemsForPostcode(postcode: string): SystemCode[] {
-	if (typeof postcode !== "string" || !postcode.length) return []
-	const out: SystemCode[] = []
-
-	for (const [system, accepts] of SYSTEM_ACCEPTS) {
-		if (accepts(postcode)) {
-			out.push(system)
-		}
-	}
-
-	return out
-}