@mailwoman/codex 6.0.0 → 6.2.0

package/out/level-semantics.js

@@ -0,0 +1,516 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Per-locale LEVEL semantics — the fix for "Flr 1 means something different depending on where you
+ *   are" (#1100, the secondary-address epic's second data deliverable). {@link "./us/unit-designator.ts"},
+ *   {@link "./us/floor-designator.ts"}, and {@link "./au/level-designator.ts"} each standardize ONE
+ *   address system's floor/level VOCABULARY — which surface tokens exist ("FL", "L 3", "Ground
+ *   Floor"). This module standardizes the cross-locale ORDINAL SEMANTICS those tokens carry: the fact
+ *   that "1st floor" names the SAME physical storey as "ground floor" in the United States
+ *   (`firstNumberedIsGround: true`) but ONE STOREY ABOVE it in France, Germany, and most of
+ *   continental Europe (`firstNumberedIsGround: false`), where ground already has its own name (RDC,
+ *   EG, PLANTA BAJA, …) and claims ordinal 0 on its own.
+ *
+ *   This is inherently a MULTI-LOCALE module — unlike `us/`, `au/`, `fr/`, … it doesn't belong to one
+ *   address system, so it lives at the codex root and is exported only from the root barrel
+ *   (mirroring `address-system-conventions.ts` and `postcode-systems.ts`, the other cross-system root
+ *   modules). It does not get its own `@mailwoman/codex/<x>` subpath.
+ *
+ *   Two tables do the work:
+ *
+ *   1. {@link LEVEL_DESIGNATORS_BY_FAMILY} — the designator LEXICON per LANGUAGE family (the surface
+ *      vocabulary: FL/FLOOR/LVL/LEVEL, ÉTAGE/ÉT, OG/OBERGESCHOSS, …). Keyed by a bare language tag
+ *      ("en", "fr", "de", …) because the WORDS don't vary by country — American and British English
+ *      both say "floor", "basement", "penthouse".
+ *   2. {@link LEVEL_ORDINAL_CONVENTIONS} — the ORDINAL CONVENTION per full locale ("en-US", "en-GB",
+ *      …), because the NUMBERING varies by country even within one language: American and Canadian
+ *      buildings both call the ground floor "the 1st floor"; British buildings, like the rest of the
+ *      IMDF/continental-European convention locales, do not.
+ *
+ *   {@link levelToOrdinal} composes both: look up the designator's KIND in the locale's language
+ *   family (ground / basement / numbered / fractional / special / fixed), then — for numbered
+ *   designators only — apply the locale's numbering convention. IMDF (Apple's Indoor Mapping Data
+ *   Format) is the schema precedent for encoding a level as a signed integer `ordinal` where ground is
+ *   always 0; this table supplies the locale-aware mapping from a raw (designator, number) pair into
+ *   that same ordinal space.
+ *
+ *   Data is convention encoded from common postal/building usage, not a single postal authority
+ *   publication — level-numbering conventions are cultural, not regulatory, so no Pub-28-style single
+ *   source exists for most of these locales. Retrieved/encoded 2026-07-13, epic #1100.
+ *
+ *   Deliberately-excluded ambiguities (handled by an explicit, documented rounding rule below, never a
+ *   silent guess):
+ *
+ *   - **Spanish PRINCIPAL / ENTRESUELO**: pre-metric Spanish buildings run BAJO (0) → ENTRESUELO
+ *     (~0.5) → PRINCIPAL (1) → PISO 1/2 (2), but the exact offset varies by city and building age.
+ *     ENTRESUELO's true position (0.5) isn't representable as an integer ordinal; it floors to 0
+ *     (grouped with ground) — a documented approximation, not an empirical claim. PRINCIPAL is a
+ *     fixed, always-ordinal-1 designator (it names a specific floor by convention, not by a number the
+ *     caller supplies).
+ *   - **English LOWER GROUND / UPPER GROUND** (UK mixed-use buildings): sit at roughly -0.5 and +0.5
+ *     relative to ground. Both round DOWN (floor): LOWER GROUND → -1 (grouped with the first basement
+ *     level), UPPER GROUND → 0 (grouped with ground). Convention choices, not measurements.
+ *   - **PENTHOUSE / ROOF / ATTIC / DACHGESCHOSS / ÁTICO / ATTICO**: named by relationship to the TOP of
+ *     a SPECIFIC building, not by a fixed distance from ground — there is no locale-independent integer
+ *     to assign. {@link levelToOrdinal} returns `undefined` for this designator kind rather than
+ *     guessing.
+ *   - **Nordic ground-floor vocabulary**: Danish STUEN/STUEETAGE is a well-attested standard term
+ *     (the "st." you see on Danish addresses). Norwegian has no equally standard, universally-agreed
+ *     single word for "ground floor" distinct from "1. etasje" in everyday use; GATEPLAN is included
+ *     here for structural parity with the other Nordic tables but is a lower-confidence, regional
+ *     inclusion — flagged in-line, not asserted as authoritative.
+ *
+ * @see {@link https://register.apple.com/resources/imdf/Level/ IMDF Level — `ordinal` (Apple Indoor Mapping Data Format)}
+ */
+/**
+ * English (American, British, Canadian, Australian, …) floor/level vocabulary. This is the GENERIC English lexicon for
+ * the ordinal-semantics table; it doesn't replace the more detailed per-system lexicons in
+ * {@link "./us/floor-designator.ts"} (USPS Pub-28 C2) or {@link "./au/level-designator.ts"} (AS 4590.1 / AMAS) — those
+ * drive span-proposer/synthesis vocabulary for their own address system. This table exists to answer a narrower
+ * question for ANY English-speaking locale: given a designator + number, what ordinal does it name.
+ */
+export const EN_LEVEL_DESIGNATORS = [
+    {
+        code: "FLOOR",
+        name: "Floor",
+        variants: ["FLOOR", "FL", "FLR", "LEVEL", "LVL"],
+        kind: "numbered",
+        requiresNumber: true,
+    },
+    { code: "BASEMENT", name: "Basement", variants: ["BASEMENT", "BSMT", "B"], kind: "basement", requiresNumber: true },
+    { code: "PENTHOUSE", name: "Penthouse", variants: ["PENTHOUSE", "PH"], kind: "special", requiresNumber: false },
+    {
+        code: "GROUND",
+        name: "Ground",
+        variants: ["GROUND", "G", "GROUND FLOOR", "GF"],
+        kind: "ground",
+        requiresNumber: false,
+    },
+    {
+        code: "LOWER GROUND",
+        name: "Lower Ground",
+        variants: ["LOWER GROUND", "LG"],
+        kind: "fractionalBelowGround",
+        requiresNumber: false,
+    },
+    {
+        code: "UPPER GROUND",
+        name: "Upper Ground",
+        variants: ["UPPER GROUND", "UG"],
+        kind: "fractionalAboveGround",
+        requiresNumber: false,
+    },
+    {
+        code: "MEZZANINE",
+        name: "Mezzanine",
+        variants: ["MEZZANINE", "MEZZ", "M"],
+        kind: "fractionalAboveGround",
+        requiresNumber: false,
+    },
+    { code: "ROOF", name: "Roof", variants: ["ROOF", "RF"], kind: "special", requiresNumber: false },
+];
+/** French (France, and — for the vocabulary, not the numbering convention — Francophone Canada) floor/level vocabulary. */
+export const FR_LEVEL_DESIGNATORS = [
+    {
+        code: "ÉTAGE",
+        name: "Étage (Floor)",
+        variants: ["ÉTAGE", "ETAGE", "ÉT", "ET"],
+        kind: "numbered",
+        requiresNumber: true,
+    },
+    {
+        code: "RDC",
+        name: "Rez-de-chaussée (Ground floor)",
+        variants: ["RDC", "REZ-DE-CHAUSSÉE", "REZ-DE-CHAUSSEE", "REZ DE CHAUSSEE"],
+        kind: "ground",
+        requiresNumber: false,
+    },
+    {
+        code: "SOUS-SOL",
+        name: "Sous-sol (Basement)",
+        variants: ["SOUS-SOL", "SOUS SOL", "SS"],
+        kind: "basement",
+        requiresNumber: true,
+    },
+    {
+        code: "ENTRESOL",
+        name: "Entresol (Mezzanine)",
+        variants: ["ENTRESOL"],
+        kind: "fractionalAboveGround",
+        requiresNumber: false,
+    },
+];
+/** German floor/level vocabulary (the -geschoss family). */
+export const DE_LEVEL_DESIGNATORS = [
+    {
+        code: "OBERGESCHOSS",
+        name: "Obergeschoss (Upper floor)",
+        variants: ["OBERGESCHOSS", "OG"],
+        kind: "numbered",
+        requiresNumber: true,
+    },
+    {
+        code: "ERDGESCHOSS",
+        name: "Erdgeschoss (Ground floor)",
+        variants: ["ERDGESCHOSS", "EG"],
+        kind: "ground",
+        requiresNumber: false,
+    },
+    {
+        code: "UNTERGESCHOSS",
+        name: "Untergeschoss (Basement)",
+        variants: ["UNTERGESCHOSS", "UG"],
+        kind: "basement",
+        requiresNumber: true,
+    },
+    {
+        code: "DACHGESCHOSS",
+        name: "Dachgeschoss (Attic/roof floor)",
+        variants: ["DACHGESCHOSS", "DG"],
+        kind: "special",
+        requiresNumber: false,
+    },
+    {
+        code: "ZWISCHENGESCHOSS",
+        name: "Zwischengeschoss (Mezzanine)",
+        variants: ["ZWISCHENGESCHOSS", "ZG"],
+        kind: "fractionalAboveGround",
+        requiresNumber: false,
+    },
+];
+/**
+ * Spanish floor/level vocabulary. PRINCIPAL and ENTRESUELO offsets vary by city and building age (see the module
+ * header) — encoded here as a single convention, not an empirical universal.
+ */
+export const ES_LEVEL_DESIGNATORS = [
+    { code: "PLANTA", name: "Planta/Piso (Floor)", variants: ["PLANTA", "PISO"], kind: "numbered", requiresNumber: true },
+    {
+        code: "PLANTA BAJA",
+        name: "Planta Baja (Ground floor)",
+        variants: ["PLANTA BAJA", "BAJO", "PB"],
+        kind: "ground",
+        requiresNumber: false,
+    },
+    {
+        code: "ENTRESUELO",
+        name: "Entresuelo (Mezzanine)",
+        variants: ["ENTRESUELO"],
+        kind: "fractionalAboveGround",
+        requiresNumber: false,
+    },
+    {
+        code: "PRINCIPAL",
+        name: "Principal",
+        variants: ["PRINCIPAL"],
+        kind: "fixedOrdinal",
+        requiresNumber: false,
+        fixedOrdinal: 1,
+    },
+    {
+        code: "SÓTANO",
+        name: "Sótano (Basement)",
+        variants: ["SÓTANO", "SOTANO"],
+        kind: "basement",
+        requiresNumber: true,
+    },
+    {
+        code: "ÁTICO",
+        name: "Ático (Attic/penthouse)",
+        variants: ["ÁTICO", "ATICO"],
+        kind: "special",
+        requiresNumber: false,
+    },
+];
+/** Italian floor/level vocabulary. */
+export const IT_LEVEL_DESIGNATORS = [
+    { code: "PIANO", name: "Piano (Floor)", variants: ["PIANO"], kind: "numbered", requiresNumber: true },
+    {
+        code: "PIANO TERRA",
+        name: "Piano Terra (Ground floor)",
+        variants: ["PIANO TERRA", "PT"],
+        kind: "ground",
+        requiresNumber: false,
+    },
+    {
+        code: "SEMINTERRATO",
+        name: "Seminterrato (Semi-basement)",
+        variants: ["SEMINTERRATO"],
+        kind: "fractionalBelowGround",
+        requiresNumber: false,
+    },
+    {
+        code: "ATTICO",
+        name: "Attico (Attic/penthouse)",
+        variants: ["ATTICO"],
+        kind: "special",
+        requiresNumber: false,
+    },
+];
+/** Portuguese floor/level vocabulary. */
+export const PT_LEVEL_DESIGNATORS = [
+    { code: "ANDAR", name: "Andar (Floor)", variants: ["ANDAR"], kind: "numbered", requiresNumber: true },
+    {
+        code: "RÉS-DO-CHÃO",
+        name: "Rés-do-chão (Ground floor)",
+        variants: ["RÉS-DO-CHÃO", "RES-DO-CHAO", "RC"],
+        kind: "ground",
+        requiresNumber: false,
+    },
+    { code: "CAVE", name: "Cave (Basement)", variants: ["CAVE"], kind: "basement", requiresNumber: true },
+];
+/** Dutch floor/level vocabulary. */
+export const NL_LEVEL_DESIGNATORS = [
+    {
+        code: "VERDIEPING",
+        name: "Verdieping (Floor)",
+        variants: ["VERDIEPING", "VERD"],
+        kind: "numbered",
+        requiresNumber: true,
+    },
+    {
+        code: "BEGANE GROND",
+        name: "Begane Grond (Ground floor)",
+        variants: ["BEGANE GROND", "BG"],
+        kind: "ground",
+        requiresNumber: false,
+    },
+    { code: "KELDER", name: "Kelder (Basement)", variants: ["KELDER"], kind: "basement", requiresNumber: true },
+];
+/**
+ * Japanese (and generic CJK numeral+letter) floor/level vocabulary. Japanese addresses write the numbered floor as a
+ * trailing "F" suffix on the number ("2F", "地下1F"/"B1F") or the kanji "階" ("2階"); there is no distinct bare word for
+ * "ground floor" the way RDC/EG/PLANTA BAJA exist in Europe — "1F"/"1階" already IS ground (handled by the `"numbered"`
+ * kind + the ja-JP `firstNumberedIsGround: true` convention, not a separate `"ground"` row). "B" (and "地下", literally
+ * "underground") name the basement count the same way English "B1" does.
+ */
+export const JA_LEVEL_DESIGNATORS = [
+    { code: "F", name: "階 (Floor)", variants: ["F", "階"], kind: "numbered", requiresNumber: true },
+    { code: "B", name: "地下 (Basement)", variants: ["B", "地下"], kind: "basement", requiresNumber: true },
+    { code: "RF", name: "屋上 (Rooftop)", variants: ["RF", "屋上", "ROOFTOP"], kind: "special", requiresNumber: false },
+];
+/** Swedish floor/level vocabulary. */
+export const SV_LEVEL_DESIGNATORS = [
+    { code: "VÅNING", name: "Våning (Floor)", variants: ["VÅNING", "VANING"], kind: "numbered", requiresNumber: true },
+    {
+        code: "BOTTENVÅNING",
+        name: "Bottenvåning (Ground floor)",
+        variants: ["BOTTENVÅNING", "BOTTENVANING", "BV"],
+        kind: "ground",
+        requiresNumber: false,
+    },
+    {
+        code: "KÄLLARE",
+        name: "Källare (Basement)",
+        variants: ["KÄLLARE", "KALLARE"],
+        kind: "basement",
+        requiresNumber: true,
+    },
+];
+/**
+ * Norwegian floor/level vocabulary. GATEPLAN ("street level") is a lower-confidence, regional inclusion for the
+ * ground-floor row — see the module header's Nordic-vocabulary caveat.
+ */
+export const NO_LEVEL_DESIGNATORS = [
+    { code: "ETASJE", name: "Etasje (Floor)", variants: ["ETASJE"], kind: "numbered", requiresNumber: true },
+    {
+        code: "GATEPLAN",
+        name: "Gateplan (Street/ground level)",
+        variants: ["GATEPLAN"],
+        kind: "ground",
+        requiresNumber: false,
+    },
+    { code: "KJELLER", name: "Kjeller (Basement)", variants: ["KJELLER"], kind: "basement", requiresNumber: true },
+];
+/** Danish floor/level vocabulary. STUEN/STUEETAGE ("st.") is the standard ground-floor term seen on Danish addresses. */
+export const DA_LEVEL_DESIGNATORS = [
+    { code: "ETAGE", name: "Etage (Floor)", variants: ["ETAGE"], kind: "numbered", requiresNumber: true },
+    {
+        code: "STUEN",
+        name: "Stuen/Stueetage (Ground floor)",
+        variants: ["STUEN", "STUEETAGE", "ST"],
+        kind: "ground",
+        requiresNumber: false,
+    },
+    {
+        code: "KÆLDER",
+        name: "Kælder (Basement)",
+        variants: ["KÆLDER", "KAELDER"],
+        kind: "basement",
+        requiresNumber: true,
+    },
+];
+/** Every language family's level-designator lexicon, keyed by bare language tag. */
+export const LEVEL_DESIGNATORS_BY_FAMILY = {
+    en: EN_LEVEL_DESIGNATORS,
+    fr: FR_LEVEL_DESIGNATORS,
+    de: DE_LEVEL_DESIGNATORS,
+    es: ES_LEVEL_DESIGNATORS,
+    it: IT_LEVEL_DESIGNATORS,
+    pt: PT_LEVEL_DESIGNATORS,
+    nl: NL_LEVEL_DESIGNATORS,
+    ja: JA_LEVEL_DESIGNATORS,
+    sv: SV_LEVEL_DESIGNATORS,
+    no: NO_LEVEL_DESIGNATORS,
+    da: DA_LEVEL_DESIGNATORS,
+};
+/**
+ * Per-family inverse lookup (lowercase variant → its designator row), built once at module load. Structural integrity
+ * check runs here: every row must carry at least one non-blank variant, and no variant may repeat WITHIN a family
+ * (case-insensitive) — a malformed table throws loudly at import time rather than silently producing an ambiguous
+ * lexicon. Collisions ACROSS families are expected and fine (that's the entire point of this module: "UG" is Upper
+ * Ground in English but Untergeschoss in German — same token, different family, different meaning).
+ */
+const LEVEL_DESIGNATOR_LOOKUP_BY_FAMILY = (() => {
+    const byFamily = new Map();
+    for (const family of Object.keys(LEVEL_DESIGNATORS_BY_FAMILY)) {
+        const rows = LEVEL_DESIGNATORS_BY_FAMILY[family];
+        const lookup = new Map();
+        for (const row of rows) {
+            if (row.variants.length === 0) {
+                throw new Error(`[codex/level-semantics] family "${family}" designator "${row.code}" has no variants`);
+            }
+            for (const variant of row.variants) {
+                if (!variant || !variant.trim()) {
+                    throw new Error(`[codex/level-semantics] family "${family}" designator "${row.code}" has an empty or blank variant`);
+                }
+                const key = variant.toLowerCase();
+                const existing = lookup.get(key);
+                if (existing) {
+                    throw new Error(`[codex/level-semantics] family "${family}" has a duplicate variant "${variant}" (designators "${existing.code}" and "${row.code}")`);
+                }
+                lookup.set(key, row);
+            }
+        }
+        byFamily.set(family, lookup);
+    }
+    return byFamily;
+})();
+const LEVEL_LOCALE_FAMILIES = new Set(Object.keys(LEVEL_DESIGNATORS_BY_FAMILY));
+/** BCP-47-ish language tags that fold into the Norwegian family (Bokmål, Nynorsk, and the deprecated macrolanguage tag). */
+const NORWEGIAN_LANGUAGE_TAGS = new Set(["no", "nb", "nn"]);
+/**
+ * Split `locale` into `{ language, region }`, lowercasing the language and uppercasing the region. Tolerant of a bare
+ * language tag (no region).
+ */
+function splitLocaleTag(locale) {
+    const [language, region] = locale.split("-");
+    return { language: (language ?? "").toLowerCase(), region: region?.toUpperCase() };
+}
+/** Resolve a BCP-47-ish locale tag to its {@link LevelLocaleFamily}, or `undefined` if this module has no lexicon for it. */
+function localeFamily(locale) {
+    const { language } = splitLocaleTag(locale);
+    const family = NORWEGIAN_LANGUAGE_TAGS.has(language) ? "no" : language;
+    return LEVEL_LOCALE_FAMILIES.has(family) ? family : undefined;
+}
+/**
+ * Per-FULL-LOCALE ordinal convention overrides. Keyed by full locale (not bare language family) because English splits
+ * by country even though the vocabulary doesn't: American and Canadian buildings number the ground floor "1"; British
+ * buildings do not. "CA" (English or French) buckets with the US/Japan convention per real-world North American
+ * building-code practice, though individual Quebec buildings can and do vary.
+ */
+export const LEVEL_ORDINAL_CONVENTIONS = {
+    "en-US": { firstNumberedIsGround: true },
+    "en-CA": { firstNumberedIsGround: true },
+    "en-GB": { firstNumberedIsGround: false },
+    "fr-CA": { firstNumberedIsGround: true },
+    "ja-JP": { firstNumberedIsGround: true },
+};
+/**
+ * Default convention per language family, used when {@link levelToOrdinal} is given a bare-language locale ("fr" with no
+ * country) or a country this table doesn't specifically override. Every entry here follows the
+ * continental-European/IMDF convention (ground is its own designator; numbered floors start at 1 for the storey above)
+ * except Japanese, which follows the US/CA convention. English has NO family-wide default — American/Canadian and
+ * British buildings disagree, so a bare "en" locale intentionally resolves to `undefined` rather than guessing.
+ */
+const FAMILY_DEFAULT_ORDINAL_CONVENTION = {
+    fr: { firstNumberedIsGround: false },
+    de: { firstNumberedIsGround: false },
+    es: { firstNumberedIsGround: false },
+    it: { firstNumberedIsGround: false },
+    pt: { firstNumberedIsGround: false },
+    nl: { firstNumberedIsGround: false },
+    sv: { firstNumberedIsGround: false },
+    no: { firstNumberedIsGround: false },
+    da: { firstNumberedIsGround: false },
+    ja: { firstNumberedIsGround: true },
+};
+/**
+ * Resolve the ordinal convention for `locale`: an exact full-locale override, else the language family's default, else
+ * `undefined`.
+ */
+function resolveOrdinalConvention(locale) {
+    const { language, region } = splitLocaleTag(locale);
+    const normalized = region ? `${language}-${region}` : language;
+    if (LEVEL_ORDINAL_CONVENTIONS[normalized]) {
+        return LEVEL_ORDINAL_CONVENTIONS[normalized];
+    }
+    const family = localeFamily(locale);
+    return family ? FAMILY_DEFAULT_ORDINAL_CONVENTION[family] : undefined;
+}
+/**
+ * Look up a level designator (by canonical code, abbreviation, or any recognized variant) within a locale's language
+ * family. Case-insensitive. Returns `undefined` when the locale's family is unknown to this module, or the token isn't
+ * a recognized designator in that family.
+ */
+export function lookupLevelDesignator(designator, locale) {
+    if (!designator || typeof designator !== "string")
+        return undefined;
+    const family = localeFamily(locale);
+    if (!family)
+        return undefined;
+    return LEVEL_DESIGNATOR_LOOKUP_BY_FAMILY.get(family)?.get(designator.trim().toLowerCase());
+}
+/** True when `input` is a recognized level designator (case-insensitive) in `locale`'s language family. */
+export function isLevelDesignatorToken(input, locale) {
+    return typeof input === "string" && lookupLevelDesignator(input, locale) !== undefined;
+}
+/**
+ * Map a (designator, number) pair to an IMDF-style signed integer ordinal, given the semantics of `locale`. Ground is
+ * always 0. Returns `undefined` when:
+ *
+ * - `locale`'s language family has no lexicon in this module,
+ * - `designator` isn't a recognized token in that family,
+ * - The designator is `"special"` (penthouse/roof/attic — no locale-independent ordinal exists), or
+ * - The designator is `"numbered"` but either `number` is missing or the locale has no resolvable ordinal convention (a
+ *   bare "en" locale, for example).
+ *
+ * @example
+ * 	levelToOrdinal("FL", 1, "en-US") // → 0 (US: 1st floor IS ground)
+ * 	levelToOrdinal("étage", 1, "fr-FR") // → 1 (FR: 1st étage is one storey above ground)
+ * 	levelToOrdinal("EG", undefined, "de-DE") // → 0 (ground, number ignored)
+ * 	levelToOrdinal("B", 1, "en-US") // → -1 (basement 1)
+ * 	levelToOrdinal("F", 1, "ja-JP") // → 0 (JP: 1F IS ground)
+ * 	levelToOrdinal("B", 1, "ja-JP") // → -1 (JP: B1F)
+ */
+export function levelToOrdinal(designator, number, locale) {
+    const row = lookupLevelDesignator(designator, locale);
+    if (!row)
+        return undefined;
+    switch (row.kind) {
+        case "ground":
+            return 0;
+        case "fractionalAboveGround":
+            return 0;
+        case "fractionalBelowGround":
+            return -1;
+        case "special":
+            return undefined;
+        case "fixedOrdinal":
+            return row.fixedOrdinal;
+        case "basement":
+            return -Math.abs(number ?? 1);
+        case "numbered": {
+            if (number === undefined)
+                return undefined;
+            const convention = resolveOrdinalConvention(locale);
+            if (!convention)
+                return undefined;
+            return convention.firstNumberedIsGround ? number - 1 : number;
+        }
+        default:
+            return undefined;
+    }
+}
+//# sourceMappingURL=level-semantics.js.map

package/out/level-semantics.js.map

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

package/out/tools/build-country-surface-lexicon.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Build the COUNTRY-SURFACE LEXICON for the country-lexicon soft-feed channel (#1104). This is the
+ *   third atlas channel, a sibling of the postcode anchor (#239/#240) and the gazetteer anchor
+ *   (#464): a per-token multi-hot clue the neural GRAMMAR conditions on but never obeys. Country is a
+ *   CLOSED, ENUMERABLE class (~250 surfaces) — atlas, not grammar — so a dictionary phrase-lookup
+ *   recovers the WOF-admin / resolver hierarchy case ("United States of America, Wyoming, <locality>")
+ *   the learned tagger reads as a leading STREET. Pelias handled the same class the same way
+ *   (`WhosOnFirstClassifier extends PhraseClassifier`); this is the model-first analogue.
+ *
+ *   WHY A DEDICATED LEXICON (not just the gazetteer's `country` slot): the gazetteer already carries
+ *   these surfaces in slot 0, and the shipped model already consumes them — yet the WOF-admin case
+ *   still fails (model-card #1104: golden country recall 82.0% vs 88.6%). The country bit is one of a
+ *   5-hot vector sharing ONE learned projection with region/po_box/cedex/homograph, and it is ZEROED
+ *   adjacent to a postcode by `suppress_gazetteer_near_postcode` (exactly where a trailing "…12345
+ *   USA" sits). A dedicated channel de-entangles the country signal (its own projection + confidence
+ *   weight) and is immune to that suppression. See
+ *   docs/superpowers/plans/2026-07-14-country-lexicon-channel.md.
+ *
+ *   The matcher REUSES the gazetteer's phrase-scan (longest-first n-gram over whitespace words,
+ *   case-insensitive `entries` + uppercase-exact `code_entries`, char→piece projection) — one tested
+ *   algorithm, two vocabularies. Only the vocabulary + the emitted feature differ. The emitted
+ *   feature is 2-dim per piece: `[country_surface, country_ambiguous]`.
+ *
+ *   - `country_surface` (bit 1): the piece is part of a recognized country surface phrase.
+ *   - `country_ambiguous` (bit 2): the SURFACE is a homograph (also a US region) or a common-word
+ *     name ("Georgia", "America", "England", "IN") — a SOFT version of Pelias's hard blacklist. The
+ *     model learns to trust `surface & !ambiguous` (unambiguous long/code forms) strongly and
+ *     `surface & ambiguous` weakly, using context — model-first, never a hard drop, so recall on
+ *     "Republic of Georgia" is preserved.
+ *
+ *   Source of truth: `@mailwoman/codex` (COUNTRY_SURFACE_FORMS + ISO2_TO_NAME) — the SAME data the
+ *   corpus-python bridge `country-surfaces.json` is generated from (export-country-surfaces.ts), so
+ *   the channel and the corpus shard synthesizer cannot diverge on what a country surface IS.
+ *
+ *   Output: data/gazetteer/country-surface-lexicon-v1.json (small, committed, provenance-tracked).
+ *   Regenerate: `node codex/tools/build-country-surface-lexicon.ts`
+ */
+export {};
+//# sourceMappingURL=build-country-surface-lexicon.d.ts.map

package/out/tools/build-country-surface-lexicon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-country-surface-lexicon.d.ts","sourceRoot":"","sources":["../../tools/build-country-surface-lexicon.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG"}