@mailwoman/corpus 10.0.0 → 10.2.0

package/out/recipes/street/bare.js.map

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

package/out/recipes/street.d.ts

@@ -3,13 +3,15 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- *   `street` slice recipe — synthetic street-decomposition rows for Stage 3 (US-only): tuples →
- *   {@link synthesizeStreetRow} → aligned LabeledRow. Ported from scripts/build-street-slice.mjs.
+ *   `street` recipe — synthetic street-decomposition rows for Stage 3 (US-only): tuples →
+ *   {@link synthesizeStreetRow} → aligned LabeledRow. Ported from the root build script it replaced.
  */
 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.
+ *
+ * The file header describes the parse behavior this recipe exercises.
+ * `description` below shows the generated surface form.
  */
 export declare const streetRecipe: CorpusRecipe;
 //# sourceMappingURL=street.d.ts.map

package/out/recipes/street.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"street.d.ts","sourceRoot":"","sources":["../../lib/recipes/street.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,EAA6B,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAGhF;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,YA+D1B,CAAA"}
+{"version":3,"file":"street.d.ts","sourceRoot":"","sources":["../../lib/recipes/street.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,EAA6B,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAwBhF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,EAAE,YAkE1B,CAAA"}

package/out/recipes/street.js

@@ -3,16 +3,37 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- *   `street` slice recipe — synthetic street-decomposition rows for Stage 3 (US-only): tuples →
- *   {@link synthesizeStreetRow} → aligned LabeledRow. Ported from scripts/build-street-slice.mjs.
+ *   `street` recipe — synthetic street-decomposition rows for Stage 3 (US-only): tuples →
+ *   {@link synthesizeStreetRow} → aligned LabeledRow. Ported from the root build script it replaced.
  */
 import { makeLcg } from "@mailwoman/core/utils";
-import { stableSourceID } from "#adapters/utils";
+import { stableSourceID } from "#adapters/source-id";
 import { alignAndWrite, readTuples } from "#recipes/scaffold";
-import { synthesizeStreetRow } from "#synthesizers/street";
+import { defaultRecipeSource } from "#recipes/sources";
+import { SurfaceOrigin } from "#types";
+import { synthesizeStreetRow } from "#us/synthesizers/street";
 /**
- * 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.
+ * The recipe draws a street name from a pool and joins it to a tuple's locality, region and postcode.
+ *
+ * No register asserts that the street runs through that locality.
+ * The row is invented rather than a rendering of a published record.
+ */
+/**
+ * Resolved once, because `source_id` includes the source as its prefix and a pair
+ * that disagreed would name a source no row of this output declares.
+ */
+const STREET_SOURCE = defaultRecipeSource("synth-street");
+const STREET_PROVENANCE = {
+    register: null,
+    surface: SurfaceOrigin.Invented,
+    // An invented row has no underlying record to name.
+    baseSourceID: null,
+};
+/**
+ * Recipe registered with the corpus builder.
+ *
+ * The file header describes the parse behavior this recipe exercises.
+ * `description` below shows the generated surface form.
  */
 export const streetRecipe = {
     name: "street",
@@ -33,6 +54,8 @@ export const streetRecipe = {
                 skipped++;
                 continue;
             }
+            // country-branch: `synthesizeStreetRow` renders the US layout only.
+            // The codex layouts in the `locale` recipe cover the rest.
             if (tuple.country !== "US") {
                 skipped++;
                 continue;
@@ -46,8 +69,8 @@ export const streetRecipe = {
                     components: synth.components,
                     country: tuple.country,
                     locale: synth.locale,
-                    source: "synth-street",
-                    source_id: stableSourceID("synth-street", {
+                    source: STREET_SOURCE,
+                    source_id: stableSourceID(STREET_SOURCE, {
                         locality: `${tuple.locality}#${v}`,
                         region: tuple.region,
                         postcode: tuple.postcode,
@@ -55,7 +78,7 @@ export const streetRecipe = {
                     }),
                     corpus_version: "0.4.0",
                     license: "Synthetic — public-domain street name + tuple combination",
-                }, "street-decomp");
+                }, "street-decomp", STREET_PROVENANCE);
                 if (ok) {
                     emitted++;
                 }

package/out/recipes/street.js.map

@@ -1 +1 @@
-{"version":3,"file":"street.js","sourceRoot":"","sources":["../../lib/recipes/street.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAA;AAE/C,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,EAAE,aAAa,EAAE,UAAU,EAAqB,MAAM,mBAAmB,CAAA;AAChF,OAAO,EAAE,mBAAmB,EAAwB,MAAM,sBAAsB,CAAA;AAEhF;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAiB;IACzC,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,mFAAmF;IAChG,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,yBAAyB,EAAE,WAAW,EAAE,sCAAsC,EAAE,CAAC;IACnG,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,sBAAsB,GAAG,IAAI,CAAC,eAAe,IAAI,IAAI,CAAA;QAC3D,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;YAEN,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;gBAC3E,OAAO,EAAE,CAAA;gBAET,SAAQ;YACT,CAAC;YAED,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;gBAC5B,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,mBAAmB,CAAC,KAAwB,EAAE,EAAE,MAAM,EAAE,sBAAsB,EAAE,CAAC,CAAA;gBAE/F,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,EAAE,cAAc;oBACtB,SAAS,EAAE,cAAc,CAAC,cAAc,EAAE;wBACzC,QAAQ,EAAE,GAAG,KAAK,CAAC,QAAQ,IAAI,CAAC,EAAE;wBAClC,MAAM,EAAE,KAAK,CAAC,MAAM;wBACpB,QAAQ,EAAE,KAAK,CAAC,QAAQ;wBACxB,OAAO,EAAE,KAAK,CAAC,OAAO;qBACtB,CAAC;oBACF,cAAc,EAAE,OAAO;oBACvB,OAAO,EAAE,2DAA2D;iBACpE,EACD,eAAe,CACf,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"}
+{"version":3,"file":"street.js","sourceRoot":"","sources":["../../lib/recipes/street.ts"],"names":[],"mappings":"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"}

package/out/recipes/sub/venue/context.d.ts

@@ -5,20 +5,23 @@
  * @file Reads address context and derives street-side negatives for the sub-venue recipe.
  */
 import type { PathBuilderLike } from "path-ts";
-import type { LocaleBaseTuple } from "#synthesizers/locale";
+import type { LocaleBaseTuple } from "#surfaces/locale";
 /**
- * Load the address skeletons every leg renders onto: GB / US / FR from the house-venue v3 tuples (the same 176,519 real
- * rows the `synth-house-venue` slice is built from, so the two slices' address halves are drawn from one pool), DE and
- * ES streamed out of OpenAddresses.
+ * Load the address skeletons every leg renders onto: GB / US / FR from the house-venue v3 tuples
+ * (the same 176,519 real rows the `invented-house-venue` recipe output is built from, so the two
+ * recipes' address halves are drawn from one pool), DE and ES streamed out of OpenAddresses.
  */
 export declare function loadContextTuples(tuplesPath: PathBuilderLike, seed: number): Promise<Map<string, LocaleBaseTuple[]>>;
 /**
- * The street-side confound classes, mined from the leg's OWN address tuples.
+ * The street-side confound classes, mined from the leg's own address tuples.
  *
- * Real streets, not invented ones. The 176,519-row context pool carries 195 GB `hall` streets, 114 GB `gate` streets,
- * 134 distinct GB `-gate` single tokens and a two-figure `<modifier> <designator>` population in both GB and US — small
- * absolute numbers, but every one of them a street somebody lives on, which is the property an invented list cannot
- * have.
+ * Real streets rather than invented ones.
+ * The 176,519-row context pool includes 195 GB `hall` streets and 114 GB `gate` streets.
+ *
+ * It includes 134 distinct GB `-gate` tokens and a two-figure `<modifier> <designator>`
+ * population in both GB and US.
+ * Each item comes from a real address where someone lives.
+ * Each example comes from a real address tuple.
  */
 export interface StreetNegatives {
     designator: LocaleBaseTuple[];

package/out/recipes/sub/venue/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../../lib/recipes/sub/venue/context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAI9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAqB3D;;;;GAIG;AACH,wBAAsB,iBAAiB,CACtC,UAAU,EAAE,eAAe,EAC3B,IAAI,EAAE,MAAM,GACV,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC,CA2CzC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC/B,UAAU,EAAE,eAAe,EAAE,CAAA;IAC7B,kBAAkB,EAAE,eAAe,EAAE,CAAA;IACrC,UAAU,EAAE,eAAe,EAAE,CAAA;CAC7B;AAQD,wBAAgB,oBAAoB,CACnC,OAAO,EAAE,SAAS,eAAe,EAAE,EACnC,iBAAiB,EAAE,SAAS,MAAM,EAAE,EACpC,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,OAAO,EAAE,MAAM,GACb,eAAe,CAkCjB"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../../lib/recipes/sub/venue/context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAI9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAyBvD;;;;GAIG;AACH,wBAAsB,iBAAiB,CACtC,UAAU,EAAE,eAAe,EAC3B,IAAI,EAAE,MAAM,GACV,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC,CA2CzC;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,eAAe;IAC/B,UAAU,EAAE,eAAe,EAAE,CAAA;IAC7B,kBAAkB,EAAE,eAAe,EAAE,CAAA;IACrC,UAAU,EAAE,eAAe,EAAE,CAAA;CAC7B;AAQD,wBAAgB,oBAAoB,CACnC,OAAO,EAAE,SAAS,eAAe,EAAE,EACnC,iBAAiB,EAAE,SAAS,MAAM,EAAE,EACpC,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,OAAO,EAAE,MAAM,GACb,eAAe,CAoCjB"}

package/out/recipes/sub/venue/context.js

@@ -7,16 +7,20 @@
 import { dataRootPath } from "@mailwoman/core/data-root";
 import { mulberry32 as makeMulberry32 } from "@mailwoman/core/utils";
 import { readTuples as readLocaleTuples } from "#international/recipes/locale";
-import { readTuples as readSliceTuples } from "#recipes/scaffold";
-//#region Address context
+import { readTuples as readRecipeTuples } from "#recipes/scaffold";
+// #region Address context
 /**
- * DE + ES address context. Both read through {@link readLocaleTuples}, the `locale` recipe's own streaming + reservoir
- * reader, so the CSV handling (quoted fields, CRLF, city-noise cleaning, the DE per-part region fallback) has exactly
- * one implementation.
+ * DE + ES address context.
  *
- * DE reads `europe.zip`'s two members rather than `oa-cache/de__*.zip`: the cached per-state zips the `locale` recipe
- * names are not materialized on this host, and the archive members are byte-identical to OA's current run (verified in
- * `corpus/AGENTS.md`'s "a file's mtime is not its data's vintage" note).
+ * Both read through {@link readLocaleTuples}, the `locale` recipe's own streaming + reservoir reader,
+ * so the CSV handling (quoted fields, crlf, city-noise cleaning, the DE per-part region fallback)
+ * has exactly one implementation.
+ *
+ * The DE adapter reads two members from `europe.zip` instead of `oa-cache/de__*.zip`.
+ * The cached per-state zips used by the `locale` recipe are absent on this host.
+ *
+ * The archive members match OA's current run byte for byte.
+ * The note "a file's mtime is not its data's vintage" in `corpus/agents.md` records this comparison.
  */
 const CONTEXT_PARTS = {
     DE: [
@@ -26,13 +30,13 @@ const CONTEXT_PARTS = {
     ES: [{ path: dataRootPath("openaddresses", "extracted", "es", "countrywide.csv") }],
 };
 /**
- * Load the address skeletons every leg renders onto: GB / US / FR from the house-venue v3 tuples (the same 176,519 real
- * rows the `synth-house-venue` slice is built from, so the two slices' address halves are drawn from one pool), DE and
- * ES streamed out of OpenAddresses.
+ * Load the address skeletons every leg renders onto: GB / US / FR from the house-venue v3 tuples
+ * (the same 176,519 real rows the `invented-house-venue` recipe output is built from, so the two
+ * recipes' address halves are drawn from one pool), DE and ES streamed out of OpenAddresses.
  */
 export async function loadContextTuples(tuplesPath, seed) {
     const byCountry = new Map();
-    for await (const tuple of readSliceTuples(tuplesPath)) {
+    for await (const tuple of readRecipeTuples(tuplesPath)) {
         const country = String(tuple.country ?? "");
         if (!country || !tuple.locality || !tuple.street)
             continue;
@@ -56,8 +60,8 @@ export async function loadContextTuples(tuplesPath, seed) {
             continue;
         const pooled = [];
         for (const [index, part] of parts.entries()) {
-            // A dedicated stream PRNG, seeded per part, so the input sample is reproducible without
-            // perturbing the emit loop's draws (the `locale` recipe's rule, kept).
+            // A dedicated stream prng, seeded per part, so the input sample is reproducible
+            // without perturbing the emit loop's draws (the `locale` recipe's rule, kept).
             const streamRandom = makeMulberry32(seed + index);
             for (const tuple of await readLocaleTuples(part, streamRandom)) {
                 pooled.push(tuple);
@@ -68,8 +72,8 @@ export async function loadContextTuples(tuplesPath, seed) {
     return byCountry;
 }
 /**
- * Shortest token that can carry a `-gate` street suffix and still be a NAME rather than the bare word: `gate` itself is
- * four characters, so the class starts at five (`Highgate`, `Moorgate`, `Stonegate`).
+ * Shortest token that can take a `-gate` street suffix and still be a name rather than the bare word:
+ * `gate` itself is four characters, so the class starts at five (`Highgate`, `Moorgate`, `Stonegate`).
  */
 const MIN_GATE_SUFFIX_TOKEN_LENGTH = 5;
 export function buildStreetNegatives(context, designatorPhrases, modifiers, country) {
@@ -89,6 +93,8 @@ export function buildStreetNegatives(context, designatorPhrases, modifiers, coun
             if (index + 1 < tokens.length && modifierSet.has(token) && designatorSet.has(tokens[index + 1])) {
                 isPair = true;
             }
+            // country-branch: `-gate` is a street-name suffix in British English only.
+            // The street-morphology FST per locale would replace it.
             if (country === "GB" && token.length >= MIN_GATE_SUFFIX_TOKEN_LENGTH && token.endsWith("gate")) {
                 gateSuffix.push(tuple);
             }
@@ -102,5 +108,5 @@ export function buildStreetNegatives(context, designatorPhrases, modifiers, coun
     }
     return { designator, modifierDesignator, gateSuffix };
 }
-//#endregion
+// #endregion
 //# sourceMappingURL=context.js.map

package/out/recipes/sub/venue/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../../lib/recipes/sub/venue/context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AACxD,OAAO,EAAE,UAAU,IAAI,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAGpE,OAAO,EAAE,UAAU,IAAI,gBAAgB,EAAmB,MAAM,+BAA+B,CAAA;AAC/F,OAAO,EAAE,UAAU,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAGjE,yBAAyB;AAEzB;;;;;;;;GAQG;AACH,MAAM,aAAa,GAAoD;IACtE,EAAE,EAAE;QACH,EAAE,GAAG,EAAE,YAAY,CAAC,eAAe,EAAE,YAAY,CAAC,EAAE,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE;QAC5F,EAAE,GAAG,EAAE,YAAY,CAAC,eAAe,EAAE,YAAY,CAAC,EAAE,GAAG,EAAE,qBAAqB,EAAE,MAAM,EAAE,SAAS,EAAE;KACnG;IACD,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,YAAY,CAAC,eAAe,EAAE,WAAW,EAAE,IAAI,EAAE,iBAAiB,CAAC,EAAE,CAAC;CACnF,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACtC,UAA2B,EAC3B,IAAY;IAEZ,MAAM,SAAS,GAAG,IAAI,GAAG,EAA6B,CAAA;IAEtD,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,eAAe,CAAC,UAAU,CAAC,EAAE,CAAC;QACvD,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAA;QAE3C,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,MAAM;YAAE,SAAQ;QAE1D,MAAM,MAAM,GAAoB;YAC/B,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC;YACnE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC;YAC5B,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC;YAChC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC;YAClC,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;SACtC,CAAA;QAED,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QAEnC,IAAI,IAAI,EAAE,CAAC;YACV,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAClB,CAAC;aAAM,CAAC;YACP,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;QACjC,CAAC;IACF,CAAC;IAED,KAAK,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;QAC9D,IAAI,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC;YAAE,SAAQ;QACpC,MAAM,MAAM,GAAsB,EAAE,CAAA;QAEpC,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YAC7C,wFAAwF;YACxF,uEAAuE;YACvE,MAAM,YAAY,GAAG,cAAc,CAAC,IAAI,GAAG,KAAK,CAAC,CAAA;YAEjD,KAAK,MAAM,KAAK,IAAI,MAAM,gBAAgB,CAAC,IAAI,EAAE,YAAY,CAAC,EAAE,CAAC;gBAChE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YACnB,CAAC;QACF,CAAC;QAED,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;IAC/B,CAAC;IAED,OAAO,SAAS,CAAA;AACjB,CAAC;AAgBD;;;GAGG;AACH,MAAM,4BAA4B,GAAG,CAAC,CAAA;AAEtC,MAAM,UAAU,oBAAoB,CACnC,OAAmC,EACnC,iBAAoC,EACpC,SAA4B,EAC5B,OAAe;IAEf,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,iBAAiB,CAAC,CAAA;IAChD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAA;IACtC,MAAM,UAAU,GAAsB,EAAE,CAAA;IACxC,MAAM,kBAAkB,GAAsB,EAAE,CAAA;IAChD,MAAM,UAAU,GAAsB,EAAE,CAAA;IAExC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,CAAA;QACnE,IAAI,YAAY,GAAG,KAAK,CAAA;QACxB,IAAI,MAAM,GAAG,KAAK,CAAA;QAElB,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;YAC/C,IAAI,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC9B,YAAY,GAAG,IAAI,CAAA;YACpB,CAAC;YAED,IAAI,KAAK,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,IAAI,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAE,CAAC,EAAE,CAAC;gBAClG,MAAM,GAAG,IAAI,CAAA;YACd,CAAC;YAED,IAAI,OAAO,KAAK,IAAI,IAAI,KAAK,CAAC,MAAM,IAAI,4BAA4B,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBAChG,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YACvB,CAAC;QACF,CAAC;QAED,IAAI,MAAM,EAAE,CAAC;YACZ,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC/B,CAAC;aAAM,IAAI,YAAY,EAAE,CAAC;YACzB,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACvB,CAAC;IACF,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,UAAU,EAAE,CAAA;AACtD,CAAC;AAED,YAAY"}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../../lib/recipes/sub/venue/context.ts"],"names":[],"mappings":"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"}

package/out/recipes/sub/venue/render.d.ts

@@ -0,0 +1,58 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ * @file Renders labeled pieces into sub-venue rows in a sampled case register and a per-country address order.
+ */
+import type { ComponentTag } from "@mailwoman/codex/component";
+import type { LocaleBaseTuple } from "#surfaces/locale";
+/**
+ * One labeled piece of a row.
+ *
+ * Pieces inside a group are joined with a space.
+ * Groups are joined with the register's separator.
+ */
+export interface Piece {
+    text: string;
+    tag?: ComponentTag;
+}
+/**
+ * A run of pieces that share one comma segment.
+ */
+export type Group = Piece[];
+/**
+ * The case and punctuation style of a rendered row.
+ *
+ * Users often type addresses in lowercase, so every recipe output includes lowercase rows.
+ */
+export declare const Register: {
+    readonly Canonical: "canonical";
+    readonly CommaFree: "comma-free";
+    readonly Lower: "lower";
+    readonly Upper: "upper";
+};
+/**
+ * One of the {@link Register} values.
+ */
+export type Register = (typeof Register)[keyof typeof Register];
+/**
+ * Samples a register with the fixed shares above.
+ */
+export declare function sampleRegister(random: () => number): Register;
+/**
+ * Joins groups into `raw` and `components`.
+ *
+ * The register's case change applies to both so that alignment still finds every component value in `raw`.
+ */
+export declare function renderGroups(groups: Group[], register: Register): {
+    raw: string;
+    components: Partial<Record<ComponentTag, string>>;
+};
+/**
+ * Returns the street and locality groups for a country in the order of its codex address layout.
+ *
+ * The function splits the rendered layout at comma and line-break connectors.
+ * It returns an empty list when codex has no Latin-script layout for the country.
+ */
+export declare function addressGroups(country: string, tuple: LocaleBaseTuple, withStreet: boolean): Group[];
+//# sourceMappingURL=render.d.ts.map

package/out/recipes/sub/venue/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../../lib/recipes/sub/venue/render.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAG9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAEvD;;;;;GAKG;AACH,MAAM,WAAW,KAAK;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,YAAY,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG,KAAK,EAAE,CAAA;AAE3B;;;;GAIG;AACH,eAAO,MAAM,QAAQ;aACpB,SAAS,EAAE,WAAW;aACtB,SAAS,EAAE,YAAY;aACvB,KAAK,EAAE,OAAO;aACd,KAAK,EAAE,OAAO;CACL,CAAA;AAEV;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAA;AAO/D;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,MAAM,GAAG,QAAQ,CAU7D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC3B,MAAM,EAAE,KAAK,EAAE,EACf,QAAQ,EAAE,QAAQ,GAChB;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAA;CAAE,CA2BpE;AAOD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,OAAO,GAAG,KAAK,EAAE,CAsDnG"}

package/out/recipes/sub/venue/render.js

@@ -0,0 +1,118 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ * @file Renders labeled pieces into sub-venue rows in a sampled case register and a per-country address order.
+ */
+import { layoutForCountry } from "@mailwoman/codex/address/layouts";
+import { renderAddress } from "@mailwoman/codex/address/render";
+import { isPresent } from "@mailwoman/core/objects";
+/**
+ * The case and punctuation style of a rendered row.
+ *
+ * Users often type addresses in lowercase, so every recipe output includes lowercase rows.
+ */
+export const Register = {
+    Canonical: "canonical",
+    CommaFree: "comma-free",
+    Lower: "lower",
+    Upper: "upper",
+};
+// The cutoffs are cumulative: 45% canonical, 20% comma-free, 25% lower and 10% upper.
+const CANONICAL_REGISTER_CUTOFF = 0.45;
+const COMMA_FREE_REGISTER_CUTOFF = 0.65;
+const LOWER_REGISTER_CUTOFF = 0.9;
+/**
+ * Samples a register with the fixed shares above.
+ */
+export function sampleRegister(random) {
+    const r = random();
+    if (r < CANONICAL_REGISTER_CUTOFF)
+        return Register.Canonical;
+    if (r < COMMA_FREE_REGISTER_CUTOFF)
+        return Register.CommaFree;
+    if (r < LOWER_REGISTER_CUTOFF)
+        return Register.Lower;
+    return Register.Upper;
+}
+/**
+ * Joins groups into `raw` and `components`.
+ *
+ * The register's case change applies to both so that alignment still finds every component value in `raw`.
+ */
+export function renderGroups(groups, register) {
+    const fold = (text) => {
+        if (register === Register.Lower)
+            return text.toLowerCase();
+        if (register === Register.Upper)
+            return text.toUpperCase();
+        return text;
+    };
+    const separator = register === Register.CommaFree ? " " : ", ";
+    const raw = groups
+        .map((group) => group.map((piece) => fold(piece.text)).join(" "))
+        .filter(isPresent)
+        .join(separator);
+    const components = {};
+    for (const group of groups) {
+        for (const piece of group) {
+            if (piece.tag && !components[piece.tag]) {
+                components[piece.tag] = fold(piece.text);
+            }
+        }
+    }
+    return { raw, components };
+}
+/**
+ * Layout connectors that end a group.
+ */
+const GROUP_BREAK = new Set([", ", "\n"]);
+/**
+ * Returns the street and locality groups for a country in the order of its codex address layout.
+ *
+ * The function splits the rendered layout at comma and line-break connectors.
+ * It returns an empty list when codex has no Latin-script layout for the country.
+ */
+export function addressGroups(country, tuple, withStreet) {
+    const components = {};
+    const street = tuple.street.trim();
+    const houseNumber = tuple.house_number?.trim();
+    if (withStreet && street) {
+        components.street = street;
+        if (houseNumber) {
+            components.house_number = houseNumber;
+        }
+    }
+    const locality = tuple.locality.trim();
+    const postcode = tuple.postcode?.trim();
+    const region = tuple.region?.trim();
+    if (locality) {
+        components.locality = locality;
+    }
+    if (postcode) {
+        components.postcode = postcode;
+    }
+    if (region) {
+        components.region = region;
+    }
+    const layout = layoutForCountry(country, "latin");
+    if (!layout)
+        return [];
+    const groups = [];
+    let current = [];
+    for (const piece of renderAddress(layout, components).pieces) {
+        if (!piece.tag) {
+            if (GROUP_BREAK.has(piece.text) && current.length) {
+                groups.push(current);
+                current = [];
+            }
+            continue;
+        }
+        current.push({ text: piece.text, tag: piece.tag });
+    }
+    if (current.length) {
+        groups.push(current);
+    }
+    return groups;
+}
+//# sourceMappingURL=render.js.map

package/out/recipes/sub/venue/render.js.map

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