@mailwoman/corpus 10.6.0 → 10.7.0

package/out/fo/adapters/adressur/adapter.js

@@ -0,0 +1,177 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ * `adressur-fo`: the Faroese national address register, `Adressur`, which Umhvørvisstovan (the Faroese
+ * Environment Agency) serves as the ArcGIS MapServer layer `adressur/us_adr_husanr/MapServer/0` on
+ * `gis.us.fo`.
+ *
+ * Input is the layer queried whole as GeoJSON (`query?where=1=1&outFields=*&f=geojson&outSR=4326`), one
+ * FeatureCollection, or a directory of such page files read in name order. Each feature's `properties`
+ * hold the register's columns. The register states no absent value as a sentinel: `house_letter` is the
+ * empty string when a number has no letter, and every row carries a street, since Faroese villages name
+ * their lanes and paths too (`Heimi í Húsi`, `Suðuri á Bø`).
+ *
+ * The adapter reads `street_name` as the street, `house_digit` with `house_letter` as the house number
+ * (their concatenation equals the register's own `house_no` on every row), `zip` as the postcode and
+ * `city` as the postal locality. Two postal localities carry a comma that disambiguates them,
+ * `Nes, Eysturoy` and `Syðradalur, Kalsoy`, and the adapter keeps them as the register spells them.
+ * `municipality` is left out, because the FO layout prints no region.
+ *
+ * Umhvørvisstovan grants anyone a free, worldwide right to copy, distribute, publish, modify and combine
+ * the data, for commercial and non-commercial use, on condition that the source is credited as
+ * `Data from the Faroese Environment Agency, Umhvørvisstovan: Adressur, <date>` and the terms are made
+ * available to third parties. Every row records those terms.
+ */
+import { formatAddressRow } from "@mailwoman/codex/address/format";
+import { matchCountryPostcode } from "@mailwoman/codex/postcode/country-formats";
+import { readLocalTextFile } from "@mailwoman/core/fs/readers";
+import { tryStat } from "@mailwoman/core/fs/readers/stat";
+import { parseJSONStrict } from "@mailwoman/core/json";
+import { resolvePath } from "path-ts";
+import { Globerator } from "spliterator/node/fs";
+import { UnsupportedCountryError } from "#adapters/errors";
+import { stableSourceIDFromParts } from "#adapters/source-id";
+import { composeHouseNumber } from "#adapters/street-line";
+import { SourceRegister } from "#registers";
+import { AddressRole, countDropped, SurfaceOrigin, } from "#types";
+/**
+ * Registry id for this adapter, stamped into every row it emits.
+ */
+export const ADRESSUR_FO_ADAPTER_ID = "adressur-fo";
+/**
+ * Umhvørvisstovan's `Brúksrættur og treytir` (June 2019).
+ * They have no SPDX identifier.
+ */
+export const ADRESSUR_FO_LICENSE = "LicenseRef-FO-Umhvorvisstovan-Brukstreytir";
+/**
+ * Every jurisdiction this adapter emits, checked against a caller's `--country`.
+ */
+export const ADRESSUR_FO_COUNTRIES = ["FO"];
+function present(value) {
+    if (value == null)
+        return null;
+    const trimmed = String(value).trim();
+    return trimmed || null;
+}
+/**
+ * Maps one record onto the components the corpus asserts, or returns null when the row is refused.
+ *
+ * Each refusal increments its reason in `dropped`.
+ */
+export function componentsForAdressurRecord(record, dropped) {
+    const tally = dropped ?? {};
+    const street = present(record.street_name);
+    if (!street) {
+        countDropped(tally, "row:no-street");
+        return null;
+    }
+    const number = composeHouseNumber(present(record.house_digit) ?? "", present(record.house_letter) ?? "");
+    if (!number) {
+        countDropped(tally, "row:no-house-number");
+        return null;
+    }
+    const components = {
+        street,
+        house_number: number,
+    };
+    const postcode = present(record.zip);
+    const matched = postcode ? matchCountryPostcode(postcode, "FO") : null;
+    if (matched) {
+        components.postcode = matched;
+    }
+    else if (postcode) {
+        countDropped(tally, "component:postcode:not-country-format");
+    }
+    const locality = present(record.city);
+    if (locality) {
+        components.locality = locality;
+    }
+    if (!components.locality && !components.postcode) {
+        countDropped(tally, "row:no-locality-or-postcode");
+        return null;
+    }
+    return components;
+}
+/**
+ * The GeoJSON files an input names: the file itself, or every `.geojson` in a directory, in name order.
+ */
+async function pageFiles(inputPath) {
+    const stat = await tryStat(inputPath);
+    if (!stat?.isDirectory())
+        return [inputPath];
+    const names = await Globerator.from("*.geojson", {
+        cwd: inputPath,
+        absolute: false,
+    }).toSorted();
+    return names.map((name) => `${inputPath}/${name}`);
+}
+export function createAdressurFaroeAdapter() {
+    return {
+        id: ADRESSUR_FO_ADAPTER_ID,
+        defaultLicense: ADRESSUR_FO_LICENSE,
+        addressRole: AddressRole.Premise,
+        register: SourceRegister.FaroeAdressur,
+        surface: SurfaceOrigin.Rendered,
+        description: "Adressur (Umhvørvisstovan): the national address register of the Faroe Islands.",
+        async *rows(opts) {
+            if (opts.country && !ADRESSUR_FO_COUNTRIES.includes(opts.country)) {
+                throw new UnsupportedCountryError(ADRESSUR_FO_ADAPTER_ID, ADRESSUR_FO_COUNTRIES, opts.country);
+            }
+            let emitted = 0;
+            for (const file of await pageFiles(resolvePath(opts.inputPath))) {
+                // The whole layer is one 20 MB response, so each page is parsed whole.
+                const collection = parseJSONStrict(await readLocalTextFile(file));
+                if (!Array.isArray(collection.features)) {
+                    throw new TypeError(`${ADRESSUR_FO_ADAPTER_ID} adapter: ${file} holds no GeoJSON features array`);
+                }
+                for (const feature of collection.features) {
+                    if (opts.signal?.aborted)
+                        return;
+                    if (opts.limit !== undefined && emitted >= opts.limit)
+                        return;
+                    const record = feature.properties;
+                    if (!record) {
+                        countDropped(opts, "row:no-properties");
+                        continue;
+                    }
+                    const components = componentsForAdressurRecord(record, opts);
+                    if (!components)
+                        continue;
+                    const rendered = formatAddressRow(components, "FO", {
+                        singleLine: true,
+                    });
+                    if (!rendered) {
+                        countDropped(opts, "row:render-failed");
+                        continue;
+                    }
+                    for (const tag of rendered.unplaced) {
+                        countDropped(opts, `component:${tag}:not-rendered`);
+                    }
+                    const { raw, components: aligned } = rendered;
+                    yield {
+                        raw,
+                        components: aligned,
+                        country: "FO",
+                        locale: "fo-FO",
+                        source: ADRESSUR_FO_ADAPTER_ID,
+                        // `address_id` is the register's own identifier, unique per feature.
+                        source_id: stableSourceIDFromParts(ADRESSUR_FO_ADAPTER_ID, {
+                            ...aligned,
+                            address_id: present(record.address_id) ?? "",
+                        }),
+                        corpus_version: "",
+                        license: ADRESSUR_FO_LICENSE,
+                    };
+                    emitted++;
+                }
+            }
+        },
+    };
+}
+/**
+ * The configured adapter instance registered with the corpus builder.
+ */
+export const adressurFaroeAdapter = createAdressurFaroeAdapter();
+//# sourceMappingURL=adapter.js.map

package/out/fo/adapters/adressur/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../../lib/fo/adapters/adressur/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAA;AAChF,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAA;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAEhD,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAA;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAC3C,OAAO,EACN,WAAW,EAIX,YAAY,EACZ,aAAa,GACb,MAAM,QAAQ,CAAA;AAEf;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,aAAa,CAAA;AAEnD;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,4CAA4C,CAAA;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAsB,CAAC,IAAI,CAAC,CAAA;AAkB9D,SAAS,OAAO,CAAC,KAAyC;IACzD,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,IAAI,CAAA;IAE9B,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAA;IAEpC,OAAO,OAAO,IAAI,IAAI,CAAA;AACvB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CAC1C,MAAsB,EACtB,OAAyC;IAEzC,MAAM,KAAK,GAAG,OAAO,IAAI,EAAE,CAAA;IAC3B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,CAAA;IAE1C,IAAI,CAAC,MAAM,EAAE,CAAC;QACb,YAAY,CAAC,KAAK,EAAE,eAAe,CAAC,CAAA;QAEpC,OAAO,IAAI,CAAA;IACZ,CAAC;IAED,MAAM,MAAM,GAAG,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CAAA;IAExG,IAAI,CAAC,MAAM,EAAE,CAAC;QACb,YAAY,CAAC,KAAK,EAAE,qBAAqB,CAAC,CAAA;QAE1C,OAAO,IAAI,CAAA;IACZ,CAAC;IAED,MAAM,UAAU,GAA+B;QAC9C,MAAM;QACN,YAAY,EAAE,MAAM;KACpB,CAAA;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IACpC,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,oBAAoB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IAEtE,IAAI,OAAO,EAAE,CAAC;QACb,UAAU,CAAC,QAAQ,GAAG,OAAO,CAAA;IAC9B,CAAC;SAAM,IAAI,QAAQ,EAAE,CAAC;QACrB,YAAY,CAAC,KAAK,EAAE,uCAAuC,CAAC,CAAA;IAC7D,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAErC,IAAI,QAAQ,EAAE,CAAC;QACd,UAAU,CAAC,QAAQ,GAAG,QAAQ,CAAA;IAC/B,CAAC;IAED,IAAI,CAAC,UAAU,CAAC,QAAQ,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;QAClD,YAAY,CAAC,KAAK,EAAE,6BAA6B,CAAC,CAAA;QAElD,OAAO,IAAI,CAAA;IACZ,CAAC;IAED,OAAO,UAAU,CAAA;AAClB,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,SAAS,CAAC,SAAiB;IACzC,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,CAAA;IAErC,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE;QAAE,OAAO,CAAC,SAAS,CAAC,CAAA;IAE5C,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE;QAChD,GAAG,EAAE,SAAS;QACd,QAAQ,EAAE,KAAK;KACf,CAAC,CAAC,QAAQ,EAAE,CAAA;IAEb,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,SAAS,IAAI,IAAI,EAAE,CAAC,CAAA;AACnD,CAAC;AAED,MAAM,UAAU,0BAA0B;IACzC,OAAO;QACN,EAAE,EAAE,sBAAsB;QAC1B,cAAc,EAAE,mBAAmB;QACnC,WAAW,EAAE,WAAW,CAAC,OAAO;QAChC,QAAQ,EAAE,cAAc,CAAC,aAAa;QACtC,OAAO,EAAE,aAAa,CAAC,QAAQ;QAC/B,WAAW,EAAE,iFAAiF;QAE9F,KAAK,CAAC,CAAC,IAAI,CAAC,IAAoB;YAC/B,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;gBACnE,MAAM,IAAI,uBAAuB,CAAC,sBAAsB,EAAE,qBAAqB,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;YAC/F,CAAC;YAED,IAAI,OAAO,GAAG,CAAC,CAAA;YAEf,KAAK,MAAM,IAAI,IAAI,MAAM,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;gBACjE,uEAAuE;gBACvE,MAAM,UAAU,GAAG,eAAe,CAA4B,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAA;gBAE5F,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;oBACzC,MAAM,IAAI,SAAS,CAAC,GAAG,sBAAsB,aAAa,IAAI,kCAAkC,CAAC,CAAA;gBAClG,CAAC;gBAED,KAAK,MAAM,OAAO,IAAI,UAAU,CAAC,QAAQ,EAAE,CAAC;oBAC3C,IAAI,IAAI,CAAC,MAAM,EAAE,OAAO;wBAAE,OAAM;oBAEhC,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,IAAI,IAAI,CAAC,KAAK;wBAAE,OAAM;oBAE7D,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAAA;oBAEjC,IAAI,CAAC,MAAM,EAAE,CAAC;wBACb,YAAY,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAA;wBAEvC,SAAQ;oBACT,CAAC;oBAED,MAAM,UAAU,GAAG,2BAA2B,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;oBAE5D,IAAI,CAAC,UAAU;wBAAE,SAAQ;oBAEzB,MAAM,QAAQ,GAAG,gBAAgB,CAAC,UAAU,EAAE,IAAI,EAAE;wBACnD,UAAU,EAAE,IAAI;qBAChB,CAAC,CAAA;oBAEF,IAAI,CAAC,QAAQ,EAAE,CAAC;wBACf,YAAY,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAA;wBAEvC,SAAQ;oBACT,CAAC;oBAED,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;wBACrC,YAAY,CAAC,IAAI,EAAE,aAAa,GAAG,eAAe,CAAC,CAAA;oBACpD,CAAC;oBAED,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAA;oBAE7C,MAAM;wBACL,GAAG;wBACH,UAAU,EAAE,OAAO;wBACnB,OAAO,EAAE,IAAI;wBACb,MAAM,EAAE,OAAO;wBACf,MAAM,EAAE,sBAAsB;wBAC9B,qEAAqE;wBACrE,SAAS,EAAE,uBAAuB,CAAC,sBAAsB,EAAE;4BAC1D,GAAG,OAAO;4BACV,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE;yBAC5C,CAAC;wBACF,cAAc,EAAE,EAAE;wBAClB,OAAO,EAAE,mBAAmB;qBAC5B,CAAA;oBAED,OAAO,EAAE,CAAA;gBACV,CAAC;YACF,CAAC;QACF,CAAC;KACD,CAAA;AACF,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,0BAA0B,EAAE,CAAA"}

package/out/gb/adapters/os-open/adapter.d.ts

@@ -62,6 +62,14 @@ export declare const GB_OS_OPEN_PRODUCT_DIRECTORIES: {
     readonly openNames: "open-names";
     readonly openRoads: "open-roads";
 };
+/**
+ * The rows `mailwoman corpus run gb-os-open --out $MAILWOMAN_DATA_ROOT/corpus/staging/gb-os-open` writes.
+ *
+ * The `locale` recipe's GB part and corpus-python's `countries/gb/tuples.py` read
+ * their Great Britain address skeletons from this file.
+ * The Python reader spells the same path parts.
+ */
+export declare function gbOSOpenCanonicalRowsPath(): PathBuilder;
 /**
  * The bands the drawn house number comes from.
  *

package/out/gb/adapters/os-open/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../lib/gb/adapters/os-open/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AASH,OAAO,EAAE,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,SAAS,CAAA;AAM3D,OAAO,EACN,wBAAwB,EAIxB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,wBAAwB,EAAsB,MAAM,wBAAwB,CAAA;AAErF,OAAO,EAAgB,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACzE,OAAO,EAAuD,KAAK,aAAa,EAAiB,MAAM,QAAQ,CAAA;AAE/G;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,eAAe,CAAA;AAEjD;;GAEG;AACH,eAAO,MAAM,kBAAkB,eAAe,CAAA;AAE9C;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EAAW,CAAA;AAE7D;;GAEG;AACH,eAAO,MAAM,wBAAwB,MAAM,CAAA;AAE3C;;GAEG;AACH,eAAO,MAAM,8BAA8B;aAC1C,aAAa,EAAE,iBAAiB;aAChC,SAAS,EAAE,YAAY;aACvB,SAAS,EAAE,YAAY;CACd,CAAA;AAEV;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,EAAE,SAAS,gBAAgB,EAIpE,CAAA;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B;;OAEG;IACH,aAAa,EAAE,MAAM,CAAA;IACrB;;OAEG;IACH,kBAAkB,EAAE,MAAM,CAAA;IAC1B;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC3B;;OAEG;IACH,uBAAuB,EAAE,MAAM,CAAA;IAC/B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE;QACR;;WAEG;QACH,YAAY,EAAE,MAAM,CAAA;QACpB;;WAEG;QACH,gBAAgB,EAAE,MAAM,CAAA;QACxB;;WAEG;QACH,kBAAkB,EAAE,MAAM,CAAA;QAC1B;;WAEG;QACH,cAAc,EAAE,MAAM,CAAA;QACtB;;WAEG;QACH,gBAAgB,EAAE,MAAM,CAAA;KACxB,CAAA;IACD;;OAEG;IACH,OAAO,EAAE,MAAM,CAAA;IACf;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAA;IACzB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAA;IAClB;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAA;IACzB,KAAK,EAAE,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAA;IAClD,KAAK,EAAE,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAA;CAClD;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACtC;;OAEG;IACH,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,CAAA;CAC9C;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACzC,SAAS,EAAE,eAAe,GACxB,OAAO,CAAC,MAAM,CAAC,MAAM,OAAO,8BAA8B,EAAE,WAAW,CAAC,CAAC,CAkB3E;AAiBD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAI1D;AAqBD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,sBAA2B,GAAG,aAAa,CAoMzF;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,eAA0B,CAAA"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../lib/gb/adapters/os-open/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAUH,OAAO,EAAE,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,SAAS,CAAA;AAM3D,OAAO,EACN,wBAAwB,EAIxB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,wBAAwB,EAAsB,MAAM,wBAAwB,CAAA;AAErF,OAAO,EAAgB,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACzE,OAAO,EAAuD,KAAK,aAAa,EAAiB,MAAM,QAAQ,CAAA;AAE/G;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,eAAe,CAAA;AAEjD;;GAEG;AACH,eAAO,MAAM,kBAAkB,eAAe,CAAA;AAE9C;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EAAW,CAAA;AAE7D;;GAEG;AACH,eAAO,MAAM,wBAAwB,MAAM,CAAA;AAE3C;;GAEG;AACH,eAAO,MAAM,8BAA8B;aAC1C,aAAa,EAAE,iBAAiB;aAChC,SAAS,EAAE,YAAY;aACvB,SAAS,EAAE,YAAY;CACd,CAAA;AAEV;;;;;;GAMG;AACH,wBAAgB,yBAAyB,IAAI,WAAW,CAEvD;AAED;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,EAAE,SAAS,gBAAgB,EAIpE,CAAA;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B;;OAEG;IACH,aAAa,EAAE,MAAM,CAAA;IACrB;;OAEG;IACH,kBAAkB,EAAE,MAAM,CAAA;IAC1B;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC3B;;OAEG;IACH,uBAAuB,EAAE,MAAM,CAAA;IAC/B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE;QACR;;WAEG;QACH,YAAY,EAAE,MAAM,CAAA;QACpB;;WAEG;QACH,gBAAgB,EAAE,MAAM,CAAA;QACxB;;WAEG;QACH,kBAAkB,EAAE,MAAM,CAAA;QAC1B;;WAEG;QACH,cAAc,EAAE,MAAM,CAAA;QACtB;;WAEG;QACH,gBAAgB,EAAE,MAAM,CAAA;KACxB,CAAA;IACD;;OAEG;IACH,OAAO,EAAE,MAAM,CAAA;IACf;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAA;IACzB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAA;IAClB;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAA;IACzB,KAAK,EAAE,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAA;IAClD,KAAK,EAAE,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAA;CAClD;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACtC;;OAEG;IACH,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,CAAA;CAC9C;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACzC,SAAS,EAAE,eAAe,GACxB,OAAO,CAAC,MAAM,CAAC,MAAM,OAAO,8BAA8B,EAAE,WAAW,CAAC,CAAC,CAkB3E;AAiBD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAI1D;AAqBD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,sBAA2B,GAAG,aAAa,CAoMzF;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,eAA0B,CAAA"}

package/out/gb/adapters/os-open/adapter.js

@@ -32,6 +32,7 @@
 import { formatAddressRow } from "@mailwoman/codex/address/format";
 import { titleCaseGB } from "@mailwoman/codex/gb/place-name";
 import { outwardCode } from "@mailwoman/codex/gb/postcode";
+import { dataRootPath } from "@mailwoman/core/data-root";
 import { pathExists } from "@mailwoman/core/fs/readers/stat";
 import { stringifyJSON } from "@mailwoman/core/json";
 import { mulberry32 } from "@mailwoman/core/random";
@@ -74,6 +75,16 @@ export const GB_OS_OPEN_PRODUCT_DIRECTORIES = {
     openNames: "open-names",
     openRoads: "open-roads",
 };
+/**
+ * The rows `mailwoman corpus run gb-os-open --out $MAILWOMAN_DATA_ROOT/corpus/staging/gb-os-open` writes.
+ *
+ * The `locale` recipe's GB part and corpus-python's `countries/gb/tuples.py` read
+ * their Great Britain address skeletons from this file.
+ * The Python reader spells the same path parts.
+ */
+export function gbOSOpenCanonicalRowsPath() {
+    return dataRootPath("corpus", "staging", GB_OS_OPEN_ADAPTER_ID, GB_OS_OPEN_ADAPTER_ID, "canonical.jsonl");
+}
 /**
  * The bands the drawn house number comes from.
  *

package/out/gb/adapters/os-open/adapter.js.map

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

package/out/gb/county.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   The county or unitary authority of a GB postcode, read from the unit-postcode entries of OS Open Names.
+ *
+ *   A GB address commonly ends its locality with a county, as in `King's Lynn, Norfolk` or
+ *   `38 High Street, Maidstone, Kent ME14 1JH`. The rows a corpus renders from `gb-os-open` take their
+ *   region from {@link openConstituentCountryReader}, which answers England, Scotland or Wales, so a model
+ *   trained on them alone sees no county in the region position and reads `Norfolk` as a locality.
+ *   OS Open Names publishes one entry per unit postcode with its `COUNTY_UNITARY`, under the same
+ *   Open Government Licence as the other two products the adapter reads.
+ */
+import { PathBuilder, type PathBuilderLike } from "path-ts";
+/**
+ * The Open Names product the `gb-os-open` fetch writes under the data root.
+ */
+export declare function gbOpenNamesDirectory(): PathBuilder;
+/**
+ * Reads every unit postcode of OS Open Names and returns a map from the postcode
+ * to its county or unitary authority.
+ *
+ * A postcode whose entry names no county is left out of the map.
+ *
+ * @throws When the directory holds no `Data/*.csv`, so a missing product reports itself
+ * rather than reading as a map with no county.
+ */
+export declare function readCountyOfPostcode(openNamesDirectory?: PathBuilderLike): Promise<Map<string, string>>;
+//# sourceMappingURL=county.d.ts.map

package/out/gb/county.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"county.d.ts","sourceRoot":"","sources":["../../lib/gb/county.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,SAAS,CAAA;AAM3D;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,WAAW,CAElD;AAED;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CACzC,kBAAkB,GAAE,eAAwC,GAC1D,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAkB9B"}

package/out/gb/county.js

@@ -0,0 +1,51 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   The county or unitary authority of a GB postcode, read from the unit-postcode entries of OS Open Names.
+ *
+ *   A GB address commonly ends its locality with a county, as in `King's Lynn, Norfolk` or
+ *   `38 High Street, Maidstone, Kent ME14 1JH`. The rows a corpus renders from `gb-os-open` take their
+ *   region from {@link openConstituentCountryReader}, which answers England, Scotland or Wales, so a model
+ *   trained on them alone sees no county in the region position and reads `Norfolk` as a locality.
+ *   OS Open Names publishes one entry per unit postcode with its `COUNTY_UNITARY`, under the same
+ *   Open Government Licence as the other two products the adapter reads.
+ */
+import { dataRootPath } from "@mailwoman/core/data-root";
+import { PathBuilder } from "path-ts";
+import { Globerator } from "spliterator/node/fs";
+import { GB_OS_OPEN_ADAPTER_ID, GB_OS_OPEN_PRODUCT_DIRECTORIES } from "#gb/adapters/os-open/adapter";
+import { createOpenNamesReadStats, readOpenNamesPostcodeCounties } from "#gb/os-open/open/names";
+/**
+ * The Open Names product the `gb-os-open` fetch writes under the data root.
+ */
+export function gbOpenNamesDirectory() {
+    return dataRootPath("corpus", "sources", GB_OS_OPEN_ADAPTER_ID, GB_OS_OPEN_PRODUCT_DIRECTORIES.openNames);
+}
+/**
+ * Reads every unit postcode of OS Open Names and returns a map from the postcode
+ * to its county or unitary authority.
+ *
+ * A postcode whose entry names no county is left out of the map.
+ *
+ * @throws When the directory holds no `Data/*.csv`, so a missing product reports itself
+ * rather than reading as a map with no county.
+ */
+export async function readCountyOfPostcode(openNamesDirectory = gbOpenNamesDirectory()) {
+    const directory = PathBuilder.from(openNamesDirectory);
+    const files = await Globerator.from("Data/*.csv", { cwd: directory.toString(), absolute: false }).toSorted();
+    if (!files.length)
+        throw new Error(`${directory.toString()} holds no Data/*.csv`);
+    const stats = createOpenNamesReadStats();
+    const counties = new Map();
+    for (const file of files) {
+        for await (const entry of readOpenNamesPostcodeCounties(directory(file).toString(), stats)) {
+            if (entry.countyUnitary) {
+                counties.set(entry.postcode, entry.countyUnitary);
+            }
+        }
+    }
+    return counties;
+}
+//# sourceMappingURL=county.js.map

package/out/gb/county.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"county.js","sourceRoot":"","sources":["../../lib/gb/county.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AACxD,OAAO,EAAE,WAAW,EAAwB,MAAM,SAAS,CAAA;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAEhD,OAAO,EAAE,qBAAqB,EAAE,8BAA8B,EAAE,MAAM,8BAA8B,CAAA;AACpG,OAAO,EAAE,wBAAwB,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAA;AAEhG;;GAEG;AACH,MAAM,UAAU,oBAAoB;IACnC,OAAO,YAAY,CAAC,QAAQ,EAAE,SAAS,EAAE,qBAAqB,EAAE,8BAA8B,CAAC,SAAS,CAAC,CAAA;AAC1G,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACzC,kBAAkB,GAAoB,oBAAoB,EAAE;IAE5D,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAA;IACtD,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,GAAG,EAAE,SAAS,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAA;IAE5G,IAAI,CAAC,KAAK,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS,CAAC,QAAQ,EAAE,sBAAsB,CAAC,CAAA;IAEjF,MAAM,KAAK,GAAG,wBAAwB,EAAE,CAAA;IACxC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAA;IAE1C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,6BAA6B,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,KAAK,CAAC,EAAE,CAAC;YAC5F,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;gBACzB,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,aAAa,CAAC,CAAA;YAClD,CAAC;QACF,CAAC;IACF,CAAC;IAED,OAAO,QAAQ,CAAA;AAChB,CAAC"}

package/out/gb/os-open/open/names.d.ts

@@ -83,6 +83,23 @@ export declare function createOpenNamesReadStats(): OpenNamesReadStats;
  * @param ids When given, only roads whose `ID` is in the set are yielded.
  */
 export declare function readOpenNamesRoads(csvPath: string, stats: OpenNamesReadStats, ids?: ReadonlySet<string>): AsyncGenerator<OpenNamesRoad>;
+/**
+ * One unit postcode of OS Open Names with the county or unitary authority holding it.
+ */
+export interface OpenNamesPostcodeCounty {
+    /**
+     * The postcode as OS writes it in `NAME1`, such as `ME14 1JH`.
+     */
+    postcode: string;
+    /**
+     * The `COUNTY_UNITARY` name, such as `Kent`, or an empty string where OS records none.
+     */
+    countyUnitary: string;
+}
+/**
+ * Streams the unit-postcode rows of one Open Names CSV with their county or unitary authority.
+ */
+export declare function readOpenNamesPostcodeCounties(csvPath: string, stats: OpenNamesReadStats): AsyncGenerator<OpenNamesPostcodeCounty>;
 /**
  * The settlement's first-listed name from a `POPULATED_PLACE` value.
  *

package/out/gb/os-open/open/names.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"names.d.ts","sourceRoot":"","sources":["../../../../lib/gb/os-open/open/names.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH;;GAEG;AACH,eAAO,MAAM,kBAAkB,YAC9B,IAAI,EACJ,WAAW,EACX,OAAO,EACP,YAAY,EACZ,OAAO,EACP,YAAY,EACZ,MAAM,EACN,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,sBAAsB,EACtB,uBAAuB,EACvB,UAAU,EACV,UAAU,EACV,UAAU,EACV,UAAU,EACV,mBAAmB,EACnB,uBAAuB,EACvB,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACtB,kBAAkB,EAClB,sBAAsB,EACtB,uBAAuB,EACvB,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,QAAQ,EACR,YAAY,EACZ,SAAS,EACT,aAAa,EACb,wBAAwB,EACxB,iBAAiB,EACjB,kBAAkB,CACT,CAAA;AAOV;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAAC,MAAM,CAAoD,CAAA;AAE1G;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAA;IACV;;OAEG;IACH,KAAK,EAAE,MAAM,CAAA;IACb;;OAEG;IACH,KAAK,EAAE,MAAM,CAAA;IACb;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAA;IACxB;;;;;OAKG;IACH,cAAc,EAAE,MAAM,CAAA;IACtB,eAAe,EAAE,MAAM,CAAA;IACvB,aAAa,EAAE,MAAM,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ;;OAEG;IACH,KAAK,EAAE,MAAM,CAAA;IACb;;OAEG;IACH,WAAW,EAAE,MAAM,CAAA;IACnB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,kBAAkB,CAE7D;AAED;;;;GAIG;AACH,wBAAuB,kBAAkB,CACxC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,kBAAkB,EACzB,GAAG,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GACvB,cAAc,CAAC,aAAa,CAAC,CAgC/B;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAElE"}
+{"version":3,"file":"names.d.ts","sourceRoot":"","sources":["../../../../lib/gb/os-open/open/names.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH;;GAEG;AACH,eAAO,MAAM,kBAAkB,YAC9B,IAAI,EACJ,WAAW,EACX,OAAO,EACP,YAAY,EACZ,OAAO,EACP,YAAY,EACZ,MAAM,EACN,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,sBAAsB,EACtB,uBAAuB,EACvB,UAAU,EACV,UAAU,EACV,UAAU,EACV,UAAU,EACV,mBAAmB,EACnB,uBAAuB,EACvB,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACtB,kBAAkB,EAClB,sBAAsB,EACtB,uBAAuB,EACvB,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,QAAQ,EACR,YAAY,EACZ,SAAS,EACT,aAAa,EACb,wBAAwB,EACxB,iBAAiB,EACjB,kBAAkB,CACT,CAAA;AAOV;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAAC,MAAM,CAAoD,CAAA;AAE1G;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAA;IACV;;OAEG;IACH,KAAK,EAAE,MAAM,CAAA;IACb;;OAEG;IACH,KAAK,EAAE,MAAM,CAAA;IACb;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAA;IACxB;;;;;OAKG;IACH,cAAc,EAAE,MAAM,CAAA;IACtB,eAAe,EAAE,MAAM,CAAA;IACvB,aAAa,EAAE,MAAM,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ;;OAEG;IACH,KAAK,EAAE,MAAM,CAAA;IACb;;OAEG;IACH,WAAW,EAAE,MAAM,CAAA;IACnB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,kBAAkB,CAE7D;AAED;;;;GAIG;AACH,wBAAuB,kBAAkB,CACxC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,kBAAkB,EACzB,GAAG,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GACvB,cAAc,CAAC,aAAa,CAAC,CAgC/B;AAOD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACvC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAA;CACrB;AAED;;GAEG;AACH,wBAAuB,6BAA6B,CACnD,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,kBAAkB,GACvB,cAAc,CAAC,uBAAuB,CAAC,CAczC;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAElE"}

package/out/gb/os-open/open/names.js

@@ -96,6 +96,25 @@ export async function* readOpenNamesRoads(csvPath, stats, ids) {
         };
     }
 }
+/**
+ * The `LOCAL_TYPE` of the one Open Names entry OS publishes for each unit postcode.
+ */
+const OPEN_NAMES_POSTCODE_TYPE = "Postcode";
+/**
+ * Streams the unit-postcode rows of one Open Names CSV with their county or unitary authority.
+ */
+export async function* readOpenNamesPostcodeCounties(csvPath, stats) {
+    for await (const row of CSVSpliterator.fromAsync(csvPath, { header: false })) {
+        stats.read++;
+        if (row.length !== OPEN_NAMES_COLUMNS.length) {
+            stats.malformed++;
+            continue;
+        }
+        if (row[column.LOCAL_TYPE] !== OPEN_NAMES_POSTCODE_TYPE)
+            continue;
+        yield { postcode: row[column.NAME1].trim(), countyUnitary: row[column.COUNTY_UNITARY].trim() };
+    }
+}
 /**
  * The settlement's first-listed name from a `POPULATED_PLACE` value.
  *

package/out/gb/os-open/open/names.js.map

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

package/out/gu/adapters/bsp/adapter.d.ts

@@ -0,0 +1,83 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ * `bsp-gu`: the address points of Guam, which the Bureau of Statistics & Plans GIS publishes on the
+ * Government of Guam GISWEB Portal as the ArcGIS layer `Address_Point_(Public_View)`.
+ *
+ * The input is the layer's GeoJSON query pages, one file or a directory of them. The adapter reads
+ * `HOUSE_NUM` as the house number, `PRE_DIR` as the street prefix, `STREETNAME` as the street (or the
+ * assembled `FullRdNm` when `STREETNAME` is blank), `STR_TYPE` as the street suffix, `UNIT` as the unit
+ * and `CITY` (or `PLACENAME` when `CITY` is blank) as the locality. Route roads read `ROUTE 10` with the
+ * type `HWY`, which is how the layer's own `FullRdNm` writes them.
+ *
+ * The layer carries no postcode: its NG911 `Post_Code` column is blank on every feature.
+ *
+ * `HOUSE_NUM` sometimes pairs the number with a building-permit number (`120 / B19000483`); the number is
+ * kept and the permit dropped. `CITY` writes Guam's villages with Chamorro and English spellings
+ * (`HAGÅTÑA`, `HAGATNA`; `INARAJAN`, `INALAHAN`) and with typing slips (`BARRIGDAA`, `MANGIL.AO`), so a
+ * value is kept only when each of its parts is a village, or a community the villages contain,
+ * listed in {@link GUAM_PLACE_NAMES}. A road written `(OFF OF) ROUTE 4A HWY` locates a point near a road
+ * rather than on it, and a street naming two roads (`AGUILAR RD / RT 17`) states no single street, so both
+ * are refused.
+ *
+ * The layer states no license. Under the United States position in `packages/corpus/lib/us/AGENTS.md`
+ * (Feist), a US public body's address file published without terms restricting its use is elected,
+ * and the rows carry the label the US public-body adapters use.
+ */
+import { type AdapterOptions, type CanonicalRow, type CorpusAdapter } from "#types";
+/**
+ * Registry id for this adapter, stamped into every row it emits.
+ */
+export declare const BSP_GU_ADAPTER_ID = "bsp-gu";
+/**
+ * The label every row carries, matching the US public-body adapters elected under the Feist reading.
+ */
+export declare const BSP_GU_LICENSE = "Public Domain";
+/**
+ * Every jurisdiction this adapter emits, checked against a caller's `--country`.
+ */
+export declare const BSP_GU_COUNTRIES: readonly string[];
+/**
+ * The feature properties the adapter reads from the layer.
+ */
+export interface GuamAddressPointRecord {
+    FID?: number | null;
+    HOUSE_NUM?: string | null;
+    PRE_DIR?: string | null;
+    STREETNAME?: string | null;
+    STR_TYPE?: string | null;
+    FullRdNm?: string | null;
+    UNIT?: string | null;
+    CITY?: string | null;
+    PLACENAME?: string | null;
+}
+/**
+ * Guam's nineteen villages under each name the layer writes for them,
+ * and the communities within a village that `CITY` names on its own
+ * (Tumon and Harmon in Tamuning, Ipan in Talofofo, Paasan in Agana Heights, Anigua in Hagåtña), folded.
+ */
+export declare const GUAM_PLACE_NAMES: ReadonlySet<string>;
+/**
+ * Whether every part of a place value, split at commas, slashes, hyphens and parentheses,
+ * is a listed place: `CHALAN PAGO - ORDOT` and `AGANA HEIGHTS (PAASAN)` are, `RADIO, BARRIGADA` is not.
+ */
+export declare function isGuamPlaceName(value: string): boolean;
+/**
+ * The house number `HOUSE_NUM` states, with a building-permit number written beside
+ * it removed, or null when the value is not a house number.
+ */
+export declare function guamHouseNumber(value: string): string | null;
+/**
+ * Maps one record onto the components the corpus asserts, or returns null when the row is refused.
+ *
+ * Each refusal and each dropped component increments its reason in `dropped`.
+ */
+export declare function componentsForGuamRecord(record: GuamAddressPointRecord, dropped?: Pick<AdapterOptions, "dropped">): CanonicalRow["components"] | null;
+export declare function createGuamAddressPointsAdapter(): CorpusAdapter;
+/**
+ * The configured adapter instance registered with the corpus builder.
+ */
+export declare const guamAddressPointsAdapter: CorpusAdapter;
+//# sourceMappingURL=adapter.d.ts.map

package/out/gu/adapters/bsp/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../lib/gu/adapters/bsp/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAaH,OAAO,EAEN,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,aAAa,EAGlB,MAAM,QAAQ,CAAA;AAEf;;GAEG;AACH,eAAO,MAAM,iBAAiB,WAAW,CAAA;AAEzC;;GAEG;AACH,eAAO,MAAM,cAAc,kBAAkB,CAAA;AAE7C;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,MAAM,EAAW,CAAA;AAEzD;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACtC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB;AA0BD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAuC/C,CAAA;AAEF;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAOtD;AAaD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAe5D;AAkCD;;;;GAIG;AACH,wBAAgB,uBAAuB,CACtC,MAAM,EAAE,sBAAsB,EAC9B,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,GACvC,YAAY,CAAC,YAAY,CAAC,GAAG,IAAI,CAmGnC;AAeD,wBAAgB,8BAA8B,IAAI,aAAa,CAgF9D;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB,eAAmC,CAAA"}