@mailwoman/resolver-wof-sqlite 10.0.0 → 10.2.0

package/out/candidate/schema.d.ts

@@ -2,26 +2,16 @@
  * @copyright Sister Software
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
- *
- *   Typed schema for the byte-range CANDIDATE gazetteer (`candidate.db`) — the single source of truth
- *   for the columns shared by the BUILDER ({@link buildCandidateTable}) and the READERS (the Node
- *   {@link WOFCandidateTableLookup} + the browser `@mailwoman/resolver-wof-wasm/httpvfs/resolver`). Before this module each
- *   side hand-wrote the column list; a rename in one place broke the other at runtime. Now the
- *   contract is a Kysely `Database` interface (`new DatabaseClient<CandidateDatabase>(...)` for
- *   typed inserts) plus the table DDL as strings — so a column change is a compile error on every
- *   consumer.
- *
- *   `cand_stage` is the transient staging table the builder bulk-loads; `candidate` is the clustered
- *   `WITHOUT ROWID` B-tree it's materialized into (same columns). The reader queries `candidate`.
  */
 import { type Kysely } from "kysely";
 import type { CandidateAncestorsDatabase } from "#candidate/ancestors/schema";
 import type { CapitalTable } from "#capital-schema";
 import type { NameKey } from "#street/normalize";
 /**
- * One candidate row. `name_key` + the four small int keys + `neg_rank` + `spr_id` form the clustered primary key; the
- * rest is denormalized so a resolve is one probe (no join to `spr`). Coordinates + bbox + name are nullable at the SQL
- * level (a postcode extract row may lack a bbox).
+ * One candidate row.
+ *
+ * `name_key`, four small integer keys, `neg_rank`, and `spr_id` form the clustered primary key.
+ * The remaining fields are denormalized so a resolve needs one probe.
  */
 export interface CandidateTable {
     /**
@@ -33,7 +23,7 @@ export interface CandidateTable {
      */
     country_id: number;
     /**
-     * The place's region-tier ancestor id, or 0 (carried for the future region 2-step).
+     * The place's region-tier ancestor id, or 0.
      */
     region_id: number;
     /**
@@ -41,7 +31,10 @@ export interface CandidateTable {
      */
     placetype_id: number;
     /**
-     * `-log10(population + 1)` — ASC order = highest-population first. 0 for postcodes (no population).
+     * `-log10(population + 1)`.
+     *
+     * The sort uses ascending order to put the highest population first.
+     * Postcodes use `0`.
      */
     neg_rank: number;
     /**
@@ -61,42 +54,14 @@ export interface CandidateTable {
      */
     is_primary: number | null;
     /**
-     * Blended place importance in [0, 1] — the toponym-fame prior the bare-city-name class is decided on (#28). NULL
-     * means the score source had no row for this place: UNMEASURED, never "an importance of zero" (meaning-of-zero).
-     * Constant across every row of one place — primary, alias and abbrev alike — because it is a property of the PLACE,
-     * not of the name that reached it, which is what lets a bare `Moscow` inherit Москва's score through the alias row.
-     *
-     * **THIS IS THE PRE-SPLIT CONFLATION, AND THE NAME SAYS SO.** It is `place_importance.importance` copied verbatim
-     * from the score source — the bounded blend `place-importance-schema.ts`'s `blendImportance` writes (the
-     * concordance's encyclopedia-derived channel clamped around a population-derived base); that module calls the column
-     * DEPRECATED. It is NOT the split `encyclopedic` channel, and the two must not be conflated in a future build:
-     * writing the split value here instead was measured on 2026-08-10 and makes the ranking key INERT on three of the
-     * four rows it exists to fix. The reason is coverage, not principle — the encyclopedia-concordance join in
-     * `admin-global-priority-importance.db` reaches 133,888 of 702,709 scored places and only eleven countries
-     * (US/FR/GB/DE/IT/ES/NL/JP/CN/KR/TW). CA, AU and RU have ZERO concordance rows, so Whitby CA, Windsor CA and Epping
-     * AU carry the population fallback and nothing else. Under the strict split those three become unmeasured, the
-     * consumer's positive-evidence-only rule leaves them exactly where population put them (first), and the famous GB
-     * bearer can never overtake them. The conflated column is the only one on which every bearer of a name is scored on a
-     * single comparable scale, which is the precondition for comparing them at all.
-     *
-     * So a consumer reads this as "fame, with population standing in where fame was never measured" — the legacy blended
-     * semantics — and NOT as "this place has an encyclopedia entry of this importance". When the score source grows a
-     * real `encyclopedic` column for every country, add a SECOND column rather than redefining this one.
+     * Blended place importance in [0, 1], NULL when unmeasured (never zero) and copied
+     * verbatim from the pre-split score source rather than the split `encyclopedic` channel.
      */
     importance: number | null;
     /**
-     * The NAME'S detected role on this row, or NULL (#1730). Two build-time detectors stamp `is_primary = 0` rows only:
-     *
-     * - `'abbr'` — provenance-based: the surface is a WOF `variant` name in one of the place's country's official languages
-     *   (or English) — the #936 signal, measured at a 13× key-collision rate vs preferred names.
-     * - `'gloss'` — anomaly-based: the row belongs to a place whose key count crosses the gloss threshold with a non-admin
-     *   placetype and NO measured prominence (population absent AND importance unmeasured) — the translation-gloss
-     *   fingerprint (#1730's sweep; `Poisson` → a US fish-name place). Provenance CANNOT separate a gloss from an exonym
-     *   (WOF imported both as `x_preferred`), which is why this detector is an anomaly test and stamps only the certain
-     *   core.
-     *
-     * NULL = no role detected. The column is WRITE-ONLY in this build generation: no ranking consumer reads it — a rank
-     * penalty is its own future, D-rule-conditional step with the `gloss_key` board as regression check.
+     * The name's detected role on this row (`'abbr'`, `'gloss'` or `'variant'`),
+     * or NULL when no role was detected.
+     * The column is write-only in this build generation.
      */
     name_role: string | null;
 }
@@ -115,13 +80,12 @@ export interface PlacetypeCodeTable {
     placetype: string;
 }
 /**
- * The candidate database schema for `new DatabaseClient<CandidateDatabase>(...)`. Extends the ancestors sidecar
- * (`candidate_ancestor` + `candidate_interval` — see candidate-ancestors-schema.ts for the encoding decision), so the
- * builder's one typed client covers every table in the artifact.
+ * The candidate database schema, extending the ancestors sidecar so one typed
+ * client covers every table in the artifact.
  */
 export interface CandidateDatabase extends CandidateAncestorsDatabase {
     /**
-     * The clustered `WITHOUT ROWID` lookup table the reader probes.
+     * The clustered `without rowid` lookup table the reader probes.
      */
     candidate: CandidateTable;
     /**
@@ -131,25 +95,26 @@ export interface CandidateDatabase extends CandidateAncestorsDatabase {
     country_codes: CountryCodeTable;
     placetype_codes: PlacetypeCodeTable;
     /**
-     * The capital-status reference carried in-artifact (#1880's distribution home) — see capital-schema.ts.
+     * The capital-status reference stored in the artifact.
+     * See capital-schema.ts.
      */
     capital: CapitalTable;
 }
 /**
- * The `candidate`/`cand_stage` columns in clustered-key order. The materialization `INSERT INTO candidate SELECT … FROM
- * cand_stage` derives its column list from this, so the two tables can't drift. Keep in sync with
- * {@link CandidateTable}.
+ * The `candidate`/`cand_stage` columns in clustered-key order, from which the
+ * materialization derives its column list.
+ * Keep in sync with {@link CandidateTable}.
  */
 export declare const CANDIDATE_COLUMNS: readonly ["name_key", "country_id", "region_id", "placetype_id", "neg_rank", "spr_id", "name", "latitude", "longitude", "min_lat", "min_lon", "max_lat", "max_lon", "population", "is_primary", "importance", "name_role"];
 /**
- * Create the code dictionaries + the transient staging table — called before the build's load passes. `cand_stage`
- * mirrors {@link CandidateTable} but every column is nullable (the loader fills them positionally). Pass a
- * {@link DatabaseClient} (or any `Kysely`) over the candidate DB.
+ * Create the code dictionaries and the transient staging table; `cand_stage` mirrors
+ * {@link CandidateTable} with every column nullable because the loader fills them positionally.
  */
 export declare function createCandidateStagingTables(db: Kysely<CandidateDatabase>): Promise<void>;
 /**
- * Create the clustered `WITHOUT ROWID` lookup table — called after staging, before the VACUUM. The first six columns
- * form the clustered primary key (population-ranked via `neg_rank`).
+ * Create the clustered `without rowid` lookup table.
+ *
+ * Its first six columns form the primary key, ranked by population through `neg_rank`.
  */
 export declare function createCandidateTable(db: Kysely<CandidateDatabase>): Promise<void>;
 //# sourceMappingURL=schema.d.ts.map

package/out/candidate/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../lib/candidate/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAO,KAAK,MAAM,EAAE,MAAM,QAAQ,CAAA;AAEzC,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAA;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAEhD;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC9B;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAA;IACjB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAA;IAClB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAA;IACjB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAA;IACpB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB;;OAEG;IACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB;;;;;;;;;;;;;OAaG;IACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,MAAM,CAAA;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAkB,SAAQ,0BAA0B;IACpE;;OAEG;IACH,SAAS,EAAE,cAAc,CAAA;IACzB;;OAEG;IACH,UAAU,EAAE,cAAc,CAAA;IAC1B,aAAa,EAAE,gBAAgB,CAAA;IAC/B,eAAe,EAAE,kBAAkB,CAAA;IACnC;;OAEG;IACH,OAAO,EAAE,YAAY,CAAA;CACrB;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,YAC7B,UAAU,EACV,YAAY,EACZ,WAAW,EACX,cAAc,EACd,UAAU,EACV,QAAQ,EACR,MAAM,EACN,UAAU,EACV,WAAW,EACX,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,YAAY,EACZ,YAAY,EAGZ,YAAY,EACZ,WAAW,CACF,CAAA;AAEV;;;;GAIG;AACH,wBAAsB,4BAA4B,CAAC,EAAE,EAAE,MAAM,CAAC,iBAAiB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAiC/F;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,EAAE,EAAE,MAAM,CAAC,iBAAiB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BvF"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../lib/candidate/schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAO,KAAK,MAAM,EAAE,MAAM,QAAQ,CAAA;AAEzC,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAA;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAEhD;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC9B;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAA;IACjB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAA;IAClB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAA;IACjB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAA;IACpB;;;;;OAKG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB;;OAEG;IACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB;;;OAGG;IACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB;;;;OAIG;IACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,MAAM,CAAA;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAkB,SAAQ,0BAA0B;IACpE;;OAEG;IACH,SAAS,EAAE,cAAc,CAAA;IACzB;;OAEG;IACH,UAAU,EAAE,cAAc,CAAA;IAC1B,aAAa,EAAE,gBAAgB,CAAA;IAC/B,eAAe,EAAE,kBAAkB,CAAA;IACnC;;;OAGG;IACH,OAAO,EAAE,YAAY,CAAA;CACrB;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,YAC7B,UAAU,EACV,YAAY,EACZ,WAAW,EACX,cAAc,EACd,UAAU,EACV,QAAQ,EACR,MAAM,EACN,UAAU,EACV,WAAW,EACX,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,YAAY,EACZ,YAAY,EAEZ,YAAY,EACZ,WAAW,CACF,CAAA;AAEV;;;GAGG;AACH,wBAAsB,4BAA4B,CAAC,EAAE,EAAE,MAAM,CAAC,iBAAiB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAiC/F;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,EAAE,EAAE,MAAM,CAAC,iBAAiB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BvF"}

package/out/candidate/schema.js

@@ -2,23 +2,12 @@
  * @copyright Sister Software
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
- *
- *   Typed schema for the byte-range CANDIDATE gazetteer (`candidate.db`) — the single source of truth
- *   for the columns shared by the BUILDER ({@link buildCandidateTable}) and the READERS (the Node
- *   {@link WOFCandidateTableLookup} + the browser `@mailwoman/resolver-wof-wasm/httpvfs/resolver`). Before this module each
- *   side hand-wrote the column list; a rename in one place broke the other at runtime. Now the
- *   contract is a Kysely `Database` interface (`new DatabaseClient<CandidateDatabase>(...)` for
- *   typed inserts) plus the table DDL as strings — so a column change is a compile error on every
- *   consumer.
- *
- *   `cand_stage` is the transient staging table the builder bulk-loads; `candidate` is the clustered
- *   `WITHOUT ROWID` B-tree it's materialized into (same columns). The reader queries `candidate`.
  */
 import { sql } from "kysely";
 /**
- * The `candidate`/`cand_stage` columns in clustered-key order. The materialization `INSERT INTO candidate SELECT … FROM
- * cand_stage` derives its column list from this, so the two tables can't drift. Keep in sync with
- * {@link CandidateTable}.
+ * The `candidate`/`cand_stage` columns in clustered-key order, from which the
+ * materialization derives its column list.
+ * Keep in sync with {@link CandidateTable}.
  */
 export const CANDIDATE_COLUMNS = [
     "name_key",
@@ -36,15 +25,13 @@ export const CANDIDATE_COLUMNS = [
     "max_lon",
     "population",
     "is_primary",
-    // Appended, never inserted mid-list: the first six entries ARE the clustered primary key, and the
-    // positional `INSERT INTO cand_stage VALUES (…)` in the builder binds by position.
+    // Appended, never inserted mid-list: the positional `insert into cand_stage values (…)` binds by position.
     "importance",
     "name_role",
 ];
 /**
- * Create the code dictionaries + the transient staging table — called before the build's load passes. `cand_stage`
- * mirrors {@link CandidateTable} but every column is nullable (the loader fills them positionally). Pass a
- * {@link DatabaseClient} (or any `Kysely`) over the candidate DB.
+ * Create the code dictionaries and the transient staging table; `cand_stage` mirrors
+ * {@link CandidateTable} with every column nullable because the loader fills them positionally.
  */
 export async function createCandidateStagingTables(db) {
     await db.schema
@@ -79,8 +66,9 @@ export async function createCandidateStagingTables(db) {
         .execute();
 }
 /**
- * Create the clustered `WITHOUT ROWID` lookup table — called after staging, before the VACUUM. The first six columns
- * form the clustered primary key (population-ranked via `neg_rank`).
+ * Create the clustered `without rowid` lookup table.
+ *
+ * Its first six columns form the primary key, ranked by population through `neg_rank`.
  */
 export async function createCandidateTable(db) {
     await db.schema
@@ -110,7 +98,7 @@ export async function createCandidateTable(db) {
         "neg_rank",
         "spr_id",
     ])
-        // `WITHOUT ROWID` has no first-class builder; the raw modifier is the idiomatic fallback.
+        // `without rowid` has no first-class builder. The raw modifier is the idiomatic fallback.
         .modifyEnd(sql `without rowid`)
         .execute();
 }

package/out/candidate/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../lib/candidate/schema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../lib/candidate/schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,GAAG,EAAe,MAAM,QAAQ,CAAA;AAuGzC;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAChC,UAAU;IACV,YAAY;IACZ,WAAW;IACX,cAAc;IACd,UAAU;IACV,QAAQ;IACR,MAAM;IACN,UAAU;IACV,WAAW;IACX,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,YAAY;IACZ,YAAY;IACZ,2GAA2G;IAC3G,YAAY;IACZ,WAAW;CACF,CAAA;AAEV;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAAC,EAA6B;IAC/E,MAAM,EAAE,CAAC,MAAM;SACb,WAAW,CAAC,eAAe,CAAC;SAC5B,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC;SACjD,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SAC5C,OAAO,EAAE,CAAA;IAEX,MAAM,EAAE,CAAC,MAAM;SACb,WAAW,CAAC,iBAAiB,CAAC;SAC9B,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC;SACjD,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjD,OAAO,EAAE,CAAA;IAEX,MAAM,EAAE,CAAC,MAAM;SACb,WAAW,CAAC,YAAY,CAAC;SACzB,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC;SAC7B,SAAS,CAAC,YAAY,EAAE,SAAS,CAAC;SAClC,SAAS,CAAC,WAAW,EAAE,SAAS,CAAC;SACjC,SAAS,CAAC,cAAc,EAAE,SAAS,CAAC;SACpC,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC;SAC7B,SAAS,CAAC,QAAQ,EAAE,SAAS,CAAC;SAC9B,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;SACzB,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC;SAC7B,SAAS,CAAC,WAAW,EAAE,MAAM,CAAC;SAC9B,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC;SAC5B,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC;SAC5B,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC;SAC5B,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC;SAC5B,SAAS,CAAC,YAAY,EAAE,SAAS,CAAC;SAClC,SAAS,CAAC,YAAY,EAAE,SAAS,CAAC;SAClC,SAAS,CAAC,YAAY,EAAE,MAAM,CAAC;SAC/B,SAAS,CAAC,WAAW,EAAE,MAAM,CAAC;SAC9B,OAAO,EAAE,CAAA;AACZ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,EAA6B;IACvE,MAAM,EAAE,CAAC,MAAM;SACb,WAAW,CAAC,WAAW,CAAC;SACxB,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SACjD,SAAS,CAAC,YAAY,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SACtD,SAAS,CAAC,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SACrD,SAAS,CAAC,cAAc,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SACxD,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,CAAC;SACzB,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC;SAC7B,SAAS,CAAC,WAAW,EAAE,MAAM,CAAC;SAC9B,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC;SAC5B,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC;SAC5B,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC;SAC5B,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC;SAC5B,SAAS,CAAC,YAAY,EAAE,SAAS,CAAC;SAClC,SAAS,CAAC,YAAY,EAAE,SAAS,CAAC;SAClC,SAAS,CAAC,YAAY,EAAE,MAAM,CAAC;SAC/B,SAAS,CAAC,WAAW,EAAE,MAAM,CAAC;SAC9B,uBAAuB,CAAC,cAAc,EAAE;QACxC,UAAU;QACV,YAAY;QACZ,WAAW;QACX,cAAc;QACd,UAAU;QACV,QAAQ;KACR,CAAC;QACF,0FAA0F;SACzF,SAAS,CAAC,GAAG,CAAA,eAAe,CAAC;SAC7B,OAAO,EAAE,CAAA;AACZ,CAAC"}

package/out/candidate/scoring.d.ts

@@ -2,18 +2,17 @@
  * @copyright Sister Software
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
- *
- *   How a raw `place_search` row becomes a scored `PlaceCandidate`, and how the resulting pool is
- *   ordered — the weighted-sum score and the exact-match tiering that ranks over it.
  */
 import type { DatabaseClient } from "@mailwoman/sqlite/client";
 import { type RankingWeights } from "#ranking-weights";
 import type { RawSearchRow } from "#search-fetch";
 import type { FindPlaceQuery, PlaceCandidate, WOFPlacetype } from "#types";
 /**
- * Score one raw FTS row into a `PlaceCandidate`: the weighted sum over the negated BM25 baseline, the placetype /
- * country / parent boosts, the length penalty, the proximity and population terms, and the carried fields (referential,
- * encyclopedic, bbox) consumers read. `queryLen` is the query text's length, hoisted out of the per-row loop.
+ * Score one raw FTS row into a `PlaceCandidate`: the weighted sum over the negated
+ * BM25 baseline plus placetype, country and parent boosts.
+ *
+ * It also applies the length penalty, proximity and population terms,
+ * then returns the fields consumers read.
  */
 export declare function candidateFromSearchRow(row: RawSearchRow, context: {
     query: FindPlaceQuery;
@@ -22,8 +21,8 @@ export declare function candidateFromSearchRow(row: RawSearchRow, context: {
     weights: RankingWeights;
 }): PlaceCandidate;
 /**
- * Order `candidates` IN PLACE — the exact-match tier first when the extract can answer the name probes, otherwise plain
- * weighted-score order. Every candidate is stamped with its `exactMatch` flag on the way through.
+ * Order `candidates` in place with the exact-match tier first when the extract can answer name probes.
+ * Stamp every candidate's `exactMatch` flag.
  */
 export declare function rankCandidates<DB>(candidates: PlaceCandidate[], options: {
     db: DatabaseClient<DB>;

package/out/candidate/scoring.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scoring.d.ts","sourceRoot":"","sources":["../../lib/candidate/scoring.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAI9D,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AAE1E;;;;GAIG;AACH,wBAAgB,sBAAsB,CACrC,GAAG,EAAE,YAAY,EACjB,OAAO,EAAE;IACR,KAAK,EAAE,cAAc,CAAA;IACrB,UAAU,EAAE,YAAY,EAAE,GAAG,IAAI,CAAA;IACjC,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,cAAc,CAAA;CACvB,GACC,cAAc,CAmHhB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAChC,UAAU,EAAE,cAAc,EAAE,EAC5B,OAAO,EAAE;IACR,EAAE,EAAE,cAAc,CAAC,EAAE,CAAC,CAAA;IACtB,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,cAAc,CAAA;IACrB,OAAO,EAAE,cAAc,CAAA;CACvB,GACC,IAAI,CAmGN"}
+{"version":3,"file":"scoring.d.ts","sourceRoot":"","sources":["../../lib/candidate/scoring.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAI9D,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AAE1E;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACrC,GAAG,EAAE,YAAY,EACjB,OAAO,EAAE;IACR,KAAK,EAAE,cAAc,CAAA;IACrB,UAAU,EAAE,YAAY,EAAE,GAAG,IAAI,CAAA;IACjC,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,cAAc,CAAA;CACvB,GACC,cAAc,CA2GhB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAChC,UAAU,EAAE,cAAc,EAAE,EAC5B,OAAO,EAAE;IACR,EAAE,EAAE,cAAc,CAAC,EAAE,CAAC,CAAA;IACtB,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,cAAc,CAAA;IACrB,OAAO,EAAE,cAAc,CAAA;CACvB,GACC,IAAI,CAqEN"}

package/out/candidate/scoring.js

@@ -2,24 +2,22 @@
  * @copyright Sister Software
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
- *
- *   How a raw `place_search` row becomes a scored `PlaceCandidate`, and how the resulting pool is
- *   ordered — the weighted-sum score and the exact-match tiering that ranks over it.
  */
 import { compareReferential, referentialFromPopulation } from "@mailwoman/core/resolver";
 import { haversineKm } from "@mailwoman/spatial";
 import { exactMatchIDs, officialNameIDs } from "#exact-match";
-import { foldQueryText } from "#fts/index";
+import { foldQueryText } from "#fts";
 import { populationBoostTerm } from "#ranking-weights";
 /**
- * Score one raw FTS row into a `PlaceCandidate`: the weighted sum over the negated BM25 baseline, the placetype /
- * country / parent boosts, the length penalty, the proximity and population terms, and the carried fields (referential,
- * encyclopedic, bbox) consumers read. `queryLen` is the query text's length, hoisted out of the per-row loop.
+ * Score one raw FTS row into a `PlaceCandidate`: the weighted sum over the negated
+ * BM25 baseline plus placetype, country and parent boosts.
+ *
+ * It also applies the length penalty, proximity and population terms,
+ * then returns the fields consumers read.
  */
 export function candidateFromSearchRow(row, context) {
     const { query, placetypes, queryLen, weights } = context;
-    // SQLite's bm25() returns a lower-is-better score (negative for matches). Negate so we
-    // start from a higher-is-better baseline.
+    // SQLite's bm25() is lower-is-better, so negate it to get a higher-is-better baseline.
     let score = -row.rank;
     if (placetypes && placetypes.length && placetypes.includes(row.placetype)) {
         score += weights.placetypeMatchBoost;
@@ -35,13 +33,10 @@ export function candidateFromSearchRow(row, context) {
     }
     const extraLen = Math.max(0, row.name.length - queryLen - 3);
     score -= (weights.lengthPenaltyWeight * extraLen) / 10;
-    // Proximity boost: only applied when the query carries `near` AND the candidate has real
-    // coordinates. The formula decays smoothly with distance so close-but-not-exact hits
-    // still benefit; tunable via proximityBoost + proximityScaleKm.
-    let distanceKm;
-    // The best decayed-distance term over `near` + every `bias` point (each point's term is
-    // scaled by its weight; the MAX wins — a candidate near ANY hint is "nearby"). Carried
-    // into the exact-tier prominence sort below when hints are present.
+    // Proximity boost applies only when the query includes `near` and the candidate has real coordinates.
+    // The decay is tunable via proximityBoost + proximityScaleKm.
+    let distanceKm = null;
+    // The best decayed-distance term over `near` and every `bias` point wins, each scaled by its weight.
     let proximityTerm = 0;
     if (row.lat !== null && row.lon !== null && !(row.lat === 0 && row.lon === 0)) {
         const hints = [];
@@ -64,14 +59,19 @@ export function candidateFromSearchRow(row, context) {
         }
         score += scoreTerm;
     }
-    // Population boost: capped at `populationBoost` magnitude at `10^populationScaleLog10`
-    // people. Missing population → no contribution. Never penalizes.
+    // Population boost caps at `populationBoost` magnitude at `10^populationScaleLog10` people and never penalizes.
     const popTerm = populationBoostTerm(row.population, weights);
     score += popTerm;
-    // Combined prominence for the exact-tier sort when proximity hints are present: population
-    // and nearness in the SAME additive units, so the map view / the user's location can win a
-    // cross-country postcode tie without a hard filter.
+    // Combined prominence for the exact-tier sort: population and nearness in the same
+    // additive units, so hints can win a cross-country postcode tie without a hard filter.
     const prominence = popTerm + proximityTerm;
+    const population = row.population !== null && row.population > 0 ? row.population : null;
+    // The referential key derives from this row's population and no other field,
+    // so it cannot drift from the ordering.
+    // Consumers read the encyclopedic value.
+    // No ranking site reads it.
+    // The bbox gives parity with the wasm lookup.
+    // Without it the region→bbox constraint is dead and disambiguation falls to population ranking.
     const candidate = {
         id: row.id,
         prominence,
@@ -80,77 +80,49 @@ export function candidateFromSearchRow(row, context) {
         country: row.country ?? "",
         lat: row.lat ?? 0,
         lon: row.lon ?? 0,
-        parent_id: row.parent_id ?? undefined,
+        parent_id: row.parent_id ?? null,
         score,
+        distanceKm,
+        exactMatch: null,
+        population,
+        referential: population === null ? null : referentialFromPopulation(population),
+        encyclopedic: row.encyclopedic ?? null,
+        importance: null,
+        bbox: row.min_latitude != null && row.max_latitude != null && row.min_longitude != null && row.max_longitude != null
+            ? {
+                minLat: row.min_latitude,
+                maxLat: row.max_latitude,
+                minLon: row.min_longitude,
+                maxLon: row.max_longitude,
+            }
+            : null,
+        mismatch: null,
+        containedByQualifier: null,
+        regionScopeMiss: null,
+        variantAliasExempted: null,
     };
-    if (distanceKm !== undefined) {
-        candidate.distanceKm = distanceKm;
-    }
-    if (row.population !== null && row.population > 0) {
-        candidate.population = row.population;
-        // The named ranking key (ROAD_TO_V9 §2). DERIVED, not stored — a pure function of the
-        // population already on this row, so it cannot drift from what the ordering uses.
-        candidate.referential = referentialFromPopulation(row.population);
-    }
-    // Carried for consumers (annotations / API surfaces). No ranking site reads it.
-    if (row.encyclopedic !== null) {
-        candidate.encyclopedic = row.encyclopedic;
-    }
-    // Candidate bbox — parity with the WASM lookup (resolver-wof-wasm/lookup.ts), whose
-    // consumers (the demo cascade's region constraint) read it. Without this the Node
-    // backend's region→bbox constraint is dead and disambiguation falls to population
-    // ranking (the Springfield-IL→MO failure the #524 smoke eval caught).
-    if (row.min_latitude != null && row.max_latitude != null && row.min_longitude != null && row.max_longitude != null) {
-        candidate.bbox = {
-            minLat: row.min_latitude,
-            maxLat: row.max_latitude,
-            minLon: row.min_longitude,
-            maxLon: row.max_longitude,
-        };
-    }
     return candidate;
 }
 /**
- * Order `candidates` IN PLACE — the exact-match tier first when the extract can answer the name probes, otherwise plain
- * weighted-score order. Every candidate is stamped with its `exactMatch` flag on the way through.
+ * Order `candidates` in place with the exact-match tier first when the extract can answer name probes.
+ * Stamp every candidate's `exactMatch` flag.
  */
 export function rankCandidates(candidates, options) {
     const { db, schemaName, query, weights } = options;
-    // Exact-match tiering: a candidate whose name OR any alias equals the query text (case-folded)
-    // ranks above any partial match, with the weighted-sum score (incl. population) breaking ties
-    // WITHIN a tier. See the RankingWeights.exactMatchTiering docstring for why this aligns the
-    // population prior rather than overriding it. One cheap indexed lookup over the candidate ids.
-    // Runs even for a SINGLE candidate so `exactMatch` is stamped consistently (parity with the
-    // WASM lookup) — a sole alias hit ("New York City" → New York) must still carry the flag the
-    // demo cascade / #369 re-rank read.
+    // Exact-match tiering ranks a case-folded full match above a partial one.
+    // It also runs for a single candidate so `exactMatch` is stamped consistently.
     if (weights.exactMatchTiering && candidates.length) {
         const exactIDs = exactMatchIDs(db, schemaName, candidates.map((c) => c.id), query.text);
-        // Stamp the tier onto every candidate (not just when the tiering sort fires) so a downstream
-        // re-rank — #369's postcode-anchor country pin in `resolveTree` — can keep the country pin from
-        // crossing the exact/partial boundary ("ME" → Maine, not the more-populous Missouri).
+        // Stamp the tier onto every candidate so a downstream re-rank's country pin
+        // cannot cross the exact/partial boundary.
         for (const c of candidates) {
             c.exactMatch = exactIDs.has(c.id);
         }
         if (exactIDs.size) {
-            // #905: WITHIN the exact tier, population is the PRIMARY key and the weighted score
-            // only breaks population ties. Exactness saturates text relevance, and the bm25
-            // residue inside `score` is length-noise (see the fetch-site comment), so letting it
-            // order the tier is what sent unscoped "Paris" to an Ohio township. The partial tier
-            // keeps score order — text relevance still means something there. This makes the
-            // exactMatchTiering docstring literal: match quality primary, prominence within.
-            //
-            // #912 sub-tier: a NAME-exact candidate (spr.name equals the query) outranks an
-            // ALIAS-exact one ('Paris' the place beats 'Paris Township' held via alias 'Paris').
-            // The place's own name is a stronger identity claim than an alias — aliases exist to
-            // widen recall, not to tie primaries. ME→Maine is untouched: 'ME' name-exact-matches
-            // nothing, so the alias sub-tier still decides there. Population orders within each
-            // sub-tier as before.
+            // Within the exact tier, population is the primary key and the score only breaks
+            // ties. a name-exact candidate outranks an alias-exact one.
             const needle = foldQueryText(query.text);
-            // #936 option 3: an OFFICIAL name (preferred form in an official language of the place's
-            // country, `names.official = 1`) counts as the place's own name for the sub-tier — "Åbo" is
-            // Turku's name, not merely its alias. Floor-conditioned on the holder's population (see the
-            // RankingWeights docstring for the measured 100k boundary). officialIDs ⊆ exactIDs by
-            // construction (official rows are names rows), so only the sub-tier KIND changes.
+            // An official name counts as the place's own name for the sub-tier, floor-conditioned on the holder's population.
             const officialIDs = weights.officialNameExact
                 ? officialNameIDs(db, schemaName, candidates
                     .filter((c) => exactIDs.has(c.id) && (c.population ?? 0) >= weights.officialNameExactFloor)
@@ -163,18 +135,9 @@ export function rankCandidates(candidates, options) {
                     return 2;
                 return officialIDs?.has(c.id) ? 2 : 1;
             };
-            // With proximity hints (near/bias), prominence (population + nearness, same units)
-            // replaces raw population as the within-tier key — the 48026 rule: the map view or
-            // the user's location breaks a cross-country postcode tie. Without hints, REFERENTIAL
-            // ordering decides.
-            //
-            // ROAD_TO_V9 §2: this is the site that "orders namesakes", so it is the site that has to
-            // say what it orders by. `compareReferential` is referential DESC with raw population as
-            // the tiebreak, which is provably the SAME ORDER as the `(b.population ?? 0) - (a.population ?? 0)`
-            // it replaces — referential is strictly increasing in population below saturation and
-            // constant above it, and the tiebreak restores the order in the saturated tail. Measured
-            // zero-delta, not assumed: see `place-importance-schema.test.ts` and `resolver-referential-ranking.test.ts`.
-            // Encyclopedic importance is not, and must not become, an input here.
+            // With proximity hints, prominence replaces raw population as the within-tier key.
+            // Without them, referential ordering decides.
+            // Encyclopedic importance does not affect this order.
             const hasHints = !!query.near || (query.bias?.length ?? 0) > 0;
             candidates.sort((a, b) => {
                 const ax = kind(a);

package/out/candidate/scoring.js.map

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

package/out/capital-schema.d.ts

@@ -3,27 +3,28 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- *   The `capital` table (#1880's distribution home): the capital-status reference carried INSIDE
- *   `candidate.db`, so an npm consumer who pulled the artifact can run `capital_tier` without the
- *   repo's `data/gazetteer/capitals-v1.json` — which published packages do not ship. One row per
- *   reference entry (241 national capitals + 3,463 admin-1 seats at the 2026-08-24 build); the
- *   loader reads the WHOLE table once into a `CapitalIndex` at session construction, so there is no
- *   per-probe query and no index beyond the rowid.
+ *   The `capital` table: the capital-status reference included inside `candidate.db`, so an npm
+ *   consumer who pulled the artifact can run `capital_tier` without the repo's
+ *   `data/gazetteer/capitals-v1.json`, which published packages do not ship. One row per reference
+ *   entry. The loader reads the whole table once into a `CapitalIndex` at session construction, so
+ *   there is no per-probe query and no index beyond the rowid.
  *
- *   `keys` holds the entry's folded name set as a JSON array — the name-membership conjunct that
- *   keeps the coordinate radius from promoting a capital's same-name neighbours (`capitals.ts`).
+ *   `keys` holds the entry's folded name set as a JSON array, the name-membership conjunct that keeps
+ *   the coordinate radius from promoting a capital's same-name neighbors (`capitals.ts`).
  */
 import type { DatabaseClient } from "@mailwoman/sqlite/client";
 import type { Kysely } from "kysely";
 import type { CapitalPoint } from "#capitals";
 /**
- * The table name the builder writes and the reader probes — one word, singular, matching the artifact's other reference
- * tables (`candidate`, `country_codes`).
+ * The table name the builder writes and the reader probes, one word and singular,
+ * matching the artifact's other reference tables (`candidate`, `country_codes`).
  */
 export declare const CAPITAL_TABLE = "capital";
 /**
- * One reference entry as the artifact stores it. `level` is the reference vocabulary (`national` | `admin1`) kept as
- * text — the reader validates on load rather than trusting bytes.
+ * One reference entry as the artifact stores it.
+ *
+ * `level` is the reference vocabulary (`national` | `admin1`) kept as text.
+ * and the reader validates on load rather than trusting bytes.
  */
 export interface CapitalTable {
     country: string;
@@ -36,16 +37,19 @@ export interface CapitalTable {
     keys: string;
 }
 /**
- * Create the table on a build in progress. Async because Kysely's schema-builder is; called from the candidate build's
- * DDL phase alongside the other typed builders.
+ * Create the table on a build in progress.
+ *
+ * Async because Kysely's schema-builder is.
+ * Called from the candidate build's DDL phase alongside the other typed builders.
  */
 export declare function createCapitalTable<DB extends {
     capital: CapitalTable;
 }>(db: Kysely<DB>): Promise<void>;
 /**
- * Read the whole reference out of an artifact, or `null` when the artifact predates the table — the caller then falls
- * back to its next source rather than treating an old artifact as "no capitals" (the meaning-of-zero rule: a missing
- * table is UNMEASURED, an empty one is a finding).
+ * Read the whole reference out of an artifact, or `null` when the artifact predates the table.
+ *
+ * The caller then falls back to its next source rather than treating an old artifact as "no
+ * capitals" (the meaning-of-zero rule: a missing table is unmeasured, an empty one is a finding).
  */
 export declare function readCapitalPoints<DB>(db: DatabaseClient<DB>): CapitalPoint[] | null;
 //# sourceMappingURL=capital-schema.d.ts.map

package/out/capital-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capital-schema.d.ts","sourceRoot":"","sources":["../lib/capital-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAEpC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAG7C;;;GAGG;AACH,eAAO,MAAM,aAAa,YAAY,CAAA;AAEtC;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;CACZ;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,EAAE,SAAS;IAAE,OAAO,EAAE,YAAY,CAAA;CAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAS5G;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,EAAE,EAAE,cAAc,CAAC,EAAE,CAAC,GAAG,YAAY,EAAE,GAAG,IAAI,CAwBnF"}
+{"version":3,"file":"capital-schema.d.ts","sourceRoot":"","sources":["../lib/capital-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAEpC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAG7C;;;GAGG;AACH,eAAO,MAAM,aAAa,YAAY,CAAA;AAEtC;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;CACZ;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,EAAE,SAAS;IAAE,OAAO,EAAE,YAAY,CAAA;CAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAS5G;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,EAAE,EAAE,cAAc,CAAC,EAAE,CAAC,GAAG,YAAY,EAAE,GAAG,IAAI,CAwBnF"}