@mailwoman/corpus 10.0.0 → 10.1.0

package/out/cz/tools/fetch/cuzk.js

@@ -0,0 +1,446 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ * Harvest ČÚZK's INSPIRE Addresses archives into the directory `#cz/adapters/cuzk/adapter` reads.
+ *
+ * ČÚZK serves the Addresses (AD) theme as a two-level ATOM service rather than as a WFS. The
+ * service document at `https://atom.cuzk.gov.cz/AD/AD.xml` holds one entry per municipality, each
+ * pointing at a dataset feed, and each dataset feed offers that municipality's addresses as a
+ * zipped GML in two projections. Measured 2026-10-02: the service document answered HTTP 200 with
+ * 8,373,817 bytes holding 6,258 entries, sha256
+ * `9b1d51a721ab601fa74307cce5ce20f74d12dd29512f87be29cd1072f0a2d83b`.
+ *
+ * The acquisition belongs under a `tools/` root. `@mailwoman/corpus` is one of the
+ * `TOOLING_PACKAGES` in `dependency-cruiser.config.mjs`, which keep their tooling under `lib/`, so
+ * this module sits beside `#fr/tools/fetch/ban` rather than in an `sdk/` root the workspace does
+ * not declare.
+ *
+ * Every one of the service document's `rights` elements reads `žádné podmínky neplatí`, INSPIRE's
+ * controlled value for no conditions applying to access and use, and the address-source register
+ * elects it on that basis. `#cz/adapters/cuzk/adapter` records the same value on every row.
+ *
+ * Four properties of this service decide the harvest's shape, and each was measured rather than
+ * assumed:
+ *
+ * 1. **The service document carries each municipality's file modification time.** An entry's
+ *    `<updated>` equals the archive's `Last-Modified` to the second, checked on six municipalities
+ *    on 2026-10-02 — `584061` reads `2026-06-04T02:19:33+02:00` against
+ *    `Thu, 04 Jun 2026 00:19:33 GMT`, and `531529`, `551481`, `545031`, `587044` and `584282`
+ *    agree the same way. So one 8.4 MB request states the freshness of all 6,258 archives, and a
+ *    re-run requests only the municipalities whose stated time moved. The alternative — a
+ *    conditional request per municipality — costs 6,258 round trips to learn the same thing.
+ * 2. **The download URL is composed from a base the feed itself declares.** The service document's
+ *    own `rel="next"` links are `https://services.cuzk.gov.cz/gml/inspire/ad/epsg-4258` and
+ *    `…/epsg-5514`, and a dataset feed's `alternate` link for the same municipality is that base
+ *    plus `/<code>.zip`. Composing from the declared base rather than reading 6,258 dataset feeds
+ *    halves the harvest's requests. {@linkcode HarvestCzCuzkOptions.resolveThroughDatasetFeed}
+ *    reads the publisher's own href instead, for a run that will not compose a URL.
+ * 3. **The `type` attribute describes the data rather than the file.** A dataset feed's link
+ *    advertises `application/gml+xml` while the host serves `application/zip`, so the GML is inside
+ *    the archive and the advertised type cannot decide what to write. The archive is stored as it
+ *    arrives: the adapter opens it with `adm-zip`, because at least one archive's central directory
+ *    records its member's size as the ZIP64 sentinel `0xFFFFFFFF`.
+ * 4. **A dataset feed's `length` is accurate here, and is still not used.** `584061.zip` claims
+ *    24,846 bytes and the host's `content-length` says 24,846. Denmark's feed understates its file
+ *    by 23 times, so every byte count this module records is counted off the delivered body.
+ *
+ * The archives are small — a systematic sample of 50 of the 6,258 municipalities on 2026-10-02 ran
+ * from 5,236 to 1,642,586 bytes with a median of 16,591 — so the harvest is bound by round trips
+ * rather than by bandwidth, and it is dispatched serially through one `APIClient`. ČÚZK publishes
+ * no rate limit. {@linkcode CZ_CUZK_REQUEST_INTERVAL_MS} holds the harvest to four requests per
+ * second against one government host, which is under half of the ten per second the same 50
+ * requests measured, and a caller that has asked ČÚZK for more raises it.
+ */
+/* oxlint-disable sister-software/prefer-region-over-marks -- these markers label steps inside one
+   procedure rather than sections of declarations. A region there folds no element a reader wants folded. */
+import { APIClient, assertNoOGCServiceException } from "@mailwoman/core/api";
+import { ByteFormatter } from "@mailwoman/core/fs/formatters";
+import { tryStat } from "@mailwoman/core/fs/readers";
+import { makeDirectories, writeLocalFile } from "@mailwoman/core/fs/writers";
+import { sha256File, sha256Hex } from "@mailwoman/core/hash";
+import { stringifyJSON } from "@mailwoman/core/json";
+import { PathBuilder } from "path-ts";
+import { CZ_CUZK_ADAPTER_ID, CZ_CUZK_LICENSE } from "#cz/adapters/cuzk/adapter";
+import { feedChunks, linkWithRel, readAtomFeed } from "#tools/fetch/atom";
+import { loadCollectionFiles, writeManifest } from "#tools/fetch/download";
+/**
+ * The ATOM service document listing one dataset feed per municipality.
+ */
+export const CZ_CUZK_SERVICE_FEED_URL = "https://atom.cuzk.gov.cz/AD/AD.xml";
+/**
+ * The directory the harvest writes under, which is the adapter's `inputPath`.
+ */
+const SLUG = CZ_CUZK_ADAPTER_ID;
+/**
+ * The attribution the model card must carry for this source.
+ */
+export const CZ_CUZK_ATTRIBUTION = "Český úřad zeměměřický a katastrální (ČÚZK), INSPIRE téma Adresy";
+/**
+ * The two projections the service offers, keyed by the path segment the feed's own base URL ends in.
+ *
+ * The adapter reads either.
+ * `epsg-4258` is ETRS89, in degrees, and is the projection the adapter's
+ * component joins were verified against.
+ */
+export const CZ_CUZK_PROJECTIONS = {
+    "epsg-4258": "ETRS89",
+    "epsg-5514": "S-JTSK",
+};
+/**
+ * The minimum spacing between two requests to `services.cuzk.gov.cz`, in milliseconds.
+ *
+ * Four requests per second.
+ * A systematic sample of 50 archives on 2026-10-02 answered a serial `HEAD` in 100 ms each,
+ * so this leaves the host more than half the rate it demonstrated.
+ */
+export const CZ_CUZK_REQUEST_INTERVAL_MS = 250;
+/**
+ * The first two bytes of every zip archive, `PK`.
+ *
+ * The check is on the signature rather than on a size, because an error page
+ * and a small municipality are told apart by what the body is rather than by
+ * how long it is: the smallest archive in the 2026-10-02 sample is 5,236 bytes,
+ * and a size floor between the two would be a number fitted to that sample.
+ */
+const ZIP_SIGNATURE = "PK";
+/**
+ * How many archives are written between two manifest writes.
+ *
+ * The manifest is what makes an interrupted harvest resumable, and writing it
+ * after every archive would rewrite a 6,258-entry document 6,258 times.
+ * At this interval an interruption re-fetches at most this many archives that are already on disk.
+ */
+const MANIFEST_INTERVAL = 25;
+/**
+ * The trailing numeric component of an INSPIRE dataset identifier code,
+ * `CZ-00025712-CUZK_AD_584061` → `584061`.
+ */
+const IDENTIFIER_CODE_SUFFIX = /_(\d+)$/u;
+/**
+ * The municipality code a title states in brackets, `… obec: Unkovice [584061]` → `584061`.
+ */
+const TITLE_CODE = /\[(\d+)\]\s*$/u;
+/**
+ * The municipality code of one entry, read from its INSPIRE identifier and checked against its title.
+ *
+ * Both spellings are read because the code is the file name the archive is composed
+ * and stored under, so a disagreement between the publisher's two statements of it
+ * would silently store one municipality's addresses under another's name.
+ *
+ * @throws When either statement is missing or the two disagree, which reads as a change
+ * in the publisher's layout rather than as a municipality without a code.
+ */
+export function municipalityCodeOf(entry) {
+    const fromIdentifier = IDENTIFIER_CODE_SUFFIX.exec(entry.identifierCode ?? "")?.[1];
+    const fromTitle = TITLE_CODE.exec(entry.title)?.[1];
+    if (!fromIdentifier) {
+        throw new Error(`${CZ_CUZK_SERVICE_FEED_URL}: the entry titled "${entry.title}" states the dataset identifier ` +
+            `${stringifyJSON(entry.identifierCode)}, which ends in no municipality code`);
+    }
+    if (!fromTitle) {
+        throw new Error(`${CZ_CUZK_SERVICE_FEED_URL}: the entry titled "${entry.title}" states no municipality code in brackets, ` +
+            `so its identifier's ${fromIdentifier} could not be checked against the title`);
+    }
+    if (fromIdentifier !== fromTitle) {
+        throw new Error(`${CZ_CUZK_SERVICE_FEED_URL}: the entry titled "${entry.title}" states municipality ${fromTitle} in its ` +
+            `title and ${fromIdentifier} in its dataset identifier, so the archive it names is ambiguous`);
+    }
+    return fromIdentifier;
+}
+/**
+ * The base URL the feed declares for one projection.
+ *
+ * Matched on the href's last path segment rather than on the link's `title`,
+ * because the segment is the EPSG code itself while the title is a Czech-language label.
+ *
+ * @throws When the feed declares no base for the requested projection, naming the ones it does
+ * declare, so a publisher that moves its files reports itself instead of composing a dead URL.
+ */
+export function projectionBaseURL(feed, projection) {
+    const bases = feed.links.filter((link) => link.rel === "next");
+    const found = bases.find((link) => link.href.replace(/\/+$/u, "").endsWith(`/${projection}`));
+    if (!found) {
+        throw new Error(`${CZ_CUZK_SERVICE_FEED_URL}: the feed declares no download base ending in /${projection}. ` +
+            `Its rel="next" links are ${bases.length ? bases.map((link) => link.href).join(", ") : "absent"}.`);
+    }
+    return found.href.replace(/\/+$/u, "");
+}
+/**
+ * The municipalities the service document lists, with the archive URL for one projection.
+ *
+ * @throws When the feed lists no entry, when two entries claim one municipality code — which
+ * would make one archive overwrite the other — or when an entry carries no dataset feed link.
+ */
+export function readCzCuzkServiceFeed(feed, projection) {
+    if (!feed.entries.length) {
+        throw new Error(`${CZ_CUZK_SERVICE_FEED_URL}: the service document holds no <entry>, so the municipalities it offers ` +
+            `could not be read`);
+    }
+    const base = projectionBaseURL(feed, projection);
+    const datasets = [];
+    const seen = new Set();
+    for (const entry of feed.entries) {
+        const code = municipalityCodeOf(entry);
+        if (seen.has(code)) {
+            throw new Error(`${CZ_CUZK_SERVICE_FEED_URL}: municipality ${code} is listed twice, so one of the two archives ` +
+                `would overwrite the other`);
+        }
+        seen.add(code);
+        // The entry's `alternate` link is its dataset feed.
+        // The `describedby` link beside it is the ISO 19139 metadata record.
+        // Reading either as the other costs a request that answers XML of the wrong kind.
+        const datasetFeed = linkWithRel(entry.links, "alternate");
+        if (!datasetFeed?.href) {
+            throw new Error(`${CZ_CUZK_SERVICE_FEED_URL}: the entry for municipality ${code} carries no rel="alternate" link, ` +
+                `so its dataset feed could not be read`);
+        }
+        datasets.push({
+            code,
+            title: entry.title,
+            updated: entry.updated,
+            datasetFeedURL: datasetFeed.href,
+            downloadURL: `${base}/${code}.zip`,
+            filename: `${code}.zip`,
+        });
+    }
+    return datasets;
+}
+/**
+ * The archive link a dataset feed states for one projection.
+ *
+ * Read only when {@linkcode HarvestCzCuzkOptions.resolveThroughDatasetFeed} is set.
+ * The feed holds one entry per projection, each with one `alternate` link, and the projection is
+ * identified by the href's own path segment for the same reason {@linkcode projectionBaseURL} uses it.
+ *
+ * @throws When the dataset feed states no link for the requested projection.
+ */
+export function datasetFeedArchiveURL(feed, projection, context) {
+    for (const entry of feed.entries) {
+        const link = linkWithRel(entry.links, "alternate");
+        if (link?.href.includes(`/${projection}/`))
+            return link.href;
+    }
+    throw new Error(`${context}: the dataset feed states no alternate link under /${projection}/, so the archive for that ` +
+        `projection could not be read`);
+}
+/**
+ * Whether the archive recorded for one municipality is still the one the feed now describes.
+ *
+ * Three conditions, and the first is what saves 6,258 requests: the service
+ * document states the same modification time it stated when the file was fetched,
+ * the file is still there, and it is still the length that was recorded for it.
+ */
+async function isCurrent(recorded, dataset, path, verifyDigests) {
+    if (!recorded || recorded.feed_updated !== dataset.updated)
+        return false;
+    const stat = await tryStat(path);
+    if (!stat || stat.size !== recorded.bytes)
+        return false;
+    // The digest check reads the whole file rather than its metadata, which is why it is opt-in.
+    if (!verifyDigests)
+        return true;
+    return (await sha256File(path)) === recorded.sha256;
+}
+/**
+ * Harvest the municipalities the service document lists into `options.outputDir`.
+ *
+ * The client is injected so the harvest is testable without the network and so a caller
+ * decides the pacing. {@linkcode fetchCzCuzk} is the registry entry point and supplies both.
+ *
+ * @returns What was fetched, what was already current, and which municipality codes failed.
+ */
+export async function harvestCzCuzk(client, options) {
+    const { report, signal } = options;
+    const projection = options.projection ?? "epsg-4258";
+    const destDir = PathBuilder.from(options.outputDir);
+    const manifestPath = destDir("MANIFEST.json");
+    await makeDirectories(destDir);
+    // MARK: Read the service document
+    //
+    // One request, and it states the modification time of every archive the service offers.
+    report?.(`=== ${SLUG}: reading ${CZ_CUZK_SERVICE_FEED_URL}`);
+    const { data: serviceXML } = await client.fetch({
+        method: "GET",
+        url: CZ_CUZK_SERVICE_FEED_URL,
+        responseType: "text",
+    });
+    // The service document shares the http 200 an exception report arrives on.
+    assertNoOGCServiceException(serviceXML, `${SLUG} service document`);
+    const feed = await readAtomFeed(feedChunks(serviceXML));
+    const listed = readCzCuzkServiceFeed(feed, projection);
+    report?.(`  ${listed.length} municipalities listed, projection ${projection} (${CZ_CUZK_PROJECTIONS[projection]})`);
+    const wanted = selectMunicipalities(listed, options);
+    report?.(`  ${wanted.selected.length} selected for this run`);
+    // MARK: Fetch what the feed describes anew
+    const previous = await loadCollectionFiles(manifestPath);
+    const files = new Map();
+    // An entry for a municipality this run does not consider is carried through,
+    // so a bounded run never drops what an earlier run recorded.
+    for (const [filename, entry] of previous) {
+        files.set(filename, entry);
+    }
+    let fetched = 0;
+    let skipped = 0;
+    const failedCodes = [...wanted.unknown];
+    for (const unknown of wanted.unknown) {
+        report?.(`  ✗ municipality ${unknown} is not listed in the service document`);
+    }
+    const writeHarvestManifest = async () => {
+        const manifest = {
+            source: SLUG,
+            source_url: CZ_CUZK_SERVICE_FEED_URL,
+            license: CZ_CUZK_LICENSE,
+            attribution: CZ_CUZK_ATTRIBUTION,
+            downloaded_at: new Date().toISOString(),
+            projection,
+            municipalities_listed: listed.length,
+            files: [...files.values()].toSorted((left, right) => left.municipality_code < right.municipality_code ? -1 : left.municipality_code > right.municipality_code ? 1 : 0),
+        };
+        await writeManifest(manifestPath, manifest);
+    };
+    for (const dataset of wanted.selected) {
+        if (signal?.aborted)
+            break;
+        const dest = destDir(dataset.filename);
+        if (await isCurrent(files.get(dataset.filename), dataset, dest, options.verifyDigests ?? false)) {
+            skipped++;
+            continue;
+        }
+        try {
+            const entry = await fetchArchive(client, dataset, {
+                projection,
+                dest,
+                resolveThroughDatasetFeed: options.resolveThroughDatasetFeed ?? false,
+            });
+            files.set(dataset.filename, entry);
+            fetched++;
+            report?.(`  ✓ ${dataset.code} ${ByteFormatter.formatIEC(entry.bytes)} sha256=${entry.sha256}`);
+        }
+        catch (error) {
+            report?.(`  ✗ ${dataset.code}: ${error instanceof Error ? error.message : String(error)}`);
+            failedCodes.push(dataset.code);
+            continue;
+        }
+        if (fetched % MANIFEST_INTERVAL === 0) {
+            await writeHarvestManifest();
+        }
+    }
+    await writeHarvestManifest();
+    report?.(`=== ${SLUG} summary`);
+    report?.(`fetched: ${fetched}`);
+    report?.(`skipped: ${skipped} (the feed states the modification time already recorded)`);
+    report?.(`failed:  ${failedCodes.length}`);
+    return { fetched, skipped, failed: failedCodes.length, failedCodes };
+}
+/**
+ * The municipalities this run considers, and the codes a caller named that the feed does not list.
+ *
+ * A code the caller asked for and the service document does not list is returned
+ * rather than dropped, because a municipality that is not published is a different
+ * condition from a selection that holds no municipality.
+ */
+function selectMunicipalities(listed, options) {
+    let selected = listed;
+    const unknown = [];
+    if (options.municipalities) {
+        const byCode = new Map(listed.map((dataset) => [dataset.code, dataset]));
+        const found = [];
+        for (const code of options.municipalities) {
+            const dataset = byCode.get(code);
+            if (dataset) {
+                found.push(dataset);
+            }
+            else {
+                unknown.push(code);
+            }
+        }
+        selected = found;
+    }
+    if (options.limit !== undefined) {
+        selected = selected.slice(0, options.limit);
+    }
+    return { selected, unknown };
+}
+/**
+ * Download one municipality's archive and answer the manifest entry for it.
+ *
+ * The archive is stored as it arrives.
+ * The adapter opens it, because ČÚZK writes the ZIP64 sentinel into at least one central
+ * directory and `adm-zip` inflates the member instead of trusting it.
+ *
+ * @throws When the body does not begin with a zip signature.
+ * An error page served under http 200 is the body that fails this check.
+ * An html page is therefore never written to disk under a `.zip` name.
+ */
+async function fetchArchive(client, dataset, options) {
+    let url = dataset.downloadURL;
+    if (options.resolveThroughDatasetFeed) {
+        const { data: datasetXML } = await client.fetch({
+            method: "GET",
+            url: dataset.datasetFeedURL,
+            responseType: "text",
+        });
+        assertNoOGCServiceException(datasetXML, `${SLUG} dataset feed ${dataset.code}`);
+        url = datasetFeedArchiveURL(await readAtomFeed(feedChunks(datasetXML)), options.projection, `${SLUG} dataset feed ${dataset.code}`);
+    }
+    const response = await client.fetch({
+        method: "GET",
+        url,
+        responseType: "arraybuffer",
+    });
+    const bytes = Buffer.from(response.data);
+    // The signature rather than a length: the advertised `type` is `application/gml+xml` on
+    // a body the host serves as `application/zip`, so neither header settles what arrived.
+    if (bytes.subarray(0, ZIP_SIGNATURE.length).toString("latin1") !== ZIP_SIGNATURE) {
+        throw new Error(`${url} answered ${bytes.byteLength} bytes that do not begin with a zip signature, ` +
+            `so the body is not the archive`);
+    }
+    await writeLocalFile(bytes, options.dest);
+    // A stubbed transport may answer without headers at all, so the record of what the
+    // host served the archive under is read defensively rather than indexed.
+    const headers = response.headers;
+    return {
+        municipality_code: dataset.code,
+        filename: dataset.filename,
+        source_url: url,
+        downloaded_at: new Date().toISOString(),
+        sha256: sha256Hex(bytes),
+        bytes: bytes.byteLength,
+        feed_updated: dataset.updated,
+        last_modified: headers?.["last-modified"] ?? null,
+    };
+}
+/**
+ * Harvest ČÚZK's INSPIRE Addresses archives into `<outRoot>/cz-cuzk/`.
+ *
+ * Re-runnable: a municipality whose recorded modification time still matches the service
+ * document's and whose archive is still on disk at the recorded length costs no request.
+ *
+ * A full harvest is 6,259 requests — the service document plus one per municipality —
+ * and an estimated 396 MB, from a mean of 63,337 bytes over a systematic sample
+ * of 50 of the 6,258 archives on 2026-10-02.
+ * The sample ran from 5,236 to 1,642,586 bytes, so the total is an estimate from
+ * 50 measurements rather than a measurement of all 6,258.
+ */
+export async function fetchCzCuzk(options, report) {
+    await using client = new APIClient({
+        displayName: SLUG,
+        minRequestIntervalMs: options.minRequestIntervalMs ?? CZ_CUZK_REQUEST_INTERVAL_MS,
+        retry: true,
+    });
+    // Awaited rather than returned: `await using` disposes the client when this scope exits,
+    // and a disposed `APIClient` refuses every later request.
+    return await harvestCzCuzk(client, {
+        outputDir: options.outRoot(SLUG),
+        projection: options.projection,
+        municipalities: options.municipalities,
+        limit: options.limit,
+        resolveThroughDatasetFeed: options.resolveThroughDatasetFeed,
+        verifyDigests: options.verifyDigests,
+        signal: options.signal,
+        report,
+    });
+}
+//# sourceMappingURL=cuzk.js.map

package/out/cz/tools/fetch/cuzk.js.map

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

package/out/de/recipes/locale.d.ts

@@ -3,42 +3,40 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- *   `german` slice recipe — German coverage rows from REAL OpenAddresses tuples (Berlin + Saxony,
- *   cached zips). Each sampled tuple is rendered via {@link synthesizeGermanRow} in BOTH orders —
- *   `--intl-fraction` (default 0.4) in international order (house-first / postcode-after-city), the
- *   rest in idiomatic German order — then aligned to BIO. Generate-mode: it builds a tuple pool
- *   from the cached zips, then draws `--count` rows from it with the passed `random` (so the emit
- *   stream matches the legacy reservoir-sample loop). Ported from scripts/build-german-slice.mjs.
+ * `german` recipe: German coverage rows from real OpenAddresses tuples (Berlin and Saxony, cached
+ * zips). Each sampled tuple renders through {@link renderGermanRow} in both orders, with
+ * `--intl-fraction` (default 0.4) in international order and the rest in idiomatic German order.
+ * Generate mode builds a tuple pool from the cached zips, then draws `--count` rows with the passed
+ * `random`.
  *
- *   ORDER ROBUSTNESS (2026-06-06): mixing the two renderings stops a native-only slice from teaching
- *   German order so well it reads the US/feed-order eval as a "collapse". See
- *   docs/articles/evals/resolver-geo/2026-06-06-anchor-pilot.md (the order-artifact correction).
+ * The combined renderings keep native-only recipe output from over-teaching German order.
+ * Over-teaching German order appears as a collapse on the US/feed-order eval.
  *
- *   TWO REGISTERS THE OA TUPLES DO NOT CARRY (#1946). A comma-free single line — `Neusser Str. 12 Nippes
- *   50733 Köln`, the dictation / one-field-form register — segments as ONE unit at stage 2, and with one
- *   segment the placetype-pair prior never fires, so the model reads `Nippes` as a second street and the
- *   one-value-per-tag projection deletes it. `--comma-free-fraction` renders that many native-order rows
- *   with `" "` as the line separator. And OA rows have no district at all, so `--ortsteil-fraction` rows
- *   borrow a WOF Ortsteil of the tuple's own locality as `dependent_locality` — 67,532 DE neighbourhoods
- *   carry a locality ancestor in the admin database, `Köln-Nippes` among them. The German spelling is
- *   recovered from the `names` table ({@link ortsteilSurface}): WOF's `spr.name` for DE neighbourhoods is
- *   the ASCII-folded label (`Bocklemuend`), which no German ever types.
+ * Two registers are absent from the OA tuples. A comma-free single line (`Neusser Str. 12 Nippes 50733
+ * Köln`) segments as one unit at stage 2. With one segment, the placetype-pair prior never fires.
+ * The model then reads `Nippes` as a second street. The one-value-per-tag projection deletes it.
+ * `--comma-free-fraction` renders that many native-order rows with `" "` as the line separator. OA
+ * rows also lack a district, so `--ortsteil-fraction` rows borrow a WOF Ortsteil of the tuple's
+ * own locality as `dependent_locality`. The German spelling is recovered from the `names` table
+ * ({@link ortsteilSurface}) because WOF's `spr.name` for DE neighborhoods is the ascii-folded label.
  */
 import { type CorpusRecipe } from "#recipes/scaffold";
 /**
  * The surface an Ortsteil is written with in an address, from WOF's rows for it.
  *
- * `spr.name` for a DE neighbourhood is the ASCII-folded label; the `names` rows in `deu` carry the German spelling
- * beside unrelated labels for co-located features (`Bocklemuend` → `Bocklemünd`, `Jüdischer Friedhof Bocklemünd`,
- * `Menara-Garten`). The German name is the one that spells the same label as `spr.name` under either of WOF's ASCII
- * folds ({@link foldGerman}); with none, `spr.name` stands. WOF also prefixes some Ortsteile with their city
- * (`Köln-Nippes`), a form no envelope carries once the city is its own line, so a leading `<locality>-` is dropped when
- * something is left after it.
+ * `spr.name` for a DE neighborhood is the ascii-folded label.
+ * The `names` rows in `deu` contain the German spelling beside unrelated labels for co-located
+ * features (`Bocklemuend` → `Bocklemünd`, `Jüdischer Friedhof Bocklemünd`, `Menara-Garten`).
+ *
+ * The German name is the one that spells the same label as `spr.name` under either of
+ * WOF's ascii folds ({@link foldGerman}); with none, `spr.name` stands.
+ *
+ * WOF also prefixes some Ortsteile with their city (`Köln-Nippes`), a form absent from the envelope
+ * once the city is its own line, so a leading `<locality>-` is dropped when something is left after it.
  */
 export declare function ortsteilSurface(sprName: string, deuNames: readonly string[], locality: string): string;
 /**
- * Slice recipe registered with the corpus builder — see the file header for the parse behaviour it exists to exercise,
- * and `description` below for the surface form it generates.
+ * Recipe registered with the corpus builder.
  */
 export declare const germanRecipe: CorpusRecipe;
 //# sourceMappingURL=locale.d.ts.map

package/out/de/recipes/locale.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"locale.d.ts","sourceRoot":"","sources":["../../../lib/de/recipes/locale.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAUH,OAAO,EAAwB,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAA;AA0D3E;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAOtG;AAoFD;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,YAiK1B,CAAA"}
+{"version":3,"file":"locale.d.ts","sourceRoot":"","sources":["../../../lib/de/recipes/locale.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAYH,OAAO,EAAwB,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAiE3E;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAOtG;AAuFD;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,YAiK1B,CAAA"}