@mailwoman/resolver-wof-sqlite 9.1.0 → 9.2.0

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@mailwoman/resolver-wof-sqlite",
-  "version": "9.1.0",
+  "version": "9.2.0",
   "description": "Who's On First SQLite resolver — FTS5-backed PlaceLookup that resolves text queries to WOF place IDs + coordinates. Optional dependency for callers who want geocoding.",
   "license": "AGPL-3.0-only OR LicenseRef-Commercial",
   "repository": {
     "type": "git",
     "url": "https://github.com/sister-software/mailwoman.git",
-    "directory": "resolver-wof-sqlite"
+    "directory": "packages/resolver-wof-sqlite"
   },
   "files": [
     "out/**/*.js",
@@ -21,9 +21,28 @@
     "!*.test.ts",
     "!*.test.tsx",
     "!**/*.test.ts",
-    "!**/*.test.tsx"
+    "!**/*.test.tsx",
+    "!test/**"
   ],
   "type": "module",
+  "imports": {
+    "#candidate/alias-bags": {
+      "types": "./out/candidate/alias-bags.d.ts",
+      "default": "./out/candidate/alias-bags.js"
+    },
+    "#candidate/name-roles": {
+      "types": "./out/candidate/name-roles.d.ts",
+      "default": "./out/candidate/name-roles.js"
+    },
+    "#candidate/place-attrs": {
+      "types": "./out/candidate/place-attrs.d.ts",
+      "default": "./out/candidate/place-attrs.js"
+    },
+    "#sqlite-utils": {
+      "types": "./out/sqlite-utils.d.ts",
+      "default": "./out/sqlite-utils.js"
+    }
+  },
   "exports": {
     "./package.json": "./package.json",
     ".": {
@@ -34,6 +53,30 @@
       "types": "./out/fts.d.ts",
       "default": "./out/fts.js"
     },
+    "./fts-query": {
+      "types": "./out/fts-query.d.ts",
+      "default": "./out/fts-query.js"
+    },
+    "./primary-preference": {
+      "types": "./out/primary-preference.d.ts",
+      "default": "./out/primary-preference.js"
+    },
+    "./capitals": {
+      "types": "./out/capitals.d.ts",
+      "default": "./out/capitals.js"
+    },
+    "./capital-schema": {
+      "types": "./out/capital-schema.d.ts",
+      "default": "./out/capital-schema.js"
+    },
+    "./candidate/own-name": {
+      "types": "./out/candidate/own-name.d.ts",
+      "default": "./out/candidate/own-name.js"
+    },
+    "./proximity-rerank": {
+      "types": "./out/proximity-rerank.d.ts",
+      "default": "./out/proximity-rerank.js"
+    },
     "./build-slim": {
       "types": "./out/build-slim.d.ts",
       "default": "./out/build-slim.js"
@@ -98,18 +141,22 @@
       "types": "./out/geonames-postal.d.ts",
       "default": "./out/geonames-postal.js"
     },
-    "./geo": {
-      "types": "./out/geo.d.ts",
-      "default": "./out/geo.js"
-    },
     "./street-normalize": {
       "types": "./out/street-normalize.d.ts",
       "default": "./out/street-normalize.js"
     },
+    "./region-keys": {
+      "types": "./out/region-keys.d.ts",
+      "default": "./out/region-keys.js"
+    },
     "./build-candidate": {
       "types": "./out/build-candidate.d.ts",
       "default": "./out/build-candidate.js"
     },
+    "./candidate-ancestors-schema": {
+      "types": "./out/candidate-ancestors-schema.d.ts",
+      "default": "./out/candidate-ancestors-schema.js"
+    },
     "./candidate-schema": {
       "types": "./out/candidate-schema.d.ts",
       "default": "./out/candidate-schema.js"
@@ -137,6 +184,94 @@
     "./poi-lookup": {
       "types": "./out/poi-lookup.d.ts",
       "default": "./out/poi-lookup.js"
+    },
+    "./uprn-schema": {
+      "types": "./out/uprn-schema.d.ts",
+      "default": "./out/uprn-schema.js"
+    },
+    "./uprn-lookup": {
+      "types": "./out/uprn-lookup.d.ts",
+      "default": "./out/uprn-lookup.js"
+    },
+    "./weights-overlay-linker": {
+      "types": "./out/weights-overlay-linker.d.ts",
+      "default": "./out/weights-overlay-linker.js"
+    },
+    "./address-point-interpolation": {
+      "types": "./out/address-point-interpolation.d.ts",
+      "default": "./out/address-point-interpolation.js"
+    },
+    "./interpolation": {
+      "types": "./out/interpolation.d.ts",
+      "default": "./out/interpolation.js"
+    },
+    "./address-point": {
+      "types": "./out/address-point.d.ts",
+      "default": "./out/address-point.js"
+    },
+    "./ancestry": {
+      "types": "./out/ancestry.d.ts",
+      "default": "./out/ancestry.js"
+    },
+    "./candidate-lookup": {
+      "types": "./out/candidate-lookup.d.ts",
+      "default": "./out/candidate-lookup.js"
+    },
+    "./candidate-importance": {
+      "types": "./out/candidate-importance.d.ts",
+      "default": "./out/candidate-importance.js"
+    },
+    "./types": {
+      "types": "./out/types.d.ts",
+      "default": "./out/types.js"
+    },
+    "./lookup": {
+      "types": "./out/lookup.d.ts",
+      "default": "./out/lookup.js"
+    },
+    "./convention": {
+      "types": "./out/convention.d.ts",
+      "default": "./out/convention.js"
+    },
+    "./postal-city-alias-lookup": {
+      "types": "./out/postal-city-alias-lookup.d.ts",
+      "default": "./out/postal-city-alias-lookup.js"
+    },
+    "./postal-city-candidate-schema": {
+      "types": "./out/postal-city-candidate-schema.d.ts",
+      "default": "./out/postal-city-candidate-schema.js"
+    },
+    "./postcode-point-lookup": {
+      "types": "./out/postcode-point-lookup.d.ts",
+      "default": "./out/postcode-point-lookup.js"
+    },
+    "./reverse": {
+      "types": "./out/reverse.d.ts",
+      "default": "./out/reverse.js"
+    },
+    "./sharding": {
+      "types": "./out/sharding.d.ts",
+      "default": "./out/sharding.js"
+    },
+    "./sqlite-convention-source": {
+      "types": "./out/sqlite-convention-source.d.ts",
+      "default": "./out/sqlite-convention-source.js"
+    },
+    "./street-centroid": {
+      "types": "./out/street-centroid.d.ts",
+      "default": "./out/street-centroid.js"
+    },
+    "./street-name-lookup": {
+      "types": "./out/street-name-lookup.d.ts",
+      "default": "./out/street-name-lookup.js"
+    },
+    "./convention-schema": {
+      "types": "./out/convention-schema.d.ts",
+      "default": "./out/convention-schema.js"
+    },
+    "./polygon-schema": {
+      "types": "./out/polygon-schema.d.ts",
+      "default": "./out/polygon-schema.js"
     }
   },
   "publishConfig": {
@@ -151,6 +286,30 @@
         "types": "./out/fts.d.ts",
         "default": "./out/fts.js"
       },
+      "./fts-query": {
+        "types": "./out/fts-query.d.ts",
+        "default": "./out/fts-query.js"
+      },
+      "./primary-preference": {
+        "types": "./out/primary-preference.d.ts",
+        "default": "./out/primary-preference.js"
+      },
+      "./capitals": {
+        "types": "./out/capitals.d.ts",
+        "default": "./out/capitals.js"
+      },
+      "./capital-schema": {
+        "types": "./out/capital-schema.d.ts",
+        "default": "./out/capital-schema.js"
+      },
+      "./candidate/own-name": {
+        "types": "./out/candidate/own-name.d.ts",
+        "default": "./out/candidate/own-name.js"
+      },
+      "./proximity-rerank": {
+        "types": "./out/proximity-rerank.d.ts",
+        "default": "./out/proximity-rerank.js"
+      },
       "./build-slim": {
         "types": "./out/build-slim.d.ts",
         "default": "./out/build-slim.js"
@@ -215,18 +374,22 @@
         "types": "./out/geonames-postal.d.ts",
         "default": "./out/geonames-postal.js"
       },
-      "./geo": {
-        "types": "./out/geo.d.ts",
-        "default": "./out/geo.js"
-      },
       "./street-normalize": {
         "types": "./out/street-normalize.d.ts",
         "default": "./out/street-normalize.js"
       },
+      "./region-keys": {
+        "types": "./out/region-keys.d.ts",
+        "default": "./out/region-keys.js"
+      },
       "./build-candidate": {
         "types": "./out/build-candidate.d.ts",
         "default": "./out/build-candidate.js"
       },
+      "./candidate-ancestors-schema": {
+        "types": "./out/candidate-ancestors-schema.d.ts",
+        "default": "./out/candidate-ancestors-schema.js"
+      },
       "./candidate-schema": {
         "types": "./out/candidate-schema.d.ts",
         "default": "./out/candidate-schema.js"
@@ -254,17 +417,126 @@
       "./poi-lookup": {
         "types": "./out/poi-lookup.d.ts",
         "default": "./out/poi-lookup.js"
+      },
+      "./uprn-schema": {
+        "types": "./out/uprn-schema.d.ts",
+        "default": "./out/uprn-schema.js"
+      },
+      "./uprn-lookup": {
+        "types": "./out/uprn-lookup.d.ts",
+        "default": "./out/uprn-lookup.js"
+      },
+      "./weights-overlay-linker": {
+        "types": "./out/weights-overlay-linker.d.ts",
+        "default": "./out/weights-overlay-linker.js"
+      },
+      "./address-point-interpolation": {
+        "types": "./out/address-point-interpolation.d.ts",
+        "default": "./out/address-point-interpolation.js"
+      },
+      "./interpolation": {
+        "types": "./out/interpolation.d.ts",
+        "default": "./out/interpolation.js"
+      },
+      "./address-point": {
+        "types": "./out/address-point.d.ts",
+        "default": "./out/address-point.js"
+      },
+      "./ancestry": {
+        "types": "./out/ancestry.d.ts",
+        "default": "./out/ancestry.js"
+      },
+      "./candidate-lookup": {
+        "types": "./out/candidate-lookup.d.ts",
+        "default": "./out/candidate-lookup.js"
+      },
+      "./candidate-importance": {
+        "types": "./out/candidate-importance.d.ts",
+        "default": "./out/candidate-importance.js"
+      },
+      "./types": {
+        "types": "./out/types.d.ts",
+        "default": "./out/types.js"
+      },
+      "./lookup": {
+        "types": "./out/lookup.d.ts",
+        "default": "./out/lookup.js"
+      },
+      "./convention": {
+        "types": "./out/convention.d.ts",
+        "default": "./out/convention.js"
+      },
+      "./postal-city-alias-lookup": {
+        "types": "./out/postal-city-alias-lookup.d.ts",
+        "default": "./out/postal-city-alias-lookup.js"
+      },
+      "./postal-city-candidate-schema": {
+        "types": "./out/postal-city-candidate-schema.d.ts",
+        "default": "./out/postal-city-candidate-schema.js"
+      },
+      "./postcode-point-lookup": {
+        "types": "./out/postcode-point-lookup.d.ts",
+        "default": "./out/postcode-point-lookup.js"
+      },
+      "./reverse": {
+        "types": "./out/reverse.d.ts",
+        "default": "./out/reverse.js"
+      },
+      "./sharding": {
+        "types": "./out/sharding.d.ts",
+        "default": "./out/sharding.js"
+      },
+      "./sqlite-convention-source": {
+        "types": "./out/sqlite-convention-source.d.ts",
+        "default": "./out/sqlite-convention-source.js"
+      },
+      "./street-centroid": {
+        "types": "./out/street-centroid.d.ts",
+        "default": "./out/street-centroid.js"
+      },
+      "./street-name-lookup": {
+        "types": "./out/street-name-lookup.d.ts",
+        "default": "./out/street-name-lookup.js"
+      },
+      "./convention-schema": {
+        "types": "./out/convention-schema.d.ts",
+        "default": "./out/convention-schema.js"
+      },
+      "./polygon-schema": {
+        "types": "./out/polygon-schema.d.ts",
+        "default": "./out/polygon-schema.js"
+      }
+    },
+    "imports": {
+      "#candidate/alias-bags": {
+        "types": "./out/candidate/alias-bags.d.ts",
+        "default": "./out/candidate/alias-bags.js"
+      },
+      "#candidate/name-roles": {
+        "types": "./out/candidate/name-roles.d.ts",
+        "default": "./out/candidate/name-roles.js"
+      },
+      "#candidate/place-attrs": {
+        "types": "./out/candidate/place-attrs.d.ts",
+        "default": "./out/candidate/place-attrs.js"
+      },
+      "#sqlite-utils": {
+        "types": "./out/sqlite-utils.d.ts",
+        "default": "./out/sqlite-utils.js"
       }
     }
   },
   "dependencies": {
-    "@mailwoman/codex": "9.1.0",
-    "@mailwoman/core": "9.1.0",
-    "@mailwoman/resolver": "9.1.0",
-    "@mailwoman/spatial": "9.1.0",
+    "@mailwoman/ancestrie": "9.2.0",
+    "@mailwoman/codex": "9.2.0",
+    "@mailwoman/core": "9.2.0",
+    "@mailwoman/match": "9.2.0",
+    "@mailwoman/resolver": "9.2.0",
+    "@mailwoman/spatial": "9.2.0",
     "h3-js": "^4.5.0",
     "kysely": "^0.29.4",
     "path-ts": "^2.1.0",
-    "spliterator": "^6.1.0"
+    "spliterator": "^6.2.0",
+    "type-fest": "^5.8.0"
   }
 }

package/place-importance-schema.ts

@@ -26,9 +26,9 @@
  *   ABOVE the place every user means. Referentially the suburb wins by 230x on population. One score
  *   cannot serve both readers, which is why there are two.
  *
- *   THE LEGACY COLUMN STAYS, AND IS DERIVED. `importance` remains as `COALESCE(encyclopedic,
- *   referential)` — byte-for-byte today's semantics — so every reader built against the old table
- *   keeps working while the split rolls out. It is the CONFLATION, and nothing new should read it.
+ *   THE LEGACY COLUMN STAYS, AND IS DERIVED. `importance` is written by {@link blendImportance} — the
+ *   bounded blend the bare-toponym fame consumer (#28) ranks on. It is the CONFLATION, and nothing new
+ *   should read it; new code reads the split columns.
  */
 
 import type { DatabaseSync } from "node:sqlite"
@@ -36,6 +36,8 @@ import type { DatabaseSync } from "node:sqlite"
 import { referentialFromPopulation } from "@mailwoman/core/resolver"
 import type { Kysely } from "kysely"
 
+import { allRows } from "./sqlite-utils.ts"
+
 //#region Schema
 
 /**
@@ -55,8 +57,8 @@ export interface PlaceImportanceTable {
 	 */
 	encyclopedic: number | null
 	/**
-	 * DEPRECATED — the pre-split conflation, written as `COALESCE(encyclopedic, referential)` so pre-split readers keep
-	 * working unchanged. New code reads {@link PlaceImportanceTable.referential} (to rank) or
+	 * DEPRECATED — the pre-split conflation, written by {@link blendImportance} so the bare-toponym fame consumer (#28)
+	 * keeps one cross-bearer scale. New code reads {@link PlaceImportanceTable.referential} (to rank) or
 	 * {@link PlaceImportanceTable.encyclopedic} (to display).
 	 */
 	importance: number
@@ -115,6 +117,55 @@ export {
 
 //#endregion
 
+//#region The legacy blend
+
+/**
+ * The most the encyclopedic channel may raise a place's blended importance above its population-anchored referential
+ * score.
+ *
+ * In referential units 0.25 is 3.5 population doublings (the referential curve divides log2 by 14), so an article can
+ * promote a place as if it were up to ~11x its recorded population — never more. The bound exists because the two
+ * channels' scales CROSS at the article floor: merely having a Wikipedia article scores ~0.25–0.35, which exceeds the
+ * referential score of a mid-size town, so an unbounded blend ranks a 136-person village with an article above a
+ * 16,026-person town without one.
+ *
+ * The value is bracketed by two decided contests, measured on the 2026-08-24 staging build:
+ *
+ * - `> 0.2282`, or bare `Whitby` stops answering Whitby GB (pop 13,130, referential 0.2729, encyclopedic 0.5496) over
+ *   Whitby CA (pop 128,377, referential 0.5011) — the #28 design case the fame prior exists to serve.
+ * - `< 0.2790`, or bare `Tó`/`To` answers Tó PT (pop 136, referential 0.0131, encyclopedic 0.3375) over Tô BF (pop
+ *   16,026, no article) — the `bf-gloss-to-*` board pair.
+ *
+ * 0.25 sits mid-interval with ~0.02 margin to each bound.
+ */
+export const ENCYCLOPEDIC_BOOST_CAP = 0.25
+
+/**
+ * The legacy `importance` blend — one cross-bearer fame scale for the #28 consumer, derived from the two split
+ * channels:
+ *
+ * - No article → the referential score.
+ * - No population evidence (`referential` 0) → the encyclopedic score stands alone: there is nothing to bound the
+ *   article's claim against, and a constant cap would demote every famous place WOF records no population for
+ *   (meaning-of-zero: referential 0 is "unmeasured", not "tiny").
+ * - Both present → the encyclopedic value clamped to at most {@link ENCYCLOPEDIC_BOOST_CAP} above the referential score,
+ *   and never below it. The floor half repairs the downward inversion (the Seine-Saint-Denis suburb's weak article
+ *   scored 0.1173 and REPLACED its referential 0.4716 under the old `COALESCE`, so a 418-person Aude hamlet outranked
+ *   it 4.8x); the cap half repairs the upward one (`Tó`, above).
+ *
+ * Scale of the clamp on the 2026-08-24 staging build: of 628,202 article-bearing rows, 209,738 sit above the cap and
+ * 13,888 sit below their referential floor; the 305,168 article-without-population rows pass through unchanged.
+ */
+export function blendImportance(referential: number, encyclopedic: number | null | undefined): number {
+	if (encyclopedic === null || encyclopedic === undefined) return referential
+
+	if (referential <= 0) return encyclopedic
+
+	return Math.max(referential, Math.min(encyclopedic, referential + ENCYCLOPEDIC_BOOST_CAP))
+}
+
+//#endregion
+
 //#region Reading a database that may or may not carry the split
 
 /**
@@ -163,9 +214,7 @@ export function encyclopedicClauses(db: DatabaseSync, schemaName: string): { sel
 	let present: boolean
 
 	try {
-		const rows = db.prepare(`PRAGMA ${schemaName}.table_info(place_importance)`).all() as unknown as Array<{
-			name: string
-		}>
+		const rows = allRows<{ name: string }>(db.prepare(`PRAGMA ${schemaName}.table_info(place_importance)`))
 
 		present = rows.some((r) => r.name === "encyclopedic")
 	} catch {
@@ -253,7 +302,7 @@ export interface ImportanceSplit {
  */
 function tableColumns(db: DatabaseSync, table: string): Set<string> {
 	try {
-		const rows = db.prepare(`PRAGMA table_info(${table})`).all() as unknown as Array<{ name: string }>
+		const rows = allRows<{ name: string }>(db.prepare(`PRAGMA table_info(${table})`))
 
 		return new Set(rows.map((r) => r.name))
 	} catch {
@@ -276,10 +325,10 @@ export function loadImportanceSplit(db: DatabaseSync): ImportanceSplit {
 	const populationColumns = tableColumns(db, "place_population")
 
 	if (populationColumns.has("population")) {
-		const rows = db.prepare("SELECT id, population FROM place_population").all() as unknown as Array<{
+		const rows = allRows<{
 			id: number
 			population: number
-		}>
+		}>(db.prepare("SELECT id, population FROM place_population"))
 
 		for (const row of rows) {
 			population.set(row.id, row.population)
@@ -297,11 +346,11 @@ export function loadImportanceSplit(db: DatabaseSync): ImportanceSplit {
 		// Post-split build: the columns ARE the contract. Referential is read verbatim rather than
 		// re-derived, so a build that scored referential differently stays visible instead of being
 		// silently overwritten by this reader's own formula.
-		const rows = db.prepare("SELECT id, referential, encyclopedic FROM place_importance").all() as unknown as Array<{
+		const rows = allRows<{
 			id: number
 			referential: number
 			encyclopedic: number | null
-		}>
+		}>(db.prepare("SELECT id, referential, encyclopedic FROM place_importance"))
 
 		for (const row of rows) {
 			if (row.referential > 0) {
@@ -317,10 +366,10 @@ export function loadImportanceSplit(db: DatabaseSync): ImportanceSplit {
 	}
 
 	if (importanceColumns.has("importance")) {
-		const rows = db.prepare("SELECT id, importance FROM place_importance").all() as unknown as Array<{
+		const rows = allRows<{
 			id: number
 			importance: number
-		}>
+		}>(db.prepare("SELECT id, importance FROM place_importance"))
 
 		let legacyFallbackRows = 0
 

package/poi-lookup.ts

@@ -31,6 +31,7 @@ import { haversineKm, shortCellToInt, type H3Cell } from "@mailwoman/spatial"
 import { gridDisk, latLngToCell } from "h3-js"
 
 import type { POICategoryCodeTable, POITable } from "./poi-schema.ts"
+import { allRows } from "./sqlite-utils.ts"
 
 /**
  * Resolution the `poi` table's `h3_cell` column is keyed at — matches the builder (spec §3.4).
@@ -141,7 +142,7 @@ type POIRow = Pick<
 /**
  * Node reader over `poi.db`. `implements Disposable` so callers can `using lookup = new POILookup(...)` (or call
  * `[Symbol.dispose]()` explicitly), the same precedent as {@link WOFCandidateTableLookup} /
- * {@link WOFSqlitePlaceLookup}.
+ * {@link WOFSQLitePlaceLookup}.
  */
 export class POILookup implements Disposable {
 	#db: DatabaseSync
@@ -175,9 +176,7 @@ export class POILookup implements Disposable {
 
 		// The category dictionary is tiny (poi-taxonomy's category count) — load it once at
 		// construction so `search` never round-trips to it.
-		for (const r of this.#db
-			.prepare("SELECT id, category FROM poi_category_codes")
-			.all() as unknown as POICategoryCodeTable[]) {
+		for (const r of allRows<POICategoryCodeTable>(this.#db.prepare("SELECT id, category FROM poi_category_codes"))) {
 			this.#categoryToID.set(String(r.category), Number(r.id))
 			this.#idToCategory.set(Number(r.id), String(r.category))
 		}
@@ -226,7 +225,7 @@ export class POILookup implements Disposable {
 	 * nearest at any distance — the reach ceiling k-ring hits on sparse brand rows is gone.
 	 */
 	#searchBrand(brandWikidata: string, center: { latitude: number; longitude: number }, limit: number): POISearchHit[] {
-		const rows = this.#brandProbe.all(brandWikidata) as unknown as POIRow[]
+		const rows = allRows<POIRow>(this.#brandProbe, brandWikidata)
 
 		return sortByDistance(rows, center)
 			.filter(
@@ -242,7 +241,7 @@ export class POILookup implements Disposable {
 	#searchKRing(query: POISearchQuery, limit: number): POISearchHit[] {
 		const center = query.center!
 		const maxRings = query.maxRings ?? DEFAULT_MAX_RINGS
-		const categoryIds: number[] = []
+		const categoryIDs: number[] = []
 
 		// `categoryIDs` (the fan-out list) supersedes the single `categoryID`; either way, resolve each id through the
 		// dictionary and drop the ones the db doesn't carry (Overture-taxonomy drift, or an identity id with no rows).
@@ -252,12 +251,12 @@ export class POILookup implements Disposable {
 			const resolved = this.#categoryToID.get(id)
 
 			if (resolved !== undefined) {
-				categoryIds.push(resolved)
+				categoryIDs.push(resolved)
 			}
 		}
 
 		// No resolvable leaf (every id unknown to the dictionary) can't have rows — a clean miss, not a throw.
-		if (!categoryIds.length) return []
+		if (!categoryIDs.length) return []
 
 		const origin = latLngToCell(center.latitude, center.longitude, POI_H3_RESOLUTION) as H3Cell
 		const seenCells = new Set<string>()
@@ -276,8 +275,8 @@ export class POILookup implements Disposable {
 
 				// Fan-out: probe every resolved Overture leaf for this canonical category, unioning the rows. The
 				// post-ring distance sort + `slice(0, limit)` below dedupes the pool down to the nearest `limit`.
-				for (const categoryID of categoryIds) {
-					rows.push(...(this.#categoryCellProbe.all(shortCell, categoryID, limit) as unknown as POIRow[]))
+				for (const categoryID of categoryIDs) {
+					rows.push(...allRows<POIRow>(this.#categoryCellProbe, shortCell, categoryID, limit))
 				}
 			}
 
@@ -301,7 +300,7 @@ export class POILookup implements Disposable {
 
 		if (!matchQuery) return []
 
-		const ftsHits = this.#nameFTSProbe.all(matchQuery, limit) as unknown as Array<{ name_key: string | null }>
+		const ftsHits = allRows<{ name_key: string | null }>(this.#nameFTSProbe, matchQuery, limit)
 		const uniqueKeys: string[] = []
 		const seenKeys = new Set<string>()
 
@@ -350,7 +349,7 @@ export class POILookup implements Disposable {
 		const placeholders = nameKeys.map(() => "?").join(", ")
 		const stmt = this.#db.prepare(`SELECT ${columns} FROM poi WHERE name_key IN (${placeholders})`)
 
-		return stmt.all(...nameKeys) as unknown as POIRow[]
+		return allRows<POIRow>(stmt, ...nameKeys)
 	}
 
 	close(): void {
@@ -406,7 +405,7 @@ function sanitizePOINameQuery(text: string): string {
 		.replaceAll(/["*:]/g, "")
 		.trim()
 		.split(/\s+/u)
-		.filter(Boolean)
+		.filter((token) => token.length > 0)
 		.map((token) => `"${token.replaceAll('"', '""')}"`)
 		.join(" ")
 }

package/poi-schema.ts

@@ -17,6 +17,8 @@ import type { DatabaseSync } from "node:sqlite"
 import type { LayerContractDatabase } from "@mailwoman/core/layers"
 import { sql, type Kysely } from "kysely"
 
+import type { NameKey } from "./street-normalize.ts"
+
 /**
  * One POI row. Clustered PK: h3_cell → category_id → neg_rank → rowid_key.
  */
@@ -39,9 +41,12 @@ export interface POITable {
 	rowid_key: number
 	name: string | null
 	/**
-	 * Lowercased, diacritic-flattened probe key for exact name lookups.
+	 * Probe key for exact name lookups, minted by {@link normalizeLocalityForKey} at build AND at query.
+	 *
+	 * Branded because a `toLowerCase()` approximation of the fold is still a `string`: it binds to the parameter, returns
+	 * fewer rows, and the shortfall reads as a coverage gap in the data rather than a defect in the probe.
 	 */
-	name_key: string | null
+	name_key: NameKey | null
 	brand_wikidata: string | null
 	latitude: number
 	longitude: number
@@ -69,7 +74,7 @@ export interface POIStageTable {
 	neg_rank: number | null
 	rowid_key: number | null
 	name: string | null
-	name_key: string | null
+	name_key: NameKey | null
 	brand_wikidata: string | null
 	latitude: number
 	longitude: number