@mailwoman/corpus 10.3.0 → 10.5.0

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

@@ -0,0 +1,92 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Reads the road rows of OS Open Names.
+ *
+ *   The CSV product is 819 files, one per 10 km National Grid square, with no header row. OS ships
+ *   the 34 column names in `Doc/OS_Open_Names_Header.csv`, and the first data row of each file opens
+ *   with a byte-order mark, which this reader strips from the `ID` value.
+ *
+ *   A road row's `ID` is the roadNameTOID that OS Open Roads links reference, such as
+ *   `osgb4000000010927776`. Two `LOCAL_TYPE` values are roads: `Named Road`, and
+ *   `Section Of Named Road` for a road that OS splits where it crosses a postcode district or a
+ *   settlement.
+ */
+/**
+ * The 34 columns of an OS Open Names CSV, in file order, as `Doc/OS_Open_Names_Header.csv` names them.
+ */
+export declare const OPEN_NAMES_COLUMNS: readonly ["ID", "NAMES_URI", "NAME1", "NAME1_LANG", "NAME2", "NAME2_LANG", "TYPE", "LOCAL_TYPE", "GEOMETRY_X", "GEOMETRY_Y", "MOST_DETAIL_VIEW_RES", "LEAST_DETAIL_VIEW_RES", "MBR_XMIN", "MBR_YMIN", "MBR_XMAX", "MBR_YMAX", "POSTCODE_DISTRICT", "POSTCODE_DISTRICT_URI", "POPULATED_PLACE", "POPULATED_PLACE_URI", "POPULATED_PLACE_TYPE", "DISTRICT_BOROUGH", "DISTRICT_BOROUGH_URI", "DISTRICT_BOROUGH_TYPE", "COUNTY_UNITARY", "COUNTY_UNITARY_URI", "COUNTY_UNITARY_TYPE", "REGION", "REGION_URI", "COUNTRY", "COUNTRY_URI", "RELATED_SPATIAL_OBJECT", "SAME_AS_DBPEDIA", "SAME_AS_GEONAMES"];
+/**
+ * The `LOCAL_TYPE` values that mark a road row.
+ */
+export declare const OPEN_NAMES_ROAD_TYPES: ReadonlySet<string>;
+/**
+ * One road row of OS Open Names, with the columns the corpus adapter reads.
+ */
+export interface OpenNamesRoad {
+    /**
+     * The roadNameTOID, such as `osgb4000000010927776`.
+     */
+    id: string;
+    /**
+     * The road's name, in the language OS lists first.
+     */
+    name1: string;
+    /**
+     * The road's other-language name, Welsh or Gaelic, or an empty string.
+     */
+    name2: string;
+    /**
+     * The outward code of the postcode district holding the road, such as `LS6`.
+     */
+    postcodeDistrict: string;
+    /**
+     * The settlement holding the road, or an empty string.
+     *
+     * A bilingual settlement is written `<NAME1> / <NAME2>` of that settlement,
+     * such as `Stornoway / Steòrnabhagh`.
+     */
+    populatedPlace: string;
+    districtBorough: string;
+    countyUnitary: string;
+}
+/**
+ * Counts from a read, with a reason for each row that did not yield.
+ */
+export interface OpenNamesReadStats {
+    /**
+     * Rows read across every file.
+     */
+    read: number;
+    /**
+     * Road rows yielded.
+     */
+    roads: number;
+    /**
+     * Road rows skipped because their `ID` was not among the requested ids.
+     */
+    unrequested: number;
+    /**
+     * Rows with a column count other than 34.
+     */
+    malformed: number;
+}
+/**
+ * A stats object with every count at zero.
+ */
+export declare function createOpenNamesReadStats(): OpenNamesReadStats;
+/**
+ * Streams the road rows of one Open Names CSV.
+ *
+ * @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>;
+/**
+ * The settlement's first-listed name from a `POPULATED_PLACE` value.
+ *
+ * OS writes a bilingual settlement as `<NAME1> / <NAME2>`, and NAME1 is the form the adapter emits.
+ */
+export declare function populatedPlaceName1(populatedPlace: string): string;
+//# sourceMappingURL=open-names.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"open-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"}

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

@@ -0,0 +1,107 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Reads the road rows of OS Open Names.
+ *
+ *   The CSV product is 819 files, one per 10 km National Grid square, with no header row. OS ships
+ *   the 34 column names in `Doc/OS_Open_Names_Header.csv`, and the first data row of each file opens
+ *   with a byte-order mark, which this reader strips from the `ID` value.
+ *
+ *   A road row's `ID` is the roadNameTOID that OS Open Roads links reference, such as
+ *   `osgb4000000010927776`. Two `LOCAL_TYPE` values are roads: `Named Road`, and
+ *   `Section Of Named Road` for a road that OS splits where it crosses a postcode district or a
+ *   settlement.
+ */
+import { CSVSpliterator } from "spliterator";
+/**
+ * The 34 columns of an OS Open Names CSV, in file order, as `Doc/OS_Open_Names_Header.csv` names them.
+ */
+export const OPEN_NAMES_COLUMNS = [
+    "ID",
+    "NAMES_URI",
+    "NAME1",
+    "NAME1_LANG",
+    "NAME2",
+    "NAME2_LANG",
+    "TYPE",
+    "LOCAL_TYPE",
+    "GEOMETRY_X",
+    "GEOMETRY_Y",
+    "MOST_DETAIL_VIEW_RES",
+    "LEAST_DETAIL_VIEW_RES",
+    "MBR_XMIN",
+    "MBR_YMIN",
+    "MBR_XMAX",
+    "MBR_YMAX",
+    "POSTCODE_DISTRICT",
+    "POSTCODE_DISTRICT_URI",
+    "POPULATED_PLACE",
+    "POPULATED_PLACE_URI",
+    "POPULATED_PLACE_TYPE",
+    "DISTRICT_BOROUGH",
+    "DISTRICT_BOROUGH_URI",
+    "DISTRICT_BOROUGH_TYPE",
+    "COUNTY_UNITARY",
+    "COUNTY_UNITARY_URI",
+    "COUNTY_UNITARY_TYPE",
+    "REGION",
+    "REGION_URI",
+    "COUNTRY",
+    "COUNTRY_URI",
+    "RELATED_SPATIAL_OBJECT",
+    "SAME_AS_DBPEDIA",
+    "SAME_AS_GEONAMES",
+];
+const column = Object.fromEntries(OPEN_NAMES_COLUMNS.map((name, index) => [name, index]));
+/**
+ * The `LOCAL_TYPE` values that mark a road row.
+ */
+export const OPEN_NAMES_ROAD_TYPES = new Set(["Named Road", "Section Of Named Road"]);
+/**
+ * A stats object with every count at zero.
+ */
+export function createOpenNamesReadStats() {
+    return { read: 0, roads: 0, unrequested: 0, malformed: 0 };
+}
+/**
+ * Streams the road rows of one Open Names CSV.
+ *
+ * @param ids When given, only roads whose `ID` is in the set are yielded.
+ */
+export async function* readOpenNamesRoads(csvPath, stats, ids) {
+    for await (const row of CSVSpliterator.fromAsync(csvPath, { header: false })) {
+        stats.read++;
+        if (row.length !== OPEN_NAMES_COLUMNS.length) {
+            stats.malformed++;
+            continue;
+        }
+        if (!OPEN_NAMES_ROAD_TYPES.has(row[column.LOCAL_TYPE]))
+            continue;
+        const id = row[column.ID].replace(/^/u, "");
+        if (ids && !ids.has(id)) {
+            stats.unrequested++;
+            continue;
+        }
+        stats.roads++;
+        yield {
+            id,
+            name1: row[column.NAME1].trim(),
+            name2: row[column.NAME2].trim(),
+            postcodeDistrict: row[column.POSTCODE_DISTRICT].trim(),
+            populatedPlace: row[column.POPULATED_PLACE].trim(),
+            districtBorough: row[column.DISTRICT_BOROUGH].trim(),
+            countyUnitary: row[column.COUNTY_UNITARY].trim(),
+        };
+    }
+}
+/**
+ * The settlement's first-listed name from a `POPULATED_PLACE` value.
+ *
+ * OS writes a bilingual settlement as `<NAME1> / <NAME2>`, and NAME1 is the form the adapter emits.
+ */
+export function populatedPlaceName1(populatedPlace) {
+    return populatedPlace.split(" / ")[0].trim();
+}
+//# sourceMappingURL=open-names.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"open-names.js","sourceRoot":"","sources":["../../../lib/gb/os-open/open-names.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAE5C;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IACjC,IAAI;IACJ,WAAW;IACX,OAAO;IACP,YAAY;IACZ,OAAO;IACP,YAAY;IACZ,MAAM;IACN,YAAY;IACZ,YAAY;IACZ,YAAY;IACZ,sBAAsB;IACtB,uBAAuB;IACvB,UAAU;IACV,UAAU;IACV,UAAU;IACV,UAAU;IACV,mBAAmB;IACnB,uBAAuB;IACvB,iBAAiB;IACjB,qBAAqB;IACrB,sBAAsB;IACtB,kBAAkB;IAClB,sBAAsB;IACtB,uBAAuB;IACvB,gBAAgB;IAChB,oBAAoB;IACpB,qBAAqB;IACrB,QAAQ;IACR,YAAY;IACZ,SAAS;IACT,aAAa;IACb,wBAAwB;IACxB,iBAAiB;IACjB,kBAAkB;CACT,CAAA;AAEV,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAGvF,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAwB,IAAI,GAAG,CAAC,CAAC,YAAY,EAAE,uBAAuB,CAAC,CAAC,CAAA;AAuD1G;;GAEG;AACH,MAAM,UAAU,wBAAwB;IACvC,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAA;AAC3D,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,kBAAkB,CACxC,OAAe,EACf,KAAyB,EACzB,GAAyB;IAEzB,IAAI,KAAK,EAAE,MAAM,GAAG,IAAI,cAAc,CAAC,SAAS,CAAW,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;QACxF,KAAK,CAAC,IAAI,EAAE,CAAA;QAEZ,IAAI,GAAG,CAAC,MAAM,KAAK,kBAAkB,CAAC,MAAM,EAAE,CAAC;YAC9C,KAAK,CAAC,SAAS,EAAE,CAAA;YAEjB,SAAQ;QACT,CAAC;QAED,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAE,CAAC;YAAE,SAAQ;QAEjE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;QAE7C,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YACzB,KAAK,CAAC,WAAW,EAAE,CAAA;YAEnB,SAAQ;QACT,CAAC;QAED,KAAK,CAAC,KAAK,EAAE,CAAA;QAEb,MAAM;YACL,EAAE;YACF,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAE,CAAC,IAAI,EAAE;YAChC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAE,CAAC,IAAI,EAAE;YAChC,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,iBAAiB,CAAE,CAAC,IAAI,EAAE;YACvD,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,eAAe,CAAE,CAAC,IAAI,EAAE;YACnD,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAE,CAAC,IAAI,EAAE;YACrD,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,cAAc,CAAE,CAAC,IAAI,EAAE;SACjD,CAAA;IACF,CAAC;AACF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,cAAsB;IACzD,OAAO,cAAc,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAA;AAC9C,CAAC"}

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

@@ -0,0 +1,80 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Reads the named road links of an OS Open Roads GML tile.
+ *
+ *   The GML product is one file per 100 km National Grid square. A tile holds `road:RoadLink`,
+ *   `road:RoadNode` and `road:MotorwayJunction` features. Only the links hold a centreline and a
+ *   name. A named link has a `road:name1` and a `road:roadNameTOID` whose `xlink:href` is `#` plus
+ *   the roadNameTOID that OS Open Names uses as its `ID`. A link with only a road number carries a
+ *   `road:roadNumberTOID` instead, and an unnamed link carries neither.
+ *
+ *   The centreline is a `gml:LineString` in EPSG:27700, written as a `gml:posList` of easting and
+ *   northing pairs. The reader honors the line's `srsDimension` so a 3D tile would still read its
+ *   first two ordinates.
+ */
+import { type MarkupElement } from "@mailwoman/core/html/elements";
+import type { PathBuilderLike } from "path-ts";
+/**
+ * The feature element that carries a centreline.
+ */
+export declare const OPEN_ROADS_LINK_ELEMENT = "road:RoadLink";
+/**
+ * One named road link.
+ */
+export interface OpenRoadsLink {
+    /**
+     * The link's `gml:id`.
+     */
+    id: string;
+    /**
+     * `road:name1` as the tile spells it.
+     */
+    name1: string;
+    /**
+     * The roadNameTOID, without the `#` of the reference, such as `osgb4000000010927776`.
+     */
+    roadNameTOID: string;
+    /**
+     * The centreline as flat `[easting0, northing0, easting1, northing1, …]` in EPSG:27700 meters.
+     */
+    vertices: Float64Array;
+}
+/**
+ * Counts from a read.
+ */
+export interface OpenRoadsReadStats {
+    /**
+     * Road links read.
+     */
+    links: number;
+    /**
+     * Named links yielded.
+     */
+    named: number;
+    /**
+     * Links with no `road:name1` or no `road:roadNameTOID`.
+     */
+    unnamed: number;
+    /**
+     * Named links whose centreline held fewer than two vertices or a non-numeric ordinate.
+     */
+    malformedGeometry: number;
+}
+/**
+ * A stats object with every count at zero.
+ */
+export declare function createOpenRoadsReadStats(): OpenRoadsReadStats;
+/**
+ * The named link a `road:RoadLink` element describes, or a reason it describes none.
+ */
+export declare function readOpenRoadsLink(element: MarkupElement): OpenRoadsLink | "unnamed" | "malformed-geometry";
+/**
+ * Streams the named links of one Open Roads GML tile.
+ */
+export declare function readOpenRoadsLinks(gmlPath: PathBuilderLike, stats: OpenRoadsReadStats, options?: {
+    signal?: AbortSignal;
+}): AsyncGenerator<OpenRoadsLink>;
+//# sourceMappingURL=open-roads.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"open-roads.d.ts","sourceRoot":"","sources":["../../../lib/gb/os-open/open-roads.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAmD,KAAK,aAAa,EAAE,MAAM,+BAA+B,CAAA;AACnH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE9C;;GAEG;AACH,eAAO,MAAM,uBAAuB,kBAAkB,CAAA;AAEtD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAA;IACV;;OAEG;IACH,KAAK,EAAE,MAAM,CAAA;IACb;;OAEG;IACH,YAAY,EAAE,MAAM,CAAA;IACpB;;OAEG;IACH,QAAQ,EAAE,YAAY,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAA;IACb;;OAEG;IACH,KAAK,EAAE,MAAM,CAAA;IACb;;OAEG;IACH,OAAO,EAAE,MAAM,CAAA;IACf;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAA;CACzB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,kBAAkB,CAE7D;AAID;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,aAAa,GAAG,aAAa,GAAG,SAAS,GAAG,oBAAoB,CA2B1G;AAED;;GAEG;AACH,wBAAuB,kBAAkB,CACxC,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE,kBAAkB,EACzB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,WAAW,CAAA;CAAO,GACpC,cAAc,CAAC,aAAa,CAAC,CAyB/B"}

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

@@ -0,0 +1,79 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Reads the named road links of an OS Open Roads GML tile.
+ *
+ *   The GML product is one file per 100 km National Grid square. A tile holds `road:RoadLink`,
+ *   `road:RoadNode` and `road:MotorwayJunction` features. Only the links hold a centreline and a
+ *   name. A named link has a `road:name1` and a `road:roadNameTOID` whose `xlink:href` is `#` plus
+ *   the roadNameTOID that OS Open Names uses as its `ID`. A link with only a road number carries a
+ *   `road:roadNumberTOID` instead, and an unnamed link carries neither.
+ *
+ *   The centreline is a `gml:LineString` in EPSG:27700, written as a `gml:posList` of easting and
+ *   northing pairs. The reader honors the line's `srsDimension` so a 3D tile would still read its
+ *   first two ordinates.
+ */
+import { openReadStream } from "@mailwoman/core/fs/streams";
+import { elementAtPath, streamMarkupElements, textAtPath } from "@mailwoman/core/html/elements";
+/**
+ * The feature element that carries a centreline.
+ */
+export const OPEN_ROADS_LINK_ELEMENT = "road:RoadLink";
+/**
+ * A stats object with every count at zero.
+ */
+export function createOpenRoadsReadStats() {
+    return { links: 0, named: 0, unnamed: 0, malformedGeometry: 0 };
+}
+const LINE_PATH = ["net:centrelineGeometry", "gml:LineString"];
+/**
+ * The named link a `road:RoadLink` element describes, or a reason it describes none.
+ */
+export function readOpenRoadsLink(element) {
+    const name1 = (textAtPath(element, "road:name1") ?? "").trim();
+    const href = elementAtPath(element, "road:roadNameTOID")?.attributes["xlink:href"] ?? "";
+    const roadNameTOID = href.replace(/^#/u, "").trim();
+    if (!name1 || !roadNameTOID)
+        return "unnamed";
+    const dimension = Number(elementAtPath(element, ...LINE_PATH)?.attributes.srsDimension ?? "2") || 2;
+    const posList = (textAtPath(element, ...LINE_PATH, "gml:posList") ?? "").trim();
+    const ordinates = posList ? posList.split(/\s+/u) : [];
+    const vertexCount = Math.floor(ordinates.length / dimension);
+    if (vertexCount < 2 || ordinates.length % dimension !== 0)
+        return "malformed-geometry";
+    const vertices = new Float64Array(vertexCount * 2);
+    for (let vertex = 0; vertex < vertexCount; vertex++) {
+        const easting = Number(ordinates[vertex * dimension]);
+        const northing = Number(ordinates[vertex * dimension + 1]);
+        if (!Number.isFinite(easting) || !Number.isFinite(northing))
+            return "malformed-geometry";
+        vertices[vertex * 2] = easting;
+        vertices[vertex * 2 + 1] = northing;
+    }
+    return { id: element.attributes["gml:id"] ?? "", name1, roadNameTOID, vertices };
+}
+/**
+ * Streams the named links of one Open Roads GML tile.
+ */
+export async function* readOpenRoadsLinks(gmlPath, stats, options = {}) {
+    for await (const element of streamMarkupElements(openReadStream(gmlPath), OPEN_ROADS_LINK_ELEMENT, {
+        xml: true,
+        signal: options.signal,
+    })) {
+        stats.links++;
+        const link = readOpenRoadsLink(element);
+        if (link === "unnamed") {
+            stats.unnamed++;
+            continue;
+        }
+        if (link === "malformed-geometry") {
+            stats.malformedGeometry++;
+            continue;
+        }
+        stats.named++;
+        yield link;
+    }
+}
+//# sourceMappingURL=open-roads.js.map

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

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

package/out/gb/tools/fetch/os-open.d.ts

@@ -0,0 +1,91 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Downloads the three OS OpenData products the `gb-os-open` adapter joins, from the OS Downloads API.
+ *
+ *   The API serves OpenData without a key. `GET /products/<id>/downloads` lists one archive per
+ *   format and area with its OS-published MD5, and each archive is checked against that MD5 after
+ *   transfer. A present archive whose MD5 already matches is kept rather than downloaded again.
+ *
+ *   Each archive is unpacked into the subdirectory the adapter reads, `code-point-open/`,
+ *   `open-names/` or `open-roads/`, so the fetch root is the adapter's `inputPath`. The archive
+ *   stays beside its members, because its digest is the value the address-source register records.
+ */
+import { APIClient } from "@mailwoman/core/api";
+import { type OSDownload } from "@mailwoman/spatial/gb/os-downloads";
+import { type PathBuilderLike } from "path-ts";
+import type { BaseFetchOptions, FetchSummary, SourceManifest } from "#tools/fetch/download";
+/**
+ * The license all three products are published under.
+ */
+export declare const GB_OS_OPEN_LICENSE_NAME = "Open Government Licence v3.0";
+/**
+ * The attribution OGL v3 requires, in the wording OS asks for on Code-Point Open,
+ * which also carries Royal Mail and ONS data.
+ */
+export declare const GB_OS_OPEN_ATTRIBUTION = "Contains OS data \u00A9 Crown copyright and database right. Contains Royal Mail data \u00A9 Royal Mail copyright and database right. Contains National Statistics data \u00A9 Crown copyright and database right.";
+/**
+ * One product the adapter reads: its OS Downloads API id, the archive format,
+ * and the subdirectory it unpacks into.
+ */
+export interface OSOpenProduct {
+    productID: string;
+    format: string;
+    directory: string;
+}
+/**
+ * The three products, in the order they are fetched.
+ */
+export declare const GB_OS_OPEN_PRODUCTS: readonly OSOpenProduct[];
+/**
+ * The manifest entry for one product's archive.
+ */
+export interface OSOpenFileManifest extends SourceManifest {
+    product_id: string;
+    format: string;
+    md5: string;
+    members: number;
+}
+/**
+ * The archive of `product` among the listed downloads, the Great Britain one where an area is stated.
+ *
+ * @throws Naming the formats offered, when none matches.
+ */
+export declare function selectOSDownload(product: OSOpenProduct, downloads: readonly OSDownload[]): OSDownload;
+/**
+ * The archives the OS Downloads API lists for one product.
+ */
+export declare function readOSDownloads(client: Pick<APIClient, "fetch">, product: OSOpenProduct, options?: {
+    signal?: AbortSignal;
+}): Promise<OSDownload[]>;
+/**
+ * Downloads and unpacks one product.
+ */
+export declare function downloadOSOpenProduct(client: Pick<APIClient, "fetch">, product: OSOpenProduct, options: {
+    outputDir: PathBuilderLike;
+    force?: boolean;
+    retries?: number;
+    retryDelayMs?: number;
+    signal?: AbortSignal;
+    report?: (line: string) => void;
+}): Promise<{
+    entry: OSOpenFileManifest;
+    downloaded: boolean;
+}>;
+/**
+ * Per-invocation options for the registry entry.
+ */
+export interface FetchGBOSOpenOptions extends BaseFetchOptions {
+    force?: boolean;
+    retries?: number;
+    signal?: AbortSignal;
+}
+/**
+ * The registry entry: fetches all three products and writes `MANIFEST.json` at the adapter's input root.
+ *
+ * A product that fails is counted and the others are still taken.
+ */
+export declare function fetchGBOSOpen(options: FetchGBOSOpenOptions, report?: (line: string) => void): Promise<FetchSummary>;
+//# sourceMappingURL=os-open.d.ts.map

package/out/gb/tools/fetch/os-open.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"os-open.d.ts","sourceRoot":"","sources":["../../../../lib/gb/tools/fetch/os-open.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAK/C,OAAO,EAAyB,KAAK,UAAU,EAAE,MAAM,oCAAoC,CAAA;AAC3F,OAAO,EAAe,KAAK,eAAe,EAAE,MAAM,SAAS,CAAA;AAG3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAA4B,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAGrH;;GAEG;AACH,eAAO,MAAM,uBAAuB,iCAAiC,CAAA;AAErE;;;GAGG;AACH,eAAO,MAAM,sBAAsB,sNACkK,CAAA;AAErM;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,aAAa,EAIvD,CAAA;AAED;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,cAAc;IACzD,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,MAAM,CAAA;CACf;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,UAAU,EAAE,GAAG,UAAU,CAYrG;AAED;;GAEG;AACH,wBAAsB,eAAe,CACpC,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,EAChC,OAAO,EAAE,aAAa,EACtB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,WAAW,CAAA;CAAO,GACpC,OAAO,CAAC,UAAU,EAAE,CAAC,CAevB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAC1C,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,EAChC,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE;IACR,SAAS,EAAE,eAAe,CAAA;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAC/B,GACC,OAAO,CAAC;IAAE,KAAK,EAAE,kBAAkB,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,CAAC,CAsD7D;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC7D,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,WAAW,CAAA;CACpB;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAClC,OAAO,EAAE,oBAAoB,EAC7B,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC7B,OAAO,CAAC,YAAY,CAAC,CAmDvB"}

package/out/gb/tools/fetch/os-open.js

@@ -0,0 +1,166 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Downloads the three OS OpenData products the `gb-os-open` adapter joins, from the OS Downloads API.
+ *
+ *   The API serves OpenData without a key. `GET /products/<id>/downloads` lists one archive per
+ *   format and area with its OS-published MD5, and each archive is checked against that MD5 after
+ *   transfer. A present archive whose MD5 already matches is kept rather than downloaded again.
+ *
+ *   Each archive is unpacked into the subdirectory the adapter reads, `code-point-open/`,
+ *   `open-names/` or `open-roads/`, so the fetch root is the adapter's `inputPath`. The archive
+ *   stays beside its members, because its digest is the value the address-source register records.
+ */
+import { APIClient } from "@mailwoman/core/api";
+import { ByteFormatter } from "@mailwoman/core/fs/formatters";
+import { makeDirectories } from "@mailwoman/core/fs/writers";
+import { extractZipEntries } from "@mailwoman/core/fs/zip";
+import { md5File, sha256File } from "@mailwoman/core/hash";
+import { OS_DOWNLOADS_API_BASE } from "@mailwoman/spatial/gb/os-downloads";
+import { PathBuilder } from "path-ts";
+import { GB_OS_OPEN_ADAPTER_ID, GB_OS_OPEN_PRODUCT_DIRECTORIES } from "#gb/adapters/os-open/adapter";
+import { downloadToFile, writeManifest } from "#tools/fetch/download";
+/**
+ * The license all three products are published under.
+ */
+export const GB_OS_OPEN_LICENSE_NAME = "Open Government Licence v3.0";
+/**
+ * The attribution OGL v3 requires, in the wording OS asks for on Code-Point Open,
+ * which also carries Royal Mail and ONS data.
+ */
+export const GB_OS_OPEN_ATTRIBUTION = "Contains OS data © Crown copyright and database right. Contains Royal Mail data © Royal Mail copyright and database right. Contains National Statistics data © Crown copyright and database right.";
+/**
+ * The three products, in the order they are fetched.
+ */
+export const GB_OS_OPEN_PRODUCTS = [
+    { productID: "CodePointOpen", format: "CSV", directory: GB_OS_OPEN_PRODUCT_DIRECTORIES.codePointOpen },
+    { productID: "OpenNames", format: "CSV", directory: GB_OS_OPEN_PRODUCT_DIRECTORIES.openNames },
+    { productID: "OpenRoads", format: "GML", directory: GB_OS_OPEN_PRODUCT_DIRECTORIES.openRoads },
+];
+/**
+ * The archive of `product` among the listed downloads, the Great Britain one where an area is stated.
+ *
+ * @throws Naming the formats offered, when none matches.
+ */
+export function selectOSDownload(product, downloads) {
+    const matches = downloads.filter((download) => download.format === product.format);
+    const chosen = matches.find((download) => download.area === "GB") ?? (matches.length === 1 ? matches[0] : undefined);
+    if (!chosen) {
+        throw new Error(`${GB_OS_OPEN_ADAPTER_ID}: OS Downloads API lists no single ${product.format} archive for ${product.productID} ` +
+            `(listed: ${downloads.map((download) => `${download.format}/${download.area}`).join(", ") || "nothing"})`);
+    }
+    return chosen;
+}
+/**
+ * The archives the OS Downloads API lists for one product.
+ */
+export async function readOSDownloads(client, product, options = {}) {
+    const { data } = await client.fetch({
+        method: "GET",
+        url: `${OS_DOWNLOADS_API_BASE}/products/${product.productID}/downloads`,
+        timeout: 60_000,
+        signal: options.signal,
+    });
+    if (!Array.isArray(data)) {
+        throw new TypeError(`${GB_OS_OPEN_ADAPTER_ID}: OS Downloads API answered ${product.productID} with no download list`);
+    }
+    return data;
+}
+/**
+ * Downloads and unpacks one product.
+ */
+export async function downloadOSOpenProduct(client, product, options) {
+    const { report } = options;
+    const download = selectOSDownload(product, await readOSDownloads(client, product, { signal: options.signal }));
+    const productDir = PathBuilder.from(options.outputDir)(product.directory);
+    const archivePath = productDir(download.fileName);
+    report?.(`=== ${GB_OS_OPEN_ADAPTER_ID} / ${product.productID} ${download.fileName} (${ByteFormatter.formatIEC(download.size)})`);
+    await makeDirectories(productDir);
+    const present = options.force ? null : await md5File(archivePath).catch(() => null);
+    const downloaded = present !== download.md5;
+    if (downloaded) {
+        await downloadToFile({
+            url: download.url,
+            dest: archivePath,
+            retries: options.retries,
+            retryDelayMs: options.retryDelayMs,
+            report,
+        });
+        const md5 = await md5File(archivePath);
+        if (md5 !== download.md5) {
+            throw new Error(`${GB_OS_OPEN_ADAPTER_ID}: ${download.fileName} has md5 ${md5}, and OS publishes ${download.md5} for it`);
+        }
+    }
+    else {
+        report?.(`  present, and its md5 matches the published ${download.md5}`);
+    }
+    const members = await extractZipEntries(archivePath, productDir, { skipExisting: true });
+    const sha256 = await sha256File(archivePath);
+    report?.(`  ${members.length} members unpacked  sha256=${sha256}`);
+    return {
+        entry: {
+            source_url: download.url,
+            filename: download.fileName,
+            product_id: product.productID,
+            format: product.format,
+            bytes: download.size,
+            md5: download.md5,
+            sha256,
+            members: members.length,
+            downloaded_at: new Date().toISOString(),
+        },
+        downloaded,
+    };
+}
+/**
+ * The registry entry: fetches all three products and writes `MANIFEST.json` at the adapter's input root.
+ *
+ * A product that fails is counted and the others are still taken.
+ */
+export async function fetchGBOSOpen(options, report) {
+    const outputDir = options.outRoot(GB_OS_OPEN_ADAPTER_ID);
+    const files = [];
+    const failedCodes = [];
+    let fetched = 0;
+    let skipped = 0;
+    await using client = new APIClient({ displayName: GB_OS_OPEN_ADAPTER_ID, minRequestIntervalMs: 250, retry: true });
+    for (const product of GB_OS_OPEN_PRODUCTS) {
+        if (options.signal?.aborted)
+            break;
+        try {
+            const { entry, downloaded } = await downloadOSOpenProduct(client, product, {
+                outputDir,
+                force: options.force,
+                retries: options.retries,
+                retryDelayMs: options.retryDelayMs,
+                signal: options.signal,
+                report,
+            });
+            files.push(entry);
+            if (downloaded) {
+                fetched += 1;
+            }
+            else {
+                skipped += 1;
+            }
+        }
+        catch (error) {
+            report?.(`  ✗ ${product.productID}: ${error instanceof Error ? error.message : String(error)}`);
+            failedCodes.push(product.productID);
+        }
+    }
+    const manifest = {
+        source: GB_OS_OPEN_ADAPTER_ID,
+        source_url: OS_DOWNLOADS_API_BASE,
+        license: GB_OS_OPEN_LICENSE_NAME,
+        attribution: GB_OS_OPEN_ATTRIBUTION,
+        downloaded_at: new Date().toISOString(),
+        files,
+    };
+    await writeManifest(outputDir("MANIFEST.json"), manifest);
+    report?.(`  MANIFEST written to ${outputDir("MANIFEST.json")}`);
+    return { fetched, skipped, failed: failedCodes.length, failedCodes };
+}
+//# sourceMappingURL=os-open.js.map

package/out/gb/tools/fetch/os-open.js.map

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