@mailwoman/corpus 9.4.0 → 10.1.0

package/out/recipes/po/box/cedex/sources.js

@@ -0,0 +1,143 @@
+/**
+ * @copyright Sister Software
+ */
+import { isAuPostcode, isAuStateAbbreviation } from "@mailwoman/codex/au";
+import { isNZPostcode } from "@mailwoman/codex/nz";
+import { dataRootPath } from "@mailwoman/core/data-root";
+import { pathExists } from "@mailwoman/core/fs/readers";
+import { readZipEntry } from "@mailwoman/core/fs/zip";
+import { TextSpliterator, TSVSpliterator } from "spliterator";
+import { readCSVRecords, readZippedCSVRecords } from "#recipes/scaffold";
+/**
+ * Non-Vermont OpenAddresses files used for training rows.
+ */
+export const US_TRAIN_SOURCES = [
+    { zip: dataRootPath("oa-cache", "us__ca__berkeley.zip"), csv: "us/ca/berkeley.csv", region: "CA" },
+    { zip: dataRootPath("oa-cache", "us__ca__marin.zip"), csv: "us/ca/marin.csv", region: "CA" },
+    { zip: dataRootPath("oa-cache", "us__dc__statewide.zip"), csv: "us/dc/statewide.csv", region: "DC" },
+    { zip: dataRootPath("oa-cache", "us__ia__statewide.zip"), csv: "us/ia/statewide.csv", region: "IA" },
+    { zip: dataRootPath("oa-cache", "us__il__cook.zip"), csv: "us/il/cook.csv", region: "IL" },
+    { zip: dataRootPath("oa-cache", "us__mt__statewide.zip"), csv: "us/mt/statewide.csv", region: "MT" },
+    { zip: dataRootPath("oa-cache", "us__sd__statewide.zip"), csv: "us/sd/statewide.csv", region: "SD" },
+];
+/**
+ * Vermont OpenAddresses file reserved for golden rows.
+ */
+export const US_EVAL_SOURCE = {
+    zip: dataRootPath("oa-cache", "us__vt__statewide.zip"),
+    csv: "us/vt/statewide.csv",
+    region: "VT",
+};
+/**
+ * Countrywide French OpenAddresses source.
+ */
+export const FR_SOURCE = { zip: dataRootPath("oa-cache", "fr__countrywide.zip"), csv: "fr/countrywide.csv" };
+/**
+ * GeoNames Canada feature dump.
+ */
+export const GEONAMES_CA = dataRootPath("geonames", "CA.zip");
+/**
+ * GeoNames Australian postal-code dump.
+ */
+export const GEONAMES_POSTAL_AU = { zip: dataRootPath("geonames-postal", "AU.zip"), txt: "AU.txt" };
+/**
+ * GeoNames New Zealand postal-code dump.
+ */
+export const GEONAMES_POSTAL_NZ = { zip: dataRootPath("geonames-postal", "NZ.zip"), txt: "NZ.txt" };
+const MAX_LOCALITY_LENGTH = 40;
+const FR_STRIDE = 211;
+const FR_STRIDE_OFFSET = 3;
+const CA_LOCALITY_MIN_POPULATION = 1000;
+export const localityHash = (name) => {
+    let hash = 5381;
+    for (const character of name.toLowerCase()) {
+        hash = ((hash << 5) + hash + character.charCodeAt(0)) >>> 0;
+    }
+    return hash;
+};
+export const isHoldoutLocality = (name) => localityHash(name) % 10 === 0;
+const cleanLocality = (locality) => locality && locality.length <= MAX_LOCALITY_LENGTH && !/\d|,/.test(locality) && !/cedex/i.test(locality);
+export async function readUsTuples(source) {
+    const tuples = [];
+    const seen = new Set();
+    for await (const row of readZippedCSVRecords(source.zip, source.csv)) {
+        const locality = row.city ?? "";
+        if (!cleanLocality(locality))
+            continue;
+        const street = row.street ?? "";
+        const pairKey = `${locality}|${street}`.toLowerCase();
+        if (seen.has(pairKey))
+            continue;
+        seen.add(pairKey);
+        tuples.push({
+            house_number: row.number ?? "",
+            street,
+            locality,
+            region: source.region,
+            postcode: row.postcode ?? "",
+        });
+    }
+    return tuples;
+}
+export async function readFrTuples(limit) {
+    if (!(await pathExists(FR_SOURCE.zip))) {
+        console.error(`  WARN: ${FR_SOURCE.zip} is not cached — skipping ${FR_SOURCE.csv}`);
+        return [];
+    }
+    const encoder = new TextEncoder();
+    const strided = TextSpliterator.fromAsync(readZipEntry(FR_SOURCE.zip, FR_SOURCE.csv), { skipEmpty: false })
+        .filter((_line, index) => index === 0 || (index + 1) % FR_STRIDE === FR_STRIDE_OFFSET)
+        .take(limit + 1)
+        .map((line) => encoder.encode(line + "\n"));
+    const tuples = [];
+    const seen = new Set();
+    for await (const row of readCSVRecords(strided)) {
+        const locality = row.city ?? "", postcode = row.postcode ?? "", street = row.street ?? "", house_number = row.number ?? "";
+        if (!cleanLocality(locality) || !/^\d{5}$/.test(postcode) || !street || !house_number)
+            continue;
+        const key = `${locality}|${street}`.toLowerCase();
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        tuples.push({ house_number, street, locality, postcode });
+    }
+    return tuples;
+}
+export async function readCaLocalities(admin1) {
+    if (!(await pathExists(GEONAMES_CA))) {
+        console.error(`  WARN: ${GEONAMES_CA} is not cached — skipping CA localities (admin1=${admin1})`);
+        return [];
+    }
+    const localities = new Set();
+    for await (const columns of TSVSpliterator.fromAsync(readZipEntry(GEONAMES_CA, "CA.txt"), { header: false })) {
+        if (columns[6] === "P" &&
+            columns[8] === "CA" &&
+            columns[10] === admin1 &&
+            Number(columns[14]) > CA_LOCALITY_MIN_POPULATION &&
+            cleanLocality(columns[1] ?? "")) {
+            localities.add(columns[1]);
+        }
+    }
+    return [...localities];
+}
+export async function readPostalTuples(source, opts) {
+    if (!(await pathExists(source.zip))) {
+        console.error(`  WARN: ${source.zip} is not cached — skipping ${source.txt}`);
+        return [];
+    }
+    const tuples = [];
+    const seen = new Set();
+    const validPostcode = opts.withState ? isAuPostcode : isNZPostcode;
+    for await (const columns of TSVSpliterator.fromAsync(readZipEntry(source.zip, source.txt), { header: false })) {
+        const postcode = columns[1] ?? "", locality = columns[2] ?? "", region = columns[4] ?? "";
+        if (!cleanLocality(locality) || !validPostcode(postcode) || (opts.withState && !isAuStateAbbreviation(region)))
+            continue;
+        const key = `${locality}|${postcode}`.toLowerCase();
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        tuples.push(opts.withState ? { locality, region, postcode } : { locality, postcode });
+    }
+    return tuples;
+}
+//# sourceMappingURL=sources.js.map

package/out/recipes/po/box/cedex/sources.js.map

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

package/out/recipes/po/box/cedex/types.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @copyright Sister Software
+ */
+export interface USTuple {
+    house_number: string;
+    street: string;
+    locality: string;
+    region: string;
+    postcode: string;
+}
+export interface FRTuple {
+    house_number: string;
+    street: string;
+    locality: string;
+    postcode: string;
+}
+export interface AUTuple {
+    locality: string;
+    region: string;
+    postcode: string;
+}
+export interface NZTuple {
+    locality: string;
+    postcode: string;
+}
+export interface Rendered {
+    fmt: string;
+    raw: string;
+    components: Record<string, string>;
+}
+//# sourceMappingURL=types.d.ts.map

package/out/recipes/po/box/cedex/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../lib/recipes/po/box/cedex/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,OAAO;IACvB,YAAY,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,OAAO;IACvB,YAAY,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,OAAO;IACvB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,OAAO;IACvB,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,QAAQ;IACxB,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAClC"}

package/out/recipes/po/box/cedex/types.js

@@ -0,0 +1,5 @@
+/**
+ * @copyright Sister Software
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/out/recipes/po/box/cedex/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../lib/recipes/po/box/cedex/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/out/recipes/po/box/cedex/us.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @copyright Sister Software
+ */
+import type { Rendered, USTuple } from "#recipes/po/box/cedex/types";
+export declare function renderPoBoxUs(random: () => number, tuple: USTuple): Rendered;
+export declare function renderPmbUs(random: () => number, tuple: USTuple): Rendered;
+//# sourceMappingURL=us.d.ts.map

package/out/recipes/po/box/cedex/us.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"us.d.ts","sourceRoot":"","sources":["../../../../../lib/recipes/po/box/cedex/us.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAA;AAWpE,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,QAAQ,CAmC5E;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,QAAQ,CAc1E"}

package/out/recipes/po/box/cedex/us.js

@@ -0,0 +1,54 @@
+/**
+ * @copyright Sister Software
+ */
+/* oxlint-disable mailwoman/prefer-home -- this module is the US arm of the cedex recipe, identified by its path. Its
+ sibling arms cover the other countries. A layout call would answer the same string for the only country that reaches
+   it. */
+import { sample } from "@mailwoman/core/random";
+import { makePoBoxPhrase } from "#recipes/po/box/cedex/phrases";
+import { US_LEADERS_COMMON, US_LEADERS_RARE, US_PMB_LEADERS, VENUES_EN } from "#recipes/po/box/cedex/vocabulary";
+const US_FULL_CUTOFF = 0.4, US_NO_POSTCODE_CUTOFF = 0.55, US_BARE_CUTOFF = 0.75, US_VENUE_CUTOFF = 0.9;
+const PMB_AFTER_STREET_CUTOFF = 0.5, PMB_COMMA_CUTOFF = 0.85;
+export function renderPoBoxUs(random, tuple) {
+    const phrase = makePoBoxPhrase(random, US_LEADERS_COMMON, US_LEADERS_RARE);
+    const { locality, region, postcode } = tuple;
+    const base = { po_box: phrase, locality, region };
+    const draw = random();
+    if (draw < US_FULL_CUTOFF && postcode)
+        return { fmt: "full", raw: `${phrase}, ${locality}, ${region} ${postcode}`, components: { ...base, postcode } };
+    if (draw < US_NO_POSTCODE_CUTOFF)
+        return { fmt: "no-postcode", raw: `${phrase}, ${locality}, ${region}`, components: base };
+    if (draw < US_BARE_CUTOFF)
+        return { fmt: "bare", raw: phrase, components: { po_box: phrase } };
+    if (draw < US_VENUE_CUTOFF) {
+        const venue = sample(VENUES_EN, random);
+        return {
+            fmt: "venue",
+            raw: postcode
+                ? `${venue}, ${phrase}, ${locality}, ${region} ${postcode}`
+                : `${venue}, ${phrase}, ${locality}, ${region}`,
+            components: { venue, ...base, ...(postcode ? { postcode } : {}) },
+        };
+    }
+    const upper = (value) => value.toUpperCase();
+    return {
+        fmt: "label-nocomma",
+        raw: postcode
+            ? `${upper(phrase)} ${upper(locality)} ${region} ${postcode}`
+            : `${upper(phrase)} ${upper(locality)} ${region}`,
+        components: { po_box: upper(phrase), locality: upper(locality), region, ...(postcode ? { postcode } : {}) },
+    };
+}
+export function renderPmbUs(random, tuple) {
+    const phrase = makePoBoxPhrase(random, US_PMB_LEADERS);
+    const { house_number, street, locality, region, postcode } = tuple;
+    const road = `${house_number} ${street}`;
+    const components = { house_number, street, po_box: phrase, locality, region, postcode };
+    const draw = random();
+    if (draw < PMB_AFTER_STREET_CUTOFF)
+        return { fmt: "pmb-after-street", raw: `${road} ${phrase}, ${locality}, ${region} ${postcode}`, components };
+    if (draw < PMB_COMMA_CUTOFF)
+        return { fmt: "pmb-comma", raw: `${road}, ${phrase}, ${locality}, ${region} ${postcode}`, components };
+    return { fmt: "pmb-bare", raw: `${road} ${phrase}`, components: { house_number, street, po_box: phrase } };
+}
+//# sourceMappingURL=us.js.map

package/out/recipes/po/box/cedex/us.js.map

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

package/out/recipes/po/box/cedex/vocabulary.d.ts

@@ -0,0 +1,68 @@
+/**
+ * @copyright Sister Software
+ */
+/**
+ * Common US PO-box leaders from the en-US corpus template.
+ */
+export declare const US_LEADERS_COMMON: readonly string[];
+/**
+ * Less-common USPS designators derived from the codex list.
+ */
+export declare const US_LEADERS_RARE: string[];
+/**
+ * US private-mailbox leaders excluding the conflicting hash sign.
+ */
+export declare const US_PMB_LEADERS: string[];
+/**
+ * French PO-box leaders from the fr-FR corpus template.
+ */
+export declare const FR_LEADERS: readonly string[];
+/**
+ * French-language Canadian PO-box leaders from the fr-CA template.
+ */
+export declare const CA_FR_LEADERS: readonly string[];
+/**
+ * English-language Canadian PO-box leaders from the en-CA template.
+ */
+export declare const CA_EN_LEADERS: readonly string[];
+/**
+ * Current Australian delivery-service leaders.
+ */
+export declare const AU_LEADERS_CURRENT: string[];
+/**
+ * Recognized legacy Australian delivery-service leaders.
+ */
+export declare const AU_LEADERS_LEGACY: string[];
+/**
+ * Common New Zealand delivery-service leaders.
+ */
+export declare const NZ_LEADERS_COMMON: string[];
+/**
+ * Rare New Zealand delivery-service leader.
+ */
+export declare const NZ_LEADERS_RARE: string[];
+/**
+ * Quebec first-letter choices from the Canadian FSA prior.
+ */
+export declare const QC_FSA_LETTERS: string[];
+/**
+ * Ontario first-letter choices from the Canadian FSA prior.
+ */
+export declare const ON_FSA_LETTERS: string[];
+/**
+ * Valid Canadian postal-code interior letters.
+ */
+export declare const CA_INTERIOR_LETTERS = "ABCEGHJKLMNPRSTVWXYZ";
+/**
+ * Weighted country and address-form mix for generated rows.
+ */
+export declare const CLASS_MIX: ReadonlyArray<[string, number]>;
+/**
+ * English recipient prefixes used in venue layouts.
+ */
+export declare const VENUES_EN: string[];
+/**
+ * French recipient prefixes used in venue layouts.
+ */
+export declare const VENUES_FR: string[];
+//# sourceMappingURL=vocabulary.d.ts.map

package/out/recipes/po/box/cedex/vocabulary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vocabulary.d.ts","sourceRoot":"","sources":["../../../../../lib/recipes/po/box/cedex/vocabulary.ts"],"names":[],"mappings":"AAAA;;GAEG;AAWH;;GAEG;AACH,eAAO,MAAM,iBAAiB,mBAA8B,CAAA;AAE5D;;GAEG;AACH,eAAO,MAAM,eAAe,UAQ3B,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,UAA8D,CAAA;AACzF;;GAEG;AACH,eAAO,MAAM,UAAU,mBAA8B,CAAA;AACrD;;GAEG;AACH,eAAO,MAAM,aAAa,mBAA8B,CAAA;AACxD;;GAEG;AACH,eAAO,MAAM,aAAa,mBAA8B,CAAA;AACxD;;GAEG;AACH,eAAO,MAAM,kBAAkB,UAAoF,CAAA;AACnH;;GAEG;AACH,eAAO,MAAM,iBAAiB,UAAwB,CAAA;AACtD;;GAEG;AACH,eAAO,MAAM,iBAAiB,UAA4B,CAAA;AAC1D;;GAEG;AACH,eAAO,MAAM,eAAe,UAAU,CAAA;AAEtC;;GAEG;AACH,eAAO,MAAM,cAAc,UAEA,CAAA;AAE3B;;GAEG;AACH,eAAO,MAAM,cAAc,UAEA,CAAA;AAE3B;;GAEG;AACH,eAAO,MAAM,mBAAmB,yBAAyB,CAAA;AAEzD;;GAEG;AACH,eAAO,MAAM,SAAS,EAAE,aAAa,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAUrD,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,SAAS,UAAkG,CAAA;AACxH;;GAEG;AACH,eAAO,MAAM,SAAS,UAAiG,CAAA"}

package/out/recipes/po/box/cedex/vocabulary.js

@@ -0,0 +1,90 @@
+/**
+ * @copyright Sister Software
+ */
+import { FSA_LETTER_TO_PROVINCE } from "@mailwoman/codex/ca";
+import { US_PO_BOX_DESIGNATORS } from "@mailwoman/codex/us";
+import { PO_BOX_LOCALE_TEMPLATES } from "#synthesizers/po-box";
+const templates = Object.fromEntries(PO_BOX_LOCALE_TEMPLATES.map((template) => [template.locale, template]));
+/**
+ * Common US PO-box leaders from the en-US corpus template.
+ */
+export const US_LEADERS_COMMON = templates["en-US"].leaders;
+/**
+ * Less-common USPS designators derived from the codex list.
+ */
+export const US_LEADERS_RARE = US_PO_BOX_DESIGNATORS.filter((designator) => !["POST OFFICE BOX", "PO BOX", "P O BOX", "BOX"].includes(designator)).map((designator) => designator
+    .toLowerCase()
+    .split(" ")
+    .map((word) => `${word[0].toUpperCase()}${word.slice(1)}`)
+    .join(" "));
+/**
+ * US private-mailbox leaders excluding the conflicting hash sign.
+ */
+export const US_PMB_LEADERS = templates["en-US"].pmb.filter((leader) => leader !== "#");
+/**
+ * French PO-box leaders from the fr-FR corpus template.
+ */
+export const FR_LEADERS = templates["fr-FR"].leaders;
+/**
+ * French-language Canadian PO-box leaders from the fr-CA template.
+ */
+export const CA_FR_LEADERS = templates["fr-CA"].leaders;
+/**
+ * English-language Canadian PO-box leaders from the en-CA template.
+ */
+export const CA_EN_LEADERS = templates["en-CA"].leaders;
+/**
+ * Current Australian delivery-service leaders.
+ */
+export const AU_LEADERS_CURRENT = ["PO Box", "P.O. Box", "Post Office Box", "GPO Box", "Locked Bag", "Private Bag"];
+/**
+ * Recognized legacy Australian delivery-service leaders.
+ */
+export const AU_LEADERS_LEGACY = ["RMB", "RSD", "CMB"];
+/**
+ * Common New Zealand delivery-service leaders.
+ */
+export const NZ_LEADERS_COMMON = ["PO Box", "Private Bag"];
+/**
+ * Rare New Zealand delivery-service leader.
+ */
+export const NZ_LEADERS_RARE = ["CMB"];
+/**
+ * Quebec first-letter choices from the Canadian FSA prior.
+ */
+export const QC_FSA_LETTERS = Object.entries(FSA_LETTER_TO_PROVINCE)
+    .filter(([, province]) => province === "QC")
+    .map(([letter]) => letter);
+/**
+ * Ontario first-letter choices from the Canadian FSA prior.
+ */
+export const ON_FSA_LETTERS = Object.entries(FSA_LETTER_TO_PROVINCE)
+    .filter(([, province]) => province === "ON")
+    .map(([letter]) => letter);
+/**
+ * Valid Canadian postal-code interior letters.
+ */
+export const CA_INTERIOR_LETTERS = "ABCEGHJKLMNPRSTVWXYZ";
+/**
+ * Weighted country and address-form mix for generated rows.
+ */
+export const CLASS_MIX = [
+    ["po-box-us", 0.27],
+    ["po-box-us-military", 0.05],
+    ["pmb-us", 0.07],
+    ["bp-fr", 0.1],
+    ["cedex-fr", 0.17],
+    ["cp-ca-fr", 0.12],
+    ["po-box-ca-en", 0.04],
+    ["po-box-au", 0.12],
+    ["po-box-nz", 0.06],
+];
+/**
+ * English recipient prefixes used in venue layouts.
+ */
+export const VENUES_EN = ["John Doe", "Jane Smith", "Acme Inc", "Wayne Enterprises", "Maria Garcia", "Riverside Clinic"];
+/**
+ * French recipient prefixes used in venue layouts.
+ */
+export const VENUES_FR = ["Société Dupont", "Cabinet Martin", "Hôpital Central", "Mairie Annexe", "Imprimerie Moderne"];
+//# sourceMappingURL=vocabulary.js.map

package/out/recipes/po/box/cedex/vocabulary.js.map

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

package/out/recipes/po/box/cedex.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ * The recipe's implementation is partitioned by data source and postal system in `cedex/`.
+ */
+export { poBoxCedexRecipe } from "#recipes/po/box/cedex/recipe";
+//# sourceMappingURL=cedex.d.ts.map

package/out/recipes/po/box/cedex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cedex.d.ts","sourceRoot":"","sources":["../../../../lib/recipes/po/box/cedex.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA"}

package/out/recipes/po/box/cedex.js

@@ -0,0 +1,9 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ * The recipe's implementation is partitioned by data source and postal system in `cedex/`.
+ */
+export { poBoxCedexRecipe } from "#recipes/po/box/cedex/recipe";
+//# sourceMappingURL=cedex.js.map

package/out/recipes/po/box/cedex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cedex.js","sourceRoot":"","sources":["../../../../lib/recipes/po/box/cedex.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA"}

package/out/recipes/po/box.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `po-box` recipe, synthetic PO box rows: tuples → {@link synthesizePoBoxRow} → aligned
+ *   LabeledRow, plus optional self-contained US military/diplomatic rows at `--military-ratio`.
+ *   Region is required except for region-less locales (NZ).
+ */
+import { type CorpusRecipe } from "#recipes/scaffold";
+/**
+ * Recipe registered with the corpus builder.
+ *
+ * See the file header for the parse behavior this recipe exercises.
+ * See `description` below for the surface form it generates.
+ */
+export declare const poBoxRecipe: CorpusRecipe;
+//# sourceMappingURL=box.d.ts.map

package/out/recipes/po/box.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"box.d.ts","sourceRoot":"","sources":["../../../lib/recipes/po/box.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAKN,KAAK,YAAY,EACjB,MAAM,mBAAmB,CAAA;AAmB1B;;;;;GAKG;AACH,eAAO,MAAM,WAAW,EAAE,YAyGzB,CAAA"}

package/out/recipes/po/box.js

@@ -0,0 +1,123 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `po-box` recipe, synthetic PO box rows: tuples → {@link synthesizePoBoxRow} → aligned
+ *   LabeledRow, plus optional self-contained US military/diplomatic rows at `--military-ratio`.
+ *   Region is required except for region-less locales (NZ).
+ */
+import { makeLcg } from "@mailwoman/core/utils";
+import { alignAndWrite, readTuples, recipeSourceID, SYNTHETIC_TUPLE_LICENSE as LICENSE, } from "#recipes/scaffold";
+import { defaultRecipeSource } from "#recipes/sources";
+import { synthesizeMilitaryPoBoxRow, synthesizePoBoxRow } from "#synthesizers/po-box";
+import { SurfaceOrigin } from "#types";
+/**
+ * The box number is drawn rather than read, so no register asserts that this box exists.
+ *
+ * The locality, region and postcode around it come from the `--input` tuples.
+ * The row as a whole identifies no published record.
+ * The register field is null for that reason.
+ */
+const PO_BOX_PROVENANCE = {
+    register: null,
+    surface: SurfaceOrigin.Invented,
+    // An invented row has no underlying record to name.
+    baseSourceID: null,
+};
+/**
+ * Recipe registered with the corpus builder.
+ *
+ * See the file header for the parse behavior this recipe exercises.
+ * See `description` below for the surface form it generates.
+ */
+export const poBoxRecipe = {
+    name: "po-box",
+    description: "PO box rows: tuples → synthesizePoBoxRow (+ optional US military/diplomatic rows)",
+    mode: "tuples",
+    options: [
+        { flag: "--pmb-ratio <p>", description: "P(private-mailbox layout). Default 0.15" },
+        { flag: "--military-ratio <p>", description: "P(emit one US military/diplomatic row per input, #517). Default 0" },
+    ],
+    async run(opts, write) {
+        if (!opts.input)
+            throw new Error("po-box recipe requires --input <tuples.jsonl>");
+        const random = makeLcg(opts.seed);
+        const pmbRatio = opts.pmbRatio ?? 0.15;
+        const militaryRatio = opts.militaryRatio ?? 0;
+        // `--source-name` gives an output built for one class its own source label and its own reps per row.
+        // A military-only output (`--variants 0 --military-ratio 1`) would otherwise be
+        // indistinguishable from the leader-template rows in the mixture.
+        // The two classes have different weights.
+        const source = opts.sourceName ?? defaultRecipeSource("synth-po-box");
+        let read = 0;
+        let emitted = 0;
+        let skipped = 0;
+        for await (const tuple of readTuples(opts.input)) {
+            read++;
+            // Region is required except for region-less locales (NZ: "Private Bag 12, Auckland 1010").
+            const regionOptional = ["NZ", "NZL", "NEW ZEALAND"].includes(String(tuple.country || "").toUpperCase());
+            if (!tuple.locality || !tuple.postcode || !tuple.country || (!tuple.region && !regionOptional)) {
+                skipped++;
+                continue;
+            }
+            for (let v = 0; v < opts.variants; v++) {
+                const synth = synthesizePoBoxRow(tuple, { random, pmbRatio });
+                if (!synth)
+                    continue;
+                const ok = alignAndWrite(write, {
+                    raw: synth.raw,
+                    components: synth.components,
+                    country: tuple.country,
+                    locale: synth.locale,
+                    source,
+                    source_id: recipeSourceID(source, {
+                        locality: tuple.locality,
+                        region: tuple.region,
+                        postcode: tuple.postcode,
+                        country: tuple.country,
+                        v: String(v),
+                    }),
+                    corpus_version: "0.4.0",
+                    license: LICENSE,
+                }, synth.template, PO_BOX_PROVENANCE);
+                if (ok) {
+                    emitted++;
+                }
+                else {
+                    skipped++;
+                }
+            }
+            // US military/diplomatic rows, self-contained, one per input line at --military-ratio.
+            // The default of 0 keeps the output byte-stable, because random() is not called when the ratio is 0.
+            // US-only.
+            if (militaryRatio > 0 && random() < militaryRatio) {
+                const mil = synthesizeMilitaryPoBoxRow({ random });
+                const ok = alignAndWrite(write, {
+                    raw: mil.raw,
+                    components: mil.components,
+                    country: "US",
+                    locale: mil.locale,
+                    source,
+                    source_id: recipeSourceID(source, {
+                        po_box: mil.components.po_box,
+                        locality: mil.components.locality,
+                        region: mil.components.region,
+                        postcode: mil.components.postcode,
+                        v: `mil${emitted}`,
+                    }),
+                    corpus_version: "0.4.0",
+                    license: LICENSE,
+                }, mil.template, PO_BOX_PROVENANCE);
+                if (ok) {
+                    emitted++;
+                }
+                else {
+                    skipped++;
+                }
+            }
+        }
+        return { read, emitted, skipped };
+    },
+};
+//# sourceMappingURL=box.js.map

package/out/recipes/po/box.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"box.js","sourceRoot":"","sources":["../../../lib/recipes/po/box.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAA;AAE/C,OAAO,EACN,aAAa,EACb,UAAU,EACV,cAAc,EACd,uBAAuB,IAAI,OAAO,GAElC,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AACtD,OAAO,EAAE,0BAA0B,EAAE,kBAAkB,EAAuB,MAAM,sBAAsB,CAAA;AAC1G,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAA;AAEtC;;;;;;GAMG;AACH,MAAM,iBAAiB,GAAG;IACzB,QAAQ,EAAE,IAAI;IACd,OAAO,EAAE,aAAa,CAAC,QAAQ;IAC/B,oDAAoD;IACpD,YAAY,EAAE,IAAI;CAClB,CAAA;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAiB;IACxC,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,mFAAmF;IAChG,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE;QACR,EAAE,IAAI,EAAE,iBAAiB,EAAE,WAAW,EAAE,yCAAyC,EAAE;QACnF,EAAE,IAAI,EAAE,sBAAsB,EAAE,WAAW,EAAE,mEAAmE,EAAE;KAClH;IACD,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK;QACpB,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAA;QACjF,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAA;QACtC,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,IAAI,CAAC,CAAA;QAC7C,qGAAqG;QACrG,gFAAgF;QAChF,kEAAkE;QAClE,0CAA0C;QAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,IAAI,mBAAmB,CAAC,cAAc,CAAC,CAAA;QACrE,IAAI,IAAI,GAAG,CAAC,CAAA;QACZ,IAAI,OAAO,GAAG,CAAC,CAAA;QACf,IAAI,OAAO,GAAG,CAAC,CAAA;QAEf,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAClD,IAAI,EAAE,CAAA;YACN,2FAA2F;YAC3F,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAA;YAEvG,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC;gBAChG,OAAO,EAAE,CAAA;gBAET,SAAQ;YACT,CAAC;YAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;gBACxC,MAAM,KAAK,GAAG,kBAAkB,CAAC,KAAuB,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAA;gBAE/E,IAAI,CAAC,KAAK;oBAAE,SAAQ;gBAEpB,MAAM,EAAE,GAAG,aAAa,CACvB,KAAK,EACL;oBACC,GAAG,EAAE,KAAK,CAAC,GAAG;oBACd,UAAU,EAAE,KAAK,CAAC,UAAU;oBAC5B,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,MAAM,EAAE,KAAK,CAAC,MAAM;oBACpB,MAAM;oBACN,SAAS,EAAE,cAAc,CAAC,MAAM,EAAE;wBACjC,QAAQ,EAAE,KAAK,CAAC,QAAQ;wBACxB,MAAM,EAAE,KAAK,CAAC,MAAM;wBACpB,QAAQ,EAAE,KAAK,CAAC,QAAQ;wBACxB,OAAO,EAAE,KAAK,CAAC,OAAO;wBACtB,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;qBACZ,CAAC;oBACF,cAAc,EAAE,OAAO;oBACvB,OAAO,EAAE,OAAO;iBAChB,EACD,KAAK,CAAC,QAAQ,EACd,iBAAiB,CACjB,CAAA;gBAED,IAAI,EAAE,EAAE,CAAC;oBACR,OAAO,EAAE,CAAA;gBACV,CAAC;qBAAM,CAAC;oBACP,OAAO,EAAE,CAAA;gBACV,CAAC;YACF,CAAC;YAED,uFAAuF;YACvF,qGAAqG;YACrG,WAAW;YACX,IAAI,aAAa,GAAG,CAAC,IAAI,MAAM,EAAE,GAAG,aAAa,EAAE,CAAC;gBACnD,MAAM,GAAG,GAAG,0BAA0B,CAAC,EAAE,MAAM,EAAE,CAAC,CAAA;gBAElD,MAAM,EAAE,GAAG,aAAa,CACvB,KAAK,EACL;oBACC,GAAG,EAAE,GAAG,CAAC,GAAG;oBACZ,UAAU,EAAE,GAAG,CAAC,UAAU;oBAC1B,OAAO,EAAE,IAAI;oBACb,MAAM,EAAE,GAAG,CAAC,MAAM;oBAClB,MAAM;oBACN,SAAS,EAAE,cAAc,CAAC,MAAM,EAAE;wBACjC,MAAM,EAAE,GAAG,CAAC,UAAU,CAAC,MAAM;wBAC7B,QAAQ,EAAE,GAAG,CAAC,UAAU,CAAC,QAAQ;wBACjC,MAAM,EAAE,GAAG,CAAC,UAAU,CAAC,MAAM;wBAC7B,QAAQ,EAAE,GAAG,CAAC,UAAU,CAAC,QAAQ;wBACjC,CAAC,EAAE,MAAM,OAAO,EAAE;qBAClB,CAAC;oBACF,cAAc,EAAE,OAAO;oBACvB,OAAO,EAAE,OAAO;iBAChB,EACD,GAAG,CAAC,QAAQ,EACZ,iBAAiB,CACjB,CAAA;gBAED,IAAI,EAAE,EAAE,CAAC;oBACR,OAAO,EAAE,CAAA;gBACV,CAAC;qBAAM,CAAC;oBACP,OAAO,EAAE,CAAA;gBACV,CAAC;YACF,CAAC;QACF,CAAC;QAED,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAA;IAClC,CAAC;CACD,CAAA"}