@mailwoman/corpus 10.1.0 → 10.2.1

package/out/inspire/address.d.ts

@@ -27,8 +27,8 @@
  *    without regard to case, and accept either form of a coded value.
  *
  * So this module exposes the primitives and leaves composition to each adapter. A configuration
- * object describing those four axes would have to be right about publishers whose files nobody has
- * read yet. A handful of small functions carries no such claim.
+ * object describing those axes would state claims about files no one has read. These small
+ * functions state none.
  *
  * The reference form is the exception, because its shapes are enumerable and measured:
  * {@linkcode componentJoinKey} reads all four.
@@ -42,33 +42,34 @@ import type { MarkupElement } from "@mailwoman/core/html/elements";
  *
  * The Dirección General del Catastro and the Gobierno de Navarra bind the same
  * two namespaces to `AD:` and `GN:`.
- * A reader comparing the name exactly finds neither a locator nor a street
- * nor a postcode in either Spanish file.
+ * An exact comparison finds neither a locator, a street nor a postcode in either Spanish file.
  *
- * That reads as an address carrying none rather than as a prefix this repository had not met.
+ * That reads as an address with none of those rather than as an unfamiliar prefix.
  *
- * The prefix is still compared, because it carries the namespace and the namespace carries the meaning.
+ * The prefix is still compared, because it identifies the namespace and the namespace holds the meaning.
  * The Service public de Wallonie writes three `gml:name` elements inside each
  * `ad:ThoroughfareName`, ahead of the `ad:name` that holds the street.
  *
- * A reader that dropped the prefix and matched on `name` alone read the first of those three
- * and found no street on any of Wallonia's 58,591 thoroughfare features.
+ * A reader that dropped the prefix and matched only on `name` read the first of those three,
+ * so it found no street on any of Wallonia's 58,591 thoroughfare features.
  */
 export declare function inspireNameIs(name: string, wanted: string): boolean;
 /**
- * The first child of `element` named `name`, ignoring case.
+ * The first child of `element` whose name matches `name`, ignoring case.
  *
- * `name` is written with the prefix the INSPIRE guideline uses, which is the
- * prefix eight of the nine publishers write.
- * The case-insensitive sibling of `childElement` from `@mailwoman/core/html/elements`,
- * which compares the name exactly as a general markup reader must.
+ * Write `name` with the prefix the INSPIRE guideline uses.
+ * Eight of the nine publishers use it.
+ *
+ * The case-insensitive sibling of `childElement` from `@mailwoman/core/html/elements`.
+ * That
+ * function compares the name exactly, as a general markup reader must.
  */
-export declare function inspireChild(element: MarkupElement, name: string): MarkupElement | undefined;
+export declare function inspireChild(element: MarkupElement, name: string): MarkupElement | null;
 /**
- * Every child of `element` named `name`, in document order, ignoring case.
+ * Every child of `element` whose name matches `name`, in document order, ignoring case.
  *
  * The case-insensitive sibling of `childElements` from `@mailwoman/core/html/elements`,
- * for the same reason {@linkcode inspireChild} is.
+ * for the same reason {@linkcode inspireChild} exists.
  */
 export declare function inspireChildren(element: MarkupElement, name: string): readonly MarkupElement[];
 /**
@@ -78,50 +79,55 @@ export declare function inspireChildren(element: MarkupElement, name: string): r
  * An INSPIRE value sits five or six elements down, so the path form reads better than
  * a chain of {@linkcode inspireChild} calls and reports the same absence.
  */
-export declare function inspireElementAt(element: MarkupElement, ...path: readonly string[]): MarkupElement | undefined;
+export declare function inspireElementAt(element: MarkupElement, ...path: readonly string[]): MarkupElement | null;
 /**
- * The final segment of an INSPIRE codelist URI, which is the value's name.
+ * The final segment of an INSPIRE codelist URI.
+ * That segment is the value's name.
  *
  * `http://inspire.ec.europa.eu/codelist/LocatorDesignatorTypeValue/buildingIdentifier`
  * reads `buildingIdentifier`.
  * A `#` fragment is dropped first, because Flanders appends one to a `vocab.belgif.be`
  * reference and Czechia folds it into `base:localId`.
  */
-export declare function codelistValue(uri: string | undefined): string | undefined;
+export declare function codelistValue(uri: string | null | undefined): string | null;
 /**
  * Whether a publisher marked this element void.
  *
  * INSPIRE writes `xsi:nil="true"` and usually a `nilReason`.
  * Brussels writes the nil marker and no reason on all 232,003 of its void `ad:validFrom`
- * elements, and Czechia writes four `gn:pronunciation` elements nil with no reason,
- * so a reader keyed on `nilReason` alone mistakes a void value for a populated one.
+ * elements, and Czechia writes four `gn:pronunciation` elements nil with no reason.
+ *
+ * A reader that keys only on `nilReason` mistakes a void value for a populated one.
  *
  * An absent element answers false, so a caller distinguishes a void value from a missing one.
  */
-export declare function isVoid(element: MarkupElement | undefined): boolean;
+export declare function isVoid(element: MarkupElement | null): boolean;
 /**
  * The reason a publisher gave for a void element, as a codelist value such as `Unpopulated`.
  *
- * Returns undefined when the element is void and states no reason, which the
- * schema permits and which Brussels does throughout.
- * A caller that needs to separate a void carrying a reason from a void carrying
- * none reads this together with {@linkcode isVoid}.
+ * Returns null when the element is void and states no reason.
+ * The schema permits that form, and Brussels uses it throughout.
+ *
+ * A caller that needs to separate a void with a reason from a void with none
+ * reads this together with {@linkcode isVoid}.
  */
-export declare function voidReason(element: MarkupElement | undefined): string | undefined;
+export declare function voidReason(element: MarkupElement | null): string | null;
 /**
  * Every locator designator on an address, keyed by its INSPIRE type name.
  *
- * One `ad:AddressLocator` carries a designator per part of the number, each in its
- * own `ad:LocatorDesignator` beside an `ad:type` naming what it is.
+ * One `ad:AddressLocator` holds a designator per part of the number, each in its own
+ * `ad:LocatorDesignator` beside an `ad:type` that states what it is.
  * Czechia writes two, `č.ev.` typed `buildingIdentifierPrefix` and `502` typed `buildingIdentifier`.
  *
  * The Netherlands writes four, including an empty `LocatorDesignatorTypeValue/addressNumberExtension`
  * and the postcode as `LocatorDesignatorTypeValue/postalDeliveryIdentifier`.
  *
  * A type may repeat, so each key holds a list in document order.
- * A designator the publisher wrote empty contributes an empty string, which is a value the publisher
- * stated rather than one it omitted: the Netherlands writes `<ad:designator/>` 198,118 times
- * over 108,708 features to mean "no extension", and that is a different condition from void.
+ * A designator the publisher wrote empty contributes an empty string.
+ *
+ * That string is a value the publisher stated rather than one it omitted.
+ * The Netherlands writes `<ad:designator/>` 198,118 times over 108,708 features to
+ * mean "no extension", and that condition differs from void.
  *
  * A designator whose `ad:type` is absent or void is skipped, because its value cannot be placed.
  */
@@ -142,19 +148,21 @@ export declare function designatorsByType(address: MarkupElement): ReadonlyMap<s
  * value has to be reported rather than turned into an absence.
  *
  * A caller reads this when the difference changes what it does.
- * An adapter that refuses a row carrying no house number should report a void `buildingIdentifier` as
+ * An adapter that refuses a row with no house number should report a void `buildingIdentifier` as
  * a value it could not read, and an absent one as an address the publisher states has no number.
  */
 export declare function voidDesignatorTypes(address: MarkupElement): ReadonlySet<string>;
-export declare function designator(byType: ReadonlyMap<string, readonly string[]>, ...types: readonly string[]): string | undefined;
+export declare function designator(byType: ReadonlyMap<string, readonly string[]>, ...types: readonly string[]): string | null;
 /**
  * Every `ad:component` reference on an address, as written.
  *
  * The href is returned verbatim, and {@linkcode componentJoinKey} turns it into a join key.
  * A component whose href is absent or empty is skipped.
  *
- * Brussels writes `<ad:component xlink:href=""/>` on 9 addresses, and those 9 therefore
- * carry no postal zone, which a caller must report rather than read as a resolved component.
+ * Brussels writes `<ad:component xlink:href=""/>` on 9 addresses.
+ * Those 9 hold no postal zone.
+ *
+ * A caller must report that rather than read a resolved component.
  */
 export declare function componentHrefs(address: MarkupElement): readonly string[];
 /**
@@ -166,9 +174,9 @@ export interface ComponentLink {
      */
     readonly href: string;
     /**
-     * The `xlink:title`, or undefined where the reference carries none.
+     * The `xlink:title`, or null where the reference has no title.
      */
-    readonly title?: string;
+    readonly title: string | null;
 }
 /**
  * Every `ad:component` reference on an address, with its title.
@@ -181,7 +189,7 @@ export interface ComponentLink {
  * and an administrative-unit reference addresses a CartoCiudad stored query.
  *
  * The title is the only statement of the street name, the postcode and the place names
- * that its own file carries, so its adapter reads titles and resolves no reference.
+ * in its own file, so its adapter reads titles and resolves no reference.
  *
  * A component whose href is absent or empty is skipped, as in {@linkcode componentHrefs}.
  */
@@ -199,20 +207,22 @@ export declare function componentLinks(address: MarkupElement): readonly Compone
  * | Slovakia | `…ad/ows?…&id=AdminUnitName.15345` | `AdminUnitName.15345` |
  * | Flanders | `https://data.vlaanderen.be/id/straatnaam/6301` | the URI itself |
  *
- * A URI with no id parameter is its own key, which is what Flanders publishes on both sides of the join.
- * Its fragment is dropped, because a reference may carry one where the identifier does not:
+ * A URI with no id parameter is its own key.
+ * Flanders publishes that form on both sides of the join.
+ *
+ * Its fragment is dropped, because a reference may hold one where the identifier does not:
  * `http://vocab.belgif.be/auth/refnis1995/1000#id` addresses the same term as that URI without it.
  *
  * Whether a key joins is not a property of its spelling, so this reads a key
  * and the caller decides joinability against the features the publisher actually served.
- * Deciding it here from the URL's shape once reported 15 of Flanders' 20 references as
- * belonging to another register when every one of them addressed a feature of the same service.
+ * A check based on the URL's shape once reported 15 of Flanders' 20 references as belonging
+ * to another register, when every one of them addressed a feature of the same service.
  *
- * @returns The key, or undefined when the href is neither a fragment nor a URL.
+ * @returns The key, or null when the href is neither a fragment nor a URL.
  */
-export declare function componentJoinKey(href: string): string | undefined;
+export declare function componentJoinKey(href: string): string | null;
 /**
- * The spelling a `gn:GeographicalName` carries, reached from a feature that holds one.
+ * The spelling a `gn:GeographicalName` holds, reached from a feature that has one.
  *
  * Every name-bearing INSPIRE feature nests the text at
  * `…/gn:GeographicalName/gn:spelling/gn:SpellingOfName/gn:text`, under a per-feature
@@ -220,17 +230,17 @@ export declare function componentJoinKey(href: string): string | undefined;
  * while an `ad:AdminUnitName` and an `ad:AddressAreaName` add only `ad:name`.
  * The caller gives the prefix.
  *
- * @returns The text, or undefined when any step is absent or the name is void.
+ * @returns The text, or null when any step is absent or the name is void.
  */
-export declare function geographicalNameText(feature: MarkupElement, ...prefix: readonly string[]): string | undefined;
+export declare function geographicalNameText(feature: MarkupElement, ...prefix: readonly string[]): string | null;
 /**
  * The street name an `ad:ThoroughfareName` feature states.
  */
-export declare function thoroughfareName(feature: MarkupElement): string | undefined;
+export declare function thoroughfareName(feature: MarkupElement): string | null;
 /**
  * The place name an `ad:AdminUnitName` or `ad:AddressAreaName` feature states.
  */
-export declare function placeName(feature: MarkupElement): string | undefined;
+export declare function placeName(feature: MarkupElement): string | null;
 /**
  * The postcode an `ad:PostalDescriptor` feature states.
  *
@@ -238,7 +248,7 @@ export declare function placeName(feature: MarkupElement): string | undefined;
  * Left-padding belongs to the caller that knows the jurisdiction's width,
  * because this reader returns what the publisher wrote.
  */
-export declare function postalDescriptorCode(feature: MarkupElement): string | undefined;
+export declare function postalDescriptorCode(feature: MarkupElement): string | null;
 /**
  * The administrative level an `ad:AdminUnitName` states, as a codelist value such as `4thOrder`.
  *
@@ -247,5 +257,5 @@ export declare function postalDescriptorCode(feature: MarkupElement): string | u
  * publishes exactly one `ad:AdminUnitName` feature, the country.
  * A caller picks the finest level it wants by this value rather than by the order the references appear.
  */
-export declare function adminUnitLevel(feature: MarkupElement): string | undefined;
+export declare function adminUnitLevel(feature: MarkupElement): string | null;
 //# sourceMappingURL=address.d.ts.map

package/out/inspire/address.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"address.d.ts","sourceRoot":"","sources":["../../lib/inspire/address.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAElE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAE5F;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,aAAa,EAAE,CAE9F;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,aAAa,GAAG,SAAS,CAU9G;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAOzE;AAED;;;;;;;;;GASG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,GAAG,OAAO,CAElE;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAIjF;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,aAAa,GAAG,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAmChG;AAED;;;;;;GAMG;AACH;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,GAAG,WAAW,CAAC,MAAM,CAAC,CAwB/E;AAED,wBAAgB,UAAU,CACzB,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,EAC9C,GAAG,KAAK,EAAE,SAAS,MAAM,EAAE,GACzB,MAAM,GAAG,SAAS,CAUpB;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,MAAM,EAAE,CAExE;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACvB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,aAAa,EAAE,CAc/E;AAYD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CA0BjE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAe7G;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CAE3E;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CAEpE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CAQ/E;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CAMzE"}
+{"version":3,"file":"address.d.ts","sourceRoot":"","sources":["../../lib/inspire/address.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAElE;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAEvF;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,aAAa,EAAE,CAE9F;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,aAAa,GAAG,IAAI,CAUzG;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAO3E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,GAAG,OAAO,CAE7D;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAIvE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,aAAa,GAAG,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAmChG;AAED;;;;;;GAMG;AACH;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,GAAG,WAAW,CAAC,MAAM,CAAC,CAyB/E;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,EAAE,GAAG,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAUrH;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,MAAM,EAAE,CAExE;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAC7B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,aAAa,EAAE,CAc/E;AAYD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA0B5D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAexG;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CAEtE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CAE/D;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CAQ1E;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CAMpE"}

package/out/inspire/address.js

@@ -27,8 +27,8 @@
  *    without regard to case, and accept either form of a coded value.
  *
  * So this module exposes the primitives and leaves composition to each adapter. A configuration
- * object describing those four axes would have to be right about publishers whose files nobody has
- * read yet. A handful of small functions carries no such claim.
+ * object describing those axes would state claims about files no one has read. These small
+ * functions state none.
  *
  * The reference form is the exception, because its shapes are enumerable and measured:
  * {@linkcode componentJoinKey} reads all four.
@@ -41,37 +41,38 @@
  *
  * The Dirección General del Catastro and the Gobierno de Navarra bind the same
  * two namespaces to `AD:` and `GN:`.
- * A reader comparing the name exactly finds neither a locator nor a street
- * nor a postcode in either Spanish file.
+ * An exact comparison finds neither a locator, a street nor a postcode in either Spanish file.
  *
- * That reads as an address carrying none rather than as a prefix this repository had not met.
+ * That reads as an address with none of those rather than as an unfamiliar prefix.
  *
- * The prefix is still compared, because it carries the namespace and the namespace carries the meaning.
+ * The prefix is still compared, because it identifies the namespace and the namespace holds the meaning.
  * The Service public de Wallonie writes three `gml:name` elements inside each
  * `ad:ThoroughfareName`, ahead of the `ad:name` that holds the street.
  *
- * A reader that dropped the prefix and matched on `name` alone read the first of those three
- * and found no street on any of Wallonia's 58,591 thoroughfare features.
+ * A reader that dropped the prefix and matched only on `name` read the first of those three,
+ * so it found no street on any of Wallonia's 58,591 thoroughfare features.
  */
 export function inspireNameIs(name, wanted) {
     return name.toLowerCase() === wanted.toLowerCase();
 }
 /**
- * The first child of `element` named `name`, ignoring case.
+ * The first child of `element` whose name matches `name`, ignoring case.
  *
- * `name` is written with the prefix the INSPIRE guideline uses, which is the
- * prefix eight of the nine publishers write.
- * The case-insensitive sibling of `childElement` from `@mailwoman/core/html/elements`,
- * which compares the name exactly as a general markup reader must.
+ * Write `name` with the prefix the INSPIRE guideline uses.
+ * Eight of the nine publishers use it.
+ *
+ * The case-insensitive sibling of `childElement` from `@mailwoman/core/html/elements`.
+ * That
+ * function compares the name exactly, as a general markup reader must.
  */
 export function inspireChild(element, name) {
-    return element.children.find((child) => inspireNameIs(child.name, name));
+    return element.children.find((child) => inspireNameIs(child.name, name)) ?? null;
 }
 /**
- * Every child of `element` named `name`, in document order, ignoring case.
+ * Every child of `element` whose name matches `name`, in document order, ignoring case.
  *
  * The case-insensitive sibling of `childElements` from `@mailwoman/core/html/elements`,
- * for the same reason {@linkcode inspireChild} is.
+ * for the same reason {@linkcode inspireChild} exists.
  */
 export function inspireChildren(element, name) {
     return element.children.filter((child) => inspireNameIs(child.name, name));
@@ -87,13 +88,14 @@ export function inspireElementAt(element, ...path) {
     let current = element;
     for (const step of path) {
         if (!current)
-            return undefined;
+            return null;
         current = inspireChild(current, step);
     }
     return current;
 }
 /**
- * The final segment of an INSPIRE codelist URI, which is the value's name.
+ * The final segment of an INSPIRE codelist URI.
+ * That segment is the value's name.
  *
  * `http://inspire.ec.europa.eu/codelist/LocatorDesignatorTypeValue/buildingIdentifier`
  * reads `buildingIdentifier`.
@@ -102,18 +104,19 @@ export function inspireElementAt(element, ...path) {
  */
 export function codelistValue(uri) {
     if (!uri)
-        return undefined;
+        return null;
     const withoutFragment = uri.split("#")[0];
     const segment = withoutFragment.split("/").pop();
-    return segment || undefined;
+    return segment || null;
 }
 /**
  * Whether a publisher marked this element void.
  *
  * INSPIRE writes `xsi:nil="true"` and usually a `nilReason`.
  * Brussels writes the nil marker and no reason on all 232,003 of its void `ad:validFrom`
- * elements, and Czechia writes four `gn:pronunciation` elements nil with no reason,
- * so a reader keyed on `nilReason` alone mistakes a void value for a populated one.
+ * elements, and Czechia writes four `gn:pronunciation` elements nil with no reason.
+ *
+ * A reader that keys only on `nilReason` mistakes a void value for a populated one.
  *
  * An absent element answers false, so a caller distinguishes a void value from a missing one.
  */
@@ -123,30 +126,33 @@ export function isVoid(element) {
 /**
  * The reason a publisher gave for a void element, as a codelist value such as `Unpopulated`.
  *
- * Returns undefined when the element is void and states no reason, which the
- * schema permits and which Brussels does throughout.
- * A caller that needs to separate a void carrying a reason from a void carrying
- * none reads this together with {@linkcode isVoid}.
+ * Returns null when the element is void and states no reason.
+ * The schema permits that form, and Brussels uses it throughout.
+ *
+ * A caller that needs to separate a void with a reason from a void with none
+ * reads this together with {@linkcode isVoid}.
  */
 export function voidReason(element) {
     if (!isVoid(element))
-        return undefined;
+        return null;
     return codelistValue(element?.attributes.nilReason);
 }
 /**
  * Every locator designator on an address, keyed by its INSPIRE type name.
  *
- * One `ad:AddressLocator` carries a designator per part of the number, each in its
- * own `ad:LocatorDesignator` beside an `ad:type` naming what it is.
+ * One `ad:AddressLocator` holds a designator per part of the number, each in its own
+ * `ad:LocatorDesignator` beside an `ad:type` that states what it is.
  * Czechia writes two, `č.ev.` typed `buildingIdentifierPrefix` and `502` typed `buildingIdentifier`.
  *
  * The Netherlands writes four, including an empty `LocatorDesignatorTypeValue/addressNumberExtension`
  * and the postcode as `LocatorDesignatorTypeValue/postalDeliveryIdentifier`.
  *
  * A type may repeat, so each key holds a list in document order.
- * A designator the publisher wrote empty contributes an empty string, which is a value the publisher
- * stated rather than one it omitted: the Netherlands writes `<ad:designator/>` 198,118 times
- * over 108,708 features to mean "no extension", and that is a different condition from void.
+ * A designator the publisher wrote empty contributes an empty string.
+ *
+ * That string is a value the publisher stated rather than one it omitted.
+ * The Netherlands writes `<ad:designator/>` 198,118 times over 108,708 features to
+ * mean "no extension", and that condition differs from void.
  *
  * A designator whose `ad:type` is absent or void is skipped, because its value cannot be placed.
  */
@@ -196,7 +202,7 @@ export function designatorsByType(address) {
  * value has to be reported rather than turned into an absence.
  *
  * A caller reads this when the difference changes what it does.
- * An adapter that refuses a row carrying no house number should report a void `buildingIdentifier` as
+ * An adapter that refuses a row with no house number should report a void `buildingIdentifier` as
  * a value it could not read, and an absent one as an address the publisher states has no number.
  */
 export function voidDesignatorTypes(address) {
@@ -212,9 +218,10 @@ export function voidDesignatorTypes(address) {
         if (!value || !isVoid(value))
             continue;
         const type = inspireChild(locatorDesignator, "ad:type");
-        const name = type && !isVoid(type) ? (codelistValue(type.attributes["xlink:href"]) ?? type.text) : undefined;
-        // A void value whose own type is void or absent cannot be placed, so it is reported under
-        // the empty name rather than dropped, which keeps the address's unreadable parts countable.
+        const name = type && !isVoid(type) ? (codelistValue(type.attributes["xlink:href"]) ?? type.text) : null;
+        // A void value whose own type is void or absent cannot be placed,
+        // so it is reported under the empty name.
+        // That keeps the address's unreadable parts countable.
         voided.add(name || "");
     }
     return voided;
@@ -227,7 +234,7 @@ export function designator(byType, ...types) {
                 return trimmed;
         }
     }
-    return undefined;
+    return null;
 }
 /**
  * Every `ad:component` reference on an address, as written.
@@ -235,8 +242,10 @@ export function designator(byType, ...types) {
  * The href is returned verbatim, and {@linkcode componentJoinKey} turns it into a join key.
  * A component whose href is absent or empty is skipped.
  *
- * Brussels writes `<ad:component xlink:href=""/>` on 9 addresses, and those 9 therefore
- * carry no postal zone, which a caller must report rather than read as a resolved component.
+ * Brussels writes `<ad:component xlink:href=""/>` on 9 addresses.
+ * Those 9 hold no postal zone.
+ *
+ * A caller must report that rather than read a resolved component.
  */
 export function componentHrefs(address) {
     return componentLinks(address).map((link) => link.href);
@@ -252,7 +261,7 @@ export function componentHrefs(address) {
  * and an administrative-unit reference addresses a CartoCiudad stored query.
  *
  * The title is the only statement of the street name, the postcode and the place names
- * that its own file carries, so its adapter reads titles and resolves no reference.
+ * in its own file, so its adapter reads titles and resolves no reference.
  *
  * A component whose href is absent or empty is skipped, as in {@linkcode componentHrefs}.
  */
@@ -263,15 +272,15 @@ export function componentLinks(address) {
         if (!href)
             continue;
         const title = component.attributes["xlink:title"]?.trim();
-        links.push(title ? { href, title } : { href });
+        links.push({ href, title: title || null });
     }
     return links;
 }
 /**
- * The query parameters a WFS stored-query reference carries its feature id in.
+ * The query parameters that hold a WFS stored-query reference's feature id.
  *
- * Each publisher picked a spelling, and the match below ignores case, so Czechia's `Id`
- * and Slovakia's `id` both resolve without naming each casing separately.
+ * Each publisher picked a spelling, and the match below ignores case,
+ * so Czechia's `Id` and Slovakia's `id` both resolve.
  * A reader that knew only `id` returned Czechia's whole URL as the key, and no `gml:id`
  * equals a URL, so all 5,460 of one municipality's references read as unjoinable.
  */
@@ -289,29 +298,31 @@ const REFERENCE_ID_PARAMETERS = new Set(["id", "featureid", "resourceid"]);
  * | Slovakia | `…ad/ows?…&id=AdminUnitName.15345` | `AdminUnitName.15345` |
  * | Flanders | `https://data.vlaanderen.be/id/straatnaam/6301` | the URI itself |
  *
- * A URI with no id parameter is its own key, which is what Flanders publishes on both sides of the join.
- * Its fragment is dropped, because a reference may carry one where the identifier does not:
+ * A URI with no id parameter is its own key.
+ * Flanders publishes that form on both sides of the join.
+ *
+ * Its fragment is dropped, because a reference may hold one where the identifier does not:
  * `http://vocab.belgif.be/auth/refnis1995/1000#id` addresses the same term as that URI without it.
  *
  * Whether a key joins is not a property of its spelling, so this reads a key
  * and the caller decides joinability against the features the publisher actually served.
- * Deciding it here from the URL's shape once reported 15 of Flanders' 20 references as
- * belonging to another register when every one of them addressed a feature of the same service.
+ * A check based on the URL's shape once reported 15 of Flanders' 20 references as belonging
+ * to another register, when every one of them addressed a feature of the same service.
  *
- * @returns The key, or undefined when the href is neither a fragment nor a URL.
+ * @returns The key, or null when the href is neither a fragment nor a URL.
  */
 export function componentJoinKey(href) {
     const trimmed = href.trim();
     if (!trimmed)
-        return undefined;
+        return null;
     if (trimmed.startsWith("#"))
-        return trimmed.slice(1) || undefined;
+        return trimmed.slice(1) || null;
     let url;
     try {
         url = new URL(trimmed);
     }
     catch {
-        return undefined;
+        return null;
     }
     for (const [parameter, value] of url.searchParams) {
         if (!REFERENCE_ID_PARAMETERS.has(parameter.toLowerCase()))
@@ -324,7 +335,7 @@ export function componentJoinKey(href) {
     return url.toString();
 }
 /**
- * The spelling a `gn:GeographicalName` carries, reached from a feature that holds one.
+ * The spelling a `gn:GeographicalName` holds, reached from a feature that has one.
  *
  * Every name-bearing INSPIRE feature nests the text at
  * `…/gn:GeographicalName/gn:spelling/gn:SpellingOfName/gn:text`, under a per-feature
@@ -332,14 +343,14 @@ export function componentJoinKey(href) {
  * while an `ad:AdminUnitName` and an `ad:AddressAreaName` add only `ad:name`.
  * The caller gives the prefix.
  *
- * @returns The text, or undefined when any step is absent or the name is void.
+ * @returns The text, or null when any step is absent or the name is void.
  */
 export function geographicalNameText(feature, ...prefix) {
     const name = inspireElementAt(feature, ...prefix, "gn:GeographicalName", "gn:spelling", "gn:SpellingOfName", "gn:text");
     if (!name || isVoid(name))
-        return undefined;
+        return null;
     const text = name.text.trim();
-    return text || undefined;
+    return text || null;
 }
 /**
  * The street name an `ad:ThoroughfareName` feature states.
@@ -363,9 +374,9 @@ export function placeName(feature) {
 export function postalDescriptorCode(feature) {
     const code = inspireChild(feature, "ad:postCode");
     if (!code || isVoid(code))
-        return undefined;
+        return null;
     const text = code.text.trim();
-    return text || undefined;
+    return text || null;
 }
 /**
  * The administrative level an `ad:AdminUnitName` states, as a codelist value such as `4thOrder`.
@@ -378,7 +389,7 @@ export function postalDescriptorCode(feature) {
 export function adminUnitLevel(feature) {
     const level = inspireChild(feature, "ad:level");
     if (!level || isVoid(level))
-        return undefined;
-    return codelistValue(level.attributes["xlink:href"]) ?? (level.text.trim() || undefined);
+        return null;
+    return codelistValue(level.attributes["xlink:href"]) ?? (level.text.trim() || null);
 }
 //# sourceMappingURL=address.js.map

package/out/inspire/address.js.map

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