@mailwoman/resolver-wof-sqlite 10.0.0 → 10.2.0

package/out/reverse.d.ts

@@ -3,89 +3,110 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- *   Reverse geocoding (#484): `(lat, lon)` → the containing admin hierarchy. Assembly over existing
- *   implementation, per the 2026-06-11 scoping notes:
+ *   Reverse geocoding: map a `(lat, lon)` point to the containing admin hierarchy.
  *
- *   1. **Candidate fetch** — the admin DB's `place_bbox` R*Tree (built by `fts.ts`) for places whose
- *        bbox contains the point, smallest-area-first (so the FIRST polygon confirmation is the
- *        deepest).
- *   2. **PIP confirmation** — ray-cast (geo.ts, the canonical TS port of
- *        `scripts/eval/pip-containment.py`) against the polygon sidecar DB (`wof-polygons.db`,
- *        `polygons(id, geom)` with GeoJSON text — built by `scripts/build-wof-polygons.mjs` for the
- *        demo map). A candidate whose polygon EXISTS but rejects the point is a bbox false positive
- *        and is dropped entirely; a candidate with no polygon row stays eligible for the
- *        approximate fallback.
- *   3. **Approximate descent** — WOF carries point geometry for most localities (#292: ~99% of JP
- *        municipalities; ~half of US localities have degenerate bboxes too), so the polygon walk
- *        usually bottoms out at county level. We then descend tier-by-tier (county → localadmin →
- *        locality → …) through the winner's DESCENDANTS (the `ancestors` table, reversed), taking
- *        the PIP-confirmed child when a polygon exists and the nearest-centroid child otherwise —
- *        the latter flagged `containment: "approximate"`, the demo's honesty convention.
- *   4. **Hierarchy assembly** — the deepest place's ancestor chain via the SAME walk forward resolution
- *        uses (`ancestry.ts`, #404), so consumers get a symmetric tree.
+ *   1. Fetch the admin DB's `place_bbox` R*Tree candidates whose bbox contains the point,
+ *      smallest-area-first, so the first polygon confirmation is the deepest.
+ *   2. Confirm each candidate by ray-cast (geo.ts, the canonical TS port of
+ *      `scripts/eval/pip-containment.py`) against the polygon sidecar DB (`wof-polygons.db`,
+ *      `polygons(id, geom)` with GeoJSON text, built by `scripts/build-wof-polygons.mjs`). A
+ *      candidate whose polygon exists but rejects the point is a bbox false positive and is
+ *      dropped. A candidate with no polygon row stays eligible for the approximate fallback.
+ *   3. Descend tier-by-tier through the winner's descendants (the `ancestors` table, reversed),
+ *      taking the PIP-confirmed child when a polygon exists and the nearest-centroid child
+ *      otherwise. A centroid-fallback step is flagged `containment: "approximate"`.
+ *   4. Assemble the deepest place's ancestor chain through the same walk forward resolution uses,
+ *      so consumers get a symmetric tree.
  *
- *   Reverse quality is country-dependent (polygon coverage: see the #292 JP finding); `containment`
- *   says so per result rather than pretending.
+ *   Reverse quality is country-dependent, because polygon coverage is. `containment` records this per
+ *   result.
  */
 import { DatabaseClient } from "@mailwoman/sqlite/client";
+import type { PathBuilderLike } from "path-ts";
 import type { WOFDatabase } from "#schema";
 import type { PlaceCandidate, WOFPlacetype } from "#types";
 /**
  * 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.
+ * - `"polygon"`: the point ray-cast inside the place's real (DP-simplified) admin boundary.
+ * - `"approximate"`: the place has no polygon on record.
+ *   It returns the nearest-centroid candidate among places whose bbox or parent contains the point.
+ *   The demo's approximate circles use the same convention.
+ *   Both results expose country-dependent data coverage.
  */
 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.
+     * This is 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 kind of the deepest place in `hierarchy` (see {@link ContainmentKind}).
      */
     containment: ContainmentKind;
 }
 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 gazetteer build fts`). Mutually exclusive with `adminDatabase`.
+     * Path to the admin gazetteer DB (e.g. `admin-global-priority.db`).
+     *
+     * It must include `spr`, `ancestors`, and the package-built `place_bbox`
+     * R*Tree (`mailwoman gazetteer build fts`).
+     *
+     * Mutually exclusive with `adminDatabase`.
      */
-    adminDBPath?: string;
+    adminDBPath?: PathBuilderLike;
     /**
-     * Pre-opened admin DB — primarily for tests against an inline fixture.
+     * Pre-opened admin DB, primarily for tests against an inline fixture.
      */
     adminDatabase?: DatabaseClient<WOFDatabase>;
     /**
-     * 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?: PathBuilderLike;
     /**
-     * Pre-opened polygon DB — primarily for tests.
+     * Pre-opened polygon DB, primarily for tests.
      */
     polygonDatabase?: DatabaseClient<WOFDatabase>;
 }
 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).
+     *
+     * E.g.
+     *
+     * `["region", "county", "locality"]` to skip the neighborhood grain.
+     *
+     * @defaultValue every admin placetype in the gazetteer.
      */
     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.
+     *
+     * Current measurements show that this covers a dense metro.
+     *
+     * The most bbox-overlapping point we have measured is a few dozen neighborhoods plus the admin chain.
+     *
+     * @defaultValue `128`
      */
     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.
+     * The lookup skips approximate (nearest-centroid) steps farther than this from the query point.
+     *
+     * This keeps a sparse gazetteer from "refining" to a far-away sibling.
+     *
+     * Polygon-confirmed steps ignore it (containment is exact regardless of centroid distance).
+     *
+     * @defaultValue `25 km`
      */
     maxApproximateKm?: number;
 }
@@ -93,15 +114,22 @@ export declare class WOFReverseGeocoder implements Disposable {
     #private;
     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). Thin wrapper over {@link reverseGeocodeSync}.
+     * Resolve a WGS-84 point to its containing admin hierarchy.
+     *
+     * Async for symmetry with `PlaceLookup.findPlace`
+     * (the work is sync `node:sqlite` underneath, the same convention).
+     * Thin wrapper over {@link reverseGeocodeSync}.
      */
     reverseGeocode(lat: number, lon: number, opts?: ReverseGeocodeOpts): Promise<ReverseGeocodeResult>;
     /**
-     * Synchronous core of {@link reverseGeocode} — every step underneath is already sync `node:sqlite`, so this is the
-     * REAL implementation; the async method above exists only for call-site symmetry with `PlaceLookup.findPlace`.
-     * Exposed directly for callers that can't await mid-call (e.g. `mailwoman/poi-executor.ts`'s `createPOIExecutor`,
-     * whose `POIIntentOutcome` return type is synchronous by contract — see `poi-intent.ts`'s `deps.execute`).
+     * Synchronous core of {@link reverseGeocode}.
+     *
+     * Every step underneath is already sync `node:sqlite`, so this is the real implementation.
+     * The async method above exists only for call-site symmetry with `PlaceLookup.findPlace`.
+     *
+     * Exposed directly for callers that can't await mid-call
+     * (e.g. `mailwoman/poi-executor.ts`'s `createPOIExecutor`, whose `POIQueryResult`
+     * return type is synchronous by interface. See `poi-intent.ts`'s `deps.execute`).
      */
     reverseGeocodeSync(lat: number, lon: number, opts?: ReverseGeocodeOpts): ReverseGeocodeResult;
     [Symbol.dispose](): void;

package/out/reverse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reverse.d.ts","sourceRoot":"","sources":["../lib/reverse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAKH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAKzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AAW1D;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,aAAa,CAAA;AAEvD,MAAM,WAAW,oBAAoB;IACpC;;;;OAIG;IACH,SAAS,EAAE,cAAc,EAAE,CAAA;IAC3B;;OAEG;IACH,WAAW,EAAE,eAAe,CAAA;CAC5B;AAED,MAAM,WAAW,sBAAsB;IACtC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;OAEG;IACH,aAAa,CAAC,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;IAC3C;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;OAEG;IACH,eAAe,CAAC,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;CAC7C;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;AAkDD,qBAAa,kBAAmB,YAAW,UAAU;;IAcpD,YAAY,IAAI,EAAE,sBAAsB,EAqCvC;IAED;;;OAGG;IACG,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,kBAAuB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAE3G;IAED;;;;;OAKG;IACH,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,kBAAuB,GAAG,oBAAoB,CAmIhG;IA0FD,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAQvB;CACD"}
+{"version":3,"file":"reverse.d.ts","sourceRoot":"","sources":["../lib/reverse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAKH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAEzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAI9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AAW1D;;;;;;;;GAQG;AACH,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,aAAa,CAAA;AAEvD,MAAM,WAAW,oBAAoB;IACpC;;;;;;;OAOG;IACH,SAAS,EAAE,cAAc,EAAE,CAAA;IAC3B;;OAEG;IACH,WAAW,EAAE,eAAe,CAAA;CAC5B;AAED,MAAM,WAAW,sBAAsB;IACtC;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,eAAe,CAAA;IAC7B;;OAEG;IACH,aAAa,CAAC,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;IAC3C;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,eAAe,CAAA;IAC/B;;OAEG;IACH,eAAe,CAAC,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;CAC7C;AAED,MAAM,WAAW,kBAAkB;IAClC;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,YAAY,EAAE,CAAA;IAC3B;;;;;;;;OAQG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;;;;;;OAQG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;CACzB;AAgED,qBAAa,kBAAmB,YAAW,UAAU;;IAgBpD,YAAY,IAAI,EAAE,sBAAsB,EAsCvC;IAED;;;;;;OAMG;IACG,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,kBAAuB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAE3G;IAED;;;;;;;;;OASG;IACH,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,kBAAuB,GAAG,oBAAoB,CAiJhG;IA8FD,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAQvB;CACD"}

package/out/reverse.js

@@ -3,37 +3,31 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- *   Reverse geocoding (#484): `(lat, lon)` → the containing admin hierarchy. Assembly over existing
- *   implementation, per the 2026-06-11 scoping notes:
+ *   Reverse geocoding: map a `(lat, lon)` point to the containing admin hierarchy.
  *
- *   1. **Candidate fetch** — the admin DB's `place_bbox` R*Tree (built by `fts.ts`) for places whose
- *        bbox contains the point, smallest-area-first (so the FIRST polygon confirmation is the
- *        deepest).
- *   2. **PIP confirmation** — ray-cast (geo.ts, the canonical TS port of
- *        `scripts/eval/pip-containment.py`) against the polygon sidecar DB (`wof-polygons.db`,
- *        `polygons(id, geom)` with GeoJSON text — built by `scripts/build-wof-polygons.mjs` for the
- *        demo map). A candidate whose polygon EXISTS but rejects the point is a bbox false positive
- *        and is dropped entirely; a candidate with no polygon row stays eligible for the
- *        approximate fallback.
- *   3. **Approximate descent** — WOF carries point geometry for most localities (#292: ~99% of JP
- *        municipalities; ~half of US localities have degenerate bboxes too), so the polygon walk
- *        usually bottoms out at county level. We then descend tier-by-tier (county → localadmin →
- *        locality → …) through the winner's DESCENDANTS (the `ancestors` table, reversed), taking
- *        the PIP-confirmed child when a polygon exists and the nearest-centroid child otherwise —
- *        the latter flagged `containment: "approximate"`, the demo's honesty convention.
- *   4. **Hierarchy assembly** — the deepest place's ancestor chain via the SAME walk forward resolution
- *        uses (`ancestry.ts`, #404), so consumers get a symmetric tree.
+ *   1. Fetch the admin DB's `place_bbox` R*Tree candidates whose bbox contains the point,
+ *      smallest-area-first, so the first polygon confirmation is the deepest.
+ *   2. Confirm each candidate by ray-cast (geo.ts, the canonical TS port of
+ *      `scripts/eval/pip-containment.py`) against the polygon sidecar DB (`wof-polygons.db`,
+ *      `polygons(id, geom)` with GeoJSON text, built by `scripts/build-wof-polygons.mjs`). A
+ *      candidate whose polygon exists but rejects the point is a bbox false positive and is
+ *      dropped. A candidate with no polygon row stays eligible for the approximate fallback.
+ *   3. Descend tier-by-tier through the winner's descendants (the `ancestors` table, reversed),
+ *      taking the PIP-confirmed child when a polygon exists and the nearest-centroid child
+ *      otherwise. A centroid-fallback step is flagged `containment: "approximate"`.
+ *   4. Assemble the deepest place's ancestor chain through the same walk forward resolution uses,
+ *      so consumers get a symmetric tree.
  *
- *   Reverse quality is country-dependent (polygon coverage: see the #292 JP finding); `containment`
- *   says so per result rather than pretending.
+ *   Reverse quality is country-dependent, because polygon coverage is. `containment` records this per
+ *   result.
  */
 import { tryParsingJSON } from "@mailwoman/core/json";
 import { allRows } from "@mailwoman/core/utils";
 import { bboxAround, geometryContains, haversineKm } from "@mailwoman/spatial";
 import { DatabaseClient } from "@mailwoman/sqlite/client";
 import { tableExists } from "@mailwoman/sqlite/introspection";
-import { ancestorLineage, placetypeDepth } from "#ancestry/index";
-import { PLACE_BBOX_TABLE } from "#fts/index";
+import { ancestorLineage, placetypeDepth } from "#ancestry";
+import { PLACE_BBOX_TABLE } from "#fts";
 /**
  * Largest absolute latitude in WGS-84 degrees.
  */
@@ -45,8 +39,10 @@ const MAX_ABS_LONGITUDE = 180;
 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",
@@ -56,21 +52,34 @@ const DESCENT_TIERS = [
     "neighbourhood",
     "microhood",
 ];
-function toPlaceCandidate(row, distanceKm) {
-    const c = {
+const ABSENT_CANDIDATE_FIELDS = {
+    parent_id: null,
+    distanceKm: null,
+    exactMatch: null,
+    prominence: null,
+    population: null,
+    referential: null,
+    encyclopedic: null,
+    importance: null,
+    bbox: null,
+    mismatch: null,
+    containedByQualifier: null,
+    regionScopeMiss: null,
+    variantAliasExempted: null,
+};
+function toPlaceCandidate(row, distanceKm = null) {
+    return {
+        ...ABSENT_CANDIDATE_FIELDS,
         id: row.id,
         name: row.name,
         placetype: row.placetype,
         country: row.country ?? "",
         lat: row.lat,
         lon: row.lon,
-        parent_id: row.parent_id ?? undefined,
+        parent_id: row.parent_id ?? null,
         score: 0,
+        distanceKm,
     };
-    if (distanceKm !== undefined) {
-        c.distanceKm = distanceKm;
-    }
-    return c;
 }
 export class WOFReverseGeocoder {
     #admin;
@@ -78,10 +87,12 @@ export class WOFReverseGeocoder {
     #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, so caching the JSON.parse avoids repeated work.
+     * The cache is bounded and clears wholesale at the cap.
+     *
+     * The polygons are DP-simplified and small, so the cap only bounds a long-lived server process.
      */
     #geometryCache = new Map();
     static #GEOMETRY_CACHE_CAP = 4096;
@@ -101,8 +112,9 @@ export class WOFReverseGeocoder {
             opts.polygonDatabase ??
                 (opts.polygonDBPath ? new DatabaseClient(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.
+        // Fail loudly up front.
+        // The R*Tree is a build artifact and is not part of the upstream WOF distribution,
+        // so a missing index would otherwise surface as an opaque SQL error per query.
         if (!tableExists(this.#admin, PLACE_BBOX_TABLE)) {
             throw new Error(`WOFReverseGeocoder: the admin DB has no \`${PLACE_BBOX_TABLE}\` R*Tree. Build it with ` +
                 "`mailwoman gazetteer build fts <path-to-wof.db>` (see resolver-wof-sqlite/README.md).");
@@ -113,17 +125,24 @@ export class WOFReverseGeocoder {
         }
     }
     /**
-     * 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). Thin wrapper over {@link reverseGeocodeSync}.
+     * Resolve a WGS-84 point to its containing admin hierarchy.
+     *
+     * Async for symmetry with `PlaceLookup.findPlace`
+     * (the work is sync `node:sqlite` underneath, the same convention).
+     * Thin wrapper over {@link reverseGeocodeSync}.
      */
     async reverseGeocode(lat, lon, opts = {}) {
         return this.reverseGeocodeSync(lat, lon, opts);
     }
     /**
-     * Synchronous core of {@link reverseGeocode} — every step underneath is already sync `node:sqlite`, so this is the
-     * REAL implementation; the async method above exists only for call-site symmetry with `PlaceLookup.findPlace`.
-     * Exposed directly for callers that can't await mid-call (e.g. `mailwoman/poi-executor.ts`'s `createPOIExecutor`,
-     * whose `POIIntentOutcome` return type is synchronous by contract — see `poi-intent.ts`'s `deps.execute`).
+     * Synchronous core of {@link reverseGeocode}.
+     *
+     * Every step underneath is already sync `node:sqlite`, so this is the real implementation.
+     * The async method above exists only for call-site symmetry with `PlaceLookup.findPlace`.
+     *
+     * Exposed directly for callers that can't await mid-call
+     * (e.g. `mailwoman/poi-executor.ts`'s `createPOIExecutor`, whose `POIQueryResult`
+     * return type is synchronous by interface. See `poi-intent.ts`'s `deps.execute`).
      */
     reverseGeocodeSync(lat, lon, opts = {}) {
         if (!Number.isFinite(lat) ||
@@ -134,8 +153,9 @@ export class WOFReverseGeocoder {
         }
         const maxApproximateKm = opts.maxApproximateKm ?? DEFAULT_MAX_APPROXIMATE_KM;
         const candidates = this.#bboxCandidates(lat, lon, opts);
-        // PIP walk, smallest-bbox-first: the first polygon that contains the point is the deepest
-        // polygon-confirmable place. Polygon-rejected candidates are bbox false positives — dropped.
+        // PIP walk, smallest-bbox-first.
+        // The first polygon that contains the point is the deepest polygon-confirmable place.
+        // Drop candidates whose bounding boxes match but whose polygons reject the point.
         let winner = null;
         let winnerConfirmed = false;
         const pointOnly = [];
@@ -151,7 +171,7 @@ export class WOFReverseGeocoder {
             }
         }
         if (!winner) {
-            // No polygon confirmed anywhere — nearest centroid among the polygon-less bbox candidates.
+            // No polygon confirmed anywhere, so take the nearest centroid among the polygon-less bbox candidates.
             let bestKm = Infinity;
             for (const c of pointOnly) {
                 const km = haversineKm(lat, lon, c.lat, c.lon);
@@ -166,7 +186,7 @@ export class WOFReverseGeocoder {
         // Approximate descent into finer tiers than the winner.
         let current = winner;
         let currentConfirmed = winnerConfirmed;
-        let currentDistanceKm = currentConfirmed ? undefined : haversineKm(lat, lon, current.lat, current.lon);
+        let currentDistanceKm = currentConfirmed ? null : haversineKm(lat, lon, current.lat, current.lon);
         for (const tier of DESCENT_TIERS) {
             if (placetypeDepth(tier) <= placetypeDepth(current.placetype))
                 continue;
@@ -175,18 +195,18 @@ export class WOFReverseGeocoder {
             const kids = this.#descendants(current.id, tier, lat, lon, maxApproximateKm);
             let next = null;
             let nextConfirmed = false;
-            let nextKm;
+            let nextKm = null;
             let bestKm = Infinity;
             for (const k of kids) {
                 const contains = geometryContains(this.#geometry(k.id), lon, lat);
                 if (contains === true) {
                     next = k;
                     nextConfirmed = true;
-                    nextKm = undefined;
+                    nextKm = null;
                     break;
                 }
                 if (contains === false)
-                    continue; // known not-here — polygon rejected
+                    continue; // known not-here, polygon rejected
                 const km = haversineKm(lat, lon, k.lat, k.lon);
                 if (km <= maxApproximateKm && km < bestKm) {
                     bestKm = km;
@@ -200,22 +220,35 @@ export class WOFReverseGeocoder {
                 currentConfirmed = nextConfirmed;
                 currentDistanceKm = nextKm;
             }
-            // An empty tier is NOT terminal — counties without localadmins jump straight to locality.
+            // An empty tier is not terminal.
+            // Counties without localadmins jump straight to locality.
         }
-        // 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.
+        // 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([[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 });
+                byID.set(a.id, {
+                    ...ABSENT_CANDIDATE_FIELDS,
+                    ...a,
+                    placetype: a.placetype,
+                    country: a.country ?? "",
+                    score: 0,
+                });
             }
         }
         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 });
+                    byID.set(a.id, {
+                        ...ABSENT_CANDIDATE_FIELDS,
+                        ...a,
+                        placetype: a.placetype,
+                        country: a.country ?? "",
+                        score: 0,
+                    });
                 }
             }
         }
@@ -257,9 +290,12 @@ export class WOFReverseGeocoder {
 				LIMIT ?`), ...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, since polygon-holding
+     * children may legitimately have far centroids, e.g. a sprawling consolidated city).
+     *
+     * The caller applies the precise cap per candidate.
+     * It limits centroid-fallback steps only.
      */
     #descendants(parentID, placetype, lat, lon, maxApproximateKm) {
         const window = bboxAround(lat, lon, maxApproximateKm * 4);
@@ -282,7 +318,8 @@ export class WOFReverseGeocoder {
             this.#geometryCache.clear();
         }
         const row = this.#polygons.prepare(`SELECT geom FROM polygons WHERE id = ?`).get(id);
-        // Malformed row parses to null — treat as no-polygon rather than failing the query.
+        // Malformed row parses to null.
+        // Treat it as no-polygon so the query does not fail.
         const geometry = row ? tryParsingJSON(row.geom) : null;
         this.#geometryCache.set(id, geometry);
         return geometry;

package/out/reverse.js.map

@@ -1 +1 @@
-{"version":3,"file":"reverse.js","sourceRoot":"","sources":["../lib/reverse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAA;AAC/C,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,WAAW,EAAuB,MAAM,oBAAoB,CAAA;AACnG,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAE7D,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAG7C;;GAEG;AACH,MAAM,gBAAgB,GAAG,EAAE,CAAA;AAE3B;;GAEG;AACH,MAAM,iBAAiB,GAAG,GAAG,CAAA;AAiE7B,MAAM,sBAAsB,GAAG,GAAG,CAAA;AAClC,MAAM,0BAA0B,GAAG,EAAE,CAAA;AAErC;;;GAGG;AACH,MAAM,aAAa,GAA4B;IAC9C,QAAQ;IACR,YAAY;IACZ,UAAU;IACV,SAAS;IACT,eAAe;IACf,WAAW;CACX,CAAA;AAeD,SAAS,gBAAgB,CAAC,GAAiB,EAAE,UAAmB;IAC/D,MAAM,CAAC,GAAmB;QACzB,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,SAAS,EAAE,GAAG,CAAC,SAAyB;QACxC,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,EAAE;QAC1B,GAAG,EAAE,GAAG,CAAC,GAAG;QACZ,GAAG,EAAE,GAAG,CAAC,GAAG;QACZ,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,SAAS;QACrC,KAAK,EAAE,CAAC;KACR,CAAA;IAED,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC9B,CAAC,CAAC,UAAU,GAAG,UAAU,CAAA;IAC1B,CAAC;IAED,OAAO,CAAC,CAAA;AACT,CAAC;AAED,MAAM,OAAO,kBAAkB;IACrB,MAAM,CAA6B;IACnC,UAAU,CAAS;IACnB,SAAS,CAAoC;IAC7C,aAAa,CAAS;IAC/B;;;;;OAKG;IACM,cAAc,GAAG,IAAI,GAAG,EAAiC,CAAA;IAClE,MAAM,CAAU,mBAAmB,GAAG,IAAI,CAAA;IAE1C,YAAY,IAA4B;QACvC,IAAI,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CAAC,4EAA4E,CAAC,CAAA;QAC9F,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CAAC,yEAAyE,CAAC,CAAA;QAC3F,CAAC;QAED,IAAI,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CAAC,gFAAgF,CAAC,CAAA;QAClG,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,aAAa,IAAI,IAAI,cAAc,CAAc,IAAI,CAAC,WAAY,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAA;QAC1G,IAAI,CAAC,UAAU,GAAG,CAAC,IAAI,CAAC,aAAa,CAAA;QAErC,IAAI,CAAC,SAAS;YACb,IAAI,CAAC,eAAe;gBACpB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,cAAc,CAAc,IAAI,CAAC,aAAa,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;QAEtG,IAAI,CAAC,aAAa,GAAG,CAAC,IAAI,CAAC,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;QAEzE,sFAAsF;QACtF,8FAA8F;QAC9F,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,gBAAgB,CAAC,EAAE,CAAC;YACjD,MAAM,IAAI,KAAK,CACd,6CAA6C,gBAAgB,2BAA2B;gBACvF,uFAAuF,CACxF,CAAA;QACF,CAAC;QAED,IAAI,IAAI,CAAC,SAAS,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,EAAE,CAAC;YAChE,MAAM,IAAI,KAAK,CACd,2FAA2F;gBAC1F,0CAA0C,CAC3C,CAAA;QACF,CAAC;IACF,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,cAAc,CAAC,GAAW,EAAE,GAAW,EAAE,IAAI,GAAuB,EAAE;QAC3E,OAAO,IAAI,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAA;IAC/C,CAAC;IAED;;;;;OAKG;IACH,kBAAkB,CAAC,GAAW,EAAE,GAAW,EAAE,IAAI,GAAuB,EAAE;QACzE,IACC,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC;YACrB,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC;YACrB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,gBAAgB;YAChC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,iBAAiB,EAChC,CAAC;YACF,MAAM,IAAI,UAAU,CAAC,uCAAuC,GAAG,KAAK,GAAG,8BAA8B,CAAC,CAAA;QACvG,CAAC;QAED,MAAM,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,IAAI,0BAA0B,CAAA;QAC5E,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAA;QAEvD,0FAA0F;QAC1F,6FAA6F;QAC7F,IAAI,MAAM,GAAwB,IAAI,CAAA;QACtC,IAAI,eAAe,GAAG,KAAK,CAAA;QAC3B,MAAM,SAAS,GAAmB,EAAE,CAAA;QAEpC,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;YAEjE,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;gBACvB,MAAM,GAAG,CAAC,CAAA;gBACV,eAAe,GAAG,IAAI,CAAA;gBAEtB,MAAK;YACN,CAAC;YAED,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;gBACvB,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YAClB,CAAC;QACF,CAAC;QAED,IAAI,CAAC,MAAM,EAAE,CAAC;YACb,2FAA2F;YAC3F,IAAI,MAAM,GAAG,QAAQ,CAAA;YAErB,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;gBAC3B,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,CAAA;gBAE9C,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC;oBACjB,MAAM,GAAG,EAAE,CAAA;oBACX,MAAM,GAAG,CAAC,CAAA;gBACX,CAAC;YACF,CAAC;YAED,IAAI,CAAC,MAAM;gBAAE,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,WAAW,EAAE,aAAa,EAAE,CAAA;QAClE,CAAC;QAED,wDAAwD;QACxD,IAAI,OAAO,GAAG,MAAM,CAAA;QACpB,IAAI,gBAAgB,GAAG,eAAe,CAAA;QACtC,IAAI,iBAAiB,GAAG,gBAAgB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,CAAA;QAEtG,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;YAClC,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,cAAc,CAAC,OAAO,CAAC,SAAS,CAAC;gBAAE,SAAQ;YAEvE,IAAI,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAAE,SAAQ;YAChE,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,gBAAgB,CAAC,CAAA;YAC5E,IAAI,IAAI,GAAwB,IAAI,CAAA;YACpC,IAAI,aAAa,GAAG,KAAK,CAAA;YACzB,IAAI,MAA0B,CAAA;YAC9B,IAAI,MAAM,GAAG,QAAQ,CAAA;YAErB,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;gBACtB,MAAM,QAAQ,GAAG,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;gBAEjE,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;oBACvB,IAAI,GAAG,CAAC,CAAA;oBACR,aAAa,GAAG,IAAI,CAAA;oBACpB,MAAM,GAAG,SAAS,CAAA;oBAElB,MAAK;gBACN,CAAC;gBAED,IAAI,QAAQ,KAAK,KAAK;oBAAE,SAAQ,CAAC,oCAAoC;gBACrE,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,CAAA;gBAE9C,IAAI,EAAE,IAAI,gBAAgB,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC;oBAC3C,MAAM,GAAG,EAAE,CAAA;oBACX,IAAI,GAAG,CAAC,CAAA;oBACR,aAAa,GAAG,KAAK,CAAA;oBACrB,MAAM,GAAG,EAAE,CAAA;gBACZ,CAAC;YACF,CAAC;YAED,IAAI,IAAI,EAAE,CAAC;gBACV,OAAO,GAAG,IAAI,CAAA;gBACd,gBAAgB,GAAG,aAAa,CAAA;gBAChC,iBAAiB,GAAG,MAAM,CAAA;YAC3B,CAAC;YACD,0FAA0F;QAC3F,CAAC;QAED,0FAA0F;QAC1F,4FAA4F;QAC5F,mEAAmE;QACnE,MAAM,IAAI,GAAG,IAAI,GAAG,CAAyB,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAA;QAE1G,KAAK,MAAM,CAAC,IAAI,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;YAC1D,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;gBACrB,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,SAAyB,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAA;YACrG,CAAC;QACF,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAA;YAE7C,KAAK,MAAM,CAAC,IAAI,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;gBACzD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;oBACrB,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,SAAyB,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAA;gBACrG,CAAC;YACF,CAAC;QACF,CAAC;QAED,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAA;QAEpC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,MAAM,OAAO,GAAG,IAAI,GAAG,CAAS,IAAI,CAAC,UAAU,CAAC,CAAA;YAEhD,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBAChD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAE,CAAC,SAAS,CAAC,EAAE,CAAC;oBAC3C,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;gBACvB,CAAC;YACF,CAAC;QACF,CAAC;QAED,SAAS,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;QAEnF,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,gBAAgB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,EAAE,CAAA;IAChF,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,GAAW,EAAE,GAAW,EAAE,IAAwB;QACjE,MAAM,KAAK,GAAa;YACvB,mBAAmB;YACnB,mBAAmB;YACnB,mBAAmB;YACnB,mBAAmB;YACnB,qBAAqB;YACrB,uBAAuB;SACvB,CAAA;QAED,MAAM,MAAM,GAA2B,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;QAE3D,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;YAC/C,KAAK,CAAC,IAAI,CAAC,qBAAqB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YAC7E,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAA;QAChC,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,IAAI,sBAAsB,CAAC,CAAA;QAEzD,OAAO,OAAO,CACb,IAAI,CAAC,MAAM,CAAC,OAAO,CAClB;;WAEO,gBAAgB;YACf,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC;;YAEnB,CACR,EACD,GAAG,MAAM,CACT,CAAA;IACF,CAAC;IAED;;;;OAIG;IACH,YAAY,CACX,QAAgB,EAChB,SAAiB,EACjB,GAAW,EACX,GAAW,EACX,gBAAwB;QAExB,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,gBAAgB,GAAG,CAAC,CAAC,CAAA;QAEzD,OAAO,OAAO,CACb,IAAI,CAAC,MAAM,CAAC,OAAO,CAClB;;;;oEAIgE,CAChE,EACD,QAAQ,EACR,SAAS,EACT,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,MAAM,CACb,CAAA;IACF,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,EAAU;QACnB,IAAI,CAAC,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAA;QAChC,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QAE1C,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,MAAM,CAAA;QAEvC,IAAI,IAAI,CAAC,cAAc,CAAC,IAAI,IAAI,kBAAkB,CAAC,mBAAmB,EAAE,CAAC;YACxE,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAA;QAC5B,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,wCAAwC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAiC,CAAA;QACpH,oFAAoF;QACpF,MAAM,QAAQ,GAAG,GAAG,CAAC,CAAC,CAAC,cAAc,CAAiB,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;QAEtE,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAA;QAErC,OAAO,QAAQ,CAAA;IAChB,CAAC;IAED,CAAC,MAAM,CAAC,OAAO,CAAC;QACf,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAA;QACtB,CAAC;QAED,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,CAAA;QAC1B,CAAC;IACF,CAAC;CACD"}
+{"version":3,"file":"reverse.js","sourceRoot":"","sources":["../lib/reverse.ts"],"names":[],"mappings":"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"}