@mailwoman/resolver-wof-sqlite 4.16.2 → 5.0.0

package/out/postal-city-alias-lookup.d.ts

@@ -5,7 +5,7 @@
  *
  *   Node reader over the POSTAL-CITY ALIAS table (`postal-city-alias-<cc>.db`) — the observed
  *   `postal_city → geo_locality` aliases per postcode (`build-postal-city-alias.ts`). Consumed by
- *   {@link WofSqlitePlaceLookup}'s coordinate-first locality scorer: a user-typed postal city
+ *   {@link WOFSqlitePlaceLookup}'s coordinate-first locality scorer: a user-typed postal city
  *   ("Antioch", postcode 37013) becomes a name-match alias for the geographic locality the postcode
  *   actually sits in ("Nashville"), so the right place tiers to the top instead of a same-named
  *   town in another state. Opt-in — the lookup is only constructed when a path is supplied, and
@@ -16,7 +16,7 @@
  *   uses), keeping one normalizer in one place.
  */
 import { DatabaseSync } from "node:sqlite";
-export interface WofPostalCityAliasLookupOpts {
+export interface WOFPostalCityAliasLookupOpts {
     /** Path to a `postal-city-alias-<cc>.db` built by `build-postal-city-alias.ts`. Opened read-only. */
     databasePath?: string;
     /** Pre-opened handle (tests / shared connections). Mutually exclusive with `databasePath`. */
@@ -32,17 +32,16 @@ export interface PostalCityAlias {
     n: number;
 }
 /**
- * Reader over `postal_city_alias`. The only query is a postcode-scoped probe for DIVERGENT rows
- * (where the postal name differs from the geographic name — the rows that carry alias signal),
- * issued via the typed Kysely query builder against {@link PostalCityAliasDatabase}.
+ * Reader over `postal_city_alias`. The only query is a postcode-scoped probe for DIVERGENT rows (where the postal name
+ * differs from the geographic name — the rows that carry alias signal), issued via the typed Kysely query builder
+ * against {@link PostalCityAliasDatabase}.
  */
-export declare class WofPostalCityAliasLookup {
+export declare class WOFPostalCityAliasLookup {
     #private;
-    constructor(opts: WofPostalCityAliasLookupOpts);
+    constructor(opts: WOFPostalCityAliasLookupOpts);
     /**
-     * Divergent postal-city aliases for a postcode (empty when the postcode isn't in the table). The
-     * scorer groups these by normalized `geoLocality` and appends the `postalCity` surfaces to the
-     * matching candidate locality's alias set.
+     * Divergent postal-city aliases for a postcode (empty when the postcode isn't in the table). The scorer groups these
+     * by normalized `geoLocality` and appends the `postalCity` surfaces to the matching candidate locality's alias set.
      */
     getDivergentAliases(postcode: string): Promise<PostalCityAlias[]>;
     close(): void;

package/out/postal-city-alias-lookup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"postal-city-alias-lookup.d.ts","sourceRoot":"","sources":["../postal-city-alias-lookup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAG1C,MAAM,WAAW,4BAA4B;IAC5C,qGAAqG;IACrG,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,8FAA8F;IAC9F,QAAQ,CAAC,EAAE,YAAY,CAAA;CACvB;AAED,+FAA+F;AAC/F,MAAM,WAAW,eAAe;IAC/B,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAA;IAClB,4FAA4F;IAC5F,WAAW,EAAE,MAAM,CAAA;IACnB,kDAAkD;IAClD,CAAC,EAAE,MAAM,CAAA;CACT;AAED;;;;GAIG;AACH,qBAAa,wBAAwB;;gBAKxB,IAAI,EAAE,4BAA4B;IAc9C;;;;OAIG;IACG,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAYvE,KAAK,IAAI,IAAI;CAGb"}
+{"version":3,"file":"postal-city-alias-lookup.d.ts","sourceRoot":"","sources":["../postal-city-alias-lookup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAM1C,MAAM,WAAW,4BAA4B;IAC5C,qGAAqG;IACrG,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,8FAA8F;IAC9F,QAAQ,CAAC,EAAE,YAAY,CAAA;CACvB;AAED,+FAA+F;AAC/F,MAAM,WAAW,eAAe;IAC/B,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAA;IAClB,4FAA4F;IAC5F,WAAW,EAAE,MAAM,CAAA;IACnB,kDAAkD;IAClD,CAAC,EAAE,MAAM,CAAA;CACT;AAED;;;;GAIG;AACH,qBAAa,wBAAwB;;gBAKxB,IAAI,EAAE,4BAA4B;IAc9C;;;OAGG;IACG,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAcvE,KAAK,IAAI,IAAI;CAGb"}

package/out/postal-city-alias-lookup.js

@@ -5,7 +5,7 @@
  *
  *   Node reader over the POSTAL-CITY ALIAS table (`postal-city-alias-<cc>.db`) — the observed
  *   `postal_city → geo_locality` aliases per postcode (`build-postal-city-alias.ts`). Consumed by
- *   {@link WofSqlitePlaceLookup}'s coordinate-first locality scorer: a user-typed postal city
+ *   {@link WOFSqlitePlaceLookup}'s coordinate-first locality scorer: a user-typed postal city
  *   ("Antioch", postcode 37013) becomes a name-match alias for the geographic locality the postcode
  *   actually sits in ("Nashville"), so the right place tiers to the top instead of a same-named
  *   town in another state. Opt-in — the lookup is only constructed when a path is supplied, and
@@ -15,36 +15,35 @@
  *   candidate localities is the scorer's job (it owns the case/diacritic fold the soft name score
  *   uses), keeping one normalizer in one place.
  */
-import { DatabaseClient } from "@mailwoman/core/kysley/client";
 import { DatabaseSync } from "node:sqlite";
+import { DatabaseClient } from "@mailwoman/core/kysley/client";
 /**
- * Reader over `postal_city_alias`. The only query is a postcode-scoped probe for DIVERGENT rows
- * (where the postal name differs from the geographic name — the rows that carry alias signal),
- * issued via the typed Kysely query builder against {@link PostalCityAliasDatabase}.
+ * Reader over `postal_city_alias`. The only query is a postcode-scoped probe for DIVERGENT rows (where the postal name
+ * differs from the geographic name — the rows that carry alias signal), issued via the typed Kysely query builder
+ * against {@link PostalCityAliasDatabase}.
  */
-export class WofPostalCityAliasLookup {
+export class WOFPostalCityAliasLookup {
     #db;
     #kdb;
-    #ownsDb;
+    #ownsDB;
     constructor(opts) {
         if (opts.database) {
             this.#db = opts.database;
-            this.#ownsDb = false;
+            this.#ownsDB = false;
         }
         else if (opts.databasePath) {
             this.#db = new DatabaseSync(opts.databasePath, { readOnly: true });
-            this.#ownsDb = true;
+            this.#ownsDB = true;
         }
         else {
-            throw new Error("WofPostalCityAliasLookup needs `databasePath` or `database`");
+            throw new Error("WOFPostalCityAliasLookup needs `databasePath` or `database`");
         }
         // `#kdb` wraps `#db` for the typed query; close() owns the raw handle directly (sync).
         this.#kdb = new DatabaseClient({ database: this.#db });
     }
     /**
-     * Divergent postal-city aliases for a postcode (empty when the postcode isn't in the table). The
-     * scorer groups these by normalized `geoLocality` and appends the `postalCity` surfaces to the
-     * matching candidate locality's alias set.
+     * Divergent postal-city aliases for a postcode (empty when the postcode isn't in the table). The scorer groups these
+     * by normalized `geoLocality` and appends the `postalCity` surfaces to the matching candidate locality's alias set.
      */
     async getDivergentAliases(postcode) {
         const pc = postcode.trim();
@@ -59,7 +58,7 @@ export class WofPostalCityAliasLookup {
         return rows.map((r) => ({ postalCity: String(r.postal_city), geoLocality: String(r.geo_locality), n: Number(r.n) }));
     }
     close() {
-        if (this.#ownsDb)
+        if (this.#ownsDB)
             this.#db.close();
     }
 }

package/out/postal-city-alias-lookup.js.map

@@ -1 +1 @@
-{"version":3,"file":"postal-city-alias-lookup.js","sourceRoot":"","sources":["../postal-city-alias-lookup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAoB1C;;;;GAIG;AACH,MAAM,OAAO,wBAAwB;IACpC,GAAG,CAAc;IACjB,IAAI,CAAyC;IAC7C,OAAO,CAAS;IAEhB,YAAY,IAAkC;QAC7C,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAA;YACxB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAA;QACrB,CAAC;aAAM,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YAC9B,IAAI,CAAC,GAAG,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAA;YAClE,IAAI,CAAC,OAAO,GAAG,IAAI,CAAA;QACpB,CAAC;aAAM,CAAC;YACP,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAA;QAC/E,CAAC;QACD,uFAAuF;QACvF,IAAI,CAAC,IAAI,GAAG,IAAI,cAAc,CAA0B,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAA;IAChF,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,mBAAmB,CAAC,QAAgB;QACzC,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAA;QAC1B,IAAI,CAAC,EAAE;YAAE,OAAO,EAAE,CAAA;QAClB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI;aAC1B,UAAU,CAAC,mBAAmB,CAAC;aAC/B,MAAM,CAAC,CAAC,aAAa,EAAE,cAAc,EAAE,GAAG,CAAC,CAAC;aAC5C,KAAK,CAAC,UAAU,EAAE,GAAG,EAAE,EAAE,CAAC;aAC1B,KAAK,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC;aAC1B,OAAO,EAAE,CAAA;QACX,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IACrH,CAAC;IAED,KAAK;QACJ,IAAI,IAAI,CAAC,OAAO;YAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAA;IACnC,CAAC;CACD"}
+{"version":3,"file":"postal-city-alias-lookup.js","sourceRoot":"","sources":["../postal-city-alias-lookup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1C,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAqB9D;;;;GAIG;AACH,MAAM,OAAO,wBAAwB;IACpC,GAAG,CAAc;IACjB,IAAI,CAAyC;IAC7C,OAAO,CAAS;IAEhB,YAAY,IAAkC;QAC7C,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAA;YACxB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAA;QACrB,CAAC;aAAM,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YAC9B,IAAI,CAAC,GAAG,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAA;YAClE,IAAI,CAAC,OAAO,GAAG,IAAI,CAAA;QACpB,CAAC;aAAM,CAAC;YACP,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAA;QAC/E,CAAC;QACD,uFAAuF;QACvF,IAAI,CAAC,IAAI,GAAG,IAAI,cAAc,CAA0B,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAA;IAChF,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,mBAAmB,CAAC,QAAgB;QACzC,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAA;QAE1B,IAAI,CAAC,EAAE;YAAE,OAAO,EAAE,CAAA;QAClB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI;aAC1B,UAAU,CAAC,mBAAmB,CAAC;aAC/B,MAAM,CAAC,CAAC,aAAa,EAAE,cAAc,EAAE,GAAG,CAAC,CAAC;aAC5C,KAAK,CAAC,UAAU,EAAE,GAAG,EAAE,EAAE,CAAC;aAC1B,KAAK,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC;aAC1B,OAAO,EAAE,CAAA;QAEX,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IACrH,CAAC;IAED,KAAK;QACJ,IAAI,IAAI,CAAC,OAAO;YAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAA;IACnC,CAAC;CACD"}

package/out/postal-city-alias-schema.d.ts

@@ -5,7 +5,7 @@
  *
  *   Typed schema for the POSTAL-CITY ALIAS table (`postal-city-alias-<cc>.db`, built by
  *   `scripts/build-postal-city-alias.ts`) — the single source of truth for the columns shared by
- *   the BUILDER and the READER ({@link WofPostalCityAliasLookup}). Like {@link CandidateTable}, the
+ *   the BUILDER and the READER ({@link WOFPostalCityAliasLookup}). Like {@link CandidateTable}, the
  *   contract is a Kysely `Database` interface plus the table DDL as a string, so a column rename in
  *   the builder is a compile error in the reader.
  *
@@ -17,8 +17,8 @@
  */
 import type { Kysely } from "kysely";
 /**
- * One observed postal-city aggregate. The natural key is `(postcode, postal_city, geo_locality)`;
- * the builder enforces a `MIN_COUNT` floor on `n`, so every row is a non-trivial usage.
+ * One observed postal-city aggregate. The natural key is `(postcode, postal_city, geo_locality)`; the builder enforces
+ * a `MIN_COUNT` floor on `n`, so every row is a non-trivial usage.
  */
 export interface PostalCityAliasTable {
     /** The postcode the aggregate is scoped to (the resolver probes by this). */
@@ -43,9 +43,8 @@ export interface PostalCityAliasDatabase {
 /** The `postal_city_alias` column order — the builder's INSERT derives its column list from this. */
 export declare const POSTAL_CITY_ALIAS_COLUMNS: readonly ["postcode", "postal_city", "geo_locality", "n", "divergent", "source", "release"];
 /**
- * Create the `postal_city_alias` table + its two probe indexes. Kept here (not only in the builder)
- * so tests can stand up a fixture DB with the exact production shape. Pass a {@link DatabaseClient}
- * (or any `Kysely`) over the alias DB.
+ * Create the `postal_city_alias` table + its two probe indexes. Kept here (not only in the builder) so tests can stand
+ * up a fixture DB with the exact production shape. Pass a {@link DatabaseClient} (or any `Kysely`) over the alias DB.
  */
 export declare function createPostalCityAliasTable(db: Kysely<PostalCityAliasDatabase>): Promise<void>;
 //# sourceMappingURL=postal-city-alias-schema.d.ts.map

package/out/postal-city-alias-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"postal-city-alias-schema.d.ts","sourceRoot":"","sources":["../postal-city-alias-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAEpC;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACpC,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,CAAA;IAChB,qFAAqF;IACrF,WAAW,EAAE,MAAM,CAAA;IACnB,qGAAqG;IACrG,YAAY,EAAE,MAAM,CAAA;IACpB,kEAAkE;IAClE,CAAC,EAAE,MAAM,CAAA;IACT,kFAAkF;IAClF,SAAS,EAAE,MAAM,CAAA;IACjB,6EAA6E;IAC7E,MAAM,EAAE,MAAM,CAAA;IACd,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAA;CACf;AAED,oGAAoG;AACpG,MAAM,WAAW,uBAAuB;IACvC,iBAAiB,EAAE,oBAAoB,CAAA;CACvC;AAED,qGAAqG;AACrG,eAAO,MAAM,yBAAyB,6FAQ5B,CAAA;AAEV;;;;GAIG;AACH,wBAAsB,0BAA0B,CAAC,EAAE,EAAE,MAAM,CAAC,uBAAuB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAanG"}
+{"version":3,"file":"postal-city-alias-schema.d.ts","sourceRoot":"","sources":["../postal-city-alias-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAEpC;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACpC,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,CAAA;IAChB,qFAAqF;IACrF,WAAW,EAAE,MAAM,CAAA;IACnB,qGAAqG;IACrG,YAAY,EAAE,MAAM,CAAA;IACpB,kEAAkE;IAClE,CAAC,EAAE,MAAM,CAAA;IACT,kFAAkF;IAClF,SAAS,EAAE,MAAM,CAAA;IACjB,6EAA6E;IAC7E,MAAM,EAAE,MAAM,CAAA;IACd,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAA;CACf;AAED,oGAAoG;AACpG,MAAM,WAAW,uBAAuB;IACvC,iBAAiB,EAAE,oBAAoB,CAAA;CACvC;AAED,qGAAqG;AACrG,eAAO,MAAM,yBAAyB,6FAQ5B,CAAA;AAEV;;;GAGG;AACH,wBAAsB,0BAA0B,CAAC,EAAE,EAAE,MAAM,CAAC,uBAAuB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAanG"}

package/out/postal-city-alias-schema.js

@@ -5,7 +5,7 @@
  *
  *   Typed schema for the POSTAL-CITY ALIAS table (`postal-city-alias-<cc>.db`, built by
  *   `scripts/build-postal-city-alias.ts`) — the single source of truth for the columns shared by
- *   the BUILDER and the READER ({@link WofPostalCityAliasLookup}). Like {@link CandidateTable}, the
+ *   the BUILDER and the READER ({@link WOFPostalCityAliasLookup}). Like {@link CandidateTable}, the
  *   contract is a Kysely `Database` interface plus the table DDL as a string, so a column rename in
  *   the builder is a compile error in the reader.
  *
@@ -26,9 +26,8 @@ export const POSTAL_CITY_ALIAS_COLUMNS = [
     "release",
 ];
 /**
- * Create the `postal_city_alias` table + its two probe indexes. Kept here (not only in the builder)
- * so tests can stand up a fixture DB with the exact production shape. Pass a {@link DatabaseClient}
- * (or any `Kysely`) over the alias DB.
+ * Create the `postal_city_alias` table + its two probe indexes. Kept here (not only in the builder) so tests can stand
+ * up a fixture DB with the exact production shape. Pass a {@link DatabaseClient} (or any `Kysely`) over the alias DB.
  */
 export async function createPostalCityAliasTable(db) {
     await db.schema

package/out/postal-city-alias-schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"postal-city-alias-schema.js","sourceRoot":"","sources":["../postal-city-alias-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AA8BH,qGAAqG;AACrG,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACxC,UAAU;IACV,aAAa;IACb,cAAc;IACd,GAAG;IACH,WAAW;IACX,QAAQ;IACR,SAAS;CACA,CAAA;AAEV;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,EAAmC;IACnF,MAAM,EAAE,CAAC,MAAM;SACb,WAAW,CAAC,mBAAmB,CAAC;SAChC,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SACjD,SAAS,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SACpD,SAAS,CAAC,cAAc,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SACrD,SAAS,CAAC,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SAC7C,SAAS,CAAC,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SACrD,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,OAAO,EAAE,CAAA;IACX,MAAM,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC,EAAE,CAAC,mBAAmB,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,CAAA;IACpG,MAAM,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC,mBAAmB,CAAC,CAAC,OAAO,CAAC,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC,CAAC,OAAO,EAAE,CAAA;AACvH,CAAC"}
+{"version":3,"file":"postal-city-alias-schema.js","sourceRoot":"","sources":["../postal-city-alias-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AA8BH,qGAAqG;AACrG,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACxC,UAAU;IACV,aAAa;IACb,cAAc;IACd,GAAG;IACH,WAAW;IACX,QAAQ;IACR,SAAS;CACA,CAAA;AAEV;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,EAAmC;IACnF,MAAM,EAAE,CAAC,MAAM;SACb,WAAW,CAAC,mBAAmB,CAAC;SAChC,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SACjD,SAAS,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SACpD,SAAS,CAAC,cAAc,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SACrD,SAAS,CAAC,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SAC7C,SAAS,CAAC,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SACrD,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,OAAO,EAAE,CAAA;IACX,MAAM,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC,EAAE,CAAC,mBAAmB,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,CAAA;IACpG,MAAM,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC,mBAAmB,CAAC,CAAC,OAAO,CAAC,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC,CAAC,OAAO,EAAE,CAAA;AACvH,CAAC"}

package/out/postal-city-candidate-schema.d.ts

@@ -19,8 +19,8 @@
  */
 import { type Kysely } from "kysely";
 /**
- * One postal-city → geo-locality edge, keyed exactly by `(name_key, postcode)`. The probe returns
- * the geographic locality directly; the denormalized name/coord avoid a join back to `candidate`.
+ * One postal-city → geo-locality edge, keyed exactly by `(name_key, postcode)`. The probe returns the geographic
+ * locality directly; the denormalized name/coord avoid a join back to `candidate`.
  */
 export interface PostalCityCandidateTable {
     /** {@link normalizeLocalityForKey} of the postal-city name — the build/query-consistent probe key. */
@@ -35,24 +35,21 @@ export interface PostalCityCandidateTable {
     longitude: number;
 }
 /**
- * The postal-city-candidate database schema for `new
- * DatabaseClient<PostalCityCandidateDatabase>(...)`.
+ * The postal-city-candidate database schema for `new DatabaseClient<PostalCityCandidateDatabase>(...)`.
  */
 export interface PostalCityCandidateDatabase {
     postal_city_candidate: PostalCityCandidateTable;
 }
 /**
- * The table name the lookup probes (existence-gated, so an old candidate.db without it is
- * byte-stable).
+ * The table name the lookup probes (existence-gated, so an old candidate.db without it is byte-stable).
  */
 export declare const POSTAL_CITY_CANDIDATE_TABLE = "postal_city_candidate";
 /** Column order for the builder's positional INSERT. */
 export declare const POSTAL_CITY_CANDIDATE_COLUMNS: readonly ["name_key", "postcode", "spr_id", "name", "latitude", "longitude"];
 /**
- * Create the side-index — a clustered `WITHOUT ROWID` B-tree on `(name_key, postcode)` so the
- * resolve is a single exact probe. Idempotent (`IF NOT EXISTS`); pass a {@link DatabaseClient} (or
- * any `Kysely`) over the candidate DB. The Kysely schema-builder is the house idiom for table
- * creation — see `AGENTS.md` (inline-SQL → Kysely).
+ * Create the side-index — a clustered `WITHOUT ROWID` B-tree on `(name_key, postcode)` so the resolve is a single exact
+ * probe. Idempotent (`IF NOT EXISTS`); pass a {@link DatabaseClient} (or any `Kysely`) over the candidate DB. The
+ * Kysely schema-builder is the house idiom for table creation — see `AGENTS.md` (inline-SQL → Kysely).
  */
 export declare function createPostalCityCandidateTable(db: Kysely<PostalCityCandidateDatabase>): Promise<void>;
 //# sourceMappingURL=postal-city-candidate-schema.d.ts.map

package/out/postal-city-candidate-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"postal-city-candidate-schema.d.ts","sourceRoot":"","sources":["../postal-city-candidate-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAO,KAAK,MAAM,EAAE,MAAM,QAAQ,CAAA;AAEzC;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACxC,sGAAsG;IACtG,QAAQ,EAAE,MAAM,CAAA;IAChB,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,CAAA;IAChB,mFAAmF;IACnF,MAAM,EAAE,MAAM,CAAA;IACd,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IAC3C,qBAAqB,EAAE,wBAAwB,CAAA;CAC/C;AAED;;;GAGG;AACH,eAAO,MAAM,2BAA2B,0BAA0B,CAAA;AAElE,wDAAwD;AACxD,eAAO,MAAM,6BAA6B,8EAOhC,CAAA;AAEV;;;;;GAKG;AACH,wBAAsB,8BAA8B,CAAC,EAAE,EAAE,MAAM,CAAC,2BAA2B,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAc3G"}
+{"version":3,"file":"postal-city-candidate-schema.d.ts","sourceRoot":"","sources":["../postal-city-candidate-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAO,KAAK,MAAM,EAAE,MAAM,QAAQ,CAAA;AAEzC;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACxC,sGAAsG;IACtG,QAAQ,EAAE,MAAM,CAAA;IAChB,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,CAAA;IAChB,mFAAmF;IACnF,MAAM,EAAE,MAAM,CAAA;IACd,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC3C,qBAAqB,EAAE,wBAAwB,CAAA;CAC/C;AAED;;GAEG;AACH,eAAO,MAAM,2BAA2B,0BAA0B,CAAA;AAElE,wDAAwD;AACxD,eAAO,MAAM,6BAA6B,8EAOhC,CAAA;AAEV;;;;GAIG;AACH,wBAAsB,8BAA8B,CAAC,EAAE,EAAE,MAAM,CAAC,2BAA2B,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAc3G"}

package/out/postal-city-candidate-schema.js

@@ -19,8 +19,7 @@
  */
 import { sql } from "kysely";
 /**
- * The table name the lookup probes (existence-gated, so an old candidate.db without it is
- * byte-stable).
+ * The table name the lookup probes (existence-gated, so an old candidate.db without it is byte-stable).
  */
 export const POSTAL_CITY_CANDIDATE_TABLE = "postal_city_candidate";
 /** Column order for the builder's positional INSERT. */
@@ -33,10 +32,9 @@ export const POSTAL_CITY_CANDIDATE_COLUMNS = [
     "longitude",
 ];
 /**
- * Create the side-index — a clustered `WITHOUT ROWID` B-tree on `(name_key, postcode)` so the
- * resolve is a single exact probe. Idempotent (`IF NOT EXISTS`); pass a {@link DatabaseClient} (or
- * any `Kysely`) over the candidate DB. The Kysely schema-builder is the house idiom for table
- * creation — see `AGENTS.md` (inline-SQL → Kysely).
+ * Create the side-index — a clustered `WITHOUT ROWID` B-tree on `(name_key, postcode)` so the resolve is a single exact
+ * probe. Idempotent (`IF NOT EXISTS`); pass a {@link DatabaseClient} (or any `Kysely`) over the candidate DB. The
+ * Kysely schema-builder is the house idiom for table creation — see `AGENTS.md` (inline-SQL → Kysely).
  */
 export async function createPostalCityCandidateTable(db) {
     await db.schema

package/out/postal-city-candidate-schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"postal-city-candidate-schema.js","sourceRoot":"","sources":["../postal-city-candidate-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,GAAG,EAAe,MAAM,QAAQ,CAAA;AA2BzC;;;GAGG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,uBAAuB,CAAA;AAElE,wDAAwD;AACxD,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC5C,UAAU;IACV,UAAU;IACV,QAAQ;IACR,MAAM;IACN,UAAU;IACV,WAAW;CACF,CAAA;AAEV;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAAC,EAAuC;IAC3F,MAAM,EAAE,CAAC,MAAM;SACb,WAAW,CAAC,2BAA2B,CAAC;SACxC,WAAW,EAAE;SACb,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SACjD,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SACjD,SAAS,CAAC,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SAClD,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SAC7C,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SACjD,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SAClD,uBAAuB,CAAC,0BAA0B,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QAC9E,0FAA0F;SACzF,SAAS,CAAC,GAAG,CAAA,eAAe,CAAC;SAC7B,OAAO,EAAE,CAAA;AACZ,CAAC"}
+{"version":3,"file":"postal-city-candidate-schema.js","sourceRoot":"","sources":["../postal-city-candidate-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,GAAG,EAAe,MAAM,QAAQ,CAAA;AA0BzC;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,uBAAuB,CAAA;AAElE,wDAAwD;AACxD,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC5C,UAAU;IACV,UAAU;IACV,QAAQ;IACR,MAAM;IACN,UAAU;IACV,WAAW;CACF,CAAA;AAEV;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAAC,EAAuC;IAC3F,MAAM,EAAE,CAAC,MAAM;SACb,WAAW,CAAC,2BAA2B,CAAC;SACxC,WAAW,EAAE;SACb,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SACjD,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SACjD,SAAS,CAAC,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SAClD,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SAC7C,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SACjD,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SAClD,uBAAuB,CAAC,0BAA0B,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QAC9E,0FAA0F;SACzF,SAAS,CAAC,GAAG,CAAA,eAAe,CAAC;SAC7B,OAAO,EAAE,CAAA;AACZ,CAAC"}

package/out/postcode-point-lookup.d.ts

@@ -13,21 +13,20 @@
  *   anchor only needs "does this string exist as a postcode, in which countries, near where". A
  *   future WASM build swaps this for an FST-backed resolver behind the same `lookup()` seam.
  *
- *   Why multiple shards instead of the multi-shard `WofSqlitePlaceLookup`: that resolver routes a
+ *   Why multiple shards instead of the multi-shard `WOFSqlitePlaceLookup`: that resolver routes a
  *   query to ONE shard by placetype, but every postcode shard shares `placetype='postalcode'`, so a
  *   single query could only ever hit one country's shard. The anchor needs the union across
  *   countries to build its country posterior, so it queries each shard directly.
  */
 /**
- * A gazetteer hit. `lat`/`lon` of 0 means the postcode is known but has no centroid (no admin
- * parent).
+ * A gazetteer hit. `lat`/`lon` of 0 means the postcode is known but has no centroid (no admin parent).
  */
 export interface PostcodePlace {
     country: string;
     lat: number;
     lon: number;
 }
-export declare class WofPostcodeLookup {
+export declare class WOFPostcodeLookup {
     #private;
     /** Open each shard read-only and prepare its exact-match statement. */
     constructor(dbPaths: readonly string[]);

package/out/postcode-point-lookup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"postcode-point-lookup.d.ts","sourceRoot":"","sources":["../postcode-point-lookup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;CACX;AAKD,qBAAa,iBAAiB;;IAI7B,uEAAuE;gBAC3D,OAAO,EAAE,SAAS,MAAM,EAAE;IAKtC,sEAAsE;IACtE,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE;IAUzC,KAAK,IAAI,IAAI;CAGb"}
+{"version":3,"file":"postcode-point-lookup.d.ts","sourceRoot":"","sources":["../postcode-point-lookup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;CACX;AAKD,qBAAa,iBAAiB;;IAI7B,uEAAuE;gBAC3D,OAAO,EAAE,SAAS,MAAM,EAAE;IAKtC,sEAAsE;IACtE,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE;IAYzC,KAAK,IAAI,IAAI;CAGb"}

package/out/postcode-point-lookup.js

@@ -13,14 +13,14 @@
  *   anchor only needs "does this string exist as a postcode, in which countries, near where". A
  *   future WASM build swaps this for an FST-backed resolver behind the same `lookup()` seam.
  *
- *   Why multiple shards instead of the multi-shard `WofSqlitePlaceLookup`: that resolver routes a
+ *   Why multiple shards instead of the multi-shard `WOFSqlitePlaceLookup`: that resolver routes a
  *   query to ONE shard by placetype, but every postcode shard shares `placetype='postalcode'`, so a
  *   single query could only ever hit one country's shard. The anchor needs the union across
  *   countries to build its country posterior, so it queries each shard directly.
  */
 import { DatabaseSync } from "node:sqlite";
 const LOOKUP_SQL = "SELECT country, latitude AS lat, longitude AS lon FROM spr WHERE name = ? AND placetype = 'postalcode' AND is_current != 0";
-export class WofPostcodeLookup {
+export class WOFPostcodeLookup {
     #dbs;
     #stmts;
     /** Open each shard read-only and prepare its exact-match statement. */

package/out/postcode-point-lookup.js.map

@@ -1 +1 @@
-{"version":3,"file":"postcode-point-lookup.js","sourceRoot":"","sources":["../postcode-point-lookup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAY1C,MAAM,UAAU,GACf,4HAA4H,CAAA;AAE7H,MAAM,OAAO,iBAAiB;IACpB,IAAI,CAAgB;IACpB,MAAM,CAAuC;IAEtD,uEAAuE;IACvE,YAAY,OAA0B;QACrC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,YAAY,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;QACvE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAA;IAC5D,CAAC;IAED,sEAAsE;IACtE,MAAM,CAAC,QAAgB;QACtB,MAAM,GAAG,GAAoB,EAAE,CAAA;QAC/B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACtC,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;YACvF,CAAC;QACF,CAAC;QACD,OAAO,GAAG,CAAA;IACX,CAAC;IAED,KAAK;QACJ,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,IAAI;YAAE,EAAE,CAAC,KAAK,EAAE,CAAA;IACvC,CAAC;CACD"}
+{"version":3,"file":"postcode-point-lookup.js","sourceRoot":"","sources":["../postcode-point-lookup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAW1C,MAAM,UAAU,GACf,4HAA4H,CAAA;AAE7H,MAAM,OAAO,iBAAiB;IACpB,IAAI,CAAgB;IACpB,MAAM,CAAuC;IAEtD,uEAAuE;IACvE,YAAY,OAA0B;QACrC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,YAAY,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;QACvE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAA;IAC5D,CAAC;IAED,sEAAsE;IACtE,MAAM,CAAC,QAAgB;QACtB,MAAM,GAAG,GAAoB,EAAE,CAAA;QAE/B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACtC,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;YACvF,CAAC;QACF,CAAC;QAED,OAAO,GAAG,CAAA;IACX,CAAC;IAED,KAAK;QACJ,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,IAAI;YAAE,EAAE,CAAC,KAAK,EAAE,CAAA;IACvC,CAAC;CACD"}

package/out/reverse.d.ts

@@ -28,69 +28,66 @@
  *   says so per result rather than pretending.
  */
 import { DatabaseSync } from "node:sqlite";
-import type { PlaceCandidate, WofPlacetype } from "./types.js";
+import type { PlaceCandidate, WOFPlacetype } from "./types.js";
 /**
  * How the deepest returned place was confirmed:
  *
  * - `"polygon"` — the point ray-cast INSIDE the place's real (DP-simplified) admin boundary.
- * - `"approximate"` — the place has no polygon on record; it won by nearest-centroid among the
- *   candidates whose bbox (or parent) contains the point. The same honesty convention as the demo's
- *   approximate circles — country-dependent data reality, surfaced instead of hidden.
+ * - `"approximate"` — the place has no polygon on record; it won by nearest-centroid among the candidates whose bbox (or
+ *   parent) contains the point. The same honesty convention as the demo's approximate circles — country-dependent data
+ *   reality, surfaced instead of hidden.
  */
 export type ContainmentKind = "polygon" | "approximate";
 export interface ReverseGeocodeResult {
     /**
-     * The containment chain, DEEPEST-FIRST (`[0]` is the winning place, then its ancestors up to
-     * country) — the same tree shape forward resolution attaches via `includeAncestors`. Empty when
-     * no candidate's bbox contains the point (open ocean, or outside the gazetteer's coverage).
+     * The containment chain, DEEPEST-FIRST (`[0]` is the winning place, then its ancestors up to country) — the same tree
+     * shape forward resolution attaches via `includeAncestors`. Empty when no candidate's bbox contains the point (open
+     * ocean, or outside the gazetteer's coverage).
      */
     hierarchy: PlaceCandidate[];
     /** Containment kind of the DEEPEST place in `hierarchy` (see {@link ContainmentKind}). */
     containment: ContainmentKind;
 }
-export interface WofReverseGeocoderOpts {
+export interface WOFReverseGeocoderOpts {
     /**
-     * Path to the admin gazetteer DB (e.g. `admin-global-priority.db`) — must carry `spr`,
-     * `ancestors`, and the package-built `place_bbox` R*Tree (`mailwoman-wof-build-fts`). Mutually
-     * exclusive with `adminDatabase`.
+     * Path to the admin gazetteer DB (e.g. `admin-global-priority.db`) — must carry `spr`, `ancestors`, and the
+     * package-built `place_bbox` R*Tree (`mailwoman-wof-build-fts`). Mutually exclusive with `adminDatabase`.
      */
-    adminDbPath?: string;
+    adminDBPath?: string;
     /** Pre-opened admin DB — primarily for tests against an inline fixture. */
     adminDatabase?: DatabaseSync;
     /**
-     * Path to the polygon sidecar DB (`wof-polygons.db`, table `polygons(id, geom)`). OPTIONAL —
-     * without it every result is `containment: "approximate"` (centroid-only mode). Mutually
-     * exclusive with `polygonDatabase`.
+     * Path to the polygon sidecar DB (`wof-polygons.db`, table `polygons(id, geom)`). OPTIONAL — without it every result
+     * is `containment: "approximate"` (centroid-only mode). Mutually exclusive with `polygonDatabase`.
      */
-    polygonDbPath?: string;
+    polygonDBPath?: string;
     /** Pre-opened polygon DB — primarily for tests. */
     polygonDatabase?: DatabaseSync;
 }
 export interface ReverseGeocodeOpts {
     /**
-     * Restrict the hierarchy to these placetypes (both the bbox candidates and the descent tiers).
-     * Default: every admin placetype the gazetteer carries. E.g. `["region", "county", "locality"]`
-     * to skip the neighbourhood grain.
+     * Restrict the hierarchy to these placetypes (both the bbox candidates and the descent tiers). Default: every admin
+     * placetype the gazetteer carries. E.g. `["region", "county", "locality"]` to skip the neighbourhood grain.
      */
-    placetypes?: WofPlacetype[];
+    placetypes?: WOFPlacetype[];
     /**
-     * Cap on the bbox candidate fetch. Default 128 — comfortably covers a dense metro (the most
-     * bbox-overlapping point we've measured is a few dozen neighbourhoods + the admin chain).
+     * Cap on the bbox candidate fetch. Default 128 — comfortably covers a dense metro (the most bbox-overlapping point
+     * we've measured is a few dozen neighbourhoods + the admin chain).
      */
     maxCandidates?: number;
     /**
-     * Approximate (nearest-centroid) steps further than this from the query point are not taken —
-     * keeps a sparse gazetteer from "refining" to a far-away sibling. Polygon-confirmed steps ignore
-     * it (containment is exact regardless of centroid distance). Default 25 km.
+     * Approximate (nearest-centroid) steps further than this from the query point are not taken — keeps a sparse
+     * gazetteer from "refining" to a far-away sibling. Polygon-confirmed steps ignore it (containment is exact regardless
+     * of centroid distance). Default 25 km.
      */
     maxApproximateKm?: number;
 }
-export declare class WofReverseGeocoder implements Disposable {
+export declare class WOFReverseGeocoder implements Disposable {
     #private;
-    constructor(opts: WofReverseGeocoderOpts);
+    constructor(opts: WOFReverseGeocoderOpts);
     /**
-     * Resolve a WGS-84 point to its containing admin hierarchy. Async for symmetry with
-     * `PlaceLookup.findPlace` (the work is sync `node:sqlite` underneath — same convention).
+     * Resolve a WGS-84 point to its containing admin hierarchy. Async for symmetry with `PlaceLookup.findPlace` (the work
+     * is sync `node:sqlite` underneath — same convention).
      */
     reverseGeocode(lat: number, lon: number, opts?: ReverseGeocodeOpts): Promise<ReverseGeocodeResult>;
     close(): void;

package/out/reverse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reverse.d.ts","sourceRoot":"","sources":["../reverse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAK1C,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9D;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,aAAa,CAAA;AAEvD,MAAM,WAAW,oBAAoB;IACpC;;;;OAIG;IACH,SAAS,EAAE,cAAc,EAAE,CAAA;IAC3B,0FAA0F;IAC1F,WAAW,EAAE,eAAe,CAAA;CAC5B;AAED,MAAM,WAAW,sBAAsB;IACtC;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,2EAA2E;IAC3E,aAAa,CAAC,EAAE,YAAY,CAAA;IAC5B;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,mDAAmD;IACnD,eAAe,CAAC,EAAE,YAAY,CAAA;CAC9B;AAED,MAAM,WAAW,kBAAkB;IAClC;;;;OAIG;IACH,UAAU,CAAC,EAAE,YAAY,EAAE,CAAA;IAC3B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;CACzB;AA6CD,qBAAa,kBAAmB,YAAW,UAAU;;gBAcxC,IAAI,EAAE,sBAAsB;IAyCxC;;;OAGG;IACG,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,kBAAuB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAqL5G,KAAK,IAAI,IAAI;IAKb,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;CAGxB"}
+{"version":3,"file":"reverse.d.ts","sourceRoot":"","sources":["../reverse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAK1C,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9D;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,aAAa,CAAA;AAEvD,MAAM,WAAW,oBAAoB;IACpC;;;;OAIG;IACH,SAAS,EAAE,cAAc,EAAE,CAAA;IAC3B,0FAA0F;IAC1F,WAAW,EAAE,eAAe,CAAA;CAC5B;AAED,MAAM,WAAW,sBAAsB;IACtC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,2EAA2E;IAC3E,aAAa,CAAC,EAAE,YAAY,CAAA;IAC5B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,mDAAmD;IACnD,eAAe,CAAC,EAAE,YAAY,CAAA;CAC9B;AAED,MAAM,WAAW,kBAAkB;IAClC;;;OAGG;IACH,UAAU,CAAC,EAAE,YAAY,EAAE,CAAA;IAC3B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;CACzB;AA8CD,qBAAa,kBAAmB,YAAW,UAAU;;gBAcxC,IAAI,EAAE,sBAAsB;IA8CxC;;;OAGG;IACG,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,kBAAuB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA6M5G,KAAK,IAAI,IAAI;IAMb,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;CAGxB"}

package/out/reverse.js

@@ -34,9 +34,8 @@ import { geometryContains, haversineKm } from "./geo.js";
 const DEFAULT_MAX_CANDIDATES = 128;
 const DEFAULT_MAX_APPROXIMATE_KM = 25;
 /**
- * The tier ladder for the approximate descent, coarsest-first. Each tier is attempted among the
- * CURRENT winner's descendants; a tier with no rows is skipped (e.g. counties without localadmins
- * jump straight to locality).
+ * The tier ladder for the approximate descent, coarsest-first. Each tier is attempted among the CURRENT winner's
+ * descendants; a tier with no rows is skipped (e.g. counties without localadmins jump straight to locality).
  */
 const DESCENT_TIERS = [
     "county",
@@ -61,41 +60,41 @@ function toPlaceCandidate(row, distanceKm) {
         c.distanceKm = distanceKm;
     return c;
 }
-export class WofReverseGeocoder {
+export class WOFReverseGeocoder {
     #admin;
     #ownsAdmin;
     #polygons;
     #ownsPolygons;
     /**
-     * Parsed-geometry cache. Reverse queries cluster geographically (an eval run hits the same ~15
-     * county polygons 1400 times), so caching the JSON.parse pays for itself immediately. Bounded —
-     * cleared wholesale at the cap rather than LRU-tracked; the polygons are DP-simplified and small,
-     * the cap exists only to keep a long-lived server process honest.
+     * Parsed-geometry cache. Reverse queries cluster geographically (an eval run hits the same ~15 county polygons 1400
+     * times), so caching the JSON.parse pays for itself immediately. Bounded — cleared wholesale at the cap rather than
+     * LRU-tracked; the polygons are DP-simplified and small, the cap exists only to keep a long-lived server process
+     * honest.
      */
     #geometryCache = new Map();
     static #GEOMETRY_CACHE_CAP = 4096;
     constructor(opts) {
-        if (opts.adminDatabase && opts.adminDbPath) {
-            throw new Error("WofReverseGeocoder: pass either `adminDatabase` or `adminDbPath`, not both");
+        if (opts.adminDatabase && opts.adminDBPath) {
+            throw new Error("WOFReverseGeocoder: pass either `adminDatabase` or `adminDBPath`, not both");
         }
-        if (!opts.adminDatabase && !opts.adminDbPath) {
-            throw new Error("WofReverseGeocoder: one of `adminDatabase` or `adminDbPath` is required");
+        if (!opts.adminDatabase && !opts.adminDBPath) {
+            throw new Error("WOFReverseGeocoder: one of `adminDatabase` or `adminDBPath` is required");
         }
-        if (opts.polygonDatabase && opts.polygonDbPath) {
-            throw new Error("WofReverseGeocoder: pass either `polygonDatabase` or `polygonDbPath`, not both");
+        if (opts.polygonDatabase && opts.polygonDBPath) {
+            throw new Error("WOFReverseGeocoder: pass either `polygonDatabase` or `polygonDBPath`, not both");
         }
-        this.#admin = opts.adminDatabase ?? new DatabaseSync(opts.adminDbPath, { readOnly: true });
+        this.#admin = opts.adminDatabase ?? new DatabaseSync(opts.adminDBPath, { readOnly: true });
         this.#ownsAdmin = !opts.adminDatabase;
         this.#polygons =
-            opts.polygonDatabase ?? (opts.polygonDbPath ? new DatabaseSync(opts.polygonDbPath, { readOnly: true }) : null);
-        this.#ownsPolygons = !opts.polygonDatabase && Boolean(opts.polygonDbPath);
+            opts.polygonDatabase ?? (opts.polygonDBPath ? new DatabaseSync(opts.polygonDBPath, { readOnly: true }) : null);
+        this.#ownsPolygons = !opts.polygonDatabase && Boolean(opts.polygonDBPath);
         // Fail loudly up front — the R*Tree is a build artifact, not part of the upstream WOF
         // distribution, and a missing index would otherwise surface as an opaque SQL error per query.
         const hasBbox = this.#admin
             .prepare(`SELECT name FROM sqlite_master WHERE type = 'table' AND name = ?`)
             .get(PLACE_BBOX_TABLE);
         if (!hasBbox) {
-            throw new Error(`WofReverseGeocoder: the admin DB has no \`${PLACE_BBOX_TABLE}\` R*Tree. Build it with ` +
+            throw new Error(`WOFReverseGeocoder: the admin DB has no \`${PLACE_BBOX_TABLE}\` R*Tree. Build it with ` +
                 "`mailwoman-wof-build-fts <path-to-wof.db>` (see resolver-wof-sqlite/README.md).");
         }
         if (this.#polygons) {
@@ -103,18 +102,18 @@ export class WofReverseGeocoder {
                 .prepare(`SELECT name FROM sqlite_master WHERE type = 'table' AND name = 'polygons'`)
                 .get();
             if (!hasPolygons) {
-                throw new Error("WofReverseGeocoder: the polygon DB has no `polygons` table. Expected a `wof-polygons.db` " +
+                throw new Error("WOFReverseGeocoder: the polygon DB has no `polygons` table. Expected a `wof-polygons.db` " +
                     "built by scripts/build-wof-polygons.mjs.");
             }
         }
     }
     /**
-     * Resolve a WGS-84 point to its containing admin hierarchy. Async for symmetry with
-     * `PlaceLookup.findPlace` (the work is sync `node:sqlite` underneath — same convention).
+     * Resolve a WGS-84 point to its containing admin hierarchy. Async for symmetry with `PlaceLookup.findPlace` (the work
+     * is sync `node:sqlite` underneath — same convention).
      */
     async reverseGeocode(lat, lon, opts = {}) {
         if (!Number.isFinite(lat) || !Number.isFinite(lon) || Math.abs(lat) > 90 || Math.abs(lon) > 180) {
-            throw new RangeError(`WofReverseGeocoder.reverseGeocode: (${lat}, ${lon}) is not a WGS-84 coordinate`);
+            throw new RangeError(`WOFReverseGeocoder.reverseGeocode: (${lat}, ${lon}) is not a WGS-84 coordinate`);
         }
         const maxApproximateKm = opts.maxApproximateKm ?? DEFAULT_MAX_APPROXIMATE_KM;
         const candidates = this.#bboxCandidates(lat, lon, opts);
@@ -188,22 +187,22 @@ export class WofReverseGeocoder {
         // Hierarchy assembly via the shared ancestor walk. If the descent crossed an ancestry gap
         // (the deepest place's recorded lineage misses the PIP root), merge the root's own chain so
         // region/country are always present when a polygon confirmed them.
-        const byId = new Map();
-        byId.set(current.id, toPlaceCandidate(current, currentDistanceKm));
+        const byID = new Map();
+        byID.set(current.id, toPlaceCandidate(current, currentDistanceKm));
         for (const a of ancestorLineage(this.#admin, current.id)) {
-            if (!byId.has(a.id)) {
-                byId.set(a.id, { ...a, placetype: a.placetype, country: a.country ?? "", score: 0 });
+            if (!byID.has(a.id)) {
+                byID.set(a.id, { ...a, placetype: a.placetype, country: a.country ?? "", score: 0 });
             }
         }
-        if (!byId.has(winner.id)) {
-            byId.set(winner.id, toPlaceCandidate(winner));
+        if (!byID.has(winner.id)) {
+            byID.set(winner.id, toPlaceCandidate(winner));
             for (const a of ancestorLineage(this.#admin, winner.id)) {
-                if (!byId.has(a.id)) {
-                    byId.set(a.id, { ...a, placetype: a.placetype, country: a.country ?? "", score: 0 });
+                if (!byID.has(a.id)) {
+                    byID.set(a.id, { ...a, placetype: a.placetype, country: a.country ?? "", score: 0 });
                 }
             }
         }
-        const hierarchy = [...byId.values()];
+        const hierarchy = [...byID.values()];
         if (opts.placetypes) {
             const allowed = new Set(opts.placetypes);
             for (let i = hierarchy.length - 1; i >= 0; i--) {
@@ -240,12 +239,11 @@ export class WofReverseGeocoder {
             .all(...params);
     }
     /**
-     * Descendants of `parentId` at one placetype tier, pre-filtered to a centroid window around the
-     * query point (a generous 4× the approximate cap — polygon-holding children may legitimately have
-     * far centroids, e.g. a sprawling consolidated city; the precise cap is applied per-candidate in
-     * the caller, and only to centroid-fallback steps).
+     * Descendants of `parentID` at one placetype tier, pre-filtered to a centroid window around the query point (a
+     * generous 4× the approximate cap — polygon-holding children may legitimately have far centroids, e.g. a sprawling
+     * consolidated city; the precise cap is applied per-candidate in the caller, and only to centroid-fallback steps).
      */
-    #descendants(parentId, placetype, lat, lon, maxApproximateKm) {
+    #descendants(parentID, placetype, lat, lon, maxApproximateKm) {
         const windowDeg = (maxApproximateKm * 4) / 111;
         return this.#admin
             .prepare(`SELECT s.id AS id, s.name AS name, s.placetype AS placetype, s.country AS country,
@@ -253,7 +251,7 @@ export class WofReverseGeocoder {
 				FROM ancestors a JOIN spr s ON s.id = a.id
 				WHERE a.ancestor_id = ? AND s.placetype = ? AND s.is_current != 0 AND s.is_deprecated = 0
 					AND s.latitude BETWEEN ? AND ? AND s.longitude BETWEEN ? AND ?`)
-            .all(parentId, placetype, lat - windowDeg, lat + windowDeg, lon - windowDeg, lon + windowDeg);
+            .all(parentID, placetype, lat - windowDeg, lat + windowDeg, lon - windowDeg, lon + windowDeg);
     }
     /** Parsed GeoJSON geometry for a WOF id, or null when absent / unparseable / no polygon DB. */
     #geometry(id) {
@@ -262,7 +260,7 @@ export class WofReverseGeocoder {
         const cached = this.#geometryCache.get(id);
         if (cached !== undefined)
             return cached;
-        if (this.#geometryCache.size >= WofReverseGeocoder.#GEOMETRY_CACHE_CAP)
+        if (this.#geometryCache.size >= WOFReverseGeocoder.#GEOMETRY_CACHE_CAP)
             this.#geometryCache.clear();
         const row = this.#polygons.prepare(`SELECT geom FROM polygons WHERE id = ?`).get(id);
         let geometry = null;