@mailwoman/corpus 8.0.0 → 8.2.0

package/src/shard-recipes/country-balanced.ts

@@ -37,6 +37,12 @@ import { makeMulberry32, type ShardRecipe } from "./scaffold.ts"
 // v2: the country TOKEN is decoupled from the skeleton's locale and drawn from a BROAD pool — every
 // ISO canonical name + every curated surface form (endonyms/abbrevs). Surface forms are over-weighted
 // so endonyms/abbrevs ("Deutschland","USA","NL") get strong signal.
+/* oxlint-disable sister-software/no-unnamed-threshold -- the bare decimals below are weighted-sampler
+   cutoffs, not thresholds: `const r = random()` followed by a cascade of `r < 0.4` branches IS the
+   output distribution, and reading the cascade top-to-bottom is how you see it. Naming each cutoff
+   would hide the distribution behind a wall of identifiers. Genuine thresholds in these files are
+   extracted as named constants above. */
+
 const COUNTRY_FORM_POOL = (() => {
 	const surface = Object.values(COUNTRY_SURFACE_FORMS).flat() // endonyms + abbrevs + canonical (curated)
 	const names = [...CountryNames]
@@ -44,9 +50,15 @@ const COUNTRY_FORM_POOL = (() => {
 	// all ~249 ISO canonical English names (breadth)
 	return { surface, names }
 })()
-const COUNTRY_ABSENT_PROB = 0.3 // negatives: rows with NO country token → teach golden precision
 
-/** A cached OpenAddresses extract + the implied iso2/region/render-order. */
+/**
+ * Negatives: rows with NO country token → teach golden precision.
+ */
+const COUNTRY_ABSENT_PROB = 0.3
+
+/**
+ * A cached OpenAddresses extract + the implied iso2/region/render-order.
+ */
 interface CountrySource {
 	zip: string
 	csv: string
@@ -55,8 +67,10 @@ interface CountrySource {
 	order: string
 }
 
-// Multi-locale OA sources. region = implied admin where the extract is single-region (US states, DE
-// Saxony); countrywide extracts (FR/IT/NL) read region from the CSV when present.
+/**
+ * Multi-locale OA sources. region = implied admin where the extract is single-region (US states, DE Saxony);
+ * countrywide extracts (FR/IT/NL) read region from the CSV when present.
+ */
 const SOURCES: readonly CountrySource[] = [
 	{ zip: "/tmp/oa-cache/us__ia__statewide.zip", csv: "us/ia/statewide.csv", iso2: "US", region: "IA", order: "us" },
 	{ zip: "/tmp/oa-cache/us__il__cook.zip", csv: "us/il/cook.csv", iso2: "US", region: "IL", order: "us" },
@@ -69,13 +83,18 @@ const SOURCES: readonly CountrySource[] = [
 	{ zip: "/tmp/oa-cache/it__countrywide.zip", csv: "it/countrywide.csv", iso2: "IT", region: "", order: "eu" },
 	{ zip: "/tmp/oa-cache/nl__countrywide.zip", csv: "nl/countrywide.csv", iso2: "NL", region: "", order: "eu" },
 ]
-// Held-out for --golden: Vermont (US holdout) + Berlin (DE holdout) — geographic split, never trained.
+
+/**
+ * Held-out for --golden: Vermont (US holdout) + Berlin (DE holdout) — geographic split, never trained.
+ */
 const EVAL_SOURCES: readonly CountrySource[] = [
 	{ zip: "/tmp/oa-cache/us__vt__statewide.zip", csv: "us/vt/statewide.csv", iso2: "US", region: "VT", order: "us" },
 	{ zip: "/tmp/oa-cache/de__berlin.zip", csv: "de/berlin.csv", iso2: "DE", region: "", order: "eu" },
 ]
 
-/** A real tuple read out of a cached OA zip (+ the source's iso2/render-order). */
+/**
+ * A real tuple read out of a cached OA zip (+ the source's iso2/render-order).
+ */
 interface CountryTuple {
 	house_number: string
 	street: string
@@ -88,6 +107,7 @@ interface CountryTuple {
 
 function splitCSV(line: string): string[] {
 	const out: string[] = []
+
 	let cur = "",
 		inQ = false
 
@@ -98,6 +118,7 @@ function splitCSV(line: string): string[] {
 			if (c === '"') {
 				if (line[i + 1] === '"') {
 					cur += '"'
+
 					i++
 				} else {
 					inQ = false
@@ -114,6 +135,7 @@ function splitCSV(line: string): string[] {
 			cur += c
 		}
 	}
+
 	out.push(cur)
 
 	return out
@@ -122,7 +144,8 @@ function splitCSV(line: string): string[] {
 function readTuples(source: CountrySource, limit: number): CountryTuple[] {
 	// countrywide extracts (FR/IT/NL) are GB-scale — cap the bytes with `head` (read ~8 lines per wanted
 	// tuple to survive dedup/skips) so the toString stays under V8's string limit.
-	const maxLines = Math.max(limit * 8, 20000) + 1
+	const maxLines = Math.max(limit * 8, 20_000) + 1
+
 	const r = spawnSync("bash", ["-c", `unzip -p "${source.zip}" "${source.csv}" | head -n ${maxLines}`], {
 		maxBuffer: 1024 * 1024 * 1024,
 		encoding: "buffer",
@@ -133,16 +156,19 @@ function readTuples(source: CountrySource, limit: number): CountryTuple[] {
 
 		return []
 	}
+
 	const lines = r.stdout.toString("utf8").split(/\r?\n/)
 
 	if (lines.length < 2) return []
 	const header = splitCSV(lines[0]!).map((h) => h.trim().toLowerCase())
 	const idx = (n: string): number => header.indexOf(n)
+
 	const iNum = idx("number"),
 		iStreet = idx("street"),
 		iCity = idx("city"),
 		iRegion = idx("region"),
 		iPost = idx("postcode")
+
 	const get = (cells: string[], i: number): string => (i >= 0 && i < cells.length ? (cells[i] ?? "").trim() : "")
 	const tuples: CountryTuple[] = []
 	const seen = new Set<string>()
@@ -150,6 +176,7 @@ function readTuples(source: CountrySource, limit: number): CountryTuple[] {
 	for (let li = 1; li < lines.length && tuples.length < limit; li++) {
 		if (!lines[li]) continue
 		const cells = splitCSV(lines[li]!)
+
 		const street = get(cells, iStreet),
 			locality = get(cells, iCity),
 			house_number = get(cells, iNum)
@@ -159,6 +186,7 @@ function readTuples(source: CountrySource, limit: number): CountryTuple[] {
 
 		if (seen.has(key)) continue
 		seen.add(key)
+
 		tuples.push({
 			house_number,
 			street,
@@ -173,7 +201,9 @@ function readTuples(source: CountrySource, limit: number): CountryTuple[] {
 	return tuples
 }
 
-/** Pick a country token from the BROAD pool, or null (a country-absent negative). v2. */
+/**
+ * Pick a country token from the BROAD pool, or null (a country-absent negative). v2.
+ */
 function pickCountry(random: () => number): string | null {
 	if (random() < COUNTRY_ABSENT_PROB) return null // negative — teaches "trailing token != always country"
 	// 60% curated surface forms (endonym/abbrev variety), 40% broad ISO canonical names (coverage).
@@ -182,7 +212,9 @@ function pickCountry(random: () => number): string | null {
 	return pool[Math.floor(random() * pool.length)]!
 }
 
-/** Render the address body in native-ish order. `country` null → a country-ABSENT negative row. */
+/**
+ * Render the address body in native-ish order. `country` null → a country-ABSENT negative row.
+ */
 function renderCountry(
 	random: () => number,
 	t: CountryTuple,
@@ -198,6 +230,7 @@ function renderCountry(
 	if (pc) {
 		components.postcode = pc
 	}
+
 	let body: string
 
 	if (order === "us") {
@@ -217,6 +250,7 @@ function renderCountry(
 		// postcode is NOT a country (counters the v1 golden over-firing).
 		return { fmt: "negative", raw: body, components }
 	}
+
 	const withC: Partial<Record<ComponentTag, string>> = { ...components, country }
 	const r = random()
 
@@ -242,6 +276,7 @@ interface Homograph {
 	cities: readonly string[]
 	us: { role: "region" | "locality"; locality: string; region: string; postcodes: readonly string[] }
 }
+
 const HOMOGRAPHS: readonly Homograph[] = [
 	{
 		surface: "Georgia",
@@ -280,12 +315,14 @@ const HOMOGRAPHS: readonly Homograph[] = [
 		us: { role: "locality", locality: "Turkey", region: "TX", postcodes: ["79261", "28393"] },
 	},
 ]
+
 // 2-letter codes that are BOTH a US state abbrev AND an ISO country code → must read as region in US ctx.
 interface AbbrevRegion {
 	code: string
 	localities: readonly string[]
 	postcodes: readonly string[]
 }
+
 const ABBREV_REGIONS: readonly AbbrevRegion[] = [
 	{ code: "CA", localities: ["Los Angeles", "Sacramento", "San Diego"], postcodes: ["90012", "95814", "92101"] }, // California / Canada
 	{ code: "GA", localities: ["Atlanta", "Savannah", "Macon"], postcodes: ["30309", "31401", "31201"] }, // Georgia(US) / Georgia
@@ -294,6 +331,7 @@ const ABBREV_REGIONS: readonly AbbrevRegion[] = [
 	{ code: "PA", localities: ["Philadelphia", "Pittsburgh"], postcodes: ["19103", "15222"] }, // Pennsylvania / Panama
 	{ code: "AL", localities: ["Birmingham", "Montgomery"], postcodes: ["35203", "36104"] }, // Alabama / Albania
 ]
+
 const STREET_POOL: readonly string[] = [
 	"Main Street",
 	"Oak Avenue",
@@ -306,6 +344,7 @@ const STREET_POOL: readonly string[] = [
 	"2nd Avenue",
 	"Maple Drive",
 ]
+
 const pick = <T>(random: () => number, arr: readonly T[]): T => arr[Math.floor(random() * arr.length)]!
 const houseNo = (random: () => number): string => String(1 + Math.floor(random() * 998))
 
@@ -320,6 +359,7 @@ function renderHomograph(random: () => number): {
 	iso2: string
 } {
 	const h = pick(random, HOMOGRAPHS)
+
 	const hn = houseNo(random),
 		street = pick(random, STREET_POOL)
 
@@ -327,12 +367,14 @@ function renderHomograph(random: () => number): {
 		const city = pick(random, h.cities)
 		const withStreet = random() < 0.6
 		const raw = withStreet ? `${hn} ${street}, ${city}, ${h.surface}` : `${city}, ${h.surface}`
+
 		const components: Partial<Record<ComponentTag, string>> = withStreet
 			? { house_number: hn, street, locality: city, country: h.surface }
 			: { locality: city, country: h.surface }
 
 		return { fmt: "homograph-country", raw, components, iso2: h.iso2 }
 	}
+
 	const pc = pick(random, h.us.postcodes)
 
 	if (h.us.role === "region") {
@@ -354,7 +396,9 @@ function renderHomograph(random: () => number): {
 	}
 }
 
-/** An abbrev-as-region negative: "123 Main St, Los Angeles, CA 90012" → region CA, NO country. */
+/**
+ * An abbrev-as-region negative: "123 Main St, Los Angeles, CA 90012" → region CA, NO country.
+ */
 function renderAbbrevRegion(random: () => number): {
 	fmt: string
 	raw: string
@@ -362,6 +406,7 @@ function renderAbbrevRegion(random: () => number): {
 	iso2: string
 } {
 	const a = pick(random, ABBREV_REGIONS)
+
 	const hn = houseNo(random),
 		street = pick(random, STREET_POOL),
 		locality = pick(random, a.localities),
@@ -375,9 +420,19 @@ function renderAbbrevRegion(random: () => number): {
 	}
 }
 
-const HOMOGRAPH_FRAC = 0.22 // share of rows that are homograph contrast pairs
-const ABBREV_FRAC = 0.08 // share that are code-as-region negatives (cumulative with HOMOGRAPH_FRAC)
+/**
+ * Share of rows that are homograph contrast pairs.
+ */
+const HOMOGRAPH_FRAC = 0.22
+/**
+ * Share that are code-as-region negatives (cumulative with HOMOGRAPH_FRAC)
+ */
+const ABBREV_FRAC = 0.08
 
+/**
+ * Shard 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.
+ */
 export const countryBalancedRecipe: ShardRecipe = {
 	name: "country-balanced",
 	description: "Balanced model-first country rows (#464): OA skeletons + ISO surface forms + homograph contrast pairs",
@@ -396,6 +451,7 @@ export const countryBalancedRecipe: ShardRecipe = {
 
 		for (const s of sources) {
 			const t = readTuples(s, perSource)
+
 			console.error(`  ${s.csv} (${s.iso2}): ${t.length} tuples`)
 
 			for (const x of t) {
@@ -403,7 +459,7 @@ export const countryBalancedRecipe: ShardRecipe = {
 			}
 		}
 
-		if (pool.length === 0) {
+		if (!pool.length) {
 			throw new Error("No tuples — are the cached OA zips present in /tmp/oa-cache?")
 		}
 
@@ -435,17 +491,22 @@ export const countryBalancedRecipe: ShardRecipe = {
 
 				if (country && !rendered.raw.includes(country)) {
 					skipped++
+
 					continue
 				}
 			}
+
 			const { raw, components } = rendered
 			const localeTag = rowISO2 === "US" ? "en-US" : `${rowISO2.toLowerCase()}-${rowISO2}`
 
 			if (opts.golden) {
 				write(JSON.stringify({ raw, components, country: rowISO2 }) + "\n")
+
 				emitted++
+
 				continue
 			}
+
 			const canonical: CanonicalRow = {
 				raw,
 				components,
@@ -456,13 +517,17 @@ export const countryBalancedRecipe: ShardRecipe = {
 				corpus_version: "0.4.0",
 				license: "OpenAddresses multi-locale skeletons + injected ISO-3166 country surface forms (codex)",
 			}
+
 			const aligned = alignRow(canonical)
 
 			if (aligned.kind !== "labeled" || !aligned.row) {
 				skipped++
+
 				continue
 			}
+
 			write(JSON.stringify({ ...aligned.row, synth_method: "country", synth_base_id: null }) + "\n")
+
 			emitted++
 		}
 

package/src/shard-recipes/cz-pcfirst-preposition.ts

@@ -16,6 +16,10 @@
 
 import { alignAndWrite, makeMulberry32, readTuples, type ShardRecipe, shardSourceID } from "./scaffold.ts"
 
+/**
+ * Shard 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.
+ */
 export const czPcFirstPrepositionRecipe: ShardRecipe = {
 	name: "cz-pcfirst-preposition",
 	description:
@@ -36,10 +40,13 @@ export const czPcFirstPrepositionRecipe: ShardRecipe = {
 
 			if (!street || !city || !number || !postcode) {
 				skipped++
+
 				continue
 			}
+
 			const order = read % 3
 			let raw: string
+
 			const components: Record<string, string> = {
 				street,
 				house_number: number,
@@ -54,11 +61,13 @@ export const czPcFirstPrepositionRecipe: ShardRecipe = {
 			} else {
 				raw = `${city}, ${postcode}, ${street} ${number}`
 			}
+
 			const source_id = shardSourceID("synth-cz-pcfirst-preposition", {
 				...components,
 				o: String(order),
 				v: String(read),
 			})
+
 			const canonical = {
 				raw,
 				components,

package/src/shard-recipes/fr-admin-split.ts

@@ -39,10 +39,18 @@ import { alignRow } from "../align.ts"
 import type { CanonicalRow } from "../types.ts"
 import { makeMulberry32, type ShardRecipe } from "./scaffold.ts"
 
+/* oxlint-disable sister-software/no-unnamed-threshold -- the bare decimals below are weighted-sampler
+   cutoffs, not thresholds: `const r = random()` followed by a cascade of `r < 0.4` branches IS the
+   output distribution, and reading the cascade top-to-bottom is how you see it. Naming each cutoff
+   would hide the distribution behind a wall of identifiers. Genuine thresholds in these files are
+   extracted as named constants above. */
+
 const DEFAULT_COMMUNES = "/tmp/reg/fr-communes.tsv"
 const LICENSE = "BAN (Base Adresse Nationale) commune+postcode tuples, rendered admin-split — see ingest SOURCE"
 
-/** One distinct commune row from the TSV, with the département derived from its postcode. */
+/**
+ * One distinct commune row from the TSV, with the département derived from its postcode.
+ */
 interface CommuneRow {
 	commune: string
 	postcode: string
@@ -51,14 +59,18 @@ interface CommuneRow {
 	lat: string | undefined
 }
 
-/** One rendered admin-split variant. */
+/**
+ * One rendered admin-split variant.
+ */
 interface AdminSplitVariant {
 	raw: string
 	components: Partial<Record<ComponentTag, string>>
 	order: string
 }
 
-/** Read the distinct commune TSV (commune, postcode, lon, lat); derive the département name. */
+/**
+ * Read the distinct commune TSV (commune, postcode, lon, lat); derive the département name.
+ */
 async function readCommunes(path: string): Promise<CommuneRow[]> {
 	const rows: CommuneRow[] = []
 
@@ -129,6 +141,10 @@ function render(random: () => number, c: CommuneRow): AdminSplitVariant {
 	return out
 }
 
+/**
+ * Shard 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.
+ */
 export const frAdminSplitRecipe: ShardRecipe = {
 	name: "fr-admin-split",
 	description: "FR admin-split rows: BAN communes → split département into `region` (+ canonical-FR preservation)",
@@ -139,14 +155,15 @@ export const frAdminSplitRecipe: ShardRecipe = {
 	async run(opts, write) {
 		// Legacy build-fr-admin-split-shard.mjs seeded `mulberry32(opts.seed)`.
 		const random = makeMulberry32(opts.seed)
-		const count = opts.count ?? 60000
+		const count = opts.count ?? 60_000
 		const source = opts.sourceName ?? "synth-fr-admin-split"
 		const communesPath = opts.communes ?? DEFAULT_COMMUNES
 
 		const pool = await readCommunes(communesPath)
+
 		console.error(`  ${communesPath}: ${pool.length} communes with derived département`)
 
-		if (pool.length === 0) {
+		if (!pool.length) {
 			throw new Error("No communes — build the TSV from BAN first (see the recipe header).")
 		}
 
@@ -165,14 +182,17 @@ export const frAdminSplitRecipe: ShardRecipe = {
 
 			if (!values.every((v) => raw.includes(v))) {
 				skipped++
+
 				continue
 			}
 
 			if (opts.golden) {
 				// Held-out eval slice for the centroid gate — carries the truth coordinate.
 				write(JSON.stringify({ raw, components, country: "FR", lat: Number(base.lat), lon: Number(base.lon) }) + "\n")
+
 				emitted++
 				orderCounts[order] = (orderCounts[order] ?? 0) + 1
+
 				continue
 			}
 
@@ -181,6 +201,7 @@ export const frAdminSplitRecipe: ShardRecipe = {
 				region: components.region,
 				postcode: components.postcode,
 			})
+
 			const canonical: CanonicalRow = {
 				raw,
 				components,
@@ -191,16 +212,20 @@ export const frAdminSplitRecipe: ShardRecipe = {
 				corpus_version: "0.5.0",
 				license: LICENSE,
 			}
+
 			const aligned = alignRow(canonical)
 
 			if (aligned.kind !== "labeled" || !aligned.row) {
 				skipped++
+
 				continue
 			}
+
 			write(
 				JSON.stringify({ ...aligned.row, synth_method: "fr-admin-split", synth_order: order, synth_base_id: null }) +
 					"\n"
 			)
+
 			emitted++
 			orderCounts[order] = (orderCounts[order] ?? 0) + 1
 		}

package/src/shard-recipes/fr-bare-street.ts

@@ -23,6 +23,10 @@
 import { decomposeFrStreet } from "../adapters/ban/street-decompose.ts"
 import { alignAndWrite, makeMulberry32, readTuples, type ShardRecipe, shardSourceID } from "./scaffold.ts"
 
+/**
+ * Shard 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.
+ */
 export const frBareStreetRecipe: ShardRecipe = {
 	name: "fr-bare-street",
 	description:
@@ -43,24 +47,30 @@ export const frBareStreetRecipe: ShardRecipe = {
 
 			if (!fullStreet || !number || !locality) {
 				skipped++
+
 				continue
 			}
+
 			const { prefix, street } = decomposeFrStreet(fullStreet)
 
 			// The failing class is the prefix-led FR street; a no-prefix nom_voie ("La Ville Mois") isn't it.
 			if (!prefix || !street) {
 				skipped++
+
 				continue
 			}
+
 			const components: Record<string, string> = {
 				house_number: number,
 				street_prefix: prefix,
 				street,
 				locality,
 			}
+
 			// BARE comma form, number-before (FR's dominant order), NO postcode — the whole point.
 			const raw = `${number} ${prefix} ${street}, ${locality}`
 			const source_id = shardSourceID("synth-fr-bare-street", { ...components, v: String(read) })
+
 			const canonical = {
 				raw,
 				components,

package/src/shard-recipes/fr-fragment.ts

@@ -73,19 +73,30 @@ import { readFileSync } from "node:fs"
 import { decomposeFrStreet } from "../adapters/ban/street-decompose.ts"
 import { alignAndWrite, makeMulberry32, readTuples, type ShardRecipe, shardSourceID } from "./scaffold.ts"
 
-/** House numbers, weighted toward the small values that dominate real BAN rows. */
+/**
+ * House numbers, weighted toward the small values that dominate real BAN rows.
+ */
+/* oxlint-disable sister-software/no-unnamed-threshold -- the bare decimals below are weighted-sampler
+   cutoffs, not thresholds: `const r = random()` followed by a cascade of `r < 0.4` branches IS the
+   output distribution, and reading the cascade top-to-bottom is how you see it. Naming each cutoff
+   would hide the distribution behind a wall of identifiers. Genuine thresholds in these files are
+   extracted as named constants above. */
+
 const HOUSE_NUMBERS = [
 	1, 1, 2, 2, 3, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 14, 15, 16, 18, 20, 21, 24, 27, 30, 33, 42, 57, 68, 84, 102, 115, 140,
 ]
-/** FR alphanumeric house-number forms. `bis`/`ter` are separated; a bare letter is suffixed. */
+
+/**
+ * FR alphanumeric house-number forms. `bis`/`ter` are separated; a bare letter is suffixed.
+ */
 const ALNUM_SUFFIXES = ["bis", "ter", "A", "B"]
 
 const norm = (value: string): string =>
 	value
 		.normalize("NFD")
-		.replace(/[̀-ͯ]/g, "")
+		.replaceAll(/[̀-ͯ]/g, "")
 		.toLowerCase()
-		.replace(/\s+/g, " ")
+		.replaceAll(/\s+/g, " ")
 		.trim()
 
 /**
@@ -130,12 +141,21 @@ export function frTitleCase(value: string): string {
 		.join(" ")
 }
 
-/** Does the street name carry a particle? Decides the particle vs bare classification. */
+/**
+ * Does the street name carry a particle? Decides the particle vs bare classification.
+ */
 const PARTICLE = /\b(de la|de l'|du|des|de|d'|le|la|les)\b/i
-/** Does the street name carry date material (a year, or a day + French month)? */
+
+/**
+ * Does the street name carry date material (a year, or a day + French month)?
+ */
 const DATEISH =
 	/\b(1[0-9]|20)\d{2}\b|\b\d{1,2}\s+(janvier|f[ée]vrier|mars|avril|mai|juin|juillet|ao[ûu]t|septembre|octobre|novembre|d[ée]cembre)\b/i
 
+/**
+ * Shard 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.
+ */
 export const frFragmentRecipe: ShardRecipe = {
 	name: "fr-fragment",
 	description:
@@ -199,12 +219,14 @@ export const frFragmentRecipe: ShardRecipe = {
 
 			if (!fullStreet) {
 				skipped++
+
 				continue
 			}
 
 			// THE SPLIT. A surface on the fragment board never enters training.
 			if (excluded.has(norm(fullStreet))) {
 				contaminated++
+
 				continue
 			}
 
@@ -214,6 +236,7 @@ export const frFragmentRecipe: ShardRecipe = {
 			// is a different problem and would muddy the signal.
 			if (!prefix || !street) {
 				skipped++
+
 				continue
 			}
 
@@ -226,11 +249,13 @@ export const frFragmentRecipe: ShardRecipe = {
 				const number = HOUSE_NUMBERS[Math.floor(random() * HOUSE_NUMBERS.length)]!
 				const alnum = random() < 0.25
 				const suffix = ALNUM_SUFFIXES[Math.floor(random() * ALNUM_SUFFIXES.length)]!
+
 				const houseNumber = alnum
 					? suffix === "bis" || suffix === "ter"
 						? `${number} ${suffix}`
 						: `${number}${suffix}`
 					: String(number)
+
 				components.house_number = houseNumber
 				raw = `${houseNumber} ${prefix} ${street}`
 				klass = alnum ? "alnum-housenumber" : "street-housenumber"
@@ -260,11 +285,11 @@ export const frFragmentRecipe: ShardRecipe = {
 			}
 		}
 
-		// ---- the counter-distribution: bare localities, NO street anywhere in the row -------------
+		// MARK: counter-distribution — bare localities
 		// Minted last so the locality pool is complete. Without these the model can satisfy every row
 		// above by flipping its default from "bare => locality" to "bare => street", which trades one
 		// broken prior for another and would show up as bare-locality collapsing on the board.
-		const pool = [...localities].sort()
+		const pool = [...localities].toSorted()
 		const wanted = Math.round((emitted / Math.max(1, 1 - bareLocalityProb)) * bareLocalityProb)
 
 		for (let i = 0; i < wanted && pool.length; i++) {