@mailwoman/resolver-wof-sqlite 10.1.0 → 10.2.0

package/lib/street/morphology/fst/builder.ts

@@ -24,7 +24,8 @@
  *   `fst-street-morphology.bin`.
  */
 
-import { isDirectory, isFile, readLocalTextFile } from "@mailwoman/core/fs/readers"
+import { readLocalTextFile } from "@mailwoman/core/fs/readers"
+import { isDirectory, isFile } from "@mailwoman/core/fs/readers/stat"
 import { PathBuilder, type PathBuilderLike } from "path-ts"
 import { TextSpliterator } from "spliterator"
 import { Globerator } from "spliterator/node/fs"
@@ -52,14 +53,12 @@ export interface BuildStreetMorphologyFSTOpts {
 	/**
 	 * Optional locale filter — only ingest these locale subfolders.
 	 *
-	 * Defaults to all that have a `street_types.txt`.
+	 * @defaultValue all that have a `street_types.txt`.
 	 */
 	locales?: string[]
 	/**
 	 * Minimum length (in characters, post-normalization) of variant surface forms to insert into the trie.
 	 *
-	 * Defaults to 3.
-	 *
 	 * Rationale: libpostal's street_types dictionaries contain 1-2 character abbreviations
 	 * (`a`, `b`, `av`, `bd`, `br`, ...) that collide with non-affix tokens at parse time,
 	 * including US state abbreviations (`or`, `CA`, `ND`, `NY`).
@@ -69,6 +68,8 @@ export interface BuildStreetMorphologyFSTOpts {
 	 * abbreviations as `street_suffix`.
 	 *
 	 * A minimum length of 3 retains useful forms (`ave`, `blvd`, `rue`, `str`) while filtering out the noise.
+	 *
+	 * @defaultValue `3`
 	 */
 	minVariantLength?: number
 	/**
@@ -97,7 +98,7 @@ export interface BuildStreetMorphologyFSTResult {
 function parseLine(line: string): { canonical: string; variants: string[] } | null {
 	const trimmed = line.trim()
 
-	if (!trimmed.length || trimmed.startsWith("#")) return null
+	if (!trimmed || trimmed.startsWith("#")) return null
 
 	const parts = TextSpliterator.from(trimmed, { delimiter: "|" }).toArray()
 
@@ -223,11 +224,12 @@ export async function buildStreetMorphologyFST(
 			// (Avenue is almost never anything but street-typing).
 			// The morphology prior caps bias separately.
 			// This value just feeds the cap formula `referential * cap`.
-			// No encyclopedic field — a street affix is not a place and has no article.
-			// Absence here is the correct statement.
+			// No encyclopedic score — a street affix is not a place and has no article.
 			referential: 1,
+			encyclopedic: null,
 			lat: 0,
 			lon: 0,
+			crossCountryBranches: null,
 		}
 
 		for (const variant of variants) {
@@ -260,7 +262,14 @@ export async function buildStreetMorphologyFST(
 		edgeCount,
 		nameInsertions: insertCount,
 		importanceMatches: 0, // No importance scoring for morphology — fixed at 1.0.
+		encyclopedicMatches: null,
+		importanceSource: null,
 		sourceDB: dictionariesDir.toString(),
+		sourceDBMD5: null,
+		sourceDBBytes: null,
+		modelCardVersion: null,
+		exclusionPolicy: null,
+		excludedInsertions: null,
 	}
 
 	return {

package/lib/street/morphology/fst/loader.ts

@@ -19,7 +19,8 @@
  *   artifact through `fst-deserialize-web.ts` (see the docs demo loader).
  */
 
-import { pathExists, readLocalBuffer } from "@mailwoman/core/fs/readers"
+import { readLocalBuffer } from "@mailwoman/core/fs/readers"
+import { pathExists } from "@mailwoman/core/fs/readers/stat"
 import { resourceDictionaryPath } from "@mailwoman/core/paths"
 import type { PathBuilder, PathBuilderLike } from "path-ts"
 
@@ -53,13 +54,13 @@ export interface LoadStreetMorphologyFSTOpts {
 	/**
 	 * Dictionaries dir for the build fallback.
 	 *
-	 * Defaults to core's bundled libpostal dictionaries.
+	 * @defaultValue core's bundled libpostal dictionaries.
 	 */
 	dictionariesDir?: PathBuilderLike
 	/**
 	 * Unreadable-artifact diagnostics.
 	 *
-	 * Defaults to silent (the caller owns its warn channel).
+	 * @defaultValue silent (the caller owns its warn channel).
 	 */
 	onWarn?: (message: string) => void
 }
@@ -73,11 +74,11 @@ export interface LoadedStreetMorphologyFST {
 	/**
 	 * The artifact path when `source === "artifact"`.
 	 */
-	path?: PathBuilderLike
+	path: PathBuilderLike | null
 	/**
 	 * Build provenance, read from the artifact trailer or copied from the fallback build.
 	 */
-	provenance?: FSTProvenance
+	provenance: FSTProvenance | null
 }
 
 /**
@@ -96,7 +97,7 @@ export async function loadStreetMorphologyFST(
 			const matcher = deserializeFST(buf)
 			const provenance = readFSTProvenance(buf)
 
-			return { matcher, source: "artifact", path: artifactPath, ...(provenance ? { provenance } : {}) }
+			return { matcher, source: "artifact", path: artifactPath, provenance }
 		} catch (error) {
 			warn(
 				`street-morphology artifact at ${artifactPath} unreadable (${(error as Error).message}) — falling back to the dictionary build`
@@ -108,5 +109,5 @@ export async function loadStreetMorphologyFST(
 		dictionariesDir: (opts.dictionariesDir ?? resourceDictionaryPath("libpostal")).toString(),
 	})
 
-	return { matcher: built.matcher, source: "built", provenance: built.provenance }
+	return { matcher: built.matcher, source: "built", path: null, provenance: built.provenance }
 }

package/lib/street/name-lookup.ts

@@ -29,13 +29,13 @@ export interface SQLiteStreetNameLookupOpts {
 	/**
 	 * ISO-2 (upper-case) countries this index answers for.
 	 *
-	 * Default `["FR"]` (the BAN street-centroids instance).
+	 * @defaultValue `["FR"]` (the BAN street-centroids instance).
 	 */
 	countries?: Iterable<string>
 	/**
 	 * Table name.
 	 *
-	 * Default `street_centroid`.
+	 * @defaultValue `street_centroid`
 	 */
 	table?: string
 }
@@ -88,15 +88,11 @@ export class SQLiteStreetNameLookup extends SQLiteLookup<WOFDatabase> implements
 		// Scoped lookups tighten precision when the hypothesis includes a locality/postcode.
 		// A scoped miss falls back to the unscoped probe.
 		// The scope column may be incomplete, so a miss there does not establish absence.
-		if (
-			scope?.locality &&
-			this.#byNameLocality &&
-			this.#byNameLocality.get(norm, foldStreetSurface(scope.locality)) !== undefined
-		) {
+		if (scope?.locality && this.#byNameLocality && this.#byNameLocality.get(norm, foldStreetSurface(scope.locality))) {
 			return true
 		}
 
-		if (scope?.postcode && this.#byNamePostcode && this.#byNamePostcode.get(norm, scope.postcode) !== undefined) {
+		if (scope?.postcode && this.#byNamePostcode && this.#byNamePostcode.get(norm, scope.postcode)) {
 			return true
 		}
 

package/lib/street/normalize.ts

@@ -377,7 +377,7 @@ export function stripLocalityQualifier(locality: string): string {
 	}
 
 	const words = [...s.matchAll(/\S+/gu)].map((match) => ({ value: match[0], index: match.index }))
-	let qualifierStart: number | undefined
+	let qualifierStart: number | null = null
 
 	for (let index = 1; index < words.length; index++) {
 		const word = words[index]!
@@ -400,7 +400,7 @@ export function stripLocalityQualifier(locality: string): string {
 	const suffix = words.at(-1)
 
 	if (
-		qualifierStart === undefined &&
+		qualifierStart === null &&
 		suffix &&
 		words.length > 1 &&
 		(["S", "N", "E", "W", "V", "Ø", "Sø", "Fyn", "Thy", "Sjælland", "Jylland"].includes(suffix.value) ||
@@ -409,7 +409,7 @@ export function stripLocalityQualifier(locality: string): string {
 		qualifierStart = suffix.index
 	}
 
-	if (qualifierStart !== undefined) {
+	if (qualifierStart !== null) {
 		s = s.slice(0, qualifierStart).trimEnd()
 	}
 

package/lib/street/segment-schema.ts

@@ -214,7 +214,7 @@ const STREET_SEGMENT_CLUSTER_ORDER = "street_norm, postcode, min_hn, max_hn, row
  *
  * `street_segment` stays a rowid table, because `postcode` is nullable.
  * A `WITHOUT ROWID` primary key forbids a null column.
- * Loading in key order gives the same page locality.
+ * A load in key order gives the same page locality.
  *
  * Run {@link createStreetSegmentIndexes} and `VACUUM` afterwards.
  */
@@ -233,7 +233,7 @@ export async function clusterStreetSegments(db: Kysely<StreetSegmentDatabase>):
 /**
  * Create the two probe indexes the readers use (postcode-scope, street-scope).
  *
- * Each index carries `max_hn`.
+ * Each index holds `max_hn`.
  * SQLite therefore rejects a range ending below the house number from the index entry.
  * The rejected row's table page is never fetched.
  */

package/lib/types.ts

@@ -45,69 +45,74 @@ export interface PlaceCandidate {
 	 * The place's depth-1 ancestor id from the ancestors sidecar, absent when the
 	 * artifact has no sidecar even for a place with a parent.
 	 */
-	parent_id?: number
+	parent_id: number | null
 	score: number
-	distanceKm?: number
+	distanceKm: number | null
 
 	/**
 	 * Whether the candidate's name or an alias exactly equals the query, used by a
 	 * later re-rank to stay within the exact-match tier.
 	 */
-	exactMatch?: boolean
+	exactMatch: boolean | null
 
 	/**
 	 * The population term plus the best proximity-bias term.
 	 *
 	 * The exact tier sorts by this value instead of population when the query has `near` or `bias`.
 	 */
-	prominence?: number
+	prominence: number | null
 
 	/**
 	 * The WOF `wof:population` value, absent when the population is unknown.
 	 */
-	population?: number
+	population: number | null
 
 	/**
 	 * The referential likelihood in [0, 1], derived from {@link PlaceCandidate.population}
 	 * and absent whenever it is.
 	 */
-	referential?: number
+	referential: number | null
 
 	/**
 	 * The encyclopedia-evidence importance in [0, 1], used for display only and present only
 	 * when the extract's `place_importance` table has the split columns.
 	 */
-	encyclopedic?: number
+	encyclopedic: number | null
 
 	/**
 	 * The blended toponym prior in [0, 1] that `rankByImportance` reads for bare toponyms,
 	 * set only by the candidate-table backend.
 	 */
-	importance?: number
+	importance: number | null
 
 	/**
 	 * The bounding box from the WOF `spr` extent columns, omitted when the schema lacks them.
 	 */
-	bbox?: LatLonBounds
+	bbox: LatLonBounds | null
 
 	/**
 	 * Set by the postcode path when the chosen locality is far from the postcode's own
 	 * locality. the candidate is still returned so callers can lower their confidence.
 	 */
-	mismatch?: boolean
+	mismatch: boolean | null
 
 	/**
 	 * Whether the ancestors sidecar places this candidate under the query's
 	 * {@link FindPlaceQuery.regionQualifier}, with `false` meaning the check ran
 	 * and an absent value meaning it did not.
 	 */
-	containedByQualifier?: boolean
+	containedByQualifier: boolean | null
+
+	/**
+	 * Set when the candidate lies outside the query's parent scope, so callers can demote it.
+	 */
+	regionScopeMiss: boolean | null
 
 	/**
 	 * Set when the variant exemption spared the candidate from the cross-country
 	 * alias penalty, by the candidate-table backend only.
 	 */
-	variantAliasExempted?: true
+	variantAliasExempted: true | null
 }
 
 /**

package/lib/uprn/lookup.ts

@@ -150,7 +150,7 @@ export class UPRNLookup implements Disposable {
 				for (const row of rows) {
 					const distanceM = haversineKm(latitude, longitude, row.lat, row.lon) * 1000
 
-					if (distanceM <= radiusM && (best === null || distanceM < best.distanceM)) {
+					if (distanceM <= radiusM && (!best || distanceM < best.distanceM)) {
 						best = { uprn: row.uprn, latitude: row.lat, longitude: row.lon, distanceM }
 					}
 				}

package/lib/weights-overlay-linker.ts

@@ -5,14 +5,8 @@
  */
 
 import { dataRootPath, weightsOverlayPath } from "@mailwoman/core/data-root"
-import {
-	pathExists,
-	readLocalJSONFile,
-	readLocalTextFile,
-	statPath,
-	readLocalBuffer,
-	statLink,
-} from "@mailwoman/core/fs/readers"
+import { readLocalJSONFile, readLocalTextFile, readLocalBuffer } from "@mailwoman/core/fs/readers"
+import { pathExists, statPath, statLink } from "@mailwoman/core/fs/readers/stat"
 import {
 	createSymbolicLink,
 	makeDirectories,
@@ -140,24 +134,27 @@ export interface PairIndexOverlay {
 
 	/**
 	 * The source files whose MD5s the build records, in the order that `gazetteer pair-index` records them.
-	 * The default is the WOF admin database.
 	 *
 	 * The freshness check compares each MD5 with the header.
 	 * An empty list makes the check compare the magnitudes only.
+	 *
+	 * @defaultValue the WOF admin database.
 	 */
 	sources?: PathBuilder[]
 
 	/**
 	 * Files that must exist before a build runs.
 	 *
-	 * The default is `sources`.
 	 * A missing file prints a warning and skips the build.
+	 *
+	 * @defaultValue `sources`
 	 */
 	inputs?: PathBuilder[]
 
 	/**
 	 * Extra CLI arguments that pass the build's sources.
-	 * The default is `--borough-db <admin db>`.
+	 *
+	 * @defaultValue `--borough-db <admin db>`
 	 */
 	extraArgs?: PathBuilderLike[]
 
@@ -268,10 +265,7 @@ export interface PairIndexCalibration {
  *
  * The caller checks the source MD5s because only the caller knows its sources.
  */
-export function pairIndexStaleReason(
-	header: PairIndexHeaderFields,
-	expected: PairIndexCalibration
-): string | undefined {
+export function pairIndexStaleReason(header: PairIndexHeaderFields, expected: PairIndexCalibration): string | null {
 	if (header.schemaVersion !== REQUIRED_PAIR_INDEX_SCHEMA) {
 		return `schemaVersion ${header.schemaVersion} → ${REQUIRED_PAIR_INDEX_SCHEMA}`
 	}
@@ -286,7 +280,7 @@ export function pairIndexStaleReason(
 		return `parentDelta ${header.parentDelta ?? "(absent)"} → ${expected.parentDelta ?? "(absent)"}`
 	}
 
-	return undefined
+	return null
 }
 
 /**
@@ -518,15 +512,15 @@ export interface SoftFeedLink {
 export async function committedSoftFeedLinks(): Promise<{
 	anchor: SoftFeedLink
 	country: SoftFeedLink
-	streetType?: SoftFeedLink
+	streetType: SoftFeedLink | null
 }> {
 	const config = await readReleaseConfig()
 	const sources = repoCommittedSoftFeedSources(repoRootPath(), config.softFeed ?? {})
 
-	const link = (name: string, consequenceIfMissing: string): SoftFeedLink | undefined => {
+	const link = (name: string, consequenceIfMissing: string): SoftFeedLink | null => {
 		const source = sources.get(name)
 
-		return source ? { source, name, consequenceIfMissing } : undefined
+		return source ? { source, name, consequenceIfMissing } : null
 	}
 
 	const anchor = link("anchor-lexicon-v1.json", "gazetteer channel will resolve OFF in this worktree.")
@@ -540,7 +534,7 @@ export async function committedSoftFeedLinks(): Promise<{
 
 	const streetType = link("street-type-lexicon-v3.json", "the street_type channel will resolve OFF in this worktree.")
 
-	return { anchor, country, ...(streetType ? { streetType } : {}) }
+	return { anchor, country, streetType }
 }
 
 /**
@@ -631,7 +625,7 @@ export interface DevOverlayManifest {
 export interface DevOverlay {
 	destDir: PathBuilder
 	cli: PathBuilder
-	card: WeightsCard | undefined
+	card: WeightsCard | null
 }
 
 const EVIDENCE_LEXICON_SOURCES: ReadonlyArray<{
@@ -642,10 +636,23 @@ const EVIDENCE_LEXICON_SOURCES: ReadonlyArray<{
 	{ channel: "locality_surface", source: (name) => dataRootPath("gazetteer", name) },
 ]
 
-async function readWeightsCard(workspace: string): Promise<WeightsCard | undefined> {
+/**
+ * Whether the locale's workspace package declares `mailwoman.baseWeights`.
+ */
+async function declaresBaseWeights(locale: string): Promise<boolean> {
+	const path = workspacePathBuilder(`neural-weights-${locale}`, "package.json")
+
+	if (!(await pathExists(path))) return false
+
+	const { mailwoman } = await readLocalJSONFile<{ mailwoman?: { baseWeights?: unknown } }>(path)
+
+	return typeof mailwoman?.baseWeights === "string" && mailwoman.baseWeights.length > 0
+}
+
+async function readWeightsCard(workspace: string): Promise<WeightsCard | null> {
 	const path = workspacePathBuilder(workspace, "model-card.json")
 
-	if (!(await pathExists(path))) return undefined
+	if (!(await pathExists(path))) return null
 
 	return readLocalJSONFile<WeightsCard>(path)
 }
@@ -680,7 +687,7 @@ async function linkCharModel(destDir: PathBuilder, family: string): Promise<void
 	await removeIfPresent(destDir("tokenizer.model"))
 }
 
-async function linkBaseModelPair(destDir: PathBuilder, digestCard: string | undefined): Promise<void> {
+async function linkBaseModelPair(destDir: PathBuilder, digestCard: string | null): Promise<void> {
 	const recipe = await readReleaseConfig()
 
 	const dataRoot = dataRootPath()
@@ -800,11 +807,16 @@ export async function materializeDevOverlay(manifest: DevOverlayManifest): Promi
 
 	await makeDirectories(destDir)
 
-	if (manifest.model?.kind === "inherit") {
+	// A package that declares `mailwoman.baseWeights` inherits its graph whatever the manifest says,
+	// because `resolveWeights` takes the base's graph over a file in the overlay directory.
+	const inherits =
+		manifest.model?.kind === "inherit" || (!manifest.model && (await declaresBaseWeights(manifest.locale)))
+
+	if (inherits) {
 		await removeIfPresent(destDir("model.onnx"))
 		await removeIfPresent(destDir("tokenizer.model"))
 	} else if (manifest.model?.kind === "link") {
-		await linkBaseModelPair(destDir, manifest.model.digestCard)
+		await linkBaseModelPair(destDir, manifest.model.digestCard ?? null)
 	} else if (manifest.model?.kind === "char") {
 		await linkCharModel(destDir, manifest.model.family)
 	}

package/out/address/point/interpolation.d.ts

@@ -39,6 +39,7 @@ export declare class AddressPointInterpolator<DB extends AddressPointDatabase =
         database?: DatabaseClient<DB>;
         fallback?: StreetInterpolator;
     });
+    readonly radiusCalibration: null;
     find(query: InterpolationQuery): InterpolatedHit | null;
     [Symbol.dispose](): void;
 }

package/out/address/point/interpolation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interpolation.d.ts","sourceRoot":"","sources":["../../../lib/address/point/interpolation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAEnE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAEzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AACjE,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AA8B7F,qBAAa,wBAAwB,CACpC,EAAE,SAAS,oBAAoB,GAAG,oBAAoB,CACrD,YAAW,mBAAmB;;IAY/B,YAAY,IAAI,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,cAAc,CAAC,EAAE,CAAC,CAAC;QAAC,QAAQ,CAAC,EAAE,kBAAkB,CAAA;KAAE,EA2BlG;IAED,IAAI,CAAC,KAAK,EAAE,kBAAkB,GAAG,eAAe,GAAG,IAAI,CAsBtD;IAED,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAEvB;CACD"}
+{"version":3,"file":"interpolation.d.ts","sourceRoot":"","sources":["../../../lib/address/point/interpolation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAEnE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAEzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AACjE,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AA8B7F,qBAAa,wBAAwB,CACpC,EAAE,SAAS,oBAAoB,GAAG,oBAAoB,CACrD,YAAW,mBAAmB;;IAY/B,YAAY,IAAI,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,cAAc,CAAC,EAAE,CAAC,CAAC;QAAC,QAAQ,CAAC,EAAE,kBAAkB,CAAA;KAAE,EA2BlG;IAED,QAAQ,CAAC,iBAAiB,OAAO;IAEjC,IAAI,CAAC,KAAK,EAAE,kBAAkB,GAAG,eAAe,GAAG,IAAI,CAsBtD;IAED,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAEvB;CACD"}

package/out/address/point/interpolation.js

@@ -73,6 +73,7 @@ export class AddressPointInterpolator {
         }
         this.#resources = resources.move();
     }
+    radiusCalibration = null;
     find(query) {
         const numberRaw = query.number.trim();
         if (!/^\d+$/.test(numberRaw))
@@ -123,8 +124,8 @@ function interpolateFromNeighbors(rows, n) {
     const anchors = anchorsByNumber(rows);
     // Nearest known number below and above the query.
     // The rows never contain n itself.
-    let below;
-    let above;
+    let below = null;
+    let above = null;
     for (const anchor of anchors) {
         if (anchor.n < n) {
             below = anchor;
@@ -142,6 +143,7 @@ function interpolateFromNeighbors(rows, n) {
             lon: below.lon + (above.lon - below.lon) * t,
             interpolated: true,
             method: "address_point",
+            parityMatched: null,
             bracket: "both",
             uncertaintyM: Math.round(spanM / 2),
             source: below.source,
@@ -166,6 +168,7 @@ function interpolateFromNeighbors(rows, n) {
         lon,
         interpolated: true,
         method: "address_point",
+        parityMatched: null,
         bracket: "single",
         // Explicitly larger than the both-sided radius: the whole pair span plus the overshoot.
         uncertaintyM: Math.round(pairM + overshootM),

package/out/address/point/interpolation.js.map

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

package/out/address/point.d.ts

@@ -25,13 +25,14 @@ export declare class AddressPointSqliteLookup<DB extends AddressPointDatabase =
      * @param dbPath Extract path.
      * @param opts.streetLocale The street-normalization locale the extract was built with.
      * A mismatch makes every key miss.
-     * It defaults to `"us"`.
      * @param opts.localityKeys Whether the extract's `locality_norm` holds full place names.
      * With `"abbreviated"`, a row's locality can select a row but never rejects one.
      * The US situs extract uses NAD city fields.
      * Some counties abbreviate them (`addi` for Addison).
      * Other counties replace them with the parent town.
-     * It defaults to `"abbreviated"` for `"us"` and `"full"` for every other locale.
+     *
+     * @defaultValue `"us"`
+     * @defaultValue `"abbreviated"` for `"us"` and `"full"` for every other locale.
      */
     constructor(dbPath: PathBuilderLike, opts?: {
         streetLocale?: StreetLocale;
@@ -44,12 +45,12 @@ export declare class AddressPointSqliteLookup<DB extends AddressPointDatabase =
         locality?: string;
         region?: string;
         subregion?: string;
-        bbox?: {
+        bbox: {
             minLat: number;
             maxLat: number;
             minLon: number;
             maxLon: number;
-        };
+        } | null;
     }): AddressPointHit | null;
     [Symbol.dispose](): void;
 }

package/out/address/point.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"point.d.ts","sourceRoot":"","sources":["../../lib/address/point.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAEnF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE9C,OAAO,KAAK,EAAE,oBAAoB,EAAqB,MAAM,uBAAuB,CAAA;AAEpF,OAAO,EASN,KAAK,YAAY,EACjB,MAAM,mBAAmB,CAAA;AAc1B;;;;;;;;;;GAUG;AACH,qBAAa,wBAAwB,CAAC,EAAE,SAAS,oBAAoB,GAAG,oBAAoB,CAC3F,YAAW,kBAAkB,EAAE,UAAU;;IAyBzC;;;;;;;;;;;OAWG;IACH,YACC,MAAM,EAAE,eAAe,EACvB,IAAI,GAAE;QAAE,YAAY,CAAC,EAAE,YAAY,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,GAAG,aAAa,CAAA;KAAO,EAsCjF;IAED,IAAI,CAAC,KAAK,EAAE;QACX,MAAM,EAAE,MAAM,CAAA;QACd,MAAM,EAAE,MAAM,CAAA;QACd,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,IAAI,CAAC,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAA;KACzE,GAAG,eAAe,GAAG,IAAI,CAsCzB;IAyID,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAEvB;CACD"}
+{"version":3,"file":"point.d.ts","sourceRoot":"","sources":["../../lib/address/point.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAEnF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE9C,OAAO,KAAK,EAAE,oBAAoB,EAAqB,MAAM,uBAAuB,CAAA;AAEpF,OAAO,EASN,KAAK,YAAY,EACjB,MAAM,mBAAmB,CAAA;AAc1B;;;;;;;;;;GAUG;AACH,qBAAa,wBAAwB,CAAC,EAAE,SAAS,oBAAoB,GAAG,oBAAoB,CAC3F,YAAW,kBAAkB,EAAE,UAAU;;IAyBzC;;;;;;;;;;;;OAYG;IACH,YACC,MAAM,EAAE,eAAe,EACvB,IAAI,GAAE;QAAE,YAAY,CAAC,EAAE,YAAY,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,GAAG,aAAa,CAAA;KAAO,EAsCjF;IAED,IAAI,CAAC,KAAK,EAAE;QACX,MAAM,EAAE,MAAM,CAAA;QACd,MAAM,EAAE,MAAM,CAAA;QACd,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,IAAI,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAA;KAC/E,GAAG,eAAe,GAAG,IAAI,CAsCzB;IAyID,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAEvB;CACD"}

package/out/address/point.js

@@ -41,13 +41,14 @@ export class AddressPointSqliteLookup {
      * @param dbPath Extract path.
      * @param opts.streetLocale The street-normalization locale the extract was built with.
      * A mismatch makes every key miss.
-     * It defaults to `"us"`.
      * @param opts.localityKeys Whether the extract's `locality_norm` holds full place names.
      * With `"abbreviated"`, a row's locality can select a row but never rejects one.
      * The US situs extract uses NAD city fields.
      * Some counties abbreviate them (`addi` for Addison).
      * Other counties replace them with the parent town.
-     * It defaults to `"abbreviated"` for `"us"` and `"full"` for every other locale.
+     *
+     * @defaultValue `"us"`
+     * @defaultValue `"abbreviated"` for `"us"` and `"full"` for every other locale.
      */
     constructor(dbPath, opts = {}) {
         this.#db = new DatabaseClient(dbPath, { readOnly: true });
@@ -85,7 +86,7 @@ export class AddressPointSqliteLookup {
         // `streetKeyVariants` yields the literal key first.
         // Each variant runs the full number fallback sequence.
         // The first variant with a match wins.
-        let row;
+        let row = null;
         for (const streetNorm of streetKeyVariants(query.street, streetLocaleForSurface(query.street, this.#locale))) {
             row = this.#findForKey(streetNorm, number, scoped);
             if (row)
@@ -98,8 +99,8 @@ export class AddressPointSqliteLookup {
             lon: row.lon,
             source: row.source,
             release: row.release,
-            ...(row.locality_norm ? { localityNorm: row.locality_norm } : {}),
-            ...(row.postcode ? { postcode: row.postcode } : {}),
+            localityNorm: row.locality_norm || null,
+            postcode: row.postcode || null,
         };
     }
     /**
@@ -145,16 +146,16 @@ export class AddressPointSqliteLookup {
      * Each scope runs only when the previous ones missed.
      */
     #probe(streetNorm, number, query) {
-        let row;
+        let row = null;
         if (query.postcode) {
             const postcode = query.postcode.trim();
-            const localityKey = query.locality ? this.#localityKey(query.locality) : undefined;
+            const localityKey = query.locality ? this.#localityKey(query.locality) : null;
             // One postcode can cover several places with the same street and number,
             // so a row whose locality agrees with the query is tried first.
             // The postcode-only row answers only if `#scopeContradicts` accepts it.
-            const agreeing = localityKey ? this.#byPostcodeLocality(postcode, localityKey, streetNorm, number) : undefined;
+            const agreeing = localityKey ? this.#byPostcodeLocality(postcode, localityKey, streetNorm, number) : null;
             const candidate = agreeing ?? this.#byPostcode(postcode, streetNorm, number);
-            row = candidate && !this.#scopeContradicts(candidate, query) ? candidate : undefined;
+            row = candidate && !this.#scopeContradicts(candidate, query) ? candidate : null;
         }
         if (!row && query.locality) {
             row = this.#byLocality(this.#localityKey(query.locality), streetNorm, number);
@@ -168,7 +169,7 @@ export class AddressPointSqliteLookup {
             const b = query.bbox;
             const candidate = this.#byBbox(streetNorm, number, b.minLat, b.maxLat, b.minLon, b.maxLon);
             // A row with its own scope that the scoped probes missed is a different address in the same box.
-            row = candidate && !this.#scopeContradicts(candidate, query) ? candidate : undefined;
+            row = candidate && !this.#scopeContradicts(candidate, query) ? candidate : null;
         }
         return row;
     }