@mailwoman/resolver-wof-sqlite 9.4.0 → 10.1.0

package/out/convention/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../lib/convention/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAuCH;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAuB;IAChD,mBAAmB,EAAE,CAAC,0BAA0B,EAAE,2BAA2B,CAAC;IAC9E,cAAc,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE;CAChD,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,0BAA0B,EAAE,2BAA2B,CAAU,CAAA;AAExG;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,oBAAoB,CAAA;AAe5D;;;;GAIG;AACH,MAAM,OAAO,oBAAoB;IACvB,KAAK,CAAyB;IAEvC,YAAY,OAAmC,EAAE;QAChD,IAAI,CAAC,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;IAC3E,CAAC;IAED,GAAG,CAAC,KAAa;QAChB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IAC7B,CAAC;CACD;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAgB,EAAE,GAAG,SAAwC;IAC7F,MAAM,GAAG,GAAe;QACvB,mBAAmB,EAAE,IAAI,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,SAAS;QACzF,cAAc,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,SAAS;KAC5E,CAAA;IAED,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC3B,IAAI,CAAC,CAAC;YAAE,SAAQ;QAEhB,IAAI,CAAC,CAAC,mBAAmB,KAAK,SAAS,EAAE,CAAC;YACzC,GAAG,CAAC,mBAAmB,GAAG,CAAC,GAAG,CAAC,CAAC,mBAAmB,CAAC,CAAA;QACrD,CAAC;QAED,IAAI,CAAC,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;YACpC,GAAG,CAAC,cAAc,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,cAAc,IAAI,aAAa,CAAC,cAAc,CAAC,EAAE,GAAG,CAAC,CAAC,cAAc,EAAE,CAAA;QACtG,CAAC;IACF,CAAC;IAED,OAAO,GAAG,CAAA;AACX,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAwB,EAAE,WAA8B;IACzF,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAA;IACtD,MAAM,MAAM,GAAG,gBAAgB,CAAC,aAAa,EAAE,GAAG,MAAM,CAAC,CAAA;IAEzD,OAAO;QACN,mBAAmB,EAAE,MAAM,CAAC,mBAAmB,IAAI,aAAa,CAAC,mBAAmB;QACpF,8EAA8E;QAC9E,cAAc,EAAE,EAAE,GAAG,aAAa,CAAC,cAAc,EAAE,GAAG,MAAM,CAAC,cAAc,EAAE;KAC7E,CAAA;AACF,CAAC"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../lib/fst/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,mBAAmB,CAAA;AACjC,cAAc,cAAc,CAAA;AAC5B,cAAc,sBAAsB,CAAA;AACpC,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA"}

package/out/fst/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../lib/fst/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,mBAAmB,CAAA;AACjC,cAAc,cAAc,CAAA;AAC5B,cAAc,sBAAsB,CAAA;AACpC,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA"}

package/out/fts/index.d.ts

@@ -1,184 +0,0 @@
-/**
- * @copyright Sister Software
- * @license AGPL-3.0
- * @author Teffen Ellis, et al.
- *
- *   FTS5 index lifecycle for the WOF SQLite distribution.
- *
- *   Shared by `WOFSQLitePlaceLookup` (lazy build via `buildFTS: true`) and the operator-side
- *   `mailwoman gazetteer build fts` CLI (ahead-of-time build to avoid first-open latency in production).
- *
- *   Upstream WOF SQLite distributions do NOT ship FTS5. The index lives in a `place_search` virtual
- *   table whose rows mirror `(spr.id, spr.name, GROUP_CONCAT(names.name))` — one current,
- *   non-deprecated place per row, with all alternate names concatenated into a single search-token
- *   bag.
- */
-import type { DatabaseClient } from "@mailwoman/sqlite/client";
-/**
- * Name of the FTS5 virtual table this module owns. Centralized so `WOFSQLitePlaceLookup` and the CLI can't drift apart.
- */
-export declare const PLACE_SEARCH_TABLE = "place_search";
-/**
- * Boundary-preserving separator between aliases in the `alt_names` bag (#523): U+E000, the first Private Use Area
- * codepoint, written as an escape so the source stays plain ASCII.
- *
- * Why a PUA codepoint and not punctuation: the goal is to stop a phrase query from matching ACROSS two adjacent
- * aliases' concatenation boundary ("York" + "New City" must not phrase-match `"york new"`). FTS5 assigns token
- * positions to TOKENS only — separator characters never consume a position — so any character the tokenizer treats as a
- * boundary leaves the two aliases' tokens adjacent and the false phrase match intact. The separator must therefore be
- * an INDEXED TOKEN that sits between the aliases and breaks positional adjacency.
- *
- * Empirical probe (node:sqlite, `tokenize = 'unicode61 remove_diacritics 2'` — the exact config below). Bag = the
- * aliases "York" and "New City" joined by each candidate separator; query = the cross-boundary phrase `MATCH '"york
- * new"'`:
- *
- * - `' '` (the pre-#523 join, no separator) — false HIT
- * - `' ; '` (punctuation) — false HIT
- * - `' \u2016 '` (double vertical line) — false HIT
- * - `' \x1F '` (ASCII unit separator) — false HIT
- * - `' \uE000 '` (PUA, this constant) — NO match, while `'"york"'` and `'"new city"'` still match the bag individually
- *   under every variant above.
- *
- * U+E000 works because unicode61 classifies it (category Co — neither space nor punctuation) as a token character, so
- * the standalone `\uE000` between aliases is indexed as its own token and the aliases' tokens are no longer
- * positionally adjacent. The remaining requirements also hold:
- *
- * - **Unreachable from queries**: `sanitizeFTSQuery` (Node + WASM resolvers) strips everything outside `\p{L}\p{N}` from
- *   token bodies, and U+E000 is neither — no user query can ever address the separator token. The demo's `sanitizeFTS`
- *   strips it explicitly.
- * - **Never in place names**: PUA codepoints are unassigned by definition; real-world WOF names don't carry them.
- *   Defensively, the INSERT below also strips any embedded U+E000 from source names so a poisoned row can't forge an
- *   alias boundary.
- * - **Survives GROUP_CONCAT**: verified — `GROUP_CONCAT(name, ' ' || char(57344) || ' ')` emits the codepoint intact
- *   (`57344` = 0xE000).
- * - **Cost**: one extra token per alias boundary in the FTS document. Marginal BM25 length-norm impact, on a column whose
- *   length stats are already the known #189 problem.
- *
- * Interaction with #189 (split `alt_names` into its own FTS table for independent BM25 length stats): the separator
- * SURVIVES that split as proposed — #189 still GROUP_CONCATs all aliases into one `place_search_alt` row per place, so
- * both the separator and the bag-parsing exact check (`aliasBagExactMatch`) carry over unchanged, just pointed at the
- * new table. Only if #189 were instead built as one-row-per-alias would both become moot (per-alias rows give exact
- * equality and phrase isolation for free). Sequencing: if #189 lands before the next slim-DB artifact rebuild, fold
- * both into ONE rebuild rather than shipping two FTS schema bumps.
- */
-export declare const ALIAS_SEPARATOR = "\uE000";
-/**
- * The query/name fold every exact-tier comparison uses: lowercase, trim, collapse internal whitespace. The `alt_names`
- * bag is compared alias-by-alias against a query folded THIS way, so the fold lives beside the bag parser — every
- * consumer (the Node resolver's exact tier, the WASM resolver, the name-exact sub-tier sort) folds through this one
- * function.
- */
-export declare function foldQueryText(input: string): string;
-/**
- * Does any alias in an `alt_names` bag exactly equal the (already-normalized) query? The single shared implementation
- * of the exact-tier alias check for every consumer of the bag — the Node resolver's `#exactMatchIDs` fallback, the WASM
- * resolver, and the demo's httpvfs resolver — so the bag format and its parsers can't drift.
- *
- * Two formats exist in the wild:
- *
- * - **Separated bags** (built since #523): aliases joined with {@link ALIAS_SEPARATOR}, plus a trailing separator so even
- *   a single-alias bag self-identifies as separator-formatted. Split + per-alias equality — a true exact-alias check,
- *   matching the semantics of the full `names` table (`names.name = ? COLLATE NOCASE`), so it runs unrestricted: an
- *   alias match is an exact match whether or not another candidate matched on its canonical name.
- * - **Legacy bags** (pre-#523 artifacts, e.g. an already-deployed slim DB): aliases space-joined, boundaries lost. Falls
- *   back to the historical padded-containment check, conditioned on `anyStrictExact` — unrestricted containment would
- *   false-promote interior fragments ("York" inside the alias "New York City") and cross-boundary fragments ("York New"
- *   across "…York" + "New…"). Delete this branch once every shipped artifact carries the separator.
- *
- * @param altNames The `alt_names` bag from `place_search` (null when the row has no aliases).
- * @param normalizedQuery The query, pre-normalized: lowercased, trimmed, internal whitespace collapsed (every consumer
- *   already normalizes this way).
- * @param anyStrictExact Whether ANY candidate in the pool already matched strictly (canonical name or region
- *   abbreviation). Only consulted for legacy bags.
- */
-export declare function aliasBagExactMatch(altNames: string | null, normalizedQuery: string, anyStrictExact: boolean): boolean;
-/**
- * Name of the R*Tree virtual table that indexes WOF places' bounding boxes for proximity / bbox lookups. Built
- * alongside `place_search` by the CLI and `buildFTS: true`. Pure SQLite — no extensions needed, the `rtree`
- * virtual-table module ships with the core library.
- */
-export declare const PLACE_BBOX_TABLE = "place_bbox";
-/**
- * Name of the auxiliary table holding `wof:population` per place. Powers the population-weighted ranking boost. Sparse
- * — WOF only populates this field for ~15% of localities (and mostly larger ones); missing means no boost, never a
- * penalty. Built upstream by `scripts/build-unified-wof.ts` at ingest (and copied through by `build-slim`) — this
- * module consumes it, never builds it.
- *
- * Schema: `(id INTEGER PRIMARY KEY, population INTEGER NOT NULL)`. Plain table, not virtual.
- */
-export declare const PLACE_POPULATION_TABLE = "place_population";
-/**
- * Name of the auxiliary table holding the two salience scores per place — `referential` (population-anchored, the
- * ranking backbone) and `encyclopedic` (the Wikipedia join, NULL when there is no article). Built by `mailwoman
- * gazetteer importance`; schema and derivations in `place-importance-schema.ts`.
- *
- * The lookup reads ONLY `encyclopedic` from it, and only to CARRY the value onto the result — referential is derived
- * from the population already joined, and no ORDER BY anywhere touches this table (ROAD_TO_V9 §2). Sparse and
- * schema-versioned: a pre-split gazetteer has this table with a single conflated `importance` column instead, which the
- * lookup's column probe deliberately refuses to read.
- */
-export declare const PLACE_IMPORTANCE_TABLE = "place_importance";
-/**
- * Counters for a single `buildPlaceSearchFTS` run. Exposed so callers (CLI, lazy-build) can render progress to the
- * user.
- */
-export interface BuildPlaceSearchFTSResult {
-    /**
-     * Whether the FTS5 index was created (true) or already existed and was left alone (false).
-     */
-    created: boolean;
-    /**
-     * Number of rows in the `place_search` table after the call.
-     */
-    indexedRows: number;
-    /**
-     * Whether the R*Tree bbox index was created (true) or already existed (false).
-     */
-    bboxCreated: boolean;
-    /**
-     * Number of rows in the `place_bbox` R*Tree after the call.
-     */
-    bboxIndexedRows: number;
-    /**
-     * Wall-clock duration of the build step, in milliseconds.
-     */
-    durationMs: number;
-}
-export interface BuildPlaceSearchFTSOpts {
-    /**
-     * Drop the existing `place_search` AND `place_bbox` tables before building. Default false — if either already exists
-     * the corresponding build step is skipped. Set true when you want to rebuild against an updated `spr` / `names`
-     * snapshot.
-     */
-    drop?: boolean;
-    /**
-     * Optional progress callback invoked after each phase. Useful for CLI output on the planet-scale builds where the
-     * INSERT step can take minutes.
-     */
-    onProgress?: (phase: "checking" | "dropping" | "creating" | "populating" | "creating-bbox" | "populating-bbox" | "done", detail?: string) => void;
-}
-/**
- * Build (or rebuild, with `drop: true`) the `place_search` FTS5 virtual table AND the `place_bbox` R*Tree virtual table
- * from the existing `spr` + `names` tables in a WOF SQLite distribution.
- *
- * The FTS5 index is used for name-based MATCH queries; the R*Tree is used for bbox + proximity filtering. Both are pure
- * SQLite — no extensions required.
- *
- * Returns a `BuildPlaceSearchFTSResult` summary. Idempotent when `drop: false` — re-running against an already-indexed
- * DB skips whichever indexes already exist.
- */
-export declare function buildPlaceSearchFTS<DB>(db: DatabaseClient<DB>, opts?: BuildPlaceSearchFTSOpts): BuildPlaceSearchFTSResult;
-/**
- * Returns true iff the `place_search` table exists in the connected DB. Used by `WOFSQLitePlaceLookup` for its "FTS
- * missing — pass buildFTS:true or run the CLI" guard.
- */
-export declare function placeSearchFTSExists<DB>(db: DatabaseClient<DB>): boolean;
-/**
- * Returns true iff the `place_bbox` R*Tree table exists. Used for opt-in proximity lookup checks.
- */
-export declare function placeBboxExists<DB>(db: DatabaseClient<DB>): boolean;
-/**
- * Returns true iff the `place_population` table exists. Used for opt-in population-ranking checks.
- */
-export declare function placePopulationExists<DB>(db: DatabaseClient<DB>): boolean;
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../lib/fts/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAG9D;;GAEG;AACH,eAAO,MAAM,kBAAkB,iBAAiB,CAAA;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,eAAO,MAAM,eAAe,WAAW,CAAA;AAOvC;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,GAAG,OAAO,CAUrH;AAED;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,eAAe,CAAA;AAE5C;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,qBAAqB,CAAA;AAExD;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB,qBAAqB,CAAA;AAExD;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACzC;;OAEG;IACH,OAAO,EAAE,OAAO,CAAA;IAChB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAA;IACnB;;OAEG;IACH,WAAW,EAAE,OAAO,CAAA;IACpB;;OAEG;IACH,eAAe,EAAE,MAAM,CAAA;IACvB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,uBAAuB;IACvC;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,CAAA;IACd;;;OAGG;IACH,UAAU,CAAC,EAAE,CACZ,KAAK,EAAE,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,YAAY,GAAG,eAAe,GAAG,iBAAiB,GAAG,MAAM,EACzG,MAAM,CAAC,EAAE,MAAM,KACX,IAAI,CAAA;CACT;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EACrC,EAAE,EAAE,cAAc,CAAC,EAAE,CAAC,EACtB,IAAI,GAAE,uBAA4B,GAChC,yBAAyB,CAsI3B;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,EAAE,EAAE,cAAc,CAAC,EAAE,CAAC,GAAG,OAAO,CAExE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,EAAE,EAAE,cAAc,CAAC,EAAE,CAAC,GAAG,OAAO,CAEnE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,EAAE,EAAE,cAAc,CAAC,EAAE,CAAC,GAAG,OAAO,CAEzE"}

package/out/fts/index.js

@@ -1,277 +0,0 @@
-/**
- * @copyright Sister Software
- * @license AGPL-3.0
- * @author Teffen Ellis, et al.
- *
- *   FTS5 index lifecycle for the WOF SQLite distribution.
- *
- *   Shared by `WOFSQLitePlaceLookup` (lazy build via `buildFTS: true`) and the operator-side
- *   `mailwoman gazetteer build fts` CLI (ahead-of-time build to avoid first-open latency in production).
- *
- *   Upstream WOF SQLite distributions do NOT ship FTS5. The index lives in a `place_search` virtual
- *   table whose rows mirror `(spr.id, spr.name, GROUP_CONCAT(names.name))` — one current,
- *   non-deprecated place per row, with all alternate names concatenated into a single search-token
- *   bag.
- */
-import { tableExists } from "@mailwoman/sqlite/introspection";
-/**
- * Name of the FTS5 virtual table this module owns. Centralized so `WOFSQLitePlaceLookup` and the CLI can't drift apart.
- */
-export const PLACE_SEARCH_TABLE = "place_search";
-/**
- * Boundary-preserving separator between aliases in the `alt_names` bag (#523): U+E000, the first Private Use Area
- * codepoint, written as an escape so the source stays plain ASCII.
- *
- * Why a PUA codepoint and not punctuation: the goal is to stop a phrase query from matching ACROSS two adjacent
- * aliases' concatenation boundary ("York" + "New City" must not phrase-match `"york new"`). FTS5 assigns token
- * positions to TOKENS only — separator characters never consume a position — so any character the tokenizer treats as a
- * boundary leaves the two aliases' tokens adjacent and the false phrase match intact. The separator must therefore be
- * an INDEXED TOKEN that sits between the aliases and breaks positional adjacency.
- *
- * Empirical probe (node:sqlite, `tokenize = 'unicode61 remove_diacritics 2'` — the exact config below). Bag = the
- * aliases "York" and "New City" joined by each candidate separator; query = the cross-boundary phrase `MATCH '"york
- * new"'`:
- *
- * - `' '` (the pre-#523 join, no separator) — false HIT
- * - `' ; '` (punctuation) — false HIT
- * - `' \u2016 '` (double vertical line) — false HIT
- * - `' \x1F '` (ASCII unit separator) — false HIT
- * - `' \uE000 '` (PUA, this constant) — NO match, while `'"york"'` and `'"new city"'` still match the bag individually
- *   under every variant above.
- *
- * U+E000 works because unicode61 classifies it (category Co — neither space nor punctuation) as a token character, so
- * the standalone `\uE000` between aliases is indexed as its own token and the aliases' tokens are no longer
- * positionally adjacent. The remaining requirements also hold:
- *
- * - **Unreachable from queries**: `sanitizeFTSQuery` (Node + WASM resolvers) strips everything outside `\p{L}\p{N}` from
- *   token bodies, and U+E000 is neither — no user query can ever address the separator token. The demo's `sanitizeFTS`
- *   strips it explicitly.
- * - **Never in place names**: PUA codepoints are unassigned by definition; real-world WOF names don't carry them.
- *   Defensively, the INSERT below also strips any embedded U+E000 from source names so a poisoned row can't forge an
- *   alias boundary.
- * - **Survives GROUP_CONCAT**: verified — `GROUP_CONCAT(name, ' ' || char(57344) || ' ')` emits the codepoint intact
- *   (`57344` = 0xE000).
- * - **Cost**: one extra token per alias boundary in the FTS document. Marginal BM25 length-norm impact, on a column whose
- *   length stats are already the known #189 problem.
- *
- * Interaction with #189 (split `alt_names` into its own FTS table for independent BM25 length stats): the separator
- * SURVIVES that split as proposed — #189 still GROUP_CONCATs all aliases into one `place_search_alt` row per place, so
- * both the separator and the bag-parsing exact check (`aliasBagExactMatch`) carry over unchanged, just pointed at the
- * new table. Only if #189 were instead built as one-row-per-alias would both become moot (per-alias rows give exact
- * equality and phrase isolation for free). Sequencing: if #189 lands before the next slim-DB artifact rebuild, fold
- * both into ONE rebuild rather than shipping two FTS schema bumps.
- */
-export const ALIAS_SEPARATOR = "\uE000";
-/**
- * `char()` argument for {@link ALIAS_SEPARATOR} in SQL — keeps the SQL text plain ASCII.
- */
-const ALIAS_SEPARATOR_CODEPOINT = ALIAS_SEPARATOR.codePointAt(0);
-/**
- * The query/name fold every exact-tier comparison uses: lowercase, trim, collapse internal whitespace. The `alt_names`
- * bag is compared alias-by-alias against a query folded THIS way, so the fold lives beside the bag parser — every
- * consumer (the Node resolver's exact tier, the WASM resolver, the name-exact sub-tier sort) folds through this one
- * function.
- */
-export function foldQueryText(input) {
-    return input.toLowerCase().trim().replaceAll(/\s+/g, " ");
-}
-/**
- * Does any alias in an `alt_names` bag exactly equal the (already-normalized) query? The single shared implementation
- * of the exact-tier alias check for every consumer of the bag — the Node resolver's `#exactMatchIDs` fallback, the WASM
- * resolver, and the demo's httpvfs resolver — so the bag format and its parsers can't drift.
- *
- * Two formats exist in the wild:
- *
- * - **Separated bags** (built since #523): aliases joined with {@link ALIAS_SEPARATOR}, plus a trailing separator so even
- *   a single-alias bag self-identifies as separator-formatted. Split + per-alias equality — a true exact-alias check,
- *   matching the semantics of the full `names` table (`names.name = ? COLLATE NOCASE`), so it runs unrestricted: an
- *   alias match is an exact match whether or not another candidate matched on its canonical name.
- * - **Legacy bags** (pre-#523 artifacts, e.g. an already-deployed slim DB): aliases space-joined, boundaries lost. Falls
- *   back to the historical padded-containment check, conditioned on `anyStrictExact` — unrestricted containment would
- *   false-promote interior fragments ("York" inside the alias "New York City") and cross-boundary fragments ("York New"
- *   across "…York" + "New…"). Delete this branch once every shipped artifact carries the separator.
- *
- * @param altNames The `alt_names` bag from `place_search` (null when the row has no aliases).
- * @param normalizedQuery The query, pre-normalized: lowercased, trimmed, internal whitespace collapsed (every consumer
- *   already normalizes this way).
- * @param anyStrictExact Whether ANY candidate in the pool already matched strictly (canonical name or region
- *   abbreviation). Only consulted for legacy bags.
- */
-export function aliasBagExactMatch(altNames, normalizedQuery, anyStrictExact) {
-    if (altNames === null || altNames === "" || !normalizedQuery)
-        return false;
-    if (altNames.includes(ALIAS_SEPARATOR)) {
-        return altNames.split(ALIAS_SEPARATOR).some((alias) => foldQueryText(alias) === normalizedQuery);
-    }
-    if (anyStrictExact)
-        return false;
-    return ` ${foldQueryText(altNames)} `.includes(` ${normalizedQuery} `);
-}
-/**
- * Name of the R*Tree virtual table that indexes WOF places' bounding boxes for proximity / bbox lookups. Built
- * alongside `place_search` by the CLI and `buildFTS: true`. Pure SQLite — no extensions needed, the `rtree`
- * virtual-table module ships with the core library.
- */
-export const PLACE_BBOX_TABLE = "place_bbox";
-/**
- * Name of the auxiliary table holding `wof:population` per place. Powers the population-weighted ranking boost. Sparse
- * — WOF only populates this field for ~15% of localities (and mostly larger ones); missing means no boost, never a
- * penalty. Built upstream by `scripts/build-unified-wof.ts` at ingest (and copied through by `build-slim`) — this
- * module consumes it, never builds it.
- *
- * Schema: `(id INTEGER PRIMARY KEY, population INTEGER NOT NULL)`. Plain table, not virtual.
- */
-export const PLACE_POPULATION_TABLE = "place_population";
-/**
- * Name of the auxiliary table holding the two salience scores per place — `referential` (population-anchored, the
- * ranking backbone) and `encyclopedic` (the Wikipedia join, NULL when there is no article). Built by `mailwoman
- * gazetteer importance`; schema and derivations in `place-importance-schema.ts`.
- *
- * The lookup reads ONLY `encyclopedic` from it, and only to CARRY the value onto the result — referential is derived
- * from the population already joined, and no ORDER BY anywhere touches this table (ROAD_TO_V9 §2). Sparse and
- * schema-versioned: a pre-split gazetteer has this table with a single conflated `importance` column instead, which the
- * lookup's column probe deliberately refuses to read.
- */
-export const PLACE_IMPORTANCE_TABLE = "place_importance";
-/**
- * Build (or rebuild, with `drop: true`) the `place_search` FTS5 virtual table AND the `place_bbox` R*Tree virtual table
- * from the existing `spr` + `names` tables in a WOF SQLite distribution.
- *
- * The FTS5 index is used for name-based MATCH queries; the R*Tree is used for bbox + proximity filtering. Both are pure
- * SQLite — no extensions required.
- *
- * Returns a `BuildPlaceSearchFTSResult` summary. Idempotent when `drop: false` — re-running against an already-indexed
- * DB skips whichever indexes already exist.
- */
-export function buildPlaceSearchFTS(db, opts = {}) {
-    const start = Date.now();
-    const onProgress = opts.onProgress ?? (() => { });
-    onProgress("checking");
-    const ftsExisting = tableExists(db, PLACE_SEARCH_TABLE);
-    const bboxExisting = tableExists(db, PLACE_BBOX_TABLE);
-    // ─── FTS5 phase ──────────────────────────────────────────────────
-    let ftsCreated = false;
-    if (ftsExisting && opts.drop) {
-        onProgress("dropping", PLACE_SEARCH_TABLE);
-        db.exec(`DROP TABLE ${PLACE_SEARCH_TABLE}`);
-    }
-    if (!ftsExisting || opts.drop) {
-        onProgress("creating");
-        db.exec(`
-			CREATE VIRTUAL TABLE ${PLACE_SEARCH_TABLE} USING fts5(
-				wof_id UNINDEXED,
-				name,
-				alt_names,
-				tokenize = 'unicode61 remove_diacritics 2'
-			);
-		`);
-        onProgress("populating");
-        // Excludes only definitively-not-current places. WOF's `is_current` carries TWO conventions:
-        // `-1` (modern Who's On First) and `1` (legacy Mapzen-era), both meaning "currently valid".
-        // Only `0` means "no longer current". Filtering on `= -1` strict (as Phase 4.2 did) excluded
-        // ~42% of admin-US and ~68% of postcode-US — see #91 for the diagnostic + magnitude.
-        //
-        // Aliases join on the boundary-preserving ALIAS_SEPARATOR token (#523) — space-padded so each
-        // alias still tokenizes normally — and any U+E000 embedded in a source name is defensively
-        // flattened to a space so it can't forge a boundary. A TRAILING separator marks the bag as
-        // separator-formatted even when it holds a single alias, so `aliasBagExactMatch` never
-        // mistakes a new bag for a legacy (pre-#523) one. See the ALIAS_SEPARATOR docs for the
-        // probe + rationale.
-        db.exec(`
-			INSERT INTO ${PLACE_SEARCH_TABLE} (wof_id, name, alt_names)
-			SELECT
-				spr.id,
-				spr.name,
-				COALESCE((
-					SELECT GROUP_CONCAT(
-						REPLACE(name, char(${ALIAS_SEPARATOR_CODEPOINT}), ' '),
-						' ' || char(${ALIAS_SEPARATOR_CODEPOINT}) || ' '
-					) || ' ' || char(${ALIAS_SEPARATOR_CODEPOINT})
-					FROM names WHERE names.id = spr.id
-				), '')
-			FROM spr
-			WHERE spr.is_current != 0
-				AND spr.is_deprecated = 0
-				AND spr.name IS NOT NULL;
-		`);
-        ftsCreated = true;
-    }
-    const ftsCountRow = db.prepare(`SELECT COUNT(*) AS n FROM ${PLACE_SEARCH_TABLE}`).get();
-    // ─── R*Tree phase ────────────────────────────────────────────────
-    let bboxCreated = false;
-    if (bboxExisting && opts.drop) {
-        onProgress("dropping", PLACE_BBOX_TABLE);
-        db.exec(`DROP TABLE ${PLACE_BBOX_TABLE}`);
-    }
-    if (!bboxExisting || opts.drop) {
-        onProgress("creating-bbox");
-        // R*Tree requires INTEGER PRIMARY KEY (id) + paired min/max for each indexed dimension.
-        // `rtree` (not `rtree_i32`) keeps coordinates as REAL — what we want for WGS-84.
-        db.exec(`
-			CREATE VIRTUAL TABLE ${PLACE_BBOX_TABLE} USING rtree(
-				id,
-				min_lat, max_lat,
-				min_lon, max_lon
-			);
-		`);
-        onProgress("populating-bbox");
-        // Only index places that have non-zero coordinates AND a real bbox. WOF stores both the
-        // centroid (latitude/longitude) and the bounding box (min_*/max_*). A subset of rows have
-        // all-zero coordinates — likely placeholders for deprecated / unmapped entries; the
-        // is_current / is_deprecated filter mostly catches them, but we double-check at insert.
-        db.exec(`
-			INSERT INTO ${PLACE_BBOX_TABLE} (id, min_lat, max_lat, min_lon, max_lon)
-			SELECT
-				spr.id,
-				spr.min_latitude,
-				spr.max_latitude,
-				spr.min_longitude,
-				spr.max_longitude
-			FROM spr
-			WHERE spr.is_current != 0
-				AND spr.is_deprecated = 0
-				AND spr.min_latitude IS NOT NULL
-				AND spr.max_latitude IS NOT NULL
-				AND spr.min_longitude IS NOT NULL
-				AND spr.max_longitude IS NOT NULL
-				AND NOT (spr.min_latitude = 0 AND spr.max_latitude = 0
-				     AND spr.min_longitude = 0 AND spr.max_longitude = 0);
-		`);
-        bboxCreated = true;
-    }
-    const bboxCountRow = db.prepare(`SELECT COUNT(*) AS n FROM ${PLACE_BBOX_TABLE}`).get();
-    // NOTE: `place_population` is NOT built here. `scripts/build-unified-wof.ts` extracts
-    // `wof:population` straight into that table at ingest (the canonical source carries no `geojson`
-    // table), and `build-slim` copies it through. This function only owns the two FTS-derived virtual
-    // tables, both of which build from `spr` + `names` alone. `placePopulationExists` lets callers
-    // check for the pre-built table.
-    onProgress("done", `${ftsCountRow.n} FTS rows + ${bboxCountRow.n} bbox rows ` +
-        `(${ftsCreated ? "built" : "preexisting"} / ${bboxCreated ? "built" : "preexisting"})`);
-    return {
-        created: ftsCreated,
-        indexedRows: ftsCountRow.n,
-        bboxCreated,
-        bboxIndexedRows: bboxCountRow.n,
-        durationMs: Date.now() - start,
-    };
-}
-/**
- * Returns true iff the `place_search` table exists in the connected DB. Used by `WOFSQLitePlaceLookup` for its "FTS
- * missing — pass buildFTS:true or run the CLI" guard.
- */
-export function placeSearchFTSExists(db) {
-    return tableExists(db, PLACE_SEARCH_TABLE);
-}
-/**
- * Returns true iff the `place_bbox` R*Tree table exists. Used for opt-in proximity lookup checks.
- */
-export function placeBboxExists(db) {
-    return tableExists(db, PLACE_BBOX_TABLE);
-}
-/**
- * Returns true iff the `place_population` table exists. Used for opt-in population-ranking checks.
- */
-export function placePopulationExists(db) {
-    return tableExists(db, PLACE_POPULATION_TABLE);
-}
-//# sourceMappingURL=index.js.map

package/out/fts/index.js.map

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../lib/geonames/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,mBAAmB,CAAA;AACjC,cAAc,kBAAkB,CAAA"}

package/out/geonames/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../lib/geonames/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,mBAAmB,CAAA;AACjC,cAAc,kBAAkB,CAAA"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../lib/nsul/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA"}

package/out/nsul/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../lib/nsul/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../lib/poi/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA"}

package/out/poi/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../lib/poi/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"city-alias-lookup.d.ts","sourceRoot":"","sources":["../../lib/postal/city-alias-lookup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAEzD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAA;AAExE,MAAM,WAAW,4BAA4B;IAC5C;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;OAEG;IACH,QAAQ,CAAC,EAAE,cAAc,CAAC,uBAAuB,CAAC,CAAA;CAClD;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B;;OAEG;IACH,UAAU,EAAE,MAAM,CAAA;IAClB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAA;IACnB;;OAEG;IACH,CAAC,EAAE,MAAM,CAAA;CACT;AAED;;;;GAIG;AACH,qBAAa,wBAAyB,YAAW,UAAU;;gBAQ9C,IAAI,EAAE,4BAA4B;IAU9C;;;OAGG;IACG,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAevE,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;CAGxB"}

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

@@ -1,62 +0,0 @@
-/**
- * @copyright Sister Software
- * @license AGPL-3.0
- * @author Teffen Ellis, et al.
- *
- *   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
- *   ("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
- *   absent it the resolver is byte-identical.
- *
- *   The reader returns RAW divergent rows for a postcode; normalization + name-matching against the
- *   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/sqlite/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}.
- */
-export class WOFPostalCityAliasLookup {
-    #db;
-    /**
-     * Resources this instance opened. A connection handed in by a caller is NOT in here, so disposal cannot reach it —
-     * ownership is membership rather than a flag a later branch has to check.
-     */
-    #resources = new DisposableStack();
-    constructor(opts) {
-        if (opts.database) {
-            this.#db = opts.database;
-        }
-        else if (opts.databasePath) {
-            this.#db = this.#resources.use(new DatabaseClient(opts.databasePath, { readOnly: true }));
-        }
-        else {
-            throw new Error("WOFPostalCityAliasLookup needs `databasePath` or `database`");
-        }
-    }
-    /**
-     * 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();
-        if (!pc)
-            return [];
-        const rows = await this.#db
-            .selectFrom("postal_city_alias")
-            .select(["postal_city", "geo_locality", "n"])
-            .where("postcode", "=", pc)
-            .where("divergent", "=", 1)
-            .execute();
-        return rows.map((r) => ({ postalCity: String(r.postal_city), geoLocality: String(r.geo_locality), n: Number(r.n) }));
-    }
-    [Symbol.dispose]() {
-        this.#resources[Symbol.dispose]();
-    }
-}
-//# sourceMappingURL=city-alias-lookup.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"city-alias-lookup.js","sourceRoot":"","sources":["../../lib/postal/city-alias-lookup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAiCzD;;;;GAIG;AACH,MAAM,OAAO,wBAAwB;IACpC,GAAG,CAAyC;IAC5C;;;OAGG;IACM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;IAE3C,YAAY,IAAkC;QAC7C,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAA;QACzB,CAAC;aAAM,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YAC9B,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,cAAc,CAA0B,IAAI,CAAC,YAAY,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;QACnH,CAAC;aAAM,CAAC;YACP,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAA;QAC/E,CAAC;IACF,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;QAElB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG;aACzB,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,CAAC,MAAM,CAAC,OAAO,CAAC;QACf,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAA;IAClC,CAAC;CACD"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"city-alias-schema.d.ts","sourceRoot":"","sources":["../../lib/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;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAA;IACnB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAA;IACpB;;OAEG;IACH,CAAC,EAAE,MAAM,CAAA;IACT;;OAEG;IACH,SAAS,EAAE,MAAM,CAAA;IACjB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;IACd;;OAEG;IACH,OAAO,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACvC,iBAAiB,EAAE,oBAAoB,CAAA;CACvC;AAED;;GAEG;AACH,eAAO,MAAM,yBAAyB,6FAQ5B,CAAA;AAEV;;;GAGG;AACH,wBAAsB,0BAA0B,CAAC,EAAE,EAAE,MAAM,CAAC,uBAAuB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAcnG"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"city-alias-schema.js","sourceRoot":"","sources":["../../lib/postal/city-alias-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AA8CH;;GAEG;AACH,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;IAEX,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"}