@mailwoman/codex 8.5.0 → 9.0.0

package/README.md

@@ -92,7 +92,7 @@ questions, different tables.
 
 - [`@mailwoman/core`](../core) — `ComponentTag` schema, pipeline infrastructure
 - [`@mailwoman/address-id`](../address-id) — uses codex for stable address primary keys
-- [Address system conventions](https://mailwoman.sister.software/articles/plan/reference/SCHEMA/)
+- [Address system conventions](https://github.com/sister-software/mailwoman/blob/main/docs/engineering/reference/SCHEMA.mdx)
 
 ## License
 

package/ca/province.ts

@@ -16,6 +16,8 @@
  *   regions, the Canadian code IS a surface form, not just a resolver key.
  */
 
+import { foldName } from "../normalize.ts"
+
 /**
  * Per-province record: ISO 3166-2:CA code, English name, and the co-official French name.
  */
@@ -68,18 +70,6 @@ export function isCanadianProvinceCode(input: unknown): input is CanadianProvinc
 	return typeof input === "string" && PROVINCE_CODE_SET.has(input.toUpperCase())
 }
 
-/**
- * Strip diacritics + lowercase so `Québec`, `Quebec`, and `quebec` all key alike.
- */
-function foldName(s: string): string {
-	return s
-		.toLowerCase()
-		.normalize("NFD")
-		.replaceAll(/[\u0300-\u036F]/g, "")
-		.replaceAll(/[^a-z0-9]+/g, " ")
-		.trim()
-}
-
 /**
  * Folded province name (English or French) / code → ISO 3166-2:CA code. Built diacritic-insensitive so both co-official
  * names map regardless of accents: `Québec`, `Quebec`, and an unaccented `Nouvelle-Ecosse` all resolve. The two-name

package/country/subdivision.ts

@@ -27,6 +27,7 @@
  */
 
 import { CA_PROVINCES } from "../ca/province.ts"
+import { foldName } from "../normalize.ts"
 import { US_STATE_BY_ABBREVIATION } from "../us/state.ts"
 
 /**
@@ -47,18 +48,6 @@ export interface SubdivisionMatch {
 	country: string
 }
 
-/**
- * Strip diacritics + lowercase so `Québec`, `Quebec`, and `quebec` all key alike (mirrors `ca/province.ts`).
- */
-function foldName(s: string): string {
-	return s
-		.toLowerCase()
-		.normalize("NFD")
-		.replaceAll(/[\u0300-\u036F]/g, "")
-		.replaceAll(/[^a-z0-9]+/g, " ")
-		.trim()
-}
-
 /**
  * Folded surface form (ISO code, English name, or — for CA — co-official French name) → subdivision. Built once. US
  * states are inserted first and never overwritten, so on the (currently empty) event of a future code/name collision

package/es/codigo-postal.ts

@@ -0,0 +1,51 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Spanish postal codes (código postal): the branded type, the shape, and the province prior.
+ *
+ *   The contrast with a German PLZ is the informative part. A PLZ's leading digit maps to a Leitzone
+ *   that deliberately CROSSES state borders, so it cannot tell you the Bundesland. A Spanish código
+ *   postal is the opposite: its first TWO digits are the province code, assigned alphabetically
+ *   (01 Álava … 28 Madrid … 50 Zaragoza), so the province is derivable from the postcode exactly.
+ *   Code that wants a Spanish region from an address can read it off the postcode; code that wants a
+ *   German one cannot.
+ */
+
+import type { Tagged } from "type-fest"
+
+/**
+ * A Spanish postal code: five digits, `PPNNN`, where `PP` is the province (`28001` is Madrid).
+ *
+ * @category Postal
+ * @type string
+ * @title CodigoPostal
+ * @pattern ^\d{5}$
+ */
+export type CodigoPostal = Tagged<string, "CodigoPostal">
+
+/**
+ * Shape of a Spanish código postal — five digits. Identical in shape to a French code postal, a German PLZ and a US
+ * ZIP; disambiguation is the parser's job, not the pattern's.
+ */
+export const CODIGO_POSTAL_PATTERN = /^\d{5}$/
+
+/**
+ * Narrow a string to a {@link CodigoPostal}, or `null` when it is not one.
+ */
+export function parseCodigoPostal(input: string): CodigoPostal | null {
+	const s = input.trim()
+
+	return CODIGO_POSTAL_PATTERN.test(s) ? (s as CodigoPostal) : null
+}
+
+/**
+ * The two-digit province prefix (`"28001"` → `"28"`), or `null` for a non-postcode. Callers map it through their own
+ * province table; this module deliberately does not ship one, since the campaign that needed it only needs the shape.
+ */
+export function codigoPostalProvincePrefix(input: string): string | null {
+	const code = parseCodigoPostal(input)
+
+	return code ? code.slice(0, 2) : null
+}

package/es/index.ts

@@ -0,0 +1,9 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Spanish (ES) address-system reference data.
+ */
+
+export * from "./codigo-postal.ts"

package/fr/region.ts

@@ -13,6 +13,8 @@
  *   `code-postal.ts`).
  */
 
+import { foldName } from "../normalize.ts"
+
 /**
  * Per-region record: ISO 3166-2:FR code (sans `FR-` prefix) + French name.
  */
@@ -65,18 +67,6 @@ export function isFrenchRegionCode(input: unknown): input is FrenchRegionCode {
 	return typeof input === "string" && REGION_CODE_SET.has(input.toUpperCase())
 }
 
-/**
- * Strip diacritics + lowercase so `Île-de-France`, `ile-de-france`, `Ile de France` all key alike.
- */
-function foldName(s: string): string {
-	return s
-		.toLowerCase()
-		.normalize("NFD")
-		.replaceAll(/[\u0300-\u036F]/g, "")
-		.replaceAll(/[^a-z0-9]+/g, " ")
-		.trim()
-}
-
 /**
  * Folded region name / code → ISO 3166-2:FR code. Built diacritic-insensitive so the resolver's surface form
  * (`Île-de-France`, or an unaccented `Ile-de-France`) maps regardless of accents. Mirrors `de/bundesland.ts`'s

package/gb/postcode-area.ts

@@ -76,6 +76,16 @@ export const GB_POSTCODE_AREA_COUNTRY: Record<string, UkCountryCode> = {
 	...Object.fromEntries(WALES_AREAS.map((a) => [a, "WLS" as const])),
 }
 
+/**
+ * The two postcode areas whose assignment in {@link GB_POSTCODE_AREA_COUNTRY} is a MAJORITY call rather than a fact —
+ * TD (Galashiels) straddles the Scotland/England border and SY (Shrewsbury) straddles the Wales/England border, and
+ * both carry real postcodes on the other side of the line. The header above documents them in prose; this is the same
+ * knowledge in a form a build can read, so an artifact that ASSERTS ancestry per postcode district can withhold the
+ * constituent country here instead of asserting a coin-flip. Consumers that only want the coarse majority answer keep
+ * using {@link countryOfPostcodeArea} and ignore this.
+ */
+export const GB_BORDER_STRADDLING_AREAS: ReadonlySet<string> = new Set(["TD", "SY"])
+
 /**
  * True when `area` looks like a valid postcode-area string: one or two ASCII letters.
  */

package/index.ts

@@ -27,6 +27,7 @@ export {
 	type AddressSystemConventions,
 } from "./address-system-conventions.ts"
 
+export * from "./normalize.ts"
 export * as au from "./au/index.ts"
 export * as ca from "./ca/index.ts"
 export * as de from "./de/index.ts"

package/it/cap.ts

@@ -0,0 +1,39 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Italian postal codes (Codice di Avviamento Postale, CAP): the branded type and the shape.
+ *
+ *   Five digits like the Spanish, French and German forms, but do NOT infer a province from the
+ *   leading digits the way `es/codigo-postal.ts` documents for Spain. Italy's large cities are
+ *   assigned RANGES rather than a single code (Rome spans 00118–00199, Milan 20121–20162), and
+ *   several provinces share leading digits, so the CAP narrows geography without identifying a
+ *   province. It is the same trap German PLZ Leitzonen set, in a different disguise.
+ */
+
+import type { Tagged } from "type-fest"
+
+/**
+ * An Italian postal code: five digits (`00184` is Rome, Rione Monti).
+ *
+ * @category Postal
+ * @type string
+ * @title CAP
+ * @pattern ^\d{5}$
+ */
+export type CAP = Tagged<string, "CAP">
+
+/**
+ * Shape of an Italian CAP — five digits.
+ */
+export const CAP_PATTERN = /^\d{5}$/
+
+/**
+ * Narrow a string to a {@link CAP}, or `null` when it is not one.
+ */
+export function parseCAP(input: string): CAP | null {
+	const s = input.trim()
+
+	return CAP_PATTERN.test(s) ? (s as CAP) : null
+}

package/it/index.ts

@@ -0,0 +1,9 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Italian (IT) address-system reference data.
+ */
+
+export * from "./cap.ts"

package/normalize.ts

@@ -0,0 +1,53 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Name-normalization primitives shared across the codex tables and the lexicon builders that read
+ *   them.
+ *
+ *   These live in `@mailwoman/codex` rather than in `core` or `normalize` for one reason: codex is
+ *   the zero-runtime-dependency reference package, and everything that needs to match a name against
+ *   a codex table already depends on it. Putting the folding rules next to the tables they fold
+ *   means a lookup and its table can never disagree about what counts as the same name.
+ *
+ */
+
+/**
+ * Fold a name to its ASCII match key: lower-cased, accents stripped, every run of non-alphanumerics collapsed to a
+ * single space.
+ *
+ * This is the aggressive fold used to match a user's surface form against a codex table — `"Québec"` and `"QUEBEC"` and
+ * `"quebec"` all become `"quebec"`. It is lossy by design and never used to render anything back to a user.
+ */
+export function foldName(s: string): string {
+	return s
+		.toLowerCase()
+		.normalize("NFD")
+		.replaceAll(/[\u0300-\u036F]/g, "")
+		.replaceAll(/[^a-z0-9]+/g, " ")
+		.trim()
+}
+
+/**
+ * Strip leading and trailing punctuation from every whitespace-separated word, dropping words that were nothing but
+ * punctuation, and rejoin on single spaces.
+ *
+ * Unlike {@link foldName} this preserves case and non-Latin scripts — it works on Unicode letter and number classes, so
+ * `"Кыргызстан,"` and `"日本 。"` survive with their content intact. That is what makes it the right normalizer for
+ * building surface lexicons, where the entry has to remain renderable, and the wrong one for building a match key.
+ */
+export function wordNorm(s: string): string {
+	return s
+		.split(/\s+/)
+		.map((w) => w.replaceAll(/^[^\p{L}\p{N}]+|[^\p{L}\p{N}]+$/gu, ""))
+		.filter(Boolean)
+		.join(" ")
+}
+
+/**
+ * {@link wordNorm}, lower-cased — the case-insensitive lexicon key.
+ */
+export function wordNormLower(s: string): string {
+	return wordNorm(s).toLowerCase()
+}

package/nz/delivery-service.ts

@@ -45,12 +45,12 @@
 /**
  * Identifier requirement per ADV358's Delivery Service Elements rules.
  */
-export type NzIdentifierRule = "required-if-allocated" | "optional" | "not-used"
+export type NZIdentifierRule = "required-if-allocated" | "optional" | "not-used"
 
 /**
  * One Delivery Service Type row from ADV358.
  */
-export interface NzDeliveryServiceType {
+export interface NZDeliveryServiceType {
 	/**
 	 * The Delivery Service Type, verbatim casing per ADV358 ("PO Box", "Private Bag", "CMB").
 	 */
@@ -64,7 +64,7 @@ export interface NzDeliveryServiceType {
 	 * none ("not used … for Private Bags that do not have an identifier allocated by New Zealand Post"); Counter Delivery
 	 * and Poste Restante never carry one.
 	 */
-	identifier: NzIdentifierRule
+	identifier: NZIdentifierRule
 }
 
 /**
@@ -89,12 +89,12 @@ export const NZ_DELIVERY_SERVICE_TYPES = [
 		description: "Hold for Poste Restante collection - international mail",
 		identifier: "not-used",
 	},
-] as const satisfies readonly NzDeliveryServiceType[]
+] as const satisfies readonly NZDeliveryServiceType[]
 
 /**
  * A canonical NZ Delivery Service Type.
  */
-export type NzDeliveryServiceTypeName = (typeof NZ_DELIVERY_SERVICE_TYPES)[number]["type"]
+export type NZDeliveryServiceTypeName = (typeof NZ_DELIVERY_SERVICE_TYPES)[number]["type"]
 
 /**
  * Metadata for the colloquial "Private Box" alias (see the module header and operator ruling 2026-06-11). Kept separate
@@ -121,7 +121,7 @@ export const NZ_PRIVATE_BOX_ALIAS = {
 	/**
 	 * Identifier rule mirrors PO Box: a number is expected when the alias is used with one.
 	 */
-	identifier: "required-if-allocated" satisfies NzIdentifierRule,
+	identifier: "required-if-allocated" satisfies NZIdentifierRule,
 	/**
 	 * True — this form is NOT valid per ADV358 or NZ Post's live standards pages (accessed 2026-06-11).
 	 */
@@ -136,7 +136,7 @@ export const NZ_PRIVATE_BOX_ALIAS = {
  * The colloquial "Private Box" alias is included for recognition (see {@link NZ_PRIVATE_BOX_ALIAS} and operator ruling
  * 2026-06-11); it maps to a distinct synthetic type string so callers can distinguish it from the ADV358 types.
  */
-const TYPE_PATTERNS: ReadonlyArray<readonly [NzDeliveryServiceTypeName | "Private Box", string]> = [
+const TYPE_PATTERNS: ReadonlyArray<readonly [NZDeliveryServiceTypeName | "Private Box", string]> = [
 	["PO Box", String.raw`p\.?\s*o\.?\s*box|post\s+box`],
 	["Private Bag", String.raw`private\s+bag`],
 	["Private Box", String.raw`private\s+box`],
@@ -149,9 +149,9 @@ const TYPE_PATTERNS: ReadonlyArray<readonly [NzDeliveryServiceTypeName | "Privat
 /**
  * Extended type name union including the colloquial alias recognized for parsing.
  */
-export type NzDeliveryServiceMatchTypeName = NzDeliveryServiceTypeName | "Private Box"
+export type NZDeliveryServiceMatchTypeName = NZDeliveryServiceTypeName | "Private Box"
 
-const IDENTIFIER_RULES = new Map<NzDeliveryServiceMatchTypeName, NzIdentifierRule>([
+const IDENTIFIER_RULES = new Map<NZDeliveryServiceMatchTypeName, NZIdentifierRule>([
 	...NZ_DELIVERY_SERVICE_TYPES.map((t) => [t.type, t.identifier] as const),
 	// "Private Box" mirrors PO Box identifier rules (required-if-allocated) per the alias metadata.
 	["Private Box", NZ_PRIVATE_BOX_ALIAS.identifier],
@@ -161,7 +161,7 @@ const IDENTIFIER_RULES = new Map<NzDeliveryServiceMatchTypeName, NzIdentifierRul
  * One anchored regex per type. The identifier shape follows ADV358 (alphanumeric, no spaces or separators — `24999`,
  * `B99`); the identifier-less counter services take no tail at all.
  */
-const MATCHERS: ReadonlyArray<{ type: NzDeliveryServiceMatchTypeName; re: RegExp }> = TYPE_PATTERNS.map(
+const MATCHERS: ReadonlyArray<{ type: NZDeliveryServiceMatchTypeName; re: RegExp }> = TYPE_PATTERNS.map(
 	([type, src]) => {
 		const rule = IDENTIFIER_RULES.get(type)!
 		const tail = rule === "not-used" ? "" : String.raw`(?:\s+([\dA-Za-z]+))${rule === "optional" ? "?" : ""}`
@@ -173,7 +173,7 @@ const MATCHERS: ReadonlyArray<{ type: NzDeliveryServiceMatchTypeName; re: RegExp
 /**
  * Result of an NZ delivery-service parse.
  */
-export interface NzDeliveryServiceMatch {
+export interface NZDeliveryServiceMatch {
 	/**
 	 * The designator phrase as it appeared ("PO Box", "private bag", "Private Box").
 	 */
@@ -183,7 +183,7 @@ export interface NzDeliveryServiceMatch {
 	 * `type` is "Private Box", `colloquial` is true and `officiallyInvalid` is true — the form is not a valid ADV358
 	 * type.
 	 */
-	type: NzDeliveryServiceMatchTypeName
+	type: NZDeliveryServiceMatchTypeName
 	/**
 	 * The Delivery Service Identifier when present ("24999", "B99").
 	 */
@@ -204,7 +204,7 @@ export interface NzDeliveryServiceMatch {
  * Delivery Service Type; see {@link NZ_PRIVATE_BOX_ALIAS} and operator ruling 2026-06-11). Callers that want only
  * formally-valid ADV358 types should check `!result.colloquial`.
  */
-export function matchNzDeliveryService(input: unknown): NzDeliveryServiceMatch | null {
+export function matchNZDeliveryService(input: unknown): NZDeliveryServiceMatch | null {
 	if (typeof input !== "string") return null
 
 	for (const { type, re } of MATCHERS) {
@@ -222,16 +222,16 @@ export function matchNzDeliveryService(input: unknown): NzDeliveryServiceMatch |
 /**
  * Type-predicate: does the input look like a standalone NZ delivery-service address line?
  */
-export function isNzDeliveryService(input: unknown): boolean {
-	return matchNzDeliveryService(input) !== null
+export function isNZDeliveryService(input: unknown): boolean {
+	return matchNZDeliveryService(input) !== null
 }
 
 /**
  * Normalize a recognized phrase to the ADV358 form (`"p.o. box 24999"` → `"PO Box 24999"`). Returns the input unchanged
  * if it isn't a delivery-service phrase.
  */
-export function normalizeNzDeliveryService(input: string): string {
-	const m = matchNzDeliveryService(input)
+export function normalizeNZDeliveryService(input: string): string {
+	const m = matchNZDeliveryService(input)
 
 	if (!m) return input
 

package/nz/postcode.ts

@@ -23,7 +23,7 @@ import type { Tagged } from "type-fest"
  * @title New Zealand postcode
  * @pattern ^\d{4}$
  */
-export type NzPostcode = Tagged<string, "NzPostcode">
+export type NZPostcode = Tagged<string, "NZPostcode">
 
 /**
  * The NZ postcode shape: exactly four digits.
@@ -33,16 +33,16 @@ export const NZ_POSTCODE_PATTERN = /^\d{4}$/
 /**
  * Normalize a postcode surface form (trim only — NZ has no country-prefix courtesy form).
  */
-export function normalizeNzPostcode(raw: unknown): NzPostcode | null {
+export function normalizeNZPostcode(raw: unknown): NZPostcode | null {
 	if (typeof raw !== "string") return null
 	const s = raw.trim()
 
-	return NZ_POSTCODE_PATTERN.test(s) ? (s as NzPostcode) : null
+	return NZ_POSTCODE_PATTERN.test(s) ? (s as NZPostcode) : null
 }
 
 /**
  * Type-predicate for a (normalized) New Zealand postcode.
  */
-export function isNzPostcode(input: unknown): input is NzPostcode {
+export function isNZPostcode(input: unknown): input is NZPostcode {
 	return typeof input === "string" && NZ_POSTCODE_PATTERN.test(input)
 }

package/out/ca/province.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"province.d.ts","sourceRoot":"","sources":["../../ca/province.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;CACd;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAcgC,CAAA;AAEzD;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,OAAO,YAAY,CAAA;AAI5D;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,oBAAoB,CAEpF;AAcD;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,EAAE,WAAW,CAAC,MAAM,EAAE,oBAAoB,CAW3E,CAAA;AAEJ;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,oBAAoB,GAAG,IAAI,CAOpG"}
+{"version":3,"file":"province.d.ts","sourceRoot":"","sources":["../../ca/province.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;CACd;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAcgC,CAAA;AAEzD;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,OAAO,YAAY,CAAA;AAI5D;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,oBAAoB,CAEpF;AAED;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,EAAE,WAAW,CAAC,MAAM,EAAE,oBAAoB,CAW3E,CAAA;AAEJ;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,oBAAoB,GAAG,IAAI,CAOpG"}

package/out/ca/province.js

@@ -15,6 +15,7 @@
  *   is the abbreviation people actually write on the address line — so unlike German or French
  *   regions, the Canadian code IS a surface form, not just a resolver key.
  */
+import { foldName } from "../normalize.js";
 /**
  * ISO 3166-2:CA code → province/territory info, for all 13 subdivisions (10 provinces + 3 territories). Codes are the
  * official subdivision codes minus the `CA-` prefix.
@@ -41,17 +42,6 @@ const PROVINCE_CODE_SET = new Set(Object.keys(CA_PROVINCES));
 export function isCanadianProvinceCode(input) {
     return typeof input === "string" && PROVINCE_CODE_SET.has(input.toUpperCase());
 }
-/**
- * Strip diacritics + lowercase so `Québec`, `Quebec`, and `quebec` all key alike.
- */
-function foldName(s) {
-    return s
-        .toLowerCase()
-        .normalize("NFD")
-        .replaceAll(/[\u0300-\u036F]/g, "")
-        .replaceAll(/[^a-z0-9]+/g, " ")
-        .trim();
-}
 /**
  * Folded province name (English or French) / code → ISO 3166-2:CA code. Built diacritic-insensitive so both co-official
  * names map regardless of accents: `Québec`, `Quebec`, and an unaccented `Nouvelle-Ecosse` all resolve. The two-name

package/out/ca/province.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"subdivision.d.ts","sourceRoot":"","sources":["../../country/subdivision.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAKH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ;;OAEG;IACH,OAAO,EAAE,MAAM,CAAA;CACf;AA8CD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,gBAAgB,GAAG,IAAI,CAI1F"}
+{"version":3,"file":"subdivision.d.ts","sourceRoot":"","sources":["../../country/subdivision.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAMH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ;;OAEG;IACH,OAAO,EAAE,MAAM,CAAA;CACf;AAkCD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,gBAAgB,GAAG,IAAI,CAI1F"}

package/out/country/subdivision.js

@@ -26,18 +26,8 @@
  *   re-keys those two existing tables into one subdivision→country view.
  */
 import { CA_PROVINCES } from "../ca/province.js";
+import { foldName } from "../normalize.js";
 import { US_STATE_BY_ABBREVIATION } from "../us/state.js";
-/**
- * Strip diacritics + lowercase so `Québec`, `Quebec`, and `quebec` all key alike (mirrors `ca/province.ts`).
- */
-function foldName(s) {
-    return s
-        .toLowerCase()
-        .normalize("NFD")
-        .replaceAll(/[\u0300-\u036F]/g, "")
-        .replaceAll(/[^a-z0-9]+/g, " ")
-        .trim();
-}
 /**
  * Folded surface form (ISO code, English name, or — for CA — co-official French name) → subdivision. Built once. US
  * states are inserted first and never overwritten, so on the (currently empty) event of a future code/name collision

package/out/country/subdivision.js.map

@@ -1 +1 @@
-{"version":3,"file":"subdivision.js","sourceRoot":"","sources":["../../country/subdivision.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAA;AAoBzD;;GAEG;AACH,SAAS,QAAQ,CAAC,CAAS;IAC1B,OAAO,CAAC;SACN,WAAW,EAAE;SACb,SAAS,CAAC,KAAK,CAAC;SAChB,UAAU,CAAC,kBAAkB,EAAE,EAAE,CAAC;SAClC,UAAU,CAAC,aAAa,EAAE,GAAG,CAAC;SAC9B,IAAI,EAAE,CAAA;AACT,CAAC;AAED;;;;GAIG;AACH,MAAM,kBAAkB,GAA0C,CAAC,GAAG,EAAE;IACvE,MAAM,GAAG,GAAG,IAAI,GAAG,EAA4B,CAAA;IAE/C,MAAM,GAAG,GAAG,CAAC,GAAW,EAAE,KAAuB,EAAQ,EAAE;QAC1D,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAA;QAE5B,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACvC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;QACvB,CAAC;IACF,CAAC,CAAA;IAED,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,wBAAwB,CAAC,EAAE,CAAC;QACrE,MAAM,KAAK,GAAqB,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;QAC7D,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;QAChB,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;IACjB,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;QAChD,MAAM,KAAK,GAAqB,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;QACnF,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;QACrB,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;QACrB,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;IACxB,CAAC;IAED,OAAO,GAAG,CAAA;AACX,CAAC,CAAC,EAAE,CAAA;AAEJ;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAgC;IAChE,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAA;IAEpD,OAAO,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,IAAI,CAAA;AACvD,CAAC"}
+{"version":3,"file":"subdivision.js","sourceRoot":"","sources":["../../country/subdivision.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC1C,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAA;AAoBzD;;;;GAIG;AACH,MAAM,kBAAkB,GAA0C,CAAC,GAAG,EAAE;IACvE,MAAM,GAAG,GAAG,IAAI,GAAG,EAA4B,CAAA;IAE/C,MAAM,GAAG,GAAG,CAAC,GAAW,EAAE,KAAuB,EAAQ,EAAE;QAC1D,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAA;QAE5B,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACvC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;QACvB,CAAC;IACF,CAAC,CAAA;IAED,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,wBAAwB,CAAC,EAAE,CAAC;QACrE,MAAM,KAAK,GAAqB,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;QAC7D,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;QAChB,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;IACjB,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;QAChD,MAAM,KAAK,GAAqB,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;QACnF,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;QACrB,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;QACrB,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;IACxB,CAAC;IAED,OAAO,GAAG,CAAA;AACX,CAAC,CAAC,EAAE,CAAA;AAEJ;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAgC;IAChE,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAA;IAEpD,OAAO,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,IAAI,CAAA;AACvD,CAAC"}

package/out/es/codigo-postal.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Spanish postal codes (código postal): the branded type, the shape, and the province prior.
+ *
+ *   The contrast with a German PLZ is the informative part. A PLZ's leading digit maps to a Leitzone
+ *   that deliberately CROSSES state borders, so it cannot tell you the Bundesland. A Spanish código
+ *   postal is the opposite: its first TWO digits are the province code, assigned alphabetically
+ *   (01 Álava … 28 Madrid … 50 Zaragoza), so the province is derivable from the postcode exactly.
+ *   Code that wants a Spanish region from an address can read it off the postcode; code that wants a
+ *   German one cannot.
+ */
+import type { Tagged } from "type-fest";
+/**
+ * A Spanish postal code: five digits, `PPNNN`, where `PP` is the province (`28001` is Madrid).
+ *
+ * @category Postal
+ * @type string
+ * @title CodigoPostal
+ * @pattern ^\d{5}$
+ */
+export type CodigoPostal = Tagged<string, "CodigoPostal">;
+/**
+ * Shape of a Spanish código postal — five digits. Identical in shape to a French code postal, a German PLZ and a US
+ * ZIP; disambiguation is the parser's job, not the pattern's.
+ */
+export declare const CODIGO_POSTAL_PATTERN: RegExp;
+/**
+ * Narrow a string to a {@link CodigoPostal}, or `null` when it is not one.
+ */
+export declare function parseCodigoPostal(input: string): CodigoPostal | null;
+/**
+ * The two-digit province prefix (`"28001"` → `"28"`), or `null` for a non-postcode. Callers map it through their own
+ * province table; this module deliberately does not ship one, since the campaign that needed it only needs the shape.
+ */
+export declare function codigoPostalProvincePrefix(input: string): string | null;
+//# sourceMappingURL=codigo-postal.d.ts.map

package/out/es/codigo-postal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codigo-postal.d.ts","sourceRoot":"","sources":["../../es/codigo-postal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAEvC;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;AAEzD;;;GAGG;AACH,eAAO,MAAM,qBAAqB,QAAY,CAAA;AAE9C;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAIpE;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIvE"}

package/out/es/codigo-postal.js

@@ -0,0 +1,35 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Spanish postal codes (código postal): the branded type, the shape, and the province prior.
+ *
+ *   The contrast with a German PLZ is the informative part. A PLZ's leading digit maps to a Leitzone
+ *   that deliberately CROSSES state borders, so it cannot tell you the Bundesland. A Spanish código
+ *   postal is the opposite: its first TWO digits are the province code, assigned alphabetically
+ *   (01 Álava … 28 Madrid … 50 Zaragoza), so the province is derivable from the postcode exactly.
+ *   Code that wants a Spanish region from an address can read it off the postcode; code that wants a
+ *   German one cannot.
+ */
+/**
+ * Shape of a Spanish código postal — five digits. Identical in shape to a French code postal, a German PLZ and a US
+ * ZIP; disambiguation is the parser's job, not the pattern's.
+ */
+export const CODIGO_POSTAL_PATTERN = /^\d{5}$/;
+/**
+ * Narrow a string to a {@link CodigoPostal}, or `null` when it is not one.
+ */
+export function parseCodigoPostal(input) {
+    const s = input.trim();
+    return CODIGO_POSTAL_PATTERN.test(s) ? s : null;
+}
+/**
+ * The two-digit province prefix (`"28001"` → `"28"`), or `null` for a non-postcode. Callers map it through their own
+ * province table; this module deliberately does not ship one, since the campaign that needed it only needs the shape.
+ */
+export function codigoPostalProvincePrefix(input) {
+    const code = parseCodigoPostal(input);
+    return code ? code.slice(0, 2) : null;
+}
+//# sourceMappingURL=codigo-postal.js.map

package/out/es/codigo-postal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codigo-postal.js","sourceRoot":"","sources":["../../es/codigo-postal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAcH;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,SAAS,CAAA;AAE9C;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC9C,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAA;IAEtB,OAAO,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,CAAkB,CAAC,CAAC,CAAC,IAAI,CAAA;AAClE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CAAC,KAAa;IACvD,MAAM,IAAI,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAA;IAErC,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;AACtC,CAAC"}

package/out/es/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Spanish (ES) address-system reference data.
+ */
+export * from "./codigo-postal.ts";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../es/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,oBAAoB,CAAA"}

package/out/es/index.js

@@ -0,0 +1,9 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Spanish (ES) address-system reference data.
+ */
+export * from "./codigo-postal.js";
+//# sourceMappingURL=index.js.map

package/out/es/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../es/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,oBAAoB,CAAA"}

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

@@ -1 +1 @@
-{"version":3,"file":"region.d.ts","sourceRoot":"","sources":["../../fr/region.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;CACZ;AAED;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmB8B,CAAA;AAErD;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,UAAU,CAAA;AAItD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAE5E;AAcD;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CASrE,CAAA;AAEJ;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,gBAAgB,GAAG,IAAI,CAO5F"}
+{"version":3,"file":"region.d.ts","sourceRoot":"","sources":["../../fr/region.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;CACZ;AAED;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmB8B,CAAA;AAErD;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,UAAU,CAAA;AAItD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAE5E;AAED;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CASrE,CAAA;AAEJ;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,gBAAgB,GAAG,IAAI,CAO5F"}