@mailwoman/corpus 9.4.0 → 10.1.0

package/out/inspire/address.d.ts

@@ -0,0 +1,251 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Reads the parts of an INSPIRE Addresses feature that every publisher spells the same way.
+ *
+ * INSPIRE harmonizes the schema and leaves the rest to the publisher. Seven publishers this
+ * repository reads all write `ad:Address` with the same element paths, and they disagree on four
+ * things that each decide a value:
+ *
+ * 1. The wrapper. Czechia writes `base:SpatialDataSet` with `base:member`. The Netherlands,
+ *    Wallonia and Brussels write `gml:FeatureCollection` with `gml:featureMember`.
+ * 2. The reference form. Czechia's `ad:component` href is an absolute WFS stored-query URL
+ *    whose `Id=` parameter is the key. The Netherlands, Wallonia and Brussels write a local `#`
+ *    fragment. Flanders writes an absolute data URI that a caller rewrites into a `resourceId`.
+ * 3. Where the postcode lives. Czechia and Wallonia reference an `ad:PostalDescriptor`; the
+ *    Netherlands puts it inline as a `LocatorDesignatorTypeValue/postalDeliveryIdentifier` locator and publishes no
+ *    `ad:PostalDescriptor` at all.
+ * 4. The locator vocabulary. Czechia types its number `buildingIdentifier`, the Netherlands
+ *    `addressNumber`, Wallonia `LocatorDesignatorTypeValue/addressIdentifierGeneral`, Brussels
+ *    `buildingIdentifier`.
+ * 5. The prefix's case. Seven publishers write `ad:` and `gn:`. The Dirección General del Catastro
+ *    and the Gobierno de Navarra bind the same namespaces to `AD:` and `GN:`. The Catastro also
+ *    states a designator type and an administrative level as element text, `1` and `4`, where
+ *    everyone else writes a codelist URI. The readers below therefore match an element name
+ *    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.
+ *
+ * The reference form is the exception, because its shapes are enumerable and measured:
+ * {@linkcode componentJoinKey} reads all four.
+ */
+import type { MarkupElement } from "@mailwoman/core/html/elements";
+/**
+ * Whether an element's name is `wanted`, ignoring the case of both.
+ *
+ * The prefix a document binds a namespace to is the document's own choice.
+ * Seven publishers write `ad:Address` and `gn:text`.
+ *
+ * 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.
+ *
+ * That reads as an address carrying none rather than as a prefix this repository had not met.
+ *
+ * The prefix is still compared, because it carries the namespace and the namespace carries 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.
+ */
+export declare function inspireNameIs(name: string, wanted: string): boolean;
+/**
+ * The first child of `element` named `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.
+ */
+export declare function inspireChild(element: MarkupElement, name: string): MarkupElement | undefined;
+/**
+ * Every child of `element` named `name`, in document order, ignoring case.
+ *
+ * The case-insensitive sibling of `childElements` from `@mailwoman/core/html/elements`,
+ * for the same reason {@linkcode inspireChild} is.
+ */
+export declare function inspireChildren(element: MarkupElement, name: string): readonly MarkupElement[];
+/**
+ * The element reached by walking `path` from `element`, taking the first match at each step.
+ *
+ * The case-insensitive sibling of `elementAtPath` from `@mailwoman/core/html/elements`.
+ * 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;
+/**
+ * The final segment of an INSPIRE codelist URI, which 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;
+/**
+ * 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.
+ *
+ * An absent element answers false, so a caller distinguishes a void value from a missing one.
+ */
+export declare function isVoid(element: MarkupElement | undefined): 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}.
+ */
+export declare function voidReason(element: MarkupElement | undefined): string | undefined;
+/**
+ * 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.
+ * 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 whose `ad:type` is absent or void is skipped, because its value cannot be placed.
+ */
+export declare function designatorsByType(address: MarkupElement): ReadonlyMap<string, readonly string[]>;
+/**
+ * The first non-empty designator among `types`, in the order given.
+ *
+ * A caller states its publisher's vocabulary and its own precedence:
+ * Czechia asks for `buildingIdentifier`, the Netherlands for `addressNumber`,
+ * Wallonia for `LocatorDesignatorTypeValue/addressIdentifierGeneral`.
+ */
+/**
+ * The locator-designator types this address marks void, by their INSPIRE type name.
+ *
+ * {@linkcode designatorsByType} leaves a void designator out, so on its own it cannot
+ * separate a value the publisher marked unknown from one the publisher never wrote.
+ * The repository's partial-read rule needs that separation: an unreadable requested
+ * 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
+ * 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;
+/**
+ * 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.
+ */
+export declare function componentHrefs(address: MarkupElement): readonly string[];
+/**
+ * One `ad:component` reference, with the title the publisher wrote beside it.
+ */
+export interface ComponentLink {
+    /**
+     * The `xlink:href`, trimmed and otherwise as written.
+     */
+    readonly href: string;
+    /**
+     * The `xlink:title`, or undefined where the reference carries none.
+     */
+    readonly title?: string;
+}
+/**
+ * Every `ad:component` reference on an address, with its title.
+ *
+ * Most publishers repeat the referenced feature's own value in `xlink:title`, and their adapters
+ * read the resolved feature instead, because a title is a copy and the feature is the record.
+ *
+ * The Gobierno de Navarra is the case that needs the title.
+ * Its references leave the file: a thoroughfare reference is the bare string `ThoroughfareName`
+ * 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.
+ *
+ * A component whose href is absent or empty is skipped, as in {@linkcode componentHrefs}.
+ */
+export declare function componentLinks(address: MarkupElement): readonly ComponentLink[];
+/**
+ * The key a component reference joins on.
+ *
+ * Four shapes appear across the publishers measured, and they differ in
+ * where the key sits rather than in whether one exists:
+ *
+ * | publisher | href | key |
+ * | --- | --- | --- |
+ * | Netherlands, Wallonia, Brussels | `#nl-imbag-ad-thoroughfarename.0003300000117203` | the fragment |
+ * | Czechia | `…inspire-ad-wfs.asp?…&Id=TF.48674` | `TF.48674` |
+ * | 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:
+ * `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.
+ *
+ * @returns The key, or undefined when the href is neither a fragment nor a URL.
+ */
+export declare function componentJoinKey(href: string): string | undefined;
+/**
+ * The spelling a `gn:GeographicalName` carries, reached from a feature that holds one.
+ *
+ * Every name-bearing INSPIRE feature nests the text at
+ * `…/gn:GeographicalName/gn:spelling/gn:SpellingOfName/gn:text`, under a per-feature
+ * prefix: an `ad:ThoroughfareName` adds `ad:name/ad:ThoroughfareNameValue/ad:name`,
+ * 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.
+ */
+export declare function geographicalNameText(feature: MarkupElement, ...prefix: readonly string[]): string | undefined;
+/**
+ * The street name an `ad:ThoroughfareName` feature states.
+ */
+export declare function thoroughfareName(feature: MarkupElement): string | undefined;
+/**
+ * The place name an `ad:AdminUnitName` or `ad:AddressAreaName` feature states.
+ */
+export declare function placeName(feature: MarkupElement): string | undefined;
+/**
+ * The postcode an `ad:PostalDescriptor` feature states.
+ *
+ * The Spanish cadastre writes this element as an integer, so `02250` arrives as `2250`.
+ * 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;
+/**
+ * The administrative level an `ad:AdminUnitName` states, as a codelist value such as `4thOrder`.
+ *
+ * A publisher references several admin units per address: Czechia references the
+ * country at `1stOrder` and the municipality at `4thOrder`, and the Netherlands
+ * 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;
+//# sourceMappingURL=address.d.ts.map

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

@@ -0,0 +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"}

package/out/inspire/address.js

@@ -0,0 +1,384 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Reads the parts of an INSPIRE Addresses feature that every publisher spells the same way.
+ *
+ * INSPIRE harmonizes the schema and leaves the rest to the publisher. Seven publishers this
+ * repository reads all write `ad:Address` with the same element paths, and they disagree on four
+ * things that each decide a value:
+ *
+ * 1. The wrapper. Czechia writes `base:SpatialDataSet` with `base:member`. The Netherlands,
+ *    Wallonia and Brussels write `gml:FeatureCollection` with `gml:featureMember`.
+ * 2. The reference form. Czechia's `ad:component` href is an absolute WFS stored-query URL
+ *    whose `Id=` parameter is the key. The Netherlands, Wallonia and Brussels write a local `#`
+ *    fragment. Flanders writes an absolute data URI that a caller rewrites into a `resourceId`.
+ * 3. Where the postcode lives. Czechia and Wallonia reference an `ad:PostalDescriptor`; the
+ *    Netherlands puts it inline as a `LocatorDesignatorTypeValue/postalDeliveryIdentifier` locator and publishes no
+ *    `ad:PostalDescriptor` at all.
+ * 4. The locator vocabulary. Czechia types its number `buildingIdentifier`, the Netherlands
+ *    `addressNumber`, Wallonia `LocatorDesignatorTypeValue/addressIdentifierGeneral`, Brussels
+ *    `buildingIdentifier`.
+ * 5. The prefix's case. Seven publishers write `ad:` and `gn:`. The Dirección General del Catastro
+ *    and the Gobierno de Navarra bind the same namespaces to `AD:` and `GN:`. The Catastro also
+ *    states a designator type and an administrative level as element text, `1` and `4`, where
+ *    everyone else writes a codelist URI. The readers below therefore match an element name
+ *    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.
+ *
+ * The reference form is the exception, because its shapes are enumerable and measured:
+ * {@linkcode componentJoinKey} reads all four.
+ */
+/**
+ * Whether an element's name is `wanted`, ignoring the case of both.
+ *
+ * The prefix a document binds a namespace to is the document's own choice.
+ * Seven publishers write `ad:Address` and `gn:text`.
+ *
+ * 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.
+ *
+ * That reads as an address carrying none rather than as a prefix this repository had not met.
+ *
+ * The prefix is still compared, because it carries the namespace and the namespace carries 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.
+ */
+export function inspireNameIs(name, wanted) {
+    return name.toLowerCase() === wanted.toLowerCase();
+}
+/**
+ * The first child of `element` named `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.
+ */
+export function inspireChild(element, name) {
+    return element.children.find((child) => inspireNameIs(child.name, name));
+}
+/**
+ * Every child of `element` named `name`, in document order, ignoring case.
+ *
+ * The case-insensitive sibling of `childElements` from `@mailwoman/core/html/elements`,
+ * for the same reason {@linkcode inspireChild} is.
+ */
+export function inspireChildren(element, name) {
+    return element.children.filter((child) => inspireNameIs(child.name, name));
+}
+/**
+ * The element reached by walking `path` from `element`, taking the first match at each step.
+ *
+ * The case-insensitive sibling of `elementAtPath` from `@mailwoman/core/html/elements`.
+ * 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 function inspireElementAt(element, ...path) {
+    let current = element;
+    for (const step of path) {
+        if (!current)
+            return undefined;
+        current = inspireChild(current, step);
+    }
+    return current;
+}
+/**
+ * The final segment of an INSPIRE codelist URI, which 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 function codelistValue(uri) {
+    if (!uri)
+        return undefined;
+    const withoutFragment = uri.split("#")[0];
+    const segment = withoutFragment.split("/").pop();
+    return segment || undefined;
+}
+/**
+ * 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.
+ *
+ * An absent element answers false, so a caller distinguishes a void value from a missing one.
+ */
+export function isVoid(element) {
+    return element?.attributes["xsi:nil"] === "true";
+}
+/**
+ * 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}.
+ */
+export function voidReason(element) {
+    if (!isVoid(element))
+        return undefined;
+    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.
+ * 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 whose `ad:type` is absent or void is skipped, because its value cannot be placed.
+ */
+export function designatorsByType(address) {
+    const byType = new Map();
+    const locator = inspireElementAt(address, "ad:locator", "ad:AddressLocator");
+    if (!locator)
+        return byType;
+    for (const wrapper of inspireChildren(locator, "ad:designator")) {
+        const locatorDesignator = inspireChild(wrapper, "ad:LocatorDesignator");
+        if (!locatorDesignator)
+            continue;
+        const type = inspireChild(locatorDesignator, "ad:type");
+        if (!type || isVoid(type))
+            continue;
+        const name = codelistValue(type.attributes["xlink:href"]) ?? type.text;
+        if (!name)
+            continue;
+        const value = inspireChild(locatorDesignator, "ad:designator");
+        // A void designator is reported by `voidDesignatorTypes` rather than here, because a
+        // value the publisher marked unknown is not a value and must not reach a component.
+        if (!value || isVoid(value))
+            continue;
+        const existing = byType.get(name);
+        if (existing) {
+            existing.push(value.text);
+        }
+        else {
+            byType.set(name, [value.text]);
+        }
+    }
+    return byType;
+}
+/**
+ * The first non-empty designator among `types`, in the order given.
+ *
+ * A caller states its publisher's vocabulary and its own precedence:
+ * Czechia asks for `buildingIdentifier`, the Netherlands for `addressNumber`,
+ * Wallonia for `LocatorDesignatorTypeValue/addressIdentifierGeneral`.
+ */
+/**
+ * The locator-designator types this address marks void, by their INSPIRE type name.
+ *
+ * {@linkcode designatorsByType} leaves a void designator out, so on its own it cannot
+ * separate a value the publisher marked unknown from one the publisher never wrote.
+ * The repository's partial-read rule needs that separation: an unreadable requested
+ * 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
+ * a value it could not read, and an absent one as an address the publisher states has no number.
+ */
+export function voidDesignatorTypes(address) {
+    const voided = new Set();
+    const locator = inspireElementAt(address, "ad:locator", "ad:AddressLocator");
+    if (!locator)
+        return voided;
+    for (const wrapper of inspireChildren(locator, "ad:designator")) {
+        const locatorDesignator = inspireChild(wrapper, "ad:LocatorDesignator");
+        if (!locatorDesignator)
+            continue;
+        const value = inspireChild(locatorDesignator, "ad:designator");
+        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.
+        voided.add(name || "");
+    }
+    return voided;
+}
+export function designator(byType, ...types) {
+    for (const type of types) {
+        for (const value of byType.get(type) ?? []) {
+            const trimmed = value.trim();
+            if (trimmed)
+                return trimmed;
+        }
+    }
+    return undefined;
+}
+/**
+ * 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.
+ */
+export function componentHrefs(address) {
+    return componentLinks(address).map((link) => link.href);
+}
+/**
+ * Every `ad:component` reference on an address, with its title.
+ *
+ * Most publishers repeat the referenced feature's own value in `xlink:title`, and their adapters
+ * read the resolved feature instead, because a title is a copy and the feature is the record.
+ *
+ * The Gobierno de Navarra is the case that needs the title.
+ * Its references leave the file: a thoroughfare reference is the bare string `ThoroughfareName`
+ * 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.
+ *
+ * A component whose href is absent or empty is skipped, as in {@linkcode componentHrefs}.
+ */
+export function componentLinks(address) {
+    const links = [];
+    for (const component of inspireChildren(address, "ad:component")) {
+        const href = component.attributes["xlink:href"]?.trim();
+        if (!href)
+            continue;
+        const title = component.attributes["xlink:title"]?.trim();
+        links.push(title ? { href, title } : { href });
+    }
+    return links;
+}
+/**
+ * The query parameters a WFS stored-query reference carries its feature id in.
+ *
+ * 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.
+ * 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.
+ */
+const REFERENCE_ID_PARAMETERS = new Set(["id", "featureid", "resourceid"]);
+/**
+ * The key a component reference joins on.
+ *
+ * Four shapes appear across the publishers measured, and they differ in
+ * where the key sits rather than in whether one exists:
+ *
+ * | publisher | href | key |
+ * | --- | --- | --- |
+ * | Netherlands, Wallonia, Brussels | `#nl-imbag-ad-thoroughfarename.0003300000117203` | the fragment |
+ * | Czechia | `…inspire-ad-wfs.asp?…&Id=TF.48674` | `TF.48674` |
+ * | 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:
+ * `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.
+ *
+ * @returns The key, or undefined when the href is neither a fragment nor a URL.
+ */
+export function componentJoinKey(href) {
+    const trimmed = href.trim();
+    if (!trimmed)
+        return undefined;
+    if (trimmed.startsWith("#"))
+        return trimmed.slice(1) || undefined;
+    let url;
+    try {
+        url = new URL(trimmed);
+    }
+    catch {
+        return undefined;
+    }
+    for (const [parameter, value] of url.searchParams) {
+        if (!REFERENCE_ID_PARAMETERS.has(parameter.toLowerCase()))
+            continue;
+        const id = value.trim();
+        if (id)
+            return id;
+    }
+    url.hash = "";
+    return url.toString();
+}
+/**
+ * The spelling a `gn:GeographicalName` carries, reached from a feature that holds one.
+ *
+ * Every name-bearing INSPIRE feature nests the text at
+ * `…/gn:GeographicalName/gn:spelling/gn:SpellingOfName/gn:text`, under a per-feature
+ * prefix: an `ad:ThoroughfareName` adds `ad:name/ad:ThoroughfareNameValue/ad:name`,
+ * 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.
+ */
+export function geographicalNameText(feature, ...prefix) {
+    const name = inspireElementAt(feature, ...prefix, "gn:GeographicalName", "gn:spelling", "gn:SpellingOfName", "gn:text");
+    if (!name || isVoid(name))
+        return undefined;
+    const text = name.text.trim();
+    return text || undefined;
+}
+/**
+ * The street name an `ad:ThoroughfareName` feature states.
+ */
+export function thoroughfareName(feature) {
+    return geographicalNameText(feature, "ad:name", "ad:ThoroughfareNameValue", "ad:name");
+}
+/**
+ * The place name an `ad:AdminUnitName` or `ad:AddressAreaName` feature states.
+ */
+export function placeName(feature) {
+    return geographicalNameText(feature, "ad:name");
+}
+/**
+ * The postcode an `ad:PostalDescriptor` feature states.
+ *
+ * The Spanish cadastre writes this element as an integer, so `02250` arrives as `2250`.
+ * Left-padding belongs to the caller that knows the jurisdiction's width,
+ * because this reader returns what the publisher wrote.
+ */
+export function postalDescriptorCode(feature) {
+    const code = inspireChild(feature, "ad:postCode");
+    if (!code || isVoid(code))
+        return undefined;
+    const text = code.text.trim();
+    return text || undefined;
+}
+/**
+ * The administrative level an `ad:AdminUnitName` states, as a codelist value such as `4thOrder`.
+ *
+ * A publisher references several admin units per address: Czechia references the
+ * country at `1stOrder` and the municipality at `4thOrder`, and the Netherlands
+ * 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 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);
+}
+//# sourceMappingURL=address.js.map

package/out/inspire/address.js.map

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