@mailwoman/cartographer 9.2.0 → 9.4.0

package/{base → lib/base}/buildings.ts

@@ -10,8 +10,9 @@ import type {
 	LayerSpecification,
 } from "@maplibre/maplibre-gl-style-spec"
 
-import { LayerID } from "../styles/layers.ts"
-import { MailwomanBaseTileSetID } from "./theme.ts"
+import { MailwomanBaseTileSetID } from "#base/theme"
+import { PROTOMAPS_FONT_REGULAR } from "#styles/fonts"
+import { LayerID } from "#styles/layers"
 
 const BuildingLayerID = LayerID.bind(null, "buildings")
 
@@ -114,7 +115,7 @@ export const BuildingLayers: LayerSpecification[] = [
 			"text-field": ["to-string", ["id"]],
 			"text-offset": [0, 0],
 			"text-anchor": "center",
-			"text-font": ["Fira Sans Regular"],
+			"text-font": [PROTOMAPS_FONT_REGULAR],
 		},
 
 		paint: {

package/{base → lib/base}/composition.ts

@@ -4,17 +4,17 @@
  * @author Teffen Ellis, et al.
  */
 
-import type { SourceSpecification } from "@maplibre/maplibre-gl-style-spec"
+import type { LayerSpecification, SourceSpecification } from "@maplibre/maplibre-gl-style-spec"
 import type { LightSpecification, SkySpecification, StyleSpecification, TerrainSpecification } from "maplibre-gl"
 
+import { BaseLayers } from "#base/layers"
+import { createTerrainDEMSource, HillshadeTileSetID } from "#base/terrain"
 import {
 	LayerSpecificationList,
 	type LayerSpecificationListInput,
 	type LayerSpecificationListItem,
-} from "../styles/layers.ts"
-import type { TileSetSourceRecord } from "../styles/sources.ts"
-import { BaseLayers } from "./layers.ts"
-import { createTerrainDEMSource, HillshadeTileSetID } from "./terrain.ts"
+} from "#styles/layers"
+import type { TileSetSourceRecord } from "#styles/sources"
 
 //#endregion
 
@@ -50,12 +50,38 @@ export function createSkySpec(spec?: Partial<SkySpecification>): SkySpecificatio
 
 //#region Style Composition
 
+/**
+ * The glyph host every style composed here reads fonts from. The Protomaps font set, mirrored under the public bucket
+ * so a style never depends on an upstream host at render time.
+ */
+export const PROTOMAPS_GLYPHS_URL = "https://public.mailwoman.ai/protomaps/fonts/{fontstack}/{range}.pbf"
+
+/**
+ * The Earth sprite. It must match the basemap schema version: the v4 sprite carries the icons the v4 theme's layers
+ * reference by name, so a style over a different basemap version needs a different sprite.
+ */
+export const PROTOMAPS_SPRITE_URL = "https://public.mailwoman.ai/protomaps/sprites/v4/light"
+
 export interface StyleSpecificationComposition {
 	sources: Record<string, SourceSpecification>
 	layers?: LayerSpecificationListInput[]
 	light?: Partial<LightSpecification>
 	sky?: Partial<SkySpecification>
 	terrain?: Partial<TerrainSpecification>
+	/**
+	 * The layer list every `layers` entry inserts into. Earth's basemap layers by default; a body with no roads, water or
+	 * buildings brings its own.
+	 */
+	baseLayers?: LayerSpecification[]
+	/**
+	 * The `hillshade` source. Earth's terrarium DEM by default; `null` adds no such source.
+	 */
+	hillshadeSource?: SourceSpecification | null
+	/**
+	 * The sprite URL. Earth's Protomaps v4 sprite by default; `null` omits the key, for a style with no icons.
+	 */
+	sprite?: string | null
+	glyphs?: string
 }
 
 /**
@@ -67,23 +93,29 @@ export class StyleSpecificationComposer {
 	sky: SkySpecification
 	// terrain: TerrainSpecification
 	sources: TileSetSourceRecord
+	sprite: string | null
+	glyphs: string
 
 	constructor(spec: StyleSpecificationComposition) {
 		this.light = createLightSpec(spec.light)
 		this.sky = createSkySpec(spec.sky)
+		this.sprite = spec.sprite === undefined ? PROTOMAPS_SPRITE_URL : spec.sprite
+		this.glyphs = spec.glyphs ?? PROTOMAPS_GLYPHS_URL
 
 		// this.terrain = {
 		// 	source: TerrainTileSetID,
 		// 	...spec.terrain,
 		// }
 
+		const hillshadeSource = spec.hillshadeSource === undefined ? createTerrainDEMSource() : spec.hillshadeSource
+
 		this.sources = {
 			...spec.sources,
 			// [TerrainTileSetID]: createTerrainDEMSource(),
-			[HillshadeTileSetID]: createTerrainDEMSource(),
+			...(hillshadeSource ? { [HillshadeTileSetID]: hillshadeSource } : {}),
 		}
 
-		this.layersList = new LayerSpecificationList(BaseLayers)
+		this.layersList = new LayerSpecificationList(spec.baseLayers ?? BaseLayers)
 
 		for (const layer of spec.layers || []) {
 			this.layersList.insert(layer)
@@ -97,11 +129,8 @@ export class StyleSpecificationComposer {
 	toJSON(): StyleSpecification {
 		const styleSpec: StyleSpecification = {
 			version: 8,
-			// Sprite must match the basemap schema version — v4 sprites carry the icons referenced
-			// by the v4 theme spec. Currently upstream URLs; we mirror these to nexus-assets/{fonts,
-			// sprites/v4}/ for self-hosting, but no public route fronts that bucket yet.
-			glyphs: "https://public.sister.software/protomaps/fonts/{fontstack}/{range}.pbf",
-			sprite: "https://public.sister.software/protomaps/sprites/v4/light",
+			glyphs: this.glyphs,
+			...(this.sprite === null ? {} : { sprite: this.sprite }),
 			light: createLightSpec(this.light),
 			sky: createSkySpec(this.sky),
 			// terrain: this.terrain,

package/lib/base/index.ts

@@ -0,0 +1,10 @@
+/**
+ * @copyright Sister Software.
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+
+export * from "#base/buildings"
+export * from "#base/composition"
+export * from "#base/layers"
+export * from "#base/theme"

package/{base → lib/base}/layers.ts

@@ -7,10 +7,10 @@
 import { layers } from "@protomaps/basemaps"
 import type { LayerSpecification } from "maplibre-gl"
 
-import { MailwomanBaseFlavor, MailwomanBaseTileSetID } from "../base/theme.ts"
-import { LayerID } from "../styles/layers.ts"
-import { BuildingLayers } from "./buildings.ts"
-import { HillshadeTileSetID } from "./terrain.ts"
+import { BuildingLayers } from "#base/buildings"
+import { HillshadeTileSetID } from "#base/terrain"
+import { MailwomanBaseFlavor, MailwomanBaseTileSetID } from "#base/theme"
+import { LayerID } from "#styles/layers"
 
 /**
  * Layer id for the hillshade raster, referenced by style definitions that draw terrain beneath the base map.

package/{base → lib/base}/terrain.ts

@@ -6,7 +6,7 @@
 
 import type { RasterDEMSourceSpecification } from "@maplibre/maplibre-gl-style-spec"
 
-import { TileSetSourceID } from "../styles/sources.ts"
+import { TileSetSourceID } from "#styles/sources"
 
 /**
  * Creates a raster DEM source specification for terrain data.

package/{base → lib/base}/theme.ts

@@ -6,12 +6,12 @@
 
 import { type Flavor, namedFlavor } from "@protomaps/basemaps"
 
-import { TileSetSourceID } from "../styles/sources.ts"
+import { TileSetSourceID } from "#styles/sources"
 
 /**
  * Identifier for the Mailwoman base tileset. Matches the R2 object basename (`nexus-assets/tiles/basemap-v4.pmtiles`) —
- * `tiles.sister.software/basemap-v4.json` returns its tilejson, `tiles.sister.software/basemap-v4/{z}/{x}/{y}.mvt`
- * returns vector tiles.
+ * `tiles.mailwoman.ai/basemap-v4.json` returns its tilejson, `tiles.mailwoman.ai/basemap-v4/{z}/{x}/{y}.mvt` returns
+ * vector tiles.
  */
 export const MailwomanBaseTileSetID = TileSetSourceID("basemap-v4")
 

package/{bdc → lib/bdc}/index.ts

@@ -15,8 +15,8 @@ import type {
 } from "@maplibre/maplibre-gl-style-spec"
 import { interpolateTurbo } from "d3-scale-chromatic"
 
-import type { LayerSpecificationListInput } from "../styles/layers.ts"
-import { TileSetSourceID } from "../styles/sources.ts"
+import type { LayerSpecificationListInput } from "#styles/layers"
+import { TileSetSourceID } from "#styles/sources"
 
 /**
  * Identifier for the Broadband Data Collection tile set.
@@ -46,17 +46,28 @@ export type BaseBDCLayerSpecification<T> = T extends BDCLayerSpecificationInput
 	? Omit<T, "source-layer" | "source">
 	: never
 
-function createBDCBlockLayer<T extends BDCLayerSpecificationInput>(spec: BaseBDCLayerSpecification<T>): T {
+/**
+ * The three builders below take a spec WITHOUT the source fields and return one with them filled in.
+ *
+ * They are not generic, and the assertion each ends with is single rather than through `unknown`, both for the same
+ * reason: TypeScript cannot verify that `Omit<T, K>` plus the omitted keys reconstitutes `T`, so a builder declared
+ * `<T>(…): T` can only reach its return type by defeating the checker entirely — which then covers the `id`, `minzoom`
+ * and `maxzoom` values too. Nothing wanted the narrowing: the sole consumer, {@linkcode BroadbandDataCollectionLayers},
+ * annotates the union.
+ */
+type BDCLayerBuilderInput = BaseBDCLayerSpecification<BDCLayerSpecificationInput>
+
+function createBDCBlockLayer(spec: BDCLayerBuilderInput): BDCLayerSpecificationInput {
 	return {
 		...spec,
 		id: `bdc_${TIGERLevel.Block}_${spec.id}`,
 		source: BDCTileSetID,
 		"source-layer": `bdc_${TIGERLevel.Block}`,
 		minzoom: 12,
-	} as unknown as T
+	} as BDCLayerSpecificationInput
 }
 
-function createBDCTractLayer<T extends BDCLayerSpecificationInput>(spec: BaseBDCLayerSpecification<T>): T {
+function createBDCTractLayer(spec: BDCLayerBuilderInput): BDCLayerSpecificationInput {
 	return {
 		...spec,
 		id: `bdc_${TIGERLevel.Tract}_${spec.id}`,
@@ -64,10 +75,10 @@ function createBDCTractLayer<T extends BDCLayerSpecificationInput>(spec: BaseBDC
 		"source-layer": `bdc_${TIGERLevel.Tract}`,
 		maxzoom: 12,
 		minzoom: 9,
-	} as unknown as T
+	} as BDCLayerSpecificationInput
 }
 
-function createBDCCountyLayer<T extends BDCLayerSpecificationInput>(spec: BaseBDCLayerSpecification<T>): T {
+function createBDCCountyLayer(spec: BDCLayerBuilderInput): BDCLayerSpecificationInput {
 	return {
 		...spec,
 		id: `bdc_${TIGERLevel.County}_${spec.id}`,
@@ -75,11 +86,11 @@ function createBDCCountyLayer<T extends BDCLayerSpecificationInput>(spec: BaseBD
 		"source-layer": `bdc_${TIGERLevel.County}`,
 		maxzoom: 9,
 		minzoom: 2,
-	} as unknown as T
+	} as BDCLayerSpecificationInput
 }
 
-export function createBDCLayer<T extends BDCLayerSpecificationInput>(spec: BaseBDCLayerSpecification<T>): T[] {
-	return [createBDCBlockLayer(spec), createBDCTractLayer(spec), createBDCCountyLayer(spec)] as T[]
+export function createBDCLayer(spec: BDCLayerBuilderInput): BDCLayerSpecificationInput[] {
+	return [createBDCBlockLayer(spec), createBDCTractLayer(spec), createBDCCountyLayer(spec)]
 }
 
 const GIGABIT_BROADBAND_SPEED = 1000

package/{coverage → lib/coverage}/index.ts

@@ -18,13 +18,13 @@
  *   demo's LayerToggleControl gives each its own checkbox — pick the reading you want, no extra UI.
  *
  *   Served as XYZ vector tiles by the tile worker from `nexus-assets/tiles/coverage-v5.pmtiles` (same
- *   as `basemap-v4`); the consumer passes its TileJSON URL (`tiles.sister.software/coverage-v5.json`)
+ *   as `basemap-v4`); the consumer passes its TileJSON URL (`tiles.mailwoman.ai/coverage-v5.json`)
  *   to `createCoverageSource`.
  */
 
 import type { FillLayerSpecification, VectorSourceSpecification } from "@maplibre/maplibre-gl-style-spec"
 
-import { TileSetSourceID } from "../styles/sources.ts"
+import { TileSetSourceID } from "#styles/sources"
 
 export const CoverageTileSetID = TileSetSourceID("coverage-v5")
 
@@ -55,7 +55,7 @@ export const CoverageLayerID = {
 
 /**
  * Build the coverage source spec from the tile worker's TileJSON endpoint
- * (`https://tiles.sister.software/coverage-v5.json`).
+ * (`https://tiles.mailwoman.ai/coverage-v5.json`).
  */
 export function createCoverageSource(url: string): VectorSourceSpecification {
 	return { type: "vector", url }

package/{hspa → lib/hspa}/index.ts

@@ -4,8 +4,8 @@
  * @author Teffen Ellis, et al.
  */
 
-// import { LayerSpecificationListInput } from "../styles/layers.ts"
-import { TileSetSourceID } from "../styles/sources.ts"
+// import { LayerSpecificationListInput } from "#styles/layers"
+import { TileSetSourceID } from "#styles/sources"
 
 /**
  * Identifier for the Health Service Provider Access tile set.

package/lib/index.ts

@@ -0,0 +1,12 @@
+/**
+ * @copyright Sister Software.
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+
+export * from "#base/index"
+export * from "#bdc/index"
+export * from "#hspa/index"
+export * from "#styles/index"
+export * from "#tiger/index"
+export * from "#tiles/index"

package/lib/planetary/index.ts

@@ -0,0 +1,9 @@
+/**
+ * @copyright Sister Software.
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+
+export * from "#planetary/layers"
+export * from "#planetary/sources"
+export * from "#planetary/style"

package/lib/planetary/layers.ts

@@ -0,0 +1,123 @@
+/**
+ * @copyright Sister Software.
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+
+import type {
+	BackgroundLayerSpecification,
+	CircleLayerSpecification,
+	RasterLayerSpecification,
+	SymbolLayerSpecification,
+} from "@maplibre/maplibre-gl-style-spec"
+
+import { PlanetaryHillshadeSourceID, PlanetaryNomenclatureSourceID } from "#planetary/sources"
+import { PROTOMAPS_FONT_REGULAR } from "#styles/fonts"
+import { LayerID } from "#styles/layers"
+
+export interface PlanetaryPalette {
+	space: string
+	labelColor: string
+	labelHalo: string
+	selection: string
+}
+
+/**
+ * One palette per body with a published style. The record's keys are the bodies a style can be composed for, so a body
+ * without a row here has no style rather than a wrong one.
+ */
+export const PALETTES = {
+	moon: { space: "#05070d", labelColor: "#e8eef7", labelHalo: "#05070d", selection: "#7fd1ff" },
+	mars: { space: "#0a0604", labelColor: "#f6e3d1", labelHalo: "#1a0c06", selection: "#ffb37f" },
+} as const satisfies Record<string, PlanetaryPalette>
+
+export type PlanetaryStyleBody = keyof typeof PALETTES
+
+const PLANETARY_NAMESPACE = "planetary"
+
+/**
+ * The background layer: the body's space color, drawn first.
+ */
+export const PlanetarySpaceLayerID = LayerID(PLANETARY_NAMESPACE, "space")
+
+/**
+ * The hillshade raster layer, present only when the body has a hillshade tileset.
+ */
+export const PlanetaryHillshadeLayerID = LayerID(PLANETARY_NAMESPACE, "hillshade")
+
+/**
+ * The nomenclature label layer, the one an app reads feature properties from on a click.
+ */
+export const PlanetaryLabelsLayerID = LayerID(PLANETARY_NAMESPACE, "nomenclature-labels")
+
+/**
+ * The selection ring layer, the one an app sets a feature `id` filter on.
+ */
+export const PlanetarySelectionLayerID = LayerID(PLANETARY_NAMESPACE, "selection")
+
+/**
+ * The IAU feature-type codes drawn as spaced capitals: a mare, planitia, oceanus or terra spans a region rather than
+ * marking a point, and the wide setting reads as an area name the way a printed atlas sets one.
+ */
+const REGION_FEATURE_TYPE_CODES = ["ME", "PL", "OC", "TA"]
+
+export function spaceLayer(palette: PlanetaryPalette): BackgroundLayerSpecification {
+	return {
+		id: PlanetarySpaceLayerID,
+		type: "background",
+		paint: { "background-color": palette.space },
+	}
+}
+
+export function hillshadeLayer(): RasterLayerSpecification {
+	return {
+		id: PlanetaryHillshadeLayerID,
+		type: "raster",
+		source: PlanetaryHillshadeSourceID,
+		paint: { "raster-opacity": 0.9, "raster-resampling": "linear" },
+	}
+}
+
+/**
+ * Labels by feature scale: the tile's per-feature `minzoom` already hides a small crater at a low zoom, so the symbol
+ * layer only sizes and prioritizes. `featureTypeCode` is the IAU feature-type code carried in the tile properties (AA
+ * crater, MO mons, VA vallis, ME mare, PL planitia, SF satellite feature); `diameterKm` is the feature's diameter.
+ */
+export function labelLayer(palette: PlanetaryPalette): SymbolLayerSpecification {
+	return {
+		id: PlanetaryLabelsLayerID,
+		type: "symbol",
+		source: PlanetaryNomenclatureSourceID,
+		"source-layer": "nomenclature",
+		layout: {
+			"text-field": ["get", "name"],
+			"text-font": [PROTOMAPS_FONT_REGULAR],
+			"text-size": ["interpolate", ["linear"], ["coalesce", ["get", "diameterKm"], 0], 0, 11, 100, 14, 1000, 18],
+			"text-transform": ["match", ["get", "featureTypeCode"], REGION_FEATURE_TYPE_CODES, "uppercase", "none"],
+			"text-letter-spacing": ["match", ["get", "featureTypeCode"], REGION_FEATURE_TYPE_CODES, 0.15, 0.02],
+			"symbol-sort-key": ["-", 0, ["coalesce", ["get", "diameterKm"], 0]],
+			"text-allow-overlap": false,
+		},
+		paint: { "text-color": palette.labelColor, "text-halo-color": palette.labelHalo, "text-halo-width": 1.2 },
+	}
+}
+
+/**
+ * The selection ring. Its filter matches no feature until the app sets one by `id`, so the layer ships in the style and
+ * the app never inserts a layer at runtime.
+ */
+export function selectionLayer(palette: PlanetaryPalette): CircleLayerSpecification {
+	return {
+		id: PlanetarySelectionLayerID,
+		type: "circle",
+		source: PlanetaryNomenclatureSourceID,
+		"source-layer": "nomenclature",
+		filter: ["==", ["get", "id"], ""],
+		paint: {
+			"circle-radius": 14,
+			"circle-color": "transparent",
+			"circle-stroke-color": palette.selection,
+			"circle-stroke-width": 2,
+		},
+	}
+}

package/lib/planetary/sources.ts

@@ -0,0 +1,38 @@
+/**
+ * @copyright Sister Software.
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+
+import type { RasterSourceSpecification, VectorSourceSpecification } from "@maplibre/maplibre-gl-style-spec"
+
+import { TileSetSourceID } from "#styles/sources"
+
+/**
+ * The vector source carrying a body's IAU nomenclature: one `nomenclature` source layer of named features.
+ */
+export const PlanetaryNomenclatureSourceID = TileSetSourceID("nomenclature")
+
+/**
+ * The raster source carrying a body's hillshade, rendered from its DEM at build time.
+ */
+export const PlanetaryHillshadeSourceID = TileSetSourceID("hillshade")
+
+/**
+ * MapLibre resolves a TileJSON `url` itself: tiles, bounds, zoom range and attribution all come from the tile worker's
+ * document, so nothing here restates them.
+ */
+export function nomenclatureSource(tileJSONURL: string): VectorSourceSpecification {
+	return {
+		type: "vector",
+		url: tileJSONURL,
+	}
+}
+
+export function hillshadeSource(tileJSONURL: string): RasterSourceSpecification {
+	return {
+		type: "raster",
+		url: tileJSONURL,
+		tileSize: 256,
+	}
+}

package/lib/planetary/style.ts

@@ -0,0 +1,66 @@
+/**
+ * @copyright Sister Software.
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+
+import type { SourceSpecification, StyleSpecification } from "@maplibre/maplibre-gl-style-spec"
+
+import { StyleSpecificationComposer } from "#base/composition"
+import {
+	hillshadeLayer,
+	labelLayer,
+	PALETTES,
+	type PlanetaryStyleBody,
+	selectionLayer,
+	spaceLayer,
+} from "#planetary/layers"
+import {
+	hillshadeSource,
+	nomenclatureSource,
+	PlanetaryHillshadeSourceID,
+	PlanetaryNomenclatureSourceID,
+} from "#planetary/sources"
+
+export interface PlanetaryStyleOptions {
+	body: PlanetaryStyleBody
+	/**
+	 * The TileJSON document of the body's nomenclature tileset.
+	 */
+	nomenclatureTileJSONURL: string
+	/**
+	 * The TileJSON document of the body's hillshade tileset. Without one the style draws labels over bare space.
+	 */
+	hillshadeTileJSONURL?: string
+}
+
+/**
+ * A body's whole style: space, the hillshade when a tileset exists, the nomenclature labels, and the selection ring. No
+ * Earth layer, no Earth DEM and no sprite reach the result, so a viewer loads nothing Earth-shaped.
+ */
+export function createPlanetaryStyle(options: PlanetaryStyleOptions): StyleSpecification {
+	const palette = PALETTES[options.body]
+
+	const sources: Record<string, SourceSpecification> = {
+		[PlanetaryNomenclatureSourceID]: nomenclatureSource(options.nomenclatureTileJSONURL),
+	}
+
+	if (options.hillshadeTileJSONURL) {
+		sources[PlanetaryHillshadeSourceID] = hillshadeSource(options.hillshadeTileJSONURL)
+	}
+
+	const baseLayers = [
+		spaceLayer(palette),
+		...(options.hillshadeTileJSONURL ? [hillshadeLayer()] : []),
+		labelLayer(palette),
+		selectionLayer(palette),
+	]
+
+	return new StyleSpecificationComposer({
+		sources,
+		baseLayers,
+		hillshadeSource: null,
+		sprite: null,
+		sky: { "sky-color": palette.space, "horizon-color": palette.space },
+	}).toJSON()
+}

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

@@ -15,7 +15,7 @@
  *   Same idiom as the coverage overlay.
  *
  *   Served as XYZ vector tiles by the tile worker from `nexus-assets/tiles/race-dots-la.pmtiles`; the
- *   consumer passes its TileJSON URL (`tiles.sister.software/race-dots-la.json`) to
+ *   consumer passes its TileJSON URL (`tiles.mailwoman.ai/race-dots-la.json`) to
  *   `createRaceDotsSource`.
  *
  *   The dot is a _representation_, not a record: a random position inside the block, standing in for
@@ -24,7 +24,7 @@
 
 import type { CircleLayerSpecification, VectorSourceSpecification } from "@maplibre/maplibre-gl-style-spec"
 
-import { TileSetSourceID } from "../styles/sources.ts"
+import { TileSetSourceID } from "#styles/sources"
 
 /**
  * Tile set id for the dot-density race layer, one dot per N people (see `tiger/tools/race-dots.ts`).

package/lib/styles/fonts.ts

@@ -0,0 +1,19 @@
+/**
+ * @copyright Sister Software.
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   The glyph stacks a symbol layer may name. MapLibre draws NO text at all when a glyph range answers 404 — not a
+ *   fallback face, nothing — so a `text-font` naming an absent stack blanks every label in the style at every zoom,
+ *   with no console error a reader would connect to the missing labels.
+ *
+ *   The mirror behind `PROTOMAPS_GLYPHS_URL` serves five stacks: `Noto Sans Regular`, `Noto Sans Medium`,
+ *   `Noto Sans Italic`, `Fira Code Regular` and `Fira Code Medium`. It serves no Fira Sans, and no
+ *   `Open Sans Regular` — which is MapLibre's own default, so a symbol layer that omits `text-font` also draws
+ *   nothing. Name a constant from this file rather than a string literal.
+ */
+
+/**
+ * The regular text stack: body labels, point features, place names.
+ */
+export const PROTOMAPS_FONT_REGULAR = "Noto Sans Regular"

package/{tiles → lib/styles}/index.ts

@@ -4,6 +4,6 @@
  * @author Teffen Ellis, et al.
  */
 
-export * from "./api.ts"
-export * from "./coords.ts"
-export * from "./schema.ts"
+export * from "#styles/fonts"
+export * from "#styles/layers"
+export * from "#styles/sources"

package/{styles → lib/styles}/sources.ts

@@ -18,7 +18,11 @@ export type TileSetSourceID<T extends string = string> = Tagged<string, "TileSet
  * Declares a tileset identifier.
  */
 export function TileSetSourceID<T extends string>(value: T): TileSetSourceID<T> {
-	return value as unknown as TileSetSourceID<T>
+	// Widen to `string` before the tag: a generic `T` defers the comparability check and the assertion is refused,
+	// while `string` to the tagged type is the ordinary mint this function exists to be the only site of.
+	const raw: string = value
+
+	return raw as TileSetSourceID<T>
 }
 
 /**

package/{tiger → lib/tiger}/index.ts

@@ -4,9 +4,9 @@
  * @author Teffen Ellis, et al.
  */
 
-import { HillsLayerID } from "../base/layers.ts"
-import type { LayerSpecificationListInput } from "../styles/layers.ts"
-import { TileSetSourceID } from "../styles/sources.ts"
+import { HillsLayerID } from "#base/layers"
+import type { LayerSpecificationListInput } from "#styles/layers"
+import { TileSetSourceID } from "#styles/sources"
 
 /**
  * Tile set id for US Census tract polygons.

package/{tiles → lib/tiles}/api.ts

@@ -7,8 +7,8 @@
 import { APIClient, pluckResponseData } from "@mailwoman/core/api"
 import type { VectorSourceSpecification } from "maplibre-gl"
 
-import type { TileSetSourceID, TileSetSourceRecord } from "../styles/sources.ts"
-import type { TileJSON } from "./schema.ts"
+import type { TileSetSourceID, TileSetSourceRecord } from "#styles/sources"
+import type { TileJSON } from "#tiles/schema"
 
 /**
  * API Client for fetching Protomap tile data.
@@ -16,7 +16,7 @@ import type { TileJSON } from "./schema.ts"
 export const TileAPI = new APIClient({
 	displayName: "TileAPI",
 	axios: {
-		baseURL: "https://tiles.sister.software",
+		baseURL: "https://tiles.mailwoman.ai",
 	},
 })
 

package/{styles → lib/tiles}/index.ts

@@ -4,5 +4,6 @@
  * @author Teffen Ellis, et al.
  */
 
-export * from "./layers.ts"
-export * from "./sources.ts"
+export * from "#tiles/api"
+export * from "#tiles/coords"
+export * from "#tiles/schema"

package/out/base/buildings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buildings.d.ts","sourceRoot":"","sources":["../../base/buildings.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAGX,kBAAkB,EAClB,MAAM,kCAAkC,CAAA;AA2CzC;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,kBAAkB,EAqE9C,CAAA"}
+{"version":3,"file":"buildings.d.ts","sourceRoot":"","sources":["../../lib/base/buildings.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAGX,kBAAkB,EAClB,MAAM,kCAAkC,CAAA;AA4CzC;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,kBAAkB,EAqE9C,CAAA"}