@mailwoman/resolver-wof-sqlite 9.4.0 → 10.1.0

package/out/candidate-importance.d.ts

@@ -1,132 +0,0 @@
-/**
- * @copyright Sister Software
- * @license AGPL-3.0
- * @author Teffen Ellis, et al.
- *
- *   The score side of the candidate build (#28) — load a WOF admin database's `place_importance` into
- *   a lookup the candidate builder can probe per place, so every candidate row can carry the
- *   toponym-fame prior a bare city name is decided on.
- *
- *   ## Why this joins on the NAME and not on the id
- *
- *   The obvious join is `candidate.spr_id = place_importance.id`, and it is wrong here. The score
- *   source (`admin-global-priority-importance.db`) and the candidate build's admin source are
- *   DIFFERENT SNAPSHOTS, and they disagree about ids for exactly the rows that matter: Whitby,
- *   Ontario is `8143502164401` in the shipped `candidate.db` and `8000001156384` in the score source
- *   — the Overture-sourced rows were re-keyed between the two. An id join silently drops every one of
- *   them, which means it drops precisely the FOREIGN HOMONYMS the fame prior exists to demote, and it
- *   drops them invisibly: the build succeeds, the column is populated, and the ranking is inert on
- *   the queries it was built for.
- *
- *   So the join key is `(name_key, country, placetype)` — the same {@link normalizeLocalityForKey} the
- *   candidate build uses for its probe key, so the two sides fold identically by construction.
- *
- *   ## Why the key alone is not enough
- *
- *   `(warwick, US, locality)` names ELEVEN different places. Taking the group's max would give every
- *   Warwick in America the fame of Warwick, Rhode Island, which is the fan-out defect
- *   `importance-fanout.ts` documents one layer up, re-introduced at the join. So the group is
- *   disambiguated GEOGRAPHICALLY: the nearest centroid wins, and only within
- *   {@link IMPORTANCE_JOIN_RADIUS_KM}. Two artifacts describing the same settlement put its centroid in
- *   almost the same place; two same-named towns in one country do not.
- *
- *   ## What lands in the column
- *
- *   `place_importance.importance` VERBATIM — the pre-split conflation (encyclopedia-derived where
- *   the concordance matched, a population-derived proxy everywhere else). See
- *   {@link CandidateTable.importance} for why the split `encyclopedic` channel is deliberately NOT
- *   what is written here, with the measurement that settled it.
- *
- *   A place with no match gets NULL. NULL is UNMEASURED, never zero — the consumer
- *   (`resolver/toponym-prior.ts`) leaves an unmeasured candidate exactly where population put it.
- */
-/**
- * How far apart two artifacts may put the same place's centroid and still be read as the same place.
- *
- * MEASURED, not guessed (2026-08-10, `admin-global-priority.db` × `admin-global-priority-importance.db`; 4,476,245
- * current locality-tier places against 676,790 scored ones, 1,020,099 of which matched a scored group by `(name_key,
- * country, placetype)`). The nearest-centroid distance is **exactly 0.00 km for 577,080 of them (56.6%)** — the two
- * snapshots agree to the bit — and 656,755 (64.4%) are inside 500 m.
- *
- * What sets the radius is where that mode ENDS, and the per-kilometre density states. It falls from 1,076 places/km
- * over 3–5 km to a trough of **441 places/km over 7–10 km**, then climbs back and flattens onto a plateau of 760–780
- * places/km from 30 km out to 100 km and beyond. That plateau is the background rate of two DIFFERENT towns wearing one
- * name in one country, and it does not decay with distance because there is no reason it should. 10 km is the floor
- * between the two populations. Admitting it scores 679,163 places (66.6% of the matched set); pushing the radius to 25
- * km buys 8,722 more, and by then better than half of each additional kilometre is the wrong town.
- *
- * The four-row bare-GB board is insensitive across this whole range — 5 km and 25 km were both measured and select
- * identical rows — so the value is chosen by what the join MEANS, not by what it scores. The radius is the definition
- * of "this is the same place"; widening it past the floor starts handing one town's fame to another.
- */
-export declare const IMPORTANCE_JOIN_RADIUS_KM = 10;
-/**
- * One scored place from the source: where it is, and what it scored.
- */
-interface ScoredPlace {
-    lat: number;
-    lon: number;
-    importance: number;
-}
-/**
- * What {@link loadImportanceIndex} measured while reading the source. Reported by the builder so a run says how much of
- * the gazetteer it actually scored, rather than leaving the caller to infer it from a column full of nulls.
- */
-export interface ImportanceIndexStats {
-    /**
-     * Scored places read out of the source.
-     */
-    places: number;
-    /**
-     * Distinct `(name_key, country, placetype)` groups they fall into.
-     */
-    keys: number;
-    /**
-     * Places whose name folded to the empty key and could never be joined (non-Latin punctuation-only names, blanks).
-     */
-    unkeyable: number;
-}
-/**
- * A loaded `place_importance`, probed by name + country + placetype + position.
- */
-export declare class ImportanceIndex {
-    #private;
-    readonly stats: ImportanceIndexStats;
-    /**
-     * Places {@link find} matched inside the radius.
-     */
-    matched: number;
-    /**
-     * Places {@link find} REFUSED — the key matched a scored group, but the nearest member of it was outside the radius,
-     * so it is a different place wearing the same name.
-     *
-     * This is the number worth watching across rebuilds. A jump means the score source and the admin source have drifted
-     * apart and the join is being asked to guess; it does not mean the radius is too tight.
-     */
-    refused: number;
-    constructor(groups: Map<string, ScoredPlace[]>, stats: ImportanceIndexStats);
-    /**
-     * The importance of the scored place nearest `(lat, lon)` sharing `name`'s folded key, `country` and `placetype`, or
-     * null when there is no such place within {@link IMPORTANCE_JOIN_RADIUS_KM}.
-     *
-     * Null is UNMEASURED. Never substitute a zero, and never fall back to a population-derived value here — the source
-     * column already carries that fallback where it has one, and inventing a second one would make an absence
-     * indistinguishable from a measurement.
-     */
-    find(name: string, country: string | null, placetype: string | null, lat: number, lon: number): number | null;
-}
-/**
- * Read `place_importance` (joined to `spr` for the name/country/placetype/centroid) out of a WOF admin database into an
- * {@link ImportanceIndex}.
- *
- * Only CURRENT, non-deprecated places are indexed — a superseded row's score belongs to a place the gazetteer no longer
- * carries, and letting it win the nearest-centroid contest would hand a live place a dead one's fame.
- *
- * The whole table is held in memory on purpose. The 2026-08-10 source holds 676,790 scored places in 544,823 groups,
- * and the build probes it once for every one of its ~4.8 M places; the alternative is a prepared statement per place
- * against a 3.7 GB database. Measured end to end, loading the index plus probing all 4.48 M locality-tier places takes
- * 25 s.
- */
-export declare function loadImportanceIndex(databasePath: string): ImportanceIndex;
-export {};
-//# sourceMappingURL=candidate-importance.d.ts.map

package/out/candidate-importance.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"candidate-importance.d.ts","sourceRoot":"","sources":["../lib/candidate-importance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAQH;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,yBAAyB,KAAK,CAAA;AAE3C;;GAEG;AACH,UAAU,WAAW;IACpB,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,UAAU,EAAE,MAAM,CAAA;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACpC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;IACd;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ;;OAEG;IACH,SAAS,EAAE,MAAM,CAAA;CACjB;AAUD;;GAEG;AACH,qBAAa,eAAe;;IAE3B,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAA;IACpC;;OAEG;IACH,OAAO,SAAI;IACX;;;;;;OAMG;IACH,OAAO,SAAI;gBAEC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,EAAE,KAAK,EAAE,oBAAoB;IAK3E;;;;;;;OAOG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CA+B7G;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,eAAe,CAwCzE"}

package/out/candidate-importance.js

@@ -1,169 +0,0 @@
-/**
- * @copyright Sister Software
- * @license AGPL-3.0
- * @author Teffen Ellis, et al.
- *
- *   The score side of the candidate build (#28) — load a WOF admin database's `place_importance` into
- *   a lookup the candidate builder can probe per place, so every candidate row can carry the
- *   toponym-fame prior a bare city name is decided on.
- *
- *   ## Why this joins on the NAME and not on the id
- *
- *   The obvious join is `candidate.spr_id = place_importance.id`, and it is wrong here. The score
- *   source (`admin-global-priority-importance.db`) and the candidate build's admin source are
- *   DIFFERENT SNAPSHOTS, and they disagree about ids for exactly the rows that matter: Whitby,
- *   Ontario is `8143502164401` in the shipped `candidate.db` and `8000001156384` in the score source
- *   — the Overture-sourced rows were re-keyed between the two. An id join silently drops every one of
- *   them, which means it drops precisely the FOREIGN HOMONYMS the fame prior exists to demote, and it
- *   drops them invisibly: the build succeeds, the column is populated, and the ranking is inert on
- *   the queries it was built for.
- *
- *   So the join key is `(name_key, country, placetype)` — the same {@link normalizeLocalityForKey} the
- *   candidate build uses for its probe key, so the two sides fold identically by construction.
- *
- *   ## Why the key alone is not enough
- *
- *   `(warwick, US, locality)` names ELEVEN different places. Taking the group's max would give every
- *   Warwick in America the fame of Warwick, Rhode Island, which is the fan-out defect
- *   `importance-fanout.ts` documents one layer up, re-introduced at the join. So the group is
- *   disambiguated GEOGRAPHICALLY: the nearest centroid wins, and only within
- *   {@link IMPORTANCE_JOIN_RADIUS_KM}. Two artifacts describing the same settlement put its centroid in
- *   almost the same place; two same-named towns in one country do not.
- *
- *   ## What lands in the column
- *
- *   `place_importance.importance` VERBATIM — the pre-split conflation (encyclopedia-derived where
- *   the concordance matched, a population-derived proxy everywhere else). See
- *   {@link CandidateTable.importance} for why the split `encyclopedic` channel is deliberately NOT
- *   what is written here, with the measurement that settled it.
- *
- *   A place with no match gets NULL. NULL is UNMEASURED, never zero — the consumer
- *   (`resolver/toponym-prior.ts`) leaves an unmeasured candidate exactly where population put it.
- */
-import { haversineKm } from "@mailwoman/spatial";
-import { DatabaseClient } from "@mailwoman/sqlite/client";
-import { normalizeLocalityForKey } from "#street/normalize";
-/**
- * How far apart two artifacts may put the same place's centroid and still be read as the same place.
- *
- * MEASURED, not guessed (2026-08-10, `admin-global-priority.db` × `admin-global-priority-importance.db`; 4,476,245
- * current locality-tier places against 676,790 scored ones, 1,020,099 of which matched a scored group by `(name_key,
- * country, placetype)`). The nearest-centroid distance is **exactly 0.00 km for 577,080 of them (56.6%)** — the two
- * snapshots agree to the bit — and 656,755 (64.4%) are inside 500 m.
- *
- * What sets the radius is where that mode ENDS, and the per-kilometre density states. It falls from 1,076 places/km
- * over 3–5 km to a trough of **441 places/km over 7–10 km**, then climbs back and flattens onto a plateau of 760–780
- * places/km from 30 km out to 100 km and beyond. That plateau is the background rate of two DIFFERENT towns wearing one
- * name in one country, and it does not decay with distance because there is no reason it should. 10 km is the floor
- * between the two populations. Admitting it scores 679,163 places (66.6% of the matched set); pushing the radius to 25
- * km buys 8,722 more, and by then better than half of each additional kilometre is the wrong town.
- *
- * The four-row bare-GB board is insensitive across this whole range — 5 km and 25 km were both measured and select
- * identical rows — so the value is chosen by what the join MEANS, not by what it scores. The radius is the definition
- * of "this is the same place"; widening it past the floor starts handing one town's fame to another.
- */
-export const IMPORTANCE_JOIN_RADIUS_KM = 10;
-/**
- * `(name_key, country, placetype)` → the scored places under it. The separator is U+0000, which no WOF name carries and
- * no fold can produce, so the three fields can't smear into one another.
- */
-function groupKey(nameKey, country, placetype) {
-    return `${nameKey}\u0000${(country ?? "").toUpperCase()}\u0000${placetype ?? ""}`;
-}
-/**
- * A loaded `place_importance`, probed by name + country + placetype + position.
- */
-export class ImportanceIndex {
-    #groups;
-    stats;
-    /**
-     * Places {@link find} matched inside the radius.
-     */
-    matched = 0;
-    /**
-     * Places {@link find} REFUSED — the key matched a scored group, but the nearest member of it was outside the radius,
-     * so it is a different place wearing the same name.
-     *
-     * This is the number worth watching across rebuilds. A jump means the score source and the admin source have drifted
-     * apart and the join is being asked to guess; it does not mean the radius is too tight.
-     */
-    refused = 0;
-    constructor(groups, stats) {
-        this.#groups = groups;
-        this.stats = stats;
-    }
-    /**
-     * The importance of the scored place nearest `(lat, lon)` sharing `name`'s folded key, `country` and `placetype`, or
-     * null when there is no such place within {@link IMPORTANCE_JOIN_RADIUS_KM}.
-     *
-     * Null is UNMEASURED. Never substitute a zero, and never fall back to a population-derived value here — the source
-     * column already carries that fallback where it has one, and inventing a second one would make an absence
-     * indistinguishable from a measurement.
-     */
-    find(name, country, placetype, lat, lon) {
-        const nameKey = normalizeLocalityForKey(name);
-        if (!nameKey)
-            return null;
-        const group = this.#groups.get(groupKey(nameKey, country, placetype));
-        if (!group)
-            return null;
-        let best;
-        let bestKm = Infinity;
-        for (const place of group) {
-            const km = haversineKm(lat, lon, place.lat, place.lon);
-            if (km < bestKm) {
-                bestKm = km;
-                best = place;
-            }
-        }
-        if (!best || bestKm > IMPORTANCE_JOIN_RADIUS_KM) {
-            this.refused++;
-            return null;
-        }
-        this.matched++;
-        return best.importance;
-    }
-}
-/**
- * Read `place_importance` (joined to `spr` for the name/country/placetype/centroid) out of a WOF admin database into an
- * {@link ImportanceIndex}.
- *
- * Only CURRENT, non-deprecated places are indexed — a superseded row's score belongs to a place the gazetteer no longer
- * carries, and letting it win the nearest-centroid contest would hand a live place a dead one's fame.
- *
- * The whole table is held in memory on purpose. The 2026-08-10 source holds 676,790 scored places in 544,823 groups,
- * and the build probes it once for every one of its ~4.8 M places; the alternative is a prepared statement per place
- * against a 3.7 GB database. Measured end to end, loading the index plus probing all 4.48 M locality-tier places takes
- * 25 s.
- */
-export function loadImportanceIndex(databasePath) {
-    using db = new DatabaseClient(databasePath, { readOnly: true });
-    const groups = new Map();
-    let places = 0;
-    let unkeyable = 0;
-    for (const row of db
-        .prepare(`SELECT s.name AS name, s.country AS country, s.placetype AS placetype,
-				s.latitude AS latitude, s.longitude AS longitude, i.importance AS importance
-			 FROM place_importance i JOIN spr s ON s.id = i.id
-			 WHERE s.is_current != 0 AND s.is_deprecated = 0`)
-        .iterate()) {
-        const importance = Number(row.importance);
-        if (!Number.isFinite(importance))
-            continue;
-        const nameKey = normalizeLocalityForKey(String(row.name ?? ""));
-        if (!nameKey) {
-            unkeyable++;
-            continue;
-        }
-        const key = groupKey(nameKey, row.country, row.placetype);
-        let group = groups.get(key);
-        if (!group) {
-            group = [];
-            groups.set(key, group);
-        }
-        group.push({ lat: Number(row.latitude), lon: Number(row.longitude), importance });
-        places++;
-    }
-    return new ImportanceIndex(groups, { places, keys: groups.size, unkeyable });
-}
-//# sourceMappingURL=candidate-importance.js.map

package/out/candidate-importance.js.map

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

package/out/candidate-lookup.d.ts

@@ -1,76 +0,0 @@
-/**
- * @copyright Sister Software
- * @license AGPL-3.0
- * @author Teffen Ellis, et al.
- *
- *   Node-side {@link PlaceLookup} over the byte-range CANDIDATE table (`build-candidate.ts`) — the
- *   SAME gazetteer the browser runtime resolves against ({@link WOFCandidateTableLookup} in
- *   `packages/resolver-wof-wasm/lib/httpvfs/resolver.ts`), but reading a LOCAL `candidate.db` via
- *   `node:sqlite` instead of sql.js-httpvfs. This is what makes the server/CLI resolver match the
- *   browser: one lookup surface, one artifact, one ranking.
- *
- *   The query is a single contiguous probe on the `WITHOUT ROWID` B-tree keyed `(name_key,
- *   country_id, region_id, placetype_id, neg_rank, spr_id)`. `name_key` is the SHARED
- *   {@link normalizeLocalityForKey} (build- and query-consistent), each row is denormalized (display
- *   `name`, centroid, bbox), and population rank is precomputed into `neg_rank` — so the result is
- *   POPULATION-FIRST and COUNTRY-AGNOSTIC (when no `country` filter is given), exactly like the
- *   demo. That's the deliberate divergence from {@link WOFSQLitePlaceLookup}'s FTS/bm25 ranking: a
- *   bare "Moscow" resolves to the 10.4 M-pop Russian city, not whichever same-name US township bm25
- *   floats to the top.
- *
- *   Disambiguation rides the same mechanism the cascade already uses: a parsed region resolves to its
- *   stored bbox and the locality query is point-in-bbox-filtered on the candidate centroid (the
- *   `bbox` field on {@link FindPlaceQuery}).
- */
-import { type Ancestor, type GazetteerArtifactCoverage } from "@mailwoman/core/resolver";
-import { DatabaseClient } from "@mailwoman/sqlite/client";
-import type { PathBuilderLike } from "path-ts";
-import type { CandidateDatabase } from "#candidate-schema";
-import type { FindPlaceQuery, PlaceCandidate, PlaceLookup } from "#types";
-export { rankByPrimaryPreference } from "#primary-preference";
-export type { RankedRow } from "#primary-preference";
-export interface WOFCandidateTableLookupOpts {
-    /**
-     * Path to a `candidate.db` built by `build-candidate.ts`. Opened read-only.
-     */
-    databasePath?: PathBuilderLike;
-    /**
-     * Pre-opened handle (tests / shared connections). Mutually exclusive with `databasePath`.
-     */
-    database?: DatabaseClient<CandidateDatabase>;
-    /**
-     * #1882 opt-in: exempt `name_role = 'variant'` aliases — the holder's own primary name in another orthography,
-     * stamped by the build's own-name detector — from the cross-country primary-preference penalty. No-ops on an artifact
-     * without the role column. Default OFF (D-rule).
-     */
-    variantAliasExemption?: boolean;
-}
-/**
- * Node {@link PlaceLookup} over `candidate.db`. Drop-in for {@link WOFSQLitePlaceLookup} in `createWOFResolver(backend)`
- * — same `findPlace` contract, population-first ranking.
- */
-export declare class WOFCandidateTableLookup implements PlaceLookup, Disposable {
-    #private;
-    /**
-     * Facts this candidate DB declares about itself — the coverage manifest (`country_coverage` + `country_bbox`) the
-     * gazetteer build emits, read once at open. `undefined` when the artifact predates the manifest, so every consumer
-     * (the hard-country coverage check, guard-B plausibility) falls back to its code constants byte-identically.
-     */
-    readonly artifactCoverage: GazetteerArtifactCoverage | undefined;
-    /**
-     * The ancestor lineage of a resolved place — nearest-first (locality-tier → county → region → … → country), the same
-     * order the FTS backend's `ancestorLineage` serves, read from the `candidate_ancestor` sidecar in one clustered
-     * probe. Backs `ResolveOpts.includeAncestors` (#404) on this backend, which is what puts region-class ancestry in
-     * front of the admin-coherence check (#1717).
-     *
-     * A PROPERTY, not a method, and assigned only when the artifact carries the sidecar: capability probes (`typeof
-     * backend.ancestors === "function"` — the resolver's gap report) then read the ARTIFACT truthfully. A candidate.db
-     * built before the sidecar reports the capability absent instead of presenting a method that answers `[]` for every
-     * place, which would be an absence dressed as a negative answer.
-     */
-    readonly ancestors: ((id: number | string) => Ancestor[]) | undefined;
-    constructor(opts: WOFCandidateTableLookupOpts);
-    findPlace(query: FindPlaceQuery): Promise<PlaceCandidate[]>;
-    [Symbol.dispose](): void;
-}
-//# sourceMappingURL=candidate-lookup.d.ts.map

package/out/candidate-lookup.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"candidate-lookup.d.ts","sourceRoot":"","sources":["../lib/candidate-lookup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAEN,KAAK,QAAQ,EACb,KAAK,yBAAyB,EAE9B,MAAM,0BAA0B,CAAA;AAKjC,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAU9C,OAAO,KAAK,EAAE,iBAAiB,EAAwD,MAAM,mBAAmB,CAAA;AAQhH,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,WAAW,EAAgB,MAAM,QAAQ,CAAA;AAEvF,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAA;AAC7D,YAAY,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAEpD,MAAM,WAAW,2BAA2B;IAC3C;;OAEG;IACH,YAAY,CAAC,EAAE,eAAe,CAAA;IAC9B;;OAEG;IACH,QAAQ,CAAC,EAAE,cAAc,CAAC,iBAAiB,CAAC,CAAA;IAC5C;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAA;CAC/B;AAiFD;;;GAGG;AACH,qBAAa,uBAAwB,YAAW,WAAW,EAAE,UAAU;;IA6BtE;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,EAAE,yBAAyB,GAAG,SAAS,CAAA;IAsChE;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,KAAK,QAAQ,EAAE,CAAC,GAAG,SAAS,CAAA;gBAEzD,IAAI,EAAE,2BAA2B;IAsVvC,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAmYjE,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;CAGxB"}