@mailwoman/corpus 10.1.0 → 10.2.1

package/out/es/adapters/bizkaia/adapter.js

@@ -8,17 +8,17 @@
  *
  * The ATOM service at `https://apli.bizkaia.eus/apps/Danok/INSPIRE/addresses.xml` lists 112
  * municipality entries, one zipped GML each. Catastro's national feed links this service rather than
- * serving its data, which is why the publisher is a register of its own.
+ * serving its data. The publisher is therefore a register of its own.
  *
- * The archives carry addresses alone, and that is what shapes this reader. Abadiño's
+ * The archives hold only addresses. That shapes this reader. Abadiño's
  * `ES.BFA.AD.001.zip` holds one member, `ES.BFA.AD.gml`, whose 1,360 `ad:Address` features write
  * 4,080 `ad:component` references and not one `ad:ThoroughfareName`, `ad:PostalDescriptor` or
  * `ad:AdminUnitName` feature. Every reference is a stored-query URL on
  * `https://geo.bizkaia.eus/arcgisserverinspire/…` addressing an `adComponent.<n>` the ATOM feed never
- * publishes. A reader of the archive alone therefore writes every address in the province without
+ * publishes. A reader given only those archives therefore writes every address in the province without
  * its street, its postcode or its municipality.
  *
- * Those features are on the publisher's WFS, which serves the whole province in three requests. The
+ * Those features are on the publisher's WFS. It serves the whole province in one request per type. The
  * service answers `ad:ThoroughfareName` with `numberMatched="6921"`, `ad:PostalDescriptor` with
  * `96` and `ad:AdminUnitName` with `113`, and a `GetFeature` with `COUNT=10000` returns each type
  * whole: 6,921 thoroughfare names arrive in one 13,916,056-byte document. One request per type is
@@ -32,14 +32,14 @@
  * addresses. An unresolved reference is a value the reader asked for and could not read, and it
  * raises.
  *
- * Two of the publisher's own spellings decide what a row carries.
+ * Two of the publisher's own spellings decide what a row records.
  *
  * A thoroughfare name is a cadastral field rather than a street name:
  * `BO\TRAÑA-MATIENA(1)` is the street-type abbreviation `BO`, a backslash, the name, and the
  * street's own sequence code in parentheses. All 6,921 take that form. The row keeps the
  * abbreviation, as the Dirección General del Catastro's own rendered line does with `CL SANTIAGO
- * APOSTOL`, writes a space where the cadastre writes its separator, and drops the sequence code,
- * which is an identifier rather than part of the name.
+ * APOSTOL`, writes a space where the cadastre writes its separator, and drops the sequence code
+ * because it is an identifier rather than part of the name.
  *
  * The house number is the last of the four dot-separated fields of the designator, and the
  * designator is a cadastral code: `48.001.00026.003` is municipality 48001, street 00026 and number
@@ -57,10 +57,9 @@
  * The first three are an ordinary Spanish number, a number with a letter, and a number with a
  * *bis*, *izquierda* or *derecha* qualifier. The fourth is two fields concatenated and what its
  * second field designates is not established: it is three digits wide like the number itself, and
- * no document the publisher publishes says what it counts. Those 181 of 1,360 rows therefore carry the
- * publisher's own concatenation with its padding removed, which transcribes the designator without
- * interpreting it. Splitting the field on a guessed separator would state a number the cadastre does
- * not hold.
+ * no document the publisher publishes states what it counts. The row therefore writes the
+ * publisher's own concatenation with its padding removed. A split on a guessed separator would
+ * state a number the cadastre does not hold.
  *
  * The municipality is `ad:AdminUnitName` at `3rdOrder`, which is the only level the service
  * publishes: 113 of 113 of its administrative-unit features state it, and their names are padded
@@ -71,14 +70,14 @@
  * `48 001 CL\TRAÑAETXOSTE(00066) 002` for the address whose designator is `48.001.00066.002`. It
  * restates the municipality code, the street type and name, the street code zero-padded to five, and
  * the number field, and it is written inside the archive while the street itself comes from a
- * separate WFS document. Putting the resolved street and the composed number beside it therefore
- * checks that the right feature was joined, which is what the adapter's test does. The register's
+ * separate WFS document. The adapter's test compares the resolved street and the composed number
+ * against it to check that the right feature was joined. The register's
  * personal-data review reads these values as internal cadastral references rather than names, and
  * the adapter writes none of them into a row.
  *
  * No service either publisher runs was found to render a postal address for this province: the
- * ArcGIS layer behind the WFS exposes INSPIRE fields alone. So the number's unexplained second field
- * stays an open question rather than one this adapter resolved.
+ * ArcGIS layer behind the WFS exposes only INSPIRE fields. The number's unexplained second field
+ * therefore stays open.
  */
 import { openReadStream } from "@mailwoman/core/fs/streams";
 import { streamMarkupElements } from "@mailwoman/core/html/elements";
@@ -104,24 +103,24 @@ export const ES_BIZKAIA_COUNTRIES = ["ES"];
 /**
  * The license the address-source register elected for this publisher.
  *
- * Bizkaia names no license instrument, so no SPDX identifier is written and this records the
- * publisher's own words. Its INSPIRE metadata carries the controlled values `No limitations to
+ * Bizkaia states no license instrument, so no SPDX identifier is written and this records the
+ * publisher's own words. Its INSPIRE metadata states the controlled values `No limitations to
  * public access` and `No conditions to access and use`, and its feed-level `rights` adds the
  * condition that authorship and ownership of the BFA be stated as «©Bizkaiko Foru Aldundia». The
  * register records two contradictions it did not resolve: all 112 municipality entries also read
  * `Copyright (c) 2017", ES.BFA; all rights reserved`, and Catastro's national feed labels this
- * publisher `CC BY 3.0 ES`, which no document Bizkaia publishes names.
+ * publisher `CC BY 3.0 ES`. No document Bizkaia publishes states that label.
  */
 export const ES_BIZKAIA_LICENSE = "No conditions to access and use, with attribution to «©Bizkaiko Foru Aldundia»";
 /**
  * The member of a municipality's archive that holds the GML.
  *
- * Each archive ships one member, named `ES.BFA.AD.gml` whichever municipality it holds,
- * so the extension selects it and the archive's own name carries the municipality.
+ * Each archive ships one member, `ES.BFA.AD.gml` whichever municipality it holds,
+ * so the extension selects it and the archive's own name identifies the municipality.
  */
 const GML_MEMBER = /\.gml$/iu;
 /**
- * The feature types the saved WFS documents carry, indexed before any address is read.
+ * The feature types in the saved WFS documents, indexed before any address is read.
  */
 const COMPONENT_ELEMENTS = [
     "ad:ThoroughfareName",
@@ -144,7 +143,7 @@ const MUNICIPALITY_LEVEL = "3rdOrder";
  */
 const HOUSE_NUMBER_TYPE = "buildingIdentifier";
 /**
- * How many dot-separated fields a designator carries.
+ * How many dot-separated fields a designator has.
  *
  * Municipality, street, number: `48.001.00026.003` splits the municipality code across two.
  */
@@ -154,32 +153,33 @@ const DESIGNATOR_FIELDS = 4;
  *
  * `BO\TRAÑA-MATIENA(1)` answers `BO TRAÑA-MATIENA`.
  * The backslash is the cadastre's separator between the street-type abbreviation
- * and the name, and the trailing parenthesis holds the street's sequence code,
- * which the address's own designator repeats as its third field.
+ * and the name, and the trailing parenthesis holds the street's sequence code.
  *
- * @returns The street, or undefined where the feature states no name.
+ * The address's own designator repeats that code as its third field.
+ *
+ * @returns The street, or null where the feature states no name.
  */
 export function bizkaiaStreet(feature) {
     const text = thoroughfareName(feature);
     if (!text)
-        return undefined;
+        return null;
     const street = text
         .replace(/\((\d+)\)\s*$/u, "")
         .replaceAll("\\", " ")
         .replaceAll(/\s+/gu, " ")
         .trim();
-    return street || undefined;
+    return street || null;
 }
 /**
  * The street's sequence code a thoroughfare feature states, as the feature writes it.
  *
- * The code the address's designator joins on, which is what makes the publisher's own
- * `ad:LocatorName` a check of the join rather than a copy of it.
+ * The code the address's designator joins on.
+ * The publisher's own `ad:LocatorName` therefore checks the join rather than copying it.
  *
- * @returns The digits inside the trailing parentheses, or undefined where there are none.
+ * @returns The digits inside the trailing parentheses, or null where there are none.
  */
 export function bizkaiaStreetCode(feature) {
-    return /\((\d+)\)\s*$/u.exec(thoroughfareName(feature) ?? "")?.[1];
+    return /\((\d+)\)\s*$/u.exec(thoroughfareName(feature) ?? "")?.[1] ?? null;
 }
 /**
  * The house number the designator's fourth field states.
@@ -189,17 +189,17 @@ export function bizkaiaStreetCode(feature) {
  *
  * This module's header tabulates the four shapes it takes, with their counts.
  *
- * @returns The number, or undefined where the designator is absent or does not carry four fields.
+ * @returns The number, or null where the designator is absent or does not have four fields.
  */
 export function bizkaiaHouseNumber(byType) {
     const code = designator(byType, HOUSE_NUMBER_TYPE);
     if (!code)
-        return undefined;
+        return null;
     const fields = code.split(".");
     if (fields.length !== DESIGNATOR_FIELDS)
-        return undefined;
+        return null;
     const number = fields[DESIGNATOR_FIELDS - 1].replace(/^0+(?=.)/u, "");
-    return number || undefined;
+    return number || null;
 }
 export function createESBizkaiaAdapter() {
     return {
@@ -252,17 +252,17 @@ export function createESBizkaiaAdapter() {
     };
 }
 /**
- * One address's row, or undefined when it carries too little to render.
+ * One address's row, or null when it has too little to render.
  */
 function composeRow(address, referenced) {
-    const addressID = address.attributes["gml:id"]?.trim();
+    const addressID = address.attributes["gml:id"]?.trim() ?? null;
     if (voidDesignatorTypes(address).has(HOUSE_NUMBER_TYPE)) {
         throw new VoidDesignatorError(ES_BIZKAIA_ADAPTER_ID, addressID, HOUSE_NUMBER_TYPE);
     }
-    let street;
-    let postcode;
-    let locality;
-    let settlement;
+    let street = null;
+    let postcode = null;
+    let locality = null;
+    let settlement = null;
     for (const href of componentHrefs(address)) {
         const key = componentJoinKey(href);
         const feature = key ? referenced.get(key) : undefined;
@@ -308,8 +308,8 @@ function memberChunks(path) {
  * The two passes read the same list, so an input holding addresses and an input holding
  * component features need not be told apart: a municipality archive contributes addresses
  * to the second pass and no feature to the first, and a saved WFS page the reverse.
- * Deciding by extension would be wrong on a hand-assembled input that holds both,
- * and the publisher's own naming distinguishes neither.
+ * Extension cannot decide: a hand-assembled input can hold both, and the
+ * publisher's own naming distinguishes neither.
  *
  * A path holding no input raises rather than yielding zero rows, so a wrong path
  * reports itself instead of reading as an empty publisher.

package/out/es/adapters/bizkaia/adapter.js.map

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

package/out/es/adapters/catastro/adapter.d.ts

@@ -7,32 +7,32 @@
  * from its per-municipality zipped GML.
  *
  * The ATOM service at `https://www.catastro.hacienda.gob.es/INSPIRE/Addresses/ES.SDGC.AD.atom.xml`
- * lists 55 entries, and 52 of them are the Dirección General del Catastro's own provinces. The other
- * three link the foral cadastres of Bizkaia, Gipuzkoa and Navarra, which state their own terms and
- * have an adapter each. Every DGC entry links a province feed listing one zipped GML per
- * municipality, so a caller harvests municipality by municipality and this adapter reads one archive
- * or a directory of them.
+ * lists 55 entries. 52 are the Dirección General del Catastro's own provinces. Three link the foral
+ * cadastres of Bizkaia, Gipuzkoa and Navarra. Those three state their own terms and have an adapter
+ * each. Every DGC entry links a province feed listing one zipped GML per municipality, so a caller
+ * harvests municipality by municipality and this adapter reads one archive or a directory of them.
  *
  * Three properties of the file decide the reader, and each of the three would silently empty a row
  * if it were read the way the other INSPIRE publishers are read.
  *
- * The archive carries two members. `A.ES.SDGC.AD.<code>.gml` is the data and
+ * The archive holds two members. `A.ES.SDGC.AD.<code>.gml` is the data and
  * `A.ES.SDGC.AD.MD.<code>.xml` is its ISO 19139 metadata record. A member selector matching `.xml`
- * therefore selects the metadata record. That record carries no `AD:Address` at all, so
+ * therefore selects the metadata record. That record holds no `AD:Address` at all, so
  * {@linkcode GML_MEMBER} matches the extension that holds the features.
  *
- * The GML declares `<?xml version="1.0" encoding="ISO-8859-1"?>` and is not valid UTF-8: Ceuta's
- * 11,861,975-byte member carries 26 bytes above 0x7F, one of which is the `Ñ` of a street name.
- * `streamMarkupElements` decodes with a UTF-8 `TextDecoder`, which answers those bytes with U+FFFD,
- * so the bytes pass through `decodeByteStream` first. {@linkcode assertLatin1Declaration} reads the
- * declaration rather than trusting this note, because a publisher that re-encodes its output would
- * otherwise have every accented name mojibaked under a reader that still claimed to be right.
+ * The GML declares `<?xml version="1.0" encoding="ISO-8859-1"?>` and is not valid UTF-8. Ceuta's
+ * 11,861,975-byte member holds 26 bytes above 0x7F, one of which is the `Ñ` of a street name.
+ * `streamMarkupElements` decodes with a UTF-8 `TextDecoder`. That decoder answers those bytes with
+ * U+FFFD. The bytes therefore pass through `decodeByteStream` first. {@linkcode assertLatin1Declaration}
+ * reads the declaration rather than trusting this note, because a publisher that re-encodes its
+ * output would otherwise have every accented name mojibaked under a reader that still claimed to be
+ * right.
  *
  * The file binds the INSPIRE namespaces to upper-case prefixes, `AD:Address` and `GN:text`, and
  * states a designator type and an administrative level as element text rather than as a codelist
  * URI. `#inspire/address` matches an element by its local name and accepts either form of a coded
  * value, so the readers there serve this publisher. Only the element names this module passes to the
- * markup stream carry the upper-case prefix.
+ * markup stream hold the upper-case prefix.
  *
  * Each address references exactly three features by local `#` fragment, measured as 8,126 of 8,126
  * addresses in Ceuta carrying one `ES.SDGC.PD`, one `ES.SDGC.TN` and one `ES.SDGC.AU` reference.
@@ -52,10 +52,10 @@
  * | `9744803TE8794S` | `13` | `CL SANTIAGO APOSTOL 13 51002 CEUTA (CEUTA)` |
  * | `9745701TE8794S` | `13D` | `CL SANTIAGO APOSTOL 13(D) 51002 CEUTA (CEUTA)` |
  *
- * So the designator is `pnp` with `plp` appended, and the street is `tv` followed by `nv`, which is
- * the `AD:ThoroughfareName` text verbatim once its leading space is trimmed. The abbreviation stays
- * in the street component because the publisher writes it in its own rendered line. Expanding `CL`
- * to `Calle` would state something the Cadastre did not.
+ * So the designator is `pnp` with `plp` appended, and the street is `tv` followed by `nv`. That
+ * street matches the `AD:ThoroughfareName` text verbatim once its leading space is trimmed. The
+ * abbreviation stays in the street component because the publisher writes it in its own rendered
+ * line. `Calle` would state something the Cadastre did not.
  *
  * `S-N` is *sin número*, the publisher stating that the address has no number, and it is 856 of
  * Ceuta's 8,126 designators. A row carrying it writes no `house_number`, because the string is a
@@ -87,13 +87,12 @@ export declare const ES_CATASTRO_COUNTRIES: readonly string[];
  *
  * The register elects the titled instrument, `Licencia de acceso y uso de los servicios y conjuntos
  * de datos INSPIRE de la Dirección General del Catastro` at version 1.0, rather than the older
- * `all rights reserved` template the feed still carries. It names no license instrument a
- * Creative Commons label or an SPDX identifier would cover, so the row records the instrument's
- * own title.
+ * `all rights reserved` template the feed still shows. No Creative Commons label or SPDX identifier
+ * covers that instrument, so the row records the instrument's own title.
  *
- * That decision reads `refused` for `redistribute-data`: clause 1 withholds distribution
+ * The register reads `refused` for `redistribute-data`: clause 1 withholds distribution
  * of the information as supplied, and requires transformation before any public use.
- * Ingest, transformation and training are permitted, which is what this adapter performs.
+ * Ingest, transformation and training are permitted, and this adapter performs those.
  */
 export declare const ES_CATASTRO_LICENSE = "Licencia de acceso y uso de los servicios y conjuntos de datos INSPIRE de la Direcci\u00F3n General del Catastro";
 export declare function createESCatastroAdapter(): CorpusAdapter;

package/out/es/adapters/catastro/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../lib/es/adapters/catastro/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqEG;AAyBH,OAAO,EAAuD,KAAK,aAAa,EAAiB,MAAM,QAAQ,CAAA;AAE/G;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,gBAAgB,CAAA;AAEnD;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EAAW,CAAA;AAE9D;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,mBAAmB,qHAC8E,CAAA;AAgG9G,wBAAgB,uBAAuB,IAAI,aAAa,CAyCvD;AA6ED;;GAEG;AACH,eAAO,MAAM,iBAAiB,eAA4B,CAAA"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../lib/es/adapters/catastro/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqEG;AAyBH,OAAO,EAAuD,KAAK,aAAa,EAAiB,MAAM,QAAQ,CAAA;AAE/G;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,gBAAgB,CAAA;AAEnD;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EAAW,CAAA;AAE9D;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,mBAAmB,qHAC8E,CAAA;AAmG9G,wBAAgB,uBAAuB,IAAI,aAAa,CAyCvD;AA6ED;;GAEG;AACH,eAAO,MAAM,iBAAiB,eAA4B,CAAA"}

package/out/es/adapters/catastro/adapter.js

@@ -7,32 +7,32 @@
  * from its per-municipality zipped GML.
  *
  * The ATOM service at `https://www.catastro.hacienda.gob.es/INSPIRE/Addresses/ES.SDGC.AD.atom.xml`
- * lists 55 entries, and 52 of them are the Dirección General del Catastro's own provinces. The other
- * three link the foral cadastres of Bizkaia, Gipuzkoa and Navarra, which state their own terms and
- * have an adapter each. Every DGC entry links a province feed listing one zipped GML per
- * municipality, so a caller harvests municipality by municipality and this adapter reads one archive
- * or a directory of them.
+ * lists 55 entries. 52 are the Dirección General del Catastro's own provinces. Three link the foral
+ * cadastres of Bizkaia, Gipuzkoa and Navarra. Those three state their own terms and have an adapter
+ * each. Every DGC entry links a province feed listing one zipped GML per municipality, so a caller
+ * harvests municipality by municipality and this adapter reads one archive or a directory of them.
  *
  * Three properties of the file decide the reader, and each of the three would silently empty a row
  * if it were read the way the other INSPIRE publishers are read.
  *
- * The archive carries two members. `A.ES.SDGC.AD.<code>.gml` is the data and
+ * The archive holds two members. `A.ES.SDGC.AD.<code>.gml` is the data and
  * `A.ES.SDGC.AD.MD.<code>.xml` is its ISO 19139 metadata record. A member selector matching `.xml`
- * therefore selects the metadata record. That record carries no `AD:Address` at all, so
+ * therefore selects the metadata record. That record holds no `AD:Address` at all, so
  * {@linkcode GML_MEMBER} matches the extension that holds the features.
  *
- * The GML declares `<?xml version="1.0" encoding="ISO-8859-1"?>` and is not valid UTF-8: Ceuta's
- * 11,861,975-byte member carries 26 bytes above 0x7F, one of which is the `Ñ` of a street name.
- * `streamMarkupElements` decodes with a UTF-8 `TextDecoder`, which answers those bytes with U+FFFD,
- * so the bytes pass through `decodeByteStream` first. {@linkcode assertLatin1Declaration} reads the
- * declaration rather than trusting this note, because a publisher that re-encodes its output would
- * otherwise have every accented name mojibaked under a reader that still claimed to be right.
+ * The GML declares `<?xml version="1.0" encoding="ISO-8859-1"?>` and is not valid UTF-8. Ceuta's
+ * 11,861,975-byte member holds 26 bytes above 0x7F, one of which is the `Ñ` of a street name.
+ * `streamMarkupElements` decodes with a UTF-8 `TextDecoder`. That decoder answers those bytes with
+ * U+FFFD. The bytes therefore pass through `decodeByteStream` first. {@linkcode assertLatin1Declaration}
+ * reads the declaration rather than trusting this note, because a publisher that re-encodes its
+ * output would otherwise have every accented name mojibaked under a reader that still claimed to be
+ * right.
  *
  * The file binds the INSPIRE namespaces to upper-case prefixes, `AD:Address` and `GN:text`, and
  * states a designator type and an administrative level as element text rather than as a codelist
  * URI. `#inspire/address` matches an element by its local name and accepts either form of a coded
  * value, so the readers there serve this publisher. Only the element names this module passes to the
- * markup stream carry the upper-case prefix.
+ * markup stream hold the upper-case prefix.
  *
  * Each address references exactly three features by local `#` fragment, measured as 8,126 of 8,126
  * addresses in Ceuta carrying one `ES.SDGC.PD`, one `ES.SDGC.TN` and one `ES.SDGC.AU` reference.
@@ -52,10 +52,10 @@
  * | `9744803TE8794S` | `13` | `CL SANTIAGO APOSTOL 13 51002 CEUTA (CEUTA)` |
  * | `9745701TE8794S` | `13D` | `CL SANTIAGO APOSTOL 13(D) 51002 CEUTA (CEUTA)` |
  *
- * So the designator is `pnp` with `plp` appended, and the street is `tv` followed by `nv`, which is
- * the `AD:ThoroughfareName` text verbatim once its leading space is trimmed. The abbreviation stays
- * in the street component because the publisher writes it in its own rendered line. Expanding `CL`
- * to `Calle` would state something the Cadastre did not.
+ * So the designator is `pnp` with `plp` appended, and the street is `tv` followed by `nv`. That
+ * street matches the `AD:ThoroughfareName` text verbatim once its leading space is trimmed. The
+ * abbreviation stays in the street component because the publisher writes it in its own rendered
+ * line. `Calle` would state something the Cadastre did not.
  *
  * `S-N` is *sin número*, the publisher stating that the address has no number, and it is 856 of
  * Ceuta's 8,126 designators. A row carrying it writes no `house_number`, because the string is a
@@ -98,13 +98,12 @@ export const ES_CATASTRO_COUNTRIES = ["ES"];
  *
  * The register elects the titled instrument, `Licencia de acceso y uso de los servicios y conjuntos
  * de datos INSPIRE de la Dirección General del Catastro` at version 1.0, rather than the older
- * `all rights reserved` template the feed still carries. It names no license instrument a
- * Creative Commons label or an SPDX identifier would cover, so the row records the instrument's
- * own title.
+ * `all rights reserved` template the feed still shows. No Creative Commons label or SPDX identifier
+ * covers that instrument, so the row records the instrument's own title.
  *
- * That decision reads `refused` for `redistribute-data`: clause 1 withholds distribution
+ * The register reads `refused` for `redistribute-data`: clause 1 withholds distribution
  * of the information as supplied, and requires transformation before any public use.
- * Ingest, transformation and training are permitted, which is what this adapter performs.
+ * Ingest, transformation and training are permitted, and this adapter performs those.
  */
 export const ES_CATASTRO_LICENSE = "Licencia de acceso y uso de los servicios y conjuntos de datos INSPIRE de la Dirección General del Catastro";
 /**
@@ -112,7 +111,8 @@ export const ES_CATASTRO_LICENSE = "Licencia de acceso y uso de los servicios y
  *
  * The archive ships two members and the other is `A.ES.SDGC.AD.MD.<code>.xml`,
  * the ISO 19139 metadata record.
- * A selector matching `.xml` reads that record, which carries no `AD:Address`.
+ * A selector matching `.xml` reads that record.
+ * That record holds no `AD:Address`.
  */
 const GML_MEMBER = /\.gml$/iu;
 /**
@@ -146,10 +146,12 @@ const MUNICIPALITY_LEVELS = new Set(["4", "4thOrder"]);
 /**
  * The designator type the publisher writes on every address.
  *
- * Measured over Ceuta: 8,126 of 8,126 addresses carry exactly one designator
+ * Measured over Ceuta: 8,126 of 8,126 addresses hold exactly one designator,
  * and its `AD:type` is the text `1`.
- * The value is the house number, which `Consulta_DNPRC`'s `pnp` and `plp` fields
- * confirm for the two addresses tabulated in this module's header.
+ * The value is the house number.
+ *
+ * `Consulta_DNPRC`'s `pnp` and `plp` fields confirm that for the two addresses
+ * tabulated in this module's header.
  */
 const HOUSE_NUMBER_TYPE = "1";
 /**
@@ -219,20 +221,20 @@ export function createESCatastroAdapter() {
     };
 }
 /**
- * One address's row, or undefined when it carries too little to render.
+ * One address's row, or null when it holds too little to render.
  *
  * The reference index is complete before this is called, so a reference resolving to no
  * feature is a value the reader asked for and could not read, and it raises.
  */
 function composeRow(address, referenced) {
-    const addressID = address.attributes["gml:id"]?.trim();
+    const addressID = address.attributes["gml:id"]?.trim() ?? null;
     if (voidDesignatorTypes(address).has(HOUSE_NUMBER_TYPE)) {
         throw new VoidDesignatorError(ES_CATASTRO_ADAPTER_ID, addressID, HOUSE_NUMBER_TYPE);
     }
-    let street;
-    let postcode;
-    let locality;
-    let settlement;
+    let street = null;
+    let postcode = null;
+    let locality = null;
+    let settlement = null;
     for (const href of componentHrefs(address)) {
         const key = componentJoinKey(href);
         if (key && referenceStatesNoValue(key))

package/out/es/adapters/catastro/adapter.js.map

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

package/out/es/adapters/gipuzkoa/adapter.d.ts

@@ -4,21 +4,18 @@
  * @author Teffen Ellis, et al.
  *
  * `es-gipuzkoa`: the INSPIRE Addresses theme the Diputación Foral de Gipuzkoa publishes, read from
- * the one zipped GML that carries the whole province.
+ * the one zipped GML that holds the whole province.
  *
- * The ATOM service at `https://b5m.gipuzkoa.eus/inspire/download/addresses.xml` is 4,469 bytes and
- * holds a single entry for the province rather than one per municipality. That entry links its
- * dataset through `rel="alternate"` and not `rel="enclosure"`, so a fetcher that looks only for an
- * enclosure finds no dataset here. The adapter is handed the archive and the feed is acquisition's
- * concern. The archive `ES.GFA.AD.zip` is 7,959,103 bytes and its one member `ES.GFA.AD.gml` is
- * 313,162,472 bytes, a ratio of 39, so the member is read as a chunk sequence and never buffered.
+ * The ATOM service at `https://b5m.gipuzkoa.eus/inspire/download/addresses.xml` holds a single entry
+ * for the province and links its dataset through `rel="alternate"` rather than `rel="enclosure"`, so
+ * a fetcher that looks only for an enclosure finds no dataset here. The adapter is handed the
+ * archive and the feed is acquisition's concern. The archive holds one 313 MB GML member. The
+ * adapter reads that member as a chunk sequence and never buffers it.
  *
- * The member is self-contained and its order decides the reader. Counted over all 313,162,472 bytes:
- * 68,744 `ad:Address`, 4,250 `ad:ThoroughfareName`, 178 `ad:PostalDescriptor` and 88
- * `ad:AdminUnitName`, which is every one of the 73,260 `gml:featureMember` elements. The 4,516
- * reference features are written last, beginning at byte 306,440,816. Holding an address until the
- * document ends would therefore hold all 68,744, so the adapter reads the member twice through
- * {@linkcode streamIndexedInspireRows} and indexes 4,516 features instead.
+ * The member is self-contained and its order decides the reader. Addresses number 68,744, and the
+ * 4,516 reference features they point at are written last. An address held until the document ends
+ * would keep all 68,744 pending, so the adapter reads the member twice through
+ * {@linkcode streamIndexedInspireRows} and indexes the 4,516 references instead.
  *
  * A reference is a WFS stored-query URL whose `ID` parameter equals the target's `gml:id`, written
  * against the internal host `http://b5mdev/` and with the id repeated as the URL's fragment:
@@ -28,31 +25,26 @@
  *
  * A postal-descriptor reference whose final segment is empty, `…&ID=ES.GFA.PD.059. #…`, states that
  * the publisher holds no postcode, and `referenceStatesNoValue` separates it from a broken join.
- * The Cadastre writes the same form, which is why the predicate has one home.
+ * The Cadastre writes the same form. The predicate therefore has one home.
  *
- * The locator vocabulary is one type. 68,743 of 68,744 addresses write exactly one designator, typed
- * `LocatorDesignatorTypeValue/addressIdentifierGeneral`; one address writes none. The municipality is
- * the only `ad:AdminUnitName` level published, `4thOrder`, and the province publishes 88 of them for
- * its 88 municipalities.
+ * The locator vocabulary is one type,
+ * `LocatorDesignatorTypeValue/addressIdentifierGeneral`. The municipality is the only
+ * `ad:AdminUnitName` level published, `4thOrder`.
  *
  * The publisher writes its street names in Basque, with the street type as a trailing word rather
  * than a leading abbreviation: `Samikolla ibilbidea`. The name is taken as written.
  *
- * `ad:LocatorName` is populated on 46,365 of 68,744 addresses and holds a building name as a Basque
- * and Spanish pair, `Gasolinera` with `Gasolindegia` and `Agirre, baserria` with `Agirre, caserío`.
- * The adapter writes none of them. The address-source register's personal-data review reads `absent`
- * on the ground that these name the building rather than its occupant, and it records that a Basque
- * *baserri* name is commonly also a surname. Keeping them out of the corpus keeps that reading from
- * resting on the stronger claim that the name is safe to publish as address text.
+ * `ad:LocatorName` holds a building name as a Basque and Spanish pair, `Gasolinera` with
+ * `Gasolindegia` and `Agirre, baserria` with `Agirre, caserío`. The adapter writes none of them: the
+ * address-source register's personal-data review reads `absent` because these identify the building
+ * rather than its occupant, and a Basque *baserri* name is commonly also a surname. The review
+ * therefore does not rest on the stronger claim that the name is safe to publish as address text.
  *
- * No publisher-side rendering of a whole address was found for this source. `ad:alternativeIdentifier`
- * is populated on all 68,744 addresses and holds a serial number such as `36798` rather than an
- * address. What the file does state twice is the join: the address `gml:id`
- * `ES.GFA.AD.056_1110_003` concatenates the municipality code `056`, the thoroughfare code `1110`
- * and the number `003`, and the references it carries are `AU_ADMINISTRATIVEUNIT_34162020056`,
- * `ES.GFA.TN.056.1110` and `ES.GFA.PD.056.20830`. The adapter's test checks the composed street and
- * number against that identifier, which is a check that the right features were joined rather than a
- * check of the address the publisher would print.
+ * The address `gml:id` `ES.GFA.AD.056_1110_003` concatenates the municipality code `056`, the
+ * thoroughfare code `1110` and the number `003`, and holds references
+ * `AU_ADMINISTRATIVEUNIT_34162020056`, `ES.GFA.TN.056.1110` and `ES.GFA.PD.056.20830`. The
+ * adapter's test checks the composed street and number against that identifier. That check confirms
+ * the right features were joined. It does not check the address the publisher would print.
  */
 import { type CorpusAdapter } from "#types";
 /**
@@ -64,7 +56,8 @@ export declare const ES_GIPUZKOA_ADAPTER_ID = "es-gipuzkoa";
 /**
  * The jurisdiction this adapter emits.
  *
- * Coverage is the province of Gipuzkoa, which the feed states as the dataset's whole extent.
+ * Coverage is the province of Gipuzkoa.
+ * The feed states that as the dataset's whole extent.
  */
 export declare const ES_GIPUZKOA_COUNTRIES: readonly string[];
 /**
@@ -72,15 +65,15 @@ export declare const ES_GIPUZKOA_COUNTRIES: readonly string[];
  *
  * Gipuzkoa states four things, and the register elects the one addressing this dataset:
  * the `otherConstraints` of its ISO 19139 dataset record, `CC BY-SA 4.0`.
- * Its feed states attribution alone and its website states CC BY 4.0, and the register
- * records why the stricter reading is the one to err towards: the share-alike filter reads
- * this label, so recording CC BY 4.0 would hide an obligation the publisher may hold.
+ * Its feed states attribution only and its website states CC BY 4.0, and the register records
+ * why the stricter reading is the one to err towards: the share-alike filter reads this label,
+ * so recording CC BY 4.0 would hide an obligation the publisher may hold.
  *
  * The value is the SPDX identifier the register elected rather than the license's title,
  * because `licenseVerdict` resolves an identifier and reads a title as unrecognized.
  * Under `LicensePolicy.ShareAlikeFree` the title returns `{refusal: null, mentionsShareAlike: false}`
- * and `CC-BY-SA-4.0` returns `{refusal: "share-alike-carried"}`, so the title admits
- * these rows to a corpus assembled to hold no share-alike source.
+ * and `CC-BY-SA-4.0` returns a share-alike refusal, so the title admits these rows
+ * to a corpus assembled to hold no share-alike source.
  */
 export declare const ES_GIPUZKOA_LICENSE = "CC-BY-SA-4.0";
 export declare function createESGipuzkoaAdapter(): CorpusAdapter;

package/out/es/adapters/gipuzkoa/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../lib/es/adapters/gipuzkoa/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AAuBH,OAAO,EAAuD,KAAK,aAAa,EAAiB,MAAM,QAAQ,CAAA;AAE/G;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,gBAAgB,CAAA;AAEnD;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EAAW,CAAA;AAE9D;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,mBAAmB,iBAAiB,CAAA;AAkCjD,wBAAgB,uBAAuB,IAAI,aAAa,CAqCvD;AA+ED;;GAEG;AACH,eAAO,MAAM,iBAAiB,eAA4B,CAAA"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../lib/es/adapters/gipuzkoa/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAuBH,OAAO,EAAuD,KAAK,aAAa,EAAiB,MAAM,QAAQ,CAAA;AAE/G;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,gBAAgB,CAAA;AAEnD;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EAAW,CAAA;AAE9D;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,mBAAmB,iBAAiB,CAAA;AAkCjD,wBAAgB,uBAAuB,IAAI,aAAa,CAqCvD;AA+ED;;GAEG;AACH,eAAO,MAAM,iBAAiB,eAA4B,CAAA"}