@mailwoman/cartographer 9.3.0 → 9.4.0

package/lib/base/buildings.ts

@@ -11,6 +11,7 @@ import type {
 } from "@maplibre/maplibre-gl-style-spec"
 
 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/lib/base/composition.ts

@@ -4,7 +4,7 @@
  * @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"
@@ -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.mailwoman.ai/protomaps/fonts/{fontstack}/{range}.pbf",
-			sprite: "https://public.mailwoman.ai/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/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/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/lib/styles/index.ts

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

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

@@ -1 +1 @@
-{"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;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"}

package/out/base/buildings.js

@@ -4,6 +4,7 @@
  * @author Teffen Ellis, et al.
  */
 import { MailwomanBaseTileSetID } from "#base/theme";
+import { PROTOMAPS_FONT_REGULAR } from "#styles/fonts";
 import { LayerID } from "#styles/layers";
 const BuildingLayerID = LayerID.bind(null, "buildings");
 /**
@@ -97,7 +98,7 @@ export const BuildingLayers = [
             "text-field": ["to-string", ["id"]],
             "text-offset": [0, 0],
             "text-anchor": "center",
-            "text-font": ["Fira Sans Regular"],
+            "text-font": [PROTOMAPS_FONT_REGULAR],
         },
         paint: {
             "text-color": "black",

package/out/base/buildings.js.map

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

package/out/base/composition.d.ts

@@ -3,18 +3,42 @@
  * @license AGPL-3.0
  * @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 { LayerSpecificationList, type LayerSpecificationListInput, type LayerSpecificationListItem } from "#styles/layers";
 import type { TileSetSourceRecord } from "#styles/sources";
 export declare function createLightSpec(spec?: Partial<LightSpecification>): LightSpecification;
 export declare function createSkySpec(spec?: Partial<SkySpecification>): SkySpecification;
+/**
+ * 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 declare 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 declare 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;
 }
 /**
  * A stateful class for composing a style specification.
@@ -24,6 +48,8 @@ export declare class StyleSpecificationComposer {
     light: LightSpecification;
     sky: SkySpecification;
     sources: TileSetSourceRecord;
+    sprite: string | null;
+    glyphs: string;
     constructor(spec: StyleSpecificationComposition);
     get layers(): LayerSpecificationListItem[];
     toJSON(): StyleSpecification;

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

@@ -1 +1 @@
-{"version":3,"file":"composition.d.ts","sourceRoot":"","sources":["../../lib/base/composition.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAA;AAC3E,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAIjH,OAAO,EACN,sBAAsB,EACtB,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,EAC/B,MAAM,gBAAgB,CAAA;AACvB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAM1D,wBAAgB,eAAe,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,kBAAkB,CAYtF;AAED,wBAAgB,aAAa,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,gBAAgB,CAUhF;AAMD,MAAM,WAAW,6BAA6B;IAC7C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAA;IAC5C,MAAM,CAAC,EAAE,2BAA2B,EAAE,CAAA;IACtC,KAAK,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAA;IACnC,GAAG,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAA;CACvC;AAED;;GAEG;AACH,qBAAa,0BAA0B;IACtC,UAAU,EAAE,sBAAsB,CAAA;IAClC,KAAK,EAAE,kBAAkB,CAAA;IACzB,GAAG,EAAE,gBAAgB,CAAA;IAErB,OAAO,EAAE,mBAAmB,CAAA;gBAEhB,IAAI,EAAE,6BAA6B;IAsB/C,IAAW,MAAM,IAAI,0BAA0B,EAAE,CAEhD;IAED,MAAM,IAAI,kBAAkB;IAkB5B,IAAI,IAAI,kBAAkB;CAG1B"}
+{"version":3,"file":"composition.d.ts","sourceRoot":"","sources":["../../lib/base/composition.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAA;AAC/F,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAIjH,OAAO,EACN,sBAAsB,EACtB,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,EAC/B,MAAM,gBAAgB,CAAA;AACvB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAM1D,wBAAgB,eAAe,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,kBAAkB,CAYtF;AAED,wBAAgB,aAAa,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,gBAAgB,CAUhF;AAMD;;;GAGG;AACH,eAAO,MAAM,oBAAoB,wEAAwE,CAAA;AAEzG;;;GAGG;AACH,eAAO,MAAM,oBAAoB,2DAA2D,CAAA;AAE5F,MAAM,WAAW,6BAA6B;IAC7C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAA;IAC5C,MAAM,CAAC,EAAE,2BAA2B,EAAE,CAAA;IACtC,KAAK,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAA;IACnC,GAAG,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAA;IACvC;;;OAGG;IACH,UAAU,CAAC,EAAE,kBAAkB,EAAE,CAAA;IACjC;;OAEG;IACH,eAAe,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAA;IAC5C;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,MAAM,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,qBAAa,0BAA0B;IACtC,UAAU,EAAE,sBAAsB,CAAA;IAClC,KAAK,EAAE,kBAAkB,CAAA;IACzB,GAAG,EAAE,gBAAgB,CAAA;IAErB,OAAO,EAAE,mBAAmB,CAAA;IAC5B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,MAAM,EAAE,MAAM,CAAA;gBAEF,IAAI,EAAE,6BAA6B;IA0B/C,IAAW,MAAM,IAAI,0BAA0B,EAAE,CAEhD;IAED,MAAM,IAAI,kBAAkB;IAe5B,IAAI,IAAI,kBAAkB;CAG1B"}

package/out/base/composition.js

@@ -32,6 +32,18 @@ export function createSkySpec(spec) {
         ...spec,
     };
 }
+//#endregion
+//#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";
 /**
  * A stateful class for composing a style specification.
  */
@@ -41,19 +53,24 @@ export class StyleSpecificationComposer {
     sky;
     // terrain: TerrainSpecification
     sources;
+    sprite;
+    glyphs;
     constructor(spec) {
         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);
         }
@@ -64,11 +81,8 @@ export class StyleSpecificationComposer {
     toJSON() {
         const styleSpec = {
             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.mailwoman.ai/protomaps/fonts/{fontstack}/{range}.pbf",
-            sprite: "https://public.mailwoman.ai/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/out/base/composition.js.map

@@ -1 +1 @@
-{"version":3,"file":"composition.js","sourceRoot":"","sources":["../../lib/base/composition.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAC1E,OAAO,EACN,sBAAsB,GAGtB,MAAM,gBAAgB,CAAA;AAGvB,YAAY;AAEZ,uBAAuB;AAEvB,MAAM,UAAU,eAAe,CAAC,IAAkC;IACjE,OAAO;QACN,KAAK,EAAE,OAAO;QACd,SAAS,EAAE,IAAI;QACf,MAAM,EAAE,UAAU;QAClB,QAAQ,EAAE;YACT,EAAE,EAAE,SAAS;YACb,EAAE,EAAE,YAAY;YAChB,CAAC,CAAC,EAAE,QAAQ;SACZ;QACD,GAAG,IAAI;KACP,CAAA;AACF,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAgC;IAC7D,OAAO;QACN,WAAW,EAAE,SAAS;QACtB,eAAe,EAAE,qBAAqB;QACtC,WAAW,EAAE,oBAAoB;QACjC,mBAAmB,EAAE,IAAI;QACzB,mBAAmB,EAAE,IAAI;QACzB,kBAAkB,EAAE,GAAG;QACvB,GAAG,IAAI;KACP,CAAA;AACF,CAAC;AAcD;;GAEG;AACH,MAAM,OAAO,0BAA0B;IACtC,UAAU,CAAwB;IAClC,KAAK,CAAoB;IACzB,GAAG,CAAkB;IACrB,gCAAgC;IAChC,OAAO,CAAqB;IAE5B,YAAY,IAAmC;QAC9C,IAAI,CAAC,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACxC,IAAI,CAAC,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAElC,mBAAmB;QACnB,6BAA6B;QAC7B,oBAAoB;QACpB,IAAI;QAEJ,IAAI,CAAC,OAAO,GAAG;YACd,GAAG,IAAI,CAAC,OAAO;YACf,gDAAgD;YAChD,CAAC,kBAAkB,CAAC,EAAE,sBAAsB,EAAE;SAC9C,CAAA;QAED,IAAI,CAAC,UAAU,GAAG,IAAI,sBAAsB,CAAC,UAAU,CAAC,CAAA;QAExD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;YACvC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QAC9B,CAAC;IACF,CAAC;IAED,IAAW,MAAM;QAChB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IACnC,CAAC;IAED,MAAM;QACL,MAAM,SAAS,GAAuB;YACrC,OAAO,EAAE,CAAC;YACV,uFAAuF;YACvF,yFAAyF;YACzF,6EAA6E;YAC7E,MAAM,EAAE,qEAAqE;YAC7E,MAAM,EAAE,wDAAwD;YAChE,KAAK,EAAE,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC;YAClC,GAAG,EAAE,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC;YAC5B,yBAAyB;YACzB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM,EAAE,IAAI,CAAC,MAAM;SACnB,CAAA;QAED,OAAO,SAAS,CAAA;IACjB,CAAC;IAED,IAAI;QACH,OAAO,IAAI,CAAC,MAAM,EAAE,CAAA;IACrB,CAAC;CACD;AAED,YAAY"}
+{"version":3,"file":"composition.js","sourceRoot":"","sources":["../../lib/base/composition.ts"],"names":[],"mappings":"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"}

package/out/planetary/index.d.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";
+//# sourceMappingURL=index.d.ts.map

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

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

package/out/planetary/index.js

@@ -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";
+//# sourceMappingURL=index.js.map

package/out/planetary/index.js.map

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

package/out/planetary/layers.d.ts

@@ -0,0 +1,61 @@
+/**
+ * @copyright Sister Software.
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+import type { BackgroundLayerSpecification, CircleLayerSpecification, RasterLayerSpecification, SymbolLayerSpecification } from "@maplibre/maplibre-gl-style-spec";
+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 declare const PALETTES: {
+    readonly moon: {
+        readonly space: "#05070d";
+        readonly labelColor: "#e8eef7";
+        readonly labelHalo: "#05070d";
+        readonly selection: "#7fd1ff";
+    };
+    readonly mars: {
+        readonly space: "#0a0604";
+        readonly labelColor: "#f6e3d1";
+        readonly labelHalo: "#1a0c06";
+        readonly selection: "#ffb37f";
+    };
+};
+export type PlanetaryStyleBody = keyof typeof PALETTES;
+/**
+ * The background layer: the body's space color, drawn first.
+ */
+export declare const PlanetarySpaceLayerID: "planetary/space";
+/**
+ * The hillshade raster layer, present only when the body has a hillshade tileset.
+ */
+export declare const PlanetaryHillshadeLayerID: "planetary/hillshade";
+/**
+ * The nomenclature label layer, the one an app reads feature properties from on a click.
+ */
+export declare const PlanetaryLabelsLayerID: "planetary/nomenclature-labels";
+/**
+ * The selection ring layer, the one an app sets a feature `id` filter on.
+ */
+export declare const PlanetarySelectionLayerID: "planetary/selection";
+export declare function spaceLayer(palette: PlanetaryPalette): BackgroundLayerSpecification;
+export declare function hillshadeLayer(): RasterLayerSpecification;
+/**
+ * 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 declare function labelLayer(palette: PlanetaryPalette): SymbolLayerSpecification;
+/**
+ * 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 declare function selectionLayer(palette: PlanetaryPalette): CircleLayerSpecification;
+//# sourceMappingURL=layers.d.ts.map

package/out/planetary/layers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layers.d.ts","sourceRoot":"","sources":["../../lib/planetary/layers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACX,4BAA4B,EAC5B,wBAAwB,EACxB,wBAAwB,EACxB,wBAAwB,EACxB,MAAM,kCAAkC,CAAA;AAMzC,MAAM,WAAW,gBAAgB;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CACjB;AAED;;;GAGG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;CAGgC,CAAA;AAErD,MAAM,MAAM,kBAAkB,GAAG,MAAM,OAAO,QAAQ,CAAA;AAItD;;GAEG;AACH,eAAO,MAAM,qBAAqB,mBAAwC,CAAA;AAE1E;;GAEG;AACH,eAAO,MAAM,yBAAyB,uBAA4C,CAAA;AAElF;;GAEG;AACH,eAAO,MAAM,sBAAsB,iCAAsD,CAAA;AAEzF;;GAEG;AACH,eAAO,MAAM,yBAAyB,uBAA4C,CAAA;AAQlF,wBAAgB,UAAU,CAAC,OAAO,EAAE,gBAAgB,GAAG,4BAA4B,CAMlF;AAED,wBAAgB,cAAc,IAAI,wBAAwB,CAOzD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,gBAAgB,GAAG,wBAAwB,CAiB9E;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,gBAAgB,GAAG,wBAAwB,CAclF"}

package/out/planetary/layers.js

@@ -0,0 +1,96 @@
+/**
+ * @copyright Sister Software.
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+import { PlanetaryHillshadeSourceID, PlanetaryNomenclatureSourceID } from "#planetary/sources";
+import { PROTOMAPS_FONT_REGULAR } from "#styles/fonts";
+import { LayerID } from "#styles/layers";
+/**
+ * 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" },
+};
+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) {
+    return {
+        id: PlanetarySpaceLayerID,
+        type: "background",
+        paint: { "background-color": palette.space },
+    };
+}
+export function hillshadeLayer() {
+    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) {
+    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) {
+    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,
+        },
+    };
+}
+//# sourceMappingURL=layers.js.map

package/out/planetary/layers.js.map

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

package/out/planetary/sources.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @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 declare const PlanetaryNomenclatureSourceID: TileSetSourceID<"nomenclature">;
+/**
+ * The raster source carrying a body's hillshade, rendered from its DEM at build time.
+ */
+export declare 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 declare function nomenclatureSource(tileJSONURL: string): VectorSourceSpecification;
+export declare function hillshadeSource(tileJSONURL: string): RasterSourceSpecification;
+//# sourceMappingURL=sources.d.ts.map

package/out/planetary/sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sources.d.ts","sourceRoot":"","sources":["../../lib/planetary/sources.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAA;AAE5G,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEjD;;GAEG;AACH,eAAO,MAAM,6BAA6B,iCAAkC,CAAA;AAE5E;;GAEG;AACH,eAAO,MAAM,0BAA0B,8BAA+B,CAAA;AAEtE;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,yBAAyB,CAKjF;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,yBAAyB,CAM9E"}

package/out/planetary/sources.js

@@ -0,0 +1,32 @@
+/**
+ * @copyright Sister Software.
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+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) {
+    return {
+        type: "vector",
+        url: tileJSONURL,
+    };
+}
+export function hillshadeSource(tileJSONURL) {
+    return {
+        type: "raster",
+        url: tileJSONURL,
+        tileSize: 256,
+    };
+}
+//# sourceMappingURL=sources.js.map

package/out/planetary/sources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sources.js","sourceRoot":"","sources":["../../lib/planetary/sources.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEjD;;GAEG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,eAAe,CAAC,cAAc,CAAC,CAAA;AAE5E;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,eAAe,CAAC,WAAW,CAAC,CAAA;AAEtE;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,WAAmB;IACrD,OAAO;QACN,IAAI,EAAE,QAAQ;QACd,GAAG,EAAE,WAAW;KAChB,CAAA;AACF,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,WAAmB;IAClD,OAAO;QACN,IAAI,EAAE,QAAQ;QACd,GAAG,EAAE,WAAW;QAChB,QAAQ,EAAE,GAAG;KACb,CAAA;AACF,CAAC"}

package/out/planetary/style.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @copyright Sister Software.
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+import type { StyleSpecification } from "@maplibre/maplibre-gl-style-spec";
+import { type PlanetaryStyleBody } from "#planetary/layers";
+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 declare function createPlanetaryStyle(options: PlanetaryStyleOptions): StyleSpecification;
+//# sourceMappingURL=style.d.ts.map

package/out/planetary/style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["../../lib/planetary/style.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAuB,kBAAkB,EAAE,MAAM,kCAAkC,CAAA;AAG/F,OAAO,EAIN,KAAK,kBAAkB,EAGvB,MAAM,mBAAmB,CAAA;AAQ1B,MAAM,WAAW,qBAAqB;IACrC,IAAI,EAAE,kBAAkB,CAAA;IACxB;;OAEG;IACH,uBAAuB,EAAE,MAAM,CAAA;IAC/B;;OAEG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAC7B;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,kBAAkB,CAyBvF"}

package/out/planetary/style.js

@@ -0,0 +1,35 @@
+/**
+ * @copyright Sister Software.
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+import { StyleSpecificationComposer } from "#base/composition";
+import { hillshadeLayer, labelLayer, PALETTES, selectionLayer, spaceLayer, } from "#planetary/layers";
+import { hillshadeSource, nomenclatureSource, PlanetaryHillshadeSourceID, PlanetaryNomenclatureSourceID, } from "#planetary/sources";
+/**
+ * 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) {
+    const palette = PALETTES[options.body];
+    const sources = {
+        [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();
+}
+//# sourceMappingURL=style.js.map

package/out/planetary/style.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.js","sourceRoot":"","sources":["../../lib/planetary/style.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAA;AAC9D,OAAO,EACN,cAAc,EACd,UAAU,EACV,QAAQ,EAER,cAAc,EACd,UAAU,GACV,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EACN,eAAe,EACf,kBAAkB,EAClB,0BAA0B,EAC1B,6BAA6B,GAC7B,MAAM,oBAAoB,CAAA;AAc3B;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAA8B;IAClE,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IAEtC,MAAM,OAAO,GAAwC;QACpD,CAAC,6BAA6B,CAAC,EAAE,kBAAkB,CAAC,OAAO,CAAC,uBAAuB,CAAC;KACpF,CAAA;IAED,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC;QAClC,OAAO,CAAC,0BAA0B,CAAC,GAAG,eAAe,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAA;IACpF,CAAC;IAED,MAAM,UAAU,GAAG;QAClB,UAAU,CAAC,OAAO,CAAC;QACnB,GAAG,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,UAAU,CAAC,OAAO,CAAC;QACnB,cAAc,CAAC,OAAO,CAAC;KACvB,CAAA;IAED,OAAO,IAAI,0BAA0B,CAAC;QACrC,OAAO;QACP,UAAU;QACV,eAAe,EAAE,IAAI;QACrB,MAAM,EAAE,IAAI;QACZ,GAAG,EAAE,EAAE,WAAW,EAAE,OAAO,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,CAAC,KAAK,EAAE;KACnE,CAAC,CAAC,MAAM,EAAE,CAAA;AACZ,CAAC"}

package/out/styles/fonts.d.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 declare const PROTOMAPS_FONT_REGULAR = "Noto Sans Regular";
+//# sourceMappingURL=fonts.d.ts.map

package/out/styles/fonts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fonts.d.ts","sourceRoot":"","sources":["../../lib/styles/fonts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;GAEG;AACH,eAAO,MAAM,sBAAsB,sBAAsB,CAAA"}

package/out/styles/fonts.js

@@ -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";
+//# sourceMappingURL=fonts.js.map

package/out/styles/fonts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fonts.js","sourceRoot":"","sources":["../../lib/styles/fonts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,mBAAmB,CAAA"}

package/out/styles/index.d.ts

@@ -3,6 +3,7 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  */
+export * from "#styles/fonts";
 export * from "#styles/layers";
 export * from "#styles/sources";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../lib/styles/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../lib/styles/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,eAAe,CAAA;AAC7B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA"}

package/out/styles/index.js

@@ -3,6 +3,7 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  */
+export * from "#styles/fonts";
 export * from "#styles/layers";
 export * from "#styles/sources";
 //# sourceMappingURL=index.js.map

package/out/styles/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../lib/styles/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../lib/styles/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,eAAe,CAAA;AAC7B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA"}

package/out/tsconfig.test.tsbuildinfo

@@ -1 +1 @@
-{"root":["../test/unit/base/composition.test.ts","../test/unit/tiles/coords.test.ts"],"version":"6.0.3"}
+{"root":["../test/unit/base/composition.test.ts","../test/unit/planetary/style.test.ts","../test/unit/tiles/coords.test.ts"],"version":"6.0.3"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mailwoman/cartographer",
-  "version": "9.3.0",
+  "version": "9.4.0",
   "description": "Mapping utilities for the Mailwoman geo-spatial data pipeline.",
   "license": "AGPL-3.0-only OR LicenseRef-Commercial",
   "contributors": [
@@ -82,6 +82,11 @@
       "types": "./out/base/composition.d.ts",
       "node": "./out/base/composition.js",
       "default": "./out/base/composition.js"
+    },
+    "./planetary": {
+      "types": "./out/planetary/index.d.ts",
+      "node": "./out/planetary/index.js",
+      "default": "./out/planetary/index.js"
     }
   },
   "publishConfig": {
@@ -132,6 +137,11 @@
         "types": "./out/base/composition.d.ts",
         "node": "./out/base/composition.js",
         "default": "./out/base/composition.js"
+      },
+      "./planetary": {
+        "types": "./out/planetary/index.d.ts",
+        "node": "./out/planetary/index.js",
+        "default": "./out/planetary/index.js"
       }
     },
     "imports": {
@@ -143,8 +153,8 @@
     }
   },
   "dependencies": {
-    "@mailwoman/core": "9.3.0",
-    "@mailwoman/tiger": "9.3.0",
+    "@mailwoman/core": "9.4.0",
+    "@mailwoman/tiger": "9.4.0",
     "@maplibre/maplibre-gl-style-spec": "^26.4.1",
     "@protomaps/basemaps": "^5.7.2",
     "d3-scale-chromatic": "^3.1.0",