@mailwoman/corpus 10.6.0 → 10.7.0

package/out/us/adapters/usgov/nad/adapter.d.ts

@@ -14,6 +14,86 @@ export declare const USGOV_NAD_ADAPTER_ID = "usgov-nad";
  * The license label on every emitted row, because US federal works are public domain under 17 U.S.C. § 105.
  */
 export declare const USGOV_NAD_DEFAULT_LICENSE = "Public Domain";
+/**
+ * One NAD address point as the FeatureServer pages publish it, limited to the fields a reader here uses.
+ */
+export interface NADRecord {
+    OBJECTID?: number;
+    UUID?: string | null;
+    AddNum_Pre?: string | null;
+    Add_Number?: number | string | null;
+    AddNum_Suf?: string | null;
+    AddNo_Full?: string | null;
+    St_PreMod?: string | null;
+    St_PreDir?: string | null;
+    St_PreTyp?: string | null;
+    St_PreSep?: string | null;
+    St_Name?: string | null;
+    St_PosTyp?: string | null;
+    St_PosDir?: string | null;
+    St_PosMod?: string | null;
+    StNam_Full?: string | null;
+    Building?: string | null;
+    Floor?: string | null;
+    Unit?: string | null;
+    Room?: string | null;
+    Seat?: string | null;
+    Addtl_Loc?: string | null;
+    SubAddress?: string | null;
+    LandmkName?: string | null;
+    County?: string | null;
+    Inc_Muni?: string | null;
+    Post_City?: string | null;
+    Census_Plc?: string | null;
+    Uninc_Comm?: string | null;
+    Nbrhd_Comm?: string | null;
+    NatAmArea?: string | null;
+    NatAmSub?: string | null;
+    Urbnztn_PR?: string | null;
+    PlaceOther?: string | null;
+    PlaceNmTyp?: string | null;
+    State?: string | null;
+    Zip_Code?: string | null;
+    Plus_4?: string | null;
+}
+/**
+ * The house number a NAD record states, read from its own four columns.
+ *
+ * NAD publishes `AddNo_Full` already assembled and the parts beside it, so this prefers the
+ * assembled column and falls back to joining `AddNum_Pre`, `Add_Number` and `AddNum_Suf`.
+ * The shared `composeHouseNumber` in `#adapters/street-line` joins exactly two columns with
+ * one separator, so it fits a publisher that splits the number in two rather than in four.
+ */
+export declare function nadHouseNumber(r: NADRecord): string | null;
+/**
+ * A NAD street split into the prefix, name and suffix its structured columns state,
+ * with the whole street beside them.
+ */
+export interface DecomposedNADStreet {
+    prefix?: string;
+    street?: string;
+    suffix?: string;
+    full: string;
+}
+/**
+ * The street a NAD record states.
+ *
+ * Structured street fields take precedence.
+ * If they are empty, `StNam_Full` supplies the whole street.
+ */
+export declare function decomposeNADStreet(r: NADRecord): DecomposedNADStreet | null;
+/**
+ * The locality a NAD record states.
+ *
+ * The postal city comes first because it is the name that people write on mail.
+ * NAD fills an unknown `Post_City` with the domain value `Not stated`
+ * (99,998 rows of a 100,000-row Massachusetts sample and 11,713 of a Texas one), and an address
+ * outside any municipality has `Inc_Muni` `Unincorporated` (the same 11,713 Texas rows).
+ *
+ * Another 23 rows of that Texas sample read `0`.
+ * Each of these values counts as absent, and the next column supplies the place name.
+ */
+export declare function composeNADLocality(r: NADRecord): string | null;
 /**
  * Creates the NAD adapter.
  *

package/out/us/adapters/usgov/nad/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../../lib/us/adapters/usgov/nad/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH,OAAO,EAAuD,KAAK,aAAa,EAAiB,MAAM,QAAQ,CAAA;AAE/G;;GAEG;AACH,eAAO,MAAM,oBAAoB,cAAc,CAAA;AAC/C;;GAEG;AACH,eAAO,MAAM,yBAAyB,kBAAkB,CAAA;AAiIxD;;;;;GAKG;AACH,wBAAgB,qBAAqB,IAAI,aAAa,CAgGrD;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,eAA0B,CAAA"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../../lib/us/adapters/usgov/nad/adapter.ts"],"names":[],"mappings":"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"}

package/out/us/adapters/usgov/nad/adapter.js

@@ -47,7 +47,7 @@ function nonEmpty(...values) {
  * The shared `composeHouseNumber` in `#adapters/street-line` joins exactly two columns with
  * one separator, so it fits a publisher that splits the number in two rather than in four.
  */
-function nadHouseNumber(r) {
+export function nadHouseNumber(r) {
     const full = (r.AddNo_Full ?? "").toString().trim();
     if (full)
         return full;
@@ -58,9 +58,13 @@ function nadHouseNumber(r) {
     const suf = (r.AddNum_Suf ?? "").toString().trim();
     return [pre, num, suf].filter(isPresent).join(" ").trim() || null;
 }
-// Structured street fields take precedence.
-// If they are empty, `StNam_Full` supplies the whole street.
-function decomposeNADStreet(r) {
+/**
+ * The street a NAD record states.
+ *
+ * Structured street fields take precedence.
+ * If they are empty, `StNam_Full` supplies the whole street.
+ */
+export function decomposeNADStreet(r) {
     const name = (r.St_Name ?? "").toString().trim();
     if (name) {
         const preDir = (r.St_PreDir ?? "").toString().trim();
@@ -78,9 +82,24 @@ function decomposeNADStreet(r) {
         return { full, street: full };
     return null;
 }
-// The postal city comes first because it is the name that people write on mail.
-function composeLocality(r) {
-    return nonEmpty(r.Post_City, r.Inc_Muni, r.Census_Plc, r.Uninc_Comm);
+/**
+ * The NAD domain values that fill a place-name column without naming a place, lower-cased.
+ */
+const NAD_PLACEHOLDER_PLACE_NAMES = new Set(["not stated", "unincorporated", "0"]);
+/**
+ * The locality a NAD record states.
+ *
+ * The postal city comes first because it is the name that people write on mail.
+ * NAD fills an unknown `Post_City` with the domain value `Not stated`
+ * (99,998 rows of a 100,000-row Massachusetts sample and 11,713 of a Texas one), and an address
+ * outside any municipality has `Inc_Muni` `Unincorporated` (the same 11,713 Texas rows).
+ *
+ * Another 23 rows of that Texas sample read `0`.
+ * Each of these values counts as absent, and the next column supplies the place name.
+ */
+export function composeNADLocality(r) {
+    const stated = (value) => NAD_PLACEHOLDER_PLACE_NAMES.has(value?.trim().toLowerCase() ?? "") ? null : value;
+    return nonEmpty(stated(r.Post_City), stated(r.Inc_Muni), stated(r.Census_Plc), stated(r.Uninc_Comm));
 }
 function composePostcode(r) {
     const zip = (r.Zip_Code ?? "").toString().trim();
@@ -132,7 +151,7 @@ export function createUsgovNADAdapter() {
                     const state = (record.State ?? "").toString().trim().toUpperCase();
                     if (!US_STATES_SET.has(state))
                         continue;
-                    const locality = composeLocality(record);
+                    const locality = composeNADLocality(record);
                     if (!locality)
                         continue;
                     const postcode = composePostcode(record);

package/out/us/adapters/usgov/nad/adapter.js.map

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

package/out/us/recipes/skeleton-sources.d.ts

@@ -0,0 +1,92 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ * @file The US address skeletons the OA-shaped recipes read: two elected OpenAddresses extracts and one
+ *   National Address Database sample per chosen state, with Vermont held out for the golden sets.
+ *
+ *   `unit`, `street-affix`, `suffix-boundary`, `po-box-cedex` and `country-balanced` read these files
+ *   through the same zipped-CSV reader, so a NAD sample is written in OpenAddresses' column layout by
+ *   `packages/mailwoman/tools/dev-tools/corpus/nad-skeletons.run.ts`.
+ */
+import type { PathBuilderLike } from "path-ts";
+/**
+ * The register a skeleton file's rows were published in.
+ *
+ * It prefixes the `base_source_id` a recipe derives from the file.
+ */
+export declare const USSkeletonRegister: {
+    readonly OpenAddresses: "openaddresses";
+    readonly NationalAddressDatabase: "usgov-nad";
+};
+export type USSkeletonRegister = (typeof USSkeletonRegister)[keyof typeof USSkeletonRegister];
+/**
+ * One cached US skeleton file: the zip, its CSV member and the region every row of it lies in.
+ */
+export interface USSkeletonSource {
+    zip: PathBuilderLike;
+    csv: string;
+    region: string;
+    register: USSkeletonRegister;
+}
+/**
+ * The data-root directory holding the NAD samples and ZIP-to-city tables the NAD skeleton tool writes.
+ */
+export declare const NAD_SKELETON_DIRECTORY = "nad-skeletons";
+/**
+ * The states sampled from NAD, chosen for address shapes the OpenAddresses files lack
+ * rather than for row count.
+ *
+ * Distinct tuples of those six files carry a unit on 0.6% of rows, and none has
+ * a hyphenated or direction-prefixed house number.
+ *
+ * Each comment states the shape measured over the usable rows of the FeatureServer
+ * pages fetched on 2026-05-18.
+ * `nad-skeletons.run.ts` prints the table for every state.
+ *
+ * Vermont is absent because it is the eval holdout.
+ * No state's rows match a rural-route street pattern, so NAD adds no rural-route form.
+ */
+export declare const NAD_SKELETON_STATES: readonly ["IL", "MA", "UT", "WI", "NY", "TX"];
+/**
+ * The zip and CSV member the NAD skeleton tool writes for one state.
+ */
+export declare function nadSkeletonFile(region: string): {
+    zip: PathBuilderLike;
+    csv: string;
+};
+/**
+ * The NAD skeleton file for every state in {@link NAD_SKELETON_STATES}.
+ */
+export declare const NAD_SKELETON_SOURCES: readonly USSkeletonSource[];
+/**
+ * The cached OpenAddresses US extracts used for training.
+ *
+ * `us/il/cook` is absent because Cook County's terms restrict redistribution.
+ * NAD's Illinois sample stands in for its city grid.
+ */
+export declare const OA_SKELETON_TRAIN_SOURCES: readonly USSkeletonSource[];
+/**
+ * Every US training skeleton: the OpenAddresses extracts and the NAD samples.
+ */
+export declare const US_SKELETON_TRAIN_SOURCES: readonly USSkeletonSource[];
+/**
+ * Vermont, the corpus holdout — `--golden` reads this and no other US source.
+ */
+export declare const US_SKELETON_EVAL_SOURCE: USSkeletonSource;
+/**
+ * A county whose NAD rows give the ZIP-to-city table the `intersection` recipe renders city tails from.
+ */
+export interface NADZipCityCounty {
+    region: string;
+    county: string;
+}
+/**
+ * The counties of the `intersection` recipe's TIGER training crossings, Cook IL and Morris NJ.
+ */
+export declare const NAD_ZIP_CITY_COUNTIES: readonly NADZipCityCounty[];
+/**
+ * The ZIP-to-city CSV the NAD skeleton tool writes for one county.
+ */
+export declare function nadZipCityPath(entry: NADZipCityCounty): PathBuilderLike;
+//# sourceMappingURL=skeleton-sources.d.ts.map

package/out/us/recipes/skeleton-sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skeleton-sources.d.ts","sourceRoot":"","sources":["../../../lib/us/recipes/skeleton-sources.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE9C;;;;GAIG;AACH,eAAO,MAAM,kBAAkB;aAC9B,aAAa,EAAE,eAAe;aAC9B,uBAAuB,EAAE,WAAW;CAC3B,CAAA;AAEV,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAA;AAE7F;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,GAAG,EAAE,eAAe,CAAA;IACpB,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,kBAAkB,CAAA;CAC5B;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,kBAAkB,CAAA;AAErD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,mBAAmB,YAE/B,IAAI,EAEJ,IAAI,EAEJ,IAAI,EAEJ,IAAI,EAEJ,IAAI,EAEJ,IAAI,CACK,CAAA;AAEV;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,eAAe,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAOrF;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,gBAAgB,EAIzD,CAAA;AAEH;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,EAAE,SAAS,gBAAgB,EAc9D,CAAA;AAEH;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,SAAS,gBAAgB,EAGhE,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,gBAKrC,CAAA;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;CACd;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,SAAS,gBAAgB,EAG5D,CAAA;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,gBAAgB,GAAG,eAAe,CAIvE"}

package/out/us/recipes/skeleton-sources.js

@@ -0,0 +1,121 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ * @file The US address skeletons the OA-shaped recipes read: two elected OpenAddresses extracts and one
+ *   National Address Database sample per chosen state, with Vermont held out for the golden sets.
+ *
+ *   `unit`, `street-affix`, `suffix-boundary`, `po-box-cedex` and `country-balanced` read these files
+ *   through the same zipped-CSV reader, so a NAD sample is written in OpenAddresses' column layout by
+ *   `packages/mailwoman/tools/dev-tools/corpus/nad-skeletons.run.ts`.
+ */
+import { dataRootPath } from "@mailwoman/core/data-root";
+/**
+ * The register a skeleton file's rows were published in.
+ *
+ * It prefixes the `base_source_id` a recipe derives from the file.
+ */
+export const USSkeletonRegister = {
+    OpenAddresses: "openaddresses",
+    NationalAddressDatabase: "usgov-nad",
+};
+/**
+ * The data-root directory holding the NAD samples and ZIP-to-city tables the NAD skeleton tool writes.
+ */
+export const NAD_SKELETON_DIRECTORY = "nad-skeletons";
+/**
+ * The states sampled from NAD, chosen for address shapes the OpenAddresses files lack
+ * rather than for row count.
+ *
+ * Distinct tuples of those six files carry a unit on 0.6% of rows, and none has
+ * a hyphenated or direction-prefixed house number.
+ *
+ * Each comment states the shape measured over the usable rows of the FeatureServer
+ * pages fetched on 2026-05-18.
+ * `nad-skeletons.run.ts` prints the table for every state.
+ *
+ * Vermont is absent because it is the eval holdout.
+ * No state's rows match a rural-route street pattern, so NAD adds no rural-route form.
+ */
+export const NAD_SKELETON_STATES = [
+    // Chicago's city grid, which `us/il/cook` supplied before it was withdrawn: 8.9% unit, 1,268 ZIPs.
+    "IL",
+    // 36.6% unit, the most of any state with over a million rows, and 154 street types.
+    "MA",
+    // The numbered grid: 43.1% numeric street names and 42.6% post-directionals, as in `500 E`.
+    "UT",
+    // Direction-prefixed rural grid house numbers such as `S9878` on 1.3% of rows, and lettered county roads.
+    "WI",
+    // Hyphenated Queens house numbers such as `244-32` on 5.3% of rows, and 15.8% unit.
+    "NY",
+    // Farm to Market, Ranch Road and County Road prefix types on 5.4% of rows, and 161 street types.
+    "TX",
+];
+/**
+ * The zip and CSV member the NAD skeleton tool writes for one state.
+ */
+export function nadSkeletonFile(region) {
+    const state = region.toLowerCase();
+    return {
+        zip: dataRootPath(NAD_SKELETON_DIRECTORY, `us__${state}__nad.zip`),
+        csv: `us/${state}/nad.csv`,
+    };
+}
+/**
+ * The NAD skeleton file for every state in {@link NAD_SKELETON_STATES}.
+ */
+export const NAD_SKELETON_SOURCES = NAD_SKELETON_STATES.map((region) => ({
+    ...nadSkeletonFile(region),
+    region,
+    register: USSkeletonRegister.NationalAddressDatabase,
+}));
+/**
+ * The cached OpenAddresses US extracts used for training.
+ *
+ * `us/il/cook` is absent because Cook County's terms restrict redistribution.
+ * NAD's Illinois sample stands in for its city grid.
+ */
+export const OA_SKELETON_TRAIN_SOURCES = [
+    ["us__ca__berkeley.zip", "us/ca/berkeley.csv", "CA"],
+    ["us__ca__marin.zip", "us/ca/marin.csv", "CA"],
+    ["us__dc__statewide.zip", "us/dc/statewide.csv", "DC"],
+    ["us__ia__statewide.zip", "us/ia/statewide.csv", "IA"],
+    ["us__mt__statewide.zip", "us/mt/statewide.csv", "MT"],
+    ["us__sd__statewide.zip", "us/sd/statewide.csv", "SD"],
+].map(([zip, csv, region]) => ({
+    zip: dataRootPath("oa-cache", zip),
+    csv,
+    region,
+    register: USSkeletonRegister.OpenAddresses,
+}));
+/**
+ * Every US training skeleton: the OpenAddresses extracts and the NAD samples.
+ */
+export const US_SKELETON_TRAIN_SOURCES = [
+    ...OA_SKELETON_TRAIN_SOURCES,
+    ...NAD_SKELETON_SOURCES,
+];
+/**
+ * Vermont, the corpus holdout — `--golden` reads this and no other US source.
+ */
+export const US_SKELETON_EVAL_SOURCE = {
+    zip: dataRootPath("oa-cache", "us__vt__statewide.zip"),
+    csv: "us/vt/statewide.csv",
+    region: "VT",
+    register: USSkeletonRegister.OpenAddresses,
+};
+/**
+ * The counties of the `intersection` recipe's TIGER training crossings, Cook IL and Morris NJ.
+ */
+export const NAD_ZIP_CITY_COUNTIES = [
+    { region: "IL", county: "Cook" },
+    { region: "NJ", county: "Morris" },
+];
+/**
+ * The ZIP-to-city CSV the NAD skeleton tool writes for one county.
+ */
+export function nadZipCityPath(entry) {
+    const county = entry.county.toLowerCase().replaceAll(/[^a-z0-9]+/g, "-");
+    return dataRootPath(NAD_SKELETON_DIRECTORY, `us__${entry.region.toLowerCase()}__${county}__zip-city.csv`);
+}
+//# sourceMappingURL=skeleton-sources.js.map

package/out/us/recipes/skeleton-sources.js.map

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

package/out/us/tools/nad-skeletons.d.ts

@@ -0,0 +1,120 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ * @file Samples National Address Database rows into OpenAddresses-layout CSV skeletons, measures the address
+ *   shapes each state's rows carry, and tallies county ZIP-to-city tables.
+ *
+ *   The OA-skeleton recipes read a zipped CSV with OpenAddresses' columns, so a NAD sample written in that
+ *   layout reaches them through the same reader as the OpenAddresses extracts they also read.
+ */
+import { type PathBuilderLike } from "path-ts";
+import { type NADRecord } from "#us/adapters/usgov/nad/adapter";
+import { type NADZipCityCounty } from "#us/recipes/skeleton-sources";
+/**
+ * The OpenAddresses columns a skeleton CSV carries, in OpenAddresses' order.
+ */
+export declare const NAD_SKELETON_COLUMNS: readonly ["NUMBER", "STREET", "UNIT", "CITY", "DISTRICT", "REGION", "POSTCODE", "ID"];
+/**
+ * One NAD row projected onto {@link NAD_SKELETON_COLUMNS}.
+ */
+export type NADSkeletonRow = Record<(typeof NAD_SKELETON_COLUMNS)[number], string>;
+/**
+ * The unit identifier of a NAD row without its designator, as OpenAddresses' `UNIT` column mostly states it.
+ *
+ * NAD writes `APT 6`, `UNIT D` or a bare `200`; the recipes add their own designator in
+ * front of the identifier, so the designator NAD wrote is dropped rather than doubled.
+ */
+export declare function nadUnitIdentifier(record: NADRecord): string;
+/**
+ * Projects one NAD record onto the OpenAddresses columns, or returns null
+ * when it lacks a house number, street, locality, state or five-digit ZIP.
+ *
+ * A street whose name NAD publishes in capitals is written wholly in capitals,
+ * because NAD spells its structured types in title case (`East MAIN Street`)
+ * and a recipe would otherwise teach that mixed case.
+ */
+export declare function nadSkeletonRow(record: NADRecord): NADSkeletonRow | null;
+/**
+ * The address-shape measures for one state's usable NAD rows.
+ */
+export interface NADStateShape {
+    region: string;
+    /**
+     * Rows with a house number, street, locality and five-digit ZIP.
+     */
+    usable: number;
+    unitShare: number;
+    /**
+     * Distinct `St_PosTyp` and `St_PreTyp` values.
+     */
+    streetTypes: number;
+    zips: number;
+    /**
+     * Share of rows whose street opens with a type, such as `County Road 12` or `Farm to Market 1960`.
+     */
+    prefixTypeShare: number;
+    numericNameShare: number;
+    postDirectionalShare: number;
+    ruralRouteShare: number;
+    hyphenatedNumberShare: number;
+    /**
+     * Share of house numbers that open with a direction letter, as Wisconsin's `E2755` does.
+     */
+    gridNumberShare: number;
+}
+export interface BuildNADSkeletonsOptions {
+    /**
+     * The directory of FeatureServer NDJSON pages the NAD fetcher writes.
+     */
+    inputDirectory: PathBuilderLike;
+    /**
+     * The states to sample, as USPS abbreviations.
+     */
+    states: readonly string[];
+    /**
+     * The most rows any one state's sample keeps.
+     */
+    cap: number;
+    seed: number;
+    zipCityCounties: readonly NADZipCityCounty[];
+    /**
+     * Called after each page with the count read so far.
+     */
+    onPage?: (pagesRead: number, pages: number) => void;
+}
+export interface NADSkeletonSummary {
+    pages: number;
+    cap: number;
+    seed: number;
+    shapes: NADStateShape[];
+    samples: Array<{
+        region: string;
+        rows: number;
+        zip: string;
+        csv: string;
+        csvSHA256: string;
+    }>;
+    zipCity: Array<{
+        region: string;
+        county: string;
+        zips: number;
+        path: string;
+        sha256: string;
+    }>;
+}
+/**
+ * Reads every NAD page once, measures every state's address shapes,
+ * keeps a uniform reservoir sample of at most `cap` rows for each requested state,
+ * and tallies the majority city of each ZIP in each requested county.
+ *
+ * The sample is written in reservoir order rather than page order, so a reader that
+ * takes the first N rows still draws across the whole state.
+ * It refuses to replace a file that already exists.
+ */
+export declare function buildNADSkeletons(options: BuildNADSkeletonsOptions): Promise<NADSkeletonSummary>;
+/**
+ * Writes the summary beside the skeletons it describes.
+ */
+export declare function writeNADSkeletonSummary(summary: NADSkeletonSummary, path: PathBuilderLike): Promise<void>;
+//# sourceMappingURL=nad-skeletons.d.ts.map

package/out/us/tools/nad-skeletons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nad-skeletons.d.ts","sourceRoot":"","sources":["../../../lib/us/tools/nad-skeletons.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AASH,OAAO,EAAsB,KAAK,eAAe,EAAE,MAAM,SAAS,CAAA;AAIlE,OAAO,EAA0D,KAAK,SAAS,EAAE,MAAM,gCAAgC,CAAA;AACvH,OAAO,EAAmC,KAAK,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAErG;;GAEG;AACH,eAAO,MAAM,oBAAoB,YAChC,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,MAAM,EACN,UAAU,EACV,QAAQ,EACR,UAAU,EACV,IAAI,CACK,CAAA;AAEV;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAA;AAKlF;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAS3D;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,GAAG,cAAc,GAAG,IAAI,CAsBvE;AAMD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ;;OAEG;IACH,eAAe,EAAE,MAAM,CAAA;IACvB,gBAAgB,EAAE,MAAM,CAAA;IACxB,oBAAoB,EAAE,MAAM,CAAA;IAC5B,eAAe,EAAE,MAAM,CAAA;IACvB,qBAAqB,EAAE,MAAM,CAAA;IAC7B;;OAEG;IACH,eAAe,EAAE,MAAM,CAAA;CACvB;AAyFD,MAAM,WAAW,wBAAwB;IACxC;;OAEG;IACH,cAAc,EAAE,eAAe,CAAA;IAC/B;;OAEG;IACH,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;IACzB;;OAEG;IACH,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,eAAe,EAAE,SAAS,gBAAgB,EAAE,CAAA;IAC5C;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CACnD;AAED,MAAM,WAAW,kBAAkB;IAClC,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,aAAa,EAAE,CAAA;IACvB,OAAO,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC7F,OAAO,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAC9F;AAED;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAoItG;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,kBAAkB,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAEzG"}