@mailwoman/tiger 5.9.0 → 5.10.1

package/out/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,cAAc,gBAAgB,CAAA;AAC9B,cAAc,oBAAoB,CAAA;AAClC,cAAc,kBAAkB,CAAA"}

package/out/tools/race-dots-map.d.ts

@@ -8,12 +8,36 @@
  *   inlined here, à la `registry/map-html.ts`) under a circle layer of the dots, colored by race
  *   category. The dots PMTiles is read client-side via the `pmtiles` protocol.
  *
- *   Each dot is one of `--per` people of a category, placed at random inside its Census block — a
+ *   Each dot is one of `per` people of a category, placed at random inside its Census block — a
  *   representation, not a record about any address. Serve over localhost (the house tile server
- *   CORS-restricts to localhost + the docs domains).
+ *   CORS-restricts to localhost + the docs domains) — `mailwoman tiger race-dots-map --serve` wires
+ *   {@linkcode serveWithRangeSupport} for exactly this.
  *
- *   Run: node --experimental-strip-types scripts/census/race-dots-map.ts\
- *   --pmtiles-url http://localhost:8899/race-dots-oc.pmtiles --out /tmp/race-dots-oc.html
+ *   Run: `mailwoman tiger race-dots-map --pmtiles-url
+ *   http://localhost:8899/race-dots-oc.pmtiles --out /tmp/race-dots-oc.html`
  */
-export {};
+/** Options for {@linkcode raceDotsMap}. */
+export interface RaceDotsMapOptions {
+    /** Dots tileset URL the page reads client-side. Default `http://localhost:8899/race-dots-oc.pmtiles`. */
+    pmtilesURL?: string;
+    /** Output HTML path. Default `/tmp/race-dots-oc.html`. */
+    out?: string;
+    /** People represented by one dot (title/legend copy only). Default 5. */
+    per?: number;
+    /** Page title. Default derives from `per`. */
+    title?: string;
+    /** Initial map center longitude. Default -117.83 (Orange County, CA). */
+    lng?: number;
+    /** Initial map center latitude. Default 33.68. */
+    lat?: number;
+    /** Initial map zoom. Default 9.4. */
+    zoom?: number;
+}
+/** Result of {@linkcode raceDotsMap}. */
+export interface RaceDotsMapResult {
+    outPath: string;
+    pmtilesURL: string;
+}
+/** Race-dots MapLibre page writer — see the module doc. */
+export declare function raceDotsMap(options?: RaceDotsMapOptions, report?: (line: string) => void): Promise<RaceDotsMapResult>;
 //# sourceMappingURL=race-dots-map.d.ts.map

package/out/tools/race-dots-map.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"race-dots-map.d.ts","sourceRoot":"","sources":["../../tools/race-dots-map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG"}
+{"version":3,"file":"race-dots-map.d.ts","sourceRoot":"","sources":["../../tools/race-dots-map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,2CAA2C;AAC3C,MAAM,WAAW,kBAAkB;IAClC,yGAAyG;IACzG,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,0DAA0D;IAC1D,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,yEAAyE;IACzE,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,yEAAyE;IACzE,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,kDAAkD;IAClD,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAA;CACb;AAED,yCAAyC;AACzC,MAAM,WAAW,iBAAiB;IACjC,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;CAClB;AAkCD,2DAA2D;AAC3D,wBAAsB,WAAW,CAChC,OAAO,GAAE,kBAAuB,EAChC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC7B,OAAO,CAAC,iBAAiB,CAAC,CA6F5B"}

package/out/tools/race-dots-map.js

@@ -8,40 +8,15 @@
  *   inlined here, à la `registry/map-html.ts`) under a circle layer of the dots, colored by race
  *   category. The dots PMTiles is read client-side via the `pmtiles` protocol.
  *
- *   Each dot is one of `--per` people of a category, placed at random inside its Census block — a
+ *   Each dot is one of `per` people of a category, placed at random inside its Census block — a
  *   representation, not a record about any address. Serve over localhost (the house tile server
- *   CORS-restricts to localhost + the docs domains).
+ *   CORS-restricts to localhost + the docs domains) — `mailwoman tiger race-dots-map --serve` wires
+ *   {@linkcode serveWithRangeSupport} for exactly this.
  *
- *   Run: node --experimental-strip-types scripts/census/race-dots-map.ts\
- *   --pmtiles-url http://localhost:8899/race-dots-oc.pmtiles --out /tmp/race-dots-oc.html
+ *   Run: `mailwoman tiger race-dots-map --pmtiles-url
+ *   http://localhost:8899/race-dots-oc.pmtiles --out /tmp/race-dots-oc.html`
  */
 import { writeFileSync } from "node:fs";
-import { parseArgs } from "node:util";
-import { layers, namedFlavor } from "@protomaps/basemaps";
-// Loose scan parity with the retired local argv helpers: unknown flags tolerated.
-const { values: rawValues } = parseArgs({
-    options: {
-        lat: { type: "string" },
-        lng: { type: "string" },
-        out: { type: "string" },
-        per: { type: "string" },
-        "pmtiles-url": { type: "string" },
-        title: { type: "string" },
-        zoom: { type: "string" },
-    },
-    strict: false,
-    allowPositionals: true,
-});
-// Typed view: strict:false loosens TS inference, but declared options always parse to their schema type.
-const values = rawValues;
-const PMTILES_URL = values["pmtiles-url"] || "http://localhost:8899/race-dots-oc.pmtiles";
-const OUT = values["out"] || "/tmp/race-dots-oc.html";
-const PER = Number(values["per"] || "5");
-const PER_PHRASE = PER === 1 ? "one dot is one person" : `one dot ≈ ${PER} people`;
-const TITLE = values["title"] || `Race in Orange County, CA — ${PER_PHRASE} (2020 Census)`;
-const CENTER_LNG = Number(values["lng"] || "-117.83");
-const CENTER_LAT = Number(values["lat"] || "33.68");
-const ZOOM = Number(values["zoom"] || "9.4");
 const MAPLIBRE_VERSION = "5.24.0";
 const MAPLIBRE_JS_SRI = "sha384-5+cfbwT0iiub6VsQAdn6yz16nr6sDiQoHx6tm4O8OVYXHYOxcffFmCJBL0dgdvGp";
 const MAPLIBRE_CSS_SRI = "sha384-uTttxo/aOKbdE5RlD/SPzSDoDmNvGlUYPjONi2MN/b7c9HPSvW07OIuyP7uL6jxK";
@@ -71,39 +46,51 @@ const CATEGORY_LABEL = {
     other: "Other (non-Hispanic)",
     multi: "Two or more races",
 };
-const colorMatch = ["match", ["get", "cat"]];
-for (const [cat, color] of Object.entries(CATEGORY_COLOR)) {
-    colorMatch.push(cat, color);
-}
-colorMatch.push("#9e9e9e");
-const style = {
-    version: 8,
-    glyphs: GLYPHS_URL,
-    sprite: SPRITE_URL,
-    sources: {
-        [BASEMAP_SOURCE_ID]: { type: "vector", url: BASEMAP_TILEJSON_URL },
-        dots: { type: "vector", url: "pmtiles://" + PMTILES_URL },
-    },
-    layers: [
-        ...layers(BASEMAP_SOURCE_ID, namedFlavor("light"), { lang: "en" }),
-        {
-            id: "race-dots",
-            type: "circle",
-            source: "dots",
-            "source-layer": "dots",
-            paint: {
-                "circle-radius": ["interpolate", ["linear"], ["zoom"], 4, 0.7, 9, 1.7, 12, 2.8, 16, 4.5],
-                "circle-color": colorMatch,
-                "circle-opacity": 0.85,
-            },
+/** Race-dots MapLibre page writer — see the module doc. */
+export async function raceDotsMap(options = {}, report) {
+    const PMTILES_URL = options.pmtilesURL || "http://localhost:8899/race-dots-oc.pmtiles";
+    const OUT = options.out || "/tmp/race-dots-oc.html";
+    const PER = options.per ?? 5;
+    const PER_PHRASE = PER === 1 ? "one dot is one person" : `one dot ≈ ${PER} people`;
+    const TITLE = options.title || `Race in Orange County, CA — ${PER_PHRASE} (2020 Census)`;
+    const CENTER_LNG = options.lng ?? -117.83;
+    const CENTER_LAT = options.lat ?? 33.68;
+    const ZOOM = options.zoom ?? 9.4;
+    // Heavy dep (devDependency — operator tooling), lazy-imported so loading the tools barrel stays cheap.
+    const { layers, namedFlavor } = await import("@protomaps/basemaps");
+    const colorMatch = ["match", ["get", "cat"]];
+    for (const [cat, color] of Object.entries(CATEGORY_COLOR)) {
+        colorMatch.push(cat, color);
+    }
+    colorMatch.push("#9e9e9e");
+    const style = {
+        version: 8,
+        glyphs: GLYPHS_URL,
+        sprite: SPRITE_URL,
+        sources: {
+            [BASEMAP_SOURCE_ID]: { type: "vector", url: BASEMAP_TILEJSON_URL },
+            dots: { type: "vector", url: "pmtiles://" + PMTILES_URL },
         },
-    ],
-};
-const legendRows = Object.keys(CATEGORY_COLOR)
-    .map((c) => `<div><i style="background:${CATEGORY_COLOR[c]}"></i>${CATEGORY_LABEL[c]}</div>`)
-    .join("");
-// The client script avoids template literals / `${` so it survives this outer template verbatim.
-const html = `<!doctype html>
+        layers: [
+            ...layers(BASEMAP_SOURCE_ID, namedFlavor("light"), { lang: "en" }),
+            {
+                id: "race-dots",
+                type: "circle",
+                source: "dots",
+                "source-layer": "dots",
+                paint: {
+                    "circle-radius": ["interpolate", ["linear"], ["zoom"], 4, 0.7, 9, 1.7, 12, 2.8, 16, 4.5],
+                    "circle-color": colorMatch,
+                    "circle-opacity": 0.85,
+                },
+            },
+        ],
+    };
+    const legendRows = Object.keys(CATEGORY_COLOR)
+        .map((c) => `<div><i style="background:${CATEGORY_COLOR[c]}"></i>${CATEGORY_LABEL[c]}</div>`)
+        .join("");
+    // The client script avoids template literals / `${` so it survives this outer template verbatim.
+    const html = `<!doctype html>
 <html lang="en">
 <head>
 <meta charset="utf-8" />
@@ -142,6 +129,8 @@ const html = `<!doctype html>
 </body>
 </html>
 `;
-writeFileSync(OUT, html);
-console.error(`[written] ${OUT}  (pmtiles: ${PMTILES_URL})`);
+    writeFileSync(OUT, html);
+    report?.(`[written] ${OUT}  (pmtiles: ${PMTILES_URL})`);
+    return { outPath: OUT, pmtilesURL: PMTILES_URL };
+}
 //# sourceMappingURL=race-dots-map.js.map

package/out/tools/race-dots-map.js.map

@@ -1 +1 @@
-{"version":3,"file":"race-dots-map.js","sourceRoot":"","sources":["../../tools/race-dots-map.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"race-dots-map.js","sourceRoot":"","sources":["../../tools/race-dots-map.ts"],"names":[],"mappings":"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"}

package/out/tools/race-dots.d.ts

@@ -7,19 +7,39 @@
  *   `mailwoman tiger` CLI produces.
  *
  *   Reads `tabblock20 ⋈ pl_block` (block geometry + Census 2020 P.L. 94-171 table P2 counts) and
- *   scatters one dot per `--per` people uniformly at random inside each block, tagged with its
+ *   scatters one dot per `per` people uniformly at random inside each block, tagged with its
  *   race/ethnicity category. Output is NDJSON (one GeoJSON Point Feature per line, with a
  *   `tippecanoe` layer hint) ready for `tippecanoe -o race-dots.pmtiles`.
  *
  *   Point-in-polygon uses `@turf/boolean-contains` (ships with `@mailwoman/tiger`). The dot is a
  *   _representation_, not a record: a random position inside the block it belongs to, standing in
- *   for `--per` real people of that category. It says nothing about any individual address.
+ *   for `per` real people of that category. It says nothing about any individual address.
  *
- *   Build the input DB first: mailwoman tiger fetch --state 06 --county 059 --out tiger-oc.db
- *   mailwoman tiger redistricting --state 06 --county 059 --out tiger-oc.db
+ *   Build the input DB first: `mailwoman tiger fetch --state 06 --county 059 --out tiger-oc.db` then
+ *   `mailwoman tiger redistricting --state 06 --county 059 --out tiger-oc.db`.
  *
- *   Run: node --experimental-strip-types scripts/census/race-dots.ts\
- *   --db tiger-oc.db --per 10 --out /tmp/race-dots.ndjson
+ *   Run: `mailwoman tiger race-dots --db tiger-oc.db --per 10 --out /tmp/race-dots.ndjson`
  */
-export {};
+/** Options for {@linkcode raceDots}. */
+export interface RaceDotsOptions {
+    /** TIGER SQLite DB (`tabblock20` ⋈ `pl_block`). Default `$MAILWOMAN_DATA_ROOT/tiger/tiger-oc.db`. */
+    db?: string;
+    /** Output NDJSON path. Default `/tmp/race-dots.ndjson`. */
+    out?: string;
+    /** People represented by one dot. Default 10. */
+    per?: number;
+    /** Tippecanoe layer name. Default `dots`. */
+    layer?: string;
+}
+/** Result of {@linkcode raceDots}. */
+export interface RaceDotsResult {
+    outPath: string;
+    dots: number;
+    skipped: number;
+    blocks: number;
+    /** Dots emitted per P2 category. */
+    totals: Record<string, number>;
+}
+/** Race-by-dot-density NDJSON builder — see the module doc. */
+export declare function raceDots(options?: RaceDotsOptions, report?: (line: string) => void): Promise<RaceDotsResult>;
 //# sourceMappingURL=race-dots.d.ts.map

package/out/tools/race-dots.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"race-dots.d.ts","sourceRoot":"","sources":["../../tools/race-dots.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG"}
+{"version":3,"file":"race-dots.d.ts","sourceRoot":"","sources":["../../tools/race-dots.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAOH,wCAAwC;AACxC,MAAM,WAAW,eAAe;IAC/B,qGAAqG;IACrG,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,2DAA2D;IAC3D,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,iDAAiD;IACjD,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAED,sCAAsC;AACtC,MAAM,WAAW,cAAc;IAC9B,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC9B;AAmCD,+DAA+D;AAC/D,wBAAsB,QAAQ,CAC7B,OAAO,GAAE,eAAoB,EAC7B,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC7B,OAAO,CAAC,cAAc,CAAC,CA0GzB"}

package/out/tools/race-dots.js

@@ -7,37 +7,22 @@
  *   `mailwoman tiger` CLI produces.
  *
  *   Reads `tabblock20 ⋈ pl_block` (block geometry + Census 2020 P.L. 94-171 table P2 counts) and
- *   scatters one dot per `--per` people uniformly at random inside each block, tagged with its
+ *   scatters one dot per `per` people uniformly at random inside each block, tagged with its
  *   race/ethnicity category. Output is NDJSON (one GeoJSON Point Feature per line, with a
  *   `tippecanoe` layer hint) ready for `tippecanoe -o race-dots.pmtiles`.
  *
  *   Point-in-polygon uses `@turf/boolean-contains` (ships with `@mailwoman/tiger`). The dot is a
  *   _representation_, not a record: a random position inside the block it belongs to, standing in
- *   for `--per` real people of that category. It says nothing about any individual address.
+ *   for `per` real people of that category. It says nothing about any individual address.
  *
- *   Build the input DB first: mailwoman tiger fetch --state 06 --county 059 --out tiger-oc.db
- *   mailwoman tiger redistricting --state 06 --county 059 --out tiger-oc.db
+ *   Build the input DB first: `mailwoman tiger fetch --state 06 --county 059 --out tiger-oc.db` then
+ *   `mailwoman tiger redistricting --state 06 --county 059 --out tiger-oc.db`.
  *
- *   Run: node --experimental-strip-types scripts/census/race-dots.ts\
- *   --db tiger-oc.db --per 10 --out /tmp/race-dots.ndjson
+ *   Run: `mailwoman tiger race-dots --db tiger-oc.db --per 10 --out /tmp/race-dots.ndjson`
  */
 import { createWriteStream } from "node:fs";
 import { DatabaseSync } from "node:sqlite";
-import { parseArgs } from "node:util";
 import { dataRootPath } from "@mailwoman/core/utils";
-import booleanContains from "@turf/boolean-contains";
-// Loose scan parity with the retired local argv helpers: unknown flags tolerated.
-const { values: rawValues } = parseArgs({
-    options: { db: { type: "string" }, layer: { type: "string" }, out: { type: "string" }, per: { type: "string" } },
-    strict: false,
-    allowPositionals: true,
-});
-// Typed view: strict:false loosens TS inference, but declared options always parse to their schema type.
-const values = rawValues;
-const DB = values["db"] || dataRootPath("tiger", "tiger-oc.db");
-const OUT = values["out"] || "/tmp/race-dots.ndjson";
-const PER = Number(values["per"] || "10"); // people represented by one dot
-const LAYER = values["layer"] || "dots";
 // The eight P2 categories (columns in pl_block) that partition each block's population.
 const CATEGORIES = ["hispanic", "white", "black", "asian", "aian", "nhpi", "other", "multi"];
 function bbox(rings) {
@@ -58,80 +43,91 @@ function bbox(rings) {
     }
     return [minX, minY, maxX, maxY];
 }
-// A block geometry is one or more polygons. Pick a sub-polygon weighted by bbox area, then
-// rejection-sample inside it with a turf containment test (handles holes + winding correctly).
-function randomPointIn(polys, areas, totalArea) {
-    let r = Math.random() * totalArea;
-    let pick = 0;
-    while (pick < polys.length - 1 && (r -= areas[pick]) > 0) {
-        pick++;
-    }
-    const poly = polys[pick];
-    const polyFeature = {
-        type: "Feature",
-        geometry: { type: "Polygon", coordinates: poly },
-        properties: {},
-    };
-    const [minX, minY, maxX, maxY] = bbox(poly);
-    for (let tries = 0; tries < 60; tries++) {
-        const x = minX + Math.random() * (maxX - minX);
-        const y = minY + Math.random() * (maxY - minY);
-        const pt = { type: "Feature", geometry: { type: "Point", coordinates: [x, y] }, properties: {} };
-        if (booleanContains(polyFeature, pt))
-            return [x, y];
-    }
-    return null;
-}
-const db = new DatabaseSync(DB, { readOnly: true });
-const rows = db
-    .prepare(`SELECT b.geometry AS geometry, ${CATEGORIES.map((c) => `p.${c} AS ${c}`).join(", ")}
-		 FROM tabblock20 b JOIN pl_block p ON b.GEOID = p.GEOID
-		 WHERE p.pop_total > 0`)
-    .all();
-db.close();
-const out = createWriteStream(OUT);
-const totals = new Map();
-let dots = 0, skipped = 0;
-for (const row of rows) {
-    let geom;
-    try {
-        geom = JSON.parse(row.geometry);
-    }
-    catch {
-        continue;
+/** Race-by-dot-density NDJSON builder — see the module doc. */
+export async function raceDots(options = {}, report) {
+    const DB = options.db || dataRootPath("tiger", "tiger-oc.db");
+    const OUT = options.out || "/tmp/race-dots.ndjson";
+    const PER = options.per ?? 10; // people represented by one dot
+    const LAYER = options.layer || "dots";
+    // Heavy dep, lazy-imported so loading the tools barrel stays cheap.
+    const { default: booleanContains } = await import("@turf/boolean-contains");
+    // A block geometry is one or more polygons. Pick a sub-polygon weighted by bbox area, then
+    // rejection-sample inside it with a turf containment test (handles holes + winding correctly).
+    function randomPointIn(polys, areas, totalArea) {
+        let r = Math.random() * totalArea;
+        let pick = 0;
+        while (pick < polys.length - 1 && (r -= areas[pick]) > 0) {
+            pick++;
+        }
+        const poly = polys[pick];
+        const polyFeature = {
+            type: "Feature",
+            geometry: { type: "Polygon", coordinates: poly },
+            properties: {},
+        };
+        const [minX, minY, maxX, maxY] = bbox(poly);
+        for (let tries = 0; tries < 60; tries++) {
+            const x = minX + Math.random() * (maxX - minX);
+            const y = minY + Math.random() * (maxY - minY);
+            const pt = { type: "Feature", geometry: { type: "Point", coordinates: [x, y] }, properties: {} };
+            if (booleanContains(polyFeature, pt))
+                return [x, y];
+        }
+        return null;
     }
-    const polys = geom.type === "Polygon" ? [geom.coordinates] : geom.coordinates;
-    const areas = polys.map((p) => {
-        const [a, b, c, d] = bbox(p);
-        return Math.max((c - a) * (d - b), 1e-12);
-    });
-    const totalArea = areas.reduce((s, a) => s + a, 0);
-    for (const cat of CATEGORIES) {
-        const people = row[cat];
-        if (people <= 0)
+    const db = new DatabaseSync(DB, { readOnly: true });
+    const rows = db
+        .prepare(`SELECT b.geometry AS geometry, ${CATEGORIES.map((c) => `p.${c} AS ${c}`).join(", ")}
+			 FROM tabblock20 b JOIN pl_block p ON b.GEOID = p.GEOID
+			 WHERE p.pop_total > 0`)
+        .all();
+    db.close();
+    const out = createWriteStream(OUT);
+    const totals = new Map();
+    let dots = 0, skipped = 0;
+    for (const row of rows) {
+        let geom;
+        try {
+            geom = JSON.parse(row.geometry);
+        }
+        catch {
             continue;
-        const exact = people / PER;
-        const n = Math.floor(exact) + (Math.random() < exact - Math.floor(exact) ? 1 : 0);
-        for (let k = 0; k < n; k++) {
-            const pt = randomPointIn(polys, areas, totalArea);
-            if (!pt) {
-                skipped++;
+        }
+        const polys = geom.type === "Polygon" ? [geom.coordinates] : geom.coordinates;
+        const areas = polys.map((p) => {
+            const [a, b, c, d] = bbox(p);
+            return Math.max((c - a) * (d - b), 1e-12);
+        });
+        const totalArea = areas.reduce((s, a) => s + a, 0);
+        for (const cat of CATEGORIES) {
+            const people = row[cat];
+            if (people <= 0)
                 continue;
+            const exact = people / PER;
+            const n = Math.floor(exact) + (Math.random() < exact - Math.floor(exact) ? 1 : 0);
+            for (let k = 0; k < n; k++) {
+                const pt = randomPointIn(polys, areas, totalArea);
+                if (!pt) {
+                    skipped++;
+                    continue;
+                }
+                out.write(JSON.stringify({
+                    type: "Feature",
+                    tippecanoe: { layer: LAYER },
+                    properties: { cat },
+                    geometry: { type: "Point", coordinates: [Math.round(pt[0] * 1e5) / 1e5, Math.round(pt[1] * 1e5) / 1e5] },
+                }) + "\n");
+                dots++;
+                totals.set(cat, (totals.get(cat) ?? 0) + 1);
             }
-            out.write(JSON.stringify({
-                type: "Feature",
-                tippecanoe: { layer: LAYER },
-                properties: { cat },
-                geometry: { type: "Point", coordinates: [Math.round(pt[0] * 1e5) / 1e5, Math.round(pt[1] * 1e5) / 1e5] },
-            }) + "\n");
-            dots++;
-            totals.set(cat, (totals.get(cat) ?? 0) + 1);
         }
     }
-}
-out.end();
-console.error(`[done] ${dots} dots from ${rows.length} blocks (1 dot ≈ ${PER} people); ${skipped} skipped`);
-for (const [cat, n] of [...totals.entries()].sort((a, b) => b[1] - a[1])) {
-    console.error(`  ${n.toString().padStart(7)}  ${cat}`);
+    out.end();
+    await new Promise((resolve) => out.on("finish", () => resolve()));
+    report?.(`[done] ${dots} dots from ${rows.length} blocks (1 dot ≈ ${PER} people); ${skipped} skipped`);
+    for (const [cat, n] of [...totals.entries()].sort((a, b) => b[1] - a[1])) {
+        report?.(`  ${n.toString().padStart(7)}  ${cat}`);
+    }
+    return { outPath: OUT, dots, skipped, blocks: rows.length, totals: Object.fromEntries(totals) };
 }
 //# sourceMappingURL=race-dots.js.map

package/out/tools/race-dots.js.map

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

package/out/tools/serve-range.d.ts

@@ -5,10 +5,29 @@
  *
  *   Minimal static file server that honours HTTP Range requests (206) — Python's `http.server` does
  *   not, and PMTiles reads via Range, so it can't be served by it. Used to preview/render a local
- *   `.pmtiles` tileset (e.g. the race-dot map). Not for production; the deployed tiles go through
- *   the tile worker.
+ *   `.pmtiles` tileset (e.g. the race-dot map, via `mailwoman tiger race-dots-map --serve`). Not for
+ *   production; the deployed tiles go through the tile worker.
  *
- *   Run: node scripts/census/serve-range.ts [dir=/tmp] [port=8899]
+ *   Internal helper module — no standalone command.
  */
-export {};
+import { type Server } from "node:http";
+/** Options for {@linkcode serveWithRangeSupport}. */
+export interface ServeRangeOptions {
+    /** Directory to serve. Default `/tmp`. */
+    dir?: string;
+    /** Port to listen on. Default 8899. */
+    port?: number;
+}
+/** A running range-capable static server, resolved once listening. */
+export interface RangeServer {
+    dir: string;
+    port: number;
+    server: Server;
+    close: () => void;
+}
+/**
+ * Serve `dir` over localhost with HTTP Range support. Resolves once the server is listening; the caller owns the
+ * lifetime (`close()` to stop — commands typically hold the process open instead).
+ */
+export declare function serveWithRangeSupport(options?: ServeRangeOptions, report?: (line: string) => void): Promise<RangeServer>;
 //# sourceMappingURL=serve-range.d.ts.map

package/out/tools/serve-range.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serve-range.d.ts","sourceRoot":"","sources":["../../tools/serve-range.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}
+{"version":3,"file":"serve-range.d.ts","sourceRoot":"","sources":["../../tools/serve-range.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAsC,KAAK,MAAM,EAAuB,MAAM,WAAW,CAAA;AAGhG,qDAAqD;AACrD,MAAM,WAAW,iBAAiB;IACjC,0CAA0C;IAC1C,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAA;CACb;AAED,sEAAsE;AACtE,MAAM,WAAW,WAAW;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,IAAI,CAAA;CACjB;AAUD;;;GAGG;AACH,wBAAgB,qBAAqB,CACpC,OAAO,GAAE,iBAAsB,EAC/B,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC7B,OAAO,CAAC,WAAW,CAAC,CA2CtB"}