@mailwoman/tiger 9.4.0 → 10.1.0

package/{lib/sdk → sdk}/redistricting.ts

@@ -4,53 +4,56 @@
  * @author Teffen Ellis, et al.
  *
  *   Pull a state's Census 2020 P.L. 94-171 redistricting counts (table P2 — Hispanic-or-Latino by
- *   race, per block) into the `pl_block` table of a TIGER {@link DatabaseClient} DB, keyed on the
- *   same 15-char block `GEOID` as {@link fetchTIGER}'s `tabblock20`. Join the two for block-level
+ *   race, per block) into the `pl_block` table of a tiger {@link DatabaseClient} DB, keyed on the
+ *   same 15-char block `geoid` as {@link fetchTIGER}'s `tabblock20`. Join the two for block-level
  *   race + geometry (e.g. a dot-density map).
  *
  *   Keyless public data. The per-state ZIP holds a pipe-delimited geographic header
- *   (`<st>geo<yr>.pl`) and three data segments; segment 1 (`<st>00001<yr>.pl`) carries P1 + P2. We
- *   join the header (filtered to SUMLEV 750 = block) to segment 1 by LOGRECNO. Field offsets are
+ *   (`<st>geo<yr>.pl`) and three data segments. segment 1 (`<st>00001<yr>.pl`) contains P1 + P2. We
+ *   join the header (filtered to sumlev 750 = block) to segment 1 by logrecno. Field offsets are
  *   fixed by the 2020 P.L. layout (verified against the real files).
  *
  *   https://www2.census.gov/programs-surveys/decennial/2020/data/01-Redistricting_File--PL_94-171/
  */
 
-import { mailwomanDataRoot } from "@mailwoman/core/data-root"
+import { dataRootPath } from "@mailwoman/core/data-root"
 import { makeDirectories } from "@mailwoman/core/fs/writers"
 import { extractZipEntries } from "@mailwoman/core/fs/zip"
 import { DatabaseClient } from "@mailwoman/sqlite/client"
-import { dirname, join } from "path-ts"
+import { PathBuilder } from "path-ts"
 import { TextSpliterator } from "spliterator"
 
+import { initializeTIGERSchema, TIGER_PRAGMAS, type PLBlockTable, type TIGERDatabase } from "#schema"
 import { downloadIfNeeded } from "#sdk/download"
-import { initializeTIGERSchema, TIGER_PRAGMAS, type PLBlockTable, type TIGERDatabase } from "#sdk/schema"
 import { AdminLevel1CodeToAbbreviation, StateName, type AdminLevel1Code } from "#state"
 
 const REDISTRICTING_BASE =
 	"https://www2.census.gov/programs-surveys/decennial/2020/data/01-Redistricting_File--PL_94-171"
 
-const DEFAULT_DATA_ROOT = mailwomanDataRoot()
+const DEFAULT_DATA_ROOT = dataRootPath()
 
 /**
- * P.L. 94-171 (2020) pipe-delimited field offsets (0-based). Geographic header:
- * …|SUMLEV(2)|…|LOGRECNO(7)|GEOID(8)|GEOCODE(9)|… — GEOCODE is the bare 15-char block FIPS (matches TIGER GEOID20);
- * SUMLEV 750 = tabulation block.
+ * P.L. 94-171 (2020) pipe-delimited field offsets (0-based).
+ *
+ * Geographic header: …|sumlev(2)|…|logrecno(7)|geoid(8)|geocode(9)|… — geocode is the
+ * bare 15-char block FIPS (matches tiger GEOID20); sumlev 750 = tabulation block.
  */
 const GEO_SUMLEV = 2
 const GEO_LOGRECNO = 7
 const GEO_GEOCODE = 9
 /**
- * Segment 1: FILEID|STUSAB|CHARITER|CIFSN|LOGRECNO(4)| P1×71 | P2×73. P0020001 is at index 76.
+ * Segment 1: fileid|stusab|chariter|cifsn|logrecno(4)| P1×71 | P2×73. P0020001 is at index 76.
  */
 const SEG_LOGRECNO = 4
 const P2 = (fieldNo: number) => 76 + (fieldNo - 1)
 
 /**
- * Segment 2: FILEID|STUSAB|CHARITER|CIFSN|LOGRECNO(4)| P3×71 | P4×73 | H1×3 — 152 fields, H1 at the tail. Verified
- * against the real file: `ca000022020.pl`'s state row reads 14,392,140 / 13,475,623 / 916,517, the published CA 2020
- * figures. `occupied + vacant === housing_units` is the invariant that distinguishes a correct offset from a plausible
- * one, and {@link parseH1} refuses a row where it does not hold.
+ * Segment 2: fileid|stusab|chariter|cifsn|logrecno(4)| P3×71 | P4×73 | H1×3 — 152 fields, H1 at the tail. Verified
+ * against the real file: `ca000022020.pl`'s state row reads 14,392,140 / 13,475,623
+ * / 916,517, the published CA 2020 figures.
+ *
+ * `occupied + vacant === housing_units` is the invariant that distinguishes a correct
+ * offset from a plausible one. {@link parseH1} refuses a row when it does not hold.
  */
 export const SEG2_FIELD_COUNT = 152
 /**
@@ -62,7 +65,7 @@ export const H1_TOTAL = SEG2_FIELD_COUNT - 3
  */
 export const H1_OCCUPIED = SEG2_FIELD_COUNT - 2
 /**
- * H0010003 — vacant housing units, the last field (and so the one that carries a CRLF file's trailing CR).
+ * H0010003 — vacant housing units, the last field (and so the one that contains a crlf file's trailing CR).
  */
 export const H1_VACANT = SEG2_FIELD_COUNT - 1
 
@@ -73,8 +76,11 @@ export interface H1Counts {
 }
 
 /**
- * The three H1 counts from one segment-2 row. The last field carries CRLF's trailing CR when the file has one, so each
- * field is trimmed before it is read as a number; a row whose counts do not add up is refused rather than stored.
+ * The three H1 counts from one segment-2 row.
+ *
+ * The last field contains crlf's trailing CR when the file has one, so each field
+ * is trimmed before it is read as a number.
+ * A row whose counts do not add up is refused rather than stored.
  */
 export function parseH1(fields: readonly string[]): H1Counts {
 	if (fields.length !== SEG2_FIELD_COUNT) {
@@ -106,7 +112,7 @@ export function parseH1(fields: readonly string[]): H1Counts {
 const CATEGORY_INDEX = {
 	pop_total: P2(1),
 	hispanic: P2(2), // Hispanic or Latino (any race)
-	white: P2(5), // Not Hispanic: White alone
+	white: P2(5), // Not Hispanic: White without another race
 	black: P2(6),
 	aian: P2(7),
 	asian: P2(8),
@@ -121,11 +127,15 @@ export interface FetchRedistrictingOptions {
 	 */
 	stateFIPS: string
 	/**
-	 * Decennial vintage. Default 2020 (the only P.L. 94-171 release this parses).
+	 * Decennial vintage.
+	 *
+	 * Default 2020 (the only P.L. 94-171 release this parses).
 	 */
 	vintage?: number
 	/**
-	 * Output SQLite path. Default `<dataRoot>/tiger/tiger.db` (same DB as `fetchTIGER`).
+	 * Output SQLite path.
+	 *
+	 * Default `<dataRoot>/tiger/tiger.db` (same DB as `fetchTIGER`).
 	 */
 	outPath?: string
 	/**
@@ -137,7 +147,9 @@ export interface FetchRedistrictingOptions {
 	 */
 	county?: string
 	/**
-	 * Rows per insert. Default 2000.
+	 * Rows per insert.
+	 *
+	 * Default 2000.
 	 */
 	batchSize?: number
 }
@@ -154,11 +166,12 @@ export interface FetchRedistrictingResult {
 	inserted: number
 }
 
-// Pipe-delimited, fixed field-offset census rows — the manual `split("|")` at each call site stays (the
-// parse indexes by position, not by header). spliterator keeps CRLF's trailing CR where readline stripped
-// it, but every field this parser reads (geo GEOCODE/LOGRECNO ≤ 9, segment-1 LOGRECNO + P2 ≤ 86) sits well
+// Pipe-delimited, fixed field-offset census rows.
+// The manual `split("|")` at each call site stays (the parse indexes by position rather than by header).
+// Spliterator keeps crlf's trailing CR where readline stripped it, but every field
+// this parser reads (geo geocode/logrecno ≤ 9, segment-1 logrecno + P2 ≤ 86) sits well
 // before the final column, so the retained CR only ever lands on an unread trailing field.
-async function eachLine(path: string, fn: (line: string) => void): Promise<void> {
+async function eachLine(path: PathBuilder, fn: (line: string) => void): Promise<void> {
 	for await (const line of TextSpliterator.fromAsync(path)) {
 		if (line) {
 			fn(line)
@@ -167,13 +180,16 @@ async function eachLine(path: string, fn: (line: string) => void): Promise<void>
 }
 
 /**
- * Fetch one state's P.L. 94-171 block race counts into `pl_block`. Yields progress; returns the tally.
+ * Fetch one state's P.L. 94-171 block race counts into `pl_block`.
+ *
+ * Yields progress.
+ * Returns the tally.
  */
 export async function* fetchRedistricting(
 	options: FetchRedistrictingOptions
 ): AsyncGenerator<FetchRedistrictingEvent, FetchRedistrictingResult> {
 	const vintage = options.vintage ?? 2020
-	const dataRoot = options.dataRoot ?? DEFAULT_DATA_ROOT
+	const dataRoot = PathBuilder.from(options.dataRoot ?? DEFAULT_DATA_ROOT)
 	const batchSize = options.batchSize ?? 2000
 	const state = options.stateFIPS
 
@@ -184,26 +200,26 @@ export async function* fetchRedistricting(
 	const dirName = stateName.replaceAll(" ", "_")
 	const fileAbbr = abbr.toLowerCase()
 
-	const cacheDir = join(dataRoot, "census", "redistricting", String(vintage), state)
+	const cacheDir = dataRoot("census", "redistricting", String(vintage), state)
 	// Same stable `tiger.db` default as fetchTIGER — pl_block lives alongside tabblock20 in one DB.
-	const outPath = options.outPath ?? join(dataRoot, "tiger", "tiger.db")
+	const outPath = PathBuilder.from(options.outPath ?? dataRoot("tiger", "tiger.db"))
 	await makeDirectories(cacheDir)
-	await makeDirectories(dirname(outPath))
+	await makeDirectories(outPath.dirname())
 
 	const zipName = `${fileAbbr}${vintage}.pl.zip`
-	const zipPath = join(cacheDir, zipName)
+	const zipPath = cacheDir(zipName)
 	const url = `${REDISTRICTING_BASE}/${dirName}/${zipName}`
 
 	const cached = await downloadIfNeeded(url, zipPath)
 	yield { phase: "download", file: zipName, cached }
 
 	await extractZipEntries(zipPath, cacheDir)
-	const geoPath = join(cacheDir, `${fileAbbr}geo${vintage}.pl`)
-	const seg1Path = join(cacheDir, `${fileAbbr}00001${vintage}.pl`)
-	const seg2Path = join(cacheDir, `${fileAbbr}00002${vintage}.pl`)
+	const geoPath = cacheDir(`${fileAbbr}geo${vintage}.pl`)
+	const seg1Path = cacheDir(`${fileAbbr}00001${vintage}.pl`)
+	const seg2Path = cacheDir(`${fileAbbr}00002${vintage}.pl`)
 	yield { phase: "extract", file: `${fileAbbr}geo${vintage}.pl` }
 
-	// Pass 1: header → LOGRECNO → GEOID for the blocks we want.
+	// Pass 1: header → logrecno → geoid for the blocks we want.
 	const prefix = options.county ? state + options.county : state
 	const logToGeoid = new Map<string, string>()
 
@@ -220,8 +236,9 @@ export async function* fetchRedistricting(
 	const total = logToGeoid.size
 	yield { phase: "header", blocks: total }
 
-	// Pass 1b: segment 2 → H1 housing counts for the mapped LOGRECNOs. Read before segment 1 so a block's P2 and H1
-	// land in one row; a mapped block with no segment-2 row is a data defect the load refuses, never a zero.
+	// Pass 1b: segment 2 → H1 housing counts for the mapped LOGRECNOs.
+	// Read before segment 1 so a block's P2 and H1 land in one row.
+	// A mapped block with no segment-2 row is a data defect the load refuses, never a zero.
 	const h1ByLogrecno = new Map<string, H1Counts>()
 
 	await eachLine(seg2Path, (line) => {
@@ -297,7 +314,7 @@ export async function* fetchRedistricting(
 		yield { phase: "load", inserted, total }
 		kdb.exec("PRAGMA wal_checkpoint(TRUNCATE);")
 
-		return { outPath, table: "pl_block", inserted }
+		return { outPath: outPath.toString(), table: "pl_block", inserted }
 	} finally {
 		await kdb.destroy()
 	}

package/{lib/sdk → sdk}/state/TIGERTabulatedBlockEntity.ts

@@ -4,12 +4,12 @@
  * @author Teffen Ellis, et al.
  */
 
-import { smartSnakeCase } from "@mailwoman/core"
+import { smartSnakeCase } from "spliterator"
 
 import { TIGERProperty } from "#index"
 
 /**
- * Default column selections for TIGER tabulated block entities.
+ * Default column selections for tiger tabulated block entities.
  *
  * @internal
  */
@@ -23,4 +23,4 @@ export const TIGERTabulatedBlockEntitySelections = (
 		TIGERProperty.WaterAreaSqm,
 		TIGERProperty.Population,
 	] as const
-).map((columnName) => smartSnakeCase(columnName))
+).map(smartSnakeCase)

package/{lib/sdk → sdk}/state/block-operations.ts

@@ -22,7 +22,7 @@ export interface StateBlockIntersectionCriteria {
 	tractCodes?: FIPSTractCode[]
 }
 
-//#region Row parsing
+// #region Row parsing
 
 /**
  * @internal
@@ -36,7 +36,7 @@ export interface TIGERBlockRow extends TIGERTabulatedBlockProperties {
 }
 
 /**
- * Given a row from the TIGER tabulated block table, parses it into a GeoJSON feature.
+ * Given a row from the tiger tabulated block table, parses it into a GeoJSON feature.
  *
  * @internal
  */
@@ -52,7 +52,8 @@ export function parseTIGERBlockFromRow({ serializedGeometry, ...properties }: TI
 }
 
 /**
- * Given a collection of rows from the TIGER tabulated block table, parses them into a GeoJSON feature collection.
+ * Given a collection of rows from the tiger tabulated block table,
+ * parses them into a GeoJSON feature collection.
  *
  * @internal
  */
@@ -67,4 +68,4 @@ export function parseTIGERBlockFeatureCollectionFromRows(rows: TIGERBlockRow[]):
 	return featureCollection
 }
 
-//#endregion
+// #endregion

package/{lib/tools/race-dots-map.ts → tools/race/dots/map.ts}

@@ -9,8 +9,8 @@
  *   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
- *   representation, not a record about any address. Serve over localhost (the house tile server
- *   CORS-restricts to localhost + the docs domains) — `mailwoman tiger race-dots-map --serve` wires
+ *   representation rather than a record about any address. Serve over localhost (the house tile server
+ *   cors-restricts to localhost + the docs domains) — `mailwoman tiger race-dots-map --serve` wires
  *   {@linkcode serveWithRangeSupport} for exactly this.
  *
  *   Run: `mailwoman tiger race-dots-map --pmtiles-url
@@ -19,37 +19,52 @@
 
 import { tempRootPath } from "@mailwoman/core/data-root"
 import { writeLocalFile } from "@mailwoman/core/fs/writers"
+import { stringifyJSON } from "@mailwoman/core/json"
 
 /**
  * Options for {@linkcode raceDotsMap}.
  */
 export interface RaceDotsMapOptions {
 	/**
-	 * Dots tileset URL the page reads client-side. Default `http://localhost:8899/race-dots-oc.pmtiles`.
+	 * 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`.
+	 * Output html path.
+	 *
+	 * Default `/tmp/race-dots-oc.html`.
 	 */
 	out?: string
 	/**
-	 * People represented by one dot (title/legend copy only). Default 5.
+	 * People represented by one dot (title/legend copy only).
+	 *
+	 * Default 5.
 	 */
 	per?: number
 	/**
-	 * Page title. Default derives from `per`.
+	 * Page title.
+	 *
+	 * Default derives from `per`.
 	 */
 	title?: string
 	/**
-	 * Initial map center longitude. Default -117.83 (Orange County, CA).
+	 * Initial map center longitude.
+	 *
+	 * Default -117.83 (Orange County, CA).
 	 */
 	lng?: number
 	/**
-	 * Initial map center latitude. Default 33.68.
+	 * Initial map center latitude.
+	 *
+	 * Default 33.68.
 	 */
 	lat?: number
 	/**
-	 * Initial map zoom. Default 9.4.
+	 * Initial map zoom.
+	 *
+	 * Default 9.4.
 	 */
 	zoom?: number
 }
@@ -69,7 +84,10 @@ const PMTILES_VERSION = "4.4.1"
 
 const BASEMAP_SOURCE_ID = "basemap-v4"
 const BASEMAP_TILEJSON_URL = "https://tiles.mailwoman.ai/basemap-v4.json"
-const GLYPHS_URL = "https://protomaps.github.io/basemaps-assets/fonts/{fontstack}/{range}.pbf"
+// The glyph mirror and its Bliss Pro stacks, as `@mailwoman/cartographer/styles/fonts` documents them.
+// Cartographer depends on this package, so these values are restated here rather than imported.
+const GLYPHS_URL = "https://public.mailwoman.ai/protomaps/fonts/{fontstack}/{range}.pbf"
+const MAP_FONTS = { regular: "Bliss Pro Regular", bold: "Bliss Pro Medium", italic: "Bliss Pro Italic" }
 const SPRITE_URL = "https://protomaps.github.io/basemaps-assets/sprites/v4/light"
 
 /**
@@ -133,7 +151,7 @@ export async function raceDotsMap(
 			dots: { type: "vector", url: "pmtiles://" + PMTILES_URL },
 		},
 		layers: [
-			...(layers(BASEMAP_SOURCE_ID, namedFlavor("light"), { lang: "en" }) as unknown[]),
+			...(layers(BASEMAP_SOURCE_ID, { ...namedFlavor("light"), ...MAP_FONTS }, { lang: "en" }) as unknown[]),
 			{
 				id: "race-dots",
 				type: "circle",
@@ -182,7 +200,7 @@ export async function raceDotsMap(
 	maplibregl.addProtocol("pmtiles", protocol.tile);
 	var map = new maplibregl.Map({
 		container: "map",
-		style: ${JSON.stringify(style)},
+		style: ${stringifyJSON(style)},
 		center: [${CENTER_LNG}, ${CENTER_LAT}],
 		zoom: ${ZOOM},
 		attributionControl: false

package/{lib/tools/race-dots.ts → tools/race/dots.ts}

@@ -3,34 +3,17 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- *   Race-by-dot-density builder — the Cooper Center "Racial Dot Map" recipe, from the TIGER DB the
- *   `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
- *   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.
- *
- *   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: `mailwoman tiger race-dots --db tiger-oc.db --per 10 --out /tmp/race-dots.ndjson`
+ *   A dot is a representation rather than a record: a random position inside the block it belongs to,
+ *   making no statement about any individual address.
  */
 
 import { dataRootPath, tempRootPath } from "@mailwoman/core/data-root"
 import { openWriteStream } from "@mailwoman/core/fs/streams"
-import { tryParsingJSON } from "@mailwoman/core/json"
+import { tryParsingJSON, stringifyJSON } from "@mailwoman/core/json"
 import { DatabaseClient } from "@mailwoman/sqlite/client"
 
-import type { TIGERDatabase } from "#sdk/schema"
+import type { TIGERDatabase } from "#schema"
 
-/**
- * Attempts to place a dot inside its polygon by rejection sampling before giving up on it.
- */
 const MAX_PLACEMENT_TRIES = 60
 
 /**
@@ -38,19 +21,19 @@ const MAX_PLACEMENT_TRIES = 60
  */
 export interface RaceDotsOptions {
 	/**
-	 * TIGER SQLite DB (`tabblock20` ⋈ `pl_block`). Default `$MAILWOMAN_DATA_ROOT/tiger/tiger-oc.db`.
+	 * Tiger SQLite DB (`tabblock20` ⋈ `pl_block`).
 	 */
 	db?: string
 	/**
-	 * Output NDJSON path. Default `/tmp/race-dots.ndjson`.
+	 * Output ndjson path.
 	 */
 	out?: string
 	/**
-	 * People represented by one dot. Default 10.
+	 * People represented by one dot.
 	 */
 	per?: number
 	/**
-	 * Tippecanoe layer name. Default `dots`.
+	 * Tippecanoe layer name.
 	 */
 	layer?: string
 }
@@ -70,7 +53,7 @@ export interface RaceDotsResult {
 }
 
 /**
- * The eight P2 categories (columns in pl_block) that partition each block's population.
+ * The P2 categories (columns in `pl_block`) that partition each block's population.
  */
 const CATEGORIES = ["hispanic", "white", "black", "asian", "aian", "nhpi", "other", "multi"] as const
 
@@ -106,7 +89,7 @@ function bbox(rings: PolygonCoords): [number, number, number, number] {
 }
 
 /**
- * Race-by-dot-density NDJSON builder — see the module doc.
+ * Race-by-dot-density ndjson builder.
  */
 export async function raceDots(
 	options: RaceDotsOptions = {},
@@ -114,14 +97,14 @@ export async function raceDots(
 ): Promise<RaceDotsResult> {
 	const DB = options.db || dataRootPath("tiger", "tiger-oc.db")
 	const OUT = options.out || tempRootPath("race-dots.ndjson")
-	const PER = options.per ?? 10 // people represented by one dot
+	const PER = options.per ?? 10
 	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).
+	// Pick a bbox-area-weighted sub-polygon, then rejection-sample inside it.
+	// Turf handles holes and winding.
 	function randomPointIn(polys: PolygonCoords[], areas: number[], totalArea: number): [number, number] | null {
 		let r = Math.random() * totalArea
 		let pick = 0
@@ -200,7 +183,7 @@ export async function raceDots(
 				}
 
 				out.write(
-					JSON.stringify({
+					stringifyJSON({
 						type: "Feature",
 						tippecanoe: { layer: LAYER },
 						properties: { cat },

package/{lib/tools → tools}/serve-range.ts

@@ -3,19 +3,19 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- *   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
+ *   Minimal static file server that honors http Range requests (206) — Python's `http.server` does
+ *   not. PMTiles reads via Range, so this server cannot serve it. Used to preview/render a local
  *   `.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.
+ *   production. the deployed tiles go through the tile worker.
  *
  *   Internal helper module — no standalone command.
  */
 
 import { createServer, type IncomingMessage, type Server, type ServerResponse } from "node:http"
 
+import { tempRootPath } from "@mailwoman/core/data-root"
 import { statPath, type Stats } from "@mailwoman/core/fs/readers"
 import { openReadStream } from "@mailwoman/core/fs/streams"
-import { mailwomanTempRoot } from "@mailwoman/core/utils"
 import { extname, join, normalize } from "path-ts"
 
 /**
@@ -23,11 +23,15 @@ import { extname, join, normalize } from "path-ts"
  */
 export interface ServeRangeOptions {
 	/**
-	 * Directory to serve. Default `/tmp`.
+	 * Directory to serve.
+	 *
+	 * Default `/tmp`.
 	 */
 	dir?: string
 	/**
-	 * Port to listen on. Default 8899.
+	 * Port to listen on.
+	 *
+	 * Default 8899.
 	 */
 	port?: number
 }
@@ -50,14 +54,16 @@ const TYPES: Record<string, string> = {
 }
 
 /**
- * Serve `dir` over localhost with HTTP Range support. Resolves once the server is listening; the caller owns the
- * lifetime (dispose it to stop; commands typically hold the process open instead).
+ * Serve `dir` over localhost with http Range support.
+ *
+ * Resolves once the server is listening.
+ * The caller owns the lifetime (dispose it to stop. Commands typically hold the process open instead).
  */
 export async function serveWithRangeSupport(
 	options: ServeRangeOptions = {},
 	report?: (line: string) => void
 ): Promise<RangeServer> {
-	const dir = options.dir || String(mailwomanTempRoot())
+	const dir = options.dir || tempRootPath()
 	const port = options.port ?? 8899
 
 	const server = createServer(async (req: IncomingMessage, res: ServerResponse) => {

package/lib/sdk/download.ts

@@ -1,49 +0,0 @@
-/**
- * @copyright Sister Software
- * @license AGPL-3.0
- * @author Teffen Ellis, et al.
- *
- *   Cached archive download + subprocess capture, shared by `fetch.ts` and `redistricting.ts`.
- *
- *   RAW `fetch` HERE IS DELIBERATE. `AGENTS.md` requires HTTP clients to extend or instantiate
- *   `APIClient`, and that rule is about API REQUESTS — small bodies, repeated calls, rate-limited
- *   hosts, where its pacing, bounded retry, response caching and `ResourceError` mapping all earn
- *   their keep. This is a multi-gigabyte file transfer streamed straight to disk. Response caching
- *   would be nonsense at that size, pacing has nothing to pace (one request), and axios buffers a
- *   non-stream response type in memory. The primitive that fits a body this large is the one that
- *   never holds it: a web stream piped to a write stream.
- */
-
-import { pathExists } from "@mailwoman/core/fs/readers"
-import { openWriteStream, pipeline, Readable } from "@mailwoman/core/fs/streams"
-import { movePath } from "@mailwoman/core/fs/writers"
-import { verifyZipIntegrity } from "@mailwoman/core/fs/zip"
-
-/**
- * Download `url` to `dest` unless a VALID copy is already there. Returns `true` when the cache was reused, `false` when
- * a download happened.
- *
- * "Valid" means every member's CRC-32 checks out — an existence check alone is not enough, because an interrupted
- * download leaves a plausible-looking file that fails only much later, inside ogr2ogr. Writes to a `.tmp` sibling and
- * renames, so `dest` is never a partial archive.
- */
-export async function downloadIfNeeded(url: string, dest: string): Promise<boolean> {
-	if (await pathExists(dest)) {
-		try {
-			await verifyZipIntegrity(dest)
-
-			return true
-		} catch {
-			// corrupt cache — re-download
-		}
-	}
-
-	const tmp = dest + ".tmp"
-	const res = await fetch(url, { redirect: "follow" })
-
-	if (!res.ok || !res.body) throw new Error(`HTTP ${res.status} fetching ${url}`)
-	await pipeline(Readable.fromWeb(res.body as Parameters<typeof Readable.fromWeb>[0]), openWriteStream(tmp))
-	await movePath(tmp, dest)
-
-	return false
-}

package/lib/sdk/index.ts

@@ -1,10 +0,0 @@
-/**
- * @copyright Sister Software.
- * @license AGPL-3.0
- * @author Teffen Ellis, et al.
- */
-
-export * from "#sdk/fetch"
-export * from "#sdk/redistricting"
-export * from "#sdk/schema"
-export * from "#sdk/state/index"

package/lib/tools/index.ts

@@ -1,11 +0,0 @@
-/**
- * @copyright Sister Software
- * @license AGPL-3.0
- * @author Teffen Ellis, et al.
- *
- *   TIGER operator tool exports.
- */
-
-export * from "#tools/race-dots"
-export * from "#tools/race-dots-map"
-export * from "#tools/serve-range"

package/out/county-subdivision.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"county-subdivision.d.ts","sourceRoot":"","sources":["../lib/county-subdivision.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAC/D,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,yBAAyB,CAAA;AAC9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAA;AAE7C;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACtC;;OAEG;IACH,OAAO,EAAE,eAAe,CAAA;IAExB;;;;;OAKG;IACH,QAAQ,EAAE,MAAM,CAAA;IAEhB;;;;;;OAMG;IACH,QAAQ,EAAE,MAAM,CAAA;IAEhB;;;;;;;OAOG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB;;;;;;;;OAQG;IACH,KAAK,EAAE,MAAM,CAAA;IAEb;;;;;;;OAOG;IACH,OAAO,EAAE,MAAM,CAAA;IAEf;;;;;;OAMG;IACH,QAAQ,EAAE,MAAM,CAAA;IAEhB;;;;OAIG;IACH,IAAI,EAAE,+BAA+B,CAAA;IAErC;;;;OAIG;IACH,OAAO,EAAE,cAAc,CAAA;IAEvB;;;;;;;;OAQG;IACH,KAAK,EAAE,MAAM,CAAA;IAEb;;;;;;;OAOG;IACH,QAAQ,EAAE,qBAAqB,CAAA;IAE/B;;;;;OAKG;IACH,KAAK,EAAE,MAAM,CAAA;IAEb;;;;;OAKG;IACH,MAAM,EAAE,MAAM,CAAA;IAEd;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAA;IAEhB;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAA;IAEhB;;;;;;OAMG;IACH,IAAI,EAAE,MAAM,CAAA;CACZ"}

package/out/county-subdivision.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"county-subdivision.js","sourceRoot":"","sources":["../lib/county-subdivision.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/out/sdk/index.d.ts

@@ -1,10 +0,0 @@
-/**
- * @copyright Sister Software.
- * @license AGPL-3.0
- * @author Teffen Ellis, et al.
- */
-export * from "#sdk/fetch";
-export * from "#sdk/redistricting";
-export * from "#sdk/schema";
-export * from "#sdk/state/index";
-//# sourceMappingURL=index.d.ts.map

package/out/sdk/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../lib/sdk/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAA;AAC1B,cAAc,oBAAoB,CAAA;AAClC,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA"}

package/out/sdk/index.js

@@ -1,10 +0,0 @@
-/**
- * @copyright Sister Software.
- * @license AGPL-3.0
- * @author Teffen Ellis, et al.
- */
-export * from "#sdk/fetch";
-export * from "#sdk/redistricting";
-export * from "#sdk/schema";
-export * from "#sdk/state/index";
-//# sourceMappingURL=index.js.map

package/out/sdk/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../lib/sdk/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAA;AAC1B,cAAc,oBAAoB,CAAA;AAClC,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA"}