@mailwoman/resolver-wof-sqlite 9.4.0 → 10.1.0

package/lib/street/centroid-schema.ts

@@ -1,154 +0,0 @@
-/**
- * @copyright Sister Software
- * @license AGPL-3.0
- * @author Teffen Ellis, et al.
- *
- *   Typed schema for the DERIVED STREET-CENTROID extract (`street-centroids-<cc>.db`, built by
- *   `ban/scripts/build-street-centroid-extract.ts` — the #1042 street-level tier behind "street-only
- *   FR queries deserve a street-level answer"). The extract is a `GROUP BY street` roll-up of the
- *   sealed rooftop address-point extract: one row per (street, postcode, commune) carrying the street's
- *   CENTROID + bounding-box EXTENT + member-point count. No new data source — a derived artifact.
- *
- *   Single source of truth for the columns shared by the BUILDER (a positional prepared INSERT for
- *   throughput) and the READER ({@link StreetCentroidSqliteLookup}), so a column rename in one is a
- *   compile error in the other — the same discipline as `address-point-schema.ts`.
- *
- *   Probe scopes (most-selective first): by `postcode`, else by `locality_base` (the
- *   arrondissement-stripped commune — see `stripArrondissement`; BAN names Paris/Lyon/Marseille rows
- *   per arrondissement, but a query names the base commune). The reader WEIGHTED-aggregates across the
- *   matched rows (by `point_count`) so a locality-scope probe returns the street's grand centroid over
- *   every postcode/arrondissement it spans.
- */
-
-import type { Kysely } from "kysely"
-
-import type { NameKey, StreetKey } from "#street/normalize"
-
-/**
- * One street roll-up. `(street_norm, postcode, locality_base)` is unique. `lat`/`lon` are the UNWEIGHTED mean of the
- * group's member address points (each source row = one point), so a cross-group weighted mean (`SUM(lat*point_count) /
- * SUM(point_count)`) reconstructs the grand centroid. `min_/max_lat/lon` are the group's extent (the reader turns the
- * bbox diagonal into an honest `uncertainty_m`).
- */
-export interface StreetCentroidTable {
-	/**
-	 * Shared `normalizeStreetForKeyLocale` of the street — the build/query-consistent probe key.
-	 */
-	street_norm: StreetKey
-	/**
-	 * The 5-digit postcode of this group, or null when the source row carried none.
-	 */
-	postcode: string | null
-	/**
-	 * Arrondissement-stripped commune (`stripArrondissement(normalizeLocalityForKey(commune))`) — the fallback scope.
-	 */
-	locality_base: NameKey
-	/**
-	 * Weighted-mean centroid latitude of the street's member points.
-	 */
-	lat: number
-	/**
-	 * Weighted-mean centroid longitude of the street's member points.
-	 */
-	lon: number
-	min_lat: number
-	max_lat: number
-	min_lon: number
-	max_lon: number
-	/**
-	 * Member address-point count — the weight for a cross-group centroid aggregate.
-	 */
-	point_count: number
-	/**
-	 * A representative street name as it appeared in the source (display / debugging).
-	 */
-	street_raw: string
-	/**
-	 * Provenance: the register this street was derived from (e.g. `ban:fr`).
-	 */
-	source: string
-	/**
-	 * The pinned data release the underlying points came from.
-	 */
-	release: string
-	/**
-	 * #727 phase-4c: `foldStreetSurface(street_raw)` — the contract-fold street-NAME existence key for
-	 * {@link StreetLocalityEvidence}. Distinct from `street_norm` (the `street-normalize` geocoding key): the
-	 * name-evidence rerank folds the model's street surface with the SAME `foldStreetSurface` used to build this column
-	 * (the fold-parity contract), so it must not drift from `street_norm`'s richer normalizer. Indexed (`idx_sc_name`)
-	 * for a direct seek.
-	 *
-	 * Deliberately UNBRANDED despite the `name_key` column name: `foldStreetSurface` is a different fold from the
-	 * {@link NameKey} one every other `name_key` column carries, and giving it that brand would invite exactly the
-	 * cross-fold probe the brands exist to stop.
-	 */
-	name_key: string
-}
-
-/**
- * The street-centroid database schema for `new DatabaseClient<StreetCentroidDatabase>(...)`.
- */
-export interface StreetCentroidDatabase {
-	street_centroid: StreetCentroidTable
-}
-
-/**
- * The `street_centroid` columns in INSERT order. The builder's positional prepared statement derives its placeholder
- * list from this, so the positional order can't drift from the DDL / the reader.
- */
-export const STREET_CENTROID_COLUMNS = [
-	"street_norm",
-	"postcode",
-	"locality_base",
-	"lat",
-	"lon",
-	"min_lat",
-	"max_lat",
-	"min_lon",
-	"max_lon",
-	"point_count",
-	"street_raw",
-	"source",
-	"release",
-	"name_key",
-] as const
-
-/**
- * Create the `street_centroid` table — called before the streaming bulk load.
- */
-export async function createStreetCentroidTable(db: Kysely<StreetCentroidDatabase>): Promise<void> {
-	await db.schema
-		.createTable("street_centroid")
-		.addColumn("street_norm", "text", (c) => c.notNull())
-		.addColumn("postcode", "text")
-		.addColumn("locality_base", "text", (c) => c.notNull())
-		.addColumn("lat", "real", (c) => c.notNull())
-		.addColumn("lon", "real", (c) => c.notNull())
-		.addColumn("min_lat", "real", (c) => c.notNull())
-		.addColumn("max_lat", "real", (c) => c.notNull())
-		.addColumn("min_lon", "real", (c) => c.notNull())
-		.addColumn("max_lon", "real", (c) => c.notNull())
-		.addColumn("point_count", "integer", (c) => c.notNull())
-		.addColumn("street_raw", "text", (c) => c.notNull())
-		.addColumn("source", "text", (c) => c.notNull())
-		.addColumn("release", "text", (c) => c.notNull())
-		.addColumn("name_key", "text", (c) => c.notNull())
-		.execute()
-}
-
-/**
- * Create the probe indexes: the two geocoding-scope indexes (postcode, locality-base) the resolver reader relies on,
- * plus `idx_sc_name` — the #727 phase-4c name-existence key for a direct `name_key = ?` seek (the unscoped fragment
- * lookup; without it that query skip-scans `idx_sc_postcode` at ~5 ms/probe).
- */
-export async function createStreetCentroidIndexes(db: Kysely<StreetCentroidDatabase>): Promise<void> {
-	await db.schema.createIndex("idx_sc_postcode").on("street_centroid").columns(["postcode", "street_norm"]).execute()
-
-	await db.schema
-		.createIndex("idx_sc_locality")
-		.on("street_centroid")
-		.columns(["locality_base", "street_norm"])
-		.execute()
-
-	await db.schema.createIndex("idx_sc_name").on("street_centroid").columns(["name_key"]).execute()
-}

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../lib/address/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,gBAAgB,CAAA;AAC9B,cAAc,8BAA8B,CAAA;AAC5C,cAAc,uBAAuB,CAAA"}

package/out/address/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../lib/address/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,gBAAgB,CAAA;AAC9B,cAAc,8BAA8B,CAAA;AAC5C,cAAc,uBAAuB,CAAA"}

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

@@ -1,49 +0,0 @@
-/**
- * @copyright Sister Software
- * @license AGPL-3.0
- * @author Teffen Ellis, et al.
- *
- *   Address-point interpolation — "Method 2" of the resolution ladder (#483, Phase 1 of
- *   `docs/articles/plan/2026-06-11-resolution-ladder.md`): when the exact address-point tier (#476)
- *   misses a house number, bracket the number with REAL neighbor points on the same street from the
- *   same #476 extract and interpolate linearly in house-number space between them. Real occupancy
- *   replaces TIGER's uniform-spacing assumption — the dominant error term of the TIGER pilot's check
- *   miss; TIGER range interpolation (`StreetInterpolator`) demotes to the fallback for streets too
- *   sparse to bracket.
- *
- *   Matching key is `street_key` — THE shared normalizer plus the route fold
- *   (`canonicalizeRouteKey`), identical at build time (`scripts/build-address-point-extract.ts`) and
- *   query time, by construction. Scope is postcode-first like the segment tier; a query without a
- *   postcode goes straight to the fallback (which carries its own statewide-ambiguity abstention).
- *
- *   Bracketing contract:
- *
- *   - Neighbor candidates NEVER include the queried number itself (any unit/duplicate row of it) — in
- *       production the exact tier would already have answered an on-file number, and in the eval
- *       this is what makes grading against the same extract non-circular by construction.
- *   - Both-sided bracket (`bracket: "both"`): linear interpolation between the nearest known number
- *       below and above; `uncertaintyM` = half the distance between them.
- *   - Single-sided (`bracket: "single"`): linear extrapolation along the two nearest known numbers on
- *       that side, capped at one pair-span beyond the nearest point (`t ≤ 2` — beyond that the line
- *       carries no evidence and the query falls through); `uncertaintyM` = the pair distance plus
- *       the extrapolated overshoot, explicitly larger than the both-sided radius.
- *   - No bracket (no neighbors, a single known number, or past the extrapolation cap): fall through to
- *       the TIGER fallback when configured, else null.
- *
- *   Standalone like the segment tier — core wiring rides the Phase 2 ordered `spatialTiers` list.
- */
-import type { InterpolationLookup } from "@mailwoman/core/resolver";
-import { DatabaseClient } from "@mailwoman/sqlite/client";
-import type { AddressPointDatabase } from "#address/point-schema";
-import type { InterpolatedHit, InterpolationQuery, StreetInterpolator } from "#interpolation";
-export declare class AddressPointInterpolator<DB extends AddressPointDatabase = AddressPointDatabase> implements InterpolationLookup {
-    #private;
-    constructor(opts: {
-        dbPath?: string;
-        database?: DatabaseClient<DB>;
-        fallback?: StreetInterpolator;
-    });
-    find(query: InterpolationQuery): InterpolatedHit | null;
-    [Symbol.dispose](): void;
-}
-//# sourceMappingURL=point-interpolation.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"point-interpolation.d.ts","sourceRoot":"","sources":["../../lib/address/point-interpolation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;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;AA4B7F,qBAAa,wBAAwB,CACpC,EAAE,SAAS,oBAAoB,GAAG,oBAAoB,CACrD,YAAW,mBAAmB;;gBAUnB,IAAI,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,cAAc,CAAC,EAAE,CAAC,CAAC;QAAC,QAAQ,CAAC,EAAE,kBAAkB,CAAA;KAAE;IA2BnG,IAAI,CAAC,KAAK,EAAE,kBAAkB,GAAG,eAAe,GAAG,IAAI;IAyBvD,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;CAGxB"}

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

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

package/out/address/point-schema.d.ts

@@ -1,97 +0,0 @@
-/**
- * @copyright Sister Software
- * @license AGPL-3.0
- * @author Teffen Ellis, et al.
- *
- *   Typed schema for the SITUS / rooftop ADDRESS-POINT extracts (`address-points-<cc>-<slug>.db`, built
- *   by `scripts/build-address-point-extract.ts` — the #476/#567 national rooftop tier behind the
- *   demo's "type any US address, get the building"). Single source of truth for the columns shared
- *   by the BUILDER and the READER ({@link AddressPointSqliteLookup}), so a column rename in one is a
- *   compile error in the other.
- *
- *   The builder's hot INSERT (tens of millions of rows per state) stays a POSITIONAL prepared
- *   statement for throughput — but its column list is derived from {@link ADDRESS_POINT_COLUMNS}
- *   here, and its table comes from {@link createAddressPointTable}, so the positional order can't
- *   silently drift from what the reader expects. (Same convention as the candidate build: typed
- *   schema guards the contract; positional inserts keep the speed.)
- */
-import type { Kysely } from "kysely";
-import type { NameKey, RouteKey, StreetKey } from "#street/normalize";
-/**
- * One rooftop address point. `(street_norm, number)` within a `postcode` (preferred) or `locality_norm` scope is the
- * lookup; `street_key` is the #483 route-fold key for interpolation. Coordinates are non-null (the builder drops
- * non-finite coords). `unit`/`postcode`/`locality_norm` are nullable (not every source carries all three).
- */
-export interface AddressPointTable {
-    /**
-     * Shared {@link normalizeStreetForKey} of the street — the build/query-consistent probe key.
-     */
-    street_norm: StreetKey;
-    /**
-     * `canonicalizeRouteKey(street_norm)` — the route-fold key (#483 Method 2). Its own brand, so it cannot be
-     * interchanged with the plain `street_norm` above.
-     */
-    street_key: RouteKey;
-    /**
-     * House number, normalized lower-case (kept TEXT — "123-A", "12 1/2" must survive).
-     */
-    number: string;
-    unit: string | null;
-    postcode: string | null;
-    /**
-     * Shared {@link normalizeLocalityForKey} of the locality — the fallback scope.
-     */
-    locality_norm: NameKey | null;
-    /**
-     * The street as it appeared in the source (kept for display / debugging).
-     */
-    street_raw: string;
-    lat: number;
-    lon: number;
-    /**
-     * Provenance: the dataset this point came from (e.g. `overture:us`, `openaddresses`).
-     */
-    source: string;
-    /**
-     * The pinned data release the point was ingested from.
-     */
-    release: string;
-    /**
-     * The source register's stable administrative key for the point's commune or municipality — BAN's `code_insee`. A
-     * display name (`locality_norm`) is not a key; the coverage basis is computed per THIS.
-     */
-    admin_code: string | null;
-    /**
-     * The register's own certification flag for the point (BAN `certification_commune`: 1 certified by the commune, 0
-     * not), or null for a source that states none. A basis is never inferred from a share of these.
-     */
-    certified: number | null;
-}
-/**
- * The address-point database schema for `new DatabaseClient<AddressPointDatabase>(...)`.
- */
-export interface AddressPointDatabase {
-    address_point: AddressPointTable;
-}
-/**
- * The slice of a Kysely handle the `address_point` DDL touches — the parameter type its builders take.
- *
- * Kysely is invariant in its schema parameter (the incompatibility is in `transaction()`), so a extract that EXTENDS
- * `AddressPointTable` — OSM adds `h3_cell` — cannot pass its own handle to a `Kysely<AddressPointDatabase>` parameter.
- * Naming only `schema` lets it, and the DDL below needs nothing else.
- */
-export type AddressPointSchemaHandle = Pick<Kysely<AddressPointDatabase>, "schema">;
-/**
- * The `address_point` columns in INSERT order. The builder's positional prepared statement derives its placeholder list
- * from this, so the positional order can't drift from the DDL / the reader.
- */
-export declare const ADDRESS_POINT_COLUMNS: readonly ["street_norm", "street_key", "number", "unit", "postcode", "locality_norm", "street_raw", "lat", "lon", "source", "release", "admin_code", "certified"];
-/**
- * Create the `address_point` table — called before the streaming bulk load.
- */
-export declare function createAddressPointTable(db: AddressPointSchemaHandle): Promise<void>;
-/**
- * Create the three probe indexes the reader relies on (postcode-scope, locality-scope, route-key).
- */
-export declare function createAddressPointIndexes(db: AddressPointSchemaHandle): Promise<void>;
-//# sourceMappingURL=point-schema.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"point-schema.d.ts","sourceRoot":"","sources":["../../lib/address/point-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAEpC,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAErE;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IACjC;;OAEG;IACH,WAAW,EAAE,SAAS,CAAA;IACtB;;;OAGG;IACH,UAAU,EAAE,QAAQ,CAAA;IACpB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB;;OAEG;IACH,aAAa,EAAE,OAAO,GAAG,IAAI,CAAA;IAC7B;;OAEG;IACH,UAAU,EAAE,MAAM,CAAA;IAClB,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;IACd;;OAEG;IACH,OAAO,EAAE,MAAM,CAAA;IACf;;;OAGG;IACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB;;;OAGG;IACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC,aAAa,EAAE,iBAAiB,CAAA;CAChC;AAED;;;;;;GAMG;AACH,MAAM,MAAM,wBAAwB,GAAG,IAAI,CAAC,MAAM,CAAC,oBAAoB,CAAC,EAAE,QAAQ,CAAC,CAAA;AAEnF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,mKAcxB,CAAA;AAEV;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,EAAE,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBzF;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAAC,EAAE,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmB3F"}

package/out/address/point-schema.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"point-schema.js","sourceRoot":"","sources":["../../lib/address/point-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAyEH;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACpC,aAAa;IACb,YAAY;IACZ,QAAQ;IACR,MAAM;IACN,UAAU;IACV,eAAe;IACf,YAAY;IACZ,KAAK;IACL,KAAK;IACL,QAAQ;IACR,SAAS;IACT,YAAY;IACZ,WAAW;CACF,CAAA;AAEV;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,EAA4B;IACzE,MAAM,EAAE,CAAC,MAAM;SACb,WAAW,CAAC,eAAe,CAAC;SAC5B,SAAS,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QACrD,wFAAwF;SACvF,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SACnD,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SAC/C,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;SACzB,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC;SAC7B,SAAS,CAAC,eAAe,EAAE,MAAM,CAAC;SAClC,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SACnD,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SAC5C,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SAC5C,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SAC/C,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SAChD,SAAS,CAAC,YAAY,EAAE,MAAM,CAAC;SAC/B,SAAS,CAAC,WAAW,EAAE,SAAS,CAAC;SACjC,OAAO,EAAE,CAAA;AACZ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,EAA4B;IAC3E,MAAM,EAAE,CAAC,MAAM;SACb,WAAW,CAAC,iBAAiB,CAAC;SAC9B,EAAE,CAAC,eAAe,CAAC;SACnB,OAAO,CAAC,CAAC,UAAU,EAAE,aAAa,EAAE,QAAQ,CAAC,CAAC;SAC9C,OAAO,EAAE,CAAA;IAEX,MAAM,EAAE,CAAC,MAAM;SACb,WAAW,CAAC,iBAAiB,CAAC;SAC9B,EAAE,CAAC,eAAe,CAAC;SACnB,OAAO,CAAC,CAAC,eAAe,EAAE,aAAa,EAAE,QAAQ,CAAC,CAAC;SACnD,OAAO,EAAE,CAAA;IAEX,MAAM,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC,EAAE,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC,OAAO,EAAE,CAAA;IACjH,oGAAoG;IACpG,uGAAuG;IACvG,wGAAwG;IACxG,yEAAyE;IACzE,MAAM,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC,EAAE,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,CAAA;AAC9G,CAAC"}

package/out/ancestry/index.d.ts

@@ -1,45 +0,0 @@
-/**
- * @copyright Sister Software
- * @license AGPL-3.0
- * @author Teffen Ellis, et al.
- *
- *   The shared ancestor-lineage walk over the WOF `ancestors` table — one place's containment chain
- *   joined with `spr` for canonical names + centroids, ordered NEAREST-FIRST (deepest placetype
- *   first, country last).
- *
- *   Factored out of `WOFSQLitePlaceLookup.ancestors()` (#404) so the reverse geocoder (`reverse.ts`,
- *   #484) reuses the SAME walk instead of growing a second one. The placetype-specificity ordering
- *   lives here as `PLACETYPE_DEPTH` — a single TS map instead of the previous SQL CASE, and
- *   extended below `localadmin` (locality/borough/neighbourhood/microhood now rank correctly
- *   instead of sorting last; forward resolution rarely saw those as ANCESTOR placetypes, reverse
- *   geocoding always does).
- */
-import type { DatabaseClient } from "@mailwoman/sqlite/client";
-/**
- * WOF placetype → containment depth, coarsest = 1. Higher = finer. Placetypes we never resolve (continent, empire, …)
- * map to 0 and sort last. NOT the same table as the FST's `PLACETYPE_ORDER` (fst-serialize.ts) — that one is a
- * serialization order, this one is containment depth.
- */
-export declare const PLACETYPE_DEPTH: Readonly<Record<string, number>>;
-/**
- * Containment depth for a placetype — 0 (sorts coarsest) when unknown.
- */
-export declare function placetypeDepth(placetype: string): number;
-/**
- * One ancestor row, enriched with the `spr` columns both consumers need.
- */
-export interface AncestorPlaceRow {
-    id: number;
-    placetype: string;
-    name: string;
-    country: string;
-    lat: number;
-    lon: number;
-}
-/**
- * The ancestor lineage of `id` — self excluded, nearest-first. Returns `[]` when the place has no recorded ancestry.
- * NOT memoized here; `WOFSQLitePlaceLookup` keeps its own per-id cache.
- */
-export declare function ancestorLineage<DB>(db: DatabaseClient<DB>, id: number, schemaName?: string): AncestorPlaceRow[];
-export * from "#ancestry/backfill";
-//# sourceMappingURL=index.d.ts.map

package/out/ancestry/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../lib/ancestry/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAE9D;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAY5D,CAAA;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;CACX;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,EAAE,EAAE,cAAc,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,SAAS,GAAG,gBAAgB,EAAE,CAc/G;AAED,cAAc,oBAAoB,CAAA"}

package/out/ancestry/index.js

@@ -1,55 +0,0 @@
-/**
- * @copyright Sister Software
- * @license AGPL-3.0
- * @author Teffen Ellis, et al.
- *
- *   The shared ancestor-lineage walk over the WOF `ancestors` table — one place's containment chain
- *   joined with `spr` for canonical names + centroids, ordered NEAREST-FIRST (deepest placetype
- *   first, country last).
- *
- *   Factored out of `WOFSQLitePlaceLookup.ancestors()` (#404) so the reverse geocoder (`reverse.ts`,
- *   #484) reuses the SAME walk instead of growing a second one. The placetype-specificity ordering
- *   lives here as `PLACETYPE_DEPTH` — a single TS map instead of the previous SQL CASE, and
- *   extended below `localadmin` (locality/borough/neighbourhood/microhood now rank correctly
- *   instead of sorting last; forward resolution rarely saw those as ANCESTOR placetypes, reverse
- *   geocoding always does).
- */
-import { allRows } from "@mailwoman/core/utils";
-/**
- * WOF placetype → containment depth, coarsest = 1. Higher = finer. Placetypes we never resolve (continent, empire, …)
- * map to 0 and sort last. NOT the same table as the FST's `PLACETYPE_ORDER` (fst-serialize.ts) — that one is a
- * serialization order, this one is containment depth.
- */
-export const PLACETYPE_DEPTH = {
-    country: 1,
-    macroregion: 2,
-    region: 3,
-    macrocounty: 4,
-    county: 5,
-    localadmin: 6,
-    locality: 7,
-    borough: 8,
-    macrohood: 9,
-    neighbourhood: 10,
-    microhood: 11,
-};
-/**
- * Containment depth for a placetype — 0 (sorts coarsest) when unknown.
- */
-export function placetypeDepth(placetype) {
-    return PLACETYPE_DEPTH[placetype] ?? 0;
-}
-/**
- * The ancestor lineage of `id` — self excluded, nearest-first. Returns `[]` when the place has no recorded ancestry.
- * NOT memoized here; `WOFSQLitePlaceLookup` keeps its own per-id cache.
- */
-export function ancestorLineage(db, id, schemaName = "main") {
-    const rows = allRows(db.prepare(`SELECT a.ancestor_id AS id, a.ancestor_placetype AS placetype, s.name AS name,
-				s.country AS country, s.latitude AS lat, s.longitude AS lon
-			FROM ${schemaName}.ancestors a JOIN ${schemaName}.spr s ON s.id = a.ancestor_id
-			WHERE a.id = ? AND a.ancestor_id != a.id`), id);
-    rows.sort((a, b) => placetypeDepth(b.placetype) - placetypeDepth(a.placetype));
-    return rows;
-}
-export * from "#ancestry/backfill";
-//# sourceMappingURL=index.js.map

package/out/ancestry/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../lib/ancestry/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAA;AAG/C;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAqC;IAChE,OAAO,EAAE,CAAC;IACV,WAAW,EAAE,CAAC;IACd,MAAM,EAAE,CAAC;IACT,WAAW,EAAE,CAAC;IACd,MAAM,EAAE,CAAC;IACT,UAAU,EAAE,CAAC;IACb,QAAQ,EAAE,CAAC;IACX,OAAO,EAAE,CAAC;IACV,SAAS,EAAE,CAAC;IACZ,aAAa,EAAE,EAAE;IACjB,SAAS,EAAE,EAAE;CACb,CAAA;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC/C,OAAO,eAAe,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;AACvC,CAAC;AAcD;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAK,EAAsB,EAAE,EAAU,EAAE,UAAU,GAAG,MAAM;IAC1F,MAAM,IAAI,GAAG,OAAO,CACnB,EAAE,CAAC,OAAO,CACT;;UAEO,UAAU,qBAAqB,UAAU;4CACP,CACzC,EACD,EAAE,CACF,CAAA;IAED,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAA;IAE9E,OAAO,IAAI,CAAA;AACZ,CAAC;AAED,cAAc,oBAAoB,CAAA"}

package/out/build-candidate.d.ts

@@ -1,184 +0,0 @@
-/**
- * @copyright Sister Software
- * @license AGPL-3.0
- * @author Teffen Ellis, et al.
- *
- *   Build the global "candidate" lookup DB from a unified admin WOF DB — the byte-range-optimal
- *   gazetteer the browser demo resolves against. Instead of FTS5 (whose postings for a common name
- *   scatter across a multi-GB file → hundreds of serial range fetches), this materializes one
- *   `WITHOUT ROWID` B-tree keyed `(name_key, country_id, region_id, placetype_id, neg_rank,
- *   spr_id)`: every place's normalized name + distinct aliases + region abbreviations become rows,
- *   population rank is precomputed into `neg_rank`, and the rows are bulk-loaded PRE-SORTED so a
- *   resolve is one contiguous B-tree probe (a handful of pages → 1-2 chunk fetches, regardless of
- *   global volume).
- *
- *   Each row is DENORMALIZED — it carries the place's display `name`, centroid (`latitude`/
- *   `longitude`), and `min/max` bbox — so a resolve is one statement, no FTS, no join to spr:
- *   SELECT spr_id, name, latitude, longitude, min_lat, ... FROM candidate WHERE name_key = ? AND
- *   country_id = ? AND placetype_id IN (...) [AND latitude BETWEEN ...] ORDER BY neg_rank ASC LIMIT
- *   K; The demo cascade resolves a parsed region first (its bbox), then constrains the locality to
- *   that bbox; `region_id` (the place's region-tier ancestor) is also carried for a future region
- *   2-step.
- *
- *   The name_key normalizer is the SHARED {@link normalizeLocalityForKey} — the query side (the demo
- *   resolver {@link WOFCandidateTableLookup}) MUST use the same function, the one-normalizer
- *   discipline the address-point extract uses, so build/query stay consistent by construction.
- *
- *   Measured (2026-06-20, vs the 2.6 GB full-DB FTS): ~5 M rows; ~12 range fetches per 8-query
- *   session (the full DB needs 243); US locality 96.8% (region bbox), EU coord parity 88.6%.
- *
- *   #28 adds one more denormalized field, `importance` — the toponym-fame prior that decides a BARE
- *   city name, joined in from a separate score source by name rather than by id (see
- *   `candidate-importance.ts`, which owns that join and explains why the id would be wrong). It is
- *   optional: without {@link BuildCandidateOptions.importance} the column is NULL on every row, which
- *   the consumer reads as unmeasured and ignores.
- *
- *   The build also materializes the ANCESTORS SIDECAR (`candidate_ancestor` closure rows +
- *   `candidate_interval` pre/post labels) from the source `ancestors` table — the containment
- *   lineage behind {@link WOFCandidateTableLookup.ancestors} and the admin-coherence check.
- *   `candidate-ancestors-schema.ts` owns the encoding decision and the DAG/absence semantics.
- */
-import type { CapitalPoint } from "#capitals";
-export { stageCountryDisplayNames } from "#candidate/country-display-names";
-export { GLOSS_EXCLUDED_PLACETYPES, GLOSS_KEY_THRESHOLD } from "#candidate/name-roles";
-export type { PlaceAttrs } from "#candidate/place-attrs";
-export interface BuildCandidateOptions {
-    /**
-     * Source unified admin DB — needs spr, place_population, place_search, place_abbr, ancestors.
-     */
-    input: string;
-    /**
-     * Output candidate DB path (overwritten if present).
-     */
-    output: string;
-    /**
-     * The capital-status reference entries (#1880) to carry in-artifact — the parsed `data/gazetteer/capitals-v1.json`
-     * entries, passed by the CALLER because this module publishes to npm and must not read repo-root paths. Absent → the
-     * `capital` table is not created, and the session loader falls back to the repo file where one exists.
-     */
-    capitals?: readonly CapitalPoint[];
-    /**
-     * Optional postcode extracts (`spr` rows with `placetype='postalcode'` + real coords, e.g. postalcode-us.db) — folded
-     * in as `postalcode` candidate rows so `findPlace(postalcode)` resolves a ZIP directly (the demo's primary postcode
-     * path; the postcode-*.bin anchor stays the fallback). Matches the slim wof-hot.db, which took one such postcode DB.
-     *
-     * Each extract's `names` table is folded in too (#1495) — that's where the GeoNames delivery-city names live
-     * ("Brooklyn" for 11201), and they were previously reachable only through FTS.
-     */
-    postcodes?: string[];
-    /**
-     * Optional LOCALITY extracts (`spr` rows with `placetype='locality'` + real coords, e.g. localities-nz-linz.db — the
-     * #1564 NZ suburb tier) — folded through the same extract loop as the postcode extracts, staged as `locality`
-     * candidate rows with UNMEASURED population (`neg_rank 0`: a extract row ranks behind any populated namesake and wins
-     * only where its key is the answer). Each extract's `names` table folds as aliases, `is_primary = 0`, same as the
-     * delivery-city pass. An extract whose `ancestors` table names an admin region for a row gives that row the region's
-     * scope (`region_id`) plus closure rows for the region and the region's own chain above it; an extract without one
-     * stays unscoped, as before.
-     */
-    localities?: string[];
-    /**
-     * Optional WOF admin database carrying a `place_importance` table — the source of the `importance` column (#28), the
-     * toponym-fame prior that decides the bare-city-name class. Joined by `(name_key, country, placetype)` + nearest
-     * centroid, NOT by id; see `candidate-importance.ts` for why the id join silently drops the foreign homonyms the
-     * prior exists to demote.
-     *
-     * Omit it and every row's `importance` is NULL — unmeasured, which is what the consumer's positive-evidence-only rule
-     * already treats as "do not participate", so the artifact is byte-identical to a pre-#28 build except for the empty
-     * column. That is the honest degradation and it is the DEFAULT: a caller with no score source must not get a
-     * population-derived stand-in written into a column that means fame.
-     */
-    importance?: string;
-    /**
-     * Cross-source currency backfill (#1737). WOF carries deprecated-with-no-successor records for real, populated
-     * settlements (Rochester Kent, Aldershot, Telford — 120 GB localities alone), and the currency filter correctly drops
-     * them, leaving holes no ranking can fill. When this option is set, pass 1c resurrects a dead locality ONLY under
-     * three conditions, positive evidence throughout: no live same-name row of any placetype near the dead record (a
-     * distant same-name row is a NAMESAKE and does not block — Rochester, Northumberland pop 318 must not veto Rochester,
-     * Kent); an independent GeoNames P-class attestation of the same folded name within
-     * {@link CURRENCY_BACKFILL_RADIUS_KM}; and the attestor at or above {@link CURRENCY_BACKFILL_POP_FLOOR}. The staged
-     * row keeps the real WOF id, name, centroid and bbox — GeoNames only ATTESTS the place and supplies the population
-     * that lets it stand in prominence races. `countries` are judged only where `<cc>.txt` exists under `geonamesDir`;
-     * absent dumps are skipped loudly.
-     */
-    currencyBackfill?: {
-        geonamesDir: string;
-        countries: readonly string[];
-        /**
-         * The dead placetypes the resurrection judges; `resurrectCurrencyHoles`'s default (`locality`) when absent. The
-         * `localadmin` widening #1746 named is admitted here once its census is read.
-         */
-        deadPlacetypes?: readonly string[];
-    };
-    /**
-     * Optional progress callback for CLI / test introspection.
-     */
-    onProgress?: (phase: string, message: string) => void;
-    /**
-     * Key-count threshold for the gloss anomaly detector — {@link GLOSS_KEY_THRESHOLD} unless a test passes a
-     * fixture-scale value. The production number is the #1730 sweep's own threshold (4,000 places at >= 50 keys).
-     */
-    glossKeyThreshold?: number;
-}
-export interface BuildCandidateResult {
-    rows: number;
-    places: number;
-    primaries: number;
-    aliases: number;
-    abbrevs: number;
-    postcodes: number;
-    /**
-     * Delivery-city (and other `names`-table) aliases folded onto postcode rows — #1495. Zero here means the extracts
-     * carried no alias names, NOT that the pass was skipped: a extract with no `names` table reports that separately
-     * through `onProgress`.
-     */
-    postcodeAliases: number;
-    /**
-     * Closure rows in the `candidate_ancestor` sidecar (see candidate-ancestors-schema.ts). Zero means the source
-     * `ancestors` table contributed nothing within the resolvable placetypes — a finding, reported rather than implied.
-     */
-    ancestorRows: number;
-    /**
-     * Places carrying at least one closure row.
-     */
-    ancestorPlaces: number;
-    /**
-     * Places that received a pre/post interval label — the canonical-parent forest's node count. Places outside it (no
-     * recorded ancestry, extract rows, cycle-skipped) have NO label: containment against them is unverifiable, never
-     * false.
-     */
-    intervalPlaces: number;
-    /**
-     * Places that took an `importance` score from the join (#28).
-     *
-     * `undefined` and `0` mean different things. `undefined` is "the pass did not run" — no score source was given. A `0`
-     * would be the source matching NOTHING, which is a finding. Never collapse the two.
-     */
-    importanceScored?: number;
-    /**
-     * Places whose `(name_key, country, placetype)` matched a scored group but whose nearest scored centroid was outside
-     * {@link IMPORTANCE_JOIN_RADIUS_KM} — a different town wearing the same name, refused rather than scored.
-     *
-     * Worth watching across rebuilds: a jump here means the score source and the admin source have drifted apart, and the
-     * join is being asked to guess.
-     */
-    importanceFiltered?: number;
-    /**
-     * Alias rows stamped `name_role = 'gloss'` — the anomaly detector's certain core (#1730).
-     */
-    roleGloss: number;
-    /**
-     * Alias rows stamped `name_role = 'abbr'` — the variant-in-official-language provenance signal (#1730/#936).
-     */
-    roleAbbr: number;
-    /**
-     * Admin places whose staged key count reached {@link GLOSS_KEY_THRESHOLD} — the sweep's tail, reported so the stamped
-     * fraction has its denominator.
-     */
-    keyTailPlaces: number;
-    /**
-     * Of {@link BuildCandidateResult.keyTailPlaces}, how many carry at least one stamped role row.
-     */
-    keyTailWithRole: number;
-}
-export declare function buildCandidateTable(opts: BuildCandidateOptions): Promise<BuildCandidateResult>;
-//# sourceMappingURL=build-candidate.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"build-candidate.d.ts","sourceRoot":"","sources":["../lib/build-candidate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAsBH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAO7C,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAA;AAC3E,OAAO,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AACtF,YAAY,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAExD,MAAM,WAAW,qBAAqB;IACrC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAA;IACb;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;IACd;;;;OAIG;IACH,QAAQ,CAAC,EAAE,SAAS,YAAY,EAAE,CAAA;IAClC;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB;;;;;;;;;;OAUG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;;;;;;;;;OAWG;IACH,gBAAgB,CAAC,EAAE;QAClB,WAAW,EAAE,MAAM,CAAA;QACnB,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;QAC5B;;;WAGG;QACH,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;KAClC,CAAA;IACD;;OAEG;IACH,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IACrD;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACpC,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB;;;;OAIG;IACH,eAAe,EAAE,MAAM,CAAA;IACvB;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAA;IACpB;;OAEG;IACH,cAAc,EAAE,MAAM,CAAA;IACtB;;;;OAIG;IACH,cAAc,EAAE,MAAM,CAAA;IACtB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAA;IACjB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAA;IACrB;;OAEG;IACH,eAAe,EAAE,MAAM,CAAA;CACvB;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAmapG"}