@mailwoman/corpus 10.1.0 → 10.2.1

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

@@ -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 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 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 one zipped GML that holds the whole province.
+ *
+ * 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. 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.
- *
- * 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.
+ * `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.
+ *
+ * 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 { PathBuilder } from "path-ts";
 import { Globerator } from "spliterator/node/fs";
@@ -73,7 +65,8 @@ export 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 const ES_GIPUZKOA_COUNTRIES = ["ES"];
 /**
@@ -81,15 +74,15 @@ export const ES_GIPUZKOA_COUNTRIES = ["ES"];
  *
  * 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 const ES_GIPUZKOA_LICENSE = "CC-BY-SA-4.0";
 /**
@@ -154,20 +147,20 @@ export function createESGipuzkoaAdapter() {
     };
 }
 /**
- * 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_GIPUZKOA_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/gipuzkoa/adapter.js.map

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

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

@@ -9,15 +9,15 @@
  * The ATOM service at
  * `https://filescartografia.navarra.es/2_CARTOGRAFIA_TEMATICA/2_7_CATASTRO/2_7_3_INSPIRE_ATOM/2_7_3_3_AD/Addresses_ServiceATOM_Navarra.xml`
  * is 671,131 bytes and splits the province across 272 entries. Every entry is titled `Address
- * Navarra`, so a partition cannot be selected by place from the feed alone. The three measured each
- * turned out to hold one municipality, partition 1 Abáigar, partition 100 Eulate and partition 250
- * Bera, but the feed states no such mapping and this adapter claims none. It reads one archive or a
- * directory of them, which is how a caller harvests all 272.
+ * Navarra`, and the feed states no place for a partition. The three measured each held one
+ * municipality: partition 1 Abáigar, partition 100 Eulate and partition 250 Bera. The feed states
+ * no such mapping and this adapter claims none. It reads one archive or a directory of them. A
+ * caller harvests all 272 by pointing it at the directory.
  *
  * This publisher is read entirely from its references' titles, and that is what separates it from
  * every other INSPIRE reader here. Its own file publishes no `AD:ThoroughfareName`,
  * `AD:PostalDescriptor` or `AD:AdminUnitName` feature at all: partition 1 holds 29 distinct element
- * names across 115 addresses and none of them is a component feature. Each address instead carries
+ * names across 115 addresses and none of them is a component feature. Each address instead holds
  * six `AD:component` references whose `xlink:title` states the value:
  *
  * | `xlink:href` | `xlink:title` | read as |
@@ -30,7 +30,7 @@
  * | `PostalDescriptor` | `31280` | the postcode |
  *
  * The counts are exact and regular: 690 references over 115 addresses in partition 1, 1,728 over 288
- * in partition 100 and 6,324 over 1,054 in partition 250, which is six per address in each, one of
+ * in partition 100 and 6,324 over 1,054 in partition 250. Each address holds six references, one of
  * each shape above.
  *
  * The two place titles are not the same value. In Abáigar and Eulate the `5thOrder` title repeats the
@@ -39,7 +39,7 @@
  * dependent locality where it differs from the municipality and left out where it repeats it.
  *
  * `Comunidad Foral de Navarra` is the autonomous community's own name rather than the province name a
- * Spanish address writes, and the publisher's own address layer carries no region column, so no
+ * Spanish address writes, and the publisher's own address layer has no region column, so no
  * `region` is written.
  *
  * The publisher's own rendering is in a different service, and it agrees. `IDENA` publishes
@@ -47,12 +47,12 @@
  * `VIA` and `PORTAL`. Partition 1's `AD.Address.1` composes `CALLE CALLEJA, 4, 31280 Abáigar`, and
  * that layer's `DIRECC_Txt_Direcciones.1` reads `MUNICIPIO` `Abáigar`, `ENTIDAD` `Abáigar`,
  * `CODPOSTAL` `31280`, `VIA` `CALLE CALLEJA`, `PORTAL` `4`. The adapter's integration test checks a
- * sample of rows against that layer, which is this source's publisher-side oracle.
+ * sample of rows against that layer, the publisher-side oracle for this source.
  *
  * Two values state an absence rather than a value. A `PostalDescriptor` title of `0` is the publisher
- * holding no postcode, measured in Bera, and a designator of `S/N` is *sin número*, which
- * `#es/cadastre` reads for all four Spanish cadastres. A designator may also carry a space-separated
- * letter, `18 A` and `34 A` in Eulate, which is kept as the publisher wrote it.
+ * holding no postcode, measured in Bera. A designator of `S/N` is *sin número*, and `#es/cadastre`
+ * reads it for all four Spanish cadastres. A designator may also hold a space-separated letter,
+ * `18 A` and `34 A` in Eulate. The adapter keeps that letter as the publisher wrote it.
  */
 import { type MarkupElement } from "@mailwoman/core/html/elements";
 import { type CorpusAdapter } from "#types";
@@ -74,20 +74,21 @@ export declare const ES_NAVARRA_COUNTRIES: readonly string[];
  * Creative Commons Attribution 4.0 International (CC BY 4.0)`, and all 272 of its entries repeat it.
  * The version is stated, so the register records `CC-BY-4.0` as the SPDX identifier.
  *
- * The row carries that identifier rather than the license's title.
- * `licenseVerdict` resolves an identifier and reads a title as unrecognized,
- * and a row whose license resolves to no expression has unknown obligations
- * rather than none, which the build reports separately from a refusal.
+ * The row states that identifier rather than the license's title.
+ * `licenseVerdict` resolves an identifier and reads a title as unrecognized.
+ *
+ * A row whose license resolves to no expression has unknown obligations rather than none.
+ * The build reports that separately from a refusal.
  */
 export declare const ES_NAVARRA_LICENSE = "CC-BY-4.0";
 /**
  * What one address's references state, read from their titles.
  */
 interface ReferencedTitles {
-    street?: string;
-    postcode?: string;
-    locality?: string;
-    settlement?: string;
+    street: string | null;
+    postcode: string | null;
+    locality: string | null;
+    settlement: string | null;
 }
 /**
  * The street, postcode and place names an address's own references state.

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

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../lib/es/adapters/navarra/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AAEH,OAAO,EAAE,KAAK,aAAa,EAAwB,MAAM,+BAA+B,CAAA;AAgBxF,OAAO,EAAuD,KAAK,aAAa,EAAiB,MAAM,QAAQ,CAAA;AAE/G;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,eAAe,CAAA;AAEjD;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EAAW,CAAA;AAE7D;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,kBAAkB,cAAc,CAAA;AAoD7C;;GAEG;AACH,UAAU,gBAAgB;IACzB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,aAAa,GAAG,gBAAgB,CAoBhF;AAED,wBAAgB,sBAAsB,IAAI,aAAa,CA2CtD;AAoDD;;GAEG;AACH,eAAO,MAAM,gBAAgB,eAA2B,CAAA"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../lib/es/adapters/navarra/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AAEH,OAAO,EAAE,KAAK,aAAa,EAAwB,MAAM,+BAA+B,CAAA;AAgBxF,OAAO,EAAuD,KAAK,aAAa,EAAiB,MAAM,QAAQ,CAAA;AAE/G;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,eAAe,CAAA;AAEjD;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EAAW,CAAA;AAE7D;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,kBAAkB,cAAc,CAAA;AAoD7C;;GAEG;AACH,UAAU,gBAAgB;IACzB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,aAAa,GAAG,gBAAgB,CAoBhF;AAED,wBAAgB,sBAAsB,IAAI,aAAa,CA2CtD;AAoDD;;GAEG;AACH,eAAO,MAAM,gBAAgB,eAA2B,CAAA"}

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

@@ -9,15 +9,15 @@
  * The ATOM service at
  * `https://filescartografia.navarra.es/2_CARTOGRAFIA_TEMATICA/2_7_CATASTRO/2_7_3_INSPIRE_ATOM/2_7_3_3_AD/Addresses_ServiceATOM_Navarra.xml`
  * is 671,131 bytes and splits the province across 272 entries. Every entry is titled `Address
- * Navarra`, so a partition cannot be selected by place from the feed alone. The three measured each
- * turned out to hold one municipality, partition 1 Abáigar, partition 100 Eulate and partition 250
- * Bera, but the feed states no such mapping and this adapter claims none. It reads one archive or a
- * directory of them, which is how a caller harvests all 272.
+ * Navarra`, and the feed states no place for a partition. The three measured each held one
+ * municipality: partition 1 Abáigar, partition 100 Eulate and partition 250 Bera. The feed states
+ * no such mapping and this adapter claims none. It reads one archive or a directory of them. A
+ * caller harvests all 272 by pointing it at the directory.
  *
  * This publisher is read entirely from its references' titles, and that is what separates it from
  * every other INSPIRE reader here. Its own file publishes no `AD:ThoroughfareName`,
  * `AD:PostalDescriptor` or `AD:AdminUnitName` feature at all: partition 1 holds 29 distinct element
- * names across 115 addresses and none of them is a component feature. Each address instead carries
+ * names across 115 addresses and none of them is a component feature. Each address instead holds
  * six `AD:component` references whose `xlink:title` states the value:
  *
  * | `xlink:href` | `xlink:title` | read as |
@@ -30,7 +30,7 @@
  * | `PostalDescriptor` | `31280` | the postcode |
  *
  * The counts are exact and regular: 690 references over 115 addresses in partition 1, 1,728 over 288
- * in partition 100 and 6,324 over 1,054 in partition 250, which is six per address in each, one of
+ * in partition 100 and 6,324 over 1,054 in partition 250. Each address holds six references, one of
  * each shape above.
  *
  * The two place titles are not the same value. In Abáigar and Eulate the `5thOrder` title repeats the
@@ -39,7 +39,7 @@
  * dependent locality where it differs from the municipality and left out where it repeats it.
  *
  * `Comunidad Foral de Navarra` is the autonomous community's own name rather than the province name a
- * Spanish address writes, and the publisher's own address layer carries no region column, so no
+ * Spanish address writes, and the publisher's own address layer has no region column, so no
  * `region` is written.
  *
  * The publisher's own rendering is in a different service, and it agrees. `IDENA` publishes
@@ -47,12 +47,12 @@
  * `VIA` and `PORTAL`. Partition 1's `AD.Address.1` composes `CALLE CALLEJA, 4, 31280 Abáigar`, and
  * that layer's `DIRECC_Txt_Direcciones.1` reads `MUNICIPIO` `Abáigar`, `ENTIDAD` `Abáigar`,
  * `CODPOSTAL` `31280`, `VIA` `CALLE CALLEJA`, `PORTAL` `4`. The adapter's integration test checks a
- * sample of rows against that layer, which is this source's publisher-side oracle.
+ * sample of rows against that layer, the publisher-side oracle for this source.
  *
  * Two values state an absence rather than a value. A `PostalDescriptor` title of `0` is the publisher
- * holding no postcode, measured in Bera, and a designator of `S/N` is *sin número*, which
- * `#es/cadastre` reads for all four Spanish cadastres. A designator may also carry a space-separated
- * letter, `18 A` and `34 A` in Eulate, which is kept as the publisher wrote it.
+ * holding no postcode, measured in Bera. A designator of `S/N` is *sin número*, and `#es/cadastre`
+ * reads it for all four Spanish cadastres. A designator may also hold a space-separated letter,
+ * `18 A` and `34 A` in Eulate. The adapter keeps that letter as the publisher wrote it.
  */
 import { streamMarkupElements } from "@mailwoman/core/html/elements";
 import { PathBuilder } from "path-ts";
@@ -82,10 +82,11 @@ export const ES_NAVARRA_COUNTRIES = ["ES"];
  * Creative Commons Attribution 4.0 International (CC BY 4.0)`, and all 272 of its entries repeat it.
  * The version is stated, so the register records `CC-BY-4.0` as the SPDX identifier.
  *
- * The row carries that identifier rather than the license's title.
- * `licenseVerdict` resolves an identifier and reads a title as unrecognized,
- * and a row whose license resolves to no expression has unknown obligations
- * rather than none, which the build reports separately from a refusal.
+ * The row states that identifier rather than the license's title.
+ * `licenseVerdict` resolves an identifier and reads a title as unrecognized.
+ *
+ * A row whose license resolves to no expression has unknown obligations rather than none.
+ * The build reports that separately from a refusal.
  */
 export const ES_NAVARRA_LICENSE = "CC-BY-4.0";
 /**
@@ -127,7 +128,7 @@ const SETTLEMENT_LEVEL = "5thOrder";
 /**
  * The postcode title that states that the publisher holds none.
  *
- * Measured in Bera, which writes `0` beside its `31780`.
+ * Bera writes `0` beside its `31780`.
  */
 const NO_POSTCODE_TITLE = "0";
 /**
@@ -137,7 +138,7 @@ const NO_POSTCODE_TITLE = "0";
  * order in the three partitions measured and that order is the publisher's rather than the schema's.
  */
 export function navarraReferencedTitles(address) {
-    const titles = {};
+    const titles = { street: null, postcode: null, locality: null, settlement: null };
     for (const { href, title } of componentLinks(address)) {
         if (!title)
             continue;
@@ -146,7 +147,7 @@ export function navarraReferencedTitles(address) {
             titles.street = title;
         }
         else if (lowered === POSTAL_DESCRIPTOR_HREF) {
-            titles.postcode = title === NO_POSTCODE_TITLE ? undefined : title;
+            titles.postcode = title === NO_POSTCODE_TITLE ? null : title;
         }
         else if (codelistValue(href) === SETTLEMENT_LEVEL) {
             titles.settlement = title;
@@ -196,16 +197,16 @@ export function createESNavarraAdapter() {
     };
 }
 /**
- * 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.
  */
 function composeRow(address) {
-    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_NAVARRA_ADAPTER_ID, addressID, HOUSE_NUMBER_TYPE);
     }
     const { street, postcode, locality, settlement } = navarraReferencedTitles(address);
-    // Navarra's settlement is a fifth-order title, a *concejo* within the municipality, which
-    // `cadastralRow` writes as a dependent locality only where it differs from the municipality.
+    // Navarra's settlement is a fifth-order title, a *concejo* within the municipality.
+    // `cadastralRow` writes it as a dependent locality only where it differs from the municipality.
     return cadastralRow({
         street,
         house: spanishHouseNumber(designatorsByType(address), HOUSE_NUMBER_TYPE),

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

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

package/out/es/cadastre.d.ts

@@ -3,7 +3,7 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- * The two ways a Spanish cadastre states that it holds no value, which all four of them share.
+ * The two ways a Spanish cadastre states that it holds no value. All four cadastres share them.
  *
  * Spain publishes the INSPIRE Addresses theme through four cadastres: the Dirección General del
  * Catastro for 52 provinces, and the Diputación Foral de Bizkaia, the Diputación Foral de Gipuzkoa
@@ -17,20 +17,20 @@ import type { CanonicalRow } from "#types";
  * Whether a designator value states that the address has no number.
  *
  * The whole value has to be the token.
- * A value that carries more, such as Gipuzkoa's `S/N-A`, `S/N-C` and `S/N-5`,
+ * A value that holds more, such as Gipuzkoa's `S/N-A`, `S/N-C` and `S/N-5`,
  * states something further and is kept as the publisher wrote it: what the trailing part
  * designates is not established, dropping it would merge several addresses of one building,
  * and rewriting it would state a number the publisher did not.
  */
 export declare function isSinNumero(value: string): boolean;
 /**
- * The house number a Spanish cadastre states, or undefined where it states that there is none.
+ * The house number a Spanish cadastre states, or null where it states that there is none.
  *
  * @param types The publisher's own designator types, in the caller's order of precedence.
  * The Dirección General del Catastro writes the type as the element text `1`, while Navarra
  * and Gipuzkoa write the `LocatorDesignatorTypeValue/addressIdentifierGeneral` codelist URI.
  */
-export declare function spanishHouseNumber(byType: ReadonlyMap<string, readonly string[]>, ...types: readonly string[]): string | undefined;
+export declare function spanishHouseNumber(byType: ReadonlyMap<string, readonly string[]>, ...types: readonly string[]): string | null;
 /**
  * Whether a component reference's key states that the publisher holds no value for that component.
  *
@@ -40,9 +40,7 @@ export declare function spanishHouseNumber(byType: ReadonlyMap<string, readonly
  * Where the cadastre holds no postcode it writes the same identifier with that segment empty,
  * `ES.SDGC.PD.55.101.` and `ES.GFA.PD.059.`, against no feature of that id.
  *
- * Those truncated references are the only unresolvable ones measured in either
- * file: 70 of Ceuta's 8,126 addresses carry one, while its thoroughfare
- * and administrative-unit references resolve 8,126 of 8,126 each.
+ * Those truncated references are the only unresolvable ones measured in either file.
  * A reader taking every unresolved reference as an absence would also swallow a genuinely
  * broken join, so the two are separated here and every other unresolved reference raises.
  */
@@ -57,27 +55,29 @@ export interface CadastralAddress {
     /**
      * The thoroughfare name the address references, absent where the publisher writes none.
      */
-    street: string | undefined;
+    street: string | null;
     /**
      * The house number this cadastre's own designator type states.
      */
-    house: string | undefined;
+    house: string | null;
     /**
      * The postal descriptor's code.
      */
-    postcode: string | undefined;
+    postcode: string | null;
     /**
      * The municipality-level administrative unit's name.
      */
-    locality: string | undefined;
+    locality: string | null;
     /**
-     * The address-area name, which is a settlement within the municipality.
+     * The address-area name.
+     * It is a settlement within the municipality.
      */
-    settlement: string | undefined;
+    settlement: string | null;
     /**
-     * The publisher's own identifier for the address, which keys `source_id` where it exists.
+     * The publisher's own identifier for the address.
+     * It keys `source_id` where it exists.
      */
-    addressID: string | undefined;
+    addressID: string | null;
 }
 /**
  * What distinguishes one cadastre's rows from another's.
@@ -99,11 +99,12 @@ export interface CadastralSource {
  * The address area supplies a dependent locality only where the two differ.
  * The line renders in Spain's order.
  *
- * Composing that in each adapter repeated 42 lines four times.
+ * Each adapter would otherwise repeat those 42 lines four times.
  *
- * Returns `undefined` in two cases: the address carries neither a municipality
- * nor an address area, which would leave the row without a locality, or `formatAddressRow`
- * returns `undefined` for the components it was given.
+ * Returns `null` in two cases.
+ * The address holds neither a municipality nor an address area, so the row would have no locality.
+ *
+ * Otherwise `formatAddressRow` returns `null` for the components it was given.
  */
-export declare function cadastralRow(address: CadastralAddress, source: CadastralSource): CanonicalRow | undefined;
+export declare function cadastralRow(address: CadastralAddress, source: CadastralSource): CanonicalRow | null;
 //# sourceMappingURL=cadastre.d.ts.map

package/out/es/cadastre.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cadastre.d.ts","sourceRoot":"","sources":["../../lib/es/cadastre.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AAe1C;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CACjC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,EAC9C,GAAG,KAAK,EAAE,SAAS,MAAM,EAAE,GACzB,MAAM,GAAG,SAAS,CAMpB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAChC;;OAEG;IACH,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B;;OAEG;IACH,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB;;OAEG;IACH,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5B;;OAEG;IACH,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5B;;OAEG;IACH,UAAU,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9B;;OAEG;IACH,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;CAC7B;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC/B,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,eAAe,GAAG,YAAY,GAAG,SAAS,CAiDzG"}
+{"version":3,"file":"cadastre.d.ts","sourceRoot":"","sources":["../../lib/es/cadastre.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AAc1C;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CACjC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,EAC9C,GAAG,KAAK,EAAE,SAAS,MAAM,EAAE,GACzB,MAAM,GAAG,IAAI,CAMf;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAChC;;OAEG;IACH,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB;;OAEG;IACH,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB;;OAEG;IACH,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB;;OAEG;IACH,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB;;;OAGG;IACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB;;;OAGG;IACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC/B,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,eAAe,GAAG,YAAY,GAAG,IAAI,CAiDpG"}

package/out/es/cadastre.js

@@ -3,7 +3,7 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- * The two ways a Spanish cadastre states that it holds no value, which all four of them share.
+ * The two ways a Spanish cadastre states that it holds no value. All four cadastres share them.
  *
  * Spain publishes the INSPIRE Addresses theme through four cadastres: the Dirección General del
  * Catastro for 52 provinces, and the Diputación Foral de Bizkaia, the Diputación Foral de Gipuzkoa
@@ -21,17 +21,16 @@ import { designator } from "#inspire/address";
  * `S-N` is the Dirección General del Catastro's spelling, on 856 of Ceuta's 8,126 addresses.
  * `S/N` is the Gobierno de Navarra's and the Diputación Foral de Gipuzkoa's.
  *
- * Both are accepted by each of the four readers.
- * Neither is a number under any jurisdiction's rules, and the files measured are a few municipalities
- * out of the 52 provinces, 112 municipalities and 272 partitions those services publish,
- * so a reader scoped to the one spelling its own sample carried would write the other into a row.
+ * All four readers accept both.
+ * Neither is a number under any jurisdiction's rules, and a reader scoped to one
+ * spelling would write the other spelling into a row.
  */
 const SIN_NUMERO = new Set(["s-n", "s/n"]);
 /**
  * Whether a designator value states that the address has no number.
  *
  * The whole value has to be the token.
- * A value that carries more, such as Gipuzkoa's `S/N-A`, `S/N-C` and `S/N-5`,
+ * A value that holds more, such as Gipuzkoa's `S/N-A`, `S/N-C` and `S/N-5`,
  * states something further and is kept as the publisher wrote it: what the trailing part
  * designates is not established, dropping it would merge several addresses of one building,
  * and rewriting it would state a number the publisher did not.
@@ -40,7 +39,7 @@ export function isSinNumero(value) {
     return SIN_NUMERO.has(value.trim().toLowerCase());
 }
 /**
- * The house number a Spanish cadastre states, or undefined where it states that there is none.
+ * The house number a Spanish cadastre states, or null where it states that there is none.
  *
  * @param types The publisher's own designator types, in the caller's order of precedence.
  * The Dirección General del Catastro writes the type as the element text `1`, while Navarra
@@ -49,7 +48,7 @@ export function isSinNumero(value) {
 export function spanishHouseNumber(byType, ...types) {
     const value = designator(byType, ...types);
     if (!value || isSinNumero(value))
-        return undefined;
+        return null;
     return value;
 }
 /**
@@ -61,9 +60,7 @@ export function spanishHouseNumber(byType, ...types) {
  * Where the cadastre holds no postcode it writes the same identifier with that segment empty,
  * `ES.SDGC.PD.55.101.` and `ES.GFA.PD.059.`, against no feature of that id.
  *
- * Those truncated references are the only unresolvable ones measured in either
- * file: 70 of Ceuta's 8,126 addresses carry one, while its thoroughfare
- * and administrative-unit references resolve 8,126 of 8,126 each.
+ * Those truncated references are the only unresolvable ones measured in either file.
  * A reader taking every unresolved reference as an absence would also swallow a genuinely
  * broken join, so the two are separated here and every other unresolved reference raises.
  */
@@ -80,16 +77,17 @@ export function referenceStatesNoValue(key) {
  * The address area supplies a dependent locality only where the two differ.
  * The line renders in Spain's order.
  *
- * Composing that in each adapter repeated 42 lines four times.
+ * Each adapter would otherwise repeat those 42 lines four times.
  *
- * Returns `undefined` in two cases: the address carries neither a municipality
- * nor an address area, which would leave the row without a locality, or `formatAddressRow`
- * returns `undefined` for the components it was given.
+ * Returns `null` in two cases.
+ * The address holds neither a municipality nor an address area, so the row would have no locality.
+ *
+ * Otherwise `formatAddressRow` returns `null` for the components it was given.
  */
 export function cadastralRow(address, source) {
     const place = address.locality ?? address.settlement;
     if (!place)
-        return undefined;
+        return null;
     const components = {};
     if (address.house) {
         components.house_number = address.house;
@@ -103,22 +101,22 @@ export function cadastralRow(address, source) {
     components.locality = place;
     // The address area is a settlement within the municipality where the two names differ,
     // and repeats the municipality where they do not.
-    // Writing the repetition would state a dependent locality the publisher does not hold.
+    // The repetition would state a dependent locality the publisher does not hold.
     if (address.settlement && address.locality && address.settlement !== address.locality) {
         components.dependent_locality = address.settlement;
     }
     const rendered = formatAddressRow(components, "ES", { singleLine: true });
     if (!rendered)
-        return undefined;
+        return null;
     const { raw, components: aligned } = rendered;
     return {
         raw,
         components: aligned,
         country: "ES",
         locale: "es-ES",
-        // `register` is left to `runAdapter`, which stamps the adapter's own
-        // declaration onto a row that omits it.
-        // Setting it here would state per row what the adapter already states once.
+        // The row omits `register`.
+        // `runAdapter` stamps the adapter's own declaration onto it.
+        // A per-row `register` would repeat what the adapter already states once.
         source: source.adapterID,
         source_id: address.addressID
             ? `${source.adapterID}-${address.addressID}`