@mailwoman/resolver-wof-sqlite 10.0.0 → 10.2.0

package/out/proximity-rerank.js.map

@@ -1 +1 @@
-{"version":3,"file":"proximity-rerank.js","sourceRoot":"","sources":["../lib/proximity-rerank.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAEhD;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAA;AAE3B;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAA;AAE1B;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAA;AAEhC;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,CAAA;AAsB/B;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAA8B,EAAE,IAA8B;IAChG,MAAM,OAAO,GAAG,SAAS,CAAC,UAAU,IAAI,SAAS,CAAC,KAAK,CAAA;IACvD,MAAM,OAAO,GAAG,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,eAAe,CAAC,CAAA;IAC/E,IAAI,QAAQ,GAAG,CAAC,CAAA;IAEhB,+GAA+G;IAC/G,wBAAwB;IACxB,IAAI,CAAC,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC,IAAI,SAAS,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;QACnD,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACtB,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,SAAS,CAAC,GAAG,EAAE,SAAS,CAAC,GAAG,CAAC,CAAA;YACjE,MAAM,IAAI,GAAG,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,CAAA;YAErE,IAAI,IAAI,GAAG,QAAQ,EAAE,CAAC;gBACrB,QAAQ,GAAG,IAAI,CAAA;YAChB,CAAC;QACF,CAAC;IACF,CAAC;IAED,OAAO,OAAO,GAAG,QAAQ,CAAA;AAC1B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CACnC,UAAe,EACf,IAA8B;IAE9B,UAAU;SACR,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACb,CAAC,CAAC,UAAU,GAAG,kBAAkB,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA;QAE1C,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,UAAU,EAAE,CAAA;IACjC,CAAC,CAAC;QACF,8HAA8H;SAC7H,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;SACtC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAE1C,OAAO,UAAU,CAAA;AAClB,CAAC"}
+{"version":3,"file":"proximity-rerank.js","sourceRoot":"","sources":["../lib/proximity-rerank.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAEhD;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAA;AAE3B;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAA;AAE1B;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAA;AAEhC;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,CAAA;AAwB/B;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAA8B,EAAE,IAA8B;IAChG,MAAM,OAAO,GAAG,SAAS,CAAC,UAAU,IAAI,SAAS,CAAC,KAAK,CAAA;IACvD,MAAM,OAAO,GAAG,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,eAAe,CAAC,CAAA;IAC/E,IAAI,QAAQ,GAAG,CAAC,CAAA;IAEhB,qFAAqF;IACrF,+EAA+E;IAC/E,IAAI,CAAC,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC,IAAI,SAAS,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;QACnD,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACtB,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,SAAS,CAAC,GAAG,EAAE,SAAS,CAAC,GAAG,CAAC,CAAA;YACjE,MAAM,IAAI,GAAG,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,CAAA;YAErE,IAAI,IAAI,GAAG,QAAQ,EAAE,CAAC;gBACrB,QAAQ,GAAG,IAAI,CAAA;YAChB,CAAC;QACF,CAAC;IACF,CAAC;IAED,OAAO,OAAO,GAAG,QAAQ,CAAA;AAC1B,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CACnC,UAAe,EACf,IAA8B;IAE9B,UAAU;SACR,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACb,CAAC,CAAC,UAAU,GAAG,kBAAkB,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA;QAE1C,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,UAAU,EAAE,CAAA;IACjC,CAAC,CAAC;QACF,8HAA8H;SAC7H,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;SACtC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAE1C,OAAO,UAAU,CAAA;AAClB,CAAC"}

package/out/ranking-weights.d.ts

@@ -3,13 +3,14 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- *   The locality-ranking weights and their shipped defaults. Its own module because every value here is
- *   a measured tuning decision with its rationale attached — the block reads as a reference table, not
- *   as part of the lookup's control flow, and the tests import it directly to pin one change at a time.
+ *   The locality-ranking weights and their shipped defaults live here because each value is a measured tuning decision
+ *   with its rationale attached. This block reads as a reference table outside the lookup's control flow.
+ *   Tests import it directly to pin one change at a time.
  */
 /**
- * Ranking weights for `findPlace`. Tweakable per-instance but defaults match the values declared in the Phase 4.2 plan
- * doc.
+ * The weights used to rank `findPlace` results.
+ *
+ * Tweakable per-instance but defaults match the values declared in the Phase 4.2 plan doc.
  */
 export interface RankingWeights {
     /**
@@ -37,94 +38,127 @@ export interface RankingWeights {
      */
     lengthPenaltyWeight: number;
     /**
-     * Magnitude of the proximity boost when the query carries `near`. The contribution is `proximityBoost / (1 +
-     * distanceKm / proximityScaleKm)` — at distance 0 the boost is full magnitude, at `proximityScaleKm` it's half,
-     * decaying further with distance. Default tuned so proximity can overcome a typical FTS rank tie but not dominate a
-     * strong text match.
+     * Magnitude of the proximity boost when the query includes `near`.
+     *
+     * The contribution is `proximityBoost / (1 + distanceKm / proximityScaleKm)`.
+     * At distance 0 the boost has full magnitude.
+     *
+     * At `proximityScaleKm` it is half magnitude.
+     * It decays further as distance increases.
+     *
+     * Its default is tuned so proximity can overcome a typical FTS rank tie
+     * but not dominate a strong text match.
      */
     proximityBoost: number;
     /**
-     * Magnitude of the bias-hint term inside the exact-tier PROMINENCE sort (the `bias`/viewport path). Deliberately
-     * population-scale (default = populationBoost) so a candidate near the map view / the user beats a distant-but-bigger
-     * namesake — "the map view wins" is the feature; same-region ties (all candidates far from every hint) still fall to
-     * population.
+     * Magnitude of the bias-hint term inside the exact-tier prominence sort (the `bias`/viewport path).
+     *
+     * Deliberately population-scale, so a candidate near the map view
+     * or the user beats a distant-but-bigger namesake.
+     * "The map view wins" is the feature.
+     *
+     * Same-region ties, where all candidates are far from every hint, still fall to population.
+     *
+     * @defaultValue the same value as `populationBoost`
      */
     biasBoost: number;
     /**
-     * Distance (km) at which the proximity boost halves. Tune to the typical query radius.
+     * Distance (km) at which the proximity boost halves.
+     *
+     * Tune to the typical query radius.
      */
     proximityScaleKm: number;
     /**
-     * Magnitude of the population boost when the candidate has a known `wof:population`. The contribution is
-     * `populationBoost * log10(1 + population) / populationScaleLog10`, capped at `populationBoost`. WOF only carries
-     * population for ~15% of localities (mostly larger ones); places without it get +0 (never a penalty). Default tuned
-     * so the famous Springfield, IL (pop ~112k) gets ~0.42 boost — enough to nudge past tiny same-name peers.
+     * Magnitude of the population boost when the candidate has a known `wof:population`.
+     *
+     * The contribution is `populationBoost * log10(1 + population) / populationScaleLog10`,
+     * capped at `populationBoost`.
+     * WOF records population for about 15% of localities (mostly larger ones),
+     * and places without it get +0, never a penalty.
+     *
+     * Its default is tuned so the famous Springfield, IL (pop ~112k) gets about a 0.42 boost,
+     * enough to nudge past tiny same-name peers.
      */
     populationBoost: number;
     /**
-     * Population (in log10) at which the boost reaches its full magnitude. Default 6 — i.e. a population of 1,000,000
-     * gives `populationBoost` exactly. Larger populations cap at the same value (no compounding effect for megacities).
+     * Population (in log10) at which the boost reaches its full magnitude.
+     *
+     * Larger populations cap at the same value (no compounding effect for megacities).
+     *
+     * @defaultValue `6`, so a population of 1,000,000 gives `populationBoost` exactly
      */
     populationScaleLog10: number;
     /**
-     * Tier candidates with an EXACT name/alias match above candidates that only match partially, BEFORE the weighted-sum
-     * score is consulted. Default true.
-     *
-     * Why this is needed (and why it ALIGNS with — rather than overrides — the population/importance signal): the
-     * weighted sum adds population as a large additive boost (`populationBoost`, up to +4) so that famous places surface
-     * for unambiguous full-name queries. But population is a _prominence prior_ — its job is to break ties among
-     * candidates that match the query EQUALLY WELL (e.g. "Springfield" → Springfield IL over Springfield MA, both exact
-     * name matches). It was never meant to promote a place that matches the query WORSE. For a 2-letter region
-     * abbreviation that backfires: querying "ME" returns Maine (which has the exact alias `ME`) AND Missouri/
-     * Michigan/etc. (which do not), and Missouri's larger population (+4) overcomes Maine's bm25 edge — so "Portland, ME"
-     * resolves its region to Missouri and the locality then cascades to the wrong state. Tiering restores the intended
-     * ordering: **match quality is the primary key, prominence (population) the secondary key WITHIN a tier.**
-     * Springfield-IL-over-MA still works (both exact → same tier → population decides); ME→Maine now works (only Maine is
-     * exact → higher tier → population never gets to override it). See
-     * docs/articles/evals/resolver-geo/2026-05-30-resolver-exact-match.md.
-     *
-     * Note: tiering re-ranks within the over-fetched candidate window (`limit * 4`); a pathological exact match that
-     * falls outside that window is not rescued. For the region-abbrev case the window is comfortably sufficient (a
-     * handful of states match a 2-letter query).
+     * Tier candidates with an exact name/alias match above candidates that only match
+     * partially, before the weighted-sum score is consulted.
+     *
+     * The weighted sum adds population as a large additive boost, so famous places
+     * surface for unambiguous full-name queries.
+     * Population is a prominence prior.
+     *
+     * Its job is to break ties among candidates that match the query equally well,
+     * as in "Springfield" → Springfield IL over Springfield MA.
+     *
+     * It does not promote a place that matches the query worse.
+     * Tiers keep match quality as the primary key and prominence as the secondary key within each tier.
+     *
+     * Note: tiering re-ranks within the over-fetched candidate window (`limit * 4`),
+     * so a pathological exact match outside that window is not rescued.
+     *
+     * @defaultValue `true`
      */
     exactMatchTiering: boolean;
     /**
-     * #936 option 3 — official-language names ARE names. When true, a candidate holding the query as an OFFICIAL name
-     * (`names.official = 1`: a preferred-form name in an official language of its country, stamped at ingest) joins the
-     * NAME-exact sub-tier rather than the alias-exact one, provided its population clears {@link officialNameExactFloor}.
-     * Fixes unscoped "Åbo" → Turku (its official Swedish name) over a hamlet literally named Åbo; population still orders
-     * within the sub-tier, so Paris → Paris FR is untouched.
-     *
-     * Default true (operator-promoted 2026-07-03 after the pre-registered eval battery: four intended exonym flips —
-     * Berne→Bern, Bruges→Brugge, Roma→Rome, Åbo→Turku — with the namesake/abbreviation rows and the US/FI panels
-     * byte-identical). Requires a gazetteer carrying the #940 ingest bit — on older DBs without the `official` column the
-     * probe fails soft and behavior is identical to the flag being off.
+     * Official-language names count as names.
+     *
+     * When true, a candidate holding the query as an official name (`names.official = 1`,
+     * a preferred-form name in an official language of its country, stamped at ingest)
+     * joins the name-exact sub-tier rather than the alias-exact one, provided its
+     * population clears {@link officialNameExactFloor}.
+     *
+     * Fixes unscoped "Åbo" → Turku (its official Swedish name) over a hamlet literally called Åbo.
+     * Population still orders within the sub-tier, so Paris → Paris FR is untouched.
+     *
+     * It requires a gazetteer carrying the `official` ingest bit.
+     *
+     * On older DBs without that column, the probe fails soft and behavior matches the flag being off.
+     *
+     * @defaultValue `true`
      */
     officialNameExact: boolean;
     /**
-     * Minimum population for a candidate's official names to join the name-exact sub-tier. The #936 review's no-floor
-     * census measured the boundary: ≥100k holders are the famous-exonym class (757 flips, intent-correct; 7 collisions,
-     * none harmful) while 10k–100k holders are junk-dominated (3,481 flips led by short-form mis-tags — Villeneuve-Loubet
-     * carrying "villeneuve" would bury five real villages of that name). Rank-time knob: tunable without re-ingest;
-     * below-floor official names simply stay alias-tier (today's behavior).
+     * Minimum population for a candidate's official names to join the name-exact sub-tier.
+     *
+     * The floor separates the famous-exonym class from a junk-dominated one led by short-form
+     * mis-tags, where a place carrying a short form would bury real villages of that name.
+     * This is a rank-time knob, tunable without re-ingest.
+     * Below-floor official names stay in the alias tier.
      */
     officialNameExactFloor: number;
 }
 /**
- * The shipped weights. Every value is a measured decision — change one and re-run the resolver eval; the per-field docs
- * on {@link RankingWeights} say what each change moves and what motivated its current value.
+ * The shipped weights.
+ *
+ * Every value is a measured decision, so change one and re-run the resolver eval.
+ * The per-field docs on {@link RankingWeights} say what each change moves.
  */
 export declare const DEFAULT_WEIGHTS: RankingWeights;
 /**
- * The population contribution as a 0..1 fraction: `min(1, log10(1 + population) / populationScaleLog10)`. Zero for an
- * absent or non-positive population — and zero for a non-positive scale, so a magnitude never carries its own absence.
- * The coordinate-first locality path consumes this fraction directly; {@link populationBoostTerm} scales it.
+ * The population contribution as a 0..1 fraction: `min(1, log10(1 + population) / populationScaleLog10)`.
+ *
+ * Returns zero for an absent or non-positive population.
+ * It also returns zero for a non-positive scale.
+ *
+ * A magnitude never represents its own absence.
+ * The coordinate-first locality path consumes this fraction directly. {@link populationBoostTerm} scales it.
  */
-export declare function populationScaleTerm(population: number | null | undefined, weights: Pick<RankingWeights, "populationScaleLog10">): number;
+export declare function populationScaleTerm(population: number | null, weights: Pick<RankingWeights, "populationScaleLog10">): number;
 /**
- * The additive population boost: `populationBoost * populationScaleTerm(...)`, capped at `populationBoost` magnitude at
- * `10^populationScaleLog10` people. Missing population contributes 0 — never a penalty. The one formula behind the Node
- * weighted sum and the WASM re-rank, so the two backends cannot drift.
+ * The additive population boost: `populationBoost * populationScaleTerm(...)`,
+ * capped at `populationBoost` magnitude at `10^populationScaleLog10` people.
+ *
+ * A missing population contributes 0, without a penalty.
+ * The one formula behind the Node weighted sum and the wasm re-rank, so the two backends cannot drift.
  */
-export declare function populationBoostTerm(population: number | null | undefined, weights: Pick<RankingWeights, "populationBoost" | "populationScaleLog10">): number;
+export declare function populationBoostTerm(population: number | null, weights: Pick<RankingWeights, "populationBoost" | "populationScaleLog10">): number;
 //# sourceMappingURL=ranking-weights.d.ts.map

package/out/ranking-weights.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ranking-weights.d.ts","sourceRoot":"","sources":["../lib/ranking-weights.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC9B;;OAEG;IACH,mBAAmB,EAAE,MAAM,CAAA;IAC3B;;OAEG;IACH,qBAAqB,EAAE,MAAM,CAAA;IAC7B;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAA;IACzB;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAA;IACxB;;OAEG;IACH,eAAe,EAAE,MAAM,CAAA;IACvB;;OAEG;IACH,mBAAmB,EAAE,MAAM,CAAA;IAC3B;;;;;OAKG;IACH,cAAc,EAAE,MAAM,CAAA;IACtB;;;;;OAKG;IACH,SAAS,EAAE,MAAM,CAAA;IACjB;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAA;IACxB;;;;;OAKG;IACH,eAAe,EAAE,MAAM,CAAA;IACvB;;;OAGG;IACH,oBAAoB,EAAE,MAAM,CAAA;IAC5B;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,iBAAiB,EAAE,OAAO,CAAA;IAC1B;;;;;;;;;;;OAWG;IACH,iBAAiB,EAAE,OAAO,CAAA;IAC1B;;;;;;OAMG;IACH,sBAAsB,EAAE,MAAM,CAAA;CAC9B;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,cA6B7B,CAAA;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAClC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACrC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,sBAAsB,CAAC,GACnD,MAAM,CAIR;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAClC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACrC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,iBAAiB,GAAG,sBAAsB,CAAC,GACvE,MAAM,CAER"}
+{"version":3,"file":"ranking-weights.d.ts","sourceRoot":"","sources":["../lib/ranking-weights.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC9B;;OAEG;IACH,mBAAmB,EAAE,MAAM,CAAA;IAC3B;;OAEG;IACH,qBAAqB,EAAE,MAAM,CAAA;IAC7B;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAA;IACzB;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAA;IACxB;;OAEG;IACH,eAAe,EAAE,MAAM,CAAA;IACvB;;OAEG;IACH,mBAAmB,EAAE,MAAM,CAAA;IAC3B;;;;;;;;;;;OAWG;IACH,cAAc,EAAE,MAAM,CAAA;IACtB;;;;;;;;;;OAUG;IACH,SAAS,EAAE,MAAM,CAAA;IACjB;;;;OAIG;IACH,gBAAgB,EAAE,MAAM,CAAA;IACxB;;;;;;;;;;OAUG;IACH,eAAe,EAAE,MAAM,CAAA;IACvB;;;;;;OAMG;IACH,oBAAoB,EAAE,MAAM,CAAA;IAC5B;;;;;;;;;;;;;;;;;;OAkBG;IACH,iBAAiB,EAAE,OAAO,CAAA;IAC1B;;;;;;;;;;;;;;;;OAgBG;IACH,iBAAiB,EAAE,OAAO,CAAA;IAC1B;;;;;;;OAOG;IACH,sBAAsB,EAAE,MAAM,CAAA;CAC9B;AAED;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,cAsB7B,CAAA;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAClC,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,sBAAsB,CAAC,GACnD,MAAM,CAIR;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAClC,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,iBAAiB,GAAG,sBAAsB,CAAC,GACvE,MAAM,CAER"}

package/out/ranking-weights.js

@@ -3,13 +3,15 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- *   The locality-ranking weights and their shipped defaults. Its own module because every value here is
- *   a measured tuning decision with its rationale attached — the block reads as a reference table, not
- *   as part of the lookup's control flow, and the tests import it directly to pin one change at a time.
+ *   The locality-ranking weights and their shipped defaults live here because each value is a measured tuning decision
+ *   with its rationale attached. This block reads as a reference table outside the lookup's control flow.
+ *   Tests import it directly to pin one change at a time.
  */
 /**
- * The shipped weights. Every value is a measured decision — change one and re-run the resolver eval; the per-field docs
- * on {@link RankingWeights} say what each change moves and what motivated its current value.
+ * The shipped weights.
+ *
+ * Every value is a measured decision, so change one and re-run the resolver eval.
+ * The per-field docs on {@link RankingWeights} say what each change moves.
  */
 export const DEFAULT_WEIGHTS = {
     placetypeMatchBoost: 0.5,
@@ -21,30 +23,27 @@ export const DEFAULT_WEIGHTS = {
     proximityBoost: 0.8,
     proximityScaleKm: 100,
     biasBoost: 4,
-    // populationBoost is intentionally large — empirical tuning against real WOF showed BM25 gaps
-    // of 1.5-3.0 between famous places and tiny same-name peers (because the famous ones have
-    // hundreds of alt-name entries that hurt their FTS document score). To consistently surface
-    // "the famous one" for unambiguous queries like "New York" or "Chicago", the population signal
-    // needs to dominate. Callers wanting a more conservative balance can drop this in the
-    // RankingWeights override.
-    //
-    // Note: this resolver uses `place_population` directly. The separate `place_importance` table
-    // (Wikipedia-derived) is consumed by the FST layer, not here. See
-    // docs/articles/concepts/importance-vs-population.md for the two-signal contract.
+    // populationBoost is intentionally large.
+    // Real WOF showed BM25 gaps of 1.5 to 3.0 between famous places and tiny same-name peers,
+    // because the famous ones have hundreds of alt-name entries that hurt their FTS document score.
+    // This resolver reads `place_population` directly.
+    // The separate Wikipedia-derived `place_importance` table is consumed by the FST layer.
     populationBoost: 4,
     populationScaleLog10: 6,
-    // Exact name/alias match outranks partial match before the weighted sum (incl. population) is
-    // consulted — keeps population as an intra-tier prominence tiebreaker, not a cross-tier promoter.
-    // Fixes the 2-letter-region-abbrev bug ("ME" → Maine, not the more-populous Missouri).
+    // Exact name and alias matches outrank partial matches before the weighted sum.
+    // This keeps population as an intra-tier prominence tiebreaker instead of a cross-tier promoter.
     exactMatchTiering: true,
-    // #936 option 3 — promoted default-ON 2026-07-03 (eval battery PASS; see the RankingWeights docstring).
     officialNameExact: true,
     officialNameExactFloor: 100_000,
 };
 /**
- * The population contribution as a 0..1 fraction: `min(1, log10(1 + population) / populationScaleLog10)`. Zero for an
- * absent or non-positive population — and zero for a non-positive scale, so a magnitude never carries its own absence.
- * The coordinate-first locality path consumes this fraction directly; {@link populationBoostTerm} scales it.
+ * The population contribution as a 0..1 fraction: `min(1, log10(1 + population) / populationScaleLog10)`.
+ *
+ * Returns zero for an absent or non-positive population.
+ * It also returns zero for a non-positive scale.
+ *
+ * A magnitude never represents its own absence.
+ * The coordinate-first locality path consumes this fraction directly. {@link populationBoostTerm} scales it.
  */
 export function populationScaleTerm(population, weights) {
     if (population == null || population <= 0 || weights.populationScaleLog10 <= 0)
@@ -52,9 +51,11 @@ export function populationScaleTerm(population, weights) {
     return Math.min(1, Math.log10(1 + population) / weights.populationScaleLog10);
 }
 /**
- * The additive population boost: `populationBoost * populationScaleTerm(...)`, capped at `populationBoost` magnitude at
- * `10^populationScaleLog10` people. Missing population contributes 0 — never a penalty. The one formula behind the Node
- * weighted sum and the WASM re-rank, so the two backends cannot drift.
+ * The additive population boost: `populationBoost * populationScaleTerm(...)`,
+ * capped at `populationBoost` magnitude at `10^populationScaleLog10` people.
+ *
+ * A missing population contributes 0, without a penalty.
+ * The one formula behind the Node weighted sum and the wasm re-rank, so the two backends cannot drift.
  */
 export function populationBoostTerm(population, weights) {
     return weights.populationBoost * populationScaleTerm(population, weights);

package/out/ranking-weights.js.map

@@ -1 +1 @@
-{"version":3,"file":"ranking-weights.js","sourceRoot":"","sources":["../lib/ranking-weights.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA0GH;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAmB;IAC9C,mBAAmB,EAAE,GAAG;IACxB,qBAAqB,EAAE,GAAG;IAC1B,iBAAiB,EAAE,GAAG;IACtB,gBAAgB,EAAE,GAAG;IACrB,eAAe,EAAE,GAAG;IACpB,mBAAmB,EAAE,GAAG;IACxB,cAAc,EAAE,GAAG;IACnB,gBAAgB,EAAE,GAAG;IACrB,SAAS,EAAE,CAAC;IACZ,8FAA8F;IAC9F,0FAA0F;IAC1F,4FAA4F;IAC5F,+FAA+F;IAC/F,sFAAsF;IACtF,2BAA2B;IAC3B,EAAE;IACF,8FAA8F;IAC9F,kEAAkE;IAClE,kFAAkF;IAClF,eAAe,EAAE,CAAC;IAClB,oBAAoB,EAAE,CAAC;IACvB,8FAA8F;IAC9F,kGAAkG;IAClG,uFAAuF;IACvF,iBAAiB,EAAE,IAAI;IACvB,wGAAwG;IACxG,iBAAiB,EAAE,IAAI;IACvB,sBAAsB,EAAE,OAAO;CAC/B,CAAA;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAClC,UAAqC,EACrC,OAAqD;IAErD,IAAI,UAAU,IAAI,IAAI,IAAI,UAAU,IAAI,CAAC,IAAI,OAAO,CAAC,oBAAoB,IAAI,CAAC;QAAE,OAAO,CAAC,CAAA;IAExF,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,UAAU,CAAC,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAA;AAC9E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAClC,UAAqC,EACrC,OAAyE;IAEzE,OAAO,OAAO,CAAC,eAAe,GAAG,mBAAmB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAA;AAC1E,CAAC"}
+{"version":3,"file":"ranking-weights.js","sourceRoot":"","sources":["../lib/ranking-weights.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAoIH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAmB;IAC9C,mBAAmB,EAAE,GAAG;IACxB,qBAAqB,EAAE,GAAG;IAC1B,iBAAiB,EAAE,GAAG;IACtB,gBAAgB,EAAE,GAAG;IACrB,eAAe,EAAE,GAAG;IACpB,mBAAmB,EAAE,GAAG;IACxB,cAAc,EAAE,GAAG;IACnB,gBAAgB,EAAE,GAAG;IACrB,SAAS,EAAE,CAAC;IACZ,0CAA0C;IAC1C,0FAA0F;IAC1F,gGAAgG;IAChG,mDAAmD;IACnD,wFAAwF;IACxF,eAAe,EAAE,CAAC;IAClB,oBAAoB,EAAE,CAAC;IACvB,gFAAgF;IAChF,iGAAiG;IACjG,iBAAiB,EAAE,IAAI;IACvB,iBAAiB,EAAE,IAAI;IACvB,sBAAsB,EAAE,OAAO;CAC/B,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CAClC,UAAyB,EACzB,OAAqD;IAErD,IAAI,UAAU,IAAI,IAAI,IAAI,UAAU,IAAI,CAAC,IAAI,OAAO,CAAC,oBAAoB,IAAI,CAAC;QAAE,OAAO,CAAC,CAAA;IAExF,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,UAAU,CAAC,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAA;AAC9E,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAClC,UAAyB,EACzB,OAAyE;IAEzE,OAAO,OAAO,CAAC,eAAe,GAAG,mBAAmB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAA;AAC1E,CAAC"}

package/out/region-keys.d.ts

@@ -3,45 +3,64 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- *   The comparable-key expansion for a parsed REGION qualifier — one function, both consumers (the
- *   #861 rule). The admin-coherence verdicts (`mailwoman/admin-coherence.ts`) fold a qualifier and a
- *   winner-ancestry name through this to decide `confirmed`/`contradicted`; the candidate backend's
- *   admin-containment re-rank (#1717 stage 2, `candidate-lookup.ts`) folds the same qualifier through
- *   it to find the qualifier's own region-class rows in the candidate table. A check that says
- *   `contradicted` and a re-rank that cannot find the qualifier would otherwise be two readings of
- *   one string that silently disagree — the exact drift the shared-function rule exists to prevent.
- *
- *   Lives HERE rather than in `mailwoman` because the dependency points this way: `mailwoman`
+ *   Both consumers use this expansion to compare parsed region qualifiers with stored keys.
+ *   Admin-coherence verdicts (`mailwoman/admin-coherence.ts`) fold a qualifier and the winner's ancestry
+ *   to decide `confirmed` or `contradicted`. The candidate backend's admin-containment re-rank
+ *   (`candidate-lookup.ts`) uses the same fold to find region-class rows. The shared function keeps
+ *   both decisions aligned.
+ *
+ *   Lives here rather than in `mailwoman` because the dependency points this way. `mailwoman`
  *   depends on `@mailwoman/resolver-wof-sqlite` (which owns the fold and already depends on codex),
  *   never the reverse.
  */
 /**
- * The ancestry placetypes that answer for a parsed `region` qualifier — WOF's admin band between country and locality.
- * Deliberately the whole band: a qualifier stated at any grain ("Lancashire", a ceremonial county; "Thüringen", a Land)
- * may confirm against whichever level the backend stored, and `contradicted` requires the entire band to miss, so
- * widening the band only ever makes the check more conservative.
+ * The ancestry placetypes that answer for a parsed `region` qualifier,
+ * WOF's admin band between country and locality.
+ *
+ * The full band covers qualifiers at any grain, such as "Lancashire"
+ * (a ceremonial county) or "Thüringen" (a Land).
+ * A qualifier may confirm against any level the backend stored.
+ *
+ * `contradicted` requires every level in the band to miss.
+ * A wider band makes the check more conservative.
  */
 export declare const REGION_CLASS_PLACETYPES: ReadonlySet<string>;
 /**
- * The comparable keys a region string expands to: its own fold (the shared candidate.db `name_key` normalizer,
- * {@link normalizeLocalityForKey} — build side and check side agree by construction); a county-prefix-stripped variant;
- * the codex subdivision expansions — the disjoint US+CA table always, plus the COUNTRY-SCOPED table when the caller
- * knows a country (`WA` under AU is Western Australia; under US, Washington — the collision that keeps AU out of the
- * unscoped table). Every expansion lands the canonical name and code folds in the set, so `IL`/`Illinois` and
- * `WA`/`Western Australia` meet from either side.
+ * The comparable keys a region string expands to: its own fold (the shared candidate.db `name_key`
+ * normalizer, {@link normalizeLocalityForKey}, so build side and check side agree by construction).
+ *
+ * A county-prefix-stripped variant.
+ * The codex subdivision expansions.
+ *
+ * The disjoint US and CA table always, plus the country-scoped table when the caller knows a country.
+ * `WA` under AU is Western Australia, while under US it is Washington,
+ * the collision that keeps AU out of the unscoped table.
+ *
+ * Every expansion lands the canonical name and code folds in the set, so `IL`
+ * and `Illinois`, or `WA` and `Western Australia`, meet from either side.
  */
-export declare function regionKeys(value: string, countryAlpha2?: string): Set<string>;
+export declare function regionKeys(value: string, countryAlpha2?: string | null): Set<string>;
 /**
- * The PROBE-side expansion for a region qualifier — {@link regionKeys} plus the county-PREFIXED variant of every key.
- *
- * The verdict implementation intersects two {@link regionKeys} SETS, so `Co. Donegal` meets stored `County Donegal` at
- * the shared stripped key `donegal`. A table probe is one-sided: it matches the STORED fold verbatim, and WOF stores
- * Irish counties under `county donegal` with no bare `donegal` key (measured on the shipped candidate.db — the
- * qualifier probe missed every Irish county until this variant landed). Adding `county <key>` restores the
- * two-sidedness for the one stored-form family with an evidenced case; the union is monotone (a wider qualifier set can
- * only find more BEARERS, each of which must still genuinely contain a candidate before anything moves). The suffix
- * sibling (`<key> province`) is deliberately absent — no stored-form case has been evidenced, and a change without a
- * board does not get built.
+ * The probe-side expansion for a region qualifier, {@link regionKeys} plus the
+ * county-prefixed variant of every key.
+ *
+ * The verdict implementation intersects two {@link regionKeys} sets, so `Co. Donegal`
+ * meets stored `County Donegal` at the shared stripped key `donegal`.
+ * A table probe matches the stored fold verbatim in one direction.
+ *
+ * WOF stores Irish counties under `county donegal`.
+ * The table has no bare `donegal` key.
+ *
+ * The qualifier probe missed every Irish county until this variant landed.
+ *
+ * The `county <key>` form restores two-sidedness for the one stored-form family with an evidenced case.
+ * The union is monotone because a wider qualifier set can only find more bearers.
+ *
+ * Each bearer must still contain a candidate before anything moves.
+ *
+ * The suffix sibling (`<key> province`) is deliberately absent.
+ * The board has no case for this stored form.
+ * Add one before building a change for this suffix.
  */
-export declare function regionQualifierProbeKeys(value: string, countryAlpha2?: string): Set<string>;
+export declare function regionQualifierProbeKeys(value: string, countryAlpha2?: string | null): Set<string>;
 //# sourceMappingURL=region-keys.d.ts.map

package/out/region-keys.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"region-keys.d.ts","sourceRoot":"","sources":["../lib/region-keys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,EAAE,WAAW,CAAC,MAAM,CAA+D,CAAA;AAwDvH;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAyB7E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAY3F"}
+{"version":3,"file":"region-keys.d.ts","sourceRoot":"","sources":["../lib/region-keys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,uBAAuB,EAAE,WAAW,CAAC,MAAM,CAA+D,CAAA;AAgEvH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,CA0BpF;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,CAYlG"}

package/out/region-keys.js

@@ -3,39 +3,50 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- *   The comparable-key expansion for a parsed REGION qualifier — one function, both consumers (the
- *   #861 rule). The admin-coherence verdicts (`mailwoman/admin-coherence.ts`) fold a qualifier and a
- *   winner-ancestry name through this to decide `confirmed`/`contradicted`; the candidate backend's
- *   admin-containment re-rank (#1717 stage 2, `candidate-lookup.ts`) folds the same qualifier through
- *   it to find the qualifier's own region-class rows in the candidate table. A check that says
- *   `contradicted` and a re-rank that cannot find the qualifier would otherwise be two readings of
- *   one string that silently disagree — the exact drift the shared-function rule exists to prevent.
- *
- *   Lives HERE rather than in `mailwoman` because the dependency points this way: `mailwoman`
+ *   Both consumers use this expansion to compare parsed region qualifiers with stored keys.
+ *   Admin-coherence verdicts (`mailwoman/admin-coherence.ts`) fold a qualifier and the winner's ancestry
+ *   to decide `confirmed` or `contradicted`. The candidate backend's admin-containment re-rank
+ *   (`candidate-lookup.ts`) uses the same fold to find region-class rows. The shared function keeps
+ *   both decisions aligned.
+ *
+ *   Lives here rather than in `mailwoman` because the dependency points this way. `mailwoman`
  *   depends on `@mailwoman/resolver-wof-sqlite` (which owns the fold and already depends on codex),
  *   never the reverse.
  */
 import { matchSubdivision, matchSubdivisionIn } from "@mailwoman/codex/country";
 import { normalizeLocalityForKey } from "#street/normalize";
 /**
- * The ancestry placetypes that answer for a parsed `region` qualifier — WOF's admin band between country and locality.
- * Deliberately the whole band: a qualifier stated at any grain ("Lancashire", a ceremonial county; "Thüringen", a Land)
- * may confirm against whichever level the backend stored, and `contradicted` requires the entire band to miss, so
- * widening the band only ever makes the check more conservative.
+ * The ancestry placetypes that answer for a parsed `region` qualifier,
+ * WOF's admin band between country and locality.
+ *
+ * The full band covers qualifiers at any grain, such as "Lancashire"
+ * (a ceremonial county) or "Thüringen" (a Land).
+ * A qualifier may confirm against any level the backend stored.
+ *
+ * `contradicted` requires every level in the band to miss.
+ * A wider band makes the check more conservative.
  */
 export const REGION_CLASS_PLACETYPES = new Set(["region", "macroregion", "county", "macrocounty"]);
 /**
- * County-style qualifier prefixes stripped to produce a comparison VARIANT. Ireland writes `Co. Westmeath` where WOF
- * stores `Westmeath`, so the prefix defeats the fold and every Irish county qualifier read `contradicted` on the first
- * board census (2026-08-17, five rows). The stripped form is ADDED to the key set, never substituted — `County Durham`
- * is a real name whose stripped variant simply also matches, and a set union can only widen confirmation, so the
- * closure is monotone: `contradicted → confirmed` is the only movement it can cause.
+ * County-style qualifier prefixes stripped to produce a comparison variant.
+ *
+ * Ireland writes `Co. Westmeath` where WOF stores `Westmeath`, so the prefix defeats the fold
+ * and every Irish county qualifier would read `contradicted`.
+ * The stripped form is added to the key set, never substituted.
+ *
+ * `County Durham` is a real name that also matches after prefix removal.
+ * Set union can only widen confirmation, so the closure is monotone.
+ *
+ * `contradicted → confirmed` is the only movement it can cause.
  */
 const COUNTY_QUALIFIER_PREFIXES = ["county", "co.", "co"];
 /**
- * Trailing admin-qualifier words, the suffix sibling of the prefix above: `San José Province` (CR board row) folds
- * against stored `San José` only with the word removed. Same monotone rule — the stripped form joins the set, never
- * replaces the original.
+ * Admin-qualifier words at the end, the suffix form of the prefix above.
+ *
+ * `San José Province` (CR board row) folds against stored `San José` only with the word removed.
+ *
+ * Same monotone rule.
+ * The stripped form joins the set, never replaces the original.
  */
 const ADMIN_QUALIFIER_SUFFIXES = ["province", "prov.", "prov"];
 function withoutPrefix(value, prefixes) {
@@ -66,12 +77,18 @@ function withoutSuffix(value, suffixes) {
     return value;
 }
 /**
- * The comparable keys a region string expands to: its own fold (the shared candidate.db `name_key` normalizer,
- * {@link normalizeLocalityForKey} — build side and check side agree by construction); a county-prefix-stripped variant;
- * the codex subdivision expansions — the disjoint US+CA table always, plus the COUNTRY-SCOPED table when the caller
- * knows a country (`WA` under AU is Western Australia; under US, Washington — the collision that keeps AU out of the
- * unscoped table). Every expansion lands the canonical name and code folds in the set, so `IL`/`Illinois` and
- * `WA`/`Western Australia` meet from either side.
+ * The comparable keys a region string expands to: its own fold (the shared candidate.db `name_key`
+ * normalizer, {@link normalizeLocalityForKey}, so build side and check side agree by construction).
+ *
+ * A county-prefix-stripped variant.
+ * The codex subdivision expansions.
+ *
+ * The disjoint US and CA table always, plus the country-scoped table when the caller knows a country.
+ * `WA` under AU is Western Australia, while under US it is Washington,
+ * the collision that keeps AU out of the unscoped table.
+ *
+ * Every expansion lands the canonical name and code folds in the set, so `IL`
+ * and `Illinois`, or `WA` and `Western Australia`, meet from either side.
  */
 export function regionKeys(value, countryAlpha2) {
     const keys = new Set([normalizeLocalityForKey(value)]);
@@ -90,22 +107,33 @@ export function regionKeys(value, countryAlpha2) {
             keys.add(normalizeLocalityForKey(subdivision.code));
         }
     }
-    // The empty fold stays IN the set on purpose — the admin-coherence verdicts have always compared
-    // the empty key (two empty-folding strings intersect → `confirmed`), and this move must not shift
-    // a verdict. A consumer probing a table by key filters the empty string out itself.
+    // The empty fold stays in the set on purpose.
+    // The admin-coherence verdicts have always compared the empty key
+    // (two empty-folding strings intersect → `confirmed`), and this move must not shift a verdict.
+    // A consumer probing a table by key filters the empty string out itself.
     return keys;
 }
 /**
- * The PROBE-side expansion for a region qualifier — {@link regionKeys} plus the county-PREFIXED variant of every key.
- *
- * The verdict implementation intersects two {@link regionKeys} SETS, so `Co. Donegal` meets stored `County Donegal` at
- * the shared stripped key `donegal`. A table probe is one-sided: it matches the STORED fold verbatim, and WOF stores
- * Irish counties under `county donegal` with no bare `donegal` key (measured on the shipped candidate.db — the
- * qualifier probe missed every Irish county until this variant landed). Adding `county <key>` restores the
- * two-sidedness for the one stored-form family with an evidenced case; the union is monotone (a wider qualifier set can
- * only find more BEARERS, each of which must still genuinely contain a candidate before anything moves). The suffix
- * sibling (`<key> province`) is deliberately absent — no stored-form case has been evidenced, and a change without a
- * board does not get built.
+ * The probe-side expansion for a region qualifier, {@link regionKeys} plus the
+ * county-prefixed variant of every key.
+ *
+ * The verdict implementation intersects two {@link regionKeys} sets, so `Co. Donegal`
+ * meets stored `County Donegal` at the shared stripped key `donegal`.
+ * A table probe matches the stored fold verbatim in one direction.
+ *
+ * WOF stores Irish counties under `county donegal`.
+ * The table has no bare `donegal` key.
+ *
+ * The qualifier probe missed every Irish county until this variant landed.
+ *
+ * The `county <key>` form restores two-sidedness for the one stored-form family with an evidenced case.
+ * The union is monotone because a wider qualifier set can only find more bearers.
+ *
+ * Each bearer must still contain a candidate before anything moves.
+ *
+ * The suffix sibling (`<key> province`) is deliberately absent.
+ * The board has no case for this stored form.
+ * Add one before building a change for this suffix.
  */
 export function regionQualifierProbeKeys(value, countryAlpha2) {
     const keys = regionKeys(value, countryAlpha2);

package/out/region-keys.js.map

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