@mailwoman/resolver-wof-sqlite 4.16.2 → 5.0.0

package/out/index.js

@@ -3,20 +3,20 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  */
-export { WofSqlitePlaceLookup } from "./lookup.js";
-export { CANDIDATE_FTS_TABLE, createCandidateFts } from "./candidate-fts.js";
-export { WofCandidateTableLookup } from "./candidate-lookup.js";
+export { WOFSqlitePlaceLookup } from "./lookup.js";
+export { CANDIDATE_FTS_TABLE, createCandidateFTS } from "./candidate-fts.js";
+export { WOFCandidateTableLookup } from "./candidate-lookup.js";
 export { GEONAMES_ID_BASE, ingestGeonamesAliases } from "./geonames-aliases.js";
 export { ADDRESS_POINT_COLUMNS, createAddressPointIndexes, createAddressPointTable } from "./address-point-schema.js";
-export { WofPostalCityAliasLookup, } from "./postal-city-alias-lookup.js";
+export { WOFPostalCityAliasLookup, } from "./postal-city-alias-lookup.js";
 export { POSTAL_CITY_CANDIDATE_COLUMNS, POSTAL_CITY_CANDIDATE_TABLE, createPostalCityCandidateTable, } from "./postal-city-candidate-schema.js";
 export { ADDRESS_CONVENTION_TABLE, BUILTIN_STRATEGY_NAMES, SeedConventionSource, WORLD_DEFAULT, mergeConventions, resolveConvention, } from "./convention.js";
 export { SqliteConventionSource } from "./sqlite-convention-source.js";
-export { WofPostcodeLookup } from "./postcode-point-lookup.js";
-export { PLACE_BBOX_TABLE, PLACE_SEARCH_TABLE, buildPlaceSearchFts, placeBboxExists, placeSearchFtsExists, } from "./fts.js";
+export { WOFPostcodeLookup } from "./postcode-point-lookup.js";
+export { PLACE_BBOX_TABLE, PLACE_SEARCH_TABLE, buildPlaceSearchFTS, placeBboxExists, placeSearchFTSExists, } from "./fts.js";
 export { bboxAround, geometryContains, haversineKm, pointInPolygonRings, pointInRing, } from "./geo.js";
 export { PLACETYPE_DEPTH, ancestorLineage, placetypeDepth } from "./ancestry.js";
-export { WofReverseGeocoder, } from "./reverse.js";
+export { WOFReverseGeocoder, } from "./reverse.js";
 export { AddressPointInterpolator } from "./address-point-interpolation.js";
 export { AddressPointSqliteLookup } from "./address-point.js";
 export { StreetInterpolator, } from "./interpolation.js";

package/out/interpolation.d.ts

@@ -32,8 +32,8 @@ import type { InterpolationLookup } from "@mailwoman/resolver";
  *
  * - `address_point` — bracketed/extrapolated between REAL neighbor points from the #476 shard
  *   (`AddressPointInterpolator`), replacing TIGER's uniform-spacing assumption with occupancy.
- * - `tiger_range` — linear position within a TIGER segment's theoretical house-number range
- *   (`StreetInterpolator`), the fallback for streets too sparse to bracket.
+ * - `tiger_range` — linear position within a TIGER segment's theoretical house-number range (`StreetInterpolator`), the
+ *   fallback for streets too sparse to bracket.
  */
 export type InterpolationMethod = "address_point" | "tiger_range";
 /** One interpolated coordinate estimate. Never an exact situs point — see `uncertaintyM`. */
@@ -45,20 +45,18 @@ export interface InterpolatedHit {
     /** Which rung answered — see {@link InterpolationMethod}. */
     method: InterpolationMethod;
     /**
-     * `tiger_range` only. True when the matched segment side's parity agrees with the house number
-     * (or the side is `mixed`). False = opposite-side fallback: usually the right block, wrong side
-     * of the street.
+     * `tiger_range` only. True when the matched segment side's parity agrees with the house number (or the side is
+     * `mixed`). False = opposite-side fallback: usually the right block, wrong side of the street.
      */
     parityMatched?: boolean;
     /**
-     * `address_point` only. `both` = the query number sits between two known neighbor numbers;
-     * `single` = neighbors exist on one side only (extrapolated, larger `uncertaintyM`).
+     * `address_point` only. `both` = the query number sits between two known neighbor numbers; `single` = neighbors exist
+     * on one side only (extrapolated, larger `uncertaintyM`).
      */
     bracket?: "both" | "single";
     /**
-     * Honest uncertainty radius in meters: half the matched segment's polyline length
-     * (`tiger_range`), half the bracket span (`address_point`/`both`), or the explicitly larger
-     * extrapolation penalty (`address_point`/`single`).
+     * Honest uncertainty radius in meters: half the matched segment's polyline length (`tiger_range`), half the bracket
+     * span (`address_point`/`both`), or the explicitly larger extrapolation penalty (`address_point`/`single`).
      */
     uncertaintyM: number;
     /** Provenance, e.g. `"tiger:edges"`. */

package/out/interpolation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interpolation.d.ts","sourceRoot":"","sources":["../interpolation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAM9D;;;;;;;GAOG;AACH,MAAM,MAAM,mBAAmB,GAAG,eAAe,GAAG,aAAa,CAAA;AAEjE,6FAA6F;AAC7F,MAAM,WAAW,eAAe;IAC/B,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,yFAAyF;IACzF,YAAY,EAAE,IAAI,CAAA;IAClB,6DAA6D;IAC7D,MAAM,EAAE,mBAAmB,CAAA;IAC3B;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAA;IAC3B;;;;OAIG;IACH,YAAY,EAAE,MAAM,CAAA;IACpB,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAA;IACd,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,kBAAkB;IAClC,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,+FAA+F;IAC/F,QAAQ,CAAC,EAAE,MAAM,CAAA;CACjB;AAcD,qBAAa,kBAAmB,YAAW,mBAAmB;;gBAMjD,IAAI,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,YAAY,CAAA;KAAE;IAyB9D,IAAI,CAAC,KAAK,EAAE,kBAAkB,GAAG,eAAe,GAAG,IAAI;IAmDvD,KAAK,IAAI,IAAI;CAGb"}
+{"version":3,"file":"interpolation.d.ts","sourceRoot":"","sources":["../interpolation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAM9D;;;;;;;GAOG;AACH,MAAM,MAAM,mBAAmB,GAAG,eAAe,GAAG,aAAa,CAAA;AAEjE,6FAA6F;AAC7F,MAAM,WAAW,eAAe;IAC/B,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,yFAAyF;IACzF,YAAY,EAAE,IAAI,CAAA;IAClB,6DAA6D;IAC7D,MAAM,EAAE,mBAAmB,CAAA;IAC3B;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAA;IAC3B;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAA;IACpB,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAA;IACd,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,kBAAkB;IAClC,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,+FAA+F;IAC/F,QAAQ,CAAC,EAAE,MAAM,CAAA;CACjB;AAcD,qBAAa,kBAAmB,YAAW,mBAAmB;;gBAMjD,IAAI,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,YAAY,CAAA;KAAE;IA0B9D,IAAI,CAAC,KAAK,EAAE,kBAAkB,GAAG,eAAe,GAAG,IAAI;IAwDvD,KAAK,IAAI,IAAI;CAGb"}

package/out/interpolation.js

@@ -31,17 +31,17 @@ import { hasTable } from "./sqlite-utils.js";
 import { canonicalizeRouteKey, normalizeStreetForKey } from "./street-normalize.js";
 export class StreetInterpolator {
     #db;
-    #ownsDb;
+    #ownsDB;
     #byPostcode;
     #byStreet;
     constructor(opts) {
         if (opts.database) {
             this.#db = opts.database;
-            this.#ownsDb = false;
+            this.#ownsDB = false;
         }
         else if (opts.dbPath) {
             this.#db = new DatabaseSync(opts.dbPath, { readOnly: true });
-            this.#ownsDb = true;
+            this.#ownsDB = true;
         }
         else {
             throw new Error("StreetInterpolator: one of dbPath or database is required");
@@ -108,7 +108,7 @@ export class StreetInterpolator {
         };
     }
     close() {
-        if (this.#ownsDb)
+        if (this.#ownsDB)
             this.#db.close();
     }
 }
@@ -116,8 +116,8 @@ function clamp01(t) {
     return t < 0 ? 0 : t > 1 ? 1 : t;
 }
 /**
- * Point at fraction `t` of the polyline's total arc length (haversine), plus the total length in
- * km. `t` is assumed clamped to [0, 1].
+ * Point at fraction `t` of the polyline's total arc length (haversine), plus the total length in km. `t` is assumed
+ * clamped to [0, 1].
  */
 function pointAlong(polyline, t) {
     const legs = [];

package/out/interpolation.js.map

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

package/out/lookup.d.ts

@@ -3,7 +3,7 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- *   `WofSqlitePlaceLookup` — the resolver implementation backed by `node:sqlite` + a Kysely-typed
+ *   `WOFSqlitePlaceLookup` — the resolver implementation backed by `node:sqlite` + a Kysely-typed
  *   query layer where the queries are non-trivial, and raw SQL where they aren't (FTS5 MATCH, the
  *   FTS index build).
  *
@@ -12,59 +12,58 @@
 import { DatabaseSync } from "node:sqlite";
 import { type Ancestor, type CoincidentLocality } from "@mailwoman/resolver";
 import { type Convention, type ConventionSource } from "./convention.js";
-import type { WofPostalCityAliasLookup } from "./postal-city-alias-lookup.js";
+import type { WOFPostalCityAliasLookup } from "./postal-city-alias-lookup.js";
 import { type ShardConfig } from "./sharding.js";
 import type { FindPlaceQuery, PlaceCandidate, PlaceLookup } from "./types.js";
-export interface WofSqlitePlaceLookupOpts {
+export interface WOFSqlitePlaceLookupOpts {
     /**
      * Path to the WOF SQLite distribution on disk. Mutually exclusive with `database`.
      *
      * **Single string** — opens that one DB as the main shard.
      *
-     * **Array** — opens the first entry as main, then ATTACHes each subsequent entry as a separate
-     * SQLite schema. Schema names are derived from the filename (`whosonfirst-data-postalcode-
-     * us-latest.db` → `postalcode_us`); override with `ShardConfig.schemaName` when the filename
-     * doesn't follow WOF convention. See `sharding.ts` for the derivation rules.
+     * **Array** — opens the first entry as main, then ATTACHes each subsequent entry as a separate SQLite schema. Schema
+     * names are derived from the filename (`whosonfirst-data-postalcode- us-latest.db` → `postalcode_us`); override with
+     * `ShardConfig.schemaName` when the filename doesn't follow WOF convention. See `sharding.ts` for the derivation
+     * rules.
      *
-     * Routing: queries with a `placetype` matching a shard's name (or explicit `placetypes` hint) are
-     * sent to that shard; everything else hits main. Cross-shard UNION is NOT done — BM25 isn't
-     * comparable across separately-indexed corpora.
+     * Routing: queries with a `placetype` matching a shard's name (or explicit `placetypes` hint) are sent to that shard;
+     * everything else hits main. Cross-shard UNION is NOT done — BM25 isn't comparable across separately-indexed
+     * corpora.
      */
     databasePath?: string | ReadonlyArray<string | ShardConfig>;
     /**
-     * Pre-opened DatabaseSync — primarily for tests against an inline fixture DB. Mutually exclusive
-     * with `databasePath`. Multi-shard requires `databasePath` (so the lookup owns the ATTACH).
+     * Pre-opened DatabaseSync — primarily for tests against an inline fixture DB. Mutually exclusive with `databasePath`.
+     * Multi-shard requires `databasePath` (so the lookup owns the ATTACH).
      */
     database?: DatabaseSync;
     /**
-     * If true, build the FTS5 `place_search` virtual table on construction if it doesn't already
-     * exist. The upstream WOF distribution does NOT ship FTS5, so callers either set this once on
-     * first open or pre-build it via the operator-side CLI documented in the README. Default false —
-     * the resolver assumes the index already exists and errors loudly if it doesn't.
+     * If true, build the FTS5 `place_search` virtual table on construction if it doesn't already exist. The upstream WOF
+     * distribution does NOT ship FTS5, so callers either set this once on first open or pre-build it via the
+     * operator-side CLI documented in the README. Default false — the resolver assumes the index already exists and
+     * errors loudly if it doesn't.
      *
-     * With multi-shard, `buildFts: true` builds the index on the **main** shard only. Other shards
-     * must be pre-built via `mailwoman-wof-build-fts` — operator script for predictable cost.
+     * With multi-shard, `buildFTS: true` builds the index on the **main** shard only. Other shards must be pre-built via
+     * `mailwoman-wof-build-fts` — operator script for predictable cost.
      */
-    buildFts?: boolean;
+    buildFTS?: boolean;
     /**
-     * Geographic Rule Engine convention source (Direction E, #289). Per-WOF-polygon resolution
-     * profiles, either as a ready `ConventionSource` or a plain `{ wofId: Convention }` seed map.
-     * Default empty — every query rides `WORLD_DEFAULT` (the EU coordinate-first behavior). JP/KR/TW
-     * add rows; #290 wires a build-from-source sqlite-backed source here.
+     * Geographic Rule Engine convention source (Direction E, #289). Per-WOF-polygon resolution profiles, either as a
+     * ready `ConventionSource` or a plain `{ wofID: Convention }` seed map. Default empty — every query rides
+     * `WORLD_DEFAULT` (the EU coordinate-first behavior). JP/KR/TW add rows; #290 wires a build-from-source sqlite-backed
+     * source here.
      */
     conventions?: ConventionSource | Record<number, Convention>;
     /**
-     * Opt-in postal-city alias reader (#475). When supplied, the coordinate-first locality scorer
-     * treats an observed `postal_city` ("Antioch", postcode 37013) as a name-match alias for the
-     * geographic locality the postcode sits in ("Nashville"), recovering the chronic postal-vs-
-     * geographic-city mismatch. Absent (the default), the resolver is byte-identical — every alias
-     * code path is gated on this being non-null, so an unprovided reader changes no score.
+     * Opt-in postal-city alias reader (#475). When supplied, the coordinate-first locality scorer treats an observed
+     * `postal_city` ("Antioch", postcode 37013) as a name-match alias for the geographic locality the postcode sits in
+     * ("Nashville"), recovering the chronic postal-vs- geographic-city mismatch. Absent (the default), the resolver is
+     * byte-identical — every alias code path is gated on this being non-null, so an unprovided reader changes no score.
      */
-    postalCityAliases?: WofPostalCityAliasLookup;
+    postalCityAliases?: WOFPostalCityAliasLookup;
 }
 /**
- * Ranking weights for `findPlace`. Tweakable per-instance but defaults match the values declared in
- * the Phase 4.2 plan doc.
+ * Ranking weights for `findPlace`. Tweakable per-instance but defaults match the values declared in the Phase 4.2 plan
+ * doc.
  */
 export interface RankingWeights {
     /** Boost when the candidate's placetype matches an explicit `placetype` filter. */
@@ -73,89 +72,83 @@ export interface RankingWeights {
     localityImplicitBoost: number;
     /** Boost when the candidate's country matches an explicit `country` filter. */
     countryMatchBoost: number;
-    /** Boost when the candidate is a direct child of the requested `parentId`. */
+    /** Boost when the candidate is a direct child of the requested `parentID`. */
     directChildBoost: number;
-    /** Boost when the candidate is a transitive descendant of the requested `parentId`. */
+    /** Boost when the candidate is a transitive descendant of the requested `parentID`. */
     descendantBoost: number;
     /** Multiplier on the length-penalty term (penalizes much-longer-than-query names). */
     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 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.
      */
     proximityBoost: number;
     /** 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 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.
      */
     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. 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).
      */
     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.
+     * 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
+     * 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/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).
+     * 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).
      */
     exactMatchTiering: boolean;
 }
 /** Padded character-trigram set (a leading/trailing space pads short tokens). */
 export declare function trigrams(s: string): Set<string>;
 /**
- * Character-trigram Jaccard ∈ [0,1] — tolerant of the swallowed-leading-char fragments ("auen" vs
- * "plauen") and minor misspellings without a heavyweight edit-distance pass. Shared with the
- * candidate backend's FTS5-trigram fuzzy fallback so both lookups rank typos identically.
+ * Character-trigram Jaccard ∈ [0,1] — tolerant of the swallowed-leading-char fragments ("auen" vs "plauen") and minor
+ * misspellings without a heavyweight edit-distance pass. Shared with the candidate backend's FTS5-trigram fuzzy
+ * fallback so both lookups rank typos identically.
  */
 export declare function trigramJaccard(a: string, b: string): number;
-export declare class WofSqlitePlaceLookup implements PlaceLookup, Disposable {
+export declare class WOFSqlitePlaceLookup implements PlaceLookup, Disposable {
     #private;
-    constructor(opts: WofSqlitePlaceLookupOpts, weights?: Partial<RankingWeights>);
+    constructor(opts: WOFSqlitePlaceLookupOpts, weights?: Partial<RankingWeights>);
     findPlace(query: FindPlaceQuery): Promise<PlaceCandidate[]>;
     /**
-     * Dual-role localities coincident with an admin id, from the precomputed `coincident_roles`
-     * relation (#403). Backs {@link ResolveOpts.hierarchyCompletion} (#405): O(1) once the relation is
-     * loaded. Returns `[]` when the relation table is absent (older DB) or the admin isn't a
-     * dual-role place, so completion degrades gracefully. The relation + `spr` join is loaded once
-     * and memoized.
+     * Dual-role localities coincident with an admin id, from the precomputed `coincident_roles` relation (#403). Backs
+     * {@link ResolveOpts.hierarchyCompletion} (#405): O(1) once the relation is loaded. Returns `[]` when the relation
+     * table is absent (older DB) or the admin isn't a dual-role place, so completion degrades gracefully. The relation +
+     * `spr` join is loaded once and memoized.
      */
-    coincidentLocalitiesFor(adminId: number | string): CoincidentLocality[];
+    coincidentLocalitiesFor(adminID: number | string): CoincidentLocality[];
     /**
-     * The ancestor lineage of a place — its containment chain joined with `spr` for canonical names,
-     * ordered NEAREST-FIRST (localadmin → county → region → … → country). Backs
-     * {@link ResolveOpts.includeAncestors} (#404). Self is excluded; memoized per id. Returns `[]`
-     * when the place has no recorded ancestry.
+     * The ancestor lineage of a place — its containment chain joined with `spr` for canonical names, ordered
+     * NEAREST-FIRST (localadmin → county → region → … → country). Backs {@link ResolveOpts.includeAncestors} (#404). Self
+     * is excluded; memoized per id. Returns `[]` when the place has no recorded ancestry.
      *
-     * The walk itself lives in `ancestry.ts` (shared with the reverse geocoder, #484); the ordering
-     * is its `PLACETYPE_DEPTH` table — same ranking as the previous inline SQL CASE, extended below
-     * `localadmin` so locality/neighbourhood ancestors order correctly instead of sorting last.
+     * The walk itself lives in `ancestry.ts` (shared with the reverse geocoder, #484); the ordering is its
+     * `PLACETYPE_DEPTH` table — same ranking as the previous inline SQL CASE, extended below `localadmin` so
+     * locality/neighbourhood ancestors order correctly instead of sorting last.
      */
     ancestors(id: number | string): Ancestor[];
     close(): void;

package/out/lookup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lookup.d.ts","sourceRoot":"","sources":["../lookup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,YAAY,EAAsB,MAAM,aAAa,CAAA;AAI9D,OAAO,EAAyB,KAAK,QAAQ,EAAE,KAAK,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AACnG,OAAO,EAIN,KAAK,UAAU,EACf,KAAK,gBAAgB,EAGrB,MAAM,iBAAiB,CAAA;AAcxB,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAA;AAE7E,OAAO,EAA4D,KAAK,WAAW,EAAE,MAAM,eAAe,CAAA;AAE1G,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,WAAW,EAAgB,MAAM,YAAY,CAAA;AAE3F,MAAM,WAAW,wBAAwB;IACxC;;;;;;;;;;;;;OAaG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC,MAAM,GAAG,WAAW,CAAC,CAAA;IAC3D;;;OAGG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAA;IACvB;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IAC3D;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,wBAAwB,CAAA;CAC5C;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC9B,mFAAmF;IACnF,mBAAmB,EAAE,MAAM,CAAA;IAC3B,sFAAsF;IACtF,qBAAqB,EAAE,MAAM,CAAA;IAC7B,+EAA+E;IAC/E,iBAAiB,EAAE,MAAM,CAAA;IACzB,8EAA8E;IAC9E,gBAAgB,EAAE,MAAM,CAAA;IACxB,uFAAuF;IACvF,eAAe,EAAE,MAAM,CAAA;IACvB,sFAAsF;IACtF,mBAAmB,EAAE,MAAM,CAAA;IAC3B;;;;;OAKG;IACH,cAAc,EAAE,MAAM,CAAA;IACtB,2FAA2F;IAC3F,gBAAgB,EAAE,MAAM,CAAA;IACxB;;;;;;OAMG;IACH,eAAe,EAAE,MAAM,CAAA;IACvB;;;;OAIG;IACH,oBAAoB,EAAE,MAAM,CAAA;IAC5B;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,iBAAiB,EAAE,OAAO,CAAA;CAC1B;AAyFD,iFAAiF;AACjF,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAK/C;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAO3D;AAgBD,qBAAa,oBAAqB,YAAW,WAAW,EAAE,UAAU;;gBAwDvD,IAAI,EAAE,wBAAwB,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC;IAyFvE,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAoBjE;;;;;;OAMG;IACH,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,kBAAkB,EAAE;IAgDvE;;;;;;;;;OASG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,EAAE;IA8e1C,KAAK,IAAI,IAAI;IASb,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;CAgBxB"}
+{"version":3,"file":"lookup.d.ts","sourceRoot":"","sources":["../lookup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAsB,MAAM,aAAa,CAAA;AAG9D,OAAO,EAAyB,KAAK,QAAQ,EAAE,KAAK,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AAKnG,OAAO,EAIN,KAAK,UAAU,EACf,KAAK,gBAAgB,EAGrB,MAAM,iBAAiB,CAAA;AAWxB,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAA;AAE7E,OAAO,EAA4D,KAAK,WAAW,EAAE,MAAM,eAAe,CAAA;AAE1G,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,WAAW,EAAgB,MAAM,YAAY,CAAA;AAE3F,MAAM,WAAW,wBAAwB;IACxC;;;;;;;;;;;;;OAaG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC,MAAM,GAAG,WAAW,CAAC,CAAA;IAC3D;;;OAGG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAA;IACvB;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IAC3D;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,wBAAwB,CAAA;CAC5C;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC9B,mFAAmF;IACnF,mBAAmB,EAAE,MAAM,CAAA;IAC3B,sFAAsF;IACtF,qBAAqB,EAAE,MAAM,CAAA;IAC7B,+EAA+E;IAC/E,iBAAiB,EAAE,MAAM,CAAA;IACzB,8EAA8E;IAC9E,gBAAgB,EAAE,MAAM,CAAA;IACxB,uFAAuF;IACvF,eAAe,EAAE,MAAM,CAAA;IACvB,sFAAsF;IACtF,mBAAmB,EAAE,MAAM,CAAA;IAC3B;;;;;OAKG;IACH,cAAc,EAAE,MAAM,CAAA;IACtB,2FAA2F;IAC3F,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;CAC1B;AAsFD,iFAAiF;AACjF,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAO/C;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAU3D;AAqBD,qBAAa,oBAAqB,YAAW,WAAW,EAAE,UAAU;;gBAqDvD,IAAI,EAAE,wBAAwB,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC;IA8FvE,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAwBjE;;;;;OAKG;IACH,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,kBAAkB,EAAE;IAsDvE;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,EAAE;IA6hB1C,KAAK,IAAI,IAAI;IAUb,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;CAgBxB"}