@mailwoman/corpus 10.0.0 → 10.2.0

package/out/cn/recipes/organizational-units.js

@@ -2,37 +2,23 @@
  * @copyright Sister Software
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
- * @file `cn-organizational-units` recipe (#2034) — real CN address strings whose settlement is an ORGANIZATIONAL
- *   ladder (`赵光三分场二十九队`: the Zhaoguang farm, No. 3 sub-farm, No. 29 production team), labeled by rule and aligned
- *   character by character for the CJK sibling model.
+ * @file Labels Chinese rows whose settlement ends in an organizational unit chain.
  *
- *   THE LABELS ARE A READING OF THE SUFFIX, NOT A GUESS. Every generic that ends an ordinal unit (`分场`, `大队`, `队`,
- *   `连`, `团`, `组`, `场部`) is in `@mailwoman/core/locale/zh-cn-units`' one table, and the same table reads the span back
- *   after decode. The whole ordinal chain is ONE `locality_unit` span; the named head it belongs to (`赵光`, `孟定农场`) is
- *   `dependent_locality`; a province, city or county written in front of it takes `region`, `locality`, `subregion`; a
- *   Latin admin tail (`, Heilongjiang, China`) takes `region` and `country`. A row with no chain is skipped, not labeled:
- *   `红卫大队` is a village name whose generic carries no ordinal, and `苗辽林场` is a named forest farm.
- *
- *   WHERE THE ROWS COME FROM. `--input` is a JSONL of `{ raw, country }` rows — the shape of `data/coarse-placer/*.jsonl`,
- *   whose 50,000 CN rows hold 328 with unit vocabulary. That file is a local artifact and carries no per-row source; the
- *   `<name>, <admin1>, <country>` shape is the corpus's GeoNames adapter's, so the rows are stamped with GeoNames'
- *   licence and the inference is stated in the `license` field rather than hidden behind it.
- *
- *   FOR THE CJK MODEL ONLY. The tokenizer is {@link cjkAwareTokenizer}: one token per Han character, because the
- *   whitespace tokenizer reads `三分场八队` as one word and could never give it two labels. The Latin model never trains
- *   on this recipe's rows; its label set has no `locality_unit`.
+ *   The unit grammar tags the whole chain as `locality_unit` and its head unit as `dependent_locality`. Input is JSONL
+ *   with `{ raw, country }`. Rows are aligned per character for the CJK model.
  */
+import { stringifyJSON } from "@mailwoman/core/json";
 import { splitCNUnitChain } from "@mailwoman/core/locale/zh-cn-units";
-import { readTuples, sliceSourceID } from "#recipes/scaffold";
+import { TextSpliterator } from "spliterator";
+import { readTuples, recipeSourceID } from "#recipes/scaffold";
 import { alignRow } from "#utils/align";
 import { cjkAwareTokenizer } from "#utils/tokenize";
 /**
- * The leading run of Han characters (plus the digits an ordinal may be written with): the Chinese half of a row.
+ * Matches the leading run of Han characters and digits.
  */
 const LEADING_HAN = /^[\p{Script=Han}〇\d]+/u;
 /**
- * Admin prefixes a CJK address writes in front of the settlement, coarsest first. Each is matched at the START of what
- * remains, so `云南省临沧市孟定农场三分场二队` peels `云南省` (province), `临沧市` (city), and hands `孟定农场三分场二队` to the unit reader.
+ * Administrative prefixes, matched in order from broadest to narrowest.
  */
 const ADMIN_PREFIXES = [
     [/^(.+?(?:省|自治区))/u, "region"],
@@ -40,8 +26,7 @@ const ADMIN_PREFIXES = [
     [/^(.+?(?:自治县|县|旗))/u, "subregion"],
 ];
 /**
- * The components a row's string supports, every value a verbatim substring of `raw`, or `null` when the string carries
- * no organizational chain and so teaches nothing this recipe exists for.
+ * Labels the components of a row, or returns `null` when the row has no unit chain.
  */
 export function labelCNOrganizationalRow(raw) {
     const han = LEADING_HAN.exec(raw)?.[0];
@@ -51,7 +36,7 @@ export function labelCNOrganizationalRow(raw) {
     let rest = han;
     for (const [pattern, tag] of ADMIN_PREFIXES) {
         const match = pattern.exec(rest);
-        // A prefix must leave something behind it, or the whole run was the admin name and there is no settlement.
+        // A prefix is taken only when text remains after it for the settlement.
         if (match && match[1].length < rest.length) {
             components[tag] = match[1];
             rest = rest.slice(match[1].length);
@@ -66,13 +51,9 @@ export function labelCNOrganizationalRow(raw) {
     components.locality_unit = split.chain;
     const tail = raw.slice(han.length).trim();
     if (tail) {
-        // `, Heilongjiang, China` or `Hunan China` or `Inner Mongolia`: comma segments when there are commas, else the last
-        // word is the country when it says so and the rest is the admin1 name.
+        // A Latin tail becomes a region and a trailing "China" country.
         const segments = tail.includes(",")
-            ? tail
-                .split(",")
-                .map((segment) => segment.trim())
-                .filter((segment) => segment.length > 0)
+            ? TextSpliterator.from(tail, { delimiter: "," }).toArray()
             : tailWithoutCommas(tail);
         for (const segment of segments) {
             if (/^china$/iu.test(segment)) {
@@ -86,11 +67,11 @@ export function labelCNOrganizationalRow(raw) {
     return components;
 }
 /**
- * A space-separated tail: `Hunan China` → [`Hunan`, `China`]; `Inner Mongolia` → [`Inner Mongolia`]; `Xinjiang Uyghur`
- * → [`Xinjiang Uyghur`].
+ * Splits a trailing `China` off a tail without commas.
+ * Any other tail stays one segment.
  */
 function tailWithoutCommas(tail) {
-    const words = tail.split(/\s+/u).filter((word) => word.length > 0);
+    const words = tail.split(/\s+/u).filter((word) => word.length);
     const last = words.at(-1);
     if (last && /^china$/iu.test(last) && words.length > 1) {
         return [words.slice(0, -1).join(" "), last];
@@ -99,8 +80,7 @@ function tailWithoutCommas(tail) {
 }
 const SOURCE = "coarse-placer-cn-units";
 /**
- * Slice recipe registered with the corpus builder — see the file header for the rows it labels and why every label is a
- * reading of a generic rather than a guess.
+ * The recipe registered with the corpus builder.
  */
 export const cnOrganizationalUnitsRecipe = {
     name: "cn-organizational-units",
@@ -128,7 +108,7 @@ export const cnOrganizationalUnitsRecipe = {
                 continue;
             }
             if (opts.golden) {
-                write(JSON.stringify({ raw, components, country: "CN", locale: "zh-CN" }) + "\n");
+                write(stringifyJSON({ raw, components, country: "CN", locale: "zh-CN" }));
                 emitted++;
                 continue;
             }
@@ -138,18 +118,17 @@ export const cnOrganizationalUnitsRecipe = {
                 country: "CN",
                 locale: "zh-CN",
                 source: opts.sourceName ?? SOURCE,
-                source_id: sliceSourceID(opts.sourceName ?? SOURCE, { raw }),
+                source_id: recipeSourceID(opts.sourceName ?? SOURCE, { raw }),
                 corpus_version: "0.4.0",
                 license: "CC-BY-4.0 — GeoNames populated places, INFERRED from the `<name>, <admin1>, <country>` row shape; data/coarse-placer carries no per-row source",
             };
-            // Verbatim only: every value above was sliced out of `raw`, so an edit-distance match would mean this file
-            // has a bug, not that the source spells something differently.
+            // Every component must appear verbatim in `raw`.
             const aligned = alignRow(canonical, { tokenizer, maxEditDistance: 0 });
             if (aligned.kind !== "labeled" || !aligned.row) {
                 quarantined++;
                 continue;
             }
-            write(JSON.stringify({ ...aligned.row, synth_method: "cn-organizational-units", synth_base_id: null }) + "\n");
+            write(stringifyJSON({ ...aligned.row, synth_method: "cn-organizational-units", synth_base_id: null }));
             emitted++;
         }
         console.error(`  cn-organizational-units: ${emitted} labeled, ${skipped} without a chain, ${quarantined} quarantined`);

package/out/cn/recipes/organizational-units.js.map

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

package/out/cz/adapters/cuzk/adapter.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ * `cz-cuzk`: the INSPIRE Addresses theme ČÚZK publishes, read from its per-municipality GML.
+ *
+ * ČÚZK, the Czech Office for Surveying, Mapping and Cadastre, publishes one zipped GML per
+ * municipality through the ATOM service at `https://atom.cuzk.gov.cz/AD/AD.xml`. That service lists
+ * 6,258 dataset feeds. Each feed offers the same data in EPSG:5514 and EPSG:4258. The adapter reads
+ * a single archive or a directory of them, so a caller harvests municipality by municipality rather
+ * than waiting on a national file.
+ *
+ * Every address and every feature it references sit in the same archive, so this publisher is cheap
+ * to read. The `ad:component` hrefs look external, because ČÚZK writes an absolute WFS stored-query
+ * URL on `services.cuzk.cz`. The `Id=` parameter of each one matches a `gml:id` in the file at hand.
+ * Measured over `584282.xml`: 5,460 component references across 1,365 addresses, 0 of them reaching
+ * outside the archive. Only `ad:parcel` and `ad:building` point at genuinely separate themes, and
+ * the adapter reads neither.
+ *
+ * ČÚZK states one condition of use and states it uniformly. Every one of the 6,259 `rights` elements
+ * in the ATOM service document reads `žádné podmínky neplatí`, the INSPIRE controlled value
+ * `no conditions apply to access and use`. The address-source register elects that and records no
+ * license instrument, so no SPDX identifier exists to record and the rows store the controlled value
+ * itself. The register also holds a caution this adapter cannot resolve: that value states the
+ * absence of a restriction on access and use rather than granting copyright, so what it permits
+ * beyond access and use rests on Czech law.
+ */
+import { type CorpusAdapter } from "#types";
+/**
+ * Registry id for this adapter.
+ *
+ * Stamped into every row it emits, so a corpus record can be traced back to the dataset it came from.
+ */
+export declare const CZ_CUZK_ADAPTER_ID = "cz-cuzk";
+/**
+ * The jurisdiction this adapter emits.
+ */
+export declare const CZ_CUZK_COUNTRIES: readonly string[];
+/**
+ * The license recorded on every row.
+ *
+ * INSPIRE's controlled value, in the English the register renders it to, because ČÚZK
+ * names no license instrument and the register therefore writes no SPDX identifier.
+ */
+export declare const CZ_CUZK_LICENSE = "no conditions apply to access and use";
+export declare function createCzCuzkAdapter(): CorpusAdapter;
+/**
+ * The configured adapter instance registered with the corpus builder.
+ */
+export declare const czCuzkAdapter: CorpusAdapter;
+//# sourceMappingURL=adapter.d.ts.map

package/out/cz/adapters/cuzk/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../lib/cz/adapters/cuzk/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAsBH,OAAO,EAAuD,KAAK,aAAa,EAAiB,MAAM,QAAQ,CAAA;AAE/G;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,YAAY,CAAA;AAE3C;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,EAAW,CAAA;AAE1D;;;;;GAKG;AACH,eAAO,MAAM,eAAe,0CAA0C,CAAA;AAmFtE,wBAAgB,mBAAmB,IAAI,aAAa,CAwCnD;AA4HD;;GAEG;AACH,eAAO,MAAM,aAAa,eAAwB,CAAA"}

package/out/cz/adapters/cuzk/adapter.js

@@ -0,0 +1,269 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ * `cz-cuzk`: the INSPIRE Addresses theme ČÚZK publishes, read from its per-municipality GML.
+ *
+ * ČÚZK, the Czech Office for Surveying, Mapping and Cadastre, publishes one zipped GML per
+ * municipality through the ATOM service at `https://atom.cuzk.gov.cz/AD/AD.xml`. That service lists
+ * 6,258 dataset feeds. Each feed offers the same data in EPSG:5514 and EPSG:4258. The adapter reads
+ * a single archive or a directory of them, so a caller harvests municipality by municipality rather
+ * than waiting on a national file.
+ *
+ * Every address and every feature it references sit in the same archive, so this publisher is cheap
+ * to read. The `ad:component` hrefs look external, because ČÚZK writes an absolute WFS stored-query
+ * URL on `services.cuzk.cz`. The `Id=` parameter of each one matches a `gml:id` in the file at hand.
+ * Measured over `584282.xml`: 5,460 component references across 1,365 addresses, 0 of them reaching
+ * outside the archive. Only `ad:parcel` and `ad:building` point at genuinely separate themes, and
+ * the adapter reads neither.
+ *
+ * ČÚZK states one condition of use and states it uniformly. Every one of the 6,259 `rights` elements
+ * in the ATOM service document reads `žádné podmínky neplatí`, the INSPIRE controlled value
+ * `no conditions apply to access and use`. The address-source register elects that and records no
+ * license instrument, so no SPDX identifier exists to record and the rows store the controlled value
+ * itself. The register also holds a caution this adapter cannot resolve: that value states the
+ * absence of a restriction on access and use rather than granting copyright, so what it permits
+ * beyond access and use rests on Czech law.
+ */
+import { formatAddressRow } from "@mailwoman/codex/address/format";
+import { PathBuilder } from "path-ts";
+import { Globerator } from "spliterator/node/fs";
+import { UnsupportedCountryError } from "#adapters/errors";
+import { stableSourceID } from "#adapters/source-id";
+import { adminUnitLevel, componentHrefs, componentJoinKey, designator, designatorsByType, placeName, postalDescriptorCode, thoroughfareName, } from "#inspire/address";
+import { inspireGMLChunks } from "#inspire/archive";
+import { streamInspireRows } from "#inspire/stream";
+import { SourceRegister } from "#registers";
+import { AddressRole, SurfaceOrigin } from "#types";
+/**
+ * Registry id for this adapter.
+ *
+ * Stamped into every row it emits, so a corpus record can be traced back to the dataset it came from.
+ */
+export const CZ_CUZK_ADAPTER_ID = "cz-cuzk";
+/**
+ * The jurisdiction this adapter emits.
+ */
+export const CZ_CUZK_COUNTRIES = ["CZ"];
+/**
+ * The license recorded on every row.
+ *
+ * INSPIRE's controlled value, in the English the register renders it to, because ČÚZK
+ * names no license instrument and the register therefore writes no SPDX identifier.
+ */
+export const CZ_CUZK_LICENSE = "no conditions apply to access and use";
+/**
+ * The feature types an address references.
+ * The adapter indexes them as they arrive.
+ *
+ * `ad:Address` holds its number inline and is read by the driver rather than listed here.
+ * These four hold the street, the postcode and the two place names, and they are read in the same pass
+ * because an archive writes them interleaved with the addresses rather than ahead of them.
+ */
+const COMPONENT_TYPES = [
+    "ad:ThoroughfareName",
+    "ad:PostalDescriptor",
+    "ad:AdminUnitName",
+    "ad:AddressAreaName",
+];
+/**
+ * The member of a municipality's archive that holds the GML.
+ *
+ * ČÚZK names it for the municipality, as `584282.xml`, and ships one member per archive,
+ * so the extension selects it without the adapter knowing the code.
+ *
+ * ČÚZK's central directory records the member's size as the ZIP64 sentinel `0xFFFFFFFF`
+ * on at least one archive, so a reader trusting that slot reads the wrong length.
+ * `readZipEntry`, which {@linkcode inspireGMLChunks} uses, reads the ZIP64 extra field
+ * where the real length lives.
+ */
+const GML_MEMBER = /\.xml$/iu;
+/**
+ * The series prefix a street name makes unnecessary.
+ *
+ * Czechia numbers a building in one of two series.
+ * A `číslo popisné` is the descriptive number an ordinary building holds, and a
+ * `číslo evidenční` numbers a recreational or temporary building in a separate series,
+ * so the same digits can name two buildings in one municipality.
+ */
+const DESCRIPTIVE_NUMBER_PREFIX = "č.p.";
+/**
+ * The house number as ČÚZK writes it, including the series prefix wherever ČÚZK writes one.
+ *
+ * ČÚZK states the series as a `buildingIdentifierPrefix` designator on every address
+ * and renders it in three of four cases.
+ * Its own `ad:alternativeIdentifier` is the authority, and comparing this function's
+ * whole rendered line against that string over the 1,669 addresses of Židlochovice
+ * and Unkovice is what the table below was read from:
+ *
+ * | | street present | street absent |
+ * | --- | --- | --- |
+ * | `č.p.` | `Dezortova 803` | `č.p. 217, 66463 Unkovice` |
+ * | `č.ev.` | `Komenského č.ev. 502` | `č.ev. 38, 66463 Unkovice` |
+ *
+ * So the descriptive prefix is dropped only when a street name already places the number.
+ * A number with no street keeps its prefix, because the two series overlap
+ * and the digits by themselves would not say which building is meant.
+ *
+ * An earlier rule that dropped `č.p.` everywhere disagreed with the publisher on 254 of those 1,669 rows.
+ *
+ * A prefix other than `č.p.` is kept in every case, including one these two municipalities
+ * did not show, because the observed values come from 2 of 6,258 municipalities.
+ * An unrecognized prefix stays.
+ *
+ * That preserves a distinction the publisher drew rather than discarding it.
+ */
+function czechHouseNumber(byType, options) {
+    const number = designator(byType, "buildingIdentifier");
+    if (!number)
+        return null;
+    const prefix = designator(byType, "buildingIdentifierPrefix");
+    if (!prefix)
+        return number;
+    if (options.street && prefix === DESCRIPTIVE_NUMBER_PREFIX)
+        return number;
+    return `${prefix} ${number}`;
+}
+export function createCzCuzkAdapter() {
+    return {
+        id: CZ_CUZK_ADAPTER_ID,
+        defaultLicense: CZ_CUZK_LICENSE,
+        addressRole: AddressRole.Premise,
+        register: SourceRegister.CuzkInspireAddresses,
+        surface: SurfaceOrigin.Rendered,
+        description: "INSPIRE Addresses (ČÚZK): house-number-level addresses for Czechia, one zipped GML per municipality.",
+        async *rows(opts) {
+            if (opts.country && !CZ_CUZK_COUNTRIES.includes(opts.country)) {
+                throw new UnsupportedCountryError(CZ_CUZK_ADAPTER_ID, CZ_CUZK_COUNTRIES, opts.country);
+            }
+            let emitted = 0;
+            // One archive per municipality, each a document whose references resolve inside it,
+            // so the index is per archive rather than shared across the 6,258.
+            for (const archivePath of await archivePaths(opts.inputPath)) {
+                if (opts.signal?.aborted)
+                    break;
+                if (opts.limit !== undefined && emitted >= opts.limit)
+                    break;
+                for await (const row of streamInspireRows({
+                    chunks: inspireGMLChunks(archivePath, GML_MEMBER),
+                    componentElements: COMPONENT_TYPES,
+                    // The subtree is kept, because one feature answers a street, a postcode
+                    // or a place name depending on which type it is.
+                    index: (feature) => feature,
+                    compose: (address, referenced, final) => composeRow(address, referenced, { final }),
+                    limit: opts.limit === undefined ? undefined : opts.limit - emitted,
+                    signal: opts.signal,
+                })) {
+                    yield row;
+                    emitted++;
+                }
+            }
+        },
+    };
+}
+/**
+ * One address's row, `null` when it holds too little to render, or `"deferred"`
+ * when a reference it cites is not indexed yet.
+ *
+ * The caller defers rather than drops because an unresolved reference and an absent one
+ * are different conditions, and only the archive's own ordering tells them apart.
+ * With `final` set the whole member has been read, so an unresolved reference is an
+ * absence the publisher is responsible for and the row is rendered without it.
+ */
+function composeRow(address, referenced, options = {}) {
+    const byType = designatorsByType(address);
+    let street = null;
+    let postcode = null;
+    let locality = null;
+    let settlement = null;
+    let unresolved = false;
+    for (const href of componentHrefs(address)) {
+        const key = componentJoinKey(href);
+        if (!key)
+            continue;
+        const feature = referenced.get(key);
+        if (!feature) {
+            // Only the four themes this adapter reads are expected in the archive.
+            // A parcel or building reference holds no `Id` the loop above accepted.
+            if (/^(?:TF|PD|AU|AA)\./u.test(key)) {
+                unresolved = true;
+            }
+            continue;
+        }
+        if (feature.name === "ad:ThoroughfareName") {
+            street = thoroughfareName(feature);
+        }
+        else if (feature.name === "ad:PostalDescriptor") {
+            postcode = postalDescriptorCode(feature);
+        }
+        else if (feature.name === "ad:AddressAreaName") {
+            settlement = placeName(feature);
+        }
+        else if (feature.name === "ad:AdminUnitName" && adminUnitLevel(feature) === "4thOrder") {
+            locality = placeName(feature);
+        }
+    }
+    if (unresolved && !options.final)
+        return "deferred";
+    // The street decides whether the number keeps its series prefix, so it is read first.
+    const house = czechHouseNumber(byType, { street });
+    const place = locality ?? settlement;
+    if (!place)
+        return null;
+    if (!postcode && !street)
+        return null;
+    const components = {};
+    if (house) {
+        components.house_number = house;
+    }
+    if (street) {
+        components.street = street;
+    }
+    if (postcode) {
+        components.postcode = postcode;
+    }
+    components.locality = place;
+    // A `část obce`, the settlement part, is a dependent locality when the municipality is known.
+    if (settlement && locality && settlement !== locality) {
+        components.dependent_locality = settlement;
+    }
+    const rendered = formatAddressRow(components, "CZ", { singleLine: true });
+    if (!rendered)
+        return null;
+    const { raw, components: aligned } = rendered;
+    const seed = address.attributes["gml:id"]?.trim();
+    return {
+        raw,
+        components: aligned,
+        country: "CZ",
+        locale: "cs-CZ",
+        source: CZ_CUZK_ADAPTER_ID,
+        source_id: seed ? `${CZ_CUZK_ADAPTER_ID}-${seed}` : stableSourceID(CZ_CUZK_ADAPTER_ID, aligned),
+        corpus_version: "",
+        license: CZ_CUZK_LICENSE,
+    };
+}
+/**
+ * Every archive under `inputPath`, which is one `.zip` or a directory holding them.
+ *
+ * A directory is read because ČÚZK publishes 6,258 of these, one per municipality,
+ * and a caller harvesting the country points at the directory it fetched them into.
+ * A directory holding no archive raises rather than yielding zero rows, so a wrong
+ * path reports itself instead of reading as an empty publisher.
+ */
+async function archivePaths(inputPath) {
+    const path = PathBuilder.from(inputPath);
+    if (path.basename().toLowerCase().endsWith(".zip"))
+        return [path];
+    const names = await Globerator.from("*.zip", { cwd: path.toString(), absolute: false }).toSorted();
+    if (!names.length) {
+        throw new Error(`${CZ_CUZK_ADAPTER_ID} adapter: ${path.toString()} holds no .zip archive`);
+    }
+    return names.map((name) => path(name));
+}
+/**
+ * The configured adapter instance registered with the corpus builder.
+ */
+export const czCuzkAdapter = createCzCuzkAdapter();
+//# sourceMappingURL=adapter.js.map

package/out/cz/adapters/cuzk/adapter.js.map

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

package/out/cz/recipes/pcfirst-preposition.d.ts

@@ -3,20 +3,16 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- *   `cz-pcfirst-preposition` — the Czech pc-first prepositional-locality slice, fourth orthography
- *   of the #901 leading-name-boundary family. The #897 close-out read all 8 residual CZ rows as one
- *   class: a LEADING postcode mis-assigned as house_number while the multi-word "nad/pod/u X"
- *   locality shatters ("51244 Rokytnice nad Jizerou, Dolní Rokytnice 111" → street
- *   'RokytnicenadJizerou' + house_number '51244'). That leading-5-digit confusion is the
- *   anchor-pollution class whose decode-time OVERRIDE was correctly killed in #723 — this slice is
- *   the model-first fix as DATA: real prepositional localities in the order that breaks, so the
- *   model learns that a leading postcode before a multi-word name is a postcode. pc-first leads the
- *   cycle (the lesson); canonical and city-first keep the polarity balanced (the v1.9.9 lesson).
+ * `cz-pcfirst-preposition`: the Czech pc-first prepositional-locality recipe.
+ *
+ * A leading postcode is mis-assigned as a house number while a multi-word "nad/pod/u X" locality
+ * shatters. This recipe supplies real prepositional localities in the order that breaks, so the
+ * model learns that a leading postcode before a multi-word name is a postcode. pc-first leads the
+ * cycle and the canonical and city-first orders keep the polarity balanced.
  */
 import { type CorpusRecipe } from "#recipes/scaffold";
 /**
- * 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 czPcFirstPrepositionRecipe: CorpusRecipe;
 //# sourceMappingURL=pcfirst-preposition.d.ts.map

package/out/cz/recipes/pcfirst-preposition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pcfirst-preposition.d.ts","sourceRoot":"","sources":["../../../lib/cz/recipes/pcfirst-preposition.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,EAA6B,KAAK,YAAY,EAAiB,MAAM,mBAAmB,CAAA;AAQ/F;;;GAGG;AACH,eAAO,MAAM,0BAA0B,EAAE,YAiFxC,CAAA"}
+{"version":3,"file":"pcfirst-preposition.d.ts","sourceRoot":"","sources":["../../../lib/cz/recipes/pcfirst-preposition.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,EAA8C,KAAK,YAAY,EAAkB,MAAM,mBAAmB,CAAA;AAWjH;;GAEG;AACH,eAAO,MAAM,0BAA0B,EAAE,YA+FxC,CAAA"}